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

package/src/lib/components/console/return-detail-dialog.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/return-detail-dialog.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\n'use client'\n\nimport * as CommerceModel from '../../model'\nimport { useConfirmationContext } from '@aglyn/shared-ui-jsx'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  type ConsoleWidgetSlotRenderer,\n  useConsoleWidgetSlot,\n} from '@aglyn/aglyn/app-utils/console-widget-slot-context'\nimport {\n  Button,\n  Checkbox,\n  Chip,\n  Dialog,\n  DialogActions,\n  DialogContent,\n  DialogTitle,\n  Divider,\n  FormControlLabel,\n  InputAdornment,\n  Link,\n  MenuItem,\n  Stack,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { collection, doc, limit, query } from 'firebase/firestore'\nimport { memo, useCallback, useMemo, useState } from 'react'\nimport {\n  useFirestore,\n  useFirestoreCollection,\n  useFirestoreDoc,\n  useUser,\n} from '@aglyn/tenant-feature-instance'\nimport { formatMoney, postReturnAction } from './return-actions'\nimport {\n  type ConsoleReturnLabelRequest,\n  type ConsoleReturnZoneReturn,\n  RETURN_DETAIL_ZONE,\n} from './return-zones'\n\nexport interface ReturnDetailDialogProps {\n  hostId: string\n  /** The return to show; `null` keeps the dialog closed. */\n  returnId: string | null\n  onClose: () => void\n}\n\n/** The locations a receive may restock to — the locations card's own window. */\nconst LOCATION_WINDOW = 25\n\n/** The panel open beneath the details, one at a time. */\ntype Panel = 'approve' | 'decline' | 'receive' | 'refund' | null\n\n/**\n * A zone hosted in the dialog, drawn again only when what it is handed\n * changes — the order dialog's reasoning: the shell's renderer is not\n * memoized, and the dialog redraws on every keystroke in its fields.\n */\nconst HostedZone = memo(function HostedZone(\n  props: { renderer: ConsoleWidgetSlotRenderer; slot: string } & Record<string, unknown>,\n) {\n  const { renderer: Renderer, ...zone } = props\n  return <Renderer {...zone} />\n})\n\nconst centsFromInput = (value: string) => Math.round(Number(value) * 100)\n\n/**\n * One return (AGL-3611): what is coming back and why, the notes on both\n * sides, the label and the restock, its timeline, and the actions its state\n * allows (`canTransitionReturn`). Every action is the returns route — the\n * return is never written from here — and the dialog reads the return live,\n * so what the route wrote is what it shows next.\n */\nexport function ReturnDetailDialog(props: ReturnDetailDialogProps) {\n  const { hostId, returnId, onClose } = props\n  const firestore = useFirestore()\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const { confirm } = useConfirmationContext()\n  const WidgetSlot = useConsoleWidgetSlot()\n\n  const { data: entry } = useFirestoreDoc<CommerceModel.HostReturn>(\n    () => (returnId ? doc(firestore, 'hosts', hostId, 'returns', returnId) : null),\n    [firestore, hostId, returnId],\n  )\n  const orderId = entry?.orderId ?? null\n  const { data: rawOrder } = useFirestoreDoc<CommerceModel.HostOrder>(\n    () => (orderId ? doc(firestore, 'hosts', hostId, 'orders', orderId) : null),\n    [firestore, hostId, orderId],\n  )\n  const { data: store } = useFirestoreDoc<Record<string, any>>(\n    () => (returnId ? doc(firestore, 'hosts', hostId, 'settings', 'store') : null),\n    [firestore, hostId, returnId],\n  )\n  const [panel, setPanel] = useState<Panel>(null)\n  // The locations are read only to set up a receive, or to name the one a\n  // receive restocked to.\n  const readLocations = panel === 'receive' || Boolean(entry?.restock?.locationId)\n  const { data: locationDocs } = useFirestoreCollection<any>(\n    () =>\n      readLocations\n        ? query(collection(firestore, 'hosts', hostId, 'locations'), limit(LOCATION_WINDOW))\n        : null,\n    [firestore, hostId, readLocations],\n    { idField: '$id' },\n  )\n  const locations = useMemo(\n    () =>\n      [...(locationDocs ?? [])].sort((a: any, b: any) =>\n        String(a.name ?? '').localeCompare(String(b.name ?? '')),\n      ),\n    [locationDocs],\n  )\n\n  const order = useMemo(\n    () => (rawOrder ? CommerceModel.liftLegacyOrder(rawOrder as never) : null),\n    [rawOrder],\n  )\n  const currency = String(store?.currency ?? 'USD').toUpperCase()\n  const [busy, setBusy] = useState(false)\n  const [buyerNote, setBuyerNote] = useState('')\n  const [notify, setNotify] = useState(true)\n  const [restock, setRestock] = useState<Record<number, string>>({})\n  const [locationId, setLocationId] = useState('')\n  const [amount, setAmount] = useState('')\n  const [merchantNote, setMerchantNote] = useState<string | null>(null)\n\n  const lineName = useCallback(\n    (lineItemId: number) => {\n      const line = order?.lineItems?.[lineItemId]\n      if (!line) return `Line ${lineItemId + 1}`\n      return line.variantLabel ? `${line.name} — ${line.variantLabel}` : line.name\n    },\n    [order],\n  )\n\n  const suggestedRefundCents = useMemo(\n    () => (order && entry ? CommerceModel.returnRefundCents(order, entry.lines ?? []) : 0),\n    [order, entry],\n  )\n\n  const run = useCallback(\n    async (body: Record<string, unknown>, done: string) => {\n      if (!returnId) return false\n      setBusy(true)\n      try {\n        const outcome = await postReturnAction(user, { hostId, returnId, ...body })\n        if (!outcome.ok) {\n          enqueueSnackbar(outcome.message, {\n            variant: outcome.refused ? 'warning' : 'error',\n            allowDuplicate: true,\n          })\n          return false\n        }\n        enqueueSnackbar(outcome.payload['already'] ? 'Nothing to change — already done' : done, {\n          variant: 'success',\n          persist: false,\n        })\n        setPanel(null)\n        return true\n      } finally {\n        setBusy(false)\n      }\n    },\n    [returnId, user, hostId, enqueueSnackbar],\n  )\n\n  const openPanel = useCallback(\n    (next: Panel) => {\n      setPanel(next)\n      setBuyerNote('')\n      setNotify(true)\n      if (next === 'receive' && entry) {\n        setRestock(\n          Object.fromEntries(entry.lines.map((line) => [line.lineItemId, String(line.quantity)])),\n        )\n        setLocationId('')\n      }\n      if (next === 'refund') setAmount((suggestedRefundCents / 100).toFixed(2))\n    },\n    [entry, suggestedRefundCents],\n  )\n\n  const handleDecision = useCallback(\n    (action: 'approve' | 'decline') =>\n      run(\n        {\n          action,\n          ...(buyerNote.trim() ? { merchantNote: buyerNote.trim() } : {}),\n          notify,\n        },\n        action === 'approve' ? 'Return approved' : 'Return declined',\n      ),\n    [run, buyerNote, notify],\n  )\n\n  const defaultLocationId =\n    locations.find((location: any) => location.isDefault)?.$id ?? locations[0]?.$id ?? ''\n  const handleReceive = useCallback(() => {\n    if (!entry) return\n    const chosen = locationId || defaultLocationId\n    return run(\n      {\n        action: 'receive',\n        restock: entry.lines.map((line) => ({\n          lineItemId: line.lineItemId,\n          quantity: Math.max(0, Math.floor(Number(restock[line.lineItemId] ?? 0) || 0)),\n        })),\n        ...(chosen ? { locationId: chosen } : {}),\n      },\n      'Return received',\n    )\n  }, [entry, restock, locationId, defaultLocationId, run])\n\n  const refundCents = centsFromInput(amount)\n  const refundValid = Number.isInteger(refundCents) && refundCents > 0\n  const handleRefund = useCallback(async () => {\n    if (!refundValid) return\n    const confirmed = await confirm({\n      title: 'Refund this return?',\n      description:\n        `Refunds ${formatMoney(refundCents, currency)} to the buyer through Stripe, ` +\n        'through the order’s own refund. The buyer is emailed.',\n      confirmationText: 'Refund',\n      confirmationButtonProps: { color: 'error' },\n    })\n      .then(() => true)\n      .catch(() => false)\n    if (!confirmed) return\n    await run({ action: 'refund', amountCents: refundCents }, 'Refund issued')\n  }, [confirm, refundValid, refundCents, currency, run])\n\n  const noteDraft = merchantNote ?? entry?.merchantNote ?? ''\n  const handleSaveNote = useCallback(async () => {\n    const saved = await run({ action: 'note', merchantNote: noteDraft.trim() }, 'Note saved')\n    if (saved) setMerchantNote(null)\n  }, [run, noteDraft])\n\n  const attachReturnLabel = useCallback(\n    async (label: ConsoleReturnLabelRequest) => {\n      if (!returnId) throw new Error('No return is open')\n      const outcome = await postReturnAction(user, {\n        hostId,\n        returnId,\n        action: 'attach-label',\n        label: {\n          carrier: label.carrier,\n          trackingNumber: label.trackingNumber,\n          labelUrl: label.labelUrl,\n          ...(label.trackingUrl ? { trackingUrl: label.trackingUrl } : {}),\n        },\n      })\n      if (!outcome.ok) throw new Error(outcome.message)\n    },\n    [user, hostId, returnId],\n  )\n\n  const zoneReturn = useMemo((): ConsoleReturnZoneReturn | null => {\n    if (!entry || !returnId) return null\n    const address = order?.shippingAddress\n    return {\n      id: returnId,\n      status: entry.status,\n      orderId: entry.orderId,\n      orderNumber: entry.orderNumber,\n      customerName: entry.customerName ?? null,\n      customerEmail: entry.customerEmail ?? null,\n      lines: (entry.lines ?? []).map((line) => ({\n        lineItemId: line.lineItemId,\n        name: order?.lineItems?.[line.lineItemId]?.name ?? `Line ${line.lineItemId + 1}`,\n        variantLabel: order?.lineItems?.[line.lineItemId]?.variantLabel ?? null,\n        quantity: line.quantity,\n        reason: line.reason,\n      })),\n      fromAddress: address\n        ? {\n            name: address.name ?? null,\n            line1: address.line1 ?? null,\n            line2: address.line2 ?? null,\n            city: address.city ?? null,\n            state: address.state ?? null,\n            postalCode: address.postalCode ?? null,\n            country: address.country ?? null,\n            phone: address.phone ?? null,\n          }\n        : null,\n      returnLabel: entry.returnLabel\n        ? {\n            carrier: entry.returnLabel.carrier,\n            trackingNumber: entry.returnLabel.trackingNumber,\n            labelUrl: entry.returnLabel.labelUrl,\n            trackingUrl: entry.returnLabel.trackingUrl ?? null,\n            attachedAtMs: entry.returnLabel.attachedAtMs,\n          }\n        : null,\n    }\n  }, [entry, order, returnId])\n\n  if (!returnId) return null\n  const status = entry?.status\n  const can = (to: CommerceModel.ReturnStatus) =>\n    Boolean(status) && CommerceModel.canTransitionReturn(status as CommerceModel.ReturnStatus, to)\n  const restockLocationName = entry?.restock?.locationId\n    ? (locations.find((location: any) => location.$id === entry.restock?.locationId)?.name ??\n      null)\n    : null\n\n  return (\n    <Dialog open onClose={onClose} maxWidth=\"sm\" fullWidth>\n      <DialogTitle>\n        <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n          <span>{entry ? `Return for order ${entry.orderNumber}` : 'Return'}</span>\n          {status ? (\n            <Chip\n              label={CommerceModel.RETURN_STATUS_LABELS[status] ?? status}\n              size=\"small\"\n              color={CommerceModel.RETURN_STATUS_COLOR[status] ?? 'default'}\n              variant=\"outlined\"\n            />\n          ) : null}\n        </Stack>\n      </DialogTitle>\n      <DialogContent sx={{ display: 'flex', flexDirection: 'column', gap: 1.5 }}>\n        {!entry ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {'Loading the return…'}\n          </Typography>\n        ) : (\n          <>\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {[entry.customerName, entry.customerEmail].filter(Boolean).join(' · ') ||\n                'Guest buyer'}\n              {entry.requestedBy === 'merchant' ? ' · Opened by the store' : ''}\n            </Typography>\n            {(entry.lines ?? []).map((line) => (\n              <Stack\n                key={line.lineItemId}\n                direction=\"row\"\n                spacing={1}\n                sx={{ alignItems: 'center' }}\n              >\n                <Typography variant=\"body2\" sx={{ flex: 1 }}>\n                  {`${line.quantity}× ${lineName(line.lineItemId)}`}\n                </Typography>\n                <Chip\n                  label={CommerceModel.RETURN_REASON_LABELS[line.reason] ?? line.reason}\n                  size=\"small\"\n                  variant=\"outlined\"\n                />\n              </Stack>\n            ))}\n            {entry.customerNote ? (\n              <Stack spacing={0.5}>\n                <Typography variant=\"subtitle2\">{'Customer note'}</Typography>\n                <Typography variant=\"body2\" color=\"text.secondary\">\n                  {entry.customerNote}\n                </Typography>\n              </Stack>\n            ) : null}\n            {entry.returnLabel ? (\n              <Stack spacing={0.5}>\n                <Typography variant=\"subtitle2\">{'Return label'}</Typography>\n                <Typography variant=\"body2\" color=\"text.secondary\">\n                  {`${entry.returnLabel.carrier} · ${entry.returnLabel.trackingNumber}`}\n                </Typography>\n                <Stack direction=\"row\" spacing={2}>\n                  <Link href={entry.returnLabel.labelUrl} target=\"_blank\" rel=\"noopener noreferrer\">\n                    {'Print label'}\n                  </Link>\n                  {entry.returnLabel.trackingUrl ? (\n                    <Link\n                      href={entry.returnLabel.trackingUrl}\n                      target=\"_blank\"\n                      rel=\"noopener noreferrer\"\n                    >\n                      {'Track parcel'}\n                    </Link>\n                  ) : null}\n                </Stack>\n              </Stack>\n            ) : null}\n            {entry.restock ? (\n              <Stack spacing={0.5}>\n                <Typography variant=\"subtitle2\">{'Restocked'}</Typography>\n                <Typography variant=\"body2\" color=\"text.secondary\">\n                  {entry.restock.lines.length\n                    ? entry.restock.lines\n                        .map((line) => `${line.quantity}× ${lineName(line.lineItemId)}`)\n                        .join(', ')\n                    : 'Nothing went back on the shelf'}\n                  {restockLocationName ? ` at ${restockLocationName}` : ''}\n                  {` · ${new Date(entry.restock.atMs).toLocaleDateString()}`}\n                </Typography>\n              </Stack>\n            ) : null}\n            {entry.refundedAtMs ? (\n              <Typography variant=\"body2\" color=\"text.secondary\">\n                {`Refunded ${formatMoney(entry.refundCents ?? 0, currency)} on ${new Date(\n                  entry.refundedAtMs,\n                ).toLocaleDateString()}`}\n              </Typography>\n            ) : null}\n            <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'flex-start' }}>\n              <TextField\n                label=\"Merchant note\"\n                value={noteDraft}\n                onChange={(event) => setMerchantNote(event.target.value)}\n                size=\"small\"\n                multiline\n                sx={{ flex: 1 }}\n                slotProps={{ htmlInput: { maxLength: CommerceModel.RETURN_NOTE_MAX } }}\n              />\n              <Button\n                size=\"small\"\n                disabled={busy || merchantNote === null}\n                onClick={handleSaveNote}\n              >\n                {'Save note'}\n              </Button>\n            </Stack>\n\n            {panel === 'approve' || panel === 'decline' ? (\n              <Stack spacing={1}>\n                <Divider />\n                <TextField\n                  label=\"Note to the customer (optional)\"\n                  value={buyerNote}\n                  onChange={(event) => setBuyerNote(event.target.value)}\n                  size=\"small\"\n                  multiline\n                  minRows={2}\n                  slotProps={{ htmlInput: { maxLength: CommerceModel.RETURN_NOTE_MAX } }}\n                />\n                <FormControlLabel\n                  control={\n                    <Checkbox\n                      checked={notify}\n                      onChange={(event) => setNotify(event.target.checked)}\n                    />\n                  }\n                  label=\"Notify customer\"\n                />\n                <Stack direction=\"row\" spacing={1}>\n                  <Button\n                    variant=\"contained\"\n                    color={panel === 'decline' ? 'error' : 'primary'}\n                    disabled={busy}\n                    onClick={() => handleDecision(panel)}\n                  >\n                    {panel === 'approve' ? 'Approve return' : 'Decline return'}\n                  </Button>\n                  <Button disabled={busy} onClick={() => setPanel(null)}>\n                    {'Back'}\n                  </Button>\n                </Stack>\n              </Stack>\n            ) : null}\n\n            {panel === 'receive' ? (\n              <Stack spacing={1}>\n                <Divider />\n                <Typography variant=\"subtitle2\">{'Put back on the shelf'}</Typography>\n                {entry.lines.map((line) => (\n                  <Stack\n                    key={line.lineItemId}\n                    direction=\"row\"\n                    spacing={1}\n                    sx={{ alignItems: 'center' }}\n                  >\n                    <Typography variant=\"body2\" sx={{ flex: 1 }}>\n                      {lineName(line.lineItemId)}\n                    </Typography>\n                    <TextField\n                      label={`Restock (of ${line.quantity})`}\n                      type=\"number\"\n                      size=\"small\"\n                      value={restock[line.lineItemId] ?? ''}\n                      onChange={(event) =>\n                        setRestock((prior) => ({ ...prior, [line.lineItemId]: event.target.value }))\n                      }\n                      slotProps={{ htmlInput: { min: 0, max: line.quantity, step: 1 } }}\n                      sx={{ width: 150 }}\n                    />\n                  </Stack>\n                ))}\n                {locations.length > 0 ? (\n                  <TextField\n                    label=\"Location\"\n                    select\n                    size=\"small\"\n                    value={locationId || defaultLocationId}\n                    onChange={(event) => setLocationId(event.target.value)}\n                    sx={{ maxWidth: 280 }}\n                  >\n                    {locations.map((location: any) => (\n                      <MenuItem key={location.$id} value={location.$id}>\n                        {location.name ?? location.$id}\n                      </MenuItem>\n                    ))}\n                  </TextField>\n                ) : null}\n                <Stack direction=\"row\" spacing={1}>\n                  <Button variant=\"contained\" color=\"primary\" disabled={busy} onClick={handleReceive}>\n                    {'Confirm received'}\n                  </Button>\n                  <Button disabled={busy} onClick={() => setPanel(null)}>\n                    {'Back'}\n                  </Button>\n                </Stack>\n              </Stack>\n            ) : null}\n\n            {panel === 'refund' ? (\n              <Stack spacing={1}>\n                <Divider />\n                <TextField\n                  label=\"Refund amount\"\n                  type=\"number\"\n                  size=\"small\"\n                  value={amount}\n                  onChange={(event) => setAmount(event.target.value)}\n                  error={!refundValid}\n                  helperText={\n                    `Suggested ${formatMoney(suggestedRefundCents, currency)} — what the returned ` +\n                    'items were paid, shipping and tax left out. Change it to refund more or less.'\n                  }\n                  slotProps={{\n                    htmlInput: { min: 0, step: 0.01 },\n                    input: {\n                      startAdornment: <InputAdornment position=\"start\">{currency}</InputAdornment>,\n                    },\n                  }}\n                  sx={{ maxWidth: 360 }}\n                />\n                <Stack direction=\"row\" spacing={1}>\n                  <Button\n                    variant=\"contained\"\n                    color=\"error\"\n                    disabled={busy || !refundValid}\n                    onClick={handleRefund}\n                  >\n                    {'Refund'}\n                  </Button>\n                  <Button disabled={busy} onClick={() => setPanel(null)}>\n                    {'Back'}\n                  </Button>\n                </Stack>\n              </Stack>\n            ) : null}\n\n            {/*\n              The return zone (AGL-3611): a shipping plugin's widget buys the\n              buyer a label and attaches it through `attachReturnLabel`, this\n              dialog's own route.\n            */}\n            {WidgetSlot && zoneReturn ? (\n              <HostedZone\n                renderer={WidgetSlot}\n                slot={RETURN_DETAIL_ZONE.id}\n                hostId={hostId}\n                orgId={undefined}\n                return={zoneReturn}\n                attachReturnLabel={attachReturnLabel}\n              />\n            ) : null}\n\n            <Divider />\n            <Typography variant=\"subtitle2\">{'Timeline'}</Typography>\n            {(entry.timeline ?? [])\n              .slice()\n              .reverse()\n              .map((event, index) => (\n                <Typography key={index} variant=\"caption\" color=\"text.secondary\">\n                  {`${new Date(event.atMs).toLocaleString()} — ${event.event}` +\n                    (event.detail ? `: ${event.detail}` : '')}\n                </Typography>\n              ))}\n          </>\n        )}\n      </DialogContent>\n      <DialogActions>\n        {can('closed') ? (\n          <Button\n            disabled={busy}\n            onClick={() => run({ action: 'close' }, 'Return closed')}\n          >\n            {'Close return'}\n          </Button>\n        ) : null}\n        {can('declined') && panel === null ? (\n          <Button color=\"error\" disabled={busy} onClick={() => openPanel('decline')}>\n            {'Decline'}\n          </Button>\n        ) : null}\n        {can('refunded') && panel === null ? (\n          <Button color=\"error\" disabled={busy || !order} onClick={() => openPanel('refund')}>\n            {'Refund…'}\n          </Button>\n        ) : null}\n        {can('received') && panel === null ? (\n          <Button disabled={busy} onClick={() => openPanel('receive')}>\n            {'Mark received…'}\n          </Button>\n        ) : null}\n        {can('approved') && panel === null ? (\n          <Button\n            variant=\"contained\"\n            color=\"primary\"\n            disabled={busy}\n            onClick={() => openPanel('approve')}\n          >\n            {'Approve'}\n          </Button>\n        ) : null}\n        <Button onClick={onClose}>{'Done'}</Button>\n      </DialogActions>\n    </Dialog>\n  )\n}\nReturnDetailDialog.displayName = 'ReturnDetailDialog'\n\nexport default ReturnDetailDialog\n"],"names":["CommerceModel","useConfirmationContext","useSnackbar","useConsoleWidgetSlot","Button","Checkbox","Chip","Dialog","DialogActions","DialogContent","DialogTitle","Divider","FormControlLabel","InputAdornment","Link","MenuItem","Stack","TextField","Typography","collection","doc","limit","query","memo","useCallback","useMemo","useState","useFirestore","useFirestoreCollection","useFirestoreDoc","useUser","formatMoney","postReturnAction","RETURN_DETAIL_ZONE","LOCATION_WINDOW","HostedZone","props","renderer","Renderer","zone","centsFromInput","value","Math","round","Number","ReturnDetailDialog","locations","merchantNote","entry","hostId","returnId","onClose","firestore","data","user","enqueueSnackbar","confirm","WidgetSlot","orderId","rawOrder","store","panel","setPanel","readLocations","Boolean","restock","locationId","locationDocs","idField","sort","a","b","String","name","localeCompare","order","liftLegacyOrder","currency","toUpperCase","busy","setBusy","buyerNote","setBuyerNote","notify","setNotify","setRestock","setLocationId","amount","setAmount","setMerchantNote","lineName","lineItemId","line","lineItems","variantLabel","suggestedRefundCents","returnRefundCents","lines","run","body","done","outcome","ok","message","variant","refused","allowDuplicate","payload","persist","openPanel","next","Object","fromEntries","map","quantity","toFixed","handleDecision","action","trim","defaultLocationId","find","location","isDefault","$id","handleReceive","chosen","max","floor","refundCents","refundValid","isInteger","handleRefund","confirmed","title","description","confirmationText","confirmationButtonProps","color","then","catch","amountCents","noteDraft","handleSaveNote","saved","attachReturnLabel","label","Error","carrier","trackingNumber","labelUrl","trackingUrl","zoneReturn","address","shippingAddress","id","status","orderNumber","customerName","customerEmail","reason","fromAddress","line1","line2","city","state","postalCode","country","phone","returnLabel","attachedAtMs","can","to","canTransitionReturn","restockLocationName","open","maxWidth","fullWidth","direction","spacing","sx","alignItems","span","RETURN_STATUS_LABELS","size","RETURN_STATUS_COLOR","display","flexDirection","gap","filter","join","requestedBy","flex","RETURN_REASON_LABELS","customerNote","href","target","rel","length","Date","atMs","toLocaleDateString","refundedAtMs","onChange","event","multiline","slotProps","htmlInput","maxLength","RETURN_NOTE_MAX","disabled","onClick","minRows","control","checked","type","prior","min","step","width","select","error","helperText","input","startAdornment","position","slot","orgId","undefined","return","timeline","slice","reverse","index","toLocaleString","detail","displayName"],"mappings":"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"}

package/src/lib/components/console/return-settings-card.component.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @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.
+ */
+export interface ReturnSettingsCardProps {
+    hostId: string;
+}
+/**
+ * Return settings (AGL-3611) on `hosts/{hostId}/settings/store` `returns`:
+ * whether buyers may ask for a return online, for how many days after the
+ * order shipped, and which product types. The rules are the buyer's alone —
+ * a merchant may start a return on any order from the order dialog.
+ *
+ * Written as the store settings card writes the same document: guarded by a
+ * server-confirmed seed, merged so the other cards' fields stay, and with the
+ * site's cache drop, since the buyer's account page offers returns from it.
+ */
+export declare function ReturnSettingsCard(props: ReturnSettingsCardProps): import("react").JSX.Element;
+export declare namespace ReturnSettingsCard {
+    var displayName: string;
+}
+export default ReturnSettingsCard;

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

@@ -0,0 +1,195 @@
+/**
+ * @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 } from "react/jsx-runtime";
+import * as CommerceModel from "../../model/index.js";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { Button, Checkbox, FormControlLabel, FormGroup, FormLabel, Stack, Switch, TextField } from "@mui/material";
+import { doc } from "firebase/firestore";
+import { useCallback, useMemo, useState } from "react";
+import { useFirestore, useFirestoreDoc, useUser, writeGuardedBySeed } from "@aglyn/tenant-feature-instance";
+import { pluginDocsHelp } from "@aglyn/aglyn";
+import { writeSiteWideChange } from "@aglyn/tenant-feature-instance/hooks/helpers/site-wide-change";
+const PRODUCT_TYPE_LABELS = {
+    physical: 'Physical products',
+    digital: 'Digital products',
+    service: 'Services'
+};
+/**
+ * Return settings (AGL-3611) on `hosts/{hostId}/settings/store` `returns`:
+ * whether buyers may ask for a return online, for how many days after the
+ * order shipped, and which product types. The rules are the buyer's alone —
+ * a merchant may start a return on any order from the order dialog.
+ *
+ * Written as the store settings card writes the same document: guarded by a
+ * server-confirmed seed, merged so the other cards' fields stay, and with the
+ * site's cache drop, since the buyer's account page offers returns from it.
+ */ export function ReturnSettingsCard(props) {
+    const { hostId } = props;
+    const firestore = useFirestore();
+    const { data: user } = useUser();
+    const { enqueueSnackbar } = useSnackbar();
+    const { data: store, status: storeStatus, fromCache: storeFromCache } = useFirestoreDoc(()=>doc(firestore, 'hosts', hostId, 'settings', 'store'), [
+        firestore,
+        hostId
+    ]);
+    const [draft, setDraft] = useState(null);
+    const current = useMemo(()=>{
+        if (draft) return draft;
+        const saved = CommerceModel.readReturnSettings(store == null ? void 0 : store.returns);
+        return {
+            enabled: saved.enabled,
+            windowDays: String(saved.windowDays),
+            eligibleTypes: saved.eligibleTypes
+        };
+    }, [
+        draft,
+        store
+    ]);
+    const update = (patch)=>setDraft(_extends({}, current, patch));
+    const days = Number(current.windowDays);
+    const daysValid = current.windowDays.trim() !== '' && Number.isInteger(days) && days >= 0 && days <= CommerceModel.RETURN_WINDOW_MAX_DAYS;
+    const toggleType = (type, on)=>update({
+            eligibleTypes: on ? [
+                ...current.eligibleTypes.filter((entry)=>entry !== type),
+                type
+            ] : current.eligibleTypes.filter((entry)=>entry !== type)
+        });
+    const handleSave = useCallback(async ()=>{
+        if (!daysValid) return;
+        const verdict = await writeGuardedBySeed({
+            subject: 'return settings',
+            unreadable: storeStatus === 'error',
+            fromCache: storeFromCache
+        }, async ()=>{
+            await writeSiteWideChange({
+                firestore,
+                user,
+                hostId,
+                write: (batch)=>batch.set(doc(firestore, 'hosts', hostId, 'settings', 'store'), {
+                        returns: {
+                            enabled: current.enabled,
+                            windowDays: days,
+                            eligibleTypes: [
+                                'physical',
+                                'digital',
+                                'service'
+                            ].filter((type)=>current.eligibleTypes.includes(type))
+                        }
+                    }, {
+                        merge: true
+                    })
+            });
+        });
+        if (!verdict.ok) {
+            return void enqueueSnackbar(verdict.message, {
+                variant: 'warning',
+                persist: false
+            });
+        }
+        setDraft(null);
+        enqueueSnackbar('Return settings saved', {
+            variant: 'success',
+            persist: false
+        });
+    }, [
+        daysValid,
+        storeStatus,
+        storeFromCache,
+        firestore,
+        user,
+        hostId,
+        current,
+        days,
+        enqueueSnackbar
+    ]);
+    return /*#__PURE__*/ _jsx(CardDisplay, {
+        header: 'Returns',
+        help: pluginDocsHelp('ordersAndReturns', {
+            anchor: '#buyer-requests'
+        }),
+        contentGutterX: true,
+        contentGutterY: true,
+        children: /*#__PURE__*/ _jsxs(Stack, {
+            spacing: 1.5,
+            children: [
+                /*#__PURE__*/ _jsx(FormControlLabel, {
+                    control: /*#__PURE__*/ _jsx(Switch, {
+                        size: "small",
+                        checked: current.enabled,
+                        onChange: (event)=>update({
+                                enabled: event.target.checked
+                            })
+                    }),
+                    label: "Accept return requests online"
+                }),
+                /*#__PURE__*/ _jsx(TextField, {
+                    label: "Return window in days",
+                    type: "number",
+                    value: current.windowDays,
+                    onChange: (event)=>update({
+                            windowDays: event.target.value
+                        }),
+                    size: "small",
+                    error: !daysValid,
+                    helperText: `Days after the order shipped (or was placed, when nothing ships), 0–${CommerceModel.RETURN_WINDOW_MAX_DAYS}`,
+                    slotProps: {
+                        htmlInput: {
+                            min: 0,
+                            max: CommerceModel.RETURN_WINDOW_MAX_DAYS,
+                            step: 1
+                        }
+                    },
+                    sx: {
+                        maxWidth: 320
+                    }
+                }),
+                /*#__PURE__*/ _jsxs(FormGroup, {
+                    children: [
+                        /*#__PURE__*/ _jsx(FormLabel, {
+                            children: 'Returnable product types'
+                        }),
+                        Object.keys(PRODUCT_TYPE_LABELS).map((type)=>/*#__PURE__*/ _jsx(FormControlLabel, {
+                                control: /*#__PURE__*/ _jsx(Checkbox, {
+                                    size: "small",
+                                    checked: current.eligibleTypes.includes(type),
+                                    onChange: (event)=>toggleType(type, event.target.checked)
+                                }),
+                                label: PRODUCT_TYPE_LABELS[type]
+                            }, type))
+                    ]
+                }),
+                /*#__PURE__*/ _jsx(Button, {
+                    variant: "contained",
+                    color: "primary",
+                    size: "small",
+                    disabled: !draft || !daysValid,
+                    onClick: handleSave,
+                    sx: {
+                        alignSelf: 'flex-start'
+                    },
+                    children: 'Save return settings'
+                })
+            ]
+        })
+    });
+}
+ReturnSettingsCard.displayName = 'ReturnSettingsCard';
+export default ReturnSettingsCard;
+
+//# sourceMappingURL=return-settings-card.component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/return-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\n'use client'\n\nimport * as CommerceModel from '../../model'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport {\n  Button,\n  Checkbox,\n  FormControlLabel,\n  FormGroup,\n  FormLabel,\n  Stack,\n  Switch,\n  TextField,\n} from '@mui/material'\nimport { doc } from 'firebase/firestore'\nimport { useCallback, useMemo, useState } from 'react'\nimport {\n  useFirestore,\n  useFirestoreDoc,\n  useUser,\n  writeGuardedBySeed,\n} from '@aglyn/tenant-feature-instance'\nimport { pluginDocsHelp } from '@aglyn/aglyn'\nimport { writeSiteWideChange } from '@aglyn/tenant-feature-instance/hooks/helpers/site-wide-change'\nimport type { ProductType } from '../../model/commerce'\n\nexport interface ReturnSettingsCardProps {\n  hostId: string\n}\n\nconst PRODUCT_TYPE_LABELS: Record<ProductType, string> = {\n  physical: 'Physical products',\n  digital: 'Digital products',\n  service: 'Services',\n}\n\n/**\n * Return settings (AGL-3611) on `hosts/{hostId}/settings/store` `returns`:\n * whether buyers may ask for a return online, for how many days after the\n * order shipped, and which product types. The rules are the buyer's alone —\n * a merchant may start a return on any order from the order dialog.\n *\n * Written as the store settings card writes the same document: guarded by a\n * server-confirmed seed, merged so the other cards' fields stay, and with the\n * site's cache drop, since the buyer's account page offers returns from it.\n */\nexport function ReturnSettingsCard(props: ReturnSettingsCardProps) {\n  const { hostId } = props\n  const firestore = useFirestore()\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const {\n    data: store,\n    status: storeStatus,\n    fromCache: storeFromCache,\n  } = useFirestoreDoc<any>(\n    () => doc(firestore, 'hosts', hostId, 'settings', 'store'),\n    [firestore, hostId],\n  )\n  const [draft, setDraft] = useState<{\n    enabled: boolean\n    windowDays: string\n    eligibleTypes: ProductType[]\n  } | null>(null)\n  const current = useMemo(() => {\n    if (draft) return draft\n    const saved = CommerceModel.readReturnSettings(store?.returns)\n    return {\n      enabled: saved.enabled,\n      windowDays: String(saved.windowDays),\n      eligibleTypes: saved.eligibleTypes,\n    }\n  }, [draft, store])\n  const update = (patch: Partial<typeof current>) => setDraft({ ...current, ...patch })\n\n  const days = Number(current.windowDays)\n  const daysValid =\n    current.windowDays.trim() !== '' &&\n    Number.isInteger(days) &&\n    days >= 0 &&\n    days <= CommerceModel.RETURN_WINDOW_MAX_DAYS\n\n  const toggleType = (type: ProductType, on: boolean) =>\n    update({\n      eligibleTypes: on\n        ? [...current.eligibleTypes.filter((entry) => entry !== type), type]\n        : current.eligibleTypes.filter((entry) => entry !== type),\n    })\n\n  const handleSave = useCallback(async () => {\n    if (!daysValid) return\n    const verdict = await writeGuardedBySeed(\n      {\n        subject: 'return settings',\n        unreadable: storeStatus === 'error',\n        fromCache: storeFromCache,\n      },\n      async () => {\n        await writeSiteWideChange({\n          firestore,\n          user,\n          hostId,\n          write: (batch) =>\n            batch.set(\n              doc(firestore, 'hosts', hostId, 'settings', 'store'),\n              {\n                returns: {\n                  enabled: current.enabled,\n                  windowDays: days,\n                  eligibleTypes: (['physical', 'digital', 'service'] as ProductType[]).filter(\n                    (type) => current.eligibleTypes.includes(type),\n                  ),\n                },\n              },\n              { merge: true },\n            ),\n        })\n      },\n    )\n    if (!verdict.ok) {\n      return void enqueueSnackbar(verdict.message, { variant: 'warning', persist: false })\n    }\n    setDraft(null)\n    enqueueSnackbar('Return settings saved', { variant: 'success', persist: false })\n  }, [daysValid, storeStatus, storeFromCache, firestore, user, hostId, current, days, enqueueSnackbar])\n\n  return (\n    <CardDisplay\n      header={'Returns'}\n      help={pluginDocsHelp('ordersAndReturns', { anchor: '#buyer-requests' })}\n      contentGutterX\n      contentGutterY\n    >\n      <Stack spacing={1.5}>\n        <FormControlLabel\n          control={\n            <Switch\n              size=\"small\"\n              checked={current.enabled}\n              onChange={(event) => update({ enabled: event.target.checked })}\n            />\n          }\n          label=\"Accept return requests online\"\n        />\n        <TextField\n          label=\"Return window in days\"\n          type=\"number\"\n          value={current.windowDays}\n          onChange={(event) => update({ windowDays: event.target.value })}\n          size=\"small\"\n          error={!daysValid}\n          helperText={`Days after the order shipped (or was placed, when nothing ships), 0–${CommerceModel.RETURN_WINDOW_MAX_DAYS}`}\n          slotProps={{ htmlInput: { min: 0, max: CommerceModel.RETURN_WINDOW_MAX_DAYS, step: 1 } }}\n          sx={{ maxWidth: 320 }}\n        />\n        <FormGroup>\n          <FormLabel>{'Returnable product types'}</FormLabel>\n          {(Object.keys(PRODUCT_TYPE_LABELS) as ProductType[]).map((type) => (\n            <FormControlLabel\n              key={type}\n              control={\n                <Checkbox\n                  size=\"small\"\n                  checked={current.eligibleTypes.includes(type)}\n                  onChange={(event) => toggleType(type, event.target.checked)}\n                />\n              }\n              label={PRODUCT_TYPE_LABELS[type]}\n            />\n          ))}\n        </FormGroup>\n        <Button\n          variant=\"contained\"\n          color=\"primary\"\n          size=\"small\"\n          disabled={!draft || !daysValid}\n          onClick={handleSave}\n          sx={{ alignSelf: 'flex-start' }}\n        >\n          {'Save return settings'}\n        </Button>\n      </Stack>\n    </CardDisplay>\n  )\n}\nReturnSettingsCard.displayName = 'ReturnSettingsCard'\n\nexport default ReturnSettingsCard\n"],"names":["CommerceModel","CardDisplay","useSnackbar","Button","Checkbox","FormControlLabel","FormGroup","FormLabel","Stack","Switch","TextField","doc","useCallback","useMemo","useState","useFirestore","useFirestoreDoc","useUser","writeGuardedBySeed","pluginDocsHelp","writeSiteWideChange","PRODUCT_TYPE_LABELS","physical","digital","service","ReturnSettingsCard","props","hostId","firestore","data","user","enqueueSnackbar","store","status","storeStatus","fromCache","storeFromCache","draft","setDraft","current","saved","readReturnSettings","returns","enabled","windowDays","String","eligibleTypes","update","patch","days","Number","daysValid","trim","isInteger","RETURN_WINDOW_MAX_DAYS","toggleType","type","on","filter","entry","handleSave","verdict","subject","unreadable","write","batch","set","includes","merge","ok","message","variant","persist","header","help","anchor","contentGutterX","contentGutterY","spacing","control","size","checked","onChange","event","target","label","value","error","helperText","slotProps","htmlInput","min","max","step","sx","maxWidth","Object","keys","map","color","disabled","onClick","alignSelf","displayName"],"mappings":"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"}

package/src/lib/components/console/return-zones.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @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 { ConsoleOrderZoneAddress } from './order-zones';
+/**
+ * The zone the return dialog hosts (AGL-3611): `returnDetail`, among the
+ * return's details, where a shipping plugin buys the buyer a return label.
+ *
+ * Declared here, by the plugin that hosts it, as the order zones are. A
+ * widget restates the props it reads rather than importing this package, and
+ * it never writes the return itself: the label it bought is attached through
+ * `attachReturnLabel`, which posts this plugin's own route (`attach-label`),
+ * with its role gate and its https check.
+ */
+/** One line coming back. `lineItemId` is the order line's index. */
+export interface ConsoleReturnZoneLine {
+    lineItemId: number;
+    name: string;
+    variantLabel: string | null;
+    quantity: number;
+    /** A `ReturnReason` key, e.g. `damaged`. */
+    reason: string;
+}
+/** The label already on the return, when one was attached. */
+export interface ConsoleReturnZoneLabel {
+    carrier: string;
+    trackingNumber: string;
+    labelUrl: string;
+    trackingUrl: string | null;
+    attachedAtMs: number;
+}
+/** The return a widget is handed. */
+export interface ConsoleReturnZoneReturn {
+    id: string;
+    /** A `ReturnStatus`: `requested`, `approved`, `received`, … */
+    status: string;
+    orderId: string;
+    /** The order's human number, e.g. `#1042`. */
+    orderNumber: string;
+    customerName: string | null;
+    customerEmail: string | null;
+    lines: readonly ConsoleReturnZoneLine[];
+    /**
+     * Where the parcel comes FROM: the order's ship-to address, as the buyer
+     * gave it. `null` for an order that never shipped anywhere.
+     */
+    fromAddress: ConsoleOrderZoneAddress | null;
+    returnLabel: ConsoleReturnZoneLabel | null;
+}
+/** A return label a widget asks the dialog to attach. */
+export interface ConsoleReturnLabelRequest {
+    carrier: string;
+    trackingNumber: string;
+    /** The printable label, an https URL. */
+    labelUrl: string;
+    /** An explicit https tracking link; derived from the carrier when absent. */
+    trackingUrl?: string;
+}
+/**
+ * What the `returnDetail` zone hands each widget. `attachReturnLabel`
+ * resolves once the route stored the label, and throws with a message a
+ * person can act on when it refuses: a finished return, a link that is not
+ * https.
+ */
+export interface ConsoleReturnDetailZoneProps {
+    hostId: string;
+    /** The org the page names; `undefined` where the host does not know it. */
+    orgId: string | undefined;
+    return: ConsoleReturnZoneReturn;
+    attachReturnLabel: (label: ConsoleReturnLabelRequest) => Promise<void>;
+}
+export declare const RETURN_DETAIL_ZONE: import("@aglyn/aglyn/plugin-manager/plugin-zones").PluginZone<ConsoleReturnDetailZoneProps>;
+/** Declares the return zone, from the console registrar. */
+export declare function registerCommerceReturnZones(): void;

package/src/lib/components/console/return-zones.js

@@ -0,0 +1,31 @@
+/**
+ * @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 { definePluginZone, registerPluginZone } from "@aglyn/aglyn/plugin-manager/plugin-zones";
+import { BUNDLE_ID } from "../../constants/bundle-common.js";
+export const RETURN_DETAIL_ZONE = definePluginZone('returnDetail');
+/** Declares the return zone, from the console registrar. */ export function registerCommerceReturnZones() {
+    registerPluginZone({
+        zone: RETURN_DETAIL_ZONE,
+        label: 'Return detail',
+        surface: 'console',
+        layout: 'bare',
+        description: 'In the return dialog, above its actions. A widget here reads the return — its lines, the buyer and the address the parcel comes from — and attaches a return label through `attachReturnLabel`, the dialog’s own route.'
+    }, {
+        pluginId: BUNDLE_ID
+    });
+}
+
+//# sourceMappingURL=return-zones.js.map

package/src/lib/components/console/return-zones.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/return-zones.ts"],"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 {\n  definePluginZone,\n  registerPluginZone,\n} from '@aglyn/aglyn/plugin-manager/plugin-zones'\nimport { BUNDLE_ID } from '../../constants/bundle-common'\nimport type { ConsoleOrderZoneAddress } from './order-zones'\n\n/**\n * The zone the return dialog hosts (AGL-3611): `returnDetail`, among the\n * return's details, where a shipping plugin buys the buyer a return label.\n *\n * Declared here, by the plugin that hosts it, as the order zones are. A\n * widget restates the props it reads rather than importing this package, and\n * it never writes the return itself: the label it bought is attached through\n * `attachReturnLabel`, which posts this plugin's own route (`attach-label`),\n * with its role gate and its https check.\n */\n\n/** One line coming back. `lineItemId` is the order line's index. */\nexport interface ConsoleReturnZoneLine {\n  lineItemId: number\n  name: string\n  variantLabel: string | null\n  quantity: number\n  /** A `ReturnReason` key, e.g. `damaged`. */\n  reason: string\n}\n\n/** The label already on the return, when one was attached. */\nexport interface ConsoleReturnZoneLabel {\n  carrier: string\n  trackingNumber: string\n  labelUrl: string\n  trackingUrl: string | null\n  attachedAtMs: number\n}\n\n/** The return a widget is handed. */\nexport interface ConsoleReturnZoneReturn {\n  id: string\n  /** A `ReturnStatus`: `requested`, `approved`, `received`, … */\n  status: string\n  orderId: string\n  /** The order's human number, e.g. `#1042`. */\n  orderNumber: string\n  customerName: string | null\n  customerEmail: string | null\n  lines: readonly ConsoleReturnZoneLine[]\n  /**\n   * Where the parcel comes FROM: the order's ship-to address, as the buyer\n   * gave it. `null` for an order that never shipped anywhere.\n   */\n  fromAddress: ConsoleOrderZoneAddress | null\n  returnLabel: ConsoleReturnZoneLabel | null\n}\n\n/** A return label a widget asks the dialog to attach. */\nexport interface ConsoleReturnLabelRequest {\n  carrier: string\n  trackingNumber: string\n  /** The printable label, an https URL. */\n  labelUrl: string\n  /** An explicit https tracking link; derived from the carrier when absent. */\n  trackingUrl?: string\n}\n\n/**\n * What the `returnDetail` zone hands each widget. `attachReturnLabel`\n * resolves once the route stored the label, and throws with a message a\n * person can act on when it refuses: a finished return, a link that is not\n * https.\n */\nexport interface ConsoleReturnDetailZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` where the host does not know it. */\n  orgId: string | undefined\n  return: ConsoleReturnZoneReturn\n  attachReturnLabel: (label: ConsoleReturnLabelRequest) => Promise<void>\n}\n\nexport const RETURN_DETAIL_ZONE =\n  definePluginZone<ConsoleReturnDetailZoneProps>('returnDetail')\n\n/** Declares the return zone, from the console registrar. */\nexport function registerCommerceReturnZones(): void {\n  registerPluginZone(\n    {\n      zone: RETURN_DETAIL_ZONE,\n      label: 'Return detail',\n      surface: 'console',\n      layout: 'bare',\n      description:\n        'In the return dialog, above its actions. A widget here reads the return — its lines, the buyer and the address the parcel comes from — and attaches a return label through `attachReturnLabel`, the dialog’s own route.',\n    },\n    { pluginId: BUNDLE_ID },\n  )\n}\n"],"names":["definePluginZone","registerPluginZone","BUNDLE_ID","RETURN_DETAIL_ZONE","registerCommerceReturnZones","zone","label","surface","layout","description","pluginId"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,gBAAgB,EAChBC,kBAAkB,QACb,2CAA0C;AACjD,SAASC,SAAS,QAAQ,mCAA+B;AA4EzD,OAAO,MAAMC,qBACXH,iBAA+C,gBAAe;AAEhE,0DAA0D,GAC1D,OAAO,SAASI;IACdH,mBACE;QACEI,MAAMF;QACNG,OAAO;QACPC,SAAS;QACTC,QAAQ;QACRC,aACE;IACJ,GACA;QAAEC,UAAUR;IAAU;AAE1B"}

package/src/lib/components/console/returns-card.component.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as CommerceModel from '../../model';
+export interface ReturnsCardProps {
+    hostId: string;
+}
+/** The query key the Returns list opens one return's dialog by. */
+export declare const RETURNS_RETURN_PARAM = "return";
+/**
+ * What is coming back, as the row's summary: "2× Mug, 1× Tee" from the names
+ * a return keeps, or "3 items" for one opened before it kept them.
+ */
+export declare function itemsSummary(entry: Pick<CommerceModel.HostReturn, 'lines'>): string;
+/**
+ * Returns (RMA, AGL-3611): every return on the store, newest first.
+ *
+ * THE STATUS FILTER IS THE QUERY. `status == X` ordered by `createdAtMs`
+ * descending, served by the `returns(status ASC, createdAtMs DESC)`
+ * composite; "All" is the single-field order alone. The footer pages that
+ * query's answer, so page two of "Requested" is page two of the requests,
+ * never a page of the store narrowed afterwards.
+ *
+ * `?return={id}` opens that return's dialog on arrival — the address the
+ * merchant's "return requested" notification links to. The dialog reads the
+ * return by id, so one that is not on this page opens just the same.
+ */
+export declare function ReturnsCard(props: ReturnsCardProps): import("react").JSX.Element;
+export declare namespace ReturnsCard {
+    var displayName: string;
+}
+export default ReturnsCard;