@voyantjs/products 0.28.3 → 0.29.0

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

@@ -38,6 +38,14 @@ export interface QuickCreateBridgeInput {
     personId?: string | null;
     organizationId?: string | null;
     internalNotes?: string | null;
+    /**
+     * Override the seed sellAmountCents the booking lands at. The owned
+     * commit passes this when the catalog booking-engine's promotion hook
+     * has discounted the quote — without it, customers would be charged
+     * the product's list price even with a successful promotion. Per
+     * docs/architecture/promotions-architecture.md §7.1.
+     */
+    sellAmountCentsOverride?: number | null;
     travelers?: Array<{
         firstName: string;
         lastName: string;

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

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

package/dist/booking-engine/handler.js

@@ -233,6 +233,13 @@ export function createProductsBookingHandler(options) {
                     ? t.band
                     : "adult",
             }));
+            // Promotion-discounted quotes: thread the discounted customer-
+            // facing amount into the booking's seed sellAmountCents so
+            // checkout / payment see the quoted amount, not the product list
+            // price. Inclusive-tax quotes rewrite `base_amount` to net
+            // subtotal during tax recompute, so derive the override from the
+            // gross breakdown total when an included tax line is present.
+            const sellAmountCentsOverride = resolveSellAmountCentsOverride(request.pricing);
             const bridge = await options.quickCreate({
                 productId: product.id,
                 bookingNumber: generateNumber(),
@@ -240,6 +247,7 @@ export function createProductsBookingHandler(options) {
                 organizationId: extractOrganizationId(request.party),
                 internalNotes: extractInternalNotes(request.party),
                 travelers: travelers.length > 0 ? travelers : undefined,
+                sellAmountCentsOverride,
                 taxLines: extractTaxLines(request.pricing),
             });
             if (bridge.status !== "ok" || !bridge.bookingId) {
@@ -406,6 +414,36 @@ function extractTaxLines(pricing) {
     }
     return lines.length ? lines : undefined;
 }
+function resolveSellAmountCentsOverride(pricing) {
+    if (!pricing)
+        return null;
+    const breakdown = pricing.breakdown;
+    if (hasInclusiveTaxLine(breakdown)) {
+        const total = readBreakdownTotal(breakdown);
+        if (total != null)
+            return total;
+    }
+    return pricing.base_amount != null ? Math.round(pricing.base_amount) : null;
+}
+function hasInclusiveTaxLine(breakdown) {
+    if (!breakdown || typeof breakdown !== "object" || Array.isArray(breakdown))
+        return false;
+    const taxes = breakdown.taxes;
+    if (!Array.isArray(taxes))
+        return false;
+    return taxes.some((tax) => {
+        if (!tax || typeof tax !== "object" || Array.isArray(tax))
+            return false;
+        const row = tax;
+        return row.includedInPrice === true || row.scope === "included";
+    });
+}
+function readBreakdownTotal(breakdown) {
+    if (!breakdown || typeof breakdown !== "object" || Array.isArray(breakdown))
+        return null;
+    const total = breakdown.total;
+    return typeof total === "number" && Number.isFinite(total) ? Math.round(total) : null;
+}
 function asFiniteInteger(value) {
     if (typeof value !== "number" || !Number.isFinite(value))
         return null;

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

@@ -0,0 +1,52 @@
+/**
+ * Catalog plane field policy for product → departures denormalization.
+ *
+ * These fields don't live on the `products` table — they're aggregated
+ * from `availability_slots` (filtered to `status = 'open'` and future
+ * `startsAt`) at index time and projected onto the product search
+ * document. See `docs/architecture/catalog-architecture.md` §5.4.
+ *
+ * Storefront product cards filter and display by departure surface:
+ *   - "departing in May" (filter: `departureMonths[]` includes "2026-05")
+ *   - "available this weekend" (filter: `departureDates[]` overlap)
+ *   - "available now" (filter: `hasUpcomingDeparture:true`)
+ *   - sort by next departure (`nextDepartureAt` asc)
+ *   - show capacity badge (`availableUnitsTotal`)
+ *
+ * Wire this policy into the products registry by composing with
+ * `productCatalogPolicy`:
+ *
+ *   const registry = createFieldPolicyRegistry([
+ *     ...productCatalogPolicy,
+ *     ...productDeparturesCatalogPolicy,
+ *   ])
+ *
+ * and wire `createProductDeparturesProjectionExtension` into
+ * `createProductDocumentBuilder` so the values land in the doc.
+ *
+ * Reindex semantics: every aggregation depends on `now()` — the same
+ * product reindexed an hour later will produce slightly different
+ * documents because the future window slides. Operators rely on the
+ * channel-push reconciler + scheduled refresh to keep these fields warm
+ * without storming the indexer on each tick. Per architecture §5.4,
+ * `reindex: "facet-affecting"` is the right tier — these fields drive
+ * facets but aren't on the merchandisable hot path.
+ *
+ * Out of scope here:
+ *   - Sold-out / cancelled / closed slots. The projection only counts
+ *     `status = 'open'` so storefront filters never surface unavailable
+ *     departures. A "show sold-out" toggle is a query-time concern.
+ *   - Per-option splits. Today's projection rolls up to the product;
+ *     per-option faceting is a follow-up if storefronts need it.
+ *   - Duration buckets (nights/days). Slots carry these but products
+ *     with mixed-duration slots can't be summarized in one number.
+ */
+import { type FieldPolicyInput } from "@voyantjs/catalog/contract";
+declare const PRODUCT_DEPARTURES_FIELD_POLICY: FieldPolicyInput[];
+/**
+ * Resolved departures policy. Compose with `productCatalogPolicy` when
+ * building the products registry.
+ */
+export declare const productDeparturesCatalogPolicy: import("@voyantjs/catalog").FieldPolicy[];
+export { PRODUCT_DEPARTURES_FIELD_POLICY };
+//# sourceMappingURL=catalog-policy-departures.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-policy-departures.d.ts","sourceRoot":"","sources":["../src/catalog-policy-departures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAErF,QAAA,MAAM,+BAA+B,EAAE,gBAAgB,EAyHtD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,8BAA8B,2CAAqD,CAAA;AAEhG,OAAO,EAAE,+BAA+B,EAAE,CAAA"}

package/dist/catalog-policy-departures.js

@@ -0,0 +1,169 @@
+/**
+ * Catalog plane field policy for product → departures denormalization.
+ *
+ * These fields don't live on the `products` table — they're aggregated
+ * from `availability_slots` (filtered to `status = 'open'` and future
+ * `startsAt`) at index time and projected onto the product search
+ * document. See `docs/architecture/catalog-architecture.md` §5.4.
+ *
+ * Storefront product cards filter and display by departure surface:
+ *   - "departing in May" (filter: `departureMonths[]` includes "2026-05")
+ *   - "available this weekend" (filter: `departureDates[]` overlap)
+ *   - "available now" (filter: `hasUpcomingDeparture:true`)
+ *   - sort by next departure (`nextDepartureAt` asc)
+ *   - show capacity badge (`availableUnitsTotal`)
+ *
+ * Wire this policy into the products registry by composing with
+ * `productCatalogPolicy`:
+ *
+ *   const registry = createFieldPolicyRegistry([
+ *     ...productCatalogPolicy,
+ *     ...productDeparturesCatalogPolicy,
+ *   ])
+ *
+ * and wire `createProductDeparturesProjectionExtension` into
+ * `createProductDocumentBuilder` so the values land in the doc.
+ *
+ * Reindex semantics: every aggregation depends on `now()` — the same
+ * product reindexed an hour later will produce slightly different
+ * documents because the future window slides. Operators rely on the
+ * channel-push reconciler + scheduled refresh to keep these fields warm
+ * without storming the indexer on each tick. Per architecture §5.4,
+ * `reindex: "facet-affecting"` is the right tier — these fields drive
+ * facets but aren't on the merchandisable hot path.
+ *
+ * Out of scope here:
+ *   - Sold-out / cancelled / closed slots. The projection only counts
+ *     `status = 'open'` so storefront filters never surface unavailable
+ *     departures. A "show sold-out" toggle is a query-time concern.
+ *   - Per-option splits. Today's projection rolls up to the product;
+ *     per-option faceting is a follow-up if storefronts need it.
+ *   - Duration buckets (nights/days). Slots carry these but products
+ *     with mixed-duration slots can't be summarized in one number.
+ */
+import { defineFieldPolicy } from "@voyantjs/catalog/contract";
+const PRODUCT_DEPARTURES_FIELD_POLICY = [
+    // ── Earliest open future departure ──────────────────────────────────────
+    // `nextDepartureAt` is the timestamptz for sort order (catalog sort by
+    // soonest available). `nextDepartureDate` is the same departure expressed
+    // as the slot's local calendar date — what the storefront card renders.
+    {
+        path: "nextDepartureAt",
+        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: "nextDepartureDate",
+        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 + count facets ─────────────────────────────────────────────
+    // `hasUpcomingDeparture` is the cheap "available now" filter. The count
+    // lets storefront sort by "lots of options available" without exposing
+    // the date list to the query layer.
+    {
+        path: "hasUpcomingDeparture",
+        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: "upcomingDepartureCount",
+        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",
+    },
+    // ── Calendar-bucket facets ──────────────────────────────────────────────
+    // `departureDates[]` powers fine-grained "this weekend" / "next week"
+    // filters; capped at 180 days of distinct calendar dates so document
+    // size stays bounded for daily-slot products. `departureMonths[]` is
+    // the longer-tail facet — 24 months of "YYYY-MM" tokens covers an
+    // operator's typical forward-published inventory horizon.
+    {
+        path: "departureDates[]",
+        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: "departureMonths[]",
+        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",
+    },
+    // ── Capacity ────────────────────────────────────────────────────────────
+    // Sum of `remaining_pax` across upcoming open slots. `null` when ANY
+    // counted slot is unlimited — unbounded capacity can't be summarized in
+    // a number, and emitting a partial sum would mislead the storefront
+    // ("3 seats left" when one slot is actually unlimited).
+    {
+        path: "availableUnitsTotal",
+        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 departures policy. Compose with `productCatalogPolicy` when
+ * building the products registry.
+ */
+export const productDeparturesCatalogPolicy = defineFieldPolicy(PRODUCT_DEPARTURES_FIELD_POLICY);
+export { PRODUCT_DEPARTURES_FIELD_POLICY };

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

@@ -0,0 +1,41 @@
+/**
+ * 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")
+ *
+ * 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.
+ *
+ * Out of scope here:
+ *   - Coordinates / geopoints. The `destinations` table has no coordinate
+ *     columns; product geolocation lives on `product_locations` and will
+ *     ship as its own policy in a follow-up PR.
+ *   - 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 "@voyantjs/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("@voyantjs/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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAErF,QAAA,MAAM,iCAAiC,EAAE,gBAAgB,EAmFxD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gCAAgC,2CAAuD,CAAA;AAEpG,OAAO,EAAE,iCAAiC,EAAE,CAAA"}

package/dist/catalog-policy-destinations.js

@@ -0,0 +1,121 @@
+/**
+ * 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")
+ *
+ * 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.
+ *
+ * Out of scope here:
+ *   - Coordinates / geopoints. The `destinations` table has no coordinate
+ *     columns; product geolocation lives on `product_locations` and will
+ *     ship as its own policy in a follow-up PR.
+ *   - Slug fields per locale. Destinations have one canonical slug today;
+ *     locale-specific slugs are a follow-up if marketing needs them.
+ */
+import { defineFieldPolicy } from "@voyantjs/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",
+    },
+    // ── 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",
+    },
+];
+/**
+ * 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 configured
+ * default-rule 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
+ * `@voyantjs/pricing/service-catalog-plane-pricing`) 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 and put the real prices on options —
+ * this projection MINs across both, giving storefront a value that's
+ * always meaningful even for the option-driven case.
+ *
+ * Out of scope here (deferred):
+ *   - Schedule-aware rule resolution. The kernel reads `isDefault=true`
+ *     rule prices only — it does NOT walk seasonal schedules, per-
+ *     departure overrides, or per-unit occupancy tiers. A "true cheapest
+ *     bookable price right now" projection requires per-slice rule
+ *     evaluation with a moving "now" date and is a follow-up.
+ *   - 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 "@voyantjs/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("@voyantjs/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,4BAA4B,CAAA;AAErF,QAAA,MAAM,4BAA4B,EAAE,gBAAgB,EAuDnD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,2CAAkD,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 configured
+ * default-rule 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
+ * `@voyantjs/pricing/service-catalog-plane-pricing`) 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 and put the real prices on options —
+ * this projection MINs across both, giving storefront a value that's
+ * always meaningful even for the option-driven case.
+ *
+ * Out of scope here (deferred):
+ *   - Schedule-aware rule resolution. The kernel reads `isDefault=true`
+ *     rule prices only — it does NOT walk seasonal schedules, per-
+ *     departure overrides, or per-unit occupancy tiers. A "true cheapest
+ *     bookable price right now" projection requires per-slice rule
+ *     evaluation with a moving "now" date and is a follow-up.
+ *   - 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 "@voyantjs/catalog/contract";
+const PRODUCT_PRICING_FIELD_POLICY = [
+    // ── Aggregated "price from" amount ───────────────────────────────────────
+    // MIN across `products.sellAmountCents` and the active default
+    // `optionPriceRules.baseSellAmountCents` (plus option-unit-rule MINs for
+    // per-unit-priced options). `null` when no source has a non-null 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 the product row nor any active default rule has a
+    // configured price. 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 };