@voyant-travel/storefront 0.120.1

package/dist/service-departures-offers.d.ts

@@ -0,0 +1,220 @@
+import type { StorefrontOfferMutationResult, StorefrontPromotionalOffer } from "./validation.js";
+export interface StorefrontDeparturePricePreviewOfferResolvers {
+    listApplicableOffers?: (input: {
+        productId: string;
+        departureId?: string;
+        locale?: string;
+    }) => Promise<StorefrontPromotionalOffer[]> | StorefrontPromotionalOffer[];
+    applyOffer?: (input: {
+        slug: string;
+        body: {
+            productId: string;
+            departureId?: string | null;
+            pax: number;
+            audience: "customer";
+            market: string;
+            basePriceCents: number;
+            currency: string;
+            locale?: string;
+        };
+    }) => Promise<StorefrontOfferMutationResult | null> | StorefrontOfferMutationResult | null;
+    redeemOffer?: (input: {
+        body: {
+            code: string;
+            productId: string;
+            departureId?: string | null;
+            pax: number;
+            audience: "customer";
+            market: string;
+            basePriceCents: number;
+            currency: string;
+            locale?: string;
+        };
+    }) => Promise<StorefrontOfferMutationResult | null> | StorefrontOfferMutationResult | null;
+}
+export declare function buildOfferPreview(input: {
+    resolvers?: StorefrontDeparturePricePreviewOfferResolvers;
+    productId: string;
+    departureId: string;
+    basePriceCents: number;
+    currencyCode: string;
+    paxTotal: number;
+    requestedOffers: Array<{
+        slug: string;
+    }>;
+    offerCode?: string | null;
+    locale?: string;
+    market: string;
+}): Promise<{
+    available: {
+        offer: {
+            id: string;
+            name: string;
+            slug: string | null;
+            description: string | null;
+            discountType: "percentage" | "fixed_amount";
+            discountValue: string;
+            currency: string | null;
+            applicableProductIds: string[];
+            applicableDepartureIds: string[];
+            validFrom: string | null;
+            validTo: string | null;
+            minTravelers: number | null;
+            imageMobileUrl: string | null;
+            imageDesktopUrl: string | null;
+            stackable: boolean;
+            createdAt: string;
+            updatedAt: string;
+        };
+        status: string;
+        reason: string | null;
+        selected: boolean;
+        discountAppliedCents: number;
+        discountedPriceCents: number;
+    }[];
+    requested: ({
+        kind: "slug";
+        value: string;
+        result: {
+            status: "applied" | "not_applicable" | "invalid" | "conflict";
+            reason: "currency" | "scope" | "booking_mismatch" | "conflict" | "offer_not_found" | "offer_expired" | "offer_not_yet_valid" | "code_not_found" | "code_required" | "code_expired" | "code_not_yet_valid" | "min_pax" | "eligibility" | "no_discount" | "session_mismatch" | null;
+            offer: {
+                id: string;
+                name: string;
+                slug: string | null;
+                description: string | null;
+                discountType: "percentage" | "fixed_amount";
+                discountValue: string;
+                currency: string | null;
+                applicableProductIds: string[];
+                applicableDepartureIds: string[];
+                validFrom: string | null;
+                validTo: string | null;
+                minTravelers: number | null;
+                imageMobileUrl: string | null;
+                imageDesktopUrl: string | null;
+                stackable: boolean;
+                createdAt: string;
+                updatedAt: string;
+            } | null;
+            target: {
+                bookingId: string | null;
+                sessionId: string | null;
+                productId: string;
+                departureId: string | null;
+            };
+            pricing: {
+                basePriceCents: number;
+                currency: string;
+                discountAppliedCents: number;
+                discountedPriceCents: number;
+            };
+            appliedOffers: {
+                offerId: string;
+                offerName: string;
+                discountAppliedCents: number;
+                discountedPriceCents: number;
+                currency: string;
+                discountKind: "percentage" | "fixed_amount";
+                discountPercent: number | null;
+                discountAmountCents: number | null;
+                appliedCode: string | null;
+                stackable: boolean;
+            }[];
+            conflict: {
+                policy: "best_discount_wins" | "stackable_compose";
+                autoAppliedOfferIds: string[];
+                manualOfferId: string | null;
+                selectedOfferIds: string[];
+                message: string;
+            } | null;
+        } | null;
+    } | {
+        kind: "code";
+        value: string;
+        result: {
+            status: "applied" | "not_applicable" | "invalid" | "conflict";
+            reason: "currency" | "scope" | "booking_mismatch" | "conflict" | "offer_not_found" | "offer_expired" | "offer_not_yet_valid" | "code_not_found" | "code_required" | "code_expired" | "code_not_yet_valid" | "min_pax" | "eligibility" | "no_discount" | "session_mismatch" | null;
+            offer: {
+                id: string;
+                name: string;
+                slug: string | null;
+                description: string | null;
+                discountType: "percentage" | "fixed_amount";
+                discountValue: string;
+                currency: string | null;
+                applicableProductIds: string[];
+                applicableDepartureIds: string[];
+                validFrom: string | null;
+                validTo: string | null;
+                minTravelers: number | null;
+                imageMobileUrl: string | null;
+                imageDesktopUrl: string | null;
+                stackable: boolean;
+                createdAt: string;
+                updatedAt: string;
+            } | null;
+            target: {
+                bookingId: string | null;
+                sessionId: string | null;
+                productId: string;
+                departureId: string | null;
+            };
+            pricing: {
+                basePriceCents: number;
+                currency: string;
+                discountAppliedCents: number;
+                discountedPriceCents: number;
+            };
+            appliedOffers: {
+                offerId: string;
+                offerName: string;
+                discountAppliedCents: number;
+                discountedPriceCents: number;
+                currency: string;
+                discountKind: "percentage" | "fixed_amount";
+                discountPercent: number | null;
+                discountAmountCents: number | null;
+                appliedCode: string | null;
+                stackable: boolean;
+            }[];
+            conflict: {
+                policy: "best_discount_wins" | "stackable_compose";
+                autoAppliedOfferIds: string[];
+                manualOfferId: string | null;
+                selectedOfferIds: string[];
+                message: string;
+            } | null;
+        } | null;
+    })[];
+    applied: {
+        offerId: string;
+        offerName: string;
+        discountAppliedCents: number;
+        discountedPriceCents: number;
+        currency: string;
+        discountKind: "percentage" | "fixed_amount";
+        discountPercent: number | null;
+        discountAmountCents: number | null;
+        appliedCode: string | null;
+        stackable: boolean;
+    }[];
+    conflict: {
+        policy: "best_discount_wins" | "stackable_compose";
+        autoAppliedOfferIds: string[];
+        manualOfferId: string | null;
+        selectedOfferIds: string[];
+        message: string;
+    } | {
+        policy: string;
+        autoAppliedOfferIds: string[];
+        manualOfferId: null;
+        selectedOfferIds: string[];
+        message: string;
+    } | null;
+    discountTotal: number;
+    discountTotalCents: number;
+    totalAfterDiscount: number;
+    currencyCode: string;
+}>;
+//# sourceMappingURL=service-departures-offers.d.ts.map

package/dist/service-departures-offers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-departures-offers.d.ts","sourceRoot":"","sources":["../src/service-departures-offers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,6BAA6B,EAC7B,0BAA0B,EAC3B,MAAM,iBAAiB,CAAA;AAExB,MAAM,WAAW,6CAA6C;IAC5D,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC7B,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,KAAK,OAAO,CAAC,0BAA0B,EAAE,CAAC,GAAG,0BAA0B,EAAE,CAAA;IAC1E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QACnB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE;YACJ,SAAS,EAAE,MAAM,CAAA;YACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;YAC3B,GAAG,EAAE,MAAM,CAAA;YACX,QAAQ,EAAE,UAAU,CAAA;YACpB,MAAM,EAAE,MAAM,CAAA;YACd,cAAc,EAAE,MAAM,CAAA;YACtB,QAAQ,EAAE,MAAM,CAAA;YAChB,MAAM,CAAC,EAAE,MAAM,CAAA;SAChB,CAAA;KACF,KAAK,OAAO,CAAC,6BAA6B,GAAG,IAAI,CAAC,GAAG,6BAA6B,GAAG,IAAI,CAAA;IAC1F,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE;QACpB,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAA;YACZ,SAAS,EAAE,MAAM,CAAA;YACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;YAC3B,GAAG,EAAE,MAAM,CAAA;YACX,QAAQ,EAAE,UAAU,CAAA;YACpB,MAAM,EAAE,MAAM,CAAA;YACd,cAAc,EAAE,MAAM,CAAA;YACtB,QAAQ,EAAE,MAAM,CAAA;YAChB,MAAM,CAAC,EAAE,MAAM,CAAA;SAChB,CAAA;KACF,KAAK,OAAO,CAAC,6BAA6B,GAAG,IAAI,CAAC,GAAG,6BAA6B,GAAG,IAAI,CAAA;CAC3F;AAwJD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,SAAS,CAAC,EAAE,6CAA6C,CAAA;IACzD,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EA"}

package/dist/service-departures-offers.js

@@ -0,0 +1,177 @@
+import { centsToAmount } from "./service-departures-pricing-context.js";
+function computeOfferDiscountCents(offer, basePriceCents) {
+    if (basePriceCents <= 0)
+        return 0;
+    if (offer.discountType === "percentage") {
+        const percent = Number(offer.discountValue);
+        return Number.isFinite(percent) ? Math.round((basePriceCents * percent) / 100) : 0;
+    }
+    const discountCents = Number.parseInt(offer.discountValue, 10);
+    return Number.isFinite(discountCents) ? Math.min(discountCents, basePriceCents) : 0;
+}
+function buildAppliedOfferFromDto(input) {
+    const discountPercent = input.offer.discountType === "percentage" ? Number(input.offer.discountValue) : null;
+    const discountAmountCents = input.offer.discountType === "fixed_amount"
+        ? Number.parseInt(input.offer.discountValue, 10)
+        : null;
+    return {
+        offerId: input.offer.id,
+        offerName: input.offer.name,
+        discountAppliedCents: input.discountAppliedCents,
+        discountedPriceCents: Math.max(0, input.basePriceCents - input.discountAppliedCents),
+        currency: input.currencyCode,
+        discountKind: input.offer.discountType,
+        discountPercent: Number.isFinite(discountPercent) ? discountPercent : null,
+        discountAmountCents: Number.isFinite(discountAmountCents) ? discountAmountCents : null,
+        appliedCode: null,
+        stackable: input.offer.stackable,
+    };
+}
+function evaluateAvailableOfferImpacts(input) {
+    const candidates = input.offers.map((offer) => {
+        const standaloneDiscount = computeOfferDiscountCents(offer, input.basePriceCents);
+        const reason = offer.minTravelers != null && input.paxTotal < offer.minTravelers
+            ? "min_pax"
+            : offer.discountType === "fixed_amount" && offer.currency !== input.currencyCode
+                ? "currency"
+                : standaloneDiscount <= 0
+                    ? "no_discount"
+                    : null;
+        return { offer, standaloneDiscount, reason };
+    });
+    const applicable = candidates.filter((candidate) => candidate.reason == null);
+    const stackable = applicable
+        .filter((candidate) => candidate.offer.stackable)
+        .sort((a, b) => (a.offer.id < b.offer.id ? -1 : a.offer.id > b.offer.id ? 1 : 0));
+    const nonStackable = applicable.filter((candidate) => !candidate.offer.stackable);
+    let bestNonStackable = null;
+    for (const candidate of nonStackable) {
+        if (bestNonStackable == null ||
+            candidate.standaloneDiscount > bestNonStackable.standaloneDiscount) {
+            bestNonStackable = candidate;
+        }
+    }
+    let runningBase = input.basePriceCents;
+    const selectedStackable = stackable
+        .map((candidate) => {
+        const discount = computeOfferDiscountCents(candidate.offer, runningBase);
+        runningBase = Math.max(0, runningBase - discount);
+        return { ...candidate, selectedDiscount: discount };
+    })
+        .filter((candidate) => candidate.selectedDiscount > 0);
+    const stackableDiscount = input.basePriceCents - runningBase;
+    const selected = bestNonStackable && bestNonStackable.standaloneDiscount >= stackableDiscount
+        ? [{ ...bestNonStackable, selectedDiscount: bestNonStackable.standaloneDiscount }]
+        : selectedStackable;
+    const selectedByOfferId = new Map(selected.map((candidate) => [candidate.offer.id, candidate]));
+    const applied = selected.map((candidate) => buildAppliedOfferFromDto({
+        offer: candidate.offer,
+        discountAppliedCents: candidate.selectedDiscount,
+        basePriceCents: input.basePriceCents,
+        currencyCode: input.currencyCode,
+    }));
+    const discountTotalCents = applied.reduce((sum, offer) => sum + offer.discountAppliedCents, 0);
+    const eligibleButNotSelected = applicable.filter((candidate) => !selectedByOfferId.has(candidate.offer.id));
+    const conflict = eligibleButNotSelected.length > 0
+        ? {
+            policy: selected.every((candidate) => candidate.offer.stackable)
+                ? "stackable_compose"
+                : "best_discount_wins",
+            autoAppliedOfferIds: selected
+                .filter((candidate) => candidate.offer.slug == null)
+                .map((candidate) => candidate.offer.id),
+            manualOfferId: null,
+            selectedOfferIds: selected.map((candidate) => candidate.offer.id),
+            message: selected.every((candidate) => candidate.offer.stackable)
+                ? "Stackable offers compose when they beat the best standalone discount."
+                : "The best discount wins when non-stackable offers compete.",
+        }
+        : null;
+    return {
+        available: candidates.map((candidate) => {
+            const selectedCandidate = selectedByOfferId.get(candidate.offer.id);
+            const selectedDiscount = selectedCandidate?.selectedDiscount ?? 0;
+            const conflictReason = candidate.reason == null && !selectedCandidate && selected.length > 0 ? "conflict" : null;
+            const discountAppliedCents = selectedCandidate?.selectedDiscount ?? candidate.standaloneDiscount;
+            return {
+                offer: candidate.offer,
+                status: selectedCandidate ? "applied" : conflictReason ? "conflict" : "not_applicable",
+                reason: candidate.reason ?? conflictReason,
+                selected: Boolean(selectedCandidate),
+                discountAppliedCents,
+                discountedPriceCents: Math.max(0, input.basePriceCents -
+                    (selectedCandidate ? selectedDiscount : candidate.standaloneDiscount)),
+            };
+        }),
+        applied,
+        conflict,
+        discountTotalCents,
+    };
+}
+export async function buildOfferPreview(input) {
+    const availableOffers = (await input.resolvers?.listApplicableOffers?.({
+        productId: input.productId,
+        departureId: input.departureId,
+        locale: input.locale,
+    })) ?? [];
+    const autoPreview = evaluateAvailableOfferImpacts({
+        offers: availableOffers,
+        basePriceCents: input.basePriceCents,
+        currencyCode: input.currencyCode,
+        paxTotal: input.paxTotal,
+    });
+    const target = {
+        productId: input.productId,
+        departureId: input.departureId,
+        pax: input.paxTotal,
+        audience: "customer",
+        market: input.market,
+        basePriceCents: input.basePriceCents,
+        currency: input.currencyCode,
+        ...(input.locale ? { locale: input.locale } : {}),
+    };
+    const requested = [];
+    for (const offer of input.requestedOffers) {
+        requested.push({
+            kind: "slug",
+            value: offer.slug,
+            result: (await input.resolvers?.applyOffer?.({
+                slug: offer.slug,
+                body: target,
+            })) ?? null,
+        });
+    }
+    if (input.offerCode) {
+        requested.push({
+            kind: "code",
+            value: input.offerCode,
+            result: (await input.resolvers?.redeemOffer?.({
+                body: { ...target, code: input.offerCode },
+            })) ?? null,
+        });
+    }
+    const bestRequested = requested
+        .map((entry) => entry.result)
+        .filter((result) => Boolean(result))
+        .filter((result) => result.status === "applied" || result.status === "conflict")
+        .sort((a, b) => b.pricing.discountAppliedCents - a.pricing.discountAppliedCents)[0];
+    const applied = bestRequested && bestRequested.pricing.discountAppliedCents > autoPreview.discountTotalCents
+        ? bestRequested.appliedOffers
+        : autoPreview.applied;
+    const conflict = bestRequested && bestRequested.pricing.discountAppliedCents > autoPreview.discountTotalCents
+        ? bestRequested.conflict
+        : autoPreview.conflict;
+    const discountTotalCents = bestRequested && bestRequested.pricing.discountAppliedCents > autoPreview.discountTotalCents
+        ? bestRequested.pricing.discountAppliedCents
+        : autoPreview.discountTotalCents;
+    return {
+        available: autoPreview.available,
+        requested,
+        applied,
+        conflict,
+        discountTotal: centsToAmount(discountTotalCents) ?? 0,
+        discountTotalCents,
+        totalAfterDiscount: centsToAmount(Math.max(0, input.basePriceCents - discountTotalCents)) ?? 0,
+        currencyCode: input.currencyCode,
+    };
+}