@voyantjs/products 0.27.0 → 0.28.0

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

@@ -96,6 +96,25 @@ export interface BuildOwnedProductDraftShapeOptions {
     addonCatalog?: ReadonlyArray<AddonOffer>;
 }
 export declare function buildOwnedProductDraftShape(options?: BuildOwnedProductDraftShapeOptions): BookingDraftShape;
+/** A per-unit price within a resolved option price rule, returned by
+ *  `loadResolvedOptionPrice`. The handler matches `travelerCategory`
+ *  to the draft's pax-band codes ("adult" / "child" / "infant" /
+ *  "senior") to compute per-band totals. Units that don't map to a
+ *  band — or whose band has zero count — are dropped. */
+export interface ResolvedUnitPrice {
+    unitId: string;
+    unitType: "person" | "room" | "vehicle" | "service" | "group" | "other" | string;
+    travelerCategory: "adult" | "child" | "infant" | "senior" | null;
+    sellAmountCents: number | null;
+}
+/** Output of `loadResolvedOptionPrice`. The handler prefers
+ *  `unitPrices` (per-band pricing) when present and any unit matches a
+ *  pax band; otherwise falls back to `baseSellAmountCents × paxCount`
+ *  for per-booking rules; otherwise back to `product.sellAmountCents`. */
+export interface ResolvedOptionPrice {
+    baseSellAmountCents: number | null;
+    unitPrices: ReadonlyArray<ResolvedUnitPrice>;
+}
 /** A resolved tax-rate decision — resolved from `tax_classes` ×
  *  `tax_regimes` × buyer country at quote time. */
 export interface ResolvedTaxRate {
@@ -139,6 +158,33 @@ export interface OwnedProductsShapeLoaders {
         buyerCountry?: string;
         buyerType?: "B2C" | "B2B";
     }) => Promise<ResolvedTaxRate | null>;
+    /**
+     * Resolve the option price rule for a given (product, option, date)
+     * — typically backed by `@voyantjs/pricing`'s
+     * `resolveOptionPriceRulesForDate` plus a join into per-unit prices.
+     * Returns null when no rule applies or the resolver can't run; the
+     * handler then falls back to `product.sellAmountCents × pax`.
+     *
+     * Caller-supplied so `@voyantjs/products` does not import
+     * `@voyantjs/pricing` (the dependency direction is pricing →
+     * products, not the reverse).
+     */
+    loadResolvedOptionPrice?: (ctx: OwnedHandlerContext, args: {
+        productId: string;
+        optionId: string;
+        /** ISO yyyy-mm-dd in the slot's local timezone. */
+        date: string;
+        catalogId?: string;
+    }) => Promise<ResolvedOptionPrice | null>;
+    /**
+     * Look up the local date of a departure slot (`availability_slots`).
+     * Caller-supplied so the products package does not import
+     * `@voyantjs/availability`. Returns null when the slot is missing.
+     *
+     * Used together with `loadResolvedOptionPrice` to convert a draft's
+     * `departureSlotId` into a date the resolver can match against.
+     */
+    loadSlotDate?: (ctx: OwnedHandlerContext, slotId: string) => Promise<string | null>;
 }
 /**
  * Caller-supplied availability-hold bridge — keeps the products

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

@@ -60,9 +60,12 @@ export function createProductsBookingHandler(options) {
                 };
             }
             const draft = (request.draft ?? {});
-            // Concurrent enrichment — all three calls are pure reads and
-            // don't depend on each other.
-            const [travelerFields, addonCatalog, taxRate] = await Promise.all([
+            const optionId = draft.configure?.variantId;
+            const slotId = draft.configure?.departureSlotId;
+            // Concurrent enrichment + slot-date lookup. The slot date is
+            // needed before we can call loadResolvedOptionPrice, so it
+            // joins this batch.
+            const [travelerFields, addonCatalog, taxRate, slotDate] = await Promise.all([
                 options.loadTravelerFields?.(ctx, request.entityId) ?? Promise.resolve(undefined),
                 options.loadAddonCatalog?.(ctx, request.entityId) ?? Promise.resolve(undefined),
                 options.loadTaxRate?.(ctx, {
@@ -70,19 +73,34 @@ export function createProductsBookingHandler(options) {
                     buyerCountry: draft.billing?.address?.country,
                     buyerType: draft.billing?.buyerType,
                 }) ?? Promise.resolve(null),
+                slotId && options.loadSlotDate
+                    ? options.loadSlotDate(ctx, slotId)
+                    : Promise.resolve(draft.configure?.departureDate ?? null),
             ]);
+            const resolvedPrice = optionId && slotDate && options.loadResolvedOptionPrice
+                ? await options.loadResolvedOptionPrice(ctx, {
+                    productId: request.entityId,
+                    optionId,
+                    date: slotDate,
+                })
+                : null;
             const paxCount = sumPax(draft.configure?.pax);
             // Per-pax pricing fallback: when no pax is supplied yet, quote a
             // single-occupant baseline so the wizard can render a starter
             // total before the user picks counts.
             const effectivePax = paxCount > 0 ? paxCount : 1;
-            const unitCents = product.sellAmountCents ?? 0;
-            const grossCents = unitCents * effectivePax;
+            const priced = priceQuote({
+                product,
+                resolvedPrice,
+                pax: draft.configure?.pax,
+                effectivePax,
+            });
             // Tax computation. The base is taxable; addons/accommodation
             // get the same rate in this MVP cut. Per-line override (the
             // `applies_to` axis on tax_classes.lines) lands in a follow-up
             // when the catalog actually carries mixed treatments.
             const taxIsInclusive = taxRate?.priceMode === "inclusive";
+            const grossCents = priced.totalCents;
             const taxCents = taxRate && taxRate.rate > 0
                 ? taxIsInclusive
                     ? Math.round(grossCents - grossCents / (1 + taxRate.rate))
@@ -90,7 +108,8 @@ export function createProductsBookingHandler(options) {
                 : 0;
             const netCents = taxIsInclusive ? grossCents - taxCents : grossCents;
             const payableCents = taxIsInclusive ? grossCents : netCents + taxCents;
-            const pricing = unitCents > 0
+            const available = grossCents > 0;
+            const pricing = available
                 ? {
                     base_amount: netCents,
                     taxes: taxCents,
@@ -98,16 +117,10 @@ export function createProductsBookingHandler(options) {
                     surcharges: 0,
                     currency: product.sellCurrency,
                     breakdown: {
-                        lines: [
-                            {
-                                kind: "base",
-                                label: product.name,
-                                quantity: effectivePax,
-                                unitAmount: unitCents,
-                                totalAmount: grossCents,
-                                taxIncluded: taxIsInclusive,
-                            },
-                        ],
+                        lines: priced.lines.map((line) => ({
+                            ...line,
+                            taxIncluded: taxIsInclusive,
+                        })),
                         taxes: taxRate && taxCents > 0
                             ? [
                                 {
@@ -129,8 +142,8 @@ export function createProductsBookingHandler(options) {
                 }
                 : undefined;
             return {
-                available: unitCents > 0,
-                invalidReason: unitCents > 0 ? undefined : "no_sell_amount_configured",
+                available,
+                invalidReason: available ? undefined : "no_sell_amount_configured",
                 pricing,
                 shape: buildOwnedProductDraftShape({
                     travelerFields,
@@ -267,6 +280,80 @@ function sumPax(pax) {
     }
     return total;
 }
+/**
+ * Three-way price computation:
+ *
+ * 1. **Per-band** (preferred): when `resolvedPrice.unitPrices` matches
+ *    at least one band with positive count, sum `pax[band] ×
+ *    unit.sellAmountCents` for each matching band. One breakdown line
+ *    per band.
+ *
+ * 2. **Per-booking**: when no per-band match but `baseSellAmountCents`
+ *    is set, charge a single `base × paxCount` line.
+ *
+ * 3. **Fallback**: `product.sellAmountCents × paxCount`. Same shape as
+ *    Phase A behavior, kept for bookings without an option/slot
+ *    configured yet.
+ */
+function priceQuote(input) {
+    const { product, resolvedPrice, pax, effectivePax } = input;
+    if (resolvedPrice && resolvedPrice.unitPrices.length > 0) {
+        const bandLines = [];
+        let total = 0;
+        for (const unit of resolvedPrice.unitPrices) {
+            if (!unit.travelerCategory)
+                continue;
+            const count = pax?.[unit.travelerCategory] ?? 0;
+            if (count <= 0)
+                continue;
+            const sell = unit.sellAmountCents ?? 0;
+            if (sell <= 0)
+                continue;
+            const lineTotal = sell * count;
+            total += lineTotal;
+            bandLines.push({
+                kind: "base",
+                label: `${product.name} — ${unit.travelerCategory}`,
+                quantity: count,
+                unitAmount: sell,
+                totalAmount: lineTotal,
+            });
+        }
+        if (bandLines.length > 0) {
+            return { totalCents: total, lines: bandLines };
+        }
+    }
+    if (resolvedPrice && resolvedPrice.baseSellAmountCents !== null) {
+        const unitCents = resolvedPrice.baseSellAmountCents;
+        const totalCents = unitCents * effectivePax;
+        return {
+            totalCents,
+            lines: [
+                {
+                    kind: "base",
+                    label: product.name,
+                    quantity: effectivePax,
+                    unitAmount: unitCents,
+                    totalAmount: totalCents,
+                },
+            ],
+        };
+    }
+    const unitCents = product.sellAmountCents ?? 0;
+    const totalCents = unitCents * effectivePax;
+    return {
+        totalCents,
+        lines: [
+            {
+                kind: "base",
+                label: product.name,
+                quantity: effectivePax,
+                unitAmount: unitCents,
+                totalAmount: totalCents,
+            },
+        ],
+    };
+}
 function extractPersonId(party) {
     if (!party)
         return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/products",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -55,12 +55,12 @@
     "hono": "^4.12.10",
     "pdf-lib": "^1.17.1",
     "zod": "^4.3.6",
-    "@voyantjs/core": "0.27.0",
-    "@voyantjs/db": "0.27.0",
-    "@voyantjs/hono": "0.27.0",
-    "@voyantjs/utils": "0.27.0",
-    "@voyantjs/catalog": "0.27.0",
-    "@voyantjs/storage": "0.27.0"
+    "@voyantjs/core": "0.28.0",
+    "@voyantjs/db": "0.28.0",
+    "@voyantjs/hono": "0.28.0",
+    "@voyantjs/utils": "0.28.0",
+    "@voyantjs/catalog": "0.28.0",
+    "@voyantjs/storage": "0.28.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",