@aglyn/plugins-commerce 1.0.0-beta.269 → 1.0.0-beta.271

package/src/lib/model/order-events.d.ts

@@ -14,137 +14,20 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { type PluginDomainEvent, type PluginDomainEventDeclaration } from '@aglyn/aglyn/plugin-manager/plugin-domain-events';
+import type { PluginDomainEvent, PluginDomainEventDeclaration } from '@aglyn/aglyn/plugin-manager/plugin-domain-events';
 /**
  * The order and return events commerce raises (AGL-3611), for other plugins
  * — accounting, shipping, workflows — and for the merchant's own webhooks.
  *
- * Each payload carries `order` in the public API's shape (`GET
- * /v1/sites/{siteId}/orders/{orderId}`), as it stood once the fact was
- * written, so a subscriber reads one documented object rather than the
- * plugin's storage. A subscriber in another plugin restates the fields it
- * reads; these types are this plugin's own.
+ * Their names and payloads are commerce's contract with other plugins and
+ * live in `../contracts` (AGL-3980), which a subscriber imports as
+ * `@aglyn/plugins-commerce/contracts`; they are re-exported here for
+ * commerce's own code. What stays here is how commerce offers them to the
+ * merchant: the labels, the workflow triggers, the picker order.
  */
-/** An order as the public API returns it. Money is integer cents. */
-export interface OrderEventOrder {
-    id: string;
-    object: 'order';
-    number: number | null;
-    status: string | null;
-    channel: string;
-    currency: string;
-    customerEmail: string | null;
-    customerName: string | null;
-    lineItems: unknown;
-    totals: {
-        itemsCents: number;
-        shippingCents: number;
-        taxCents: number;
-        discountCents: number;
-        totalCents: number | null;
-        feeCents: number;
-    };
-    refundedCents: number;
-    /** The tax regime: `stripe-automatic`, `manual`, `none`, or `null` when not recorded. */
-    taxMode: string | null;
-    [key: string]: unknown;
-}
-/** A shipment as an event carries it. */
-export interface OrderEventFulfillment {
-    id: string;
-    lines: Array<{
-        lineItemId: number;
-        quantity: number;
-    }>;
-    carrier: string | null;
-    trackingNumber: string | null;
-    trackingUrl: string | null;
-    labelUrl: string | null;
-    /** What the shipment cost to send — its label's cost, or the merchant's hand-entered one (AGL-3705) — in integer cents of the order's currency; `null` when unknown (AGL-3693). */
-    labelCostCents: number | null;
-    at: string;
-}
-/** A refund as an event carries it: what THIS refund moved. */
-export interface OrderEventRefund {
-    /** Stripe's refund id, when there is one. */
-    id: string | null;
-    amountCents: number;
-    /** The line indexes refunded by name; empty for an amount-only refund. */
-    lineItemIds: number[];
-    /** Whether this refund left nothing more to refund. */
-    full: boolean;
-}
-/** A return as an event carries it. */
-export interface OrderEventReturn {
-    id: string;
-    status: string;
-    lines: Array<{
-        lineItemId: number;
-        quantity: number;
-        reason: string;
-    }>;
-    refundCents: number | null;
-    /** What went back in stock when the parcel arrived; `null` before then. */
-    restock?: Array<{
-        lineItemId: number;
-        quantity: number;
-    }> | null;
-}
-export interface OrderEventPayload {
-    order: OrderEventOrder;
-}
-export interface OrderFulfilledEventPayload extends OrderEventPayload {
-    fulfillment: OrderEventFulfillment;
-}
-export interface OrderRefundedEventPayload extends OrderEventPayload {
-    refund: OrderEventRefund;
-}
-export interface ReturnEventPayload extends OrderEventPayload {
-    return: OrderEventReturn;
-}
-export declare const ORDER_PAID_EVENT: PluginDomainEvent<OrderEventPayload>;
-export declare const ORDER_FULFILLED_EVENT: PluginDomainEvent<OrderFulfilledEventPayload>;
-export declare const ORDER_DELIVERED_EVENT: PluginDomainEvent<OrderEventPayload>;
-export declare const ORDER_REFUNDED_EVENT: PluginDomainEvent<OrderRefundedEventPayload>;
-export declare const ORDER_CANCELLED_EVENT: PluginDomainEvent<OrderEventPayload>;
-export declare const RETURN_REQUESTED_EVENT: PluginDomainEvent<ReturnEventPayload>;
-export declare const RETURN_APPROVED_EVENT: PluginDomainEvent<ReturnEventPayload>;
-export declare const RETURN_DECLINED_EVENT: PluginDomainEvent<ReturnEventPayload>;
-export declare const RETURN_RECEIVED_EVENT: PluginDomainEvent<ReturnEventPayload>;
-export declare const RETURN_REFUNDED_EVENT: PluginDomainEvent<ReturnEventPayload>;
-/**
- * A checkout a shopper reached with an address (AGL-3639): the fact an
- * abandoned-cart flow in a merchant's own email platform starts from. Not an
- * order event — nothing was bought — so it is raised beside them rather than
- * among them: it is not a workflow trigger and not offered to the merchant's
- * outbound webhooks, whose events are about orders.
- */
-export interface CheckoutStartedEventPayload {
-    checkout: {
-        /** The checkout session's id: one event per checkout. */
-        id: string;
-        email: string;
-        /** Whether the shopper ticked the store's marketing box at checkout. */
-        marketingOptIn: boolean;
-        currency: string;
-        /** The basket's list value, integer cents, before discounts and shipping. */
-        itemsCents: number;
-        /** Where the shopper can pick the checkout up again. */
-        resumeUrl: string | null;
-        items: Array<{
-            productId: string;
-            variantId: string | null;
-            name: string;
-            sku: string | null;
-            quantity: number;
-            unitCents: number;
-        }>;
-    };
-}
-export declare const CHECKOUT_STARTED_EVENT: PluginDomainEvent<CheckoutStartedEventPayload>;
+export { CHECKOUT_STARTED_EVENT, COMMERCE_EVENT_NAMES, ORDER_CANCELLED_EVENT, ORDER_DELIVERED_EVENT, ORDER_FULFILLED_EVENT, ORDER_PAID_EVENT, ORDER_REFUNDED_EVENT, RETURN_APPROVED_EVENT, RETURN_DECLINED_EVENT, RETURN_RECEIVED_EVENT, RETURN_REFUNDED_EVENT, RETURN_REQUESTED_EVENT, } from '../contracts';
+export type { CheckoutStartedEventPayload, CommerceEventName, OrderEventFulfillment, OrderEventOrder, OrderEventPayload, OrderEventRefund, OrderEventReturn, OrderFulfilledEventPayload, OrderRefundedEventPayload, OrderViewFulfillment, ReturnEventPayload, } from '../contracts';
 export declare const CHECKOUT_STARTED_EVENT_DECLARATION: PluginDomainEventDeclaration;
-/** Every event commerce raises, by name. */
-export type CommerceEventName = 'order.paid' | 'order.fulfilled' | 'order.delivered' | 'order.refunded' | 'order.cancelled' | 'return.requested' | 'return.approved' | 'return.declined' | 'return.received' | 'return.refunded';
 /** The events, in the order pickers list them, with their words. */
 export declare const COMMERCE_EVENT_DECLARATIONS: ReadonlyArray<PluginDomainEventDeclaration & {
     event: PluginDomainEvent<unknown>;
@@ -152,5 +35,3 @@ export declare const COMMERCE_EVENT_DECLARATIONS: ReadonlyArray<PluginDomainEven
 }>;
 /** The workflow trigger an event is offered as. */
 export declare function commerceHostEventFor(event: string): string | null;
-/** The event names, for a webhook's event picker. */
-export declare const COMMERCE_EVENT_NAMES: readonly CommerceEventName[];

package/src/lib/model/order-events.js

@@ -13,18 +13,17 @@
  * 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 { definePluginDomainEvent } from "@aglyn/aglyn/plugin-manager/plugin-domain-events";
-export const ORDER_PAID_EVENT = definePluginDomainEvent('order.paid');
-export const ORDER_FULFILLED_EVENT = definePluginDomainEvent('order.fulfilled');
-export const ORDER_DELIVERED_EVENT = definePluginDomainEvent('order.delivered');
-export const ORDER_REFUNDED_EVENT = definePluginDomainEvent('order.refunded');
-export const ORDER_CANCELLED_EVENT = definePluginDomainEvent('order.cancelled');
-export const RETURN_REQUESTED_EVENT = definePluginDomainEvent('return.requested');
-export const RETURN_APPROVED_EVENT = definePluginDomainEvent('return.approved');
-export const RETURN_DECLINED_EVENT = definePluginDomainEvent('return.declined');
-export const RETURN_RECEIVED_EVENT = definePluginDomainEvent('return.received');
-export const RETURN_REFUNDED_EVENT = definePluginDomainEvent('return.refunded');
-export const CHECKOUT_STARTED_EVENT = definePluginDomainEvent('checkout.started');
+ */ import { CHECKOUT_STARTED_EVENT, ORDER_CANCELLED_EVENT, ORDER_DELIVERED_EVENT, ORDER_FULFILLED_EVENT, ORDER_PAID_EVENT, ORDER_REFUNDED_EVENT, RETURN_APPROVED_EVENT, RETURN_DECLINED_EVENT, RETURN_RECEIVED_EVENT, RETURN_REFUNDED_EVENT, RETURN_REQUESTED_EVENT } from "../contracts.js";
+/**
+ * The order and return events commerce raises (AGL-3611), for other plugins
+ * — accounting, shipping, workflows — and for the merchant's own webhooks.
+ *
+ * Their names and payloads are commerce's contract with other plugins and
+ * live in `../contracts` (AGL-3980), which a subscriber imports as
+ * `@aglyn/plugins-commerce/contracts`; they are re-exported here for
+ * commerce's own code. What stays here is how commerce offers them to the
+ * merchant: the labels, the workflow triggers, the picker order.
+ */ export { CHECKOUT_STARTED_EVENT, COMMERCE_EVENT_NAMES, ORDER_CANCELLED_EVENT, ORDER_DELIVERED_EVENT, ORDER_FULFILLED_EVENT, ORDER_PAID_EVENT, ORDER_REFUNDED_EVENT, RETURN_APPROVED_EVENT, RETURN_DECLINED_EVENT, RETURN_RECEIVED_EVENT, RETURN_REFUNDED_EVENT, RETURN_REQUESTED_EVENT } from "../contracts.js";
 export const CHECKOUT_STARTED_EVENT_DECLARATION = {
     event: CHECKOUT_STARTED_EVENT,
     label: 'Checkout started',
@@ -137,17 +136,5 @@ export const CHECKOUT_STARTED_EVENT_DECLARATION = {
     var _COMMERCE_EVENT_DECLARATIONS_find;
     return (_ref = (_COMMERCE_EVENT_DECLARATIONS_find = COMMERCE_EVENT_DECLARATIONS.find((entry)=>entry.event.id === event)) == null ? void 0 : _COMMERCE_EVENT_DECLARATIONS_find.hostEvent) != null ? _ref : null;
 }
-/** The event names, for a webhook's event picker. */ export const COMMERCE_EVENT_NAMES = [
-    'order.paid',
-    'order.fulfilled',
-    'order.delivered',
-    'order.refunded',
-    'order.cancelled',
-    'return.requested',
-    'return.approved',
-    'return.declined',
-    'return.received',
-    'return.refunded'
-];
 
 //# sourceMappingURL=order-events.js.map

package/src/lib/model/order-events.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/order-events.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  definePluginDomainEvent,\n  type PluginDomainEvent,\n  type PluginDomainEventDeclaration,\n} from '@aglyn/aglyn/plugin-manager/plugin-domain-events'\n\n/**\n * The order and return events commerce raises (AGL-3611), for other plugins\n * — accounting, shipping, workflows — and for the merchant's own webhooks.\n *\n * Each payload carries `order` in the public API's shape (`GET\n * /v1/sites/{siteId}/orders/{orderId}`), as it stood once the fact was\n * written, so a subscriber reads one documented object rather than the\n * plugin's storage. A subscriber in another plugin restates the fields it\n * reads; these types are this plugin's own.\n */\n\n/** An order as the public API returns it. Money is integer cents. */\nexport interface OrderEventOrder {\n  id: string\n  object: 'order'\n  number: number | null\n  status: string | null\n  channel: string\n  currency: string\n  customerEmail: string | null\n  customerName: string | null\n  lineItems: unknown\n  totals: {\n    itemsCents: number\n    shippingCents: number\n    taxCents: number\n    discountCents: number\n    totalCents: number | null\n    feeCents: number\n  }\n  refundedCents: number\n  /** The tax regime: `stripe-automatic`, `manual`, `none`, or `null` when not recorded. */\n  taxMode: string | null\n  [key: string]: unknown\n}\n\n/** A shipment as an event carries it. */\nexport interface OrderEventFulfillment {\n  id: string\n  lines: Array<{ lineItemId: number; quantity: number }>\n  carrier: string | null\n  trackingNumber: string | null\n  trackingUrl: string | null\n  labelUrl: string | null\n  /** What the shipment cost to send — its label's cost, or the merchant's hand-entered one (AGL-3705) — in integer cents of the order's currency; `null` when unknown (AGL-3693). */\n  labelCostCents: number | null\n  at: string\n}\n\n/** A refund as an event carries it: what THIS refund moved. */\nexport interface OrderEventRefund {\n  /** Stripe's refund id, when there is one. */\n  id: string | null\n  amountCents: number\n  /** The line indexes refunded by name; empty for an amount-only refund. */\n  lineItemIds: number[]\n  /** Whether this refund left nothing more to refund. */\n  full: boolean\n}\n\n/** A return as an event carries it. */\nexport interface OrderEventReturn {\n  id: string\n  status: string\n  lines: Array<{ lineItemId: number; quantity: number; reason: string }>\n  refundCents: number | null\n  /** What went back in stock when the parcel arrived; `null` before then. */\n  restock?: Array<{ lineItemId: number; quantity: number }> | null\n}\n\nexport interface OrderEventPayload {\n  order: OrderEventOrder\n}\nexport interface OrderFulfilledEventPayload extends OrderEventPayload {\n  fulfillment: OrderEventFulfillment\n}\nexport interface OrderRefundedEventPayload extends OrderEventPayload {\n  refund: OrderEventRefund\n}\nexport interface ReturnEventPayload extends OrderEventPayload {\n  return: OrderEventReturn\n}\n\nexport const ORDER_PAID_EVENT = definePluginDomainEvent<OrderEventPayload>('order.paid')\nexport const ORDER_FULFILLED_EVENT = definePluginDomainEvent<OrderFulfilledEventPayload>('order.fulfilled')\nexport const ORDER_DELIVERED_EVENT = definePluginDomainEvent<OrderEventPayload>('order.delivered')\nexport const ORDER_REFUNDED_EVENT = definePluginDomainEvent<OrderRefundedEventPayload>('order.refunded')\nexport const ORDER_CANCELLED_EVENT = definePluginDomainEvent<OrderEventPayload>('order.cancelled')\nexport const RETURN_REQUESTED_EVENT = definePluginDomainEvent<ReturnEventPayload>('return.requested')\nexport const RETURN_APPROVED_EVENT = definePluginDomainEvent<ReturnEventPayload>('return.approved')\nexport const RETURN_DECLINED_EVENT = definePluginDomainEvent<ReturnEventPayload>('return.declined')\nexport const RETURN_RECEIVED_EVENT = definePluginDomainEvent<ReturnEventPayload>('return.received')\nexport const RETURN_REFUNDED_EVENT = definePluginDomainEvent<ReturnEventPayload>('return.refunded')\n\n/**\n * A checkout a shopper reached with an address (AGL-3639): the fact an\n * abandoned-cart flow in a merchant's own email platform starts from. Not an\n * order event — nothing was bought — so it is raised beside them rather than\n * among them: it is not a workflow trigger and not offered to the merchant's\n * outbound webhooks, whose events are about orders.\n */\nexport interface CheckoutStartedEventPayload {\n  checkout: {\n    /** The checkout session's id: one event per checkout. */\n    id: string\n    email: string\n    /** Whether the shopper ticked the store's marketing box at checkout. */\n    marketingOptIn: boolean\n    currency: string\n    /** The basket's list value, integer cents, before discounts and shipping. */\n    itemsCents: number\n    /** Where the shopper can pick the checkout up again. */\n    resumeUrl: string | null\n    items: Array<{\n      productId: string\n      variantId: string | null\n      name: string\n      sku: string | null\n      quantity: number\n      unitCents: number\n    }>\n  }\n}\n\nexport const CHECKOUT_STARTED_EVENT = definePluginDomainEvent<CheckoutStartedEventPayload>('checkout.started')\n\nexport const CHECKOUT_STARTED_EVENT_DECLARATION: PluginDomainEventDeclaration = {\n  event: CHECKOUT_STARTED_EVENT as PluginDomainEvent<unknown>,\n  label: 'Checkout started',\n  description:\n    'A shopper reached checkout with an email address: the basket, its value and the link back to it. Raised once per checkout, whether or not it is paid.',\n  payloadKeys: ['checkout'],\n}\n\n/** Every event commerce raises, by name. */\nexport type CommerceEventName =\n  | 'order.paid'\n  | 'order.fulfilled'\n  | 'order.delivered'\n  | 'order.refunded'\n  | 'order.cancelled'\n  | 'return.requested'\n  | 'return.approved'\n  | 'return.declined'\n  | 'return.received'\n  | 'return.refunded'\n\n/** The events, in the order pickers list them, with their words. */\nexport const COMMERCE_EVENT_DECLARATIONS: ReadonlyArray<\n  PluginDomainEventDeclaration & { event: PluginDomainEvent<unknown>; hostEvent: string }\n> = [\n  {\n    event: ORDER_PAID_EVENT,\n    hostEvent: 'orderPaid',\n    label: 'Order paid',\n    description:\n      'An order was paid: a storefront checkout, a buy-now, a paid payment link, a POS sale or a subscription renewal.',\n    payloadKeys: ['order'],\n  },\n  {\n    event: ORDER_FULFILLED_EVENT,\n    hostEvent: 'orderFulfilled',\n    label: 'Order fulfilled',\n    description: 'A shipment was recorded on an order, once per shipment, with the units it carried.',\n    payloadKeys: ['order', 'fulfillment'],\n  },\n  {\n    event: ORDER_DELIVERED_EVENT,\n    hostEvent: 'orderDelivered',\n    label: 'Order delivered',\n    description: 'An order was marked delivered.',\n    payloadKeys: ['order'],\n  },\n  {\n    event: ORDER_REFUNDED_EVENT,\n    hostEvent: 'orderRefunded',\n    label: 'Order refunded',\n    description: 'Money went back to the buyer, in part or in full, once per refund.',\n    payloadKeys: ['order', 'refund'],\n  },\n  {\n    event: ORDER_CANCELLED_EVENT,\n    hostEvent: 'orderCancelled',\n    label: 'Order canceled',\n    description: 'An order was canceled and its stock returned.',\n    payloadKeys: ['order'],\n  },\n  {\n    event: RETURN_REQUESTED_EVENT,\n    hostEvent: 'returnRequested',\n    label: 'Return requested',\n    description: 'A buyer asked to return items, or the merchant opened a return for them.',\n    payloadKeys: ['order', 'return'],\n  },\n  {\n    event: RETURN_APPROVED_EVENT,\n    hostEvent: 'returnApproved',\n    label: 'Return approved',\n    description: 'The store approved a return, or opened one itself.',\n    payloadKeys: ['order', 'return'],\n  },\n  {\n    event: RETURN_DECLINED_EVENT,\n    hostEvent: 'returnDeclined',\n    label: 'Return declined',\n    description: 'The store declined a return request.',\n    payloadKeys: ['order', 'return'],\n  },\n  {\n    event: RETURN_RECEIVED_EVENT,\n    hostEvent: 'returnReceived',\n    label: 'Return received',\n    description: 'The returned items arrived, with what went back in stock.',\n    payloadKeys: ['order', 'return'],\n  },\n  {\n    event: RETURN_REFUNDED_EVENT,\n    hostEvent: 'returnRefunded',\n    label: 'Return refunded',\n    description: 'A return was refunded.',\n    payloadKeys: ['order', 'return'],\n  },\n]\n\n/** The workflow trigger an event is offered as. */\nexport function commerceHostEventFor(event: string): string | null {\n  return COMMERCE_EVENT_DECLARATIONS.find((entry) => entry.event.id === event)?.hostEvent ?? null\n}\n\n/** The event names, for a webhook's event picker. */\nexport const COMMERCE_EVENT_NAMES: readonly CommerceEventName[] = [\n  'order.paid',\n  'order.fulfilled',\n  'order.delivered',\n  'order.refunded',\n  'order.cancelled',\n  'return.requested',\n  'return.approved',\n  'return.declined',\n  'return.received',\n  'return.refunded',\n]\n"],"names":["definePluginDomainEvent","ORDER_PAID_EVENT","ORDER_FULFILLED_EVENT","ORDER_DELIVERED_EVENT","ORDER_REFUNDED_EVENT","ORDER_CANCELLED_EVENT","RETURN_REQUESTED_EVENT","RETURN_APPROVED_EVENT","RETURN_DECLINED_EVENT","RETURN_RECEIVED_EVENT","RETURN_REFUNDED_EVENT","CHECKOUT_STARTED_EVENT","CHECKOUT_STARTED_EVENT_DECLARATION","event","label","description","payloadKeys","COMMERCE_EVENT_DECLARATIONS","hostEvent","commerceHostEventFor","find","entry","id","COMMERCE_EVENT_NAMES"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,uBAAuB,QAGlB,mDAAkD;AAqFzD,OAAO,MAAMC,mBAAmBD,wBAA2C,cAAa;AACxF,OAAO,MAAME,wBAAwBF,wBAAoD,mBAAkB;AAC3G,OAAO,MAAMG,wBAAwBH,wBAA2C,mBAAkB;AAClG,OAAO,MAAMI,uBAAuBJ,wBAAmD,kBAAiB;AACxG,OAAO,MAAMK,wBAAwBL,wBAA2C,mBAAkB;AAClG,OAAO,MAAMM,yBAAyBN,wBAA4C,oBAAmB;AACrG,OAAO,MAAMO,wBAAwBP,wBAA4C,mBAAkB;AACnG,OAAO,MAAMQ,wBAAwBR,wBAA4C,mBAAkB;AACnG,OAAO,MAAMS,wBAAwBT,wBAA4C,mBAAkB;AACnG,OAAO,MAAMU,wBAAwBV,wBAA4C,mBAAkB;AAgCnG,OAAO,MAAMW,yBAAyBX,wBAAqD,oBAAmB;AAE9G,OAAO,MAAMY,qCAAmE;IAC9EC,OAAOF;IACPG,OAAO;IACPC,aACE;IACFC,aAAa;QAAC;KAAW;AAC3B,EAAC;AAeD,kEAAkE,GAClE,OAAO,MAAMC,8BAET;IACF;QACEJ,OAAOZ;QACPiB,WAAW;QACXJ,OAAO;QACPC,aACE;QACFC,aAAa;YAAC;SAAQ;IACxB;IACA;QACEH,OAAOX;QACPgB,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAc;IACvC;IACA;QACEH,OAAOV;QACPe,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;SAAQ;IACxB;IACA;QACEH,OAAOT;QACPc,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAS;IAClC;IACA;QACEH,OAAOR;QACPa,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;SAAQ;IACxB;IACA;QACEH,OAAOP;QACPY,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAS;IAClC;IACA;QACEH,OAAON;QACPW,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAS;IAClC;IACA;QACEH,OAAOL;QACPU,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAS;IAClC;IACA;QACEH,OAAOJ;QACPS,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAS;IAClC;IACA;QACEH,OAAOH;QACPQ,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAS;IAClC;CACD,CAAA;AAED,iDAAiD,GACjD,OAAO,SAASG,qBAAqBN,KAAa;;QACzCI;IAAP,gBAAOA,oCAAAA,4BAA4BG,IAAI,CAAC,CAACC,QAAUA,MAAMR,KAAK,CAACS,EAAE,KAAKT,2BAA/DI,kCAAuEC,SAAS,mBAAI;AAC7F;AAEA,mDAAmD,GACnD,OAAO,MAAMK,uBAAqD;IAChE;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/order-events.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 {\n  PluginDomainEvent,\n  PluginDomainEventDeclaration,\n} from '@aglyn/aglyn/plugin-manager/plugin-domain-events'\nimport {\n  CHECKOUT_STARTED_EVENT,\n  ORDER_CANCELLED_EVENT,\n  ORDER_DELIVERED_EVENT,\n  ORDER_FULFILLED_EVENT,\n  ORDER_PAID_EVENT,\n  ORDER_REFUNDED_EVENT,\n  RETURN_APPROVED_EVENT,\n  RETURN_DECLINED_EVENT,\n  RETURN_RECEIVED_EVENT,\n  RETURN_REFUNDED_EVENT,\n  RETURN_REQUESTED_EVENT,\n} from '../contracts'\n\n/**\n * The order and return events commerce raises (AGL-3611), for other plugins\n * — accounting, shipping, workflows — and for the merchant's own webhooks.\n *\n * Their names and payloads are commerce's contract with other plugins and\n * live in `../contracts` (AGL-3980), which a subscriber imports as\n * `@aglyn/plugins-commerce/contracts`; they are re-exported here for\n * commerce's own code. What stays here is how commerce offers them to the\n * merchant: the labels, the workflow triggers, the picker order.\n */\n\nexport {\n  CHECKOUT_STARTED_EVENT,\n  COMMERCE_EVENT_NAMES,\n  ORDER_CANCELLED_EVENT,\n  ORDER_DELIVERED_EVENT,\n  ORDER_FULFILLED_EVENT,\n  ORDER_PAID_EVENT,\n  ORDER_REFUNDED_EVENT,\n  RETURN_APPROVED_EVENT,\n  RETURN_DECLINED_EVENT,\n  RETURN_RECEIVED_EVENT,\n  RETURN_REFUNDED_EVENT,\n  RETURN_REQUESTED_EVENT,\n} from '../contracts'\nexport type {\n  CheckoutStartedEventPayload,\n  CommerceEventName,\n  OrderEventFulfillment,\n  OrderEventOrder,\n  OrderEventPayload,\n  OrderEventRefund,\n  OrderEventReturn,\n  OrderFulfilledEventPayload,\n  OrderRefundedEventPayload,\n  OrderViewFulfillment,\n  ReturnEventPayload,\n} from '../contracts'\n\nexport const CHECKOUT_STARTED_EVENT_DECLARATION: PluginDomainEventDeclaration = {\n  event: CHECKOUT_STARTED_EVENT as PluginDomainEvent<unknown>,\n  label: 'Checkout started',\n  description:\n    'A shopper reached checkout with an email address: the basket, its value and the link back to it. Raised once per checkout, whether or not it is paid.',\n  payloadKeys: ['checkout'],\n}\n\n/** The events, in the order pickers list them, with their words. */\nexport const COMMERCE_EVENT_DECLARATIONS: ReadonlyArray<\n  PluginDomainEventDeclaration & { event: PluginDomainEvent<unknown>; hostEvent: string }\n> = [\n  {\n    event: ORDER_PAID_EVENT,\n    hostEvent: 'orderPaid',\n    label: 'Order paid',\n    description:\n      'An order was paid: a storefront checkout, a buy-now, a paid payment link, a POS sale or a subscription renewal.',\n    payloadKeys: ['order'],\n  },\n  {\n    event: ORDER_FULFILLED_EVENT,\n    hostEvent: 'orderFulfilled',\n    label: 'Order fulfilled',\n    description: 'A shipment was recorded on an order, once per shipment, with the units it carried.',\n    payloadKeys: ['order', 'fulfillment'],\n  },\n  {\n    event: ORDER_DELIVERED_EVENT,\n    hostEvent: 'orderDelivered',\n    label: 'Order delivered',\n    description: 'An order was marked delivered.',\n    payloadKeys: ['order'],\n  },\n  {\n    event: ORDER_REFUNDED_EVENT,\n    hostEvent: 'orderRefunded',\n    label: 'Order refunded',\n    description: 'Money went back to the buyer, in part or in full, once per refund.',\n    payloadKeys: ['order', 'refund'],\n  },\n  {\n    event: ORDER_CANCELLED_EVENT,\n    hostEvent: 'orderCancelled',\n    label: 'Order canceled',\n    description: 'An order was canceled and its stock returned.',\n    payloadKeys: ['order'],\n  },\n  {\n    event: RETURN_REQUESTED_EVENT,\n    hostEvent: 'returnRequested',\n    label: 'Return requested',\n    description: 'A buyer asked to return items, or the merchant opened a return for them.',\n    payloadKeys: ['order', 'return'],\n  },\n  {\n    event: RETURN_APPROVED_EVENT,\n    hostEvent: 'returnApproved',\n    label: 'Return approved',\n    description: 'The store approved a return, or opened one itself.',\n    payloadKeys: ['order', 'return'],\n  },\n  {\n    event: RETURN_DECLINED_EVENT,\n    hostEvent: 'returnDeclined',\n    label: 'Return declined',\n    description: 'The store declined a return request.',\n    payloadKeys: ['order', 'return'],\n  },\n  {\n    event: RETURN_RECEIVED_EVENT,\n    hostEvent: 'returnReceived',\n    label: 'Return received',\n    description: 'The returned items arrived, with what went back in stock.',\n    payloadKeys: ['order', 'return'],\n  },\n  {\n    event: RETURN_REFUNDED_EVENT,\n    hostEvent: 'returnRefunded',\n    label: 'Return refunded',\n    description: 'A return was refunded.',\n    payloadKeys: ['order', 'return'],\n  },\n]\n\n/** The workflow trigger an event is offered as. */\nexport function commerceHostEventFor(event: string): string | null {\n  return COMMERCE_EVENT_DECLARATIONS.find((entry) => entry.event.id === event)?.hostEvent ?? null\n}\n"],"names":["CHECKOUT_STARTED_EVENT","ORDER_CANCELLED_EVENT","ORDER_DELIVERED_EVENT","ORDER_FULFILLED_EVENT","ORDER_PAID_EVENT","ORDER_REFUNDED_EVENT","RETURN_APPROVED_EVENT","RETURN_DECLINED_EVENT","RETURN_RECEIVED_EVENT","RETURN_REFUNDED_EVENT","RETURN_REQUESTED_EVENT","COMMERCE_EVENT_NAMES","CHECKOUT_STARTED_EVENT_DECLARATION","event","label","description","payloadKeys","COMMERCE_EVENT_DECLARATIONS","hostEvent","commerceHostEventFor","find","entry","id"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAMD,SACEA,sBAAsB,EACtBC,qBAAqB,EACrBC,qBAAqB,EACrBC,qBAAqB,EACrBC,gBAAgB,EAChBC,oBAAoB,EACpBC,qBAAqB,EACrBC,qBAAqB,EACrBC,qBAAqB,EACrBC,qBAAqB,EACrBC,sBAAsB,QACjB,kBAAc;AAErB;;;;;;;;;CASC,GAED,SACEV,sBAAsB,EACtBW,oBAAoB,EACpBV,qBAAqB,EACrBC,qBAAqB,EACrBC,qBAAqB,EACrBC,gBAAgB,EAChBC,oBAAoB,EACpBC,qBAAqB,EACrBC,qBAAqB,EACrBC,qBAAqB,EACrBC,qBAAqB,EACrBC,sBAAsB,QACjB,kBAAc;AAerB,OAAO,MAAME,qCAAmE;IAC9EC,OAAOb;IACPc,OAAO;IACPC,aACE;IACFC,aAAa;QAAC;KAAW;AAC3B,EAAC;AAED,kEAAkE,GAClE,OAAO,MAAMC,8BAET;IACF;QACEJ,OAAOT;QACPc,WAAW;QACXJ,OAAO;QACPC,aACE;QACFC,aAAa;YAAC;SAAQ;IACxB;IACA;QACEH,OAAOV;QACPe,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAc;IACvC;IACA;QACEH,OAAOX;QACPgB,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;SAAQ;IACxB;IACA;QACEH,OAAOR;QACPa,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAS;IAClC;IACA;QACEH,OAAOZ;QACPiB,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;SAAQ;IACxB;IACA;QACEH,OAAOH;QACPQ,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAS;IAClC;IACA;QACEH,OAAOP;QACPY,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAS;IAClC;IACA;QACEH,OAAON;QACPW,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAS;IAClC;IACA;QACEH,OAAOL;QACPU,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAS;IAClC;IACA;QACEH,OAAOJ;QACPS,WAAW;QACXJ,OAAO;QACPC,aAAa;QACbC,aAAa;YAAC;YAAS;SAAS;IAClC;CACD,CAAA;AAED,iDAAiD,GACjD,OAAO,SAASG,qBAAqBN,KAAa;;QACzCI;IAAP,gBAAOA,oCAAAA,4BAA4BG,IAAI,CAAC,CAACC,QAAUA,MAAMR,KAAK,CAACS,EAAE,KAAKT,2BAA/DI,kCAAuEC,SAAS,mBAAI;AAC7F"}

package/src/lib/model/order-history.d.ts

@@ -14,45 +14,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { OrderEventOrder } from './order-events';
 /**
- * A site's order HISTORY, for another plugin (AGL-3614).
- *
- * The order events (`order-events.ts`) bring every order from the moment a
- * subscriber listens. A plugin that must also read the orders BEFORE that —
- * accounting, posting a merchant's earlier sales from a start date — reads
- * them through this service, in the same public shape the events carry, and
- * never through commerce's storage. Commerce registers the one
- * implementation from its console server declarations; a reader in another
- * plugin restates this contract under the same id, as an event subscriber
- * restates an event.
+ * A site's order HISTORY, for another plugin (AGL-3614). The service is
+ * commerce's contract with other plugins and lives in `../contracts`
+ * (AGL-3980), which a reader imports as `@aglyn/plugins-commerce/contracts`;
+ * it is re-exported here for commerce's own code, which registers the one
+ * implementation from its console server declarations.
  */
-/** One stored order, as the history hands it out. */
-export interface OrderHistoryEntry {
-    id: string;
-    createdAtMs: number;
-    /** When it was paid; `null` for one never paid. */
-    paidAtMs: number | null;
-    /** The newest refund on its timeline, or `null`. */
-    lastRefundAtMs: number | null;
-    /** Whether its prices include the tax. */
-    taxInclusive: boolean;
-    /** The tax rate it was charged under, when one was named. */
-    taxRateId: string | null;
-    /** The order in the public API's shape. */
-    order: OrderEventOrder;
-}
-export interface OrderHistoryPageRequest {
-    hostId: string;
-    /** Orders created at or after this… */
-    fromMs: number;
-    /** …and before this. */
-    untilMs: number;
-    /** At most this many, oldest first; capped at 200. */
-    limit: number;
-}
-export interface OrderHistoryReader {
-    listOrders(request: OrderHistoryPageRequest): Promise<OrderHistoryEntry[]>;
-}
-export declare const ORDER_HISTORY_CONTRACT_ID = "commerce.orderHistory";
-export declare const ORDER_HISTORY_CONTRACT: import("@aglyn/aglyn/src").PluginServiceContract<OrderHistoryReader>;
+export { ORDER_HISTORY_CONTRACT, ORDER_HISTORY_CONTRACT_ID } from '../contracts';
+export type { OrderHistoryEntry, OrderHistoryPageRequest, OrderHistoryReader } from '../contracts';

package/src/lib/model/order-history.js

@@ -13,10 +13,12 @@
  * 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 { definePluginServiceContract } from "@aglyn/aglyn/plugin-manager/plugin-services";
-export const ORDER_HISTORY_CONTRACT_ID = 'commerce.orderHistory';
-export const ORDER_HISTORY_CONTRACT = definePluginServiceContract(ORDER_HISTORY_CONTRACT_ID, {
-    multiple: false
-});
+ */ /**
+ * A site's order HISTORY, for another plugin (AGL-3614). The service is
+ * commerce's contract with other plugins and lives in `../contracts`
+ * (AGL-3980), which a reader imports as `@aglyn/plugins-commerce/contracts`;
+ * it is re-exported here for commerce's own code, which registers the one
+ * implementation from its console server declarations.
+ */ export { ORDER_HISTORY_CONTRACT, ORDER_HISTORY_CONTRACT_ID } from "../contracts.js";
 
 //# sourceMappingURL=order-history.js.map

package/src/lib/model/order-history.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/order-history.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 { definePluginServiceContract } from '@aglyn/aglyn/plugin-manager/plugin-services'\nimport type { OrderEventOrder } from './order-events'\n\n/**\n * A site's order HISTORY, for another plugin (AGL-3614).\n *\n * The order events (`order-events.ts`) bring every order from the moment a\n * subscriber listens. A plugin that must also read the orders BEFORE that —\n * accounting, posting a merchant's earlier sales from a start date — reads\n * them through this service, in the same public shape the events carry, and\n * never through commerce's storage. Commerce registers the one\n * implementation from its console server declarations; a reader in another\n * plugin restates this contract under the same id, as an event subscriber\n * restates an event.\n */\n\n/** One stored order, as the history hands it out. */\nexport interface OrderHistoryEntry {\n  id: string\n  createdAtMs: number\n  /** When it was paid; `null` for one never paid. */\n  paidAtMs: number | null\n  /** The newest refund on its timeline, or `null`. */\n  lastRefundAtMs: number | null\n  /** Whether its prices include the tax. */\n  taxInclusive: boolean\n  /** The tax rate it was charged under, when one was named. */\n  taxRateId: string | null\n  /** The order in the public API's shape. */\n  order: OrderEventOrder\n}\n\nexport interface OrderHistoryPageRequest {\n  hostId: string\n  /** Orders created at or after this… */\n  fromMs: number\n  /** …and before this. */\n  untilMs: number\n  /** At most this many, oldest first; capped at 200. */\n  limit: number\n}\n\nexport interface OrderHistoryReader {\n  listOrders(request: OrderHistoryPageRequest): Promise<OrderHistoryEntry[]>\n}\n\nexport const ORDER_HISTORY_CONTRACT_ID = 'commerce.orderHistory'\n\nexport const ORDER_HISTORY_CONTRACT = definePluginServiceContract<OrderHistoryReader>(ORDER_HISTORY_CONTRACT_ID, {\n  multiple: false,\n})\n"],"names":["definePluginServiceContract","ORDER_HISTORY_CONTRACT_ID","ORDER_HISTORY_CONTRACT","multiple"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,2BAA2B,QAAQ,8CAA6C;AA8CzF,OAAO,MAAMC,4BAA4B,wBAAuB;AAEhE,OAAO,MAAMC,yBAAyBF,4BAAgDC,2BAA2B;IAC/GE,UAAU;AACZ,GAAE"}
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/order-history.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 * A site's order HISTORY, for another plugin (AGL-3614). The service is\n * commerce's contract with other plugins and lives in `../contracts`\n * (AGL-3980), which a reader imports as `@aglyn/plugins-commerce/contracts`;\n * it is re-exported here for commerce's own code, which registers the one\n * implementation from its console server declarations.\n */\n\nexport { ORDER_HISTORY_CONTRACT, ORDER_HISTORY_CONTRACT_ID } from '../contracts'\nexport type { OrderHistoryEntry, OrderHistoryPageRequest, OrderHistoryReader } from '../contracts'\n"],"names":["ORDER_HISTORY_CONTRACT","ORDER_HISTORY_CONTRACT_ID"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;CAMC,GAED,SAASA,sBAAsB,EAAEC,yBAAyB,QAAQ,kBAAc"}

package/src/lib/native-nav.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type NativeNavContribution, type NativeNavCreateContribution, type NativeNavElsewhere } from '@aglyn/aglyn/app-utils/native-nav';
+/**
+ * Orders and Products in the native apps' navigation (AGL-3943): the rows this plugin
+ * adds to the manifest the shells draw, placed into the core's lists by
+ * `order` (`assembleNativeNav`, `generate:native-contracts`). Labels are the
+ * console's words, held by `apps/console/specs/native-nav-manifest.spec.ts`.
+ *
+ * Imports only the core's plain nav module, so the native contracts read it.
+ */
+export declare const NATIVE_NAV_ROWS: readonly NativeNavContribution[];
+/** The console's POS tab is the register app's, not a row of this one. */
+export declare const NATIVE_NAV_ELSEWHERE: readonly NativeNavElsewhere[];
+/** A product ("Add product" on Catalog) and a draft order ("Draft order" on Orders). */
+export declare const NATIVE_NAV_CREATE: readonly NativeNavCreateContribution[];

package/src/lib/native-nav.js

@@ -0,0 +1,127 @@
+/**
+ * @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 { nativeNavHubSection, nativeNavIcon, nativeNavRef } from "@aglyn/aglyn/app-utils/native-nav";
+/**
+ * Orders and Products in the native apps' navigation (AGL-3943): the rows this plugin
+ * adds to the manifest the shells draw, placed into the core's lists by
+ * `order` (`assembleNativeNav`, `generate:native-contracts`). Labels are the
+ * console's words, held by `apps/console/specs/native-nav-manifest.spec.ts`.
+ *
+ * Imports only the core's plain nav module, so the native contracts read it.
+ */ export const NATIVE_NAV_ROWS = [
+    {
+        list: 'site',
+        group: 'sell',
+        row: {
+            id: 'orders',
+            label: 'Orders',
+            icon: nativeNavIcon('bag', 'shopping_bag'),
+            screen: 'commerce.orders',
+            pluginId: 'commerce',
+            order: 10,
+            sections: [
+                nativeNavHubSection('host', '/products', 'orders', 'Orders', 'commerce.orders'),
+                nativeNavHubSection('host', '/products', 'returns', 'Returns', 'commerce.returns'),
+                nativeNavHubSection('host', '/products', 'reservations', 'Reservations', 'commerce.reservations')
+            ],
+            docs: '/commerce-and-bookings/commerce/overview',
+            console: nativeNavRef('hostPluginSection', '/products/orders')
+        }
+    },
+    {
+        list: 'site',
+        group: 'sell',
+        row: {
+            id: 'products',
+            label: 'Products',
+            icon: nativeNavIcon('tag', 'sell'),
+            screen: 'commerce.products',
+            pluginId: 'commerce',
+            order: 20,
+            keywords: [
+                'catalog',
+                'stock',
+                'inventory'
+            ],
+            sections: [
+                nativeNavHubSection('host', '/products', 'catalog', 'Catalog', 'commerce.products'),
+                nativeNavHubSection('host', '/products', 'promotions', 'Promotions', 'commerce.promotions'),
+                nativeNavHubSection('host', '/products', 'analytics', 'Analytics', 'commerce.sales')
+            ],
+            actions: [
+                {
+                    id: 'scan',
+                    label: 'Scan stock',
+                    icon: nativeNavIcon('barcode.viewfinder', 'qr_code_scanner'),
+                    screen: 'commerce.scan'
+                },
+                {
+                    id: 'newProduct',
+                    label: 'New product',
+                    icon: nativeNavIcon('plus', 'add'),
+                    screen: 'commerce.product',
+                    params: {
+                        new: '1'
+                    }
+                }
+            ],
+            docs: '/commerce-and-bookings/commerce/overview',
+            console: nativeNavRef('hostPluginTab', '/products')
+        }
+    }
+];
+/** The console's POS tab is the register app's, not a row of this one. */ export const NATIVE_NAV_ELSEWHERE = [
+    {
+        console: nativeNavRef('hostPluginTab', '/pos'),
+        where: 'The POS app'
+    }
+];
+/** A product ("Add product" on Catalog) and a draft order ("Draft order" on Orders). */ export const NATIVE_NAV_CREATE = [
+    {
+        scope: 'site',
+        item: {
+            id: 'product',
+            label: 'Product',
+            icon: nativeNavIcon('tag', 'sell'),
+            screen: 'commerce.product',
+            params: {
+                new: '1'
+            },
+            pluginId: 'commerce',
+            planFeature: 'commerce',
+            order: 20,
+            console: nativeNavRef('hostPluginSection', '/products/catalog')
+        }
+    },
+    {
+        scope: 'site',
+        item: {
+            id: 'draftOrder',
+            label: 'Draft order',
+            icon: nativeNavIcon('link.badge.plus', 'link'),
+            screen: 'commerce.orders',
+            params: {
+                new: '1'
+            },
+            pluginId: 'commerce',
+            planFeature: 'commerce',
+            order: 30,
+            console: nativeNavRef('hostPluginSection', '/products/orders')
+        }
+    }
+];
+
+//# sourceMappingURL=native-nav.js.map

package/src/lib/native-nav.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/plugins/commerce/src/lib/native-nav.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  type NativeNavContribution,\n  type NativeNavCreateContribution,\n  type NativeNavElsewhere,\n  nativeNavHubSection,\n  nativeNavIcon,\n  nativeNavRef,\n} from '@aglyn/aglyn/app-utils/native-nav'\n\n/**\n * Orders and Products in the native apps' navigation (AGL-3943): the rows this plugin\n * adds to the manifest the shells draw, placed into the core's lists by\n * `order` (`assembleNativeNav`, `generate:native-contracts`). Labels are the\n * console's words, held by `apps/console/specs/native-nav-manifest.spec.ts`.\n *\n * Imports only the core's plain nav module, so the native contracts read it.\n */\n\nexport const NATIVE_NAV_ROWS: readonly NativeNavContribution[] = [\n  {\n    list: 'site',\n    group: 'sell',\n    row: {\n      id: 'orders',\n      label: 'Orders',\n      icon: nativeNavIcon('bag', 'shopping_bag'),\n      screen: 'commerce.orders',\n      pluginId: 'commerce',\n      order: 10,\n      sections: [\n        nativeNavHubSection('host', '/products', 'orders', 'Orders', 'commerce.orders'),\n        nativeNavHubSection('host', '/products', 'returns', 'Returns', 'commerce.returns'),\n        nativeNavHubSection('host', '/products', 'reservations', 'Reservations', 'commerce.reservations'),\n      ],\n      docs: '/commerce-and-bookings/commerce/overview',\n      console: nativeNavRef('hostPluginSection', '/products/orders'),\n    },\n  },\n  {\n    list: 'site',\n    group: 'sell',\n    row: {\n      id: 'products',\n      label: 'Products',\n      icon: nativeNavIcon('tag', 'sell'),\n      screen: 'commerce.products',\n      pluginId: 'commerce',\n      order: 20,\n      keywords: ['catalog', 'stock', 'inventory'],\n      sections: [\n        nativeNavHubSection('host', '/products', 'catalog', 'Catalog', 'commerce.products'),\n        nativeNavHubSection('host', '/products', 'promotions', 'Promotions', 'commerce.promotions'),\n        nativeNavHubSection('host', '/products', 'analytics', 'Analytics', 'commerce.sales'),\n      ],\n      actions: [\n        {\n          id: 'scan',\n          label: 'Scan stock',\n          icon: nativeNavIcon('barcode.viewfinder', 'qr_code_scanner'),\n          screen: 'commerce.scan',\n        },\n        {\n          id: 'newProduct',\n          label: 'New product',\n          icon: nativeNavIcon('plus', 'add'),\n          screen: 'commerce.product',\n          params: { new: '1' },\n        },\n      ],\n      docs: '/commerce-and-bookings/commerce/overview',\n      console: nativeNavRef('hostPluginTab', '/products'),\n    },\n  },\n]\n\n/** The console's POS tab is the register app's, not a row of this one. */\nexport const NATIVE_NAV_ELSEWHERE: readonly NativeNavElsewhere[] = [\n  { console: nativeNavRef('hostPluginTab', '/pos'), where: 'The POS app' },\n]\n\n/** A product (\"Add product\" on Catalog) and a draft order (\"Draft order\" on Orders). */\nexport const NATIVE_NAV_CREATE: readonly NativeNavCreateContribution[] = [\n  {\n    scope: 'site',\n    item: {\n      id: 'product',\n      label: 'Product',\n      icon: nativeNavIcon('tag', 'sell'),\n      screen: 'commerce.product',\n      params: { new: '1' },\n      pluginId: 'commerce',\n      planFeature: 'commerce',\n      order: 20,\n      console: nativeNavRef('hostPluginSection', '/products/catalog'),\n    },\n  },\n  {\n    scope: 'site',\n    item: {\n      id: 'draftOrder',\n      label: 'Draft order',\n      icon: nativeNavIcon('link.badge.plus', 'link'),\n      screen: 'commerce.orders',\n      params: { new: '1' },\n      pluginId: 'commerce',\n      planFeature: 'commerce',\n      order: 30,\n      console: nativeNavRef('hostPluginSection', '/products/orders'),\n    },\n  },\n]\n"],"names":["nativeNavHubSection","nativeNavIcon","nativeNavRef","NATIVE_NAV_ROWS","list","group","row","id","label","icon","screen","pluginId","order","sections","docs","console","keywords","actions","params","new","NATIVE_NAV_ELSEWHERE","where","NATIVE_NAV_CREATE","scope","item","planFeature"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAIEA,mBAAmB,EACnBC,aAAa,EACbC,YAAY,QACP,oCAAmC;AAE1C;;;;;;;CAOC,GAED,OAAO,MAAMC,kBAAoD;IAC/D;QACEC,MAAM;QACNC,OAAO;QACPC,KAAK;YACHC,IAAI;YACJC,OAAO;YACPC,MAAMR,cAAc,OAAO;YAC3BS,QAAQ;YACRC,UAAU;YACVC,OAAO;YACPC,UAAU;gBACRb,oBAAoB,QAAQ,aAAa,UAAU,UAAU;gBAC7DA,oBAAoB,QAAQ,aAAa,WAAW,WAAW;gBAC/DA,oBAAoB,QAAQ,aAAa,gBAAgB,gBAAgB;aAC1E;YACDc,MAAM;YACNC,SAASb,aAAa,qBAAqB;QAC7C;IACF;IACA;QACEE,MAAM;QACNC,OAAO;QACPC,KAAK;YACHC,IAAI;YACJC,OAAO;YACPC,MAAMR,cAAc,OAAO;YAC3BS,QAAQ;YACRC,UAAU;YACVC,OAAO;YACPI,UAAU;gBAAC;gBAAW;gBAAS;aAAY;YAC3CH,UAAU;gBACRb,oBAAoB,QAAQ,aAAa,WAAW,WAAW;gBAC/DA,oBAAoB,QAAQ,aAAa,cAAc,cAAc;gBACrEA,oBAAoB,QAAQ,aAAa,aAAa,aAAa;aACpE;YACDiB,SAAS;gBACP;oBACEV,IAAI;oBACJC,OAAO;oBACPC,MAAMR,cAAc,sBAAsB;oBAC1CS,QAAQ;gBACV;gBACA;oBACEH,IAAI;oBACJC,OAAO;oBACPC,MAAMR,cAAc,QAAQ;oBAC5BS,QAAQ;oBACRQ,QAAQ;wBAAEC,KAAK;oBAAI;gBACrB;aACD;YACDL,MAAM;YACNC,SAASb,aAAa,iBAAiB;QACzC;IACF;CACD,CAAA;AAED,wEAAwE,GACxE,OAAO,MAAMkB,uBAAsD;IACjE;QAAEL,SAASb,aAAa,iBAAiB;QAASmB,OAAO;IAAc;CACxE,CAAA;AAED,sFAAsF,GACtF,OAAO,MAAMC,oBAA4D;IACvE;QACEC,OAAO;QACPC,MAAM;YACJjB,IAAI;YACJC,OAAO;YACPC,MAAMR,cAAc,OAAO;YAC3BS,QAAQ;YACRQ,QAAQ;gBAAEC,KAAK;YAAI;YACnBR,UAAU;YACVc,aAAa;YACbb,OAAO;YACPG,SAASb,aAAa,qBAAqB;QAC7C;IACF;IACA;QACEqB,OAAO;QACPC,MAAM;YACJjB,IAAI;YACJC,OAAO;YACPC,MAAMR,cAAc,mBAAmB;YACvCS,QAAQ;YACRQ,QAAQ;gBAAEC,KAAK;YAAI;YACnBR,UAAU;YACVc,aAAa;YACbb,OAAO;YACPG,SAASb,aAAa,qBAAqB;QAC7C;IACF;CACD,CAAA"}

package/src/lib/server/order-event-triggers.d.ts

@@ -34,6 +34,6 @@ export declare function hostEventPayloadFor(envelope: Pick<PluginDomainEventEnve
  */
 export declare function registerCommerceEventTriggers(): void;
 /** The order events that schedule a review request (AGL-3736). */
-export declare const REVIEW_REQUEST_EVENTS: readonly [import("@aglyn/aglyn/plugin-manager/plugin-domain-events").PluginDomainEvent<import("../model").OrderFulfilledEventPayload>, import("@aglyn/aglyn/plugin-manager/plugin-domain-events").PluginDomainEvent<import("../model").OrderEventPayload>, import("@aglyn/aglyn/plugin-manager/plugin-domain-events").PluginDomainEvent<import("../model").OrderEventPayload>];
+export declare const REVIEW_REQUEST_EVENTS: readonly [import("@aglyn/aglyn/plugin-manager/plugin-domain-events").PluginDomainEvent<import("../contracts").OrderFulfilledEventPayload>, import("@aglyn/aglyn/plugin-manager/plugin-domain-events").PluginDomainEvent<import("../contracts").OrderEventPayload>, import("@aglyn/aglyn/plugin-manager/plugin-domain-events").PluginDomainEvent<import("../contracts").OrderEventPayload>];
 /** The order events that change what ShippingEasy should hold. */
-export declare const SHIPPINGEASY_EVENTS: readonly [import("@aglyn/aglyn/plugin-manager/plugin-domain-events").PluginDomainEvent<import("../model").OrderEventPayload>, import("@aglyn/aglyn/plugin-manager/plugin-domain-events").PluginDomainEvent<import("../model").OrderEventPayload>, import("@aglyn/aglyn/plugin-manager/plugin-domain-events").PluginDomainEvent<import("../model").OrderRefundedEventPayload>];
+export declare const SHIPPINGEASY_EVENTS: readonly [import("@aglyn/aglyn/plugin-manager/plugin-domain-events").PluginDomainEvent<import("../contracts").OrderEventPayload>, import("@aglyn/aglyn/plugin-manager/plugin-domain-events").PluginDomainEvent<import("../contracts").OrderEventPayload>, import("@aglyn/aglyn/plugin-manager/plugin-domain-events").PluginDomainEvent<import("../contracts").OrderRefundedEventPayload>];