@bash-app/bash-common 30.333.0 → 30.335.0

package/src/__tests__/hostCrmGrowthPack.test.ts

@@ -1,16 +1,19 @@
 import {
   hostCrmGrowthPackIsComplete,
+  hostCrmHasLateBuyerPackAutomation,
   hostCrmHasPostEventPackAutomation,
   hostCrmHasWinBackPackAutomation,
+  HOST_CRM_GROWTH_PACK_LATE_BUYER_PRESET_ID,
   HOST_CRM_GROWTH_PACK_WINBACK_PRESET_ID,
 } from "../hostCrmAutomation.js";
 
 describe("host CRM growth pack detection", () => {
-  it("detects win-back and post-event pack rows", () => {
+  it("detects win-back, post-event, and late-buyer pack rows", () => {
     const empty: Array<{ trigger: string; channel: string; audiencePresetId?: string | null }> =
       [];
     expect(hostCrmHasWinBackPackAutomation(empty)).toBe(false);
     expect(hostCrmHasPostEventPackAutomation(empty)).toBe(false);
+    expect(hostCrmHasLateBuyerPackAutomation(empty)).toBe(false);
     expect(hostCrmGrowthPackIsComplete(empty)).toBe(false);
 
     const winBack = [
@@ -29,5 +32,15 @@ describe("host CRM growth pack detection", () => {
     ];
     expect(hostCrmHasPostEventPackAutomation(both)).toBe(true);
     expect(hostCrmGrowthPackIsComplete(both)).toBe(true);
+
+    const withLateBuyer = [
+      ...both,
+      {
+        trigger: "Recurring",
+        channel: "Email",
+        audiencePresetId: HOST_CRM_GROWTH_PACK_LATE_BUYER_PRESET_ID,
+      },
+    ];
+    expect(hostCrmHasLateBuyerPackAutomation(withLateBuyer)).toBe(true);
   });
 });

package/src/bashFeedTypes.ts

@@ -36,6 +36,8 @@ export interface BashFeedPostBashSummary {
     rsvpGoing?: number;
     /** `PublicBashRsvp` rows with status Maybe. */
     rsvpMaybe?: number;
+    /** Classic `Review` rows for the event (feed ratings modal / event reviews). */
+    reviews?: number;
   };
   activeOffers?: Array<{
     id: string;
@@ -158,6 +160,8 @@ export interface BashFeedPostBashSummaryWire {
     checkedIn?: number;
     rsvpGoing?: number;
     rsvpMaybe?: number;
+    /** Classic `Review` rows for the event (feed ratings modal / event reviews). */
+    reviews?: number;
   };
 }
 

package/src/causeTags.ts

@@ -0,0 +1,243 @@
+/**
+ * Curated cause / community tags for bash + service Why flows.
+ * Stored as stable string IDs on `causeTags` (Service / BashEvent) so search
+ * can filter later without parsing free text.
+ */
+export type CauseTagId =
+  | "neighborhood"
+  | "mutual_aid"
+  | "arts_culture"
+  | "music_scene"
+  | "youth"
+  | "lgbtq"
+  | "environment"
+  | "mental_health"
+  | "education"
+  | "food_security"
+  | "animal_welfare"
+  | "sports_rec"
+  | "faith_spiritual"
+  | "civic"
+  | "fundraiser"
+  | "small_business";
+
+export type CauseTag = {
+  id: CauseTagId;
+  label: string;
+  /** Short seed line for bash descriptions when a chip is selected. */
+  bashSeed: string;
+};
+
+export const CAUSE_TAGS: readonly CauseTag[] = [
+  {
+    id: "neighborhood",
+    label: "Neighborhood / block",
+    bashSeed: "This bash is for the neighbors — building our block crew.",
+  },
+  {
+    id: "mutual_aid",
+    label: "Mutual aid",
+    bashSeed: "We're gathering to support mutual aid in our community.",
+  },
+  {
+    id: "arts_culture",
+    label: "Arts & culture",
+    bashSeed: "This night celebrates local arts and culture.",
+  },
+  {
+    id: "music_scene",
+    label: "Music scene",
+    bashSeed: "Built for the local music scene — come through for the sound.",
+  },
+  {
+    id: "youth",
+    label: "Youth & kids",
+    bashSeed: "This bash supports youth and families in our area.",
+  },
+  {
+    id: "lgbtq",
+    label: "LGBTQ+",
+    bashSeed: "A queer-friendly bash — everyone who shows respect is welcome.",
+  },
+  {
+    id: "environment",
+    label: "Environment",
+    bashSeed: "We're tying this night to environmental care and climate action.",
+  },
+  {
+    id: "mental_health",
+    label: "Mental health",
+    bashSeed: "This gathering centers mental health, rest, and real connection.",
+  },
+  {
+    id: "education",
+    label: "Education",
+    bashSeed: "We're here for learning, mentoring, and education in our community.",
+  },
+  {
+    id: "food_security",
+    label: "Food security",
+    bashSeed: "Part of this night supports food access for people nearby.",
+  },
+  {
+    id: "animal_welfare",
+    label: "Animal welfare",
+    bashSeed: "We're throwing this with animal welfare in mind.",
+  },
+  {
+    id: "sports_rec",
+    label: "Sports & recreation",
+    bashSeed: "Come move, play, and build the local sports / rec crew.",
+  },
+  {
+    id: "faith_spiritual",
+    label: "Faith / spiritual",
+    bashSeed: "This bash brings our faith / spiritual community together.",
+  },
+  {
+    id: "civic",
+    label: "Civic / local politics",
+    bashSeed: "A civic hang — talk, organize, and show up for our city.",
+  },
+  {
+    id: "fundraiser",
+    label: "Fundraiser",
+    bashSeed: "This bash raises support for a cause we care about.",
+  },
+  {
+    id: "small_business",
+    label: "Small business / makers",
+    bashSeed: "Celebrating local small businesses and makers.",
+  },
+] as const;
+
+export const CAUSE_TAG_BY_ID: Readonly<Record<CauseTagId, CauseTag>> =
+  CAUSE_TAGS.reduce(
+    (acc, tag) => {
+      acc[tag.id] = tag;
+      return acc;
+    },
+    {} as Record<CauseTagId, CauseTag>
+  );
+
+export function isCauseTagId(value: string): value is CauseTagId {
+  return Object.prototype.hasOwnProperty.call(CAUSE_TAG_BY_ID, value);
+}
+
+export function normalizeCauseTags(ids: string[] | null | undefined): CauseTagId[] {
+  if (!ids?.length) return [];
+  const seen = new Set<CauseTagId>();
+  for (const id of ids) {
+    if (isCauseTagId(id)) seen.add(id);
+  }
+  return [...seen];
+}
+
+export function causeTagLabels(ids: string[] | null | undefined): string[] {
+  return normalizeCauseTags(ids).map((id) => CAUSE_TAG_BY_ID[id].label);
+}
+
+/**
+ * Cause tag IDs whose label or id matches a free-text search query.
+ * Used by keyword search (Prisma `hasSome`) and client-side filters.
+ */
+export function causeTagIdsMatchingSearch(query: string): CauseTagId[] {
+  const term = query.trim().toLowerCase();
+  if (!term) return [];
+
+  const termAsId = term.replace(/\s+/g, "_");
+  return CAUSE_TAGS.filter((tag) => {
+    const idSpaced = tag.id.replace(/_/g, " ");
+    return (
+      tag.label.toLowerCase().includes(term) ||
+      tag.id.includes(termAsId) ||
+      idSpaced.includes(term)
+    );
+  }).map((tag) => tag.id);
+}
+
+/** True when any of the entity's cause tags match the search query. */
+export function causeTagsMatchSearch(
+  causeTags: string[] | null | undefined,
+  query: string
+): boolean {
+  const matching = causeTagIdsMatchingSearch(query);
+  if (matching.length === 0) return false;
+  const selected = new Set(normalizeCauseTags(causeTags));
+  return matching.some((id) => selected.has(id));
+}
+
+export type BashDonationCauseFields = {
+  donationGoalCents?: number | null;
+  donationCausePercent?: number | null;
+  donationCauseTagId?: string | null;
+  donationCauseLabel?: string | null;
+};
+
+/**
+ * Resolve the public cause label for host-declared donation split.
+ * Prefers curated tag label over free-text.
+ */
+export function resolveDonationCauseLabel(
+  fields: Pick<
+    BashDonationCauseFields,
+    "donationCauseTagId" | "donationCauseLabel"
+  >
+): string | null {
+  const tagId = fields.donationCauseTagId?.trim();
+  if (tagId && isCauseTagId(tagId)) {
+    return CAUSE_TAG_BY_ID[tagId].label;
+  }
+  const label = fields.donationCauseLabel?.trim();
+  return label ? label : null;
+}
+
+export type DonationCauseValidationError =
+  | "invalid_goal"
+  | "invalid_percent"
+  | "percent_requires_cause"
+  | "invalid_cause_tag";
+
+/**
+ * Validate bash donation goal / cause-split fields before persist.
+ * Returns null when valid.
+ */
+export function validateBashDonationCauseFields(
+  fields: BashDonationCauseFields
+): DonationCauseValidationError | null {
+  const goal = fields.donationGoalCents;
+  if (
+    goal != null &&
+    (typeof goal !== "number" ||
+      !Number.isFinite(goal) ||
+      goal <= 0 ||
+      !Number.isInteger(goal))
+  ) {
+    return "invalid_goal";
+  }
+
+  const rawTag = fields.donationCauseTagId?.trim() || null;
+  if (rawTag && !isCauseTagId(rawTag)) {
+    return "invalid_cause_tag";
+  }
+
+  const percent = fields.donationCausePercent;
+  if (percent != null) {
+    if (
+      typeof percent !== "number" ||
+      !Number.isFinite(percent) ||
+      !Number.isInteger(percent) ||
+      percent < 0 ||
+      percent > 100
+    ) {
+      return "invalid_percent";
+    }
+    const hasTag = !!rawTag && isCauseTagId(rawTag);
+    const hasLabel = !!fields.donationCauseLabel?.trim();
+    if (!hasTag && !hasLabel) {
+      return "percent_requires_cause";
+    }
+  }
+
+  return null;
+}

package/src/definitions.ts

@@ -229,6 +229,45 @@ export const CHECKOUT_PURPOSE_DOOR_SQUARE_SALE = "door_square_sale" as const;
 /** Walk-up / PAD door sale via Square Terminal (card present). */
 export const CHECKOUT_PURPOSE_DOOR_SQUARE_TERMINAL_SALE =
   "door_square_terminal_sale" as const;
+/** Online ticket checkout line: coat/bag check add-on. */
+export const CHECKOUT_PURPOSE_COAT_CHECK_ONLINE = "coat_check_online" as const;
+/** Walk-up coat/bag check via Stripe Checkout (guest pays on phone). */
+export const CHECKOUT_PURPOSE_COAT_CHECK_DOOR_SALE = "coat_check_door_sale" as const;
+/** Coat/bag check via Stripe Terminal (card present). */
+export const CHECKOUT_PURPOSE_COAT_CHECK_DOOR_TERMINAL_SALE =
+  "coat_check_door_terminal_sale" as const;
+/** Walk-up coat/bag check via Square Payment Link. */
+export const CHECKOUT_PURPOSE_COAT_CHECK_DOOR_SQUARE_SALE =
+  "coat_check_door_square_sale" as const;
+/** Coat/bag check via Square Terminal. */
+export const CHECKOUT_PURPOSE_COAT_CHECK_DOOR_SQUARE_TERMINAL_SALE =
+  "coat_check_door_square_terminal_sale" as const;
+
+export const COAT_CHECK_ENTITLEMENT_STATUSES = [
+  "Paid",
+  "CheckedIn",
+  "Claimed",
+  "Refunded",
+  "Cancelled",
+] as const;
+export type CoatCheckEntitlementStatusName =
+  (typeof COAT_CHECK_ENTITLEMENT_STATUSES)[number];
+
+export const COAT_CHECK_QR_TYPE = "coat_check" as const;
+
+export const COAT_CHECK_SCAN_OUTCOMES = [
+  "ready_for_dropoff",
+  "ready_for_claim",
+  "already_claimed",
+  "invalid_or_expired",
+  "wrong_event",
+  "cancelled_or_refunded",
+] as const;
+export type CoatCheckScanOutcome = (typeof COAT_CHECK_SCAN_OUTCOMES)[number];
+
+/** Statuses that occupy a coat-check slot. */
+export const COAT_CHECK_SLOT_OCCUPYING_STATUSES: CoatCheckEntitlementStatusName[] =
+  ["Paid", "CheckedIn"];
 
 /** Which processor the door app uses for card capture (host preferred + ready). */
 export type DoorPaymentRail = "STRIPE" | "SQUARE";
@@ -1038,6 +1077,13 @@ export interface StripeCreateBashEventTicketsCheckoutSessionArgs extends UtmFiel
 
   /** EventGroup id when purchasing a group package for the crew */
   groupId?: string;
+
+  /** Optional coat/bag check units to buy with this ticket checkout (0 = none). */
+  coatCheckQuantity?: number;
+  /** When true, add oversized surcharge per coat unit (if host configured). */
+  coatCheckOversized?: boolean;
+  /** Optional tip cents for coat check (when host enables tips). */
+  coatCheckTipCents?: number;
 }
 
 export interface StripeCreateBashEventDonationCheckoutSessionArgs extends UtmFields {

package/src/hostCrmAutomation.ts

@@ -93,11 +93,22 @@ export const HOST_CRM_WINBACK_DEFAULT_SUBJECT =
 export const HOST_CRM_WINBACK_DEFAULT_BODY =
   "It's been a while since your last bash with us. We'd love to see you again.";
 
-/** Post-event cron substitutes {{eventTitle}}, {{firstName}}, {{bashFeedUrl}}. */
+/**
+ * Post-event cron substitutes {{eventTitle}}, {{firstName}}, {{bashFeedUrl}},
+ * {{memoriesUrl}}.
+ */
 export const HOST_CRM_GROWTH_PACK_POST_EVENT_SUBJECT =
   "Thank you for coming to {{eventTitle}}";
 export const HOST_CRM_GROWTH_PACK_POST_EVENT_BODY =
-  "Hi {{firstName}},\n\nThanks so much for being part of {{eventTitle}} — it wouldn't have been the same without you. Hope to see you at the next one!\n\n{{bashFeedUrl}}";
+  "Hi {{firstName}},\n\nThanks so much for being part of {{eventTitle}} — it wouldn't have been the same without you. Got photos from the night? Save them to Memories, then post on BashFeed or drop them in the album:\n\nMemories: {{memoriesUrl}}\nBashFeed: {{bashFeedUrl}}\n\nHope to see you at the next one!";
+
+/** Recurring email to last-minute buyers (paid within 48h of start). */
+export const HOST_CRM_GROWTH_PACK_LATE_BUYER_PRESET_ID = "last_minute_buyer";
+export const HOST_CRM_GROWTH_PACK_LATE_BUYER_NAME = "Late-buyer logistics nudge";
+export const HOST_CRM_GROWTH_PACK_LATE_BUYER_SUBJECT =
+  "You're in — here's how to make door day smooth";
+export const HOST_CRM_GROWTH_PACK_LATE_BUYER_BODY =
+  "Hi {{firstName}},\n\nGlad you're coming. Since you grabbed tickets close to showtime, leave a few extra minutes for parking and check-in — doors can get busy.\n\nSee you there!";
 
 type GrowthPackAutomationShape = {
   trigger: string;
@@ -128,6 +139,18 @@ export function hostCrmHasPostEventPackAutomation(
   );
 }
 
+/** True when a Recurring Email + last_minute_buyer automation already exists. */
+export function hostCrmHasLateBuyerPackAutomation(
+  automations: GrowthPackAutomationShape[]
+): boolean {
+  return automations.some(
+    (a) =>
+      a.trigger === HostCrmAutomationTrigger.Recurring &&
+      a.channel === HostCrmAutomationChannel.Email &&
+      a.audiencePresetId === HOST_CRM_GROWTH_PACK_LATE_BUYER_PRESET_ID
+  );
+}
+
 export function hostCrmGrowthPackIsComplete(
   automations: GrowthPackAutomationShape[]
 ): boolean {

package/src/index.ts

@@ -10,6 +10,7 @@ export * from "./competitionIdeas.js";
 export * from "./sideQuestIdeas.js";
 export * from "./sideQuestTypes.js";
 export * from "./icebreakerPrompts.js";
+export * from "./causeTags.js";
 export * from "./competitionValidation.js";
 export * from "./groupTicketUtils.js";
 export * from "./guestPartySize.js";
@@ -406,6 +407,7 @@ export * from "./utils/flyerUtils.js";
 export * from "./utils/promotionBlastUtils.js";
 export * from "./utils/orgPromotionalPackageUtils.js";
 export * from "./utils/ticketCheckInDisplay.js";
+export * from "./utils/coatCheckUtils.js";
 export * from "./utils/ticketTierSchedule.js";
 export * from "./utils/lobFlyerUtils.js";
 export * from "./utils/generalDateTimeUtils.js";

package/src/sms/smsTemplates.ts

@@ -10,6 +10,7 @@ export const SMS_TEMPLATE_KEYS = [
   "EVENT_VENUE_CHANGED",
   "EVENT_WAITLIST_APPROVED",
   "TICKET_CONFIRMED",
+  "COAT_CHECK_CLAIM",
 ] as const;
 
 export type SmsTemplateKey = (typeof SMS_TEMPLATE_KEYS)[number];
@@ -23,4 +24,9 @@ export type SmsTemplateContext = {
   EVENT_VENUE_CHANGED: { eventTitle: string; shortUrl: string };
   EVENT_WAITLIST_APPROVED: { eventTitle: string; shortUrl: string };
   TICKET_CONFIRMED: { eventTitle: string; ticketCount: number; ticketsUrl?: string };
+  COAT_CHECK_CLAIM: {
+    eventTitle: string;
+    claimLabel: string;
+    ticketsUrl?: string;
+  };
 };

package/src/utils/__tests__/coatCheckUtils.test.ts

@@ -0,0 +1,110 @@
+import {
+  canTransitionCoatCheckStatus,
+  clampCoatCheckPurchaseQty,
+  coatCheckScanOutcomeForStatus,
+  encodeCoatCheckQrPayload,
+  parseCoatCheckQrPayload,
+  remainingCoatCheckSlots,
+} from "../coatCheckUtils";
+
+describe("coatCheckUtils", () => {
+  describe("encode/parse QR payload", () => {
+    it("round-trips claim QR fields", () => {
+      const raw = encodeCoatCheckQrPayload({
+        eventId: "evt1",
+        entitlementId: "ent1",
+        qrToken: "tok-abc",
+      });
+      const parsed = parseCoatCheckQrPayload(raw);
+      expect(parsed).toMatchObject({
+        type: "coat_check",
+        eventId: "evt1",
+        entitlementId: "ent1",
+        qrToken: "tok-abc",
+      });
+      expect(typeof parsed?.timestamp).toBe("number");
+    });
+
+    it("rejects ticket-style payloads", () => {
+      expect(
+        parseCoatCheckQrPayload(
+          JSON.stringify({ eventId: "e", ticketId: "t", qrToken: "x" })
+        )
+      ).toBeNull();
+    });
+
+    it("rejects invalid JSON", () => {
+      expect(parseCoatCheckQrPayload("not-json")).toBeNull();
+    });
+  });
+
+  describe("state machine", () => {
+    it("allows Paid → CheckedIn → Claimed", () => {
+      expect(canTransitionCoatCheckStatus("Paid", "CheckedIn")).toBe(true);
+      expect(canTransitionCoatCheckStatus("CheckedIn", "Claimed")).toBe(true);
+    });
+
+    it("rejects illegal transitions", () => {
+      expect(canTransitionCoatCheckStatus("Paid", "Claimed")).toBe(false);
+      expect(canTransitionCoatCheckStatus("Claimed", "CheckedIn")).toBe(false);
+      expect(canTransitionCoatCheckStatus("CheckedIn", "Paid")).toBe(false);
+      expect(canTransitionCoatCheckStatus("Paid", "Paid")).toBe(false);
+    });
+
+    it("allows refund/cancel from Paid or CheckedIn", () => {
+      expect(canTransitionCoatCheckStatus("Paid", "Refunded")).toBe(true);
+      expect(canTransitionCoatCheckStatus("CheckedIn", "Cancelled")).toBe(true);
+      expect(canTransitionCoatCheckStatus("Claimed", "Refunded")).toBe(false);
+    });
+
+    it("maps status to scan outcomes", () => {
+      expect(coatCheckScanOutcomeForStatus("Paid")).toBe("ready_for_dropoff");
+      expect(coatCheckScanOutcomeForStatus("CheckedIn")).toBe("ready_for_claim");
+      expect(coatCheckScanOutcomeForStatus("Claimed")).toBe("already_claimed");
+      expect(coatCheckScanOutcomeForStatus("Refunded")).toBe(
+        "cancelled_or_refunded"
+      );
+    });
+  });
+
+  describe("inventory helpers", () => {
+    it("treats null capacity as unlimited remaining", () => {
+      expect(
+        remainingCoatCheckSlots({ capacity: null, occupiedCount: 50 })
+      ).toBeNull();
+    });
+
+    it("computes remaining slots", () => {
+      expect(
+        remainingCoatCheckSlots({ capacity: 100, occupiedCount: 40 })
+      ).toBe(60);
+      expect(
+        remainingCoatCheckSlots({ capacity: 10, occupiedCount: 12 })
+      ).toBe(0);
+    });
+
+    it("clamps purchase qty by max and remaining", () => {
+      expect(
+        clampCoatCheckPurchaseQty({
+          requested: 5,
+          maxPerPurchase: 2,
+          remainingSlots: 10,
+        })
+      ).toBe(2);
+      expect(
+        clampCoatCheckPurchaseQty({
+          requested: 5,
+          maxPerPurchase: 10,
+          remainingSlots: 1,
+        })
+      ).toBe(1);
+      expect(
+        clampCoatCheckPurchaseQty({
+          requested: -3,
+          maxPerPurchase: 2,
+          remainingSlots: null,
+        })
+      ).toBe(0);
+    });
+  });
+});

package/src/utils/coatCheckUtils.ts

@@ -0,0 +1,134 @@
+import {
+  COAT_CHECK_ENTITLEMENT_STATUSES,
+  COAT_CHECK_QR_TYPE,
+  COAT_CHECK_SCAN_OUTCOMES,
+  COAT_CHECK_SLOT_OCCUPYING_STATUSES,
+  type CoatCheckEntitlementStatusName,
+  type CoatCheckScanOutcome,
+} from "../definitions.js";
+
+export type CoatCheckQrPayload = {
+  type: typeof COAT_CHECK_QR_TYPE;
+  eventId: string;
+  entitlementId: string;
+  qrToken: string;
+  timestamp: number;
+};
+
+export function encodeCoatCheckQrPayload(args: {
+  eventId: string;
+  entitlementId: string;
+  qrToken: string;
+}): string {
+  const payload: CoatCheckQrPayload = {
+    type: COAT_CHECK_QR_TYPE,
+    eventId: args.eventId,
+    entitlementId: args.entitlementId,
+    qrToken: args.qrToken,
+    timestamp: Date.now(),
+  };
+  return JSON.stringify(payload);
+}
+
+export function parseCoatCheckQrPayload(
+  raw: string
+): CoatCheckQrPayload | null {
+  try {
+    const parsed = JSON.parse(raw) as Partial<CoatCheckQrPayload>;
+    if (
+      parsed?.type !== COAT_CHECK_QR_TYPE ||
+      typeof parsed.eventId !== "string" ||
+      typeof parsed.entitlementId !== "string" ||
+      typeof parsed.qrToken !== "string"
+    ) {
+      return null;
+    }
+    return {
+      type: COAT_CHECK_QR_TYPE,
+      eventId: parsed.eventId,
+      entitlementId: parsed.entitlementId,
+      qrToken: parsed.qrToken,
+      timestamp:
+        typeof parsed.timestamp === "number" ? parsed.timestamp : Date.now(),
+    };
+  } catch {
+    return null;
+  }
+}
+
+export function coatCheckScanOutcomeForStatus(
+  status: CoatCheckEntitlementStatusName
+): CoatCheckScanOutcome {
+  switch (status) {
+    case "Paid":
+      return "ready_for_dropoff";
+    case "CheckedIn":
+      return "ready_for_claim";
+    case "Claimed":
+      return "already_claimed";
+    case "Refunded":
+    case "Cancelled":
+      return "cancelled_or_refunded";
+    default:
+      return "invalid_or_expired";
+  }
+}
+
+export function canTransitionCoatCheckStatus(
+  from: CoatCheckEntitlementStatusName,
+  to: CoatCheckEntitlementStatusName
+): boolean {
+  if (from === to) return false;
+  if (from === "Paid" && to === "CheckedIn") return true;
+  if (from === "CheckedIn" && to === "Claimed") return true;
+  if (
+    (from === "Paid" || from === "CheckedIn") &&
+    (to === "Refunded" || to === "Cancelled")
+  ) {
+    return true;
+  }
+  return false;
+}
+
+export function isCoatCheckSlotOccupyingStatus(
+  status: string
+): status is CoatCheckEntitlementStatusName {
+  return (COAT_CHECK_SLOT_OCCUPYING_STATUSES as readonly string[]).includes(
+    status
+  );
+}
+
+export function isCoatCheckEntitlementStatus(
+  status: string
+): status is CoatCheckEntitlementStatusName {
+  return (COAT_CHECK_ENTITLEMENT_STATUSES as readonly string[]).includes(status);
+}
+
+export function assertCoatCheckScanOutcome(
+  outcome: string
+): outcome is CoatCheckScanOutcome {
+  return (COAT_CHECK_SCAN_OUTCOMES as readonly string[]).includes(outcome);
+}
+
+/** Remaining slots; null capacity = unlimited (Infinity for math). */
+export function remainingCoatCheckSlots(args: {
+  capacity: number | null | undefined;
+  occupiedCount: number;
+}): number | null {
+  if (args.capacity == null) return null;
+  return Math.max(0, args.capacity - args.occupiedCount);
+}
+
+export function clampCoatCheckPurchaseQty(args: {
+  requested: number;
+  maxPerPurchase: number;
+  remainingSlots: number | null;
+}): number {
+  const maxPer = Math.max(1, args.maxPerPurchase || 1);
+  let qty = Math.max(0, Math.floor(args.requested));
+  qty = Math.min(qty, maxPer);
+  if (args.remainingSlots != null) {
+    qty = Math.min(qty, args.remainingSlots);
+  }
+  return qty;
+}

package/src/utils/slugUtils.ts

@@ -53,10 +53,9 @@ export function getPublicBashDetailPath(
 }
 
 /**
- * Public, shareable Memories recap path for a bash — nested under the bash
- * detail path so it inherits the same id/slug parsing (`/bash/{id}-{slug}/memories`).
- * No-login-required by design: the whole point of Memories is that a shared
- * link works for people who aren't signed in yet.
+ * Path to Your Memories (private vault) for a bash — nested under bash detail
+ * (`/bash/{id}-{slug}/memories`). Requires sign-in + eligibility; not a public
+ * unauthenticated recap page.
  */
 export function getPublicBashMemoriesPath(
   bashEventId: string,