@bash-app/bash-common 30.309.0 → 30.314.0

package/prisma/schema.prisma

@@ -266,6 +266,16 @@ model Competition {
   /// How 1st/2nd/3rd place icons appear on leaderboards and profiles
   placementAwardStyle   PlacementAwardStyle          @default(Trophy)
 
+  /// Optional Adventures rewards when someone becomes an ACCEPTED participant
+  participationBashPoints    Int?
+  participationEventBadgeId  String?
+  /// Optional Adventures rewards when a participant reaches a finalist placement (placement <= 3)
+  finalistBashPoints         Int?
+  finalistEventBadgeId       String?
+  /// Optional Adventures rewards when assigned as a prize winner
+  winBashPoints              Int?
+  winEventBadgeId            String?
+
   createdAt        DateTime                     @default(now())
   updatedAt        DateTime                     @updatedAt
   bashEvent        BashEvent                    @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
@@ -279,11 +289,18 @@ model Competition {
   judgeAssignments CompetitionJudgeAssignment[]
   judgeScores      CompetitionJudgeScore[]
   notifications    Notification[]
+  sideQuests       SideQuest[]
+  participationEventBadge EventBadge? @relation("CompetitionParticipationBadge", fields: [participationEventBadgeId], references: [id], onDelete: SetNull)
+  finalistEventBadge      EventBadge? @relation("CompetitionFinalistBadge", fields: [finalistEventBadgeId], references: [id], onDelete: SetNull)
+  winEventBadge           EventBadge? @relation("CompetitionWinBadge", fields: [winEventBadgeId], references: [id], onDelete: SetNull)
 
   @@index([bashEventId])
   @@index([competitionType])
   @@index([startTime])
   @@index([endTime])
+  @@index([participationEventBadgeId])
+  @@index([finalistEventBadgeId])
+  @@index([winEventBadgeId])
 }
 
 model CompetitionJudgeAssignment {
@@ -373,6 +390,8 @@ model CompetitionParticipant {
   name          String // Display name
   description   String?           @db.Text // Why they should win
   imageUrl      String? // Photo/avatar
+  /// Optional link when the entrant is a Service listing (e.g. Best Food Truck)
+  sourceServiceId String?
   order         Int               @default(0) // Display order
   voteCount     Int               @default(0) // Denormalized for performance
   isEliminated  Boolean           @default(false) // For tournament brackets
@@ -385,6 +404,7 @@ model CompetitionParticipant {
   createdAt     DateTime          @default(now())
   competition   Competition       @relation(fields: [competitionId], references: [id], onDelete: Cascade)
   user          User?             @relation(fields: [userId], references: [id], onDelete: Cascade)
+  sourceService Service?          @relation("CompetitionParticipantSourceService", fields: [sourceServiceId], references: [id], onDelete: SetNull)
   votes         CompetitionVote[]
 
   // Tournament bracket relations
@@ -397,6 +417,7 @@ model CompetitionParticipant {
   @@index([email])
   @@index([voteCount])
   @@index([status])
+  @@index([sourceServiceId])
 }
 
 // Tournament bracket matches (1v1, heats, or battle royale via entrants join table)
@@ -994,6 +1015,7 @@ model BashEvent {
   userPromoCodeRedemption         UserPromoCodeRedemption[]
   userReport                      UserReport[]
   vendorBookingRequests           VendorBookingRequest[]         @relation("VendorBookingEvent")
+  vendorCategoryExclusivities     VendorCategoryExclusivity[]
   vendorBids                      VendorBid[]
   media                           Media[]                        @relation("BashEventToMedia")
   associatedServicesReferencingMe Service[]                      @relation("BashEventToService")
@@ -2023,6 +2045,7 @@ enum EventBadgeAwardSource {
   Milestone
   Manual
   Community
+  Competition
 }
 
 model SideQuest {
@@ -2047,17 +2070,21 @@ model SideQuest {
   unlockedAt               DateTime?
   sponsorLabel             String?
   sponsorServiceId         String?
+  /// When questType is Vote: the competition casting a vote completes this quest
+  competitionId            String?
   createdAt                DateTime          @default(now())
   updatedAt                DateTime          @updatedAt
 
   bashEvent    BashEvent             @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
   eventBadge   EventBadge?           @relation(fields: [eventBadgeId], references: [id], onDelete: SetNull)
+  competition  Competition?          @relation(fields: [competitionId], references: [id], onDelete: SetNull)
   completions  SideQuestCompletion[]
   milestonesUnlocking SideQuestMilestone[] @relation("MilestoneUnlocksQuest")
 
   @@index([bashEventId])
   @@index([bashEventId, sortOrder])
   @@index([eventBadgeId])
+  @@index([competitionId])
 }
 
 model SideQuestCompletion {
@@ -2091,6 +2118,9 @@ model EventBadge {
   sideQuests  SideQuest[]
   milestones  SideQuestMilestone[]
   communityGoals CommunityQuestGoal[]
+  competitionsParticipation Competition[] @relation("CompetitionParticipationBadge")
+  competitionsFinalist      Competition[] @relation("CompetitionFinalistBadge")
+  competitionsWin           Competition[] @relation("CompetitionWinBadge")
 
   @@index([bashEventId])
   @@index([createdByUserId])
@@ -2208,6 +2238,7 @@ model EventDiscussionComment {
   parent    EventDiscussionComment?  @relation("EventDiscussionReplies", fields: [parentId], references: [id], onDelete: Cascade)
   replies   EventDiscussionComment[] @relation("EventDiscussionReplies")
   likes     EventDiscussionCommentLike[]
+  reports   EventDiscussionCommentReport[]
 
   @@index([bashEventId])
   @@index([authorId])
@@ -2228,6 +2259,27 @@ model EventDiscussionCommentLike {
   @@index([commentId])
 }
 
+model EventDiscussionCommentReport {
+  id          String               @id @default(cuid())
+  userId      String
+  commentId   String
+  reason      BashFeedReportReason
+  description String?              @db.Text
+  status      ReportStatus         @default(Pending)
+  reviewedBy  String?
+  reviewedAt  DateTime?
+  createdAt   DateTime             @default(now())
+
+  user     User                   @relation(fields: [userId], references: [id], onDelete: Cascade)
+  comment  EventDiscussionComment @relation(fields: [commentId], references: [id], onDelete: Cascade)
+  reviewer User?                  @relation("ReviewedDiscussionReports", fields: [reviewedBy], references: [id])
+
+  @@unique([userId, commentId])
+  @@index([commentId])
+  @@index([status])
+  @@index([userId])
+}
+
 // === Phase 3: event experience depth ========================================
 // Scalar-FK models (no Prisma relations to the large BashEvent/User models);
 // DB foreign keys are added in the migration for integrity.
@@ -3766,6 +3818,8 @@ model User {
   bashFeedComments     BashFeedComment[]
   bashFeedCommentLikes BashFeedCommentLike[]
   eventDiscussionCommentLikes EventDiscussionCommentLike[]
+  discussionCommentReports    EventDiscussionCommentReport[]
+  reviewedDiscussionCommentReports EventDiscussionCommentReport[] @relation("ReviewedDiscussionReports")
   bashFeedRatings      BashFeedRating[]
   bashFeedReports      BashFeedReport[]
   reviewedFeedReports  BashFeedReport[]      @relation("ReviewedReports")
@@ -4347,6 +4401,11 @@ model Service {
   sponsorId                          String?                    @unique
   venueId                            String?                    @unique
   organizationId                     String?                    @unique
+  /// Set when this Service was created via "Also list as [complementary type]"
+  /// (e.g. Vendors -> EventServices) as a one-time identity-field prefill copy —
+  /// not an ongoing synced link. Used to avoid creating duplicate complementary
+  /// drafts from repeated clicks; the two profiles are otherwise independent.
+  complementaryOfServiceId           String?
   isFreeFirstListing                 Boolean                    @default(false)
   monthlyPrice                       Decimal                    @default(0)
   serviceListingStripeSubscriptionId String?
@@ -4377,6 +4436,8 @@ model Service {
   exhibitorBookingRequests           ExhibitorBookingRequest[]  @relation("ExhibitorBookingService")
   notification                       Notification[]
   creator                            User?                      @relation("CreatedService", fields: [creatorId], references: [id])
+  complementaryOf                    Service?                   @relation("ComplementaryService", fields: [complementaryOfServiceId], references: [id])
+  complementaryProfiles              Service[]                  @relation("ComplementaryService")
   entertainmentService               EntertainmentService?      @relation(fields: [entertainmentServiceId], references: [id], onDelete: Cascade)
   eventService                       EventService?              @relation(fields: [eventServiceId], references: [id], onDelete: Cascade)
   exhibitor                          Exhibitor?                 @relation(fields: [exhibitorId], references: [id], onDelete: Cascade)
@@ -4416,6 +4477,7 @@ model Service {
   competitionPrizesSourced           Prize[]                    @relation("PrizeSourceService")
   competitionSponsorCredits          CompetitionSponsor[]       @relation("CompetitionSponsorSourceService")
   competitionPrizeOffersSourced    CompetitionPrizeOffer[]    @relation("CompetitionPrizeOfferSourceService")
+  competitionParticipantsSourced   CompetitionParticipant[]   @relation("CompetitionParticipantSourceService")
   venueMatchCandidates               VenueMatchCandidate[]
   supplyLeadConversions              VenueSupplyLead[]          @relation("SupplyLeadConvertedService")
   googleReviews                      GoogleReview[]
@@ -4429,6 +4491,7 @@ model Service {
   @@index([isLicensed])
   @@index([isFeaturedService, featuredReason, featuredAt])
   @@index([latitude, longitude])
+  @@index([complementaryOfServiceId])
 }
 
 model StripeAccount {
@@ -4666,6 +4729,16 @@ model Vendor {
   tierPricing        Json? // For tiered pricing: [{name: "Bronze", priceCents: 100000, description: "..."}, ...]
   pricingNotes       String? // Additional pricing details or terms
 
+  // Guarantee & deal-terms communication (informational only — Bash does not
+  // calculate or process any guarantee shortfall payment). Preferred/minimum
+  // attendance for this context reuses crowdSize (crowdSizeId/AmountOfGuests)
+  // above rather than a separate field.
+  requiresGuarantee            Boolean? @default(false)
+  minimumRevenueGuaranteeCents Int?
+  averageSalesGoalCents        Int?
+  openToGuaranteeNegotiation   Boolean? @default(true)
+  guaranteeNotes               String?  @db.Text
+
   service           Service?
   crowdSize         AmountOfGuests?          @relation(fields: [crowdSizeId], references: [id], onDelete: Cascade)
   serviceRange      ServiceRange?            @relation(fields: [serviceRangeId], references: [id])
@@ -4740,6 +4813,9 @@ model VendorSocialMediaExpectation {
   @@index([preferencesId])
 }
 
+/// @deprecated Not written or read by any live API route — vendor-initiated offers now flow through
+/// the unified ServiceBookingOffer model (see ServiceBooking.isProviderInitiatedOffer). Kept only so
+/// existing rows aren't dropped; do not add new call sites. Slated for removal in a future migration.
 model VendorBid {
   id                    String          @id @default(cuid())
   vendorId              String
@@ -6034,7 +6110,8 @@ model ServiceBooking {
   totalATBCents                     Int
   subtotalATBCents                  Int                            @default(0)
   bashEventId                       String?
-  isVendorBid                       Boolean                        @default(false)
+  // Renamed from isVendorBid: set whenever a ProviderToHost offer (vendor, exhibitor, OR sponsor) is accepted — not vendor-specific.
+  isProviderInitiatedOffer          Boolean                        @default(false) @map("isVendorBid")
   vendorBidAmountCents              Int?
   vendorEventDetails                String?
   bashPointsApplied                 Int? // BashPoints credits applied to this booking
@@ -6204,12 +6281,22 @@ model VendorBookingRequest {
   paidAt                 DateTime?
   vendorResponse         String?
   respondedAt            DateTime?
+  /// Informational counter-offer to the vendor's stated guarantee terms — not a payment obligation.
+  proposedGuaranteeCents Int?
+  proposedGuaranteeNotes String?                 @db.Text
+  /// Host recruiting incentive offered at request-creation time — see VendorCategoryExclusivity.
+  /// Requires bashEventId (exclusivity is scoped to one event) and a Pro+ membership on the host.
+  exclusiveCategoryOffered Boolean?              @default(false)
+  /// Vended product/service categories (VendedProductType/VendorServiceType values) the host
+  /// chose to offer exclusivity for — not necessarily every category the vendor lists.
+  exclusiveCategories    String[]                @default([])
   serviceMessages        ServiceBookingMessage[] @relation("ServiceBookingMessages")
   messages               VendorBookingMessage[]
   bashEvent              BashEvent?              @relation("VendorBookingEvent", fields: [bashEventId], references: [id])
   hostUser               User                    @relation("VendorBookingHost", fields: [hostUserId], references: [id], onDelete: Cascade)
   vendorService          Service                 @relation("VendorBookingService", fields: [vendorServiceId], references: [id], onDelete: Cascade)
   offers                 ServiceBookingOffer[]
+  categoryExclusivities  VendorCategoryExclusivity[]
 
   @@index([hostUserId])
   @@index([vendorServiceId])
@@ -6217,6 +6304,25 @@ model VendorBookingRequest {
   @@index([createdAt])
 }
 
+/// Records a category lock granted when a host's VendorBookingRequest with
+/// exclusiveCategoryOffered=true is accepted. One row per (event, category) the
+/// host chose — a multi-category vendor does not lock every category it lists,
+/// only the ones the host explicitly offered exclusivity for. Released (deleted)
+/// if the underlying accepted request is later cancelled.
+model VendorCategoryExclusivity {
+  id                     String   @id @default(cuid())
+  bashEventId            String
+  /// A VendedProductType or VendorServiceType value.
+  category               String
+  vendorBookingRequestId String
+  createdAt              DateTime @default(now())
+  bashEvent              BashEvent            @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  vendorBookingRequest   VendorBookingRequest @relation(fields: [vendorBookingRequestId], references: [id], onDelete: Cascade)
+
+  @@unique([vendorBookingRequestId, category])
+  @@index([bashEventId, category])
+}
+
 model VendorBookingMessage {
   id                     String               @id @default(cuid())
   createdAt              DateTime             @default(now())
@@ -6775,6 +6881,9 @@ enum NotificationType {
   CompetitionParticipantRequested // Someone requested to join your competition
   CompetitionParticipantApproved // Host approved your request to compete
   CompetitionParticipantRejected // Host rejected your request
+  CompetitionPrizeOfferReceived // Host: someone offered a prize contribution
+  CompetitionPrizeOfferAccepted // Offeror: host accepted your prize offer
+  CompetitionPrizeOfferDeclined // Offeror: host declined your prize offer
   BashRating
   BashRatingMilestone
   BashFeedPost
@@ -9256,6 +9365,10 @@ enum CreditSourceType {
   SideQuestCompletion // Completing a Side Quest on a bash
   SideQuestMilestone // Hitting a Side Quest milestone (e.g. complete N quests)
   CommunityQuestUnlock // Digital reward when a Community Quest goal unlocks
+  CompetitionVote // Completing a Vote-type Side Quest by casting a competition vote
+  CompetitionParticipation // Adventures reward for becoming a competition participant
+  CompetitionFinalist // Adventures reward for reaching a finalist placement
+  CompetitionWin // Adventures reward for winning a competition prize
 }
 
 enum ReferralTier {

package/src/__tests__/competitionValidation.test.ts

@@ -0,0 +1,43 @@
+import {
+  assertAllowedJudgingTypeForNew,
+  DEFAULT_COMPETITION_JUDGING_TYPE,
+  DISALLOWED_JUDGING_TYPE_MESSAGE,
+  getJudgingTypeDescription,
+  getJudgingTypeLabel,
+  isDisallowedJudgingTypeForNew,
+} from "../competitionValidation";
+import { JudgingType } from "../definitions";
+
+describe("competitionValidation", () => {
+  it("defaults new competitions to HOST_CHOOSES", () => {
+    expect(DEFAULT_COMPETITION_JUDGING_TYPE).toBe(JudgingType.HOST_CHOOSES);
+  });
+
+  it("disallows METRICS and FIRST_COME for new competitions", () => {
+    expect(isDisallowedJudgingTypeForNew(JudgingType.METRICS)).toBe(true);
+    expect(isDisallowedJudgingTypeForNew(JudgingType.FIRST_COME)).toBe(true);
+    expect(isDisallowedJudgingTypeForNew(JudgingType.RANDOM_DRAW)).toBe(true);
+    expect(isDisallowedJudgingTypeForNew(JudgingType.HIGHEST_BID)).toBe(true);
+    expect(isDisallowedJudgingTypeForNew(JudgingType.HOST_CHOOSES)).toBe(false);
+  });
+
+  it("throws with the updated disallowed judging message", () => {
+    expect(() =>
+      assertAllowedJudgingTypeForNew(JudgingType.FIRST_COME)
+    ).toThrow(DISALLOWED_JUDGING_TYPE_MESSAGE);
+    expect(DISALLOWED_JUDGING_TYPE_MESSAGE).toMatch(/metrics/i);
+  });
+
+  it("getJudgingTypeLabel returns TBD for null", () => {
+    expect(getJudgingTypeLabel(null)).toBe("TBD");
+    expect(getJudgingTypeLabel(undefined)).toBe("TBD");
+  });
+
+  it("getJudgingTypeDescription covers AUDIENCE_VOTE and legacy types", () => {
+    expect(getJudgingTypeDescription(JudgingType.AUDIENCE_VOTE).length).toBeGreaterThan(
+      0
+    );
+    expect(getJudgingTypeDescription(JudgingType.METRICS).length).toBeGreaterThan(0);
+    expect(getJudgingTypeLabel(JudgingType.FIRST_COME)).toMatch(/first come/i);
+  });
+});

package/src/__tests__/definitionsHelpers.test.ts

@@ -10,6 +10,8 @@ import {
   isUnpaidPayAtDoorTicket,
   TICKET_PURCHASE_TYPE_COMP,
   TICKET_PURCHASE_TYPE_PAY_AT_DOOR,
+  COMPLEMENTARY_SERVICE_TYPE,
+  ServiceTypes,
 } from "../definitions.js";
 
 describe("definitions helpers", () => {
@@ -133,4 +135,18 @@ describe("definitions helpers", () => {
       ).toBe(false);
     });
   });
+
+  describe("COMPLEMENTARY_SERVICE_TYPE", () => {
+    test("pairs Vendors and EventServices both ways", () => {
+      expect(COMPLEMENTARY_SERVICE_TYPE[ServiceTypes.Vendors]).toBe(
+        ServiceTypes.EventServices
+      );
+      expect(COMPLEMENTARY_SERVICE_TYPE[ServiceTypes.EventServices]).toBe(
+        ServiceTypes.Vendors
+      );
+      expect(
+        COMPLEMENTARY_SERVICE_TYPE[ServiceTypes.EntertainmentServices]
+      ).toBeUndefined();
+    });
+  });
 });

package/src/__tests__/membershipDefinitions.test.ts

@@ -65,6 +65,24 @@ describe("membershipDefinitions helpers", () => {
       );
     });
 
+    test("Pro unlocks vendor category exclusivity", () => {
+      expect(
+        hasFeatureAccess(
+          MembershipTier.Pro,
+          MEMBERSHIP_FEATURES.VENDOR_CATEGORY_EXCLUSIVITY
+        )
+      ).toBe(true);
+      expect(
+        hasFeatureAccess(
+          MembershipTier.Premium,
+          MEMBERSHIP_FEATURES.VENDOR_CATEGORY_EXCLUSIVITY
+        )
+      ).toBe(false);
+      expect(
+        getRequiredTierForFeature(MEMBERSHIP_FEATURES.VENDOR_CATEGORY_EXCLUSIVITY)
+      ).toBe(MembershipTier.Pro);
+    });
+
     test("unknown feature returns false", () => {
       expect(hasFeatureAccess(MembershipTier.Legend, "not_a_feature")).toBe(false);
     });

package/src/__tests__/sideQuestIdeas.test.ts

@@ -1,4 +1,9 @@
-import { filterSideQuestIdeas, SIDE_QUEST_IDEAS } from "../sideQuestIdeas";
+import {
+  filterSideQuestIdeas,
+  SIDE_QUEST_IDEAS,
+  SIDE_QUEST_PHASE1_TYPES,
+  SIDE_QUEST_TYPE_META,
+} from "../sideQuestIdeas";
 
 describe("sideQuestIdeas", () => {
   it("includes festival and market templates", () => {
@@ -13,4 +18,9 @@ describe("sideQuestIdeas", () => {
     expect(hits.length).toBeGreaterThan(0);
     expect(hits.every((h) => JSON.stringify(h).toLowerCase().includes("transit") || h.category === "Transit")).toBe(true);
   });
+
+  it("includes Vote in phase 1 types", () => {
+    expect(SIDE_QUEST_PHASE1_TYPES).toContain("Vote");
+    expect(SIDE_QUEST_TYPE_META.Vote.phase1).toBe(true);
+  });
 });

package/src/__tests__/statusEnums.test.ts

@@ -139,6 +139,13 @@ describe("status enum value sets", () => {
         "ReferralCodeUsed",
         "VenueLoyaltyRedemption",
         "PartnerPromoRedemption",
+        "SideQuestCompletion",
+        "SideQuestMilestone",
+        "CommunityQuestUnlock",
+        "CompetitionVote",
+        "CompetitionParticipation",
+        "CompetitionFinalist",
+        "CompetitionWin",
       ].sort(),
     );
   });

package/src/competitionValidation.ts

@@ -17,14 +17,20 @@ export function parseJudgingType(
   return value as JudgingType;
 }
 
-/** Judging modes disallowed for new competitions (lottery / auction-adjacent). */
+/**
+ * Judging modes disallowed for new competitions: lottery / auction-adjacent
+ * (RANDOM_DRAW, HIGHEST_BID), plus METRICS and FIRST_COME which have no
+ * winner-resolution implementation yet (dead ends for hosts).
+ */
 export const DISALLOWED_JUDGING_TYPES_FOR_NEW: ReadonlySet<JudgingType> = new Set([
   JudgingType.RANDOM_DRAW,
   JudgingType.HIGHEST_BID,
+  JudgingType.METRICS,
+  JudgingType.FIRST_COME,
 ]);
 
 export const DISALLOWED_JUDGING_TYPE_MESSAGE =
-  "Random draw and highest-bid judging are not supported on Bash. Use host choice, skill judging, audience vote, metrics, first come, or tournament bracket.";
+  "Random draw, highest-bid, metrics, and first-come judging are not supported on Bash yet. Use host choice, skill judging, audience vote, or tournament bracket.";
 
 export function isDisallowedJudgingTypeForNew(
   judgingType: JudgingType | null | undefined
@@ -45,6 +51,54 @@ export function assertAllowedJudgingTypeForNew(
 export const DEFAULT_COMPETITION_JUDGING_TYPE: JudgingType =
   JudgingType.HOST_CHOOSES;
 
+/** Single source of truth for judging-type copy — shared by the host wizard and guest-facing display. */
+export const JUDGING_TYPE_LABELS: Record<JudgingType, string> = {
+  [JudgingType.RANDOM_DRAW]: "Drawing (legacy)",
+  [JudgingType.HIGHEST_BID]: "Highest Bid (legacy)",
+  [JudgingType.HOST_CHOOSES]: "Host Selection",
+  [JudgingType.JUDGES]: "Panel of Judges",
+  [JudgingType.AUDIENCE_VOTE]: "Audience Vote",
+  [JudgingType.METRICS]: "Performance Metrics",
+  [JudgingType.FIRST_COME]: "First Come First Serve",
+  [JudgingType.BRACKET_TOURNAMENT]: "Bracket Tournament",
+};
+
+export const JUDGING_TYPE_DESCRIPTIONS: Record<JudgingType, string> = {
+  [JudgingType.RANDOM_DRAW]:
+    "This competition uses a legacy random drawing configuration. New competitions on Bash use host choice, skill judging, audience vote, or tournament formats.",
+  [JudgingType.HIGHEST_BID]:
+    "Legacy auction-style configuration. New competitions on Bash do not support highest-bid judging.",
+  [JudgingType.HOST_CHOOSES]:
+    "The event host will personally select the winner(s) based on their criteria.",
+  [JudgingType.JUDGES]:
+    "A panel of judges will evaluate participants based on specific criteria and select the winner(s).",
+  [JudgingType.AUDIENCE_VOTE]:
+    "Attendees will vote to determine the winner(s). The participant(s) with the most votes win!",
+  [JudgingType.METRICS]:
+    "Winners are determined by measurable performance metrics and objective criteria.",
+  [JudgingType.FIRST_COME]:
+    "Winners are determined by order of participation - first to sign up or complete wins!",
+  [JudgingType.BRACKET_TOURNAMENT]:
+    "Participants compete head-to-head in a tournament bracket. Winners advance through rounds until a champion is determined.",
+};
+
+export function getJudgingTypeLabel(
+  judgingType: JudgingType | null | undefined
+): string {
+  if (!judgingType) return "TBD";
+  return JUDGING_TYPE_LABELS[judgingType] ?? "TBD";
+}
+
+export function getJudgingTypeDescription(
+  judgingType: JudgingType | null | undefined
+): string {
+  if (!judgingType) return "The judging method has not been determined yet.";
+  return (
+    JUDGING_TYPE_DESCRIPTIONS[judgingType] ??
+    "The judging method has not been determined yet."
+  );
+}
+
 export function normalizeJudgingTypeForSave(
   judgingType: JudgingType | null | undefined,
   isExistingLegacy: boolean

package/src/definitions.ts

@@ -44,6 +44,35 @@ import type { UtmFields } from "./utmAttribution.js";
  * values — importing them from `@prisma/client` yields `undefined` and crashes on first
  * property access. These mirrors match the Prisma schema / full client enum strings.
  */
+/**
+ * "Also list as [complementary type]" — a one-time identity-field prefill copy
+ * (see Service.complementaryOfServiceId), not an ongoing synced link. Scoped to
+ * the Vendors <-> EventServices pairing only (e.g. a food truck that vends
+ * publicly at festivals and is also paid a flat fee at private weddings).
+ */
+export const COMPLEMENTARY_SERVICE_TYPE: Partial<
+  Record<ServiceTypes, ServiceTypes>
+> = {
+  [ServiceTypes.Vendors]: ServiceTypes.EventServices,
+  [ServiceTypes.EventServices]: ServiceTypes.Vendors,
+};
+
+/**
+ * Human-readable label for a ServiceTypes value — the raw enum ("EventServices")
+ * is not fit for display copy. Only covers the values COMPLEMENTARY_SERVICE_TYPE
+ * can produce; extend as more callers need display labels for other types.
+ */
+export const SERVICE_TYPE_DISPLAY_LABEL: Partial<Record<ServiceTypes, string>> =
+  {
+    [ServiceTypes.Vendors]: "Vendor",
+    [ServiceTypes.EventServices]: "Event Service",
+  };
+
+/** Picks "a"/"an" for the given word, e.g. for "a Vendor" vs "an Event Service". */
+export function articleFor(word: string): "a" | "an" {
+  return /^[aeiou]/i.test(word) ? "an" : "a";
+}
+
 export const ServiceBookingOfferDirection = {
     HostToProvider: "HostToProvider",
     ProviderToHost: "ProviderToHost",
@@ -1161,7 +1190,17 @@ export const YearsOfExperienceToString: { [key in YearsOfExperienceEnum]: string
     [YearsOfExperience.FivePlusYears]: "More than five years",
   };
 
-export { BracketType } from "./mirroredPrismaEnums.js";
+export { BracketType, ServiceBookingSettlementStatusLabel } from "./mirroredPrismaEnums.js";
+
+// Re-exported for backward compatibility during migration — see serviceTypeLabels.ts/targetAudienceLabels.ts
+// for the canonical, consolidated source (following the BracketType precedent above).
+export { SERVICE_TYPE_LABELS } from "./serviceTypeLabels.js";
+export {
+  AgeRangeLabel,
+  EducationLabel,
+  GenderLabel,
+  OccupationLabel,
+} from "./targetAudienceLabels.js";
 
 // Export Prisma enums for use in frontend
 export {