@epztickets/common 1.98.0 → 1.100.0

package/build/events/contract-events.d.ts

@@ -36,3 +36,15 @@ export interface RenterContractStatusChangedEvent {
         changedAt: string;
     };
 }
+export interface ResourceSharedEvent {
+    subject: Subjects.ResourceShared;
+    data: {
+        resourceId: string;
+        title: string;
+        ownerUserId: string;
+        ownerName?: string;
+        buildingName?: string;
+        updated: boolean;
+        renterUserIds: string[];
+    };
+}

package/build/events/room-pricing-updated-event.d.ts

@@ -0,0 +1,13 @@
+import { Subjects } from "./subjects";
+import { PricingRules } from "../shared/pricing";
+export interface RoomPricingUpdatedEvent {
+    subject: Subjects.RoomPricingUpdated;
+    data: {
+        roomId: string;
+        ownerUserId: string;
+        baseRate: number;
+        rules: PricingRules | null;
+        source: "room" | "building" | "none";
+        updatedAt: string;
+    };
+}

package/build/events/room-pricing-updated-event.js

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

package/build/events/subjects.d.ts

@@ -61,6 +61,8 @@ export declare enum Subjects {
     ContractSignRequested = "events.contract.sign-requested",
     ContractSigned = "events.contract.signed",
     RenterContractStatusChanged = "events.contract.renter-status-changed",
+    ResourceShared = "events.contract.resource-shared",
+    RoomPricingUpdated = "events.room.pricing-updated",
     OrderSeriesCancelled = "events.order-series.cancelled"
 }
 export declare enum Streams {

package/build/events/subjects.js

@@ -183,6 +183,9 @@ var Subjects;
     Subjects["ContractSignRequested"] = "events.contract.sign-requested";
     Subjects["ContractSigned"] = "events.contract.signed";
     Subjects["RenterContractStatusChanged"] = "events.contract.renter-status-changed";
+    Subjects["ResourceShared"] = "events.contract.resource-shared";
+    // Dynamic pricing (rooms → orders).
+    Subjects["RoomPricingUpdated"] = "events.room.pricing-updated";
     Subjects["OrderSeriesCancelled"] = "events.order-series.cancelled";
 })(Subjects || (exports.Subjects = Subjects = {}));
 var Streams;

package/build/index.d.ts

@@ -57,6 +57,7 @@ export * from "./events/time-block-events";
 export * from "./events/order-series-events";
 export * from "./events/order-hold-events";
 export * from "./events/contract-events";
+export * from "./events/room-pricing-updated-event";
 export * from "./events/order-rejected-event";
 export * from "./events/sellableunit-created-event";
 export * from "./events/sellableunit-updated-event";

package/build/index.js

@@ -78,6 +78,7 @@ __exportStar(require("./events/time-block-events"), exports);
 __exportStar(require("./events/order-series-events"), exports);
 __exportStar(require("./events/order-hold-events"), exports);
 __exportStar(require("./events/contract-events"), exports);
+__exportStar(require("./events/room-pricing-updated-event"), exports);
 __exportStar(require("./events/order-rejected-event"), exports);
 __exportStar(require("./events/sellableunit-created-event"), exports);
 __exportStar(require("./events/sellableunit-updated-event"), exports);

package/build/shared/index.d.ts

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

package/build/shared/index.js

@@ -22,3 +22,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./stripe-fee"), exports);
 __exportStar(require("./business-hours"), exports);
 __exportStar(require("./class-categories"), exports);
+__exportStar(require("./pricing"), exports);

package/build/shared/pricing.d.ts

@@ -0,0 +1,36 @@
+export interface PriceWindow {
+    name: string;
+    days: number[];
+    start: string;
+    end: string;
+    kind: "percent" | "fixed";
+    value: number;
+}
+export interface PricingRules {
+    windows: PriceWindow[];
+    minRate?: number;
+    maxRate?: number;
+    timezone: string;
+}
+export interface PriceSegment {
+    start: string;
+    end: string;
+    label: string;
+    rate: number;
+    amount: number;
+}
+export interface PriceQuote {
+    total: number;
+    hours: number;
+    effectiveRate: number;
+    segments: PriceSegment[];
+}
+export declare const STANDARD_LABEL = "Standard";
+export declare function rateAt(baseRate: number, rules: PricingRules | undefined | null, at: Date): {
+    rate: number;
+    label: string;
+};
+export declare function quotePrice(baseRate: number, rules: PricingRules | undefined | null, start: Date, end: Date): PriceQuote;
+export declare function lockedQuote(rate: number, start: Date, end: Date, label?: string): PriceQuote;
+export declare const isDynamicQuote: (q: PriceQuote) => boolean;
+export declare function pricingRulesProblem(rules: PricingRules): string | null;

package/build/shared/pricing.js

@@ -0,0 +1,159 @@
+"use strict";
+// Dynamic pricing — "price windows" (browser-safe; shared by the
+// frontend and the services so the price shown is the price charged).
+//
+// A room has a base hourly rate (Room.price). Its PricingRules (set
+// on the building, or overridden per room) list price windows:
+//   { name: "Peak", days: [1,2,3,4], start: "17:00", end: "21:00",
+//     kind: "percent", value: 25 }          → +25% Mon–Thu 5–9 PM
+//   { kind: "fixed", value: 45 }            → $45/hr in that window
+// Time outside every window = the base rate ("Standard"). When windows
+// overlap, the LATER one in the list wins. minRate / maxRate clamp the
+// resulting hourly rate. Windows are in the building's own timezone.
+//
+// Prices are worked out in 15-minute steps, so a booking that crosses
+// a window edge is priced part at each rate.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDynamicQuote = exports.STANDARD_LABEL = void 0;
+exports.rateAt = rateAt;
+exports.quotePrice = quotePrice;
+exports.lockedQuote = lockedQuote;
+exports.pricingRulesProblem = pricingRulesProblem;
+exports.STANDARD_LABEL = "Standard";
+const STEP_MS = 15 * 60 * 1000;
+const round2 = (n) => Math.round(n * 100) / 100;
+const toMin = (hhmm) => {
+    const m = /^(\d{2}):(\d{2})$/.exec(hhmm);
+    if (!m)
+        return NaN;
+    return Number(m[1]) * 60 + Number(m[2]);
+};
+// Local weekday + minute-of-day of an instant in a timezone.
+const fmtCache = new Map();
+function localParts(d, tz) {
+    var _a, _b, _c, _d, _e, _f;
+    let f = fmtCache.get(tz);
+    if (!f) {
+        f = new Intl.DateTimeFormat("en-US", {
+            timeZone: tz,
+            weekday: "short",
+            hour: "2-digit",
+            minute: "2-digit",
+            hourCycle: "h23",
+        });
+        fmtCache.set(tz, f);
+    }
+    const parts = f.formatToParts(d);
+    const wd = (_b = (_a = parts.find((p) => p.type === "weekday")) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : "Sun";
+    const h = Number((_d = (_c = parts.find((p) => p.type === "hour")) === null || _c === void 0 ? void 0 : _c.value) !== null && _d !== void 0 ? _d : 0);
+    const m = Number((_f = (_e = parts.find((p) => p.type === "minute")) === null || _e === void 0 ? void 0 : _e.value) !== null && _f !== void 0 ? _f : 0);
+    const day = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"].indexOf(wd);
+    return { day: day < 0 ? 0 : day, minute: h * 60 + m };
+}
+// The hourly rate (and its label) at one instant.
+function rateAt(baseRate, rules, at) {
+    let rate = baseRate;
+    let label = exports.STANDARD_LABEL;
+    if (rules && rules.windows.length) {
+        const { day, minute } = localParts(at, rules.timezone || "UTC");
+        for (const w of rules.windows) {
+            const s = toMin(w.start);
+            const e = w.end === "24:00" ? 1440 : toMin(w.end);
+            if (w.days.includes(day) && minute >= s && minute < e) {
+                rate = w.kind === "fixed" ? w.value : baseRate * (1 + w.value / 100);
+                label = w.name;
+            }
+        }
+    }
+    if ((rules === null || rules === void 0 ? void 0 : rules.minRate) !== undefined && rules.minRate !== null)
+        rate = Math.max(rate, rules.minRate);
+    if ((rules === null || rules === void 0 ? void 0 : rules.maxRate) !== undefined && rules.maxRate !== null)
+        rate = Math.min(rate, rules.maxRate);
+    return { rate: round2(Math.max(0, rate)), label };
+}
+// Price for [start, end) with a segment breakdown.
+function quotePrice(baseRate, rules, start, end) {
+    const segments = [];
+    let total = 0;
+    for (let t = start.getTime(); t < end.getTime(); t += STEP_MS) {
+        const stepEnd = Math.min(t + STEP_MS, end.getTime());
+        const { rate, label } = rateAt(baseRate, rules, new Date(t));
+        const amount = (rate * (stepEnd - t)) / 3600000;
+        total += amount;
+        const last = segments[segments.length - 1];
+        if (last && last.label === label && last.rate === rate) {
+            last.end = new Date(stepEnd).toISOString();
+            last.amount += amount;
+        }
+        else {
+            segments.push({ start: new Date(t).toISOString(), end: new Date(stepEnd).toISOString(), label, rate, amount });
+        }
+    }
+    for (const s of segments)
+        s.amount = round2(s.amount);
+    const hours = (end.getTime() - start.getTime()) / 3600000;
+    total = round2(total);
+    return { total, hours, effectiveRate: hours > 0 ? round2(total / hours) : baseRate, segments };
+}
+// A recurring series keeps its first date's hourly rate for every date.
+function lockedQuote(rate, start, end, label = "Series rate") {
+    const hours = (end.getTime() - start.getTime()) / 3600000;
+    const total = round2(rate * hours);
+    return {
+        total,
+        hours,
+        effectiveRate: rate,
+        segments: [{ start: start.toISOString(), end: end.toISOString(), label, rate, amount: total }],
+    };
+}
+// Does this booking touch any price window? (UI: show the breakdown.)
+const isDynamicQuote = (q) => q.segments.some((s) => s.label !== exports.STANDARD_LABEL);
+exports.isDynamicQuote = isDynamicQuote;
+// Validation shared by the owner form and the rooms service.
+// Returns a readable problem or null.
+function pricingRulesProblem(rules) {
+    if (!rules || !Array.isArray(rules.windows))
+        return "Price windows are missing.";
+    if (rules.windows.length > 20)
+        return "Use at most 20 price windows.";
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone: rules.timezone });
+    }
+    catch (_a) {
+        return "Unknown timezone.";
+    }
+    for (const [i, w] of rules.windows.entries()) {
+        const n = `Price window ${i + 1}`;
+        if (!w.name || !w.name.trim() || w.name.trim().length > 40)
+            return `${n}: give it a name (up to 40 characters).`;
+        if (!Array.isArray(w.days) || !w.days.length || w.days.some((d) => !Number.isInteger(d) || d < 0 || d > 6)) {
+            return `${n}: pick at least one day.`;
+        }
+        const s = toMin(w.start);
+        const e = w.end === "24:00" ? 1440 : toMin(w.end);
+        if (!Number.isFinite(s) || !Number.isFinite(e) || s % 15 || e % 15 || s < 0 || e > 1440) {
+            return `${n}: times must be on 15-minute steps.`;
+        }
+        if (e <= s)
+            return `${n}: the end time must be after the start time.`;
+        if (w.kind === "percent") {
+            if (!(w.value >= -90 && w.value <= 300))
+                return `${n}: the change must be between -90% and +300%.`;
+        }
+        else if (w.kind === "fixed") {
+            if (!(w.value > 0 && w.value <= 10000))
+                return `${n}: enter an hourly price above $0.`;
+        }
+        else {
+            return `${n}: choose percent or fixed price.`;
+        }
+    }
+    const { minRate, maxRate } = rules;
+    if (minRate !== undefined && minRate !== null && !(minRate >= 0))
+        return "The minimum hourly price can't be negative.";
+    if (maxRate !== undefined && maxRate !== null && !(maxRate > 0))
+        return "The maximum hourly price must be above $0.";
+    if (minRate != null && maxRate != null && minRate > maxRate)
+        return "The minimum price is higher than the maximum.";
+    return null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epztickets/common",
-  "version": "1.98.0",
+  "version": "1.100.0",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
   "files": [
@@ -15,7 +15,7 @@
     "version:major": "npm version major",
     "release:minor": "npm version minor && npm run build && npm publish",
     "pub:patch": "npm run build && git add . && git commit -m \"chore: patch release\" && npm run version:patch && npm publish",
-    "pub:minor": "npm run build && git add . && git commit -m \"feat: nats support\" && npm run version:minor && npm publish"
+    "pub:minor": "npm run build && git add . && git commit -m \"feat: version improvement\" && npm run version:minor && npm publish"
   },
   "keywords": [],
   "author": "",