@bash-app/bash-common 30.320.0 → 30.322.0

package/src/sideQuestTypes.ts

@@ -14,6 +14,37 @@ export interface EventBadgeExt {
   createdByUserId?: string;
 }
 
+export interface SideQuestCheckpointExt {
+  id: string;
+  label: string;
+  sortOrder: number;
+  code?: string;
+  /** Guest: whether this checkpoint was already hit */
+  hit?: boolean;
+  serviceBookingId?: string | null;
+  serviceId?: string | null;
+  vendorBookingRequestId?: string | null;
+  exhibitorBookingRequestId?: string | null;
+  contactEmail?: string | null;
+  contactName?: string | null;
+  /** Host: resolved assignee label for booth list */
+  assigneeLabel?: string | null;
+  /** Host: email we can send the booth QR to */
+  assigneeEmail?: string | null;
+}
+
+/** Assignable vendor/exhibitor for circuit booth picker (host). */
+export interface CircuitVendorOptionExt {
+  sourceType: "serviceBooking" | "vendorRequest" | "exhibitorRequest";
+  id: string;
+  serviceId: string;
+  displayName: string;
+  status: string;
+  contactEmail: string | null;
+  contactName: string | null;
+  kindLabel: "Vendor" | "Exhibitor";
+}
+
 export interface SideQuestExt {
   id: string;
   title: string;
@@ -39,6 +70,18 @@ export interface SideQuestExt {
   completed?: boolean;
   code?: string;
   completionCount?: number;
+  requiredTicks?: number;
+  icebreakerPrompt?: string | null;
+  /** Resolved prompt for Connect (bash icebreaker preferred) */
+  resolvedIcebreakerPrompt?: string | null;
+  progressCurrent?: number;
+  progressTarget?: number;
+  checkpoints?: SideQuestCheckpointExt[];
+  /** Guest Connect: names / users already logged */
+  meetHits?: Array<{
+    meetDisplayName: string | null;
+    meetUserId: string | null;
+  }>;
 }
 
 export interface SideQuestMilestoneExt {
@@ -71,6 +114,14 @@ export interface SideQuestLogExt {
   raffleEntries: number;
   pointsFromQuests: number;
   community: CommunityQuestGoalExt | null;
+  /** Aggregate Side Quest completions tonight (all guests) */
+  tonightCompletions?: number;
+  /** Next personal milestone distance (without leaking secret rewards) */
+  nextMilestone?: {
+    requiredCompletions: number;
+    remaining: number;
+    unlocksSecret: boolean;
+  } | null;
 }
 
 export interface SideQuestHostBundleExt {
@@ -105,6 +156,18 @@ export interface SideQuestAnalyticsExt {
   }>;
 }
 
+/** Lifetime Progress page summary */
+export interface SideQuestLifetimeSummaryExt {
+  totalCompletions: number;
+  eventsWithCompletions: number;
+  recent: Array<{
+    bashEventId: string;
+    bashTitle: string;
+    completionCount: number;
+    lastCompletedAt: string | Date;
+  }>;
+}
+
 const LEGACY_PREFIX = "bash-side-quest:";
 
 /** Absolute or path-only HTTPS deep link for booth QR codes. */
@@ -112,6 +175,7 @@ export function buildSideQuestDeepLink(params: {
   bashEventId: string;
   questId: string;
   code: string;
+  checkpointId?: string;
   /** Origin without trailing slash, e.g. https://bash.community */
   frontendOrigin?: string;
   slug?: string | null;
@@ -121,6 +185,9 @@ export function buildSideQuestDeepLink(params: {
     quest: params.questId,
     code,
   });
+  if (params.checkpointId) {
+    qs.set("checkpoint", params.checkpointId);
+  }
   const path = `${TICKET_DETAILS}/${params.bashEventId}?${qs.toString()}`;
   const origin = (params.frontendOrigin ?? "").replace(/\/$/, "");
   return origin ? `${origin}${path}` : path;
@@ -139,6 +206,7 @@ export function buildSideQuestLegacyPayload(
 export type ParsedSideQuestScan = {
   bashEventId?: string;
   questId?: string;
+  checkpointId?: string;
   code: string;
 };
 
@@ -166,10 +234,12 @@ export function parseSideQuestScanPayload(raw: string): ParsedSideQuestScan | nu
       ? new URL(trimmed)
       : new URL(trimmed, "https://bash.community");
     const questId = url.searchParams.get("quest") ?? undefined;
+    const checkpointId = url.searchParams.get("checkpoint") ?? undefined;
     const codeParam = url.searchParams.get("code");
     if (codeParam) {
       return {
         questId: questId || undefined,
+        checkpointId: checkpointId || undefined,
         code: codeParam.trim().toUpperCase().replace(/\s+/g, ""),
         bashEventId: url.pathname.includes("/ticket-details/")
           ? url.pathname.split("/ticket-details/")[1]?.split(/[/?#]/)[0]
@@ -188,3 +258,44 @@ export function parseSideQuestScanPayload(raw: string): ParsedSideQuestScan | nu
 
   return null;
 }
+
+/** Normalize a Connect meet display name for soft dedupe (legacy name hits). */
+export function normalizeMeetNameKey(name: string): string {
+  return name.trim().toLowerCase().replace(/\s+/g, " ");
+}
+
+/** Ticket door-scan QR payload (JSON string on guest ticket QR). */
+export type ParsedTicketDoorQr = {
+  eventId: string;
+  userId: string;
+  ticketId: string;
+  qrToken?: string;
+};
+
+/**
+ * Parse a ticket check-in / door QR JSON payload.
+ * Used by Connect Side Quests: scan their ticket → log the meet.
+ */
+export function parseTicketDoorQrPayload(
+  raw: string
+): ParsedTicketDoorQr | null {
+  const trimmed = raw.trim();
+  if (!trimmed.startsWith("{")) return null;
+  try {
+    const data = JSON.parse(trimmed) as Record<string, unknown>;
+    const eventId = typeof data.eventId === "string" ? data.eventId.trim() : "";
+    const userId = typeof data.userId === "string" ? data.userId.trim() : "";
+    const ticketId =
+      typeof data.ticketId === "string" ? data.ticketId.trim() : "";
+    if (!eventId || !userId || !ticketId) return null;
+    const qrToken =
+      typeof data.qrToken === "string" && data.qrToken.trim()
+        ? data.qrToken.trim()
+        : undefined;
+    return qrToken
+      ? { eventId, userId, ticketId, qrToken }
+      : { eventId, userId, ticketId };
+  } catch {
+    return null;
+  }
+}