@bash-app/bash-common 30.316.0 → 30.319.0

package/src/__tests__/hostCrmSegments.test.ts

@@ -158,6 +158,15 @@ describe("applyHostCrmSegmentRules", () => {
       })
     ).toHaveLength(1);
   });
+
+  it("filters by maxEventCount (first-timers style segments)", () => {
+    const audience = [
+      member({ userId: "first-timer", eventCount: 1 }),
+      member({ userId: "repeat", eventCount: 4 }),
+    ];
+    const filtered = applyHostCrmSegmentRules(audience, { maxEventCount: 1 });
+    expect(filtered.map((r) => r.userId)).toEqual(["first-timer"]);
+  });
 });
 
 describe("HOST_CRM_PRESET_SEGMENTS", () => {
@@ -177,12 +186,16 @@ describe("HOST_CRM_PRESET_SEGMENTS", () => {
         "series_regular",
         "brings_friends",
         "last3Events",
+        "first_timers",
       ])
     );
     expect(ids).not.toContain("cadence_often");
     expect(
       HOST_CRM_PRESET_SEGMENTS.find((p) => p.id === "repeat_guests")?.rules
     ).toEqual({ minEventCount: 2 });
+    expect(
+      HOST_CRM_PRESET_SEGMENTS.find((p) => p.id === "first_timers")?.rules
+    ).toEqual({ maxEventCount: 1 });
     expect(
       HOST_CRM_PRESET_SEGMENTS.find((p) => p.id === "top_spenders")?.rules
     ).toEqual({});

package/src/__tests__/ticketExtShapes.test.ts

@@ -0,0 +1,55 @@
+import type { PublicUser, TicketFlexible } from "../extendedSchemas";
+import {
+  isTicketExt,
+  ticketsWithOwnerAndForUser,
+} from "../extendedSchemas";
+
+function ticketStub(overrides: Partial<TicketFlexible> = {}): TicketFlexible {
+  return {
+    id: "ticket-1",
+    ownerId: "owner-1",
+    forUserId: "for-user-1",
+    ...overrides,
+  } as TicketFlexible;
+}
+
+describe("TicketFlexible / TicketExt shapes", () => {
+  const owner = { id: "owner-1" } as PublicUser;
+  const forUser = { id: "for-user-1" } as PublicUser;
+
+  it("isTicketExt requires both owner and forUser", () => {
+    expect(isTicketExt(ticketStub({ id: "t1" }))).toBe(false);
+    expect(isTicketExt(ticketStub({ id: "t2", owner }))).toBe(false);
+    expect(isTicketExt(ticketStub({ id: "t3", forUser }))).toBe(false);
+    expect(isTicketExt(ticketStub({ id: "t4", owner, forUser }))).toBe(true);
+  });
+
+  it("ticketsWithOwnerAndForUser keeps only TicketExt rows", () => {
+    const rows = [
+      ticketStub({ id: "a" }),
+      ticketStub({ id: "b", owner, forUser }),
+      ticketStub({ id: "c", owner }),
+    ];
+    const full = ticketsWithOwnerAndForUser(rows);
+    expect(full.map((t) => t.id)).toEqual(["b"]);
+    expect(full[0].owner.id).toBe("owner-1");
+    expect(full[0].forUser.id).toBe("for-user-1");
+  });
+
+  it("TicketExt is assignable from a narrowed TicketFlexible", () => {
+    const flexible = ticketStub({
+      id: "t5",
+      owner,
+      forUser,
+      postponeRespondedAt: new Date("2026-07-17T00:00:00.000Z"),
+    });
+    expect(isTicketExt(flexible)).toBe(true);
+    if (isTicketExt(flexible)) {
+      expect(flexible.owner.id).toBe("owner-1");
+      expect(flexible.forUser.id).toBe("for-user-1");
+      expect(flexible.postponeRespondedAt).toEqual(
+        new Date("2026-07-17T00:00:00.000Z")
+      );
+    }
+  });
+});

package/src/appleIapProducts.ts

@@ -0,0 +1,203 @@
+/**
+ * Apple App Store product catalog for iOS IAP.
+ * Product IDs must match App Store Connect exactly.
+ *
+ * Stripe remains the billing path on web/Android. On iOS native, these products
+ * unlock the same entitlements Stripe grants for digital goods (Guideline 3.1.1).
+ * Event tickets and real-world service bookings stay on Stripe (3.1.3(e)).
+ */
+import { BashPassTier, MembershipTier } from "@prisma/client";
+
+import { FEATURE_BOOST_DURATIONS, MEMBERSHIP_PRICING } from "./membershipDefinitions.js";
+import { SERVICE_SUBSCRIPTION_TIERS } from "./definitions.js";
+
+export type AppleIapProductFamily =
+  | "membership"
+  | "listing"
+  | "bashpass"
+  | "feature_boost";
+
+export type AppleMembershipInterval = "monthly" | "yearly" | "lifetime";
+
+export type AppleListingTier = "Ally" | "Partner" | "Patron";
+
+export interface AppleMembershipProduct {
+  productId: string;
+  family: "membership";
+  tier: Exclude<MembershipTier, "Basic" | "Guest">;
+  interval: AppleMembershipInterval;
+  /** Reference price in cents (ASC must match; Apple may regionalize). */
+  priceCents: number;
+}
+
+export interface AppleListingProduct {
+  productId: string;
+  family: "listing";
+  tier: AppleListingTier;
+  interval: "monthly";
+  priceCents: number;
+}
+
+export interface AppleBashPassProduct {
+  productId: string;
+  family: "bashpass";
+  tier: BashPassTier;
+  interval: "monthly";
+  priceCents: number;
+}
+
+export interface AppleFeatureBoostProduct {
+  productId: string;
+  family: "feature_boost";
+  durationId: (typeof FEATURE_BOOST_DURATIONS)[number]["id"];
+  hours: number;
+  priceCents: number;
+}
+
+export type AppleIapProduct =
+  | AppleMembershipProduct
+  | AppleListingProduct
+  | AppleBashPassProduct
+  | AppleFeatureBoostProduct;
+
+const MEMBERSHIP_TIERS = [
+  MembershipTier.Premium,
+  MembershipTier.Pro,
+  MembershipTier.Elite,
+  MembershipTier.Legend,
+] as const;
+
+function membershipProductId(
+  tier: (typeof MEMBERSHIP_TIERS)[number],
+  interval: AppleMembershipInterval
+): string {
+  return `community.bash.us.membership.${tier.toLowerCase()}.${interval}`;
+}
+
+/** Lifetime price heuristic: 10× yearly (matches existing Stripe lifetime helpers). */
+function lifetimePriceCents(tier: (typeof MEMBERSHIP_TIERS)[number]): number {
+  return MEMBERSHIP_PRICING[tier].yearly * 10;
+}
+
+export const APPLE_MEMBERSHIP_PRODUCTS: readonly AppleMembershipProduct[] =
+  MEMBERSHIP_TIERS.flatMap((tier) => {
+    const monthly: AppleMembershipProduct = {
+      productId: membershipProductId(tier, "monthly"),
+      family: "membership",
+      tier,
+      interval: "monthly",
+      priceCents: MEMBERSHIP_PRICING[tier].monthly,
+    };
+    const yearly: AppleMembershipProduct = {
+      productId: membershipProductId(tier, "yearly"),
+      family: "membership",
+      tier,
+      interval: "yearly",
+      priceCents: MEMBERSHIP_PRICING[tier].yearly,
+    };
+    const lifetime: AppleMembershipProduct = {
+      productId: membershipProductId(tier, "lifetime"),
+      family: "membership",
+      tier,
+      interval: "lifetime",
+      priceCents: lifetimePriceCents(tier),
+    };
+    return [monthly, yearly, lifetime];
+  });
+
+/** Listing seat subscriptions — dollars in SERVICE_SUBSCRIPTION_TIERS → cents. */
+export const APPLE_LISTING_PRODUCTS: readonly AppleListingProduct[] = (
+  ["Ally", "Partner", "Patron"] as const
+).map((tier) => ({
+  productId: `community.bash.us.listing.${tier.toLowerCase()}.monthly`,
+  family: "listing" as const,
+  tier,
+  interval: "monthly" as const,
+  priceCents: Math.round(SERVICE_SUBSCRIPTION_TIERS[tier].price * 100),
+}));
+
+/**
+ * Standalone BashPass monthly prices (cents). Mirror Stripe catalog when ASC is created.
+ * LITE $19.99 · STANDARD $49.99 · UNLIMITED $99.99
+ */
+export const APPLE_BASHPASS_PRICE_CENTS: Record<BashPassTier, number> = {
+  [BashPassTier.LITE]: 1999,
+  [BashPassTier.STANDARD]: 4999,
+  [BashPassTier.UNLIMITED]: 9999,
+};
+
+export const APPLE_BASHPASS_PRODUCTS: readonly AppleBashPassProduct[] = (
+  Object.values(BashPassTier) as BashPassTier[]
+).map((tier) => ({
+  productId: `community.bash.us.bashpass.${tier.toLowerCase()}.monthly`,
+  family: "bashpass" as const,
+  tier,
+  interval: "monthly" as const,
+  priceCents: APPLE_BASHPASS_PRICE_CENTS[tier],
+}));
+
+export const APPLE_FEATURE_BOOST_PRODUCTS: readonly AppleFeatureBoostProduct[] =
+  FEATURE_BOOST_DURATIONS.map((d) => ({
+    productId: `community.bash.us.boost.${d.id}`,
+    family: "feature_boost" as const,
+    durationId: d.id,
+    hours: d.hours,
+    priceCents: d.priceCents,
+  }));
+
+export const APPLE_IAP_PRODUCTS: readonly AppleIapProduct[] = [
+  ...APPLE_MEMBERSHIP_PRODUCTS,
+  ...APPLE_LISTING_PRODUCTS,
+  ...APPLE_BASHPASS_PRODUCTS,
+  ...APPLE_FEATURE_BOOST_PRODUCTS,
+];
+
+const BY_PRODUCT_ID: ReadonlyMap<string, AppleIapProduct> = new Map(
+  APPLE_IAP_PRODUCTS.map((p) => [p.productId, p])
+);
+
+export function getAppleIapProduct(productId: string): AppleIapProduct | undefined {
+  return BY_PRODUCT_ID.get(productId);
+}
+
+export function isAppleIapProductId(productId: string): boolean {
+  return BY_PRODUCT_ID.has(productId);
+}
+
+export function listAppleIapProductIds(family?: AppleIapProductFamily): string[] {
+  if (!family) {
+    return APPLE_IAP_PRODUCTS.map((p) => p.productId);
+  }
+  return APPLE_IAP_PRODUCTS.filter((p) => p.family === family).map((p) => p.productId);
+}
+
+export function findAppleMembershipProduct(
+  tier: Exclude<MembershipTier, "Basic" | "Guest">,
+  interval: AppleMembershipInterval
+): AppleMembershipProduct | undefined {
+  return APPLE_MEMBERSHIP_PRODUCTS.find(
+    (p) => p.tier === tier && p.interval === interval
+  );
+}
+
+export function findAppleListingProduct(
+  tier: AppleListingTier
+): AppleListingProduct | undefined {
+  return APPLE_LISTING_PRODUCTS.find((p) => p.tier === tier);
+}
+
+export function findAppleBashPassProduct(
+  tier: BashPassTier
+): AppleBashPassProduct | undefined {
+  return APPLE_BASHPASS_PRODUCTS.find((p) => p.tier === tier);
+}
+
+export function findAppleFeatureBoostProduct(
+  durationId: (typeof FEATURE_BOOST_DURATIONS)[number]["id"]
+): AppleFeatureBoostProduct | undefined {
+  return APPLE_FEATURE_BOOST_PRODUCTS.find((p) => p.durationId === durationId);
+}
+
+/** Apple subscription management deep link (Settings → Subscriptions). */
+export const APPLE_SUBSCRIPTIONS_MANAGEMENT_URL =
+  "https://apps.apple.com/account/subscriptions";

package/src/definitions.ts

@@ -909,6 +909,8 @@ export enum ApiErrorType {
   payment_intent_creation_failed,
   /** Host requires waiver / custom terms; buyer did not attest acceptance */
   EventWaiverNotAccepted,
+  /** Bash is not Published/PreSale — ticket purchase and checkout creation are blocked */
+  EventNotAcceptingPurchases,
 }
 
 export type ErrorDataType = Record<RecordKey, unknown>;

package/src/extendedSchemas.ts

@@ -371,6 +371,48 @@ export type BashEventMerchCatalog = {
   settings: BashEventHostMerchSettings;
 };
 
+/** Mirrors Prisma `BashEventMerchOrderStatus` for app/API without requiring a Prisma client import. */
+export const BashEventMerchOrderStatus = {
+  Paid: "Paid",
+  Fulfilled: "Fulfilled",
+  Cancelled: "Cancelled",
+  Refunded: "Refunded",
+} as const;
+
+export type BashEventMerchOrderStatus =
+  (typeof BashEventMerchOrderStatus)[keyof typeof BashEventMerchOrderStatus];
+
+/** Fulfillment channel chosen at Stripe checkout for host-event merch. */
+export type BashEventMerchFulfillment =
+  | "pickup"
+  | "shipping"
+  | "checkout_bundle";
+
+/** One paid host-event merch order (Stripe Checkout → BashEventMerchOrder). */
+export type BashEventMerchOrderExt = {
+  id: string;
+  bashEventId: string;
+  merchItemId: string;
+  buyerId: string;
+  itemNameSnapshot: string;
+  unitPriceCents: number;
+  fulfillment: string;
+  status: BashEventMerchOrderStatus;
+  stripeCheckoutSessionId: string;
+  shippingName: string | null;
+  shippingLine1: string | null;
+  shippingLine2: string | null;
+  shippingCity: string | null;
+  shippingState: string | null;
+  shippingPostalCode: string | null;
+  shippingCountry: string | null;
+  fulfilledAt: Date | string | null;
+  createdAt: Date | string;
+  updatedAt: Date | string;
+  buyer?: PublicUser | null;
+  bashEvent?: Pick<BashEvent, "id" | "title" | "slug"> | null;
+};
+
 /**
  * Service profile merch purchase options (ServiceRatesAssociation.merchSettings JSON).
  *
@@ -409,18 +451,44 @@ export type BashEventHiredServicePublic = {
   }>;
 };
 
-export interface BashEventExt extends Override<
+/**
+ * API/app bash shape. Declared as a `type` (not `interface extends Override`) so
+ * Prisma scalar redeclares stay `T` rather than `T | undefined` — a TypeScript
+ * quirk when interfaces extend intersection/mapped types.
+ *
+ * Policy fields are applied in a final `Omit & { ... }` intersection so they stay
+ * required even when Prisma's mapped `BashEvent` makes `Omit` leave residual
+ * optionality on those keys.
+ */
+type BashEventExtBase = Override<
   Omit<
     BashEvent,
     | "ideaExpiresAt"
     | "ideaInterestThreshold"
     | "isAutoApprovable"
     | "merchandiseItems"
+    | "icebreakerPrompt"
+    | "cancellationPolicy"
+    | "refundsGuaranteedOnCancellation"
+    | "postponementAllowed"
+    | "isPostponed"
+    | "postponedAt"
+    | "postponeResponseDeadline"
   >,
-  { icebreakerPrompt: string | null }
-> {
-  /** Host-curated merch catalog (wizard); stored as JSON on BashEvent. Null = no merch configured. */
-  merchandiseItems: BashEventMerchCatalog | null;
+  {
+    icebreakerPrompt: string | null;
+    cancellationPolicy: string | null;
+    refundsGuaranteedOnCancellation: boolean;
+    postponementAllowed: boolean;
+    isPostponed: boolean;
+    postponedAt: Date | null;
+    postponeResponseDeadline: Date | null;
+    merchandiseItems: BashEventMerchCatalog | null;
+    ideaExpiresAt: Date | null;
+    isAutoApprovable: boolean;
+    ideaInterestThreshold: number | null;
+  }
+> & {
   // Prisma relation fields (not included in the flat BashEvent model type)
   coordinates?: Coordinates[];
   /** Linked venue (when bashEvent.venueId is set and `venue` is requested in include params) */
@@ -461,27 +529,39 @@ export interface BashEventExt extends Override<
   goingCount?: number;
   /** GET /event/:id when status=Idea — total IdeaInterest rows */
   ideaInterestCount?: number;
+  /** Feed/card alias for idea interest (some list payloads use this name). */
+  interestedCount?: number;
   /** GET /event/:id — PublicBashRsvp counts (published / presale) */
   publicRsvpCounts?: { going: number; interested: number; notGoing: number };
   /** Current viewer's soft RSVP (PublicBashRsvp), if any */
   myPublicRsvpStatus?: string | null;
   /** Host approval queue status for the viewer's PublicBashRsvp (Pending | Approved | Denied) */
   myPublicRsvpApprovalStatus?: string | null;
+  /** When the viewer last kept/declined after a postponement (PublicBashRsvp) */
+  myPublicRsvpPostponeRespondedAt?: Date | string | null;
+  /**
+   * Creator-view only when `isPostponed`: keep / decline / pending counts for
+   * active tickets and approved Going RSVPs.
+   */
+  postponeResponseSummary?: {
+    ticketsKept: number;
+    ticketsDeclined: number;
+    ticketsPending: number;
+    rsvpsKept: number;
+    rsvpsDeclined: number;
+    rsvpsPending: number;
+  };
   /** GET /event/:id and GET /public-event/:id (authenticated) when accessScreeningEnabled — viewer's latest access request status */
   myAccessRequestStatus?: "None" | "Pending" | "Approved" | "Denied" | null;
   /** GET /event/:id when status=Idea — viewer's IdeaInterest row (matched by email) */
   myIdeaInterest?: (IdeaInterest & { responses: IdeaInterestResponse[] }) | null;
-  /** Rolling expiry timestamp for Idea events (aligned with Prisma `BashEvent.ideaExpiresAt`) */
-  ideaExpiresAt: Date | null;
-  /** Whether the Idea has met the auto-approval threshold */
-  isAutoApprovable: boolean;
-  /** Number of interests needed for auto-publish (see DEFAULT_IDEA_INTEREST_THRESHOLD) */
-  ideaInterestThreshold: number | null;
   /** GET /event/:id when status=Idea — distinct service providers who sent a service-offer notification */
   ideaServiceProviderInterestCount?: number;
   // Event page visual customisation (stored as scalar columns on BashEvent)
   backgroundImage: string | null;
   themeColor: string | null;
+  /** Soft blur on theme photo backgrounds; hosts may turn off for a sharp image. */
+  backgroundBlurEnabled: boolean;
   /**
    * Computed at request time from the host Organization's nonprofit verification.
    * Drives the buyer-facing fee breakdown ("Nonprofit — no Bash platform fee").
@@ -506,7 +586,29 @@ export interface BashEventExt extends Override<
    * Scalar on `BashEvent`; included on GET /event/:id and GET /public-event/:id responses.
    */
   discussionEnabled: boolean;
-}
+};
+
+export type BashEventExt = Omit<
+  BashEventExtBase,
+  | "icebreakerPrompt"
+  | "cancellationPolicy"
+  | "refundsGuaranteedOnCancellation"
+  | "postponementAllowed"
+  | "isPostponed"
+  | "postponedAt"
+  | "postponeResponseDeadline"
+> & {
+  icebreakerPrompt: string | null;
+  /** Free-text cancellation / refund policy shown at checkout and on tickets. */
+  cancellationPolicy: string | null;
+  /** When true (default), cancelling auto-refunds paid ticket holders. */
+  refundsGuaranteedOnCancellation: boolean;
+  /** Host may postpone after tickets exist if enabled before first sale. */
+  postponementAllowed: boolean;
+  isPostponed: boolean;
+  postponedAt: Date | null;
+  postponeResponseDeadline: Date | null;
+};
 
 /**
  * Incoming create/update payload (e.g. Express JSON body): core date fields may still be ISO strings
@@ -1554,26 +1656,18 @@ export type TicketGiftGrantExt = Prisma.TicketGiftGrantGetPayload<{
   include: typeof TICKET_GIFT_GRANT_DATA_TO_INCLUDE;
 }>;
 
-export interface TicketExt extends Ticket {
-  owner: PublicUser;
-  forUser: PublicUser;
-  checkout?: Checkout;
-  transfers?: TicketTransfer[];
-  metadata?: TicketMetadata[];
-  /**
-   * Included on authenticated GET /event/:id for the viewer's tickets when a
-   * peer transfer invite row exists (see transfer-withdraw / check-in guards).
-   */
-  transferInvite?: Pick<
-    TicketTransferInvite,
-    "status" | "expiresAt" | "token" | "toEmail" | "toUserId"
-  > | null;
-}
+/**
+ * Ticket transfer-invite teaser shared by list/detail payloads.
+ * Authenticated GET `/event/:id` may include this without `owner` / `forUser`.
+ */
+export type TicketTransferInviteTeaser = Pick<
+  TicketTransferInvite,
+  "status" | "expiresAt" | "token" | "toEmail" | "toUserId"
+>;
 
 /**
- * Ticket rows in attendee/event payloads where nested relations may be omitted
- * (e.g. authenticated GET `/event/:id` may include `transferInvite` without
- * `owner` / `forUser` selects).
+ * Ticket row when nested relations may be omitted (privacy / payload size).
+ * Use on `BashEventExt.tickets` and other event-scoped lists.
  */
 export type TicketFlexible = Ticket & {
   owner?: PublicUser;
@@ -1581,12 +1675,30 @@ export type TicketFlexible = Ticket & {
   checkout?: Checkout;
   transfers?: TicketTransfer[];
   metadata?: TicketMetadata[];
-  transferInvite?: Pick<
-    TicketTransferInvite,
-    "status" | "expiresAt" | "token" | "toEmail" | "toUserId"
-  > | null;
+  transferInvite?: TicketTransferInviteTeaser | null;
 };
 
+/**
+ * Ticket row when `owner` and `forUser` were selected (host/admin / full ticket APIs).
+ * Strict refinement of {@link TicketFlexible} — prefer narrowing with {@link isTicketExt}.
+ */
+export type TicketExt = TicketFlexible & {
+  owner: PublicUser;
+  forUser: PublicUser;
+};
+
+/** True when both buyer (`owner`) and assignee (`forUser`) are present. */
+export function isTicketExt(ticket: TicketFlexible): ticket is TicketExt {
+  return ticket.owner != null && ticket.forUser != null;
+}
+
+/** Keep only tickets that include both `owner` and `forUser`. */
+export function ticketsWithOwnerAndForUser(
+  tickets: readonly TicketFlexible[]
+): TicketExt[] {
+  return tickets.filter(isTicketExt);
+}
+
 export interface CheckoutExt extends Checkout {
   /** Full owner row for hosts/organizers; teaser row (no email) for other authenticated viewers. */
   owner: PublicUser | PublicTeaserUser;
@@ -1680,7 +1792,7 @@ export interface UserExt extends User {
   socialMediaPlatforms?: SocialMediaPlatform[] | null;
   reviews?: ReviewExt[] | null;
   contacts?: Contact[] | null;
-  ticketsIOwn?: TicketExt[] | null;
+  ticketsIOwn?: TicketFlexible[] | null;
   ownedServices?: ServiceExt[];
   createdServices?: ServiceExt[];
   password?: string;

package/src/hostCrmAutomation.ts

@@ -77,3 +77,62 @@ export type HostCrmAutomationInput = {
   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/hostCrmSegments.ts

@@ -10,6 +10,8 @@ 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;
@@ -107,6 +109,10 @@ export function applyHostCrmSegmentRules<T extends HostCrmAudienceMember>(
     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) => {
@@ -200,6 +206,12 @@ export const HOST_CRM_PRESET_SEGMENTS: Array<{
     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",

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

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