@bash-app/bash-common 30.284.0 → 30.285.0

package/prisma/schema.prisma

@@ -237,6 +237,13 @@ model Competition {
   startTime             DateTime? // Competition start time (for voting)
   endTime               DateTime? // Competition end time (for voting)
   allowSelfRegistration Boolean          @default(false)
+  /// When true, participant requests are auto-approved (ACCEPTED) instead of queued for host review.
+  autoApproveParticipants Boolean        @default(false)
+  /// How the participant roster appears on the bash page ("All" | "Hidden").
+  participantDisplayMode  String         @default("All")
+  /// AUDIENCE_VOTE only: when true, only attendees (ticket holders / RSVPs) may vote.
+  /// Default false keeps voting open to any signed-in viewer.
+  restrictVotingToAttendees Boolean      @default(false)
   maxParticipants       Int? // Optional cap on participants
 
   // Tournament bracket fields
@@ -316,6 +323,8 @@ model CompetitionSponsor {
   sponsorName     String?
   logoUrl         String?
   description     String?
+  /// Optional outbound link to the sponsor's website (clickable on the public competition page)
+  websiteUrl      String?
   paidOn          String?
   competition     Competition @relation(fields: [competitionId], references: [id], onDelete: Cascade)
   sponsor         User?       @relation(fields: [userId], references: [id], onDelete: Cascade)
@@ -372,10 +381,9 @@ model CompetitionParticipant {
   votes         CompetitionVote[]
 
   // Tournament bracket relations
-  matchesAsParticipant1 CompetitionMatch[]      @relation("MatchParticipant1")
-  matchesAsParticipant2 CompetitionMatch[]      @relation("MatchParticipant2")
-  matchesWon            CompetitionMatch[]      @relation("MatchWinner")
-  judgeScores           CompetitionJudgeScore[]
+  matchEntries CompetitionMatchEntrant[]
+  matchesWon   CompetitionMatch[]      @relation("MatchWinner")
+  judgeScores  CompetitionJudgeScore[]
 
   @@index([competitionId])
   @@index([userId])
@@ -384,26 +392,28 @@ model CompetitionParticipant {
   @@index([status])
 }
 
-// Tournament bracket matches
+// Tournament bracket matches (1v1, heats, or battle royale via entrants join table)
 model CompetitionMatch {
   id            String @id @default(cuid())
   competitionId String
   round         Int // 1 = first round, 2 = semifinals, etc.
   matchNumber   Int // Position in round (1, 2, 3...)
 
-  participant1Id String?
-  participant2Id String?
-  winnerId       String?
+  format       CompetitionMatchFormat @default(HEAD_TO_HEAD)
+  capacity     Int? // Max entrants (heat lanes, server slots)
+  advanceCount Int? // How many advance from this heat/pool
+  heatIndex    Int? // Wave number within a round (e.g. heat 12 of 50)
+
+  winnerId String?
 
   scheduledTime DateTime?
   completedAt   DateTime?
-  score         Json? // {participant1: 10, participant2: 8}
+  score         Json? // Legacy H2H: {participant1, participant2}; multi-entrant scores live on entrants
   notes         String? // Match notes
 
-  competition  Competition             @relation(fields: [competitionId], references: [id], onDelete: Cascade)
-  participant1 CompetitionParticipant? @relation("MatchParticipant1", fields: [participant1Id], references: [id])
-  participant2 CompetitionParticipant? @relation("MatchParticipant2", fields: [participant2Id], references: [id])
-  winner       CompetitionParticipant? @relation("MatchWinner", fields: [winnerId], references: [id])
+  competition Competition             @relation(fields: [competitionId], references: [id], onDelete: Cascade)
+  winner      CompetitionParticipant? @relation("MatchWinner", fields: [winnerId], references: [id])
+  entrants    CompetitionMatchEntrant[]
 
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
@@ -413,6 +423,29 @@ model CompetitionMatch {
   @@index([round])
 }
 
+// N entrants per match — heats, battle royales, and head-to-head (slots 1 & 2)
+model CompetitionMatchEntrant {
+  id            String @id @default(cuid())
+  matchId       String
+  participantId String
+  slot          Int // Lane/pod position (1-based)
+  placement     Int? // Finish order within the match
+  score         Json? // Time, points, etc.
+  eliminatedAt  DateTime?
+  advanced      Boolean? // Heat qualifiers: true when advancing to next stage
+
+  match       CompetitionMatch       @relation(fields: [matchId], references: [id], onDelete: Cascade)
+  participant CompetitionParticipant @relation(fields: [participantId], references: [id], onDelete: Cascade)
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@unique([matchId, slot])
+  @@unique([matchId, participantId])
+  @@index([matchId])
+  @@index([participantId])
+}
+
 model CompetitionVote {
   id            String                 @id @default(cuid())
   competitionId String
@@ -828,6 +861,9 @@ model BashEvent {
   collaborationEnabled        Boolean                @default(true)
   /// Host opt-in: show icebreaker prompts on the bash detail page for guests
   icebreakerEnabled           Boolean                @default(false)
+  /// Optional host-authored / host-picked icebreaker prompt. When set, it is shown
+  /// instead of a random canned prompt on the bash detail page.
+  icebreakerPrompt            String?
   /// Host-curated merch catalog for this event (informational; not a checkout line item for MVP)
   merchandiseItems            Json?
   externalPriceMax            Int? // Maximum ticket price in cents (for imported events)
@@ -910,6 +946,8 @@ model BashEvent {
   userConnections                 UserConnection[]
   aiRecommendationLogs            AIRecommendationLog[]
   aiRecommendationCaches          AIRecommendationCache[]
+  venueMatchRuns                  VenueMatchRun[]
+  venueSupplyLeadEvents           VenueSupplyLeadEvent[]
   // Template tracking
   templateId                      String?
   template                        BashEventTemplate?             @relation("CreatedFromTemplate", fields: [templateId], references: [id])
@@ -3025,6 +3063,8 @@ model User {
   userItineraries               UserItinerary[]
   aiRecommendationLogs          AIRecommendationLog[]
   scoutReferralsReceived        ScoutReferral[]         @relation("ScoutReferred")
+  venueMatchRuns                VenueMatchRun[]         @relation("VenueMatchRunHost")
+  assignedSupplyLeads           VenueSupplyLead[]       @relation("SupplyLeadAssignee")
 
   // Service Category Requests
   serviceCategoryRequests  ServiceCategoryRequest[]
@@ -3601,6 +3641,10 @@ model Service {
   verifiedAt                         DateTime? // When verification was approved
   licenseNumber                      String? // License/registration number
   certifications                     String[]                   @default([]) // Array of certification names
+  /// Geo anchor for distance scoring (Venue Match + future geo queries).
+  /// Backfilled from googlePlaceId / address via api/scripts/backfillServiceCoordinates.ts.
+  latitude                           Float?
+  longitude                          Float?
   bashFeedPosts                      BashFeedPost[]
   bashEventArtists                   BashEventArtist[]
   bashCreativeSubmissions            BashCreativeSubmission[]
@@ -3647,6 +3691,8 @@ model Service {
   competitionPrizesSourced           Prize[]                    @relation("PrizeSourceService")
   competitionSponsorCredits          CompetitionSponsor[]       @relation("CompetitionSponsorSourceService")
   competitionPrizeOffersSourced    CompetitionPrizeOffer[]    @relation("CompetitionPrizeOfferSourceService")
+  venueMatchCandidates               VenueMatchCandidate[]
+  supplyLeadConversions              VenueSupplyLead[]          @relation("SupplyLeadConvertedService")
 
   @@index([serviceListingStripeSubscriptionId])
   @@index([paymentAccountId])
@@ -3654,6 +3700,7 @@ model Service {
   @@index([isVerified])
   @@index([isLicensed])
   @@index([isFeaturedService, featuredReason, featuredAt])
+  @@index([latitude, longitude])
 }
 
 model StripeAccount {
@@ -6257,6 +6304,14 @@ enum BracketType {
   DOUBLE_ELIMINATION // Lose twice, you're out
   ROUND_ROBIN // Everyone plays everyone
   SWISS // Pairing based on performance
+  HEAT // Wave-based qualifiers (many entrants per match, top performers advance)
+  BATTLE_ROYALE // Last standing / placement in a multi-entrant match
+}
+
+enum CompetitionMatchFormat {
+  HEAD_TO_HEAD // Traditional 1v1 (slots 1 & 2)
+  HEAT // Sequential wave with capacity-limited entrants
+  BATTLE_ROYALE // All entrants compete simultaneously until one remains
 }
 
 enum ParticipantStatus {
@@ -9637,3 +9692,183 @@ enum StripeNonprofitPricingStatus {
   Approved
   Declined
 }
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Venue Match pipeline (retrieve → score → explain) + supply sales pipeline.
+// JSON column shapes live in bash-common/src/venueMatch.ts (VenueMatchIntent,
+// VenueMatchScoreBreakdown, VenueCandidateDisplay).
+// ─────────────────────────────────────────────────────────────────────────────
+
+enum VenueMatchCandidateSource {
+  Marketplace
+  GooglePlaces
+}
+
+enum VenueMatchHostAction {
+  None
+  Viewed
+  Accepted
+  AcceptedOffPlatform
+  Dismissed
+  CalledPhone
+  InvitedVenue
+}
+
+enum VenueSupplyLeadStage {
+  Surfaced
+  Prioritized
+  Queued
+  Contacted
+  Interested
+  DemoScheduled
+  Listed
+  Declined
+  DoNotContact
+}
+
+enum ExternalPlaceSource {
+  OutscraperCsv
+  OutscraperApi
+  Manual
+}
+
+/// One scoring run for a bash. Content-hash dedupes identical re-runs.
+model VenueMatchRun {
+  id          String   @id @default(cuid())
+  bashEventId String
+  hostUserId  String
+  /// `VenueMatchIntent` — occasion, guestCount, anchor coords, vibe, budget.
+  intent      Json
+  contentHash String
+  /// Run telemetry: latencyMs, candidateCounts, googleCalls, cacheHits.
+  meta        Json?
+  createdAt   DateTime @default(now())
+
+  bashEvent  BashEvent             @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  hostUser   User                  @relation("VenueMatchRunHost", fields: [hostUserId], references: [id], onDelete: Cascade)
+  candidates VenueMatchCandidate[]
+
+  @@index([bashEventId, createdAt])
+  @@index([hostUserId])
+}
+
+/// Every scored candidate in a run (not just the top 3 shown).
+model VenueMatchCandidate {
+  id              String                    @id @default(cuid())
+  runId           String
+  rank            Int
+  score           Int
+  /// `VenueMatchScoreBreakdown` — per-factor score + applied weight.
+  scoreBreakdown  Json
+  /// Host-facing reason strings ("2.1 mi away", "Fits 25 guests").
+  reasons         Json
+  source          VenueMatchCandidateSource
+  serviceId       String?
+  googlePlaceId   String?
+  /// `VenueCandidateDisplay` — snapshot so GET never re-hits Google.
+  displaySnapshot Json
+  hostAction      VenueMatchHostAction      @default(None)
+  hostActionAt    DateTime?
+
+  run     VenueMatchRun @relation(fields: [runId], references: [id], onDelete: Cascade)
+  service Service?      @relation(fields: [serviceId], references: [id], onDelete: SetNull)
+
+  @@index([runId, rank])
+  @@index([googlePlaceId])
+  @@index([serviceId])
+}
+
+/// ToS-compatible place data (Outscraper CSV/API imports). The ONLY allowed
+/// contact-data source for VenueSupplyLead — Google Place fields are never
+/// copied here (see GooglePlaceCache for the ephemeral display tier).
+model ExternalPlaceCatalog {
+  id            String              @id @default(cuid())
+  googlePlaceId String?             @unique
+  phoneE164     String?
+  name          String
+  fullAddress   String?             @db.Text
+  city          String?
+  state         String?
+  postalCode    String?
+  latitude      Float?
+  longitude     Float?
+  rating        Float?
+  reviewCount   Int?
+  category      String?
+  website       String?             @db.Text
+  source        ExternalPlaceSource @default(OutscraperCsv)
+  /// Scraped/ file stem or Outscraper query that produced this row.
+  sourceKey     String?
+  importedAt    DateTime            @default(now())
+  refreshedAt   DateTime?
+
+  supplyLeads VenueSupplyLead[]
+
+  @@index([phoneE164])
+  @@index([city, state])
+}
+
+/// Off-platform venue prospect for the sales pipeline. Contact fields come
+/// from ExternalPlaceCatalog (denormalized name/phone kept for fast lists).
+model VenueSupplyLead {
+  id                 String               @id @default(cuid())
+  catalogId          String?
+  googlePlaceId      String?              @unique
+  /// Set when the venue converts (publishes a Service on Bash).
+  serviceId          String?
+  /// Dedup link to the Vapi dialer lead when phoneE164 matches.
+  outreachLeadId     String?
+  name               String
+  phoneE164          String?
+  city               String?
+  state              String?
+  /// Count of DISTINCT bash events that surfaced this venue (top 10).
+  distinctEventCount Int                  @default(0)
+  firstSurfacedAt    DateTime             @default(now())
+  lastSurfacedAt     DateTime             @default(now())
+  stage              VenueSupplyLeadStage @default(Surfaced)
+  assignedToUserId   String?
+  notes              String?              @db.Text
+  createdAt          DateTime             @default(now())
+  updatedAt          DateTime             @updatedAt
+
+  catalog       ExternalPlaceCatalog?  @relation(fields: [catalogId], references: [id], onDelete: SetNull)
+  service       Service?               @relation("SupplyLeadConvertedService", fields: [serviceId], references: [id], onDelete: SetNull)
+  assignedTo    User?                  @relation("SupplyLeadAssignee", fields: [assignedToUserId], references: [id], onDelete: SetNull)
+  surfaceEvents VenueSupplyLeadEvent[]
+
+  @@index([stage, distinctEventCount])
+  @@index([city, state])
+  @@index([phoneE164])
+  @@index([assignedToUserId])
+}
+
+/// Join row: which bash surfaced this lead, with occasion context for
+/// cold-call scripts ("4 hosts searched bachelor party venues near you").
+model VenueSupplyLeadEvent {
+  id                 String   @id @default(cuid())
+  supplyLeadId       String
+  bashEventId        String
+  matchCandidateId   String?
+  occasion           String?
+  guestCountEstimate Int?
+  surfacedAt         DateTime @default(now())
+
+  supplyLead VenueSupplyLead @relation(fields: [supplyLeadId], references: [id], onDelete: Cascade)
+  bashEvent  BashEvent       @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+
+  @@unique([supplyLeadId, bashEventId])
+  @@index([bashEventId])
+}
+
+/// Ephemeral Google Place display data (48h TTL). NEVER copied into
+/// VenueSupplyLead or ExternalPlaceCatalog — Google ToS tier C only.
+model GooglePlaceCache {
+  googlePlaceId   String   @id
+  /// Display-only snapshot: name, address, rating, reviewCount, photoUrl, phone, lat/lng.
+  displaySnapshot Json
+  fetchedAt       DateTime @default(now())
+  expiresAt       DateTime
+
+  @@index([expiresAt])
+}

package/src/definitions.ts

@@ -1,6 +1,5 @@
 import {
     BashEventType,
-    BracketType,
     CompetitionType,
     Contact,
     DietaryOption,
@@ -1137,9 +1136,10 @@ export const YearsOfExperienceToString: { [key in YearsOfExperienceEnum]: string
     [YearsOfExperience.FivePlusYears]: "More than five years",
   };
 
+export { BracketType } from "./mirroredPrismaEnums.js";
+
 // Export Prisma enums for use in frontend
 export {
-    BracketType,
     CompetitionType,
     EntertainmentServiceType,
     JudgingType,

package/src/extendedSchemas.ts

@@ -1,3 +1,4 @@
+import type { BracketType } from "./mirroredPrismaEnums.js";
 import {
     AmountOfGuests,
     AssociatedBash,
@@ -280,14 +281,23 @@ export interface CompetitionPrizeOfferExt {
   } | null;
 }
 
-export interface CompetitionExt extends Competition {
-  prizes: PrizeExt[];
+/** Competition row + relations; Override keeps new columns visible before consumers refresh Prisma. */
+export type CompetitionExt = Override<
+  Competition,
+  {
+    autoApproveParticipants: boolean;
+    participantDisplayMode: string;
+    restrictVotingToAttendees: boolean;
+    bracketType: BracketType | null;
+    prizes: PrizeExt[];
+  }
+> & {
   participants?: CompetitionParticipant[];
   votes?: CompetitionVote[];
   entryTicketTier?: TicketTier | null;
   sponsor?: CompetitionSponsor[];
   prizeOffers?: CompetitionPrizeOfferExt[];
-}
+};
 
 /** One row in BashEvent.merchandiseItems (host wizard; informational catalog) */
 export type BashEventHostMerchItem = {
@@ -356,12 +366,15 @@ export type BashEventHiredServicePublic = {
   }>;
 };
 
-export interface BashEventExt extends Omit<
-  BashEvent,
-  | "ideaExpiresAt"
-  | "ideaInterestThreshold"
-  | "isAutoApprovable"
-  | "merchandiseItems"
+export interface BashEventExt extends Override<
+  Omit<
+    BashEvent,
+    | "ideaExpiresAt"
+    | "ideaInterestThreshold"
+    | "isAutoApprovable"
+    | "merchandiseItems"
+  >,
+  { icebreakerPrompt: string | null }
 > {
   /** Host-curated merch catalog (wizard); stored as JSON on BashEvent. Null = no merch configured. */
   merchandiseItems: BashEventMerchCatalog | null;
@@ -984,8 +997,9 @@ export interface ServiceExt extends Service {
 
   stripeAccount?: PublicStripeAccount | null;
 
-  latitude?: number;
-  longitude?: number;
+  /** Geo anchor — explicit on ext type for consumers before Prisma client catches up */
+  latitude: number | null;
+  longitude: number | null;
 
   // availableDateTimes?: Availability[];
 

package/src/icebreakerPrompts.ts

@@ -0,0 +1,75 @@
+/**
+ * Curated conversation starters for Bash events (hosts enable per-event).
+ * Single source of truth shared by the API (public icebreaker endpoint) and the
+ * bash-app wizard (host "Generate a new icebreaker" picker).
+ */
+export const ICEBREAKER_PROMPTS: string[] = [
+  // Get to know you
+  "What’s something small that made your week better?",
+  "What’s a hobby you’ve always wanted to try but haven’t yet?",
+  "If you could learn one new skill overnight, what would it be?",
+  "What’s your go-to comfort food?",
+  "What’s a book, show, or podcast you recommend to almost everyone?",
+  "What city or country is still on your travel list?",
+  "What’s a tradition from your family or culture you love?",
+  "What’s the best advice you’ve ever been given?",
+  "Who is someone you admire and why (in one sentence)?",
+  "What’s a song that instantly puts you in a good mood?",
+  // Event / party
+  "What brought you out tonight?",
+  "What are you most looking forward to at this event?",
+  "If this bash had a theme song, what would it be?",
+  "What’s one thing you hope to take away from tonight?",
+  "Who here do you already know—and how did you meet?",
+  "What’s your favorite thing about gatherings like this?",
+  "If you could add one activity to this event, what would it be?",
+  "What’s a memory from a past party you still think about?",
+  "What’s your ideal way to spend an evening with friends?",
+  "What’s something you’re celebrating lately (big or small)?",
+  // Light / funny
+  "What’s a hot take you’re willing to defend at this table?",
+  "What’s your most useless talent?",
+  "Would you rather: perfect weather forever or perfect sleep forever?",
+  "What’s a food you pretend to like but secretly don’t?",
+  "What’s the last thing you laughed really hard at?",
+  "If animals could talk, which would be the rudest?",
+  "What’s a trend you don’t get but respect?",
+  "What’s your go-to karaoke song (or what would it be)?",
+  "What’s something everyone likes but you’re lukewarm on?",
+  "What’s a nickname you’ve had—or wish you had?",
+  // Nostalgia
+  "What’s a childhood snack or meal you still crave?",
+  "What’s the first concert or live event you remember?",
+  "What game did you play endlessly as a kid?",
+  "What’s a smell that instantly takes you back somewhere?",
+  "What’s a lesson from school you still use?",
+  "What’s something you believed as a kid that makes you laugh now?",
+  "What’s a movie you’ve watched way too many times?",
+  "What’s a friendship that started in an unexpected place?",
+  "What’s a piece of clothing or merch you wish you still had?",
+  "What’s a place you grew up that you’d show someone new?",
+  // Deeper (still party-safe)
+  "What’s something you’re proud of from the last year?",
+  "What’s a goal you’re working on right now?",
+  "What’s something kind someone did for you that stuck with you?",
+  "What’s a risk you’re glad you took?",
+  "What helps you recharge after a busy week?",
+  "What’s a cause or community you care about?",
+  "What’s a skill you’re trying to get better at?",
+  "What’s something you’ve changed your mind about?",
+  "What’s a question you wish people asked you more often?",
+  "What’s one thing you’re grateful for today?",
+];
+
+/** Random icebreaker, optionally avoiding the current prompt so "generate again" feels fresh. */
+export function getRandomIcebreakerPrompt(exclude?: string | null): string {
+  if (ICEBREAKER_PROMPTS.length === 0) return "";
+  if (ICEBREAKER_PROMPTS.length === 1) return ICEBREAKER_PROMPTS[0];
+  let next = ICEBREAKER_PROMPTS[Math.floor(Math.random() * ICEBREAKER_PROMPTS.length)];
+  let guard = 0;
+  while (exclude && next === exclude && guard < 10) {
+    next = ICEBREAKER_PROMPTS[Math.floor(Math.random() * ICEBREAKER_PROMPTS.length)];
+    guard += 1;
+  }
+  return next;
+}

package/src/index.ts

@@ -7,6 +7,7 @@ export * from "./venueLoyaltyRedemption.js";
 export * from "./stripeListingSubscriptionMessages.js";
 export * from "./extendedSchemas.js";
 export * from "./competitionIdeas.js";
+export * from "./icebreakerPrompts.js";
 export * from "./competitionValidation.js";
 export * from "./groupTicketUtils.js";
 export * from "./utils/groupTicketCartUtils.js";
@@ -18,6 +19,7 @@ export * from "./membershipDefinitions.js";
 export * from "./onSaleCapabilityRecommendations.js";
 export * from "./ticketBnplPaymentMethods.js";
 export * from "./aiApproval.js";
+export * from "./venueMatch.js";
 export * from "./userReportTypes.js";
 export * from "./mirroredPrismaEnums.js";
 export * from "./utils/featuredDiscoveryGeo.js";

package/src/mirroredPrismaEnums.ts

@@ -180,3 +180,19 @@ export const CreditSourceType = {
 } as const satisfies Record<CreditSourceTypeEnum, CreditSourceTypeEnum>;
 
 export type CreditSourceType = CreditSourceTypeEnum;
+
+/**
+ * Mirrors Prisma `BracketType` — includes HEAT / BATTLE_ROYALE before all consumers
+ * refresh `@prisma/client` (see README-typecheck.md).
+ */
+export const BracketType = {
+  NONE: "NONE",
+  SINGLE_ELIMINATION: "SINGLE_ELIMINATION",
+  DOUBLE_ELIMINATION: "DOUBLE_ELIMINATION",
+  ROUND_ROBIN: "ROUND_ROBIN",
+  SWISS: "SWISS",
+  HEAT: "HEAT",
+  BATTLE_ROYALE: "BATTLE_ROYALE",
+} as const;
+
+export type BracketType = (typeof BracketType)[keyof typeof BracketType];