@zukhruf/mutex 0.0.0-stage → 0.1.0

package/dist/lock-stores/remote/remote-lock-client.js

@@ -0,0 +1,172 @@
+import { randomUUID } from 'node:crypto';
+import { FencingToken } from "../../fencing/fencing-token.js";
+import { LockLostError } from "../../mutex/lock-lost-error.js";
+import { untilAborted } from "../../shared/until-aborted.js";
+import { CoordinatorUnavailableError } from "./coordinator-unavailable-error.js";
+/**
+ * Asks a coordinator for keys over a connection. When the connection drops, it
+ * asks its connector for another, reasserts the keys it holds and re-requests
+ * the ones it waits for. A held key whose reassertion is refused is lost.
+ */
+export class RemoteLockClient {
+    #connector;
+    #pending = new Map();
+    #held = new Map();
+    #lost = new Set();
+    #connection;
+    #current;
+    #closed = false;
+    constructor(connector) {
+        this.#connector = connector;
+    }
+    async acquire(key, { signal } = {}) {
+        signal?.throwIfAborted();
+        const id = randomUUID();
+        try {
+            const token = await untilAborted(this.#request(id, key, 'acquire'), signal);
+            // The coordinator answers 'busy' only to a try; an acquire waits for its grant.
+            if (!token) {
+                throw new Error(`The lock coordinator answered 'busy' to an acquire of key "${key}".`);
+            }
+            return this.#hold(id, key, token);
+        }
+        catch (error) {
+            if (signal?.aborted && this.#current) {
+                void this.#send(this.#current, { op: 'cancel', id });
+            }
+            throw error;
+        }
+        finally {
+            this.#pending.delete(id);
+            this.#updateRef();
+        }
+    }
+    async tryAcquire(key) {
+        const id = randomUUID();
+        try {
+            const token = await this.#request(id, key, 'try');
+            return token && this.#hold(id, key, token);
+        }
+        finally {
+            this.#pending.delete(id);
+            this.#updateRef();
+        }
+    }
+    async #request(id, key, attempt) {
+        if (this.#closed)
+            throw new Error('This lock client is closed.');
+        const answer = Promise.withResolvers();
+        this.#pending.set(id, { key, attempt, answer });
+        this.#updateRef();
+        this.#connection ??= this.#open();
+        const connection = await this.#connection;
+        if (!connection)
+            throw new CoordinatorUnavailableError(key);
+        void this.#send(connection, { op: attempt, id, key });
+        return answer.promise;
+    }
+    #hold(id, key, token) {
+        this.#held.set(id, { key, token });
+        return {
+            token,
+            [Symbol.asyncDispose]: async () => {
+                // Forget the key first, so a reconnect cannot reassert a released lease.
+                const wasHeld = this.#held.delete(id);
+                if (this.#lost.delete(id))
+                    throw new LockLostError(key);
+                if (wasHeld && this.#current) {
+                    await this.#send(this.#current, { op: 'release', id });
+                }
+            },
+        };
+    }
+    async #open() {
+        const connection = await this.#connector.connect();
+        if (!connection) {
+            this.#connection = undefined;
+            return undefined;
+        }
+        this.#current = connection;
+        connection.listen({
+            message: (response) => this.#receive(connection, response),
+            close: () => this.#reconnect(connection),
+        });
+        this.#updateRef();
+        return connection;
+    }
+    #receive(connection, response) {
+        const pending = this.#pending.get(response.id);
+        switch (response.op) {
+            case 'granted':
+                if (pending) {
+                    pending.answer.resolve(new FencingToken(BigInt(response.token)));
+                }
+                else {
+                    // Nobody waits for this grant any more (the request was cancelled), so give the key back.
+                    void this.#send(connection, { op: 'release', id: response.id });
+                }
+                return;
+            case 'busy':
+                pending?.answer.resolve(undefined);
+                return;
+            case 'rejected':
+                if (this.#held.delete(response.id))
+                    this.#lost.add(response.id);
+                return;
+        }
+    }
+    async #send(connection, request) {
+        try {
+            await connection.send(request);
+        }
+        catch {
+            this.#reconnect(connection);
+        }
+    }
+    /** Disconnects for good; the coordinator releases whatever this client still holds. */
+    close() {
+        this.#closed = true;
+        const current = this.#current;
+        this.#current = undefined;
+        current?.close();
+    }
+    #reconnect(lost) {
+        if (this.#closed || this.#current !== lost)
+            return;
+        this.#current = undefined;
+        lost.close();
+        this.#connection = this.#open();
+        void this.#connection.then((connection) => this.#resume(connection));
+    }
+    async #resume(connection) {
+        if (!connection) {
+            // Held keys stay exclusive: no coordinator is left to grant them to anyone else.
+            for (const { key, answer } of this.#pending.values()) {
+                answer.reject(new CoordinatorUnavailableError(key));
+            }
+            return;
+        }
+        for (const [id, { key, token }] of this.#held) {
+            await this.#send(connection, {
+                op: 'reassert',
+                id,
+                key,
+                token: token.toString(),
+            });
+        }
+        for (const [id, { key, attempt, answer }] of this.#pending) {
+            // A try is one attempt; the coordinator that would have answered it is gone.
+            if (attempt === 'try')
+                answer.resolve(undefined);
+            else
+                await this.#send(connection, { op: 'acquire', id, key });
+        }
+    }
+    #updateRef() {
+        if (this.#pending.size > 0)
+            this.#current?.ref();
+        else
+            this.#current?.unref();
+    }
+}
+//# sourceMappingURL=remote-lock-client.js.map

package/dist/lock-stores/remote/remote-lock-client.js.map

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

package/dist/lock-stores/socket/electing-connector.d.ts

@@ -0,0 +1,21 @@
+import type { LeaderElection } from '../../leader-election/leader-election.ts';
+import type { Leadership } from '../../leader-election/leadership.ts';
+import type { ClientConnection, Connector } from '../remote/connector.ts';
+export interface ElectingConnectorOptions {
+    socketPath: string;
+    election: LeaderElection;
+    pollInterval: number;
+    /** Starts serving for a term this process just won. */
+    serve(leadership: Leadership): Promise<void>;
+    connected(): void;
+}
+/**
+ * Reaches the leader's socket, and when nobody serves it, campaigns to become
+ * the leader. Never gives up: a lost leader is always replaced by a candidate.
+ */
+export declare class ElectingConnector implements Connector {
+    #private;
+    constructor(options: ElectingConnectorOptions);
+    connect(): Promise<ClientConnection>;
+}
+//# sourceMappingURL=electing-connector.d.ts.map

package/dist/lock-stores/socket/electing-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"electing-connector.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/socket/electing-connector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAQ1E,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,SAAS,IAAI,IAAI,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,SAAS;;gBAGrC,OAAO,EAAE,wBAAwB;IAIvC,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAiB3C"}

package/dist/lock-stores/socket/electing-connector.js

@@ -0,0 +1,45 @@
+import { connect } from 'node:net';
+import { setTimeout as delay } from 'node:timers/promises';
+import { isLockResponse, } from "../remote/protocol.js";
+import { SocketConnection } from "./socket-connection.js";
+/**
+ * Reaches the leader's socket, and when nobody serves it, campaigns to become
+ * the leader. Never gives up: a lost leader is always replaced by a candidate.
+ */
+export class ElectingConnector {
+    #options;
+    constructor(options) {
+        this.#options = options;
+    }
+    async connect() {
+        const { socketPath, election, pollInterval, serve, connected } = this.#options;
+        for (;;) {
+            const socket = await reach(socketPath);
+            if (socket) {
+                connected();
+                return new SocketConnection(socket, isLockResponse);
+            }
+            const leadership = await election.campaign({ timeout: pollInterval });
+            if (leadership)
+                await serve(leadership);
+            else
+                await delay(pollInterval);
+        }
+    }
+}
+/** Resolves `undefined` when nothing listens yet (no file, or a dead leader's file). */
+function reach(socketPath) {
+    return new Promise((resolve) => {
+        const socket = connect(socketPath);
+        const fail = () => {
+            socket.destroy();
+            resolve(undefined);
+        };
+        socket.once('error', fail);
+        socket.once('connect', () => {
+            socket.off('error', fail);
+            resolve(socket);
+        });
+    });
+}
+//# sourceMappingURL=electing-connector.js.map

package/dist/lock-stores/socket/electing-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"electing-connector.js","sourceRoot":"","sources":["../../../src/lock-stores/socket/electing-connector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,OAAO,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAK3D,OAAO,EAGL,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAW1D;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACnB,QAAQ,CAA2B;IAE5C,YAAY,OAAiC;QAC3C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,GAC5D,IAAI,CAAC,QAAQ,CAAC;QAChB,SAAS,CAAC;YACR,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;YACvC,IAAI,MAAM,EAAE,CAAC;gBACX,SAAS,EAAE,CAAC;gBACZ,OAAO,IAAI,gBAAgB,CACzB,MAAM,EACN,cAAc,CACf,CAAC;YACJ,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;YACtE,IAAI,UAAU;gBAAE,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;;gBACnC,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;CACF;AAED,wFAAwF;AACxF,SAAS,KAAK,CAAC,UAAkB;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC1B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lock-stores/socket/lock-server.d.ts

@@ -0,0 +1,23 @@
+import type { Leadership } from '../../leader-election/leadership.ts';
+export interface LockServerOptions {
+    /** Milliseconds the new term grants nothing, so holders from the last term can reassert. */
+    graceWindow: number;
+}
+/**
+ * Serves a `LockCoordinator` on a Unix socket for one leadership term. Tokens
+ * carry the term's epoch, so they outrank every token of earlier terms.
+ */
+export declare class LockServer {
+    #private;
+    private constructor();
+    static start(socketPath: string, leadership: Leadership, { graceWindow }: LockServerOptions): Promise<LockServer>;
+    /**
+     * Hands leadership over. Dropping every connection tells followers to elect
+     * a successor and reassert their keys during its grace window; `close` alone
+     * would wait for followers that never disconnect on their own. The term ends
+     * only after the socket is gone: in the other order, this close could remove
+     * a successor's socket file.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=lock-server.d.ts.map

package/dist/lock-stores/socket/lock-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-server.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/socket/lock-server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAUtE,MAAM,WAAW,iBAAiB;IAChC,4FAA4F;IAC5F,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,UAAU;;IAKrB,OAAO;WAUM,KAAK,CAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,UAAU,EACtB,EAAE,WAAW,EAAE,EAAE,iBAAiB,GACjC,OAAO,CAAC,UAAU,CAAC;IAiCtB;;;;;;OAMG;IACG,KAAK;CAQZ"}

package/dist/lock-stores/socket/lock-server.js

@@ -0,0 +1,67 @@
+import { unlink } from 'node:fs/promises';
+import { createServer } from 'node:net';
+import { EpochTokenSource } from "../../fencing/epoch-token-source.js";
+import { isErrno } from "../../shared/fs/errno.js";
+import { LockCoordinator } from "../remote/lock-coordinator.js";
+import { isLockRequest, } from "../remote/protocol.js";
+import { SocketConnection } from "./socket-connection.js";
+/**
+ * Serves a `LockCoordinator` on a Unix socket for one leadership term. Tokens
+ * carry the term's epoch, so they outrank every token of earlier terms.
+ */
+export class LockServer {
+    #server;
+    #connections;
+    #leadership;
+    constructor(server, connections, leadership) {
+        this.#server = server;
+        this.#connections = connections;
+        this.#leadership = leadership;
+    }
+    static async start(socketPath, leadership, { graceWindow }) {
+        // Only the leader gets here, so removing a dead leader's socket file cannot race another server.
+        // Windows removes a named pipe when its process stops, so there is no file to remove.
+        if (process.platform !== 'win32') {
+            await unlink(socketPath).catch((error) => {
+                if (!isErrno(error, 'ENOENT'))
+                    throw error;
+            });
+        }
+        const coordinator = new LockCoordinator({
+            tokens: new EpochTokenSource(leadership.epoch),
+            graceWindow,
+        });
+        const connections = new Set();
+        // Serving others never keeps the leader alive: when its own work ends, it exits and another process takes over.
+        const server = createServer((socket) => {
+            socket.unref();
+            connections.add(socket);
+            socket.once('close', () => connections.delete(socket));
+            coordinator.serve(new SocketConnection(socket, isLockRequest));
+        });
+        await new Promise((resolve, reject) => {
+            server.once('error', reject);
+            server.listen(socketPath, () => {
+                server.off('error', reject);
+                resolve();
+            });
+        });
+        server.unref();
+        return new LockServer(server, connections, leadership);
+    }
+    /**
+     * Hands leadership over. Dropping every connection tells followers to elect
+     * a successor and reassert their keys during its grace window; `close` alone
+     * would wait for followers that never disconnect on their own. The term ends
+     * only after the socket is gone: in the other order, this close could remove
+     * a successor's socket file.
+     */
+    async close() {
+        const closed = new Promise((resolve) => this.#server.close(() => resolve()));
+        for (const socket of this.#connections)
+            socket.destroy();
+        await closed;
+        await this.#leadership.resign();
+    }
+}
+//# sourceMappingURL=lock-server.js.map

package/dist/lock-stores/socket/lock-server.js.map

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

package/dist/lock-stores/socket/socket-connection.d.ts

@@ -0,0 +1,18 @@
+import type { Socket } from 'node:net';
+import type { Connection, ConnectionHandlers } from '../remote/connection.ts';
+/**
+ * Newline-delimited JSON over a stream socket. A stream has no message
+ * boundaries (writes arrive merged and split), and JSON escapes newlines inside
+ * strings, so one line is always one message. `isIncoming` checks each message
+ * from the peer; a line that is not one closes the connection.
+ */
+export declare class SocketConnection<Outgoing, Incoming> implements Connection<Outgoing, Incoming> {
+    #private;
+    constructor(socket: Socket, isIncoming: (message: unknown) => message is Incoming);
+    send(message: Outgoing): Promise<void>;
+    listen({ message, close }: ConnectionHandlers<Incoming>): void;
+    ref(): void;
+    unref(): void;
+    close(): void;
+}
+//# sourceMappingURL=socket-connection.d.ts.map

package/dist/lock-stores/socket/socket-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-connection.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/socket/socket-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE9E;;;;;GAKG;AACH,qBAAa,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAE,YAAW,UAAU,CACrE,QAAQ,EACR,QAAQ,CACT;;gBAKG,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,IAAI,QAAQ;IAQvD,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,kBAAkB,CAAC,QAAQ,CAAC;IAgBvD,GAAG;IAIH,KAAK;IAIL,KAAK;CAGN"}

package/dist/lock-stores/socket/socket-connection.js

@@ -0,0 +1,54 @@
+import { createInterface } from 'node:readline';
+/**
+ * Newline-delimited JSON over a stream socket. A stream has no message
+ * boundaries (writes arrive merged and split), and JSON escapes newlines inside
+ * strings, so one line is always one message. `isIncoming` checks each message
+ * from the peer; a line that is not one closes the connection.
+ */
+export class SocketConnection {
+    #socket;
+    #isIncoming;
+    constructor(socket, isIncoming) {
+        this.#socket = socket;
+        this.#isIncoming = isIncoming;
+        // Every error is followed by `close`, which is where the peer's loss is handled.
+        socket.on('error', () => { });
+    }
+    send(message) {
+        return new Promise((resolve, reject) => {
+            if (!this.#socket.writable) {
+                reject(new Error('The socket is closed.'));
+                return;
+            }
+            this.#socket.write(`${JSON.stringify(message)}\n`, (error) => error ? reject(error) : resolve());
+        });
+    }
+    listen({ message, close }) {
+        createInterface({ input: this.#socket, crlfDelay: Infinity })
+            .on('line', (line) => {
+            try {
+                const parsed = JSON.parse(line);
+                if (this.#isIncoming(parsed))
+                    message(parsed);
+                else
+                    this.close();
+            }
+            catch {
+                this.close();
+            }
+        })
+            // readline re-emits socket errors (e.g. EPIPE when the peer died); `close` reports the loss.
+            .on('error', () => { });
+        this.#socket.once('close', close);
+    }
+    ref() {
+        this.#socket.ref();
+    }
+    unref() {
+        this.#socket.unref();
+    }
+    close() {
+        this.#socket.destroy();
+    }
+}
+//# sourceMappingURL=socket-connection.js.map

package/dist/lock-stores/socket/socket-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-connection.js","sourceRoot":"","sources":["../../../src/lock-stores/socket/socket-connection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIhD;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAIlB,OAAO,CAAS;IAChB,WAAW,CAA4C;IAEhE,YACE,MAAc,EACd,UAAqD;QAErD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,iFAAiF;QACjF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,OAAiB;QACpB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;gBAC3C,OAAO;YACT,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAC3D,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAClC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAgC;QACrD,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;aAC1D,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACnB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;oBAAE,OAAO,CAAC,MAAM,CAAC,CAAC;;oBACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACpB,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;QACH,CAAC,CAAC;YACF,6FAA6F;aAC5F,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,GAAG;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACzB,CAAC;CACF"}

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

@@ -0,0 +1,35 @@
+import { EventEmitter } from 'node:events';
+import type { Lease } from '../../mutex/lease.ts';
+import type { AcquireOptions, LockStore } from '../../mutex/lock-store.ts';
+export type SocketRole = 'leader' | 'follower';
+export interface SocketStoreOptions {
+    /** Milliseconds between connection and campaign attempts. */
+    pollInterval?: number;
+    /**
+     * Milliseconds a new leader grants nothing, so holders from the previous
+     * term can reassert first. Must exceed how long a holder takes to reconnect.
+     */
+    graceWindow?: number;
+}
+/**
+ * Host-wide locks granted by one elected process over a Unix socket in
+ * `directory`. Every process using the store is a candidate: the first one to
+ * need a lock with no leader serving wins the election and serves the rest
+ * until it exits. When the leader dies, the kernel closes every connection,
+ * a survivor takes over, and holders reassert their keys during the new
+ * leader's grace window. Tokens carry the term's epoch, so a holder that
+ * missed the window (for example while frozen) is fenced off by any resource
+ * that checks tokens, and its lease ends with `LockLostError`.
+ */
+export declare class SocketStore extends EventEmitter<{
+    role: [SocketRole];
+}> implements LockStore, AsyncDisposable {
+    #private;
+    constructor(directory: string, { pollInterval, graceWindow }?: SocketStoreOptions);
+    /** Whether this process serves the locks, or `undefined` before it first needed one. */
+    get role(): SocketRole | undefined;
+    acquire(key: string, options?: AcquireOptions): Promise<Lease>;
+    tryAcquire(key: string): Promise<Lease | undefined>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=socket-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"socket-store.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/socket/socket-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAQ3E,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,qBAAa,WACX,SAAQ,YAAY,CAAC;IAAE,IAAI,EAAE,CAAC,UAAU,CAAC,CAAA;CAAE,CAC3C,YAAW,SAAS,EAAE,eAAe;;gBAOnC,SAAS,EAAE,MAAM,EACjB,EAAE,YAAiB,EAAE,WAAiB,EAAE,GAAE,kBAAuB;IAuBnE,wFAAwF;IACxF,IAAI,IAAI,IAAI,UAAU,GAAG,SAAS,CAEjC;IAED,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAI9D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAI7C,CAAC,MAAM,CAAC,YAAY,CAAC;CAU5B"}

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

@@ -0,0 +1,84 @@
+import { createHash } from 'node:crypto';
+import { EventEmitter } from 'node:events';
+import { join, resolve } from 'node:path';
+import { LeaderElection } from "../../leader-election/leader-election.js";
+import { RemoteLockClient } from "../remote/remote-lock-client.js";
+import { ElectingConnector } from "./electing-connector.js";
+import { LockServer } from "./lock-server.js";
+/** macOS allows 104 bytes including the terminating NUL; Linux allows 108. */
+const SOCKET_PATH_LIMIT = 103;
+/**
+ * Host-wide locks granted by one elected process over a Unix socket in
+ * `directory`. Every process using the store is a candidate: the first one to
+ * need a lock with no leader serving wins the election and serves the rest
+ * until it exits. When the leader dies, the kernel closes every connection,
+ * a survivor takes over, and holders reassert their keys during the new
+ * leader's grace window. Tokens carry the term's epoch, so a holder that
+ * missed the window (for example while frozen) is fenced off by any resource
+ * that checks tokens, and its lease ends with `LockLostError`.
+ */
+export class SocketStore extends EventEmitter {
+    #client;
+    #server;
+    #role;
+    constructor(directory, { pollInterval = 10, graceWindow = 500 } = {}) {
+        super();
+        const socketPath = socketPathFor(directory);
+        this.#client = new RemoteLockClient(new ElectingConnector({
+            socketPath,
+            election: new LeaderElection(directory, { pollInterval }),
+            pollInterval,
+            serve: async (leadership) => {
+                this.#server = await LockServer.start(socketPath, leadership, {
+                    // The first term of a directory has no predecessor to wait for.
+                    graceWindow: leadership.epoch > 1n ? graceWindow : 0,
+                });
+                this.#setRole('leader');
+            },
+            connected: () => {
+                if (!this.#server)
+                    this.#setRole('follower');
+            },
+        }));
+    }
+    /** Whether this process serves the locks, or `undefined` before it first needed one. */
+    get role() {
+        return this.#role;
+    }
+    acquire(key, options) {
+        return this.#client.acquire(key, options);
+    }
+    tryAcquire(key) {
+        return this.#client.tryAcquire(key);
+    }
+    async [Symbol.asyncDispose]() {
+        this.#client.close();
+        await this.#server?.close();
+    }
+    #setRole(role) {
+        if (this.#role === role)
+            return;
+        this.#role = role;
+        this.emit('role', role);
+    }
+}
+/**
+ * A Unix socket file in the directory on macOS and Linux. On Windows, a named
+ * pipe: pipe names are global, so the name comes from the directory, and
+ * Windows paths ignore case, so the path is lowercased first.
+ */
+function socketPathFor(directory) {
+    if (process.platform === 'win32') {
+        const id = createHash('sha256')
+            .update(resolve(directory).toLowerCase())
+            .digest('hex')
+            .slice(0, 32);
+        return `\\\\.\\pipe\\mutex-${id}`;
+    }
+    const socketPath = join(directory, 'lock.sock');
+    if (Buffer.byteLength(socketPath) > SOCKET_PATH_LIMIT) {
+        throw new RangeError(`The socket path ${socketPath} exceeds ${SOCKET_PATH_LIMIT} bytes; choose a shorter directory.`);
+    }
+    return socketPath;
+}
+//# sourceMappingURL=socket-store.js.map

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

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

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

@@ -0,0 +1,21 @@
+import type { Lease } from '../../mutex/lease.ts';
+import type { AcquireOptions } from '../../mutex/lock-store.ts';
+import { FileLockStore } from '../file-system/file-lock-store.ts';
+/**
+ * Holds an exclusive SQLite transaction on the key's database file. SQLite
+ * locks through the kernel, which releases them when the holder dies, so a
+ * crash never leaves a key locked. Keep the default rollback journal: in WAL
+ * mode an exclusive transaction no longer blocks readers.
+ *
+ * Callers in this process first line up in a queue in memory, so only the
+ * first one opens a database connection: one open file per key per process,
+ * however many callers wait, and first-come order within the process.
+ */
+export declare class SqliteStore extends FileLockStore {
+    #private;
+    acquire(key: string, options?: AcquireOptions): Promise<Lease>;
+    tryAcquire(key: string): Promise<Lease | undefined>;
+    protected lock(path: string, signal: AbortSignal | undefined): Promise<AsyncDisposable>;
+    protected tryLock(path: string): Promise<AsyncDisposable | undefined>;
+}
+//# sourceMappingURL=sqlite-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/sqlite/sqlite-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGlE;;;;;;;;;GASG;AACH,qBAAa,WAAY,SAAQ,aAAa;;IAG7B,OAAO,CACpB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,KAAK,CAAC;IAWF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;cAclD,IAAI,CAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,eAAe,CAAC;cAaX,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;CAW5E"}