@voyant-travel/flights 0.137.0 → 0.137.2

package/dist/contract/schemas.test.js

@@ -1,6 +1,6 @@
 // agent-quality: file-size exception -- owner: flights; existing coverage file stays co-located until a dedicated split preserves behavior and tests.
 import { describe, expect, it } from "vitest";
-import { ancillaryRequestSchema, ancillaryResponseSchema, checkInRequestSchema, checkInResponseSchema, flightAdapterCapabilitiesSchema, flightAdapterContextSchema, flightBookRequestSchema, flightBookResponseSchema, flightCancelResponseSchema, flightGetOrderResponseSchema, flightModifyRequestSchema, flightModifyResponseSchema, flightOrdersListQuerySchema, flightOrdersListResponseSchema, flightPriceRequestSchema, flightPriceResponseSchema, flightRefundRequestSchema, flightRefundResponseSchema, flightSearchRequestSchema, flightSearchResponseSchema, flightVoidResponseSchema, moneySchema, seatMapRequestSchema, seatMapResponseSchema, seatSelectionRequestSchema, seatSelectionResponseSchema, ssrRequestSchema, ssrResponseSchema, } from "./schemas.js";
+import { ancillaryRequestSchema, ancillaryResponseSchema, checkInRequestSchema, checkInResponseSchema, flightAdapterCapabilitiesSchema, flightAdapterContextSchema, flightBookRequestSchema, flightBookResponseSchema, flightCancelResponseSchema, flightGetOrderResponseSchema, flightModifyRequestSchema, flightModifyResponseSchema, flightOrdersListQuerySchema, flightOrdersListResponseSchema, flightPriceRequestSchema, flightPriceResponseSchema, flightRefundRequestSchema, flightRefundResponseSchema, flightSearchRequestSchema, flightSearchResponseSchema, flightVoidResponseSchema, moneySchema, paymentIntentSchema, seatMapRequestSchema, seatMapResponseSchema, seatSelectionRequestSchema, seatSelectionResponseSchema, ssrRequestSchema, ssrResponseSchema, } from "./schemas.js";
 const typeChecks = [
     true,
     true,
@@ -164,6 +164,7 @@ const roundTripCases = [
     ["flightSearchResponseSchema", flightSearchResponseSchema, { offers: [offer] }],
     ["flightPriceRequestSchema", flightPriceRequestSchema, { offerId: "offer_1", offer }],
     ["flightPriceResponseSchema", flightPriceResponseSchema, { offer, valid: true }],
+    ["paymentIntentSchema", paymentIntentSchema, { type: "bank_transfer" }],
     [
         "flightBookRequestSchema",
         flightBookRequestSchema,

package/dist/hono.d.ts

@@ -2,21 +2,24 @@ import type { HonoModule } from "@voyant-travel/hono";
 import { type Context, Hono } from "hono";
 import type { FlightConnectorAdapter } from "./contract/adapter.js";
 import type { FlightOrder } from "./contract/types.js";
-/** A resolved payment session for a flight hold order. */
+/** A resolved payment session for a flight order. */
 export interface FlightOrderPaymentSummary {
     sessionId: string;
     status: string;
 }
 /**
- * Deployment-supplied payment integration for flight hold orders. The flights
+ * Deployment-supplied payment integration for flight orders. The flights
  * module stays payment-provider agnostic; the deployment wires its finance /
  * payment provider here.
  */
 export interface FlightPaymentIntegration {
-    /** Ensure (idempotently) a payment session exists for a hold order. */
+    /** Ensure (idempotently) a payment session exists for an order. */
     ensureOrderSession(c: Context, order: FlightOrder, contact?: {
         email?: string;
         phone?: string;
+    }, options?: {
+        paymentMethod?: "bank_transfer" | "credit_card";
+        startCardPayment?: boolean;
     }): Promise<FlightOrderPaymentSummary | null>;
     /** Bulk-resolve the most relevant payment session per order id (no N+1). */
     fetchOrderSessions(c: Context, orderIds: string[]): Promise<Map<string, FlightOrderPaymentSummary>>;

package/dist/hono.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../src/hono.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAEzC,OAAO,KAAK,EAEV,sBAAsB,EAEvB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAGV,WAAW,EAIZ,MAAM,qBAAqB,CAAA;AAO5B,0DAA0D;AAC1D,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,kBAAkB,CAChB,CAAC,EAAE,OAAO,EACV,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;IAC5C,4EAA4E;IAC5E,kBAAkB,CAChB,CAAC,EAAE,OAAO,EACV,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAA;IAClD,yDAAyD;IACzD,OAAO,CAAC,EAAE,wBAAwB,CAAA;CACnC;AAED,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,CAAA;AA8B1D,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAsO1E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,UAAU,CAKrF"}
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../src/hono.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAEzC,OAAO,KAAK,EAEV,sBAAsB,EAEvB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAGV,WAAW,EAKZ,MAAM,qBAAqB,CAAA;AAO5B,qDAAqD;AACrD,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,kBAAkB,CAChB,CAAC,EAAE,OAAO,EACV,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC5C,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,eAAe,GAAG,aAAa,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GACxF,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;IAC5C,4EAA4E;IAC5E,kBAAkB,CAChB,CAAC,EAAE,OAAO,EACV,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAA;IAClD,yDAAyD;IACzD,OAAO,CAAC,EAAE,wBAAwB,CAAA;CACnC;AAED,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,CAAA;AAoD1D,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CA+O1E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,UAAU,CAKrF"}

package/dist/hono.js

@@ -24,6 +24,25 @@ function attachPaymentSession(order, summary) {
         },
     };
 }
+function statusForAdapterErrorMessage(message) {
+    return /(?:not found|_not_found\b)/i.test(message) ? 404 : 500;
+}
+function paymentSessionOptionsForIntent(intent) {
+    if (!intent || intent.type === "hold")
+        return { startCardPayment: true };
+    if (intent.type === "bank_transfer") {
+        return { paymentMethod: "bank_transfer", startCardPayment: false };
+    }
+    return null;
+}
+function adapterBookingRequestForIntent(body) {
+    if (body.paymentIntent?.type !== "bank_transfer")
+        return body;
+    return {
+        ...body,
+        paymentIntent: { type: "hold" },
+    };
+}
 /** Build the flight admin routes (relative paths; mount at `/v1/admin/flights`). */
 export function createFlightAdminRoutes(options) {
     const { resolveAdapter, payment } = options;
@@ -96,7 +115,7 @@ export function createFlightAdminRoutes(options) {
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            return c.json({ error: message }, /not found/i.test(message) ? 404 : 500);
+            return c.json({ error: message }, statusForAdapterErrorMessage(message));
         }
     });
     // ── Re-price ────────────────────────────────────────────────────────────
@@ -132,12 +151,12 @@ export function createFlightAdminRoutes(options) {
         if (!body.passengers?.length)
             return c.json({ error: "passengers is required" }, 400);
         try {
-            const response = await resolveAdapter(c).bookFlight(buildContext(c), body);
-            // Hold is the default intent; eagerly create the payment session so the
-            // order page can show the shareable link immediately.
-            const isHold = !body.paymentIntent || body.paymentIntent.type === "hold";
-            if (isHold && response.order && payment) {
-                const summary = await payment.ensureOrderSession(c, response.order, body.contact);
+            const response = await resolveAdapter(c).bookFlight(buildContext(c), adapterBookingRequestForIntent(body));
+            // Hold is the default intent. Bank transfer also needs a finance session
+            // so the order can expose the reference/instructions through checkout.
+            const paymentSessionOptions = paymentSessionOptionsForIntent(body.paymentIntent);
+            if (paymentSessionOptions && response.order && payment) {
+                const summary = await payment.ensureOrderSession(c, response.order, body.contact, paymentSessionOptions);
                 response.order = attachPaymentSession(response.order, summary);
             }
             return c.json(response);
@@ -191,14 +210,15 @@ export function createFlightAdminRoutes(options) {
         try {
             const response = await resolveAdapter(c).getOrder(buildContext(c), orderId);
             if (response.order && payment) {
-                const summary = await payment.ensureOrderSession(c, response.order, response.order.contact);
+                const sessionByOrderId = await payment.fetchOrderSessions(c, [response.order.orderId]);
+                const summary = sessionByOrderId.get(response.order.orderId) ?? null;
                 response.order = attachPaymentSession(response.order, summary);
             }
             return c.json(response);
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            return c.json({ error: message }, /not found/i.test(message) ? 404 : 500);
+            return c.json({ error: message }, statusForAdapterErrorMessage(message));
         }
     });
     // ── Cancel order ────────────────────────────────────────────────────────
@@ -219,7 +239,7 @@ export function createFlightAdminRoutes(options) {
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            return c.json({ error: message }, /not found/i.test(message) ? 404 : 500);
+            return c.json({ error: message }, statusForAdapterErrorMessage(message));
         }
     });
     // ── Reference: airports (with substring search) ───────────────────────────

package/dist/hono.test.js

@@ -1,6 +1,6 @@
 import { Hono } from "hono";
 import { describe, expect, it, vi } from "vitest";
-import { createFlightAdminRoutes, createFlightsHonoModule } from "./hono.js";
+import { createFlightAdminRoutes, createFlightsHonoModule, } from "./hono.js";
 function stubAdapter(over = {}) {
     return {
         capabilities: { provider: "stub", declared: [] },
@@ -12,8 +12,8 @@ function stubAdapter(over = {}) {
         ...over,
     };
 }
-function mount(adapter) {
-    return new Hono().route("/v1/admin/flights", createFlightAdminRoutes({ resolveAdapter: () => adapter }));
+function mount(adapter, payment) {
+    return new Hono().route("/v1/admin/flights", createFlightAdminRoutes({ resolveAdapter: () => adapter, payment }));
 }
 describe("flights hono module", () => {
     it("createFlightsHonoModule exposes adminRoutes on module 'flights'", () => {
@@ -50,4 +50,244 @@ describe("flights hono module", () => {
         });
         expect(res.status).toBe(501);
     });
+    it("creates and attaches a bank-transfer payment session during booking", async () => {
+        const adapter = stubAdapter();
+        const payment = {
+            ensureOrderSession: vi.fn(async () => ({ sessionId: "ps_bank", status: "pending" })),
+            fetchOrderSessions: vi.fn(async () => new Map()),
+        };
+        const app = mount(adapter, payment);
+        const res = await app.request("/v1/admin/flights/book", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                offerId: "off_1",
+                passengers: [{ passengerId: "p1" }],
+                contact: { email: "payer@example.com" },
+                paymentIntent: { type: "bank_transfer" },
+            }),
+        });
+        expect(res.status).toBe(200);
+        await expect(res.json()).resolves.toMatchObject({
+            order: {
+                providerData: {
+                    paymentSessionId: "ps_bank",
+                    paymentStatus: "pending",
+                },
+            },
+        });
+        expect(payment.ensureOrderSession).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({ orderId: "ord_1" }), { email: "payer@example.com" }, { paymentMethod: "bank_transfer", startCardPayment: false });
+        expect(adapter.bookFlight).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({ paymentIntent: { type: "hold" } }));
+    });
+    it("preserves hold payment-session creation during booking", async () => {
+        const adapter = stubAdapter();
+        const payment = {
+            ensureOrderSession: vi.fn(async () => ({ sessionId: "ps_hold", status: "pending" })),
+            fetchOrderSessions: vi.fn(async () => new Map()),
+        };
+        const app = mount(adapter, payment);
+        const res = await app.request("/v1/admin/flights/book", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                offerId: "off_1",
+                passengers: [{ passengerId: "p1" }],
+                paymentIntent: { type: "hold" },
+            }),
+        });
+        expect(res.status).toBe(200);
+        expect(payment.ensureOrderSession).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({ orderId: "ord_1" }), undefined, { startCardPayment: true });
+    });
+    it("does not create a payment session for card booking intent", async () => {
+        const adapter = stubAdapter();
+        const payment = {
+            ensureOrderSession: vi.fn(async () => ({ sessionId: "ps_card", status: "pending" })),
+            fetchOrderSessions: vi.fn(async () => new Map()),
+        };
+        const app = mount(adapter, payment);
+        const res = await app.request("/v1/admin/flights/book", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                offerId: "off_1",
+                passengers: [{ passengerId: "p1" }],
+                paymentIntent: { type: "card", token: "tok_1" },
+            }),
+        });
+        expect(res.status).toBe(200);
+        expect(payment.ensureOrderSession).not.toHaveBeenCalled();
+        expect(adapter.bookFlight).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({ paymentIntent: { type: "card", token: "tok_1" } }));
+    });
+    it("does not create a delayed payment session when reading a card-ticketed order", async () => {
+        const adapter = stubAdapter({
+            bookFlight: vi.fn(async () => ({
+                order: {
+                    orderId: "ord_card",
+                    status: "ticketed",
+                    passengers: [{ passengerId: "p1" }],
+                },
+            })),
+            getOrder: vi.fn(async () => ({
+                order: {
+                    orderId: "ord_card",
+                    status: "ticketed",
+                    passengers: [{ passengerId: "p1" }],
+                },
+            })),
+        });
+        const payment = {
+            ensureOrderSession: vi.fn(async () => ({ sessionId: "ps_card", status: "pending" })),
+            fetchOrderSessions: vi.fn(async () => new Map()),
+        };
+        const app = mount(adapter, payment);
+        const bookRes = await app.request("/v1/admin/flights/book", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                offerId: "off_1",
+                passengers: [{ passengerId: "p1" }],
+                paymentIntent: { type: "card", token: "tok_1" },
+            }),
+        });
+        const readRes = await app.request("/v1/admin/flights/orders/ord_card");
+        expect(bookRes.status).toBe(200);
+        expect(readRes.status).toBe(200);
+        await expect(readRes.json()).resolves.toMatchObject({
+            order: {
+                orderId: "ord_card",
+                status: "ticketed",
+            },
+        });
+        expect(payment.ensureOrderSession).not.toHaveBeenCalled();
+        expect(payment.fetchOrderSessions).toHaveBeenCalledWith(expect.anything(), ["ord_card"]);
+    });
+    it("GET /orders/:orderId attaches an existing payment session without ensuring one", async () => {
+        const adapter = stubAdapter({
+            getOrder: vi.fn(async () => ({
+                order: {
+                    orderId: "ord_1",
+                    passengers: [],
+                    providerData: { source: "stub" },
+                },
+            })),
+        });
+        const payment = {
+            ensureOrderSession: vi.fn(async () => {
+                throw new Error("GET must not create or start payment sessions");
+            }),
+            fetchOrderSessions: vi.fn(async () => new Map([["ord_1", { sessionId: "ps_existing", status: "pending" }]])),
+        };
+        const app = mount(adapter, payment);
+        const res = await app.request("/v1/admin/flights/orders/ord_1");
+        expect(res.status).toBe(200);
+        await expect(res.json()).resolves.toMatchObject({
+            order: {
+                providerData: {
+                    source: "stub",
+                    paymentSessionId: "ps_existing",
+                    paymentStatus: "pending",
+                },
+            },
+        });
+        expect(payment.fetchOrderSessions).toHaveBeenCalledWith(expect.anything(), ["ord_1"]);
+        expect(payment.ensureOrderSession).not.toHaveBeenCalled();
+    });
+    it("does not create payment sessions when listing orders", async () => {
+        const adapter = stubAdapter({
+            listOrders: vi.fn(async () => ({
+                orders: [{ orderId: "ord_card", status: "ticketed", passengers: [] }],
+                pagination: { total: 1, hasMore: false },
+            })),
+        });
+        const payment = {
+            ensureOrderSession: vi.fn(async () => ({ sessionId: "ps_unexpected", status: "pending" })),
+            fetchOrderSessions: vi.fn(async () => new Map()),
+        };
+        const app = mount(adapter, payment);
+        const res = await app.request("/v1/admin/flights/orders");
+        expect(res.status).toBe(200);
+        await expect(res.json()).resolves.toMatchObject({
+            orders: [{ orderId: "ord_card", status: "ticketed" }],
+        });
+        expect(payment.fetchOrderSessions).toHaveBeenCalledWith(expect.anything(), ["ord_card"]);
+        expect(payment.ensureOrderSession).not.toHaveBeenCalled();
+    });
+    it("GET /orders attaches existing payment sessions without ensuring any", async () => {
+        const adapter = stubAdapter({
+            listOrders: vi.fn(async () => ({
+                orders: [
+                    { orderId: "ord_1", passengers: [] },
+                    { orderId: "ord_2", passengers: [] },
+                ],
+                pagination: { total: 2, hasMore: false },
+            })),
+        });
+        const payment = {
+            ensureOrderSession: vi.fn(async () => {
+                throw new Error("GET must not create or start payment sessions");
+            }),
+            fetchOrderSessions: vi.fn(async () => new Map([
+                ["ord_1", { sessionId: "ps_1", status: "pending" }],
+                ["ord_2", { sessionId: "ps_2", status: "paid" }],
+            ])),
+        };
+        const app = mount(adapter, payment);
+        const res = await app.request("/v1/admin/flights/orders");
+        expect(res.status).toBe(200);
+        await expect(res.json()).resolves.toMatchObject({
+            orders: [
+                { providerData: { paymentSessionId: "ps_1", paymentStatus: "pending" } },
+                { providerData: { paymentSessionId: "ps_2", paymentStatus: "paid" } },
+            ],
+        });
+        expect(payment.fetchOrderSessions).toHaveBeenCalledWith(expect.anything(), ["ord_1", "ord_2"]);
+        expect(payment.ensureOrderSession).not.toHaveBeenCalled();
+    });
+    it("attaches an existing payment session when reading an order", async () => {
+        const adapter = stubAdapter({
+            getOrder: vi.fn(async () => ({
+                order: { orderId: "ord_hold", status: "confirmed", passengers: [] },
+            })),
+        });
+        const payment = {
+            ensureOrderSession: vi.fn(async () => ({ sessionId: "ps_unexpected", status: "pending" })),
+            fetchOrderSessions: vi.fn(async () => new Map([["ord_hold", { sessionId: "ps_existing", status: "paid" }]])),
+        };
+        const app = mount(adapter, payment);
+        const res = await app.request("/v1/admin/flights/orders/ord_hold");
+        expect(res.status).toBe(200);
+        await expect(res.json()).resolves.toMatchObject({
+            order: {
+                providerData: {
+                    paymentSessionId: "ps_existing",
+                    paymentStatus: "paid",
+                },
+            },
+        });
+        expect(payment.ensureOrderSession).not.toHaveBeenCalled();
+    });
+    it("returns 404 when reading a missing order", async () => {
+        const adapter = stubAdapter({
+            getOrder: vi.fn(async () => {
+                throw new Error("order_not_found");
+            }),
+        });
+        const app = mount(adapter);
+        const res = await app.request("/v1/admin/flights/orders/no_such_order");
+        expect(res.status).toBe(404);
+        await expect(res.json()).resolves.toEqual({ error: "order_not_found" });
+    });
+    it("returns 404 when cancelling a missing order", async () => {
+        const adapter = stubAdapter({
+            cancelOrder: vi.fn(async () => {
+                throw new Error("order_not_found");
+            }),
+        });
+        const app = mount(adapter);
+        const res = await app.request("/v1/admin/flights/orders/no_such_order/cancel", {
+            method: "POST",
+        });
+        expect(res.status).toBe(404);
+        await expect(res.json()).resolves.toEqual({ error: "order_not_found" });
+    });
 });

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { createFlightAdminRoutes, createFlightsHonoModule, type FlightOrderPayme
 export { FLIGHTS_ENTITY_MODULE, mergedFlightOffersToCandidates, mergedFlightOfferToCandidate, } from "./orchestration/availability-bridge.js";
 export { type ConnectionResult, type ConnectionSearchStatus, type FanOutFlightSearchOptions, type FanOutFlightSearchResult, fanOutFlightSearch, type MergedFlightOffer, } from "./orchestration/fan-out.js";
 export { itineraryFingerprint } from "./orchestration/fingerprint.js";
-export { buildFlightSummary, createFlightOrderPaymentIntegration, type FlightCardBilling, type FlightOrderPaymentIntegrationDeps, formatDay, type OrderPaymentSessionsLike, parseAmountToCents, synthesizeBilling, } from "./payment-integration.js";
+export { buildFlightSummary, createFlightOrderPaymentIntegration, type FlightCardBilling, type FlightOrderPaymentIntegrationDeps, type FlightOrderPaymentSessionOptions, formatDay, type OrderPaymentSessionsLike, parseAmountToCents, synthesizeBilling, } from "./payment-integration.js";
 export { type Aircraft, type Airline, type Airport, dedupeCodes, type ReferenceDataCapabilities, type ReferenceDataProvider, } from "./reference/contract.js";
 export { createLocalPostgresReferenceProvider, type LocalPostgresReferenceProviderOptions, referenceAircraft, referenceAirlines, referenceAirports, } from "./reference/local-postgres.js";
 export { createStaticBundleReferenceProvider, type StaticBundleProviderOptions, type StaticBundleReferenceData, } from "./reference/static-bundle.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,aAAa,EAClB,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,iCAAiC,EACjC,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AAGnC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AAGrE,OAAO,EACL,kBAAkB,EAClB,mCAAmC,EACnC,KAAK,iBAAiB,EACtB,KAAK,iCAAiC,EACtC,SAAS,EACT,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,WAAW,EACX,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,GAC3B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,oCAAoC,EACpC,KAAK,qCAAqC,EAC1C,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EACL,mCAAmC,EACnC,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,GAC/B,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,KAAK,+BAA+B,EACpC,wBAAwB,GACzB,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,aAAa,EAClB,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,iCAAiC,EACjC,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AAGnC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAA;AAGrE,OAAO,EACL,kBAAkB,EAClB,mCAAmC,EACnC,KAAK,iBAAiB,EACtB,KAAK,iCAAiC,EACtC,KAAK,gCAAgC,EACrC,SAAS,EACT,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,WAAW,EACX,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,GAC3B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,oCAAoC,EACpC,KAAK,qCAAqC,EAC1C,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EACL,mCAAmC,EACnC,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,GAC/B,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,KAAK,+BAA+B,EACpC,wBAAwB,GACzB,MAAM,eAAe,CAAA"}

package/dist/payment-integration.d.ts

@@ -1,6 +1,7 @@
 /**
  * Flight-specific payment integration: maps a `FlightOrder` onto finance's
- * generic order-payment-session service and (optionally) a card provider.
+ * generic order-payment-session service and, for card-capable flows,
+ * optionally starts a card provider.
  *
  * The flights module stays payment-provider agnostic AND finance-agnostic — the
  * deps below are typed STRUCTURALLY so this file imports neither
@@ -53,6 +54,7 @@ export interface OrderPaymentSessionsLike {
         payerEmail?: string | null;
         payerName?: string | null;
         notes?: string | null;
+        paymentMethod?: "bank_transfer" | "credit_card" | null;
     }, startProvider?: (db: AnyDrizzleDb, sessionId: string) => Promise<void>): Promise<{
         sessionId: string;
         status: string;
@@ -62,6 +64,10 @@ export interface OrderPaymentSessionsLike {
         status: string;
     }>>;
 }
+export interface FlightOrderPaymentSessionOptions {
+    paymentMethod?: "bank_transfer" | "credit_card";
+    startCardPayment?: boolean;
+}
 export interface FlightOrderPaymentIntegrationDeps {
     /** Finance's generic order-payment-session service (structural). */
     orderPaymentSessions: OrderPaymentSessionsLike;

package/dist/payment-integration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment-integration.d.ts","sourceRoot":"","sources":["../src/payment-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACvE,OAAO,KAAK,EAA6B,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAQpF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,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,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GACtD,iBAAiB,CAYnB;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAgB7D;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,CACX,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KACtB,EACD,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACrE,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IACxD,aAAa,CACX,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;CAC/D;AAED,MAAM,WAAW,iCAAiC;IAChD,oEAAoE;IACpE,oBAAoB,EAAE,wBAAwB,CAAA;IAC9C;;;;;;;;OAQG;IACH,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5F;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,iCAAiC,GACtC,wBAAwB,CAoC1B"}
+{"version":3,"file":"payment-integration.d.ts","sourceRoot":"","sources":["../src/payment-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACvE,OAAO,KAAK,EAA6B,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAQpF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,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,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GACtD,iBAAiB,CAYnB;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAgB7D;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,CACX,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACrB,aAAa,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,IAAI,CAAA;KACvD,EACD,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACrE,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IACxD,aAAa,CACX,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;CAC/D;AAED,MAAM,WAAW,gCAAgC;IAC/C,aAAa,CAAC,EAAE,eAAe,GAAG,aAAa,CAAA;IAC/C,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,iCAAiC;IAChD,oEAAoE;IACpE,oBAAoB,EAAE,wBAAwB,CAAA;IAC9C;;;;;;;;OAQG;IACH,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5F;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,iCAAiC,GACtC,wBAAwB,CAuC1B"}

package/dist/payment-integration.js

@@ -58,13 +58,14 @@ export function buildFlightSummary(order) {
 export function createFlightOrderPaymentIntegration(deps) {
     const { orderPaymentSessions, startCardPayment } = deps;
     return {
-        async ensureOrderSession(c, order, contact) {
+        async ensureOrderSession(c, order, contact, options) {
             const db = getDb(c);
             const passengerForBilling = order.passengers[0];
             if (!passengerForBilling)
                 return null;
             const amountCents = parseAmountToCents(order.totalPrice.amount);
-            const startProvider = startCardPayment
+            const shouldStartCardPayment = options?.startCardPayment ?? true;
+            const startProvider = startCardPayment && shouldStartCardPayment
                 ? (_writer, sessionId) => startCardPayment(c, sessionId, synthesizeBilling(passengerForBilling, contact))
                 : undefined;
             return orderPaymentSessions.ensureSession(db, {
@@ -74,6 +75,7 @@ export function createFlightOrderPaymentIntegration(deps) {
                 payerEmail: contact?.email ?? passengerForBilling.email ?? null,
                 payerName: `${passengerForBilling.firstName} ${passengerForBilling.lastName}`.trim(),
                 notes: buildFlightSummary(order),
+                paymentMethod: options?.paymentMethod,
             }, startProvider);
         },
         async fetchOrderSessions(c, orderIds) {

package/dist/payment-integration.test.js

@@ -83,6 +83,20 @@ describe("createFlightOrderPaymentIntegration", () => {
             notes: expect.stringContaining("LHR → CDG"),
         }), undefined);
     });
+    it("stamps bank-transfer sessions without starting the card provider", async () => {
+        const startCardPayment = vi.fn(async () => undefined);
+        const orderPaymentSessions = stubSessions();
+        const integration = createFlightOrderPaymentIntegration({
+            orderPaymentSessions,
+            startCardPayment,
+        });
+        await integration.ensureOrderSession(stubContext(), stubOrder(), undefined, {
+            paymentMethod: "bank_transfer",
+            startCardPayment: false,
+        });
+        expect(orderPaymentSessions.ensureSession).toHaveBeenCalledWith(DB, expect.objectContaining({ paymentMethod: "bank_transfer" }), undefined);
+        expect(startCardPayment).not.toHaveBeenCalled();
+    });
     it("returns null when the order has no passengers", async () => {
         const orderPaymentSessions = stubSessions();
         const integration = createFlightOrderPaymentIntegration({ orderPaymentSessions });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/flights",
-  "version": "0.137.0",
+  "version": "0.137.2",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -81,18 +81,18 @@
   },
   "dependencies": {
     "drizzle-orm": "^0.45.2",
-    "hono": "^4.12.10",
-    "zod": "^4.3.6",
+    "hono": "^4.12.25",
+    "zod": "^4.4.3",
     "@voyant-travel/db": "^0.109.4",
-    "@voyant-travel/catalog": "^0.135.0",
+    "@voyant-travel/catalog": "^0.135.6",
     "@voyant-travel/catalog-contracts": "^0.108.0",
-    "@voyant-travel/flights-contracts": "^0.104.5",
-    "@voyant-travel/hono": "^0.117.0"
+    "@voyant-travel/flights-contracts": "^0.104.6",
+    "@voyant-travel/hono": "^0.118.2"
   },
   "devDependencies": {
     "drizzle-kit": "^0.31.10",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9",
     "@voyant-travel/voyant-typescript-config": "^0.1.0"
   },
   "repository": {
@@ -101,10 +101,10 @@
     "directory": "packages/flights"
   },
   "scripts": {
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
     "lint": "biome check src/",
     "test": "vitest run",
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.build.json",
     "clean": "rm -rf dist tsconfig.tsbuildinfo",
     "db:generate": "drizzle-kit generate --config=drizzle.migrations.config.ts --name=flights_baseline && node ../../scripts/migrations/guard-create-type.mjs ./migrations && node ../../scripts/migrations/ensure-extensions.mjs ./migrations"
   },