@aglyn/plugins-commerce 1.0.0-beta.143

package/src/lib/components/console/discounts-card.component.js

@@ -0,0 +1,443 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as Aglyn from "@aglyn/aglyn";
+import * as CommerceModel from "../../model/index.js";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { Button, Chip, Dialog, DialogActions, DialogContent, DialogTitle, MenuItem, Stack, TextField, Typography } from "@mui/material";
+import { collection, deleteDoc, doc, setDoc } from "firebase/firestore";
+import { useCallback, useState } from "react";
+import { useFirestore } from "@aglyn/tenant-feature-instance";
+import { collectionPage, usePagedCollection, writeGuardedBySeed } from "@aglyn/tenant-feature-instance";
+import { ListPagination } from "@aglyn/shared-ui-jsx/components/list-pagination.component";
+import { pluginDocsHelp } from "@aglyn/aglyn";
+/**
+ * Discounts hub (AGL-305): code and automatic promotions with value,
+ * min-subtotal, schedule, and usage-limit controls, resolved at
+ * checkout/POS by the shared engine. Supersedes the simple coupons
+ * card (which keeps working for existing codes).
+ */ export function DiscountsCard(props) {
+    var _ref, _ref1, _ref2, _ref3, _ref4, _ref5, _ref6;
+    const { hostId } = props;
+    const firestore = useFirestore();
+    const { enqueueSnackbar } = useSnackbar();
+    const { status: discountsStatus, /**
+     * The row this dialog is seeded from is unconfirmed by the server
+     * (AGL-1358). `redemptions` is a LIVE counter the checkout engine
+     * increments, and editing a discount copies it out of the seed and
+     * writes it straight back — so a cached seed rolls the count backwards
+     * and hands out redemptions that were already spent.
+     */ fromCache: discountsFromCache, rows: discounts, hasMore, page, setPage, pageSize, setPageSize } = usePagedCollection(/*
+     * SERVER-PAGED, and ordered (AGL-2501).
+     *
+     * `limit(100)` alone is answered in DOCUMENT-ID order and the ids are
+     * `createResourceUid()`, so the hundred were a pseudo-random sample of the
+     * shop's promotions — and the hundred-and-first was UNREACHABLE, because
+     * nothing rendered it and no control asked for more.
+     *
+     * The query can be paged here, unlike the cards carrying a duplicate-name
+     * check: a discount's identity is its document id, `code` is an ordinary
+     * field with no uniqueness test on this surface, and nothing on the card
+     * is computed from rows that are off the page.
+     *
+     * `collectionPage` orders on the document NAME. `orderBy('code')` is the
+     * tempting one and would be wrong twice: an AUTOMATIC promotion is stored
+     * with `code: null`, so ordering on it would hide every automatic discount
+     * the shop has, and a merchant reading "no automatic promotions" would be
+     * reading a query artifact.
+     */ (pageLimit)=>collectionPage(collection(firestore, 'hosts', hostId, 'discounts'), pageLimit), [
+        firestore,
+        hostId
+    ], {
+        idField: '$id'
+    });
+    const [draft, setDraft] = useState(null);
+    const handleSave = useCallback(async ()=>{
+        var _data_code;
+        if (!draft) return;
+        /**
+     * `$id` comes off with `id` (AGL-1374).
+     *
+     * The editor is seeded `{ id: discount.$id, ...discount }`, and that
+     * spread carries the listener's SYNTHETIC `$id` — `idField: '$id'`
+     * stamps the document id onto the in-memory row, where nothing persists
+     * it. Destructuring only `id` left `$id` in `data`, so every save wrote
+     * it into the stored document as a real field. Nothing reads it; it is
+     * the listener's bookkeeping leaking into storage, and once there no
+     * reader can tell it from a field the card meant to write.
+     */ const seeded = draft;
+        const { id, $id: _syntheticId } = seeded, data = _object_without_properties_loose(seeded, [
+            "id",
+            "$id"
+        ]);
+        const code = (_data_code = data.code) == null ? void 0 : _data_code.trim().toUpperCase().replace(/[^A-Z0-9_-]/g, '');
+        /**
+     * Refuse an EDIT whose seed the server never confirmed (AGL-1358).
+     *
+     * `merge: true` protects nothing here — `{...data}` carries every field
+     * of the seeded row, `redemptions` included, so it is written back
+     * whether or not anyone touched it. Under `persistentLocalCache` that
+     * seed can be arbitrarily old, and a redemption cap silently regains
+     * uses that buyers already spent.
+     *
+     * Only the edit path is guarded: a NEW discount is built from blanks at
+     * a fresh uid and can overwrite nothing.
+     */ const verdict = await writeGuardedBySeed({
+            subject: 'discount',
+            unreadable: Boolean(id) && discountsStatus === 'error',
+            fromCache: Boolean(id) && discountsFromCache
+        }, async ()=>{
+            var _data_redemptions;
+            await setDoc(doc(firestore, 'hosts', hostId, 'discounts', id != null ? id : Aglyn.createResourceUid()), _extends({}, data, code ? {
+                code
+            } : {
+                code: null
+            }, {
+                enabled: data.enabled !== false,
+                redemptions: (_data_redemptions = data.redemptions) != null ? _data_redemptions : 0
+            }), {
+                merge: true
+            });
+        });
+        // Keep the dialog open with what was typed rather than failing silently.
+        if (!verdict.ok) {
+            return void enqueueSnackbar(verdict.message, {
+                variant: 'warning',
+                persist: false
+            });
+        }
+        setDraft(null);
+        enqueueSnackbar('Discount saved', {
+            variant: 'success',
+            persist: false
+        });
+    }, [
+        draft,
+        firestore,
+        hostId,
+        enqueueSnackbar,
+        discountsFromCache,
+        discountsStatus
+    ]);
+    const describe = (discount)=>{
+        var _discount_valueCents;
+        const value = discount.kind === 'percent' ? `${discount.valuePct}% off` : discount.kind === 'fixed' ? `$${(((_discount_valueCents = discount.valueCents) != null ? _discount_valueCents : 0) / 100).toFixed(2)} off` : 'Free shipping';
+        const scopeCount = Array.isArray(discount.productIds) ? discount.productIds.length : 0;
+        const extras = [
+            // THE SCOPE, SAID OUT LOUD. A discount can cover named
+            // products rather than the catalog, and the card showed no sign of it —
+            // so a merchant could not tell a store-wide discount from a scoped one,
+            // and had no way to understand why a scoped one takes less off than the
+            // basket total. "Store-wide" is stated rather than left blank, because a
+            // silent absence is what a narrower scope would also look like.
+            scopeCount > 0 ? `${scopeCount} product${scopeCount === 1 ? '' : 's'} only` : 'store-wide',
+            discount.minSubtotalCents ? `min $${(discount.minSubtotalCents / 100).toFixed(0)}` : '',
+            // Held slots are NAMED, not folded into the used figure (AGL-2453). A
+            // live checkout now consumes a slot for as long as it can still be paid,
+            // so `redemptions` alone would show a cap of 100 sitting at 100 against
+            // 97 orders with nothing to explain the other three.
+            discount.maxRedemptions ? CommerceModel.promotionUsageLabel(discount, Date.now()) : ''
+        ].filter(Boolean).join(' · ');
+        return `${value}${extras ? ` · ${extras}` : ''}`;
+    };
+    return /*#__PURE__*/ _jsxs(CardDisplay, {
+        header: 'Discounts',
+        help: pluginDocsHelp('commerceEndToEnd', {
+            anchor: '#4-what-checkout-does',
+            excerpt: 'Discount codes your customers type at your own checkout — not ' + `the coupons ${Aglyn.PLATFORM_BRAND_NAME} issues against your subscription.`
+        }),
+        contentGutterX: true,
+        contentGutterY: true,
+        children: [
+            /*#__PURE__*/ _jsxs(Stack, {
+                spacing: 1,
+                children: [
+                    discounts.length === 0 && page === 0 ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: 'Codes buyers enter at checkout, or automatic promotions that ' + 'apply on their own.'
+                    }) : discounts.map((discount)=>/*#__PURE__*/ _jsxs(Stack, {
+                            direction: "row",
+                            spacing: 1,
+                            sx: {
+                                alignItems: 'center'
+                            },
+                            children: [
+                                /*#__PURE__*/ _jsx(Chip, {
+                                    label: discount.code || discount.name || 'Automatic',
+                                    size: "small",
+                                    variant: "outlined",
+                                    color: discount.code ? 'primary' : 'info'
+                                }),
+                                /*#__PURE__*/ _jsxs(Typography, {
+                                    variant: "body2",
+                                    sx: {
+                                        flex: 1
+                                    },
+                                    noWrap: true,
+                                    children: [
+                                        describe(discount),
+                                        discount.enabled === false ? ' · disabled' : ''
+                                    ]
+                                }),
+                                /*#__PURE__*/ _jsx(Button, {
+                                    size: "small",
+                                    onClick: ()=>setDraft(_extends({
+                                            id: discount.$id
+                                        }, discount)),
+                                    children: 'Edit'
+                                }),
+                                /*#__PURE__*/ _jsx(Button, {
+                                    size: "small",
+                                    color: "error",
+                                    onClick: ()=>deleteDoc(doc(firestore, 'hosts', hostId, 'discounts', discount.$id)),
+                                    children: 'Delete'
+                                })
+                            ]
+                        }, discount.$id)),
+                    discounts.length === 0 && page === 0 ? null : /*#__PURE__*/ _jsx(ListPagination, {
+                        page: page,
+                        pageSize: pageSize,
+                        rowCount: discounts.length,
+                        // No `count`: a server window does not know the collection's
+                        // total, and `hasMore` is the probe row's answer rather than a
+                        // comparison against the cap.
+                        hasMore: hasMore,
+                        onPageChange: setPage,
+                        onPageSizeChange: setPageSize
+                    }),
+                    /*#__PURE__*/ _jsx(Button, {
+                        size: "small",
+                        sx: {
+                            alignSelf: 'flex-start'
+                        },
+                        onClick: ()=>setDraft({
+                                id: null,
+                                kind: 'percent',
+                                valuePct: 10,
+                                enabled: true
+                            }),
+                        children: 'Add discount'
+                    })
+                ]
+            }),
+            /*#__PURE__*/ _jsxs(Dialog, {
+                open: Boolean(draft),
+                onClose: ()=>setDraft(null),
+                maxWidth: "xs",
+                fullWidth: true,
+                children: [
+                    /*#__PURE__*/ _jsx(DialogTitle, {
+                        children: (draft == null ? void 0 : draft.id) ? 'Edit discount' : 'New discount'
+                    }),
+                    /*#__PURE__*/ _jsxs(DialogContent, {
+                        sx: {
+                            display: 'flex',
+                            flexDirection: 'column',
+                            gap: 2
+                        },
+                        children: [
+                            /*#__PURE__*/ _jsx(TextField, {
+                                label: "Code (blank = automatic)",
+                                value: (_ref = draft == null ? void 0 : draft.code) != null ? _ref : '',
+                                onChange: (event)=>setDraft((prev)=>prev ? _extends({}, prev, {
+                                            code: event.target.value
+                                        }) : prev),
+                                size: "small",
+                                sx: {
+                                    mt: 1
+                                },
+                                placeholder: "SAVE10"
+                            }),
+                            !(draft == null ? void 0 : draft.code) ? /*#__PURE__*/ _jsx(TextField, {
+                                label: "Promotion name",
+                                value: (_ref1 = draft == null ? void 0 : draft.name) != null ? _ref1 : '',
+                                onChange: (event)=>setDraft((prev)=>prev ? _extends({}, prev, {
+                                            name: event.target.value
+                                        }) : prev),
+                                size: "small",
+                                placeholder: "Summer sale"
+                            }) : null,
+                            /*#__PURE__*/ _jsxs(Stack, {
+                                direction: "row",
+                                spacing: 1,
+                                children: [
+                                    /*#__PURE__*/ _jsxs(TextField, {
+                                        label: "Type",
+                                        value: (_ref2 = draft == null ? void 0 : draft.kind) != null ? _ref2 : 'percent',
+                                        onChange: (event)=>setDraft((prev)=>prev ? _extends({}, prev, {
+                                                    kind: event.target.value
+                                                }) : prev),
+                                        size: "small",
+                                        select: true,
+                                        sx: {
+                                            minWidth: 150
+                                        },
+                                        children: [
+                                            /*#__PURE__*/ _jsx(MenuItem, {
+                                                value: "percent",
+                                                children: 'Percent off'
+                                            }),
+                                            /*#__PURE__*/ _jsx(MenuItem, {
+                                                value: "fixed",
+                                                children: 'Fixed amount off'
+                                            }),
+                                            /*#__PURE__*/ _jsx(MenuItem, {
+                                                value: "free_shipping",
+                                                children: 'Free shipping'
+                                            })
+                                        ]
+                                    }),
+                                    (draft == null ? void 0 : draft.kind) === 'percent' ? /*#__PURE__*/ _jsx(TextField, {
+                                        label: "%",
+                                        value: (_ref3 = draft == null ? void 0 : draft.valuePct) != null ? _ref3 : '',
+                                        onChange: (event)=>setDraft((prev)=>prev ? _extends({}, prev, {
+                                                    valuePct: Math.min(100, Math.max(0, Number(event.target.value) || 0))
+                                                }) : prev),
+                                        size: "small",
+                                        sx: {
+                                            width: 90
+                                        },
+                                        slotProps: {
+                                            htmlInput: {
+                                                inputMode: 'numeric'
+                                            }
+                                        }
+                                    }) : null,
+                                    (draft == null ? void 0 : draft.kind) === 'fixed' ? /*#__PURE__*/ _jsx(TextField, {
+                                        label: "$ off",
+                                        value: (draft == null ? void 0 : draft.valueCents) != null ? draft.valueCents / 100 : '',
+                                        onChange: (event)=>setDraft((prev)=>prev ? _extends({}, prev, {
+                                                    valueCents: Math.round((Number(event.target.value) || 0) * 100)
+                                                }) : prev),
+                                        size: "small",
+                                        sx: {
+                                            width: 110
+                                        },
+                                        slotProps: {
+                                            htmlInput: {
+                                                inputMode: 'decimal'
+                                            }
+                                        }
+                                    }) : null
+                                ]
+                            }),
+                            /*#__PURE__*/ _jsxs(Stack, {
+                                direction: "row",
+                                spacing: 1,
+                                children: [
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        label: "Min subtotal ($)",
+                                        placeholder: "None",
+                                        value: (draft == null ? void 0 : draft.minSubtotalCents) != null ? draft.minSubtotalCents / 100 : '',
+                                        onChange: (event)=>{
+                                            const raw = event.target.value.trim();
+                                            setDraft((prev)=>prev ? _extends({}, prev, {
+                                                    minSubtotalCents: raw === '' ? undefined : Math.round((Number(raw) || 0) * 100)
+                                                }) : prev);
+                                        },
+                                        size: "small",
+                                        slotProps: {
+                                            htmlInput: {
+                                                inputMode: 'decimal'
+                                            }
+                                        }
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        label: "Max uses",
+                                        placeholder: "Unlimited",
+                                        value: (_ref4 = draft == null ? void 0 : draft.maxRedemptions) != null ? _ref4 : '',
+                                        onChange: (event)=>{
+                                            const raw = event.target.value.trim();
+                                            setDraft((prev)=>prev ? _extends({}, prev, {
+                                                    maxRedemptions: raw === '' ? undefined : Math.max(1, Math.round(Number(raw)))
+                                                }) : prev);
+                                        },
+                                        size: "small",
+                                        slotProps: {
+                                            htmlInput: {
+                                                inputMode: 'numeric'
+                                            }
+                                        }
+                                    })
+                                ]
+                            }),
+                            /*#__PURE__*/ _jsxs(Stack, {
+                                direction: "row",
+                                spacing: 1,
+                                children: [
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        label: "Starts",
+                                        type: "date",
+                                        value: (draft == null ? void 0 : draft.startAtMs) ? new Date(draft.startAtMs).toISOString().slice(0, 10) : '',
+                                        onChange: (event)=>setDraft((prev)=>prev ? _extends({}, prev, {
+                                                    startAtMs: event.target.value ? Date.parse(`${event.target.value}T00:00:00Z`) : undefined
+                                                }) : prev),
+                                        size: "small",
+                                        fullWidth: true,
+                                        slotProps: {
+                                            inputLabel: {
+                                                shrink: true
+                                            }
+                                        }
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        label: "Ends",
+                                        type: "date",
+                                        value: (draft == null ? void 0 : draft.endAtMs) ? new Date(draft.endAtMs).toISOString().slice(0, 10) : '',
+                                        onChange: (event)=>setDraft((prev)=>prev ? _extends({}, prev, {
+                                                    endAtMs: event.target.value ? Date.parse(`${event.target.value}T23:59:59Z`) : undefined
+                                                }) : prev),
+                                        size: "small",
+                                        fullWidth: true,
+                                        slotProps: {
+                                            inputLabel: {
+                                                shrink: true
+                                            }
+                                        }
+                                    })
+                                ]
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsxs(DialogActions, {
+                        children: [
+                            /*#__PURE__*/ _jsx(Button, {
+                                onClick: ()=>setDraft(null),
+                                children: 'Cancel'
+                            }),
+                            /*#__PURE__*/ _jsx(Button, {
+                                variant: "contained",
+                                color: "primary",
+                                disabled: (draft == null ? void 0 : draft.kind) === 'percent' && !(((_ref5 = draft == null ? void 0 : draft.valuePct) != null ? _ref5 : 0) > 0) || (draft == null ? void 0 : draft.kind) === 'fixed' && !(((_ref6 = draft == null ? void 0 : draft.valueCents) != null ? _ref6 : 0) > 0),
+                                onClick: handleSave,
+                                children: 'Save'
+                            })
+                        ]
+                    })
+                ]
+            })
+        ]
+    });
+}
+DiscountsCard.displayName = 'DiscountsCard';
+export default DiscountsCard;
+
+//# sourceMappingURL=discounts-card.component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/discounts-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 * as Aglyn from '@aglyn/aglyn'\nimport * as CommerceModel from '../../model'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  Button,\n  Chip,\n  Dialog,\n  DialogActions,\n  DialogContent,\n  DialogTitle,\n  MenuItem,\n  Stack,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport {\n  collection,\n  deleteDoc,\n  doc,\n  setDoc,\n} from 'firebase/firestore'\nimport { useCallback, useState } from 'react'\nimport { useFirestore } from '@aglyn/tenant-feature-instance'\nimport {\n  collectionPage,\n  usePagedCollection,\n  writeGuardedBySeed,\n} from '@aglyn/tenant-feature-instance'\nimport { ListPagination } from '@aglyn/shared-ui-jsx/components/list-pagination.component'\nimport { pluginDocsHelp } from '@aglyn/aglyn'\n\nexport interface DiscountsCardProps {\n  hostId: string\n}\n\n/**\n * Discounts hub (AGL-305): code and automatic promotions with value,\n * min-subtotal, schedule, and usage-limit controls, resolved at\n * checkout/POS by the shared engine. Supersedes the simple coupons\n * card (which keeps working for existing codes).\n */\nexport function DiscountsCard(props: DiscountsCardProps) {\n  const { hostId } = props\n  const firestore = useFirestore()\n  const { enqueueSnackbar } = useSnackbar()\n  const {\n    status: discountsStatus,\n    /**\n     * The row this dialog is seeded from is unconfirmed by the server\n     * (AGL-1358). `redemptions` is a LIVE counter the checkout engine\n     * increments, and editing a discount copies it out of the seed and\n     * writes it straight back — so a cached seed rolls the count backwards\n     * and hands out redemptions that were already spent.\n     */\n    fromCache: discountsFromCache,\n    rows: discounts,\n    hasMore,\n    page,\n    setPage,\n    pageSize,\n    setPageSize,\n  } = usePagedCollection<any>(\n    /*\n     * SERVER-PAGED, and ordered (AGL-2501).\n     *\n     * `limit(100)` alone is answered in DOCUMENT-ID order and the ids are\n     * `createResourceUid()`, so the hundred were a pseudo-random sample of the\n     * shop's promotions — and the hundred-and-first was UNREACHABLE, because\n     * nothing rendered it and no control asked for more.\n     *\n     * The query can be paged here, unlike the cards carrying a duplicate-name\n     * check: a discount's identity is its document id, `code` is an ordinary\n     * field with no uniqueness test on this surface, and nothing on the card\n     * is computed from rows that are off the page.\n     *\n     * `collectionPage` orders on the document NAME. `orderBy('code')` is the\n     * tempting one and would be wrong twice: an AUTOMATIC promotion is stored\n     * with `code: null`, so ordering on it would hide every automatic discount\n     * the shop has, and a merchant reading \"no automatic promotions\" would be\n     * reading a query artifact.\n     */\n    (pageLimit) =>\n      collectionPage(\n        collection(firestore, 'hosts', hostId, 'discounts'),\n        pageLimit,\n      ),\n    [firestore, hostId],\n    { idField: '$id' },\n  )\n  const [draft, setDraft] = useState<\n    (Partial<CommerceModel.HostDiscount> & { id: string | null }) | null\n  >(null)\n\n  const handleSave = useCallback(async () => {\n    if (!draft) return\n    /**\n     * `$id` comes off with `id` (AGL-1374).\n     *\n     * The editor is seeded `{ id: discount.$id, ...discount }`, and that\n     * spread carries the listener's SYNTHETIC `$id` — `idField: '$id'`\n     * stamps the document id onto the in-memory row, where nothing persists\n     * it. Destructuring only `id` left `$id` in `data`, so every save wrote\n     * it into the stored document as a real field. Nothing reads it; it is\n     * the listener's bookkeeping leaking into storage, and once there no\n     * reader can tell it from a field the card meant to write.\n     */\n    const seeded = draft as typeof draft & { $id?: string }\n    const { id, $id: _syntheticId, ...data } = seeded\n    const code = data.code?.trim().toUpperCase().replace(/[^A-Z0-9_-]/g, '')\n    /**\n     * Refuse an EDIT whose seed the server never confirmed (AGL-1358).\n     *\n     * `merge: true` protects nothing here — `{...data}` carries every field\n     * of the seeded row, `redemptions` included, so it is written back\n     * whether or not anyone touched it. Under `persistentLocalCache` that\n     * seed can be arbitrarily old, and a redemption cap silently regains\n     * uses that buyers already spent.\n     *\n     * Only the edit path is guarded: a NEW discount is built from blanks at\n     * a fresh uid and can overwrite nothing.\n     */\n    const verdict = await writeGuardedBySeed(\n      {\n        subject: 'discount',\n        unreadable: Boolean(id) && discountsStatus === 'error',\n        fromCache: Boolean(id) && discountsFromCache,\n      },\n      async () => {\n        await setDoc(\n          doc(\n            firestore,\n            'hosts',\n            hostId,\n            'discounts',\n            id ?? Aglyn.createResourceUid(),\n          ),\n          {\n            ...data,\n            ...(code ? { code } : { code: null }),\n            enabled: data.enabled !== false,\n            redemptions: data.redemptions ?? 0,\n          },\n          { merge: true },\n        )\n      },\n    )\n    // Keep the dialog open with what was typed rather than failing silently.\n    if (!verdict.ok) {\n      return void enqueueSnackbar(verdict.message, {\n        variant: 'warning',\n        persist: false,\n      })\n    }\n    setDraft(null)\n    enqueueSnackbar('Discount saved', { variant: 'success', persist: false })\n  }, [\n    draft,\n    firestore,\n    hostId,\n    enqueueSnackbar,\n    discountsFromCache,\n    discountsStatus,\n  ])\n\n  const describe = (discount: any) => {\n    const value =\n      discount.kind === 'percent'\n        ? `${discount.valuePct}% off`\n        : discount.kind === 'fixed'\n          ? `$${((discount.valueCents ?? 0) / 100).toFixed(2)} off`\n          : 'Free shipping'\n    const scopeCount = Array.isArray(discount.productIds)\n      ? discount.productIds.length\n      : 0\n    const extras = [\n      // THE SCOPE, SAID OUT LOUD. A discount can cover named\n      // products rather than the catalog, and the card showed no sign of it —\n      // so a merchant could not tell a store-wide discount from a scoped one,\n      // and had no way to understand why a scoped one takes less off than the\n      // basket total. \"Store-wide\" is stated rather than left blank, because a\n      // silent absence is what a narrower scope would also look like.\n      scopeCount > 0\n        ? `${scopeCount} product${scopeCount === 1 ? '' : 's'} only`\n        : 'store-wide',\n      discount.minSubtotalCents\n        ? `min $${(discount.minSubtotalCents / 100).toFixed(0)}`\n        : '',\n      // Held slots are NAMED, not folded into the used figure (AGL-2453). A\n      // live checkout now consumes a slot for as long as it can still be paid,\n      // so `redemptions` alone would show a cap of 100 sitting at 100 against\n      // 97 orders with nothing to explain the other three.\n      discount.maxRedemptions\n        ? CommerceModel.promotionUsageLabel(discount, Date.now())\n        : '',\n    ]\n      .filter(Boolean)\n      .join(' · ')\n    return `${value}${extras ? ` · ${extras}` : ''}`\n  }\n\n  return (\n    <CardDisplay\n      header={'Discounts'}\n      help={pluginDocsHelp('commerceEndToEnd', {\n        anchor: '#4-what-checkout-does',\n        excerpt:\n          'Discount codes your customers type at your own checkout — not ' +\n          `the coupons ${Aglyn.PLATFORM_BRAND_NAME} issues against your subscription.`,\n      })}\n      contentGutterX\n      contentGutterY\n    >\n      <Stack spacing={1}>\n        {discounts.length === 0 && page === 0 ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'Codes buyers enter at checkout, or automatic promotions that ' +\n              'apply on their own.'}\n          </Typography>\n        ) : (\n          discounts.map((discount: any) => (\n            <Stack\n              key={discount.$id}\n              direction=\"row\"\n              spacing={1}\n              sx={{ alignItems: 'center' }}\n            >\n              <Chip\n                label={discount.code || discount.name || 'Automatic'}\n                size=\"small\"\n                variant=\"outlined\"\n                color={discount.code ? 'primary' : 'info'}\n              />\n              <Typography variant=\"body2\" sx={{ flex: 1 }} noWrap>\n                {describe(discount)}\n                {discount.enabled === false ? ' · disabled' : ''}\n              </Typography>\n              <Button\n                size=\"small\"\n                onClick={() => setDraft({ id: discount.$id, ...discount })}\n              >\n                {'Edit'}\n              </Button>\n              <Button\n                size=\"small\"\n                color=\"error\"\n                onClick={() =>\n                  deleteDoc(\n                    doc(firestore, 'hosts', hostId, 'discounts', discount.$id),\n                  )\n                }\n              >\n                {'Delete'}\n              </Button>\n            </Stack>\n          ))\n        )}\n        {discounts.length === 0 && page === 0 ? null : (\n          <ListPagination\n            page={page}\n            pageSize={pageSize}\n            rowCount={discounts.length}\n            // No `count`: a server window does not know the collection's\n            // total, and `hasMore` is the probe row's answer rather than a\n            // comparison against the cap.\n            hasMore={hasMore}\n            onPageChange={setPage}\n            onPageSizeChange={setPageSize}\n          />\n        )}\n        <Button\n          size=\"small\"\n          sx={{ alignSelf: 'flex-start' }}\n          onClick={() =>\n            setDraft({ id: null, kind: 'percent', valuePct: 10, enabled: true })\n          }\n        >\n          {'Add discount'}\n        </Button>\n      </Stack>\n      <Dialog\n        open={Boolean(draft)}\n        onClose={() => setDraft(null)}\n        maxWidth=\"xs\"\n        fullWidth\n      >\n        <DialogTitle>{draft?.id ? 'Edit discount' : 'New discount'}</DialogTitle>\n        <DialogContent sx={{ display: 'flex', flexDirection: 'column', gap: 2 }}>\n          <TextField\n            label=\"Code (blank = automatic)\"\n            value={draft?.code ?? ''}\n            onChange={(event) =>\n              setDraft((prev) =>\n                prev ? { ...prev, code: event.target.value } : prev,\n              )\n            }\n            size=\"small\"\n            sx={{ mt: 1 }}\n            placeholder=\"SAVE10\"\n          />\n          {!draft?.code ? (\n            <TextField\n              label=\"Promotion name\"\n              value={draft?.name ?? ''}\n              onChange={(event) =>\n                setDraft((prev) =>\n                  prev ? { ...prev, name: event.target.value } : prev,\n                )\n              }\n              size=\"small\"\n              placeholder=\"Summer sale\"\n            />\n          ) : null}\n          <Stack direction=\"row\" spacing={1}>\n            <TextField\n              label=\"Type\"\n              value={draft?.kind ?? 'percent'}\n              onChange={(event) =>\n                setDraft((prev) =>\n                  prev\n                    ? { ...prev, kind: event.target.value as CommerceModel.DiscountKind }\n                    : prev,\n                )\n              }\n              size=\"small\"\n              select\n              sx={{ minWidth: 150 }}\n            >\n              <MenuItem value=\"percent\">{'Percent off'}</MenuItem>\n              <MenuItem value=\"fixed\">{'Fixed amount off'}</MenuItem>\n              <MenuItem value=\"free_shipping\">{'Free shipping'}</MenuItem>\n            </TextField>\n            {draft?.kind === 'percent' ? (\n              <TextField\n                label=\"%\"\n                value={draft?.valuePct ?? ''}\n                onChange={(event) =>\n                  setDraft((prev) =>\n                    prev\n                      ? {\n                          ...prev,\n                          valuePct: Math.min(\n                            100,\n                            Math.max(0, Number(event.target.value) || 0),\n                          ),\n                        }\n                      : prev,\n                  )\n                }\n                size=\"small\"\n                sx={{ width: 90 }}\n                slotProps={{ htmlInput: { inputMode: 'numeric' } }}\n              />\n            ) : null}\n            {draft?.kind === 'fixed' ? (\n              <TextField\n                label=\"$ off\"\n                value={\n                  draft?.valueCents != null ? draft.valueCents / 100 : ''\n                }\n                onChange={(event) =>\n                  setDraft((prev) =>\n                    prev\n                      ? {\n                          ...prev,\n                          valueCents: Math.round(\n                            (Number(event.target.value) || 0) * 100,\n                          ),\n                        }\n                      : prev,\n                  )\n                }\n                size=\"small\"\n                sx={{ width: 110 }}\n                slotProps={{ htmlInput: { inputMode: 'decimal' } }}\n              />\n            ) : null}\n          </Stack>\n          <Stack direction=\"row\" spacing={1}>\n            <TextField\n              label=\"Min subtotal ($)\"\n              placeholder=\"None\"\n              value={\n                draft?.minSubtotalCents != null\n                  ? draft.minSubtotalCents / 100\n                  : ''\n              }\n              onChange={(event) => {\n                const raw = event.target.value.trim()\n                setDraft((prev) =>\n                  prev\n                    ? {\n                        ...prev,\n                        minSubtotalCents:\n                          raw === ''\n                            ? undefined\n                            : Math.round((Number(raw) || 0) * 100),\n                      }\n                    : prev,\n                )\n              }}\n              size=\"small\"\n              slotProps={{ htmlInput: { inputMode: 'decimal' } }}\n            />\n            <TextField\n              label=\"Max uses\"\n              placeholder=\"Unlimited\"\n              value={draft?.maxRedemptions ?? ''}\n              onChange={(event) => {\n                const raw = event.target.value.trim()\n                setDraft((prev) =>\n                  prev\n                    ? {\n                        ...prev,\n                        maxRedemptions:\n                          raw === ''\n                            ? undefined\n                            : Math.max(1, Math.round(Number(raw))),\n                      }\n                    : prev,\n                )\n              }}\n              size=\"small\"\n              slotProps={{ htmlInput: { inputMode: 'numeric' } }}\n            />\n          </Stack>\n          <Stack direction=\"row\" spacing={1}>\n            <TextField\n              label=\"Starts\"\n              type=\"date\"\n              value={\n                draft?.startAtMs\n                  ? new Date(draft.startAtMs).toISOString().slice(0, 10)\n                  : ''\n              }\n              onChange={(event) =>\n                setDraft((prev) =>\n                  prev\n                    ? {\n                        ...prev,\n                        startAtMs: event.target.value\n                          ? Date.parse(`${event.target.value}T00:00:00Z`)\n                          : undefined,\n                      }\n                    : prev,\n                )\n              }\n              size=\"small\"\n              fullWidth\n              slotProps={{ inputLabel: { shrink: true } }}\n            />\n            <TextField\n              label=\"Ends\"\n              type=\"date\"\n              value={\n                draft?.endAtMs\n                  ? new Date(draft.endAtMs).toISOString().slice(0, 10)\n                  : ''\n              }\n              onChange={(event) =>\n                setDraft((prev) =>\n                  prev\n                    ? {\n                        ...prev,\n                        endAtMs: event.target.value\n                          ? Date.parse(`${event.target.value}T23:59:59Z`)\n                          : undefined,\n                      }\n                    : prev,\n                )\n              }\n              size=\"small\"\n              fullWidth\n              slotProps={{ inputLabel: { shrink: true } }}\n            />\n          </Stack>\n        </DialogContent>\n        <DialogActions>\n          <Button onClick={() => setDraft(null)}>{'Cancel'}</Button>\n          <Button\n            variant=\"contained\"\n            color=\"primary\"\n            disabled={\n              (draft?.kind === 'percent' && !((draft?.valuePct ?? 0) > 0)) ||\n              (draft?.kind === 'fixed' && !((draft?.valueCents ?? 0) > 0))\n            }\n            onClick={handleSave}\n          >\n            {'Save'}\n          </Button>\n        </DialogActions>\n      </Dialog>\n    </CardDisplay>\n  )\n}\nDiscountsCard.displayName = 'DiscountsCard'\n\nexport default DiscountsCard\n"],"names":["Aglyn","CommerceModel","CardDisplay","useSnackbar","Button","Chip","Dialog","DialogActions","DialogContent","DialogTitle","MenuItem","Stack","TextField","Typography","collection","deleteDoc","doc","setDoc","useCallback","useState","useFirestore","collectionPage","usePagedCollection","writeGuardedBySeed","ListPagination","pluginDocsHelp","DiscountsCard","props","hostId","firestore","enqueueSnackbar","status","discountsStatus","fromCache","discountsFromCache","rows","discounts","hasMore","page","setPage","pageSize","setPageSize","pageLimit","idField","draft","setDraft","handleSave","data","seeded","id","$id","_syntheticId","code","trim","toUpperCase","replace","verdict","subject","unreadable","Boolean","createResourceUid","enabled","redemptions","merge","ok","message","variant","persist","describe","discount","value","kind","valuePct","valueCents","toFixed","scopeCount","Array","isArray","productIds","length","extras","minSubtotalCents","maxRedemptions","promotionUsageLabel","Date","now","filter","join","header","help","anchor","excerpt","PLATFORM_BRAND_NAME","contentGutterX","contentGutterY","spacing","color","map","direction","sx","alignItems","label","name","size","flex","noWrap","onClick","rowCount","onPageChange","onPageSizeChange","alignSelf","open","onClose","maxWidth","fullWidth","display","flexDirection","gap","onChange","event","prev","target","mt","placeholder","select","minWidth","Math","min","max","Number","width","slotProps","htmlInput","inputMode","round","raw","undefined","type","startAtMs","toISOString","slice","parse","inputLabel","shrink","endAtMs","disabled","displayName"],"mappings":"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"}

package/src/lib/components/console/entitlement-gate.component.d.ts

@@ -0,0 +1,76 @@
+import type { OrgFeatureFlags } from '@aglyn/aglyn';
+import { type HelpTipContent } from '@aglyn/shared-ui-jsx';
+import type { ReactNode } from 'react';
+export interface CommerceEntitlementState {
+    /** The plan doc has settled. NEVER refuse before this is true. */
+    ready: boolean;
+    entitled: boolean;
+    /** Console billing route, or undefined before the org slug resolves. */
+    upgradeHref: string | undefined;
+    /** Cheapest plan carrying the feature — "Business". */
+    planLabel: string | undefined;
+}
+/**
+ * The three-state entitlement read every commerce console surface needs
+ * (AGL-2080), factored out of the copy-pasted pair that
+ * `CommerceAnalyticsCard` and `CommerceGlanceCard` grew in AGL-2056.
+ *
+ * Three states, not two. `checkEntitlement(undefined)` resolves the FREE
+ * tier rather than "unknown", so a surface that refuses on `!entitled`
+ * alone shows a paying customer an upgrade prompt for the render or two
+ * their org doc is in flight. `ready` is the difference, and it is why this
+ * returns a struct rather than a boolean — a boolean is the API that caused
+ * the bug.
+ *
+ * `planLabel` comes from `planGrantingFeature`, derived from
+ * `PLAN_ENTITLEMENTS` on every call, so the upsell can never name a tier
+ * that no longer carries the feature.
+ */
+export declare function useCommerceEntitlement(hostId: string | undefined, feature: keyof OrgFeatureFlags): CommerceEntitlementState;
+export interface EntitlementUpsellProps {
+    /** What the feature is and what it does, in the operator's terms. */
+    children: ReactNode;
+    planLabel: string | undefined;
+    upgradeHref: string | undefined;
+}
+/**
+ * The locked-state notice: what the feature is, which plan carries it, and
+ * one click to the plan grid.
+ *
+ * The plan name is not decoration. "This is a paid feature" is a dead end;
+ * "this is on Business" plus an Upgrade button is the upgrade path AGL-1859
+ * asks to keep prominent and one-click. Always `AppLink` — a MUI `href`
+ * bypasses the client router and full-reloads the console.
+ */
+export declare function EntitlementUpsell(props: EntitlementUpsellProps): import("react").JSX.Element;
+export interface EntitlementGatedCardProps {
+    hostId: string;
+    feature: keyof OrgFeatureFlags;
+    header: string;
+    /**
+     * Help affordance for the two branches this component renders itself
+     * (AGL-2213).
+     *
+     * Required, not optional. The entitled branch renders `children`, which is
+     * the real card and carries its own help; the branches rendered HERE are
+     * "checking your plan" and the refusal — and the refusal is the one a
+     * reader reaches precisely because they do not have what it takes. That is
+     * the branch AGL-2130 found carrying no explanation on two console cards,
+     * and an optional prop would let it happen again silently.
+     */
+    help: HelpTipContent;
+    /** Locked-state copy: what this does, so the upsell sells something. */
+    upsell: ReactNode;
+    children: ReactNode;
+}
+/**
+ * A whole console card behind an entitlement (AGL-2080).
+ *
+ * The refusal happens BEFORE the operator can configure anything, which is
+ * the entire point: five commerce features were fully configurable by an
+ * unentitled org and only failed at checkout — a refusal delivered to the
+ * buyer instead of the operator. A warning after configuration would be the
+ * same defect with better manners.
+ */
+export declare function EntitlementGatedCard(props: EntitlementGatedCardProps): import("react").JSX.Element;
+export default EntitlementGatedCard;