@wave-av/sdk 2.0.4 → 2.0.6

package/dist/scene-types.d.ts

@@ -0,0 +1,191 @@
+/**
+ * WAVE SDK - Scene AI API
+ *
+ * AI-powered scene detection, analysis, and segmentation.
+ *
+ * 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';
+/**
+ * Scene detection status
+ */
+export type SceneDetectionStatus = 'pending' | 'processing' | 'ready' | 'failed';
+/**
+ * Scene type
+ */
+export type SceneType = 'intro' | 'outro' | 'transition' | 'main_content' | 'interview' | 'b_roll' | 'action' | 'dialogue' | 'montage' | 'credits' | 'advertisement' | 'unknown';
+/**
+ * Shot type
+ */
+export type ShotType = 'wide' | 'medium' | 'close_up' | 'extreme_close_up' | 'establishing' | 'over_shoulder' | 'pov' | 'aerial' | 'tracking' | 'static';
+/**
+ * Scene detection job
+ */
+export interface SceneDetection extends Timestamps {
+    id: string;
+    organization_id: string;
+    media_id: string;
+    media_type: 'video' | 'stream' | 'recording';
+    status: SceneDetectionStatus;
+    scene_count?: number;
+    shot_count?: number;
+    total_duration?: number;
+    processing_time?: number;
+    error?: string;
+    metadata?: Metadata;
+}
+/**
+ * Detected scene
+ */
+export interface Scene extends Timestamps {
+    id: string;
+    detection_id: string;
+    start_time: number;
+    end_time: number;
+    duration: number;
+    scene_type: SceneType;
+    confidence: number;
+    thumbnail_url?: string;
+    description?: string;
+    shots: Shot[];
+    labels: SceneLabel[];
+    visual_features: VisualFeatures;
+    audio_features?: AudioFeatures;
+    order: number;
+}
+/**
+ * Shot within a scene
+ */
+export interface Shot {
+    id: string;
+    start_time: number;
+    end_time: number;
+    duration: number;
+    shot_type: ShotType;
+    confidence: number;
+    thumbnail_url?: string;
+    motion_intensity: number;
+    dominant_colors: string[];
+}
+/**
+ * Scene label
+ */
+export interface SceneLabel {
+    label: string;
+    confidence: number;
+    category: string;
+}
+/**
+ * Visual features
+ */
+export interface VisualFeatures {
+    dominant_colors: string[];
+    brightness: number;
+    contrast: number;
+    saturation: number;
+    motion_intensity: number;
+    faces_detected: number;
+    text_detected: boolean;
+    objects: string[];
+}
+/**
+ * Audio features
+ */
+export interface AudioFeatures {
+    has_speech: boolean;
+    has_music: boolean;
+    loudness: number;
+    silence_ratio: number;
+    speech_ratio: number;
+    music_ratio: number;
+}
+/**
+ * Scene boundary
+ */
+export interface SceneBoundary {
+    timestamp: number;
+    type: 'cut' | 'fade' | 'dissolve' | 'wipe' | 'other';
+    confidence: number;
+    before_thumbnail?: string;
+    after_thumbnail?: string;
+}
+/**
+ * Create scene detection request
+ */
+export interface CreateSceneDetectionRequest {
+    media_id: string;
+    media_type: 'video' | 'stream' | 'recording';
+    options?: {
+        /** Minimum scene duration in seconds */
+        min_scene_duration?: number;
+        /** Detection sensitivity (0-1) */
+        sensitivity?: number;
+        /** Enable shot detection */
+        detect_shots?: boolean;
+        /** Enable scene classification */
+        classify_scenes?: boolean;
+        /** Enable audio analysis */
+        analyze_audio?: boolean;
+        /** Generate thumbnails */
+        generate_thumbnails?: boolean;
+        /** Extract visual features */
+        extract_features?: boolean;
+    };
+    /** Webhook URL for completion */
+    webhook_url?: string;
+    metadata?: Metadata;
+}
+/**
+ * List scene detections params
+ */
+export interface ListSceneDetectionsParams extends PaginationParams {
+    media_id?: string;
+    status?: SceneDetectionStatus;
+    created_after?: string;
+    created_before?: string;
+}
+/**
+ * Scene comparison result
+ */
+export interface SceneComparison {
+    source_scene_id: string;
+    target_scene_id: string;
+    similarity_score: number;
+    visual_similarity: number;
+    audio_similarity?: number;
+    duration_difference: number;
+    matched_labels: string[];
+}
+/**
+ * Scene AI 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 { SceneAPI } from '@wave/sdk/scene';
+ *
+ * const client = new WaveClient({ apiKey: 'your-api-key' });
+ * const scene = new SceneAPI(client);
+ *
+ * // Detect scenes in a video
+ * const detection = await scene.detect({
+ *   media_id: 'video_123',
+ *   media_type: 'video',
+ *   options: {
+ *     detect_shots: true,
+ *     classify_scenes: true,
+ *   },
+ * });
+ *
+ * // Wait for processing
+ * const result = await scene.waitForReady(detection.id);
+ *
+ * // Get detected scenes
+ * const scenes = await scene.getScenes(detection.id);
+ * ```
+ */
+//# sourceMappingURL=scene-types.d.ts.map

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

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

package/dist/scene.d.ts

@@ -0,0 +1,214 @@
+/**
+ * WAVE SDK - Scene AI API
+ *
+ * AI-powered scene detection, analysis, and segmentation.
+ *
+ * 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 { CreateSceneDetectionRequest, ListSceneDetectionsParams, Scene, SceneBoundary, SceneComparison, SceneDetection, SceneLabel, SceneType, Shot, ShotType } from './scene-types';
+export * from './scene-types';
+export declare class SceneAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * Start scene detection
+     *
+     * Requires: scene:detect permission
+     */
+    detect(request: CreateSceneDetectionRequest): Promise<SceneDetection>;
+    /**
+     * Get scene detection job
+     *
+     * Requires: scene:read permission
+     */
+    getDetection(detectionId: string): Promise<SceneDetection>;
+    /**
+     * Remove scene detection
+     *
+     * Requires: scene:remove permission (server-side RBAC enforced)
+     */
+    removeDetection(detectionId: string): Promise<void>;
+    /**
+     * List scene detections
+     *
+     * Requires: scene:read permission
+     */
+    listDetections(params?: ListSceneDetectionsParams): Promise<PaginatedResponse<SceneDetection>>;
+    /**
+     * Get scenes for a detection
+     *
+     * Requires: scene:read permission
+     */
+    getScenes(detectionId: string, params?: PaginationParams & {
+        scene_type?: SceneType;
+        min_duration?: number;
+        min_confidence?: number;
+    }): Promise<PaginatedResponse<Scene>>;
+    /**
+     * Get a specific scene
+     *
+     * Requires: scene:read permission
+     */
+    getScene(detectionId: string, sceneId: string): Promise<Scene>;
+    /**
+     * Update scene metadata
+     *
+     * Requires: scene:update permission
+     */
+    updateScene(detectionId: string, sceneId: string, updates: {
+        scene_type?: SceneType;
+        description?: string;
+        labels?: SceneLabel[];
+    }): Promise<Scene>;
+    /**
+     * Get scene at a specific timestamp
+     *
+     * Requires: scene:read permission
+     */
+    getSceneAtTime(detectionId: string, timestamp: number): Promise<Scene | null>;
+    /**
+     * Get scene boundaries (transitions)
+     *
+     * Requires: scene:read permission
+     */
+    getBoundaries(detectionId: string, params?: PaginationParams & {
+        type?: SceneBoundary['type'];
+    }): Promise<PaginatedResponse<SceneBoundary>>;
+    /**
+     * Detect scene boundaries only (without full analysis)
+     *
+     * Requires: scene:detect permission
+     */
+    detectBoundaries(mediaId: string, mediaType: 'video' | 'stream' | 'recording', options?: {
+        sensitivity?: number;
+        min_gap?: number;
+    }): Promise<SceneBoundary[]>;
+    /**
+     * Get shots for a scene
+     *
+     * Requires: scene:read permission
+     */
+    getShots(detectionId: string, sceneId: string, params?: PaginationParams): Promise<PaginatedResponse<Shot>>;
+    /**
+     * Get all shots for a detection
+     *
+     * Requires: scene:read permission
+     */
+    getAllShots(detectionId: string, params?: PaginationParams & {
+        shot_type?: ShotType;
+    }): Promise<PaginatedResponse<Shot & {
+        scene_id: string;
+    }>>;
+    /**
+     * Get scene summary/statistics
+     *
+     * Requires: scene:read permission
+     */
+    getSummary(detectionId: string): Promise<{
+        total_scenes: number;
+        total_shots: number;
+        scene_types: Record<SceneType, number>;
+        shot_types: Record<ShotType, number>;
+        average_scene_duration: number;
+        average_shot_duration: number;
+        dominant_colors: string[];
+        content_labels: Array<{
+            label: string;
+            count: number;
+        }>;
+    }>;
+    /**
+     * Get visual timeline
+     *
+     * Requires: scene:read permission
+     */
+    getTimeline(detectionId: string, options?: {
+        resolution?: number;
+        include_shots?: boolean;
+    }): Promise<Array<{
+        timestamp: number;
+        scene_id: string;
+        scene_type: SceneType;
+        shot_id?: string;
+        shot_type?: ShotType;
+        thumbnail_url?: string;
+    }>>;
+    /**
+     * Compare scenes between detections
+     *
+     * Requires: scene:read permission
+     */
+    compareScenes(sourceDetectionId: string, targetDetectionId: string, options?: {
+        min_similarity?: number;
+    }): Promise<SceneComparison[]>;
+    /**
+     * Find similar scenes across all content
+     *
+     * Requires: scene:read permission
+     */
+    findSimilarScenes(detectionId: string, sceneId: string, options?: {
+        limit?: number;
+        min_similarity?: number;
+    }): Promise<Array<{
+        detection_id: string;
+        scene_id: string;
+        media_id: string;
+        similarity: number;
+        thumbnail_url?: string;
+    }>>;
+    /**
+     * Export scene data
+     *
+     * Requires: scene:read permission
+     */
+    exportDetection(detectionId: string, format: 'json' | 'csv' | 'edl' | 'fcpxml'): Promise<{
+        url: string;
+        expires_at: string;
+    }>;
+    /**
+     * Generate scene thumbnails
+     *
+     * Requires: scene:update permission
+     */
+    generateThumbnails(detectionId: string, options?: {
+        regenerate?: boolean;
+        format?: 'jpg' | 'png';
+        size?: string;
+    }): Promise<{
+        generated: number;
+    }>;
+    /**
+     * Wait for scene detection to complete
+     */
+    waitForReady(detectionId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+        onProgress?: (detection: SceneDetection) => void;
+    }): Promise<SceneDetection>;
+    /**
+     * Merge scenes
+     *
+     * Requires: scene:update permission
+     */
+    mergeScenes(detectionId: string, sceneIds: string[], options?: {
+        scene_type?: SceneType;
+        description?: string;
+    }): Promise<Scene>;
+    /**
+     * Split scene at timestamp
+     *
+     * Requires: scene:update permission
+     */
+    splitScene(detectionId: string, sceneId: string, splitTime: number): Promise<{
+        first: Scene;
+        second: Scene;
+    }>;
+}
+/**
+ * Create a Scene API instance
+ */
+export declare function createSceneAPI(client: WaveClient): SceneAPI;
+//# sourceMappingURL=scene.d.ts.map

package/dist/scene.d.ts.map

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

package/dist/search-types.d.ts

@@ -0,0 +1,211 @@
+/**
+ * WAVE SDK - Search API
+ *
+ * Search across media content using text, visual, and audio queries.
+ *
+ * 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 { Timestamps, Metadata } from './client';
+/**
+ * Search result type
+ */
+export type SearchResultType = 'video' | 'audio' | 'clip' | 'stream' | 'transcript' | 'chapter';
+/**
+ * Search mode
+ */
+export type SearchMode = 'text' | 'semantic' | 'visual' | 'audio' | 'multimodal';
+/**
+ * Sort order
+ */
+export type SearchSortOrder = 'relevance' | 'created_at' | 'duration' | 'views' | 'engagement';
+/**
+ * Search result
+ */
+export interface SearchResult {
+    id: string;
+    type: SearchResultType;
+    score: number;
+    title: string;
+    description?: string;
+    thumbnail_url?: string;
+    preview_url?: string;
+    duration?: number;
+    timestamp?: number;
+    end_timestamp?: number;
+    highlights: SearchHighlight[];
+    metadata?: Metadata;
+}
+/**
+ * Search highlight
+ */
+export interface SearchHighlight {
+    field: string;
+    text: string;
+    ranges: Array<{
+        start: number;
+        end: number;
+    }>;
+}
+/**
+ * Search facet
+ */
+export interface SearchFacet {
+    field: string;
+    values: Array<{
+        value: string;
+        count: number;
+        selected: boolean;
+    }>;
+}
+/**
+ * Search suggestion
+ */
+export interface SearchSuggestion {
+    text: string;
+    type: 'query' | 'content' | 'filter';
+    score: number;
+}
+/**
+ * Search request
+ */
+export interface SearchRequest {
+    /** Search query */
+    query: string;
+    /** Search mode */
+    mode?: SearchMode;
+    /** Result types to include */
+    types?: SearchResultType[];
+    /** Filters */
+    filters?: SearchFilters;
+    /** Sort order */
+    sort?: SearchSortOrder;
+    /** Sort direction */
+    order?: 'asc' | 'desc';
+    /** Include facets */
+    facets?: boolean;
+    /** Facet fields */
+    facet_fields?: string[];
+    /** Pagination */
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Search filters
+ */
+export interface SearchFilters {
+    /** Filter by organization */
+    organization_id?: string;
+    /** Filter by creator */
+    creator_id?: string;
+    /** Filter by tags */
+    tags?: string[];
+    /** Filter by language */
+    language?: string;
+    /** Filter by duration range (seconds) */
+    duration_min?: number;
+    duration_max?: number;
+    /** Filter by date range */
+    created_after?: string;
+    created_before?: string;
+    /** Filter by content rating */
+    content_rating?: string[];
+    /** Filter by visibility */
+    visibility?: 'public' | 'private' | 'unlisted';
+    /** Custom metadata filters */
+    metadata?: Record<string, string | number | boolean>;
+}
+/**
+ * Search response
+ */
+export interface SearchResponse {
+    results: SearchResult[];
+    total: number;
+    has_more: boolean;
+    took_ms: number;
+    query_id: string;
+    suggestions?: SearchSuggestion[];
+    facets?: SearchFacet[];
+    spell_correction?: string;
+}
+/**
+ * Visual search request
+ */
+export interface VisualSearchRequest {
+    /** Image URL to search with */
+    image_url?: string;
+    /** Base64 encoded image */
+    image_base64?: string;
+    /** Search for similar scenes */
+    scene_similarity?: boolean;
+    /** Search for objects */
+    object_detection?: boolean;
+    /** Search for faces */
+    face_detection?: boolean;
+    /** Search for text in images */
+    ocr?: boolean;
+    /** Filters */
+    filters?: SearchFilters;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Audio search request
+ */
+export interface AudioSearchRequest {
+    /** Audio URL to search with */
+    audio_url?: string;
+    /** Search for similar audio */
+    audio_similarity?: boolean;
+    /** Search for music */
+    music_detection?: boolean;
+    /** Search for speech */
+    speech_detection?: boolean;
+    /** Search for sound effects */
+    sound_effects?: boolean;
+    /** Filters */
+    filters?: SearchFilters;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Index status
+ */
+export interface IndexStatus extends Timestamps {
+    id: string;
+    media_id: string;
+    media_type: 'video' | 'audio' | 'clip' | 'stream';
+    status: 'pending' | 'indexing' | 'ready' | 'failed';
+    indexed_features: string[];
+    progress?: number;
+    error?: string;
+}
+/**
+ * Search 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 { SearchAPI } from '@wave/sdk/search';
+ *
+ * const client = new WaveClient({ apiKey: 'your-api-key' });
+ * const search = new SearchAPI(client);
+ *
+ * // Text search
+ * const results = await search.search({
+ *   query: 'product demo',
+ *   mode: 'semantic',
+ *   types: ['video', 'clip'],
+ * });
+ *
+ * // Visual search
+ * const visualResults = await search.visualSearch({
+ *   image_url: 'https://example.com/frame.jpg',
+ *   scene_similarity: true,
+ * });
+ * ```
+ */
+//# sourceMappingURL=search-types.d.ts.map

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

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