@voyant-travel/accommodations 0.105.30 → 0.106.0

package/dist/booking-engine/index.d.ts

@@ -1,8 +1,9 @@
 /**
- * `@voyant-travel/accommodations/booking-engine` — owned-arm booking
- * handler for the accommodation vertical.
+ * `@voyant-travel/accommodations/booking-engine` — owned-arm booking +
+ * availability-search handlers for the accommodation vertical.
  *
  * Per `docs/architecture/booking-journey-architecture.md` §6.
  */
 export { type AccommodationCommitBridge, type AccommodationCommitBridgeInput, type AccommodationCommitBridgeResult, type AccommodationContentLoader, type CreateAccommodationBookingHandlerOptions, createAccommodationBookingHandler, } from "./handler.js";
+export { type AccommodationSearchBridge, type AccommodationSearchBridgeInput, type AccommodationSearchCriteria, type AccommodationSearchMatch, type AccommodationSearchOccupancy, type CreateAccommodationSearchHandlerOptions, createAccommodationOwnedSearchHandler, nightsBetween, } from "./search-handler.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/booking-engine/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/booking-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,0BAA0B,EAC/B,KAAK,wCAAwC,EAC7C,iCAAiC,GAClC,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/booking-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,0BAA0B,EAC/B,KAAK,wCAAwC,EAC7C,iCAAiC,GAClC,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EACnC,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,uCAAuC,EAC5C,qCAAqC,EACrC,aAAa,GACd,MAAM,qBAAqB,CAAA"}

package/dist/booking-engine/index.js

@@ -1,7 +1,8 @@
 /**
- * `@voyant-travel/accommodations/booking-engine` — owned-arm booking
- * handler for the accommodation vertical.
+ * `@voyant-travel/accommodations/booking-engine` — owned-arm booking +
+ * availability-search handlers for the accommodation vertical.
  *
  * Per `docs/architecture/booking-journey-architecture.md` §6.
  */
 export { createAccommodationBookingHandler, } from "./handler.js";
+export { createAccommodationOwnedSearchHandler, nightsBetween, } from "./search-handler.js";

package/dist/booking-engine/search-handler.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Owned-arm availability-search handler for the `accommodation` vertical.
+ *
+ * The counterpart of `createAccommodationBookingHandler`: it lets owned
+ * accommodation inventory participate in the catalog availability fan-out
+ * (`fanOutAvailabilitySearch`, RFC #2081/#2093) so owned and sourced supply
+ * land in one ranked candidate list.
+ *
+ * Like the booking handler, this is a thin shell that delegates the actual
+ * inventory query to a caller-supplied **bridge**. Owned accommodations have no
+ * date-aware rate/availability table in the schema yet, and the location lookup
+ * spans the operations (places/facility) schema — both deployment-specific — so
+ * the handler owns the vertical-agnostic parts (criteria validation, nights,
+ * candidate assembly) and the deployment owns the data access.
+ */
+import type { OwnedAvailabilitySearchHandler, OwnedSearchContext } from "@voyant-travel/catalog";
+import type { AvailabilitySearchRequest } from "@voyant-travel/catalog/adapter/contract";
+/** Occupancy for one requested room. Mirrors the sourced stay-search shape. */
+export interface AccommodationSearchOccupancy {
+    adults: number;
+    children?: number;
+    childrenAges?: number[];
+    infants?: number;
+}
+/**
+ * Accommodation-vertical search criteria. The composer/caller shapes
+ * `AvailabilitySearchRequest.criteria` into this; `checkIn`/`checkOut`/`rooms`
+ * are required.
+ */
+export interface AccommodationSearchCriteria {
+    destination?: {
+        countryCode?: string;
+        region?: string;
+        city?: string;
+    };
+    near?: {
+        latitude: number;
+        longitude: number;
+        radiusKm: number;
+    };
+    checkIn: string;
+    checkOut: string;
+    rooms: AccommodationSearchOccupancy[];
+    minStars?: number;
+    amenities?: string[];
+    refundableOnly?: boolean;
+}
+/** Validated criteria + derived context handed to the bridge. */
+export interface AccommodationSearchBridgeInput {
+    criteria: AccommodationSearchCriteria;
+    /** Nights between check-in and check-out (≥ 1). */
+    nights: number;
+    scope: AvailabilitySearchRequest["scope"];
+    limit?: number;
+    cursor?: string;
+}
+/**
+ * One owned room matched + priced for the requested stay. The bridge resolves
+ * availability + price from wherever the deployment models owned rates; the
+ * handler maps these onto `AvailabilityCandidate`s.
+ */
+export interface AccommodationSearchMatch {
+    /** Entity id surfaced to the composer — typically the room type / accommodation id. */
+    accommodationId: string;
+    roomTypeId: string;
+    ratePlanId: string;
+    occupancy: AccommodationSearchOccupancy;
+    /** Public total stay price across the date range. */
+    price: {
+        amount: string;
+        currency: string;
+    };
+    /** Stable ref for this match within the search; defaults to a composed key. */
+    candidateRef?: string;
+    expiresAt?: Date;
+    /** Internal-only economics / raw row for reserve. Never serialized publicly. */
+    providerData?: Record<string, unknown>;
+}
+export type AccommodationSearchBridge = (ctx: OwnedSearchContext, input: AccommodationSearchBridgeInput) => Promise<{
+    matches: AccommodationSearchMatch[];
+    nextCursor?: string;
+}>;
+export interface CreateAccommodationSearchHandlerOptions {
+    /**
+     * Resolves owned accommodation availability for a stay. Wired by the
+     * deployment to its owned room/rate query (joins through the operations
+     * places/facility schema + the deployment's rate source).
+     */
+    searchBridge: AccommodationSearchBridge;
+}
+export declare function createAccommodationOwnedSearchHandler(options: CreateAccommodationSearchHandlerOptions): OwnedAvailabilitySearchHandler;
+/** Whole nights between two ISO dates (UTC), floored to ≥ 1. */
+export declare function nightsBetween(checkIn: string, checkOut: string): number;
+//# sourceMappingURL=search-handler.d.ts.map

package/dist/booking-engine/search-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-handler.d.ts","sourceRoot":"","sources":["../../src/booking-engine/search-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,8BAA8B,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAChG,OAAO,KAAK,EAEV,yBAAyB,EAE1B,MAAM,yCAAyC,CAAA;AAEhD,+EAA+E;AAC/E,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,WAAW,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACtE,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAChE,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,4BAA4B,EAAE,CAAA;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,2BAA2B,CAAA;IACrC,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,yBAAyB,CAAC,OAAO,CAAC,CAAA;IACzC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,uFAAuF;IACvF,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,4BAA4B,CAAA;IACvC,qDAAqD;IACrD,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,GAAG,EAAE,kBAAkB,EACvB,KAAK,EAAE,8BAA8B,KAClC,OAAO,CAAC;IAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE1E,MAAM,WAAW,uCAAuC;IACtD;;;;OAIG;IACH,YAAY,EAAE,yBAAyB,CAAA;CACxC;AAED,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,uCAAuC,GAC/C,8BAA8B,CAwBhC;AAiBD,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQvE"}

package/dist/booking-engine/search-handler.js

@@ -0,0 +1,77 @@
+/**
+ * Owned-arm availability-search handler for the `accommodation` vertical.
+ *
+ * The counterpart of `createAccommodationBookingHandler`: it lets owned
+ * accommodation inventory participate in the catalog availability fan-out
+ * (`fanOutAvailabilitySearch`, RFC #2081/#2093) so owned and sourced supply
+ * land in one ranked candidate list.
+ *
+ * Like the booking handler, this is a thin shell that delegates the actual
+ * inventory query to a caller-supplied **bridge**. Owned accommodations have no
+ * date-aware rate/availability table in the schema yet, and the location lookup
+ * spans the operations (places/facility) schema — both deployment-specific — so
+ * the handler owns the vertical-agnostic parts (criteria validation, nights,
+ * candidate assembly) and the deployment owns the data access.
+ */
+export function createAccommodationOwnedSearchHandler(options) {
+    return {
+        entityModule: "accommodations",
+        async searchAvailability(ctx, request) {
+            const criteria = parseAccommodationCriteria(request.criteria);
+            const nights = nightsBetween(criteria.checkIn, criteria.checkOut);
+            const { matches, nextCursor } = await options.searchBridge(ctx, {
+                criteria,
+                nights,
+                scope: request.scope,
+                limit: request.limit,
+                cursor: request.cursor,
+            });
+            const candidates = matches.map((match) => matchToCandidate(match, criteria));
+            return {
+                candidates,
+                status: candidates.length > 0 ? "ok" : "empty",
+                next_cursor: nextCursor,
+            };
+        },
+    };
+}
+function parseAccommodationCriteria(criteria) {
+    const c = criteria;
+    if (typeof c.checkIn !== "string" || typeof c.checkOut !== "string") {
+        throw new Error("Accommodation search requires `checkIn` and `checkOut` (ISO dates) in criteria");
+    }
+    if (!Array.isArray(c.rooms) || c.rooms.length === 0) {
+        throw new Error("Accommodation search requires a non-empty `rooms` array in criteria");
+    }
+    return c;
+}
+/** Whole nights between two ISO dates (UTC), floored to ≥ 1. */
+export function nightsBetween(checkIn, checkOut) {
+    const start = Date.parse(checkIn);
+    const end = Date.parse(checkOut);
+    if (Number.isNaN(start) || Number.isNaN(end)) {
+        throw new Error("Accommodation search `checkIn`/`checkOut` must be valid ISO dates");
+    }
+    const nights = Math.round((end - start) / 86_400_000);
+    return nights >= 1 ? nights : 1;
+}
+function matchToCandidate(match, criteria) {
+    return {
+        candidateRef: match.candidateRef ??
+            `${match.accommodationId}:${match.roomTypeId}:${match.ratePlanId}:${criteria.checkIn}:${criteria.checkOut}`,
+        entity_module: "accommodations",
+        entity_id: match.accommodationId,
+        // Enough to re-resolve + reserve the owned stay via the booking handler.
+        selection: {
+            roomTypeId: match.roomTypeId,
+            ratePlanId: match.ratePlanId,
+            checkIn: criteria.checkIn,
+            checkOut: criteria.checkOut,
+            occupancy: match.occupancy,
+        },
+        // `source` is left for the fan-out to stamp as { kind: "owned", module }.
+        price: match.price,
+        expiresAt: match.expiresAt,
+        providerData: match.providerData,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/accommodations",
-  "version": "0.105.30",
+  "version": "0.106.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -60,10 +60,10 @@
     "hono": "^4.12.10",
     "zod": "^4.3.6",
     "@voyant-travel/accommodations-contracts": "^0.105.3",
-    "@voyant-travel/bookings": "^0.132.0",
-    "@voyant-travel/catalog": "^0.130.0",
-    "@voyant-travel/db": "^0.108.5",
-    "@voyant-travel/operations": "^0.2.7"
+    "@voyant-travel/bookings": "^0.133.0",
+    "@voyant-travel/catalog": "^0.131.0",
+    "@voyant-travel/operations": "^0.2.8",
+    "@voyant-travel/db": "^0.109.0"
   },
   "devDependencies": {
     "drizzle-kit": "^0.31.10",