@wocart/storefront 2.2.0 → 3.1.0

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,9 +4,13 @@ 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";
 export type { NotFoundContext, ResolvedStore, StoreRequestOptions, StoreRequestResolution } from "./store-request.js";
+export { createStorefrontMiddleware } from "./storefront-middleware.js";
+export type { PreviewLocals, StorefrontActionContext, StorefrontMiddleware, StorefrontMiddlewareContext, StorefrontMiddlewareOptions, } from "./storefront-middleware.js";
+export { revalidateEndpoint } from "./endpoints/revalidate-endpoint.js";
+export type { RevalidateEndpointContext, RevalidateEndpointOptions } from "./endpoints/revalidate-endpoint.js";

package/dist/astro.js

@@ -1,6 +1,8 @@
 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";
+export { createStorefrontMiddleware } from "./storefront-middleware.js";
+export { revalidateEndpoint } from "./endpoints/revalidate-endpoint.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/revalidate-endpoint.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The revalidation route a theme exports, ready-made:
+ *
+ * ```ts
+ * // src/pages/wocart-revalidate.ts
+ * import { revalidateEndpoint } from "@wocart/storefront/astro";
+ *
+ * export const prerender = false;
+ * export const { POST, ALL } = revalidateEndpoint({ publicKey: () => WOCART_PREVIEW_KEY, theme: THEME_KEY });
+ * ```
+ *
+ * `POST` verifies the platform's token (`readRevalidateRequest`), drops every
+ * page cached under `PAGES_CACHE_TAG` and answers 204; a refused token
+ * answers its status and drops nothing. `ALL` answers any other method 405.
+ * Neither answer is ever cached.
+ */
+import { type RevalidateRequestOptions } from "../revalidate.js";
+/** What the route uses of Astro's `APIContext`. */
+export interface RevalidateEndpointContext {
+    request: Request;
+    cache: {
+        invalidate(options: {
+            tags: string[];
+        }): Promise<void>;
+    };
+}
+export interface RevalidateEndpointOptions {
+    /** The deployment's preview public key; a function reads it on each request. Absent: every request answers 404. */
+    publicKey: RevalidateRequestOptions["publicKey"] | (() => RevalidateRequestOptions["publicKey"]);
+    /** This theme's key. */
+    theme: string;
+}
+/** The theme's `/wocart-revalidate` route: `POST` drops the cached pages for a verified token, `ALL` answers 405. */
+export declare function revalidateEndpoint(options: RevalidateEndpointOptions): {
+    POST: (context: RevalidateEndpointContext) => Promise<Response>;
+    ALL: () => Response;
+};

package/dist/endpoints/revalidate-endpoint.js

@@ -0,0 +1,32 @@
+/**
+ * The revalidation route a theme exports, ready-made:
+ *
+ * ```ts
+ * // src/pages/wocart-revalidate.ts
+ * import { revalidateEndpoint } from "@wocart/storefront/astro";
+ *
+ * export const prerender = false;
+ * export const { POST, ALL } = revalidateEndpoint({ publicKey: () => WOCART_PREVIEW_KEY, theme: THEME_KEY });
+ * ```
+ *
+ * `POST` verifies the platform's token (`readRevalidateRequest`), drops every
+ * page cached under `PAGES_CACHE_TAG` and answers 204; a refused token
+ * answers its status and drops nothing. `ALL` answers any other method 405.
+ * Neither answer is ever cached.
+ */
+import { PAGES_CACHE_TAG, readRevalidateRequest } from "../revalidate.js";
+const noStore = (status, headers = {}) => new Response(null, { status, headers: { "Cache-Control": "no-store", ...headers } });
+/** The theme's `/wocart-revalidate` route: `POST` drops the cached pages for a verified token, `ALL` answers 405. */
+export function revalidateEndpoint(options) {
+    return {
+        POST: async (context) => {
+            const publicKey = typeof options.publicKey === "function" ? options.publicKey() : options.publicKey;
+            const revalidation = await readRevalidateRequest(context.request, { publicKey, theme: options.theme });
+            if (!revalidation.ok)
+                return noStore(revalidation.status);
+            await context.cache.invalidate({ tags: [PAGES_CACHE_TAG] });
+            return noStore(204);
+        },
+        ALL: () => noStore(405, { Allow: "POST" }),
+    };
+}

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 { SINGLE_LANGUAGE_PAGE_TYPES, STOREFRONT_API_PATHS, STOREFRONT_PAGE_PATHS, isSingleLanguagePage, matchStorefrontPath, showsWidgetOn, storefrontApiPath, 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 { StorefrontApiName, StorefrontApiParams, 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";
@@ -36,6 +38,8 @@ export { readCartQuote, readCouponOutcome, readShippingRates } from "./answer-re
 export { createQuoter } from "./quote.js";
 export type { Quoter, QuoterOptions, QuoteResult } from "./quote.js";
 export { isOrderNumber, ORDER_NUMBER_PATTERN } from "./order-number.js";
+export { readThankYou, thankYouHref } from "./thank-you.js";
+export type { ThankYouOrder } from "./thank-you.js";
 export { DEFAULT_COLLECTION_HANDLES, PRODUCT_SORTS, SHOPPER_ORDER_JOURNEY, SHOPPER_ORDER_STAGES } from "./catalog.js";
 export { SEO_TEXT_LIMITS, canonicalUrl, jsonLd, productMeta, productStructuredData } from "./seo.js";
 export type { CanonicalPage, PageMeta, ProductStructuredDataOptions } from "./seo.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 { SINGLE_LANGUAGE_PAGE_TYPES, STOREFRONT_API_PATHS, STOREFRONT_PAGE_PATHS, isSingleLanguagePage, matchStorefrontPath, showsWidgetOn, storefrontApiPath, 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";
@@ -26,6 +27,7 @@ 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 { readThankYou, thankYouHref } from "./thank-you.js";
 export { DEFAULT_COLLECTION_HANDLES, PRODUCT_SORTS, SHOPPER_ORDER_JOURNEY, SHOPPER_ORDER_STAGES } from "./catalog.js";
 export { SEO_TEXT_LIMITS, canonicalUrl, jsonLd, productMeta, productStructuredData } from "./seo.js";
 export { REVIEW_REFUSAL_CODES, REVIEW_TEXT_LIMITS } from "./reviews.js";

package/dist/locale-routing.d.ts

@@ -1,16 +1,3 @@
-/**
- * Language-prefixed storefront URLs — Shopify's
- * subfolders: the primary language keeps today's URLs (`/products/x`), every
- * other published language lives under its code (`/fr/products/x`), and the
- * primary has exactly one address (`/ar/products/x` redirects to
- * `/products/x`).
- *
- * Pure functions over the store's own languages (`StoreConfig.lang` and
- * `StoreConfig.locales`): a theme reads the request's language with
- * `resolveLocalePath`, builds every internal link with `localizeHref`, and
- * lists a page's language versions with `alternateLinks` — the counterpart of
- * Shopify's `request.locale.root_url` and `routes`.
- */
 import type { StoreConfig } from "./types.js";
 /** The store's languages as URLs need them. */
 export interface LocaleRouting {
@@ -27,7 +14,7 @@ export type LocalePath =
     locale: string;
     pathname: string;
 }
-/** The primary under a prefix: send the shopper to its one address. */
+/** The primary under a prefix, or a single-language page under any: send the shopper to its one address. */
  | {
     kind: "redirect";
     location: string;
@@ -35,23 +22,27 @@ export type LocalePath =
 /**
  * Which language a request is for, and the path it renders. A first segment
  * that is a published language other than the primary selects it; the
- * primary's own prefix redirects; anything else — an unpublished or unknown
- * code included — is an ordinary path in the primary language, so it renders
- * or 404s exactly as before.
+ * primary's own prefix redirects, and so does any prefix on a page that
+ * exists in the primary language only (`isSingleLanguagePage`: `/fr/lp/x` →
+ * `/lp/x`); anything else — an unpublished or unknown code included — is an
+ * ordinary path in the primary language, so it renders or 404s exactly as
+ * before.
  */
 export declare function resolveLocalePath(pathname: string, routing: LocaleRouting): LocalePath;
 /**
  * An internal link in `locale`: `/products/x` → `/fr/products/x`, `/` → `/fr`.
  * Left unchanged: the primary language, external and protocol-relative URLs,
- * fragments, `mailto:`/`tel:`, endpoints and files, and a link that already
- * carries a language prefix. Query strings and fragments are kept.
+ * fragments, `mailto:`/`tel:`, endpoints and files, a page that exists in the
+ * primary language only (a landing page), and a link that already carries a
+ * language prefix. Query strings and fragments are kept.
  */
 export declare function localizeHref(href: string, locale: string, routing: LocaleRouting): string;
 /**
  * Every published language's URL for one page, primary first, plus
  * `x-default` (the primary) — the `<link rel="alternate" hreflang>` set.
  * `pathname` is the page's unprefixed path; `origin` makes the URLs absolute,
- * as search engines require.
+ * as search engines require. None for a page that exists in the primary
+ * language only.
  */
 export declare function alternateLinks(pathname: string, routing: LocaleRouting, origin: string): {
     hreflang: string;

package/dist/locale-routing.js

@@ -1,3 +1,17 @@
+/**
+ * Language-prefixed storefront URLs — Shopify's
+ * subfolders: the primary language keeps today's URLs (`/products/x`), every
+ * other published language lives under its code (`/fr/products/x`), and the
+ * primary has exactly one address (`/ar/products/x` redirects to
+ * `/products/x`).
+ *
+ * Pure functions over the store's own languages (`StoreConfig.lang` and
+ * `StoreConfig.locales`): a theme reads the request's language with
+ * `resolveLocalePath`, builds every internal link with `localizeHref`, and
+ * lists a page's language versions with `alternateLinks` — the counterpart of
+ * Shopify's `request.locale.root_url` and `routes`.
+ */
+import { isSingleLanguagePage } from "./routes.js";
 export function localeRouting(config) {
     const published = config.locales.map((language) => language.code);
     return {
@@ -12,16 +26,18 @@ function isPagePath(pathname) {
 /**
  * Which language a request is for, and the path it renders. A first segment
  * that is a published language other than the primary selects it; the
- * primary's own prefix redirects; anything else — an unpublished or unknown
- * code included — is an ordinary path in the primary language, so it renders
- * or 404s exactly as before.
+ * primary's own prefix redirects, and so does any prefix on a page that
+ * exists in the primary language only (`isSingleLanguagePage`: `/fr/lp/x` →
+ * `/lp/x`); anything else — an unpublished or unknown code included — is an
+ * ordinary path in the primary language, so it renders or 404s exactly as
+ * before.
  */
 export function resolveLocalePath(pathname, routing) {
     const match = /^\/([^/]+)(\/.*)?$/.exec(pathname);
     const segment = match?.[1];
     if (segment !== undefined && routing.published.includes(segment)) {
         const rest = match?.[2] ?? "/";
-        if (segment === routing.primary)
+        if (segment === routing.primary || isSingleLanguagePage(rest))
             return { kind: "redirect", location: rest };
         return { kind: "page", locale: segment, pathname: rest };
     }
@@ -30,8 +46,9 @@ export function resolveLocalePath(pathname, routing) {
 /**
  * An internal link in `locale`: `/products/x` → `/fr/products/x`, `/` → `/fr`.
  * Left unchanged: the primary language, external and protocol-relative URLs,
- * fragments, `mailto:`/`tel:`, endpoints and files, and a link that already
- * carries a language prefix. Query strings and fragments are kept.
+ * fragments, `mailto:`/`tel:`, endpoints and files, a page that exists in the
+ * primary language only (a landing page), and a link that already carries a
+ * language prefix. Query strings and fragments are kept.
  */
 export function localizeHref(href, locale, routing) {
     if (locale === routing.primary || !href.startsWith("/") || href.startsWith("//"))
@@ -39,7 +56,7 @@ export function localizeHref(href, locale, routing) {
     const split = /^([^?#]*)(.*)$/.exec(href);
     const pathname = split[1];
     const rest = split[2];
-    if (!isPagePath(pathname))
+    if (!isPagePath(pathname) || isSingleLanguagePage(pathname))
         return href;
     const first = /^\/([^/]+)/.exec(pathname)?.[1];
     if (first !== undefined && routing.published.includes(first))
@@ -50,9 +67,12 @@ export function localizeHref(href, locale, routing) {
  * Every published language's URL for one page, primary first, plus
  * `x-default` (the primary) — the `<link rel="alternate" hreflang>` set.
  * `pathname` is the page's unprefixed path; `origin` makes the URLs absolute,
- * as search engines require.
+ * as search engines require. None for a page that exists in the primary
+ * language only.
  */
 export function alternateLinks(pathname, routing, origin) {
+    if (isSingleLanguagePage(pathname))
+        return [];
     const base = origin.replace(/\/+$/, "");
     const links = routing.published.map((locale) => ({
         hreflang: locale,

package/dist/middleware.d.ts

@@ -53,10 +53,11 @@ export interface ActionDescriptor<TResult extends ActionHandlerResult = ActionHa
     handler: () => Promise<TResult>;
 }
 /**
- * `TSerialized` is the framework's result-cookie token, opaque to this SDK:
- * Astro 5 used a string, Astro 7 an object (`SerializedActionResult`). The
- * generics thread whatever `getActionContext()` hands the theme straight
- * through, so no theme ever casts.
+ * What `runFormAction` needs from `getActionContext()`. `TSerialized` is the
+ * framework's result-cookie token, opaque to this SDK: Astro 5 used a string,
+ * Astro 7 an object (`SerializedActionResult`). The generics thread whatever
+ * `getActionContext()` hands the theme straight through, so no theme ever
+ * casts.
  */
 export interface ActionMiddlewareDeps<TResult extends ActionHandlerResult = ActionHandlerResult, TSerialized = string> {
     action?: ActionDescriptor<TResult>;
@@ -64,31 +65,10 @@ export interface ActionMiddlewareDeps<TResult extends ActionHandlerResult = Acti
     setActionResult: (name: string, serialized: TSerialized) => void;
     /** Serializes an ActionResult into the cookie value (Astro's serializeActionResult). */
     serializeActionResult: (result: TResult) => TSerialized;
-    /** @deprecated Unused since 1.2.0: nothing redirects. */
-    referer?: string | null;
-    /** @deprecated Unused since 1.2.0: nothing redirects. */
-    pathname?: string;
 }
-export type PrgDecision = 
-/** Never produced since 1.2.0 — kept so existing `decision.kind` checks compile. */
-{
-    kind: "redirect";
-    location: string;
-    status: 303;
-}
-/** Render the page from this POST. */
- | {
-    kind: "next";
-};
 /**
  * Run an action called from an HTML form and store its result for the page
  * this POST renders. Resolves to that result, or `undefined` when the request
  * is not a form-called action (a JSON call or a plain request is Astro's).
  */
-export declare function runFormAction<TResult extends ActionHandlerResult, TSerialized>(deps: Pick<ActionMiddlewareDeps<TResult, TSerialized>, "action" | "setActionResult" | "serializeActionResult">): Promise<TResult | undefined>;
-/**
- * @deprecated Use `runFormAction` and call `next()`. Runs the action the same
- * way and always answers `{ kind: "next" }`: an errored post renders in place,
- * because a redirect drops the result (see the note at the top of this file).
- */
-export declare function resolveActionRedirectDecision<TResult extends ActionHandlerResult, TSerialized>(deps: ActionMiddlewareDeps<TResult, TSerialized>): Promise<PrgDecision>;
+export declare function runFormAction<TResult extends ActionHandlerResult, TSerialized>(deps: ActionMiddlewareDeps<TResult, TSerialized>): Promise<TResult | undefined>;

package/dist/middleware.js

@@ -51,12 +51,3 @@ export async function runFormAction(deps) {
     setActionResult(action.name, serializeActionResult(result));
     return result;
 }
-/**
- * @deprecated Use `runFormAction` and call `next()`. Runs the action the same
- * way and always answers `{ kind: "next" }`: an errored post renders in place,
- * because a redirect drops the result (see the note at the top of this file).
- */
-export async function resolveActionRedirectDecision(deps) {
-    await runFormAction(deps);
-    return { kind: "next" };
-}

package/dist/product-view.d.ts

@@ -10,11 +10,3 @@ export interface ProductView {
 }
 export declare function getProductView(product: ProductDetail): ProductView;
 export declare function getProductListView(product: ProductList): ProductView;
-/**
- * A product's tags as a list, whichever read it came from: a product page's
- * `tags` is already a list, a listing's is the stored JSON text. Anything
- * that is not a list of text reads as no tags.
- */
-export declare function productTags(product: {
-    tags: string | null | readonly string[];
-}): string[];

package/dist/product-view.js

@@ -44,20 +44,3 @@ export function getProductListView(product) {
         ...stockOf(product),
     };
 }
-/**
- * A product's tags as a list, whichever read it came from: a product page's
- * `tags` is already a list, a listing's is the stored JSON text. Anything
- * that is not a list of text reads as no tags.
- */
-export function productTags(product) {
-    let tags = product.tags;
-    if (typeof tags === "string") {
-        try {
-            tags = JSON.parse(tags);
-        }
-        catch {
-            return [];
-        }
-    }
-    return Array.isArray(tags) ? tags.filter((tag) => typeof tag === "string") : [];
-}

package/dist/revalidate.d.ts

@@ -1,5 +1,11 @@
 /** Where a theme that can drop its cached pages answers a revalidation. */
 export declare const REVALIDATE_PATH = "/wocart-revalidate";
+/**
+ * The cache tag every cached page carries, and the one a revalidation drops:
+ * a publish (pages, settings or text) can change any page, so a theme tags
+ * every cached route with it (`routeRules` in `astro.config.mjs`).
+ */
+export declare const PAGES_CACHE_TAG = "pages";
 /** What a verified revalidation token says. */
 export interface RevalidateClaims {
     /** The storefront origin the token was made for. */

package/dist/revalidate.js

@@ -17,6 +17,12 @@
 import { timingRefusal, verifiedPayload } from "./signed-token.js";
 /** Where a theme that can drop its cached pages answers a revalidation. */
 export const REVALIDATE_PATH = "/wocart-revalidate";
+/**
+ * The cache tag every cached page carries, and the one a revalidation drops:
+ * a publish (pages, settings or text) can change any page, so a theme tags
+ * every cached route with it (`routeRules` in `astro.config.mjs`).
+ */
+export const PAGES_CACHE_TAG = "pages";
 /** The longest a revalidation token may live. */
 const MAX_LIFETIME_SECONDS = 5 * 60;
 const refuse = (status, reason) => ({ ok: false, status, reason });