@voyant-travel/trips 0.111.1 → 0.113.0

package/dist/catalog-component.d.ts

@@ -0,0 +1,63 @@
+import { type CancelEntityResult, type OwnedBookingHandlerRegistry, type QuoteEntityDeps, type QuoteEntityResult, type QuoteResponseV1, type SourceAdapterRegistry } from "@voyant-travel/catalog/booking-engine";
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import type { CancelComponentInput, CancelComponentResult, CatalogComponentQuoteInput, ComponentCancellationPreview, ComponentCancellationPreviewInput, ComponentCheckoutInput, ComponentCheckoutResult, ReleaseReservedComponentInput, ReleaseReservedComponentResult, ReserveComponentInput, ReserveComponentResult } from "./service-types.js";
+/** Per-request adapter context propagated to the catalog source adapters. */
+export interface CatalogAdapterContext {
+    connection_id: string;
+    correlation_id: string;
+}
+/** Deployment-specific checkout hand-off for a reserved component. */
+export type StartComponentCheckout = (input: ComponentCheckoutInput) => Promise<ComponentCheckoutResult>;
+/**
+ * Deployment-supplied, request-scoped readers + registries for the catalog
+ * component adapter. These cross the boundaries trips must not import
+ * statically (process-local registries, commerce promotions, the deployment's
+ * tax recompute + checkout wiring) and so are injected.
+ */
+export interface CatalogComponentAdapterOptions {
+    /** The per-request drizzle handle. */
+    db: AnyDrizzleDb;
+    /** Process-local source-adapter registry (deployment-assembled). */
+    registry: SourceAdapterRegistry;
+    /** Process-local owned-handler registry (deployment-assembled). */
+    ownedHandlers: OwnedBookingHandlerRegistry;
+    /**
+     * Promotion evaluator for the quote path. Injected because
+     * `createCatalogPromotionEvaluator` lives in commerce, which transitively
+     * (optionally) depends on quotes → trips.
+     */
+    evaluatePromotions: QuoteEntityDeps["evaluatePromotions"];
+    /**
+     * Customer-facing tax recompute applied to a quote result. Injected because
+     * the deployment resolves its own tax settings (a deployment reader) and the
+     * transform is shared with the catalog-booking route module.
+     */
+    transformQuoteResult: (result: QuoteEntityResult, entityModule: string, entityId: string, sourceKind: string) => Promise<QuoteEntityResult>;
+    /** Builds the per-request adapter context (correlation id, connection id). */
+    adapterContext: (connectionId: string | null | undefined) => CatalogAdapterContext;
+    /** Deployment-specific checkout hand-off (payment-provider wiring). */
+    startCheckout: StartComponentCheckout;
+}
+/** The catalog component orchestration surface produced by the factory. */
+export interface CatalogComponentAdapter {
+    quote(input: CatalogComponentQuoteInput): Promise<QuoteResponseV1>;
+    reserve(input: ReserveComponentInput): Promise<ReserveComponentResult>;
+    release(input: ReleaseReservedComponentInput): Promise<ReleaseReservedComponentResult>;
+    previewCancellation(input: ComponentCancellationPreviewInput): Promise<ComponentCancellationPreview>;
+    cancel(input: CancelComponentInput): Promise<CancelComponentResult>;
+    startCheckout(input: ComponentCheckoutInput): Promise<ComponentCheckoutResult>;
+}
+/**
+ * Build the catalog-backed trip-component orchestration bound to a request's
+ * db + deployment registries/readers.
+ */
+export declare function createCatalogComponentAdapter(options: CatalogComponentAdapterOptions): CatalogComponentAdapter;
+/**
+ * Pure catalog-component cancellation preview. Has no db / registry reads —
+ * supplier cancellation previews aren't available, so the cancellation result
+ * itself is authoritative. Exported standalone so deployments can preview
+ * without constructing a request-scoped adapter.
+ */
+export declare function previewCancellation(input: ComponentCancellationPreviewInput): Promise<ComponentCancellationPreview>;
+export type { CancelEntityResult };
+//# sourceMappingURL=catalog-component.d.ts.map

package/dist/catalog-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-component.d.ts","sourceRoot":"","sources":["../src/catalog-component.ts"],"names":[],"mappings":"AAsCA,OAAO,EAKL,KAAK,kBAAkB,EAEvB,KAAK,2BAA2B,EAEhC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAGpB,KAAK,qBAAqB,EAC3B,MAAM,uCAAuC,CAAA;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,iCAAiC,EACjC,sBAAsB,EACtB,uBAAuB,EACvB,6BAA6B,EAC7B,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,oBAAoB,CAAA;AAE3B,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,sEAAsE;AACtE,MAAM,MAAM,sBAAsB,GAAG,CACnC,KAAK,EAAE,sBAAsB,KAC1B,OAAO,CAAC,uBAAuB,CAAC,CAAA;AAErC;;;;;GAKG;AACH,MAAM,WAAW,8BAA8B;IAC7C,sCAAsC;IACtC,EAAE,EAAE,YAAY,CAAA;IAChB,oEAAoE;IACpE,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,mEAAmE;IACnE,aAAa,EAAE,2BAA2B,CAAA;IAC1C;;;;OAIG;IACH,kBAAkB,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAA;IACzD;;;;OAIG;IACH,oBAAoB,EAAE,CACpB,MAAM,EAAE,iBAAiB,EACzB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC/B,8EAA8E;IAC9E,cAAc,EAAE,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,qBAAqB,CAAA;IAClF,uEAAuE;IACvE,aAAa,EAAE,sBAAsB,CAAA;CACtC;AAED,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAClE,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACtE,OAAO,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAA;IACtF,mBAAmB,CACjB,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,4BAA4B,CAAC,CAAA;IACxC,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACnE,aAAa,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;CAC/E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,uBAAuB,CAuLzB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,4BAA4B,CAAC,CA6BvC;AAkJD,YAAY,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/catalog-component.js

@@ -0,0 +1,349 @@
+/**
+ * Catalog-backed trip-component orchestration — owned by `@voyant-travel/trips`.
+ *
+ * Trips owns the reserve/checkout flow for catalog-backed components, so the
+ * orchestration that turns a `TripComponent` into a catalog booking-engine
+ * quote / reservation / cancellation lives here rather than in any deployment:
+ *   - offer validation (`quote`) + customer-facing tax recompute hand-off,
+ *   - reserve-with-origin-tracking (stamp the booking's catalog reservation
+ *     origin so the component → booking link survives),
+ *   - hold release (compensation) + cancellation preview + cancel,
+ *   - checkout hand-off.
+ *
+ * WHY SOME PIECES ARE INJECTED (not imported):
+ *
+ * Trips depends acyclically on `@voyant-travel/catalog` (booking-engine) and
+ * `@voyant-travel/bookings` (origin upsert), so those are imported directly.
+ * Three things stay deployment-supplied and are injected via `options`:
+ *
+ *   1. The `SourceAdapterRegistry` / `OwnedBookingHandlerRegistry` — these are
+ *      process-local registries assembled from a deployment's installed source
+ *      adapters + owned vertical handlers. They live in the deployment.
+ *   2. The promotion evaluator — `createCatalogPromotionEvaluator` lives in
+ *      `@voyant-travel/commerce`, and `commerce → quotes → trips` would make a
+ *      package cycle. So the evaluator is injected.
+ *   3. The customer-facing tax recompute (`transformQuoteResult`) — the operator
+ *      resolves its own tax settings (a deployment reader) and the transform is
+ *      shared with the catalog-booking route module, so it stays in the
+ *      deployment and is injected.
+ *   4. The checkout starter (`startCatalogCheckout`) — deployment-specific
+ *      payment-provider wiring.
+ *
+ * Behaviour is byte-for-byte equivalent to the operator's previous
+ * `trips-catalog-runtime.ts`.
+ */
+import { toCatalogReservationBookingOriginInput, upsertBookingOrigin, } from "@voyant-travel/bookings";
+import { bookEntity, bookingDraftV1, cancelEntity, quoteEntity, quoteResponseV1, } from "@voyant-travel/catalog/booking-engine";
+import { toBookingDraftV1 } from "./catalog-component-adapter.js";
+/**
+ * Build the catalog-backed trip-component orchestration bound to a request's
+ * db + deployment registries/readers.
+ */
+export function createCatalogComponentAdapter(options) {
+    const { db, registry, ownedHandlers, evaluatePromotions, transformQuoteResult, adapterContext } = options;
+    async function quote(input) {
+        const component = input.component;
+        const entityModule = required(component.entityModule, "component.entityModule");
+        const entityId = required(component.entityId, "component.entityId");
+        const sourceKind = required(component.sourceKind, "component.sourceKind");
+        const result = await quoteEntity(db, {
+            registry,
+            ownedHandlers,
+            evaluatePromotions,
+        }, {
+            entityModule,
+            entityId,
+            sourceKind,
+            sourceConnectionId: component.sourceConnectionId ?? undefined,
+            sourceRef: component.sourceRef ?? undefined,
+            scope: {
+                locale: input.scope.locale ?? "en-GB",
+                audience: input.scope.audience ?? "staff",
+                market: input.scope.market ?? "default",
+                currency: input.scope.currency,
+            },
+            parameters: engineParametersFromBookingDraft(undefined, input.bookingDraft),
+            ttlMs: input.ttlMs,
+            adapterContext: adapterContext(component.sourceConnectionId ?? sourceKind),
+        });
+        const transformed = await transformQuoteResult(result, entityModule, entityId, sourceKind);
+        return serializeQuoteResult(transformed);
+    }
+    async function reserve(input) {
+        const component = input.component;
+        const quoteId = required(component.catalogQuoteId, "component.catalogQuoteId");
+        const bookingDraft = bookingDraftFromComponent(component);
+        // The trips can start underlying bookings in draft status. When the
+        // operator leaves that option unchecked, the resulting booking lands in
+        // `awaiting_payment`. The owned products handler reads this off
+        // `request.parameters.initialStatus` and forwards it to the bridge.
+        const createAsDraft = readBoolean(input.envelope.constraints?.createAsDraft);
+        const initialStatus = createAsDraft ? "draft" : "awaiting_payment";
+        const result = await bookEntity(db, {
+            registry,
+            ownedHandlers,
+        }, {
+            quoteId,
+            party: {
+                draft: bookingDraft,
+                travelerParty: input.envelope.travelerParty,
+            },
+            paymentIntent: { type: "hold" },
+            parameters: { ...engineParametersFromBookingDraft(undefined, bookingDraft), initialStatus },
+            idempotencyKey: componentReserveIdempotencyKey(component.id, quoteId),
+            adapterContext: adapterContext(component.sourceConnectionId ?? component.sourceKind),
+        });
+        if (result.status === "failed") {
+            throw new Error("component_reservation_failed");
+        }
+        const orderRef = result.orderRef || result.snapshotId;
+        if (result.bookingId) {
+            await upsertBookingOrigin(db, toCatalogReservationBookingOriginInput({
+                bookingId: result.bookingId,
+                tripEnvelopeId: input.envelope.id,
+                tripComponentId: component.id,
+                reservationPlanId: input.reservationPlanId,
+                catalogPriceResponseId: quoteId,
+                catalogSnapshotId: result.snapshotId,
+                providerSourceKind: component.sourceKind,
+                providerSourceConnectionId: component.sourceConnectionId,
+                providerSourceRef: component.sourceRef,
+                providerOrderRef: orderRef,
+                metadata: {
+                    entityModule: component.entityModule,
+                    entityId: component.entityId,
+                    createAsDraft,
+                },
+            }));
+        }
+        return {
+            status: bookStatusToComponentStatus(result.status),
+            bookingId: result.bookingId,
+            orderId: orderRef,
+            providerRef: orderRef,
+            supplierRef: orderRef,
+            warnings: result.status === "held" ? undefined : [`booking_engine_status:${result.status}`],
+        };
+    }
+    async function release(input) {
+        const component = input.component;
+        if (!component.bookingId || !component.entityModule || !component.entityId) {
+            return { released: false, reason: "missing_component_booking_ref" };
+        }
+        try {
+            const result = await cancelEntity(db, { registry }, {
+                bookingId: component.bookingId,
+                entityModule: component.entityModule,
+                entityId: component.entityId,
+                reason: "Trips compensation",
+                adapterContext: adapterContext(component.sourceConnectionId ?? component.sourceKind),
+            });
+            return {
+                released: result.status === "cancelled",
+                reason: result.status === "refused" ? "cancel_refused" : undefined,
+            };
+        }
+        catch (error) {
+            return {
+                released: false,
+                reason: error instanceof Error ? error.message : "release_failed",
+            };
+        }
+    }
+    async function cancel(input) {
+        const component = input.component;
+        if (!component.bookingId || !component.entityModule || !component.entityId) {
+            return { status: "refused", reason: "missing_component_booking_ref" };
+        }
+        const result = await cancelEntity(db, { registry }, {
+            bookingId: component.bookingId,
+            entityModule: component.entityModule,
+            entityId: component.entityId,
+            reason: input.reason,
+            adapterContext: adapterContext(component.sourceConnectionId ?? component.sourceKind),
+        });
+        // Catalog adapters can return "pending" when an async cancel was submitted
+        // (email/partner-portal/batch) and the inventory hasn't been released yet.
+        // The trips's `CancelComponentResult` doesn't model that state;
+        // surface it as `refused` with a reason so the trip lands in remediation
+        // and the operator follows up out-of-band. `pending_channel` flows through
+        // the reason so the UI can show where the request went.
+        const status = result.status === "pending" ? "refused" : result.status;
+        const reason = result.status === "cancelled"
+            ? undefined
+            : result.status === "pending"
+                ? `cancel_pending${result.pendingChannel ? `:${result.pendingChannel}` : ""}`
+                : `cancel_${result.status}`;
+        return {
+            status,
+            refundAmountCents: result.refundAmount,
+            refundCurrency: result.refundCurrency,
+            reason,
+            snapshot: { snapshotId: result.snapshotId },
+        };
+    }
+    function startCheckout(input) {
+        return options.startCheckout(input);
+    }
+    return { quote, reserve, release, previewCancellation, cancel, startCheckout };
+}
+/**
+ * Pure catalog-component cancellation preview. Has no db / registry reads —
+ * supplier cancellation previews aren't available, so the cancellation result
+ * itself is authoritative. Exported standalone so deployments can preview
+ * without constructing a request-scoped adapter.
+ */
+export function previewCancellation(input) {
+    const component = input.component;
+    if (!component.bookingId || !component.entityModule || !component.entityId) {
+        return Promise.resolve({
+            componentId: component.id,
+            action: "staff_remediation",
+            currentStatus: component.status,
+            staffActionRequired: true,
+            reason: "missing_component_booking_ref",
+        });
+    }
+    return Promise.resolve({
+        componentId: component.id,
+        action: "cancel",
+        currentStatus: component.status,
+        staffActionRequired: false,
+        refundAmountCents: 0,
+        refundCurrency: component.componentCurrency ?? undefined,
+        penaltyAmountCents: 0,
+        policySummary: "Supplier cancellation preview is not available; cancellation result is authoritative.",
+        snapshot: {
+            bookingId: component.bookingId,
+            entityModule: component.entityModule,
+            entityId: component.entityId,
+            sourceKind: component.sourceKind,
+        },
+    });
+}
+// ── Pure helpers (vertical-agnostic) ────────────────────────────────────────
+function bookingDraftFromComponent(component) {
+    const metadata = component.metadata;
+    const candidate = metadata.bookingDraftV1 ?? metadata.bookingDraft;
+    if (candidate && typeof candidate === "object" && !Array.isArray(candidate)) {
+        return bookingDraftV1.parse(candidate);
+    }
+    return toBookingDraftV1(component);
+}
+function serializeQuoteResult(result) {
+    return quoteResponseV1.parse({
+        ...result,
+        quotedAt: result.quotedAt.toISOString(),
+        expiresAt: result.expiresAt.toISOString(),
+        pricing: toPricingBreakdownV1(result.pricing),
+    });
+}
+function toPricingBreakdownV1(basis) {
+    if (!basis)
+        return undefined;
+    if (basis.breakdown) {
+        const breakdown = basis.breakdown;
+        if (breakdown.currency && Array.isArray(breakdown.lines) && Array.isArray(breakdown.taxes)) {
+            return breakdown;
+        }
+    }
+    const lines = [
+        {
+            kind: "base",
+            label: "Base",
+            quantity: 1,
+            unitAmount: basis.base_amount,
+            totalAmount: basis.base_amount,
+        },
+    ];
+    if (basis.fees > 0) {
+        lines.push({ kind: "fee", label: "Fees", unitAmount: basis.fees, totalAmount: basis.fees });
+    }
+    if (basis.surcharges > 0) {
+        lines.push({
+            kind: "supplement",
+            label: "Surcharges",
+            unitAmount: basis.surcharges,
+            totalAmount: basis.surcharges,
+        });
+    }
+    const subtotal = basis.base_amount + basis.fees + basis.surcharges;
+    return {
+        currency: basis.currency,
+        lines,
+        taxes: basis.taxes > 0
+            ? [
+                {
+                    code: "tax",
+                    label: "Tax",
+                    rate: 0,
+                    amount: basis.taxes,
+                    base: basis.base_amount,
+                },
+            ]
+            : [],
+        subtotal,
+        taxTotal: basis.taxes,
+        total: subtotal + basis.taxes,
+    };
+}
+function bookStatusToComponentStatus(status) {
+    return status === "held" ? "held" : "booked";
+}
+function componentReserveIdempotencyKey(componentId, quoteId) {
+    return `trips:${componentId}:${quoteId}`.slice(0, 128);
+}
+function engineParametersFromBookingDraft(parameters, bookingDraftPayload) {
+    const bookingDraft = asRecord(bookingDraftPayload);
+    const configure = asRecord(bookingDraft?.configure);
+    const departureSlotId = stringValue(configure?.departureSlotId);
+    const paxCount = sumBookingDraftPax(configure?.pax);
+    const next = {
+        ...(parameters ?? {}),
+        ...(bookingDraft ? { draft: bookingDraft } : {}),
+    };
+    if (departureSlotId) {
+        if (next.departureSlotId == null)
+            next.departureSlotId = departureSlotId;
+        if (next.departure_id == null)
+            next.departure_id = departureSlotId;
+        if (next.slotId == null)
+            next.slotId = departureSlotId;
+    }
+    if (paxCount > 0 && next.paxCount == null) {
+        next.paxCount = paxCount;
+    }
+    const promotionCode = stringValue(bookingDraft?.promotionCode);
+    if (promotionCode && next.promotionCode == null) {
+        next.promotionCode = promotionCode;
+    }
+    return next;
+}
+function readBoolean(value) {
+    return value === true;
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function sumBookingDraftPax(value) {
+    const pax = asRecord(value);
+    if (!pax)
+        return 0;
+    let total = 0;
+    for (const count of Object.values(pax)) {
+        if (typeof count === "number" && Number.isFinite(count) && count > 0) {
+            total += count;
+        }
+    }
+    return total;
+}
+function required(value, label) {
+    if (!value)
+        throw new Error(`${label} is required`);
+    return value;
+}

package/dist/checkout/billing.d.ts

@@ -0,0 +1,9 @@
+import type { SynthesizedTripBilling, TripBillingInfo } from "./types.js";
+export declare function readTripBilling(travelerParty: Record<string, unknown>): TripBillingInfo;
+export declare function formatTripBillingName(billing: TripBillingInfo): string | null;
+export declare function synthesizeTripBilling(billing: TripBillingInfo): SynthesizedTripBilling;
+export declare function splitTripBillingName(value: string): {
+    firstName: string;
+    lastName: string;
+};
+//# sourceMappingURL=billing.d.ts.map

package/dist/checkout/billing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/checkout/billing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEzE,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAcvF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAS7E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,sBAAsB,CAatF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAM3F"}

package/dist/checkout/billing.js

@@ -0,0 +1,54 @@
+export function readTripBilling(travelerParty) {
+    const billing = asRecord(travelerParty.billing);
+    const contact = asRecord(billing?.contact);
+    return {
+        buyerType: stringValue(billing?.buyerType),
+        personId: stringValue(billing?.personId),
+        organizationId: stringValue(billing?.organizationId),
+        contact: {
+            firstName: stringValue(contact?.firstName),
+            lastName: stringValue(contact?.lastName),
+            email: stringValue(contact?.email),
+            phone: stringValue(contact?.phone),
+        },
+    };
+}
+export function formatTripBillingName(billing) {
+    return [billing.contact?.firstName, billing.contact?.lastName]
+        .filter((part) => Boolean(part))
+        .join(" ")
+        .trim()
+        ? [billing.contact?.firstName, billing.contact?.lastName]
+            .filter((part) => Boolean(part))
+            .join(" ")
+        : null;
+}
+export function synthesizeTripBilling(billing) {
+    const names = splitTripBillingName(formatTripBillingName(billing) ?? "Trip customer");
+    return {
+        email: billing.contact?.email ?? "",
+        phone: billing.contact?.phone ?? "0000000000",
+        firstName: names.firstName,
+        lastName: names.lastName,
+        city: "TBD",
+        country: 642,
+        state: "TBD",
+        postalCode: "00000",
+        details: "Pending — customer to confirm at payment.",
+    };
+}
+export function splitTripBillingName(value) {
+    const parts = value.trim().split(/\s+/).filter(Boolean);
+    return {
+        firstName: parts[0] ?? "Trip",
+        lastName: parts.slice(1).join(" ") || "Customer",
+    };
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}

package/dist/checkout/index.d.ts

@@ -0,0 +1,5 @@
+export { formatTripBillingName, readTripBilling, splitTripBillingName, synthesizeTripBilling, } from "./billing.js";
+export { buildTripPaymentSummary, checkoutPricingForTrip } from "./pricing.js";
+export { startTripCheckout } from "./start-checkout.js";
+export type { FxQuote, SynthesizedTripBilling, Trip, TripBillingInfo, TripCheckoutAllocation, TripCheckoutDeps, TripCheckoutInput, TripCheckoutResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/checkout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checkout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EACV,OAAO,EACP,sBAAsB,EACtB,IAAI,EACJ,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAA"}

package/dist/checkout/index.js

@@ -0,0 +1,3 @@
+export { formatTripBillingName, readTripBilling, splitTripBillingName, synthesizeTripBilling, } from "./billing.js";
+export { buildTripPaymentSummary, checkoutPricingForTrip } from "./pricing.js";
+export { startTripCheckout } from "./start-checkout.js";

package/dist/checkout/pricing.d.ts

@@ -0,0 +1,9 @@
+import type { Trip } from "../service.js";
+import type { TripCheckoutAllocation, TripCheckoutDeps } from "./types.js";
+export declare function checkoutPricingForTrip(quoteFx: TripCheckoutDeps["quoteFx"], trip: Trip, request: Record<string, unknown>): Promise<{
+    currency: string;
+    totalAmountCents: number;
+    allocations: TripCheckoutAllocation[];
+}>;
+export declare function buildTripPaymentSummary(trip: Trip, currency: string, allocations?: TripCheckoutAllocation[]): string;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/checkout/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/checkout/pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE1E,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,EACpC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC;IACT,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,sBAAsB,EAAE,CAAA;CACtC,CAAC,CAsDD;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,sBAAsB,EAAE,GACrC,MAAM,CAwCR"}

package/dist/checkout/pricing.js

@@ -0,0 +1,100 @@
+export async function checkoutPricingForTrip(quoteFx, trip, request) {
+    const active = trip.components.filter((component) => component.status !== "removed" && component.status !== "cancelled");
+    const collectionCurrency = stringValue(request.collectionCurrency) ?? trip.envelope.aggregateCurrency ?? "EUR";
+    const allocations = [];
+    for (const component of active) {
+        const sourceCurrency = component.componentCurrency ?? collectionCurrency;
+        const sourceAmountCents = component.componentTotalAmountCents ?? 0;
+        if (sourceAmountCents <= 0)
+            continue;
+        if (sourceCurrency === collectionCurrency) {
+            allocations.push({
+                componentId: component.id,
+                kind: component.kind,
+                bookingId: component.bookingId,
+                orderId: component.orderId,
+                sourceCurrency,
+                sourceAmountCents,
+                targetCurrency: collectionCurrency,
+                targetAmountCents: sourceAmountCents,
+            });
+            continue;
+        }
+        const fx = await quoteFx(sourceCurrency, collectionCurrency);
+        allocations.push({
+            componentId: component.id,
+            kind: component.kind,
+            bookingId: component.bookingId,
+            orderId: component.orderId,
+            sourceCurrency,
+            sourceAmountCents,
+            targetCurrency: collectionCurrency,
+            targetAmountCents: convertCents(sourceAmountCents, fx.rate),
+            fx: {
+                rate: fx.rate,
+                provider: "voyant_data_fx",
+                quotedAt: fx.quotedAt,
+                validUntil: fx.validUntil,
+            },
+        });
+    }
+    return {
+        currency: collectionCurrency,
+        totalAmountCents: allocations.reduce((sum, allocation) => sum + allocation.targetAmountCents, 0),
+        allocations,
+    };
+}
+export function buildTripPaymentSummary(trip, currency, allocations) {
+    const lines = ["Trip payment summary"];
+    const byComponentId = new Map(allocations?.map((allocation) => [allocation.componentId, allocation]));
+    for (const component of trip.components.filter((item) => item.status !== "removed" && item.status !== "cancelled")) {
+        const allocation = byComponentId.get(component.id);
+        if (allocation?.fx) {
+            lines.push(`${componentDisplayName(component)} — ${formatCents(allocation.sourceAmountCents, allocation.sourceCurrency)} -> ${formatCents(allocation.targetAmountCents, allocation.targetCurrency)}`);
+        }
+        else {
+            lines.push(`${componentDisplayName(component)} — ${formatCents(allocation?.targetAmountCents ?? component.componentTotalAmountCents, allocation?.targetCurrency ?? component.componentCurrency ?? currency)}`);
+        }
+    }
+    const total = allocations?.reduce((sum, allocation) => sum + allocation.targetAmountCents, 0);
+    lines.push(`Total payable — ${formatCents(total ?? trip.envelope.aggregateTotalAmountCents, currency)}`);
+    const fxAllocations = allocations?.filter((allocation) => allocation.fx) ?? [];
+    if (fxAllocations.length > 0) {
+        lines.push("");
+        lines.push("FX rates");
+        for (const allocation of fxAllocations) {
+            lines.push(`${allocation.sourceCurrency}->${allocation.targetCurrency}: ${allocation.fx?.rate} quoted ${allocation.fx?.quotedAt}`);
+        }
+    }
+    return lines.join("\n");
+}
+function componentDisplayName(component) {
+    const metadata = asRecord(component.metadata);
+    const catalogItem = asRecord(metadata?.catalogItem);
+    const flightDraft = asRecord(metadata?.flightDraft);
+    const origin = stringValue(flightDraft?.origin);
+    const destination = stringValue(flightDraft?.destination);
+    if (origin && destination)
+        return `${origin} -> ${destination}`;
+    return (stringValue(catalogItem?.name) ||
+        stringValue(component.title) ||
+        stringValue(component.description) ||
+        component.kind.replaceAll("_", " "));
+}
+function formatCents(amountCents, currency) {
+    return ((amountCents ?? 0) / 100).toLocaleString("en-GB", {
+        style: "currency",
+        currency,
+    });
+}
+function convertCents(amountCents, rate) {
+    return Math.round(amountCents * rate);
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}

package/dist/checkout/start-checkout.d.ts

@@ -0,0 +1,14 @@
+import type { TripCheckoutInput, TripCheckoutResult } from "../service.js";
+import type { TripCheckoutDeps } from "./types.js";
+/**
+ * Orchestrate a trip checkout: price the trip's components into the collection
+ * currency, create the finance payment session, optionally start the payment
+ * provider, and return the customer-facing checkout link / bank-transfer
+ * instructions.
+ *
+ * Finance (`createPaymentSession` + `buildPaymentLinkUrl`) is composed
+ * directly. The deployment supplies FX quoting, the checkout base URL, and the
+ * payment-provider start via `deps`.
+ */
+export declare function startTripCheckout(deps: TripCheckoutDeps, input: TripCheckoutInput): Promise<TripCheckoutResult>;
+//# sourceMappingURL=start-checkout.d.ts.map

package/dist/checkout/start-checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-checkout.d.ts","sourceRoot":"","sources":["../../src/checkout/start-checkout.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAG1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CA8D7B"}

package/dist/checkout/start-checkout.js

@@ -0,0 +1,74 @@
+import { buildPaymentLinkUrl, financeService } from "@voyant-travel/finance";
+import { formatTripBillingName, readTripBilling, synthesizeTripBilling } from "./billing.js";
+import { buildTripPaymentSummary, checkoutPricingForTrip } from "./pricing.js";
+/**
+ * Orchestrate a trip checkout: price the trip's components into the collection
+ * currency, create the finance payment session, optionally start the payment
+ * provider, and return the customer-facing checkout link / bank-transfer
+ * instructions.
+ *
+ * Finance (`createPaymentSession` + `buildPaymentLinkUrl`) is composed
+ * directly. The deployment supplies FX quoting, the checkout base URL, and the
+ * payment-provider start via `deps`.
+ */
+export async function startTripCheckout(deps, input) {
+    const db = deps.db;
+    const pricing = await checkoutPricingForTrip(deps.quoteFx, input.trip, input.request);
+    if (pricing.totalAmountCents <= 0) {
+        throw new Error("trip_checkout_total_required");
+    }
+    const billing = readTripBilling(input.trip.envelope.travelerParty);
+    const payerName = formatTripBillingName(billing);
+    const payerEmail = billing.contact?.email ?? null;
+    if (!payerName || !payerEmail) {
+        throw new Error("trip_checkout_billing_required");
+    }
+    const paymentMethod = input.intent === "bank_transfer" ? "bank_transfer" : "credit_card";
+    const session = await financeService.createPaymentSession(db, {
+        targetType: "other",
+        targetId: input.trip.envelope.id,
+        idempotencyKey: `trip-checkout:${input.trip.envelope.id}:${pricing.currency}:${pricing.totalAmountCents}`,
+        clientReference: input.trip.envelope.id,
+        currency: pricing.currency,
+        amountCents: pricing.totalAmountCents,
+        status: "pending",
+        provider: input.intent === "bank_transfer" ? null : "netopia",
+        paymentMethod,
+        payerPersonId: billing.personId ?? null,
+        payerOrganizationId: billing.organizationId ?? null,
+        payerEmail,
+        payerName,
+        notes: buildTripPaymentSummary(input.trip, pricing.currency, pricing.allocations),
+        metadata: {
+            tripEnvelopeId: input.trip.envelope.id,
+            collectionCurrency: pricing.currency,
+            componentAllocations: pricing.allocations,
+            fxAllocations: pricing.allocations.filter((allocation) => allocation.fx),
+        },
+    });
+    if (!session) {
+        throw new Error("trip_checkout_session_create_failed");
+    }
+    if (input.intent !== "bank_transfer") {
+        try {
+            if (deps.startProviderPayment) {
+                await deps.startProviderPayment({
+                    paymentSessionId: session.id,
+                    billing: synthesizeTripBilling(billing),
+                    description: `Trip ${input.trip.envelope.id}`,
+                    trip: input.trip,
+                });
+            }
+        }
+        catch (error) {
+            console.warn("[trips] netopia start failed for trip payment session:", error);
+        }
+    }
+    return {
+        kind: input.intent === "bank_transfer" ? "bank_transfer_instructions" : "payment_session",
+        paymentSessionId: session.id,
+        checkoutUrl: buildPaymentLinkUrl(session.id, {
+            baseUrl: deps.resolveCheckoutBaseUrl(),
+        }),
+    };
+}

package/dist/checkout/types.d.ts

@@ -0,0 +1,82 @@
+import type { Trip, TripCheckoutInput, TripCheckoutResult } from "../service.js";
+/** A per-component currency allocation produced while pricing a trip checkout. */
+export interface TripCheckoutAllocation {
+    componentId: string;
+    kind: string;
+    bookingId: string | null;
+    orderId: string | null;
+    sourceCurrency: string;
+    sourceAmountCents: number;
+    targetCurrency: string;
+    targetAmountCents: number;
+    fx?: {
+        rate: number;
+        provider: "voyant_data_fx";
+        quotedAt: string;
+        validUntil?: string | null;
+    };
+}
+/** A resolved FX quote between two currencies. */
+export interface FxQuote {
+    rate: number;
+    quotedAt: string;
+    validUntil?: string | null;
+}
+/** Billing details extracted from a trip's traveler party. */
+export interface TripBillingInfo {
+    buyerType?: string | null;
+    personId?: string | null;
+    organizationId?: string | null;
+    contact?: {
+        firstName?: string | null;
+        lastName?: string | null;
+        email?: string | null;
+        phone?: string | null;
+    };
+}
+/** Synthesized billing payload handed to a payment provider. */
+export interface SynthesizedTripBilling {
+    email: string;
+    phone: string;
+    firstName: string;
+    lastName: string;
+    city: string;
+    country: number;
+    state: string;
+    postalCode: string;
+    details: string;
+}
+/**
+ * Deployment-supplied dependencies for the trip-checkout orchestration. The
+ * trips package composes finance (`createPaymentSession` + payment-link URL)
+ * directly, but everything that is a deployment provider choice — FX rates,
+ * the public checkout base URL, and the payment-provider start (Netopia) —
+ * is injected here.
+ */
+export interface TripCheckoutDeps {
+    /** The finance-compatible drizzle db used for `createPaymentSession`. */
+    db: unknown;
+    /**
+     * Quote an FX rate from `sourceCurrency` to `targetCurrency`. Called only
+     * when a component's currency differs from the collection currency.
+     */
+    quoteFx(sourceCurrency: string, targetCurrency: string): Promise<FxQuote>;
+    /**
+     * Resolve the customer-facing checkout base URL used to build the payment
+     * link. May return `null` (the helper falls back to a root-relative URL).
+     */
+    resolveCheckoutBaseUrl(): string | null;
+    /**
+     * Start the payment-provider session for a non-bank-transfer checkout. This
+     * is best-effort; the orchestration logs and continues on failure. Omit to
+     * skip provider start entirely.
+     */
+    startProviderPayment?(args: {
+        paymentSessionId: string;
+        billing: SynthesizedTripBilling;
+        description: string;
+        trip: Trip;
+    }): Promise<void>;
+}
+export type { Trip, TripCheckoutInput, TripCheckoutResult };
+//# sourceMappingURL=types.d.ts.map

package/dist/checkout/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/checkout/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEhF,kFAAkF;AAClF,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,EAAE,CAAC,EAAE;QACH,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,gBAAgB,CAAA;QAC1B,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC3B,CAAA;CACF;AAED,kDAAkD;AAClD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KACtB,CAAA;CACF;AAED,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,EAAE,EAAE,OAAO,CAAA;IACX;;;OAGG;IACH,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACzE;;;OAGG;IACH,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAAA;IACvC;;;;OAIG;IACH,oBAAoB,CAAC,CAAC,IAAI,EAAE;QAC1B,gBAAgB,EAAE,MAAM,CAAA;QACxB,OAAO,EAAE,sBAAsB,CAAA;QAC/B,WAAW,EAAE,MAAM,CAAA;QACnB,IAAI,EAAE,IAAI,CAAA;KACX,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClB;AAED,YAAY,EAAE,IAAI,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/checkout/types.js

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

package/dist/flight-component.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Non-catalog (flight) trip-component orchestration — owned by
+ * `@voyant-travel/trips`.
+ *
+ * Trips owns the reserve/checkout flow for flight placeholder components, so the
+ * orchestration that prices a selected flight offer before reserve (detecting
+ * price changes / expiry) and books the held flight order lives here:
+ *   - flight preflight + price-change detection (`validateBeforeReserve`),
+ *   - passenger-roster building (DOB / contact fallbacks) + billing mapping,
+ *   - reserve (book the held flight order).
+ *
+ * WHY THE FLIGHT ADAPTER IS INJECTED (not imported):
+ *
+ * Trips reads flight *contract types* from `@voyant-travel/flights` (a leaf
+ * contract dependency, acyclic), but the concrete adapter
+ * (`createDemoFlightAdapter` from `@voyant-travel/plugin-flights-demo`) is
+ * deployment-specific provider wiring — which provider, which base URL — so it
+ * is injected via `options.adapter` rather than imported. The price/expiry
+ * detection, passenger mapping, and billing fallbacks are vertical-agnostic
+ * orchestration and live here.
+ *
+ * Behaviour is byte-for-byte equivalent to the operator's previous
+ * `trips-flight-runtime.ts`.
+ */
+import type { FlightBookRequest, FlightOffer, FlightOrder } from "@voyant-travel/flights/contract/types";
+import type { ReserveComponentInput, ReserveComponentPreflightResult, ReserveComponentResult } from "./service-types.js";
+/** Per-request adapter context propagated to the flight adapter. */
+export interface FlightAdapterContext {
+    connectionId: string;
+    correlationId?: string;
+}
+/**
+ * The minimal flight-adapter surface the orchestration needs. Injected because
+ * the concrete adapter is deployment-specific provider wiring.
+ */
+export interface FlightComponentAdapter {
+    priceOffer(ctx: FlightAdapterContext, request: {
+        offerId: string;
+        offer?: FlightOffer;
+    }): Promise<{
+        offer: FlightOffer;
+        valid: boolean;
+        invalidReason?: string;
+    }>;
+    bookFlight(ctx: FlightAdapterContext, request: FlightBookRequest): Promise<{
+        order: FlightOrder;
+    }>;
+}
+/** Deployment-supplied, request-scoped flight wiring. */
+export interface FlightComponentAdapterOptions {
+    /** The deployment-specific flight adapter (provider + base URL). */
+    adapter: FlightComponentAdapter;
+    /** Per-request adapter context (connection id + correlation id). */
+    adapterContext: FlightAdapterContext;
+}
+/** The flight component orchestration surface produced by the factory. */
+export interface FlightComponentAdapterApi {
+    validateBeforeReserve(input: ReserveComponentInput): Promise<ReserveComponentPreflightResult | null>;
+    reserve(input: ReserveComponentInput): Promise<ReserveComponentResult | null>;
+}
+/**
+ * Build the flight (non-catalog) trip-component orchestration bound to a
+ * request's flight adapter + adapter context.
+ */
+export declare function createFlightComponentAdapter(options: FlightComponentAdapterOptions): FlightComponentAdapterApi;
+//# sourceMappingURL=flight-component.d.ts.map

package/dist/flight-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flight-component.d.ts","sourceRoot":"","sources":["../src/flight-component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAEV,iBAAiB,EACjB,WAAW,EACX,WAAW,EAGZ,MAAM,uCAAuC,CAAA;AAG9C,OAAO,KAAK,EACV,qBAAqB,EACrB,+BAA+B,EAC/B,sBAAsB,EACvB,MAAM,oBAAoB,CAAA;AAE3B,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,CACR,GAAG,EAAE,oBAAoB,EACzB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,GAChD,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC1E,UAAU,CAAC,GAAG,EAAE,oBAAoB,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;CACnG;AAED,yDAAyD;AACzD,MAAM,WAAW,6BAA6B;IAC5C,oEAAoE;IACpE,OAAO,EAAE,sBAAsB,CAAA;IAC/B,oEAAoE;IACpE,cAAc,EAAE,oBAAoB,CAAA;CACrC;AAED,0EAA0E;AAC1E,MAAM,WAAW,yBAAyB;IACxC,qBAAqB,CACnB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IAClD,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAA;CAC9E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,GACrC,yBAAyB,CAyG3B"}

package/dist/flight-component.js

@@ -0,0 +1,177 @@
+import { formatTripBillingName, readTripBilling, splitTripBillingName } from "./checkout/index.js";
+/**
+ * Build the flight (non-catalog) trip-component orchestration bound to a
+ * request's flight adapter + adapter context.
+ */
+export function createFlightComponentAdapter(options) {
+    const { adapter, adapterContext } = options;
+    async function validateBeforeReserve(input) {
+        if (input.component.kind !== "flight_placeholder")
+            return null;
+        const flightDraft = asRecord(input.component.metadata)?.flightDraft;
+        const draftRecord = asRecord(flightDraft);
+        const selectedOffer = draftRecord?.selectedOffer;
+        const offerId = stringValue(draftRecord?.offerId) ?? selectedOffer?.offerId;
+        if (!selectedOffer || !offerId) {
+            return { status: "unavailable", reason: "flight_offer_required" };
+        }
+        try {
+            const priced = await adapter.priceOffer(adapterContext, {
+                offerId,
+                offer: selectedOffer,
+            });
+            if (!priced.valid) {
+                return {
+                    status: "unavailable",
+                    reason: priced.invalidReason ?? "flight_offer_unavailable",
+                    details: { offerId },
+                };
+            }
+            const previousPricing = asRecord(draftRecord?.pricing);
+            const ancillaryAmountCents = numberValue(previousPricing?.ancillaryAmountCents) ?? 0;
+            const currentTotalAmountCents = moneyToCents(priced.offer.totalPrice.amount) + ancillaryAmountCents;
+            const previousTotalAmountCents = input.component.componentTotalAmountCents ??
+                numberValue(previousPricing?.totalAmountCents) ??
+                0;
+            const currentCurrency = priced.offer.totalPrice.currency;
+            const previousCurrency = input.component.componentCurrency ??
+                stringValue(previousPricing?.currency) ??
+                currentCurrency;
+            if (currentCurrency !== previousCurrency ||
+                currentTotalAmountCents !== previousTotalAmountCents) {
+                return {
+                    status: "price_changed",
+                    reason: "flight_price_changed",
+                    details: {
+                        offerId,
+                        previous: {
+                            currency: previousCurrency,
+                            totalAmountCents: previousTotalAmountCents,
+                        },
+                        current: {
+                            currency: currentCurrency,
+                            totalAmountCents: currentTotalAmountCents,
+                        },
+                    },
+                };
+            }
+            return { status: "ok" };
+        }
+        catch (error) {
+            return {
+                status: isExpiredOffer(selectedOffer) ? "expired" : "unavailable",
+                reason: error instanceof Error ? error.message : "flight_offer_unavailable",
+                details: { offerId },
+            };
+        }
+    }
+    async function reserve(input) {
+        if (input.component.kind !== "flight_placeholder")
+            return null;
+        const flightDraft = asRecord(input.component.metadata)?.flightDraft;
+        const selectedOffer = asRecord(flightDraft)?.selectedOffer;
+        if (!selectedOffer?.offerId) {
+            throw new Error("flight_offer_required");
+        }
+        const request = {
+            offerId: selectedOffer.offerId,
+            offer: selectedOffer,
+            passengers: flightPassengersFromTravelerParty(input.envelope.travelerParty),
+            contact: flightContactFromTravelerParty(input.envelope.travelerParty),
+            paymentIntent: { type: "hold" },
+            ancillaries: asRecord(flightDraft)?.ancillaries,
+        };
+        const response = await adapter.bookFlight(adapterContext, request);
+        const order = response.order;
+        return {
+            status: order.status === "ticketed" ? "booked" : "held",
+            orderId: order.orderId,
+            providerRef: order.pnr ?? order.orderId,
+            supplierRef: order.orderId,
+            holdExpiresAt: order.paymentDeadline,
+            warnings: order.paymentDeadline ? undefined : ["flight_hold_deadline_missing"],
+        };
+    }
+    return { validateBeforeReserve, reserve };
+}
+// ── Pure helpers (vertical-agnostic) ────────────────────────────────────────
+function moneyToCents(amount) {
+    const parsed = Number.parseFloat(amount);
+    return Number.isFinite(parsed) ? Math.round(parsed * 100) : 0;
+}
+function isExpiredOffer(offer) {
+    const expiresAt = offer.expiresAt ? new Date(offer.expiresAt) : null;
+    return Boolean(expiresAt && expiresAt.getTime() <= Date.now());
+}
+function flightPassengersFromTravelerParty(travelerParty) {
+    const travelers = Array.isArray(travelerParty.travelers)
+        ? travelerParty.travelers
+        : [];
+    const passengers = travelers.map((traveler, index) => flightPassengerFromTraveler(asRecord(traveler) ?? {}, index));
+    if (passengers.length > 0)
+        return passengers;
+    const billing = readTripBilling(travelerParty);
+    const names = splitTripBillingName(formatTripBillingName(billing) ?? "Lead traveler");
+    return [
+        {
+            passengerId: "traveler_1",
+            type: "adult",
+            firstName: names.firstName,
+            lastName: names.lastName,
+            dateOfBirth: "1990-01-01",
+            ...(billing.contact?.email ? { email: billing.contact.email } : {}),
+            ...(billing.contact?.phone ? { phone: billing.contact.phone } : {}),
+        },
+    ];
+}
+function flightPassengerFromTraveler(traveler, index) {
+    const type = passengerTypeFromRole(stringValue(traveler.role));
+    return {
+        passengerId: stringValue(traveler.localId) || stringValue(traveler.personId) || `traveler_${index + 1}`,
+        type,
+        firstName: stringValue(traveler.firstName) || fallbackFirstName(type),
+        lastName: stringValue(traveler.lastName) || `${index + 1}`,
+        dateOfBirth: stringValue(traveler.dateOfBirth) || fallbackDobForPassengerType(type),
+        ...(stringValue(traveler.email) ? { email: stringValue(traveler.email) ?? undefined } : {}),
+        ...(stringValue(traveler.phone) ? { phone: stringValue(traveler.phone) ?? undefined } : {}),
+    };
+}
+function passengerTypeFromRole(role) {
+    if (role === "child")
+        return "child";
+    if (role === "infant")
+        return "infant";
+    return "adult";
+}
+function fallbackFirstName(type) {
+    if (type === "child")
+        return "Child";
+    if (type === "infant")
+        return "Infant";
+    return "Adult";
+}
+function fallbackDobForPassengerType(type) {
+    if (type === "child")
+        return "2016-01-01";
+    if (type === "infant")
+        return "2025-01-01";
+    return "1990-01-01";
+}
+function flightContactFromTravelerParty(travelerParty) {
+    const billing = readTripBilling(travelerParty);
+    return {
+        ...(billing.contact?.email ? { email: billing.contact.email } : {}),
+        ...(billing.contact?.phone ? { phone: billing.contact.phone } : {}),
+    };
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 import type { Module } from "@voyant-travel/core";
 import type { HonoModule } from "@voyant-travel/hono/module";
 import { type TripsRoutesOptions } from "./routes.js";
+export { type CatalogAdapterContext, type CatalogComponentAdapter, type CatalogComponentAdapterOptions, createCatalogComponentAdapter, previewCancellation, type StartComponentCheckout, } from "./catalog-component.js";
 export { type CatalogComponentBookingDraftOverrides, isCatalogBackedTripComponent, toBookingDraftV1, } from "./catalog-component-adapter.js";
 export { CRUISE_EXTENSION_METADATA_KIND, type CruiseExtensionExtra, type CruiseExtensionLifecycle, type CruiseExtensionLinkCommand, type CruiseExtensionLinkInput, type CruiseExtensionPlacement, type CruiseExtensionRepresentation, type CruiseExtensionSelection, type CruiseExtensionTargetKind, createCruiseExtensionComponent, createCruiseExtensionExtra, createCruiseExtensionLinkCommand, cruiseExtensionLinkKey, groupCruiseExtensionLinksByProduct, representCruiseExtensionSelection, } from "./cruise-extension.js";
+export { createFlightComponentAdapter, type FlightAdapterContext, type FlightComponentAdapter, type FlightComponentAdapterApi, type FlightComponentAdapterOptions, } from "./flight-component.js";
 export type { TripsRoutes, TripsRoutesOptions } from "./routes.js";
 export { createTripsRoutes } from "./routes.js";
 export declare const tripsModule: Module;
@@ -14,6 +16,7 @@ export declare function createTripsHonoModule(options?: TripsHonoModuleOptions):
 export type { McpToolContent, McpToolContext, McpToolDefinition, McpToolErrorCode, McpToolHandler, McpToolResult, } from "./mcp-contract.js";
 export { McpToolError } from "./mcp-contract.js";
 export { type CreateMcpToolRegistryOptions, createMcpToolRegistry, enforceAudienceAuthorization, type McpToolListEntry, type McpToolRegistry, requireService, } from "./mcp-registry.js";
+export { createTripMcpRoutes, type TripMcpRoutesOptions } from "./mcp-routes.js";
 export { type CreateTripArgs, createTripTool, type PriceTripArgs, priceTripTool, type ReserveTripArgs, type ReviseTripArgs, reserveTripTool, reviseTripTool, type TripsMcpServices, tripsMcpTools, } from "./mcp-tools.js";
 export { tripsRoutes } from "./routes.js";
 export type { NewTripComponent, NewTripComponentEvent, NewTripEnvelope, NewTripReservationPlan, NewTripSnapshot, TripComponent, TripComponentEvent, TripComponentPricingSnapshot, TripComponentTaxLineSnapshot, TripEnvelope, TripEnvelopePricingSnapshot, TripReservationPlan, TripReservationPlanCompensationSnapshot, TripReservationPlanComponentSnapshot, TripReservationPlanFailureSnapshot, TripSnapshot, TripSnapshotProposal, TripSnapshotProposalLine, } from "./schema.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,8 @@
 import { createTripsRoutes, tripsRoutes } from "./routes.js";
+export { createCatalogComponentAdapter, previewCancellation, } from "./catalog-component.js";
 export { isCatalogBackedTripComponent, toBookingDraftV1, } from "./catalog-component-adapter.js";
 export { CRUISE_EXTENSION_METADATA_KIND, createCruiseExtensionComponent, createCruiseExtensionExtra, createCruiseExtensionLinkCommand, cruiseExtensionLinkKey, groupCruiseExtensionLinksByProduct, representCruiseExtensionSelection, } from "./cruise-extension.js";
+export { createFlightComponentAdapter, } from "./flight-component.js";
 export { createTripsRoutes } from "./routes.js";
 export const tripsModule = {
     name: "trips",
@@ -23,6 +25,7 @@ export function createTripsHonoModule(options = {}) {
 }
 export { McpToolError } from "./mcp-contract.js";
 export { createMcpToolRegistry, enforceAudienceAuthorization, requireService, } from "./mcp-registry.js";
+export { createTripMcpRoutes } from "./mcp-routes.js";
 export { createTripTool, priceTripTool, reserveTripTool, reviseTripTool, tripsMcpTools, } from "./mcp-tools.js";
 export { tripsRoutes } from "./routes.js";
 export { tripComponentEvents, tripComponentEventTypeEnum, tripComponentKindEnum, tripComponentStatusEnum, tripComponents, tripEnvelopeStatusEnum, tripEnvelopes, tripReservationPlanStatusEnum, tripReservationPlans, tripSnapshots, } from "./schema.js";

package/dist/mcp-routes.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Trips agent tool surface (transport: HTTP).
+ *
+ * A generic tool-dispatch route owned by the trips package. It registers the
+ * trips command tools (create / revise / price / reserve) and dispatches a
+ * `POST /tools/:tool` call against them.
+ *
+ * The deployment supplies the per-request `McpToolContext` and the
+ * `TripsMcpServices` (which bind the trips service to the deployment's db +
+ * dependency wiring) via `options`. Mount the returned router at
+ * `/v1/admin/mcp`.
+ */
+import { type Context, Hono } from "hono";
+import type { McpToolContext } from "./mcp-contract.js";
+import { type TripsMcpServices } from "./mcp-tools.js";
+export interface TripMcpRoutesOptions {
+    /**
+     * Build the per-request MCP tool context (actor / tenant / default scope).
+     * Derived from the request's auth + the deployment's defaults.
+     */
+    buildContext(c: Context): McpToolContext;
+    /**
+     * Build the trips MCP services for this request — binds the trips service to
+     * the deployment's db + dependency wiring.
+     */
+    buildTripsServices(c: Context): TripsMcpServices;
+}
+/** Build the trips MCP admin routes (relative paths; mount at `/v1/admin/mcp`). */
+export declare function createTripMcpRoutes(options: TripMcpRoutesOptions): Hono;
+//# sourceMappingURL=mcp-routes.d.ts.map

package/dist/mcp-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-routes.d.ts","sourceRoot":"","sources":["../src/mcp-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAA;AAEvB,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAAA;IACxC;;;OAGG;IACH,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAA;CACjD;AASD,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CA0BvE"}

package/dist/mcp-routes.js

@@ -0,0 +1,48 @@
+/**
+ * Trips agent tool surface (transport: HTTP).
+ *
+ * A generic tool-dispatch route owned by the trips package. It registers the
+ * trips command tools (create / revise / price / reserve) and dispatches a
+ * `POST /tools/:tool` call against them.
+ *
+ * The deployment supplies the per-request `McpToolContext` and the
+ * `TripsMcpServices` (which bind the trips service to the deployment's db +
+ * dependency wiring) via `options`. Mount the returned router at
+ * `/v1/admin/mcp`.
+ */
+import { Hono } from "hono";
+import { createMcpToolRegistry } from "./mcp-registry.js";
+import { createTripTool, priceTripTool, reserveTripTool, reviseTripTool, } from "./mcp-tools.js";
+function registerAdminTools(registry) {
+    registry.register(createTripTool);
+    registry.register(reviseTripTool);
+    registry.register(priceTripTool);
+    registry.register(reserveTripTool);
+}
+/** Build the trips MCP admin routes (relative paths; mount at `/v1/admin/mcp`). */
+export function createTripMcpRoutes(options) {
+    async function handle(c) {
+        const tool = c.req.param("tool");
+        if (!tool)
+            return c.json({ error: "Missing tool name" }, 400);
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            body = {};
+        }
+        const registry = createMcpToolRegistry({
+            context: {
+                ...options.buildContext(c),
+                trips: options.buildTripsServices(c),
+            },
+        });
+        registerAdminTools(registry);
+        const result = await registry.dispatchTool(tool, body);
+        return c.json(result);
+    }
+    const routes = new Hono();
+    routes.post("/tools/:tool", handle);
+    return routes;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/trips",
-  "version": "0.111.1",
+  "version": "0.113.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -29,6 +29,26 @@
       "import": "./dist/mcp-tools.js",
       "default": "./dist/mcp-tools.js"
     },
+    "./mcp": {
+      "types": "./dist/mcp-routes.d.ts",
+      "import": "./dist/mcp-routes.js",
+      "default": "./dist/mcp-routes.js"
+    },
+    "./checkout": {
+      "types": "./dist/checkout/index.d.ts",
+      "import": "./dist/checkout/index.js",
+      "default": "./dist/checkout/index.js"
+    },
+    "./catalog-component": {
+      "types": "./dist/catalog-component.d.ts",
+      "import": "./dist/catalog-component.js",
+      "default": "./dist/catalog-component.js"
+    },
+    "./flight-component": {
+      "types": "./dist/flight-component.d.ts",
+      "import": "./dist/flight-component.js",
+      "default": "./dist/flight-component.js"
+    },
     "./cruise-extension": {
       "types": "./dist/cruise-extension.d.ts",
       "import": "./dist/cruise-extension.js",
@@ -51,9 +71,12 @@
     "hono": "^4.12.10",
     "zod": "^4.3.6",
     "@voyant-travel/core": "^0.109.0",
-    "@voyant-travel/catalog": "^0.118.1",
+    "@voyant-travel/bookings": "^0.122.0",
+    "@voyant-travel/catalog": "^0.120.0",
     "@voyant-travel/db": "^0.108.1",
-    "@voyant-travel/hono": "^0.110.2"
+    "@voyant-travel/finance": "^0.122.0",
+    "@voyant-travel/flights": "^0.122.0",
+    "@voyant-travel/hono": "^0.111.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",