@bash-app/bash-common 30.423.0 → 30.425.0

package/src/utils/service/apiServiceBookingApiUtils.ts

@@ -328,7 +328,7 @@ export function servicePriceToBookToApiBookingBase({
     packages: packages as ServiceBookingPackageExt[],
     allowPromiseToPay: allowPromiseToPay,
     isFreeGuest: isFreeGuest,
-    // Phase 3 — providers opt in per-booking when they want BP-paid tickets
+    // Phase 3. Providers opt in per-booking when they want BP-paid tickets
     // to count toward PER_PAID_ATTENDEE settlement. Defaults to false so
     // legacy bookings keep their original counting semantics.
     countsBashPointsTickets: false,

package/src/utils/service/billingCapUtils.ts

@@ -1,10 +1,10 @@
 /**
- * Phase 0 adoption guardrails — host-side soft cap on variable-pricing bookings.
+ * Phase 0 adoption guardrails. Host-side soft cap on variable-pricing bookings.
  *
  * Any booking whose `pricingModel` is not flat/hourly/daily can run up the host's
  * tab if turnout exceeds expectations. `maxBillableCents` lets the host put a
  * dollar ceiling on each booking. The default ceiling is `1.5x` of
- * `expectedAttendees * baseRateCents`, rounded up to the nearest $10 — generous
+ * `expectedAttendees * baseRateCents`, rounded up to the nearest $10. Generous
  * enough that hosts almost never trip it on a good night, but tight enough to
  * protect against a runaway viral bash.
  *
@@ -49,7 +49,7 @@ export interface DefaultMaxBillableCentsInput {
  * Computes the default Phase 0 soft cap for a variable-pricing booking.
  *
  * Returns `null` when `baseRateCents` is unusable. Returns `0` when
- * `expectedAttendees` is zero or absent — caller decides whether that means
+ * `expectedAttendees` is zero or absent. Caller decides whether that means
  * "skip the cap" (free / comp-only bash) or "force the host to set one explicitly".
  *
  * Worked example: 200 expected attendees @ $5 each → 200 * 500 * 1.5 = $1500 →
@@ -83,7 +83,7 @@ export function defaultMaxBillableCents(
 }
 
 /**
- * Parallel cap for `PER_BASHPOINTS_ATTENDEE` bookings — same formula, BashPoints
+ * Parallel cap for `PER_BASHPOINTS_ATTENDEE` bookings. Same formula, BashPoints
  * units. Rounds up to the nearest 100 BashPoints by default since BashPoints
  * are integer-only.
  */
@@ -118,7 +118,7 @@ export function defaultMaxBillableBashPoints(input: {
 
 /**
  * Default snippet to snapshot onto `ServiceBooking.payoutTimingNote` at booking
- * time for any variable-pricing booking. Keep concise — surfaces in offer
+ * time for any variable-pricing booking. Keep concise. Surfaces in offer
  * sheets, booking detail, and email summaries.
  */
 export const DEFAULT_VARIABLE_PAYOUT_TIMING_NOTE =

package/src/utils/service/cancellationPolicyRefundResolver.ts

@@ -21,7 +21,7 @@ export function cancellationRuleThresholdHours(
 }
 
 export type ResolveCancellationRefundOptions = {
-  /** Event start time (UTC or local — caller must be consistent). */
+  /** Event start time (UTC or local. Caller must be consistent). */
   eventStart: Date;
   /** Defaults to `new Date()`. */
   now?: Date;

package/src/utils/service/eventPromoterUtils.ts

@@ -25,7 +25,7 @@ import {
  *
  * Compared with the **string literal** rather than the Prisma enum object
  * because the browser bundle (`index-browser`) does not always re-export
- * Prisma enums as runtime values — see `bash-common/src/mirroredPrismaEnums.ts`
+ * Prisma enums as runtime values. See `bash-common/src/mirroredPrismaEnums.ts`
  * for the same pattern.
  */
 export function isPerAttendeeLockedPromotionSubType(
@@ -65,7 +65,7 @@ export const EVENT_PROMOTER_LATE_CANCEL_HOURS = 48;
 /**
  * Late-cancellation penalty as a fraction of the deposit (0..1). 0.25 means
  * the host forfeits 25% of the deposit when they cancel inside the
- * `EVENT_PROMOTER_LATE_CANCEL_HOURS` window — covers the promoter's
+ * `EVENT_PROMOTER_LATE_CANCEL_HOURS` window. Covers the promoter's
  * sunk planning time.
  */
 export const EVENT_PROMOTER_LATE_CANCEL_PENALTY_FRACTION = 0.25;
@@ -75,11 +75,11 @@ export type EventPromoterCanceller = "host" | "promoter" | "admin";
 
 export interface EventPromoterCancellationInput {
   who: EventPromoterCanceller;
-  /** ISO timestamp of "now" — injected so callers can test edge cases. */
+  /** ISO timestamp of "now". Injected so callers can test edge cases. */
   nowMs: number;
   /** Bash start time. */
   bashStartMs: number | null;
-  /** Bash end time — once we're past this, settlement takes over instead. */
+  /** Bash end time. Once we're past this, settlement takes over instead. */
   bashEndMs: number | null;
   /** Deposit cents already charged at booking. */
   depositCents: number;
@@ -92,12 +92,12 @@ export interface EventPromoterCancellationDecision {
   allow: boolean;
   /**
    * Outcome category for telemetry + thread messaging:
-   * - `FullRefund` — full deposit returned (host cancel outside window, or
+   * - `FullRefund`. Full deposit returned (host cancel outside window, or
    *   promoter cancel any time before the bash).
-   * - `PartialRefund` — host cancels inside the late-cancel window; promoter
+   * - `PartialRefund`. Host cancels inside the late-cancel window; promoter
    *   keeps `EVENT_PROMOTER_LATE_CANCEL_PENALTY_FRACTION` of the deposit.
-   * - `NoRefund` — bash already happened; settlement handles it instead.
-   * - `Blocked` — booking already settled, or impossible state; admin only.
+   * - `NoRefund`. Bash already happened; settlement handles it instead.
+   * - `Blocked`. Booking already settled, or impossible state; admin only.
    */
   outcome: "FullRefund" | "PartialRefund" | "NoRefund" | "Blocked";
   /** Refund amount in cents (0 when outcome is NoRefund/Blocked). */
@@ -136,7 +136,7 @@ export function decideEventPromoterCancellation(
       outcome: "Blocked",
       refundCents: 0,
       penaltyFraction: 0,
-      reason: "Booking already settled — cancellation no longer applies.",
+      reason: "Booking already settled. Cancellation no longer applies.",
     };
   }
 
@@ -157,7 +157,7 @@ export function decideEventPromoterCancellation(
         outcome: "NoRefund",
         refundCents: 0,
         penaltyFraction: 0,
-        reason: "Admin cancel after bash started — settlement handles money.",
+        reason: "Admin cancel after bash started. Settlement handles money.",
       };
     }
     return {
@@ -165,7 +165,7 @@ export function decideEventPromoterCancellation(
       outcome: "FullRefund",
       refundCents: input.depositCents,
       penaltyFraction: 0,
-      reason: "Admin cancel — full refund of deposit.",
+      reason: "Admin cancel. Full refund of deposit.",
     };
   }
 
@@ -177,7 +177,7 @@ export function decideEventPromoterCancellation(
         refundCents: 0,
         penaltyFraction: 0,
         reason:
-          "Bash already started — promoter must coordinate with host in the thread, not auto-cancel.",
+          "Bash already started. Promoter must coordinate with host in the thread, not auto-cancel.",
       };
     }
     return {
@@ -186,7 +186,7 @@ export function decideEventPromoterCancellation(
       refundCents: input.depositCents,
       penaltyFraction: 0,
       reason:
-        "Promoter cancelled — full refund of host deposit. Bash notifies the host and re-opens the slot.",
+        "Promoter cancelled. Full refund of host deposit. Bash notifies the host and re-opens the slot.",
     };
   }
 
@@ -198,7 +198,7 @@ export function decideEventPromoterCancellation(
       refundCents: 0,
       penaltyFraction: 0,
       reason:
-        "Bash already in progress or over — the post-event settlement will calculate any refund automatically.",
+        "Bash already in progress or over. The post-event settlement will calculate any refund automatically.",
     };
   }
 
@@ -208,7 +208,7 @@ export function decideEventPromoterCancellation(
       outcome: "FullRefund",
       refundCents: input.depositCents,
       penaltyFraction: 0,
-      reason: `Host cancelled with more than ${EVENT_PROMOTER_LATE_CANCEL_HOURS}h notice — full refund of deposit.`,
+      reason: `Host cancelled with more than ${EVENT_PROMOTER_LATE_CANCEL_HOURS}h notice. Full refund of deposit.`,
     };
   }
 
@@ -222,7 +222,7 @@ export function decideEventPromoterCancellation(
     outcome: "PartialRefund",
     refundCents,
     penaltyFraction,
-    reason: `Host cancelled inside the ${EVENT_PROMOTER_LATE_CANCEL_HOURS}h window — promoter keeps ${Math.round(
+    reason: `Host cancelled inside the ${EVENT_PROMOTER_LATE_CANCEL_HOURS}h window. Promoter keeps ${Math.round(
       penaltyFraction * 100
     )}% of the deposit to cover planning time.`,
   };
@@ -240,7 +240,7 @@ export const EVENT_PROMOTER_LOCKED_PRICING_MODEL: PricingModel =
   "PER_ATTENDEE";
 
 /**
- * Phase 3 — set of pricing models the locked Event Promoter subtype may use.
+ * Phase 3. Set of pricing models the locked Event Promoter subtype may use.
  * Any of these guarantees a per-head settlement at bash close, which is the
  * actual constraint the worker cares about. Wizard offers them as a choice;
  * api validator accepts any.
@@ -319,7 +319,7 @@ export interface EventPromoterSettlementInput {
   totalCheckedInAttendees: number;
   /** Per-booking host-set ceiling on attributable attendees; `null` = no cap. */
   maxAttendeesAttributable?: number | null;
-  /** Optional floor — usually `EventService.minimumQuantity` at booking time. */
+  /** Optional floor. Usually `EventService.minimumQuantity` at booking time. */
   minimumQuantity?: number | null;
 }
 
@@ -331,7 +331,7 @@ export interface EventPromoterSettlementResult {
   finalCount: number;
   /**
    * True iff `maxAttendeesAttributable` capped `finalCount`. Useful for
-   * analytics — high `ceilingHit` rates signal v2 (per-ticket attribution).
+   * analytics. High `ceilingHit` rates signal v2 (per-ticket attribution).
    */
   ceilingHit: boolean;
   /**
@@ -393,18 +393,18 @@ export function computeEventPromoterSettlement(
 }
 
 // --------------------------------------------------------------------------
-// Phase 3 — PER_PAID_ATTENDEE + PER_BASHPOINTS_ATTENDEE settlement helpers.
+// Phase 3. PER_PAID_ATTENDEE + PER_BASHPOINTS_ATTENDEE settlement helpers.
 // --------------------------------------------------------------------------
 
 /**
  * Which checked-in attendees count toward the settlement headcount?
  *
- * - `AllCheckedIn` — every checked-in, non-comp guest (legacy PER_ATTENDEE).
- * - `PaidUsdOnly` — only guests on USD-priced tiers (PER_PAID_ATTENDEE without
+ * - `AllCheckedIn`. Every checked-in, non-comp guest (legacy PER_ATTENDEE).
+ * - `PaidUsdOnly`. Only guests on USD-priced tiers (PER_PAID_ATTENDEE without
  *   `countsBashPointsTickets`).
- * - `PaidBpOnly` — only guests on BashPoints-priced tiers
+ * - `PaidBpOnly`. Only guests on BashPoints-priced tiers
  *   (PER_BASHPOINTS_ATTENDEE).
- * - `PaidAny` — paid guests on either currency
+ * - `PaidAny`. Paid guests on either currency
  *   (PER_PAID_ATTENDEE with `countsBashPointsTickets = true`).
  */
 export type EventPromoterCountingBasis =
@@ -477,7 +477,7 @@ export interface EventPromoterMixedSettlementInput {
   expectedBpAttendeesAtBooking?: number | null;
   /** Snapshots from the bash checkout (see `EventPromoterAttendeeSnapshots`). */
   snapshots: EventPromoterAttendeeSnapshots;
-  /** Optional ceilings — separate caps for USD and BP. */
+  /** Optional ceilings. Separate caps for USD and BP. */
   maxUsdAttendeesAttributable?: number | null;
   maxBpAttendeesAttributable?: number | null;
   /** Optional dollar cap on USD side (from `maxBillableCents`). */
@@ -568,7 +568,7 @@ export function computeEventPromoterMixedSettlement(
 }
 
 // --------------------------------------------------------------------------
-// Phase 3 — BashPoints payout source resolver (pool-then-wallet).
+// Phase 3. BashPoints payout source resolver (pool-then-wallet).
 // --------------------------------------------------------------------------
 
 export type BashPointsPayoutSourceValue = "HostWallet" | "BashBpPool";
@@ -596,7 +596,7 @@ export interface BashPointsPayoutResolverResult {
   fromWalletBp: number;
   /** BP that could NOT be sourced (resulting failure → dunning). */
   shortfallBp: number;
-  /** True when fromWalletBp > 0 — used to surface UI / push notifications. */
+  /** True when fromWalletBp > 0. Used to surface UI / push notifications. */
   walletDebited: boolean;
 }
 

package/src/utils/service/foodAndBeverageQuote.ts

@@ -6,7 +6,7 @@
  *  - Headcount floors at minimumQuantity if set.
  *  - Dollar total floors at minimumChargeCents if set.
  *  - Packages and add-ons still stack on top.
- *  - No check-in true-up (promoter settlement) — headcount is snapshotted
+ *  - No check-in true-up (promoter settlement). Headcount is snapshotted
  *    at booking time only.
  *
  * Keep this module pure (no Prisma, no React). Import it in bash-app, api,
@@ -45,7 +45,7 @@ export const FOOD_AND_BEVERAGE_SUBTYPES = new Set([
 ]);
 
 /**
- * Custom-order celebration cakes — consultation, serving-size packages,
+ * Custom-order celebration cakes. Consultation, serving-size packages,
  * pickup/delivery. Not a dessert station (DessertBar) and not per-guest catering.
  */
 export function isCelebrationCakeEventService(opts: {
@@ -55,7 +55,7 @@ export function isCelebrationCakeEventService(opts: {
 }
 
 /**
- * Charcuterie boards and grazing tables — board/table packages, not per-guest catering.
+ * Charcuterie boards and grazing tables. Board/table packages, not per-guest catering.
  */
 export function isGrazingTableEventService(opts: {
   eventServiceSubType?: string | null;
@@ -64,7 +64,7 @@ export function isGrazingTableEventService(opts: {
 }
 
 /**
- * Wedding / ceremony officiant. Hosting Support — not F&B, not Entertainment Emcee.
+ * Wedding / ceremony officiant. Hosting Support. Not F&B, not Entertainment Emcee.
  */
 export function isOfficiantEventService(opts: {
   eventServiceSubType?: string | null;
@@ -88,7 +88,7 @@ export function isPackagePricedFoodEventService(opts: {
 }
 
 /**
- * Return true when a listing is an F&B EventService — either by top-level
+ * Return true when a listing is an F&B EventService. Either by top-level
  * type or by subtype string (for legacy/alias safety).
  */
 export function isFoodAndBeverageEventService(opts: {
@@ -102,7 +102,7 @@ export function isFoodAndBeverageEventService(opts: {
 }
 
 /**
- * Per-guest F&B only. Cake and grazing use packages — never this path.
+ * Per-guest F&B only. Cake and grazing use packages. Never this path.
  */
 export function isPerGuestFoodAndBeverageEventService(opts: {
   eventServiceType?: string | null;
@@ -155,7 +155,7 @@ export const FULFILLMENT_MODE_LABEL: Record<FoodAndBeverageFulfillmentMode, stri
 /**
  * Suggested menu category chips shown in the wizard and on the listing.
  * Providers can add custom values; these are just pre-populated starting points.
- * Not SKUs — no flavors, quantities, or prices here.
+ * Not SKUs. No flavors, quantities, or prices here.
  */
 export const FB_MENU_CATEGORY_SUGGESTIONS: Record<string, readonly string[]> = {
   Caterer: [
@@ -283,7 +283,7 @@ export function quotedGuestCount(
  *  2. Compute rate total: baseRateCents × quotedGuests
  *  3. Floor at minimumChargeCents
  *
- * Packages and add-ons are NOT included here — they are added on top by
+ * Packages and add-ons are NOT included here. They are added on top by
  * frontendServiceBookingUtils (same as for all other service types).
  */
 export function foodAndBeverageQuoteCents({

package/src/utils/service/offerAllowListUtils.ts

@@ -1,5 +1,5 @@
 /**
- * Phase 4 of the unified-pricing roadmap — host-side pricing-model allow-list
+ * Phase 4 of the unified-pricing roadmap. Host-side pricing-model allow-list
  * validation.
  *
  * Each vertical request entity (`VendorBookingRequest`,

package/src/utils/service/offerComparisonUtils.ts

@@ -1,5 +1,5 @@
 /**
- * Phase 5 of the unified-pricing roadmap — pure projection of a `ServiceBookingOffer`
+ * Phase 5 of the unified-pricing roadmap. Pure projection of a `ServiceBookingOffer`
  * candidate into expected / worst-case / best-case totals (in cents).
  *
  * Used by:
@@ -10,17 +10,17 @@
  *     host's expected attendees and any host-side caps.
  *
  * Heuristics for `worstCaseCents` / `bestCaseCents`:
- *   - `FLAT_FEE` / `HOURLY` / `PER_DAY` / `CUSTOM` — all three bands equal the
+ *   - `FLAT_FEE` / `HOURLY` / `PER_DAY` / `CUSTOM`. All three bands equal the
  *     expected total (no variability).
- *   - `PER_ATTENDEE` / `PER_PAID_ATTENDEE` — worst case = floor (minimumQuantity
+ *   - `PER_ATTENDEE` / `PER_PAID_ATTENDEE`. Worst case = floor (minimumQuantity
  *     * baseRateCents, capped by minimumChargeCents); best case = capped to
  *     `maxBillableCents` when present, else `expectedAttendees * 1.5`.
- *   - `PER_BASHPOINTS_ATTENDEE` — same shape but in BashPoints, so we surface
+ *   - `PER_BASHPOINTS_ATTENDEE`. Same shape but in BashPoints, so we surface
  *     `expectedTotalBp` and the USD bands return null.
- *   - `TICKET_REVENUE_PERCENTAGE` / `PRODUCT_SALES_PERCENTAGE` — caller passes
+ *   - `TICKET_REVENUE_PERCENTAGE` / `PRODUCT_SALES_PERCENTAGE`. Caller passes
  *     an `expectedBasisCents` (usually the bash's projected ticket revenue or
  *     vendor gross sales). Worst case = 0 if pre-sale, best case = basis * pct.
- *   - `TIERED` — worst case = lowest tier price, best case = highest tier
+ *   - `TIERED`. Worst case = lowest tier price, best case = highest tier
  *     price; expected resolves via the supplied `tieredExpectedTierCents`.
  */
 import type { PricingModel } from "@prisma/client";
@@ -99,7 +99,7 @@ export function computeOfferComparisonBands(
         reasoning:
           total > 0
             ? `Fixed price: you pay ${fmt(total)} regardless of turnout.`
-            : "Fixed price — provider has not set a rate.",
+            : "Fixed price. Provider has not set a rate.",
       };
     }
 
@@ -190,7 +190,7 @@ export function computeOfferComparisonBands(
         expectedTotalBp: null,
         worstCaseBp: null,
         bestCaseBp: null,
-        reasoning: `Unrecognized pricing model "${input.pricingModel}" — treated as flat.`,
+        reasoning: `Unrecognized pricing model "${input.pricingModel}". Treated as flat.`,
       };
     }
   }

package/src/utils/service/serviceBookingExposureUtils.ts

@@ -1,11 +1,11 @@
 /**
- * Phase 0 adoption guardrails — aggregate cost exposure for a bash's service
+ * Phase 0 adoption guardrails. Aggregate cost exposure for a bash's service
  * bookings. Pure functions so the api endpoint (Prisma query, then this util)
  * and bash-app (display) share one source of truth.
  *
  * Each booking resolves to:
- *   - `expectedCents` — the most-likely total at expected attendance.
- *   - `worstCaseCents` — the dollar ceiling if the host's caps trip. For flat
+ *   - `expectedCents`. The most-likely total at expected attendance.
+ *   - `worstCaseCents`. The dollar ceiling if the host's caps trip. For flat
  *     models this equals `expectedCents` (no variance). For variable models it
  *     equals `maxBillableCents` if set; otherwise `1.5x expected` (matches the
  *     `defaultMaxBillableCents` heuristic in `billingCapUtils.ts`).
@@ -41,7 +41,7 @@ export interface ServiceBookingExposureInput {
   label: string;
   /**
    * The pricing model from the booked service's subtype, if known. Phase 0
-   * bookings that predate the unified block pass `null` — exposure falls
+   * bookings that predate the unified block pass `null`. Exposure falls
    * back to flat-rate math.
    */
   pricingModel?: string | null;
@@ -63,7 +63,7 @@ export interface ServiceBookingExposureInput {
    */
   maxBillableCents?: number | null;
   /**
-   * The booking's grand total (cents) when it was confirmed — used as the
+   * The booking's grand total (cents) when it was confirmed. Used as the
    * fallback "expected" amount for non-variable bookings whose pricing model
    * isn't yet tracked. Mirrors `ServiceBooking.totalATBCents`.
    */
@@ -92,7 +92,7 @@ export interface AggregateExposureSummary {
   /** Sum of `worstCaseCents` across all bookings (cents). */
   worstCaseTotalCents: number;
   /**
-   * Per-booking breakdown — preserves input order so callers can render rows
+   * Per-booking breakdown. Preserves input order so callers can render rows
    * alongside the booking list without re-sorting.
    */
   byBooking: ServiceBookingExposure[];
@@ -124,7 +124,7 @@ export function isVariablePricingModel(
  * - TICKET_REVENUE_PERCENTAGE / PRODUCT_SALES_PERCENTAGE / TIERED / CUSTOM:
  *     expected = totalATBCents ?? 0
  *     worst    = maxBillableCents ?? expected * 1.5 (variance unknown without
- *                 settlement basis math — see Phase 2 for venue rev-share).
+ *                 settlement basis math. See Phase 2 for venue rev-share).
  * - FLAT_FEE / HOURLY / PER_DAY (or null pricingModel): flat → expected = worst.
  */
 export function computeServiceBookingExposure(
@@ -162,7 +162,7 @@ export function computeServiceBookingExposure(
   if (isAttendeeDriven) {
     expected = expectedAttendees * baseRate;
   } else {
-    // Revenue-share / tiered / custom — totalATBCents is the most we know.
+    // Revenue-share / tiered / custom. TotalATBCents is the most we know.
     expected = Math.max(0, flatFallback);
   }
 

package/src/utils/service/serviceBookingTypes.ts

@@ -64,11 +64,11 @@ export type ServiceBookingRequiredData = MakeNullablePropsOptional<
     | "creatorId"
     | "creator"
     | "checkout"
-    // Event Promoter settlement fields — DB applies defaults at creation,
+    // Event Promoter settlement fields. DB applies defaults at creation,
     // so callers building a new booking shape may omit them.
     | "settlementStatus"
     | "settlementAttempts"
-    // Reschedule lifecycle — DB defaults `rescheduleStatus` to None; the rest are
+    // Reschedule lifecycle. DB defaults `rescheduleStatus` to None; the rest are
     // nullable and set only when a host moves the date.
     | "rescheduleStatus"
   >

package/src/utils/service/serviceFeaturedSortUtils.ts

@@ -35,7 +35,7 @@ function isActiveFeatured(s: FeaturedServiceSortable, now: Date): boolean {
 
 /**
  * Tier 0 = paid / admin / membership feature, 1 = AutoNewService, 2 = unfeatured
- * (or featured but with no reason recorded — these existed before the migration
+ * (or featured but with no reason recorded. These existed before the migration
  * and are treated as "legacy featured" sitting just below auto-features).
  */
 function featuredTier(s: FeaturedServiceSortable, now: Date): number {
@@ -69,7 +69,7 @@ export function compareFeaturedServices(
     if (ta < 3) {
       const fa = toMs(a.featuredAt);
       const fb = toMs(b.featuredAt);
-      if (fa !== fb) return fa - fb; // ASC — earliest paid wins
+      if (fa !== fb) return fa - fb; // ASC. Earliest paid wins
     }
 
     return toMs(b.createdAt) - toMs(a.createdAt); // DESC for non-featured / tie-break

package/src/utils/service/serviceListingMediaUtils.ts

@@ -26,7 +26,7 @@ export function isOwnerProfileListingImageUrl(
   return profileUrls.some((profileUrl) => profileUrl === normalized);
 }
 
-/** Gallery images suitable for public service cards — excludes videos and profile avatars. */
+/** Gallery images suitable for public service cards. Excludes videos and profile avatars. */
 export function filterServiceListingMedia(
   service: Pick<ServiceExt, "media"> & { owner?: ServiceListingOwner }
 ): Media[] {
@@ -45,7 +45,7 @@ export function filterServiceListingMedia(
  * Resolve the still image for browse cards and list heroes.
  *
  * Prefers `coverPhoto`, then the first gallery image. Supporting videos in
- * `media` are never used — cards must not autoplay performance clips.
+ * `media` are never used. Cards must not autoplay performance clips.
  */
 export function resolveServiceListingImage(
   service: Pick<ServiceExt, "coverPhoto" | "media"> & {

package/src/utils/service/serviceUtils.ts

@@ -245,7 +245,7 @@ function generateDescription(
  * Vendor cancellation policy copy shown in the service wizard. Hosts send
  * **booking requests**; after acceptance and payment, the vendor's obligation
  * is a **verified booking**. Use "verified booking" for vendor-initiated
- * cancellation—never "booking request" in this generator.
+ * cancellation. Never "booking request" in this generator.
  */
 function generateVendorDescription(
   refundPolicy: ServiceCancellationRefundPolicy[]
@@ -691,7 +691,7 @@ export const serviceSpecificInfoAI = {
       isArray: true,
     },
     goodsOrServices: {
-      description: `goodsOrServices (array of specific items offered — e.g. "Donuts", "Coffee", "Glazed doughnuts", not just category names). When the user names a famous brand, infer typical menu or product lines for that brand.`,
+      description: `goodsOrServices (array of specific items offered. E.g. "Donuts", "Coffee", "Glazed doughnuts", not just category names). When the user names a famous brand, infer typical menu or product lines for that brand.`,
       example: `["Donuts", "Coffee", "Seasonal flavors"]`,
       type: "string",
       isArray: true,

package/src/utils/service/unifiedPricingResolver.ts

@@ -1,10 +1,10 @@
 /**
- * Phase 6 of the unified-pricing roadmap — forward-looking dual-read.
+ * Phase 6 of the unified-pricing roadmap. Forward-looking dual-read.
  *
  * Reads the unified pricing block from whichever subtype owns it (EventService,
  * Vendor, Exhibitor, Sponsor, Venue, EntertainmentService, VolunteerService),
  * then falls back to the legacy `ServiceRate` row pinned on the service if the
- * unified block is null. Plain object passing only — no Prisma client calls,
+ * unified block is null. Plain object passing only. No Prisma client calls,
  * no fetches, no I/O.
  *
  * Use this from the booking + checkout paths so existing data keeps working
@@ -21,7 +21,7 @@ export interface UnifiedPricingBlock {
   rateUnit: string | null;
   minimumChargeCents: number | null;
   minimumQuantity: number | null;
-  /** Json — keep `unknown` so callers narrow at use sites. */
+  /** Json. Keep `unknown` so callers narrow at use sites. */
   tierPricing: unknown;
   pricingNotes: string | null;
   /** True iff this came from a unified block (vs the legacy ServiceRate). */
@@ -39,7 +39,7 @@ export interface UnifiedPricingSourceCandidates {
   venue?: PartialPricingBlock | null;
   entertainmentService?: PartialPricingBlock | null;
   volunteerService?: PartialPricingBlock | null;
-  /** Legacy fallback — the active `ServiceRate` row. */
+  /** Legacy fallback. The active `ServiceRate` row. */
   legacyRate?: LegacyServiceRateShape | null;
 }
 
@@ -55,7 +55,7 @@ type PartialPricingBlock = {
 };
 
 type LegacyServiceRateShape = {
-  /** Legacy doesn't carry a pricing model — caller can default to FLAT_FEE. */
+  /** Legacy doesn't carry a pricing model. Caller can default to FLAT_FEE. */
   ratePerUnitCents?: number | null;
   rateUnit?: string | null;
   minimumQuantity?: number | null;

package/src/utils/service/venueSettlementUtils.ts

@@ -1,5 +1,5 @@
 /**
- * Phase 2 of the unified-pricing roadmap — pure math for Venue F&B minimums
+ * Phase 2 of the unified-pricing roadmap. Pure math for Venue F&B minimums
  * and revenue share. Pure functions only (no Prisma / no fetches) so the
  * wizard, api validators, settlement worker, and offer-suggestion AI can all
  * share one source of truth.
@@ -34,7 +34,7 @@ export const REVENUE_SHARE_BASES = [
 ] as const;
 export type RevenueShareBasis = (typeof REVENUE_SHARE_BASES)[number];
 
-/** Internal helper — cents → non-negative rounded integer. */
+/** Internal helper. Cents → non-negative rounded integer. */
 function nonNegInt(value: number): number {
   if (!Number.isFinite(value) || value <= 0) return 0;
   return Math.round(value);
@@ -63,7 +63,7 @@ export interface ResolveFBMinimumInput {
  * is used. Returns `null` if neither produces a value.
  *
  * Callers that need timezone-aware day-of-week selection should pre-shift the
- * Date before passing it in — this function uses `Date.getDay()` directly.
+ * Date before passing it in. This function uses `Date.getDay()` directly.
  */
 export function resolveFBMinimumForDate(
   input: ResolveFBMinimumInput

package/src/utils/service/volunteerCompensationUtils.ts

@@ -1,5 +1,5 @@
 /**
- * Volunteer compensation — closed-loop BashPoints stipends + on-site perks.
+ * Volunteer compensation. Closed-loop BashPoints stipends + on-site perks.
  *
  * Volunteers are NOT employees or contractors. This util intentionally avoids
  * any USD rate / wage / per-attendee math, because crossing that line would
@@ -9,7 +9,7 @@
  *   - never cashed out,
  *   - never used to settle third-party USD invoices,
  *   - only redeemable against Bash-issued goods (tickets, BashPass upgrades,
- *     premium features) — see the closed-loop BP plan.
+ *     premium features). See the closed-loop BP plan.
  *
  * Pure functions only so the wizard, api validators, and help-center page
  * share one source of truth.
@@ -119,7 +119,7 @@ export function volunteerCompensationSummary(args: {
 }): string {
   switch (args.compensationType) {
     case "None":
-      return "Pure volunteer — no stipend or perks beyond appreciation.";
+      return "Pure volunteer. No stipend or perks beyond appreciation.";
     case "BashPointsStipend":
       return `${args.bashPointsStipend ?? 0} BashPoints per ${args.rateUnit ?? "shift"}.`;
     case "PerksOnly":

package/src/utils/slugUtils.ts

@@ -85,7 +85,7 @@ export function getPublicBashDetailPath(
 }
 
 /**
- * Path to Your Memories (private vault) for a bash — nested under bash detail
+ * Path to Your Memories (private vault) for a bash. Nested under bash detail
  * (`/bash/{id}-{slug}/memories`). Requires sign-in + eligibility; not a public
  * unauthenticated recap page.
  */

package/src/utils/ticketPrintPostageUtils.ts

@@ -1,10 +1,10 @@
 /**
  * Buyer-facing surcharge for physical ticket delivery (mail-to-buyer or venue
- * will-call), both fulfilled as individually-addressed Lob postcards — one
+ * will-call), both fulfilled as individually-addressed Lob postcards. One
  * ticket = one piece, same product used by Flyer Blast's addressed mail path.
  *
  * Reuses the Lob per-piece cost table from `lobFlyerUtils.ts` rather than
- * duplicating pricing — same "verify before production" caveat applies here.
+ * duplicating pricing. Same "verify before production" caveat applies here.
  */
 
 import { TicketDeliveryMethod, TicketPrintOrderStatus } from "@prisma/client";
@@ -21,7 +21,7 @@ export function ticketPrintSurchargeCentsPerPiece(size: LobPostcardSizeKey): num
 
 /**
  * Total buyer-facing surcharge (integer cents) for `quantity` physical ticket
- * pieces of the given size — used as the Stripe checkout line item amount.
+ * pieces of the given size. Used as the Stripe checkout line item amount.
  */
 export function ticketPrintSurchargeCentsForQuantity(
   size: LobPostcardSizeKey,
@@ -32,7 +32,7 @@ export function ticketPrintSurchargeCentsForQuantity(
 }
 
 /**
- * Buyer-facing badge copy for a ticket's physical delivery status — shared by
+ * Buyer-facing badge copy for a ticket's physical delivery status. Shared by
  * My Tickets and the ticket details view so both surfaces stay in sync.
  * `null`/`undefined` (Digital) means no badge should render.
  */
@@ -52,7 +52,7 @@ export function ticketDeliveryStatusLabel(
     return "Physical ticket cancelled";
   }
   if (status === TicketPrintOrderStatus.Failed) {
-    return "Physical ticket delivery failed — contact the host";
+    return "Physical ticket delivery failed. Contact the host";
   }
   if (deliveryMethod === TicketDeliveryMethod.VenueWillCall) {
     switch (status) {