@bash-app/bash-common 30.306.0 → 30.308.0

package/dist/sideQuestIdeas.js

@@ -0,0 +1,215 @@
+/**
+ * Side Quest starter templates and category display metadata.
+ * Behavior design: Action → Prove (quest type) → Reward.
+ */
+export const SIDE_QUEST_CATEGORY_META = {
+    Explore: { label: "Explore", emoji: "🧭" },
+    Connect: { label: "Connect", emoji: "🤝" },
+    Discover: { label: "Discover", emoji: "🎵" },
+    SupportLocal: { label: "Support Local", emoji: "🛍️" },
+    Compete: { label: "Compete", emoji: "🏆" },
+    Transit: { label: "Transit", emoji: "🚆" },
+    Create: { label: "Create", emoji: "📸" },
+    GiveBack: { label: "Give Back", emoji: "❤️" },
+};
+/** Phase 1 host-selectable quest types */
+export const SIDE_QUEST_PHASE1_TYPES = ["Qr", "Code"];
+export const SIDE_QUEST_TYPE_META = {
+    Qr: {
+        label: "QR Quest",
+        description: "Guest scans a printed QR at the location.",
+        phase1: true,
+    },
+    Code: {
+        label: "Code Quest",
+        description: "Guest enters a short code shown on-site.",
+        phase1: true,
+    },
+    Gps: {
+        label: "GPS Quest",
+        description: "Guest checks in near a location.",
+        phase1: false,
+    },
+    Photo: {
+        label: "Photo Quest",
+        description: "Guest uploads a photo as proof.",
+        phase1: false,
+    },
+    CheckIn: {
+        label: "Check-in Quest",
+        description: "Tied to event ticket check-in.",
+        phase1: false,
+    },
+    Purchase: {
+        label: "Purchase Quest",
+        description: "Completes after a qualifying purchase.",
+        phase1: false,
+    },
+    Vote: {
+        label: "Vote Quest",
+        description: "Completes after voting in a competition.",
+        phase1: false,
+    },
+    Sponsor: {
+        label: "Sponsor Quest",
+        description: "Visit or engage with a sponsor booth.",
+        phase1: false,
+    },
+    Social: {
+        label: "Social Quest",
+        description: "Share or tag on social.",
+        phase1: false,
+    },
+    Trivia: {
+        label: "Trivia Quest",
+        description: "Answer a question correctly.",
+        phase1: false,
+    },
+};
+export const SIDE_QUEST_IDEAS = [
+    {
+        id: "festival-transit",
+        title: "Ride transit to the festival",
+        description: "Take FrontRunner, TRAX, or the bus — scan the code at the station booth.",
+        category: "Transit",
+        questType: "Qr",
+        pointsReward: 100,
+        tags: ["festival", "transit"],
+    },
+    {
+        id: "festival-vendor",
+        title: "Try food from a local vendor",
+        description: "Support a food vendor on site and grab their quest code.",
+        category: "SupportLocal",
+        questType: "Code",
+        pointsReward: 50,
+        tags: ["festival", "food"],
+    },
+    {
+        id: "festival-artists",
+        title: "Watch 3 different artists",
+        description: "Catch three sets — collect the stage code after the third.",
+        category: "Discover",
+        questType: "Code",
+        pointsReward: 75,
+        tags: ["festival", "music"],
+    },
+    {
+        id: "festival-photo",
+        title: "Take a photo at the landmark",
+        description: "Find the landmark and scan the QR nearby.",
+        category: "Create",
+        questType: "Qr",
+        pointsReward: 25,
+        tags: ["festival", "photo"],
+    },
+    {
+        id: "market-three-vendors",
+        title: "Buy from 3 vendors",
+        description: "Support three market stalls — get the code from the info booth when done.",
+        category: "SupportLocal",
+        questType: "Code",
+        pointsReward: 75,
+        tags: ["market"],
+    },
+    {
+        id: "market-meet-farmer",
+        title: "Meet a farmer",
+        description: "Say hello to a grower and scan their booth QR.",
+        category: "Connect",
+        questType: "Qr",
+        pointsReward: 50,
+        tags: ["market"],
+    },
+    {
+        id: "conference-keynote",
+        title: "Attend a keynote",
+        description: "Sit in on a keynote — scan the room QR on the way out.",
+        category: "Discover",
+        questType: "Qr",
+        pointsReward: 50,
+        tags: ["conference"],
+    },
+    {
+        id: "conference-meet-five",
+        title: "Meet five new people",
+        description: "Network intentionally — enter the lounge code when you've made five intros.",
+        category: "Connect",
+        questType: "Code",
+        pointsReward: 75,
+        tags: ["conference"],
+    },
+    {
+        id: "campus-club",
+        title: "Join a club fair booth",
+        description: "Stop by a student org table and scan their QR.",
+        category: "Connect",
+        questType: "Qr",
+        pointsReward: 40,
+        tags: ["campus"],
+    },
+    {
+        id: "downtown-mural",
+        title: "Find a hidden mural",
+        description: "Hunt the mural and scan the nearby QR.",
+        category: "Explore",
+        questType: "Qr",
+        pointsReward: 60,
+        tags: ["downtown"],
+    },
+    {
+        id: "give-back-volunteer",
+        title: "Complete a volunteer shift",
+        description: "Help out — staff will share the completion code.",
+        category: "GiveBack",
+        questType: "Code",
+        pointsReward: 100,
+        tags: ["volunteer"],
+    },
+    {
+        id: "compete-vote",
+        title: "Vote for your favorite",
+        description: "Cast your vote — use the code shown after you submit.",
+        category: "Compete",
+        questType: "Code",
+        pointsReward: 25,
+        tags: ["festival", "vote"],
+    },
+];
+export function filterSideQuestIdeas(search) {
+    const q = search.trim().toLowerCase();
+    if (!q)
+        return SIDE_QUEST_IDEAS;
+    return SIDE_QUEST_IDEAS.filter((idea) => idea.title.toLowerCase().includes(q) ||
+        idea.description.toLowerCase().includes(q) ||
+        idea.tags.some((t) => t.toLowerCase().includes(q)) ||
+        idea.category.toLowerCase().includes(q));
+}
+/** Lifetime achievement catalog (Phase 2 awarding; definitions ship now). */
+export const ADVENTURE_ACHIEVEMENT_CATALOG = [
+    {
+        id: "explorer",
+        name: "Explorer",
+        description: "Completed 100 Side Quests",
+        threshold: 100,
+    },
+    {
+        id: "foodie",
+        name: "Foodie",
+        description: "Visited 50 vendors via Support Local quests",
+        threshold: 50,
+    },
+    {
+        id: "festival-veteran",
+        name: "Festival Veteran",
+        description: "Attended 25 festivals with Side Quests",
+        threshold: 25,
+    },
+    {
+        id: "transit-hero",
+        name: "Transit Hero",
+        description: "Rode transit to 15 events",
+        threshold: 15,
+    },
+];
+//# sourceMappingURL=sideQuestIdeas.js.map

package/dist/sideQuestIdeas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sideQuestIdeas.js","sourceRoot":"","sources":["../src/sideQuestIdeas.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bash-app/bash-common",
-  "version": "30.306.0",
+  "version": "30.308.0",
   "description": "Common data and scripts to use on the frontend and backend",
   "type": "module",
   "main": "dist/index.js",

package/prisma/schema.prisma

@@ -842,6 +842,9 @@ model BashEvent {
   smsConfirmationsEnabled     Boolean                @default(false)
   /// Collect named holder per seat at checkout.
   namedTicketsEnabled         Boolean                @default(false)
+  /// Max companions a guest may bring (0 = alone, 1 = +1, 2 = +2, null = unlimited).
+  /// Applies to RSVP plus-ones and ticketed seats-per-buyer. Null preserves open defaults.
+  maxAdditionalGuests         Int?
   attendeeDisplayMode         String                 @default("All") // "All" | "CountOnly" | "NetworkOnly" | "Hidden"
   /// Optional headline above featured guests on bash detail (curated guest visibility).
   featuredGuestsHeadline      String?
@@ -1038,6 +1041,13 @@ model BashEvent {
   discussionComments   EventDiscussionComment[]
   bashEventDonations   BashEventDonation[]
 
+  // Adventures / Side Quests
+  sideQuests           SideQuest[]
+  eventBadges          EventBadge[]
+  sideQuestMilestones  SideQuestMilestone[]
+  sideQuestPrizeEntries SideQuestPrizeEntry[]
+  communityQuestGoal   CommunityQuestGoal?
+
   // User night itineraries (events in user's "My Night" plan)
   userItineraryItems UserItineraryItem[]
 
@@ -1981,6 +1991,192 @@ model EventReferralReward {
   @@index([bashEventId])
 }
 
+// --- Adventures / Side Quests (behavior design engine) ---
+
+enum SideQuestCategory {
+  Explore
+  Connect
+  Discover
+  SupportLocal
+  Compete
+  Transit
+  Create
+  GiveBack
+}
+
+/// How the guest proves completion. Phase 1: Qr + Code. Others reserved.
+enum SideQuestType {
+  Qr
+  Code
+  Gps
+  Photo
+  CheckIn
+  Purchase
+  Vote
+  Sponsor
+  Social
+  Trivia
+}
+
+enum EventBadgeAwardSource {
+  SideQuest
+  Milestone
+  Manual
+  Community
+}
+
+model SideQuest {
+  id                       String            @id @default(cuid())
+  bashEventId              String
+  title                    String
+  description              String?
+  sortOrder                Int               @default(0)
+  category                 SideQuestCategory @default(Explore)
+  questType                SideQuestType     @default(Code)
+  /// Short display code for hosts/guests (e.g. 4-digit). Guests submit this; never treat as the only secret.
+  code                     String
+  /// SHA-256 hex of normalized code — server verification
+  codeHash                 String
+  pointsReward             Int               @default(0)
+  raffleEntriesOnComplete  Int               @default(0)
+  eventBadgeId             String?
+  startsAt                 DateTime?
+  endsAt                   DateTime?
+  maxCompletions           Int?
+  isHidden                 Boolean           @default(false)
+  unlockedAt               DateTime?
+  sponsorLabel             String?
+  sponsorServiceId         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)
+  completions  SideQuestCompletion[]
+  milestonesUnlocking SideQuestMilestone[] @relation("MilestoneUnlocksQuest")
+
+  @@index([bashEventId])
+  @@index([bashEventId, sortOrder])
+  @@index([eventBadgeId])
+}
+
+model SideQuestCompletion {
+  id          String        @id @default(cuid())
+  sideQuestId String
+  userId      String
+  completedAt DateTime      @default(now())
+  questType   SideQuestType
+
+  sideQuest SideQuest @relation(fields: [sideQuestId], references: [id], onDelete: Cascade)
+  user      User      @relation("SideQuestCompletions", fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([sideQuestId, userId])
+  @@index([userId])
+  @@index([sideQuestId])
+}
+
+model EventBadge {
+  id              String   @id @default(cuid())
+  bashEventId     String
+  name            String
+  description     String?
+  imageUrl        String
+  createdByUserId String
+  createdAt       DateTime @default(now())
+  updatedAt       DateTime @updatedAt
+
+  bashEvent   BashEvent         @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  createdBy   User              @relation("EventBadgesCreated", fields: [createdByUserId], references: [id], onDelete: Cascade)
+  awards      EventBadgeAward[]
+  sideQuests  SideQuest[]
+  milestones  SideQuestMilestone[]
+  communityGoals CommunityQuestGoal[]
+
+  @@index([bashEventId])
+  @@index([createdByUserId])
+}
+
+model EventBadgeAward {
+  id           String                @id @default(cuid())
+  eventBadgeId String
+  userId       String
+  awardedAt    DateTime              @default(now())
+  sourceType   EventBadgeAwardSource
+  sourceId     String?
+
+  eventBadge EventBadge @relation(fields: [eventBadgeId], references: [id], onDelete: Cascade)
+  user       User       @relation("EventBadgeAwards", fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([eventBadgeId, userId])
+  @@index([userId])
+}
+
+model SideQuestMilestone {
+  id                   String  @id @default(cuid())
+  bashEventId          String
+  requiredCompletions  Int
+  bashPointsReward     Int?
+  eventBadgeId         String?
+  raffleEntries        Int?
+  unlockSideQuestId    String?
+  sortOrder            Int     @default(0)
+  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)
+  unlockSideQuest SideQuest? @relation("MilestoneUnlocksQuest", fields: [unlockSideQuestId], references: [id], onDelete: SetNull)
+  claims          SideQuestMilestoneClaim[]
+
+  @@index([bashEventId])
+}
+
+model SideQuestMilestoneClaim {
+  id          String   @id @default(cuid())
+  milestoneId String
+  userId      String
+  claimedAt   DateTime @default(now())
+
+  milestone SideQuestMilestone @relation(fields: [milestoneId], references: [id], onDelete: Cascade)
+  user      User               @relation("SideQuestMilestoneClaims", fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([milestoneId, userId])
+  @@index([userId])
+}
+
+model SideQuestPrizeEntry {
+  id                 String   @id @default(cuid())
+  bashEventId        String
+  userId             String
+  entries            Int      @default(1)
+  sourceCompletionId String?
+  sourceMilestoneId  String?
+  sourceType         String   @default("SideQuest")
+  createdAt          DateTime @default(now())
+
+  bashEvent BashEvent @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  user      User      @relation("SideQuestPrizeEntries", fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([bashEventId, userId])
+  @@index([userId])
+}
+
+model CommunityQuestGoal {
+  id                 String    @id @default(cuid())
+  bashEventId        String    @unique
+  targetCompletions  Int
+  currentCompletions Int       @default(0)
+  rewardLabel        String
+  eventBadgeId       String?
+  bashPointsReward   Int?
+  unlockedAt         DateTime?
+  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)
+}
+
 enum BackgroundEffect {
   None
   Confetti
@@ -3414,6 +3610,11 @@ model User {
   competitionVotes               CompetitionVote[]
   competitionJudgeAssignments    CompetitionJudgeAssignment[] @relation("CompetitionJudgeAssignments")
   competitionJudgeScoresAuthored CompetitionJudgeScore[]      @relation("CompetitionJudgeScoresAuthored")
+  sideQuestCompletions           SideQuestCompletion[]        @relation("SideQuestCompletions")
+  eventBadgesCreated             EventBadge[]                 @relation("EventBadgesCreated")
+  eventBadgeAwards               EventBadgeAward[]            @relation("EventBadgeAwards")
+  sideQuestMilestoneClaims       SideQuestMilestoneClaim[]    @relation("SideQuestMilestoneClaims")
+  sideQuestPrizeEntries          SideQuestPrizeEntry[]        @relation("SideQuestPrizeEntries")
   contacts                       Contact[]
   contactLists                   ContactList[]                @relation("UserContactLists")
   contactlist                    ContactList[]
@@ -9050,6 +9251,9 @@ enum CreditSourceType {
   ReferralCodeUsed // Flat bonus for referrer when code drives a ticket/signup
   VenueLoyaltyRedemption // BashPoints moved through a VenueLoyaltyRedemption claim/redeem/refund
   PartnerPromoRedemption // BashPoints spent to unlock a local partner promo code
+  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
 }
 
 enum ReferralTier {

package/src/__tests__/guestPartySize.test.ts

@@ -0,0 +1,31 @@
+import {
+  resolveMaxPlusOnes,
+  resolveMaxSeatsPerBuyer,
+  rsvpPartyPolicyGuestCopy,
+  seatsForTicketQuantity,
+  ticketPartyPolicyGuestCopy,
+} from "../guestPartySize.js";
+
+describe("guestPartySize", () => {
+  it("resolveMaxSeatsPerBuyer", () => {
+    expect(resolveMaxSeatsPerBuyer(0)).toBe(1);
+    expect(resolveMaxSeatsPerBuyer(1)).toBe(2);
+    expect(resolveMaxSeatsPerBuyer(null)).toBeNull();
+    expect(resolveMaxSeatsPerBuyer(2, 1)).toBe(1);
+  });
+
+  it("resolveMaxPlusOnes soft-caps unlimited", () => {
+    expect(resolveMaxPlusOnes(null)).toBe(10);
+    expect(resolveMaxPlusOnes(0)).toBe(0);
+  });
+
+  it("seatsForTicketQuantity expands group packages", () => {
+    expect(seatsForTicketQuantity(1, 6, true)).toBe(6);
+  });
+
+  it("guest copy helpers", () => {
+    expect(rsvpPartyPolicyGuestCopy(0)).toMatch(/no plus-ones/i);
+    expect(ticketPartyPolicyGuestCopy(1)).toBe("Up to 2 tickets per person");
+    expect(ticketPartyPolicyGuestCopy(null)).toBeNull();
+  });
+});

package/src/__tests__/sideQuestIdeas.test.ts

@@ -0,0 +1,16 @@
+import { filterSideQuestIdeas, SIDE_QUEST_IDEAS } from "../sideQuestIdeas";
+
+describe("sideQuestIdeas", () => {
+  it("includes festival and market templates", () => {
+    expect(SIDE_QUEST_IDEAS.some((i) => i.tags.includes("festival"))).toBe(
+      true
+    );
+    expect(SIDE_QUEST_IDEAS.some((i) => i.tags.includes("market"))).toBe(true);
+  });
+
+  it("filters by search", () => {
+    const hits = filterSideQuestIdeas("transit");
+    expect(hits.length).toBeGreaterThan(0);
+    expect(hits.every((h) => JSON.stringify(h).toLowerCase().includes("transit") || h.category === "Transit")).toBe(true);
+  });
+});

package/src/extendedSchemas.ts

@@ -478,6 +478,10 @@ export interface BashEventExt extends Override<
    * (host absorbs processing, no external checkout). Drives "No fees for attendees" badge.
    */
   guestCheckoutHasNoAddedFees?: boolean;
+  /**
+   * Partner-scraped listing still open for an organizer to claim (detail page CTA).
+   */
+  listingClaimable?: boolean;
   /** When eventType is a CustomBashEventType id, resolved display name for filters/UI */
   customType?: { displayName?: string | null } | null;
   /** Wizard context when bash is loaded via AssociatedBash (organizer invitation flow) */

package/src/guestPartySize.ts

@@ -0,0 +1,83 @@
+/**
+ * Event-level guest party size (plus-ones / seats-per-buyer).
+ * maxAdditionalGuests: 0 = alone, 1 = +1, 2 = +2, null = unlimited.
+ */
+
+export const RSVP_PLUS_ONES_UI_SOFT_CAP = 10;
+export const RSVP_PLUS_ONES_API_HARD_CAP = 20;
+
+/** Max seats one buyer may hold (owned + cart). null = unlimited. */
+export function resolveMaxSeatsPerBuyer(
+  maxAdditionalGuests: number | null | undefined,
+  tierMaxTicketsPerUser?: number | null
+): number | null {
+  let eventCap: number | null = null;
+  if (maxAdditionalGuests != null && Number.isFinite(maxAdditionalGuests)) {
+    eventCap = Math.max(0, Math.floor(maxAdditionalGuests)) + 1;
+  }
+  const tierCap =
+    tierMaxTicketsPerUser != null && Number.isFinite(tierMaxTicketsPerUser)
+      ? Math.max(0, Math.floor(tierMaxTicketsPerUser))
+      : null;
+
+  if (eventCap == null && tierCap == null) return null;
+  if (eventCap == null) return tierCap;
+  if (tierCap == null) return eventCap;
+  return Math.min(eventCap, tierCap);
+}
+
+/** Max plus-ones for RSVP UI/API. */
+export function resolveMaxPlusOnes(
+  maxAdditionalGuests: number | null | undefined,
+  softCap = RSVP_PLUS_ONES_UI_SOFT_CAP
+): number {
+  if (maxAdditionalGuests == null) return softCap;
+  return Math.max(0, Math.min(softCap, Math.floor(maxAdditionalGuests)));
+}
+
+export function seatsForTicketQuantity(
+  quantity: number,
+  groupTicketSeatCount?: number | null,
+  isGroupTicket?: boolean | null
+): number {
+  const qty = Math.max(0, Math.floor(quantity));
+  if (isGroupTicket && groupTicketSeatCount && groupTicketSeatCount > 0) {
+    return qty * groupTicketSeatCount;
+  }
+  return qty;
+}
+
+export function guestPartyPolicyLabel(
+  maxAdditionalGuests: number | null | undefined
+): string {
+  if (maxAdditionalGuests === 0) return "No plus-ones";
+  if (maxAdditionalGuests === 1) return "Plus one";
+  if (maxAdditionalGuests === 2) return "Plus two";
+  return "Unlimited";
+}
+
+/** Guest-facing RSVP copy. */
+export function rsvpPartyPolicyGuestCopy(
+  maxAdditionalGuests: number | null | undefined
+): string {
+  if (maxAdditionalGuests === 0) return "Just you — no plus-ones";
+  if (maxAdditionalGuests === 1) return "You can bring up to 1 guest";
+  if (maxAdditionalGuests === 2) return "You can bring up to 2 guests";
+  return `You can bring up to ${RSVP_PLUS_ONES_UI_SOFT_CAP} guests`;
+}
+
+/** Guest-facing ticketed copy. */
+export function ticketPartyPolicyGuestCopy(
+  maxAdditionalGuests: number | null | undefined
+): string | null {
+  if (maxAdditionalGuests == null) return null;
+  const seats = maxAdditionalGuests + 1;
+  if (seats === 1) return "1 ticket per person";
+  return `Up to ${seats} tickets per person`;
+}
+
+export function nearCapacityPartyError(spotsLeft: number): string {
+  if (spotsLeft <= 0) return "This bash is at capacity.";
+  if (spotsLeft === 1) return "Only 1 spot left — you can’t bring that many guests.";
+  return `Only ${spotsLeft} spots left — you can’t bring that many guests.`;
+}

package/src/index.ts

@@ -7,9 +7,11 @@ export * from "./venueLoyaltyRedemption.js";
 export * from "./stripeListingSubscriptionMessages.js";
 export * from "./extendedSchemas.js";
 export * from "./competitionIdeas.js";
+export * from "./sideQuestIdeas.js";
 export * from "./icebreakerPrompts.js";
 export * from "./competitionValidation.js";
 export * from "./groupTicketUtils.js";
+export * from "./guestPartySize.js";
 export * from "./utils/groupTicketCartUtils.js";
 export * from "./partnerStoreTypes.js";
 export * from "./storeTypes.js";

package/src/mirroredPrismaEnums.ts

@@ -177,6 +177,9 @@ export const CreditSourceType = {
   ReferralCodeUsed: "ReferralCodeUsed",
   VenueLoyaltyRedemption: "VenueLoyaltyRedemption",
   PartnerPromoRedemption: "PartnerPromoRedemption",
+  SideQuestCompletion: "SideQuestCompletion",
+  SideQuestMilestone: "SideQuestMilestone",
+  CommunityQuestUnlock: "CommunityQuestUnlock",
 } as const satisfies Record<CreditSourceTypeEnum, CreditSourceTypeEnum>;
 
 export type CreditSourceType = CreditSourceTypeEnum;