@blinkdotnew/sdk 0.18.8 → 0.19.1

package/README.md

@@ -145,15 +145,16 @@ 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  
-- **🤖 AI**: Text generation with web search, object generation, image creation (Gemini 2.5 Flash), speech synthesis, and transcription
+- **🗄️ Database**: PostgREST-compatible CRUD operations with advanced filtering
+- **🤖 AI**: Multi-model image generation & editing (10 models), text generation with web search, object generation, 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
 - **📧 Notifications**: Email sending with attachments, custom branding, and delivery tracking
 - **⚡ 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
 
@@ -190,6 +191,52 @@ const blink = createClient({
 // 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
 
 ### Authentication
@@ -661,29 +708,56 @@ const { object: todoList } = await blink.ai.generateObject({
 // })
 // Error: "schema must be a JSON Schema of 'type: \"object\"', got 'type: \"array\"'"
 
-// Generate and modify images with AI (powered by Gemini 2.5 Flash Image)
-// 🔥 Automatic optimization - no need to specify size, quality, or style parameters
+// Generate and modify images with AI - Multi-Model Support (10 models available)
+// 🔥 Choose between fast generation or high-quality results
 // 🎨 For style transfer: provide ALL images in the images array, don't reference URLs in prompts
 
-// Basic image generation - returns public URLs directly
+// Basic image generation (uses default fast model: fal-ai/nano-banana)
 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: proImage } = await blink.ai.generateImage({
+  prompt: 'A detailed infographic about AI with charts and diagrams',
+  model: 'fal-ai/nano-banana-pro', // High quality model
+  n: 1,
+  size: '1792x1024' // Custom size
+})
+
+// Generate multiple variations
 const { data } = await blink.ai.generateImage({
   prompt: 'A futuristic robot in different poses',
+  model: 'fal-ai/nano-banana', // Fast model
   n: 3
 })
 data.forEach((img, i) => console.log(`Image ${i+1}:`, img.url))
 
-// Image editing - transform existing images with prompts
+**Available Models for Text-to-Image:**
+
+| Model | Speed | Quality | Best For |
+|-------|-------|---------|----------|
+| `fal-ai/nano-banana` (default) | ⚡ Fast | Good | Prototypes, high-volume generation |
+| `fal-ai/nano-banana-pro` | Standard | ⭐ Excellent | Marketing materials, high-fidelity visuals |
+| `fal-ai/gemini-25-flash-image` | ⚡ Fast | Good | Alias for `nano-banana` |
+| `fal-ai/gemini-3-pro-image-preview` | Standard | ⭐ Excellent | Alias for `nano-banana-pro` |
+| `gemini-2.5-flash-image-preview` | ⚡ Fast | Good | Legacy - Direct Gemini API |
+| `gemini-3-pro-image-preview` | Standard | ⭐ Excellent | Legacy - Direct Gemini API |
+
+// Image editing - transform existing images with prompts (uses default fast model)
 const { data: headshots } = await blink.ai.modifyImage({
-  images: ['https://storage.example.com/user-photo.jpg'], // Up to 50 images supported!
+  images: ['https://storage.example.com/user-photo.jpg'], // Up to 16 images supported!
   prompt: 'Transform into professional business headshot with studio lighting'
 })
 
+// High-quality editing with Pro model
+const { data: proEdited } = await blink.ai.modifyImage({
+  images: ['https://storage.example.com/portrait.jpg'],
+  prompt: 'Add a majestic ancient tree in the background with glowing leaves',
+  model: 'fal-ai/nano-banana-pro/edit' // High quality editing
+})
+
 // Advanced image editing with multiple input images
 const { data } = await blink.ai.modifyImage({
   images: [
@@ -692,9 +766,19 @@ const { data } = await blink.ai.modifyImage({
     'https://storage.example.com/photo3.jpg'
   ],
   prompt: 'Combine these architectural styles into a futuristic building design',
+  model: 'fal-ai/nano-banana/edit', // Fast editing
   n: 2
 })
 
+**Available Models for Image Editing:**
+
+| Model | Speed | Quality | Best For |
+|-------|-------|---------|----------|
+| `fal-ai/nano-banana/edit` (default) | ⚡ Fast | Good | Quick adjustments, style transfers |
+| `fal-ai/nano-banana-pro/edit` | Standard | ⭐ Excellent | Detailed retouching, complex edits |
+| `fal-ai/gemini-25-flash-image/edit` | ⚡ Fast | Good | Alias for `nano-banana/edit` |
+| `fal-ai/gemini-3-pro-image-preview/edit` | Standard | ⭐ Excellent | Alias for `nano-banana-pro/edit` |
+
 // 🎨 Style Transfer & Feature Application
 // ⚠️ IMPORTANT: When applying styles/features from one image to another,
 // provide ALL images in the array - don't reference images in the prompt text

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