@bash-app/bash-common 30.381.0 → 30.385.0

package/src/definitions.ts

@@ -520,6 +520,10 @@ export const DONATION_CHECKOUT_RETURN_SUCCESS_URL_PAGE =
   "/bash/${bashEventIdSlug}/donation-success/${checkoutSessionId}" as const;
 export const DONATION_CHECKOUT_RETURN_CANCEL_URL_PAGE =
   "/bash/${bashEventIdSlug}/donation-cancel/${checkoutSessionId}" as const;
+export const FUNDING_CHECKOUT_RETURN_SUCCESS_URL_PAGE =
+  "/bash/${bashEventIdSlug}/funding-success/${checkoutSessionId}" as const;
+export const FUNDING_CHECKOUT_RETURN_CANCEL_URL_PAGE =
+  "/bash/${bashEventIdSlug}/funding-cancel/${checkoutSessionId}" as const;
 
 export const SERVICE_BOOKING_CHECKOUT_RETURN_SUCCESS_URL =
   "/service/${SERVICE_ID}/${SERVICE_TYPE}/${SPECIFIC_ID}/booking/${BOOKING_ID}/checkout-return/success/{CHECKOUT_SESSION_ID}" as const; //CHECKOUT_SESSION_ID filled by stripe
@@ -550,12 +554,90 @@ export const BASH_DETAIL_URL = `/bash` as const;
 export const BASH_DETAIL_URL_PATTERN = `/bash/$bashEventIdSlug` as const;
 
 /**
- * Bash event wizard indices for the "How" major step. Must match bash-app
- * `bashEventWizardHowSubsteps.ts` / `BashEventWizard.tsx`.
+ * Bash event wizard major/substep indices. Must match `AppWizard.Step` /
+ * `SubStep` child order in bash-app `BashEventWizard.tsx`. Deep links use
+ * these names — do not hardcode `/major/sub` integers.
  */
-export const BASH_EVENT_WIZARD_HOW_MAJOR_STEP = 7;
-/** Payout / Stripe Connect substep within "How" (app `BASH_EVENT_WIZARD_HOW_SUBSTEP.PAYOUT`). */
-export const BASH_EVENT_WIZARD_HOW_SUBSTEP_PAYOUT = 8;
+export const BASH_EVENT_WIZARD_MAJOR = {
+  TEMPLATES: 0,
+  GENERATE: 1,
+  WHO: 2,
+  WHAT: 3,
+  WHERE: 4,
+  WHEN: 5,
+  WHY: 6,
+  HOW: 7,
+  FINISH: 8,
+} as const;
+
+export const BASH_EVENT_WIZARD_HOW_MAJOR_STEP = BASH_EVENT_WIZARD_MAJOR.HOW;
+
+export const BASH_EVENT_WIZARD_TEMPLATES_SUBSTEP = {
+  START: 0,
+} as const;
+
+export const BASH_EVENT_WIZARD_GENERATE_SUBSTEP = {
+  START: 0,
+} as const;
+
+export const BASH_EVENT_WIZARD_WHO_SUBSTEP = {
+  TARGET_AUDIENCE: 0,
+  CROWD_SIZE: 1,
+  PRIVACY: 2,
+  INVITEES: 3,
+  ORGANIZERS: 4,
+} as const;
+
+/** Title and Type share one SubStep (index 0). Later What pages start at Vibe. */
+export const BASH_EVENT_WIZARD_WHAT_SUBSTEP = {
+  TITLE: 0,
+  TYPE: 0,
+  VIBE_DRESS: 1,
+  SCHEDULE: 2,
+  COMPETITION: 3,
+  SIDE_QUESTS: 4,
+  POTLUCK: 5,
+  ALLOWED_NOT_ALLOWED: 6,
+  COMMUNITY: 7,
+} as const;
+
+export const BASH_EVENT_WIZARD_WHERE_SUBSTEP = {
+  LOCATION: 0,
+  UPLOAD_MEDIA: 1,
+} as const;
+
+export const BASH_EVENT_WIZARD_WHEN_SUBSTEP = {
+  DATE_TIME: 0,
+} as const;
+
+export const BASH_EVENT_WIZARD_WHY_SUBSTEP = {
+  WHY: 0,
+} as const;
+
+export const BASH_EVENT_WIZARD_HOW_SUBSTEP = {
+  PRICE: 0,
+  APPLICATION: 1,
+  PROMO_CODES: 2,
+  SPECIAL_OFFERS: 3,
+  BUDGET: 4,
+  MERCH: 5,
+  GIVEAWAYS: 6,
+  SERVICES_PARTNERS: 7,
+  TASKS: 8,
+  PAYOUT: 9,
+  WAIVERS: 10,
+  CANCELLATION_POLICIES: 11,
+  FLYER_BLAST: 12,
+  ANALYTICS: 13,
+} as const;
+
+export const BASH_EVENT_WIZARD_FINISH_SUBSTEP = {
+  START: 0,
+} as const;
+
+/** Alias for Stripe Connect / payout deep links. */
+export const BASH_EVENT_WIZARD_HOW_SUBSTEP_PAYOUT =
+  BASH_EVENT_WIZARD_HOW_SUBSTEP.PAYOUT;
 
 export const BASH_EVENT_WIZARD_PATH_PREFIX = "/bash-event-wizard" as const;
 
@@ -1122,6 +1204,19 @@ export interface StripeCreateBashEventDonationCheckoutSessionArgs extends UtmFie
   guestLastName?: string;
 }
 
+export interface StripeCreateBudgetFundingCheckoutSessionArgs extends UtmFields {
+  bashEventId: string;
+  budgetId: string;
+  currency: string;
+  paymentMethodType: string;
+  amountCents: number;
+  displayName?: string;
+  note?: string;
+  guestEmail?: string;
+  guestFirstName?: string;
+  guestLastName?: string;
+}
+
 export interface StripeCreateSetupPaymentMethodSessionArgs {
   // currency: string;
   // successUrl: string;
@@ -1318,6 +1413,68 @@ export const YearsOfExperienceToString: { [key in YearsOfExperienceEnum]: string
 
 export { BracketType, ServiceBookingSettlementStatusLabel } from "./mirroredPrismaEnums.js";
 
+// ─── Promoter Competition enums ───────────────────────────────────────────────
+// Mirrored here (standalone const objects) so they compile and work at runtime
+// before consumers re-generate @prisma/client from the updated schema.
+// Pattern matches BracketType in mirroredPrismaEnums.ts.
+
+/**
+ * Mirrors Prisma `CompetitionPurpose` — distinguishes consumer contests
+ * (vote/bracket/raffle) from ticket-sales promoter races.
+ */
+export const CompetitionPurpose = {
+  CONSUMER: "CONSUMER",
+  PROMOTER: "PROMOTER",
+} as const;
+export type CompetitionPurpose = (typeof CompetitionPurpose)[keyof typeof CompetitionPurpose];
+
+/**
+ * Mirrors Prisma `PromoterRewardMode` — how milestone rewards are calculated
+ * in a PROMOTER competition.
+ */
+export const PromoterRewardMode = {
+  TOTAL_AT_MILESTONE: "TOTAL_AT_MILESTONE",
+  ADDITIVE: "ADDITIVE",
+} as const;
+export type PromoterRewardMode = (typeof PromoterRewardMode)[keyof typeof PromoterRewardMode];
+
+/**
+ * Mirrors Prisma `PromoterRecruitMode` — who can enroll as a promoter.
+ */
+export const PromoterRecruitMode = {
+  Public: "Public",
+  InviteOnly: "InviteOnly",
+  Private: "Private",
+} as const;
+export type PromoterRecruitMode = (typeof PromoterRecruitMode)[keyof typeof PromoterRecruitMode];
+
+/**
+ * Mirrors Prisma `PromoterRewardType` — category of reward a promoter can earn.
+ */
+export const PromoterRewardType = {
+  CASH: "CASH",
+  TICKET: "TICKET",
+  TICKET_UPGRADE: "TICKET_UPGRADE",
+  TABLE: "TABLE",
+  ACCESS: "ACCESS",
+  MERCH: "MERCH",
+  SPONSOR_PRIZE: "SPONSOR_PRIZE",
+  CREDIT: "CREDIT",
+  CUSTOM: "CUSTOM",
+} as const;
+export type PromoterRewardType = (typeof PromoterRewardType)[keyof typeof PromoterRewardType];
+
+/**
+ * Mirrors Prisma `PromoterRewardStatus` — lifecycle state of a single earned reward.
+ */
+export const PromoterRewardStatus = {
+  PENDING: "PENDING",
+  EARNED: "EARNED",
+  FULFILLED: "FULFILLED",
+  REVOKED: "REVOKED",
+} as const;
+export type PromoterRewardStatus = (typeof PromoterRewardStatus)[keyof typeof PromoterRewardStatus];
+
 // Re-exported for backward compatibility during migration — see serviceTypeLabels.ts/targetAudienceLabels.ts
 // for the canonical, consolidated source (following the BracketType precedent above).
 export { SERVICE_TYPE_LABELS } from "./serviceTypeLabels.js";
@@ -1815,6 +1972,25 @@ export function canonicalBashEventRowKey(raw: string): string {
   return trimmed;
 }
 
+/**
+ * Homepage / category row key for an event's `eventType`. Blank, whitespace,
+ * and unset values group under `Other` so drafts without a picked type still
+ * appear on the home page.
+ */
+export function homepageBashEventRowKey(
+  eventType: string | null | undefined
+): string {
+  const key = canonicalBashEventRowKey(eventType ?? "");
+  return key || BashEventType.Other;
+}
+
+/** True when the wizard should treat type as unselected (blank dropdown). */
+export function isUnsetBashEventType(
+  eventType: string | null | undefined
+): boolean {
+  return homepageBashEventRowKey(eventType) === BashEventType.Other;
+}
+
 /**
  * Heading shown on the home page row and the `/category/...` page for a bash
  * `eventType` / section key. Uses plural-friendly copy for Prisma

package/src/extendedSchemas.ts

@@ -103,7 +103,11 @@ import {
   FlyerConversion,
   PostalCarrierRoute,
 } from "@prisma/client";
-import { BlogStatus, SERVICE_LINK_DATA_TO_INCLUDE } from "./definitions.js";
+import {
+  BlogStatus,
+  ItineraryItem,
+  SERVICE_LINK_DATA_TO_INCLUDE,
+} from "./definitions.js";
 
 /** Prisma model — re-exported for homepage filters and custom event type pickers. */
 export type { CustomBashEventType } from "@prisma/client";
@@ -356,8 +360,106 @@ export type CompetitionExt = Override<
   entryTicketTier?: TicketTier | null;
   sponsor?: CompetitionSponsor[];
   prizeOffers?: CompetitionPrizeOfferExt[];
+  /** PROMOTER competitions: milestone reward steps defined by the organizer. */
+  promoterMilestones?: PromoterMilestoneExt[];
+  /** PROMOTER competitions: per-promoter earned/pending/revoked reward rows. */
+  promoterRewards?: PromoterRewardExt[];
+  competitionPurpose?: string;
+  promoterSalesGoal?: number | null;
+  promoterRewardBudgetCents?: number | null;
+  promoterRewardMode?: string | null;
+  promoterRecruitMode?: string | null;
 };
 
+// ─── Promoter Competition types ───────────────────────────────────────────────
+// Defined as plain interfaces (not extending @prisma/client) because PromoterMilestone
+// and PromoterReward are new models; consumers must run `npx prisma generate` in
+// bash-common to get the generated Prisma types. These shapes mirror the schema exactly.
+
+/** Base shape of a PromoterMilestone row (mirrors Prisma model; stable before prisma generate). */
+export interface PromoterMilestoneBase {
+  id: string;
+  competitionId: string;
+  threshold: number | null;
+  rank: number | null;
+  rewardType: string; // PromoterRewardType — string union until client is regenerated
+  rewardAmountCents: number | null;
+  rewardDescription: string | null;
+  ticketTierId: string | null;
+  sponsorPrizeId: string | null;
+  displayOrder: number;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+/** PromoterMilestone row with optional reward rows loaded. */
+export interface PromoterMilestoneExt extends PromoterMilestoneBase {
+  rewards?: PromoterRewardExt[];
+  competition?: Competition | null;
+}
+
+/** Base shape of a PromoterReward row (mirrors Prisma model; stable before prisma generate). */
+export interface PromoterRewardBase {
+  id: string;
+  competitionId: string;
+  promoterId: string;
+  milestoneId: string | null;
+  rank: number | null;
+  qualifiedSalesSnapshot: number;
+  status: string; // PromoterRewardStatus — string union until client is regenerated
+  earnedAt: Date | null;
+  fulfilledAt: Date | null;
+  revokedAt: Date | null;
+  revokeReason: string | null;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+/** PromoterReward row with optional milestone and competition loaded. */
+export interface PromoterRewardExt extends PromoterRewardBase {
+  milestone?: PromoterMilestoneBase | null;
+  competition?: Competition | null;
+}
+
+/** Persisted per-promoter per-event performance record (PromoterEventPerformance model). */
+export interface PromoterEventPerformanceExt {
+  id: string;
+  promoterUserId: string;
+  bashEventId: string;
+  competitionId: string;
+  clicks: number;
+  checkoutStarts: number;
+  qualifiedOrders: number;
+  qualifiedTickets: number;
+  revenueGeneratedCents: number;
+  highestMilestoneThreshold: number | null;
+  finalRank: number | null;
+  eventCategory: string | null;
+  eventCity: string | null;
+  eventRegion: string | null;
+  joinedAt: Date;
+  lastSaleAt: Date | null;
+  completedAt: Date | null;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+/** Cross-event organizer ↔ promoter relationship (OrganizerPromoterRelationship model). */
+export interface OrganizerPromoterRelationshipExt {
+  id: string;
+  organizerUserId: string;
+  promoterUserId: string;
+  timesInvited: number;
+  timesJoined: number;
+  eventsWithSale: number;
+  totalTicketsGenerated: number;
+  totalRevenueGeneratedCents: number;
+  lastWorkedTogetherAt: Date | null;
+  lastInvitedAt: Date;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
 /** One row in BashEvent.merchandiseItems (host wizard; informational catalog) */
 export type BashEventHostMerchItem = {
   id: string;
@@ -514,6 +616,8 @@ type BashEventExtBase = Override<
   venue?: Venue | null;
   /** Host organization when included on the event payload */
   organization?: Pick<Organization, "id" | "name" | "slug" | "logoUrl"> | null;
+  /** Host-as-service identity when included on the event payload */
+  hostedByService?: ServiceRefLite | null;
   targetAudience?: TargetAudience;
   amountOfGuests?: AmountOfGuests;
   recurrence?: Recurrence;
@@ -550,6 +654,12 @@ type BashEventExtBase = Override<
   goingCount?: number;
   /** GET /event/:id — true when at least one Budget line has `showOnBashDetailPage` set. Drives the "View budget" reveal on the public bash page; never carries dollar amounts. */
   hasVisibleBudget?: boolean;
+  /** Public funding meter: value coming in toward included budget lines. */
+  showFundingMeter?: boolean;
+  /** When false, guests do not see host identity on cards or Meet the host. */
+  showHostOnBashPage?: boolean;
+  fundingAllowCommitments?: boolean;
+  fundingShowPledgesOnMeter?: boolean;
   /** GET /event/:id when status=Idea — total IdeaInterest rows */
   ideaInterestCount?: number;
   /** Feed/card alias for idea interest (some list payloads use this name). */
@@ -576,6 +686,8 @@ type BashEventExtBase = Override<
   };
   /** GET /event/:id and GET /public-event/:id (authenticated) when accessScreeningEnabled — viewer's latest access request status */
   myAccessRequestStatus?: "None" | "Pending" | "Approved" | "Denied" | null;
+  /** Public pending + approved application / RSVP totals when Application is on. Hidden at 0. */
+  applicationApplicantCount?: number;
   /** GET /event/:id when status=Idea — viewer's IdeaInterest row (matched by email) */
   myIdeaInterest?:
     | (IdeaInterest & { responses: IdeaInterestResponse[] })
@@ -655,6 +767,14 @@ export type BashEventUpsertWireInput = Override<
   {
     /** Explicit null clears recurrence (API deleteMany on Recurrence rows). */
     recurrence?: DeepPartial<Recurrence> | null;
+    /** Upsert merges partial guest-count fields (see upsertAmountOfGuests). */
+    amountOfGuests?: Partial<AmountOfGuests>;
+    /** Upsert merges partial audience fields (see upsertTargetAudience). */
+    targetAudience?: Partial<TargetAudience>;
+    /** Wizard itinerary blocks stored as BashEvent.itinerary JSON. */
+    itinerary?: ItineraryItem[] | Prisma.JsonValue | null;
+    /** Delete these competition ids on upsert (does not clear other competitions). */
+    removeCompetitionIds?: string[];
   }
 >;
 
@@ -689,6 +809,12 @@ export const BASH_EVENT_DATA_TO_INCLUDE = {
   creator: {
     select: FRONT_END_USER_DATA_TO_SELECT,
   },
+  organization: {
+    select: { id: true, name: true, slug: true, logoUrl: true },
+  },
+  hostedByService: {
+    select: SERVICE_REF_LITE_SELECT,
+  },
   payoutUser: {
     select: { givenName: true, familyName: true, email: true },
   },

package/src/fundingMeter.ts

@@ -0,0 +1,188 @@
+/**
+ * Public funding meter contract — value coming in toward included budget lines.
+ * Consumers may copy these types until this package is published with this module.
+ */
+
+export const BUDGET_FUNDING_CHECKOUT_PURPOSE = "budget_funding" as const;
+
+export type BudgetContributionKind = "Cash" | "InKind";
+export type BudgetContributionStatus =
+  | "Pledged"
+  | "Paid"
+  | "Fulfilled"
+  | "Declined"
+  | "Cancelled";
+export type BudgetContributionSource = "Stripe" | "HostEntered" | "PublicPledge";
+
+export type FundingMeterLine = {
+  budgetId: string;
+  name: string;
+  category: string | null;
+  allocatedCents: number;
+  collectedCents: number;
+  pledgedCents: number;
+  remainingCents: number;
+};
+
+export type FundingMeterPledge = {
+  displayName: string;
+  amountCents: number;
+  kind: BudgetContributionKind;
+  note: string | null;
+  budgetName: string | null;
+};
+
+export type FundingMeterProgress = {
+  showFundingMeter: boolean;
+  fundingAllowCommitments: boolean;
+  fundingShowPledgesOnMeter: boolean;
+  hostStripeConnected: boolean;
+  goalCents: number;
+  collectedCents: number;
+  pledgedCents: number;
+  unallocatedCents: number;
+  percentFunded: number;
+  lines: FundingMeterLine[];
+  pledges: FundingMeterPledge[];
+  unallocated: FundingMeterPledge[];
+};
+
+export type FundingContributionForProgress = {
+  budgetId: string | null;
+  amountCents: number;
+  kind: BudgetContributionKind;
+  status: BudgetContributionStatus;
+  source: BudgetContributionSource;
+  displayName: string;
+  note: string | null;
+};
+
+export type FundingLineForProgress = {
+  id: string;
+  name: string;
+  category: string | null;
+  totalAllocatedCents: number;
+  includeOnFundingMeter: boolean;
+};
+
+const INACTIVE: ReadonlySet<BudgetContributionStatus> = new Set([
+  "Declined",
+  "Cancelled",
+]);
+
+/** Line-attached collected: Stripe Paid + host-entered (cash Paid or in-kind Fulfilled/Paid). */
+export function contributionCountsAsCollected(
+  row: FundingContributionForProgress
+): boolean {
+  if (INACTIVE.has(row.status)) return false;
+  if (row.source === "HostEntered") {
+    return row.status === "Paid" || row.status === "Fulfilled";
+  }
+  return row.status === "Paid";
+}
+
+export function contributionCountsAsOpenPledge(
+  row: FundingContributionForProgress
+): boolean {
+  return row.status === "Pledged";
+}
+
+export function computeFundingMeterProgress(input: {
+  showFundingMeter: boolean;
+  fundingAllowCommitments: boolean;
+  fundingShowPledgesOnMeter: boolean;
+  hostStripeConnected: boolean;
+  lines: FundingLineForProgress[];
+  contributions: FundingContributionForProgress[];
+}): FundingMeterProgress {
+  const included = input.lines.filter((line) => line.includeOnFundingMeter);
+  const includedIds = new Set(included.map((line) => line.id));
+  const nameById = new Map(input.lines.map((line) => [line.id, line.name]));
+
+  const goalCents = included.reduce((sum, line) => sum + line.totalAllocatedCents, 0);
+
+  let collectedCents = 0;
+  let pledgedCents = 0;
+  let unallocatedCents = 0;
+  const collectedByLine = new Map<string, number>();
+  const pledgedByLine = new Map<string, number>();
+  const pledges: FundingMeterPledge[] = [];
+  const unallocated: FundingMeterPledge[] = [];
+
+  for (const row of input.contributions) {
+    if (INACTIVE.has(row.status)) continue;
+
+    const isCollected = contributionCountsAsCollected(row);
+    const isPledge = contributionCountsAsOpenPledge(row);
+
+    if (!row.budgetId) {
+      if (isCollected || isPledge) {
+        unallocatedCents += row.amountCents;
+        unallocated.push({
+          displayName: row.displayName,
+          amountCents: row.amountCents,
+          kind: row.kind,
+          note: row.note,
+          budgetName: null,
+        });
+      }
+      continue;
+    }
+
+    if (!includedIds.has(row.budgetId)) continue;
+
+    if (isCollected) {
+      collectedCents += row.amountCents;
+      collectedByLine.set(
+        row.budgetId,
+        (collectedByLine.get(row.budgetId) ?? 0) + row.amountCents
+      );
+    }
+    if (isPledge) {
+      pledgedCents += row.amountCents;
+      pledgedByLine.set(
+        row.budgetId,
+        (pledgedByLine.get(row.budgetId) ?? 0) + row.amountCents
+      );
+      pledges.push({
+        displayName: row.displayName,
+        amountCents: row.amountCents,
+        kind: row.kind,
+        note: row.note,
+        budgetName: nameById.get(row.budgetId) ?? null,
+      });
+    }
+  }
+
+  const lines: FundingMeterLine[] = included.map((line) => {
+    const lineCollected = collectedByLine.get(line.id) ?? 0;
+    const linePledged = pledgedByLine.get(line.id) ?? 0;
+    return {
+      budgetId: line.id,
+      name: line.name,
+      category: line.category,
+      allocatedCents: line.totalAllocatedCents,
+      collectedCents: lineCollected,
+      pledgedCents: linePledged,
+      remainingCents: Math.max(0, line.totalAllocatedCents - lineCollected),
+    };
+  });
+
+  const percentFunded =
+    goalCents > 0 ? Math.min(100, Math.round((collectedCents / goalCents) * 100)) : 0;
+
+  return {
+    showFundingMeter: input.showFundingMeter,
+    fundingAllowCommitments: input.fundingAllowCommitments,
+    fundingShowPledgesOnMeter: input.fundingShowPledgesOnMeter,
+    hostStripeConnected: input.hostStripeConnected,
+    goalCents,
+    collectedCents,
+    pledgedCents,
+    unallocatedCents,
+    percentFunded,
+    lines,
+    pledges,
+    unallocated,
+  };
+}