@voyant-travel/flights 0.131.1 → 0.133.0

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { type AdapterLogger, CAPABILITY_NOT_SUPPORTED, type FlightAdapterCapabil
 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 { 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";

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,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,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

@@ -6,6 +6,7 @@ export * from "./contract/types.js";
 // Flight admin HTTP routes (module-owned; the deployment supplies connector +
 // payment options).
 export { createFlightAdminRoutes, createFlightsHonoModule, } from "./hono.js";
+export { FLIGHTS_ENTITY_MODULE, mergedFlightOffersToCandidates, mergedFlightOfferToCandidate, } from "./orchestration/availability-bridge.js";
 export { fanOutFlightSearch, } from "./orchestration/fan-out.js";
 // Orchestration — fingerprinting + multi-connection fan-out.
 export { itineraryFingerprint } from "./orchestration/fingerprint.js";

package/dist/orchestration/availability-bridge.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Flights → AvailabilityCandidate bridge.
+ *
+ * Maps the flights-native `MergedFlightOffer` (produced by `fanOutFlightSearch`)
+ * onto the vertical-agnostic `AvailabilityCandidate` the dynamic-packaging
+ * composer ranks. This is a mapping, NOT proof that flights already satisfy the
+ * generic source-adapter contract — flights keep their own connector contract
+ * and fan-out; this only normalizes the result shape.
+ *
+ * See `docs/architecture/dynamic-packaging-rfc.md` §2 (Gap 1) and §4.
+ */
+import type { AvailabilityCandidate } from "@voyant-travel/catalog-contracts";
+import type { MergedFlightOffer } from "./fan-out.js";
+/** Vertical key flights candidates carry. */
+export declare const FLIGHTS_ENTITY_MODULE: "flights";
+/**
+ * Convert one merged flight offer into a normalized availability candidate.
+ *
+ * The candidate's `selection` carries what the flights booking path needs to
+ * re-resolve and price the exact offer at reserve time (offer id + source +
+ * the connections that returned it). The per-search `offerId` is not
+ * replay-safe, so callers re-price before booking — same rule as the generic
+ * `AvailabilityCandidate.candidateRef`.
+ */
+export declare function mergedFlightOfferToCandidate(merged: MergedFlightOffer): AvailabilityCandidate;
+/** Convenience: map a whole fan-out result set to candidates, preserving rank. */
+export declare function mergedFlightOffersToCandidates(merged: ReadonlyArray<MergedFlightOffer>): AvailabilityCandidate[];
+//# sourceMappingURL=availability-bridge.d.ts.map

package/dist/orchestration/availability-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability-bridge.d.ts","sourceRoot":"","sources":["../../src/orchestration/availability-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD,6CAA6C;AAC7C,eAAO,MAAM,qBAAqB,EAAG,SAAkB,CAAA;AAEvD;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,GAAG,qBAAqB,CAoB7F;AAED,kFAAkF;AAClF,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,aAAa,CAAC,iBAAiB,CAAC,GACvC,qBAAqB,EAAE,CAEzB"}

package/dist/orchestration/availability-bridge.js

@@ -0,0 +1,47 @@
+/**
+ * Flights → AvailabilityCandidate bridge.
+ *
+ * Maps the flights-native `MergedFlightOffer` (produced by `fanOutFlightSearch`)
+ * onto the vertical-agnostic `AvailabilityCandidate` the dynamic-packaging
+ * composer ranks. This is a mapping, NOT proof that flights already satisfy the
+ * generic source-adapter contract — flights keep their own connector contract
+ * and fan-out; this only normalizes the result shape.
+ *
+ * See `docs/architecture/dynamic-packaging-rfc.md` §2 (Gap 1) and §4.
+ */
+/** Vertical key flights candidates carry. */
+export const FLIGHTS_ENTITY_MODULE = "flights";
+/**
+ * Convert one merged flight offer into a normalized availability candidate.
+ *
+ * The candidate's `selection` carries what the flights booking path needs to
+ * re-resolve and price the exact offer at reserve time (offer id + source +
+ * the connections that returned it). The per-search `offerId` is not
+ * replay-safe, so callers re-price before booking — same rule as the generic
+ * `AvailabilityCandidate.candidateRef`.
+ */
+export function mergedFlightOfferToCandidate(merged) {
+    const offer = merged.cheapest;
+    return {
+        candidateRef: merged.itineraryFingerprint,
+        entity_module: FLIGHTS_ENTITY_MODULE,
+        entity_id: offer.offerId,
+        selection: {
+            offerId: offer.offerId,
+            source: offer.source,
+            itineraryFingerprint: merged.itineraryFingerprint,
+            sourceConnectionIds: merged.sourceConnectionIds,
+        },
+        price: { amount: offer.totalPrice.amount, currency: offer.totalPrice.currency },
+        expiresAt: offer.expiresAt ? new Date(offer.expiresAt) : undefined,
+        providerData: {
+            sourceConnectionIds: merged.sourceConnectionIds,
+            alternateCount: merged.alternates.length,
+            ...offer.providerData,
+        },
+    };
+}
+/** Convenience: map a whole fan-out result set to candidates, preserving rank. */
+export function mergedFlightOffersToCandidates(merged) {
+    return merged.map(mergedFlightOfferToCandidate);
+}

package/dist/orchestration/availability-bridge.test.d.ts

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

package/dist/orchestration/availability-bridge.test.d.ts.map

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

package/dist/orchestration/availability-bridge.test.js

@@ -0,0 +1,53 @@
+import { describe, expect, it } from "vitest";
+import { FLIGHTS_ENTITY_MODULE, mergedFlightOffersToCandidates, mergedFlightOfferToCandidate, } from "./availability-bridge.js";
+function offer(overrides = {}) {
+    return {
+        offerId: overrides.offerId ?? "ofr_1",
+        source: overrides.source ?? "conn_amadeus",
+        itineraries: [],
+        fareBreakdowns: [],
+        totalPrice: overrides.totalPrice ?? { amount: "600", currency: "USD" },
+        ...overrides,
+    };
+}
+function merged(overrides = {}) {
+    return {
+        itineraryFingerprint: overrides.itineraryFingerprint ?? "fp_lhr_jfk",
+        cheapest: overrides.cheapest ?? offer(),
+        alternates: overrides.alternates ?? [],
+        sourceConnectionIds: overrides.sourceConnectionIds ?? ["conn_amadeus"],
+    };
+}
+describe("mergedFlightOfferToCandidate", () => {
+    it("maps a merged offer onto a normalized candidate", () => {
+        const candidate = mergedFlightOfferToCandidate(merged({
+            cheapest: offer({
+                offerId: "ofr_99",
+                expiresAt: "2026-10-15T10:00:00Z",
+                providerData: { fareKey: "abc" },
+            }),
+            alternates: [offer({ offerId: "ofr_alt" })],
+            sourceConnectionIds: ["conn_amadeus", "conn_sabre"],
+        }));
+        expect(candidate.entity_module).toBe(FLIGHTS_ENTITY_MODULE);
+        expect(candidate.entity_id).toBe("ofr_99");
+        expect(candidate.candidateRef).toBe("fp_lhr_jfk");
+        expect(candidate.price).toEqual({ amount: "600", currency: "USD" });
+        expect(candidate.selection).toMatchObject({
+            offerId: "ofr_99",
+            sourceConnectionIds: ["conn_amadeus", "conn_sabre"],
+        });
+        expect(candidate.expiresAt).toEqual(new Date("2026-10-15T10:00:00Z"));
+        expect(candidate.providerData).toMatchObject({ fareKey: "abc", alternateCount: 1 });
+    });
+    it("leaves expiresAt undefined when the offer has none", () => {
+        expect(mergedFlightOfferToCandidate(merged()).expiresAt).toBeUndefined();
+    });
+    it("maps a list preserving rank order", () => {
+        const candidates = mergedFlightOffersToCandidates([
+            merged({ itineraryFingerprint: "fp_a", cheapest: offer({ offerId: "a" }) }),
+            merged({ itineraryFingerprint: "fp_b", cheapest: offer({ offerId: "b" }) }),
+        ]);
+        expect(candidates.map((c) => c.entity_id)).toEqual(["a", "b"]);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/flights",
-  "version": "0.131.1",
+  "version": "0.133.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -83,10 +83,11 @@
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.10",
     "zod": "^4.3.6",
-    "@voyant-travel/db": "^0.108.5",
-    "@voyant-travel/catalog": "^0.129.1",
-    "@voyant-travel/flights-contracts": "^0.104.4",
-    "@voyant-travel/hono": "^0.113.0"
+    "@voyant-travel/db": "^0.109.0",
+    "@voyant-travel/catalog": "^0.131.0",
+    "@voyant-travel/catalog-contracts": "^0.108.0",
+    "@voyant-travel/flights-contracts": "^0.104.5",
+    "@voyant-travel/hono": "^0.114.0"
   },
   "devDependencies": {
     "drizzle-kit": "^0.31.10",