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

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

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

package/dist/wholesale-provider/index.js

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

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

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

package/dist/wholesale-provider/interface.js

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

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

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

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

@@ -0,0 +1,197 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+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;
+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');
+        });
+    }
+    // ──────────────────────────────────────────────────────────────────
+    //  Appointments
+    // ──────────────────────────────────────────────────────────────────
+    listAppointments(_req) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new NotImplementedError('listAppointments');
+        });
+    }
+    reserveAppointment(_req) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new NotImplementedError('reserveAppointment');
+        });
+    }
+    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');
+        });
+    }
+    getAppointment(_key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new NotImplementedError('getAppointment');
+        });
+    }
+    amendAppointment(_key, _patch) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new NotImplementedError('amendAppointment');
+        });
+    }
+    cancelAppointment(_key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new NotImplementedError('cancelAppointment');
+        });
+    }
+    // ──────────────────────────────────────────────────────────────────
+    //  Orders
+    // ──────────────────────────────────────────────────────────────────
+    createOrder(_req) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new NotImplementedError('createOrder');
+        });
+    }
+    amendOrder(_orderId, _patch) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new NotImplementedError('amendOrder');
+        });
+    }
+    cancelOrder(_orderId, _reason) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new NotImplementedError('cancelOrder');
+        });
+    }
+    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');
+        });
+    }
+    // ──────────────────────────────────────────────────────────────────
+    //  Service Management
+    // ──────────────────────────────────────────────────────────────────
+    createIncident(_req) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new NotImplementedError('createIncident');
+        });
+    }
+    amendIncident(_requestId, _patch) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new NotImplementedError('amendIncident');
+        });
+    }
+    cancelIncident(_requestId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new NotImplementedError('cancelIncident');
+        });
+    }
+    getIncident(_requestId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new NotImplementedError('getIncident');
+        });
+    }
+    // ──────────────────────────────────────────────────────────────────
+    //  Inbound notification subscription
+    // ──────────────────────────────────────────────────────────────────
+    onOrderNotification(handler) {
+        this.orderHandlers.push(handler);
+    }
+    onSMRNotification(handler) {
+        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.
+     */
+    dispatchOrderNotification(n) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const errors = [];
+            for (const h of this.orderHandlers) {
+                try {
+                    yield h(n);
+                }
+                catch (err) {
+                    errors.push(err);
+                }
+            }
+            if (errors.length > 0) {
+                throw new AggregateNotificationError(errors);
+            }
+        });
+    }
+    dispatchSMRNotification(n) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const errors = [];
+            for (const h of this.smrHandlers) {
+                try {
+                    yield h(n);
+                }
+                catch (err) {
+                    errors.push(err);
+                }
+            }
+            if (errors.length > 0) {
+                throw new AggregateNotificationError(errors);
+            }
+        });
+    }
+}
+exports.NetomniaProvider = NetomniaProvider;
+/**
+ * Aggregates errors thrown by handlers during notification dispatch so the
+ * webhook controller can surface every failure rather than masking later
+ * handlers with the first throw.
+ */
+class AggregateNotificationError extends Error {
+    constructor(errors) {
+        super(`${errors.length} handler error(s) during notification dispatch`);
+        this.errors = errors;
+        this.name = 'AggregateNotificationError';
+    }
+}
+exports.AggregateNotificationError = AggregateNotificationError;

package/dist/wholesale-provider/test/netomnia-provider.spec.d.ts

@@ -0,0 +1 @@
+export {};