@rovela-ai/sdk 0.1.2 → 0.1.4

package/dist/auth/server/verification-service.js

@@ -0,0 +1,268 @@
+"use strict";
+/**
+ * @rovela/sdk/auth/server/verification-service
+ *
+ * Email verification token management.
+ * Handles creating, validating, and cleaning up verification tokens.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVerificationToken = createVerificationToken;
+exports.verifyEmail = verifyEmail;
+exports.deleteVerificationTokens = deleteVerificationTokens;
+exports.resendVerificationEmail = resendVerificationEmail;
+exports.isEmailVerified = isEmailVerified;
+exports.cleanupExpiredTokens = cleanupExpiredTokens;
+const drizzle_orm_1 = require("drizzle-orm");
+const nanoid_1 = require("nanoid");
+const client_1 = require("../../core/db/client");
+const schema = __importStar(require("../../core/db/schema"));
+const customer_service_1 = require("./customer-service");
+const email_sender_1 = require("./email-sender");
+// =============================================================================
+// Constants
+// =============================================================================
+/**
+ * Verification token expiry time in milliseconds (24 hours).
+ */
+const TOKEN_EXPIRY_MS = 24 * 60 * 60 * 1000;
+/**
+ * Token length (URL-safe).
+ */
+const TOKEN_LENGTH = 32;
+// =============================================================================
+// Token Management
+// =============================================================================
+/**
+ * Create a verification token for a customer.
+ * Deletes any existing tokens for the customer first.
+ *
+ * @param customerId - Customer UUID
+ * @returns The verification token
+ *
+ * @example
+ * ```typescript
+ * const token = await createVerificationToken(customerId)
+ * // Use token in verification email link
+ * ```
+ */
+async function createVerificationToken(customerId) {
+    const db = (0, client_1.getDb)();
+    const tenantId = (0, client_1.getTenantId)();
+    // Delete any existing tokens for this customer
+    await deleteVerificationTokens(customerId);
+    // Generate new token
+    const token = (0, nanoid_1.nanoid)(TOKEN_LENGTH);
+    const expires = new Date(Date.now() + TOKEN_EXPIRY_MS);
+    await db.insert(schema.customerVerificationTokens).values({
+        tenantId,
+        customerId,
+        token,
+        expires,
+    });
+    return token;
+}
+/**
+ * Verify email using a token.
+ * Marks the customer's email as verified if token is valid.
+ *
+ * @param token - Verification token from email link
+ * @returns Verification result
+ *
+ * @example
+ * ```typescript
+ * const result = await verifyEmail(token)
+ * if (result.success) {
+ *   console.log('Email verified for customer:', result.customerId)
+ * } else {
+ *   console.error('Verification failed:', result.error)
+ * }
+ * ```
+ */
+async function verifyEmail(token) {
+    const db = (0, client_1.getDb)();
+    // Find the token (not tenant-scoped since we only have the token)
+    const [tokenRecord] = await db
+        .select()
+        .from(schema.customerVerificationTokens)
+        .where((0, drizzle_orm_1.eq)(schema.customerVerificationTokens.token, token))
+        .limit(1);
+    if (!tokenRecord) {
+        return {
+            success: false,
+            error: 'Invalid verification link. Please request a new one.',
+        };
+    }
+    // Check if token has expired
+    if (new Date() > tokenRecord.expires) {
+        // Clean up expired token
+        await db
+            .delete(schema.customerVerificationTokens)
+            .where((0, drizzle_orm_1.eq)(schema.customerVerificationTokens.id, tokenRecord.id));
+        return {
+            success: false,
+            error: 'Verification link has expired. Please request a new one.',
+        };
+    }
+    // Mark customer email as verified
+    await (0, customer_service_1.markEmailVerified)(tokenRecord.customerId);
+    // Delete the used token and any other tokens for this customer
+    await db
+        .delete(schema.customerVerificationTokens)
+        .where((0, drizzle_orm_1.eq)(schema.customerVerificationTokens.customerId, tokenRecord.customerId));
+    // Send welcome email (non-blocking)
+    sendWelcomeEmailAsync(tokenRecord.customerId);
+    return {
+        success: true,
+        customerId: tokenRecord.customerId,
+    };
+}
+/**
+ * Delete all verification tokens for a customer.
+ *
+ * @param customerId - Customer UUID
+ *
+ * @example
+ * ```typescript
+ * await deleteVerificationTokens(customerId)
+ * ```
+ */
+async function deleteVerificationTokens(customerId) {
+    const db = (0, client_1.getDb)();
+    const tenantId = (0, client_1.getTenantId)();
+    await db
+        .delete(schema.customerVerificationTokens)
+        .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema.customerVerificationTokens.tenantId, tenantId), (0, drizzle_orm_1.eq)(schema.customerVerificationTokens.customerId, customerId)));
+}
+/**
+ * Resend verification email to a customer.
+ * Creates a new token and sends the email.
+ *
+ * @param email - Customer email address
+ * @returns Result with success status
+ *
+ * @example
+ * ```typescript
+ * const result = await resendVerificationEmail('customer@example.com')
+ * if (result.success) {
+ *   console.log('Verification email sent')
+ * }
+ * ```
+ */
+async function resendVerificationEmail(email) {
+    // Find customer by email
+    const customer = await (0, customer_service_1.findCustomerByEmail)(email);
+    if (!customer) {
+        // Don't reveal if email exists - return success anyway
+        return { success: true };
+    }
+    // Check if already verified
+    if (customer.emailVerified) {
+        return {
+            success: false,
+            error: 'Email is already verified',
+        };
+    }
+    // Create new verification token
+    const token = await createVerificationToken(customer.id);
+    // Send verification email
+    const storeName = (0, email_sender_1.getStoreName)();
+    try {
+        await (0, email_sender_1.sendVerificationEmail)(email, token, storeName);
+        return { success: true };
+    }
+    catch {
+        return {
+            success: false,
+            error: 'Failed to send verification email. Please try again.',
+        };
+    }
+}
+/**
+ * Check if a customer's email is verified.
+ *
+ * @param customerId - Customer UUID
+ * @returns True if email is verified
+ */
+async function isEmailVerified(customerId) {
+    const db = (0, client_1.getDb)();
+    const tenantId = (0, client_1.getTenantId)();
+    const [customer] = await db
+        .select({ emailVerified: schema.customers.emailVerified })
+        .from(schema.customers)
+        .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(schema.customers.tenantId, tenantId), (0, drizzle_orm_1.eq)(schema.customers.id, customerId)))
+        .limit(1);
+    return !!customer?.emailVerified;
+}
+/**
+ * Clean up expired verification tokens.
+ * Should be called periodically (e.g., via cron job).
+ *
+ * @returns Number of tokens deleted
+ */
+async function cleanupExpiredTokens() {
+    const db = (0, client_1.getDb)();
+    const result = await db
+        .delete(schema.customerVerificationTokens)
+        .where((0, drizzle_orm_1.lt)(schema.customerVerificationTokens.expires, new Date()))
+        .returning({ id: schema.customerVerificationTokens.id });
+    return result.length;
+}
+// =============================================================================
+// Internal Helpers
+// =============================================================================
+/**
+ * Send welcome email asynchronously (fire and forget).
+ * Used after successful email verification.
+ */
+async function sendWelcomeEmailAsync(customerId) {
+    try {
+        const db = (0, client_1.getDb)();
+        const [customer] = await db
+            .select({ email: schema.customers.email, name: schema.customers.name })
+            .from(schema.customers)
+            .where((0, drizzle_orm_1.eq)(schema.customers.id, customerId))
+            .limit(1);
+        if (customer) {
+            const storeName = (0, email_sender_1.getStoreName)();
+            await (0, email_sender_1.sendWelcomeEmail)(customer.email, customer.name, storeName);
+        }
+    }
+    catch (error) {
+        // Log but don't throw - welcome email is not critical
+        console.error('[Auth Verification] Failed to send welcome email:', error);
+    }
+}
+//# sourceMappingURL=verification-service.js.map

package/dist/auth/server/verification-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-service.js","sourceRoot":"","sources":["../../../src/auth/server/verification-service.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCH,0DAqBC;AAmBD,kCAiDC;AAYD,4DAcC;AAiBD,0DAkCC;AAQD,0CAgBC;AAQD,oDASC;AArPD,6CAAyC;AACzC,mCAA+B;AAC/B,iDAAyD;AACzD,6DAA8C;AAC9C,yDAA2E;AAC3E,iDAAsF;AAEtF,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;GAEG;AACH,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAE3C;;GAEG;AACH,MAAM,YAAY,GAAG,EAAE,CAAA;AAEvB,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,uBAAuB,CAC3C,UAAkB;IAElB,MAAM,EAAE,GAAG,IAAA,cAAK,GAAE,CAAA;IAClB,MAAM,QAAQ,GAAG,IAAA,oBAAW,GAAE,CAAA;IAE9B,+CAA+C;IAC/C,MAAM,wBAAwB,CAAC,UAAU,CAAC,CAAA;IAE1C,qBAAqB;IACrB,MAAM,KAAK,GAAG,IAAA,eAAM,EAAC,YAAY,CAAC,CAAA;IAClC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,CAAC,CAAA;IAEtD,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,MAAM,CAAC;QACxD,QAAQ;QACR,UAAU;QACV,KAAK;QACL,OAAO;KACR,CAAC,CAAA;IAEF,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,UAAU,WAAW,CAAC,KAAa;IAK7C,MAAM,EAAE,GAAG,IAAA,cAAK,GAAE,CAAA;IAElB,kEAAkE;IAClE,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,EAAE;SAC3B,MAAM,EAAE;SACR,IAAI,CAAC,MAAM,CAAC,0BAA0B,CAAC;SACvC,KAAK,CAAC,IAAA,gBAAE,EAAC,MAAM,CAAC,0BAA0B,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;SACzD,KAAK,CAAC,CAAC,CAAC,CAAA;IAEX,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,sDAAsD;SAC9D,CAAA;IACH,CAAC;IAED,6BAA6B;IAC7B,IAAI,IAAI,IAAI,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC;QACrC,yBAAyB;QACzB,MAAM,EAAE;aACL,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC;aACzC,KAAK,CAAC,IAAA,gBAAE,EAAC,MAAM,CAAC,0BAA0B,CAAC,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,CAAA;QAElE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,0DAA0D;SAClE,CAAA;IACH,CAAC;IAED,kCAAkC;IAClC,MAAM,IAAA,oCAAiB,EAAC,WAAW,CAAC,UAAU,CAAC,CAAA;IAE/C,+DAA+D;IAC/D,MAAM,EAAE;SACL,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC;SACzC,KAAK,CAAC,IAAA,gBAAE,EAAC,MAAM,CAAC,0BAA0B,CAAC,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC,CAAA;IAElF,oCAAoC;IACpC,qBAAqB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAA;IAE7C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,WAAW,CAAC,UAAU;KACnC,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACI,KAAK,UAAU,wBAAwB,CAC5C,UAAkB;IAElB,MAAM,EAAE,GAAG,IAAA,cAAK,GAAE,CAAA;IAClB,MAAM,QAAQ,GAAG,IAAA,oBAAW,GAAE,CAAA;IAE9B,MAAM,EAAE;SACL,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC;SACzC,KAAK,CACJ,IAAA,iBAAG,EACD,IAAA,gBAAE,EAAC,MAAM,CAAC,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,CAAC,EACxD,IAAA,gBAAE,EAAC,MAAM,CAAC,0BAA0B,CAAC,UAAU,EAAE,UAAU,CAAC,CAC7D,CACF,CAAA;AACL,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,uBAAuB,CAAC,KAAa;IAIzD,yBAAyB;IACzB,MAAM,QAAQ,GAAG,MAAM,IAAA,sCAAmB,EAAC,KAAK,CAAC,CAAA;IAEjD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,uDAAuD;QACvD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;IAED,4BAA4B;IAC5B,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,2BAA2B;SACnC,CAAA;IACH,CAAC;IAED,gCAAgC;IAChC,MAAM,KAAK,GAAG,MAAM,uBAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAExD,0BAA0B;IAC1B,MAAM,SAAS,GAAG,IAAA,2BAAY,GAAE,CAAA;IAChC,IAAI,CAAC;QACH,MAAM,IAAA,oCAAqB,EAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;QACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,sDAAsD;SAC9D,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,eAAe,CAAC,UAAkB;IACtD,MAAM,EAAE,GAAG,IAAA,cAAK,GAAE,CAAA;IAClB,MAAM,QAAQ,GAAG,IAAA,oBAAW,GAAE,CAAA;IAE9B,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE;SACxB,MAAM,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;SACzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;SACtB,KAAK,CACJ,IAAA,iBAAG,EACD,IAAA,gBAAE,EAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,EACvC,IAAA,gBAAE,EAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,CAAC,CACpC,CACF;SACA,KAAK,CAAC,CAAC,CAAC,CAAA;IAEX,OAAO,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAA;AAClC,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,oBAAoB;IACxC,MAAM,EAAE,GAAG,IAAA,cAAK,GAAE,CAAA;IAElB,MAAM,MAAM,GAAG,MAAM,EAAE;SACpB,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC;SACzC,KAAK,CAAC,IAAA,gBAAE,EAAC,MAAM,CAAC,0BAA0B,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;SAChE,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,0BAA0B,CAAC,EAAE,EAAE,CAAC,CAAA;IAE1D,OAAO,MAAM,CAAC,MAAM,CAAA;AACtB,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;GAGG;AACH,KAAK,UAAU,qBAAqB,CAAC,UAAkB;IACrD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAA,cAAK,GAAE,CAAA;QAClB,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE;aACxB,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;aACtE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;aACtB,KAAK,CAAC,IAAA,gBAAE,EAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;aAC1C,KAAK,CAAC,CAAC,CAAC,CAAA;QAEX,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,IAAA,2BAAY,GAAE,CAAA;YAChC,MAAM,IAAA,+BAAgB,EAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QAClE,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sDAAsD;QACtD,OAAO,CAAC,KAAK,CAAC,mDAAmD,EAAE,KAAK,CAAC,CAAA;IAC3E,CAAC;AACH,CAAC"}

package/dist/auth/types.d.ts

@@ -0,0 +1,305 @@
+/**
+ * @rovela/sdk/auth/types
+ *
+ * Type definitions for customer authentication.
+ */
+/**
+ * Customer session data stored in JWT token.
+ * This is what's available after authentication.
+ */
+export interface CustomerSession {
+    /** Customer UUID */
+    id: string;
+    /** Customer email */
+    email: string;
+    /** Customer name (optional) */
+    name?: string | null;
+    /** Whether email has been verified */
+    emailVerified: boolean;
+}
+/**
+ * Extended session type for NextAuth.
+ */
+export interface AuthSession {
+    user: CustomerSession;
+    expires: string;
+}
+/**
+ * Authentication state returned by useAuth hook.
+ */
+export interface AuthState {
+    /** Current customer session (null if not authenticated) */
+    customer: CustomerSession | null;
+    /** Whether customer is authenticated */
+    isAuthenticated: boolean;
+    /** Whether auth state is loading */
+    isLoading: boolean;
+    /** Whether customer's email is verified */
+    isEmailVerified: boolean;
+}
+/**
+ * Options for signing in.
+ */
+export interface SignInOptions {
+    /** Customer email */
+    email: string;
+    /** Customer password */
+    password: string;
+    /** Whether to extend session duration (30 days vs 24 hours) */
+    rememberMe?: boolean;
+    /** URL to redirect to after successful sign in */
+    redirectTo?: string;
+}
+/**
+ * Result of sign in attempt.
+ */
+export interface SignInResult {
+    /** Whether sign in was successful */
+    success: boolean;
+    /** Error message if sign in failed */
+    error?: string;
+    /** Whether customer needs to verify email first */
+    requiresVerification?: boolean;
+    /** Customer email (for showing verification notice) */
+    email?: string;
+}
+/**
+ * Data for signing up a new customer.
+ */
+export interface SignUpData {
+    /** Customer email */
+    email: string;
+    /** Customer password (minimum 8 characters) */
+    password: string;
+    /** Customer name (optional) */
+    name?: string;
+}
+/**
+ * Result of sign up attempt.
+ */
+export interface SignUpResult {
+    /** Whether sign up was successful */
+    success: boolean;
+    /** Error message if sign up failed */
+    error?: string;
+    /** Customer ID if sign up was successful */
+    customerId?: string;
+    /** Whether verification email was sent */
+    verificationEmailSent?: boolean;
+}
+/**
+ * Result of password reset request.
+ */
+export interface PasswordResetRequestResult {
+    /** Always true for security (don't reveal if email exists) */
+    success: boolean;
+}
+/**
+ * Result of password reset execution.
+ */
+export interface PasswordResetResult {
+    /** Whether password was reset successfully */
+    success: boolean;
+    /** Error message if reset failed */
+    error?: string;
+}
+/**
+ * Result of token validation.
+ */
+export interface TokenValidationResult {
+    /** Whether token is valid */
+    valid: boolean;
+    /** Error message if token is invalid */
+    error?: string;
+}
+/**
+ * Result of email verification.
+ */
+export interface VerifyEmailResult {
+    /** Whether verification was successful */
+    success: boolean;
+    /** Error message if verification failed */
+    error?: string;
+}
+/**
+ * Result of resend verification request.
+ */
+export interface ResendVerificationResult {
+    /** Whether email was sent successfully */
+    success: boolean;
+    /** Error message if sending failed */
+    error?: string;
+}
+/**
+ * Props for SignInForm component.
+ */
+export interface SignInFormProps {
+    /** URL to redirect to after successful sign in */
+    redirectTo?: string;
+    /** Callback when sign in is successful */
+    onSuccess?: () => void;
+    /** Whether to show "Remember me" checkbox (default: true) */
+    showRememberMe?: boolean;
+    /** Link to sign up page (default: '/auth/signup') */
+    signUpHref?: string;
+    /** Link to forgot password page (default: '/auth/forgot-password') */
+    forgotPasswordHref?: string;
+    /** Custom class name */
+    className?: string;
+}
+/**
+ * Props for SignUpForm component.
+ */
+export interface SignUpFormProps {
+    /** URL to redirect to after successful sign up */
+    redirectTo?: string;
+    /** Callback when sign up is successful */
+    onSuccess?: () => void;
+    /** Link to sign in page (default: '/auth/signin') */
+    signInHref?: string;
+    /** Custom class name */
+    className?: string;
+}
+/**
+ * Props for ForgotPasswordForm component.
+ */
+export interface ForgotPasswordFormProps {
+    /** Callback when request is sent successfully */
+    onSuccess?: () => void;
+    /** Link to sign in page (default: '/auth/signin') */
+    signInHref?: string;
+    /** Custom class name */
+    className?: string;
+}
+/**
+ * Props for ResetPasswordForm component.
+ */
+export interface ResetPasswordFormProps {
+    /** Reset token from URL */
+    token: string;
+    /** Callback when password is reset successfully */
+    onSuccess?: () => void;
+    /** Link to sign in page (default: '/auth/signin') */
+    signInHref?: string;
+    /** Custom class name */
+    className?: string;
+}
+/**
+ * Props for VerifyEmailNotice component.
+ */
+export interface VerifyEmailNoticeProps {
+    /** Customer email to show in notice */
+    email: string;
+    /** Callback when resend is clicked */
+    onResend?: () => Promise<void>;
+    /** Custom class name */
+    className?: string;
+}
+/**
+ * Props for UserMenu component.
+ */
+export interface UserMenuProps {
+    /** Link to account page (default: '/account') */
+    accountHref?: string;
+    /** Link to orders page (default: '/account/orders') */
+    ordersHref?: string;
+    /** Link to settings page (default: '/account/settings') */
+    settingsHref?: string;
+    /** Custom class name */
+    className?: string;
+}
+/**
+ * Props for AuthGuard component.
+ */
+export interface AuthGuardProps {
+    /** Child components to render when authenticated */
+    children: React.ReactNode;
+    /** Fallback component to render when not authenticated */
+    fallback?: React.ReactNode;
+    /** URL to redirect to when not authenticated (default: '/auth/signin') */
+    redirectTo?: string;
+    /** Whether to require verified email (default: true) */
+    requireVerified?: boolean;
+    /** Loading component to show while checking auth */
+    loadingComponent?: React.ReactNode;
+}
+/**
+ * API error response.
+ */
+export interface AuthApiError {
+    /** Error message */
+    error: string;
+    /** Error code for programmatic handling */
+    code?: 'INVALID_CREDENTIALS' | 'EMAIL_NOT_VERIFIED' | 'EMAIL_EXISTS' | 'INVALID_TOKEN' | 'TOKEN_EXPIRED' | 'VALIDATION_ERROR';
+}
+/**
+ * Register API request body.
+ */
+export interface RegisterRequest {
+    email: string;
+    password: string;
+    name?: string;
+}
+/**
+ * Register API response.
+ */
+export interface RegisterResponse {
+    success: boolean;
+    customerId: string;
+    message: string;
+}
+/**
+ * Verify email API response.
+ */
+export interface VerifyEmailResponse {
+    success: boolean;
+    message: string;
+}
+/**
+ * Forgot password API request body.
+ */
+export interface ForgotPasswordRequest {
+    email: string;
+}
+/**
+ * Reset password API request body.
+ */
+export interface ResetPasswordRequest {
+    token: string;
+    password: string;
+}
+/**
+ * Options for creating auth configuration.
+ */
+export interface AuthConfigOptions {
+    /** Default session duration in seconds (default: 24 hours) */
+    sessionMaxAge?: number;
+    /** Extended session duration for "remember me" in seconds (default: 30 days) */
+    rememberMeMaxAge?: number;
+    /** Require email verification before login (default: true) */
+    requireEmailVerification?: boolean;
+    /** Custom sign in page path (default: '/auth/signin') */
+    signInPage?: string;
+    /** Custom error page path (default: '/auth/signin') */
+    errorPage?: string;
+}
+/**
+ * Return type for useAuth hook.
+ */
+export interface UseAuthReturn extends AuthState {
+    /** Sign in with email and password */
+    signIn: (options: SignInOptions) => Promise<SignInResult>;
+    /** Sign up with email and password */
+    signUp: (data: SignUpData) => Promise<SignUpResult>;
+    /** Sign out */
+    signOut: () => Promise<void>;
+    /** Resend verification email */
+    resendVerification: (email: string) => Promise<ResendVerificationResult>;
+    /** Request password reset */
+    requestPasswordReset: (email: string) => Promise<PasswordResetRequestResult>;
+    /** Reset password with token */
+    resetPassword: (token: string, newPassword: string) => Promise<PasswordResetResult>;
+    /** Validate reset token */
+    validateResetToken: (token: string) => Promise<TokenValidationResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/auth/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":"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"}

package/dist/auth/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * @rovela/sdk/auth/types
+ *
+ * Type definitions for customer authentication.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/auth/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/cart/CartProvider.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @rovela/sdk/cart/CartProvider
+ *
+ * Optional provider for SSR-safe cart hydration.
+ * Ensures cart state is properly hydrated from localStorage after mount.
+ */
+import { type ReactNode } from 'react';
+export interface CartProviderProps {
+    /**
+     * Child components that will have access to the cart.
+     */
+    children: ReactNode;
+    /**
+     * Optional callback when hydration is complete.
+     */
+    onHydrated?: () => void;
+}
+/**
+ * CartProvider component for SSR-safe cart hydration.
+ *
+ * This provider is optional but recommended for Next.js apps.
+ * It ensures the cart is properly hydrated from localStorage
+ * after the component mounts, preventing hydration mismatches.
+ *
+ * @example
+ * ```tsx
+ * // In app/layout.tsx:
+ * import { CartProvider } from '@rovela/sdk/cart'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <CartProvider>
+ *           {children}
+ *         </CartProvider>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ */
+export declare function CartProvider({ children, onHydrated }: CartProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to check if the cart has been hydrated.
+ * Useful for showing loading states or skeleton UI.
+ *
+ * @example
+ * ```tsx
+ * import { useCartHydrated } from '@rovela/sdk/cart'
+ *
+ * function CartIcon() {
+ *   const hydrated = useCartHydrated()
+ *   const { itemCount } = useCart()
+ *
+ *   if (!hydrated) {
+ *     return <span className="animate-pulse">...</span>
+ *   }
+ *
+ *   return <span>{itemCount}</span>
+ * }
+ * ```
+ */
+export declare function useCartHydrated(): boolean;
+//# sourceMappingURL=CartProvider.d.ts.map

package/dist/cart/CartProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CartProvider.d.ts","sourceRoot":"","sources":["../../src/cart/CartProvider.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAO3D,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAA;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,iBAAiB,2CAoBvE;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAqBzC"}