@fayz-ai/storefront 0.7.0 → 0.8.2

package/dist/pages/CheckoutPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CheckoutPage.d.ts","sourceRoot":"","sources":["../../src/pages/CheckoutPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAgGlD,wBAAgB,YAAY,sBAke3B"}
+{"version":3,"file":"CheckoutPage.d.ts","sourceRoot":"","sources":["../../src/pages/CheckoutPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AA0GlD,wBAAgB,YAAY,sBAkkB3B"}

package/dist/pages/ProductDetailPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProductDetailPage.d.ts","sourceRoot":"","sources":["../../src/pages/ProductDetailPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAmBlD,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,qBAgP3D"}
+{"version":3,"file":"ProductDetailPage.d.ts","sourceRoot":"","sources":["../../src/pages/ProductDetailPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAqBlD,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,qBAkP3D"}

package/dist/presets.d.ts

@@ -23,11 +23,16 @@ export declare const sertaoTemplate: StorefrontTemplate;
 export declare const voltTemplate: StorefrontTemplate;
 /** atelier — classic premium retail (Flex): white, near-black, gold accent, slider hero, trust badges. */
 export declare const atelierTemplate: StorefrontTemplate;
+/** food — warm appetizing delivery (steakhouse / burger / comfort food): dark inviting
+ *  header, ember CTA, cream canvas, rounded cards, menu-first home with "mais pedidos"
+ *  rail and social proof. Built for restaurant/food stores — override to go fully dark. */
+export declare const foodTemplate: StorefrontTemplate;
 export declare const storefrontTemplates: {
     readonly mare: StorefrontTemplate;
     readonly sertao: StorefrontTemplate;
     readonly volt: StorefrontTemplate;
     readonly atelier: StorefrontTemplate;
+    readonly food: StorefrontTemplate;
 };
 export type StorefrontTemplateId = keyof typeof storefrontTemplates;
 //# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAS5C;qFACqF;AACrF,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,eAAe,CAAA;IACtB,0EAA0E;IAC1E,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,KAAK,UAAU,CAAA;IAChE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,yFAAyF;AACzF,eAAO,MAAM,YAAY,EAAE,kBA0C1B,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,cAAc,EAAE,kBA2D5B,CAAA;AAED,kHAAkH;AAClH,eAAO,MAAM,YAAY,EAAE,kBAkD1B,CAAA;AAED,0GAA0G;AAC1G,eAAO,MAAM,eAAe,EAAE,kBA4D7B,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAA;AAEV,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,mBAAmB,CAAA"}
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAS5C;qFACqF;AACrF,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAChC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,eAAe,CAAA;IACtB,0EAA0E;IAC1E,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,KAAK,UAAU,CAAA;IAChE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,yFAAyF;AACzF,eAAO,MAAM,YAAY,EAAE,kBA0C1B,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,cAAc,EAAE,kBA2D5B,CAAA;AAED,kHAAkH;AAClH,eAAO,MAAM,YAAY,EAAE,kBAkD1B,CAAA;AAED,0GAA0G;AAC1G,eAAO,MAAM,eAAe,EAAE,kBA4D7B,CAAA;AAED;;2FAE2F;AAC3F,eAAO,MAAM,YAAY,EAAE,kBA4D1B,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;;;CAMtB,CAAA;AAEV,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,mBAAmB,CAAA"}

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

@@ -30,6 +30,11 @@ export interface CartState {
     clear(): void;
     openDrawer(): void;
     closeDrawer(): void;
+    /** Drop persisted lines the active backend can no longer resolve (e.g. a cart
+     *  built in an earlier mock-mode session, whose ids don't exist live). The
+     *  resolver returns false only for a definitive "not found"; on error it must
+     *  return true so a transient failure never discards a legit line. */
+    reconcile(resolve: (line: CartLine) => Promise<boolean>): Promise<void>;
 }
 export declare const useCartStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<CartState>, "persist"> & {
     persist: {
@@ -53,6 +58,22 @@ export declare const useCartStore: import("zustand").UseBoundStore<Omit<import("
 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;
+/**
+ * Freight to display.
+ *
+ * When the shopper has given a CEP and the store quoted it, that quote wins —
+ * it came from the same shipping_zones rows shop_place_order will charge from.
+ * Otherwise this falls back to the store-wide rate in config, which is what
+ * every storefront did before zones existed.
+ *
+ * The subtotal is PRE-discount on both sides of this. That is 0017's rule, and
+ * the quote is requested against the same number, so a coupon can never make
+ * the cart and the order disagree.
+ *
+ * Read through getState() rather than a hook because this is a plain selector
+ * called from several screens; components that render the value subscribe to
+ * useDeliveryStore themselves so a fresh quote re-renders them.
+ */
 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

@@ -1 +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"}
+{"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;AAEzD,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;IACnB;;;0EAGsE;IACtE,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxE;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;EAoFxB,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;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc,GACzB,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAC3B,KAAK,wBAAwB,KAC5B,MASF,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/delivery.store.d.ts

@@ -0,0 +1,64 @@
+import { type PostalAddress } from '@fayz-ai/core';
+import type { ShippingQuoteOption } from '@fayz-ai/shop/types';
+/**
+ * Where the shopper wants it delivered, decided before the cart exists.
+ *
+ * Two different things live here and they are persisted differently on purpose:
+ *
+ *   the ADDRESS is durable — a CEP maps to the same street for years, and
+ *   carrying it to checkout is the whole point (the buyer types the number and
+ *   nothing else);
+ *
+ *   the QUOTE is not persisted at all. It is a price, and a price restored from
+ *   localStorage is a price the shopper can edit with devtools. It is re-asked
+ *   on demand, and resolved for the current cart through resolveOptionRate —
+ *   the same rule shop_shipping_for applies — so it can never go stale. The
+ *   order is charged from shop_place_order, which recomputes from the same
+ *   zones and ignores anything the client sends.
+ */
+export type DeliveryStatus = 'idle' | 'loading' | 'served' | 'unserved' | 'error';
+export interface DeliveryState {
+    postalCode: string;
+    address: PostalAddress | null;
+    options: ShippingQuoteOption[];
+    selectedZoneId: string | null;
+    status: DeliveryStatus;
+    error: string | null;
+    /** Look the CEP up and quote it. `subtotal` decides free-above thresholds. */
+    resolve: (postalCode: string, subtotal: number) => Promise<void>;
+    selectZone: (zoneId: string) => void;
+    clear: () => void;
+}
+export declare const useDeliveryStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<DeliveryState>, "persist"> & {
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<DeliveryState, {
+            postalCode: string;
+            address: PostalAddress | null;
+        }>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: DeliveryState) => void) => () => void;
+        onFinishHydration: (fn: (state: DeliveryState) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<DeliveryState, {
+            postalCode: string;
+            address: PostalAddress | null;
+        }>>;
+    };
+}>;
+/**
+ * The freight for the chosen zone at THIS subtotal, or null when there is no
+ * zone in play (no CEP yet, or a store that configured none) and the caller
+ * should use the store-wide rate. Null never means free.
+ *
+ * The free-above rule is applied here rather than trusting the `rate` the
+ * server resolved, because that one was resolved for whatever the cart held at
+ * quote time. Re-deriving from `baseRate`/`freeAbove` — the same CASE
+ * shop_shipping_for runs — means adding an item can never leave a stale price
+ * on screen. An earlier version fell back to the config flat rate when the
+ * quote went stale, which showed R$ 8 (the flat rate) for an address in an
+ * R$ 18 zone: shown one number, charged another.
+ */
+export declare function resolveOptionRate(option: ShippingQuoteOption, subtotal: number): number;
+export declare const selectQuotedShipping: (state: Pick<DeliveryState, "options" | "selectedZoneId" | "status">, subtotal: number) => number | null;
+//# sourceMappingURL=delivery.store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.store.d.ts","sourceRoot":"","sources":["../../src/stores/delivery.store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAEzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE9D;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAA;AAEjF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;IAC7B,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,MAAM,EAAE,cAAc,CAAA;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpB,8EAA8E;IAC9E,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAWD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;EA4E5B,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvF;AAED,eAAO,MAAM,oBAAoB,GAC/B,OAAO,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,gBAAgB,GAAG,QAAQ,CAAC,EACnE,UAAU,MAAM,KACf,MAAM,GAAG,IAIX,CAAA"}

package/dist/testids.d.ts

@@ -1,5 +1,6 @@
 export declare const TID: {
     readonly headerSearch: "header-search";
+    readonly headerSearchToggle: "header-search-toggle";
     readonly cartButton: "cart-button";
     readonly cartCount: "cart-count";
     readonly accountLink: "account-link";
@@ -51,6 +52,9 @@ export declare const TID: {
     readonly pdpAddToCart: "pdp-add-to-cart";
     readonly pdpRoot: "pdp-root";
     readonly pdpGallery: "pdp-gallery";
+    readonly pdpGalleryImage: "pdp-gallery-image";
+    readonly pdpGalleryThumbs: "pdp-gallery-thumbs";
+    readonly pdpGalleryThumb: "pdp-gallery-thumb";
     readonly pdpActions: "pdp-actions";
     readonly pdpEnquiryButton: "pdp-enquiry-button";
     readonly enquiryForm: "enquiry-form";
@@ -78,6 +82,14 @@ export declare const TID: {
     readonly cartTotal: "cart-total";
     readonly goCheckout: "go-checkout";
     readonly cartEmpty: "cart-empty";
+    readonly deliveryEstimator: "delivery-estimator";
+    readonly deliveryCepInput: "delivery-cep-input";
+    readonly deliveryCepSubmit: "delivery-cep-submit";
+    readonly deliveryOption: "delivery-option";
+    readonly deliveryUnserved: "delivery-unserved";
+    readonly deliveryError: "delivery-error";
+    readonly deliveryAddress: "delivery-address";
+    readonly deliveryClear: "delivery-clear";
     readonly checkoutEmail: "checkout-email";
     readonly checkoutName: "checkout-name";
     readonly checkoutStreet: "checkout-street";

package/dist/testids.d.ts.map

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

package/dist/theme.d.ts

@@ -20,13 +20,21 @@ export interface StorefrontThemeColors {
     /** Announcement bar */
     announcementBackground?: string;
     announcementForeground?: string;
+    /** Secondary brand accent (e.g. a gourmet gold beside the primary). Emitted
+     *  as `--sf-accent` / `--sf-accent-foreground` and the `accent` tailwind token. */
+    accent?: string;
+    accentForeground?: 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) */
+    /** Optional oversized display face for hero words (emitted as `--sf-font-display`). */
+    display?: string;
+    /** Optional serif accent for quotes/editorial (emitted as `--sf-font-serif`). */
+    serif?: string;
+    /** Google Fonts families to load (defaults to heading+body+display+serif) */
     googleFonts?: string[];
     /** Fallback stack — default sans-serif; use 'serif' for editorial themes */
     fallback?: 'sans-serif' | 'serif';
@@ -43,8 +51,11 @@ export interface StorefrontTheme {
         uppercaseNav?: boolean;
         /** Show category shortcuts after primary nav links. Default true. */
         showCategories?: boolean;
-        /** Show the storefront search input in the header. Default true. */
+        /** Show the storefront search in the header. Default true. */
         showSearch?: boolean;
+        /** Header search presentation: a full input ('full', default) or a compact
+         *  icon button that expands into an input on click ('icon'). */
+        searchStyle?: 'full' | 'icon';
     };
     productCard?: {
         style?: CardStyle;
@@ -52,6 +63,11 @@ export interface StorefrontTheme {
     };
     /** Uppercase CTA buttons with letter-spacing (Uyuni/Flex tone) */
     uppercaseButtons?: boolean;
+    /** Brand-token passthrough. Each entry is emitted verbatim as a `--<key>` CSS
+     *  custom property, so a store can add gradients, glows, extra colors, or
+     *  letter-spacing the fixed schema doesn't enumerate — without editing the SDK.
+     *  e.g. { 'grad-ember': 'linear-gradient(...)', 'glow-ember': '0 0 0 1px ...' }. */
+    tokens?: Record<string, string>;
 }
 export declare function themeToCss(theme: StorefrontTheme): string;
 /** Injects theme CSS variables + Google Fonts. Mount once inside the app root. */

package/dist/theme.d.ts.map

@@ -1 +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;QACtB,qEAAqE;QACrE,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,oEAAoE;QACpE,UAAU,CAAC,EAAE,OAAO,CAAA;KACrB,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"}
+{"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;IAC/B;uFACmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAA;IACf,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6EAA6E;IAC7E,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;QACtB,qEAAqE;QACrE,cAAc,CAAC,EAAE,OAAO,CAAA;QACxB,8DAA8D;QAC9D,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB;wEACgE;QAChE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAC9B,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;IAC1B;;;wFAGoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AA2BD,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA+CzD;AAgBD,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,eAAe,CAAA;CAAE;;8CAiBzE"}

package/dist/workflows/checkout.d.ts

@@ -1,4 +1,4 @@
-import type { Order } from '@fayz-ai/shop/types';
+import type { Order, ShippingAddressInput, PaymentMethodKind } from '@fayz-ai/shop/types';
 import type { ResolvedStorefrontConfig } from '../config';
 import type { CartState } from '../stores/cart.store';
 import type { SessionState } from '../stores/session.store';
@@ -18,6 +18,9 @@ export interface PlaceStorefrontOrderInput {
     session?: Pick<SessionState, 'customerId' | 'email'>;
     customer: StorefrontCheckoutCustomer;
     address?: StorefrontCheckoutAddress;
+    /** Structured address; without it the order keeps only the free-text note. */
+    shippingAddress?: ShippingAddressInput;
+    paymentMethod?: PaymentMethodKind;
     markPaid?: boolean;
 }
 export interface PlaceStorefrontOrderResult {
@@ -29,5 +32,5 @@ export interface PlaceStorefrontOrderResult {
  * 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>;
+export declare function placeStorefrontOrder({ config, cart, session, customer, address, shippingAddress, paymentMethod, markPaid, }: PlaceStorefrontOrderInput): Promise<PlaceStorefrontOrderResult>;
 //# sourceMappingURL=checkout.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/workflows/checkout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEzF,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,8EAA8E;IAC9E,eAAe,CAAC,EAAE,oBAAoB,CAAA;IACtC,aAAa,CAAC,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,KAAK,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB;AA4BD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,EACzC,MAAM,EACN,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,OAAO,EACP,eAAe,EACf,aAAa,EACb,QAAgB,GACjB,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAyCjE"}

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "@fayz-ai/storefront",
-  "version": "0.7.0",
+  "fayz": {
+    "status": "beta"
+  },
+  "version": "0.8.2",
   "description": "Fayz SDK storefront kit — Shopify-style customer-facing ecommerce template components",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -40,12 +43,12 @@
     "@supabase/supabase-js": "^2.45.0",
     "lucide-react": "^0.400.0",
     "zustand": "^4.5.0",
-    "@fayz-ai/core": "^0.6.6",
-    "@fayz-ai/plugin-auth": "^0.1.2",
-    "@fayz-ai/shop": "^0.7.0",
-    "@fayz-ai/ui": "^0.6.6",
-    "@fayz-ai/sdk": "^0.6.6",
-    "@fayz-ai/auth": "^0.6.6"
+    "@fayz-ai/auth": "^0.8.2",
+    "@fayz-ai/core": "^0.8.2",
+    "@fayz-ai/plugin-auth": "^0.8.0",
+    "@fayz-ai/shop": "^0.8.2",
+    "@fayz-ai/sdk": "^0.8.2",
+    "@fayz-ai/ui": "^0.8.1"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -64,6 +67,9 @@
     "template"
   ],
   "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationMap --noEmit false",
     "dev": "tsup --watch",

package/src/auth.ts

@@ -5,6 +5,7 @@ import {
   type AuthPluginOptions,
 } from '@fayz-ai/plugin-auth'
 import { getShopProvider } from '@fayz-ai/shop/runtime'
+import { setShopAccessTokenResolver } from '@fayz-ai/sdk/shop'
 import { useSessionStore } from './stores/session.store'
 
 // ---------------------------------------------------------------------------
@@ -64,13 +65,41 @@ export function resolveAuthAdapter(
   }).adapter
 }
 
+// The shopper's current access token, handed to the shop REST client so its
+// requests reach PostgREST as the signed-in user instead of as `anon`. Held
+// here rather than in the session store because it is a credential: it must not
+// be persisted to localStorage alongside the customer id. The Supabase client
+// owns its own refresh; this is only a mirror of the live value.
+let _accessToken: string | null = null
+
+/** Whether an authenticated identity was ever seen this session. Distinguishes
+ *  "signed out" from "was never signed in" — see the onAuthStateChange guard. */
+let _hadAuthUser = false
+
+/** Refresh the mirrored token from the adapter. Safe to call on any event. */
+async function syncAccessToken(adapter: AuthAdapter): Promise<void> {
+  try {
+    const existing = await adapter.getSession()
+    _accessToken = existing?.session.accessToken ?? null
+  } catch {
+    _accessToken = null
+  }
+}
+
 /** Called once by createStorefrontApp. Restores any persisted session. */
 export function initCustomerAuth(adapter: AuthAdapter): void {
   _adapter = adapter
+
+  // Registered before the first await so no request can slip out anonymously
+  // while the session is still being restored.
+  setShopAccessTokenResolver(() => _accessToken)
+
   adapter
     .getSession()
     .then((existing) => {
+      _accessToken = existing?.session.accessToken ?? null
       if (!existing) return
+      _hadAuthUser = true
       const store = useSessionStore.getState()
       // Re-link only when the persisted shop session doesn't match the auth user
       if (store.email !== existing.user.email) {
@@ -78,8 +107,26 @@ export function initCustomerAuth(adapter: AuthAdapter): void {
       }
     })
     .catch(() => {})
+
   adapter.onAuthStateChange((user) => {
-    if (!user) useSessionStore.getState().signOut()
+    if (!user) {
+      _accessToken = null
+      // Only tear down the shop session if there WAS an authenticated identity
+      // to lose. The Supabase adapter fires this once on boot with a null user
+      // (INITIAL_SESSION), and clearing unconditionally wiped the guest's local
+      // session on every page load — a guest who checked out could no longer
+      // find their order after a reload. The mock adapter never surfaced this
+      // because it always restored a session.
+      if (_hadAuthUser) {
+        _hadAuthUser = false
+        useSessionStore.getState().signOut()
+      }
+      return
+    }
+    _hadAuthUser = true
+    // Covers token refresh too, not just sign-in: the callback carries the user
+    // but not the token, and a stale token would 401 every read an hour in.
+    void syncAccessToken(adapter)
   })
 }
 
@@ -137,6 +184,11 @@ export async function establishCustomerSession(
   if (opts?.password) {
     const adapter = getCustomerAuthAdapter()
     const session = await adapter.signIn(normalized, opts.password)
+    // Before linkCustomer, not after: linkCustomer calls shop_resolve_customer,
+    // which reads auth.uid() to fill auth_user_id. Sent with the old token that
+    // link silently no-ops and the account stays unlinked forever.
+    _accessToken = session.accessToken ?? null
+    _hadAuthUser = true
     return linkCustomer(session.user.email ? session.user : { ...session.user, email: normalized }, opts.name)
   }
   // Guest / passwordless checkout: do NOT create an auth account (that made
@@ -159,6 +211,8 @@ export async function signUpCustomer(
   const adapter = getCustomerAuthAdapter()
   const normalized = email.trim().toLowerCase()
   const session = await adapter.signUp(normalized, password, name)
+  _accessToken = session.accessToken ?? null
+  _hadAuthUser = true
   return linkCustomer(session.user.email ? session.user : { ...session.user, email: normalized }, name)
 }
 
@@ -166,6 +220,8 @@ export async function signOutCustomer(): Promise<void> {
   try {
     await getCustomerAuthAdapter().signOut()
   } finally {
+    _accessToken = null
+    _hadAuthUser = false
     useSessionStore.getState().signOut()
   }
 }

package/src/components/CartDrawer.tsx

@@ -13,6 +13,9 @@ import { useStorefrontConfig } from '../config'
 import { navigateTo } from '../router'
 import { formatMoney } from '../format'
 import { QuantityInput } from './QuantityInput'
+import { formatPostalCode } from '@fayz-ai/core'
+import { useDeliveryStore } from '../stores/delivery.store'
+import { DeliveryEstimator } from './DeliveryEstimator'
 import { TID } from '../testids'
 import { SmoothImage } from './SmoothImage'
 
@@ -34,9 +37,15 @@ export function CartDrawer() {
     return () => document.removeEventListener('keydown', onKey)
   }, [cart.isOpen, cart.closeDrawer])
 
+  // Subscribed, not just read: selectShipping consults this store through
+  // getState(), which does not subscribe, so without this hook a fresh quote
+  // would change the price and leave the drawer showing the old one.
+  const delivery = useDeliveryStore()
+
   const subtotal = selectSubtotal(cart)
   const discountTotal = selectDiscountTotal(cart)
   const shipping = selectShipping(cart, config)
+
   const total = selectTotal(cart, config)
   const money = (v: number) => formatMoney(v, config.currency, config.locale)
 
@@ -198,6 +207,12 @@ export function CartDrawer() {
                 </div>
               )}
 
+              {/* Second chance to give a CEP for anyone who added to cart from
+                  the catalogue and never opened a product page. */}
+              <div className="mb-3">
+                <DeliveryEstimator compact />
+              </div>
+
               <dl className="space-y-1.5 text-sm">
                 <div className="flex justify-between">
                   <dt className="text-muted-foreground">Subtotal</dt>
@@ -219,7 +234,14 @@ export function CartDrawer() {
                   </div>
                 )}
                 <div className="flex justify-between">
-                  <dt className="text-muted-foreground">Frete</dt>
+                  <dt className="text-muted-foreground">
+                    Frete
+                    {delivery.status === 'served' && delivery.postalCode && (
+                      <span className="ml-1 text-xs">
+                        · {formatPostalCode(delivery.postalCode)}
+                      </span>
+                    )}
+                  </dt>
                   <dd data-testid={TID.cartShipping} data-price={shipping.toFixed(2)}>
                     {shipping === 0 ? 'Grátis' : money(shipping)}
                   </dd>

package/src/components/DeliveryEstimator.tsx

@@ -0,0 +1,157 @@
+import React, { useState } from 'react'
+import { MapPin, Truck } from 'lucide-react'
+import { formatPostalCode } from '@fayz-ai/core'
+import { useDeliveryStore, resolveOptionRate } from '../stores/delivery.store'
+import { useCartStore, selectSubtotal } from '../stores/cart.store'
+import { useStorefrontConfig } from '../config'
+import { formatMoney } from '../format'
+import { TID } from '../testids'
+
+/**
+ * "Do you deliver to me, for how much, and when" — asked on the product page,
+ * before the shopper has invested anything in a cart.
+ *
+ * The CEP is kept in the delivery store, so the answer follows them to the cart
+ * and lands at checkout with street/district/city/UF already filled. That is
+ * the actual payoff: the buyer types a house number instead of an address.
+ *
+ * `subtotal` is the PRE-discount cart subtotal, the same number shop_place_order
+ * uses to resolve free-above thresholds. Quoting against anything else is how
+ * the cart and the order end up disagreeing (see migration 0017).
+ */
+export function DeliveryEstimator({ compact = false }: { compact?: boolean }) {
+  const config = useStorefrontConfig()
+  const cart = useCartStore()
+  const delivery = useDeliveryStore()
+  const [draft, setDraft] = useState(() => formatPostalCode(delivery.postalCode))
+
+  const subtotal = selectSubtotal(cart)
+  const money = (value: number) => formatMoney(value, config.currency, config.locale)
+  const loading = delivery.status === 'loading'
+
+  async function submit(event: React.FormEvent) {
+    event.preventDefault()
+    await delivery.resolve(draft, subtotal)
+  }
+
+  function eta(option: { etaMinDays?: number; etaMaxDays?: number }): string | null {
+    const { etaMinDays: min, etaMaxDays: max } = option
+    if (min == null && max == null) return null
+    if (min === 0 && (max === 0 || max === 1)) return 'hoje ou amanhã'
+    if (min != null && max != null && min !== max) return `${min} a ${max} dias úteis`
+    return `${max ?? min} dia(s) útil(eis)`
+  }
+
+  return (
+    <section
+      data-testid={TID.deliveryEstimator}
+      className={compact ? 'rounded-lg border p-3' : 'mt-6 rounded-lg border p-4'}
+    >
+      <div className="flex items-center gap-2 text-sm font-semibold">
+        <Truck className="h-4 w-4 text-primary" />
+        Calcular entrega
+      </div>
+
+      <form onSubmit={submit} className="mt-3 flex gap-2">
+        <input
+          data-testid={TID.deliveryCepInput}
+          aria-label="CEP"
+          inputMode="numeric"
+          autoComplete="postal-code"
+          placeholder="00000-000"
+          value={draft}
+          onChange={(event) => setDraft(formatPostalCode(event.target.value))}
+          className="min-w-0 flex-1 rounded-lg border bg-background px-3 py-2 text-sm outline-none transition focus:border-primary focus:ring-2 focus:ring-primary/10"
+        />
+        <button
+          type="submit"
+          data-testid={TID.deliveryCepSubmit}
+          disabled={loading}
+          className="shrink-0 rounded-lg bg-primary px-4 py-2 text-sm font-semibold text-primary-foreground transition hover:opacity-90 disabled:opacity-50"
+        >
+          {loading ? '...' : 'Calcular'}
+        </button>
+      </form>
+
+      {/* Shown whenever there is one, including alongside a price: the range
+          may be covered even though the CEP itself was mistyped. */}
+      {delivery.error && (
+        <p data-testid={TID.deliveryError} className="mt-3 text-sm text-destructive">
+          {delivery.error}
+        </p>
+      )}
+
+      {delivery.address && (
+        <p data-testid={TID.deliveryAddress} className="mt-3 flex items-start gap-1.5 text-xs text-muted-foreground">
+          <MapPin className="mt-0.5 h-3.5 w-3.5 shrink-0" />
+          <span>
+            {[delivery.address.street, delivery.address.district].filter(Boolean).join(', ')}
+            {delivery.address.street || delivery.address.district ? ' — ' : ''}
+            {delivery.address.city}/{delivery.address.state}
+          </span>
+        </p>
+      )}
+
+      {delivery.status === 'served' && (
+        <ul className="mt-3 space-y-2">
+          {delivery.options.map((option) => {
+            const selected = delivery.selectedZoneId === option.zoneId
+            const label = eta(option)
+            // Resolved for the cart as it stands right now, not for whatever it
+            // held when the CEP was typed — the same rule the server applies.
+            const rate = resolveOptionRate(option, subtotal)
+            return (
+              <li key={option.zoneId}>
+                <button
+                  type="button"
+                  data-testid={TID.deliveryOption}
+                  data-zone={option.zoneId}
+                  data-rate={rate.toFixed(2)}
+                  aria-pressed={selected}
+                  onClick={() => delivery.selectZone(option.zoneId)}
+                  className={`flex w-full items-center justify-between gap-3 rounded-lg border px-3 py-2 text-left text-sm transition ${
+                    selected ? 'border-primary bg-primary/5' : 'border-border hover:bg-muted/40'
+                  }`}
+                >
+                  <span className="min-w-0">
+                    <span className="block truncate font-medium">
+                      {option.carrier ? `${option.carrier} · ${option.name}` : option.name}
+                    </span>
+                    {label && <span className="block text-xs text-muted-foreground">{label}</span>}
+                  </span>
+                  <span className="shrink-0 font-semibold">
+                    {rate === 0 ? 'Grátis' : money(rate)}
+                  </span>
+                </button>
+              </li>
+            )
+          })}
+        </ul>
+      )}
+
+      {/*
+        No options for a valid address. For a store that configured zones this
+        means "outside our delivery area" and checkout will refuse the order, so
+        it is said plainly here rather than at the end of the funnel. A store
+        with no zones at all never reaches this state — it quotes nothing and
+        keeps its flat rate.
+      */}
+      {delivery.status === 'unserved' && (
+        <p data-testid={TID.deliveryUnserved} className="mt-3 text-sm text-destructive">
+          Ainda não entregamos nesse CEP.
+        </p>
+      )}
+
+      {delivery.postalCode && (
+        <button
+          type="button"
+          data-testid={TID.deliveryClear}
+          onClick={() => { delivery.clear(); setDraft('') }}
+          className="mt-3 text-xs text-muted-foreground underline-offset-2 hover:underline"
+        >
+          Trocar CEP
+        </button>
+      )}
+    </section>
+  )
+}