@d19n/youfibre-odin-sdk 2.0.157 → 2.0.158

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

@@ -89,6 +89,20 @@ export interface YfKciEffect {
         readonly timeBlockFrom: string;
         /** JSONPath for the supplier-side appointment reservation reference. */
         readonly supplierReferenceFrom: string;
+        /**
+         * When set, this dispatch is a *reschedule* (not a first-time booking):
+         * the dispatcher passes this value as the schedule-appointment
+         * `RescheduleReason`, which makes field-service update the existing
+         * ServiceAppointment in place AND record a `SA_RESCHEDULE` ChangeReason
+         * (Owner derived from the reason; supplier reasons → SUPPLIER).
+         *
+         * NOTE: `ChangeReasonRescheduleReason` does NOT map 1:1 to KCI types —
+         * the KCI only tells us *that* the supplier moved the slot, not the
+         * granular operational reason. We therefore stamp a single neutral
+         * supplier-owned value (`SCHEDULE_CHANGED`) for every supplier-driven
+         * KCI reschedule rather than inventing a per-KCI mapping.
+         */
+        readonly rescheduleReason?: string;
     };
     readonly notes: string;
 }
@@ -139,6 +153,13 @@ export declare type KciDispatchDecision = {
         entityKey: YfKciTargetEntity;
         properties: ReadonlyArray<string>;
     };
+    /**
+     * Present only for reschedule rows. The dispatcher forwards it as the
+     * schedule-appointment `RescheduleReason`, triggering in-place SA update
+     * + `SA_RESCHEDULE` ChangeReason creation. Absent for first-booking-style
+     * schedule-appointment effects.
+     */
+    rescheduleReason?: string;
 } | {
     kind: 'PROPERTY_WRITE';
     row: KciEffectRow;

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

@@ -189,9 +189,16 @@ exports.KCI_EFFECT_ROWS = [
         yfEffect: {
             kind: 'WO_SCHEDULE_APPOINTMENT',
             scheduleAppointment: {
-                dateFrom: 'provideServiceOrder.appointmentTimeslot.timeslotStartDateTime',
-                timeBlockFrom: 'provideServiceOrder.appointmentTimeslot.classification',
+                // NET now stamps the rebooked slot on the flat KCI envelope fields
+                // (appointmentDate / appointmentTimeBlock) rather than the nested
+                // provideServiceOrder.appointmentTimeslot. appointmentTimeBlock is
+                // already the AM/PM block — no WEEKDAY_ prefix to trim.
+                dateFrom: 'appointmentDate',
+                timeBlockFrom: 'appointmentTimeBlock',
                 supplierReferenceFrom: 'provideServiceOrder.appointmentReservationReference',
+                // REAPPOINTED is a supplier reschedule → update existing SA in place
+                // + record the SA_RESCHEDULE ChangeReason.
+                rescheduleReason: 'SCHEDULE_CHANGED',
             },
             // Co-effect: REAPPOINTED's dto also carries an updated
             // `provideServiceOrder.committedDate` for the rebooked appointment.
@@ -321,6 +328,30 @@ exports.KCI_EFFECT_ROWS = [
         },
         logAgainstOrder: true,
     },
+    {
+        // Supplier rescheduled the REMEDIATION visit. Move the REMEDIATION WO's
+        // appointment to the new slot and land it back in Scheduled, recording an
+        // SA_RESCHEDULE ChangeReason. Emitted on the parent INSTALL's PROVIDE
+        // order; tenantWorkOrderReference points at the REMEDIATION WO.
+        id: 'provide-update-remediation-rescheduled',
+        reasonCode: 'UPDATE',
+        serviceOrderKind: 'PROVIDE',
+        supplierCodes: ['NETOMNIA_REMEDIATION_WORK_ORDER_RESCHEDULED'],
+        yfEffect: {
+            kind: 'WO_SCHEDULE_APPOINTMENT',
+            scheduleAppointment: {
+                dateFrom: 'appointmentDate',
+                timeBlockFrom: 'appointmentTimeBlock',
+                supplierReferenceFrom: 'provideServiceOrder.appointmentReservationReference',
+                rescheduleReason: 'SCHEDULE_CHANGED',
+            },
+            notes: 'Supplier-confirmed REMEDIATION reschedule. Update the WO ' +
+                'ServiceAppointment Date/TimeBlock in place, land the WO in Scheduled, ' +
+                'and record the SA_RESCHEDULE ChangeReason. No Order stage / CommittedDate ' +
+                'effect (REMEDIATION is its own WO; parent INSTALL stage unchanged).',
+        },
+        logAgainstOrder: true,
+    },
     // ═══════════════════════════════════════════════════════════════════
     //  REPAIR — SERVICE WO state changes (post-install fault / service visit)
     //
@@ -365,6 +396,30 @@ exports.KCI_EFFECT_ROWS = [
         },
         logAgainstOrder: true,
     },
+    {
+        // Supplier rescheduled the SERVICE (repair) visit. Move the SERVICE WO's
+        // appointment to the new slot and land it back in Scheduled (from any
+        // non-terminal stage, incl. EnRoute/InProgress), recording an
+        // SA_RESCHEDULE ChangeReason. Detected REPAIR via the
+        // NETOMNIA_SERVICE_WORK_ORDER_ prefix in detectKciKind.
+        id: 'repair-update-service-rescheduled',
+        reasonCode: 'UPDATE',
+        serviceOrderKind: 'REPAIR',
+        supplierCodes: ['NETOMNIA_SERVICE_WORK_ORDER_RESCHEDULED'],
+        yfEffect: {
+            kind: 'WO_SCHEDULE_APPOINTMENT',
+            scheduleAppointment: {
+                dateFrom: 'appointmentDate',
+                timeBlockFrom: 'appointmentTimeBlock',
+                supplierReferenceFrom: 'provideServiceOrder.appointmentReservationReference',
+                rescheduleReason: 'SCHEDULE_CHANGED',
+            },
+            notes: 'Supplier-confirmed SERVICE reschedule. Update the WO ServiceAppointment ' +
+                'Date/TimeBlock in place, land the WO in Scheduled, and record the ' +
+                'SA_RESCHEDULE ChangeReason. No Order stage effect (changesOrderStage:false).',
+        },
+        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
@@ -543,13 +598,15 @@ function decideKciDispatch(dto) {
             if (!row.yfEffect.scheduleAppointment) {
                 throw new Error(`bridge invariant: WO_SCHEDULE_APPOINTMENT row ${row.id} missing scheduleAppointment`);
             }
-            return Object.assign({ kind: 'WO_SCHEDULE_APPOINTMENT', row, dateFrom: row.yfEffect.scheduleAppointment.dateFrom, timeBlockFrom: row.yfEffect.scheduleAppointment.timeBlockFrom, supplierReferenceFrom: row.yfEffect.scheduleAppointment.supplierReferenceFrom }, (row.yfEffect.propertyWrite
+            return Object.assign(Object.assign({ kind: 'WO_SCHEDULE_APPOINTMENT', row, dateFrom: row.yfEffect.scheduleAppointment.dateFrom, timeBlockFrom: row.yfEffect.scheduleAppointment.timeBlockFrom, supplierReferenceFrom: row.yfEffect.scheduleAppointment.supplierReferenceFrom }, (row.yfEffect.propertyWrite
                 ? {
                     propertyWrite: {
                         entityKey: row.yfEffect.propertyWrite.entityKey,
                         properties: row.yfEffect.propertyWrite.properties,
                     },
                 }
+                : {})), (row.yfEffect.scheduleAppointment.rescheduleReason
+                ? { rescheduleReason: row.yfEffect.scheduleAppointment.rescheduleReason }
                 : {}));
         case 'PROPERTY_WRITE':
             if (!row.yfEffect.propertyWrite) {

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

@@ -140,10 +140,39 @@ function run() {
         const decision = (0, kci_effect_bridge_1.decideKciDispatch)(makeProvideDto('RESUMED'));
         assert('kind=LOG_KCI_ONLY', decision.kind === 'LOG_KCI_ONLY');
     }
-    console.log('Test: REAPPOINTED → WO_SCHEDULE_APPOINTMENT (bundled stage move + appointment write)');
+    console.log('Test: REAPPOINTED → WO_SCHEDULE_APPOINTMENT (reschedule: flat fields + rescheduleReason)');
     {
         const decision = (0, kci_effect_bridge_1.decideKciDispatch)(makeProvideDto('REAPPOINTED'));
         assert('kind=WO_SCHEDULE_APPOINTMENT', decision.kind === 'WO_SCHEDULE_APPOINTMENT');
+        if (decision.kind === 'WO_SCHEDULE_APPOINTMENT') {
+            assert('dateFrom=appointmentDate', decision.dateFrom === 'appointmentDate');
+            assert('timeBlockFrom=appointmentTimeBlock', decision.timeBlockFrom === 'appointmentTimeBlock');
+            assert('rescheduleReason=SCHEDULE_CHANGED', decision.rescheduleReason === 'SCHEDULE_CHANGED');
+        }
+    }
+    console.log('Test: SERVICE WORK_ORDER_RESCHEDULED → WO_SCHEDULE_APPOINTMENT (REPAIR reschedule)');
+    {
+        const dto = makeProvideDto('UPDATE');
+        dto.supplierCodes = ['NETOMNIA_SERVICE_WORK_ORDER_RESCHEDULED'];
+        const decision = (0, kci_effect_bridge_1.decideKciDispatch)(dto);
+        assert('detectKciKind=REPAIR', (0, kci_effect_bridge_1.detectKciKind)(dto) === 'REPAIR');
+        assert('kind=WO_SCHEDULE_APPOINTMENT', decision.kind === 'WO_SCHEDULE_APPOINTMENT');
+        if (decision.kind === 'WO_SCHEDULE_APPOINTMENT') {
+            assert('row=repair-update-service-rescheduled', decision.row.id === 'repair-update-service-rescheduled');
+            assert('rescheduleReason=SCHEDULE_CHANGED', decision.rescheduleReason === 'SCHEDULE_CHANGED');
+        }
+    }
+    console.log('Test: REMEDIATION WORK_ORDER_RESCHEDULED → WO_SCHEDULE_APPOINTMENT (PROVIDE reschedule)');
+    {
+        const dto = makeProvideDto('UPDATE');
+        dto.supplierCodes = ['NETOMNIA_REMEDIATION_WORK_ORDER_RESCHEDULED'];
+        const decision = (0, kci_effect_bridge_1.decideKciDispatch)(dto);
+        assert('detectKciKind=PROVIDE', (0, kci_effect_bridge_1.detectKciKind)(dto) === 'PROVIDE');
+        assert('kind=WO_SCHEDULE_APPOINTMENT', decision.kind === 'WO_SCHEDULE_APPOINTMENT');
+        if (decision.kind === 'WO_SCHEDULE_APPOINTMENT') {
+            assert('row=provide-update-remediation-rescheduled', decision.row.id === 'provide-update-remediation-rescheduled');
+            assert('rescheduleReason=SCHEDULE_CHANGED', decision.rescheduleReason === 'SCHEDULE_CHANGED');
+        }
     }
     console.log('Test: WARNING → LOG_KCI_ONLY');
     {

package/dist/wholesale-provider/types/fibrecafe.d.ts

@@ -496,6 +496,15 @@ export interface FibreCafeKciDto {
      * supplierCode discriminator needed).
      */
     tenantWorkOrderReference?: string | null;
+    /**
+     * Rebooked appointment slot — set on REAPPOINTED and the SERVICE /
+     * REMEDIATION *_RESCHEDULED UPDATE KCIs. NET stamps these flat envelope
+     * fields directly (in preference to the nested
+     * provideServiceOrder.appointmentTimeslot). `appointmentDate` is the ISO
+     * appointment date; `appointmentTimeBlock` is the AM/PM block.
+     */
+    appointmentDate?: string;
+    appointmentTimeBlock?: 'AM' | 'PM';
     /** Full Odin WorkOrder record — sent for WO stage/appointment updates. */
     workOrder?: OdinRecord<WorkOrderProperties>;
     /** Partial Odin ServiceAppointment record — sent for WO stage/appointment updates. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d19n/youfibre-odin-sdk",
-  "version": "2.0.157",
+  "version": "2.0.158",
   "description": "",
   "author": "@d19n",
   "license": "UNLICENSED",