@blinkdotnew/sdk 0.19.0 → 0.19.1

package/README.md

@@ -146,7 +146,7 @@ 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
+- **🤖 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
@@ -708,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: [
@@ -739,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkdotnew/sdk",
-  "version": "0.19.0",
+  "version": "0.19.1",
   "description": "Blink TypeScript SDK for client-side applications - Zero-boilerplate CRUD + auth + AI + analytics + notifications for modern SaaS/AI apps",
   "keywords": [
     "blink",