@wave-av/sdk 2.0.0 → 2.0.1

package/dist/search.d.ts

@@ -0,0 +1,250 @@
+/**
+ * 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 { WaveClient, PaginationParams, PaginatedResponse } from './client';
+export * from './search-types';
+import type { AudioSearchRequest, IndexStatus, SearchFilters, SearchRequest, SearchResponse, SearchResult, SearchResultType, SearchSuggestion, VisualSearchRequest } from './search-types';
+export declare class SearchAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * Search content
+     *
+     * Requires: search:query permission
+     */
+    search(request: SearchRequest): Promise<SearchResponse>;
+    /**
+     * Quick search (simplified API)
+     *
+     * Requires: search:query permission
+     */
+    quickSearch(query: string, options?: {
+        types?: SearchResultType[];
+        limit?: number;
+        filters?: SearchFilters;
+    }): Promise<SearchResult[]>;
+    /**
+     * Search within a specific media
+     *
+     * Requires: search:query permission
+     */
+    searchInMedia(mediaId: string, mediaType: 'video' | 'audio' | 'clip' | 'stream', query: string, options?: {
+        limit?: number;
+    }): Promise<Array<{
+        timestamp: number;
+        end_timestamp?: number;
+        text?: string;
+        score: number;
+        type: 'speech' | 'visual' | 'chapter';
+    }>>;
+    /**
+     * Visual search (search by image)
+     *
+     * Requires: search:visual permission
+     */
+    visualSearch(request: VisualSearchRequest): Promise<SearchResponse>;
+    /**
+     * Find similar frames
+     *
+     * Requires: search:visual permission
+     */
+    findSimilarFrames(mediaId: string, timestamp: number, options?: {
+        limit?: number;
+        min_similarity?: number;
+    }): Promise<Array<{
+        media_id: string;
+        media_type: string;
+        timestamp: number;
+        thumbnail_url: string;
+        similarity: number;
+    }>>;
+    /**
+     * Detect objects in media
+     *
+     * Requires: search:visual permission
+     */
+    detectObjects(mediaId: string, options?: {
+        timestamps?: number[];
+        confidence_threshold?: number;
+    }): Promise<Array<{
+        timestamp: number;
+        objects: Array<{
+            label: string;
+            confidence: number;
+            bounding_box: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            };
+        }>;
+    }>>;
+    /**
+     * Audio search (search by audio)
+     *
+     * Requires: search:audio permission
+     */
+    audioSearch(request: AudioSearchRequest): Promise<SearchResponse>;
+    /**
+     * Find similar audio segments
+     *
+     * Requires: search:audio permission
+     */
+    findSimilarAudio(mediaId: string, startTime: number, endTime: number, options?: {
+        limit?: number;
+        min_similarity?: number;
+    }): Promise<Array<{
+        media_id: string;
+        media_type: string;
+        start_time: number;
+        end_time: number;
+        similarity: number;
+    }>>;
+    /**
+     * Detect music in media
+     *
+     * Requires: search:audio permission
+     */
+    detectMusic(mediaId: string): Promise<Array<{
+        start_time: number;
+        end_time: number;
+        confidence: number;
+        music_info?: {
+            title?: string;
+            artist?: string;
+            album?: string;
+            isrc?: string;
+        };
+    }>>;
+    /**
+     * Get search suggestions
+     *
+     * Requires: search:query permission
+     */
+    getSuggestions(prefix: string, options?: {
+        limit?: number;
+        types?: SearchResultType[];
+    }): Promise<SearchSuggestion[]>;
+    /**
+     * Get trending searches
+     *
+     * Requires: search:query permission
+     */
+    getTrending(options?: {
+        limit?: number;
+        timeframe?: 'hour' | 'day' | 'week';
+    }): Promise<Array<{
+        query: string;
+        count: number;
+        trend: number;
+    }>>;
+    /**
+     * Index media for search
+     *
+     * Requires: search:index permission
+     */
+    indexMedia(mediaId: string, mediaType: 'video' | 'audio' | 'clip' | 'stream', options?: {
+        features?: ('transcript' | 'visual' | 'audio' | 'metadata')[];
+        priority?: 'low' | 'normal' | 'high';
+        webhook_url?: string;
+    }): Promise<IndexStatus>;
+    /**
+     * Get index status
+     *
+     * Requires: search:read permission
+     */
+    getIndexStatus(mediaId: string): Promise<IndexStatus>;
+    /**
+     * Reindex media
+     *
+     * Requires: search:index permission
+     */
+    reindexMedia(mediaId: string, options?: {
+        features?: ('transcript' | 'visual' | 'audio' | 'metadata')[];
+    }): Promise<IndexStatus>;
+    /**
+     * Remove media from index
+     *
+     * Requires: search:index permission (server-side RBAC enforced)
+     */
+    removeFromIndex(mediaId: string): Promise<void>;
+    /**
+     * Save a search
+     *
+     * Requires: search:save permission
+     */
+    saveSearch(name: string, request: SearchRequest, options?: {
+        notify_on_new?: boolean;
+    }): Promise<{
+        id: string;
+        name: string;
+        query: SearchRequest;
+        created_at: string;
+    }>;
+    /**
+     * List saved searches
+     *
+     * Requires: search:read permission
+     */
+    listSavedSearches(params?: PaginationParams): Promise<PaginatedResponse<{
+        id: string;
+        name: string;
+        query: SearchRequest;
+        last_run?: string;
+        new_results?: number;
+    }>>;
+    /**
+     * Run a saved search
+     *
+     * Requires: search:query permission
+     */
+    runSavedSearch(savedSearchId: string): Promise<SearchResponse>;
+    /**
+     * Remove a saved search
+     *
+     * Requires: search:save permission (server-side RBAC enforced)
+     */
+    removeSavedSearch(savedSearchId: string): Promise<void>;
+    /**
+     * Get search analytics
+     *
+     * Requires: search:analytics permission
+     */
+    getAnalytics(options?: {
+        start_date?: string;
+        end_date?: string;
+        group_by?: 'day' | 'week' | 'month';
+    }): Promise<{
+        total_searches: number;
+        unique_queries: number;
+        zero_results_rate: number;
+        average_results: number;
+        top_queries: Array<{
+            query: string;
+            count: number;
+            avg_results: number;
+        }>;
+        top_zero_results: Array<{
+            query: string;
+            count: number;
+        }>;
+    }>;
+    /**
+     * Wait for indexing to complete
+     */
+    waitForIndex(mediaId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+        onProgress?: (status: IndexStatus) => void;
+    }): Promise<IndexStatus>;
+}
+/**
+ * Create a Search API instance
+ */
+export declare function createSearchAPI(client: WaveClient): SearchAPI;

package/dist/search.d.ts.map

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

package/dist/sentiment.d.ts

@@ -0,0 +1,378 @@
+/**
+ * WAVE SDK - Sentiment API
+ *
+ * Analyze sentiment and emotions in audio, video, and text 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, Timestamps, Metadata } from './client';
+/**
+ * Analysis status
+ */
+export type AnalysisStatus = 'pending' | 'processing' | 'ready' | 'failed';
+/**
+ * Sentiment label
+ */
+export type SentimentLabel = 'very_negative' | 'negative' | 'neutral' | 'positive' | 'very_positive';
+/**
+ * Emotion type
+ */
+export type EmotionType = 'joy' | 'sadness' | 'anger' | 'fear' | 'surprise' | 'disgust' | 'contempt' | 'neutral';
+/**
+ * Analysis source type
+ */
+export type SourceType = 'video' | 'audio' | 'text' | 'chat' | 'transcript';
+/**
+ * Sentiment analysis job
+ */
+export interface SentimentAnalysis extends Timestamps {
+    id: string;
+    organization_id: string;
+    source_type: SourceType;
+    source_id?: string;
+    source_url?: string;
+    status: AnalysisStatus;
+    overall_sentiment: SentimentLabel;
+    sentiment_score: number;
+    confidence: number;
+    dominant_emotions: EmotionType[];
+    duration?: number;
+    segment_count?: number;
+    error?: string;
+    metadata?: Metadata;
+}
+/**
+ * Sentiment segment
+ */
+export interface SentimentSegment {
+    id: string;
+    start_time: number;
+    end_time: number;
+    text?: string;
+    sentiment: SentimentLabel;
+    sentiment_score: number;
+    confidence: number;
+    emotions: EmotionScore[];
+    speaker_id?: number;
+}
+/**
+ * Emotion score
+ */
+export interface EmotionScore {
+    emotion: EmotionType;
+    score: number;
+    confidence: number;
+}
+/**
+ * Sentiment trend point
+ */
+export interface SentimentTrend {
+    timestamp: number;
+    sentiment_score: number;
+    dominant_emotion: EmotionType;
+    window_size: number;
+}
+/**
+ * Sentiment summary
+ */
+export interface SentimentSummary {
+    overall_sentiment: SentimentLabel;
+    sentiment_score: number;
+    sentiment_distribution: Record<SentimentLabel, number>;
+    emotion_distribution: Record<EmotionType, number>;
+    key_moments: KeyMoment[];
+    topics_sentiment: TopicSentiment[];
+}
+/**
+ * Key emotional moment
+ */
+export interface KeyMoment {
+    timestamp: number;
+    end_time?: number;
+    type: 'peak_positive' | 'peak_negative' | 'sentiment_shift' | 'high_emotion';
+    sentiment_score: number;
+    emotion: EmotionType;
+    description?: string;
+    text?: string;
+}
+/**
+ * Topic sentiment
+ */
+export interface TopicSentiment {
+    topic: string;
+    sentiment: SentimentLabel;
+    sentiment_score: number;
+    mention_count: number;
+    examples: string[];
+}
+/**
+ * Create analysis request
+ */
+export interface CreateAnalysisRequest {
+    source_type: SourceType;
+    source_id?: string;
+    source_url?: string;
+    text?: string;
+    /** Analysis options */
+    options?: {
+        /** Enable emotion detection */
+        emotions?: boolean;
+        /** Enable topic extraction */
+        topics?: boolean;
+        /** Enable key moment detection */
+        key_moments?: boolean;
+        /** Segment granularity in seconds */
+        segment_size?: number;
+        /** Language (auto-detect if not specified) */
+        language?: string;
+        /** Enable speaker-level analysis */
+        per_speaker?: boolean;
+    };
+    /** Webhook URL for completion */
+    webhook_url?: string;
+    metadata?: Metadata;
+}
+/**
+ * Batch analysis request
+ */
+export interface BatchAnalysisRequest {
+    items: Array<{
+        source_type: SourceType;
+        source_id?: string;
+        source_url?: string;
+        text?: string;
+    }>;
+    options?: CreateAnalysisRequest['options'];
+    webhook_url?: string;
+}
+/**
+ * List analyses params
+ */
+export interface ListAnalysesParams extends PaginationParams {
+    status?: AnalysisStatus;
+    source_type?: SourceType;
+    sentiment?: SentimentLabel;
+    created_after?: string;
+    created_before?: string;
+}
+/**
+ * Sentiment 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 { SentimentAPI } from '@wave/sdk/sentiment';
+ *
+ * const client = new WaveClient({ apiKey: 'your-api-key' });
+ * const sentiment = new SentimentAPI(client);
+ *
+ * // Analyze sentiment of a video
+ * const analysis = await sentiment.analyze({
+ *   source_type: 'video',
+ *   source_id: 'video_123',
+ *   options: {
+ *     emotions: true,
+ *     key_moments: true,
+ *   },
+ * });
+ *
+ * // Wait for results
+ * const result = await sentiment.waitForReady(analysis.id);
+ * console.log('Overall sentiment:', result.overall_sentiment);
+ * ```
+ */
+export declare class SentimentAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * Create a sentiment analysis job
+     *
+     * Requires: sentiment:analyze permission
+     */
+    analyze(request: CreateAnalysisRequest): Promise<SentimentAnalysis>;
+    /**
+     * Analyze text directly (synchronous for short text)
+     *
+     * Requires: sentiment:analyze permission
+     */
+    analyzeText(text: string, options?: {
+        emotions?: boolean;
+        language?: string;
+    }): Promise<{
+        sentiment: SentimentLabel;
+        sentiment_score: number;
+        confidence: number;
+        emotions?: EmotionScore[];
+    }>;
+    /**
+     * Batch analyze multiple items
+     *
+     * Requires: sentiment:analyze permission
+     */
+    batchAnalyze(request: BatchAnalysisRequest): Promise<{
+        batch_id: string;
+        jobs: SentimentAnalysis[];
+    }>;
+    /**
+     * Get an analysis by ID
+     *
+     * Requires: sentiment:read permission
+     */
+    get(analysisId: string): Promise<SentimentAnalysis>;
+    /**
+     * Remove an analysis
+     *
+     * Requires: sentiment:remove permission (server-side RBAC enforced)
+     */
+    remove(analysisId: string): Promise<void>;
+    /**
+     * List analyses
+     *
+     * Requires: sentiment:read permission
+     */
+    list(params?: ListAnalysesParams): Promise<PaginatedResponse<SentimentAnalysis>>;
+    /**
+     * Get sentiment segments
+     *
+     * Requires: sentiment:read permission
+     */
+    getSegments(analysisId: string, params?: PaginationParams & {
+        start_time?: number;
+        end_time?: number;
+        sentiment?: SentimentLabel;
+        min_score?: number;
+    }): Promise<PaginatedResponse<SentimentSegment>>;
+    /**
+     * Get sentiment summary
+     *
+     * Requires: sentiment:read permission
+     */
+    getSummary(analysisId: string): Promise<SentimentSummary>;
+    /**
+     * Get sentiment trend over time
+     *
+     * Requires: sentiment:read permission
+     */
+    getTrend(analysisId: string, options?: {
+        window_size?: number;
+        resolution?: number;
+    }): Promise<SentimentTrend[]>;
+    /**
+     * Get key emotional moments
+     *
+     * Requires: sentiment:read permission
+     */
+    getKeyMoments(analysisId: string, options?: {
+        type?: KeyMoment['type'];
+        limit?: number;
+    }): Promise<KeyMoment[]>;
+    /**
+     * Get topic sentiments
+     *
+     * Requires: sentiment:read permission
+     */
+    getTopicSentiments(analysisId: string, options?: {
+        min_mentions?: number;
+    }): Promise<TopicSentiment[]>;
+    /**
+     * Get sentiment by speaker
+     *
+     * Requires: sentiment:read permission
+     */
+    getSpeakerSentiment(analysisId: string): Promise<Array<{
+        speaker_id: number;
+        speaker_label?: string;
+        sentiment: SentimentLabel;
+        sentiment_score: number;
+        dominant_emotions: EmotionType[];
+        segment_count: number;
+        total_duration: number;
+    }>>;
+    /**
+     * Start real-time sentiment analysis
+     *
+     * Requires: sentiment:realtime permission
+     */
+    startRealtime(streamId: string, options?: {
+        emotions?: boolean;
+        segment_size?: number;
+        language?: string;
+    }): Promise<{
+        session_id: string;
+        websocket_url: string;
+        expires_at: string;
+    }>;
+    /**
+     * Stop real-time analysis
+     *
+     * Requires: sentiment:realtime permission
+     */
+    stopRealtime(sessionId: string): Promise<SentimentAnalysis>;
+    /**
+     * Get real-time session status
+     *
+     * Requires: sentiment:read permission
+     */
+    getRealtimeStatus(sessionId: string): Promise<{
+        status: 'active' | 'paused' | 'stopped';
+        duration: number;
+        current_sentiment: SentimentLabel;
+        current_score: number;
+        segments_processed: number;
+    }>;
+    /**
+     * Compare sentiment between analyses
+     *
+     * Requires: sentiment:read permission
+     */
+    compare(analysisIds: string[]): Promise<{
+        analyses: Array<{
+            id: string;
+            sentiment: SentimentLabel;
+            sentiment_score: number;
+            dominant_emotions: EmotionType[];
+        }>;
+        comparison: {
+            most_positive: string;
+            most_negative: string;
+            score_range: number;
+            common_emotions: EmotionType[];
+        };
+    }>;
+    /**
+     * Export analysis results
+     *
+     * Requires: sentiment:read permission
+     */
+    exportAnalysis(analysisId: string, format: 'json' | 'csv' | 'pdf'): Promise<{
+        url: string;
+        expires_at: string;
+    }>;
+    /**
+     * Wait for analysis to complete
+     */
+    waitForReady(analysisId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+        onProgress?: (analysis: SentimentAnalysis) => void;
+    }): Promise<SentimentAnalysis>;
+    /**
+     * Get supported languages
+     *
+     * Requires: sentiment:read permission
+     */
+    getSupportedLanguages(): Promise<Array<{
+        code: string;
+        name: string;
+        emotion_detection: boolean;
+    }>>;
+}
+/**
+ * Create a Sentiment API instance
+ */
+export declare function createSentimentAPI(client: WaveClient): SentimentAPI;

package/dist/sentiment.d.ts.map

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