@bash-app/bash-common 30.265.0 → 30.273.0

package/prisma/schema.prisma

@@ -930,6 +930,7 @@ model BashEvent {
   bookingOffers ServiceBookingOffer[]
   promotionBlastEntitlements PromotionBlastEntitlement[]
   promotionBlasts            PromotionBlast[]
+  orgPromotionalPackages     OrgPromotionalPackage[]
 
   @@index([templateId])
   @@index([parentEventId])
@@ -1423,6 +1424,73 @@ model PromotionBlastPushDelivery {
   @@index([bashEventId])
 }
 
+// --- Org Promotional Packages (host pays org to endorse event to members) ---
+enum OrgPromotionalPackageStatus {
+  PENDING_APPROVAL
+  ACTIVE
+  COMPLETED
+  REJECTED
+  EXPIRED
+  REFUNDED
+}
+
+model OrgPromotionalPackage {
+  id        String   @id @default(cuid())
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  organizationId String
+  organization   Organization @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+  bashEventId    String
+  bashEvent      BashEvent    @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  hostUserId     String
+  hostUser       User         @relation("OrgPromoHost", fields: [hostUserId], references: [id], onDelete: Cascade)
+
+  tierId               String
+  maxReach             Int
+  orgFeeCents          Int
+  bashPlatformFeeCents Int
+  totalCents           Int
+
+  stripePaymentIntentId String @unique
+  authorizedAt          DateTime
+  capturedAt            DateTime?
+  status                OrgPromotionalPackageStatus @default(PENDING_APPROVAL)
+
+  hostNote         String?
+  orgResponseNote  String?
+  approvedByUserId String?
+  approvedBy       User?    @relation("OrgPromoApprover", fields: [approvedByUserId], references: [id], onDelete: SetNull)
+  activatedAt      DateTime?
+
+  membersNotifiedAt  DateTime?
+  notifyError        String?
+  notifyAttemptCount Int      @default(0)
+
+  deliveries OrgPromotionalDelivery[]
+
+  @@index([organizationId, status])
+  @@index([bashEventId, status])
+  @@index([hostUserId])
+  @@index([status])
+}
+
+model OrgPromotionalDelivery {
+  id        String   @id @default(cuid())
+  createdAt DateTime @default(now())
+
+  packageId String
+  package   OrgPromotionalPackage @relation(fields: [packageId], references: [id], onDelete: Cascade)
+  userId    String
+  user      User   @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  channel String
+
+  @@unique([packageId, userId, channel])
+  @@index([packageId])
+  @@index([userId])
+}
+
 /// USPS carrier-route catalog (Utah MVP; expand for national rollout).
 model PostalCarrierRoute {
   id               String  @id @default(cuid())
@@ -2794,6 +2862,9 @@ model User {
   sentBookingOffers              ServiceBookingOffer[]        @relation("OfferSender")
   receivedBookingOffers          ServiceBookingOffer[]        @relation("OfferRecipient")
   promotionBlastEntitlements     PromotionBlastEntitlement[]  @relation("PromotionBlastPartner")
+  orgPromotionalPackagesHosted OrgPromotionalPackage[]      @relation("OrgPromoHost")
+  orgPromotionalPackagesApproved OrgPromotionalPackage[]    @relation("OrgPromoApprover")
+  orgPromotionalDeliveries     OrgPromotionalDelivery[]
   promotionBlastsOwned           PromotionBlast[]             @relation("PromotionBlastOwner")
   promotionBlastsPaused          PromotionBlast[]             @relation("PromotionBlastPausedBy")
   promotionBlastRedemptions      PromotionBlastRedemption[]
@@ -3232,6 +3303,13 @@ model Contact {
   contactEmail             String?
   fullName                 String?
   phone                    String?
+  /// Mailing address line 1 (street number and name). Maps to Lob `address1`.
+  street                   String?
+  /// Mailing address line 2 (apt, suite, unit). Maps to Lob `address2`.
+  addressLine2             String?
+  city                     String?
+  state                    String?
+  zipCode                  String?
   requestToConnectSent     DateTime?
   requestToConnectAccepted DateTime?
   contactOwner             User      @relation(fields: [contactOwnerId], references: [id], onDelete: Cascade)
@@ -4175,6 +4253,10 @@ model Organization {
 
   smsSendLogs SmsSendLog[]
 
+  /// Per-tier promotional package rates for external hosts (community / spotlight / featured).
+  promotionalPackageRates Json?
+  orgPromotionalPackages  OrgPromotionalPackage[]
+
   @@index([ownerId])
   @@index([slug])
   @@index([parentOrganizationId])
@@ -7738,6 +7820,7 @@ enum CreditSourceType {
   PostAfterEvent // First BashFeed post linked to event after it ends
   ReferralCodeUsed // Flat bonus for referrer when code drives a ticket/signup
   VenueLoyaltyRedemption // BashPoints moved through a VenueLoyaltyRedemption claim/redeem/refund
+  PartnerPromoRedemption // BashPoints spent to unlock a local partner promo code
 }
 
 enum ReferralTier {
@@ -9143,21 +9226,61 @@ enum PartnerTier {
   Featured
 }
 
+enum PartnerListingType {
+  Gear
+  LocalService
+}
+
+enum LocalServiceCategory {
+  GetReady
+  WearAndStyle
+  EatAndDrink
+  Move
+  Recover
+  Wellness
+  HealthAndEssentials
+  HomeAndLife
+  ContentAndKeepsakes
+  HostShortcuts
+  PerksAndRetail
+  Other
+}
+
 model PartnerBrand {
-  id                String           @id @default(cuid())
+  id                String                @id @default(cuid())
   name              String
   logoUrl           String?
   websiteUrl        String?
-  description       String?          @db.Text
-  tier              PartnerTier      @default(Standard)
-  isActive          Boolean          @default(true)
+  description       String?               @db.Text
+  tier              PartnerTier           @default(Standard)
+  isActive          Boolean               @default(true)
   affiliateBaseUrl  String?
   listingFeeMonthly Int? // cents; null = affiliate-only
-  createdAt         DateTime         @default(now())
+  listingType       PartnerListingType    @default(Gear)
+  address           String?               @db.Text
+  phone             String?
+  citySlug          String?
+  stateSlug         String?
+  serviceTimings    String[]              @default([])
+  serviceCategory   LocalServiceCategory?
+  promoHeadline     String?
+  promoCode         String?
+  bookingUrl        String?
+  /// Weekly hours: { hours: { Monday: [{ open, close }] }, openDays: { Monday: true } }
+  businessHours     Json?
+  timezone          String?
+  latitude          Float?
+  longitude         Float?
+  bashPointsCost    Int?
+  clicks            Int                   @default(0)
+  createdAt         DateTime              @default(now())
   products          PartnerProduct[]
   adSlots           PartnerAdSlot[]
+  sourceInquiry     PartnerInquiry?
 
   @@index([isActive, tier])
+  @@index([listingType, citySlug])
+  @@index([serviceCategory])
 }
 
 model PartnerProduct {
@@ -9215,12 +9338,17 @@ model PartnerInquiry {
   website     String?
   description String               @db.Text
   categories  String[]
-  status      PartnerInquiryStatus @default(Pending)
-  adminNote   String?              @db.Text
-  createdAt   DateTime             @default(now())
-  updatedAt   DateTime             @updatedAt
+  listingType PartnerListingType   @default(Gear)
+  city        String?
+  status          PartnerInquiryStatus @default(Pending)
+  adminNote       String?              @db.Text
+  createdBrandId  String?              @unique
+  createdBrand    PartnerBrand?        @relation(fields: [createdBrandId], references: [id], onDelete: SetNull)
+  createdAt       DateTime             @default(now())
+  updatedAt       DateTime             @updatedAt
 
   @@index([status, createdAt])
+  @@index([listingType])
 }
 
 // ============================================

package/src/__tests__/statusEnums.test.ts

@@ -138,6 +138,7 @@ describe("status enum value sets", () => {
         "PostAfterEvent",
         "ReferralCodeUsed",
         "VenueLoyaltyRedemption",
+        "PartnerPromoRedemption",
       ].sort(),
     );
   });

package/src/index.ts

@@ -154,6 +154,8 @@ export {
   PrizePaymentMethod,
   PrizePaymentStatus,
   PartnerTier,
+  PartnerListingType,
+  LocalServiceCategory,
   PaymentProvider,
   PrizeType,
   ProjectorSetupFormat,
@@ -277,6 +279,8 @@ export type {
   SuggestionUpvote,
 } from "@prisma/client";
 
+export * from "./utils/localPartnerHours.js";
+export * from "./utils/eventCitySlug.js";
 export * from "./utils/addressUtils.js";
 export * from "./utils/apiUtils.js";
 export * from "./utils/arrayUtils.js";
@@ -336,6 +340,7 @@ export * from "./utils/blogUtils.js";
 export * from "./utils/entityUtils.js";
 export * from "./utils/flyerUtils.js";
 export * from "./utils/promotionBlastUtils.js";
+export * from "./utils/orgPromotionalPackageUtils.js";
 export * from "./utils/guestSurface.js";
 export * from "./utils/ticketTierSchedule.js";
 export * from "./utils/lobFlyerUtils.js";

package/src/mirroredPrismaEnums.ts

@@ -176,6 +176,7 @@ export const CreditSourceType = {
   PostAfterEvent: "PostAfterEvent",
   ReferralCodeUsed: "ReferralCodeUsed",
   VenueLoyaltyRedemption: "VenueLoyaltyRedemption",
+  PartnerPromoRedemption: "PartnerPromoRedemption",
 } as const satisfies Record<CreditSourceTypeEnum, CreditSourceTypeEnum>;
 
 export type CreditSourceType = CreditSourceTypeEnum;

package/src/partnerStoreTypes.ts

@@ -1,4 +1,8 @@
-import type { PartnerTier } from "@prisma/client";
+import type {
+  LocalServiceCategory,
+  PartnerListingType,
+  PartnerTier,
+} from "@prisma/client";
 
 /** Product row returned by BashStore / wizard suggestion APIs (no internal counters). */
 export type PartnerProductPublic = {
@@ -28,9 +32,136 @@ export type PartnerStoreResponse = {
   brands: (PartnerBrandSummary & { products: PartnerProductPublic[] })[];
 };
 
-/** GET /api/partner/suggestions — at most one suggestion */
-export type PartnerSuggestionResponse = {
+export type LocalPartnerOfferPublic = {
+  id: string;
+  name: string;
+  description: string | null;
+  imageUrl: string | null;
+  affiliateUrl: string;
+  priceSummary: string | null;
+};
+
+export type LocalPartnerPublic = {
+  id: string;
+  name: string;
+  logoUrl: string | null;
+  websiteUrl: string | null;
+  description: string | null;
+  tier: PartnerTier;
+  address: string | null;
+  phone: string | null;
+  citySlug: string | null;
+  stateSlug: string | null;
+  serviceTimings: string[];
+  serviceCategory: LocalServiceCategory | null;
+  promoHeadline: string | null;
+  promoCode: string | null;
+  bookingUrl: string | null;
+  businessHours: unknown;
+  timezone: string | null;
+  latitude: number | null;
+  longitude: number | null;
+  bashPointsCost: number | null;
+  distanceMiles: number | null;
+  offers: LocalPartnerOfferPublic[];
+};
+
+/** Gear wizard ad slot suggestion */
+export type PartnerGearSuggestion = {
+  kind: "gear";
   slotId: string;
   product: PartnerProductPublic;
   brand: PartnerBrandSummary;
 };
+
+/** Local service partner surfaced in wizard or feed contexts */
+export type PartnerLocalSuggestion = {
+  kind: "local";
+  partner: LocalPartnerPublic;
+};
+
+/** GET /api/partner/suggestions — at most one suggestion */
+export type PartnerSuggestionResponse = PartnerGearSuggestion | PartnerLocalSuggestion;
+
+export type ClaimPartnerPromoResponse = {
+  promoCode: string;
+  bashPointsCost: number;
+  balanceAfter: number;
+};
+
+/** GET /api/partner/local-services */
+export type LocalServiceListingResponse = {
+  featured: LocalPartnerPublic | null;
+  partners: LocalPartnerPublic[];
+};
+
+/** Display labels for LocalServiceCategory enum values. */
+export const LOCAL_SERVICE_CATEGORY_LABELS: Record<LocalServiceCategory, string> = {
+  GetReady: "Get Ready",
+  WearAndStyle: "Wear & Style",
+  EatAndDrink: "Eat & Drink",
+  Move: "Move",
+  Recover: "Recover",
+  Wellness: "Wellness",
+  HealthAndEssentials: "Health & Essentials",
+  HomeAndLife: "Home & Life",
+  ContentAndKeepsakes: "Content & Keepsakes",
+  HostShortcuts: "Host Shortcuts",
+  PerksAndRetail: "Perks & Retail",
+  Other: "Other",
+};
+
+/** Ordered list for filter chips in BashStore Local Partners tab. */
+export const LOCAL_SERVICE_CATEGORY_ORDER: LocalServiceCategory[] = [
+  "GetReady",
+  "WearAndStyle",
+  "EatAndDrink",
+  "Move",
+  "Recover",
+  "Wellness",
+  "HealthAndEssentials",
+  "HomeAndLife",
+  "ContentAndKeepsakes",
+  "HostShortcuts",
+  "PerksAndRetail",
+  "Other",
+];
+
+export const LOCAL_SERVICE_TIMING_OPTIONS = [
+  { value: "pre_event", label: "Pre-event" },
+  { value: "day_of", label: "Day-of" },
+  { value: "post_event", label: "Post-event" },
+] as const;
+
+export type LocalServiceTiming = (typeof LOCAL_SERVICE_TIMING_OPTIONS)[number]["value"];
+
+export const PARTNER_LISTING_TYPE_LABELS: Record<PartnerListingType, string> = {
+  Gear: "Gear",
+  LocalService: "Local Service",
+};
+
+/** Admin / inquiry payloads for BashStore partner listing requests. */
+export type PartnerInquiryRecord = {
+  id: string;
+  contactName: string;
+  email: string;
+  brandName: string;
+  website: string | null;
+  description: string;
+  categories: string[];
+  listingType: PartnerListingType;
+  city: string | null;
+  status: "Pending" | "Reviewed" | "Approved" | "Rejected";
+  adminNote: string | null;
+  createdBrandId: string | null;
+  createdAt: string;
+};
+
+/** GET /api/partner/inquiry-status */
+export type PartnerInquiryStatusResponse = {
+  brandName: string;
+  status: string;
+  listingLive: boolean;
+  storeUrl: string | null;
+  createdBrandId: string | null;
+};

package/src/requestAuthUser.ts

@@ -90,16 +90,18 @@ export function parseRequestAuthFromJwtPayload(decoded: unknown): RequestAuthUse
 export function userHasSuperUserAccess(
   auth: Pick<RequestAuthUser, "roles" | "isSuperUser">,
 ): boolean {
-  return auth.isSuperUser === true || auth.roles.includes(UserRole.SuperUser);
+  const roles = auth.roles ?? [];
+  return auth.isSuperUser === true || roles.includes(UserRole.SuperUser);
 }
 
 /** Admin or SuperUser role, or legacy `isSuperUser` flag. */
 export function userHasAdminAccess(
   auth: Pick<RequestAuthUser, "roles" | "isSuperUser">,
 ): boolean {
+  const roles = auth.roles ?? [];
   return (
     auth.isSuperUser === true ||
-    auth.roles.includes(UserRole.SuperUser) ||
-    auth.roles.includes(UserRole.Admin)
+    roles.includes(UserRole.SuperUser) ||
+    roles.includes(UserRole.Admin)
   );
 }

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

@@ -0,0 +1,17 @@
+import { resolveEventCitySlug, resolveEventStateSlug } from "../eventCitySlug.js";
+
+describe("eventCitySlug", () => {
+  it("resolveEventCitySlug slugifies city names", () => {
+    expect(resolveEventCitySlug({ city: "New York City", state: "NY" })).toBe(
+      "new-york-city"
+    );
+    expect(resolveEventCitySlug({ city: "  ", state: "NY" })).toBeNull();
+  });
+
+  it("resolveEventStateSlug normalizes two-letter states", () => {
+    expect(resolveEventStateSlug({ city: "Brooklyn", state: "NY" })).toBe("ny");
+    expect(resolveEventStateSlug({ city: "LA", state: "California" })).toBe(
+      "california"
+    );
+  });
+});

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

@@ -0,0 +1,45 @@
+import {
+  isLocalPartnerOpenNow,
+  type LocalPartnerHoursConfig,
+} from "../localPartnerHours.js";
+
+describe("isLocalPartnerOpenNow", () => {
+  const sampleHours: LocalPartnerHoursConfig = {
+    openDays: {
+      Monday: true,
+      Tuesday: true,
+      Wednesday: true,
+      Thursday: true,
+      Friday: true,
+      Saturday: false,
+      Sunday: false,
+    },
+    hours: {
+      Monday: [{ open: "09:00", close: "17:00" }],
+      Tuesday: [{ open: "09:00", close: "17:00" }],
+      Wednesday: [{ open: "09:00", close: "17:00" }],
+      Thursday: [{ open: "09:00", close: "17:00" }],
+      Friday: [{ open: "09:00", close: "17:00" }],
+      Saturday: [{ open: "", close: "" }],
+      Sunday: [{ open: "", close: "" }],
+    },
+  };
+
+  it("returns null when hours are missing", () => {
+    expect(isLocalPartnerOpenNow(null, "America/New_York")).toBeNull();
+  });
+
+  it("returns true during configured weekday hours", () => {
+    const mondayMorning = new Date("2026-05-25T15:00:00.000Z");
+    expect(
+      isLocalPartnerOpenNow(sampleHours, "America/New_York", mondayMorning)
+    ).toBe(true);
+  });
+
+  it("returns false outside configured hours", () => {
+    const mondayNight = new Date("2026-05-26T03:00:00.000Z");
+    expect(
+      isLocalPartnerOpenNow(sampleHours, "America/New_York", mondayNight)
+    ).toBe(false);
+  });
+});

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

@@ -0,0 +1,115 @@
+import {
+  buildOrgPromoPackageTerms,
+  chunkArray,
+  isBashEventEligibleForOrgPromo,
+  orgPromoPackageTermsFromPaymentIntent,
+  orgPromoPackageTotalCents,
+  ORG_PROMO_PI_METADATA_TYPE,
+  parseOrgPromotionalPackageRates,
+  selectMembersForOrgPromoReach,
+} from "../orgPromotionalPackageUtils.js";
+
+describe("orgPromotionalPackageUtils", () => {
+  it("parses valid rates", () => {
+    const rates = parseOrgPromotionalPackageRates({
+      community: { enabled: true, orgFeeCents: 5000 },
+    });
+    expect(rates?.community).toEqual({ enabled: true, orgFeeCents: 5000 });
+  });
+
+  it("rejects negative org fee", () => {
+    expect(
+      parseOrgPromotionalPackageRates({
+        community: { enabled: true, orgFeeCents: -1 },
+      })
+    ).toBeNull();
+  });
+
+  it("builds package terms and total", () => {
+    const rates = { community: { enabled: true, orgFeeCents: 1000 } };
+    const terms = buildOrgPromoPackageTerms("community", rates);
+    expect(terms).not.toBeNull();
+    expect(orgPromoPackageTotalCents(terms!)).toBe(1000 + 300);
+  });
+
+  it("selectMembersForOrgPromoReach caps by joinedAt order", () => {
+    const members = [
+      { id: "b", joinedAt: new Date("2024-02-01") },
+      { id: "a", joinedAt: new Date("2024-01-01") },
+      { id: "c", joinedAt: new Date("2024-03-01") },
+    ];
+    const selected = selectMembersForOrgPromoReach(members, 2);
+    expect(selected.map((m) => m.id)).toEqual(["a", "b"]);
+  });
+
+  it("chunks arrays for FCM", () => {
+    expect(chunkArray([1, 2, 3, 4, 5], 2)).toEqual([[1, 2], [3, 4], [5]]);
+  });
+
+  it("rejects unpublished and org-only events", () => {
+    expect(isBashEventEligibleForOrgPromo({ status: "Draft" }).eligible).toBe(false);
+    const orgOnly = isBashEventEligibleForOrgPromo({
+      status: "Published",
+      isApproved: true,
+      startDateTime: new Date(),
+      requiresOrgMembership: true,
+      ticketTierCount: 1,
+    });
+    expect(orgOnly.eligible).toBe(false);
+    if (!orgOnly.eligible) {
+      expect(orgOnly.reason).toBe("event_org_only");
+    }
+  });
+
+  it("builds terms from payment intent metadata", () => {
+    const result = orgPromoPackageTermsFromPaymentIntent(
+      {
+        amount: 5300,
+        metadata: {
+          type: ORG_PROMO_PI_METADATA_TYPE,
+          tierId: "community",
+          orgFeeCents: "5000",
+          bashPlatformFeeCents: "300",
+        },
+      },
+      "community"
+    );
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      expect(result.totalCents).toBe(5300);
+      expect(result.terms.orgFeeCents).toBe(5000);
+      expect(result.terms.bashPlatformFeeCents).toBe(300);
+    }
+  });
+
+  it("rejects payment intent amount mismatch", () => {
+    const result = orgPromoPackageTermsFromPaymentIntent(
+      {
+        amount: 9999,
+        metadata: {
+          type: ORG_PROMO_PI_METADATA_TYPE,
+          tierId: "community",
+          orgFeeCents: "5000",
+          bashPlatformFeeCents: "300",
+        },
+      },
+      "community"
+    );
+    expect(result.ok).toBe(false);
+    if (!result.ok) {
+      expect(result.error).toBe("payment_amount_mismatch");
+    }
+  });
+
+  it("accepts published ticketed events", () => {
+    expect(
+      isBashEventEligibleForOrgPromo({
+        status: "Published",
+        isApproved: true,
+        startDateTime: new Date(Date.now() + 86400000),
+        endDateTime: new Date(Date.now() + 172800000),
+        ticketTierCount: 2,
+      }).eligible
+    ).toBe(true);
+  });
+});

package/src/utils/eventCitySlug.ts

@@ -0,0 +1,23 @@
+import { generateSlug } from "./slugUtils.js";
+
+export type EventCityContext = {
+  city?: string | null;
+  state?: string | null;
+};
+
+/**
+ * Derive a partner-store city slug from bash event location text.
+ * Matches admin `citySlug` conventions (kebab-case).
+ */
+export function resolveEventCitySlug(context: EventCityContext): string | null {
+  const city = context.city?.trim();
+  if (!city) return null;
+  return generateSlug(city);
+}
+
+export function resolveEventStateSlug(context: EventCityContext): string | null {
+  const state = context.state?.trim();
+  if (!state) return null;
+  if (state.length === 2) return state.toLowerCase();
+  return generateSlug(state);
+}