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

package/src/lib/components/console/shipstation-card.component.js

@@ -0,0 +1,345 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { pluginDocsHelp } from "@aglyn/aglyn";
+import { PLATFORM_BRAND_NAME } from "@aglyn/aglyn/app-utils/platform-brand";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { Alert, AlertTitle, Button, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, Stack, TableBody, TableCell, TableRow, Typography } from "@mui/material";
+import { useCallback, useEffect, useState } from "react";
+import ScrollTable from "@aglyn/shared-ui-jsx/components/scroll-table.component";
+import { SHIPSTATION_STATUS_NAMES } from "../../model/shipstation.js";
+/** The address ShipStation calls: this console's own origin, never a guess. */ export function shipStationEndpoint(hostId, origin) {
+    const base = origin != null ? origin : typeof window === 'undefined' ? '' : window.location.origin;
+    return `${base}/api/commerce/shipstation/${encodeURIComponent(hostId)}`;
+}
+/** The status names to type into ShipStation's Custom Store form, in its order. */ export const SHIPSTATION_STATUS_ROWS = [
+    [
+        'Unpaid Status',
+        SHIPSTATION_STATUS_NAMES.unpaid
+    ],
+    [
+        'Paid Status',
+        SHIPSTATION_STATUS_NAMES.paid
+    ],
+    [
+        'Shipped Status',
+        SHIPSTATION_STATUS_NAMES.shipped
+    ],
+    [
+        'Canceled Status',
+        SHIPSTATION_STATUS_NAMES.canceled
+    ],
+    [
+        'On-Hold Status',
+        SHIPSTATION_STATUS_NAMES.onHold
+    ]
+];
+const when = (ms)=>ms ? new Date(ms).toLocaleString(undefined, {
+        dateStyle: 'medium',
+        timeStyle: 'short'
+    }) : 'Not yet';
+/**
+ * Connect ShipStation (AGL-3613): the URL, username and password a merchant
+ * pastes into ShipStation's Custom Store, the status names to map, a new
+ * password and a disconnect. The password is kept sealed on the server and
+ * a site admin can show it again; the card renders nothing on a deployment
+ * that cannot seal one.
+ */ export function ShipStationCard(props) {
+    var _ref;
+    const { hostId } = props;
+    const { data: user } = useUser();
+    const { enqueueSnackbar } = useSnackbar();
+    const [status, setStatus] = useState(null);
+    const [loadError, setLoadError] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const [password, setPassword] = useState(null);
+    const [confirmDisconnect, setConfirmDisconnect] = useState(false);
+    // Keyed on the account, not the user object: the object is new on every
+    // render, and the status is the same until somebody else signs in.
+    const uid = user == null ? void 0 : user.uid;
+    useEffect(()=>{
+        if (!uid || !user) return;
+        let live = true;
+        authorizedFetch(user, `/api/commerce/shipping-connectors?hostId=${encodeURIComponent(hostId)}`).then(async (response)=>{
+            var _ref;
+            const body = await response.json().catch(()=>({}));
+            if (!live) return;
+            if (!response.ok) return setLoadError((_ref = body == null ? void 0 : body.error) != null ? _ref : 'The connection could not be read.');
+            setLoadError(null);
+            setStatus(body);
+        }).catch(()=>live && setLoadError('The connection could not be read.'));
+        return ()=>{
+            live = false;
+        };
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- `user` changes identity every render; `uid` is what matters.
+    }, [
+        uid,
+        hostId
+    ]);
+    const act = useCallback(async (action)=>{
+        setBusy(true);
+        try {
+            const response = await authorizedFetch(user, '/api/commerce/shipping-connectors', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    hostId,
+                    action
+                })
+            });
+            const body = await response.json().catch(()=>({}));
+            if (!response.ok) {
+                var _ref;
+                enqueueSnackbar((_ref = body == null ? void 0 : body.error) != null ? _ref : 'That did not work. Try again.', {
+                    variant: 'error',
+                    allowDuplicate: true
+                });
+                return;
+            }
+            setStatus(body);
+            setPassword(typeof (body == null ? void 0 : body.password) === 'string' ? body.password : null);
+            if (action === 'disconnect') {
+                enqueueSnackbar('ShipStation is disconnected. It can no longer read your orders.', {
+                    variant: 'success'
+                });
+            }
+        } finally{
+            setBusy(false);
+        }
+    }, [
+        user,
+        hostId,
+        enqueueSnackbar
+    ]);
+    const copy = (label, value)=>{
+        var _navigator_clipboard;
+        void ((_navigator_clipboard = navigator.clipboard) == null ? void 0 : _navigator_clipboard.writeText(value).then(()=>enqueueSnackbar(`${label} copied`, {
+                variant: 'success',
+                persist: false
+            })).catch(()=>enqueueSnackbar(`Select the ${label.toLowerCase()} and copy it.`, {
+                variant: 'info'
+            })));
+    };
+    // A deployment with no secret keyring cannot keep a password: nothing to offer.
+    if (status && status.available === false && !status.connected) return null;
+    const connected = Boolean(status == null ? void 0 : status.connected);
+    const actions = !status ? null : connected ? /*#__PURE__*/ _jsxs(Stack, {
+        direction: "row",
+        spacing: 1,
+        children: [
+            /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                disabled: busy,
+                onClick: ()=>void act('rotate'),
+                children: 'New password'
+            }),
+            /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                color: "error",
+                disabled: busy,
+                onClick: ()=>setConfirmDisconnect(true),
+                children: 'Disconnect'
+            })
+        ]
+    }) : /*#__PURE__*/ _jsx(Button, {
+        size: "small",
+        variant: "contained",
+        disabled: busy,
+        onClick: ()=>void act('connect'),
+        children: 'Connect ShipStation'
+    });
+    const endpoint = shipStationEndpoint(hostId);
+    const credentialRows = [
+        [
+            'URL to custom XML page',
+            endpoint,
+            true
+        ],
+        [
+            'Username',
+            (_ref = status == null ? void 0 : status.username) != null ? _ref : '',
+            true
+        ]
+    ];
+    if (password) credentialRows.push([
+        'Password',
+        password,
+        true
+    ]);
+    return /*#__PURE__*/ _jsxs(CardDisplay, {
+        header: 'ShipStation',
+        help: pluginDocsHelp('shipStation', {
+            excerpt: `ShipStation imports your paid orders from ${PLATFORM_BRAND_NAME} and sends each shipment back, which ` + 'marks the order shipped and emails your customer the tracking link.'
+        }),
+        HeaderProps: {
+            action: actions
+        },
+        contentGutterX: true,
+        contentGutterY: true,
+        children: [
+            /*#__PURE__*/ _jsxs(Stack, {
+                spacing: 2,
+                children: [
+                    loadError ? /*#__PURE__*/ _jsx(Alert, {
+                        severity: "error",
+                        children: loadError
+                    }) : null,
+                    !connected ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "body2",
+                        color: "text.secondary",
+                        children: 'Already labeling in ShipStation? Connect it as a Custom Store: ShipStation imports the ' + 'orders you still have to ship, and each label you buy there marks the order shipped ' + 'here and emails your customer the tracking link. Only a site admin can connect it.'
+                    }) : /*#__PURE__*/ _jsxs(_Fragment, {
+                        children: [
+                            password ? /*#__PURE__*/ _jsxs(Alert, {
+                                severity: "info",
+                                children: [
+                                    /*#__PURE__*/ _jsx(AlertTitle, {
+                                        children: 'Paste these into ShipStation'
+                                    }),
+                                    'Anyone with this password can read the name and address on every order you ship. ' + 'If it gets out, make a new password: the old one stops working at once.'
+                                ]
+                            }) : null,
+                            /*#__PURE__*/ _jsx(ScrollTable, {
+                                size: "small",
+                                "aria-label": "ShipStation connection",
+                                children: /*#__PURE__*/ _jsxs(TableBody, {
+                                    children: [
+                                        credentialRows.map(([label, value])=>/*#__PURE__*/ _jsxs(TableRow, {
+                                                children: [
+                                                    /*#__PURE__*/ _jsx(TableCell, {
+                                                        component: "th",
+                                                        scope: "row",
+                                                        children: label
+                                                    }),
+                                                    /*#__PURE__*/ _jsx(TableCell, {
+                                                        sx: {
+                                                            wordBreak: 'break-all'
+                                                        },
+                                                        children: value
+                                                    }),
+                                                    /*#__PURE__*/ _jsx(TableCell, {
+                                                        align: "right",
+                                                        children: /*#__PURE__*/ _jsx(Button, {
+                                                            size: "small",
+                                                            onClick: ()=>copy(label, value),
+                                                            children: 'Copy'
+                                                        })
+                                                    })
+                                                ]
+                                            }, label)),
+                                        !password ? /*#__PURE__*/ _jsxs(TableRow, {
+                                            children: [
+                                                /*#__PURE__*/ _jsx(TableCell, {
+                                                    component: "th",
+                                                    scope: "row",
+                                                    children: 'Password'
+                                                }),
+                                                /*#__PURE__*/ _jsx(TableCell, {
+                                                    children: /*#__PURE__*/ _jsx(Typography, {
+                                                        variant: "body2",
+                                                        color: "text.secondary",
+                                                        children: 'Hidden. Only a site admin can show it.'
+                                                    })
+                                                }),
+                                                /*#__PURE__*/ _jsx(TableCell, {
+                                                    align: "right",
+                                                    children: /*#__PURE__*/ _jsx(Button, {
+                                                        size: "small",
+                                                        disabled: busy,
+                                                        onClick: ()=>void act('reveal'),
+                                                        children: 'Show'
+                                                    })
+                                                })
+                                            ]
+                                        }) : null
+                                    ]
+                                })
+                            }),
+                            /*#__PURE__*/ _jsx(Typography, {
+                                variant: "subtitle2",
+                                children: 'Status names to type into ShipStation'
+                            }),
+                            /*#__PURE__*/ _jsx(ScrollTable, {
+                                size: "small",
+                                "aria-label": "ShipStation status names",
+                                children: /*#__PURE__*/ _jsx(TableBody, {
+                                    children: SHIPSTATION_STATUS_ROWS.map(([field, value])=>/*#__PURE__*/ _jsxs(TableRow, {
+                                            children: [
+                                                /*#__PURE__*/ _jsx(TableCell, {
+                                                    component: "th",
+                                                    scope: "row",
+                                                    children: field
+                                                }),
+                                                /*#__PURE__*/ _jsx(TableCell, {
+                                                    children: value
+                                                })
+                                            ]
+                                        }, field))
+                                })
+                            }),
+                            /*#__PURE__*/ _jsx(Typography, {
+                                variant: "body2",
+                                color: "text.secondary",
+                                children: `Last order import: ${when(status == null ? void 0 : status.lastExportAtMs)}. Last shipment received: ${when(status == null ? void 0 : status.lastShipNoticeAtMs)}.`
+                            })
+                        ]
+                    })
+                ]
+            }),
+            /*#__PURE__*/ _jsxs(Dialog, {
+                open: confirmDisconnect,
+                onClose: ()=>setConfirmDisconnect(false),
+                children: [
+                    /*#__PURE__*/ _jsx(DialogTitle, {
+                        children: 'Disconnect ShipStation?'
+                    }),
+                    /*#__PURE__*/ _jsx(DialogContent, {
+                        children: /*#__PURE__*/ _jsx(DialogContentText, {
+                            children: 'ShipStation stops importing orders from this site, and shipments it sends back are ' + 'refused. Orders already shipped stay shipped. You can connect again later with a new password.'
+                        })
+                    }),
+                    /*#__PURE__*/ _jsxs(DialogActions, {
+                        children: [
+                            /*#__PURE__*/ _jsx(Button, {
+                                onClick: ()=>setConfirmDisconnect(false),
+                                children: 'Cancel'
+                            }),
+                            /*#__PURE__*/ _jsx(Button, {
+                                color: "error",
+                                disabled: busy,
+                                onClick: ()=>{
+                                    setConfirmDisconnect(false);
+                                    void act('disconnect');
+                                },
+                                children: 'Disconnect'
+                            })
+                        ]
+                    })
+                ]
+            })
+        ]
+    });
+}
+ShipStationCard.displayName = 'ShipStationCard';
+export default ShipStationCard;
+
+//# sourceMappingURL=shipstation-card.component.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/shipstation-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 { pluginDocsHelp } from '@aglyn/aglyn'\nimport { PLATFORM_BRAND_NAME } from '@aglyn/aglyn/app-utils/platform-brand'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport {\n  Alert,\n  AlertTitle,\n  Button,\n  Dialog,\n  DialogActions,\n  DialogContent,\n  DialogContentText,\n  DialogTitle,\n  Stack,\n  TableBody,\n  TableCell,\n  TableRow,\n  Typography,\n} from '@mui/material'\nimport { useCallback, useEffect, useState } from 'react'\nimport ScrollTable from '@aglyn/shared-ui-jsx/components/scroll-table.component'\nimport { SHIPSTATION_STATUS_NAMES } from '../../model/shipstation'\n\nexport interface ShipStationCardProps {\n  hostId: string\n}\n\n/** What the connectors route answers about a connection. */\ninterface ConnectionStatus {\n  /** Whether this deployment can keep a ShipStation password at all. */\n  available?: boolean\n  connected: boolean\n  username?: string\n  createdAtMs?: number\n  rotatedAtMs?: number\n  lastExportAtMs?: number\n  lastShipNoticeAtMs?: number\n}\n\n/** The address ShipStation calls: this console's own origin, never a guess. */\nexport function shipStationEndpoint(hostId: string, origin?: string): string {\n  const base = origin ?? (typeof window === 'undefined' ? '' : window.location.origin)\n  return `${base}/api/commerce/shipstation/${encodeURIComponent(hostId)}`\n}\n\n/** The status names to type into ShipStation's Custom Store form, in its order. */\nexport const SHIPSTATION_STATUS_ROWS: ReadonlyArray<readonly [string, string]> = [\n  ['Unpaid Status', SHIPSTATION_STATUS_NAMES.unpaid],\n  ['Paid Status', SHIPSTATION_STATUS_NAMES.paid],\n  ['Shipped Status', SHIPSTATION_STATUS_NAMES.shipped],\n  ['Canceled Status', SHIPSTATION_STATUS_NAMES.canceled],\n  ['On-Hold Status', SHIPSTATION_STATUS_NAMES.onHold],\n]\n\nconst when = (ms: number | undefined): string =>\n  ms ? new Date(ms).toLocaleString(undefined, { dateStyle: 'medium', timeStyle: 'short' }) : 'Not yet'\n\n/**\n * Connect ShipStation (AGL-3613): the URL, username and password a merchant\n * pastes into ShipStation's Custom Store, the status names to map, a new\n * password and a disconnect. The password is kept sealed on the server and\n * a site admin can show it again; the card renders nothing on a deployment\n * that cannot seal one.\n */\nexport function ShipStationCard(props: ShipStationCardProps) {\n  const { hostId } = props\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const [status, setStatus] = useState<ConnectionStatus | null>(null)\n  const [loadError, setLoadError] = useState<string | null>(null)\n  const [busy, setBusy] = useState(false)\n  const [password, setPassword] = useState<string | null>(null)\n  const [confirmDisconnect, setConfirmDisconnect] = useState(false)\n\n  // Keyed on the account, not the user object: the object is new on every\n  // render, and the status is the same until somebody else signs in.\n  const uid = user?.uid\n  useEffect(() => {\n    if (!uid || !user) return\n    let live = true\n    authorizedFetch(user as never, `/api/commerce/shipping-connectors?hostId=${encodeURIComponent(hostId)}`)\n      .then(async (response) => {\n        const body = await response.json().catch(() => ({}))\n        if (!live) return\n        if (!response.ok) return setLoadError(body?.error ?? 'The connection could not be read.')\n        setLoadError(null)\n        setStatus(body as ConnectionStatus)\n      })\n      .catch(() => live && setLoadError('The connection could not be read.'))\n    return () => {\n      live = false\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- `user` changes identity every render; `uid` is what matters.\n  }, [uid, hostId])\n\n  const act = useCallback(\n    async (action: 'connect' | 'rotate' | 'reveal' | 'disconnect') => {\n      setBusy(true)\n      try {\n        const response = await authorizedFetch(user as never, '/api/commerce/shipping-connectors', {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({ hostId, action }),\n        })\n        const body = await response.json().catch(() => ({}))\n        if (!response.ok) {\n          enqueueSnackbar(body?.error ?? 'That did not work. Try again.', { variant: 'error', allowDuplicate: true })\n          return\n        }\n        setStatus(body as ConnectionStatus)\n        setPassword(typeof body?.password === 'string' ? body.password : null)\n        if (action === 'disconnect') {\n          enqueueSnackbar('ShipStation is disconnected. It can no longer read your orders.', { variant: 'success' })\n        }\n      } finally {\n        setBusy(false)\n      }\n    },\n    [user, hostId, enqueueSnackbar],\n  )\n\n  const copy = (label: string, value: string) => {\n    void navigator.clipboard\n      ?.writeText(value)\n      .then(() => enqueueSnackbar(`${label} copied`, { variant: 'success', persist: false }))\n      .catch(() => enqueueSnackbar(`Select the ${label.toLowerCase()} and copy it.`, { variant: 'info' }))\n  }\n\n  // A deployment with no secret keyring cannot keep a password: nothing to offer.\n  if (status && status.available === false && !status.connected) return null\n\n  const connected = Boolean(status?.connected)\n  const actions = !status ? null : connected ? (\n    <Stack direction=\"row\" spacing={1}>\n      <Button size=\"small\" disabled={busy} onClick={() => void act('rotate')}>\n        {'New password'}\n      </Button>\n      <Button size=\"small\" color=\"error\" disabled={busy} onClick={() => setConfirmDisconnect(true)}>\n        {'Disconnect'}\n      </Button>\n    </Stack>\n  ) : (\n    <Button size=\"small\" variant=\"contained\" disabled={busy} onClick={() => void act('connect')}>\n      {'Connect ShipStation'}\n    </Button>\n  )\n\n  const endpoint = shipStationEndpoint(hostId)\n  const credentialRows: Array<[string, string, boolean]> = [\n    ['URL to custom XML page', endpoint, true],\n    ['Username', status?.username ?? '', true],\n  ]\n  if (password) credentialRows.push(['Password', password, true])\n\n  return (\n    <CardDisplay\n      header={'ShipStation'}\n      help={pluginDocsHelp('shipStation', {\n        excerpt:\n          `ShipStation imports your paid orders from ${PLATFORM_BRAND_NAME} and sends each shipment back, which ` +\n          'marks the order shipped and emails your customer the tracking link.',\n      })}\n      HeaderProps={{ action: actions }}\n      contentGutterX\n      contentGutterY\n    >\n      <Stack spacing={2}>\n        {loadError ? <Alert severity=\"error\">{loadError}</Alert> : null}\n        {!connected ? (\n          <Typography variant=\"body2\" color=\"text.secondary\">\n            {\n              'Already labeling in ShipStation? Connect it as a Custom Store: ShipStation imports the ' +\n              'orders you still have to ship, and each label you buy there marks the order shipped ' +\n              'here and emails your customer the tracking link. Only a site admin can connect it.'\n            }\n          </Typography>\n        ) : (\n          <>\n            {password ? (\n              <Alert severity=\"info\">\n                <AlertTitle>{'Paste these into ShipStation'}</AlertTitle>\n                {\n                  'Anyone with this password can read the name and address on every order you ship. ' +\n                  'If it gets out, make a new password: the old one stops working at once.'\n                }\n              </Alert>\n            ) : null}\n            <ScrollTable size=\"small\" aria-label=\"ShipStation connection\">\n              <TableBody>\n                {credentialRows.map(([label, value]) => (\n                  <TableRow key={label}>\n                    <TableCell component=\"th\" scope=\"row\">\n                      {label}\n                    </TableCell>\n                    <TableCell sx={{ wordBreak: 'break-all' }}>{value}</TableCell>\n                    <TableCell align=\"right\">\n                      <Button size=\"small\" onClick={() => copy(label, value)}>\n                        {'Copy'}\n                      </Button>\n                    </TableCell>\n                  </TableRow>\n                ))}\n                {!password ? (\n                  <TableRow>\n                    <TableCell component=\"th\" scope=\"row\">\n                      {'Password'}\n                    </TableCell>\n                    <TableCell>\n                      <Typography variant=\"body2\" color=\"text.secondary\">\n                        {'Hidden. Only a site admin can show it.'}\n                      </Typography>\n                    </TableCell>\n                    <TableCell align=\"right\">\n                      <Button size=\"small\" disabled={busy} onClick={() => void act('reveal')}>\n                        {'Show'}\n                      </Button>\n                    </TableCell>\n                  </TableRow>\n                ) : null}\n              </TableBody>\n            </ScrollTable>\n            <Typography variant=\"subtitle2\">{'Status names to type into ShipStation'}</Typography>\n            <ScrollTable size=\"small\" aria-label=\"ShipStation status names\">\n              <TableBody>\n                {SHIPSTATION_STATUS_ROWS.map(([field, value]) => (\n                  <TableRow key={field}>\n                    <TableCell component=\"th\" scope=\"row\">\n                      {field}\n                    </TableCell>\n                    <TableCell>{value}</TableCell>\n                  </TableRow>\n                ))}\n              </TableBody>\n            </ScrollTable>\n            <Typography variant=\"body2\" color=\"text.secondary\">\n              {`Last order import: ${when(status?.lastExportAtMs)}. Last shipment received: ${when(status?.lastShipNoticeAtMs)}.`}\n            </Typography>\n          </>\n        )}\n      </Stack>\n      <Dialog open={confirmDisconnect} onClose={() => setConfirmDisconnect(false)}>\n        <DialogTitle>{'Disconnect ShipStation?'}</DialogTitle>\n        <DialogContent>\n          <DialogContentText>\n            {\n              'ShipStation stops importing orders from this site, and shipments it sends back are ' +\n              'refused. Orders already shipped stay shipped. You can connect again later with a new password.'\n            }\n          </DialogContentText>\n        </DialogContent>\n        <DialogActions>\n          <Button onClick={() => setConfirmDisconnect(false)}>{'Cancel'}</Button>\n          <Button\n            color=\"error\"\n            disabled={busy}\n            onClick={() => {\n              setConfirmDisconnect(false)\n              void act('disconnect')\n            }}\n          >\n            {'Disconnect'}\n          </Button>\n        </DialogActions>\n      </Dialog>\n    </CardDisplay>\n  )\n}\nShipStationCard.displayName = 'ShipStationCard'\n\nexport default ShipStationCard\n"],"names":["pluginDocsHelp","PLATFORM_BRAND_NAME","CardDisplay","useSnackbar","authorizedFetch","useUser","Alert","AlertTitle","Button","Dialog","DialogActions","DialogContent","DialogContentText","DialogTitle","Stack","TableBody","TableCell","TableRow","Typography","useCallback","useEffect","useState","ScrollTable","SHIPSTATION_STATUS_NAMES","shipStationEndpoint","hostId","origin","base","window","location","encodeURIComponent","SHIPSTATION_STATUS_ROWS","unpaid","paid","shipped","canceled","onHold","when","ms","Date","toLocaleString","undefined","dateStyle","timeStyle","ShipStationCard","props","data","user","enqueueSnackbar","status","setStatus","loadError","setLoadError","busy","setBusy","password","setPassword","confirmDisconnect","setConfirmDisconnect","uid","live","then","response","body","json","catch","ok","error","act","action","method","headers","JSON","stringify","variant","allowDuplicate","copy","label","value","navigator","clipboard","writeText","persist","toLowerCase","available","connected","Boolean","actions","direction","spacing","size","disabled","onClick","color","endpoint","credentialRows","username","push","header","help","excerpt","HeaderProps","contentGutterX","contentGutterY","severity","aria-label","map","component","scope","sx","wordBreak","align","field","lastExportAtMs","lastShipNoticeAtMs","open","onClose","displayName"],"mappings":"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"}

package/src/lib/components/console/start-return-dialog.component.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @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 StartReturnDialogProps {
+    hostId: string;
+    orderId: string;
+    order: Pick<CommerceModel.HostOrder, 'lineItems' | 'fulfillments' | 'refundedLineItemIds'>;
+    /** The returns already on the order, which hold units against it. */
+    existing: ReadonlyArray<Pick<CommerceModel.HostReturn, 'status' | 'lines' | 'refundedAtMs'>>;
+    open: boolean;
+    onClose: () => void;
+    /** Called with the new return's id once the route opened it. */
+    onCreated?: (returnId: string) => void;
+}
+/**
+ * "Start return" (AGL-3611): the merchant opens a return on the buyer's
+ * behalf. It starts approved — the merchant asking is the approval — and the
+ * route re-checks every quantity against the order and the returns already on
+ * it. What is offered here is `returnableLines` with no store policy, since a
+ * merchant may take back any product type, at any time.
+ */
+export declare function StartReturnDialog(props: StartReturnDialogProps): import("react").JSX.Element;
+export declare namespace StartReturnDialog {
+    var displayName: string;
+}
+export default StartReturnDialog;