@bash-app/bash-common 30.142.0 → 30.143.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bash-app/bash-common",
-  "version": "30.142.0",
+  "version": "30.143.0",
   "description": "Common data and scripts to use on the frontend and backend",
   "type": "module",
   "main": "dist/index.js",

package/prisma/schema.prisma

@@ -555,6 +555,7 @@ model Invitation {
 model BashEvent {
   id                       String          @id @default(cuid())
   source                   BashEventSource @default(Bash)
+  sourcePartnerId          String?         // When source=Partner, e.g. 'jamwith', 'mixlog'
   title                    String
   slug                     String?         @unique
   creatorId                String
@@ -1374,6 +1375,7 @@ model User {
   isSuperUser          Boolean     @default(false)
   isSuspended          Boolean     @default(false)
   intent               UserIntent?
+  signupSource         String?     // e.g. 'jamwith', 'mixlog', 'organic' for attribution
   googleCalendarAccess String?
 
   // Google OAuth tokens for API access (Contacts, Calendar, etc.)
@@ -1391,6 +1393,15 @@ model User {
   uploadedImage                  String?
   uploadedImageUpdatedAt         DateTime? // When manually uploaded image was last updated
   dob                            DateTime?
+  showBirthdayOnProfile          Boolean   @default(false) // If true, show month/day on public profile
+  // Part B: Birthday Rewards full product
+  birthdayRewardsOptIn           Boolean   @default(false)
+  birthdayRewardsOptInAt         DateTime?
+  birthdayLocationId             String?   // FK UserLocation (birthday home base)
+  birthdayMaxDistanceMiles       Int       @default(25)
+  birthdayNoPurchaseOnly         Boolean   @default(false)
+  birthdayCategories             String[]  @default([]) // e.g. restaurant, coffee, dessert
+  idDocumentUrl                  String?   // Optional: secure ID upload for verification
   gender                         Gender?
   sex                            Sex?
   organization                   String?
@@ -1478,6 +1489,15 @@ model User {
   auditLogs          AuditLog[]     @relation("UserAuditLogs")
   auditLogsPerformed AuditLog[]     @relation("PerformedByUser")
   consents           UserConsent[]
+  birthdayOfferOptIns    UserBirthdayOfferOptIn[]
+  birthdayOfferDeliveries BirthdayOfferDelivery[]
+  birthdayBoostGrants    BirthdayBoostGrant[]
+  birthdayRewardRedemptions BirthdayRewardRedemption[]
+  birthdayDealSuggestions BirthdayDealSuggestion[]
+  userLocations          UserLocation[]
+  birthdayLocation       UserLocation?   @relation("UserBirthdayLocation", fields: [birthdayLocationId], references: [id], onDelete: SetNull)
+  offerClaims            OfferClaim[]
+  birthdayPlans          BirthdayPlan[]
 
   associatedBashes               AssociatedBash[]
   associatedServices             AssociatedService[]
@@ -3610,6 +3630,8 @@ enum BashEventSource {
   LinkedIn
   Meetup
   Facebook
+  JamWith
+  Partner   // Generic: use sourcePartnerId for partner key (e.g. 'mixlog', custom integrations)
 }
 
 enum TicketStatus {
@@ -5516,6 +5538,7 @@ enum CreditSourceType {
   FirstFavoriteBash // First bash added to favorites
   FirstShareBash // First time sharing a bash event
   FirstInviteToBash // First invite to someone else's bash
+  BirthdayReward // Annual BashPoints boost on user's birthday
 }
 
 enum PendingGiftStatus {
@@ -5577,6 +5600,325 @@ enum ConsentType {
   Analytics // Optional: Google Analytics, Mixpanel, etc.
   Marketing // Optional: Promotional emails
   ThirdPartySharing // Optional: Share data with partners
+  BirthdayOffers // Optional: Receive birthday offers from partner companies
+}
+
+// Birthday offers from partner companies: users opt in once, we send minimal PII to partner APIs
+model BirthdayOfferPartner {
+  id            String   @id @default(cuid())
+  name          String
+  slug          String   @unique
+  description   String?  @db.Text
+  apiEndpoint   String   // Partner API URL; API keys live in env (BIRTHDAY_PARTNER_<SLUG>_API_KEY)
+  config        Json?    // Partner-specific: e.g. sendFullDob (bool), extra fields
+  requiresPhone Boolean  @default(false) // Part B: when true, share User.phone with partner
+  isActive      Boolean  @default(true)
+  createdAt     DateTime @default(now())
+  updatedAt     DateTime @updatedAt
+  optIns        UserBirthdayOfferOptIn[]
+  deliveries    BirthdayOfferDelivery[]
+  catalogEntries BirthdayFreebieCatalog[]
+
+  @@index([isActive])
+}
+
+model UserBirthdayOfferOptIn {
+  id         String   @id @default(cuid())
+  userId     String
+  partnerId  String
+  optedInAt  DateTime @default(now())
+  lastSentAt DateTime? // Last time we sent this user to this partner (for idempotency)
+  user       User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  partner    BirthdayOfferPartner @relation(fields: [partnerId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, partnerId])
+  @@index([partnerId])
+  @@index([userId])
+}
+
+model BirthdayOfferDelivery {
+  id           String   @id @default(cuid())
+  userId       String
+  partnerId    String
+  birthdayYear Int      // Year when the send counted (for idempotency: one send per user/partner/year)
+  sentAt       DateTime @default(now())
+  user         User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  partner      BirthdayOfferPartner @relation(fields: [partnerId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, partnerId, birthdayYear])
+  @@index([partnerId])
+  @@index([userId])
+}
+
+// Birthday Rewards focused scope (v1): annual BashPoints boost idempotency
+model BirthdayBoostGrant {
+  id          String   @id @default(cuid())
+  userId      String
+  birthdayYear Int     // Year for which boost was granted
+  grantedAt   DateTime @default(now())
+  user        User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, birthdayYear])
+  @@index([userId])
+  @@index([birthdayYear])
+}
+
+// User-recorded places where they picked up a birthday reward (with optional rating)
+model BirthdayRewardRedemption {
+  id              String    @id @default(cuid())
+  userId          String
+  placeName       String    // e.g. "Freddy's", "Starbucks"
+  redeemedAt      DateTime  @default(now())
+  birthdayYear    Int
+  notes           String?   @db.Text
+  difficultyScore Int?     // 1-10
+  qualityScore    Int?     // 1-10
+  ratingComment   String?   @db.Text
+  ratedAt         DateTime?
+  offerId         String?   // Part B: optional FK to structured BirthdayOffer
+  user            User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  offer           BirthdayOffer? @relation(fields: [offerId], references: [id], onDelete: SetNull)
+
+  @@index([userId])
+  @@index([userId, birthdayYear])
+  @@index([offerId])
+}
+
+enum BirthdayDealSuggestionStatus {
+  Pending
+  Approved
+  Rejected
+}
+
+// User-suggested birthday deals (admin can approve and add to catalog later)
+model BirthdayDealSuggestion {
+  id               String   @id @default(cuid())
+  userId           String
+  brandOrPlaceName  String
+  dealDescription   String   @db.Text
+  sourceWhereHeard  String?  @db.Text
+  linkUrl           String?  @db.Text
+  status           BirthdayDealSuggestionStatus @default(Pending)
+  createdAt        DateTime @default(now())
+  reviewedAt       DateTime?
+  reviewedById     String?
+  user             User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  catalogEntry     BirthdayFreebieCatalog?
+
+  @@index([userId])
+  @@index([status])
+}
+
+// Public SEO catalog for birthday freebie pages (programmatic by city/state)
+enum BirthdayFreebieCategory {
+  NoPurchaseRequired
+  PurchaseRequired
+}
+
+enum BirthdayFreebieExpirationType {
+  DayOf
+  Valid30Days
+}
+
+enum BirthdayFreebieSource {
+  Partner
+  Suggestion
+  Manual
+}
+
+enum BirthdayFreebieSector {
+  CoffeeAndBeverages
+  FoodAndRestaurants
+  DessertsAndIceCream
+  BeautyAndRetail
+  Entertainment
+  Other
+}
+
+model BirthdayFreebieCatalog {
+  id                    String                     @id @default(cuid())
+  brandOrPlaceName      String
+  description           String?                    @db.Text
+  logoUrl               String?                    @db.Text
+  sector                BirthdayFreebieSector      @default(Other)
+  category              BirthdayFreebieCategory
+  expirationType        BirthdayFreebieExpirationType
+  lastVerifiedAt        DateTime
+  requiresAdvanceSignup Boolean?                   @default(false)
+  source                BirthdayFreebieSource
+  partnerId             String?
+  suggestionId          String?   @unique  // one-to-one: at most one catalog entry per suggestion
+  stateSlug             String
+  citySlug              String?
+  isActive              Boolean                    @default(true)
+  createdAt             DateTime                   @default(now())
+  updatedAt             DateTime                   @updatedAt
+
+  partner    BirthdayOfferPartner?   @relation(fields: [partnerId], references: [id], onDelete: SetNull)
+  suggestion BirthdayDealSuggestion? @relation(fields: [suggestionId], references: [id], onDelete: SetNull)
+
+  @@index([stateSlug, citySlug])
+  @@index([isActive])
+  @@index([sector])
+}
+
+// Part B: User saved locations (birthday home base, etc.)
+model UserLocation {
+  id        String   @id @default(cuid())
+  userId    String
+  label     String?  // e.g. "Home", "Work"
+  address1  String
+  address2  String?
+  city      String
+  state     String
+  zip       String
+  country   String?  @default("US")
+  lat       Float?
+  lng       Float?
+  isDefault Boolean? @default(false)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  usersWithBirthdayLocation User[] @relation("UserBirthdayLocation")
+
+  @@index([userId])
+}
+
+// Part B: Structured birthday offers (catalog)
+enum RedemptionMethod {
+  APP
+  EMAIL
+  IN_STORE
+  ONLINE
+}
+
+enum BirthdayOfferExpirationType {
+  DAY_OF        // End of birthday day
+  DAYS_FROM_BDAY
+  END_OF_MONTH
+  VARIABLE
+}
+
+enum BirthdayOfferSourceType {
+  BRAND_SITE
+  USER_REPORTED
+  PARTNER
+}
+
+enum OfferClaimStatus {
+  CLICKED
+  SAVED
+  CLAIMED
+  REDEEMED
+  EXPIRED
+}
+
+model Brand {
+  id              String   @id @default(cuid())
+  name            String
+  websiteUrl      String?  @db.Text
+  logoUrl         String?  @db.Text
+  categoryDefault String?  // restaurant, coffee, dessert, retail, entertainment
+  isNational      Boolean  @default(true)
+  createdAt       DateTime @default(now())
+  updatedAt       DateTime @updatedAt
+  offers          BirthdayOffer[]
+  locations       BrandLocation[]
+
+  @@index([isNational])
+}
+
+model BirthdayOffer {
+  id                    String   @id @default(cuid())
+  brandId               String
+  title                 String   // e.g. "Free burger reward"
+  descriptionShort      String?  @db.Text
+  purchaseRequired      Boolean  @default(false)
+  signupRequired        Boolean  @default(false)
+  appRequired           Boolean  @default(false)
+  requiresPhone         Boolean  @default(false)
+  redemptionMethod      RedemptionMethod
+  expirationType        BirthdayOfferExpirationType
+  expirationDays        Int?     // when expirationType = DAYS_FROM_BDAY
+  windowStartOffsetDays Int      @default(0)
+  termsUrl              String?  @db.Text
+  termsNotes            String?  @db.Text
+  sourceType            BirthdayOfferSourceType
+  lastVerifiedAt        DateTime?
+  isActive              Boolean  @default(true)
+  priorityScore         Int      @default(0)
+  featuredUntil        DateTime?
+  createdAt             DateTime @default(now())
+  updatedAt             DateTime @updatedAt
+  brand                 Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
+  claims                OfferClaim[]
+  redemptions           BirthdayRewardRedemption[]
+
+  @@index([brandId])
+  @@index([isActive])
+  @@index([sourceType])
+}
+
+model BrandLocation {
+  id        String   @id @default(cuid())
+  brandId   String
+  address1  String
+  address2  String?
+  city      String
+  state     String
+  zip       String
+  lat       Float
+  lng       Float
+  isActive  Boolean  @default(true)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  brand     Brand    @relation(fields: [brandId], references: [id], onDelete: Cascade)
+
+  @@index([brandId])
+  @@index([isActive])
+}
+
+model OfferClaim {
+  id               String   @id @default(cuid())
+  userId           String
+  birthdayOfferId  String
+  claimedAt        DateTime @default(now())
+  birthdayYear     Int
+  status           OfferClaimStatus
+  meta             Json?
+  user             User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  birthdayOffer    BirthdayOffer @relation(fields: [birthdayOfferId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@index([birthdayOfferId])
+  @@index([userId, birthdayYear])
+}
+
+model BirthdayPlan {
+  id                    String   @id @default(cuid())
+  userId                String
+  birthdayYear          Int
+  generatedAt           DateTime @default(now())
+  preferencesSnapshot   Json     // distance, filters, optimizeFor
+  items                 Json     // ordered stops: plannedDate, brandId, offerId, locationId?, distanceFromHome, deadline, purchaseRequired
+  validFrom             DateTime
+  validTo               DateTime
+  user                  User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@index([userId, birthdayYear])
+}
+
+// Part B: Geocoding cache to avoid repeated API calls (birthday rewards, UserLocation, etc.)
+model GeocodeCache {
+  id              String   @id @default(cuid())
+  addressQuery      String   @unique // Normalized query string (trimmed, collapsed whitespace)
+  lat               Float
+  lng               Float
+  normalizedAddress String   @db.Text // formatted_address from provider
+  createdAt       DateTime @default(now())
+
+  @@index([addressQuery])
 }
 
 model AuditLog {