@bash-app/bash-common 30.424.0 → 30.427.0

package/src/extendedSchemas.ts

@@ -109,7 +109,7 @@ import {
   SERVICE_LINK_DATA_TO_INCLUDE,
 } from "./definitions.js";
 
-/** Prisma model — re-exported for homepage filters and custom event type pickers. */
+/** Prisma model. Re-exported for homepage filters and custom event type pickers. */
 export type { CustomBashEventType } from "@prisma/client";
 
 import {
@@ -193,7 +193,7 @@ export const FRONT_END_USER_DATA_TO_SELECT = {
   // documentID: true,
   /** Set when Stripe Identity verification completes (hosted flow). */
   idVerified: true,
-  /** $1 card verification (Stripe PaymentIntent) — unlocks publish gate + 2x earn multiplier */
+  /** $1 card verification (Stripe PaymentIntent). Unlocks publish gate + 2x earn multiplier */
   paymentVerified: true,
   reviews: true,
   contacts: true,
@@ -225,7 +225,7 @@ export const FRONT_END_USER_DATA_TO_SELECT = {
   totalEventsHosted: true,
   /** Whether this account is suspended (superuser admin visibility). */
   isSuspended: true,
-  /** Subscription summary for public surfaces — omit Stripe linkage fields (see PUBLIC_USER_SUBSCRIPTION_DATA_TO_SELECT). */
+  /** Subscription summary for public surfaces. Omit Stripe linkage fields (see PUBLIC_USER_SUBSCRIPTION_DATA_TO_SELECT). */
   userSubscription: {
     select: PUBLIC_USER_SUBSCRIPTION_DATA_TO_SELECT,
   },
@@ -276,9 +276,9 @@ export type PublicTeaserUser = Prisma.UserGetPayload<{
 
 export const PRIVATE_USER_ACCOUNT_TO_SELECT = {
   ...FRONT_END_USER_DATA_TO_SELECT,
-  /** Self session only — preferred payment rail (Stripe vs Square). */
+  /** Self session only. Preferred payment rail (Stripe vs Square). */
   paymentProvider: true,
-  // Self-only sensitive demographics — re-added so /me can populate edit forms.
+  // Self-only sensitive demographics. Re-added so /me can populate edit forms.
   gender: true,
   genderIdentity: true,
   sex: true,
@@ -290,9 +290,9 @@ export const PRIVATE_USER_ACCOUNT_TO_SELECT = {
   zipCode: true,
   country: true,
   phone: true,
-  /** SMS verification — self account only. */
+  /** SMS verification. Self account only. */
   phoneVerifiedAt: true,
-  /** Opt-in SMS login codes — self account only. */
+  /** Opt-in SMS login codes. Self account only. */
   smsMfaEnabled: true,
   membershipExpiresAt: true,
   bashPassStripeSubscriptionId: true,
@@ -399,7 +399,7 @@ export interface PromoterMilestoneBase {
   competitionId: string;
   threshold: number | null;
   rank: number | null;
-  rewardType: string; // PromoterRewardType — string union until client is regenerated
+  rewardType: string; // PromoterRewardType. String union until client is regenerated
   rewardAmountCents: number | null;
   rewardDescription: string | null;
   ticketTierId: string | null;
@@ -423,7 +423,7 @@ export interface PromoterRewardBase {
   milestoneId: string | null;
   rank: number | null;
   qualifiedSalesSnapshot: number;
-  status: string; // PromoterRewardStatus — string union until client is regenerated
+  status: string; // PromoterRewardStatus. String union until client is regenerated
   earnedAt: Date | null;
   fulfilledAt: Date | null;
   revokedAt: Date | null;
@@ -490,9 +490,9 @@ export type BashEventHostMerchItem = {
 
 /** Host-controlled visibility of purchase options shown in the merch modal on the event detail page. */
 export type BashEventHostMerchSettings = {
-  /** Show "Buy now — get it shipped" option in merch modal (default: true) */
+  /** Show "Buy now. Get it shipped" option in merch modal (default: true) */
   showShipping: boolean;
-  /** Show "Pay in advance — pick up at event" option in merch modal (default: true) */
+  /** Show "Pay in advance. Pick up at event" option in merch modal (default: true) */
   showPreOrder: boolean;
   /** Show "Add to ticket checkout" option in merch modal (default: true) */
   showAddToCheckout: boolean;
@@ -558,7 +558,7 @@ export type BashEventMerchOrderExt = {
 export type ServiceMerchSettings = {
   showShipping: boolean;
   showPreOrder: boolean;
-  /** Stripe ticket-cart bundle option for host merch flows—not used for hired-service Square checkout. */
+  /** Stripe ticket-cart bundle option for host merch flows. Not used for hired-service Square checkout. */
   showAddToCheckout: boolean;
   purchaseNote?: string | null;
 };
@@ -573,7 +573,7 @@ export type BashEventHiredServicePublic = {
   coverPhoto: string | null;
   /** When true, standalone Square checkout is available for merchandise SKUs below. */
   squareMerchCheckoutEnabled: boolean;
-  /** Merch options from provider profile—Square hired-service checkout reads ship + pickup only. */
+  /** Merch options from provider profile. Square hired-service checkout reads ship + pickup only. */
   merchSettings: ServiceMerchSettings | null;
   merchandiseAddons: Array<{
     id: string;
@@ -588,7 +588,7 @@ export type BashEventHiredServicePublic = {
 
 /**
  * API/app bash shape. Declared as a `type` (not `interface extends Override`) so
- * Prisma scalar redeclares stay `T` rather than `T | undefined` — a TypeScript
+ * 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
@@ -625,7 +625,7 @@ type BashEventExtBase = Override<
     ideaExpiresAt: Date | null;
     isAutoApprovable: boolean;
     ideaInterestThreshold: number | null;
-    /** Venue seat chart JSON — typed for wizard/checkout (Prisma stores Json). */
+    /** Venue seat chart JSON. Typed for wizard/checkout (Prisma stores Json). */
     seatMap: import("./seatMap.js").SeatMapDocument | null;
   }
 > & {
@@ -641,7 +641,7 @@ type BashEventExtBase = Override<
   amountOfGuests?: AmountOfGuests;
   recurrence?: Recurrence;
   creator?: PublicUser;
-  /** Co-hosts / organizers (AssociatedBash.isOrganizer), excluding the creator — GET /event/:id and public-event/:id when loaded */
+  /** Co-hosts / organizers (AssociatedBash.isOrganizer), excluding the creator. GET /event/:id and public-event/:id when loaded */
   organizers?: PublicUser[];
   /** Service bookings for this bash + enabled merchandise rows (public detail) */
   hiredServices?: BashEventHiredServicePublic[];
@@ -665,16 +665,16 @@ type BashEventExtBase = Override<
   competitions?: CompetitionExt[];
   interests?: (IdeaInterest & { responses?: IdeaInterestResponse[] })[];
   configurations?: IdeaConfiguration[];
-  /** GET /event/:id when status=Idea and ideaDatePollEnabled — candidate datetimes for guest voting */
+  /** GET /event/:id when status=Idea and ideaDatePollEnabled. Candidate datetimes for guest voting */
   dateOptions?: IdeaDateOption[];
   /** Public aggregate when poll enabled (no PII) */
   datePollPublicSummary?: IdeaDatePollPublicSummary;
   hideCancellationPolicy?: boolean;
   hideGroupUp?: boolean;
   hideServicesOpenTo?: boolean;
-  /** GET /event/:id — tickets sold (non-cancelled), for social proof */
+  /** GET /event/:id. Tickets sold (non-cancelled), for social proof */
   goingCount?: number;
-  /** GET /event/:id — true when at least one Budget line has `showOnBashDetailPage` set. Drives the "View budget" reveal on the public bash page; never carries dollar amounts. */
+  /** GET /event/:id. True when at least one Budget line has `showOnBashDetailPage` set. Drives the "View budget" reveal on the public bash page; never carries dollar amounts. */
   hasVisibleBudget?: boolean;
   /** Public funding meter: value coming in toward included budget lines. */
   showFundingMeter?: boolean;
@@ -682,11 +682,11 @@ type BashEventExtBase = Override<
   showHostOnBashPage?: boolean;
   fundingAllowCommitments?: boolean;
   fundingShowPledgesOnMeter?: boolean;
-  /** GET /event/:id when status=Idea — total IdeaInterest rows */
+  /** 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) */
+  /** 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;
@@ -708,15 +708,15 @@ type BashEventExtBase = Override<
     rsvpsDeclined: number;
     rsvpsPending: number;
   };
-  /** GET /event/:id and GET /public-event/:id (authenticated) when accessScreeningEnabled — viewer's latest access request status */
+  /** GET /event/:id and GET /public-event/:id (authenticated) when accessScreeningEnabled. Viewer's latest access request status */
   myAccessRequestStatus?: "None" | "Pending" | "Approved" | "Denied" | null;
   /** Public pending + approved application / RSVP totals when Application is on. Hidden at 0. */
   applicationApplicantCount?: number;
-  /** GET /event/:id when status=Idea — viewer's IdeaInterest row (matched by email) */
+  /** GET /event/:id when status=Idea. Viewer's IdeaInterest row (matched by email) */
   myIdeaInterest?:
     | (IdeaInterest & { responses: IdeaInterestResponse[] })
     | null;
-  /** GET /event/:id when status=Idea — distinct service providers who sent a service-offer notification */
+  /** 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;
@@ -725,7 +725,7 @@ type BashEventExtBase = Override<
   backgroundBlurEnabled: boolean;
   /**
    * Computed at request time from the host Organization's nonprofit verification.
-   * Drives the buyer-facing fee breakdown ("Nonprofit — no Bash platform fee").
+   * Drives the buyer-facing fee breakdown ("Nonprofit. No Bash platform fee").
    * Optional because not every endpoint that returns BashEventExt resolves the host org.
    */
   isVerifiedNonprofitHost?: boolean;
@@ -831,7 +831,7 @@ export type BashEventUpsertWireInput = Override<
   }
 >;
 
-/** Minimal ticket-holder identity — narrower than PublicUser/PublicTeaserUser; used wherever a ticket
+/** Minimal ticket-holder identity. Narrower than PublicUser/PublicTeaserUser; used wherever a ticket
  * relation just needs to identify who owns/holds it (not a full public profile). */
 export const TICKET_HOLDER_USER_SELECT = {
   id: true,
@@ -997,7 +997,7 @@ export const VENUE_DATA_TO_REMOVE: RemoveCommonProperties<
   // 'bashEvents',
 ] as const;
 
-/** Shared by Vendor/EventService/EntertainmentService/Exhibitor/Sponsor includes — each model has
+/** Shared by Vendor/EventService/EntertainmentService/Exhibitor/Sponsor includes. Each model has
  * its own identically-shaped `crowdSize`/`serviceRange` relations (attendance preferences). */
 export const SERVICE_SUBTYPE_CROWD_RANGE_INCLUDE = {
   crowdSize: true,
@@ -1236,7 +1236,7 @@ export const SERVICE_DATA_TO_INCLUDE = {
       sportsProfile: true,
     },
   }, // Include organization data with member counts
-  // Lightweight — just enough for the UI to know a complementary Vendor <-> EventServices
+  // Lightweight. Just enough for the UI to know a complementary Vendor <-> EventServices
   // profile already exists (see Part B "also list as" flow) without a second fetch.
   complementaryProfiles: {
     select: { id: true, serviceType: true },
@@ -1428,7 +1428,7 @@ export const SERVICE_BOOKING_PRIVATE_DATA_TO_INCLUDE = {
   },
 } satisfies Prisma.ServiceBookingInclude;
 
-// Narrowed reference types — match exactly what SERVICE_BOOKING_PRIVATE_DATA_TO_INCLUDE selects,
+// Narrowed reference types. Match exactly what SERVICE_BOOKING_PRIVATE_DATA_TO_INCLUDE selects,
 // so call sites can cast prisma.upsert/findUnique results without needing `as unknown`.
 export type ServiceBookingBashEventRef = Pick<
   BashEvent,
@@ -1490,7 +1490,7 @@ export interface ServiceExt extends Service {
 
   stripeAccount?: PublicStripeAccount | null;
 
-  /** Geo anchor — explicit on ext type for consumers before Prisma client catches up */
+  /** Geo anchor. Explicit on ext type for consumers before Prisma client catches up */
   latitude: number | null;
   longitude: number | null;
 
@@ -1515,7 +1515,7 @@ export interface ServiceExt extends Service {
   associatedBashesReferencingMe?: AssociatedBashExt[];
   associatedServicesReferencingMe?: AssociatedServiceExt[];
 
-  /** Reverse side of `complementaryOfServiceId` — the "also list as" profile(s) this service already spawned. */
+  /** Reverse side of `complementaryOfServiceId`. The "also list as" profile(s) this service already spawned. */
   complementaryProfiles?: Pick<Service, "id" | "serviceType">[];
 
   // googleReviews: GoogleReview[];
@@ -1580,7 +1580,7 @@ export type ServiceExtNoIds = Omit<
   | "serviceRatesAssociationId"
   | "serviceId"
 >;
-/** Attendance-preference overlay shared by every bookable service subtype — mirrors
+/** Attendance-preference overlay shared by every bookable service subtype. Mirrors
  * SERVICE_SUBTYPE_CROWD_RANGE_INCLUDE so the type and the select/include it's derived from stay in sync. */
 export interface ServiceSubtypeCrowdRange {
   crowdSize?: AmountOfGuests;
@@ -1616,7 +1616,7 @@ export interface VendorExt extends Vendor, ServiceSubtypeCrowdRange {
 // Partner (Vendor/Exhibitor/Sponsor) booking requests
 //
 // VendorBookingRequest/ExhibitorBookingRequest/SponsorBookingRequest are three separate Prisma
-// models (a real merge into one polymorphic table is a future schema migration — see the
+// models (a real merge into one polymorphic table is a future schema migration. See the
 // bash-common schema/type consolidation plan). Until then, these GetPayload-derived types give
 // the API and app a single shared, real contract instead of hand-typed hand-drift per package.
 //-------------------------------------------------------------------------------------------------------------------------------
@@ -1683,7 +1683,7 @@ export type SponsorBookingRequestExt = Prisma.SponsorBookingRequestGetPayload<{
 }>;
 
 /** Fields common to all three partner booking request models (same name + type on every model).
- * `status` is intentionally excluded — Vendor/Exhibitor/SponsorBookingStatus are separate (if
+ * `status` is intentionally excluded. Vendor/Exhibitor/SponsorBookingStatus are separate (if
  * byte-identical) enums, so each Ext type keeps its own nominal status field. */
 export type PartnerBookingRequestBase = Pick<
   VendorBookingRequestExt,
@@ -1714,7 +1714,7 @@ export type PartnerBookingRequestBase = Pick<
   | "bashEvent"
 >;
 
-/** Discriminated union of the three partner booking request types — `partnerType` is attached
+/** Discriminated union of the three partner booking request types. `partnerType` is attached
  * by the API (it isn't a DB column) so callers can narrow without checking which service-ref key is present. */
 export type PartnerBookingRequest =
   | ({ partnerType: "vendor" } & VendorBookingRequestExt)
@@ -1987,7 +1987,7 @@ export type TicketFlexible = Ticket & {
 
 /**
  * Ticket row when `owner` and `forUser` were selected (host/admin / full ticket APIs).
- * Strict refinement of {@link TicketFlexible} — prefer narrowing with {@link isTicketExt}.
+ * Strict refinement of {@link TicketFlexible}. Prefer narrowing with {@link isTicketExt}.
  */
 export type TicketExt = TicketFlexible & {
   owner: PublicUser;
@@ -2023,7 +2023,7 @@ export const CHECKOUT_DATA_TO_INCLUDE = {
   },
 } satisfies Prisma.CheckoutInclude;
 
-/** Checkout list for non-privileged viewers — buyer email omitted on `owner`. */
+/** Checkout list for non-privileged viewers. Buyer email omitted on `owner`. */
 export const CHECKOUT_DATA_TO_INCLUDE_TEASER_OWNER = {
   owner: {
     select: PUBLIC_TEASER_USER_DATA_TO_SELECT,
@@ -2142,11 +2142,11 @@ type PublicUserBase = Prisma.UserGetPayload<{
   select: typeof FRONT_END_USER_DATA_TO_SELECT;
 }>;
 
-/** Real `User` select shape for public profile surfaces — derived via `GetPayload` (like `PublicTeaserUser`)
+/** Real `User` select shape for public profile surfaces. Derived via `GetPayload` (like `PublicTeaserUser`)
  * so relation/computed fields (e.g. `reviews`, `contacts`) can't silently drift from what
  * `FRONT_END_USER_DATA_TO_SELECT` actually queries. The four relation fields below stay optional (not
- * required-but-nullable, as a strict `GetPayload` would make them) because some call sites — e.g. auth/session
- * flows — legitimately pass a scalar-only `User` row through this type without ever including them.
+ * required-but-nullable, as a strict `GetPayload` would make them) because some call sites. E.g. auth/session
+ * flows. Legitimately pass a scalar-only `User` row through this type without ever including them.
  * `reviews` is additionally re-widened to a union since some call sites merge in
  * `USER_DATA_SELECT_REVIEWS_COMMENTS` for nested review comments. */
 export type PublicUser = Omit<
@@ -2162,7 +2162,7 @@ export type PublicUser = Omit<
     reviews?: (PublicUserPlainReview | PublicUserReviewWithComments)[] | null;
   };
 
-/** Self-account (`/me`) select shape — derived via `GetPayload` the same way `PublicUser` is. */
+/** Self-account (`/me`) select shape. Derived via `GetPayload` the same way `PublicUser` is. */
 export type PrivateUser = Prisma.UserGetPayload<{
   select: typeof PRIVATE_USER_ACCOUNT_TO_SELECT;
 }>;

package/src/fundingMeter.ts

@@ -1,5 +1,5 @@
 /**
- * Public funding meter contract — value coming in toward included budget lines.
+ * Public funding meter contract. Value coming in toward included budget lines.
  * Consumers may copy these types until this package is published with this module.
  */
 

package/src/giveaway.ts

@@ -1,5 +1,5 @@
 /**
- * Event giveaways — shared types, attendee identity, and guest-facing copy.
+ * Event giveaways. Shared types, attendee identity, and guest-facing copy.
  * Qualifying does not guarantee inventory (first-come among eligible people).
  */
 
@@ -173,7 +173,7 @@ export function matchesCompetitionParticipant(input: {
   });
 }
 
-/** Active outstanding inventory — not historical "ever distributed". */
+/** Active outstanding inventory. Not historical "ever distributed". */
 export function giveawayActiveDistributedCount(
   quantityTotal: number,
   quantityRemaining: number

package/src/guestPartySize.ts

@@ -60,7 +60,7 @@ export function guestPartyPolicyLabel(
 export function rsvpPartyPolicyGuestCopy(
   maxAdditionalGuests: number | null | undefined
 ): string {
-  if (maxAdditionalGuests === 0) return "Just you — no plus-ones";
+  if (maxAdditionalGuests === 0) return "Just you. No plus-ones";
   if (maxAdditionalGuests === 1) return "You can bring up to 1 guest";
   if (maxAdditionalGuests === 2) return "You can bring up to 2 guests";
   return `You can bring up to ${RSVP_PLUS_ONES_UI_SOFT_CAP} guests`;
@@ -78,6 +78,6 @@ export function ticketPartyPolicyGuestCopy(
 
 export function nearCapacityPartyError(spotsLeft: number): string {
   if (spotsLeft <= 0) return "This bash is at capacity.";
-  if (spotsLeft === 1) return "Only 1 spot left — you can’t bring that many guests.";
-  return `Only ${spotsLeft} spots left — you can’t bring that many guests.`;
+  if (spotsLeft === 1) return "Only 1 spot left. You can’t bring that many guests.";
+  return `Only ${spotsLeft} spots left. You can’t bring that many guests.`;
 }

package/src/home.ts

@@ -1,5 +1,5 @@
 /**
- * Lightweight entry for homepage / event card surfaces — avoids pulling the full
+ * Lightweight entry for homepage / event card surfaces. Avoids pulling the full
  * bash-common barrel (and its Prisma enum surface) into the mobile critical path.
  *
  * Re-exports only from canonical modules (definitions, extendedSchemas, geo utils),

package/src/homepageSyntheticRows.ts

@@ -1,6 +1,6 @@
 import { DISCOVERY_SCOPE_ROW_KEYS } from "./discoveryScope.js";
 
-/** Algorithm / geo / social rows — not host-picked `BashEventType` values. */
+/** Algorithm / geo / social rows. Not host-picked `BashEventType` values. */
 export const HOMEPAGE_DISCOVERY_SYNTHETIC_ROW_KEYS = [
   "Featured",
   "Popular",
@@ -27,5 +27,5 @@ export function isHomepageSyntheticSectionRowKey(key: string): boolean {
   );
 }
 
-/** @deprecated Prefer `HOMEPAGE_DISCOVERY_SYNTHETIC_ROW_KEYS` — kept for app imports. */
+/** @deprecated Prefer `HOMEPAGE_DISCOVERY_SYNTHETIC_ROW_KEYS`. Kept for app imports. */
 export const HOMEPAGE_DISCOVERY_ROW_KEYS = HOMEPAGE_DISCOVERY_SYNTHETIC_ROW_KEYS;

package/src/hostCrmAutomation.ts

@@ -4,7 +4,7 @@ import type {
   HostCrmAutomationTrigger as HostCrmAutomationTriggerEnum,
 } from "@prisma/client";
 
-/** Mirrors Prisma `HostCrmAutomationTrigger` — `@prisma/client` browser bundle omits runtime enum exports. */
+/** Mirrors Prisma `HostCrmAutomationTrigger`. `@prisma/client` browser bundle omits runtime enum exports. */
 export const HostCrmAutomationTrigger = {
   Recurring: "Recurring",
   NewlyAtRisk: "NewlyAtRisk",
@@ -13,7 +13,7 @@ export const HostCrmAutomationTrigger = {
 
 export type HostCrmAutomationTrigger = HostCrmAutomationTriggerEnum;
 
-/** Mirrors Prisma `HostCrmAutomationChannel` — `@prisma/client` browser bundle omits runtime enum exports. */
+/** Mirrors Prisma `HostCrmAutomationChannel`. `@prisma/client` browser bundle omits runtime enum exports. */
 export const HostCrmAutomationChannel = {
   Email: "Email",
   Sms: "Sms",
@@ -21,7 +21,7 @@ export const HostCrmAutomationChannel = {
 
 export type HostCrmAutomationChannel = HostCrmAutomationChannelEnum;
 
-/** Mirrors Prisma `HostCrmAutomationAudienceType` — `@prisma/client` browser bundle omits runtime enum exports. */
+/** Mirrors Prisma `HostCrmAutomationAudienceType`. `@prisma/client` browser bundle omits runtime enum exports. */
 export const HostCrmAutomationAudienceType = {
   Preset: "Preset",
   Segment: "Segment",
@@ -38,7 +38,7 @@ export const HOST_CRM_AUTOMATION_MIN_CADENCE_DAYS = 1;
 export const HOST_CRM_AUTOMATION_DEFAULT_CADENCE_DAYS = 30;
 
 /**
- * API/client shape of a `HostCrmAutomation` row — dates are ISO strings (as
+ * 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`
@@ -50,7 +50,7 @@ export type HostCrmAutomation = {
   name: string;
   trigger: HostCrmAutomationTrigger;
   channel: HostCrmAutomationChannel;
-  /** Ignored for PostEvent — audience there is implicit (that event's ticket holders). */
+  /** Ignored for PostEvent. Audience there is implicit (that event's ticket holders). */
   audienceType: HostCrmAutomationAudienceType | null;
   audiencePresetId: string | null;
   audienceSegmentId: string | null;
@@ -79,7 +79,7 @@ export type HostCrmAutomationInput = {
 };
 
 /**
- * "Growth pack" — the one-click Host CRM automation pair (win-back + post-event
+ * "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.
  */
@@ -87,9 +87,9 @@ 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. */
+/** 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";
+  "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.";
 
@@ -100,15 +100,15 @@ export const HOST_CRM_WINBACK_DEFAULT_BODY =
 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. Got photos from the night? Save them to Memories, then post on BashFeed or drop them in the album:\n\nMemories: {{memoriesUrl}}\nBashFeed: {{bashFeedUrl}}\n\nHope to see you at the next one!";
+  "Hi {{firstName}},\n\nThanks so much for being part of {{eventTitle}}. It wouldn't have been the same without you. Got photos from the night? Save them to Memories, then post on BashFeed or drop them in the album:\n\nMemories: {{memoriesUrl}}\nBashFeed: {{bashFeedUrl}}\n\nHope to see you at the next one!";
 
 /** Recurring email to last-minute buyers (paid within 48h of start). */
 export const HOST_CRM_GROWTH_PACK_LATE_BUYER_PRESET_ID = "last_minute_buyer";
 export const HOST_CRM_GROWTH_PACK_LATE_BUYER_NAME = "Late-buyer logistics nudge";
 export const HOST_CRM_GROWTH_PACK_LATE_BUYER_SUBJECT =
-  "You're in — here's how to make door day smooth";
+  "You're in. Here's how to make door day smooth";
 export const HOST_CRM_GROWTH_PACK_LATE_BUYER_BODY =
-  "Hi {{firstName}},\n\nGlad you're coming. Since you grabbed tickets close to showtime, leave a few extra minutes for parking and check-in — doors can get busy.\n\nSee you there!";
+  "Hi {{firstName}},\n\nGlad you're coming. Since you grabbed tickets close to showtime, leave a few extra minutes for parking and check-in. Doors can get busy.\n\nSee you there!";
 
 type GrowthPackAutomationShape = {
   trigger: string;

package/src/hostCrmConstants.ts

@@ -1,4 +1,4 @@
-/** Per-recipient CRM email cooldown — matches SMS CRM_BLAST window. */
+/** Per-recipient CRM email cooldown. Matches SMS CRM_BLAST window. */
 export const HOST_CRM_EMAIL_COOLDOWN_MS = 48 * 60 * 60 * 1000;
 
 export const HOST_CRM_EMAIL_TEMPLATE_KEYS = {

package/src/hostCrmCrowdPulse.ts

@@ -1,8 +1,8 @@
 /**
- * Community Builder Crowd Pulse — overall + per-bash glance metrics.
+ * Community Builder Crowd Pulse. Overall + per-bash glance metrics.
  */
 
-/** Upcoming / live / past — same decision order as My Bashes guest phases. */
+/** Upcoming / live / past. Same decision order as My Bashes guest phases. */
 export type HostCrmCrowdPulseHorizon = "upcoming" | "live" | "past";
 
 /** Same fallback as schedule rendering when end is missing or invalid. */

package/src/hostCrmInsights.ts

@@ -3,8 +3,8 @@ 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
+ * 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 =
@@ -30,7 +30,7 @@ export type HostCrmInsight =
     };
 
 /**
- * Response shape for the Predictive Insights card. Gated server-side —
+ * 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.
  */

package/src/hostCrmLastBashProof.ts

@@ -1,5 +1,5 @@
 /**
- * Last-bash proof — afterglow metrics for the host's most recently ended bash.
+ * Last-bash proof. Afterglow metrics for the host's most recently ended bash.
  * Composed on the Monday Morning response (no separate analytics product).
  */
 
@@ -19,7 +19,7 @@ export type HostCrmLastBashProof = {
   ticketPeopleCount: number;
   checkedInCount: number;
   reachable: HostCrmLastBashProofReachable;
-  /** 0–100 among CRM members tied to that bash with eventCount >= 2. */
+  /** 0 to 100 among CRM members tied to that bash with eventCount >= 2. */
   repeatMemberRate: number;
   postEventMessageSent: boolean;
   postEventMessageSentAt: string | null;

package/src/hostCrmSegments.ts

@@ -29,17 +29,17 @@ export type HostCrmSegmentRules = {
   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 */
+  /** 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 */
+  /** 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 */
+  /** 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 */
+  /** 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) */
+  /** 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;
@@ -271,13 +271,13 @@ export type HostCrmAudienceMember = {
   noShowCount: number;
   /** UI label: "Uses Promo Codes" */
   discountResponsive: boolean;
-  /** UI label: "Last-Minute Buyer" — majority of purchases within 48h of the event start */
+  /** 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 */
+  /** 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 */
+  /** 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;
@@ -291,7 +291,7 @@ export type HostCrmAudienceMember = {
   associationBreakdown: HostCrmAssociationBreakdown;
   communityStrengthScore: number;
   communityStrengthTier: CommunityStrengthTier;
-  /** Rule-based suggested tags — never merged into host-editable `tags`. */
+  /** Rule-based suggested tags. Never merged into host-editable `tags`. */
   systemTags: string[];
 };
 
@@ -434,7 +434,7 @@ export const HOST_CRM_PRESET_SEGMENTS: Array<{
     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.
+    // Computed at query time from the full audience. See filterHostCrmAudience's presetId branch.
     rules: {},
   },
   {
@@ -477,7 +477,7 @@ export const HOST_CRM_PRESET_SEGMENTS: Array<{
     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.
+    // Computed at query time from the host's finished events. See filterHostCrmAudience's presetId branch.
     rules: {},
   },
 ];
@@ -520,7 +520,7 @@ export type HostCrmAttendeeDetailBadges = {
 };
 
 /**
- * Full detail payload for one attendee's drawer — the response shape for
+ * 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.

package/src/hostPromoter.ts

@@ -62,7 +62,7 @@ export function hostPromoterKindFromEventServiceSubType(
   }
 }
 
-/** Inverse of sync mapping — PromoCode has no hireable EventService subtype. */
+/** Inverse of sync mapping. PromoCode has no hireable EventService subtype. */
 export function eventServiceSubTypeFromHostPromoterKind(
   kind: HostPromoterKind | string | null | undefined
 ): HostPromoterSyncServiceSubType | null {

package/src/icebreakerPrompts.ts

@@ -20,7 +20,7 @@ export const ICEBREAKER_PROMPTS: string[] = [
   "What are you most looking forward to at this event?",
   "If this bash had a theme song, what would it be?",
   "What’s one thing you hope to take away from tonight?",
-  "Who here do you already know—and how did you meet?",
+  "Who here do you already know. And how did you meet?",
   "What’s your favorite thing about gatherings like this?",
   "If you could add one activity to this event, what would it be?",
   "What’s a memory from a past party you still think about?",
@@ -36,7 +36,7 @@ export const ICEBREAKER_PROMPTS: string[] = [
   "What’s a trend you don’t get but respect?",
   "What’s your go-to karaoke song (or what would it be)?",
   "What’s something everyone likes but you’re lukewarm on?",
-  "What’s a nickname you’ve had—or wish you had?",
+  "What’s a nickname you’ve had. Or wish you had?",
   // Nostalgia
   "What’s a childhood snack or meal you still crave?",
   "What’s the first concert or live event you remember?",

package/src/index.ts

@@ -471,7 +471,7 @@ export type {
     MakeRequired, Override, RemoveCommonProperties, UnionFromArray
 } from "./utils/typeUtils.js";
 
-// Promoter Competition utilities (pure — safe to import in bash-app and api)
+// Promoter Competition utilities (pure. Safe to import in bash-app and api)
 export {
   computePromoterCompetitionEconomics,
   formatPromoterRewardLabel,