@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/cart/store.js

@@ -0,0 +1,315 @@
+/**
+ * @rovela/sdk/cart/store
+ *
+ * Zustand cart store with localStorage persistence.
+ * Client-side only - no database, no API calls.
+ */
+import { create } from 'zustand';
+import { persist, createJSONStorage } from 'zustand/middleware';
+// =============================================================================
+// Constants
+// =============================================================================
+const STORAGE_KEY = 'rovela-cart';
+const STORAGE_VERSION = 2;
+// Cart metadata caps — defense-in-depth before Stripe (Stripe Checkout
+// Session metadata caps at 50 keys / 500 chars per value). We set tighter
+// caps so app-level validation rejects bad input before it ever reaches
+// the Checkout Session creation.
+const CART_METADATA_MAX_KEYS = 10;
+const CART_METADATA_MAX_VALUE_LENGTH = 200;
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Generate a unique cart item ID from product and variant.
+ * Format: productId or productId-variantId
+ */
+function generateCartItemId(productId, variantId) {
+    return variantId ? `${productId}-${variantId}` : productId;
+}
+/**
+ * Calculate the total item count in the cart.
+ */
+function calculateItemCount(items) {
+    return items.reduce((sum, item) => sum + item.quantity, 0);
+}
+/**
+ * Calculate the subtotal of all items.
+ */
+function calculateSubtotal(items) {
+    return items.reduce((sum, item) => sum + item.price * item.quantity, 0);
+}
+/**
+ * Extract the price from a product or variant.
+ * Variant price overrides product price if present.
+ */
+function extractPrice(product, variant) {
+    if (variant?.price !== undefined && variant.price !== null) {
+        return typeof variant.price === 'string'
+            ? parseFloat(variant.price)
+            : variant.price;
+    }
+    return typeof product.price === 'string'
+        ? parseFloat(product.price)
+        : product.price;
+}
+// =============================================================================
+// Store
+// =============================================================================
+/**
+ * Cart store with localStorage persistence.
+ *
+ * @example
+ * ```tsx
+ * import { useCart } from '@rovela/sdk/cart'
+ *
+ * function CartButton() {
+ *   const { itemCount, openCart } = useCart()
+ *   return (
+ *     <button onClick={openCart}>
+ *       Cart ({itemCount})
+ *     </button>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * import { useCart } from '@rovela/sdk/cart'
+ *
+ * function ProductPage({ product, variant }) {
+ *   const { addItem } = useCart()
+ *
+ *   const handleAddToCart = () => {
+ *     addItem(product, variant, 1)
+ *   }
+ *
+ *   return <button onClick={handleAddToCart}>Add to Cart</button>
+ * }
+ * ```
+ */
+export const useCart = create()(persist((set, get) => ({
+    // =======================================================================
+    // State
+    // =======================================================================
+    items: [],
+    metadata: {},
+    isOpen: false,
+    // =======================================================================
+    // Getters (computed as getters on the store)
+    // =======================================================================
+    get itemCount() {
+        return calculateItemCount(get().items);
+    },
+    get subtotal() {
+        return calculateSubtotal(get().items);
+    },
+    getItem: (productId, variantId) => {
+        const itemId = generateCartItemId(productId, variantId);
+        return get().items.find((item) => item.id === itemId);
+    },
+    hasItem: (productId, variantId) => {
+        return get().getItem(productId, variantId) !== undefined;
+    },
+    // =======================================================================
+    // Actions
+    // =======================================================================
+    addItem: (product, variant, quantity = 1) => {
+        const itemId = generateCartItemId(product.id, variant?.id);
+        const price = extractPrice(product, variant);
+        set((state) => {
+            const existingIndex = state.items.findIndex((item) => item.id === itemId);
+            if (existingIndex >= 0) {
+                // Item exists - increment quantity
+                const updatedItems = [...state.items];
+                updatedItems[existingIndex] = {
+                    ...updatedItems[existingIndex],
+                    quantity: updatedItems[existingIndex].quantity + quantity,
+                };
+                return { items: updatedItems };
+            }
+            // New item - add to cart
+            const newItem = {
+                id: itemId,
+                productId: product.id,
+                variantId: variant?.id,
+                name: variant ? `${product.name} - ${variant.name}` : product.name,
+                price,
+                quantity,
+                image: product.images?.[0],
+                attributes: variant?.attributes,
+            };
+            return { items: [...state.items, newItem] };
+        });
+    },
+    updateQuantity: (itemId, quantity) => {
+        if (quantity <= 0) {
+            // Remove item if quantity is 0 or less
+            get().removeItem(itemId);
+            return;
+        }
+        set((state) => ({
+            items: state.items.map((item) => item.id === itemId ? { ...item, quantity } : item),
+        }));
+    },
+    removeItem: (itemId) => {
+        set((state) => ({
+            items: state.items.filter((item) => item.id !== itemId),
+        }));
+    },
+    clearCart: () => {
+        set({ items: [] });
+    },
+    openCart: () => {
+        set({ isOpen: true });
+    },
+    closeCart: () => {
+        set({ isOpen: false });
+    },
+    toggleCart: () => {
+        set((state) => ({ isOpen: !state.isOpen }));
+    },
+    setMetadata: (key, value) => {
+        if (typeof key !== 'string' || key.length === 0) {
+            throw new Error('cart.setMetadata: key must be a non-empty string');
+        }
+        if (typeof value !== 'string') {
+            throw new Error('cart.setMetadata: value must be a string');
+        }
+        if (value.length > CART_METADATA_MAX_VALUE_LENGTH) {
+            throw new Error(`cart.setMetadata: value exceeds ${CART_METADATA_MAX_VALUE_LENGTH} chars (got ${value.length})`);
+        }
+        set((state) => {
+            const isNewKey = !(key in state.metadata);
+            if (isNewKey && Object.keys(state.metadata).length >= CART_METADATA_MAX_KEYS) {
+                throw new Error(`cart.setMetadata: cart already has ${CART_METADATA_MAX_KEYS} keys (max). Remove one before adding more.`);
+            }
+            return { metadata: { ...state.metadata, [key]: value } };
+        });
+    },
+    removeMetadata: (key) => {
+        set((state) => {
+            if (!(key in state.metadata))
+                return state;
+            const next = { ...state.metadata };
+            delete next[key];
+            return { metadata: next };
+        });
+    },
+    clearMetadata: () => {
+        set({ metadata: {} });
+    },
+}), {
+    name: STORAGE_KEY,
+    version: STORAGE_VERSION,
+    storage: createJSONStorage(() => {
+        // SSR-safe: check if window is available
+        if (typeof window === 'undefined') {
+            return {
+                getItem: () => null,
+                setItem: () => { },
+                removeItem: () => { },
+            };
+        }
+        return localStorage;
+    }),
+    // Only persist items + metadata, not UI state (drawer open/closed)
+    partialize: (state) => ({
+        items: state.items,
+        metadata: state.metadata,
+    }),
+    // Skip hydration on server, hydrate manually via CartProvider
+    skipHydration: true,
+    // STORAGE_VERSION migrations.
+    //
+    // v1 → v2: Add `metadata: {}` to existing carts. Items are
+    // preserved verbatim. Old carts without metadata get an empty
+    // object; the field exists on every persisted state from v2 on.
+    migrate: (persistedState, fromVersion) => {
+        // Defensive: persistedState is `unknown` because zustand can't
+        // type-narrow legacy schemas. We only touch the `metadata` slot
+        // and pass the rest through.
+        const state = (persistedState ?? {});
+        if (fromVersion < 2) {
+            return {
+                ...state,
+                items: state.items ?? [],
+                metadata: state.metadata ?? {},
+            };
+        }
+        return persistedState;
+    },
+}));
+// =============================================================================
+// Hydration Helper
+// =============================================================================
+/**
+ * Manually trigger hydration from localStorage.
+ * Call this in CartProvider's useEffect.
+ */
+export function hydrateCart() {
+    useCart.persist.rehydrate();
+}
+/**
+ * Check if the cart has been hydrated.
+ */
+export function isCartHydrated() {
+    return useCart.persist.hasHydrated();
+}
+// =============================================================================
+// Module Duplication Fallback
+// =============================================================================
+/**
+ * Get cart items with lazy hydration fallback.
+ *
+ * This function handles webpack module duplication issues in Next.js where
+ * different route chunks may get separate instances of the useCart store.
+ * When CartProvider hydrates one instance, other instances remain empty.
+ *
+ * This helper reads directly from localStorage if the store instance is empty,
+ * ensuring reliable cart data regardless of which module instance is used.
+ *
+ * @example
+ * ```tsx
+ * import { getCartItemsWithFallback } from '@rovela-ai/sdk/cart'
+ *
+ * function CartPage() {
+ *   const items = getCartItemsWithFallback()
+ *   const itemCount = items.reduce((sum, item) => sum + item.quantity, 0)
+ *   // ...
+ * }
+ * ```
+ */
+export function getCartItemsWithFallback() {
+    // Try the store first
+    const storeItems = useCart.getState().items;
+    // If store has items, use them
+    if (storeItems.length > 0) {
+        return storeItems;
+    }
+    // Store is empty - check if it's because we're unhydrated
+    // Read directly from localStorage as fallback
+    if (typeof window !== 'undefined') {
+        try {
+            const stored = localStorage.getItem(STORAGE_KEY);
+            if (stored) {
+                const parsed = JSON.parse(stored);
+                const items = parsed?.state?.items || [];
+                if (items.length > 0) {
+                    // Found items in localStorage that store doesn't have
+                    // This means we have a module duplication issue
+                    // Trigger hydration on this instance to sync future reads
+                    if (!useCart.persist.hasHydrated()) {
+                        useCart.persist.rehydrate();
+                    }
+                    return items;
+                }
+            }
+        }
+        catch {
+            // Ignore parse errors, return empty array
+        }
+    }
+    return storeItems;
+}
+//# sourceMappingURL=store.js.map

package/dist/cart/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/cart/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAG/D,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,WAAW,GAAG,aAAa,CAAA;AACjC,MAAM,eAAe,GAAG,CAAC,CAAA;AAEzB,uEAAuE;AACvE,0EAA0E;AAC1E,wEAAwE;AACxE,iCAAiC;AACjC,MAAM,sBAAsB,GAAG,EAAE,CAAA;AACjC,MAAM,8BAA8B,GAAG,GAAG,CAAA;AA4F1C,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;GAGG;AACH,SAAS,kBAAkB,CAAC,SAAiB,EAAE,SAAkB;IAC/D,OAAO,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AAC5D,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,KAAiB;IAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAiB;IAC1C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;AACzE,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,OAAgB,EAAE,OAA+B;IACrE,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC3D,OAAO,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YACtC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;YAC3B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAA;IACnB,CAAC;IACD,OAAO,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;QACtC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;QAC3B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAA;AACnB,CAAC;AAED,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,EAAa,CACxC,OAAO,CACL,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACb,0EAA0E;IAC1E,QAAQ;IACR,0EAA0E;IAC1E,KAAK,EAAE,EAAE;IACT,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,KAAK;IAEb,0EAA0E;IAC1E,6CAA6C;IAC7C,0EAA0E;IAC1E,IAAI,SAAS;QACX,OAAO,kBAAkB,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;IACxC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,iBAAiB,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;IACvC,CAAC;IAED,OAAO,EAAE,CAAC,SAAiB,EAAE,SAAkB,EAAE,EAAE;QACjD,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;QACvD,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAA;IACvD,CAAC;IAED,OAAO,EAAE,CAAC,SAAiB,EAAE,SAAkB,EAAE,EAAE;QACjD,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,SAAS,CAAA;IAC1D,CAAC;IAED,0EAA0E;IAC1E,UAAU;IACV,0EAA0E;IAC1E,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,GAAG,CAAC,EAAE,EAAE;QAC1C,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAA;QAC1D,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAE5C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACZ,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAA;YAEzE,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;gBACvB,mCAAmC;gBACnC,MAAM,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;gBACrC,YAAY,CAAC,aAAa,CAAC,GAAG;oBAC5B,GAAG,YAAY,CAAC,aAAa,CAAC;oBAC9B,QAAQ,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,QAAQ,GAAG,QAAQ;iBAC1D,CAAA;gBACD,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;YAChC,CAAC;YAED,yBAAyB;YACzB,MAAM,OAAO,GAAa;gBACxB,EAAE,EAAE,MAAM;gBACV,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,SAAS,EAAE,OAAO,EAAE,EAAE;gBACtB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI;gBAClE,KAAK;gBACL,QAAQ;gBACR,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBAC1B,UAAU,EAAE,OAAO,EAAE,UAAU;aAChC,CAAA;YAED,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAA;QAC7C,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,cAAc,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;QACnC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,uCAAuC;YACvC,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;YACxB,OAAM;QACR,CAAC;QAED,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACd,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC9B,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAClD;SACF,CAAC,CAAC,CAAA;IACL,CAAC;IAED,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;QACrB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACd,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC;SACxD,CAAC,CAAC,CAAA;IACL,CAAC;IAED,SAAS,EAAE,GAAG,EAAE;QACd,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;IACpB,CAAC;IAED,QAAQ,EAAE,GAAG,EAAE;QACb,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IACvB,CAAC;IAED,SAAS,EAAE,GAAG,EAAE;QACd,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IACxB,CAAC;IAED,UAAU,EAAE,GAAG,EAAE;QACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC7C,CAAC;IAED,WAAW,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC1B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;QACrE,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;QAC7D,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,8BAA8B,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,mCAAmC,8BAA8B,eAAe,KAAK,CAAC,MAAM,GAAG,CAChG,CAAA;QACH,CAAC;QACD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACZ,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAA;YACzC,IAAI,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,IAAI,sBAAsB,EAAE,CAAC;gBAC7E,MAAM,IAAI,KAAK,CACb,sCAAsC,sBAAsB,6CAA6C,CAC1G,CAAA;YACH,CAAC;YACD,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAA;QAC1D,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE;QACtB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACZ,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC;gBAAE,OAAO,KAAK,CAAA;YAC1C,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;YAClC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;YAChB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;QAC3B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,aAAa,EAAE,GAAG,EAAE;QAClB,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAA;IACvB,CAAC;CACF,CAAC,EACF;IACE,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,iBAAiB,CAAC,GAAG,EAAE;QAC9B,yCAAyC;QACzC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;gBACnB,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;gBACjB,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC;aACrB,CAAA;QACH,CAAC;QACD,OAAO,YAAY,CAAA;IACrB,CAAC,CAAC;IACF,mEAAmE;IACnE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC;IACF,8DAA8D;IAC9D,aAAa,EAAE,IAAI;IACnB,8BAA8B;IAC9B,EAAE;IACF,2DAA2D;IAC3D,8DAA8D;IAC9D,gEAAgE;IAChE,OAAO,EAAE,CAAC,cAAuB,EAAE,WAAmB,EAAE,EAAE;QACxD,+DAA+D;QAC/D,gEAAgE;QAChE,6BAA6B;QAC7B,MAAM,KAAK,GAAG,CAAC,cAAc,IAAI,EAAE,CAAuB,CAAA;QAC1D,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO;gBACL,GAAG,KAAK;gBACR,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;gBACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;aAClB,CAAA;QAChB,CAAC;QACD,OAAO,cAA2B,CAAA;IACpC,CAAC;CACF,CACF,CACF,CAAA;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAA;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;AACtC,CAAC;AAED,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,wBAAwB;IACtC,sBAAsB;IACtB,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAA;IAE3C,+BAA+B;IAC/B,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,0DAA0D;IAC1D,8CAA8C;IAC9C,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;YAChD,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBACjC,MAAM,KAAK,GAAe,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAA;gBACpD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,sDAAsD;oBACtD,gDAAgD;oBAChD,0DAA0D;oBAC1D,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;wBACnC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAA;oBAC7B,CAAC;oBACD,OAAO,KAAK,CAAA;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/checkout/api/checkout.js

@@ -0,0 +1,112 @@
+/**
+ * @rovela/sdk/checkout/api/checkout
+ *
+ * API route handler for creating checkout sessions.
+ *
+ * Usage in Next.js App Router:
+ * ```typescript
+ * // app/api/checkout/route.ts
+ * export { POST } from '@rovela/sdk/checkout/api'
+ * ```
+ */
+import { NextResponse } from 'next/server';
+import { createCheckoutSession } from '../server/create-checkout-session';
+import { findSettings } from '../../core/db/queries';
+// =============================================================================
+// Handler
+// =============================================================================
+/**
+ * POST /api/checkout
+ *
+ * Creates a Stripe Checkout session and returns the URL to redirect to.
+ *
+ * Request Body:
+ * - items: Array of line items (required)
+ * - customerEmail: Customer email (optional)
+ * - successUrl: Success redirect URL (optional, defaults to /checkout/success)
+ * - cancelUrl: Cancel redirect URL (optional, defaults to /cart)
+ * - metadata: Additional metadata (optional)
+ *
+ * Response:
+ * - sessionId: Stripe Checkout session ID
+ * - url: URL to redirect customer to
+ */
+export async function POST(request) {
+    try {
+        const body = (await request.json());
+        // Check guest checkout setting
+        const settings = await findSettings();
+        const allowGuestCheckout = settings?.guestCheckout ?? true;
+        if (!allowGuestCheckout && !body.customerId) {
+            return NextResponse.json({
+                error: 'Guest checkout is disabled. Please sign in to continue.',
+                code: 'GUEST_CHECKOUT_DISABLED',
+            }, { status: 403 });
+        }
+        // Validate items
+        if (!body.items || !Array.isArray(body.items) || body.items.length === 0) {
+            return NextResponse.json({ error: 'No items provided', code: 'EMPTY_CART' }, { status: 400 });
+        }
+        // Validate each item has required fields
+        for (const item of body.items) {
+            if (!item.name || typeof item.price !== 'number' || item.price <= 0) {
+                return NextResponse.json({
+                    error: 'Invalid item: each item must have name and positive price',
+                    code: 'INVALID_REQUEST',
+                }, { status: 400 });
+            }
+            if (!item.quantity || item.quantity < 1) {
+                return NextResponse.json({
+                    error: 'Invalid item: quantity must be at least 1',
+                    code: 'INVALID_REQUEST',
+                }, { status: 400 });
+            }
+        }
+        // Build request
+        const origin = request.headers.get('origin') || request.nextUrl.origin;
+        const checkoutRequest = {
+            items: body.items,
+            customerEmail: body.customerEmail,
+            customerId: body.customerId,
+            successUrl: body.successUrl ||
+                `${origin}/checkout/success?session_id={CHECKOUT_SESSION_ID}`,
+            cancelUrl: body.cancelUrl || `${origin}/cart`,
+            metadata: body.metadata,
+            shippingAddress: body.shippingAddress,
+            selectedShipping: body.selectedShipping,
+        };
+        // Create checkout session
+        const session = await createCheckoutSession(checkoutRequest);
+        return NextResponse.json(session);
+    }
+    catch (error) {
+        console.error('[Checkout API] Error:', error);
+        // Handle specific error types
+        if (error instanceof Error) {
+            // Stripe not configured
+            if (error.message.includes('STRIPE_SECRET_KEY')) {
+                return NextResponse.json({
+                    error: 'Payment system not configured. Please contact the store owner.',
+                    code: 'STRIPE_NOT_CONFIGURED',
+                }, { status: 500 });
+            }
+            // Connected account not set up
+            if (error.message.includes('STRIPE_CONNECTED_ACCOUNT_ID')) {
+                return NextResponse.json({
+                    error: 'Store payments not set up. The store owner must complete Stripe onboarding.',
+                    code: 'ACCOUNT_NOT_CONNECTED',
+                }, { status: 500 });
+            }
+            // Generic Stripe error
+            if (error.message.includes('Stripe')) {
+                return NextResponse.json({ error: 'Payment provider error. Please try again.', code: 'CHECKOUT_ERROR' }, { status: 500 });
+            }
+        }
+        // Unknown error
+        return NextResponse.json({
+            error: 'Failed to create checkout session. Please try again.',
+            code: 'CHECKOUT_ERROR',
+        }, { status: 500 });
+    }
+}
+//# sourceMappingURL=checkout.js.map

package/dist/checkout/api/checkout.js.map

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

package/dist/checkout/api/countries.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @rovela/sdk/checkout/api/countries
+ *
+ * Public API endpoint to get allowed shipping countries.
+ * Returns countries from store_settings.shippingCountries.
+ */
+import { NextResponse } from 'next/server';
+/**
+ * GET /api/checkout/countries
+ *
+ * Returns the list of allowed shipping countries for this store.
+ * Used by CheckoutFlow to filter the country dropdown in ShippingForm.
+ *
+ * @returns { success: true, countries: string[] }
+ */
+export declare function GET(): Promise<NextResponse>;
+//# sourceMappingURL=countries.d.ts.map

package/dist/checkout/api/countries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countries.d.ts","sourceRoot":"","sources":["../../../src/checkout/api/countries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C;;;;;;;GAOG;AACH,wBAAsB,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,CAuBjD"}

package/dist/checkout/api/countries.js

@@ -0,0 +1,38 @@
+/**
+ * @rovela/sdk/checkout/api/countries
+ *
+ * Public API endpoint to get allowed shipping countries.
+ * Returns countries from store_settings.shippingCountries.
+ */
+import { NextResponse } from 'next/server';
+import { findSettings } from '../../core/db/queries';
+/**
+ * GET /api/checkout/countries
+ *
+ * Returns the list of allowed shipping countries for this store.
+ * Used by CheckoutFlow to filter the country dropdown in ShippingForm.
+ *
+ * @returns { success: true, countries: string[] }
+ */
+export async function GET() {
+    try {
+        const settings = await findSettings();
+        // Use shippingCountries from settings, fallback to US/CA if not configured
+        const countries = settings?.shippingCountries && settings.shippingCountries.length > 0
+            ? settings.shippingCountries
+            : ['US', 'CA'];
+        return NextResponse.json({
+            success: true,
+            countries,
+        });
+    }
+    catch (error) {
+        console.error('[Checkout] Failed to fetch shipping countries:', error);
+        // Graceful fallback - return default countries on error
+        return NextResponse.json({
+            success: true,
+            countries: ['US', 'CA'],
+        });
+    }
+}
+//# sourceMappingURL=countries.js.map

package/dist/checkout/api/countries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"countries.js","sourceRoot":"","sources":["../../../src/checkout/api/countries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG;IACvB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAA;QAErC,2EAA2E;QAC3E,MAAM,SAAS,GACb,QAAQ,EAAE,iBAAiB,IAAI,QAAQ,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC;YAClE,CAAC,CAAC,QAAQ,CAAC,iBAAiB;YAC5B,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAElB,OAAO,YAAY,CAAC,IAAI,CAAC;YACvB,OAAO,EAAE,IAAI;YACb,SAAS;SACV,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,gDAAgD,EAAE,KAAK,CAAC,CAAA;QAEtE,wDAAwD;QACxD,OAAO,YAAY,CAAC,IAAI,CAAC;YACvB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;SACxB,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}

package/dist/checkout/api/index.js

@@ -0,0 +1,11 @@
+/**
+ * @rovela/sdk/checkout/api
+ *
+ * API route handlers for checkout
+ */
+export { POST } from './checkout';
+export { POST as WebhookPOST } from './webhook';
+export { GET as PaymentStatusGET } from './payment-status';
+export { POST as ShippingPOST } from './shipping';
+export { GET as CountriesGET } from './countries';
+//# sourceMappingURL=index.js.map

package/dist/checkout/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/checkout/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjC,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,GAAG,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,GAAG,IAAI,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/checkout/api/payment-status.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @rovela/sdk/checkout/api/payment-status
+ *
+ * API route handler for checking payment configuration status.
+ * Returns whether the store can accept payments.
+ *
+ * This handler verifies:
+ * 1. Environment variables are configured (STRIPE_SECRET_KEY, publishable key)
+ * 2. Connected account ID is set (STRIPE_CONNECTED_ACCOUNT_ID)
+ * 3. Connected account is active with charges_enabled (via Stripe API)
+ *
+ * Usage in Next.js App Router:
+ * ```typescript
+ * // app/api/checkout/status/route.ts
+ * export { GET } from '@rovela-ai/sdk/checkout/api/payment-status'
+ * ```
+ */
+import { NextResponse } from 'next/server';
+export interface PaymentStatusResponse {
+    /** Whether the store can accept payments */
+    canAcceptPayments: boolean;
+    /** Status reason */
+    status: 'active' | 'not_configured' | 'incomplete' | 'restricted' | 'pending';
+    /** Human-readable message */
+    message: string;
+    /** Additional details for debugging (only in development) */
+    details?: {
+        chargesEnabled?: boolean;
+        payoutsEnabled?: boolean;
+        detailsSubmitted?: boolean;
+    };
+}
+/**
+ * GET /api/checkout/status
+ *
+ * Checks if the store is configured to accept payments.
+ * Performs actual Stripe API call to verify account status.
+ *
+ * Response:
+ * - canAcceptPayments: boolean
+ * - status: 'active' | 'not_configured' | 'incomplete' | 'restricted' | 'pending'
+ * - message: Human-readable explanation
+ */
+export declare function GET(): Promise<NextResponse<PaymentStatusResponse>>;
+//# sourceMappingURL=payment-status.d.ts.map

package/dist/checkout/api/payment-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-status.d.ts","sourceRoot":"","sources":["../../../src/checkout/api/payment-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAO1C,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,iBAAiB,EAAE,OAAO,CAAA;IAC1B,oBAAoB;IACpB,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAA;IAC7E,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAC3B,CAAA;CACF;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC,CA8ExE"}