@pangza/redis 0.0.0-stage → 1.0.1

package/dist/redisson/RFairLock.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFairLock = createFairLock;
+const Redis_1 = __importDefault(require("../Redis"));
+const scripts_1 = require("./scripts");
+const RLock_1 = require("./RLock");
+const types_1 = require("./types");
+const utils_1 = require("./utils");
+/**
+ * 公平锁：按等待队列顺序获取（简化版 Redisson FairLock）。
+ */
+function createFairLock(name, clientId, config = types_1.defaultRedissonConfig) {
+    const queueKey = () => Redis_1.default.key(`${name}:fair:queue`);
+    const timeoutPrefix = () => Redis_1.default.key(`${name}:fair:timeout:`);
+    return new RLock_1.RedissonLock(name, clientId, config, {
+        acquire: (threadId, leaseMs) => (0, utils_1.evalNumber)(scripts_1.FAIR_LOCK_ACQUIRE_LUA, [
+            Redis_1.default.key(name),
+            queueKey(),
+            timeoutPrefix(),
+        ], [leaseMs, `${clientId}:${threadId}`, Math.max(leaseMs * 2, 60000)]),
+        unlock: async (threadId, leaseMs) => {
+            const result = await (0, utils_1.evalScript)(scripts_1.LOCK_UNLOCK_LUA, [Redis_1.default.key(name), `pangza_lock_channel:{${name}}`], ["0", leaseMs, `${clientId}:${threadId}`]);
+            if (result === null || result === undefined)
+                return null;
+            return Number(result);
+        },
+    });
+}
+//# sourceMappingURL=RFairLock.js.map

package/dist/redisson/RFairLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RFairLock.js","sourceRoot":"","sources":["../../src/redisson/RFairLock.ts"],"names":[],"mappings":";;;;;AAUA,wCA6BC;AAvCD,qDAA6B;AAC7B,uCAAmE;AACnE,mCAAuC;AAEvC,mCAAgD;AAChD,mCAAiD;AAEjD;;GAEG;AACH,SAAgB,cAAc,CAC5B,IAAY,EACZ,QAAgB,EAChB,SAAmC,6BAAqB;IAExD,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,eAAK,CAAC,GAAG,CAAC,GAAG,IAAI,aAAa,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,eAAK,CAAC,GAAG,CAAC,GAAG,IAAI,gBAAgB,CAAC,CAAC;IAE/D,OAAO,IAAI,oBAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE;QAC9C,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAC7B,IAAA,kBAAU,EACR,+BAAqB,EACrB;YACE,eAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE;YACV,aAAa,EAAE;SAChB,EACD,CAAC,OAAO,EAAE,GAAG,QAAQ,IAAI,QAAQ,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,KAAM,CAAC,CAAC,CACpE;QACH,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;YAClC,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAU,EAC7B,yBAAe,EACf,CAAC,eAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,wBAAwB,IAAI,GAAG,CAAC,EAClD,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAC1C,CAAC;YACF,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YACzD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/redisson/RLock.d.ts

@@ -0,0 +1,44 @@
+import type { RedissonConfig, RLock } from "./types";
+type AcquireFn = (threadId: string, leaseMs: number) => Promise<number | null>;
+type UnlockFn = (threadId: string, leaseMs: number) => Promise<number | null>;
+/**
+ * Redisson 风格可重入分布式锁（Hash + 看门狗 + pub/sub 唤醒）。
+ */
+export declare class RedissonLock implements RLock {
+    readonly name: string;
+    private readonly clientId;
+    /** Redis 存储名（默认与 name 相同；读写锁读写端共享） */
+    private readonly storageName?;
+    private readonly watchdogTimeout;
+    private readonly watchInterval;
+    private renewTimer;
+    private heldThreadId;
+    private readonly doAcquire;
+    private readonly doUnlock;
+    constructor(name: string, clientId: string, config?: Required<RedissonConfig>, hooks?: {
+        acquire?: AcquireFn;
+        unlock?: UnlockFn;
+    }, 
+    /** Redis 存储名（默认与 name 相同；读写锁读写端共享） */
+    storageName?: string | undefined);
+    protected lockKey(): string;
+    protected channel(): string;
+    protected field(threadId: string): string;
+    private unlockInner;
+    lock(leaseTimeMs?: number): Promise<void>;
+    /**
+     * @param waitTimeMs 等待毫秒；undefined=0（立即）；-1=无限等
+     * @param leaseTimeMs 租约；undefined/-1=看门狗
+     */
+    tryLock(waitTimeMs?: number, leaseTimeMs?: number): Promise<boolean>;
+    private scheduleWatchdog;
+    private cancelWatchdog;
+    unlock(): Promise<void>;
+    forceUnlock(): Promise<boolean>;
+    isLocked(): Promise<boolean>;
+    isHeldByCurrentThread(): Promise<boolean>;
+    getHoldCount(): Promise<number>;
+    remainTimeToLive(): Promise<number>;
+}
+export {};
+//# sourceMappingURL=RLock.d.ts.map

package/dist/redisson/RLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RLock.d.ts","sourceRoot":"","sources":["../../src/redisson/RLock.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAYrD,KAAK,SAAS,GAAG,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5B,KAAK,QAAQ,GAAG,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5B;;GAEG;AACH,qBAAa,YAAa,YAAW,KAAK;IAStC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAGzB,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAb/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;gBAGzB,IAAI,EAAE,MAAM,EACJ,QAAQ,EAAE,MAAM,EACjC,MAAM,GAAE,QAAQ,CAAC,cAAc,CAAyB,EACxD,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,QAAQ,CAAA;KAAE;IAClD,sCAAsC;IACrB,WAAW,CAAC,EAAE,MAAM,YAAA;IAiBvC,SAAS,CAAC,OAAO,IAAI,MAAM;IAI3B,SAAS,CAAC,OAAO,IAAI,MAAM;IAI3B,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;YAI3B,WAAW;IAcnB,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C;;;OAGG;IACG,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuC1E,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,cAAc;IAOhB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAYvB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAW/B,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAM5B,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC;IAOzC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAO/B,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CAI1C"}

package/dist/redisson/RLock.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedissonLock = void 0;
+const Redis_1 = __importDefault(require("../Redis"));
+const errors_1 = require("../errors");
+const scripts_1 = require("./scripts");
+const types_1 = require("./types");
+const utils_1 = require("./utils");
+/**
+ * Redisson 风格可重入分布式锁（Hash + 看门狗 + pub/sub 唤醒）。
+ */
+class RedissonLock {
+    constructor(name, clientId, config = types_1.defaultRedissonConfig, hooks, 
+    /** Redis 存储名（默认与 name 相同；读写锁读写端共享） */
+    storageName) {
+        this.name = name;
+        this.clientId = clientId;
+        this.storageName = storageName;
+        this.renewTimer = null;
+        this.heldThreadId = null;
+        this.watchdogTimeout = config.lockWatchdogTimeout;
+        this.watchInterval = config.lockWatchInterval;
+        this.doAcquire =
+            hooks?.acquire ??
+                ((threadId, leaseMs) => (0, utils_1.evalNumber)(scripts_1.LOCK_ACQUIRE_LUA, [this.lockKey()], [
+                    leaseMs,
+                    this.field(threadId),
+                ]));
+        this.doUnlock =
+            hooks?.unlock ??
+                ((threadId, leaseMs) => this.unlockInner(scripts_1.LOCK_UNLOCK_LUA, threadId, leaseMs));
+    }
+    lockKey() {
+        return Redis_1.default.key(this.storageName ?? this.name);
+    }
+    channel() {
+        return (0, utils_1.channelName)(this.storageName ?? this.name);
+    }
+    field(threadId) {
+        return `${this.clientId}:${threadId}`;
+    }
+    async unlockInner(script, threadId, leaseMs) {
+        const result = await (0, utils_1.evalScript)(script, [this.lockKey(), this.channel()], [
+            "0",
+            leaseMs,
+            this.field(threadId),
+        ]);
+        if (result === null || result === undefined)
+            return null;
+        return Number(result);
+    }
+    async lock(leaseTimeMs) {
+        const ok = await this.tryLock(-1, leaseTimeMs);
+        if (!ok)
+            throw new errors_1.LockError(`获取锁失败: ${this.name}`);
+    }
+    /**
+     * @param waitTimeMs 等待毫秒；undefined=0（立即）；-1=无限等
+     * @param leaseTimeMs 租约；undefined/-1=看门狗
+     */
+    async tryLock(waitTimeMs, leaseTimeMs) {
+        // 同一 RLock 实例已持有时复用 threadId，保证跨 await 可重入
+        const threadId = this.heldThreadId ?? (0, utils_1.currentThreadId)(this.clientId);
+        return (0, utils_1.runWithThreadIdAsync)(threadId, async () => {
+            const wait = waitTimeMs === undefined ? 0 : waitTimeMs;
+            const useWatchdog = leaseTimeMs === undefined || leaseTimeMs < 0;
+            const lease = useWatchdog
+                ? this.watchdogTimeout
+                : Math.max(1, leaseTimeMs);
+            const deadline = wait < 0 ? Number.POSITIVE_INFINITY : Date.now() + Math.max(0, wait);
+            for (;;) {
+                const ttl = await this.doAcquire(threadId, lease);
+                if (ttl === null) {
+                    this.heldThreadId = threadId;
+                    if (useWatchdog)
+                        this.scheduleWatchdog(threadId, lease);
+                    return true;
+                }
+                if (Date.now() >= deadline)
+                    return false;
+                const remain = Math.min(Math.max(ttl > 0 ? ttl : this.watchInterval, this.watchInterval), Math.max(0, deadline - Date.now()));
+                if (remain <= 0)
+                    return false;
+                const notified = await (0, utils_1.waitNotify)(this.channel(), Math.min(remain, 3000));
+                if (!notified) {
+                    await (0, utils_1.sleep)(Math.min(this.watchInterval, remain));
+                }
+            }
+        });
+    }
+    scheduleWatchdog(threadId, leaseMs) {
+        this.cancelWatchdog();
+        const every = Math.max(100, Math.floor(leaseMs / 3));
+        this.renewTimer = setInterval(() => {
+            void (0, utils_1.evalNumber)(scripts_1.LOCK_RENEW_LUA, [this.lockKey()], [
+                leaseMs,
+                this.field(threadId),
+            ]).then((ok) => {
+                if (ok !== 1)
+                    this.cancelWatchdog();
+            });
+        }, every);
+        if (typeof this.renewTimer === "object" && "unref" in this.renewTimer) {
+            this.renewTimer.unref?.();
+        }
+    }
+    cancelWatchdog() {
+        if (this.renewTimer) {
+            clearInterval(this.renewTimer);
+            this.renewTimer = null;
+        }
+    }
+    async unlock() {
+        const threadId = this.heldThreadId ?? (0, utils_1.currentThreadId)(this.clientId);
+        const result = await this.doUnlock(threadId, this.watchdogTimeout);
+        if (result === null) {
+            throw new errors_1.LockError(`无法解锁（非持有者）: ${this.name}`);
+        }
+        if (result === 1) {
+            this.cancelWatchdog();
+            this.heldThreadId = null;
+        }
+    }
+    async forceUnlock() {
+        this.cancelWatchdog();
+        this.heldThreadId = null;
+        const n = await (0, utils_1.evalNumber)(scripts_1.LOCK_FORCE_UNLOCK_LUA, [this.lockKey(), this.channel()], ["0"]);
+        return n === 1;
+    }
+    async isLocked() {
+        const client = await Redis_1.default.getClient();
+        const n = await client.exists(this.lockKey());
+        return Number(n) > 0;
+    }
+    async isHeldByCurrentThread() {
+        const threadId = this.heldThreadId ?? (0, utils_1.currentThreadId)(this.clientId);
+        const client = await Redis_1.default.getClient();
+        const n = await client.hExists(this.lockKey(), this.field(threadId));
+        return Number(n) === 1;
+    }
+    async getHoldCount() {
+        const threadId = this.heldThreadId ?? (0, utils_1.currentThreadId)(this.clientId);
+        const client = await Redis_1.default.getClient();
+        const v = await client.hGet(this.lockKey(), this.field(threadId));
+        return v == null ? 0 : Number(v);
+    }
+    async remainTimeToLive() {
+        const client = await Redis_1.default.getClient();
+        return client.pTTL(this.lockKey());
+    }
+}
+exports.RedissonLock = RedissonLock;
+//# sourceMappingURL=RLock.js.map

package/dist/redisson/RLock.js.map

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

package/dist/redisson/RMultiLock.d.ts

@@ -0,0 +1,18 @@
+import type { RLock } from "./types";
+/**
+ * 联锁：按顺序加锁，失败则回滚已加锁。
+ */
+export declare class RedissonMultiLock implements RLock {
+    private readonly locks;
+    readonly name: string;
+    constructor(locks: RLock[]);
+    lock(leaseTimeMs?: number): Promise<void>;
+    tryLock(waitTimeMs?: number, leaseTimeMs?: number): Promise<boolean>;
+    unlock(): Promise<void>;
+    forceUnlock(): Promise<boolean>;
+    isLocked(): Promise<boolean>;
+    isHeldByCurrentThread(): Promise<boolean>;
+    getHoldCount(): Promise<number>;
+    remainTimeToLive(): Promise<number>;
+}
+//# sourceMappingURL=RMultiLock.d.ts.map

package/dist/redisson/RMultiLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RMultiLock.d.ts","sourceRoot":"","sources":["../../src/redisson/RMultiLock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;GAEG;AACH,qBAAa,iBAAkB,YAAW,KAAK;IAGjC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEO,KAAK,EAAE,KAAK,EAAE;IAKrC,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BpE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAMvB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAQ/B,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAO5B,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC;IAOzC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ/B,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CAO1C"}

package/dist/redisson/RMultiLock.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedissonMultiLock = void 0;
+const errors_1 = require("../errors");
+/**
+ * 联锁：按顺序加锁，失败则回滚已加锁。
+ */
+class RedissonMultiLock {
+    constructor(locks) {
+        this.locks = locks;
+        if (!locks.length)
+            throw new errors_1.LockError("MultiLock 至少需要一把锁");
+        this.name = locks.map((l) => l.name).join(",");
+    }
+    async lock(leaseTimeMs) {
+        const ok = await this.tryLock(-1, leaseTimeMs);
+        if (!ok)
+            throw new errors_1.LockError(`获取联锁失败: ${this.name}`);
+    }
+    async tryLock(waitTimeMs, leaseTimeMs) {
+        const acquired = [];
+        try {
+            for (const lock of this.locks) {
+                const ok = await lock.tryLock(waitTimeMs, leaseTimeMs);
+                if (!ok) {
+                    for (const a of acquired.reverse()) {
+                        try {
+                            await a.unlock();
+                        }
+                        catch {
+                            // ignore
+                        }
+                    }
+                    return false;
+                }
+                acquired.push(lock);
+            }
+            return true;
+        }
+        catch (e) {
+            for (const a of acquired.reverse()) {
+                try {
+                    await a.unlock();
+                }
+                catch {
+                    // ignore
+                }
+            }
+            throw e;
+        }
+    }
+    async unlock() {
+        for (const lock of [...this.locks].reverse()) {
+            await lock.unlock();
+        }
+    }
+    async forceUnlock() {
+        let any = false;
+        for (const lock of [...this.locks].reverse()) {
+            if (await lock.forceUnlock())
+                any = true;
+        }
+        return any;
+    }
+    async isLocked() {
+        for (const lock of this.locks) {
+            if (!(await lock.isLocked()))
+                return false;
+        }
+        return true;
+    }
+    async isHeldByCurrentThread() {
+        for (const lock of this.locks) {
+            if (!(await lock.isHeldByCurrentThread()))
+                return false;
+        }
+        return true;
+    }
+    async getHoldCount() {
+        let min = Number.POSITIVE_INFINITY;
+        for (const lock of this.locks) {
+            min = Math.min(min, await lock.getHoldCount());
+        }
+        return Number.isFinite(min) ? min : 0;
+    }
+    async remainTimeToLive() {
+        let min = Number.POSITIVE_INFINITY;
+        for (const lock of this.locks) {
+            min = Math.min(min, await lock.remainTimeToLive());
+        }
+        return Number.isFinite(min) ? min : -2;
+    }
+}
+exports.RedissonMultiLock = RedissonMultiLock;
+//# sourceMappingURL=RMultiLock.js.map

package/dist/redisson/RMultiLock.js.map

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

package/dist/redisson/RReadWriteLock.d.ts

@@ -0,0 +1,9 @@
+import type { RedissonConfig, RLock, RReadWriteLock } from "./types";
+export declare class RedissonReadWriteLock implements RReadWriteLock {
+    private readonly read;
+    private readonly write;
+    constructor(name: string, clientId: string, config?: Required<RedissonConfig>);
+    readLock(): RLock;
+    writeLock(): RLock;
+}
+//# sourceMappingURL=RReadWriteLock.d.ts.map

package/dist/redisson/RReadWriteLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RReadWriteLock.d.ts","sourceRoot":"","sources":["../../src/redisson/RReadWriteLock.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAIrE,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;gBAG5B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,QAAQ,CAAC,cAAc,CAAyB;IAsD1D,QAAQ,IAAI,KAAK;IAIjB,SAAS,IAAI,KAAK;CAGnB"}

package/dist/redisson/RReadWriteLock.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedissonReadWriteLock = void 0;
+const Redis_1 = __importDefault(require("../Redis"));
+const scripts_1 = require("./scripts");
+const RLock_1 = require("./RLock");
+const types_1 = require("./types");
+const utils_1 = require("./utils");
+class RedissonReadWriteLock {
+    constructor(name, clientId, config = types_1.defaultRedissonConfig) {
+        const storage = `${name}:rwlock`;
+        const key = () => Redis_1.default.key(storage);
+        const ch = () => (0, utils_1.channelName)(storage);
+        const field = (threadId) => `${clientId}:${threadId}`;
+        this.read = new RLock_1.RedissonLock(`${name}:read`, clientId, config, {
+            acquire: (threadId, leaseMs) => (0, utils_1.evalNumber)(scripts_1.READ_LOCK_ACQUIRE_LUA, [key()], [
+                leaseMs,
+                field(threadId),
+            ]),
+            unlock: async (threadId, leaseMs) => {
+                const result = await (0, utils_1.evalScript)(scripts_1.READ_LOCK_UNLOCK_LUA, [key(), ch()], ["0", field(threadId), leaseMs]);
+                if (result === null || result === undefined)
+                    return null;
+                return Number(result);
+            },
+        }, storage);
+        this.write = new RLock_1.RedissonLock(`${name}:write`, clientId, config, {
+            acquire: (threadId, leaseMs) => (0, utils_1.evalNumber)(scripts_1.WRITE_LOCK_ACQUIRE_LUA, [key()], [
+                leaseMs,
+                field(threadId),
+            ]),
+            unlock: async (threadId, leaseMs) => {
+                const result = await (0, utils_1.evalScript)(scripts_1.WRITE_LOCK_UNLOCK_LUA, [key(), ch()], ["0", field(threadId), leaseMs]);
+                if (result === null || result === undefined)
+                    return null;
+                return Number(result);
+            },
+        }, storage);
+    }
+    readLock() {
+        return this.read;
+    }
+    writeLock() {
+        return this.write;
+    }
+}
+exports.RedissonReadWriteLock = RedissonReadWriteLock;
+//# sourceMappingURL=RReadWriteLock.js.map

package/dist/redisson/RReadWriteLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RReadWriteLock.js","sourceRoot":"","sources":["../../src/redisson/RReadWriteLock.ts"],"names":[],"mappings":";;;;;;AAAA,qDAA6B;AAC7B,uCAKmB;AACnB,mCAAuC;AAEvC,mCAAgD;AAChD,mCAA8D;AAE9D,MAAa,qBAAqB;IAIhC,YACE,IAAY,EACZ,QAAgB,EAChB,SAAmC,6BAAqB;QAExD,MAAM,OAAO,GAAG,GAAG,IAAI,SAAS,CAAC;QACjC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,eAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAE9D,IAAI,CAAC,IAAI,GAAG,IAAI,oBAAY,CAC1B,GAAG,IAAI,OAAO,EACd,QAAQ,EACR,MAAM,EACN;YACE,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAC7B,IAAA,kBAAU,EAAC,+BAAqB,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE;gBACzC,OAAO;gBACP,KAAK,CAAC,QAAQ,CAAC;aAChB,CAAC;YACJ,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;gBAClC,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAU,EAC7B,8BAAoB,EACpB,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,EACb,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAChC,CAAC;gBACF,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;oBAAE,OAAO,IAAI,CAAC;gBACzD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC;SACF,EACD,OAAO,CACR,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG,IAAI,oBAAY,CAC3B,GAAG,IAAI,QAAQ,EACf,QAAQ,EACR,MAAM,EACN;YACE,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAC7B,IAAA,kBAAU,EAAC,gCAAsB,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE;gBAC1C,OAAO;gBACP,KAAK,CAAC,QAAQ,CAAC;aAChB,CAAC;YACJ,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;gBAClC,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAU,EAC7B,+BAAqB,EACrB,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,EACb,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAChC,CAAC;gBACF,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;oBAAE,OAAO,IAAI,CAAC;gBACzD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC;SACF,EACD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AApED,sDAoEC"}

package/dist/redisson/RSemaphore.d.ts

@@ -0,0 +1,13 @@
+import type { RSemaphore } from "./types";
+export declare class RedissonSemaphore implements RSemaphore {
+    readonly name: string;
+    constructor(name: string);
+    private key;
+    private channel;
+    trySetPermits(permits: number): Promise<boolean>;
+    availablePermits(): Promise<number>;
+    acquire(permits?: number): Promise<void>;
+    tryAcquire(permits?: number, waitTimeMs?: number): Promise<boolean>;
+    release(permits?: number): Promise<void>;
+}
+//# sourceMappingURL=RSemaphore.d.ts.map

package/dist/redisson/RSemaphore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RSemaphore.d.ts","sourceRoot":"","sources":["../../src/redisson/RSemaphore.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAS1C,qBAAa,iBAAkB,YAAW,UAAU;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;IAEjC,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,OAAO;IAIT,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKnC,OAAO,CAAC,OAAO,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnC,UAAU,CAAC,OAAO,SAAI,EAAE,UAAU,SAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBzD,OAAO,CAAC,OAAO,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAO1C"}

package/dist/redisson/RSemaphore.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedissonSemaphore = void 0;
+const Redis_1 = __importDefault(require("../Redis"));
+const scripts_1 = require("./scripts");
+const utils_1 = require("./utils");
+class RedissonSemaphore {
+    constructor(name) {
+        this.name = name;
+    }
+    key() {
+        return Redis_1.default.key(`semaphore:${this.name}`);
+    }
+    channel() {
+        return (0, utils_1.channelName)(`semaphore:${this.name}`);
+    }
+    async trySetPermits(permits) {
+        return Redis_1.default.setNX(`semaphore:${this.name}`, String(Math.max(0, permits)));
+    }
+    async availablePermits() {
+        const v = await Redis_1.default.get(`semaphore:${this.name}`);
+        return v == null ? 0 : Number(v);
+    }
+    async acquire(permits = 1) {
+        const ok = await this.tryAcquire(permits, -1);
+        if (!ok)
+            throw new Error(`获取信号量失败: ${this.name}`);
+    }
+    async tryAcquire(permits = 1, waitTimeMs = 0) {
+        const n = Math.max(1, permits);
+        const deadline = waitTimeMs < 0
+            ? Number.POSITIVE_INFINITY
+            : Date.now() + Math.max(0, waitTimeMs);
+        for (;;) {
+            // ARGV[1]=初始值（仅当 key 不存在时用，这里传 0 表示不自动初始化）
+            const ok = await (0, utils_1.evalNumber)(scripts_1.SEMAPHORE_TRY_ACQUIRE_LUA, [this.key()], [0, n]);
+            if (ok === 1)
+                return true;
+            if (Date.now() >= deadline)
+                return false;
+            const remain = Math.max(0, deadline - Date.now());
+            const notified = await (0, utils_1.waitNotify)(this.channel(), Math.min(remain, 2000));
+            if (!notified)
+                await (0, utils_1.sleep)(Math.min(50, remain));
+        }
+    }
+    async release(permits = 1) {
+        await (0, utils_1.evalScript)(scripts_1.SEMAPHORE_RELEASE_LUA, [this.key(), this.channel()], [Math.max(1, permits)]);
+    }
+}
+exports.RedissonSemaphore = RedissonSemaphore;
+//# sourceMappingURL=RSemaphore.js.map

package/dist/redisson/RSemaphore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RSemaphore.js","sourceRoot":"","sources":["../../src/redisson/RSemaphore.ts"],"names":[],"mappings":";;;;;;AAAA,qDAA6B;AAC7B,uCAGmB;AAEnB,mCAMiB;AAEjB,MAAa,iBAAiB;IAC5B,YAAqB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE7B,GAAG;QACT,OAAO,eAAK,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAEO,OAAO;QACb,OAAO,IAAA,mBAAW,EAAC,aAAa,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,OAAO,eAAK,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,CAAC,GAAG,MAAM,eAAK,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC;QACvB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,EAAE,UAAU,GAAG,CAAC;QAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,QAAQ,GACZ,UAAU,GAAG,CAAC;YACZ,CAAC,CAAC,MAAM,CAAC,iBAAiB;YAC1B,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAE3C,SAAS,CAAC;YACR,2CAA2C;YAC3C,MAAM,EAAE,GAAG,MAAM,IAAA,kBAAU,EACzB,mCAAyB,EACzB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EACZ,CAAC,CAAC,EAAE,CAAC,CAAC,CACP,CAAC;YACF,IAAI,EAAE,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1B,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,MAAM,IAAA,kBAAU,EAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1E,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAA,aAAK,EAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC;QACvB,MAAM,IAAA,kBAAU,EACd,+BAAqB,EACrB,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAC5B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CACvB,CAAC;IACJ,CAAC;CACF;AAtDD,8CAsDC"}

package/dist/redisson/Redisson.d.ts

@@ -0,0 +1,45 @@
+import type { RAtomicLong, RBitSet, RBucket, RCountDownLatch, RList, RLock, RMap, RQueue, RRateLimiter, RReadWriteLock, RScoredSortedSet, RSemaphore, RSet, RTopic, RedissonConfig } from "./types";
+/**
+ * Redisson 风格门面（基于现有 Redis 连接）。
+ *
+ * @example
+ *   const lock = Redisson.getLock('order:pay');
+ *   await lock.lock();
+ *   try { ... } finally { await lock.unlock(); }
+ */
+declare class RedissonClient {
+    private readonly clientId;
+    private config;
+    constructor(config?: RedissonConfig);
+    /** 覆盖看门狗等配置 */
+    configure(config: RedissonConfig): void;
+    getClientId(): string;
+    getLock(name: string): RLock;
+    getFairLock(name: string): RLock;
+    getReadWriteLock(name: string): RReadWriteLock;
+    getMultiLock(...locks: RLock[]): RLock;
+    getSemaphore(name: string): RSemaphore;
+    getCountDownLatch(name: string): RCountDownLatch;
+    getAtomicLong(name: string): RAtomicLong;
+    getBucket<T = unknown>(name: string): RBucket<T>;
+    getMap<V = string>(name: string): RMap<V>;
+    getSet(name: string): RSet;
+    getList(name: string): RList;
+    getScoredSortedSet(name: string): RScoredSortedSet;
+    getTopic(name: string): RTopic;
+    getRateLimiter(name: string): RRateLimiter;
+    getBitSet(name: string): RBitSet;
+    getQueue(name: string): RQueue;
+    /**
+     * 持锁执行（看门狗）；等价于 getLock + lock + unlock。
+     */
+    withLock<T>(name: string, fn: () => Promise<T> | T, leaseTimeMs?: number): Promise<T>;
+}
+/** 默认单例（进程级 clientId） */
+export declare const Redisson: RedissonClient;
+/** 创建独立客户端（不同 clientId，用于测试或多实例语义） */
+export declare function createRedisson(config?: RedissonConfig): RedissonClient;
+export type { RedissonClient };
+/** 生成随机 token（测试辅助） */
+export declare function randomLockToken(): string;
+//# sourceMappingURL=Redisson.d.ts.map

package/dist/redisson/Redisson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Redisson.d.ts","sourceRoot":"","sources":["../../src/redisson/Redisson.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,WAAW,EACX,OAAO,EACP,OAAO,EACP,eAAe,EACf,KAAK,EACL,KAAK,EACL,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,IAAI,EACJ,MAAM,EACN,cAAc,EACf,MAAM,SAAS,CAAC;AAIjB;;;;;;;GAOG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,GAAE,cAAmB;IAKvC,eAAe;IACf,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIvC,WAAW,IAAI,MAAM;IAMrB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAI5B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAIhC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAI9C,YAAY,CAAC,GAAG,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK;IAMtC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAItC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAMhD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAIxC,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAIzC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAI5B,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAIlD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAI1C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B;;OAEG;IACG,QAAQ,CAAC,CAAC,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,CAAC,CAAC;CASd;AAED,yBAAyB;AACzB,eAAO,MAAM,QAAQ,gBAAuB,CAAC;AAE7C,sCAAsC;AACtC,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,cAAc,CAEtE;AAED,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,uBAAuB;AACvB,wBAAgB,eAAe,IAAI,MAAM,CAExC"}