@bash-app/bash-common 30.155.0 → 30.158.0

package/prisma/schema.prisma

@@ -608,6 +608,9 @@ model BashEvent {
   donationDetails          String?
   absorbDonationFees       Boolean         @default(false)
   absorbTicketFees         Boolean         @default(false)
+  feeHandling             String          @default("GuestPays") // "GuestPays" | "HostAbsorbs" | "Split"
+  topPromoterPrize              String?         // Optional prize label: "Free table for your crew"
+  promoterLeaderboardIsPublic   Boolean         @default(false) // Host opts in to public leaderboard
   showAttendees            Boolean         @default(true)
   servicePreferences       Json? // New tiered status: { "Entertainment": "need", "Sponsors": "booked_closed", ... }
   bookedServices           Json? // Booked service details: { "Entertainment": { serviceId: "...", providerId: "...", bookedAt: "..." }, ... }
@@ -716,6 +719,13 @@ model BashEvent {
   // Analytics Relations
   analyticsPredictions AnalyticsPrediction[]
 
+  // Per-event referral rewards
+  eventReferralRewards EventReferralReward[]
+  eventReferrals       EventReferral[]
+
+  // User night itineraries (events in user's "My Night" plan)
+  userItineraryItems UserItineraryItem[]
+
   // Event series (recurring template instances)
   eventSeriesId String?
   eventSeries   EventSeries? @relation("SeriesEvents", fields: [eventSeriesId], references: [id], onDelete: SetNull)
@@ -724,6 +734,11 @@ model BashEvent {
   budgets Budget[]    @relation("EventBudgets")
   rsvps   EventRSVP[] @relation("EventRSVPs")
 
+  // Groups & page views (Phases 0–4)
+  pageViews        BashEventPageView[]
+  eventGroups      EventGroup[]
+  groupUnlockOffers GroupUnlockOffer[]
+
   @@index([templateId])
   @@index([parentEventId])
   @@index([organizationId])
@@ -794,6 +809,92 @@ model IdeaConfiguration {
   @@index([isActive])
 }
 
+// Per-event referral rewards: host defines tiers (e.g. 3 referrals = free drink)
+model EventReferralReward {
+  id            String   @id @default(cuid())
+  bashEventId   String
+  referralCount Int      // How many referrals needed for this reward
+  rewardType    String   // BashPoints, FreeTicket, FreeDrink, Custom
+  rewardLabel   String   // e.g. "Free drink at the bar"
+  bashPointsAmount Int?  // When rewardType=BashPoints
+  sortOrder     Int      @default(0)
+  createdAt     DateTime @default(now())
+  updatedAt     DateTime @updatedAt
+
+  bashEvent BashEvent @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+
+  @@index([bashEventId])
+}
+
+// Tracks referrals: attendee A referred person B who bought a ticket
+model EventReferral {
+  id              String   @id @default(cuid())
+  bashEventId     String
+  referrerId      String   // Attendee who shared their link
+  referredUserId  String   // Person who bought via the link
+  ticketId        String?  @unique // Ticket purchased (optional, 1:1 with Ticket)
+  createdAt       DateTime @default(now())
+
+  bashEvent    BashEvent @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  referrer     User      @relation("EventReferralsMade", fields: [referrerId], references: [id], onDelete: Cascade)
+  referredUser User      @relation("EventReferralsReceived", fields: [referredUserId], references: [id], onDelete: Cascade)
+  ticket       Ticket?   @relation(fields: [ticketId], references: [id], onDelete: SetNull)
+
+  @@unique([bashEventId, referrerId, referredUserId])
+  @@index([bashEventId])
+  @@index([referrerId])
+}
+
+// Curated event lists for discovery (super-user editorial tool)
+model BashList {
+  id            String   @id @default(cuid())
+  title         String   // e.g. "Best Friday Night in Ogden"
+  slug          String   @unique // URL-friendly identifier
+  description   String?  @db.Text
+  filterConfig  Json     // { dateRange?, city?, state?, eventType?, maxPrice?, ... }
+  isFeatured    Boolean  @default(false)
+  sortOrder     Int      @default(0)
+  createdById   String
+  createdAt     DateTime @default(now())
+  updatedAt     DateTime @updatedAt
+
+  createdBy User @relation(fields: [createdById], references: [id], onDelete: Cascade)
+
+  @@index([isFeatured, sortOrder])
+  @@index([slug])
+}
+
+// User's personal multi-event night plan (e.g. Dinner 6:30 → Comedy 8:00 → Dance 10:00)
+model UserItinerary {
+  id        String   @id @default(cuid())
+  userId    String
+  date      DateTime @db.Date // The night (e.g. 2026-03-15)
+  title     String?  // e.g. "Friday night out"
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user  User                 @relation(fields: [userId], references: [id], onDelete: Cascade)
+  items UserItineraryItem[]
+
+  @@unique([userId, date])
+  @@index([userId])
+}
+
+model UserItineraryItem {
+  id              String   @id @default(cuid())
+  userItineraryId String
+  bashEventId     String
+  sortOrder       Int      @default(0)
+  notes           String?  @db.Text
+  createdAt       DateTime @default(now())
+
+  userItinerary UserItinerary @relation(fields: [userItineraryId], references: [id], onDelete: Cascade)
+  bashEvent     BashEvent     @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+
+  @@unique([userItineraryId, bashEventId])
+  @@index([userItineraryId])
+}
+
 model Coordinates {
   id          Int        @id @default(autoincrement())
   lat         Float?
@@ -980,6 +1081,7 @@ model TicketTier {
   waitList               User[]               @relation("TicketTierToUser")
   specialOffers          SpecialOffer[] // NEW - Special offers for this tier
   appliedDiscounts       AppliedDiscount[] // NEW - Discounts applied to this tier
+  groupUnlockOffers      GroupUnlockOffer[] // Phase 4: Group unlock incentives
 
   // BashPoints Pricing (peer-to-peer economy)
   pricingType     PricingType @default(USD) // 'USD' or 'BASHPOINTS'
@@ -995,6 +1097,16 @@ model TicketTier {
   isWaitlistTier   Boolean @default(false) // Attendees request a spot; host approves/denies
   waitlistCapacity Int? // Max waitlist size; null = unlimited
 
+  // Availability rules
+  availabilityType             String    @default("Immediate") // "Immediate" | "OnDate" | "EngagedUsersOnly" | "UnlockWhenInterestReached" | "UnlockWhenTicketsSold"
+  availableAt                  DateTime? // OnDate: when tier unlocks
+  availableWhenInterestReached  Int?     // UnlockWhenInterestReached: min IdeaInterest count
+  unlockWhenTicketsSold        Int?     // UnlockWhenTicketsSold: min tickets sold across event to unlock this tier
+  maxTicketsPerUser            Int?     // Optional per-user purchase cap
+
+  // Privacy: "Public" | "LinkOnly" | "InviteOnly"
+  tierPrivacy                  String    @default("Public")
+
   @@unique([bashEventId, title])
 }
 
@@ -1046,6 +1158,7 @@ model Ticket {
   metadata         TicketMetadata[]
   transfers        TicketTransfer[]
   appliedDiscounts AppliedDiscount[] // NEW - Discounts applied to this ticket
+  eventReferral    EventReferral?    // When this ticket was purchased via a referral link
 
   @@index([bashEventId])
   @@index([waitlistUserId])
@@ -1613,6 +1726,10 @@ model User {
   bashEventPromoCodesIUsed      BashEventPromoCode[]    @relation("BashEventPromoCodeToUser")
   ticketTiersWaitListsIveJoined TicketTier[]            @relation("TicketTierToUser")
   scoutReferralsMade            ScoutReferral[]         @relation("ScoutReferrer")
+  eventReferralsMade            EventReferral[]         @relation("EventReferralsMade")
+  eventReferralsReceived        EventReferral[]         @relation("EventReferralsReceived")
+  bashListsCreated              BashList[]
+  userItineraries               UserItinerary[]
   aiRecommendationLogs          AIRecommendationLog[]
   scoutReferralsReceived        ScoutReferral[]         @relation("ScoutReferred")
 
@@ -1668,6 +1785,10 @@ model User {
 
   // Availability
   bashAvailability BashAvailability? @relation("UserAvailability")
+
+  // Groups
+  ownedGroups   EventGroup[]  @relation("OwnedGroups")
+  groupMembers  GroupMember[] @relation("GroupMemberships")
 }
 
 model UserPreferences {
@@ -3613,6 +3734,17 @@ enum NotificationType {
   WaitlistDenied        // Attendee: host denied your waitlist request
   WaitlistSpotAvailable // Waitlister: a refund opened a spot — claim it now
   WaitlistSpotMayBeOpen // Waitlister: someone left the venue — standby at door
+  // Group notifications
+  GroupMemberPurchased      // Owner: "Riley just bought a ticket — 2 more to go!"
+  GroupEveryoneConfirmed    // Owner: "All members want to attend. Buy tickets together?"
+  GroupEveryonePurchased    // Owner: "Your group is officially attending"
+  GroupMemberJoined         // Owner: "Alex joined your group"
+  FriendsAttending          // User: "3 of your friends are attending this bash"
+  GroupRewardProgress       // Member: "Only 2 more friends needed for your group reward"
+  GroupUnlockOfferReceived  // Member: "Special offer unlocked for your group"
+  HostSalesAccelerating     // Host: "Your event sales increased 38% today"
+  HostTopPromoter           // Host: "Top promoter: Alex (6 tickets today)"
+  HostSalesSlowing          // Host: "Sales slowed today. Try sharing your event."
 }
 
 enum NotificationPriority {
@@ -5559,6 +5691,7 @@ enum CreditSourceType {
   FirstShareBash // First time sharing a bash event
   FirstInviteToBash // First invite to someone else's bash
   BirthdayReward // Annual BashPoints boost on user's birthday
+  EventReferralReward // Per-event: attendee referred X friends, earned reward
 }
 
 enum PendingGiftStatus {
@@ -6721,3 +6854,111 @@ model BashAvailability {
 
   @@index([city, window, expiresAt])
 }
+
+// ─── Phase 0: Momentum Dashboard ────────────────────────────────────────────
+
+// Anonymous page view for conversion rate tracking. No PII stored.
+model BashEventPageView {
+  id          String   @id @default(cuid())
+  bashEventId String
+  sessionHash String   // hashed IP+UA for dedup
+  viewedAt    DateTime @default(now())
+
+  bashEvent BashEvent @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+
+  @@index([bashEventId, viewedAt])
+}
+
+// ─── Phase 1: Bash Groups ────────────────────────────────────────────────────
+
+enum GroupVisibility {
+  Private  // Default: owner curates members
+  OpenLink // Anyone with the group link can self-join as WantsToGo
+}
+
+enum GroupMemberStatus {
+  Going       // Ticket purchased / attending
+  WantsToGo   // Interested, no ticket yet
+  Maybe       // Maybe attending (aligns with Invitation maybeDate)
+  NotGoing    // Not attending (aligns with Invitation rejectedDate)
+  Invited     // Invited by owner, not yet responded
+}
+
+// A group of attendees for a specific event
+model EventGroup {
+  id            String          @id @default(cuid())
+  bashEventId   String
+  ownerId       String
+  name          String?         // e.g. "Steve's Birthday Group", "Weber State Crew"
+  maxMembers    Int?            // null = unlimited
+  visibility    GroupVisibility @default(Private)
+  allowAutoJoin Boolean         @default(false) // When true, anyone can join instantly; when false, requests require approval
+  promoterId    String?         // Optional: links to event promoter for display context
+  createdAt     DateTime        @default(now())
+  updatedAt     DateTime        @updatedAt
+
+  bashEvent BashEvent     @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  owner     User          @relation("OwnedGroups", fields: [ownerId], references: [id], onDelete: Cascade)
+  members   GroupMember[]
+  unlocks   GroupUnlock[]
+
+  @@unique([bashEventId, ownerId])
+  @@index([bashEventId])
+  @@index([ownerId])
+}
+
+// Membership record within a group
+model GroupMember {
+  id       String            @id @default(cuid())
+  groupId  String
+  userId   String
+  status   GroupMemberStatus @default(Invited)
+  ticketId String?           // Set when status = Going
+  joinedAt DateTime          @default(now())
+
+  group  EventGroup @relation(fields: [groupId], references: [id], onDelete: Cascade)
+  user   User       @relation("GroupMemberships", fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([groupId, userId])
+  @@index([groupId])
+  @@index([userId])
+}
+
+// ─── Phase 1.5: Promoter Leaderboards ───────────────────────────────────────
+// topPromoterPrize and promoterLeaderboardIsPublic are added to BashEvent via migration SQL.
+
+// ─── Phase 4: Group Unlock Incentives ───────────────────────────────────────
+
+// Host-created time-limited offer targeting a specific group
+model GroupUnlockOffer {
+  id           String    @id @default(cuid())
+  bashEventId  String
+  ticketTierId String?   // Optional: scoped to a specific tier
+  minGroupSize Int       // Minimum members who must buy
+  rewardLabel  String    // "Free drink", "VIP upgrade", "Free table"
+  rewardType   String    // FreeDrink | VIPUpgrade | Merch | Custom
+  expiresAt    DateTime
+  maxGroups    Int?      // null = unlimited
+  createdAt    DateTime  @default(now())
+
+  bashEvent  BashEvent        @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  ticketTier TicketTier?      @relation(fields: [ticketTierId], references: [id])
+  unlocks    GroupUnlock[]
+
+  @@index([bashEventId])
+  @@index([expiresAt])
+}
+
+// Record of a group claiming an unlock offer
+model GroupUnlock {
+  id         String   @id @default(cuid())
+  offerId    String
+  groupId    String
+  unlockedAt DateTime @default(now())
+
+  offer GroupUnlockOffer @relation(fields: [offerId], references: [id], onDelete: Cascade)
+  group EventGroup       @relation(fields: [groupId], references: [id], onDelete: Cascade)
+
+  @@unique([offerId, groupId])
+  @@index([groupId])
+}

package/src/definitions.ts

@@ -28,8 +28,8 @@ export const PASSWORD_REQUIREMENTS_REGEX = new RegExp(
 );
 
 // Stripe checkout timeout constants
-export const STRIPE_CHECKOUT_TIMEOUT_MS = 20000 as const; // 10 seconds (more reasonable)
-export const STRIPE_REDIRECT_TIMEOUT_MS = 10000 as const; // 5 seconds for redirect
+export const STRIPE_CHECKOUT_TIMEOUT_MS = 20000 as const; // 20 seconds
+export const STRIPE_REDIRECT_TIMEOUT_MS = 10000 as const; // 10 seconds for redirect
 export const STRIPE_API_TIMEOUT_MS = 15000 as const; // 15 seconds for API calls
 
 export const URL_PARAMS_BASH_EVENT_ID = "bashEventId" as const;
@@ -231,25 +231,6 @@ export const DONATION_CHECKOUT_RETURN_SUCCESS_URL_PAGE =
 export const DONATION_CHECKOUT_RETURN_CANCEL_URL_PAGE =
   "/bash/${bashEventIdSlug}/donation-cancel/${checkoutSessionId}" as const;
 
-// export const SERVICE_BOOKING_CHECKOUT_RETURN_SUCCESS_URL = urlAppendQueryParam(
-//   `/service/{SERVICE_ID}/booking/{BOOKING_ID}/checkout-return/{CHECKOUT_SESSION_ID}`,
-//   [
-//     {
-//       key: URL_PARAMS_STRIPE_CHECKOUT,
-//       value: URL_PARAMS_STRIPE_CHECKOUT_OPTIONS.complete,
-//     },
-//   ]
-// );
-// export const SERVICE_BOOKING_CHECKOUT_RETURN_CANCEL_URL = urlAppendQueryParam(
-//   `/service/{SERVICE_ID}/booking/{BOOKING_ID}/checkout-return/{CHECKOUT_SESSION_ID}`,
-//   [
-//     {
-//       key: URL_PARAMS_STRIPE_CHECKOUT,
-//       value: URL_PARAMS_STRIPE_CHECKOUT_OPTIONS.incomplete,
-//     },
-//   ]
-// );
-
 export const SERVICE_BOOKING_CHECKOUT_RETURN_SUCCESS_URL =
   "/service/${SERVICE_ID}/${SERVICE_TYPE}/${SPECIFIC_ID}/booking/${BOOKING_ID}/checkout-return/success/{CHECKOUT_SESSION_ID}" as const; //CHECKOUT_SESSION_ID filled by stripe
 export const SERVICE_BOOKING_CHECKOUT_RETURN_CANCEL_URL =
@@ -322,17 +303,6 @@ export const SERVICE_LINK_DATA_TO_INCLUDE = {
   link: true,
 } satisfies Prisma.ServiceLinkInclude;
 
-// export type ServiceSpecificName = keyof Pick<
-//   ServiceExt,
-//   "eventService" |
-//   "entertainmentService" |
-//   "vendor" |
-//   "exhibitor" |
-//   "sponsor" |
-//   "venue" |
-//   "organization"
-// >;
-
 export type DateTimeArgType = Date | string | undefined | null;
 export type RequiredStripeInfoMissingErrorDataType = {
   [k in keyof User]?: { type: string; label: string };
@@ -365,6 +335,12 @@ export type TicketTierWherePriceIsAString = Omit<TicketTier, "price"> & {
   price: string;
   pricingType?: string; // 'USD' or 'BASHPOINTS'
   priceBashPoints?: string; // Price in BashPoints credits (string for form input)
+  availabilityType?: string;
+  availableAt?: Date | string | null;
+  availableWhenInterestReached?: number | null;
+  unlockWhenTicketsSold?: number | null;
+  maxTicketsPerUser?: number | null;
+  tierPrivacy?: "Public" | "InviteOnly" | "LinkOnly";
 } & { cannotDelete: boolean };
 
 export type ApiServiceAddonParams = {
@@ -535,9 +511,21 @@ export interface NumberOfTicketsForDate {
   ticketDateTime: DateTimeArgType;
 }
 
+export interface TicketTierAvailability {
+  available: boolean;
+  reason?: "OnDate" | "EngagedUsersOnly" | "UnlockWhenInterestReached" | "UnlockWhenTicketsSold";
+  availableAt?: string; // ISO string, OnDate
+  interestCount?: number; // current count, UnlockWhenInterestReached
+  interestThreshold?: number; // target, UnlockWhenInterestReached
+  ticketsSoldCount?: number; // current count, UnlockWhenTicketsSold
+  ticketsSoldThreshold?: number; // target, UnlockWhenTicketsSold
+  isViewerEngaged?: boolean; // EngagedUsersOnly — undefined if not logged in
+}
+
 export interface AvailableTicketsForTicketTier {
   ticketTier: TicketTier;
   availableTickets: NumberOfTicketsForDate[];
+  availability?: TicketTierAvailability;
 }
 
 export interface AvailableTicketsForTicketTierForDate {
@@ -545,37 +533,11 @@ export interface AvailableTicketsForTicketTierForDate {
   availableTicketsForDate: NumberOfTicketsForDate;
 }
 
-export interface AvailableTicketsForTicketTier {
-  ticketTier: TicketTier;
-  availableTickets: NumberOfTicketsForDate[];
-}
-
 export interface NumberOfHoursForDate {
   numberOfHours: number;
   bookingDateTime: DateTimeArgType;
 }
 
-// export interface AvailableNumberOfHoursForRate {
-//   rate: Rate;
-//   availableHours: NumberOfHoursForDate[];
-// }
-
-// export interface AvailableHoursForRateForDate {
-//   rate: Rate,
-//   availableHoursForDate: NumberOfHoursForDate;
-// }
-
-// export interface AvailableHoursForRate {
-//   rate: Rate;
-//   availableHours: NumberOfHoursForDate[];
-// }
-
-// export interface DeletedAndHiddenRates {
-//   deletedRates: Rate[];
-//   hiddenRates: Rate[];
-//   errorType?: ApiErrorType;
-// }
-
 export interface SignInEmailWithPassword {
   email: string;
   password: string;
@@ -696,6 +658,11 @@ export interface StripeCreateBashEventTicketsCheckoutSessionArgs {
   bashPointsReservationId?: string;  // Reservation ID from /bashpoints/reserve-for-checkout
   bashPointsTicketListStr?: string;  // Ticket list for BashPoints portion
   bashPointsAmount?: number;         // Total BashPoints reserved
+
+  // Per-event referral: userId of attendee who shared the link
+  referrerId?: string;
+  // Attribution ref from URL (referral code or userId) - backend resolves to referrerId
+  attributionRef?: string;
 }
 
 export interface StripeCreateBashEventDonationCheckoutSessionArgs {
@@ -750,26 +717,11 @@ export interface ServiceGenerateCoverPhotoArgs {
   searchTerm: string;
 }
 
-export interface ServiceNextGooglePhotoArgs {
-  photoIndex: string;
-  useBusinessPhotos: boolean;
-}
-
 export type StripeSessionRedirect = {
   stripeAccountIdDB: string;
   redirectUrl: string;
 };
 
-// export type ServiceStripeSessionRedirect = {
-//   service: ServiceExt;
-// } & StripeSessionRedirect;
-
-// export type BashEventStripeSessionRedirect = {
-//   bashEvent: BashEventExt;
-// } & StripeSessionRedirect;
-
-// export type StripeLinkingStatus = "Complete" | "Incomplete";
-
 export type StripeAddress = {
   line1: string;
   line2: string;

package/src/extendedSchemas.ts

@@ -712,7 +712,7 @@ export interface ServiceExt extends Service {
   // bookedCheckouts: ServiceBookingCheckoutExt[]; //not necessary to include
 }
 
-export type ServiceExtNonSpecific = Exclude<
+export type ServiceExtNonSpecific = Omit<
   ServiceExt,
   | "id"
   | "venue"
@@ -735,7 +735,7 @@ export type ServiceExtNonSpecific = Exclude<
   | "bashEventId"
 >;
 
-export type ServiceExtNoIds = Exclude<
+export type ServiceExtNoIds = Omit<
   ServiceExt,
   | "id"
   | "venueId"

package/src/index.ts

@@ -31,7 +31,6 @@ export * from "./utils/ticketListUtils";
 export * from "./utils/urlUtils";
 export * from "./utils/userPromoCodeUtils";
 export * from "./utils/userSubscriptionUtils";
-// export * from "./utils/service/serviceRateDBUtils";
 export * from "./utils/blog/blogDbUtils";
 export * from "./utils/blogUtils";
 export * from "./utils/entityUtils";

package/src/membershipDefinitions.ts

@@ -51,11 +51,19 @@ export interface CreateMembershipPaymentIntentArgs {
 }
 
 export interface MembershipPaymentIntentResult {
+  paymentIntentId?: string;
   clientSecret: string;
   amount: number;
   currency: string;
 }
 
+/** Legacy shape for deprecated createMembershipPaymentIntent endpoint (tierName/interval). */
+export interface CreateMembershipPaymentIntentArgsLegacy {
+  tierName: string;
+  interval?: "monthly" | "yearly";
+  currency?: string;
+}
+
 export interface MembershipFeatureAccessCheck {
   hasAccess: boolean;
   requiredTier?: MembershipTier;
@@ -914,17 +922,3 @@ export interface ConfirmMembershipPaymentArgs {
   interval?: 'monthly' | 'yearly';
   userId?: string;
 }
-
-export interface CreateMembershipPaymentIntentArgs {
-  tierName: string;
-  interval?: 'monthly' | 'yearly';
-  paymentMethodId?: string;
-  userId?: string;
-}
-
-export interface MembershipPaymentIntentResult {
-  paymentIntentId: string;
-  clientSecret: string;
-  amount: number;
-  currency: string;
-}

package/src/utils/index.ts

@@ -25,7 +25,6 @@ export * from './service/regexUtils';
 export * from './service/serviceBookingStatusUtils';
 export * from './service/serviceBookingTypes';
 export * from './service/serviceDBUtils';
-// export * from './service/serviceRateDBUtils'; // File is all commented out
 export * from './service/serviceRateTypes';
 export * from './service/serviceRateUtils';
 export * from './service/serviceUtils';