@d19n/youfibre-odin-sdk 2.0.103-beta.10 → 2.0.103-beta.12

package/dist/wholesale-provider/interface.d.ts

@@ -99,11 +99,9 @@ export interface SyncWorkOrderToSupplierArgs<TPrincipal = unknown> {
     };
     yfServiceAppointment: {
         id?: string;
-        properties: {
-            Date?: string;
-            TimeBlock?: string;
-            [extra: string]: unknown;
-        };
+        entity: string;
+        type: unknown;
+        properties: unknown;
     };
 }
 export interface UpdateOrderExternalRefArgs {
@@ -131,6 +129,11 @@ export interface UpdateOrderExternalRefArgs {
  * }
  * ```
  *
+ * `FibreCafeKciDto` is fixed as the inbound KCI envelope — that's the
+ * canonical wire shape Netomnia sends (per the FibreCafe Tenant Updates
+ * spec). Modules consuming the SDK should consolidate any local KCI type
+ * to alias `FibreCafeKciDto` rather than maintain a duplicate.
+ *
  * Default `TPrincipal = unknown` lets the SDK compile standalone without
  * tenant-specific type imports.
  */

package/dist/wholesale-provider/providers/netomnia-provider.d.ts

@@ -50,7 +50,7 @@ import type { OrderRecord } from '../../records-v2/OrderRecord';
  *   }
  * ```
  */
-export interface NetomniaProviderDeps<TPrincipal = unknown> {
+export interface NetomniaProviderDeps<TPrincipal = unknown, TKci = FibreCafeKciDto> {
     searchAddress: (uprn: number) => Promise<FibreCafeServiceAvailability200>;
     listAppointments: (args: ListAppointmentsArgs) => Promise<FibreCafeAvailableAppointments200>;
     reserveAppointment: (args: ReserveAppointmentArgs) => Promise<FibreCafeReserveAppointment201>;

package/dist/wholesale-provider/test/netomnia-provider.spec.js

@@ -296,7 +296,7 @@ function run() {
                 yfOrderId: 'ORD-1',
                 yfWorkOrderId: 'WO-1',
                 yfChangeReason: { externalId: 'CR-1', entity: 'ChangeReason', type: 'CANCEL', properties: {} },
-                yfServiceAppointment: { properties: {} },
+                yfServiceAppointment: { entity: 'ServiceAppointment', type: 'INSTALL', properties: {} },
             };
             yield p.syncWorkOrderToSupplier(args);
             assert('called once', log.length === 1);

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

@@ -448,7 +448,14 @@ export interface FibreCafeUnsolicitedCeaseServiceOrder {
  * KCI envelope. Inbound from the Tenant Updates API. The presence of one of
  * `provideServiceOrder | ceaseServiceOrder | modifyServiceOrder | unsolicitedCeaseServiceOrder`
  * + the `reasonCode` together discriminate the event.
+ *
+ * `workOrder` / `serviceAppointment` / `changeReason` carry typed Odin
+ * record / partial-record shapes — consumers that handle the KCI need them
+ * to update YF WorkOrder stages and log OrderKci on the YF side.
  */
+import type { OdinRecord } from '@d19n/odin-types/dist/core';
+import type { WorkOrderProperties } from '../../entities-v2/WorkOrder';
+import type { ChangeReasonProperties } from '../../entities-v2/ChangeReason';
 export interface FibreCafeKciDto {
     /** Unique identifier for this update (UUID). */
     id: string;
@@ -464,8 +471,8 @@ export interface FibreCafeKciDto {
     ceaseServiceOrder?: FibreCafeCeaseServiceOrder;
     modifyServiceOrder?: FibreCafeModifyServiceOrder;
     unsolicitedCeaseServiceOrder?: FibreCafeUnsolicitedCeaseServiceOrder;
-    /** Full Odin WorkOrder record — sent for WO stage/appointment updates. Opaque to SDK. */
-    workOrder?: unknown;
+    /** Full Odin WorkOrder record — sent for WO stage/appointment updates. */
+    workOrder?: OdinRecord<WorkOrderProperties>;
     /** Partial Odin ServiceAppointment record — sent for WO stage/appointment updates. */
     serviceAppointment?: {
         id: string;
@@ -474,8 +481,8 @@ export interface FibreCafeKciDto {
             TimeBlock: string;
         };
     };
-    /** Full Odin ChangeReason record — sent when a change reason is associated. Opaque to SDK. */
-    changeReason?: unknown;
+    /** Full Odin ChangeReason record — sent when a change reason is associated. */
+    changeReason?: OdinRecord<ChangeReasonProperties>;
 }
 export interface FibreCafeServiceProblemCreateDto {
     /** Caller-generated id. */

package/package.json

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