@bash-app/bash-common 30.431.0 → 30.433.0

package/src/utils/paymentUtils.ts

@@ -448,12 +448,35 @@ export function lowestGuestAllInPriceCents(
   return min;
 }
 
-/** Max share of attributed ticket subtotal a host can assign to a performer (50%). */
-export const MAX_TICKET_COMMISSION_BPS = 5000;
+/** A host can assign up to 100% of eligible net ticket proceeds to a promoter. */
+export const MAX_TICKET_COMMISSION_BPS = 10_000;
 
 /**
- * Floor cents owed to a promo-code performer from the discounted ticket subtotal.
- * Guest price is unchanged; this amount is withheld from the host via application_fee.
+ * Cents left on the host transfer when withholding commission. Stripe test mode
+ * accepted application_fee_amount equal to the charge (check 4b, 2026-10-14),
+ * so a $0 host transfer is allowed and this stays 0. This is not a host share.
+ */
+export const TEMPORARY_SETTLEMENT_SAFETY_REMAINDER_CENTS = 0;
+
+/** Error message for an out-of-range rate, or null when 0-100% (0-10000 bps). */
+export function ticketCommissionBpsError(
+  commissionBps: number | null | undefined
+): string | null {
+  if (commissionBps == null) return null;
+  if (!Number.isInteger(commissionBps)) {
+    return "Commission must be a whole number of basis points.";
+  }
+  if (commissionBps < 0 || commissionBps > MAX_TICKET_COMMISSION_BPS) {
+    return "Commission must be between 0% and 100% of eligible net ticket proceeds.";
+  }
+  return null;
+}
+
+/**
+ * Floor cents owed to a promoter: `commissionBps` of `basisCents`, where the basis
+ * is eligible net ticket proceeds. Guest price is unchanged; the amount is
+ * withheld from the host via application_fee. Rates are validated when written;
+ * this never pays more than 100% of the basis.
  */
 export function ticketCommissionCents(
   basisCents: number,
@@ -462,16 +485,34 @@ export function ticketCommissionCents(
   if (basisCents <= 0) return 0;
   const bps = Math.floor(Number(commissionBps) || 0);
   if (bps <= 0) return 0;
-  const clamped = Math.min(MAX_TICKET_COMMISSION_BPS, bps);
-  return Math.floor((basisCents * clamped) / 10_000);
+  return Math.floor((basisCents * Math.min(MAX_TICKET_COMMISSION_BPS, bps)) / 10_000);
 }
 
-export function clampTicketCommissionBps(
-  commissionBps: number | null | undefined
-): number {
-  const bps = Math.floor(Number(commissionBps) || 0);
-  if (bps <= 0) return 0;
-  return Math.min(MAX_TICKET_COMMISSION_BPS, bps);
+/**
+ * What the host would otherwise receive for the eligible ticket lines: the
+ * eligible discounted subtotal, less its share of the Bash platform fee and the
+ * Stripe processing estimate that no guest fee line pays. Tax, guest fee lines,
+ * coat check, and delivery are never part of it. Floored at 0.
+ */
+export function eligibleNetTicketProceedsCents(args: {
+  /** Discounted subtotal of the lines the code applies to. */
+  eligibleSubtotalCents: number;
+  /** Discounted ticket subtotal of the whole cart (the fee basis). */
+  discountedSubtotalCents: number;
+  bashPlatformTotalCents: number;
+  guestPlatformLineCents: number;
+  stripeProcessingCents: number;
+  guestProcessingLineCents: number;
+}): number {
+  const eligible = Math.max(0, Math.floor(args.eligibleSubtotalCents));
+  const cart = Math.max(0, Math.floor(args.discountedSubtotalCents));
+  if (eligible <= 0 || cart <= 0) return 0;
+  const share = Math.min(1, eligible / cart);
+  const hostPlatform = Math.max(0, args.bashPlatformTotalCents - args.guestPlatformLineCents);
+  const hostProcessing = Math.max(0, args.stripeProcessingCents - args.guestProcessingLineCents);
+  const net =
+    eligible - Math.ceil(hostPlatform * share) - Math.ceil(hostProcessing * share);
+  return Math.max(0, net);
 }
 
 /**
@@ -528,7 +569,9 @@ export function computeTicketApplicationFeeAmountCents(args: {
   );
   const maxWithhold = Math.max(
     0,
-    breakdown.totalDueCents - breakdown.applicationFeeAmountCents - 1
+    breakdown.totalDueCents -
+      breakdown.applicationFeeAmountCents -
+      TEMPORARY_SETTLEMENT_SAFETY_REMAINDER_CENTS
   );
   const withheld = Math.min(performerCommissionCents, maxWithhold);
   return {