@aglyn/plugins-commerce 1.0.0-beta.143

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

@@ -0,0 +1,295 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { trackEvent } from "@aglyn/aglyn/app-utils/analytics-events";
+import * as Aglyn from "@aglyn/aglyn";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { Alert, Button, Chip, Stack, Typography } from "@mui/material";
+import { doc } from "firebase/firestore";
+import { useCallback, useState } from "react";
+import { useFirestore, useUser } from "@aglyn/tenant-feature-instance";
+import { useFirestoreDoc } from "@aglyn/tenant-feature-instance";
+import { useOrgPlan } from "@aglyn/tenant-feature-instance";
+import { pluginDocsHelp } from "@aglyn/aglyn";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+/**
+ * Merchant payments card (AGL-284): Stripe Connect Express onboarding
+ * status for the org owner + the plan's transaction-fee ladder so the
+ * "upgrade to kill fees" motion (AGL-278) is visible where it matters.
+ */ export function PaymentsSettingsCard(props) {
+    var _profile_lastPayoutFailureCents, _profile_lastPayoutFailureReason;
+    const { hostId } = props;
+    const firestore = useFirestore();
+    const { data: user } = useUser();
+    const { enqueueSnackbar } = useSnackbar();
+    const [busy, setBusy] = useState(false);
+    /**
+   * A one-time Stripe Express dashboard link, minted by the connect route on
+   * request. Not persisted: login links are single-use and short-lived, so a
+   * stored one would be a button that fails the second time it is pressed.
+   */ const [dashboardUrl, setDashboardUrl] = useState(null);
+    const { org, ready: planReady } = useOrgPlan(hostId);
+    /** Bumped by Retry to re-subscribe the profile listen (AGL-1380). */ const [retryNonce, setRetryNonce] = useState(0);
+    const uid = user == null ? void 0 : user.uid;
+    const { data: profile, status: profileStatus } = useFirestoreDoc(// Held at null rather than addressed as `profiles/-pending-` — that
+    // sentinel issued a guaranteed-denied read on every pre-auth mount, and
+    // a denial lands in `status: 'error'`, which now means something.
+    ()=>uid ? doc(firestore, 'profiles', uid) : null, [
+        firestore,
+        uid,
+        retryNonce
+    ]);
+    const isOwner = Boolean((org == null ? void 0 : org.ownerUid) && (user == null ? void 0 : user.uid) === org.ownerUid);
+    /**
+   * Three outcomes, not two (AGL-1380). An absent profile doc is the value
+   * BEFORE an answer as much as it is the value of a merchant who never
+   * connected Stripe, so "Not set up" off a falsy `stripeChargesEnabled` is a
+   * claim about this org's payment setup made without having heard back. It
+   * is wrong in the direction that provokes action: the same falsy value
+   * turns the button into "Set up payments", which sends a merchant who is
+   * already taking money into Stripe onboarding.
+   */ const stripeState = !uid || profileStatus === 'loading' ? 'pending' : profileStatus === 'error' ? 'error' : 'loaded';
+    /**
+   * WHICH STRIPE WORLD THE STORED ACCOUNT BELONGS TO (AGL-2471).
+   *
+   * `stripeChargesEnabled: true` was the whole readiness claim, and a
+   * production profile carrying it named a TEST-mode account: this card said
+   * "Charges enabled" about three storefronts that could not take a single
+   * payment. Only a literal boolean counts as recorded — the same
+   * three-valued reading `connectLinkageIsReady` uses on the server, so the
+   * chip and the checkout cannot disagree.
+   */ const modeVerified = typeof (profile == null ? void 0 : profile.stripeAccountLivemode) === 'boolean';
+    const chargesConnected = stripeState === 'loaded' && Boolean(profile == null ? void 0 : profile.stripeChargesEnabled);
+    const modeUnverified = chargesConnected && !modeVerified;
+    const chargesEnabled = chargesConnected && modeVerified;
+    const physicalPct = Aglyn.resolveTransactionFeePct(org, 'physical');
+    const digitalPct = Aglyn.resolveTransactionFeePct(org, 'digital');
+    const commerceEnabled = Aglyn.checkEntitlement(org, 'commerce');
+    const handleConnect = useCallback(async ()=>{
+        setBusy(true);
+        try {
+            const response = await authorizedFetch(user, '/api/commerce/connect', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    hostId
+                })
+            });
+            const payload = await response.json();
+            if (response.status === 501) {
+                return void enqueueSnackbar('Payments are not configured on this deployment', {
+                    variant: 'info',
+                    persist: false
+                });
+            }
+            if (!response.ok) {
+                var _ref;
+                return void enqueueSnackbar((_ref = payload == null ? void 0 : payload.error) != null ? _ref : 'Payment setup failed', {
+                    variant: 'error',
+                    allowDuplicate: true
+                });
+            }
+            if (payload.chargesEnabled) {
+                // "% who connect Stripe" — a GTM plan §6 activation metric
+                // (AGL-1561). Gated on the TRANSITION, not the state: this handler
+                // is a re-entrant create-or-resume, so it answers `chargesEnabled:
+                // true` on every subsequent visit to a connected account, and a bare
+                // event here would count one merchant once per click forever.
+                // `chargesEnabled` is the state read from the profile BEFORE this
+                // request, so the event fires only when onboarding actually completed.
+                if (!chargesEnabled) trackEvent('stripe_connected', {});
+                // CHARGES AND PAYOUTS ARE TWO FLAGS, AND ONLY ONE OF THEM IS THIS
+                // SENTENCE (AGL-1997). `chargesEnabled` says Stripe will let the
+                // account take money; whether the money can LEAVE is `payoutsEnabled`,
+                // which the route answers alongside it. Charges-yes/payouts-no is an
+                // ordinary Stripe state — verification pending or lapsed, no payout
+                // method — and announcing "Payments are enabled" in it is false in the
+                // direction that costs the merchant: they sell believing they are
+                // paid, and the funds sit in a Connect account that cannot release
+                // them. Read three-valued, so only a literal `false` from Stripe
+                // downgrades the claim; an absent flag means unasked, not off.
+                const payoutsBlocked = payload.payoutsEnabled === false;
+                // A WARNING THAT NAMES A PROBLEM MUST OFFER THE FIX.
+                //
+                // Stripe is the only place payouts can be released — an Express
+                // account has no password and no direct login — so telling the
+                // merchant their funds are stranded and then keeping them here is half
+                // an answer. The route now mints the remediation link for exactly this
+                // state; going there is the whole point of pressing the button.
+                if (payoutsBlocked && payload.url) {
+                    return void window.location.assign(payload.url);
+                }
+                // Payouts are flowing, so the link is the Express dashboard: balance,
+                // payout schedule, and the reason a payout failed. Held in state
+                // rather than followed, because this click was a status check and
+                // navigating away from one nobody asked to leave is its own defect.
+                if (!payoutsBlocked && typeof payload.dashboardUrl === 'string') {
+                    setDashboardUrl(payload.dashboardUrl);
+                }
+                return void enqueueSnackbar(payoutsBlocked ? 'Connected — payouts are not released yet' : 'Payments are enabled', {
+                    variant: payoutsBlocked ? 'warning' : 'success',
+                    persist: false
+                });
+            }
+            if (payload.url) window.location.assign(payload.url);
+        } catch (error) {
+            console.error(error);
+            enqueueSnackbar('An error has occurred', {
+                variant: 'error',
+                allowDuplicate: true
+            });
+        } finally{
+            setBusy(false);
+        }
+    }, [
+        user,
+        hostId,
+        chargesEnabled,
+        enqueueSnackbar
+    ]);
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: 'Payments',
+        help: pluginDocsHelp('commerceEndToEnd', {
+            anchor: '#1-connect-payments'
+        }),
+        contentGutterX: true,
+        contentGutterY: true,
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 1.5,
+            children: [
+                /*#__PURE__*/ _jsxs(Stack, {
+                    direction: "row",
+                    spacing: 1,
+                    sx: {
+                        alignItems: 'center'
+                    },
+                    children: [
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            sx: {
+                                flex: 1
+                            },
+                            children: 'Stripe account'
+                        }),
+                        stripeState === 'error' ? null : /*#__PURE__*/ _jsx(Chip, {
+                            size: "small",
+                            label: stripeState === 'pending' ? 'Checking…' : chargesEnabled ? 'Charges enabled' : modeUnverified ? 'Not verified' : 'Not set up',
+                            color: stripeState === 'pending' ? 'default' : chargesEnabled ? 'success' : modeUnverified ? 'error' : 'warning',
+                            variant: "outlined"
+                        })
+                    ]
+                }),
+                stripeState === 'error' ? /*#__PURE__*/ _jsx(Alert, {
+                    severity: "error",
+                    action: /*#__PURE__*/ _jsx(Button, {
+                        color: "inherit",
+                        size: "small",
+                        onClick: ()=>setRetryNonce((n)=>n + 1),
+                        children: 'Retry'
+                    }),
+                    children: 'We couldn’t load your payment setup. This says nothing about ' + 'whether payments are on — we could not reach the setting to ' + 'find out. Nothing has changed.'
+                }) : null,
+                !planReady ? /*#__PURE__*/ _jsx(Typography, {
+                    variant: "body2",
+                    color: "text.secondary",
+                    children: 'Checking your plan…'
+                }) : /*#__PURE__*/ _jsxs(_Fragment, {
+                    children: [
+                        !commerceEnabled ? /*#__PURE__*/ _jsx(Alert, {
+                            severity: "info",
+                            children: 'Selling requires a paid plan — upgrade on the billing page.'
+                        }) : null,
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'Buyers pay on your own Stripe account; ' + `${Aglyn.PLATFORM_BRAND_LEGAL_NAME} collects a platform fee ` + 'per sale based on your plan:'
+                        }),
+                        /*#__PURE__*/ _jsxs(Typography, {
+                            variant: "body2",
+                            children: [
+                                `Physical products: ${physicalPct}% · Digital products, ` + `services & bookings: ${digitalPct}%`,
+                                physicalPct > 0 || digitalPct > 0 ? /*#__PURE__*/ _jsx(Typography, {
+                                    component: "span",
+                                    variant: "caption",
+                                    color: "text.secondary",
+                                    children: ' — higher plans reduce fees to 0%'
+                                }) : null
+                            ]
+                        }),
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'Card processing is passed through at cost on top of that: ' + `${Aglyn.MARKETPLACE_PROCESSING_PERCENT_CARD}–` + `${Aglyn.MARKETPLACE_PROCESSING_PERCENT_BNPL}% + ` + `${Aglyn.MARKETPLACE_PROCESSING_FIXED_CENTS}¢ per online ` + 'sale, what Stripe charges to take the payment. It is not a ' + `${Aglyn.PLATFORM_BRAND_LEGAL_NAME} margin.`
+                        }),
+                        physicalPct > 0 || digitalPct > 0 ? /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            color: "text.secondary",
+                            children: 'The fee is charged on the sale, not on how it was paid — ' + 'in-person cash and room-charge sales carry it too. On card ' + 'sales it is deducted from your Stripe payout; on cash and ' + 'room-charge sales there is no payout to deduct from, so it ' + `is added to your monthly ${Aglyn.PLATFORM_BRAND_LEGAL_NAME} ` + 'invoice instead.'
+                        }) : null
+                    ]
+                }),
+                modeUnverified ? /*#__PURE__*/ _jsx(Alert, {
+                    severity: "error",
+                    children: 'Your Stripe account has not been verified for payments on ' + 'this site, so sales will be refused. Set up payments again ' + 'to verify it — if it was connected against Stripe test mode, ' + 'you will need to connect a live account.'
+                }) : null,
+                stripeState === 'loaded' && (profile == null ? void 0 : profile.lastPayoutFailureAtMs) ? /*#__PURE__*/ _jsx(Alert, {
+                    severity: "warning",
+                    variant: "outlined",
+                    children: `A payout of $${(Number((_profile_lastPayoutFailureCents = profile.lastPayoutFailureCents) != null ? _profile_lastPayoutFailureCents : 0) / 100).toFixed(2)} did not reach your bank on ${new Date(Number(profile.lastPayoutFailureAtMs)).toLocaleDateString()} — ${String((_profile_lastPayoutFailureReason = profile.lastPayoutFailureReason) != null ? _profile_lastPayoutFailureReason : 'Stripe did not say why')} The money is still in your Stripe account. Open Stripe to fix your payout details.`
+                }) : null,
+                !planReady || stripeState !== 'loaded' ? null : isOwner ? /*#__PURE__*/ _jsxs(_Fragment, {
+                    children: [
+                        /*#__PURE__*/ _jsx(Button, {
+                            size: "small",
+                            variant: chargesEnabled ? 'text' : 'contained',
+                            color: "primary",
+                            disabled: busy,
+                            onClick: handleConnect,
+                            sx: {
+                                alignSelf: 'flex-start'
+                            },
+                            children: chargesEnabled ? 'Refresh status' : busy ? 'Opening Stripe…' : 'Set up payments'
+                        }),
+                        dashboardUrl ? /*#__PURE__*/ _jsx(Button, {
+                            size: "small",
+                            variant: "text",
+                            color: "primary",
+                            href: dashboardUrl,
+                            target: "_blank",
+                            rel: "noopener noreferrer",
+                            sx: {
+                                alignSelf: 'flex-start'
+                            },
+                            children: 'View payouts in Stripe'
+                        }) : null
+                    ]
+                }) : /*#__PURE__*/ _jsx(Typography, {
+                    variant: "caption",
+                    color: "text.secondary",
+                    children: 'Only the organization owner can set up payments.'
+                })
+            ]
+        })
+    });
+}
+PaymentsSettingsCard.displayName = 'PaymentsSettingsCard';
+export default PaymentsSettingsCard;
+
+//# sourceMappingURL=payments-settings-card.component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/payments-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 { trackEvent } from '@aglyn/aglyn/app-utils/analytics-events'\nimport * as Aglyn from '@aglyn/aglyn'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { Alert, Button, Chip, Stack, Typography } from '@mui/material'\nimport { doc } from 'firebase/firestore'\nimport { useCallback, useState } from 'react'\nimport { useFirestore, useUser } from '@aglyn/tenant-feature-instance'\nimport { useFirestoreDoc } from '@aglyn/tenant-feature-instance'\nimport { useOrgPlan } from '@aglyn/tenant-feature-instance'\nimport { pluginDocsHelp } from '@aglyn/aglyn'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\n\nexport interface PaymentsSettingsCardProps {\n  hostId: string\n}\n\n/**\n * Merchant payments card (AGL-284): Stripe Connect Express onboarding\n * status for the org owner + the plan's transaction-fee ladder so the\n * \"upgrade to kill fees\" motion (AGL-278) is visible where it matters.\n */\nexport function PaymentsSettingsCard(props: PaymentsSettingsCardProps) {\n  const { hostId } = props\n  const firestore = useFirestore()\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const [busy, setBusy] = useState(false)\n  /**\n   * A one-time Stripe Express dashboard link, minted by the connect route on\n   * request. Not persisted: login links are single-use and short-lived, so a\n   * stored one would be a button that fails the second time it is pressed.\n   */\n  const [dashboardUrl, setDashboardUrl] = useState<string | null>(null)\n  const { org, ready: planReady } = useOrgPlan(hostId)\n  /** Bumped by Retry to re-subscribe the profile listen (AGL-1380). */\n  const [retryNonce, setRetryNonce] = useState(0)\n  const uid = (user as any)?.uid as string | undefined\n  const { data: profile, status: profileStatus } = useFirestoreDoc<any>(\n    // Held at null rather than addressed as `profiles/-pending-` — that\n    // sentinel issued a guaranteed-denied read on every pre-auth mount, and\n    // a denial lands in `status: 'error'`, which now means something.\n    () => (uid ? doc(firestore, 'profiles', uid) : null),\n    [firestore, uid, retryNonce],\n  )\n  const isOwner = Boolean(\n    org?.ownerUid && (user as any)?.uid === org.ownerUid,\n  )\n  /**\n   * Three outcomes, not two (AGL-1380). An absent profile doc is the value\n   * BEFORE an answer as much as it is the value of a merchant who never\n   * connected Stripe, so \"Not set up\" off a falsy `stripeChargesEnabled` is a\n   * claim about this org's payment setup made without having heard back. It\n   * is wrong in the direction that provokes action: the same falsy value\n   * turns the button into \"Set up payments\", which sends a merchant who is\n   * already taking money into Stripe onboarding.\n   */\n  const stripeState: 'pending' | 'error' | 'loaded' =\n    !uid || profileStatus === 'loading'\n      ? 'pending'\n      : profileStatus === 'error'\n        ? 'error'\n        : 'loaded'\n  /**\n   * WHICH STRIPE WORLD THE STORED ACCOUNT BELONGS TO (AGL-2471).\n   *\n   * `stripeChargesEnabled: true` was the whole readiness claim, and a\n   * production profile carrying it named a TEST-mode account: this card said\n   * \"Charges enabled\" about three storefronts that could not take a single\n   * payment. Only a literal boolean counts as recorded — the same\n   * three-valued reading `connectLinkageIsReady` uses on the server, so the\n   * chip and the checkout cannot disagree.\n   */\n  const modeVerified = typeof profile?.stripeAccountLivemode === 'boolean'\n  const chargesConnected =\n    stripeState === 'loaded' && Boolean(profile?.stripeChargesEnabled)\n  const modeUnverified = chargesConnected && !modeVerified\n  const chargesEnabled = chargesConnected && modeVerified\n  const physicalPct = Aglyn.resolveTransactionFeePct(org, 'physical')\n  const digitalPct = Aglyn.resolveTransactionFeePct(org, 'digital')\n  const commerceEnabled = Aglyn.checkEntitlement(org, 'commerce')\n\n  const handleConnect = useCallback(async () => {\n    setBusy(true)\n    try {\n      const response = await authorizedFetch(user, '/api/commerce/connect', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ hostId }),\n      })\n      const payload = await response.json()\n      if (response.status === 501) {\n        return void enqueueSnackbar(\n          'Payments are not configured on this deployment',\n          { variant: 'info', persist: false },\n        )\n      }\n      if (!response.ok) {\n        return void enqueueSnackbar(payload?.error ?? 'Payment setup failed', {\n          variant: 'error',\n          allowDuplicate: true,\n        })\n      }\n      if (payload.chargesEnabled) {\n        // \"% who connect Stripe\" — a GTM plan §6 activation metric\n        // (AGL-1561). Gated on the TRANSITION, not the state: this handler\n        // is a re-entrant create-or-resume, so it answers `chargesEnabled:\n        // true` on every subsequent visit to a connected account, and a bare\n        // event here would count one merchant once per click forever.\n        // `chargesEnabled` is the state read from the profile BEFORE this\n        // request, so the event fires only when onboarding actually completed.\n        if (!chargesEnabled) trackEvent('stripe_connected', {})\n        // CHARGES AND PAYOUTS ARE TWO FLAGS, AND ONLY ONE OF THEM IS THIS\n        // SENTENCE (AGL-1997). `chargesEnabled` says Stripe will let the\n        // account take money; whether the money can LEAVE is `payoutsEnabled`,\n        // which the route answers alongside it. Charges-yes/payouts-no is an\n        // ordinary Stripe state — verification pending or lapsed, no payout\n        // method — and announcing \"Payments are enabled\" in it is false in the\n        // direction that costs the merchant: they sell believing they are\n        // paid, and the funds sit in a Connect account that cannot release\n        // them. Read three-valued, so only a literal `false` from Stripe\n        // downgrades the claim; an absent flag means unasked, not off.\n        const payoutsBlocked = payload.payoutsEnabled === false\n        // A WARNING THAT NAMES A PROBLEM MUST OFFER THE FIX.\n        //\n        // Stripe is the only place payouts can be released — an Express\n        // account has no password and no direct login — so telling the\n        // merchant their funds are stranded and then keeping them here is half\n        // an answer. The route now mints the remediation link for exactly this\n        // state; going there is the whole point of pressing the button.\n        if (payoutsBlocked && payload.url) {\n          return void window.location.assign(payload.url)\n        }\n        // Payouts are flowing, so the link is the Express dashboard: balance,\n        // payout schedule, and the reason a payout failed. Held in state\n        // rather than followed, because this click was a status check and\n        // navigating away from one nobody asked to leave is its own defect.\n        if (!payoutsBlocked && typeof payload.dashboardUrl === 'string') {\n          setDashboardUrl(payload.dashboardUrl)\n        }\n        return void enqueueSnackbar(\n          payoutsBlocked\n            ? 'Connected — payouts are not released yet'\n            : 'Payments are enabled',\n          {\n            variant: payoutsBlocked ? 'warning' : 'success',\n            persist: false,\n          },\n        )\n      }\n      if (payload.url) window.location.assign(payload.url)\n    } catch (error) {\n      console.error(error)\n      enqueueSnackbar('An error has occurred', {\n        variant: 'error',\n        allowDuplicate: true,\n      })\n    } finally {\n      setBusy(false)\n    }\n  }, [user, hostId, chargesEnabled, enqueueSnackbar])\n\n  return (\n    <CardDisplay\n      header={'Payments'}\n      help={pluginDocsHelp('commerceEndToEnd', {\n        anchor: '#1-connect-payments',\n      })}\n      contentGutterX\n      contentGutterY\n    >\n      <Stack spacing={1.5}>\n        <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n          <Typography variant=\"body2\" sx={{ flex: 1 }}>\n            {'Stripe account'}\n          </Typography>\n          {/*\n            No chip at all on error: both labels it could carry — \"Charges\n            enabled\" and \"Not set up\" — assert something we failed to find\n            out. Whatever Stripe is doing right now it carries on doing.\n          */}\n          {stripeState === 'error' ? null : (\n            <Chip\n              size=\"small\"\n              label={\n                stripeState === 'pending'\n                  ? 'Checking…'\n                  : chargesEnabled\n                    ? 'Charges enabled'\n                    : modeUnverified\n                      ? 'Not verified'\n                      : 'Not set up'\n              }\n              color={\n                stripeState === 'pending'\n                  ? 'default'\n                  : chargesEnabled\n                    ? 'success'\n                    : modeUnverified\n                      ? 'error'\n                      : 'warning'\n              }\n              variant=\"outlined\"\n            />\n          )}\n        </Stack>\n        {stripeState === 'error' ? (\n          <Alert\n            severity=\"error\"\n            action={\n              <Button\n                color=\"inherit\"\n                size=\"small\"\n                onClick={() => setRetryNonce((n) => n + 1)}\n              >\n                {'Retry'}\n              </Button>\n            }\n          >\n            {'We couldn’t load your payment setup. This says nothing about ' +\n              'whether payments are on — we could not reach the setting to ' +\n              'find out. Nothing has changed.'}\n          </Alert>\n        ) : null}\n        {/*\n          Every line below reads the plan, and an org doc still in flight\n          resolves to the FREE tier (AGL-1064) — which would flash \"Selling\n          requires a paid plan\" and the wrong fee percentages at a paying\n          seller, then correct itself. Say nothing until it is known.\n        */}\n        {!planReady ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'Checking your plan…'}\n          </Typography>\n        ) : (\n          <>\n            {!commerceEnabled ? (\n              <Alert severity=\"info\">\n                {'Selling requires a paid plan — upgrade on the billing page.'}\n              </Alert>\n            ) : null}\n            {/*\n                THE LEGAL NAME, not the org's resolved `productName`\n                (AGL-2351). This sentence says who takes money off the\n                merchant's own Stripe account, and the application fee lands in\n                the platform Stripe account — held by the operating entity, not\n                by a white-label agency reselling the console. Naming the\n                agency here would assert a fee relationship that does not\n                exist. `PLATFORM_BRAND_LEGAL_NAME` still configures cleanly for\n                a self-host operator, who really is the entity collecting it.\n            */}\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {'Buyers pay on your own Stripe account; ' +\n                `${Aglyn.PLATFORM_BRAND_LEGAL_NAME} collects a platform fee ` +\n                'per sale based on your plan:'}\n            </Typography>\n            {/* The DIGITAL rate is not products-only (AGL-2315). A paid\n                booking is a service sale and resolves through the same\n                `'service'`/digital axis, so a bookings-only merchant pays this\n                exact number — and this card was the one place they could read\n                their own rate while naming only \"products\". Stated here rather\n                than adding a third figure: it is one rate, not two. */}\n            <Typography variant=\"body2\">\n              {`Physical products: ${physicalPct}% · Digital products, ` +\n                `services & bookings: ${digitalPct}%`}\n              {physicalPct > 0 || digitalPct > 0 ? (\n                <Typography\n                  component=\"span\"\n                  variant=\"caption\"\n                  color=\"text.secondary\"\n                >\n                  {' — higher plans reduce fees to 0%'}\n                </Typography>\n              ) : null}\n            </Typography>\n            {/* CARD PROCESSING, PASSED THROUGH AT COST (AGL-2152).\n\n                Unconditional, including on the 0% plans, because it is\n                exactly those plans where the merchant would otherwise read\n                \"0%\" and be surprised by a deduction. Their PLATFORM fee\n                really is zero — the figure below is Stripe's own charge for\n                taking the payment, which every storefront sale incurs and\n                which used to be absorbed silently out of the platform's\n                balance rather than passed through.\n\n                Named as a range rather than one number because the buyer\n                chooses the payment method after the session is created:\n                cards settle at the low end, buy-now-pay-later at the high\n                end, and the deduction is sized for the dearest so a sale can\n                never cost more to process than it collects. */}\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {'Card processing is passed through at cost on top of that: ' +\n                `${Aglyn.MARKETPLACE_PROCESSING_PERCENT_CARD}–` +\n                `${Aglyn.MARKETPLACE_PROCESSING_PERCENT_BNPL}% + ` +\n                `${Aglyn.MARKETPLACE_PROCESSING_FIXED_CENTS}¢ per online ` +\n                'sale, what Stripe charges to take the payment. It is not a ' +\n                `${Aglyn.PLATFORM_BRAND_LEGAL_NAME} margin.`}\n            </Typography>\n            {/* EVERY TENDER, AND HOW EACH IS COLLECTED (AGL-2111).\n\n                Until now this card said \"per sale\" and meant it for online and\n                card sales only: cash and room-charge sales at the register\n                recorded no fee at all, so a merchant could read this sentence,\n                ring everything as cash, and pay nothing. The fee now attaches\n                to the sale on every tender, which makes the sentence above\n                true — and creates a second, visible collection route the\n                merchant has to be told about BEFORE it appears on their\n                invoice, because it is money leaving by a door they have never\n                seen it leave by.\n\n                Shown only when a rate actually applies: on a 0% plan there is\n                nothing to collect either way, and the paragraph would be noise\n                on the card of the merchants who upgraded to escape fees. */}\n            {physicalPct > 0 || digitalPct > 0 ? (\n              <Typography variant=\"body2\" color=\"text.secondary\">\n                {'The fee is charged on the sale, not on how it was paid — ' +\n                  'in-person cash and room-charge sales carry it too. On card ' +\n                  'sales it is deducted from your Stripe payout; on cash and ' +\n                  'room-charge sales there is no payout to deduct from, so it ' +\n                  `is added to your monthly ${Aglyn.PLATFORM_BRAND_LEGAL_NAME} ` +\n                  'invoice instead.'}\n              </Typography>\n            ) : null}\n          </>\n        )}\n        {/*\n          AGL-2471: connected, and refused by every money door because the\n          account was never verified against this deployment's Stripe mode.\n          \"Not set up\" would be a lie in the other direction — the merchant\n          did set something up — so the card names what is actually wrong and\n          what to do about it.\n        */}\n        {modeUnverified ? (\n          <Alert severity=\"error\">\n            {'Your Stripe account has not been verified for payments on ' +\n              'this site, so sales will be refused. Set up payments again ' +\n              'to verify it — if it was connected against Stripe test mode, ' +\n              'you will need to connect a live account.'}\n          </Alert>\n        ) : null}\n        {/*\n          The button's own label is a claim — \"Set up payments\" tells the\n          owner they have none. Withheld until the answer is in, for the same\n          reason as the chip (AGL-1380); on error the Retry above is the only\n          action offered, because acting on a setup we could not read is how\n          a connected merchant gets sent back through onboarding.\n        */}\n        {/*\n          WHERE THE MONEY STOPPED. Mirrored onto this profile by the\n          `payout.failed` handler and retired by the next successful payout, so\n          it names a live problem rather than a scar. Without it a merchant sold\n          into an account that could not release the funds and the card said\n          \"Payments are enabled\" the whole time — the storefront looked healthy\n          from every angle available to them.\n        */}\n        {stripeState === 'loaded' && profile?.lastPayoutFailureAtMs ? (\n          <Alert severity=\"warning\" variant=\"outlined\">\n            {`A payout of $${(\n              Number(profile.lastPayoutFailureCents ?? 0) / 100\n            ).toFixed(2)} did not reach your bank on ${new Date(\n              Number(profile.lastPayoutFailureAtMs),\n            ).toLocaleDateString()} — ${String(\n              profile.lastPayoutFailureReason ?? 'Stripe did not say why',\n            )} The money is still in your Stripe account. Open Stripe to fix your payout details.`}\n          </Alert>\n        ) : null}\n        {!planReady || stripeState !== 'loaded' ? null : isOwner ? (\n          <>\n            <Button\n              size=\"small\"\n              variant={chargesEnabled ? 'text' : 'contained'}\n              color=\"primary\"\n              disabled={busy}\n              onClick={handleConnect}\n              sx={{ alignSelf: 'flex-start' }}\n            >\n              {chargesEnabled\n                ? 'Refresh status'\n                : busy\n                  ? 'Opening Stripe…'\n                  : 'Set up payments'}\n            </Button>\n            {/*\n            Where the money actually is. Aglyn records none of it —\n            no balance, no payout schedule, and no `payout.failed` handling\n            anywhere — so a merchant whose payout bounced has no way to learn\n            that from this console. An Express account has no direct login\n            either, which leaves a link minted by the platform as the only\n            route in. `target=\"_blank\"` because it leaves the app entirely.\n          */}\n            {dashboardUrl ? (\n              <Button\n                size=\"small\"\n                variant=\"text\"\n                color=\"primary\"\n                href={dashboardUrl}\n                target=\"_blank\"\n                rel=\"noopener noreferrer\"\n                sx={{ alignSelf: 'flex-start' }}\n              >\n                {'View payouts in Stripe'}\n              </Button>\n            ) : null}\n          </>\n        ) : (\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {'Only the organization owner can set up payments.'}\n          </Typography>\n        )}\n      </Stack>\n    </CardDisplay>\n  )\n}\nPaymentsSettingsCard.displayName = 'PaymentsSettingsCard'\n\nexport default PaymentsSettingsCard\n"],"names":["trackEvent","Aglyn","CardDisplay","useSnackbar","Alert","Button","Chip","Stack","Typography","doc","useCallback","useState","useFirestore","useUser","useFirestoreDoc","useOrgPlan","pluginDocsHelp","authorizedFetch","PaymentsSettingsCard","props","profile","hostId","firestore","data","user","enqueueSnackbar","busy","setBusy","dashboardUrl","setDashboardUrl","org","ready","planReady","retryNonce","setRetryNonce","uid","status","profileStatus","isOwner","Boolean","ownerUid","stripeState","modeVerified","stripeAccountLivemode","chargesConnected","stripeChargesEnabled","modeUnverified","chargesEnabled","physicalPct","resolveTransactionFeePct","digitalPct","commerceEnabled","checkEntitlement","handleConnect","response","method","headers","body","JSON","stringify","payload","json","variant","persist","ok","error","allowDuplicate","payoutsBlocked","payoutsEnabled","url","window","location","assign","console","header","help","anchor","contentGutterX","contentGutterY","spacing","direction","sx","alignItems","flex","size","label","color","severity","action","onClick","n","PLATFORM_BRAND_LEGAL_NAME","component","MARKETPLACE_PROCESSING_PERCENT_CARD","MARKETPLACE_PROCESSING_PERCENT_BNPL","MARKETPLACE_PROCESSING_FIXED_CENTS","lastPayoutFailureAtMs","Number","lastPayoutFailureCents","toFixed","Date","toLocaleDateString","String","lastPayoutFailureReason","disabled","alignSelf","href","target","rel","displayName"],"mappings":"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"}

package/src/lib/components/console/pos-page.component.d.ts

@@ -0,0 +1,13 @@
+import type { ConsolePluginPageProps } from '@aglyn/aglyn';
+/**
+ * POS register (AGL-312): touch-first full-screen sale surface —
+ * product grid with search/barcode (keyboard-wedge scanners type into
+ * the search box and press Enter), a register cart with a whole-sale
+ * discount, and cash / QR-card / reservation-folio settlement through
+ * the server-priced pos-order API. Receipts print via the browser.
+ */
+export declare function PosConsolePage({ hostId }: ConsolePluginPageProps): import("react").JSX.Element;
+export declare namespace PosConsolePage {
+    var displayName: string;
+}
+export default PosConsolePage;