@voyantjs/flights-react 0.21.0

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAkEvB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ3B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAY5B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE9D,eAAO,MAAM,gCAAgC;;;;iBAI3C,CAAA;AAEF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAE5F,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIrC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEhF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIpC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAa9E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoC5B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEnC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE5E,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEvC,CAAA;AAEF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEpF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGrC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEhF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOzC,CAAA;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAexF,QAAA,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;iBAehC,CAAA;AAEF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEpF,QAAA,MAAM,+BAA+B;;;;;;;;;;;;;;;;iBAMnC,CAAA;AAEF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE1F,QAAA,MAAM,0BAA0B;;;;;;;;;;;;iBAM9B,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEhF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIjC,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAExE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGlC,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAc1E,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWd,CAAA;AAEF,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AAOhD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOxB,CAAA;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEtD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGhC,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAItE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;iBAcnC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE5E,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;iBAE/C,CAAA;AAEF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAA;AAIjG,eAAO,MAAM,aAAa;;;;;;;iBAOxB,CAAA;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEtD,eAAO,MAAM,aAAa;;;;;;;;;iBASxB,CAAA;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEtD,eAAO,MAAM,cAAc;;;;;;iBAMzB,CAAA;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAExD,eAAO,MAAM,yBAAyB;;;;;;;;;iBAA6C,CAAA;AACnF,eAAO,MAAM,yBAAyB;;;;;;;;;;;iBAA6C,CAAA;AACnF,eAAO,MAAM,0BAA0B;;;;;;;;iBAA8C,CAAA;AAErF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC3E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC3E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA"}

package/dist/schemas.js

@@ -0,0 +1,295 @@
+/**
+ * Zod schemas mirroring the flight contract types from `@voyantjs/flights`.
+ * Used to validate API responses at the network boundary.
+ *
+ * Drift policy: when the contract types change (additive only — see
+ * `packages/flights/src/contract/types.ts`), update these schemas to match.
+ */
+import { z } from "zod";
+const cabinSchema = z.enum(["economy", "premium_economy", "business", "first"]);
+const passengerTypeSchema = z.enum(["adult", "child", "infant", "senior", "youth"]);
+const moneySchema = z.object({
+    amount: z.string(),
+    currency: z.string(),
+});
+const segmentEndpointSchema = z.object({
+    iataCode: z.string(),
+    terminal: z.string().optional(),
+    at: z.string(),
+});
+const flightSegmentSchema = z.object({
+    segmentId: z.string(),
+    carrierCode: z.string(),
+    flightNumber: z.string(),
+    operatingCarrierCode: z.string().optional(),
+    operatingFlightNumber: z.string().optional(),
+    departure: segmentEndpointSchema,
+    arrival: segmentEndpointSchema,
+    duration: z.string().optional(),
+    aircraft: z.string().optional(),
+    cabin: cabinSchema,
+    fareClass: z.string().optional(),
+    fareBasis: z.string().optional(),
+    status: z.string().optional(),
+    providerData: z.record(z.string(), z.unknown()).optional(),
+});
+const itinerarySchema = z.object({
+    segments: z.array(flightSegmentSchema),
+    duration: z.string().optional(),
+});
+const fareBreakdownSchema = z.object({
+    passengerType: passengerTypeSchema,
+    passengerCount: z.number(),
+    baseFare: moneySchema,
+    taxes: moneySchema,
+    fees: moneySchema.optional(),
+    total: moneySchema,
+    fareFamily: z.string().optional(),
+});
+const fareBundleInclusionsSchema = z.object({
+    cabinBag: z.object({ included: z.boolean(), weightKg: z.number().optional() }).optional(),
+    checkedBag: z
+        .object({
+        included: z.boolean(),
+        pieces: z.number().optional(),
+        weightKg: z.number().optional(),
+    })
+        .optional(),
+    seatSelection: z.enum(["none", "standard", "free"]).optional(),
+    priorityBoarding: z.boolean().optional(),
+    loungeAccess: z.boolean().optional(),
+    refundable: z.boolean().optional(),
+    changeable: z.boolean().optional(),
+    notes: z.array(z.string()).optional(),
+});
+export const fareBundleSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    tier: z.enum(["basic", "standard", "plus", "premium"]),
+    priceDelta: moneySchema,
+    recommended: z.boolean().optional(),
+    inclusions: fareBundleInclusionsSchema,
+    providerData: z.record(z.string(), z.unknown()).optional(),
+});
+export const flightOfferSchema = z.object({
+    offerId: z.string(),
+    source: z.string(),
+    itineraries: z.array(itinerarySchema),
+    fareBreakdowns: z.array(fareBreakdownSchema),
+    totalPrice: moneySchema,
+    validatingCarrier: z.string().optional(),
+    expiresAt: z.string().optional(),
+    lastTicketingDate: z.string().optional(),
+    instantTicketing: z.boolean().optional(),
+    fareBundles: z.array(fareBundleSchema).optional(),
+    providerData: z.record(z.string(), z.unknown()).optional(),
+});
+export const flightSearchPaginationMetaSchema = z.object({
+    total: z.number(),
+    cursor: z.string().optional(),
+    hasMore: z.boolean(),
+});
+export const flightSearchResponseSchema = z.object({
+    offers: z.array(flightOfferSchema),
+    pagination: flightSearchPaginationMetaSchema.optional(),
+    providerData: z.record(z.string(), z.unknown()).optional(),
+});
+export const flightPriceResponseSchema = z.object({
+    offer: flightOfferSchema,
+    valid: z.boolean(),
+    invalidReason: z.string().optional(),
+});
+// ── Booking ─────────────────────────────────────────────────────────────────
+const flightTicketSchema = z.object({
+    ticketNumber: z.string(),
+    passengerId: z.string(),
+    segmentIds: z.array(z.string()),
+    status: z.string().optional(),
+});
+const flightOrderStatusSchema = z.enum(["pending", "confirmed", "ticketed", "cancelled", "failed"]);
+export const flightOrderSchema = z.object({
+    orderId: z.string(),
+    pnr: z.string().optional(),
+    status: flightOrderStatusSchema,
+    offer: flightOfferSchema,
+    passengers: z.array(z.object({
+        passengerId: z.string(),
+        type: passengerTypeSchema,
+        firstName: z.string(),
+        middleName: z.string().optional(),
+        lastName: z.string(),
+        dateOfBirth: z.string(),
+        gender: z.enum(["M", "F", "X"]).optional(),
+        email: z.string().optional(),
+        phone: z.string().optional(),
+        documents: z
+            .array(z.object({
+            type: z.enum(["passport", "national_id", "visa"]),
+            number: z.string(),
+            countryOfIssue: z.string(),
+            countryOfNationality: z.string().optional(),
+            expiryDate: z.string().optional(),
+        }))
+            .optional(),
+    })),
+    contact: z.object({ email: z.string().optional(), phone: z.string().optional() }).optional(),
+    tickets: z.array(flightTicketSchema).optional(),
+    totalPrice: moneySchema,
+    paymentDeadline: z.string().optional(),
+    createdAt: z.string(),
+    updatedAt: z.string().optional(),
+    providerData: z.record(z.string(), z.unknown()).optional(),
+});
+export const flightBookResponseSchema = z.object({
+    order: flightOrderSchema,
+});
+export const flightGetOrderResponseSchema = z.object({
+    order: flightOrderSchema,
+});
+export const flightCancelResponseSchema = z.object({
+    order: flightOrderSchema,
+    refundedAmount: moneySchema.optional(),
+});
+export const flightOrdersListResponseSchema = z.object({
+    orders: z.array(flightOrderSchema),
+    pagination: z.object({
+        total: z.number(),
+        hasMore: z.boolean(),
+        cursor: z.string().optional(),
+    }),
+});
+// ── Ancillaries ─────────────────────────────────────────────────────────────
+const baggageCategorySchema = z.enum(["checked", "cabin", "personal_item", "sports", "oversized"]);
+const assistanceCategorySchema = z.enum([
+    "wheelchair",
+    "visual",
+    "hearing",
+    "cognitive",
+    "medical",
+    "other",
+]);
+const ancillaryBaggageOptionSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    category: baggageCategorySchema,
+    weightKg: z.number().optional(),
+    dimensions: z
+        .object({
+        lengthCm: z.number().optional(),
+        widthCm: z.number().optional(),
+        heightCm: z.number().optional(),
+    })
+        .optional(),
+    price: moneySchema,
+    recommended: z.boolean().optional(),
+    providerData: z.record(z.string(), z.unknown()).optional(),
+});
+const ancillaryAssistanceOptionSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    category: assistanceCategorySchema,
+    price: moneySchema.optional(),
+    notes: z.string().optional(),
+});
+const ancillaryExtraOptionSchema = z.object({
+    id: z.string(),
+    label: z.string(),
+    category: z.string(),
+    price: moneySchema,
+    pricingScope: z.enum(["per_passenger", "per_booking"]).optional(),
+});
+export const ancillaryCatalogSchema = z.object({
+    baggage: z.array(ancillaryBaggageOptionSchema),
+    assistance: z.array(ancillaryAssistanceOptionSchema),
+    extras: z.array(ancillaryExtraOptionSchema),
+});
+export const ancillaryResponseSchema = z.object({
+    catalog: ancillaryCatalogSchema,
+    validUntil: z.string().optional(),
+});
+// ── Seat maps ───────────────────────────────────────────────────────────────
+const seatStatusSchema = z.enum(["available", "blocked", "unavailable", "selected"]);
+const seatCategorySchema = z.enum([
+    "standard",
+    "preferred",
+    "extra_legroom",
+    "exit_row",
+    "premium",
+    "bulkhead",
+]);
+const seatSchema = z.object({
+    seatNumber: z.string(),
+    row: z.number(),
+    column: z.string(),
+    status: seatStatusSchema,
+    category: seatCategorySchema,
+    price: moneySchema.optional(),
+    notes: z.string().optional(),
+    window: z.boolean().optional(),
+    aisle: z.boolean().optional(),
+    providerData: z.record(z.string(), z.unknown()).optional(),
+});
+const seatRowSchema = z.object({
+    row: z.number(),
+    seats: z.array(seatSchema),
+});
+export const seatMapSchema = z.object({
+    segmentId: z.string(),
+    aircraft: z.string().optional(),
+    cabin: cabinSchema,
+    columnLayout: z.array(z.string().nullable()),
+    rows: z.array(seatRowSchema),
+    providerData: z.record(z.string(), z.unknown()).optional(),
+});
+export const seatMapResponseSchema = z.object({
+    seatMap: seatMapSchema,
+    validUntil: z.string().optional(),
+});
+// ── Saved payment methods (demo / template-side) ─────────────────────────────
+export const savedPaymentMethodSchema = z.object({
+    id: z.string(),
+    /** Present on CRM-backed responses; ignored client-side. */
+    personId: z.string().optional(),
+    brand: z.enum(["visa", "mastercard", "amex", "revolut", "bank_transfer"]),
+    /** Null for non-card methods (bank_transfer). */
+    last4: z.string().nullable(),
+    holderName: z.string().nullable().optional(),
+    /** Null for non-card methods. */
+    expMonth: z.number().nullable().optional(),
+    expYear: z.number().nullable().optional(),
+    processorToken: z.string(),
+    isDefault: z.boolean(),
+    createdAt: z.string(),
+});
+export const savedPaymentMethodListResponseSchema = z.object({
+    data: z.array(savedPaymentMethodSchema),
+});
+// ── Reference data ──────────────────────────────────────────────────────────
+export const airlineSchema = z.object({
+    iataCode: z.string(),
+    icaoCode: z.string().nullable().optional(),
+    name: z.string(),
+    country: z.string().nullable().optional(),
+    logoUrl: z.string().nullable().optional(),
+    alliance: z.string().nullable().optional(),
+});
+export const airportSchema = z.object({
+    iataCode: z.string(),
+    icaoCode: z.string().nullable().optional(),
+    name: z.string(),
+    city: z.string(),
+    country: z.string(),
+    timezone: z.string().nullable().optional(),
+    latitude: z.number().nullable().optional(),
+    longitude: z.number().nullable().optional(),
+});
+export const aircraftSchema = z.object({
+    iataCode: z.string(),
+    icaoCode: z.string().nullable().optional(),
+    name: z.string(),
+    manufacturer: z.string().nullable().optional(),
+    typicalSeats: z.number().nullable().optional(),
+});
+export const airlineListResponseSchema = z.object({ data: z.array(airlineSchema) });
+export const airportListResponseSchema = z.object({ data: z.array(airportSchema) });
+export const aircraftListResponseSchema = z.object({ data: z.array(aircraftSchema) });

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@voyantjs/flights-react",
+  "version": "0.21.0",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/voyantjs/voyant.git",
+    "directory": "packages/flights-react"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": "./src/index.ts",
+    "./provider": "./src/provider.tsx",
+    "./hooks": "./src/hooks/index.ts",
+    "./client": "./src/client.ts",
+    "./query-keys": "./src/query-keys.ts"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "prepack": "pnpm run build",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/",
+    "test": "vitest run --passWithNoTests"
+  },
+  "peerDependencies": {
+    "@voyantjs/flights": "workspace:*",
+    "@tanstack/react-query": "^5.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@voyantjs/flights": "workspace:*",
+    "@voyantjs/react": "workspace:*",
+    "@voyantjs/voyant-typescript-config": "workspace:*",
+    "@tanstack/react-query": "^5.96.2",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2",
+    "zod": "^4.3.6"
+  },
+  "dependencies": {
+    "@voyantjs/react": "workspace:*"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      },
+      "./provider": {
+        "types": "./dist/provider.d.ts",
+        "import": "./dist/provider.js",
+        "default": "./dist/provider.js"
+      },
+      "./hooks": {
+        "types": "./dist/hooks/index.d.ts",
+        "import": "./dist/hooks/index.js",
+        "default": "./dist/hooks/index.js"
+      },
+      "./client": {
+        "types": "./dist/client.d.ts",
+        "import": "./dist/client.js",
+        "default": "./dist/client.js"
+      },
+      "./query-keys": {
+        "types": "./dist/query-keys.d.ts",
+        "import": "./dist/query-keys.js",
+        "default": "./dist/query-keys.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  }
+}