@bash-app/bash-common 30.284.0 → 30.289.0

package/dist/dist/utils/service/defaultOfferAmountUtils.js

@@ -0,0 +1,115 @@
+/**
+ * Deterministic default offer amount for a service + bash context.
+ * Keeps service cards, budget bar, SendOfferSheet prefill, and bulk offers aligned.
+ */
+import { computeOfferComparisonBands, } from "./offerComparisonUtils.js";
+import { resolveUnifiedPricingBlock, } from "./unifiedPricingResolver.js";
+import { SERVICE_DAILY_RATE_HOURS_MIN } from "./serviceRateUtils.js";
+export { SERVICE_DAILY_RATE_HOURS_MIN };
+/** Event length in hours; defaults to 1 when dates are missing or invalid. */
+export function computeBashEventDurationHours(startDateTime, endDateTime) {
+    if (!startDateTime || !endDateTime)
+        return 1;
+    const start = new Date(startDateTime).getTime();
+    const end = new Date(endDateTime).getTime();
+    if (!Number.isFinite(start) || !Number.isFinite(end))
+        return 1;
+    const hours = (end - start) / (1000 * 60 * 60);
+    return hours >= 0.25 ? hours : 1;
+}
+/** Legacy published-rate estimate (flat → daily if 8+ hrs → hourly × duration). */
+export function calcLegacyRateEstimateCents(rates, durationHours) {
+    if (!rates)
+        return 0;
+    if ((rates.flatRateCents ?? 0) > 0)
+        return rates.flatRateCents;
+    const hours = durationHours >= 0.25 ? durationHours : 1;
+    if (hours >= SERVICE_DAILY_RATE_HOURS_MIN &&
+        (rates.dailyRateCents ?? 0) > 0) {
+        return rates.dailyRateCents;
+    }
+    if ((rates.hourlyRateCents ?? 0) > 0) {
+        return Math.round(rates.hourlyRateCents * hours);
+    }
+    if ((rates.dailyRateCents ?? 0) > 0)
+        return rates.dailyRateCents;
+    return 0;
+}
+function unifiedModelEstimateCents(pricingModel, block, durationHours, expectedAttendees) {
+    const base = block.baseRateCents ?? 0;
+    const hours = durationHours >= 0.25 ? durationHours : 1;
+    switch (pricingModel) {
+        case "HOURLY":
+            return base > 0 ? Math.round(base * hours) : 0;
+        case "PER_DAY":
+            if (base <= 0)
+                return 0;
+            if (hours >= SERVICE_DAILY_RATE_HOURS_MIN)
+                return base;
+            return Math.round(base * (hours / SERVICE_DAILY_RATE_HOURS_MIN));
+        case "FLAT_FEE":
+        case "CUSTOM":
+            return base > 0 ? base : 0;
+        case "PER_ATTENDEE":
+        case "PER_PAID_ATTENDEE": {
+            const bands = computeOfferComparisonBands({
+                pricingModel,
+                baseRateCents: base,
+                minimumChargeCents: block.minimumChargeCents,
+                minimumQuantity: block.minimumQuantity,
+                expectedAttendees,
+            });
+            return bands.expectedTotalCents ?? 0;
+        }
+        case "PER_BASHPOINTS_ATTENDEE":
+            return 0;
+        case "TIERED": {
+            const bands = computeOfferComparisonBands({
+                pricingModel: "TIERED",
+                tieredExpectedTierCents: base > 0 ? base : null,
+            });
+            return bands.expectedTotalCents ?? 0;
+        }
+        default: {
+            const bands = computeOfferComparisonBands({
+                pricingModel,
+                baseRateCents: base,
+                flatRateCents: base > 0 ? base : null,
+            });
+            return bands.expectedTotalCents ?? 0;
+        }
+    }
+}
+/**
+ * Returns the suggested opening offer in USD cents for this bash, or 0 when
+ * no computable rate exists (bulk send should skip those services).
+ */
+export function getDefaultOfferAmountCents(params) {
+    const { service, durationHours, expectedAttendees } = params;
+    const legacyRates = service.serviceRatesAssociation?.serviceGeneralRates;
+    const block = resolveUnifiedPricingBlock({
+        eventService: service.eventService,
+        vendor: service.vendor,
+        exhibitor: service.exhibitor,
+        sponsor: service.sponsor,
+        venue: service.venue,
+        entertainmentService: service.entertainmentService,
+        volunteerService: service.volunteerService,
+        legacyRate: null,
+    });
+    if (block.fromUnifiedBlock && block.pricingModel) {
+        const unified = unifiedModelEstimateCents(block.pricingModel, block, durationHours, expectedAttendees);
+        if (unified > 0)
+            return unified;
+    }
+    return calcLegacyRateEstimateCents(legacyRates, durationHours);
+}
+export function formatOfferAmountDollars(cents) {
+    return `$${Math.round(cents / 100).toLocaleString("en-US")}`;
+}
+/** Host → provider bulk offers only when a positive USD default exists. */
+export function isBulkHostOfferEligible(amountCents, isParticipationFeeService) {
+    return !isParticipationFeeService && amountCents > 0;
+}
+export const BULK_OFFER_MAX_COUNT = 10;
+//# sourceMappingURL=defaultOfferAmountUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaultOfferAmountUtils.js","sourceRoot":"","sources":["../../../src/utils/service/defaultOfferAmountUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,2BAA2B,GAE5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,0BAA0B,GAE3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,EAAE,4BAA4B,EAAE,CAAC;AAoBxC,8EAA8E;AAC9E,MAAM,UAAU,6BAA6B,CAC3C,aAA+C,EAC/C,WAA6C;IAE7C,IAAI,CAAC,aAAa,IAAI,CAAC,WAAW;QAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/C,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,2BAA2B,CACzC,KAAiD,EACjD,aAAqB;IAErB,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC,aAAc,CAAC;IAChE,MAAM,KAAK,GAAG,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,IACE,KAAK,IAAI,4BAA4B;QACrC,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,CAAC,EAC/B,CAAC;QACD,OAAO,KAAK,CAAC,cAAe,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,eAAgB,GAAG,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC,cAAe,CAAC;IAClE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,yBAAyB,CAChC,YAAoB,EACpB,KAKC,EACD,aAAqB,EACrB,iBAA4C;IAE5C,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAExD,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,KAAK,SAAS;YACZ,IAAI,IAAI,IAAI,CAAC;gBAAE,OAAO,CAAC,CAAC;YACxB,IAAI,KAAK,IAAI,4BAA4B;gBAAE,OAAO,IAAI,CAAC;YACvD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,4BAA4B,CAAC,CAAC,CAAC;QACnE,KAAK,UAAU,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,KAAK,cAAc,CAAC;QACpB,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,KAAK,GAAG,2BAA2B,CAAC;gBACxC,YAAY;gBACZ,aAAa,EAAE,IAAI;gBACnB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;gBAC5C,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,iBAAiB;aACa,CAAC,CAAC;YAClC,OAAO,KAAK,CAAC,kBAAkB,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,yBAAyB;YAC5B,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,KAAK,GAAG,2BAA2B,CAAC;gBACxC,YAAY,EAAE,QAAQ;gBACtB,uBAAuB,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;aAChD,CAAC,CAAC;YACH,OAAO,KAAK,CAAC,kBAAkB,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,KAAK,GAAG,2BAA2B,CAAC;gBACxC,YAAY;gBACZ,aAAa,EAAE,IAAI;gBACnB,aAAa,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;aACtC,CAAC,CAAC;YACH,OAAO,KAAK,CAAC,kBAAkB,IAAI,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAgC;IAEhC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC;IAC7D,MAAM,WAAW,GAAG,OAAO,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;IAEzE,MAAM,KAAK,GAAG,0BAA0B,CAAC;QACvC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;QAClD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,yBAAyB,CACvC,KAAK,CAAC,YAAY,EAClB,KAAK,EACL,aAAa,EACb,iBAAiB,CAClB,CAAC;QACF,IAAI,OAAO,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC;IAClC,CAAC;IAED,OAAO,2BAA2B,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,uBAAuB,CACrC,WAAmB,EACnB,yBAAkC;IAElC,OAAO,CAAC,yBAAyB,IAAI,WAAW,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC"}

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

@@ -0,0 +1,319 @@
+import { PricingModel, PromotionAndMarketingSubType } from "@prisma/client";
+/**
+ * Event Promoter is a productized hire-a-promoter service profile under
+ * `EventService` → `PromotionAndMarketing` → `Promoter`. Its pricing model
+ * is intentionally locked to PER_ATTENDEE so:
+ *
+ * 1. Bookings can compute a deposit at booking time from
+ *    `bashEvent.expectedAttendees * baseRateCents`.
+ * 2. The bash-close settlement job can run a delta charge/refund based on
+ *    final checked-in attendee count (see
+ *    `apiEventPromoterSettlementMath` below).
+ *
+ * Keep the disambiguation: this is the **Event Promoter** service, not the
+ * **Promo-code Promoter** referral program (`model Promoter` +
+ * `BashEventPromoCode`), which earns BashPoints per ticket purchased.
+ */
+/**
+ * Returns true when the given `PromotionAndMarketing` subtype is locked to a
+ * specific `PricingModel`. Today only `Promoter` is locked (PER_ATTENDEE).
+ *
+ * Compared with the **string literal** rather than the Prisma enum object
+ * because the browser bundle (`index-browser`) does not always re-export
+ * Prisma enums as runtime values — see `bash-common/src/mirroredPrismaEnums.ts`
+ * for the same pattern.
+ */
+export declare function isPerAttendeeLockedPromotionSubType(subType: PromotionAndMarketingSubType | string | null | undefined): boolean;
+/**
+ * Build the URL the host clicks from an Event Promoter booking thread to
+ * issue/edit a `BashEventPromoCode` with the promoter pre-selected. The
+ * landing page reads `promoterUserId` from the query string and opens the
+ * promo-code create modal already focused on that user.
+ *
+ * Keeping this in `bash-common` so api emails + bash-app threads + push
+ * notifications all generate the same deep link.
+ */
+export declare function buildIssuePromoCodeDeepLink(args: {
+    bashEventId: string;
+    promoterUserId: string;
+    /** Optional preselected ticket tier (skip the chooser screen when set). */
+    ticketTierId?: string | null;
+}): string;
+/** Hours-before-bash threshold under which a host cancellation is "late". */
+export declare const EVENT_PROMOTER_LATE_CANCEL_HOURS = 48;
+/**
+ * Late-cancellation penalty as a fraction of the deposit (0..1). 0.25 means
+ * the host forfeits 25% of the deposit when they cancel inside the
+ * `EVENT_PROMOTER_LATE_CANCEL_HOURS` window — covers the promoter's
+ * sunk planning time.
+ */
+export declare const EVENT_PROMOTER_LATE_CANCEL_PENALTY_FRACTION = 0.25;
+/** Who is cancelling the Event Promoter booking. Maps to refund policy. */
+export type EventPromoterCanceller = "host" | "promoter" | "admin";
+export interface EventPromoterCancellationInput {
+    who: EventPromoterCanceller;
+    /** ISO timestamp of "now" — injected so callers can test edge cases. */
+    nowMs: number;
+    /** Bash start time. */
+    bashStartMs: number | null;
+    /** Bash end time — once we're past this, settlement takes over instead. */
+    bashEndMs: number | null;
+    /** Deposit cents already charged at booking. */
+    depositCents: number;
+    /** Has settlement already run? If so, cancellation is a no-op. */
+    alreadySettled: boolean;
+}
+export interface EventPromoterCancellationDecision {
+    /** Whether the cancellation can run automatically right now. */
+    allow: boolean;
+    /**
+     * Outcome category for telemetry + thread messaging:
+     * - `FullRefund` — full deposit returned (host cancel outside window, or
+     *   promoter cancel any time before the bash).
+     * - `PartialRefund` — host cancels inside the late-cancel window; promoter
+     *   keeps `EVENT_PROMOTER_LATE_CANCEL_PENALTY_FRACTION` of the deposit.
+     * - `NoRefund` — bash already happened; settlement handles it instead.
+     * - `Blocked` — booking already settled, or impossible state; admin only.
+     */
+    outcome: "FullRefund" | "PartialRefund" | "NoRefund" | "Blocked";
+    /** Refund amount in cents (0 when outcome is NoRefund/Blocked). */
+    refundCents: number;
+    /** Penalty fraction applied (0 when not late-cancelled by host). */
+    penaltyFraction: number;
+    /** Human-readable reason, suitable for booking-thread system messages. */
+    reason: string;
+}
+/**
+ * Pure decision function that returns what should happen when someone tries
+ * to cancel an Event Promoter booking. Mirrors the matrix called out in the
+ * plan:
+ *
+ *   - Host, bash hasn't started, > 48h out → FullRefund.
+ *   - Host, bash hasn't started, ≤ 48h out → PartialRefund (25% penalty).
+ *   - Host, bash already running/ended → NoRefund (settlement takes over).
+ *   - Promoter, bash not started → FullRefund + promoter notified
+ *     (Bash never holds a promoter to a job they can't do).
+ *   - Promoter, bash already running/ended → Blocked (use the booking thread
+ *     to coordinate; nothing automatic).
+ *   - Admin always allowed; refund amount decided by caller.
+ *   - Already settled → Blocked (no automatic cancel).
+ *
+ * The actual Stripe refund + DB mutation lives in the api-side counterpart;
+ * this function only encodes policy so the same matrix surfaces in tests,
+ * the booking thread copy, and the audit log.
+ */
+export declare function decideEventPromoterCancellation(input: EventPromoterCancellationInput): EventPromoterCancellationDecision;
+/**
+ * The single allowed pricing model for the locked promotion subtype. Exposed
+ * as a constant so wizard + api validators share the same source of truth.
+ *
+ * Retained for backwards compatibility; new call sites should prefer
+ * {@link EVENT_PROMOTER_LOCKED_PRICING_MODELS} to allow Phase 3's
+ * `PER_PAID_ATTENDEE` and `PER_BASHPOINTS_ATTENDEE`.
+ */
+export declare const EVENT_PROMOTER_LOCKED_PRICING_MODEL: PricingModel;
+/**
+ * Phase 3 — set of pricing models the locked Event Promoter subtype may use.
+ * Any of these guarantees a per-head settlement at bash close, which is the
+ * actual constraint the worker cares about. Wizard offers them as a choice;
+ * api validator accepts any.
+ */
+export declare const EVENT_PROMOTER_LOCKED_PRICING_MODELS: ReadonlyArray<PricingModel>;
+export type EventPromoterPricingValidation = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+    expected: ReadonlyArray<PricingModel>;
+};
+/**
+ * Validates that an `EventService` save with `subType === "Promoter"` uses
+ * one of the {@link EVENT_PROMOTER_LOCKED_PRICING_MODELS}. Intended for both:
+ *
+ * - the Event Services wizard (block save with a friendly message), and
+ * - the api save path (reject the request even if the wizard is bypassed).
+ *
+ * Returns `{ ok: true }` for any non-locked subtype.
+ */
+export declare function validateEventPromoterPricing(args: {
+    eventServiceSubType: PromotionAndMarketingSubType | string | null | undefined;
+    pricingModel: PricingModel | null | undefined;
+}): EventPromoterPricingValidation;
+/**
+ * Computes the deposit cents to charge a host at Event Promoter booking time.
+ *
+ * Logic:
+ * - Baseline = max(`bashExpectedAttendees`, `minimumQuantity ?? 0`).
+ * - Deposit = baseline * `baseRateCents`.
+ *
+ * Returns `null` if `baseRateCents` is not set (caller should surface a
+ * validation error rather than silently charge $0).
+ */
+export declare function computeEventPromoterDepositCents(args: {
+    bashExpectedAttendees: number;
+    baseRateCents: number | null | undefined;
+    minimumQuantity: number | null | undefined;
+}): number | null;
+export interface EventPromoterSettlementInput {
+    baseRateCents: number;
+    expectedAttendeesAtBooking: number;
+    totalCheckedInAttendees: number;
+    /** Per-booking host-set ceiling on attributable attendees; `null` = no cap. */
+    maxAttendeesAttributable?: number | null;
+    /** Optional floor — usually `EventService.minimumQuantity` at booking time. */
+    minimumQuantity?: number | null;
+}
+export interface EventPromoterSettlementResult {
+    /**
+     * Attendee count actually used to bill, after applying the ceiling and any
+     * minimum-quantity floor. Always ≥ 0.
+     */
+    finalCount: number;
+    /**
+     * True iff `maxAttendeesAttributable` capped `finalCount`. Useful for
+     * analytics — high `ceilingHit` rates signal v2 (per-ticket attribution).
+     */
+    ceilingHit: boolean;
+    /**
+     * Signed delta in cents:
+     * - positive → charge the host this additional amount.
+     * - negative → refund the host this amount (refund magnitude = |delta|).
+     * - 0 → no Stripe action needed; mark `settledAt`.
+     */
+    settlementDeltaCents: number;
+    /**
+     * Total cents the host owes for the booking after settlement
+     * (`finalCount * baseRateCents`). Useful for receipts / analytics.
+     */
+    totalCents: number;
+}
+/**
+ * Pure function: compute the per-attendee settlement delta for an Event
+ * Promoter `ServiceBooking`. Caller is responsible for translating the result
+ * into Stripe API calls (charge if positive delta, refund if negative).
+ *
+ * Worked example (host hires two promoters for the same bash @ $5/attendee):
+ *
+ *   Promoter A: expected=200, ceiling=250, checked-in=220
+ *     → finalCount=220, delta = (220-200) * 500 = +$100
+ *
+ *   Promoter B: expected=100, ceiling=150, same 220 checked-in
+ *     → finalCount=min(220,150)=150, delta = (150-100) * 500 = +$250
+ *
+ * @see plan: docs/design/CONTENT-PATTERNS.md, .cursor/plans/ambashadors_page_tiers_ux_*.plan.md
+ */
+export declare function computeEventPromoterSettlement(input: EventPromoterSettlementInput): EventPromoterSettlementResult;
+/**
+ * Which checked-in attendees count toward the settlement headcount?
+ *
+ * - `AllCheckedIn` — every checked-in, non-comp guest (legacy PER_ATTENDEE).
+ * - `PaidUsdOnly` — only guests on USD-priced tiers (PER_PAID_ATTENDEE without
+ *   `countsBashPointsTickets`).
+ * - `PaidBpOnly` — only guests on BashPoints-priced tiers
+ *   (PER_BASHPOINTS_ATTENDEE).
+ * - `PaidAny` — paid guests on either currency
+ *   (PER_PAID_ATTENDEE with `countsBashPointsTickets = true`).
+ */
+export type EventPromoterCountingBasis = "AllCheckedIn" | "PaidUsdOnly" | "PaidBpOnly" | "PaidAny";
+/**
+ * Choose the correct counting basis given the pricing model and the
+ * per-booking `countsBashPointsTickets` knob. Pure function so wizard +
+ * worker share one mapping.
+ */
+export declare function eventPromoterCountingBasisFor(args: {
+    pricingModel: PricingModel | string | null | undefined;
+    countsBashPointsTickets?: boolean | null;
+}): EventPromoterCountingBasis;
+/**
+ * Pick the matching checked-in count from the snapshots a worker has gathered
+ * at settlement time. Returns the **paying** head count regardless of
+ * currency, narrowed by basis.
+ */
+export interface EventPromoterAttendeeSnapshots {
+    /** All checked-in attendees (`AllCheckedIn` basis). */
+    totalCheckedInAttendees: number;
+    /** Checked-in attendees on USD-priced tiers (`PaidUsdOnly` / `PaidAny`). */
+    paidAttendeesAtSettle?: number | null;
+    /** Checked-in attendees on BP-priced tiers (`PaidBpOnly` / `PaidAny`). */
+    paidInBashPointsAttendeesAtSettle?: number | null;
+}
+export declare function pickCheckedInForBasis(basis: EventPromoterCountingBasis, s: EventPromoterAttendeeSnapshots): number;
+export interface EventPromoterMixedSettlementInput {
+    /** Per-attendee USD rate (cents). 0/null = no USD owed. */
+    baseRateCents?: number | null;
+    /** Per-attendee BP rate. 0/null = no BP owed. */
+    baseRateBashPoints?: number | null;
+    /** Expected USD-paying head count at booking. */
+    expectedPaidAttendeesAtBooking?: number | null;
+    /** Expected BP-paying head count at booking. */
+    expectedBpAttendeesAtBooking?: number | null;
+    /** Snapshots from the bash checkout (see `EventPromoterAttendeeSnapshots`). */
+    snapshots: EventPromoterAttendeeSnapshots;
+    /** Optional ceilings — separate caps for USD and BP. */
+    maxUsdAttendeesAttributable?: number | null;
+    maxBpAttendeesAttributable?: number | null;
+    /** Optional dollar cap on USD side (from `maxBillableCents`). */
+    maxBillableCents?: number | null;
+    /** Optional BP cap on BP side (from `maxBillableBashPoints`). */
+    maxBillableBashPoints?: number | null;
+}
+export interface EventPromoterMixedSettlementResult {
+    /** USD owed at settlement. */
+    usdTotalCents: number;
+    /** USD delta vs the deposit pre-paid at booking. */
+    usdDeltaCents: number;
+    /** BashPoints owed at settlement. */
+    bpTotal: number;
+    /** BP delta vs the deposit pre-paid at booking. */
+    bpDelta: number;
+    /** True if either cap kicked in. */
+    cappedUsd: boolean;
+    cappedBp: boolean;
+}
+/**
+ * Pure function for mixed PER_PAID_ATTENDEE / PER_BASHPOINTS_ATTENDEE
+ * settlement. Either side can be unset (the worker only computes the side
+ * that applies). Caller is responsible for the actual Stripe + BP ledger
+ * postings.
+ */
+export declare function computeEventPromoterMixedSettlement(input: EventPromoterMixedSettlementInput): EventPromoterMixedSettlementResult;
+export type BashPointsPayoutSourceValue = "HostWallet" | "BashBpPool";
+export interface BashPointsPayoutResolverInput {
+    /** From `BashEvent.bashPointsPayoutSource`. */
+    source: BashPointsPayoutSourceValue;
+    /** BP the worker owes the provider for this settlement. */
+    payoutBp: number;
+    /** BP the host has in their wallet at settlement time. */
+    hostWalletBp: number;
+    /**
+     * For `BashBpPool` source: live remaining BP in the bash's BP pool. This is
+     * `sum(BP from BP-ticket purchases) − sum(BP already paid out) −
+     * sum(outstanding BP-refund obligations)`. Caller computes; resolver only
+     * drains.
+     */
+    bashPoolBp?: number;
+}
+export interface BashPointsPayoutResolverResult {
+    /** BP drained from the bash's BashPoints pool. */
+    fromPoolBp: number;
+    /** BP debited from the host's wallet. */
+    fromWalletBp: number;
+    /** BP that could NOT be sourced (resulting failure → dunning). */
+    shortfallBp: number;
+    /** True when fromWalletBp > 0 — used to surface UI / push notifications. */
+    walletDebited: boolean;
+}
+/**
+ * Pure function that decides which BashPoints buckets to drain to satisfy a
+ * provider payout. Mirrors the worker's behavior:
+ *
+ *   - `HostWallet`: take everything from the host's wallet; any shortfall is
+ *     a payment failure (`SettlementPaymentFailed`).
+ *   - `BashBpPool`: drain the pool first; pay the remainder from the host's
+ *     wallet; if still short, mark `SettlementPaymentFailed`.
+ *
+ * Negative inputs are clamped to zero so the resolver never returns a
+ * negative bucket.
+ */
+export declare function resolveBashPointsPayoutSources(input: BashPointsPayoutResolverInput): BashPointsPayoutResolverResult;
+//# sourceMappingURL=eventPromoterUtils.d.ts.map

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

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