@wave-av/sdk 2.0.0 → 2.0.1

package/dist/chapters.d.ts

@@ -0,0 +1,315 @@
+/**
+ * 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, PaginationParams, PaginatedResponse, Timestamps, Metadata } from './client';
+/**
+ * Chapter status
+ */
+export type ChapterStatus = 'pending' | 'processing' | 'ready' | 'failed';
+/**
+ * Chapter
+ */
+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;
+}
+/**
+ * Chapter set (collection of chapters for a media)
+ */
+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;
+}
+/**
+ * Generate chapters request
+ */
+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;
+}
+/**
+ * Create chapter set request
+ */
+export interface CreateChapterSetRequest {
+    media_id: string;
+    media_type: 'video' | 'audio' | 'stream';
+    name: string;
+    chapters: CreateChapterRequest[];
+    set_as_default?: boolean;
+    metadata?: Metadata;
+}
+/**
+ * Create chapter request
+ */
+export interface CreateChapterRequest {
+    title: string;
+    description?: string;
+    start_time: number;
+    end_time?: number;
+    thumbnail_url?: string;
+    metadata?: Metadata;
+}
+/**
+ * Update chapter request
+ */
+export interface UpdateChapterRequest {
+    title?: string;
+    description?: string;
+    start_time?: number;
+    end_time?: number;
+    thumbnail_url?: string;
+    order?: number;
+    metadata?: Metadata;
+}
+/**
+ * Update chapter set request
+ */
+export interface UpdateChapterSetRequest {
+    name?: string;
+    is_default?: boolean;
+    metadata?: Metadata;
+}
+/**
+ * List chapter sets params
+ */
+export interface ListChapterSetsParams extends PaginationParams {
+    media_id?: string;
+    media_type?: 'video' | 'audio' | 'stream';
+    status?: ChapterStatus;
+    is_auto_generated?: boolean;
+}
+/**
+ * Chapters 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 { ChaptersAPI } from '@wave/sdk/chapters';
+ *
+ * const client = new WaveClient({ apiKey: 'your-api-key' });
+ * const chapters = new ChaptersAPI(client);
+ *
+ * // Generate chapters automatically
+ * const chapterSet = await chapters.generate({
+ *   media_id: 'video_123',
+ *   media_type: 'video',
+ *   method: 'combined',
+ *   generate_thumbnails: true,
+ * });
+ *
+ * // Wait for processing
+ * const ready = await chapters.waitForReady(chapterSet.id);
+ * console.log('Chapters:', ready.chapters);
+ * ```
+ */
+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;

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/client.d.ts

@@ -0,0 +1,191 @@
+/**
+ * WAVE SDK - Base API Client
+ *
+ * Core HTTP client with authentication, rate limiting, and retry logic.
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { TelemetryConfig } from './telemetry';
+/**
+ * SDK configuration options
+ */
+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;
+}
+/**
+ * Request options for individual API calls
+ */
+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>;
+}
+/**
+ * API error response structure
+ */
+export interface WaveAPIErrorResponse {
+    error: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+    request_id?: string;
+}
+/**
+ * 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>);
+    private isRetryable;
+}
+/**
+ * Rate limit error with retry information
+ */
+export declare class RateLimitError extends WaveError {
+    readonly retryAfter: number;
+    constructor(message: string, retryAfter: number, requestId?: 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;
+}
+/**
+ * WAVE API Base Client
+ *
+ * Handles authentication, rate limiting, and retry logic for all API requests.
+ *
+ * @example
+ * ```typescript
+ * const client = new WaveClient({
+ *   apiKey: process.env.WAVE_API_KEY!,
+ *   organizationId: 'org_123',
+ * });
+ *
+ * // Make a request
+ * const response = await client.get('/v1/clips');
+ * ```
+ */
+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
+     */
+    private parseErrorResponse;
+    /**
+     * Parse Retry-After header
+     */
+    private parseRetryAfter;
+    /**
+     * 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
+ */
+export interface PaginationParams {
+    limit?: number;
+    offset?: number;
+    cursor?: string;
+}
+/**
+ * Standard paginated response
+ */
+export interface PaginatedResponse<T> {
+    data: T[];
+    total: number;
+    has_more: boolean;
+    next_cursor?: string;
+}
+/**
+ * Media types supported by WAVE
+ */
+export type MediaType = 'video' | 'audio' | 'image';
+/**
+ * Standard timestamp fields
+ */
+export interface Timestamps {
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Standard metadata object
+ */
+export type Metadata = Record<string, string | number | boolean>;

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