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

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

@@ -29,7 +29,7 @@ export declare type KciServiceOrderKind = 'PROVIDE' | 'CEASE' | 'MODIFY' | 'UNSO
  * `actionKey` in `packages/youfibre-odin-sdk/src/actions-v2/<Name>Dto.ts`.
  */
 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 YfKciEffectKind = 'LOG_KCI_ONLY' | 'WO_FLOW_ACTION' | 'WO_SCHEDULE_APPOINTMENT' | 'PROPERTY_WRITE' | 'NO_OP_DOCUMENTED';
 export declare type YfKciTargetEntity = 'OrderModule:Order' | 'CrmModule:Address' | 'FieldServiceModule:WorkOrder';
 export interface YfKciEffect {
     readonly kind: YfKciEffectKind;
@@ -42,6 +42,21 @@ export interface YfKciEffect {
     };
     /** For NO_OP_DOCUMENTED: required reason text. */
     readonly noOpReason?: string;
+    /** For WO_SCHEDULE_APPOINTMENT: bundled stage move + appointment + supplier
+     * reference via the field-service scheduleAppointment service. The dispatcher
+     * extracts each property's value from the DTO at the JSONPath given by
+     * `*From` and POSTs to /FieldServiceModule/.../schedule-appointment with
+     * skipSupplierBooking=true (the KCI is the supplier's commit, not a request). */
+    readonly scheduleAppointment?: {
+        /** Which WO type the appointment lives on. */
+        readonly woType: 'INSTALL' | 'INSTALL_BUSINESS' | 'SERVICE';
+        /** JSONPath from KCI dto root for the appointment start datetime. */
+        readonly dateFrom: string;
+        /** JSONPath for the timeslot classification (WEEKDAY_AM / WEEKDAY_PM / etc.). */
+        readonly timeBlockFrom: string;
+        /** JSONPath for the supplier-side appointment reservation reference. */
+        readonly supplierReferenceFrom: string;
+    };
     readonly notes: string;
 }
 export interface KciEffectRow {
@@ -71,6 +86,13 @@ export declare type KciDispatchDecision = {
     kind: 'WO_FLOW_ACTION';
     row: KciEffectRow;
     woActionKey: YfWoComposedActionKey;
+} | {
+    kind: 'WO_SCHEDULE_APPOINTMENT';
+    row: KciEffectRow;
+    woType: 'INSTALL' | 'INSTALL_BUSINESS' | 'SERVICE';
+    dateFrom: string;
+    timeBlockFrom: string;
+    supplierReferenceFrom: string;
 } | {
     kind: 'PROPERTY_WRITE';
     row: KciEffectRow;

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

@@ -148,9 +148,13 @@ exports.KCI_EFFECT_ROWS = [
         reasonCode: 'RESUMED',
         serviceOrderKind: 'PROVIDE',
         yfEffect: {
-            kind: 'WO_FLOW_ACTION',
-            woActionKey: 'MoveInstallWorkOrderFromPendingToInProgress',
-            notes: 'Supplier resumed fulfillment after Pending/Held.',
+            kind: 'LOG_KCI_ONLY',
+            notes: "RESUMED is NET-side ambiguous (emitted for both Held→InProgress and " +
+                "the invalid-in-YF Pending→InProgress). Per Frank: Pending→InProgress " +
+                "is never a valid YF transition (Pending exits to Scheduled only). " +
+                "RESOLVED already covers the RemediationRequired→InProgress case. " +
+                "Log only until T-20260508-011 has NET emit REAPPOINTED for the rebook " +
+                "case instead of RESUMED.",
         },
         logAgainstOrder: true,
     },
@@ -183,9 +187,17 @@ exports.KCI_EFFECT_ROWS = [
         reasonCode: 'REAPPOINTED',
         serviceOrderKind: 'PROVIDE',
         yfEffect: {
-            kind: 'WO_FLOW_ACTION',
-            woActionKey: 'CreateInstallRescheduledChangeReasonSupplier',
-            notes: 'Supplier-side reappointment confirmed. Reschedule flow + ChangeReason for audit.',
+            kind: 'WO_SCHEDULE_APPOINTMENT',
+            scheduleAppointment: {
+                woType: 'INSTALL',
+                dateFrom: 'provideServiceOrder.appointmentTimeslot.timeslotStartDateTime',
+                timeBlockFrom: 'provideServiceOrder.appointmentTimeslot.classification',
+                supplierReferenceFrom: 'provideServiceOrder.appointmentReservationReference',
+            },
+            notes: 'Supplier-confirmed reschedule. Bundled effect: WO Pending→Scheduled + ' +
+                'set appointment date + stamp supplier reservation reference. Single ' +
+                'scheduleAppointment service call handles all three (skipSupplierBooking=true ' +
+                'because KCI is the commit, not a request).',
         },
         logAgainstOrder: true,
     },
@@ -449,6 +461,18 @@ function decideKciDispatch(dto) {
                 throw new Error(`bridge invariant: WO_FLOW_ACTION row ${row.id} missing woActionKey`);
             }
             return { kind: 'WO_FLOW_ACTION', row, woActionKey: row.yfEffect.woActionKey };
+        case 'WO_SCHEDULE_APPOINTMENT':
+            if (!row.yfEffect.scheduleAppointment) {
+                throw new Error(`bridge invariant: WO_SCHEDULE_APPOINTMENT row ${row.id} missing scheduleAppointment`);
+            }
+            return {
+                kind: 'WO_SCHEDULE_APPOINTMENT',
+                row,
+                woType: row.yfEffect.scheduleAppointment.woType,
+                dateFrom: row.yfEffect.scheduleAppointment.dateFrom,
+                timeBlockFrom: row.yfEffect.scheduleAppointment.timeBlockFrom,
+                supplierReferenceFrom: row.yfEffect.scheduleAppointment.supplierReferenceFrom,
+            };
         case 'PROPERTY_WRITE':
             if (!row.yfEffect.propertyWrite) {
                 throw new Error(`bridge invariant: PROPERTY_WRITE row ${row.id} missing propertyWrite`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d19n/youfibre-odin-sdk",
-  "version": "2.0.103-beta.16",
+  "version": "2.0.103-beta.17",
   "description": "",
   "author": "@d19n",
   "license": "UNLICENSED",