@bash-app/bash-common 30.118.0 → 30.119.0

package/src/definitions.ts

@@ -354,6 +354,7 @@ export type FilterFields = {
   specialOffers: string[];
   eventFormat: string[];
   hasOpenTasks: boolean; // Boolean filter for events with open volunteer tasks
+  acceptsBashPoints: boolean; // Boolean filter for events with BashPoints-priced tickets
 };
 
 export type ApiEntityApproval = {
@@ -362,6 +363,8 @@ export type ApiEntityApproval = {
 
 export type TicketTierWherePriceIsAString = Omit<TicketTier, "price"> & {
   price: string;
+  pricingType?: string; // 'USD' or 'BASHCASH'
+  priceBashPoints?: string; // Price in BashPoints credits (string for form input)
 } & { cannotDelete: boolean };
 
 export type ApiServiceAddonParams = {

package/src/index.ts

@@ -9,7 +9,7 @@ export * from "./utils/addressUtils";
 export * from "./utils/apiUtils";
 export * from "./utils/arrayUtils";
 export * from "./utils/awsS3Utils";
-export * from "./utils/bashCashPaymentUtils";
+export * from "./utils/bashPointsPaymentUtils";
 export * from "./utils/contentFilterUtils";
 export * from "./utils/dateTimeUtils";
 export * from "./utils/discountEngine/bestPriceResolver";

package/src/membershipDefinitions.ts

@@ -90,7 +90,7 @@ export const MEMBERSHIP_PRICING = {
   Legend: { monthly: 99900, yearly: 1000000 }, // $999/month, $10,000/year
 };
 
-// Helper: Get monthly price in cents for a tier (for BashCash calculations)
+// Helper: Get monthly price in cents for a tier (for BashPoints calculations)
 export const MEMBERSHIP_MONTHLY_PRICE_CENTS: Record<MembershipTier, number> = {
   Basic: MEMBERSHIP_PRICING.Basic.monthly,
   Creator: MEMBERSHIP_PRICING.Creator.monthly,
@@ -104,59 +104,63 @@ export const MEMBERSHIP_TIER_HIERARCHY: MembershipTier[] = [
 ];
 
 // ============================================================================
-// BASHCASH REWARDS SYSTEM
+// BASHPOINTS REWARDS SYSTEM
 // ============================================================================
 
 /**
- * BashCash rewards per membership tier
- * All amounts in CENTS (1 credit = 1 cent = $0.01)
+ * BashPoints rewards per membership tier
+ * Points are loyalty rewards with floating market value (like airline miles)
  */
-export const BASHCASH_REWARDS: Record<MembershipTier, {
-  monthlyCredits: number;      // Credits earned per month
+export const BASHPOINTS_REWARDS: Record<MembershipTier, {
+  monthlyCredits: number;      // Points earned per month
   ticketCashbackRate: number;  // Cashback % on ticket purchases
   serviceCashbackRate: number; // Cashback % on service bookings
 }> = {
   Basic: { 
     monthlyCredits: 0,
-    ticketCashbackRate: 0,
-    serviceCashbackRate: 0,
+    ticketCashbackRate: 0.01,   // 1% cashback
+    serviceCashbackRate: 0.01,  // 1% cashback
   },
   Creator: { 
-    monthlyCredits: 10000,      // 10,000 credits = $100/month
-    ticketCashbackRate: 0.05,   // 5% cashback
-    serviceCashbackRate: 0.03,  // 3% cashback
+    monthlyCredits: 10000,      // 10,000 BashPoints/month
+    ticketCashbackRate: 0.03,   // 3% cashback
+    serviceCashbackRate: 0.02,  // 2% cashback
   },
   Pro: { 
-    monthlyCredits: 40000,      // 40,000 credits = $400/month
+    monthlyCredits: 40000,      // 40,000 BashPoints/month
     ticketCashbackRate: 0.05,   // 5% cashback
     serviceCashbackRate: 0.03,  // 3% cashback
   },
   Elite: { 
-    monthlyCredits: 120000,     // 120,000 credits = $1,200/month
-    ticketCashbackRate: 0.05,   // 5% cashback
-    serviceCashbackRate: 0.03,  // 3% cashback
+    monthlyCredits: 120000,     // 120,000 BashPoints/month
+    ticketCashbackRate: 0.07,   // 7% cashback
+    serviceCashbackRate: 0.04,  // 4% cashback
   },
   Legend: { 
-    monthlyCredits: 250000,     // 250,000 credits = $2,500/month
-    ticketCashbackRate: 0.05,   // 5% cashback
-    serviceCashbackRate: 0.03,  // 3% cashback
+    monthlyCredits: 250000,     // 250,000 BashPoints/month
+    ticketCashbackRate: 0.10,   // 10% cashback
+    serviceCashbackRate: 0.05,  // 5% cashback
   },
 } as const;
 
 /**
- * BashCash system rules and limits
+ * BashPoints system rules and limits
+ * 
+ * IMPORTANT: BashPoints is a LOYALTY POINTS SYSTEM with floating market value.
+ * Credits do NOT have a fixed dollar conversion rate.
+ * Hosts/providers set their own BashPoints prices for tickets and services.
  */
-export const BASHCASH_CONFIG = {
+export const BASHPOINTS_CONFIG = {
   // Referral bonuses
-  referralBonusRate: 0.10,           // 10% of referee's first purchase
-  maxReferralCredits: 10000,         // $100 cap on referral bonuses
+  referralBonusRate: 0.10,           // 10% of referee's first USD purchase (in credits)
+  maxReferralCredits: 10000,         // 10,000 credit cap on referral bonuses
   
   // Credit lifecycle
   creditExpirationMonths: 12,        // Credits expire after 12 months
   
-  // Redemption rules
-  minimumRedemption: 100,            // $1 minimum redemption (100 credits)
-  membershipRedemptionCap: 0.50,     // 50% max BashCash for membership fees
+  // Redemption rules (deprecated for floating value system)
+  minimumRedemption: 100,            // Legacy: was used for fixed-value redemptions
+  membershipRedemptionCap: 0.50,     // NOT USED: Can't pay memberships with BashPoints (no fixed value)
 } as const;
 
 // ============================================================================

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));
-}
-