@voyant-travel/flights 0.120.1 → 0.122.0

package/dist/hono.d.ts

@@ -0,0 +1,41 @@
+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. */
+export interface FlightOrderPaymentSummary {
+    sessionId: string;
+    status: string;
+}
+/**
+ * Deployment-supplied payment integration for flight hold 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. */
+    ensureOrderSession(c: Context, order: FlightOrder, contact?: {
+        email?: string;
+        phone?: string;
+    }): 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>>;
+}
+export interface FlightsRouteOptions {
+    /**
+     * Resolve the flight connector adapter for a request. The deployment picks
+     * the demo connector or a real GDS (Sabre / Amadeus / Duffel).
+     */
+    resolveAdapter(c: Context): FlightConnectorAdapter;
+    /** Optional payment-link integration for hold orders. */
+    payment?: FlightPaymentIntegration;
+}
+export type FlightsHonoModuleOptions = FlightsRouteOptions;
+/** Build the flight admin routes (relative paths; mount at `/v1/admin/flights`). */
+export declare function createFlightAdminRoutes(options: FlightsRouteOptions): Hono;
+/**
+ * The flights route module — mounts the admin routes at `/v1/admin/flights`.
+ * A deployment composes this and supplies the connector + payment options.
+ */
+export declare function createFlightsHonoModule(options: FlightsHonoModuleOptions): HonoModule;
+//# sourceMappingURL=hono.d.ts.map

package/dist/hono.d.ts.map

@@ -0,0 +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"}

package/dist/hono.js

@@ -0,0 +1,265 @@
+import { ilike, or } from "drizzle-orm";
+import { Hono } from "hono";
+import { referenceAircraft, referenceAirlines, referenceAirports, } from "./reference/local-postgres.js";
+function buildContext(c) {
+    return {
+        connectionId: "demo",
+        correlationId: c.req.header("x-request-id") ?? undefined,
+    };
+}
+// `c.var.db` is set by the createApp DB middleware; the global ContextVariableMap
+// doesn't declare it, so cast at the call site to keep type-safety local.
+function getDb(c) {
+    return c.var.db;
+}
+function attachPaymentSession(order, summary) {
+    if (!summary)
+        return order;
+    return {
+        ...order,
+        providerData: {
+            ...(order.providerData ?? {}),
+            paymentSessionId: summary.sessionId,
+            paymentStatus: summary.status,
+        },
+    };
+}
+/** Build the flight admin routes (relative paths; mount at `/v1/admin/flights`). */
+export function createFlightAdminRoutes(options) {
+    const { resolveAdapter, payment } = options;
+    const hono = new Hono();
+    // ── Search ──────────────────────────────────────────────────────────────
+    hono.post("/search", async (c) => {
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ error: "Invalid JSON body" }, 400);
+        }
+        if (!body.slices?.length)
+            return c.json({ error: "slices is required" }, 400);
+        if (!body.passengers?.adults || body.passengers.adults < 1) {
+            return c.json({ error: "passengers.adults must be at least 1" }, 400);
+        }
+        try {
+            const response = await resolveAdapter(c).searchFlights(buildContext(c), body);
+            return c.json(response);
+        }
+        catch (err) {
+            return c.json({ error: err instanceof Error ? err.message : String(err) }, 500);
+        }
+    });
+    // ── Ancillaries ─────────────────────────────────────────────────────────
+    hono.post("/ancillaries", async (c) => {
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ error: "Invalid JSON body" }, 400);
+        }
+        if (!body.offerId)
+            return c.json({ error: "offerId is required" }, 400);
+        const adapter = resolveAdapter(c);
+        if (!adapter.getAncillaries) {
+            return c.json({ error: "Connector does not declare flight/ancillaries capability" }, 501);
+        }
+        try {
+            const response = await adapter.getAncillaries(buildContext(c), body);
+            return c.json(response);
+        }
+        catch (err) {
+            return c.json({ error: err instanceof Error ? err.message : String(err) }, 500);
+        }
+    });
+    // ── Seat map ────────────────────────────────────────────────────────────
+    hono.post("/seatmap", async (c) => {
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ error: "Invalid JSON body" }, 400);
+        }
+        if (!body.offerId)
+            return c.json({ error: "offerId is required" }, 400);
+        if (!body.segmentId)
+            return c.json({ error: "segmentId is required" }, 400);
+        const adapter = resolveAdapter(c);
+        if (!adapter.getSeatMap) {
+            return c.json({ error: "Connector does not declare flight/seatmap capability" }, 501);
+        }
+        try {
+            const response = await adapter.getSeatMap(buildContext(c), body);
+            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);
+        }
+    });
+    // ── Re-price ────────────────────────────────────────────────────────────
+    hono.post("/price", async (c) => {
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ error: "Invalid JSON body" }, 400);
+        }
+        if (!body.offerId)
+            return c.json({ error: "offerId is required" }, 400);
+        try {
+            const response = await resolveAdapter(c).priceOffer(buildContext(c), body);
+            return c.json(response);
+        }
+        catch (err) {
+            return c.json({ error: err instanceof Error ? err.message : String(err) }, 500);
+        }
+    });
+    // ── Book ────────────────────────────────────────────────────────────────
+    hono.post("/book", async (c) => {
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ error: "Invalid JSON body" }, 400);
+        }
+        if (!body.offerId)
+            return c.json({ error: "offerId is required" }, 400);
+        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);
+                response.order = attachPaymentSession(response.order, summary);
+            }
+            return c.json(response);
+        }
+        catch (err) {
+            return c.json({ error: err instanceof Error ? err.message : String(err) }, 500);
+        }
+    });
+    // ── List orders ─────────────────────────────────────────────────────────
+    hono.get("/orders", async (c) => {
+        const adapter = resolveAdapter(c);
+        if (!adapter.listOrders) {
+            return c.json({ error: "Adapter does not support listing orders" }, 501);
+        }
+        const url = new URL(c.req.url);
+        const limitParam = url.searchParams.get("limit");
+        const cursor = url.searchParams.get("cursor") ?? undefined;
+        const search = url.searchParams.get("q") ?? url.searchParams.get("search") ?? undefined;
+        const statusParam = url.searchParams.getAll("status");
+        const status = statusParam.length > 0 ? statusParam : undefined;
+        const limit = limitParam
+            ? Math.max(1, Math.min(100, Number.parseInt(limitParam, 10)))
+            : undefined;
+        const paymentStatusParam = url.searchParams.getAll("paymentStatus");
+        const paymentStatusFilter = paymentStatusParam.length > 0 ? new Set(paymentStatusParam) : null;
+        try {
+            const response = await adapter.listOrders(buildContext(c), {
+                ...(limit !== undefined ? { limit } : {}),
+                ...(cursor !== undefined ? { cursor } : {}),
+                ...(search !== undefined ? { search } : {}),
+                ...(status !== undefined ? { status } : {}),
+            });
+            if (payment) {
+                const sessionByOrderId = await payment.fetchOrderSessions(c, response.orders.map((o) => o.orderId));
+                response.orders = response.orders.map((order) => attachPaymentSession(order, sessionByOrderId.get(order.orderId) ?? null));
+            }
+            if (paymentStatusFilter) {
+                response.orders = response.orders.filter((o) => paymentStatusFilter.has(o.providerData?.paymentStatus ?? "none"));
+            }
+            return c.json(response);
+        }
+        catch (err) {
+            return c.json({ error: err instanceof Error ? err.message : String(err) }, 500);
+        }
+    });
+    // ── Get order ───────────────────────────────────────────────────────────
+    hono.get("/orders/:orderId", async (c) => {
+        const orderId = c.req.param("orderId");
+        if (!orderId)
+            return c.json({ error: "orderId is required" }, 400);
+        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);
+                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);
+        }
+    });
+    // ── Cancel order ────────────────────────────────────────────────────────
+    hono.post("/orders/:orderId/cancel", async (c) => {
+        const orderId = c.req.param("orderId");
+        if (!orderId)
+            return c.json({ error: "orderId is required" }, 400);
+        let body = {};
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            // Body is optional for cancel.
+        }
+        try {
+            const response = await resolveAdapter(c).cancelOrder(buildContext(c), orderId, body.reason);
+            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);
+        }
+    });
+    // ── Reference: airports (with substring search) ───────────────────────────
+    hono.get("/reference/airports", async (c) => {
+        const db = getDb(c);
+        const q = c.req.query("q")?.trim();
+        const limit = Math.min(Number(c.req.query("limit") ?? 50), 200);
+        let rows;
+        if (q) {
+            const pattern = `%${q}%`;
+            rows = await db
+                .select()
+                .from(referenceAirports)
+                .where(or(ilike(referenceAirports.iataCode, pattern), ilike(referenceAirports.city, pattern), ilike(referenceAirports.name, pattern)))
+                .limit(limit);
+        }
+        else {
+            rows = await db.select().from(referenceAirports).limit(limit);
+        }
+        return c.json({ data: rows });
+    });
+    // ── Reference: airlines (full list) ───────────────────────────────────────
+    hono.get("/reference/airlines", async (c) => {
+        const rows = await getDb(c).select().from(referenceAirlines);
+        return c.json({ data: rows });
+    });
+    // ── Reference: aircraft (full list) ────────────────────────────────────────
+    hono.get("/reference/aircraft", async (c) => {
+        const rows = await getDb(c).select().from(referenceAircraft);
+        return c.json({ data: rows });
+    });
+    return hono;
+}
+/**
+ * The flights route module — mounts the admin routes at `/v1/admin/flights`.
+ * A deployment composes this and supplies the connector + payment options.
+ */
+export function createFlightsHonoModule(options) {
+    return {
+        module: { name: "flights" },
+        adminRoutes: createFlightAdminRoutes(options),
+    };
+}

package/dist/hono.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hono.test.d.ts.map

package/dist/hono.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.test.d.ts","sourceRoot":"","sources":["../src/hono.test.ts"],"names":[],"mappings":""}

package/dist/hono.test.js

@@ -0,0 +1,53 @@
+import { Hono } from "hono";
+import { describe, expect, it, vi } from "vitest";
+import { createFlightAdminRoutes, createFlightsHonoModule } from "./hono.js";
+function stubAdapter(over = {}) {
+    return {
+        capabilities: { provider: "stub", declared: [] },
+        searchFlights: vi.fn(async () => ({ offers: [] })),
+        priceOffer: vi.fn(async () => ({ offer: {}, valid: true })),
+        bookFlight: vi.fn(async () => ({ order: { orderId: "ord_1", passengers: [] } })),
+        getOrder: vi.fn(async () => ({ order: { orderId: "ord_1", passengers: [] } })),
+        cancelOrder: vi.fn(async () => ({ order: { orderId: "ord_1" } })),
+        ...over,
+    };
+}
+function mount(adapter) {
+    return new Hono().route("/v1/admin/flights", createFlightAdminRoutes({ resolveAdapter: () => adapter }));
+}
+describe("flights hono module", () => {
+    it("createFlightsHonoModule exposes adminRoutes on module 'flights'", () => {
+        const mod = createFlightsHonoModule({ resolveAdapter: () => stubAdapter() });
+        expect(mod.module.name).toBe("flights");
+        expect(mod.adminRoutes).toBeDefined();
+    });
+    it("POST /search delegates to the resolved adapter", async () => {
+        const adapter = stubAdapter();
+        const app = mount(adapter);
+        const res = await app.request("/v1/admin/flights/search", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ slices: [{}], passengers: { adults: 1 } }),
+        });
+        expect(res.status).toBe(200);
+        expect(adapter.searchFlights).toHaveBeenCalledTimes(1);
+    });
+    it("POST /search validates required fields", async () => {
+        const app = mount(stubAdapter());
+        const res = await app.request("/v1/admin/flights/search", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ passengers: { adults: 1 } }),
+        });
+        expect(res.status).toBe(400);
+    });
+    it("returns 501 when the connector lacks an optional capability", async () => {
+        const app = mount(stubAdapter());
+        const res = await app.request("/v1/admin/flights/ancillaries", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ offerId: "off_1" }),
+        });
+        expect(res.status).toBe(501);
+    });
+});

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 export { type AdapterLogger, CAPABILITY_NOT_SUPPORTED, type FlightAdapterCapabilities, type FlightAdapterContext, type FlightAdapterEnvironment, type FlightBookResponse, type FlightCancelReason, type FlightCancelResponse, FlightCapabilityNotSupportedError, type FlightConnectorAdapter, type FlightGetOrderResponse, type FlightPriceRequest, type FlightPriceResponse, type FlightSearchResponse, requireCapability, } from "./contract/adapter.js";
 export * from "./contract/schemas.js";
 export * from "./contract/types.js";
+export { createFlightAdminRoutes, createFlightsHonoModule, type FlightOrderPaymentSummary, type FlightPaymentIntegration, type FlightsHonoModuleOptions, type FlightsRouteOptions, } from "./hono.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 { 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;AACnC,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;AAErE,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,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"}

package/dist/index.js

@@ -3,9 +3,15 @@
 export { CAPABILITY_NOT_SUPPORTED, FlightCapabilityNotSupportedError, requireCapability, } from "./contract/adapter.js";
 export * from "./contract/schemas.js";
 export * from "./contract/types.js";
+// Flight admin HTTP routes (module-owned; the deployment supplies connector +
+// payment options).
+export { createFlightAdminRoutes, createFlightsHonoModule, } from "./hono.js";
 export { fanOutFlightSearch, } from "./orchestration/fan-out.js";
 // Orchestration — fingerprinting + multi-connection fan-out.
 export { itineraryFingerprint } from "./orchestration/fingerprint.js";
+// Flight-specific payment integration — maps a FlightOrder onto a generic
+// order-payment-session service + an optional card provider (both structural).
+export { buildFlightSummary, createFlightOrderPaymentIntegration, formatDay, parseAmountToCents, synthesizeBilling, } from "./payment-integration.js";
 // ReferenceDataProvider — swappable provider for global reference data.
 export { dedupeCodes, } from "./reference/contract.js";
 export { createLocalPostgresReferenceProvider, referenceAircraft, referenceAirlines, referenceAirports, } from "./reference/local-postgres.js";

package/dist/payment-integration.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Flight-specific payment integration: maps a `FlightOrder` onto finance's
+ * generic order-payment-session service and (optionally) a card provider.
+ *
+ * The flights module stays payment-provider agnostic AND finance-agnostic — the
+ * deps below are typed STRUCTURALLY so this file imports neither
+ * `@voyant-travel/finance` nor any payment provider. The deployment wires the
+ * concrete services in `createFlightOrderPaymentIntegration({ ... })`.
+ *
+ * What's flight-specific (and therefore lives here, not in finance):
+ *   - mapping `order.totalPrice` → amountCents/currency,
+ *   - picking the payer from `order.passengers[0]`,
+ *   - the `notes` summary (`buildFlightSummary`),
+ *   - synthesizing card billing (`synthesizeBilling`).
+ */
+import type { AnyDrizzleDb } from "@voyant-travel/db";
+import type { Context } from "hono";
+import type { FlightOrder, FlightPassenger } from "./contract/types.js";
+import type { FlightPaymentIntegration } from "./hono.js";
+export declare function parseAmountToCents(amount: string): number;
+/** Card billing details synthesized from a passenger + (optional) contact. */
+export interface FlightCardBilling {
+    email: string;
+    phone: string;
+    firstName: string;
+    lastName: string;
+    city: string;
+    country: number;
+    state: string;
+    postalCode: string;
+    details: string;
+}
+export declare function synthesizeBilling(pax: FlightPassenger, contact: {
+    email?: string;
+    phone?: string;
+} | undefined): FlightCardBilling;
+export declare function formatDay(iso: string): string;
+/**
+ * Build a single-line human summary of the flight order — surfaced as
+ * `payment_session.notes` so the public landing page can show what's being paid.
+ */
+export declare function buildFlightSummary(order: FlightOrder): string;
+/**
+ * Structural shape of finance's generic order-payment-session service. Matches
+ * `@voyant-travel/finance`'s `createOrderPaymentSessions(...)` return value —
+ * declared here (not imported) so flights never depends on finance.
+ */
+export interface OrderPaymentSessionsLike {
+    ensureSession(db: AnyDrizzleDb, params: {
+        targetId: string;
+        currency: string;
+        amountCents: number;
+        payerEmail?: string | null;
+        payerName?: string | null;
+        notes?: string | null;
+    }, startProvider?: (db: AnyDrizzleDb, sessionId: string) => Promise<void>): Promise<{
+        sessionId: string;
+        status: string;
+    } | null>;
+    fetchSessions(db: AnyDrizzleDb, targetIds: string[]): Promise<Map<string, {
+        sessionId: string;
+        status: string;
+    }>>;
+}
+export interface FlightOrderPaymentIntegrationDeps {
+    /** Finance's generic order-payment-session service (structural). */
+    orderPaymentSessions: OrderPaymentSessionsLike;
+    /**
+     * Optional card provider start. Best-effort — called after a session is
+     * created so the provider can populate the card redirect link. The deployment
+     * supplies its card provider (e.g. Netopia); flights stays provider-agnostic.
+     *
+     * Receives the request `Context` (so the deployment can resolve its
+     * request-scoped provider runtime / container) plus the new session id and
+     * synthesized card billing.
+     */
+    startCardPayment?(c: Context, sessionId: string, billing: FlightCardBilling): Promise<void>;
+}
+/**
+ * Build a {@link FlightPaymentIntegration} from the generic order-payment
+ * service + an optional card provider. The deployment composes this in its
+ * flights runtime wiring.
+ */
+export declare function createFlightOrderPaymentIntegration(deps: FlightOrderPaymentIntegrationDeps): FlightPaymentIntegration;
+//# sourceMappingURL=payment-integration.d.ts.map

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

@@ -0,0 +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"}

package/dist/payment-integration.js

@@ -0,0 +1,86 @@
+// `c.var.db` is set by the createApp DB middleware; the global ContextVariableMap
+// doesn't declare it, so cast at the call site to keep type-safety local.
+function getDb(c) {
+    return c.var.db;
+}
+export function parseAmountToCents(amount) {
+    const n = Number.parseFloat(amount);
+    if (!Number.isFinite(n))
+        return 0;
+    return Math.round(n * 100);
+}
+export function synthesizeBilling(pax, contact) {
+    return {
+        email: contact?.email ?? pax.email ?? "tbd@example.com",
+        phone: contact?.phone ?? pax.phone ?? "0000000000",
+        firstName: pax.firstName,
+        lastName: pax.lastName,
+        city: "TBD",
+        country: 642, // ISO 3166-1 numeric — Romania default; customer overrides on hosted form.
+        state: "TBD",
+        postalCode: "00000",
+        details: "Pending — customer to confirm at payment.",
+    };
+}
+export function formatDay(iso) {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return iso;
+    return d.toLocaleDateString("en-GB", { weekday: "short", day: "numeric", month: "short" });
+}
+/**
+ * Build a single-line human summary of the flight order — surfaced as
+ * `payment_session.notes` so the public landing page can show what's being paid.
+ */
+export function buildFlightSummary(order) {
+    const parts = [];
+    for (const itin of order.offer.itineraries) {
+        if (itin.segments.length === 0)
+            continue;
+        const first = itin.segments[0];
+        const last = itin.segments[itin.segments.length - 1];
+        if (!first || !last)
+            continue;
+        parts.push(`${first.departure.iataCode} → ${last.arrival.iataCode} · ${formatDay(first.departure.at)}`);
+    }
+    const paxNames = order.passengers
+        .map((p) => `${p.firstName} ${p.lastName}`.trim())
+        .filter(Boolean);
+    if (paxNames.length > 0)
+        parts.push(paxNames.join(", "));
+    return parts.join("  ·  ");
+}
+/**
+ * Build a {@link FlightPaymentIntegration} from the generic order-payment
+ * service + an optional card provider. The deployment composes this in its
+ * flights runtime wiring.
+ */
+export function createFlightOrderPaymentIntegration(deps) {
+    const { orderPaymentSessions, startCardPayment } = deps;
+    return {
+        async ensureOrderSession(c, order, contact) {
+            const db = getDb(c);
+            const passengerForBilling = order.passengers[0];
+            if (!passengerForBilling)
+                return null;
+            const amountCents = parseAmountToCents(order.totalPrice.amount);
+            const startProvider = startCardPayment
+                ? (_writer, sessionId) => startCardPayment(c, sessionId, synthesizeBilling(passengerForBilling, contact))
+                : undefined;
+            return orderPaymentSessions.ensureSession(db, {
+                targetId: order.orderId,
+                currency: order.totalPrice.currency,
+                amountCents,
+                payerEmail: contact?.email ?? passengerForBilling.email ?? null,
+                payerName: `${passengerForBilling.firstName} ${passengerForBilling.lastName}`.trim(),
+                notes: buildFlightSummary(order),
+            }, startProvider);
+        },
+        async fetchOrderSessions(c, orderIds) {
+            const result = new Map();
+            if (orderIds.length === 0)
+                return result;
+            return orderPaymentSessions.fetchSessions(getDb(c), orderIds);
+        },
+    };
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=payment-integration.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payment-integration.test.d.ts","sourceRoot":"","sources":["../src/payment-integration.test.ts"],"names":[],"mappings":""}

package/dist/payment-integration.test.js

@@ -0,0 +1,124 @@
+import { describe, expect, it, vi } from "vitest";
+import { buildFlightSummary, createFlightOrderPaymentIntegration, parseAmountToCents, synthesizeBilling, } from "./payment-integration.js";
+const DB = { __db: true };
+let CTX;
+function stubContext() {
+    CTX = { var: { db: DB } };
+    return CTX;
+}
+function stubOrder(over = {}) {
+    return {
+        orderId: "ord_1",
+        status: "confirmed",
+        offer: {
+            itineraries: [
+                {
+                    segments: [
+                        {
+                            departure: { iataCode: "LHR", at: "2026-07-01T08:00:00Z" },
+                            arrival: { iataCode: "CDG", at: "2026-07-01T10:00:00Z" },
+                        },
+                    ],
+                },
+            ],
+        },
+        passengers: [
+            { passengerId: "p1", type: "adult", firstName: "Ada", lastName: "Lovelace" },
+        ],
+        totalPrice: { amount: "250.50", currency: "EUR" },
+        createdAt: "2026-06-01T00:00:00Z",
+        ...over,
+    };
+}
+describe("helpers", () => {
+    it("parseAmountToCents rounds to cents and guards non-finite", () => {
+        expect(parseAmountToCents("250.50")).toBe(25050);
+        expect(parseAmountToCents("not-a-number")).toBe(0);
+    });
+    it("synthesizeBilling prefers contact, falls back to passenger then defaults", () => {
+        const pax = {
+            passengerId: "p1",
+            type: "adult",
+            firstName: "Ada",
+            lastName: "Lovelace",
+            email: "pax@x.com",
+        };
+        expect(synthesizeBilling(pax, { email: "c@x.com" })).toMatchObject({
+            email: "c@x.com",
+            phone: "0000000000",
+            firstName: "Ada",
+            lastName: "Lovelace",
+            country: 642,
+        });
+        expect(synthesizeBilling(pax, undefined).email).toBe("pax@x.com");
+    });
+    it("buildFlightSummary renders route + passenger names", () => {
+        const summary = buildFlightSummary(stubOrder());
+        expect(summary).toContain("LHR → CDG");
+        expect(summary).toContain("Ada Lovelace");
+    });
+});
+describe("createFlightOrderPaymentIntegration", () => {
+    function stubSessions(over = {}) {
+        return {
+            ensureSession: vi.fn(async () => ({ sessionId: "ps_1", status: "pending" })),
+            fetchSessions: vi.fn(async () => new Map()),
+            ...over,
+        };
+    }
+    it("ensureOrderSession maps the order onto generic session params", async () => {
+        const orderPaymentSessions = stubSessions();
+        const integration = createFlightOrderPaymentIntegration({ orderPaymentSessions });
+        const result = await integration.ensureOrderSession(stubContext(), stubOrder(), {
+            email: "c@x.com",
+        });
+        expect(result).toEqual({ sessionId: "ps_1", status: "pending" });
+        expect(orderPaymentSessions.ensureSession).toHaveBeenCalledWith(DB, expect.objectContaining({
+            targetId: "ord_1",
+            currency: "EUR",
+            amountCents: 25050,
+            payerEmail: "c@x.com",
+            payerName: "Ada Lovelace",
+            notes: expect.stringContaining("LHR → CDG"),
+        }), undefined);
+    });
+    it("returns null when the order has no passengers", async () => {
+        const orderPaymentSessions = stubSessions();
+        const integration = createFlightOrderPaymentIntegration({ orderPaymentSessions });
+        const result = await integration.ensureOrderSession(stubContext(), stubOrder({ passengers: [] }));
+        expect(result).toBeNull();
+        expect(orderPaymentSessions.ensureSession).not.toHaveBeenCalled();
+    });
+    it("wires startCardPayment through the generic startProvider with synthesized billing", async () => {
+        const startCardPayment = vi.fn(async () => undefined);
+        const ensureSession = vi.fn(async (_db, _params, startProvider) => {
+            await startProvider?.(DB, "ps_new");
+            return { sessionId: "ps_new", status: "pending" };
+        });
+        const integration = createFlightOrderPaymentIntegration({
+            orderPaymentSessions: stubSessions({ ensureSession: ensureSession }),
+            startCardPayment,
+        });
+        const ctx = stubContext();
+        await integration.ensureOrderSession(ctx, stubOrder(), undefined);
+        expect(startCardPayment).toHaveBeenCalledWith(ctx, "ps_new", expect.objectContaining({ firstName: "Ada", lastName: "Lovelace", country: 642 }));
+    });
+    it("fetchOrderSessions delegates to the generic service", async () => {
+        const fetchSessions = vi.fn(async () => new Map([["ord_1", { sessionId: "ps_1", status: "paid" }]]));
+        const integration = createFlightOrderPaymentIntegration({
+            orderPaymentSessions: stubSessions({ fetchSessions: fetchSessions }),
+        });
+        const result = await integration.fetchOrderSessions(stubContext(), ["ord_1"]);
+        expect(result.get("ord_1")).toEqual({ sessionId: "ps_1", status: "paid" });
+        expect(fetchSessions).toHaveBeenCalledWith(DB, ["ord_1"]);
+    });
+    it("fetchOrderSessions short-circuits empty input", async () => {
+        const fetchSessions = vi.fn(async () => new Map());
+        const integration = createFlightOrderPaymentIntegration({
+            orderPaymentSessions: stubSessions({ fetchSessions: fetchSessions }),
+        });
+        const result = await integration.fetchOrderSessions(stubContext(), []);
+        expect(result.size).toBe(0);
+        expect(fetchSessions).not.toHaveBeenCalled();
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/flights",
-  "version": "0.120.1",
+  "version": "0.122.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -53,6 +53,16 @@
       "types": "./dist/reference/static-bundle.d.ts",
       "import": "./dist/reference/static-bundle.js",
       "default": "./dist/reference/static-bundle.js"
+    },
+    "./hono": {
+      "types": "./dist/hono.d.ts",
+      "import": "./dist/hono.js",
+      "default": "./dist/hono.js"
+    },
+    "./payment-integration": {
+      "types": "./dist/payment-integration.d.ts",
+      "import": "./dist/payment-integration.js",
+      "default": "./dist/payment-integration.js"
     }
   },
   "voyant": {
@@ -69,10 +79,12 @@
   },
   "dependencies": {
     "drizzle-orm": "^0.45.2",
+    "hono": "^4.12.10",
     "zod": "^4.3.6",
     "@voyant-travel/db": "^0.108.1",
-    "@voyant-travel/catalog": "^0.118.1",
-    "@voyant-travel/flights-contracts": "^0.104.4"
+    "@voyant-travel/catalog": "^0.120.0",
+    "@voyant-travel/flights-contracts": "^0.104.4",
+    "@voyant-travel/hono": "^0.111.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",