@d19n/youfibre-odin-sdk 2.0.192 → 2.0.194

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

@@ -30,7 +30,7 @@ export declare type VMO2OrderAction = 'add' | 'remove' | 'change';
 export declare type VMO2OrderStatus = 'accepted' | 'rejected' | 'validated' | 'committed' | 'completed' | 'cancelled' | 'delayed';
 export declare type VMO2RequestType = 'reactiveincident' | 'preserviceispassistance' | 'postserviceispassistance' | 'restrictedpremisesurvey' | 'cableinstallsurvey' | 'equipmentmove';
 export declare type VMO2RequestStatus = 'rejected' | 'delayed' | 'accepted' | 'inprogress' | 'resolved' | 'closed';
-export declare type VMO2VisitType = 'Pre-Work' | 'In-Home' | 'SingleVisitForPreWorkAndInHome' | 'Internal Incident' | 'External Incident' | 'Move Interior Equipment' | 'Move Exterior Equipment' | 'End Customer Support' | 'Pre-Service ISP Assistance' | 'Restricted Premise Survey' | 'Cable Install Survey' | 'Troubleshoot';
+export declare type VMO2VisitType = 'InHome' | 'PreWork' | 'SingleVisitForPreWorkAndInHome' | 'Internal Incident' | 'External Incident' | 'Move Interior Equipment' | 'Move Exterior Equipment' | 'End Customer Support' | 'Pre-Service ISP Assistance' | 'Restricted Premise Survey' | 'Cable Install Survey' | 'Troubleshoot';
 export declare type VMO2AppointmentStatus = 'reserved' | 'confirmed' | 'cancelled' | 'engineer assigned' | 'visit started' | 'visit complete';
 export declare type VMO2InstallFieldVisitRequired = 'no' | 'singleInHome' | 'splitPreWorkAndInHome' | 'singlePreWork' | 'singlePreWorkAndInHome';
 export declare type VMO2SelfInstallAvailable = 'no' | 'customerGatewayOnly';
@@ -112,19 +112,39 @@ export interface VMO2NetworkCapability {
     deployment: VMO2DeploymentDetail[];
     products: VMO2TechnicalProduct[];
 }
+/**
+ * Premise record. CORRECTED to the verified wire (2026-06-08, CP staging stub):
+ * address fields are FLAT (not nested under `address`), and networks are keyed
+ * `networkTypeList` (not `networks`). Previously authored from the docs alone.
+ */
 export interface VMO2PremiseRecord {
     premiseId: VMO2PremiseId;
     uprn?: UPRN;
-    address: VMO2AddressFields;
+    subBuildingName?: string;
+    buildingName?: string;
+    streetNumber?: string;
+    streetName?: string;
+    postCode: string;
+    locality?: string;
+    city?: string;
+    country: string;
     activeServiceAtPremise: boolean;
-    networks: VMO2NetworkCapability[];
+    networkTypeList: VMO2NetworkCapability[];
 }
+/**
+ * CORRECTED to the verified wire (2026-06-08): a match is returned as
+ * `premiseIdList[]` (an array even for one match), not a singular `premise`.
+ * OneAddressFound + NoAddressFound are live-verified; ManyAddressesFound's
+ * element shape is still unconfirmed (no multi-match sample yet).
+ */
 export declare type VMO2AddressLookupResult = {
     status: 'OneAddressFound';
-    premise: VMO2PremiseRecord;
+    premiseIdList: VMO2PremiseRecord[];
 } | {
     status: 'ManyAddressesFound';
-    premises: Array<Pick<VMO2PremiseRecord, 'premiseId' | 'uprn' | 'address'>>;
+    premiseIdList: Array<Partial<VMO2PremiseRecord> & {
+        premiseId: VMO2PremiseId;
+    }>;
 } | {
     status: 'TooManyAddressesFound';
 } | {
@@ -141,36 +161,55 @@ export interface VMO2AppointmentVisitFilter {
     additionalWorkCode?: VMO2AdditionalWorkCode[];
     specialRequest?: VMO2SpecialRequestCode[];
     startDate?: ISODate;
+    /** Request-side filter; response slots come back lowercase (`am`/`pm`). */
     preferredSlotType?: 'AM' | 'PM' | 'ALL DAY';
     preferredAppointmentClass?: 'Standard' | 'Premium';
 }
+/**
+ * CORRECTED to the verified wire (2026-06-08): identifiers (orderId / requestId
+ * / premiseId) are ROOT parameters, NOT nested under a `scope` object. The
+ * previous `scope` wrapper made the gateway treat premiseId as missing →
+ * "invalid combination".
+ */
 export interface VMO2ListAppointmentRequest {
-    scope: VMO2AppointmentScope;
+    orderId?: VMO2OrderId;
+    requestId?: VMO2RequestId;
+    premiseId?: VMO2PremiseId;
     networkType: VMO2NetworkType;
     journeyType: VMO2JourneyType;
     deploymentMethod?: VMO2DeploymentMethod;
     serviceLevel?: VMO2RequestServiceLevel;
     visit: VMO2AppointmentVisitFilter[];
 }
+/** Verified response slot — slot/class come back LOWERCASE (`am`/`pm`/`standard`). */
 export interface VMO2AvailableSlot {
     appointmentDate: ISODate;
-    appointmentSlot: 'AM' | 'PM' | 'ALL DAY' | string;
-    appointmentClass: 'Standard' | 'Premium' | string;
+    appointmentSlot: 'am' | 'pm' | string;
+    appointmentClass: 'standard' | string;
     earliestArrivalTime: string;
     latestArrivalTime: string;
 }
+/**
+ * CORRECTED to the verified wire (2026-06-08): carries a free-text `status`
+ * (e.g. "Fully Accepted"), and `estimatedDuration` / `inHomeLeadTime` are
+ * NUMBERS (minutes / days), not strings.
+ */
 export interface VMO2ListAppointmentResult {
+    status: string;
     installFieldVisitRequired?: VMO2InstallFieldVisitRequired;
     visit: Array<{
         visitType: VMO2VisitType;
-        estimatedDuration: string;
-        inHomeLeadTime?: string;
+        estimatedDuration: number;
+        inHomeLeadTime?: number;
         availableTimeSlots: VMO2AvailableSlot[];
         message?: WholesaleRejectionMessage[];
     }>;
 }
+/** CORRECTED: identifiers at ROOT (not under `scope`). */
 export interface VMO2ReserveAppointmentRequest {
-    scope: VMO2AppointmentScope;
+    orderId?: VMO2OrderId;
+    requestId?: VMO2RequestId;
+    premiseId?: VMO2PremiseId;
     networkType: VMO2NetworkType;
     journeyType: VMO2JourneyType;
     deploymentMethod?: VMO2DeploymentMethod;
@@ -184,16 +223,18 @@ export interface VMO2ReserveAppointmentRequest {
         appointmentClass: string;
     }>;
 }
+/** CORRECTED: `estimatedDuration` is a NUMBER; carries the issued appointmentKey. */
 export interface VMO2ReservedSlot {
     visitType: VMO2VisitType;
-    estimatedDuration: string;
+    estimatedDuration: number;
     appointmentKey: VMO2AppointmentKey;
     earliestArrivalTime: string;
     latestArrivalTime: string;
     message?: WholesaleRejectionMessage[];
 }
+/** CORRECTED: `status` is free-text (e.g. "fully accepted"). */
 export interface VMO2ReserveAppointmentResult {
-    status: 'accepted' | 'partially accepted';
+    status: string;
     appointmentSlots: VMO2ReservedSlot[];
 }
 export interface VMO2AppointmentDetails {

package/package.json

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