@wave-av/sdk 2.0.1 → 2.0.3

package/dist/pipeline-types.js

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/pipeline-types.ts
+var pipeline_types_exports = {};
+module.exports = __toCommonJS(pipeline_types_exports);

package/dist/pipeline.js

@@ -0,0 +1,263 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/pipeline.ts
+var pipeline_exports = {};
+__export(pipeline_exports, {
+  PipelineAPI: () => PipelineAPI,
+  createPipelineAPI: () => createPipelineAPI
+});
+module.exports = __toCommonJS(pipeline_exports);
+var PipelineAPI = class {
+  client;
+  basePath = "/v1/streams";
+  constructor(client) {
+    this.client = client;
+  }
+  // ==========================================================================
+  // Stream CRUD
+  // ==========================================================================
+  /**
+   * Create a new stream
+   *
+   * Requires: streams:create permission
+   */
+  async create(request) {
+    return this.client.post(this.basePath, request);
+  }
+  /**
+   * Get a stream by ID
+   *
+   * Requires: streams:read permission
+   */
+  async get(streamId) {
+    return this.client.get(`${this.basePath}/${streamId}`);
+  }
+  /**
+   * Update a stream
+   *
+   * Requires: streams:update permission
+   */
+  async update(streamId, request) {
+    return this.client.patch(`${this.basePath}/${streamId}`, request);
+  }
+  /**
+   * Remove a stream
+   *
+   * Requires: streams:remove permission (server-side RBAC enforced)
+   */
+  async remove(streamId) {
+    await this.client.delete(`${this.basePath}/${streamId}`);
+  }
+  /**
+   * List streams with optional filters
+   *
+   * Requires: streams:read permission
+   */
+  async list(params) {
+    const queryParams = {
+      limit: params?.limit,
+      offset: params?.offset,
+      cursor: params?.cursor,
+      status: params?.status,
+      protocol: params?.protocol,
+      created_after: params?.created_after,
+      created_before: params?.created_before,
+      order_by: params?.order_by,
+      order: params?.order
+    };
+    return this.client.get(this.basePath, {
+      params: queryParams
+    });
+  }
+  // ==========================================================================
+  // Stream Lifecycle
+  // ==========================================================================
+  /**
+   * Start a stream
+   *
+   * Transitions the stream from idle to connecting. The stream will move
+   * to "live" once media is received on the ingest endpoint.
+   *
+   * Requires: streams:start permission
+   */
+  async start(streamId) {
+    return this.client.post(`${this.basePath}/${streamId}/start`);
+  }
+  /**
+   * Stop a stream
+   *
+   * Gracefully ends the stream. Any active recording will be finalized.
+   *
+   * Requires: streams:stop permission
+   */
+  async stop(streamId) {
+    return this.client.post(`${this.basePath}/${streamId}/stop`);
+  }
+  /**
+   * Switch the ingest protocol for a live stream
+   *
+   * Performs a zero-downtime protocol switch. The stream will briefly
+   * enter "reconnecting" status during the transition.
+   *
+   * Requires: streams:update permission
+   */
+  async switchProtocol(streamId, protocol) {
+    return this.client.post(`${this.basePath}/${streamId}/switch-protocol`, { protocol });
+  }
+  // ==========================================================================
+  // Health & Monitoring
+  // ==========================================================================
+  /**
+   * Get real-time health metrics for a stream
+   *
+   * Returns current bitrate, frame rate, latency, and overall health status.
+   *
+   * Requires: streams:read permission
+   */
+  async getHealth(streamId) {
+    return this.client.get(`${this.basePath}/${streamId}/health`);
+  }
+  /**
+   * Get ingest endpoints for a stream
+   *
+   * Returns primary and backup URLs for each configured protocol.
+   *
+   * Requires: streams:read permission
+   */
+  async getIngestEndpoints(streamId) {
+    return this.client.get(`${this.basePath}/${streamId}/ingest-endpoints`);
+  }
+  // ==========================================================================
+  // Recording
+  // ==========================================================================
+  /**
+   * Start recording a live stream
+   *
+   * Begins capturing the stream to a file. The stream must be in "live" status.
+   *
+   * Requires: streams:record permission
+   */
+  async startRecording(streamId) {
+    return this.client.post(`${this.basePath}/${streamId}/recordings/start`);
+  }
+  /**
+   * Stop recording a live stream
+   *
+   * Finalizes the current recording. The recording enters "processing" status
+   * while it is being packaged.
+   *
+   * Requires: streams:record permission
+   */
+  async stopRecording(streamId) {
+    return this.client.post(`${this.basePath}/${streamId}/recordings/stop`);
+  }
+  /**
+   * List recordings for a stream
+   *
+   * Requires: streams:read permission
+   */
+  async listRecordings(streamId, params) {
+    return this.client.get(
+      `${this.basePath}/${streamId}/recordings`,
+      { params }
+    );
+  }
+  /**
+   * Get a specific recording
+   *
+   * Requires: streams:read permission
+   */
+  async getRecording(streamId, recordingId) {
+    return this.client.get(
+      `${this.basePath}/${streamId}/recordings/${recordingId}`
+    );
+  }
+  // ==========================================================================
+  // Viewers
+  // ==========================================================================
+  /**
+   * List active viewer sessions for a stream
+   *
+   * Requires: streams:read permission
+   */
+  async listViewers(streamId, params) {
+    return this.client.get(
+      `${this.basePath}/${streamId}/viewers`,
+      { params }
+    );
+  }
+  /**
+   * Get current and peak viewer count for a stream
+   *
+   * Requires: streams:read permission
+   */
+  async getViewerCount(streamId) {
+    return this.client.get(
+      `${this.basePath}/${streamId}/viewers/count`
+    );
+  }
+  // ==========================================================================
+  // Polling Helpers
+  // ==========================================================================
+  /**
+   * Wait for a stream to reach "live" status
+   *
+   * Polls the stream until it transitions to "live" or a terminal state.
+   * Useful after calling `start()` to wait for the encoder to connect.
+   *
+   * @param streamId - Stream to monitor
+   * @param options - Polling configuration
+   * @param options.pollInterval - Milliseconds between polls (default: 2000)
+   * @param options.timeout - Maximum wait time in milliseconds (default: 120000)
+   * @param options.onProgress - Called on each poll with the current stream state
+   * @returns The stream once it reaches "live" status
+   * @throws Error if the stream enters "failed" or "ended" status, or if the timeout is exceeded
+   */
+  async waitForLive(streamId, options) {
+    const pollInterval = options?.pollInterval || 2e3;
+    const timeout = options?.timeout || 12e4;
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+      const stream = await this.get(streamId);
+      if (options?.onProgress) {
+        options.onProgress(stream);
+      }
+      if (stream.status === "live") {
+        return stream;
+      }
+      if (stream.status === "failed") {
+        throw new Error(`Stream failed to go live: ${stream.id}`);
+      }
+      if (stream.status === "ended") {
+        throw new Error(`Stream ended before going live: ${stream.id}`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollInterval));
+    }
+    throw new Error(`Stream did not go live within ${timeout}ms`);
+  }
+};
+function createPipelineAPI(client) {
+  return new PipelineAPI(client);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PipelineAPI,
+  createPipelineAPI
+});

package/dist/pipeline.mjs

@@ -0,0 +1,9 @@
+import {
+  PipelineAPI,
+  createPipelineAPI
+} from "./chunk-O6DOGYP5.mjs";
+import "./chunk-Y6FXYEAI.mjs";
+export {
+  PipelineAPI,
+  createPipelineAPI
+};

package/dist/podcast.js

@@ -0,0 +1,94 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/podcast.ts
+var podcast_exports = {};
+__export(podcast_exports, {
+  PodcastAPI: () => PodcastAPI,
+  createPodcastAPI: () => createPodcastAPI
+});
+module.exports = __toCommonJS(podcast_exports);
+var PodcastAPI = class {
+  client;
+  basePath = "/v1/podcasts";
+  constructor(client) {
+    this.client = client;
+  }
+  async create(request) {
+    return this.client.post(this.basePath, request);
+  }
+  async get(podcastId) {
+    return this.client.get(`${this.basePath}/${podcastId}`);
+  }
+  async update(podcastId, updates) {
+    return this.client.patch(`${this.basePath}/${podcastId}`, updates);
+  }
+  async remove(podcastId) {
+    await this.client.delete(`${this.basePath}/${podcastId}`);
+  }
+  async list(params) {
+    return this.client.get(this.basePath, {
+      params
+    });
+  }
+  async createEpisode(request) {
+    return this.client.post(`${this.basePath}/${request.podcast_id}/episodes`, request);
+  }
+  async getEpisode(episodeId) {
+    return this.client.get(`/v1/episodes/${episodeId}`);
+  }
+  async updateEpisode(episodeId, updates) {
+    return this.client.patch(`/v1/episodes/${episodeId}`, updates);
+  }
+  async removeEpisode(episodeId) {
+    await this.client.delete(`/v1/episodes/${episodeId}`);
+  }
+  async publishEpisode(episodeId) {
+    return this.client.post(`/v1/episodes/${episodeId}/publish`);
+  }
+  async listEpisodes(podcastId, params) {
+    return this.client.get(`${this.basePath}/${podcastId}/episodes`, {
+      params
+    });
+  }
+  async getRSSFeed(podcastId) {
+    return this.client.get(`${this.basePath}/${podcastId}/rss`);
+  }
+  async getAnalytics(podcastId, params) {
+    return this.client.get(`${this.basePath}/${podcastId}/analytics`, {
+      params
+    });
+  }
+  async distribute(podcastId, targets) {
+    return this.client.post(`${this.basePath}/${podcastId}/distribute`, {
+      targets
+    });
+  }
+  async getDistributionStatus(podcastId) {
+    return this.client.get(`${this.basePath}/${podcastId}/distribution`);
+  }
+};
+function createPodcastAPI(client) {
+  return new PodcastAPI(client);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PodcastAPI,
+  createPodcastAPI
+});

package/dist/podcast.mjs

@@ -0,0 +1,9 @@
+import {
+  PodcastAPI,
+  createPodcastAPI
+} from "./chunk-3ZLK4J3V.mjs";
+import "./chunk-Y6FXYEAI.mjs";
+export {
+  PodcastAPI,
+  createPodcastAPI
+};

package/dist/prism.js

@@ -0,0 +1,82 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/prism.ts
+var prism_exports = {};
+__export(prism_exports, {
+  PrismAPI: () => PrismAPI,
+  createPrismAPI: () => createPrismAPI
+});
+module.exports = __toCommonJS(prism_exports);
+var PrismAPI = class {
+  client;
+  basePath = "/v1/prism";
+  constructor(client) {
+    this.client = client;
+  }
+  async createDevice(request) {
+    return this.client.post(`${this.basePath}/devices`, request);
+  }
+  async getDevice(deviceId) {
+    return this.client.get(`${this.basePath}/devices/${deviceId}`);
+  }
+  async updateDevice(deviceId, request) {
+    return this.client.patch(`${this.basePath}/devices/${deviceId}`, request);
+  }
+  async removeDevice(deviceId) {
+    await this.client.delete(`${this.basePath}/devices/${deviceId}`);
+  }
+  async listDevices(params) {
+    return this.client.get(`${this.basePath}/devices`, {
+      params
+    });
+  }
+  async startDevice(deviceId) {
+    return this.client.post(`${this.basePath}/devices/${deviceId}/start`);
+  }
+  async stopDevice(deviceId) {
+    return this.client.post(`${this.basePath}/devices/${deviceId}/stop`);
+  }
+  async getHealth(deviceId) {
+    return this.client.get(`${this.basePath}/devices/${deviceId}/health`);
+  }
+  async discoverSources(options) {
+    return this.client.post(`${this.basePath}/discovery`, options);
+  }
+  async getPresets(deviceId) {
+    return this.client.get(`${this.basePath}/devices/${deviceId}/presets`);
+  }
+  async setPreset(deviceId, request) {
+    return this.client.put(`${this.basePath}/devices/${deviceId}/presets`, request);
+  }
+  async removePreset(deviceId, slotNumber) {
+    await this.client.delete(`${this.basePath}/devices/${deviceId}/presets/${slotNumber}`);
+  }
+  async recallPreset(deviceId, slotNumber) {
+    await this.client.post(`${this.basePath}/devices/${deviceId}/presets/${slotNumber}/recall`);
+  }
+};
+function createPrismAPI(client) {
+  return new PrismAPI(client);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PrismAPI,
+  createPrismAPI
+});

package/dist/prism.mjs

@@ -0,0 +1,9 @@
+import {
+  PrismAPI,
+  createPrismAPI
+} from "./chunk-C2GQ756E.mjs";
+import "./chunk-Y6FXYEAI.mjs";
+export {
+  PrismAPI,
+  createPrismAPI
+};

package/dist/prompter.js

@@ -0,0 +1,99 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/prompter.ts
+var prompter_exports = {};
+__export(prompter_exports, {
+  createPrompterApi: () => createPrompterApi
+});
+module.exports = __toCommonJS(prompter_exports);
+function createPrompterApi(client) {
+  const basePath = "/api/v1/prompter";
+  return {
+    scripts: {
+      async list(params) {
+        return client.get(`${basePath}/scripts`, { params });
+      },
+      async get(scriptId) {
+        return client.get(`${basePath}/scripts/${scriptId}`);
+      },
+      async create(input) {
+        return client.post(`${basePath}/scripts`, input);
+      },
+      async update(scriptId, input) {
+        return client.patch(`${basePath}/scripts/${scriptId}`, input);
+      },
+      async delete(scriptId) {
+        return client.delete(`${basePath}/scripts/${scriptId}`);
+      },
+      async versions(scriptId) {
+        return client.get(`${basePath}/scripts/${scriptId}/versions`);
+      },
+      async restoreVersion(scriptId, versionNumber) {
+        return client.post(`${basePath}/scripts/${scriptId}/restore`, { versionNumber });
+      }
+    },
+    async generate(input) {
+      return client.post(`${basePath}/generate`, input);
+    },
+    async translate(scriptId, targetLanguage) {
+      return client.post(`${basePath}/scripts/${scriptId}/translate`, { targetLanguage });
+    },
+    sessions: {
+      async start(input) {
+        return client.post(`${basePath}/sessions`, input);
+      },
+      async get(sessionId) {
+        return client.get(`${basePath}/sessions/${sessionId}`);
+      },
+      async pause(sessionId) {
+        return client.post(`${basePath}/sessions/${sessionId}/pause`);
+      },
+      async resume(sessionId) {
+        return client.post(`${basePath}/sessions/${sessionId}/resume`);
+      },
+      async end(sessionId) {
+        return client.post(`${basePath}/sessions/${sessionId}/end`);
+      },
+      async analytics(sessionId) {
+        return client.get(`${basePath}/sessions/${sessionId}/analytics`);
+      },
+      async list(params) {
+        return client.get(`${basePath}/sessions`, { params });
+      }
+    },
+    templates: {
+      async search(params) {
+        return client.get(`${basePath}/templates`, { params });
+      },
+      async use(templateId) {
+        return client.post(`${basePath}/templates/${templateId}/use`);
+      }
+    },
+    usage: {
+      async summary(periodStart, periodEnd) {
+        return client.get(`${basePath}/usage`, { params: { periodStart, periodEnd } });
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createPrompterApi
+});

package/dist/prompter.mjs

@@ -0,0 +1,76 @@
+import "./chunk-Y6FXYEAI.mjs";
+
+// src/prompter.ts
+function createPrompterApi(client) {
+  const basePath = "/api/v1/prompter";
+  return {
+    scripts: {
+      async list(params) {
+        return client.get(`${basePath}/scripts`, { params });
+      },
+      async get(scriptId) {
+        return client.get(`${basePath}/scripts/${scriptId}`);
+      },
+      async create(input) {
+        return client.post(`${basePath}/scripts`, input);
+      },
+      async update(scriptId, input) {
+        return client.patch(`${basePath}/scripts/${scriptId}`, input);
+      },
+      async delete(scriptId) {
+        return client.delete(`${basePath}/scripts/${scriptId}`);
+      },
+      async versions(scriptId) {
+        return client.get(`${basePath}/scripts/${scriptId}/versions`);
+      },
+      async restoreVersion(scriptId, versionNumber) {
+        return client.post(`${basePath}/scripts/${scriptId}/restore`, { versionNumber });
+      }
+    },
+    async generate(input) {
+      return client.post(`${basePath}/generate`, input);
+    },
+    async translate(scriptId, targetLanguage) {
+      return client.post(`${basePath}/scripts/${scriptId}/translate`, { targetLanguage });
+    },
+    sessions: {
+      async start(input) {
+        return client.post(`${basePath}/sessions`, input);
+      },
+      async get(sessionId) {
+        return client.get(`${basePath}/sessions/${sessionId}`);
+      },
+      async pause(sessionId) {
+        return client.post(`${basePath}/sessions/${sessionId}/pause`);
+      },
+      async resume(sessionId) {
+        return client.post(`${basePath}/sessions/${sessionId}/resume`);
+      },
+      async end(sessionId) {
+        return client.post(`${basePath}/sessions/${sessionId}/end`);
+      },
+      async analytics(sessionId) {
+        return client.get(`${basePath}/sessions/${sessionId}/analytics`);
+      },
+      async list(params) {
+        return client.get(`${basePath}/sessions`, { params });
+      }
+    },
+    templates: {
+      async search(params) {
+        return client.get(`${basePath}/templates`, { params });
+      },
+      async use(templateId) {
+        return client.post(`${basePath}/templates/${templateId}/use`);
+      }
+    },
+    usage: {
+      async summary(periodStart, periodEnd) {
+        return client.get(`${basePath}/usage`, { params: { periodStart, periodEnd } });
+      }
+    }
+  };
+}
+export {
+  createPrompterApi
+};