omni-sync-sdk 0.7.9 → 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.js

@@ -1118,7 +1118,10 @@ var OmniSyncClient = class {
   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);
+      throw new OmniSyncError(
+        "Customer token is required. Pass token parameter or call setCustomerToken() first.",
+        401
+      );
     }
     const originalToken = this.customerToken;
     if (token) {
@@ -1126,9 +1129,13 @@ var OmniSyncClient = class {
     }
     try {
       if (this.isVibeCodedMode()) {
-        return await this.vibeCodedRequest("POST", "/customers/verify-email", {
-          code
-        });
+        return await this.vibeCodedRequest(
+          "POST",
+          "/customers/verify-email",
+          {
+            code
+          }
+        );
       }
       throw new OmniSyncError("verifyEmail is only available in vibe-coded mode", 400);
     } finally {
@@ -1157,7 +1164,10 @@ var OmniSyncClient = class {
   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);
+      throw new OmniSyncError(
+        "Customer token is required. Pass token parameter or call setCustomerToken() first.",
+        401
+      );
     }
     const originalToken = this.customerToken;
     if (token) {
@@ -1165,7 +1175,10 @@ var OmniSyncClient = class {
     }
     try {
       if (this.isVibeCodedMode()) {
-        return await this.vibeCodedRequest("POST", "/customers/resend-verification");
+        return await this.vibeCodedRequest(
+          "POST",
+          "/customers/resend-verification"
+        );
       }
       throw new OmniSyncError("resendVerificationEmail is only available in vibe-coded mode", 400);
     } finally {

package/dist/index.mjs

@@ -1093,7 +1093,10 @@ var OmniSyncClient = class {
   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);
+      throw new OmniSyncError(
+        "Customer token is required. Pass token parameter or call setCustomerToken() first.",
+        401
+      );
     }
     const originalToken = this.customerToken;
     if (token) {
@@ -1101,9 +1104,13 @@ var OmniSyncClient = class {
     }
     try {
       if (this.isVibeCodedMode()) {
-        return await this.vibeCodedRequest("POST", "/customers/verify-email", {
-          code
-        });
+        return await this.vibeCodedRequest(
+          "POST",
+          "/customers/verify-email",
+          {
+            code
+          }
+        );
       }
       throw new OmniSyncError("verifyEmail is only available in vibe-coded mode", 400);
     } finally {
@@ -1132,7 +1139,10 @@ var OmniSyncClient = class {
   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);
+      throw new OmniSyncError(
+        "Customer token is required. Pass token parameter or call setCustomerToken() first.",
+        401
+      );
     }
     const originalToken = this.customerToken;
     if (token) {
@@ -1140,7 +1150,10 @@ var OmniSyncClient = class {
     }
     try {
       if (this.isVibeCodedMode()) {
-        return await this.vibeCodedRequest("POST", "/customers/resend-verification");
+        return await this.vibeCodedRequest(
+          "POST",
+          "/customers/resend-verification"
+        );
       }
       throw new OmniSyncError("resendVerificationEmail is only available in vibe-coded mode", 400);
     } finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-sync-sdk",
-  "version": "0.7.9",
+  "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",