release: 10.1.0 (#551)

* docs: update URLs from stainlessapi.com to stainless.com (#550)

More details at https://www.stainless.com/changelog/stainless-com

* feat: add asset metadata schema (#323) (#552)

* feat: Add Video Creator ID dimension (#325) (#553)

* feat: add static_rendition webhooks (#327) (#554)

* release: 10.1.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "10.0.0"
+  ".": "10.1.0"
 }

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 88
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/mux%2Fmux-2eec862e75143314aec7ca531a90eecc404ce10a5038c2140810caaeb22cae43.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/mux%2Fmux-5f3a1cefec239fb0daed651397851795841e0d4b17d242968b946002d8feaa19.yml

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 10.1.0 (2025-03-06)
+
+Full Changelog: [v10.0.0...v10.1.0](https://github.com/muxinc/mux-node-sdk/compare/v10.0.0...v10.1.0)
+
+### Features
+
+* add asset metadata schema ([#323](https://github.com/muxinc/mux-node-sdk/issues/323)) ([#552](https://github.com/muxinc/mux-node-sdk/issues/552)) ([769d578](https://github.com/muxinc/mux-node-sdk/commit/769d5783a1278fd7e22353a28ab1d8f0bedbe044))
+* add static_rendition webhooks ([#327](https://github.com/muxinc/mux-node-sdk/issues/327)) ([#554](https://github.com/muxinc/mux-node-sdk/issues/554)) ([b483052](https://github.com/muxinc/mux-node-sdk/commit/b48305245dcb4b9eac7053239d2050305d542e1c))
+* Add Video Creator ID dimension ([#325](https://github.com/muxinc/mux-node-sdk/issues/325)) ([#553](https://github.com/muxinc/mux-node-sdk/issues/553)) ([0246142](https://github.com/muxinc/mux-node-sdk/commit/024614201acffe3e227534e4ba353aa4cc7ac229))
+
+
+### Documentation
+
+* update URLs from stainlessapi.com to stainless.com ([#550](https://github.com/muxinc/mux-node-sdk/issues/550)) ([0be8bb7](https://github.com/muxinc/mux-node-sdk/commit/0be8bb743e1e5c551d950dfca5dce7aa2ab84830))
+
 ## 10.0.0 (2025-02-21)
 
 Full Changelog: [v9.0.1...v10.0.0](https://github.com/muxinc/mux-node-sdk/compare/v9.0.1...v10.0.0)

SECURITY.md

@@ -2,9 +2,9 @@
 
 ## Reporting Security Issues
 
-This SDK is generated by [Stainless Software Inc](http://stainlessapi.com). Stainless takes security seriously, and encourages you to report any security vulnerability promptly so that appropriate action can be taken.
+This SDK is generated by [Stainless Software Inc](http://stainless.com). Stainless takes security seriously, and encourages you to report any security vulnerability promptly so that appropriate action can be taken.
 
-To report a security issue, please contact the Stainless team at security@stainlessapi.com.
+To report a security issue, please contact the Stainless team at security@stainless.com.
 
 ## Responsible Disclosure
 

api.md

@@ -336,6 +336,11 @@ Types:
 - <code><a href="./src/resources/webhooks.ts">VideoAssetTrackReadyWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">VideoAssetTrackErroredWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">VideoAssetTrackDeletedWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">VideoAssetStaticRenditionCreatedWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">VideoAssetStaticRenditionReadyWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">VideoAssetStaticRenditionErroredWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">VideoAssetStaticRenditionDeletedWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">VideoAssetStaticRenditionSkippedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">VideoAssetWarningWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">VideoAssetNonStandardInputDetectedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">VideoUploadAssetCreatedWebhookEvent</a></code>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mux/mux-node",
-  "version": "10.0.0",
+  "version": "10.1.0",
   "description": "The official TypeScript library for the Mux API",
   "author": "Mux <[email protected]>",
   "types": "dist/index.d.ts",

src/resources/data/metrics.ts

@@ -934,7 +934,8 @@ export interface MetricListParams {
     | 'audio_codec'
     | 'video_dynamic_range_type'
     | 'view_cdn_edge_pop'
-    | 'view_cdn_origin';
+    | 'view_cdn_origin'
+    | 'video_creator_id';
 
   /**
    * Limit the results to rows that match conditions from provided key:value pairs.
@@ -1308,7 +1309,8 @@ export interface MetricListBreakdownValuesParams extends BasePageParams {
     | 'audio_codec'
     | 'video_dynamic_range_type'
     | 'view_cdn_edge_pop'
-    | 'view_cdn_origin';
+    | 'view_cdn_origin'
+    | 'video_creator_id';
 
   /**
    * Measurement for the provided metric. If omitted, the default for the metric will

src/resources/data/video-views.ts

@@ -309,6 +309,8 @@ export namespace VideoViewResponse {
 
     video_content_type: string | null;
 
+    video_creator_id: string | null;
+
     video_duration: number | null;
 
     video_dynamic_range_type: string | null;

src/resources/video/assets.ts

@@ -304,6 +304,8 @@ export interface Asset {
    */
   max_stored_resolution?: 'Audio only' | 'SD' | 'HD' | 'FHD' | 'UHD';
 
+  meta?: Asset.Meta;
+
   /**
    * @deprecated
    */
@@ -325,7 +327,10 @@ export interface Asset {
   normalize_audio?: boolean;
 
   /**
-   * Arbitrary user-supplied metadata set for the asset. Max 255 characters.
+   * You can set this field to anything you want. It will be included in the asset
+   * details and related webhooks. If you're looking for more structured metadata,
+   * such as `title` or `external_id` , you can use the `meta` object instead. **Max:
+   * 255 characters**.
    */
   passthrough?: string;
 
@@ -430,6 +435,25 @@ export namespace Asset {
     url?: string;
   }
 
+  export interface Meta {
+    /**
+     * This is an identifier you provide to keep track of the creator of the video. Max
+     * 128 code points.
+     */
+    creator_id?: string;
+
+    /**
+     * This is an identifier you provide to link the video to your own data. Max 128
+     * code points.
+     */
+    external_id?: string;
+
+    /**
+     * The video title. Max 512 code points.
+     */
+    title?: string;
+  }
+
   /**
    * An object containing one or more reasons the input file is non-standard. See
    * [the guide on minimizing processing time](https://docs.mux.com/guides/minimize-processing-time)
@@ -687,6 +711,8 @@ export interface AssetOptions {
    */
   max_resolution_tier?: '1080p' | '1440p' | '2160p';
 
+  meta?: AssetOptions.Meta;
+
   /**
    * @deprecated Deprecated. See the
    * [Static Renditions API](https://www.mux.com/docs/guides/enable-static-mp4-renditions)
@@ -728,9 +754,10 @@ export interface AssetOptions {
   normalize_audio?: boolean;
 
   /**
-   * Arbitrary user-supplied metadata that will be included in the asset details and
-   * related webhooks. Can be used to store your own ID for a video along with the
-   * asset. **Max: 255 characters**.
+   * You can set this field to anything you want. It will be included in the asset
+   * details and related webhooks. If you're looking for more structured metadata,
+   * such as `title` or `external_id`, you can use the `meta` object instead. **Max:
+   * 255 characters**.
    */
   passthrough?: string;
 
@@ -1011,6 +1038,25 @@ export namespace AssetOptions {
     }
   }
 
+  export interface Meta {
+    /**
+     * This is an identifier you provide to keep track of the creator of the video. Max
+     * 128 code points.
+     */
+    creator_id?: string;
+
+    /**
+     * This is an identifier you provide to link the video to your own data. Max 128
+     * code points.
+     */
+    external_id?: string;
+
+    /**
+     * The video title. Max 512 code points.
+     */
+    title?: string;
+  }
+
   export interface StaticRendition {
     resolution:
       | 'highest'
@@ -1450,6 +1496,8 @@ export interface AssetCreateParams {
    */
   max_resolution_tier?: '1080p' | '1440p' | '2160p';
 
+  meta?: AssetCreateParams.Meta;
+
   /**
    * Deprecated. See the
    * [Static Renditions API](https://www.mux.com/docs/guides/enable-static-mp4-renditions)
@@ -1491,9 +1539,10 @@ export interface AssetCreateParams {
   normalize_audio?: boolean;
 
   /**
-   * Arbitrary user-supplied metadata that will be included in the asset details and
-   * related webhooks. Can be used to store your own ID for a video along with the
-   * asset. **Max: 255 characters**.
+   * You can set this field to anything you want. It will be included in the asset
+   * details and related webhooks. If you're looking for more structured metadata,
+   * such as `title` or `external_id`, you can use the `meta` object instead. **Max:
+   * 255 characters**.
    */
   passthrough?: string;
 
@@ -1771,6 +1820,25 @@ export namespace AssetCreateParams {
     policy?: Shared.PlaybackPolicy;
   }
 
+  export interface Meta {
+    /**
+     * This is an identifier you provide to keep track of the creator of the video. Max
+     * 128 code points.
+     */
+    creator_id?: string;
+
+    /**
+     * This is an identifier you provide to link the video to your own data. Max 128
+     * code points.
+     */
+    external_id?: string;
+
+    /**
+     * The video title. Max 512 code points.
+     */
+    title?: string;
+  }
+
   export interface StaticRendition {
     resolution:
       | 'highest'
@@ -1793,13 +1861,39 @@ export namespace AssetCreateParams {
 }
 
 export interface AssetUpdateParams {
+  meta?: AssetUpdateParams.Meta;
+
   /**
-   * Arbitrary metadata set for the Asset. Max 255 characters. In order to clear this
-   * value, the field should be included with an empty string value.
+   * You can set this field to anything you want. It will be included in the asset
+   * details and related webhooks. If you're looking for more structured metadata,
+   * such as `title` or `external_id` , you can use the `meta` object instead. **Max:
+   * 255 characters**. In order to clear this value, the field should be included
+   * with an empty string value.
    */
   passthrough?: string;
 }
 
+export namespace AssetUpdateParams {
+  export interface Meta {
+    /**
+     * This is an identifier you provide to keep track of the creator of the video. Max
+     * 128 code points.
+     */
+    creator_id?: string;
+
+    /**
+     * This is an identifier you provide to link the video to your own data. Max 128
+     * code points.
+     */
+    external_id?: string;
+
+    /**
+     * The video title. Max 512 code points.
+     */
+    title?: string;
+  }
+}
+
 export interface AssetListParams extends BasePageParams {
   /**
    * Filter response to return all the assets for this live stream only

src/resources/video/live-streams.ts

@@ -864,6 +864,8 @@ export namespace LiveStreamUpdateParams {
      */
     master_access?: 'temporary' | 'none';
 
+    meta?: NewAssetSettings.Meta;
+
     /**
      * @deprecated Deprecated. See the
      * [Static Renditions API](https://www.mux.com/docs/guides/enable-static-mp4-renditions#during-live-stream-creation)
@@ -895,6 +897,27 @@ export namespace LiveStreamUpdateParams {
      */
     video_quality?: 'plus' | 'premium';
   }
+
+  export namespace NewAssetSettings {
+    export interface Meta {
+      /**
+       * This is an identifier you provide to keep track of the creator of the video. Max
+       * 128 code points.
+       */
+      creator_id?: string;
+
+      /**
+       * This is an identifier you provide to link the video to your own data. Max 128
+       * code points.
+       */
+      external_id?: string;
+
+      /**
+       * The video title. Max 512 code points.
+       */
+      title?: string;
+    }
+  }
 }
 
 export interface LiveStreamListParams extends BasePageParams {

src/resources/webhooks.ts

@@ -371,6 +371,36 @@ export interface VideoAssetTrackDeletedWebhookEvent extends BaseWebhookEvent {
   type: 'video.asset.track.deleted';
 }
 
+export interface VideoAssetStaticRenditionCreatedWebhookEvent extends BaseWebhookEvent {
+  data: AssetsAPI.Asset;
+
+  type: 'video.asset.static_rendition.created';
+}
+
+export interface VideoAssetStaticRenditionReadyWebhookEvent extends BaseWebhookEvent {
+  data: AssetsAPI.Asset;
+
+  type: 'video.asset.static_rendition.ready';
+}
+
+export interface VideoAssetStaticRenditionErroredWebhookEvent extends BaseWebhookEvent {
+  data: AssetsAPI.Asset;
+
+  type: 'video.asset.static_rendition.errored';
+}
+
+export interface VideoAssetStaticRenditionDeletedWebhookEvent extends BaseWebhookEvent {
+  data: AssetsAPI.Asset;
+
+  type: 'video.asset.static_rendition.deleted';
+}
+
+export interface VideoAssetStaticRenditionSkippedWebhookEvent extends BaseWebhookEvent {
+  data: AssetsAPI.Asset;
+
+  type: 'video.asset.static_rendition.skipped';
+}
+
 export interface VideoAssetWarningWebhookEvent extends BaseWebhookEvent {
   data: AssetsAPI.Asset;
 
@@ -666,6 +696,11 @@ export type UnwrapWebhookEvent =
   | VideoAssetTrackReadyWebhookEvent
   | VideoAssetTrackErroredWebhookEvent
   | VideoAssetTrackDeletedWebhookEvent
+  | VideoAssetStaticRenditionCreatedWebhookEvent
+  | VideoAssetStaticRenditionReadyWebhookEvent
+  | VideoAssetStaticRenditionErroredWebhookEvent
+  | VideoAssetStaticRenditionDeletedWebhookEvent
+  | VideoAssetStaticRenditionSkippedWebhookEvent
   | VideoAssetWarningWebhookEvent
   | VideoAssetNonStandardInputDetectedWebhookEvent
   | VideoUploadAssetCreatedWebhookEvent

src/version.ts

@@ -1 +1 @@
-export const VERSION = '10.0.0'; // x-release-please-version
+export const VERSION = '10.1.0'; // x-release-please-version

tests/api-resources/video/assets.test.ts

@@ -50,6 +50,7 @@ describe('resource assets', () => {
       encoding_tier: 'smart',
       master_access: 'none',
       max_resolution_tier: '1080p',
+      meta: { creator_id: 'creator_id', external_id: 'external_id', title: 'title' },
       mp4_support: 'none',
       normalize_audio: true,
       passthrough: 'passthrough',

tests/api-resources/video/uploads.test.ts

@@ -52,6 +52,7 @@ describe('resource uploads', () => {
         ],
         master_access: 'none',
         max_resolution_tier: '1080p',
+        meta: { creator_id: 'creator_id', external_id: 'external_id', title: 'title' },
         mp4_support: 'none',
         normalize_audio: true,
         passthrough: 'passthrough',