@d19n/youfibre-odin-sdk 2.0.103-beta.14 → 2.0.103-beta.16

package/dist/wholesale-provider/kci-effect-bridge.d.ts

@@ -28,7 +28,7 @@ export declare type KciServiceOrderKind = 'PROVIDE' | 'CEASE' | 'MODIFY' | 'UNSO
  * Allowed YF SDK composed action keys. Every value MUST grep-resolve as
  * `actionKey` in `packages/youfibre-odin-sdk/src/actions-v2/<Name>Dto.ts`.
  */
-export declare type YfWoComposedActionKey = 'MoveInstallWorkOrderToScheduled' | 'MoveInstallWorkOrderFromInProgressToPending' | 'MoveInstallWorkOrderFromPendingToInProgress' | 'MoveInstallWorkOrderToRemediation' | 'MoveInstallWorkOrderFromRemediationToInProgress' | 'CreateInstallRescheduledChangeReasonSupplier' | 'CompleteInstallWorkOrderFlow' | 'CancelInstallWorkOrderFlowSupplier' | 'CreateInstallCancelledChangeReasonSupplier';
+export declare type YfWoComposedActionKey = 'MoveInstallWorkOrderToScheduled' | 'MoveInstallWorkOrderToEnRoute' | 'MoveInstallWorkOrderFromInProgressToPending' | 'MoveInstallWorkOrderFromPendingToInProgress' | 'MoveInstallWorkOrderToRemediation' | 'MoveInstallWorkOrderFromRemediationToInProgress' | 'CreateInstallRescheduledChangeReasonSupplier' | 'CompleteInstallWorkOrderFlow' | 'CancelInstallWorkOrderFlowSupplier' | 'CreateInstallCancelledChangeReasonSupplier' | 'MoveBusinessInstallToEnRoute' | 'MoveBusinessInstallToInProgress' | 'MoveRemediationWorkOrderToEnRoute' | 'MoveRemediationWorkOrderToInProgress' | 'MoveServiceWorkOrderFromAcceptedToScheduled' | 'MoveServiceWorkOrderToEnRoute' | 'MoveServiceWorkOrderToInProgress';
 export declare type YfKciEffectKind = 'LOG_KCI_ONLY' | 'WO_FLOW_ACTION' | 'PROPERTY_WRITE' | 'NO_OP_DOCUMENTED';
 export declare type YfKciTargetEntity = 'OrderModule:Order' | 'CrmModule:Address' | 'FieldServiceModule:WorkOrder';
 export interface YfKciEffect {
@@ -49,6 +49,14 @@ export interface KciEffectRow {
     readonly reasonCode: FibreCafeKciReasonCode;
     readonly serviceOrderKind: KciServiceOrderKind;
     readonly yfOrderStagePreconditions?: ReadonlyArray<string>;
+    /** Optional supplierCode discriminator — when set, the row only matches
+     *  if the KCI's `supplierCodes[]` contains at least one of these. Used
+     *  to differentiate UPDATE KCIs (NETOMNIA emits 8+ distinct UPDATE
+     *  variants by supplierCode for INSTALL / BUSINESS / REMEDIATION /
+     *  SERVICE WO state transitions). The walker prefers the most-specific
+     *  matching row (with supplierCodes) over the generic fallback (no
+     *  supplierCodes). */
+    readonly supplierCodes?: ReadonlyArray<string>;
     readonly yfEffect: YfKciEffect;
     /** Always true per rule #4. Field is explicit so future rows that
      *  document an intentional skip can mark it false. */

package/dist/wholesale-provider/kci-effect-bridge.js

@@ -189,7 +189,141 @@ exports.KCI_EFFECT_ROWS = [
         },
         logAgainstOrder: true,
     },
+    // ── PROVIDE — UPDATE supplierCode variants ───────────────────────
+    // NETOMNIA emits UPDATE KCIs differentiated by supplierCodes[0] for the
+    // 4 WO types it exposes (INSTALL / INSTALL_BUSINESS / REMEDIATION /
+    // SERVICE) × engineer state (Scheduled / EnRoute / InProgress). Walker
+    // matches most-specific (with supplierCodes) before falling through to
+    // the generic provide-update row. Source: NET KCI catalog 2026-05-09.
+    //
+    // INSTALL WO
+    {
+        id: 'provide-update-install-en-route',
+        reasonCode: 'UPDATE',
+        serviceOrderKind: 'PROVIDE',
+        supplierCodes: ['NETOMNIA_WORK_ORDER_EN_ROUTE'],
+        yfEffect: {
+            kind: 'WO_FLOW_ACTION',
+            woActionKey: 'MoveInstallWorkOrderToEnRoute',
+            notes: 'INSTALL engineer travelling to site.',
+        },
+        logAgainstOrder: true,
+    },
+    {
+        id: 'provide-update-install-in-progress',
+        reasonCode: 'UPDATE',
+        serviceOrderKind: 'PROVIDE',
+        supplierCodes: ['NETOMNIA_WORK_ORDER_IN_PROGRESS'],
+        yfEffect: {
+            kind: 'LOG_KCI_ONLY',
+            notes: 'INSTALL engineer on site. WO already at InProgress from earlier RESUMED ' +
+                'or scheduling flow — informational only.',
+        },
+        logAgainstOrder: true,
+    },
+    // INSTALL_BUSINESS WO
+    {
+        id: 'provide-update-business-en-route',
+        reasonCode: 'UPDATE',
+        serviceOrderKind: 'PROVIDE',
+        supplierCodes: ['NETOMNIA_BUSINESS_INSTALL_WORK_ORDER_EN_ROUTE'],
+        yfEffect: {
+            kind: 'WO_FLOW_ACTION',
+            woActionKey: 'MoveBusinessInstallToEnRoute',
+            notes: 'Business INSTALL engineer travelling to site.',
+        },
+        logAgainstOrder: true,
+    },
+    {
+        id: 'provide-update-business-in-progress',
+        reasonCode: 'UPDATE',
+        serviceOrderKind: 'PROVIDE',
+        supplierCodes: ['NETOMNIA_BUSINESS_INSTALL_WORK_ORDER_IN_PROGRESS'],
+        yfEffect: {
+            kind: 'WO_FLOW_ACTION',
+            woActionKey: 'MoveBusinessInstallToInProgress',
+            notes: 'Business INSTALL engineer on site.',
+        },
+        logAgainstOrder: true,
+    },
+    // REMEDIATION WO (parent INSTALL stage unchanged — REM is its own WO)
+    {
+        id: 'provide-update-remediation-scheduled',
+        reasonCode: 'UPDATE',
+        serviceOrderKind: 'PROVIDE',
+        supplierCodes: ['NETOMNIA_REMEDIATION_WORK_ORDER_SCHEDULED'],
+        yfEffect: {
+            kind: 'LOG_KCI_ONLY',
+            notes: 'REMEDIATION WO scheduled. No SDK move-to-scheduled flow exposed; ' +
+                'WO is at Scheduled by default after Accepted. Logged informationally.',
+        },
+        logAgainstOrder: true,
+    },
+    {
+        id: 'provide-update-remediation-en-route',
+        reasonCode: 'UPDATE',
+        serviceOrderKind: 'PROVIDE',
+        supplierCodes: ['NETOMNIA_REMEDIATION_WORK_ORDER_EN_ROUTE'],
+        yfEffect: {
+            kind: 'WO_FLOW_ACTION',
+            woActionKey: 'MoveRemediationWorkOrderToEnRoute',
+            notes: 'REMEDIATION engineer travelling to site.',
+        },
+        logAgainstOrder: true,
+    },
+    {
+        id: 'provide-update-remediation-in-progress',
+        reasonCode: 'UPDATE',
+        serviceOrderKind: 'PROVIDE',
+        supplierCodes: ['NETOMNIA_REMEDIATION_WORK_ORDER_IN_PROGRESS'],
+        yfEffect: {
+            kind: 'WO_FLOW_ACTION',
+            woActionKey: 'MoveRemediationWorkOrderToInProgress',
+            notes: 'REMEDIATION engineer on site.',
+        },
+        logAgainstOrder: true,
+    },
+    // SERVICE WO
+    {
+        id: 'provide-update-service-scheduled',
+        reasonCode: 'UPDATE',
+        serviceOrderKind: 'PROVIDE',
+        supplierCodes: ['NETOMNIA_SERVICE_WORK_ORDER_SCHEDULED'],
+        yfEffect: {
+            kind: 'WO_FLOW_ACTION',
+            woActionKey: 'MoveServiceWorkOrderFromAcceptedToScheduled',
+            notes: 'SERVICE WO scheduled.',
+        },
+        logAgainstOrder: true,
+    },
+    {
+        id: 'provide-update-service-en-route',
+        reasonCode: 'UPDATE',
+        serviceOrderKind: 'PROVIDE',
+        supplierCodes: ['NETOMNIA_SERVICE_WORK_ORDER_EN_ROUTE'],
+        yfEffect: {
+            kind: 'WO_FLOW_ACTION',
+            woActionKey: 'MoveServiceWorkOrderToEnRoute',
+            notes: 'SERVICE engineer travelling to site.',
+        },
+        logAgainstOrder: true,
+    },
+    {
+        id: 'provide-update-service-in-progress',
+        reasonCode: 'UPDATE',
+        serviceOrderKind: 'PROVIDE',
+        supplierCodes: ['NETOMNIA_SERVICE_WORK_ORDER_IN_PROGRESS'],
+        yfEffect: {
+            kind: 'WO_FLOW_ACTION',
+            woActionKey: 'MoveServiceWorkOrderToInProgress',
+            notes: 'SERVICE engineer on site.',
+        },
+        logAgainstOrder: true,
+    },
     // ── PROVIDE — informational / no-action ──────────────────────────
+    // Generic UPDATE row — fallback for KCIs that don't carry a recognized
+    // supplierCode. Walker matches this only after rejecting all
+    // supplierCode-keyed UPDATE rows above.
     {
         id: 'provide-update',
         reasonCode: 'UPDATE',
@@ -285,6 +419,7 @@ exports.detectKciKind = detectKciKind;
  * the gap explicitly.
  */
 function decideKciDispatch(dto) {
+    var _a;
     const kind = detectKciKind(dto);
     if (!kind) {
         return {
@@ -293,7 +428,16 @@ function decideKciDispatch(dto) {
             serviceOrderKind: 'PROVIDE',
         };
     }
-    const row = exports.KCI_EFFECT_ROWS.find((r) => r.reasonCode === dto.reasonCode && r.serviceOrderKind === kind);
+    // Match priority: most-specific (with supplierCodes intersecting the
+    // KCI's supplierCodes[]) before generic (no supplierCodes). For UPDATE
+    // KCIs NETOMNIA emits 8+ variants discriminated by supplierCodes — the
+    // walker resolves each variant to its specific WO target action.
+    const candidates = exports.KCI_EFFECT_ROWS.filter((r) => r.reasonCode === dto.reasonCode && r.serviceOrderKind === kind);
+    const dtoSupplierCodes = (_a = dto.supplierCodes) !== null && _a !== void 0 ? _a : [];
+    const specificMatch = candidates.find((r) => r.supplierCodes !== undefined &&
+        r.supplierCodes.some((sc) => dtoSupplierCodes.includes(sc)));
+    const genericMatch = candidates.find((r) => r.supplierCodes === undefined);
+    const row = specificMatch !== null && specificMatch !== void 0 ? specificMatch : genericMatch;
     if (!row) {
         return { kind: 'NO_MATCH', reasonCode: dto.reasonCode, serviceOrderKind: kind };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d19n/youfibre-odin-sdk",
-  "version": "2.0.103-beta.14",
+  "version": "2.0.103-beta.16",
   "description": "",
   "author": "@d19n",
   "license": "UNLICENSED",
@@ -17,6 +17,11 @@
       "import": "./dist/wholesale-provider/index.js",
       "types": "./dist/wholesale-provider/index.d.ts"
     },
+    "./dist/wholesale-provider": {
+      "require": "./dist/wholesale-provider/index.js",
+      "import": "./dist/wholesale-provider/index.js",
+      "types": "./dist/wholesale-provider/index.d.ts"
+    },
     "./dist/*": {
       "require": "./dist/*.js",
       "import": "./dist/*.js",