@bash-app/bash-common 30.375.0 → 30.380.0

package/dist/utils/lobFlyerUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"lobFlyerUtils.js","sourceRoot":"","sources":["../../src/utils/lobFlyerUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,gFAAgF;AAChF,MAAM,CAAC,MAAM,oBAAoB,GAG7B;IACF,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IACpC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IACpC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;CACvC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAuC;IAClF,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,MAAM,UAAU,2BAA2B,CAAC,IAAwB;IAClE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC;QACf,KAAK,UAAU;YACb,OAAO,MAAM,CAAC;QAChB,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,EAAE,GAAU,IAAI,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,IAAwB,EACxB,cAAsB;IAEtB,IAAI,cAAc,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,gCAAgC,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,cAAc,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,mBAAmB,CAAC,GAAG,KAAK,CAAC,CAAC;IACpE,OAAO,QAAQ,GAAG,MAAM,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAI9C;IACC,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3D,IAAI,MAAM,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO,uFAAuF,CAAC;IACjG,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"lobFlyerUtils.js","sourceRoot":"","sources":["../../src/utils/lobFlyerUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,qGAAqG;AACrG,MAAM,UAAU,wBAAwB,CAAC,IAAiC;IACxE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC3C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,oBAAoB,GAG7B;IACF,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IACpC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;IACpC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;CACvC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAuC;IAClF,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,MAAM,UAAU,2BAA2B,CAAC,IAAwB;IAClE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC;QACf,KAAK,UAAU;YACb,OAAO,MAAM,CAAC;QAChB,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,EAAE,GAAU,IAAI,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,IAAwB,EACxB,cAAsB;IAEtB,IAAI,cAAc,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,gCAAgC,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,cAAc,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,mBAAmB,CAAC,GAAG,KAAK,CAAC,CAAC;IACpE,OAAO,QAAQ,GAAG,MAAM,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAI9C;IACC,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3D,IAAI,MAAM,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO,uFAAuF,CAAC;IACjG,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/qrCodeUtils.d.ts

@@ -2,4 +2,21 @@ export declare function bashEventPrismaCheckoutQrCodeUrl(bashEventId: string | u
 /** Builds a **navigable** `/ticket-details/...` URL for QR or links (not the JSON scan-at-door payload — see bash-app `encodeTicketQrPayload`). */
 export declare function bashEventQrCodeUrl(bashEventId: string | undefined | null, ticketTierId?: string | undefined | null, ticketId?: string | undefined | null, slug?: string | undefined | null): string;
 export declare function createQrCodeImage(qrData: string): Promise<string>;
+/**
+ * Door-scan admission QR payload for a ticket — the same shape the buyer's
+ * "show at door" QR encodes (bash-app `MyTicketInlineQr.tsx`, built inline as
+ * `checkInData` for `encodeTicketQrPayload`) and what the API's door-verify
+ * parser reads (`parseTicketQrScanPayload` in `ticketApi.ts`, which requires
+ * string `eventId`/`ticketId` and reads an optional `qrToken`).
+ *
+ * Server-side callers (e.g. printed ticket artwork) MUST use this so a
+ * physical ticket's QR scans identically to the in-app one — no new
+ * verification path, no schema changes to `qrToken` handling.
+ */
+export declare function encodeTicketDoorQrPayload(args: {
+    eventId: string;
+    ticketId: string;
+    ownerUserId?: string | null;
+    qrToken?: string | null;
+}): string;
 //# sourceMappingURL=qrCodeUtils.d.ts.map

package/dist/utils/qrCodeUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"qrCodeUtils.d.ts","sourceRoot":"","sources":["../../src/utils/qrCodeUtils.ts"],"names":[],"mappings":"AAIA,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAE5I;AAED,mJAAmJ;AACnJ,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAUnM;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIvE"}
+{"version":3,"file":"qrCodeUtils.d.ts","sourceRoot":"","sources":["../../src/utils/qrCodeUtils.ts"],"names":[],"mappings":"AAIA,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAE5I;AAED,mJAAmJ;AACnJ,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAUnM;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIvE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,GAAG,MAAM,CAQT"}

package/dist/utils/qrCodeUtils.js

@@ -20,4 +20,24 @@ export async function createQrCodeImage(qrData) {
         errorCorrectionLevel: 'high',
     });
 }
+/**
+ * Door-scan admission QR payload for a ticket — the same shape the buyer's
+ * "show at door" QR encodes (bash-app `MyTicketInlineQr.tsx`, built inline as
+ * `checkInData` for `encodeTicketQrPayload`) and what the API's door-verify
+ * parser reads (`parseTicketQrScanPayload` in `ticketApi.ts`, which requires
+ * string `eventId`/`ticketId` and reads an optional `qrToken`).
+ *
+ * Server-side callers (e.g. printed ticket artwork) MUST use this so a
+ * physical ticket's QR scans identically to the in-app one — no new
+ * verification path, no schema changes to `qrToken` handling.
+ */
+export function encodeTicketDoorQrPayload(args) {
+    return JSON.stringify({
+        eventId: args.eventId,
+        userId: args.ownerUserId ?? "",
+        ticketId: args.ticketId,
+        qrToken: args.qrToken ?? undefined,
+        timestamp: new Date().toISOString(),
+    });
+}
 //# sourceMappingURL=qrCodeUtils.js.map

package/dist/utils/qrCodeUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"qrCodeUtils.js","sourceRoot":"","sources":["../../src/utils/qrCodeUtils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,UAAU,gCAAgC,CAAC,WAAsC,EAAE,gBAA2C;IAClI,OAAO,GAAG,cAAc,IAAI,WAAW,IAAI,gBAAgB,EAAE,CAAC;AAChE,CAAC;AAED,mJAAmJ;AACnJ,MAAM,UAAU,kBAAkB,CAAC,WAAsC,EAAE,YAAwC,EAAE,QAAoC,EAAE,IAAgC;IACzL,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,WAAY,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,WAAW,EAAE,CAAC;IAE5I,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,GAAG,OAAO,WAAW,QAAQ,EAAE,CAAC;IACzC,CAAC;SACI,IAAI,YAAY,EAAE,CAAC;QACtB,OAAO,GAAG,OAAO,gBAAgB,YAAY,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAc;IACpD,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE;QAC9B,oBAAoB,EAAE,MAAM;KAC7B,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"qrCodeUtils.js","sourceRoot":"","sources":["../../src/utils/qrCodeUtils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,UAAU,gCAAgC,CAAC,WAAsC,EAAE,gBAA2C;IAClI,OAAO,GAAG,cAAc,IAAI,WAAW,IAAI,gBAAgB,EAAE,CAAC;AAChE,CAAC;AAED,mJAAmJ;AACnJ,MAAM,UAAU,kBAAkB,CAAC,WAAsC,EAAE,YAAwC,EAAE,QAAoC,EAAE,IAAgC;IACzL,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,WAAY,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,WAAW,EAAE,CAAC;IAE5I,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,GAAG,OAAO,WAAW,QAAQ,EAAE,CAAC;IACzC,CAAC;SACI,IAAI,YAAY,EAAE,CAAC;QACtB,OAAO,GAAG,OAAO,gBAAgB,YAAY,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAc;IACpD,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE;QAC9B,oBAAoB,EAAE,MAAM;KAC7B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAKzC;IACC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,SAAS;QAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/ticketPrintPostageUtils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Buyer-facing surcharge for physical ticket delivery (mail-to-buyer or venue
+ * will-call), both fulfilled as individually-addressed Lob postcards — one
+ * ticket = one piece, same product used by Flyer Blast's addressed mail path.
+ *
+ * Reuses the Lob per-piece cost table from `lobFlyerUtils.ts` rather than
+ * duplicating pricing — same "verify before production" caveat applies here.
+ */
+import { TicketDeliveryMethod, TicketPrintOrderStatus } from "@prisma/client";
+import { type LobPostcardSizeKey } from "./lobFlyerUtils.js";
+/** Surcharge for a single printed/mailed ticket piece (integer cents). */
+export declare function ticketPrintSurchargeCentsPerPiece(size: LobPostcardSizeKey): number;
+/**
+ * Total buyer-facing surcharge (integer cents) for `quantity` physical ticket
+ * pieces of the given size — used as the Stripe checkout line item amount.
+ */
+export declare function ticketPrintSurchargeCentsForQuantity(size: LobPostcardSizeKey, quantity: number): number;
+/**
+ * Buyer-facing badge copy for a ticket's physical delivery status — shared by
+ * My Tickets and the ticket details view so both surfaces stay in sync.
+ * `null`/`undefined` (Digital) means no badge should render.
+ */
+export declare function ticketDeliveryStatusLabel(printOrder: {
+    deliveryMethod: TicketDeliveryMethod;
+    status: TicketPrintOrderStatus;
+} | null | undefined): string | null;
+//# sourceMappingURL=ticketPrintPostageUtils.d.ts.map

package/dist/utils/ticketPrintPostageUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticketPrintPostageUtils.d.ts","sourceRoot":"","sources":["../../src/utils/ticketPrintPostageUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,0EAA0E;AAC1E,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAElF;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EACN;IAAE,cAAc,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GACxE,IAAI,GACJ,SAAS,GACZ,MAAM,GAAG,IAAI,CAqCf"}

package/dist/utils/ticketPrintPostageUtils.js

@@ -0,0 +1,65 @@
+/**
+ * Buyer-facing surcharge for physical ticket delivery (mail-to-buyer or venue
+ * will-call), both fulfilled as individually-addressed Lob postcards — one
+ * ticket = one piece, same product used by Flyer Blast's addressed mail path.
+ *
+ * Reuses the Lob per-piece cost table from `lobFlyerUtils.ts` rather than
+ * duplicating pricing — same "verify before production" caveat applies here.
+ */
+import { TicketDeliveryMethod, TicketPrintOrderStatus } from "@prisma/client";
+import { quoteLobAddressedPostageCents, } from "./lobFlyerUtils.js";
+/** Surcharge for a single printed/mailed ticket piece (integer cents). */
+export function ticketPrintSurchargeCentsPerPiece(size) {
+    return quoteLobAddressedPostageCents(size, 1);
+}
+/**
+ * Total buyer-facing surcharge (integer cents) for `quantity` physical ticket
+ * pieces of the given size — used as the Stripe checkout line item amount.
+ */
+export function ticketPrintSurchargeCentsForQuantity(size, quantity) {
+    if (quantity < 1)
+        return 0;
+    return quoteLobAddressedPostageCents(size, quantity);
+}
+/**
+ * Buyer-facing badge copy for a ticket's physical delivery status — shared by
+ * My Tickets and the ticket details view so both surfaces stay in sync.
+ * `null`/`undefined` (Digital) means no badge should render.
+ */
+export function ticketDeliveryStatusLabel(printOrder) {
+    if (!printOrder)
+        return null;
+    const { deliveryMethod, status } = printOrder;
+    if (status === TicketPrintOrderStatus.CancelledBeforeSubmit ||
+        status === TicketPrintOrderStatus.CancelledAfterSubmit) {
+        return "Physical ticket cancelled";
+    }
+    if (status === TicketPrintOrderStatus.Failed) {
+        return "Physical ticket delivery failed — contact the host";
+    }
+    if (deliveryMethod === TicketDeliveryMethod.VenueWillCall) {
+        switch (status) {
+            case TicketPrintOrderStatus.Queued:
+                return "Pick up at venue: will-call (printing soon)";
+            case TicketPrintOrderStatus.Delivered:
+                return "Pick up at venue: will-call (ready)";
+            default:
+                return "Pick up at venue: will-call";
+        }
+    }
+    // PhysicalMail
+    switch (status) {
+        case TicketPrintOrderStatus.Queued:
+        case TicketPrintOrderStatus.Submitted:
+            return "Mailed ticket: printing";
+        case TicketPrintOrderStatus.Printed:
+            return "Mailed ticket: printed";
+        case TicketPrintOrderStatus.InTransit:
+            return "Mailed ticket: in transit";
+        case TicketPrintOrderStatus.Delivered:
+            return "Mailed ticket: delivered";
+        default:
+            return "Mailed ticket";
+    }
+}
+//# sourceMappingURL=ticketPrintPostageUtils.js.map

package/dist/utils/ticketPrintPostageUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticketPrintPostageUtils.js","sourceRoot":"","sources":["../../src/utils/ticketPrintPostageUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EACL,6BAA6B,GAE9B,MAAM,oBAAoB,CAAC;AAE5B,0EAA0E;AAC1E,MAAM,UAAU,iCAAiC,CAAC,IAAwB;IACxE,OAAO,6BAA6B,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CAClD,IAAwB,EACxB,QAAgB;IAEhB,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,6BAA6B,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAGa;IAEb,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IAE9C,IACE,MAAM,KAAK,sBAAsB,CAAC,qBAAqB;QACvD,MAAM,KAAK,sBAAsB,CAAC,oBAAoB,EACtD,CAAC;QACD,OAAO,2BAA2B,CAAC;IACrC,CAAC;IACD,IAAI,MAAM,KAAK,sBAAsB,CAAC,MAAM,EAAE,CAAC;QAC7C,OAAO,oDAAoD,CAAC;IAC9D,CAAC;IACD,IAAI,cAAc,KAAK,oBAAoB,CAAC,aAAa,EAAE,CAAC;QAC1D,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,sBAAsB,CAAC,MAAM;gBAChC,OAAO,6CAA6C,CAAC;YACvD,KAAK,sBAAsB,CAAC,SAAS;gBACnC,OAAO,qCAAqC,CAAC;YAC/C;gBACE,OAAO,6BAA6B,CAAC;QACzC,CAAC;IACH,CAAC;IACD,eAAe;IACf,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,sBAAsB,CAAC,MAAM,CAAC;QACnC,KAAK,sBAAsB,CAAC,SAAS;YACnC,OAAO,yBAAyB,CAAC;QACnC,KAAK,sBAAsB,CAAC,OAAO;YACjC,OAAO,wBAAwB,CAAC;QAClC,KAAK,sBAAsB,CAAC,SAAS;YACnC,OAAO,2BAA2B,CAAC;QACrC,KAAK,sBAAsB,CAAC,SAAS;YACnC,OAAO,0BAA0B,CAAC;QACpC;YACE,OAAO,eAAe,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/package.json

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

package/prisma/schema.prisma

@@ -927,6 +927,8 @@ model BashEvent {
   featuredGuestsHeadline      String?
   /// When true, bash detail shows the full privacy-filtered guest list to everyone (not just tier holders).
   attendeeListPublic          Boolean                @default(false)
+  /// Host opt-in: show live current-location pins on the public bash page.
+  locationSharePublic         Boolean                @default(false)
   /// Preview = count + curated faces; Public = full list for everyone; TicketHolders = full list for ticket buyers only.
   attendeeListAccess          String                 @default("Preview")
   /// When true, only accounts with a published service profile (Vendor/Venue/Entertainment/Exhibitor/Sponsor/Event
@@ -1181,6 +1183,8 @@ model BashEvent {
   merchOrders             BashEventMerchOrder[]
   coatCheckEntitlements   CoatCheckEntitlement[]
   experienceOpportunities ExperienceOpportunity[]
+  ticketPrintOrders       TicketPrintOrder[]
+  ticketDeliverySettings  TicketDeliverySettings?
 
   /// Latest AI moderator verdict
   /// Null = never reviewed by AI. Recomputed each time the bash transitions to Pending
@@ -3316,6 +3320,9 @@ model TicketTier {
   tierReleaseReminders   TierReleaseReminder[]
   entryCompetition       Competition? @relation("CompetitionEntryTicketTier")
 
+  /// Host opt-in: buyers of this tier may choose mailed or venue will-call physical delivery (see TicketPrintOrder).
+  allowsPhysicalDelivery Boolean @default(false)
+
   @@unique([bashEventId, title])
   @@index([availableAt])
 }
@@ -3464,6 +3471,7 @@ model Ticket {
   eventReferral      EventReferral? // When this ticket was purchased via a referral link
   flyerConversions   FlyerConversion[]
   coatCheckEntitlements CoatCheckEntitlement[]
+  printOrder            TicketPrintOrder?
 
   @@index([bashEventId])
   @@index([bashEventId, seatId])
@@ -3556,6 +3564,94 @@ model TicketMetadata {
   @@index([ticketId])
 }
 
+enum TicketDeliveryMethod {
+  Digital
+  PhysicalMail
+  VenueWillCall
+}
+
+enum TicketPrintOrderStatus {
+  Queued
+  Submitted
+  Printed
+  InTransit
+  Delivered
+  Failed
+  CancelledBeforeSubmit
+  CancelledAfterSubmit
+}
+
+/// One row per physical ticket piece mailed or held for venue will-call via Lob.
+/// Mirrors FlyerCampaign's Lob usage and CoatCheckEntitlement's per-unit purchase/status pattern.
+model TicketPrintOrder {
+  id          String @id @default(cuid())
+  ticketId    String @unique
+  bashEventId String
+
+  deliveryMethod TicketDeliveryMethod
+  status         TicketPrintOrderStatus @default(Queued)
+
+  /// Ship-to snapshot: buyer address (PhysicalMail, from Stripe shipping_details) or
+  /// venue will-call address (VenueWillCall, from TicketDeliverySettings) at submit time.
+  shipToName  String?
+  shipToLine1 String?
+  shipToLine2 String?
+  shipToCity  String?
+  shipToState String?
+  shipToZip   String?
+
+  lobPostcardSize LobPostcardSize @default(LOB_4X6)
+  lobPostcardId   String?
+  vendorStatus    String?
+  /// Groups will-call pieces submitted together for host tracking ("Batch #3 — 42 pieces").
+  willCallBatchId String?
+
+  surchargeCents          Int     @default(0)
+  stripeCheckoutSessionId String?
+  checkoutId              String?
+
+  submittedAt DateTime?
+  printedAt   DateTime?
+  shippedAt   DateTime?
+  deliveredAt DateTime?
+  cancelledAt DateTime?
+
+  lastVendorStatusSyncAt DateTime?
+  lastLobWebhookId       String?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  ticket    Ticket    @relation(fields: [ticketId], references: [id], onDelete: Cascade)
+  bashEvent BashEvent @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+
+  @@index([bashEventId, deliveryMethod, status])
+  @@index([willCallBatchId])
+}
+
+/// Per-event opt-in + venue will-call address for physical ticket delivery; kept separate
+/// from BashEvent (already very large) — one row per event, created on first opt-in.
+model TicketDeliverySettings {
+  id          String @id @default(cuid())
+  bashEventId String @unique
+
+  physicalMailEnabled Boolean         @default(false)
+  willCallEnabled     Boolean         @default(false)
+  lobPostcardSize     LobPostcardSize @default(LOB_4X6)
+
+  willCallAddressName  String?
+  willCallAddressLine1 String?
+  willCallAddressLine2 String?
+  willCallAddressCity  String?
+  willCallAddressState String?
+  willCallAddressZip   String?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  bashEvent BashEvent @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+}
+
 /// Stripe donation to an event (Checkout session or PaymentIntent); includes optional UTM attribution.
 model BashEventDonation {
   id                      String   @id @default(cuid())

package/src/__tests__/locationShare.test.ts

@@ -9,6 +9,9 @@ import {
   LOCATION_SHARE_GRACE_MS,
   LOCATION_SHARE_START_FALLBACK_MS,
   LOCATION_SHARE_TASK_STATUSES,
+  mergeLocationShareViewer,
+  sortLocationShareViewers,
+  type LocationShareViewer,
 } from "../locationShare.js";
 
 describe("locationShare helpers", () => {
@@ -119,4 +122,30 @@ describe("locationShare helpers", () => {
       );
     });
   });
+
+  describe("mergeLocationShareViewer", () => {
+    const teaser = (id: string) =>
+      ({ id }) as LocationShareViewer["user"];
+
+    it("keeps Host over Task for the same person", () => {
+      const byUserId = new Map<string, LocationShareViewer>();
+      mergeLocationShareViewer(byUserId, teaser("u1"), "Task");
+      mergeLocationShareViewer(byUserId, teaser("u1"), "Host");
+      expect(byUserId.get("u1")?.role).toBe("Host");
+    });
+
+    it("ignores a missing user", () => {
+      const byUserId = new Map<string, LocationShareViewer>();
+      mergeLocationShareViewer(byUserId, null, "Host");
+      expect(byUserId.size).toBe(0);
+    });
+
+    it("sorts Host before hired providers", () => {
+      const sorted = sortLocationShareViewers([
+        { userId: "b", role: "Provider", user: teaser("b") },
+        { userId: "a", role: "Host", user: teaser("a") },
+      ]);
+      expect(sorted.map((v) => v.role)).toEqual(["Host", "Provider"]);
+    });
+  });
 });

package/src/definitions.ts

@@ -1101,6 +1101,14 @@ export interface StripeCreateBashEventTicketsCheckoutSessionArgs extends UtmFiel
   coatCheckOversized?: boolean;
   /** Optional tip cents for coat check (when host enables tips). */
   coatCheckTipCents?: number;
+
+  /**
+   * Physical ticket delivery via Lob (mail-to-buyer or venue will-call).
+   * Undefined = digital ticket only (existing flow, unchanged). Server
+   * validates against the event's `TicketDeliverySettings` + each tier's
+   * `allowsPhysicalDelivery` before charging the surcharge.
+   */
+  ticketDeliveryMethod?: "PhysicalMail" | "VenueWillCall";
 }
 
 export interface StripeCreateBashEventDonationCheckoutSessionArgs extends UtmFields {

package/src/extendedSchemas.ts

@@ -78,6 +78,10 @@ import {
   TicketTier,
   TicketTransfer,
   TicketTransferInvite,
+  TicketDeliverySettings,
+  TicketDeliveryMethod,
+  TicketPrintOrder,
+  TicketPrintOrderStatus,
   User,
   UserPreferences,
   UserStats,
@@ -1729,6 +1733,8 @@ export type TicketFlexible = Ticket & {
   transfers?: TicketTransfer[];
   metadata?: TicketMetadata[];
   transferInvite?: TicketTransferInviteTeaser | null;
+  /** Physical delivery (mail / venue will-call) status, when the ticket opted in at checkout. */
+  printOrder?: TicketPrintOrder | null;
 };
 
 /**
@@ -2114,6 +2120,64 @@ export interface FlyerAnalyticsSummary {
 
 export type PostalCarrierRouteExt = PostalCarrierRoute;
 
+// --- Physical ticket delivery (mail / venue will-call via Lob) ---
+
+/** Delivery method a buyer picks at checkout when the tier allows physical delivery. */
+export interface TicketDeliverySelection {
+  deliveryMethod: TicketDeliveryMethod;
+}
+
+export const TICKET_PRINT_ORDER_WITH_TICKET_INCLUDE = {
+  ticket: {
+    select: {
+      id: true,
+      fullName: true,
+      email: true,
+      ticketTier: { select: { id: true, title: true } },
+    },
+  },
+} satisfies Prisma.TicketPrintOrderInclude;
+
+export type TicketPrintOrderExt = Prisma.TicketPrintOrderGetPayload<{
+  include: typeof TICKET_PRINT_ORDER_WITH_TICKET_INCLUDE;
+}>;
+
+/** Host-facing form for enabling/configuring physical delivery on an event. */
+export interface TicketDeliverySettingsFormData {
+  physicalMailEnabled: boolean;
+  willCallEnabled: boolean;
+  lobPostcardSize: TicketDeliverySettings["lobPostcardSize"];
+  willCallAddressName?: string;
+  willCallAddressLine1?: string;
+  willCallAddressLine2?: string;
+  willCallAddressCity?: string;
+  willCallAddressState?: string;
+  willCallAddressZip?: string;
+}
+
+/** Response from the host "send queued will-call tickets to venue" action. */
+export interface WillCallBatchSubmitResult {
+  willCallBatchId: string;
+  submittedCount: number;
+  failedCount: number;
+}
+
+/** Summary counts for the host Tickets tab "Print & Mail" panel. */
+export interface TicketPrintOrderSummary {
+  deliveryMethod: TicketDeliveryMethod;
+  status: TicketPrintOrderStatus;
+  count: number;
+}
+
+/** Public-safe checkout-time read of an event's physical delivery settings. */
+export interface TicketDeliveryAvailability {
+  physicalMailEnabled: boolean;
+  willCallEnabled: boolean;
+  lobPostcardSize: TicketDeliverySettings["lobPostcardSize"];
+  /** Buyer-facing surcharge (integer cents) for one physical ticket piece. */
+  surchargeCentsPerTicket: number;
+}
+
 // === Talent Agency selects/types ============================================
 
 /// Public-safe roster entry for an agency's artist (agency detail page + cards).

package/src/index.ts

@@ -416,6 +416,7 @@ export * from "./utils/ticketCheckInDisplay.js";
 export * from "./utils/coatCheckUtils.js";
 export * from "./utils/ticketTierSchedule.js";
 export * from "./utils/lobFlyerUtils.js";
+export * from "./utils/ticketPrintPostageUtils.js";
 export * from "./utils/generalDateTimeUtils.js";
 export * from "./utils/locationVisibility.js";
 export * from "./utils/luxonUtils.js";

package/src/locationShare.ts

@@ -171,3 +171,76 @@ export type LocationShareMySession = Pick<
   | "lastAccuracyM"
   | "lastUpdatedAt"
 >;
+
+/** Why this person can see live location on the bash. */
+export const LOCATION_SHARE_VIEWER_ROLES = [
+  "Host",
+  "Organizer",
+  "CoHost",
+  "Promoter",
+  "Task",
+  "Provider",
+] as const;
+
+export type LocationShareViewerRole =
+  (typeof LOCATION_SHARE_VIEWER_ROLES)[number];
+
+const LOCATION_SHARE_VIEWER_ROLE_RANK: Record<LocationShareViewerRole, number> =
+  {
+    Host: 0,
+    Organizer: 1,
+    CoHost: 2,
+    Promoter: 3,
+    Task: 4,
+    Provider: 5,
+  };
+
+/** Host-facing labels — access copy, not promoter voice. */
+export const LOCATION_SHARE_VIEWER_ROLE_LABEL: Record<
+  LocationShareViewerRole,
+  string
+> = {
+  Host: "Host",
+  Organizer: "Organizer",
+  CoHost: "Co-host",
+  Promoter: "Promoter",
+  Task: "On a task",
+  Provider: "Hired",
+};
+
+export type LocationShareViewer = {
+  userId: string;
+  role: LocationShareViewerRole;
+  user: Prisma.UserGetPayload<{
+    select: typeof LOCATION_SHARE_SESSION_USER_SELECT;
+  }>;
+};
+
+/** Keep the highest-rank role when the same person qualifies more than once. */
+export function mergeLocationShareViewer(
+  byUserId: Map<string, LocationShareViewer>,
+  user: LocationShareViewer["user"] | null | undefined,
+  role: LocationShareViewerRole
+): void {
+  if (!user?.id) return;
+  const existing = byUserId.get(user.id);
+  if (
+    !existing ||
+    LOCATION_SHARE_VIEWER_ROLE_RANK[role] <
+      LOCATION_SHARE_VIEWER_ROLE_RANK[existing.role]
+  ) {
+    byUserId.set(user.id, { userId: user.id, role, user });
+  }
+}
+
+export function sortLocationShareViewers(
+  viewers: LocationShareViewer[]
+): LocationShareViewer[] {
+  return [...viewers].sort((a, b) => {
+    const rank =
+      LOCATION_SHARE_VIEWER_ROLE_RANK[a.role] -
+      LOCATION_SHARE_VIEWER_ROLE_RANK[b.role];
+    if (rank !== 0) return rank;
+    return a.userId.localeCompare(b.userId);
+  });
+}

package/src/utils/__tests__/ticketPrintPostageUtils.test.ts

@@ -0,0 +1,95 @@
+import { describe, expect, it } from "@jest/globals";
+import { TicketDeliveryMethod, TicketPrintOrderStatus } from "@prisma/client";
+
+import {
+  ticketDeliveryStatusLabel,
+  ticketPrintSurchargeCentsForQuantity,
+  ticketPrintSurchargeCentsPerPiece,
+} from "../ticketPrintPostageUtils.js";
+
+describe("ticketPrintPostageUtils", () => {
+  describe("ticketPrintSurchargeCentsPerPiece", () => {
+    it("matches the per-piece quote for quantity 1", () => {
+      expect(ticketPrintSurchargeCentsPerPiece("LOB_4X6")).toBe(
+        ticketPrintSurchargeCentsForQuantity("LOB_4X6", 1)
+      );
+    });
+  });
+
+  describe("ticketPrintSurchargeCentsForQuantity", () => {
+    it("is zero for quantity < 1", () => {
+      expect(ticketPrintSurchargeCentsForQuantity("LOB_4X6", 0)).toBe(0);
+      expect(ticketPrintSurchargeCentsForQuantity("LOB_4X6", -1)).toBe(0);
+    });
+
+    it("scales with quantity", () => {
+      const one = ticketPrintSurchargeCentsForQuantity("LOB_6X9", 1);
+      const five = ticketPrintSurchargeCentsForQuantity("LOB_6X9", 5);
+      expect(five).toBeGreaterThan(one);
+    });
+  });
+
+  describe("ticketDeliveryStatusLabel", () => {
+    it("returns null for Digital (no print order)", () => {
+      expect(ticketDeliveryStatusLabel(null)).toBeNull();
+      expect(ticketDeliveryStatusLabel(undefined)).toBeNull();
+    });
+
+    it("returns a cancelled label regardless of delivery method (before submit)", () => {
+      expect(
+        ticketDeliveryStatusLabel({
+          deliveryMethod: TicketDeliveryMethod.PhysicalMail,
+          status: TicketPrintOrderStatus.CancelledBeforeSubmit,
+        })
+      ).toBe("Physical ticket cancelled");
+    });
+
+    it("returns a cancelled label (after submit)", () => {
+      expect(
+        ticketDeliveryStatusLabel({
+          deliveryMethod: TicketDeliveryMethod.VenueWillCall,
+          status: TicketPrintOrderStatus.CancelledAfterSubmit,
+        })
+      ).toBe("Physical ticket cancelled");
+    });
+
+    it("returns a failure label", () => {
+      expect(
+        ticketDeliveryStatusLabel({
+          deliveryMethod: TicketDeliveryMethod.PhysicalMail,
+          status: TicketPrintOrderStatus.Failed,
+        })
+      ).toBe("Physical ticket delivery failed — contact the host");
+    });
+
+    it.each([
+      [TicketPrintOrderStatus.Queued, "Pick up at venue: will-call (printing soon)"],
+      [TicketPrintOrderStatus.Submitted, "Pick up at venue: will-call"],
+      [TicketPrintOrderStatus.Printed, "Pick up at venue: will-call"],
+      [TicketPrintOrderStatus.InTransit, "Pick up at venue: will-call"],
+      [TicketPrintOrderStatus.Delivered, "Pick up at venue: will-call (ready)"],
+    ])("VenueWillCall %s -> %s", (status, expected) => {
+      expect(
+        ticketDeliveryStatusLabel({
+          deliveryMethod: TicketDeliveryMethod.VenueWillCall,
+          status,
+        })
+      ).toBe(expected);
+    });
+
+    it.each([
+      [TicketPrintOrderStatus.Queued, "Mailed ticket: printing"],
+      [TicketPrintOrderStatus.Submitted, "Mailed ticket: printing"],
+      [TicketPrintOrderStatus.Printed, "Mailed ticket: printed"],
+      [TicketPrintOrderStatus.InTransit, "Mailed ticket: in transit"],
+      [TicketPrintOrderStatus.Delivered, "Mailed ticket: delivered"],
+    ])("PhysicalMail %s -> %s", (status, expected) => {
+      expect(
+        ticketDeliveryStatusLabel({
+          deliveryMethod: TicketDeliveryMethod.PhysicalMail,
+          status,
+        })
+      ).toBe(expected);
+    });
+  });
+});

package/src/utils/lobFlyerUtils.ts

@@ -13,6 +13,13 @@
 
 export type LobPostcardSizeKey = "LOB_4X6" | "LOB_6X9" | "LOB_6X11";
 
+/** Narrows the Prisma `LobPostcardSize` enum value to the string-literal key used by these utils. */
+export function lobPostcardSizeEnumToKey(size: LobPostcardSizeKey | string): LobPostcardSizeKey {
+  if (size === "LOB_6X9") return "LOB_6X9";
+  if (size === "LOB_6X11") return "LOB_6X11";
+  return "LOB_4X6";
+}
+
 /** Trim width × height in inches (portrait), matching Lob postcard products. */
 export const LOB_POSTCARD_TRIM_IN: Record<
   LobPostcardSizeKey,