@myparcel-dev/pdk-admin 2.2.0 → 2.2.2

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 <!-- MONOWEAVE:BELOW -->
 
+## [2.2.2](https://github.com/myparcelnl/js-pdk/compare/@myparcel-dev/pdk-admin@2.2.1...@myparcel-dev/pdk-admin@2.2.2) "@myparcel-dev/pdk-admin" (2026-08-19)
+
+
+### Bug Fixes
+
+* **insurance:** read insurance limits from the flat capabilities format ([#383](https://github.com/myparcelnl/js-pdk/issues/383)) ([8794c46](https://github.com/myparcelnl/js-pdk/commit/8794c46ee0ffce36fdad9b3e7dc95e44ee56af23)), closes [myparcelnl/pdk#511](https://github.com/myparcelnl/pdk/issues/511)
+
+
+
+
+## [2.2.1](https://github.com/myparcelnl/js-pdk/compare/@myparcel-dev/pdk-admin@2.2.0...@myparcel-dev/pdk-admin@2.2.1) "@myparcel-dev/pdk-admin" (2026-08-07)
+
+
+
+
 ## [2.2.0](https://github.com/myparcelnl/js-pdk/compare/@myparcel-dev/pdk-admin@2.1.0...@myparcel-dev/pdk-admin@2.2.0) "@myparcel-dev/pdk-admin" (2026-08-06)
 
 

package/dist/forms/helpers/useFormCapabilities.d.ts

@@ -37,8 +37,8 @@ export type FormCapabilities = {
      */
     hasShipmentOption: (form: FormInstance, option: string) => boolean;
     /**
-     * Insurance amount bracket options derived from the currently selected carrier's
-     * `insuredAmount` data. Amounts in the context are in cents; emitted values are strings
+     * Insurance amount bracket options derived from the currently selected carrier's insurance
+     * limits (`min` / `max`). Amounts in the context are in cents; emitted values are strings
      * representing cent amounts so they round-trip through form select inputs unchanged.
      */
     getInsuranceOptions: (form: FormInstance, formatter: Formatter) => SelectOption[];

package/dist/forms/shipmentOptions/fieldFactoryRegistry.d.ts

@@ -15,7 +15,7 @@ export type FieldFactory = (refs: ShipmentOptionsRefs, fieldName: string) => Int
  * `carrier.options`) to its custom factory function.
  *
  * Current exceptions:
- * - `insurance`: renders as a select/dropdown with amount brackets derived from
- *   `insuredAmount` in the option data.
+ * - `insurance`: renders as a select/dropdown with amount brackets derived from the
+ *   `min` / `max` limits in the option data.
  */
 export declare const fieldFactoryRegistry: Record<string, FieldFactory>;

package/dist/forms/shipmentOptions/fields/createInsuranceField.d.ts

@@ -4,7 +4,7 @@ import { type ShipmentOptionsRefs } from '../types';
  * Custom field factory for the insurance shipment option.
  *
  * Renders as a select/dropdown instead of a TriState toggle. Insurance amount brackets are
- * derived from the currently selected carrier's shipment-scoped `insuredAmount` data (min/max)
+ * derived from the currently selected carrier's shipment-scoped insurance limits (min/max)
  * and refresh automatically whenever that data changes — i.e. on carrier change AND on
  * packageType / deliveryType / weight / cc change, since those all narrow the shipment-scoped
  * capabilities response.

package/dist/forms/shipmentOptions/wireProxyCapabilities.d.ts

@@ -13,8 +13,8 @@ import { type CapabilitiesSelection } from '../../actions/composables/queries/ac
  * - **Order query** drives the carrier / packageType / deliveryType dropdowns from each
  *   carrier's flat union arrays. Refetches only when destination, weight or the recipient
  *   business flag change.
- * - **Shipment query** drives per-option metadata (`isRequired`, `requires`, `excludes`,
- *   `insuredAmount`) for the chosen combination. Refetches when any axis of the selection
+ * - **Shipment query** drives per-option metadata (`isRequired`, `requires`, `excludes`, and the
+ *   insurance `min` / `max`) for the chosen combination. Refetches when any axis of the selection
  *   changes; the empty-result case is the invalid-combo signal consumed by
  *   `useCapabilitiesAutoClear`.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myparcel-dev/pdk-admin",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/myparcelnl/js-pdk.git",
@@ -37,7 +37,7 @@
   },
   "dependencies": {
     "@myparcel-dev/constants": "^2.9.0",
-    "@myparcel-dev/pdk-common": "^2.1.0",
+    "@myparcel-dev/pdk-common": "^2.1.2",
     "@myparcel-dev/sdk": "^5.1.0",
     "@myparcel-dev/vue-form-builder": "1.0.0-beta.42.6",
     "@tanstack/vue-query": "~4.43.0",
@@ -46,9 +46,7 @@
     "lodash-es": "^4.17.21",
     "lodash-unified": "^1.0.3",
     "pinia": "^2.0.0",
-    "vite": "^5.4.10",
-    "vue": "3.5.40",
-    "vue-tsc": "^3.3.9"
+    "vue": "3.4.31"
   },
   "devDependencies": {
     "@myparcel-dev/pdk-build-vite": "1.0.0-alpha.0",
@@ -56,7 +54,8 @@
     "@vue/test-utils": "^2.0.0",
     "typescript": "^5.2.2",
     "vite": "^5.4.10",
-    "vitest": "^3.2.6"
+    "vitest": "^3.2.6",
+    "vue-tsc": "^3.3.9"
   },
   "engines": {
     "node": ">=20"

package/src/forms/helpers/useFormCapabilities.spec.ts

@@ -182,11 +182,9 @@ describe('useFormCapabilities', () => {
         carrier: 'POSTNL',
         options: {
           insurance: {
-            insuredAmount: {
-              min: {amount: 0, currency: 'EUR'},
-              max: {amount: 0, currency: 'EUR'},
-              default: {amount: 0, currency: 'EUR'},
-            },
+            min: {amount: 0, currency: 'EUR'},
+            max: {amount: 0, currency: 'EUR'},
+            default: {amount: 0, currency: 'EUR'},
           } as never,
         },
       });
@@ -202,12 +200,10 @@ describe('useFormCapabilities', () => {
         carrier: 'POSTNL',
         options: {
           insurance: {
-            insuredAmount: {
-              min: {amount: 0, currency: 'EUR'},
-              // max is 1000€ in cents
-              max: {amount: 100_000, currency: 'EUR'},
-              default: {amount: 0, currency: 'EUR'},
-            },
+            min: {amount: 0, currency: 'EUR'},
+            // max is 1000€ in cents
+            max: {amount: 100_000, currency: 'EUR'},
+            default: {amount: 0, currency: 'EUR'},
           } as never,
         },
       });
@@ -223,5 +219,21 @@ describe('useFormCapabilities', () => {
       // the boundary semantics — replacing `<` with `<=` on LOW_THRESHOLD would shift these.
       expect(values.slice(1)).toEqual(['0', '25000', '50000', '100000']);
     });
+
+    it('returns [] when the carrier advertises insurance without limits', async () => {
+      // Stored carrier data that predates the flat limits: insurance is offered, but there is
+      // no max to build brackets up to, so there is nothing to enumerate into the dropdown.
+      const shipment = buildCarrier({
+        carrier: 'POSTNL',
+        options: {
+          insurance: {isRequired: false, isSelectedByDefault: false} as never,
+        },
+      });
+      queryStore.setQuery(shipmentModifier('order-1'), 'success', [shipment]);
+
+      const {useFormCapabilities} = await import('./useFormCapabilities');
+
+      expect(useFormCapabilities().getInsuranceOptions(formStub('POSTNL'), formatter)).toEqual([]);
+    });
   });
 });

package/src/forms/helpers/useFormCapabilities.ts

@@ -7,14 +7,6 @@ import {type AdminContext, type SelectOption} from '../../types';
 import {useQueryStore, type ResolvedQuery} from '../../stores';
 import {Format, type Formatter} from '../../composables';
 
-interface InsuranceAmountData {
-  insuredAmount?: {
-    min: {amount: number; currency: string};
-    max: {amount: number; currency: string};
-    default: {amount: number; currency: string};
-  };
-}
-
 /**
  * Bag of capability resolvers, each pre-bound to a Pinia store + orderId snapshot captured at
  * the composable's invocation time. Returned by {@link useFormCapabilities}.
@@ -53,8 +45,8 @@ export type FormCapabilities = {
   hasShipmentOption: (form: FormInstance, option: string) => boolean;
 
   /**
-   * Insurance amount bracket options derived from the currently selected carrier's
-   * `insuredAmount` data. Amounts in the context are in cents; emitted values are strings
+   * Insurance amount bracket options derived from the currently selected carrier's insurance
+   * limits (`min` / `max`). Amounts in the context are in cents; emitted values are strings
    * representing cent amounts so they round-trip through form select inputs unchanged.
    */
   getInsuranceOptions: (form: FormInstance, formatter: Formatter) => SelectOption[];
@@ -80,11 +72,10 @@ export type FormCapabilities = {
  * window focus, so we read `query.data` live on every resolver call rather than snapshotting
  * the carriers array at setup time.
  */
+// eslint-disable-next-line max-lines-per-function
 export const useFormCapabilities = (): FormCapabilities => {
   const queryStore = useQueryStore();
-  const dynamicContextQuery = queryStore.get(BackendEndpoint.FetchContext, AdminContextKey.Dynamic) as ResolvedQuery<
-    BackendEndpoint.FetchContext
-  >;
+  const dynamicContextQuery = queryStore.get(BackendEndpoint.FetchContext, AdminContextKey.Dynamic);
   const orderId = getOrderId();
 
   const orderModifier = typeof orderId === 'string' ? `${orderId}.order` : undefined;
@@ -97,7 +88,7 @@ export const useFormCapabilities = (): FormCapabilities => {
 
     if (toValue(query.status) !== 'success') return undefined;
 
-    return (toValue(query.data) ?? []) as CarrierModel[];
+    return toValue(query.data) ?? [];
   };
 
   const liveDynamicCarriers = (): CarrierModel[] => {
@@ -145,10 +136,10 @@ export const useFormCapabilities = (): FormCapabilities => {
     const STEP_THRESHOLD = 500;
 
     const carrier = getCarrierCapabilitiesForShipment(form);
-    const insuranceData = (carrier?.options?.insurance ?? {}) as InsuranceAmountData;
+    const insuranceData = carrier?.options?.insurance;
 
-    const min = insuranceData.insuredAmount?.min.amount ? insuranceData.insuredAmount.min.amount / 100 : 0;
-    const max = insuranceData.insuredAmount?.max.amount ? insuranceData.insuredAmount.max.amount / 100 : 0;
+    const min = insuranceData?.min?.amount ? insuranceData.min.amount / 100 : 0;
+    const max = insuranceData?.max?.amount ? insuranceData.max.amount / 100 : 0;
 
     if (max === 0) return [];
 

package/src/forms/shipmentOptions/createShipmentOptionsForm.ts

@@ -86,7 +86,7 @@ export const createShipmentOptionsForm = (orders?: OneOrMore<Plugin.ModelPdkOrde
  * `hasShipmentOption`, which checks whether the currently selected carrier
  * supports each option.
  *
- * Runtime carrier-specific data (isRequired, insuredAmount, etc.) is read
+ * Runtime carrier-specific data (isRequired, insurance limits, etc.) is read
  * from the currently selected carrier via `getCarrier(form)`, not from
  * creation-time option data.
  */

package/src/forms/shipmentOptions/fieldFactoryRegistry.ts

@@ -18,8 +18,8 @@ export type FieldFactory = (refs: ShipmentOptionsRefs, fieldName: string) => Int
  * `carrier.options`) to its custom factory function.
  *
  * Current exceptions:
- * - `insurance`: renders as a select/dropdown with amount brackets derived from
- *   `insuredAmount` in the option data.
+ * - `insurance`: renders as a select/dropdown with amount brackets derived from the
+ *   `min` / `max` limits in the option data.
  */
 export const fieldFactoryRegistry: Record<string, FieldFactory> = {
   insurance: createInsuranceField,

package/src/forms/shipmentOptions/fields/createInsuranceField.ts

@@ -13,7 +13,7 @@ import {createRef} from './createRef';
  * Custom field factory for the insurance shipment option.
  *
  * Renders as a select/dropdown instead of a TriState toggle. Insurance amount brackets are
- * derived from the currently selected carrier's shipment-scoped `insuredAmount` data (min/max)
+ * derived from the currently selected carrier's shipment-scoped insurance limits (min/max)
  * and refresh automatically whenever that data changes — i.e. on carrier change AND on
  * packageType / deliveryType / weight / cc change, since those all narrow the shipment-scoped
  * capabilities response.
@@ -39,7 +39,7 @@ export const createInsuranceField = (
 
       // Watch the shipment-scoped carrier capabilities directly. The resolver tracks both the
       // selected carrier (via `form.getValue(FIELD_CARRIER)`) and the shipment-capabilities
-      // query data, so any axis change that updates `insuredAmount` triggers a refresh.
+      // query data, so any axis change that updates the insurance limits triggers a refresh.
       stopWatcher = watch(
         () => capabilities.getCarrierCapabilitiesForShipment(field.form),
         () => {

package/src/forms/shipmentOptions/wireProxyCapabilities.ts

@@ -47,8 +47,8 @@ const resolveOrderInput = (form: FormInstance, order: Plugin.ModelContextOrderDa
  * - **Order query** drives the carrier / packageType / deliveryType dropdowns from each
  *   carrier's flat union arrays. Refetches only when destination, weight or the recipient
  *   business flag change.
- * - **Shipment query** drives per-option metadata (`isRequired`, `requires`, `excludes`,
- *   `insuredAmount`) for the chosen combination. Refetches when any axis of the selection
+ * - **Shipment query** drives per-option metadata (`isRequired`, `requires`, `excludes`, and the
+ *   insurance `min` / `max`) for the chosen combination. Refetches when any axis of the selection
  *   changes; the empty-result case is the invalid-combo signal consumed by
  *   `useCapabilitiesAutoClear`.
  *