@epztickets/common 1.88.0 → 1.90.0

package/build/events/class-category.d.ts

@@ -1,5 +1 @@
-import { CLASS_CATEGORIES } from "./orientation-scheduled-event";
-export type ClassCategory = (typeof CLASS_CATEGORIES)[number]["value"];
-export declare const CLASS_CATEGORY_VALUES: string[];
-export declare const isClassCategory: (v: unknown) => v is ClassCategory;
-export declare function inferClassCategory(title?: string | null): ClassCategory | undefined;
+export * from "../shared/class-categories";

package/build/events/class-category.js

@@ -1,32 +1,19 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isClassCategory = exports.CLASS_CATEGORY_VALUES = void 0;
-exports.inferClassCategory = inferClassCategory;
-const orientation_scheduled_event_1 = require("./orientation-scheduled-event");
-exports.CLASS_CATEGORY_VALUES = orientation_scheduled_event_1.CLASS_CATEGORIES.map((c) => c.value);
-const isClassCategory = (v) => typeof v === "string" && exports.CLASS_CATEGORY_VALUES.includes(v);
-exports.isClassCategory = isClassCategory;
-// Best-effort guess of a category from a free-text class name
-// ("Salsa basics" → dance, "BJJ open mat" → martial_arts). Used when a
-// booking arrives without a category (AI chat agent, older clients)
-// and to estimate categories for bookings made before categories
-// existed. Returns undefined when nothing matches.
-const KEYWORDS = [
-    ["martial_arts", /\b(karate|judo|jiu[- ]?jitsu|bjj|taekwondo|tae kwon do|kung fu|boxing|kickbox\w*|mma|muay thai|self[- ]defen[cs]e|aikido|capoeira|krav maga|wrestling)\b/],
-    ["yoga", /\b(yoga|pilates|meditat\w*|mindful\w*|stretch\w*|wellness|breathwork|sound bath|tai chi)\b/],
-    ["dance", /\b(danc\w*|salsa|bachata|ballet|hip[- ]?hop|tango|merengue|cumbia|contemporary|choreo\w*|tap|jazz funk|k-?pop|twerk|ballroom|swing|flamenco|folklorico|breakdanc\w*|heels)\b/],
-    ["fitness", /\b(fitness|hiit|boot ?camp|crossfit|zumba|workout|strength|spin(ning)?|cardio|barre|conditioning|circuit|bootcamp|personal training|training session)\b/],
-    ["singing", /\b(sing\w*|vocal\w*|voice|choir|chorus|karaoke|a cappella)\b/],
-    ["instrumental", /\b(guitar|piano|drum\w*|violin|viola|cello|bass|band|ukulele|sax\w*|trumpet|flute|clarinet|keyboard|instrument\w*|orchestra|jam session|dj)\b/],
-    ["theater", /\b(theat(er|re)|acting|actor\w*|drama|improv|audition\w*|scene study|monologue|musical theat(er|re)|stage combat)\b/],
-    ["workshop", /\b(workshop|lecture|seminar|talk|course|training|meeting|info session|q&a|panel)\b/],
-];
-function inferClassCategory(title) {
-    if (!title)
-        return undefined;
-    const t = title.toLowerCase();
-    for (const [cat, rx] of KEYWORDS)
-        if (rx.test(t))
-            return cat;
-    return undefined;
-}
+// Moved to shared/class-categories.ts (re-exported from the package
+// root and from "@epztickets/common/shared").
+__exportStar(require("../shared/class-categories"), exports);

package/build/events/orientation-scheduled-event.d.ts

@@ -1,34 +1,5 @@
 import { Subjects } from "./subjects";
 export type OrientationStatus = "scheduled" | "approved" | "no_show" | "declined" | "cancelled";
-export declare const CLASS_CATEGORIES: readonly [{
-    readonly value: "singing";
-    readonly label: "Singing / vocal";
-}, {
-    readonly value: "instrumental";
-    readonly label: "Instrumental";
-}, {
-    readonly value: "dance";
-    readonly label: "Dance";
-}, {
-    readonly value: "fitness";
-    readonly label: "Fitness";
-}, {
-    readonly value: "theater";
-    readonly label: "Theater / acting";
-}, {
-    readonly value: "yoga";
-    readonly label: "Yoga / Pilates / wellness";
-}, {
-    readonly value: "martial_arts";
-    readonly label: "Martial arts";
-}, {
-    readonly value: "workshop";
-    readonly label: "Workshop / lecture";
-}, {
-    readonly value: "other";
-    readonly label: "Other";
-}];
-export declare const classCategoryLabel: (v?: string) => string | undefined;
 export interface OrientationSnapshot {
     id: string;
     ownerUserId: string;

package/build/events/orientation-scheduled-event.js

@@ -1,19 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.classCategoryLabel = exports.CLASS_CATEGORIES = void 0;
-// "Category of class" the renter picks on the orientation form.
-// Shared by rooms (validation), notifications (email labels); the
-// frontend keeps a matching copy in lib/orientations.ts.
-exports.CLASS_CATEGORIES = [
-    { value: "singing", label: "Singing / vocal" },
-    { value: "instrumental", label: "Instrumental" },
-    { value: "dance", label: "Dance" },
-    { value: "fitness", label: "Fitness" },
-    { value: "theater", label: "Theater / acting" },
-    { value: "yoga", label: "Yoga / Pilates / wellness" },
-    { value: "martial_arts", label: "Martial arts" },
-    { value: "workshop", label: "Workshop / lecture" },
-    { value: "other", label: "Other" },
-];
-const classCategoryLabel = (v) => { var _a, _b; return (_b = (_a = exports.CLASS_CATEGORIES.find((c) => c.value === v)) === null || _a === void 0 ? void 0 : _a.label) !== null && _b !== void 0 ? _b : v; };
-exports.classCategoryLabel = classCategoryLabel;

package/build/events/orientation-updated-event.d.ts

@@ -8,5 +8,6 @@ export interface OrientationUpdatedEvent {
         changedBy: "renter" | "owner" | "admin";
         previousStartTime?: string;
         previousEndTime?: string;
+        accountDeleted?: "renter" | "owner";
     };
 }

package/build/events/subjects.d.ts

@@ -51,7 +51,9 @@ export declare enum Subjects {
     RenterApprovalChanged = "events.orientation.renter-approval-changed",
     OrientationScheduled = "events.orientation.scheduled",
     OrientationUpdated = "events.orientation.updated",
-    OwnerPlanUpdated = "events.owner-plan.updated"
+    OwnerPlanUpdated = "events.owner-plan.updated",
+    SubscriptionPaymentFailed = "events.billing.payment-failed",
+    SubscriptionPaymentRecovered = "events.billing.payment-recovered"
 }
 export declare enum Streams {
     Events = "events",

package/build/events/subjects.js

@@ -164,6 +164,9 @@ var Subjects;
     // rate, negotiated per owner. orders mirrors the commission rate to
     // snapshot it onto each booking.
     Subjects["OwnerPlanUpdated"] = "events.owner-plan.updated";
+    // Monthly platform-fee payment outcomes (payments → notifications).
+    Subjects["SubscriptionPaymentFailed"] = "events.billing.payment-failed";
+    Subjects["SubscriptionPaymentRecovered"] = "events.billing.payment-recovered";
 })(Subjects || (exports.Subjects = Subjects = {}));
 var Streams;
 (function (Streams) {

package/build/events/subscription-payment-events.d.ts

@@ -0,0 +1,23 @@
+import { Subjects } from "./subjects";
+export interface SubscriptionPaymentFailedEvent {
+    subject: Subjects.SubscriptionPaymentFailed;
+    data: {
+        ownerUserId: string;
+        invoiceId: string;
+        amountCents: number;
+        attemptCount: number;
+        finalAttempt: boolean;
+        nextAttemptAt: string | null;
+        invoiceUrl: string | null;
+        occurredAt: string;
+    };
+}
+export interface SubscriptionPaymentRecoveredEvent {
+    subject: Subjects.SubscriptionPaymentRecovered;
+    data: {
+        ownerUserId: string;
+        invoiceId: string;
+        amountCents: number;
+        occurredAt: string;
+    };
+}

package/build/events/subscription-payment-events.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/index.d.ts

@@ -37,8 +37,8 @@ export * from "./events/orientation-settings-updated-event";
 export * from "./events/renter-approval-changed-event";
 export * from "./events/orientation-scheduled-event";
 export * from "./events/orientation-updated-event";
-export * from "./events/class-category";
 export * from "./events/owner-plan-updated-event";
+export * from "./events/subscription-payment-events";
 export * from "./events/order-cancelled-event";
 export * from "./events/order-completed-event";
 export * from "./events/order-created-event";
@@ -73,3 +73,4 @@ export * from "./events/user-self-booking-payment-reminder-requested-event";
 export * from "./events/connect-disconnect-requested-event";
 export * from "./events/connect-disconnect-approved-event";
 export * from "./events/connect-disconnect-rejected-event";
+export * from "./shared";

package/build/index.js

@@ -57,8 +57,9 @@ __exportStar(require("./events/orientation-settings-updated-event"), exports);
 __exportStar(require("./events/renter-approval-changed-event"), exports);
 __exportStar(require("./events/orientation-scheduled-event"), exports);
 __exportStar(require("./events/orientation-updated-event"), exports);
-__exportStar(require("./events/class-category"), exports);
+// class categories now live in shared/ (re-exported below)
 __exportStar(require("./events/owner-plan-updated-event"), exports);
+__exportStar(require("./events/subscription-payment-events"), exports);
 __exportStar(require("./events/order-cancelled-event"), exports);
 __exportStar(require("./events/order-completed-event"), exports);
 __exportStar(require("./events/order-created-event"), exports);
@@ -93,3 +94,5 @@ __exportStar(require("./events/user-self-booking-payment-reminder-requested-even
 __exportStar(require("./events/connect-disconnect-requested-event"), exports);
 __exportStar(require("./events/connect-disconnect-approved-event"), exports);
 __exportStar(require("./events/connect-disconnect-rejected-event"), exports);
+// Browser-safe helpers (also available as "@epztickets/common/shared")
+__exportStar(require("./shared"), exports);

package/build/shared/business-hours.d.ts

@@ -0,0 +1,26 @@
+export interface DayHours {
+    closed: boolean;
+    open?: string;
+    close?: string;
+}
+export interface BusinessHours {
+    mon: DayHours;
+    tue: DayHours;
+    wed: DayHours;
+    thu: DayHours;
+    fri: DayHours;
+    sat: DayHours;
+    sun: DayHours;
+}
+export interface HoursCheckResult {
+    ok: boolean;
+    /** Human-readable reason. Only meaningful when ok=false. */
+    reason?: string;
+}
+/**
+ * Public check. Returns { ok: true } when the booking is allowed
+ * (either because there's no hours restriction, OR the window
+ * fits inside the day's open/close). Returns { ok: false, reason }
+ * with a message safe to surface to the caller when it doesn't.
+ */
+export declare function checkBusinessHours(hours: BusinessHours | undefined, startTime: Date, endTime: Date, timezone: string | undefined): HoursCheckResult;

package/build/shared/business-hours.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkBusinessHours = checkBusinessHours;
+// Server-side counterpart to reservation-frontend/lib/business-
+// hours.ts. Given a Room replica's businessHours + the requested
+// booking window, decides whether the window falls entirely
+// within the room's open hours for the relevant day-of-week.
+//
+// Design decisions:
+//   - Backward compat: when businessHours is undefined the guard
+//     ALLOWS the booking. Matches the client's "no gate when
+//     hours aren't configured" behavior — an owner who hasn't
+//     set hours yet shouldn't accidentally lock renters out.
+//   - Timezone: businessHours are stored in the room's local
+//     time (e.g. "09:00" = 9am). At validation time we need the
+//     day-of-week and HH:MM of the requested start/end in that
+//     same local timezone. We use the ORDER'S buyer timezone
+//     as a proxy — in almost every case the buyer and the room
+//     are in the same physical location, so their timezones
+//     match. If they differ, worst-case the guard evaluates in
+//     the wrong timezone. That's a rare edge case we can revisit
+//     once we have real cross-timezone data.
+//   - Multi-day ranges: rejected. V1 doesn't support overnight
+//     bookings that cross a business-hour boundary. If an owner
+//     eventually wants "open Fri 8pm to Sat 2am," we'll add
+//     dedicated support then.
+const JS_DAY_TO_KEY = [
+    "sun", "mon", "tue", "wed", "thu", "fri", "sat",
+];
+/**
+ * Extract { dayOfWeek, hh:mm } for a Date in a given IANA
+ * timezone, using Intl.DateTimeFormat. Falls back to UTC when
+ * the timezone is invalid or missing.
+ */
+function partsIn(date, timezone) {
+    var _a, _b, _c, _d;
+    const opts = Object.assign({ weekday: "short", hour: "2-digit", minute: "2-digit", hour12: false }, (timezone ? { timeZone: timezone } : { timeZone: "UTC" }));
+    let formatted;
+    try {
+        formatted = new Intl.DateTimeFormat("en-US", opts).formatToParts(date);
+    }
+    catch (_e) {
+        formatted = new Intl.DateTimeFormat("en-US", Object.assign(Object.assign({}, opts), { timeZone: "UTC" })).formatToParts(date);
+    }
+    const map = {};
+    for (const p of formatted)
+        map[p.type] = p.value;
+    const weekdayShort = (_a = map.weekday) !== null && _a !== void 0 ? _a : "Sun";
+    // Intl gives "Sun" ... "Sat" — map to our internal keys.
+    const dayKey = (_b = {
+        Sun: "sun", Mon: "mon", Tue: "tue", Wed: "wed",
+        Thu: "thu", Fri: "fri", Sat: "sat",
+    }[weekdayShort]) !== null && _b !== void 0 ? _b : "sun";
+    const hh = map.hour === "24" ? "00" : ((_c = map.hour) !== null && _c !== void 0 ? _c : "00");
+    const mm = (_d = map.minute) !== null && _d !== void 0 ? _d : "00";
+    return { dayKey: dayKey, hhmm: `${hh}:${mm}` };
+}
+/**
+ * Public check. Returns { ok: true } when the booking is allowed
+ * (either because there's no hours restriction, OR the window
+ * fits inside the day's open/close). Returns { ok: false, reason }
+ * with a message safe to surface to the caller when it doesn't.
+ */
+function checkBusinessHours(hours, startTime, endTime, timezone) {
+    // No hours configured — no gate. Same behavior as the
+    // frontend picker when businessHours is undefined.
+    if (!hours)
+        return { ok: true };
+    // Multi-day guard. This is intentionally strict — an overnight
+    // booking that would legitimately span two days (e.g. 8pm-2am)
+    // is out of scope for the current business-hours model.
+    const startParts = partsIn(startTime, timezone);
+    const endParts = partsIn(endTime, timezone);
+    if (startParts.dayKey !== endParts.dayKey) {
+        return {
+            ok: false,
+            reason: "This room does not accept bookings that cross midnight. Please book within a single day.",
+        };
+    }
+    const day = hours[startParts.dayKey];
+    if (!day)
+        return { ok: true };
+    if (day.closed) {
+        return {
+            ok: false,
+            reason: `This room is closed on ${dayLabel(startParts.dayKey)}. Please pick a day when it's open.`,
+        };
+    }
+    if (!day.open || !day.close) {
+        // Malformed row — treat as no gate rather than reject a
+        // legitimate booking on bad server-side data.
+        return { ok: true };
+    }
+    // String comparison works for zero-padded 24-hour HH:MM.
+    if (startParts.hhmm < day.open || endParts.hhmm > day.close) {
+        return {
+            ok: false,
+            reason: `This room is open ${to12h(day.open)} to ${to12h(day.close)} on ${dayLabel(startParts.dayKey)}. Please pick a time within the open window.`,
+        };
+    }
+    return { ok: true };
+}
+// Small formatting helpers used only in the error message. Kept
+// local so the guard has no external formatting dependency.
+function dayLabel(key) {
+    return {
+        mon: "Monday", tue: "Tuesday", wed: "Wednesday", thu: "Thursday",
+        fri: "Friday", sat: "Saturday", sun: "Sunday",
+    }[key];
+}
+function to12h(hhmm) {
+    const [h, m] = hhmm.split(":").map(Number);
+    if (Number.isNaN(h) || Number.isNaN(m))
+        return hhmm;
+    const period = h < 12 ? "AM" : "PM";
+    const displayH = h === 0 ? 12 : h > 12 ? h - 12 : h;
+    return `${displayH}:${String(m).padStart(2, "0")} ${period}`;
+}

package/build/shared/class-categories.d.ts

@@ -0,0 +1,33 @@
+export declare const CLASS_CATEGORIES: readonly [{
+    readonly value: "singing";
+    readonly label: "Singing / vocal";
+}, {
+    readonly value: "instrumental";
+    readonly label: "Instrumental";
+}, {
+    readonly value: "dance";
+    readonly label: "Dance";
+}, {
+    readonly value: "fitness";
+    readonly label: "Fitness";
+}, {
+    readonly value: "theater";
+    readonly label: "Theater / acting";
+}, {
+    readonly value: "yoga";
+    readonly label: "Yoga / Pilates / wellness";
+}, {
+    readonly value: "martial_arts";
+    readonly label: "Martial arts";
+}, {
+    readonly value: "workshop";
+    readonly label: "Workshop / lecture";
+}, {
+    readonly value: "other";
+    readonly label: "Other";
+}];
+export declare const classCategoryLabel: (v?: string) => string | undefined;
+export type ClassCategory = (typeof CLASS_CATEGORIES)[number]["value"];
+export declare const CLASS_CATEGORY_VALUES: string[];
+export declare const isClassCategory: (v: unknown) => v is ClassCategory;
+export declare function inferClassCategory(title?: string | null): ClassCategory | undefined;

package/build/shared/class-categories.js

@@ -0,0 +1,47 @@
+"use strict";
+// "Category of class" — single source for services AND the frontend
+// (via @epztickets/common/shared). Used by the orientation form, the
+// Reserve modal, orders validation, and metrics trends.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isClassCategory = exports.CLASS_CATEGORY_VALUES = exports.classCategoryLabel = exports.CLASS_CATEGORIES = void 0;
+exports.inferClassCategory = inferClassCategory;
+exports.CLASS_CATEGORIES = [
+    { value: "singing", label: "Singing / vocal" },
+    { value: "instrumental", label: "Instrumental" },
+    { value: "dance", label: "Dance" },
+    { value: "fitness", label: "Fitness" },
+    { value: "theater", label: "Theater / acting" },
+    { value: "yoga", label: "Yoga / Pilates / wellness" },
+    { value: "martial_arts", label: "Martial arts" },
+    { value: "workshop", label: "Workshop / lecture" },
+    { value: "other", label: "Other" },
+];
+const classCategoryLabel = (v) => { var _a, _b; return (_b = (_a = exports.CLASS_CATEGORIES.find((c) => c.value === v)) === null || _a === void 0 ? void 0 : _a.label) !== null && _b !== void 0 ? _b : v; };
+exports.classCategoryLabel = classCategoryLabel;
+exports.CLASS_CATEGORY_VALUES = exports.CLASS_CATEGORIES.map((c) => c.value);
+const isClassCategory = (v) => typeof v === "string" && exports.CLASS_CATEGORY_VALUES.includes(v);
+exports.isClassCategory = isClassCategory;
+// Best-effort guess of a category from a free-text class name
+// ("Salsa basics" → dance, "BJJ open mat" → martial_arts). Used when a
+// booking arrives without a category (AI chat agent, older clients)
+// and to estimate categories for bookings made before categories
+// existed. Returns undefined when nothing matches.
+const KEYWORDS = [
+    ["martial_arts", /\b(karate|judo|jiu[- ]?jitsu|bjj|taekwondo|tae kwon do|kung fu|boxing|kickbox\w*|mma|muay thai|self[- ]defen[cs]e|aikido|capoeira|krav maga|wrestling)\b/],
+    ["yoga", /\b(yoga|pilates|meditat\w*|mindful\w*|stretch\w*|wellness|breathwork|sound bath|tai chi)\b/],
+    ["dance", /\b(danc\w*|salsa|bachata|ballet|hip[- ]?hop|tango|merengue|cumbia|contemporary|choreo\w*|tap|jazz funk|k-?pop|twerk|ballroom|swing|flamenco|folklorico|breakdanc\w*|heels)\b/],
+    ["fitness", /\b(fitness|hiit|boot ?camp|crossfit|zumba|workout|strength|spin(ning)?|cardio|barre|conditioning|circuit|bootcamp|personal training|training session)\b/],
+    ["singing", /\b(sing\w*|vocal\w*|voice|choir|chorus|karaoke|a cappella)\b/],
+    ["instrumental", /\b(guitar|piano|drum\w*|violin|viola|cello|bass|band|ukulele|sax\w*|trumpet|flute|clarinet|keyboard|instrument\w*|orchestra|jam session|dj)\b/],
+    ["theater", /\b(theat(er|re)|acting|actor\w*|drama|improv|audition\w*|scene study|monologue|musical theat(er|re)|stage combat)\b/],
+    ["workshop", /\b(workshop|lecture|seminar|talk|course|training|meeting|info session|q&a|panel)\b/],
+];
+function inferClassCategory(title) {
+    if (!title)
+        return undefined;
+    const t = title.toLowerCase();
+    for (const [cat, rx] of KEYWORDS)
+        if (rx.test(t))
+            return cat;
+    return undefined;
+}

package/build/shared/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./stripe-fee";
+export * from "./business-hours";
+export * from "./class-categories";

package/build/shared/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Browser-safe, dependency-free helpers shared by the services AND
+// the Next.js frontend. Import from "@epztickets/common/shared" in the
+// frontend (the package root pulls in server-only code: express,
+// nats, pino…). Services can keep importing from the root, which
+// re-exports everything here.
+__exportStar(require("./stripe-fee"), exports);
+__exportStar(require("./business-hours"), exports);
+__exportStar(require("./class-categories"), exports);

package/build/shared/stripe-fee.d.ts

@@ -0,0 +1,8 @@
+export declare const STRIPE_FEE_PCT = 0.029;
+export declare const STRIPE_FEE_FIXED_CENTS = 30;
+/** Total to charge (cents) for a base price (cents). 0 stays 0. */
+export declare function totalWithStripeFeeCents(baseCents: number): number;
+/** Dollars in → dollars out, rounded to cents. */
+export declare function totalWithStripeFee(baseDollars: number): number;
+/** The processing-fee portion (dollars) of a base price (dollars). */
+export declare function stripeFeeFor(baseDollars: number): number;

package/build/shared/stripe-fee.js

@@ -0,0 +1,33 @@
+"use strict";
+// Stripe processing-fee pass-through — THE single source of truth for
+// what a renter pays at checkout. Used by:
+//   - payments (new-stripe-session): the amount actually charged
+//   - frontend ReserveModal: the price shown before booking
+//   - frontend order page: fallback total when Stripe's real charged
+//     amount isn't recorded yet
+// If these ever disagreed, renters would see one price and pay another.
+//
+// Stripe takes 2.9% + 30¢ of the TOTAL charge. We gross up the room
+// price so that after Stripe's cut the platform still receives the
+// full base amount:  total = ceil((base + 30) / (1 - 0.029)).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STRIPE_FEE_FIXED_CENTS = exports.STRIPE_FEE_PCT = void 0;
+exports.totalWithStripeFeeCents = totalWithStripeFeeCents;
+exports.totalWithStripeFee = totalWithStripeFee;
+exports.stripeFeeFor = stripeFeeFor;
+exports.STRIPE_FEE_PCT = 0.029;
+exports.STRIPE_FEE_FIXED_CENTS = 30;
+/** Total to charge (cents) for a base price (cents). 0 stays 0. */
+function totalWithStripeFeeCents(baseCents) {
+    if (baseCents <= 0)
+        return 0;
+    return Math.ceil((baseCents + exports.STRIPE_FEE_FIXED_CENTS) / (1 - exports.STRIPE_FEE_PCT));
+}
+/** Dollars in → dollars out, rounded to cents. */
+function totalWithStripeFee(baseDollars) {
+    return totalWithStripeFeeCents(Math.round(baseDollars * 100)) / 100;
+}
+/** The processing-fee portion (dollars) of a base price (dollars). */
+function stripeFeeFor(baseDollars) {
+    return Math.round((totalWithStripeFee(baseDollars) - baseDollars) * 100) / 100;
+}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@epztickets/common",
-  "version": "1.88.0",
+  "version": "1.90.0",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
   "files": [
-    "build/**/*"
+    "build/**/*",
+    "shared/package.json"
   ],
   "scripts": {
     "clean": "rimraf build",

package/shared/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@epztickets/common/shared",
+  "private": true,
+  "main": "../build/shared/index.js",
+  "types": "../build/shared/index.d.ts"
+}