@wocart/storefront 1.18.0 → 1.20.0

package/dist/client/products.js

@@ -12,8 +12,8 @@
  * half-shaped product into a theme.
  */
 import { z } from "zod";
-import { ProductListSchema, ProductSchema, ReviewEligibilitySchema, ReviewListEnvelopeSchema, ReviewSubmitResultSchema, ReviewUploadSchema } from "../schemas.js";
-import { STOREFRONT_OPERATIONS } from "../domain.js";
+import { ProductListSchema, ProductPageEnvelopeSchema, ProductSchema, ReviewEligibilitySchema, ReviewListEnvelopeSchema, ReviewSubmitResultSchema, ReviewUploadSchema } from "../schemas.js";
+import { STOREFRONT_OPERATIONS } from "../operations.js";
 import { localizedPath } from "./paths.js";
 import { isNotFoundAnswer, reportDegradedRead } from "./core.js";
 /** Page size when a caller names none — the storefront's default grid. */
@@ -24,16 +24,19 @@ export const PRODUCT_PAGE_MAX = 99;
  * Create products namespace
  */
 export function createProductsNamespace(core) {
+    const query = (filters, extra = {}) => ({
+        ...extra,
+        categoryId: filters?.categoryId || undefined,
+        collection: filters?.collection || undefined,
+        onSale: filters?.onSale ? "true" : undefined,
+        featured: filters?.featured ? "true" : undefined,
+        sort: filters?.sort || undefined,
+        limit: filters?.limit === undefined ? undefined : String(filters.limit),
+        offset: filters?.offset ? String(filters.offset) : undefined,
+    });
     const list = async (filters) => {
         try {
-            const products = await core.get(localizedPath(core.config, "/store/products", {
-                categoryId: filters?.categoryId || undefined,
-                collection: filters?.collection || undefined,
-                onSale: filters?.onSale ? "true" : undefined,
-                featured: filters?.featured ? "true" : undefined,
-                limit: filters?.limit === undefined ? undefined : String(filters.limit),
-                offset: filters?.offset ? String(filters.offset) : undefined,
-            }), z.array(ProductListSchema), { operation: STOREFRONT_OPERATIONS.productsList });
+            const products = await core.get(localizedPath(core.config, "/store/products", query(filters)), z.array(ProductListSchema), { operation: STOREFRONT_OPERATIONS.productsList });
             return products ?? [];
         }
         catch (error) {
@@ -41,6 +44,22 @@ export function createProductsNamespace(core) {
             return [];
         }
     };
+    /** One page of `path`, asked for one row more than the page so `hasNext` is exact. */
+    const page = async (path, filters, extra, operation) => {
+        const size = Math.min(Math.max(1, filters?.limit ?? PRODUCT_PAGE_DEFAULT), PRODUCT_PAGE_MAX);
+        try {
+            const envelope = await core.get(localizedPath(core.config, path, query({ ...filters, limit: size + 1 }, extra)), ProductPageEnvelopeSchema, {
+                envelope: true,
+                operation,
+            });
+            const rows = envelope?.data ?? [];
+            return { items: rows.slice(0, size), hasNext: rows.length > size, total: envelope?.total ?? null };
+        }
+        catch (error) {
+            reportDegradedRead(core.config, error, operation);
+            return { items: [], hasNext: false, total: null };
+        }
+    };
     return {
         async get(handle) {
             try {
@@ -55,9 +74,13 @@ export function createProductsNamespace(core) {
         },
         list,
         async page(filters) {
-            const size = Math.min(Math.max(1, filters?.limit ?? PRODUCT_PAGE_DEFAULT), PRODUCT_PAGE_MAX);
-            const rows = await list({ ...filters, limit: size + 1 });
-            return { items: rows.slice(0, size), hasNext: rows.length > size };
+            return page("/store/products", filters, {}, STOREFRONT_OPERATIONS.productsList);
+        },
+        async search(text, filters) {
+            const q = text.trim().slice(0, 100);
+            if (q === "")
+                return { items: [], hasNext: false, total: 0 };
+            return page("/store/search", filters, { q }, STOREFRONT_OPERATIONS.productsSearch);
         },
         reviews: {
             async list(productId, pagination) {

package/dist/client/shipping.js

@@ -13,7 +13,7 @@
  * treated as unsupported.
  */
 import { ShippingRatesSchema } from "../schemas.js";
-import { STOREFRONT_OPERATIONS } from "../domain.js";
+import { STOREFRONT_OPERATIONS } from "../operations.js";
 import { reportDegradedRead } from "./core.js";
 /**
  * Create shipping namespace

package/dist/coupon.d.ts

@@ -7,7 +7,7 @@
  * code does not apply. A theme shows those answers; it never decides one.
  */
 import type { ClientResult } from "./domain.js";
-import type { CouponRefusal } from "./types.js";
+import type { CouponRefusal, CouponRefusalReason } from "./types.js";
 /** The error code of an order refused for its code. */
 export declare const COUPON_NOT_APPLICABLE = "COUPON_NOT_APPLICABLE";
 /** The query parameter a shareable coupon link carries: `/products/robe?coupon=RAMADAN10`. */
@@ -16,3 +16,18 @@ export declare const COUPON_URL_PARAM = "coupon";
 export declare function couponFromUrl(url: URL): string | null;
 /** Why an order was refused for its code, or null when it was refused — or placed — for anything else. */
 export declare function couponRefusalOf(result: ClientResult<unknown>): CouponRefusal | null;
+/** Every reason a code is refused for, as the platform names them. A newer server may add one; it then reads as `refused`. */
+export declare const COUPON_REFUSAL_REASONS: readonly ["not_found", "not_started", "expired", "used_up", "identify_first", "not_eligible", "already_used", "no_eligible_products", "offer_applied", "below_minimum_subtotal", "below_minimum_quantity", "delivery_already_free"];
+/**
+ * The reasons about the basket, not the code: the code is good, but this
+ * basket does not meet it yet — a phone still to type, a product under an
+ * offer, a minimum not reached, delivery already free.
+ */
+export declare const COUPON_HINT_REASONS: readonly CouponRefusalReason[];
+/**
+ * How a refusal reads: `hint` when the shopper can still meet the code with
+ * this basket (see `COUPON_HINT_REASONS`), `refused` when the code itself
+ * cannot be used — unknown, outside its dates, used up, not for this shopper —
+ * and for a reason this release does not know.
+ */
+export declare function couponRefusalTone(reason: CouponRefusalReason): "refused" | "hint";

package/dist/coupon.js

@@ -17,3 +17,40 @@ export function couponRefusalOf(result) {
         ...(typeof result.startsAt === "string" ? { startsAt: result.startsAt } : {}),
     };
 }
+/** Every reason a code is refused for, as the platform names them. A newer server may add one; it then reads as `refused`. */
+export const COUPON_REFUSAL_REASONS = [
+    "not_found",
+    "not_started",
+    "expired",
+    "used_up",
+    "identify_first",
+    "not_eligible",
+    "already_used",
+    "no_eligible_products",
+    "offer_applied",
+    "below_minimum_subtotal",
+    "below_minimum_quantity",
+    "delivery_already_free",
+];
+/**
+ * The reasons about the basket, not the code: the code is good, but this
+ * basket does not meet it yet — a phone still to type, a product under an
+ * offer, a minimum not reached, delivery already free.
+ */
+export const COUPON_HINT_REASONS = [
+    "identify_first",
+    "no_eligible_products",
+    "offer_applied",
+    "below_minimum_subtotal",
+    "below_minimum_quantity",
+    "delivery_already_free",
+];
+/**
+ * How a refusal reads: `hint` when the shopper can still meet the code with
+ * this basket (see `COUPON_HINT_REASONS`), `refused` when the code itself
+ * cannot be used — unknown, outside its dates, used up, not for this shopper —
+ * and for a reason this release does not know.
+ */
+export function couponRefusalTone(reason) {
+    return COUPON_HINT_REASONS.includes(reason) ? "hint" : "refused";
+}

package/dist/domain.d.ts

@@ -46,9 +46,6 @@ export interface StoreScope {
      */
     readonly readTimeoutMs?: number;
 }
-/** The server's hard limits for one canonical browser basket. */
-export declare const MAX_BASKET_LINES: 20;
-export declare const MAX_BASKET_LINE_QUANTITY: 100;
 /**
  * A wilaya id, bounded by the reference dataset itself rather than a literal.
  *
@@ -57,11 +54,6 @@ export declare const MAX_BASKET_LINE_QUANTITY: 100;
  * range in step.
  */
 export declare const WilayaIdSchema: z.ZodNumber;
-/**
- * Product + variant is the identity of a basket line. A null variant is a
- * real identity, not the same thing as any selected variant.
- */
-export declare function basketLineKey(productId: string, variantId: string | null): string;
 /**
  * A browser-owned basket line. `unitPrice` is an optimistic display value;
  * the server re-prices every line during validation and order creation.
@@ -347,65 +339,3 @@ export type ClientResult<T> = {
     readonly domainError: DomainError;
     readonly [key: string]: unknown;
 };
-export type RetryPolicy = "safe-read" | "never";
-export declare const STOREFRONT_OPERATIONS: {
-    readonly configGet: "config.get";
-    readonly categoriesList: "categories.list";
-    readonly productsGet: "products.get";
-    readonly productsList: "products.list";
-    readonly productsReviewsList: "products.reviews.list";
-    readonly productsReviewsSubmit: "products.reviews.submit";
-    readonly productsReviewsEligibility: "products.reviews.eligibility";
-    readonly productsReviewsUpload: "products.reviews.upload";
-    readonly pagesGet: "pages.get";
-    readonly pagesLanding: "pages.landing";
-    readonly menusGet: "menus.get";
-    readonly collectionsGet: "collections.get";
-    readonly shippingRates: "shipping.rates";
-    readonly shippingRate: "shipping.rate";
-    readonly geoCommunes: "geo.communes";
-    readonly cartValidate: "cart.validate";
-    readonly pageDataGet: "pageData.get";
-    readonly ordersCreate: "orders.create";
-    readonly ordersTracking: "orders.tracking";
-    readonly ordersAbandonedUpsert: "orders.abandoned.upsert";
-    readonly ordersAbandonedConvert: "orders.abandoned.convert";
-    readonly ordersOtpSend: "orders.otp.send";
-    readonly ordersOtpVerify: "orders.otp.verify";
-};
-export type StorefrontOperation = (typeof STOREFRONT_OPERATIONS)[keyof typeof STOREFRONT_OPERATIONS];
-/**
- * The retry policy per operation, as a contract a caller can read.
- *
- * The transport enforces it by kind: every `safe-read` goes through the
- * caching/deduplicating GET path, which repeats a transport or 5xx failure,
- * while every `never` goes through the POST/PATCH path, which returns a result
- * and never retries (a replayed write is how a shopper ends up with two
- * orders). A test asserts this table covers every public operation and agrees
- * with that classification, so a new operation cannot ship unclassified.
- */
-export declare const STOREFRONT_RETRY_POLICIES: {
-    readonly "cart.validate": "safe-read";
-    readonly "categories.list": "safe-read";
-    readonly "config.get": "safe-read";
-    readonly "geo.communes": "safe-read";
-    readonly "orders.abandoned.convert": "never";
-    readonly "orders.abandoned.upsert": "never";
-    readonly "orders.create": "never";
-    readonly "orders.otp.send": "never";
-    readonly "orders.otp.verify": "never";
-    readonly "orders.tracking": "safe-read";
-    readonly "pageData.get": "safe-read";
-    readonly "pages.get": "safe-read";
-    readonly "pages.landing": "safe-read";
-    readonly "menus.get": "safe-read";
-    readonly "collections.get": "safe-read";
-    readonly "products.get": "safe-read";
-    readonly "products.list": "safe-read";
-    readonly "products.reviews.list": "safe-read";
-    readonly "products.reviews.submit": "never";
-    readonly "products.reviews.eligibility": "never";
-    readonly "products.reviews.upload": "never";
-    readonly "shipping.rate": "safe-read";
-    readonly "shipping.rates": "safe-read";
-};

package/dist/domain.js

@@ -1,8 +1,6 @@
 import { z } from "zod";
 import { WILAYAS } from "./data/wilayas.js";
-/** The server's hard limits for one canonical browser basket. */
-export const MAX_BASKET_LINES = 20;
-export const MAX_BASKET_LINE_QUANTITY = 100;
+import { MAX_BASKET_LINES, MAX_BASKET_LINE_QUANTITY, basketLineKey } from "./basket-line.js";
 /**
  * A wilaya id, bounded by the reference dataset itself rather than a literal.
  *
@@ -11,13 +9,6 @@ export const MAX_BASKET_LINE_QUANTITY = 100;
  * range in step.
  */
 export const WilayaIdSchema = z.number().int().min(1).max(WILAYAS.length);
-/**
- * Product + variant is the identity of a basket line. A null variant is a
- * real identity, not the same thing as any selected variant.
- */
-export function basketLineKey(productId, variantId) {
-    return `${productId}\u0000${variantId ?? ""}`;
-}
 /**
  * A browser-owned basket line. `unitPrice` is an optimistic display value;
  * the server re-prices every line during validation and order creation.
@@ -201,63 +192,3 @@ export const TrackingDecisionSchema = z.object({
     pixelId: z.string().nullable(),
     event: z.enum(["Purchase", "Lead"]).nullable(),
 });
-export const STOREFRONT_OPERATIONS = {
-    configGet: "config.get",
-    categoriesList: "categories.list",
-    productsGet: "products.get",
-    productsList: "products.list",
-    productsReviewsList: "products.reviews.list",
-    productsReviewsSubmit: "products.reviews.submit",
-    productsReviewsEligibility: "products.reviews.eligibility",
-    productsReviewsUpload: "products.reviews.upload",
-    pagesGet: "pages.get",
-    pagesLanding: "pages.landing",
-    menusGet: "menus.get",
-    collectionsGet: "collections.get",
-    shippingRates: "shipping.rates",
-    shippingRate: "shipping.rate",
-    geoCommunes: "geo.communes",
-    cartValidate: "cart.validate",
-    pageDataGet: "pageData.get",
-    ordersCreate: "orders.create",
-    ordersTracking: "orders.tracking",
-    ordersAbandonedUpsert: "orders.abandoned.upsert",
-    ordersAbandonedConvert: "orders.abandoned.convert",
-    ordersOtpSend: "orders.otp.send",
-    ordersOtpVerify: "orders.otp.verify",
-};
-/**
- * The retry policy per operation, as a contract a caller can read.
- *
- * The transport enforces it by kind: every `safe-read` goes through the
- * caching/deduplicating GET path, which repeats a transport or 5xx failure,
- * while every `never` goes through the POST/PATCH path, which returns a result
- * and never retries (a replayed write is how a shopper ends up with two
- * orders). A test asserts this table covers every public operation and agrees
- * with that classification, so a new operation cannot ship unclassified.
- */
-export const STOREFRONT_RETRY_POLICIES = {
-    [STOREFRONT_OPERATIONS.cartValidate]: "safe-read",
-    [STOREFRONT_OPERATIONS.categoriesList]: "safe-read",
-    [STOREFRONT_OPERATIONS.configGet]: "safe-read",
-    [STOREFRONT_OPERATIONS.geoCommunes]: "safe-read",
-    [STOREFRONT_OPERATIONS.ordersAbandonedConvert]: "never",
-    [STOREFRONT_OPERATIONS.ordersAbandonedUpsert]: "never",
-    [STOREFRONT_OPERATIONS.ordersCreate]: "never",
-    [STOREFRONT_OPERATIONS.ordersOtpSend]: "never",
-    [STOREFRONT_OPERATIONS.ordersOtpVerify]: "never",
-    [STOREFRONT_OPERATIONS.ordersTracking]: "safe-read",
-    [STOREFRONT_OPERATIONS.pageDataGet]: "safe-read",
-    [STOREFRONT_OPERATIONS.pagesGet]: "safe-read",
-    [STOREFRONT_OPERATIONS.pagesLanding]: "safe-read",
-    [STOREFRONT_OPERATIONS.menusGet]: "safe-read",
-    [STOREFRONT_OPERATIONS.collectionsGet]: "safe-read",
-    [STOREFRONT_OPERATIONS.productsGet]: "safe-read",
-    [STOREFRONT_OPERATIONS.productsList]: "safe-read",
-    [STOREFRONT_OPERATIONS.productsReviewsList]: "safe-read",
-    [STOREFRONT_OPERATIONS.productsReviewsSubmit]: "never",
-    [STOREFRONT_OPERATIONS.productsReviewsEligibility]: "never",
-    [STOREFRONT_OPERATIONS.productsReviewsUpload]: "never",
-    [STOREFRONT_OPERATIONS.shippingRate]: "safe-read",
-    [STOREFRONT_OPERATIONS.shippingRates]: "safe-read",
-};

package/dist/endpoints/storefront-routes.d.ts

@@ -3,8 +3,8 @@
  *
  * Every theme needs the same routes between the shopper's browser and the
  * platform: OTP send and verify, cart validation, abandoned-checkout tracking
- * and its conversion, communes, and reviews (list, find the order, send a
- * photo or voice note, submit). What
+ * and its conversion, communes, reviews (list, find the order, send a photo
+ * or voice note, submit), and where a shopper's order is. What
  * each one must get right is decided here once — the cross-origin check on
  * every POST, the shopper's address forwarded wherever the server counts or
  * attributes per shopper, the input bounds, and the response shape the
@@ -59,6 +59,12 @@ export interface StorefrontRoutes<C extends AstroAPIContext> {
     readonly reviewUpload: StorefrontApiRoute<C>;
     /** POST a `ReviewInput` → 201 `{ success: true, data: { id, visibility } }`. */
     readonly reviewSubmit: StorefrontApiRoute<C>;
+    /**
+     * POST `{ orderNumber, phone }` → `{ data: ShopperOrderStatus }`. A wrong
+     * number or phone is refused with `ORDER_NOT_FOUND`; too many tries with
+     * `ORDER_LOOKUP_RATE_LIMITED` (429, `windowSeconds`).
+     */
+    readonly orderStatus: StorefrontApiRoute<C>;
 }
 export declare const REVIEWS_PAGE_DEFAULT = 20;
 export declare const REVIEWS_PAGE_MAX = 50;

package/dist/endpoints/storefront-routes.js

@@ -3,8 +3,8 @@
  *
  * Every theme needs the same routes between the shopper's browser and the
  * platform: OTP send and verify, cart validation, abandoned-checkout tracking
- * and its conversion, communes, and reviews (list, find the order, send a
- * photo or voice note, submit). What
+ * and its conversion, communes, reviews (list, find the order, send a photo
+ * or voice note, submit), and where a shopper's order is. What
  * each one must get right is decided here once — the cross-origin check on
  * every POST, the shopper's address forwarded wherever the server counts or
  * attributes per shopper, the input bounds, and the response shape the
@@ -22,7 +22,8 @@
  * (see `createProxyEndpoint`), and the server's diagnostic fields ride along.
  */
 import { z } from "zod";
-import { AbandonedCheckoutInputSchema, BasketLineInputSchema, DeliveryDestinationSchema, ProductQuoteInputSchema, MAX_BASKET_LINES, WilayaIdSchema, } from "../domain.js";
+import { AbandonedCheckoutInputSchema, BasketLineInputSchema, DeliveryDestinationSchema, ProductQuoteInputSchema, WilayaIdSchema, } from "../domain.js";
+import { MAX_BASKET_LINES } from "../basket-line.js";
 import { createProxyEndpoint, } from "./proxy.js";
 export const REVIEWS_PAGE_DEFAULT = 20;
 export const REVIEWS_PAGE_MAX = 50;
@@ -81,6 +82,10 @@ const reviewSubmitInput = z.object({
     grant: z.string().min(1).max(2048).optional(),
     uploads: z.array(z.string().min(1).max(64)).max(8).optional(),
 });
+const orderStatusInput = z.object({
+    orderNumber: z.string().min(1).max(64),
+    phone: z.string().min(1).max(32),
+});
 const reviewEligibilityInput = z.object({
     orderNumber: z.string().min(1).max(64),
     phone: z.string().min(1).max(32),
@@ -190,5 +195,11 @@ export function createStorefrontRoutes(options) {
             successBody: (data) => ({ success: true, data }),
             call: (client, review) => client.products.reviews.submit(defined(review)),
         }),
+        orderStatus: route({
+            method: "POST",
+            inputSchema: orderStatusInput,
+            forwardAttribution: true,
+            call: (client, proof, headers) => client.orders.status(proof, headers),
+        }),
     };
 }

package/dist/index.d.ts

@@ -11,8 +11,8 @@
  */
 export { formatMoney } from "./utils/money.js";
 export type { MoneyFormatOptions } from "./utils/money.js";
-export { optimizeImage, generateSrcSet, IMAGE_SIZES, getCardImage, getGalleryImage, getThumbnailImage, getHeroImage, getCategoryImage, getLogoImage, createImageHelpers, mediaImageUrl, mediaUrl, } from "./utils/image.js";
-export type { ImageHelpers, ImageResizeOptions, MediaImageParams } from "./utils/image.js";
+export { optimizeImage, generateSrcSet, IMAGE_SIZES, getCardImage, getGalleryImage, getThumbnailImage, getHeroImage, getCategoryImage, getLogoImage, createImageHelpers, mediaImageUrl, mediaImageSrcset, mediaUrl, pictureOf, } from "./utils/image.js";
+export type { ImageHelpers, ImageResizeOptions, MediaImageParams, MediaImageSrcsetOptions, PickedImage, Picture } from "./utils/image.js";
 export { productImageSource } from "./utils/product-image.js";
 export type { ProductImageSourceInput } from "./utils/product-image.js";
 export { MAX_RESOLVED_PREFILL_LENGTH, PREFILL_TOKENS, stripTrackingParams, truncateAtWordBoundary, resolvePrefillText, buildWhatsAppHref, } from "./whatsapp.js";
@@ -23,24 +23,36 @@ export { alternateLinks, localeRouting, localizeHref, resolveLocalePath } from "
 export type { LocalePath, LocaleRouting } from "./locale-routing.js";
 export type { StorefrontPageMatch, StorefrontPageType, StorefrontPathParams, StorefrontRoute } from "./routes.js";
 export { createBasketStore, createMemoryStorageAdapter, createLocalStorageAdapter, DEFAULT_BASKET_STORAGE_KEY, toOrderItems, } from "./basket.js";
-export type { BasketStore, BasketStorageAdapter, BasketStoreOptions, BasketListener, } from "./basket.js";
+export { MAX_BASKET_LINES, MAX_BASKET_LINE_QUANTITY, basketLineKey } from "./basket-line.js";
+export type { BasketStore, BasketStorageAdapter, BasketStoreOptions, BasketListener, BasketSelectionLine, } from "./basket.js";
 export { createOtpMachine, createOtpTransport, mapOtpResponse, otpTransportFailure, } from "./otp.js";
 export type { OtpMachine, OtpMachineOptions, OtpFailureContext, OtpResponseOptions, OtpState, OtpStatus, OtpTransport, OtpTransportResult, OtpStateListener, } from "./otp.js";
 export { WILAYAS } from "./data/wilayas.js";
 export { ALGERIA_COMMUNES, communesForWilaya } from "./data/communes.js";
+export { isWilayaId } from "./wilaya-id.js";
+export { readCartQuote, readCouponOutcome, readShippingRates } from "./answer-readers.js";
+export { createQuoter } from "./quote.js";
+export type { Quoter, QuoterOptions, QuoteResult } from "./quote.js";
+export { isOrderNumber, ORDER_NUMBER_PATTERN } from "./order-number.js";
+export { DEFAULT_COLLECTION_HANDLES, PRODUCT_SORTS, SHOPPER_ORDER_STAGES } from "./catalog.js";
+export { SEO_TEXT_LIMITS, jsonLd, productMeta, productStructuredData } from "./seo.js";
+export type { PageMeta, ProductStructuredDataOptions } from "./seo.js";
+export { REVIEW_REFUSAL_CODES, REVIEW_TEXT_LIMITS } from "./reviews.js";
+export type { ReviewRefusalCode } from "./reviews.js";
 export type { CommuneTuple } from "./data/communes.js";
 export { normalizeAlgerianPhone, toLocalAlgerianMobile } from "./phone.js";
 export * from "./types.js";
 export * from "./schemas.js";
 export * from "./domain.js";
+export * from "./operations.js";
 export * from "./product-view.js";
 export { getOfferTierView, getQuantityTierViews } from "./offer-view.js";
-export { COUPON_NOT_APPLICABLE, COUPON_URL_PARAM, couponFromUrl, couponRefusalOf } from "./coupon.js";
+export { COUPON_HINT_REASONS, COUPON_NOT_APPLICABLE, COUPON_REFUSAL_REASONS, COUPON_URL_PARAM, couponFromUrl, couponRefusalOf, couponRefusalTone, } from "./coupon.js";
 export { initialVariant, optionStates, pickOption, variantFor } from "./variant-picker.js";
 export type { OptionSelection, OptionState, PickerVariant } from "./variant-picker.js";
 export type { CartQuoteOptions } from "./client/cart.js";
 export type { OfferTierInput, OfferTierView, QuantityTierView } from "./offer-view.js";
-export { createAbandonedCheckoutTracker } from "./abandoned-checkout.js";
-export type { AbandonedCheckoutPorts, AbandonedCheckoutSnapshot, AbandonedCheckoutStorage, AbandonedCheckoutTracker, } from "./abandoned-checkout.js";
+export { ABANDONED_CHECKOUT_SESSION_KEY, convertAbandonedCheckout, createAbandonedCheckoutTracker, createBrowserAbandonedCheckoutTracker, } from "./abandoned-checkout.js";
+export type { AbandonedCheckoutConversion, AbandonedCheckoutHost, AbandonedCheckoutPorts, AbandonedCheckoutSnapshot, AbandonedCheckoutStorage, AbandonedCheckoutTracker, BrowserAbandonedCheckoutOptions, } from "./abandoned-checkout.js";
 export { META_CURRENCY, buildMetaAddToCartPayload, buildMetaInitiateCheckoutPayload, buildMetaProductPayload, buildMetaViewContentPayload, createMetaPixelTracker, } from "./meta-tracking.js";
 export type { MetaCartPayload, MetaCatalogPayload, MetaContent, MetaEventName, MetaPixelFunction, MetaPixelOptions, MetaPixelTracker, } from "./meta-tracking.js";

package/dist/index.js

@@ -10,23 +10,32 @@
  * Internal modules stay reachable only through their intentional entry points.
  */
 export { formatMoney } from "./utils/money.js";
-export { optimizeImage, generateSrcSet, IMAGE_SIZES, getCardImage, getGalleryImage, getThumbnailImage, getHeroImage, getCategoryImage, getLogoImage, createImageHelpers, mediaImageUrl, mediaUrl, } from "./utils/image.js";
+export { optimizeImage, generateSrcSet, IMAGE_SIZES, getCardImage, getGalleryImage, getThumbnailImage, getHeroImage, getCategoryImage, getLogoImage, createImageHelpers, mediaImageUrl, mediaImageSrcset, mediaUrl, pictureOf, } from "./utils/image.js";
 export { productImageSource } from "./utils/product-image.js";
 export { MAX_RESOLVED_PREFILL_LENGTH, PREFILL_TOKENS, stripTrackingParams, truncateAtWordBoundary, resolvePrefillText, buildWhatsAppHref, } from "./whatsapp.js";
 export { STOREFRONT_PAGE_PATHS, STOREFRONT_ROUTES, matchStorefrontPath, showsWidgetOn, storefrontPath } from "./routes.js";
 export { servedLanguage } from "./locales.js";
 export { alternateLinks, localeRouting, localizeHref, resolveLocalePath } from "./locale-routing.js";
 export { createBasketStore, createMemoryStorageAdapter, createLocalStorageAdapter, DEFAULT_BASKET_STORAGE_KEY, toOrderItems, } from "./basket.js";
+export { MAX_BASKET_LINES, MAX_BASKET_LINE_QUANTITY, basketLineKey } from "./basket-line.js";
 export { createOtpMachine, createOtpTransport, mapOtpResponse, otpTransportFailure, } from "./otp.js";
 export { WILAYAS } from "./data/wilayas.js";
 export { ALGERIA_COMMUNES, communesForWilaya } from "./data/communes.js";
+export { isWilayaId } from "./wilaya-id.js";
+export { readCartQuote, readCouponOutcome, readShippingRates } from "./answer-readers.js";
+export { createQuoter } from "./quote.js";
+export { isOrderNumber, ORDER_NUMBER_PATTERN } from "./order-number.js";
+export { DEFAULT_COLLECTION_HANDLES, PRODUCT_SORTS, SHOPPER_ORDER_STAGES } from "./catalog.js";
+export { SEO_TEXT_LIMITS, jsonLd, productMeta, productStructuredData } from "./seo.js";
+export { REVIEW_REFUSAL_CODES, REVIEW_TEXT_LIMITS } from "./reviews.js";
 export { normalizeAlgerianPhone, toLocalAlgerianMobile } from "./phone.js";
 export * from "./types.js";
 export * from "./schemas.js";
 export * from "./domain.js";
+export * from "./operations.js";
 export * from "./product-view.js";
 export { getOfferTierView, getQuantityTierViews } from "./offer-view.js";
-export { COUPON_NOT_APPLICABLE, COUPON_URL_PARAM, couponFromUrl, couponRefusalOf } from "./coupon.js";
+export { COUPON_HINT_REASONS, COUPON_NOT_APPLICABLE, COUPON_REFUSAL_REASONS, COUPON_URL_PARAM, couponFromUrl, couponRefusalOf, couponRefusalTone, } from "./coupon.js";
 export { initialVariant, optionStates, pickOption, variantFor } from "./variant-picker.js";
-export { createAbandonedCheckoutTracker } from "./abandoned-checkout.js";
+export { ABANDONED_CHECKOUT_SESSION_KEY, convertAbandonedCheckout, createAbandonedCheckoutTracker, createBrowserAbandonedCheckoutTracker, } from "./abandoned-checkout.js";
 export { META_CURRENCY, buildMetaAddToCartPayload, buildMetaInitiateCheckoutPayload, buildMetaProductPayload, buildMetaViewContentPayload, createMetaPixelTracker, } from "./meta-tracking.js";

package/dist/operations.d.ts

@@ -0,0 +1,72 @@
+/**
+ * The platform operations a storefront calls, and the retry policy each one
+ * keeps. Plain values and no schema: browser code reads the operation names
+ * too — an OTP route's failure names the operation it was — so this module
+ * stays free of anything that would bring a validator into a shopper's page.
+ */
+export type RetryPolicy = "safe-read" | "never";
+export declare const STOREFRONT_OPERATIONS: {
+    readonly configGet: "config.get";
+    readonly categoriesList: "categories.list";
+    readonly productsGet: "products.get";
+    readonly productsList: "products.list";
+    readonly productsSearch: "products.search";
+    readonly productsReviewsList: "products.reviews.list";
+    readonly productsReviewsSubmit: "products.reviews.submit";
+    readonly productsReviewsEligibility: "products.reviews.eligibility";
+    readonly productsReviewsUpload: "products.reviews.upload";
+    readonly pagesGet: "pages.get";
+    readonly pagesLanding: "pages.landing";
+    readonly menusGet: "menus.get";
+    readonly collectionsGet: "collections.get";
+    readonly shippingRates: "shipping.rates";
+    readonly shippingRate: "shipping.rate";
+    readonly geoCommunes: "geo.communes";
+    readonly cartValidate: "cart.validate";
+    readonly pageDataGet: "pageData.get";
+    readonly ordersCreate: "orders.create";
+    readonly ordersTracking: "orders.tracking";
+    readonly ordersStatus: "orders.status";
+    readonly ordersAbandonedUpsert: "orders.abandoned.upsert";
+    readonly ordersAbandonedConvert: "orders.abandoned.convert";
+    readonly ordersOtpSend: "orders.otp.send";
+    readonly ordersOtpVerify: "orders.otp.verify";
+};
+export type StorefrontOperation = (typeof STOREFRONT_OPERATIONS)[keyof typeof STOREFRONT_OPERATIONS];
+/**
+ * The retry policy per operation, as a contract a caller can read.
+ *
+ * The transport enforces it by kind: every `safe-read` goes through the
+ * caching/deduplicating GET path, which repeats a transport or 5xx failure,
+ * while every `never` goes through the POST/PATCH path, which returns a result
+ * and never retries (a replayed write is how a shopper ends up with two
+ * orders). A test asserts this table covers every public operation and agrees
+ * with that classification, so a new operation cannot ship unclassified.
+ */
+export declare const STOREFRONT_RETRY_POLICIES: {
+    readonly "cart.validate": "safe-read";
+    readonly "categories.list": "safe-read";
+    readonly "config.get": "safe-read";
+    readonly "geo.communes": "safe-read";
+    readonly "orders.abandoned.convert": "never";
+    readonly "orders.abandoned.upsert": "never";
+    readonly "orders.create": "never";
+    readonly "orders.otp.send": "never";
+    readonly "orders.otp.verify": "never";
+    readonly "orders.tracking": "safe-read";
+    readonly "orders.status": "never";
+    readonly "pageData.get": "safe-read";
+    readonly "pages.get": "safe-read";
+    readonly "pages.landing": "safe-read";
+    readonly "menus.get": "safe-read";
+    readonly "collections.get": "safe-read";
+    readonly "products.get": "safe-read";
+    readonly "products.list": "safe-read";
+    readonly "products.search": "safe-read";
+    readonly "products.reviews.list": "safe-read";
+    readonly "products.reviews.submit": "never";
+    readonly "products.reviews.eligibility": "never";
+    readonly "products.reviews.upload": "never";
+    readonly "shipping.rate": "safe-read";
+    readonly "shipping.rates": "safe-read";
+};

package/dist/operations.js

@@ -0,0 +1,70 @@
+/**
+ * The platform operations a storefront calls, and the retry policy each one
+ * keeps. Plain values and no schema: browser code reads the operation names
+ * too — an OTP route's failure names the operation it was — so this module
+ * stays free of anything that would bring a validator into a shopper's page.
+ */
+export const STOREFRONT_OPERATIONS = {
+    configGet: "config.get",
+    categoriesList: "categories.list",
+    productsGet: "products.get",
+    productsList: "products.list",
+    productsSearch: "products.search",
+    productsReviewsList: "products.reviews.list",
+    productsReviewsSubmit: "products.reviews.submit",
+    productsReviewsEligibility: "products.reviews.eligibility",
+    productsReviewsUpload: "products.reviews.upload",
+    pagesGet: "pages.get",
+    pagesLanding: "pages.landing",
+    menusGet: "menus.get",
+    collectionsGet: "collections.get",
+    shippingRates: "shipping.rates",
+    shippingRate: "shipping.rate",
+    geoCommunes: "geo.communes",
+    cartValidate: "cart.validate",
+    pageDataGet: "pageData.get",
+    ordersCreate: "orders.create",
+    ordersTracking: "orders.tracking",
+    ordersStatus: "orders.status",
+    ordersAbandonedUpsert: "orders.abandoned.upsert",
+    ordersAbandonedConvert: "orders.abandoned.convert",
+    ordersOtpSend: "orders.otp.send",
+    ordersOtpVerify: "orders.otp.verify",
+};
+/**
+ * The retry policy per operation, as a contract a caller can read.
+ *
+ * The transport enforces it by kind: every `safe-read` goes through the
+ * caching/deduplicating GET path, which repeats a transport or 5xx failure,
+ * while every `never` goes through the POST/PATCH path, which returns a result
+ * and never retries (a replayed write is how a shopper ends up with two
+ * orders). A test asserts this table covers every public operation and agrees
+ * with that classification, so a new operation cannot ship unclassified.
+ */
+export const STOREFRONT_RETRY_POLICIES = {
+    [STOREFRONT_OPERATIONS.cartValidate]: "safe-read",
+    [STOREFRONT_OPERATIONS.categoriesList]: "safe-read",
+    [STOREFRONT_OPERATIONS.configGet]: "safe-read",
+    [STOREFRONT_OPERATIONS.geoCommunes]: "safe-read",
+    [STOREFRONT_OPERATIONS.ordersAbandonedConvert]: "never",
+    [STOREFRONT_OPERATIONS.ordersAbandonedUpsert]: "never",
+    [STOREFRONT_OPERATIONS.ordersCreate]: "never",
+    [STOREFRONT_OPERATIONS.ordersOtpSend]: "never",
+    [STOREFRONT_OPERATIONS.ordersOtpVerify]: "never",
+    [STOREFRONT_OPERATIONS.ordersTracking]: "safe-read",
+    [STOREFRONT_OPERATIONS.ordersStatus]: "never",
+    [STOREFRONT_OPERATIONS.pageDataGet]: "safe-read",
+    [STOREFRONT_OPERATIONS.pagesGet]: "safe-read",
+    [STOREFRONT_OPERATIONS.pagesLanding]: "safe-read",
+    [STOREFRONT_OPERATIONS.menusGet]: "safe-read",
+    [STOREFRONT_OPERATIONS.collectionsGet]: "safe-read",
+    [STOREFRONT_OPERATIONS.productsGet]: "safe-read",
+    [STOREFRONT_OPERATIONS.productsList]: "safe-read",
+    [STOREFRONT_OPERATIONS.productsSearch]: "safe-read",
+    [STOREFRONT_OPERATIONS.productsReviewsList]: "safe-read",
+    [STOREFRONT_OPERATIONS.productsReviewsSubmit]: "never",
+    [STOREFRONT_OPERATIONS.productsReviewsEligibility]: "never",
+    [STOREFRONT_OPERATIONS.productsReviewsUpload]: "never",
+    [STOREFRONT_OPERATIONS.shippingRate]: "safe-read",
+    [STOREFRONT_OPERATIONS.shippingRates]: "safe-read",
+};

package/dist/order-number.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The order number a shopper is given (`ORD-20261023-0042`) and types back to
+ * review what they bought or follow their order. The server refuses any other
+ * shape with `VALIDATION_FAILED`; a form can say so before asking.
+ */
+/** `ORD-`, the day the order was placed (`YYYYMMDD`), a dash and its digits; any case. */
+export declare const ORDER_NUMBER_PATTERN: RegExp;
+/** Whether `value`, without the spaces around it, has the shape of an order number. */
+export declare function isOrderNumber(value: string): boolean;