@bash-app/bash-common 30.308.0 → 30.310.0

package/src/sideQuestIdeas.ts

@@ -40,7 +40,7 @@ export const SIDE_QUEST_CATEGORY_META: Record<
 };
 
 /** Phase 1 host-selectable quest types */
-export const SIDE_QUEST_PHASE1_TYPES: SideQuestTypeId[] = ["Qr", "Code"];
+export const SIDE_QUEST_PHASE1_TYPES: SideQuestTypeId[] = ["Qr", "Code", "Vote"];
 
 export const SIDE_QUEST_TYPE_META: Record<
   SideQuestTypeId,
@@ -79,7 +79,7 @@ export const SIDE_QUEST_TYPE_META: Record<
   Vote: {
     label: "Vote Quest",
     description: "Completes after voting in a competition.",
-    phase1: false,
+    phase1: true,
   },
   Sponsor: {
     label: "Sponsor Quest",

package/src/sideQuestTypes.ts

@@ -0,0 +1,190 @@
+/**
+ * Shared Side Quest / Adventures API shapes and QR deep-link helpers.
+ */
+
+import { TICKET_DETAILS } from "./definitions.js";
+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;
+  competitionId?: string | 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;
+  }>;
+}
+
+const LEGACY_PREFIX = "bash-side-quest:";
+
+/** Absolute or path-only HTTPS deep link for booth QR codes. */
+export function buildSideQuestDeepLink(params: {
+  bashEventId: string;
+  questId: string;
+  code: string;
+  /** Origin without trailing slash, e.g. https://bash.community */
+  frontendOrigin?: string;
+  slug?: string | null;
+}): string {
+  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: string,
+  questId: string,
+  code: string
+): string {
+  const normalized = code.trim().toUpperCase().replace(/\s+/g, "");
+  return `${LEGACY_PREFIX}${bashEventId}:${questId}:${normalized}`;
+}
+
+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 function parseSideQuestScanPayload(raw: string): ParsedSideQuestScan | null {
+  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;
+}