@bash-app/bash-common 30.118.1 → 30.120.0

package/src/utils/bashPointsPaymentUtils.ts

@@ -0,0 +1,107 @@
+/**
+ * BashPoints Utilities
+ * 
+ * BashPoints is a loyalty rewards program where:
+ * 1. Users EARN BashPoints as cashback on USD purchases (tickets & services)
+ * 2. Users SPEND BashPoints ONLY on BashPoints-priced tickets (floating market value set by hosts)
+ * 
+ * BashPoints have NO fixed dollar value - hosts set prices freely (e.g., "500 points for entry")
+ * This is a peer-to-peer points exchange system, NOT a stored value currency.
+ */
+
+/**
+ * Format BashPoints for display
+ * @param points BashPoints amount
+ * @returns Formatted string (e.g., "28,750 points")
+ */
+export function formatBashPoints(points: number): string {
+  return `${points.toLocaleString('en-US')} point${points === 1 ? '' : 's'}`;
+}
+
+/**
+ * Calculate BashPoints cashback earned on a USD purchase
+ * Uses tiered rates based on membership level (handled by membership tier definitions)
+ * 
+ * @param amountCents Amount paid in USD cents
+ * @param cashbackRate Cashback rate (e.g., 0.05 for 5%)
+ * @returns BashPoints earned (1 cent = 1 point for earning calculation)
+ */
+export function calculateBashPointsCashback(
+  amountCents: number,
+  cashbackRate: number
+): number {
+  // Award 1 point per cent spent, multiplied by cashback rate
+  // Example: $10.00 (1000 cents) at 5% = 50 points
+  return Math.floor(amountCents * cashbackRate);
+}
+
+// =====================================================================
+// DEPRECATED FUNCTIONS - Service Booking Payments Removed
+// BashPoints can ONLY be spent on BashPoints-priced tickets, not service bookings
+// =====================================================================
+
+/**
+ * @deprecated BashPoints cannot be used for service bookings
+ * Only for BashPoints-priced tickets with floating market value
+ */
+export function centsToBashPoints(cents: number): number {
+  console.warn('DEPRECATED: centsToBashPoints - BashPoints have no fixed dollar value');
+  return cents; // Keep for backward compatibility but log warning
+}
+
+/**
+ * @deprecated BashPoints cannot be used for service bookings
+ * Only for BashPoints-priced tickets with floating market value
+ */
+export function bashPointsToCents(credits: number): number {
+  console.warn('DEPRECATED: bashPointsToCents - BashPoints have no fixed dollar value');
+  return credits; // Keep for backward compatibility but log warning
+}
+
+/**
+ * @deprecated BashPoints cannot be used for service bookings
+ */
+export function calculateMaxBashPointsForBooking(
+  totalCents: number,
+  userBalance: number
+): number {
+  console.warn('DEPRECATED: calculateMaxBashPointsForBooking - BashPoints not supported for service bookings');
+  return 0;
+}
+
+/**
+ * @deprecated BashPoints cannot be used for service bookings
+ */
+export function calculateSplitPayment(
+  totalCents: number,
+  bashPointsToUse: number
+): {
+  bashPointsCents: number;
+  stripeCents: number;
+  bashPointsCredits: number;
+} {
+  console.warn('DEPRECATED: calculateSplitPayment - BashPoints not supported for service bookings');
+  return {
+    bashPointsCents: 0,
+    stripeCents: totalCents,
+    bashPointsCredits: 0,
+  };
+}
+
+/**
+ * @deprecated BashPoints cannot be used for service bookings
+ */
+export function validateBashPointsPayment(
+  bashPointsToUse: number,
+  userBalance: number,
+  totalCents: number
+): {
+  valid: boolean;
+  errorMessage?: string;
+} {
+  return {
+    valid: false,
+    errorMessage: "BashPoints can only be used for BashPoints-priced tickets, not service bookings. Please pay with a credit card.",
+  };
+}
+

package/src/utils/index.ts

@@ -3,7 +3,7 @@ export * from './apiUtils';
 export * from './arrayUtils';
 export * from './awsS3Utils';
 export * from './badgeUtils';
-export * from './bashCashPaymentUtils';
+export * from './bashPointsPaymentUtils';
 export * from './blog/blogDbUtils';
 export * from './blogUtils';
 export * from './contentFilterUtils';

package/src/utils/ticketListUtils.ts

@@ -13,8 +13,50 @@ import {
   LUXON_DATETIME_FORMAT_ISO_LIKE,
 } from "./luxonUtils";
 
+/**
+ * Encodes a string to Base64 URL-safe format
+ * Replaces + with -, / with _, and removes = padding
+ */
+function encodeBase64UrlSafe(str: string): string {
+  if (typeof window !== "undefined") {
+    // Browser environment
+    return btoa(str)
+      .replace(/\+/g, "-")
+      .replace(/\//g, "_")
+      .replace(/=/g, "");
+  } else {
+    // Node environment
+    return Buffer.from(str)
+      .toString("base64")
+      .replace(/\+/g, "-")
+      .replace(/\//g, "_")
+      .replace(/=/g, "");
+  }
+}
+
+/**
+ * Decodes a Base64 URL-safe string
+ * Replaces - with +, _ with /, and adds back = padding
+ */
+function decodeBase64UrlSafe(str: string): string {
+  // Add back padding
+  let base64 = str.replace(/-/g, "+").replace(/_/g, "/");
+  while (base64.length % 4) {
+    base64 += "=";
+  }
+  
+  if (typeof window !== "undefined") {
+    // Browser environment
+    return atob(base64);
+  } else {
+    // Node environment
+    return Buffer.from(base64, "base64").toString();
+  }
+}
+
 /**
  * Returns A string structured like: [ticketTierId]__[numberOfTickets];;[date]~~[numberOfTickets];;[date]~~,...
+ * The returned string is Base64 URL-safe encoded to prevent routing issues
  * @param ticketList A map where the key is the ticketTierId
  */
 export function ticketListToString(
@@ -23,51 +65,63 @@ export function ticketListToString(
   const ticketListArr: string[] = [];
 
   for (const [ticketTierId, ticketListArgs] of ticketList.entries()) {
-    let ticketsExist = true;
     const ticketArgs: string[] = [
       `${ticketTierId}${URL_PARAMS_TICKET_TIER_ID_NUMBER_OF_TICKETS_DATE_DELIM}`,
     ];
+    let hasAnyTickets = false; // Track if we added ANY valid tickets for this tier
+    
     for (const ticketNumAndDates of ticketListArgs) {
       if (ticketNumAndDates.numberOfTickets > 0) {
-        ticketsExist = true;
+        hasAnyTickets = true;
 
-        // Ensure ticketDateTime is in ISO format
+        // Ensure ticketDateTime is in ISO format (URL-safe)
         let dateTimeStr = ticketNumAndDates.ticketDateTime;
         if (dateTimeStr) {
           // If it's already a string, try to parse it as DateTime and convert to ISO
           const dateTime = dateTimeFromDate(dateTimeStr);
           if (dateTime.isValid) {
-            dateTimeStr = dateTimeFormat(dateTime) || dateTimeStr;
+            dateTimeStr = dateTime.toISO() || dateTimeStr;
           }
         }
 
         ticketArgs.push(
           `${ticketNumAndDates.numberOfTickets}${URL_PARAMS_TICKETS_DATE_DELIM}${dateTimeStr}`
         );
-      } else {
-        ticketsExist = false;
       }
     }
-    if (ticketsExist) {
+    
+    // Only include this tier if we found at least one ticket > 0
+    if (hasAnyTickets) {
       ticketListArr.push(
         ticketArgs.join(URL_PARAMS_NUMBER_OF_TICKETS_TICKETS_DATE_DELIM)
       );
     }
   }
-  return ticketListArr.join(URL_PARAMS_TICKET_LIST_DELIM);
+  const plainString = ticketListArr.join(URL_PARAMS_TICKET_LIST_DELIM);
+  return encodeBase64UrlSafe(plainString);
 }
 
 /**
  * Returns map where the key is the ticketTierId
- * @param ticketListStr A string structured like: [ticketTierId]__[numberOfTickets];;[date]~~[numberOfTickets];;[date]~~...,...
+ * @param ticketListStr A Base64 URL-safe encoded string that decodes to: [ticketTierId]__[numberOfTickets];;[date]~~[numberOfTickets];;[date]~~...,...
  */
 export function ticketListStrToTicketList(
   ticketListStr: string
 ): Map<string, NumberOfTicketsForDate[]> {
   const ticketList: Map<string, NumberOfTicketsForDate[]> = new Map();
 
+  // Decode the Base64 URL-safe string first
+  let decodedStr: string;
+  try {
+    decodedStr = decodeBase64UrlSafe(ticketListStr);
+  } catch (error) {
+    console.error("Failed to decode ticketListStr:", error);
+    // If decoding fails, try using the string as-is (for backward compatibility)
+    decodedStr = ticketListStr;
+  }
+
   // [ticketTierId]__~~[numberOfTickets];;[date]~~[numberOfTickets];;[date]~~...,...
-  const ticketListArgs = ticketListStr.split(URL_PARAMS_TICKET_LIST_DELIM);
+  const ticketListArgs = decodedStr.split(URL_PARAMS_TICKET_LIST_DELIM);
 
   ticketListArgs.forEach((tierIdAndTicketNumbersAndDates: string): void => {
     const ticketNumAndDatesArr: NumberOfTicketsForDate[] = [];

package/src/utils/bashCashPaymentUtils.ts

@@ -1,146 +0,0 @@
-/**
- * BashCash Payment Utilities
- * Handles calculations and conversions for BashCash payment system
- */
-
-// 1 BashCash credit = 1 cent = $0.01
-export const BASHCASH_TO_CENTS_RATE = 1;
-export const CENTS_TO_BASHCASH_RATE = 1;
-
-/**
- * Convert USD cents to BashCash credits
- * @param cents Amount in cents (e.g., 28750 = $287.50)
- * @returns BashCash credits (e.g., 28750 credits)
- */
-export function centsToBashCash(cents: number): number {
-  return Math.floor(cents * CENTS_TO_BASHCASH_RATE);
-}
-
-/**
- * Convert BashCash credits to USD cents
- * @param credits BashCash credits (e.g., 28750 credits)
- * @returns Amount in cents (e.g., 28750 = $287.50)
- */
-export function bashCashToCents(credits: number): number {
-  return Math.floor(credits * BASHCASH_TO_CENTS_RATE);
-}
-
-/**
- * Format BashCash credits for display
- * @param credits BashCash credits
- * @returns Formatted string (e.g., "28,750 credits")
- */
-export function formatBashCash(credits: number): string {
-  return `${credits.toLocaleString('en-US')} credit${credits === 1 ? '' : 's'}`;
-}
-
-/**
- * Format BashCash credits with USD equivalent
- * @param credits BashCash credits
- * @returns Formatted string (e.g., "28,750 credits ($287.50)")
- */
-export function formatBashCashWithUSD(credits: number): string {
-  const cents = bashCashToCents(credits);
-  const dollars = (cents / 100).toFixed(2);
-  return `${formatBashCash(credits)} ($${dollars})`;
-}
-
-/**
- * Calculate maximum BashCash that can be used for a booking
- * @param totalCents Total booking cost in cents
- * @param userBalance User's BashCash balance in credits
- * @returns Maximum BashCash credits that can be applied
- */
-export function calculateMaxBashCashForBooking(
-  totalCents: number,
-  userBalance: number
-): number {
-  // No cap on BashCash usage for service bookings (can pay 100% if they have enough)
-  const maxPossible = centsToBashCash(totalCents);
-  return Math.min(maxPossible, userBalance);
-}
-
-/**
- * Calculate split payment amounts
- * @param totalCents Total booking cost in cents
- * @param bashCashToUse BashCash credits user wants to apply
- * @returns Object with bashCashCents and stripeCents
- */
-export function calculateSplitPayment(
-  totalCents: number,
-  bashCashToUse: number
-): {
-  bashCashCents: number;
-  stripeCents: number;
-  bashCashCredits: number;
-} {
-  const bashCashCents = bashCashToCents(bashCashToUse);
-  const stripeCents = Math.max(0, totalCents - bashCashCents);
-  
-  return {
-    bashCashCents,
-    stripeCents,
-    bashCashCredits: bashCashToUse,
-  };
-}
-
-/**
- * Validate BashCash payment
- * @param bashCashToUse BashCash credits to use
- * @param userBalance User's current balance
- * @param totalCents Total booking cost
- * @returns Validation result
- */
-export function validateBashCashPayment(
-  bashCashToUse: number,
-  userBalance: number,
-  totalCents: number
-): {
-  valid: boolean;
-  errorMessage?: string;
-} {
-  if (bashCashToUse < 0) {
-    return {
-      valid: false,
-      errorMessage: "BashCash amount cannot be negative",
-    };
-  }
-
-  if (bashCashToUse > userBalance) {
-    return {
-      valid: false,
-      errorMessage: `Insufficient BashCash balance. You have ${formatBashCash(userBalance)}, but tried to use ${formatBashCash(bashCashToUse)}.`,
-    };
-  }
-
-  const bashCashCents = bashCashToCents(bashCashToUse);
-  if (bashCashCents > totalCents) {
-    return {
-      valid: false,
-      errorMessage: `BashCash amount ($${(bashCashCents / 100).toFixed(2)}) exceeds booking total ($${(totalCents / 100).toFixed(2)}).`,
-    };
-  }
-
-  return { valid: true };
-}
-
-/**
- * Calculate BashCash cashback for a service booking (3%)
- * @param amountCents Amount paid in cents
- * @returns BashCash credits earned as cashback
- */
-export function calculateServiceBookingCashback(amountCents: number): number {
-  const CASHBACK_RATE = 0.03; // 3% for service bookings
-  return Math.floor((amountCents * CASHBACK_RATE));
-}
-
-/**
- * Calculate BashCash cashback for a ticket purchase (5%)
- * @param amountCents Amount paid in cents
- * @returns BashCash credits earned as cashback
- */
-export function calculateTicketCashback(amountCents: number): number {
-  const CASHBACK_RATE = 0.05; // 5% for ticket purchases
-  return Math.floor((amountCents * CASHBACK_RATE));
-}
-