@bash-app/bash-common 30.375.0 → 30.380.0

package/src/utils/qrCodeUtils.ts

@@ -24,3 +24,29 @@ export async function createQrCodeImage(qrData: string): Promise<string> {
     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: {
+  eventId: string;
+  ticketId: string;
+  ownerUserId?: string | null;
+  qrToken?: string | null;
+}): string {
+  return JSON.stringify({
+    eventId: args.eventId,
+    userId: args.ownerUserId ?? "",
+    ticketId: args.ticketId,
+    qrToken: args.qrToken ?? undefined,
+    timestamp: new Date().toISOString(),
+  });
+}

package/src/utils/ticketPrintPostageUtils.ts

@@ -0,0 +1,81 @@
+/**
+ * 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,
+  type LobPostcardSizeKey,
+} from "./lobFlyerUtils.js";
+
+/** Surcharge for a single printed/mailed ticket piece (integer cents). */
+export function ticketPrintSurchargeCentsPerPiece(size: LobPostcardSizeKey): number {
+  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: LobPostcardSizeKey,
+  quantity: number
+): number {
+  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:
+    | { deliveryMethod: TicketDeliveryMethod; status: TicketPrintOrderStatus }
+    | null
+    | undefined
+): string | null {
+  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";
+  }
+}