@blinkdotnew/sdk 0.18.7 → 0.19.0

package/README.md

@@ -145,7 +145,7 @@ const { publicUrl } = await blink.storage.upload(
 This SDK powers every Blink-generated app with:
 
 - **🔐 Authentication**: Flexible auth system with managed (redirect) and headless (custom UI) modes, email/password, social providers (Google, GitHub, Apple, Microsoft), magic links, RBAC, and custom email branding
-- **🗄️ Database**: PostgREST-compatible CRUD operations with advanced filtering  
+- **🗄️ Database**: PostgREST-compatible CRUD operations with advanced filtering
 - **🤖 AI**: Text generation with web search, object generation, image creation (Gemini 2.5 Flash), speech synthesis, and transcription
 - **📄 Data**: Extract text content from documents, secure API proxy with secret substitution, web scraping, screenshots, and web search
 - **📁 Storage**: File upload, download, and management
@@ -153,7 +153,8 @@ This SDK powers every Blink-generated app with:
 - **⚡ Realtime**: WebSocket-based pub/sub messaging, presence tracking, and live updates
 - **📊 Analytics**: Automatic pageview tracking, custom event logging, session management, and privacy-first design
 - **🌐 Universal**: Works on client-side and server-side
-- **📱 Framework Agnostic**: React, Vue, Svelte, vanilla JS, Node.js, Deno
+- **📱 Framework Agnostic**: React, Vue, Svelte, vanilla JS, Node.js, Deno, **React Native**
+- **📱 React Native**: First-class mobile support with AsyncStorage integration and platform-aware features
 - **🔄 Real-time**: Built-in auth state management and token refresh
 - **⚡ Zero Boilerplate**: Everything works out of the box
 
@@ -187,8 +188,53 @@ const blink = createClient({
   auth: { mode: 'managed' } // Manual token management
 })
 
-// Set JWT manually
-blink.auth.setToken(jwtFromHeader)
+// Token injection is only needed when calling blink.auth.* methods on the server
+```
+
+### 📱 React Native (iOS & Android)
+
+The SDK has **first-class React Native support** with platform-aware features that automatically adapt to mobile environments.
+
+```bash
+npm install @blinkdotnew/sdk @react-native-async-storage/async-storage
+```
+
+```typescript
+import { createClient, AsyncStorageAdapter } from '@blinkdotnew/sdk'
+import AsyncStorage from '@react-native-async-storage/async-storage'
+
+const blink = createClient({
+  projectId: 'your-project-id',
+  authRequired: false,
+  // Use AsyncStorage for secure token persistence on mobile
+  storage: new AsyncStorageAdapter(AsyncStorage)
+})
+
+// All features work seamlessly in React Native!
+const { data } = await blink.ai.generateImage({
+  prompt: 'A beautiful sunset over mountains',
+  n: 1
+})
+```
+
+**Platform-Aware Features:**
+- ✅ **AsyncStorage integration** for secure token persistence
+- ✅ **Automatic platform detection** - skips browser-only features (analytics tracking, cross-tab sync)
+- ✅ **No polyfills needed** - works out of the box
+- ✅ **Optimized for mobile** - reduced memory footprint
+
+**Configuration Options:**
+```typescript
+// With AsyncStorage (recommended for token persistence)
+const blink = createClient({
+  projectId: 'your-project-id',
+  storage: new AsyncStorageAdapter(AsyncStorage)
+})
+
+// Without persistence (tokens in memory only)
+const blink = createClient({
+  projectId: 'your-project-id'
+})
 ```
 
 ## 📖 API Reference
@@ -235,6 +281,22 @@ const user = await blink.auth.signInWithGitHub()
 const user = await blink.auth.signInWithApple()
 const user = await blink.auth.signInWithMicrosoft()
 
+// ✅ Store custom signup fields inside metadata
+await blink.auth.signUp({
+  email: 'founder@example.com',
+  password: 'SuperSecret123',
+  displayName: 'Alex Founder',
+  role: 'operations',
+  metadata: {
+    company: 'Acme Freight',
+    marketingConsent: true
+  }
+})
+// `displayName`, `avatar`, and `role` map to dedicated auth columns.
+// Everything else goes into auth.users.metadata automatically.
+// Keep custom fields in metadata or your own profile table—avoid adding NOT NULL
+// columns directly to auth tables.
+
 // Magic links (passwordless)
 await blink.auth.sendMagicLink(email)
 
@@ -427,6 +489,8 @@ function EditButton() {
 
 #### Core Methods
 
+> ⚠️ Tokens are managed automatically for Blink APIs. Use `getValidToken()` only if you must manually pass a token to your own backend or third-party services.
+
 ```typescript
 // User management
 const user = await blink.auth.me()
@@ -435,6 +499,7 @@ await blink.auth.updateMe({ displayName: 'New Name' })
 // Token management
 blink.auth.setToken(jwt, persist?)
 const isAuth = blink.auth.isAuthenticated()
+const token = await blink.auth.getValidToken() // Get valid token (auto-refreshes)
 
 // Password management
 await blink.auth.sendPasswordResetEmail('user@example.com')
@@ -2356,9 +2421,6 @@ const blink = createClient({
 })
 
 export default async function handler(req, res) {
-  const jwt = req.headers.authorization?.replace('Bearer ', '')
-  blink.auth.setToken(jwt)
-
   const todos = await blink.db.todos.list()
   res.json(todos)
 }
@@ -2376,9 +2438,6 @@ const blink = createClient({
 })
 
 Deno.serve(async (req) => {
-  const jwt = req.headers.get('authorization')?.replace('Bearer ', '')
-  blink.auth.setToken(jwt)
-
   const todos = await blink.db.todos.list()
   return Response.json(todos)
 })

package/dist/index.d.mts

@@ -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 };

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 };