@zukhruf/mutex 0.3.40 → 0.3.41

package/README.md

@@ -38,22 +38,30 @@ The full program is in the recipe [Stop two requests from selling the last item]
 
 First find who writes to the resource. Then select the lock store with that [reach](./docs/concepts/reach.md). Each family of lock stores has its own import path. The root `@zukhruf/mutex` gives only `Mutex` and the acquire modes ([ADR 0020](./docs/adr/0020-each-store-family-has-its-own-import-path.md)).
 
-| Lock store                                                       | Import                       | Reach                                   | Order                                   | A holder stops                                | Needs                                        |
-| ---------------------------------------------------------------- | ---------------------------- | --------------------------------------- | --------------------------------------- | --------------------------------------------- | -------------------------------------------- |
-| [MemoryStore](./docs/stores/memory-store.md)                     | `@zukhruf/mutex/memory`      | One object                              | First come, first served                | The locks stop with the process               | Nothing                                      |
-| [ThreadStore](./docs/stores/thread-store.md)                     | `@zukhruf/mutex/thread`      | One process (threads)                   | First come, first served                | Released when the worker exits                | `adopt(worker)`                              |
-| [IpcStore](./docs/stores/ipc-store.md)                           | `@zukhruf/mutex/ipc`         | Parent and its children                 | First come, first served                | Released in approximately 2 ms                | `fork()` and `adopt(child)`                  |
-| [TicketQueueFileStore](./docs/stores/ticket-queue-file-store.md) | `@zukhruf/mutex/file-system` | One host                                | First come, first served                | Released after a waiter finds that it stopped | A shared directory                           |
-| [LockFileStore](./docs/stores/lock-file-store.md)                | `@zukhruf/mutex/file-system` | One host                                | No order                                | Released after a waiter finds that it stopped | A shared directory                           |
-| [SqliteStore](./docs/stores/sqlite-store.md)                     | `@zukhruf/mutex/sqlite`      | One host                                | First come, first served in one process | Released by the kernel                        | A shared directory                           |
-| [SocketStore](./docs/stores/socket-store.md)                     | `@zukhruf/mutex/socket`      | One host                                | First come, first served                | Released in approximately 2 ms                | A shared directory                           |
-| [PostgresStore](./docs/stores/postgres-store.md)                 | `@zukhruf/mutex/postgres`    | Every machine that reaches the database | Postgres' lock queue                    | Released when its session ends                | A Postgres database and a `connect` function |
+| Lock store                                                       | Import                       | Reach                                        | Order                                   | A holder stops                                | Needs                                                       |
+| ---------------------------------------------------------------- | ---------------------------- | -------------------------------------------- | --------------------------------------- | --------------------------------------------- | ----------------------------------------------------------- |
+| [MemoryStore](./docs/stores/memory-store.md)                     | `@zukhruf/mutex/memory`      | One object                                   | First come, first served                | The locks stop with the process               | Nothing                                                     |
+| [ThreadStore](./docs/stores/thread-store.md)                     | `@zukhruf/mutex/thread`      | One process (threads)                        | First come, first served                | Released when the worker exits                | `adopt(worker)`                                             |
+| [IpcStore](./docs/stores/ipc-store.md)                           | `@zukhruf/mutex/ipc`         | Parent and its children                      | First come, first served                | Released in approximately 2 ms                | `fork()` and `adopt(child)`                                 |
+| [TicketQueueFileStore](./docs/stores/ticket-queue-file-store.md) | `@zukhruf/mutex/file-system` | One host                                     | First come, first served                | Released after a waiter finds that it stopped | A shared directory                                          |
+| [LockFileStore](./docs/stores/lock-file-store.md)                | `@zukhruf/mutex/file-system` | One host                                     | No order                                | Released after a waiter finds that it stopped | A shared directory                                          |
+| [SqliteStore](./docs/stores/sqlite-store.md)                     | `@zukhruf/mutex/sqlite`      | One host                                     | First come, first served in one process | Released by the kernel                        | A shared directory                                          |
+| [SocketStore](./docs/stores/socket-store.md)                     | `@zukhruf/mutex/socket`      | One host                                     | First come, first served                | Released in approximately 2 ms                | A shared directory                                          |
+| [PostgresStore](./docs/stores/postgres-store.md)                 | `@zukhruf/mutex/postgres`    | Every machine that reaches the database      | Postgres' lock queue                    | Released when its session ends                | A Postgres database and a `connect` function                |
+| [SqlServerStore](./docs/stores/sqlserver-store.md)               | `@zukhruf/mutex/sqlserver`   | Every machine that reaches the database      | SQL Server's lock queue                 | Released when its session ends                | A SQL Server database and a `connect` function              |
+| [MysqlStore](./docs/stores/mysql-store.md)                       | `@zukhruf/mutex/mysql`       | Every machine that reaches the database      | MySQL's lock queue                      | Released when its session ends                | A MySQL database and a `connect` function                   |
+| [MariadbStore](./docs/stores/mariadb-store.md)                   | `@zukhruf/mutex/mariadb`     | Every machine that reaches the database      | MariaDB's lock queue                    | Released when its session ends                | A MariaDB database and a `connect` function                 |
+| [DockerEngineStore](./docs/stores/docker-engine-store.md)        | `@zukhruf/mutex/docker`      | Every machine that reaches the Docker engine | No order between processes              | Released when its attach ends                 | A Docker engine, an image with `cat`, and `@zukhruf/docker` |
 
 If you are not sure:
 
 - **One process:** use `MemoryStore`.
 - **Several processes on one host:** use `SqliteStore`.
 - **Many machines that already use Postgres:** use `PostgresStore`.
+- **Many machines that already use SQL Server:** use `SqlServerStore`.
+- **Many machines that already use MySQL:** use `MysqlStore`.
+- **Many machines that already use MariaDB:** use `MariadbStore`.
+- **Many machines that already use one Docker engine, with no database:** use `DockerEngineStore`.
 
 ## Acquire modes
 

package/dist/lock-stores/docker/docker-engine-store.d.ts

@@ -0,0 +1,37 @@
+import { type Docker } from '@zukhruf/docker';
+import type { LockHandle } from '../../mutex/lease.ts';
+import type { AcquireOptions, LockStore } from '../../mutex/lock-store.ts';
+export interface DockerEngineStoreOptions {
+    /** The client of the engine. The caller owns it; its disposal ends each attach, so each held key is lost. */
+    docker: Docker;
+    /** The image of each claim. It must be on the engine and have `cat` on its `PATH`; the store never pulls it. */
+    image: string;
+    /** The first part of each name and the value of the label `zukhruf.mutex.namespace`. Stores with one namespace on one engine share their locks. */
+    namespace: 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 claim
+     * ended, before its signal aborts. It is also the time that a waiter gives
+     * a `created` claim before it removes it, and the time between two looks of
+     * a waiter at the claim.
+     */
+    heartbeatInterval: number;
+}
+/**
+ * Holds a key as a named container on one Docker engine: the claim. The claim
+ * runs `cat` on the standard input of the attach of its holder, so it ends
+ * and the engine removes it when the attach ends. Every process on every
+ * machine that reaches the engine shares the locks.
+ *
+ * Callers in this process first line up in a queue in memory, so one process
+ * makes at most one claim attempt for each key, in the order of the calls.
+ */
+export declare class DockerEngineStore implements LockStore {
+    #private;
+    constructor(options: DockerEngineStoreOptions);
+    acquire(key: string, options?: AcquireOptions): Promise<LockHandle>;
+    tryAcquire(key: string): Promise<LockHandle | undefined>;
+    /** Reads the state of the claim, and never creates a container or mints a token. */
+    isHeld(key: string): Promise<boolean>;
+}
+//# sourceMappingURL=docker-engine-store.d.ts.map

package/dist/lock-stores/docker/docker-engine-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-engine-store.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/docker/docker-engine-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,MAAM,EAEZ,MAAM,iBAAiB,CAAC;AAIzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAI3E,MAAM,WAAW,wBAAwB;IACvC,6GAA6G;IAC7G,MAAM,EAAE,MAAM,CAAC;IACf,gHAAgH;IAChH,KAAK,EAAE,MAAM,CAAC;IACd,mJAAmJ;IACnJ,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAYD;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,YAAW,SAAS;;gBAIrC,OAAO,EAAE,wBAAwB;IAI7C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBnE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAOxD,oFAAoF;IAC9E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAO5C"}

package/dist/lock-stores/docker/docker-engine-store.js

@@ -0,0 +1,312 @@
+import { setTimeout as delay } from 'node:timers/promises';
+import { ContainerNotFoundError, ContainerRunningError, NameConflictError, } from '@zukhruf/docker';
+import { FencingToken } from '@zukhruf/fencing';
+import { LeaseController } from '@zukhruf/lease';
+import { InProcessTurns } from "../../shared/in-process-turns.js";
+import { keyDigest } from "../../shared/key-digest.js";
+const namespaceLabel = 'zukhruf.mutex.namespace';
+const keyLabel = 'zukhruf.mutex.key';
+const tokenLabel = 'zukhruf.mutex.token';
+/** The states of a claim that no other caller can take the key from. */
+const holdingStates = new Set(['created', 'running', 'paused', 'restarting']);
+/** The states of a claim that ended: no holder can have it, and only a removal makes its name free. */
+const endedStates = new Set(['exited', 'dead']);
+/**
+ * Holds a key as a named container on one Docker engine: the claim. The claim
+ * runs `cat` on the standard input of the attach of its holder, so it ends
+ * and the engine removes it when the attach ends. Every process on every
+ * machine that reaches the engine shares the locks.
+ *
+ * Callers in this process first line up in a queue in memory, so one process
+ * makes at most one claim attempt for each key, in the order of the calls.
+ */
+export class DockerEngineStore {
+    #turns = new InProcessTurns();
+    #options;
+    constructor(options) {
+        this.#options = options;
+    }
+    acquire(key, options) {
+        return this.#turns.acquire(key, options, async () => {
+            const signal = options?.signal;
+            const claims = new Claims(key, this.#options);
+            const cancel = signal === undefined ? {} : { signal };
+            for (;;) {
+                signal?.throwIfAborted();
+                const claim = await claims.create(signal);
+                if (claim === undefined) {
+                    await claims.waitForRelease(cancel);
+                    continue;
+                }
+                const handle = await claim.hold();
+                if (handle !== undefined)
+                    return handle;
+            }
+        });
+    }
+    tryAcquire(key) {
+        return this.#turns.tryAcquire(key, async () => {
+            const claim = await new Claims(key, this.#options).create(undefined);
+            return claim?.hold();
+        });
+    }
+    /** Reads the state of the claim, and never creates a container or mints a token. */
+    async isHeld(key) {
+        const claim = await this.#options.docker.containers.find(claimName(key, this.#options.namespace));
+        if (claim === undefined)
+            return false;
+        return holdingStates.has((await stateOf(claim)) ?? '');
+    }
+}
+/** The key digest in hexadecimal. */
+function digestOf(key) {
+    return keyDigest(key).toString('hex');
+}
+function claimName(key, namespace) {
+    return `${namespace}-${digestOf(key)}`;
+}
+/** The state of the container, or undefined when it is gone. */
+async function stateOf(container, cancel = {}) {
+    try {
+        return (await container.inspect(cancel)).State?.Status;
+    }
+    catch (error) {
+        if (error instanceof ContainerNotFoundError)
+            return undefined;
+        throw error;
+    }
+}
+/** The claims of one key: their create, and the wait of a caller that did not get the name. */
+class Claims {
+    #key;
+    #options;
+    #name;
+    constructor(key, options) {
+        this.#key = key;
+        this.#options = options;
+        this.#name = claimName(key, options.namespace);
+    }
+    /** The new claim, or undefined when another caller has the name. A cancel after the create removes the new claim. */
+    async create(signal) {
+        const { docker, image, namespace } = this.#options;
+        let container;
+        try {
+            container = await docker.containers.create({
+                Image: image,
+                Entrypoint: ['cat'],
+                Cmd: [],
+                OpenStdin: true,
+                StdinOnce: true,
+                AttachStdin: true,
+                Labels: { [namespaceLabel]: namespace, [keyLabel]: this.#key },
+                HostConfig: { AutoRemove: true },
+            }, { name: this.#name });
+        }
+        catch (error) {
+            if (error instanceof NameConflictError)
+                return undefined;
+            throw error;
+        }
+        if (signal?.aborted) {
+            await container.remove({ force: true });
+            throw signal.reason;
+        }
+        return new Claim(container, this.#key, this.#options);
+    }
+    /**
+     * Waits by ID for the claim that has the name, so that a release before the
+     * wait is never lost. Each wait lasts at most `heartbeatInterval`, and then
+     * the waiter looks at the claim again:
+     *
+     * - An `exited` or `dead` claim has no holder. Its removal failed, so the
+     *   waiter removes it.
+     * - A claim that stays `created` gets a removal without force: the engine
+     *   lets only one of that removal and the start of its caller succeed.
+     * - A `running`, `paused` or `restarting` claim can have a live holder, so
+     *   the waiter never removes it, and waits again.
+     */
+    async waitForRelease(cancel) {
+        const claim = await this.#options.docker.containers.find(this.#name, cancel);
+        if (claim === undefined)
+            return;
+        let state = await stateOf(claim, cancel);
+        for (;;) {
+            if (state === undefined)
+                return;
+            if (endedStates.has(state)) {
+                await removeUnlessRunning(claim, cancel);
+                return;
+            }
+            const seen = state;
+            if (await this.#removedWithin(claim, cancel))
+                return;
+            state = await stateOf(claim, cancel);
+            if (seen === 'created' && state === 'created') {
+                await removeUnlessRunning(claim, cancel);
+                return;
+            }
+        }
+    }
+    /** True when the claim is gone within `heartbeatInterval`, false when it is still there. */
+    async #removedWithin(claim, { signal }) {
+        const patience = AbortSignal.timeout(this.#options.heartbeatInterval);
+        try {
+            await claim.wait({
+                condition: 'removed',
+                signal: signal === undefined ? patience : AbortSignal.any([signal, patience]),
+            });
+            return true;
+        }
+        catch (error) {
+            if (error instanceof ContainerNotFoundError)
+                return true;
+            if (signal?.aborted || !patience.aborted)
+                throw error;
+            return false;
+        }
+    }
+}
+/**
+ * Removes the claim by its ID without force, so that a claim of a later
+ * holder with the same name is never removed. The engine lets only one of
+ * this removal and the start of a `created` claim succeed.
+ */
+async function removeUnlessRunning(claim, cancel) {
+    try {
+        await claim.remove({ force: false, ...cancel });
+    }
+    catch (error) {
+        if (!(error instanceof ContainerRunningError))
+            throw error;
+    }
+}
+/** A claim that this caller created: it attaches, starts, mints and confirms, then holds with a heartbeat. */
+class Claim {
+    #container;
+    #key;
+    #options;
+    #lease;
+    /** Aborts when the store stops holding: a release, or a lost claim. */
+    #done = new AbortController();
+    constructor(container, key, options) {
+        this.#container = container;
+        this.#key = key;
+        this.#options = options;
+        this.#lease = new LeaseController(key);
+    }
+    /** The handle of the key, or undefined when a waiter removed the claim before its start, or the claim ended during the mint. */
+    async hold() {
+        let attach;
+        let token;
+        try {
+            // The attach comes before the start, so the claim never runs without it.
+            attach = await this.#container.attach({ stdin: true });
+            const ended = attach.exitCode;
+            ended.catch(() => { });
+            await this.#container.start();
+            token = await this.#mint();
+            if ((await stateOf(this.#container)) === undefined)
+                return undefined;
+            ended.then((code) => this.#lose(new Error(`The claim exited with the code ${code}.`)), (cause) => this.#lose(cause));
+        }
+        catch (error) {
+            if (error instanceof ContainerNotFoundError)
+                return undefined;
+            await this.#container.remove({ force: true });
+            throw error;
+        }
+        void this.#beat();
+        return {
+            token,
+            signal: this.#lease.signal,
+            [Symbol.asyncDispose]: () => this.#release(),
+        };
+    }
+    /**
+     * Creates the rung above the highest rung of the ladder of the key, climbs
+     * on a taken name, then removes the rungs that it read. A rung goes only
+     * after a higher one exists, so a list always finds the highest rung.
+     */
+    async #mint() {
+        const { docker, namespace } = this.#options;
+        const digest = digestOf(this.#key);
+        const prefix = `${namespace}-${digest}-token-`;
+        const rungs = await docker.volumes.list({
+            filters: {
+                label: [`${namespaceLabel}=${namespace}`, `${tokenLabel}=${digest}`],
+            },
+        });
+        let rung = 0;
+        for (const { Name } of rungs) {
+            if (!Name.startsWith(prefix))
+                continue;
+            const number = Number(Name.slice(prefix.length));
+            if (Number.isSafeInteger(number) && number > rung)
+                rung = number;
+        }
+        for (;;) {
+            rung += 1;
+            try {
+                await docker.volumes.create({
+                    Name: `${prefix}${rung}`,
+                    Labels: { [namespaceLabel]: namespace, [tokenLabel]: digest },
+                });
+                break;
+            }
+            catch (error) {
+                if (!(error instanceof NameConflictError))
+                    throw error;
+            }
+        }
+        for (const { Name } of rungs) {
+            await (await docker.volumes.find(Name))?.remove();
+        }
+        return new FencingToken(BigInt(rung));
+    }
+    /** Inspects the claim each interval. A claim that is gone or does not run, or a failed or late answer, loses the lease. */
+    async #beat() {
+        const interval = this.#options.heartbeatInterval;
+        const done = this.#done.signal;
+        try {
+            for (;;) {
+                await delay(interval, undefined, { signal: done });
+                const state = await stateOf(this.#container, {
+                    signal: AbortSignal.any([done, AbortSignal.timeout(interval)]),
+                });
+                if (state !== 'running') {
+                    throw new Error(state === undefined
+                        ? 'The claim is gone.'
+                        : `The claim is ${state}.`);
+                }
+            }
+        }
+        catch (cause) {
+            if (!done.aborted)
+                this.#lose(cause);
+        }
+    }
+    /** Another caller can have the key now. A claim that still runs is removed, so that waiters do not wait for it. */
+    #lose(cause) {
+        if (this.#done.signal.aborted)
+            return;
+        this.#done.abort();
+        this.#lease.lose(cause);
+        // Nobody waits for this removal; a failed one leaves the claim to the end of its attach.
+        this.#container.remove({ force: true }).catch(() => { });
+    }
+    /** Removes the claim by its ID, so that a release never removes the claim of a later holder. */
+    async #release() {
+        if (this.#done.signal.aborted)
+            return;
+        this.#done.abort();
+        try {
+            await this.#container.remove({ force: true });
+        }
+        catch (cause) {
+            this.#lease.lose(cause);
+            return;
+        }
+        this.#lease.end();
+    }
+}
+//# sourceMappingURL=docker-engine-store.js.map

package/dist/lock-stores/docker/docker-engine-store.js.map

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

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

@@ -0,0 +1,2 @@
+export { DockerEngineStore, type DockerEngineStoreOptions, } from './docker-engine-store.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/docker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC"}

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

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

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

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

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

@@ -0,0 +1,2 @@
+export { MariadbStore, type MariadbSession, type MariadbStoreOptions, } from './mariadb-store.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/mariadb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,33 @@
+import { type GetLockSession } from '../mysql/get-lock-dialect.ts';
+import { SessionLockStore } from '../session/session-lock-store.ts';
+/**
+ * One connection to the MariaDB server: only the methods that the store
+ * calls. A `PoolConnection` of `mariadb` (MariaDB Connector/Node.js) fits it.
+ */
+export interface MariadbSession extends GetLockSession {
+    query(sql: string, values: unknown[]): Promise<unknown>;
+    /** Gives the session back to its pool. It never rejects. */
+    release(): Promise<void>;
+}
+export interface MariadbStoreOptions {
+    /** Gives a new session. The store owns each session that it gets. */
+    connect(): Promise<MariadbSession>;
+    /** The name of an existing sequence in the database of the session, 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 MariaDB user lock (`GET_LOCK`) 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 MariaDB database shares the locks.
+ */
+export declare class MariadbStore extends SessionLockStore<MariadbSession> {
+    constructor({ connect, sequence, heartbeatInterval }: MariadbStoreOptions);
+}
+//# sourceMappingURL=mariadb-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mariadb-store.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/mariadb/mariadb-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAIpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,4DAA4D;IAC5D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,sHAAsH;IACtH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AASD;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,gBAAgB,CAAC,cAAc,CAAC;gBACpD,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,EAAE,mBAAmB;CAM1E"}

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

@@ -0,0 +1,36 @@
+import { getLockDialect, lockName, quoteName, } from "../mysql/get-lock-dialect.js";
+import { SessionLockStore } from "../session/session-lock-store.js";
+/**
+ * MariaDB's longest `GET_LOCK` timeout that the store uses: one year, in
+ * seconds. A negative timeout gives NULL, and a timeout that ends after
+ * 2^64 nanoseconds since 1970 gives 0 at once.
+ */
+const oneYear = 31_536_000;
+/**
+ * Holds a MariaDB user lock (`GET_LOCK`) 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 MariaDB database shares the locks.
+ */
+export class MariadbStore extends SessionLockStore {
+    constructor({ connect, sequence, heartbeatInterval }) {
+        super({ connect, heartbeatInterval }, getLockDialect(mariadbServer(quoteName(sequence))));
+    }
+}
+function mariadbServer(sequence) {
+    return {
+        server: 'MariaDB',
+        // The session's max_statement_time makes a waiting GET_LOCK give NULL.
+        waitStatement: `SET STATEMENT max_statement_time = 0 FOR SELECT GET_LOCK(${lockName}, ${oneYear}) AS locked`,
+        run: (session, sql, values) => session.query(sql, values),
+        giveBack: (session) => void session.release(),
+        mint: async (run) => {
+            const row = await run(`SELECT CAST(NEXTVAL(${sequence}) AS CHAR) AS token`, []);
+            if (typeof row?.['token'] !== 'string') {
+                throw new Error(`NEXTVAL of sequence ${sequence} gave no number.`);
+            }
+            return BigInt(row['token']);
+        },
+    };
+}
+//# sourceMappingURL=mariadb-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mariadb-store.js","sourceRoot":"","sources":["../../../src/lock-stores/mariadb/mariadb-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAyBpE;;;;GAIG;AACH,MAAM,OAAO,GAAG,UAAU,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,gBAAgC;IAChE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAuB;QACvE,KAAK,CACH,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAC9B,cAAc,CAAC,aAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CACnD,CAAC;IACJ,CAAC;CACF;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,uEAAuE;QACvE,aAAa,EAAE,4DAA4D,QAAQ,KAAK,OAAO,aAAa;QAC5G,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC;QACzD,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,EAAE;QAC7C,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAClB,MAAM,GAAG,GAAG,MAAM,GAAG,CACnB,uBAAuB,QAAQ,qBAAqB,EACpD,EAAE,CACH,CAAC;YACF,IAAI,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,kBAAkB,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lock-stores/mysql/get-lock-dialect.d.ts

@@ -0,0 +1,46 @@
+import type { SessionLockDialect } from '../session/session-lock-store.ts';
+/** The events and the close of one connection to a server of the MySQL family: the parts that both drivers share. */
+export interface GetLockSession {
+    on(event: 'error', listener: (error: Error) => void): unknown;
+    on(event: 'end', listener: () => void): unknown;
+    off(event: 'error' | 'end', listener: (error: Error) => void): unknown;
+    /** Closes the connection; the server then releases each user lock of the session. */
+    destroy(): void;
+}
+export type Row = Record<string, unknown>;
+/** Runs one statement on the session and gives its first row, if it gives rows. */
+export type RunStatement = (sql: string, values: unknown[]) => Promise<Row | undefined>;
+/** What differs between MySQL and MariaDB, and between their drivers. */
+export interface GetLockServer<Session extends GetLockSession> {
+    /** The name of the server in error messages. */
+    readonly server: string;
+    /**
+     * `SELECT GET_LOCK(${lockName}, <timeout>) AS locked`, with the longest timeout of
+     * the server, and free of the time limit of a statement of the session.
+     */
+    readonly waitStatement: string;
+    /** Runs a statement with the driver, and gives the result: the rows of a SELECT. */
+    run(session: Session, sql: string, values: unknown[]): Promise<unknown>;
+    /** Gives a session that holds nothing back to its pool. */
+    giveBack(session: Session): void;
+    /** Gives the next fencing token from the object that the caller created. */
+    mint(run: RunStatement): Promise<bigint>;
+}
+/**
+ * The name of the user lock, made on the server from the database of the
+ * session and the digest of the key (the one `?`). A user lock belongs to
+ * the whole server, but the token source belongs to one database, so the
+ * lock belongs to one database too. SHA-256 gives 64 lowercase hex
+ * characters: the limit of MySQL, and the same under a comparison with or
+ * without case. With no database, the name is NULL, and the statement fails.
+ */
+export declare const lockName = "SHA2(CONCAT(DATABASE(), ':', ?), 256)";
+/**
+ * The dialect of a user lock (`GET_LOCK`) for each key. The name of each lock
+ * includes the database of the session, so the locks belong to one database.
+ * The client sends the key digest as 64 lowercase hex characters.
+ */
+export declare function getLockDialect<Session extends GetLockSession>(server: GetLockServer<Session>): SessionLockDialect<Session>;
+/** Quotes one identifier for MySQL and MariaDB. */
+export declare function quoteName(name: string): string;
+//# sourceMappingURL=get-lock-dialect.d.ts.map

package/dist/lock-stores/mysql/get-lock-dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-lock-dialect.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/mysql/get-lock-dialect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,qHAAqH;AACrH,MAAM,WAAW,cAAc;IAC7B,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,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;IACvE,qFAAqF;IACrF,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,EAAE,KACd,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;AAE9B,yEAAyE;AACzE,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,cAAc;IAC3D,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,oFAAoF;IACpF,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,4EAA4E;IAC5E,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,0CAA0C,CAAC;AAehE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAS,cAAc,EAC3D,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,GAC7B,kBAAkB,CAAC,OAAO,CAAC,CA+D7B;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}