@blinkdotnew/sdk 0.17.3 → 0.18.0

package/dist/index.d.mts

@@ -4,6 +4,53 @@
 interface BlinkClientConfig {
     projectId: string;
     authRequired?: boolean;
+    auth?: BlinkAuthConfig;
+}
+interface BlinkAuthConfig {
+    mode?: 'managed' | 'headless';
+    email?: {
+        requireVerification?: boolean;
+        allowSignUp?: boolean;
+        passwordRules?: {
+            minLength?: number;
+            requireUppercase?: boolean;
+            requireLowercase?: boolean;
+            requireNumbers?: boolean;
+            requireSpecialChars?: boolean;
+        };
+    };
+    roles?: {
+        [role: string]: {
+            permissions: string[];
+            inherit?: string[];
+        };
+    };
+    defaultRole?: string;
+    session?: {
+        duration?: number;
+        refreshThreshold?: number;
+        multiDevice?: boolean;
+    };
+    redirectUrl?: string;
+    authUrl?: string;
+    coreUrl?: string;
+}
+type AuthProvider = 'email' | 'google' | 'github' | 'apple' | 'microsoft' | 'twitter' | 'linkedin' | 'discord';
+interface AuthOptions {
+    redirectUrl?: string;
+    metadata?: Record<string, any>;
+}
+interface SignUpData {
+    email: string;
+    password: string;
+    metadata?: {
+        displayName?: string;
+        avatar?: string;
+        [key: string]: any;
+    };
+}
+interface MagicLinkOptions {
+    redirectUrl?: string;
 }
 interface BlinkUser {
     id: string;
@@ -13,6 +60,7 @@ interface BlinkUser {
     emailVerified?: boolean;
     createdAt?: string;
     lastSignInAt?: string;
+    role?: string;
 }
 interface AuthTokens {
     access_token: string;
@@ -768,9 +816,11 @@ declare class HttpClient {
 type AuthStateChangeCallback = (state: AuthState) => void;
 declare class BlinkAuth {
     private config;
+    private authConfig;
     private authState;
     private listeners;
     private readonly authUrl;
+    private readonly coreUrl;
     private parentWindowTokens;
     private isIframe;
     private initializationPromise;
@@ -825,6 +875,111 @@ declare class BlinkAuth {
      * Gracefully waits for auth initialization to complete before throwing errors
      */
     me(): Promise<BlinkUser>;
+    /**
+     * Sign up with email and password (headless mode)
+     */
+    signUp(data: SignUpData): Promise<BlinkUser>;
+    /**
+     * Sign in with email and password (headless mode)
+     */
+    signInWithEmail(email: string, password: string): Promise<BlinkUser>;
+    /**
+     * Sign in with Google (headless mode)
+     */
+    signInWithGoogle(options?: AuthOptions): Promise<BlinkUser>;
+    /**
+     * Sign in with GitHub (headless mode)
+     */
+    signInWithGitHub(options?: AuthOptions): Promise<BlinkUser>;
+    /**
+     * Sign in with Apple (headless mode)
+     */
+    signInWithApple(options?: AuthOptions): Promise<BlinkUser>;
+    /**
+     * Sign in with Microsoft (headless mode)
+     */
+    signInWithMicrosoft(options?: AuthOptions): Promise<BlinkUser>;
+    /**
+     * Generic provider sign-in method (headless mode)
+     */
+    signInWithProvider(provider: AuthProvider, options?: AuthOptions): Promise<BlinkUser>;
+    /**
+     * Generate password reset token (for custom email delivery)
+     */
+    generatePasswordResetToken(email: string): Promise<{
+        token: string;
+        expiresAt: string;
+        resetUrl: string;
+    }>;
+    /**
+     * Send password reset email (using Blink default email service)
+     */
+    sendPasswordResetEmail(email: string): Promise<void>;
+    /**
+     * Confirm password reset with token
+     */
+    confirmPasswordReset(token: string, newPassword: string): Promise<void>;
+    /**
+     * Change password (requires current authentication)
+     */
+    changePassword(oldPassword: string, newPassword: string): Promise<void>;
+    /**
+     * Generate email verification token (for custom email delivery)
+     */
+    generateEmailVerificationToken(): Promise<{
+        token: string;
+        expiresAt: string;
+        verifyUrl: string;
+    }>;
+    /**
+     * Send email verification (using Blink default email service)
+     */
+    sendEmailVerification(): Promise<void>;
+    /**
+     * Verify email with token
+     */
+    verifyEmail(token: string): Promise<void>;
+    /**
+     * Generate magic link token (for custom email delivery)
+     */
+    generateMagicLinkToken(email: string, options?: MagicLinkOptions): Promise<{
+        token: string;
+        expiresAt: string;
+        magicUrl: string;
+    }>;
+    /**
+     * Send magic link (using Blink default email service)
+     */
+    sendMagicLink(email: string, options?: MagicLinkOptions): Promise<void>;
+    /**
+     * Verify magic link (automatic on redirect)
+     */
+    verifyMagicLink(token?: string): Promise<BlinkUser>;
+    /**
+     * Get available providers for the current project
+     */
+    getAvailableProviders(): Promise<AuthProvider[]>;
+    /**
+     * Check if user has a specific role
+     */
+    hasRole(role: string | string[]): boolean;
+    /**
+     * Check if user can perform a specific action
+     */
+    can(permission: string, resource?: string): boolean;
+    /**
+     * Sign out (clear local tokens)
+     * Note: With stateless tokens, this only clears local storage
+     */
+    signOut(): Promise<void>;
+    /**
+     * @deprecated Use signOut() instead. Kept for backward compatibility.
+     */
+    revokeAllSessions(): Promise<void>;
+    /**
+     * Recover auth state (clear corrupted tokens and re-initialize)
+     */
+    recoverAuthState(): Promise<void>;
     /**
      * Update user profile
      */
@@ -853,6 +1008,22 @@ declare class BlinkAuth {
     private redirectToAuth;
     private setLoading;
     private updateAuthState;
+    /**
+     * Generate secure random state for OAuth flows
+     */
+    private generateState;
+    /**
+     * Extract magic link token from URL
+     */
+    private extractMagicTokenFromUrl;
+    /**
+     * Map server error codes to BlinkAuthErrorCode
+     */
+    private mapErrorCodeFromResponse;
+    /**
+     * Setup cross-tab authentication synchronization
+     */
+    private setupCrossTabSync;
 }
 
 /**
@@ -1447,14 +1618,11 @@ declare class BlinkAIImpl implements BlinkAI {
      */
     streamObject(options: ObjectGenerationRequest, onPartial: (partial: any) => void): Promise<ObjectGenerationResponse>;
     /**
-     * Generates images from text descriptions using AI.
+     * Generates images from text descriptions using Gemini 2.5 Flash Image.
      *
      * @param options - Object containing:
-     *   - `prompt`: Text description of the desired image (required)
-     *   - `size`: Image dimensions (default: "1024x1024")
-     *   - `quality`: Image quality ("auto", "low", "medium", or "high", default: "auto")
+     *   - `prompt`: Text description of the desired image (required, up to 100k characters)
      *   - `n`: Number of images to generate (default: 1)
-     *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
      *   - Plus optional signal parameter
      *
      * @example
@@ -1465,47 +1633,36 @@ declare class BlinkAIImpl implements BlinkAI {
      * });
      * console.log("Image URL:", data[0].url);
      *
-      * // High-quality image with specific size
-   * const { data } = await blink.ai.generateImage({
-   *   prompt: "A futuristic city skyline with flying cars",
-   *   size: "1536x1024",
-   *   quality: "high",
-   *   background: "transparent"
-   * });
-     *
-      * // Multiple images
-   * const { data } = await blink.ai.generateImage({
-   *   prompt: "A cute robot mascot for a tech company",
-   *   n: 3,
-   *   size: "1024x1024",
-   *   quality: "high"
-   * });
+     * // Multiple images
+     * const { data } = await blink.ai.generateImage({
+     *   prompt: "A futuristic city skyline with flying cars",
+     *   n: 3
+     * });
      * data.forEach((img, i) => console.log(`Image ${i+1}:`, img.url));
+     *
+     * // Detailed prompt for better results
+     * const { data } = await blink.ai.generateImage({
+     *   prompt: "A cute robot mascot for a tech company, digital art style, vibrant colors, modern design, friendly expression"
+     * });
      * ```
      *
      * @returns Promise<ImageGenerationResponse> - Object containing:
      *   - `data`: Array of generated images with URLs
      *   - `created`: Timestamp of generation
-     *   - `usage`: Token usage information
+     *   - `model`: Always "gemini-2.5-flash-image-preview"
      */
     generateImage(options: {
         prompt: string;
-        size?: string;
-        quality?: "auto" | "low" | "medium" | "high";
         n?: number;
-        background?: "auto" | "transparent" | "opaque";
         signal?: AbortSignal;
     }): Promise<ImageGenerationResponse>;
     /**
-     * Modifies existing images using AI with text prompts for image-to-image editing.
+     * Modifies existing images using Gemini 2.5 Flash Image with text prompts for image-to-image editing.
      *
      * @param options - Object containing:
-     *   - `images`: Array of public image URLs to modify (required, up to 16 images)
-     *   - `prompt`: Text description of desired modifications (required)
-     *   - `size`: Output image dimensions (default: "auto")
-     *   - `quality`: Image quality ("auto", "low", "medium", or "high", default: "auto")
+     *   - `images`: Array of public image URLs to modify (required, up to 50 images)
+     *   - `prompt`: Text description of desired modifications (required, up to 100k characters)
      *   - `n`: Number of output images to generate (default: 1)
-     *   - `background`: Background handling ("auto", "transparent", "opaque", default: "auto")
      *   - Plus optional signal parameter
      *
      * @example
@@ -1516,25 +1673,21 @@ declare class BlinkAIImpl implements BlinkAI {
      *     "https://storage.example.com/user-photo-1.jpg",
      *     "https://storage.example.com/user-photo-2.jpg"
      *   ],
-      *   prompt: "Transform into professional business headshots with studio lighting",
-   *   quality: "high",
-   *   n: 4
+     *   prompt: "Transform into professional business headshots with studio lighting",
+     *   n: 4
      * });
      * data.forEach((img, i) => console.log(`Headshot ${i+1}:`, img.url));
      *
      * // 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",
-   *   quality: "high",
-   *   size: "1024x1024"
-   * });
+     * const { data } = await blink.ai.modifyImage({
+     *   images: ["https://storage.example.com/portrait.jpg"],
+     *   prompt: "Transform into oil painting style with dramatic lighting"
+     * });
      *
      * // Background replacement
      * const { data } = await blink.ai.modifyImage({
      *   images: ["https://storage.example.com/product.jpg"],
      *   prompt: "Remove background and place on clean white studio background",
-     *   background: "transparent",
      *   n: 2
      * });
      *
@@ -1545,24 +1698,33 @@ declare class BlinkAIImpl implements BlinkAI {
      *   "https://storage.example.com/photo3.jpg"
      * ];
      * const { data } = await blink.ai.modifyImage({
-      *   images: userPhotos,
-   *   prompt: "Convert to black and white vintage style photographs",
-   *   quality: "high"
+     *   images: userPhotos,
+     *   prompt: "Convert to black and white vintage style photographs"
+     * });
+     *
+     * // 🎨 Style Transfer - IMPORTANT: Provide all images in array
+     * // ❌ WRONG - Don't reference other images in prompt
+     * const wrong = await blink.ai.modifyImage({
+     *   images: [userPhotoUrl],
+     *   prompt: `Apply hairstyle from ${referenceUrl}`
+     * });
+     *
+     * // ✅ CORRECT - Provide all images in array
+     * const { data } = await blink.ai.modifyImage({
+     *   images: [userPhotoUrl, hairstyleReferenceUrl],
+     *   prompt: "Apply the hairstyle from the second image to the person in the first image"
      * });
      * ```
      *
      * @returns Promise<ImageGenerationResponse> - Object containing:
      *   - `data`: Array of modified images with URLs
      *   - `created`: Timestamp of generation
-     *   - `usage`: Token usage information
+     *   - `model`: Always "gemini-2.5-flash-image-preview"
      */
     modifyImage(options: {
         images: string[];
         prompt: string;
-        size?: string;
-        quality?: "auto" | "low" | "medium" | "high";
         n?: number;
-        background?: "auto" | "transparent" | "opaque";
         signal?: AbortSignal;
     }): Promise<ImageGenerationResponse>;
     /**