@wave-av/sdk 2.0.0 → 2.0.1

package/dist/signage.d.ts

@@ -0,0 +1,101 @@
+/**
+ * WAVE SDK - Signage API
+ *
+ * Digital signage display and playlist management.
+ */
+import type { WaveClient, PaginationParams, PaginatedResponse, Timestamps } from "./client";
+export type DisplayStatus = "online" | "offline" | "playing" | "error";
+export interface Display extends Timestamps {
+    id: string;
+    organization_id: string;
+    name: string;
+    status: DisplayStatus;
+    resolution: string;
+    orientation: "landscape" | "portrait";
+    location?: string;
+    current_playlist_id?: string;
+    ip_address?: string;
+    version?: string;
+    last_seen_at?: string;
+}
+export interface Playlist extends Timestamps {
+    id: string;
+    organization_id: string;
+    name: string;
+    items: PlaylistItem[];
+    loop: boolean;
+    duration_seconds: number;
+}
+export interface PlaylistItem {
+    id: string;
+    type: "image" | "video" | "stream" | "webpage" | "html";
+    content_url: string;
+    duration_seconds: number;
+    transition?: string;
+    sort_order: number;
+}
+export interface ScheduleEntry {
+    id: string;
+    playlist_id: string;
+    display_ids: string[];
+    start_time: string;
+    end_time: string;
+    days_of_week: number[];
+    recurring: boolean;
+}
+export interface DisplayConfig {
+    brightness?: number;
+    volume?: number;
+    auto_sleep?: boolean;
+    sleep_start?: string;
+    sleep_end?: string;
+    rotation?: number;
+}
+export interface ListDisplaysParams extends PaginationParams {
+    status?: DisplayStatus;
+    location?: string;
+}
+/**
+ * Digital signage display, playlist, and schedule management.
+ *
+ * @example
+ * ```typescript
+ * const display = await wave.signage.registerDisplay({ name: "Lobby Screen" });
+ * const playlist = await wave.signage.createPlaylist({ name: "Welcome", items: [...] });
+ * await wave.signage.assignPlaylist(display.id, playlist.id);
+ * ```
+ */
+export declare class SignageAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    listDisplays(params?: ListDisplaysParams): Promise<PaginatedResponse<Display>>;
+    getDisplay(displayId: string): Promise<Display>;
+    registerDisplay(request: {
+        name: string;
+        location?: string;
+    }): Promise<Display>;
+    updateDisplay(displayId: string, updates: {
+        name?: string;
+        location?: string;
+    }): Promise<Display>;
+    removeDisplay(displayId: string): Promise<void>;
+    createPlaylist(request: {
+        name: string;
+        items: Omit<PlaylistItem, "id">[];
+        loop?: boolean;
+    }): Promise<Playlist>;
+    updatePlaylist(playlistId: string, updates: Partial<{
+        name: string;
+        items: Omit<PlaylistItem, "id">[];
+        loop: boolean;
+    }>): Promise<Playlist>;
+    removePlaylist(playlistId: string): Promise<void>;
+    listPlaylists(params?: PaginationParams): Promise<PaginatedResponse<Playlist>>;
+    assignPlaylist(displayId: string, playlistId: string): Promise<void>;
+    scheduleContent(request: Omit<ScheduleEntry, "id">): Promise<ScheduleEntry>;
+    listSchedules(displayId?: string): Promise<ScheduleEntry[]>;
+    removeSchedule(scheduleId: string): Promise<void>;
+    configureDisplay(displayId: string, config: DisplayConfig): Promise<DisplayConfig>;
+}
+export declare function createSignageAPI(client: WaveClient): SignageAPI;

package/dist/signage.d.ts.map

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

package/dist/slides.d.ts

@@ -0,0 +1,68 @@
+/**
+ * WAVE SDK - Slides API
+ *
+ * Presentation to video conversion with narration and transitions.
+ */
+import type { WaveClient, PaginationParams, PaginatedResponse, Timestamps } from "./client";
+export type ConversionStatus = "pending" | "processing" | "ready" | "failed";
+export type SlideFormat = "pptx" | "pdf" | "google_slides" | "keynote";
+export type TransitionPreset = "none" | "fade" | "slide" | "zoom" | "morph";
+export interface Conversion extends Timestamps {
+    id: string;
+    organization_id: string;
+    title: string;
+    status: ConversionStatus;
+    input_format: SlideFormat;
+    input_url: string;
+    output_url?: string;
+    slide_count: number;
+    duration_seconds?: number;
+    resolution: string;
+    narration_enabled: boolean;
+    progress_percent: number;
+    error?: string;
+}
+export interface SlideNarration {
+    slide_index: number;
+    text: string;
+    voice_id?: string;
+    duration_seconds?: number;
+}
+export interface ConvertRequest {
+    title: string;
+    input_url: string;
+    input_format: SlideFormat;
+    resolution?: string;
+    narration?: SlideNarration[];
+    transition?: TransitionPreset;
+    slide_duration_seconds?: number;
+    webhook_url?: string;
+}
+/**
+ * Presentation-to-video conversion with narration and transitions.
+ *
+ * @example
+ * ```typescript
+ * const conversion = await wave.slides.convert({ title: "Q4 Review", input_url: "https://...", input_format: "pptx" });
+ * const ready = await wave.slides.waitForReady(conversion.id);
+ * ```
+ */
+export declare class SlidesAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    convert(request: ConvertRequest): Promise<Conversion>;
+    get(conversionId: string): Promise<Conversion>;
+    list(params?: PaginationParams): Promise<PaginatedResponse<Conversion>>;
+    remove(conversionId: string): Promise<void>;
+    getProgress(conversionId: string): Promise<{
+        status: ConversionStatus;
+        progress_percent: number;
+    }>;
+    addNarration(conversionId: string, narrations: SlideNarration[]): Promise<Conversion>;
+    waitForReady(conversionId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+    }): Promise<Conversion>;
+}
+export declare function createSlidesAPI(client: WaveClient): SlidesAPI;

package/dist/slides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slides.d.ts","sourceRoot":"","sources":["../src/slides.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE5F,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAC7E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,eAAe,GAAG,SAAS,CAAC;AACvE,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5E,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,WAAW,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AACD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAC7B,MAAM,EAAE,UAAU;IAIxB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAGrD,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAG9C,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAKvE,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAG3C,WAAW,CACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;QAAE,MAAM,EAAE,gBAAgB,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IAK5D,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAMrF,YAAY,CAChB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,OAAO,CAAC,UAAU,CAAC;CAavB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAE7D"}

package/dist/studio-ai-types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * WAVE SDK - Studio AI API
+ *
+ * AI-powered production assistance for live streaming and video production.
+ *
+ * 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';
+/**
+ * AI assistant mode
+ */
+export type AssistantMode = 'auto_director' | 'graphics_operator' | 'audio_mixer' | 'replay_operator' | 'content_moderator' | 'engagement_manager';
+/**
+ * AI suggestion priority
+ */
+export type SuggestionPriority = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * AI suggestion status
+ */
+export type SuggestionStatus = 'pending' | 'accepted' | 'rejected' | 'applied' | 'expired';
+/**
+ * AI assistant
+ */
+export interface AIAssistant extends Timestamps {
+    id: string;
+    organization_id: string;
+    stream_id: string;
+    mode: AssistantMode;
+    status: 'active' | 'paused' | 'stopped';
+    config: AssistantConfig;
+    stats: AssistantStats;
+    metadata?: Metadata;
+}
+/**
+ * Assistant configuration
+ */
+export interface AssistantConfig {
+    /** Automation level (0-100) */
+    automation_level: number;
+    /** Enable auto-apply for suggestions */
+    auto_apply: boolean;
+    /** Auto-apply confidence threshold (0-1) */
+    confidence_threshold: number;
+    /** Mode-specific settings */
+    settings: Record<string, unknown>;
+}
+/**
+ * Assistant statistics
+ */
+export interface AssistantStats {
+    suggestions_made: number;
+    suggestions_accepted: number;
+    suggestions_rejected: number;
+    auto_applied: number;
+    average_confidence: number;
+    uptime_seconds: number;
+}
+/**
+ * AI suggestion
+ */
+export interface AISuggestion extends Timestamps {
+    id: string;
+    assistant_id: string;
+    stream_id: string;
+    mode: AssistantMode;
+    type: string;
+    title: string;
+    description: string;
+    priority: SuggestionPriority;
+    status: SuggestionStatus;
+    confidence: number;
+    action: SuggestionAction;
+    preview_url?: string;
+    expires_at?: string;
+    applied_at?: string;
+    metadata?: Metadata;
+}
+/**
+ * Suggestion action
+ */
+export interface SuggestionAction {
+    type: string;
+    target?: string;
+    params: Record<string, unknown>;
+}
+/**
+ * Auto-director scene recommendation
+ */
+export interface SceneRecommendation {
+    scene_id: string;
+    scene_name: string;
+    confidence: number;
+    reason: string;
+    triggers: string[];
+}
+/**
+ * Graphics suggestion
+ */
+export interface GraphicsSuggestion {
+    graphic_type: 'lower_third' | 'full_screen' | 'overlay' | 'bug';
+    template_id?: string;
+    content: Record<string, string>;
+    duration?: number;
+    position?: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Audio mix suggestion
+ */
+export interface AudioMixSuggestion {
+    source_id: string;
+    source_name: string;
+    action: 'raise' | 'lower' | 'mute' | 'unmute' | 'solo';
+    target_level?: number;
+    reason: string;
+}
+/**
+ * Content moderation alert
+ */
+export interface ModerationAlert {
+    type: 'inappropriate_content' | 'copyright' | 'spam' | 'hate_speech' | 'violence';
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    source: 'video' | 'audio' | 'chat';
+    description: string;
+    timestamp?: number;
+    frame_url?: string;
+}
+/**
+ * Engagement insight
+ */
+export interface EngagementInsight {
+    type: 'peak_moment' | 'drop_off' | 'chat_spike' | 'reaction_surge';
+    metric: string;
+    value: number;
+    change: number;
+    timestamp: number;
+    suggestion?: string;
+}
+/**
+ * Start assistant request
+ */
+export interface StartAssistantRequest {
+    stream_id: string;
+    mode: AssistantMode;
+    config?: Partial<AssistantConfig>;
+    metadata?: Metadata;
+}
+/**
+ * Update assistant request
+ */
+export interface UpdateAssistantRequest {
+    config?: Partial<AssistantConfig>;
+    status?: 'active' | 'paused';
+    metadata?: Metadata;
+}
+/**
+ * List suggestions params
+ */
+export interface ListSuggestionsParams extends PaginationParams {
+    assistant_id?: string;
+    stream_id?: string;
+    mode?: AssistantMode;
+    status?: SuggestionStatus;
+    priority?: SuggestionPriority;
+    min_confidence?: number;
+}
+/**
+ * Studio 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 { StudioAIAPI } from '@wave/sdk/studio-ai';
+ *
+ * const client = new WaveClient({ apiKey: 'your-api-key' });
+ * const studioAI = new StudioAIAPI(client);
+ *
+ * // Start auto-director for a live stream
+ * const assistant = await studioAI.startAssistant({
+ *   stream_id: 'stream_123',
+ *   mode: 'auto_director',
+ *   config: {
+ *     automation_level: 50,
+ *     auto_apply: false,
+ *     confidence_threshold: 0.8,
+ *   },
+ * });
+ *
+ * // Get scene recommendations
+ * const scenes = await studioAI.getSceneRecommendations(assistant.id);
+ * ```
+ */

package/dist/studio-ai-types.d.ts.map

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

package/dist/studio-ai.d.ts

@@ -0,0 +1,218 @@
+/**
+ * WAVE SDK - Studio AI API
+ *
+ * AI-powered production assistance for live streaming and video production.
+ *
+ * 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 { AIAssistant, AISuggestion, AssistantMode, AssistantStats, AudioMixSuggestion, EngagementInsight, GraphicsSuggestion, ListSuggestionsParams, ModerationAlert, SceneRecommendation, StartAssistantRequest, UpdateAssistantRequest } from './studio-ai-types';
+export * from './studio-ai-types';
+export declare class StudioAIAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * Start an AI assistant
+     *
+     * Requires: studio-ai:create permission
+     */
+    startAssistant(request: StartAssistantRequest): Promise<AIAssistant>;
+    /**
+     * Get an assistant by ID
+     *
+     * Requires: studio-ai:read permission
+     */
+    getAssistant(assistantId: string): Promise<AIAssistant>;
+    /**
+     * Update an assistant
+     *
+     * Requires: studio-ai:update permission
+     */
+    updateAssistant(assistantId: string, request: UpdateAssistantRequest): Promise<AIAssistant>;
+    /**
+     * Stop an assistant
+     *
+     * Requires: studio-ai:manage permission
+     */
+    stopAssistant(assistantId: string): Promise<AIAssistant>;
+    /**
+     * Pause an assistant
+     *
+     * Requires: studio-ai:manage permission
+     */
+    pauseAssistant(assistantId: string): Promise<AIAssistant>;
+    /**
+     * Resume an assistant
+     *
+     * Requires: studio-ai:manage permission
+     */
+    resumeAssistant(assistantId: string): Promise<AIAssistant>;
+    /**
+     * List assistants
+     *
+     * Requires: studio-ai:read permission
+     */
+    listAssistants(params?: PaginationParams & {
+        stream_id?: string;
+        mode?: AssistantMode;
+        status?: 'active' | 'paused' | 'stopped';
+    }): Promise<PaginatedResponse<AIAssistant>>;
+    /**
+     * Get assistant statistics
+     *
+     * Requires: studio-ai:read permission
+     */
+    getAssistantStats(assistantId: string): Promise<AssistantStats>;
+    /**
+     * List suggestions
+     *
+     * Requires: studio-ai:read permission
+     */
+    listSuggestions(params?: ListSuggestionsParams): Promise<PaginatedResponse<AISuggestion>>;
+    /**
+     * Get a suggestion by ID
+     *
+     * Requires: studio-ai:read permission
+     */
+    getSuggestion(suggestionId: string): Promise<AISuggestion>;
+    /**
+     * Accept a suggestion
+     *
+     * Requires: studio-ai:apply permission
+     */
+    acceptSuggestion(suggestionId: string): Promise<AISuggestion>;
+    /**
+     * Reject a suggestion
+     *
+     * Requires: studio-ai:apply permission
+     */
+    rejectSuggestion(suggestionId: string, reason?: string): Promise<AISuggestion>;
+    /**
+     * Apply a suggestion immediately
+     *
+     * Requires: studio-ai:apply permission
+     */
+    applySuggestion(suggestionId: string): Promise<AISuggestion>;
+    /**
+     * Get scene recommendations
+     *
+     * Requires: studio-ai:read permission
+     */
+    getSceneRecommendations(assistantId: string): Promise<SceneRecommendation[]>;
+    /**
+     * Set auto-director rules
+     *
+     * Requires: studio-ai:update permission
+     */
+    setDirectorRules(assistantId: string, rules: Array<{
+        trigger: string;
+        condition: Record<string, unknown>;
+        action: {
+            scene_id: string;
+            duration?: number;
+        };
+        priority: number;
+    }>): Promise<{
+        rules_count: number;
+    }>;
+    /**
+     * Trigger manual scene switch via AI
+     *
+     * Requires: studio-ai:apply permission
+     */
+    suggestSceneSwitch(assistantId: string, options?: {
+        reason?: string;
+    }): Promise<SceneRecommendation>;
+    /**
+     * Get graphics suggestions
+     *
+     * Requires: studio-ai:read permission
+     */
+    getGraphicsSuggestions(assistantId: string): Promise<GraphicsSuggestion[]>;
+    /**
+     * Generate lower third for speaker
+     *
+     * Requires: studio-ai:apply permission
+     */
+    generateLowerThird(assistantId: string, speakerInfo?: {
+        name?: string;
+        title?: string;
+    }): Promise<GraphicsSuggestion>;
+    /**
+     * Get audio mix suggestions
+     *
+     * Requires: studio-ai:read permission
+     */
+    getAudioSuggestions(assistantId: string): Promise<AudioMixSuggestion[]>;
+    /**
+     * Auto-level audio sources
+     *
+     * Requires: studio-ai:apply permission
+     */
+    autoLevelAudio(assistantId: string): Promise<{
+        adjustments: AudioMixSuggestion[];
+    }>;
+    /**
+     * Get moderation alerts
+     *
+     * Requires: studio-ai:read permission
+     */
+    getModerationAlerts(assistantId: string, params?: PaginationParams & {
+        severity?: 'low' | 'medium' | 'high' | 'critical';
+    }): Promise<PaginatedResponse<ModerationAlert>>;
+    /**
+     * Dismiss a moderation alert
+     *
+     * Requires: studio-ai:apply permission
+     */
+    dismissAlert(assistantId: string, alertId: string): Promise<void>;
+    /**
+     * Set moderation sensitivity
+     *
+     * Requires: studio-ai:update permission
+     */
+    setModerationSensitivity(assistantId: string, settings: {
+        inappropriate_content?: number;
+        copyright?: number;
+        spam?: number;
+        hate_speech?: number;
+        violence?: number;
+    }): Promise<{
+        updated: boolean;
+    }>;
+    /**
+     * Get engagement insights
+     *
+     * Requires: studio-ai:read permission
+     */
+    getEngagementInsights(assistantId: string, params?: {
+        since?: string;
+        type?: EngagementInsight['type'];
+    }): Promise<EngagementInsight[]>;
+    /**
+     * Get optimal interaction times
+     *
+     * Requires: studio-ai:read permission
+     */
+    getOptimalInteractionTimes(assistantId: string): Promise<Array<{
+        time: number;
+        reason: string;
+        engagement_score: number;
+    }>>;
+    /**
+     * Generate engagement suggestion
+     *
+     * Requires: studio-ai:apply permission
+     */
+    generateEngagementAction(assistantId: string, type: 'poll' | 'question' | 'shoutout' | 'giveaway'): Promise<{
+        type: string;
+        content: Record<string, unknown>;
+        timing: string;
+    }>;
+}
+/**
+ * Create a Studio AI API instance
+ */
+export declare function createStudioAIAPI(client: WaveClient): StudioAIAPI;

package/dist/studio-ai.d.ts.map

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