@blinkdotnew/sdk 0.18.8 → 0.19.1

package/dist/index.d.ts

@@ -1,10 +1,84 @@
+/**
+ * Storage adapter for cross-platform compatibility
+ * Allows using AsyncStorage on React Native and localStorage on web
+ */
+/**
+ * Storage adapter interface
+ * Supports both synchronous (web localStorage) and asynchronous (React Native AsyncStorage) implementations
+ */
+interface StorageAdapter {
+    getItem(key: string): Promise<string | null> | string | null;
+    setItem(key: string, value: string): Promise<void> | void;
+    removeItem(key: string): Promise<void> | void;
+    clear(): Promise<void> | void;
+}
+/**
+ * Web localStorage adapter (synchronous)
+ * Used automatically on web browsers
+ */
+declare class WebStorageAdapter implements StorageAdapter {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+}
+/**
+ * Async storage adapter wrapper (for React Native AsyncStorage)
+ * Usage:
+ * ```typescript
+ * import AsyncStorage from '@react-native-async-storage/async-storage'
+ * const storage = new AsyncStorageAdapter(AsyncStorage)
+ * ```
+ */
+declare class AsyncStorageAdapter implements StorageAdapter {
+    private asyncStorage;
+    constructor(asyncStorage: any);
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+/**
+ * No-op storage adapter (for server-side or when storage is disabled)
+ * Used automatically on Node.js or when no storage is available
+ */
+declare class NoOpStorageAdapter implements StorageAdapter {
+    getItem(_key: string): null;
+    setItem(_key: string, _value: string): void;
+    removeItem(_key: string): void;
+    clear(): void;
+}
+/**
+ * Get default storage adapter based on platform
+ */
+declare function getDefaultStorageAdapter(): StorageAdapter;
+
 /**
  * Core type definitions for Blink SDK
  */
+
 interface BlinkClientConfig {
     projectId: string;
     authRequired?: boolean;
     auth?: BlinkAuthConfig;
+    /**
+     * Storage adapter for cross-platform token persistence
+     *
+     * Web: Uses localStorage by default
+     * React Native: Pass AsyncStorageAdapter(AsyncStorage)
+     * Node.js: Uses NoOpStorageAdapter by default
+     *
+     * @example
+     * // React Native
+     * import AsyncStorage from '@react-native-async-storage/async-storage'
+     * import { AsyncStorageAdapter } from '@blinkdotnew/sdk'
+     *
+     * const blink = createClient({
+     *   projectId: 'your-project',
+     *   storage: new AsyncStorageAdapter(AsyncStorage)
+     * })
+     */
+    storage?: StorageAdapter;
 }
 interface BlinkAuthConfig {
     mode?: 'managed' | 'headless';
@@ -34,6 +108,11 @@ interface BlinkAuthConfig {
     redirectUrl?: string;
     authUrl?: string;
     coreUrl?: string;
+    /**
+     * Storage adapter for auth token persistence (overrides global storage)
+     * If not provided, uses the global storage from BlinkClientConfig
+     */
+    storage?: StorageAdapter;
 }
 type AuthProvider = 'email' | 'google' | 'github' | 'apple' | 'microsoft' | 'twitter' | 'linkedin' | 'discord';
 interface AuthOptions {
@@ -808,6 +887,23 @@ declare class HttpClient {
     private parseDataStream;
 }
 
+/**
+ * Platform detection for cross-platform compatibility
+ * Detects whether code is running on web, React Native, or Node.js
+ */
+type Platform = 'web' | 'react-native' | 'node';
+/**
+ * Current platform
+ */
+declare const platform: Platform;
+/**
+ * Platform detection helpers
+ */
+declare const isWeb: boolean;
+declare const isReactNative: boolean;
+declare const isNode: boolean;
+declare const isBrowser: boolean;
+
 /**
  * Blink Auth Module - Client-side authentication management
  * Handles token storage, user state, and authentication flows
@@ -825,6 +921,7 @@ declare class BlinkAuth {
     private isIframe;
     private initializationPromise;
     private isInitialized;
+    private storage;
     constructor(config: BlinkClientConfig);
     /**
      * Generate project-scoped storage key
@@ -1636,55 +1733,99 @@ declare class BlinkAIImpl implements BlinkAI {
      */
     streamObject(options: ObjectGenerationRequest, onPartial: (partial: any) => void): Promise<ObjectGenerationResponse>;
     /**
-     * Generates images from text descriptions using Gemini 2.5 Flash Image.
+     * Generates images from text descriptions using AI image models.
      *
      * @param options - Object containing:
      *   - `prompt`: Text description of the desired image (required, up to 100k characters)
+     *   - `model`: AI model to use (optional). Available models:
+     *       **Fal.ai Models (Recommended):**
+     *       - `"fal-ai/nano-banana"` (default) - Gemini 2.5 Flash Image (Fast)
+     *       - `"fal-ai/nano-banana-pro"` - Gemini 3 Pro Image (High quality)
+     *       - `"fal-ai/gemini-25-flash-image"` - Alias for nano-banana
+     *       - `"fal-ai/gemini-3-pro-image-preview"` - Alias for nano-banana-pro
+     *       **Legacy Gemini Models:**
+     *       - `"gemini-2.5-flash-image-preview"` - Direct Gemini API
+     *       - `"gemini-3-pro-image-preview"` - Direct Gemini API
      *   - `n`: Number of images to generate (default: 1)
+     *   - `size`: Image dimensions (e.g., "1024x1024", "512x512")
      *   - Plus optional signal parameter
      *
      * @example
      * ```ts
-     * // Basic image generation
+     * // Basic image generation (uses default fast model)
      * const { data } = await blink.ai.generateImage({
      *   prompt: "A serene landscape with mountains and a lake at sunset"
      * });
      * console.log("Image URL:", data[0].url);
      *
-     * // Multiple images
+     * // High quality generation with Pro model
+     * const { data } = await blink.ai.generateImage({
+     *   prompt: "A detailed infographic about AI with charts and diagrams",
+     *   model: "fal-ai/nano-banana-pro",
+     *   n: 2
+     * });
+     *
+     * // Fast generation with specific size
      * const { data } = await blink.ai.generateImage({
      *   prompt: "A futuristic city skyline with flying cars",
+     *   model: "fal-ai/nano-banana",
+     *   size: "1024x1024",
      *   n: 3
      * });
      * data.forEach((img, i) => console.log(`Image ${i+1}:`, img.url));
      *
-     * // Detailed prompt for better results
+     * // Using legacy Gemini model
      * const { data } = await blink.ai.generateImage({
-     *   prompt: "A cute robot mascot for a tech company, digital art style, vibrant colors, modern design, friendly expression"
+     *   prompt: "A cute robot mascot for a tech company",
+     *   model: "gemini-2.5-flash-image-preview"
      * });
      * ```
      *
      * @returns Promise<ImageGenerationResponse> - Object containing:
      *   - `data`: Array of generated images with URLs
      *   - `created`: Timestamp of generation
-     *   - `model`: Always "gemini-2.5-flash-image-preview"
+     *   - `model`: The model used for generation
      */
     generateImage(options: {
         prompt: string;
+        model?: string;
         n?: number;
+        size?: string;
         signal?: AbortSignal;
     }): Promise<ImageGenerationResponse>;
     /**
-     * Modifies existing images using Gemini 2.5 Flash Image with text prompts for image-to-image editing.
+     * Modifies existing images using AI image editing models with text prompts for image-to-image editing.
      *
      * @param options - Object containing:
      *   - `images`: Array of public image URLs to modify (required, up to 50 images)
      *   - `prompt`: Text description of desired modifications (required, up to 100k characters)
+     *   - `model`: AI model to use (optional). Available editing models:
+     *       **Fal.ai Editing Models (Recommended):**
+     *       - `"fal-ai/nano-banana/edit"` (default) - Flash editing (Fast)
+     *       - `"fal-ai/nano-banana-pro/edit"` - Pro editing (High quality)
+     *       - `"fal-ai/gemini-25-flash-image/edit"` - Alias for nano-banana/edit
+     *       - `"fal-ai/gemini-3-pro-image-preview/edit"` - Alias for nano-banana-pro/edit
+     *       **Legacy Gemini Models:**
+     *       - `"gemini-2.5-flash-image-preview"` - Direct Gemini API
+     *       - `"gemini-3-pro-image-preview"` - Direct Gemini API
      *   - `n`: Number of output images to generate (default: 1)
      *   - Plus optional signal parameter
      *
      * @example
      * ```ts
+     * // Fast editing with default model
+     * const { data } = await blink.ai.modifyImage({
+     *   images: ["https://storage.example.com/photo.jpg"],
+     *   prompt: "make it green"
+     * });
+     *
+     * // High quality editing with Pro model
+     * const { data } = await blink.ai.modifyImage({
+     *   images: ["https://storage.example.com/landscape.jpg"],
+     *   prompt: "add a tree in the background",
+     *   model: "fal-ai/nano-banana-pro/edit"
+     * });
+     *
      * // Professional headshots from casual photos
      * const { data } = await blink.ai.modifyImage({
      *   images: [
@@ -1692,6 +1833,7 @@ declare class BlinkAIImpl implements BlinkAI {
      *     "https://storage.example.com/user-photo-2.jpg"
      *   ],
      *   prompt: "Transform into professional business headshots with studio lighting",
+     *   model: "fal-ai/nano-banana/edit",
      *   n: 4
      * });
      * data.forEach((img, i) => console.log(`Headshot ${i+1}:`, img.url));
@@ -1699,7 +1841,8 @@ declare class BlinkAIImpl implements BlinkAI {
      * // Artistic style transformation
      * const { data } = await blink.ai.modifyImage({
      *   images: ["https://storage.example.com/portrait.jpg"],
-     *   prompt: "Transform into oil painting style with dramatic lighting"
+     *   prompt: "Transform into oil painting style with dramatic lighting",
+     *   model: "fal-ai/nano-banana-pro/edit"
      * });
      *
      * // Background replacement
@@ -1737,11 +1880,12 @@ declare class BlinkAIImpl implements BlinkAI {
      * @returns Promise<ImageGenerationResponse> - Object containing:
      *   - `data`: Array of modified images with URLs
      *   - `created`: Timestamp of generation
-     *   - `model`: Always "gemini-2.5-flash-image-preview"
+     *   - `model`: The model used for editing
      */
     modifyImage(options: {
         images: string[];
         prompt: string;
+        model?: string;
         n?: number;
         signal?: AbortSignal;
     }): Promise<ImageGenerationResponse>;
@@ -1920,4 +2064,4 @@ declare class BlinkRealtimeImpl implements BlinkRealtime {
     onPresence(channelName: string, callback: (users: PresenceUser[]) => void): () => void;
 }
 
-export { type AnalyticsEvent, 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, 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 StorageUploadOptions, type StorageUploadResponse, type TableOperations, type TextGenerationRequest, type TextGenerationResponse, type TokenUsage, type TranscriptionRequest, type TranscriptionResponse, type UpdateOptions, type UpsertOptions, createClient };
+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, WebStorageAdapter, createClient, getDefaultStorageAdapter, isBrowser, isNode, isReactNative, isWeb, platform };