@zukhruf/mutex 0.3.40 → 0.3.42

package/dist/lock-stores/session/session-lock-store.js

@@ -0,0 +1,221 @@
+import { setTimeout as delay } from 'node:timers/promises';
+import { untilAborted } from '@zukhruf/async';
+import { FencingToken } from '@zukhruf/fencing';
+import { LeaseController } from '@zukhruf/lease';
+import { InProcessTurns } from "../../shared/in-process-turns.js";
+/**
+ * Holds a session-level lock of a SQL server for each key, on a session of
+ * its own. The server releases the lock when the session ends, so a holder
+ * that stops never leaves a key locked. Every process on every machine that
+ * reaches one database shares the locks.
+ *
+ * Callers in this process first line up in a queue in memory, so only the
+ * first one gets a session: one session per key per process, however many
+ * callers wait, and first-come order within the process.
+ */
+export class SessionLockStore {
+    #turns = new InProcessTurns();
+    #options;
+    #dialect;
+    constructor(options, dialect) {
+        this.#options = options;
+        this.#dialect = dialect;
+    }
+    acquire(key, options) {
+        return this.#turns.acquire(key, options, async () => {
+            const signal = options?.signal;
+            const session = await this.#session(key, signal);
+            await session.wait(signal);
+            return session.hold();
+        });
+    }
+    tryAcquire(key) {
+        return this.#turns.tryAcquire(key, async () => {
+            const session = await this.#session(key, undefined);
+            if (!(await session.try()))
+                return undefined;
+            return session.hold();
+        });
+    }
+    /** Asks the server on a short session, and never acquires the lock. */
+    async isHeld(key) {
+        const dialect = this.#dialect;
+        const session = new OwnedSession(await this.#options.connect(), dialect);
+        try {
+            const held = await dialect.isHeld(session.session, {
+                key,
+                name: dialect.lockName(key),
+            });
+            session.giveBack();
+            return held;
+        }
+        catch (error) {
+            session.destroy();
+            throw error;
+        }
+    }
+    /** Gets a session for `key`. A cancel never waits for `connect`: a session that comes later is given back at once. */
+    async #session(key, signal) {
+        const dialect = this.#dialect;
+        const connecting = this.#options.connect();
+        try {
+            return new KeySession(new OwnedSession(await untilAborted(connecting, signal), dialect), key, this.#options.heartbeatInterval, dialect);
+        }
+        catch (error) {
+            if (signal?.aborted && error === signal.reason) {
+                void connecting.then((late) => dialect.giveBack(late), () => { });
+            }
+            throw error;
+        }
+    }
+}
+/**
+ * A session from `connect` that the store owns until it gives it back or
+ * destroys it, once. Its `ended` signal aborts when the session emits `error`
+ * or `end`. Its listeners stay on a destroyed session, because a driver can
+ * emit `error` after the close.
+ */
+class OwnedSession {
+    session;
+    #dialect;
+    #ended = new AbortController();
+    #owned = new AbortController();
+    #listeners = {
+        error: (error) => this.#ended.abort(error),
+        end: () => this.#ended.abort(new Error(`The ${this.#dialect.server} session ended.`)),
+    };
+    constructor(session, dialect) {
+        this.session = session;
+        this.#dialect = dialect;
+        session.on('error', this.#listeners.error);
+        session.on('end', this.#listeners.end);
+    }
+    get ended() {
+        return this.#ended.signal;
+    }
+    /** The session holds nothing. */
+    giveBack() {
+        if (this.#owned.signal.aborted)
+            return;
+        this.#owned.abort();
+        this.#dialect.detach(this.session, this.#listeners);
+        this.#dialect.giveBack(this.session);
+    }
+    /** The lock state of the session is not known: the server releases each lock of a session that ends. */
+    destroy() {
+        if (this.#owned.signal.aborted)
+            return;
+        this.#owned.abort();
+        this.#dialect.destroy(this.session);
+    }
+}
+/** One session for one key: it waits for the lock or tries it, then holds it with a heartbeat. */
+class KeySession {
+    #owned;
+    #lock;
+    #heartbeatInterval;
+    #dialect;
+    #lease;
+    /** Aborts when the store stops holding: a release, or a lost session. */
+    #done = new AbortController();
+    constructor(owned, key, heartbeatInterval, dialect) {
+        this.#owned = owned;
+        this.#lock = { key, name: dialect.lockName(key) };
+        this.#heartbeatInterval = heartbeatInterval;
+        this.#dialect = dialect;
+        this.#lease = new LeaseController(key);
+    }
+    /** Waits in the server's lock queue. A cancel destroys the session, and the end of the session releases a late grant. */
+    async wait(signal) {
+        try {
+            await this.#dialect.wait(this.#owned.session, this.#lock, signal);
+        }
+        catch (error) {
+            this.#owned.destroy();
+            throw error;
+        }
+    }
+    async try() {
+        try {
+            if (await this.#dialect.try(this.#owned.session, this.#lock))
+                return true;
+        }
+        catch (error) {
+            this.#owned.destroy();
+            throw error;
+        }
+        this.#owned.giveBack();
+        return false;
+    }
+    /** Mints the token of a granted lock and starts the heartbeat. A failed mint releases the key. */
+    async hold() {
+        let token;
+        try {
+            token = new FencingToken(await this.#dialect.mint(this.#owned.session));
+        }
+        catch (error) {
+            await this.#release();
+            throw error;
+        }
+        const ended = this.#owned.ended;
+        ended.addEventListener('abort', () => this.#lose(ended.reason), {
+            once: true,
+            signal: this.#done.signal,
+        });
+        void this.#beat();
+        return {
+            token,
+            signal: this.#lease.signal,
+            [Symbol.asyncDispose]: () => this.#release(),
+        };
+    }
+    /**
+     * Asks the server each interval whether this session still holds the lock.
+     * A session that connected again by itself answers, but holds nothing. A
+     * failed, late or negative answer loses the lease.
+     */
+    async #beat() {
+        const interval = this.#heartbeatInterval;
+        const done = this.#done.signal;
+        try {
+            for (;;) {
+                await delay(interval, undefined, { signal: done });
+                const holds = await untilAborted(this.#dialect.holds(this.#owned.session, this.#lock), AbortSignal.any([done, AbortSignal.timeout(interval)]));
+                if (!holds) {
+                    throw new Error(`The session no longer holds the lock of ${JSON.stringify(this.#lock.key)}.`);
+                }
+            }
+        }
+        catch (cause) {
+            if (!done.aborted)
+                this.#lose(cause);
+        }
+    }
+    /** Another holder can have the key now. */
+    #lose(cause) {
+        if (this.#done.signal.aborted)
+            return;
+        this.#done.abort();
+        this.#lease.lose(cause);
+        this.#owned.destroy();
+    }
+    async #release() {
+        if (this.#done.signal.aborted)
+            return;
+        this.#done.abort();
+        try {
+            if (!(await this.#dialect.release(this.#owned.session, this.#lock))) {
+                throw new Error(`The session did not hold the lock of ${JSON.stringify(this.#lock.key)}.`);
+            }
+        }
+        catch (cause) {
+            // A plain give-back would give the next borrower a lock that this session may still hold.
+            this.#lease.lose(cause);
+            this.#owned.destroy();
+            return;
+        }
+        this.#lease.end();
+        this.#owned.giveBack();
+    }
+}
+//# sourceMappingURL=session-lock-store.js.map

package/dist/lock-stores/session/session-lock-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lock-store.js","sourceRoot":"","sources":["../../../src/lock-stores/session/session-lock-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAIjD,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AA8DlE;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAgB;IAGlB,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IAC9B,QAAQ,CAAmC;IAC3C,QAAQ,CAA8B;IAE/C,YACE,OAAyC,EACzC,OAAoC;QAEpC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE;YAClD,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;YAC/B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACjD,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3B,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE;YAC5C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACpD,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC7C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACzE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE;gBACjD,GAAG;gBACH,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;aAC5B,CAAC,CAAC;YACH,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,sHAAsH;IACtH,KAAK,CAAC,QAAQ,CACZ,GAAW,EACX,MAA+B;QAE/B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,OAAO,IAAI,UAAU,CACnB,IAAI,YAAY,CAAC,MAAM,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EACjE,GAAG,EACH,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAC/B,OAAO,CACR,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,MAAM,EAAE,OAAO,IAAI,KAAK,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC/C,KAAK,UAAU,CAAC,IAAI,CAClB,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAChC,GAAG,EAAE,GAAE,CAAC,CACT,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,YAAY;IACP,OAAO,CAAU;IACjB,QAAQ,CAA8B;IACtC,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAC/B,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAC/B,UAAU,GAAqB;QACtC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QAC1C,GAAG,EAAE,GAAG,EAAE,CACR,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,iBAAiB,CAAC,CACxD;KACJ,CAAC;IAEF,YAAY,OAAgB,EAAE,OAAoC;QAChE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,iCAAiC;IACjC,QAAQ;QACN,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QACvC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,wGAAwG;IACxG,OAAO;QACL,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QACvC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;CACF;AAED,kGAAkG;AAClG,MAAM,UAAU;IACL,MAAM,CAAwB;IAC9B,KAAK,CAAc;IACnB,kBAAkB,CAAS;IAC3B,QAAQ,CAA8B;IACtC,MAAM,CAAkB;IACjC,yEAAyE;IAChE,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IAEvC,YACE,KAA4B,EAC5B,GAAW,EACX,iBAAyB,EACzB,OAAoC;QAEpC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,yHAAyH;IACzH,KAAK,CAAC,IAAI,CAAC,MAA+B;QACxC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG;QACP,IAAI,CAAC;YACH,IAAI,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kGAAkG;IAClG,KAAK,CAAC,IAAI;QACR,IAAI,KAAmB,CAAC;QACxB,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAChC,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;YAC9D,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO;YACL,KAAK;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE;SAC7C,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAC/B,IAAI,CAAC;YACH,SAAS,CAAC;gBACR,MAAM,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnD,MAAM,KAAK,GAAG,MAAM,YAAY,CAC9B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EACpD,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CACvD,CAAC;gBACF,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,IAAI,KAAK,CACb,2CAA2C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAC7E,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,KAAc;QAClB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QACtC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QACtC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACpE,MAAM,IAAI,KAAK,CACb,wCAAwC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAC1E,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0FAA0F;YAC1F,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/lock-stores/sqlite/sqlite-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/sqlite/sqlite-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAIlE;;;;;;;;;;;GAWG;AACH,qBAAa,WAAY,SAAQ,aAAa;;IAC5C;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,SAAqB;IAGtC,OAAO,CACpB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,UAAU,CAAC;IAOP,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;cASvD,IAAI,CAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,eAAe,CAAC;cASX,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAQ3E,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGnD"}
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/sqlite/sqlite-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGlE;;;;;;;;;;;GAWG;AACH,qBAAa,WAAY,SAAQ,aAAa;;IAC5C;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,SAAqB;IAG5C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAInE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;cAIjD,IAAI,CAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,eAAe,CAAC;cASX,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAQ3E,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGnD"}

package/dist/lock-stores/sqlite/sqlite-store.js

@@ -1,6 +1,6 @@
 import { FileLock } from '@zukhruf/fs';
+import { InProcessTurns } from "../../shared/in-process-turns.js";
 import { FileLockStore } from "../file-system/file-lock-store.js";
-import { MemoryStore } from "../memory/memory-store.js";
 import { HolderRecord } from "./holder-record.js";
 /**
  * Holds the file lock of the key's database file. The kernel releases it when
@@ -22,21 +22,12 @@ export class SqliteStore extends FileLockStore {
      * holder folder `<path>.holder` is shorter.
      */
     longestSuffix = '-journal'.length;
-    #inProcess = new MemoryStore();
-    async acquire(key, options = {}) {
-        await using turn = new AsyncDisposableStack();
-        // Joining the in-process queue is synchronous, so the order is the order of the calls.
-        turn.use(await this.#inProcess.acquire(key, options));
-        return withTurn(await super.acquire(key, options), turn);
+    #turns = new InProcessTurns();
+    acquire(key, options) {
+        return this.#turns.acquire(key, options, () => super.acquire(key, options));
     }
-    async tryAcquire(key) {
-        await using turn = new AsyncDisposableStack();
-        const inProcess = await this.#inProcess.tryAcquire(key);
-        if (!inProcess)
-            return undefined;
-        turn.use(inProcess);
-        const lease = await super.tryAcquire(key);
-        return lease && withTurn(lease, turn);
+    tryAcquire(key) {
+        return this.#turns.tryAcquire(key, () => super.tryAcquire(key));
     }
     async lock(path, signal) {
         await using held = new AsyncDisposableStack();
@@ -58,14 +49,4 @@ export class SqliteStore extends FileLockStore {
         return new HolderRecord(path).isPresent();
     }
 }
-/** Releases the database lock first, then lets the next caller in this process try. */
-function withTurn(handle, turn) {
-    turn.use(handle);
-    const release = turn.move();
-    return {
-        token: handle.token,
-        signal: handle.signal,
-        [Symbol.asyncDispose]: () => release.disposeAsync(),
-    };
-}
 //# sourceMappingURL=sqlite-store.js.map

package/dist/lock-stores/sqlite/sqlite-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-store.js","sourceRoot":"","sources":["../../../src/lock-stores/sqlite/sqlite-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sqlite-store.js","sourceRoot":"","sources":["../../../src/lock-stores/sqlite/sqlite-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,WAAY,SAAQ,aAAa;IAC5C;;;;;OAKG;IACgB,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC;IAC5C,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IAE9B,OAAO,CAAC,GAAW,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9E,CAAC;IAEQ,UAAU,CAAC,GAAW;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IAES,KAAK,CAAC,IAAI,CAClB,IAAY,EACZ,MAA+B;QAE/B,YAAY,IAAI,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QACzE,oFAAoF;QACpF,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,IAAY;QAClC,YAAY,IAAI,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO,SAAS,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAES,QAAQ,CAAC,IAAY;QAC7B,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;IAC5C,CAAC;CACF"}

package/dist/lock-stores/sqlserver/index.d.ts

@@ -0,0 +1,2 @@
+export { SqlServerStore, type SqlServerSession, type SqlServerStoreOptions, } from './sqlserver-store.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/lock-stores/sqlserver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/sqlserver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC"}

package/dist/lock-stores/sqlserver/index.js

@@ -0,0 +1,2 @@
+export { SqlServerStore, } from "./sqlserver-store.js";
+//# sourceMappingURL=index.js.map

package/dist/lock-stores/sqlserver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lock-stores/sqlserver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAGf,MAAM,sBAAsB,CAAC"}

package/dist/lock-stores/sqlserver/sqlserver-store.d.ts

@@ -0,0 +1,40 @@
+import { SessionLockStore } from '../session/session-lock-store.ts';
+/**
+ * One connection to SQL Server: only the methods that the store calls. No
+ * driver object fits it as it is; a `Connection` of tedious fits it through a
+ * small wrapper. The session must never connect again by itself.
+ */
+export interface SqlServerSession {
+    /** Runs one batch. Each parameter is an `nvarchar`. Resolves to the rows of the batch. */
+    query(text: string, parameters: Record<string, string>): Promise<Record<string, unknown>[]>;
+    on(event: 'error', listener: (error: Error) => void): unknown;
+    on(event: 'end', listener: () => void): unknown;
+    /** Ends the connection. The server then releases each lock of the session. */
+    close(): void;
+}
+export interface SqlServerStoreOptions {
+    /** Gives a new session. The store owns each session that it gets, and closes it. */
+    connect(): Promise<SqlServerSession>;
+    /** The name of an existing sequence for the fencing tokens. The store runs no DDL. */
+    sequence: string;
+    /**
+     * Milliseconds between two heartbeats of a holder, and the time limit of
+     * each heartbeat: the longest time that a holder can work after its session
+     * ended, before its signal aborts.
+     */
+    heartbeatInterval: number;
+}
+/**
+ * Holds a session-owned application lock of SQL Server (`sp_getapplock`) for
+ * each key, on a session of its own. The server releases the lock when the
+ * session ends, so a holder that stops never leaves a key locked. Every
+ * process on every machine that reaches one database shares the locks.
+ *
+ * Callers in this process first line up in a queue in memory, so only the
+ * first one gets a session: one session per key per process, however many
+ * callers wait, and first-come order within the process.
+ */
+export declare class SqlServerStore extends SessionLockStore<SqlServerSession> {
+    constructor(options: SqlServerStoreOptions);
+}
+//# sourceMappingURL=sqlserver-store.d.ts.map

package/dist/lock-stores/sqlserver/sqlserver-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlserver-store.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/sqlserver/sqlserver-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,gBAAgB,EACjB,MAAM,kCAAkC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0FAA0F;IAC1F,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACtC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;IAC9D,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IAChD,8EAA8E;IAC9E,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,oFAAoF;IACpF,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAoCD;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,gBAAgB,CAAC,gBAAgB,CAAC;gBACxD,OAAO,EAAE,qBAAqB;CAG3C"}

package/dist/lock-stores/sqlserver/sqlserver-store.js

@@ -0,0 +1,104 @@
+import { untilAborted } from '@zukhruf/async';
+import { keyDigest } from "../../shared/key-digest.js";
+import { SessionLockStore, } from "../session/session-lock-store.js";
+/** `0` is the principal ID of `public`, the default `@DbPrincipal` of `sp_getapplock`. */
+const heldQuery = `SELECT CASE WHEN EXISTS (
+  SELECT 1 FROM sys.dm_tran_locks
+  WHERE resource_type = N'APPLICATION'
+    AND resource_database_id = DB_ID()
+    AND request_status = N'GRANT'
+    AND LEFT(resource_description, 36) = N'0:[' + @resource + N']'
+) THEN 1 ELSE 0 END AS held`;
+/** `APPLOCK_MODE` reads the lock mode of this session, and never takes the lock. */
+const holdsQuery = `SELECT CASE WHEN APPLOCK_MODE('public', @resource, 'Session') <> 'NoLock' THEN 1 ELSE 0 END AS held`;
+const waitQuery = `DECLARE @result int;
+EXEC @result = sp_getapplock @Resource = @resource, @LockMode = 'Exclusive', @LockOwner = 'Session', @LockTimeout = -1;
+SELECT @result AS result;`;
+const tryQuery = `DECLARE @result int;
+EXEC @result = sp_getapplock @Resource = @resource, @LockMode = 'Exclusive', @LockOwner = 'Session', @LockTimeout = 0;
+SELECT @result AS result;`;
+const releaseQuery = `DECLARE @result int;
+EXEC @result = sp_releaseapplock @Resource = @resource, @LockOwner = 'Session';
+SELECT @result AS result;`;
+/** `NEXT VALUE FOR` takes no parameter, so the batch finds the sequence by name, as `regclass` does, and quotes it. */
+const tokenQuery = `DECLARE @id int = OBJECT_ID(@sequence, 'SO');
+IF @id IS NULL
+BEGIN
+  DECLARE @message nvarchar(2048) = N'The sequence ' + @sequence + N' does not exist, or the role has no permission on it.';
+  THROW 50000, @message, 1;
+END;
+DECLARE @next nvarchar(400) = N'SELECT CAST(NEXT VALUE FOR ' + QUOTENAME(OBJECT_SCHEMA_NAME(@id)) + N'.' + QUOTENAME(OBJECT_NAME(@id)) + N' AS nvarchar(20)) AS token';
+EXEC sp_executesql @next;`;
+/**
+ * Holds a session-owned application lock of SQL Server (`sp_getapplock`) for
+ * each key, on a session of its own. The server releases the lock when the
+ * session ends, so a holder that stops never leaves a key locked. Every
+ * process on every machine that reaches one database shares the locks.
+ *
+ * Callers in this process first line up in a queue in memory, so only the
+ * first one gets a session: one session per key per process, however many
+ * callers wait, and first-come order within the process.
+ */
+export class SqlServerStore extends SessionLockStore {
+    constructor(options) {
+        super(options, sqlServerDialect(options));
+    }
+}
+/**
+ * The application lock resource of `key`: the first 16 bytes of the key
+ * digest, as 32 hex characters. Any key fits the 255 characters of
+ * `@Resource`, and `sys.dm_tran_locks` shows only the first 32 characters of
+ * a resource, so the holder check sees the whole name.
+ */
+function resourceName(key) {
+    return keyDigest(key).subarray(0, 16).toString('hex');
+}
+function sqlServerDialect(options) {
+    return {
+        server: 'SQL Server',
+        lockName: resourceName,
+        wait: async (session, { key, name }, signal) => {
+            const [row] = await untilAborted(session.query(waitQuery, { resource: name }), signal);
+            if (typeof row?.result !== 'number' || row.result < 0) {
+                throw new Error(`sp_getapplock for ${JSON.stringify(key)} returned ${String(row?.result)}.`);
+            }
+        },
+        try: async (session, { key, name }) => {
+            const [row] = await session.query(tryQuery, { resource: name });
+            if (row?.result === 0)
+                return true;
+            if (row?.result !== -1) {
+                throw new Error(`sp_getapplock for ${JSON.stringify(key)} returned ${String(row?.result)}.`);
+            }
+            return false;
+        },
+        mint: async (session) => {
+            const [row] = await session.query(tokenQuery, {
+                sequence: options.sequence,
+            });
+            if (typeof row?.token !== 'string') {
+                throw new Error(`NEXT VALUE FOR sequence ${JSON.stringify(options.sequence)} gave no number.`);
+            }
+            return BigInt(row.token);
+        },
+        holds: async (session, { name }) => {
+            const [row] = await session.query(holdsQuery, { resource: name });
+            return row?.held === 1;
+        },
+        // Releases the lock on the server before the close: the server sees a closed connection a little later.
+        release: async (session, { name }) => {
+            const [row] = await session.query(releaseQuery, { resource: name });
+            return row?.result === 0;
+        },
+        /** Reads `sys.dm_tran_locks`. `APPLOCK_TEST` would take the lock for an instant. */
+        isHeld: async (session, { name }) => {
+            const [row] = await session.query(heldQuery, { resource: name });
+            return row?.held === 1;
+        },
+        // A closed session keeps its listeners, because a driver can emit `error` after the close.
+        detach: () => { },
+        giveBack: (session) => session.close(),
+        destroy: (session) => session.close(),
+    };
+}
+//# sourceMappingURL=sqlserver-store.js.map

package/dist/lock-stores/sqlserver/sqlserver-store.js.map

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

package/dist/shared/in-process-turns.d.ts

@@ -0,0 +1,17 @@
+import type { LockHandle } from '../mutex/lease.ts';
+import type { AcquireOptions } from '../mutex/lock-store.ts';
+/**
+ * The line of the callers of each key in this process. A lock store puts each
+ * call in the line first, so only the first caller of a key takes the
+ * store's resource of the key (a file, a session or a claim): one resource
+ * per key per process, however many callers wait, and first-come order within
+ * the process.
+ */
+export declare class InProcessTurns {
+    #private;
+    /** Waits for the turn of `key`, then calls `take`. A cancel of `options.signal` also ends the wait for the turn. */
+    acquire(key: string, options: AcquireOptions | undefined, take: () => Promise<LockHandle>): Promise<LockHandle>;
+    /** Calls `take` only when no caller in this process has the turn of `key`. */
+    tryAcquire(key: string, take: () => Promise<LockHandle | undefined>): Promise<LockHandle | undefined>;
+}
+//# sourceMappingURL=in-process-turns.d.ts.map

package/dist/shared/in-process-turns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-turns.d.ts","sourceRoot":"","sources":["../../src/shared/in-process-turns.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;;;;GAMG;AACH,qBAAa,cAAc;;IAGzB,oHAAoH;IAC9G,OAAO,CACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAC9B,OAAO,CAAC,UAAU,CAAC;IAOtB,8EAA8E;IACxE,UAAU,CACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,GAC1C,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;CAQnC"}

package/dist/shared/in-process-turns.js

@@ -0,0 +1,39 @@
+import { MemoryStore } from "../lock-stores/memory/memory-store.js";
+/**
+ * The line of the callers of each key in this process. A lock store puts each
+ * call in the line first, so only the first caller of a key takes the
+ * store's resource of the key (a file, a session or a claim): one resource
+ * per key per process, however many callers wait, and first-come order within
+ * the process.
+ */
+export class InProcessTurns {
+    #lines = new MemoryStore();
+    /** Waits for the turn of `key`, then calls `take`. A cancel of `options.signal` also ends the wait for the turn. */
+    async acquire(key, options, take) {
+        await using turn = new AsyncDisposableStack();
+        // Joining the line is synchronous, so the order is the order of the calls.
+        turn.use(await this.#lines.acquire(key, options));
+        return withTurn(await take(), turn);
+    }
+    /** Calls `take` only when no caller in this process has the turn of `key`. */
+    async tryAcquire(key, take) {
+        await using turn = new AsyncDisposableStack();
+        const inProcess = await this.#lines.tryAcquire(key);
+        if (!inProcess)
+            return undefined;
+        turn.use(inProcess);
+        const handle = await take();
+        return handle && withTurn(handle, turn);
+    }
+}
+/** Releases the key in the store first, then lets the next caller in this process continue. */
+function withTurn(handle, turn) {
+    turn.use(handle);
+    const release = turn.move();
+    return {
+        token: handle.token,
+        signal: handle.signal,
+        [Symbol.asyncDispose]: () => release.disposeAsync(),
+    };
+}
+//# sourceMappingURL=in-process-turns.js.map

package/dist/shared/in-process-turns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-turns.js","sourceRoot":"","sources":["../../src/shared/in-process-turns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAIpE;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IAChB,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;IAEpC,oHAAoH;IACpH,KAAK,CAAC,OAAO,CACX,GAAW,EACX,OAAmC,EACnC,IAA+B;QAE/B,YAAY,IAAI,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC9C,2EAA2E;QAC3E,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;QAClD,OAAO,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,UAAU,CACd,GAAW,EACX,IAA2C;QAE3C,YAAY,IAAI,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QAC5B,OAAO,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,+FAA+F;AAC/F,SAAS,QAAQ,CAAC,MAAkB,EAAE,IAA0B;IAC9D,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE;KACpD,CAAC;AACJ,CAAC"}

package/dist/shared/key-digest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The SHA-256 digest of the UTF-16 code units of `key`. The code units, not
+ * UTF-8, so that keys that differ only in a lone surrogate get different
+ * digests. Each lock store encodes the digest in the form that its server
+ * takes.
+ */
+export declare function keyDigest(key: string): Buffer;
+//# sourceMappingURL=key-digest.d.ts.map

package/dist/shared/key-digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-digest.d.ts","sourceRoot":"","sources":["../../src/shared/key-digest.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/shared/key-digest.js

@@ -0,0 +1,11 @@
+import { createHash } from 'node:crypto';
+/**
+ * The SHA-256 digest of the UTF-16 code units of `key`. The code units, not
+ * UTF-8, so that keys that differ only in a lone surrogate get different
+ * digests. Each lock store encodes the digest in the form that its server
+ * takes.
+ */
+export function keyDigest(key) {
+    return createHash('sha256').update(Buffer.from(key, 'utf16le')).digest();
+}
+//# sourceMappingURL=key-digest.js.map

package/dist/shared/key-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-digest.js","sourceRoot":"","sources":["../../src/shared/key-digest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAC3E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zukhruf/mutex",
-  "version": "0.3.40",
+  "version": "0.3.42",
   "description": "A mutex with interchangeable lock stores, from one object to every process on a host, with fencing tokens on every lease.",
   "license": "MIT",
   "repository": {
@@ -28,6 +28,7 @@
       "default": "./dist/index.js"
     },
     "./remote": null,
+    "./session": null,
     "./*": {
       "@zukhruf/source": "./src/lock-stores/*/index.ts",
       "types": "./dist/lock-stores/*/index.d.ts",
@@ -45,16 +46,28 @@
     "access": "public"
   },
   "dependencies": {
-    "@zukhruf/async": "^0.3.40",
-    "@zukhruf/election": "^0.3.40",
-    "@zukhruf/fencing": "^0.3.40",
-    "@zukhruf/fs": "^0.3.40",
-    "@zukhruf/lease": "^0.3.40"
+    "@zukhruf/async": "^0.3.42",
+    "@zukhruf/election": "^0.3.42",
+    "@zukhruf/fencing": "^0.3.42",
+    "@zukhruf/fs": "^0.3.42",
+    "@zukhruf/lease": "^0.3.42"
+  },
+  "peerDependencies": {
+    "@zukhruf/docker": "^0.3.42"
+  },
+  "peerDependenciesMeta": {
+    "@zukhruf/docker": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/pg": "^8.23.1",
-    "@zukhruf/testing": "^0.3.40",
+    "@zukhruf/docker": "^0.3.42",
+    "@zukhruf/testing": "^0.3.42",
     "hono": "^4.13.13",
-    "pg": "^8.23.1"
+    "mariadb": "^3.5.4",
+    "mysql2": "^3.24.5",
+    "pg": "^8.23.1",
+    "tedious": "^20.3.3"
   }
 }