@blinkdotnew/sdk 0.19.0 → 0.19.4

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/dist/index.d.mts

@@ -118,6 +118,11 @@ type AuthProvider = 'email' | 'google' | 'github' | 'apple' | 'microsoft' | 'twi
 interface AuthOptions {
     redirectUrl?: string;
     metadata?: Record<string, any>;
+    /**
+     * Force redirect flow instead of popup (useful for Safari or when popups are blocked)
+     * When true, always uses redirect flow regardless of browser detection
+     */
+    forceRedirect?: boolean;
 }
 interface SignUpData {
     email: string;
@@ -1008,8 +1013,14 @@ declare class BlinkAuth {
      * Sign in with Microsoft (headless mode)
      */
     signInWithMicrosoft(options?: AuthOptions): Promise<BlinkUser>;
+    /**
+     * Check if current browser is Safari (desktop, iPhone, iPad)
+     * Safari has strict popup blocking, so we must use redirect flow
+     */
+    private isSafari;
     /**
      * Generic provider sign-in method (headless mode)
+     * Uses redirect flow for Safari, popup flow for other browsers
      */
     signInWithProvider(provider: AuthProvider, options?: AuthOptions): Promise<BlinkUser>;
     /**
@@ -1114,6 +1125,11 @@ declare class BlinkAuth {
     private setTokens;
     private clearTokens;
     private getStoredTokens;
+    /**
+     * Extract URL parameters from both search params and hash fragments
+     * Safari OAuth redirects often use hash fragments instead of query params
+     */
+    private extractUrlParams;
     private extractTokensFromUrl;
     private clearUrlTokens;
     private redirectToAuth;

package/dist/index.d.ts

@@ -118,6 +118,11 @@ type AuthProvider = 'email' | 'google' | 'github' | 'apple' | 'microsoft' | 'twi
 interface AuthOptions {
     redirectUrl?: string;
     metadata?: Record<string, any>;
+    /**
+     * Force redirect flow instead of popup (useful for Safari or when popups are blocked)
+     * When true, always uses redirect flow regardless of browser detection
+     */
+    forceRedirect?: boolean;
 }
 interface SignUpData {
     email: string;
@@ -1008,8 +1013,14 @@ declare class BlinkAuth {
      * Sign in with Microsoft (headless mode)
      */
     signInWithMicrosoft(options?: AuthOptions): Promise<BlinkUser>;
+    /**
+     * Check if current browser is Safari (desktop, iPhone, iPad)
+     * Safari has strict popup blocking, so we must use redirect flow
+     */
+    private isSafari;
     /**
      * Generic provider sign-in method (headless mode)
+     * Uses redirect flow for Safari, popup flow for other browsers
      */
     signInWithProvider(provider: AuthProvider, options?: AuthOptions): Promise<BlinkUser>;
     /**
@@ -1114,6 +1125,11 @@ declare class BlinkAuth {
     private setTokens;
     private clearTokens;
     private getStoredTokens;
+    /**
+     * Extract URL parameters from both search params and hash fragments
+     * Safari OAuth redirects often use hash fragments instead of query params
+     */
+    private extractUrlParams;
     private extractTokensFromUrl;
     private clearUrlTokens;
     private redirectToAuth;

package/dist/index.js

@@ -1144,6 +1144,36 @@ var BlinkAuth = class {
           return;
         }
       }
+      try {
+        if (typeof window !== "undefined") {
+          console.log("\u{1F50D} Checking URL for errors/tokens:", {
+            href: window.location.href,
+            search: window.location.search,
+            hash: window.location.hash
+          });
+          const urlParams = this.extractUrlParams();
+          const errorParam = urlParams.get("error");
+          if (errorParam) {
+            const errorCode = this.mapErrorCodeFromResponse(errorParam);
+            const errorMessage = urlParams.get("error_description") || "Authentication failed";
+            const error = new BlinkAuthError(errorCode, errorMessage);
+            console.error("\u274C Auth error in URL:", {
+              error: errorParam,
+              errorMessage,
+              allParams: Object.fromEntries(urlParams.entries())
+            });
+            if (typeof window !== "undefined") {
+              window.dispatchEvent(new CustomEvent("blink:auth:error", {
+                detail: { error, errorMessage }
+              }));
+            }
+            this.clearUrlTokens();
+            return;
+          }
+        }
+      } catch (error) {
+        console.error("Error handling failed redirect:", error);
+      }
       const tokensFromUrl = this.extractTokensFromUrl();
       if (tokensFromUrl) {
         console.log("\u{1F4E5} Found tokens in URL, setting them...");
@@ -1151,6 +1181,31 @@ var BlinkAuth = class {
         this.clearUrlTokens();
         console.log("\u2705 Auth initialization complete (from URL)");
         return;
+      } else {
+        console.log("\u26A0\uFE0F No tokens found in URL after redirect - checking if this was a redirect callback");
+        if (typeof window !== "undefined") {
+          const urlParams = this.extractUrlParams();
+          const state = urlParams.get("state");
+          if (state) {
+            console.log("\u26A0\uFE0F State found in URL but no tokens - redirect may have failed silently");
+            try {
+              const expectedState = sessionStorage.getItem("blink_oauth_state");
+              if (expectedState === state) {
+                console.error("\u274C Redirect callback received but no tokens - authentication may have failed");
+                const errorMessage = "Authentication failed. Please try again.";
+                if (typeof window !== "undefined") {
+                  window.dispatchEvent(new CustomEvent("blink:auth:error", {
+                    detail: { error: new BlinkAuthError("NETWORK_ERROR" /* NETWORK_ERROR */, errorMessage), errorMessage }
+                  }));
+                }
+                this.clearUrlTokens();
+                return;
+              }
+            } catch (e) {
+              console.error("Error checking sessionStorage:", e);
+            }
+          }
+        }
       }
       const storedTokens = await this.getStoredTokens();
       if (storedTokens) {
@@ -1504,37 +1559,145 @@ var BlinkAuth = class {
     }
     return this.signInWithProvider("microsoft", options);
   }
+  /**
+   * Check if current browser is Safari (desktop, iPhone, iPad)
+   * Safari has strict popup blocking, so we must use redirect flow
+   */
+  isSafari() {
+    if (typeof window === "undefined") return false;
+    const ua = navigator.userAgent.toLowerCase();
+    const hasSafariUA = /safari/i.test(ua) && !/chrome|chromium|android|edg|firefox|opera/i.test(ua);
+    const isSafariVendor = typeof navigator !== "undefined" && !!navigator.vendor && /apple/i.test(navigator.vendor);
+    const isIOSSafari = /safari/i.test(ua) && /iphone|ipad|ipod/i.test(ua);
+    const hasSafariProperties = typeof window !== "undefined" && ("safari" in window || window.safari !== void 0) && !("chrome" in window);
+    const isMacSafari = /macintosh/i.test(ua) && isSafariVendor && !/chrome|chromium|firefox|edg/i.test(ua);
+    const isSafari = !!(hasSafariUA || isSafariVendor || isIOSSafari || hasSafariProperties || isMacSafari);
+    if (isSafari) {
+      console.log("\u{1F34E} Safari browser detected - will use redirect flow", {
+        hasSafariUA,
+        isSafariVendor,
+        isIOSSafari,
+        hasSafariProperties,
+        isMacSafari,
+        userAgent: ua.substring(0, 100),
+        vendor: navigator.vendor
+      });
+    } else {
+      console.log("\u{1F50D} Not detected as Safari:", {
+        hasSafariUA,
+        isSafariVendor,
+        isIOSSafari,
+        hasSafariProperties,
+        isMacSafari,
+        userAgent: ua.substring(0, 100),
+        vendor: navigator.vendor
+      });
+    }
+    return isSafari;
+  }
   /**
    * Generic provider sign-in method (headless mode)
+   * Uses redirect flow for Safari, popup flow for other browsers
    */
   async signInWithProvider(provider, options) {
     if (this.authConfig.mode !== "headless") {
       throw new BlinkAuthError("INVALID_CREDENTIALS" /* INVALID_CREDENTIALS */, "signInWithProvider is only available in headless mode");
     }
-    return new Promise((resolve, reject) => {
-      const state = this.generateState();
-      try {
-        if (typeof window !== "undefined") {
-          sessionStorage.setItem("blink_oauth_state", state);
-        }
-      } catch {
+    const state = this.generateState();
+    let redirectUrl = options?.redirectUrl || "";
+    if (!redirectUrl && typeof window !== "undefined") {
+      if (window.location.href.startsWith("http")) {
+        redirectUrl = window.location.href;
+      } else {
+        redirectUrl = `${window.location.protocol}//${window.location.host}${window.location.pathname}${window.location.search}${window.location.hash}`;
       }
-      const redirectUrl = options?.redirectUrl || window.location.origin;
+    }
+    try {
+      const redirectUrlObj = new URL(redirectUrl);
+      redirectUrlObj.searchParams.delete("access_token");
+      redirectUrlObj.searchParams.delete("refresh_token");
+      redirectUrlObj.searchParams.delete("state");
+      redirectUrlObj.searchParams.delete("error");
+      redirectUrlObj.searchParams.delete("error_description");
+      redirectUrlObj.hash = "";
+      redirectUrl = redirectUrlObj.toString();
+    } catch (e) {
+      console.warn("Failed to clean redirect URL:", e);
+    }
+    try {
+      if (typeof window !== "undefined") {
+        sessionStorage.setItem("blink_oauth_state", state);
+        sessionStorage.setItem("blink_oauth_redirect_url", redirectUrl);
+        console.log("\u{1F4BE} Stored OAuth state:", { state, redirectUrl });
+      }
+    } catch (e) {
+      console.warn("Failed to store OAuth state in sessionStorage:", e);
+    }
+    const isSafari = this.isSafari();
+    const forceRedirect = options?.forceRedirect === true;
+    if ((isSafari || forceRedirect) && typeof window !== "undefined") {
+      console.log("\u{1F310} Using redirect flow (no popup)", {
+        provider,
+        projectId: this.config.projectId,
+        state,
+        redirectUrl,
+        authUrl: this.authUrl,
+        reason: isSafari ? "Safari detected" : "forceRedirect option set"
+      });
+      const authRedirectUrl = new URL("/auth", this.authUrl);
+      authRedirectUrl.searchParams.set("provider", provider);
+      authRedirectUrl.searchParams.set("project_id", this.config.projectId);
+      authRedirectUrl.searchParams.set("state", state);
+      authRedirectUrl.searchParams.set("mode", "redirect");
+      authRedirectUrl.searchParams.set("redirect_url", redirectUrl);
+      console.log("\u{1F504} Redirecting to:", authRedirectUrl.toString());
+      window.location.href = authRedirectUrl.toString();
+      return new Promise(() => {
+      });
+    }
+    return new Promise((resolve, reject) => {
       const popupUrl = new URL("/auth", this.authUrl);
       popupUrl.searchParams.set("provider", provider);
       popupUrl.searchParams.set("project_id", this.config.projectId);
       popupUrl.searchParams.set("state", state);
       popupUrl.searchParams.set("mode", "popup");
       popupUrl.searchParams.set("redirect_url", redirectUrl);
+      if (typeof window !== "undefined") {
+        popupUrl.searchParams.set("opener_origin", window.location.origin);
+      }
       const popup = window.open(
         popupUrl.toString(),
         "blink-auth",
         "width=500,height=600,scrollbars=yes,resizable=yes"
       );
       if (!popup) {
-        reject(new BlinkAuthError("POPUP_CANCELED" /* POPUP_CANCELED */, "Popup was blocked"));
+        console.warn("\u26A0\uFE0F Popup was blocked, falling back to redirect flow");
+        const authRedirectUrl = new URL("/auth", this.authUrl);
+        authRedirectUrl.searchParams.set("provider", provider);
+        authRedirectUrl.searchParams.set("project_id", this.config.projectId);
+        authRedirectUrl.searchParams.set("state", state);
+        authRedirectUrl.searchParams.set("mode", "redirect");
+        authRedirectUrl.searchParams.set("redirect_url", redirectUrl);
+        console.log("\u{1F504} Falling back to redirect:", authRedirectUrl.toString());
+        window.location.href = authRedirectUrl.toString();
         return;
       }
+      try {
+        if (popup.closed || !popup.window) {
+          console.warn("\u26A0\uFE0F Popup appears to be blocked (closed immediately), falling back to redirect flow");
+          const authRedirectUrl = new URL("/auth", this.authUrl);
+          authRedirectUrl.searchParams.set("provider", provider);
+          authRedirectUrl.searchParams.set("project_id", this.config.projectId);
+          authRedirectUrl.searchParams.set("state", state);
+          authRedirectUrl.searchParams.set("mode", "redirect");
+          authRedirectUrl.searchParams.set("redirect_url", redirectUrl);
+          console.log("\u{1F504} Falling back to redirect:", authRedirectUrl.toString());
+          window.location.href = authRedirectUrl.toString();
+          return;
+        }
+      } catch (e) {
+        console.log("\u26A0\uFE0F Could not verify popup state, assuming it opened successfully");
+      }
       let timeoutId;
       const messageListener = (event) => {
         let allowed = false;
@@ -1544,7 +1707,12 @@ var BlinkAuth = class {
         } catch {
         }
         if (event.origin === "http://localhost:3000" || event.origin === "http://localhost:3001") allowed = true;
-        if (!allowed) return;
+        if (typeof window !== "undefined" && event.origin === window.location.origin) allowed = true;
+        if (!allowed) {
+          console.log("\u{1F6AB} Blocked postMessage from untrusted origin:", event.origin);
+          return;
+        }
+        console.log("\u2705 Accepted postMessage from origin:", event.origin);
         if (event.data?.type === "BLINK_AUTH_TOKENS") {
           const { access_token, refresh_token, token_type, expires_in, refresh_expires_in, projectId, state: returnedState } = event.data;
           try {
@@ -2304,17 +2472,50 @@ var BlinkAuth = class {
       return null;
     }
   }
+  /**
+   * Extract URL parameters from both search params and hash fragments
+   * Safari OAuth redirects often use hash fragments instead of query params
+   */
+  extractUrlParams() {
+    const params = new URLSearchParams();
+    if (typeof window !== "undefined" && window.location.search) {
+      const searchParams = new URLSearchParams(window.location.search);
+      for (const [key, value] of searchParams.entries()) {
+        params.set(key, value);
+      }
+    }
+    if (typeof window !== "undefined" && window.location.hash) {
+      const hash = window.location.hash.substring(1);
+      const hashParams = new URLSearchParams(hash);
+      for (const [key, value] of hashParams.entries()) {
+        if (!params.has(key)) {
+          params.set(key, value);
+        }
+      }
+    }
+    return params;
+  }
   extractTokensFromUrl() {
     if (typeof window === "undefined") return null;
-    const params = new URLSearchParams(window.location.search);
+    const params = this.extractUrlParams();
     const accessToken = params.get("access_token");
     const refreshToken = params.get("refresh_token");
+    const state = params.get("state");
+    const error = params.get("error");
     console.log("\u{1F50D} Extracting tokens from URL:", {
       url: window.location.href,
+      search: window.location.search,
+      hash: window.location.hash,
       accessToken: accessToken ? `${accessToken.substring(0, 20)}...` : null,
       refreshToken: refreshToken ? `${refreshToken.substring(0, 20)}...` : null,
+      state: state ? `${state.substring(0, 10)}...` : null,
+      error: error || null,
       allParams: Object.fromEntries(params.entries())
     });
+    if (error) {
+      console.log("\u274C Error parameter found in URL, not extracting tokens");
+      return null;
+    }
     if (accessToken) {
       const tokens = {
         access_token: accessToken,
@@ -2329,7 +2530,8 @@ var BlinkAuth = class {
       };
       console.log("\u2705 Tokens extracted successfully:", {
         hasAccessToken: !!tokens.access_token,
-        hasRefreshToken: !!tokens.refresh_token
+        hasRefreshToken: !!tokens.refresh_token,
+        state: state || "no state"
       });
       return tokens;
     }
@@ -2349,8 +2551,9 @@ var BlinkAuth = class {
     url.searchParams.delete("code");
     url.searchParams.delete("error");
     url.searchParams.delete("error_description");
+    url.hash = "";
     window.history.replaceState({}, "", url.toString());
-    console.log("\u{1F9F9} URL cleaned up, removed auth parameters");
+    console.log("\u{1F9F9} URL cleaned up, removed auth parameters from both search and hash");
   }
   redirectToAuth() {
     if (typeof window !== "undefined") {

package/dist/index.mjs

@@ -1142,6 +1142,36 @@ var BlinkAuth = class {
           return;
         }
       }
+      try {
+        if (typeof window !== "undefined") {
+          console.log("\u{1F50D} Checking URL for errors/tokens:", {
+            href: window.location.href,
+            search: window.location.search,
+            hash: window.location.hash
+          });
+          const urlParams = this.extractUrlParams();
+          const errorParam = urlParams.get("error");
+          if (errorParam) {
+            const errorCode = this.mapErrorCodeFromResponse(errorParam);
+            const errorMessage = urlParams.get("error_description") || "Authentication failed";
+            const error = new BlinkAuthError(errorCode, errorMessage);
+            console.error("\u274C Auth error in URL:", {
+              error: errorParam,
+              errorMessage,
+              allParams: Object.fromEntries(urlParams.entries())
+            });
+            if (typeof window !== "undefined") {
+              window.dispatchEvent(new CustomEvent("blink:auth:error", {
+                detail: { error, errorMessage }
+              }));
+            }
+            this.clearUrlTokens();
+            return;
+          }
+        }
+      } catch (error) {
+        console.error("Error handling failed redirect:", error);
+      }
       const tokensFromUrl = this.extractTokensFromUrl();
       if (tokensFromUrl) {
         console.log("\u{1F4E5} Found tokens in URL, setting them...");
@@ -1149,6 +1179,31 @@ var BlinkAuth = class {
         this.clearUrlTokens();
         console.log("\u2705 Auth initialization complete (from URL)");
         return;
+      } else {
+        console.log("\u26A0\uFE0F No tokens found in URL after redirect - checking if this was a redirect callback");
+        if (typeof window !== "undefined") {
+          const urlParams = this.extractUrlParams();
+          const state = urlParams.get("state");
+          if (state) {
+            console.log("\u26A0\uFE0F State found in URL but no tokens - redirect may have failed silently");
+            try {
+              const expectedState = sessionStorage.getItem("blink_oauth_state");
+              if (expectedState === state) {
+                console.error("\u274C Redirect callback received but no tokens - authentication may have failed");
+                const errorMessage = "Authentication failed. Please try again.";
+                if (typeof window !== "undefined") {
+                  window.dispatchEvent(new CustomEvent("blink:auth:error", {
+                    detail: { error: new BlinkAuthError("NETWORK_ERROR" /* NETWORK_ERROR */, errorMessage), errorMessage }
+                  }));
+                }
+                this.clearUrlTokens();
+                return;
+              }
+            } catch (e) {
+              console.error("Error checking sessionStorage:", e);
+            }
+          }
+        }
       }
       const storedTokens = await this.getStoredTokens();
       if (storedTokens) {
@@ -1502,37 +1557,145 @@ var BlinkAuth = class {
     }
     return this.signInWithProvider("microsoft", options);
   }
+  /**
+   * Check if current browser is Safari (desktop, iPhone, iPad)
+   * Safari has strict popup blocking, so we must use redirect flow
+   */
+  isSafari() {
+    if (typeof window === "undefined") return false;
+    const ua = navigator.userAgent.toLowerCase();
+    const hasSafariUA = /safari/i.test(ua) && !/chrome|chromium|android|edg|firefox|opera/i.test(ua);
+    const isSafariVendor = typeof navigator !== "undefined" && !!navigator.vendor && /apple/i.test(navigator.vendor);
+    const isIOSSafari = /safari/i.test(ua) && /iphone|ipad|ipod/i.test(ua);
+    const hasSafariProperties = typeof window !== "undefined" && ("safari" in window || window.safari !== void 0) && !("chrome" in window);
+    const isMacSafari = /macintosh/i.test(ua) && isSafariVendor && !/chrome|chromium|firefox|edg/i.test(ua);
+    const isSafari = !!(hasSafariUA || isSafariVendor || isIOSSafari || hasSafariProperties || isMacSafari);
+    if (isSafari) {
+      console.log("\u{1F34E} Safari browser detected - will use redirect flow", {
+        hasSafariUA,
+        isSafariVendor,
+        isIOSSafari,
+        hasSafariProperties,
+        isMacSafari,
+        userAgent: ua.substring(0, 100),
+        vendor: navigator.vendor
+      });
+    } else {
+      console.log("\u{1F50D} Not detected as Safari:", {
+        hasSafariUA,
+        isSafariVendor,
+        isIOSSafari,
+        hasSafariProperties,
+        isMacSafari,
+        userAgent: ua.substring(0, 100),
+        vendor: navigator.vendor
+      });
+    }
+    return isSafari;
+  }
   /**
    * Generic provider sign-in method (headless mode)
+   * Uses redirect flow for Safari, popup flow for other browsers
    */
   async signInWithProvider(provider, options) {
     if (this.authConfig.mode !== "headless") {
       throw new BlinkAuthError("INVALID_CREDENTIALS" /* INVALID_CREDENTIALS */, "signInWithProvider is only available in headless mode");
     }
-    return new Promise((resolve, reject) => {
-      const state = this.generateState();
-      try {
-        if (typeof window !== "undefined") {
-          sessionStorage.setItem("blink_oauth_state", state);
-        }
-      } catch {
+    const state = this.generateState();
+    let redirectUrl = options?.redirectUrl || "";
+    if (!redirectUrl && typeof window !== "undefined") {
+      if (window.location.href.startsWith("http")) {
+        redirectUrl = window.location.href;
+      } else {
+        redirectUrl = `${window.location.protocol}//${window.location.host}${window.location.pathname}${window.location.search}${window.location.hash}`;
       }
-      const redirectUrl = options?.redirectUrl || window.location.origin;
+    }
+    try {
+      const redirectUrlObj = new URL(redirectUrl);
+      redirectUrlObj.searchParams.delete("access_token");
+      redirectUrlObj.searchParams.delete("refresh_token");
+      redirectUrlObj.searchParams.delete("state");
+      redirectUrlObj.searchParams.delete("error");
+      redirectUrlObj.searchParams.delete("error_description");
+      redirectUrlObj.hash = "";
+      redirectUrl = redirectUrlObj.toString();
+    } catch (e) {
+      console.warn("Failed to clean redirect URL:", e);
+    }
+    try {
+      if (typeof window !== "undefined") {
+        sessionStorage.setItem("blink_oauth_state", state);
+        sessionStorage.setItem("blink_oauth_redirect_url", redirectUrl);
+        console.log("\u{1F4BE} Stored OAuth state:", { state, redirectUrl });
+      }
+    } catch (e) {
+      console.warn("Failed to store OAuth state in sessionStorage:", e);
+    }
+    const isSafari = this.isSafari();
+    const forceRedirect = options?.forceRedirect === true;
+    if ((isSafari || forceRedirect) && typeof window !== "undefined") {
+      console.log("\u{1F310} Using redirect flow (no popup)", {
+        provider,
+        projectId: this.config.projectId,
+        state,
+        redirectUrl,
+        authUrl: this.authUrl,
+        reason: isSafari ? "Safari detected" : "forceRedirect option set"
+      });
+      const authRedirectUrl = new URL("/auth", this.authUrl);
+      authRedirectUrl.searchParams.set("provider", provider);
+      authRedirectUrl.searchParams.set("project_id", this.config.projectId);
+      authRedirectUrl.searchParams.set("state", state);
+      authRedirectUrl.searchParams.set("mode", "redirect");
+      authRedirectUrl.searchParams.set("redirect_url", redirectUrl);
+      console.log("\u{1F504} Redirecting to:", authRedirectUrl.toString());
+      window.location.href = authRedirectUrl.toString();
+      return new Promise(() => {
+      });
+    }
+    return new Promise((resolve, reject) => {
       const popupUrl = new URL("/auth", this.authUrl);
       popupUrl.searchParams.set("provider", provider);
       popupUrl.searchParams.set("project_id", this.config.projectId);
       popupUrl.searchParams.set("state", state);
       popupUrl.searchParams.set("mode", "popup");
       popupUrl.searchParams.set("redirect_url", redirectUrl);
+      if (typeof window !== "undefined") {
+        popupUrl.searchParams.set("opener_origin", window.location.origin);
+      }
       const popup = window.open(
         popupUrl.toString(),
         "blink-auth",
         "width=500,height=600,scrollbars=yes,resizable=yes"
       );
       if (!popup) {
-        reject(new BlinkAuthError("POPUP_CANCELED" /* POPUP_CANCELED */, "Popup was blocked"));
+        console.warn("\u26A0\uFE0F Popup was blocked, falling back to redirect flow");
+        const authRedirectUrl = new URL("/auth", this.authUrl);
+        authRedirectUrl.searchParams.set("provider", provider);
+        authRedirectUrl.searchParams.set("project_id", this.config.projectId);
+        authRedirectUrl.searchParams.set("state", state);
+        authRedirectUrl.searchParams.set("mode", "redirect");
+        authRedirectUrl.searchParams.set("redirect_url", redirectUrl);
+        console.log("\u{1F504} Falling back to redirect:", authRedirectUrl.toString());
+        window.location.href = authRedirectUrl.toString();
         return;
       }
+      try {
+        if (popup.closed || !popup.window) {
+          console.warn("\u26A0\uFE0F Popup appears to be blocked (closed immediately), falling back to redirect flow");
+          const authRedirectUrl = new URL("/auth", this.authUrl);
+          authRedirectUrl.searchParams.set("provider", provider);
+          authRedirectUrl.searchParams.set("project_id", this.config.projectId);
+          authRedirectUrl.searchParams.set("state", state);
+          authRedirectUrl.searchParams.set("mode", "redirect");
+          authRedirectUrl.searchParams.set("redirect_url", redirectUrl);
+          console.log("\u{1F504} Falling back to redirect:", authRedirectUrl.toString());
+          window.location.href = authRedirectUrl.toString();
+          return;
+        }
+      } catch (e) {
+        console.log("\u26A0\uFE0F Could not verify popup state, assuming it opened successfully");
+      }
       let timeoutId;
       const messageListener = (event) => {
         let allowed = false;
@@ -1542,7 +1705,12 @@ var BlinkAuth = class {
         } catch {
         }
         if (event.origin === "http://localhost:3000" || event.origin === "http://localhost:3001") allowed = true;
-        if (!allowed) return;
+        if (typeof window !== "undefined" && event.origin === window.location.origin) allowed = true;
+        if (!allowed) {
+          console.log("\u{1F6AB} Blocked postMessage from untrusted origin:", event.origin);
+          return;
+        }
+        console.log("\u2705 Accepted postMessage from origin:", event.origin);
         if (event.data?.type === "BLINK_AUTH_TOKENS") {
           const { access_token, refresh_token, token_type, expires_in, refresh_expires_in, projectId, state: returnedState } = event.data;
           try {
@@ -2302,17 +2470,50 @@ var BlinkAuth = class {
       return null;
     }
   }
+  /**
+   * Extract URL parameters from both search params and hash fragments
+   * Safari OAuth redirects often use hash fragments instead of query params
+   */
+  extractUrlParams() {
+    const params = new URLSearchParams();
+    if (typeof window !== "undefined" && window.location.search) {
+      const searchParams = new URLSearchParams(window.location.search);
+      for (const [key, value] of searchParams.entries()) {
+        params.set(key, value);
+      }
+    }
+    if (typeof window !== "undefined" && window.location.hash) {
+      const hash = window.location.hash.substring(1);
+      const hashParams = new URLSearchParams(hash);
+      for (const [key, value] of hashParams.entries()) {
+        if (!params.has(key)) {
+          params.set(key, value);
+        }
+      }
+    }
+    return params;
+  }
   extractTokensFromUrl() {
     if (typeof window === "undefined") return null;
-    const params = new URLSearchParams(window.location.search);
+    const params = this.extractUrlParams();
     const accessToken = params.get("access_token");
     const refreshToken = params.get("refresh_token");
+    const state = params.get("state");
+    const error = params.get("error");
     console.log("\u{1F50D} Extracting tokens from URL:", {
       url: window.location.href,
+      search: window.location.search,
+      hash: window.location.hash,
       accessToken: accessToken ? `${accessToken.substring(0, 20)}...` : null,
       refreshToken: refreshToken ? `${refreshToken.substring(0, 20)}...` : null,
+      state: state ? `${state.substring(0, 10)}...` : null,
+      error: error || null,
       allParams: Object.fromEntries(params.entries())
     });
+    if (error) {
+      console.log("\u274C Error parameter found in URL, not extracting tokens");
+      return null;
+    }
     if (accessToken) {
       const tokens = {
         access_token: accessToken,
@@ -2327,7 +2528,8 @@ var BlinkAuth = class {
       };
       console.log("\u2705 Tokens extracted successfully:", {
         hasAccessToken: !!tokens.access_token,
-        hasRefreshToken: !!tokens.refresh_token
+        hasRefreshToken: !!tokens.refresh_token,
+        state: state || "no state"
       });
       return tokens;
     }
@@ -2347,8 +2549,9 @@ var BlinkAuth = class {
     url.searchParams.delete("code");
     url.searchParams.delete("error");
     url.searchParams.delete("error_description");
+    url.hash = "";
     window.history.replaceState({}, "", url.toString());
-    console.log("\u{1F9F9} URL cleaned up, removed auth parameters");
+    console.log("\u{1F9F9} URL cleaned up, removed auth parameters from both search and hash");
   }
   redirectToAuth() {
     if (typeof window !== "undefined") {

package/package.json

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