@fayz-ai/storefront 0.2.0

package/dist/stores/cart.store.d.ts

@@ -0,0 +1,58 @@
+import type { Product } from '@fayz-ai/shop/types';
+import type { ResolvedStorefrontConfig } from '../config';
+import { type ProductOptionSelection } from '../product-options';
+export interface CartLine {
+    lineId: string;
+    productId: string;
+    slug: string;
+    name: string;
+    sku: string | null;
+    options: ProductOptionSelection;
+    optionsLabel: string;
+    unitPrice: number;
+    quantity: number;
+    imageUrl: string | null;
+    /** inventoryCount at add time — clamps quantity */
+    maxQuantity: number;
+}
+export interface CartState {
+    lines: CartLine[];
+    discountCode: string | null;
+    discountPercent: number;
+    isOpen: boolean;
+    /** Line most recently added — lets the drawer briefly highlight it. */
+    justAddedLineId: string | null;
+    addItem(product: Product, qty?: number, options?: ProductOptionSelection): void;
+    setQuantity(lineId: string, qty: number): void;
+    removeItem(lineId: string): void;
+    applyDiscount(code: string, percent: number): void;
+    clearDiscount(): void;
+    clear(): void;
+    openDrawer(): void;
+    closeDrawer(): void;
+}
+export declare const useCartStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<CartState>, "persist"> & {
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<CartState, {
+            lines: CartLine[];
+            discountCode: string | null;
+            discountPercent: number;
+        }>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: CartState) => void) => () => void;
+        onFinishHydration: (fn: (state: CartState) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<CartState, {
+            lines: CartLine[];
+            discountCode: string | null;
+            discountPercent: number;
+        }>>;
+    };
+}>;
+export declare const selectCount: (s: Pick<CartState, "lines">) => number;
+export declare const selectSubtotal: (s: Pick<CartState, "lines">) => number;
+export declare const selectDiscountTotal: (s: Pick<CartState, "lines" | "discountPercent">) => number;
+export declare const selectShipping: (s: Pick<CartState, "lines">, cfg: ResolvedStorefrontConfig) => number;
+export declare const selectTotal: (s: Pick<CartState, "lines" | "discountPercent">, cfg: ResolvedStorefrontConfig) => number;
+//# sourceMappingURL=cart.store.d.ts.map

package/dist/stores/cart.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.store.d.ts","sourceRoot":"","sources":["../../src/stores/cart.store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAA;AAE3B,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,OAAO,EAAE,sBAAsB,CAAA;IAC/B,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,OAAO,CAAA;IACf,uEAAuE;IACvE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAA;IAC/E,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAClD,aAAa,IAAI,IAAI,CAAA;IACrB,KAAK,IAAI,IAAI,CAAA;IACb,UAAU,IAAI,IAAI,CAAA;IAClB,WAAW,IAAI,IAAI,CAAA;CACpB;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;EA0ExB,CAAA;AAOD,eAAO,MAAM,WAAW,GAAI,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAG,MACb,CAAA;AAE7C,eAAO,MAAM,cAAc,GAAI,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAG,MACc,CAAA;AAE3E,eAAO,MAAM,mBAAmB,GAAI,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,iBAAiB,CAAC,KAAG,MAC3B,CAAA;AAE3D,eAAO,MAAM,cAAc,GACzB,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAC3B,KAAK,wBAAwB,KAC5B,MAKF,CAAA;AAED,eAAO,MAAM,WAAW,GACtB,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,iBAAiB,CAAC,EAC/C,KAAK,wBAAwB,KAC5B,MAC8E,CAAA"}

package/dist/stores/catalog.store.d.ts

@@ -0,0 +1,18 @@
+export type CatalogSort = 'newest' | 'price-asc' | 'price-desc' | 'name';
+export interface CatalogState {
+    search: string;
+    categoryId: string | null;
+    priceMin: number | null;
+    priceMax: number | null;
+    inStockOnly: boolean;
+    sort: CatalogSort;
+    setSearch(search: string): void;
+    setCategoryId(categoryId: string | null): void;
+    setPriceMin(priceMin: number | null): void;
+    setPriceMax(priceMax: number | null): void;
+    setInStockOnly(inStockOnly: boolean): void;
+    setSort(sort: CatalogSort): void;
+    reset(): void;
+}
+export declare const useCatalogStore: import("zustand").UseBoundStore<import("zustand").StoreApi<CatalogState>>;
+//# sourceMappingURL=catalog.store.d.ts.map

package/dist/stores/catalog.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.store.d.ts","sourceRoot":"","sources":["../../src/stores/catalog.store.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,CAAA;AAExE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;IACpB,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAC9C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAC1C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAC1C,cAAc,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,CAAA;IAC1C,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;IAChC,KAAK,IAAI,IAAI,CAAA;CACd;AAWD,eAAO,MAAM,eAAe,2EASzB,CAAA"}

package/dist/stores/session.store.d.ts

@@ -0,0 +1,23 @@
+export interface SessionState {
+    customerId: string | null;
+    email: string | null;
+    name: string | null;
+    setSession(session: {
+        customerId: string;
+        email: string;
+        name?: string | null;
+    }): void;
+    signOut(): void;
+}
+export declare const useSessionStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<SessionState>, "persist"> & {
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<SessionState, SessionState>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: SessionState) => void) => () => void;
+        onFinishHydration: (fn: (state: SessionState) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<SessionState, SessionState>>;
+    };
+}>;
+//# sourceMappingURL=session.store.d.ts.map

package/dist/stores/session.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.store.d.ts","sourceRoot":"","sources":["../../src/stores/session.store.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,UAAU,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;IACtF,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,eAAO,MAAM,eAAe;;;;;;;;;;EAY3B,CAAA"}

package/dist/stores/toast.store.d.ts

@@ -0,0 +1,27 @@
+export type ToastVariant = 'success' | 'error' | 'info';
+export interface Toast {
+    id: string;
+    title: string;
+    description?: string;
+    variant: ToastVariant;
+    durationMs: number;
+}
+interface ToastState {
+    toasts: Toast[];
+    push(input: {
+        title: string;
+        description?: string;
+        variant?: ToastVariant;
+        durationMs?: number;
+    }): string;
+    dismiss(id: string): void;
+}
+export declare const useToastStore: import("zustand").UseBoundStore<import("zustand").StoreApi<ToastState>>;
+/** Imperative toast API — callable from components, store actions, or workflows. */
+export declare const toast: {
+    success: (title: string, description?: string) => string;
+    error: (title: string, description?: string) => string;
+    info: (title: string, description?: string) => string;
+};
+export {};
+//# sourceMappingURL=toast.store.d.ts.map

package/dist/stores/toast.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.store.d.ts","sourceRoot":"","sources":["../../src/stores/toast.store.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;AAEvD,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,YAAY,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,IAAI,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,YAAY,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAA;IACzG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAID,eAAO,MAAM,aAAa,yEAevB,CAAA;AAEH,oFAAoF;AACpF,eAAO,MAAM,KAAK;qBACC,MAAM,gBAAgB,MAAM;mBAC9B,MAAM,gBAAgB,MAAM;kBAC7B,MAAM,gBAAgB,MAAM;CAC3C,CAAA"}

package/dist/testids.d.ts

@@ -0,0 +1,93 @@
+export declare const TID: {
+    readonly headerSearch: "header-search";
+    readonly cartButton: "cart-button";
+    readonly cartCount: "cart-count";
+    readonly accountLink: "account-link";
+    readonly accountDropdown: "account-dropdown";
+    readonly announcementBar: "announcement-bar";
+    readonly navLink: (label: string) => string;
+    readonly navCategory: (slug: string) => string;
+    readonly accountName: "account-name";
+    readonly hero: "home-hero";
+    readonly heroPrev: "hero-prev";
+    readonly heroNext: "hero-next";
+    readonly categoryShowcase: "category-showcase";
+    readonly productRail: "product-rail";
+    readonly benefits: "benefits-row";
+    readonly promoBanner: "promo-banner";
+    readonly manifesto: "manifesto";
+    readonly testimonials: "testimonials";
+    readonly newsletter: "newsletter";
+    readonly newsletterEmail: "newsletter-email";
+    readonly newsletterSubmit: "newsletter-submit";
+    readonly newsletterDone: "newsletter-done";
+    readonly productGrid: "product-grid";
+    readonly productCard: "product-card";
+    readonly productCardName: "product-card-name";
+    readonly productCardPrice: "product-card-price";
+    readonly productCardAdd: "product-card-add";
+    readonly badgeSale: "badge-sale";
+    readonly badgeSoldout: "badge-soldout";
+    readonly filterCategory: (slug: string) => string;
+    readonly filterPriceMin: "filter-price-min";
+    readonly filterPriceMax: "filter-price-max";
+    readonly filterInstock: "filter-instock";
+    readonly sortSelect: "sort-select";
+    readonly filtersClear: "filters-clear";
+    readonly pdpName: "pdp-name";
+    readonly pdpPrice: "pdp-price";
+    readonly pdpComparePrice: "pdp-compare-price";
+    readonly pdpDescription: "pdp-description";
+    readonly productOptionGroup: (id: string) => string;
+    readonly productOptionValue: (id: string, value: string) => string;
+    readonly pdpQtyInput: "pdp-qty-input";
+    readonly pdpAddToCart: "pdp-add-to-cart";
+    readonly cartDrawer: "cart-drawer";
+    readonly cartLine: "cart-line";
+    readonly lineQty: "line-qty";
+    readonly lineInc: "line-inc";
+    readonly lineDec: "line-dec";
+    readonly lineRemove: "line-remove";
+    readonly cartSubtotal: "cart-subtotal";
+    readonly discountInput: "discount-input";
+    readonly discountApply: "discount-apply";
+    readonly discountRow: "discount-row";
+    readonly discountError: "discount-error";
+    readonly cartShipping: "cart-shipping";
+    readonly shippingProgress: "shipping-progress";
+    readonly cartTotal: "cart-total";
+    readonly goCheckout: "go-checkout";
+    readonly cartEmpty: "cart-empty";
+    readonly checkoutEmail: "checkout-email";
+    readonly checkoutName: "checkout-name";
+    readonly checkoutStreet: "checkout-street";
+    readonly checkoutCity: "checkout-city";
+    readonly checkoutZip: "checkout-zip";
+    readonly checkoutCard: "checkout-card";
+    readonly checkoutExpiry: "checkout-expiry";
+    readonly checkoutCvc: "checkout-cvc";
+    readonly placeOrder: "place-order";
+    readonly checkoutError: "checkout-error";
+    readonly checkoutProcessing: "checkout-processing";
+    readonly orderNumber: "order-number";
+    readonly orderStatus: "order-status";
+    readonly orderTracking: "order-tracking";
+    readonly orderTrackingStep: (step: string) => string;
+    readonly orderTotal: "order-total";
+    readonly viewPurchases: "view-purchases";
+    readonly customerAccountShell: "customer-account-shell";
+    readonly customerAccountMenu: "customer-account-menu";
+    readonly orderDetail: "order-detail";
+    readonly authTabSignin: "auth-tab-signin";
+    readonly authTabSignup: "auth-tab-signup";
+    readonly signinEmail: "signin-email";
+    readonly signinPassword: "signin-password";
+    readonly signinName: "signin-name";
+    readonly signinSubmit: "signin-submit";
+    readonly authError: "auth-error";
+    readonly purchasesList: "purchases-list";
+    readonly purchaseItem: "purchase-item";
+    readonly purchasesEmpty: "purchases-empty";
+    readonly signout: "signout";
+};
+//# sourceMappingURL=testids.d.ts.map

package/dist/testids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testids.d.ts","sourceRoot":"","sources":["../src/testids.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG;;;;;;;8BAQG,MAAM;iCACH,MAAM;;;;;;;;;;;;;;;;;;;;;;oCAyBH,MAAM;;;;;;;;;;sCAWJ,MAAM;sCACN,MAAM,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAoCpB,MAAM;;;;;;;;;;;;;;;;;CAkBxB,CAAA"}

package/dist/theme.d.ts

@@ -0,0 +1,59 @@
+import React from 'react';
+export type StorefrontRadius = 'none' | 'soft' | 'round' | 'pill';
+export type HeaderVariant = 'classic' | 'centered' | 'search' | 'minimal';
+export type HeroVariant = 'banner' | 'split' | 'slider';
+export type CardStyle = 'card' | 'editorial';
+export interface StorefrontThemeColors {
+    /** HSL triplets, e.g. '40 20% 94%' — same convention as SaasTheme */
+    background?: string;
+    foreground?: string;
+    primary?: string;
+    primaryForeground?: string;
+    card?: string;
+    cardForeground?: string;
+    muted?: string;
+    mutedForeground?: string;
+    border?: string;
+    /** Header treatment — dark headers (Brasília) set these */
+    headerBackground?: string;
+    headerForeground?: string;
+    /** Announcement bar */
+    announcementBackground?: string;
+    announcementForeground?: string;
+}
+export interface StorefrontThemeFont {
+    /** Display font for headings, e.g. 'Marcellus' */
+    heading: string;
+    /** Body font, e.g. 'Rubik' */
+    body: string;
+    /** Google Fonts families to load (defaults to heading+body) */
+    googleFonts?: string[];
+    /** Fallback stack — default sans-serif; use 'serif' for editorial themes */
+    fallback?: 'sans-serif' | 'serif';
+}
+export interface StorefrontTheme {
+    name: string;
+    colors?: StorefrontThemeColors;
+    font?: StorefrontThemeFont;
+    radius?: StorefrontRadius;
+    /** Layout personality */
+    header?: {
+        variant?: HeaderVariant;
+        /** Uppercase nav links (premium retail tone) */
+        uppercaseNav?: boolean;
+    };
+    productCard?: {
+        style?: CardStyle;
+        imageAspect?: 'square' | 'portrait';
+    };
+    /** Uppercase CTA buttons with letter-spacing (Uyuni/Flex tone) */
+    uppercaseButtons?: boolean;
+}
+export declare function themeToCss(theme: StorefrontTheme): string;
+/** Injects theme CSS variables + Google Fonts. Mount once inside the app root. */
+export declare function StorefrontThemeStyle({ theme }: {
+    theme: StorefrontTheme;
+}): React.ReactElement<{
+    'data-sf-theme': string;
+}, string | React.JSXElementConstructor<any>>;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAA;AAaxC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AACjE,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAA;AACzE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;AACvD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,WAAW,CAAA;AAE5C,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,uBAAuB;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAA;IACf,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAC9B,IAAI,CAAC,EAAE,mBAAmB,CAAA;IAC1B,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,yBAAyB;IACzB,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,aAAa,CAAA;QACvB,gDAAgD;QAChD,YAAY,CAAC,EAAE,OAAO,CAAA;KACvB,CAAA;IACD,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,SAAS,CAAA;QACjB,WAAW,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;KACpC,CAAA;IACD,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAyBD,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAuCzD;AAYD,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,eAAe,CAAA;CAAE;;8CAiBzE"}

package/dist/workflows/checkout.d.ts

@@ -0,0 +1,33 @@
+import type { Order } from '@fayz-ai/shop/types';
+import type { ResolvedStorefrontConfig } from '../config';
+import type { CartState } from '../stores/cart.store';
+import type { SessionState } from '../stores/session.store';
+export interface StorefrontCheckoutCustomer {
+    email: string;
+    name: string;
+}
+export interface StorefrontCheckoutAddress {
+    street?: string;
+    city?: string;
+    zip?: string;
+    notes?: string;
+}
+export interface PlaceStorefrontOrderInput {
+    config: ResolvedStorefrontConfig;
+    cart: Pick<CartState, 'lines' | 'discountCode' | 'discountPercent'>;
+    session?: Pick<SessionState, 'customerId' | 'email'>;
+    customer: StorefrontCheckoutCustomer;
+    address?: StorefrontCheckoutAddress;
+    markPaid?: boolean;
+}
+export interface PlaceStorefrontOrderResult {
+    order: Order;
+    customerId: string;
+}
+/**
+ * Storefront checkout primitive for custom/generated checkout screens.
+ * It owns the order payload math and customer-session handshake so app-owned
+ * routes can customize UX without copying provider/business logic.
+ */
+export declare function placeStorefrontOrder({ config, cart, session, customer, address, markPaid, }: PlaceStorefrontOrderInput): Promise<PlaceStorefrontOrderResult>;
+//# sourceMappingURL=checkout.d.ts.map

package/dist/workflows/checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/workflows/checkout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEhD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,wBAAwB,CAAA;IAChC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,cAAc,GAAG,iBAAiB,CAAC,CAAA;IACnE,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,CAAA;IACpD,QAAQ,EAAE,0BAA0B,CAAA;IACpC,OAAO,CAAC,EAAE,yBAAyB,CAAA;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,KAAK,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB;AAaD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,EACzC,MAAM,EACN,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAgB,GACjB,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAiCjE"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@fayz-ai/storefront",
+  "version": "0.2.0",
+  "description": "Fayz SDK storefront kit — Shopify-style customer-facing ecommerce template components",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@supabase/supabase-js": "^2.45.0",
+    "lucide-react": "^0.400.0",
+    "zustand": "^4.5.0",
+    "@fayz-ai/shop": "^0.2.0",
+    "@fayz-ai/core": "^0.2.0",
+    "@fayz-ai/auth": "^0.2.0",
+    "@fayz-ai/ui": "^0.2.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "react": "^18.3.0",
+    "tsup": "^8.2.0",
+    "typescript": "^5.5.0"
+  },
+  "keywords": [
+    "fayz",
+    "storefront",
+    "ecommerce",
+    "template"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationMap --noEmit false",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/src/auth.ts

@@ -0,0 +1,134 @@
+import type { AuthAdapter, AuthUser } from '@fayz-ai/core'
+import { createMockAuthAdapter } from '@fayz-ai/auth'
+import { getShopProvider } from '@fayz-ai/shop/runtime'
+import { useSessionStore } from './stores/session.store'
+
+// ---------------------------------------------------------------------------
+// Customer auth — the SAME AuthAdapter contract createSaasApp uses, so the
+// mock and Supabase adapters from @fayz-ai/auth serve both the saas admin and
+// the storefront customer. The storefront adds one layer on top: linking the
+// auth identity to a ShopCustomer record (find-or-create by email) so orders
+// and purchase history attach to a customer.
+// ---------------------------------------------------------------------------
+
+export type StorefrontAuthAdapter = AuthAdapter | 'mock' | 'supabase'
+
+let _adapter: AuthAdapter | null = null
+
+export function resolveAuthAdapter(
+  configured: StorefrontAuthAdapter | undefined,
+): AuthAdapter {
+  if (configured && configured !== 'mock' && configured !== 'supabase') return configured
+  if (configured === 'supabase') {
+    console.warn(
+      '@fayz-ai/shop: auth.adapter="supabase" is legacy. Pass an explicit AuthAdapter or use the Fayz SDK broker path.',
+    )
+  }
+  return createMockAuthAdapter()
+}
+
+/** Called once by createStorefrontApp. Restores any persisted session. */
+export function initCustomerAuth(adapter: AuthAdapter): void {
+  _adapter = adapter
+  adapter
+    .getSession()
+    .then((existing) => {
+      if (!existing) return
+      const store = useSessionStore.getState()
+      // Re-link only when the persisted shop session doesn't match the auth user
+      if (store.email !== existing.user.email) {
+        void linkCustomer(existing.user)
+      }
+    })
+    .catch(() => {})
+  adapter.onAuthStateChange((user) => {
+    if (!user) useSessionStore.getState().signOut()
+  })
+}
+
+export function getCustomerAuthAdapter(): AuthAdapter {
+  if (!_adapter) _adapter = createMockAuthAdapter()
+  return _adapter
+}
+
+/** Resolve (find-or-create + server-side auth link) the ShopCustomer for an email. */
+async function resolveShopCustomer(email: string, name: string) {
+  const provider = getShopProvider()
+  // Preferred: provider.resolveCustomer find-or-creates AND links auth.uid
+  // server-side (RLS-safe). Falls back to generic CRUD for legacy providers.
+  if (provider.resolveCustomer) return provider.resolveCustomer({ email, name })
+  const matches = await provider.listCustomers({ search: email, limit: 10 })
+  const existing = matches.find((c) => (c.email ?? '').toLowerCase() === email)
+  if (existing) return existing
+  const parts = name.trim().split(/\s+/).filter(Boolean)
+  return provider.createCustomer({
+    firstName: parts[0] ?? email.split('@')[0] ?? 'Cliente',
+    lastName: parts.slice(1).join(' '),
+    email,
+  })
+}
+
+/** Find-or-create the ShopCustomer for an auth identity and persist the session. */
+async function linkCustomer(user: AuthUser, fullName?: string): Promise<{ customerId: string }> {
+  const email = (user.email ?? '').trim().toLowerCase()
+  const name = fullName ?? user.fullName ?? ''
+  const customer = await resolveShopCustomer(email, name)
+  useSessionStore.getState().setSession({
+    customerId: customer.id,
+    email,
+    name: name || `${customer.firstName} ${customer.lastName}`.trim(),
+  })
+  return { customerId: customer.id }
+}
+
+export interface EstablishSessionOptions {
+  /** Provided → adapter.signIn; omitted → passwordless customer identity via signUp (mock-friendly). */
+  password?: string
+  name?: string
+}
+
+/**
+ * Sign a customer in through the auth adapter and link the ShopCustomer.
+ * Used by the account page sign-in AND by checkout (so a buyer is signed in
+ * for "my purchases" immediately after purchase) — one auth path, two doors.
+ */
+export async function establishCustomerSession(
+  email: string,
+  opts?: EstablishSessionOptions,
+): Promise<{ customerId: string }> {
+  const normalized = email.trim().toLowerCase()
+  if (opts?.password) {
+    const adapter = getCustomerAuthAdapter()
+    const session = await adapter.signIn(normalized, opts.password)
+    return linkCustomer(session.user.email ? session.user : { ...session.user, email: normalized }, opts.name)
+  }
+  // Guest / passwordless checkout: do NOT create an auth account (that made
+  // returning guests fail with "user already registered" on Supabase). Just
+  // resolve the ShopCustomer and persist the local session for order history.
+  return linkCustomer({ id: '', email: normalized } as AuthUser, opts?.name)
+}
+
+/** Convenience wrapper — passwordless email sign-in (guest checkout path). */
+export function signInByEmail(email: string, name?: string): Promise<{ customerId: string }> {
+  return establishCustomerSession(email, { name })
+}
+
+/** Explicit account creation (account page "Criar conta" form). */
+export async function signUpCustomer(
+  email: string,
+  password: string,
+  name: string,
+): Promise<{ customerId: string }> {
+  const adapter = getCustomerAuthAdapter()
+  const normalized = email.trim().toLowerCase()
+  const session = await adapter.signUp(normalized, password, name)
+  return linkCustomer(session.user.email ? session.user : { ...session.user, email: normalized }, name)
+}
+
+export async function signOutCustomer(): Promise<void> {
+  try {
+    await getCustomerAuthAdapter().signOut()
+  } finally {
+    useSessionStore.getState().signOut()
+  }
+}

package/src/blocks.tsx

@@ -0,0 +1,47 @@
+import { registerBlock } from '@fayz-ai/core'
+import type { BlockNode } from '@fayz-ai/core'
+import type { HomeSection } from './sections'
+import { HeroSection } from './components/sections/HeroSection'
+import { CategoryShowcase } from './components/sections/CategoryShowcase'
+import { ProductRail } from './components/sections/ProductRail'
+import {
+  BenefitsRow,
+  PromoBanner,
+  ManifestoBlock,
+  Testimonials,
+  NewsletterBand,
+} from './components/sections/MiscSections'
+
+// ---------------------------------------------------------------------------
+// Storefront blocks — the section components registered into the universal
+// block registry. This replaces HomePage's hardcoded switch: a home page is now
+// a block tree (`{ type, props }[]`) resolved through the registry, identical
+// to how admin pages will compose. Section prop shapes are unchanged, so the
+// components are registered directly.
+// ---------------------------------------------------------------------------
+
+let registered = false
+
+export function registerStorefrontBlocks(): void {
+  if (registered) return
+  registered = true
+  registerBlock('hero', HeroSection, { source: 'sdk', label: 'Hero' })
+  registerBlock('categories', CategoryShowcase, { source: 'sdk', label: 'Categories' })
+  registerBlock('products', ProductRail, { source: 'sdk', label: 'Product rail' })
+  registerBlock('benefits', BenefitsRow, { source: 'sdk', label: 'Benefits row' })
+  registerBlock('banner', PromoBanner, { source: 'sdk', label: 'Promo banner' })
+  registerBlock('manifesto', ManifestoBlock, { source: 'sdk', label: 'Manifesto' })
+  registerBlock('testimonials', Testimonials, { source: 'sdk', label: 'Testimonials' })
+  registerBlock('newsletter', NewsletterBand, { source: 'sdk', label: 'Newsletter band' })
+}
+
+// Register on import so any consumer of the storefront package has the blocks.
+registerStorefrontBlocks()
+
+/** Convert the legacy HomeSection[] blueprint into a generic block tree. */
+export function sectionsToBlocks(sections: HomeSection[]): BlockNode[] {
+  return sections.map((section, i) => {
+    const { type, ...props } = section
+    return { type, id: `${type}-${i}`, props: props as Record<string, unknown> }
+  })
+}