@aglyn/plugins-commerce 1.0.0-beta.143

package/src/lib/server/reviews.js

@@ -0,0 +1,132 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import * as Aglyn from "@aglyn/aglyn/server";
+import * as CommerceModel from "../model/index.js";
+import { firebaseAdmin, getOrgForHost } from "@aglyn/tenant-data-admin";
+/**
+ * Approved reviews for a product, newest first, plus their aggregate.
+ *
+ * Extracted from the handler (AGL-686) so the site-page resolver can nest
+ * `aggregateRating` inside the server-rendered `Product` node. Schema.org
+ * wants it as a PROPERTY of the product; the reviews block was emitting a
+ * free-standing `AggregateRating` node alongside it, which is orphaned and
+ * ignored. One reader means the rating in the structured data and the rating
+ * on the page cannot disagree.
+ */ export async function readProductReviews(hostId, productId) {
+    const hostRef = firebaseAdmin.app().firestore().collection('hosts').doc(hostId);
+    const reviewsSnapshot = await hostRef.collection('reviews').where('productId', '==', productId).where('status', '==', 'approved').limit(100).get();
+    const reviews = reviewsSnapshot.docs.map((docSnapshot)=>{
+        var _docSnapshot_get, _docSnapshot_get1, _docSnapshot_get2, _docSnapshot_get3, _docSnapshot_get4;
+        return {
+            id: docSnapshot.id,
+            rating: Number((_docSnapshot_get = docSnapshot.get('rating')) != null ? _docSnapshot_get : 0),
+            body: String((_docSnapshot_get1 = docSnapshot.get('body')) != null ? _docSnapshot_get1 : ''),
+            authorName: String((_docSnapshot_get2 = docSnapshot.get('authorName')) != null ? _docSnapshot_get2 : 'Anonymous'),
+            verified: Boolean(docSnapshot.get('verified')),
+            reply: (_docSnapshot_get3 = docSnapshot.get('reply')) != null ? _docSnapshot_get3 : null,
+            createdAtMs: Number((_docSnapshot_get4 = docSnapshot.get('createdAtMs')) != null ? _docSnapshot_get4 : 0)
+        };
+    }).sort((a, b)=>b.createdAtMs - a.createdAtMs);
+    const count = reviews.length;
+    const average = count ? reviews.reduce((sum, review)=>sum + review.rating, 0) / count : 0;
+    return {
+        reviews,
+        aggregate: {
+            count,
+            average: Math.round(average * 10) / 10
+        }
+    };
+}
+/**
+ * Product reviews (AGL-324). GET returns approved reviews + aggregate;
+ * POST submits into the moderation queue, marking `verified` when the
+ * email has a paid order containing the product. Pro-plan gated.
+ */ export const reviewsHandler = async (req, res)=>{
+    var _ref, _ref1;
+    var _req_body, _req_body1;
+    const isPost = req.method === 'POST';
+    const hostId = String((_ref = isPost ? (_req_body = req.body) == null ? void 0 : _req_body.hostId : req.query.hostId) != null ? _ref : '');
+    const productId = String((_ref1 = isPost ? (_req_body1 = req.body) == null ? void 0 : _req_body1.productId : req.query.productId) != null ? _ref1 : '');
+    if (!hostId || !productId) {
+        return res.status(400).json({
+            error: 'Missing hostId or productId'
+        });
+    }
+    try {
+        const firestore = firebaseAdmin.app().firestore();
+        const hostRef = firestore.collection('hosts').doc(hostId);
+        if (isPost) {
+            var _ref2, _ref3, _ref4, _ref5;
+            var _req_body2, _req_body3, _req_body4, _req_body5;
+            const org = await getOrgForHost(hostId);
+            if (!Aglyn.checkEntitlement(org == null ? void 0 : org.org, 'productReviews')) {
+                return res.status(403).json({
+                    error: 'Reviews are not enabled'
+                });
+            }
+            const rating = Math.min(5, Math.max(1, Math.round(Number((_ref2 = (_req_body2 = req.body) == null ? void 0 : _req_body2.rating) != null ? _ref2 : 0))));
+            const body = String((_ref3 = (_req_body3 = req.body) == null ? void 0 : _req_body3.body) != null ? _ref3 : '').trim().slice(0, 2000);
+            const authorName = String((_ref4 = (_req_body4 = req.body) == null ? void 0 : _req_body4.authorName) != null ? _ref4 : '').trim().slice(0, 80);
+            const authorEmail = String((_ref5 = (_req_body5 = req.body) == null ? void 0 : _req_body5.authorEmail) != null ? _ref5 : '').trim().toLowerCase().slice(0, 120);
+            if (!rating || !body || !authorEmail) {
+                return res.status(400).json({
+                    error: 'Rating, review, and email required'
+                });
+            }
+            // Verified buyer: a paid order with the product under this email.
+            let verified = false;
+            const orders = await hostRef.collection('orders').where('customerEmail', '==', authorEmail).limit(25).get();
+            for (const docSnapshot of orders.docs){
+                const order = CommerceModel.liftLegacyOrder(docSnapshot.data());
+                // Through the shared entitlement test (AGL-2454). "Verified buyer" on a
+                // purchase that was refunded line by line is a badge for goods the
+                // buyer no longer has — and the inline status literal this replaced
+                // only moved on a FULL refund.
+                if (CommerceModel.orderEntitlesProduct(order, productId)) {
+                    verified = true;
+                    break;
+                }
+            }
+            await hostRef.collection('reviews').add({
+                productId,
+                rating,
+                body,
+                authorName: authorName || 'Anonymous',
+                authorEmail,
+                verified,
+                status: 'pending',
+                createdAtMs: Date.now()
+            });
+            return res.status(200).json({
+                ok: true,
+                pending: true
+            });
+        }
+        const { reviews, aggregate } = await readProductReviews(hostId, productId);
+        res.setHeader('Cache-Control', 'public, s-maxage=120, stale-while-revalidate=300');
+        return res.status(200).json({
+            reviews,
+            aggregate
+        });
+    } catch (error) {
+        console.error(error);
+        return res.status(500).json({
+            error: 'Reviews unavailable'
+        });
+    }
+};
+
+//# sourceMappingURL=reviews.js.map

package/src/lib/server/reviews.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/reviews.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { PluginApiHandler } from '@aglyn/aglyn/server'\nimport * as Aglyn from '@aglyn/aglyn/server'\nimport * as CommerceModel from '../model'\nimport { firebaseAdmin, getOrgForHost } from '@aglyn/tenant-data-admin'\n\nexport interface PublicProductReview {\n  id: string\n  rating: number\n  body: string\n  authorName: string\n  verified: boolean\n  reply: string | null\n  createdAtMs: number\n}\n\nexport interface ProductReviewAggregate {\n  count: number\n  /** Mean rating, one decimal. */\n  average: number\n}\n\n/**\n * Approved reviews for a product, newest first, plus their aggregate.\n *\n * Extracted from the handler (AGL-686) so the site-page resolver can nest\n * `aggregateRating` inside the server-rendered `Product` node. Schema.org\n * wants it as a PROPERTY of the product; the reviews block was emitting a\n * free-standing `AggregateRating` node alongside it, which is orphaned and\n * ignored. One reader means the rating in the structured data and the rating\n * on the page cannot disagree.\n */\nexport async function readProductReviews(\n  hostId: string,\n  productId: string,\n): Promise<{\n  reviews: PublicProductReview[]\n  aggregate: ProductReviewAggregate\n}> {\n  const hostRef = firebaseAdmin\n    .app()\n    .firestore()\n    .collection('hosts')\n    .doc(hostId)\n  const reviewsSnapshot = await hostRef\n    .collection('reviews')\n    .where('productId', '==', productId)\n    .where('status', '==', 'approved')\n    .limit(100)\n    .get()\n  const reviews = reviewsSnapshot.docs\n    .map((docSnapshot) => ({\n      id: docSnapshot.id,\n      rating: Number(docSnapshot.get('rating') ?? 0),\n      body: String(docSnapshot.get('body') ?? ''),\n      authorName: String(docSnapshot.get('authorName') ?? 'Anonymous'),\n      verified: Boolean(docSnapshot.get('verified')),\n      reply: (docSnapshot.get('reply') as string | undefined) ?? null,\n      createdAtMs: Number(docSnapshot.get('createdAtMs') ?? 0),\n    }))\n    .sort((a, b) => b.createdAtMs - a.createdAtMs)\n  const count = reviews.length\n  const average = count\n    ? reviews.reduce((sum, review) => sum + review.rating, 0) / count\n    : 0\n  return {\n    reviews,\n    aggregate: { count, average: Math.round(average * 10) / 10 },\n  }\n}\n\n/**\n * Product reviews (AGL-324). GET returns approved reviews + aggregate;\n * POST submits into the moderation queue, marking `verified` when the\n * email has a paid order containing the product. Pro-plan gated.\n */\nexport const reviewsHandler: PluginApiHandler = async (req, res) => {\n  const isPost = req.method === 'POST'\n  const hostId = String((isPost ? req.body?.hostId : req.query.hostId) ?? '')\n  const productId = String(\n    (isPost ? req.body?.productId : req.query.productId) ?? '',\n  )\n  if (!hostId || !productId) {\n    return res.status(400).json({ error: 'Missing hostId or productId' })\n  }\n  try {\n    const firestore = firebaseAdmin.app().firestore()\n    const hostRef = firestore.collection('hosts').doc(hostId)\n\n    if (isPost) {\n      const org = await getOrgForHost(hostId)\n      if (!Aglyn.checkEntitlement(org?.org as any, 'productReviews')) {\n        return res.status(403).json({ error: 'Reviews are not enabled' })\n      }\n      const rating = Math.min(5, Math.max(1, Math.round(Number(req.body?.rating ?? 0))))\n      const body = String(req.body?.body ?? '').trim().slice(0, 2000)\n      const authorName = String(req.body?.authorName ?? '').trim().slice(0, 80)\n      const authorEmail = String(req.body?.authorEmail ?? '')\n        .trim()\n        .toLowerCase()\n        .slice(0, 120)\n      if (!rating || !body || !authorEmail) {\n        return res.status(400).json({ error: 'Rating, review, and email required' })\n      }\n      // Verified buyer: a paid order with the product under this email.\n      let verified = false\n      const orders = await hostRef\n        .collection('orders')\n        .where('customerEmail', '==', authorEmail)\n        .limit(25)\n        .get()\n      for (const docSnapshot of orders.docs) {\n        const order = CommerceModel.liftLegacyOrder(docSnapshot.data() as any)\n        // Through the shared entitlement test (AGL-2454). \"Verified buyer\" on a\n        // purchase that was refunded line by line is a badge for goods the\n        // buyer no longer has — and the inline status literal this replaced\n        // only moved on a FULL refund.\n        if (CommerceModel.orderEntitlesProduct(order, productId)) {\n          verified = true\n          break\n        }\n      }\n      await hostRef.collection('reviews').add({\n        productId,\n        rating,\n        body,\n        authorName: authorName || 'Anonymous',\n        authorEmail,\n        verified,\n        status: 'pending',\n        createdAtMs: Date.now(),\n      })\n      return res.status(200).json({ ok: true, pending: true })\n    }\n\n    const { reviews, aggregate } = await readProductReviews(hostId, productId)\n    res.setHeader(\n      'Cache-Control',\n      'public, s-maxage=120, stale-while-revalidate=300',\n    )\n    return res.status(200).json({ reviews, aggregate })\n  } catch (error) {\n    console.error(error)\n    return res.status(500).json({ error: 'Reviews unavailable' })\n  }\n}\n"],"names":["Aglyn","CommerceModel","firebaseAdmin","getOrgForHost","readProductReviews","hostId","productId","hostRef","app","firestore","collection","doc","reviewsSnapshot","where","limit","get","reviews","docs","map","docSnapshot","id","rating","Number","body","String","authorName","verified","Boolean","reply","createdAtMs","sort","a","b","count","length","average","reduce","sum","review","aggregate","Math","round","reviewsHandler","req","res","isPost","method","query","status","json","error","org","checkEntitlement","min","max","trim","slice","authorEmail","toLowerCase","orders","order","liftLegacyOrder","data","orderEntitlesProduct","add","Date","now","ok","pending","setHeader","console"],"mappings":"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"}

package/src/lib/server/site-page-enricher.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { SitePageEnricher } from '@aglyn/aglyn/server';
+/**
+ * Seeds each product grid's FIRST, UNFILTERED page (AGL-659).
+ *
+ * `/products` shipped 11KB of HTML with zero words in it: the grid fetches
+ * its catalog in a `useEffect`, so the server rendered skeleton cards and
+ * crawlers indexed an empty shell. The fix is to run the same query on the
+ * server and hand the result down through `pageData`.
+ *
+ * Three things this deliberately does NOT do:
+ *
+ * - It does not seed anything the visitor can change. Search text, category
+ *   chips, type chips and the price slider all start empty on mount, so a
+ *   props-derived query is exactly what the grid's own first fetch would
+ *   send. Seed a filtered page and SSR would disagree with hydration.
+ * - It does not seed later pages. Load more still goes to the API.
+ * - It does not share one slice between grids. Seeds are keyed by node id,
+ *   because a collection-scoped grid and an all-products grid on the same
+ *   page must not receive each other's items — wrong products would get
+ *   indexed and visibly swap on hydrate.
+ *
+ * Failures are swallowed by the enricher runner, and the grid falls back to
+ * fetching. A catalog read that errors must not take a page down.
+ */
+export declare const commerceSitePageEnricher: SitePageEnricher;
+export default commerceSitePageEnricher;

package/src/lib/server/site-page-enricher.js

@@ -0,0 +1,149 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { createCatalogReadScope, queryPublicCatalog } from "./catalog.js";
+/** Component id of the block this enricher seeds; persisted, never renamed. */ const PRODUCT_GRID_ID = 'product-grid';
+/**
+ * Grids seeded per page. A page with a dozen grids would turn one render
+ * into a dozen catalog reads, so the walk stops after this many — the rest
+ * fetch client-side exactly as they did before, which is a slower first
+ * paint rather than a broken page.
+ */ const MAX_SEEDED_GRIDS = 4;
+/**
+ * Every product-grid node on the page.
+ *
+ * `composeScreenNodes` returns `Record<string, node>` — a DENORMALIZED FLAT
+ * MAP keyed by node id, whose children are id STRINGS in `nodes`. It does not
+ * return a tree, and there is no `children` array anywhere in it.
+ *
+ * The first version of this walked `children` recursively and therefore
+ * matched nothing at all, on any page. It shipped green because the unit
+ * tests fed it a nested fixture — the fixture encoded the assumption instead
+ * of the actual contract, so the tests only ever proved the walker was
+ * self-consistent. Iterating the map's values is both correct and simpler;
+ * the flat shape means no recursion is needed.
+ *
+ * Sorted by id so that the MAX_SEEDED_GRIDS cap takes a deterministic subset
+ * rather than whichever ones the map happened to enumerate first.
+ */ function collectGridNodes(nodes) {
+    if (!nodes || typeof nodes !== 'object') return [];
+    const found = [];
+    for (const value of Object.values(nodes)){
+        if (!value || typeof value !== 'object' || Array.isArray(value)) continue;
+        const shaped = value;
+        if (shaped.componentId === PRODUCT_GRID_ID && shaped.$id) {
+            found.push(shaped);
+        }
+    }
+    return found.sort((a, b)=>String(a.$id).localeCompare(String(b.$id)));
+}
+/** Positive integer from a props value that may arrive as a string. */ function positiveInt(value) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0) return undefined;
+    return Math.floor(parsed);
+}
+/**
+ * The collection slug a grid on a `/collections/{slug}` page follows when
+ * it has no pinned collection — the server-side twin of the grid's
+ * `collectionSlugFromLocation()`, which reads `window.location`.
+ */ function collectionSlugFromPath(path) {
+    const match = path.match(/\/collections\/([^/?#]+)/);
+    return match ? decodeURIComponent(match[1]) : '';
+}
+/**
+ * Seeds each product grid's FIRST, UNFILTERED page (AGL-659).
+ *
+ * `/products` shipped 11KB of HTML with zero words in it: the grid fetches
+ * its catalog in a `useEffect`, so the server rendered skeleton cards and
+ * crawlers indexed an empty shell. The fix is to run the same query on the
+ * server and hand the result down through `pageData`.
+ *
+ * Three things this deliberately does NOT do:
+ *
+ * - It does not seed anything the visitor can change. Search text, category
+ *   chips, type chips and the price slider all start empty on mount, so a
+ *   props-derived query is exactly what the grid's own first fetch would
+ *   send. Seed a filtered page and SSR would disagree with hydration.
+ * - It does not seed later pages. Load more still goes to the API.
+ * - It does not share one slice between grids. Seeds are keyed by node id,
+ *   because a collection-scoped grid and an all-products grid on the same
+ *   page must not receive each other's items — wrong products would get
+ *   indexed and visibly swap on hydrate.
+ *
+ * Failures are swallowed by the enricher runner, and the grid falls back to
+ * fetching. A catalog read that errors must not take a page down.
+ */ export const commerceSitePageEnricher = async ({ hostId, path, nodes })=>{
+    const grids = collectGridNodes(nodes).slice(0, MAX_SEEDED_GRIDS);
+    if (!grids.length) return undefined;
+    const seeds = {};
+    // One scope for this render, so four grids on a page cost one catalog read
+    // instead of four identical ones. Each grid still filters and sorts that
+    // snapshot for itself — the seeds stay keyed by node id.
+    const reads = createCatalogReadScope();
+    await Promise.all(grids.map(async (node)=>{
+        var _ref, _node_resolvedProps, _props_source;
+        const props = (_ref = (_node_resolvedProps = node.resolvedProps) != null ? _node_resolvedProps : node.props) != null ? _ref : {};
+        const source = (_props_source = props.source) != null ? _props_source : 'all';
+        // Ids first (rename-safe, AGL-343), slugs as the legacy path — the
+        // same precedence the grid applies when it builds its own params.
+        const collectionSlug = source === 'collection' ? props.collectionSlug || collectionSlugFromPath(path) : props.collectionSlug;
+        const pageLimit = positiveInt(props.pageSize);
+        const limit = pageLimit != null ? pageLimit : positiveInt(props.maxItems);
+        try {
+            const result = await queryPublicCatalog(_extends({
+                hostId
+            }, source === 'collection' ? props.collectionId ? {
+                collectionId: props.collectionId
+            } : collectionSlug ? {
+                collectionSlug
+            } : {} : {}, source === 'category' ? props.categoryId ? {
+                categoryId: props.categoryId
+            } : props.categorySlug ? {
+                categorySlug: props.categorySlug
+            } : {} : {}, source === 'tag' && props.tag ? {
+                tag: props.tag
+            } : {}, props.sort ? {
+                sort: props.sort
+            } : {}, limit ? {
+                limit
+            } : {}, {
+                // Facets ride along only when a control needs them, matching the
+                // grid's `facets=1` condition on its first request.
+                facets: Boolean(props.showCategories || props.showPriceFilter),
+                reads
+            }));
+            seeds[node.$id] = result;
+        } catch (error) {
+            // One grid failing leaves the others seeded; this one fetches.
+            console.error('commerce grid seed failed', node.$id, error);
+        }
+    }));
+    if (!Object.keys(seeds).length) return undefined;
+    return {
+        // Merged shallowly into the page props, so this key is the whole
+        // `pageData` for a screen page. Screens never reach a page resolver
+        // (the loader returns a resolver's answer before enrichers run), so
+        // there is no resolver-written pageData here to preserve.
+        pageData: {
+            commerce: {
+                grids: seeds
+            }
+        }
+    };
+};
+export default commerceSitePageEnricher;
+
+//# sourceMappingURL=site-page-enricher.js.map

package/src/lib/server/site-page-enricher.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/site-page-enricher.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { SitePageEnricher } from '@aglyn/aglyn/server'\nimport {\n  createCatalogReadScope,\n  queryPublicCatalog,\n  type PublicCatalogResult,\n} from './catalog'\n\n/** Component id of the block this enricher seeds; persisted, never renamed. */\nconst PRODUCT_GRID_ID = 'product-grid'\n\n/**\n * Grids seeded per page. A page with a dozen grids would turn one render\n * into a dozen catalog reads, so the walk stops after this many — the rest\n * fetch client-side exactly as they did before, which is a slower first\n * paint rather than a broken page.\n */\nconst MAX_SEEDED_GRIDS = 4\n\ninterface GridProps {\n  source?: 'all' | 'collection' | 'category' | 'tag'\n  collectionId?: string\n  collectionSlug?: string\n  categoryId?: string\n  categorySlug?: string\n  tag?: string\n  sort?: string\n  maxItems?: number | string\n  pageSize?: number | string\n  showCategories?: boolean\n  showPriceFilter?: boolean\n}\n\ninterface ComposedNode {\n  $id?: string\n  componentId?: string\n  props?: Record<string, unknown>\n  resolvedProps?: Record<string, unknown>\n  /** Child node IDS — denormalized nodes do not nest (see below). */\n  nodes?: string[]\n}\n\n/**\n * Every product-grid node on the page.\n *\n * `composeScreenNodes` returns `Record<string, node>` — a DENORMALIZED FLAT\n * MAP keyed by node id, whose children are id STRINGS in `nodes`. It does not\n * return a tree, and there is no `children` array anywhere in it.\n *\n * The first version of this walked `children` recursively and therefore\n * matched nothing at all, on any page. It shipped green because the unit\n * tests fed it a nested fixture — the fixture encoded the assumption instead\n * of the actual contract, so the tests only ever proved the walker was\n * self-consistent. Iterating the map's values is both correct and simpler;\n * the flat shape means no recursion is needed.\n *\n * Sorted by id so that the MAX_SEEDED_GRIDS cap takes a deterministic subset\n * rather than whichever ones the map happened to enumerate first.\n */\nfunction collectGridNodes(nodes: unknown): ComposedNode[] {\n  if (!nodes || typeof nodes !== 'object') return []\n  const found: ComposedNode[] = []\n  for (const value of Object.values(nodes as Record<string, unknown>)) {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) continue\n    const shaped = value as ComposedNode\n    if (shaped.componentId === PRODUCT_GRID_ID && shaped.$id) {\n      found.push(shaped)\n    }\n  }\n  return found.sort((a, b) => String(a.$id).localeCompare(String(b.$id)))\n}\n\n/** Positive integer from a props value that may arrive as a string. */\nfunction positiveInt(value: unknown): number | undefined {\n  const parsed = Number(value)\n  if (!Number.isFinite(parsed) || parsed <= 0) return undefined\n  return Math.floor(parsed)\n}\n\n/**\n * The collection slug a grid on a `/collections/{slug}` page follows when\n * it has no pinned collection — the server-side twin of the grid's\n * `collectionSlugFromLocation()`, which reads `window.location`.\n */\nfunction collectionSlugFromPath(path: string): string {\n  const match = path.match(/\\/collections\\/([^/?#]+)/)\n  return match ? decodeURIComponent(match[1]) : ''\n}\n\n/**\n * Seeds each product grid's FIRST, UNFILTERED page (AGL-659).\n *\n * `/products` shipped 11KB of HTML with zero words in it: the grid fetches\n * its catalog in a `useEffect`, so the server rendered skeleton cards and\n * crawlers indexed an empty shell. The fix is to run the same query on the\n * server and hand the result down through `pageData`.\n *\n * Three things this deliberately does NOT do:\n *\n * - It does not seed anything the visitor can change. Search text, category\n *   chips, type chips and the price slider all start empty on mount, so a\n *   props-derived query is exactly what the grid's own first fetch would\n *   send. Seed a filtered page and SSR would disagree with hydration.\n * - It does not seed later pages. Load more still goes to the API.\n * - It does not share one slice between grids. Seeds are keyed by node id,\n *   because a collection-scoped grid and an all-products grid on the same\n *   page must not receive each other's items — wrong products would get\n *   indexed and visibly swap on hydrate.\n *\n * Failures are swallowed by the enricher runner, and the grid falls back to\n * fetching. A catalog read that errors must not take a page down.\n */\nexport const commerceSitePageEnricher: SitePageEnricher = async ({\n  hostId,\n  path,\n  nodes,\n}) => {\n  const grids = collectGridNodes(nodes).slice(0, MAX_SEEDED_GRIDS)\n  if (!grids.length) return undefined\n\n  const seeds: Record<string, PublicCatalogResult> = {}\n  // One scope for this render, so four grids on a page cost one catalog read\n  // instead of four identical ones. Each grid still filters and sorts that\n  // snapshot for itself — the seeds stay keyed by node id.\n  const reads = createCatalogReadScope()\n  await Promise.all(\n    grids.map(async (node) => {\n      const props = (node.resolvedProps ??\n        node.props ??\n        {}) as unknown as GridProps\n      const source = props.source ?? 'all'\n      // Ids first (rename-safe, AGL-343), slugs as the legacy path — the\n      // same precedence the grid applies when it builds its own params.\n      const collectionSlug =\n        source === 'collection'\n          ? props.collectionSlug || collectionSlugFromPath(path)\n          : props.collectionSlug\n      const pageLimit = positiveInt(props.pageSize)\n      const limit = pageLimit ?? positiveInt(props.maxItems)\n\n      try {\n        const result = await queryPublicCatalog({\n          hostId,\n          ...(source === 'collection'\n            ? props.collectionId\n              ? { collectionId: props.collectionId }\n              : collectionSlug\n                ? { collectionSlug }\n                : {}\n            : {}),\n          ...(source === 'category'\n            ? props.categoryId\n              ? { categoryId: props.categoryId }\n              : props.categorySlug\n                ? { categorySlug: props.categorySlug }\n                : {}\n            : {}),\n          ...(source === 'tag' && props.tag ? { tag: props.tag } : {}),\n          ...(props.sort ? { sort: props.sort } : {}),\n          ...(limit ? { limit } : {}),\n          // Facets ride along only when a control needs them, matching the\n          // grid's `facets=1` condition on its first request.\n          facets: Boolean(props.showCategories || props.showPriceFilter),\n          reads,\n        })\n        seeds[node.$id as string] = result\n      } catch (error) {\n        // One grid failing leaves the others seeded; this one fetches.\n        console.error('commerce grid seed failed', node.$id, error)\n      }\n    }),\n  )\n\n  if (!Object.keys(seeds).length) return undefined\n\n  return {\n    // Merged shallowly into the page props, so this key is the whole\n    // `pageData` for a screen page. Screens never reach a page resolver\n    // (the loader returns a resolver's answer before enrichers run), so\n    // there is no resolver-written pageData here to preserve.\n    pageData: { commerce: { grids: seeds } },\n  }\n}\n\nexport default commerceSitePageEnricher\n"],"names":["createCatalogReadScope","queryPublicCatalog","PRODUCT_GRID_ID","MAX_SEEDED_GRIDS","collectGridNodes","nodes","found","value","Object","values","Array","isArray","shaped","componentId","$id","push","sort","a","b","String","localeCompare","positiveInt","parsed","Number","isFinite","undefined","Math","floor","collectionSlugFromPath","path","match","decodeURIComponent","commerceSitePageEnricher","hostId","grids","slice","length","seeds","reads","Promise","all","map","node","props","resolvedProps","source","collectionSlug","pageLimit","pageSize","limit","maxItems","result","collectionId","categoryId","categorySlug","tag","facets","Boolean","showCategories","showPriceFilter","error","console","keys","pageData","commerce"],"mappings":"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"}

package/src/lib/server/site-page-resolver.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { SitePageResolver } from '@aglyn/aglyn/server';
+/**
+ * Commerce page resolver (AGL-292/298/418), relocated verbatim from the
+ * tenant loader: /products/{slug} renders the host's designated PDP
+ * template with product tokens, /collections/{slug} the collection
+ * template — both compose server-side and return complete page props.
+ * Runs only for paths that didn't match a published screen; returns
+ * undefined for everything else so the loader falls through.
+ */
+export declare const commerceSitePageResolver: SitePageResolver;

package/src/lib/server/site-page-resolver.js

@@ -0,0 +1,223 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { hostCollectionKind } from "@aglyn/aglyn/server";
+import composeScreenNodes from "@aglyn/tenant-runtime/compose-screen-nodes";
+import getScreen from "@aglyn/tenant-runtime/get-screen";
+import { collectSocialImageFacts } from "@aglyn/tenant-runtime/social-image-facts";
+import { firebaseAdmin } from "@aglyn/tenant-data-admin";
+import * as CommerceModel from "../model/index.js";
+import { toPublicProductDetail } from "./product.js";
+import { readProductReviews } from "./reviews.js";
+/**
+ * Commerce page resolver (AGL-292/298/418), relocated verbatim from the
+ * tenant loader: /products/{slug} renders the host's designated PDP
+ * template with product tokens, /collections/{slug} the collection
+ * template — both compose server-side and return complete page props.
+ * Runs only for paths that didn't match a published screen; returns
+ * undefined for everything else so the loader falls through.
+ */ export const commerceSitePageResolver = async ({ hostId, host, path })=>{
+    const hostRes = {
+        host
+    };
+    // Product detail routes (AGL-292): /products/{slug} renders the
+    // host's designated PDP template screen (settings/store
+    // `pdpScreenId`, AGL-295) with product tokens; the product-detail
+    // block hydrates variants client-side from the same slug. Same
+    // mechanism as entry-template screens below.
+    const pdpSegments = path.split('/').filter(Boolean);
+    if (pdpSegments.length === 2 && pdpSegments[0] === 'products') {
+        var _productSnapshot_docs_;
+        const adminFirestore = firebaseAdmin.app().firestore();
+        const hostDocRef = adminFirestore.collection('hosts').doc(hostId);
+        const [storeSettings, productSnapshot] = await Promise.all([
+            hostDocRef.collection('settings').doc('store').get(),
+            hostDocRef.collection('products').where('slug', '==', pdpSegments[1]).limit(1).get()
+        ]);
+        const pdpScreenId = storeSettings.get('pdpScreenId');
+        const productRaw = (_productSnapshot_docs_ = productSnapshot.docs[0]) == null ? void 0 : _productSnapshot_docs_.data();
+        if (pdpScreenId && productRaw && !productRaw.deletedAt && productRaw.status === 'active') {
+            const product = CommerceModel.liftLegacyProduct(productRaw);
+            const templateRes = await getScreen({
+                hostId,
+                screenId: pdpScreenId,
+                // A PDP template renders against a routed PRODUCT, never at an address
+                // of its own, so it is served here and 404s everywhere else (AGL-1400).
+                allowTemplate: true
+            });
+            if (templateRes.screen) {
+                var _product_description, _ref, _ref1;
+                var _templateRes_screen_seo, _hostRes_host_seo, _hostRes_host, _product_mediaUrls;
+                const [minPrice, maxPrice] = CommerceModel.productPriceRange(product);
+                // Best-effort: a reviews read that fails costs the page its rating
+                // snippet, not the page.
+                const productReviews = await readProductReviews(hostId, productSnapshot.docs[0].id).catch((error)=>{
+                    console.error('product review aggregate failed', error);
+                    return {
+                        reviews: [],
+                        aggregate: {
+                            count: 0,
+                            average: 0
+                        }
+                    };
+                });
+                // The head shares this page as the template's image, then the site
+                // default, so their documents are read in the template's own batch
+                // (AGL-2850).
+                const card = collectSocialImageFacts([
+                    (_templateRes_screen_seo = templateRes.screen.seo) == null ? void 0 : _templateRes_screen_seo.image,
+                    (_hostRes_host = hostRes.host) == null ? void 0 : (_hostRes_host_seo = _hostRes_host.seo) == null ? void 0 : _hostRes_host_seo.image
+                ]);
+                const templateNodes = await composeScreenNodes({
+                    hostId,
+                    screenId: pdpScreenId,
+                    screen: templateRes.screen,
+                    socialImages: card.socialImages,
+                    // The template's host variables, and its layout's, fill in from
+                    // this site as they do on every other page (AGL-2883).
+                    host: hostRes.host,
+                    tokens: {
+                        'product.name': product.name,
+                        'product.description': (_product_description = product.description) != null ? _product_description : '',
+                        'product.price': minPrice === maxPrice ? `$${minPrice}` : `From $${minPrice}`,
+                        'product.image': (_ref = (_ref1 = (_product_mediaUrls = product.mediaUrls) == null ? void 0 : _product_mediaUrls[0]) != null ? _ref1 : product.imageUrl) != null ? _ref : '',
+                        'product.slug': product.slug
+                    }
+                });
+                if (templateNodes) {
+                    var _templateRes_screen_seo1, _ref2, _ref3, _ref4;
+                    var _product_seo, _product_seo1;
+                    return {
+                        props: JSON.parse(JSON.stringify(_extends({
+                            // The PDP block used to fetch this in an effect, so the
+                            // server rendered a skeleton and crawlers saw a product page
+                            // with no product in it (AGL-659). The product is already
+                            // loaded here — hand it down so it renders server-side.
+                            pageData: {
+                                commerce: _extends({
+                                    product: toPublicProductDetail(productSnapshot.docs[0].id, product)
+                                }, productReviews.aggregate.count ? {
+                                    reviews: productReviews
+                                } : {})
+                            },
+                            data: {
+                                host: hostRes.host,
+                                screen: {
+                                    data: _extends({}, templateRes.screen, {
+                                        // The product NAMES this page; the template's own name
+                                        // ("Product detail") describes none of the products it
+                                        // renders. Kept distinct from the SEO title because the
+                                        // head treats an authored title as verbatim and a name
+                                        // as the side the site title joins (AGL-1341) — so a
+                                        // product with its own SEO title gets exactly that, and
+                                        // one without gets "Blue Widget – Acme Store".
+                                        displayName: product.name,
+                                        seo: _extends({}, (_templateRes_screen_seo1 = templateRes.screen.seo) != null ? _templateRes_screen_seo1 : {}, {
+                                            // Only when the PRODUCT authored one: inheriting the
+                                            // template screen's title would give every product
+                                            // page in the store the same `<title>`.
+                                            title: (_ref2 = (_product_seo = product.seo) == null ? void 0 : _product_seo.title) != null ? _ref2 : undefined,
+                                            description: (_ref3 = (_ref4 = (_product_seo1 = product.seo) == null ? void 0 : _product_seo1.description) != null ? _ref4 : product.description) != null ? _ref3 : undefined
+                                        })
+                                    })
+                                }
+                            },
+                            nodes: templateNodes
+                        }, card.collected()))),
+                        revalidate: 60
+                    };
+                }
+            }
+        }
+    }
+    // Commerce collection routes (AGL-298): /collections/{slug} renders
+    // the designated collection template with collection tokens; the
+    // product-grid block derives the same slug from the URL.
+    if (pdpSegments.length === 2 && pdpSegments[0] === 'collections') {
+        var _collectionSnapshot_docs_find;
+        const adminFirestore = firebaseAdmin.app().firestore();
+        const hostDocRef = adminFirestore.collection('hosts').doc(hostId);
+        const [storeSettings, collectionSnapshot] = await Promise.all([
+            hostDocRef.collection('settings').doc('store').get(),
+            hostDocRef.collection('collections').where('slug', '==', pdpSegments[1]).limit(5).get()
+        ]);
+        const collectionScreenId = storeSettings.get('collectionScreenId');
+        // Content collections share this path and a slug is only unique within a
+        // kind (AGL-954), so take the first CATALOG match rather than the first
+        // doc — otherwise a blog with the same slug renders as a product page.
+        const shopCollection = (_collectionSnapshot_docs_find = collectionSnapshot.docs.find((docSnapshot)=>hostCollectionKind(docSnapshot.data()) === 'catalog')) == null ? void 0 : _collectionSnapshot_docs_find.data();
+        if (collectionScreenId && shopCollection) {
+            const templateRes = await getScreen({
+                hostId,
+                screenId: collectionScreenId,
+                allowTemplate: true
+            });
+            if (templateRes.screen) {
+                var _shopCollection_description, _shopCollection_imageUrl;
+                var _templateRes_screen_seo2, _hostRes_host_seo1, _hostRes_host1;
+                // As on the PDP above: the template's image, then the site default
+                // (AGL-2850).
+                const card = collectSocialImageFacts([
+                    (_templateRes_screen_seo2 = templateRes.screen.seo) == null ? void 0 : _templateRes_screen_seo2.image,
+                    (_hostRes_host1 = hostRes.host) == null ? void 0 : (_hostRes_host_seo1 = _hostRes_host1.seo) == null ? void 0 : _hostRes_host_seo1.image
+                ]);
+                const templateNodes = await composeScreenNodes({
+                    hostId,
+                    screenId: collectionScreenId,
+                    screen: templateRes.screen,
+                    socialImages: card.socialImages,
+                    // As on the PDP above (AGL-2883).
+                    host: hostRes.host,
+                    tokens: {
+                        'collection.name': shopCollection.name,
+                        'collection.description': (_shopCollection_description = shopCollection.description) != null ? _shopCollection_description : '',
+                        'collection.image': (_shopCollection_imageUrl = shopCollection.imageUrl) != null ? _shopCollection_imageUrl : '',
+                        'collection.slug': shopCollection.slug
+                    }
+                });
+                if (templateNodes) {
+                    var _templateRes_screen_seo3, _shopCollection_description1;
+                    return {
+                        props: JSON.parse(JSON.stringify(_extends({
+                            data: {
+                                host: hostRes.host,
+                                screen: {
+                                    data: _extends({}, templateRes.screen, {
+                                        // As on the PDP above: the catalog collection names the
+                                        // page, and a name takes the site title after it while
+                                        // an authored SEO title would not (AGL-1341). A shop
+                                        // collection has no SEO title field of its own, so the
+                                        // template's must not stand in for one.
+                                        displayName: shopCollection.name,
+                                        seo: _extends({}, (_templateRes_screen_seo3 = templateRes.screen.seo) != null ? _templateRes_screen_seo3 : {}, {
+                                            title: undefined,
+                                            description: (_shopCollection_description1 = shopCollection.description) != null ? _shopCollection_description1 : undefined
+                                        })
+                                    })
+                                }
+                            },
+                            nodes: templateNodes
+                        }, card.collected()))),
+                        revalidate: 60
+                    };
+                }
+            }
+        }
+    }
+    return undefined;
+};
+
+//# sourceMappingURL=site-page-resolver.js.map