@voyant-travel/inventory 0.1.0

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

@@ -0,0 +1,43 @@
+/**
+ * Catalog plane field policy for product → destination denormalization.
+ *
+ * These fields don't live on the `products` table — they're joined from
+ * `product_destinations` → `destinations` (+ `destination_translations` for
+ * locale-aware names) at index time and projected onto the product search
+ * document. See `docs/architecture/catalog-architecture.md` §5.4 — the
+ * search index is the canonical place for cross-entity denormalization.
+ *
+ * Storefront product cards filter and display by destinations:
+ *   - "trips to Italy" (filter: `countries[]` includes "Italy")
+ *   - "trips in Rome" (filter: `cities[]` includes "Rome")
+ *   - "Mediterranean cruises" (filter: `regions[]` includes "Mediterranean")
+ *   - "cruises from Amsterdam" (filter: `ports[]` or canonical place ids)
+ *
+ * Wire this policy into the products registry by composing with
+ * `productCatalogPolicy`:
+ *
+ *   const registry = createFieldPolicyRegistry([
+ *     ...productCatalogPolicy,
+ *     ...productDestinationsCatalogPolicy,
+ *   ])
+ *
+ * and wire `createProductDestinationsProjectionExtension` into
+ * `createProductDocumentBuilder` so the values land in the doc.
+ *
+ * Destination rows can carry canonical place ids (for example UN/LOCODE)
+ * and optional display coordinates. The gazetteer itself remains external;
+ * this module stores stable pointers/snapshots for faceting.
+ *
+ * Out of scope here:
+ *   - Slug fields per locale. Destinations have one canonical slug today;
+ *     locale-specific slugs are a follow-up if marketing needs them.
+ */
+import { type FieldPolicyInput } from "@voyant-travel/catalog/contract";
+declare const PRODUCT_DESTINATIONS_FIELD_POLICY: FieldPolicyInput[];
+/**
+ * Resolved destinations policy. Compose with `productCatalogPolicy` when
+ * building the products registry.
+ */
+export declare const productDestinationsCatalogPolicy: import("@voyant-travel/catalog").FieldPolicy[];
+export { PRODUCT_DESTINATIONS_FIELD_POLICY };
+//# sourceMappingURL=catalog-policy-destinations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-policy-destinations.d.ts","sourceRoot":"","sources":["../src/catalog-policy-destinations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAE1F,QAAA,MAAM,iCAAiC,EAAE,gBAAgB,EA6HxD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gCAAgC,gDAAuD,CAAA;AAEpG,OAAO,EAAE,iCAAiC,EAAE,CAAA"}

package/dist/catalog-policy-destinations.js

@@ -0,0 +1,165 @@
+/**
+ * Catalog plane field policy for product → destination denormalization.
+ *
+ * These fields don't live on the `products` table — they're joined from
+ * `product_destinations` → `destinations` (+ `destination_translations` for
+ * locale-aware names) at index time and projected onto the product search
+ * document. See `docs/architecture/catalog-architecture.md` §5.4 — the
+ * search index is the canonical place for cross-entity denormalization.
+ *
+ * Storefront product cards filter and display by destinations:
+ *   - "trips to Italy" (filter: `countries[]` includes "Italy")
+ *   - "trips in Rome" (filter: `cities[]` includes "Rome")
+ *   - "Mediterranean cruises" (filter: `regions[]` includes "Mediterranean")
+ *   - "cruises from Amsterdam" (filter: `ports[]` or canonical place ids)
+ *
+ * Wire this policy into the products registry by composing with
+ * `productCatalogPolicy`:
+ *
+ *   const registry = createFieldPolicyRegistry([
+ *     ...productCatalogPolicy,
+ *     ...productDestinationsCatalogPolicy,
+ *   ])
+ *
+ * and wire `createProductDestinationsProjectionExtension` into
+ * `createProductDocumentBuilder` so the values land in the doc.
+ *
+ * Destination rows can carry canonical place ids (for example UN/LOCODE)
+ * and optional display coordinates. The gazetteer itself remains external;
+ * this module stores stable pointers/snapshots for faceting.
+ *
+ * Out of scope here:
+ *   - Slug fields per locale. Destinations have one canonical slug today;
+ *     locale-specific slugs are a follow-up if marketing needs them.
+ */
+import { defineFieldPolicy } from "@voyant-travel/catalog/contract";
+const PRODUCT_DESTINATIONS_FIELD_POLICY = [
+    // ── Locale-aware destination labels ──────────────────────────────────────
+    // Sourced from `destination_translations` (falls back to `destinations.slug`
+    // when no translation exists for the slice's locale). One array entry per
+    // linked destination of the matching `destination_type`.
+    {
+        path: "regions[]",
+        class: "structural",
+        merge: "source-only",
+        drift: "low",
+        reindex: "entry-locale",
+        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: "low",
+        reindex: "entry-locale",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: true,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "cities[]",
+        class: "structural",
+        merge: "source-only",
+        drift: "low",
+        reindex: "entry-locale",
+        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: "low",
+        reindex: "entry-locale",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: true,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    {
+        path: "waterways[]",
+        class: "structural",
+        merge: "source-only",
+        drift: "low",
+        reindex: "entry-locale",
+        snapshot: "on-book",
+        query: "indexed-column",
+        localized: true,
+        visibility: ["staff", "customer", "partner"],
+        editRole: "none",
+        overrideFriction: "none",
+        sourceFreshness: "sync",
+    },
+    // ── Slugs (locale-stable) ────────────────────────────────────────────────
+    // Used for category-page links — operators want stable URLs that don't
+    // shift when translations are edited. One entry per linked destination.
+    {
+        path: "destinationSlugs[]",
+        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",
+    },
+    // ── Destination IDs ──────────────────────────────────────────────────────
+    // Useful for filtering by exact destination match (e.g. landing pages
+    // pinned to a destination ID rather than a slug).
+    {
+        path: "destinationIds[]",
+        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: "destinationCanonicalPlaceIds[]",
+        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",
+    },
+];
+/**
+ * Resolved destinations policy. Compose with `productCatalogPolicy` when
+ * building the products registry.
+ */
+export const productDestinationsCatalogPolicy = defineFieldPolicy(PRODUCT_DESTINATIONS_FIELD_POLICY);
+export { PRODUCT_DESTINATIONS_FIELD_POLICY };

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

@@ -0,0 +1,55 @@
+/**
+ * Catalog plane field policy for product → pricing denormalization.
+ *
+ * Aggregates a "price from" value across the product's future bookable
+ * default rate-plan prices so storefront cards can render `from $X`
+ * without fanning out to per-option pricing on every render. See
+ * `docs/architecture/catalog-architecture.md` §5.4.
+ *
+ * Storefront product cards filter and display by:
+ *   - "trips under $1000" (filter: `priceFromAmountCents` <= 100000)
+ *   - badge "from $X" (display: `priceFromAmountCents` + `priceFromCurrency`)
+ *   - sort by price ascending (`priceFromAmountCents` asc)
+ *
+ * Wire this policy into the products registry by composing with
+ * `productCatalogPolicy`:
+ *
+ *   const registry = createFieldPolicyRegistry([
+ *     ...productCatalogPolicy,
+ *     ...productPricingCatalogPolicy,
+ *   ])
+ *
+ * and wire `createProductPricingProjectionExtension` (from
+ * `@voyant-travel/commerce` pricing projection support) into
+ * `createProductDocumentBuilder` so the values land in the doc.
+ *
+ * Why a separate field instead of reusing the existing `sellAmountCents`
+ * from `productCatalogPolicy`: that path projects the product-row
+ * configured default verbatim. Multi-option products often leave
+ * `products.sellAmountCents` null or stale and put the real prices on
+ * active rate-plan room/base/unit rows. This projection prefers those
+ * bookable prices and only falls back to the product row when no rate-
+ * plan price exists.
+ *
+ * Out of scope here (deferred):
+ *   - Full schedule-aware rule resolution. The kernel reads
+ *     `isDefault=true` rule prices on options that have a future
+ *     bookable departure; it does NOT walk seasonal schedules or per-
+ *     departure overrides.
+ *   - Per-audience / per-market currency conversion. The currency we
+ *     emit is `products.sellCurrency`; multi-catalog operators using
+ *     mixed currencies for the same product will see prices clipped
+ *     to the rules matching that currency.
+ *   - `pricing.changed` event surface. Today, edits to option-price
+ *     rules don't fire any event, so the bridge can only reindex on
+ *     `product.updated`. Tracked separately.
+ */
+import { type FieldPolicyInput } from "@voyant-travel/catalog/contract";
+declare const PRODUCT_PRICING_FIELD_POLICY: FieldPolicyInput[];
+/**
+ * Resolved pricing policy. Compose with `productCatalogPolicy` when
+ * building the products registry.
+ */
+export declare const productPricingCatalogPolicy: import("@voyant-travel/catalog").FieldPolicy[];
+export { PRODUCT_PRICING_FIELD_POLICY };
+//# sourceMappingURL=catalog-policy-pricing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-policy-pricing.d.ts","sourceRoot":"","sources":["../src/catalog-policy-pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAE1F,QAAA,MAAM,4BAA4B,EAAE,gBAAgB,EAuDnD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,gDAAkD,CAAA;AAE1F,OAAO,EAAE,4BAA4B,EAAE,CAAA"}

package/dist/catalog-policy-pricing.js

@@ -0,0 +1,109 @@
+/**
+ * Catalog plane field policy for product → pricing denormalization.
+ *
+ * Aggregates a "price from" value across the product's future bookable
+ * default rate-plan prices so storefront cards can render `from $X`
+ * without fanning out to per-option pricing on every render. See
+ * `docs/architecture/catalog-architecture.md` §5.4.
+ *
+ * Storefront product cards filter and display by:
+ *   - "trips under $1000" (filter: `priceFromAmountCents` <= 100000)
+ *   - badge "from $X" (display: `priceFromAmountCents` + `priceFromCurrency`)
+ *   - sort by price ascending (`priceFromAmountCents` asc)
+ *
+ * Wire this policy into the products registry by composing with
+ * `productCatalogPolicy`:
+ *
+ *   const registry = createFieldPolicyRegistry([
+ *     ...productCatalogPolicy,
+ *     ...productPricingCatalogPolicy,
+ *   ])
+ *
+ * and wire `createProductPricingProjectionExtension` (from
+ * `@voyant-travel/commerce` pricing projection support) into
+ * `createProductDocumentBuilder` so the values land in the doc.
+ *
+ * Why a separate field instead of reusing the existing `sellAmountCents`
+ * from `productCatalogPolicy`: that path projects the product-row
+ * configured default verbatim. Multi-option products often leave
+ * `products.sellAmountCents` null or stale and put the real prices on
+ * active rate-plan room/base/unit rows. This projection prefers those
+ * bookable prices and only falls back to the product row when no rate-
+ * plan price exists.
+ *
+ * Out of scope here (deferred):
+ *   - Full schedule-aware rule resolution. The kernel reads
+ *     `isDefault=true` rule prices on options that have a future
+ *     bookable departure; it does NOT walk seasonal schedules or per-
+ *     departure overrides.
+ *   - Per-audience / per-market currency conversion. The currency we
+ *     emit is `products.sellCurrency`; multi-catalog operators using
+ *     mixed currencies for the same product will see prices clipped
+ *     to the rules matching that currency.
+ *   - `pricing.changed` event surface. Today, edits to option-price
+ *     rules don't fire any event, so the bridge can only reindex on
+ *     `product.updated`. Tracked separately.
+ */
+import { defineFieldPolicy } from "@voyant-travel/catalog/contract";
+const PRODUCT_PRICING_FIELD_POLICY = [
+    // ── Aggregated "price from" amount ───────────────────────────────────────
+    // MIN across future bookable active default room prices first, then
+    // base/unit fallbacks, then `products.sellAmountCents`. `null` when no
+    // source has a positive amount.
+    {
+        path: "priceFromAmountCents",
+        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",
+    },
+    // ── Currency for the projected amount ────────────────────────────────────
+    // `products.sellCurrency`. Stays consistent across all rule sources for
+    // the projected product because we filter rule rows to ones matching
+    // this currency before MIN'ing.
+    {
+        path: "priceFromCurrency",
+        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",
+    },
+    // ── Existence flag ───────────────────────────────────────────────────────
+    // `false` when neither future rate-plan pricing nor the product row has
+    // a positive amount. Storefront filters use this for "show only priced
+    // products" and to suppress an empty `from` badge.
+    {
+        path: "hasPricing",
+        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",
+    },
+];
+/**
+ * Resolved pricing policy. Compose with `productCatalogPolicy` when
+ * building the products registry.
+ */
+export const productPricingCatalogPolicy = defineFieldPolicy(PRODUCT_PRICING_FIELD_POLICY);
+export { PRODUCT_PRICING_FIELD_POLICY };

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

@@ -0,0 +1,52 @@
+/**
+ * Catalog plane field policy for product → promotional-offer denormalization.
+ *
+ * Promotions are projected as **annotations only** — this policy does NOT
+ * touch the existing `priceFromAmountCents` field (that's emitted by the
+ * pricing extension and the two extensions can't read each other's output;
+ * see `docs/architecture/promotions-architecture.md` §3.7). Instead, we
+ * emit `bestOffer*` + `originalPriceFromAmountCents` and storefront
+ * consumers compute the effective price client-side:
+ *
+ *   effective = bestOfferDiscountKind === "percentage"
+ *     ? round(price × (1 - bestOfferDiscountPercent/100))
+ *     : price - bestOfferDiscountAmountCents
+ *
+ * Catalog filter / sort behavior continues to use `priceFromAmountCents`
+ * (the list price). A customer searching `< $200` won't find a
+ * `$250 → $180` discounted product via the filter — acknowledged v1
+ * limitation, see §15.1 of the architecture doc.
+ *
+ * Conditional offers are surfaced separately so storefront cards can
+ * render hints like "From 4 pax: extra 5% off" — the catalog plane
+ * doesn't know pax at index time, so any offer with a `minPax` condition
+ * lands here instead of in `bestOffer*`.
+ *
+ * Wire this policy into the products registry by composing with
+ * `productCatalogPolicy`:
+ *
+ *   const registry = createFieldPolicyRegistry([
+ *     ...productCatalogPolicy,
+ *     ...productPromotionsCatalogPolicy,
+ *   ])
+ *
+ * and wire `createProductPromotionsProjectionExtension` (from
+ * `@voyant-travel/commerce` promotion projection support) into
+ * `createProductDocumentBuilder` so the values land in the doc.
+ *
+ * Out of scope here:
+ *   - Localized offer names. Offers are operator-managed in one language
+ *     for v1 (`localized: false`); a `promotional_offer_translations`
+ *     table mirrors `destinations_translations` if/when needed.
+ *   - Discount-aware filter / sort. Requires the §15.1 ordered-extensions
+ *     contract change; deferred.
+ */
+import { type FieldPolicyInput } from "@voyant-travel/catalog/contract";
+declare const PRODUCT_PROMOTIONS_FIELD_POLICY: FieldPolicyInput[];
+/**
+ * Resolved promotions policy. Compose with `productCatalogPolicy` when
+ * building the products registry.
+ */
+export declare const productPromotionsCatalogPolicy: import("@voyant-travel/catalog").FieldPolicy[];
+export { PRODUCT_PROMOTIONS_FIELD_POLICY };
+//# sourceMappingURL=catalog-policy-promotions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-policy-promotions.d.ts","sourceRoot":"","sources":["../src/catalog-policy-promotions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAE1F,QAAA,MAAM,+BAA+B,EAAE,gBAAgB,EA4NtD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,8BAA8B,gDAAqD,CAAA;AAEhG,OAAO,EAAE,+BAA+B,EAAE,CAAA"}