@voyant-travel/catalog-react 0.117.2

package/dist/catalog-enrichment.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Catalog detail enrichment — the normalized detail view-model
+ * (`CatalogDetailEnrichment`) + the client that fetches a single entity's rich
+ * content from the catalog content service and maps it into that shape.
+ *
+ * Provides a first-class factory for the
+ * `/v1/admin/{products,cruises,accommodations}/:id/content` URLs the detail
+ * sheet expects, so hosts no longer hand-roll `onLoadProductDetail` for the
+ * common case and can't accidentally point at a route that isn't mounted.
+ *
+ * The server side of this contract is `createProductContentRoutes` from
+ * `@voyant-travel/inventory`. If a host mounts `CatalogPage` with
+ * `enrichmentFetchers` but forgets the server mount, the first 404 triggers a
+ * one-time `console.warn` pointing at the docs — fast feedback on the foot-gun
+ * called out in issue #1023.
+ */
+import type { CatalogSearchHit } from "./schemas.js";
+/**
+ * Rich detail enrichment loaded on-demand when the sheet opens.
+ * Fetched separately from the search index — the index keeps a lean
+ * facetable projection; the enrichment carries everything else via the
+ * catalog content service (description, itinerary, media, options,
+ * policies, supplier).
+ */
+export interface CatalogDetailEnrichment {
+    /** Entity display name from the content source (header on the full-page view). */
+    name?: string | null;
+    description?: string | null;
+    shortDescription?: string | null;
+    highlights?: ReadonlyArray<string>;
+    heroImageUrl?: string | null;
+    supplier?: string | null;
+    /** The vessel a cruise sails on (Ship tab). */
+    ship?: {
+        id?: string | null;
+        name: string;
+        shipType?: string | null;
+        description?: string | null;
+        deckPlanUrl?: string | null;
+        deckPlans?: Array<{
+            name: string;
+            level?: number | null;
+            imageUrl?: string | null;
+        }>;
+        capacity?: number | null;
+        decks?: number | null;
+        yearBuilt?: number | null;
+        images?: string[];
+    } | null;
+    itinerary?: ReadonlyArray<{
+        dayNumber: number;
+        title?: string | null;
+        description?: string | null;
+        location?: string | null;
+        date?: string | null;
+        arrivalTime?: string | null;
+        departureTime?: string | null;
+        isAtSea?: boolean | null;
+        /** Optional hero image rendered alongside the day card. */
+        heroImageUrl?: string | null;
+    }>;
+    media?: ReadonlyArray<{
+        url: string;
+        type?: string;
+        caption?: string | null;
+    }>;
+    options?: ReadonlyArray<{
+        id: string;
+        name: string;
+        description?: string | null;
+        code?: string | null;
+        type?: string | null;
+        images?: string[];
+        floorplanImages?: string[];
+        squareFeet?: string | null;
+        gradeCodes?: string[];
+        wheelchairAccessible?: boolean;
+        capacityMax?: number | null;
+        amenities?: string[];
+    }>;
+    policies?: ReadonlyArray<{
+        kind: string;
+        body: string;
+    }>;
+    departures?: ReadonlyArray<{
+        id: string;
+        sourceRef?: string | null;
+        startsAt: string;
+        endsAt?: string | null;
+        durationNights?: number | null;
+        status?: string | null;
+        embarkationPort?: string | null;
+        disembarkationPort?: string | null;
+        unlimited?: boolean | null;
+        capacity?: number | null;
+        remaining?: number | null;
+        lowestPriceCents?: number | null;
+        currency?: string | null;
+        note?: string | null;
+        itinerary?: ReadonlyArray<{
+            dayNumber: number;
+            title?: string | null;
+            description?: string | null;
+            location?: string | null;
+            date?: string | null;
+            arrivalTime?: string | null;
+            departureTime?: string | null;
+            isAtSea?: boolean | null;
+        }>;
+    }>;
+    /** Resolution metadata — drives the chips at the top. */
+    servedLocale?: string;
+    matchKind?: string;
+    source?: string;
+    servedStale?: boolean;
+    synthesized?: boolean;
+    machineTranslated?: boolean;
+}
+export interface CatalogEnrichmentFetchers {
+    /**
+     * Fetch the rich detail enrichment for a single hit. Returns `null`
+     * when the server has no content row (404 / 503) — the sheet falls
+     * back to the bare indexed projection.
+     *
+     * `vertical` selects the content route when `contentBasePathByVertical`
+     * is configured (e.g. cruises read `/v1/admin/cruises/:id/content`,
+     * not the products route). Returns `null` for verticals with no
+     * configured content route so the sheet renders the projection only.
+     */
+    loadProductDetail: (hit: CatalogSearchHit, vertical?: string) => Promise<CatalogDetailEnrichment | null>;
+    /**
+     * Fetch live per-cabin pricing for one sailing (cruises). Called lazily when
+     * a departure row expands — pricing is volatile-live, so it's never cached in
+     * the detail enrichment. Returns `null` when unavailable (non-cruise vertical,
+     * no sailing ref, or the adapter can't price).
+     */
+    loadDeparturePricing: (hit: CatalogSearchHit, sailingRef: string, vertical?: string) => Promise<CatalogDeparturePricingRow[] | null>;
+}
+/** One live per-cabin price row for a cruise sailing. */
+export interface CatalogDeparturePricingRow {
+    cabinExternalId: string;
+    occupancy: number;
+    fareCode: string | null;
+    fareName: string | null;
+    currency: string;
+    /** Major-unit price string as the adapter returns it (e.g. "12959.00"). */
+    pricePerPerson: string;
+    availability: string;
+}
+export interface CatalogEnrichmentFetchersOptions {
+    /** Base URL the content route lives under, e.g. `/api` or `https://operator.example/api`. */
+    baseUrl: string;
+    /**
+     * Hono-mount path for `createProductContentRoutes`. Defaults to
+     * `/v1/admin/products` — the operator mount. Public surfaces typically
+     * pass `/v1/public/products`.
+     */
+    contentBasePath?: string;
+    /**
+     * Per-vertical content mount paths, e.g.
+     * `{ products: "/v1/admin/products", cruises: "/v1/admin/cruises" }`.
+     * When set, the detail loader routes by the hit's vertical: a vertical
+     * present in the map fetches from its path; a vertical absent from the
+     * map skips the fetch (returns `null`) so the sheet shows the projection
+     * only — avoiding a spurious request to the products route. When unset,
+     * every fetch uses `contentBasePath` (legacy single-vertical behavior).
+     */
+    contentBasePathByVertical?: Record<string, string>;
+    fetch?: typeof globalThis.fetch;
+    credentials?: RequestCredentials;
+    /**
+     * Resolves supplier ids to display names. The server returns the
+     * supplier as an id string; the sheet shows the resolved name. When
+     * omitted, the id is passed through unchanged.
+     */
+    formatSupplier?: (id: string) => string;
+    /** Optional locale forwarded as `?locale=...` (BCP 47). */
+    locale?: string;
+    /** Optional market id forwarded as `?market=...`. */
+    market?: string;
+    /**
+     * Optional per-departure availability loader. When provided, the
+     * fetcher merges runtime availability (status / remaining / capacity)
+     * onto each departure in the result. Mirrors the operator's existing
+     * call to `/v1/admin/catalog/slots`.
+     */
+    loadSlotAvailability?: (productId: string) => Promise<Map<string, CatalogSlotAvailability>>;
+}
+export interface CatalogSlotAvailability {
+    id: string;
+    startsAt?: string;
+    status?: string | null;
+    unlimited?: boolean | null;
+    remainingPax?: number | null;
+    initialPax?: number | null;
+}
+/**
+ * Build a `CatalogEnrichmentFetchers` for the configured `baseUrl`.
+ */
+export declare function createCatalogEnrichmentFetchers(options: CatalogEnrichmentFetchersOptions): CatalogEnrichmentFetchers;
+/** @internal — exported for testing. Resets the one-time warn flag. */
+export declare function __resetEnrichmentFetcherWarnings(): void;
+//# sourceMappingURL=catalog-enrichment.d.ts.map

package/dist/catalog-enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-enrichment.d.ts","sourceRoot":"","sources":["../src/catalog-enrichment.ts"],"names":[],"mappings":"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"}

package/dist/catalog-enrichment.js

@@ -0,0 +1,130 @@
+/**
+ * Catalog detail enrichment — the normalized detail view-model
+ * (`CatalogDetailEnrichment`) + the client that fetches a single entity's rich
+ * content from the catalog content service and maps it into that shape.
+ *
+ * Provides a first-class factory for the
+ * `/v1/admin/{products,cruises,accommodations}/:id/content` URLs the detail
+ * sheet expects, so hosts no longer hand-roll `onLoadProductDetail` for the
+ * common case and can't accidentally point at a route that isn't mounted.
+ *
+ * The server side of this contract is `createProductContentRoutes` from
+ * `@voyant-travel/inventory`. If a host mounts `CatalogPage` with
+ * `enrichmentFetchers` but forgets the server mount, the first 404 triggers a
+ * one-time `console.warn` pointing at the docs — fast feedback on the foot-gun
+ * called out in issue #1023.
+ */
+import { mapContentToEnrichment, } from "./catalog-enrichment-mappers.js";
+let warnedAboutMissingMount = false;
+/**
+ * Build a `CatalogEnrichmentFetchers` for the configured `baseUrl`.
+ */
+export function createCatalogEnrichmentFetchers(options) {
+    const { baseUrl, contentBasePath = "/v1/admin/products", contentBasePathByVertical, fetch: fetchImpl = globalThis.fetch, credentials = "include", formatSupplier, locale, market, loadSlotAvailability, } = options;
+    const root = trimTrailingSlash(baseUrl);
+    const defaultBasePath = ensureLeadingSlash(contentBasePath);
+    // Resolve the content mount for a vertical. Returns null when a per-vertical
+    // map is configured but this vertical has no entry (so callers skip the fetch
+    // rather than hitting the products route with a foreign id, which 404s).
+    const resolveBasePath = (vertical) => {
+        if (!contentBasePathByVertical)
+            return defaultBasePath;
+        if (!vertical)
+            return null;
+        const mapped = contentBasePathByVertical[vertical];
+        return mapped ? ensureLeadingSlash(mapped) : null;
+    };
+    const loadProductDetail = async (hit, vertical) => {
+        const basePath = resolveBasePath(vertical);
+        if (!basePath)
+            return null;
+        const url = buildContentUrl(root, basePath, hit.id, { locale, market });
+        let response;
+        try {
+            response = await fetchImpl(url, {
+                method: "GET",
+                headers: { Accept: "application/json" },
+                credentials,
+            });
+        }
+        catch (err) {
+            throw new Error(`catalog enrichment fetch failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (response.status === 404 || response.status === 503) {
+            // 404 ALSO means the server didn't mount `createProductContentRoutes`.
+            // Warn once so the foot-gun called out in #1023 surfaces in dev
+            // instead of silently rendering the bare projection.
+            maybeWarnMissingMount(response, url);
+            return null;
+        }
+        if (!response.ok) {
+            throw new Error(`catalog enrichment fetch failed: ${response.status} ${response.statusText}`);
+        }
+        const payload = (await response.json());
+        const availability = loadSlotAvailability
+            ? // i18n-literal-ok: `=> new Map<…>` trips the JSX-text heuristic — no user-facing copy here.
+                await loadSlotAvailability(hit.id).catch(() => new Map())
+            : new Map();
+        return mapContentToEnrichment(payload, availability, formatSupplier);
+    };
+    const loadDeparturePricing = async (hit, sailingRef, vertical) => {
+        const basePath = resolveBasePath(vertical);
+        if (!basePath)
+            return null;
+        const url = `${root}${basePath}/${encodeURIComponent(hit.id)}/sailings/${encodeURIComponent(sailingRef)}/pricing`;
+        let response;
+        try {
+            response = await fetchImpl(url, {
+                method: "GET",
+                headers: { Accept: "application/json" },
+                credentials,
+            });
+        }
+        catch {
+            return null;
+        }
+        if (!response.ok)
+            return null;
+        const payload = (await response.json());
+        return payload.data?.pricing ?? null;
+    };
+    return { loadProductDetail, loadDeparturePricing };
+}
+function maybeWarnMissingMount(response, url) {
+    if (warnedAboutMissingMount)
+        return;
+    if (response.status !== 404)
+        return;
+    // Heuristic: a 404 returned with no JSON body almost always means the
+    // route is unmounted on the server side. A real "product not found"
+    // response carries a JSON `{ error: "not_found", detail }`. We don't
+    // re-read the body here (the caller will not parse it for 404), so we
+    // log a generic hint — false positives are tolerable in dev.
+    warnedAboutMissingMount = true;
+    if (typeof console !== "undefined" && typeof console.warn === "function") {
+        console.warn(`[catalog-ui] enrichment fetch returned 404 for ${url}. ` +
+            `If the catalog detail sheet renders empty, make sure the host mounts ` +
+            `createProductContentRoutes from @voyant-travel/inventory ` +
+            `under the same prefix used here.`);
+    }
+}
+function buildContentUrl(root, basePath, id, query) {
+    const params = new URLSearchParams();
+    if (query.locale)
+        params.set("locale", query.locale);
+    if (query.market)
+        params.set("market", query.market);
+    const qs = params.toString();
+    const suffix = qs ? `?${qs}` : "";
+    return `${root}${basePath}/${encodeURIComponent(id)}/content${suffix}`;
+}
+function trimTrailingSlash(s) {
+    return s.endsWith("/") ? s.slice(0, -1) : s;
+}
+function ensureLeadingSlash(s) {
+    return s.startsWith("/") ? s : `/${s}`;
+}
+/** @internal — exported for testing. Resets the one-time warn flag. */
+export function __resetEnrichmentFetcherWarnings() {
+    warnedAboutMissingMount = false;
+}

package/dist/catalog-offers-client.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Client functions for the Booking.com-style catalog offer endpoints.
+ *
+ * These are the non-hook layer (mirrors `fetchWithValidation`'s "bypass the
+ * hook layer" intent) — imperative consumers (search-on-submit, lazy
+ * per-row pricing) call these directly with `{ baseUrl, fetcher }` from
+ * `useVoyantCatalogContext()`; the `hooks/` wrap them in react-query.
+ *
+ * `surface` switches `/v1/admin/...` (operator dashboards, default) vs
+ * `/v1/public/...` (storefront / partner / embedded surfaces).
+ */
+import { type VoyantFetcher } from "./client.js";
+import { type CatalogSlotsResponse, type CruiseContentResponse, type CruisePriceResponse, type CruiseSailingPricingResponse, type DepartureAirportsResponse, type PackageDetailResponse, type PackageSearchResponse } from "./schemas-catalog-offers.js";
+export type CatalogSurface = "admin" | "public";
+export interface CatalogOffersClientContext {
+    baseUrl: string;
+    fetcher: VoyantFetcher;
+    /** Defaults to `"admin"`. */
+    surface?: CatalogSurface;
+}
+export interface NightsRange {
+    min: number;
+    max: number;
+}
+export declare function fetchDepartureAirports(ctx: CatalogOffersClientContext, args: {
+    countryCode: string;
+}, signal?: AbortSignal): Promise<DepartureAirportsResponse>;
+export declare function fetchPackageSearch(ctx: CatalogOffersClientContext, args: {
+    countryCode: string;
+    departureDateFrom: string;
+    departureDateTo: string;
+    adults: number;
+    nights: NightsRange;
+}, signal?: AbortSignal): Promise<PackageSearchResponse>;
+export declare function fetchPackageDetail(ctx: CatalogOffersClientContext, args: {
+    productId: string;
+    departureDateFrom: string;
+    departureDateTo: string;
+    adults: number;
+    nights: NightsRange;
+    locale?: string;
+}, signal?: AbortSignal): Promise<PackageDetailResponse>;
+export declare function fetchCruisePrice(ctx: CatalogOffersClientContext, args: {
+    cruiseId: string;
+}, signal?: AbortSignal): Promise<CruisePriceResponse>;
+export declare function fetchCruiseSailingPricing(ctx: CatalogOffersClientContext, args: {
+    cruiseId: string;
+    sailingRef: string;
+}, signal?: AbortSignal): Promise<CruiseSailingPricingResponse>;
+export declare function fetchCruiseContent(ctx: CatalogOffersClientContext, args: {
+    cruiseId: string;
+    locale?: string;
+}, signal?: AbortSignal): Promise<CruiseContentResponse>;
+export declare function fetchCatalogSlots(ctx: CatalogOffersClientContext, args: {
+    entityModule: string;
+    entityId: string;
+}, signal?: AbortSignal): Promise<CatalogSlotsResponse>;
+//# sourceMappingURL=catalog-offers-client.d.ts.map

package/dist/catalog-offers-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-offers-client.d.ts","sourceRoot":"","sources":["../src/catalog-offers-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EAKjC,KAAK,yBAAyB,EAE9B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAG3B,MAAM,6BAA6B,CAAA;AAEpC,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE/C,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,aAAa,CAAA;IACtB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACZ;AAUD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,0BAA0B,EAC/B,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,yBAAyB,CAAC,CAOpC;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,0BAA0B,EAC/B,IAAI,EAAE;IACJ,WAAW,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,WAAW,CAAA;CACpB,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,qBAAqB,CAAC,CAgBhC;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,0BAA0B,EAC/B,IAAI,EAAE;IACJ,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,EAAE,MAAM,CAAA;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,qBAAqB,CAAC,CAiBhC;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,0BAA0B,EAC/B,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC1B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAO9B;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,0BAA0B,EAC/B,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAC9C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,4BAA4B,CAAC,CAOvC;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,0BAA0B,EAC/B,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,qBAAqB,CAAC,CAYhC;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,0BAA0B,EAC/B,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAChD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAW/B"}

package/dist/catalog-offers-client.js

@@ -0,0 +1,61 @@
+/**
+ * Client functions for the Booking.com-style catalog offer endpoints.
+ *
+ * These are the non-hook layer (mirrors `fetchWithValidation`'s "bypass the
+ * hook layer" intent) — imperative consumers (search-on-submit, lazy
+ * per-row pricing) call these directly with `{ baseUrl, fetcher }` from
+ * `useVoyantCatalogContext()`; the `hooks/` wrap them in react-query.
+ *
+ * `surface` switches `/v1/admin/...` (operator dashboards, default) vs
+ * `/v1/public/...` (storefront / partner / embedded surfaces).
+ */
+import { fetchWithValidation } from "./client.js";
+import { catalogSlotsResponseSchema, cruiseContentResponseSchema, cruisePriceResponseSchema, cruiseSailingPricingResponseSchema, departureAirportsResponseSchema, packageDetailResponseSchema, packageSearchResponseSchema, } from "./schemas-catalog-offers.js";
+function catalogPath(surface, path) {
+    return `/v1/${surface ?? "admin"}/catalog/${path}`;
+}
+function post(body, signal) {
+    return { method: "POST", body: JSON.stringify(body), signal };
+}
+export function fetchDepartureAirports(ctx, args, signal) {
+    return fetchWithValidation(catalogPath(ctx.surface, "departure-airports"), departureAirportsResponseSchema, { baseUrl: ctx.baseUrl, fetcher: ctx.fetcher }, post({ destination: { countryCode: args.countryCode } }, signal));
+}
+export function fetchPackageSearch(ctx, args, signal) {
+    return fetchWithValidation(catalogPath(ctx.surface, "package-search"), packageSearchResponseSchema, { baseUrl: ctx.baseUrl, fetcher: ctx.fetcher }, post({
+        destination: { countryCode: args.countryCode },
+        departureDateFrom: args.departureDateFrom,
+        departureDateTo: args.departureDateTo,
+        adults: args.adults,
+        nights: args.nights,
+    }, signal));
+}
+export function fetchPackageDetail(ctx, args, signal) {
+    return fetchWithValidation(catalogPath(ctx.surface, "package-detail"), packageDetailResponseSchema, { baseUrl: ctx.baseUrl, fetcher: ctx.fetcher }, post({
+        productId: args.productId,
+        departureDateFrom: args.departureDateFrom,
+        departureDateTo: args.departureDateTo,
+        adults: args.adults,
+        nights: args.nights,
+        locale: args.locale,
+    }, signal));
+}
+export function fetchCruisePrice(ctx, args, signal) {
+    return fetchWithValidation(catalogPath(ctx.surface, "cruise-price"), cruisePriceResponseSchema, { baseUrl: ctx.baseUrl, fetcher: ctx.fetcher }, post({ cruiseId: args.cruiseId }, signal));
+}
+export function fetchCruiseSailingPricing(ctx, args, signal) {
+    return fetchWithValidation(catalogPath(ctx.surface, "cruise-sailing-pricing"), cruiseSailingPricingResponseSchema, { baseUrl: ctx.baseUrl, fetcher: ctx.fetcher }, post({ cruiseId: args.cruiseId, sailingRef: args.sailingRef }, signal));
+}
+export function fetchCruiseContent(ctx, args, signal) {
+    const params = new URLSearchParams();
+    if (args.locale)
+        params.set("locale", args.locale);
+    const qs = params.toString();
+    return fetchWithValidation(`/v1/${ctx.surface ?? "admin"}/cruises/${encodeURIComponent(args.cruiseId)}/content${qs ? `?${qs}` : ""}`, cruiseContentResponseSchema, { baseUrl: ctx.baseUrl, fetcher: ctx.fetcher }, { method: "GET", signal });
+}
+export function fetchCatalogSlots(ctx, args, signal) {
+    const params = new URLSearchParams({
+        entityModule: args.entityModule,
+        entityId: args.entityId,
+    });
+    return fetchWithValidation(catalogPath(ctx.surface, `slots?${params.toString()}`), catalogSlotsResponseSchema, { baseUrl: ctx.baseUrl, fetcher: ctx.fetcher }, { method: "GET", signal });
+}

package/dist/catalog-search-params.d.ts

@@ -0,0 +1,45 @@
+import { z } from "zod";
+/**
+ * Catalog browse search state — the URL/query shape shared by every catalog
+ * surface (grid/list + sort + facet/range filters). Lives in the data layer
+ * (no router imports) so route files and templates parse/validate the same
+ * contract; the operator binds it to TanStack Router's `validateSearch`.
+ */
+export declare const catalogViewModes: readonly ["grid", "list"];
+export type CatalogViewMode = (typeof catalogViewModes)[number];
+export declare const catalogSortOptions: readonly ["relevance", "price-asc", "price-desc", "departure-asc", "newest"];
+export type CatalogSortOption = (typeof catalogSortOptions)[number];
+export declare const catalogFiltersSchema: z.ZodObject<{
+    facets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>;
+    ranges: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        gte: z.ZodOptional<z.ZodNumber>;
+        lte: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type CatalogFilterSelections = z.infer<typeof catalogFiltersSchema>;
+export declare const catalogSearchSchema: z.ZodObject<{
+    q: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    market: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodString>;
+    view: z.ZodOptional<z.ZodEnum<{
+        grid: "grid";
+        list: "list";
+    }>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        relevance: "relevance";
+        "price-asc": "price-asc";
+        "price-desc": "price-desc";
+        "departure-asc": "departure-asc";
+        newest: "newest";
+    }>>;
+    filters: z.ZodOptional<z.ZodObject<{
+        facets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>>;
+        ranges: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            gte: z.ZodOptional<z.ZodNumber>;
+            lte: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CatalogSearchParams = z.infer<typeof catalogSearchSchema>;
+//# sourceMappingURL=catalog-search-params.d.ts.map

package/dist/catalog-search-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-search-params.d.ts","sourceRoot":"","sources":["../src/catalog-search-params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AAEH,eAAO,MAAM,gBAAgB,2BAA4B,CAAA;AACzD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,eAAO,MAAM,kBAAkB,8EAMrB,CAAA;AACV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,eAAO,MAAM,oBAAoB;;;;;;iBAK/B,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAE1E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;iBAQ9B,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/catalog-search-params.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+/**
+ * Catalog browse search state — the URL/query shape shared by every catalog
+ * surface (grid/list + sort + facet/range filters). Lives in the data layer
+ * (no router imports) so route files and templates parse/validate the same
+ * contract; the operator binds it to TanStack Router's `validateSearch`.
+ */
+export const catalogViewModes = ["grid", "list"];
+export const catalogSortOptions = [
+    "relevance",
+    "price-asc",
+    "price-desc",
+    "departure-asc",
+    "newest",
+];
+export const catalogFiltersSchema = z.object({
+    facets: z.record(z.string(), z.array(z.union([z.string(), z.number()]))).optional(),
+    ranges: z
+        .record(z.string(), z.object({ gte: z.number().optional(), lte: z.number().optional() }))
+        .optional(),
+});
+export const catalogSearchSchema = z.object({
+    q: z.string().optional(),
+    page: z.coerce.number().int().min(1).default(1),
+    market: z.string().optional(),
+    locale: z.string().optional(),
+    view: z.enum(catalogViewModes).optional(),
+    sort: z.enum(catalogSortOptions).optional(),
+    filters: catalogFiltersSchema.optional(),
+});

package/dist/catalog-surfaces.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Catalog "surfaces" that have a dedicated, full-page detail view. Excursions
+ * and tours are scheduled PRODUCTS (their own browse surface), but their detail
+ * content comes from the products content route — see `catalogSurfaceVertical`.
+ */
+export declare const catalogDetailSurfaces: readonly ["products", "cruises", "accommodations", "excursions", "tours"];
+export type CatalogDetailSurface = (typeof catalogDetailSurfaces)[number];
+/**
+ * Verticals the indexed browse grid (`CatalogVerticalHost`) can render — the
+ * surfaces with their own search-index collection. Excursions/tours browse the
+ * `products` vertical with locked supply-model/duration filters instead.
+ */
+export declare const catalogVerticalPageIds: readonly ["products", "cruises", "accommodations"];
+export type CatalogVerticalPageId = (typeof catalogVerticalPageIds)[number];
+/** Catalog/content vertical backing a surface (excursions/tours → products). */
+export declare function catalogSurfaceVertical(surface: CatalogDetailSurface): "products" | "cruises" | "accommodations";
+//# sourceMappingURL=catalog-surfaces.d.ts.map

package/dist/catalog-surfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-surfaces.d.ts","sourceRoot":"","sources":["../src/catalog-surfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,2EAMxB,CAAA;AACV,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,oDAAqD,CAAA;AACxF,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3E,gFAAgF;AAChF,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,oBAAoB,GAC5B,UAAU,GAAG,SAAS,GAAG,gBAAgB,CAI3C"}

package/dist/catalog-surfaces.js

@@ -0,0 +1,26 @@
+/**
+ * Catalog "surfaces" that have a dedicated, full-page detail view. Excursions
+ * and tours are scheduled PRODUCTS (their own browse surface), but their detail
+ * content comes from the products content route — see `catalogSurfaceVertical`.
+ */
+export const catalogDetailSurfaces = [
+    "products",
+    "cruises",
+    "accommodations",
+    "excursions",
+    "tours",
+];
+/**
+ * Verticals the indexed browse grid (`CatalogVerticalHost`) can render — the
+ * surfaces with their own search-index collection. Excursions/tours browse the
+ * `products` vertical with locked supply-model/duration filters instead.
+ */
+export const catalogVerticalPageIds = ["products", "cruises", "accommodations"];
+/** Catalog/content vertical backing a surface (excursions/tours → products). */
+export function catalogSurfaceVertical(surface) {
+    if (surface === "cruises")
+        return "cruises";
+    if (surface === "accommodations")
+        return "accommodations";
+    return "products";
+}

package/dist/client.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Re-exports the shared HTTP plumbing from `@voyant-travel/inventory-react/client`
+ * so the catalog-react package doesn't duplicate the fetcher / error-shaping
+ * logic. If/when this drifts, extract into `@voyant-travel/react/client` and
+ * point both packages at it.
+ */
+import type { z } from "zod";
+export type VoyantFetcher = (url: string, init?: RequestInit) => Promise<Response>;
+export declare const defaultFetcher: VoyantFetcher;
+export declare class VoyantApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+export interface FetchWithValidationOptions {
+    baseUrl: string;
+    fetcher: VoyantFetcher;
+}
+export declare function fetchWithValidation<TOut>(path: string, schema: z.ZodType<TOut>, options: FetchWithValidationOptions, init?: RequestInit): Promise<TOut>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAElF,eAAO,MAAM,cAAc,EAAE,aACoB,CAAA;AAEjD,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;gBAEV,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAM3D;AAaD,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,aAAa,CAAA;CACvB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAC5C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,EAAE,0BAA0B,EACnC,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAgCf"}