@bash-app/bash-common 30.329.0 → 30.331.0

package/dist/locationShare.js

@@ -0,0 +1,95 @@
+/**
+ * Event location sharing — consented near-live pins for bash participants
+ * (host / organizers / co-hosts, live task assignees, hired providers).
+ */
+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",
+};
+/** EventTask statuses that allow location share (assignee). */
+export const LOCATION_SHARE_TASK_STATUSES = [
+    "Accepted",
+    "Assigned",
+    "InProgress",
+];
+/** ServiceBooking statuses that allow location share (provider). */
+export const LOCATION_SHARE_BOOKING_STATUSES = [
+    "Approved",
+    "Confirmed",
+];
+export function isLocationShareLiveTaskStatus(status) {
+    return (status != null &&
+        LOCATION_SHARE_TASK_STATUSES.includes(status));
+}
+export function isLocationShareLiveBookingStatus(status) {
+    return (status != null &&
+        LOCATION_SHARE_BOOKING_STATUSES.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, bash, association) {
+    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, bash, options) {
+    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, now = new 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,
+};
+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 },
+};
+//# sourceMappingURL=locationShare.js.map

package/dist/locationShare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locationShare.js","sourceRoot":"","sources":["../src/locationShare.ts"],"names":[],"mappings":"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"}

package/package.json

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

package/prisma/schema.prisma

@@ -1028,6 +1028,7 @@ model BashEvent {
   sponsorships                    SponsoredEvent[]
   tickets                         Ticket[]
   hostCrmCommunityPromptDismisses HostCrmCommunityPromptDismiss[]
+  hostPromoterPayouts             HostPromoterPayout[]
   ticketGiftGrants                TicketGiftGrant[]
   ticketTiers                     TicketTier[]
   tierReleaseReminders            TierReleaseReminder[]
@@ -1135,6 +1136,9 @@ model BashEvent {
   promotionBlasts            PromotionBlast[]
   orgPromotionalPackages     OrgPromotionalPackage[]
 
+  /// Crew location sharing (host + organizers/co-hosts opt-in near-live pins)
+  locationShareSessions LocationShareSession[]
+
   @@index([templateId])
   @@index([parentEventId])
   @@index([organizationId])
@@ -2504,6 +2508,36 @@ model EventNetworkingOptIn {
   @@index([bashEventId])
 }
 
+/// Consented near-live location share for bash crew (host / organizers / co-hosts).
+/// One row per (bashEventId, userId); restart reactivates the same row.
+/// Follow-ons (tasks, door staff, service bookings) can extend audience rules without a second GPS stack.
+model LocationShareSession {
+  id             String                 @id @default(cuid())
+  bashEventId    String
+  userId         String
+  status         LocationShareStatus    @default(Active)
+  startedAt      DateTime               @default(now())
+  expiresAt      DateTime
+  stoppedAt      DateTime?
+  lastLat        Float?
+  lastLng        Float?
+  lastAccuracyM  Float?
+  lastUpdatedAt  DateTime?
+
+  bashEvent BashEvent @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  user      User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([bashEventId, userId])
+  @@index([bashEventId, status, lastUpdatedAt])
+  @@index([userId, status])
+}
+
+enum LocationShareStatus {
+  Active
+  Stopped
+  Expired
+}
+
 /// Host-scoped CRM row for a past guest (VIP tags, notes)
 model HostAttendeeProfile {
   id             String   @id @default(cuid())
@@ -2568,6 +2602,91 @@ model HostCrmCommunityPromptDismiss {
   @@index([hostUserId])
 }
 
+/// Host-owned promoter roster (Community Builder → Promoters).
+/// Distinct from per-bash `Promoter` (promo-code assignment) and hireable Event Promoter bookings.
+model HostPromoter {
+  id                               String             @id @default(cuid())
+  hostUserId                       String
+  /// Linked Bash user when known; null for email-only ad-hoc / pending invites.
+  promoterUserId                   String?
+  /// Normalized lowercase email (required for ad-hoc add and invite).
+  email                            String
+  displayName                      String?
+  /// "PromoCode" | "EventPromoter" | "Influencer" | "ContentCreator" | "Model" | "BrandAmbassador"
+  kinds                            String[]                 @default([])
+  status                           HostPromoterStatus       @default(Active)
+  notes                            String?                  @db.Text
+  defaultBashPointsRewardPerTicket Int?
+  /// Nano / Micro / Macro / Mega when kinds includes Influencer (optional).
+  influencerAudienceTier           InfluencerAudienceTier?
+  /// "Manual" | "PastPromoCode" | "PastEventBooking"
+  sources                          String[]                 @default([])
+  lastPromotedAt                   DateTime?
+  createdAt                        DateTime                 @default(now())
+  updatedAt                        DateTime                 @updatedAt
+
+  host     User                @relation("HostPromotersOwned", fields: [hostUserId], references: [id], onDelete: Cascade)
+  promoter User?               @relation("HostPromotersAsPromoter", fields: [promoterUserId], references: [id], onDelete: SetNull)
+  payouts  HostPromoterPayout[]
+
+  @@unique([hostUserId, email])
+  @@index([hostUserId, status])
+  @@index([hostUserId, promoterUserId])
+}
+
+enum HostPromoterStatus {
+  Active
+  Archived
+}
+
+/// Off-platform cash ledger OR platform Stripe Connect payout for host bookkeeping.
+/// OffPlatform does not move money. Platform uses Checkout + Connect destination transfer.
+model HostPromoterPayout {
+  id                      String                     @id @default(cuid())
+  hostPromoterId          String
+  bashEventId             String?
+  serviceBookingId        String?
+  amountCents             Int
+  currency                String                     @default("usd")
+  status                  HostPromoterPayoutStatus   @default(Unpaid)
+  method                  HostPromoterPayoutMethod   @default(Other)
+  channel                 HostPromoterPayoutChannel  @default(OffPlatform)
+  stripeCheckoutSessionId String?
+  stripePaymentIntentId   String?
+  platformFeeCents        Int                        @default(0)
+  paidAt                  DateTime?
+  note                    String?                    @db.Text
+  createdAt               DateTime                   @default(now())
+  updatedAt               DateTime                   @updatedAt
+
+  hostPromoter   HostPromoter    @relation(fields: [hostPromoterId], references: [id], onDelete: Cascade)
+  bashEvent      BashEvent?      @relation(fields: [bashEventId], references: [id], onDelete: SetNull)
+  serviceBooking ServiceBooking? @relation(fields: [serviceBookingId], references: [id], onDelete: SetNull)
+
+  @@index([hostPromoterId, status])
+  @@index([bashEventId])
+  @@index([serviceBookingId])
+}
+
+enum HostPromoterPayoutStatus {
+  Unpaid
+  Paid
+  Cancelled
+}
+
+enum HostPromoterPayoutMethod {
+  Venmo
+  Zelle
+  CashApp
+  Cash
+  Other
+}
+
+enum HostPromoterPayoutChannel {
+  OffPlatform
+  Platform
+}
+
 /// Host-defined reusable CRM audience filters (tag, cadence, lapsed, cohorts).
 model HostCrmSavedSegment {
   id         String   @id @default(cuid())
@@ -3036,6 +3155,8 @@ model Ticket {
   invitationId               String?
   checkoutId                 String?
   checkedInMethod            String?      @default("manual")
+  /// Door staff user who confirmed cash collected (door_cash path).
+  cashMarkedById             String?
   waitlistPosition           Int?
   waitlistJoinedAt           DateTime?
   waitlistNotifiedAt         DateTime?
@@ -3878,6 +3999,7 @@ model User {
 
   associatedBashes               AssociatedBash[]
   associatedServices             AssociatedService[]
+  locationShareSessions          LocationShareSession[]
   comment                        BashComment[]
   referredTransactions           BashCreditTransaction[]      @relation("ReferredUser")
   creditTransactions             BashCreditTransaction[]
@@ -4045,6 +4167,8 @@ model User {
   hostAttendeeActivityAsHost    HostAttendeeActivity[]  @relation("HostAttendeeActivityHost")
   hostAttendeeActivityAsTarget  HostAttendeeActivity[]  @relation("HostAttendeeActivityAttendee")
   hostCrmCommunityPromptDismisses HostCrmCommunityPromptDismiss[] @relation("HostCrmCommunityPromptDismissHost")
+  hostPromotersOwned            HostPromoter[]          @relation("HostPromotersOwned")
+  hostPromotersAsPromoter       HostPromoter[]          @relation("HostPromotersAsPromoter")
   bashListsCreated              BashList[]
   userItineraries               UserItinerary[]
   aiRecommendationLogs          AIRecommendationLog[]
@@ -6468,6 +6592,7 @@ model ServiceBooking {
   sentReminders                     SentReminder[]
   offers                            ServiceBookingOffer[]
   promotionBlastEntitlement         PromotionBlastEntitlement?
+  hostPromoterPayouts               HostPromoterPayout[]
 
   // Agency routing — all nullable; solo bookings unchanged.
   representedByOrganizationId       String?

package/src/__tests__/locationShare.test.ts

@@ -0,0 +1,122 @@
+import {
+  computeLocationShareExpiresAt,
+  isLocationShareCrewMember,
+  isLocationShareEventParticipant,
+  isLocationShareLiveBookingStatus,
+  isLocationShareLiveTaskStatus,
+  LOCATION_SHARE_BOOKING_STATUSES,
+  LOCATION_SHARE_DEFAULT_TTL_MS,
+  LOCATION_SHARE_GRACE_MS,
+  LOCATION_SHARE_START_FALLBACK_MS,
+  LOCATION_SHARE_TASK_STATUSES,
+} from "../locationShare.js";
+
+describe("locationShare helpers", () => {
+  describe("isLocationShareCrewMember", () => {
+    it("allows the creator", () => {
+      expect(
+        isLocationShareCrewMember("u1", { creatorId: "u1" }, null)
+      ).toBe(true);
+    });
+
+    it("allows organizers and co-hosts", () => {
+      expect(
+        isLocationShareCrewMember("u2", { creatorId: "u1" }, {
+          isOrganizer: true,
+        })
+      ).toBe(true);
+      expect(
+        isLocationShareCrewMember("u3", { creatorId: "u1" }, {
+          isCoHost: true,
+        })
+      ).toBe(true);
+    });
+
+    it("rejects attendees", () => {
+      expect(
+        isLocationShareCrewMember("u4", { creatorId: "u1" }, {
+          isOrganizer: false,
+          isCoHost: false,
+        })
+      ).toBe(false);
+      expect(isLocationShareCrewMember(undefined, { creatorId: "u1" })).toBe(
+        false
+      );
+    });
+  });
+
+  describe("isLocationShareEventParticipant", () => {
+    it("allows live task assignees, hired providers, and promoters", () => {
+      expect(
+        isLocationShareEventParticipant("u2", { creatorId: "u1" }, {
+          hasLiveTaskAssignment: true,
+        })
+      ).toBe(true);
+      expect(
+        isLocationShareEventParticipant("u3", { creatorId: "u1" }, {
+          hasLiveHiredBooking: true,
+        })
+      ).toBe(true);
+      expect(
+        isLocationShareEventParticipant("u5", { creatorId: "u1" }, {
+          hasActivePromoterRole: true,
+        })
+      ).toBe(true);
+    });
+
+    it("rejects when no crew and no live role", () => {
+      expect(
+        isLocationShareEventParticipant("u4", { creatorId: "u1" }, {})
+      ).toBe(false);
+    });
+  });
+
+  describe("status allow-lists", () => {
+    it("includes live task and booking statuses", () => {
+      expect(LOCATION_SHARE_TASK_STATUSES).toEqual([
+        "Accepted",
+        "Assigned",
+        "InProgress",
+      ]);
+      expect(LOCATION_SHARE_BOOKING_STATUSES).toEqual([
+        "Approved",
+        "Confirmed",
+      ]);
+      expect(isLocationShareLiveTaskStatus("InProgress")).toBe(true);
+      expect(isLocationShareLiveTaskStatus("Completed")).toBe(false);
+      expect(isLocationShareLiveBookingStatus("Approved")).toBe(true);
+      expect(isLocationShareLiveBookingStatus("Pending")).toBe(false);
+    });
+  });
+
+  describe("computeLocationShareExpiresAt", () => {
+    const now = new Date("2026-07-23T12:00:00.000Z");
+
+    it("uses end + grace when end exists", () => {
+      const end = new Date("2026-07-23T18:00:00.000Z");
+      const expires = computeLocationShareExpiresAt(
+        { endDateTime: end, startDateTime: null },
+        now
+      );
+      expect(expires.getTime()).toBe(end.getTime() + LOCATION_SHARE_GRACE_MS);
+    });
+
+    it("falls back to start + 12h", () => {
+      const start = new Date("2026-07-23T14:00:00.000Z");
+      const expires = computeLocationShareExpiresAt(
+        { startDateTime: start, endDateTime: null },
+        now
+      );
+      expect(expires.getTime()).toBe(
+        start.getTime() + LOCATION_SHARE_START_FALLBACK_MS
+      );
+    });
+
+    it("falls back to now + 24h", () => {
+      const expires = computeLocationShareExpiresAt({}, now);
+      expect(expires.getTime()).toBe(
+        now.getTime() + LOCATION_SHARE_DEFAULT_TTL_MS
+      );
+    });
+  });
+});