@bash-app/bash-common 30.400.0 → 30.406.0

package/src/definitions.ts

@@ -4,7 +4,6 @@ import {
     Contact,
     DietaryOption,
     EntertainmentServiceType,
-    IncomeRange,
     JudgingType,
     MembershipTier,
     MusicGenreType,
@@ -17,6 +16,7 @@ import {
 } from "@prisma/client";
 import type {
     AgePolicy as AgePolicyEnum,
+    IncomeRange,
     BashPassTier,
     BashEventDressTags,
     BashEventVibeTags,
@@ -134,6 +134,109 @@ export const AgePolicy = {
 
 export type AgePolicy = AgePolicyEnum;
 
+export const INTRO_INTENT_OPTIONS = [
+  { id: "friends", label: "Making friends" },
+  { id: "professional", label: "Professional networking" },
+  { id: "mentorship", label: "Finding a mentor or mentee" },
+] as const;
+
+export type IntroIntentId = (typeof INTRO_INTENT_OPTIONS)[number]["id"];
+
+export const INTRO_INTENT_IDS: readonly IntroIntentId[] =
+  INTRO_INTENT_OPTIONS.map((option) => option.id);
+
+export function isIntroIntentId(value: string): value is IntroIntentId {
+  return (INTRO_INTENT_IDS as readonly string[]).includes(value);
+}
+
+export const LOCUS_OF_CONTROL_OPTIONS = [
+  { id: "internal", label: "Internal — I shape my own outcomes" },
+  { id: "external", label: "External — circumstances shape outcomes" },
+  { id: "mixed", label: "Mixed — bit of both" },
+] as const;
+
+export type LocusOfControlId = (typeof LOCUS_OF_CONTROL_OPTIONS)[number]["id"];
+
+export const LOCUS_OF_CONTROL_IDS: readonly LocusOfControlId[] =
+  LOCUS_OF_CONTROL_OPTIONS.map((option) => option.id);
+
+export function isLocusOfControlId(value: string): value is LocusOfControlId {
+  return (LOCUS_OF_CONTROL_IDS as readonly string[]).includes(value);
+}
+
+export const PERSONALITY_TYPE_MAX_LENGTH = 4;
+
+export function normalizePersonalityType(
+  value: string | null | undefined
+): string | null {
+  if (!value) return null;
+  const normalized = value
+    .toUpperCase()
+    .replace(/[^A-Z]/g, "")
+    .slice(0, PERSONALITY_TYPE_MAX_LENGTH);
+  return normalized.length > 0 ? normalized : null;
+}
+
+/** True if two MBTI codes share the same second letter (S/N axis). */
+export function hasSensingIntuitionOverlap(a: string, b: string): boolean {
+  return (
+    a.length >= 2 &&
+    b.length >= 2 &&
+    a[1].toUpperCase() === b[1].toUpperCase()
+  );
+}
+
+export function personalityOverlapHint(
+  a: string | null | undefined,
+  b: string | null | undefined
+): string | null {
+  if (!a || !b || !hasSensingIntuitionOverlap(a, b)) return null;
+  return `You both picked ${a[1].toUpperCase()} — good icebreaker.`;
+}
+
+export function sharedIntroIntentHint(
+  viewerIntents: readonly string[] | null | undefined,
+  guestIntents: readonly string[] | null | undefined
+): string | null {
+  if (!viewerIntents?.length || !guestIntents?.length) return null;
+  const guest = new Set(guestIntents);
+  const match = viewerIntents.find((id) => guest.has(id));
+  if (!match || !isIntroIntentId(match)) return null;
+  const label = INTRO_INTENT_OPTIONS.find((option) => option.id === match)?.label;
+  return label ? `You're both here for ${label.toLowerCase()}.` : null;
+}
+
+export function locusOfControlShortLabel(
+  id: string | null | undefined
+): string | null {
+  if (!id || !isLocusOfControlId(id)) return null;
+  if (id === "internal") return "Internal";
+  if (id === "external") return "External";
+  return "Mixed";
+}
+
+export const INTEREST_EXPRESSION_MODES = ["named", "anonymous"] as const;
+
+export type InterestExpressionMode = (typeof INTEREST_EXPRESSION_MODES)[number];
+
+export function isInterestExpressionMode(
+  value: string
+): value is InterestExpressionMode {
+  return (INTEREST_EXPRESSION_MODES as readonly string[]).includes(value);
+}
+
+export const INTROS_DISCLAIMER =
+  "Intros connects you only with people who have also explicitly opted in. Bash does not conduct background checks, verify identities beyond basic account registration, or screen users for any purpose. This feature supports platonic and professional connections only — romantic or sexual contact is a violation of our Community Guidelines. Always meet at the event, in public. Use the Report button if anyone makes you uncomfortable. By turning on Intros, you agree that Bash is not responsible for interactions between users.";
+
+export const INTROS_DISCLAIMER_SHORT =
+  "Bash does not background-check users. Meet at the event, in public. Romantic or sexual contact is prohibited. Bash is not responsible for interactions between users.";
+
+/** @deprecated Use INTROS_DISCLAIMER */
+export const SCENE_INTROS_DISCLAIMER = INTROS_DISCLAIMER;
+
+/** @deprecated Use INTROS_DISCLAIMER_SHORT */
+export const SCENE_INTROS_DISCLAIMER_SHORT = INTROS_DISCLAIMER_SHORT;
+
 export const PASSWORD_MIN_LENGTH = 8 as const;
 export const PASSWORD_REQUIREMENTS_REGEX = new RegExp(
   String.raw`^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&^#])[A-Za-z\d@$!%*?&^#]{${PASSWORD_MIN_LENGTH},}$`
@@ -1366,6 +1469,8 @@ export interface StripeConfirmPaymentResult {
   ticketsSubtotalCents?: number;
   /** Actual amount charged to the guest (cents), including pass-through fees when applicable */
   totalPaidCents?: number;
+  /** True when this is the buyer's first ticket purchase on Bash ever. */
+  isFirstTicketPurchase?: boolean;
 }
 
 export interface IMediaUploadArgs {
@@ -1649,96 +1754,101 @@ export type BashEventTypeToStringType = {
   [key in BashEventType]: string;
 };
 export { BashEventType };
+/**
+ * Keys are string literals (not `BashEventType.*`) so this module can load
+ * when Jest's `@prisma/client` cache is briefly incomplete after resetModules
+ * (see api/jest.setup.afterEnv.cjs). Same pattern as SERVICE_TYPE_LABELS.
+ */
 export const BashEventTypeToString: BashEventTypeToStringType = {
-  [BashEventType.AfterParty]: "After-Party",
-  [BashEventType.AnniversaryCelebration]: "Anniversary Celebration",
-  [BashEventType.ArtAndCraftNight]: "Art and Craft Night",
-  [BashEventType.ArtExhibitOpening]: "Art Exhibit Opening",
-  [BashEventType.BBQCookout]: "BBQ Cookout",
-  [BashEventType.BabyShower]: "Baby Shower",
-  [BashEventType.BachelorParty]: "Bachelor Party",
-  [BashEventType.BacheloretteParty]: "Bachelorette Party",
-  [BashEventType.BeachParty]: "Beach Party",
-  [BashEventType.Birthday]: "Birthday",
-  [BashEventType.BoatParty]: "Boat Party",
-  [BashEventType.Bonfire]: "Bonfire",
-  [BashEventType.BridalShower]: "Bridal Shower",
-  [BashEventType.BrunchGathering]: "Brunch Gathering",
-  [BashEventType.CarShow]: "Car Show",
-  [BashEventType.Carnival]: "Carnival",
-  [BashEventType.CasinoNight]: "Casino Night",
-  [BashEventType.CasualMixer]: "Casual Mixer",
-  [BashEventType.CharityGala]: "Charity Gala",
-  [BashEventType.ChristmasParty]: "Christmas Party",
-  [BashEventType.ChurchEvent]: "Church Event",
-  [BashEventType.CitySponsored]: "City-Sponsored Event",
-  [BashEventType.CocktailParty]: "Cocktail Party",
-  [BashEventType.CollegeParty]: "College Party",
-  [BashEventType.ComedyShow]: "Comedy Show",
-  [BashEventType.Concert]: "Concert",
-  [BashEventType.Conference]: "Conference",
-  [BashEventType.Convention]: "Convention",
-  [BashEventType.CorporateEvent]: "Corporate Event",
-  [BashEventType.Cruise]: "Cruise",
-  [BashEventType.DanceParty]: "Dance Party",
-  [BashEventType.DiscoNight]: "Disco Night",
-  [BashEventType.EasterGathering]: "Easter Gathering",
-  [BashEventType.EngagementParty]: "Engagement Party",
-  [BashEventType.Fair]: "Fair",
-  [BashEventType.FarewellParty]: "Farewell Party",
-  [BashEventType.FashionShow]: "Fashion Show",
-  [BashEventType.Festival]: "Festival",
-  [BashEventType.FestivalFilm]: "Film Festival",
-  [BashEventType.FestivalFood]: "Food Festival",
-  [BashEventType.Fundraiser]: "Fundraiser",
-  [BashEventType.GameNight]: "Game Night",
-  [BashEventType.GamingEvent]: "Gaming Event",
-  [BashEventType.GardenParty]: "Garden Party",
-  [BashEventType.GraduationParty]: "Graduation Party",
-  [BashEventType.HalloweenParty]: "Halloween Party",
-  [BashEventType.HanukkahParty]: "Hanukkah Party",
-  [BashEventType.HolidayParty]: "Holiday Party",
-  [BashEventType.HouseParty]: "House Party",
-  [BashEventType.HousewarmingParty]: "Housewarming Party",
-  [BashEventType.KaraokeNight]: "Karaoke Night",
-  [BashEventType.LaunchParty]: "Launch Party",
-  [BashEventType.LuxuryRetreat]: "Luxury Retreat",
-  [BashEventType.MansionParty]: "Mansion Party",
-  [BashEventType.MardiGras]: "Mardi Gras",
-  [BashEventType.Memorial]: "Memorial",
-  [BashEventType.MovieNight]: "Movie Night",
-  [BashEventType.MoviePremiere]: "Movie Premiere",
-  [BashEventType.MusicFestival]: "Music Festival",
-  [BashEventType.NewYearsEveCelebration]: "New Year's Eve Celebration",
-  [BashEventType.OfficeParty]: "Office Party",
-  [BashEventType.OpenMicNight]: "Open Mic Night",
-  [BashEventType.OutdoorActivity]: "Outdoor Activity",
-  [BashEventType.Parade]: "Parade",
-  [BashEventType.Party]: "Party",
-  [BashEventType.PoolParty]: "Pool Party",
-  [BashEventType.Potluck]: "Potluck",
-  [BashEventType.PreParty]: "Pre-Party",
-  [BashEventType.ProfessionalNetworkingEvent]: "Professional Networking Event",
-  [BashEventType.PubCrawl]: "Pub Crawl",
-  [BashEventType.Rave]: "Rave",
-  [BashEventType.RetirementCelebration]: "Retirement Celebration",
-  [BashEventType.Reunion]: "Reunion",
-  [BashEventType.SchoolEvent]: "School Event",
-  [BashEventType.SocialClubEvent]: "Social Club Event",
-  [BashEventType.SportsWatchParty]: "Sports Watch Party",
-  [BashEventType.ThanksgivingDinner]: "Thanksgiving Dinner",
-  [BashEventType.ThemedDinnerParty]: "Themed Dinner Party",
-  [BashEventType.ThemedParty]: "Themed Party",
-  [BashEventType.ThemedPubCrawl]: "Themed Pub Crawl",
-  [BashEventType.Tournament]: "Tournament",
-  [BashEventType.TradeShow]: "Trade Show",
-  [BashEventType.TriviaNight]: "Trivia Night",
-  [BashEventType.ValentinesDayParty]: "Valentine's Day Party",
-  [BashEventType.WeddingReception]: "Wedding Reception",
-  [BashEventType.WelcomeHomeParty]: "Welcome Home Party",
-  [BashEventType.WineTastingEvent]: "Wine Tasting Event",
-  [BashEventType.Workshop]: "Workshop",
-  [BashEventType.Other]: "Other",
+  AfterParty: "After-Party",
+  AnniversaryCelebration: "Anniversary Celebration",
+  ArtAndCraftNight: "Art and Craft Night",
+  ArtExhibitOpening: "Art Exhibit Opening",
+  BBQCookout: "BBQ Cookout",
+  BabyShower: "Baby Shower",
+  BachelorParty: "Bachelor Party",
+  BacheloretteParty: "Bachelorette Party",
+  BeachParty: "Beach Party",
+  Birthday: "Birthday",
+  BoatParty: "Boat Party",
+  Bonfire: "Bonfire",
+  BridalShower: "Bridal Shower",
+  BrunchGathering: "Brunch Gathering",
+  CarShow: "Car Show",
+  Carnival: "Carnival",
+  CasinoNight: "Casino Night",
+  CasualMixer: "Casual Mixer",
+  CharityGala: "Charity Gala",
+  ChristmasParty: "Christmas Party",
+  ChurchEvent: "Church Event",
+  CitySponsored: "City-Sponsored Event",
+  CocktailParty: "Cocktail Party",
+  CollegeParty: "College Party",
+  ComedyShow: "Comedy Show",
+  Concert: "Concert",
+  Conference: "Conference",
+  Convention: "Convention",
+  CorporateEvent: "Corporate Event",
+  Cruise: "Cruise",
+  DanceParty: "Dance Party",
+  DiscoNight: "Disco Night",
+  EasterGathering: "Easter Gathering",
+  EngagementParty: "Engagement Party",
+  Fair: "Fair",
+  FarewellParty: "Farewell Party",
+  FashionShow: "Fashion Show",
+  Festival: "Festival",
+  FestivalFilm: "Film Festival",
+  FestivalFood: "Food Festival",
+  Fundraiser: "Fundraiser",
+  GameNight: "Game Night",
+  GamingEvent: "Gaming Event",
+  GardenParty: "Garden Party",
+  GraduationParty: "Graduation Party",
+  HalloweenParty: "Halloween Party",
+  HanukkahParty: "Hanukkah Party",
+  HolidayParty: "Holiday Party",
+  HouseParty: "House Party",
+  HousewarmingParty: "Housewarming Party",
+  KaraokeNight: "Karaoke Night",
+  LaunchParty: "Launch Party",
+  LuxuryRetreat: "Luxury Retreat",
+  MansionParty: "Mansion Party",
+  MardiGras: "Mardi Gras",
+  Memorial: "Memorial",
+  MovieNight: "Movie Night",
+  MoviePremiere: "Movie Premiere",
+  MusicFestival: "Music Festival",
+  NewYearsEveCelebration: "New Year's Eve Celebration",
+  OfficeParty: "Office Party",
+  OpenMicNight: "Open Mic Night",
+  OutdoorActivity: "Outdoor Activity",
+  Parade: "Parade",
+  Party: "Party",
+  PoolParty: "Pool Party",
+  Potluck: "Potluck",
+  PreParty: "Pre-Party",
+  ProfessionalNetworkingEvent: "Professional Networking Event",
+  PubCrawl: "Pub Crawl",
+  Rave: "Rave",
+  RetirementCelebration: "Retirement Celebration",
+  Reunion: "Reunion",
+  SchoolEvent: "School Event",
+  SocialClubEvent: "Social Club Event",
+  SportsWatchParty: "Sports Watch Party",
+  ThanksgivingDinner: "Thanksgiving Dinner",
+  ThemedDinnerParty: "Themed Dinner Party",
+  ThemedParty: "Themed Party",
+  ThemedPubCrawl: "Themed Pub Crawl",
+  Tournament: "Tournament",
+  TradeShow: "Trade Show",
+  TriviaNight: "Trivia Night",
+  ValentinesDayParty: "Valentine's Day Party",
+  WeddingReception: "Wedding Reception",
+  WelcomeHomeParty: "Welcome Home Party",
+  WineTastingEvent: "Wine Tasting Event",
+  Workshop: "Workshop",
+  Other: "Other",
 };
 
 /**
@@ -1751,47 +1861,47 @@ export type DietaryOptionToStringType = {
   [key in DietaryOption]: string;
 };
 export const DietaryOptionToString: DietaryOptionToStringType = {
-  [DietaryOption.GlutenFreeOptions]: "Gluten-Free Options Available",
-  [DietaryOption.VeganOptions]: "Vegan Options Available",
-  [DietaryOption.VegetarianOptions]: "Vegetarian Options Available",
-  [DietaryOption.DairyFreeOptions]: "Dairy-Free Options Available",
-  [DietaryOption.NutFreeOptions]: "Nut-Free Options Available",
-  [DietaryOption.HalalOptions]: "Halal Options Available",
-  [DietaryOption.KosherOptions]: "Kosher Options Available",
-  [DietaryOption.SugarFreeOptions]: "Low-Sugar / Sugar-Free Options Available",
-  [DietaryOption.KetoOptions]: "Keto-Friendly Options Available",
-  [DietaryOption.PaleoOptions]: "Paleo-Friendly Options Available",
-  [DietaryOption.AlcoholFreeOptions]: "Non-Alcoholic Options Available",
+  GlutenFreeOptions: "Gluten-Free Options Available",
+  VeganOptions: "Vegan Options Available",
+  VegetarianOptions: "Vegetarian Options Available",
+  DairyFreeOptions: "Dairy-Free Options Available",
+  NutFreeOptions: "Nut-Free Options Available",
+  HalalOptions: "Halal Options Available",
+  KosherOptions: "Kosher Options Available",
+  SugarFreeOptions: "Low-Sugar / Sugar-Free Options Available",
+  KetoOptions: "Keto-Friendly Options Available",
+  PaleoOptions: "Paleo-Friendly Options Available",
+  AlcoholFreeOptions: "Non-Alcoholic Options Available",
 };
 
 /** Short chip labels used in tight UI spots (filter modal, card pills). */
 export const DietaryOptionShortLabel: DietaryOptionToStringType = {
-  [DietaryOption.GlutenFreeOptions]: "Gluten-Free",
-  [DietaryOption.VeganOptions]: "Vegan",
-  [DietaryOption.VegetarianOptions]: "Vegetarian",
-  [DietaryOption.DairyFreeOptions]: "Dairy-Free",
-  [DietaryOption.NutFreeOptions]: "Nut-Free",
-  [DietaryOption.HalalOptions]: "Halal",
-  [DietaryOption.KosherOptions]: "Kosher",
-  [DietaryOption.SugarFreeOptions]: "Sugar-Free",
-  [DietaryOption.KetoOptions]: "Keto",
-  [DietaryOption.PaleoOptions]: "Paleo",
-  [DietaryOption.AlcoholFreeOptions]: "Non-Alcoholic",
+  GlutenFreeOptions: "Gluten-Free",
+  VeganOptions: "Vegan",
+  VegetarianOptions: "Vegetarian",
+  DairyFreeOptions: "Dairy-Free",
+  NutFreeOptions: "Nut-Free",
+  HalalOptions: "Halal",
+  KosherOptions: "Kosher",
+  SugarFreeOptions: "Sugar-Free",
+  KetoOptions: "Keto",
+  PaleoOptions: "Paleo",
+  AlcoholFreeOptions: "Non-Alcoholic",
 };
 
 /** All `DietaryOption` enum values in display order (for rendering checkboxes/tags). */
 export const DIETARY_OPTION_VALUES: ReadonlyArray<DietaryOption> = [
-  DietaryOption.GlutenFreeOptions,
-  DietaryOption.VeganOptions,
-  DietaryOption.VegetarianOptions,
-  DietaryOption.DairyFreeOptions,
-  DietaryOption.NutFreeOptions,
-  DietaryOption.HalalOptions,
-  DietaryOption.KosherOptions,
-  DietaryOption.SugarFreeOptions,
-  DietaryOption.KetoOptions,
-  DietaryOption.PaleoOptions,
-  DietaryOption.AlcoholFreeOptions,
+  "GlutenFreeOptions",
+  "VeganOptions",
+  "VegetarianOptions",
+  "DairyFreeOptions",
+  "NutFreeOptions",
+  "HalalOptions",
+  "KosherOptions",
+  "SugarFreeOptions",
+  "KetoOptions",
+  "PaleoOptions",
+  "AlcoholFreeOptions",
 ];
 
 /** Display labels for `IncomeRange` (wizard primary/secondary chips). */
@@ -1799,29 +1909,28 @@ export type IncomeRangeToStringType = {
   [key in IncomeRange]: string;
 };
 export const IncomeRangeLabel: IncomeRangeToStringType = {
-  [IncomeRange.NoPreference]: "Anyone",
-  [IncomeRange.Under40k]: "Under $40k",
-  [IncomeRange.From40to80k]: "$40k – $80k",
-  [IncomeRange.From80to150k]: "$80k – $150k",
-  [IncomeRange.From150to200k]: "$150k – $200k",
-  [IncomeRange.From200to500k]:
-    "$200k – $500k (common accredited-income band)",
-  [IncomeRange.From500kTo1M]: "$500k – $1M",
-  [IncomeRange.Over1M]: "$1M+",
-  [IncomeRange.PreferNotToSay]: "Prefer not to say",
+  NoPreference: "Anyone",
+  Under40k: "Under $40k",
+  From40to80k: "$40k – $80k",
+  From80to150k: "$80k – $150k",
+  From150to200k: "$150k – $200k",
+  From200to500k: "$200k – $500k (common accredited-income band)",
+  From500kTo1M: "$500k – $1M",
+  Over1M: "$1M+",
+  PreferNotToSay: "Prefer not to say",
 };
 
 /** Short labels for filter modal / tight chips. */
 export const IncomeRangeShortLabel: IncomeRangeToStringType = {
-  [IncomeRange.NoPreference]: "Any income",
-  [IncomeRange.Under40k]: "<$40k",
-  [IncomeRange.From40to80k]: "$40–80k",
-  [IncomeRange.From80to150k]: "$80–150k",
-  [IncomeRange.From150to200k]: "$150–200k",
-  [IncomeRange.From200to500k]: "$200–500k",
-  [IncomeRange.From500kTo1M]: "$500k–$1M",
-  [IncomeRange.Over1M]: "$1M+",
-  [IncomeRange.PreferNotToSay]: "No answer",
+  NoPreference: "Any income",
+  Under40k: "<$40k",
+  From40to80k: "$40–80k",
+  From80to150k: "$80–150k",
+  From150to200k: "$150–200k",
+  From200to500k: "$200–500k",
+  From500kTo1M: "$500k–$1M",
+  Over1M: "$1M+",
+  PreferNotToSay: "No answer",
 };
 
 /**
@@ -1829,15 +1938,15 @@ export const IncomeRangeShortLabel: IncomeRangeToStringType = {
  * Audience-targeting only — never use to gate ticket purchase or entry.
  */
 export const INCOME_RANGE_VALUES: ReadonlyArray<IncomeRange> = [
-  IncomeRange.Under40k,
-  IncomeRange.From40to80k,
-  IncomeRange.From80to150k,
-  IncomeRange.From150to200k,
-  IncomeRange.From200to500k,
-  IncomeRange.From500kTo1M,
-  IncomeRange.Over1M,
-  IncomeRange.PreferNotToSay,
-  IncomeRange.NoPreference,
+  "Under40k",
+  "From40to80k",
+  "From80to150k",
+  "From150to200k",
+  "From200to500k",
+  "From500kTo1M",
+  "Over1M",
+  "PreferNotToSay",
+  "NoPreference",
 ];
 
 /** Homepage / discovery section labels for synthetic rows (not `BashEventType` enum values). */

package/src/eventStaffRoles.ts

@@ -0,0 +1,168 @@
+/**
+ * Per-event staff role templates. Booleans on AssociatedBash stay the live
+ * write-through so existing canUserEditBashEvent / userCanAccessDoor callers
+ * keep working during the transition.
+ */
+
+export const EVENT_STAFF_ROLES = [
+  "Admin",
+  "Organizer",
+  "Promoter",
+  "DoorStaff",
+  "ServiceProvider",
+  "Volunteer",
+] as const;
+
+export type EventStaffRole = (typeof EVENT_STAFF_ROLES)[number];
+
+export type EventStaffPermissionKey =
+  | "canEditEvent"
+  | "canEditTickets"
+  | "canManageAttendees"
+  | "canIssueComps"
+  | "canAccessDoor"
+  | "canViewFinances"
+  | "canRefund"
+  | "canMessage"
+  | "canManageTrackingLinks";
+
+export type EventStaffPermissionFlags = Record<EventStaffPermissionKey, boolean>;
+
+export type EventStaffBooleanWriteThrough = {
+  isOrganizer: boolean;
+  isDoorStaff: boolean;
+  isCoHost: boolean;
+};
+
+export const EVENT_STAFF_TEMPLATE_DEFAULTS: Record<EventStaffRole, EventStaffPermissionFlags> = {
+  Admin: {
+    canEditEvent: true,
+    canEditTickets: true,
+    canManageAttendees: true,
+    canIssueComps: true,
+    canAccessDoor: true,
+    canViewFinances: true,
+    canRefund: true,
+    canMessage: true,
+    canManageTrackingLinks: true,
+  },
+  Organizer: {
+    canEditEvent: true,
+    canEditTickets: true,
+    canManageAttendees: true,
+    canIssueComps: true,
+    canAccessDoor: true,
+    canViewFinances: false,
+    canRefund: false,
+    canMessage: true,
+    canManageTrackingLinks: true,
+  },
+  Promoter: {
+    canEditEvent: false,
+    canEditTickets: false,
+    canManageAttendees: false,
+    canIssueComps: true,
+    canAccessDoor: false,
+    canViewFinances: false,
+    canRefund: false,
+    canMessage: false,
+    canManageTrackingLinks: true,
+  },
+  DoorStaff: {
+    canEditEvent: false,
+    canEditTickets: false,
+    canManageAttendees: true,
+    canIssueComps: true,
+    canAccessDoor: true,
+    canViewFinances: false,
+    canRefund: false,
+    canMessage: false,
+    canManageTrackingLinks: false,
+  },
+  ServiceProvider: {
+    canEditEvent: false,
+    canEditTickets: false,
+    canManageAttendees: false,
+    canIssueComps: false,
+    canAccessDoor: false,
+    canViewFinances: false,
+    canRefund: false,
+    canMessage: false,
+    canManageTrackingLinks: false,
+  },
+  Volunteer: {
+    canEditEvent: false,
+    canEditTickets: false,
+    canManageAttendees: false,
+    canIssueComps: false,
+    canAccessDoor: false,
+    canViewFinances: false,
+    canRefund: false,
+    canMessage: false,
+    canManageTrackingLinks: false,
+  },
+};
+
+export function isEventStaffRole(value: string | null | undefined): value is EventStaffRole {
+  return !!value && (EVENT_STAFF_ROLES as readonly string[]).includes(value);
+}
+
+/** Setting a role also writes the legacy booleans so existing callers stay valid. */
+export function writeThroughAssociatedBashFlags(
+  role: EventStaffRole,
+  isCoHost = false
+): EventStaffBooleanWriteThrough {
+  if (role === "Admin" || role === "Organizer") {
+    return { isOrganizer: true, isDoorStaff: false, isCoHost };
+  }
+  if (role === "DoorStaff") {
+    return { isOrganizer: false, isDoorStaff: true, isCoHost: false };
+  }
+  return { isOrganizer: false, isDoorStaff: false, isCoHost: false };
+}
+
+export function resolveEventStaffPermission(
+  role: EventStaffRole | null | undefined,
+  key: EventStaffPermissionKey,
+  override: boolean | null | undefined
+): boolean {
+  if (typeof override === "boolean") return override;
+  if (!isEventStaffRole(role)) return false;
+  return EVENT_STAFF_TEMPLATE_DEFAULTS[role][key];
+}
+
+/**
+ * Edit access: honor role+overrides when eventRole is set; otherwise the
+ * existing isOrganizer boolean. Never drop the boolean check for legacy rows.
+ */
+export function associatedBashCanEditEvent(row: {
+  eventRole?: string | null;
+  isOrganizer?: boolean | null;
+  canEditEvent?: boolean | null;
+}): boolean {
+  if (isEventStaffRole(row.eventRole)) {
+    return resolveEventStaffPermission(row.eventRole, "canEditEvent", row.canEditEvent);
+  }
+  return !!row.isOrganizer;
+}
+
+export function associatedBashCanAccessDoor(row: {
+  eventRole?: string | null;
+  isOrganizer?: boolean | null;
+  isDoorStaff?: boolean | null;
+  canAccessDoor?: boolean | null;
+}): boolean {
+  if (isEventStaffRole(row.eventRole)) {
+    return resolveEventStaffPermission(row.eventRole, "canAccessDoor", row.canAccessDoor);
+  }
+  return Boolean(row.isOrganizer || row.isDoorStaff);
+}
+
+export function roleFromLegacyFlags(row: {
+  isOrganizer?: boolean | null;
+  isDoorStaff?: boolean | null;
+}): EventStaffRole | null {
+  if (row.isDoorStaff && !row.isOrganizer) return "DoorStaff";
+  if (row.isOrganizer) return "Organizer";
+  return null;
+}