@bash-app/bash-common 30.97.0 → 30.98.0

package/prisma/schema.prisma

@@ -3,9 +3,8 @@ generator client {
 }
 
 datasource db {
-  provider  = "postgresql"
-  url       = env("POSTGRES_PRISMA_URL")
-  directUrl = env("POSTGRES_URL_NON_POOLING")
+  provider = "postgresql"
+  url      = env("POSTGRES_PRISMA_URL")
 }
 
 model Club {
@@ -54,16 +53,25 @@ model BashComment {
 }
 
 model Competition {
-  id             String               @id @default(cuid())
-  name           String
-  description    String
-  userId         String
-  bashEventId    String
-  numberOfPrizes Int
-  bashEvent      BashEvent            @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
-  owner          User                 @relation(fields: [userId], references: [id], onDelete: Cascade)
-  sponsor        CompetitionSponsor[]
-  prizes         Prize[]
+  id              String               @id @default(cuid())
+  name            String
+  description     String               @db.Text
+  userId          String
+  bashEventId     String
+  numberOfPrizes  Int
+  competitionType CompetitionType? // Main category
+  subtype         String? // Subcategory
+  rules           String?              @db.Text // Detailed rules/disclaimers
+  judgingType     JudgingType? // How winner is determined
+  createdAt       DateTime             @default(now())
+  updatedAt       DateTime             @updatedAt
+  bashEvent       BashEvent            @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  owner           User                 @relation(fields: [userId], references: [id], onDelete: Cascade)
+  sponsor         CompetitionSponsor[]
+  prizes          Prize[]
+
+  @@index([bashEventId])
+  @@index([competitionType])
 }
 
 model CompetitionSponsor {
@@ -366,6 +374,8 @@ model BashEvent {
   media                           Media[]                    @relation("BashEventToMedia")
   associatedServicesReferencingMe Service[]                  @relation("BashEventToService")
   userConnections                 UserConnection[]
+  aiRecommendationLogs            AIRecommendationLog[]
+  aiRecommendationCaches          AIRecommendationCache[]
 }
 
 model Coordinates {
@@ -732,14 +742,20 @@ model Prize {
   id            String       @id @default(cuid())
   prizeWorth    Float?
   prizeType     PrizeType
-  name          String
+  name          String // Prize name (e.g., "$100 Cash", "Backpack")
+  placeName     String? // Display name (e.g., "1st Place", "Winner")
   prizeLevel    Int
   description   String
   competitionId String?
   paidOn        String?
   winnerUserId  String?
-  competition   Competition? @relation(fields: [competitionId], references: [id])
+  wonAt         DateTime? // When the prize was awarded
+  claimedAt     DateTime? // When the prize was claimed
+  competition   Competition? @relation(fields: [competitionId], references: [id], onDelete: Cascade)
   winner        User?        @relation(fields: [winnerUserId], references: [id], onDelete: Cascade)
+
+  @@index([competitionId])
+  @@index([winnerUserId]) // For fetching user's wins
 }
 
 model Review {
@@ -807,16 +823,22 @@ model SocialMediaProfile {
 }
 
 model User {
-  id                             String         @id @default(cuid())
-  username                       String?        @unique
-  email                          String         @unique
-  createdOn                      DateTime       @default(now())
-  stripeCustomerId               String?        @unique
-  stripeAccountId                String?        @unique
-  isSuperUser                    Boolean        @default(false)
-  isSuspended                    Boolean        @default(false)
-  intent                         UserIntent?
-  googleCalendarAccess           String?
+  id                   String      @id @default(cuid())
+  username             String?     @unique
+  email                String      @unique
+  createdOn            DateTime    @default(now())
+  stripeCustomerId     String?     @unique
+  stripeAccountId      String?     @unique
+  isSuperUser          Boolean     @default(false)
+  isSuspended          Boolean     @default(false)
+  intent               UserIntent?
+  googleCalendarAccess String?
+
+  // Google OAuth tokens for API access (Contacts, Calendar, etc.)
+  googleAccessToken  String?
+  googleRefreshToken String?
+  googleTokenExpiry  DateTime?
+
   givenName                      String?
   familyName                     String?
   nameChangeCount                Int            @default(0)
@@ -901,8 +923,9 @@ model User {
 
   // Security Fields
   accountLockedUntil DateTime? // Account lockout timestamp for failed login protection
-  auditLogs          AuditLog[]    @relation("UserAuditLogs")
-  auditLogsPerformed AuditLog[]    @relation("PerformedByUser")
+  revokedTokens      RevokedToken[] @relation("RevokedTokens") // Revoked JWT tokens
+  auditLogs          AuditLog[]     @relation("UserAuditLogs")
+  auditLogsPerformed AuditLog[]     @relation("PerformedByUser")
   consents           UserConsent[]
 
   associatedBashes               AssociatedBash[]
@@ -980,6 +1003,7 @@ model User {
   connectionRequestsReceived     UserConnection[]           @relation("ConnectionRequestsReceived")
   links                          UserLink[]
   preferences                    UserPreferences?
+  rankings                       UserRankings?
   userPromoCodeRedemption        UserPromoCodeRedemption[]
   referralCode                   UserReferralCode?
   referralTokens                 UserReferralToken[]        @relation("UserReferralTokens")
@@ -990,6 +1014,7 @@ model User {
   userSubscription               UserSubscription?
   vendorBid                      VendorBid[]
   vendorBookingMessages          VendorBookingMessage[]     @relation("VendorMessageSender")
+  serviceAnalytics               ServiceAnalytics[] // Track service analytics for this user
   vendorBookingRequestsAsHost    VendorBookingRequest[]     @relation("VendorBookingHost")
   volunteerService               VolunteerService[]
   reviewedAmbashadorApps         AmbashadorApplication[]    @relation("AmbashadorReviewer")
@@ -999,6 +1024,7 @@ model User {
   bashEventPromoCodesIUsed       BashEventPromoCode[]       @relation("BashEventPromoCodeToUser")
   ticketTiersWaitListsIveJoined  TicketTier[]               @relation("TicketTierToUser")
   scoutReferralsMade             ScoutReferral[]            @relation("ScoutReferrer")
+  aiRecommendationLogs           AIRecommendationLog[]
   scoutReferralsReceived         ScoutReferral[]            @relation("ScoutReferred")
   bookingCommissionsEarned       BookingCommission[]        @relation("CommissionReferrer")
 
@@ -1043,6 +1069,7 @@ model UserPreferences {
   showEmailPublicly           Boolean  @default(true)
   showPhonePublicly           Boolean  @default(false)
   showAddressPublicly         Boolean  @default(false)
+  showCompetitionWins         Boolean  @default(true) // Display competition wins on public profile
   theme                       String   @default("system")
   language                    String   @default("en")
   timeZone                    String   @default("America/New_York")
@@ -1098,6 +1125,9 @@ model UserPreferences {
   localEventsToCalendarSync   Boolean  @default(false)
   localEventsCity             String   @default("")
   localEventsState            String   @default("")
+  showRankings                Boolean  @default(true) // Show rankings on profile
+  showAttendeeRank            Boolean  @default(true) // Show attendee rank publicly
+  showHostRank                Boolean  @default(true) // Show host rank publicly
   user                        User     @relation(fields: [userId], references: [id], onDelete: Cascade)
 }
 
@@ -1116,6 +1146,42 @@ model UserFollowing {
   @@unique([userId, followingId])
 }
 
+model UserRankings {
+  id                         String   @id @default(cuid())
+  userId                     String   @unique
+  attendeeScore              Int      @default(0) // Number of events attended
+  hostScore                  Int      @default(0) // Number of events hosted
+  totalAttendeesScore        Int      @default(0) // Total attendees across all hosted events
+  attendeeRankGlobal         Int? // Global rank as attendee
+  attendeeRankNational       Int? // National rank as attendee
+  attendeeRankCity           Int? // City rank as attendee
+  hostRankGlobal             Int? // Global rank as host
+  hostRankNational           Int? // National rank as host
+  hostRankCity               Int? // City rank as host
+  totalAttendeesRankGlobal   Int? // Global rank by total attendees
+  totalAttendeesRankNational Int? // National rank by total attendees
+  totalAttendeesRankCity     Int? // City rank by total attendees
+  attendeePercentile         Float? // Percentile rank as attendee (0-100)
+  hostPercentile             Float? // Percentile rank as host (0-100)
+  totalAttendeesPercentile   Float? // Percentile rank by total attendees (0-100)
+  city                       String? // City for location-based rankings
+  country                    String   @default("US") // Country for location-based rankings
+  lastScoreUpdate            DateTime @default(now()) // When scores were last calculated
+  lastCalculated             DateTime @default(now()) // When ranks were last calculated
+  createdAt                  DateTime @default(now())
+  updatedAt                  DateTime @updatedAt
+  user                       User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@index([attendeeScore])
+  @@index([hostScore])
+  @@index([totalAttendeesScore])
+  @@index([city])
+  @@index([country])
+  @@index([attendeeRankGlobal])
+  @@index([hostRankGlobal])
+}
+
 model UserConnection {
   id                String           @id @default(cuid())
   requesterId       String // User who sent the request
@@ -1366,6 +1432,7 @@ model Service {
   associatedBashesReferencingMe      AssociatedBash[]           @relation("AssociatedBashToService")
   bashEvent                          BashEvent[]                @relation("BashEventToService")
   media                              Media[]                    @relation("MediaToService")
+  analytics                          ServiceAnalytics[] // Track service analytics
   scoutReferrals                     ScoutReferral[]            @relation("ScoutServiceProfile")
   bookingCommissions                 BookingCommission[]        @relation("CommissionServiceProfile")
 
@@ -1863,42 +1930,42 @@ model ServiceBookingCheckout {
 }
 
 model ServiceBooking {
-  id                   String                   @id @default(cuid())
-  creatorId            String
-  forUserId            String
-  daysTotalATBCents    Int
-  serviceId            String
-  rateOption           ServiceBookingRateOption @default(TimeBased)
-  flatRateCents        Int?
-  status               ServiceBookingStatus     @default(Pending)
-  bookingType          ServiceBookingType       @default(Request)
-  timezone             String
-  requestedOn          DateTime?
-  requestDecisionOn    DateTime?
-  bookedOn             DateTime?
-  canceledOn           DateTime?
-  isFreeGuest          Boolean                  @default(false)
-  allowPromiseToPay    Boolean                  @default(false)
-  totalATBCents        Int
-  subtotalATBCents     Int                      @default(0)
-  bashEventId          String?
-  isVendorBid          Boolean                  @default(false)
-  vendorBidAmountCents Int?
-  vendorEventDetails   String?
-  bashCashApplied      Int?                     // BashCash credits applied to this booking
-  bashCashTransactionId String?                 // Link to BashCreditTransaction
-  notification         Notification[]
-  bashEvent            BashEvent?               @relation(fields: [bashEventId], references: [id])
-  creator              User                     @relation("BookingCreator", fields: [creatorId], references: [id])
-  forUser              User                     @relation("BookingForUser", fields: [forUserId], references: [id])
-  service              Service                  @relation(fields: [serviceId], references: [id])
-  addOns               ServiceBookingAddOn[]
-  checkout             ServiceBookingCheckout?
-  bookedDays           ServiceBookingDay[]
-  additionalFees       ServiceBookingFee[]
-  messages             ServiceBookingMessage[]
-  packages             ServiceBookingPackage[]
-  commissions          BookingCommission[]      @relation("BookingCommissions")
+  id                    String                   @id @default(cuid())
+  creatorId             String
+  forUserId             String
+  daysTotalATBCents     Int
+  serviceId             String
+  rateOption            ServiceBookingRateOption @default(TimeBased)
+  flatRateCents         Int?
+  status                ServiceBookingStatus     @default(Pending)
+  bookingType           ServiceBookingType       @default(Request)
+  timezone              String
+  requestedOn           DateTime?
+  requestDecisionOn     DateTime?
+  bookedOn              DateTime?
+  canceledOn            DateTime?
+  isFreeGuest           Boolean                  @default(false)
+  allowPromiseToPay     Boolean                  @default(false)
+  totalATBCents         Int
+  subtotalATBCents      Int                      @default(0)
+  bashEventId           String?
+  isVendorBid           Boolean                  @default(false)
+  vendorBidAmountCents  Int?
+  vendorEventDetails    String?
+  bashCashApplied       Int? // BashCash credits applied to this booking
+  bashCashTransactionId String? // Link to BashCreditTransaction
+  notification          Notification[]
+  bashEvent             BashEvent?               @relation(fields: [bashEventId], references: [id])
+  creator               User                     @relation("BookingCreator", fields: [creatorId], references: [id])
+  forUser               User                     @relation("BookingForUser", fields: [forUserId], references: [id])
+  service               Service                  @relation(fields: [serviceId], references: [id])
+  addOns                ServiceBookingAddOn[]
+  checkout              ServiceBookingCheckout?
+  bookedDays            ServiceBookingDay[]
+  additionalFees        ServiceBookingFee[]
+  messages              ServiceBookingMessage[]
+  packages              ServiceBookingPackage[]
+  commissions           BookingCommission[]      @relation("BookingCommissions")
 
   @@index([status])
   @@index([creatorId])
@@ -2795,6 +2862,31 @@ enum PrizeType {
   Combo
 }
 
+enum CompetitionType {
+  RAFFLE // Raffles & Drawings
+  SKILL // Skill-Based Contests
+  PHYSICAL // Physical & Outdoor
+  INTERACTIVE // Interactive Audience
+  SOCIAL_MEDIA // Social Media-Driven
+  KIDS_FAMILY // Kids & Family
+  FOOD_DRINK // Food & Drink
+  VENDOR_BOOTH // Vendor Booth
+  BUSINESS_PROFESSIONAL // Business / Professional
+  RANDOMIZED // Randomized Participation
+  SEASONAL_HOLIDAY // Seasonal or Holiday
+  AUDIENCE_VOTING // Audience Voting-Based
+}
+
+enum JudgingType {
+  RANDOM_DRAW // Raffle-style random selection
+  JUDGES // Panel of judges decides
+  AUDIENCE_VOTE // Attendees vote
+  METRICS // Based on measurable metrics
+  HOST_CHOOSES // Host/organizer picks winner
+  FIRST_COME // First X people win
+  HIGHEST_BID // Auction-style
+}
+
 enum Sex {
   Male
   Female
@@ -4240,6 +4332,25 @@ model AuditLog {
   @@index([ipAddress])
 }
 
+/// Token Revocation System
+/// Tracks revoked JWT tokens to prevent their reuse
+/// Required for secure logout, password changes, and account termination
+model RevokedToken {
+  id        String   @id @default(cuid())
+  userId    String // Owner of the revoked token
+  jti       String   @unique // JWT ID from token payload
+  revokedAt DateTime @default(now())
+  expiresAt DateTime // When the original token would have expired (for cleanup)
+  reason    String? // Why it was revoked: "logout", "password_change", "suspicious_activity", etc.
+
+  // Relation to user
+  user User @relation("RevokedTokens", fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([jti]) // Fast lookup for token validation
+  @@index([userId, revokedAt]) // User-specific revocation history
+  @@index([expiresAt]) // For cleanup of old expired tokens
+}
+
 enum AuditAction {
   // Authentication
   LOGIN_SUCCESS
@@ -4300,6 +4411,11 @@ enum AuditAction {
   DATA_IMPORTED
   SENSITIVE_DATA_ACCESSED
 
+  // Compliance
+  CONSENT_GIVEN
+  CONSENT_WITHDRAWN
+  POLICY_ACCEPTED
+
   // Security
   SUSPICIOUS_ACTIVITY_DETECTED
   RATE_LIMIT_EXCEEDED
@@ -4317,6 +4433,7 @@ enum AuditCategory {
   Tickets
   AdminAction
   DataAccess
+  Compliance
   Security
 }
 
@@ -4326,6 +4443,88 @@ enum AuditSeverity {
   Critical // Security incidents
 }
 
+// Service Analytics Tracking
+model ServiceAnalytics {
+  id           String                @id @default(cuid())
+  serviceId    String
+  userId       String? // null for anonymous views
+  eventType    ServiceAnalyticsEvent
+  serviceType  ServiceTypes? // Venues, EventServices, etc.
+  specificType String? // For detailed tracking (e.g., "WeddingVenue", "Restaurant")
+  timestamp    DateTime              @default(now())
+  sessionId    String? // Track user sessions
+  referrer     String? // Where the user came from
+  deviceType   String? // mobile, desktop, tablet
+  metadata     Json? // Additional context data
+
+  service Service @relation(fields: [serviceId], references: [id], onDelete: Cascade)
+  user    User?   @relation(fields: [userId], references: [id], onDelete: SetNull)
+
+  @@index([serviceId])
+  @@index([userId])
+  @@index([eventType])
+  @@index([timestamp])
+  @@index([serviceType])
+  @@index([specificType])
+}
+
+enum ServiceAnalyticsEvent {
+  VIEW // Card/listing viewed
+  CLICK // Card clicked
+  DETAIL_VIEW // Detail page viewed
+  FAVORITE // Added to favorites
+  UNFAVORITE // Removed from favorites
+  SHARE // Shared via link/social
+  CONTACT_CLICK // Contact button clicked
+  BOOKING_STARTED // Booking process initiated
+  BOOKING_COMPLETED // Booking confirmed
+  BOOKING_ABANDONED // User left during booking
+  INQUIRY_SENT // Inquiry form submitted
+  PHONE_CLICK // Phone number clicked
+  EMAIL_CLICK // Email clicked
+  WEBSITE_CLICK // Website link clicked
+  DIRECTIONS_CLICK // Directions/map clicked
+  PHOTO_VIEW // Photo gallery viewed
+  VIDEO_PLAY // Video played
+  REVIEW_VIEW // Reviews section viewed
+  FILTER_APPLIED // When a user filters results
+}
+
+// AI Recommendation System - Logs each recommendation request
+model AIRecommendationLog {
+  id                  String       @id @default(cuid())
+  eventId             String
+  userId              String
+  venueId             String?
+  serviceType         ServiceTypes
+  recommendationCount Int          @default(0)
+  cacheHit            Boolean      @default(false)
+  createdAt           DateTime     @default(now())
+
+  event BashEvent @relation(fields: [eventId], references: [id], onDelete: Cascade)
+  user  User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([eventId])
+  @@index([userId])
+  @@index([createdAt])
+}
+
+// AI Recommendation Cache - Stores recommendations to reduce API costs
+model AIRecommendationCache {
+  id              String       @id @default(cuid())
+  cacheKey        String       @unique
+  eventId         String
+  serviceType     ServiceTypes
+  recommendations Json // Array of ServiceRecommendation objects
+  expiresAt       DateTime
+  createdAt       DateTime     @default(now())
+
+  event BashEvent @relation(fields: [eventId], references: [id], onDelete: Cascade)
+
+  @@index([eventId])
+  @@index([expiresAt])
+}
+
 enum VoucherStatus {
   Active
   Redeemed

package/src/definitions.ts

@@ -2,8 +2,10 @@ import {
     BashEventDressTags,
     BashEventType,
     BashEventVibeTags,
+    CompetitionType,
     Contact,
     EntertainmentServiceType,
+    JudgingType,
     MembershipTier,
     MusicGenreType,
     Prisma,
@@ -877,7 +879,7 @@ export const YearsOfExperienceToString: { [key in YearsOfExperience]: string } =
   };
 
 // Export Prisma enums for use in frontend
-export { YearsOfExperience, EntertainmentServiceType, MusicGenreType, ServiceTypes };
+export { YearsOfExperience, EntertainmentServiceType, MusicGenreType, ServiceTypes, CompetitionType, JudgingType };
 
 export type BashEventTypeToStringType = {
   [key in BashEventType]: string;

package/src/extendedSchemas.ts

@@ -10,6 +10,7 @@ import {
     BlogPost,
     BlogTag,
     Checkout,
+    Competition,
     Contact,
     Coordinates,
     Demerit,
@@ -23,6 +24,7 @@ import {
     Notification,
     Organization,
     Prisma,
+    Prize,
     Recurrence,
     Reminder,
     Review,
@@ -154,6 +156,14 @@ export const PRIVATE_USER_ACCOUNT_TO_SELECT = {
 
 export interface SponsoredEventExt extends SponsoredEvent {}
 
+export interface PrizeExt extends Prize {
+  winner?: PublicUser | null;
+}
+
+export interface CompetitionExt extends Competition {
+  prizes: PrizeExt[];
+}
+
 export interface BashEventExt extends BashEvent {
   targetAudience?: TargetAudience;
   amountOfGuests?: AmountOfGuests;
@@ -169,6 +179,7 @@ export interface BashEventExt extends BashEvent {
   venueServiceId?: string;
   venueOwner?: PublicUser;
   sponsorships?: SponsoredEventExt[];
+  competitions?: CompetitionExt[];
 }
 
 export const TICKET_TIER_DATA_TO_INCLUDE = {
@@ -206,6 +217,17 @@ export const BASH_EVENT_DATA_TO_INCLUDE = {
   media: true,
   eventTasks: true,
   invitations: true,
+  competitions: {
+    include: {
+      prizes: {
+        include: {
+          winner: {
+            select: FRONT_END_USER_DATA_TO_SELECT,
+          },
+        },
+      },
+    },
+  },
 } satisfies Prisma.BashEventInclude;
 
 export const BASH_EVENT_DATA_TO_CLONE = [

package/src/index.ts

@@ -38,6 +38,7 @@ export * from "./utils/service/serviceDBUtils";
 export * from "./utils/service/serviceRateUtils";
 export * from "./utils/stripeAccountUtils";
 export * from "./utils/userUtils";
+export * from "./utils/venueTypeFormatter";
 
 // Export typeUtils types individually to avoid ValueOf conflict with definitions
 export { createAllTrueObject } from "./utils/typeUtils";

package/src/utils/contentFilterUtils.ts

@@ -319,3 +319,4 @@ export function shouldWarnUser(violations: ContentViolation[], userTier: string)
 
 
 
+

package/src/utils/index.ts

@@ -0,0 +1,43 @@
+export * from './addressUtils';
+export * from './apiUtils';
+export * from './arrayUtils';
+export * from './awsS3Utils';
+export * from './badgeUtils';
+export * from './bashCashPaymentUtils';
+export * from './blog/blogDbUtils';
+export * from './blogUtils';
+export * from './contentFilterUtils';
+export * from './dateTimeUtils';
+export * from './entityUtils';
+export * from './generalDateTimeUtils';
+export * from './luxonUtils';
+export * from './mathUtils';
+export * from './objUtils';
+export * from './paymentUtils';
+export * from './promoCodesUtils';
+export * from './qrCodeUtils';
+export * from './recurrenceUtils';
+export * from './reviewUtils';
+export * from './service/apiServiceBookingApiUtils';
+export * from './service/attendeeOptionUtils';
+export * from './service/frontendServiceBookingUtils';
+export * from './service/regexUtils';
+export * from './service/serviceBookingStatusUtils';
+export * from './service/serviceBookingTypes';
+export * from './service/serviceDBUtils';
+// export * from './service/serviceRateDBUtils'; // File is all commented out
+export * from './service/serviceRateTypes';
+export * from './service/serviceRateUtils';
+export * from './service/serviceUtils';
+export * from './slugUtils';
+export * from './sortUtils';
+export * from './stringUtils';
+export * from './stripeAccountUtils';
+export * from './ticketListUtils';
+export * from './typeUtils';
+export * from './urlUtils';
+export * from './userPromoCodeUtils';
+export * from './userSubscriptionUtils';
+export * from './userUtils';
+export * from './venueTypeFormatter';
+

package/src/utils/venueTypeFormatter.ts

@@ -0,0 +1,30 @@
+/**
+ * Formats venue type enum values into human-readable display names
+ * Example: "OutdoorSpace" -> "Outdoor Space", "WeddingVenue" -> "Wedding Venue"
+ */
+export function formatVenueType(venueType: string): string {
+  if (!venueType) return '';
+  
+  // Insert space before capital letters (but not at the start)
+  return venueType.replace(/([A-Z])/g, ' $1').trim();
+}
+
+/**
+ * Formats an array of venue types into a human-readable string
+ */
+export function formatVenueTypes(venueTypes: string[], maxDisplay: number = 2): string {
+  if (!Array.isArray(venueTypes) || venueTypes.length === 0) {
+    return '';
+  }
+
+  const formatted = venueTypes.slice(0, maxDisplay).map(formatVenueType);
+  const remaining = venueTypes.length - maxDisplay;
+
+  if (remaining > 0) {
+    return `${formatted.join(', ')} +${remaining} more`;
+  }
+
+  return formatted.join(', ');
+}
+
+