@bash-app/bash-common 30.219.0 → 30.220.0

package/src/utils/__tests__/paymentUtils.test.ts

@@ -15,6 +15,10 @@ import {
   calculateTotalBashPoints,
   calculateStripeDonationFee,
   calculateServiceFeeWithMembershipDiscount,
+  calculateBashPlatformFeeCents,
+  splitBashPlatformFeeForTicketCheckout,
+  computeTicketApplicationFeeAmountCents,
+  userHasActiveBashPass,
 } from "../paymentUtils.js";
 
 describe("PaymentUtils - Core Functions", () => {
@@ -93,6 +97,67 @@ describe("PaymentUtils - Core Functions", () => {
     test("calculateStripeFee (dollars) aligns with calculateStripeProcessingFeeCents", () => {
       expect(calculateStripeFee(100)).toBe(3.2);
     });
+
+    test("calculateBashPlatformFeeCents floors 3% of gross", () => {
+      expect(calculateBashPlatformFeeCents(10000, 0.03)).toBe(300);
+      expect(calculateBashPlatformFeeCents(100, 0.03)).toBe(3);
+      expect(calculateBashPlatformFeeCents(0, 0.03)).toBe(0);
+    });
+
+    test("splitBashPlatformFeeForTicketCheckout respects feeHandling and BashPass", () => {
+      const base = {
+        grossCents: 10000,
+        platformFeeEnabled: true,
+        platformFeeRate: 0.03,
+      };
+      expect(splitBashPlatformFeeForTicketCheckout({ ...base, feeHandling: "HostAbsorbs", bashPassWaivesGuestFee: false })).toEqual({
+        totalPlatformCents: 300,
+        guestPlatformLineCents: 0,
+      });
+      expect(splitBashPlatformFeeForTicketCheckout({ ...base, feeHandling: "GuestPays", bashPassWaivesGuestFee: false })).toEqual({
+        totalPlatformCents: 300,
+        guestPlatformLineCents: 300,
+      });
+      expect(splitBashPlatformFeeForTicketCheckout({ ...base, feeHandling: "Split", bashPassWaivesGuestFee: false })).toEqual({
+        totalPlatformCents: 300,
+        guestPlatformLineCents: 150,
+      });
+      expect(splitBashPlatformFeeForTicketCheckout({ ...base, feeHandling: "GuestPays", bashPassWaivesGuestFee: true })).toEqual({
+        totalPlatformCents: 300,
+        guestPlatformLineCents: 0,
+      });
+    });
+
+    test("computeTicketApplicationFeeAmountCents sums Stripe + Bash platform into application fee", () => {
+      const r = computeTicketApplicationFeeAmountCents({
+        discountedSubtotalCents: 10000,
+        platformFeeEnabled: true,
+        platformFeeRate: 0.03,
+        feeHandling: "HostAbsorbs",
+        bashPassWaivesGuestFee: false,
+      });
+      expect(r.totalChargedCents).toBe(10000);
+      expect(r.bashPlatformTotalCents).toBe(300);
+      expect(r.stripeProcessingCents).toBe(calculateStripeProcessingFeeCents(10000));
+      expect(r.applicationFeeAmountCents).toBe(r.stripeProcessingCents + 300);
+    });
+
+    test("userHasActiveBashPass", () => {
+      expect(userHasActiveBashPass({ bashPassStripeSubscriptionId: null, bashPassCurrentPeriodEnd: null })).toBe(false);
+      expect(userHasActiveBashPass({ bashPassStripeSubscriptionId: "sub_1", bashPassCurrentPeriodEnd: null })).toBe(true);
+      expect(
+        userHasActiveBashPass({
+          bashPassStripeSubscriptionId: "sub_1",
+          bashPassCurrentPeriodEnd: new Date(Date.now() + 86400000),
+        })
+      ).toBe(true);
+      expect(
+        userHasActiveBashPass({
+          bashPassStripeSubscriptionId: "sub_1",
+          bashPassCurrentPeriodEnd: new Date(Date.now() - 86400000),
+        })
+      ).toBe(false);
+    });
   });
 
   describe("Ticket total price (USD)", () => {

package/src/utils/paymentUtils.ts

@@ -221,6 +221,94 @@ export function calculatePartnerFeeWithMembershipDiscount(
   return parseFloat(calculatedFee.toFixed(2));
 }
 
+/**
+ * Bash **platform** take rate on ticket gross (e.g. 3%). Separate from Stripe card processing pass-through.
+ */
+export function calculateBashPlatformFeeCents(grossCents: number, rate: number): number {
+  if (grossCents <= 0 || rate <= 0) return 0;
+  return Math.floor(grossCents * rate);
+}
+
+export type BashPlatformTicketFeeSplit = {
+  totalPlatformCents: number;
+  /** Shown as a separate checkout line when greater than 0 */
+  guestPlatformLineCents: number;
+};
+
+/**
+ * Split the Bash platform fee between guest line items vs host absorption using `feeHandling`.
+ * BashPass waives the **guest-visible** portion only; the host still funds the full platform fee when the guest pays nothing extra.
+ */
+export function splitBashPlatformFeeForTicketCheckout(args: {
+  grossCents: number;
+  platformFeeEnabled: boolean;
+  platformFeeRate: number;
+  feeHandling: string | null | undefined;
+  bashPassWaivesGuestFee: boolean;
+}): BashPlatformTicketFeeSplit {
+  const { grossCents, platformFeeEnabled, platformFeeRate, feeHandling, bashPassWaivesGuestFee } = args;
+  const total = platformFeeEnabled
+    ? calculateBashPlatformFeeCents(grossCents, platformFeeRate)
+    : 0;
+  if (total <= 0) {
+    return { totalPlatformCents: 0, guestPlatformLineCents: 0 };
+  }
+  const mode = feeHandling ?? "HostAbsorbs";
+  let guestLine = 0;
+  if (mode === "GuestPays") {
+    guestLine = total;
+  } else if (mode === "Split") {
+    guestLine = Math.floor(total / 2);
+  }
+  if (bashPassWaivesGuestFee && guestLine > 0) {
+    guestLine = 0;
+  }
+  return { totalPlatformCents: total, guestPlatformLineCents: guestLine };
+}
+
+export function computeTicketApplicationFeeAmountCents(args: {
+  discountedSubtotalCents: number;
+  platformFeeEnabled: boolean;
+  platformFeeRate: number;
+  feeHandling: string | null | undefined;
+  bashPassWaivesGuestFee: boolean;
+}): {
+  totalChargedCents: number;
+  stripeProcessingCents: number;
+  bashPlatformTotalCents: number;
+  applicationFeeAmountCents: number;
+  guestPlatformLineCents: number;
+} {
+  const split = splitBashPlatformFeeForTicketCheckout({
+    grossCents: args.discountedSubtotalCents,
+    platformFeeEnabled: args.platformFeeEnabled,
+    platformFeeRate: args.platformFeeRate,
+    feeHandling: args.feeHandling,
+    bashPassWaivesGuestFee: args.bashPassWaivesGuestFee,
+  });
+  const guestPlatformLineCents = split.guestPlatformLineCents;
+  const bashPlatformTotalCents = split.totalPlatformCents;
+  const totalChargedCents = args.discountedSubtotalCents + guestPlatformLineCents;
+  const stripeProcessingCents = calculateStripeProcessingFeeCents(totalChargedCents);
+  const applicationFeeAmountCents = stripeProcessingCents + bashPlatformTotalCents;
+  return {
+    totalChargedCents,
+    stripeProcessingCents,
+    bashPlatformTotalCents,
+    applicationFeeAmountCents,
+    guestPlatformLineCents,
+  };
+}
+
+export function userHasActiveBashPass(user: {
+  bashPassStripeSubscriptionId: string | null | undefined;
+  bashPassCurrentPeriodEnd: Date | null | undefined;
+}): boolean {
+  if (!user.bashPassStripeSubscriptionId) return false;
+  if (!user.bashPassCurrentPeriodEnd) return true;
+  return user.bashPassCurrentPeriodEnd > new Date();
+}
+
 // ============================================
 // VENUE PRICING PLANS
 // ============================================