@wave-av/sdk 2.0.4 → 2.0.5

package/dist/pipeline-types.d.ts

@@ -0,0 +1,188 @@
+export type StreamStatus = "idle" | "connecting" | "live" | "reconnecting" | "ending" | "ended" | "failed";
+export type StreamProtocol = "webrtc" | "srt" | "rtmp" | "hls" | "ndi" | "omt";
+export type StreamQuality = "source" | "4k" | "1080p" | "720p" | "480p" | "360p";
+export interface Stream extends Timestamps {
+    /** Unique stream identifier */
+    id: string;
+    /** Organization that owns the stream */
+    organization_id: string;
+    /** Human-readable stream title */
+    title: string;
+    /** Optional description */
+    description?: string;
+    /** Current lifecycle status */
+    status: StreamStatus;
+    /** Ingest protocol */
+    protocol: StreamProtocol;
+    /** URL to push media to */
+    ingest_url?: string;
+    /** URL for viewers to watch */
+    playback_url?: string;
+    /** Secret key for stream authentication */
+    stream_key?: string;
+    /** Video resolution (e.g., "1920x1080") */
+    resolution?: string;
+    /** Video frame rate in fps */
+    frame_rate?: number;
+    /** Video bitrate in kilobits per second */
+    bitrate_kbps?: number;
+    /** Current number of connected viewers */
+    viewer_count: number;
+    /** Whether recording is enabled */
+    recording_enabled: boolean;
+    /** Whether DVR (rewind during live) is enabled */
+    dvr_enabled: boolean;
+    /** Whether low-latency mode is active */
+    low_latency: boolean;
+    /** Maximum allowed stream duration in seconds */
+    max_duration_seconds?: number;
+    /** ISO 8601 timestamp when the stream went live */
+    started_at?: string;
+    /** ISO 8601 timestamp when the stream ended */
+    ended_at?: string;
+    /** Categorization tags */
+    tags?: string[];
+    /** Arbitrary key-value metadata */
+    metadata?: Metadata;
+}
+export interface CreateStreamRequest {
+    /** Human-readable stream title */
+    title: string;
+    /** Optional description */
+    description?: string;
+    /** Ingest protocol (default: webrtc) */
+    protocol?: StreamProtocol;
+    /** Quality preset for transcoding */
+    quality?: StreamQuality;
+    /** Enable recording of the stream */
+    recording_enabled?: boolean;
+    /** Enable DVR (rewind during live) */
+    dvr_enabled?: boolean;
+    /** Enable low-latency mode */
+    low_latency?: boolean;
+    /** Maximum allowed duration in seconds */
+    max_duration_seconds?: number;
+    /** Preferred ingest region (e.g., "us-east-1") */
+    region?: string;
+    /** Categorization tags */
+    tags?: string[];
+    /** Arbitrary key-value metadata */
+    metadata?: Metadata;
+    /** Webhook URL for stream lifecycle events */
+    webhook_url?: string;
+}
+export interface UpdateStreamRequest {
+    /** Updated title */
+    title?: string;
+    /** Updated description */
+    description?: string;
+    /** Toggle recording */
+    recording_enabled?: boolean;
+    /** Toggle DVR */
+    dvr_enabled?: boolean;
+    /** Toggle low-latency mode */
+    low_latency?: boolean;
+    /** Update metadata */
+    metadata?: Metadata;
+    /** Update tags */
+    tags?: string[];
+}
+export interface ListStreamsParams extends PaginationParams {
+    /** Filter by stream status */
+    status?: StreamStatus;
+    /** Filter by ingest protocol */
+    protocol?: StreamProtocol;
+    /** Filter streams created after this ISO 8601 timestamp */
+    created_after?: string;
+    /** Filter streams created before this ISO 8601 timestamp */
+    created_before?: string;
+    /** Field to order results by */
+    order_by?: "created_at" | "started_at" | "viewer_count" | "title";
+    /** Sort direction */
+    order?: "asc" | "desc";
+}
+export interface StreamHealth {
+    /** Stream this health report belongs to */
+    stream_id: string;
+    /** Overall health assessment */
+    status: "healthy" | "degraded" | "critical";
+    /** Current video bitrate in kbps */
+    bitrate_kbps: number;
+    /** Current frame rate in fps */
+    frame_rate: number;
+    /** Number of dropped frames since stream start */
+    dropped_frames: number;
+    /** End-to-end latency in milliseconds */
+    latency_ms: number;
+    /** Current viewer count */
+    viewer_count: number;
+    /** Seconds since the stream went live */
+    uptime_seconds: number;
+    /** ISO 8601 timestamp of the last received keyframe */
+    last_keyframe_at?: string;
+    /** Encoder software/hardware info reported by the source */
+    encoder_info?: string;
+}
+export interface StreamRecording extends Timestamps {
+    /** Unique recording identifier */
+    id: string;
+    /** Stream this recording was captured from */
+    stream_id: string;
+    /** Recording pipeline status */
+    status: "recording" | "processing" | "ready" | "failed";
+    /** Duration in seconds */
+    duration?: number;
+    /** File size in bytes */
+    file_size?: number;
+    /** URL to download the recording file */
+    download_url?: string;
+    /** URL for playback */
+    playback_url?: string;
+    /** Container format (e.g., "mp4", "ts") */
+    format?: string;
+}
+export interface IngestEndpoint {
+    /** Protocol for this endpoint */
+    protocol: StreamProtocol;
+    /** Primary ingest URL */
+    url: string;
+    /** Stream key for authentication */
+    stream_key: string;
+    /** Region where this endpoint is located */
+    region: string;
+    /** Backup ingest URL for failover */
+    backup_url?: string;
+}
+export interface ViewerSession {
+    /** Unique session identifier */
+    id: string;
+    /** Stream being watched */
+    stream_id: string;
+    /** Viewer's user or anonymous identifier */
+    viewer_id: string;
+    /** Playback protocol the viewer is using */
+    protocol: StreamProtocol;
+    /** Quality level the viewer is receiving */
+    quality: StreamQuality;
+    /** ISO 8601 timestamp when the viewer joined */
+    started_at: string;
+    /** Duration the viewer has been watching in seconds */
+    duration: number;
+    /** Viewer's geographic region */
+    region?: string;
+    /** Device type (e.g., "desktop", "mobile", "tv") */
+    device_type?: string;
+    /** Number of buffering events during this session */
+    buffering_events: number;
+}
+export interface StreamEvent {
+    /** Event type */
+    type: "stream.started" | "stream.ended" | "viewer.joined" | "viewer.left" | "health.degraded" | "recording.ready";
+    /** Stream this event relates to */
+    stream_id: string;
+    /** ISO 8601 timestamp when the event occurred */
+    timestamp: string;
+    /** Event-specific payload */
+    data?: Record<string, unknown>;
+}
+//# sourceMappingURL=pipeline-types.d.ts.map

package/dist/pipeline-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-types.d.ts","sourceRoot":"","sources":["../src/pipeline-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,YAAY,GACZ,MAAM,GACN,cAAc,GACd,QAAQ,GACR,OAAO,GACP,QAAQ,CAAC;AACb,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAC/E,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AACjF,MAAM,WAAW,MAAO,SAAQ,UAAU;IACxC,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,sBAAsB;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kDAAkD;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,yCAAyC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AACD,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,qCAAqC;IACrC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,mBAAmB;IAClC,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AACD,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,8BAA8B;IAC9B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,cAAc,GAAG,OAAO,CAAC;IAClE,qBAAqB;IACrB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AACD,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IAC5C,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;IACxD,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,QAAQ,EAAE,cAAc,CAAC;IACzB,4CAA4C;IAC5C,OAAO,EAAE,aAAa,CAAC;IACvB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AACD,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,IAAI,EACA,gBAAgB,GAChB,cAAc,GACd,eAAe,GACf,aAAa,GACb,iBAAiB,GACjB,iBAAiB,CAAC;IACtB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

package/dist/pipeline.d.ts

@@ -0,0 +1,224 @@
+/**
+ * WAVE SDK - Pipeline API
+ *
+ * Manage live streams across protocols (WebRTC, SRT, RTMP, HLS, NDI, OMT).
+ * The Pipeline is WAVE's core streaming engine for ingesting, transcoding,
+ * and delivering live video at scale.
+ *
+ * NOTE: This is a client SDK. All authorization checks are performed server-side.
+ * The API will return 403 Forbidden if the user lacks required permissions.
+ */
+import type { WaveClient, PaginationParams, PaginatedResponse } from "./client";
+import type { StreamProtocol, Stream, CreateStreamRequest, UpdateStreamRequest, ListStreamsParams, StreamHealth, StreamRecording, IngestEndpoint, ViewerSession } from './pipeline-types';
+/**
+ * Stream lifecycle status
+ */
+/**
+ * Supported streaming protocols
+ */
+/**
+ * Stream quality presets
+ */
+/**
+ * Live stream object
+ */
+/**
+ * Request body to create a new stream
+ */
+/**
+ * Request body to update an existing stream
+ */
+/**
+ * Query parameters for listing streams
+ */
+/**
+ * Real-time health metrics for a live stream
+ */
+/**
+ * A recording created from a live stream
+ */
+/**
+ * Ingest endpoint details for a stream
+ */
+/**
+ * A single viewer session on a stream
+ */
+/**
+ * A stream lifecycle or health event
+ */
+/**
+ * Pipeline API client
+ *
+ * All operations require appropriate permissions. Authorization is enforced
+ * server-side - the API returns 403 if the authenticated user lacks access.
+ *
+ * @example
+ * ```typescript
+ * import { WaveClient } from '@wave/sdk';
+ * import { PipelineAPI } from '@wave/sdk/pipeline';
+ *
+ * const client = new WaveClient({ apiKey: 'your-api-key' });
+ * const pipeline = new PipelineAPI(client);
+ *
+ * // Create a stream
+ * const stream = await pipeline.create({
+ *   title: 'My Live Stream',
+ *   protocol: 'webrtc',
+ *   recording_enabled: true,
+ * });
+ *
+ * // Start and wait for live
+ * await pipeline.start(stream.id);
+ * const live = await pipeline.waitForLive(stream.id);
+ * console.log('Stream is live:', live.playback_url);
+ *
+ * // Monitor health
+ * const health = await pipeline.getHealth(stream.id);
+ * console.log('Stream health:', health.status);
+ * ```
+ */
+export declare class PipelineAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * Create a new stream
+     *
+     * Requires: streams:create permission
+     */
+    create(request: CreateStreamRequest): Promise<Stream>;
+    /**
+     * Get a stream by ID
+     *
+     * Requires: streams:read permission
+     */
+    get(streamId: string): Promise<Stream>;
+    /**
+     * Update a stream
+     *
+     * Requires: streams:update permission
+     */
+    update(streamId: string, request: UpdateStreamRequest): Promise<Stream>;
+    /**
+     * Remove a stream
+     *
+     * Requires: streams:remove permission (server-side RBAC enforced)
+     */
+    remove(streamId: string): Promise<void>;
+    /**
+     * List streams with optional filters
+     *
+     * Requires: streams:read permission
+     */
+    list(params?: ListStreamsParams): Promise<PaginatedResponse<Stream>>;
+    /**
+     * 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
+     */
+    start(streamId: string): Promise<Stream>;
+    /**
+     * Stop a stream
+     *
+     * Gracefully ends the stream. Any active recording will be finalized.
+     *
+     * Requires: streams:stop permission
+     */
+    stop(streamId: string): Promise<Stream>;
+    /**
+     * 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
+     */
+    switchProtocol(streamId: string, protocol: StreamProtocol): Promise<Stream>;
+    /**
+     * Get real-time health metrics for a stream
+     *
+     * Returns current bitrate, frame rate, latency, and overall health status.
+     *
+     * Requires: streams:read permission
+     */
+    getHealth(streamId: string): Promise<StreamHealth>;
+    /**
+     * Get ingest endpoints for a stream
+     *
+     * Returns primary and backup URLs for each configured protocol.
+     *
+     * Requires: streams:read permission
+     */
+    getIngestEndpoints(streamId: string): Promise<IngestEndpoint[]>;
+    /**
+     * Start recording a live stream
+     *
+     * Begins capturing the stream to a file. The stream must be in "live" status.
+     *
+     * Requires: streams:record permission
+     */
+    startRecording(streamId: string): Promise<StreamRecording>;
+    /**
+     * Stop recording a live stream
+     *
+     * Finalizes the current recording. The recording enters "processing" status
+     * while it is being packaged.
+     *
+     * Requires: streams:record permission
+     */
+    stopRecording(streamId: string): Promise<StreamRecording>;
+    /**
+     * List recordings for a stream
+     *
+     * Requires: streams:read permission
+     */
+    listRecordings(streamId: string, params?: PaginationParams): Promise<PaginatedResponse<StreamRecording>>;
+    /**
+     * Get a specific recording
+     *
+     * Requires: streams:read permission
+     */
+    getRecording(streamId: string, recordingId: string): Promise<StreamRecording>;
+    /**
+     * List active viewer sessions for a stream
+     *
+     * Requires: streams:read permission
+     */
+    listViewers(streamId: string, params?: PaginationParams): Promise<PaginatedResponse<ViewerSession>>;
+    /**
+     * Get current and peak viewer count for a stream
+     *
+     * Requires: streams:read permission
+     */
+    getViewerCount(streamId: string): Promise<{
+        count: number;
+        peak: number;
+    }>;
+    /**
+     * 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
+     */
+    waitForLive(streamId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+        onProgress?: (stream: Stream) => void;
+    }): Promise<Stream>;
+}
+/**
+ * Create a Pipeline API instance
+ */
+export declare function createPipelineAPI(client: WaveClient): PipelineAPI;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EAGlB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAgB,cAAc,EAAiB,MAAM,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAe,MAAM,kBAAkB,CAAC;AAMpO;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAE9B,MAAM,EAAE,UAAU;IAQ9B;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3D;;;;OAIG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5C;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7E;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;;;OAIG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAsB1E;;;;;;;OAOG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9C;;;;;;OAMG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7C;;;;;;;OAOG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAQjF;;;;;;OAMG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIxD;;;;;;OAMG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAQrE;;;;;;OAMG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIhE;;;;;;;OAOG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/D;;;;OAIG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAO9C;;;;OAIG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAUnF;;;;OAIG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAO5C;;;;OAIG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAUhF;;;;;;;;;;;;;OAaG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;KACvC,GACA,OAAO,CAAC,MAAM,CAAC;CA6BnB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAEjE"}

package/dist/podcast.d.ts

@@ -0,0 +1,114 @@
+/**
+ * WAVE SDK - Podcast API
+ *
+ * Podcast production, episode management, and distribution.
+ */
+import type { WaveClient, PaginationParams, PaginatedResponse, Timestamps } from "./client";
+export type EpisodeStatus = "draft" | "processing" | "published" | "scheduled" | "failed";
+export type DistributionTarget = "spotify" | "apple" | "google" | "amazon" | "overcast";
+export interface Podcast extends Timestamps {
+    id: string;
+    organization_id: string;
+    title: string;
+    description: string;
+    cover_art_url?: string;
+    rss_url?: string;
+    category: string;
+    language: string;
+    explicit: boolean;
+    author: string;
+    email?: string;
+    website?: string;
+    subscriber_count: number;
+    episode_count: number;
+}
+export interface Episode extends Timestamps {
+    id: string;
+    podcast_id: string;
+    title: string;
+    description: string;
+    status: EpisodeStatus;
+    audio_url?: string;
+    duration_seconds: number;
+    file_size_bytes: number;
+    season_number?: number;
+    episode_number?: number;
+    published_at?: string;
+    scheduled_at?: string;
+    tags?: string[];
+}
+export interface PodcastAnalytics {
+    podcast_id: string;
+    total_downloads: number;
+    unique_listeners: number;
+    average_listen_duration: number;
+    top_episodes: {
+        episode_id: string;
+        downloads: number;
+    }[];
+    listener_geography: {
+        country: string;
+        count: number;
+    }[];
+}
+export interface PodcastDistribution {
+    target: DistributionTarget;
+    status: "connected" | "pending" | "error";
+    url?: string;
+}
+export interface CreatePodcastRequest {
+    title: string;
+    description: string;
+    category: string;
+    language?: string;
+    explicit?: boolean;
+    author?: string;
+    email?: string;
+}
+export interface CreateEpisodeRequest {
+    podcast_id: string;
+    title: string;
+    description: string;
+    audio_url?: string;
+    season_number?: number;
+    episode_number?: number;
+    tags?: string[];
+    scheduled_at?: string;
+}
+/**
+ * Podcast production, episode management, RSS feeds, and distribution.
+ *
+ * @example
+ * ```typescript
+ * const podcast = await wave.podcast.create({ title: "My Show", description: "...", category: "Tech" });
+ * await wave.podcast.createEpisode({ podcast_id: podcast.id, title: "Ep 1", description: "..." });
+ * await wave.podcast.distribute(podcast.id, ["spotify", "apple"]);
+ * ```
+ */
+export declare class PodcastAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    create(request: CreatePodcastRequest): Promise<Podcast>;
+    get(podcastId: string): Promise<Podcast>;
+    update(podcastId: string, updates: Partial<CreatePodcastRequest>): Promise<Podcast>;
+    remove(podcastId: string): Promise<void>;
+    list(params?: PaginationParams): Promise<PaginatedResponse<Podcast>>;
+    createEpisode(request: CreateEpisodeRequest): Promise<Episode>;
+    getEpisode(episodeId: string): Promise<Episode>;
+    updateEpisode(episodeId: string, updates: Partial<CreateEpisodeRequest>): Promise<Episode>;
+    removeEpisode(episodeId: string): Promise<void>;
+    publishEpisode(episodeId: string): Promise<Episode>;
+    listEpisodes(podcastId: string, params?: PaginationParams): Promise<PaginatedResponse<Episode>>;
+    getRSSFeed(podcastId: string): Promise<{
+        url: string;
+        xml: string;
+    }>;
+    getAnalytics(podcastId: string, params?: {
+        period?: string;
+    }): Promise<PodcastAnalytics>;
+    distribute(podcastId: string, targets: DistributionTarget[]): Promise<PodcastDistribution[]>;
+    getDistributionStatus(podcastId: string): Promise<PodcastDistribution[]>;
+}
+export declare function createPodcastAPI(client: WaveClient): PodcastAPI;
+//# sourceMappingURL=podcast.d.ts.map

package/dist/podcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"podcast.d.ts","sourceRoot":"","sources":["../src/podcast.ts"],"names":[],"mappings":"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"}

package/dist/prism.d.ts

@@ -0,0 +1,133 @@
+/**
+ * WAVE SDK - Prism API
+ *
+ * Virtual Device Bridge - present network AV sources (NDI, ONVIF, VISCA, Dante)
+ * as standard USB UVC/UAC devices to conferencing apps.
+ */
+import type { WaveClient, PaginationParams, PaginatedResponse, Timestamps } from "./client";
+export type VirtualDeviceType = "camera" | "microphone";
+export type DeviceStatus = "created" | "starting" | "running" | "stopping" | "stopped" | "error";
+export type SourceProtocol = "ndi" | "onvif" | "srt" | "rtmp" | "webrtc" | "dante" | "cloudflare" | "livekit";
+export type PTZProtocol = "ndi" | "onvif" | "visca" | "pelcod" | "cgi" | "livekit";
+export interface VirtualDevice extends Timestamps {
+    id: string;
+    organization_id: string;
+    name: string;
+    type: VirtualDeviceType;
+    status: DeviceStatus;
+    source_protocol: SourceProtocol;
+    source_endpoint: string;
+    node_id: string;
+    resolution?: {
+        width: number;
+        height: number;
+    };
+    frame_rate?: number;
+    health_score: number;
+    ptz_enabled: boolean;
+    ptz_protocol?: PTZProtocol;
+}
+export interface PresetMapping extends Timestamps {
+    id: string;
+    device_id: string;
+    slot_number: number;
+    preset_name: string;
+    preset_token: string;
+    protocol: PTZProtocol;
+    transition_speed: number;
+}
+export interface DeviceHealth {
+    device_id: string;
+    status: "healthy" | "degraded" | "critical" | "offline";
+    latency_ms: number;
+    dropped_frames: number;
+    fps: number;
+    cpu_usage: number;
+    source_connected: boolean;
+    driver_connected: boolean;
+}
+export interface DiscoveredSource {
+    id: string;
+    name: string;
+    protocol: string;
+    address: string;
+    supports_ptz: boolean;
+    capabilities: string[];
+    discovered_at: string;
+}
+export interface CreateDeviceRequest {
+    name: string;
+    type: VirtualDeviceType;
+    source_protocol: SourceProtocol;
+    source_endpoint: string;
+    node_id: string;
+    resolution?: {
+        width: number;
+        height: number;
+    };
+    frame_rate?: number;
+    ptz_enabled?: boolean;
+    ptz_protocol?: PTZProtocol;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateDeviceRequest {
+    name?: string;
+    source_endpoint?: string;
+    resolution?: {
+        width: number;
+        height: number;
+    };
+    frame_rate?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface SetPresetRequest {
+    slot_number: number;
+    preset_name: string;
+    preset_token: string;
+    protocol: PTZProtocol;
+    transition_speed?: number;
+}
+export interface ListDevicesParams extends PaginationParams {
+    type?: VirtualDeviceType;
+    status?: DeviceStatus;
+    node_id?: string;
+    source_protocol?: SourceProtocol;
+    order_by?: string;
+    order?: "asc" | "desc";
+}
+/**
+ * Virtual Device Bridge - present network AV sources (NDI, ONVIF, VISCA, Dante)
+ * as standard USB UVC/UAC devices to conferencing apps (Zoom, Teams, Meet).
+ *
+ * @example
+ * ```typescript
+ * const device = await wave.prism.createDevice({ name: 'PTZ Cam', type: 'camera', source_protocol: 'ndi', source_endpoint: 'NDI-1', node_id: 'node_abc' });
+ * await wave.prism.startDevice(device.id);
+ * await wave.prism.setPreset(device.id, { slot_number: 1, preset_name: 'Wide', preset_token: 'p1', protocol: 'ndi' });
+ * const sources = await wave.prism.discoverSources({ protocols: ['ndi', 'onvif'] });
+ * ```
+ */
+export declare class PrismAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    createDevice(request: CreateDeviceRequest): Promise<VirtualDevice>;
+    getDevice(deviceId: string): Promise<VirtualDevice>;
+    updateDevice(deviceId: string, request: UpdateDeviceRequest): Promise<VirtualDevice>;
+    removeDevice(deviceId: string): Promise<void>;
+    listDevices(params?: ListDevicesParams): Promise<PaginatedResponse<VirtualDevice>>;
+    startDevice(deviceId: string): Promise<VirtualDevice>;
+    stopDevice(deviceId: string): Promise<VirtualDevice>;
+    getHealth(deviceId: string): Promise<DeviceHealth>;
+    discoverSources(options?: {
+        protocols?: string[];
+        subnet?: string;
+        timeout?: number;
+    }): Promise<DiscoveredSource[]>;
+    getPresets(deviceId: string): Promise<PresetMapping[]>;
+    setPreset(deviceId: string, request: SetPresetRequest): Promise<PresetMapping>;
+    removePreset(deviceId: string, slotNumber: number): Promise<void>;
+    recallPreset(deviceId: string, slotNumber: number): Promise<void>;
+}
+export declare function createPrismAPI(client: WaveClient): PrismAPI;
+//# sourceMappingURL=prism.d.ts.map