@voyant-travel/cruises 0.118.2

package/dist/catalog-policy-core.js

@@ -0,0 +1,247 @@
+export const CRUISE_CORE_FIELD_POLICY = [
+    // ── Source pointer / provenance ─────────────────────────────────────────
+    {
+        path: "source.kind",
+        class: "managed",
+        merge: "source-only",
+        drift: "critical",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "source.ref",
+        class: "managed",
+        merge: "source-only",
+        drift: "critical",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "seller.operator_id",
+        class: "managed",
+        merge: "source-only",
+        drift: "critical",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "static",
+    },
+    // ── Identity / lifecycle ────────────────────────────────────────────────
+    {
+        path: "id",
+        class: "managed",
+        merge: "source-only",
+        drift: "critical",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "first-class-table",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "static",
+    },
+    {
+        path: "slug",
+        class: "managed",
+        merge: "source-only",
+        drift: "high",
+        reindex: "entry",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "createdAt",
+        class: "managed",
+        merge: "source-only",
+        drift: "none",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "static",
+    },
+    {
+        path: "updatedAt",
+        class: "managed",
+        merge: "source-only",
+        drift: "none",
+        reindex: "none",
+        snapshot: "never",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "externalRefs",
+        class: "managed",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "none",
+        snapshot: "on-book",
+        query: "blob-only",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    // ── Merchandisable / marketing ──────────────────────────────────────────
+    {
+        path: "name",
+        class: "merchandisable",
+        merge: "replace",
+        drift: "medium",
+        reindex: "entry-locale",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: true,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "marketing",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "description",
+        class: "merchandisable",
+        merge: "replace",
+        drift: "low",
+        reindex: "entry-locale",
+        snapshot: "on-book",
+        query: "blob-only",
+        localized: true,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "marketing",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "shortDescription",
+        class: "merchandisable",
+        merge: "replace",
+        drift: "low",
+        reindex: "entry-locale",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: true,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "marketing",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "highlights",
+        class: "merchandisable",
+        merge: "additive-list",
+        drift: "low",
+        reindex: "entry-locale",
+        snapshot: "on-book",
+        query: "blob-only",
+        localized: true,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "marketing",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        // Note: split rule §7.1 — `inclusionsHtml` is human-readable copy;
+        // `cruiseInclusionEntitlements` (deferred — child entity) is the
+        // machine-evaluable form. Today they live in separate columns; the
+        // split is honored.
+        path: "inclusionsHtml",
+        class: "merchandisable",
+        merge: "replace",
+        drift: "medium",
+        reindex: "entry-locale",
+        snapshot: "on-book",
+        query: "blob-only",
+        localized: true,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "marketing",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "exclusionsHtml",
+        class: "merchandisable",
+        merge: "replace",
+        drift: "medium",
+        reindex: "entry-locale",
+        snapshot: "on-book",
+        query: "blob-only",
+        localized: true,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "marketing",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "heroImageUrl",
+        class: "merchandisable",
+        merge: "replace",
+        drift: "low",
+        reindex: "entry",
+        snapshot: "on-book",
+        query: "blob-only",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "marketing",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "thumbnailUrl",
+        class: "merchandisable",
+        merge: "source-only",
+        drift: "low",
+        reindex: "entry",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "mapImageUrl",
+        class: "merchandisable",
+        merge: "replace",
+        drift: "low",
+        reindex: "entry",
+        snapshot: "on-book",
+        query: "blob-only",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "marketing",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+];

package/dist/catalog-policy-structure.d.ts

@@ -0,0 +1,3 @@
+import type { FieldPolicyInput } from "@voyant-travel/catalog/contract";
+export declare const CRUISE_STRUCTURE_FIELD_POLICY: FieldPolicyInput[];
+//# sourceMappingURL=catalog-policy-structure.d.ts.map

package/dist/catalog-policy-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-policy-structure.d.ts","sourceRoot":"","sources":["../src/catalog-policy-structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAEvE,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAmY3D,CAAA"}

package/dist/catalog-policy-structure.js

@@ -0,0 +1,387 @@
+export const CRUISE_STRUCTURE_FIELD_POLICY = [
+    // ── Structural / facet-affecting ───────────────────────────────────────
+    {
+        path: "cruiseType",
+        class: "structural",
+        merge: "source-only",
+        drift: "high",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        // Supply mechanic — cruises are always `scheduled` (fixed dated sailings
+        // with cabin allotment). See docs/architecture/catalog-supply-models.md.
+        path: "supplyModel",
+        class: "structural",
+        merge: "source-only",
+        drift: "low",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "status",
+        class: "structural",
+        merge: "source-only",
+        drift: "high",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "lineSupplierId",
+        class: "structural",
+        merge: "source-only",
+        drift: "high",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "defaultShipId",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "entry",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "nights",
+        class: "structural",
+        merge: "source-only",
+        drift: "high",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "embarkPortFacilityId",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "embarkPortCanonicalPlaceId",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "disembarkPortFacilityId",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "disembarkPortCanonicalPlaceId",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "region_ids[]",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "waterway_ids[]",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "port_ids[]",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "country_iso[]",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    // TODO(catalog): split into marketing_regions + facet_regions per §7.1.
+    // Today's schema has one `regions` column; declared structural so search
+    // facets work, but that means marketing edits to it would drift faceting.
+    // Operationally this is mostly source-controlled today; flag for split.
+    {
+        path: "regions[]",
+        class: "structural",
+        merge: "additive-set",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "ops",
+        overrideFriction: "confirm",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "waterways[]",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: true,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "ports[]",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: true,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "countries[]",
+        class: "structural",
+        merge: "source-only",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: true,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        // Same TODO as `regions` — split into marketing_themes + facet_themes
+        // when the rule lands.
+        path: "themes[]",
+        class: "structural",
+        merge: "additive-set",
+        drift: "medium",
+        reindex: "facet-affecting",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "ops",
+        overrideFriction: "confirm",
+        sourceFreshness: "sync",
+    },
+    // ── Volatile-indexed (browse-time approximations) ──────────────────────
+    // The cached lowest-price (integer minor units) + departure window are
+    // explicit Tier 1 indexed price summaries (architecture §5.4.3). Refreshed
+    // on source freshness sync; quote-time price comes through volatile-live
+    // elsewhere.
+    {
+        path: "lowestPriceCached",
+        class: "volatile-indexed",
+        merge: "source-only",
+        drift: "low",
+        reindex: "entry",
+        snapshot: "on-quote-and-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "lowestPriceCurrencyCached",
+        class: "volatile-indexed",
+        merge: "source-only",
+        drift: "low",
+        reindex: "entry",
+        snapshot: "on-quote-and-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "lowestPriceUnit",
+        class: "volatile-indexed",
+        merge: "source-only",
+        drift: "low",
+        reindex: "entry",
+        snapshot: "on-quote-and-book",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "earliestDepartureCached",
+        class: "volatile-indexed",
+        merge: "source-only",
+        drift: "low",
+        reindex: "facet-affecting",
+        snapshot: "never",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "latestDepartureCached",
+        class: "volatile-indexed",
+        merge: "source-only",
+        drift: "low",
+        reindex: "facet-affecting",
+        snapshot: "never",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        // Distinct departure months (`YYYY-MM`) across the cruise's sailings.
+        // Facet-affecting (string[]) so browse surfaces can filter by departure
+        // month/year. Populated from the per-cruise sailing list at sync time —
+        // the upstream search projection only carries the [earliest, latest]
+        // window, not the per-month breakdown.
+        path: "departureMonths[]",
+        class: "volatile-indexed",
+        merge: "source-only",
+        drift: "low",
+        reindex: "facet-affecting",
+        snapshot: "never",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        // Total sailing (departure) count — typed `int64` via the `Count` suffix.
+        // Rendered on browse cards alongside the next departure date.
+        path: "departureCount",
+        class: "volatile-indexed",
+        merge: "source-only",
+        drift: "low",
+        reindex: "entry",
+        snapshot: "never",
+        query: "indexed-column",
+        localized: false,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+];

package/dist/catalog-policy.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Catalog plane field policy for root `cruises` rows.
+ *
+ * Deferred child-entity registries: sailings, cabin categories/decks,
+ * itinerary days, and pricing grids.
+ */
+import { type FieldPolicyInput } from "@voyant-travel/catalog/contract";
+declare const CRUISE_FIELD_POLICY: FieldPolicyInput[];
+/**
+ * Resolved field-policy registry for cruises. Templates wire it into the
+ * indexer, overlay resolver, and snapshot capture pipeline.
+ */
+export declare const cruiseCatalogPolicy: import("@voyant-travel/catalog").FieldPolicy[];
+export { CRUISE_FIELD_POLICY };
+//# sourceMappingURL=catalog-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-policy.d.ts","sourceRoot":"","sources":["../src/catalog-policy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAK1F,QAAA,MAAM,mBAAmB,EAAE,gBAAgB,EAG1C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,gDAAyC,CAAA;AAEzE,OAAO,EAAE,mBAAmB,EAAE,CAAA"}

package/dist/catalog-policy.js

@@ -0,0 +1,19 @@
+/**
+ * Catalog plane field policy for root `cruises` rows.
+ *
+ * Deferred child-entity registries: sailings, cabin categories/decks,
+ * itinerary days, and pricing grids.
+ */
+import { defineFieldPolicy } from "@voyant-travel/catalog/contract";
+import { CRUISE_CORE_FIELD_POLICY } from "./catalog-policy-core.js";
+import { CRUISE_STRUCTURE_FIELD_POLICY } from "./catalog-policy-structure.js";
+const CRUISE_FIELD_POLICY = [
+    ...CRUISE_CORE_FIELD_POLICY,
+    ...CRUISE_STRUCTURE_FIELD_POLICY,
+];
+/**
+ * Resolved field-policy registry for cruises. Templates wire it into the
+ * indexer, overlay resolver, and snapshot capture pipeline.
+ */
+export const cruiseCatalogPolicy = defineFieldPolicy(CRUISE_FIELD_POLICY);
+export { CRUISE_FIELD_POLICY };

package/dist/content-shape.d.ts

@@ -0,0 +1,5 @@
+import { type ContentOverlay, type MergeOverlaysOptions } from "@voyant-travel/catalog";
+import { type CruiseContent } from "@voyant-travel/cruises-contracts/content-shape";
+export { BOARD_BASIS_FROM_SHORT_CODE, BOARD_BASIS_SHORT_CODES, BOARD_BASIS_VALUES, type BoardBasis, type BoardBasisShortCode, boardBasisSchema, CRUISES_CONTENT_SCHEMA_VERSION, type CruiseCabinCategory, type CruiseContent, type CruiseItineraryStop, type CruisePolicy, type CruiseSailing, type CruiseShip, type CruiseSummary, cruiseCabinCategorySchema, cruiseContentSchema, cruiseItineraryStopSchema, cruisePolicySchema, cruiseSailingSchema, cruiseShipSchema, cruiseSummarySchema, validateCruiseContent, } from "@voyant-travel/cruises-contracts/content-shape";
+export declare function mergeOverlaysIntoCruiseContent(payload: CruiseContent, overlays: ReadonlyArray<ContentOverlay>, options?: Pick<MergeOverlaysOptions, "onOverlayError">): CruiseContent;
+//# sourceMappingURL=content-shape.d.ts.map

package/dist/content-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-shape.d.ts","sourceRoot":"","sources":["../src/content-shape.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAE1B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,gDAAgD,CAAA;AAEvD,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,gBAAgB,EAChB,8BAA8B,EAC9B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,gDAAgD,CAAA;AAEvD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,EACvC,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,CAAM,GACzD,aAAa,CASf"}