@bash-app/bash-common 30.314.0 → 30.318.0

package/src/hostCrmAutomation.ts

@@ -0,0 +1,138 @@
+import type {
+  HostCrmAutomationAudienceType as HostCrmAutomationAudienceTypeEnum,
+  HostCrmAutomationChannel as HostCrmAutomationChannelEnum,
+  HostCrmAutomationTrigger as HostCrmAutomationTriggerEnum,
+} from "@prisma/client";
+
+/** Mirrors Prisma `HostCrmAutomationTrigger` — `@prisma/client` browser bundle omits runtime enum exports. */
+export const HostCrmAutomationTrigger = {
+  Recurring: "Recurring",
+  NewlyAtRisk: "NewlyAtRisk",
+  PostEvent: "PostEvent",
+} as const satisfies Record<HostCrmAutomationTriggerEnum, HostCrmAutomationTriggerEnum>;
+
+export type HostCrmAutomationTrigger = HostCrmAutomationTriggerEnum;
+
+/** Mirrors Prisma `HostCrmAutomationChannel` — `@prisma/client` browser bundle omits runtime enum exports. */
+export const HostCrmAutomationChannel = {
+  Email: "Email",
+  Sms: "Sms",
+} as const satisfies Record<HostCrmAutomationChannelEnum, HostCrmAutomationChannelEnum>;
+
+export type HostCrmAutomationChannel = HostCrmAutomationChannelEnum;
+
+/** Mirrors Prisma `HostCrmAutomationAudienceType` — `@prisma/client` browser bundle omits runtime enum exports. */
+export const HostCrmAutomationAudienceType = {
+  Preset: "Preset",
+  Segment: "Segment",
+} as const satisfies Record<
+  HostCrmAutomationAudienceTypeEnum,
+  HostCrmAutomationAudienceTypeEnum
+>;
+
+export type HostCrmAutomationAudienceType = HostCrmAutomationAudienceTypeEnum;
+
+/** Minimum days between two runs of a Recurring automation. */
+export const HOST_CRM_AUTOMATION_MIN_CADENCE_DAYS = 1;
+/** Default cadence for a newly created Recurring automation, matching the legacy win-back cron interval. */
+export const HOST_CRM_AUTOMATION_DEFAULT_CADENCE_DAYS = 30;
+
+/**
+ * API/client shape of a `HostCrmAutomation` row — dates are ISO strings (as
+ * returned by the JSON API), not the raw Prisma `Date` type. See
+ * `api/src/api/user/privateUser/hostCrmAutomationApi.ts` for the endpoints
+ * that produce this shape and `bash-app/src/dataLayer/user/attendeeAudienceFetcher.ts`
+ * for the client fetchers.
+ */
+export type HostCrmAutomation = {
+  id: string;
+  hostUserId: string;
+  name: string;
+  trigger: HostCrmAutomationTrigger;
+  channel: HostCrmAutomationChannel;
+  /** Ignored for PostEvent — audience there is implicit (that event's ticket holders). */
+  audienceType: HostCrmAutomationAudienceType | null;
+  audiencePresetId: string | null;
+  audienceSegmentId: string | null;
+  subject: string | null;
+  body: string;
+  /** Only used by the Recurring trigger. */
+  cadenceDays: number | null;
+  enabled: boolean;
+  lastRunAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+
+/** Payload for creating or fully updating a `HostCrmAutomation`. */
+export type HostCrmAutomationInput = {
+  name: string;
+  trigger: HostCrmAutomationTrigger;
+  channel: HostCrmAutomationChannel;
+  audienceType?: HostCrmAutomationAudienceType | null;
+  audiencePresetId?: string | null;
+  audienceSegmentId?: string | null;
+  subject?: string | null;
+  body: string;
+  cadenceDays?: number | null;
+  enabled?: boolean;
+};
+
+/**
+ * "Growth pack" — the one-click Host CRM automation pair (win-back + post-event
+ * thank-you). Specs live here so API enable, legacy backfill, and UI detection
+ * cannot drift apart.
+ */
+export const HOST_CRM_GROWTH_PACK_WINBACK_PRESET_ID = "lapsed_180";
+export const HOST_CRM_GROWTH_PACK_WINBACK_NAME = "Win-back email";
+export const HOST_CRM_GROWTH_PACK_POST_EVENT_NAME = "Post-event thank-you";
+
+/** Shared with the live win-back blast defaults — keep in lockstep. */
+export const HOST_CRM_WINBACK_DEFAULT_SUBJECT =
+  "We miss you — come back out with us";
+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}}. */
+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}}";
+
+type GrowthPackAutomationShape = {
+  trigger: string;
+  channel: string;
+  audiencePresetId?: string | null;
+};
+
+/** True when a Recurring Email + lapsed_180 win-back automation already exists. */
+export function hostCrmHasWinBackPackAutomation(
+  automations: GrowthPackAutomationShape[]
+): boolean {
+  return automations.some(
+    (a) =>
+      a.trigger === HostCrmAutomationTrigger.Recurring &&
+      a.channel === HostCrmAutomationChannel.Email &&
+      a.audiencePresetId === HOST_CRM_GROWTH_PACK_WINBACK_PRESET_ID
+  );
+}
+
+/** True when a PostEvent Email thank-you automation already exists. */
+export function hostCrmHasPostEventPackAutomation(
+  automations: GrowthPackAutomationShape[]
+): boolean {
+  return automations.some(
+    (a) =>
+      a.trigger === HostCrmAutomationTrigger.PostEvent &&
+      a.channel === HostCrmAutomationChannel.Email
+  );
+}
+
+export function hostCrmGrowthPackIsComplete(
+  automations: GrowthPackAutomationShape[]
+): boolean {
+  return (
+    hostCrmHasWinBackPackAutomation(automations) &&
+    hostCrmHasPostEventPackAutomation(automations)
+  );
+}

package/src/hostCrmInsights.ts

@@ -0,0 +1,39 @@
+import type { MembershipTier } from "./membershipDefinitions.js";
+
+/**
+ * One curated predictive-insight observation for the Attendee CRM's
+ * Recommended-actions accordion. Deliberately a discriminated union of
+ * discrete, computed facts (not prose) — same design choice already made for
+ * `HostCrmTimelineEntry` — so the drawer/card renders each fact directly and
+ * a future AI layer can consume the same structured data without re-deriving it.
+ */
+export type HostCrmInsight =
+  | {
+      type: "MostLikelyToReturn";
+      nextEventTitle: string;
+      nextEventStartsAt: string;
+      attendeeCount: number;
+    }
+  | {
+      type: "AttendanceTrend";
+      direction: "up" | "down" | "flat";
+      percent: number;
+      recentCount: number;
+      priorCount: number;
+    }
+  | {
+      type: "DayOfWeekRetention";
+      bestDay: string;
+      worstDay: string;
+      bestRepeatRate: number;
+      worstRepeatRate: number;
+    };
+
+/**
+ * Response shape for the Predictive Insights card. Gated server-side —
+ * `locked: true` hosts never receive computed `insights`, so a Basic-tier
+ * host can't see real data even by inspecting the network response.
+ */
+export type HostCrmInsightsResult =
+  | { locked: true; requiredTier: MembershipTier }
+  | { locked: false; insights: HostCrmInsight[] };

package/src/hostCrmSegments.ts

@@ -1,10 +1,17 @@
 import type { SocialEventCadence } from "@prisma/client";
 
+import type {
+  RelationshipHealthResult,
+  RelationshipHealthStatus,
+} from "./relationshipHealth.js";
+
 /** Rule-based CRM segment (stored as JSON on HostCrmSavedSegment.rules). */
 export type HostCrmSegmentRules = {
   tag?: string;
   cadence?: SocialEventCadence;
   minEventCount?: number;
+  /** First-timers-style segment: attended at most this many of the host's bashes. */
+  maxEventCount?: number;
   lapsedDays?: number;
   /** Ticket buyers for this bash event id */
   sourceEventId?: string;
@@ -14,10 +21,30 @@ export type HostCrmSegmentRules = {
   tierTitle?: string;
   /** Match attendee city (case-insensitive substring) */
   city?: string;
-  /** Built-in preset id (e.g. cadence_often) when rules alone are insufficient */
+  /** Built-in preset id (e.g. top_spenders) when rules alone are insufficient */
   presetId?: string;
+  /** Relationship Health status (New/Steady/Cooling/AtRisk) */
+  healthStatus?: RelationshipHealthStatus;
+  /** Lifetime spend across host bashes, in cents */
+  minTotalSpendCents?: number;
+  /** Bought a ticket but never checked in to an ended bash */
+  noShow?: boolean;
+  /** UI label: "Uses Promo Codes" — redeemed a promo code on a host bash */
+  discountResponsive?: boolean;
+  /** UI label: "Last-Minute Buyer" — typically buys within 48h of the event */
+  fastDecider?: boolean;
+  /** UI label: "Series Regular" — attended 2+ events in the same EventSeries */
+  seriesLoyalist?: boolean;
+  /** Refunded/cancelled a ticket and hasn't been back since */
+  refundChurn?: boolean;
+  /** UI label: "Brings Friends" — buys multiple tickets per checkout or brings plus-ones */
+  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[];
 };
 
+export type HostCrmDiscoverySource = "promoter" | "referral" | "direct";
+
 export type HostCrmAudienceMember = {
   userId: string | null;
   email: string | null;
@@ -32,19 +59,41 @@ export type HostCrmAudienceMember = {
   reachableEmail: boolean;
   reachableSms: boolean;
   lastAttendedAt: string | null;
+  /** First attended bash time, used to derive this attendee's own cadence for Relationship Health. */
+  firstAttendedAt: string | null;
   city: string | null;
   tierTitles: string[];
   /** Bash event ids this person attended (for cohort / source filters) */
   sourceEventIds?: string[];
   /** True when row is email-only (guest checkout) without a linked user id */
   emailOnly: boolean;
+  /** Lifetime spend across host bashes, in cents (paidUnitPriceCents when set, else tier price). */
+  totalSpendCents: number;
+  /** Ended bashes where they bought a ticket but never checked in. */
+  noShowCount: number;
+  /** UI label: "Uses Promo Codes" */
+  discountResponsive: boolean;
+  /** UI label: "Last-Minute Buyer" — majority of purchases within 48h of the event start */
+  fastDecider: boolean;
+  /** UI label: "Series Regular" — attended 2+ events sharing an EventSeries */
+  seriesLoyalist: boolean;
+  /** Refunded/cancelled a ticket on a host bash and hasn't bought again since */
+  refundChurn: boolean;
+  /** UI label: "Brings Friends" — multi-ticket checkouts, group tiers, or RSVP plus-ones */
+  bringsGuests: boolean;
+  /** How this attendee was attributed to the host's audience, when known. */
+  discoverySource: HostCrmDiscoverySource;
+  /** This attendee's own derived cadence in days, or null when there isn't enough history to personalize it. */
+  expectedGapDays: number | null;
+  /** Predicted next-attendance date (now + expectedGapDays from lastAttendedAt), or null when unknown. */
+  nextExpectedAt: string | null;
 };
 
-export function applyHostCrmSegmentRules(
-  audience: HostCrmAudienceMember[],
+export function applyHostCrmSegmentRules<T extends HostCrmAudienceMember>(
+  audience: T[],
   rules: HostCrmSegmentRules,
   now: Date = new Date()
-): HostCrmAudienceMember[] {
+): T[] {
   let rows = audience;
 
   if (rules.tag?.trim()) {
@@ -60,6 +109,10 @@ export function applyHostCrmSegmentRules(
     rows = rows.filter((r) => r.eventCount >= rules.minEventCount!);
   }
 
+  if (typeof rules.maxEventCount === "number" && rules.maxEventCount > 0) {
+    rows = rows.filter((r) => r.eventCount <= rules.maxEventCount!);
+  }
+
   if (typeof rules.lapsedDays === "number" && rules.lapsedDays > 0) {
     const cutoff = now.getTime() - rules.lapsedDays * 24 * 60 * 60 * 1000;
     rows = rows.filter((r) => {
@@ -78,6 +131,11 @@ export function applyHostCrmSegmentRules(
     rows = rows.filter((r) => !r.sourceEventIds?.includes(excludeId));
   }
 
+  if (rules.sourceEventIdIn && rules.sourceEventIdIn.length > 0) {
+    const idSet = new Set(rules.sourceEventIdIn);
+    rows = rows.filter((r) => r.sourceEventIds?.some((id) => idSet.has(id)));
+  }
+
   if (rules.tierTitle?.trim()) {
     const tier = rules.tierTitle.trim().toLowerCase();
     rows = rows.filter((r) =>
@@ -90,6 +148,43 @@ export function applyHostCrmSegmentRules(
     rows = rows.filter((r) => (r.city ?? "").toLowerCase().includes(cityNeedle));
   }
 
+  if (typeof rules.minTotalSpendCents === "number" && rules.minTotalSpendCents > 0) {
+    rows = rows.filter((r) => r.totalSpendCents >= rules.minTotalSpendCents!);
+  }
+
+  if (rules.noShow) {
+    rows = rows.filter((r) => r.noShowCount > 0);
+  }
+
+  if (rules.discountResponsive) {
+    rows = rows.filter((r) => r.discountResponsive);
+  }
+
+  if (rules.fastDecider) {
+    rows = rows.filter((r) => r.fastDecider);
+  }
+
+  if (rules.seriesLoyalist) {
+    rows = rows.filter((r) => r.seriesLoyalist);
+  }
+
+  if (rules.refundChurn) {
+    rows = rows.filter((r) => r.refundChurn);
+  }
+
+  if (rules.bringsGuests) {
+    rows = rows.filter((r) => r.bringsGuests);
+  }
+
+  if (rules.healthStatus) {
+    rows = rows.filter((r) => {
+      const health = (
+        r as HostCrmAudienceMember & { relationshipHealth?: RelationshipHealthResult }
+      ).relationshipHealth;
+      return health?.status === rules.healthStatus;
+    });
+  }
+
   return rows;
 }
 
@@ -105,6 +200,18 @@ export const HOST_CRM_PRESET_SEGMENTS: Array<{
     description: "People who have been to at least two of your bashes",
     rules: { minEventCount: 2 },
   },
+  {
+    id: "frequent_guest",
+    label: "Frequent guest (3+ bashes)",
+    description: "People who have been to at least three of your bashes",
+    rules: { minEventCount: 3 },
+  },
+  {
+    id: "first_timers",
+    label: "First-timers",
+    description: "Came to exactly one of your bashes and haven't been back",
+    rules: { maxEventCount: 1 },
+  },
   {
     id: "lapsed_90",
     label: "Haven't been in 90 days",
@@ -118,9 +225,103 @@ export const HOST_CRM_PRESET_SEGMENTS: Array<{
     rules: { lapsedDays: 180 },
   },
   {
-    id: "cadence_often",
-    label: "Goes out often",
-    description: "Self-reported cadence: Often or Always",
+    id: "top_spenders",
+    label: "Top spenders",
+    description: "Your top quartile of attendees by lifetime spend",
+    // Computed at query time from the full audience — see filterHostCrmAudience's presetId branch.
+    rules: {},
+  },
+  {
+    id: "no_show",
+    label: "Bought, didn't check in",
+    description: "Bought a ticket to a past bash but never checked in",
+    rules: { noShow: true },
+  },
+  {
+    id: "uses_promo_codes",
+    label: "Uses promo codes",
+    description: "Has redeemed a promo code on one of your bashes",
+    rules: { discountResponsive: true },
+  },
+  {
+    id: "last_minute_buyer",
+    label: "Last-minute buyer",
+    description: "Typically buys within 48 hours of the event",
+    rules: { fastDecider: true },
+  },
+  {
+    id: "refund_churn",
+    label: "Refunded and hasn't been back",
+    description: "Refunded or cancelled a ticket and hasn't returned since",
+    rules: { refundChurn: true },
+  },
+  {
+    id: "series_regular",
+    label: "Series regular",
+    description: "Attended two or more events in the same series",
+    rules: { seriesLoyalist: true },
+  },
+  {
+    id: "brings_friends",
+    label: "Brings friends",
+    description: "Usually buys multiple tickets or brings plus-ones",
+    rules: { bringsGuests: true },
+  },
+  {
+    id: "last3Events",
+    label: "Last 3 events",
+    description: "People who came to any of your 3 most recently ended bashes",
+    // Computed at query time from the host's finished events — see filterHostCrmAudience's presetId branch.
     rules: {},
   },
 ];
+
+/**
+ * One chronological entry in an attendee's relationship timeline (detail
+ * drawer). Deliberately a discriminated union of discrete facts rather than
+ * pre-rendered prose: the drawer renders it directly, and any future
+ * AI-drafted-message feature can consume the same structured facts to build
+ * a prompt without re-deriving them (see `buildAttendeeCrmContext`).
+ */
+export type HostCrmTimelineEntryType =
+  | "TicketPurchased"
+  | "CheckedIn"
+  | "Refunded"
+  | "DiscountApplied"
+  | "EmailSent"
+  | "SmsSent"
+  | "NoteAdded"
+  | "NoteUpdated"
+  | "TagAdded"
+  | "TagRemoved";
+
+export type HostCrmTimelineEntry = {
+  type: HostCrmTimelineEntryType;
+  /** ISO timestamp. */
+  at: string;
+  /** Short human-readable detail (event title, discount code, tag name, etc.). */
+  detail?: string;
+  /** Rendering-only flag: true when a TicketPurchased entry was for a VIP-titled tier. */
+  isVip?: boolean;
+};
+
+/** Drawer-only behavioral badges, kept off the always-visible attendee row. */
+export type HostCrmAttendeeDetailBadges = {
+  fastDecider: boolean;
+  discountResponsive: boolean;
+  seriesLoyalist: boolean;
+  refundChurn: boolean;
+};
+
+/**
+ * Full detail payload for one attendee's drawer — the response shape for
+ * `GET /attendee-audience/:attendeeUserId/detail`, built by the shared
+ * `buildAttendeeCrmContext` function so a future AI compose endpoint can
+ * reuse the same assembly without refactoring this contract.
+ */
+export type HostCrmAttendeeDetail = {
+  member: HostCrmAudienceMember;
+  relationshipHealth: RelationshipHealthResult;
+  badges: HostCrmAttendeeDetailBadges;
+  timeline: HostCrmTimelineEntry[];
+};

package/src/index.ts

@@ -19,6 +19,7 @@ export * from "./storeTypes.js";
 export * from "./storePrintArtworkUtils.js";
 export * from "./bashFeedTypes.js";
 export * from "./membershipDefinitions.js";
+export * from "./appleIapProducts.js";
 export * from "./onSaleCapabilityRecommendations.js";
 export * from "./ticketBnplPaymentMethods.js";
 export * from "./aiApproval.js";
@@ -30,6 +31,9 @@ export * from "./entertainmentNotableVenues.js";
 export * from "./productLaunch.js";
 export * from "./accessScreening.js";
 export * from "./hostCrmSegments.js";
+export * from "./hostCrmInsights.js";
+export * from "./hostCrmAutomation.js";
+export * from "./relationshipHealth.js";
 export * from "./hostCrmConstants.js";
 export * from "./userReportTypes.js";
 export * from "./mirroredPrismaEnums.js";

package/src/membershipDefinitions.ts

@@ -807,6 +807,8 @@ export const MEMBERSHIP_FEATURES = {
   FEATURED_EVENTS_PAID: 'featured_events_paid',
   BETA_FEATURES: 'beta_features',
   BASIC_NOTIFICATIONS: 'basic_notifications',
+  /** Host CRM: predictive insight cards (most-likely-to-return, attendance trend, day-of-week retention). */
+  HOST_CRM_INSIGHTS: 'host_crm_insights',
   
   // Pro features
   FREE_FEATURED_EVENTS: 'free_featured_events',
@@ -850,6 +852,7 @@ export function hasFeatureAccess(userTier: MembershipTier, feature: string): boo
     case MEMBERSHIP_FEATURES.FEATURED_EVENTS_PAID:
     case MEMBERSHIP_FEATURES.BETA_FEATURES:
     case MEMBERSHIP_FEATURES.BASIC_NOTIFICATIONS:
+    case MEMBERSHIP_FEATURES.HOST_CRM_INSIGHTS:
       return tierIndex >= 1; // Creator+
       
     case MEMBERSHIP_FEATURES.FREE_FEATURED_EVENTS:

package/src/relationshipHealth.ts

@@ -0,0 +1,134 @@
+/**
+ * Per-attendee Relationship Health — one deterministic, inspectable signal for
+ * the Attendee CRM, replacing the narrower "lapsed VIP alert" idea with a
+ * status every attendee gets. Deliberately rule-based (not LLM-guessed) so a
+ * host can see exactly why a status fired via `reasons`.
+ */
+
+export type RelationshipHealthStatus = "New" | "Steady" | "Cooling" | "AtRisk";
+
+export const RELATIONSHIP_HEALTH_LABELS: Record<RelationshipHealthStatus, string> = {
+  New: "New",
+  Steady: "Steady",
+  Cooling: "Cooling",
+  AtRisk: "At risk",
+};
+
+export type RelationshipHealthInputs = {
+  eventCount: number;
+  /** ISO date of the most recent attended bash, if any. */
+  lastAttendedAt: string | null;
+  /** ISO date of the first attended bash, if any (used to derive this attendee's own cadence). */
+  firstAttendedAt: string | null;
+  tags: string[];
+  /** ISO date of the most recent host outreach (CRM email/SMS) to this attendee, if any. Display-only input — does not change the bucket. */
+  lastOutreachAt: string | null;
+};
+
+export type RelationshipHealthResult = {
+  status: RelationshipHealthStatus;
+  /** Ordered, human-readable trace of the exact signals behind this status — shown on hover/click, never hidden. */
+  reasons: string[];
+  daysSinceLastAttended: number | null;
+  /** This attendee's own derived cadence in days, or null when there isn't enough history to personalize it. */
+  expectedGapDays: number | null;
+};
+
+const DEFAULT_EXPECTED_GAP_DAYS = 60;
+const MIN_EXPECTED_GAP_DAYS = 14;
+const NEW_WINDOW_DAYS = 45;
+const SINGLE_EVENT_COOLING_DAYS = 120;
+const STEADY_RATIO = 1.5;
+const COOLING_RATIO = 3;
+
+function isVip(tags: string[]): boolean {
+  return tags.some((t) => t.trim().toLowerCase() === "vip");
+}
+
+function daysBetween(later: Date, earlier: Date): number {
+  return Math.round((later.getTime() - earlier.getTime()) / (24 * 60 * 60 * 1000));
+}
+
+function plural(n: number): string {
+  return n === 1 ? "" : "s";
+}
+
+export function computeRelationshipHealth(
+  inputs: RelationshipHealthInputs,
+  now: Date = new Date()
+): RelationshipHealthResult {
+  const reasons: string[] = [];
+  const vip = isVip(inputs.tags);
+
+  if (inputs.eventCount === 0) {
+    reasons.push("No attended bashes on record yet");
+    return { status: "New", reasons, daysSinceLastAttended: null, expectedGapDays: null };
+  }
+
+  const lastAttended = inputs.lastAttendedAt ? new Date(inputs.lastAttendedAt) : null;
+  const daysSinceLastAttended = lastAttended ? daysBetween(now, lastAttended) : null;
+  if (daysSinceLastAttended !== null) {
+    reasons.push(
+      `Last attended ${daysSinceLastAttended} day${plural(daysSinceLastAttended)} ago`
+    );
+  }
+
+  let status: RelationshipHealthStatus;
+  let expectedGapDays: number | null = null;
+
+  if (inputs.eventCount === 1) {
+    reasons.push("Attended 1 bash so far");
+    if (daysSinceLastAttended === null || daysSinceLastAttended <= NEW_WINDOW_DAYS) {
+      status = "New";
+    } else if (daysSinceLastAttended <= SINGLE_EVENT_COOLING_DAYS) {
+      status = "Cooling";
+    } else {
+      status = "AtRisk";
+    }
+  } else {
+    const first = inputs.firstAttendedAt ? new Date(inputs.firstAttendedAt) : null;
+    expectedGapDays = DEFAULT_EXPECTED_GAP_DAYS;
+    if (first && lastAttended) {
+      const spanDays = daysBetween(lastAttended, first);
+      if (spanDays > 0) {
+        expectedGapDays = Math.max(
+          MIN_EXPECTED_GAP_DAYS,
+          Math.round(spanDays / (inputs.eventCount - 1))
+        );
+        reasons.push(
+          `Typically attends every ~${expectedGapDays} days (based on ${inputs.eventCount} bashes)`
+        );
+      }
+    }
+    if (expectedGapDays === DEFAULT_EXPECTED_GAP_DAYS) {
+      reasons.push(
+        `Using a default ${DEFAULT_EXPECTED_GAP_DAYS}-day cadence — not enough history to personalize yet`
+      );
+    }
+
+    const ratio = daysSinceLastAttended === null ? 0 : daysSinceLastAttended / expectedGapDays;
+    if (ratio <= STEADY_RATIO) {
+      status = "Steady";
+    } else if (ratio <= COOLING_RATIO) {
+      status = "Cooling";
+    } else {
+      status = "AtRisk";
+    }
+  }
+
+  if (vip && status === "Cooling") {
+    status = "AtRisk";
+    reasons.push("Tagged VIP — escalated from Cooling");
+  }
+
+  if (inputs.lastOutreachAt) {
+    const daysSinceOutreach = daysBetween(now, new Date(inputs.lastOutreachAt));
+    reasons.push(
+      `Last contacted ${daysSinceOutreach} day${plural(daysSinceOutreach)} ago`
+    );
+  } else if (status === "Cooling" || status === "AtRisk") {
+    reasons.push("No outreach on record");
+  }
+
+  return { status, reasons, daysSinceLastAttended, expectedGapDays };
+}

package/src/sms/smsTemplates.ts

@@ -3,6 +3,9 @@
  * Consumers use these keys for type-safe `sendTemplatedSms` calls.
  */
 export const SMS_TEMPLATE_KEYS = [
+  "EVENT_REMINDER_1WEEK",
+  "EVENT_REMINDER_24H",
+  "EVENT_REMINDER_3H",
   "EVENT_REMINDER_1H",
   "EVENT_VENUE_CHANGED",
   "EVENT_WAITLIST_APPROVED",
@@ -13,6 +16,9 @@ export type SmsTemplateKey = (typeof SMS_TEMPLATE_KEYS)[number];
 
 /** Typed context per template (API maps these to final message strings). */
 export type SmsTemplateContext = {
+  EVENT_REMINDER_1WEEK: { eventTitle: string; shortUrl: string };
+  EVENT_REMINDER_24H: { eventTitle: string; shortUrl: string };
+  EVENT_REMINDER_3H: { eventTitle: string; shortUrl: string };
   EVENT_REMINDER_1H: { eventTitle: string; shortUrl: string };
   EVENT_VENUE_CHANGED: { eventTitle: string; shortUrl: string };
   EVENT_WAITLIST_APPROVED: { eventTitle: string; shortUrl: string };

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

@@ -10,6 +10,7 @@ import {
   generateUniqueSlug,
   generateBashDetailUrl,
   getPublicBashDetailPath,
+  getPublicBashMemoriesPath,
   getBashEventWizardStepPath,
   getBashEventWizardPayoutStepPath,
   parseBashUrlParams,
@@ -79,6 +80,20 @@ describe("getPublicBashDetailPath", () => {
   });
 });
 
+describe("getPublicBashMemoriesPath", () => {
+  test("nests /memories under the slug detail path", () => {
+    expect(getPublicBashMemoriesPath("abc123", "summer-bash")).toBe(
+      "/bash/abc123-summer-bash/memories"
+    );
+  });
+
+  test("nests /memories under the id-only path when slug is missing", () => {
+    expect(getPublicBashMemoriesPath("abc123", null)).toBe(
+      `${BASH_DETAIL_URL}/abc123/memories`
+    );
+  });
+});
+
 describe("getBashEventWizardStepPath", () => {
   test("builds wizard step path", () => {
     expect(getBashEventWizardStepPath("evt-1", 3, 2)).toBe(