release: v2.0.0 - expand SDK with new Media, Live, SigningKey, and Data APIs

Author: HarishKumar097

.gitattributes

@@ -0,0 +1,2 @@
+# This allows generated code to be indexed correctly
+*.ts linguist-generated=false

.gitignore

@@ -1,5 +1,28 @@
+/models
+/models/errors
+/types
+/node_modules
+/examples/node_modules
+/lib
+/sdk
+/funcs
+/react-query
+/mcp-server
+/hooks
+/index.*
+/core.*
+/bin
+/cjs
+/esm
+/dist
+/.tsbuildinfo
+/.eslintcache
+/.tshy
+/.tshy-*
+/__tests__
+.DS_Store
+.DS_Store
+.env
+.env.local
+.env.*.local
 node_modules
-dist
-utils
-/.cache
-**/.DS_Store

.npmignore

@@ -1 +1,15 @@
-*
+**/*
+!/FUNCTIONS.md
+!/RUNTIMES.md
+!/REACT_QUERY.md
+!/**/*.ts
+!/**/*.js
+!/**/*.mjs
+!/**/*.json
+!/**/*.map
+
+/eslint.config.mjs
+/cjs
+/.tshy
+/.tshy-*
+/__tests__

.prettierrc

@@ -2,13 +2,68 @@
 
 All notable changes to this project will be documented in this file.
 
-## [1.0.2]
-- Updated `package.json` with keywords related to FastPix Node.js API SDK.
+## [2.0.0] - Major Feature Release
+This release introduces a wide set of new APIs, significantly expanding the SDK’s capabilities across **On Demand**, **Live Stream**, **SigningKeys**, and **Video Data** domains.
 
-## [1.0.1]
-- update `README.md`
+### Media API
+Extended functionality for managing media with advanced processing, playlist management, and DRM support:
+- `updateMediaSummary` - Generate video summaries for quick insights
+- `updateMediaChapters` - Automatically generate structured video chapters
+- `updateMediaNamedEntities` - Extract named entities for video intelligence
+- `updateMediaModeration` - Enable video moderation features for compliance
+- `addMediaTrack` - Add audio/subtitle tracks
+- `cancelUpload` - Cancel ongoing uploads gracefully
+- `updateMediaTrack` - Update audio/subtitle tracks
+- `deleteMediaTrack` - Remove audio/subtitle tracks
+- `generateSubtitleTrack` - Auto-generate subtitles
+- `updatedSourceAccess` - Update media source access permissions
+- `updatedMp4Support` - Toggle MP4 support for a media
+- `retrieveMediaInputInfo` - Fetch media input information
+- `listUploads` - Retrieve all unused upload URLs
+- `getMediaClips` - List clips of a media
+- Playlist Management: 
+  - `createAPlaylist`, `getAllPlaylists`, `getPlaylistById`, `updateAPlaylist`, `deleteAPlaylist`, `addMediaToPlaylist`, `changeMediaOrderInPlaylist`, `deleteMediaFromPlaylist`
+- DRM Management:
+  - `getDrmConfiguration`, `getDrmConfigurationById`
 
-## [1.0.0]
-- This SDK serves as a library for secure and efficient communication with the FastPix API.
+### Live API
+Added fine-grained stream control:
+- `enableLiveStream` - Enable a stream
+- `disableLiveStream` - Disable a stream
+- `completeLiveStream` - Mark a live stream as completed
+
+### SigningKey API
+Introduced secure signing key management:
+- `createSigningKey` - Create signing keys for secure token usage
+- `listSigningKeys` - List available signing keys
+- `deleteSigningKey` - Revoke signing keys
+- `getSigningKeyById` - Retrieve signing key details
+
+### Data API
+New analytics endpoints for tracking and measuring performance:
+- `listVideoViews` - List video views
+- `getVideoViewDetails` - Fetch detailed video view information
+- `listByTopContent` - Discover top-performing content
+- `getDataViewlistCurrentViewsGetTimeseriesViews` - Retrieve concurrent viewers timeseries
+- `getDataViewlistCurrentViewsFilter` - Breakdown concurrent viewers by dimension
+- `listDimensions` - List all available dimensions
+- `listFilterValuesForDimension` - List filter values per dimension
+- `listErrors` - Retrieve error logs
+- `listBreakdownValues` - Get breakdown metrics
+- `listOverallValues` - Get overall summary metrics
+- `getTimeseriesData` - Access timeseries data
+- `listComparisonValues` - Compare metrics across datasets
+
+---
+
+## [1.0.2] - Metadata Update
+- Updated `package.json` with keywords related to FastPix Node.js API SDK for better discoverability.
+
+## [1.0.1] - Documentation Update
+- Improved `README.md` with clearer usage instructions and examples.
+
+## [1.0.0] - Initial Release
+- First release of the FastPix Node.js API SDK.  
+- Provides a robust foundation for interacting with the FastPix API.  
   - **Media API**: Upload media, manage media assets (list, fetch, update, delete), and generate playback IDs.
-  - **Live API**: Create, list, update, and delete live streams; generate and manage playback IDs; and simulcasting to multiple platforms.
+  - **Live API**: Create, list, update, and delete live streams; generate and manage playback IDs; and simulcast to multiple platforms.

CHANGELOG.md

@@ -0,0 +1,26 @@
+# Contributing to This Repository
+
+Thank you for your interest in contributing to this repository. Please note that this repository contains generated code. As such, we do not accept direct changes or pull requests. Instead, we encourage you to follow the guidelines below to report issues and suggest improvements.
+
+## How to Report Issues
+
+If you encounter any bugs or have suggestions for improvements, please open an issue on GitHub. When reporting an issue, please provide as much detail as possible to help us reproduce the problem. This includes:
+
+- A clear and descriptive title
+- Steps to reproduce the issue
+- Expected and actual behavior
+- Any relevant logs, screenshots, or error messages
+- Information about your environment (e.g., operating system, software versions)
+    - For example can be collected using the `npx envinfo` command from your terminal if you have Node.js installed
+
+## Issue Triage and Upstream Fixes
+
+We will review and triage issues as quickly as possible. Our goal is to address bugs and incorporate improvements in the upstream source code. Fixes will be included in the next generation of the generated code.
+
+## Contact
+
+If you have any questions or need further assistance, please feel free to reach out by opening an issue.
+
+Thank you for your understanding and cooperation!
+
+The Maintainers

CONTRIBUTING.md

@@ -0,0 +1,101 @@
+# Standalone Functions
+
+> [!NOTE]
+> This section is useful if you are using a bundler and targetting browsers and
+> runtimes where the size of an application affects performance and load times. 
+
+Every method in this SDK is also available as a standalone function. This
+alternative API is suitable when targetting the browser or serverless runtimes
+and using a bundler to build your application since all unused functionality
+will be tree-shaken away. This includes code for unused methods, Zod schemas,
+encoding helpers and response handlers. The result is dramatically smaller
+impact on the application's final bundle size which grows very slowly as you use
+more and more functionality from this SDK.
+
+Calling methods through the main SDK class remains a valid and generally more
+more ergonomic option. Standalone functions represent an optimisation for a
+specific category of applications.
+
+## Example
+
+```typescript
+import { FastpixCore } from "@fastpix/fastpix-node/core.js";
+import { inputVideoCreateMedia } from "@fastpix/fastpix-node/funcs/inputVideoCreateMedia.js";
+
+// Use `FastpixCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const fastpix = new FastpixCore({
+  security: {
+    username: "",
+    password: "",
+  },
+});
+
+async function run() {
+  const res = await inputVideoCreateMedia(fastpix, {
+    inputs: [
+      {
+        type: "video",
+        url: "https://static.fastpix.io/sample.mp4",
+      },
+    ],
+    metadata: {
+      "key1": "value1",
+    },
+    accessPolicy: "public",
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("inputVideoCreateMedia failed:", res.error);
+  }
+}
+
+run();
+```
+
+## Result types
+
+Standalone functions differ from SDK methods in that they return a
+`Result<Value, Error>` type to capture _known errors_ and document them using
+the type system. By avoiding throwing errors, application code maintains clear
+control flow and error-handling become part of the regular flow of application
+code.
+
+> We use the term "known errors" because standalone functions, and JavaScript
+> code in general, can still throw unexpected errors such as `TypeError`s,
+> `RangeError`s and `DOMException`s. Exhaustively catching all errors may be
+> something this SDK addresses in the future. Nevertheless, there is still a lot
+> of benefit from capturing most errors and turning them into values.
+
+The second reason for this style of programming is because these functions will
+typically be used in front-end applications where exception throwing is
+sometimes discouraged or considered unidiomatic. React and similar ecosystems
+and libraries tend to promote this style of programming so that components
+render useful content under all states (loading, success, error and so on).
+
+The general pattern when calling standalone functions looks like this:
+
+```typescript
+import { Core } from "<sdk-package-name>";
+import { fetchSomething } from "<sdk-package-name>/funcs/fetchSomething.js";
+
+const client = new Core();
+
+async function run() {
+  const result = await fetchSomething(client, { id: "123" });
+  if (!result.ok) {
+    // You can throw the error or handle it. It's your choice now.
+    throw result.error;
+  }
+
+  console.log(result.value);
+}
+
+run();
+```
+
+Notably, `result.error` above will have an explicit type compared to a try-catch
+variation where the error in the catch block can only be of type `unknown` (or
+`any` depending on your TypeScript settings).

FUNCTIONS.md

@@ -198,4 +198,4 @@
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
-   limitations under the License.
+   limitations under the License.