@epztickets/common 1.81.0 → 1.83.0

package/build/events/jetstream-listener.d.ts

@@ -13,6 +13,12 @@ export declare abstract class JetStreamListener<T extends Event> {
     constructor(js: JetStreamClient, jsm: JetStreamManager);
     listen(): Promise<void>;
     private ensureConsumer;
+    /**
+     * Ask JetStream to redeliver this message later (NAK with backoff).
+     * Use for "not ready yet" (replica missing) and transient failures.
+     * Safe to call from handlers whose tests pass a bare { ack } mock.
+     */
+    protected defer(msg: JsMsg, reason?: string): void;
     abstract onMessage(data: T["data"], msg: JsMsg): Promise<void>;
 }
 export {};

package/build/events/jetstream-listener.js

@@ -18,6 +18,20 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JetStreamListener = void 0;
 const nats_1 = require("nats");
+// Must match max_deliver in ensureConsumer below.
+const MAX_DELIVER = 5;
+// Retry backoff for defer(): 2s, 4s, 8s, 16s (capped at 30s).
+const BASE_RETRY_MS = 2000;
+const MAX_RETRY_MS = 30000;
+// ACK CONTRACT for onMessage implementations:
+//   - Return normally → the message is ACKed (done, never redelivered).
+//     This is true even if you didn't call msg.ack() yourself.
+//   - Want a retry (replica not caught up, transient DB/SMTP error)?
+//     `return this.defer(msg)` — NAKs with backoff so JetStream
+//     redelivers. Just returning without msg.ack() does NOT retry.
+//   - Throwing also retries (the base class defers for you).
+// After MAX_DELIVER attempts JetStream stops redelivering; defer()
+// logs an error on the final attempt so a dropped event is visible.
 class JetStreamListener {
     constructor(js, jsm) {
         this.js = js;
@@ -42,10 +56,13 @@ class JetStreamListener {
                     try {
                         const data = JSON.parse(msg.data.toString());
                         yield this.onMessage(data, msg);
+                        // No-op if onMessage already acked or deferred (nats ignores a
+                        // second ack/nak on the same message).
                         msg.ack();
                     }
                     catch (err) {
-                        console.error("Listener error", err);
+                        console.error(`[${this.durableName}] Listener error`, err);
+                        this.defer(msg);
                     }
                 }
             }
@@ -72,10 +89,29 @@ class JetStreamListener {
                     filter_subject: this.subject,
                     ack_policy: nats_1.AckPolicy.Explicit,
                     deliver_policy: nats_1.DeliverPolicy.All,
-                    max_deliver: 5,
+                    max_deliver: MAX_DELIVER,
                 });
             }
         });
     }
+    /**
+     * Ask JetStream to redeliver this message later (NAK with backoff).
+     * Use for "not ready yet" (replica missing) and transient failures.
+     * Safe to call from handlers whose tests pass a bare { ack } mock.
+     */
+    defer(msg, reason) {
+        var _a, _b;
+        const attempt = (_b = (_a = msg === null || msg === void 0 ? void 0 : msg.info) === null || _a === void 0 ? void 0 : _a.deliveryCount) !== null && _b !== void 0 ? _b : 1;
+        const delayMs = Math.min(BASE_RETRY_MS * 2 ** (attempt - 1), MAX_RETRY_MS);
+        const why = reason ? ` (${reason})` : "";
+        if (attempt >= MAX_DELIVER) {
+            console.error(`[${this.durableName}] giving up on ${this.subject} after ${attempt} attempts${why} — event will NOT be redelivered`);
+        }
+        else {
+            console.warn(`[${this.durableName}] deferring ${this.subject}${why}; attempt ${attempt}/${MAX_DELIVER}, retry in ${delayMs}ms`);
+        }
+        if (typeof (msg === null || msg === void 0 ? void 0 : msg.nak) === "function")
+            msg.nak(delayMs);
+    }
 }
 exports.JetStreamListener = JetStreamListener;

package/build/events/order-reschedule-requested-event.d.ts

@@ -0,0 +1,11 @@
+import { Subjects } from "./subjects";
+export interface OrderRescheduleRequestedEvent {
+    subject: Subjects.OrderRescheduleRequested;
+    data: {
+        orderId: string;
+        requestId: string;
+        sellableUnitId: string;
+        startTime: string;
+        endTime: string;
+    };
+}

package/build/events/order-reschedule-requested-event.js

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

package/build/events/order-rescheduled-event.d.ts

@@ -0,0 +1,25 @@
+import { Subjects } from "./subjects";
+export interface OrderRescheduledEvent {
+    subject: Subjects.OrderRescheduled;
+    data: {
+        id: string;
+        version: number;
+        userId: string;
+        ownerUserId?: string;
+        selfBooking?: boolean;
+        sellableUnit: {
+            id: string;
+            title: string;
+            roomId: string;
+        };
+        classTitle?: string;
+        timezone?: string;
+        previousStartTime: string;
+        previousEndTime: string;
+        startTime: string;
+        endTime: string;
+        price: number;
+        priceDelta: number;
+        rescheduledBy: "renter" | "owner" | "admin";
+    };
+}

package/build/events/order-rescheduled-event.js

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

package/build/events/subjects.d.ts

@@ -19,6 +19,10 @@ export declare enum Subjects {
     OrderRefunded = "events.order.refunded",
     OrderRefundFailed = "events.order.refund-failed",
     OrderAwaitingPayment = "events.order.awaiting-payment",
+    OrderRescheduleRequested = "events.order.reschedule-requested",
+    OrderRescheduled = "events.order.rescheduled",
+    TimeLockMoved = "events.timelock.moved",
+    TimeLockMoveRejected = "events.timelock.move-rejected",
     ExpirationComplete = "events.expiration.complete",
     PaymentCreated = "events.payment.created",
     OwnerApproved = "events.owner.approved",

package/build/events/subjects.js

@@ -36,6 +36,15 @@ var Subjects;
     // OrderCancelled/Completed transitions and the Stripe charge route would
     // have no way to refuse pre-confirmation payments.
     Subjects["OrderAwaitingPayment"] = "events.order.awaiting-payment";
+    // Reschedule lifecycle (move a paid booking to a new time, same
+    // order). orders publishes Requested → inventory moves the
+    // TimeLock in place and replies Moved or MoveRejected → orders
+    // applies the change and publishes Rescheduled for downstream
+    // consumers (notifications: emails + reminder reset).
+    Subjects["OrderRescheduleRequested"] = "events.order.reschedule-requested";
+    Subjects["OrderRescheduled"] = "events.order.rescheduled";
+    Subjects["TimeLockMoved"] = "events.timelock.moved";
+    Subjects["TimeLockMoveRejected"] = "events.timelock.move-rejected";
     Subjects["ExpirationComplete"] = "events.expiration.complete";
     Subjects["PaymentCreated"] = "events.payment.created";
     Subjects["OwnerApproved"] = "events.owner.approved";

package/build/events/timelock-move-rejected-event.d.ts

@@ -0,0 +1,9 @@
+import { Subjects } from "./subjects";
+export interface TimeLockMoveRejectedEvent {
+    subject: Subjects.TimeLockMoveRejected;
+    data: {
+        orderId: string;
+        requestId: string;
+        reason: string;
+    };
+}

package/build/events/timelock-move-rejected-event.js

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

package/build/events/timelock-moved-event.d.ts

@@ -0,0 +1,11 @@
+import { Subjects } from "./subjects";
+export interface TimeLockMovedEvent {
+    subject: Subjects.TimeLockMoved;
+    data: {
+        orderId: string;
+        requestId: string;
+        sellableUnitId: string;
+        startTime: string;
+        endTime: string;
+    };
+}

package/build/events/timelock-moved-event.js

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

package/build/index.d.ts

@@ -37,6 +37,10 @@ export * from "./events/order-cancelled-event";
 export * from "./events/order-completed-event";
 export * from "./events/order-created-event";
 export * from "./events/order-awaiting-payment-event";
+export * from "./events/order-reschedule-requested-event";
+export * from "./events/order-rescheduled-event";
+export * from "./events/timelock-moved-event";
+export * from "./events/timelock-move-rejected-event";
 export * from "./events/order-refund-requested-event";
 export * from "./events/order-refunded-event";
 export * from "./events/order-refund-failed-event";

package/build/index.js

@@ -57,6 +57,10 @@ __exportStar(require("./events/order-cancelled-event"), exports);
 __exportStar(require("./events/order-completed-event"), exports);
 __exportStar(require("./events/order-created-event"), exports);
 __exportStar(require("./events/order-awaiting-payment-event"), exports);
+__exportStar(require("./events/order-reschedule-requested-event"), exports);
+__exportStar(require("./events/order-rescheduled-event"), exports);
+__exportStar(require("./events/timelock-moved-event"), exports);
+__exportStar(require("./events/timelock-move-rejected-event"), exports);
 __exportStar(require("./events/order-refund-requested-event"), exports);
 __exportStar(require("./events/order-refunded-event"), exports);
 __exportStar(require("./events/order-refund-failed-event"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epztickets/common",
-  "version": "1.81.0",
+  "version": "1.83.0",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
   "files": [