@bash-app/bash-common 30.236.0 → 30.237.0

package/dist/utils/service/unifiedPricingResolver.js

@@ -0,0 +1,75 @@
+const EMPTY = {
+    pricingModel: null,
+    baseRateCents: null,
+    baseRateBashPoints: null,
+    rateUnit: null,
+    minimumChargeCents: null,
+    minimumQuantity: null,
+    tierPricing: null,
+    pricingNotes: null,
+    fromUnifiedBlock: false,
+    noRateConfigured: true,
+};
+function hasUnifiedSignal(b) {
+    if (!b)
+        return false;
+    return (b.pricingModel != null ||
+        b.baseRateCents != null ||
+        b.baseRateBashPoints != null ||
+        b.minimumChargeCents != null ||
+        b.minimumQuantity != null);
+}
+/**
+ * Walk the candidate subtypes in order, returning the first one that has
+ * unified pricing populated. Falls back to legacy `ServiceRate` if nothing
+ * has been migrated yet.
+ */
+export function resolveUnifiedPricingBlock(c) {
+    const candidates = [
+        c.eventService,
+        c.vendor,
+        c.exhibitor,
+        c.sponsor,
+        c.venue,
+        c.entertainmentService,
+        c.volunteerService,
+    ];
+    for (const cand of candidates) {
+        if (hasUnifiedSignal(cand)) {
+            const b = cand;
+            const baseRateCents = b.baseRateCents ?? null;
+            return {
+                pricingModel: b.pricingModel ?? null,
+                baseRateCents,
+                baseRateBashPoints: b.baseRateBashPoints ?? null,
+                rateUnit: b.rateUnit ?? null,
+                minimumChargeCents: b.minimumChargeCents ?? null,
+                minimumQuantity: b.minimumQuantity ?? null,
+                tierPricing: b.tierPricing ?? null,
+                pricingNotes: b.pricingNotes ?? null,
+                fromUnifiedBlock: true,
+                noRateConfigured: baseRateCents == null && (b.baseRateBashPoints ?? null) == null,
+            };
+        }
+    }
+    const legacy = c.legacyRate;
+    if (legacy &&
+        (legacy.ratePerUnitCents != null ||
+            legacy.minimumQuantity != null ||
+            legacy.minimumChargeCents != null)) {
+        return {
+            pricingModel: "FLAT_FEE",
+            baseRateCents: legacy.ratePerUnitCents ?? null,
+            baseRateBashPoints: null,
+            rateUnit: legacy.rateUnit ?? null,
+            minimumChargeCents: legacy.minimumChargeCents ?? null,
+            minimumQuantity: legacy.minimumQuantity ?? null,
+            tierPricing: null,
+            pricingNotes: null,
+            fromUnifiedBlock: false,
+            noRateConfigured: legacy.ratePerUnitCents == null,
+        };
+    }
+    return EMPTY;
+}
+//# sourceMappingURL=unifiedPricingResolver.js.map

package/dist/utils/service/unifiedPricingResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unifiedPricingResolver.js","sourceRoot":"","sources":["../../../src/utils/service/unifiedPricingResolver.ts"],"names":[],"mappings":"AAgEA,MAAM,KAAK,GAAwB;IACjC,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,IAAI;IACnB,kBAAkB,EAAE,IAAI;IACxB,QAAQ,EAAE,IAAI;IACd,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE,IAAI;IACjB,YAAY,EAAE,IAAI;IAClB,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,IAAI;CACvB,CAAC;AAEF,SAAS,gBAAgB,CAAC,CAAyC;IACjE,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CACL,CAAC,CAAC,YAAY,IAAI,IAAI;QACtB,CAAC,CAAC,aAAa,IAAI,IAAI;QACvB,CAAC,CAAC,kBAAkB,IAAI,IAAI;QAC5B,CAAC,CAAC,kBAAkB,IAAI,IAAI;QAC5B,CAAC,CAAC,eAAe,IAAI,IAAI,CAC1B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,CAAiC;IAEjC,MAAM,UAAU,GAAkD;QAChE,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,oBAAoB;QACtB,CAAC,CAAC,gBAAgB;KACnB,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,IAAK,CAAC;YAChB,MAAM,aAAa,GAAG,CAAC,CAAC,aAAa,IAAI,IAAI,CAAC;YAC9C,OAAO;gBACL,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,IAAI;gBACpC,aAAa;gBACb,kBAAkB,EAAE,CAAC,CAAC,kBAAkB,IAAI,IAAI;gBAChD,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;gBAC5B,kBAAkB,EAAE,CAAC,CAAC,kBAAkB,IAAI,IAAI;gBAChD,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,IAAI;gBAC1C,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;gBAClC,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,IAAI;gBACpC,gBAAgB,EAAE,IAAI;gBACtB,gBAAgB,EACd,aAAa,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAkB,IAAI,IAAI,CAAC,IAAI,IAAI;aAClE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC;IAC5B,IACE,MAAM;QACN,CAAC,MAAM,CAAC,gBAAgB,IAAI,IAAI;YAC9B,MAAM,CAAC,eAAe,IAAI,IAAI;YAC9B,MAAM,CAAC,kBAAkB,IAAI,IAAI,CAAC,EACpC,CAAC;QACD,OAAO;YACL,YAAY,EAAE,UAA0B;YACxC,aAAa,EAAE,MAAM,CAAC,gBAAgB,IAAI,IAAI;YAC9C,kBAAkB,EAAE,IAAI;YACxB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;YACjC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,IAAI;YACrD,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,IAAI;YAC/C,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,IAAI;YAClB,gBAAgB,EAAE,KAAK;YACvB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,IAAI;SAClD,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/service/venueFBSettlementUtils.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Phase 2 of the unified-pricing roadmap — Venue F&B minimum + revenue-share math.
+ *
+ * Pure functions only (no Prisma / no fetches) so the wizard, api validators,
+ * settlement worker, and offer-suggestion AI can all share one source of truth.
+ *
+ * Concepts:
+ *  - F&B MINIMUM: A venue can require the host's bash to generate at least
+ *    $X in food + beverage spend. If actual spend < minimum, the host owes
+ *    the gap (the "shortfall"). Service charge + tax may or may not count
+ *    toward the minimum, depending on venue config.
+ *  - CARRYOVER CREDIT: If `fbCarryoverEnabled`, excess spend over the minimum
+ *    converts to a credit the host can apply to their next bash at the same
+ *    venue (expires after `fbCarryoverExpiryDays`).
+ *  - REVENUE SHARE: Venue takes a % of ticket revenue. Optional `revenueShareMinimumCents`
+ *    is a floor so the venue is guaranteed at least that much even on slow nights.
+ *
+ * All amounts are integer cents.
+ */
+export interface VenueFBPolicySnapshot {
+    /** Effective minimum in cents (already weekday/weekend/override-resolved). */
+    fbMinimumCents: number;
+    /** True if the stated minimum already bakes in service charge. */
+    fbMinimumIncludesServiceCharge: boolean;
+    /** True if the stated minimum already bakes in tax. */
+    fbMinimumIncludesTax: boolean;
+    /** 0..1 service charge rate (e.g. 0.20 for 20%). Optional. */
+    fbServiceChargeRate?: number | null;
+    /** 0..1 tax rate. Optional. */
+    fbTaxRate?: number | null;
+}
+export interface FBSettlementInput extends VenueFBPolicySnapshot {
+    /**
+     * Raw F&B spend the venue invoiced (pre-service-charge, pre-tax) in cents.
+     * Use the same dollar basis as the minimum's "includes" flags below.
+     */
+    actualFbSpendCents: number;
+    /**
+     * Any existing carryover credits the host has at this venue (sum of
+     * `remainingCents`, expiry-filtered upstream). Optional.
+     */
+    availableCarryoverCents?: number;
+    /**
+     * Whether the venue has carryover credits enabled at all (so excess spend
+     * becomes a credit instead of evaporating).
+     */
+    carryoverEnabled?: boolean;
+}
+export interface FBSettlementResult {
+    /** What the minimum normalizes to on the *actual* spend basis. */
+    normalizedMinimumCents: number;
+    /** Normalized actual spend (after applying svc-charge + tax if missing). */
+    normalizedActualCents: number;
+    /** Raw shortfall before carryover (>=0). */
+    rawShortfallCents: number;
+    /** Carryover credits redeemed against shortfall this settlement. */
+    carryoverAppliedCents: number;
+    /** Final amount the host owes for the F&B gap (after carryover). */
+    shortfallChargedCents: number;
+    /** Excess F&B spend over the minimum, available as new carryover. */
+    carryoverEarnedCents: number;
+    /** True if no shortfall + no excess. */
+    metExactly: boolean;
+}
+/**
+ * Settle an F&B minimum.
+ *
+ * Algorithm:
+ *  1. Normalize both the minimum and the actual spend to the same basis.
+ *     - If the minimum INCLUDES service charge but actual does not, gross up
+ *       the actual by (1 + serviceChargeRate). Same logic for tax.
+ *     - If the minimum EXCLUDES service charge but actual does, strip the
+ *       service charge from the actual figure. Same for tax.
+ *  2. Shortfall = max(0, normalizedMinimum - normalizedActual).
+ *  3. If carryover credits are available, apply them against shortfall.
+ *  4. Excess = max(0, normalizedActual - normalizedMinimum). Becomes new
+ *     carryover credit if `carryoverEnabled`.
+ */
+export declare function settleVenueFBMinimum(input: FBSettlementInput): FBSettlementResult;
+export interface RevenueShareInput {
+    /** Held ticket revenue at settlement, in cents. */
+    heldTicketRevenueCents: number;
+    /** 0..100 percentage the venue gets. */
+    revenueSharePercentage: number;
+    /** Optional floor — venue gets at least this even if the % is lower. */
+    revenueShareMinimumCents?: number | null;
+}
+export interface RevenueShareResult {
+    /** Venue's cut after applying %. */
+    venueCutPctCents: number;
+    /** Final venue cut after applying the floor. */
+    venuePayoutCents: number;
+    /** True if the floor topped up the %. */
+    flooredUp: boolean;
+}
+export declare function settleVenueRevenueShare(input: RevenueShareInput): RevenueShareResult;
+/**
+ * Returns the effective weekday-vs-weekend F&B minimum for a given bash date.
+ * Override windows take precedence; otherwise picks weekday/weekend based on
+ * day-of-week of the bash *start* (Mon=1..Sun=0, in local TZ at the caller's
+ * level — pass `bashStartDay` 0..6 in whatever convention you've already
+ * resolved).
+ */
+export interface ResolveFBMinimumInput {
+    bashStartDay: number;
+    /** Optional date windows that override the weekday/weekend values. */
+    overrides?: ReadonlyArray<{
+        startsAt: Date;
+        endsAt: Date;
+        minimumCents: number;
+    }>;
+    bashStartDate?: Date;
+    fbMinimumWeekdayCents?: number | null;
+    fbMinimumWeekendCents?: number | null;
+}
+export declare function resolveFBMinimumCents(input: ResolveFBMinimumInput): number | null;
+/**
+ * Cancellation-policy copy snippet to surface on offer sheets + booking
+ * detail when a venue booking has an F&B minimum attached.
+ */
+export declare const FB_MINIMUM_CANCELLATION_COPY = "If the bash is canceled within the venue's cancellation window, the host may still owe the F&B minimum shortfall. See the venue's cancellation policy for the exact timing.";
+//# sourceMappingURL=venueFBSettlementUtils.d.ts.map

package/dist/utils/service/venueFBSettlementUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"venueFBSettlementUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/service/venueFBSettlementUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,8BAA8B,EAAE,OAAO,CAAC;IACxC,uDAAuD;IACvD,oBAAoB,EAAE,OAAO,CAAC;IAC9B,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4EAA4E;IAC5E,qBAAqB,EAAE,MAAM,CAAC;IAC9B,4CAA4C;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oEAAoE;IACpE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qEAAqE;IACrE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wCAAwC;IACxC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,iBAAiB,GACvB,kBAAkB,CA4CpB;AAED,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wCAAwC;IACxC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wEAAwE;IACxE,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,GACvB,kBAAkB,CAWpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,SAAS,CAAC,EAAE,aAAa,CAAC;QACxB,QAAQ,EAAE,IAAI,CAAC;QACf,MAAM,EAAE,IAAI,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,qBAAqB,GAC3B,MAAM,GAAG,IAAI,CAkBf;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,gLACsI,CAAC"}

package/dist/utils/service/venueFBSettlementUtils.js

@@ -0,0 +1,106 @@
+/**
+ * Phase 2 of the unified-pricing roadmap — Venue F&B minimum + revenue-share math.
+ *
+ * Pure functions only (no Prisma / no fetches) so the wizard, api validators,
+ * settlement worker, and offer-suggestion AI can all share one source of truth.
+ *
+ * Concepts:
+ *  - F&B MINIMUM: A venue can require the host's bash to generate at least
+ *    $X in food + beverage spend. If actual spend < minimum, the host owes
+ *    the gap (the "shortfall"). Service charge + tax may or may not count
+ *    toward the minimum, depending on venue config.
+ *  - CARRYOVER CREDIT: If `fbCarryoverEnabled`, excess spend over the minimum
+ *    converts to a credit the host can apply to their next bash at the same
+ *    venue (expires after `fbCarryoverExpiryDays`).
+ *  - REVENUE SHARE: Venue takes a % of ticket revenue. Optional `revenueShareMinimumCents`
+ *    is a floor so the venue is guaranteed at least that much even on slow nights.
+ *
+ * All amounts are integer cents.
+ */
+/** Cents → cents helper that always returns a non-negative integer. */
+function nonNegInt(value) {
+    if (!Number.isFinite(value) || value <= 0)
+        return 0;
+    return Math.round(value);
+}
+/**
+ * Settle an F&B minimum.
+ *
+ * Algorithm:
+ *  1. Normalize both the minimum and the actual spend to the same basis.
+ *     - If the minimum INCLUDES service charge but actual does not, gross up
+ *       the actual by (1 + serviceChargeRate). Same logic for tax.
+ *     - If the minimum EXCLUDES service charge but actual does, strip the
+ *       service charge from the actual figure. Same for tax.
+ *  2. Shortfall = max(0, normalizedMinimum - normalizedActual).
+ *  3. If carryover credits are available, apply them against shortfall.
+ *  4. Excess = max(0, normalizedActual - normalizedMinimum). Becomes new
+ *     carryover credit if `carryoverEnabled`.
+ */
+export function settleVenueFBMinimum(input) {
+    const svcRate = Math.max(0, input.fbServiceChargeRate ?? 0);
+    const taxRate = Math.max(0, input.fbTaxRate ?? 0);
+    // Both the minimum and the actual need to live on the same basis. We
+    // normalize to "pre-service-charge, pre-tax" (the food+bev sticker price).
+    let normalizedMinimumCents = input.fbMinimumCents;
+    if (input.fbMinimumIncludesServiceCharge && svcRate > 0) {
+        normalizedMinimumCents = normalizedMinimumCents / (1 + svcRate);
+    }
+    if (input.fbMinimumIncludesTax && taxRate > 0) {
+        normalizedMinimumCents = normalizedMinimumCents / (1 + taxRate);
+    }
+    normalizedMinimumCents = nonNegInt(normalizedMinimumCents);
+    const normalizedActualCents = nonNegInt(input.actualFbSpendCents);
+    const rawShortfallCents = Math.max(0, normalizedMinimumCents - normalizedActualCents);
+    const availableCarryover = nonNegInt(input.availableCarryoverCents ?? 0);
+    const carryoverAppliedCents = Math.min(rawShortfallCents, availableCarryover);
+    const shortfallChargedCents = rawShortfallCents - carryoverAppliedCents;
+    const excessCents = Math.max(0, normalizedActualCents - normalizedMinimumCents);
+    const carryoverEarnedCents = input.carryoverEnabled ? excessCents : 0;
+    return {
+        normalizedMinimumCents,
+        normalizedActualCents,
+        rawShortfallCents,
+        carryoverAppliedCents,
+        shortfallChargedCents,
+        carryoverEarnedCents,
+        metExactly: rawShortfallCents === 0 &&
+            excessCents === 0 &&
+            normalizedActualCents === normalizedMinimumCents,
+    };
+}
+export function settleVenueRevenueShare(input) {
+    const heldCents = nonNegInt(input.heldTicketRevenueCents);
+    const pct = Math.max(0, Math.min(100, input.revenueSharePercentage));
+    const venueCutPctCents = nonNegInt((heldCents * pct) / 100);
+    const floor = nonNegInt(input.revenueShareMinimumCents ?? 0);
+    const venuePayoutCents = Math.max(venueCutPctCents, floor);
+    return {
+        venueCutPctCents,
+        venuePayoutCents,
+        flooredUp: venuePayoutCents > venueCutPctCents,
+    };
+}
+export function resolveFBMinimumCents(input) {
+    if (input.overrides && input.bashStartDate) {
+        for (const o of input.overrides) {
+            if (o.startsAt <= input.bashStartDate &&
+                input.bashStartDate <= o.endsAt) {
+                return o.minimumCents;
+            }
+        }
+    }
+    const day = input.bashStartDay;
+    // Fri (5), Sat (6), Sun (0) treated as weekend.
+    const isWeekend = day === 0 || day === 5 || day === 6;
+    const result = isWeekend
+        ? input.fbMinimumWeekendCents
+        : input.fbMinimumWeekdayCents;
+    return result == null ? null : Math.max(0, Math.floor(result));
+}
+/**
+ * Cancellation-policy copy snippet to surface on offer sheets + booking
+ * detail when a venue booking has an F&B minimum attached.
+ */
+export const FB_MINIMUM_CANCELLATION_COPY = "If the bash is canceled within the venue's cancellation window, the host may still owe the F&B minimum shortfall. See the venue's cancellation policy for the exact timing.";
+//# sourceMappingURL=venueFBSettlementUtils.js.map

package/dist/utils/service/venueFBSettlementUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"venueFBSettlementUtils.js","sourceRoot":"","sources":["../../../src/utils/service/venueFBSettlementUtils.ts"],"names":[],"mappings":"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"}

package/dist/utils/service/venueSettlementUtils.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Phase 2 of the unified-pricing roadmap — pure math for Venue F&B minimums
+ * and revenue share. Pure functions only (no Prisma / no fetches) so the
+ * wizard, api validators, settlement worker, and offer-suggestion AI can all
+ * share one source of truth.
+ *
+ * See `docs/help-center/pricing-models/` and the plan at
+ * `unified-pricing-roadmap_21d456c6.plan.md` for the policy story.
+ *
+ * Amounts are always integer cents.
+ */
+/** Days of week used in `Venue.fbMinimumSchedule`. Locale-agnostic short keys. */
+export declare const FB_MINIMUM_SCHEDULE_DAYS: readonly ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+export type FBMinimumScheduleDay = (typeof FB_MINIMUM_SCHEDULE_DAYS)[number];
+/** Shape of the JSON stored at `Venue.fbMinimumSchedule`. */
+export type FBMinimumSchedule = Partial<Record<FBMinimumScheduleDay, number>>;
+/** Allowed values for `Venue.revenueShareBasis` (kept as plain strings since
+ *  the column is `String?` rather than an enum). */
+export declare const REVENUE_SHARE_BASES: readonly ["FB_SALES", "TICKET_REVENUE", "TOTAL_GROSS"];
+export type RevenueShareBasis = (typeof REVENUE_SHARE_BASES)[number];
+export interface ResolveFBMinimumInput {
+    /** Per-day-of-week schedule from `Venue.fbMinimumSchedule`. */
+    schedule: FBMinimumSchedule | null | undefined;
+    /** Optional date-windowed overrides from `VenueFBMinimumOverride`. */
+    overrides?: ReadonlyArray<{
+        startDate: Date;
+        endDate: Date;
+        minimumCents: number;
+    }>;
+    /** Bash start as it should be evaluated for day-of-week / override match. */
+    eventStartDateTime: Date;
+}
+/**
+ * Resolve the effective F&B minimum (in cents) for a given bash date.
+ *
+ * Override precedence: any matching window in `overrides` (inclusive endpoints)
+ * wins; otherwise the schedule entry for the day-of-week of `eventStartDateTime`
+ * is used. Returns `null` if neither produces a value.
+ *
+ * Callers that need timezone-aware day-of-week selection should pre-shift the
+ * Date before passing it in — this function uses `Date.getDay()` directly.
+ */
+export declare function resolveFBMinimumForDate(input: ResolveFBMinimumInput): number | null;
+export interface FBShortfallInput {
+    /** Effective minimum (resolved via `resolveFBMinimumForDate`). */
+    fbMinimumCents: number;
+    /** Final food+bev sticker price from the venue invoice. */
+    fbActualSpendCents: number;
+    /** Service-charge cents the venue charged on top of the F&B subtotal. */
+    serviceChargeCents?: number | null;
+    /** Tax cents the venue charged on top of subtotal+service. */
+    taxCents?: number | null;
+    /** Snapshot of `Venue.fbServiceChargeCountsTowardMinimum`. */
+    serviceChargeCountsTowardMinimum: boolean;
+    /** Snapshot of `Venue.fbMinimumIncludesTax`. */
+    includesTax: boolean;
+}
+export interface FBShortfallResult {
+    /** Spend credited toward the minimum after svc-charge/tax flags. */
+    coveredSpendCents: number;
+    /** max(0, minimum - covered). */
+    shortfallCents: number;
+    /** max(0, covered - minimum). Useful for carryover-credit issuance. */
+    excessCents: number;
+    /** True if `shortfallCents === 0 && excessCents === 0`. */
+    metExactly: boolean;
+}
+/**
+ * Compute how much of the bash's F&B invoice counts toward the venue's
+ * minimum and the resulting shortfall (or excess) at settlement.
+ *
+ * Rules:
+ *   - Subtotal (`fbActualSpendCents`) ALWAYS counts toward the minimum.
+ *   - Service charge counts iff `serviceChargeCountsTowardMinimum`.
+ *   - Tax counts iff `includesTax`.
+ *
+ * All cents are integers and always non-negative.
+ */
+export declare function computeFBMinimumShortfallCents(input: FBShortfallInput): FBShortfallResult;
+export interface RevenueShareInput {
+    /** The basis amount in cents (ticket revenue, F&B sales, etc.). */
+    basisCents: number;
+    /** Host percentage (0..100). Venue cut = basisCents * (100 - hostPct) / 100. */
+    hostPct: number;
+}
+export interface RevenueShareResult {
+    /** Host's share in cents. */
+    hostCents: number;
+    /** Venue's share in cents. Equals basis - host. */
+    venueCents: number;
+}
+/**
+ * Compute the revenue-share split given a basis and host percentage.
+ * Returns integer cents. Out-of-range hostPct is clamped to [0, 100].
+ */
+export declare function computeRevenueShareCents(input: RevenueShareInput): RevenueShareResult;
+/** Surfaced on offer sheets + booking detail when an F&B minimum is attached. */
+export declare const FB_MINIMUM_CANCELLATION_COPY = "If the bash is canceled within the venue's cancellation window, the host may still owe the F&B minimum shortfall. See the venue's cancellation policy for the exact timing.";
+/** Surfaced when a venue booking has revenue share configured. */
+export declare const REVENUE_SHARE_CANCELLATION_COPY = "If the bash is canceled before tickets sell, no revenue-share payment is owed. See the venue's cancellation policy for late-cancel rules.";
+/** Default lifetime for a `VenueFBCarryoverCredit`, in days (12 months). */
+export declare const DEFAULT_FB_CARRYOVER_EXPIRY_DAYS = 365;
+/**
+ * Compute the default expiry timestamp for a newly-issued carryover credit.
+ */
+export declare function defaultFBCarryoverExpiresAt(issuedAt?: Date, days?: number): Date;
+//# sourceMappingURL=venueSettlementUtils.d.ts.map

package/dist/utils/service/venueSettlementUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"venueSettlementUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/service/venueSettlementUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,4DAQ3B,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7E,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9E;oDACoD;AACpD,eAAO,MAAM,mBAAmB,wDAItB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAUrE,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/C,sEAAsE;IACtE,SAAS,CAAC,EAAE,aAAa,CAAC;QACxB,SAAS,EAAE,IAAI,CAAC;QAChB,OAAO,EAAE,IAAI,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,6EAA6E;IAC7E,kBAAkB,EAAE,IAAI,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,qBAAqB,GAC3B,MAAM,GAAG,IAAI,CAgBf;AAED,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,8DAA8D;IAC9D,gCAAgC,EAAE,OAAO,CAAC;IAC1C,gDAAgD;IAChD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,gBAAgB,GACtB,iBAAiB,CAiBnB;AAID,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,iBAAiB,GACvB,kBAAkB,CAMpB;AAID,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,gLACsI,CAAC;AAEhL,kEAAkE;AAClE,eAAO,MAAM,+BAA+B,8IACiG,CAAC;AAE9I,4EAA4E;AAC5E,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAEpD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,GAAE,IAAiB,EAC3B,IAAI,GAAE,MAAyC,GAC9C,IAAI,CAGN"}

package/dist/utils/service/venueSettlementUtils.js

@@ -0,0 +1,117 @@
+/**
+ * Phase 2 of the unified-pricing roadmap — pure math for Venue F&B minimums
+ * and revenue share. Pure functions only (no Prisma / no fetches) so the
+ * wizard, api validators, settlement worker, and offer-suggestion AI can all
+ * share one source of truth.
+ *
+ * See `docs/help-center/pricing-models/` and the plan at
+ * `unified-pricing-roadmap_21d456c6.plan.md` for the policy story.
+ *
+ * Amounts are always integer cents.
+ */
+/** Days of week used in `Venue.fbMinimumSchedule`. Locale-agnostic short keys. */
+export const FB_MINIMUM_SCHEDULE_DAYS = [
+    "Sun",
+    "Mon",
+    "Tue",
+    "Wed",
+    "Thu",
+    "Fri",
+    "Sat",
+];
+/** Allowed values for `Venue.revenueShareBasis` (kept as plain strings since
+ *  the column is `String?` rather than an enum). */
+export const REVENUE_SHARE_BASES = [
+    "FB_SALES",
+    "TICKET_REVENUE",
+    "TOTAL_GROSS",
+];
+/** Internal helper — cents → non-negative rounded integer. */
+function nonNegInt(value) {
+    if (!Number.isFinite(value) || value <= 0)
+        return 0;
+    return Math.round(value);
+}
+/**
+ * Resolve the effective F&B minimum (in cents) for a given bash date.
+ *
+ * Override precedence: any matching window in `overrides` (inclusive endpoints)
+ * wins; otherwise the schedule entry for the day-of-week of `eventStartDateTime`
+ * is used. Returns `null` if neither produces a value.
+ *
+ * Callers that need timezone-aware day-of-week selection should pre-shift the
+ * Date before passing it in — this function uses `Date.getDay()` directly.
+ */
+export function resolveFBMinimumForDate(input) {
+    if (input.overrides && input.overrides.length > 0) {
+        const ms = input.eventStartDateTime.getTime();
+        for (const o of input.overrides) {
+            if (o.startDate.getTime() <= ms && ms <= o.endDate.getTime()) {
+                return Math.max(0, Math.floor(o.minimumCents));
+            }
+        }
+    }
+    const schedule = input.schedule ?? null;
+    if (!schedule)
+        return null;
+    const dayIdx = input.eventStartDateTime.getDay();
+    const dayKey = FB_MINIMUM_SCHEDULE_DAYS[dayIdx];
+    const value = schedule[dayKey];
+    if (value == null || !Number.isFinite(value))
+        return null;
+    return Math.max(0, Math.floor(value));
+}
+/**
+ * Compute how much of the bash's F&B invoice counts toward the venue's
+ * minimum and the resulting shortfall (or excess) at settlement.
+ *
+ * Rules:
+ *   - Subtotal (`fbActualSpendCents`) ALWAYS counts toward the minimum.
+ *   - Service charge counts iff `serviceChargeCountsTowardMinimum`.
+ *   - Tax counts iff `includesTax`.
+ *
+ * All cents are integers and always non-negative.
+ */
+export function computeFBMinimumShortfallCents(input) {
+    const subtotal = nonNegInt(input.fbActualSpendCents);
+    const svc = nonNegInt(input.serviceChargeCents ?? 0);
+    const tax = nonNegInt(input.taxCents ?? 0);
+    const coveredSpendCents = subtotal +
+        (input.serviceChargeCountsTowardMinimum ? svc : 0) +
+        (input.includesTax ? tax : 0);
+    const minimum = nonNegInt(input.fbMinimumCents);
+    const shortfallCents = Math.max(0, minimum - coveredSpendCents);
+    const excessCents = Math.max(0, coveredSpendCents - minimum);
+    return {
+        coveredSpendCents,
+        shortfallCents,
+        excessCents,
+        metExactly: shortfallCents === 0 && excessCents === 0,
+    };
+}
+/**
+ * Compute the revenue-share split given a basis and host percentage.
+ * Returns integer cents. Out-of-range hostPct is clamped to [0, 100].
+ */
+export function computeRevenueShareCents(input) {
+    const basis = nonNegInt(input.basisCents);
+    const hostPct = Math.max(0, Math.min(100, input.hostPct));
+    const hostCents = nonNegInt((basis * hostPct) / 100);
+    const venueCents = Math.max(0, basis - hostCents);
+    return { hostCents, venueCents };
+}
+// ---------- Cancellation copy ----------
+/** Surfaced on offer sheets + booking detail when an F&B minimum is attached. */
+export const FB_MINIMUM_CANCELLATION_COPY = "If the bash is canceled within the venue's cancellation window, the host may still owe the F&B minimum shortfall. See the venue's cancellation policy for the exact timing.";
+/** Surfaced when a venue booking has revenue share configured. */
+export const REVENUE_SHARE_CANCELLATION_COPY = "If the bash is canceled before tickets sell, no revenue-share payment is owed. See the venue's cancellation policy for late-cancel rules.";
+/** Default lifetime for a `VenueFBCarryoverCredit`, in days (12 months). */
+export const DEFAULT_FB_CARRYOVER_EXPIRY_DAYS = 365;
+/**
+ * Compute the default expiry timestamp for a newly-issued carryover credit.
+ */
+export function defaultFBCarryoverExpiresAt(issuedAt = new Date(), days = DEFAULT_FB_CARRYOVER_EXPIRY_DAYS) {
+    const ms = issuedAt.getTime() + Math.max(1, Math.floor(days)) * 86_400_000;
+    return new Date(ms);
+}
+//# sourceMappingURL=venueSettlementUtils.js.map

package/dist/utils/service/venueSettlementUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"venueSettlementUtils.js","sourceRoot":"","sources":["../../../src/utils/service/venueSettlementUtils.ts"],"names":[],"mappings":"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"}

package/dist/utils/service/volunteerCompensationUtils.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Volunteer compensation — closed-loop BashPoints stipends + on-site perks.
+ *
+ * Volunteers are NOT employees or contractors. This util intentionally avoids
+ * any USD rate / wage / per-attendee math, because crossing that line would
+ * trigger worker-classification, minimum-wage, and 1099 reporting concerns.
+ *
+ * BashPoints stipends are safe because BP is closed-loop platform credit:
+ *   - never cashed out,
+ *   - never used to settle third-party USD invoices,
+ *   - only redeemable against Bash-issued goods (tickets, BashPass upgrades,
+ *     premium features) — see the closed-loop BP plan.
+ *
+ * Pure functions only so the wizard, api validators, and help-center page
+ * share one source of truth.
+ */
+import { VolunteerCompensationType } from "../../mirroredPrismaEnums.js";
+/** Suggested starter BP stipend per shift. Hosts can override in the wizard. */
+export declare const DEFAULT_VOLUNTEER_STIPEND_BP_PER_SHIFT = 100;
+/** Suggested starter BP stipend per hour. */
+export declare const DEFAULT_VOLUNTEER_STIPEND_BP_PER_HOUR = 25;
+/** Allowed values for `VolunteerService.rateUnit`. */
+export declare const VOLUNTEER_RATE_UNITS: readonly ["shift", "hour"];
+export type VolunteerRateUnit = (typeof VOLUNTEER_RATE_UNITS)[number];
+/**
+ * Returns the suggested starter BP stipend for a volunteer profile based on
+ * how the host wants to denominate it. Wizard pre-fills `bashPointsStipend`
+ * with this; host can override.
+ */
+export declare function defaultStipendBpFor(args: {
+    rateUnit: VolunteerRateUnit | string | null | undefined;
+}): number;
+/**
+ * Returns true if the given compensation type pays any BashPoints. Used by
+ * the booking detail page + settlement worker to decide whether to surface
+ * BP-stipend fields.
+ */
+export declare function compensationTypePaysBashPoints(t: VolunteerCompensationType | string | null | undefined): boolean;
+/**
+ * Returns true if the given compensation type includes on-site perks.
+ */
+export declare function compensationTypeIncludesPerks(t: VolunteerCompensationType | string | null | undefined): boolean;
+/**
+ * Validates a saved volunteer compensation block. Returns a friendly error
+ * when the host's choices contradict (e.g. `PerksOnly` with a BP stipend
+ * filled in, or `BashPointsStipend` with no BP amount).
+ */
+export type VolunteerCompensationValidation = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function validateVolunteerCompensation(args: {
+    compensationType: VolunteerCompensationType | string;
+    bashPointsStipend?: number | null;
+    rateUnit?: string | null;
+    perksDescription?: string | null;
+}): VolunteerCompensationValidation;
+/**
+ * Plain-English label for the booking detail page + booking thread system
+ * messages. Stable across renders.
+ */
+export declare function volunteerCompensationSummary(args: {
+    compensationType: VolunteerCompensationType | string;
+    bashPointsStipend?: number | null;
+    rateUnit?: string | null;
+    perksDescription?: string | null;
+}): string;
+/**
+ * Disclaimer copy for the volunteer wizard step + help-center page + booking
+ * detail. Kept here so wizard, api, and docs cite the exact same wording.
+ */
+export declare const VOLUNTEER_COMPENSATION_DISCLAIMER = "Volunteers are not employees or contractors. BashPoints stipends are platform credit redeemable on Bash, not wages, and don't count toward employment or 1099 reporting.";
+//# sourceMappingURL=volunteerCompensationUtils.d.ts.map

package/dist/utils/service/volunteerCompensationUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volunteerCompensationUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/service/volunteerCompensationUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,gFAAgF;AAChF,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D,6CAA6C;AAC7C,eAAO,MAAM,qCAAqC,KAAK,CAAC;AAExD,sDAAsD;AACtD,eAAO,MAAM,oBAAoB,4BAA6B,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACzD,GAAG,MAAM,CAKT;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,CAAC,EAAE,yBAAyB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACvD,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,CAAC,EAAE,yBAAyB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACvD,OAAO,CAET;AAED;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,GACvC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,gBAAgB,EAAE,yBAAyB,GAAG,MAAM,CAAC;IACrD,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,GAAG,+BAA+B,CA+BlC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,gBAAgB,EAAE,yBAAyB,GAAG,MAAM,CAAC;IACrD,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,GAAG,MAAM,CAmBT;AAED;;;GAGG;AACH,eAAO,MAAM,iCAAiC,6KAC8H,CAAC"}