@tokenoftrust/storefront-runner 2.5.5 → 3.0.0

package/apps/storefront/src/pages/collections/[handle].astro

@@ -1,209 +1,24 @@
 ---
 /**
- * PLP / collection page (brief §5). Responsive grid, collection hero, sort,
- * URL-addressable facets, numbered pagination + load-more. Product data from
- * ToT (active-only); hero copy from the collection record (Storyblok could
- * override later — documented seam).
+ * PLP / collection page 1. Page N≥2 lives at `/collections/<h>/page/<n>/`
+ * (collections/[handle]/page/[n].astro); both render through _CollectionView.
  */
-import Layout from "@/layouts/Layout.astro";
-import Breadcrumbs from "@/components/content/storefront/Breadcrumbs.astro";
-import { homeCrumbLabel, siteTrail } from "@/lib/content/shared/breadcrumbs";
-import ProductCard from "@/components/catalog/storefront/ProductCard.astro";
-import EmptyState from "@/components/content/storefront/EmptyState.astro";
-import FacetSidebar from "@/components/catalog/storefront/plp/FacetSidebar.astro";
-import ActiveFilters from "@/components/catalog/storefront/plp/ActiveFilters.astro";
-import SortSelect from "@/components/catalog/storefront/plp/SortSelect.astro";
-import Pagination from "@/components/catalog/storefront/plp/Pagination.astro";
-import Img from "@/components/assets/storefront/Img.astro";
-import { parseQuery, buildQueryString } from "@/lib/publication/shared/url";
-import { breadcrumbLd, itemListLd } from "@/lib/content/shared/jsonld";
-import { truncate } from "@/lib/content/shared/format";
-import { pageUrlForm } from "@/lib/content/seo/urlForm";
-import { sourceSeoTitle } from "@/lib/content/seo/documentTitle";
-import { withBase } from "@/lib/publication/shared/basePath";
-import { isBlankDescriptionHtml, sanitizeDescriptionHtml } from "@/lib/content/sanitizeDescriptionHtml";
+import CollectionView from "./_CollectionView.astro";
+import { loadCollectionListing } from "@/lib/catalog/shared/collectionPaging";
+import { effectiveCollectionQuery } from "@/lib/publication/shared/staticQuery";
+
+// Sort, facets, price and inline search ride the query string, which a static host
+// never passes to a renderer: CatalogQueryView applies them client-side there.
+export const STATIC_QUERY = "client-applied";
 
 const { handle } = Astro.params;
-const { tenant, tot, canonicalBase } = Astro.locals;
 // Commerce-only route: marketing tenants have no catalog surface.
 if (!Astro.locals.features.catalog) return new Response(null, { status: 404 });
 if (!handle) return new Response(null, { status: 404 });
 
-const collection = await tot.getCollectionByHandle(handle);
-if (!collection || collection.visibility === "hidden") return new Response(null, { status: 404 });
-
-const url = new URL(Astro.request.url);
-const query = parseQuery(url);
-query.collection = handle;
-if (!query.pageSize) query.pageSize = 9;
-
-const { products, page, pageSize, total, facets } = await tot.listProducts(query);
-
-// A synthesized-EMPTY collection (zero active members overall — not merely
-// zero under the current facet/price/q filters) still resolves 200 for a direct
-// link, but must not be indexed: it's a crawlable dead end, kept out of the
-// sitemap + directory too. Detect it via the UNFILTERED membership total.
-const { total: memberTotal } = await tot.listProducts({ collection: handle, pageSize: 1 });
-const isEmptyCollection = memberTotal === 0;
-const basePath = pageUrlForm(`/collections/${handle}`, tenant.seo);
-// Tenant-prefixed page path for facet/sort/pagination, which build links by
-// string-concatenating onto this base (so they stay inside a path-routed
-// tenant). `basePath` itself stays unprefixed for the SEO canonical `path`,
-// breadcrumbs, and EmptyState — those prefix on their own via withBase.
-const linkBase = withBase(Astro.locals.basePath, basePath);
-
-const crumbs = siteTrail(
-  homeCrumbLabel(await Astro.locals.content.getChrome()),
-  { label: collection.title, href: basePath },
-);
-
-const heroImg = collection.image;
-const desc = collection.description_text || collection.description_html?.replace(/<[^>]+>/g, "");
-// Full-fidelity body (brands/how-it-works/ingredients/FAQ sections on the merchant's
-// live collection pages), sanitized for render-time defense-in-depth on top of the
-// migration pipeline's own sanitize-html pass at ingestion (see
-// sanitizeDescriptionHtml.ts). Rendered as its own block BELOW the product grid,
-// matching the live site's layout — `desc` above stays the short hero excerpt.
-const contentBlockHtml = sanitizeDescriptionHtml(collection.description_html);
-const hasContentBlock = contentBlockHtml.length > 0 && !isBlankDescriptionHtml(contentBlockHtml);
-
-// Zero-results recovery: differentiate the cause (search term vs. facet/price
-// filters) and offer targeted "undo just this" links alongside the existing
-// "clear everything" CTA, instead of one generic message + one broad reset.
-const hasFacetOrPriceFilters =
-  !!query.filters ||
-  query.priceMin != null ||
-  query.priceMax != null ||
-  query.availability === "in-stock";
-const zeroResultsTitle = query.q ? `No matches for "${query.q}"` : "Nothing matches — yet";
-const zeroResultsBody = query.q
-  ? "Try a broader search term, or clear your filters to browse the full collection."
-  : "No pieces fit these filters. Loosen a filter or clear them to see the full collection.";
-const zeroResultsActions: { label: string; href: string }[] = [];
-if (query.q && hasFacetOrPriceFilters) {
-  const { q: _q, ...rest } = query;
-  zeroResultsActions.push({ label: "Clear search, keep filters", href: basePath + buildQueryString(rest) });
-}
-if (query.priceMin != null || query.priceMax != null) {
-  const { priceMin: _priceMin, priceMax: _priceMax, ...rest } = query;
-  zeroResultsActions.push({ label: "Remove price range", href: basePath + buildQueryString(rest) });
-}
+const query = effectiveCollectionQuery(Astro.url);
+const listing = await loadCollectionListing(Astro.locals.tot, handle, query);
+if (!listing) return new Response(null, { status: 404 });
 ---
 
-<Layout
-  title={collection.seo.title || collection.title}
-  seoTitle={sourceSeoTitle(tenant.seo, collection.seo.title)}
-  description={collection.seo.description || (desc ? truncate(desc, 160) : `Shop ${collection.title} at ${tenant.displayName}.`)}
-  path={basePath}
-  noindex={isEmptyCollection}
-  jsonLd={[
-    breadcrumbLd(crumbs, canonicalBase),
-    itemListLd(products, canonicalBase, (page - 1) * pageSize),
-  ]}
-  structuredData={{
-    pageType: "collection",
-    description: collection.seo.description || undefined,
-    crumbs,
-    items: products.map((p) => ({ title: p.title, url: new URL(`/products/${p.handle}`, canonicalBase + "/").toString() })),
-  }}
->
-  {/* Collection hero */}
-  <header class="bg-[var(--color-primary)] text-[var(--color-primary-contrast)]">
-    <div class="container-prose grid gap-6 py-[clamp(2.5rem,6vw,4.5rem)] md:grid-cols-[1fr_auto] md:items-end">
-      <div data-reveal>
-        <p class="eyebrow mb-3 text-[color-mix(in_srgb,var(--color-primary-contrast)_70%,transparent)]">
-          Collection
-        </p>
-        <h1 class="display-xl">
-          {collection.title}
-        </h1>
-        {desc && (
-          <p class="mt-4 max-w-prose text-[1.05rem] text-[color-mix(in_srgb,var(--color-primary-contrast)_82%,transparent)]">
-            {truncate(desc, 220)}
-          </p>
-        )}
-      </div>
-      {heroImg && (
-        <div class="hidden w-48 overflow-hidden rounded-[var(--radius-md)] md:block" data-reveal>
-          <Img
-            src={heroImg.url}
-            rehosted={heroImg.rehosted}
-            seed={heroImg.id ?? collection.handle}
-            label={collection.title}
-            alt={heroImg.alt ?? collection.title}
-            width={heroImg.width ?? 400}
-            height={heroImg.height ?? 300}
-          />
-        </div>
-      )}
-    </div>
-  </header>
-
-  <div class="container-prose py-4">
-    <Breadcrumbs crumbs={crumbs} />
-  </div>
-
-  <div class="container-prose grid gap-10 pb-16 lg:grid-cols-[230px_1fr]">
-    {/* Facets — sticky on desktop; a <details> drawer on mobile. */}
-    <div class="lg:sticky lg:top-24 lg:self-start">
-      <details class="lg:hidden">
-        <summary class="cursor-pointer rounded-[var(--radius-md)] border border-[var(--color-border)] bg-[var(--color-surface)] px-4 py-2.5 font-display text-sm font-medium">
-          Filters & sort
-        </summary>
-        <div class="mt-4">
-          <FacetSidebar facets={facets} query={query} basePath={linkBase} />
-        </div>
-      </details>
-      <div class="hidden lg:block">
-        <FacetSidebar facets={facets} query={query} basePath={linkBase} />
-      </div>
-    </div>
-
-    <div>
-      <div class="mb-5 flex flex-wrap items-center justify-between gap-3 border-b border-[var(--color-border)] pb-4">
-        <p class="text-sm text-[var(--color-muted)]">
-          {total} {total === 1 ? "item" : "items"}
-        </p>
-        <SortSelect query={query} basePath={linkBase} />
-      </div>
-
-      <ActiveFilters query={query} basePath={linkBase} />
-
-      {products.length === 0 ? (
-        <EmptyState
-          title={zeroResultsTitle}
-          body={zeroResultsBody}
-          ctaLabel="Clear all filters"
-          ctaHref={basePath}
-          secondaryActions={zeroResultsActions}
-        />
-      ) : (
-        <>
-          <div class="grid grid-cols-2 gap-5 sm:grid-cols-2 lg:grid-cols-3">
-            {products.map((p, i) => (
-              <ProductCard
-                product={p}
-                position={(page - 1) * pageSize + i}
-                list={collection.handle}
-                priority={i < 3 && page === 1}
-              />
-            ))}
-          </div>
-          <Pagination
-            query={query}
-            basePath={linkBase}
-            page={page}
-            pageSize={pageSize}
-            total={total}
-          />
-        </>
-      )}
-    </div>
-  </div>
-
-  {hasContentBlock && (
-    <section class="container-prose pb-16">
-      <div class="rte mx-auto max-w-[68ch] text-[var(--color-text)]" set:html={contentBlockHtml} />
-    </section>
-  )}
-</Layout>
+<CollectionView {...listing} query={query} pathPage={1} />

package/apps/storefront/src/pages/collections/_CollectionView.astro

@@ -0,0 +1,251 @@
+---
+/**
+ * PLP / collection view (brief §5), shared by `/collections/<h>/` (page 1) and
+ * `/collections/<h>/page/<n>/` so the two can't drift. Responsive grid,
+ * collection hero, sort, URL-addressable facets, numbered pagination + load-more.
+ * Hero copy from the collection record (Storyblok could override later —
+ * documented seam).
+ *
+ * The rendered results carry the key of the query they applied
+ * (`data-applied-query`). A static host serves this page for any query, so
+ * `CatalogQueryView` re-applies the URL's own query client-side whenever it
+ * differs from that key (lib/publication/shared/staticQuery.ts).
+ */
+import type { ListProductsQuery, ListProductsResponse, CatalogCollection } from "@tot/public-runtime";
+import Layout from "@/layouts/Layout.astro";
+import Breadcrumbs from "@/components/content/storefront/Breadcrumbs.astro";
+import { homeCrumbLabel, siteTrail } from "@/lib/content/shared/breadcrumbs";
+import ProductCard from "@/components/catalog/storefront/ProductCard.astro";
+import EmptyState from "@/components/content/storefront/EmptyState.astro";
+import FacetSidebar from "@/components/catalog/storefront/plp/FacetSidebar.astro";
+import ActiveFilters from "@/components/catalog/storefront/plp/ActiveFilters.astro";
+import SortSelect from "@/components/catalog/storefront/plp/SortSelect.astro";
+import Pagination from "@/components/catalog/storefront/plp/Pagination.astro";
+import CatalogQueryView from "@/components/publication/storefront/islands/CatalogQueryView.tsx";
+import Img from "@/components/assets/storefront/Img.astro";
+import { buildQueryString } from "@/lib/publication/shared/url";
+import { collectionPageCount, collectionPagePath, isPathPageable } from "@/lib/catalog/shared/collectionPaging";
+import { listQueryKey } from "@/lib/publication/shared/staticQuery";
+import { breadcrumbLd, itemListLd } from "@/lib/content/shared/jsonld";
+import { truncate } from "@/lib/content/shared/format";
+import { pageUrlForm } from "@/lib/content/seo/urlForm";
+import { sourceSeoTitle } from "@/lib/content/seo/documentTitle";
+import { withBase } from "@/lib/publication/shared/basePath";
+import { isBlankDescriptionHtml, sanitizeDescriptionHtml } from "@/lib/content/sanitizeDescriptionHtml";
+
+interface Props {
+  collection: CatalogCollection;
+  query: ListProductsQuery;
+  result: ListProductsResponse;
+  memberTotal: number;
+  /** The page the route's PATH names (1 for the bare collection path). */
+  pathPage: number;
+}
+
+const { collection, query, result, memberTotal, pathPage } = Astro.props;
+const { tenant, canonicalBase } = Astro.locals;
+const { handle } = collection;
+const { products, page, pageSize, total, facets } = result;
+
+// A synthesized-EMPTY collection (zero active members overall — not merely
+// zero under the current facet/price/q filters) still resolves 200 for a direct
+// link, but must not be indexed: it's a crawlable dead end, kept out of the
+// sitemap + directory too. Detect it via the UNFILTERED membership total.
+const isEmptyCollection = memberTotal === 0;
+const basePath = pageUrlForm(collectionPagePath(handle, 1), tenant.seo);
+// Tenant-prefixed page path for facet/sort/pagination, which build links by
+// string-concatenating onto this base (so they stay inside a path-routed
+// tenant). `basePath` itself stays unprefixed for the SEO canonical `path`,
+// breadcrumbs, and EmptyState — those prefix on their own via withBase.
+const linkBase = withBase(Astro.locals.basePath, basePath);
+
+// Page N of the default view is its own indexable path variant; every other view
+// keeps its query (noindex territory) and canonicalizes to the collection.
+const pathPaged = isPathPageable(query);
+const pagePath = (n: number) => pageUrlForm(collectionPagePath(handle, n), tenant.seo);
+const pageCount = collectionPageCount(total, pageSize);
+const path = pathPaged ? pagePath(page) : basePath;
+const pagination = pathPaged
+  ? {
+      ...(page > 1 ? { prev: pagePath(page - 1) } : {}),
+      ...(page < pageCount ? { next: pagePath(page + 1) } : {}),
+    }
+  : undefined;
+const pageHref = pathPaged ? (n: number) => withBase(Astro.locals.basePath, pagePath(n)) : undefined;
+
+const crumbs = siteTrail(
+  homeCrumbLabel(await Astro.locals.content.getChrome()),
+  { label: collection.title, href: basePath },
+);
+
+const heroImg = collection.image;
+const desc = collection.description_text || collection.description_html?.replace(/<[^>]+>/g, "");
+// Full-fidelity body (brands/how-it-works/ingredients/FAQ sections on the merchant's
+// live collection pages), sanitized for render-time defense-in-depth on top of the
+// migration pipeline's own sanitize-html pass at ingestion (see
+// sanitizeDescriptionHtml.ts). Rendered as its own block BELOW the product grid,
+// matching the live site's layout — `desc` above stays the short hero excerpt.
+const contentBlockHtml = sanitizeDescriptionHtml(collection.description_html);
+const hasContentBlock = contentBlockHtml.length > 0 && !isBlankDescriptionHtml(contentBlockHtml);
+
+// Zero-results recovery: differentiate the cause (search term vs. facet/price
+// filters) and offer targeted "undo just this" links alongside the existing
+// "clear everything" CTA, instead of one generic message + one broad reset.
+const hasFacetOrPriceFilters =
+  !!query.filters ||
+  query.priceMin != null ||
+  query.priceMax != null ||
+  query.availability === "in-stock";
+const zeroResultsTitle = query.q ? `No matches for "${query.q}"` : "Nothing matches — yet";
+const zeroResultsBody = query.q
+  ? "Try a broader search term, or clear your filters to browse the full collection."
+  : "No pieces fit these filters. Loosen a filter or clear them to see the full collection.";
+const zeroResultsActions: { label: string; href: string }[] = [];
+if (query.q && hasFacetOrPriceFilters) {
+  const { q: _q, ...rest } = query;
+  zeroResultsActions.push({ label: "Clear search, keep filters", href: basePath + buildQueryString(rest) });
+}
+if (query.priceMin != null || query.priceMax != null) {
+  const { priceMin: _priceMin, priceMax: _priceMax, ...rest } = query;
+  zeroResultsActions.push({ label: "Remove price range", href: basePath + buildQueryString(rest) });
+}
+
+const baseTitle = collection.seo.title || collection.title;
+const documentTitle = pathPaged && page > 1 ? `${baseTitle} — Page ${page}` : baseTitle;
+const seoTitle = sourceSeoTitle(tenant.seo, collection.seo.title);
+---
+
+<Layout
+  title={documentTitle}
+  seoTitle={seoTitle && pathPaged && page > 1 ? `${seoTitle} — Page ${page}` : seoTitle}
+  description={collection.seo.description || (desc ? truncate(desc, 160) : `Shop ${collection.title} at ${tenant.displayName}.`)}
+  path={path}
+  noindex={isEmptyCollection}
+  pagination={pagination}
+  jsonLd={[
+    breadcrumbLd(crumbs, canonicalBase),
+    itemListLd(products, canonicalBase, (page - 1) * pageSize),
+  ]}
+  structuredData={{
+    pageType: "collection",
+    description: collection.seo.description || undefined,
+    crumbs,
+    items: products.map((p) => ({ title: p.title, url: new URL(`/products/${p.handle}`, canonicalBase + "/").toString() })),
+  }}
+>
+  {/* Collection hero */}
+  <header class="bg-[var(--color-primary)] text-[var(--color-primary-contrast)]">
+    <div class="container-prose grid gap-6 py-[clamp(2.5rem,6vw,4.5rem)] md:grid-cols-[1fr_auto] md:items-end">
+      <div data-reveal>
+        <p class="eyebrow mb-3 text-[color-mix(in_srgb,var(--color-primary-contrast)_70%,transparent)]">
+          Collection
+        </p>
+        <h1 class="display-xl">
+          {collection.title}
+        </h1>
+        {desc && (
+          <p class="mt-4 max-w-prose text-[1.05rem] text-[color-mix(in_srgb,var(--color-primary-contrast)_82%,transparent)]">
+            {truncate(desc, 220)}
+          </p>
+        )}
+      </div>
+      {heroImg && (
+        <div class="hidden w-48 overflow-hidden rounded-[var(--radius-md)] md:block" data-reveal>
+          <Img
+            src={heroImg.url}
+            rehosted={heroImg.rehosted}
+            seed={heroImg.id ?? collection.handle}
+            label={collection.title}
+            alt={heroImg.alt ?? collection.title}
+            width={heroImg.width ?? 400}
+            height={heroImg.height ?? 300}
+          />
+        </div>
+      )}
+    </div>
+  </header>
+
+  <div class="container-prose py-4">
+    <Breadcrumbs crumbs={crumbs} />
+  </div>
+
+  <div
+    class="container-prose grid gap-10 pb-16 lg:grid-cols-[230px_1fr]"
+    data-catalog-query-rendered
+    data-applied-query={listQueryKey(query)}
+  >
+    {/* Facets — sticky on desktop; a <details> drawer on mobile. */}
+    <div class="lg:sticky lg:top-24 lg:self-start">
+      <details class="lg:hidden">
+        <summary class="cursor-pointer rounded-[var(--radius-md)] border border-[var(--color-border)] bg-[var(--color-surface)] px-4 py-2.5 font-display text-sm font-medium">
+          Filters & sort
+        </summary>
+        <div class="mt-4">
+          <FacetSidebar facets={facets} query={query} basePath={linkBase} />
+        </div>
+      </details>
+      <div class="hidden lg:block">
+        <FacetSidebar facets={facets} query={query} basePath={linkBase} />
+      </div>
+    </div>
+
+    <div>
+      <div class="mb-5 flex flex-wrap items-center justify-between gap-3 border-b border-[var(--color-border)] pb-4">
+        <p class="text-sm text-[var(--color-muted)]">
+          {total} {total === 1 ? "item" : "items"}
+        </p>
+        <SortSelect query={query} basePath={linkBase} />
+      </div>
+
+      <ActiveFilters query={query} basePath={linkBase} />
+
+      {products.length === 0 ? (
+        <EmptyState
+          title={zeroResultsTitle}
+          body={zeroResultsBody}
+          ctaLabel="Clear all filters"
+          ctaHref={basePath}
+          secondaryActions={zeroResultsActions}
+        />
+      ) : (
+        <>
+          <div class="grid grid-cols-2 gap-5 sm:grid-cols-2 lg:grid-cols-3">
+            {products.map((p, i) => (
+              <ProductCard
+                product={p}
+                position={(page - 1) * pageSize + i}
+                list={collection.handle}
+                priority={i < 3 && page === 1}
+              />
+            ))}
+          </div>
+          <Pagination
+            query={query}
+            basePath={linkBase}
+            page={page}
+            pageSize={pageSize}
+            total={total}
+            pageHref={pageHref}
+          />
+        </>
+      )}
+    </div>
+  </div>
+
+  <CatalogQueryView
+    client:only="preact"
+    mode="collection"
+    collection={handle}
+    pathPage={pathPage}
+    linkBase={linkBase}
+    pageBase={withBase(Astro.locals.basePath, collectionPagePath(handle, 1))}
+    trailingSlash={!!tenant.seo?.trailingSlash}
+    locale={tenant.locale}
+  />
+
+  {hasContentBlock && (
+    <section class="container-prose pb-16">
+      <div class="rte mx-auto max-w-[68ch] text-[var(--color-text)]" set:html={contentBlockHtml} />
+    </section>
+  )}
+</Layout>

package/apps/storefront/src/pages/collections/index.astro

@@ -34,7 +34,7 @@ const crumbs = siteTrail(
   description={`Browse every collection at ${tenant.displayName}.`}
   path="/collections"
   jsonLd={breadcrumbLd(crumbs, canonicalBase)}
-  structuredData={{ pageType: "collection" }}
+  structuredData={{ pageType: "collection", crumbs }}
 >
   <div class="container-prose pt-6">
     <Breadcrumbs crumbs={crumbs} />

package/apps/storefront/src/pages/products/[handle].astro

@@ -11,7 +11,7 @@ import { homeCrumbLabel, siteTrail } from "@/lib/content/shared/breadcrumbs";
 import Badge from "@/components/content/storefront/Badge.astro";
 import ProductCard from "@/components/catalog/storefront/ProductCard.astro";
 import Section from "@/components/content/storefront/Section.astro";
-import ImageGallery from "@/components/catalog/storefront/islands/ImageGallery.tsx";
+import ImageGallery, { publicGalleryImages } from "@/components/catalog/storefront/islands/ImageGallery.tsx";
 import VariantSelector, { publicSelectorVariants } from "@/components/catalog/storefront/islands/VariantSelector.tsx";
 import CheckoutComplianceGate from "@/components/compliance/storefront/islands/CheckoutComplianceGate.tsx";
 import RecentlyViewed from "@/components/catalog/storefront/islands/RecentlyViewed.tsx";
@@ -44,6 +44,7 @@ import type {
 import { resolveCartSigning, shopperCheckoutUnavailableHtml } from "@/lib/checkout/shared/checkoutCommerce";
 import { isLocalSampleCheckout } from "@/config/declaredTenantConfig";
 import { isRegulatedTenant } from "@/lib/compliance/enforcement";
+import { checkoutComplianceGateRequired } from "@/lib/checkout/commerce/sharedStoreAdmission";
 import { resolveMemberContext } from "@/lib/membership/eligibility";
 import { truncate } from "@/lib/content/shared/format";
 import { productLd, breadcrumbLd, reviewLd } from "@/lib/content/shared/jsonld";
@@ -232,12 +233,14 @@ const cartApiPath = workerCartApiPath({
 let checkoutCart:
   | {
       action: string;
+      method: "get" | "post";
       purchaseOptions: ProductPurchaseOption[];
       byVariantId: Record<string, Record<string, VariantCartPayload>>;
     }
   | undefined;
 let checkoutUnavailable = false;
 const sampleHandoff = isLocalSampleCheckout(tenant.tenant_id);
+const complianceGateRequired = await checkoutComplianceGateRequired(tenant, commerce, Astro.locals.customizationEnv);
 if (commerce || sampleHandoff) {
   // Fail closed for production signed checkout: a signed tenant with no
   // cart-validation secret builds NO cart (never a tamperable form). See
@@ -265,6 +268,7 @@ if (commerce || sampleHandoff) {
                     pricing: pricingCtx,
                     autopilotEnabled,
                     tenantId: commerceTenantId(tenant),
+                    currency: tenant.currency,
                   }),
                 ] as const;
               }),
@@ -275,6 +279,7 @@ if (commerce || sampleHandoff) {
       );
       checkoutCart = {
         action: sampleHandoff ? SAMPLE_CART_HANDOFF_URL : cartApiPath,
+        method: sampleHandoff ? "get" : "post",
         purchaseOptions,
         byVariantId: Object.fromEntries(entries),
       };
@@ -345,7 +350,7 @@ const structuredData = {
     <div>
       <ImageGallery
         client:idle
-        images={product.images}
+        images={publicGalleryImages(product.images)}
         title={product.title}
         productHandle={product.handle}
       />
@@ -354,8 +359,8 @@ const structuredData = {
     {/* Buy column */}
     <div class="md:pt-2">
       <div class="flex flex-wrap items-center gap-2">
-        {onSale && <Badge variant="sale" label="Sale" />}
-        {!onSale && isNew(product) && <Badge variant="new" label="New" />}
+        {Astro.locals.features.productBadges && onSale && <Badge variant="sale" label="Sale" />}
+        {Astro.locals.features.productBadges && !onSale && isNew(product) && <Badge variant="new" label="New" />}
         {!available && <Badge variant="soldout" label="Sold out" />}
       </div>
 
@@ -420,13 +425,18 @@ const structuredData = {
           productTitle={product.title}
           checkoutCart={checkoutCart}
           pricing={pricing}
-          handoffUrl={sampleHandoff ? undefined : cartApiPath}
+          handoffUrl={
+            !sampleHandoff &&
+            (Astro.locals.browserEnvironment.environment === "live" || Astro.locals.browserEnvironment.environment === "local")
+              ? cartApiPath
+              : undefined
+          }
         />
         {/* Regulated-tenant checkout ENFORCEMENT gate. Intercepts the
             managed-cart handoff to clear age + ship-to compliance server-side
-            before the external checkout. Only mounts when a store is wired AND
-            the tenant is regulated. */}
-        {checkoutCart && !sampleHandoff && isRegulatedTenant(tenant) && compliance?.minAge && (
+            before the external checkout. Only mounts when a store is wired, the
+            tenant is regulated, and that store's policy requires a check. */}
+        {checkoutCart && !sampleHandoff && isRegulatedTenant(tenant) && compliance?.minAge && complianceGateRequired && (
           <CheckoutComplianceGate
             client:load
             preflightUrl={withBase(apiBasePath, "/api/compliance/preflight")}