@wave-av/sdk 2.0.4 → 2.0.6

package/dist/captions.d.ts

@@ -0,0 +1,218 @@
+/**
+ * WAVE SDK - Captions API
+ *
+ * Generate, manage, and translate captions for video content.
+ *
+ * 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 { CaptionFormat, CaptionTrack, CaptionCue, GenerateCaptionsRequest, UploadCaptionsRequest, UpdateCaptionsRequest, TranslateCaptionsRequest, BurnInCaptionsRequest, BurnInJob, ListCaptionsParams } from './captions-types';
+/**
+ * Caption status
+ */
+/**
+ * Caption format
+ */
+/**
+ * Caption track
+ */
+/**
+ * Caption cue (single caption segment)
+ */
+/**
+ * Word-level timing
+ */
+/**
+ * Caption styling
+ */
+/**
+ * Generate captions request
+ */
+/**
+ * Upload captions request
+ */
+/**
+ * Update captions request
+ */
+/**
+ * Translate captions request
+ */
+/**
+ * Burn-in captions request
+ */
+/**
+ * Burn-in job
+ */
+/**
+ * List captions params
+ */
+/**
+ * Captions API client
+ */
+export declare class CaptionsAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * Generate captions using AI
+     *
+     * Requires: captions:generate permission
+     */
+    generate(request: GenerateCaptionsRequest): Promise<CaptionTrack>;
+    /**
+     * Upload existing captions
+     *
+     * Requires: captions:create permission
+     */
+    upload(request: UploadCaptionsRequest): Promise<CaptionTrack>;
+    /**
+     * Get a caption track by ID
+     *
+     * Requires: captions:read permission
+     */
+    get(trackId: string): Promise<CaptionTrack>;
+    /**
+     * Update a caption track
+     *
+     * Requires: captions:update permission
+     */
+    update(trackId: string, request: UpdateCaptionsRequest): Promise<CaptionTrack>;
+    /**
+     * Remove a caption track
+     *
+     * Requires: captions:remove permission (server-side RBAC enforced)
+     */
+    remove(trackId: string): Promise<void>;
+    /**
+     * List caption tracks
+     *
+     * Requires: captions:read permission
+     */
+    list(params?: ListCaptionsParams): Promise<PaginatedResponse<CaptionTrack>>;
+    /**
+     * Get caption tracks for a specific media
+     *
+     * Requires: captions:read permission
+     */
+    getForMedia(mediaId: string, mediaType: 'video' | 'audio' | 'stream'): Promise<CaptionTrack[]>;
+    /**
+     * Get caption cues (segments)
+     *
+     * Requires: captions:read permission
+     */
+    getCues(trackId: string, params?: PaginationParams & {
+        start_time?: number;
+        end_time?: number;
+    }): Promise<PaginatedResponse<CaptionCue>>;
+    /**
+     * Update a caption cue
+     *
+     * Requires: captions:update permission
+     */
+    updateCue(trackId: string, cueId: string, updates: Partial<Pick<CaptionCue, 'text' | 'start_time' | 'end_time' | 'speaker' | 'style'>>): Promise<CaptionCue>;
+    /**
+     * Add a new caption cue
+     *
+     * Requires: captions:update permission
+     */
+    addCue(trackId: string, cue: Omit<CaptionCue, 'id' | 'confidence' | 'words'>): Promise<CaptionCue>;
+    /**
+     * Remove a caption cue
+     *
+     * Requires: captions:update permission (server-side RBAC enforced)
+     */
+    removeCue(trackId: string, cueId: string): Promise<void>;
+    /**
+     * Bulk update cues
+     *
+     * Requires: captions:update permission
+     */
+    bulkUpdateCues(trackId: string, updates: Array<{
+        id: string;
+        text?: string;
+        start_time?: number;
+        end_time?: number;
+    }>): Promise<{
+        updated: number;
+    }>;
+    /**
+     * Translate a caption track to another language
+     *
+     * Requires: captions:translate permission
+     */
+    translate(trackId: string, request: TranslateCaptionsRequest): Promise<CaptionTrack>;
+    /**
+     * Export captions in a specific format
+     *
+     * Requires: captions:read permission
+     */
+    exportFormat(trackId: string, format: CaptionFormat): Promise<{
+        url: string;
+        expires_at: string;
+    }>;
+    /**
+     * Get captions as plain text
+     *
+     * Requires: captions:read permission
+     */
+    getText(trackId: string): Promise<string>;
+    /**
+     * Burn captions into video
+     *
+     * Requires: captions:burnin permission
+     */
+    burnIn(request: BurnInCaptionsRequest): Promise<BurnInJob>;
+    /**
+     * Get burn-in job status
+     *
+     * Requires: captions:read permission
+     */
+    getBurnInJob(jobId: string): Promise<BurnInJob>;
+    /**
+     * Wait for burn-in to complete
+     */
+    waitForBurnIn(jobId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+        onProgress?: (job: BurnInJob) => void;
+    }): Promise<BurnInJob>;
+    /**
+     * Wait for caption generation to complete
+     */
+    waitForReady(trackId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+        onProgress?: (track: CaptionTrack) => void;
+    }): Promise<CaptionTrack>;
+    /**
+     * Get supported languages
+     *
+     * Requires: captions:read permission
+     */
+    getSupportedLanguages(): Promise<Array<{
+        code: string;
+        name: string;
+        native_name: string;
+        supports_generation: boolean;
+        supports_translation: boolean;
+    }>>;
+    /**
+     * Detect language from audio
+     *
+     * Requires: captions:generate permission
+     */
+    detectLanguage(mediaId: string, mediaType: 'video' | 'audio' | 'stream'): Promise<{
+        detected_language: string;
+        confidence: number;
+        alternatives: Array<{
+            language: string;
+            confidence: number;
+        }>;
+    }>;
+}
+/**
+ * Create a Captions API instance
+ */
+export declare function createCaptionsAPI(client: WaveClient): CaptionsAPI;
+//# sourceMappingURL=captions.d.ts.map

package/dist/captions.d.ts.map

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

package/dist/chapters-types.d.ts

@@ -0,0 +1,87 @@
+export type ChapterStatus = 'pending' | 'processing' | 'ready' | 'failed';
+export interface Chapter extends Timestamps {
+    id: string;
+    media_id: string;
+    title: string;
+    description?: string;
+    start_time: number;
+    end_time?: number;
+    thumbnail_url?: string;
+    order: number;
+    is_auto_generated: boolean;
+    confidence?: number;
+    metadata?: Metadata;
+}
+export interface ChapterSet extends Timestamps {
+    id: string;
+    organization_id: string;
+    media_id: string;
+    media_type: 'video' | 'audio' | 'stream';
+    name: string;
+    status: ChapterStatus;
+    is_default: boolean;
+    is_auto_generated: boolean;
+    chapters: Chapter[];
+    chapter_count: number;
+    error?: string;
+    metadata?: Metadata;
+}
+export interface GenerateChaptersRequest {
+    media_id: string;
+    media_type: 'video' | 'audio' | 'stream';
+    name?: string;
+    /** Minimum chapter duration in seconds */
+    min_duration?: number;
+    /** Maximum number of chapters */
+    max_chapters?: number;
+    /** Detection method */
+    method?: 'scene' | 'topic' | 'combined';
+    /** Use transcript for topic detection */
+    use_transcript?: boolean;
+    /** Caption track ID if using transcript */
+    caption_track_id?: string;
+    /** Generate thumbnails for chapters */
+    generate_thumbnails?: boolean;
+    /** Set as default chapter set */
+    set_as_default?: boolean;
+    /** Webhook URL for completion */
+    webhook_url?: string;
+    metadata?: Metadata;
+}
+export interface CreateChapterSetRequest {
+    media_id: string;
+    media_type: 'video' | 'audio' | 'stream';
+    name: string;
+    chapters: CreateChapterRequest[];
+    set_as_default?: boolean;
+    metadata?: Metadata;
+}
+export interface CreateChapterRequest {
+    title: string;
+    description?: string;
+    start_time: number;
+    end_time?: number;
+    thumbnail_url?: string;
+    metadata?: Metadata;
+}
+export interface UpdateChapterRequest {
+    title?: string;
+    description?: string;
+    start_time?: number;
+    end_time?: number;
+    thumbnail_url?: string;
+    order?: number;
+    metadata?: Metadata;
+}
+export interface UpdateChapterSetRequest {
+    name?: string;
+    is_default?: boolean;
+    metadata?: Metadata;
+}
+export interface ListChapterSetsParams extends PaginationParams {
+    media_id?: string;
+    media_type?: 'video' | 'audio' | 'stream';
+    status?: ChapterStatus;
+    is_auto_generated?: boolean;
+}
+//# sourceMappingURL=chapters-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chapters-types.d.ts","sourceRoot":"","sources":["../src/chapters-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAC1E,MAAM,WAAW,OAAQ,SAAQ,UAAU;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AACD,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AACD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;IACxC,yCAAyC;IACzC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iCAAiC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AACD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AACD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AACD,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AACD,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AACD,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC1C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B"}

package/dist/chapters.d.ts

@@ -0,0 +1,207 @@
+/**
+ * WAVE SDK - Chapters API
+ *
+ * Manage video chapters and smart chapter generation.
+ *
+ * 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';
+import type { Chapter, ChapterSet, GenerateChaptersRequest, CreateChapterSetRequest, CreateChapterRequest, UpdateChapterRequest, UpdateChapterSetRequest, ListChapterSetsParams } from './chapters-types';
+/**
+ * Chapter status
+ */
+/**
+ * Chapter
+ */
+/**
+ * Chapter set (collection of chapters for a media)
+ */
+/**
+ * Generate chapters request
+ */
+/**
+ * Create chapter set request
+ */
+/**
+ * Create chapter request
+ */
+/**
+ * Update chapter request
+ */
+/**
+ * Update chapter set request
+ */
+/**
+ * List chapter sets params
+ */
+/**
+ * Chapters API client
+ */
+export declare class ChaptersAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * Generate chapters using AI
+     *
+     * Requires: chapters:generate permission
+     */
+    generate(request: GenerateChaptersRequest): Promise<ChapterSet>;
+    /**
+     * Create a chapter set manually
+     *
+     * Requires: chapters:create permission
+     */
+    createSet(request: CreateChapterSetRequest): Promise<ChapterSet>;
+    /**
+     * Get a chapter set by ID
+     *
+     * Requires: chapters:read permission
+     */
+    getSet(setId: string): Promise<ChapterSet>;
+    /**
+     * Update a chapter set
+     *
+     * Requires: chapters:update permission
+     */
+    updateSet(setId: string, request: UpdateChapterSetRequest): Promise<ChapterSet>;
+    /**
+     * Remove a chapter set
+     *
+     * Requires: chapters:remove permission (canDelete verified server-side)
+     */
+    removeSet(setId: string): Promise<void>;
+    /**
+     * List chapter sets
+     *
+     * Requires: chapters:read permission
+     */
+    listSets(params?: ListChapterSetsParams): Promise<PaginatedResponse<ChapterSet>>;
+    /**
+     * Get the default chapter set for a media
+     *
+     * Requires: chapters:read permission
+     */
+    getDefaultSet(mediaId: string, mediaType: 'video' | 'audio' | 'stream'): Promise<ChapterSet | null>;
+    /**
+     * Duplicate a chapter set
+     *
+     * Requires: chapters:create permission
+     */
+    duplicateSet(setId: string, name?: string): Promise<ChapterSet>;
+    /**
+     * Add a chapter to a set
+     *
+     * Requires: chapters:update permission
+     */
+    addChapter(setId: string, chapter: CreateChapterRequest): Promise<Chapter>;
+    /**
+     * Get a chapter by ID
+     *
+     * Requires: chapters:read permission
+     */
+    getChapter(setId: string, chapterId: string): Promise<Chapter>;
+    /**
+     * Update a chapter
+     *
+     * Requires: chapters:update permission
+     */
+    updateChapter(setId: string, chapterId: string, request: UpdateChapterRequest): Promise<Chapter>;
+    /**
+     * Remove a chapter
+     *
+     * Requires: chapters:update permission (server-side RBAC enforced)
+     */
+    removeChapter(setId: string, chapterId: string): Promise<void>;
+    /**
+     * Reorder chapters
+     *
+     * Requires: chapters:update permission
+     */
+    reorderChapters(setId: string, chapterIds: string[]): Promise<ChapterSet>;
+    /**
+     * Bulk update chapters
+     *
+     * Requires: chapters:update permission
+     */
+    bulkUpdateChapters(setId: string, updates: Array<{
+        id: string;
+    } & Partial<UpdateChapterRequest>>): Promise<{
+        updated: number;
+    }>;
+    /**
+     * Generate thumbnail for a chapter
+     *
+     * Requires: chapters:update permission
+     */
+    generateThumbnail(setId: string, chapterId: string, options?: {
+        time?: number;
+    }): Promise<Chapter>;
+    /**
+     * Generate thumbnails for all chapters in a set
+     *
+     * Requires: chapters:update permission
+     */
+    generateAllThumbnails(setId: string): Promise<{
+        generated: number;
+    }>;
+    /**
+     * Export chapters in various formats
+     *
+     * Requires: chapters:read permission
+     */
+    exportChapters(setId: string, format: 'json' | 'youtube' | 'webvtt' | 'ffmpeg'): Promise<{
+        content: string;
+        format: string;
+    }>;
+    /**
+     * Import chapters from a format
+     *
+     * Requires: chapters:create permission
+     */
+    importChapters(mediaId: string, mediaType: 'video' | 'audio' | 'stream', format: 'json' | 'youtube' | 'webvtt' | 'ffmpeg', content: string, options?: {
+        name?: string;
+        set_as_default?: boolean;
+    }): Promise<ChapterSet>;
+    /**
+     * Wait for chapter generation to complete
+     */
+    waitForReady(setId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+        onProgress?: (set: ChapterSet) => void;
+    }): Promise<ChapterSet>;
+    /**
+     * Get chapter at a specific time
+     *
+     * Requires: chapters:read permission
+     */
+    getChapterAtTime(setId: string, time: number): Promise<Chapter | null>;
+    /**
+     * Merge chapters
+     *
+     * Requires: chapters:update permission
+     */
+    mergeChapters(setId: string, chapterIds: string[], options?: {
+        title?: string;
+        description?: string;
+    }): Promise<Chapter>;
+    /**
+     * Split a chapter at a specific time
+     *
+     * Requires: chapters:update permission
+     */
+    splitChapter(setId: string, chapterId: string, splitTime: number, options?: {
+        first_title?: string;
+        second_title?: string;
+    }): Promise<{
+        first: Chapter;
+        second: Chapter;
+    }>;
+}
+/**
+ * Create a Chapters API instance
+ */
+export declare function createChaptersAPI(client: WaveClient): ChaptersAPI;
+//# sourceMappingURL=chapters.d.ts.map

package/dist/chapters.d.ts.map

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

package/dist/chunk-I3V47I4W.mjs

@@ -0,0 +1,114 @@
+// src/billing.ts
+var BillingAPI = class {
+  client;
+  thresholds = [];
+  pollInterval = null;
+  config;
+  constructor(client, config) {
+    this.client = client;
+    this.config = {
+      pollIntervalMs: config?.pollIntervalMs ?? 6e4
+    };
+  }
+  /**
+   * Report a usage event to a billing meter.
+   * Events are aggregated by Stripe Billing Meters.
+   */
+  async reportUsage(event) {
+    await this.client.request("POST", "/billing/usage/track", {
+      meter_type: event.meterType,
+      value: event.value,
+      idempotency_key: event.idempotencyKey,
+      timestamp: event.timestamp?.toISOString(),
+      dimensions: event.dimensions
+    });
+  }
+  /**
+   * Report multiple usage events in a single request.
+   */
+  async reportUsageBatch(events) {
+    await this.client.request("POST", "/billing/usage/track/batch", {
+      events: events.map((e) => ({
+        meter_type: e.meterType,
+        value: e.value,
+        idempotency_key: e.idempotencyKey,
+        timestamp: e.timestamp?.toISOString(),
+        dimensions: e.dimensions
+      }))
+    });
+  }
+  /**
+   * Get current usage summary for a meter in the current billing period.
+   */
+  async getUsageSummary(meterType) {
+    return this.client.request("GET", `/billing/usage/meters?meter=${meterType}`);
+  }
+  /**
+   * Get usage summaries for all 6 billing meters.
+   */
+  async getAllUsageSummaries() {
+    return this.client.request("GET", "/billing/usage/meters");
+  }
+  /**
+   * Get current subscription status.
+   */
+  async getSubscriptionStatus() {
+    return this.client.request("GET", "/billing/status");
+  }
+  /**
+   * Register a callback when usage crosses a threshold percentage.
+   * Starts polling usage data if not already polling.
+   */
+  onUsageThreshold(meterType, thresholdPercent, callback) {
+    const entry = {
+      meterType,
+      threshold: thresholdPercent,
+      callback
+    };
+    this.thresholds.push(entry);
+    if (!this.pollInterval) {
+      this.startPolling();
+    }
+    return () => {
+      const idx = this.thresholds.indexOf(entry);
+      if (idx >= 0) this.thresholds.splice(idx, 1);
+      if (this.thresholds.length === 0) this.stopPolling();
+    };
+  }
+  /**
+   * Stop all polling and clean up.
+   */
+  destroy() {
+    this.stopPolling();
+    this.thresholds = [];
+  }
+  startPolling() {
+    this.pollInterval = setInterval(async () => {
+      try {
+        const summaries = await this.getAllUsageSummaries();
+        for (const summary of summaries) {
+          for (const threshold of this.thresholds) {
+            if (threshold.meterType === summary.meterType && summary.percentUsed >= threshold.threshold) {
+              threshold.callback(summary);
+            }
+          }
+        }
+      } catch {
+      }
+    }, this.config.pollIntervalMs);
+  }
+  stopPolling() {
+    if (this.pollInterval) {
+      clearInterval(this.pollInterval);
+      this.pollInterval = null;
+    }
+  }
+};
+function createBillingAPI(client, config) {
+  return new BillingAPI(client, config);
+}
+
+export {
+  BillingAPI,
+  createBillingAPI
+};