@bash-app/bash-common 30.391.0 → 30.393.0

package/src/__tests__/userTaste.test.ts

@@ -0,0 +1,33 @@
+import { UserTasteKind, isValidTasteValue, userHasTravelTaste } from "../userTaste.js";
+import { DiscoveryScope } from "../discoveryScope.js";
+
+describe("userTaste", () => {
+  it("accepts Festival event types and rejects junk", () => {
+    expect(isValidTasteValue(UserTasteKind.EventType, "Festival")).toBe(true);
+    expect(isValidTasteValue(UserTasteKind.EventType, "Networking")).toBe(
+      false
+    );
+  });
+
+  it("accepts cause tags and genres", () => {
+    expect(isValidTasteValue(UserTasteKind.CauseTag, "lgbtq")).toBe(true);
+    expect(isValidTasteValue(UserTasteKind.MusicGenre, "House")).toBe(true);
+    expect(isValidTasteValue(UserTasteKind.DiscoveryScope, DiscoveryScope.National)).toBe(
+      true
+    );
+    expect(
+      isValidTasteValue(UserTasteKind.DiscoveryScope, DiscoveryScope.Unspecified)
+    ).toBe(false);
+  });
+
+  it("detects travel taste", () => {
+    expect(
+      userHasTravelTaste([
+        { kind: UserTasteKind.DiscoveryScope, value: DiscoveryScope.National },
+      ])
+    ).toBe(true);
+    expect(
+      userHasTravelTaste([{ kind: UserTasteKind.EventType, value: "Festival" }])
+    ).toBe(false);
+  });
+});

package/src/budgetApproval.ts

@@ -0,0 +1,303 @@
+/**
+ * Event-level budget approval requests — plan sign-off and pre-plan cap asks.
+ * Shared types and validation for api + bash-app.
+ */
+
+import {
+  BASH_EVENT_WIZARD_HOW_MAJOR_STEP,
+  BASH_EVENT_WIZARD_HOW_SUBSTEP,
+} from "./definitions.js";
+
+export const BUDGET_APPROVAL_TTL_DAYS = 14;
+
+export const BudgetApprovalKind = {
+  CapAsk: "CapAsk",
+  PlanSignOff: "PlanSignOff",
+} as const;
+
+export type BudgetApprovalKind =
+  (typeof BudgetApprovalKind)[keyof typeof BudgetApprovalKind];
+
+export const BUDGET_APPROVAL_KINDS = [
+  BudgetApprovalKind.CapAsk,
+  BudgetApprovalKind.PlanSignOff,
+] as const;
+export type BudgetApprovalKindName = BudgetApprovalKind;
+
+export const BudgetApprovalStatus = {
+  Pending: "Pending",
+  Approved: "Approved",
+  ChangesRequested: "ChangesRequested",
+  Declined: "Declined",
+  Cancelled: "Cancelled",
+  Superseded: "Superseded",
+} as const;
+
+export type BudgetApprovalStatus =
+  (typeof BudgetApprovalStatus)[keyof typeof BudgetApprovalStatus];
+
+export const BUDGET_APPROVAL_STATUSES = [
+  BudgetApprovalStatus.Pending,
+  BudgetApprovalStatus.Approved,
+  BudgetApprovalStatus.ChangesRequested,
+  BudgetApprovalStatus.Declined,
+  BudgetApprovalStatus.Cancelled,
+  BudgetApprovalStatus.Superseded,
+] as const;
+export type BudgetApprovalStatusName = BudgetApprovalStatus;
+
+export const BUDGET_APPROVAL_ACTIONS = [
+  "approve",
+  "changes",
+  "decline",
+] as const;
+export type BudgetApprovalAction = (typeof BUDGET_APPROVAL_ACTIONS)[number];
+
+export type BudgetApprovalSnapshotLine = {
+  id: string;
+  name: string;
+  category: string | null;
+  totalAllocatedCents: number;
+};
+
+export type BudgetApprovalLineNoteInput = {
+  budgetId?: string | null;
+  nameSnapshot: string;
+  categorySnapshot?: string | null;
+  allocatedCentsSnapshot: number;
+  note: string;
+};
+
+export type BudgetApprovalDecideInput = {
+  action: BudgetApprovalAction;
+  kind: BudgetApprovalKindName;
+  approverName?: string | null;
+  decisionNote?: string | null;
+  authorizedCents?: number | null;
+  lineNotes?: BudgetApprovalLineNoteInput[] | null;
+};
+
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+
+export function normalizeApproverEmail(email: string): string {
+  return email.trim().toLowerCase();
+}
+
+export function isValidApproverEmail(email: string): boolean {
+  return EMAIL_RE.test(email.trim());
+}
+
+export function isBudgetApprovalKind(
+  value: string
+): value is BudgetApprovalKindName {
+  return (BUDGET_APPROVAL_KINDS as readonly string[]).includes(value);
+}
+
+export function isBudgetApprovalAction(
+  value: string
+): value is BudgetApprovalAction {
+  return (BUDGET_APPROVAL_ACTIONS as readonly string[]).includes(value);
+}
+
+export function isBudgetApprovalExpired(
+  expiresAt: Date | string,
+  now: Date = new Date()
+): boolean {
+  return now.getTime() > new Date(expiresAt).getTime();
+}
+
+function canonicalizeSnapshotLines(
+  lines: BudgetApprovalSnapshotLine[]
+): BudgetApprovalSnapshotLine[] {
+  return [...lines]
+    .map((line) => ({
+      id: line.id,
+      name: line.name,
+      category: line.category ?? null,
+      totalAllocatedCents: line.totalAllocatedCents,
+    }))
+    .sort((a, b) => a.id.localeCompare(b.id));
+}
+
+export function buildBudgetApprovalSnapshot(
+  lines: Array<{
+    id: string;
+    name: string;
+    category?: string | null;
+    totalAllocatedCents: number;
+  }>
+): { lines: BudgetApprovalSnapshotLine[]; totalCents: number; hash: string } {
+  const snapshotLines: BudgetApprovalSnapshotLine[] = lines.map((line) => ({
+    id: line.id,
+    name: line.name,
+    category: line.category ?? null,
+    totalAllocatedCents: line.totalAllocatedCents,
+  }));
+  const totalCents = snapshotLines.reduce(
+    (sum, line) => sum + line.totalAllocatedCents,
+    0
+  );
+  return {
+    lines: snapshotLines,
+    totalCents,
+    hash: budgetApprovalSnapshotHash(snapshotLines),
+  };
+}
+
+export function budgetApprovalSnapshotHash(
+  lines: BudgetApprovalSnapshotLine[]
+): string {
+  return JSON.stringify(canonicalizeSnapshotLines(lines));
+}
+
+export function parseBudgetApprovalSnapshot(
+  json: unknown
+): BudgetApprovalSnapshotLine[] {
+  if (!Array.isArray(json)) return [];
+  const lines: BudgetApprovalSnapshotLine[] = [];
+  for (const row of json) {
+    if (!row || typeof row !== "object") continue;
+    const rec = row as Record<string, unknown>;
+    if (typeof rec.id !== "string" || typeof rec.name !== "string") continue;
+    if (typeof rec.totalAllocatedCents !== "number") continue;
+    lines.push({
+      id: rec.id,
+      name: rec.name,
+      category: typeof rec.category === "string" ? rec.category : null,
+      totalAllocatedCents: rec.totalAllocatedCents,
+    });
+  }
+  return lines;
+}
+
+export function budgetApprovalSnapshotsMatch(
+  current: BudgetApprovalSnapshotLine[],
+  snapshot: BudgetApprovalSnapshotLine[]
+): boolean {
+  return (
+    budgetApprovalSnapshotHash(current) === budgetApprovalSnapshotHash(snapshot)
+  );
+}
+
+export function validateBudgetApprovalDecide(
+  input: BudgetApprovalDecideInput
+): { ok: true } | { ok: false; error: string } {
+  const decisionNote = input.decisionNote?.trim() ?? "";
+  const lineNotes = (input.lineNotes ?? []).filter(
+    (note) => note.note.trim().length > 0
+  );
+
+  if (input.kind === "CapAsk" && lineNotes.length > 0) {
+    return { ok: false, error: "A cap ask has no budget lines to annotate." };
+  }
+
+  if (input.action === "approve") {
+    if (input.kind === "CapAsk") {
+      const cents = input.authorizedCents;
+      if (cents == null || !Number.isFinite(cents) || cents <= 0) {
+        return {
+          ok: false,
+          error: "Enter an authorized amount greater than zero.",
+        };
+      }
+    }
+    return { ok: true };
+  }
+
+  if (input.action === "changes") {
+    if (input.kind === "CapAsk") {
+      if (!decisionNote) {
+        return {
+          ok: false,
+          error: "Add a note so the host knows what to change.",
+        };
+      }
+      return { ok: true };
+    }
+    if (!decisionNote && lineNotes.length === 0) {
+      return {
+        ok: false,
+        error: "Add an overall note or a note on at least one line.",
+      };
+    }
+    return { ok: true };
+  }
+
+  return { ok: true };
+}
+
+export function resolveApproverDisplayName(params: {
+  decidedName?: string | null;
+  hostHintName?: string | null;
+  email: string;
+}): string {
+  const decided = params.decidedName?.trim();
+  if (decided) return decided;
+  const hint = params.hostHintName?.trim();
+  if (hint) return hint;
+  return params.email;
+}
+
+export function formatBudgetCents(cents: number): string {
+  return new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: "USD",
+    minimumFractionDigits: 0,
+    maximumFractionDigits: 0,
+  }).format(cents / 100);
+}
+
+export function eventBudgetApprovalWizardPath(bashEventId: string): string {
+  return `/bash-event-wizard/${bashEventId}/${BASH_EVENT_WIZARD_HOW_MAJOR_STEP}/${BASH_EVENT_WIZARD_HOW_SUBSTEP.BUDGET}?budgetTab=lines`;
+}
+
+export type BudgetApprovalPublicDto = {
+  kind: BudgetApprovalKindName;
+  status: BudgetApprovalStatusName;
+  hostNote: string | null;
+  hostDisplayName: string;
+  event: {
+    id: string;
+    title: string;
+    startDateTime: string | null;
+    slug: string | null;
+  };
+  snapshotLines: BudgetApprovalSnapshotLine[];
+  snapshotTotalCents: number;
+  expiresAt: string;
+  expired: boolean;
+  alreadyDecided: boolean;
+  eventIsPubliclyViewable: boolean;
+};
+
+export type BudgetApprovalHostDto = {
+  id: string;
+  kind: BudgetApprovalKindName;
+  status: BudgetApprovalStatusName;
+  approverEmail: string;
+  approverName: string | null;
+  hostNote: string | null;
+  decisionNote: string | null;
+  authorizedCents: number | null;
+  snapshotTotalCents: number;
+  staleAt: string | null;
+  decidedAt: string | null;
+  expiresAt: string;
+  createdAt: string;
+  isExpired: boolean;
+  emailError?: boolean;
+  lineNotes: Array<{
+    budgetId: string | null;
+    nameSnapshot: string;
+    categorySnapshot: string | null;
+    allocatedCentsSnapshot: number;
+    note: string;
+  }>;
+};
+
+export type BudgetApprovalHostSummary = {
+  latest: BudgetApprovalHostDto | null;
+  history: BudgetApprovalHostDto[];
+  planMatchesSnapshot: boolean;
+  currentAuthorizedCents: number | null;
+};

package/src/crewSocialCopy.ts

@@ -0,0 +1,37 @@
+/**
+ * Privacy-safe social-proof lines for suggestions and reminders.
+ * Never name hidden attendees. Never use a follow-count when names are hidden.
+ */
+
+export type CrewGoingPerson = {
+  displayName: string;
+  attendanceVisible: boolean;
+};
+
+export type CrewSocialCopy = {
+  line: string | null;
+  named: boolean;
+};
+
+export function crewSocialProofCopy(
+  people: readonly CrewGoingPerson[]
+): CrewSocialCopy {
+  const visible = people.filter((p) => p.attendanceVisible && p.displayName.trim());
+  const hidden = people.filter((p) => !p.attendanceVisible);
+
+  if (visible.length >= 2) {
+    const a = visible[0].displayName.trim();
+    const b = visible[1].displayName.trim();
+    return { line: `${a} and ${b} are going`, named: true };
+  }
+  if (visible.length === 1) {
+    return { line: `${visible[0].displayName.trim()} is going`, named: true };
+  }
+  if (hidden.length > 0) {
+    return { line: "Your crew's on this one", named: false };
+  }
+  return { line: null, named: false };
+}
+
+export const CREW_GOING_RAIL_TITLE = "The crew's going";
+export const SCENE_PROMPT_COPY = "What's your scene?";

package/src/definitions.ts

@@ -675,6 +675,7 @@ export const HTTP_CODE_BAD_REQUEST = 400 as const;
 export const HTTP_CODE_UNAUTHORIZED = 401 as const;
 export const HTTP_CODE_FORBIDDEN = 403 as const;
 export const HTTP_CODE_NOT_FOUND = 404 as const;
+export const HTTP_CODE_GONE = 410 as const;
 export const ERR_UNAUTHORIZED_REQUEST =
   "Unauthorized to perform requested action. Have you logged in?" as const;
 export const ERR_SESSION_EXPIRED =
@@ -1822,6 +1823,11 @@ const SYNTHETIC_BASH_SECTION_TITLE: Record<string, string> = {
   Featured: "Featured",
   Popular: "Popular",
   Trending: "Trending",
+  CrewGoing: "The crew's going",
+  Local: "Local",
+  State: "Statewide",
+  National: "Across the country",
+  International: "Worth the flight",
 };
 
 /**

package/src/discoveryScope.ts

@@ -0,0 +1,170 @@
+/**
+ * Geographic / importance scope for public discovery.
+ * Orthogonal to `BashEventType` — a Fair can be Local or State.
+ */
+
+export const DiscoveryScope = {
+  Local: "Local",
+  State: "State",
+  National: "National",
+  International: "International",
+  Unspecified: "Unspecified",
+} as const;
+
+export type DiscoveryScope =
+  (typeof DiscoveryScope)[keyof typeof DiscoveryScope];
+
+export const DISCOVERY_SCOPE_VALUES: readonly DiscoveryScope[] = [
+  DiscoveryScope.Local,
+  DiscoveryScope.State,
+  DiscoveryScope.National,
+  DiscoveryScope.International,
+  DiscoveryScope.Unspecified,
+] as const;
+
+/** Homepage / category row keys (not Unspecified). */
+export const DISCOVERY_SCOPE_ROW_KEYS = [
+  DiscoveryScope.Local,
+  DiscoveryScope.State,
+  DiscoveryScope.National,
+  DiscoveryScope.International,
+] as const;
+
+export const DISCOVERY_SCOPE_SECTION_TITLE: Record<
+  (typeof DISCOVERY_SCOPE_ROW_KEYS)[number],
+  string
+> = {
+  Local: "Local",
+  State: "Statewide",
+  National: "Across the country",
+  International: "Worth the flight",
+};
+
+/** Hosts may set these without a hard signal. */
+export const HOST_SETTABLE_DISCOVERY_SCOPES: readonly DiscoveryScope[] = [
+  DiscoveryScope.Unspecified,
+  DiscoveryScope.Local,
+  DiscoveryScope.State,
+];
+
+export const HOST_SCOPE_CHIPS: ReadonlyArray<{
+  id: DiscoveryScope;
+  label: string;
+}> = [
+  { id: DiscoveryScope.Unspecified, label: "Not sure yet" },
+  { id: DiscoveryScope.Local, label: "Just the neighborhood / city-wide" },
+  {
+    id: DiscoveryScope.State,
+    label: "People will drive from across the state",
+  },
+];
+
+export function isDiscoveryScope(value: unknown): value is DiscoveryScope {
+  return (
+    typeof value === "string" &&
+    (DISCOVERY_SCOPE_VALUES as readonly string[]).includes(value)
+  );
+}
+
+export function isHostSettableDiscoveryScope(
+  value: unknown
+): value is DiscoveryScope {
+  return (
+    typeof value === "string" &&
+    (HOST_SETTABLE_DISCOVERY_SCOPES as readonly string[]).includes(value)
+  );
+}
+
+export function isNationalOrInternational(scope: DiscoveryScope): boolean {
+  return (
+    scope === DiscoveryScope.National || scope === DiscoveryScope.International
+  );
+}
+
+/**
+ * Known touring / destination brands that are a hard signal for National.
+ * Small allowlist — not a taxonomy.
+ */
+export const NATIONAL_SCOPE_BRAND_PATTERN =
+  /\b(insomniac|c3 presents|aeg presents|live nation|coachella|lollapalooza|bonnaroo|ultra miami|edc las vegas|edc vegas|burning man|sxsw|comic-?con|ces\b|super bowl|final four|wrestlemania)\b/i;
+
+export const INTERNATIONAL_SCOPE_PATTERN =
+  /\b(world tour|world cup|olympics|tomorrowland|glastonbury|primavera sound|oktoberfest|cannes|eurovision|ibiza)\b/i;
+
+export const STATE_SCOPE_PATTERN =
+  /\b(state fair|statewide|governor'?s? (?:ball|festival)|days of ['’]?47|pioneer day)\b/i;
+
+export const LOCAL_SCOPE_PATTERN =
+  /\b(block party|neighborhood|community day|city-sponsored|city festival)\b/i;
+
+export function inferDiscoveryScopeFromText(
+  title: string | undefined,
+  description?: string | undefined
+): DiscoveryScope {
+  const text = `${title ?? ""} ${description ?? ""}`.trim();
+  if (!text) return DiscoveryScope.Unspecified;
+  if (INTERNATIONAL_SCOPE_PATTERN.test(text)) {
+    return DiscoveryScope.International;
+  }
+  if (NATIONAL_SCOPE_BRAND_PATTERN.test(text)) {
+    return DiscoveryScope.National;
+  }
+  if (STATE_SCOPE_PATTERN.test(text)) return DiscoveryScope.State;
+  if (LOCAL_SCOPE_PATTERN.test(text)) return DiscoveryScope.Local;
+  return DiscoveryScope.Unspecified;
+}
+
+export type DiscoveryScopeWriteRole = "host" | "superUser" | "scraper";
+
+/**
+ * Hosts cannot self-promote to National/International unless a hard text
+ * signal is already present (or the writer is a super-user / scraper).
+ */
+export function resolveDiscoveryScopeForWrite(args: {
+  requested: string | null | undefined;
+  existing?: string | null | undefined;
+  role: DiscoveryScopeWriteRole;
+  title?: string | null;
+  description?: string | null;
+}): DiscoveryScope {
+  const inferred = inferDiscoveryScopeFromText(
+    args.title ?? undefined,
+    args.description ?? undefined
+  );
+  const requested = isDiscoveryScope(args.requested)
+    ? args.requested
+    : undefined;
+  const existing = isDiscoveryScope(args.existing) ? args.existing : undefined;
+
+  if (args.role === "superUser" || args.role === "scraper") {
+    return requested ?? existing ?? inferred;
+  }
+
+  if (requested && isHostSettableDiscoveryScope(requested)) {
+    return requested;
+  }
+
+  if (
+    requested &&
+    isNationalOrInternational(requested) &&
+    inferred === requested
+  ) {
+    return requested;
+  }
+
+  if (existing && isHostSettableDiscoveryScope(existing)) {
+    return existing;
+  }
+
+  if (existing && isNationalOrInternational(existing)) {
+    return existing;
+  }
+
+  if (inferred !== DiscoveryScope.Unspecified && !requested) {
+    return inferred;
+  }
+
+  return DiscoveryScope.Unspecified;
+}
+
+export const MIN_EVENTS_FOR_SCOPE_ROW = 3;

package/src/home.ts

@@ -23,7 +23,22 @@ export {
 
 export {
   DEFAULT_FEATURED_RADIUS_MILES,
+  haversineMiles,
   sortPublicEventsForFeaturedDiscovery,
 } from "./utils/featuredDiscoveryGeo.js";
 
 export { causeTagsMatchSearch } from "./causeTags.js";
+
+export {
+  DiscoveryScope,
+  DISCOVERY_SCOPE_ROW_KEYS,
+  MIN_EVENTS_FOR_SCOPE_ROW,
+  isNationalOrInternational,
+} from "./discoveryScope.js";
+
+export { userHasTravelTaste, UserTasteKind } from "./userTaste.js";
+
+export { CREW_GOING_RAIL_TITLE, SCENE_PROMPT_COPY } from "./crewSocialCopy.js";
+
+export { scoreSuggestion } from "./suggestionScore.js";
+export type { SuggestionTasteRow } from "./suggestionScore.js";

package/src/hostCrmCrowdPulse.ts

@@ -83,6 +83,8 @@ export type HostCrmCrowdPulseBash = {
   capacity: number | null;
   /** Distinct checked-in ticket holders. */
   checkedInCount: number;
+  /** Anonymized Accepted SuggestedNight / favorite saves. */
+  savedCount: number;
 };
 
 export type HostCrmCrowdPulse = {

package/src/hostCrmSegments.ts

@@ -41,6 +41,12 @@ export type HostCrmSegmentRules = {
   bringsGuests?: boolean;
   /** Ticket buyers for any of these bash event ids (e.g. the host's 3 most recently ended bashes — see the last3Events preset) */
   sourceEventIdIn?: string[];
+  /** Guest taste: EventType value (own audience + hostsMayTargetTaste only). */
+  tasteEventType?: string;
+  /** Guest taste: MusicGenre value. */
+  tasteGenre?: string;
+  /** Guest opted into National/International travel chips. */
+  tasteTravel?: boolean;
 };
 
 export type HostCrmDiscoverySource = "promoter" | "referral" | "direct";

package/src/index.ts

@@ -1,5 +1,6 @@
 export * from "./definitions.js";
 export * from "./fundingMeter.js";
+export * from "./budgetApproval.js";
 export * from "./giveaway.js";
 export * from "./requestAuthUser.js";
 export * from "./sms/smsTemplates.js";
@@ -13,6 +14,11 @@ export * from "./sideQuestIdeas.js";
 export * from "./sideQuestTypes.js";
 export * from "./icebreakerPrompts.js";
 export * from "./causeTags.js";
+export * from "./discoveryScope.js";
+export * from "./userTaste.js";
+export * from "./crewSocialCopy.js";
+export * from "./suggestionScore.js";
+export * from "./suggestedNight.js";
 export * from "./competitionValidation.js";
 export * from "./groupTicketUtils.js";
 export * from "./guestPartySize.js";
@@ -56,10 +62,15 @@ export * from "./targetAudienceLabels.js";
 export * from "./liveActivity/liveActivityTypes.js";
 
 // Re-export ALL Prisma enums as values (usable as runtime constants, e.g. ServiceTypes.Entertainment)
-// Excludes enums already re-exported by definitions.ts, mirroredPrismaEnums.ts, and membershipDefinitions.ts:
+// Excludes enums already re-exported by definitions.ts, mirroredPrismaEnums.ts, membershipDefinitions.ts,
+// and local domain modules (so API boot does not wait on prisma generate):
 //   mirroredPrismaEnums.ts: ServiceCancellationPolicy
 //   definitions.ts:       YearsOfExperience, GovIdRetentionPolicy, EntertainmentServiceType, MusicGenreType, ServiceTypes,
 //   membershipDefinitions.ts: MembershipTier, ReferralTier, CreditTransactionType
+//   budgetApproval.ts:    BudgetApprovalKind, BudgetApprovalStatus
+//   discoveryScope.ts:    DiscoveryScope
+//   userTaste.ts:         UserTasteKind, UserTasteSource
+//   suggestedNight.ts:    SuggestedNightStatus
 export {
   $Enums,
   AISpecialistFormat,
@@ -115,8 +126,6 @@ export {
   ChairsFormat,
   ClaimRequestStatus,
   CleaningSubType,
-  ClubAdminRole,
-  ClubMemberStatus,
   ConnectionStatus,
   ConsentType,
   ConsultantFormat,

package/src/sms/smsTemplates.ts

@@ -15,6 +15,7 @@ export const SMS_TEMPLATE_KEYS = [
   "EVENT_WAITLIST_APPROVED",
   "TICKET_CONFIRMED",
   "COAT_CHECK_CLAIM",
+  "SUGGESTED_NIGHT_REMINDER_24H",
 ] as const;
 
 export type SmsTemplateKey = (typeof SMS_TEMPLATE_KEYS)[number];
@@ -56,4 +57,9 @@ export type SmsTemplateContext = {
     claimLabel: string;
     ticketsUrl?: string;
   };
+  SUGGESTED_NIGHT_REMINDER_24H: {
+    eventTitle: string;
+    shortUrl: string;
+    socialProof?: string;
+  };
 };

package/src/suggestedNight.ts

@@ -0,0 +1,20 @@
+export const SuggestedNightStatus = {
+  Proposed: "Proposed",
+  Accepted: "Accepted",
+  Dismissed: "Dismissed",
+  Expired: "Expired",
+} as const;
+
+export type SuggestedNightStatus =
+  (typeof SuggestedNightStatus)[keyof typeof SuggestedNightStatus];
+
+export const FAVORITE_NUDGE_REMINDER_TYPE = "SUGGESTED_NIGHT_24H";
+
+export type UnfavoriteSuggestedNightAction = "delete" | "dismiss";
+
+/** Never nudged → delete. Already nudged → keep Dismissed so we do not re-propose. */
+export function unfavoriteSuggestedNightAction(
+  remindedAt: Date | string | null | undefined
+): UnfavoriteSuggestedNightAction {
+  return remindedAt ? "dismiss" : "delete";
+}