@aglyn/plugins-commerce 1.0.0-beta.268 → 1.0.0-beta.270

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_basket'),
+            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_basket'),\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>];