@bash-app/bash-common 30.307.0 → 30.309.0

package/dist/sideQuestTypes.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Shared Side Quest / Adventures API shapes and QR deep-link helpers.
+ */
+import type { SideQuestCategoryId, SideQuestTypeId } from "./sideQuestIdeas.js";
+export interface EventBadgeExt {
+    id: string;
+    bashEventId: string;
+    name: string;
+    description: string | null;
+    imageUrl: string;
+    createdByUserId?: string;
+}
+export interface SideQuestExt {
+    id: string;
+    title: string;
+    description: string | null;
+    sortOrder: number;
+    category: SideQuestCategoryId | string;
+    questType: SideQuestTypeId | string;
+    pointsReward: number;
+    raffleEntriesOnComplete: number;
+    eventBadgeId: string | null;
+    eventBadge?: Pick<EventBadgeExt, "id" | "name" | "imageUrl" | "description"> | null;
+    startsAt: string | Date | null;
+    endsAt: string | Date | null;
+    maxCompletions: number | null;
+    isHidden: boolean;
+    isLocked?: boolean;
+    unlockedAt: string | Date | null;
+    sponsorLabel: string | null;
+    completed?: boolean;
+    code?: string;
+    completionCount?: number;
+}
+export interface SideQuestMilestoneExt {
+    id: string;
+    requiredCompletions: number;
+    bashPointsReward: number | null;
+    eventBadgeId: string | null;
+    raffleEntries: number | null;
+    unlockSideQuestId: string | null;
+    sortOrder: number;
+}
+export interface CommunityQuestGoalExt {
+    id?: string;
+    targetCompletions: number;
+    currentCompletions?: number;
+    rewardLabel: string;
+    eventBadgeId?: string | null;
+    bashPointsReward?: number | null;
+    unlockedAt?: string | Date | null;
+}
+export interface SideQuestLogExt {
+    quests: SideQuestExt[];
+    availableCount: number;
+    completedCount: number;
+    hiddenCount: number;
+    badgesEarned: EventBadgeExt[];
+    eventBadges: EventBadgeExt[];
+    raffleEntries: number;
+    pointsFromQuests: number;
+    community: CommunityQuestGoalExt | null;
+}
+export interface SideQuestHostBundleExt {
+    quests: SideQuestExt[];
+    milestones: SideQuestMilestoneExt[];
+    community: CommunityQuestGoalExt | null;
+    badges: EventBadgeExt[];
+}
+export interface SideQuestAnalyticsExt {
+    uniqueCompleters: number;
+    totalCompletions: number;
+    raffleEntriesTotal: number;
+    community: CommunityQuestGoalExt | null;
+    perQuest: Array<{
+        questId: string;
+        title: string;
+        sponsorLabel: string | null;
+        completionCount: number;
+    }>;
+    sponsorRollup: Array<{
+        sponsorLabel: string;
+        completionCount: number;
+    }>;
+    recentCompletions: Array<{
+        completionId: string;
+        questId: string;
+        questTitle: string;
+        userId: string;
+        displayName: string;
+        completedAt: string | Date;
+    }>;
+}
+/** Absolute or path-only HTTPS deep link for booth QR codes. */
+export declare function buildSideQuestDeepLink(params: {
+    bashEventId: string;
+    questId: string;
+    code: string;
+    /** Origin without trailing slash, e.g. https://bash.community */
+    frontendOrigin?: string;
+    slug?: string | null;
+}): string;
+/** Legacy opaque payload (still accepted when pasted). */
+export declare function buildSideQuestLegacyPayload(bashEventId: string, questId: string, code: string): string;
+export type ParsedSideQuestScan = {
+    bashEventId?: string;
+    questId?: string;
+    code: string;
+};
+/**
+ * Parse a scanned/pasted value into quest id + code.
+ * Supports HTTPS ticket-details URLs and legacy `bash-side-quest:` payloads.
+ */
+export declare function parseSideQuestScanPayload(raw: string): ParsedSideQuestScan | null;
+//# sourceMappingURL=sideQuestTypes.d.ts.map

package/dist/sideQuestTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sideQuestTypes.d.ts","sourceRoot":"","sources":["../src/sideQuestTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEhF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAAC;IACvC,SAAS,EAAE,eAAe,GAAG,MAAM,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,IAAI,CACf,aAAa,EACb,IAAI,GAAG,MAAM,GAAG,UAAU,GAAG,aAAa,CAC3C,GAAG,IAAI,CAAC;IACT,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,SAAS,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACxC,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACxC,QAAQ,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,aAAa,EAAE,KAAK,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,iBAAiB,EAAE,KAAK,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC,CAAC;CACJ;AAID,gEAAgE;AAChE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,GAAG,MAAM,CAST;AAED,0DAA0D;AAC1D,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,MAAM,CAGR;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAyCjF"}

package/dist/sideQuestTypes.js

@@ -0,0 +1,67 @@
+/**
+ * Shared Side Quest / Adventures API shapes and QR deep-link helpers.
+ */
+import { TICKET_DETAILS } from "./definitions.js";
+const LEGACY_PREFIX = "bash-side-quest:";
+/** Absolute or path-only HTTPS deep link for booth QR codes. */
+export function buildSideQuestDeepLink(params) {
+    const code = params.code.trim().toUpperCase().replace(/\s+/g, "");
+    const qs = new URLSearchParams({
+        quest: params.questId,
+        code,
+    });
+    const path = `${TICKET_DETAILS}/${params.bashEventId}?${qs.toString()}`;
+    const origin = (params.frontendOrigin ?? "").replace(/\/$/, "");
+    return origin ? `${origin}${path}` : path;
+}
+/** Legacy opaque payload (still accepted when pasted). */
+export function buildSideQuestLegacyPayload(bashEventId, questId, code) {
+    const normalized = code.trim().toUpperCase().replace(/\s+/g, "");
+    return `${LEGACY_PREFIX}${bashEventId}:${questId}:${normalized}`;
+}
+/**
+ * Parse a scanned/pasted value into quest id + code.
+ * Supports HTTPS ticket-details URLs and legacy `bash-side-quest:` payloads.
+ */
+export function parseSideQuestScanPayload(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    if (trimmed.startsWith(LEGACY_PREFIX)) {
+        const rest = trimmed.slice(LEGACY_PREFIX.length);
+        const parts = rest.split(":");
+        if (parts.length >= 3) {
+            const [bashEventId, questId, ...codeParts] = parts;
+            const code = codeParts.join(":").trim().toUpperCase();
+            if (code)
+                return { bashEventId, questId, code };
+        }
+        return null;
+    }
+    try {
+        const url = trimmed.includes("://")
+            ? new URL(trimmed)
+            : new URL(trimmed, "https://bash.community");
+        const questId = url.searchParams.get("quest") ?? undefined;
+        const codeParam = url.searchParams.get("code");
+        if (codeParam) {
+            return {
+                questId: questId || undefined,
+                code: codeParam.trim().toUpperCase().replace(/\s+/g, ""),
+                bashEventId: url.pathname.includes("/ticket-details/")
+                    ? url.pathname.split("/ticket-details/")[1]?.split(/[/?#]/)[0]
+                    : undefined,
+            };
+        }
+    }
+    catch {
+        // not a URL — treat as raw code
+    }
+    // Plain code (4–6 chars)
+    const plain = trimmed.toUpperCase().replace(/\s+/g, "");
+    if (/^[A-Z0-9]{4,8}$/.test(plain)) {
+        return { code: plain };
+    }
+    return null;
+}
+//# sourceMappingURL=sideQuestTypes.js.map

package/dist/sideQuestTypes.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bash-app/bash-common",
-  "version": "30.307.0",
+  "version": "30.309.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[]
@@ -6613,6 +6814,8 @@ enum NotificationType {
   FeaturedGuestInviteAccepted // Host: guest accepted featured guest invite
   FeaturedGuestInviteDeclined // Host: guest declined featured guest invite
   PartnerPromotionBlast // Attendee: partner on-site promo deal at an event
+  SideQuestRevealed // Attendee: host revealed a secret Side Quest
+  CommunityQuestUnlocked // Attendee: community quest goal unlocked
 }
 
 /// Opt-in reminder for a scheduled tier release (v1.5).
@@ -9050,6 +9253,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/__tests__/sideQuestTypes.test.ts

@@ -0,0 +1,44 @@
+import {
+  buildSideQuestDeepLink,
+  buildSideQuestLegacyPayload,
+  parseSideQuestScanPayload,
+} from "../sideQuestTypes.js";
+
+describe("sideQuestTypes deep links", () => {
+  it("builds HTTPS ticket-details URLs", () => {
+    expect(
+      buildSideQuestDeepLink({
+        bashEventId: "evt1",
+        questId: "q1",
+        code: "ab12",
+        frontendOrigin: "https://bash.community",
+      })
+    ).toBe("https://bash.community/ticket-details/evt1?quest=q1&code=AB12");
+  });
+
+  it("parses HTTPS deep links", () => {
+    expect(
+      parseSideQuestScanPayload(
+        "https://bash.community/ticket-details/evt1?quest=q1&code=XY99"
+      )
+    ).toEqual({
+      bashEventId: "evt1",
+      questId: "q1",
+      code: "XY99",
+    });
+  });
+
+  it("parses legacy bash-side-quest payloads", () => {
+    expect(
+      parseSideQuestScanPayload(buildSideQuestLegacyPayload("evt1", "q1", "ab12"))
+    ).toEqual({
+      bashEventId: "evt1",
+      questId: "q1",
+      code: "AB12",
+    });
+  });
+
+  it("parses plain codes", () => {
+    expect(parseSideQuestScanPayload("ab12")).toEqual({ code: "AB12" });
+  });
+});

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,12 @@ export * from "./venueLoyaltyRedemption.js";
 export * from "./stripeListingSubscriptionMessages.js";
 export * from "./extendedSchemas.js";
 export * from "./competitionIdeas.js";
+export * from "./sideQuestIdeas.js";
+export * from "./sideQuestTypes.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;