@bash-app/bash-common 30.386.0 → 30.393.0

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/extendedSchemas.ts

@@ -1054,6 +1054,14 @@ export const SERVICE_PUBLIC_LIST_DATA_TO_INCLUDE = {
       eventServiceSubType: true,
       formatOptions: true,
       crowdSize: true,
+      // F&B per-guest pricing & logistics fields
+      pricingModel: true,
+      baseRateCents: true,
+      minimumQuantity: true,
+      minimumChargeCents: true,
+      goodsOrServices: true,
+      fulfillmentModes: true,
+      leadTimeDays: true,
     },
   },
   entertainmentService: {

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";
@@ -36,6 +42,7 @@ export * from "./accessScreening.js";
 export * from "./applicationFunnel.js";
 export * from "./hostCrmSegments.js";
 export * from "./hostCrmCrowdPulse.js";
+export * from "./scenePulse.js";
 export * from "./hostCrmLastBashProof.js";
 export * from "./hostCrmInsights.js";
 export * from "./hostCrmAutomation.js";
@@ -55,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,
@@ -107,13 +119,13 @@ export {
   BrandStrategistFormat,
   CPAsFormat,
   CateringFormat,
+  CelebrationCakeFormat,
+  GrazingTableFormat,
   CelebrityAppearanceFormat,
   CenterpiecesFormat,
   ChairsFormat,
   ClaimRequestStatus,
   CleaningSubType,
-  ClubAdminRole,
-  ClubMemberStatus,
   ConnectionStatus,
   ConsentType,
   ConsultantFormat,
@@ -189,6 +201,7 @@ export {
   NotificationPriority,
   NotificationType,
   Occupation,
+  OfficiantFormat,
   OfferClaimStatus,
   OfferDiscountType,
   OrganizationArtistInvitationStatus,
@@ -225,6 +238,7 @@ export {
   RecurringFrequency,
   RedemptionMethod,
   RentalEquipmentSubType,
+  RestroomTrailerFormat,
   ReportStatus,
   ReportingFormat,
   RewardReportStatus,
@@ -429,6 +443,7 @@ export * from "./utils/mathUtils.js";
 export * from "./utils/birthdayExperienceQuality.js";
 export * from "./utils/service/apiServiceBookingApiUtils.js";
 export * from "./utils/service/frontendServiceBookingUtils.js";
+export * from "./utils/service/foodAndBeverageQuote.js";
 export * from "./utils/service/serviceBookingStatusUtils.js";
 export * from "./utils/service/serviceDBUtils.js";
 export * from "./utils/service/serviceRateUtils.js";

package/src/scenePulse.ts

@@ -0,0 +1,113 @@
+/**
+ * Community Builder scene pulse — city / region / world aggregates.
+ * You (Crowd Pulse) stays host ops; these scopes are public scene energy + platform proof.
+ */
+
+export const SCENE_PULSE_SCOPES = ["city", "region", "world"] as const;
+
+export type ScenePulseScope = (typeof SCENE_PULSE_SCOPES)[number];
+
+export type ScenePulseGeo = {
+  city: string | null;
+  state: string | null;
+  country: string | null;
+  /** Short label for copy ("Salt Lake City", "Utah", "World"). */
+  label: string;
+  timeZone: string;
+};
+
+export type ScenePulseEnergy = {
+  /** Public rooms currently live. */
+  liveNow: number;
+  /** Unique Going RSVPs + ticketed people on live + tonight + this weekend. */
+  going: number;
+  tonightBashes: number;
+  tonightGoing: number;
+  weekendBashes: number;
+  weekendGoing: number;
+  /** Unique people who RSVP'd Going or paid for a ticket in the last 7 days. */
+  newThisWeek: number;
+  /**
+   * Distinct live/tonight/weekend public bashes with a lineup slot or a
+   * host-spotlighted featured guest (names in the room — not CRM).
+   */
+  namesInTheRoom: number;
+};
+
+/** World-only cumulative credibility. Null on city/region. */
+export type ScenePulseWorldCred = {
+  totalPeople: number;
+  bashesHosted: number;
+  ticketsSold: number;
+  gmvCents: number;
+  citiesRepresented: number;
+  regionsRepresented: number;
+};
+
+export type ScenePulse = {
+  scope: ScenePulseScope;
+  geo: ScenePulseGeo | null;
+  /** True when city (or region) can't be resolved from profile or hosted bashes. */
+  needsLocation: boolean;
+  energy: ScenePulseEnergy;
+  world: ScenePulseWorldCred | null;
+};
+
+/** Optional city/state used to pulse a scene other than the host's profile. */
+export type ScenePulseGeoOverride = {
+  city: string | null;
+  state: string | null;
+};
+
+const MAX_GEO_CITY_CHARS = 80;
+const MAX_GEO_STATE_CHARS = 40;
+
+function normalizeGeoPart(raw: unknown, maxChars: number): string | null {
+  if (typeof raw !== "string") return null;
+  const trimmed = raw.replace(/\s+/g, " ").trim();
+  if (!trimmed) return null;
+  return trimmed.slice(0, maxChars);
+}
+
+/**
+ * Blank city+state → null (use profile). Otherwise a trimmed override.
+ */
+export function normalizeScenePulseGeoOverride(input: {
+  city?: unknown;
+  state?: unknown;
+}): ScenePulseGeoOverride | null {
+  const city = normalizeGeoPart(input.city, MAX_GEO_CITY_CHARS);
+  const state = normalizeGeoPart(input.state, MAX_GEO_STATE_CHARS);
+  if (!city && !state) return null;
+  return { city, state };
+}
+
+export function emptyScenePulseEnergy(): ScenePulseEnergy {
+  return {
+    liveNow: 0,
+    going: 0,
+    tonightBashes: 0,
+    tonightGoing: 0,
+    weekendBashes: 0,
+    weekendGoing: 0,
+    newThisWeek: 0,
+    namesInTheRoom: 0,
+  };
+}
+
+/**
+ * Missing / blank → city. Invalid string → null (caller should 400).
+ */
+export function parseScenePulseScope(raw: unknown): ScenePulseScope | null {
+  if (raw == null || raw === "") return "city";
+  if (typeof raw !== "string") return null;
+  const normalized = raw.trim().toLowerCase();
+  if (
+    normalized === "city" ||
+    normalized === "region" ||
+    normalized === "world"
+  ) {
+    return normalized;
+  }
+  return null;
+}

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";
+}

package/src/suggestionScore.ts

@@ -0,0 +1,140 @@
+import { DiscoveryScope, isNationalOrInternational } from "./discoveryScope.js";
+import { UserTasteKind, UserTasteSource } from "./userTaste.js";
+
+export type SuggestionTasteRow = {
+  kind: string;
+  value: string;
+  weight: number;
+  source: string;
+};
+
+export type SuggestionSignals = {
+  connectionsGoingVisible: number;
+  connectionsGoingHidden: number;
+  followedHost: boolean;
+  attendedHost: boolean;
+  eventType: string;
+  causeTags: readonly string[];
+  musicGenre?: string | null;
+  discoveryScope: string;
+  artistsToSee: readonly string[];
+  eventTitle: string;
+  distanceMiles: number | null;
+  radiusMiles: number;
+  isFeatured: boolean;
+  trendingScore: number;
+  paidFeatureTasteOverlap: boolean;
+  tastes: readonly SuggestionTasteRow[];
+};
+
+export const SUGGESTION_WEIGHTS = {
+  connectionsGoing: 40,
+  followedHost: 24,
+  attendedHost: 20,
+  explicitTaste: 16,
+  explicitTasteLove: 32,
+  inferredTaste: 8,
+  travelScope: 10,
+  featured: 3,
+  trending: 2,
+  paidFeatureTaste: 1,
+  artistsToSee: 4,
+} as const;
+
+export const PAID_FEATURE_TASTE_CAP = SUGGESTION_WEIGHTS.paidFeatureTaste;
+
+export function scoreSuggestion(signals: SuggestionSignals): number {
+  let score = 0;
+  if (signals.connectionsGoingVisible + signals.connectionsGoingHidden > 0) {
+    score += SUGGESTION_WEIGHTS.connectionsGoing;
+  }
+  if (signals.followedHost) score += SUGGESTION_WEIGHTS.followedHost;
+  if (signals.attendedHost) score += SUGGESTION_WEIGHTS.attendedHost;
+
+  for (const taste of signals.tastes) {
+    if (taste.weight < 0) {
+      if (tasteMatchesEvent(taste, signals)) return Number.NEGATIVE_INFINITY;
+      continue;
+    }
+    if (!tasteMatchesEvent(taste, signals)) continue;
+    if (taste.kind === UserTasteKind.DiscoveryScope) {
+      score += SUGGESTION_WEIGHTS.travelScope;
+      continue;
+    }
+    if (taste.source === UserTasteSource.Explicit) {
+      score +=
+        taste.weight === 2
+          ? SUGGESTION_WEIGHTS.explicitTasteLove
+          : SUGGESTION_WEIGHTS.explicitTaste;
+    } else {
+      score += SUGGESTION_WEIGHTS.inferredTaste;
+    }
+  }
+
+  if (signals.isFeatured) score += SUGGESTION_WEIGHTS.featured;
+  if (signals.trendingScore > 0) score += SUGGESTION_WEIGHTS.trending;
+  if (signals.paidFeatureTasteOverlap) {
+    score += PAID_FEATURE_TASTE_CAP;
+  }
+  if (
+    signals.artistsToSee.some((a) =>
+      signals.eventTitle.toLowerCase().includes(a.toLowerCase())
+    )
+  ) {
+    score += SUGGESTION_WEIGHTS.artistsToSee;
+  }
+
+  const withinRadius = isWithinDiscoveryRadius(signals);
+  if (!withinRadius) return Number.NEGATIVE_INFINITY;
+
+  if (signals.distanceMiles != null && signals.radiusMiles > 0) {
+    const decay = Math.min(1, signals.distanceMiles / signals.radiusMiles);
+    score -= decay * 4;
+  }
+
+  return score;
+}
+
+export function isWithinDiscoveryRadius(signals: SuggestionSignals): boolean {
+  const travel = signals.tastes.some(
+    (t) =>
+      t.kind === UserTasteKind.DiscoveryScope &&
+      isNationalOrInternational(t.value as DiscoveryScope) &&
+      t.weight > 0
+  );
+  if (
+    travel &&
+    isNationalOrInternational(signals.discoveryScope as DiscoveryScope)
+  ) {
+    return true;
+  }
+  if (signals.distanceMiles == null) return true;
+  return signals.distanceMiles <= signals.radiusMiles;
+}
+
+function tasteMatchesEvent(
+  taste: SuggestionTasteRow,
+  signals: SuggestionSignals
+): boolean {
+  switch (taste.kind) {
+    case UserTasteKind.EventType:
+      return signals.eventType === taste.value;
+    case UserTasteKind.CauseTag:
+      return signals.causeTags.includes(taste.value);
+    case UserTasteKind.MusicGenre:
+      return (signals.musicGenre ?? "") === taste.value;
+    case UserTasteKind.DiscoveryScope:
+      return signals.discoveryScope === taste.value;
+    default:
+      return false;
+  }
+}
+
+export function crewOutranksPaid(signals: SuggestionSignals): boolean {
+  const crew =
+    signals.connectionsGoingVisible +
+    signals.connectionsGoingHidden +
+    (signals.followedHost ? 1 : 0) +
+    (signals.attendedHost ? 1 : 0);
+  return crew > 0;
+}