@bash-app/bash-common 30.320.0 → 30.322.0

package/prisma/schema.prisma

@@ -2043,7 +2043,7 @@ enum SideQuestCategory {
   GiveBack
 }
 
-/// How the guest proves completion. Phase 1: Qr + Code. Others reserved.
+/// How the guest proves completion. Phase 1+: Qr, Code, Vote, Circuit, Connect. Others reserved.
 enum SideQuestType {
   Qr
   Code
@@ -2055,6 +2055,10 @@ enum SideQuestType {
   Sponsor
   Social
   Trivia
+  /// Multi-stop booth tour — guest scans N checkpoint QRs
+  Circuit
+  /// Meet N people — scan their ticket QR after the icebreaker (requiredTicks)
+  Connect
 }
 
 enum EventBadgeAwardSource {
@@ -2089,6 +2093,12 @@ model SideQuest {
   sponsorServiceId         String?
   /// When questType is Vote: the competition casting a vote completes this quest
   competitionId            String?
+  /// Ticks needed for this guest to complete (1 = single-shot; Circuit/Connect use N)
+  requiredTicks            Int               @default(1)
+  /// Quest-local icebreaker when bash icebreaker is off (Connect quests)
+  icebreakerPrompt         String?
+  /// Set when timed-window-open push has been sent (cron)
+  windowOpenedNotifiedAt   DateTime?
   createdAt                DateTime          @default(now())
   updatedAt                DateTime          @updatedAt
 
@@ -2097,11 +2107,70 @@ model SideQuest {
   competition  Competition?          @relation(fields: [competitionId], references: [id], onDelete: SetNull)
   completions  SideQuestCompletion[]
   milestonesUnlocking SideQuestMilestone[] @relation("MilestoneUnlocksQuest")
+  checkpoints  SideQuestCheckpoint[]
+  progressHits SideQuestProgressHit[]
 
   @@index([bashEventId])
   @@index([bashEventId, sortOrder])
   @@index([eventBadgeId])
   @@index([competitionId])
+  @@index([startsAt, windowOpenedNotifiedAt])
+}
+
+model SideQuestCheckpoint {
+  id          String   @id @default(cuid())
+  sideQuestId String
+  label       String
+  sortOrder   Int      @default(0)
+  code        String
+  codeHash    String
+  /// Platform hire (Vendors / Exhibitors) — Pending, Approved, or Confirmed.
+  serviceBookingId          String?
+  serviceId                 String?
+  /// Partner request flows (vendor or exhibitor) before/at confirm.
+  vendorBookingRequestId    String?
+  exhibitorBookingRequestId String?
+  /// Off-platform vendor — QR emailed here; optional display name.
+  contactEmail              String?
+  contactName               String?
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  sideQuest               SideQuest                @relation(fields: [sideQuestId], references: [id], onDelete: Cascade)
+  hits                    SideQuestProgressHit[]
+  serviceBooking          ServiceBooking?          @relation(fields: [serviceBookingId], references: [id], onDelete: SetNull)
+  service                   Service?                 @relation(fields: [serviceId], references: [id], onDelete: SetNull)
+  vendorBookingRequest      VendorBookingRequest?    @relation(fields: [vendorBookingRequestId], references: [id], onDelete: SetNull)
+  exhibitorBookingRequest   ExhibitorBookingRequest? @relation(fields: [exhibitorBookingRequestId], references: [id], onDelete: SetNull)
+
+  @@index([sideQuestId, sortOrder])
+  @@index([sideQuestId, codeHash])
+  @@index([serviceBookingId])
+  @@index([vendorBookingRequestId])
+  @@index([exhibitorBookingRequestId])
+}
+
+/// Per-guest progress toward requiredTicks (checkpoint scan or Connect meet).
+model SideQuestProgressHit {
+  id              String   @id @default(cuid())
+  sideQuestId     String
+  userId          String
+  /// Stable key: "cp:{checkpointId}" | "user:{meetUserId}" | "name:{normalized}"
+  dedupeKey       String
+  checkpointId    String?
+  meetDisplayName String?
+  meetUserId      String?
+  createdAt       DateTime @default(now())
+
+  sideQuest  SideQuest            @relation(fields: [sideQuestId], references: [id], onDelete: Cascade)
+  user       User                 @relation("SideQuestProgressHits", fields: [userId], references: [id], onDelete: Cascade)
+  checkpoint SideQuestCheckpoint? @relation(fields: [checkpointId], references: [id], onDelete: Cascade)
+  meetUser   User?                @relation("SideQuestMeetTargets", fields: [meetUserId], references: [id], onDelete: SetNull)
+
+  @@unique([sideQuestId, userId, dedupeKey])
+  @@index([sideQuestId, userId])
+  @@index([userId])
+  @@index([checkpointId])
 }
 
 model SideQuestCompletion {
@@ -2217,6 +2286,8 @@ model CommunityQuestGoal {
   eventBadgeId       String?
   bashPointsReward   Int?
   unlockedAt         DateTime?
+  /// Set when ~80% near-goal push has been sent (once per event)
+  nearGoalNotifiedAt DateTime?
   createdAt          DateTime  @default(now())
   updatedAt          DateTime  @updatedAt
 
@@ -3815,6 +3886,8 @@ model User {
   eventBadgeAwards               EventBadgeAward[]            @relation("EventBadgeAwards")
   sideQuestMilestoneClaims       SideQuestMilestoneClaim[]    @relation("SideQuestMilestoneClaims")
   sideQuestPrizeEntries          SideQuestPrizeEntry[]        @relation("SideQuestPrizeEntries")
+  sideQuestProgressHits          SideQuestProgressHit[]       @relation("SideQuestProgressHits")
+  sideQuestMeetTargets           SideQuestProgressHit[]       @relation("SideQuestMeetTargets")
   contacts                       Contact[]
   contactLists                   ContactList[]                @relation("UserContactLists")
   contactlist                    ContactList[]
@@ -4638,6 +4711,7 @@ model Service {
   googleReviews                      GoogleReview[]
   serviceReviews                     ServiceReview[]
   providerHostReviews                ProviderHostReview[]
+  sideQuestCheckpoints               SideQuestCheckpoint[]
 
   @@index([serviceListingStripeSubscriptionId])
   @@index([paymentAccountId])
@@ -6383,6 +6457,7 @@ model ServiceBooking {
   representedByOrganization         Organization?                     @relation(fields: [representedByOrganizationId], references: [id], onDelete: SetNull)
   representation                    OrganizationArtistRepresentation? @relation("BookingRepresentation", fields: [representationId], references: [id], onDelete: SetNull)
   agencySettlement                  AgencyBookingSettlement?
+  sideQuestCheckpoints              SideQuestCheckpoint[]
 
   @@index([status])
   @@index([creatorId])
@@ -6452,6 +6527,7 @@ model VendorBookingRequest {
   vendorService          Service                 @relation("VendorBookingService", fields: [vendorServiceId], references: [id], onDelete: Cascade)
   offers                 ServiceBookingOffer[]
   categoryExclusivities  VendorCategoryExclusivity[]
+  sideQuestCheckpoints   SideQuestCheckpoint[]
 
   @@index([hostUserId])
   @@index([vendorServiceId])
@@ -6575,6 +6651,7 @@ model ExhibitorBookingRequest {
   exhibitorService       Service                 @relation("ExhibitorBookingService", fields: [exhibitorServiceId], references: [id], onDelete: Cascade)
   hostUser               User                    @relation("ExhibitorBookingHost", fields: [hostUserId], references: [id], onDelete: Cascade)
   serviceMessages        ServiceBookingMessage[] @relation("ExhibitorServiceMessages")
+  sideQuestCheckpoints   SideQuestCheckpoint[]
 
   @@index([hostUserId])
   @@index([exhibitorServiceId])
@@ -7080,6 +7157,8 @@ enum NotificationType {
   PartnerPromotionBlast // Attendee: partner on-site promo deal at an event
   SideQuestRevealed // Attendee: host revealed a secret Side Quest
   CommunityQuestUnlocked // Attendee: community quest goal unlocked
+  CommunityQuestNearGoal // Attendee: community goal ~80% of the way
+  SideQuestWindowOpened // Attendee: a timed Side Quest just went live
 }
 
 /// Opt-in reminder for a scheduled tier release (v1.5).

package/src/__tests__/bashEventCancellationPolicy.test.ts

@@ -0,0 +1,148 @@
+import {
+  resolveBashEventCancellationPresetId,
+  bashEventCancellationPresetDisplayText,
+  bashEventCancellationPolicyDetailLabel,
+  defaultBashEventCancellationPolicyDisplayText,
+  resolveBashEventGuestRefundEligibility,
+  BASH_EVENT_CANCELLATION_PRESETS,
+  DEFAULT_BASH_EVENT_CANCELLATION_PRESET_ID,
+} from "../bashEventCancellationPolicy";
+
+describe("bashEventCancellationPolicy", () => {
+  it("defaults to Standard — 7 days", () => {
+    expect(DEFAULT_BASH_EVENT_CANCELLATION_PRESET_ID).toBe("flexible_7_day");
+    expect(defaultBashEventCancellationPolicyDisplayText()).toBe(
+      bashEventCancellationPresetDisplayText("flexible_7_day")
+    );
+  });
+
+  it("lists Anytime first as the most guest-friendly preset", () => {
+    expect(BASH_EVENT_CANCELLATION_PRESETS[0].id).toBe("anytime_until_start");
+    expect(BASH_EVENT_CANCELLATION_PRESETS[0].name).toBe("Anytime");
+  });
+
+  it("maps stored policy text to a short detail-page label", () => {
+    expect(bashEventCancellationPolicyDetailLabel(null)).toBeNull();
+    expect(
+      bashEventCancellationPolicyDetailLabel(
+        bashEventCancellationPresetDisplayText("anytime_until_start")
+      )
+    ).toBe("Anytime");
+    expect(
+      bashEventCancellationPolicyDetailLabel(
+        bashEventCancellationPresetDisplayText("flexible_7_day")
+      )
+    ).toBe("Standard — 7 days");
+    expect(
+      bashEventCancellationPolicyDetailLabel("Call the host for a refund.")
+    ).toBe("Call the host for a refund.");
+  });
+
+  it("resolves empty to null", () => {
+    expect(resolveBashEventCancellationPresetId(null)).toBeNull();
+    expect(resolveBashEventCancellationPresetId("")).toBeNull();
+    expect(resolveBashEventCancellationPresetId("   ")).toBeNull();
+  });
+
+  it("resolves each preset displayText to its id", () => {
+    for (const preset of BASH_EVENT_CANCELLATION_PRESETS) {
+      expect(resolveBashEventCancellationPresetId(preset.displayText)).toBe(
+        preset.id
+      );
+      expect(bashEventCancellationPresetDisplayText(preset.id)).toBe(
+        preset.displayText
+      );
+    }
+  });
+
+  it("treats unknown free text as custom", () => {
+    expect(
+      resolveBashEventCancellationPresetId("Contact the host for refund.")
+    ).toBe("custom");
+  });
+
+  describe("resolveBashEventGuestRefundEligibility", () => {
+    const start = new Date("2026-08-01T20:00:00.000Z");
+
+    it("auto-refunds Standard 7-day when more than 7 days out", () => {
+      const now = new Date("2026-07-20T20:00:00.000Z"); // 12 days before
+      const result = resolveBashEventGuestRefundEligibility(
+        bashEventCancellationPresetDisplayText("flexible_7_day"),
+        { eventStart: start, now }
+      );
+      expect(result).toEqual({
+        mode: "auto",
+        eligibleNow: true,
+        presetId: "flexible_7_day",
+        fullRefundHoursBeforeStart: 168,
+      });
+    });
+
+    it("blocks Standard 7-day when inside the 7-day window", () => {
+      const now = new Date("2026-07-28T20:00:00.000Z"); // 4 days before
+      const result = resolveBashEventGuestRefundEligibility(
+        bashEventCancellationPresetDisplayText("flexible_7_day"),
+        { eventStart: start, now }
+      );
+      expect(result.mode).toBe("auto");
+      expect(result.eligibleNow).toBe(false);
+    });
+
+    it("allows Anytime until the event starts", () => {
+      const now = new Date("2026-08-01T19:00:00.000Z");
+      const result = resolveBashEventGuestRefundEligibility(
+        bashEventCancellationPresetDisplayText("anytime_until_start"),
+        { eventStart: start, now }
+      );
+      expect(result.mode).toBe("auto");
+      expect(result.eligibleNow).toBe(true);
+      expect(result.fullRefundHoursBeforeStart).toBe(0);
+    });
+
+    it("blocks Anytime after the event starts", () => {
+      const now = new Date("2026-08-01T21:00:00.000Z");
+      const result = resolveBashEventGuestRefundEligibility(
+        bashEventCancellationPresetDisplayText("anytime_until_start"),
+        { eventStart: start, now }
+      );
+      expect(result.eligibleNow).toBe(false);
+    });
+
+    it("returns none for no_refunds", () => {
+      const result = resolveBashEventGuestRefundEligibility(
+        bashEventCancellationPresetDisplayText("no_refunds"),
+        { eventStart: start, now: new Date("2026-06-01T00:00:00.000Z") }
+      );
+      expect(result).toEqual({
+        mode: "none",
+        eligibleNow: false,
+        presetId: "no_refunds",
+        fullRefundHoursBeforeStart: null,
+      });
+    });
+
+    it("returns host_review for custom free text", () => {
+      const result = resolveBashEventGuestRefundEligibility(
+        "Email the host for a partial refund.",
+        { eventStart: start, now: new Date("2026-06-01T00:00:00.000Z") }
+      );
+      expect(result).toEqual({
+        mode: "host_review",
+        eligibleNow: true,
+        presetId: "custom",
+        fullRefundHoursBeforeStart: null,
+      });
+    });
+
+    it("uses Standard 7-day when policy is empty", () => {
+      const now = new Date("2026-07-20T20:00:00.000Z");
+      const result = resolveBashEventGuestRefundEligibility(null, {
+        eventStart: start,
+        now,
+      });
+      expect(result.presetId).toBe("flexible_7_day");
+      expect(result.mode).toBe("auto");
+      expect(result.eligibleNow).toBe(true);
+    });
+  });
+});

package/src/__tests__/sideQuestIdeas.test.ts

@@ -19,8 +19,12 @@ describe("sideQuestIdeas", () => {
     expect(hits.every((h) => JSON.stringify(h).toLowerCase().includes("transit") || h.category === "Transit")).toBe(true);
   });
 
-  it("includes Vote in phase 1 types", () => {
+  it("includes Vote, Circuit, and Connect in phase 1 types", () => {
     expect(SIDE_QUEST_PHASE1_TYPES).toContain("Vote");
+    expect(SIDE_QUEST_PHASE1_TYPES).toContain("Circuit");
+    expect(SIDE_QUEST_PHASE1_TYPES).toContain("Connect");
     expect(SIDE_QUEST_TYPE_META.Vote.phase1).toBe(true);
+    expect(SIDE_QUEST_TYPE_META.Circuit.phase1).toBe(true);
+    expect(SIDE_QUEST_TYPE_META.Connect.phase1).toBe(true);
   });
 });

package/src/__tests__/sideQuestTypes.test.ts

@@ -2,6 +2,7 @@ import {
   buildSideQuestDeepLink,
   buildSideQuestLegacyPayload,
   parseSideQuestScanPayload,
+  parseTicketDoorQrPayload,
 } from "../sideQuestTypes.js";
 
 describe("sideQuestTypes deep links", () => {
@@ -38,7 +39,47 @@ describe("sideQuestTypes deep links", () => {
     });
   });
 
+  it("builds and parses checkpoint deep links", () => {
+    const url = buildSideQuestDeepLink({
+      bashEventId: "evt1",
+      questId: "q1",
+      code: "ab12",
+      checkpointId: "cp9",
+      frontendOrigin: "https://bash.community",
+    });
+    expect(url).toContain("checkpoint=cp9");
+    expect(parseSideQuestScanPayload(url)).toEqual({
+      bashEventId: "evt1",
+      questId: "q1",
+      checkpointId: "cp9",
+      code: "AB12",
+    });
+  });
+
   it("parses plain codes", () => {
     expect(parseSideQuestScanPayload("ab12")).toEqual({ code: "AB12" });
   });
+
+  it("parses ticket door QR JSON for Connect meets", () => {
+    expect(
+      parseTicketDoorQrPayload(
+        JSON.stringify({
+          eventId: "evt-1",
+          userId: "user-2",
+          ticketId: "tix-9",
+          qrToken: "tok",
+          timestamp: "2026-01-01T00:00:00.000Z",
+        })
+      )
+    ).toEqual({
+      eventId: "evt-1",
+      userId: "user-2",
+      ticketId: "tix-9",
+      qrToken: "tok",
+    });
+    expect(parseTicketDoorQrPayload("not-json")).toBeNull();
+    expect(
+      parseTicketDoorQrPayload(JSON.stringify({ eventId: "e", userId: "u" }))
+    ).toBeNull();
+  });
 });

package/src/bashEventCancellationPolicy.ts

@@ -0,0 +1,231 @@
+/**
+ * Guest-facing cancellation policy presets for ticketed bash events
+ * (Eventbrite-style windows). Stored as the human-readable `displayText` in
+ * BashEvent.cancellationPolicy; refund eligibility is resolved from the matching
+ * named preset (or host-review for custom free text).
+ */
+
+import { hoursUntilEventStart } from "./utils/service/cancellationPolicyRefundResolver.js";
+
+export const BASH_EVENT_CANCELLATION_PRESET_IDS = [
+  "anytime_until_start",
+  "flexible_1_day",
+  "flexible_7_day",
+  "flexible_30_day",
+  "no_refunds",
+  "custom",
+] as const;
+
+export type BashEventCancellationPresetId =
+  (typeof BASH_EVENT_CANCELLATION_PRESET_IDS)[number];
+
+export type BashEventCancellationNamedPresetId = Exclude<
+  BashEventCancellationPresetId,
+  "custom"
+>;
+
+/** Default for new bashes and empty policy fields. */
+export const DEFAULT_BASH_EVENT_CANCELLATION_PRESET_ID: BashEventCancellationNamedPresetId =
+  "flexible_7_day";
+
+export type BashEventCancellationPreset = {
+  id: BashEventCancellationNamedPresetId;
+  name: string;
+  /** Short line under the name in the host picker. */
+  summary: string;
+  /** Exact string persisted to BashEvent.cancellationPolicy and shown to guests. */
+  displayText: string;
+  /**
+   * Hours before start required for a full auto guest refund.
+   * - `0` = anytime until the event starts (`hoursUntil > 0`)
+   * - `null` = no guest auto-refunds (`no_refunds`)
+   */
+  fullRefundHoursBeforeStart: number | null;
+};
+
+/** Ordered most guest-friendly → strictest (default is still Standard). */
+export const BASH_EVENT_CANCELLATION_PRESETS: readonly BashEventCancellationPreset[] =
+  [
+    {
+      id: "anytime_until_start",
+      name: "Anytime",
+      summary: "Full refund until the event starts.",
+      displayText:
+        "Full refund if you cancel anytime before the event starts. No refunds after it begins.",
+      fullRefundHoursBeforeStart: 0,
+    },
+    {
+      id: "flexible_1_day",
+      name: "Flexible — 24 hours",
+      summary: "Full refund until 24 hours before start.",
+      displayText:
+        "Full refund if you cancel at least 24 hours before the event starts. No refunds after that.",
+      fullRefundHoursBeforeStart: 24,
+    },
+    {
+      id: "flexible_7_day",
+      name: "Standard — 7 days",
+      summary: "Full refund until 7 days before start.",
+      displayText:
+        "Full refund if you cancel at least 7 days before the event starts. No refunds after that.",
+      fullRefundHoursBeforeStart: 168,
+    },
+    {
+      id: "flexible_30_day",
+      name: "Strict — 30 days",
+      summary: "Full refund until 30 days before start.",
+      displayText:
+        "Full refund if you cancel at least 30 days before the event starts. No refunds after that.",
+      fullRefundHoursBeforeStart: 720,
+    },
+    {
+      id: "no_refunds",
+      name: "No guest refunds",
+      summary: "Tickets are final sale for guest cancellations.",
+      displayText:
+        "No refunds for guest cancellations. If the host cancels the event, refunds follow the host’s guarantee settings.",
+      fullRefundHoursBeforeStart: null,
+    },
+  ] as const;
+
+const PRESET_BY_DISPLAY = new Map(
+  BASH_EVENT_CANCELLATION_PRESETS.map((p) => [p.displayText, p.id] as const)
+);
+
+const PRESET_BY_ID = new Map(
+  BASH_EVENT_CANCELLATION_PRESETS.map((p) => [p.id, p] as const)
+);
+
+/** Map a stored policy string to a preset id (or custom / null if empty). */
+export function resolveBashEventCancellationPresetId(
+  policy: string | null | undefined
+): BashEventCancellationPresetId | null {
+  const trimmed = policy?.trim() ?? "";
+  if (!trimmed) return null;
+  return PRESET_BY_DISPLAY.get(trimmed) ?? "custom";
+}
+
+export function getBashEventCancellationPreset(
+  id: BashEventCancellationNamedPresetId
+): BashEventCancellationPreset {
+  const preset = PRESET_BY_ID.get(id);
+  if (!preset) {
+    throw new Error(`Unknown bash cancellation preset: ${id}`);
+  }
+  return preset;
+}
+
+export function bashEventCancellationPresetDisplayText(
+  id: BashEventCancellationNamedPresetId
+): string {
+  return getBashEventCancellationPreset(id).displayText;
+}
+
+export function defaultBashEventCancellationPolicyDisplayText(): string {
+  return bashEventCancellationPresetDisplayText(
+    DEFAULT_BASH_EVENT_CANCELLATION_PRESET_ID
+  );
+}
+
+/**
+ * Short label for bash detail / meta UI. Named presets use the host-picker name
+ * (e.g. "Anytime"); custom/legacy free text returns the stored string.
+ */
+export function bashEventCancellationPolicyDetailLabel(
+  policy: string | null | undefined
+): string | null {
+  const trimmed = policy?.trim() ?? "";
+  if (!trimmed) return null;
+  const id = resolveBashEventCancellationPresetId(trimmed);
+  if (id && id !== "custom") {
+    return getBashEventCancellationPreset(id).name;
+  }
+  return trimmed;
+}
+
+export type BashEventGuestRefundMode = "auto" | "host_review" | "none";
+
+export type BashEventGuestRefundEligibility = {
+  mode: BashEventGuestRefundMode;
+  /** True when the guest may take the mode's money path right now. */
+  eligibleNow: boolean;
+  presetId: BashEventCancellationPresetId | null;
+  fullRefundHoursBeforeStart: number | null;
+};
+
+export type ResolveBashEventGuestRefundOptions = {
+  eventStart: Date | string | null | undefined;
+  now?: Date;
+};
+
+function parseEventStart(
+  eventStart: Date | string | null | undefined
+): Date | null {
+  if (eventStart == null) return null;
+  const d = eventStart instanceof Date ? eventStart : new Date(eventStart);
+  if (Number.isNaN(d.getTime())) return null;
+  return d;
+}
+
+/**
+ * Resolves guest self-serve refund path from stored cancellation policy text.
+ * - Named presets (except no_refunds): `auto` when still inside the window
+ * - `no_refunds`: `none`
+ * - Custom / unknown free text: `host_review` (host must approve)
+ * - Empty / missing policy: treated as default Standard 7-day preset
+ */
+export function resolveBashEventGuestRefundEligibility(
+  policy: string | null | undefined,
+  options: ResolveBashEventGuestRefundOptions
+): BashEventGuestRefundEligibility {
+  const now = options.now ?? new Date();
+  const eventStart = parseEventStart(options.eventStart);
+  const hoursUntil =
+    eventStart != null ? hoursUntilEventStart(eventStart, now) : 0;
+
+  const trimmed = policy?.trim() ?? "";
+  const resolvedId = trimmed
+    ? resolveBashEventCancellationPresetId(trimmed)
+    : DEFAULT_BASH_EVENT_CANCELLATION_PRESET_ID;
+
+  if (resolvedId === "custom") {
+    return {
+      mode: "host_review",
+      eligibleNow: true,
+      presetId: "custom",
+      fullRefundHoursBeforeStart: null,
+    };
+  }
+
+  if (resolvedId == null) {
+    return {
+      mode: "none",
+      eligibleNow: false,
+      presetId: null,
+      fullRefundHoursBeforeStart: null,
+    };
+  }
+
+  const preset = getBashEventCancellationPreset(resolvedId);
+  const threshold = preset.fullRefundHoursBeforeStart;
+
+  if (threshold == null) {
+    return {
+      mode: "none",
+      eligibleNow: false,
+      presetId: resolvedId,
+      fullRefundHoursBeforeStart: null,
+    };
+  }
+
+  // threshold 0 = anytime until start; otherwise need hoursUntil >= threshold
+  const eligibleNow =
+    hoursUntil > 0 && (threshold === 0 || hoursUntil >= threshold);
+
+  return {
+    mode: "auto",
+    eligibleNow,
+    presetId: resolvedId,
+    fullRefundHoursBeforeStart: threshold,
+  };
+}

package/src/definitions.ts

@@ -836,6 +836,11 @@ export interface ResetPassword {
 
 export interface ApiResult<T, P extends ErrorDataType = ErrorDataType> {
   data?: T;
+  /**
+   * Endpoint-specific extras that are not the primary `data` payload
+   * (e.g. guest roster `depth`, ticket `refundMode`).
+   */
+  meta?: Record<string, unknown>;
   /** PATCH group member / some RSVP endpoints — true when BashPoints RSVP bonus was newly awarded */
   rsvpBonusAwarded?: boolean;
   /** POST event task assign — true when volunteer guestlist invite was created */

package/src/index.ts

@@ -35,6 +35,7 @@ export * from "./hostCrmInsights.js";
 export * from "./hostCrmAutomation.js";
 export * from "./relationshipHealth.js";
 export * from "./hostCrmConstants.js";
+export * from "./bashEventCancellationPolicy.js";
 export * from "./userReportTypes.js";
 export * from "./mirroredPrismaEnums.js";
 export * from "./utils/featuredDiscoveryGeo.js";

package/src/sideQuestIdeas.ts

@@ -23,7 +23,9 @@ export type SideQuestTypeId =
   | "Vote"
   | "Sponsor"
   | "Social"
-  | "Trivia";
+  | "Trivia"
+  | "Circuit"
+  | "Connect";
 
 export const SIDE_QUEST_CATEGORY_META: Record<
   SideQuestCategoryId,
@@ -39,8 +41,14 @@ export const SIDE_QUEST_CATEGORY_META: Record<
   GiveBack: { label: "Give Back", emoji: "❤️" },
 };
 
-/** Phase 1 host-selectable quest types */
-export const SIDE_QUEST_PHASE1_TYPES: SideQuestTypeId[] = ["Qr", "Code", "Vote"];
+/** Host-selectable quest types (single-shot + Circuit/Connect) */
+export const SIDE_QUEST_PHASE1_TYPES: SideQuestTypeId[] = [
+  "Qr",
+  "Code",
+  "Vote",
+  "Circuit",
+  "Connect",
+];
 
 export const SIDE_QUEST_TYPE_META: Record<
   SideQuestTypeId,
@@ -96,6 +104,17 @@ export const SIDE_QUEST_TYPE_META: Record<
     description: "Answer a question correctly.",
     phase1: false,
   },
+  Circuit: {
+    label: "Vendor circuit",
+    description: "Guest scans QRs at N booths — progress ticks toward done.",
+    phase1: true,
+  },
+  Connect: {
+    label: "Icebreaker Connect",
+    description:
+      "Meet N people by scanning their ticket QR after the icebreaker.",
+    phase1: true,
+  },
 };
 
 export interface SideQuestIdea {