@dolbyio/dolbyio-rest-apis-client 6.2.2 → 6.3.1

package/dist/index.js

@@ -34,4 +34,4 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
 // Expose the logger to control when/where to log
 
 /** Gets the version of this library. */
-var version = exports.version = "6.2.2";
+var version = exports.version = "6.3.1";

package/dist/streaming/assets.js

@@ -50,11 +50,14 @@ var create = exports.create = /*#__PURE__*/function () {
             headers: {
               Accept: 'application/json',
               'Content-Type': 'application/json',
-              Authorization: "Bearer ".concat(apiSecret),
-              'Idempotency-Key': idempotencyKey
+              Authorization: "Bearer ".concat(apiSecret)
             },
             body: JSON.stringify(clipRequest)
           };
+          if (idempotencyKey) {
+            // @ts-ignore
+            options.headers['Idempotency-Key'] = idempotencyKey;
+          }
           _context.n = 1;
           return (0, _httpHelpers.sendPost)(options);
         case 1:

package/dist/streaming/types/asset.d.ts

@@ -48,6 +48,21 @@ export interface CreateAssetClipRequest {
     storage?: MediaAssetStorageModel | null;
     /** Optional. Provide expiry time for live recording clip. */
     expiration?: string | null;
+    /** Optional. Id of the OptiView Live channel to create live clip. */
+    channelId?: string | null;
+    /** Optional. Format of the media asset. */
+    targetFormat?: 'mp4' | 'hls' | null;
+    /** Optional. ID of the media distribution used to authenticate viewing of this media asset. */
+    mediaDistributionId?: string | null;
+    /**
+     * Optional.
+     * Customize the download url path.
+     * Typically the download url has format `https://<domain>/<orgId>/<mediaAssetId>/<fileName>`.
+     * The customPath replaces the mediaAssetId so that the url looks like `https://<domain>/<orgId>/<customPath>/<fileName>`. The `customPath` must be unique.
+     *
+     * Possible values: non-empty and <= 512 characters.
+     */
+    customPath?: string | null;
 }
 /**
  * Response data for the Clip storage.
@@ -113,8 +128,10 @@ export interface MediaAssetFeedSelectionModel {
     sourceId?: string | null;
     /** Optional, The simulcastId of the stream the clip belongs to. */
     simulcastId?: string | null;
-    /** Optional, int32, the priority of the clip request. */
+    /** Optional, the priority of the clip request. */
     priority?: number | null;
+    /** Optional, the identifier of the OptiView Live channel. */
+    channelId?: number | null;
 }
 /**
  * Response data for a clip.
@@ -243,6 +260,10 @@ export interface UpdateMediaAssetRequest {
      * Updates may take up to an hour to take effect.
      */
     mediaDistributionId?: string;
-    /** Customise the download url path. */
+    /**
+     * Customize a portion of the download url path.
+     * As an example assets are returned in a url such as `https://cdn.optiview.dolby.com/vod/<orgId>/<mediaAssetId>/<fileName>`.
+     * `customPath` will replace `mediaAssetId` in order for a more predictable path.
+     */
     customPath?: string;
 }

package/dist/streaming/types/monitoring.d.ts

@@ -50,6 +50,113 @@ export interface StreamSummary {
     /** Viewer count. */
     viewerCount: number;
 }
+/** Represents a Feed object. */
+export interface Feed {
+    /** Identifier of the stream. */
+    streamId: string;
+    /** Identifier of the feed. */
+    feedId: string;
+    /** Identifier of the cluster. */
+    clusterId: string;
+    /** Identifier of the source. */
+    sourceId: string;
+    /** Simulcast ID. */
+    simulcastId: string;
+    /** Server ID. */
+    serverId: string;
+    /** Is the feed active. */
+    active: boolean;
+    /** Stream publishing start time. */
+    startTime: string;
+    /** Stream publishing end time. */
+    endTime?: string;
+    /** Is recording allowed for this stream. */
+    isRecordingAllowed: boolean;
+    /** Packet loss percentage over last five minutes. */
+    packetLoss: number;
+    /** Is the feed redundant. */
+    isRedundant?: boolean;
+    /** Feed priority. */
+    priority?: number;
+    /** Framerate. */
+    frameRate: number;
+    /** Feed type. */
+    type: string;
+    /** Identifier of the token. */
+    tokenId: number;
+    /** Client. */
+    client: {
+        /** Country. */
+        country: string;
+        /** City. */
+        city: string;
+        /** Continent. */
+        continent: string;
+        /** coordinates. */
+        coordinates: number[];
+        /** Sub. */
+        sub: string[];
+        /** IP Address. */
+        ip: string;
+    };
+    /** Restream information. */
+    restreams: Restream[];
+    /** Feed statistics. */
+    feedStats: FeedStats[];
+    /** Details for all tracks. */
+    trackDetails: TrackDetails[];
+}
+/** Represents the details of a track object. */
+export interface TrackDetails {
+    /** Idenitfier of the track. */
+    trackId: string;
+    /** Encoding details. */
+    encodingDetails: EncodingDetails[];
+}
+/** Represents the encoding details of a track. */
+export interface EncodingDetails {
+    /** Encoding ID. */
+    encodingId: string;
+    /** I-frame rate. */
+    iFrameRate: number;
+    /** B-frame rate. */
+    bFrameRate: number;
+    /** P-frame rate. */
+    pFrameRate: number;
+    /** Encoding statistics. */
+    encodingStats: EncodingStats[];
+}
+/** Represents the encoding statistic of a track. */
+export interface EncodingStats {
+    /** Timestamp of the entry. */
+    timestamp: string;
+    /** Timestamp of the entry. */
+    resolution: {
+        /** Height of the frame. */
+        height: number;
+        /** Width of the frame. */
+        width: number;
+    };
+    /** Bitrate. */
+    bitRate: {
+        /** Audio bitrate. */
+        audioBitrate: number;
+        /** Video bitrate. */
+        videoBitrate: number;
+    };
+    /** Video codec. */
+    videoCodec: number;
+    /** Audio codec. */
+    audioCodec: number;
+    /** Frames. */
+    frames?: number;
+    /** RTT. */
+    rtt?: number;
+    /** Buffer Time. */
+    bufferTime?: number;
+    /** B-frames. */
+    bFrames?: number;
+}
 /** Represents a stream details. */
 export interface StreamDetails extends StreamSummary {
     /** Has redundant stream. */
@@ -57,106 +164,7 @@ export interface StreamDetails extends StreamSummary {
     /** Restreaming enabled. */
     restreaming: boolean;
     /** Feeds. */
-    feeds: {
-        /** Identifier of the stream. */
-        streamId: string;
-        /** Identifier of the feed. */
-        feedId: string;
-        /** Identifier of the cluster. */
-        clusterId: string;
-        /** Identifier of the source. */
-        sourceId: string;
-        /** Simulcast ID. */
-        simulcastId: string;
-        /** Server ID. */
-        serverId: string;
-        /** Is the feed active. */
-        active: boolean;
-        /** Stream publishing start time. */
-        startTime: string;
-        /** Stream publishing end time. */
-        endTime?: string;
-        /** Is recording allowed for this stream. */
-        isRecordingAllowed: boolean;
-        /** Packet loss percentage over last five minutes. */
-        packetLoss: number;
-        /** Is the feed redundant. */
-        isRedundant?: boolean;
-        /** Feed priority. */
-        priority?: number;
-        /** Framerate. */
-        frameRate: number;
-        /** Feed type. */
-        type: string;
-        /** Identifier of the token. */
-        tokenId: number;
-        /** Client. */
-        client: {
-            /** Country. */
-            country: string;
-            /** City. */
-            city: string;
-            /** Continent. */
-            continent: string;
-            /** coordinates. */
-            coordinates: number[];
-            /** Sub. */
-            sub: string[];
-            /** IP Address. */
-            ip: string;
-        };
-        /** Restream information. */
-        restreams: Restream[];
-        /** Feed statistics. */
-        feedStats: FeedStats[];
-        /** Details for all tracks. */
-        trackDetails: {
-            /** Idenitfier of the track. */
-            trackId: string;
-            /** Encoding details. */
-            encodingDetails: {
-                /** Encoding ID. */
-                encodingId: string;
-                /** I-frame rate. */
-                iFrameRate: number;
-                /** B-frame rate. */
-                bFrameRate: number;
-                /** P-frame rate. */
-                pFrameRate: number;
-                /** Encoding statistics. */
-                encodingStats: {
-                    /** Timestamp of the entry. */
-                    timestamp: string;
-                    /** Timestamp of the entry. */
-                    resolution: {
-                        /** Height of the frame. */
-                        height: number;
-                        /** Width of the frame. */
-                        width: number;
-                    };
-                    /** Bitrate. */
-                    bitRate: {
-                        /** Audio bitrate. */
-                        audioBitrate: number;
-                        /** Video bitrate. */
-                        videoBitrate: number;
-                    };
-                    /** Video codec. */
-                    videoCodec: number;
-                    /** Audio codec. */
-                    audioCodec: number;
-                    /** Frames. */
-                    frames?: number;
-                    /** RTT. */
-                    rtt?: number;
-                    /** Buffer Time. */
-                    bufferTime?: number;
-                    /** B-frames. */
-                    bFrames?: number;
-                }[];
-            }[];
-        }[];
-    }[];
+    feeds: Feed[];
 }
 /** Represents the restream information. */
 export interface Restream {

package/dist/streaming/types/webhooks.d.ts

@@ -8,8 +8,6 @@ export interface Webhook {
     secret: string;
     /** If `true` sends webhook events on feeds `start/stop`. */
     isFeedHooks: boolean;
-    /** If `true` sends webhook events on recording `start/error/complete/deleted`. */
-    isRecordingHooks: boolean;
     /** If `true` sends webhook events on thumbnail generation. */
     isThumbnailHooks: boolean;
     /** If `true` sends webhook events on transcoder instance updates. */
@@ -46,8 +44,6 @@ export interface UpdateWebhookRequest {
     refreshSecret?: boolean;
     /** Set to `true` to send webhook events on feeds `start/stop`. */
     isFeedHooks?: boolean;
-    /** Set to `true` to send webhook events on recording `start/error/complete/deleted`. */
-    isRecordingHooks?: boolean;
     /** Set to `true` to send webhook events on thumbnail generation. */
     isThumbnailHooks?: boolean;
     /** Set to `true` to send webhook events on transcoder instance updates. */
@@ -109,5 +105,14 @@ export interface AddWebhookRequest {
      */
     filter?: string;
 }
+/** Represents a webhook test request. */
+export interface TestWebhookRequest {
+    /** Type of webhook event to test. */
+    webhookType: WebhookType;
+    /** StreamName to include in test webhook payload. If not provided a default value will be used. */
+    streamName?: string;
+    /** TranscoderName to include in test webhook payload. If not provided a default value will be used.. */
+    transcoderName?: string;
+}
 /** Types of webhook events. */
-export type WebhookType = 'Recordings' | 'Thumbnail' | 'Transcoder' | 'Media' | 'Feeds' | 'ViewerConnection';
+export type WebhookType = 'Thumbnail' | 'Transcoder' | 'Media' | 'Feeds' | 'ViewerConnection';

package/dist/streaming/webhooks.d.ts

@@ -1,4 +1,4 @@
-import { Webhook, UpdateWebhookRequest, ListWebhooksRequest, AddWebhookRequest, WebhookType } from './types/webhooks';
+import { Webhook, UpdateWebhookRequest, ListWebhooksRequest, AddWebhookRequest, TestWebhookRequest } from './types/webhooks';
 /**
  * Gets the specified webhook.
  *
@@ -61,8 +61,8 @@ export declare const add: (apiSecret: string, webhook: AddWebhookRequest) => Pro
  * @see {@link https://optiview.dolby.com/docs/millicast/api/webhooks-test-webhook/}
  *
  * @param apiSecret The API Secret used to authenticate this request.
- * @param webhookType Type of webhook to test.
+ * @param testRequest Test request for the webhook.
  *
  * @returns A {@link !Promise Promise} whose fulfillment handler receives a flag indicating if the operation was successful or not.
  */
-export declare const test: (apiSecret: string, webhookType: WebhookType) => Promise<boolean>;
+export declare const test: (apiSecret: string, testRequest: TestWebhookRequest) => Promise<boolean>;

package/dist/streaming/webhooks.js

@@ -214,24 +214,28 @@ var add = exports.add = /*#__PURE__*/function () {
  * @see {@link https://optiview.dolby.com/docs/millicast/api/webhooks-test-webhook/}
  *
  * @param apiSecret The API Secret used to authenticate this request.
- * @param webhookType Type of webhook to test.
+ * @param testRequest Test request for the webhook.
  *
  * @returns A {@link !Promise Promise} whose fulfillment handler receives a flag indicating if the operation was successful or not.
  */
 var test = exports.test = /*#__PURE__*/function () {
-  var _ref6 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6(apiSecret, webhookType) {
+  var _ref6 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6(apiSecret, testRequest) {
     var options;
     return _regenerator().w(function (_context6) {
       while (1) switch (_context6.n) {
         case 0:
           options = {
             hostname: Urls.getRtsHostname(),
-            path: "/api/webhooks/test/".concat(webhookType),
+            path: "/api/webhooks/test/".concat(testRequest.webhookType),
             headers: {
               Accept: 'application/json',
               'Content-Type': 'application/json',
               Authorization: "Bearer ".concat(apiSecret)
-            }
+            },
+            body: JSON.stringify({
+              streamName: testRequest.streamName,
+              transcoderName: testRequest.transcoderName
+            })
           };
           _context6.n = 1;
           return (0, _httpHelpers.sendPost)(options);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dolbyio/dolbyio-rest-apis-client",
-    "version": "6.2.2",
+    "version": "6.3.1",
     "description": "Node.JS wrapper for the Dolby OptiView REST APIs",
     "main": "dist/index.js",
     "scripts": {
@@ -40,18 +40,18 @@
         }
     },
     "devDependencies": {
-        "@babel/cli": "^7.28.6",
-        "@babel/core": "^7.29.0",
-        "@babel/preset-env": "^7.29.0",
-        "@babel/preset-typescript": "^7.28.5",
+        "@babel/cli": "^7",
+        "@babel/core": "^7",
+        "@babel/preset-env": "^7",
+        "@babel/preset-typescript": "^7",
         "@types/follow-redirects": "^1.14.4",
-        "@types/node": "^25.6.2",
+        "@types/node": "^26.1.1",
         "babel-plugin-inline-replace-variables": "^1.3.1",
         "npm-watch": "^0.13.0",
-        "prettier": "^3.8.3",
-        "typedoc": "^0.28.19",
+        "prettier": "^3.9.5",
+        "typedoc": "^0.28.20",
         "typedoc-plugin-mdn-links": "^5.1.1",
-        "typescript": "^6.0.3"
+        "typescript": "^6"
     },
     "dependencies": {
         "follow-redirects": "^1.16.0",