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

package/src/lib/components/console/order-shipping-actions.component.js

@@ -0,0 +1,149 @@
+/**
+ * @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 { useTransferLauncher } from "@aglyn/aglyn/app-utils/transfer-launcher-context";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { Button, ListItemText, Menu, MenuItem, Stack } from "@mui/material";
+import { useState } from "react";
+import { ORDER_SHIPPING_PRESETS } from "../../transfer/shipping-presets.js";
+import { COMMERCE_ORDERS_TRANSFER, COMMERCE_TRACKING_TRANSFER } from "../../transfer/transfer-keys.js";
+/**
+ * The orders still to ship, as the export dialog's filter: orders that ship
+ * at all (`requiresShipping`, AGL-3613) that are paid or part-shipped —
+ * one indexed query, `(requiresShipping, status, createdAtMs)`.
+ */ export const ORDERS_TO_SHIP_FILTER = {
+    label: 'orders still to ship',
+    value: {
+        filters: [
+            {
+                path: 'requiresShipping',
+                op: '==',
+                value: true
+            },
+            {
+                path: 'status',
+                op: 'in',
+                value: [
+                    'paid',
+                    'partially_fulfilled'
+                ]
+            }
+        ],
+        orderBy: {
+            path: 'createdAtMs',
+            direction: 'desc'
+        }
+    }
+};
+/**
+ * The orders card's shipping actions, for its header (AGL-3613): Export for
+ * shipping — the orders still to ship, laid out for Pirate Ship, Shippo,
+ * EasyPost or any tool — and Import tracking, which records each parcel in a
+ * label tool's file as a shipment. Each shows only when the transfer
+ * launcher's `can` admits the person; off the console shell, nothing.
+ */ export function OrderShippingActions(props) {
+    const { hostId } = props;
+    const transfer = useTransferLauncher();
+    const { data: user } = useUser();
+    const [anchor, setAnchor] = useState(null);
+    if (!transfer) return null;
+    const canExport = transfer.can('export', {
+        resource: COMMERCE_ORDERS_TRANSFER,
+        scope: 'host',
+        hostId
+    });
+    const canImport = transfer.can('import', {
+        resource: COMMERCE_TRACKING_TRANSFER,
+        scope: 'host',
+        hostId
+    });
+    if (!canExport && !canImport) return null;
+    const exportFor = async (preset)=>{
+        setAnchor(null);
+        // Orders written before AGL-3613 carry no `requiresShipping`; stamping
+        // the open ones first is what lets the query find them. Best effort: the
+        // export still opens, and shows what is already stamped.
+        try {
+            await authorizedFetch(user, '/api/commerce/orders-shipping-prepare', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                    hostId
+                })
+            });
+        } catch (unused) {
+        // The export below is still right for every order written since.
+        }
+        transfer.openExport({
+            resource: COMMERCE_ORDERS_TRANSFER,
+            scope: 'host',
+            hostId,
+            title: 'Export orders for shipping',
+            preset,
+            filter: {
+                label: ORDERS_TO_SHIP_FILTER.label,
+                value: ORDERS_TO_SHIP_FILTER.value
+            }
+        });
+    };
+    return /*#__PURE__*/ _jsxs(Stack, {
+        direction: "row",
+        spacing: 1,
+        children: [
+            canImport ? /*#__PURE__*/ _jsx(Button, {
+                size: "small",
+                onClick: ()=>transfer.openImport({
+                        resource: COMMERCE_TRACKING_TRANSFER,
+                        scope: 'host',
+                        hostId,
+                        title: 'Import tracking numbers'
+                    }),
+                children: 'Import tracking'
+            }) : null,
+            canExport ? /*#__PURE__*/ _jsxs(_Fragment, {
+                children: [
+                    /*#__PURE__*/ _jsx(Button, {
+                        size: "small",
+                        "aria-haspopup": "menu",
+                        "aria-expanded": anchor ? 'true' : undefined,
+                        onClick: (event)=>setAnchor(event.currentTarget),
+                        children: 'Export for shipping'
+                    }),
+                    /*#__PURE__*/ _jsx(Menu, {
+                        anchorEl: anchor,
+                        open: Boolean(anchor),
+                        onClose: ()=>setAnchor(null),
+                        children: ORDER_SHIPPING_PRESETS.map((preset)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                onClick: ()=>void exportFor(preset.id),
+                                children: /*#__PURE__*/ _jsx(ListItemText, {
+                                    primary: preset.label,
+                                    secondary: preset.description
+                                })
+                            }, preset.id))
+                    })
+                ]
+            }) : null
+        ]
+    });
+}
+OrderShippingActions.displayName = 'OrderShippingActions';
+export default OrderShippingActions;
+
+//# sourceMappingURL=order-shipping-actions.component.js.map

package/src/lib/components/console/order-shipping-actions.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/plugins/commerce/src/lib/components/console/order-shipping-actions.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 { useTransferLauncher } from '@aglyn/aglyn/app-utils/transfer-launcher-context'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport { Button, ListItemText, Menu, MenuItem, Stack } from '@mui/material'\nimport { useState } from 'react'\nimport { ORDER_SHIPPING_PRESETS } from '../../transfer/shipping-presets'\nimport { COMMERCE_ORDERS_TRANSFER, COMMERCE_TRACKING_TRANSFER } from '../../transfer/transfer-keys'\n\n/**\n * The orders still to ship, as the export dialog's filter: orders that ship\n * at all (`requiresShipping`, AGL-3613) that are paid or part-shipped —\n * one indexed query, `(requiresShipping, status, createdAtMs)`.\n */\nexport const ORDERS_TO_SHIP_FILTER = {\n  label: 'orders still to ship',\n  value: {\n    filters: [\n      { path: 'requiresShipping', op: '==', value: true },\n      { path: 'status', op: 'in', value: ['paid', 'partially_fulfilled'] },\n    ],\n    orderBy: { path: 'createdAtMs', direction: 'desc' },\n  },\n} as const\n\nexport interface OrderShippingActionsProps {\n  hostId: string\n}\n\n/**\n * The orders card's shipping actions, for its header (AGL-3613): Export for\n * shipping — the orders still to ship, laid out for Pirate Ship, Shippo,\n * EasyPost or any tool — and Import tracking, which records each parcel in a\n * label tool's file as a shipment. Each shows only when the transfer\n * launcher's `can` admits the person; off the console shell, nothing.\n */\nexport function OrderShippingActions(props: OrderShippingActionsProps) {\n  const { hostId } = props\n  const transfer = useTransferLauncher()\n  const { data: user } = useUser()\n  const [anchor, setAnchor] = useState<HTMLElement | null>(null)\n  if (!transfer) return null\n  const canExport = transfer.can('export', { resource: COMMERCE_ORDERS_TRANSFER, scope: 'host', hostId })\n  const canImport = transfer.can('import', { resource: COMMERCE_TRACKING_TRANSFER, scope: 'host', hostId })\n  if (!canExport && !canImport) return null\n\n  const exportFor = async (preset: string) => {\n    setAnchor(null)\n    // Orders written before AGL-3613 carry no `requiresShipping`; stamping\n    // the open ones first is what lets the query find them. Best effort: the\n    // export still opens, and shows what is already stamped.\n    try {\n      await authorizedFetch(user as never, '/api/commerce/orders-shipping-prepare', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ hostId }),\n      })\n    } catch {\n      // The export below is still right for every order written since.\n    }\n    transfer.openExport({\n      resource: COMMERCE_ORDERS_TRANSFER,\n      scope: 'host',\n      hostId,\n      title: 'Export orders for shipping',\n      preset,\n      filter: { label: ORDERS_TO_SHIP_FILTER.label, value: ORDERS_TO_SHIP_FILTER.value },\n    })\n  }\n\n  return (\n    <Stack direction=\"row\" spacing={1}>\n      {canImport ? (\n        <Button\n          size=\"small\"\n          onClick={() =>\n            transfer.openImport({\n              resource: COMMERCE_TRACKING_TRANSFER,\n              scope: 'host',\n              hostId,\n              title: 'Import tracking numbers',\n            })\n          }\n        >\n          {'Import tracking'}\n        </Button>\n      ) : null}\n      {canExport ? (\n        <>\n          <Button\n            size=\"small\"\n            aria-haspopup=\"menu\"\n            aria-expanded={anchor ? 'true' : undefined}\n            onClick={(event) => setAnchor(event.currentTarget)}\n          >\n            {'Export for shipping'}\n          </Button>\n          <Menu anchorEl={anchor} open={Boolean(anchor)} onClose={() => setAnchor(null)}>\n            {ORDER_SHIPPING_PRESETS.map((preset) => (\n              <MenuItem key={preset.id} onClick={() => void exportFor(preset.id)}>\n                <ListItemText primary={preset.label} secondary={preset.description} />\n              </MenuItem>\n            ))}\n          </Menu>\n        </>\n      ) : null}\n    </Stack>\n  )\n}\nOrderShippingActions.displayName = 'OrderShippingActions'\n\nexport default OrderShippingActions\n"],"names":["useTransferLauncher","authorizedFetch","useUser","Button","ListItemText","Menu","MenuItem","Stack","useState","ORDER_SHIPPING_PRESETS","COMMERCE_ORDERS_TRANSFER","COMMERCE_TRACKING_TRANSFER","ORDERS_TO_SHIP_FILTER","label","value","filters","path","op","orderBy","direction","OrderShippingActions","props","hostId","transfer","data","user","anchor","setAnchor","canExport","can","resource","scope","canImport","exportFor","preset","method","headers","body","JSON","stringify","openExport","title","filter","spacing","size","onClick","openImport","aria-haspopup","aria-expanded","undefined","event","currentTarget","anchorEl","open","Boolean","onClose","map","id","primary","secondary","description","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;AAEA,SAASA,mBAAmB,QAAQ,mDAAkD;AACtF,SAASC,eAAe,QAAQ,2CAA0C;AAC1E,SAASC,OAAO,QAAQ,iCAAgC;AACxD,SAASC,MAAM,EAAEC,YAAY,EAAEC,IAAI,EAAEC,QAAQ,EAAEC,KAAK,QAAQ,gBAAe;AAC3E,SAASC,QAAQ,QAAQ,QAAO;AAChC,SAASC,sBAAsB,QAAQ,qCAAiC;AACxE,SAASC,wBAAwB,EAAEC,0BAA0B,QAAQ,kCAA8B;AAEnG;;;;CAIC,GACD,OAAO,MAAMC,wBAAwB;IACnCC,OAAO;IACPC,OAAO;QACLC,SAAS;YACP;gBAAEC,MAAM;gBAAoBC,IAAI;gBAAMH,OAAO;YAAK;YAClD;gBAAEE,MAAM;gBAAUC,IAAI;gBAAMH,OAAO;oBAAC;oBAAQ;iBAAsB;YAAC;SACpE;QACDI,SAAS;YAAEF,MAAM;YAAeG,WAAW;QAAO;IACpD;AACF,EAAU;AAMV;;;;;;CAMC,GACD,OAAO,SAASC,qBAAqBC,KAAgC;IACnE,MAAM,EAAEC,MAAM,EAAE,GAAGD;IACnB,MAAME,WAAWvB;IACjB,MAAM,EAAEwB,MAAMC,IAAI,EAAE,GAAGvB;IACvB,MAAM,CAACwB,QAAQC,UAAU,GAAGnB,SAA6B;IACzD,IAAI,CAACe,UAAU,OAAO;IACtB,MAAMK,YAAYL,SAASM,GAAG,CAAC,UAAU;QAAEC,UAAUpB;QAA0BqB,OAAO;QAAQT;IAAO;IACrG,MAAMU,YAAYT,SAASM,GAAG,CAAC,UAAU;QAAEC,UAAUnB;QAA4BoB,OAAO;QAAQT;IAAO;IACvG,IAAI,CAACM,aAAa,CAACI,WAAW,OAAO;IAErC,MAAMC,YAAY,OAAOC;QACvBP,UAAU;QACV,uEAAuE;QACvE,yEAAyE;QACzE,yDAAyD;QACzD,IAAI;YACF,MAAM1B,gBAAgBwB,MAAe,yCAAyC;gBAC5EU,QAAQ;gBACRC,SAAS;oBAAE,gBAAgB;gBAAmB;gBAC9CC,MAAMC,KAAKC,SAAS,CAAC;oBAAEjB;gBAAO;YAChC;QACF,EAAE,eAAM;QACN,iEAAiE;QACnE;QACAC,SAASiB,UAAU,CAAC;YAClBV,UAAUpB;YACVqB,OAAO;YACPT;YACAmB,OAAO;YACPP;YACAQ,QAAQ;gBAAE7B,OAAOD,sBAAsBC,KAAK;gBAAEC,OAAOF,sBAAsBE,KAAK;YAAC;QACnF;IACF;IAEA,qBACE,MAACP;QAAMY,WAAU;QAAMwB,SAAS;;YAC7BX,0BACC,KAAC7B;gBACCyC,MAAK;gBACLC,SAAS,IACPtB,SAASuB,UAAU,CAAC;wBAClBhB,UAAUnB;wBACVoB,OAAO;wBACPT;wBACAmB,OAAO;oBACT;0BAGD;iBAED;YACHb,0BACC;;kCACE,KAACzB;wBACCyC,MAAK;wBACLG,iBAAc;wBACdC,iBAAetB,SAAS,SAASuB;wBACjCJ,SAAS,CAACK,QAAUvB,UAAUuB,MAAMC,aAAa;kCAEhD;;kCAEH,KAAC9C;wBAAK+C,UAAU1B;wBAAQ2B,MAAMC,QAAQ5B;wBAAS6B,SAAS,IAAM5B,UAAU;kCACrElB,uBAAuB+C,GAAG,CAAC,CAACtB,uBAC3B,KAAC5B;gCAAyBuC,SAAS,IAAM,KAAKZ,UAAUC,OAAOuB,EAAE;0CAC/D,cAAA,KAACrD;oCAAasD,SAASxB,OAAOrB,KAAK;oCAAE8C,WAAWzB,OAAO0B,WAAW;;+BADrD1B,OAAOuB,EAAE;;;iBAM5B;;;AAGV;AACArC,qBAAqByC,WAAW,GAAG;AAEnC,eAAezC,qBAAoB"}

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

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { authorizedFetch } from '@aglyn/shared-util-http/authorized-token';
+import * as Webhooks from '../../model/order-webhooks';
+export interface OrderWebhooksCardProps {
+    hostId: string;
+}
+type EndpointRow = Webhooks.OrderWebhookEndpoint & {
+    $id: string;
+};
+type DeliveryRow = Webhooks.OrderWebhookDelivery & {
+    $id: string;
+};
+/** POSTs one action to the webhooks route; answers the body or throws its error. */
+export declare function callOrderWebhooks(user: Parameters<typeof authorizedFetch>[0], hostId: string, body: Record<string, unknown>): Promise<Record<string, any>>;
+/**
+ * Order webhooks (AGL-3611): the store's endpoints for order and return
+ * events, each with its signing secret, a test event and a delivery log. Shown
+ * only to the people who may manage them — the route answers who — and only
+ * where the deployment can sign.
+ */
+export declare function OrderWebhooksCard(props: OrderWebhooksCardProps): import("react").JSX.Element;
+export declare namespace OrderWebhooksCard {
+    var displayName: string;
+}
+interface DeliveriesDialogProps {
+    hostId: string;
+    endpoint: EndpointRow;
+    labelFor: (event: string) => string;
+    busy: boolean;
+    onResend: (delivery: DeliveryRow) => void | Promise<void>;
+    onClose: () => void;
+}
+/** The endpoint's delivery log, newest first, filtered and paged by a Firestore query. */
+export declare function DeliveriesDialog(props: DeliveriesDialogProps): import("react").JSX.Element;
+export default OrderWebhooksCard;