@d19n/youfibre-odin-sdk 2.0.103-beta.17 → 2.0.103-beta.3

package/README.md

@@ -352,7 +352,7 @@ This SDK includes **164** entities across **12** modules.
 
 ## Actions
 
-This SDK includes **630** actions.
+This SDK includes **629** actions.
 
 ### Action Types
 
@@ -1116,7 +1116,6 @@ 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 |
-| `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/records-v2/CallLegRecord.d.ts

@@ -28,7 +28,6 @@ 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 { UpdateAgentCallLegOnIncomingCallRingingProperties } from '../actions-v2/UpdateAgentCallLegOnIncomingCallRingingDto';
 import { UpdateCallProperties } from '../actions-v2/UpdateCallDto';
 import { UpdateCustomerCallLegOnIncomingCallAnsweredProperties } from '../actions-v2/UpdateCustomerCallLegOnIncomingCallAnsweredDto';
 import { CallRecord } from './CallRecord';
@@ -352,32 +351,6 @@ export declare class CallLegRecord<TProps = CallLegProperties> {
         journeyId?: string;
         stageKey?: string;
     }): ActionBuilder;
-    /**
-     * UpdateAgentCallLegOnIncomingCallRinging
-     *
-     * Updates this CallLeg record with the specified properties.
-     * Returns an ActionBuilder - call .execute() to update or .dryRun() for debugging.
-     *
-     * @param properties - Required properties for this action
-     * @param options - Optional settings
-     * @param options.journeyId - Associate with a journey
-     * @param options.stageKey - Transition to pipeline stage
-     * @returns ActionBuilder - call .execute() to update or .dryRun() for payload
-     * @throws Error if called on a new (unsaved) record
-     *
-     * @example
-     * ```typescript
-     * const record = await odinClient.callLegs.get(id);
-     * await record.updateAgentCallLegOnIncomingCallRinging({ ... }).execute();
-     *
-     * // Dry run (for debugging)
-     * const payload = record.updateAgentCallLegOnIncomingCallRinging({ ... }).dryRun();
-     * ```
-     */
-    updateAgentCallLegOnIncomingCallRinging(properties: UpdateAgentCallLegOnIncomingCallRingingProperties, options?: {
-        journeyId?: string;
-        stageKey?: string;
-    }): ActionBuilder;
     /**
      * UpdateCall
      *

package/dist/records-v2/CallLegRecord.js

@@ -454,35 +454,6 @@ class CallLegRecord {
         const payload = Object.assign({ id: this._record.id, entity: this._record.entity, type: this._record.type, actionName: 'UpdateAgentCallLegOnIncomingCallCompleted', properties, associations: this._pendingLinks.length > 0 ? this._pendingLinks : undefined }, options);
         return new ActionBuilder(this._provider, 'NotificationModule', 'CallLeg', payload, () => { this._pendingLinks = []; });
     }
-    /**
-     * UpdateAgentCallLegOnIncomingCallRinging
-     *
-     * Updates this CallLeg record with the specified properties.
-     * Returns an ActionBuilder - call .execute() to update or .dryRun() for debugging.
-     *
-     * @param properties - Required properties for this action
-     * @param options - Optional settings
-     * @param options.journeyId - Associate with a journey
-     * @param options.stageKey - Transition to pipeline stage
-     * @returns ActionBuilder - call .execute() to update or .dryRun() for payload
-     * @throws Error if called on a new (unsaved) record
-     *
-     * @example
-     * ```typescript
-     * const record = await odinClient.callLegs.get(id);
-     * await record.updateAgentCallLegOnIncomingCallRinging({ ... }).execute();
-     *
-     * // Dry run (for debugging)
-     * const payload = record.updateAgentCallLegOnIncomingCallRinging({ ... }).dryRun();
-     * ```
-     */
-    updateAgentCallLegOnIncomingCallRinging(properties, options) {
-        var _a;
-        if (!((_a = this._record) === null || _a === void 0 ? void 0 : _a.id))
-            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 = []; });
-    }
     /**
      * UpdateCall
      *

package/package.json

@@ -1,33 +1,11 @@
 {
   "name": "@d19n/youfibre-odin-sdk",
-  "version": "2.0.103-beta.17",
+  "version": "2.0.103-beta.3",
   "description": "",
   "author": "@d19n",
   "license": "UNLICENSED",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "require": "./dist/index.js",
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./wholesale-provider": {
-      "require": "./dist/wholesale-provider/index.js",
-      "import": "./dist/wholesale-provider/index.js",
-      "types": "./dist/wholesale-provider/index.d.ts"
-    },
-    "./dist/wholesale-provider": {
-      "require": "./dist/wholesale-provider/index.js",
-      "import": "./dist/wholesale-provider/index.js",
-      "types": "./dist/wholesale-provider/index.d.ts"
-    },
-    "./dist/*": {
-      "require": "./dist/*.js",
-      "import": "./dist/*.js",
-      "types": "./dist/*.d.ts"
-    }
-  },
   "devDependencies": {
     "ts-node": "^10.9.2",
     "typescript": "4.8.4"
@@ -37,9 +15,8 @@
     "@d19n/odin-types": "^3.0.41"
   },
   "scripts": {
-    "test:wholesale-provider": "npx --yes tsx src/wholesale-provider/test/netomnia-provider.spec.ts && npx --yes tsx src/wholesale-provider/test/kci-effect-bridge.spec.ts",
-    "release:beta": "git pull --ff-only && rm -rf dist && tsc && npm version prerelease --preid=beta && git push && npm publish --tag beta",
-    "release:prod": "git pull --ff-only && rm -rf dist && tsc && npm version patch && git push && npm publish --tag latest"
+    "release:beta": "rm -rf dist && tsc && npm version prerelease --preid=beta && git push && npm publish --tag beta",
+    "release:prod": "rm -rf dist && tsc && npm version patch && git push && npm publish --tag latest"
   },
   "files": [
     "dist",

package/dist/actions-v2/UpdateAgentCallLegOnIncomingCallRingingDto.d.ts

@@ -1,81 +0,0 @@
-/**
- * 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
- */
-import { OdinRecord, OdinRecordUpdateDto, OdinRecordUpdatedEvent } from '@d19n/odin-types/dist/core';
-/**
- * RabbitMQ message payload for UpdateAgentCallLegOnIncomingCallRinging updated events
- *
- * @event k1.t-hEOJjsDb.NotificationModule.CallLeg.Update.UpdateAgentCallLegOnIncomingCallRinging
- */
-export interface UpdateAgentCallLegOnIncomingCallRingingMessage extends OdinRecordUpdatedEvent<UpdateAgentCallLegOnIncomingCallRingingDto, UpdateAgentCallLegOnIncomingCallRingingProperties> {
-}
-/**
- * Properties for UpdateAgentCallLegOnIncomingCallRinging action
- *
- * @property Required fields: 2
- * @property Optional fields: 0
- */
-export interface UpdateAgentCallLegOnIncomingCallRingingProperties {
-    /**
-     * RingingAt
-     *
-     * Data field for CallLeg records. Used by Communications team.
-     * @type {DATE_TIME}
-     * @required
-     */
-    RingingAt: string;
-    /**
-     * Status
-     *
-     * Status indicator for CallLeg records. Tracks lifecycle state. Used by Communications team.
-     * @type {ENUM}
-     * @required
-     */
-    Status: string;
-}
-/**
- * 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
- */
-export declare class UpdateAgentCallLegOnIncomingCallRingingDto extends OdinRecordUpdateDto<UpdateAgentCallLegOnIncomingCallRingingProperties> {
-    /** Used by SDK generators to identify action type */
-    static readonly ACTION_TYPE = "UPDATE";
-    static readonly ACTION_KEY = "UpdateAgentCallLegOnIncomingCallRinging";
-    static readonly MODULE_NAME = "NotificationModule";
-    static readonly ENTITIES: string[];
-    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 = "a16ff881-91e5-449d-b5e2-c9556dd2e850";
-    static readonly AUTO_LINK_PARENT = false;
-    readonly actionName: string;
-    readonly schemaActionId: string;
-    readonly entity: string;
-    constructor(record: OdinRecord<any> | {
-        id: string;
-        entity: string;
-        type?: string;
-    }, properties: UpdateAgentCallLegOnIncomingCallRingingProperties, options?: {
-        journeyId?: string;
-        stageKey?: string;
-    });
-}

package/dist/actions-v2/UpdateAgentCallLegOnIncomingCallRingingDto.js

@@ -1,56 +0,0 @@
-"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/wholesale-provider/index.d.ts

@@ -1,35 +0,0 @@
-/**
- * Wholesale provider — subpath barrel.
- *
- * Consumers import from `@d19n/youfibre-odin-sdk/dist/wholesale-provider`:
- *
- *   ```ts
- *   import {
- *     WholesaleProvider,
- *     NetomniaProvider,
- *     NetomniaProviderDeps,
- *   } from '@d19n/youfibre-odin-sdk/dist/wholesale-provider';
- *   ```
- *
- * **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 / T-20260508-010
- */
-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 { NetomniaProvider, AggregateNotificationError } from './providers/netomnia-provider';
-export type { NetomniaProviderDeps } from './providers/netomnia-provider';
-export { KCI_EFFECT_ROWS, decideKciDispatch, detectKciKind, } from './kci-effect-bridge';
-export type { KciServiceOrderKind, YfWoComposedActionKey, YfKciEffectKind, YfKciTargetEntity, YfKciEffect, KciEffectRow, KciDispatchDecision, } from './kci-effect-bridge';
-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

@@ -1,64 +0,0 @@
-"use strict";
-/**
- * Wholesale provider — subpath barrel.
- *
- * Consumers import from `@d19n/youfibre-odin-sdk/dist/wholesale-provider`:
- *
- *   ```ts
- *   import {
- *     WholesaleProvider,
- *     NetomniaProvider,
- *     NetomniaProviderDeps,
- *   } from '@d19n/youfibre-odin-sdk/dist/wholesale-provider';
- *   ```
- *
- * **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 / 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.detectKciKind = exports.decideKciDispatch = exports.KCI_EFFECT_ROWS = 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; } });
-// ── KCI effect bridge (canonical typed catalog + walker) ──────────────
-var kci_effect_bridge_1 = require("./kci-effect-bridge");
-Object.defineProperty(exports, "KCI_EFFECT_ROWS", { enumerable: true, get: function () { return kci_effect_bridge_1.KCI_EFFECT_ROWS; } });
-Object.defineProperty(exports, "decideKciDispatch", { enumerable: true, get: function () { return kci_effect_bridge_1.decideKciDispatch; } });
-Object.defineProperty(exports, "detectKciKind", { enumerable: true, get: function () { return kci_effect_bridge_1.detectKciKind; } });
-// ── 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,176 +0,0 @@
-/**
- * WholesaleProvider — strategy-dispatchable interface for wholesale supplier
- * integrations (Netomnia today, VMO2 from July 2026).
- *
- * **Architecture (T-20260508-009/010 — confirmed with Frank 2026-05-09 as
- * "Path B / first step"):**
- *
- * Methods take YF-context arguments (orderId, principal, etc.) — matching
- * the existing NET module method signatures. Each provider implementation
- * builds the supplier-specific wire request internally from this YF context.
- *
- * Rationale:
- *   - Existing NET module methods take YF context, not wire DTOs. The SDK
- *     provider abstracts the supplier dispatch layer, not the DTO-building.
- *   - Method names align with VMO2 spec where it makes sense (`createOrder`,
- *     `cancelOrder`, etc.) so call-site vocabulary doesn't change when the
- *     provider switches.
- *   - When VMO2 ships, Vmo2Provider implements the same method names with
- *     args that may differ slightly. Frank's framing: "we adjust function
- *     arguments, nothing beyond that — we map X to Y and get the same result."
- *
- * **Trade-off accepted:** the interface is shaped after NET reality, not
- * VMO2. That keeps Phase 0 a strict drop-in replacement. We can standardize
- * args further once VMO2 ships if a tighter cross-provider abstraction
- * proves valuable.
- *
- * **Type pragmatics:** principal/options/return values use `unknown` /
- * `Record<string, unknown>` so the SDK doesn't need to depend on
- * NestJS-decorated entity types. Modules cast at the wiring boundary (where
- * full types are available).
- */
-import type { VMO2OrderNotification, VMO2SMRNotification } from './types/vmo2';
-import type { FibreCafeServiceAvailability200, FibreCafeAvailableAppointments200, FibreCafeReserveAppointment201, FibreCafeScheduleServiceWorkOrder201, FibreCafeRescheduleServiceWorkOrder200, FibreCafeOrderCreate202, FibreCafeOrderAmendAccept202, FibreCafeKciDto } from './types/fibrecafe';
-import type { OrderRecord } from '../records-v2/OrderRecord';
-/**
- * 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;
-    };
-    flow: 'FIRST_TIME_BOOKING' | 'RESCHEDULE';
-}
-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<TPrincipal = unknown> {
-    principal: TPrincipal;
-    yfOrderId: string;
-    yfWorkOrderId: string;
-    yfChangeReason: {
-        id?: string;
-        externalId: string;
-        entity: string;
-        type: unknown;
-        properties: unknown;
-    };
-    yfServiceAppointment: {
-        id?: 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.
- *
- * Returns are typed loosely — modules know the return shape via the dep
- * function they wire in.
- */
-/**
- * Generic in `TPrincipal` so call sites get full typing on the user/org
- * principal that NestJS injects via the `@Principal()` decorator. Modules
- * specialize at the wiring boundary:
- *
- * ```ts
- * class WholesaleProviderFactory {
- *   constructor(@Inject(...) private netomnia: WholesaleProvider<OrganizationUserEntity>) {}
- *   get(...): WholesaleProvider<OrganizationUserEntity> { ... }
- * }
- * ```
- *
- * `FibreCafeKciDto` is fixed as the inbound KCI envelope — that's the
- * canonical wire shape Netomnia sends (per the FibreCafe Tenant Updates
- * spec). Modules consuming the SDK should consolidate any local KCI type
- * to alias `FibreCafeKciDto` rather than maintain a duplicate.
- *
- * Default `TPrincipal = unknown` lets the SDK compile standalone without
- * tenant-specific type imports.
- */
-export interface WholesaleProvider<TPrincipal = unknown> {
-    searchAddress(uprn: number): Promise<FibreCafeServiceAvailability200>;
-    listAppointments(args: ListAppointmentsArgs): Promise<FibreCafeAvailableAppointments200>;
-    reserveAppointment(args: ReserveAppointmentArgs): Promise<FibreCafeReserveAppointment201>;
-    scheduleServiceWorkOrder(args: ScheduleServiceWorkOrderArgs): Promise<FibreCafeScheduleServiceWorkOrder201>;
-    rescheduleServiceWorkOrder(args: RescheduleServiceWorkOrderArgs): Promise<FibreCafeRescheduleServiceWorkOrder200>;
-    amendAppointment(args: AmendAppointmentArgs): Promise<FibreCafeOrderAmendAccept202>;
-    /**
-     * Sold→Supply dispatch. Existing NET impl returns void after async dispatch
-     * (the actual order acknowledgement arrives later as an inbound KCI).
-     */
-    createOrder(principal: TPrincipal, orderId: string, options?: CreateOrderOptions): Promise<void>;
-    /** Tier-change CoS — wraps `createModifyOrderForYfOrder` style args. Returns null when already at target SKU. */
-    amendOrder(principal: TPrincipal, yfOrderId: string): Promise<FibreCafeOrderCreate202 | null>;
-    /** Pre-install cancel of an in-flight provide order. */
-    cancelOrder(yfOrderId: string, reasonCode: CancellationReasonCode): Promise<FibreCafeOrderCreate202>;
-    /** Active-customer cease (post-Active churn / OTS-losing). */
-    ceaseOrder(yfOrderId: string, serviceId: string): Promise<FibreCafeOrderCreate202>;
-    /** Inbound supplier KCI / notification handler. */
-    receiveKci(principal: TPrincipal, dto: FibreCafeKciDto): Promise<void>;
-    /** Outbound YF→supplier WO sync (cancel propagation, etc.). */
-    syncWorkOrderToSupplier(args: SyncWorkOrderToSupplierArgs<TPrincipal>): Promise<void>;
-    /** Inbound supplier→YF WO change application (post-receiveKci). */
-    syncWorkOrderFromSupplier(order: OrderRecord, dto: FibreCafeKciDto): Promise<void>;
-    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/interface.js

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