@aglyn/plugins-commerce 1.0.0-beta.143

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

@@ -0,0 +1,473 @@
+/**
+ * @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 { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import * as CommerceModel from "../../model/index.js";
+import { PLATFORM_BRAND_NAME } from "@aglyn/aglyn/app-utils/platform-brand";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { Alert, Button, Divider, FormControlLabel, MenuItem, Stack, Switch, TextField, Typography } from "@mui/material";
+import { doc, setDoc } from "firebase/firestore";
+import { useCallback, useState } from "react";
+import { useFirestore } from "@aglyn/tenant-feature-instance";
+import { useFirestoreDoc, writeGuardedBySeed } from "@aglyn/tenant-feature-instance";
+import { pluginDocsHelp } from "@aglyn/aglyn";
+/**
+ * Tax settings (AGL-285): manual per-region rates (most-specific wins)
+ * or Stripe Tax automatic calculation, stored on
+ * `hosts/{hostId}/settings/store` under `tax`. The legacy quick-buy
+ * checkout taxes by the store origin; Checkout v2 taxes by destination.
+ */ export function TaxSettingsCard(props) {
+    var _ref, _current_mode, _ref1, _ref2, _current_rates, _flatPctProblem, _ref3, _flatPctProblem1, _ref4;
+    var _store_tax, _current_origin, _current_origin1, _current_lodging, _current_service;
+    const { hostId } = props;
+    const firestore = useFirestore();
+    const { enqueueSnackbar } = useSnackbar();
+    const { data: store, status: storeStatus, /**
+     * The settings doc this form is seeded from is unconfirmed by the server
+     * (AGL-1358). `current` is `draft ?? store?.tax ?? {mode: 'manual'}` and
+     * the save writes `{tax: current}`, so `merge: true` protects the doc's
+     * other maps and nothing inside this one. `mode` is the field that costs
+     * money: a cached seed flipping `stripe` back to `manual` stops automatic
+     * tax calculation — `resolveTaxRate` returns null in stripe mode — and
+     * the store under-collects with nothing anywhere reporting it.
+     */ fromCache: storeFromCache } = useFirestoreDoc(()=>doc(firestore, 'hosts', hostId, 'settings', 'store'), [
+        firestore,
+        hostId
+    ]);
+    const [draft, setDraft] = useState(null);
+    const current = (_ref = draft != null ? draft : store == null ? void 0 : store.tax) != null ? _ref : {
+        mode: 'manual'
+    };
+    /**
+   * Whether anyone has ever answered the tax question for this store
+   * (AGL-1999). Read from the SAVED document, never from `current` — the
+   * `{ mode: 'manual' }` seed above is local state that has never reached
+   * Firestore, and it is exactly what made this invisible: the card looked
+   * configured while the server saw `mode: undefined`, took no branch, and
+   * sold untaxed. Every storefront path now refuses that state, so the card
+   * has to show it rather than paper over it.
+   */ const decided = storeStatus !== 'loading' && typeof (store == null ? void 0 : (_store_tax = store.tax) == null ? void 0 : _store_tax.mode) === 'string';
+    const update = (patch)=>setDraft(_extends({}, current, patch));
+    const updateRate = (index, patch)=>{
+        var _current_rates;
+        const rates = [
+            ...(_current_rates = current.rates) != null ? _current_rates : []
+        ];
+        if (patch === null) rates.splice(index, 1);
+        else rates[index] = _extends({
+            country: '',
+            pct: 0
+        }, rates[index], patch);
+        update({
+            rates
+        });
+    };
+    /**
+   * One of the flat, per-regime rates (AGL-1969 lodging, AGL-2028 services).
+   *
+   * A blank field clears the rate rather than storing `NaN`: clearing is how a
+   * merchant turns the regime back off, and `Number('')` is 0 while
+   * `Number(' ')` is also 0 — neither of which should ever reach the document
+   * as a "rate".
+   */ const updateFlat = (key, patch)=>update({
+            [key]: _extends({}, current[key], patch)
+        });
+    const flatPctText = (key)=>{
+        var _current_key;
+        const pct = (_current_key = current[key]) == null ? void 0 : _current_key.pct;
+        return pct === undefined || pct === null ? '' : String(pct);
+    };
+    /**
+   * Shown under a typed rate this will NOT apply. Silence here would be the
+   * failure: `resolveFlatTaxCents` treats an out-of-range percentage as off,
+   * so a decimal-point typo would otherwise save cleanly and collect nothing.
+   */ const flatPctProblem = (key)=>{
+        var _current_key;
+        const raw = (_current_key = current[key]) == null ? void 0 : _current_key.pct;
+        if (raw === undefined || raw === null || String(raw) === '') return null;
+        if (Number(raw) === 0) return null;
+        return CommerceModel.isUsableFlatTaxPct(raw) ? null : `Enter a percentage between 0 and ${CommerceModel.FLAT_TAX_MAX_PCT}. ` + 'This rate is not being applied.';
+    };
+    const handleSave = useCallback(async ()=>{
+        /**
+     * Refuse a save whose seed the server never confirmed (AGL-1358).
+     *
+     * No create path to exempt: this is a FIXED document path, so the
+     * `{mode: 'manual'}` default produced when the cache has never seen the
+     * map is not the harmless blank a fresh uid would be — writing it turns
+     * automatic tax calculation off on a store that had it on.
+     *
+     * The guard WRAPS the write — an early return is a shape you can keep
+     * while losing the protection.
+     */ const verdict = await writeGuardedBySeed({
+            subject: 'tax settings',
+            unreadable: storeStatus === 'error',
+            fromCache: storeFromCache
+        }, async ()=>{
+            await setDoc(doc(firestore, 'hosts', hostId, 'settings', 'store'), {
+                tax: current
+            }, {
+                merge: true
+            });
+        });
+        // Before `setDraft(null)`, so a refusal keeps every typed rate on screen.
+        if (!verdict.ok) {
+            return void enqueueSnackbar(verdict.message, {
+                variant: 'warning',
+                persist: false
+            });
+        }
+        setDraft(null);
+        enqueueSnackbar('Tax settings saved', {
+            variant: 'success',
+            persist: false
+        });
+    }, [
+        current,
+        firestore,
+        hostId,
+        enqueueSnackbar,
+        storeStatus,
+        storeFromCache
+    ]);
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: 'Taxes',
+        help: pluginDocsHelp('commerce', {
+            anchor: '#shipping--taxes'
+        }),
+        contentGutterX: true,
+        contentGutterY: true,
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 1.5,
+            children: [
+                decided ? null : // The store is not selling. Saying so here is the whole point: the
+                // silent version of this state charged shoppers an untaxed total.
+                /*#__PURE__*/ _jsx(Alert, {
+                    severity: "warning",
+                    children: 'Choose how this store handles sales tax and save. Until you ' + 'do, checkout is turned off — we won’t take an order we can’t ' + 'tax correctly.'
+                }),
+                /*#__PURE__*/ _jsxs(TextField, {
+                    label: "Calculation",
+                    value: (_current_mode = current.mode) != null ? _current_mode : 'manual',
+                    onChange: (event)=>update({
+                            mode: event.target.value
+                        }),
+                    size: "small",
+                    select: true,
+                    sx: {
+                        maxWidth: 280
+                    },
+                    children: [
+                        /*#__PURE__*/ _jsx(MenuItem, {
+                            value: "manual",
+                            children: 'Manual rates (below)'
+                        }),
+                        /*#__PURE__*/ _jsx(MenuItem, {
+                            value: "stripe",
+                            children: 'Stripe Tax (automatic)'
+                        }),
+                        /*#__PURE__*/ _jsx(MenuItem, {
+                            value: "none",
+                            children: 'Don’t collect sales tax'
+                        })
+                    ]
+                }),
+                current.mode === 'none' ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "text.secondary",
+                    children: 'This store adds no sales tax to any order. Orders still go ' + 'through — the decision is recorded, not the tax.'
+                }) : current.mode === 'stripe' ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "text.secondary",
+                    children: 'Stripe Tax calculates per buyer location at checkout. ' + 'Activate Stripe Tax in your Stripe dashboard first.'
+                }) : /*#__PURE__*/ _jsxs(_Fragment, {
+                    children: [
+                        /*#__PURE__*/ _jsx(FormControlLabel, {
+                            control: /*#__PURE__*/ _jsx(Switch, {
+                                size: "small",
+                                checked: Boolean(current.pricesIncludeTax),
+                                onChange: (event)=>update({
+                                        pricesIncludeTax: event.target.checked
+                                    })
+                            }),
+                            label: "Prices include tax (VAT-style)"
+                        }),
+                        /*#__PURE__*/ _jsxs(Stack, {
+                            direction: "row",
+                            spacing: 1,
+                            children: [
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "Origin country",
+                                    value: (_ref1 = (_current_origin = current.origin) == null ? void 0 : _current_origin.country) != null ? _ref1 : '',
+                                    onChange: (event)=>update({
+                                            origin: _extends({}, current.origin, {
+                                                country: event.target.value.toUpperCase().slice(0, 2)
+                                            })
+                                        }),
+                                    size: "small",
+                                    sx: {
+                                        width: 140
+                                    },
+                                    placeholder: "US"
+                                }),
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "Origin state",
+                                    value: (_ref2 = (_current_origin1 = current.origin) == null ? void 0 : _current_origin1.state) != null ? _ref2 : '',
+                                    onChange: (event)=>update({
+                                            origin: _extends({}, current.origin, {
+                                                state: event.target.value.toUpperCase().slice(0, 3)
+                                            })
+                                        }),
+                                    size: "small",
+                                    sx: {
+                                        width: 140
+                                    },
+                                    placeholder: "TX"
+                                })
+                            ]
+                        }),
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'Where this store ships or sells FROM — the jurisdiction the ' + 'manual rates below are applied from. Not the address your ' + 'workspace is billed at by Aglyn, and not where your payouts ' + 'are sent.'
+                        }),
+                        ((_current_rates = current.rates) != null ? _current_rates : []).map((rate, index)=>{
+                            var _rate_state, _rate_label;
+                            return /*#__PURE__*/ _jsxs(Stack, {
+                                direction: "row",
+                                spacing: 1,
+                                children: [
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        label: "Country",
+                                        value: rate.country,
+                                        onChange: (event)=>updateRate(index, {
+                                                country: event.target.value.toUpperCase().slice(0, 2)
+                                            }),
+                                        size: "small",
+                                        sx: {
+                                            width: 90
+                                        }
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        label: "State",
+                                        value: (_rate_state = rate.state) != null ? _rate_state : '',
+                                        onChange: (event)=>updateRate(index, {
+                                                state: event.target.value.toUpperCase().slice(0, 3) || undefined
+                                            }),
+                                        size: "small",
+                                        sx: {
+                                            width: 80
+                                        }
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        label: "%",
+                                        value: rate.pct,
+                                        onChange: (event)=>updateRate(index, {
+                                                pct: Number(event.target.value) || 0
+                                            }),
+                                        size: "small",
+                                        sx: {
+                                            width: 80
+                                        },
+                                        slotProps: {
+                                            htmlInput: {
+                                                inputMode: 'decimal'
+                                            }
+                                        }
+                                    }),
+                                    /*#__PURE__*/ _jsx(TextField, {
+                                        label: "Label",
+                                        value: (_rate_label = rate.label) != null ? _rate_label : '',
+                                        onChange: (event)=>updateRate(index, {
+                                                label: event.target.value
+                                            }),
+                                        size: "small",
+                                        sx: {
+                                            flex: 1
+                                        },
+                                        placeholder: "Sales tax"
+                                    }),
+                                    /*#__PURE__*/ _jsx(Button, {
+                                        size: "small",
+                                        color: "error",
+                                        onClick: ()=>updateRate(index, null),
+                                        children: '✕'
+                                    })
+                                ]
+                            }, index);
+                        }),
+                        /*#__PURE__*/ _jsx(Button, {
+                            size: "small",
+                            sx: {
+                                alignSelf: 'flex-start'
+                            },
+                            onClick: ()=>{
+                                var _ref;
+                                var _current_rates;
+                                return updateRate((_ref = (_current_rates = current.rates) == null ? void 0 : _current_rates.length) != null ? _ref : 0, {});
+                            },
+                            children: 'Add rate'
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ _jsx(Divider, {
+                    sx: {
+                        my: 0.5
+                    }
+                }),
+                /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 1,
+                    children: [
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "subtitle2",
+                            children: 'Lodging tax'
+                        }),
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'Charged on reservations, on top of the price, using the rate ' + 'you enter here. It is separate from the sales tax above ' + 'because occupancy tax is its own regime with its own rates ' + 'and its own return. Leave it blank to charge none — that is ' + 'the default.'
+                        }),
+                        /*#__PURE__*/ _jsxs(Stack, {
+                            direction: "row",
+                            spacing: 1,
+                            children: [
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "Rate %",
+                                    value: flatPctText('lodging'),
+                                    onChange: (event)=>updateFlat('lodging', {
+                                            pct: event.target.value === '' ? undefined : Number(event.target.value)
+                                        }),
+                                    size: "small",
+                                    sx: {
+                                        width: 110
+                                    },
+                                    placeholder: "0",
+                                    error: Boolean(flatPctProblem('lodging')),
+                                    helperText: (_flatPctProblem = flatPctProblem('lodging')) != null ? _flatPctProblem : ' ',
+                                    slotProps: {
+                                        htmlInput: {
+                                            inputMode: 'decimal'
+                                        }
+                                    }
+                                }),
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "Label",
+                                    value: (_ref3 = (_current_lodging = current.lodging) == null ? void 0 : _current_lodging.label) != null ? _ref3 : '',
+                                    onChange: (event)=>updateFlat('lodging', {
+                                            label: event.target.value
+                                        }),
+                                    size: "small",
+                                    sx: {
+                                        flex: 1
+                                    },
+                                    placeholder: "Occupancy tax",
+                                    helperText: "Shown to the guest on the receipt"
+                                })
+                            ]
+                        }),
+                        /*#__PURE__*/ _jsx(Alert, {
+                            severity: "info",
+                            children: `${PLATFORM_BRAND_NAME} applies the rate you enter and records ` + 'what was charged. It does not determine whether this tax ' + 'applies to you, at what rate, or where it should be paid — ' + 'that is yours to decide.'
+                        }),
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'On a reservation that takes a deposit, the rate is applied to ' + 'the deposit — the amount actually charged here — not to the ' + 'whole stay. If tax is due on the full stay, collect the ' + 'difference the same way you collect the rest of the balance.'
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ _jsx(Divider, {
+                    sx: {
+                        my: 0.5
+                    }
+                }),
+                /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 1,
+                    children: [
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "subtitle2",
+                            children: 'Service tax'
+                        }),
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'Charged on paid bookings, on top of the price, using the rate ' + 'you enter here. It is separate from the sales tax above ' + 'because whether a service is taxable is often a different ' + 'question from whether goods are. Leave it blank to charge ' + 'none — that is the default.'
+                        }),
+                        /*#__PURE__*/ _jsxs(Stack, {
+                            direction: "row",
+                            spacing: 1,
+                            children: [
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "Rate %",
+                                    value: flatPctText('service'),
+                                    onChange: (event)=>updateFlat('service', {
+                                            pct: event.target.value === '' ? undefined : Number(event.target.value)
+                                        }),
+                                    size: "small",
+                                    sx: {
+                                        width: 110
+                                    },
+                                    placeholder: "0",
+                                    error: Boolean(flatPctProblem('service')),
+                                    helperText: (_flatPctProblem1 = flatPctProblem('service')) != null ? _flatPctProblem1 : ' ',
+                                    slotProps: {
+                                        htmlInput: {
+                                            inputMode: 'decimal'
+                                        }
+                                    }
+                                }),
+                                /*#__PURE__*/ _jsx(TextField, {
+                                    label: "Label",
+                                    value: (_ref4 = (_current_service = current.service) == null ? void 0 : _current_service.label) != null ? _ref4 : '',
+                                    onChange: (event)=>updateFlat('service', {
+                                            label: event.target.value
+                                        }),
+                                    size: "small",
+                                    sx: {
+                                        flex: 1
+                                    },
+                                    placeholder: "Service tax",
+                                    helperText: "Shown to the client on the receipt"
+                                })
+                            ]
+                        }),
+                        /*#__PURE__*/ _jsx(Alert, {
+                            severity: "info",
+                            children: `${PLATFORM_BRAND_NAME} applies the rate you enter and records ` + 'what was charged. It does not determine whether this tax ' + 'applies to you, at what rate, or where it should be paid — ' + 'that is yours to decide.'
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ _jsx(Button, {
+                    variant: "contained",
+                    color: "primary",
+                    size: "small",
+                    disabled: !draft,
+                    onClick: handleSave,
+                    sx: {
+                        alignSelf: 'flex-start'
+                    },
+                    children: 'Save tax settings'
+                })
+            ]
+        })
+    });
+}
+TaxSettingsCard.displayName = 'TaxSettingsCard';
+export default TaxSettingsCard;
+
+//# sourceMappingURL=tax-settings-card.component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/tax-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 * as Aglyn from '@aglyn/aglyn'\nimport * as CommerceModel from '../../model'\nimport { PLATFORM_BRAND_NAME } from '@aglyn/aglyn/app-utils/platform-brand'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  Alert,\n  Button,\n  Divider,\n  FormControlLabel,\n  MenuItem,\n  Stack,\n  Switch,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { doc, setDoc } from 'firebase/firestore'\nimport { useCallback, useState } from 'react'\nimport { useFirestore } from '@aglyn/tenant-feature-instance'\nimport {\n  useFirestoreDoc,\n  writeGuardedBySeed,\n} from '@aglyn/tenant-feature-instance'\nimport { pluginDocsHelp } from '@aglyn/aglyn'\n\nexport interface TaxSettingsCardProps {\n  hostId: string\n}\n\n/**\n * Tax settings (AGL-285): manual per-region rates (most-specific wins)\n * or Stripe Tax automatic calculation, stored on\n * `hosts/{hostId}/settings/store` under `tax`. The legacy quick-buy\n * checkout taxes by the store origin; Checkout v2 taxes by destination.\n */\nexport function TaxSettingsCard(props: TaxSettingsCardProps) {\n  const { hostId } = props\n  const firestore = useFirestore()\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?.tax ?? {mode: 'manual'}` and\n     * the save writes `{tax: current}`, so `merge: true` protects the doc's\n     * other maps and nothing inside this one. `mode` is the field that costs\n     * money: a cached seed flipping `stripe` back to `manual` stops automatic\n     * tax calculation — `resolveTaxRate` returns null in stripe mode — and\n     * the store under-collects with nothing anywhere reporting it.\n     */\n    fromCache: storeFromCache,\n  } = useFirestoreDoc<any>(\n    () => doc(firestore, 'hosts', hostId, 'settings', 'store'),\n    [firestore, hostId],\n  )\n  const [draft, setDraft] = useState<CommerceModel.TaxSettings | null>(null)\n  const current: CommerceModel.TaxSettings = draft ?? store?.tax ?? { mode: 'manual' }\n  /**\n   * Whether anyone has ever answered the tax question for this store\n   * (AGL-1999). Read from the SAVED document, never from `current` — the\n   * `{ mode: 'manual' }` seed above is local state that has never reached\n   * Firestore, and it is exactly what made this invisible: the card looked\n   * configured while the server saw `mode: undefined`, took no branch, and\n   * sold untaxed. Every storefront path now refuses that state, so the card\n   * has to show it rather than paper over it.\n   */\n  const decided =\n    storeStatus !== 'loading' && typeof store?.tax?.mode === 'string'\n  const update = (patch: Partial<CommerceModel.TaxSettings>) =>\n    setDraft({ ...current, ...patch })\n  const updateRate = (\n    index: number,\n    patch: Partial<CommerceModel.TaxRate> | null,\n  ) => {\n    const rates = [...(current.rates ?? [])]\n    if (patch === null) rates.splice(index, 1)\n    else rates[index] = { country: '', pct: 0, ...rates[index], ...patch }\n    update({ rates })\n  }\n  /**\n   * One of the flat, per-regime rates (AGL-1969 lodging, AGL-2028 services).\n   *\n   * A blank field clears the rate rather than storing `NaN`: clearing is how a\n   * merchant turns the regime back off, and `Number('')` is 0 while\n   * `Number(' ')` is also 0 — neither of which should ever reach the document\n   * as a \"rate\".\n   */\n  const updateFlat = (\n    key: 'lodging' | 'service',\n    patch: Partial<CommerceModel.FlatTaxRate>,\n  ) => update({ [key]: { ...current[key], ...patch } })\n  const flatPctText = (key: 'lodging' | 'service') => {\n    const pct = current[key]?.pct\n    return pct === undefined || pct === null ? '' : String(pct)\n  }\n  /**\n   * Shown under a typed rate this will NOT apply. Silence here would be the\n   * failure: `resolveFlatTaxCents` treats an out-of-range percentage as off,\n   * so a decimal-point typo would otherwise save cleanly and collect nothing.\n   */\n  const flatPctProblem = (key: 'lodging' | 'service'): string | null => {\n    const raw = current[key]?.pct\n    if (raw === undefined || raw === null || String(raw) === '') return null\n    if (Number(raw) === 0) return null\n    return CommerceModel.isUsableFlatTaxPct(raw)\n      ? null\n      : `Enter a percentage between 0 and ${CommerceModel.FLAT_TAX_MAX_PCT}. ` +\n          'This rate is not being applied.'\n  }\n\n  const handleSave = useCallback(async () => {\n    /**\n     * Refuse a save whose seed the server never confirmed (AGL-1358).\n     *\n     * No create path to exempt: this is a FIXED document path, so the\n     * `{mode: 'manual'}` default produced when the cache has never seen the\n     * map is not the harmless blank a fresh uid would be — writing it turns\n     * automatic tax calculation off on a store that had it on.\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: 'tax settings',\n        unreadable: storeStatus === 'error',\n        fromCache: storeFromCache,\n      },\n      async () => {\n        await setDoc(\n          doc(firestore, 'hosts', hostId, 'settings', 'store'),\n          { tax: current },\n          { merge: true },\n        )\n      },\n    )\n    // Before `setDraft(null)`, so a refusal keeps every typed rate on screen.\n    if (!verdict.ok) {\n      return void enqueueSnackbar(verdict.message, {\n        variant: 'warning',\n        persist: false,\n      })\n    }\n    setDraft(null)\n    enqueueSnackbar('Tax settings saved', { variant: 'success', persist: false })\n  }, [current, firestore, hostId, enqueueSnackbar, storeStatus, storeFromCache])\n\n  return (\n    <CardDisplay\n      header={'Taxes'}\n      help={pluginDocsHelp('commerce', { anchor: '#shipping--taxes' })}\n      contentGutterX\n      contentGutterY\n    >\n      <Stack spacing={1.5}>\n        {decided ? null : (\n          // The store is not selling. Saying so here is the whole point: the\n          // silent version of this state charged shoppers an untaxed total.\n          <Alert severity=\"warning\">\n            {'Choose how this store handles sales tax and save. Until you ' +\n              'do, checkout is turned off — we won’t take an order we can’t ' +\n              'tax correctly.'}\n          </Alert>\n        )}\n        <TextField\n          label=\"Calculation\"\n          value={current.mode ?? 'manual'}\n          onChange={(event) =>\n            update({\n              mode: event.target.value as 'manual' | 'stripe' | 'none',\n            })\n          }\n          size=\"small\"\n          select\n          sx={{ maxWidth: 280 }}\n        >\n          <MenuItem value=\"manual\">{'Manual rates (below)'}</MenuItem>\n          <MenuItem value=\"stripe\">{'Stripe Tax (automatic)'}</MenuItem>\n          {/* An explicit decision, not an omission (AGL-1999) — the option a\n              merchant under a nexus threshold, or selling non-taxable goods,\n              needs in order to sell at all. */}\n          <MenuItem value=\"none\">{'Don’t collect sales tax'}</MenuItem>\n        </TextField>\n        {current.mode === 'none' ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'This store adds no sales tax to any order. Orders still go ' +\n              'through — the decision is recorded, not the tax.'}\n          </Typography>\n        ) : current.mode === 'stripe' ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'Stripe Tax calculates per buyer location at checkout. ' +\n              'Activate Stripe Tax in your Stripe dashboard first.'}\n          </Typography>\n        ) : (\n          <>\n            <FormControlLabel\n              control={\n                <Switch\n                  size=\"small\"\n                  checked={Boolean(current.pricesIncludeTax)}\n                  onChange={(event) =>\n                    update({ pricesIncludeTax: event.target.checked })\n                  }\n                />\n              }\n              label=\"Prices include tax (VAT-style)\"\n            />\n            <Stack direction=\"row\" spacing={1}>\n              <TextField\n                label=\"Origin country\"\n                value={current.origin?.country ?? ''}\n                onChange={(event) =>\n                  update({\n                    origin: {\n                      ...current.origin,\n                      country: event.target.value.toUpperCase().slice(0, 2),\n                    },\n                  })\n                }\n                size=\"small\"\n                sx={{ width: 140 }}\n                placeholder=\"US\"\n              />\n              <TextField\n                label=\"Origin state\"\n                value={current.origin?.state ?? ''}\n                onChange={(event) =>\n                  update({\n                    origin: {\n                      ...current.origin,\n                      state: event.target.value.toUpperCase().slice(0, 3),\n                    },\n                  })\n                }\n                size=\"small\"\n                sx={{ width: 140 }}\n                placeholder=\"TX\"\n              />\n            </Stack>\n            {/* Which of the product's three addresses this is. A merchant\n                who reads an unlabeled origin as \"our address\" may set it\n                from the wrong one: the address the workspace pays Aglyn\n                from is a different jurisdiction question, and the payout\n                identity is a third. Naming the two it is NOT costs a line\n                and prevents a mis-taxed order. */}\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {'Where this store ships or sells FROM — the jurisdiction the ' +\n                'manual rates below are applied from. Not the address your ' +\n                'workspace is billed at by Aglyn, and not where your payouts ' +\n                'are sent.'}\n            </Typography>\n            {(current.rates ?? []).map((rate, index) => (\n              <Stack key={index} direction=\"row\" spacing={1}>\n                <TextField\n                  label=\"Country\"\n                  value={rate.country}\n                  onChange={(event) =>\n                    updateRate(index, {\n                      country: event.target.value.toUpperCase().slice(0, 2),\n                    })\n                  }\n                  size=\"small\"\n                  sx={{ width: 90 }}\n                />\n                <TextField\n                  label=\"State\"\n                  value={rate.state ?? ''}\n                  onChange={(event) =>\n                    updateRate(index, {\n                      state:\n                        event.target.value.toUpperCase().slice(0, 3) ||\n                        undefined,\n                    })\n                  }\n                  size=\"small\"\n                  sx={{ width: 80 }}\n                />\n                <TextField\n                  label=\"%\"\n                  value={rate.pct}\n                  onChange={(event) =>\n                    updateRate(index, { pct: Number(event.target.value) || 0 })\n                  }\n                  size=\"small\"\n                  sx={{ width: 80 }}\n                  slotProps={{ htmlInput: { inputMode: 'decimal' } }}\n                />\n                <TextField\n                  label=\"Label\"\n                  value={rate.label ?? ''}\n                  onChange={(event) =>\n                    updateRate(index, { label: event.target.value })\n                  }\n                  size=\"small\"\n                  sx={{ flex: 1 }}\n                  placeholder=\"Sales tax\"\n                />\n                <Button\n                  size=\"small\"\n                  color=\"error\"\n                  onClick={() => updateRate(index, null)}\n                >\n                  {'✕'}\n                </Button>\n              </Stack>\n            ))}\n            <Button\n              size=\"small\"\n              sx={{ alignSelf: 'flex-start' }}\n              onClick={() => updateRate(current.rates?.length ?? 0, {})}\n            >\n              {'Add rate'}\n            </Button>\n          </>\n        )}\n        {/*\n          LODGING TAX (AGL-1969) — deliberately OUTSIDE the calculation branch\n          above, and deliberately not a `rates[]` row.\n\n          The setting above is a goods SALES rate resolved against an address.\n          Occupancy tax is a different regime with its own rates, registration\n          and return, and it applies to reservations, which sell nights rather\n          than goods. Nesting it under \"Manual rates\" would have said the two\n          are the same machinery; putting it here says a store on Stripe Tax —\n          which cannot compute occupancy tax from these sessions at all — can\n          still set one.\n\n          It is off until the merchant fills it in, so nothing an existing\n          store charges moves.\n        */}\n        <Divider sx={{ my: 0.5 }} />\n        <Stack spacing={1}>\n          <Typography variant=\"subtitle2\">{'Lodging tax'}</Typography>\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'Charged on reservations, on top of the price, using the rate ' +\n              'you enter here. It is separate from the sales tax above ' +\n              'because occupancy tax is its own regime with its own rates ' +\n              'and its own return. Leave it blank to charge none — that is ' +\n              'the default.'}\n          </Typography>\n          <Stack direction=\"row\" spacing={1}>\n            <TextField\n              label=\"Rate %\"\n              value={flatPctText('lodging')}\n              onChange={(event) =>\n                updateFlat('lodging', {\n                  pct:\n                    event.target.value === ''\n                      ? undefined\n                      : Number(event.target.value),\n                })\n              }\n              size=\"small\"\n              sx={{ width: 110 }}\n              placeholder=\"0\"\n              error={Boolean(flatPctProblem('lodging'))}\n              helperText={flatPctProblem('lodging') ?? ' '}\n              slotProps={{ htmlInput: { inputMode: 'decimal' } }}\n            />\n            <TextField\n              label=\"Label\"\n              value={current.lodging?.label ?? ''}\n              onChange={(event) =>\n                updateFlat('lodging', { label: event.target.value })\n              }\n              size=\"small\"\n              sx={{ flex: 1 }}\n              placeholder=\"Occupancy tax\"\n              helperText=\"Shown to the guest on the receipt\"\n            />\n          </Stack>\n          {/*\n            MECHANISM ONLY, AND NO REMITTANCE DETERMINATION.\n\n            Whether a jurisdiction imposes occupancy tax, who must register for\n            it and who must remit it are legal conclusions that attach by\n            operation of law (AGL-1904/AGL-1956) and are the merchant's under\n            the Terms. This copy says what the software DOES and what it does\n            not do, and stops there — including the deposit basis, which is a\n            real limitation rather than an answer this product has taken.\n          */}\n          <Alert severity=\"info\">\n            {`${PLATFORM_BRAND_NAME} applies the rate you enter and records ` +\n              'what was charged. It does not determine whether this tax ' +\n              'applies to you, at what rate, or where it should be paid — ' +\n              'that is yours to decide.'}\n          </Alert>\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'On a reservation that takes a deposit, the rate is applied to ' +\n              'the deposit — the amount actually charged here — not to the ' +\n              'whole stay. If tax is due on the full stay, collect the ' +\n              'difference the same way you collect the rest of the balance.'}\n          </Typography>\n        </Stack>\n        {/*\n          SERVICE TAX (AGL-2028) — the bookings sibling of the block above,\n          and here for the same reason it is not in the bookings plugin's own\n          settings: this is the one card a merchant comes to with a tax\n          question, and a second tax surface elsewhere is how one of them ends\n          up unanswered.\n\n          Its EXISTENCE is also the opt-in AGL-2000 wanted. That issue\n          declined to apply the goods rate to an appointment partly because\n          nothing said the merchant meant these settings to cover bookings; a\n          field labelled for services, blank until they fill it in, is them\n          saying so.\n        */}\n        <Divider sx={{ my: 0.5 }} />\n        <Stack spacing={1}>\n          <Typography variant=\"subtitle2\">{'Service tax'}</Typography>\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'Charged on paid bookings, on top of the price, using the rate ' +\n              'you enter here. It is separate from the sales tax above ' +\n              'because whether a service is taxable is often a different ' +\n              'question from whether goods are. Leave it blank to charge ' +\n              'none — that is the default.'}\n          </Typography>\n          <Stack direction=\"row\" spacing={1}>\n            <TextField\n              label=\"Rate %\"\n              value={flatPctText('service')}\n              onChange={(event) =>\n                updateFlat('service', {\n                  pct:\n                    event.target.value === ''\n                      ? undefined\n                      : Number(event.target.value),\n                })\n              }\n              size=\"small\"\n              sx={{ width: 110 }}\n              placeholder=\"0\"\n              error={Boolean(flatPctProblem('service'))}\n              helperText={flatPctProblem('service') ?? ' '}\n              slotProps={{ htmlInput: { inputMode: 'decimal' } }}\n            />\n            <TextField\n              label=\"Label\"\n              value={current.service?.label ?? ''}\n              onChange={(event) =>\n                updateFlat('service', { label: event.target.value })\n              }\n              size=\"small\"\n              sx={{ flex: 1 }}\n              placeholder=\"Service tax\"\n              helperText=\"Shown to the client on the receipt\"\n            />\n          </Stack>\n          {/* MECHANISM ONLY, AND NO REMITTANCE DETERMINATION — see the\n              lodging block above. */}\n          <Alert severity=\"info\">\n            {`${PLATFORM_BRAND_NAME} applies the rate you enter and records ` +\n              'what was charged. It does not determine whether this tax ' +\n              'applies to you, at what rate, or where it should be paid — ' +\n              'that is yours to decide.'}\n          </Alert>\n        </Stack>\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 tax settings'}\n        </Button>\n      </Stack>\n    </CardDisplay>\n  )\n}\nTaxSettingsCard.displayName = 'TaxSettingsCard'\n\nexport default TaxSettingsCard\n"],"names":["CommerceModel","PLATFORM_BRAND_NAME","CardDisplay","useSnackbar","Alert","Button","Divider","FormControlLabel","MenuItem","Stack","Switch","TextField","Typography","doc","setDoc","useCallback","useState","useFirestore","useFirestoreDoc","writeGuardedBySeed","pluginDocsHelp","TaxSettingsCard","props","draft","current","flatPctProblem","store","hostId","firestore","enqueueSnackbar","data","status","storeStatus","fromCache","storeFromCache","setDraft","tax","mode","decided","update","patch","updateRate","index","rates","splice","country","pct","updateFlat","key","flatPctText","undefined","String","raw","Number","isUsableFlatTaxPct","FLAT_TAX_MAX_PCT","handleSave","verdict","subject","unreadable","merge","ok","message","variant","persist","header","help","anchor","contentGutterX","contentGutterY","spacing","severity","label","value","onChange","event","target","size","select","sx","maxWidth","color","control","checked","Boolean","pricesIncludeTax","direction","origin","toUpperCase","slice","width","placeholder","state","map","rate","slotProps","htmlInput","inputMode","flex","onClick","alignSelf","length","my","error","helperText","lodging","service","disabled","displayName"],"mappings":"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"}

package/src/lib/components/gate.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as Aglyn from '@aglyn/aglyn';
+import { type ReactNode } from 'react';
+export declare const ID: Aglyn.ComponentId;
+export interface GateProps {
+    /** Product id granting access; blank = any live subscription. */
+    productId?: string;
+    teaserText?: string;
+    ctaLabel?: string;
+    /** Where the CTA sends non-members (product or sign-in page). */
+    ctaHref?: string;
+    children?: ReactNode;
+}
+/**
+ * Content gate (AGL-309): renders children only for entitled members
+ * (purchase or live subscription, checked by the server-enforced gate
+ * API). Non-members see the teaser + CTA. Layout gating only — media
+ * that must stay secret should use the gated video block (AGL-315) or
+ * download links (AGL-302), which enforce on the server end-to-end.
+ */
+declare const Gate: import("react").ForwardRefExoticComponent<GateProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const schema: Aglyn.ComponentSchema<GateProps>;
+export declare const presets: Aglyn.PresetSchema[];
+export default Gate;