@wave-av/sdk 2.0.0 → 2.0.1

package/dist/clips.d.ts

@@ -0,0 +1,258 @@
+/**
+ * WAVE SDK - Clips API
+ *
+ * Create, manage, and export video clips from streams and recordings.
+ *
+ * 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, Timestamps, Metadata } from './client';
+/**
+ * Clip status
+ */
+export type ClipStatus = 'pending' | 'processing' | 'ready' | 'failed' | 'deleted';
+/**
+ * Clip export format
+ */
+export type ClipExportFormat = 'mp4' | 'webm' | 'mov' | 'gif' | 'mp3' | 'wav';
+/**
+ * Clip quality preset
+ */
+export type ClipQualityPreset = 'low' | 'medium' | 'high' | 'source' | 'custom';
+/**
+ * Clip source reference
+ */
+export interface ClipSource {
+    type: 'stream' | 'recording' | 'upload';
+    id: string;
+    start_time: number;
+    end_time: number;
+}
+/**
+ * Clip object
+ */
+export interface Clip extends Timestamps {
+    id: string;
+    organization_id: string;
+    title: string;
+    description?: string;
+    source: ClipSource;
+    status: ClipStatus;
+    duration: number;
+    thumbnail_url?: string;
+    playback_url?: string;
+    download_url?: string;
+    file_size?: number;
+    width?: number;
+    height?: number;
+    frame_rate?: number;
+    bitrate?: number;
+    codec?: string;
+    tags?: string[];
+    metadata?: Metadata;
+    error?: string;
+}
+/**
+ * Create clip request
+ */
+export interface CreateClipRequest {
+    title: string;
+    description?: string;
+    source: ClipSource;
+    quality?: ClipQualityPreset;
+    format?: ClipExportFormat;
+    tags?: string[];
+    metadata?: Metadata;
+    /** Enable AI-powered highlight detection */
+    auto_highlights?: boolean;
+    /** Webhook URL for status updates */
+    webhook_url?: string;
+}
+/**
+ * Update clip request
+ */
+export interface UpdateClipRequest {
+    title?: string;
+    description?: string;
+    tags?: string[];
+    metadata?: Metadata;
+}
+/**
+ * List clips filters
+ */
+export interface ListClipsParams extends PaginationParams {
+    status?: ClipStatus;
+    source_type?: 'stream' | 'recording' | 'upload';
+    source_id?: string;
+    tags?: string[];
+    created_after?: string;
+    created_before?: string;
+    order_by?: 'created_at' | 'duration' | 'title';
+    order?: 'asc' | 'desc';
+}
+/**
+ * Export clip request
+ */
+export interface ExportClipRequest {
+    format: ClipExportFormat;
+    quality?: ClipQualityPreset;
+    /** Custom resolution (e.g., "1920x1080") */
+    resolution?: string;
+    /** Custom bitrate in kbps */
+    bitrate?: number;
+    /** Include audio */
+    include_audio?: boolean;
+    /** Add watermark */
+    watermark?: {
+        image_url: string;
+        position: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
+        opacity?: number;
+        scale?: number;
+    };
+}
+/**
+ * Export job status
+ */
+export interface ClipExport extends Timestamps {
+    id: string;
+    clip_id: string;
+    status: 'pending' | 'processing' | 'ready' | 'failed';
+    format: ClipExportFormat;
+    download_url?: string;
+    file_size?: number;
+    expires_at?: string;
+    error?: string;
+}
+/**
+ * Auto-highlight result
+ */
+export interface ClipHighlight {
+    start_time: number;
+    end_time: number;
+    score: number;
+    type: 'action' | 'speech' | 'emotion' | 'custom';
+    label?: string;
+}
+/**
+ * Clips 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 { ClipsAPI } from '@wave/sdk/clips';
+ *
+ * const client = new WaveClient({ apiKey: 'your-api-key' });
+ * const clips = new ClipsAPI(client);
+ *
+ * // Create a clip from a stream
+ * const clip = await clips.create({
+ *   title: 'Best Moment',
+ *   source: {
+ *     type: 'stream',
+ *     id: 'stream_123',
+ *     start_time: 120,
+ *     end_time: 150,
+ *   },
+ * });
+ *
+ * // Wait for processing
+ * const ready = await clips.waitForReady(clip.id);
+ * console.log('Clip ready:', ready.playback_url);
+ * ```
+ */
+export declare class ClipsAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * Create a new clip
+     *
+     * Requires: clips:create permission
+     */
+    create(request: CreateClipRequest): Promise<Clip>;
+    /**
+     * Get a clip by ID
+     *
+     * Requires: clips:read permission
+     */
+    get(clipId: string): Promise<Clip>;
+    /**
+     * Update a clip
+     *
+     * Requires: clips:update permission
+     */
+    update(clipId: string, request: UpdateClipRequest): Promise<Clip>;
+    /**
+     * Remove a clip
+     *
+     * Requires: clips:remove permission (server-side RBAC enforced)
+     */
+    remove(clipId: string): Promise<void>;
+    /**
+     * List clips with optional filters
+     *
+     * Requires: clips:read permission
+     */
+    list(params?: ListClipsParams): Promise<PaginatedResponse<Clip>>;
+    /**
+     * Export a clip to a different format
+     *
+     * Requires: clips:export permission
+     */
+    exportClip(clipId: string, request: ExportClipRequest): Promise<ClipExport>;
+    /**
+     * Get export job status
+     *
+     * Requires: clips:read permission
+     */
+    getExport(clipId: string, exportId: string): Promise<ClipExport>;
+    /**
+     * List all exports for a clip
+     *
+     * Requires: clips:read permission
+     */
+    listExports(clipId: string, params?: PaginationParams): Promise<PaginatedResponse<ClipExport>>;
+    /**
+     * Detect highlights in source content
+     *
+     * Requires: clips:analyze permission
+     */
+    detectHighlights(sourceType: 'stream' | 'recording', sourceId: string, options?: {
+        types?: ('action' | 'speech' | 'emotion')[];
+        min_score?: number;
+        max_results?: number;
+    }): Promise<ClipHighlight[]>;
+    /**
+     * Generate clips from detected highlights
+     *
+     * Requires: clips:create permission
+     */
+    createFromHighlights(sourceType: 'stream' | 'recording', sourceId: string, options?: {
+        min_score?: number;
+        max_clips?: number;
+        title_prefix?: string;
+        tags?: string[];
+    }): Promise<Clip[]>;
+    /**
+     * Wait for a clip to be ready
+     */
+    waitForReady(clipId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+        onProgress?: (clip: Clip) => void;
+    }): Promise<Clip>;
+    /**
+     * Wait for an export to be ready
+     */
+    waitForExport(clipId: string, exportId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+    }): Promise<ClipExport>;
+}
+/**
+ * Create a Clips API instance
+ */
+export declare function createClipsAPI(client: WaveClient): ClipsAPI;

package/dist/clips.d.ts.map

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

package/dist/cloud-switcher.d.ts

@@ -0,0 +1,65 @@
+/**
+ * WAVE Cloud Switcher SDK
+ *
+ * Control cloud video switchers programmatically.
+ *
+ * @packageDocumentation
+ */
+import type { WaveClient } from './client';
+export interface SwitcherInstance {
+    readonly id: string;
+    readonly name: string;
+    readonly status: 'idle' | 'live' | 'error';
+    readonly inputCount: number;
+    readonly outputCount: number;
+    readonly resolution: '720p' | '1080p' | '4k';
+    readonly frameRate: 30 | 60;
+    readonly tier: 'starter' | 'pro' | 'enterprise';
+    readonly createdAt: string;
+}
+export interface SwitcherSource {
+    readonly id: string;
+    readonly type: 'webrtc' | 'srt' | 'ndi' | 'rtmp' | 'hls';
+    readonly label: string;
+    readonly status: 'connecting' | 'active' | 'error' | 'disconnected';
+}
+export interface TransitionOptions {
+    readonly type: 'cut' | 'mix' | 'wipe' | 'dip' | 'dve';
+    readonly durationMs?: number;
+    readonly wipePattern?: string;
+}
+export interface CreateSwitcherOptions {
+    readonly name: string;
+    readonly resolution?: '720p' | '1080p' | '4k';
+    readonly frameRate?: 30 | 60;
+}
+export interface AddSourceOptions {
+    readonly type: 'webrtc' | 'srt' | 'ndi' | 'rtmp';
+    readonly label: string;
+    readonly config: Record<string, unknown>;
+}
+export interface AddOutputOptions {
+    readonly type: 'rtmp' | 'srt' | 'hls' | 'recording';
+    readonly config: Record<string, unknown>;
+}
+export declare class CloudSwitcherAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    create(options: CreateSwitcherOptions): Promise<SwitcherInstance>;
+    get(switcherId: string): Promise<SwitcherInstance>;
+    list(): Promise<SwitcherInstance[]>;
+    remove(switcherId: string): Promise<void>;
+    addSource(switcherId: string, options: AddSourceOptions): Promise<SwitcherSource>;
+    removeSource(switcherId: string, sourceId: string): Promise<void>;
+    switchTo(switcherId: string, sourceId: string): Promise<void>;
+    transition(switcherId: string, options: TransitionOptions): Promise<void>;
+    addOutput(switcherId: string, options: AddOutputOptions): Promise<{
+        id: string;
+    }>;
+    startStreaming(switcherId: string, outputId: string): Promise<void>;
+    stopStreaming(switcherId: string, outputId: string): Promise<void>;
+    startRecording(switcherId: string): Promise<void>;
+    stopRecording(switcherId: string): Promise<void>;
+}
+export declare function createCloudSwitcherAPI(client: WaveClient): CloudSwitcherAPI;

package/dist/cloud-switcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-switcher.d.ts","sourceRoot":"","sources":["../src/cloud-switcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,cAAc,CAAC;CACrE;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAE/B,MAAM,EAAE,UAAU;IAIxB,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIjE,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIlD,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAInC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIjF,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAIjF,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAE3E"}

package/dist/collab-types.d.ts

@@ -0,0 +1,204 @@
+/**
+ * WAVE SDK - Collab API
+ *
+ * Real-time collaboration features for projects and media.
+ *
+ * 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';
+/**
+ * Collaboration room status
+ */
+export type RoomStatus = 'active' | 'closed' | 'archived';
+/**
+ * Participant role in collaboration
+ */
+export type ParticipantRole = 'owner' | 'editor' | 'commenter' | 'viewer';
+/**
+ * Presence status
+ */
+export type PresenceStatus = 'online' | 'away' | 'busy' | 'offline';
+/**
+ * Collaboration room
+ */
+export interface CollabRoom extends Timestamps {
+    id: string;
+    organization_id: string;
+    name: string;
+    description?: string;
+    resource_type: 'project' | 'clip' | 'document' | 'stream';
+    resource_id: string;
+    status: RoomStatus;
+    owner_id: string;
+    max_participants?: number;
+    participant_count: number;
+    allow_anonymous: boolean;
+    settings: RoomSettings;
+    metadata?: Metadata;
+}
+/**
+ * Room settings
+ */
+export interface RoomSettings {
+    voice_enabled: boolean;
+    video_enabled: boolean;
+    screen_share_enabled: boolean;
+    chat_enabled: boolean;
+    annotations_enabled: boolean;
+    playback_sync_enabled: boolean;
+    recording_enabled: boolean;
+}
+/**
+ * Room participant
+ */
+export interface Participant extends Timestamps {
+    id: string;
+    room_id: string;
+    user_id: string;
+    display_name: string;
+    avatar_url?: string;
+    role: ParticipantRole;
+    presence: PresenceStatus;
+    cursor_position?: CursorPosition;
+    selection?: Selection;
+    permissions: ParticipantPermissions;
+}
+/**
+ * Participant permissions
+ */
+export interface ParticipantPermissions {
+    can_edit: boolean;
+    can_comment: boolean;
+    can_invite: boolean;
+    can_export: boolean;
+    can_control_playback: boolean;
+}
+/**
+ * Cursor position for presence
+ */
+export interface CursorPosition {
+    x: number;
+    y: number;
+    element_id?: string;
+    timestamp: number;
+}
+/**
+ * Selection range
+ */
+export interface Selection {
+    start: number;
+    end: number;
+    element_id?: string;
+    type: 'text' | 'timeline' | 'range';
+}
+/**
+ * Comment
+ */
+export interface Comment extends Timestamps {
+    id: string;
+    room_id: string;
+    user_id: string;
+    display_name: string;
+    avatar_url?: string;
+    content: string;
+    timestamp?: number;
+    element_id?: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+    parent_id?: string;
+    resolved: boolean;
+    reactions: Reaction[];
+}
+/**
+ * Reaction
+ */
+export interface Reaction {
+    emoji: string;
+    user_id: string;
+    created_at: string;
+}
+/**
+ * Annotation
+ */
+export interface Annotation extends Timestamps {
+    id: string;
+    room_id: string;
+    user_id: string;
+    type: 'drawing' | 'text' | 'shape' | 'arrow' | 'highlight';
+    timestamp?: number;
+    duration?: number;
+    data: Record<string, unknown>;
+    color: string;
+    visible: boolean;
+}
+/**
+ * Create room request
+ */
+export interface CreateRoomRequest {
+    name: string;
+    description?: string;
+    resource_type: 'project' | 'clip' | 'document' | 'stream';
+    resource_id: string;
+    max_participants?: number;
+    allow_anonymous?: boolean;
+    settings?: Partial<RoomSettings>;
+    metadata?: Metadata;
+}
+/**
+ * Update room request
+ */
+export interface UpdateRoomRequest {
+    name?: string;
+    description?: string;
+    settings?: Partial<RoomSettings>;
+    metadata?: Metadata;
+}
+/**
+ * Invite request
+ */
+export interface InviteRequest {
+    email?: string;
+    user_id?: string;
+    role: ParticipantRole;
+    message?: string;
+}
+/**
+ * List rooms params
+ */
+export interface ListRoomsParams extends PaginationParams {
+    status?: RoomStatus;
+    resource_type?: 'project' | 'clip' | 'document' | 'stream';
+    resource_id?: string;
+}
+/**
+ * Collab 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 { CollabAPI } from '@wave/sdk/collab';
+ *
+ * const client = new WaveClient({ apiKey: 'your-api-key' });
+ * const collab = new CollabAPI(client);
+ *
+ * // Create a collaboration room for a project
+ * const room = await collab.createRoom({
+ *   name: 'Project Review',
+ *   resource_type: 'project',
+ *   resource_id: 'project_123',
+ *   settings: {
+ *     voice_enabled: true,
+ *     annotations_enabled: true,
+ *   },
+ * });
+ *
+ * // Get join token for real-time connection
+ * const token = await collab.getJoinToken(room.id);
+ * ```
+ */

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

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