@wave-av/sdk 2.0.4 → 2.0.5

package/dist/transcribe-types.d.ts

@@ -0,0 +1,154 @@
+/**
+ * WAVE SDK - Transcribe API
+ *
+ * Audio and video transcription with speaker diarization.
+ *
+ * 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';
+/**
+ * Transcription status
+ */
+export type TranscriptionStatus = 'pending' | 'processing' | 'ready' | 'failed';
+/**
+ * Transcription model
+ */
+export type TranscriptionModel = 'standard' | 'enhanced' | 'whisper-large' | 'whisper-medium' | 'medical' | 'legal';
+/**
+ * Transcription job
+ */
+export interface Transcription extends Timestamps {
+    id: string;
+    organization_id: string;
+    source_url?: string;
+    source_type: 'upload' | 'url' | 'stream' | 'recording';
+    source_id?: string;
+    status: TranscriptionStatus;
+    language: string;
+    detected_language?: string;
+    model: TranscriptionModel;
+    duration?: number;
+    word_count?: number;
+    confidence?: number;
+    speaker_count?: number;
+    cost?: number;
+    error?: string;
+    metadata?: Metadata;
+}
+/**
+ * Transcription segment
+ */
+export interface TranscriptionSegment {
+    id: string;
+    start_time: number;
+    end_time: number;
+    text: string;
+    speaker?: string;
+    speaker_id?: number;
+    confidence: number;
+    words?: TranscriptionWord[];
+}
+/**
+ * Word-level transcription
+ */
+export interface TranscriptionWord {
+    word: string;
+    start_time: number;
+    end_time: number;
+    confidence: number;
+    speaker_id?: number;
+}
+/**
+ * Speaker info
+ */
+export interface Speaker {
+    id: number;
+    label: string;
+    segments_count: number;
+    total_duration: number;
+    confidence?: number;
+}
+/**
+ * Create transcription request
+ */
+export interface CreateTranscriptionRequest {
+    /** Source URL to transcribe */
+    source_url?: string;
+    /** Source type */
+    source_type: 'upload' | 'url' | 'stream' | 'recording';
+    /** Source ID for streams/recordings */
+    source_id?: string;
+    /** Language code (auto-detect if not specified) */
+    language?: string;
+    /** Transcription model */
+    model?: TranscriptionModel;
+    /** Enable speaker diarization */
+    speaker_diarization?: boolean;
+    /** Expected number of speakers */
+    speaker_count?: number;
+    /** Enable punctuation */
+    punctuation?: boolean;
+    /** Filter profanity */
+    profanity_filter?: boolean;
+    /** Custom vocabulary/terms */
+    vocabulary?: string[];
+    /** Boost specific words */
+    vocabulary_boost?: number;
+    /** Enable word timestamps */
+    word_timestamps?: boolean;
+    /** Callback URL for completion */
+    webhook_url?: string;
+    metadata?: Metadata;
+}
+/**
+ * Update transcription request
+ */
+export interface UpdateTranscriptionRequest {
+    metadata?: Metadata;
+}
+/**
+ * List transcriptions params
+ */
+export interface ListTranscriptionsParams extends PaginationParams {
+    status?: TranscriptionStatus;
+    source_type?: 'upload' | 'url' | 'stream' | 'recording';
+    language?: string;
+    model?: TranscriptionModel;
+    created_after?: string;
+    created_before?: string;
+}
+/**
+ * Export format
+ */
+export type TranscriptExportFormat = 'txt' | 'json' | 'srt' | 'vtt' | 'docx' | 'pdf';
+/**
+ * Transcribe 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 { TranscribeAPI } from '@wave/sdk/transcribe';
+ *
+ * const client = new WaveClient({ apiKey: 'your-api-key' });
+ * const transcribe = new TranscribeAPI(client);
+ *
+ * // Transcribe a video
+ * const job = await transcribe.create({
+ *   source_url: 'https://example.com/video.mp4',
+ *   source_type: 'url',
+ *   language: 'en',
+ *   speaker_diarization: true,
+ * });
+ *
+ * // Wait for completion
+ * const result = await transcribe.waitForReady(job.id);
+ *
+ * // Get the transcript
+ * const segments = await transcribe.getSegments(result.id);
+ * ```
+ */
+//# sourceMappingURL=transcribe-types.d.ts.map

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

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

package/dist/transcribe.d.ts

@@ -0,0 +1,219 @@
+/**
+ * WAVE SDK - Transcribe API
+ *
+ * Audio and video transcription with speaker diarization.
+ *
+ * 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';
+export * from './transcribe-types';
+import type { CreateTranscriptionRequest, ListTranscriptionsParams, Speaker, TranscriptExportFormat, Transcription, TranscriptionModel, TranscriptionSegment, UpdateTranscriptionRequest } from './transcribe-types';
+export declare class TranscribeAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * Create a transcription job
+     *
+     * Requires: transcribe:create permission
+     */
+    create(request: CreateTranscriptionRequest): Promise<Transcription>;
+    /**
+     * Get a transcription by ID
+     *
+     * Requires: transcribe:read permission
+     */
+    get(transcriptionId: string): Promise<Transcription>;
+    /**
+     * Update a transcription
+     *
+     * Requires: transcribe:update permission
+     */
+    update(transcriptionId: string, request: UpdateTranscriptionRequest): Promise<Transcription>;
+    /**
+     * Remove a transcription
+     *
+     * Requires: transcribe:remove permission (server-side RBAC enforced)
+     */
+    remove(transcriptionId: string): Promise<void>;
+    /**
+     * List transcriptions
+     *
+     * Requires: transcribe:read permission
+     */
+    list(params?: ListTranscriptionsParams): Promise<PaginatedResponse<Transcription>>;
+    /**
+     * Get transcription segments
+     *
+     * Requires: transcribe:read permission
+     */
+    getSegments(transcriptionId: string, params?: PaginationParams & {
+        start_time?: number;
+        end_time?: number;
+        speaker_id?: number;
+    }): Promise<PaginatedResponse<TranscriptionSegment>>;
+    /**
+     * Update a segment
+     *
+     * Requires: transcribe:update permission
+     */
+    updateSegment(transcriptionId: string, segmentId: string, updates: {
+        text?: string;
+        speaker?: string;
+        speaker_id?: number;
+    }): Promise<TranscriptionSegment>;
+    /**
+     * Merge segments
+     *
+     * Requires: transcribe:update permission
+     */
+    mergeSegments(transcriptionId: string, segmentIds: string[]): Promise<TranscriptionSegment>;
+    /**
+     * Split a segment
+     *
+     * Requires: transcribe:update permission
+     */
+    splitSegment(transcriptionId: string, segmentId: string, splitTime: number): Promise<{
+        first: TranscriptionSegment;
+        second: TranscriptionSegment;
+    }>;
+    /**
+     * Get speakers
+     *
+     * Requires: transcribe:read permission
+     */
+    getSpeakers(transcriptionId: string): Promise<Speaker[]>;
+    /**
+     * Update speaker label
+     *
+     * Requires: transcribe:update permission
+     */
+    updateSpeaker(transcriptionId: string, speakerId: number, label: string): Promise<Speaker>;
+    /**
+     * Merge speakers
+     *
+     * Requires: transcribe:update permission
+     */
+    mergeSpeakers(transcriptionId: string, speakerIds: number[], newLabel?: string): Promise<Speaker>;
+    /**
+     * Export transcription
+     *
+     * Requires: transcribe:read permission
+     */
+    exportTranscription(transcriptionId: string, format: TranscriptExportFormat, options?: {
+        include_timestamps?: boolean;
+        include_speakers?: boolean;
+        paragraph_breaks?: boolean;
+    }): Promise<{
+        url: string;
+        expires_at: string;
+    }>;
+    /**
+     * Get plain text transcript
+     *
+     * Requires: transcribe:read permission
+     */
+    getText(transcriptionId: string, options?: {
+        include_speakers?: boolean;
+        paragraph_breaks?: boolean;
+    }): Promise<string>;
+    /**
+     * Search within a transcription
+     *
+     * Requires: transcribe:read permission
+     */
+    search(transcriptionId: string, query: string, options?: {
+        case_sensitive?: boolean;
+        whole_word?: boolean;
+    }): Promise<Array<{
+        segment_id: string;
+        text: string;
+        start_time: number;
+        end_time: number;
+        highlight_ranges: Array<{
+            start: number;
+            end: number;
+        }>;
+    }>>;
+    /**
+     * Start real-time transcription
+     *
+     * Requires: transcribe:realtime permission
+     */
+    startRealtime(streamId: string, options?: {
+        language?: string;
+        model?: TranscriptionModel;
+        speaker_diarization?: boolean;
+    }): Promise<{
+        session_id: string;
+        websocket_url: string;
+        expires_at: string;
+    }>;
+    /**
+     * Stop real-time transcription
+     *
+     * Requires: transcribe:realtime permission
+     */
+    stopRealtime(sessionId: string): Promise<Transcription>;
+    /**
+     * Get real-time session status
+     *
+     * Requires: transcribe:read permission
+     */
+    getRealtimeStatus(sessionId: string): Promise<{
+        status: 'active' | 'paused' | 'stopped';
+        duration: number;
+        word_count: number;
+        segments_count: number;
+    }>;
+    /**
+     * Wait for transcription to complete
+     */
+    waitForReady(transcriptionId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+        onProgress?: (transcription: Transcription) => void;
+    }): Promise<Transcription>;
+    /**
+     * Detect language from audio
+     *
+     * Requires: transcribe:read permission
+     */
+    detectLanguage(sourceUrl: string): Promise<{
+        detected_language: string;
+        confidence: number;
+        alternatives: Array<{
+            language: string;
+            confidence: number;
+        }>;
+    }>;
+    /**
+     * Get supported languages
+     *
+     * Requires: transcribe:read permission
+     */
+    getSupportedLanguages(): Promise<Array<{
+        code: string;
+        name: string;
+        native_name: string;
+        models: TranscriptionModel[];
+    }>>;
+    /**
+     * Estimate transcription cost
+     *
+     * Requires: transcribe:read permission
+     */
+    estimateCost(durationSeconds: number, model?: TranscriptionModel, options?: {
+        speaker_diarization?: boolean;
+    }): Promise<{
+        estimated_cost: number;
+        currency: string;
+        breakdown: Record<string, number>;
+    }>;
+}
+/**
+ * Create a Transcribe API instance
+ */
+export declare function createTranscribeAPI(client: WaveClient): TranscribeAPI;
+//# sourceMappingURL=transcribe.d.ts.map

package/dist/transcribe.d.ts.map

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

package/dist/usb.d.ts

@@ -0,0 +1,65 @@
+/**
+ * WAVE SDK - USB API
+ *
+ * USB device relay, claiming, and capability management.
+ */
+import type { WaveClient, PaginationParams, PaginatedResponse } from "./client";
+export type USBDeviceClass = "video" | "audio" | "hid" | "storage" | "composite";
+export type USBDeviceStatus = "connected" | "claimed" | "in_use" | "disconnected";
+export interface USBDevice {
+    id: string;
+    node_id: string;
+    name: string;
+    vendor_id: string;
+    product_id: string;
+    serial_number?: string;
+    device_class: USBDeviceClass;
+    status: USBDeviceStatus;
+    manufacturer?: string;
+    speed: "low" | "full" | "high" | "super";
+    current_owner_id?: string;
+    capabilities: string[];
+    connected_at: string;
+    updated_at: string;
+}
+export interface USBDeviceCapabilities {
+    video_formats?: string[];
+    audio_formats?: string[];
+    max_resolution?: string;
+    max_frame_rate?: number;
+    supports_uvc: boolean;
+    supports_uac: boolean;
+}
+export interface ClaimRequest {
+    reason?: string;
+    exclusive?: boolean;
+}
+export interface ListUSBDevicesParams extends PaginationParams {
+    node_id?: string;
+    device_class?: USBDeviceClass;
+    status?: USBDeviceStatus;
+}
+/**
+ * USB device relay: claim, release, and manage USB devices across nodes.
+ *
+ * @example
+ * ```typescript
+ * const devices = await wave.usb.list({ device_class: "video" });
+ * await wave.usb.claim(devices.data[0].id);
+ * const caps = await wave.usb.getCapabilities(deviceId);
+ * ```
+ */
+export declare class UsbAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    list(params?: ListUSBDevicesParams): Promise<PaginatedResponse<USBDevice>>;
+    get(deviceId: string): Promise<USBDevice>;
+    claim(deviceId: string, request?: ClaimRequest): Promise<USBDevice>;
+    release(deviceId: string): Promise<USBDevice>;
+    getCapabilities(deviceId: string): Promise<USBDeviceCapabilities>;
+    listByNode(nodeId: string, params?: PaginationParams): Promise<PaginatedResponse<USBDevice>>;
+    configure(deviceId: string, config: Record<string, unknown>): Promise<USBDevice>;
+}
+export declare function createUsbAPI(client: WaveClient): UsbAPI;
+//# sourceMappingURL=usb.d.ts.map

package/dist/usb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usb.d.ts","sourceRoot":"","sources":["../src/usb.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEhF,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,CAAC;AACjF,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAC;AAElF,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,cAAc,CAAC;IAC7B,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;CACvB;AACD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AACD,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;gBAC1B,MAAM,EAAE,UAAU;IAIxB,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAK1E,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAGzC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAGnE,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAG7C,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAKjE,UAAU,CACd,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAMlC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;CAGvF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAEvD"}

package/dist/vault.d.ts

@@ -0,0 +1,122 @@
+/**
+ * WAVE SDK - Vault API
+ *
+ * Recording storage, VOD management, and archival policies.
+ */
+import type { WaveClient, PaginationParams, PaginatedResponse, Timestamps, Metadata } from "./client";
+export type RecordingStatus = "recording" | "processing" | "ready" | "archived" | "failed";
+export type StorageTier = "hot" | "warm" | "cold" | "archive";
+export interface Recording extends Timestamps {
+    id: string;
+    organization_id: string;
+    stream_id?: string;
+    title: string;
+    status: RecordingStatus;
+    duration_seconds: number;
+    file_size_bytes: number;
+    format: string;
+    resolution?: string;
+    frame_rate?: number;
+    storage_tier: StorageTier;
+    playback_url?: string;
+    download_url?: string;
+    thumbnail_url?: string;
+    tags?: string[];
+    metadata?: Metadata;
+    expires_at?: string;
+}
+export interface StorageUsage {
+    organization_id: string;
+    total_bytes: number;
+    hot_bytes: number;
+    warm_bytes: number;
+    cold_bytes: number;
+    archive_bytes: number;
+    recording_count: number;
+    quota_bytes: number;
+    usage_percent: number;
+}
+export interface ArchivePolicy extends Timestamps {
+    id: string;
+    name: string;
+    tier_after_days: {
+        warm?: number;
+        cold?: number;
+        archive?: number;
+        delete?: number;
+    };
+    applies_to: "all" | "tagged";
+    tags?: string[];
+}
+export interface UploadSession {
+    id: string;
+    upload_url: string;
+    expires_at: string;
+}
+export interface TranscodeJob extends Timestamps {
+    id: string;
+    recording_id: string;
+    status: "pending" | "processing" | "ready" | "failed";
+    progress_percent: number;
+    output_url?: string;
+    error?: string;
+}
+export interface ListRecordingsParams extends PaginationParams {
+    status?: RecordingStatus;
+    stream_id?: string;
+    storage_tier?: StorageTier;
+    tags?: string[];
+    order_by?: string;
+    order?: "asc" | "desc";
+}
+/**
+ * Recording storage, VOD management, transcoding, and archival policies.
+ *
+ * @example
+ * ```typescript
+ * const recording = await wave.vault.startRecording(streamId);
+ * const usage = await wave.vault.getStorageUsage();
+ * const url = await wave.vault.getDownloadUrl(recordingId);
+ * ```
+ */
+export declare class VaultAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    list(params?: ListRecordingsParams): Promise<PaginatedResponse<Recording>>;
+    get(recordingId: string): Promise<Recording>;
+    update(recordingId: string, updates: {
+        title?: string;
+        tags?: string[];
+        metadata?: Metadata;
+    }): Promise<Recording>;
+    remove(recordingId: string): Promise<void>;
+    getStorageUsage(): Promise<StorageUsage>;
+    createUpload(request: {
+        title: string;
+        format: string;
+        file_size_bytes: number;
+        tags?: string[];
+    }): Promise<UploadSession>;
+    completeUpload(uploadId: string): Promise<Recording>;
+    startRecording(streamId: string, options?: {
+        title?: string;
+        tags?: string[];
+    }): Promise<Recording>;
+    stopRecording(streamId: string): Promise<Recording>;
+    transcode(recordingId: string, request: {
+        format: string;
+        resolution?: string;
+        bitrate_kbps?: number;
+    }): Promise<TranscodeJob>;
+    getTranscodeJob(jobId: string): Promise<TranscodeJob>;
+    createArchivePolicy(policy: Omit<ArchivePolicy, "id" | "created_at" | "updated_at">): Promise<ArchivePolicy>;
+    listArchivePolicies(): Promise<ArchivePolicy[]>;
+    removeArchivePolicy(policyId: string): Promise<void>;
+    getDownloadUrl(recordingId: string): Promise<{
+        url: string;
+        expires_at: string;
+    }>;
+}
+export declare function createVaultAPI(client: WaveClient): VaultAPI;
+//# sourceMappingURL=vault.d.ts.map

package/dist/vault.d.ts.map

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