lemon-model 1.2.3 → 1.4.0

package/dist/socket/client/reconnect-controller.d.ts

@@ -0,0 +1,56 @@
+import type { SharedTimerScheduler, SocketRuntimePort, SocketUnsubscribe } from './types';
+export interface ReconnectGiveUpEvent {
+    attempts: number;
+}
+export interface ReconnectConnectFailedEvent {
+    attempt: number;
+    error: unknown;
+}
+export interface ReconnectControllerOptions<TMessage> {
+    client: SocketRuntimePort<TMessage>;
+    minDelayMs?: number;
+    maxDelayMs?: number;
+    factor?: number;
+    jitterRatio?: number;
+    jitterMode?: 'equal' | 'full';
+    maxAttempts?: number;
+    minStableMs?: number;
+    timerScheduler?: SharedTimerScheduler;
+    timerKey?: string;
+    now?: () => number;
+}
+export declare class ReconnectController<TMessage = unknown> {
+    private readonly client;
+    private readonly minDelayMs;
+    private readonly maxDelayMs;
+    private readonly factor;
+    private readonly jitterRatio;
+    private readonly jitterMode;
+    private readonly maxAttempts;
+    private readonly minStableMs;
+    private readonly timerScheduler;
+    private readonly timerKey;
+    private readonly now;
+    private readonly unsubs;
+    private readonly giveUpListeners;
+    private readonly connectFailedListeners;
+    private active;
+    private manualStop;
+    private restarting;
+    private connecting?;
+    private attempt;
+    private stableSince?;
+    constructor(options: ReconnectControllerOptions<TMessage>);
+    start(): Promise<void>;
+    stop(code?: number, reason?: string): Promise<void>;
+    restart(): Promise<void>;
+    onGiveUp(listener: (event: ReconnectGiveUpEvent) => void): SocketUnsubscribe;
+    onConnectFailed(listener: (event: ReconnectConnectFailedEvent) => void): SocketUnsubscribe;
+    destroy(): void;
+    private applyStableReset;
+    private scheduleReconnect;
+    private tryConnect;
+    private giveUp;
+    private clearTimer;
+    private computeBackoffDelay;
+}

package/dist/socket/client/reconnect-controller.js

@@ -0,0 +1,177 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReconnectController = void 0;
+const shared_timer_scheduler_1 = require("./shared-timer-scheduler");
+class ReconnectController {
+    constructor(options) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        this.unsubs = [];
+        this.giveUpListeners = new Set();
+        this.connectFailedListeners = new Set();
+        this.active = false;
+        this.manualStop = false;
+        this.restarting = false;
+        this.attempt = 0;
+        this.client = options.client;
+        this.minDelayMs = (_a = options.minDelayMs) !== null && _a !== void 0 ? _a : 500;
+        this.maxDelayMs = (_b = options.maxDelayMs) !== null && _b !== void 0 ? _b : 30000;
+        this.factor = (_c = options.factor) !== null && _c !== void 0 ? _c : 2;
+        this.jitterRatio = Math.max(0, Math.min(1, (_d = options.jitterRatio) !== null && _d !== void 0 ? _d : 0.3));
+        this.jitterMode = (_e = options.jitterMode) !== null && _e !== void 0 ? _e : 'equal';
+        this.maxAttempts = Math.max(0, (_f = options.maxAttempts) !== null && _f !== void 0 ? _f : 0);
+        this.minStableMs = Math.max(0, (_g = options.minStableMs) !== null && _g !== void 0 ? _g : 5000);
+        this.timerScheduler = (_h = options.timerScheduler) !== null && _h !== void 0 ? _h : new shared_timer_scheduler_1.InMemorySharedTimerScheduler();
+        this.timerKey = (_j = options.timerKey) !== null && _j !== void 0 ? _j : 'reconnect';
+        this.now = (_k = options.now) !== null && _k !== void 0 ? _k : (() => Date.now());
+        this.unsubs.push(options.client.onState(event => {
+            if (!this.active)
+                return;
+            if (event.next === 'connected') {
+                this.stableSince = this.now();
+                this.clearTimer();
+                this.connecting = undefined;
+            }
+            if (event.next === 'closed' && !this.manualStop && !this.restarting) {
+                this.applyStableReset();
+                this.scheduleReconnect();
+            }
+        }));
+    }
+    start() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.active = true;
+            this.manualStop = false;
+            this.clearTimer();
+            this.attempt = 0;
+            this.stableSince = this.client.state === 'connected' ? this.now() : undefined;
+            if (this.client.state !== 'connected')
+                yield this.tryConnect();
+        });
+    }
+    stop(code, reason) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.active = false;
+            this.manualStop = true;
+            this.restarting = false;
+            this.clearTimer();
+            this.attempt = 0;
+            this.stableSince = undefined;
+            yield this.client.disconnect(code, reason);
+        });
+    }
+    restart() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.active) {
+                yield this.start();
+                return;
+            }
+            this.clearTimer();
+            this.attempt = 0;
+            this.stableSince = undefined;
+            this.restarting = true;
+            try {
+                if (this.client.state === 'connected' || this.client.state === 'connecting') {
+                    yield this.client.disconnect(1012, 'service-restart');
+                }
+                yield this.tryConnect();
+            }
+            finally {
+                this.restarting = false;
+            }
+        });
+    }
+    onGiveUp(listener) {
+        this.giveUpListeners.add(listener);
+        return () => this.giveUpListeners.delete(listener);
+    }
+    onConnectFailed(listener) {
+        this.connectFailedListeners.add(listener);
+        return () => this.connectFailedListeners.delete(listener);
+    }
+    destroy() {
+        this.clearTimer();
+        this.giveUpListeners.clear();
+        this.connectFailedListeners.clear();
+        this.unsubs.splice(0).forEach(unsub => unsub());
+    }
+    applyStableReset() {
+        if (this.stableSince === undefined)
+            return;
+        const stableMs = this.now() - this.stableSince;
+        this.stableSince = undefined;
+        if (stableMs >= this.minStableMs)
+            this.attempt = 0;
+    }
+    scheduleReconnect() {
+        if (!this.active || this.manualStop || this.connecting)
+            return;
+        if (this.maxAttempts > 0 && this.attempt >= this.maxAttempts) {
+            this.giveUp();
+            return;
+        }
+        const delayMs = this.computeBackoffDelay(this.attempt);
+        this.timerScheduler.schedule(this.timerKey, delayMs, () => {
+            void this.tryConnect();
+        });
+        this.attempt += 1;
+    }
+    tryConnect() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.active || this.manualStop)
+                return;
+            if (this.connecting)
+                return this.connecting;
+            const attempt = this.attempt;
+            let resolveConnecting;
+            this.connecting = new Promise(resolve => {
+                resolveConnecting = resolve;
+            });
+            let connectPromise;
+            try {
+                connectPromise = Promise.resolve(this.client.connect());
+            }
+            catch (error) {
+                connectPromise = Promise.reject(error);
+            }
+            connectPromise.then(() => {
+                this.connecting = undefined;
+                resolveConnecting();
+            }, error => {
+                this.connecting = undefined;
+                this.connectFailedListeners.forEach(listener => listener({ attempt, error }));
+                this.scheduleReconnect();
+                resolveConnecting();
+            });
+            return this.connecting;
+        });
+    }
+    giveUp() {
+        const attempts = this.attempt;
+        this.active = false;
+        this.clearTimer();
+        this.giveUpListeners.forEach(listener => listener({ attempts }));
+    }
+    clearTimer() {
+        this.timerScheduler.cancel(this.timerKey);
+    }
+    computeBackoffDelay(attempt) {
+        const expDelay = Math.min(this.minDelayMs * Math.pow(this.factor, attempt), this.maxDelayMs);
+        if (this.jitterMode === 'full') {
+            const delay = Math.random() * expDelay;
+            return Math.max(this.minDelayMs, Math.min(this.maxDelayMs, delay));
+        }
+        const jitter = this.jitterRatio > 0 ? expDelay * (Math.random() * 2 - 1) * this.jitterRatio : 0;
+        return Math.max(this.minDelayMs, Math.min(this.maxDelayMs, expDelay + jitter));
+    }
+}
+exports.ReconnectController = ReconnectController;
+//# sourceMappingURL=reconnect-controller.js.map

package/dist/socket/client/reconnect-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-controller.js","sourceRoot":"","sources":["../../../src/socket/client/reconnect-controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qEAAwE;AA0BxE,MAAa,mBAAmB;IAsB5B,YAAmB,OAA6C;;QAV/C,WAAM,GAAwB,EAAE,CAAC;QACjC,oBAAe,GAAG,IAAI,GAAG,EAAyC,CAAC;QACnE,2BAAsB,GAAG,IAAI,GAAG,EAAgD,CAAC;QAC1F,WAAM,GAAG,KAAK,CAAC;QACf,eAAU,GAAG,KAAK,CAAC;QACnB,eAAU,GAAG,KAAK,CAAC;QAEnB,YAAO,GAAG,CAAC,CAAC;QAIhB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,MAAA,OAAO,CAAC,UAAU,mCAAI,GAAG,CAAC;QAC5C,IAAI,CAAC,UAAU,GAAG,MAAA,OAAO,CAAC,UAAU,mCAAI,KAAK,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,MAAA,OAAO,CAAC,MAAM,mCAAI,CAAC,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAA,OAAO,CAAC,WAAW,mCAAI,GAAG,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,UAAU,GAAG,MAAA,OAAO,CAAC,UAAU,mCAAI,OAAO,CAAC;QAChD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAA,OAAO,CAAC,WAAW,mCAAI,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAA,OAAO,CAAC,WAAW,mCAAI,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,cAAc,GAAG,MAAA,OAAO,CAAC,cAAc,mCAAI,IAAI,qDAA4B,EAAE,CAAC;QACnF,IAAI,CAAC,QAAQ,GAAG,MAAA,OAAO,CAAC,QAAQ,mCAAI,WAAW,CAAC;QAChD,IAAI,CAAC,GAAG,GAAG,MAAA,OAAO,CAAC,GAAG,mCAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,CACZ,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAC3B,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO;YACzB,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE;gBAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC9B,IAAI,CAAC,UAAU,EAAE,CAAC;gBAClB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;aAC/B;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;gBACjE,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACxB,IAAI,CAAC,iBAAiB,EAAE,CAAC;aAC5B;QACL,CAAC,CAAC,CACL,CAAC;IACN,CAAC;IAEY,KAAK;;YACd,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YACxB,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;YACjB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9E,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,WAAW;gBAAE,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACnE,CAAC;KAAA;IAEY,IAAI,CAAC,IAAa,EAAE,MAAe;;YAC5C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YACxB,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;YACjB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YAC7B,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;KAAA;IAEY,OAAO;;YAChB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;gBACd,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;gBACnB,OAAO;aACV;YACD,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;YACjB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,IAAI;gBACA,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,YAAY,EAAE;oBACzE,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;iBACzD;gBACD,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;aAC3B;oBAAS;gBACN,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;aAC3B;QACL,CAAC;KAAA;IAEM,QAAQ,CAAC,QAA+C;QAC3D,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC;IAEM,eAAe,CAAC,QAAsD;QACzE,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC;IAEM,OAAO;QACV,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,sBAAsB,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAEO,gBAAgB;QACpB,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QAC/C,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,QAAQ,IAAI,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IACvD,CAAC;IAEO,iBAAiB;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC/D,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE;YAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;SACV;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;YACtD,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IACtB,CAAC;IAEa,UAAU;;YACpB,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU;gBAAE,OAAO;YAC5C,IAAI,IAAI,CAAC,UAAU;gBAAE,OAAO,IAAI,CAAC,UAAU,CAAC;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,IAAI,iBAA8B,CAAC;YACnC,IAAI,CAAC,UAAU,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;gBAC1C,iBAAiB,GAAG,OAAO,CAAC;YAChC,CAAC,CAAC,CAAC;YACH,IAAI,cAA6B,CAAC;YAClC,IAAI;gBACA,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;aAC3D;YAAC,OAAO,KAAK,EAAE;gBACZ,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aAC1C;YACD,cAAc,CAAC,IAAI,CACf,GAAG,EAAE;gBACD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;gBAC5B,iBAAiB,EAAE,CAAC;YACxB,CAAC,EACD,KAAK,CAAC,EAAE;gBACJ,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;gBAC5B,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC9E,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACzB,iBAAiB,EAAE,CAAC;YACxB,CAAC,CACJ,CAAC;YACF,OAAO,IAAI,CAAC,UAAU,CAAC;QAC3B,CAAC;KAAA;IAEO,MAAM;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IAEO,UAAU;QACd,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAEO,mBAAmB,CAAC,OAAe;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7F,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM,EAAE;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC;YACvC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;SACtE;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAChG,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC;IACnF,CAAC;CACJ;AA9KD,kDA8KC"}

package/dist/socket/client/rotation-controller.d.ts

@@ -0,0 +1,32 @@
+import type { SharedTimerScheduler, SocketRuntimePort } from './types';
+export interface RotationReconnectControl {
+    restart(): Promise<void>;
+}
+export interface RotationControllerOptions<TMessage> {
+    client: SocketRuntimePort<TMessage>;
+    reconnect?: RotationReconnectControl;
+    maxLifetimeMs?: number;
+    refreshBeforeMs?: number;
+    jitterRatio?: number;
+    timerScheduler?: SharedTimerScheduler;
+    timerKey?: string;
+}
+export declare class RotationController<TMessage = unknown> {
+    private readonly client;
+    private readonly reconnect;
+    private readonly maxLifetimeMs;
+    private readonly refreshBeforeMs;
+    private readonly jitterRatio;
+    private readonly timerScheduler;
+    private readonly timerKey;
+    private readonly unsubs;
+    private active;
+    constructor(options: RotationControllerOptions<TMessage>);
+    start(): void;
+    stop(): void;
+    destroy(): void;
+    private scheduleRotation;
+    private rotate;
+    private clearTimer;
+    private computeRotationDelay;
+}

package/dist/socket/client/rotation-controller.js

@@ -0,0 +1,76 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RotationController = void 0;
+const shared_timer_scheduler_1 = require("./shared-timer-scheduler");
+class RotationController {
+    constructor(options) {
+        var _a, _b, _c, _d, _e;
+        this.unsubs = [];
+        this.active = false;
+        this.client = options.client;
+        this.reconnect = options.reconnect;
+        this.maxLifetimeMs = (_a = options.maxLifetimeMs) !== null && _a !== void 0 ? _a : 1000 * 60 * 110;
+        this.refreshBeforeMs = (_b = options.refreshBeforeMs) !== null && _b !== void 0 ? _b : 1000 * 60 * 10;
+        this.jitterRatio = Math.max(0, Math.min(1, (_c = options.jitterRatio) !== null && _c !== void 0 ? _c : 0.1));
+        this.timerScheduler = (_d = options.timerScheduler) !== null && _d !== void 0 ? _d : new shared_timer_scheduler_1.InMemorySharedTimerScheduler();
+        this.timerKey = (_e = options.timerKey) !== null && _e !== void 0 ? _e : 'rotation';
+        this.unsubs.push(options.client.onState(event => {
+            if (!this.active)
+                return;
+            if (event.next === 'connected')
+                this.scheduleRotation();
+            if (event.next === 'closing' || event.next === 'closed')
+                this.clearTimer();
+        }));
+    }
+    start() {
+        this.active = true;
+        if (this.client.state === 'connected')
+            this.scheduleRotation();
+    }
+    stop() {
+        this.active = false;
+        this.clearTimer();
+    }
+    destroy() {
+        this.stop();
+        this.unsubs.splice(0).forEach(unsub => unsub());
+    }
+    scheduleRotation() {
+        this.clearTimer();
+        if (!this.active)
+            return;
+        this.timerScheduler.schedule(this.timerKey, this.computeRotationDelay(), () => this.rotate());
+    }
+    rotate() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.active)
+                return;
+            if (this.reconnect) {
+                yield this.reconnect.restart();
+                return;
+            }
+            yield this.client.disconnect(1012, 'service-restart');
+            yield this.client.connect();
+        });
+    }
+    clearTimer() {
+        this.timerScheduler.cancel(this.timerKey);
+    }
+    computeRotationDelay() {
+        const baseDelay = Math.max(0, this.maxLifetimeMs - this.refreshBeforeMs);
+        const jitter = this.jitterRatio > 0 ? baseDelay * (Math.random() * 2 - 1) * this.jitterRatio : 0;
+        return Math.max(0, baseDelay + jitter);
+    }
+}
+exports.RotationController = RotationController;
+//# sourceMappingURL=rotation-controller.js.map

package/dist/socket/client/rotation-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotation-controller.js","sourceRoot":"","sources":["../../../src/socket/client/rotation-controller.ts"],"names":[],"mappings":"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"}

package/dist/socket/client/shared-timer-scheduler.d.ts

@@ -0,0 +1,17 @@
+import type { SharedTimerScheduler } from './types';
+export interface SharedTimerSchedulerOptions {
+    now?: () => number;
+}
+export declare class InMemorySharedTimerScheduler implements SharedTimerScheduler {
+    private readonly tasks;
+    private readonly now;
+    private timer?;
+    constructor(options?: SharedTimerSchedulerOptions);
+    schedule(key: string, delayMs: number, task: () => unknown | Promise<unknown>): void;
+    cancel(key: string): void;
+    cancelAll(prefix?: string): void;
+    size(): number;
+    private rearm;
+    private getNextTask;
+    private flush;
+}

package/dist/socket/client/shared-timer-scheduler.js

@@ -0,0 +1,77 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemorySharedTimerScheduler = void 0;
+class InMemorySharedTimerScheduler {
+    constructor(options = {}) {
+        var _a;
+        this.tasks = new Map();
+        this.now = (_a = options.now) !== null && _a !== void 0 ? _a : (() => Date.now());
+    }
+    schedule(key, delayMs, task) {
+        const safeDelayMs = Math.max(0, delayMs || 0);
+        this.tasks.set(key, {
+            key,
+            dueAt: this.now() + safeDelayMs,
+            task,
+        });
+        this.rearm();
+    }
+    cancel(key) {
+        this.tasks.delete(key);
+        this.rearm();
+    }
+    cancelAll(prefix) {
+        if (!prefix) {
+            this.tasks.clear();
+            this.rearm();
+            return;
+        }
+        for (const key of [...this.tasks.keys()]) {
+            if (key.startsWith(prefix))
+                this.tasks.delete(key);
+        }
+        this.rearm();
+    }
+    size() {
+        return this.tasks.size;
+    }
+    rearm() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+        const next = this.getNextTask();
+        if (!next)
+            return;
+        const delayMs = Math.max(0, next.dueAt - this.now());
+        this.timer = setTimeout(() => void this.flush(), delayMs);
+    }
+    getNextTask() {
+        let next;
+        this.tasks.forEach(task => {
+            if (!next || task.dueAt < next.dueAt)
+                next = task;
+        });
+        return next;
+    }
+    flush() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.timer = undefined;
+            const now = this.now();
+            const due = [...this.tasks.values()].filter(task => task.dueAt <= now);
+            due.forEach(task => this.tasks.delete(task.key));
+            this.rearm();
+            yield Promise.all(due.map(task => Promise.resolve(task.task()).catch(() => undefined)));
+        });
+    }
+}
+exports.InMemorySharedTimerScheduler = InMemorySharedTimerScheduler;
+//# sourceMappingURL=shared-timer-scheduler.js.map

package/dist/socket/client/shared-timer-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-timer-scheduler.js","sourceRoot":"","sources":["../../../src/socket/client/shared-timer-scheduler.ts"],"names":[],"mappings":"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"}

package/dist/socket/client/socket-client.d.ts

@@ -0,0 +1,2 @@
+import type { SocketClientCore, SocketClientCoreOptions } from './types';
+export declare const createSocketClientCore: <TMessage>(options: SocketClientCoreOptions<TMessage>) => SocketClientCore<TMessage>;