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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/plugins-commerce",
-  "version": "1.0.0-beta.232",
+  "version": "1.0.0-beta.233",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,18 +25,18 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/aglyn": "1.0.0-beta.232",
-    "@aglyn/shared-data-mdi": "1.0.0-beta.232",
-    "@aglyn/shared-ui-jsx": "1.0.0-beta.232",
-    "@aglyn/shared-ui-next": "1.0.0-beta.232",
-    "@aglyn/shared-ui-snackstack": "1.0.0-beta.232",
-    "@aglyn/shared-util-email": "1.0.0-beta.232",
-    "@aglyn/shared-util-http": "1.0.0-beta.232",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.232",
-    "@aglyn/shared-util-tools": "1.0.0-beta.232",
-    "@aglyn/tenant-data-admin": "1.0.0-beta.232",
-    "@aglyn/tenant-feature-instance": "1.0.0-beta.232",
-    "@aglyn/tenant-runtime": "1.0.0-beta.232",
+    "@aglyn/aglyn": "1.0.0-beta.233",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.233",
+    "@aglyn/shared-ui-jsx": "1.0.0-beta.233",
+    "@aglyn/shared-ui-next": "1.0.0-beta.233",
+    "@aglyn/shared-ui-snackstack": "1.0.0-beta.233",
+    "@aglyn/shared-util-email": "1.0.0-beta.233",
+    "@aglyn/shared-util-http": "1.0.0-beta.233",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.233",
+    "@aglyn/shared-util-tools": "1.0.0-beta.233",
+    "@aglyn/tenant-data-admin": "1.0.0-beta.233",
+    "@aglyn/tenant-feature-instance": "1.0.0-beta.233",
+    "@aglyn/tenant-runtime": "1.0.0-beta.233",
     "@stripe/react-stripe-js": "^6.12.0",
     "@stripe/stripe-js": "^9.17.0",
     "@swc/helpers": "0.5.23",

package/src/lib/components/cart-extras.d.ts

@@ -30,12 +30,18 @@ export interface CartExtraOffer {
     defaultSelected: boolean;
     termsUrl?: string;
 }
+/** A store-credit code the cart takes (AGL-3640): rewards, referral credit. */
+export interface CartCreditOffer {
+    providerId: string;
+    label: string;
+}
 export declare function useCartExtras(hostId: string | undefined, cartSignature: string): {
     offers: CartExtraOffer[];
     chosen: Record<string, boolean>;
     chosenIds: string[];
     toggle: (id: string, value: boolean) => void;
     reload: () => void;
+    credits: CartCreditOffer[];
 };
 export declare function CartExtras(props: {
     offers: CartExtraOffer[];

package/src/lib/components/cart-extras.js

@@ -23,6 +23,7 @@ import Typography from "@mui/material/Typography";
 import { useCallback, useEffect, useMemo, useState } from "react";
 export function useCartExtras(hostId, cartSignature) {
     const [offers, setOffers] = useState([]);
+    const [credits, setCredits] = useState([]);
     const [chosen, setChosen] = useState({});
     const [round, setRound] = useState(0);
     useEffect(()=>{
@@ -37,6 +38,7 @@ export function useCartExtras(hostId, cartSignature) {
             if (!live) return;
             const next = Array.isArray(payload == null ? void 0 : payload.extras) ? payload.extras : [];
             setOffers(next);
+            setCredits(Array.isArray(payload == null ? void 0 : payload.credits) ? payload.credits : []);
             // A box the shopper already touched keeps their answer.
             setChosen((prior)=>Object.fromEntries(next.map((offer)=>{
                     var _prior_offer_id;
@@ -69,7 +71,8 @@ export function useCartExtras(hostId, cartSignature) {
         chosen,
         chosenIds,
         toggle,
-        reload
+        reload,
+        credits
     };
 }
 export function CartExtras(props) {

package/src/lib/components/cart-extras.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/components/cart-extras.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\nimport Box from '@mui/material/Box'\nimport Checkbox from '@mui/material/Checkbox'\nimport FormControlLabel from '@mui/material/FormControlLabel'\nimport Link from '@mui/material/Link'\nimport Typography from '@mui/material/Typography'\nimport { useCallback, useEffect, useMemo, useState } from 'react'\n\n/**\n * Optional lines another plugin offers at the cart (AGL-3635), as boxes the\n * shopper ticks — package protection is the first. The offers come from\n * `GET /api/commerce/cart-extras`, asked only while the cart is on screen\n * and again whenever its lines change; the checkout asks the provider again\n * for the price it charges, so what is shown here is never what is trusted.\n * A store with no offering plugin gets an empty answer and draws nothing.\n */\n\nexport interface CartExtraOffer {\n  id: string\n  label: string\n  description?: string\n  amountCents: number\n  defaultSelected: boolean\n  termsUrl?: string\n}\n\nexport function useCartExtras(hostId: string | undefined, cartSignature: string) {\n  const [offers, setOffers] = useState<CartExtraOffer[]>([])\n  const [chosen, setChosen] = useState<Record<string, boolean>>({})\n  const [round, setRound] = useState(0)\n  useEffect(() => {\n    if (!hostId || cartSignature === '[]') {\n      setOffers([])\n      return\n    }\n    let live = true\n    fetch(`/api/commerce/cart-extras?hostId=${encodeURIComponent(hostId)}`)\n      .then((response) => (response.ok ? response.json() : { extras: [] }))\n      .then((payload: { extras?: CartExtraOffer[] }) => {\n        if (!live) return\n        const next = Array.isArray(payload?.extras) ? payload.extras : []\n        setOffers(next)\n        // A box the shopper already touched keeps their answer.\n        setChosen((prior) =>\n          Object.fromEntries(next.map((offer) => [offer.id, prior[offer.id] ?? offer.defaultSelected])),\n        )\n      })\n      .catch(() => live && setOffers([]))\n    return () => {\n      live = false\n    }\n  }, [hostId, cartSignature, round])\n  const chosenIds = useMemo(\n    () => offers.filter((offer) => chosen[offer.id]).map((offer) => offer.id),\n    [offers, chosen],\n  )\n  const toggle = useCallback((id: string, value: boolean) => {\n    setChosen((prior) => ({ ...prior, [id]: value }))\n  }, [])\n  /** Asks again — after the checkout said an offer changed. */\n  const reload = useCallback(() => setRound((value) => value + 1), [])\n  return { offers, chosen, chosenIds, toggle, reload }\n}\n\nexport function CartExtras(props: {\n  offers: CartExtraOffer[]\n  chosen: Record<string, boolean>\n  onToggle: (id: string, value: boolean) => void\n  formatCents: (cents: number) => string\n}) {\n  const { offers, chosen, onToggle, formatCents } = props\n  if (!offers.length) return null\n  return (\n    <Box sx={{ display: 'flex', flexDirection: 'column', gap: 0.5 }}>\n      {offers.map((offer) => (\n        <Box key={offer.id}>\n          <FormControlLabel\n            control={\n              <Checkbox\n                size=\"small\"\n                checked={Boolean(chosen[offer.id])}\n                onChange={(event) => onToggle(offer.id, event.target.checked)}\n              />\n            }\n            label={\n              <Typography variant=\"body2\">\n                {`${offer.label} (${formatCents(offer.amountCents)})`}\n              </Typography>\n            }\n          />\n          {offer.description || offer.termsUrl ? (\n            <Typography variant=\"caption\" color=\"text.secondary\" component=\"p\" sx={{ ml: 4 }}>\n              {offer.description ?? ''}\n              {offer.termsUrl ? (\n                <>\n                  {offer.description ? ' ' : ''}\n                  <Link href={offer.termsUrl} target=\"_blank\" rel=\"noopener noreferrer\">\n                    {'Details'}\n                  </Link>\n                </>\n              ) : null}\n            </Typography>\n          ) : null}\n        </Box>\n      ))}\n    </Box>\n  )\n}\n"],"names":["Box","Checkbox","FormControlLabel","Link","Typography","useCallback","useEffect","useMemo","useState","useCartExtras","hostId","cartSignature","offers","setOffers","chosen","setChosen","round","setRound","live","fetch","encodeURIComponent","then","response","ok","json","extras","payload","next","Array","isArray","prior","Object","fromEntries","map","offer","id","defaultSelected","catch","chosenIds","filter","toggle","value","reload","CartExtras","props","onToggle","formatCents","length","sx","display","flexDirection","gap","control","size","checked","Boolean","onChange","event","target","label","variant","amountCents","description","termsUrl","color","component","ml","href","rel"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/components/cart-extras.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\nimport Box from '@mui/material/Box'\nimport Checkbox from '@mui/material/Checkbox'\nimport FormControlLabel from '@mui/material/FormControlLabel'\nimport Link from '@mui/material/Link'\nimport Typography from '@mui/material/Typography'\nimport { useCallback, useEffect, useMemo, useState } from 'react'\n\n/**\n * Optional lines another plugin offers at the cart (AGL-3635), as boxes the\n * shopper ticks — package protection is the first. The offers come from\n * `GET /api/commerce/cart-extras`, asked only while the cart is on screen\n * and again whenever its lines change; the checkout asks the provider again\n * for the price it charges, so what is shown here is never what is trusted.\n * A store with no offering plugin gets an empty answer and draws nothing.\n */\n\nexport interface CartExtraOffer {\n  id: string\n  label: string\n  description?: string\n  amountCents: number\n  defaultSelected: boolean\n  termsUrl?: string\n}\n\n/** A store-credit code the cart takes (AGL-3640): rewards, referral credit. */\nexport interface CartCreditOffer {\n  providerId: string\n  label: string\n}\n\nexport function useCartExtras(hostId: string | undefined, cartSignature: string) {\n  const [offers, setOffers] = useState<CartExtraOffer[]>([])\n  const [credits, setCredits] = useState<CartCreditOffer[]>([])\n  const [chosen, setChosen] = useState<Record<string, boolean>>({})\n  const [round, setRound] = useState(0)\n  useEffect(() => {\n    if (!hostId || cartSignature === '[]') {\n      setOffers([])\n      return\n    }\n    let live = true\n    fetch(`/api/commerce/cart-extras?hostId=${encodeURIComponent(hostId)}`)\n      .then((response) => (response.ok ? response.json() : { extras: [] }))\n      .then((payload: { extras?: CartExtraOffer[]; credits?: CartCreditOffer[] }) => {\n        if (!live) return\n        const next = Array.isArray(payload?.extras) ? payload.extras : []\n        setOffers(next)\n        setCredits(Array.isArray(payload?.credits) ? payload.credits : [])\n        // A box the shopper already touched keeps their answer.\n        setChosen((prior) =>\n          Object.fromEntries(next.map((offer) => [offer.id, prior[offer.id] ?? offer.defaultSelected])),\n        )\n      })\n      .catch(() => live && setOffers([]))\n    return () => {\n      live = false\n    }\n  }, [hostId, cartSignature, round])\n  const chosenIds = useMemo(\n    () => offers.filter((offer) => chosen[offer.id]).map((offer) => offer.id),\n    [offers, chosen],\n  )\n  const toggle = useCallback((id: string, value: boolean) => {\n    setChosen((prior) => ({ ...prior, [id]: value }))\n  }, [])\n  /** Asks again — after the checkout said an offer changed. */\n  const reload = useCallback(() => setRound((value) => value + 1), [])\n  return { offers, chosen, chosenIds, toggle, reload, credits }\n}\n\nexport function CartExtras(props: {\n  offers: CartExtraOffer[]\n  chosen: Record<string, boolean>\n  onToggle: (id: string, value: boolean) => void\n  formatCents: (cents: number) => string\n}) {\n  const { offers, chosen, onToggle, formatCents } = props\n  if (!offers.length) return null\n  return (\n    <Box sx={{ display: 'flex', flexDirection: 'column', gap: 0.5 }}>\n      {offers.map((offer) => (\n        <Box key={offer.id}>\n          <FormControlLabel\n            control={\n              <Checkbox\n                size=\"small\"\n                checked={Boolean(chosen[offer.id])}\n                onChange={(event) => onToggle(offer.id, event.target.checked)}\n              />\n            }\n            label={\n              <Typography variant=\"body2\">\n                {`${offer.label} (${formatCents(offer.amountCents)})`}\n              </Typography>\n            }\n          />\n          {offer.description || offer.termsUrl ? (\n            <Typography variant=\"caption\" color=\"text.secondary\" component=\"p\" sx={{ ml: 4 }}>\n              {offer.description ?? ''}\n              {offer.termsUrl ? (\n                <>\n                  {offer.description ? ' ' : ''}\n                  <Link href={offer.termsUrl} target=\"_blank\" rel=\"noopener noreferrer\">\n                    {'Details'}\n                  </Link>\n                </>\n              ) : null}\n            </Typography>\n          ) : null}\n        </Box>\n      ))}\n    </Box>\n  )\n}\n"],"names":["Box","Checkbox","FormControlLabel","Link","Typography","useCallback","useEffect","useMemo","useState","useCartExtras","hostId","cartSignature","offers","setOffers","credits","setCredits","chosen","setChosen","round","setRound","live","fetch","encodeURIComponent","then","response","ok","json","extras","payload","next","Array","isArray","prior","Object","fromEntries","map","offer","id","defaultSelected","catch","chosenIds","filter","toggle","value","reload","CartExtras","props","onToggle","formatCents","length","sx","display","flexDirection","gap","control","size","checked","Boolean","onChange","event","target","label","variant","amountCents","description","termsUrl","color","component","ml","href","rel"],"mappings":"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"}

package/src/lib/components/cart-fulfillment.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @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 type { PickupLocationOption } from '../model/local-fulfillment-settings';
+/**
+ * How the shopper receives the order (AGL-3624): shipped, picked up at one of
+ * the store's locations, or brought by the store's own driver. Asked at the
+ * cart because that is where the store still decides what the checkout
+ * offers; `POST /api/commerce/local-fulfillment-options` answers what this
+ * store and this basket can have, and the checkout decides the fee, the
+ * minimum and the window again from the store's settings — nothing shown
+ * here is trusted.
+ *
+ * A store with no pickup location and no local delivery gets an empty answer
+ * and draws nothing: its cart is exactly what it was.
+ */
+export interface CartDeliveryWindow {
+    id: string;
+    startMs: number;
+    endMs: number;
+    label: string;
+}
+export interface CartDeliveryQuote {
+    zoneId?: string;
+    zoneName?: string;
+    feeCents?: number;
+    minimumCents?: number;
+    freeOverCents?: number;
+    shortfallCents?: number;
+    unavailable?: string;
+}
+export interface CartFulfillmentOptions {
+    pickup: PickupLocationOption[];
+    delivery: {
+        country: string;
+        instructions?: string;
+        needsAddress: boolean;
+        windows: CartDeliveryWindow[];
+        quote?: CartDeliveryQuote;
+    } | null;
+    /** Whether the store can text the buyer about the pickup or delivery. */
+    texts?: boolean;
+}
+export type CartFulfillmentMethod = 'shipping' | 'pickup' | 'local_delivery';
+export declare function useCartFulfillment(hostId: string | undefined, cartSignature: string, 
+/**
+ * A product's Buy button asks for that product rather than the cart; `null`
+ * asks nothing (a subscription, a download).
+ */
+buyNow?: {
+    productId: string;
+    variantId?: string;
+    quantity: number;
+} | null): {
+    options: CartFulfillmentOptions;
+    offered: boolean;
+    method: CartFulfillmentMethod;
+    setMethod: import("react").Dispatch<import("react").SetStateAction<CartFulfillmentMethod>>;
+    locationId: string;
+    setLocationId: import("react").Dispatch<import("react").SetStateAction<string>>;
+    postalCode: string;
+    setPostalCode: import("react").Dispatch<import("react").SetStateAction<string>>;
+    line1: string;
+    setLine1: import("react").Dispatch<import("react").SetStateAction<string>>;
+    windowId: string;
+    setWindowId: import("react").Dispatch<import("react").SetStateAction<string>>;
+    textPhone: string;
+    setTextPhone: import("react").Dispatch<import("react").SetStateAction<string>>;
+    request: {
+        textPhone: string;
+        method: "pickup";
+        locationId: string;
+    } | {
+        textPhone?: undefined;
+        method: "pickup";
+        locationId: string;
+    } | {
+        address?: {
+            line1: string;
+            postalCode: string;
+        };
+        windowStartMs?: number;
+        postalCode: string;
+        textPhone: string;
+        method: "local_delivery";
+    } | {
+        address?: {
+            line1: string;
+            postalCode: string;
+        };
+        windowStartMs?: number;
+        postalCode: string;
+        textPhone?: undefined;
+        method: "local_delivery";
+    };
+    ready: boolean;
+    signature: string;
+    reload: () => void;
+};
+export type CartFulfillmentState = ReturnType<typeof useCartFulfillment>;
+export declare function CartFulfillmentChoice(props: {
+    state: CartFulfillmentState;
+    formatCents: (cents: number) => string;
+}): import("react").JSX.Element;

package/src/lib/components/cart-fulfillment.js

@@ -0,0 +1,367 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * @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 Alert from "@mui/material/Alert";
+import Box from "@mui/material/Box";
+import FormControl from "@mui/material/FormControl";
+import FormControlLabel from "@mui/material/FormControlLabel";
+import FormLabel from "@mui/material/FormLabel";
+import MenuItem from "@mui/material/MenuItem";
+import Radio from "@mui/material/Radio";
+import RadioGroup from "@mui/material/RadioGroup";
+import TextField from "@mui/material/TextField";
+import Typography from "@mui/material/Typography";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { pickupReadyWithinLabel } from "../model/local-fulfillment-settings.js";
+const EMPTY = {
+    pickup: [],
+    delivery: null
+};
+export function useCartFulfillment(hostId, cartSignature, /**
+   * A product's Buy button asks for that product rather than the cart; `null`
+   * asks nothing (a subscription, a download).
+   */ buyNow) {
+    var _options_delivery;
+    const buyNowKey = buyNow === undefined ? '' : JSON.stringify(buyNow);
+    const [options, setOptions] = useState(EMPTY);
+    const [method, setMethod] = useState('shipping');
+    const [locationId, setLocationId] = useState('');
+    const [postalCode, setPostalCode] = useState('');
+    const [line1, setLine1] = useState('');
+    const [windowId, setWindowId] = useState('');
+    const [textPhone, setTextPhone] = useState('');
+    const [round, setRound] = useState(0);
+    // The postal code and street the quote below was asked for, settled after
+    // the shopper stops typing so a keystroke is not a request.
+    const [asked, setAsked] = useState({
+        postalCode: '',
+        line1: ''
+    });
+    useEffect(()=>{
+        const timer = setTimeout(()=>setAsked({
+                postalCode: postalCode.trim(),
+                line1: line1.trim()
+            }), 400);
+        return ()=>clearTimeout(timer);
+    }, [
+        postalCode,
+        line1
+    ]);
+    useEffect(()=>{
+        if (!hostId || cartSignature === '[]' || buyNow === null) {
+            setOptions(EMPTY);
+            return;
+        }
+        let live = true;
+        const wantsQuote = method === 'local_delivery' && asked.postalCode.length >= 3;
+        fetch('/api/commerce/local-fulfillment-options', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(_extends({
+                hostId
+            }, buyNow ? buyNow : {}, wantsQuote ? {
+                postalCode: asked.postalCode
+            } : {}, wantsQuote && asked.line1 ? {
+                address: {
+                    line1: asked.line1,
+                    postalCode: asked.postalCode
+                }
+            } : {}))
+        }).then((response)=>response.ok ? response.json() : EMPTY).then((payload)=>{
+            var _ref;
+            if (!live) return;
+            const next = {
+                pickup: Array.isArray(payload == null ? void 0 : payload.pickup) ? payload.pickup : [],
+                delivery: (_ref = payload == null ? void 0 : payload.delivery) != null ? _ref : null,
+                texts: Boolean(payload == null ? void 0 : payload.texts)
+            };
+            setOptions(next);
+            // A choice the store no longer offers falls back to shipping.
+            setMethod((prior)=>prior === 'pickup' && !next.pickup.length || prior === 'local_delivery' && !next.delivery ? 'shipping' : prior);
+            setLocationId((prior)=>{
+                var _ref;
+                var _next_pickup_;
+                return next.pickup.some((location)=>location.id === prior) ? prior : (_ref = (_next_pickup_ = next.pickup[0]) == null ? void 0 : _next_pickup_.id) != null ? _ref : '';
+            });
+            setWindowId((prior)=>{
+                var _next_delivery;
+                return ((_next_delivery = next.delivery) == null ? void 0 : _next_delivery.windows.some((window)=>window.id === prior)) ? prior : '';
+            });
+        }).catch(()=>live && setOptions(EMPTY));
+        return ()=>{
+            live = false;
+        };
+    // `buyNow` is read through its key.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        hostId,
+        cartSignature,
+        round,
+        method,
+        asked,
+        buyNowKey
+    ]);
+    const offered = options.pickup.length > 0 || Boolean(options.delivery);
+    const quote = (_options_delivery = options.delivery) == null ? void 0 : _options_delivery.quote;
+    const deliverable = Boolean(quote && !quote.unavailable && !(quote.shortfallCents && quote.shortfallCents > 0));
+    /** What the checkout is sent; `null` for a shipped order. */ const phone = options.texts && textPhone.trim() ? {
+        textPhone: textPhone.trim()
+    } : {};
+    const request = useMemo(()=>{
+        if (method === 'pickup' && locationId) return _extends({
+            method: 'pickup',
+            locationId
+        }, phone);
+        if (method === 'local_delivery') {
+            return _extends({
+                method: 'local_delivery'
+            }, phone, {
+                postalCode: postalCode.trim()
+            }, windowId ? {
+                windowStartMs: Number(windowId)
+            } : {}, line1.trim() ? {
+                address: {
+                    line1: line1.trim(),
+                    postalCode: postalCode.trim()
+                }
+            } : {});
+        }
+        return null;
+    // `phone` is derived from the two values listed.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        method,
+        locationId,
+        postalCode,
+        windowId,
+        line1,
+        textPhone,
+        options.texts
+    ]);
+    /** Whether the choice is complete enough to check out with. */ const ready = method === 'shipping' || method === 'pickup' && Boolean(locationId) || // The quote is the server's answer for what was typed: a zone that
+    // reaches it and an order that meets its minimum.
+    method === 'local_delivery' && Boolean(postalCode.trim()) && Boolean(windowId) && deliverable;
+    const signature = JSON.stringify(request);
+    const reload = useCallback(()=>setRound((value)=>value + 1), []);
+    return {
+        options,
+        offered,
+        method,
+        setMethod,
+        locationId,
+        setLocationId,
+        postalCode,
+        setPostalCode,
+        line1,
+        setLine1,
+        windowId,
+        setWindowId,
+        textPhone,
+        setTextPhone,
+        request,
+        ready,
+        signature,
+        reload
+    };
+}
+export function CartFulfillmentChoice(props) {
+    var _quote_minimumCents;
+    const { state, formatCents } = props;
+    const { options, method } = state;
+    if (!state.offered) return null;
+    const location = options.pickup.find((entry)=>entry.id === state.locationId);
+    const delivery = options.delivery;
+    const quote = delivery == null ? void 0 : delivery.quote;
+    return /*#__PURE__*/ _jsxs(Box, {
+        sx: {
+            display: 'flex',
+            flexDirection: 'column',
+            gap: 1
+        },
+        children: [
+            /*#__PURE__*/ _jsxs(FormControl, {
+                children: [
+                    /*#__PURE__*/ _jsx(FormLabel, {
+                        id: "cart-fulfillment-method",
+                        children: /*#__PURE__*/ _jsx(Typography, {
+                            variant: "subtitle2",
+                            component: "span",
+                            children: 'How do you want your order?'
+                        })
+                    }),
+                    /*#__PURE__*/ _jsxs(RadioGroup, {
+                        "aria-labelledby": "cart-fulfillment-method",
+                        value: method,
+                        onChange: (event)=>state.setMethod(event.target.value),
+                        children: [
+                            /*#__PURE__*/ _jsx(FormControlLabel, {
+                                value: "shipping",
+                                control: /*#__PURE__*/ _jsx(Radio, {
+                                    size: "small"
+                                }),
+                                label: "Ship it"
+                            }),
+                            options.pickup.length ? /*#__PURE__*/ _jsx(FormControlLabel, {
+                                value: "pickup",
+                                control: /*#__PURE__*/ _jsx(Radio, {
+                                    size: "small"
+                                }),
+                                label: options.pickup.length === 1 ? `Pick up at ${options.pickup[0].name}` : 'Pick up in store'
+                            }) : null,
+                            delivery ? /*#__PURE__*/ _jsx(FormControlLabel, {
+                                value: "local_delivery",
+                                control: /*#__PURE__*/ _jsx(Radio, {
+                                    size: "small"
+                                }),
+                                label: "Local delivery"
+                            }) : null
+                        ]
+                    })
+                ]
+            }),
+            method === 'pickup' ? /*#__PURE__*/ _jsxs(_Fragment, {
+                children: [
+                    options.pickup.length > 1 ? /*#__PURE__*/ _jsx(TextField, {
+                        select: true,
+                        label: "Pickup location",
+                        value: state.locationId,
+                        onChange: (event)=>state.setLocationId(event.target.value),
+                        size: "small",
+                        children: options.pickup.map((entry)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                value: entry.id,
+                                children: entry.name
+                            }, entry.id))
+                    }) : null,
+                    location ? /*#__PURE__*/ _jsxs(Box, {
+                        children: [
+                            location.address ? /*#__PURE__*/ _jsx(Typography, {
+                                variant: "body2",
+                                children: location.address
+                            }) : null,
+                            location.hours ? /*#__PURE__*/ _jsx(Typography, {
+                                variant: "caption",
+                                color: "text.secondary",
+                                component: "p",
+                                sx: {
+                                    whiteSpace: 'pre-line'
+                                },
+                                children: location.hours
+                            }) : null,
+                            location.readyWithinMinutes ? /*#__PURE__*/ _jsx(Typography, {
+                                variant: "caption",
+                                color: "text.secondary",
+                                component: "p",
+                                children: `${pickupReadyWithinLabel(location.readyWithinMinutes)}. We’ll email you when it’s ready.`
+                            }) : /*#__PURE__*/ _jsx(Typography, {
+                                variant: "caption",
+                                color: "text.secondary",
+                                component: "p",
+                                children: 'We’ll email you when it’s ready.'
+                            }),
+                            location.instructions ? /*#__PURE__*/ _jsx(Typography, {
+                                variant: "caption",
+                                color: "text.secondary",
+                                component: "p",
+                                children: location.instructions
+                            }) : null
+                        ]
+                    }) : null
+                ]
+            }) : null,
+            method !== 'shipping' && options.texts ? /*#__PURE__*/ _jsx(TextField, {
+                label: "Mobile number (optional)",
+                value: state.textPhone,
+                onChange: (event)=>state.setTextPhone(event.target.value),
+                size: "small",
+                helperText: method === 'pickup' ? 'We’ll text you when your order is ready' : 'We’ll text you when your order is on its way',
+                slotProps: {
+                    htmlInput: {
+                        autoComplete: 'tel',
+                        inputMode: 'tel',
+                        maxLength: 24
+                    }
+                }
+            }) : null,
+            method === 'local_delivery' && delivery ? /*#__PURE__*/ _jsxs(_Fragment, {
+                children: [
+                    /*#__PURE__*/ _jsx(TextField, {
+                        label: "Postal code",
+                        value: state.postalCode,
+                        onChange: (event)=>state.setPostalCode(event.target.value),
+                        size: "small",
+                        slotProps: {
+                            htmlInput: {
+                                autoComplete: 'shipping postal-code',
+                                maxLength: 12
+                            }
+                        }
+                    }),
+                    delivery.needsAddress ? /*#__PURE__*/ _jsx(TextField, {
+                        label: "Street address",
+                        value: state.line1,
+                        onChange: (event)=>state.setLine1(event.target.value),
+                        size: "small",
+                        helperText: "Delivery depends on the distance from the store",
+                        slotProps: {
+                            htmlInput: {
+                                autoComplete: 'shipping address-line1',
+                                maxLength: 120
+                            }
+                        }
+                    }) : null,
+                    (quote == null ? void 0 : quote.unavailable) ? /*#__PURE__*/ _jsx(Alert, {
+                        severity: "info",
+                        children: quote.unavailable
+                    }) : null,
+                    quote && !quote.unavailable ? quote.shortfallCents && quote.shortfallCents > 0 ? /*#__PURE__*/ _jsx(Alert, {
+                        severity: "info",
+                        children: `Delivery needs an order of at least ${formatCents((_quote_minimumCents = quote.minimumCents) != null ? _quote_minimumCents : 0)}. ` + `Add ${formatCents(quote.shortfallCents)} more.`
+                    }) : /*#__PURE__*/ _jsxs(Typography, {
+                        variant: "body2",
+                        children: [
+                            quote.feeCents ? `Delivery: ${formatCents(quote.feeCents)}` : 'Delivery: free',
+                            quote.freeOverCents && quote.feeCents ? ` (free over ${formatCents(quote.freeOverCents)})` : ''
+                        ]
+                    }) : null,
+                    delivery.windows.length ? /*#__PURE__*/ _jsx(TextField, {
+                        select: true,
+                        label: "Delivery time",
+                        value: state.windowId,
+                        onChange: (event)=>state.setWindowId(event.target.value),
+                        size: "small",
+                        children: delivery.windows.map((window)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                value: window.id,
+                                children: window.label
+                            }, window.id))
+                    }) : /*#__PURE__*/ _jsx(Alert, {
+                        severity: "info",
+                        children: 'No delivery times are open right now.'
+                    }),
+                    delivery.instructions ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        color: "text.secondary",
+                        children: delivery.instructions
+                    }) : null
+                ]
+            }) : null
+        ]
+    });
+}
+
+//# sourceMappingURL=cart-fulfillment.js.map