@voyantjs/flights 0.56.0 → 0.58.0

package/dist/contract/schemas.test.js

@@ -0,0 +1,359 @@
+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";
+const typeChecks = [
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+    true,
+];
+void typeChecks;
+const money = { amount: "600.00", currency: "USD" };
+const segment = {
+    segmentId: "seg_1",
+    carrierCode: "BA",
+    flightNumber: "177",
+    departure: { iataCode: "LHR", terminal: "5", at: "2026-10-15T11:00:00+00:00" },
+    arrival: { iataCode: "JFK", terminal: "8", at: "2026-10-15T14:00:00-04:00" },
+    aircraft: "777",
+    cabin: "economy",
+    providerData: { source: "fixture" },
+};
+const offer = {
+    offerId: "offer_1",
+    source: "test",
+    itineraries: [{ segments: [segment], duration: "PT8H" }],
+    fareBreakdowns: [
+        {
+            passengerType: "adult",
+            passengerCount: 1,
+            baseFare: { amount: "500.00", currency: "USD" },
+            taxes: { amount: "100.00", currency: "USD" },
+            total: money,
+        },
+    ],
+    totalPrice: money,
+    validatingCarrier: "BA",
+    expiresAt: "2026-10-01T11:00:00Z",
+    lastTicketingDate: "2026-10-02",
+    fareBundles: [
+        {
+            id: "standard",
+            label: "Standard",
+            tier: "standard",
+            priceDelta: { amount: "30.00", currency: "USD" },
+            inclusions: {
+                cabinBag: { included: true, weightKg: 8 },
+                seatSelection: "standard",
+            },
+        },
+    ],
+};
+const passenger = {
+    passengerId: "pax_1",
+    type: "adult",
+    firstName: "Ada",
+    lastName: "Lovelace",
+    dateOfBirth: "1980-01-01",
+    documents: [
+        {
+            type: "passport",
+            number: "123456789",
+            countryOfIssue: "GB",
+            expiryDate: "2030-01-01",
+        },
+    ],
+};
+const order = {
+    orderId: "order_1",
+    pnr: "ABC123",
+    status: "ticketed",
+    offer,
+    passengers: [passenger],
+    contact: { email: "ada@example.com" },
+    tickets: [{ ticketNumber: "1250000000001", passengerId: "pax_1", segmentIds: ["seg_1"] }],
+    totalPrice: money,
+    createdAt: "2026-10-01T10:00:00Z",
+    providerData: { locator: "ABC123" },
+};
+const ancillarySelection = {
+    baggage: [{ passengerId: "pax_1", sliceIndex: 0, optionId: "bag_20kg", quantity: 1 }],
+    seats: [{ passengerId: "pax_1", segmentId: "seg_1", seatNumber: "12A" }],
+};
+const seatMap = {
+    segmentId: "seg_1",
+    aircraft: "777",
+    cabin: "economy",
+    columnLayout: ["A", "B", "C", null, "D", "E", "F"],
+    rows: [
+        {
+            row: 12,
+            seats: [
+                {
+                    seatNumber: "12A",
+                    row: 12,
+                    column: "A",
+                    status: "available",
+                    category: "standard",
+                    window: true,
+                },
+            ],
+        },
+    ],
+};
+const logger = {
+    debug() { },
+    info() { },
+    warn() { },
+    error() { },
+};
+const roundTripCases = [
+    [
+        "flightSearchRequestSchema",
+        flightSearchRequestSchema,
+        {
+            slices: [{ origin: "LHR", destination: "JFK", departureDate: "2026-10-15" }],
+            passengers: { adults: 1 },
+            cabin: "economy",
+        },
+    ],
+    ["flightSearchResponseSchema", flightSearchResponseSchema, { offers: [offer] }],
+    ["flightPriceRequestSchema", flightPriceRequestSchema, { offerId: "offer_1", offer }],
+    ["flightPriceResponseSchema", flightPriceResponseSchema, { offer, valid: true }],
+    [
+        "flightBookRequestSchema",
+        flightBookRequestSchema,
+        {
+            offerId: "offer_1",
+            offer,
+            passengers: [passenger],
+            paymentIntent: { type: "hold" },
+            ancillaries: ancillarySelection,
+        },
+    ],
+    ["flightBookResponseSchema", flightBookResponseSchema, { order }],
+    ["flightGetOrderResponseSchema", flightGetOrderResponseSchema, { order }],
+    ["flightCancelResponseSchema", flightCancelResponseSchema, { order, refundedAmount: money }],
+    [
+        "flightOrdersListQuerySchema",
+        flightOrdersListQuerySchema,
+        { cursor: "next", limit: 20, status: ["ticketed"], search: "ABC" },
+    ],
+    [
+        "flightOrdersListResponseSchema",
+        flightOrdersListResponseSchema,
+        { orders: [order], pagination: { total: 1, hasMore: false } },
+    ],
+    ["ancillaryRequestSchema", ancillaryRequestSchema, { offerId: "offer_1", offer }],
+    [
+        "ancillaryResponseSchema",
+        ancillaryResponseSchema,
+        {
+            catalog: {
+                baggage: [{ id: "bag_20kg", label: "20kg bag", category: "checked", price: money }],
+                assistance: [{ id: "wchr", label: "Wheelchair", category: "wheelchair" }],
+                extras: [{ id: "priority", label: "Priority", category: "boarding", price: money }],
+            },
+            validUntil: "2026-10-01T11:00:00Z",
+        },
+    ],
+    ["seatMapRequestSchema", seatMapRequestSchema, { offerId: "offer_1", segmentId: "seg_1", offer }],
+    ["seatMapResponseSchema", seatMapResponseSchema, { seatMap }],
+    [
+        "seatSelectionRequestSchema",
+        seatSelectionRequestSchema,
+        {
+            orderId: "order_1",
+            selections: [{ passengerId: "pax_1", segmentId: "seg_1", seatNumber: "12A" }],
+        },
+    ],
+    [
+        "seatSelectionResponseSchema",
+        seatSelectionResponseSchema,
+        { order, selections: [{ passengerId: "pax_1", segmentId: "seg_1", seatNumber: "12A" }] },
+    ],
+    ["checkInRequestSchema", checkInRequestSchema, { orderId: "order_1", passengerIds: ["pax_1"] }],
+    [
+        "checkInResponseSchema",
+        checkInResponseSchema,
+        {
+            order,
+            status: "checked_in",
+            boardingPasses: [{ passengerId: "pax_1", segmentId: "seg_1", seatNumber: "12A" }],
+        },
+    ],
+    [
+        "flightModifyRequestSchema",
+        flightModifyRequestSchema,
+        { orderId: "order_1", ancillaries: ancillarySelection },
+    ],
+    [
+        "flightModifyResponseSchema",
+        flightModifyResponseSchema,
+        { order, priceDifference: { amount: "-25.00", currency: "USD" } },
+    ],
+    [
+        "flightRefundRequestSchema",
+        flightRefundRequestSchema,
+        { orderId: "order_1", reason: "customer_request" },
+    ],
+    ["flightRefundResponseSchema", flightRefundResponseSchema, { order, refundedAmount: money }],
+    [
+        "flightVoidResponseSchema",
+        flightVoidResponseSchema,
+        { order, voidedAt: "2026-10-01T11:00:00Z" },
+    ],
+    [
+        "ssrRequestSchema",
+        ssrRequestSchema,
+        { orderId: "order_1", code: "WCHR", passengerIds: ["pax_1"] },
+    ],
+    ["ssrResponseSchema", ssrResponseSchema, { order, status: "requested" }],
+    [
+        "flightAdapterContextSchema",
+        flightAdapterContextSchema,
+        { connectionId: "conn_1", logger, environment: "sandbox" },
+    ],
+    [
+        "flightAdapterCapabilitiesSchema",
+        flightAdapterCapabilitiesSchema,
+        { provider: "demo", declared: ["flight/holds"], maxSlicesPerSearch: 2 },
+    ],
+];
+const invalidCases = [
+    ["moneySchema", moneySchema, { amount: 600, currency: "USD" }],
+    [
+        "flightSearchRequestSchema",
+        flightSearchRequestSchema,
+        { slices: [], passengers: { adults: -1 } },
+    ],
+    ["flightSearchResponseSchema", flightSearchResponseSchema, { offers: [{ totalPrice: money }] }],
+    ["flightPriceRequestSchema", flightPriceRequestSchema, { offerId: 123 }],
+    ["flightPriceResponseSchema", flightPriceResponseSchema, { offer, valid: "yes" }],
+    ["flightBookRequestSchema", flightBookRequestSchema, { offerId: "offer_1", passengers: [{}] }],
+    [
+        "flightBookResponseSchema",
+        flightBookResponseSchema,
+        { order: { ...order, status: "unknown" } },
+    ],
+    [
+        "flightGetOrderResponseSchema",
+        flightGetOrderResponseSchema,
+        { order: { ...order, totalPrice: { amount: "x", currency: "USD" } } },
+    ],
+    [
+        "flightCancelResponseSchema",
+        flightCancelResponseSchema,
+        { order, refundedAmount: { amount: "1.00", currency: "US" } },
+    ],
+    ["flightOrdersListQuerySchema", flightOrdersListQuerySchema, { limit: 0 }],
+    [
+        "flightOrdersListResponseSchema",
+        flightOrdersListResponseSchema,
+        { orders: [order], pagination: { total: -1, hasMore: false } },
+    ],
+    ["ancillaryRequestSchema", ancillaryRequestSchema, { offerId: 123 }],
+    [
+        "ancillaryResponseSchema",
+        ancillaryResponseSchema,
+        { catalog: { baggage: [], assistance: [] } },
+    ],
+    ["seatMapRequestSchema", seatMapRequestSchema, { offerId: "offer_1" }],
+    ["seatMapResponseSchema", seatMapResponseSchema, { seatMap: { ...seatMap, cabin: "sofa" } }],
+    [
+        "seatSelectionRequestSchema",
+        seatSelectionRequestSchema,
+        { orderId: "order_1", selections: [{ seatNumber: "12A" }] },
+    ],
+    [
+        "seatSelectionResponseSchema",
+        seatSelectionResponseSchema,
+        { order, selections: [{ passengerId: "pax_1" }] },
+    ],
+    ["checkInRequestSchema", checkInRequestSchema, { passengerIds: ["pax_1"] }],
+    ["checkInResponseSchema", checkInResponseSchema, { order, status: "done" }],
+    [
+        "flightModifyRequestSchema",
+        flightModifyRequestSchema,
+        { orderId: "order_1", reason: "vacation" },
+    ],
+    [
+        "flightModifyResponseSchema",
+        flightModifyResponseSchema,
+        { order, penalties: [{ amount: "1.00", currency: "US" }] },
+    ],
+    [
+        "flightRefundRequestSchema",
+        flightRefundRequestSchema,
+        { orderId: "order_1", reason: "changed_mind" },
+    ],
+    [
+        "flightRefundResponseSchema",
+        flightRefundResponseSchema,
+        { order, refundedAmount: { amount: "x", currency: "USD" } },
+    ],
+    ["flightVoidResponseSchema", flightVoidResponseSchema, { order }],
+    ["ssrRequestSchema", ssrRequestSchema, { orderId: "order_1", code: "NOPE" }],
+    ["ssrResponseSchema", ssrResponseSchema, { order, status: "done" }],
+    [
+        "flightAdapterCapabilitiesSchema",
+        flightAdapterCapabilitiesSchema,
+        { provider: "demo", declared: ["flight/nope"] },
+    ],
+    [
+        "flightAdapterContextSchema",
+        flightAdapterContextSchema,
+        { connectionId: "conn_1", logger: {} },
+    ],
+];
+describe("flight contract schemas", () => {
+    it.each(roundTripCases)("parses %s fixtures without changing shape", (_name, schema, value) => {
+        expect(schema.parse(value)).toEqual(value);
+    });
+    it.each(invalidCases)("rejects invalid %s fixtures", (_name, schema, value) => {
+        expect(schema.safeParse(value).success).toBe(false);
+    });
+});

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 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 { type ConnectionResult, type ConnectionSearchStatus, type FanOutFlightSearchOptions, type FanOutFlightSearchResult, fanOutFlightSearch, type MergedFlightOffer, } from "./orchestration/fan-out.js";
 export { itineraryFingerprint } from "./orchestration/fingerprint.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,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;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"}

package/dist/index.js

@@ -1,6 +1,7 @@
 // Flight contract types — offers, orders, segments, search, booking.
 // FlightConnectorAdapter contract.
 export { CAPABILITY_NOT_SUPPORTED, FlightCapabilityNotSupportedError, requireCapability, } from "./contract/adapter.js";
+export * from "./contract/schemas.js";
 export * from "./contract/types.js";
 export { fanOutFlightSearch, } from "./orchestration/fan-out.js";
 // Orchestration — fingerprinting + multi-connection fan-out.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/flights",
-  "version": "0.56.0",
+  "version": "0.58.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -19,6 +19,11 @@
       "import": "./dist/contract/adapter.js",
       "default": "./dist/contract/adapter.js"
     },
+    "./contract/schemas": {
+      "types": "./dist/contract/schemas.d.ts",
+      "import": "./dist/contract/schemas.js",
+      "default": "./dist/contract/schemas.js"
+    },
     "./orchestration/fingerprint": {
       "types": "./dist/orchestration/fingerprint.d.ts",
       "import": "./dist/orchestration/fingerprint.js",
@@ -58,8 +63,9 @@
   },
   "dependencies": {
     "drizzle-orm": "^0.45.2",
-    "@voyantjs/db": "0.56.0",
-    "@voyantjs/catalog": "0.56.0"
+    "zod": "^4.3.6",
+    "@voyantjs/db": "0.58.0",
+    "@voyantjs/catalog": "0.58.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",