omni-sync-sdk 0.7.8 → 0.7.10

package/README.md

@@ -903,6 +903,153 @@ interface CustomerAuthResponse {
   };
   token: string;
   expiresAt: string;
+  requiresVerification?: boolean; // true if email verification is required
+}
+```
+
+---
+
+### Email Verification
+
+If the store has **email verification enabled**, customers must verify their email after registration before they can fully use their account.
+
+#### Registration with Email Verification
+
+When `requiresVerification` is true in the registration response, the customer needs to verify their email:
+
+```typescript
+const auth = await omni.registerCustomer({
+  email: 'customer@example.com',
+  password: 'securepassword123',
+  firstName: 'John',
+});
+
+if (auth.requiresVerification) {
+  // Save token for verification step
+  localStorage.setItem('verificationToken', auth.token);
+  // Redirect to verification page
+  window.location.href = '/verify-email';
+} else {
+  // No verification needed - proceed normally
+  setCustomerToken(auth.token);
+  window.location.href = '/account';
+}
+```
+
+#### Verify Email with Code
+
+After the customer receives the 6-digit code via email:
+
+```typescript
+// Get the token saved from registration
+const token = localStorage.getItem('verificationToken');
+
+// Verify email - pass the token directly (no need to call setCustomerToken first!)
+const result = await omni.verifyEmail(code, token);
+
+if (result.verified) {
+  // Email verified! Now set the token for normal use
+  setCustomerToken(token);
+  localStorage.removeItem('verificationToken');
+  window.location.href = '/account';
+}
+```
+
+#### Resend Verification Email
+
+If the customer didn't receive the email or the code expired:
+
+```typescript
+const token = localStorage.getItem('verificationToken');
+await omni.resendVerificationEmail(token);
+// Show success message - new code sent
+```
+
+> **Note:** Resend is rate-limited to 3 requests per hour.
+
+#### Complete Email Verification Page Example
+
+```typescript
+'use client';
+import { useState } from 'react';
+import { omni, setCustomerToken } from '@/lib/omni-sync';
+import { toast } from 'sonner';
+
+export default function VerifyEmailPage() {
+  const [code, setCode] = useState('');
+  const [loading, setLoading] = useState(false);
+
+  const handleVerify = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setLoading(true);
+
+    try {
+      const token = localStorage.getItem('verificationToken');
+      if (!token) {
+        toast.error('No verification token found. Please register again.');
+        return;
+      }
+
+      const result = await omni.verifyEmail(code, token);
+
+      if (result.verified) {
+        toast.success('Email verified!');
+        setCustomerToken(token);
+        localStorage.removeItem('verificationToken');
+        window.location.href = '/account';
+      }
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : 'Verification failed');
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  const handleResend = async () => {
+    try {
+      const token = localStorage.getItem('verificationToken');
+      if (!token) {
+        toast.error('No verification token found');
+        return;
+      }
+      await omni.resendVerificationEmail(token);
+      toast.success('Verification code sent!');
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : 'Failed to resend');
+    }
+  };
+
+  return (
+    <div className="max-w-md mx-auto mt-12">
+      <h1 className="text-2xl font-bold mb-4">Verify Your Email</h1>
+      <p className="text-gray-600 mb-6">
+        We sent a 6-digit code to your email. Enter it below to verify your account.
+      </p>
+
+      <form onSubmit={handleVerify} className="space-y-4">
+        <input
+          type="text"
+          placeholder="Enter 6-digit code"
+          value={code}
+          onChange={(e) => setCode(e.target.value)}
+          maxLength={6}
+          className="w-full border p-3 rounded text-center text-2xl tracking-widest"
+          required
+        />
+        <button
+          type="submit"
+          disabled={loading || code.length !== 6}
+          className="w-full bg-black text-white py-3 rounded disabled:opacity-50"
+        >
+          {loading ? 'Verifying...' : 'Verify Email'}
+        </button>
+      </form>
+
+      <button onClick={handleResend} className="mt-4 text-blue-600 text-sm">
+        Didn't receive the code? Resend
+      </button>
+    </div>
+  );
 }
 ```
 
@@ -1684,8 +1831,17 @@ export default function RegisterPage() {
     setError('');
     try {
       const auth = await omni.registerCustomer({ email, password, firstName, lastName });
-      setCustomerToken(auth.token);
-      window.location.href = '/account';
+
+      // Check if email verification is required
+      if (auth.requiresVerification) {
+        // Save token for verification step
+        localStorage.setItem('verificationToken', auth.token);
+        window.location.href = '/verify-email';
+      } else {
+        // No verification needed - proceed normally
+        setCustomerToken(auth.token);
+        window.location.href = '/account';
+      }
     } catch (err) {
       setError('Registration failed. Email may already be in use.');
     } finally {
@@ -1989,6 +2145,7 @@ When building a store, implement these pages:
 - [ ] **Checkout** (`/checkout`) - Multi-step checkout flow
 - [ ] **Login** (`/login`) - Customer login
 - [ ] **Register** (`/register`) - Customer registration
+- [ ] **Verify Email** (`/verify-email`) - Email verification with 6-digit code (if store requires it)
 - [ ] **Account** (`/account`) - Profile and order history
 
 ---

package/dist/index.d.mts

@@ -1670,31 +1670,43 @@ declare class OmniSyncClient {
     }>;
     /**
      * Verify customer email with a verification code
-     * Requires a customer token to be set via setCustomerToken()
      * Only available in vibe-coded mode
      *
+     * @param code - The 6-digit verification code from the email
+     * @param token - Optional customer token. If not provided, uses the token set via setCustomerToken()
+     *
      * @example
      * ```typescript
-     * // After registration with requiresVerification: true
+     * // Option 1: Pass token directly (recommended for verification flow)
+     * const auth = await omni.registerCustomer({...});
+     * if (auth.requiresVerification) {
+     *   const result = await omni.verifyEmail('123456', auth.token);
+     * }
+     *
+     * // Option 2: Use setCustomerToken first
      * omni.setCustomerToken(auth.token);
      * const result = await omni.verifyEmail('123456');
-     * console.log(result.verified); // true
      * ```
      */
-    verifyEmail(code: string): Promise<EmailVerificationResponse>;
+    verifyEmail(code: string, token?: string): Promise<EmailVerificationResponse>;
     /**
      * Resend verification email
-     * Requires a customer token to be set via setCustomerToken()
      * Only available in vibe-coded mode
      * Rate limited to 3 requests per hour
      *
+     * @param token - Optional customer token. If not provided, uses the token set via setCustomerToken()
+     *
      * @example
      * ```typescript
+     * // Option 1: Pass token directly
+     * await omni.resendVerificationEmail(auth.token);
+     *
+     * // Option 2: Use setCustomerToken first
      * omni.setCustomerToken(auth.token);
      * await omni.resendVerificationEmail();
      * ```
      */
-    resendVerificationEmail(): Promise<{
+    resendVerificationEmail(token?: string): Promise<{
         message: string;
     }>;
     /**

package/dist/index.d.ts

@@ -1670,31 +1670,43 @@ declare class OmniSyncClient {
     }>;
     /**
      * Verify customer email with a verification code
-     * Requires a customer token to be set via setCustomerToken()
      * Only available in vibe-coded mode
      *
+     * @param code - The 6-digit verification code from the email
+     * @param token - Optional customer token. If not provided, uses the token set via setCustomerToken()
+     *
      * @example
      * ```typescript
-     * // After registration with requiresVerification: true
+     * // Option 1: Pass token directly (recommended for verification flow)
+     * const auth = await omni.registerCustomer({...});
+     * if (auth.requiresVerification) {
+     *   const result = await omni.verifyEmail('123456', auth.token);
+     * }
+     *
+     * // Option 2: Use setCustomerToken first
      * omni.setCustomerToken(auth.token);
      * const result = await omni.verifyEmail('123456');
-     * console.log(result.verified); // true
      * ```
      */
-    verifyEmail(code: string): Promise<EmailVerificationResponse>;
+    verifyEmail(code: string, token?: string): Promise<EmailVerificationResponse>;
     /**
      * Resend verification email
-     * Requires a customer token to be set via setCustomerToken()
      * Only available in vibe-coded mode
      * Rate limited to 3 requests per hour
      *
+     * @param token - Optional customer token. If not provided, uses the token set via setCustomerToken()
+     *
      * @example
      * ```typescript
+     * // Option 1: Pass token directly
+     * await omni.resendVerificationEmail(auth.token);
+     *
+     * // Option 2: Use setCustomerToken first
      * omni.setCustomerToken(auth.token);
      * await omni.resendVerificationEmail();
      * ```
      */
-    resendVerificationEmail(): Promise<{
+    resendVerificationEmail(token?: string): Promise<{
         message: string;
     }>;
     /**

package/dist/index.js

@@ -1097,48 +1097,95 @@ var OmniSyncClient = class {
   }
   /**
    * Verify customer email with a verification code
-   * Requires a customer token to be set via setCustomerToken()
    * Only available in vibe-coded mode
    *
+   * @param code - The 6-digit verification code from the email
+   * @param token - Optional customer token. If not provided, uses the token set via setCustomerToken()
+   *
    * @example
    * ```typescript
-   * // After registration with requiresVerification: true
+   * // Option 1: Pass token directly (recommended for verification flow)
+   * const auth = await omni.registerCustomer({...});
+   * if (auth.requiresVerification) {
+   *   const result = await omni.verifyEmail('123456', auth.token);
+   * }
+   *
+   * // Option 2: Use setCustomerToken first
    * omni.setCustomerToken(auth.token);
    * const result = await omni.verifyEmail('123456');
-   * console.log(result.verified); // true
    * ```
    */
-  async verifyEmail(code) {
-    if (!this.customerToken) {
-      throw new OmniSyncError("Customer token is required. Call setCustomerToken() first.", 401);
+  async verifyEmail(code, token) {
+    const effectiveToken = token || this.customerToken;
+    if (!effectiveToken) {
+      throw new OmniSyncError(
+        "Customer token is required. Pass token parameter or call setCustomerToken() first.",
+        401
+      );
     }
-    if (this.isVibeCodedMode()) {
-      return this.vibeCodedRequest("POST", "/customers/verify-email", {
-        code
-      });
+    const originalToken = this.customerToken;
+    if (token) {
+      this.customerToken = token;
+    }
+    try {
+      if (this.isVibeCodedMode()) {
+        return await this.vibeCodedRequest(
+          "POST",
+          "/customers/verify-email",
+          {
+            code
+          }
+        );
+      }
+      throw new OmniSyncError("verifyEmail is only available in vibe-coded mode", 400);
+    } finally {
+      if (token) {
+        this.customerToken = originalToken;
+      }
     }
-    throw new OmniSyncError("verifyEmail is only available in vibe-coded mode", 400);
   }
   /**
    * Resend verification email
-   * Requires a customer token to be set via setCustomerToken()
    * Only available in vibe-coded mode
    * Rate limited to 3 requests per hour
    *
+   * @param token - Optional customer token. If not provided, uses the token set via setCustomerToken()
+   *
    * @example
    * ```typescript
+   * // Option 1: Pass token directly
+   * await omni.resendVerificationEmail(auth.token);
+   *
+   * // Option 2: Use setCustomerToken first
    * omni.setCustomerToken(auth.token);
    * await omni.resendVerificationEmail();
    * ```
    */
-  async resendVerificationEmail() {
-    if (!this.customerToken) {
-      throw new OmniSyncError("Customer token is required. Call setCustomerToken() first.", 401);
+  async resendVerificationEmail(token) {
+    const effectiveToken = token || this.customerToken;
+    if (!effectiveToken) {
+      throw new OmniSyncError(
+        "Customer token is required. Pass token parameter or call setCustomerToken() first.",
+        401
+      );
     }
-    if (this.isVibeCodedMode()) {
-      return this.vibeCodedRequest("POST", "/customers/resend-verification");
+    const originalToken = this.customerToken;
+    if (token) {
+      this.customerToken = token;
+    }
+    try {
+      if (this.isVibeCodedMode()) {
+        return await this.vibeCodedRequest(
+          "POST",
+          "/customers/resend-verification"
+        );
+      }
+      throw new OmniSyncError("resendVerificationEmail is only available in vibe-coded mode", 400);
+    } finally {
+      if (token) {
+        this.customerToken = originalToken;
+      }
     }
-    throw new OmniSyncError("resendVerificationEmail is only available in vibe-coded mode", 400);
   }
   /**
    * Get the current logged-in customer's profile

package/dist/index.mjs

@@ -1072,48 +1072,95 @@ var OmniSyncClient = class {
   }
   /**
    * Verify customer email with a verification code
-   * Requires a customer token to be set via setCustomerToken()
    * Only available in vibe-coded mode
    *
+   * @param code - The 6-digit verification code from the email
+   * @param token - Optional customer token. If not provided, uses the token set via setCustomerToken()
+   *
    * @example
    * ```typescript
-   * // After registration with requiresVerification: true
+   * // Option 1: Pass token directly (recommended for verification flow)
+   * const auth = await omni.registerCustomer({...});
+   * if (auth.requiresVerification) {
+   *   const result = await omni.verifyEmail('123456', auth.token);
+   * }
+   *
+   * // Option 2: Use setCustomerToken first
    * omni.setCustomerToken(auth.token);
    * const result = await omni.verifyEmail('123456');
-   * console.log(result.verified); // true
    * ```
    */
-  async verifyEmail(code) {
-    if (!this.customerToken) {
-      throw new OmniSyncError("Customer token is required. Call setCustomerToken() first.", 401);
+  async verifyEmail(code, token) {
+    const effectiveToken = token || this.customerToken;
+    if (!effectiveToken) {
+      throw new OmniSyncError(
+        "Customer token is required. Pass token parameter or call setCustomerToken() first.",
+        401
+      );
     }
-    if (this.isVibeCodedMode()) {
-      return this.vibeCodedRequest("POST", "/customers/verify-email", {
-        code
-      });
+    const originalToken = this.customerToken;
+    if (token) {
+      this.customerToken = token;
+    }
+    try {
+      if (this.isVibeCodedMode()) {
+        return await this.vibeCodedRequest(
+          "POST",
+          "/customers/verify-email",
+          {
+            code
+          }
+        );
+      }
+      throw new OmniSyncError("verifyEmail is only available in vibe-coded mode", 400);
+    } finally {
+      if (token) {
+        this.customerToken = originalToken;
+      }
     }
-    throw new OmniSyncError("verifyEmail is only available in vibe-coded mode", 400);
   }
   /**
    * Resend verification email
-   * Requires a customer token to be set via setCustomerToken()
    * Only available in vibe-coded mode
    * Rate limited to 3 requests per hour
    *
+   * @param token - Optional customer token. If not provided, uses the token set via setCustomerToken()
+   *
    * @example
    * ```typescript
+   * // Option 1: Pass token directly
+   * await omni.resendVerificationEmail(auth.token);
+   *
+   * // Option 2: Use setCustomerToken first
    * omni.setCustomerToken(auth.token);
    * await omni.resendVerificationEmail();
    * ```
    */
-  async resendVerificationEmail() {
-    if (!this.customerToken) {
-      throw new OmniSyncError("Customer token is required. Call setCustomerToken() first.", 401);
+  async resendVerificationEmail(token) {
+    const effectiveToken = token || this.customerToken;
+    if (!effectiveToken) {
+      throw new OmniSyncError(
+        "Customer token is required. Pass token parameter or call setCustomerToken() first.",
+        401
+      );
     }
-    if (this.isVibeCodedMode()) {
-      return this.vibeCodedRequest("POST", "/customers/resend-verification");
+    const originalToken = this.customerToken;
+    if (token) {
+      this.customerToken = token;
+    }
+    try {
+      if (this.isVibeCodedMode()) {
+        return await this.vibeCodedRequest(
+          "POST",
+          "/customers/resend-verification"
+        );
+      }
+      throw new OmniSyncError("resendVerificationEmail is only available in vibe-coded mode", 400);
+    } finally {
+      if (token) {
+        this.customerToken = originalToken;
+      }
     }
-    throw new OmniSyncError("resendVerificationEmail is only available in vibe-coded mode", 400);
   }
   /**
    * Get the current logged-in customer's profile

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-sync-sdk",
-  "version": "0.7.8",
+  "version": "0.7.10",
   "description": "Official SDK for building e-commerce storefronts with OmniSync Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -16,6 +16,14 @@
     "dist",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint \"src/**/*.ts\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "pnpm build"
+  },
   "keywords": [
     "omni-sync",
     "e-commerce",
@@ -64,12 +72,5 @@
     "typescript": {
       "optional": true
     }
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "lint": "eslint \"src/**/*.ts\"",
-    "test": "vitest run",
-    "test:watch": "vitest"
   }
-}
+}