@blinkdotnew/sdk 2.1.1 → 2.2.1

package/dist/index.d.mts

@@ -481,6 +481,45 @@ interface TranscriptionRequest {
     response_format?: 'json' | 'text' | 'srt' | 'verbose_json' | 'vtt';
     signal?: AbortSignal;
 }
+interface VideoGenerationRequest {
+    prompt: string;
+    model?: string;
+    image_url?: string;
+    duration?: string;
+    aspect_ratio?: string;
+    resolution?: string;
+    negative_prompt?: string;
+    generate_audio?: boolean;
+    seed?: number;
+    cfg_scale?: number;
+    signal?: AbortSignal;
+}
+interface VideoGenerationResponse {
+    result: {
+        video: {
+            url: string;
+            content_type?: string;
+            file_name?: string;
+            file_size?: number;
+        };
+        seed?: number;
+        video_id?: string;
+        thumbnail?: {
+            url: string;
+        };
+    };
+    metadata?: {
+        projectId: string;
+        timestamp: string;
+        provider: string;
+        model: string;
+    };
+    usage?: {
+        creditsCharged: number;
+        costUSD: number;
+        model: string;
+    };
+}
 interface TranscriptionResponse {
     text: string;
     transcript?: string;
@@ -519,6 +558,7 @@ interface BlinkAI {
         background?: "auto" | "transparent" | "opaque";
         signal?: AbortSignal;
     }): Promise<ImageGenerationResponse>;
+    generateVideo(options: VideoGenerationRequest): Promise<VideoGenerationResponse>;
     generateSpeech(options: SpeechGenerationRequest): Promise<SpeechGenerationResponse>;
     transcribeAudio(options: TranscriptionRequest): Promise<TranscriptionResponse>;
 }
@@ -767,6 +807,54 @@ interface BlinkNotifications {
     email(params: SendEmailRequest): Promise<SendEmailResponse>;
 }
 
+type ConnectorProvider = 'discord' | 'notion' | 'google_drive' | 'google_calendar' | 'ai';
+type ConnectorAuthMode = 'oauth' | 'api_key' | 'blink_managed' | 'hybrid';
+interface ConnectorStatusData {
+    connected: boolean;
+    provider: ConnectorProvider;
+    auth_mode?: ConnectorAuthMode;
+    account_id?: string;
+    metadata?: Record<string, unknown>;
+    expires_at?: any;
+    scopes?: string[];
+}
+interface ConnectorStatusResponse {
+    success: boolean;
+    data: ConnectorStatusData;
+}
+interface ConnectorExecuteRequest<TParams = Record<string, unknown>> {
+    method: string;
+    params?: TParams;
+    account_id?: string;
+    http_method?: string;
+}
+interface ConnectorExecuteResponse<TData = any> {
+    success: boolean;
+    data: TData;
+}
+interface ConnectorApiKeyRequest<TMetadata = Record<string, unknown>> {
+    api_key: string;
+    account_id?: string;
+    metadata?: TMetadata;
+}
+interface ConnectorApiKeyResponse {
+    success: boolean;
+    data: {
+        id: string;
+        account_id?: string;
+    };
+}
+interface BlinkConnectors {
+    status(provider: ConnectorProvider, options?: {
+        account_id?: string;
+    }): Promise<ConnectorStatusResponse>;
+    execute<TParams = Record<string, unknown>, TData = any>(provider: ConnectorProvider, request: ConnectorExecuteRequest<TParams>): Promise<ConnectorExecuteResponse<TData>>;
+    saveApiKey<TMetadata = Record<string, unknown>>(provider: ConnectorProvider, request: ConnectorApiKeyRequest<TMetadata>): Promise<ConnectorApiKeyResponse>;
+}
+declare class BlinkConnectorError extends BlinkError {
+    constructor(message: string, status?: number, details?: any);
+}
+
 /**
  * HTTP client for Blink API requests
  * Handles authentication, error handling, and request/response processing
@@ -936,6 +1024,18 @@ declare class HttpClient {
         response_format?: string;
         signal?: AbortSignal;
     }): Promise<BlinkResponse<any>>;
+    aiVideo(prompt: string, options?: {
+        model?: string;
+        image_url?: string;
+        duration?: string;
+        aspect_ratio?: string;
+        resolution?: string;
+        negative_prompt?: string;
+        generate_audio?: boolean;
+        seed?: number;
+        cfg_scale?: number;
+        signal?: AbortSignal;
+    }): Promise<BlinkResponse<any>>;
     /**
      * Data-specific requests
      */
@@ -945,6 +1045,13 @@ declare class HttpClient {
     dataScreenshot(projectId: string, request: ScreenshotRequest): Promise<BlinkResponse<ScreenshotResponse>>;
     dataFetch(projectId: string, request: FetchRequest): Promise<BlinkResponse<FetchResponse | AsyncFetchResponse>>;
     dataSearch(projectId: string, request: SearchRequest): Promise<BlinkResponse<SearchResponse>>;
+    /**
+     * Connector requests
+     */
+    private formatProviderForPath;
+    connectorStatus(provider: ConnectorProvider): Promise<BlinkResponse<ConnectorStatusResponse>>;
+    connectorExecute<TParams = Record<string, unknown>, TData = any>(provider: ConnectorProvider, request: ConnectorExecuteRequest<TParams>): Promise<BlinkResponse<ConnectorExecuteResponse<TData>>>;
+    connectorSaveApiKey<TMetadata = Record<string, unknown>>(provider: ConnectorProvider, request: ConnectorApiKeyRequest<TMetadata>): Promise<BlinkResponse<ConnectorApiKeyResponse>>;
     /**
      * Realtime-specific requests
      */
@@ -1734,6 +1841,7 @@ interface BlinkClient {
     realtime: BlinkRealtime;
     notifications: BlinkNotifications;
     analytics: BlinkAnalytics;
+    connectors: BlinkConnectors;
     functions: BlinkFunctions;
 }
 /**
@@ -2209,6 +2317,82 @@ declare class BlinkAIImpl implements BlinkAI {
         n?: number;
         signal?: AbortSignal;
     }): Promise<ImageGenerationResponse>;
+    /**
+     * Generates videos from text prompts or images using AI video generation models.
+     *
+     * @param options - Object containing:
+     *   - `prompt`: Text description of the video to generate (required)
+     *   - `model`: Video model to use (optional). Available models:
+     *       **Text-to-Video Models:**
+     *       - `"fal-ai/veo3.1"` - Google Veo 3.1 (best quality)
+     *       - `"fal-ai/veo3.1/fast"` (default) - Veo 3.1 fast mode (faster, cheaper)
+     *       - `"fal-ai/sora-2/text-to-video/pro"` - OpenAI Sora 2
+     *       - `"fal-ai/kling-video/v2.6/pro/text-to-video"` - Kling 2.6
+     *       **Image-to-Video Models:**
+     *       - `"fal-ai/veo3.1/image-to-video"` - Veo 3.1 I2V
+     *       - `"fal-ai/veo3.1/fast/image-to-video"` - Veo 3.1 fast I2V
+     *       - `"fal-ai/sora-2/image-to-video/pro"` - Sora 2 I2V
+     *       - `"fal-ai/kling-video/v2.6/pro/image-to-video"` - Kling 2.6 I2V
+     *   - `image_url`: Source image URL for image-to-video (required for I2V models)
+     *   - `duration`: Video duration ("4s", "5s", "6s", "8s", "10s", "12s")
+     *   - `aspect_ratio`: Aspect ratio ("16:9", "9:16", "1:1")
+     *   - `resolution`: Resolution ("720p", "1080p") - Veo/Sora only
+     *   - `negative_prompt`: What to avoid in generation - Veo/Kling only
+     *   - `generate_audio`: Generate audio with video (default: true)
+     *   - `seed`: For reproducibility - Veo only
+     *   - `cfg_scale`: Guidance scale (0-1) - Kling only
+     *   - Plus optional signal parameter
+     *
+     * @example
+     * ```ts
+     * // Basic text-to-video generation (uses default fast model)
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "A serene sunset over the ocean with gentle waves"
+     * });
+     * console.log("Video URL:", result.video.url);
+     *
+     * // High quality with Veo 3.1
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "A cinematic shot of a futuristic city at night",
+     *   model: "fal-ai/veo3.1",
+     *   resolution: "1080p",
+     *   aspect_ratio: "16:9"
+     * });
+     *
+     * // Image-to-video animation
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "Animate this image with gentle camera movement",
+     *   model: "fal-ai/veo3.1/fast/image-to-video",
+     *   image_url: "https://example.com/my-image.jpg",
+     *   duration: "5s"
+     * });
+     *
+     * // Using Sora 2 for creative videos
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "A magical forest with glowing fireflies",
+     *   model: "fal-ai/sora-2/text-to-video/pro",
+     *   duration: "8s"
+     * });
+     *
+     * // Using Kling for detailed videos
+     * const { result, usage } = await blink.ai.generateVideo({
+     *   prompt: "A professional cooking tutorial scene",
+     *   model: "fal-ai/kling-video/v2.6/pro/text-to-video",
+     *   negative_prompt: "blur, distort, low quality",
+     *   cfg_scale: 0.7
+     * });
+     * console.log("Credits charged:", usage?.creditsCharged);
+     * ```
+     *
+     * @returns Promise<VideoGenerationResponse> - Object containing:
+     *   - `result.video.url`: URL to the generated video
+     *   - `result.video.content_type`: MIME type (video/mp4)
+     *   - `result.video.file_name`: Generated filename
+     *   - `result.video.file_size`: File size in bytes
+     *   - `metadata`: Generation metadata (projectId, timestamp, model)
+     *   - `usage`: Credits charged and cost information
+     */
+    generateVideo(options: VideoGenerationRequest): Promise<VideoGenerationResponse>;
     /**
      * Converts text to speech using AI voice synthesis models.
      *
@@ -2384,4 +2568,14 @@ declare class BlinkRealtimeImpl implements BlinkRealtime {
     onPresence(channelName: string, callback: (users: PresenceUser[]) => void): () => void;
 }
 
-export { type AnalyticsEvent, AsyncStorageAdapter, type AuthState, type AuthStateChangeCallback, type AuthTokens, type BlinkAI, BlinkAIImpl, type BlinkAnalytics, BlinkAnalyticsImpl, type BlinkClient, type BlinkClientConfig, type BlinkData, BlinkDataImpl, BlinkDatabase, type BlinkRealtime, BlinkRealtimeChannel, BlinkRealtimeError, BlinkRealtimeImpl, type BlinkStorage, BlinkStorageImpl, BlinkTable, type BlinkUser, type CreateOptions, type DataExtraction, type FileObject, type FilterCondition, type ImageGenerationRequest, type ImageGenerationResponse, type Message, NoOpStorageAdapter, type ObjectGenerationRequest, type ObjectGenerationResponse, type PresenceUser, type QueryOptions, type RealtimeChannel, type RealtimeGetMessagesOptions, type RealtimeMessage, type RealtimePublishOptions, type RealtimeSubscribeOptions, type SearchRequest, type SearchResponse, type SpeechGenerationRequest, type SpeechGenerationResponse, type StorageAdapter, type StorageUploadOptions, type StorageUploadResponse, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenUsage, type TranscriptionRequest, type TranscriptionResponse, type UpdateOptions, type UpsertOptions, type WebBrowserModule, WebStorageAdapter, createClient, getDefaultStorageAdapter, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, platform };
+declare class BlinkConnectorsImpl implements BlinkConnectors {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    status(provider: ConnectorProvider, options?: {
+        account_id?: string;
+    }): Promise<ConnectorStatusResponse>;
+    execute<TParams = Record<string, unknown>, TData = any>(provider: ConnectorProvider, request: ConnectorExecuteRequest<TParams>): Promise<ConnectorExecuteResponse<TData>>;
+    saveApiKey<TMetadata = Record<string, unknown>>(provider: ConnectorProvider, request: ConnectorApiKeyRequest<TMetadata>): Promise<ConnectorApiKeyResponse>;
+}
+
+export { type AnalyticsEvent, AsyncStorageAdapter, type AuthState, type AuthStateChangeCallback, type AuthTokens, type BlinkAI, BlinkAIImpl, type BlinkAnalytics, BlinkAnalyticsImpl, type BlinkClient, type BlinkClientConfig, BlinkConnectorError, type BlinkConnectors, BlinkConnectorsImpl, type BlinkData, BlinkDataImpl, BlinkDatabase, type BlinkRealtime, BlinkRealtimeChannel, BlinkRealtimeError, BlinkRealtimeImpl, type BlinkStorage, BlinkStorageImpl, BlinkTable, type BlinkUser, type ConnectorApiKeyRequest, type ConnectorApiKeyResponse, type ConnectorAuthMode, type ConnectorExecuteRequest, type ConnectorExecuteResponse, type ConnectorProvider, type ConnectorStatusResponse, type CreateOptions, type DataExtraction, type FileObject, type FilterCondition, type ImageGenerationRequest, type ImageGenerationResponse, type Message, NoOpStorageAdapter, type ObjectGenerationRequest, type ObjectGenerationResponse, type PresenceUser, type QueryOptions, type RealtimeChannel, type RealtimeGetMessagesOptions, type RealtimeMessage, type RealtimePublishOptions, type RealtimeSubscribeOptions, type SearchRequest, type SearchResponse, type SpeechGenerationRequest, type SpeechGenerationResponse, type StorageAdapter, type StorageUploadOptions, type StorageUploadResponse, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenUsage, type TranscriptionRequest, type TranscriptionResponse, type UpdateOptions, type UpsertOptions, type WebBrowserModule, WebStorageAdapter, createClient, getDefaultStorageAdapter, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, platform };

package/dist/index.d.ts

@@ -481,6 +481,45 @@ interface TranscriptionRequest {
     response_format?: 'json' | 'text' | 'srt' | 'verbose_json' | 'vtt';
     signal?: AbortSignal;
 }
+interface VideoGenerationRequest {
+    prompt: string;
+    model?: string;
+    image_url?: string;
+    duration?: string;
+    aspect_ratio?: string;
+    resolution?: string;
+    negative_prompt?: string;
+    generate_audio?: boolean;
+    seed?: number;
+    cfg_scale?: number;
+    signal?: AbortSignal;
+}
+interface VideoGenerationResponse {
+    result: {
+        video: {
+            url: string;
+            content_type?: string;
+            file_name?: string;
+            file_size?: number;
+        };
+        seed?: number;
+        video_id?: string;
+        thumbnail?: {
+            url: string;
+        };
+    };
+    metadata?: {
+        projectId: string;
+        timestamp: string;
+        provider: string;
+        model: string;
+    };
+    usage?: {
+        creditsCharged: number;
+        costUSD: number;
+        model: string;
+    };
+}
 interface TranscriptionResponse {
     text: string;
     transcript?: string;
@@ -519,6 +558,7 @@ interface BlinkAI {
         background?: "auto" | "transparent" | "opaque";
         signal?: AbortSignal;
     }): Promise<ImageGenerationResponse>;
+    generateVideo(options: VideoGenerationRequest): Promise<VideoGenerationResponse>;
     generateSpeech(options: SpeechGenerationRequest): Promise<SpeechGenerationResponse>;
     transcribeAudio(options: TranscriptionRequest): Promise<TranscriptionResponse>;
 }
@@ -767,6 +807,54 @@ interface BlinkNotifications {
     email(params: SendEmailRequest): Promise<SendEmailResponse>;
 }
 
+type ConnectorProvider = 'discord' | 'notion' | 'google_drive' | 'google_calendar' | 'ai';
+type ConnectorAuthMode = 'oauth' | 'api_key' | 'blink_managed' | 'hybrid';
+interface ConnectorStatusData {
+    connected: boolean;
+    provider: ConnectorProvider;
+    auth_mode?: ConnectorAuthMode;
+    account_id?: string;
+    metadata?: Record<string, unknown>;
+    expires_at?: any;
+    scopes?: string[];
+}
+interface ConnectorStatusResponse {
+    success: boolean;
+    data: ConnectorStatusData;
+}
+interface ConnectorExecuteRequest<TParams = Record<string, unknown>> {
+    method: string;
+    params?: TParams;
+    account_id?: string;
+    http_method?: string;
+}
+interface ConnectorExecuteResponse<TData = any> {
+    success: boolean;
+    data: TData;
+}
+interface ConnectorApiKeyRequest<TMetadata = Record<string, unknown>> {
+    api_key: string;
+    account_id?: string;
+    metadata?: TMetadata;
+}
+interface ConnectorApiKeyResponse {
+    success: boolean;
+    data: {
+        id: string;
+        account_id?: string;
+    };
+}
+interface BlinkConnectors {
+    status(provider: ConnectorProvider, options?: {
+        account_id?: string;
+    }): Promise<ConnectorStatusResponse>;
+    execute<TParams = Record<string, unknown>, TData = any>(provider: ConnectorProvider, request: ConnectorExecuteRequest<TParams>): Promise<ConnectorExecuteResponse<TData>>;
+    saveApiKey<TMetadata = Record<string, unknown>>(provider: ConnectorProvider, request: ConnectorApiKeyRequest<TMetadata>): Promise<ConnectorApiKeyResponse>;
+}
+declare class BlinkConnectorError extends BlinkError {
+    constructor(message: string, status?: number, details?: any);
+}
+
 /**
  * HTTP client for Blink API requests
  * Handles authentication, error handling, and request/response processing
@@ -936,6 +1024,18 @@ declare class HttpClient {
         response_format?: string;
         signal?: AbortSignal;
     }): Promise<BlinkResponse<any>>;
+    aiVideo(prompt: string, options?: {
+        model?: string;
+        image_url?: string;
+        duration?: string;
+        aspect_ratio?: string;
+        resolution?: string;
+        negative_prompt?: string;
+        generate_audio?: boolean;
+        seed?: number;
+        cfg_scale?: number;
+        signal?: AbortSignal;
+    }): Promise<BlinkResponse<any>>;
     /**
      * Data-specific requests
      */
@@ -945,6 +1045,13 @@ declare class HttpClient {
     dataScreenshot(projectId: string, request: ScreenshotRequest): Promise<BlinkResponse<ScreenshotResponse>>;
     dataFetch(projectId: string, request: FetchRequest): Promise<BlinkResponse<FetchResponse | AsyncFetchResponse>>;
     dataSearch(projectId: string, request: SearchRequest): Promise<BlinkResponse<SearchResponse>>;
+    /**
+     * Connector requests
+     */
+    private formatProviderForPath;
+    connectorStatus(provider: ConnectorProvider): Promise<BlinkResponse<ConnectorStatusResponse>>;
+    connectorExecute<TParams = Record<string, unknown>, TData = any>(provider: ConnectorProvider, request: ConnectorExecuteRequest<TParams>): Promise<BlinkResponse<ConnectorExecuteResponse<TData>>>;
+    connectorSaveApiKey<TMetadata = Record<string, unknown>>(provider: ConnectorProvider, request: ConnectorApiKeyRequest<TMetadata>): Promise<BlinkResponse<ConnectorApiKeyResponse>>;
     /**
      * Realtime-specific requests
      */
@@ -1734,6 +1841,7 @@ interface BlinkClient {
     realtime: BlinkRealtime;
     notifications: BlinkNotifications;
     analytics: BlinkAnalytics;
+    connectors: BlinkConnectors;
     functions: BlinkFunctions;
 }
 /**
@@ -2209,6 +2317,82 @@ declare class BlinkAIImpl implements BlinkAI {
         n?: number;
         signal?: AbortSignal;
     }): Promise<ImageGenerationResponse>;
+    /**
+     * Generates videos from text prompts or images using AI video generation models.
+     *
+     * @param options - Object containing:
+     *   - `prompt`: Text description of the video to generate (required)
+     *   - `model`: Video model to use (optional). Available models:
+     *       **Text-to-Video Models:**
+     *       - `"fal-ai/veo3.1"` - Google Veo 3.1 (best quality)
+     *       - `"fal-ai/veo3.1/fast"` (default) - Veo 3.1 fast mode (faster, cheaper)
+     *       - `"fal-ai/sora-2/text-to-video/pro"` - OpenAI Sora 2
+     *       - `"fal-ai/kling-video/v2.6/pro/text-to-video"` - Kling 2.6
+     *       **Image-to-Video Models:**
+     *       - `"fal-ai/veo3.1/image-to-video"` - Veo 3.1 I2V
+     *       - `"fal-ai/veo3.1/fast/image-to-video"` - Veo 3.1 fast I2V
+     *       - `"fal-ai/sora-2/image-to-video/pro"` - Sora 2 I2V
+     *       - `"fal-ai/kling-video/v2.6/pro/image-to-video"` - Kling 2.6 I2V
+     *   - `image_url`: Source image URL for image-to-video (required for I2V models)
+     *   - `duration`: Video duration ("4s", "5s", "6s", "8s", "10s", "12s")
+     *   - `aspect_ratio`: Aspect ratio ("16:9", "9:16", "1:1")
+     *   - `resolution`: Resolution ("720p", "1080p") - Veo/Sora only
+     *   - `negative_prompt`: What to avoid in generation - Veo/Kling only
+     *   - `generate_audio`: Generate audio with video (default: true)
+     *   - `seed`: For reproducibility - Veo only
+     *   - `cfg_scale`: Guidance scale (0-1) - Kling only
+     *   - Plus optional signal parameter
+     *
+     * @example
+     * ```ts
+     * // Basic text-to-video generation (uses default fast model)
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "A serene sunset over the ocean with gentle waves"
+     * });
+     * console.log("Video URL:", result.video.url);
+     *
+     * // High quality with Veo 3.1
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "A cinematic shot of a futuristic city at night",
+     *   model: "fal-ai/veo3.1",
+     *   resolution: "1080p",
+     *   aspect_ratio: "16:9"
+     * });
+     *
+     * // Image-to-video animation
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "Animate this image with gentle camera movement",
+     *   model: "fal-ai/veo3.1/fast/image-to-video",
+     *   image_url: "https://example.com/my-image.jpg",
+     *   duration: "5s"
+     * });
+     *
+     * // Using Sora 2 for creative videos
+     * const { result } = await blink.ai.generateVideo({
+     *   prompt: "A magical forest with glowing fireflies",
+     *   model: "fal-ai/sora-2/text-to-video/pro",
+     *   duration: "8s"
+     * });
+     *
+     * // Using Kling for detailed videos
+     * const { result, usage } = await blink.ai.generateVideo({
+     *   prompt: "A professional cooking tutorial scene",
+     *   model: "fal-ai/kling-video/v2.6/pro/text-to-video",
+     *   negative_prompt: "blur, distort, low quality",
+     *   cfg_scale: 0.7
+     * });
+     * console.log("Credits charged:", usage?.creditsCharged);
+     * ```
+     *
+     * @returns Promise<VideoGenerationResponse> - Object containing:
+     *   - `result.video.url`: URL to the generated video
+     *   - `result.video.content_type`: MIME type (video/mp4)
+     *   - `result.video.file_name`: Generated filename
+     *   - `result.video.file_size`: File size in bytes
+     *   - `metadata`: Generation metadata (projectId, timestamp, model)
+     *   - `usage`: Credits charged and cost information
+     */
+    generateVideo(options: VideoGenerationRequest): Promise<VideoGenerationResponse>;
     /**
      * Converts text to speech using AI voice synthesis models.
      *
@@ -2384,4 +2568,14 @@ declare class BlinkRealtimeImpl implements BlinkRealtime {
     onPresence(channelName: string, callback: (users: PresenceUser[]) => void): () => void;
 }
 
-export { type AnalyticsEvent, AsyncStorageAdapter, type AuthState, type AuthStateChangeCallback, type AuthTokens, type BlinkAI, BlinkAIImpl, type BlinkAnalytics, BlinkAnalyticsImpl, type BlinkClient, type BlinkClientConfig, type BlinkData, BlinkDataImpl, BlinkDatabase, type BlinkRealtime, BlinkRealtimeChannel, BlinkRealtimeError, BlinkRealtimeImpl, type BlinkStorage, BlinkStorageImpl, BlinkTable, type BlinkUser, type CreateOptions, type DataExtraction, type FileObject, type FilterCondition, type ImageGenerationRequest, type ImageGenerationResponse, type Message, NoOpStorageAdapter, type ObjectGenerationRequest, type ObjectGenerationResponse, type PresenceUser, type QueryOptions, type RealtimeChannel, type RealtimeGetMessagesOptions, type RealtimeMessage, type RealtimePublishOptions, type RealtimeSubscribeOptions, type SearchRequest, type SearchResponse, type SpeechGenerationRequest, type SpeechGenerationResponse, type StorageAdapter, type StorageUploadOptions, type StorageUploadResponse, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenUsage, type TranscriptionRequest, type TranscriptionResponse, type UpdateOptions, type UpsertOptions, type WebBrowserModule, WebStorageAdapter, createClient, getDefaultStorageAdapter, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, platform };
+declare class BlinkConnectorsImpl implements BlinkConnectors {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    status(provider: ConnectorProvider, options?: {
+        account_id?: string;
+    }): Promise<ConnectorStatusResponse>;
+    execute<TParams = Record<string, unknown>, TData = any>(provider: ConnectorProvider, request: ConnectorExecuteRequest<TParams>): Promise<ConnectorExecuteResponse<TData>>;
+    saveApiKey<TMetadata = Record<string, unknown>>(provider: ConnectorProvider, request: ConnectorApiKeyRequest<TMetadata>): Promise<ConnectorApiKeyResponse>;
+}
+
+export { type AnalyticsEvent, AsyncStorageAdapter, type AuthState, type AuthStateChangeCallback, type AuthTokens, type BlinkAI, BlinkAIImpl, type BlinkAnalytics, BlinkAnalyticsImpl, type BlinkClient, type BlinkClientConfig, BlinkConnectorError, type BlinkConnectors, BlinkConnectorsImpl, type BlinkData, BlinkDataImpl, BlinkDatabase, type BlinkRealtime, BlinkRealtimeChannel, BlinkRealtimeError, BlinkRealtimeImpl, type BlinkStorage, BlinkStorageImpl, BlinkTable, type BlinkUser, type ConnectorApiKeyRequest, type ConnectorApiKeyResponse, type ConnectorAuthMode, type ConnectorExecuteRequest, type ConnectorExecuteResponse, type ConnectorProvider, type ConnectorStatusResponse, type CreateOptions, type DataExtraction, type FileObject, type FilterCondition, type ImageGenerationRequest, type ImageGenerationResponse, type Message, NoOpStorageAdapter, type ObjectGenerationRequest, type ObjectGenerationResponse, type PresenceUser, type QueryOptions, type RealtimeChannel, type RealtimeGetMessagesOptions, type RealtimeMessage, type RealtimePublishOptions, type RealtimeSubscribeOptions, type SearchRequest, type SearchResponse, type SpeechGenerationRequest, type SpeechGenerationResponse, type StorageAdapter, type StorageUploadOptions, type StorageUploadResponse, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenUsage, type TranscriptionRequest, type TranscriptionResponse, type UpdateOptions, type UpsertOptions, type WebBrowserModule, WebStorageAdapter, createClient, getDefaultStorageAdapter, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, platform };

package/dist/index.js

@@ -885,6 +885,17 @@ var HttpClient = class {
       signal
     });
   }
+  async aiVideo(prompt, options = {}) {
+    const { signal, ...body } = options;
+    return this.request(`/api/ai/${this.projectId}/video`, {
+      method: "POST",
+      body: {
+        prompt,
+        ...body
+      },
+      signal
+    });
+  }
   /**
    * Data-specific requests
    */
@@ -926,6 +937,38 @@ var HttpClient = class {
   async dataSearch(projectId, request) {
     return this.post(`/api/data/${projectId}/search`, request);
   }
+  /**
+   * Connector requests
+   */
+  formatProviderForPath(provider) {
+    return provider.replace("_", "-");
+  }
+  async connectorStatus(provider) {
+    return this.request(`/api/connectors/${this.formatProviderForPath(provider)}/${this.projectId}/status`, {
+      method: "GET"
+    });
+  }
+  async connectorExecute(provider, request) {
+    const path = request.method.startsWith("/") ? request.method : `/${request.method}`;
+    const url = `/api/connectors/${this.formatProviderForPath(provider)}/${this.projectId}${path}`;
+    const method = (request.http_method || "GET").toUpperCase();
+    if (method === "GET") {
+      return this.request(url, {
+        method: "GET",
+        searchParams: request.params
+      });
+    }
+    return this.request(url, {
+      method,
+      body: request.params || {}
+    });
+  }
+  async connectorSaveApiKey(provider, request) {
+    return this.request(`/api/connectors/${this.formatProviderForPath(provider)}/${this.projectId}/api-key`, {
+      method: "POST",
+      body: request
+    });
+  }
   /**
    * Realtime-specific requests
    */
@@ -4279,6 +4322,131 @@ var BlinkAIImpl = class {
       );
     }
   }
+  /**
+   * Generates videos from text prompts or images using AI video generation models.
+   * 
+   * @param options - Object containing:
+   *   - `prompt`: Text description of the video to generate (required)
+   *   - `model`: Video model to use (optional). Available models:
+   *       **Text-to-Video Models:**
+   *       - `"fal-ai/veo3.1"` - Google Veo 3.1 (best quality)
+   *       - `"fal-ai/veo3.1/fast"` (default) - Veo 3.1 fast mode (faster, cheaper)
+   *       - `"fal-ai/sora-2/text-to-video/pro"` - OpenAI Sora 2
+   *       - `"fal-ai/kling-video/v2.6/pro/text-to-video"` - Kling 2.6
+   *       **Image-to-Video Models:**
+   *       - `"fal-ai/veo3.1/image-to-video"` - Veo 3.1 I2V
+   *       - `"fal-ai/veo3.1/fast/image-to-video"` - Veo 3.1 fast I2V
+   *       - `"fal-ai/sora-2/image-to-video/pro"` - Sora 2 I2V
+   *       - `"fal-ai/kling-video/v2.6/pro/image-to-video"` - Kling 2.6 I2V
+   *   - `image_url`: Source image URL for image-to-video (required for I2V models)
+   *   - `duration`: Video duration ("4s", "5s", "6s", "8s", "10s", "12s")
+   *   - `aspect_ratio`: Aspect ratio ("16:9", "9:16", "1:1")
+   *   - `resolution`: Resolution ("720p", "1080p") - Veo/Sora only
+   *   - `negative_prompt`: What to avoid in generation - Veo/Kling only
+   *   - `generate_audio`: Generate audio with video (default: true)
+   *   - `seed`: For reproducibility - Veo only
+   *   - `cfg_scale`: Guidance scale (0-1) - Kling only
+   *   - Plus optional signal parameter
+   * 
+   * @example
+   * ```ts
+   * // Basic text-to-video generation (uses default fast model)
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "A serene sunset over the ocean with gentle waves"
+   * });
+   * console.log("Video URL:", result.video.url);
+   * 
+   * // High quality with Veo 3.1
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "A cinematic shot of a futuristic city at night",
+   *   model: "fal-ai/veo3.1",
+   *   resolution: "1080p",
+   *   aspect_ratio: "16:9"
+   * });
+   * 
+   * // Image-to-video animation
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "Animate this image with gentle camera movement",
+   *   model: "fal-ai/veo3.1/fast/image-to-video",
+   *   image_url: "https://example.com/my-image.jpg",
+   *   duration: "5s"
+   * });
+   * 
+   * // Using Sora 2 for creative videos
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "A magical forest with glowing fireflies",
+   *   model: "fal-ai/sora-2/text-to-video/pro",
+   *   duration: "8s"
+   * });
+   * 
+   * // Using Kling for detailed videos
+   * const { result, usage } = await blink.ai.generateVideo({
+   *   prompt: "A professional cooking tutorial scene",
+   *   model: "fal-ai/kling-video/v2.6/pro/text-to-video",
+   *   negative_prompt: "blur, distort, low quality",
+   *   cfg_scale: 0.7
+   * });
+   * console.log("Credits charged:", usage?.creditsCharged);
+   * ```
+   * 
+   * @returns Promise<VideoGenerationResponse> - Object containing:
+   *   - `result.video.url`: URL to the generated video
+   *   - `result.video.content_type`: MIME type (video/mp4)
+   *   - `result.video.file_name`: Generated filename
+   *   - `result.video.file_size`: File size in bytes
+   *   - `metadata`: Generation metadata (projectId, timestamp, model)
+   *   - `usage`: Credits charged and cost information
+   */
+  async generateVideo(options) {
+    try {
+      if (!options.prompt) {
+        throw new BlinkAIError("Prompt is required");
+      }
+      const i2vModels = [
+        "fal-ai/veo3.1/image-to-video",
+        "fal-ai/veo3.1/fast/image-to-video",
+        "fal-ai/sora-2/image-to-video/pro",
+        "fal-ai/kling-video/v2.6/pro/image-to-video"
+      ];
+      if (options.model && i2vModels.includes(options.model) && !options.image_url) {
+        throw new BlinkAIError("image_url is required for image-to-video models");
+      }
+      if (options.image_url) {
+        const validation = this.validateImageUrl(options.image_url);
+        if (!validation.isValid) {
+          throw new BlinkAIError(`Invalid image_url: ${validation.error}`);
+        }
+      }
+      const response = await this.httpClient.aiVideo(
+        options.prompt,
+        {
+          model: options.model,
+          image_url: options.image_url,
+          duration: options.duration,
+          aspect_ratio: options.aspect_ratio,
+          resolution: options.resolution,
+          negative_prompt: options.negative_prompt,
+          generate_audio: options.generate_audio,
+          seed: options.seed,
+          cfg_scale: options.cfg_scale,
+          signal: options.signal
+        }
+      );
+      if (!response.data?.result?.video?.url) {
+        throw new BlinkAIError("Invalid response format: missing video URL");
+      }
+      return response.data;
+    } catch (error) {
+      if (error instanceof BlinkAIError) {
+        throw error;
+      }
+      throw new BlinkAIError(
+        `Video generation failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        { originalError: error }
+      );
+    }
+  }
   /**
    * Converts text to speech using AI voice synthesis models.
    * 
@@ -5527,6 +5695,25 @@ var BlinkAnalyticsImpl = class {
   }
 };
 
+// src/connectors.ts
+var BlinkConnectorsImpl = class {
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  async status(provider, options) {
+    const response = await this.httpClient.connectorStatus(provider);
+    return response.data;
+  }
+  async execute(provider, request) {
+    const response = await this.httpClient.connectorExecute(provider, request);
+    return response.data;
+  }
+  async saveApiKey(provider, request) {
+    const response = await this.httpClient.connectorSaveApiKey(provider, request);
+    return response.data;
+  }
+};
+
 // src/functions.ts
 var BlinkFunctionsImpl = class {
   httpClient;
@@ -5576,6 +5763,7 @@ var BlinkClientImpl = class {
   realtime;
   notifications;
   analytics;
+  connectors;
   functions;
   httpClient;
   constructor(config) {
@@ -5595,6 +5783,7 @@ var BlinkClientImpl = class {
     this.realtime = new BlinkRealtimeImpl(this.httpClient, config.projectId);
     this.notifications = new BlinkNotificationsImpl(this.httpClient);
     this.analytics = new BlinkAnalyticsImpl(this.httpClient, config.projectId);
+    this.connectors = new BlinkConnectorsImpl(this.httpClient);
     this.functions = new BlinkFunctionsImpl(
       this.httpClient,
       config.projectId,
@@ -5621,6 +5810,7 @@ function createClient(config) {
 exports.AsyncStorageAdapter = AsyncStorageAdapter;
 exports.BlinkAIImpl = BlinkAIImpl;
 exports.BlinkAnalyticsImpl = BlinkAnalyticsImpl;
+exports.BlinkConnectorsImpl = BlinkConnectorsImpl;
 exports.BlinkDataImpl = BlinkDataImpl;
 exports.BlinkDatabase = BlinkDatabase;
 exports.BlinkRealtimeChannel = BlinkRealtimeChannel;

package/dist/index.mjs

@@ -883,6 +883,17 @@ var HttpClient = class {
       signal
     });
   }
+  async aiVideo(prompt, options = {}) {
+    const { signal, ...body } = options;
+    return this.request(`/api/ai/${this.projectId}/video`, {
+      method: "POST",
+      body: {
+        prompt,
+        ...body
+      },
+      signal
+    });
+  }
   /**
    * Data-specific requests
    */
@@ -924,6 +935,38 @@ var HttpClient = class {
   async dataSearch(projectId, request) {
     return this.post(`/api/data/${projectId}/search`, request);
   }
+  /**
+   * Connector requests
+   */
+  formatProviderForPath(provider) {
+    return provider.replace("_", "-");
+  }
+  async connectorStatus(provider) {
+    return this.request(`/api/connectors/${this.formatProviderForPath(provider)}/${this.projectId}/status`, {
+      method: "GET"
+    });
+  }
+  async connectorExecute(provider, request) {
+    const path = request.method.startsWith("/") ? request.method : `/${request.method}`;
+    const url = `/api/connectors/${this.formatProviderForPath(provider)}/${this.projectId}${path}`;
+    const method = (request.http_method || "GET").toUpperCase();
+    if (method === "GET") {
+      return this.request(url, {
+        method: "GET",
+        searchParams: request.params
+      });
+    }
+    return this.request(url, {
+      method,
+      body: request.params || {}
+    });
+  }
+  async connectorSaveApiKey(provider, request) {
+    return this.request(`/api/connectors/${this.formatProviderForPath(provider)}/${this.projectId}/api-key`, {
+      method: "POST",
+      body: request
+    });
+  }
   /**
    * Realtime-specific requests
    */
@@ -4277,6 +4320,131 @@ var BlinkAIImpl = class {
       );
     }
   }
+  /**
+   * Generates videos from text prompts or images using AI video generation models.
+   * 
+   * @param options - Object containing:
+   *   - `prompt`: Text description of the video to generate (required)
+   *   - `model`: Video model to use (optional). Available models:
+   *       **Text-to-Video Models:**
+   *       - `"fal-ai/veo3.1"` - Google Veo 3.1 (best quality)
+   *       - `"fal-ai/veo3.1/fast"` (default) - Veo 3.1 fast mode (faster, cheaper)
+   *       - `"fal-ai/sora-2/text-to-video/pro"` - OpenAI Sora 2
+   *       - `"fal-ai/kling-video/v2.6/pro/text-to-video"` - Kling 2.6
+   *       **Image-to-Video Models:**
+   *       - `"fal-ai/veo3.1/image-to-video"` - Veo 3.1 I2V
+   *       - `"fal-ai/veo3.1/fast/image-to-video"` - Veo 3.1 fast I2V
+   *       - `"fal-ai/sora-2/image-to-video/pro"` - Sora 2 I2V
+   *       - `"fal-ai/kling-video/v2.6/pro/image-to-video"` - Kling 2.6 I2V
+   *   - `image_url`: Source image URL for image-to-video (required for I2V models)
+   *   - `duration`: Video duration ("4s", "5s", "6s", "8s", "10s", "12s")
+   *   - `aspect_ratio`: Aspect ratio ("16:9", "9:16", "1:1")
+   *   - `resolution`: Resolution ("720p", "1080p") - Veo/Sora only
+   *   - `negative_prompt`: What to avoid in generation - Veo/Kling only
+   *   - `generate_audio`: Generate audio with video (default: true)
+   *   - `seed`: For reproducibility - Veo only
+   *   - `cfg_scale`: Guidance scale (0-1) - Kling only
+   *   - Plus optional signal parameter
+   * 
+   * @example
+   * ```ts
+   * // Basic text-to-video generation (uses default fast model)
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "A serene sunset over the ocean with gentle waves"
+   * });
+   * console.log("Video URL:", result.video.url);
+   * 
+   * // High quality with Veo 3.1
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "A cinematic shot of a futuristic city at night",
+   *   model: "fal-ai/veo3.1",
+   *   resolution: "1080p",
+   *   aspect_ratio: "16:9"
+   * });
+   * 
+   * // Image-to-video animation
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "Animate this image with gentle camera movement",
+   *   model: "fal-ai/veo3.1/fast/image-to-video",
+   *   image_url: "https://example.com/my-image.jpg",
+   *   duration: "5s"
+   * });
+   * 
+   * // Using Sora 2 for creative videos
+   * const { result } = await blink.ai.generateVideo({
+   *   prompt: "A magical forest with glowing fireflies",
+   *   model: "fal-ai/sora-2/text-to-video/pro",
+   *   duration: "8s"
+   * });
+   * 
+   * // Using Kling for detailed videos
+   * const { result, usage } = await blink.ai.generateVideo({
+   *   prompt: "A professional cooking tutorial scene",
+   *   model: "fal-ai/kling-video/v2.6/pro/text-to-video",
+   *   negative_prompt: "blur, distort, low quality",
+   *   cfg_scale: 0.7
+   * });
+   * console.log("Credits charged:", usage?.creditsCharged);
+   * ```
+   * 
+   * @returns Promise<VideoGenerationResponse> - Object containing:
+   *   - `result.video.url`: URL to the generated video
+   *   - `result.video.content_type`: MIME type (video/mp4)
+   *   - `result.video.file_name`: Generated filename
+   *   - `result.video.file_size`: File size in bytes
+   *   - `metadata`: Generation metadata (projectId, timestamp, model)
+   *   - `usage`: Credits charged and cost information
+   */
+  async generateVideo(options) {
+    try {
+      if (!options.prompt) {
+        throw new BlinkAIError("Prompt is required");
+      }
+      const i2vModels = [
+        "fal-ai/veo3.1/image-to-video",
+        "fal-ai/veo3.1/fast/image-to-video",
+        "fal-ai/sora-2/image-to-video/pro",
+        "fal-ai/kling-video/v2.6/pro/image-to-video"
+      ];
+      if (options.model && i2vModels.includes(options.model) && !options.image_url) {
+        throw new BlinkAIError("image_url is required for image-to-video models");
+      }
+      if (options.image_url) {
+        const validation = this.validateImageUrl(options.image_url);
+        if (!validation.isValid) {
+          throw new BlinkAIError(`Invalid image_url: ${validation.error}`);
+        }
+      }
+      const response = await this.httpClient.aiVideo(
+        options.prompt,
+        {
+          model: options.model,
+          image_url: options.image_url,
+          duration: options.duration,
+          aspect_ratio: options.aspect_ratio,
+          resolution: options.resolution,
+          negative_prompt: options.negative_prompt,
+          generate_audio: options.generate_audio,
+          seed: options.seed,
+          cfg_scale: options.cfg_scale,
+          signal: options.signal
+        }
+      );
+      if (!response.data?.result?.video?.url) {
+        throw new BlinkAIError("Invalid response format: missing video URL");
+      }
+      return response.data;
+    } catch (error) {
+      if (error instanceof BlinkAIError) {
+        throw error;
+      }
+      throw new BlinkAIError(
+        `Video generation failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+        void 0,
+        { originalError: error }
+      );
+    }
+  }
   /**
    * Converts text to speech using AI voice synthesis models.
    * 
@@ -5525,6 +5693,25 @@ var BlinkAnalyticsImpl = class {
   }
 };
 
+// src/connectors.ts
+var BlinkConnectorsImpl = class {
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  async status(provider, options) {
+    const response = await this.httpClient.connectorStatus(provider);
+    return response.data;
+  }
+  async execute(provider, request) {
+    const response = await this.httpClient.connectorExecute(provider, request);
+    return response.data;
+  }
+  async saveApiKey(provider, request) {
+    const response = await this.httpClient.connectorSaveApiKey(provider, request);
+    return response.data;
+  }
+};
+
 // src/functions.ts
 var BlinkFunctionsImpl = class {
   httpClient;
@@ -5574,6 +5761,7 @@ var BlinkClientImpl = class {
   realtime;
   notifications;
   analytics;
+  connectors;
   functions;
   httpClient;
   constructor(config) {
@@ -5593,6 +5781,7 @@ var BlinkClientImpl = class {
     this.realtime = new BlinkRealtimeImpl(this.httpClient, config.projectId);
     this.notifications = new BlinkNotificationsImpl(this.httpClient);
     this.analytics = new BlinkAnalyticsImpl(this.httpClient, config.projectId);
+    this.connectors = new BlinkConnectorsImpl(this.httpClient);
     this.functions = new BlinkFunctionsImpl(
       this.httpClient,
       config.projectId,
@@ -5616,6 +5805,6 @@ function createClient(config) {
   return new BlinkClientImpl(config);
 }
 
-export { AsyncStorageAdapter, BlinkAIImpl, BlinkAnalyticsImpl, BlinkDataImpl, BlinkDatabase, BlinkRealtimeChannel, BlinkRealtimeImpl, BlinkStorageImpl, BlinkTable, NoOpStorageAdapter, WebStorageAdapter, createClient, getDefaultStorageAdapter, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, platform };
+export { AsyncStorageAdapter, BlinkAIImpl, BlinkAnalyticsImpl, BlinkConnectorsImpl, BlinkDataImpl, BlinkDatabase, BlinkRealtimeChannel, BlinkRealtimeImpl, BlinkStorageImpl, BlinkTable, NoOpStorageAdapter, WebStorageAdapter, createClient, getDefaultStorageAdapter, isBrowser, isDeno, isNode, isReactNative, isServer, isWeb, platform };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkdotnew/sdk",
-  "version": "2.1.1",
+  "version": "2.2.1",
   "description": "Blink TypeScript SDK for client-side applications - Zero-boilerplate CRUD + auth + AI + analytics + notifications for modern SaaS/AI apps",
   "keywords": [
     "blink",
@@ -53,7 +53,8 @@
   "devDependencies": {
     "@blink/core": "0.4.1",
     "tsup": "^8.0.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "@blinkdotnew/dev-sdk": "workspace:*"
   },
   "peerDependencies": {},
   "publishConfig": {