@bash-app/bash-common 30.329.0 → 30.331.0

package/src/hostPromoter.ts

@@ -0,0 +1,321 @@
+/**
+ * Host street-team roster (Community Builder → Promoters).
+ * Distinct from per-bash `Promoter` promo-code rows and hireable marketing bookings.
+ */
+
+import type { InfluencerAudienceTier } from "@prisma/client";
+
+import {
+  INFLUENCER_AUDIENCE_TIERS,
+  type InfluencerAudienceTierId,
+} from "./influencerAudience.js";
+
+export const HOST_PROMOTER_KIND = {
+  PromoCode: "PromoCode",
+  EventPromoter: "EventPromoter",
+  Influencer: "Influencer",
+  ContentCreator: "ContentCreator",
+  Model: "Model",
+  BrandAmbassador: "BrandAmbassador",
+} as const;
+
+export type HostPromoterKind =
+  (typeof HOST_PROMOTER_KIND)[keyof typeof HOST_PROMOTER_KIND];
+
+export const HOST_PROMOTER_KIND_LABELS: Record<HostPromoterKind, string> = {
+  PromoCode: "Promo code",
+  EventPromoter: "Event Promoter",
+  Influencer: "Influencer",
+  ContentCreator: "Content creator",
+  Model: "Model",
+  BrandAmbassador: "Brand ambassador",
+};
+
+/** Hireable Promotion & Marketing subtypes that sync onto the street-team roster. */
+export const HOST_PROMOTER_SYNC_SERVICE_SUBTYPES = [
+  "Promoter",
+  "Influencer",
+  "ContentCreator",
+  "Model",
+  "BrandAmbassador",
+] as const;
+
+export type HostPromoterSyncServiceSubType =
+  (typeof HOST_PROMOTER_SYNC_SERVICE_SUBTYPES)[number];
+
+export function hostPromoterKindFromEventServiceSubType(
+  subType: string | null | undefined
+): HostPromoterKind | null {
+  switch (subType) {
+    case "Promoter":
+      return HOST_PROMOTER_KIND.EventPromoter;
+    case "Influencer":
+      return HOST_PROMOTER_KIND.Influencer;
+    case "ContentCreator":
+      return HOST_PROMOTER_KIND.ContentCreator;
+    case "Model":
+      return HOST_PROMOTER_KIND.Model;
+    case "BrandAmbassador":
+      return HOST_PROMOTER_KIND.BrandAmbassador;
+    default:
+      return null;
+  }
+}
+
+/** Inverse of sync mapping — PromoCode has no hireable EventService subtype. */
+export function eventServiceSubTypeFromHostPromoterKind(
+  kind: HostPromoterKind | string | null | undefined
+): HostPromoterSyncServiceSubType | null {
+  switch (kind) {
+    case HOST_PROMOTER_KIND.EventPromoter:
+      return "Promoter";
+    case HOST_PROMOTER_KIND.Influencer:
+      return "Influencer";
+    case HOST_PROMOTER_KIND.ContentCreator:
+      return "ContentCreator";
+    case HOST_PROMOTER_KIND.Model:
+      return "Model";
+    case HOST_PROMOTER_KIND.BrandAmbassador:
+      return "BrandAmbassador";
+    default:
+      return null;
+  }
+}
+
+/** Kinds that can be hired via EventService marketplace booking. */
+export const HOST_PROMOTER_HIREABLE_KINDS = [
+  HOST_PROMOTER_KIND.EventPromoter,
+  HOST_PROMOTER_KIND.Influencer,
+  HOST_PROMOTER_KIND.ContentCreator,
+  HOST_PROMOTER_KIND.Model,
+  HOST_PROMOTER_KIND.BrandAmbassador,
+] as const;
+
+export function isHostPromoterHireableKind(
+  kind: string | null | undefined
+): kind is (typeof HOST_PROMOTER_HIREABLE_KINDS)[number] {
+  return (
+    !!kind &&
+    (HOST_PROMOTER_HIREABLE_KINDS as readonly string[]).includes(kind)
+  );
+}
+
+/**
+ * Deep link into a hireable EventService detail page, optionally preselecting a bash.
+ */
+export function buildHireStreetTeamServiceDeepLink(args: {
+  serviceId: string;
+  eventServiceId: string;
+  bashEventId?: string | null;
+}): string {
+  const base = `/services/${args.serviceId}/EventServices/${args.eventServiceId}`;
+  if (!args.bashEventId) return base;
+  return `${base}?bashEventId=${encodeURIComponent(args.bashEventId)}`;
+}
+
+export type HostPromoterHireableService = {
+  serviceId: string;
+  eventServiceId: string;
+  eventServiceSubType: string;
+  title: string | null;
+};
+
+export function isHostPromoterSyncServiceSubType(
+  subType: string | null | undefined
+): subType is HostPromoterSyncServiceSubType {
+  return (
+    !!subType &&
+    (HOST_PROMOTER_SYNC_SERVICE_SUBTYPES as readonly string[]).includes(subType)
+  );
+}
+
+export const HOST_PROMOTER_SOURCE = {
+  Manual: "Manual",
+  PastPromoCode: "PastPromoCode",
+  PastEventBooking: "PastEventBooking",
+} as const;
+
+export type HostPromoterSource =
+  (typeof HOST_PROMOTER_SOURCE)[keyof typeof HOST_PROMOTER_SOURCE];
+
+/** Mirrors Prisma `HostPromoterStatus` for browser-safe imports. */
+export const HostPromoterStatus = {
+  Active: "Active",
+  Archived: "Archived",
+} as const;
+export type HostPromoterStatus =
+  (typeof HostPromoterStatus)[keyof typeof HostPromoterStatus];
+
+/** Mirrors Prisma `HostPromoterPayoutStatus`. */
+export const HostPromoterPayoutStatus = {
+  Unpaid: "Unpaid",
+  Paid: "Paid",
+  Cancelled: "Cancelled",
+} as const;
+export type HostPromoterPayoutStatus =
+  (typeof HostPromoterPayoutStatus)[keyof typeof HostPromoterPayoutStatus];
+
+/** Mirrors Prisma `HostPromoterPayoutMethod`. */
+export const HostPromoterPayoutMethod = {
+  Venmo: "Venmo",
+  Zelle: "Zelle",
+  CashApp: "CashApp",
+  Cash: "Cash",
+  Other: "Other",
+} as const;
+export type HostPromoterPayoutMethod =
+  (typeof HostPromoterPayoutMethod)[keyof typeof HostPromoterPayoutMethod];
+
+/** Mirrors Prisma `HostPromoterPayoutChannel`. */
+export const HostPromoterPayoutChannel = {
+  OffPlatform: "OffPlatform",
+  Platform: "Platform",
+} as const;
+export type HostPromoterPayoutChannel =
+  (typeof HostPromoterPayoutChannel)[keyof typeof HostPromoterPayoutChannel];
+
+/** Re-export influencer tier ids for roster forms (Nano / Micro / Macro / Mega). */
+export const HOST_PROMOTER_INFLUENCER_TIERS = INFLUENCER_AUDIENCE_TIERS;
+export type HostPromoterInfluencerTier = InfluencerAudienceTierId;
+
+export function isHostPromoterInfluencerTier(
+  value: string | null | undefined
+): value is HostPromoterInfluencerTier {
+  return (
+    !!value &&
+    (INFLUENCER_AUDIENCE_TIERS as readonly string[]).includes(value)
+  );
+}
+
+export type HostPromoterPayoutSummary = {
+  id: string;
+  amountCents: number;
+  currency: string;
+  status: HostPromoterPayoutStatus;
+  method: HostPromoterPayoutMethod;
+  channel: HostPromoterPayoutChannel;
+  stripeCheckoutSessionId: string | null;
+  platformFeeCents: number;
+  paidAt: string | null;
+  note: string | null;
+  bashEventId: string | null;
+  bashEventTitle: string | null;
+  serviceBookingId: string | null;
+  createdAt: string;
+};
+
+export type HostPromoterPayoutReadiness = {
+  payable: boolean;
+  reason?: "no_bash_account" | "not_connected" | "onboarding_incomplete";
+};
+
+export type HostPromoterStripePayoutCreateInput = {
+  amountCents: number;
+  bashEventId?: string | null;
+  note?: string | null;
+};
+
+export type HostPromoterListItem = {
+  id: string;
+  email: string;
+  displayName: string | null;
+  promoterUserId: string | null;
+  kinds: HostPromoterKind[];
+  status: HostPromoterStatus;
+  notes: string | null;
+  defaultBashPointsRewardPerTicket: number | null;
+  /** Nano / Micro / Macro / Mega when this person is (also) an Influencer. */
+  influencerAudienceTier: InfluencerAudienceTier | null;
+  sources: HostPromoterSource[];
+  lastPromotedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+  /** Known Venmo/Zelle/CashApp handle from User.paymentHandle when linked. */
+  paymentHandle: string | null;
+  /** Distinct bashes this person had a Promoter / marketing booking on for this host. */
+  bashesPromotedCount: number;
+  /** Non-cancelled tickets attributed via this person's promo codes on host bashes. */
+  ticketsAttributed: number;
+  /** Sum of Promoter.creditsGenerated across host bashes (BashPoints). */
+  bashPointsEarned: number;
+  unpaidCashCents: number;
+  /** Open (non-Settled) Event Promoter booking count for this person. */
+  openEventPromoterBookings: number;
+  payouts: HostPromoterPayoutSummary[];
+};
+
+export type HostPromoterCreateInput = {
+  email: string;
+  displayName?: string | null;
+  kinds?: HostPromoterKind[];
+  notes?: string | null;
+  defaultBashPointsRewardPerTicket?: number | null;
+  influencerAudienceTier?: HostPromoterInfluencerTier | null;
+};
+
+export type HostPromoterUpdateInput = {
+  displayName?: string | null;
+  kinds?: HostPromoterKind[];
+  status?: HostPromoterStatus;
+  notes?: string | null;
+  defaultBashPointsRewardPerTicket?: number | null;
+  influencerAudienceTier?: HostPromoterInfluencerTier | null;
+};
+
+export type HostPromoterInviteToBashInput = {
+  hostPromoterIds: string[];
+  bashEventId: string;
+  ticketTierId: string;
+  codePrefix?: string | null;
+  bashPointsRewardPerTicket?: number | null;
+  discountAmountPercentage?: number | null;
+};
+
+export type HostPromoterInviteResult = {
+  hostPromoterId: string;
+  email: string;
+  promoCodeId: string;
+  code: string;
+  error?: string;
+};
+
+export type HostPromoterPayoutCreateInput = {
+  amountCents: number;
+  method?: HostPromoterPayoutMethod;
+  note?: string | null;
+  bashEventId?: string | null;
+  serviceBookingId?: string | null;
+  channel?: HostPromoterPayoutChannel;
+};
+
+export type HostPromoterPayoutUpdateInput = {
+  status?: HostPromoterPayoutStatus;
+  method?: HostPromoterPayoutMethod;
+  note?: string | null;
+  paidAt?: string | null;
+};
+
+export type HostPromoterEventBookingSummary = {
+  id: string;
+  bashEventId: string | null;
+  bashEventTitle: string | null;
+  promoterUserId: string | null;
+  promoterName: string;
+  promoterEmail: string | null;
+  hostPromoterId: string | null;
+  eventServiceSubType: string | null;
+  expectedAttendeesAtBooking: number | null;
+  checkedInAttendeesAtSettle: number | null;
+  maxAttendeesAttributable: number | null;
+  depositCents: number | null;
+  settlementDeltaCents: number | null;
+  settlementStatus: string;
+  settledAt: string | null;
+};
+
+export type HostPromoterSettlementSummary = {
+  unpaidCashCents: number;
+  unpaidCashCount: number;
+  openEventPromoterBookings: HostPromoterEventBookingSummary[];
+  totalBashPointsEarned: number;
+};

package/src/index.ts

@@ -35,9 +35,11 @@ export * from "./hostCrmInsights.js";
 export * from "./hostCrmAutomation.js";
 export * from "./relationshipHealth.js";
 export * from "./hostCrmConstants.js";
+export * from "./hostPromoter.js";
 export * from "./bashEventCancellationPolicy.js";
 export * from "./userReportTypes.js";
 export * from "./mirroredPrismaEnums.js";
+export * from "./locationShare.js";
 export * from "./utils/featuredDiscoveryGeo.js";
 export * from "./utils/organizationEntitlements.js";
 export * from "./serviceTypeLabels.js";

package/src/locationShare.ts

@@ -0,0 +1,173 @@
+/**
+ * Event location sharing — consented near-live pins for bash participants
+ * (host / organizers / co-hosts, live task assignees, hired providers).
+ */
+
+import type { Prisma } from "@prisma/client";
+
+import { PUBLIC_TEASER_USER_DATA_TO_SELECT } from "./extendedSchemas.js";
+
+/** Grace after event end before an Active session auto-expires. */
+export const LOCATION_SHARE_GRACE_MS = 4 * 60 * 60 * 1000;
+
+/** Fallback TTL when the bash has no start/end times. */
+export const LOCATION_SHARE_DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;
+
+/** Fallback window after start when end is missing. */
+export const LOCATION_SHARE_START_FALLBACK_MS = 12 * 60 * 60 * 1000;
+
+export const LocationShareStatus = {
+  Active: "Active",
+  Stopped: "Stopped",
+  Expired: "Expired",
+} as const;
+
+export type LocationShareStatus =
+  (typeof LocationShareStatus)[keyof typeof LocationShareStatus];
+
+/** EventTask statuses that allow location share (assignee). */
+export const LOCATION_SHARE_TASK_STATUSES = [
+  "Accepted",
+  "Assigned",
+  "InProgress",
+] as const;
+
+export type LocationShareTaskStatus =
+  (typeof LOCATION_SHARE_TASK_STATUSES)[number];
+
+/** ServiceBooking statuses that allow location share (provider). */
+export const LOCATION_SHARE_BOOKING_STATUSES = [
+  "Approved",
+  "Confirmed",
+] as const;
+
+export type LocationShareBookingStatus =
+  (typeof LOCATION_SHARE_BOOKING_STATUSES)[number];
+
+export function isLocationShareLiveTaskStatus(
+  status: string | null | undefined
+): status is LocationShareTaskStatus {
+  return (
+    status != null &&
+    (LOCATION_SHARE_TASK_STATUSES as readonly string[]).includes(status)
+  );
+}
+
+export function isLocationShareLiveBookingStatus(
+  status: string | null | undefined
+): status is LocationShareBookingStatus {
+  return (
+    status != null &&
+    (LOCATION_SHARE_BOOKING_STATUSES as readonly string[]).includes(status)
+  );
+}
+
+/**
+ * True when the user is the event creator or an AssociatedBash organizer/co-host.
+ * Super-users are intentionally not included.
+ */
+export function isLocationShareCrewMember(
+  userId: string | null | undefined,
+  bash: { creatorId: string },
+  association?: {
+    isOrganizer?: boolean | null;
+    isCoHost?: boolean | null;
+  } | null
+): boolean {
+  if (!userId) return false;
+  if (userId === bash.creatorId) return true;
+  if (association?.isOrganizer === true || association?.isCoHost === true) {
+    return true;
+  }
+  return false;
+}
+
+/**
+ * Sync eligibility when the caller already knows task/booking flags
+ * (e.g. tests or UI that prefetched live assignment). API resolves flags via Prisma.
+ */
+export function isLocationShareEventParticipant(
+  userId: string | null | undefined,
+  bash: { creatorId: string },
+  options?: {
+    association?: {
+      isOrganizer?: boolean | null;
+      isCoHost?: boolean | null;
+    } | null;
+    hasLiveTaskAssignment?: boolean;
+    hasLiveHiredBooking?: boolean;
+    /** Active promo-code promoter row for this bash (`Promoter.userId` + `isActive`). */
+    hasActivePromoterRole?: boolean;
+  }
+): boolean {
+  if (
+    isLocationShareCrewMember(userId, bash, options?.association ?? null)
+  ) {
+    return true;
+  }
+  if (!userId) return false;
+  return Boolean(
+    options?.hasLiveTaskAssignment ||
+      options?.hasLiveHiredBooking ||
+      options?.hasActivePromoterRole
+  );
+}
+
+/**
+ * Compute session expiry from bash times (end + grace, else start + 12h, else now + 24h).
+ */
+export function computeLocationShareExpiresAt(
+  bash: {
+    startDateTime?: Date | string | null;
+    endDateTime?: Date | string | null;
+  },
+  now: Date = new Date()
+): Date {
+  const end = bash.endDateTime ? new Date(bash.endDateTime) : null;
+  if (end && !Number.isNaN(end.getTime())) {
+    return new Date(end.getTime() + LOCATION_SHARE_GRACE_MS);
+  }
+  const start = bash.startDateTime ? new Date(bash.startDateTime) : null;
+  if (start && !Number.isNaN(start.getTime())) {
+    return new Date(start.getTime() + LOCATION_SHARE_START_FALLBACK_MS);
+  }
+  return new Date(now.getTime() + LOCATION_SHARE_DEFAULT_TTL_MS);
+}
+
+export const LOCATION_SHARE_SESSION_USER_SELECT = {
+  ...PUBLIC_TEASER_USER_DATA_TO_SELECT,
+} satisfies Prisma.UserSelect;
+
+export const LOCATION_SHARE_SESSION_LIST_SELECT = {
+  id: true,
+  bashEventId: true,
+  userId: true,
+  status: true,
+  startedAt: true,
+  expiresAt: true,
+  stoppedAt: true,
+  lastLat: true,
+  lastLng: true,
+  lastAccuracyM: true,
+  lastUpdatedAt: true,
+  user: { select: LOCATION_SHARE_SESSION_USER_SELECT },
+} satisfies Prisma.LocationShareSessionSelect;
+
+export type LocationShareSessionListItem = Prisma.LocationShareSessionGetPayload<{
+  select: typeof LOCATION_SHARE_SESSION_LIST_SELECT;
+}>;
+
+export type LocationShareMySession = Pick<
+  LocationShareSessionListItem,
+  | "id"
+  | "bashEventId"
+  | "userId"
+  | "status"
+  | "startedAt"
+  | "expiresAt"
+  | "stoppedAt"
+  | "lastLat"
+  | "lastLng"
+  | "lastAccuracyM"
+  | "lastUpdatedAt"
+>;