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

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

@@ -1,26 +1,33 @@
 /**
  * Wholesale provider — subpath barrel.
  *
- * Consumers import from `@d19n/youfibre-odin-sdk/wholesale-provider`:
+ * Consumers import from `@d19n/youfibre-odin-sdk/dist/wholesale-provider`:
  *
  *   ```ts
  *   import {
  *     WholesaleProvider,
  *     NetomniaProvider,
  *     NetomniaProviderDeps,
- *   } from '@d19n/youfibre-odin-sdk/wholesale-provider';
+ *   } from '@d19n/youfibre-odin-sdk/dist/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.
+ * **Architecture (Path B / pass-through delegation):**
+ * - `WholesaleProvider` is a strategy-dispatchable interface. Method names
+ *   align with VMO2 spec where it makes sense; args match existing NET
+ *   module method signatures.
+ * - `NetomniaProvider implements WholesaleProvider` — pass-through to deps
+ *   wired by modules to their existing NestJS-injected NET methods. Zero
+ *   transformation at the boundary.
+ * - VMO2-shaped types (`./types/vmo2`) and FibreCafe-shaped types
+ *   (`./types/fibrecafe`) are exported as **reference types** for future
+ *   use (Vmo2Provider implementation, module DTO consolidation). They are
+ *   NOT on the WholesaleProvider public surface in Phase 0.
  *
- * Linked: T-20260508-009
+ * Linked: T-20260508-009 / T-20260508-010
  */
-export type { WholesaleProvider } from './interface';
+export type { WholesaleProvider, CreateOrderOptions, CancellationReasonCode, ReserveAppointmentArgs, ListAppointmentsArgs, ScheduleServiceWorkOrderArgs, RescheduleServiceWorkOrderArgs, AmendAppointmentArgs, SyncWorkOrderToSupplierArgs, UpdateOrderExternalRefArgs, } 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 { NetomniaProvider, AggregateNotificationError } from './providers/netomnia-provider';
 export type { NetomniaProviderDeps } from './providers/netomnia-provider';
+export type { VMO2OrderId, VMO2RequestId, VMO2AppointmentKey, VMO2PremiseId, VMO2OrderNotificationType, VMO2SMRNotificationType, VMO2NotificationEnvelope, VMO2OrderNotification, VMO2SMRNotification, VMO2InboundNotification, } from './types/vmo2';
+export * from './types/fibrecafe';

package/dist/wholesale-provider/index.js

@@ -2,27 +2,58 @@
 /**
  * Wholesale provider — subpath barrel.
  *
- * Consumers import from `@d19n/youfibre-odin-sdk/wholesale-provider`:
+ * Consumers import from `@d19n/youfibre-odin-sdk/dist/wholesale-provider`:
  *
  *   ```ts
  *   import {
  *     WholesaleProvider,
  *     NetomniaProvider,
  *     NetomniaProviderDeps,
- *   } from '@d19n/youfibre-odin-sdk/wholesale-provider';
+ *   } from '@d19n/youfibre-odin-sdk/dist/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.
+ * **Architecture (Path B / pass-through delegation):**
+ * - `WholesaleProvider` is a strategy-dispatchable interface. Method names
+ *   align with VMO2 spec where it makes sense; args match existing NET
+ *   module method signatures.
+ * - `NetomniaProvider implements WholesaleProvider` — pass-through to deps
+ *   wired by modules to their existing NestJS-injected NET methods. Zero
+ *   transformation at the boundary.
+ * - VMO2-shaped types (`./types/vmo2`) and FibreCafe-shaped types
+ *   (`./types/fibrecafe`) are exported as **reference types** for future
+ *   use (Vmo2Provider implementation, module DTO consolidation). They are
+ *   NOT on the WholesaleProvider public surface in Phase 0.
  *
- * Linked: T-20260508-009
+ * Linked: T-20260508-009 / T-20260508-010
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NotImplementedError = exports.AggregateNotificationError = exports.NetomniaProvider = void 0;
-// Provider implementations
+exports.AggregateNotificationError = exports.NetomniaProvider = void 0;
+// ── Provider implementation ───────────────────────────────────────────
 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; } });
+// ── Reference types (re-exported — not on WholesaleProvider surface) ──
+//
+// FibreCafe wire-format types — useful for module-level DTO consolidation
+// or building the VMO2 wire request inside a future Vmo2Provider. These
+// are NOT used by NetomniaProviderDeps in Path B; the deps shape is YF-
+// context-shaped.
+//
+// Re-exported with `export *` because TS 4.8 doesn't support `export type *`.
+// All declarations in fibrecafe.ts are types/interfaces with no runtime
+// exports, so `export *` re-exports them as types only (no JS code emit).
+__exportStar(require("./types/fibrecafe"), exports);

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

@@ -1,65 +1,112 @@
+import type { VMO2OrderNotification, VMO2SMRNotification } from './types/vmo2';
 /**
- * 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.
+ * Reasons a cancellation request can be made (NET wire-level enum value
+ * passed through to the FibreCafe gateway).
+ */
+export declare type CancellationReasonCode = string;
+export interface CreateOrderOptions {
+    doNotCreateServiceAppointment?: boolean;
+    externalRefBrskFno?: string;
+    externalRefBrskIsp?: string;
+    /** Provider-specific extras — populated as needed per provider. */
+    [extra: string]: unknown;
+}
+export interface ReserveAppointmentArgs {
+    yfAppointmentId: string;
+    uprn: number;
+    startDateTime: string;
+    endDateTime: string;
+    /** 'PROVIDE' / 'REPAIR' / 'MODIFY' or supplier-specific. */
+    purpose: string;
+    yfOrderId: string;
+    woProperties: {
+        ServiceCallReason?: string;
+        WorkOrderExternalReference?: string;
+    };
+}
+export interface ListAppointmentsArgs {
+    uprn: number;
+    /** ISO date the appointment search starts from. */
+    start: string;
+    appointmentPurpose: 'PROVIDE' | 'REPAIR';
+}
+export interface ScheduleServiceWorkOrderArgs {
+    yfWorkOrderId: string;
+    uprn: number;
+    startDateTime: string;
+    endDateTime: string;
+    yfOrderId: string;
+    properties: {
+        ServiceCallReason?: string;
+    };
+}
+export interface RescheduleServiceWorkOrderArgs {
+    yfWorkOrderId: string;
+    uprn: number;
+    startDateTime: string;
+    endDateTime: string;
+    yfOrderId: string;
+}
+export interface AmendAppointmentArgs {
+    yfOrderId: string;
+    yfWorkOrderId: string;
+    supplierAppointmentReference: string;
+}
+export interface SyncWorkOrderToSupplierArgs {
+    principal: unknown;
+    yfOrderId: string;
+    yfWorkOrderId: string;
+    yfChangeReason: {
+        id?: string;
+        externalId: string;
+        entity: string;
+        type: unknown;
+        properties: unknown;
+    };
+}
+export interface UpdateOrderExternalRefArgs {
+    oldYfId: string;
+    newYfId: string;
+}
+/**
+ * Capability-shaped interface to a wholesale supplier. Method NAMES align
+ * with VMO2 spec where it makes sense; ARGS match existing NET module
+ * method signatures. Each provider implementation translates these args
+ * into its supplier wire format internally.
  *
- * 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.
+ * Returns are typed loosely — modules know the return shape via the dep
+ * function they wire in.
  */
-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>>;
+    searchAddress(uprn: number): Promise<unknown>;
+    listAppointments(args: ListAppointmentsArgs): Promise<unknown>;
+    reserveAppointment(args: ReserveAppointmentArgs): Promise<unknown>;
+    scheduleServiceWorkOrder(args: ScheduleServiceWorkOrderArgs): Promise<unknown>;
+    rescheduleServiceWorkOrder(args: RescheduleServiceWorkOrderArgs): Promise<unknown>;
+    amendAppointment(args: AmendAppointmentArgs): Promise<unknown>;
+    createOrder(principal: unknown, orderId: string, options?: CreateOrderOptions): Promise<unknown>;
+    /** Tier-change CoS — wraps `createModifyOrderForYfOrder` style args. */
+    amendOrder(principal: unknown, yfOrderId: string): Promise<unknown>;
+    /** Pre-install cancel of an in-flight provide order. */
+    cancelOrder(yfOrderId: string, reasonCode: CancellationReasonCode): Promise<unknown>;
+    /** Active-customer cease (post-Active churn / OTS-losing). */
+    ceaseOrder(yfOrderId: string, serviceId: string): Promise<unknown>;
+    /** Inbound supplier KCI / notification handler. */
+    receiveKci(principal: unknown, dto: unknown): Promise<void>;
+    /** Outbound YF→supplier WO sync (cancel propagation, etc.). */
+    syncWorkOrderToSupplier(args: SyncWorkOrderToSupplierArgs): Promise<unknown>;
+    /** Inbound supplier→YF WO change application (post-receiveKci). */
+    syncWorkOrderFromSupplier(order: unknown, dto: unknown): Promise<unknown>;
+    retrieveServiceIdByUprn(uprn: number): Promise<string | null>;
+    updateOrderExternalRef(args: UpdateOrderExternalRefArgs): Promise<void>;
+    /**
+     * Register a typed handler for fanout of supplier order notifications.
+     * The webhook controller invokes `dispatchOrderNotification` on the
+     * provider after envelope-mapping; registered handlers are called in
+     * order with the normalized `VMO2OrderNotification` envelope (the
+     * SDK uses VMO2 envelope types as the cross-supplier normalization
+     * shape — easier to reason about + matches the upcoming VMO2 wire).
+     */
     onOrderNotification(handler: (n: VMO2OrderNotification) => Promise<void>): void;
     onSMRNotification(handler: (n: VMO2SMRNotification) => Promise<void>): void;
 }

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

@@ -1,155 +1,99 @@
 /**
- * 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).
+ * NetomniaProvider — concrete `WholesaleProvider` for the Netomnia
+ * wholesale platform (which exposes its tenant API via the FibreCafe
+ * gateway). Same instance handles all three Netomnia-routed `OrderProvider`
+ * values (NETOMNIA / NETOMNIA_LEGACY / BRSK).
  *
- * **Architecture (T-20260508-009 — confirmed with Frank 2026-05-08):**
+ * **Architecture (T-20260508-009/010 — Path B):**
  *
- * 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.
+ * NetomniaProvider is a **strategy-dispatch pass-through**. Its public
+ * methods take YF-context args (matching existing NET module method
+ * signatures) and delegate 1:1 to deps. The deps are wired to the
+ * existing module-level `NetomniaProvider` / `NetomniaService` methods
+ * — zero behaviour change at the call site.
  *
- * 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.
+ * Why a thin pass-through is enough:
+ *   - The "abstraction value" provided is strategy dispatch — call sites
+ *     do `factory.get(provider).createOrder(...)` instead of
+ *     `if (isNetomnia) netomniaProvider.createNetomniaOrder(...)`.
+ *   - DTO-building / HTTP / PE-log emit semantics already live in the
+ *     existing NET module methods. Lifting them into the SDK (via deps
+ *     that take FibreCafe DTOs and a built-in HTTP transport) was
+ *     considered (Path A/C) but rejected for Phase 0 — that's a follow-up
+ *     standardization step we can take if/when VMO2 alignment requires it.
  *
  * Inbound notification handling: provider stores registered handlers
- * in-memory. A future webhook controller (T-20260508-010) invokes
- * `dispatchOrderNotification` / `dispatchSMRNotification` to fan out.
+ * in-memory. The wholesale webhook controller (T-20260508-010 Step 1d)
+ * invokes `dispatchOrderNotification` / `dispatchSMRNotification` after
+ * envelope-mapping; registered handlers are fanned 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';
+import type { WholesaleProvider, CreateOrderOptions, CancellationReasonCode, ReserveAppointmentArgs, ListAppointmentsArgs, ScheduleServiceWorkOrderArgs, RescheduleServiceWorkOrderArgs, AmendAppointmentArgs, SyncWorkOrderToSupplierArgs, UpdateOrderExternalRefArgs } from '../interface';
+import type { VMO2OrderNotification, VMO2SMRNotification } from '../types/vmo2';
 /**
- * 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.
+ * Function-bag of dependencies the NetomniaProvider delegates to.
+ *
+ * **Deps shape mirrors the WholesaleProvider interface 1:1.** Modules wire
+ * each property to their existing NestJS-injected NET service/provider
+ * method that already takes the equivalent YF-context args. The adapter
+ * boundary is intentionally narrow: zero transformation between dep input
+ * and the existing module method's input.
  *
- * 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.
+ * Example (in a module's WholesaleModule.useFactory):
+ * ```typescript
+ *   {
+ *     createOrder: (p, id, opts) => existingNetomniaProvider.createNetomniaOrder(p, id, opts),
+ *     cancelOrder: (id, reason) => existingNetomniaProvider.cancelProvideOrder(id, reason),
+ *     amendOrder: (p, id) => existingNetomniaService.createModifyOrderForYfOrder(p, id),
+ *     ...
+ *   }
+ * ```
  */
 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>>;
+    searchAddress: (uprn: number) => Promise<unknown>;
+    listAppointments: (args: ListAppointmentsArgs) => Promise<unknown>;
+    reserveAppointment: (args: ReserveAppointmentArgs) => Promise<unknown>;
+    scheduleServiceWorkOrder: (args: ScheduleServiceWorkOrderArgs) => Promise<unknown>;
+    rescheduleServiceWorkOrder: (args: RescheduleServiceWorkOrderArgs) => Promise<unknown>;
+    amendAppointment: (args: AmendAppointmentArgs) => Promise<unknown>;
+    createOrder: (principal: unknown, orderId: string, options?: CreateOrderOptions) => Promise<unknown>;
+    amendOrder: (principal: unknown, yfOrderId: string) => Promise<unknown>;
+    cancelOrder: (yfOrderId: string, reasonCode: CancellationReasonCode) => Promise<unknown>;
+    ceaseOrder: (yfOrderId: string, serviceId: string) => Promise<unknown>;
+    receiveKci: (principal: unknown, dto: unknown) => Promise<void>;
+    syncWorkOrderToSupplier: (args: SyncWorkOrderToSupplierArgs) => Promise<unknown>;
+    syncWorkOrderFromSupplier: (order: unknown, dto: unknown) => Promise<unknown>;
+    retrieveServiceIdByUprn: (uprn: number) => Promise<string | null>;
+    updateOrderExternalRef: (args: UpdateOrderExternalRefArgs) => Promise<void>;
 }
 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>>;
+    searchAddress(uprn: number): Promise<unknown>;
+    listAppointments(args: ListAppointmentsArgs): Promise<unknown>;
+    reserveAppointment(args: ReserveAppointmentArgs): Promise<unknown>;
+    scheduleServiceWorkOrder(args: ScheduleServiceWorkOrderArgs): Promise<unknown>;
+    rescheduleServiceWorkOrder(args: RescheduleServiceWorkOrderArgs): Promise<unknown>;
+    amendAppointment(args: AmendAppointmentArgs): Promise<unknown>;
+    createOrder(principal: unknown, orderId: string, options?: CreateOrderOptions): Promise<unknown>;
+    amendOrder(principal: unknown, yfOrderId: string): Promise<unknown>;
+    cancelOrder(yfOrderId: string, reasonCode: CancellationReasonCode): Promise<unknown>;
+    ceaseOrder(yfOrderId: string, serviceId: string): Promise<unknown>;
+    receiveKci(principal: unknown, dto: unknown): Promise<void>;
+    syncWorkOrderToSupplier(args: SyncWorkOrderToSupplierArgs): Promise<unknown>;
+    syncWorkOrderFromSupplier(order: unknown, dto: unknown): Promise<unknown>;
+    retrieveServiceIdByUprn(uprn: number): Promise<string>;
+    updateOrderExternalRef(args: UpdateOrderExternalRefArgs): Promise<void>;
     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.
+     * Internal dispatch — invoked by the wholesale webhook controller after
+     * mapping a supplier KCI to a normalized `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>;

package/dist/wholesale-provider/providers/netomnia-provider.js

@@ -9,133 +9,60 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AggregateNotificationError = exports.NetomniaProvider = exports.NotImplementedError = void 0;
-/**
- * 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.
- */
-class NotImplementedError extends Error {
-    constructor(method) {
-        super(`NetomniaProvider.${method} mapping not yet implemented (Phase 0 stub) — ` +
-            `lands in T-20260508-010 alongside call-site refactor.`);
-        this.method = method;
-        this.name = 'NotImplementedError';
-    }
-}
-exports.NotImplementedError = NotImplementedError;
+exports.AggregateNotificationError = exports.NetomniaProvider = void 0;
 class NetomniaProvider {
     constructor(deps) {
         this.deps = deps;
         this.orderHandlers = [];
         this.smrHandlers = [];
     }
-    // ──────────────────────────────────────────────────────────────────
-    //  Address / availability
-    // ──────────────────────────────────────────────────────────────────
-    searchAddress(_req) {
-        return __awaiter(this, void 0, void 0, function* () {
-            // Phase 0 stub: the VMO2→FibreCafe mapping for searchAddress is
-            // non-trivial (VMO2 returns premise + capability detail; FibreCafe
-            // returns address + service-spec). Real mapping lands in T-010 when
-            // call sites convert. Until then this throws to surface accidental
-            // call-site exercise.
-            throw new NotImplementedError('searchAddress');
-        });
+    // ── Pass-through delegation ────────────────────────────────────────
+    searchAddress(uprn) {
+        return this.deps.searchAddress(uprn);
     }
-    // ──────────────────────────────────────────────────────────────────
-    //  Appointments
-    // ──────────────────────────────────────────────────────────────────
-    listAppointments(_req) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('listAppointments');
-        });
+    listAppointments(args) {
+        return this.deps.listAppointments(args);
     }
-    reserveAppointment(_req) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('reserveAppointment');
-        });
+    reserveAppointment(args) {
+        return this.deps.reserveAppointment(args);
     }
-    confirmAppointment(_req) {
-        return __awaiter(this, void 0, void 0, function* () {
-            // FibreCafe has no separate confirm step — would be a no-op for NET
-            // path. Stubbed until T-010 validates the assumption end-to-end.
-            throw new NotImplementedError('confirmAppointment');
-        });
+    scheduleServiceWorkOrder(args) {
+        return this.deps.scheduleServiceWorkOrder(args);
     }
-    getAppointment(_key) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('getAppointment');
-        });
+    rescheduleServiceWorkOrder(args) {
+        return this.deps.rescheduleServiceWorkOrder(args);
     }
-    amendAppointment(_key, _patch) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('amendAppointment');
-        });
+    amendAppointment(args) {
+        return this.deps.amendAppointment(args);
     }
-    cancelAppointment(_key) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('cancelAppointment');
-        });
+    createOrder(principal, orderId, options) {
+        return this.deps.createOrder(principal, orderId, options);
     }
-    // ──────────────────────────────────────────────────────────────────
-    //  Orders
-    // ──────────────────────────────────────────────────────────────────
-    createOrder(_req) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('createOrder');
-        });
+    amendOrder(principal, yfOrderId) {
+        return this.deps.amendOrder(principal, yfOrderId);
     }
-    amendOrder(_orderId, _patch) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('amendOrder');
-        });
+    cancelOrder(yfOrderId, reasonCode) {
+        return this.deps.cancelOrder(yfOrderId, reasonCode);
     }
-    cancelOrder(_orderId, _reason) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('cancelOrder');
-        });
+    ceaseOrder(yfOrderId, serviceId) {
+        return this.deps.ceaseOrder(yfOrderId, serviceId);
     }
-    getOrder(_orderId, _opts) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('getOrder');
-        });
-    }
-    unsolicitedCease(_req) {
-        return __awaiter(this, void 0, void 0, function* () {
-            // FibreCafe doesn't have an outbound "unsolicited cease" — it's an
-            // inbound-only KCI on the Netomnia side. NetomniaProvider exposes the
-            // method for interface symmetry; calling it always throws.
-            throw new NotImplementedError('unsolicitedCease');
-        });
+    receiveKci(principal, dto) {
+        return this.deps.receiveKci(principal, dto);
     }
-    // ──────────────────────────────────────────────────────────────────
-    //  Service Management
-    // ──────────────────────────────────────────────────────────────────
-    createIncident(_req) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('createIncident');
-        });
+    syncWorkOrderToSupplier(args) {
+        return this.deps.syncWorkOrderToSupplier(args);
     }
-    amendIncident(_requestId, _patch) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('amendIncident');
-        });
+    syncWorkOrderFromSupplier(order, dto) {
+        return this.deps.syncWorkOrderFromSupplier(order, dto);
     }
-    cancelIncident(_requestId) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('cancelIncident');
-        });
+    retrieveServiceIdByUprn(uprn) {
+        return this.deps.retrieveServiceIdByUprn(uprn);
     }
-    getIncident(_requestId) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new NotImplementedError('getIncident');
-        });
+    updateOrderExternalRef(args) {
+        return this.deps.updateOrderExternalRef(args);
     }
-    // ──────────────────────────────────────────────────────────────────
-    //  Inbound notification subscription
-    // ──────────────────────────────────────────────────────────────────
+    // ── Inbound notification subscription ─────────────────────────────
     onOrderNotification(handler) {
         this.orderHandlers.push(handler);
     }
@@ -143,10 +70,10 @@ class NetomniaProvider {
         this.smrHandlers.push(handler);
     }
     /**
-     * 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.
+     * Internal dispatch — invoked by the wholesale webhook controller after
+     * mapping a supplier KCI to a normalized `VMO2OrderNotification` envelope.
+     * Fans out to every registered handler in registration order. Handler
+     * errors are aggregated and re-thrown after all handlers complete.
      */
     dispatchOrderNotification(n) {
         return __awaiter(this, void 0, void 0, function* () {

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

@@ -10,25 +10,16 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 /**
- * NetomniaProvider Phase 0 tests.
+ * NetomniaProvider tests — verify pass-through delegation pattern.
  *
- * **What we verify in Phase 0 (T-20260508-009):**
- *   1. NetomniaProvider is structurally assignable to WholesaleProvider
+ * Path B (T-20260508-009/010): NetomniaProvider's public methods delegate
+ * 1:1 to deps that match the WholesaleProvider interface signature. These
+ * tests assert:
+ *   1. Each public method calls the matching dep with identical args.
+ *   2. The dep's return value is forwarded unchanged.
+ *   3. NetomniaProvider is structurally assignable to WholesaleProvider
  *      (compile-time check via the class declaration).
- *   2. NetomniaProviderDeps is FibreCafe-shaped — modules can wire their
- *      existing typed NET functions in. Verified by constructing a
- *      stub-deps object that passes type-check.
- *   3. Each outbound method throws `NotImplementedError` until T-010 fills
- *      in the VMO2↔FibreCafe mapping bodies.
- *   4. Inbound handler registration + dispatch + error aggregation work
- *      as documented (these are NOT mapping-dependent — they fan out to
- *      registered handlers regardless of supplier).
- *
- * **What's deferred to T-20260508-010 tests:** end-to-end behaviour parity
- * — the real test is "running through NetomniaProvider produces identical
- * NET-side state vs running through legacy direct calls". That requires
- * call sites + real deps + recorded baseline; lives in T-013 acceptance
- * gate.
+ *   4. Inbound handler registration + dispatch + error aggregation work.
  *
  * Run: `npm run test:wholesale-provider`
  */
@@ -51,134 +42,238 @@ function assert(label, cond, hint) {
 function brand(s) {
     return s;
 }
-function ok(data) {
-    return {
-        status: 'accepted',
-        eventDateTime: brand('2026-05-09T00:00:00Z'),
-        data,
-    };
-}
 /**
- * Build a stub deps object that returns canned `WholesaleResult` envelopes.
- * Every method returns a passthrough OK; no method is exercised in Phase 0
- * (provider methods all throw). Deps exist so the type-check passes and
- * future tests can add behaviour assertions.
+ * Build deps that record their call args + return a sentinel value. Each
+ * dep is identical-shape to the corresponding WholesaleProvider method so
+ * the pass-through pattern can be tested.
  */
 function buildDeps() {
-    const stub = (data) => () => Promise.resolve(ok(data));
-    return {
-        getServiceAvailability: stub({
-            address: { identifier: { id: 'X', type: 'UPRN' } },
-            serviceSpecifications: [],
-        }),
-        getAvailableAppointments: stub({ availableTimeslots: [] }),
-        reserveAppointment: stub({
-            id: 'A1',
-            supplierReference: 'NET-A1',
-            address: { id: 'X', type: 'UPRN' },
-            serviceSpecification: { id: 'fttp' },
-            timeslot: {
-                timeslotStartDateTime: '2026-05-09T08:00:00Z',
-                timeslotEndDateTime: '2026-05-09T13:00:00Z',
-            },
-        }),
-        createOrder: stub({}),
-        amendOrder: stub({}),
-        cancelOrder: stub({ cancellationRequestId: 'CXL-1' }),
-        getOrder: stub({
-            id: 'O1',
-            tenant: 'YOUFIBRE',
-            status: 'IN_PROGRESS',
-            address: { id: 'X', type: 'UPRN' },
-            serviceOrderItem: {
-                serviceSpecification: { id: 'fttp' },
-                serviceCharacteristics: [],
-            },
-            primaryContact: { name: 'Bob', phoneNumber: '01234' },
-        }),
-        // Optional deps left unset — provider stubs throw when called regardless
+    const log = [];
+    const sentinel = Symbol('NET-RETURN');
+    const record = (method) => (...args) => {
+        log.push({ method, args });
+        return Promise.resolve(sentinel);
     };
+    const recordVoid = (method) => (...args) => {
+        log.push({ method, args });
+        return Promise.resolve(undefined);
+    };
+    const deps = {
+        searchAddress: record('searchAddress'),
+        listAppointments: record('listAppointments'),
+        reserveAppointment: record('reserveAppointment'),
+        scheduleServiceWorkOrder: record('scheduleServiceWorkOrder'),
+        rescheduleServiceWorkOrder: record('rescheduleServiceWorkOrder'),
+        amendAppointment: record('amendAppointment'),
+        createOrder: record('createOrder'),
+        amendOrder: record('amendOrder'),
+        cancelOrder: record('cancelOrder'),
+        ceaseOrder: record('ceaseOrder'),
+        receiveKci: recordVoid('receiveKci'),
+        syncWorkOrderToSupplier: record('syncWorkOrderToSupplier'),
+        syncWorkOrderFromSupplier: record('syncWorkOrderFromSupplier'),
+        retrieveServiceIdByUprn: (uprn) => {
+            log.push({ method: 'retrieveServiceIdByUprn', args: [uprn] });
+            return Promise.resolve('NET-SVC-1');
+        },
+        updateOrderExternalRef: recordVoid('updateOrderExternalRef'),
+    };
+    return { deps, log, sentinel };
 }
 function run() {
     return __awaiter(this, void 0, void 0, function* () {
-        console.log('NetomniaProvider — Phase 0 tests\n');
-        // ── 1. Structural assignment (compile-time check) ─────────────────
-        console.log('Test: NetomniaProvider implements WholesaleProvider (compile-time)');
+        console.log('NetomniaProvider — pass-through delegation tests\n');
+        console.log('Test: searchAddress delegates to deps');
         {
-            const p = new netomnia_provider_1.NetomniaProvider(buildDeps());
-            assert('class instantiates', p instanceof netomnia_provider_1.NetomniaProvider);
+            const { deps, log, sentinel } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            const result = yield p.searchAddress(123);
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'searchAddress');
+            assert('args forwarded', JSON.stringify(log[0].args) === JSON.stringify([123]));
+            assert('return forwarded', result === sentinel);
+        }
+        console.log('Test: listAppointments delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            const args = { uprn: 123, start: '2026-06-01', appointmentPurpose: 'PROVIDE' };
+            yield p.listAppointments(args);
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'listAppointments');
+            assert('args forwarded', log[0].args[0] === args);
+        }
+        console.log('Test: reserveAppointment delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            const args = {
+                yfAppointmentId: 'APT-1',
+                uprn: 123,
+                startDateTime: '2026-06-01T08:00:00Z',
+                endDateTime: '2026-06-01T13:00:00Z',
+                purpose: 'PROVIDE',
+                yfOrderId: 'ORD-1',
+                woProperties: {},
+            };
+            yield p.reserveAppointment(args);
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'reserveAppointment');
+            assert('args forwarded', log[0].args[0] === args);
         }
-        // ── 2. NetomniaProviderDeps is FibreCafe-shaped ───────────────────
-        console.log('Test: NetomniaProviderDeps accepts FibreCafe-shaped function bag');
-        {
-            const deps = buildDeps();
-            assert('createOrder typed dep exists', typeof deps.createOrder === 'function');
-            assert('getServiceAvailability typed dep exists', typeof deps.getServiceAvailability === 'function');
-            assert('cancelOrder typed dep exists', typeof deps.cancelOrder === 'function');
-        }
-        // ── 3. Phase 0 stubs — every outbound method throws ──────────────
-        console.log('Test: every outbound method throws NotImplementedError (Phase 0)');
-        const p = new netomnia_provider_1.NetomniaProvider(buildDeps());
-        function expectNotImplemented(label, fn) {
-            return __awaiter(this, void 0, void 0, function* () {
-                try {
-                    yield fn();
-                    assert(`${label} threw`, false, 'expected NotImplementedError, got no throw');
-                }
-                catch (err) {
-                    assert(`${label} threw NotImplementedError`, err instanceof netomnia_provider_1.NotImplementedError);
-                }
-            });
-        }
-        yield expectNotImplemented('searchAddress', () => p.searchAddress({ query: { kind: 'byAddress', postCode: 'SW1A' } }));
-        yield expectNotImplemented('listAppointments', () => p.listAppointments({
-            scope: { orderId: brand('O1') },
-            networkType: 'xgspon',
-            journeyType: 'order',
-            visit: [],
-        }));
-        yield expectNotImplemented('reserveAppointment', () => p.reserveAppointment({
-            scope: { orderId: brand('O1') },
-            networkType: 'xgspon',
-            journeyType: 'order',
-            appointmentSlots: [],
-        }));
-        yield expectNotImplemented('confirmAppointment', () => p.confirmAppointment({ appointmentKey: brand('AK1') }));
-        yield expectNotImplemented('getAppointment', () => p.getAppointment(brand('AK1')));
-        yield expectNotImplemented('amendAppointment', () => p.amendAppointment(brand('AK1'), { appointmentSlot: 'AM' }));
-        yield expectNotImplemented('cancelAppointment', () => p.cancelAppointment(brand('AK1')));
-        yield expectNotImplemented('createOrder', () => p.createOrder({
-            invoiceAccountNumber: brand('IAN-1'),
-            orderIntent: 'new provide',
-            requestedOrderCompletionDate: brand('2026-06-01'),
-            productsAndServices: {},
-        }));
-        yield expectNotImplemented('amendOrder', () => p.amendOrder(brand('O1'), {}));
-        yield expectNotImplemented('cancelOrder', () => p.cancelOrder(brand('O1')));
-        yield expectNotImplemented('getOrder', () => p.getOrder(brand('O1')));
-        yield expectNotImplemented('unsolicitedCease', () => p.unsolicitedCease({
-            premiseId: brand('P1'),
-            requestedOrderCompletionDate: brand('2026-06-01'),
-        }));
-        yield expectNotImplemented('createIncident', () => p.createIncident({
-            requestType: 'reactiveincident',
-            reasonCode: brand('RNC-1'),
-        }));
-        yield expectNotImplemented('amendIncident', () => p.amendIncident(brand('R1'), {
-            kind: 'resolutionAcceptance',
-            closureAcceptance: true,
-        }));
-        yield expectNotImplemented('cancelIncident', () => p.cancelIncident(brand('R1')));
-        yield expectNotImplemented('getIncident', () => p.getIncident(brand('R1')));
-        // ── 4. Inbound handler registration + dispatch ────────────────────
+        console.log('Test: scheduleServiceWorkOrder delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            const args = {
+                yfWorkOrderId: 'WO-1',
+                uprn: 123,
+                startDateTime: '2026-06-01T08:00:00Z',
+                endDateTime: '2026-06-01T13:00:00Z',
+                yfOrderId: 'ORD-1',
+                properties: {},
+            };
+            yield p.scheduleServiceWorkOrder(args);
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'scheduleServiceWorkOrder');
+        }
+        console.log('Test: rescheduleServiceWorkOrder delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            const args = {
+                yfWorkOrderId: 'WO-1',
+                uprn: 123,
+                startDateTime: '2026-06-01T08:00:00Z',
+                endDateTime: '2026-06-01T13:00:00Z',
+                yfOrderId: 'ORD-1',
+            };
+            yield p.rescheduleServiceWorkOrder(args);
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'rescheduleServiceWorkOrder');
+        }
+        console.log('Test: amendAppointment delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            const args = { yfOrderId: 'ORD-1', yfWorkOrderId: 'WO-1', supplierAppointmentReference: 'NET-A1' };
+            yield p.amendAppointment(args);
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'amendAppointment');
+        }
+        console.log('Test: createOrder delegates to deps with all args (principal, orderId, options)');
+        {
+            const { deps, log, sentinel } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            const principal = { id: 'user-1' };
+            const opts = { doNotCreateServiceAppointment: true };
+            const result = yield p.createOrder(principal, 'ORD-1', opts);
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'createOrder');
+            assert('principal forwarded', log[0].args[0] === principal);
+            assert('orderId forwarded', log[0].args[1] === 'ORD-1');
+            assert('options forwarded', log[0].args[2] === opts);
+            assert('return forwarded', result === sentinel);
+        }
+        console.log('Test: createOrder forwards undefined options correctly');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            yield p.createOrder({ id: 'user-1' }, 'ORD-1');
+            assert('called once', log.length === 1);
+            assert('options arg is undefined', log[0].args[2] === undefined);
+        }
+        console.log('Test: amendOrder delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            const principal = { id: 'user-1' };
+            yield p.amendOrder(principal, 'ORD-1');
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'amendOrder');
+            assert('principal forwarded', log[0].args[0] === principal);
+            assert('orderId forwarded', log[0].args[1] === 'ORD-1');
+        }
+        console.log('Test: cancelOrder delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            yield p.cancelOrder('ORD-1', 'CUSTOMER_CHANGED_MIND');
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'cancelOrder');
+            assert('orderId forwarded', log[0].args[0] === 'ORD-1');
+            assert('reasonCode forwarded', log[0].args[1] === 'CUSTOMER_CHANGED_MIND');
+        }
+        console.log('Test: ceaseOrder delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            yield p.ceaseOrder('ORD-1', 'NET-SVC-1');
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'ceaseOrder');
+        }
+        console.log('Test: receiveKci delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            const principal = { id: 'user-1' };
+            const dto = { id: 'kci-1', sequenceNumber: 1 };
+            yield p.receiveKci(principal, dto);
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'receiveKci');
+            assert('args forwarded', log[0].args[0] === principal && log[0].args[1] === dto);
+        }
+        console.log('Test: syncWorkOrderToSupplier delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            const args = {
+                principal: { id: 'user-1' },
+                yfOrderId: 'ORD-1',
+                yfWorkOrderId: 'WO-1',
+                yfChangeReason: { externalId: 'CR-1', entity: 'ChangeReason', type: 'CANCEL', properties: {} },
+            };
+            yield p.syncWorkOrderToSupplier(args);
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'syncWorkOrderToSupplier');
+        }
+        console.log('Test: syncWorkOrderFromSupplier delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            const order = { id: 'ORD-1' };
+            const dto = { id: 'kci-1' };
+            yield p.syncWorkOrderFromSupplier(order, dto);
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'syncWorkOrderFromSupplier');
+        }
+        console.log('Test: retrieveServiceIdByUprn delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            const result = yield p.retrieveServiceIdByUprn(123);
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'retrieveServiceIdByUprn');
+            assert('return forwarded', result === 'NET-SVC-1');
+        }
+        console.log('Test: updateOrderExternalRef delegates to deps');
+        {
+            const { deps, log } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            yield p.updateOrderExternalRef({ oldYfId: 'OLD', newYfId: 'NEW' });
+            assert('called once', log.length === 1);
+            assert('correct method', log[0].method === 'updateOrderExternalRef');
+        }
+        // ── Inbound handler registration + dispatch ────────────────────────
         console.log('Test: onOrderNotification registers handler; dispatchOrderNotification fans out');
         {
-            const provider = new netomnia_provider_1.NetomniaProvider(buildDeps());
+            const { deps } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
             const received = [];
-            provider.onOrderNotification((n) => __awaiter(this, void 0, void 0, function* () {
+            p.onOrderNotification((n) => __awaiter(this, void 0, void 0, function* () {
                 received.push(n);
             }));
-            provider.onOrderNotification((n) => __awaiter(this, void 0, void 0, function* () {
+            p.onOrderNotification((n) => __awaiter(this, void 0, void 0, function* () {
                 received.push(n);
             }));
             const notif = {
@@ -188,15 +283,16 @@ function run() {
                 orderId: brand('OID1'),
                 payload: {},
             };
-            yield provider.dispatchOrderNotification(notif);
+            yield p.dispatchOrderNotification(notif);
             assert('both handlers fired', received.length === 2);
             assert('handler 1 received correct notif', received[0].orderId === notif.orderId);
         }
         console.log('Test: onSMRNotification registers handler; dispatchSMRNotification fans out');
         {
-            const provider = new netomnia_provider_1.NetomniaProvider(buildDeps());
+            const { deps } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
             const received = [];
-            provider.onSMRNotification((n) => __awaiter(this, void 0, void 0, function* () {
+            p.onSMRNotification((n) => __awaiter(this, void 0, void 0, function* () {
                 received.push(n);
             }));
             const notif = {
@@ -206,23 +302,24 @@ function run() {
                 requestId: brand('RID1'),
                 payload: {},
             };
-            yield provider.dispatchSMRNotification(notif);
+            yield p.dispatchSMRNotification(notif);
             assert('handler fired', received.length === 1);
         }
         console.log('Test: dispatchOrderNotification aggregates handler errors');
         {
-            const provider = new netomnia_provider_1.NetomniaProvider(buildDeps());
+            const { deps } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
             const callState = { secondCalled: false };
-            provider.onOrderNotification(() => __awaiter(this, void 0, void 0, function* () {
+            p.onOrderNotification(() => __awaiter(this, void 0, void 0, function* () {
                 throw new Error('handler 1 boom');
             }));
-            provider.onOrderNotification(() => __awaiter(this, void 0, void 0, function* () {
+            p.onOrderNotification(() => __awaiter(this, void 0, void 0, function* () {
                 callState.secondCalled = true;
                 throw new Error('handler 2 boom');
             }));
             let caught;
             try {
-                yield provider.dispatchOrderNotification({
+                yield p.dispatchOrderNotification({
                     notificationType: 'ordercompleted',
                     eventDateTime: brand('2026-05-09T00:00:00Z'),
                     transactionId: brand('tx-3'),
@@ -237,6 +334,12 @@ function run() {
             assert('aggregate error thrown', caught instanceof netomnia_provider_1.AggregateNotificationError);
             assert('2 underlying errors', caught instanceof netomnia_provider_1.AggregateNotificationError && caught.errors.length === 2);
         }
+        console.log('Test: NetomniaProvider implements WholesaleProvider (compile-time)');
+        {
+            const { deps } = buildDeps();
+            const p = new netomnia_provider_1.NetomniaProvider(deps);
+            assert('class instantiates', p instanceof netomnia_provider_1.NetomniaProvider);
+        }
         console.log('\n────────────────────────────────────────');
         console.log(`Tests: ${passed} passed, ${failed} failed`);
         if (failed > 0) {

package/package.json

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