@bash-app/bash-common 30.281.0 → 30.285.0

package/src/icebreakerPrompts.ts

@@ -0,0 +1,75 @@
+/**
+ * Curated conversation starters for Bash events (hosts enable per-event).
+ * Single source of truth shared by the API (public icebreaker endpoint) and the
+ * bash-app wizard (host "Generate a new icebreaker" picker).
+ */
+export const ICEBREAKER_PROMPTS: string[] = [
+  // Get to know you
+  "What’s something small that made your week better?",
+  "What’s a hobby you’ve always wanted to try but haven’t yet?",
+  "If you could learn one new skill overnight, what would it be?",
+  "What’s your go-to comfort food?",
+  "What’s a book, show, or podcast you recommend to almost everyone?",
+  "What city or country is still on your travel list?",
+  "What’s a tradition from your family or culture you love?",
+  "What’s the best advice you’ve ever been given?",
+  "Who is someone you admire and why (in one sentence)?",
+  "What’s a song that instantly puts you in a good mood?",
+  // Event / party
+  "What brought you out tonight?",
+  "What are you most looking forward to at this event?",
+  "If this bash had a theme song, what would it be?",
+  "What’s one thing you hope to take away from tonight?",
+  "Who here do you already know—and how did you meet?",
+  "What’s your favorite thing about gatherings like this?",
+  "If you could add one activity to this event, what would it be?",
+  "What’s a memory from a past party you still think about?",
+  "What’s your ideal way to spend an evening with friends?",
+  "What’s something you’re celebrating lately (big or small)?",
+  // Light / funny
+  "What’s a hot take you’re willing to defend at this table?",
+  "What’s your most useless talent?",
+  "Would you rather: perfect weather forever or perfect sleep forever?",
+  "What’s a food you pretend to like but secretly don’t?",
+  "What’s the last thing you laughed really hard at?",
+  "If animals could talk, which would be the rudest?",
+  "What’s a trend you don’t get but respect?",
+  "What’s your go-to karaoke song (or what would it be)?",
+  "What’s something everyone likes but you’re lukewarm on?",
+  "What’s a nickname you’ve had—or wish you had?",
+  // Nostalgia
+  "What’s a childhood snack or meal you still crave?",
+  "What’s the first concert or live event you remember?",
+  "What game did you play endlessly as a kid?",
+  "What’s a smell that instantly takes you back somewhere?",
+  "What’s a lesson from school you still use?",
+  "What’s something you believed as a kid that makes you laugh now?",
+  "What’s a movie you’ve watched way too many times?",
+  "What’s a friendship that started in an unexpected place?",
+  "What’s a piece of clothing or merch you wish you still had?",
+  "What’s a place you grew up that you’d show someone new?",
+  // Deeper (still party-safe)
+  "What’s something you’re proud of from the last year?",
+  "What’s a goal you’re working on right now?",
+  "What’s something kind someone did for you that stuck with you?",
+  "What’s a risk you’re glad you took?",
+  "What helps you recharge after a busy week?",
+  "What’s a cause or community you care about?",
+  "What’s a skill you’re trying to get better at?",
+  "What’s something you’ve changed your mind about?",
+  "What’s a question you wish people asked you more often?",
+  "What’s one thing you’re grateful for today?",
+];
+
+/** Random icebreaker, optionally avoiding the current prompt so "generate again" feels fresh. */
+export function getRandomIcebreakerPrompt(exclude?: string | null): string {
+  if (ICEBREAKER_PROMPTS.length === 0) return "";
+  if (ICEBREAKER_PROMPTS.length === 1) return ICEBREAKER_PROMPTS[0];
+  let next = ICEBREAKER_PROMPTS[Math.floor(Math.random() * ICEBREAKER_PROMPTS.length)];
+  let guard = 0;
+  while (exclude && next === exclude && guard < 10) {
+    next = ICEBREAKER_PROMPTS[Math.floor(Math.random() * ICEBREAKER_PROMPTS.length)];
+    guard += 1;
+  }
+  return next;
+}

package/src/index.ts

@@ -7,15 +7,19 @@ export * from "./venueLoyaltyRedemption.js";
 export * from "./stripeListingSubscriptionMessages.js";
 export * from "./extendedSchemas.js";
 export * from "./competitionIdeas.js";
+export * from "./icebreakerPrompts.js";
 export * from "./competitionValidation.js";
 export * from "./groupTicketUtils.js";
 export * from "./utils/groupTicketCartUtils.js";
 export * from "./partnerStoreTypes.js";
+export * from "./storeTypes.js";
+export * from "./storePrintArtworkUtils.js";
 export * from "./bashFeedTypes.js";
 export * from "./membershipDefinitions.js";
 export * from "./onSaleCapabilityRecommendations.js";
 export * from "./ticketBnplPaymentMethods.js";
 export * from "./aiApproval.js";
+export * from "./venueMatch.js";
 export * from "./userReportTypes.js";
 export * from "./mirroredPrismaEnums.js";
 export * from "./utils/featuredDiscoveryGeo.js";

package/src/mirroredPrismaEnums.ts

@@ -180,3 +180,19 @@ export const CreditSourceType = {
 } as const satisfies Record<CreditSourceTypeEnum, CreditSourceTypeEnum>;
 
 export type CreditSourceType = CreditSourceTypeEnum;
+
+/**
+ * Mirrors Prisma `BracketType` — includes HEAT / BATTLE_ROYALE before all consumers
+ * refresh `@prisma/client` (see README-typecheck.md).
+ */
+export const BracketType = {
+  NONE: "NONE",
+  SINGLE_ELIMINATION: "SINGLE_ELIMINATION",
+  DOUBLE_ELIMINATION: "DOUBLE_ELIMINATION",
+  ROUND_ROBIN: "ROUND_ROBIN",
+  SWISS: "SWISS",
+  HEAT: "HEAT",
+  BATTLE_ROYALE: "BATTLE_ROYALE",
+} as const;
+
+export type BracketType = (typeof BracketType)[keyof typeof BracketType];

package/src/storePrintArtworkUtils.ts

@@ -0,0 +1,93 @@
+import type { StorePrintArtwork } from "@prisma/client";
+
+import { STORE_PRINT_ARTWORK_PATHS } from "./storeTypes.js";
+
+/** Royal-blue wordmark → white knock-out for dark garments. */
+export const STORE_PRINT_ARTWORK_WHITE_KNOCKOUT: Partial<
+  Record<StorePrintArtwork, StorePrintArtwork>
+> = {
+  BashLogoBig: "BashLogoBigWhite",
+  BashLogoLetters: "BashLogoLettersWhite",
+};
+
+/** Base (royal blue) artwork for each enum value, including white variants. */
+export const STORE_PRINT_ARTWORK_BASE: Partial<
+  Record<StorePrintArtwork, StorePrintArtwork>
+> = {
+  BashLogoBig: "BashLogoBig",
+  BashLogoLetters: "BashLogoLetters",
+  BashLogoBigWhite: "BashLogoBig",
+  BashLogoLettersWhite: "BashLogoLetters",
+};
+
+const DARK_GARMENT_COLOR_TOKENS = new Set([
+  "black",
+  "charcoal",
+  "navy",
+  "dark",
+  "midnight",
+  "graphite",
+  "heather-black",
+  "dark-heather",
+  "dark-heather-grey",
+  "dark-heather-gray",
+]);
+
+/**
+ * True when a garment color name/token should use white knock-out print artwork.
+ * Accepts labels like "Black / M" or hex codes (#000, #1a1a2e).
+ */
+export function isDarkGarmentColor(garmentColor: string | null | undefined): boolean {
+  const raw = garmentColor?.trim();
+  if (!raw) return false;
+
+  const hex = raw.match(/#([0-9a-f]{3}|[0-9a-f]{6})/i)?.[0];
+  if (hex) {
+    return relativeLuminanceFromHex(hex) < 0.35;
+  }
+
+  const normalized = raw.toLowerCase().replace(/[^a-z0-9]+/g, "-");
+  for (const token of DARK_GARMENT_COLOR_TOKENS) {
+    if (normalized.includes(token)) return true;
+  }
+  return false;
+}
+
+function relativeLuminanceFromHex(hex: string): number {
+  const h = hex.replace("#", "");
+  const full =
+    h.length === 3 ? h.split("").map((c) => c + c).join("") : h.slice(0, 6);
+  const r = parseInt(full.slice(0, 2), 16) / 255;
+  const g = parseInt(full.slice(2, 4), 16) / 255;
+  const b = parseInt(full.slice(4, 6), 16) / 255;
+  const lin = (c: number) =>
+    c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+  return 0.2126 * lin(r) + 0.7152 * lin(g) + 0.0722 * lin(b);
+}
+
+/**
+ * Pick print artwork for a product SKU, optionally routing to white knock-out
+ * when the selected variant/garment color is dark.
+ */
+export function resolveStorePrintArtwork(
+  printArtwork: StorePrintArtwork | null | undefined,
+  options?: { garmentColor?: string | null }
+): StorePrintArtwork | null {
+  if (!printArtwork) return null;
+
+  const base = STORE_PRINT_ARTWORK_BASE[printArtwork] ?? printArtwork;
+  if (!options?.garmentColor || !isDarkGarmentColor(options.garmentColor)) {
+    return base;
+  }
+  return STORE_PRINT_ARTWORK_WHITE_KNOCKOUT[base] ?? printArtwork;
+}
+
+/** Public path for resolved artwork (bash-app/public). */
+export function resolveStorePrintArtworkPath(
+  printArtwork: StorePrintArtwork | null | undefined,
+  options?: { garmentColor?: string | null }
+): string | null {
+  const resolved = resolveStorePrintArtwork(printArtwork, options);
+  if (!resolved) return null;
+  return STORE_PRINT_ARTWORK_PATHS[resolved] ?? null;
+}

package/src/storeTypes.ts

@@ -0,0 +1,109 @@
+import type {
+  StoreFulfillmentProvider,
+  StorePrintArtwork,
+  StoreProductCategory,
+  StoreProductStatus,
+} from "@prisma/client";
+
+/** Public catalog row for /store listing and product detail. */
+export type StoreProductVariantPublic = {
+  id: string;
+  label: string;
+  priceCents: number | null;
+  inventory: number;
+  sortOrder: number;
+};
+
+export type StoreProductPublic = {
+  id: string;
+  slug: string;
+  title: string;
+  description: string | null;
+  images: string[];
+  priceCents: number;
+  inventory: number;
+  category: StoreProductCategory;
+  sortOrder: number;
+  printArtwork: StorePrintArtwork | null;
+  variants: StoreProductVariantPublic[];
+};
+
+/** Admin CRUD shape (includes fulfillment mapping). */
+export type StoreProductAdmin = StoreProductPublic & {
+  status: StoreProductStatus;
+  fulfillmentProvider: StoreFulfillmentProvider;
+  externalProductId: string | null;
+  printArtworkUrl: string | null;
+  variants: (StoreProductVariantPublic & {
+    externalVariantId: string | null;
+  })[];
+};
+
+export type StoreCheckoutSessionRequest = {
+  productSlug: string;
+  variantId?: string;
+  quantity?: number;
+};
+
+export type StoreCheckoutSessionResponse = {
+  checkoutUrl: string;
+  orderId: string;
+};
+
+export type StoreOrderPublic = {
+  id: string;
+  status: string;
+  fulfillmentStatus: string;
+  subtotalCents: number;
+  totalCents: number;
+  currency: string;
+  createdAt: string;
+  lines: {
+    id: string;
+    titleSnapshot: string;
+    unitPriceCents: number;
+    quantity: number;
+  }[];
+};
+
+/** Brand print artwork paths served from bash-app/public. */
+export const STORE_PRINT_ARTWORK_PATHS: Record<StorePrintArtwork, string> = {
+  BashLogoBig: "/bashLogoBig.png",
+  BashLogoLetters: "/bashLogoLetters.png",
+  BashLogoBigWhite: "/bashLogoBigWhite.png",
+  BashLogoLettersWhite: "/bashLogoLettersWhite.png",
+};
+
+export const STORE_PRODUCT_STATUS_VALUES = ["Active", "Draft", "Archived"] as const;
+export const STORE_FULFILLMENT_PROVIDER_VALUES = [
+  "Platform",
+  "Printify",
+  "Printful",
+] as const;
+export const STORE_PRINT_ARTWORK_VALUES = [
+  "BashLogoBig",
+  "BashLogoLetters",
+  "BashLogoBigWhite",
+  "BashLogoLettersWhite",
+] as const;
+
+/** Printful sync product row for admin import picker. */
+export type PrintfulSyncProductSummary = {
+  id: number;
+  name: string;
+  thumbnailUrl: string | null;
+  variantCount: number;
+};
+
+/** Normalized Printful sync product payload for Bash Store admin import. */
+export type PrintfulStoreProductImport = {
+  syncProductId: string;
+  title: string;
+  images: string[];
+  priceCents: number;
+  variants: {
+    label: string;
+    externalVariantId: string;
+    priceCents: number | null;
+  }[];
+};

package/src/venueMatch.ts

@@ -0,0 +1,202 @@
+/**
+ * Shared shapes for the Venue Match pipeline (retrieve → score → explain).
+ *
+ * The api worker owns the Zod runtime validation (api/src/services/venueMatch/);
+ * this file is the type-only source of truth read by both the api and bash-app
+ * (host suggestion cards + admin supply-leads pipeline).
+ *
+ * Persisted JSON columns map exactly to these interfaces:
+ *  - `VenueMatchRun.intent`            → `VenueMatchIntent`
+ *  - `VenueMatchCandidate.scoreBreakdown` → `VenueMatchScoreBreakdown`
+ *  - `VenueMatchCandidate.reasons`     → `string[]` (host-facing copy)
+ *  - `VenueMatchCandidate.displaySnapshot` → `VenueCandidateDisplay`
+ */
+
+/** Where a candidate came from. Mirrors prisma enum `VenueMatchCandidateSource`. */
+export const VENUE_MATCH_SOURCES = {
+  Marketplace: "Marketplace",
+  GooglePlaces: "GooglePlaces",
+} as const;
+export type VenueMatchCandidateSource =
+  (typeof VENUE_MATCH_SOURCES)[keyof typeof VENUE_MATCH_SOURCES];
+
+/** Host interaction with a surfaced candidate. Mirrors prisma enum `VenueMatchHostAction`. */
+export const VENUE_MATCH_HOST_ACTIONS = {
+  None: "None",
+  Viewed: "Viewed",
+  Accepted: "Accepted",
+  AcceptedOffPlatform: "AcceptedOffPlatform",
+  Dismissed: "Dismissed",
+  CalledPhone: "CalledPhone",
+  InvitedVenue: "InvitedVenue",
+} as const;
+export type VenueMatchHostAction =
+  (typeof VENUE_MATCH_HOST_ACTIONS)[keyof typeof VENUE_MATCH_HOST_ACTIONS];
+
+/** Sales pipeline stage. Mirrors prisma enum `VenueSupplyLeadStage`. */
+export const VENUE_SUPPLY_LEAD_STAGES = {
+  Surfaced: "Surfaced",
+  Prioritized: "Prioritized",
+  Queued: "Queued",
+  Contacted: "Contacted",
+  Interested: "Interested",
+  DemoScheduled: "DemoScheduled",
+  Listed: "Listed",
+  Declined: "Declined",
+  DoNotContact: "DoNotContact",
+} as const;
+export type VenueSupplyLeadStage =
+  (typeof VENUE_SUPPLY_LEAD_STAGES)[keyof typeof VENUE_SUPPLY_LEAD_STAGES];
+
+/** Admin display labels — single source for the pipeline UI + CSV export. */
+export const VenueSupplyLeadStageLabel: Record<VenueSupplyLeadStage, string> = {
+  Surfaced: "Surfaced",
+  Prioritized: "Hot lead",
+  Queued: "Queued for outreach",
+  Contacted: "Contacted",
+  Interested: "Interested",
+  DemoScheduled: "Demo scheduled",
+  Listed: "Listed on Bash",
+  Declined: "Declined",
+  DoNotContact: "Do not contact",
+};
+
+/** Stages a rep can manually transition to from the admin UI. */
+export const VENUE_SUPPLY_LEAD_REP_STAGES: VenueSupplyLeadStage[] = [
+  "Queued",
+  "Contacted",
+  "Interested",
+  "DemoScheduled",
+  "Declined",
+  "DoNotContact",
+];
+
+/**
+ * Structured intent extracted from the host's prompt + current event fields.
+ * Persisted as `VenueMatchRun.intent` (Json column).
+ * All fields nullable — the scorer omits weights for missing signals.
+ */
+export interface VenueMatchIntent {
+  /** e.g. "bachelor party", "baby shower" — free text, lowercased */
+  occasion: string | null;
+  /** From amountOfGuests.expected or parsed from prompt */
+  guestCount: number | null;
+  city: string | null;
+  state: string | null;
+  /** Geocoded anchor for distance scoring (host geo → profile city → event city) */
+  anchorLat: number | null;
+  anchorLng: number | null;
+  /** e.g. "upscale", "casual" */
+  vibe: string | null;
+  /** Total budget in cents if the host mentioned one */
+  budgetCents: number | null;
+  /** BashEvent.eventType at run time */
+  eventType: string | null;
+}
+
+/** Per-factor contribution. `weight` is the normalized weight actually applied (0..1). */
+export interface VenueMatchFactorScore {
+  /** Raw factor score 0..100 before weighting */
+  score: number;
+  weight: number;
+}
+
+/**
+ * Persisted as `VenueMatchCandidate.scoreBreakdown` (Json).
+ * A factor is null when its signal was unavailable and its weight
+ * was re-distributed across the others.
+ */
+export interface VenueMatchScoreBreakdown {
+  distance: VenueMatchFactorScore | null;
+  capacity: VenueMatchFactorScore | null;
+  occasion: VenueMatchFactorScore | null;
+  rating: VenueMatchFactorScore | null;
+  price: VenueMatchFactorScore | null;
+  platformQuality: VenueMatchFactorScore | null;
+}
+
+/**
+ * Snapshot of everything the host card needs, captured at run time so
+ * `GET /venue-match` never re-hits Google. Persisted as
+ * `VenueMatchCandidate.displaySnapshot` (Json).
+ */
+export interface VenueCandidateDisplay {
+  name: string;
+  photoUrl: string | null;
+  formattedAddress: string | null;
+  city: string | null;
+  state: string | null;
+  /** Bash rating for marketplace, Google rating for off-platform */
+  rating: number | null;
+  reviewCount: number | null;
+  capacity: number | null;
+  distanceMiles: number | null;
+  phone: string | null;
+  /** Marketplace only — deep link target */
+  serviceDetailPath: string | null;
+}
+
+/** One candidate as served to the host UI. */
+export interface VenueMatchCandidateView {
+  id: string;
+  rank: number;
+  score: number;
+  source: VenueMatchCandidateSource;
+  serviceId: string | null;
+  /** Venue model id (for bashEvent.venueId) when marketplace */
+  venueId: string | null;
+  googlePlaceId: string | null;
+  reasons: string[];
+  scoreBreakdown: VenueMatchScoreBreakdown;
+  display: VenueCandidateDisplay;
+  hostAction: VenueMatchHostAction;
+}
+
+/** Response of `GET /event/:id/venue-match`. */
+export interface VenueMatchRunView {
+  runId: string;
+  createdAt: string;
+  intent: VenueMatchIntent;
+  candidates: VenueMatchCandidateView[];
+}
+
+/** Row shape for the admin supply-leads table + CSV export. */
+export interface VenueSupplyLeadRow {
+  id: string;
+  name: string;
+  phoneE164: string | null;
+  city: string | null;
+  state: string | null;
+  fullAddress: string | null;
+  rating: number | null;
+  reviewCount: number | null;
+  category: string | null;
+  website: string | null;
+  googlePlaceId: string | null;
+  distinctEventCount: number;
+  topOccasions: string[];
+  firstSurfacedAt: string;
+  lastSurfacedAt: string;
+  stage: VenueSupplyLeadStage;
+  assignedToUserId: string | null;
+  assignedToName: string | null;
+  notes: string | null;
+  /** Set once the venue lists on Bash (conversion) */
+  serviceId: string | null;
+  catalogSource: string | null;
+}
+
+export interface VenueSupplyLeadStats {
+  byStage: Record<VenueSupplyLeadStage, number>;
+  total: number;
+  hotLeads: number;
+  convertedTotal: number;
+}
+
+/** Feature flag values for `VENUE_MATCH_MODE`. */
+export const VENUE_MATCH_MODES = [
+  "off",
+  "marketplace_only",
+  "marketplace_and_google",
+] as const;
+export type VenueMatchMode = (typeof VENUE_MATCH_MODES)[number];