@aglyn/plugins-commerce 1.0.0-beta.230 → 1.0.0-beta.232

package/src/lib/components/console/payment-methods-card.component.js

@@ -0,0 +1,395 @@
+/**
+ * @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 { pluginDocsHelp } from "@aglyn/aglyn";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { Alert, Button, Chip, Divider, Stack, Switch, Typography } from "@mui/material";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { STOREFRONT_PAYMENT_METHODS } from "../../model/commerce-payment-methods.js";
+/**
+ * What a method's Stripe state means to the merchant, or null for nothing to
+ * say. Only an ON method gets a verdict: an off one is the merchant's choice.
+ */ export function capabilityVerdict(row, accountConnected) {
+    if (!row.on) return null;
+    if (!accountConnected) return {
+        label: 'Connect Stripe first',
+        color: 'default'
+    };
+    switch(row.capability){
+        case 'active':
+            return {
+                label: 'Ready',
+                color: 'success'
+            };
+        case 'pending':
+            return {
+                label: 'Stripe is reviewing',
+                color: 'warning'
+            };
+        case 'inactive':
+            return {
+                label: 'Stripe needs more details',
+                color: 'warning'
+            };
+        case 'unrequested':
+            return {
+                label: 'Save to request',
+                color: 'default'
+            };
+        default:
+            return null;
+    }
+}
+/** The domain chip: what Apple Pay can do on this name right now. */ export function domainVerdict(domain) {
+    if (domain.enabled && domain.status.applePay === 'active') {
+        return {
+            label: 'Apple Pay ready',
+            color: 'success'
+        };
+    }
+    if (domain.enabled) return {
+        label: 'Registered',
+        color: 'default'
+    };
+    if (domain.lastError) return {
+        label: 'Retrying',
+        color: 'warning'
+    };
+    return {
+        label: 'Registers on first checkout',
+        color: 'default'
+    };
+}
+/**
+ * The methods a merchant can see: everything the platform offers, and every
+ * method we could not ask Stripe about except crypto, which is shown only once
+ * the platform positively offers it (AGL-3629: hidden where unavailable).
+ */ export function visibleMethods(rows) {
+    return rows.map((row)=>({
+            row,
+            spec: STOREFRONT_PAYMENT_METHODS.find((method)=>method.id === row.id)
+        })).filter((entry)=>{
+        var _entry_spec;
+        return Boolean(entry.spec) && entry.row.platform !== 'unavailable' && !(entry.row.platform === null && ((_entry_spec = entry.spec) == null ? void 0 : _entry_spec.kind) === 'crypto');
+    });
+}
+/**
+ * Payment methods (AGL-3629): which wallets, buy-now-pay-later and crypto
+ * options the storefront offers, what each needs, and whether Stripe is ready
+ * for it. Cards are always on and are not listed.
+ *
+ * Read and saved through `/api/commerce/payment-methods` rather than a
+ * Firestore listen, because two of the three facts per row — what the
+ * platform offers and the payout account's capability — live at Stripe, and a
+ * save is a Stripe request as well as a settings write.
+ */ export function PaymentMethodsCard(props) {
+    const { hostId } = props;
+    const { data: user } = useUser();
+    const { enqueueSnackbar } = useSnackbar();
+    const [view, setView] = useState(null);
+    const [state, setState] = useState('loading');
+    const [draft, setDraft] = useState({});
+    const [saving, setSaving] = useState(false);
+    const [nonce, setNonce] = useState(0);
+    // The load keys on the uid, not the user object: a refreshed token hands
+    // back a new object, and reloading on it would throw away unsaved toggles.
+    const userRef = useRef(user);
+    userRef.current = user;
+    const uid = user == null ? void 0 : user.uid;
+    useEffect(()=>{
+        const user = userRef.current;
+        if (!uid || !user || !hostId) return;
+        let cancelled = false;
+        setState('loading');
+        void (async ()=>{
+            try {
+                const response = await authorizedFetch(user, `/api/commerce/payment-methods?hostId=${encodeURIComponent(hostId)}`);
+                if (cancelled) return;
+                if (response.status === 501) return void setState('unconfigured');
+                if (!response.ok) return void setState('error');
+                const payload = await response.json();
+                if (cancelled) return;
+                setView(payload);
+                setDraft({});
+                setState('loaded');
+            } catch (unused) {
+                if (!cancelled) setState('error');
+            }
+        })();
+        return ()=>{
+            cancelled = true;
+        };
+    }, [
+        uid,
+        hostId,
+        nonce
+    ]);
+    const dirty = Object.keys(draft).length > 0;
+    const handleSave = useCallback(async ()=>{
+        if (!dirty) return;
+        setSaving(true);
+        try {
+            const response = await authorizedFetch(user, '/api/commerce/payment-methods', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    hostId,
+                    methods: draft
+                })
+            });
+            const payload = await response.json().catch(()=>({}));
+            if (!response.ok) {
+                var _ref;
+                return void enqueueSnackbar((_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'Payment methods were not saved', {
+                    variant: 'error',
+                    allowDuplicate: true
+                });
+            }
+            setView(payload);
+            setDraft({});
+            enqueueSnackbar('Payment methods saved', {
+                variant: 'success',
+                persist: false
+            });
+        } catch (unused) {
+            enqueueSnackbar('Payment methods were not saved', {
+                variant: 'error',
+                allowDuplicate: true
+            });
+        } finally{
+            setSaving(false);
+        }
+    }, [
+        dirty,
+        draft,
+        enqueueSnackbar,
+        hostId,
+        user
+    ]);
+    const handleFinish = useCallback(async ()=>{
+        setSaving(true);
+        try {
+            var _ref;
+            const response = await authorizedFetch(user, '/api/commerce/payment-methods', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    hostId,
+                    action: 'finish'
+                })
+            });
+            const payload = await response.json().catch(()=>({}));
+            if (response.ok && typeof (payload == null ? void 0 : payload.url) === 'string') {
+                return void window.location.assign(payload.url);
+            }
+            enqueueSnackbar((_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'Stripe could not be opened', {
+                variant: 'error',
+                allowDuplicate: true
+            });
+        } catch (unused) {
+            enqueueSnackbar('Stripe could not be opened', {
+                variant: 'error',
+                allowDuplicate: true
+            });
+        } finally{
+            setSaving(false);
+        }
+    }, [
+        enqueueSnackbar,
+        hostId,
+        user
+    ]);
+    const rows = view ? visibleMethods(view.methods) : [];
+    const canEdit = (view == null ? void 0 : view.canEdit) !== false;
+    const canFinish = (view == null ? void 0 : view.canFinish) !== false;
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: 'Payment methods',
+        help: pluginDocsHelp('commerce', {
+            anchor: '#payment-methods'
+        }),
+        HeaderProps: {
+            action: state === 'loaded' && canEdit ? /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                variant: "contained",
+                disabled: !dirty || saving,
+                onClick: handleSave,
+                children: saving ? 'Saving…' : 'Save'
+            }) : null
+        },
+        contentGutterX: true,
+        contentGutterY: true,
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 1.5,
+            "data-testid": "payment-methods-card",
+            children: [
+                state === 'loading' ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "text.secondary",
+                    children: 'Checking your payment methods…'
+                }) : null,
+                state === 'unconfigured' ? /*#__PURE__*/ _jsx(Alert, {
+                    severity: "info",
+                    children: 'Payments are not configured on this deployment.'
+                }) : null,
+                state === 'error' ? /*#__PURE__*/ _jsx(Alert, {
+                    severity: "error",
+                    action: /*#__PURE__*/ _jsx(Button, {
+                        color: "inherit",
+                        size: "small",
+                        onClick: ()=>setNonce((n)=>n + 1),
+                        children: 'Retry'
+                    }),
+                    children: 'We couldn’t load your payment methods. Nothing has changed — ' + 'shoppers still see what they saw before.'
+                }) : null,
+                state === 'loaded' && view ? /*#__PURE__*/ _jsxs(_Fragment, {
+                    children: [
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'Cards are always on. Turn off anything you don’t want to offer. ' + 'Stripe shows each method only on orders and to shoppers it suits, ' + 'using the limits below.'
+                        }),
+                        canEdit ? null : /*#__PURE__*/ _jsx(Alert, {
+                            severity: "info",
+                            children: 'Only a site admin can change which payment methods your store offers.'
+                        }),
+                        view.warnings.map((warning)=>/*#__PURE__*/ _jsx(Alert, {
+                                severity: "warning",
+                                children: warning
+                            }, warning)),
+                        rows.map(({ row, spec })=>{
+                            var _draft_row_id;
+                            const on = (_draft_row_id = draft[row.id]) != null ? _draft_row_id : row.on;
+                            const verdict = capabilityVerdict(_extends({}, row, {
+                                on
+                            }), view.accountConnected);
+                            return /*#__PURE__*/ _jsxs(Stack, {
+                                spacing: 0.5,
+                                "data-testid": `payment-method-${row.id}`,
+                                children: [
+                                    /*#__PURE__*/ _jsxs(Stack, {
+                                        direction: "row",
+                                        spacing: 1,
+                                        sx: {
+                                            alignItems: 'center'
+                                        },
+                                        children: [
+                                            /*#__PURE__*/ _jsx(Switch, {
+                                                checked: on,
+                                                disabled: !canEdit || saving,
+                                                onChange: (event)=>{
+                                                    const next = event.target.checked;
+                                                    setDraft((current)=>{
+                                                        const copy = _extends({}, current);
+                                                        if (next === row.on) delete copy[row.id];
+                                                        else copy[row.id] = next;
+                                                        return copy;
+                                                    });
+                                                },
+                                                slotProps: {
+                                                    input: {
+                                                        'aria-label': spec.label
+                                                    }
+                                                }
+                                            }),
+                                            /*#__PURE__*/ _jsx(Typography, {
+                                                variant: "subtitle2",
+                                                sx: {
+                                                    flex: 1
+                                                },
+                                                children: spec.label
+                                            }),
+                                            spec.capability && verdict ? /*#__PURE__*/ _jsx(Chip, {
+                                                size: "small",
+                                                variant: "outlined",
+                                                label: verdict.label,
+                                                color: verdict.color
+                                            }) : null,
+                                            on && row.capability === 'inactive' && canFinish ? /*#__PURE__*/ _jsx(Button, {
+                                                size: "small",
+                                                disabled: saving,
+                                                onClick: handleFinish,
+                                                children: 'Finish in Stripe'
+                                            }) : null
+                                        ]
+                                    }),
+                                    /*#__PURE__*/ _jsx(Typography, {
+                                        variant: "body2",
+                                        color: "text.secondary",
+                                        children: spec.requirements
+                                    }),
+                                    /*#__PURE__*/ _jsx(Typography, {
+                                        variant: "caption",
+                                        color: "text.secondary",
+                                        children: spec.limits
+                                    })
+                                ]
+                            }, row.id);
+                        }),
+                        /*#__PURE__*/ _jsx(Divider, {}),
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "subtitle2",
+                            children: 'Wallet domains'
+                        }),
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'Apple Pay shows only on a domain registered with Stripe. Your ' + 'site’s domains are registered for you when you connect them and ' + 'on the first in-page checkout.'
+                        }),
+                        view.domains.map((domain)=>{
+                            const verdict = domainVerdict(domain);
+                            return /*#__PURE__*/ _jsxs(Stack, {
+                                direction: "row",
+                                spacing: 1,
+                                sx: {
+                                    alignItems: 'center'
+                                },
+                                "data-testid": `payment-domain-${domain.domain}`,
+                                children: [
+                                    /*#__PURE__*/ _jsx(Typography, {
+                                        variant: "body2",
+                                        sx: {
+                                            flex: 1
+                                        },
+                                        children: domain.domain
+                                    }),
+                                    /*#__PURE__*/ _jsx(Chip, {
+                                        size: "small",
+                                        variant: "outlined",
+                                        label: verdict.label,
+                                        color: verdict.color
+                                    })
+                                ]
+                            }, domain.domain);
+                        })
+                    ]
+                }) : null
+            ]
+        })
+    });
+}
+PaymentMethodsCard.displayName = 'PaymentMethodsCard';
+export default PaymentMethodsCard;
+
+//# sourceMappingURL=payment-methods-card.component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/payment-methods-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 { pluginDocsHelp } from '@aglyn/aglyn'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport {\n  Alert,\n  Button,\n  Chip,\n  Divider,\n  Stack,\n  Switch,\n  Typography,\n} from '@mui/material'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport {\n  STOREFRONT_PAYMENT_METHODS,\n  type StorefrontPaymentMethodId,\n  type StorefrontPaymentMethodSettings,\n  type StorefrontPaymentMethodSpec,\n} from '../../model/commerce-payment-methods'\n\nexport interface PaymentMethodsCardProps {\n  hostId: string\n}\n\n/** One method as the route reports it (`server/payment-methods.ts`). */\nexport interface PaymentMethodRowView {\n  id: StorefrontPaymentMethodId\n  on: boolean\n  platform: 'on' | 'unavailable' | null\n  capability: 'active' | 'pending' | 'inactive' | 'unrequested' | null\n}\n\nexport interface PaymentMethodDomainView {\n  domain: string\n  enabled: boolean\n  stripeId: string | null\n  status: { applePay: string | null; googlePay: string | null }\n  lastError: string | null\n}\n\nexport interface PaymentMethodsView {\n  methods: PaymentMethodRowView[]\n  domains: PaymentMethodDomainView[]\n  accountConnected: boolean\n  /** Absent from an older answer: read as allowed, and the route still judges. */\n  canEdit?: boolean\n  canFinish?: boolean\n  warnings: string[]\n}\n\n/**\n * What a method's Stripe state means to the merchant, or null for nothing to\n * say. Only an ON method gets a verdict: an off one is the merchant's choice.\n */\nexport function capabilityVerdict(\n  row: PaymentMethodRowView,\n  accountConnected: boolean,\n): { label: string; color: 'success' | 'warning' | 'default' } | null {\n  if (!row.on) return null\n  if (!accountConnected) return { label: 'Connect Stripe first', color: 'default' }\n  switch (row.capability) {\n    case 'active':\n      return { label: 'Ready', color: 'success' }\n    case 'pending':\n      return { label: 'Stripe is reviewing', color: 'warning' }\n    case 'inactive':\n      return { label: 'Stripe needs more details', color: 'warning' }\n    case 'unrequested':\n      return { label: 'Save to request', color: 'default' }\n    default:\n      return null\n  }\n}\n\n/** The domain chip: what Apple Pay can do on this name right now. */\nexport function domainVerdict(domain: PaymentMethodDomainView): {\n  label: string\n  color: 'success' | 'warning' | 'default'\n} {\n  if (domain.enabled && domain.status.applePay === 'active') {\n    return { label: 'Apple Pay ready', color: 'success' }\n  }\n  if (domain.enabled) return { label: 'Registered', color: 'default' }\n  if (domain.lastError) return { label: 'Retrying', color: 'warning' }\n  return { label: 'Registers on first checkout', color: 'default' }\n}\n\n/**\n * The methods a merchant can see: everything the platform offers, and every\n * method we could not ask Stripe about except crypto, which is shown only once\n * the platform positively offers it (AGL-3629: hidden where unavailable).\n */\nexport function visibleMethods(\n  rows: readonly PaymentMethodRowView[],\n): Array<{ row: PaymentMethodRowView; spec: StorefrontPaymentMethodSpec }> {\n  return rows\n    .map((row) => ({\n      row,\n      spec: STOREFRONT_PAYMENT_METHODS.find((method) => method.id === row.id),\n    }))\n    .filter(\n      (entry): entry is { row: PaymentMethodRowView; spec: StorefrontPaymentMethodSpec } =>\n        Boolean(entry.spec) &&\n        entry.row.platform !== 'unavailable' &&\n        !(entry.row.platform === null && entry.spec?.kind === 'crypto'),\n    )\n}\n\n/**\n * Payment methods (AGL-3629): which wallets, buy-now-pay-later and crypto\n * options the storefront offers, what each needs, and whether Stripe is ready\n * for it. Cards are always on and are not listed.\n *\n * Read and saved through `/api/commerce/payment-methods` rather than a\n * Firestore listen, because two of the three facts per row — what the\n * platform offers and the payout account's capability — live at Stripe, and a\n * save is a Stripe request as well as a settings write.\n */\nexport function PaymentMethodsCard(props: PaymentMethodsCardProps) {\n  const { hostId } = props\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const [view, setView] = useState<PaymentMethodsView | null>(null)\n  const [state, setState] = useState<'loading' | 'loaded' | 'error' | 'unconfigured'>(\n    'loading',\n  )\n  const [draft, setDraft] = useState<StorefrontPaymentMethodSettings>({})\n  const [saving, setSaving] = useState(false)\n  const [nonce, setNonce] = useState(0)\n  // The load keys on the uid, not the user object: a refreshed token hands\n  // back a new object, and reloading on it would throw away unsaved toggles.\n  const userRef = useRef(user)\n  userRef.current = user\n  const uid = user?.uid\n\n  useEffect(() => {\n    const user = userRef.current\n    if (!uid || !user || !hostId) return\n    let cancelled = false\n    setState('loading')\n    void (async () => {\n      try {\n        const response = await authorizedFetch(\n          user,\n          `/api/commerce/payment-methods?hostId=${encodeURIComponent(hostId)}`,\n        )\n        if (cancelled) return\n        if (response.status === 501) return void setState('unconfigured')\n        if (!response.ok) return void setState('error')\n        const payload = (await response.json()) as PaymentMethodsView\n        if (cancelled) return\n        setView(payload)\n        setDraft({})\n        setState('loaded')\n      } catch {\n        if (!cancelled) setState('error')\n      }\n    })()\n    return () => {\n      cancelled = true\n    }\n  }, [uid, hostId, nonce])\n\n  const dirty = Object.keys(draft).length > 0\n\n  const handleSave = useCallback(async () => {\n    if (!dirty) return\n    setSaving(true)\n    try {\n      const response = await authorizedFetch(user, '/api/commerce/payment-methods', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ hostId, methods: draft }),\n      })\n      const payload = await response.json().catch(() => ({}))\n      if (!response.ok) {\n        return void enqueueSnackbar(payload?.error ?? 'Payment methods were not saved', {\n          variant: 'error',\n          allowDuplicate: true,\n        })\n      }\n      setView(payload as PaymentMethodsView)\n      setDraft({})\n      enqueueSnackbar('Payment methods saved', { variant: 'success', persist: false })\n    } catch {\n      enqueueSnackbar('Payment methods were not saved', {\n        variant: 'error',\n        allowDuplicate: true,\n      })\n    } finally {\n      setSaving(false)\n    }\n  }, [dirty, draft, enqueueSnackbar, hostId, user])\n\n  const handleFinish = useCallback(async () => {\n    setSaving(true)\n    try {\n      const response = await authorizedFetch(user, '/api/commerce/payment-methods', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ hostId, action: 'finish' }),\n      })\n      const payload = await response.json().catch(() => ({}))\n      if (response.ok && typeof payload?.url === 'string') {\n        return void window.location.assign(payload.url)\n      }\n      enqueueSnackbar(payload?.error ?? 'Stripe could not be opened', {\n        variant: 'error',\n        allowDuplicate: true,\n      })\n    } catch {\n      enqueueSnackbar('Stripe could not be opened', { variant: 'error', allowDuplicate: true })\n    } finally {\n      setSaving(false)\n    }\n  }, [enqueueSnackbar, hostId, user])\n\n  const rows = view ? visibleMethods(view.methods) : []\n  const canEdit = view?.canEdit !== false\n  const canFinish = view?.canFinish !== false\n\n  return (\n    <CardDisplay\n      header={'Payment methods'}\n      help={pluginDocsHelp('commerce', { anchor: '#payment-methods' })}\n      HeaderProps={{\n        action:\n          state === 'loaded' && canEdit ? (\n            <Button\n              size=\"small\"\n              variant=\"contained\"\n              disabled={!dirty || saving}\n              onClick={handleSave}\n            >\n              {saving ? 'Saving…' : 'Save'}\n            </Button>\n          ) : null,\n      }}\n      contentGutterX\n      contentGutterY\n    >\n      <Stack spacing={1.5} data-testid=\"payment-methods-card\">\n        {state === 'loading' ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'Checking your payment methods…'}\n          </Typography>\n        ) : null}\n        {state === 'unconfigured' ? (\n          <Alert severity=\"info\">{'Payments are not configured on this deployment.'}</Alert>\n        ) : null}\n        {state === 'error' ? (\n          <Alert\n            severity=\"error\"\n            action={\n              <Button color=\"inherit\" size=\"small\" onClick={() => setNonce((n) => n + 1)}>\n                {'Retry'}\n              </Button>\n            }\n          >\n            {'We couldn’t load your payment methods. Nothing has changed — ' +\n              'shoppers still see what they saw before.'}\n          </Alert>\n        ) : null}\n        {state === 'loaded' && view ? (\n          <>\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {'Cards are always on. Turn off anything you don’t want to offer. ' +\n                'Stripe shows each method only on orders and to shoppers it suits, ' +\n                'using the limits below.'}\n            </Typography>\n            {canEdit ? null : (\n              <Alert severity=\"info\">\n                {'Only a site admin can change which payment methods your store offers.'}\n              </Alert>\n            )}\n            {view.warnings.map((warning) => (\n              <Alert key={warning} severity=\"warning\">\n                {warning}\n              </Alert>\n            ))}\n            {rows.map(({ row, spec }) => {\n              const on = draft[row.id] ?? row.on\n              const verdict = capabilityVerdict({ ...row, on }, view.accountConnected)\n              return (\n                <Stack key={row.id} spacing={0.5} data-testid={`payment-method-${row.id}`}>\n                  <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n                    <Switch\n                      checked={on}\n                      disabled={!canEdit || saving}\n                      onChange={(event) => {\n                        const next = event.target.checked\n                        setDraft((current) => {\n                          const copy = { ...current }\n                          if (next === row.on) delete copy[row.id]\n                          else copy[row.id] = next\n                          return copy\n                        })\n                      }}\n                      slotProps={{ input: { 'aria-label': spec.label } }}\n                    />\n                    <Typography variant=\"subtitle2\" sx={{ flex: 1 }}>\n                      {spec.label}\n                    </Typography>\n                    {spec.capability && verdict ? (\n                      <Chip size=\"small\" variant=\"outlined\" label={verdict.label} color={verdict.color} />\n                    ) : null}\n                    {on && row.capability === 'inactive' && canFinish ? (\n                      <Button size=\"small\" disabled={saving} onClick={handleFinish}>\n                        {'Finish in Stripe'}\n                      </Button>\n                    ) : null}\n                  </Stack>\n                  <Typography variant=\"body2\" color=\"text.secondary\">\n                    {spec.requirements}\n                  </Typography>\n                  <Typography variant=\"caption\" color=\"text.secondary\">\n                    {spec.limits}\n                  </Typography>\n                </Stack>\n              )\n            })}\n            <Divider />\n            <Typography variant=\"subtitle2\">{'Wallet domains'}</Typography>\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {'Apple Pay shows only on a domain registered with Stripe. Your ' +\n                'site’s domains are registered for you when you connect them and ' +\n                'on the first in-page checkout.'}\n            </Typography>\n            {view.domains.map((domain) => {\n              const verdict = domainVerdict(domain)\n              return (\n                <Stack\n                  key={domain.domain}\n                  direction=\"row\"\n                  spacing={1}\n                  sx={{ alignItems: 'center' }}\n                  data-testid={`payment-domain-${domain.domain}`}\n                >\n                  <Typography variant=\"body2\" sx={{ flex: 1 }}>\n                    {domain.domain}\n                  </Typography>\n                  <Chip size=\"small\" variant=\"outlined\" label={verdict.label} color={verdict.color} />\n                </Stack>\n              )\n            })}\n          </>\n        ) : null}\n      </Stack>\n    </CardDisplay>\n  )\n}\nPaymentMethodsCard.displayName = 'PaymentMethodsCard'\n\nexport default PaymentMethodsCard\n"],"names":["pluginDocsHelp","CardDisplay","useSnackbar","authorizedFetch","useUser","Alert","Button","Chip","Divider","Stack","Switch","Typography","useCallback","useEffect","useRef","useState","STOREFRONT_PAYMENT_METHODS","capabilityVerdict","row","accountConnected","on","label","color","capability","domainVerdict","domain","enabled","status","applePay","lastError","visibleMethods","rows","map","spec","find","method","id","filter","entry","Boolean","platform","kind","PaymentMethodsCard","props","hostId","data","user","enqueueSnackbar","view","setView","state","setState","draft","setDraft","saving","setSaving","nonce","setNonce","userRef","current","uid","cancelled","response","encodeURIComponent","ok","payload","json","dirty","Object","keys","length","handleSave","headers","body","JSON","stringify","methods","catch","error","variant","allowDuplicate","persist","handleFinish","action","url","window","location","assign","canEdit","canFinish","header","help","anchor","HeaderProps","size","disabled","onClick","contentGutterX","contentGutterY","spacing","data-testid","severity","n","warnings","warning","verdict","direction","sx","alignItems","checked","onChange","event","next","target","copy","slotProps","input","flex","requirements","limits","domains","displayName"],"mappings":"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"}

package/src/lib/components/console/pos/pos-api.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @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 { authorizedFetch } from '@aglyn/shared-util-http/authorized-token';
+import type * as CommerceModel from '../../../model';
+import type { PosRegisterSettings } from '../../../plugin-config';
+/**
+ * The register's client half (AGL-3607): one place that knows the routes, so
+ * the components ask "take cash" rather than building requests. Every call
+ * that starts a payment carries the attempt key it is given; the server
+ * derives the payment from it, so a retried press finds the same payment.
+ */
+/** The open sale as the server reports it after every change. */
+export interface PosSaleSummary {
+    orderId: string;
+    status: string;
+    totalCents: number;
+    paidCents: number;
+    dueCents: number;
+    tenderableCents: number;
+    tipCents: number;
+    payments: Array<{
+        id: string;
+        method: CommerceModel.OrderPaymentMethod;
+        amountCents: number;
+        tipCents?: number;
+        status: CommerceModel.OrderPaymentStatus;
+        cardBrand?: string;
+        last4?: string;
+        changeCents?: number;
+        checkoutUrl?: string;
+        readerId?: string;
+        failureMessage?: string;
+        livemode?: boolean;
+    }>;
+}
+export interface PosTenderResult {
+    sale: PosSaleSummary;
+    paymentId?: string;
+    completed: boolean;
+    clientSecret?: string;
+    paymentIntentId?: string;
+}
+export interface PosRegisterContext {
+    settings: PosRegisterSettings;
+    terminal: {
+        available: boolean;
+        testMode: boolean;
+    };
+    readers: Array<{
+        id: string;
+        label: string;
+        registerId: string | null;
+        status: string;
+        livemode: boolean;
+    }>;
+    publishableKey: string;
+    smsReceipts: boolean;
+}
+type User = Parameters<typeof authorizedFetch>[0];
+export declare class PosRequestError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+/** A fresh attempt key, for one press of one tender. */
+export declare function newAttemptKey(): string;
+export declare function posRegisterContext(user: User, hostId: string): Promise<PosRegisterContext>;
+/** Prices the basket on the server and opens a sale with an empty ledger. */
+export declare function openPosSale(user: User, attemptKey: string, body: {
+    hostId: string;
+    registerId: string;
+    lines: unknown[];
+    discountPct: number;
+    customerEmail?: string;
+    /** The person the register's customer lookup attached (AGL-3609). */
+    customer?: unknown;
+    /** A PIN-switched cashier's signed assertion (AGL-3609). */
+    cashierAssertion?: string;
+    locationId?: string;
+}): Promise<{
+    orderId: string;
+    totals: CommerceModel.OrderTotals;
+    dueCents: number;
+    stockWarnings?: unknown[];
+}>;
+export type PosTenderAction = 'cash' | 'gift-card' | 'folio' | 'card-present' | 'card-present-sdk' | 'card-keyed' | 'card-link' | 'status' | 'cancel' | 'retry' | 'simulate' | 'void' | 'receipt';
+export declare function posTender(user: User, hostId: string, orderId: string, action: PosTenderAction, body?: Record<string, unknown>, attemptKey?: string): Promise<PosTenderResult>;
+export declare function posGiftCardBalance(user: User, hostId: string, code: string): Promise<{
+    availableCents: number;
+    frozen: boolean;
+    voided: boolean;
+    last4: string;
+}>;
+export declare function posDisplayCall<T = any>(user: User, body: Record<string, unknown>, method?: 'GET' | 'POST'): Promise<T>;
+export declare function posReadersCall<T = any>(user: User, body: Record<string, unknown>): Promise<T>;
+/** Cents as the register shows them. */
+export declare const usd: (cents: number) => string;
+/** A dollar string the cashier typed, as whole cents (NaN-safe, never negative). */
+export declare function centsFromInput(value: string): number;
+export interface AglynPosBridge {
+    collectCardPayment(input: {
+        paymentIntentId: string;
+        clientSecret: string;
+        amountCents: number;
+    }): Promise<{
+        status: 'collected' | 'canceled' | 'failed';
+        message?: string;
+    }>;
+}
+export declare function posNativeBridge(): AglynPosBridge | null;
+export {};