@wocart/storefront 2.2.0 → 3.0.0

package/CHANGELOG.md

@@ -5,6 +5,73 @@ follows [semantic versioning](https://semver.org/): breaking changes ship only
 in a new major version, and an export is marked `@deprecated` for at least one
 minor release before a major removes it.
 
+## 3.0.0 — 2026-11-01
+
+The SDK reads exactly what platform v7.0.0 serves: `/store/config` and the
+product reads name every field they answer, and the SDK asks for no field the
+server no longer sends nor tolerates an answer from an older server. The
+WhatsApp button speaks every language, and a theme reaches it one way.
+Requires platform v7.0.0.
+
+### Added
+
+- `whatsAppContact(config, page, words)`: the store's WhatsApp on one page —
+  the `wa.me` link with the page's message, and every text resolved: the
+  merchant's in the page's language, else the theme's `words`; the agent the
+  merchant's, else the store's name. Null when the store has none. Every
+  WhatsApp link a theme draws comes from it. Types `WhatsAppContact`,
+  `WhatsAppPage`, `WhatsAppWords`.
+- `unavailableStoreConfig({ serverUrl, locale })`: the store a page renders
+  when its config cannot be read — nothing to buy, its one language described
+  by the runtime. A theme passes it as `resolveStoreRequest`'s `fallback`
+  instead of writing its own.
+- Page types `search` (`/search`) and `contact` (`/contact`); like
+  `trackOrder`, they show the widget by the App's `pages` switch.
+- `StoreConfig.contact`: `{ phone, email, address }`, each null until the
+  merchant writes it.
+- `CartValidation.freeDelivery.by`: why delivery is free — `offer`, `coupon`
+  or `threshold` — or null.
+
+### Changed (breaking)
+
+- The WhatsApp widget's texts arrive in the page's language, or null where
+  the merchant wrote none in it — never another language's.
+- `ProductList.variantOptions` and `ProductList.tags` arrive parsed, as on a
+  product page.
+- `Product.variants` holds only the active variants, in the merchant's
+  order: `ProductVariant` drops `productId`, `currency`, `barcode`,
+  `weightKg`, `active`, `position`, `createdAt` and `updatedAt`, and the
+  variant picker takes the variants as they come.
+- Required, where they were optional for older servers:
+  `StoreConfig.themeSettings`, `ProductPage.total` (0 on a failed read, never
+  null), `StoreCollection.productCount` and `image`, `Offer.rewardUnitPrice`,
+  `Product.quantityPricing`, the product `metaTitle` and `metaDescription`,
+  `LandingPage.document`, `Review.verified` and `media`,
+  `ReviewSubmitResult.visibility`,
+  `CreatedOrder.couponDiscount`, a cart quote's `coupon`, a line's `offerId`,
+  `offerName` and `discount`, and a gift's `offerName`, `variantId` and
+  `variantLabel`. `ReviewInput.phone` is required.
+
+### Removed
+
+- `StoreConfig.primaryColor`, `accentColor`, `bgColor`, `fontFamily`,
+  `fontUrl` and `announcementBar` (a theme's settings now), `themeId`,
+  `cartShippingMode`, `status`, `createdAt`, `updatedAt`, and `legalContact`
+  (`contact` replaces it; the delivery days stay on the store's legal
+  pages).
+- `Product.costPrice`, `storeFeatured`, `deletedAt`, `visibility`, `status`,
+  `showInStore`, `publishedAt`, `createdAt`, `updatedAt` and
+  `shippingProfileId`, and `ProductListFilters.featured` (use
+  `collection: "featured"`).
+- `localWhatsAppWidget`, `resolvePrefillText`, `buildWhatsAppHref`,
+  `stripTrackingParams`, `truncateAtWordBoundary` and `ResolvePrefillParams`:
+  `whatsAppContact` applies the message rules itself. Removed without a
+  deprecated minor first: the platform they served changes with this major.
+- `productTags`: both product shapes carry their tags as a list.
+- `STOREFRONT_ROUTES` and `StorefrontRoute` (use `STOREFRONT_PAGE_PATHS`),
+  `resolveActionRedirectDecision` and `PrgDecision` (use `runFormAction`), and
+  `ActionMiddlewareDeps.referer` and `pathname`.
+
 ## 2.2.0 — 2026-11-01
 
 ### Added

package/USAGE.md

@@ -112,6 +112,8 @@ break those links.
 | `checkout` | `/checkout` | the cart's checkout | required when the store turns the cart on |
 | `thankYou` | `/thank-you` | the order confirmation | required |
 | `trackOrder` | `/track-order` | where a shopper follows an order by its number and phone; `?order=<number>` fills the number in | required |
+| `search` | `/search` | the products a shopper's words find; `?q=<words>` is the query | required — a menu can open it |
+| `contact` | `/contact` | how to reach the store: its WhatsApp (`whatsAppContact`) and `config.contact` | required — a menu can open it |
 
 How a theme implements them, in Astro's own terms:
 
@@ -139,8 +141,8 @@ How a theme implements them, in Astro's own terms:
 `showsWidgetOn(surfaces, pathname)` is the platform's half of "should the
 WhatsApp widget show here": the merchant switches surfaces on; the page type
 says which surface a pathname is. `STOREFRONT_PAGE_PATHS` is the table above
-as data. `STOREFRONT_ROUTES` is deprecated: it lists six of the paths, without
-the home and the catalog.
+as data. Order tracking, search and contact count as store pages: the App's
+`pages` switch shows the widget on them.
 
 ## The five rules to remember
 
@@ -181,7 +183,7 @@ request-scoped client is the simplest safe default:
 ~~~ts
 const [config, featuredProducts] = await Promise.all([
   store.config.get(),
-  store.products.list({ featured: true, limit: 8 }),
+  store.products.list({ collection: "featured", limit: 8 }),
 ]);
 ~~~
 
@@ -223,9 +225,10 @@ server directly.
 | `isWilayaId` | Whether a value is a wilaya id — the range `WilayaIdSchema` checks on the server, without a schema in the browser |
 | `readShippingRates`, `readCouponOutcome` | Read in the browser what the server handed it — the rates a page carries, a quote's coupon outcome — accepting exactly what `ShippingRatesSchema` / `CouponOutcomeSchema` accept, without Zod |
 | `normalizeAlgerianPhone`, `toLocalAlgerianMobile` | The one Algerian phone rule (accept/format) |
-| `localWhatsAppWidget`, `resolvePrefillText`, `buildWhatsAppHref`, `stripTrackingParams`, `truncateAtWordBoundary`, `PREFILL_TOKENS`, `MAX_RESOLVED_PREFILL_LENGTH` | the widget in the page's language, WhatsApp prefill text and the `wa.me` link |
+| `whatsAppContact`, `PREFILL_TOKENS`, `MAX_RESOLVED_PREFILL_LENGTH` | The store's WhatsApp on one page: the `wa.me` link with the page's message and every text in the page's language — the only way a theme links to WhatsApp |
 | `storefrontPath`, `matchStorefrontPath`, `STOREFRONT_PAGE_PATHS` | The page types and their public paths: build a link, recognise a page |
-| `showsWidgetOn`, `STOREFRONT_ROUTES` | Which widget surface a pathname is (`STOREFRONT_ROUTES` deprecated) |
+| `showsWidgetOn` | Which widget surface a pathname is |
+| `unavailableStoreConfig` | The store a page renders when its config cannot be read — `resolveStoreRequest`'s `fallback` |
 | `productImageSource` | Which photo represents a product (cover → gallery fallback) |
 | `getProductView`, `getProductListView` | Pure price, discount, default-variant, and stock values for detail and list projections |
 | `getOfferTierView` | Pure offer-tier price, compare-price, savings, and free-shipping projection; display-only, never order authority |
@@ -372,8 +375,9 @@ Read methods use safe empty results so a theme can still render its shell:
 | orders.tracking(orderId) | null |
 
 These results do not mean the theme should crash. They mean the theme should
-show a deliberate fallback: a default brand shell, an empty catalog state, a
-not-found page, a delivery-rate fallback, or no conversion event.
+show a deliberate fallback: the unavailable store (`unavailableStoreConfig`),
+an empty catalog state, a not-found page, a delivery-rate fallback, or no
+conversion event.
 
 ### When a read degrades: `onError`
 
@@ -515,29 +519,29 @@ const cartEnabled = config?.cartEnabled === true;
 const currencySymbol = config?.currencySymbol ?? "دج";
 ~~~
 
-StoreConfig contains the current store identity and presentation fields,
-including:
+StoreConfig holds what a theme reads of the store, every merchant text in
+the page's language (`locale`):
 
-- name, domain, logo (a MediaImage) and themeId (the colors, fontFamily and fontUrl
-  fields are deprecated: colors and fonts are theme settings, read from
-  themeSettings);
-- lang (the primary language), locales, contentOverrides, themeSettings,
-  currency, currencySymbol, metaTitle, metaDescription, and ogImage (a
-  MediaImage);
+- id, name, domain and logo (a MediaImage);
+- lang (the primary language), locale, locales, currency, currencySymbol,
+  metaTitle, metaDescription, and ogImage (a MediaImage);
 - media, the store's MediaDelivery, which every image helper takes;
-- reviewsEnabled (announcementBar is deprecated and always null: an
-  announcement is a theme's own setting);
-- cartEnabled, freeShippingThreshold, and cartShippingMode;
+- reviewsEnabled, cartEnabled and freeShippingThreshold;
+- contentOverrides and themeSettings, the merchant's edits to your theme;
 - checkoutForm policy;
-- OTP and Turnstile settings;
+- whatsapp, the WhatsApp button App — read it through `whatsAppContact`;
 - pixelId and conversionEvent;
-- public page links, legal contact information, and WhatsApp widget settings.
+- pages (the footer's page links) and contact (`{ phone, email, address }`,
+  each null until the merchant writes it);
+- OTP and Turnstile settings.
+
+A store's colours, fonts and announcement are your theme's settings, never
+config fields: declare them with `defineTheme({ settings })`.
 
 `themeSettings` holds the merchant's values for your theme's settings (the
 ones it declares with `defineTheme({ settings })` in `@wocart/theme`), by
 setting key, exactly as saved. It is sent only to a client created with
-`theme`, is `{}` when the store saved none, and is absent from a server that
-predates theme settings — `resolveThemeSettings` takes either. Never read it raw: resolve it
+`theme`, and is `{}` when the store saved none. Never read it raw: resolve it
 against your declaration, which checks every value and falls back to your
 default for one it no longer accepts:
 
@@ -767,18 +771,17 @@ const onSale = await store.products.list({ onSale: true, limit: 8 });
   `store.collections.get(handle)` — title and description in the client's
   language, `null` for an unknown handle (answer a real 404) — and list it
   with `products.list({ collection: handle })`.
-- `featured: true` and `ProductList.storeFeatured` are deprecated: they mean
-  the `featured` collection.
+- The store's featured products are its `featured` collection:
+  `products.list({ collection: "featured" })`.
 
 A collection's page also has its size and a photo: `collections.get(handle)`
 answers `productCount` (what a shopper sees in it) and `image` (its first
-listed product's first photo, a `ProductImage`), both absent from a server
-that predates them.
+listed product's first photo, a `ProductImage`, null while it lists none with
+one).
 
 **Pages, totals and order.** `products.page(filters)` answers one page,
 whether another follows, and how many products the whole listing holds
-(`total`, null from a server that predates counts) — enough for "page 2 of 5"
-or "36 products":
+(`total`) — enough for "page 2 of 5" or "36 products":
 
 ~~~ts
 const page = await store.products.page({ collection: "best-sellers", sort: "price-ascending", limit: 24, offset: 24 });
@@ -791,15 +794,13 @@ const page = await store.products.page({ collection: "best-sellers", sort: "pric
 `DEFAULT_COLLECTION_HANDLES` names the collections every store starts with,
 the likeliest to hold products first, for a page that needs one and was named
 none. Without one a listing keeps
-its own order: a collection's, a search's best match first, else newest. A
-server that predates sorting ignores it.
+its own order: a collection's, a search's best match first, else newest.
 
 **Search.** `products.search(text, filters)` answers a page of the products
 whose name — in the client's language or the catalog's — or tags hold every
 word, with the same filters, sort and paging; names that hold every word come
-first. Blank text finds nothing without asking. Search has its own path, so a
-server that predates it answers an empty page (reported through `onError`),
-never the whole catalog:
+first. Blank text finds nothing without asking, and a failed search answers an
+empty page (reported through `onError`), never the whole catalog:
 
 ~~~ts
 const results = await store.products.search(Astro.url.searchParams.get("q") ?? "", { limit: 24 });
@@ -807,9 +808,10 @@ const results = await store.products.search(Astro.url.searchParams.get("q") ?? "
 
 Product lists return ProductList objects. ProductList and Product are
 different shapes: a list item is not a detail object and must not be cast to
-Product. ProductList carries list-oriented fields such as coverImage and
-reviewStats, while variantOptions and tags remain their raw serialized form.
-Read tags with `productTags(product)`, which gives a list from either shape.
+Product. Both carry the same product fields — variantOptions and tags parsed,
+metaTitle, metaDescription and reviewStats — and a ProductList adds its
+coverImage, a Product its photos, active variants (in the merchant's order),
+offers, quantity pricing and category.
 
 The limit is optional. An explicit limit of 0 is preserved, so do not replace
 it with a truthiness fallback.
@@ -1679,8 +1681,7 @@ with the error in place.
 Never redirect from the middleware, on success or on error. Astro 7 keeps an
 action result for the response being rendered only, so a redirect arrives at
 the next page with no result: the thank-you redirect never fires, and a
-refused order shows no message. resolveActionRedirectDecision, the earlier
-name, is deprecated and now always answers next.
+refused order shows no message.
 
 ### The request's store and language
 
@@ -1698,7 +1699,8 @@ theme builds its own context from it:
 // src/middleware.ts
 import { resolvePreviewStore, resolveStoreRequest, runFormAction } from "@wocart/storefront/astro";
 
-const options = { client: createStore, fallback: FALLBACK_CONFIG }; // the theme's one client factory, and its shell config
+// The theme's one client factory, and the store it renders when the config cannot be read.
+const options = { client: createStore, fallback: unavailableStoreConfig({ serverUrl: env.COD_SERVER_URL }) };
 
 export const onRequest = defineMiddleware(async (context, next) => {
   if (context.url.pathname === THEME_PREVIEW_PATH) {
@@ -1717,7 +1719,11 @@ export const onRequest = defineMiddleware(async (context, next) => {
 
 `client(locale?)` makes the request's client, in a language or the
 store's primary; `fallback` is the config rendered when the store cannot be
-read — a shell with the checkout off. `embedded(pathname)` overrides which
+read. `unavailableStoreConfig({ serverUrl, locale })` is that config, in your
+theme's default language (the platform's, Arabic, when you name none): no
+name, nothing to buy — cart, checkout, code by SMS, reviews and WhatsApp off —
+and an empty `id`, by which a theme tells it from a real store. It always has
+the config's whole shape, so never write your own. `embedded(pathname)` overrides which
 paths serve part of a page. `resolvePreviewStore(draft, options)` is the
 editor's preview: the draft's language when the store serves it, the draft's
 settings and text over the saved ones, tracking off.
@@ -1919,52 +1925,59 @@ image; `null` means the product genuinely has no photograph, so that is the
 moment to render a placeholder. The list model carries no gallery at all, so a
 card gets the cover or `null`.
 
-## WhatsApp prefill messages
+## WhatsApp
 
-The storefront's WhatsApp launcher hands the shopper to WhatsApp with a message
-already written, and the thank-you page offers the same handoff for an order.
-The template belongs to the merchant — the dashboard authors and previews it
-within the platform's limits — while the page resolves it:
-
-The merchant writes the widget's texts once, in the store's primary language.
-Read the widget with `localWhatsAppWidget(config)`: on a page in another
-language its texts (labels, welcome, prefills) are null, so the theme shows its
-own words in the shopper's language; the agent's name and the settings stay.
+The WhatsApp button App owns the store's WhatsApp: its number, its texts,
+which pages show the floating launcher, how it looks. Your theme owns only
+how it is drawn. Every link a theme draws to WhatsApp — the launcher, a
+footer or menu link, a contact card, the thank-you and tracking buttons —
+comes from one function, `whatsAppContact(config, page, words)`, and none is
+written by hand:
 
 ~~~ts
-import {
-  buildWhatsAppHref,
-  localWhatsAppWidget,
-  resolvePrefillText,
-} from "@wocart/storefront";
-
-const widget = localWhatsAppWidget(config);
-if (!widget) return;
-
-const text = resolvePrefillText({
-  template: widget.prefillProduct ?? "Hello {store}, about {product}: {url}",
-  storeName: config.name,
-  productName: product.name, // falls back to the store name when absent
-  url: Astro.url.href,       // ad-click parameters (`utm_*`, `fbclid`) stripped
-  orderNumber: null,         // resolves to nothing when absent
-});
-
-const href = buildWhatsAppHref(widget.href, text);
-~~~
-
-Three rules come with it, and a theme must not re-implement them:
-
-- the resolved message is capped at `MAX_RESOLVED_PREFILL_LENGTH` characters and
-  cut at a word boundary, because browsers and WhatsApp both truncate silently
-  past a point;
-- `{url}` never carries ad-click parameters;
-- the encoded `text=` is appended to the base href, preserving a query string
-  the href already carries.
-
-`PREFILL_TOKENS` is the token vocabulary the dashboard offers (`product`, `url`,
-`order`, `store`); an unknown placeholder is left verbatim so a template typo is
-visible rather than silently swallowed. The cap and the token list are the
-same ones the dashboard enforces.
+import { showsWidgetOn, whatsAppContact } from "@wocart/storefront";
+
+const whatsapp = whatsAppContact(
+  config,
+  { kind: "product", url: canonical, product: product.name },
+  {
+    launcher: null, // the launcher shows its icon alone unless the merchant names it
+    caption: t("whatsapp.caption"),
+    welcome: t("whatsapp.welcome"),
+    cta: t("whatsapp.cta"),
+    orderButton: t("whatsapp.order"),
+    messages: { general: t("whatsapp.message"), product: t("whatsapp.messageProduct"), order: t("whatsapp.messageOrder") },
+  },
+);
+const launcherShown = whatsapp !== null && showsWidgetOn(whatsapp.surfaces, store.pathname);
+// whatsapp.href, whatsapp.ctaLabel, whatsapp.welcomeMessage, whatsapp.agentName …
+~~~
+
+It answers `null` when the store has no WhatsApp (the App is off, or has no
+usable number). Otherwise every text is resolved for this page:
+
+- **The merchant's text, else your words.** `/store/config` serves each of
+  the App's texts in the page's language, or null where the merchant wrote
+  none in it — never another language's. A null reads your `words`, which
+  your theme has in every language it speaks. `caption`, `welcome` and
+  `launcher` may be null in your words too: the panel then shows nothing
+  there.
+- **The page's message.** `page.kind` is `product` (a product or landing
+  page, with `product` its name), `order` (the thank-you or tracking page,
+  with `order` its number) or `general`. The merchant's template for that
+  kind is used, else their general one, else yours for that kind.
+- **The agent** is the merchant's, else the store's name.
+
+The message follows three rules no theme re-implements: it is capped at
+`MAX_RESOLVED_PREFILL_LENGTH` characters, cut at a word boundary, because
+browsers and WhatsApp both truncate silently past a point; `{url}` never
+carries ad-click parameters (`utm_*`, `fbclid`); and the encoded `text=` keeps
+a query string the number's link already carries.
+
+`PREFILL_TOKENS` is the token vocabulary the dashboard offers (`product`,
+`url`, `order`, `store`); an unknown placeholder is left verbatim so a
+template typo is visible rather than silently swallowed. The cap and the
+token list are the same ones the dashboard enforces.
 
 ## The sitemap
 

package/dist/answer-readers.js

@@ -2,59 +2,33 @@ const isObject = (value) => typeof value === "object" && value !== null && !Arra
 const isFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value);
 const isInteger = (value) => typeof value === "number" && Number.isSafeInteger(value);
 const isNullableString = (value) => value === null || typeof value === "string";
-/** An optional field the schema reads as `.nullish()`: absent stays absent, null and the type are kept, anything else refuses. */
-function nullish(source, key, accepts) {
-    if (!(key in source) || source[key] === undefined)
-        return { ok: true, entry: {} };
-    const value = source[key];
-    return value === null || accepts(value) ? { ok: true, entry: { [key]: value } } : { ok: false, entry: {} };
-}
-const isString = (value) => typeof value === "string";
 const BLOCKERS = ["missing", "unlisted", "out_of_stock"];
+const FREE_BY = ["offer", "coupon", "threshold"];
 function readQuoteLine(value) {
     if (!isObject(value))
         return null;
-    const { productId, variantId, variantLabel, productName, quantity, unitPrice, lineTotal, maxQuantity, blocker } = value;
+    const { productId, variantId, variantLabel, productName, quantity, unitPrice, lineTotal, offerId, offerName, discount, maxQuantity, blocker } = value;
     if (typeof productId !== "string" || !isNullableString(variantId) || !isNullableString(variantLabel) || typeof productName !== "string")
         return null;
     if (!isInteger(quantity) || !isFiniteNumber(unitPrice) || !isFiniteNumber(lineTotal))
         return null;
+    if (!isNullableString(offerId) || !isNullableString(offerName) || !isFiniteNumber(discount))
+        return null;
     if (maxQuantity !== null && !isFiniteNumber(maxQuantity))
         return null;
     if (blocker !== null && !(typeof blocker === "string" && BLOCKERS.includes(blocker)))
         return null;
-    const offerId = nullish(value, "offerId", isString);
-    const offerName = nullish(value, "offerName", isString);
-    const discount = nullish(value, "discount", isFiniteNumber);
-    if (!offerId.ok || !offerName.ok || !discount.ok)
-        return null;
-    return {
-        productId,
-        variantId,
-        variantLabel,
-        productName,
-        quantity,
-        unitPrice,
-        lineTotal,
-        ...offerId.entry,
-        ...offerName.entry,
-        ...discount.entry,
-        maxQuantity,
-        blocker: blocker,
-    };
+    return { productId, variantId, variantLabel, productName, quantity, unitPrice, lineTotal, offerId, offerName, discount, maxQuantity, blocker: blocker };
 }
 function readReward(value) {
     if (!isObject(value))
         return null;
-    const { offerId, productId, productName, quantity } = value;
-    if (typeof offerId !== "string" || !isNullableString(productId) || !isNullableString(productName) || !isInteger(quantity))
+    const { offerId, offerName, productId, productName, variantId, variantLabel, quantity } = value;
+    if (typeof offerId !== "string" || !isNullableString(offerName) || !isNullableString(productId) || !isNullableString(productName))
         return null;
-    const offerName = nullish(value, "offerName", isString);
-    const variantId = nullish(value, "variantId", isString);
-    const variantLabel = nullish(value, "variantLabel", isString);
-    if (!offerName.ok || !variantId.ok || !variantLabel.ok)
+    if (!isNullableString(variantId) || !isNullableString(variantLabel) || !isInteger(quantity))
         return null;
-    return { offerId, ...offerName.entry, productId, productName, ...variantId.entry, ...variantLabel.entry, quantity };
+    return { offerId, offerName, productId, productName, variantId, variantLabel, quantity };
 }
 function readDelivery(value) {
     if (!isObject(value))
@@ -93,25 +67,24 @@ export function readCartQuote(value) {
         return null;
     if (free.threshold !== null && !isFiniteNumber(free.threshold))
         return null;
+    if (free.by !== null && !(typeof free.by === "string" && FREE_BY.includes(free.by)))
+        return null;
     let delivery = null;
     if ("delivery" in value && value.delivery !== undefined) {
         delivery = readDelivery(value.delivery);
         if (delivery === null)
             return null;
     }
-    let coupon;
-    if ("coupon" in value && value.coupon !== undefined) {
-        coupon = value.coupon === null ? null : readCouponOutcome(value.coupon);
-        if (coupon === null && value.coupon !== null)
-            return null;
-    }
+    const coupon = value.coupon === null ? null : readCouponOutcome(value.coupon);
+    if (coupon === null && value.coupon !== null)
+        return null;
     return {
         lines,
         subtotal: value.subtotal,
         rewards,
-        freeDelivery: { fromOffer: free.fromOffer, threshold: free.threshold, qualified: free.qualified, remaining: free.remaining },
+        freeDelivery: { fromOffer: free.fromOffer, threshold: free.threshold, qualified: free.qualified, remaining: free.remaining, by: free.by },
         ...(delivery === null ? {} : { delivery }),
-        ...(coupon === undefined ? {} : { coupon }),
+        coupon,
     };
 }
 /** The delivery rates of a value (`ShippingRates`), or null when it is not a rate table. */

package/dist/astro.d.ts

@@ -4,8 +4,8 @@ export { createStorefrontRoutes, REVIEWS_PAGE_DEFAULT, REVIEWS_PAGE_MAX, } from
 export type { StorefrontApiRoute, StorefrontRoutes, StorefrontRoutesOptions, } from "./endpoints/storefront-routes.js";
 export { placeOrderInput, executePlaceOrder, collectForwardedHeaders, } from "./actions.js";
 export type { PlaceOrderInput, PlaceOrderResult } from "./actions.js";
-export { runFormAction, resolveActionRedirectDecision } from "./middleware.js";
-export type { PrgDecision, ActionMiddlewareDeps, ActionDescriptor } from "./middleware.js";
+export { runFormAction } from "./middleware.js";
+export type { ActionMiddlewareDeps, ActionDescriptor } from "./middleware.js";
 export { lookupOrder, orderLookupInput } from "./order-lookup.js";
 export type { OrderLookup, OrderLookupInput } from "./order-lookup.js";
 export { notFound, resolvePreviewStore, resolveStoreRequest } from "./store-request.js";

package/dist/astro.js

@@ -1,6 +1,6 @@
 export { createProxyEndpoint } from "./endpoints/proxy.js";
 export { createStorefrontRoutes, REVIEWS_PAGE_DEFAULT, REVIEWS_PAGE_MAX, } from "./endpoints/storefront-routes.js";
 export { placeOrderInput, executePlaceOrder, collectForwardedHeaders, } from "./actions.js";
-export { runFormAction, resolveActionRedirectDecision } from "./middleware.js";
+export { runFormAction } from "./middleware.js";
 export { lookupOrder, orderLookupInput } from "./order-lookup.js";
 export { notFound, resolvePreviewStore, resolveStoreRequest } from "./store-request.js";

package/dist/client/index.d.ts

@@ -22,7 +22,7 @@
  *
  * const [config, products] = await Promise.all([
  *   store.config.get(),
- *   store.products.list({ featured: true, limit: 8 }),
+ *   store.products.list({ collection: "featured", limit: 8 }),
  * ]);
  * ```
  */

package/dist/client/index.js

@@ -22,7 +22,7 @@
  *
  * const [config, products] = await Promise.all([
  *   store.config.get(),
- *   store.products.list({ featured: true, limit: 8 }),
+ *   store.products.list({ collection: "featured", limit: 8 }),
  * ]);
  * ```
  */

package/dist/client/products.d.ts

@@ -41,9 +41,8 @@ export interface ProductsNamespace {
      * The products a shopper's words find — every word in the product's name,
      * in the client's language or the catalog's, or in its tags — as a page,
      * with the listing filters, sort and paging. Without a `sort`, products
-     * whose name holds every word come first. Blank words find nothing; a
-     * server that predates search answers an empty page (reported through
-     * `onError`), never the whole catalog.
+     * whose name holds every word come first. Blank words find nothing, never
+     * the whole catalog.
      */
     search(text: string, filters?: ProductListFilters): Promise<ProductPage>;
     /**

package/dist/client/products.js

@@ -29,7 +29,6 @@ export function createProductsNamespace(core) {
         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,
@@ -53,11 +52,11 @@ export function createProductsNamespace(core) {
                 operation,
             });
             const rows = envelope?.data ?? [];
-            return { items: rows.slice(0, size), hasNext: rows.length > size, total: envelope?.total ?? null };
+            return { items: rows.slice(0, size), hasNext: rows.length > size, total: envelope?.total ?? 0 };
         }
         catch (error) {
             reportDegradedRead(core.config, error, operation);
-            return { items: [], hasNext: false, total: null };
+            return { items: [], hasNext: false, total: 0 };
         }
     };
     return {

package/dist/endpoints/storefront-routes.js

@@ -75,7 +75,7 @@ const reviewsListInput = z.object({
  */
 const reviewSubmitInput = z.object({
     orderNumber: z.string().min(1).max(64),
-    phone: z.string().min(1).max(32).optional(),
+    phone: z.string().min(1).max(32),
     productId: z.string().min(1).max(200),
     rating: z.number(),
     title: z.string().max(500).optional(),

package/dist/index.d.ts

@@ -15,13 +15,15 @@ export { isMediaKey, mediaImageSrcset, mediaImageUrl, mediaUrl, pictureOf } from
 export type { MediaDelivery, MediaDeliveryKind, MediaImage, 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, localWhatsAppWidget, } from "./whatsapp.js";
-export type { PrefillToken, ResolvePrefillParams } from "./whatsapp.js";
-export { STOREFRONT_PAGE_PATHS, STOREFRONT_ROUTES, matchStorefrontPath, showsWidgetOn, storefrontPath } from "./routes.js";
+export { MAX_RESOLVED_PREFILL_LENGTH, PREFILL_TOKENS, whatsAppContact } from "./whatsapp.js";
+export type { PrefillToken, WhatsAppContact, WhatsAppPage, WhatsAppWords } from "./whatsapp.js";
+export { STOREFRONT_PAGE_PATHS, matchStorefrontPath, showsWidgetOn, storefrontPath } from "./routes.js";
 export { servedLanguage } from "./locales.js";
+export { unavailableStoreConfig } from "./unavailable-store.js";
+export type { UnavailableStoreOptions } from "./unavailable-store.js";
 export { alternateLinks, localeRouting, localizeHref, resolveLocalePath } from "./locale-routing.js";
 export type { LocalePath, LocaleRouting } from "./locale-routing.js";
-export type { StorefrontPageMatch, StorefrontPageType, StorefrontPathParams, StorefrontRoute } from "./routes.js";
+export type { StorefrontPageMatch, StorefrontPageType, StorefrontPathParams } from "./routes.js";
 export { addedLines, 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 type { BasketStore, BasketStorageAdapter, BasketStoreOptions, BasketListener, BasketSelectionLine, } from "./basket.js";

package/dist/index.js

@@ -12,9 +12,10 @@
 export { formatMoney } from "./utils/money.js";
 export { isMediaKey, mediaImageSrcset, mediaImageUrl, mediaUrl, pictureOf } from "./utils/image.js";
 export { productImageSource } from "./utils/product-image.js";
-export { MAX_RESOLVED_PREFILL_LENGTH, PREFILL_TOKENS, stripTrackingParams, truncateAtWordBoundary, resolvePrefillText, buildWhatsAppHref, localWhatsAppWidget, } from "./whatsapp.js";
-export { STOREFRONT_PAGE_PATHS, STOREFRONT_ROUTES, matchStorefrontPath, showsWidgetOn, storefrontPath } from "./routes.js";
+export { MAX_RESOLVED_PREFILL_LENGTH, PREFILL_TOKENS, whatsAppContact } from "./whatsapp.js";
+export { STOREFRONT_PAGE_PATHS, matchStorefrontPath, showsWidgetOn, storefrontPath } from "./routes.js";
 export { servedLanguage } from "./locales.js";
+export { unavailableStoreConfig } from "./unavailable-store.js";
 export { alternateLinks, localeRouting, localizeHref, resolveLocalePath } from "./locale-routing.js";
 export { addedLines, createBasketStore, createMemoryStorageAdapter, createLocalStorageAdapter, DEFAULT_BASKET_STORAGE_KEY, toOrderItems, } from "./basket.js";
 export { MAX_BASKET_LINES, MAX_BASKET_LINE_QUANTITY, basketLineKey } from "./basket-line.js";