@bash-app/bash-common 30.95.0 → 30.96.0

package/src/membershipDefinitions.ts

@@ -90,10 +90,559 @@ 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)
+export const MEMBERSHIP_MONTHLY_PRICE_CENTS: Record<MembershipTier, number> = {
+  Basic: MEMBERSHIP_PRICING.Basic.monthly,
+  Creator: MEMBERSHIP_PRICING.Creator.monthly,
+  Pro: MEMBERSHIP_PRICING.Pro.monthly,
+  Elite: MEMBERSHIP_PRICING.Elite.monthly,
+  Legend: MEMBERSHIP_PRICING.Legend.monthly,
+};
+
 export const MEMBERSHIP_TIER_HIERARCHY: MembershipTier[] = [
   'Basic', 'Creator', 'Pro', 'Elite', 'Legend'
 ];
 
+// ============================================================================
+// BASHCASH REWARDS SYSTEM
+// ============================================================================
+
+/**
+ * BashCash rewards per membership tier
+ * All amounts in CENTS (1 credit = 1 cent = $0.01)
+ */
+export const BASHCASH_REWARDS: Record<MembershipTier, {
+  monthlyCredits: number;      // Credits earned per month
+  ticketCashbackRate: number;  // Cashback % on ticket purchases
+  serviceCashbackRate: number; // Cashback % on service bookings
+}> = {
+  Basic: { 
+    monthlyCredits: 0,
+    ticketCashbackRate: 0,
+    serviceCashbackRate: 0,
+  },
+  Creator: { 
+    monthlyCredits: 10000,      // 10,000 credits = $100/month
+    ticketCashbackRate: 0.05,   // 5% cashback
+    serviceCashbackRate: 0.03,  // 3% cashback
+  },
+  Pro: { 
+    monthlyCredits: 40000,      // 40,000 credits = $400/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
+  },
+  Legend: { 
+    monthlyCredits: 250000,     // 250,000 credits = $2,500/month
+    ticketCashbackRate: 0.05,   // 5% cashback
+    serviceCashbackRate: 0.03,  // 3% cashback
+  },
+} as const;
+
+/**
+ * BashCash system rules and limits
+ */
+export const BASHCASH_CONFIG = {
+  // Referral bonuses
+  referralBonusRate: 0.10,           // 10% of referee's first purchase
+  maxReferralCredits: 10000,         // $100 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
+} as const;
+
+// ============================================================================
+// SCOUT/AGENT REFERRAL PROGRAM
+// ============================================================================
+
+/**
+ * Scout program configuration for service provider referrals
+ */
+export const SCOUT_PROGRAM_CONFIG = {
+  creditsPerProfile: 75,             // 75 credits per service profile created
+  maxProfilesPerScout: 3,            // Max 3 profiles per scout
+  scoutCommissionRate: 0.03,         // 3% commission on completed bookings
+  agentCommissionRate: 0.06,         // 6% commission (upgraded status)
+  agentThreshold: 5,                 // 5+ service profiles = Agent status
+} as const;
+
+// ============================================================================
+// SECURITY & ACCOUNT PROTECTION
+// ============================================================================
+
+/**
+ * Security configuration for account protection and rate limiting
+ */
+export const SECURITY_CONFIG = {
+  // Failed login tracking
+  maxFailedLoginAttempts: 5,         // Lock account after 5 failed attempts
+  lockoutDurationMinutes: 30,        // Lock account for 30 minutes
+  trackingWindowMinutes: 15,         // Track attempts within 15-minute window
+  suspiciousActivityThreshold: 3,    // Alert if 3+ accounts locked from same IP
+  
+  // Geofencing
+  geofenceDefaultRadiusFeet: 500,    // Default geofence radius (feet)
+  geofenceCheckIntervalMs: 60000,    // Check geofence every 60 seconds
+} as const;
+
+// ============================================================================
+// PLATFORM FEES & PRICING
+// ============================================================================
+
+/**
+ * Platform fee structure for Bash Events (tickets/donations)
+ * All amounts in CENTS to align with Stripe
+ */
+export const BASH_EVENT_FEES: Record<MembershipTier, {
+  percent: number;        // Fee percentage (e.g., 0.10 = 10%)
+  minimumCents: number;   // Minimum fee in cents (e.g., 50 = $0.50)
+  capCents: number;       // Maximum fee in cents (e.g., 25000 = $250)
+}> = {
+  Basic: {
+    percent: 0.10,        // 10%
+    minimumCents: 50,     // $0.50 minimum
+    capCents: 25000,      // $250 cap
+  },
+  Creator: {
+    percent: 0.06,        // 6% (40% discount)
+    minimumCents: 50,     // $0.50 minimum
+    capCents: 15000,      // $150 cap
+  },
+  Pro: {
+    percent: 0.08,        // 8% (20% discount)
+    minimumCents: 50,     // $0.50 minimum
+    capCents: 20000,      // $200 cap
+  },
+  Elite: {
+    percent: 0.04,        // 4% (60% discount)
+    minimumCents: 50,     // $0.50 minimum
+    capCents: 10000,      // $100 cap
+  },
+  Legend: {
+    percent: 0.02,        // 2% (80% discount)
+    minimumCents: 50,     // $0.50 minimum
+    capCents: 5000,       // $50 cap
+  },
+} as const;
+
+/**
+ * Platform fee structure for Service Bookings (Allies/Patrons)
+ * All amounts in CENTS to align with Stripe
+ */
+export const SERVICE_BOOKING_FEES: Record<MembershipTier, {
+  percent: number;        // Fee percentage (e.g., 0.15 = 15%)
+  capCents: number;       // Maximum fee in cents
+}> = {
+  Basic: {
+    percent: 0.15,        // 15%
+    capCents: 37500,      // $375 cap
+  },
+  Creator: {
+    percent: 0.09,        // 9% (40% discount)
+    capCents: 22500,      // $225 cap
+  },
+  Pro: {
+    percent: 0.12,        // 12% (20% discount)
+    capCents: 30000,      // $300 cap
+  },
+  Elite: {
+    percent: 0.06,        // 6% (60% discount)
+    capCents: 15000,      // $150 cap
+  },
+  Legend: {
+    percent: 0.05,        // 5% (67% discount, sustainable floor)
+    capCents: 7500,       // $75 cap
+  },
+} as const;
+
+/**
+ * Platform fee structure for Partner Payments (Vendors/Exhibitors/Sponsors)
+ * All amounts in CENTS to align with Stripe
+ */
+export const PARTNER_PAYMENT_FEES: Record<MembershipTier, {
+  percent: number;        // Fee percentage (e.g., 0.08 = 8%)
+  capCents: number;       // Maximum fee in cents
+}> = {
+  Basic: {
+    percent: 0.08,        // 8%
+    capCents: 20000,      // $200 cap
+  },
+  Creator: {
+    percent: 0.05,        // 5% (37.5% discount, sustainable floor)
+    capCents: 12500,      // $125 cap
+  },
+  Pro: {
+    percent: 0.06,        // 6% (25% discount)
+    capCents: 15000,      // $150 cap
+  },
+  Elite: {
+    percent: 0.05,        // 5% (same as Creator, sustainable floor)
+    capCents: 7500,       // $75 cap
+  },
+  Legend: {
+    percent: 0.05,        // 5% (same as Creator/Elite, sustainable floor)
+    capCents: 7500,       // $75 cap
+  },
+} as const;
+
+/**
+ * General platform pricing rules
+ */
+export const PLATFORM_PRICING_CONFIG = {
+  // Ticket pricing
+  minimumTicketPriceCents: 500,      // $5 minimum ticket price (quality signal)
+  minimumPlatformFeeCents: 50,       // $0.50 minimum platform fee (covers Stripe)
+  
+  // Membership trial
+  creatorTrialDays: 30,               // 30-day free trial for Creator tier
+} as const;
+
+// Legacy export for backward compatibility with existing API code
+export const CREATOR_TIER_TRIAL_DAYS = PLATFORM_PRICING_CONFIG.creatorTrialDays;
+
+// ============================================================================
+// PLATFORM FEE CALCULATION UTILITIES
+// ============================================================================
+
+/**
+ * Calculate platform fee for a Bash Event (ticket/donation)
+ * @param amountCents - Transaction amount in cents
+ * @param membershipTier - User's membership tier
+ * @returns Platform fee in cents
+ */
+export function calculateBashEventFee(amountCents: number, membershipTier: MembershipTier): number {
+  const config = BASH_EVENT_FEES[membershipTier];
+  
+  // Calculate percentage-based fee
+  let fee = Math.floor(amountCents * config.percent);
+  
+  // Apply minimum fee
+  fee = Math.max(fee, config.minimumCents);
+  
+  // Apply cap
+  fee = Math.min(fee, config.capCents);
+  
+  return fee;
+}
+
+/**
+ * Calculate platform fee for a Service Booking
+ * @param amountCents - Transaction amount in cents
+ * @param membershipTier - User's membership tier
+ * @returns Platform fee in cents
+ */
+export function calculateServiceBookingFee(amountCents: number, membershipTier: MembershipTier): number {
+  const config = SERVICE_BOOKING_FEES[membershipTier];
+  
+  // Calculate percentage-based fee
+  let fee = Math.floor(amountCents * config.percent);
+  
+  // Apply cap
+  fee = Math.min(fee, config.capCents);
+  
+  return fee;
+}
+
+/**
+ * Calculate platform fee for a Partner Payment
+ * @param amountCents - Transaction amount in cents
+ * @param membershipTier - User's membership tier
+ * @returns Platform fee in cents
+ */
+export function calculatePartnerPaymentFee(amountCents: number, membershipTier: MembershipTier): number {
+  const config = PARTNER_PAYMENT_FEES[membershipTier];
+  
+  // Calculate percentage-based fee
+  let fee = Math.floor(amountCents * config.percent);
+  
+  // Apply cap
+  fee = Math.min(fee, config.capCents);
+  
+  return fee;
+}
+
+// ============================================================================
+// MEMBERSHIP TIER LIMITS & RULES
+// ============================================================================
+
+/**
+ * Comprehensive limits and rules per membership tier
+ * Defines what each tier can and cannot do on the platform
+ */
+export const MEMBERSHIP_LIMITS: Record<MembershipTier, {
+  // Event Creation
+  canCreateEvents: boolean;
+  minimumTicketPriceCents: number | null;     // null = no minimum (Creator+)
+  maxEventsPerMonth: number;                   // -1 = unlimited
+  featuredEventsPerMonth: number;              // 0 = must pay, -1 = unlimited
+  
+  // Analytics & Insights
+  analyticsAccess: boolean;
+  advancedAnalytics: boolean;                  // Conversion trends, heatmaps
+  
+  // Service Provider Features
+  vendorDirectoryAccess: boolean;              // Can list services
+  maxServiceListings: number;                  // -1 = unlimited
+  
+  // Monetization Tools
+  canCreatePromoCodes: boolean;
+  canSetCustomPricing: boolean;
+  
+  // Platform Perks
+  prioritySearchPlacement: boolean;            // Priority in search results
+  homepageVisibility: boolean;                 // Featured on homepage
+  tierBadgeDisplay: boolean;                   // Show tier badge
+  
+  // Support & Access
+  prioritySupport: boolean;                    // Live chat/email priority
+  conciergeSupport: boolean;                   // White-glove service
+  betaFeatureAccess: boolean;                  // Early access to new features
+  
+  // Exclusive Access
+  accessExclusiveEvents: boolean;              // Creator-only, Elite-only, Legend-only events
+  bashSponsoredInvites: boolean;               // Free invites to Bash-sponsored events
+  networkingMixers: boolean;                   // Exclusive networking events
+  
+  // Business Tools
+  advancedMonetization: boolean;               // Revenue tracking, payouts
+  marketingCampaigns: boolean;                 // Automated email campaigns
+  leadGeneration: boolean;                     // Lead capture tools
+}> = {
+  Basic: {
+    // Event Creation
+    canCreateEvents: true,
+    minimumTicketPriceCents: 500,              // $5 minimum
+    maxEventsPerMonth: -1,                     // Unlimited
+    featuredEventsPerMonth: 0,                 // Must pay
+    
+    // Analytics & Insights
+    analyticsAccess: false,
+    advancedAnalytics: false,
+    
+    // Service Provider Features
+    vendorDirectoryAccess: false,
+    maxServiceListings: 0,
+    
+    // Monetization Tools
+    canCreatePromoCodes: false,
+    canSetCustomPricing: false,
+    
+    // Platform Perks
+    prioritySearchPlacement: false,
+    homepageVisibility: false,
+    tierBadgeDisplay: false,
+    
+    // Support & Access
+    prioritySupport: false,
+    conciergeSupport: false,
+    betaFeatureAccess: false,
+    
+    // Exclusive Access
+    accessExclusiveEvents: false,
+    bashSponsoredInvites: false,
+    networkingMixers: false,
+    
+    // Business Tools
+    advancedMonetization: false,
+    marketingCampaigns: false,
+    leadGeneration: false,
+  },
+  
+  Creator: {
+    // Event Creation
+    canCreateEvents: true,
+    minimumTicketPriceCents: null,             // No minimum!
+    maxEventsPerMonth: -1,                     // Unlimited
+    featuredEventsPerMonth: 0,                 // Must pay (but eligible)
+    
+    // Analytics & Insights
+    analyticsAccess: false,
+    advancedAnalytics: false,
+    
+    // Service Provider Features
+    vendorDirectoryAccess: false,
+    maxServiceListings: 0,
+    
+    // Monetization Tools
+    canCreatePromoCodes: true,                 // ✅
+    canSetCustomPricing: true,                 // ✅
+    
+    // Platform Perks
+    prioritySearchPlacement: false,
+    homepageVisibility: false,
+    tierBadgeDisplay: false,
+    
+    // Support & Access
+    prioritySupport: false,
+    conciergeSupport: false,
+    betaFeatureAccess: true,                   // ✅ Early beta access
+    
+    // Exclusive Access
+    accessExclusiveEvents: true,               // ✅ Creator-only events
+    bashSponsoredInvites: false,
+    networkingMixers: false,
+    
+    // Business Tools
+    advancedMonetization: false,
+    marketingCampaigns: false,
+    leadGeneration: false,
+  },
+  
+  Pro: {
+    // Event Creation
+    canCreateEvents: true,
+    minimumTicketPriceCents: null,             // No minimum
+    maxEventsPerMonth: -1,                     // Unlimited
+    featuredEventsPerMonth: 1,                 // ✅ 1 free/month
+    
+    // Analytics & Insights
+    analyticsAccess: true,                     // ✅ Basic analytics
+    advancedAnalytics: false,
+    
+    // Service Provider Features
+    vendorDirectoryAccess: true,               // ✅ Can list services
+    maxServiceListings: 3,                     // 3 service listings
+    
+    // Monetization Tools
+    canCreatePromoCodes: true,
+    canSetCustomPricing: true,
+    
+    // Platform Perks
+    prioritySearchPlacement: true,             // ✅ Priority placement
+    homepageVisibility: false,
+    tierBadgeDisplay: true,                    // ✅ Show Pro badge
+    
+    // Support & Access
+    prioritySupport: false,
+    conciergeSupport: false,
+    betaFeatureAccess: true,
+    
+    // Exclusive Access
+    accessExclusiveEvents: true,
+    bashSponsoredInvites: false,
+    networkingMixers: false,
+    
+    // Business Tools
+    advancedMonetization: false,
+    marketingCampaigns: false,
+    leadGeneration: false,
+  },
+  
+  Elite: {
+    // Event Creation
+    canCreateEvents: true,
+    minimumTicketPriceCents: null,             // No minimum
+    maxEventsPerMonth: -1,                     // Unlimited
+    featuredEventsPerMonth: 3,                 // ✅ 3 free/month
+    
+    // Analytics & Insights
+    analyticsAccess: true,
+    advancedAnalytics: true,                   // ✅ Advanced analytics
+    
+    // Service Provider Features
+    vendorDirectoryAccess: true,
+    maxServiceListings: 10,                    // 10 service listings
+    
+    // Monetization Tools
+    canCreatePromoCodes: true,
+    canSetCustomPricing: true,
+    
+    // Platform Perks
+    prioritySearchPlacement: true,
+    homepageVisibility: true,                  // ✅ Homepage featured
+    tierBadgeDisplay: true,                    // ✅ Gold Elite badge
+    
+    // Support & Access
+    prioritySupport: true,                     // ✅ Priority support
+    conciergeSupport: true,                    // ✅ Concierge service
+    betaFeatureAccess: true,
+    
+    // Exclusive Access
+    accessExclusiveEvents: true,               // ✅ Elite-only events
+    bashSponsoredInvites: true,                // ✅ Free Bash invites
+    networkingMixers: false,
+    
+    // Business Tools
+    advancedMonetization: true,                // ✅ Revenue tools
+    marketingCampaigns: true,                  // ✅ Email campaigns
+    leadGeneration: true,                      // ✅ Lead capture
+  },
+  
+  Legend: {
+    // Event Creation
+    canCreateEvents: true,
+    minimumTicketPriceCents: null,             // No minimum
+    maxEventsPerMonth: -1,                     // Unlimited
+    featuredEventsPerMonth: -1,                // ✅ Unlimited featured events!
+    
+    // Analytics & Insights
+    analyticsAccess: true,
+    advancedAnalytics: true,
+    
+    // Service Provider Features
+    vendorDirectoryAccess: true,
+    maxServiceListings: -1,                    // ✅ Unlimited services
+    
+    // Monetization Tools
+    canCreatePromoCodes: true,
+    canSetCustomPricing: true,
+    
+    // Platform Perks
+    prioritySearchPlacement: true,
+    homepageVisibility: true,                  // ✅ Homepage rotation
+    tierBadgeDisplay: true,                    // ✅ Platinum Legend badge
+    
+    // Support & Access
+    prioritySupport: true,
+    conciergeSupport: true,
+    betaFeatureAccess: true,
+    
+    // Exclusive Access
+    accessExclusiveEvents: true,               // ✅ All exclusive events
+    bashSponsoredInvites: true,
+    networkingMixers: true,                    // ✅ Exclusive networking
+    
+    // Business Tools
+    advancedMonetization: true,
+    marketingCampaigns: true,
+    leadGeneration: true,
+  },
+} as const;
+
+/**
+ * Check if a user has access to a specific feature based on their tier
+ * @param userTier - User's membership tier
+ * @param feature - Feature to check (key from MEMBERSHIP_LIMITS)
+ * @returns true if user has access
+ */
+export function hasFeatureLimit(
+  userTier: MembershipTier,
+  feature: keyof typeof MEMBERSHIP_LIMITS[MembershipTier]
+): boolean {
+  return Boolean(MEMBERSHIP_LIMITS[userTier][feature]);
+}
+
+/**
+ * Get the limit value for a specific feature
+ * @param userTier - User's membership tier
+ * @param limit - Limit to check (e.g., 'maxEventsPerMonth')
+ * @returns Limit value (-1 = unlimited, 0 = none, positive number = limit)
+ */
+export function getFeatureLimit(
+  userTier: MembershipTier,
+  limit: keyof typeof MEMBERSHIP_LIMITS[MembershipTier]
+): number | boolean | null {
+  return MEMBERSHIP_LIMITS[userTier][limit];
+}
+
 export const MEMBERSHIP_FEATURES = {
   // Core Creator features
   NO_MINIMUM_TICKET_PRICE: 'no_minimum_ticket_price',