@voyant-travel/charters 0.117.2

package/dist/adapters/mock.d.ts

@@ -0,0 +1,50 @@
+/**
+ * In-memory CharterAdapter for tests and templates that need a working
+ * external source without a real upstream.
+ *
+ * Seed via the `add*` / `set*` methods; queries against the seeded data work
+ * exactly like a real adapter would. Booking commits return synthesized
+ * confirmation refs and increment per-instance counters.
+ */
+import type { CharterAdapter, CreateExternalPerSuiteBookingInput, CreateExternalWholeYachtBookingInput, ExternalBookingResult, ExternalCharterProduct, ExternalCharterScheduleDay, ExternalCharterSuite, ExternalCharterVoyage, ExternalCharterYacht, ListEntriesOptions, ListEntriesResult, SourceRef } from "./index.js";
+export type MockCharterAdapterOptions = {
+    name?: string;
+    version?: string;
+    /** Auto-fail every nth call to surface upstream-error handling in tests. */
+    failEveryNthCall?: number;
+};
+export declare class MockCharterAdapter implements CharterAdapter {
+    readonly name: string;
+    readonly version: string;
+    private readonly productsByRef;
+    private readonly yachtsByRef;
+    private readonly perSuiteBookingResults;
+    private readonly wholeYachtBookingResults;
+    callCount: number;
+    perSuiteBookingCount: number;
+    wholeYachtBookingCount: number;
+    private readonly failEveryNthCall;
+    constructor(options?: MockCharterAdapterOptions);
+    addProduct(product: ExternalCharterProduct, voyages?: ExternalCharterVoyage[]): void;
+    addVoyage(productRef: SourceRef, voyage: ExternalCharterVoyage): void;
+    addYacht(yacht: ExternalCharterYacht): void;
+    setVoyageSuites(voyageRef: SourceRef, suites: ExternalCharterSuite[]): void;
+    setVoyageSchedule(voyageRef: SourceRef, days: ExternalCharterScheduleDay[]): void;
+    /** Pre-program a per-suite booking response for the next matching commit. */
+    setPerSuiteBookingResult(voyageRef: SourceRef, suiteRef: SourceRef, result: ExternalBookingResult): void;
+    /** Pre-program a whole-yacht booking response for the next matching commit. */
+    setWholeYachtBookingResult(voyageRef: SourceRef, result: ExternalBookingResult): void;
+    private tickAndCheck;
+    private resolveYachtName;
+    private lowestSuitePriceFor;
+    listEntries(options?: ListEntriesOptions): Promise<ListEntriesResult>;
+    fetchProduct(ref: SourceRef): Promise<ExternalCharterProduct | null>;
+    fetchVoyage(ref: SourceRef): Promise<ExternalCharterVoyage | null>;
+    fetchVoyageSuites(ref: SourceRef): Promise<ExternalCharterSuite[]>;
+    fetchVoyageSchedule(ref: SourceRef): Promise<ExternalCharterScheduleDay[]>;
+    fetchYacht(ref: SourceRef): Promise<ExternalCharterYacht | null>;
+    listVoyagesForProduct(productRef: SourceRef): Promise<ExternalCharterVoyage[]>;
+    createPerSuiteBooking(input: CreateExternalPerSuiteBookingInput): Promise<ExternalBookingResult>;
+    createWholeYachtBooking(input: CreateExternalWholeYachtBookingInput): Promise<ExternalBookingResult>;
+}
+//# sourceMappingURL=mock.d.ts.map

package/dist/adapters/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/adapters/mock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,kCAAkC,EAClC,oCAAoC,EACpC,qBAAqB,EACrB,sBAAsB,EAEtB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACV,MAAM,YAAY,CAAA;AAEnB,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAaD,qBAAa,kBAAmB,YAAW,cAAc;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmC;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;IACtE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAA2C;IAClF,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA2C;IAGpF,SAAS,SAAI;IACb,oBAAoB,SAAI;IACxB,sBAAsB,SAAI;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;gBAE7B,OAAO,GAAE,yBAA8B;IAQnD,UAAU,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,GAAE,qBAAqB,EAAO,GAAG,IAAI;IAUxF,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAMrE,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAI3C,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,GAAG,IAAI;IAW3E,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,0BAA0B,EAAE,GAAG,IAAI;IAWjF,6EAA6E;IAC7E,wBAAwB,CACtB,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,qBAAqB,GAC5B,IAAI;IAIP,+EAA+E;IAC/E,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAMrF,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,mBAAmB;IAiBrB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4BzE,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAKpE,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IASlE,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IASlE,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;IAS1E,UAAU,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAKhE,qBAAqB,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAK9E,qBAAqB,CACzB,KAAK,EAAE,kCAAkC,GACxC,OAAO,CAAC,qBAAqB,CAAC;IAa3B,uBAAuB,CAC3B,KAAK,EAAE,oCAAoC,GAC1C,OAAO,CAAC,qBAAqB,CAAC;CAUlC"}

package/dist/adapters/mock.js

@@ -0,0 +1,194 @@
+/**
+ * In-memory CharterAdapter for tests and templates that need a working
+ * external source without a real upstream.
+ *
+ * Seed via the `add*` / `set*` methods; queries against the seeded data work
+ * exactly like a real adapter would. Booking commits return synthesized
+ * confirmation refs and increment per-instance counters.
+ */
+function refKey(ref) {
+    return `${ref.connectionId ?? "_"}|${ref.externalId}`;
+}
+export class MockCharterAdapter {
+    name;
+    version;
+    productsByRef = new Map();
+    yachtsByRef = new Map();
+    perSuiteBookingResults = new Map();
+    wholeYachtBookingResults = new Map();
+    // Telemetry — useful for assertions in tests.
+    callCount = 0;
+    perSuiteBookingCount = 0;
+    wholeYachtBookingCount = 0;
+    failEveryNthCall;
+    constructor(options = {}) {
+        this.name = options.name ?? "mock-charter";
+        this.version = options.version ?? "1.0.0";
+        this.failEveryNthCall = options.failEveryNthCall ?? 0;
+    }
+    // ---------- seeders ----------
+    addProduct(product, voyages = []) {
+        const key = refKey(product.sourceRef);
+        this.productsByRef.set(key, {
+            product,
+            voyages: [...voyages],
+            suitesByVoyage: new Map(),
+            scheduleByVoyage: new Map(),
+        });
+    }
+    addVoyage(productRef, voyage) {
+        const seeded = this.productsByRef.get(refKey(productRef));
+        if (!seeded)
+            throw new Error(`MockCharterAdapter: product ${productRef.externalId} not seeded`);
+        seeded.voyages.push(voyage);
+    }
+    addYacht(yacht) {
+        this.yachtsByRef.set(refKey(yacht.sourceRef), yacht);
+    }
+    setVoyageSuites(voyageRef, suites) {
+        for (const seeded of this.productsByRef.values()) {
+            const match = seeded.voyages.find((v) => refKey(v.sourceRef) === refKey(voyageRef));
+            if (match) {
+                seeded.suitesByVoyage.set(refKey(voyageRef), suites);
+                return;
+            }
+        }
+        throw new Error(`MockCharterAdapter: voyage ${voyageRef.externalId} not seeded`);
+    }
+    setVoyageSchedule(voyageRef, days) {
+        for (const seeded of this.productsByRef.values()) {
+            const match = seeded.voyages.find((v) => refKey(v.sourceRef) === refKey(voyageRef));
+            if (match) {
+                seeded.scheduleByVoyage.set(refKey(voyageRef), days);
+                return;
+            }
+        }
+        throw new Error(`MockCharterAdapter: voyage ${voyageRef.externalId} not seeded`);
+    }
+    /** Pre-program a per-suite booking response for the next matching commit. */
+    setPerSuiteBookingResult(voyageRef, suiteRef, result) {
+        this.perSuiteBookingResults.set(`${refKey(voyageRef)}::${refKey(suiteRef)}`, result);
+    }
+    /** Pre-program a whole-yacht booking response for the next matching commit. */
+    setWholeYachtBookingResult(voyageRef, result) {
+        this.wholeYachtBookingResults.set(refKey(voyageRef), result);
+    }
+    // ---------- contract implementation ----------
+    tickAndCheck() {
+        this.callCount++;
+        if (this.failEveryNthCall > 0 && this.callCount % this.failEveryNthCall === 0) {
+            throw new Error(`MockCharterAdapter forced failure on call #${this.callCount}`);
+        }
+    }
+    resolveYachtName(yachtRef) {
+        return this.yachtsByRef.get(refKey(yachtRef))?.name ?? null;
+    }
+    lowestSuitePriceFor(productKey, currency) {
+        const seeded = this.productsByRef.get(productKey);
+        if (!seeded)
+            return null;
+        let lowest = null;
+        for (const voyage of seeded.voyages) {
+            const suites = seeded.suitesByVoyage.get(refKey(voyage.sourceRef)) ?? [];
+            for (const suite of suites) {
+                const amount = suite.pricesByCurrency?.[currency];
+                if (!amount)
+                    continue;
+                const value = Number.parseFloat(amount);
+                if (!Number.isFinite(value))
+                    continue;
+                if (lowest === null || value < lowest)
+                    lowest = value;
+            }
+        }
+        return lowest === null ? null : lowest.toFixed(2);
+    }
+    async listEntries(options = {}) {
+        this.tickAndCheck();
+        const limit = options.limit ?? 50;
+        const all = [];
+        for (const [key, seeded] of this.productsByRef.entries()) {
+            const sortedDates = seeded.voyages.map((v) => v.departureDate).sort();
+            // Mock browse currency is USD by default; real adapters can publish
+            // any currency the operator markets in.
+            const browseCurrency = "USD";
+            const lowest = this.lowestSuitePriceFor(key, browseCurrency);
+            all.push({
+                sourceRef: seeded.product.sourceRef,
+                name: seeded.product.name,
+                slug: seeded.product.slug,
+                lineName: seeded.product.lineName,
+                yachtName: seeded.product.defaultYachtRef
+                    ? this.resolveYachtName(seeded.product.defaultYachtRef)
+                    : null,
+                earliestVoyage: sortedDates.at(0) ?? null,
+                latestVoyage: sortedDates.at(-1) ?? null,
+                lowestPriceAmount: lowest,
+                lowestPriceCurrency: lowest ? browseCurrency : null,
+                heroImageUrl: seeded.product.heroImageUrl ?? null,
+            });
+        }
+        return { entries: all.slice(0, limit) };
+    }
+    async fetchProduct(ref) {
+        this.tickAndCheck();
+        return this.productsByRef.get(refKey(ref))?.product ?? null;
+    }
+    async fetchVoyage(ref) {
+        this.tickAndCheck();
+        for (const seeded of this.productsByRef.values()) {
+            const match = seeded.voyages.find((v) => refKey(v.sourceRef) === refKey(ref));
+            if (match)
+                return match;
+        }
+        return null;
+    }
+    async fetchVoyageSuites(ref) {
+        this.tickAndCheck();
+        for (const seeded of this.productsByRef.values()) {
+            const suites = seeded.suitesByVoyage.get(refKey(ref));
+            if (suites)
+                return suites;
+        }
+        return [];
+    }
+    async fetchVoyageSchedule(ref) {
+        this.tickAndCheck();
+        for (const seeded of this.productsByRef.values()) {
+            const days = seeded.scheduleByVoyage.get(refKey(ref));
+            if (days)
+                return days;
+        }
+        return [];
+    }
+    async fetchYacht(ref) {
+        this.tickAndCheck();
+        return this.yachtsByRef.get(refKey(ref)) ?? null;
+    }
+    async listVoyagesForProduct(productRef) {
+        this.tickAndCheck();
+        return this.productsByRef.get(refKey(productRef))?.voyages ?? [];
+    }
+    async createPerSuiteBooking(input) {
+        this.tickAndCheck();
+        this.perSuiteBookingCount++;
+        const programmed = this.perSuiteBookingResults.get(`${refKey(input.voyageRef)}::${refKey(input.suiteRef)}`);
+        if (programmed)
+            return programmed;
+        return {
+            connectorBookingRef: `MOCK-CHT-${this.perSuiteBookingCount.toString().padStart(6, "0")}`,
+            connectorStatus: "confirmed",
+        };
+    }
+    async createWholeYachtBooking(input) {
+        this.tickAndCheck();
+        this.wholeYachtBookingCount++;
+        const programmed = this.wholeYachtBookingResults.get(refKey(input.voyageRef));
+        if (programmed)
+            return programmed;
+        return {
+            connectorBookingRef: `MOCK-WYC-${this.wholeYachtBookingCount.toString().padStart(6, "0")}`,
+            connectorStatus: "confirmed",
+        };
+    }
+}

package/dist/adapters/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Process-local registry of charter adapters.
+ *
+ * Templates register adapters at app startup:
+ *
+ *   import { createConnectCharterAdapter } from "@voyant-travel/charters-adapter-connect"
+ *   registerCharterAdapter(createConnectCharterAdapter({ apiKey: env.VOYANT_CONNECT_API_KEY }))
+ *
+ * The route layer resolves an adapter by `sourceProvider` (the prefix in the
+ * unified key `<provider>:<ref>`) before dispatching detail reads or external
+ * booking commits.
+ *
+ * The registry is intentionally a plain Map. There's no per-tenant scoping —
+ * each Voyant deployment is single-tenant. Tests reset state via
+ * `clearCharterAdapters()`.
+ */
+import type { CharterAdapter } from "./index.js";
+export declare function registerCharterAdapter(adapter: CharterAdapter): void;
+export declare function unregisterCharterAdapter(name: string): boolean;
+export declare function clearCharterAdapters(): void;
+export declare function resolveCharterAdapter(name: string): CharterAdapter | undefined;
+export declare function listCharterAdapters(): CharterAdapter[];
+export declare function hasCharterAdapter(name: string): boolean;
+//# sourceMappingURL=registry.d.ts.map

package/dist/adapters/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/adapters/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAIhD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAQpE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE9E;AAED,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAEtD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/adapters/registry.js

@@ -0,0 +1,40 @@
+/**
+ * Process-local registry of charter adapters.
+ *
+ * Templates register adapters at app startup:
+ *
+ *   import { createConnectCharterAdapter } from "@voyant-travel/charters-adapter-connect"
+ *   registerCharterAdapter(createConnectCharterAdapter({ apiKey: env.VOYANT_CONNECT_API_KEY }))
+ *
+ * The route layer resolves an adapter by `sourceProvider` (the prefix in the
+ * unified key `<provider>:<ref>`) before dispatching detail reads or external
+ * booking commits.
+ *
+ * The registry is intentionally a plain Map. There's no per-tenant scoping —
+ * each Voyant deployment is single-tenant. Tests reset state via
+ * `clearCharterAdapters()`.
+ */
+const adapters = new Map();
+export function registerCharterAdapter(adapter) {
+    if (!adapter.name)
+        throw new Error("Adapter must have a non-empty name");
+    if (adapters.has(adapter.name)) {
+        throw new Error(`Charter adapter '${adapter.name}' is already registered; call unregisterCharterAdapter first if you intend to replace it`);
+    }
+    adapters.set(adapter.name, adapter);
+}
+export function unregisterCharterAdapter(name) {
+    return adapters.delete(name);
+}
+export function clearCharterAdapters() {
+    adapters.clear();
+}
+export function resolveCharterAdapter(name) {
+    return adapters.get(name);
+}
+export function listCharterAdapters() {
+    return Array.from(adapters.values());
+}
+export function hasCharterAdapter(name) {
+    return adapters.has(name);
+}