@wave-av/sdk 2.0.3 → 2.0.5

package/dist/studio-types.d.ts

@@ -0,0 +1,268 @@
+/**
+ * WAVE SDK - Studio API
+ *
+ * Multi-camera broadcast production system for creating, managing, and
+ * controlling live productions with sources, scenes, graphics, and audio mixing.
+ *
+ * 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 { PaginationParams, Timestamps, Metadata } from "./client";
+/**
+ * Production lifecycle status
+ */
+export type ProductionStatus = "idle" | "rehearsal" | "live" | "ending" | "ended";
+/**
+ * Input source type for a production
+ */
+export type SourceType = "camera" | "ndi" | "screen_share" | "rtmp_input" | "srt_input" | "media_file" | "browser" | "color_bars";
+/**
+ * Video transition type between sources or scenes
+ */
+export type TransitionType = "cut" | "dissolve" | "wipe" | "fade" | "stinger";
+/**
+ * Scene layout preset
+ */
+export type LayoutType = "fullscreen" | "split_2" | "split_3" | "split_4" | "pip" | "side_by_side" | "grid_2x2" | "grid_3x3" | "custom";
+/**
+ * Transition configuration for scene or source changes
+ */
+export interface TransitionConfig {
+    /** Transition effect type */
+    type: TransitionType;
+    /** Duration in milliseconds */
+    duration_ms: number;
+    /** Direction for directional transitions (e.g., wipe) */
+    direction?: "left" | "right" | "up" | "down";
+}
+/**
+ * Position and crop settings for a source within a scene
+ */
+export interface SceneSource {
+    /** Reference to the source */
+    source_id: string;
+    /** Position and dimensions within the scene canvas */
+    position: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        z_index: number;
+    };
+    /** Crop region (normalized 0-1 values) */
+    crop?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    /** Whether audio from this source is enabled */
+    audio_enabled?: boolean;
+    /** Audio volume (0-1) */
+    volume?: number;
+}
+/**
+ * Production scene with layout and source arrangement
+ */
+export interface Scene extends Timestamps {
+    id: string;
+    production_id: string;
+    name: string;
+    /** Layout preset for this scene */
+    layout: LayoutType;
+    /** Sources arranged within this scene */
+    sources: SceneSource[];
+    /** Transition to use when activating this scene */
+    transition_in?: TransitionConfig;
+    /** Whether this scene is currently active */
+    is_active: boolean;
+    /** Display order */
+    sort_order: number;
+}
+/**
+ * Input source connected to a production
+ */
+export interface Source extends Timestamps {
+    id: string;
+    production_id: string;
+    name: string;
+    /** Input source type */
+    type: SourceType;
+    /** Source URL or connection string */
+    url?: string;
+    /** Connection status */
+    status: "connected" | "disconnected" | "error";
+    /** Tally indicator (program = live, preview = next, off = inactive) */
+    tally: "program" | "preview" | "off";
+    /** Current audio level in dBFS */
+    audio_level?: number;
+    /** Audio volume (0-1) */
+    volume?: number;
+    /** Whether the source audio is muted */
+    muted?: boolean;
+    /** Whether PTZ (pan-tilt-zoom) control is enabled */
+    ptz_enabled?: boolean;
+    /** Position information for PTZ cameras */
+    position?: {
+        pan: number;
+        tilt: number;
+        zoom: number;
+    };
+}
+/**
+ * Live production session
+ */
+export interface Production extends Timestamps {
+    id: string;
+    organization_id: string;
+    title: string;
+    description?: string;
+    /** Current production lifecycle status */
+    status: ProductionStatus;
+    /** Source currently on program (live) output */
+    program_source_id?: string;
+    /** Source currently on preview output */
+    preview_source_id?: string;
+    /** Currently active scene */
+    active_scene_id?: string;
+    /** Whether recording is enabled */
+    recording_enabled: boolean;
+    /** Whether live streaming output is enabled */
+    streaming_enabled: boolean;
+    /** Current number of viewers */
+    viewer_count: number;
+    /** When the production went live */
+    started_at?: string;
+    /** When the production ended */
+    ended_at?: string;
+    /** Tags for organization and search */
+    tags?: string[];
+    /** Custom metadata */
+    metadata?: Metadata;
+}
+/**
+ * Graphic overlay element
+ */
+export interface Graphic extends Timestamps {
+    id: string;
+    production_id: string;
+    name: string;
+    /** Graphic overlay type */
+    type: "lower_third" | "full_screen" | "logo" | "ticker" | "scoreboard" | "custom";
+    /** Graphic content (template data, text, image URL, etc.) */
+    content: Record<string, unknown>;
+    /** Position on the canvas */
+    position?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Whether the graphic is currently visible on output */
+    visible: boolean;
+    /** Render layer (higher = on top) */
+    layer: number;
+}
+/**
+ * Audio mix channel for a source
+ */
+export interface AudioMixChannel {
+    /** Source this channel controls */
+    source_id: string;
+    /** Volume level (0-1) */
+    volume: number;
+    /** Whether the channel is muted */
+    muted: boolean;
+    /** Whether the channel is soloed */
+    solo: boolean;
+    /** Stereo pan (-1 left to 1 right) */
+    pan: number;
+    /** Whether EQ is enabled */
+    eq_enabled: boolean;
+    /** Whether the compressor is enabled */
+    compressor_enabled: boolean;
+}
+/**
+ * Create production request
+ */
+export interface CreateProductionRequest {
+    title: string;
+    description?: string;
+    /** Enable recording when going live */
+    recording_enabled?: boolean;
+    /** Enable live streaming output */
+    streaming_enabled?: boolean;
+    /** Default layout for new scenes */
+    default_layout?: LayoutType;
+    /** Tags for organization and search */
+    tags?: string[];
+    /** Custom metadata */
+    metadata?: Metadata;
+}
+/**
+ * Update production request
+ */
+export interface UpdateProductionRequest {
+    title?: string;
+    description?: string;
+    /** Enable or disable recording */
+    recording_enabled?: boolean;
+    /** Enable or disable live streaming output */
+    streaming_enabled?: boolean;
+    /** Custom metadata */
+    metadata?: Metadata;
+}
+/**
+ * List productions filters
+ */
+export interface ListProductionsParams extends PaginationParams {
+    /** Filter by production status */
+    status?: ProductionStatus;
+    /** Filter productions created after this date (ISO 8601) */
+    created_after?: string;
+    /** Filter productions created before this date (ISO 8601) */
+    created_before?: string;
+    /** Field to order results by */
+    order_by?: "created_at" | "updated_at" | "title" | "started_at";
+    /** Sort direction */
+    order?: "asc" | "desc";
+}
+/**
+ * Studio API client for multi-camera broadcast production
+ *
+ * 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 { StudioAPI } from '@wave/sdk/studio';
+ *
+ * const client = new WaveClient({ apiKey: 'your-api-key' });
+ * const studio = new StudioAPI(client);
+ *
+ * // Create a production
+ * const production = await studio.create({
+ *   title: 'Live Show',
+ *   recording_enabled: true,
+ *   streaming_enabled: true,
+ * });
+ *
+ * // Add a camera source
+ * const camera = await studio.addSource(production.id, {
+ *   name: 'Camera 1',
+ *   type: 'camera',
+ *   url: 'rtmp://ingest.wave.online/live/cam1',
+ * });
+ *
+ * // Go live
+ * await studio.start(production.id);
+ *
+ * // Switch program source with a dissolve
+ * await studio.setProgram(production.id, camera.id, {
+ *   type: 'dissolve',
+ *   duration_ms: 500,
+ * });
+ * ```
+ */
+//# sourceMappingURL=studio-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"studio-types.d.ts","sourceRoot":"","sources":["../src/studio-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACT,MAAM,UAAU,CAAC;AAOlB;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,KAAK,GACL,cAAc,GACd,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,SAAS,GACT,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,SAAS,GACT,SAAS,GACT,SAAS,GACT,KAAK,GACL,cAAc,GACd,UAAU,GACV,UAAU,GACV,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,EAAE;QACR,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,0CAA0C;IAC1C,IAAI,CAAC,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,gDAAgD;IAChD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,KAAM,SAAQ,UAAU;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,yCAAyC;IACzC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,mDAAmD;IACnD,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,MAAO,SAAQ,UAAU;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,MAAM,EAAE,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC;IAC/C,uEAAuE;IACvE,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;IACrC,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE;QACT,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,MAAM,EAAE,gBAAgB,CAAC;IACzB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+CAA+C;IAC/C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,UAAU;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;IAClF,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,6BAA6B;IAC7B,QAAQ,CAAC,EAAE;QACT,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oCAAoC;IACpC,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sBAAsB;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,kCAAkC;IAClC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,OAAO,GAAG,YAAY,CAAC;IAChE,qBAAqB;IACrB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG"}

package/dist/studio.d.ts

@@ -0,0 +1,235 @@
+/**
+ * WAVE SDK - Studio API
+ *
+ * Multi-camera broadcast production system for creating, managing, and
+ * controlling live productions with sources, scenes, graphics, and audio mixing.
+ *
+ * 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, PaginatedResponse } from "./client";
+export * from './studio-types';
+import type { AudioMixChannel, CreateProductionRequest, Graphic, LayoutType, ListProductionsParams, Production, Scene, SceneSource, Source, SourceType, TransitionConfig, UpdateProductionRequest } from './studio-types';
+export declare class StudioAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * Create a new production
+     *
+     * Requires: productions:create permission
+     */
+    create(request: CreateProductionRequest): Promise<Production>;
+    /**
+     * Get a production by ID
+     *
+     * Requires: productions:read permission
+     */
+    get(productionId: string): Promise<Production>;
+    /**
+     * Update a production
+     *
+     * Requires: productions:update permission
+     */
+    update(productionId: string, request: UpdateProductionRequest): Promise<Production>;
+    /**
+     * Remove a production
+     *
+     * Requires: productions:remove permission (server-side RBAC enforced)
+     */
+    remove(productionId: string): Promise<void>;
+    /**
+     * List productions with optional filters
+     *
+     * Requires: productions:read permission
+     */
+    list(params?: ListProductionsParams): Promise<PaginatedResponse<Production>>;
+    /**
+     * Start a production (go live)
+     *
+     * Transitions the production from 'idle' or 'rehearsal' to 'live'.
+     *
+     * Requires: productions:control permission
+     */
+    start(productionId: string): Promise<Production>;
+    /**
+     * Stop a production (end broadcast)
+     *
+     * Transitions the production to 'ending' and then 'ended'.
+     *
+     * Requires: productions:control permission
+     */
+    stop(productionId: string): Promise<Production>;
+    /**
+     * Start a rehearsal session
+     *
+     * Allows testing sources, scenes, and transitions without going live.
+     * Transitions the production from 'idle' to 'rehearsal'.
+     *
+     * Requires: productions:control permission
+     */
+    startRehearsal(productionId: string): Promise<Production>;
+    /**
+     * Add an input source to a production
+     *
+     * Requires: productions:sources:create permission
+     */
+    addSource(productionId: string, source: {
+        name: string;
+        type: SourceType;
+        url?: string;
+        ptz_enabled?: boolean;
+    }): Promise<Source>;
+    /**
+     * Remove a source from a production
+     *
+     * Requires: productions:sources:remove permission
+     */
+    removeSource(productionId: string, sourceId: string): Promise<void>;
+    /**
+     * List all sources for a production
+     *
+     * Requires: productions:sources:read permission
+     */
+    listSources(productionId: string): Promise<Source[]>;
+    /**
+     * Get a specific source by ID
+     *
+     * Requires: productions:sources:read permission
+     */
+    getSource(productionId: string, sourceId: string): Promise<Source>;
+    /**
+     * Create a new scene in a production
+     *
+     * Requires: productions:scenes:create permission
+     */
+    createScene(productionId: string, scene: {
+        name: string;
+        layout: LayoutType;
+        sources?: SceneSource[];
+        transition_in?: TransitionConfig;
+    }): Promise<Scene>;
+    /**
+     * Update an existing scene
+     *
+     * Requires: productions:scenes:update permission
+     */
+    updateScene(productionId: string, sceneId: string, updates: Partial<{
+        name: string;
+        layout: LayoutType;
+        sources: SceneSource[];
+        transition_in: TransitionConfig;
+        sort_order: number;
+    }>): Promise<Scene>;
+    /**
+     * Remove a scene from a production
+     *
+     * Requires: productions:scenes:remove permission
+     */
+    removeScene(productionId: string, sceneId: string): Promise<void>;
+    /**
+     * List all scenes for a production
+     *
+     * Requires: productions:scenes:read permission
+     */
+    listScenes(productionId: string): Promise<Scene[]>;
+    /**
+     * Activate a scene with an optional transition
+     *
+     * Sets the scene as the active scene for the production output.
+     *
+     * Requires: productions:scenes:control permission
+     */
+    activateScene(productionId: string, sceneId: string, transition?: TransitionConfig): Promise<Scene>;
+    /**
+     * Set the program (live) source with an optional transition
+     *
+     * Switches the currently live output to the specified source.
+     *
+     * Requires: productions:control permission
+     */
+    setProgram(productionId: string, sourceId: string, transition?: TransitionConfig): Promise<void>;
+    /**
+     * Set the preview source
+     *
+     * Loads a source into the preview output for inspection before going live.
+     *
+     * Requires: productions:control permission
+     */
+    setPreview(productionId: string, sourceId: string): Promise<void>;
+    /**
+     * Execute a transition between preview and program
+     *
+     * Swaps the current preview source into program using the specified transition.
+     *
+     * Requires: productions:control permission
+     */
+    transition(productionId: string, config: TransitionConfig): Promise<void>;
+    /**
+     * Add a graphic overlay to a production
+     *
+     * Requires: productions:graphics:create permission
+     */
+    addGraphic(productionId: string, graphic: {
+        name: string;
+        type: Graphic["type"];
+        content: Record<string, unknown>;
+        position?: Graphic["position"];
+        layer?: number;
+    }): Promise<Graphic>;
+    /**
+     * Update an existing graphic
+     *
+     * Requires: productions:graphics:update permission
+     */
+    updateGraphic(productionId: string, graphicId: string, updates: Partial<{
+        name: string;
+        type: Graphic["type"];
+        content: Record<string, unknown>;
+        position: Graphic["position"];
+        layer: number;
+    }>): Promise<Graphic>;
+    /**
+     * Remove a graphic from a production
+     *
+     * Requires: productions:graphics:remove permission
+     */
+    removeGraphic(productionId: string, graphicId: string): Promise<void>;
+    /**
+     * Show a graphic on the production output
+     *
+     * Makes the graphic visible on the live output.
+     *
+     * Requires: productions:graphics:control permission
+     */
+    showGraphic(productionId: string, graphicId: string): Promise<void>;
+    /**
+     * Hide a graphic from the production output
+     *
+     * Removes the graphic from the live output without deleting it.
+     *
+     * Requires: productions:graphics:control permission
+     */
+    hideGraphic(productionId: string, graphicId: string): Promise<void>;
+    /**
+     * Get the current audio mix for a production
+     *
+     * Returns volume, mute, solo, pan, and processing settings for all channels.
+     *
+     * Requires: productions:audio:read permission
+     */
+    getAudioMix(productionId: string): Promise<AudioMixChannel[]>;
+    /**
+     * Set the audio mix for a production
+     *
+     * Updates volume, mute, solo, pan, and processing settings for channels.
+     *
+     * Requires: productions:audio:control permission
+     */
+    setAudioMix(productionId: string, channels: AudioMixChannel[]): Promise<AudioMixChannel[]>;
+}
+/**
+ * Create a Studio API instance
+ */
+export declare function createStudioAPI(client: WaveClient): StudioAPI;
+//# sourceMappingURL=studio.d.ts.map

package/dist/studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../src/studio.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB,cAAc,gBAAgB,CAAC;AAC/B,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACvB,OAAO,EACP,UAAU,EACV,qBAAqB,EACrB,UAAU,EACV,KAAK,EACL,WAAW,EACX,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAExB,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAElC,MAAM,EAAE,UAAU;IAK9B;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IAInE;;;;OAIG;IACG,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpD;;;;OAIG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IAIzF;;;;OAIG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;;;OAIG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAkBlF;;;;;;OAMG;IACG,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAItD;;;;;;OAMG;IACG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIrD;;;;;;;OAOG;IACG,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAK/D;;;;OAIG;IACG,SAAS,CACb,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,UAAU,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,GACA,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;OAIG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE;;;;OAIG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI1D;;;;OAIG;IACG,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKxE;;;;OAIG;IACG,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,UAAU,CAAC;QACnB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;QACxB,aAAa,CAAC,EAAE,gBAAgB,CAAC;KAClC,GACA,OAAO,CAAC,KAAK,CAAC;IAIjB;;;;OAIG;IACG,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,UAAU,CAAC;QACnB,OAAO,EAAE,WAAW,EAAE,CAAC;QACvB,aAAa,EAAE,gBAAgB,CAAC;QAChC,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,GACD,OAAO,CAAC,KAAK,CAAC;IAIjB;;;;OAIG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE;;;;OAIG;IACG,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIxD;;;;;;OAMG;IACG,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,KAAK,CAAC;IAQjB;;;;;;OAMG;IACG,UAAU,CACd,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAOhB;;;;;;OAMG;IACG,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE;;;;;;OAMG;IACG,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/E;;;;OAIG;IACG,UAAU,CACd,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,OAAO,CAAC;IAInB;;;;OAIG;IACG,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,GACD,OAAO,CAAC,OAAO,CAAC;IAOnB;;;;OAIG;IACG,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E;;;;;;OAMG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE;;;;;;OAMG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE;;;;;;OAMG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAInE;;;;;;OAMG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAKjG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAE7D"}

package/dist/telemetry.d.ts

@@ -0,0 +1,77 @@
+/**
+ * WAVE SDK - Optional Telemetry Module
+ *
+ * Opt-in OpenTelemetry integration for observability of SDK calls.
+ * Disabled by default. Zero overhead when not enabled.
+ *
+ * @example
+ * ```typescript
+ * import { Wave } from '@wave/sdk';
+ *
+ * const wave = new Wave({
+ *   apiKey: process.env.WAVE_API_KEY!,
+ *   telemetry: { enabled: true, serviceName: 'my-app' },
+ * });
+ * ```
+ */
+/**
+ * Telemetry configuration options.
+ * Telemetry is opt-in only and disabled by default.
+ */
+export interface TelemetryConfig {
+    /** Enable telemetry span collection. Default: false */
+    enabled: boolean;
+    /** Service name reported in spans. Default: '@wave/sdk' */
+    serviceName?: string;
+}
+/**
+ * Attributes recorded on telemetry spans.
+ * Never includes PII, API keys, or request/response bodies.
+ */
+export interface TelemetrySpanAttributes {
+    /** The SDK method name (e.g., 'clips.list') */
+    'wave.sdk.method'?: string;
+    /** HTTP status code of the response */
+    'wave.sdk.status_code'?: number;
+    /** Error type (class name only, never the message) */
+    'wave.sdk.error_type'?: string;
+    /** Duration of the call in milliseconds */
+    'wave.sdk.duration_ms'?: number;
+}
+/**
+ * Initialize telemetry. Call once during SDK client construction.
+ * If @opentelemetry/api is not installed, telemetry silently remains disabled.
+ */
+export declare function initTelemetry(config: TelemetryConfig): void;
+/**
+ * Reset telemetry state. Useful for testing or teardown.
+ */
+export declare function resetTelemetry(): void;
+/**
+ * Check if telemetry is currently enabled.
+ */
+export declare function isTelemetryEnabled(): boolean;
+/**
+ * Wrap an async operation with an OpenTelemetry span.
+ *
+ * When telemetry is disabled, this calls `fn` directly with zero overhead
+ * (no span creation, no timing, no try/catch wrapper).
+ *
+ * Recorded attributes (never PII):
+ * - `wave.sdk.method`: operation name
+ * - `wave.sdk.duration_ms`: call duration
+ * - `wave.sdk.status_code`: HTTP status (if provided in attributes)
+ * - `wave.sdk.error_type`: error class name on failure
+ *
+ * @param operationName - Name of the SDK operation (e.g., 'clips.list')
+ * @param fn - The async function to execute
+ * @param attributes - Optional span attributes (status code, etc.)
+ * @returns The result of `fn`
+ */
+export declare function withTelemetry<T>(operationName: string, fn: () => Promise<T>, attributes?: Record<string, string | number | boolean>): Promise<T>;
+/**
+ * Synchronous version of withTelemetry for non-async operations.
+ * Same zero-overhead behavior when disabled.
+ */
+export declare function withTelemetrySync<T>(operationName: string, fn: () => T, attributes?: Record<string, string | number | boolean>): T;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sDAAsD;IACtD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2CAA2C;IAC3C,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AA8BD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAoB3D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,aAAa,EAAE,MAAM,EACrB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,OAAO,CAAC,CAAC,CAAC,CAwCZ;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,aAAa,EAAE,MAAM,EACrB,EAAE,EAAE,MAAM,CAAC,EACX,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,CAAC,CAqCH"}