@zukhruf/mutex 0.0.0-stage → 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-store.js","sourceRoot":"","sources":["../../../src/lock-stores/ipc/ipc-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,oFAAoF;AACpF,MAAM,uBAAuB;IAC3B,UAAU,GAAG,KAAK,CAAC;IAEnB,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAC5D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,wBAAwB,EAAE,CAAC;IACxC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,QAAQ;IACV,OAAO,CAAmB;IAEnC;QACE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,sGAAsG,CACvG,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAC,IAAI,uBAAuB,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/lock-stores/ipc/process-channel-connection.d.ts

@@ -0,0 +1,18 @@
+import type { Connection, ConnectionHandlers } from '../remote/connection.ts';
+import { type LockRequest, type LockResponse } from '../remote/protocol.ts';
+/**
+ * The child's end of the IPC channel to its parent. Node counts `message` and
+ * `disconnect` listeners to decide whether the channel keeps the process alive,
+ * so this adapter listens only while referenced. That leaves the application's
+ * own listeners in charge of the process lifetime. Messages that arrive while
+ * not listening are buffered by Node and delivered on the next `ref`.
+ */
+export declare class ProcessChannelConnection implements Connection<LockRequest, LockResponse> {
+    #private;
+    send(request: LockRequest): Promise<void>;
+    listen(handlers: ConnectionHandlers<LockResponse>): void;
+    ref(): void;
+    unref(): void;
+    close(): void;
+}
+//# sourceMappingURL=process-channel-connection.d.ts.map

package/dist/lock-stores/ipc/process-channel-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-channel-connection.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/ipc/process-channel-connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE9E,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,YAAY,EAElB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,UAAU,CACzD,WAAW,EACX,YAAY,CACb;;IAcC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,CAAC,YAAY,CAAC;IAIjD,GAAG;IAOH,KAAK;IAOL,KAAK;CAGN"}

package/dist/lock-stores/ipc/process-channel-connection.js

@@ -0,0 +1,52 @@
+import { unwrap, wrap } from "../remote/envelope.js";
+import { isLockResponse, } from "../remote/protocol.js";
+/**
+ * The child's end of the IPC channel to its parent. Node counts `message` and
+ * `disconnect` listeners to decide whether the channel keeps the process alive,
+ * so this adapter listens only while referenced. That leaves the application's
+ * own listeners in charge of the process lifetime. Messages that arrive while
+ * not listening are buffered by Node and delivered on the next `ref`.
+ */
+export class ProcessChannelConnection {
+    #handlers;
+    #listening = false;
+    #onMessage = (envelope) => {
+        const response = unwrap(envelope);
+        if (isLockResponse(response))
+            this.#handlers?.message(response);
+    };
+    #onDisconnect = () => {
+        this.unref();
+        this.#handlers?.close();
+    };
+    send(request) {
+        return new Promise((resolve, reject) => {
+            if (!process.send || !process.connected) {
+                reject(new Error('The IPC channel to the parent is closed.'));
+                return;
+            }
+            process.send(wrap(request), undefined, {}, (error) => error ? reject(error) : resolve());
+        });
+    }
+    listen(handlers) {
+        this.#handlers = handlers;
+    }
+    ref() {
+        if (this.#listening)
+            return;
+        this.#listening = true;
+        process.on('message', this.#onMessage);
+        process.on('disconnect', this.#onDisconnect);
+    }
+    unref() {
+        if (!this.#listening)
+            return;
+        this.#listening = false;
+        process.off('message', this.#onMessage);
+        process.off('disconnect', this.#onDisconnect);
+    }
+    close() {
+        this.unref();
+    }
+}
+//# sourceMappingURL=process-channel-connection.js.map

package/dist/lock-stores/ipc/process-channel-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-channel-connection.js","sourceRoot":"","sources":["../../../src/lock-stores/ipc/process-channel-connection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAGL,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,OAAO,wBAAwB;IAInC,SAAS,CAA+C;IACxD,UAAU,GAAG,KAAK,CAAC;IAEV,UAAU,GAAG,CAAC,QAAiB,EAAE,EAAE;QAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,cAAc,CAAC,QAAQ,CAAC;YAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClE,CAAC,CAAC;IAEO,aAAa,GAAG,GAAG,EAAE;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC,CAAC;IAEF,IAAI,CAAC,OAAoB;QACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBACxC,MAAM,CAAC,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC,CAAC;gBAC9D,OAAO;YACT,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CACnD,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAClC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,QAA0C;QAC/C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,GAAG;QACD,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACvC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO;QAC7B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;CACF"}

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

@@ -0,0 +1,14 @@
+import type { TokenSource } from '../../fencing/token-source.ts';
+import { type Lease } from '../../mutex/lease.ts';
+import type { AcquireOptions, LockStore } from '../../mutex/lock-store.ts';
+export interface MemoryStoreOptions {
+    tokens?: TokenSource;
+}
+/** Per-key FIFO promise chain; locks are shared only through this instance. */
+export declare class MemoryStore implements LockStore {
+    #private;
+    constructor({ tokens }?: MemoryStoreOptions);
+    acquire(key: string, { signal }?: AcquireOptions): Promise<Lease>;
+    tryAcquire(key: string): Promise<Lease | undefined>;
+}
+//# sourceMappingURL=memory-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/memory/memory-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,KAAK,KAAK,EAAY,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG3E,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,+EAA+E;AAC/E,qBAAa,WAAY,YAAW,SAAS;;gBAI/B,EAAE,MAAiC,EAAE,GAAE,kBAAuB;IAIpE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,GAAE,cAAmB,GAAG,OAAO,CAAC,KAAK,CAAC;IAwBrE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;CAI1D"}

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

@@ -0,0 +1,41 @@
+import { CounterTokenSource } from "../../fencing/counter-token-source.js";
+import { leaseFor } from "../../mutex/lease.js";
+import { untilAborted } from "../../shared/until-aborted.js";
+/** Per-key FIFO promise chain; locks are shared only through this instance. */
+export class MemoryStore {
+    #tails = new Map();
+    #tokens;
+    constructor({ tokens = new CounterTokenSource() } = {}) {
+        this.#tokens = tokens;
+    }
+    async acquire(key, { signal } = {}) {
+        signal?.throwIfAborted();
+        const previous = this.#tails.get(key);
+        const released = Promise.withResolvers();
+        const tail = previous
+            ? previous.then(() => released.promise)
+            : released.promise;
+        this.#tails.set(key, tail);
+        const release = async () => {
+            released.resolve();
+            if (this.#tails.get(key) === tail)
+                this.#tails.delete(key);
+        };
+        const turn = Promise.resolve(previous);
+        try {
+            await untilAborted(turn, signal);
+        }
+        catch (error) {
+            // A waiter cannot leave the middle of the chain, so its place passes the key on when its turn comes.
+            void turn.then(release);
+            throw error;
+        }
+        return leaseFor(key, { [Symbol.asyncDispose]: release }, this.#tokens);
+    }
+    async tryAcquire(key) {
+        if (this.#tails.has(key))
+            return undefined;
+        return this.acquire(key);
+    }
+}
+//# sourceMappingURL=memory-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.js","sourceRoot":"","sources":["../../../src/lock-stores/memory/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,OAAO,EAAc,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAM7D,+EAA+E;AAC/E,MAAM,OAAO,WAAW;IACb,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC1C,OAAO,CAAc;IAE9B,YAAY,EAAE,MAAM,GAAG,IAAI,kBAAkB,EAAE,KAAyB,EAAE;QACxE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,EAAE,MAAM,KAAqB,EAAE;QACxD,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAQ,CAAC;QAC/C,MAAM,IAAI,GAAG,QAAQ;YACnB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;YACvC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;YACzB,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,CAAC,CAAC;QAEF,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qGAAqG;YACrG,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC;QACD,OAAO,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;CACF"}

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

@@ -0,0 +1,17 @@
+export interface ConnectionHandlers<Incoming> {
+    message(message: Incoming): void;
+    /** Called once, when the peer is gone. */
+    close(): void;
+}
+/** A message channel to one peer. Adapters wrap IPC channels and sockets. */
+export interface Connection<Outgoing, Incoming> {
+    /** Rejects when the message cannot be delivered because the peer is gone. */
+    send(message: Outgoing): Promise<void>;
+    listen(handlers: ConnectionHandlers<Incoming>): void;
+    /** Keeps the process alive while its owner waits for a message. */
+    ref(): void;
+    /** Lets the process exit; messages and closure are still reported while it runs. */
+    unref(): void;
+    close(): void;
+}
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/remote/connection.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB,CAAC,QAAQ;IAC1C,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,0CAA0C;IAC1C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU,CAAC,QAAQ,EAAE,QAAQ;IAC5C,6EAA6E;IAC7E,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACrD,mEAAmE;IACnE,GAAG,IAAI,IAAI,CAAC;IACZ,oFAAoF;IACpF,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,IAAI,CAAC;CACf"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/lock-stores/remote/connection.ts"],"names":[],"mappings":""}

package/dist/lock-stores/remote/connector.d.ts

@@ -0,0 +1,12 @@
+import type { Connection } from './connection.ts';
+import type { LockRequest, LockResponse } from './protocol.ts';
+export type ClientConnection = Connection<LockRequest, LockResponse>;
+/** Decides how a client reaches its coordinator, and whether it can again after losing it. */
+export interface Connector {
+    /**
+     * Resolves to `undefined` when the coordinator is gone for good and nothing
+     * can replace it, so no other holder can ever be granted a key either.
+     */
+    connect(): Promise<ClientConnection | undefined>;
+}
+//# sourceMappingURL=connector.d.ts.map

package/dist/lock-stores/remote/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/remote/connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/D,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AAErE,8FAA8F;AAC9F,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;CAClD"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../src/lock-stores/remote/connector.ts"],"names":[],"mappings":""}

package/dist/lock-stores/remote/coordinator-unavailable-error.d.ts

@@ -0,0 +1,6 @@
+/** No coordinator is left that could ever grant this key. */
+export declare class CoordinatorUnavailableError extends Error {
+    readonly key: string;
+    constructor(key: string);
+}
+//# sourceMappingURL=coordinator-unavailable-error.d.ts.map

package/dist/lock-stores/remote/coordinator-unavailable-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-unavailable-error.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/remote/coordinator-unavailable-error.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM;CAKxB"}

package/dist/lock-stores/remote/coordinator-unavailable-error.js

@@ -0,0 +1,10 @@
+/** No coordinator is left that could ever grant this key. */
+export class CoordinatorUnavailableError extends Error {
+    key;
+    constructor(key) {
+        super(`No lock coordinator is reachable to grant ${JSON.stringify(key)}.`);
+        this.name = 'CoordinatorUnavailableError';
+        this.key = key;
+    }
+}
+//# sourceMappingURL=coordinator-unavailable-error.js.map

package/dist/lock-stores/remote/coordinator-unavailable-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-unavailable-error.js","sourceRoot":"","sources":["../../../src/lock-stores/remote/coordinator-unavailable-error.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAC3C,GAAG,CAAS;IAErB,YAAY,GAAW;QACrB,KAAK,CAAC,6CAA6C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF"}

package/dist/lock-stores/remote/envelope.d.ts

@@ -0,0 +1,7 @@
+declare const TAG = "@lock";
+/** Lock messages travel inside a tagged envelope so they share the IPC channel with the application's own messages. */
+export declare function wrap<T>(message: T): Record<typeof TAG, T>;
+/** The message inside a lock envelope, unchecked; `undefined` for the application's own messages. */
+export declare function unwrap(envelope: unknown): unknown;
+export {};
+//# sourceMappingURL=envelope.d.ts.map

package/dist/lock-stores/remote/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/remote/envelope.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,GAAG,UAAU,CAAC;AAEpB,uHAAuH;AACvH,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,CAEzD;AAED,qGAAqG;AACrG,wBAAgB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAEjD"}

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

@@ -0,0 +1,11 @@
+import { isRecord } from "../../shared/is-record.js";
+const TAG = '@lock';
+/** Lock messages travel inside a tagged envelope so they share the IPC channel with the application's own messages. */
+export function wrap(message) {
+    return { [TAG]: message };
+}
+/** The message inside a lock envelope, unchecked; `undefined` for the application's own messages. */
+export function unwrap(envelope) {
+    return isRecord(envelope) && TAG in envelope ? envelope[TAG] : undefined;
+}
+//# sourceMappingURL=envelope.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../src/lock-stores/remote/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,MAAM,GAAG,GAAG,OAAO,CAAC;AAEpB,uHAAuH;AACvH,MAAM,UAAU,IAAI,CAAI,OAAU;IAChC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,MAAM,CAAC,QAAiB;IACtC,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC"}

package/dist/lock-stores/remote/lock-coordinator.d.ts

@@ -0,0 +1,34 @@
+import { FencingToken } from '../../fencing/fencing-token.ts';
+import type { TokenSource } from '../../fencing/token-source.ts';
+import type { Lease } from '../../mutex/lease.ts';
+import type { AcquireOptions, LockStore } from '../../mutex/lock-store.ts';
+import type { Connection } from './connection.ts';
+import type { LockRequest, LockResponse } from './protocol.ts';
+export interface LockCoordinatorOptions {
+    tokens: TokenSource;
+    /**
+     * Milliseconds after start during which nothing is granted, so holders from a
+     * previous coordinator can reassert their keys first. Zero for a coordinator
+     * that never replaces another.
+     */
+    graceWindow?: number;
+}
+/**
+ * Grants keys in FIFO order to its own callers and to peers it serves over
+ * connections. A peer that disconnects releases everything it held or waited for.
+ */
+export declare class LockCoordinator implements LockStore {
+    #private;
+    constructor({ tokens, graceWindow }: LockCoordinatorOptions);
+    acquire(key: string, { signal }?: AcquireOptions): Promise<Lease>;
+    /** Nothing is granted during the grace window, so a key counts as busy then. */
+    tryAcquire(key: string): Promise<Lease | undefined>;
+    serve(connection: Connection<LockResponse, LockRequest>): void;
+    /**
+     * Re-registers a holder from before a failover. Accepted only during the
+     * grace window; for two claims on one key the newer token wins and the older
+     * claim's `lose` is called. Resolves `undefined` when the claim is refused.
+     */
+    reassert(key: string, token: FencingToken, lose: () => void): Promise<Lease> | undefined;
+}
+//# sourceMappingURL=lock-coordinator.d.ts.map

package/dist/lock-stores/remote/lock-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-coordinator.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/remote/lock-coordinator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAQD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,SAAS;;gBAMnC,EAAE,MAAM,EAAE,WAAe,EAAE,EAAE,sBAAsB;IAWzD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,GAAE,cAAmB,GAAG,OAAO,CAAC,KAAK,CAAC;IAK3E,gFAAgF;IAC1E,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAKzD,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,IAAI;IAI9D;;;;OAIG;IACH,QAAQ,CACN,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,IAAI,GACf,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS;CAY9B"}

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

@@ -0,0 +1,150 @@
+import { setTimeout as delay } from 'node:timers/promises';
+import { FencingToken } from "../../fencing/fencing-token.js";
+import { untilAborted } from "../../shared/until-aborted.js";
+import { MemoryStore } from "../memory/memory-store.js";
+/**
+ * Grants keys in FIFO order to its own callers and to peers it serves over
+ * connections. A peer that disconnects releases everything it held or waited for.
+ */
+export class LockCoordinator {
+    #store;
+    #graceOver;
+    #reassertions = new Map();
+    #inGrace;
+    constructor({ tokens, graceWindow = 0 }) {
+        this.#store = new MemoryStore({ tokens });
+        this.#inGrace = graceWindow > 0;
+        this.#graceOver = this.#inGrace
+            ? delay(graceWindow, undefined, { ref: false }).then(() => {
+                this.#inGrace = false;
+                this.#reassertions.clear();
+            })
+            : Promise.resolve();
+    }
+    async acquire(key, { signal } = {}) {
+        await untilAborted(this.#graceOver, signal);
+        return this.#store.acquire(key, { signal });
+    }
+    /** Nothing is granted during the grace window, so a key counts as busy then. */
+    async tryAcquire(key) {
+        if (this.#inGrace)
+            return undefined;
+        return this.#store.tryAcquire(key);
+    }
+    serve(connection) {
+        new Session(this, connection);
+    }
+    /**
+     * Re-registers a holder from before a failover. Accepted only during the
+     * grace window; for two claims on one key the newer token wins and the older
+     * claim's `lose` is called. Resolves `undefined` when the claim is refused.
+     */
+    reassert(key, token, lose) {
+        if (!this.#inGrace)
+            return undefined;
+        const existing = this.#reassertions.get(key);
+        if (existing && !token.isNewerThan(existing.token))
+            return undefined;
+        existing?.lose();
+        // Nothing is granted during grace, so the first claim gets the key at once
+        // and a newer claim takes over that same lease.
+        const lease = existing?.lease ?? this.#store.acquire(key);
+        this.#reassertions.set(key, { token, lease, lose });
+        return lease;
+    }
+}
+class Session {
+    #coordinator;
+    #connection;
+    #leases = new Map();
+    #requested = new Set();
+    #lost = new Set();
+    #closed = false;
+    constructor(coordinator, connection) {
+        this.#coordinator = coordinator;
+        this.#connection = connection;
+        connection.listen({
+            message: (request) => {
+                this.#handle(request).catch(() => connection.close());
+            },
+            close: () => {
+                void this.#close();
+            },
+        });
+    }
+    async #handle(request) {
+        switch (request.op) {
+            case 'acquire': {
+                // A reconnecting client may resend a request; granting it twice would orphan one lease.
+                if (this.#requested.has(request.id))
+                    return;
+                this.#requested.add(request.id);
+                const lease = await this.#coordinator.acquire(request.key);
+                return this.#grant(request.id, lease);
+            }
+            case 'try': {
+                if (this.#requested.has(request.id))
+                    return;
+                this.#requested.add(request.id);
+                const lease = await this.#coordinator.tryAcquire(request.key);
+                if (!lease) {
+                    this.#requested.delete(request.id);
+                    return this.#reply({ op: 'busy', id: request.id });
+                }
+                return this.#grant(request.id, lease);
+            }
+            case 'cancel': {
+                // A request still in line is released by #grant when its turn comes.
+                this.#requested.delete(request.id);
+                return this.#releaseLease(request.id);
+            }
+            case 'release': {
+                this.#requested.delete(request.id);
+                return this.#releaseLease(request.id);
+            }
+            case 'reassert': {
+                const claim = this.#coordinator.reassert(request.key, new FencingToken(BigInt(request.token)), () => this.#lose(request.id));
+                if (!claim)
+                    return this.#reply({ op: 'rejected', id: request.id });
+                const lease = await claim;
+                if (this.#lost.has(request.id))
+                    return;
+                if (this.#closed)
+                    return lease[Symbol.asyncDispose]();
+                this.#leases.set(request.id, lease);
+                return;
+            }
+        }
+    }
+    /** A request cancelled or a peer gone while the grant was on its way releases the key at once. */
+    #grant(id, lease) {
+        if (this.#closed || !this.#requested.has(id)) {
+            return lease[Symbol.asyncDispose]();
+        }
+        this.#leases.set(id, lease);
+        return this.#reply({ op: 'granted', id, token: lease.token.toString() });
+    }
+    #releaseLease(id) {
+        const lease = this.#leases.get(id);
+        this.#leases.delete(id);
+        return lease?.[Symbol.asyncDispose]();
+    }
+    /** A newer claim took this session's reasserted lease over, so it must not release it. */
+    #lose(id) {
+        this.#lost.add(id);
+        this.#leases.delete(id);
+        void this.#reply({ op: 'rejected', id });
+    }
+    async #reply(response) {
+        // A failed send means the peer is gone; `close` then releases its leases.
+        await this.#connection.send(response).catch(() => { });
+    }
+    async #close() {
+        this.#closed = true;
+        const leases = [...this.#leases.values()];
+        this.#leases.clear();
+        for (const lease of leases)
+            await lease[Symbol.asyncDispose]();
+    }
+}
+//# sourceMappingURL=lock-coordinator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock-coordinator.js","sourceRoot":"","sources":["../../../src/lock-stores/remote/lock-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAI9D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAoBxD;;;GAGG;AACH,MAAM,OAAO,eAAe;IACjB,MAAM,CAAc;IACpB,UAAU,CAAgB;IAC1B,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;IACxD,QAAQ,CAAU;IAElB,YAAY,EAAE,MAAM,EAAE,WAAW,GAAG,CAAC,EAA0B;QAC7D,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,WAAW,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,QAAQ;YAC7B,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;gBACtD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACtB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;YAC7B,CAAC,CAAC;YACJ,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,EAAE,MAAM,KAAqB,EAAE;QACxD,MAAM,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,UAAiD;QACrD,IAAI,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,QAAQ,CACN,GAAW,EACX,KAAmB,EACnB,IAAgB;QAEhB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAErE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACjB,2EAA2E;QAC3E,gDAAgD;QAChD,MAAM,KAAK,GAAG,QAAQ,EAAE,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,MAAM,OAAO;IACF,YAAY,CAAkB;IAC9B,WAAW,CAAwC;IACnD,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnC,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,OAAO,GAAG,KAAK,CAAC;IAEhB,YACE,WAA4B,EAC5B,UAAiD;QAEjD,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,UAAU,CAAC,MAAM,CAAC;YAChB,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;gBACnB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;YACxD,CAAC;YACD,KAAK,EAAE,GAAG,EAAE;gBACV,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACrB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAoB;QAChC,QAAQ,OAAO,CAAC,EAAE,EAAE,CAAC;YACnB,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,wFAAwF;gBACxF,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBAAE,OAAO;gBAC5C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC3D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACxC,CAAC;YACD,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBAAE,OAAO;gBAC5C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC9D,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;oBACnC,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrD,CAAC;gBACD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACxC,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,qEAAqE;gBACrE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACnC,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACxC,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACnC,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACxC,CAAC;YACD,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CACtC,OAAO,CAAC,GAAG,EACX,IAAI,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EACvC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAC7B,CAAC;gBACF,IAAI,CAAC,KAAK;oBAAE,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC;gBAC1B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBAAE,OAAO;gBACvC,IAAI,IAAI,CAAC,OAAO;oBAAE,OAAO,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;gBACtD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;gBACpC,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC;IAED,kGAAkG;IAClG,MAAM,CAAC,EAAU,EAAE,KAAY;QAC7B,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,aAAa,CAAC,EAAU;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,OAAO,KAAK,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;IACxC,CAAC;IAED,0FAA0F;IAC1F,KAAK,CAAC,EAAU;QACd,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAsB;QACjC,0EAA0E;QAC1E,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,MAAM,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;IACjE,CAAC;CACF"}

package/dist/lock-stores/remote/protocol.d.ts

@@ -0,0 +1,36 @@
+/** Tokens travel as decimal strings because JSON has no bigint. */
+export type LockRequest = {
+    op: 'acquire';
+    id: string;
+    key: string;
+} | {
+    op: 'try';
+    id: string;
+    key: string;
+} | {
+    op: 'cancel';
+    id: string;
+} | {
+    op: 'release';
+    id: string;
+} | {
+    op: 'reassert';
+    id: string;
+    key: string;
+    token: string;
+};
+export type LockResponse = {
+    op: 'granted';
+    id: string;
+    token: string;
+} | {
+    op: 'busy';
+    id: string;
+} | {
+    op: 'rejected';
+    id: string;
+};
+/** Messages arrive from another thread or process, so their shape is checked before use. */
+export declare function isLockRequest(message: unknown): message is LockRequest;
+export declare function isLockResponse(message: unknown): message is LockResponse;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/lock-stores/remote/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/remote/protocol.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAKnC,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,WAAW,CActE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,YAAY,CAWxE"}

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

@@ -0,0 +1,33 @@
+import { isRecord } from "../../shared/is-record.js";
+const isToken = (value) => typeof value === 'string' && /^-?\d+$/.test(value);
+/** Messages arrive from another thread or process, so their shape is checked before use. */
+export function isLockRequest(message) {
+    if (!isRecord(message) || typeof message.id !== 'string')
+        return false;
+    switch (message.op) {
+        case 'acquire':
+        case 'try':
+            return typeof message.key === 'string';
+        case 'cancel':
+        case 'release':
+            return true;
+        case 'reassert':
+            return typeof message.key === 'string' && isToken(message.token);
+        default:
+            return false;
+    }
+}
+export function isLockResponse(message) {
+    if (!isRecord(message) || typeof message.id !== 'string')
+        return false;
+    switch (message.op) {
+        case 'granted':
+            return isToken(message.token);
+        case 'busy':
+        case 'rejected':
+            return true;
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=protocol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/lock-stores/remote/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAerD,MAAM,OAAO,GAAG,CAAC,KAAc,EAAW,EAAE,CAC1C,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAErD,4FAA4F;AAC5F,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvE,QAAQ,OAAO,CAAC,EAAE,EAAE,CAAC;QACnB,KAAK,SAAS,CAAC;QACf,KAAK,KAAK;YACR,OAAO,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC;QACzC,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC;QACd,KAAK,UAAU;YACb,OAAO,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnE;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvE,QAAQ,OAAO,CAAC,EAAE,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC;QACZ,KAAK,UAAU;YACb,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/lock-stores/remote/remote-lock-client.d.ts

@@ -0,0 +1,17 @@
+import type { Lease } from '../../mutex/lease.ts';
+import type { AcquireOptions, LockStore } from '../../mutex/lock-store.ts';
+import type { Connector } from './connector.ts';
+/**
+ * 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 declare class RemoteLockClient implements LockStore {
+    #private;
+    constructor(connector: Connector);
+    acquire(key: string, { signal }?: AcquireOptions): Promise<Lease>;
+    tryAcquire(key: string): Promise<Lease | undefined>;
+    /** Disconnects for good; the coordinator releases whatever this client still holds. */
+    close(): void;
+}
+//# sourceMappingURL=remote-lock-client.d.ts.map

package/dist/lock-stores/remote/remote-lock-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-lock-client.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/remote/remote-lock-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAgBlE;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,SAAS;;gBASpC,SAAS,EAAE,SAAS;IAI1B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,GAAE,cAAmB,GAAG,OAAO,CAAC,KAAK,CAAC;IA0BrE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAqFzD,uFAAuF;IACvF,KAAK;CA0CN"}