@aglyn/plugins-commerce 1.0.0-beta.218 → 1.0.0-beta.220

package/src/lib/components/console/site-member-purchases.component.js

@@ -0,0 +1,339 @@
+/**
+ * @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.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { ListPagination } from "@aglyn/shared-ui-jsx/components/list-pagination.component";
+import { TABLE_PAGE_SIZE_DEFAULT } from "@aglyn/shared-ui-jsx/const/table-pagination";
+import { ceilingedWindow, useFirestore, useFirestoreCollection } from "@aglyn/tenant-feature-instance";
+import { Chip, Divider, Stack, Typography } from "@mui/material";
+import { collection, documentId, limit, orderBy, query, where } from "firebase/firestore";
+import { useEffect, useMemo, useState } from "react";
+import { splitOrderReversal } from "../../model/commerce-dispute.js";
+import { computeLifetimePurchaseCents } from "../../model/site-member-purchases.js";
+const usd = (cents)=>`$${(cents / 100).toFixed(2)}`;
+/**
+ * How many order documents this reads for one member.
+ *
+ * A CEILING, not a page size: the lifetime-purchase figure above the list is
+ * summed from these rows, so every one it intends to count has to be held. A
+ * server page would make that headline number the total of ten orders and
+ * print it as a lifetime.
+ */ const ORDER_CEILING = 100;
+/** The same, for the subscriptions this member holds. */ const SUBSCRIPTION_CEILING = 25;
+/**
+ * The reversal suffix on one order row, split by the door the money left
+ * through (AGL-1810). `refundedCents` carries a lost chargeback as well as a
+ * refund (AGL-1787 puts both there deliberately), so rendering the whole
+ * figure as "refunded" told the merchant they chose a reversal a bank took.
+ * `computeLifetimePurchaseCents` keeps netting the total; only the label
+ * splits.
+ */ const reversalSuffix = (order)=>{
+    const { refundedCents, chargedBackCents } = splitOrderReversal(order);
+    return (refundedCents ? ` · refunded ${usd(refundedCents)}` : '') + (chargedBackCents ? ` · charged back ${usd(chargedBackCents)}` : '');
+};
+/** Display order number: v1 sequential `#1042`, else a doc-id stub. */ const orderNumber = (order)=>{
+    var _order_$id;
+    return order.number != null ? `#${order.number}` : `#${String((_order_$id = order.$id) != null ? _order_$id : '').slice(-6).toUpperCase()}`;
+};
+const orderCreatedMs = (order)=>{
+    var _order_createdAtMs, _ref;
+    var _order_createdAt;
+    return Number((_order_createdAtMs = order.createdAtMs) != null ? _order_createdAtMs : ((_ref = (_order_createdAt = order.createdAt) == null ? void 0 : _order_createdAt.seconds) != null ? _ref : 0) * 1000) || 0;
+};
+/**
+ * What a site user bought (AGL-546): the lifetime purchase total, the order
+ * history (the payment records — Stripe intent id and refunds included) and
+ * storefront subscriptions — the `siteMember` zone of the account's drawer.
+ *
+ * Orders match by email (mirrors membership-account, AGL-294) and sort
+ * client-side. The QUERY orders on the document name: `orderBy('createdAt')`
+ * would want a composite index and, worse, would drop every order missing the
+ * field, while an equality filter plus `orderBy(documentId())` rides the
+ * automatic single-field index and can drop nothing — a document's name
+ * cannot be absent. That makes the window total rather than a pseudo-random
+ * hundred, which is what the newest-first sort below was quietly disguising.
+ * `orders` reads are admin/editor-only in rules (AGL-502), so viewers get a
+ * note instead of history.
+ *
+ * One section per element, as a fragment: the zone is `bare`, and the drawer's
+ * own column spaces what it holds.
+ */ export function SiteMemberPurchases(props) {
+    var _member_$id, _member_email, _ref;
+    const { hostId, member } = props;
+    const firestore = useFirestore();
+    const memberId = String((_member_$id = member.$id) != null ? _member_$id : '');
+    const email = String((_member_email = member['email']) != null ? _member_email : '');
+    const { data: orderDocs, status: ordersStatus } = useFirestoreCollection(()=>email ? query(collection(firestore, 'hosts', hostId, 'orders'), where('customerEmail', '==', email), orderBy(documentId()), // One document past the ceiling, so "this member has more" is a
+        // fact. `length === 100` cannot tell a member with exactly a
+        // hundred orders from one with a thousand, and the difference is
+        // whether the lifetime figure above is a total or a floor.
+        limit(ORDER_CEILING + 1)) : null, [
+        firestore,
+        hostId,
+        email
+    ], {
+        idField: '$id'
+    });
+    const { rows: readOrders, truncated: ordersTruncated } = ceilingedWindow(orderDocs, ORDER_CEILING);
+    const orders = useMemo(()=>[
+            ...readOrders
+        ].sort((a, b)=>orderCreatedMs(b) - orderCreatedMs(a)), // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+        orderDocs
+    ]);
+    const lifetimeCents = useMemo(()=>computeLifetimePurchaseCents(orders), [
+        orders
+    ]);
+    /**
+   * The order query failed AND nothing came back with it (AGL-1066).
+   *
+   * The copy this gates blames the reader's ROLE, which is the right
+   * explanation for the denial this was written for — orders are
+   * admin/editor-only in rules. It is the wrong explanation once a stale
+   * SESSION can push a listen to `'error'` too, and flatly wrong when
+   * `persistentLocalCache` is still serving the rows: telling someone their
+   * role is insufficient while their orders sit right there is a support
+   * ticket about permissions that was never about permissions.
+   */ const ordersUnreadable = ordersStatus === 'error' && orders.length === 0;
+    const { data: subscriptionDocs } = useFirestoreCollection(()=>email ? query(collection(firestore, 'hosts', hostId, 'subscriptions'), where('customerEmail', '==', email), // The same decision as the orders above, for the same reason: a
+        // subscription written without `createdAt` would be hidden by a
+        // field ordering rather than mis-sorted by it.
+        orderBy(documentId()), limit(SUBSCRIPTION_CEILING + 1)) : null, [
+        firestore,
+        hostId,
+        email
+    ], {
+        idField: '$id'
+    });
+    const { rows: subscriptions, truncated: subscriptionsTruncated } = ceilingedWindow(subscriptionDocs, SUBSCRIPTION_CEILING);
+    // Product names for subscriptions, loaded only when any exist.
+    const { data: productDocs } = useFirestoreCollection(()=>{
+        var _ref;
+        return email && ((_ref = subscriptionDocs == null ? void 0 : subscriptionDocs.length) != null ? _ref : 0) > 0 ? query(collection(firestore, 'hosts', hostId, 'products'), // A LOOKUP, not a list — but the same ordering decision, so the
+        // hundred it reads is a reachable hundred rather than a sample,
+        // and a product past it degrades a subscription's label to its
+        // id rather than hiding the subscription.
+        orderBy(documentId()), limit(100)) : null;
+    }, [
+        firestore,
+        hostId,
+        email,
+        ((_ref = subscriptionDocs == null ? void 0 : subscriptionDocs.length) != null ? _ref : 0) > 0
+    ], {
+        idField: '$id'
+    });
+    /*==========================================
+   * BOTH LISTS PAGE IN MEMORY.
+   *
+   * Each ceiling is held whole, which is what lets the orders sort
+   * newest-first and the lifetime figure sum over all of them. A server page
+   * would have made both about ten rows instead of about this member.
+   *=========================================*/ const [orderPage, setOrderPage] = useState(0);
+    const [orderPageSize, setOrderPageSize] = useState(TABLE_PAGE_SIZE_DEFAULT);
+    const visibleOrders = useMemo(()=>orders.slice(orderPage * orderPageSize, orderPage * orderPageSize + orderPageSize), [
+        orders,
+        orderPage,
+        orderPageSize
+    ]);
+    const [subscriptionPage, setSubscriptionPage] = useState(0);
+    const [subscriptionPageSize, setSubscriptionPageSize] = useState(TABLE_PAGE_SIZE_DEFAULT);
+    const visibleSubscriptions = useMemo(()=>subscriptions.slice(subscriptionPage * subscriptionPageSize, subscriptionPage * subscriptionPageSize + subscriptionPageSize), [
+        subscriptions,
+        subscriptionPage,
+        subscriptionPageSize
+    ]);
+    /*
+   * A different member starts at page one. The drawer is reused for whoever
+   * is selected, so without this the next member opens three pages into a
+   * history they may not have — which renders as an empty list and reads as
+   * "this person never bought anything".
+   */ useEffect(()=>{
+        setOrderPage(0);
+        setSubscriptionPage(0);
+    }, [
+        memberId
+    ]);
+    const productNames = useMemo(()=>{
+        const map = {};
+        for (const product of productDocs != null ? productDocs : []){
+            var _product_name;
+            map[product.$id] = (_product_name = product.name) != null ? _product_name : product.$id;
+        }
+        return map;
+    }, [
+        productDocs
+    ]);
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            /*#__PURE__*/ _jsx(Divider, {
+                textAlign: "left",
+                children: 'Lifetime purchases'
+            }),
+            /*#__PURE__*/ _jsx(Typography, {
+                variant: "h6",
+                children: ordersUnreadable ? '—' : `${ordersTruncated ? 'at least ' : ''}${usd(lifetimeCents)}`
+            }),
+            /*#__PURE__*/ _jsxs(Typography, {
+                variant: "caption",
+                color: "text.secondary",
+                children: [
+                    'Charged order totals minus refunds; pending and canceled ' + 'orders excluded.',
+                    ordersTruncated ? ` Summed over the ${ORDER_CEILING} orders read here; this ` + 'member has more.' : ''
+                ]
+            }),
+            /*#__PURE__*/ _jsx(Divider, {
+                textAlign: "left",
+                children: 'Orders'
+            }),
+            ordersUnreadable ? /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                color: "text.secondary",
+                children: 'Order history needs the editor or admin role on this site.'
+            }) : orders.length === 0 ? /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                color: "text.secondary",
+                children: 'No orders yet.'
+            }) : visibleOrders.map((order)=>{
+                var _ref, _ref1, _order_status;
+                var _order_totals;
+                return /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 0,
+                    children: [
+                        /*#__PURE__*/ _jsxs(Stack, {
+                            direction: "row",
+                            spacing: 1,
+                            sx: {
+                                alignItems: 'center'
+                            },
+                            children: [
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "body2",
+                                    sx: {
+                                        flex: 1
+                                    },
+                                    noWrap: true,
+                                    children: `${orderNumber(order)} · ${usd(Number((_ref = (_ref1 = (_order_totals = order.totals) == null ? void 0 : _order_totals.totalCents) != null ? _ref1 : order.amountCents) != null ? _ref : 0) || 0)}`
+                                }),
+                                /*#__PURE__*/ _jsx(Chip, {
+                                    label: String((_order_status = order.status) != null ? _order_status : 'paid').replace('_', ' '),
+                                    size: "small",
+                                    variant: "outlined"
+                                })
+                            ]
+                        }),
+                        /*#__PURE__*/ _jsxs(Typography, {
+                            variant: "caption",
+                            color: "text.secondary",
+                            children: [
+                                orderCreatedMs(order) ? new Date(orderCreatedMs(order)).toLocaleDateString() : '—',
+                                reversalSuffix(order)
+                            ]
+                        }),
+                        order.paymentIntentId ? /*#__PURE__*/ _jsx(Typography, {
+                            variant: "caption",
+                            color: "text.secondary",
+                            sx: {
+                                fontFamily: 'monospace'
+                            },
+                            noWrap: true,
+                            children: order.paymentIntentId
+                        }) : null
+                    ]
+                }, order.$id);
+            }),
+            ordersUnreadable || orders.length === 0 ? null : /*#__PURE__*/ _jsx(ListPagination, {
+                page: orderPage,
+                pageSize: orderPageSize,
+                rowCount: visibleOrders.length,
+                // The orders held here — a slice of rows already read, so the
+                // total is exact for the window. The lifetime caption above is
+                // where the window's own shortfall is stated.
+                count: orders.length,
+                onPageChange: setOrderPage,
+                onPageSizeChange: setOrderPageSize
+            }),
+            subscriptions.length > 0 ? /*#__PURE__*/ _jsxs(_Fragment, {
+                children: [
+                    /*#__PURE__*/ _jsx(Divider, {
+                        textAlign: "left",
+                        children: 'Subscriptions'
+                    }),
+                    visibleSubscriptions.map((subscription)=>{
+                        var _ref, _productNames_subscription_productId, _subscription_invoicesCount, _subscription_status;
+                        var _subscription_totals;
+                        return /*#__PURE__*/ _jsxs(Stack, {
+                            direction: "row",
+                            spacing: 1,
+                            sx: {
+                                alignItems: 'center'
+                            },
+                            children: [
+                                /*#__PURE__*/ _jsxs(Stack, {
+                                    sx: {
+                                        flex: 1,
+                                        minWidth: 0
+                                    },
+                                    children: [
+                                        /*#__PURE__*/ _jsxs(Typography, {
+                                            variant: "body2",
+                                            noWrap: true,
+                                            children: [
+                                                (_ref = (_productNames_subscription_productId = productNames[subscription.productId]) != null ? _productNames_subscription_productId : subscription.productId) != null ? _ref : 'Subscription',
+                                                ((_subscription_totals = subscription.totals) == null ? void 0 : _subscription_totals.totalCents) != null ? ` · ${usd(Number(subscription.totals.totalCents) || 0)}${subscription.interval ? `/${subscription.interval}` : ''}` : ''
+                                            ]
+                                        }),
+                                        /*#__PURE__*/ _jsxs(Typography, {
+                                            variant: "caption",
+                                            color: "text.secondary",
+                                            children: [
+                                                subscription.currentPeriodEndMs ? `Renews ${new Date(Number(subscription.currentPeriodEndMs)).toLocaleDateString()}` : '—',
+                                                Number((_subscription_invoicesCount = subscription.invoicesCount) != null ? _subscription_invoicesCount : 0) > 0 ? ` · ${usd(Number(subscription.paidCents) || 0)} paid over ${Number(subscription.invoicesCount) === 1 ? '1 invoice' : `${Number(subscription.invoicesCount)} invoices`}` : ''
+                                            ]
+                                        })
+                                    ]
+                                }),
+                                /*#__PURE__*/ _jsx(Chip, {
+                                    label: String((_subscription_status = subscription.status) != null ? _subscription_status : 'active'),
+                                    size: "small",
+                                    variant: "outlined",
+                                    color: subscription.status === 'active' ? 'success' : 'default'
+                                })
+                            ]
+                        }, subscription.$id);
+                    }),
+                    /*#__PURE__*/ _jsx(ListPagination, {
+                        page: subscriptionPage,
+                        pageSize: subscriptionPageSize,
+                        rowCount: visibleSubscriptions.length,
+                        // This member's subscriptions, in full for the window.
+                        count: subscriptions.length,
+                        onPageChange: setSubscriptionPage,
+                        onPageSizeChange: setSubscriptionPageSize
+                    }),
+                    subscriptionsTruncated ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        color: "text.secondary",
+                        children: `Showing ${SUBSCRIPTION_CEILING} subscriptions; this ` + 'member has more.'
+                    }) : null
+                ]
+            }) : null
+        ]
+    });
+}
+SiteMemberPurchases.displayName = 'SiteMemberPurchases';
+export default SiteMemberPurchases;
+
+//# sourceMappingURL=site-member-purchases.component.js.map

package/src/lib/components/console/site-member-purchases.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/site-member-purchases.component.tsx"],"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'use client'\n\nimport type { ConsoleSiteMemberZoneProps } from '@aglyn/aglyn'\nimport { ListPagination } from '@aglyn/shared-ui-jsx/components/list-pagination.component'\nimport { TABLE_PAGE_SIZE_DEFAULT } from '@aglyn/shared-ui-jsx/const/table-pagination'\nimport {\n  ceilingedWindow,\n  useFirestore,\n  useFirestoreCollection,\n} from '@aglyn/tenant-feature-instance'\nimport { Chip, Divider, Stack, Typography } from '@mui/material'\nimport {\n  collection,\n  documentId,\n  limit,\n  orderBy,\n  query,\n  where,\n} from 'firebase/firestore'\nimport { useEffect, useMemo, useState } from 'react'\nimport { splitOrderReversal } from '../../model/commerce-dispute'\nimport { computeLifetimePurchaseCents } from '../../model/site-member-purchases'\n\nconst usd = (cents: number) => `$${(cents / 100).toFixed(2)}`\n\n/**\n * How many order documents this reads for one member.\n *\n * A CEILING, not a page size: the lifetime-purchase figure above the list is\n * summed from these rows, so every one it intends to count has to be held. A\n * server page would make that headline number the total of ten orders and\n * print it as a lifetime.\n */\nconst ORDER_CEILING = 100\n/** The same, for the subscriptions this member holds. */\nconst SUBSCRIPTION_CEILING = 25\n\n/**\n * The reversal suffix on one order row, split by the door the money left\n * through (AGL-1810). `refundedCents` carries a lost chargeback as well as a\n * refund (AGL-1787 puts both there deliberately), so rendering the whole\n * figure as \"refunded\" told the merchant they chose a reversal a bank took.\n * `computeLifetimePurchaseCents` keeps netting the total; only the label\n * splits.\n */\nconst reversalSuffix = (order: any) => {\n  const { refundedCents, chargedBackCents } = splitOrderReversal(order)\n  return (\n    (refundedCents ? ` · refunded ${usd(refundedCents)}` : '') +\n    (chargedBackCents ? ` · charged back ${usd(chargedBackCents)}` : '')\n  )\n}\n\n/** Display order number: v1 sequential `#1042`, else a doc-id stub. */\nconst orderNumber = (order: any) =>\n  order.number != null\n    ? `#${order.number}`\n    : `#${String(order.$id ?? '').slice(-6).toUpperCase()}`\n\nconst orderCreatedMs = (order: any) =>\n  Number(order.createdAtMs ?? (order.createdAt?.seconds ?? 0) * 1000) || 0\n\n/**\n * What a site user bought (AGL-546): the lifetime purchase total, the order\n * history (the payment records — Stripe intent id and refunds included) and\n * storefront subscriptions — the `siteMember` zone of the account's drawer.\n *\n * Orders match by email (mirrors membership-account, AGL-294) and sort\n * client-side. The QUERY orders on the document name: `orderBy('createdAt')`\n * would want a composite index and, worse, would drop every order missing the\n * field, while an equality filter plus `orderBy(documentId())` rides the\n * automatic single-field index and can drop nothing — a document's name\n * cannot be absent. That makes the window total rather than a pseudo-random\n * hundred, which is what the newest-first sort below was quietly disguising.\n * `orders` reads are admin/editor-only in rules (AGL-502), so viewers get a\n * note instead of history.\n *\n * One section per element, as a fragment: the zone is `bare`, and the drawer's\n * own column spaces what it holds.\n */\nexport function SiteMemberPurchases(props: ConsoleSiteMemberZoneProps) {\n  const { hostId, member } = props\n  const firestore = useFirestore()\n  const memberId = String(member.$id ?? '')\n  const email = String(member['email'] ?? '')\n\n  const { data: orderDocs, status: ordersStatus } = useFirestoreCollection<any>(\n    () =>\n      email\n        ? query(\n            collection(firestore, 'hosts', hostId, 'orders'),\n            where('customerEmail', '==', email),\n            orderBy(documentId()),\n            // One document past the ceiling, so \"this member has more\" is a\n            // fact. `length === 100` cannot tell a member with exactly a\n            // hundred orders from one with a thousand, and the difference is\n            // whether the lifetime figure above is a total or a floor.\n            limit(ORDER_CEILING + 1),\n          )\n        : null,\n    [firestore, hostId, email],\n    { idField: '$id' },\n  )\n  const { rows: readOrders, truncated: ordersTruncated } = ceilingedWindow<any>(\n    orderDocs,\n    ORDER_CEILING,\n  )\n  const orders = useMemo(\n    () =>\n      [...readOrders].sort((a, b) => orderCreatedMs(b) - orderCreatedMs(a)),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [orderDocs],\n  )\n  const lifetimeCents = useMemo(\n    () => computeLifetimePurchaseCents(orders),\n    [orders],\n  )\n  /**\n   * The order query failed AND nothing came back with it (AGL-1066).\n   *\n   * The copy this gates blames the reader's ROLE, which is the right\n   * explanation for the denial this was written for — orders are\n   * admin/editor-only in rules. It is the wrong explanation once a stale\n   * SESSION can push a listen to `'error'` too, and flatly wrong when\n   * `persistentLocalCache` is still serving the rows: telling someone their\n   * role is insufficient while their orders sit right there is a support\n   * ticket about permissions that was never about permissions.\n   */\n  const ordersUnreadable = ordersStatus === 'error' && orders.length === 0\n\n  const { data: subscriptionDocs } = useFirestoreCollection<any>(\n    () =>\n      email\n        ? query(\n            collection(firestore, 'hosts', hostId, 'subscriptions'),\n            where('customerEmail', '==', email),\n            // The same decision as the orders above, for the same reason: a\n            // subscription written without `createdAt` would be hidden by a\n            // field ordering rather than mis-sorted by it.\n            orderBy(documentId()),\n            limit(SUBSCRIPTION_CEILING + 1),\n          )\n        : null,\n    [firestore, hostId, email],\n    { idField: '$id' },\n  )\n  const { rows: subscriptions, truncated: subscriptionsTruncated } =\n    ceilingedWindow<any>(subscriptionDocs, SUBSCRIPTION_CEILING)\n  // Product names for subscriptions, loaded only when any exist.\n  const { data: productDocs } = useFirestoreCollection<any>(\n    () =>\n      email && (subscriptionDocs?.length ?? 0) > 0\n        ? query(\n            collection(firestore, 'hosts', hostId, 'products'),\n            // A LOOKUP, not a list — but the same ordering decision, so the\n            // hundred it reads is a reachable hundred rather than a sample,\n            // and a product past it degrades a subscription's label to its\n            // id rather than hiding the subscription.\n            orderBy(documentId()),\n            limit(100),\n          )\n        : null,\n    [firestore, hostId, email, (subscriptionDocs?.length ?? 0) > 0],\n    { idField: '$id' },\n  )\n  /*==========================================\n   * BOTH LISTS PAGE IN MEMORY.\n   *\n   * Each ceiling is held whole, which is what lets the orders sort\n   * newest-first and the lifetime figure sum over all of them. A server page\n   * would have made both about ten rows instead of about this member.\n   *=========================================*/\n  const [orderPage, setOrderPage] = useState(0)\n  const [orderPageSize, setOrderPageSize] = useState(TABLE_PAGE_SIZE_DEFAULT)\n  const visibleOrders = useMemo(\n    () =>\n      orders.slice(\n        orderPage * orderPageSize,\n        orderPage * orderPageSize + orderPageSize,\n      ),\n    [orders, orderPage, orderPageSize],\n  )\n  const [subscriptionPage, setSubscriptionPage] = useState(0)\n  const [subscriptionPageSize, setSubscriptionPageSize] = useState(\n    TABLE_PAGE_SIZE_DEFAULT,\n  )\n  const visibleSubscriptions = useMemo(\n    () =>\n      subscriptions.slice(\n        subscriptionPage * subscriptionPageSize,\n        subscriptionPage * subscriptionPageSize + subscriptionPageSize,\n      ),\n    [subscriptions, subscriptionPage, subscriptionPageSize],\n  )\n  /*\n   * A different member starts at page one. The drawer is reused for whoever\n   * is selected, so without this the next member opens three pages into a\n   * history they may not have — which renders as an empty list and reads as\n   * \"this person never bought anything\".\n   */\n  useEffect(() => {\n    setOrderPage(0)\n    setSubscriptionPage(0)\n  }, [memberId])\n\n  const productNames = useMemo(() => {\n    const map: Record<string, string> = {}\n    for (const product of productDocs ?? []) {\n      map[product.$id] = product.name ?? product.$id\n    }\n    return map\n  }, [productDocs])\n\n  return (\n    <>\n      <Divider textAlign=\"left\">{'Lifetime purchases'}</Divider>\n      <Typography variant=\"h6\">\n        {/*\n          \"at least\", or nothing at all. This figure is summed over the order\n          WINDOW, so once the probe finds an order past the ceiling it is a\n          lower bound — and a lower bound printed as a lifetime is the number\n          a support agent quotes back to the customer.\n        */}\n        {ordersUnreadable\n          ? '—'\n          : `${ordersTruncated ? 'at least ' : ''}${usd(lifetimeCents)}`}\n      </Typography>\n      <Typography variant=\"caption\" color=\"text.secondary\">\n        {'Charged order totals minus refunds; pending and canceled ' +\n          'orders excluded.'}\n        {ordersTruncated\n          ? ` Summed over the ${ORDER_CEILING} orders read here; this ` +\n            'member has more.'\n          : ''}\n      </Typography>\n\n      <Divider textAlign=\"left\">{'Orders'}</Divider>\n      {ordersUnreadable ? (\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {'Order history needs the editor or admin role on this site.'}\n        </Typography>\n      ) : orders.length === 0 ? (\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {'No orders yet.'}\n        </Typography>\n      ) : (\n        visibleOrders.map((order: any) => (\n          <Stack key={order.$id} spacing={0}>\n            <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n              <Typography variant=\"body2\" sx={{ flex: 1 }} noWrap>\n                {`${orderNumber(order)} · ${usd(\n                  Number(order.totals?.totalCents ?? order.amountCents ?? 0) ||\n                    0,\n                )}`}\n              </Typography>\n              <Chip\n                label={String(order.status ?? 'paid').replace('_', ' ')}\n                size=\"small\"\n                variant=\"outlined\"\n              />\n            </Stack>\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {orderCreatedMs(order)\n                ? new Date(orderCreatedMs(order)).toLocaleDateString()\n                : '—'}\n              {reversalSuffix(order)}\n            </Typography>\n            {order.paymentIntentId ? (\n              <Typography\n                variant=\"caption\"\n                color=\"text.secondary\"\n                sx={{ fontFamily: 'monospace' }}\n                noWrap\n              >\n                {order.paymentIntentId}\n              </Typography>\n            ) : null}\n          </Stack>\n        ))\n      )}\n      {ordersUnreadable || orders.length === 0 ? null : (\n        <ListPagination\n          page={orderPage}\n          pageSize={orderPageSize}\n          rowCount={visibleOrders.length}\n          // The orders held here — a slice of rows already read, so the\n          // total is exact for the window. The lifetime caption above is\n          // where the window's own shortfall is stated.\n          count={orders.length}\n          onPageChange={setOrderPage}\n          onPageSizeChange={setOrderPageSize}\n        />\n      )}\n\n      {subscriptions.length > 0 ? (\n        <>\n          <Divider textAlign=\"left\">{'Subscriptions'}</Divider>\n          {visibleSubscriptions.map((subscription: any) => (\n            <Stack\n              key={subscription.$id}\n              direction=\"row\"\n              spacing={1}\n              sx={{ alignItems: 'center' }}\n            >\n              <Stack sx={{ flex: 1, minWidth: 0 }}>\n                <Typography variant=\"body2\" noWrap>\n                  {/*\n                   * The amount (AGL-1732). This row named the product and the\n                   * renewal date and stopped, and no other console surface\n                   * carried the figure either — orders, analytics and the CSV\n                   * all read `orders`, which a subscription sale does not\n                   * create. Subscriptions written before that fix have no\n                   * `totals`, so the amount is omitted rather than shown as\n                   * $0.00.\n                   */}\n                  {productNames[subscription.productId] ??\n                    subscription.productId ??\n                    'Subscription'}\n                  {subscription.totals?.totalCents != null\n                    ? ` · ${usd(Number(subscription.totals.totalCents) || 0)}${\n                        subscription.interval ? `/${subscription.interval}` : ''\n                      }`\n                    : ''}\n                </Typography>\n                <Typography variant=\"caption\" color=\"text.secondary\">\n                  {subscription.currentPeriodEndMs\n                    ? `Renews ${new Date(\n                        Number(subscription.currentPeriodEndMs),\n                      ).toLocaleDateString()}`\n                    : '—'}\n                  {/*\n                   * What this subscriber has actually paid, across every cycle\n                   * (AGL-1743). Omitted, not shown as 0, for subscriptions\n                   * whose cycles all predate `invoice.payment_succeeded`\n                   * being handled: those invoices are recoverable only from\n                   * Stripe.\n                   */}\n                  {Number(subscription.invoicesCount ?? 0) > 0\n                    ? ` · ${usd(Number(subscription.paidCents) || 0)} paid over ${\n                        Number(subscription.invoicesCount) === 1\n                          ? '1 invoice'\n                          : `${Number(subscription.invoicesCount)} invoices`\n                      }`\n                    : ''}\n                </Typography>\n              </Stack>\n              <Chip\n                label={String(subscription.status ?? 'active')}\n                size=\"small\"\n                variant=\"outlined\"\n                color={subscription.status === 'active' ? 'success' : 'default'}\n              />\n            </Stack>\n          ))}\n          <ListPagination\n            page={subscriptionPage}\n            pageSize={subscriptionPageSize}\n            rowCount={visibleSubscriptions.length}\n            // This member's subscriptions, in full for the window.\n            count={subscriptions.length}\n            onPageChange={setSubscriptionPage}\n            onPageSizeChange={setSubscriptionPageSize}\n          />\n          {subscriptionsTruncated ? (\n            <Typography variant=\"caption\" color=\"text.secondary\">\n              {`Showing ${SUBSCRIPTION_CEILING} subscriptions; this ` +\n                'member has more.'}\n            </Typography>\n          ) : null}\n        </>\n      ) : null}\n    </>\n  )\n}\nSiteMemberPurchases.displayName = 'SiteMemberPurchases'\n\nexport default SiteMemberPurchases\n"],"names":["ListPagination","TABLE_PAGE_SIZE_DEFAULT","ceilingedWindow","useFirestore","useFirestoreCollection","Chip","Divider","Stack","Typography","collection","documentId","limit","orderBy","query","where","useEffect","useMemo","useState","splitOrderReversal","computeLifetimePurchaseCents","usd","cents","toFixed","ORDER_CEILING","SUBSCRIPTION_CEILING","reversalSuffix","order","refundedCents","chargedBackCents","orderNumber","number","String","$id","slice","toUpperCase","orderCreatedMs","Number","createdAtMs","createdAt","seconds","SiteMemberPurchases","props","member","hostId","firestore","memberId","email","data","orderDocs","status","ordersStatus","idField","rows","readOrders","truncated","ordersTruncated","orders","sort","a","b","lifetimeCents","ordersUnreadable","length","subscriptionDocs","subscriptions","subscriptionsTruncated","productDocs","orderPage","setOrderPage","orderPageSize","setOrderPageSize","visibleOrders","subscriptionPage","setSubscriptionPage","subscriptionPageSize","setSubscriptionPageSize","visibleSubscriptions","productNames","map","product","name","textAlign","variant","color","spacing","direction","sx","alignItems","flex","noWrap","totals","totalCents","amountCents","label","replace","size","Date","toLocaleDateString","paymentIntentId","fontFamily","page","pageSize","rowCount","count","onPageChange","onPageSizeChange","subscription","minWidth","productId","interval","currentPeriodEndMs","invoicesCount","paidCents","displayName"],"mappings":"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"}

package/src/lib/components/console/store-settings-card.component.js

@@ -164,7 +164,7 @@ import { writeSiteWideChange } from "@aglyn/tenant-feature-instance/hooks/helper
                         }),
                     size: "small",
                     select: true,
-                    helperText: 'Screen rendered at /products/{slug} — design it in the ' + 'besigner with the Product detail block and {{product.*}} tokens.',
+                    helperText: 'Page rendered at /products/{slug} — design it in the ' + 'Besigner with the Product detail block and {{product.*}} tokens.',
                     children: [
                         /*#__PURE__*/ _jsx(MenuItem, {
                             value: "",
@@ -184,7 +184,7 @@ import { writeSiteWideChange } from "@aglyn/tenant-feature-instance/hooks/helper
                         }),
                     size: "small",
                     select: true,
-                    helperText: 'Screen rendered at /collections/{slug} — drop a Product grid ' + 'with source "A collection" and {{collection.*}} tokens.',
+                    helperText: 'Page rendered at /collections/{slug} — drop a Product grid ' + 'with source "A collection" and {{collection.*}} tokens.',
                     children: [
                         /*#__PURE__*/ _jsx(MenuItem, {
                             value: "",

package/src/lib/components/console/store-settings-card.component.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/store-settings-card.component.tsx"],"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'use client'\n\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  Button,\n  FormControlLabel,\n  MenuItem,\n  Stack,\n  Switch,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { doc } from 'firebase/firestore'\nimport { useCallback, useState } from 'react'\nimport { useFirestore, useUser } from '@aglyn/tenant-feature-instance'\nimport {\n  useFirestoreDoc,\n  writeGuardedBySeed,\n} from '@aglyn/tenant-feature-instance'\nimport { hostPublicOrigin, pluginDocsHelp } from '@aglyn/aglyn'\nimport { writeSiteWideChange } from '@aglyn/tenant-feature-instance/hooks/helpers/site-wide-change'\n\nexport interface StoreSettingsCardProps {\n  hostId: string\n}\n\ninterface StoreSettings {\n  /** Screen rendered for /products/{slug} with product tokens (AGL-292). */\n  pdpScreenId?: string\n  /** Screen rendered for /collections/{slug} (AGL-298). */\n  collectionScreenId?: string\n  currency?: string\n  guestCheckout?: boolean\n  termsUrl?: string\n  receiptFooter?: string\n}\n\n/**\n * Store settings (AGL-295) on `hosts/{hostId}/settings/store`: the PDP\n * template screen (drives /products/{slug}), currency display, checkout\n * preferences, and receipt branding. Tax and shipping have their own\n * cards; store password/maintenance live in Site Protection.\n */\nexport function StoreSettingsCard(props: StoreSettingsCardProps) {\n  const { hostId } = props\n  const firestore = useFirestore()\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const {\n    data: store,\n    status: storeStatus,\n    /**\n     * The settings doc this form is seeded from is unconfirmed by the server\n     * (AGL-1358). `current` is `draft ?? {…store}` and the save writes all\n     * six keys, so `merge: true` protects only the tax and shipping maps that\n     * belong to other cards — never this card's own fields. Against a cached\n     * read, changing the currency rewrites `guestCheckout`, and the two\n     * template ids fall back to `|| null`, which is how a storefront's\n     * product and collection URLs start returning 404.\n     */\n    fromCache: storeFromCache,\n  } = useFirestoreDoc<any>(\n    () => doc(firestore, 'hosts', hostId, 'settings', 'store'),\n    [firestore, hostId],\n  )\n  const { data: host } = useFirestoreDoc<any>(\n    () => doc(firestore, 'hosts', hostId),\n    [firestore, hostId],\n  )\n  const [draft, setDraft] = useState<StoreSettings | null>(null)\n  const current: StoreSettings = draft ?? {\n    pdpScreenId: store?.pdpScreenId ?? '',\n    collectionScreenId: store?.collectionScreenId ?? '',\n    currency: store?.currency ?? 'USD',\n    guestCheckout: store?.guestCheckout !== false,\n    termsUrl: store?.termsUrl ?? '',\n    receiptFooter: store?.receiptFooter ?? '',\n  }\n  const update = (patch: Partial<StoreSettings>) =>\n    setDraft({ ...current, ...patch })\n\n  /**\n   * Google Merchant Center feed address (AGL-2249).\n   *\n   * `server/feed.ts` has served this since AGL-299, and the only place the\n   * URL was ever written down was that file's own docblock — so the feature\n   * was built, deployed, and undiscoverable. A feed nobody can find is a\n   * shopping channel nobody switches on.\n   *\n   * Through `hostPublicOrigin` rather than a hand-built string, because a\n   * store on a custom domain must be told ITS name: the feed's `<link>`\n   * elements are built from the request host, so submitting the `.aglyn.app`\n   * address for a site that serves on `shop.example.com` would put the wrong\n   * domain on every item in Merchant Center.\n   *\n   * Undefined until the host doc lands, and undefined forever for a host with\n   * neither a cname nor a subdomain — `hostPublicOrigin` returns undefined\n   * rather than a half-built URL, and a copyable half-URL is worse than none.\n   */\n  const feedUrl = host\n    ? (() => {\n        const origin = hostPublicOrigin(host)\n        return origin\n          ? `${origin}/api/commerce/feed?hostId=${hostId}`\n          : undefined\n      })()\n    : undefined\n\n  // Host screen directory: {screenId: path} (AGL-292 template pick).\n  const screenEntries = Object.entries(\n    (host?.screens ?? {}) as Record<string, string>,\n  ).sort(([, a], [, b]) => String(a).localeCompare(String(b)))\n\n  const handleSave = useCallback(async () => {\n    /**\n     * Refuse a save whose seed the server never confirmed (AGL-1358).\n     *\n     * There is no create path to exempt, and that is deliberate rather than\n     * an oversight: unlike a new row at a fresh uid, this writes a FIXED\n     * document path, so the all-defaults `current` produced when the cache\n     * has never seen this doc is not the harmless blank a fresh uid would\n     * be. It would put `USD`, guest checkout on and two null template ids\n     * over whatever the server really holds.\n     *\n     * The guard WRAPS the write — an early return is a shape you can keep\n     * while losing the protection.\n     */\n    const verdict = await writeGuardedBySeed(\n      {\n        subject: 'store settings',\n        unreadable: storeStatus === 'error',\n        fromCache: storeFromCache,\n      },\n      async () => {\n        // The product and collection templates, the currency and the\n        // checkout rules render on the live store with no publish step, so\n        // the save carries the site's cache drop with it.\n        await writeSiteWideChange({\n          firestore,\n          user,\n          hostId,\n          write: (batch) =>\n            batch.set(\n              doc(firestore, 'hosts', hostId, 'settings', 'store'),\n              {\n                pdpScreenId: current.pdpScreenId || null,\n                collectionScreenId: current.collectionScreenId || null,\n                currency: current.currency ?? 'USD',\n                guestCheckout: current.guestCheckout !== false,\n                termsUrl: current.termsUrl || null,\n                receiptFooter: current.receiptFooter || null,\n              },\n              { merge: true },\n            ),\n        })\n      },\n    )\n    // Before `setDraft(null)`, so a refusal keeps every typed value on\n    // screen. A save that silently does nothing sends the user back to\n    // retype a form that will be refused again just as quietly.\n    if (!verdict.ok) {\n      return void enqueueSnackbar(verdict.message, {\n        variant: 'warning',\n        persist: false,\n      })\n    }\n    setDraft(null)\n    enqueueSnackbar('Store settings saved', {\n      variant: 'success',\n      persist: false,\n    })\n  }, [\n    current,\n    firestore,\n    hostId,\n    user,\n    enqueueSnackbar,\n    storeStatus,\n    storeFromCache,\n  ])\n\n  return (\n    <CardDisplay\n      header={'Store settings'}\n      help={pluginDocsHelp('commerce')}\n      contentGutterX\n      contentGutterY\n    >\n      <Stack spacing={1.5}>\n        <TextField\n          label=\"Product page template\"\n          value={current.pdpScreenId ?? ''}\n          onChange={(event) => update({ pdpScreenId: event.target.value })}\n          size=\"small\"\n          select\n          helperText={\n            'Screen rendered at /products/{slug} — design it in the ' +\n            'besigner with the Product detail block and {{product.*}} tokens.'\n          }\n        >\n          <MenuItem value=\"\">{'None (product URLs 404)'}</MenuItem>\n          {screenEntries.map(([screenId, path]) => (\n            <MenuItem key={screenId} value={screenId}>\n              {`/${path === '/' ? '' : path}`}\n            </MenuItem>\n          ))}\n        </TextField>\n        <TextField\n          label=\"Collection page template\"\n          value={current.collectionScreenId ?? ''}\n          onChange={(event) =>\n            update({ collectionScreenId: event.target.value })\n          }\n          size=\"small\"\n          select\n          helperText={\n            'Screen rendered at /collections/{slug} — drop a Product grid ' +\n            'with source \"A collection\" and {{collection.*}} tokens.'\n          }\n        >\n          <MenuItem value=\"\">{'None (collection URLs 404)'}</MenuItem>\n          {screenEntries.map(([screenId, path]) => (\n            <MenuItem key={screenId} value={screenId}>\n              {`/${path === '/' ? '' : path}`}\n            </MenuItem>\n          ))}\n        </TextField>\n        <TextField\n          label=\"Currency\"\n          value={current.currency ?? 'USD'}\n          onChange={(event) => update({ currency: event.target.value })}\n          size=\"small\"\n          select\n          sx={{ maxWidth: 200 }}\n          helperText=\"Charges settle in USD; more currencies are coming\"\n        >\n          <MenuItem value=\"USD\">{'USD ($)'}</MenuItem>\n        </TextField>\n        <FormControlLabel\n          control={\n            <Switch\n              size=\"small\"\n              checked={current.guestCheckout !== false}\n              onChange={(event) =>\n                update({ guestCheckout: event.target.checked })\n              }\n            />\n          }\n          label=\"Allow guest checkout (no account required)\"\n        />\n        <TextField\n          label=\"Terms URL\"\n          value={current.termsUrl ?? ''}\n          onChange={(event) => update({ termsUrl: event.target.value })}\n          size=\"small\"\n          placeholder=\"/terms\"\n          helperText=\"Linked from checkout when set\"\n        />\n        <TextField\n          label=\"Receipt footer\"\n          value={current.receiptFooter ?? ''}\n          onChange={(event) => update({ receiptFooter: event.target.value })}\n          size=\"small\"\n          multiline\n          minRows={2}\n          placeholder=\"Thanks for supporting our shop!\"\n        />\n        <Typography variant=\"caption\" color=\"text.secondary\">\n          {'Password protection and maintenance mode live under Site ' +\n            'Protection.'}\n        </Typography>\n        <Button\n          variant=\"contained\"\n          color=\"primary\"\n          size=\"small\"\n          disabled={!draft}\n          onClick={handleSave}\n          sx={{ alignSelf: 'flex-start' }}\n        >\n          {'Save store settings'}\n        </Button>\n        <Stack spacing={0.5}>\n          <Typography variant=\"subtitle2\">{'Product feed'}</Typography>\n          {feedUrl ? (\n            <>\n              <TextField\n                label=\"Google Merchant Center feed URL\"\n                value={feedUrl}\n                size=\"small\"\n                slotProps={{ input: { readOnly: true } }}\n                onFocus={(event) => event.target.select()}\n                helperText={\n                  'Paste this into Merchant Center → Products → Feeds as a ' +\n                  'scheduled fetch. It lists every active product with price ' +\n                  'and availability, and refreshes itself.'\n                }\n              />\n              <Button\n                size=\"small\"\n                sx={{ alignSelf: 'flex-start' }}\n                onClick={() => {\n                  void navigator.clipboard?.writeText(feedUrl).then(() =>\n                    enqueueSnackbar('Feed URL copied', {\n                      variant: 'success',\n                      persist: false,\n                    }),\n                  )\n                }}\n              >\n                {'Copy feed URL'}\n              </Button>\n            </>\n          ) : (\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {'Publish this site to a subdomain or custom domain to get its ' +\n                'Google Merchant Center feed URL.'}\n            </Typography>\n          )}\n        </Stack>\n      </Stack>\n    </CardDisplay>\n  )\n}\nStoreSettingsCard.displayName = 'StoreSettingsCard'\n\nexport default StoreSettingsCard\n"],"names":["CardDisplay","useSnackbar","Button","FormControlLabel","MenuItem","Stack","Switch","TextField","Typography","doc","useCallback","useState","useFirestore","useUser","useFirestoreDoc","writeGuardedBySeed","hostPublicOrigin","pluginDocsHelp","writeSiteWideChange","StoreSettingsCard","props","current","hostId","firestore","data","user","enqueueSnackbar","store","status","storeStatus","fromCache","storeFromCache","host","draft","setDraft","pdpScreenId","collectionScreenId","currency","guestCheckout","termsUrl","receiptFooter","update","patch","feedUrl","origin","undefined","screenEntries","Object","entries","screens","sort","a","b","String","localeCompare","handleSave","verdict","subject","unreadable","write","batch","set","merge","ok","message","variant","persist","header","help","contentGutterX","contentGutterY","spacing","label","value","onChange","event","target","size","select","helperText","map","screenId","path","sx","maxWidth","control","checked","placeholder","multiline","minRows","color","disabled","onClick","alignSelf","slotProps","input","readOnly","onFocus","navigator","clipboard","writeText","then","displayName"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/store-settings-card.component.tsx"],"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'use client'\n\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  Button,\n  FormControlLabel,\n  MenuItem,\n  Stack,\n  Switch,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { doc } from 'firebase/firestore'\nimport { useCallback, useState } from 'react'\nimport { useFirestore, useUser } from '@aglyn/tenant-feature-instance'\nimport {\n  useFirestoreDoc,\n  writeGuardedBySeed,\n} from '@aglyn/tenant-feature-instance'\nimport { hostPublicOrigin, pluginDocsHelp } from '@aglyn/aglyn'\nimport { writeSiteWideChange } from '@aglyn/tenant-feature-instance/hooks/helpers/site-wide-change'\n\nexport interface StoreSettingsCardProps {\n  hostId: string\n}\n\ninterface StoreSettings {\n  /** Screen rendered for /products/{slug} with product tokens (AGL-292). */\n  pdpScreenId?: string\n  /** Screen rendered for /collections/{slug} (AGL-298). */\n  collectionScreenId?: string\n  currency?: string\n  guestCheckout?: boolean\n  termsUrl?: string\n  receiptFooter?: string\n}\n\n/**\n * Store settings (AGL-295) on `hosts/{hostId}/settings/store`: the PDP\n * template screen (drives /products/{slug}), currency display, checkout\n * preferences, and receipt branding. Tax and shipping have their own\n * cards; store password/maintenance live in Site Protection.\n */\nexport function StoreSettingsCard(props: StoreSettingsCardProps) {\n  const { hostId } = props\n  const firestore = useFirestore()\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const {\n    data: store,\n    status: storeStatus,\n    /**\n     * The settings doc this form is seeded from is unconfirmed by the server\n     * (AGL-1358). `current` is `draft ?? {…store}` and the save writes all\n     * six keys, so `merge: true` protects only the tax and shipping maps that\n     * belong to other cards — never this card's own fields. Against a cached\n     * read, changing the currency rewrites `guestCheckout`, and the two\n     * template ids fall back to `|| null`, which is how a storefront's\n     * product and collection URLs start returning 404.\n     */\n    fromCache: storeFromCache,\n  } = useFirestoreDoc<any>(\n    () => doc(firestore, 'hosts', hostId, 'settings', 'store'),\n    [firestore, hostId],\n  )\n  const { data: host } = useFirestoreDoc<any>(\n    () => doc(firestore, 'hosts', hostId),\n    [firestore, hostId],\n  )\n  const [draft, setDraft] = useState<StoreSettings | null>(null)\n  const current: StoreSettings = draft ?? {\n    pdpScreenId: store?.pdpScreenId ?? '',\n    collectionScreenId: store?.collectionScreenId ?? '',\n    currency: store?.currency ?? 'USD',\n    guestCheckout: store?.guestCheckout !== false,\n    termsUrl: store?.termsUrl ?? '',\n    receiptFooter: store?.receiptFooter ?? '',\n  }\n  const update = (patch: Partial<StoreSettings>) =>\n    setDraft({ ...current, ...patch })\n\n  /**\n   * Google Merchant Center feed address (AGL-2249).\n   *\n   * `server/feed.ts` has served this since AGL-299, and the only place the\n   * URL was ever written down was that file's own docblock — so the feature\n   * was built, deployed, and undiscoverable. A feed nobody can find is a\n   * shopping channel nobody switches on.\n   *\n   * Through `hostPublicOrigin` rather than a hand-built string, because a\n   * store on a custom domain must be told ITS name: the feed's `<link>`\n   * elements are built from the request host, so submitting the `.aglyn.app`\n   * address for a site that serves on `shop.example.com` would put the wrong\n   * domain on every item in Merchant Center.\n   *\n   * Undefined until the host doc lands, and undefined forever for a host with\n   * neither a cname nor a subdomain — `hostPublicOrigin` returns undefined\n   * rather than a half-built URL, and a copyable half-URL is worse than none.\n   */\n  const feedUrl = host\n    ? (() => {\n        const origin = hostPublicOrigin(host)\n        return origin\n          ? `${origin}/api/commerce/feed?hostId=${hostId}`\n          : undefined\n      })()\n    : undefined\n\n  // Host screen directory: {screenId: path} (AGL-292 template pick).\n  const screenEntries = Object.entries(\n    (host?.screens ?? {}) as Record<string, string>,\n  ).sort(([, a], [, b]) => String(a).localeCompare(String(b)))\n\n  const handleSave = useCallback(async () => {\n    /**\n     * Refuse a save whose seed the server never confirmed (AGL-1358).\n     *\n     * There is no create path to exempt, and that is deliberate rather than\n     * an oversight: unlike a new row at a fresh uid, this writes a FIXED\n     * document path, so the all-defaults `current` produced when the cache\n     * has never seen this doc is not the harmless blank a fresh uid would\n     * be. It would put `USD`, guest checkout on and two null template ids\n     * over whatever the server really holds.\n     *\n     * The guard WRAPS the write — an early return is a shape you can keep\n     * while losing the protection.\n     */\n    const verdict = await writeGuardedBySeed(\n      {\n        subject: 'store settings',\n        unreadable: storeStatus === 'error',\n        fromCache: storeFromCache,\n      },\n      async () => {\n        // The product and collection templates, the currency and the\n        // checkout rules render on the live store with no publish step, so\n        // the save carries the site's cache drop with it.\n        await writeSiteWideChange({\n          firestore,\n          user,\n          hostId,\n          write: (batch) =>\n            batch.set(\n              doc(firestore, 'hosts', hostId, 'settings', 'store'),\n              {\n                pdpScreenId: current.pdpScreenId || null,\n                collectionScreenId: current.collectionScreenId || null,\n                currency: current.currency ?? 'USD',\n                guestCheckout: current.guestCheckout !== false,\n                termsUrl: current.termsUrl || null,\n                receiptFooter: current.receiptFooter || null,\n              },\n              { merge: true },\n            ),\n        })\n      },\n    )\n    // Before `setDraft(null)`, so a refusal keeps every typed value on\n    // screen. A save that silently does nothing sends the user back to\n    // retype a form that will be refused again just as quietly.\n    if (!verdict.ok) {\n      return void enqueueSnackbar(verdict.message, {\n        variant: 'warning',\n        persist: false,\n      })\n    }\n    setDraft(null)\n    enqueueSnackbar('Store settings saved', {\n      variant: 'success',\n      persist: false,\n    })\n  }, [\n    current,\n    firestore,\n    hostId,\n    user,\n    enqueueSnackbar,\n    storeStatus,\n    storeFromCache,\n  ])\n\n  return (\n    <CardDisplay\n      header={'Store settings'}\n      help={pluginDocsHelp('commerce')}\n      contentGutterX\n      contentGutterY\n    >\n      <Stack spacing={1.5}>\n        <TextField\n          label=\"Product page template\"\n          value={current.pdpScreenId ?? ''}\n          onChange={(event) => update({ pdpScreenId: event.target.value })}\n          size=\"small\"\n          select\n          helperText={\n            'Page rendered at /products/{slug} — design it in the ' +\n            'Besigner with the Product detail block and {{product.*}} tokens.'\n          }\n        >\n          <MenuItem value=\"\">{'None (product URLs 404)'}</MenuItem>\n          {screenEntries.map(([screenId, path]) => (\n            <MenuItem key={screenId} value={screenId}>\n              {`/${path === '/' ? '' : path}`}\n            </MenuItem>\n          ))}\n        </TextField>\n        <TextField\n          label=\"Collection page template\"\n          value={current.collectionScreenId ?? ''}\n          onChange={(event) =>\n            update({ collectionScreenId: event.target.value })\n          }\n          size=\"small\"\n          select\n          helperText={\n            'Page rendered at /collections/{slug} — drop a Product grid ' +\n            'with source \"A collection\" and {{collection.*}} tokens.'\n          }\n        >\n          <MenuItem value=\"\">{'None (collection URLs 404)'}</MenuItem>\n          {screenEntries.map(([screenId, path]) => (\n            <MenuItem key={screenId} value={screenId}>\n              {`/${path === '/' ? '' : path}`}\n            </MenuItem>\n          ))}\n        </TextField>\n        <TextField\n          label=\"Currency\"\n          value={current.currency ?? 'USD'}\n          onChange={(event) => update({ currency: event.target.value })}\n          size=\"small\"\n          select\n          sx={{ maxWidth: 200 }}\n          helperText=\"Charges settle in USD; more currencies are coming\"\n        >\n          <MenuItem value=\"USD\">{'USD ($)'}</MenuItem>\n        </TextField>\n        <FormControlLabel\n          control={\n            <Switch\n              size=\"small\"\n              checked={current.guestCheckout !== false}\n              onChange={(event) =>\n                update({ guestCheckout: event.target.checked })\n              }\n            />\n          }\n          label=\"Allow guest checkout (no account required)\"\n        />\n        <TextField\n          label=\"Terms URL\"\n          value={current.termsUrl ?? ''}\n          onChange={(event) => update({ termsUrl: event.target.value })}\n          size=\"small\"\n          placeholder=\"/terms\"\n          helperText=\"Linked from checkout when set\"\n        />\n        <TextField\n          label=\"Receipt footer\"\n          value={current.receiptFooter ?? ''}\n          onChange={(event) => update({ receiptFooter: event.target.value })}\n          size=\"small\"\n          multiline\n          minRows={2}\n          placeholder=\"Thanks for supporting our shop!\"\n        />\n        <Typography variant=\"caption\" color=\"text.secondary\">\n          {'Password protection and maintenance mode live under Site ' +\n            'Protection.'}\n        </Typography>\n        <Button\n          variant=\"contained\"\n          color=\"primary\"\n          size=\"small\"\n          disabled={!draft}\n          onClick={handleSave}\n          sx={{ alignSelf: 'flex-start' }}\n        >\n          {'Save store settings'}\n        </Button>\n        <Stack spacing={0.5}>\n          <Typography variant=\"subtitle2\">{'Product feed'}</Typography>\n          {feedUrl ? (\n            <>\n              <TextField\n                label=\"Google Merchant Center feed URL\"\n                value={feedUrl}\n                size=\"small\"\n                slotProps={{ input: { readOnly: true } }}\n                onFocus={(event) => event.target.select()}\n                helperText={\n                  'Paste this into Merchant Center → Products → Feeds as a ' +\n                  'scheduled fetch. It lists every active product with price ' +\n                  'and availability, and refreshes itself.'\n                }\n              />\n              <Button\n                size=\"small\"\n                sx={{ alignSelf: 'flex-start' }}\n                onClick={() => {\n                  void navigator.clipboard?.writeText(feedUrl).then(() =>\n                    enqueueSnackbar('Feed URL copied', {\n                      variant: 'success',\n                      persist: false,\n                    }),\n                  )\n                }}\n              >\n                {'Copy feed URL'}\n              </Button>\n            </>\n          ) : (\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {'Publish this site to a subdomain or custom domain to get its ' +\n                'Google Merchant Center feed URL.'}\n            </Typography>\n          )}\n        </Stack>\n      </Stack>\n    </CardDisplay>\n  )\n}\nStoreSettingsCard.displayName = 'StoreSettingsCard'\n\nexport default StoreSettingsCard\n"],"names":["CardDisplay","useSnackbar","Button","FormControlLabel","MenuItem","Stack","Switch","TextField","Typography","doc","useCallback","useState","useFirestore","useUser","useFirestoreDoc","writeGuardedBySeed","hostPublicOrigin","pluginDocsHelp","writeSiteWideChange","StoreSettingsCard","props","current","hostId","firestore","data","user","enqueueSnackbar","store","status","storeStatus","fromCache","storeFromCache","host","draft","setDraft","pdpScreenId","collectionScreenId","currency","guestCheckout","termsUrl","receiptFooter","update","patch","feedUrl","origin","undefined","screenEntries","Object","entries","screens","sort","a","b","String","localeCompare","handleSave","verdict","subject","unreadable","write","batch","set","merge","ok","message","variant","persist","header","help","contentGutterX","contentGutterY","spacing","label","value","onChange","event","target","size","select","helperText","map","screenId","path","sx","maxWidth","control","checked","placeholder","multiline","minRows","color","disabled","onClick","alignSelf","slotProps","input","readOnly","onFocus","navigator","clipboard","writeText","then","displayName"],"mappings":"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"}

package/src/lib/components/console/storefront-tax-summary-card.component.js

@@ -112,7 +112,7 @@ const usd = (cents)=>`$${(cents / 100).toFixed(2)}`;
             from: selected.from,
             to: selected.to
         });
-        const response = await authorizedFetch(user, `/api/hosts/tax-summary?${search.toString()}`);
+        const response = await authorizedFetch(user, `/api/commerce/tax-summary?${search.toString()}`);
         if (!response.ok) throw new Error('tax summary failed');
         return await response.json();
     }, [