@fayz-ai/storefront 0.9.0 → 0.10.0

package/dist/extend/extension-points.d.ts

@@ -0,0 +1,103 @@
+import type { Product } from '@fayz-ai/shop/types';
+import type { CartLine } from '../stores/cart.store';
+export declare const CART_LINE_ANNOTATION_POINT = "cart.lineAnnotation";
+export declare const ORDER_METADATA_POINT = "order.metadata";
+export declare const PRODUCT_CARD_BADGE_POINT = "product.cardBadge";
+export declare const CHECKOUT_FIELD_POINT = "checkout.field";
+export declare const BEFORE_PLACE_ORDER_VALVE = "checkout.beforePlaceOrder";
+/** Input of cart.lineAnnotation — one cart line, serializable. */
+export interface CartLineAnnotationInput {
+    productId: string;
+    name: string;
+    quantity: number;
+    unitPrice: number;
+    slug?: string;
+    optionsLabel?: string;
+}
+/** Output of cart.lineAnnotation — one annotation chip under the line. */
+export interface CartLineAnnotation {
+    /** Stable machine key (namespacing is the handler id; this keys within it). */
+    key: string;
+    /** Shopper-facing text. */
+    label: string;
+    /** Optional machine value carried alongside the label. */
+    value?: string;
+}
+export interface OrderMetadataInput {
+    items: Array<{
+        productId: string;
+        quantity: number;
+        unitPrice: number;
+    }>;
+    subtotal: number;
+    customerEmail?: string;
+}
+export interface ProductCardBadgeInput {
+    id: string;
+    slug: string;
+    name: string;
+    price: number;
+    inventoryCount: number;
+    compareAtPrice?: number | null;
+}
+export interface ProductCardBadge {
+    text: string;
+    tone?: 'default' | 'accent' | 'warning';
+}
+export interface CheckoutFieldInput {
+    customerEmail?: string;
+}
+/** Output of checkout.field — one extra field the checkout form renders. The
+ *  captured value lands in the order metadata under the handler's namespace. */
+export interface CheckoutFieldContribution {
+    id: string;
+    label: string;
+    type: 'text' | 'checkbox';
+    required?: boolean;
+    placeholder?: string;
+}
+/** Input of the beforePlaceOrder escape valve — the serializable placement
+ *  intent, BEFORE the default provider path runs. */
+export interface BeforePlaceOrderContext {
+    items: Array<{
+        productId: string;
+        variantId?: string;
+        quantity: number;
+        optionsLabel?: string;
+    }>;
+    customer: {
+        name: string;
+        email: string;
+    };
+    currency?: string;
+    discountCode?: string;
+    shippingTotal?: number;
+    notes?: string;
+    customerId?: string;
+}
+/** Test seam — clears the whole extension registry (declarations AND
+ *  handlers) and re-arms registration, so one suite cannot leak handlers into
+ *  the next. Pairs with core's clearExtensionPoints. */
+export declare function resetStorefrontExtensionPoints(): void;
+/** Declare the storefront extension points. Idempotent; called wherever blocks
+ *  are registered, so describeStore and the runtime always agree on the set. */
+export declare function registerStorefrontExtensionPoints(): void;
+/** Run cart.lineAnnotation for one line → its annotations, handler-ordered. */
+export declare function getCartLineAnnotations(line: CartLine): Promise<CartLineAnnotation[]>;
+/** Run product.cardBadge for one product → its badges, handler-ordered. */
+export declare function getProductCardBadges(product: Product): Promise<ProductCardBadge[]>;
+/** Run checkout.field → the extra fields a checkout form should render. */
+export declare function getCheckoutFieldContributions(input?: CheckoutFieldInput): Promise<Array<CheckoutFieldContribution & {
+    handlerId: string;
+}>>;
+/**
+ * Run order.metadata → the namespaced metadata object for a new order, or
+ * undefined when nothing contributed. Namespacing by handler id is the
+ * WooCommerce ExtendSchema rule: two extensions cannot clobber each other.
+ */
+export declare function collectOrderMetadata(input: OrderMetadataInput): Promise<Record<string, unknown> | undefined>;
+/** Run the beforePlaceOrder valve. Null → take the default path. */
+export declare function runBeforePlaceOrderValve<TOrder extends {
+    id: string;
+}>(ctx: BeforePlaceOrderContext): Promise<TOrder | null>;
+//# sourceMappingURL=extension-points.d.ts.map

package/dist/extend/extension-points.d.ts.map

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

package/dist/extend/slots.d.ts

@@ -0,0 +1,216 @@
+import React from 'react';
+import type { Product } from '@fayz-ai/shop/types';
+import type { StorefrontBlockLike } from '../blocks/page-blocks';
+import type { CartLine } from '../stores/cart.store';
+/** What each slot area hands to the blocks inside it. */
+export interface StorefrontSlotContextMap {
+    productDetail: {
+        product: Product;
+        soldOut: boolean;
+        lowStock: boolean;
+        /** Percent off, or 0 when the product is not discounted. */
+        discountPct: number;
+    };
+    /**
+     * The card, which renders once per product in a grid — so its context is the
+     * one product that card is for, not the list.
+     */
+    productCard: {
+        product: Product;
+        soldOut: boolean;
+        onSale: boolean;
+        /** True when the product has variants, so quick-add routes to the PDP. */
+        hasOptions: boolean;
+    };
+    catalog: {
+        /** The products currently visible, after filters and search. */
+        products: readonly Product[];
+        /** True while the list is being fetched. */
+        loading: boolean;
+    };
+    cart: {
+        lines: readonly CartLine[];
+        subtotal: number;
+    };
+    checkout: {
+        subtotal: number;
+        total: number;
+    };
+    header: Record<string, never>;
+    footer: Record<string, never>;
+}
+export type StorefrontSlotArea = keyof StorefrontSlotContextMap;
+type SlotBlocks = readonly StorefrontBlockLike[];
+/**
+ * Where a store may graft blocks into an SDK page.
+ *
+ * Position names read as "where", not "what": `afterPrice` keeps meaning the
+ * same thing if the price stops being a `<Price>` and starts being something
+ * else, which a name like `priceBelowSlot` would not.
+ */
+export interface StorefrontSlots {
+    productDetail?: {
+        /** Between the breadcrumb and the product name. */
+        beforeTitle?: SlotBlocks;
+        /** Immediately under the product name, above the price. */
+        afterTitle?: SlotBlocks;
+        /** Under the price and discount badge. */
+        afterPrice?: SlotBlocks;
+        /** Under the description paragraph. */
+        afterDescription?: SlotBlocks;
+        /** Above the quantity + add-to-cart row. Where trust seals go. */
+        beforeAddToCart?: SlotBlocks;
+        /** Under the add-to-cart row, above the delivery estimate. */
+        afterAddToCart?: SlotBlocks;
+        /** Under the gallery column, in the left half of the page. */
+        afterGallery?: SlotBlocks;
+        /** Above the specification table, below the two-column fold. */
+        beforeSpecs?: SlotBlocks;
+        /** The bottom of the page, after related products. */
+        afterDetail?: SlotBlocks;
+    };
+    /**
+     * The product card, wherever it appears — grid, rail, slider, related.
+     *
+     * This is where the fleet actually hurt: four of five customizing stores
+     * forked a ~120-line card to add one thing to it, and each fork then lost
+     * something else (the sale badge, the variant guard, `commerceMode` gating,
+     * `theme.productCard` honouring).
+     */
+    productCard?: {
+        /** Above the image, full card width. */
+        top?: SlotBlocks;
+        /** Over the image. The container is `relative`; content positions itself. */
+        imageOverlay?: SlotBlocks;
+        /** Between the product name and the price row. */
+        afterName?: SlotBlocks;
+        /** Under the price row. */
+        underPrice?: SlotBlocks;
+    };
+    catalog?: {
+        /** Above the page heading. */
+        beforeHeading?: SlotBlocks;
+        /** Between the heading and the filters/grid row. */
+        beforeGrid?: SlotBlocks;
+        /** Inside the filter column, under the filters. */
+        afterFilters?: SlotBlocks;
+        /** Under the product grid. */
+        afterGrid?: SlotBlocks;
+    };
+    cart?: {
+        /** Above the line items. */
+        beforeLines?: SlotBlocks;
+        /** Between the lines and the totals. */
+        beforeSummary?: SlotBlocks;
+        /** Under the totals, around the checkout button. */
+        afterSummary?: SlotBlocks;
+    };
+    checkout?: {
+        /** Above the checkout form. */
+        beforeForm?: SlotBlocks;
+        /** Under the payment method selector. */
+        afterPaymentMethods?: SlotBlocks;
+        /** Under the whole form, around the place-order button. */
+        afterForm?: SlotBlocks;
+    };
+    header?: {
+        /**
+         * Left of the account/cart icons.
+         *
+         * Named for the actions row rather than for the header, because the header
+         * has three layout variants (default, centered, search) that place the logo
+         * differently. A slot "left of the logo" would land somewhere different in
+         * each one; the actions row is shared, so this position is the same in all
+         * three.
+         */
+        beforeActions?: SlotBlocks;
+        /** Right of the cart icon. */
+        afterActions?: SlotBlocks;
+        /** A full-width strip under the whole header, in every variant. */
+        belowNav?: SlotBlocks;
+    };
+    footer?: {
+        /** Above the footer columns. */
+        before?: SlotBlocks;
+        /** Under the footer columns, above the credit line. */
+        after?: SlotBlocks;
+    };
+}
+export interface SlotDescriptor {
+    area: StorefrontSlotArea;
+    name: string;
+    /** Dotted id used in diagnostics and docs. */
+    id: string;
+    /** Where this slot sits in the page. */
+    position: string;
+    /** Keys the blocks inside receive through `useSlotContext`. */
+    provides: readonly string[];
+    /**
+     * `stable` means a store in our fleet actually needed this position and paid
+     * for it by forking something; `experimental` means the position is plausible
+     * but unproven and may move or be removed in a minor.
+     *
+     * The distinction is not decoration. Every slot is a compatibility promise,
+     * and a surface that promises two dozen positions nobody asked for is a
+     * surface that cannot be changed later. FastStore marks unproven API with an
+     * `__experimental` prefix for the same reason; this is the same idea as a
+     * field, so `fayz upgrade` can tell a store which unproven slots it depends on.
+     */
+    stability: 'stable' | 'experimental';
+    /** For stable slots: the fork that proves the position was needed. */
+    evidence?: string;
+}
+/**
+ * Every slot, with its position, the context it provides, and whether a real
+ * store ever asked for it.
+ *
+ * Shipped as data rather than written in prose because a prose inventory drifts
+ * the first time a slot is added. The docs page and the agent's prompt both read
+ * this, so there is one list and it is the code's.
+ *
+ * Six slots are `stable`: a store in the fleet needed that exact position and
+ * paid for it by forking a page or a component. The rest are `experimental` —
+ * plausible positions with no proven demand yet. Marking them honestly is what
+ * keeps the surface changeable; a store that builds on one is told, by
+ * `fayz upgrade`, that it did.
+ */
+export declare const STOREFRONT_SLOTS: readonly SlotDescriptor[];
+export interface ListSlotsOptions {
+    area?: StorefrontSlotArea;
+    /** Keep only slots a store has actually proven it needs. */
+    stableOnly?: boolean;
+}
+/** The slot inventory, optionally narrowed. */
+export declare function listSlots(areaOrOptions?: StorefrontSlotArea | ListSlotsOptions): readonly SlotDescriptor[];
+/** The slots a store's config actually fills, with their stability. */
+export declare function usedSlots(slots: StorefrontSlots | undefined): readonly SlotDescriptor[];
+/**
+ * The context the surrounding slot provides.
+ *
+ * The type parameter is the caller's assertion about which area it is rendering
+ * in, which is as much as a registry-resolved block can be given: the block is
+ * looked up by string, so nothing at the call site knows its area statically.
+ * Returns null outside a slot, so a block can work both in a slot and in a page.
+ */
+export declare function useSlotContext<A extends StorefrontSlotArea>(): StorefrontSlotContextMap[A] | null;
+export interface SlotProps<A extends StorefrontSlotArea> {
+    area: A;
+    name: string;
+    context?: StorefrontSlotContextMap[A];
+}
+/**
+ * Render the blocks a store put in one slot.
+ *
+ * The slot reads its own content out of the config rather than being handed it,
+ * so a page places `<Slot area="productDetail" name="afterPrice" />` without
+ * threading `config.slots` down to every position. That matters because there
+ * are two dozen of these call sites and every threaded prop is a chance to wire
+ * one to the wrong slot.
+ *
+ * Renders nothing — not even a wrapper — when the slot is empty, which is the
+ * overwhelmingly common case. An always-present wrapper would change the layout
+ * of every page for every store that uses no slots at all.
+ */
+export declare function Slot<A extends StorefrontSlotArea>({ area, name, context }: SlotProps<A>): React.JSX.Element | null;
+export {};
+//# sourceMappingURL=slots.d.ts.map

package/dist/extend/slots.d.ts.map

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

package/dist/hooks/index.d.ts

@@ -1,7 +1,26 @@
-export { useProducts } from './useProducts';
-export { useProduct } from './useProduct';
-export { useCategories } from './useCategories';
-export { useStorefront, useCatalog, useCart, useEnquiry, useStorefrontActions } from './useStorefront';
-export { useMyOrders } from './useMyOrders';
-export { useDiscountValidator } from './useDiscountValidator';
+export { useProducts } from './use-products';
+export { useProduct } from './use-product';
+export { useCategories } from './use-categories';
+export { useCatalog } from './use-catalog';
+export { useStorefront } from './use-storefront';
+export { useStorefrontActions } from './use-storefront-actions';
+export { useStorefrontHead } from './use-storefront-head';
+export { useRegion } from './use-region';
+export { usePolicies } from './use-policies';
+export type { StorefrontRegion } from './use-region';
+export type { PolicyKind, StorefrontPolicy, UsePolicies } from './use-policies';
+export { useCart } from './use-cart';
+export { useCheckout } from './use-checkout';
+export { useDiscountValidator } from './use-discount-validator';
+export { usePaymentMethods } from './use-payment-methods';
+export { useShipping } from './use-shipping';
+export { useAddress } from './use-address';
+export type { CheckoutTotals, CheckoutSubmission, UseCheckout } from './use-checkout';
+export type { UsePaymentMethods } from './use-payment-methods';
+export type { UseShipping } from './use-shipping';
+export type { AddressLookupStatus, UseAddress } from './use-address';
+export { useOrder } from './use-order';
+export { useMyOrders } from './use-my-orders';
+export type { UseOrder } from './use-order';
+export { useEnquiry } from './use-enquiry';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AACtG,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAG1C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAG/E,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACrF,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAGpE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}

package/dist/hooks/use-address.d.ts

@@ -0,0 +1,26 @@
+import type { PostalAddress } from '@fayz-ai/core';
+export type AddressLookupStatus = 'idle' | 'loading' | 'found' | 'not-found' | 'error';
+export interface UseAddress {
+    postalCode: string;
+    /** The same code formatted for display (`01311-000`). */
+    display: string;
+    address: PostalAddress | null;
+    status: AddressLookupStatus;
+    error: string | null;
+    /** Set the code and look it up once it is complete. Partial input never calls out. */
+    setPostalCode: (value: string) => void;
+    clear: () => void;
+}
+/**
+ * A postal code, and the address it resolves to.
+ *
+ * The lookup fires on the code being COMPLETE rather than on every keystroke —
+ * a debounce would still send `0`, `01`, `013`… and each is a request that can
+ * only fail. The last completed lookup wins: a shopper who corrects a typo mid
+ * flight must not have the stale response overwrite the new one.
+ *
+ * This is the address half of checkout, separated from `useShipping` on purpose:
+ * a store that does not ship still asks for a billing address.
+ */
+export declare function useAddress(initial?: string): UseAddress;
+//# sourceMappingURL=use-address.d.ts.map

package/dist/hooks/use-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-address.d.ts","sourceRoot":"","sources":["../../src/hooks/use-address.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAA;AAEtF,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;IAC7B,MAAM,EAAE,mBAAmB,CAAA;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,sFAAsF;IACtF,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAK,GAAG,UAAU,CAoDnD"}

package/dist/hooks/use-cart.d.ts

@@ -0,0 +1,3 @@
+/** The cart: lines, totals and the drawer. */
+export declare function useCart(): import("..").CartState;
+//# sourceMappingURL=use-cart.d.ts.map

package/dist/hooks/use-cart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cart.d.ts","sourceRoot":"","sources":["../../src/hooks/use-cart.ts"],"names":[],"mappings":"AAEA,8CAA8C;AAC9C,wBAAgB,OAAO,2BAEtB"}

package/dist/hooks/use-catalog.d.ts

@@ -0,0 +1,24 @@
+/** The catalog store, plus the config a listing page needs to render a link. */
+export declare function useCatalog(): {
+    catalogPath: string;
+    config: import("..").ResolvedStorefrontConfig;
+    search: string;
+    categoryId: string | null;
+    collection: string | null;
+    facets: import("..").CatalogFacets;
+    priceMin: number | null;
+    priceMax: number | null;
+    inStockOnly: boolean;
+    sort: import("..").CatalogSort;
+    setSearch(search: string): void;
+    setCategoryId(categoryId: string | null): void;
+    setCollection(collection: string | null): void;
+    setFacet(key: string, value: string | null): void;
+    clearFacets(): void;
+    setPriceMin(priceMin: number | null): void;
+    setPriceMax(priceMax: number | null): void;
+    setInStockOnly(inStockOnly: boolean): void;
+    setSort(sort: import("..").CatalogSort): void;
+    reset(): void;
+};
+//# sourceMappingURL=use-catalog.d.ts.map

package/dist/hooks/use-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-catalog.d.ts","sourceRoot":"","sources":["../../src/hooks/use-catalog.ts"],"names":[],"mappings":"AAGA,gFAAgF;AAChF,wBAAgB,UAAU;;;;;;;;;;;;;;;;;;;;;EAIzB"}

package/dist/hooks/use-categories.d.ts

@@ -0,0 +1,19 @@
+import type { Category } from '@fayz-ai/shop/types';
+/**
+ * Every catalog category, in store order.
+ *
+ * Reads through the declared `categories.list` loader instead of calling
+ * `getShopProvider().listCategories()` from an effect. Same provider, same
+ * query, same result — but a read that goes through the port is deduped with
+ * any block on the page asking the same question, and it can be resolved ahead
+ * of render. That second property is why the change matters: the footer's
+ * category column is on every page of every store, and a read that only exists
+ * inside an effect is permanently empty in a headless render (M8) and in any
+ * future SSR pass (L4). A read that reaches the provider directly can be
+ * neither deduped nor pre-resolved.
+ */
+export declare function useCategories(): {
+    categories: Category[];
+    loading: boolean;
+};
+//# sourceMappingURL=use-categories.d.ts.map

package/dist/hooks/use-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-categories.d.ts","sourceRoot":"","sources":["../../src/hooks/use-categories.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,IAAI;IAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAG5E"}

package/dist/hooks/use-checkout.d.ts

@@ -0,0 +1,41 @@
+import type { PaymentMethodKind, ShippingAddressInput } from '@fayz-ai/shop/types';
+import type { PlaceStorefrontOrderResult, StorefrontCheckoutAddress, StorefrontCheckoutCustomer } from '../workflows/checkout';
+export interface CheckoutTotals {
+    count: number;
+    subtotal: number;
+    discountTotal: number;
+    shipping: number;
+    total: number;
+}
+export interface CheckoutSubmission {
+    customer: StorefrontCheckoutCustomer;
+    address?: StorefrontCheckoutAddress;
+    shippingAddress?: ShippingAddressInput;
+    paymentMethod?: PaymentMethodKind;
+    markPaid?: boolean;
+}
+export interface UseCheckout {
+    /** False when the store sells by catalog or enquiry — there is no checkout to render. */
+    enabled: boolean;
+    /** True when the cart has nothing in it: the reason an enabled checkout still cannot proceed. */
+    empty: boolean;
+    totals: CheckoutTotals;
+    placing: boolean;
+    error: string | null;
+    placeOrder: (input: CheckoutSubmission) => Promise<PlaceStorefrontOrderResult | null>;
+}
+/**
+ * The checkout, with the cart, session and config already bound.
+ *
+ * `placeOrder` takes only what the shopper typed. Everything the server needs
+ * to be told about — lines, discount, totals, the customer session — is read
+ * here from the stores, because a caller assembling that payload is a caller
+ * that can assemble it wrongly, and the prices in it are exactly the numbers a
+ * client must not be trusted with. `shop_place_order` recomputes from the
+ * catalog regardless; this keeps the two from disagreeing on screen.
+ *
+ * `placing` is guarded rather than advisory: a double-submitted checkout is two
+ * orders and two charges, and the button being disabled is not a guarantee.
+ */
+export declare function useCheckout(): UseCheckout;
+//# sourceMappingURL=use-checkout.d.ts.map

package/dist/hooks/use-checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-checkout.d.ts","sourceRoot":"","sources":["../../src/hooks/use-checkout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAYlF,OAAO,KAAK,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,uBAAuB,CAAA;AAE9B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,0BAA0B,CAAA;IACpC,OAAO,CAAC,EAAE,yBAAyB,CAAA;IACnC,eAAe,CAAC,EAAE,oBAAoB,CAAA;IACtC,aAAa,CAAC,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,yFAAyF;IACzF,OAAO,EAAE,OAAO,CAAA;IAChB,iGAAiG;IACjG,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,cAAc,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,UAAU,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAA;CACtF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,IAAI,WAAW,CAqDzC"}

package/dist/hooks/use-discount-validator.d.ts

@@ -0,0 +1,20 @@
+export interface DiscountValidation {
+    valid: boolean;
+    percent: number;
+    message?: string;
+}
+/**
+ * Storefront coupon validator, backed by the RULE ENGINE (spine M6): a store's
+ * `{code, percent}` config entries and its document `promotions` section are
+ * both Promotions — one eligibility rule on `code` plus an application method
+ * — gated by the same evaluator path the server mirrors. The hardcoded
+ * "trust config.discounts directly" branch this hook used to carry is retired.
+ *
+ * Codes the local document does not know still go through the provider-backed
+ * validateDiscount primitive (status/date-window/usage-limit on the discount
+ * table), translated through the same adapter. The storefront cart models a
+ * discount as a percentage, so non-percentage codes are rejected for
+ * client-side preview — the server still honors them at checkout.
+ */
+export declare function useDiscountValidator(): (code: string) => Promise<DiscountValidation>;
+//# sourceMappingURL=use-discount-validator.d.ts.map

package/dist/hooks/use-discount-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-discount-validator.d.ts","sourceRoot":"","sources":["../../src/hooks/use-discount-validator.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AA0BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAoDpF"}

package/dist/hooks/use-enquiry.d.ts

@@ -0,0 +1,7 @@
+import type { CreateProductEnquiryInput } from '@fayz-ai/shop/types';
+/** The enquiry path, for stores that take orders as conversations rather than checkouts. */
+export declare function useEnquiry(): {
+    enquiry: Required<Pick<import("..").StorefrontEnquiryConfig, "label" | "successMessage" | "subjectPrefix">> & Omit<import("..").StorefrontEnquiryConfig, "label" | "successMessage" | "subjectPrefix">;
+    createProductEnquiry: (input: CreateProductEnquiryInput) => Promise<import("@fayz-ai/shop").ProductEnquiry>;
+};
+//# sourceMappingURL=use-enquiry.d.ts.map

package/dist/hooks/use-enquiry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-enquiry.d.ts","sourceRoot":"","sources":["../../src/hooks/use-enquiry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAGpE,4FAA4F;AAC5F,wBAAgB,UAAU;;kCAGmB,yBAAyB;EASrE"}

package/dist/hooks/{useMyOrders.d.ts → use-my-orders.d.ts}

@@ -4,4 +4,4 @@ export declare function useMyOrders(): {
     loading: boolean;
     refresh: () => void;
 };
-//# sourceMappingURL=useMyOrders.d.ts.map
+//# sourceMappingURL=use-my-orders.d.ts.map

package/dist/hooks/use-my-orders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-my-orders.d.ts","sourceRoot":"","sources":["../../src/hooks/use-my-orders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAGhD,wBAAgB,WAAW,IAAI;IAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAmCxF"}

package/dist/hooks/use-order.d.ts

@@ -0,0 +1,17 @@
+import type { Order } from '@fayz-ai/shop/types';
+export interface UseOrder {
+    order: Order | null;
+    loading: boolean;
+    error: string | null;
+    reload: () => void;
+}
+/**
+ * One order by id — the confirmation page, and the link a shopper is emailed.
+ *
+ * A null id is a legitimate state (the route matched before the id resolved),
+ * not an error: it settles to `loading: false` with no order rather than
+ * reporting a failure the shopper cannot act on. The last request wins, so a
+ * fast reload cannot leave the previous order on screen.
+ */
+export declare function useOrder(orderId: string | null | undefined): UseOrder;
+//# sourceMappingURL=use-order.d.ts.map

package/dist/hooks/use-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-order.d.ts","sourceRoot":"","sources":["../../src/hooks/use-order.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEhD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,CAsCrE"}

package/dist/hooks/use-payment-methods.d.ts

@@ -0,0 +1,19 @@
+import type { PaymentMethodKind } from '@fayz-ai/shop/types';
+export interface UsePaymentMethods {
+    /** The kinds this store offers, in the order it declared them. */
+    methods: readonly PaymentMethodKind[];
+    /** The default selection: the first declared method, or null when none are. */
+    preferred: PaymentMethodKind | null;
+    supports: (method: PaymentMethodKind) => boolean;
+}
+/**
+ * Which payment methods the store offers.
+ *
+ * Deliberately provider-agnostic. A method is a declared KIND (`pix`,
+ * `credit_card`, `cash`) — never a Stripe or Mercado Pago object — because the
+ * canonical rule is that no storefront code imports a provider client. Which
+ * gateway settles a `pix` is the backend's business, and swapping it must not
+ * change a line here.
+ */
+export declare function usePaymentMethods(): UsePaymentMethods;
+//# sourceMappingURL=use-payment-methods.d.ts.map

package/dist/hooks/use-payment-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-payment-methods.d.ts","sourceRoot":"","sources":["../../src/hooks/use-payment-methods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAG5D,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAA;IACrC,+EAA+E;IAC/E,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAA;CACjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,CAQrD"}

package/dist/hooks/use-policies.d.ts

@@ -0,0 +1,25 @@
+export type PolicyKind = 'privacy' | 'terms' | 'returns';
+export interface StorefrontPolicy {
+    kind: PolicyKind;
+    title: string;
+    path: string;
+    /** The store's own text, or null when it has not published this one yet. */
+    content: string | null;
+    published: boolean;
+}
+export interface UsePolicies {
+    policies: StorefrontPolicy[];
+    /** True when every policy has text — what a payment processor asks for at go-live. */
+    complete: boolean;
+    contactEmail?: string;
+}
+/**
+ * The institutional pages, as data.
+ *
+ * All three are always listed, published or not: the routes and footer links
+ * have to exist before the store writes its policies, because a 404 where a
+ * processor expects a returns policy blocks go-live. `published` is what a
+ * checklist reads; the page itself renders a placeholder.
+ */
+export declare function usePolicies(): UsePolicies;
+//# sourceMappingURL=use-policies.d.ts.map

package/dist/hooks/use-policies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-policies.d.ts","sourceRoot":"","sources":["../../src/hooks/use-policies.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;AAExD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,OAAO,CAAA;CACnB;AAQD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,gBAAgB,EAAE,CAAA;IAC5B,sFAAsF;IACtF,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,WAAW,CAWzC"}