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

package/src/lib/constants/return-request.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @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.
+ */
+/**
+ * The buyer's "Request a return" page (AGL-3611).
+ *
+ * The component id is persisted in screen documents; never rename it. The
+ * path is where the site serves the page when it has no page of its own
+ * there, and where the account block and the order-status page link to.
+ */
+export declare const RETURN_REQUEST_COMPONENT_ID = "return-request";
+export declare const RETURN_REQUEST_PATH = "order-return";
+/** The page's address for one order, with the status-link token when there is one. */
+export declare function returnRequestHref(orderId: string, token?: string | null): string;

package/src/lib/constants/return-request.js

@@ -0,0 +1,32 @@
+/**
+ * @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.
+ */ /**
+ * The buyer's "Request a return" page (AGL-3611).
+ *
+ * The component id is persisted in screen documents; never rename it. The
+ * path is where the site serves the page when it has no page of its own
+ * there, and where the account block and the order-status page link to.
+ */ export const RETURN_REQUEST_COMPONENT_ID = 'return-request';
+export const RETURN_REQUEST_PATH = 'order-return';
+/** The page's address for one order, with the status-link token when there is one. */ export function returnRequestHref(orderId, token) {
+    const query = new URLSearchParams({
+        o: orderId
+    });
+    if (token) query.set('t', token);
+    return `/${RETURN_REQUEST_PATH}?${query.toString()}`;
+}
+
+//# sourceMappingURL=return-request.js.map

package/src/lib/constants/return-request.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/constants/return-request.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\n/**\n * The buyer's \"Request a return\" page (AGL-3611).\n *\n * The component id is persisted in screen documents; never rename it. The\n * path is where the site serves the page when it has no page of its own\n * there, and where the account block and the order-status page link to.\n */\nexport const RETURN_REQUEST_COMPONENT_ID = 'return-request'\n\nexport const RETURN_REQUEST_PATH = 'order-return'\n\n/** The page's address for one order, with the status-link token when there is one. */\nexport function returnRequestHref(orderId: string, token?: string | null): string {\n  const query = new URLSearchParams({ o: orderId })\n  if (token) query.set('t', token)\n  return `/${RETURN_REQUEST_PATH}?${query.toString()}`\n}\n"],"names":["RETURN_REQUEST_COMPONENT_ID","RETURN_REQUEST_PATH","returnRequestHref","orderId","token","query","URLSearchParams","o","set","toString"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;CAMC,GACD,OAAO,MAAMA,8BAA8B,iBAAgB;AAE3D,OAAO,MAAMC,sBAAsB,eAAc;AAEjD,oFAAoF,GACpF,OAAO,SAASC,kBAAkBC,OAAe,EAAEC,KAAqB;IACtE,MAAMC,QAAQ,IAAIC,gBAAgB;QAAEC,GAAGJ;IAAQ;IAC/C,IAAIC,OAAOC,MAAMG,GAAG,CAAC,KAAKJ;IAC1B,OAAO,CAAC,CAAC,EAAEH,oBAAoB,CAAC,EAAEI,MAAMI,QAAQ,IAAI;AACtD"}

package/src/lib/constants/stock-movement-query.js

@@ -104,7 +104,8 @@ export const STOCK_MOVEMENT_FILTER_HEADERS = {
     restock: 'Restock',
     correction: 'Correction',
     damage: 'Damaged',
-    cancellation: 'Order canceled'
+    cancellation: 'Order canceled',
+    sync: 'Count synced'
 };
 
 //# sourceMappingURL=stock-movement-query.js.map

package/src/lib/constants/stock-movement-query.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/constants/stock-movement-query.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 type { ListFilterField } from '@aglyn/shared-ui-jsx/const/list-filter'\nimport type { ListQueryDeclaration } from '@aglyn/shared-ui-jsx/const/list-query-plan'\nimport type { InventoryAdjustmentReason } from '../model/commerce'\n\n/*\n * What the stock movements ledger filters by, and how its query serves it\n * (AGL-3321).\n *\n * Every field is one every writer of `hosts/{hostId}/inventoryAdjustments`\n * already stores — the \"Adjust stock\" dialog, the sale path\n * (`decrementVariantStock`) and the cancellation restock — so nothing new is\n * written and nothing needs a backfill. Each is an EQUALITY beneath the\n * ledger's one order, `atMs` newest first, which is one `(field, atMs DESC)`\n * composite per field under index merging; the date filter is a range on\n * `atMs` itself, the order the ledger is already in, so it costs nothing.\n *\n * Order and location are typed or picked ids, matched whole. A sparse field\n * answers `equals` exactly — a row with no order is simply not that order —\n * and offers no \"is set\", which would be an inequality on a second field.\n *\n * No quick search. The ledger's rows name a product by id; the name a reader\n * would type lives on the product, so a search could only ever match the\n * names of the rows already loaded. Product is a picked filter instead, and\n * the ids the old search read (order, location) are filters of their own.\n */\nexport const STOCK_MOVEMENT_FILTER_FIELDS: readonly ListFilterField[] = [\n  { column: 'productId', kind: 'exact', path: 'productId', operators: ['equals', 'isAnyOf'] },\n  { column: 'reason', kind: 'exact', path: 'reason', operators: ['equals', 'isAnyOf'] },\n  { column: 'atMs', kind: 'date', path: 'atMs', storedAs: 'millis', presence: 'always' },\n  { column: 'orderId', kind: 'exact', path: 'orderId', operators: ['equals'] },\n  { column: 'locationId', kind: 'exact', path: 'locationId', operators: ['equals'] },\n]\n\n/** The ledger's one order: newest first, the order every writer stamps. */\nexport const STOCK_MOVEMENT_QUERY: ListQueryDeclaration = {\n  fields: STOCK_MOVEMENT_FILTER_FIELDS,\n  sorts: [{ path: 'atMs', direction: 'desc', column: 'atMs' }],\n}\n\nexport const STOCK_MOVEMENT_FILTER_HEADERS: Readonly<Record<string, string>> = {\n  productId: 'Product',\n  reason: 'Reason',\n  atMs: 'When',\n  orderId: 'Order',\n  locationId: 'Location',\n}\n\n/** The fields picked from choices rather than typed. */\nexport const STOCK_MOVEMENT_SELECT_FIELDS: readonly string[] = ['productId', 'reason', 'locationId']\n\n/** The stored key is a closed set; these are what a merchant reads. */\nexport const STOCK_MOVEMENT_REASON_LABEL: Readonly<Record<InventoryAdjustmentReason, string>> = {\n  sale: 'Sale',\n  refund: 'Refund return',\n  restock: 'Restock',\n  correction: 'Correction',\n  damage: 'Damaged',\n  cancellation: 'Order canceled',\n}\n"],"names":["STOCK_MOVEMENT_FILTER_FIELDS","column","kind","path","operators","storedAs","presence","STOCK_MOVEMENT_QUERY","fields","sorts","direction","STOCK_MOVEMENT_FILTER_HEADERS","productId","reason","atMs","orderId","locationId","STOCK_MOVEMENT_SELECT_FIELDS","STOCK_MOVEMENT_REASON_LABEL","sale","refund","restock","correction","damage","cancellation"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAMD;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,MAAMA,+BAA2D;IACtE;QAAEC,QAAQ;QAAaC,MAAM;QAASC,MAAM;QAAaC,WAAW;YAAC;YAAU;SAAU;IAAC;IAC1F;QAAEH,QAAQ;QAAUC,MAAM;QAASC,MAAM;QAAUC,WAAW;YAAC;YAAU;SAAU;IAAC;IACpF;QAAEH,QAAQ;QAAQC,MAAM;QAAQC,MAAM;QAAQE,UAAU;QAAUC,UAAU;IAAS;IACrF;QAAEL,QAAQ;QAAWC,MAAM;QAASC,MAAM;QAAWC,WAAW;YAAC;SAAS;IAAC;IAC3E;QAAEH,QAAQ;QAAcC,MAAM;QAASC,MAAM;QAAcC,WAAW;YAAC;SAAS;IAAC;CAClF,CAAA;AAED,yEAAyE,GACzE,OAAO,MAAMG,uBAA6C;IACxDC,QAAQR;IACRS,OAAO;QAAC;YAAEN,MAAM;YAAQO,WAAW;YAAQT,QAAQ;QAAO;KAAE;AAC9D,EAAC;AAED,OAAO,MAAMU,gCAAkE;IAC7EC,WAAW;IACXC,QAAQ;IACRC,MAAM;IACNC,SAAS;IACTC,YAAY;AACd,EAAC;AAED,sDAAsD,GACtD,OAAO,MAAMC,+BAAkD;IAAC;IAAa;IAAU;CAAa,CAAA;AAEpG,qEAAqE,GACrE,OAAO,MAAMC,8BAAmF;IAC9FC,MAAM;IACNC,QAAQ;IACRC,SAAS;IACTC,YAAY;IACZC,QAAQ;IACRC,cAAc;AAChB,EAAC"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/constants/stock-movement-query.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 type { ListFilterField } from '@aglyn/shared-ui-jsx/const/list-filter'\nimport type { ListQueryDeclaration } from '@aglyn/shared-ui-jsx/const/list-query-plan'\nimport type { InventoryAdjustmentReason } from '../model/commerce'\n\n/*\n * What the stock movements ledger filters by, and how its query serves it\n * (AGL-3321).\n *\n * Every field is one every writer of `hosts/{hostId}/inventoryAdjustments`\n * already stores — the \"Adjust stock\" dialog, the sale path\n * (`decrementVariantStock`) and the cancellation restock — so nothing new is\n * written and nothing needs a backfill. Each is an EQUALITY beneath the\n * ledger's one order, `atMs` newest first, which is one `(field, atMs DESC)`\n * composite per field under index merging; the date filter is a range on\n * `atMs` itself, the order the ledger is already in, so it costs nothing.\n *\n * Order and location are typed or picked ids, matched whole. A sparse field\n * answers `equals` exactly — a row with no order is simply not that order —\n * and offers no \"is set\", which would be an inequality on a second field.\n *\n * No quick search. The ledger's rows name a product by id; the name a reader\n * would type lives on the product, so a search could only ever match the\n * names of the rows already loaded. Product is a picked filter instead, and\n * the ids the old search read (order, location) are filters of their own.\n */\nexport const STOCK_MOVEMENT_FILTER_FIELDS: readonly ListFilterField[] = [\n  { column: 'productId', kind: 'exact', path: 'productId', operators: ['equals', 'isAnyOf'] },\n  { column: 'reason', kind: 'exact', path: 'reason', operators: ['equals', 'isAnyOf'] },\n  { column: 'atMs', kind: 'date', path: 'atMs', storedAs: 'millis', presence: 'always' },\n  { column: 'orderId', kind: 'exact', path: 'orderId', operators: ['equals'] },\n  { column: 'locationId', kind: 'exact', path: 'locationId', operators: ['equals'] },\n]\n\n/** The ledger's one order: newest first, the order every writer stamps. */\nexport const STOCK_MOVEMENT_QUERY: ListQueryDeclaration = {\n  fields: STOCK_MOVEMENT_FILTER_FIELDS,\n  sorts: [{ path: 'atMs', direction: 'desc', column: 'atMs' }],\n}\n\nexport const STOCK_MOVEMENT_FILTER_HEADERS: Readonly<Record<string, string>> = {\n  productId: 'Product',\n  reason: 'Reason',\n  atMs: 'When',\n  orderId: 'Order',\n  locationId: 'Location',\n}\n\n/** The fields picked from choices rather than typed. */\nexport const STOCK_MOVEMENT_SELECT_FIELDS: readonly string[] = ['productId', 'reason', 'locationId']\n\n/** The stored key is a closed set; these are what a merchant reads. */\nexport const STOCK_MOVEMENT_REASON_LABEL: Readonly<Record<InventoryAdjustmentReason, string>> = {\n  sale: 'Sale',\n  refund: 'Refund return',\n  restock: 'Restock',\n  correction: 'Correction',\n  damage: 'Damaged',\n  cancellation: 'Order canceled',\n  sync: 'Count synced',\n}\n"],"names":["STOCK_MOVEMENT_FILTER_FIELDS","column","kind","path","operators","storedAs","presence","STOCK_MOVEMENT_QUERY","fields","sorts","direction","STOCK_MOVEMENT_FILTER_HEADERS","productId","reason","atMs","orderId","locationId","STOCK_MOVEMENT_SELECT_FIELDS","STOCK_MOVEMENT_REASON_LABEL","sale","refund","restock","correction","damage","cancellation","sync"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAMD;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,MAAMA,+BAA2D;IACtE;QAAEC,QAAQ;QAAaC,MAAM;QAASC,MAAM;QAAaC,WAAW;YAAC;YAAU;SAAU;IAAC;IAC1F;QAAEH,QAAQ;QAAUC,MAAM;QAASC,MAAM;QAAUC,WAAW;YAAC;YAAU;SAAU;IAAC;IACpF;QAAEH,QAAQ;QAAQC,MAAM;QAAQC,MAAM;QAAQE,UAAU;QAAUC,UAAU;IAAS;IACrF;QAAEL,QAAQ;QAAWC,MAAM;QAASC,MAAM;QAAWC,WAAW;YAAC;SAAS;IAAC;IAC3E;QAAEH,QAAQ;QAAcC,MAAM;QAASC,MAAM;QAAcC,WAAW;YAAC;SAAS;IAAC;CAClF,CAAA;AAED,yEAAyE,GACzE,OAAO,MAAMG,uBAA6C;IACxDC,QAAQR;IACRS,OAAO;QAAC;YAAEN,MAAM;YAAQO,WAAW;YAAQT,QAAQ;QAAO;KAAE;AAC9D,EAAC;AAED,OAAO,MAAMU,gCAAkE;IAC7EC,WAAW;IACXC,QAAQ;IACRC,MAAM;IACNC,SAAS;IACTC,YAAY;AACd,EAAC;AAED,sDAAsD,GACtD,OAAO,MAAMC,+BAAkD;IAAC;IAAa;IAAU;CAAa,CAAA;AAEpG,qEAAqE,GACrE,OAAO,MAAMC,8BAAmF;IAC9FC,MAAM;IACNC,QAAQ;IACRC,SAAS;IACTC,YAAY;IACZC,QAAQ;IACRC,cAAc;IACdC,MAAM;AACR,EAAC"}

package/src/lib/declarations.console-server.js

@@ -17,7 +17,9 @@
 // registry, not the whole server surface.
 import { registerApiV1SiteResource } from "@aglyn/tenant-data-admin/server/api-v1-resources";
 import { registerPluginPersonEraser } from "@aglyn/aglyn/plugin-manager/plugin-person-erasure";
+import { registerPluginService } from "@aglyn/aglyn/plugin-manager/plugin-services";
 import { BUNDLE_ID } from "./constants/bundle-common.js";
+import { ORDER_HISTORY_CONTRACT } from "./model/order-history.js";
 import { registerCommerceTransferResources } from "./transfer/register-transfer-resources.js";
 /**
  * The commerce plugin's CONSOLE-ONLY server declarations, named under
@@ -46,6 +48,13 @@ import { registerCommerceTransferResources } from "./transfer/register-transfer-
     registerPluginPersonEraser(async (request)=>(await import("./server/person-eraser.js")).commercePersonEraser(request), {
         pluginId: BUNDLE_ID
     });
+    // A site's earlier orders, for a plugin that reads history behind the
+    // order events (AGL-3614); the reader is loaded with the first page asked.
+    registerPluginService(ORDER_HISTORY_CONTRACT, {
+        listOrders: async (request)=>(await import("./server/order-history.js")).listOrderHistory(request)
+    }, {
+        pluginId: BUNDLE_ID
+    });
     registerApiV1SiteResource('products', {
         handle: async (...args)=>(await import("./server/api-v1/orders-and-products.js")).handleProducts(...args),
         describe: async ()=>(await import("./server/api-v1/openapi.js")).PRODUCTS_API_V1_DESCRIPTION

package/src/lib/declarations.console-server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/declarations.console-server.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\n// The registry's own module, not the data layer's barrel: boot needs the\n// registry, not the whole server surface.\nimport { registerApiV1SiteResource } from '@aglyn/tenant-data-admin/server/api-v1-resources'\nimport { registerPluginPersonEraser } from '@aglyn/aglyn/plugin-manager/plugin-person-erasure'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { registerCommerceTransferResources } from './transfer/register-transfer-resources'\n\n/**\n * The commerce plugin's CONSOLE-ONLY server declarations, named under\n * `consoleServerDeclarations` in `plugins.config.json` and run at the\n * console's boot. The tenant runtime registers none of it.\n *\n * It serves a site's products and orders on the customer REST API,\n * `/v1/sites/{siteId}/products/…` and `/v1/sites/{siteId}/orders/…`: the\n * console's router owns the pipeline in front — the key, the plan's API\n * access, the quota, the rate limit, the error envelope — and the site's\n * ownership, and hands every request under each resource here.\n *\n * No plan feature is named on the registrations, though both need\n * `commerce`: the handlers ask the key's scope FIRST and the plan second\n * (AGL-900, AGL-1928), so a key without the scope is told about the scope\n * whatever plan its organization is on, and the router would ask in the\n * opposite order.\n *\n * Light at boot: the handlers are imported with their first request and the\n * descriptions when the document is first built. Registering again replaces\n * this plugin's own entries.\n */\nexport function registerCommerceConsoleServerDeclarations(): void {\n  // Commerce's share of a person erasure (AGL-2623, AGL-3080): every order the\n  // person placed keeps its amounts, with the buyer taken off it. Required,\n  // and loaded with the first erasure.\n  registerPluginPersonEraser(\n    async (request) => (await import('./server/person-eraser')).commercePersonEraser(request),\n    { pluginId: BUNDLE_ID },\n  )\n  registerApiV1SiteResource(\n    'products',\n    {\n      handle: async (...args) =>\n        (await import('./server/api-v1/orders-and-products')).handleProducts(...args),\n      describe: async () =>\n        (await import('./server/api-v1/openapi')).PRODUCTS_API_V1_DESCRIPTION,\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  registerApiV1SiteResource(\n    'orders',\n    {\n      handle: async (...args) =>\n        (await import('./server/api-v1/orders-and-products')).handleOrders(...args),\n      describe: async () =>\n        (await import('./server/api-v1/openapi')).ORDERS_API_V1_DESCRIPTION,\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  // Products, categories, orders, discounts, coupons and gift cards on the\n  // import wizard and the export dialog (AGL-3531): the transfer routes are\n  // the console's alone, so they register here.\n  registerCommerceTransferResources()\n}\n"],"names":["registerApiV1SiteResource","registerPluginPersonEraser","BUNDLE_ID","registerCommerceTransferResources","registerCommerceConsoleServerDeclarations","request","commercePersonEraser","pluginId","handle","args","handleProducts","describe","PRODUCTS_API_V1_DESCRIPTION","handleOrders","ORDERS_API_V1_DESCRIPTION"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,yEAAyE;AACzE,0CAA0C;AAC1C,SAASA,yBAAyB,QAAQ,mDAAkD;AAC5F,SAASC,0BAA0B,QAAQ,oDAAmD;AAC9F,SAASC,SAAS,QAAQ,+BAA2B;AACrD,SAASC,iCAAiC,QAAQ,4CAAwC;AAE1F;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,SAASC;IACd,6EAA6E;IAC7E,0EAA0E;IAC1E,qCAAqC;IACrCH,2BACE,OAAOI,UAAY,AAAC,CAAA,MAAM,MAAM,CAAC,4BAAwB,EAAGC,oBAAoB,CAACD,UACjF;QAAEE,UAAUL;IAAU;IAExBF,0BACE,YACA;QACEQ,QAAQ,OAAO,GAAGC,OAChB,AAAC,CAAA,MAAM,MAAM,CAAC,yCAAqC,EAAGC,cAAc,IAAID;QAC1EE,UAAU,UACR,AAAC,CAAA,MAAM,MAAM,CAAC,6BAAyB,EAAGC,2BAA2B;IACzE,GACA;QAAEL,UAAUL;IAAU;IAExBF,0BACE,UACA;QACEQ,QAAQ,OAAO,GAAGC,OAChB,AAAC,CAAA,MAAM,MAAM,CAAC,yCAAqC,EAAGI,YAAY,IAAIJ;QACxEE,UAAU,UACR,AAAC,CAAA,MAAM,MAAM,CAAC,6BAAyB,EAAGG,yBAAyB;IACvE,GACA;QAAEP,UAAUL;IAAU;IAExB,yEAAyE;IACzE,0EAA0E;IAC1E,8CAA8C;IAC9CC;AACF"}
+{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/declarations.console-server.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\n// The registry's own module, not the data layer's barrel: boot needs the\n// registry, not the whole server surface.\nimport { registerApiV1SiteResource } from '@aglyn/tenant-data-admin/server/api-v1-resources'\nimport { registerPluginPersonEraser } from '@aglyn/aglyn/plugin-manager/plugin-person-erasure'\nimport { registerPluginService } from '@aglyn/aglyn/plugin-manager/plugin-services'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { ORDER_HISTORY_CONTRACT } from './model/order-history'\nimport { registerCommerceTransferResources } from './transfer/register-transfer-resources'\n\n/**\n * The commerce plugin's CONSOLE-ONLY server declarations, named under\n * `consoleServerDeclarations` in `plugins.config.json` and run at the\n * console's boot. The tenant runtime registers none of it.\n *\n * It serves a site's products and orders on the customer REST API,\n * `/v1/sites/{siteId}/products/…` and `/v1/sites/{siteId}/orders/…`: the\n * console's router owns the pipeline in front — the key, the plan's API\n * access, the quota, the rate limit, the error envelope — and the site's\n * ownership, and hands every request under each resource here.\n *\n * No plan feature is named on the registrations, though both need\n * `commerce`: the handlers ask the key's scope FIRST and the plan second\n * (AGL-900, AGL-1928), so a key without the scope is told about the scope\n * whatever plan its organization is on, and the router would ask in the\n * opposite order.\n *\n * Light at boot: the handlers are imported with their first request and the\n * descriptions when the document is first built. Registering again replaces\n * this plugin's own entries.\n */\nexport function registerCommerceConsoleServerDeclarations(): void {\n  // Commerce's share of a person erasure (AGL-2623, AGL-3080): every order the\n  // person placed keeps its amounts, with the buyer taken off it. Required,\n  // and loaded with the first erasure.\n  registerPluginPersonEraser(\n    async (request) => (await import('./server/person-eraser')).commercePersonEraser(request),\n    { pluginId: BUNDLE_ID },\n  )\n  // A site's earlier orders, for a plugin that reads history behind the\n  // order events (AGL-3614); the reader is loaded with the first page asked.\n  registerPluginService(\n    ORDER_HISTORY_CONTRACT,\n    { listOrders: async (request) => (await import('./server/order-history')).listOrderHistory(request) },\n    { pluginId: BUNDLE_ID },\n  )\n  registerApiV1SiteResource(\n    'products',\n    {\n      handle: async (...args) =>\n        (await import('./server/api-v1/orders-and-products')).handleProducts(...args),\n      describe: async () =>\n        (await import('./server/api-v1/openapi')).PRODUCTS_API_V1_DESCRIPTION,\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  registerApiV1SiteResource(\n    'orders',\n    {\n      handle: async (...args) =>\n        (await import('./server/api-v1/orders-and-products')).handleOrders(...args),\n      describe: async () =>\n        (await import('./server/api-v1/openapi')).ORDERS_API_V1_DESCRIPTION,\n    },\n    { pluginId: BUNDLE_ID },\n  )\n  // Products, categories, orders, discounts, coupons and gift cards on the\n  // import wizard and the export dialog (AGL-3531): the transfer routes are\n  // the console's alone, so they register here.\n  registerCommerceTransferResources()\n}\n"],"names":["registerApiV1SiteResource","registerPluginPersonEraser","registerPluginService","BUNDLE_ID","ORDER_HISTORY_CONTRACT","registerCommerceTransferResources","registerCommerceConsoleServerDeclarations","request","commercePersonEraser","pluginId","listOrders","listOrderHistory","handle","args","handleProducts","describe","PRODUCTS_API_V1_DESCRIPTION","handleOrders","ORDERS_API_V1_DESCRIPTION"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,yEAAyE;AACzE,0CAA0C;AAC1C,SAASA,yBAAyB,QAAQ,mDAAkD;AAC5F,SAASC,0BAA0B,QAAQ,oDAAmD;AAC9F,SAASC,qBAAqB,QAAQ,8CAA6C;AACnF,SAASC,SAAS,QAAQ,+BAA2B;AACrD,SAASC,sBAAsB,QAAQ,2BAAuB;AAC9D,SAASC,iCAAiC,QAAQ,4CAAwC;AAE1F;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,SAASC;IACd,6EAA6E;IAC7E,0EAA0E;IAC1E,qCAAqC;IACrCL,2BACE,OAAOM,UAAY,AAAC,CAAA,MAAM,MAAM,CAAC,4BAAwB,EAAGC,oBAAoB,CAACD,UACjF;QAAEE,UAAUN;IAAU;IAExB,sEAAsE;IACtE,2EAA2E;IAC3ED,sBACEE,wBACA;QAAEM,YAAY,OAAOH,UAAY,AAAC,CAAA,MAAM,MAAM,CAAC,4BAAwB,EAAGI,gBAAgB,CAACJ;IAAS,GACpG;QAAEE,UAAUN;IAAU;IAExBH,0BACE,YACA;QACEY,QAAQ,OAAO,GAAGC,OAChB,AAAC,CAAA,MAAM,MAAM,CAAC,yCAAqC,EAAGC,cAAc,IAAID;QAC1EE,UAAU,UACR,AAAC,CAAA,MAAM,MAAM,CAAC,6BAAyB,EAAGC,2BAA2B;IACzE,GACA;QAAEP,UAAUN;IAAU;IAExBH,0BACE,UACA;QACEY,QAAQ,OAAO,GAAGC,OAChB,AAAC,CAAA,MAAM,MAAM,CAAC,yCAAqC,EAAGI,YAAY,IAAIJ;QACxEE,UAAU,UACR,AAAC,CAAA,MAAM,MAAM,CAAC,6BAAyB,EAAGG,yBAAyB;IACvE,GACA;QAAET,UAAUN;IAAU;IAExB,yEAAyE;IACzE,0EAA0E;IAC1E,8CAA8C;IAC9CE;AACF"}

package/src/lib/declarations.server.d.ts

@@ -16,7 +16,8 @@
  */
 /**
  * The commerce plugin's server declarations: the light registrations core
- * reads at boot, before any surface loads.
+ * reads at boot, before any surface loads — among them its orders as a label
+ * buyer reads and writes them, through core's `core.shipment-records`.
  *
  * Its operator alerts (AGL-3377), so Staff → Operator alerts lists them and
  * staff can switch them before the first one is ever raised; and the indexes

package/src/lib/declarations.server.js

@@ -16,12 +16,20 @@
  */ // The seam from its own module, not the plugin-manager barrel: boot needs the
 // registry and nothing else, and the barrel reaches the client contexts.
 import { registerOperatorAlerts } from "@aglyn/aglyn/plugin-manager/operator-alerts";
+import { registerPluginEventHandler } from "@aglyn/aglyn/plugin-manager/plugin-events";
 import { registerPluginRecordIndex } from "@aglyn/aglyn/plugin-manager/plugin-record-index";
+import { registerPluginShipmentRecords } from "@aglyn/aglyn/plugin-manager/plugin-shipment-records";
+import { registerPluginProductCatalog } from "@aglyn/aglyn/plugin-manager/plugin-product-catalog";
+import { registerPluginStockLevels } from "@aglyn/aglyn/plugin-manager/plugin-stock-levels";
+import { registerPluginChannelOrders } from "@aglyn/aglyn/plugin-manager/plugin-channel-orders";
+import { registerPluginProductWriter } from "@aglyn/aglyn/plugin-manager/plugin-product-writer";
 import { BUNDLE_ID } from "./constants/bundle-common.js";
 import { COMMERCE_OPERATOR_ALERTS } from "./constants/operator-alerts.js";
+import { registerCommerceEventTriggers } from "./server/order-event-triggers.js";
 /**
  * The commerce plugin's server declarations: the light registrations core
- * reads at boot, before any surface loads.
+ * reads at boot, before any surface loads — among them its orders as a label
+ * buyer reads and writes them, through core's `core.shipment-records`.
  *
  * Its operator alerts (AGL-3377), so Staff → Operator alerts lists them and
  * staff can switch them before the first one is ever raised; and the indexes
@@ -31,6 +39,8 @@ import { COMMERCE_OPERATOR_ALERTS } from "./constants/operator-alerts.js";
     registerOperatorAlerts(COMMERCE_OPERATOR_ALERTS, {
         pluginId: BUNDLE_ID
     });
+    // Its order and return events (AGL-3611), and each as a workflow trigger.
+    registerCommerceEventTriggers();
     // Products and categories, as another plugin reads them (AGL-3080). The
     // readers and the Admin SDK arrive with the first read, not with the boot.
     registerPluginRecordIndex('product', lazyIndex('productRecordIndex'), {
@@ -39,7 +49,64 @@ import { COMMERCE_OPERATOR_ALERTS } from "./constants/operator-alerts.js";
     registerPluginRecordIndex('productCategory', lazyIndex('productCategoryRecordIndex'), {
         pluginId: BUNDLE_ID
     });
+    // Orders, as a label buyer reads and writes them (AGL-3612): read the
+    // lines and the address, write a shipment, record tracking. The module and
+    // the Admin SDK load with the first call.
+    registerPluginShipmentRecords(lazyShipmentRecords, {
+        pluginId: BUNDLE_ID
+    });
+    // A site's domains as Stripe payment method domains (AGL-3629), so Apple
+    // Pay and the other wallets show on the merchant's own domain. The Stripe
+    // calls arrive with the first event, not with the boot.
+    registerPluginEventHandler('host.domain.attached', async (payload)=>(await import("./server/payment-method-domains.js")).onHostDomainAttached(payload), {
+        pluginId: BUNDLE_ID
+    });
+    registerPluginEventHandler('host.domain.released', async (payload)=>(await import("./server/payment-method-domains.js")).onHostDomainReleased(payload), {
+        pluginId: BUNDLE_ID
+    });
+    // The store's catalog, as a shopping-channel feed reads it (AGL-3637).
+    registerPluginProductCatalog(lazyCatalog, {
+        pluginId: BUNDLE_ID
+    });
+    // Counts another warehouse keeps, applied as a stock-take (AGL-3634): a
+    // fulfillment network says how many it can ship and the products say so.
+    registerPluginStockLevels(lazyStockLevels, {
+        pluginId: BUNDLE_ID
+    });
+    // Products another plugin brings from a source of its own (AGL-3641),
+    // written through the store's own rules.
+    registerPluginProductWriter(lazyProductWriter, {
+        pluginId: BUNDLE_ID
+    });
+    // Orders a marketplace sold (AGL-3638), recorded as this plugin's own:
+    // numbered, their units off the same shelf in the same write, announced.
+    registerPluginChannelOrders(lazyChannelOrders, {
+        pluginId: BUNDLE_ID
+    });
 }
+/** Outside orders, with the Admin SDK and the model arriving on the first call. */ const loadChannelOrders = async ()=>(await import("./server/channel-orders.js")).commerceChannelOrders;
+const lazyChannelOrders = {
+    importOrder: async (order)=>(await loadChannelOrders()).importOrder(order),
+    cancelOrder: async (request)=>(await loadChannelOrders()).cancelOrder(request),
+    recordFees: async (request)=>(await loadChannelOrders()).recordFees(request)
+};
+/** Stock counts, with the Admin SDK and the model arriving on the first call. */ const lazyStockLevels = {
+    setAvailable: async (request)=>(await import("./server/stock-levels.js")).commerceStockLevels.setAvailable(request)
+};
+/** The writer, with the Admin SDK and the model arriving on the first write. */ const lazyProductWriter = {
+    upsertSourced: async (write)=>(await import("./server/product-writer.js")).commerceProductWriter.upsertSourced(write)
+};
+const loadShipmentRecords = async ()=>(await import("./server/shipment-records.js")).commerceShipmentRecords;
+const lazyShipmentRecords = {
+    read: async (hostId, recordId)=>(await loadShipmentRecords()).read(hostId, recordId),
+    recordShipment: async (write)=>(await loadShipmentRecords()).recordShipment(write),
+    recordTracking: async (update)=>(await loadShipmentRecords()).recordTracking(update),
+    shipFromAddresses: async (hostId)=>(await loadShipmentRecords()).shipFromAddresses(hostId)
+};
+/** The catalog, with the Admin SDK and the model arriving on the first read. */ const lazyCatalog = {
+    store: async (hostId)=>(await import("./server/product-catalog.js")).productCatalog.store(hostId),
+    page: async (request)=>(await import("./server/product-catalog.js")).productCatalog.page(request)
+};
 function lazyIndex(name) {
     const load = async ()=>(await import("./server/product-record-index.js"))[name];
     return {

package/src/lib/declarations.server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/declarations.server.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\n// The seam from its own module, not the plugin-manager barrel: boot needs the\n// registry and nothing else, and the barrel reaches the client contexts.\nimport { registerOperatorAlerts } from '@aglyn/aglyn/plugin-manager/operator-alerts'\nimport {\n  registerPluginRecordIndex,\n  type PluginRecordIndex,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-index'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { COMMERCE_OPERATOR_ALERTS } from './constants/operator-alerts'\n\n/**\n * The commerce plugin's server declarations: the light registrations core\n * reads at boot, before any surface loads.\n *\n * Its operator alerts (AGL-3377), so Staff → Operator alerts lists them and\n * staff can switch them before the first one is ever raised; and the indexes\n * of its products and categories, so another plugin reads them without\n * reaching for this plugin's collections.\n */\nexport function registerCommerceServerDeclarations(): void {\n  registerOperatorAlerts(COMMERCE_OPERATOR_ALERTS, { pluginId: BUNDLE_ID })\n  // Products and categories, as another plugin reads them (AGL-3080). The\n  // readers and the Admin SDK arrive with the first read, not with the boot.\n  registerPluginRecordIndex('product', lazyIndex('productRecordIndex'), { pluginId: BUNDLE_ID })\n  registerPluginRecordIndex('productCategory', lazyIndex('productCategoryRecordIndex'), {\n    pluginId: BUNDLE_ID,\n  })\n}\n\ntype IndexName = 'productRecordIndex' | 'productCategoryRecordIndex'\n\nfunction lazyIndex(name: IndexName): PluginRecordIndex {\n  const load = async () => (await import('./server/product-record-index'))[name]\n  return {\n    list: async (request) => (await load()).list(request),\n    get: async (request) => (await load()).get(request),\n  }\n}\n"],"names":["registerOperatorAlerts","registerPluginRecordIndex","BUNDLE_ID","COMMERCE_OPERATOR_ALERTS","registerCommerceServerDeclarations","pluginId","lazyIndex","name","load","list","request","get"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,8EAA8E;AAC9E,yEAAyE;AACzE,SAASA,sBAAsB,QAAQ,8CAA6C;AACpF,SACEC,yBAAyB,QAEpB,kDAAiD;AACxD,SAASC,SAAS,QAAQ,+BAA2B;AACrD,SAASC,wBAAwB,QAAQ,iCAA6B;AAEtE;;;;;;;;CAQC,GACD,OAAO,SAASC;IACdJ,uBAAuBG,0BAA0B;QAAEE,UAAUH;IAAU;IACvE,wEAAwE;IACxE,2EAA2E;IAC3ED,0BAA0B,WAAWK,UAAU,uBAAuB;QAAED,UAAUH;IAAU;IAC5FD,0BAA0B,mBAAmBK,UAAU,+BAA+B;QACpFD,UAAUH;IACZ;AACF;AAIA,SAASI,UAAUC,IAAe;IAChC,MAAMC,OAAO,UAAY,AAAC,CAAA,MAAM,MAAM,CAAC,mCAA+B,CAAE,CAACD,KAAK;IAC9E,OAAO;QACLE,MAAM,OAAOC,UAAY,AAAC,CAAA,MAAMF,MAAK,EAAGC,IAAI,CAACC;QAC7CC,KAAK,OAAOD,UAAY,AAAC,CAAA,MAAMF,MAAK,EAAGG,GAAG,CAACD;IAC7C;AACF"}
+{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/declarations.server.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\n// The seam from its own module, not the plugin-manager barrel: boot needs the\n// registry and nothing else, and the barrel reaches the client contexts.\nimport { registerOperatorAlerts } from '@aglyn/aglyn/plugin-manager/operator-alerts'\nimport { registerPluginEventHandler } from '@aglyn/aglyn/plugin-manager/plugin-events'\nimport {\n  registerPluginRecordIndex,\n  type PluginRecordIndex,\n} from '@aglyn/aglyn/plugin-manager/plugin-record-index'\nimport {\n  registerPluginShipmentRecords,\n  type PluginShipmentRecords,\n} from '@aglyn/aglyn/plugin-manager/plugin-shipment-records'\nimport {\n  registerPluginProductCatalog,\n  type PluginProductCatalog,\n} from '@aglyn/aglyn/plugin-manager/plugin-product-catalog'\nimport {\n  registerPluginStockLevels,\n  type PluginStockLevels,\n} from '@aglyn/aglyn/plugin-manager/plugin-stock-levels'\nimport {\n  registerPluginChannelOrders,\n  type PluginChannelOrders,\n} from '@aglyn/aglyn/plugin-manager/plugin-channel-orders'\nimport {\n  registerPluginProductWriter,\n  type PluginProductWriter,\n} from '@aglyn/aglyn/plugin-manager/plugin-product-writer'\nimport { BUNDLE_ID } from './constants/bundle-common'\nimport { COMMERCE_OPERATOR_ALERTS } from './constants/operator-alerts'\nimport { registerCommerceEventTriggers } from './server/order-event-triggers'\n\n/**\n * The commerce plugin's server declarations: the light registrations core\n * reads at boot, before any surface loads — among them its orders as a label\n * buyer reads and writes them, through core's `core.shipment-records`.\n *\n * Its operator alerts (AGL-3377), so Staff → Operator alerts lists them and\n * staff can switch them before the first one is ever raised; and the indexes\n * of its products and categories, so another plugin reads them without\n * reaching for this plugin's collections.\n */\nexport function registerCommerceServerDeclarations(): void {\n  registerOperatorAlerts(COMMERCE_OPERATOR_ALERTS, { pluginId: BUNDLE_ID })\n  // Its order and return events (AGL-3611), and each as a workflow trigger.\n  registerCommerceEventTriggers()\n  // Products and categories, as another plugin reads them (AGL-3080). The\n  // readers and the Admin SDK arrive with the first read, not with the boot.\n  registerPluginRecordIndex('product', lazyIndex('productRecordIndex'), { pluginId: BUNDLE_ID })\n  registerPluginRecordIndex('productCategory', lazyIndex('productCategoryRecordIndex'), {\n    pluginId: BUNDLE_ID,\n  })\n  // Orders, as a label buyer reads and writes them (AGL-3612): read the\n  // lines and the address, write a shipment, record tracking. The module and\n  // the Admin SDK load with the first call.\n  registerPluginShipmentRecords(lazyShipmentRecords, { pluginId: BUNDLE_ID })\n  // A site's domains as Stripe payment method domains (AGL-3629), so Apple\n  // Pay and the other wallets show on the merchant's own domain. The Stripe\n  // calls arrive with the first event, not with the boot.\n  registerPluginEventHandler(\n    'host.domain.attached',\n    async (payload) =>\n      (await import('./server/payment-method-domains')).onHostDomainAttached(payload),\n    { pluginId: BUNDLE_ID },\n  )\n  registerPluginEventHandler(\n    'host.domain.released',\n    async (payload) =>\n      (await import('./server/payment-method-domains')).onHostDomainReleased(payload),\n    { pluginId: BUNDLE_ID },\n  )\n  // The store's catalog, as a shopping-channel feed reads it (AGL-3637).\n  registerPluginProductCatalog(lazyCatalog, { pluginId: BUNDLE_ID })\n  // Counts another warehouse keeps, applied as a stock-take (AGL-3634): a\n  // fulfillment network says how many it can ship and the products say so.\n  registerPluginStockLevels(lazyStockLevels, { pluginId: BUNDLE_ID })\n  // Products another plugin brings from a source of its own (AGL-3641),\n  // written through the store's own rules.\n  registerPluginProductWriter(lazyProductWriter, { pluginId: BUNDLE_ID })\n  // Orders a marketplace sold (AGL-3638), recorded as this plugin's own:\n  // numbered, their units off the same shelf in the same write, announced.\n  registerPluginChannelOrders(lazyChannelOrders, { pluginId: BUNDLE_ID })\n}\n\n/** Outside orders, with the Admin SDK and the model arriving on the first call. */\nconst loadChannelOrders = async () => (await import('./server/channel-orders')).commerceChannelOrders\n\nconst lazyChannelOrders: PluginChannelOrders = {\n  importOrder: async (order) => (await loadChannelOrders()).importOrder(order),\n  cancelOrder: async (request) => (await loadChannelOrders()).cancelOrder(request),\n  recordFees: async (request) => (await loadChannelOrders()).recordFees(request),\n}\n\n/** Stock counts, with the Admin SDK and the model arriving on the first call. */\nconst lazyStockLevels: PluginStockLevels = {\n  setAvailable: async (request) => (await import('./server/stock-levels')).commerceStockLevels.setAvailable(request),\n}\n\n/** The writer, with the Admin SDK and the model arriving on the first write. */\nconst lazyProductWriter: PluginProductWriter = {\n  upsertSourced: async (write) => (await import('./server/product-writer')).commerceProductWriter.upsertSourced(write),\n}\n\nconst loadShipmentRecords = async () =>\n  (await import('./server/shipment-records')).commerceShipmentRecords\n\nconst lazyShipmentRecords: PluginShipmentRecords = {\n  read: async (hostId, recordId) => (await loadShipmentRecords()).read(hostId, recordId),\n  recordShipment: async (write) => (await loadShipmentRecords()).recordShipment(write),\n  recordTracking: async (update) => (await loadShipmentRecords()).recordTracking(update),\n  shipFromAddresses: async (hostId) => (await loadShipmentRecords()).shipFromAddresses(hostId),\n}\n\n/** The catalog, with the Admin SDK and the model arriving on the first read. */\nconst lazyCatalog: PluginProductCatalog = {\n  store: async (hostId) => (await import('./server/product-catalog')).productCatalog.store(hostId),\n  page: async (request) => (await import('./server/product-catalog')).productCatalog.page(request),\n}\n\ntype IndexName = 'productRecordIndex' | 'productCategoryRecordIndex'\n\nfunction lazyIndex(name: IndexName): PluginRecordIndex {\n  const load = async () => (await import('./server/product-record-index'))[name]\n  return {\n    list: async (request) => (await load()).list(request),\n    get: async (request) => (await load()).get(request),\n  }\n}\n"],"names":["registerOperatorAlerts","registerPluginEventHandler","registerPluginRecordIndex","registerPluginShipmentRecords","registerPluginProductCatalog","registerPluginStockLevels","registerPluginChannelOrders","registerPluginProductWriter","BUNDLE_ID","COMMERCE_OPERATOR_ALERTS","registerCommerceEventTriggers","registerCommerceServerDeclarations","pluginId","lazyIndex","lazyShipmentRecords","payload","onHostDomainAttached","onHostDomainReleased","lazyCatalog","lazyStockLevels","lazyProductWriter","lazyChannelOrders","loadChannelOrders","commerceChannelOrders","importOrder","order","cancelOrder","request","recordFees","setAvailable","commerceStockLevels","upsertSourced","write","commerceProductWriter","loadShipmentRecords","commerceShipmentRecords","read","hostId","recordId","recordShipment","recordTracking","update","shipFromAddresses","store","productCatalog","page","name","load","list","get"],"mappings":"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"}

package/src/lib/model/buyer-notifications.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @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.
+ */
+/**
+ * What a store tells its buyer, and when (AGL-3610).
+ *
+ * Five moments in an order's life each send the buyer one message: the
+ * receipt, each shipment, delivery, each refund and a cancellation. A store
+ * turns any of them off on `hosts/{hostId}/settings/store.buyerNotifications`
+ * — and ONLY off: every moment is ON unless an explicit `false` is stored,
+ * because transaction messages are on by default for every store, existing
+ * and new (the 2026-10-06 decision AGL-3600 implemented for the owner's own
+ * notices). An absent map, an absent key and a malformed value all read as
+ * on, so a schema slip can never silence a store's receipts.
+ *
+ * `texts` is the channel switch rather than a moment: when the platform can
+ * send texts and the order carries the buyer's phone number, each moment that
+ * is on also goes by text unless the store turned texts off.
+ */
+export declare const BUYER_NOTIFICATION_EVENTS: readonly ["receipt", "shipped", "delivered", "refunded", "cancelled"];
+export type BuyerNotificationEvent = (typeof BUYER_NOTIFICATION_EVENTS)[number];
+export type BuyerNotificationChannel = 'email' | 'sms';
+export type BuyerNotificationSettings = Partial<Record<BuyerNotificationEvent | 'texts', boolean>>;
+/** The designable email each moment sends: keys in `tenant-emails.ts`. */
+export declare const BUYER_NOTIFICATION_EMAIL_KEYS: Readonly<Record<BuyerNotificationEvent, string>>;
+/** How the store settings card names each moment. */
+export declare const BUYER_NOTIFICATION_LABELS: Readonly<Record<BuyerNotificationEvent, {
+    label: string;
+    description: string;
+}>>;
+/** Whether a moment (or the `texts` channel) is on. Only `false` is off. */
+export declare function buyerNotificationEnabled(settings: unknown, key: BuyerNotificationEvent | 'texts'): boolean;
+/**
+ * The idempotency key for one message: which moment, which occurrence of it
+ * (a shipment id, a refund id; `order` for the once-per-order moments) and
+ * which channel. Stored as a field name under `buyerNotifications` on the
+ * order, so it is restricted to characters a Firestore field path takes
+ * without quoting.
+ */
+export declare function buyerNotificationMarker(event: BuyerNotificationEvent, occurrence: string, channel: BuyerNotificationChannel): string;
+/**
+ * Formats integer cents in the store's currency. Falls back to a plain dollar
+ * figure for a currency code `Intl` does not know, rather than throwing on a
+ * stored typo.
+ */
+export declare function formatOrderMoney(cents: number, currency?: string): string;

package/src/lib/model/buyer-notifications.js

@@ -0,0 +1,97 @@
+/**
+ * @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.
+ */ /**
+ * What a store tells its buyer, and when (AGL-3610).
+ *
+ * Five moments in an order's life each send the buyer one message: the
+ * receipt, each shipment, delivery, each refund and a cancellation. A store
+ * turns any of them off on `hosts/{hostId}/settings/store.buyerNotifications`
+ * — and ONLY off: every moment is ON unless an explicit `false` is stored,
+ * because transaction messages are on by default for every store, existing
+ * and new (the 2026-10-06 decision AGL-3600 implemented for the owner's own
+ * notices). An absent map, an absent key and a malformed value all read as
+ * on, so a schema slip can never silence a store's receipts.
+ *
+ * `texts` is the channel switch rather than a moment: when the platform can
+ * send texts and the order carries the buyer's phone number, each moment that
+ * is on also goes by text unless the store turned texts off.
+ */ export const BUYER_NOTIFICATION_EVENTS = [
+    'receipt',
+    'shipped',
+    'delivered',
+    'refunded',
+    'cancelled'
+];
+/** The designable email each moment sends: keys in `tenant-emails.ts`. */ export const BUYER_NOTIFICATION_EMAIL_KEYS = {
+    receipt: 'order-receipt',
+    shipped: 'order-shipped',
+    delivered: 'order-delivered',
+    refunded: 'order-refunded',
+    cancelled: 'order-cancelled'
+};
+/** How the store settings card names each moment. */ export const BUYER_NOTIFICATION_LABELS = {
+    receipt: {
+        label: 'Order receipt',
+        description: 'When an order is paid: online, from a payment link, or at the register when the customer gives an email.'
+    },
+    shipped: {
+        label: 'Order shipped',
+        description: 'Each time you ship part or all of an order, with the carrier and tracking link.'
+    },
+    delivered: {
+        label: 'Order delivered',
+        description: 'When you mark an order delivered.'
+    },
+    refunded: {
+        label: 'Refund issued',
+        description: 'Each refund, with the amount and any items you named.'
+    },
+    cancelled: {
+        label: 'Order canceled',
+        description: 'When you cancel an order.'
+    }
+};
+/** Whether a moment (or the `texts` channel) is on. Only `false` is off. */ export function buyerNotificationEnabled(settings, key) {
+    if (!settings || typeof settings !== 'object') return true;
+    return settings[key] !== false;
+}
+/**
+ * The idempotency key for one message: which moment, which occurrence of it
+ * (a shipment id, a refund id; `order` for the once-per-order moments) and
+ * which channel. Stored as a field name under `buyerNotifications` on the
+ * order, so it is restricted to characters a Firestore field path takes
+ * without quoting.
+ */ export function buyerNotificationMarker(event, occurrence, channel) {
+    const safe = (value)=>String(value || 'order').replace(/[^A-Za-z0-9_-]/g, '_').slice(0, 120);
+    return `${event}__${safe(occurrence)}__${channel}`;
+}
+/**
+ * Formats integer cents in the store's currency. Falls back to a plain dollar
+ * figure for a currency code `Intl` does not know, rather than throwing on a
+ * stored typo.
+ */ export function formatOrderMoney(cents, currency = 'USD') {
+    const amount = (Number(cents) || 0) / 100;
+    try {
+        return new Intl.NumberFormat('en-US', {
+            style: 'currency',
+            currency: String(currency || 'USD').toUpperCase()
+        }).format(amount);
+    } catch (unused) {
+        return `$${amount.toFixed(2)}`;
+    }
+}
+
+//# sourceMappingURL=buyer-notifications.js.map

package/src/lib/model/buyer-notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/buyer-notifications.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\n/**\n * What a store tells its buyer, and when (AGL-3610).\n *\n * Five moments in an order's life each send the buyer one message: the\n * receipt, each shipment, delivery, each refund and a cancellation. A store\n * turns any of them off on `hosts/{hostId}/settings/store.buyerNotifications`\n * — and ONLY off: every moment is ON unless an explicit `false` is stored,\n * because transaction messages are on by default for every store, existing\n * and new (the 2026-10-06 decision AGL-3600 implemented for the owner's own\n * notices). An absent map, an absent key and a malformed value all read as\n * on, so a schema slip can never silence a store's receipts.\n *\n * `texts` is the channel switch rather than a moment: when the platform can\n * send texts and the order carries the buyer's phone number, each moment that\n * is on also goes by text unless the store turned texts off.\n */\nexport const BUYER_NOTIFICATION_EVENTS = [\n  'receipt',\n  'shipped',\n  'delivered',\n  'refunded',\n  'cancelled',\n] as const\n\nexport type BuyerNotificationEvent = (typeof BUYER_NOTIFICATION_EVENTS)[number]\n\nexport type BuyerNotificationChannel = 'email' | 'sms'\n\nexport type BuyerNotificationSettings = Partial<\n  Record<BuyerNotificationEvent | 'texts', boolean>\n>\n\n/** The designable email each moment sends: keys in `tenant-emails.ts`. */\nexport const BUYER_NOTIFICATION_EMAIL_KEYS: Readonly<\n  Record<BuyerNotificationEvent, string>\n> = {\n  receipt: 'order-receipt',\n  shipped: 'order-shipped',\n  delivered: 'order-delivered',\n  refunded: 'order-refunded',\n  cancelled: 'order-cancelled',\n}\n\n/** How the store settings card names each moment. */\nexport const BUYER_NOTIFICATION_LABELS: Readonly<\n  Record<BuyerNotificationEvent, { label: string; description: string }>\n> = {\n  receipt: {\n    label: 'Order receipt',\n    description:\n      'When an order is paid: online, from a payment link, or at the register when the customer gives an email.',\n  },\n  shipped: {\n    label: 'Order shipped',\n    description:\n      'Each time you ship part or all of an order, with the carrier and tracking link.',\n  },\n  delivered: {\n    label: 'Order delivered',\n    description: 'When you mark an order delivered.',\n  },\n  refunded: {\n    label: 'Refund issued',\n    description: 'Each refund, with the amount and any items you named.',\n  },\n  cancelled: {\n    label: 'Order canceled',\n    description: 'When you cancel an order.',\n  },\n}\n\n/** Whether a moment (or the `texts` channel) is on. Only `false` is off. */\nexport function buyerNotificationEnabled(\n  settings: unknown,\n  key: BuyerNotificationEvent | 'texts',\n): boolean {\n  if (!settings || typeof settings !== 'object') return true\n  return (settings as Record<string, unknown>)[key] !== false\n}\n\n/**\n * The idempotency key for one message: which moment, which occurrence of it\n * (a shipment id, a refund id; `order` for the once-per-order moments) and\n * which channel. Stored as a field name under `buyerNotifications` on the\n * order, so it is restricted to characters a Firestore field path takes\n * without quoting.\n */\nexport function buyerNotificationMarker(\n  event: BuyerNotificationEvent,\n  occurrence: string,\n  channel: BuyerNotificationChannel,\n): string {\n  const safe = (value: string) =>\n    String(value || 'order')\n      .replace(/[^A-Za-z0-9_-]/g, '_')\n      .slice(0, 120)\n  return `${event}__${safe(occurrence)}__${channel}`\n}\n\n/**\n * Formats integer cents in the store's currency. Falls back to a plain dollar\n * figure for a currency code `Intl` does not know, rather than throwing on a\n * stored typo.\n */\nexport function formatOrderMoney(cents: number, currency = 'USD'): string {\n  const amount = (Number(cents) || 0) / 100\n  try {\n    return new Intl.NumberFormat('en-US', {\n      style: 'currency',\n      currency: String(currency || 'USD').toUpperCase(),\n    }).format(amount)\n  } catch {\n    return `$${amount.toFixed(2)}`\n  }\n}\n"],"names":["BUYER_NOTIFICATION_EVENTS","BUYER_NOTIFICATION_EMAIL_KEYS","receipt","shipped","delivered","refunded","cancelled","BUYER_NOTIFICATION_LABELS","label","description","buyerNotificationEnabled","settings","key","buyerNotificationMarker","event","occurrence","channel","safe","value","String","replace","slice","formatOrderMoney","cents","currency","amount","Number","Intl","NumberFormat","style","toUpperCase","format","toFixed"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;CAeC,GACD,OAAO,MAAMA,4BAA4B;IACvC;IACA;IACA;IACA;IACA;CACD,CAAS;AAUV,wEAAwE,GACxE,OAAO,MAAMC,gCAET;IACFC,SAAS;IACTC,SAAS;IACTC,WAAW;IACXC,UAAU;IACVC,WAAW;AACb,EAAC;AAED,mDAAmD,GACnD,OAAO,MAAMC,4BAET;IACFL,SAAS;QACPM,OAAO;QACPC,aACE;IACJ;IACAN,SAAS;QACPK,OAAO;QACPC,aACE;IACJ;IACAL,WAAW;QACTI,OAAO;QACPC,aAAa;IACf;IACAJ,UAAU;QACRG,OAAO;QACPC,aAAa;IACf;IACAH,WAAW;QACTE,OAAO;QACPC,aAAa;IACf;AACF,EAAC;AAED,0EAA0E,GAC1E,OAAO,SAASC,yBACdC,QAAiB,EACjBC,GAAqC;IAErC,IAAI,CAACD,YAAY,OAAOA,aAAa,UAAU,OAAO;IACtD,OAAO,AAACA,QAAoC,CAACC,IAAI,KAAK;AACxD;AAEA;;;;;;CAMC,GACD,OAAO,SAASC,wBACdC,KAA6B,EAC7BC,UAAkB,EAClBC,OAAiC;IAEjC,MAAMC,OAAO,CAACC,QACZC,OAAOD,SAAS,SACbE,OAAO,CAAC,mBAAmB,KAC3BC,KAAK,CAAC,GAAG;IACd,OAAO,GAAGP,MAAM,EAAE,EAAEG,KAAKF,YAAY,EAAE,EAAEC,SAAS;AACpD;AAEA;;;;CAIC,GACD,OAAO,SAASM,iBAAiBC,KAAa,EAAEC,WAAW,KAAK;IAC9D,MAAMC,SAAS,AAACC,CAAAA,OAAOH,UAAU,CAAA,IAAK;IACtC,IAAI;QACF,OAAO,IAAII,KAAKC,YAAY,CAAC,SAAS;YACpCC,OAAO;YACPL,UAAUL,OAAOK,YAAY,OAAOM,WAAW;QACjD,GAAGC,MAAM,CAACN;IACZ,EAAE,eAAM;QACN,OAAO,CAAC,CAAC,EAAEA,OAAOO,OAAO,CAAC,IAAI;IAChC;AACF"}