@wave-av/sdk 2.0.4 → 2.0.5

package/dist/client-types.d.ts

@@ -0,0 +1,59 @@
+export interface WaveClientConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Organization ID for tenant isolation */
+    organizationId?: string;
+    /** Base URL for the API (default: https://api.wave.online) */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Maximum retry attempts for failed requests (default: 3) */
+    maxRetries?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Custom headers to include in all requests */
+    customHeaders?: Record<string, string>;
+    /** Optional telemetry configuration for OpenTelemetry integration */
+    telemetry?: TelemetryConfig;
+}
+export interface RequestOptions extends RequestInit {
+    /** Skip retry logic for this request */
+    noRetry?: boolean;
+    /** Custom timeout for this request */
+    timeout?: number;
+    /** Query parameters */
+    params?: Record<string, string | number | boolean | undefined>;
+}
+export interface WaveAPIErrorResponse {
+    error: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+    request_id?: string;
+}
+export interface WaveClientEvents {
+    'request.start': (url: string, method: string) => void;
+    'request.success': (url: string, method: string, duration: number) => void;
+    'request.error': (url: string, method: string, error: Error) => void;
+    'request.retry': (url: string, method: string, attempt: number, delay: number) => void;
+    'rate_limit.hit': (retryAfter: number) => void;
+}
+export interface PaginationParams {
+    limit?: number;
+    offset?: number;
+    cursor?: string;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    total: number;
+    has_more: boolean;
+    next_cursor?: string;
+}
+export type MediaType = 'video' | 'audio' | 'image';
+export interface Timestamps {
+    created_at: string;
+    updated_at: string;
+}
+export type Metadata = Record<string, string | number | boolean>;
+//# sourceMappingURL=client-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client-types.d.ts","sourceRoot":"","sources":["../src/client-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AACD,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;CAChE;AACD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3E,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACrE,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvF,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AACD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AACpD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,119 @@
+/**
+ * WAVE SDK - Base API Client
+ *
+ * Core HTTP client with authentication, rate limiting, and retry logic.
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { TelemetryConfig } from './telemetry';
+import type { WaveClientConfig, RequestOptions, WaveClientEvents } from './client-types';
+/**
+ * SDK configuration options
+ */
+/**
+ * Request options for individual API calls
+ */
+/**
+ * API error response structure
+ */
+/**
+ * WAVE SDK Error class
+ */
+export declare class WaveError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly requestId?: string;
+    readonly details?: Record<string, unknown>;
+    readonly retryable: boolean;
+    constructor(message: string, code: string, statusCode: number, requestId?: string, details?: Record<string, unknown>);
+}
+/**
+ * Rate limit error with retry information
+ */
+export declare class RateLimitError extends WaveError {
+    readonly retryAfter: number;
+    constructor(message: string, retryAfter: number, requestId?: string);
+}
+/**
+ * WAVE API Base Client
+ */
+export declare class WaveClient extends EventEmitter<WaveClientEvents> {
+    protected readonly config: Required<Omit<WaveClientConfig, 'customHeaders' | 'telemetry'>> & {
+        customHeaders: Record<string, string>;
+        telemetry?: TelemetryConfig;
+    };
+    constructor(config: WaveClientConfig);
+    /**
+     * Make a GET request
+     */
+    get<T>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a POST request
+     */
+    post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a PUT request
+     */
+    put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a PATCH request
+     */
+    patch<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a DELETE request
+     */
+    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Make an API request with retry logic
+     */
+    protected request<T>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Execute request with exponential backoff retry
+     */
+    private executeWithRetry;
+    /**
+     * Fetch with timeout
+     */
+    private fetchWithTimeout;
+    /**
+     * Build request headers
+     */
+    private buildHeaders;
+    /**
+     * Parse error response
+     */
+    /**
+     * Parse Retry-After header
+     */
+    /**
+     * Calculate exponential backoff delay
+     */
+    private calculateBackoff;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Log debug message
+     */
+    protected log(message: string, ...args: unknown[]): void;
+}
+/**
+ * Create a new WAVE client instance
+ */
+export declare function createClient(config: WaveClientConfig): WaveClient;
+/**
+ * Standard pagination parameters
+ */
+/**
+ * Standard paginated response
+ */
+/**
+ * Media types supported by WAVE
+ */
+/**
+ * Standard timestamp fields
+ */
+/**
+ * Standard metadata object
+ */
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/clips-types.d.ts

@@ -0,0 +1,31 @@
+export type ClipStatus = 'pending' | 'processing' | 'ready' | 'failed' | 'deleted';
+export type ClipExportFormat = 'mp4' | 'webm' | 'mov' | 'gif' | 'mp3' | 'wav';
+export type ClipQualityPreset = 'low' | 'medium' | 'high' | 'source' | 'custom';
+export interface ClipSource {
+    type: 'stream' | 'recording' | 'upload';
+    id: string;
+    start_time: number;
+    end_time: number;
+}
+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;
+}
+//# sourceMappingURL=clips-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clips-types.d.ts","sourceRoot":"","sources":["../src/clips-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,YAAY,GACZ,OAAO,GACP,QAAQ,GACR,SAAS,CAAC;AACd,MAAM,MAAM,gBAAgB,GACxB,KAAK,GACL,MAAM,GACN,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,CAAC;AACV,MAAM,MAAM,iBAAiB,GACzB,KAAK,GACL,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,QAAQ,CAAC;AACb,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,IAAK,SAAQ,UAAU;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/clips.d.ts

@@ -0,0 +1,230 @@
+/**
+ * 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';
+import type { ClipStatus, ClipExportFormat, ClipQualityPreset, ClipSource, Clip } from './clips-types';
+/**
+ * Clip status
+ */
+/**
+ * Clip export format
+ */
+/**
+ * Clip quality preset
+ */
+/**
+ * Clip source reference
+ */
+/**
+ * Clip object
+ */
+/**
+ * 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;
+//# sourceMappingURL=clips.d.ts.map

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,66 @@
+/**
+ * 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;
+//# sourceMappingURL=cloud-switcher.d.ts.map

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":"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"}