@myparcel-dev/pdk-admin 1.14.1 → 2.0.0

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 <!-- MONOWEAVE:BELOW -->
 
+## [2.0.0](https://github.com/myparcelnl/js-pdk/compare/@myparcel-dev/pdk-admin@1.14.2...@myparcel-dev/pdk-admin@2.0.0) "@myparcel-dev/pdk-admin" (2026-06-04)
+
+
+### ⚠ BREAKING CHANGES
+
+* drive admin shipment options and checkout from the PDK capabilities API (#346)
+
+### Features
+
+* drive admin shipment options and checkout from the PDK capabilities API ([#346](https://github.com/myparcelnl/js-pdk/issues/346)) ([f62b934](https://github.com/myparcelnl/js-pdk/commit/f62b9348d4f4316da28dbb97e4c335fc8aa9df80)), closes [myparcelnl/pdk#459](https://github.com/myparcelnl/pdk/issues/459) [myparcelnl/pdk#459](https://github.com/myparcelnl/pdk/issues/459) [myparcelnl/pdk#459](https://github.com/myparcelnl/pdk/issues/459)
+
+
+
+
+## [1.14.2](https://github.com/myparcelnl/js-pdk/compare/@myparcel-dev/pdk-admin@1.14.1...@myparcel-dev/pdk-admin@1.14.2) "@myparcel-dev/pdk-admin" (2026-05-29)
+
+
+
+
 ## [1.14.1](https://github.com/myparcelnl/js-pdk/compare/@myparcel-dev/pdk-admin@1.14.0...@myparcel-dev/pdk-admin@1.14.1) "@myparcel-dev/pdk-admin" (2026-02-16)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myparcel-dev/pdk-admin",
-  "version": "1.14.1",
+  "version": "2.0.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/myparcelnl/js-pdk.git",
@@ -36,9 +36,9 @@
     "typecheck": "run ws:vue:typecheck \"$(pwd)\""
   },
   "dependencies": {
-    "@myparcel-dev/constants": "^2.7.0",
-    "@myparcel-dev/pdk-common": "^1.12.0",
-    "@myparcel-dev/sdk": "^5.0.0",
+    "@myparcel-dev/constants": "^2.9.0",
+    "@myparcel-dev/pdk-common": "^2.0.0",
+    "@myparcel-dev/sdk": "^5.1.0",
     "@myparcel-dev/vue-form-builder": "1.0.0-beta.42.6",
     "@tanstack/vue-query": "~4.43.0",
     "@vueuse/core": "^10.0.0",
@@ -47,7 +47,7 @@
     "lodash-unified": "^1.0.3",
     "pinia": "^2.0.0",
     "vite": "^5.4.10",
-    "vue": "3.4.31",
+    "vue": "3.5.35",
     "vue-tsc": "^2.0.0"
   },
   "devDependencies": {

package/src/__tests__/__snapshots__/exports.spec.ts.snap

@@ -10,6 +10,7 @@ exports[`exports > exports from index.ts 1`] = `
   "AdminInstanceContextKey",
   "AdminModalKey",
   "AdminView",
+  "BOX_MODE_ACTIONS",
   "BackendEndpoint",
   "BulkSelectCheckbox",
   "ChildProductSettingsView",
@@ -26,13 +27,17 @@ exports[`exports > exports from index.ts 1`] = `
   "FrontendEndpoint",
   "INJECT_ADMIN_INSTANCE",
   "INJECT_GLOBAL_PDK_ADMIN",
+  "LIST_ITEM_MODE_ACTIONS",
   "LogLevel",
+  "MODAL_MODE_ACTIONS",
   "ModalsView",
   "NotificationCategory",
   "NotificationContainer",
   "NotificationsView",
+  "ORDER_VIEW_IN_BACKOFFICE_ID",
   "OrderBoxView",
   "OrderListItemView",
+  "OrderMode",
   "PackageType",
   "PdkAdmin",
   "PlainElement",
@@ -42,6 +47,7 @@ exports[`exports > exports from index.ts 1`] = `
   "QUERY_KEY_SHIPMENT",
   "ResetButton",
   "ReturnsForm",
+  "STORE_MODE_ACTIONS",
   "ShipmentBarcode",
   "ShipmentOptionsForm",
   "ShipmentStatus",
@@ -145,6 +151,7 @@ exports[`exports > exports from index.ts 1`] = `
   "useMultiSelectInputContext",
   "useNotificationStore",
   "useOrderData",
+  "useOrderMode",
   "useOrdersData",
   "usePdkMutation",
   "usePrintOrdersMutation",
@@ -186,9 +193,9 @@ exports[`exports > exports from testing.ts 1`] = `
   "mockDefaultEndpoints",
   "mockDefaultGlobalContext",
   "mockDefaultLogger",
-  "mockDefaultPlatform",
   "mockDefaultPluginSettings",
   "mockDefaultPrintOptionsView",
+  "mockDefaultProposition",
   "mockDefaultShop",
   "mockDefaultTranslations",
 ]

package/src/__tests__/doComponentTestTeardown.ts

@@ -1,6 +1,8 @@
+import {vi} from 'vitest';
 import {config} from '@vue/test-utils';
 
 export const doComponentTestTeardown = (): void => {
   config.global.plugins = [];
   config.global.stubs = {};
+  vi.restoreAllMocks();
 };

package/src/__tests__/mocks/index.ts

@@ -7,7 +7,7 @@ export * from './mockDefaultDynamicContext';
 export * from './mockDefaultEndpoints';
 export * from './mockDefaultGlobalContext';
 export * from './mockDefaultLogger';
-export * from './mockDefaultPlatform';
+export * from './mockDefaultProposition';
 export * from './mockDefaultPluginSettings';
 export * from './mockDefaultPrintOptionsView';
 export * from './mockDefaultShop';

package/src/__tests__/mocks/mockDefaultAccount.ts

@@ -13,6 +13,7 @@ export const mockDefaultAccount = vi.fn((): Account.ModelAccount => {
       hasCarrierContract: false,
       orderMode: false,
     },
+    subscriptionFeatures: [],
     shops: [mockDefaultShop()],
   };
 });

package/src/__tests__/mocks/mockDefaultGlobalContext.ts

@@ -1,7 +1,7 @@
 import {vi} from 'vitest';
 import {type GlobalAdminContext} from '../../types';
 import {mockDefaultTranslations} from './mockDefaultTranslations';
-import {mockDefaultPlatform} from './mockDefaultPlatform';
+import {mockDefaultProposition} from './mockDefaultProposition';
 import {mockDefaultEndpoints} from './mockDefaultEndpoints';
 import {mockDefaultAppInfo} from './mockDefaultAppInfo';
 
@@ -15,7 +15,7 @@ export const mockDefaultGlobalContext = vi.fn((): GlobalAdminContext => {
     eventPong: 'test2',
     language: 'en-US',
     mode: '',
-    platform: mockDefaultPlatform(),
+    proposition: mockDefaultProposition(),
     translations: mockDefaultTranslations(),
   };
 });

package/src/__tests__/mocks/{mockDefaultPlatform.ts → mockDefaultProposition.ts}

@@ -1,11 +1,9 @@
 import {vi} from 'vitest';
 import {type GlobalAdminContext} from '../../types';
 
-export const mockDefaultPlatform = vi.fn((): GlobalAdminContext['platform'] => {
+export const mockDefaultProposition = vi.fn((): GlobalAdminContext['proposition'] => {
   return {
     backofficeUrl: 'https://backoffice.test.myparcel.nl',
-    defaultCarrier: 'postnl',
-    defaultCarrierId: 1,
     human: 'Test',
     localCountry: 'NL',
     name: 'test',

package/src/__tests__/mocks/mockDefaultShop.ts

@@ -16,5 +16,6 @@ export const mockDefaultShop = vi.fn((): Account.ModelShop => {
     hidden: false,
     shipmentOptions: {},
     trackTrace: {},
+    defaultCarrier: 'POSTNL',
   };
 });

package/src/__tests__/utils/getActionIds.ts

@@ -0,0 +1,12 @@
+import {type Component, type ComponentPublicInstance} from 'vue';
+import {type VueWrapper} from '@vue/test-utils';
+
+/**
+ * Extract action IDs from a mounted component that passes actions as props to a child stub.
+ */
+export const getActionIds = (wrapper: VueWrapper<ComponentPublicInstance>, childComponent: Component): string[] => {
+  const child = wrapper.findComponent(childComponent);
+  const actions = child.props('actions') as {id: string}[];
+
+  return actions.map((a) => a.id);
+};

package/src/__tests__/utils/mockOrderData.ts

@@ -0,0 +1,20 @@
+import {computed, ref} from 'vue';
+import {type Mock} from 'vitest';
+
+interface MockOrderDataOptions {
+  exported?: boolean;
+  shipments?: {id: number; deleted?: boolean}[];
+}
+
+export const mockOrderData = (
+  mockedUseOrderData: Mock,
+  {exported = false, shipments = []}: MockOrderDataOptions = {},
+): void => {
+  const orderData = {externalIdentifier: 'TEST-1', exported, shipments};
+
+  mockedUseOrderData.mockReturnValue({
+    order: computed(() => orderData),
+    loading: computed(() => false),
+    query: {data: ref(orderData), isLoading: ref(false)} as any,
+  });
+};

package/src/actions/composables/mutations/orders/useExportOrdersMutation.ts

@@ -42,7 +42,7 @@ export const useExportOrdersMutation = (
           fillShipmentsQueryData(queryClient, order.shipments?.slice(-1) ?? [], order);
         });
 
-        if (input.form) {
+        if (mode === MutationMode.Modal && input.form) {
           await input.form?.reset();
         }
       },

package/src/actions/composables/queries/account/useOrderCapabilitiesQuery.ts

@@ -0,0 +1,67 @@
+import {computed, type Ref} from 'vue';
+import {useQuery} from '@tanstack/vue-query';
+import {BackendEndpoint} from '@myparcel-dev/pdk-common';
+import {type ProxyCapabilitiesBody, type ProxyCapabilitiesCall} from '../../../../types';
+import {type ResolvedQuery} from '../../../../stores';
+import {globalLogger} from '../../../../services';
+import {usePdkAdminApi} from '../../../../sdk';
+
+/**
+ * The form-facing input for {@link useOrderCapabilitiesQuery} — flat fields from the order
+ * context. Carrier / packageType / deliveryType are intentionally omitted: this query asks
+ * "what's possible for this order" across all carriers, regardless of what the user has
+ * currently selected on the form. The shipment-scoped query handles the chosen-combo case.
+ */
+export type OrderCapabilitiesInput = {
+  cc?: string;
+  weight?: number;
+};
+
+/**
+ * Order-scoped capabilities query — fires the shared CapabilitiesAction with ONLY destination
+ * and weight, no carrier/packageType/deliveryType filters. Returns one entry per carrier with
+ * the union of `packageTypes`, `deliveryTypes`, and `options` valid for the order context.
+ *
+ * Drives the carrier / packageType / deliveryType dropdowns. Refetches only on cc / weight
+ * changes so option toggles and dropdown picks don't trigger needless network round-trips.
+ *
+ * Errors are logged via `globalLogger.error` so we have a breadcrumb for support, but we
+ * deliberately don't surface a user-facing toast — an intermittent capabilities failure
+ * shouldn't block the form, and the auto-clear treats the errored state as still-loading.
+ */
+export const useOrderCapabilitiesQuery = (
+  input: Ref<OrderCapabilitiesInput>,
+): ResolvedQuery<BackendEndpoint.ProxyCapabilities> => {
+  const enabled = computed(() => Boolean(input.value.cc));
+  const queryKey = computed(() => [BackendEndpoint.ProxyCapabilities, 'order', input.value] as const);
+
+  return useQuery(
+    queryKey,
+    async () => {
+      const {cc, weight} = input.value;
+
+      if (!cc) return [];
+
+      const pdk = usePdkAdminApi();
+      const proxyCapabilities = pdk.proxyCapabilities as unknown as ProxyCapabilitiesCall;
+
+      const body: ProxyCapabilitiesBody = {
+        recipient: {countryCode: cc},
+        ...(weight !== undefined ? {physicalProperties: {weight: {value: weight, unit: 'g'}}} : null),
+      };
+
+      const response = await proxyCapabilities({body, parameters: {filterSupported: true}});
+
+      return response.results ?? [];
+    },
+    {
+      enabled,
+      refetchOnWindowFocus: false,
+      refetchOnMount: false,
+      refetchOnReconnect: false,
+      onError: (error) => {
+        globalLogger.error('order-capabilities-query', 'request failed', error);
+      },
+    },
+  );
+};

package/src/actions/composables/queries/account/useShipmentCapabilitiesQuery.ts

@@ -0,0 +1,96 @@
+import {computed, type Ref} from 'vue';
+import {useQuery} from '@tanstack/vue-query';
+import {BackendEndpoint} from '@myparcel-dev/pdk-common';
+import {type ProxyCapabilitiesBody, type ProxyCapabilitiesCall} from '../../../../types';
+import {type ResolvedQuery} from '../../../../stores';
+import {globalLogger} from '../../../../services';
+import {usePdkAdminApi} from '../../../../sdk';
+
+/**
+ * The form-facing selection input — flat fields the form already has. The composable maps this
+ * to the actual capabilities API request body shape (`recipient`, `physicalProperties`, …) at
+ * the call site so consumers don't need to know the API's nesting conventions. Every field is
+ * optional because the form may not have all values yet; the query gates on `cc` via `enabled`
+ * and only fires once a destination is known. The shipment query also requires `carrier`,
+ * `packageType` AND `deliveryType` to be set before firing — anything less wouldn't yield
+ * shipment-specific metadata.
+ *
+ * `options` and `filterSupported` are intentionally not part of the selection: option toggles
+ * don't drive refetches (option interactions resolve client-side), and the composable always
+ * opts in to server-side allowlist filtering via the `filterSupported` query parameter.
+ */
+export type CapabilitiesSelection = {
+  cc?: string;
+  weight?: number;
+  carrier?: string;
+  packageType?: string;
+  deliveryType?: string;
+};
+
+/**
+ * Shipment-scoped capabilities query — fires the shared CapabilitiesAction with the FULL
+ * selection (carrier + packageType + deliveryType + cc + weight) and returns the matching
+ * carrier entry (the one shipment configuration the user has chosen). Drives the option panel
+ * and acts as the invalid-combo signal: when `results` is empty, the chosen combination isn't
+ * valid for the order context.
+ *
+ * The selection ref is the only refetch trigger — no window-focus, mount, or reconnect refetches.
+ * Server-side option filtering is opted in via the `filterSupported` query parameter so admin sees
+ * the same option allowlist that `Carrier::attributesToArray` applies on the contract-definition
+ * path.
+ *
+ * Errors are logged via `globalLogger.error` so we have a breadcrumb for support, but we
+ * deliberately don't surface a user-facing toast — an intermittent capabilities failure
+ * shouldn't block the form, and the auto-clear treats the errored state as still-loading.
+ *
+ * The selection ref is accepted as `Readonly<Ref>` because callers typically pass the
+ * debounced ref from `refDebounced`, which is read-only — and the composable never mutates
+ * the selection internally.
+ */
+export const useShipmentCapabilitiesQuery = (
+  selection: Readonly<Ref<CapabilitiesSelection>>,
+): ResolvedQuery<BackendEndpoint.ProxyCapabilities> => {
+  const enabled = computed(() =>
+    Boolean(
+      selection.value.cc && selection.value.carrier && selection.value.packageType && selection.value.deliveryType,
+    ),
+  );
+  const queryKey = computed(() => [BackendEndpoint.ProxyCapabilities, 'shipment', selection.value] as const);
+
+  return useQuery(
+    queryKey,
+    async () => {
+      const {cc, weight, carrier, packageType, deliveryType} = selection.value;
+
+      // The `enabled` gate guarantees these are all present when this runs; TypeScript can't
+      // see through the runtime check, so we narrow explicitly here.
+      if (!cc || !carrier || !packageType || !deliveryType) return [];
+
+      const pdk = usePdkAdminApi();
+      const proxyCapabilities = pdk.proxyCapabilities as unknown as ProxyCapabilitiesCall;
+
+      const body: ProxyCapabilitiesBody = {
+        recipient: {countryCode: cc},
+        // PDK orders carry physical-properties weight in grams (see WeightServiceInterface::UNIT_GRAMS),
+        // and the SDK's PhysicalPropertiesWeightV2 expects a {value, unit} object — not a primitive.
+        ...(weight !== undefined ? {physicalProperties: {weight: {value: weight, unit: 'g'}}} : null),
+        carrier,
+        packageType,
+        deliveryType,
+      };
+
+      const response = await proxyCapabilities({body, parameters: {filterSupported: true}});
+
+      return response.results ?? [];
+    },
+    {
+      enabled,
+      refetchOnWindowFocus: false,
+      refetchOnMount: false,
+      refetchOnReconnect: false,
+      onError: (error) => {
+        globalLogger.error('shipment-capabilities-query', 'request failed', error);
+      },
+    },
+  );
+};

package/src/actions/definitions/orders.ts

@@ -112,17 +112,15 @@ export const ordersPrintAction = defineAction({
 /**
  * Shown on orders that have been exported to MyParcel using order mode.
  */
+export const ORDER_VIEW_IN_BACKOFFICE_ID = 'show-exported-order';
+
 export const orderViewInBackofficeAction = defineAction({
-  id: 'show-exported-order',
+  id: ORDER_VIEW_IN_BACKOFFICE_ID,
   icon: AdminIcon.External,
   label: 'order_view_in_backoffice',
   handler() {
-    const {platform} = useGlobalContext();
-    const backofficeUrls = {
-      NL: 'https://backoffice.myparcel.nl/orders',
-      BE: 'https://backoffice.sendmyparcel.be/orders',
-    };
-    const url = backofficeUrls[platform.localCountry as 'NL' | 'BE'] || backofficeUrls['NL'];
-    window.open(url, '_blank');
+    const {proposition} = useGlobalContext();
+    const baseUrl = proposition.backofficeUrl.replace(/\/$/, '');
+    window.open(`${baseUrl}/orders`, '_blank');
   },
 });

package/src/actions/index.ts

@@ -2,5 +2,6 @@ export * from './composables';
 export * from './defineAction';
 export * from './definitions';
 export * from './executors';
+export * from './orderModeActions';
 export * from './print';
 export * from './stopActionHandler';

package/src/actions/orderModeActions.spec.ts

@@ -0,0 +1,150 @@
+import {describe, expect, it} from 'vitest';
+import {AdminAction, OrderMode} from '../data';
+import {
+  BOX_MODE_ACTIONS,
+  LIST_ITEM_MODE_ACTIONS,
+  MODAL_MODE_ACTIONS,
+  ORDER_VIEW_IN_BACKOFFICE_ID,
+  STORE_MODE_ACTIONS,
+} from './orderModeActions';
+
+const getDefinitionIds = (actions: {name?: string; id?: string}[]): string[] =>
+  actions.map((a) => a.name ?? a.id ?? '');
+
+describe('orderModeActions', () => {
+  describe('all mappings cover every OrderMode', () => {
+    const allModes = Object.values(OrderMode);
+
+    it.each([
+      {name: 'STORE_MODE_ACTIONS', mapping: STORE_MODE_ACTIONS},
+      {name: 'BOX_MODE_ACTIONS', mapping: BOX_MODE_ACTIONS},
+      {name: 'MODAL_MODE_ACTIONS', mapping: MODAL_MODE_ACTIONS},
+      {name: 'LIST_ITEM_MODE_ACTIONS', mapping: LIST_ITEM_MODE_ACTIONS},
+    ])('$name has an entry for every OrderMode', ({mapping}) => {
+      expect(Object.keys(mapping)).toEqual(expect.arrayContaining(allModes));
+    });
+  });
+
+  describe('LIST_ITEM_MODE_ACTIONS', () => {
+    it('includes edit and export for OrderV1', () => {
+      const ids = getDefinitionIds(LIST_ITEM_MODE_ACTIONS[OrderMode.OrderV1]);
+
+      expect(ids).toEqual([AdminAction.OrdersEdit, AdminAction.OrdersExport]);
+    });
+
+    it('includes edit and export-to-shipments for OrderV2 (hybrid)', () => {
+      const ids = getDefinitionIds(LIST_ITEM_MODE_ACTIONS[OrderMode.OrderV2]);
+
+      expect(ids).toEqual([AdminAction.OrdersEdit, AdminAction.OrdersExport]);
+    });
+
+    it('has no actions for Shipments mode', () => {
+      expect(LIST_ITEM_MODE_ACTIONS[OrderMode.Shipments]).toHaveLength(0);
+    });
+  });
+
+  describe('STORE_MODE_ACTIONS', () => {
+    it('registers export and backoffice actions for OrderV1', () => {
+      const ids = getDefinitionIds(STORE_MODE_ACTIONS[OrderMode.OrderV1]);
+
+      expect(ids).toContain(AdminAction.OrdersExport);
+      expect(ids).toContain(ORDER_VIEW_IN_BACKOFFICE_ID);
+    });
+
+    it('registers all shipment actions for Shipments mode', () => {
+      const ids = getDefinitionIds(STORE_MODE_ACTIONS[OrderMode.Shipments]);
+
+      expect(ids).toContain(AdminAction.OrdersPrint);
+      expect(ids).toContain(AdminAction.OrdersExport);
+      expect(ids).toContain(AdminAction.OrdersExportPrint);
+      expect(ids).toContain(AdminAction.ShipmentsExportReturn);
+      expect(ids).toContain(AdminAction.ShipmentsDelete);
+      expect(ids).toContain(AdminAction.ShipmentsUpdate);
+      expect(ids).toContain(AdminAction.ShipmentsPrint);
+    });
+
+    it('registers the full shipment action set for OrderV2 (hybrid mirrors Shipments)', () => {
+      const ids = getDefinitionIds(STORE_MODE_ACTIONS[OrderMode.OrderV2]);
+
+      expect(ids).toContain(AdminAction.OrdersPrint);
+      expect(ids).toContain(AdminAction.OrdersExport);
+      expect(ids).toContain(AdminAction.OrdersExportPrint);
+      expect(ids).toContain(AdminAction.ShipmentsExportReturn);
+      expect(ids).toContain(AdminAction.ShipmentsDelete);
+      expect(ids).toContain(AdminAction.ShipmentsUpdate);
+      expect(ids).toContain(AdminAction.ShipmentsPrint);
+    });
+  });
+
+  describe('BOX_MODE_ACTIONS', () => {
+    it('includes export for OrderV1', () => {
+      const ids = getDefinitionIds(BOX_MODE_ACTIONS[OrderMode.OrderV1]);
+
+      expect(ids).toEqual([AdminAction.OrdersExport]);
+    });
+
+    it('includes export-to-shipments, print, and export-print for Shipments', () => {
+      const ids = getDefinitionIds(BOX_MODE_ACTIONS[OrderMode.Shipments]);
+
+      expect(ids).toContain(AdminAction.OrdersExport);
+      expect(ids).toContain(AdminAction.OrdersPrint);
+      expect(ids).toContain(AdminAction.OrdersExportPrint);
+    });
+
+    it('mirrors the Shipments set for OrderV2 (hybrid)', () => {
+      const ids = getDefinitionIds(BOX_MODE_ACTIONS[OrderMode.OrderV2]);
+
+      expect(ids).toContain(AdminAction.OrdersExport);
+      expect(ids).toContain(AdminAction.OrdersPrint);
+      expect(ids).toContain(AdminAction.OrdersExportPrint);
+    });
+  });
+
+  describe('MODAL_MODE_ACTIONS', () => {
+    it('includes export for OrderV1', () => {
+      const ids = getDefinitionIds(MODAL_MODE_ACTIONS[OrderMode.OrderV1]);
+
+      expect(ids).toEqual([AdminAction.OrdersExport]);
+    });
+
+    it('includes export-to-shipments and export-print for Shipments (no standalone print)', () => {
+      const ids = getDefinitionIds(MODAL_MODE_ACTIONS[OrderMode.Shipments]);
+
+      expect(ids).toContain(AdminAction.OrdersExport);
+      expect(ids).toContain(AdminAction.OrdersExportPrint);
+      expect(ids).not.toContain(AdminAction.OrdersPrint);
+    });
+
+    it('mirrors the Shipments set for OrderV2 (hybrid)', () => {
+      const ids = getDefinitionIds(MODAL_MODE_ACTIONS[OrderMode.OrderV2]);
+
+      expect(ids).toContain(AdminAction.OrdersExport);
+      expect(ids).toContain(AdminAction.OrdersExportPrint);
+      expect(ids).not.toContain(AdminAction.OrdersPrint);
+    });
+  });
+
+  describe('consistency between mappings', () => {
+    it('BOX actions are a subset of STORE actions for each mode', () => {
+      for (const mode of Object.values(OrderMode)) {
+        const storeIds = getDefinitionIds(STORE_MODE_ACTIONS[mode]);
+        const boxIds = getDefinitionIds(BOX_MODE_ACTIONS[mode]);
+
+        for (const id of boxIds) {
+          expect(storeIds, `BOX action ${id} in ${mode} mode should also be in STORE`).toContain(id);
+        }
+      }
+    });
+
+    it('MODAL actions are a subset of STORE actions for each mode', () => {
+      for (const mode of Object.values(OrderMode)) {
+        const storeIds = getDefinitionIds(STORE_MODE_ACTIONS[mode]);
+        const modalIds = getDefinitionIds(MODAL_MODE_ACTIONS[mode]);
+
+        for (const id of modalIds) {
+          expect(storeIds, `MODAL action ${id} in ${mode} mode should also be in STORE`).toContain(id);
+        }
+      }
+    });
+  });
+});

package/src/actions/orderModeActions.ts

@@ -0,0 +1,90 @@
+import {type AnyActionDefinition} from '../types';
+import {OrderMode} from '../data';
+import {
+  orderExportAction,
+  orderExportToShipmentsAction,
+  ordersEditAction,
+  ordersExportPrintShipmentsAction,
+  ordersPrintAction,
+  orderViewInBackofficeAction,
+  shipmentsDeleteAction,
+  shipmentsExportReturnAction,
+  shipmentsPrintAction,
+  shipmentsUpdateAction,
+} from './definitions';
+
+export {ORDER_VIEW_IN_BACKOFFICE_ID} from './definitions';
+
+/**
+ * Mode-specific actions for global store registration (superset of all available actions per mode).
+ *
+ * OrderV2 currently mirrors the Shipments set so manual shipment export and the related
+ * actions remain available while V2 fulfilment continues externally. INT-1590 will
+ * make this conditional on sales-channel detection so V2 with an active sales channel
+ * goes back to an empty set.
+ */
+export const STORE_MODE_ACTIONS: Record<OrderMode, AnyActionDefinition[]> = {
+  [OrderMode.OrderV1]: [orderExportAction, orderViewInBackofficeAction],
+  [OrderMode.Shipments]: [
+    ordersPrintAction,
+    orderExportToShipmentsAction,
+    ordersExportPrintShipmentsAction,
+    shipmentsExportReturnAction,
+    shipmentsDeleteAction,
+    shipmentsUpdateAction,
+    shipmentsPrintAction,
+  ],
+  // @TODO INT-1590: empty this array again once sales-channel detection gates V2.
+  [OrderMode.OrderV2]: [
+    ordersPrintAction,
+    orderExportToShipmentsAction,
+    ordersExportPrintShipmentsAction,
+    shipmentsExportReturnAction,
+    shipmentsDeleteAction,
+    shipmentsUpdateAction,
+    shipmentsPrintAction,
+  ],
+};
+
+/**
+ * Mode-specific actions for the ShipmentOptionsBox component.
+ *
+ * OrderV2 currently mirrors the Shipments set so the order-detail box exposes manual
+ * export, print and export-print actions. {@see STORE_MODE_ACTIONS} for the
+ * INT-1590 follow-up note.
+ */
+export const BOX_MODE_ACTIONS: Record<OrderMode, AnyActionDefinition[]> = {
+  [OrderMode.OrderV1]: [orderExportAction],
+  [OrderMode.Shipments]: [orderExportToShipmentsAction, ordersPrintAction, ordersExportPrintShipmentsAction],
+  // @TODO INT-1590: empty this array again once sales-channel detection gates V2.
+  [OrderMode.OrderV2]: [orderExportToShipmentsAction, ordersPrintAction, ordersExportPrintShipmentsAction],
+};
+
+/**
+ * Mode-specific actions for the ShipmentOptionsModal component.
+ *
+ * OrderV2 currently mirrors the Shipments set so the modal exposes manual export and
+ * export-print actions. {@see STORE_MODE_ACTIONS} for the INT-1590 follow-up note.
+ */
+export const MODAL_MODE_ACTIONS: Record<OrderMode, AnyActionDefinition[]> = {
+  [OrderMode.OrderV1]: [orderExportAction],
+  [OrderMode.Shipments]: [orderExportToShipmentsAction, ordersExportPrintShipmentsAction],
+  // @TODO INT-1590: empty this array again once sales-channel detection gates V2.
+  [OrderMode.OrderV2]: [orderExportToShipmentsAction, ordersExportPrintShipmentsAction],
+};
+
+/**
+ * Mode-specific actions rendered in the order-list-item button group.
+ * Shipments mode uses its own computed action logic in ShipmentModeOrderListItem.vue.
+ *
+ * OrderV2 surfaces the same edit + manual export combination as OrderV1, but routes
+ * export through the shipments-export action because in V2 the backend falls through
+ * to the shipments-export path. {@see STORE_MODE_ACTIONS} for the INT-1590 follow-up
+ * note.
+ */
+export const LIST_ITEM_MODE_ACTIONS: Record<OrderMode, AnyActionDefinition[]> = {
+  [OrderMode.OrderV1]: [ordersEditAction, orderExportAction],
+  // @TODO INT-1590: drop orderExportToShipmentsAction once sales-channel detection gates V2.
+  [OrderMode.OrderV2]: [ordersEditAction, orderExportToShipmentsAction],
+  [OrderMode.Shipments]: [],
+};