@d19n/youfibre-odin-sdk 2.0.103-beta.4 → 2.0.103-beta.6

package/README.md

@@ -1116,7 +1116,7 @@ This SDK includes **630** actions.
 | `UpdateAgentCallLegOnIncomingCallAnswered` | UPDATE | k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallAnswered |
 | `UpdateAgentCallLegOnIncomingCallCanceled` | UPDATE | k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallCanceled |
 | `UpdateAgentCallLegOnIncomingCallCompleted` | UPDATE | k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallCompleted |
-| `UpdateAgentCallLegOnIncomingCallRinding` | UPDATE | k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinding |
+| `UpdateAgentCallLegOnIncomingCallRinging` | UPDATE | k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinging |
 | `UpdateCall` | UPDATE | k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateCall |
 | `UpdateCustomerCallLegOnIncomingCallAnswered` | UPDATE | k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateCustomerCallLegOnIncomingCallAnswered |
 

package/dist/actions-v2/{UpdateAgentCallLegOnIncomingCallRindingDto.d.ts → UpdateAgentCallLegOnIncomingCallRingingDto.d.ts}

@@ -1,30 +1,30 @@
 /**
- * UpdateAgentCallLegOnIncomingCallRinding Action DTO
+ * UpdateAgentCallLegOnIncomingCallRinging Action DTO
  *
- * Update agent call leg on incoming call rinding
+ * Update agent call leg on incoming call ringing
  *
  * @module NotificationModule
  * @entity CallLeg
- * @actionKey UpdateAgentCallLegOnIncomingCallRinding
- * @event k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinding
+ * @actionKey UpdateAgentCallLegOnIncomingCallRinging
+ * @event k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinging
  *
  * AUTO-GENERATED - DO NOT EDIT DIRECTLY
  */
 import { OdinRecord, OdinRecordUpdateDto, OdinRecordUpdatedEvent } from '@d19n/odin-types/dist/core';
 /**
- * RabbitMQ message payload for UpdateAgentCallLegOnIncomingCallRinding updated events
+ * RabbitMQ message payload for UpdateAgentCallLegOnIncomingCallRinging updated events
  *
- * @event k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinding
+ * @event k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinging
  */
-export interface UpdateAgentCallLegOnIncomingCallRindingMessage extends OdinRecordUpdatedEvent<UpdateAgentCallLegOnIncomingCallRindingDto, UpdateAgentCallLegOnIncomingCallRindingProperties> {
+export interface UpdateAgentCallLegOnIncomingCallRingingMessage extends OdinRecordUpdatedEvent<UpdateAgentCallLegOnIncomingCallRingingDto, UpdateAgentCallLegOnIncomingCallRingingProperties> {
 }
 /**
- * Properties for UpdateAgentCallLegOnIncomingCallRinding action
+ * Properties for UpdateAgentCallLegOnIncomingCallRinging action
  *
  * @property Required fields: 2
  * @property Optional fields: 0
  */
-export interface UpdateAgentCallLegOnIncomingCallRindingProperties {
+export interface UpdateAgentCallLegOnIncomingCallRingingProperties {
     /**
      * RingingAt
      *
@@ -43,29 +43,29 @@ export interface UpdateAgentCallLegOnIncomingCallRindingProperties {
     Status: string;
 }
 /**
- * UpdateAgentCallLegOnIncomingCallRinding
+ * UpdateAgentCallLegOnIncomingCallRinging
  *
- * Update agent call leg on incoming call rinding
+ * Update agent call leg on incoming call ringing
  *
  * @actionType UPDATE - Updates an existing CallLeg record
  * @module NotificationModule
  * @entity CallLeg
- * @event k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinding
- * @permission schema.action.updateagentcalllegonincomingcallrinding.trigger
+ * @event k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinging
+ * @permission schema.action.updateagentcalllegonincomingcallringing.trigger
  * @benchmark This action is tracked for performance benchmarks
  */
-export declare class UpdateAgentCallLegOnIncomingCallRindingDto extends OdinRecordUpdateDto<UpdateAgentCallLegOnIncomingCallRindingProperties> {
+export declare class UpdateAgentCallLegOnIncomingCallRingingDto extends OdinRecordUpdateDto<UpdateAgentCallLegOnIncomingCallRingingProperties> {
     /** Used by SDK generators to identify action type */
     static readonly ACTION_TYPE = "UPDATE";
-    static readonly ACTION_KEY = "UpdateAgentCallLegOnIncomingCallRinding";
+    static readonly ACTION_KEY = "UpdateAgentCallLegOnIncomingCallRinging";
     static readonly MODULE_NAME = "NotificationModule";
     static readonly ENTITIES: string[];
-    static readonly EVENT_NAME = "k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinding";
-    static readonly PERMISSION = "schema.action.updateagentcalllegonincomingcallrinding.trigger";
+    static readonly EVENT_NAME = "k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinging";
+    static readonly PERMISSION = "schema.action.updateagentcalllegonincomingcallringing.trigger";
     /** Step metadata - entity this action targets */
     static readonly STEP_ENTITY = "NotificationModule:CallLeg";
     static readonly STEP_SCHEMA_ID = "75c59745-35fb-44b9-b3f2-7563101fdcec";
-    static readonly STEP_SCHEMA_ACTION_ID = "a3d8be43-ce38-4841-a836-7f38ceba4761";
+    static readonly STEP_SCHEMA_ACTION_ID = "a16ff881-91e5-449d-b5e2-c9556dd2e850";
     static readonly AUTO_LINK_PARENT = false;
     readonly actionName: string;
     readonly schemaActionId: string;
@@ -74,7 +74,7 @@ export declare class UpdateAgentCallLegOnIncomingCallRindingDto extends OdinReco
         id: string;
         entity: string;
         type?: string;
-    }, properties: UpdateAgentCallLegOnIncomingCallRindingProperties, options?: {
+    }, properties: UpdateAgentCallLegOnIncomingCallRingingProperties, options?: {
         journeyId?: string;
         stageKey?: string;
     });

package/dist/actions-v2/UpdateAgentCallLegOnIncomingCallRingingDto.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * UpdateAgentCallLegOnIncomingCallRinging Action DTO
+ *
+ * Update agent call leg on incoming call ringing
+ *
+ * @module NotificationModule
+ * @entity CallLeg
+ * @actionKey UpdateAgentCallLegOnIncomingCallRinging
+ * @event k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinging
+ *
+ * AUTO-GENERATED - DO NOT EDIT DIRECTLY
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateAgentCallLegOnIncomingCallRingingDto = void 0;
+const core_1 = require("@d19n/odin-types/dist/core");
+/**
+ * UpdateAgentCallLegOnIncomingCallRinging
+ *
+ * Update agent call leg on incoming call ringing
+ *
+ * @actionType UPDATE - Updates an existing CallLeg record
+ * @module NotificationModule
+ * @entity CallLeg
+ * @event k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinging
+ * @permission schema.action.updateagentcalllegonincomingcallringing.trigger
+ * @benchmark This action is tracked for performance benchmarks
+ */
+class UpdateAgentCallLegOnIncomingCallRingingDto extends core_1.OdinRecordUpdateDto {
+    constructor(record, properties, options) {
+        super({
+            id: record.id,
+            entity: record.entity,
+            type: record.type,
+            properties,
+            journeyId: options === null || options === void 0 ? void 0 : options.journeyId,
+            stageKey: options === null || options === void 0 ? void 0 : options.stageKey,
+        });
+        this.actionName = 'UpdateAgentCallLegOnIncomingCallRinging';
+        this.schemaActionId = 'a16ff881-91e5-449d-b5e2-c9556dd2e850';
+        this.entity = 'NotificationModule:CallLeg';
+    }
+}
+exports.UpdateAgentCallLegOnIncomingCallRingingDto = UpdateAgentCallLegOnIncomingCallRingingDto;
+/** Used by SDK generators to identify action type */
+UpdateAgentCallLegOnIncomingCallRingingDto.ACTION_TYPE = 'UPDATE';
+UpdateAgentCallLegOnIncomingCallRingingDto.ACTION_KEY = 'UpdateAgentCallLegOnIncomingCallRinging';
+UpdateAgentCallLegOnIncomingCallRingingDto.MODULE_NAME = 'NotificationModule';
+UpdateAgentCallLegOnIncomingCallRingingDto.ENTITIES = ['CallLeg'];
+UpdateAgentCallLegOnIncomingCallRingingDto.EVENT_NAME = 'k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinging';
+UpdateAgentCallLegOnIncomingCallRingingDto.PERMISSION = 'schema.action.updateagentcalllegonincomingcallringing.trigger';
+/** Step metadata - entity this action targets */
+UpdateAgentCallLegOnIncomingCallRingingDto.STEP_ENTITY = 'NotificationModule:CallLeg';
+UpdateAgentCallLegOnIncomingCallRingingDto.STEP_SCHEMA_ID = '75c59745-35fb-44b9-b3f2-7563101fdcec';
+UpdateAgentCallLegOnIncomingCallRingingDto.STEP_SCHEMA_ACTION_ID = 'a16ff881-91e5-449d-b5e2-c9556dd2e850';
+UpdateAgentCallLegOnIncomingCallRingingDto.AUTO_LINK_PARENT = false;

package/dist/records-v2/CallLegRecord.d.ts

@@ -28,7 +28,7 @@ import { CreateCustomerCallLegProperties } from '../actions-v2/CreateCustomerCal
 import { UpdateAgentCallLegOnIncomingCallAnsweredProperties } from '../actions-v2/UpdateAgentCallLegOnIncomingCallAnsweredDto';
 import { UpdateAgentCallLegOnIncomingCallCanceledProperties } from '../actions-v2/UpdateAgentCallLegOnIncomingCallCanceledDto';
 import { UpdateAgentCallLegOnIncomingCallCompletedProperties } from '../actions-v2/UpdateAgentCallLegOnIncomingCallCompletedDto';
-import { UpdateAgentCallLegOnIncomingCallRindingProperties } from '../actions-v2/UpdateAgentCallLegOnIncomingCallRindingDto';
+import { UpdateAgentCallLegOnIncomingCallRingingProperties } from '../actions-v2/UpdateAgentCallLegOnIncomingCallRingingDto';
 import { UpdateCallProperties } from '../actions-v2/UpdateCallDto';
 import { UpdateCustomerCallLegOnIncomingCallAnsweredProperties } from '../actions-v2/UpdateCustomerCallLegOnIncomingCallAnsweredDto';
 import { CallRecord } from './CallRecord';
@@ -353,7 +353,7 @@ export declare class CallLegRecord<TProps = CallLegProperties> {
         stageKey?: string;
     }): ActionBuilder;
     /**
-     * UpdateAgentCallLegOnIncomingCallRinding
+     * UpdateAgentCallLegOnIncomingCallRinging
      *
      * Updates this CallLeg record with the specified properties.
      * Returns an ActionBuilder - call .execute() to update or .dryRun() for debugging.
@@ -368,13 +368,13 @@ export declare class CallLegRecord<TProps = CallLegProperties> {
      * @example
      * ```typescript
      * const record = await odinClient.callLegs.get(id);
-     * await record.updateAgentCallLegOnIncomingCallRinding({ ... }).execute();
+     * await record.updateAgentCallLegOnIncomingCallRinging({ ... }).execute();
      *
      * // Dry run (for debugging)
-     * const payload = record.updateAgentCallLegOnIncomingCallRinding({ ... }).dryRun();
+     * const payload = record.updateAgentCallLegOnIncomingCallRinging({ ... }).dryRun();
      * ```
      */
-    updateAgentCallLegOnIncomingCallRinding(properties: UpdateAgentCallLegOnIncomingCallRindingProperties, options?: {
+    updateAgentCallLegOnIncomingCallRinging(properties: UpdateAgentCallLegOnIncomingCallRingingProperties, options?: {
         journeyId?: string;
         stageKey?: string;
     }): ActionBuilder;

package/dist/records-v2/CallLegRecord.js

@@ -455,7 +455,7 @@ class CallLegRecord {
         return new ActionBuilder(this._provider, 'NotificationModule', 'CallLeg', payload, () => { this._pendingLinks = []; });
     }
     /**
-     * UpdateAgentCallLegOnIncomingCallRinding
+     * UpdateAgentCallLegOnIncomingCallRinging
      *
      * Updates this CallLeg record with the specified properties.
      * Returns an ActionBuilder - call .execute() to update or .dryRun() for debugging.
@@ -470,17 +470,17 @@ class CallLegRecord {
      * @example
      * ```typescript
      * const record = await odinClient.callLegs.get(id);
-     * await record.updateAgentCallLegOnIncomingCallRinding({ ... }).execute();
+     * await record.updateAgentCallLegOnIncomingCallRinging({ ... }).execute();
      *
      * // Dry run (for debugging)
-     * const payload = record.updateAgentCallLegOnIncomingCallRinding({ ... }).dryRun();
+     * const payload = record.updateAgentCallLegOnIncomingCallRinging({ ... }).dryRun();
      * ```
      */
-    updateAgentCallLegOnIncomingCallRinding(properties, options) {
+    updateAgentCallLegOnIncomingCallRinging(properties, options) {
         var _a;
         if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
-            throw new Error('updateAgentCallLegOnIncomingCallRinding requires an existing record. Use accessor.get() first.');
-        const payload = Object.assign({ id: this._record.id, entity: this._record.entity, type: this._record.type, actionName: 'UpdateAgentCallLegOnIncomingCallRinding', properties, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined }, options);
+            throw new Error('updateAgentCallLegOnIncomingCallRinging requires an existing record. Use accessor.get() first.');
+        const payload = Object.assign({ id: this._record.id, entity: this._record.entity, type: this._record.type, actionName: 'UpdateAgentCallLegOnIncomingCallRinging', properties, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined }, options);
         return new ActionBuilder(this._provider, 'NotificationModule', 'CallLeg', payload, () => { this._pendingLinks = []; });
     }
     /**

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

@@ -0,0 +1,26 @@
+/**
+ * Wholesale provider — subpath barrel.
+ *
+ * Consumers import from `@d19n/youfibre-odin-sdk/wholesale-provider`:
+ *
+ *   ```ts
+ *   import {
+ *     WholesaleProvider,
+ *     NetomniaProvider,
+ *     NetomniaProviderDeps,
+ *   } from '@d19n/youfibre-odin-sdk/wholesale-provider';
+ *   ```
+ *
+ * This subpath exists so the wholesale provider abstraction does not collide
+ * with the auto-generated SDK surface (entities-v2 / accessors-v2 / etc.)
+ * that gets regenerated by `make regen`. Per `runner.ts:163-181`, the regen
+ * does NOT touch this directory.
+ *
+ * Linked: T-20260508-009
+ */
+export type { WholesaleProvider } from './interface';
+export type { WholesaleResult, WholesaleSyncResponse, WholesaleRejectionResponse, WholesaleRejectionMessage, WholesaleBUS, WholesaleSYS, ISO8601DateTime, ISODate, TransactionId, UPRN, UUID, SwitchOrderReference, } from './types/wholesale';
+export type { VMO2OrderId, VMO2RequestId, VMO2AppointmentKey, VMO2PremiseId, VMO2ParentServiceId, VMO2ChildServiceId, VMO2TechnicalProductId, VMO2InvoiceAccountNumber, VMO2NetworkType, VMO2DeploymentMethod, VMO2OrderIntent, VMO2OrderAction, VMO2OrderStatus, VMO2RequestType, VMO2RequestStatus, VMO2VisitType, VMO2AppointmentStatus, VMO2InstallFieldVisitRequired, VMO2SelfInstallAvailable, VMO2OrderServiceLevel, VMO2RequestServiceLevel, VMO2AdditionalWorkCode, VMO2SpecialRequestCode, VMO2CancellationReasonCode, VMO2IncidentReasonCode, VMO2ClosureCode, VMO2DelayCode, VMO2AddressFields, VMO2EndCustomerDetails, VMO2AddressLookupQuery, VMO2AddressLookupRequest, VMO2AddressLookupResult, VMO2DeploymentDetail, VMO2TechnicalProduct, VMO2NetworkCapability, VMO2PremiseRecord, VMO2JourneyType, VMO2AppointmentScope, VMO2AppointmentVisitFilter, VMO2ListAppointmentRequest, VMO2AvailableSlot, VMO2ListAppointmentResult, VMO2ReserveAppointmentRequest, VMO2ReservedSlot, VMO2ReserveAppointmentResult, VMO2AppointmentDetails, VMO2AmendAppointmentPatch, VMO2ConfirmAppointmentRequest, VMO2CreateOrderRequest, VMO2CreateOrderResult, VMO2AmendOrderPatch, VMO2OrderDetails, VMO2CreateIncidentRequest, VMO2CreateIncidentResult, VMO2AmendIncidentPatch, VMO2IncidentDetails, VMO2OrderNotificationType, VMO2SMRNotificationType, VMO2NotificationEnvelope, VMO2OrderNotification, VMO2SMRNotification, VMO2InboundNotification, } from './types/vmo2';
+export type { FibreCafeAddressType, FibreCafeAppointmentPurpose, FibreCafeAvailabilityConstraintCode, FibreCafeInstallationType, FibreCafePortStatus, FibreCafeUnavailabilityReasonCode, FibreCafeTimeslotClassification, FibreCafeServiceCharacteristic, FibreCafeServiceProblemCharacteristic, FibreCafeEngineerTask, FibreCafeProvideOrderType, FibreCafeCeaseOrderType, FibreCafeModifyOrderType, FibreCafeUnsolicitedCeaseOrderType, FibreCafeOrderStatus, FibreCafeUnsolicitedCeaseOrderStatus, FibreCafeUnsolicitedCeaseReason, FibreCafeKciReasonCode, FibreCafeKciProblemCode, FibreCafeResolutionCode, FibreCafeGatewayErrorCode, FibreCafeAddressIdentifier, FibreCafeAddressIdentifierWithAdditional, FibreCafeSubAddress, FibreCafeAddress, FibreCafeAddressAttribute, FibreCafeAddressTenant, FibreCafeContact, FibreCafeTimeslot, FibreCafeReserveTimeslot, FibreCafeServiceCharacteristicObject, FibreCafeServiceProblemCharacteristicObject, FibreCafeServiceCharacteristicAvailability, FibreCafeServiceSpecification, FibreCafeServiceSpecificationAvailability, FibreCafeServiceOrderItem, FibreCafeSupplierNote, FibreCafeResolutionDetails, FibreCafeGatewayError, FibreCafeAvailabilityConstraint, FibreCafeUnavailabilityReason, FibreCafeLineCharacteristic, FibreCafeOntPort, FibreCafeOnt, FibreCafeExistingLine, FibreCafeSiteInformation, FibreCafeServiceAvailabilityQuery, FibreCafeServiceAvailability200, FibreCafeAddressLookupQuery, FibreCafeAddressLookup200, FibreCafeAvailableAppointmentsQuery, FibreCafeAvailableAppointments200, FibreCafeReserveAppointmentDto, FibreCafeReserveAppointment201, FibreCafeServiceWorkOrderAddress, FibreCafeServiceWorkOrderTimeslot, FibreCafeScheduleServiceWorkOrderDto, FibreCafeRescheduleServiceWorkOrderDto, FibreCafeScheduleServiceWorkOrder201, FibreCafeRescheduleServiceWorkOrder200, FibreCafeProvideServiceOrderDto, FibreCafeCeaseServiceOrderDto, FibreCafeModifyServiceOrderDto, FibreCafeOrderCreateDto, FibreCafeOrderCreate202, FibreCafeServiceOrderCancellationDto, FibreCafeProvideServiceOrderAmendmentDto, FibreCafeOrderAmendAccept202, FibreCafeProvideServiceOrder, FibreCafeCeaseServiceOrder, FibreCafeModifyServiceOrder, FibreCafeUnsolicitedCeaseServiceOrder, FibreCafeKciDto, FibreCafeServiceProblemCreateDto, FibreCafeServiceProblemCreate202, FibreCafeServiceProblemAmendmentDto, FibreCafeServiceProblemCancellationDto, FibreCafeServiceProblemDetails, } from './types/fibrecafe';
+export { NetomniaProvider, AggregateNotificationError, NotImplementedError, } from './providers/netomnia-provider';
+export type { NetomniaProviderDeps } from './providers/netomnia-provider';

package/dist/wholesale-provider/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Wholesale provider — subpath barrel.
+ *
+ * Consumers import from `@d19n/youfibre-odin-sdk/wholesale-provider`:
+ *
+ *   ```ts
+ *   import {
+ *     WholesaleProvider,
+ *     NetomniaProvider,
+ *     NetomniaProviderDeps,
+ *   } from '@d19n/youfibre-odin-sdk/wholesale-provider';
+ *   ```
+ *
+ * This subpath exists so the wholesale provider abstraction does not collide
+ * with the auto-generated SDK surface (entities-v2 / accessors-v2 / etc.)
+ * that gets regenerated by `make regen`. Per `runner.ts:163-181`, the regen
+ * does NOT touch this directory.
+ *
+ * Linked: T-20260508-009
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotImplementedError = exports.AggregateNotificationError = exports.NetomniaProvider = void 0;
+// Provider implementations
+var netomnia_provider_1 = require("./providers/netomnia-provider");
+Object.defineProperty(exports, "NetomniaProvider", { enumerable: true, get: function () { return netomnia_provider_1.NetomniaProvider; } });
+Object.defineProperty(exports, "AggregateNotificationError", { enumerable: true, get: function () { return netomnia_provider_1.AggregateNotificationError; } });
+Object.defineProperty(exports, "NotImplementedError", { enumerable: true, get: function () { return netomnia_provider_1.NotImplementedError; } });

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

@@ -0,0 +1,65 @@
+/**
+ * WholesaleProvider — the typed contract YouFibre code uses to consume any
+ * wholesale gateway (FibreCafe-fronted suppliers like Netomnia / Brsk /
+ * Trooli today, VMO2 / Nutmeg from July 2026, others in future).
+ *
+ * Capability-shaped, not surface-shaped — callers ask "reserve an
+ * appointment", not "POST /ge/v1/appointments/reservations". Implementations
+ * map capability calls onto the per-supplier wire format.
+ *
+ * Lifted under T-20260508-009 from
+ *   agent-os/knowledge/integrations/vmo2-nutmeg/vm-provider-interface.ts
+ *
+ * Every method returns a `WholesaleResult<T>` discriminated by `status`.
+ * Errors (4xx/5xx) materialise as `WholesaleRejectionResponse`. Transport /
+ * OAuth / idempotency / retry / rate-limiting are encapsulated by the
+ * implementation.
+ *
+ * Method names are supplier-agnostic. Argument/result types are currently
+ * VMO2-shaped (since VMO2 is the first concrete shape modelled). Per-supplier
+ * implementations adapt their wire format to/from these shapes — see
+ * `comparison-fibrecafe-vs-vmo2.md` for the field-level mapping.
+ */
+import type { WholesaleResult } from './types/wholesale';
+import type { VMO2AddressLookupRequest, VMO2AddressLookupResult, VMO2ListAppointmentRequest, VMO2ListAppointmentResult, VMO2ReserveAppointmentRequest, VMO2ReserveAppointmentResult, VMO2ConfirmAppointmentRequest, VMO2AppointmentDetails, VMO2AppointmentKey, VMO2AmendAppointmentPatch, VMO2CreateOrderRequest, VMO2CreateOrderResult, VMO2AmendOrderPatch, VMO2OrderDetails, VMO2OrderId, VMO2CancellationReasonCode, VMO2PremiseId, VMO2CreateIncidentRequest, VMO2CreateIncidentResult, VMO2AmendIncidentPatch, VMO2IncidentDetails, VMO2RequestId, VMO2OrderNotification, VMO2SMRNotification } from './types/vmo2';
+import type { ISODate, SwitchOrderReference } from './types/wholesale';
+export interface WholesaleProvider {
+    searchAddress(req: VMO2AddressLookupRequest): Promise<WholesaleResult<VMO2AddressLookupResult>>;
+    listAppointments(req: VMO2ListAppointmentRequest): Promise<WholesaleResult<VMO2ListAppointmentResult>>;
+    reserveAppointment(req: VMO2ReserveAppointmentRequest): Promise<WholesaleResult<VMO2ReserveAppointmentResult>>;
+    confirmAppointment(req: VMO2ConfirmAppointmentRequest): Promise<WholesaleResult<{
+        appointmentKey: VMO2AppointmentKey;
+    }>>;
+    getAppointment(key: VMO2AppointmentKey): Promise<WholesaleResult<VMO2AppointmentDetails>>;
+    amendAppointment(key: VMO2AppointmentKey, patch: VMO2AmendAppointmentPatch): Promise<WholesaleResult<{
+        appointmentKey: VMO2AppointmentKey;
+    }>>;
+    cancelAppointment(key: VMO2AppointmentKey): Promise<WholesaleResult<{
+        appointmentKey: VMO2AppointmentKey;
+    }>>;
+    createOrder(req: VMO2CreateOrderRequest): Promise<WholesaleResult<VMO2CreateOrderResult>>;
+    amendOrder(orderId: VMO2OrderId, patch: VMO2AmendOrderPatch): Promise<WholesaleResult<{
+        orderId: VMO2OrderId;
+    }>>;
+    cancelOrder(orderId: VMO2OrderId, reason?: VMO2CancellationReasonCode): Promise<WholesaleResult<{
+        orderId: VMO2OrderId;
+    }>>;
+    getOrder(orderId: VMO2OrderId, opts?: {
+        displaySummary?: boolean;
+    }): Promise<WholesaleResult<VMO2OrderDetails>>;
+    unsolicitedCease(req: {
+        premiseId: VMO2PremiseId;
+        switchOrderReference?: SwitchOrderReference;
+        requestedOrderCompletionDate: ISODate;
+    }): Promise<WholesaleResult<VMO2CreateOrderResult>>;
+    createIncident(req: VMO2CreateIncidentRequest): Promise<WholesaleResult<VMO2CreateIncidentResult>>;
+    amendIncident(requestId: VMO2RequestId, patch: VMO2AmendIncidentPatch): Promise<WholesaleResult<{
+        requestId: VMO2RequestId;
+    }>>;
+    cancelIncident(requestId: VMO2RequestId): Promise<WholesaleResult<{
+        requestId: VMO2RequestId;
+    }>>;
+    getIncident(requestId: VMO2RequestId): Promise<WholesaleResult<VMO2IncidentDetails>>;
+    onOrderNotification(handler: (n: VMO2OrderNotification) => Promise<void>): void;
+    onSMRNotification(handler: (n: VMO2SMRNotification) => Promise<void>): void;
+}

package/dist/wholesale-provider/interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,166 @@
+/**
+ * NetomniaProvider — concrete `WholesaleProvider` implementation that
+ * routes capability calls to the Netomnia wholesale platform. Netomnia
+ * exposes its tenant API via the FibreCafe gateway, so this provider's
+ * dependency function-bag is **FibreCafe-shaped** (matches the wire +
+ * existing NET module function signatures).
+ *
+ * **Architecture (T-20260508-009 — confirmed with Frank 2026-05-08):**
+ *
+ * 1. `WholesaleProvider` interface is **VMO2-shaped**. It's the single
+ *    abstraction call sites speak — same vocabulary regardless of supplier.
+ * 2. `NetomniaProvider` implements that interface. Its **public methods
+ *    accept VMO2-shaped requests** (per the abstraction contract).
+ * 3. `NetomniaProviderDeps` is **FibreCafe-shaped**. Modules wire their
+ *    existing NestJS-injected NET clients in directly — zero
+ *    transformation at the dep boundary.
+ * 4. **Mapping VMO2 ↔ FibreCafe happens INSIDE each NetomniaProvider
+ *    method.** VMO2 in → map to FibreCafe → call dep → FibreCafe response
+ *    → map to VMO2 → return. The single place supplier shape differences
+ *    are reconciled.
+ *
+ * Phase 0 scope: mapping bodies are **stubs** (throw NotImplementedError
+ * for non-trivial mappings). T-20260508-010 will fill in the real mapping
+ * logic alongside the call-site refactor — at that point the call sites
+ * actually exercise these methods, so mapping correctness can be
+ * validated with live behavior.
+ *
+ * The same instance handles all three Netomnia-routed `OrderProvider`
+ * values (NETOMNIA / NETOMNIA_LEGACY / BRSK) — they share the same NET
+ * wholesale platform.
+ *
+ * Inbound notification handling: provider stores registered handlers
+ * in-memory. A future webhook controller (T-20260508-010) invokes
+ * `dispatchOrderNotification` / `dispatchSMRNotification` to fan out.
+ */
+import type { WholesaleProvider } from '../interface';
+import type { WholesaleResult } from '../types/wholesale';
+import type { ISODate, SwitchOrderReference } from '../types/wholesale';
+import type { VMO2AddressLookupRequest, VMO2AddressLookupResult, VMO2ListAppointmentRequest, VMO2ListAppointmentResult, VMO2ReserveAppointmentRequest, VMO2ReserveAppointmentResult, VMO2ConfirmAppointmentRequest, VMO2AppointmentDetails, VMO2AppointmentKey, VMO2AmendAppointmentPatch, VMO2CreateOrderRequest, VMO2CreateOrderResult, VMO2AmendOrderPatch, VMO2OrderDetails, VMO2OrderId, VMO2CancellationReasonCode, VMO2PremiseId, VMO2CreateIncidentRequest, VMO2CreateIncidentResult, VMO2AmendIncidentPatch, VMO2IncidentDetails, VMO2RequestId, VMO2OrderNotification, VMO2SMRNotification } from '../types/vmo2';
+import type { FibreCafeServiceAvailabilityQuery, FibreCafeServiceAvailability200, FibreCafeAvailableAppointmentsQuery, FibreCafeAvailableAppointments200, FibreCafeReserveAppointmentDto, FibreCafeReserveAppointment201, FibreCafeOrderCreateDto, FibreCafeOrderCreate202, FibreCafeProvideServiceOrderAmendmentDto, FibreCafeOrderAmendAccept202, FibreCafeServiceOrderCancellationDto, FibreCafeServiceProblemCreateDto, FibreCafeServiceProblemCreate202, FibreCafeServiceProblemAmendmentDto, FibreCafeServiceProblemCancellationDto, FibreCafeServiceProblemDetails, FibreCafeProvideServiceOrder } from '../types/fibrecafe';
+/**
+ * Function-bag of FibreCafe-shaped dependencies that NetomniaProvider
+ * delegates to. Modules wire each property to their existing typed NET
+ * client method — typically these come from NestJS-injected services
+ * (`netomniaProvider.getServiceAvailability` / `.createProvideOrder` /
+ * etc.). The adapter boundary is intentionally narrow so refactoring to
+ * use NetomniaProvider doesn't change runtime behavior or PE-log emit
+ * semantics — those still live in the wrapped function bodies.
+ *
+ * Where a FibreCafe endpoint has no current YF caller (e.g. service-problems),
+ * the dep is still typed; the wired function may be a NotImplementedError
+ * thrower until that endpoint is built out.
+ */
+export interface NetomniaProviderDeps {
+    getServiceAvailability: (query: FibreCafeServiceAvailabilityQuery) => Promise<WholesaleResult<FibreCafeServiceAvailability200>>;
+    getAvailableAppointments: (query: FibreCafeAvailableAppointmentsQuery) => Promise<WholesaleResult<FibreCafeAvailableAppointments200>>;
+    reserveAppointment: (dto: FibreCafeReserveAppointmentDto) => Promise<WholesaleResult<FibreCafeReserveAppointment201>>;
+    /**
+     * FibreCafe doesn't expose a separate confirm endpoint — confirmation is
+     * implicit at order placement. NetomniaProvider's confirmAppointment is a
+     * no-op pass-through; this dep is provided for symmetry and future use.
+     */
+    confirmAppointment?: (appointmentId: string) => Promise<WholesaleResult<{
+        appointmentId: string;
+    }>>;
+    /**
+     * FibreCafe retrieves appointment via the parent order — this dep wraps
+     * the existing module logic that reconstructs appointment state from the
+     * locally-cached NET WorkOrder mirror.
+     */
+    getAppointment?: (appointmentId: string) => Promise<WholesaleResult<FibreCafeReserveAppointment201>>;
+    /** Reappoint flow — same endpoint as reserve with rescheduleType discriminator. */
+    amendAppointment?: (dto: FibreCafeReserveAppointmentDto) => Promise<WholesaleResult<FibreCafeReserveAppointment201>>;
+    /** WO-level cancellation propagating to NET-side appointment. */
+    cancelAppointment?: (appointmentId: string, reasonCode?: string) => Promise<WholesaleResult<{
+        appointmentId: string;
+    }>>;
+    createOrder: (dto: FibreCafeOrderCreateDto) => Promise<WholesaleResult<FibreCafeOrderCreate202>>;
+    amendOrder: (dto: FibreCafeProvideServiceOrderAmendmentDto) => Promise<WholesaleResult<FibreCafeOrderAmendAccept202>>;
+    cancelOrder: (dto: FibreCafeServiceOrderCancellationDto) => Promise<WholesaleResult<{
+        cancellationRequestId: string;
+    }>>;
+    getOrder: (orderId: string) => Promise<WholesaleResult<FibreCafeProvideServiceOrder>>;
+    createIncident?: (dto: FibreCafeServiceProblemCreateDto) => Promise<WholesaleResult<FibreCafeServiceProblemCreate202>>;
+    amendIncident?: (dto: FibreCafeServiceProblemAmendmentDto) => Promise<WholesaleResult<{
+        amendmentId: string;
+    }>>;
+    cancelIncident?: (dto: FibreCafeServiceProblemCancellationDto) => Promise<WholesaleResult<{
+        cancellationId: string;
+    }>>;
+    getIncident?: (serviceProblemId: string) => Promise<WholesaleResult<FibreCafeServiceProblemDetails>>;
+}
+declare type OrderNotificationHandler = (n: VMO2OrderNotification) => Promise<void>;
+declare type SMRNotificationHandler = (n: VMO2SMRNotification) => Promise<void>;
+/**
+ * Sentinel error surfaced by Phase 0 stub mapping bodies. T-20260508-010
+ * fills in real bodies; until then any call to these methods at runtime
+ * throws this. Tests verify the *delegation* path works for methods whose
+ * mapping is trivial enough to ship in Phase 0.
+ */
+export declare class NotImplementedError extends Error {
+    readonly method: string;
+    constructor(method: string);
+}
+export declare class NetomniaProvider implements WholesaleProvider {
+    private readonly deps;
+    private readonly orderHandlers;
+    private readonly smrHandlers;
+    constructor(deps: NetomniaProviderDeps);
+    searchAddress(_req: VMO2AddressLookupRequest): Promise<WholesaleResult<VMO2AddressLookupResult>>;
+    listAppointments(_req: VMO2ListAppointmentRequest): Promise<WholesaleResult<VMO2ListAppointmentResult>>;
+    reserveAppointment(_req: VMO2ReserveAppointmentRequest): Promise<WholesaleResult<VMO2ReserveAppointmentResult>>;
+    confirmAppointment(_req: VMO2ConfirmAppointmentRequest): Promise<WholesaleResult<{
+        appointmentKey: VMO2AppointmentKey;
+    }>>;
+    getAppointment(_key: VMO2AppointmentKey): Promise<WholesaleResult<VMO2AppointmentDetails>>;
+    amendAppointment(_key: VMO2AppointmentKey, _patch: VMO2AmendAppointmentPatch): Promise<WholesaleResult<{
+        appointmentKey: VMO2AppointmentKey;
+    }>>;
+    cancelAppointment(_key: VMO2AppointmentKey): Promise<WholesaleResult<{
+        appointmentKey: VMO2AppointmentKey;
+    }>>;
+    createOrder(_req: VMO2CreateOrderRequest): Promise<WholesaleResult<VMO2CreateOrderResult>>;
+    amendOrder(_orderId: VMO2OrderId, _patch: VMO2AmendOrderPatch): Promise<WholesaleResult<{
+        orderId: VMO2OrderId;
+    }>>;
+    cancelOrder(_orderId: VMO2OrderId, _reason?: VMO2CancellationReasonCode): Promise<WholesaleResult<{
+        orderId: VMO2OrderId;
+    }>>;
+    getOrder(_orderId: VMO2OrderId, _opts?: {
+        displaySummary?: boolean;
+    }): Promise<WholesaleResult<VMO2OrderDetails>>;
+    unsolicitedCease(_req: {
+        premiseId: VMO2PremiseId;
+        switchOrderReference?: SwitchOrderReference;
+        requestedOrderCompletionDate: ISODate;
+    }): Promise<WholesaleResult<VMO2CreateOrderResult>>;
+    createIncident(_req: VMO2CreateIncidentRequest): Promise<WholesaleResult<VMO2CreateIncidentResult>>;
+    amendIncident(_requestId: VMO2RequestId, _patch: VMO2AmendIncidentPatch): Promise<WholesaleResult<{
+        requestId: VMO2RequestId;
+    }>>;
+    cancelIncident(_requestId: VMO2RequestId): Promise<WholesaleResult<{
+        requestId: VMO2RequestId;
+    }>>;
+    getIncident(_requestId: VMO2RequestId): Promise<WholesaleResult<VMO2IncidentDetails>>;
+    onOrderNotification(handler: OrderNotificationHandler): void;
+    onSMRNotification(handler: SMRNotificationHandler): void;
+    /**
+     * Internal dispatch — invoked by the webhook controller (T-20260508-010)
+     * after mapping a FibreCafe KCI to a VMO2OrderNotification envelope. Fans
+     * out to every registered handler in registration order. Handler errors
+     * are aggregated and re-thrown after all handlers complete.
+     */
+    dispatchOrderNotification(n: VMO2OrderNotification): Promise<void>;
+    dispatchSMRNotification(n: VMO2SMRNotification): Promise<void>;
+}
+/**
+ * Aggregates errors thrown by handlers during notification dispatch so the
+ * webhook controller can surface every failure rather than masking later
+ * handlers with the first throw.
+ */
+export declare class AggregateNotificationError extends Error {
+    readonly errors: unknown[];
+    constructor(errors: unknown[]);
+}
+export {};