@aglyn/plugins-commerce 1.0.0-beta.143

package/src/lib/server/catalog.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @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 { PluginApiHandler } from '@aglyn/aglyn/server';
+import * as CommerceModel from '../model';
+export interface PublicCatalogItem {
+    id: string;
+    name: string;
+    slug: string;
+    type: CommerceModel.ProductType;
+    priceUsd: number;
+    maxPriceUsd: number;
+    compareAtPriceUsd?: number;
+    imageUrl?: string;
+    soldOut: boolean;
+    tags?: string[];
+}
+/** Host category surfaced to grids for filter chips (AGL-561). */
+export interface PublicCatalogCategory {
+    id: string;
+    name: string;
+    slug: string;
+}
+/** Price facet surfaced to grids to bound a range slider (AGL-564). */
+export interface PublicCatalogPriceBounds {
+    minCents: number;
+    maxCents: number;
+}
+/**
+ * Displayed price in cents (AGL-564): the low end of the variant range —
+ * the number grid cards render (`$X` / `From $X`) — so price filtering
+ * matches what visitors see.
+ */
+export declare function displayedPriceCents(product: Pick<CommerceModel.HostProduct, 'variants'>): number;
+/**
+ * Case-insensitive catalog search (AGL-561): matches the product name,
+ * description, or any tag. An empty/blank query matches everything.
+ */
+export declare function matchesCatalogQuery(product: Pick<CommerceModel.HostProduct, 'name' | 'description' | 'tags'>, query: string): boolean;
+/** A catalog query, already parsed and bounded. */
+export interface PublicCatalogQuery {
+    hostId: string;
+    collectionId?: string;
+    collectionSlug?: string;
+    categoryId?: string;
+    categorySlug?: string;
+    tag?: string;
+    /** Free-text search over name, description and tags. */
+    query?: string;
+    type?: CommerceModel.ProductType | '';
+    /** Explicit id list in the given order (wishlist rendering, AGL-297). */
+    ids?: string[];
+    minPriceCents?: number;
+    maxPriceCents?: number;
+    sort?: string;
+    /** Page size, 1–100. */
+    limit?: number;
+    offset?: number;
+    /** Include category + price facets in the result. */
+    facets?: boolean;
+    /**
+     * Optional per-render dedupe (see {@link CatalogReadScope}). Absent for a
+     * one-off call such as the API route, where there is nothing to share with.
+     */
+    reads?: CatalogReadScope;
+}
+/**
+ * Reads shared by every catalog query in ONE render, for ONE host.
+ *
+ * The products read does not vary with the query — the whole catalog is
+ * fetched and then filtered in memory by collection, category, tag, price and
+ * search text. A page carrying four product grids therefore issued four
+ * identical 500-document reads and threw three of them away.
+ *
+ * This shares the READ, never the RESULT. Each grid still filters and sorts
+ * the shared snapshot independently, because a collection-scoped grid and an
+ * all-products grid on the same page must not receive each other's items.
+ *
+ * Scoped to one host and one render deliberately: it holds a promise, not
+ * data, so nothing is cached across requests and no staleness window opens.
+ * Reusing a scope for a second host would serve that host the first one's
+ * catalog, which is why it is created per render rather than per module.
+ */
+export interface CatalogReadScope {
+    products?: Promise<FirebaseFirestore.QuerySnapshot>;
+    categories?: Promise<FirebaseFirestore.QuerySnapshot>;
+}
+/** A fresh read scope. One per render, never reused across hosts. */
+export declare function createCatalogReadScope(): CatalogReadScope;
+/** What both the API route and the SSR seed hand to a product grid. */
+export interface PublicCatalogResult {
+    items: PublicCatalogItem[];
+    nextOffset?: number;
+    categories?: PublicCatalogCategory[];
+    priceBounds?: PublicCatalogPriceBounds;
+}
+/**
+ * Public catalog listing (AGL-291): active products for storefront
+ * blocks — filterable by collection/category slug or tag, sortable,
+ * capped at 100 items per request. Storefront catalog UX (AGL-561)
+ * adds text search, a product-type filter, offset paging (for Load
+ * more), and facets for filter chips. The price-range filter (AGL-564)
+ * bounds on the displayed price and reports `priceBounds`.
+ * Read-only public data; prices here are display-only (charges always
+ * come from the docs server-side).
+ *
+ * Extracted from the handler (AGL-659) so the site-page enricher seeds a
+ * grid's first page through THIS function rather than a reimplementation
+ * of it. A seed that filters or sorts differently from the API would
+ * server-render one set of products and hydrate to another.
+ */
+export declare function queryPublicCatalog(params: PublicCatalogQuery): Promise<PublicCatalogResult>;
+/** Public catalog listing endpoint — a thin parse over queryPublicCatalog. */
+export declare const catalogHandler: PluginApiHandler;

package/src/lib/server/catalog.js

@@ -0,0 +1,277 @@
+/**
+ * @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 * as Aglyn from "@aglyn/aglyn/server";
+import * as CommerceModel from "../model/index.js";
+import { firebaseAdmin } from "@aglyn/tenant-data-admin";
+/**
+ * Displayed price in cents (AGL-564): the low end of the variant range —
+ * the number grid cards render (`$X` / `From $X`) — so price filtering
+ * matches what visitors see.
+ */ export function displayedPriceCents(product) {
+    return Math.round(CommerceModel.productPriceRange(product)[0] * 100);
+}
+/** Non-negative integer cents from a query param; undefined otherwise. */ function parsePriceCents(value) {
+    const raw = String(value != null ? value : '').trim();
+    if (!raw) return undefined;
+    const cents = Number(raw);
+    if (!Number.isFinite(cents) || cents < 0) return undefined;
+    return Math.round(cents);
+}
+/**
+ * Case-insensitive catalog search (AGL-561): matches the product name,
+ * description, or any tag. An empty/blank query matches everything.
+ */ export function matchesCatalogQuery(product, query) {
+    var _product_description, _product_tags;
+    const needle = query.trim().toLowerCase();
+    if (!needle) return true;
+    return product.name.toLowerCase().includes(needle) || ((_product_description = product.description) != null ? _product_description : '').toLowerCase().includes(needle) || ((_product_tags = product.tags) != null ? _product_tags : []).some((tag)=>tag.toLowerCase().includes(needle));
+}
+/** A fresh read scope. One per render, never reused across hosts. */ export function createCatalogReadScope() {
+    return {};
+}
+/**
+ * Public catalog listing (AGL-291): active products for storefront
+ * blocks — filterable by collection/category slug or tag, sortable,
+ * capped at 100 items per request. Storefront catalog UX (AGL-561)
+ * adds text search, a product-type filter, offset paging (for Load
+ * more), and facets for filter chips. The price-range filter (AGL-564)
+ * bounds on the displayed price and reports `priceBounds`.
+ * Read-only public data; prices here are display-only (charges always
+ * come from the docs server-side).
+ *
+ * Extracted from the handler (AGL-659) so the site-page enricher seeds a
+ * grid's first page through THIS function rather than a reimplementation
+ * of it. A seed that filters or sorts differently from the API would
+ * server-render one set of products and hydrate to another.
+ */ export async function queryPublicCatalog(params) {
+    var _params_collectionSlug, _params_categorySlug, _params_collectionId, _params_categoryId, _params_tag, _params_query, _params_type, _params_ids, _params_limit, _params_offset;
+    var _categoriesSnapshot_docs_;
+    const { hostId } = params;
+    const collectionSlug = (_params_collectionSlug = params.collectionSlug) != null ? _params_collectionSlug : '';
+    const categorySlug = (_params_categorySlug = params.categorySlug) != null ? _params_categorySlug : '';
+    // Id-based filters are preferred (rename-safe, AGL-343); slugs remain
+    // for legacy screens and template-URL resolution.
+    const collectionIdParam = (_params_collectionId = params.collectionId) != null ? _params_collectionId : '';
+    const categoryIdParam = (_params_categoryId = params.categoryId) != null ? _params_categoryId : '';
+    const tag = (_params_tag = params.tag) != null ? _params_tag : '';
+    const query = (_params_query = params.query) != null ? _params_query : '';
+    const type = [
+        'physical',
+        'digital',
+        'service'
+    ].includes((_params_type = params.type) != null ? _params_type : '') ? params.type : '';
+    const ids = ((_params_ids = params.ids) != null ? _params_ids : []).slice(0, 100);
+    const minPriceCents = params.minPriceCents;
+    const maxPriceCents = params.maxPriceCents;
+    const sort = params.sort || 'name';
+    const max = Math.min(100, Math.max(1, Number((_params_limit = params.limit) != null ? _params_limit : 24)));
+    const offset = Math.max(0, Math.round(Number((_params_offset = params.offset) != null ? _params_offset : 0)) || 0);
+    const wantFacets = Boolean(params.facets);
+    const firestore = firebaseAdmin.app().firestore();
+    const hostRef = firestore.collection('hosts').doc(hostId);
+    const reads = params.reads;
+    // Assigned into the scope BEFORE it is awaited, so grids running together
+    // under one `Promise.all` share the single in-flight read rather than each
+    // starting their own and racing to store it.
+    const sharedProducts = ()=>{
+        var _reads, _products;
+        return reads ? (_products = (_reads = reads).products) != null ? _products : _reads.products = hostRef.collection('products').limit(500).get() : hostRef.collection('products').limit(500).get();
+    };
+    const sharedCategories = ()=>{
+        var _reads, _categories;
+        return reads ? (_categories = (_reads = reads).categories) != null ? _categories : _reads.categories = hostRef.collection('productCategories').limit(200).get() : hostRef.collection('productCategories').limit(200).get();
+    };
+    const [productsSnapshot, collectionsSnapshot, categoriesSnapshot, collectionByIdSnapshot, facetsSnapshot] = await Promise.all([
+        sharedProducts(),
+        // limit(5) not 1: content collections share this path and a slug is
+        // unique only within a kind (AGL-954) — the catalog match is picked
+        // out below rather than trusting whichever doc came back first.
+        !collectionIdParam && collectionSlug ? hostRef.collection('collections').where('slug', '==', collectionSlug).limit(5).get() : null,
+        !categoryIdParam && categorySlug ? hostRef.collection('productCategories').where('slug', '==', categorySlug).limit(1).get() : null,
+        collectionIdParam ? hostRef.collection('collections').doc(collectionIdParam).get() : null,
+        wantFacets ? sharedCategories() : null
+    ]);
+    const collectionById = (collectionByIdSnapshot == null ? void 0 : collectionByIdSnapshot.exists) && Aglyn.hostCollectionKind(collectionByIdSnapshot.data()) === 'catalog' ? collectionByIdSnapshot : undefined;
+    const collection = collectionById != null ? collectionById : collectionsSnapshot == null ? void 0 : collectionsSnapshot.docs.find((docSnapshot)=>Aglyn.hostCollectionKind(docSnapshot.data()) === 'catalog');
+    const categoryId = categoryIdParam || (categoriesSnapshot == null ? void 0 : (_categoriesSnapshot_docs_ = categoriesSnapshot.docs[0]) == null ? void 0 : _categoriesSnapshot_docs_.id);
+    let products = productsSnapshot.docs.map((docSnapshot)=>_extends({}, CommerceModel.liftLegacyProduct(docSnapshot.data()), {
+            $id: docSnapshot.id
+        })).filter((product)=>!product.deletedAt && product.status === 'active');
+    if (collection) {
+        const shaped = collection.data();
+        products = products.filter((product)=>CommerceModel.matchesCollection(product, shaped, product.$id));
+        if (shaped.mode === 'manual') {
+            var _shaped_productIds;
+            const order = new Map(((_shaped_productIds = shaped.productIds) != null ? _shaped_productIds : []).map((id, index)=>[
+                    id,
+                    index
+                ]));
+            products.sort((a, b)=>{
+                var _order_get, _order_get1;
+                return ((_order_get = order.get(a.$id)) != null ? _order_get : 999) - ((_order_get1 = order.get(b.$id)) != null ? _order_get1 : 999);
+            });
+        }
+    }
+    if (categoryId) {
+        products = products.filter((product)=>{
+            var _product_categoryIds;
+            return ((_product_categoryIds = product.categoryIds) != null ? _product_categoryIds : []).includes(categoryId);
+        });
+    }
+    if (tag) {
+        products = products.filter((product)=>{
+            var _product_tags;
+            return ((_product_tags = product.tags) != null ? _product_tags : []).includes(tag);
+        });
+    }
+    // Storefront catalog UX (AGL-561): type filter + text search.
+    if (type) {
+        products = products.filter((product)=>product.type === type);
+    }
+    if (query.trim()) {
+        products = products.filter((product)=>matchesCatalogQuery(product, query));
+    }
+    // Wishlist rendering (AGL-297): explicit id list, given order.
+    if (ids.length) {
+        const order = new Map(ids.map((id, index)=>[
+                id,
+                index
+            ]));
+        products = products.filter((product)=>order.has(product.$id)).sort((a, b)=>{
+            var _order_get, _order_get1;
+            return ((_order_get = order.get(a.$id)) != null ? _order_get : 0) - ((_order_get1 = order.get(b.$id)) != null ? _order_get1 : 0);
+        });
+    }
+    // Price facets + filter (AGL-564): bounds are computed before the
+    // price filter (with everything else applied) so the grid's slider
+    // stays anchored while the visitor narrows it. Both use the
+    // displayed price — the low end of the variant range grid cards
+    // show — so filtering matches what visitors see.
+    const priceBounds = wantFacets && products.length ? {
+        minCents: Math.min(...products.map(displayedPriceCents)),
+        maxCents: Math.max(...products.map(displayedPriceCents))
+    } : undefined;
+    if (minPriceCents != null || maxPriceCents != null) {
+        products = products.filter((product)=>{
+            const cents = displayedPriceCents(product);
+            return (minPriceCents == null || cents >= minPriceCents) && (maxPriceCents == null || cents <= maxPriceCents);
+        });
+    }
+    if (sort === 'price-asc' || sort === 'price-desc') {
+        products.sort((a, b)=>{
+            const [minA] = CommerceModel.productPriceRange(a);
+            const [minB] = CommerceModel.productPriceRange(b);
+            return sort === 'price-asc' ? minA - minB : minB - minA;
+        });
+    } else if (sort === 'newest') {
+        products.sort((a, b)=>{
+            var _b_createdAtMs, _a_createdAtMs;
+            return ((_b_createdAtMs = b.createdAtMs) != null ? _b_createdAtMs : 0) - ((_a_createdAtMs = a.createdAtMs) != null ? _a_createdAtMs : 0);
+        });
+    } else if (!ids.length && (!collection || collection.data().mode !== 'manual')) {
+        products.sort((a, b)=>a.name.localeCompare(b.name));
+    }
+    // Offset paging (AGL-561): grids pass `offset` for Load more;
+    // `nextOffset` comes back only while more filtered items remain.
+    const page = products.slice(offset, offset + max);
+    const nextOffset = offset + max < products.length ? offset + max : undefined;
+    const items = page.map((product)=>{
+        var _ref;
+        var _product_mediaUrls, _product_mediaUrls1, _product_tags;
+        const [minPrice, maxPrice] = CommerceModel.productPriceRange(product);
+        const primary = product.variants[0];
+        const inventory = CommerceModel.productInventory(product);
+        return _extends({
+            id: product.$id,
+            name: product.name,
+            slug: product.slug,
+            type: product.type,
+            priceUsd: minPrice,
+            maxPriceUsd: maxPrice
+        }, (primary == null ? void 0 : primary.compareAtPriceUsd) ? {
+            compareAtPriceUsd: primary.compareAtPriceUsd
+        } : {}, ((_product_mediaUrls = product.mediaUrls) == null ? void 0 : _product_mediaUrls[0]) || product.imageUrl ? {
+            imageUrl: (_ref = (_product_mediaUrls1 = product.mediaUrls) == null ? void 0 : _product_mediaUrls1[0]) != null ? _ref : product.imageUrl
+        } : {}, {
+            soldOut: inventory != null && inventory <= 0 && product.oversellPolicy !== 'backorder'
+        }, ((_product_tags = product.tags) == null ? void 0 : _product_tags.length) ? {
+            tags: product.tags
+        } : {});
+    });
+    // Category facets (AGL-561): id/name/slug for grid filter chips,
+    // parent-tree order preserved (order, then name).
+    const categories = facetsSnapshot ? facetsSnapshot.docs.map((docSnapshot)=>{
+        var _data_name, _data_slug, _data_order;
+        const data = docSnapshot.data();
+        return {
+            id: docSnapshot.id,
+            name: String((_data_name = data.name) != null ? _data_name : ''),
+            slug: String((_data_slug = data.slug) != null ? _data_slug : ''),
+            order: Number((_data_order = data.order) != null ? _data_order : 0)
+        };
+    }).sort((a, b)=>a.order - b.order || a.name.localeCompare(b.name)).map(({ id, name, slug })=>({
+            id,
+            name,
+            slug
+        })) : undefined;
+    return _extends({
+        items
+    }, nextOffset != null ? {
+        nextOffset
+    } : {}, categories ? {
+        categories
+    } : {}, priceBounds ? {
+        priceBounds
+    } : {});
+}
+/** Public catalog listing endpoint — a thin parse over queryPublicCatalog. */ export const catalogHandler = async (req, res)=>{
+    var _req_query_hostId;
+    const hostId = String((_req_query_hostId = req.query.hostId) != null ? _req_query_hostId : '');
+    if (!hostId) return res.status(400).json({
+        error: 'Missing hostId'
+    });
+    try {
+        var _req_query_collection, _req_query_category, _req_query_collectionId, _req_query_categoryId, _req_query_tag, _req_query_q, _req_query_type, _req_query_ids, _req_query_sort, _req_query_limit, _req_query_offset, _req_query_facets;
+        const result = await queryPublicCatalog({
+            hostId,
+            collectionSlug: String((_req_query_collection = req.query.collection) != null ? _req_query_collection : ''),
+            categorySlug: String((_req_query_category = req.query.category) != null ? _req_query_category : ''),
+            collectionId: String((_req_query_collectionId = req.query.collectionId) != null ? _req_query_collectionId : ''),
+            categoryId: String((_req_query_categoryId = req.query.categoryId) != null ? _req_query_categoryId : ''),
+            tag: String((_req_query_tag = req.query.tag) != null ? _req_query_tag : ''),
+            query: String((_req_query_q = req.query.q) != null ? _req_query_q : ''),
+            type: String((_req_query_type = req.query.type) != null ? _req_query_type : ''),
+            ids: String((_req_query_ids = req.query.ids) != null ? _req_query_ids : '').split(',').map((id)=>id.trim()).filter(Boolean),
+            // Price-range filter (AGL-564): integer cents on the displayed price.
+            minPriceCents: parsePriceCents(req.query.minPriceCents),
+            maxPriceCents: parsePriceCents(req.query.maxPriceCents),
+            sort: String((_req_query_sort = req.query.sort) != null ? _req_query_sort : 'name'),
+            limit: Number((_req_query_limit = req.query.limit) != null ? _req_query_limit : 24),
+            offset: Number((_req_query_offset = req.query.offset) != null ? _req_query_offset : 0),
+            facets: String((_req_query_facets = req.query.facets) != null ? _req_query_facets : '') === '1'
+        });
+        res.setHeader('Cache-Control', 'public, s-maxage=60, stale-while-revalidate=300');
+        return res.status(200).json(result);
+    } catch (error) {
+        console.error(error);
+        return res.status(500).json({
+            error: 'Catalog unavailable'
+        });
+    }
+};
+
+//# sourceMappingURL=catalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/catalog.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 } from '@aglyn/tenant-data-admin'\n\nexport interface PublicCatalogItem {\n  id: string\n  name: string\n  slug: string\n  type: CommerceModel.ProductType\n  priceUsd: number\n  maxPriceUsd: number\n  compareAtPriceUsd?: number\n  imageUrl?: string\n  soldOut: boolean\n  tags?: string[]\n}\n\n/** Host category surfaced to grids for filter chips (AGL-561). */\nexport interface PublicCatalogCategory {\n  id: string\n  name: string\n  slug: string\n}\n\n/** Price facet surfaced to grids to bound a range slider (AGL-564). */\nexport interface PublicCatalogPriceBounds {\n  minCents: number\n  maxCents: number\n}\n\n/**\n * Displayed price in cents (AGL-564): the low end of the variant range —\n * the number grid cards render (`$X` / `From $X`) — so price filtering\n * matches what visitors see.\n */\nexport function displayedPriceCents(\n  product: Pick<CommerceModel.HostProduct, 'variants'>,\n): number {\n  return Math.round(CommerceModel.productPriceRange(product)[0] * 100)\n}\n\n/** Non-negative integer cents from a query param; undefined otherwise. */\nfunction parsePriceCents(value: unknown): number | undefined {\n  const raw = String(value ?? '').trim()\n  if (!raw) return undefined\n  const cents = Number(raw)\n  if (!Number.isFinite(cents) || cents < 0) return undefined\n  return Math.round(cents)\n}\n\n/**\n * Case-insensitive catalog search (AGL-561): matches the product name,\n * description, or any tag. An empty/blank query matches everything.\n */\nexport function matchesCatalogQuery(\n  product: Pick<CommerceModel.HostProduct, 'name' | 'description' | 'tags'>,\n  query: string,\n): boolean {\n  const needle = query.trim().toLowerCase()\n  if (!needle) return true\n  return (\n    product.name.toLowerCase().includes(needle) ||\n    (product.description ?? '').toLowerCase().includes(needle) ||\n    (product.tags ?? []).some((tag) => tag.toLowerCase().includes(needle))\n  )\n}\n\n/** A catalog query, already parsed and bounded. */\nexport interface PublicCatalogQuery {\n  hostId: string\n  collectionId?: string\n  collectionSlug?: string\n  categoryId?: string\n  categorySlug?: string\n  tag?: string\n  /** Free-text search over name, description and tags. */\n  query?: string\n  type?: CommerceModel.ProductType | ''\n  /** Explicit id list in the given order (wishlist rendering, AGL-297). */\n  ids?: string[]\n  minPriceCents?: number\n  maxPriceCents?: number\n  sort?: string\n  /** Page size, 1–100. */\n  limit?: number\n  offset?: number\n  /** Include category + price facets in the result. */\n  facets?: boolean\n  /**\n   * Optional per-render dedupe (see {@link CatalogReadScope}). Absent for a\n   * one-off call such as the API route, where there is nothing to share with.\n   */\n  reads?: CatalogReadScope\n}\n\n/**\n * Reads shared by every catalog query in ONE render, for ONE host.\n *\n * The products read does not vary with the query — the whole catalog is\n * fetched and then filtered in memory by collection, category, tag, price and\n * search text. A page carrying four product grids therefore issued four\n * identical 500-document reads and threw three of them away.\n *\n * This shares the READ, never the RESULT. Each grid still filters and sorts\n * the shared snapshot independently, because a collection-scoped grid and an\n * all-products grid on the same page must not receive each other's items.\n *\n * Scoped to one host and one render deliberately: it holds a promise, not\n * data, so nothing is cached across requests and no staleness window opens.\n * Reusing a scope for a second host would serve that host the first one's\n * catalog, which is why it is created per render rather than per module.\n */\nexport interface CatalogReadScope {\n  products?: Promise<FirebaseFirestore.QuerySnapshot>\n  categories?: Promise<FirebaseFirestore.QuerySnapshot>\n}\n\n/** A fresh read scope. One per render, never reused across hosts. */\nexport function createCatalogReadScope(): CatalogReadScope {\n  return {}\n}\n\n/** What both the API route and the SSR seed hand to a product grid. */\nexport interface PublicCatalogResult {\n  items: PublicCatalogItem[]\n  nextOffset?: number\n  categories?: PublicCatalogCategory[]\n  priceBounds?: PublicCatalogPriceBounds\n}\n\n/**\n * Public catalog listing (AGL-291): active products for storefront\n * blocks — filterable by collection/category slug or tag, sortable,\n * capped at 100 items per request. Storefront catalog UX (AGL-561)\n * adds text search, a product-type filter, offset paging (for Load\n * more), and facets for filter chips. The price-range filter (AGL-564)\n * bounds on the displayed price and reports `priceBounds`.\n * Read-only public data; prices here are display-only (charges always\n * come from the docs server-side).\n *\n * Extracted from the handler (AGL-659) so the site-page enricher seeds a\n * grid's first page through THIS function rather than a reimplementation\n * of it. A seed that filters or sorts differently from the API would\n * server-render one set of products and hydrate to another.\n */\nexport async function queryPublicCatalog(\n  params: PublicCatalogQuery,\n): Promise<PublicCatalogResult> {\n  const { hostId } = params\n  const collectionSlug = params.collectionSlug ?? ''\n  const categorySlug = params.categorySlug ?? ''\n  // Id-based filters are preferred (rename-safe, AGL-343); slugs remain\n  // for legacy screens and template-URL resolution.\n  const collectionIdParam = params.collectionId ?? ''\n  const categoryIdParam = params.categoryId ?? ''\n  const tag = params.tag ?? ''\n  const query = params.query ?? ''\n  const type = ['physical', 'digital', 'service'].includes(params.type ?? '')\n    ? (params.type as CommerceModel.ProductType)\n    : ''\n  const ids = (params.ids ?? []).slice(0, 100)\n  const minPriceCents = params.minPriceCents\n  const maxPriceCents = params.maxPriceCents\n  const sort = params.sort || 'name'\n  const max = Math.min(100, Math.max(1, Number(params.limit ?? 24)))\n  const offset = Math.max(0, Math.round(Number(params.offset ?? 0)) || 0)\n  const wantFacets = Boolean(params.facets)\n\n  const firestore = firebaseAdmin.app().firestore()\n  const hostRef = firestore.collection('hosts').doc(hostId)\n  const reads = params.reads\n  // Assigned into the scope BEFORE it is awaited, so grids running together\n  // under one `Promise.all` share the single in-flight read rather than each\n  // starting their own and racing to store it.\n  const sharedProducts = () =>\n    (reads\n      ? (reads.products ??= hostRef.collection('products').limit(500).get())\n      : hostRef.collection('products').limit(500).get())\n  const sharedCategories = () =>\n    (reads\n      ? (reads.categories ??=\n          hostRef.collection('productCategories').limit(200).get())\n      : hostRef.collection('productCategories').limit(200).get())\n  const [\n    productsSnapshot,\n    collectionsSnapshot,\n    categoriesSnapshot,\n    collectionByIdSnapshot,\n    facetsSnapshot,\n  ] =\n    await Promise.all([\n      sharedProducts(),\n      // limit(5) not 1: content collections share this path and a slug is\n      // unique only within a kind (AGL-954) — the catalog match is picked\n      // out below rather than trusting whichever doc came back first.\n      !collectionIdParam && collectionSlug\n        ? hostRef\n            .collection('collections')\n            .where('slug', '==', collectionSlug)\n            .limit(5)\n            .get()\n        : null,\n      !categoryIdParam && categorySlug\n        ? hostRef\n            .collection('productCategories')\n            .where('slug', '==', categorySlug)\n            .limit(1)\n            .get()\n        : null,\n      collectionIdParam\n        ? hostRef.collection('collections').doc(collectionIdParam).get()\n        : null,\n      wantFacets ? sharedCategories() : null,\n    ])\n  const collectionById =\n    collectionByIdSnapshot?.exists &&\n    Aglyn.hostCollectionKind(collectionByIdSnapshot.data()) === 'catalog'\n      ? collectionByIdSnapshot\n      : undefined\n  const collection =\n    collectionById ??\n    collectionsSnapshot?.docs.find(\n      (docSnapshot) => Aglyn.hostCollectionKind(docSnapshot.data()) === 'catalog',\n    )\n  const categoryId = categoryIdParam || categoriesSnapshot?.docs[0]?.id\n\n  let products = productsSnapshot.docs\n    .map((docSnapshot) => ({\n      ...CommerceModel.liftLegacyProduct(docSnapshot.data() as any),\n      $id: docSnapshot.id,\n    }))\n    .filter((product) => !product.deletedAt && product.status === 'active')\n  if (collection) {\n    const shaped = collection.data() as CommerceModel.HostCollection\n    products = products.filter((product) =>\n      CommerceModel.matchesCollection(product, shaped, product.$id),\n    )\n    if (shaped.mode === 'manual') {\n      const order = new Map(\n        (shaped.productIds ?? []).map((id, index) => [id, index]),\n      )\n      products.sort(\n        (a, b) => (order.get(a.$id) ?? 999) - (order.get(b.$id) ?? 999),\n      )\n    }\n  }\n  if (categoryId) {\n    products = products.filter((product) =>\n      (product.categoryIds ?? []).includes(categoryId),\n    )\n  }\n  if (tag) {\n    products = products.filter((product) =>\n      (product.tags ?? []).includes(tag),\n    )\n  }\n  // Storefront catalog UX (AGL-561): type filter + text search.\n  if (type) {\n    products = products.filter((product) => product.type === type)\n  }\n  if (query.trim()) {\n    products = products.filter((product) =>\n      matchesCatalogQuery(product, query),\n    )\n  }\n  // Wishlist rendering (AGL-297): explicit id list, given order.\n  if (ids.length) {\n    const order = new Map(ids.map((id, index) => [id, index]))\n    products = products\n      .filter((product) => order.has(product.$id))\n      .sort((a, b) => (order.get(a.$id) ?? 0) - (order.get(b.$id) ?? 0))\n  }\n  // Price facets + filter (AGL-564): bounds are computed before the\n  // price filter (with everything else applied) so the grid's slider\n  // stays anchored while the visitor narrows it. Both use the\n  // displayed price — the low end of the variant range grid cards\n  // show — so filtering matches what visitors see.\n  const priceBounds: PublicCatalogPriceBounds | undefined =\n    wantFacets && products.length\n      ? {\n          minCents: Math.min(...products.map(displayedPriceCents)),\n          maxCents: Math.max(...products.map(displayedPriceCents)),\n        }\n      : undefined\n  if (minPriceCents != null || maxPriceCents != null) {\n    products = products.filter((product) => {\n      const cents = displayedPriceCents(product)\n      return (\n        (minPriceCents == null || cents >= minPriceCents) &&\n        (maxPriceCents == null || cents <= maxPriceCents)\n      )\n    })\n  }\n  if (sort === 'price-asc' || sort === 'price-desc') {\n    products.sort((a, b) => {\n      const [minA] = CommerceModel.productPriceRange(a)\n      const [minB] = CommerceModel.productPriceRange(b)\n      return sort === 'price-asc' ? minA - minB : minB - minA\n    })\n  } else if (sort === 'newest') {\n    products.sort((a, b) => (b.createdAtMs ?? 0) - (a.createdAtMs ?? 0))\n  } else if (\n    !ids.length &&\n    (!collection || (collection.data() as any).mode !== 'manual')\n  ) {\n    products.sort((a, b) => a.name.localeCompare(b.name))\n  }\n\n  // Offset paging (AGL-561): grids pass `offset` for Load more;\n  // `nextOffset` comes back only while more filtered items remain.\n  const page = products.slice(offset, offset + max)\n  const nextOffset =\n    offset + max < products.length ? offset + max : undefined\n\n  const items: PublicCatalogItem[] = page.map((product) => {\n    const [minPrice, maxPrice] = CommerceModel.productPriceRange(product)\n    const primary = product.variants[0]\n    const inventory = CommerceModel.productInventory(product)\n    return {\n      id: product.$id,\n      name: product.name,\n      slug: product.slug,\n      type: product.type,\n      priceUsd: minPrice,\n      maxPriceUsd: maxPrice,\n      ...(primary?.compareAtPriceUsd\n        ? { compareAtPriceUsd: primary.compareAtPriceUsd }\n        : {}),\n      ...(product.mediaUrls?.[0] || product.imageUrl\n        ? { imageUrl: product.mediaUrls?.[0] ?? product.imageUrl }\n        : {}),\n      soldOut:\n        inventory != null &&\n        inventory <= 0 &&\n        product.oversellPolicy !== 'backorder',\n      ...(product.tags?.length ? { tags: product.tags } : {}),\n    }\n  })\n  // Category facets (AGL-561): id/name/slug for grid filter chips,\n  // parent-tree order preserved (order, then name).\n  const categories: PublicCatalogCategory[] | undefined = facetsSnapshot\n    ? facetsSnapshot.docs\n        .map((docSnapshot) => {\n          const data = docSnapshot.data() as CommerceModel.ProductCategory\n          return {\n            id: docSnapshot.id,\n            name: String(data.name ?? ''),\n            slug: String(data.slug ?? ''),\n            order: Number(data.order ?? 0),\n          }\n        })\n        .sort((a, b) => a.order - b.order || a.name.localeCompare(b.name))\n        .map(({ id, name, slug }) => ({ id, name, slug }))\n    : undefined\n\n  return {\n    items,\n    ...(nextOffset != null ? { nextOffset } : {}),\n    ...(categories ? { categories } : {}),\n    ...(priceBounds ? { priceBounds } : {}),\n  }\n}\n\n/** Public catalog listing endpoint — a thin parse over queryPublicCatalog. */\nexport const catalogHandler: PluginApiHandler = async (req, res) => {\n  const hostId = String(req.query.hostId ?? '')\n  if (!hostId) return res.status(400).json({ error: 'Missing hostId' })\n\n  try {\n    const result = await queryPublicCatalog({\n      hostId,\n      collectionSlug: String(req.query.collection ?? ''),\n      categorySlug: String(req.query.category ?? ''),\n      collectionId: String(req.query.collectionId ?? ''),\n      categoryId: String(req.query.categoryId ?? ''),\n      tag: String(req.query.tag ?? ''),\n      query: String(req.query.q ?? ''),\n      type: String(req.query.type ?? '') as CommerceModel.ProductType | '',\n      ids: String(req.query.ids ?? '')\n        .split(',')\n        .map((id) => id.trim())\n        .filter(Boolean),\n      // Price-range filter (AGL-564): integer cents on the displayed price.\n      minPriceCents: parsePriceCents(req.query.minPriceCents),\n      maxPriceCents: parsePriceCents(req.query.maxPriceCents),\n      sort: String(req.query.sort ?? 'name'),\n      limit: Number(req.query.limit ?? 24),\n      offset: Number(req.query.offset ?? 0),\n      facets: String(req.query.facets ?? '') === '1',\n    })\n    res.setHeader(\n      'Cache-Control',\n      'public, s-maxage=60, stale-while-revalidate=300',\n    )\n    return res.status(200).json(result)\n  } catch (error) {\n    console.error(error)\n    return res.status(500).json({ error: 'Catalog unavailable' })\n  }\n}\n"],"names":["Aglyn","CommerceModel","firebaseAdmin","displayedPriceCents","product","Math","round","productPriceRange","parsePriceCents","value","raw","String","trim","undefined","cents","Number","isFinite","matchesCatalogQuery","query","needle","toLowerCase","name","includes","description","tags","some","tag","createCatalogReadScope","queryPublicCatalog","params","categoriesSnapshot","hostId","collectionSlug","categorySlug","collectionIdParam","collectionId","categoryIdParam","categoryId","type","ids","slice","minPriceCents","maxPriceCents","sort","max","min","limit","offset","wantFacets","Boolean","facets","firestore","app","hostRef","collection","doc","reads","sharedProducts","products","get","sharedCategories","categories","productsSnapshot","collectionsSnapshot","collectionByIdSnapshot","facetsSnapshot","Promise","all","where","collectionById","exists","hostCollectionKind","data","docs","find","docSnapshot","id","map","liftLegacyProduct","$id","filter","deletedAt","status","shaped","matchesCollection","mode","order","Map","productIds","index","a","b","categoryIds","length","has","priceBounds","minCents","maxCents","minA","minB","createdAtMs","localeCompare","page","nextOffset","items","minPrice","maxPrice","primary","variants","inventory","productInventory","slug","priceUsd","maxPriceUsd","compareAtPriceUsd","mediaUrls","imageUrl","soldOut","oversellPolicy","catalogHandler","req","res","json","error","result","category","q","split","setHeader","console"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,YAAYA,WAAW,sBAAqB;AAC5C,YAAYC,mBAAmB,oBAAU;AACzC,SAASC,aAAa,QAAQ,2BAA0B;AA4BxD;;;;CAIC,GACD,OAAO,SAASC,oBACdC,OAAoD;IAEpD,OAAOC,KAAKC,KAAK,CAACL,cAAcM,iBAAiB,CAACH,QAAQ,CAAC,EAAE,GAAG;AAClE;AAEA,wEAAwE,GACxE,SAASI,gBAAgBC,KAAc;IACrC,MAAMC,MAAMC,OAAOF,gBAAAA,QAAS,IAAIG,IAAI;IACpC,IAAI,CAACF,KAAK,OAAOG;IACjB,MAAMC,QAAQC,OAAOL;IACrB,IAAI,CAACK,OAAOC,QAAQ,CAACF,UAAUA,QAAQ,GAAG,OAAOD;IACjD,OAAOR,KAAKC,KAAK,CAACQ;AACpB;AAEA;;;CAGC,GACD,OAAO,SAASG,oBACdb,OAAyE,EACzEc,KAAa;QAMVd,sBACAA;IALH,MAAMe,SAASD,MAAMN,IAAI,GAAGQ,WAAW;IACvC,IAAI,CAACD,QAAQ,OAAO;IACpB,OACEf,QAAQiB,IAAI,CAACD,WAAW,GAAGE,QAAQ,CAACH,WACpC,EAACf,uBAAAA,QAAQmB,WAAW,YAAnBnB,uBAAuB,IAAIgB,WAAW,GAAGE,QAAQ,CAACH,WACnD,EAACf,gBAAAA,QAAQoB,IAAI,YAAZpB,gBAAgB,EAAE,EAAEqB,IAAI,CAAC,CAACC,MAAQA,IAAIN,WAAW,GAAGE,QAAQ,CAACH;AAElE;AAoDA,mEAAmE,GACnE,OAAO,SAASQ;IACd,OAAO,CAAC;AACV;AAUA;;;;;;;;;;;;;;CAcC,GACD,OAAO,eAAeC,mBACpBC,MAA0B;QAGHA,wBACFA,sBAGKA,sBACFA,oBACZA,aACEA,eAC2CA,cAG5CA,aAIgCA,eACAA;QA2DPC;IA5EtC,MAAM,EAAEC,MAAM,EAAE,GAAGF;IACnB,MAAMG,kBAAiBH,yBAAAA,OAAOG,cAAc,YAArBH,yBAAyB;IAChD,MAAMI,gBAAeJ,uBAAAA,OAAOI,YAAY,YAAnBJ,uBAAuB;IAC5C,sEAAsE;IACtE,kDAAkD;IAClD,MAAMK,qBAAoBL,uBAAAA,OAAOM,YAAY,YAAnBN,uBAAuB;IACjD,MAAMO,mBAAkBP,qBAAAA,OAAOQ,UAAU,YAAjBR,qBAAqB;IAC7C,MAAMH,OAAMG,cAAAA,OAAOH,GAAG,YAAVG,cAAc;IAC1B,MAAMX,SAAQW,gBAAAA,OAAOX,KAAK,YAAZW,gBAAgB;IAC9B,MAAMS,OAAO;QAAC;QAAY;QAAW;KAAU,CAAChB,QAAQ,EAACO,eAAAA,OAAOS,IAAI,YAAXT,eAAe,MACnEA,OAAOS,IAAI,GACZ;IACJ,MAAMC,MAAM,EAACV,cAAAA,OAAOU,GAAG,YAAVV,cAAc,EAAE,EAAEW,KAAK,CAAC,GAAG;IACxC,MAAMC,gBAAgBZ,OAAOY,aAAa;IAC1C,MAAMC,gBAAgBb,OAAOa,aAAa;IAC1C,MAAMC,OAAOd,OAAOc,IAAI,IAAI;IAC5B,MAAMC,MAAMvC,KAAKwC,GAAG,CAAC,KAAKxC,KAAKuC,GAAG,CAAC,GAAG7B,QAAOc,gBAAAA,OAAOiB,KAAK,YAAZjB,gBAAgB;IAC7D,MAAMkB,SAAS1C,KAAKuC,GAAG,CAAC,GAAGvC,KAAKC,KAAK,CAACS,QAAOc,iBAAAA,OAAOkB,MAAM,YAAblB,iBAAiB,OAAO;IACrE,MAAMmB,aAAaC,QAAQpB,OAAOqB,MAAM;IAExC,MAAMC,YAAYjD,cAAckD,GAAG,GAAGD,SAAS;IAC/C,MAAME,UAAUF,UAAUG,UAAU,CAAC,SAASC,GAAG,CAACxB;IAClD,MAAMyB,QAAQ3B,OAAO2B,KAAK;IAC1B,0EAA0E;IAC1E,2EAA2E;IAC3E,6CAA6C;IAC7C,MAAMC,iBAAiB;YAEhBD,QAAAA;eADJA,SACIA,YAAAA,CAAAA,SAAAA,OAAME,QAAQ,YAAdF,YAAAA,OAAME,QAAQ,GAAKL,QAAQC,UAAU,CAAC,YAAYR,KAAK,CAAC,KAAKa,GAAG,KACjEN,QAAQC,UAAU,CAAC,YAAYR,KAAK,CAAC,KAAKa,GAAG;;IACnD,MAAMC,mBAAmB;YAElBJ,QAAAA;eADJA,SACIA,cAAAA,CAAAA,SAAAA,OAAMK,UAAU,YAAhBL,cAAAA,OAAMK,UAAU,GACfR,QAAQC,UAAU,CAAC,qBAAqBR,KAAK,CAAC,KAAKa,GAAG,KACxDN,QAAQC,UAAU,CAAC,qBAAqBR,KAAK,CAAC,KAAKa,GAAG;;IAC5D,MAAM,CACJG,kBACAC,qBACAjC,oBACAkC,wBACAC,eACD,GACC,MAAMC,QAAQC,GAAG,CAAC;QAChBV;QACA,oEAAoE;QACpE,oEAAoE;QACpE,gEAAgE;QAChE,CAACvB,qBAAqBF,iBAClBqB,QACGC,UAAU,CAAC,eACXc,KAAK,CAAC,QAAQ,MAAMpC,gBACpBc,KAAK,CAAC,GACNa,GAAG,KACN;QACJ,CAACvB,mBAAmBH,eAChBoB,QACGC,UAAU,CAAC,qBACXc,KAAK,CAAC,QAAQ,MAAMnC,cACpBa,KAAK,CAAC,GACNa,GAAG,KACN;QACJzB,oBACImB,QAAQC,UAAU,CAAC,eAAeC,GAAG,CAACrB,mBAAmByB,GAAG,KAC5D;QACJX,aAAaY,qBAAqB;KACnC;IACH,MAAMS,iBACJL,CAAAA,0CAAAA,uBAAwBM,MAAM,KAC9BtE,MAAMuE,kBAAkB,CAACP,uBAAuBQ,IAAI,QAAQ,YACxDR,yBACAnD;IACN,MAAMyC,aACJe,yBAAAA,iBACAN,uCAAAA,oBAAqBU,IAAI,CAACC,IAAI,CAC5B,CAACC,cAAgB3E,MAAMuE,kBAAkB,CAACI,YAAYH,IAAI,QAAQ;IAEtE,MAAMnC,aAAaD,oBAAmBN,uCAAAA,4BAAAA,mBAAoB2C,IAAI,CAAC,EAAE,qBAA3B3C,0BAA6B8C,EAAE;IAErE,IAAIlB,WAAWI,iBAAiBW,IAAI,CACjCI,GAAG,CAAC,CAACF,cAAiB,aAClB1E,cAAc6E,iBAAiB,CAACH,YAAYH,IAAI;YACnDO,KAAKJ,YAAYC,EAAE;YAEpBI,MAAM,CAAC,CAAC5E,UAAY,CAACA,QAAQ6E,SAAS,IAAI7E,QAAQ8E,MAAM,KAAK;IAChE,IAAI5B,YAAY;QACd,MAAM6B,SAAS7B,WAAWkB,IAAI;QAC9Bd,WAAWA,SAASsB,MAAM,CAAC,CAAC5E,UAC1BH,cAAcmF,iBAAiB,CAAChF,SAAS+E,QAAQ/E,QAAQ2E,GAAG;QAE9D,IAAII,OAAOE,IAAI,KAAK,UAAU;gBAEzBF;YADH,MAAMG,QAAQ,IAAIC,IAChB,EAACJ,qBAAAA,OAAOK,UAAU,YAAjBL,qBAAqB,EAAE,EAAEN,GAAG,CAAC,CAACD,IAAIa,QAAU;oBAACb;oBAAIa;iBAAM;YAE1D/B,SAASf,IAAI,CACX,CAAC+C,GAAGC;oBAAOL,YAA4BA;uBAA7B,EAACA,aAAAA,MAAM3B,GAAG,CAAC+B,EAAEX,GAAG,aAAfO,aAAoB,SAAQA,cAAAA,MAAM3B,GAAG,CAACgC,EAAEZ,GAAG,aAAfO,cAAoB;;QAE/D;IACF;IACA,IAAIjD,YAAY;QACdqB,WAAWA,SAASsB,MAAM,CAAC,CAAC5E;gBACzBA;mBAAD,EAACA,uBAAAA,QAAQwF,WAAW,YAAnBxF,uBAAuB,EAAE,EAAEkB,QAAQ,CAACe;;IAEzC;IACA,IAAIX,KAAK;QACPgC,WAAWA,SAASsB,MAAM,CAAC,CAAC5E;gBACzBA;mBAAD,EAACA,gBAAAA,QAAQoB,IAAI,YAAZpB,gBAAgB,EAAE,EAAEkB,QAAQ,CAACI;;IAElC;IACA,8DAA8D;IAC9D,IAAIY,MAAM;QACRoB,WAAWA,SAASsB,MAAM,CAAC,CAAC5E,UAAYA,QAAQkC,IAAI,KAAKA;IAC3D;IACA,IAAIpB,MAAMN,IAAI,IAAI;QAChB8C,WAAWA,SAASsB,MAAM,CAAC,CAAC5E,UAC1Ba,oBAAoBb,SAASc;IAEjC;IACA,+DAA+D;IAC/D,IAAIqB,IAAIsD,MAAM,EAAE;QACd,MAAMP,QAAQ,IAAIC,IAAIhD,IAAIsC,GAAG,CAAC,CAACD,IAAIa,QAAU;gBAACb;gBAAIa;aAAM;QACxD/B,WAAWA,SACRsB,MAAM,CAAC,CAAC5E,UAAYkF,MAAMQ,GAAG,CAAC1F,QAAQ2E,GAAG,GACzCpC,IAAI,CAAC,CAAC+C,GAAGC;gBAAOL,YAA0BA;mBAA3B,EAACA,aAAAA,MAAM3B,GAAG,CAAC+B,EAAEX,GAAG,aAAfO,aAAoB,OAAMA,cAAAA,MAAM3B,GAAG,CAACgC,EAAEZ,GAAG,aAAfO,cAAoB;;IACnE;IACA,kEAAkE;IAClE,mEAAmE;IACnE,4DAA4D;IAC5D,gEAAgE;IAChE,iDAAiD;IACjD,MAAMS,cACJ/C,cAAcU,SAASmC,MAAM,GACzB;QACEG,UAAU3F,KAAKwC,GAAG,IAAIa,SAASmB,GAAG,CAAC1E;QACnC8F,UAAU5F,KAAKuC,GAAG,IAAIc,SAASmB,GAAG,CAAC1E;IACrC,IACAU;IACN,IAAI4B,iBAAiB,QAAQC,iBAAiB,MAAM;QAClDgB,WAAWA,SAASsB,MAAM,CAAC,CAAC5E;YAC1B,MAAMU,QAAQX,oBAAoBC;YAClC,OACE,AAACqC,CAAAA,iBAAiB,QAAQ3B,SAAS2B,aAAY,KAC9CC,CAAAA,iBAAiB,QAAQ5B,SAAS4B,aAAY;QAEnD;IACF;IACA,IAAIC,SAAS,eAAeA,SAAS,cAAc;QACjDe,SAASf,IAAI,CAAC,CAAC+C,GAAGC;YAChB,MAAM,CAACO,KAAK,GAAGjG,cAAcM,iBAAiB,CAACmF;YAC/C,MAAM,CAACS,KAAK,GAAGlG,cAAcM,iBAAiB,CAACoF;YAC/C,OAAOhD,SAAS,cAAcuD,OAAOC,OAAOA,OAAOD;QACrD;IACF,OAAO,IAAIvD,SAAS,UAAU;QAC5Be,SAASf,IAAI,CAAC,CAAC+C,GAAGC;gBAAOA,gBAAuBD;mBAAxB,EAACC,iBAAAA,EAAES,WAAW,YAAbT,iBAAiB,OAAMD,iBAAAA,EAAEU,WAAW,YAAbV,iBAAiB;;IACnE,OAAO,IACL,CAACnD,IAAIsD,MAAM,IACV,CAAA,CAACvC,cAAc,AAACA,WAAWkB,IAAI,GAAWa,IAAI,KAAK,QAAO,GAC3D;QACA3B,SAASf,IAAI,CAAC,CAAC+C,GAAGC,IAAMD,EAAErE,IAAI,CAACgF,aAAa,CAACV,EAAEtE,IAAI;IACrD;IAEA,8DAA8D;IAC9D,iEAAiE;IACjE,MAAMiF,OAAO5C,SAASlB,KAAK,CAACO,QAAQA,SAASH;IAC7C,MAAM2D,aACJxD,SAASH,MAAMc,SAASmC,MAAM,GAAG9C,SAASH,MAAM/B;IAElD,MAAM2F,QAA6BF,KAAKzB,GAAG,CAAC,CAACzE;;YAcrCA,oBACYA,qBAMZA;QApBN,MAAM,CAACqG,UAAUC,SAAS,GAAGzG,cAAcM,iBAAiB,CAACH;QAC7D,MAAMuG,UAAUvG,QAAQwG,QAAQ,CAAC,EAAE;QACnC,MAAMC,YAAY5G,cAAc6G,gBAAgB,CAAC1G;QACjD,OAAO;YACLwE,IAAIxE,QAAQ2E,GAAG;YACf1D,MAAMjB,QAAQiB,IAAI;YAClB0F,MAAM3G,QAAQ2G,IAAI;YAClBzE,MAAMlC,QAAQkC,IAAI;YAClB0E,UAAUP;YACVQ,aAAaP;WACTC,CAAAA,2BAAAA,QAASO,iBAAiB,IAC1B;YAAEA,mBAAmBP,QAAQO,iBAAiB;QAAC,IAC/C,CAAC,GACD9G,EAAAA,qBAAAA,QAAQ+G,SAAS,qBAAjB/G,kBAAmB,CAAC,EAAE,KAAIA,QAAQgH,QAAQ,GAC1C;YAAEA,QAAQ,WAAEhH,sBAAAA,QAAQ+G,SAAS,qBAAjB/G,mBAAmB,CAAC,EAAE,mBAAIA,QAAQgH,QAAQ;QAAC,IACvD,CAAC;YACLC,SACER,aAAa,QACbA,aAAa,KACbzG,QAAQkH,cAAc,KAAK;WACzBlH,EAAAA,gBAAAA,QAAQoB,IAAI,qBAAZpB,cAAcyF,MAAM,IAAG;YAAErE,MAAMpB,QAAQoB,IAAI;QAAC,IAAI,CAAC;IAEzD;IACA,iEAAiE;IACjE,kDAAkD;IAClD,MAAMqC,aAAkDI,iBACpDA,eAAeQ,IAAI,CAChBI,GAAG,CAAC,CAACF;YAIWH,YACAA,YACCA;QALhB,MAAMA,OAAOG,YAAYH,IAAI;QAC7B,OAAO;YACLI,IAAID,YAAYC,EAAE;YAClBvD,MAAMV,QAAO6D,aAAAA,KAAKnD,IAAI,YAATmD,aAAa;YAC1BuC,MAAMpG,QAAO6D,aAAAA,KAAKuC,IAAI,YAATvC,aAAa;YAC1Bc,OAAOvE,QAAOyD,cAAAA,KAAKc,KAAK,YAAVd,cAAc;QAC9B;IACF,GACC7B,IAAI,CAAC,CAAC+C,GAAGC,IAAMD,EAAEJ,KAAK,GAAGK,EAAEL,KAAK,IAAII,EAAErE,IAAI,CAACgF,aAAa,CAACV,EAAEtE,IAAI,GAC/DwD,GAAG,CAAC,CAAC,EAAED,EAAE,EAAEvD,IAAI,EAAE0F,IAAI,EAAE,GAAM,CAAA;YAAEnC;YAAIvD;YAAM0F;QAAK,CAAA,KACjDlG;IAEJ,OAAO;QACL2F;OACID,cAAc,OAAO;QAAEA;IAAW,IAAI,CAAC,GACvC1C,aAAa;QAAEA;IAAW,IAAI,CAAC,GAC/BkC,cAAc;QAAEA;IAAY,IAAI,CAAC;AAEzC;AAEA,4EAA4E,GAC5E,OAAO,MAAMwB,iBAAmC,OAAOC,KAAKC;QACpCD;IAAtB,MAAMzF,SAASpB,QAAO6G,oBAAAA,IAAItG,KAAK,CAACa,MAAM,YAAhByF,oBAAoB;IAC1C,IAAI,CAACzF,QAAQ,OAAO0F,IAAIvC,MAAM,CAAC,KAAKwC,IAAI,CAAC;QAAEC,OAAO;IAAiB;IAEnE,IAAI;YAGuBH,uBACFA,qBACAA,yBACFA,uBACPA,gBACEA,cACDA,iBACDA,gBAOCA,iBACCA,kBACCA,mBACAA;QAnBjB,MAAMI,SAAS,MAAMhG,mBAAmB;YACtCG;YACAC,gBAAgBrB,QAAO6G,wBAAAA,IAAItG,KAAK,CAACoC,UAAU,YAApBkE,wBAAwB;YAC/CvF,cAActB,QAAO6G,sBAAAA,IAAItG,KAAK,CAAC2G,QAAQ,YAAlBL,sBAAsB;YAC3CrF,cAAcxB,QAAO6G,0BAAAA,IAAItG,KAAK,CAACiB,YAAY,YAAtBqF,0BAA0B;YAC/CnF,YAAY1B,QAAO6G,wBAAAA,IAAItG,KAAK,CAACmB,UAAU,YAApBmF,wBAAwB;YAC3C9F,KAAKf,QAAO6G,iBAAAA,IAAItG,KAAK,CAACQ,GAAG,YAAb8F,iBAAiB;YAC7BtG,OAAOP,QAAO6G,eAAAA,IAAItG,KAAK,CAAC4G,CAAC,YAAXN,eAAe;YAC7BlF,MAAM3B,QAAO6G,kBAAAA,IAAItG,KAAK,CAACoB,IAAI,YAAdkF,kBAAkB;YAC/BjF,KAAK5B,QAAO6G,iBAAAA,IAAItG,KAAK,CAACqB,GAAG,YAAbiF,iBAAiB,IAC1BO,KAAK,CAAC,KACNlD,GAAG,CAAC,CAACD,KAAOA,GAAGhE,IAAI,IACnBoE,MAAM,CAAC/B;YACV,sEAAsE;YACtER,eAAejC,gBAAgBgH,IAAItG,KAAK,CAACuB,aAAa;YACtDC,eAAelC,gBAAgBgH,IAAItG,KAAK,CAACwB,aAAa;YACtDC,MAAMhC,QAAO6G,kBAAAA,IAAItG,KAAK,CAACyB,IAAI,YAAd6E,kBAAkB;YAC/B1E,OAAO/B,QAAOyG,mBAAAA,IAAItG,KAAK,CAAC4B,KAAK,YAAf0E,mBAAmB;YACjCzE,QAAQhC,QAAOyG,oBAAAA,IAAItG,KAAK,CAAC6B,MAAM,YAAhByE,oBAAoB;YACnCtE,QAAQvC,QAAO6G,oBAAAA,IAAItG,KAAK,CAACgC,MAAM,YAAhBsE,oBAAoB,QAAQ;QAC7C;QACAC,IAAIO,SAAS,CACX,iBACA;QAEF,OAAOP,IAAIvC,MAAM,CAAC,KAAKwC,IAAI,CAACE;IAC9B,EAAE,OAAOD,OAAO;QACdM,QAAQN,KAAK,CAACA;QACd,OAAOF,IAAIvC,MAAM,CAAC,KAAKwC,IAAI,CAAC;YAAEC,OAAO;QAAsB;IAC7D;AACF,EAAC"}

package/src/lib/server/checkout.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @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 { PluginApiHandler } from '@aglyn/aglyn/server';
+/**
+ * Commerce Starter checkout (AGL-90): a site visitor buys a product. The
+ * price ALWAYS comes from the host's product doc (never the request), the
+ * money goes to the host owner's Connect account (AGL-46 onboarding) as a
+ * DESTINATION charge, and the webhook records the order under the host.
+ * 501 without Stripe env.
+ *
+ * Two claims in this comment were stale and are corrected here (AGL-2295),
+ * both in the direction that matters:
+ *
+ *  - The fee is NOT "2%". It is `resolveTransactionFeePct(org, productType)`
+ *    — a per-plan, per-product-type ladder with per-org staff overrides,
+ *    resolved per request. 2% is one cell of sixteen (Starter, physical).
+ *  - Selling is gated on `commerce`, not on `marketplaceSelling` (AGL-470).
+ *    They are different entitlements on different plans: `marketplaceSelling`
+ *    gates the marketplace, and reading this comment as current would gate a
+ *    storefront on the wrong one.
+ */
+export declare const checkoutHandler: PluginApiHandler;