@zukhruf/mutex 0.3.39 → 0.3.41

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/memory/index.d.ts

@@ -0,0 +1,2 @@
+export { MemoryStore, type MemoryStoreOptions } from './memory-store.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lock-stores/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA2B,MAAM,mBAAmB,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"}

package/dist/lock-stores/mysql/get-lock-dialect.js

@@ -0,0 +1,80 @@
+import { untilAborted } from '@zukhruf/async';
+import { keyDigest } from "../../shared/key-digest.js";
+/**
+ * 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 const lockName = "SHA2(CONCAT(DATABASE(), ':', ?), 256)";
+/** `GET_LOCK` gives 1 for a grant and 0 for a timeout; NULL is an error, for example a killed statement. */
+function granted(row, server) {
+    const locked = row?.['locked'];
+    if (locked === null || locked === undefined) {
+        throw new Error(`GET_LOCK of ${server} gave NULL.`);
+    }
+    return Number(locked) === 1;
+}
+function isRow(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * 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 function getLockDialect(server) {
+    const runOn = (session) => async (sql, values) => {
+        const result = await server.run(session, sql, values);
+        if (!Array.isArray(result))
+            return undefined;
+        const first = result[0];
+        return isRow(first) ? first : undefined;
+    };
+    return {
+        server: server.server,
+        lockName: (key) => keyDigest(key).toString('hex'),
+        // A timeout of `GET_LOCK` (MariaDB's longest is one year) waits again.
+        wait: async (session, { name }, signal) => {
+            for (;;) {
+                const row = await untilAborted(runOn(session)(server.waitStatement, [name]), signal);
+                if (granted(row, server.server))
+                    return;
+            }
+        },
+        try: async (session, { name }) => granted(await runOn(session)(`SELECT GET_LOCK(${lockName}, 0) AS locked`, [
+            name,
+        ]), server.server),
+        mint: (session) => server.mint(runOn(session)),
+        // `IS_USED_LOCK` never acquires the lock. It gives NULL for a free lock.
+        holds: async (session, { name }) => {
+            const row = await runOn(session)(`SELECT IS_USED_LOCK(${lockName}) = CONNECTION_ID() AS held`, [name]);
+            return Number(row?.['held']) === 1;
+        },
+        release: async (session, { name }) => {
+            const row = await runOn(session)(`SELECT RELEASE_LOCK(${lockName}) AS released`, [name]);
+            return Number(row?.['released']) === 1;
+        },
+        /** Reads `IS_USED_LOCK`, which never acquires the lock. A session with no database fails. */
+        isHeld: async (session, { name }) => {
+            const row = await runOn(session)(`SELECT IS_USED_LOCK(${lockName}) AS holder, DATABASE() AS db`, [name]);
+            if (row?.['db'] === null) {
+                throw new Error(`The ${server.server} session has no database.`);
+            }
+            return row?.['holder'] !== null;
+        },
+        detach: (session, { error, end }) => {
+            session.off('error', error);
+            session.off('end', end);
+        },
+        giveBack: (session) => server.giveBack(session),
+        destroy: (session) => session.destroy(),
+    };
+}
+/** Quotes one identifier for MySQL and MariaDB. */
+export function quoteName(name) {
+    return `\`${name.replaceAll('`', '``')}\``;
+}
+//# sourceMappingURL=get-lock-dialect.js.map

package/dist/lock-stores/mysql/get-lock-dialect.js.map

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

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

@@ -0,0 +1,2 @@
+export { MysqlStore, type MysqlSession, type MysqlStoreOptions, } from './mysql-store.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/mysql/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,37 @@
+import { SessionLockStore } from '../session/session-lock-store.ts';
+import { type GetLockSession } from './get-lock-dialect.ts';
+/**
+ * One connection to the MySQL server: only the methods that the store calls.
+ * A `PoolConnection` of `mysql2/promise` fits it.
+ */
+export interface MysqlSession extends GetLockSession {
+    query(sql: string, values: unknown[]): Promise<[unknown, unknown]>;
+    /** Gives the session back to its pool. */
+    release(): void;
+}
+export interface MysqlStoreOptions {
+    /** Gives a new session. The store owns each session that it gets. */
+    connect(): Promise<MysqlSession>;
+    /**
+     * The name of an existing table in the database of the session, with one
+     * row and one `BIGINT UNSIGNED` column `id`, for the fencing tokens. The
+     * store runs no DDL.
+     */
+    table: 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 MySQL 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
+ * MySQL database shares the locks.
+ */
+export declare class MysqlStore extends SessionLockStore<MysqlSession> {
+    constructor({ connect, table, heartbeatInterval }: MysqlStoreOptions);
+}
+//# sourceMappingURL=mysql-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-store.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/mysql/mysql-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAEL,KAAK,cAAc,EAIpB,MAAM,uBAAuB,CAAC;AAE/B;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACnE,0CAA0C;IAC1C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IACjC;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,gBAAgB,CAAC,YAAY,CAAC;gBAChD,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,iBAAiB;CAMrE"}

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

@@ -0,0 +1,35 @@
+import { SessionLockStore } from "../session/session-lock-store.js";
+import { getLockDialect, lockName, quoteName, } from "./get-lock-dialect.js";
+/**
+ * Holds a MySQL 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
+ * MySQL database shares the locks.
+ */
+export class MysqlStore extends SessionLockStore {
+    constructor({ connect, table, heartbeatInterval }) {
+        super({ connect, heartbeatInterval }, getLockDialect(mysqlServer(quoteName(table))));
+    }
+}
+function mysqlServer(table) {
+    return {
+        server: 'MySQL',
+        // A negative timeout waits with no limit. The hint lifts the session's
+        // max_execution_time, which interrupts a waiting GET_LOCK.
+        waitStatement: `SELECT /*+ SET_VAR(max_execution_time = 0) */ GET_LOCK(${lockName}, -1) AS locked`,
+        run: async (session, sql, values) => (await session.query(sql, values))[0],
+        giveBack: (session) => session.release(),
+        // The sequence of the MySQL manual (LAST_INSERT_ID(expr)). An UPDATE that
+        // changes no row leaves LAST_INSERT_ID() at the session's last token.
+        mint: async (run) => {
+            await run(`UPDATE ${table} SET id = LAST_INSERT_ID(id + 1)`, []);
+            const row = await run('SELECT CAST(LAST_INSERT_ID() AS CHAR) AS token, ROW_COUNT() AS updated', []);
+            const updated = Number(row?.['updated']);
+            if (updated !== 1 || typeof row?.['token'] !== 'string') {
+                throw new Error(`The token table ${table} must have exactly one row; the update changed ${updated}.`);
+            }
+            return BigInt(row['token']);
+        },
+    };
+}
+//# sourceMappingURL=mysql-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-store.js","sourceRoot":"","sources":["../../../src/lock-stores/mysql/mysql-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAGL,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,uBAAuB,CAAC;AA6B/B;;;;;GAKG;AACH,MAAM,OAAO,UAAW,SAAQ,gBAA8B;IAC5D,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAqB;QAClE,KAAK,CACH,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAC9B,cAAc,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAC9C,CAAC;IACJ,CAAC;CACF;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO;QACL,MAAM,EAAE,OAAO;QACf,uEAAuE;QACvE,2DAA2D;QAC3D,aAAa,EAAE,0DAA0D,QAAQ,iBAAiB;QAClG,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;QACxC,0EAA0E;QAC1E,sEAAsE;QACtE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAClB,MAAM,GAAG,CAAC,UAAU,KAAK,kCAAkC,EAAE,EAAE,CAAC,CAAC;YACjE,MAAM,GAAG,GAAG,MAAM,GAAG,CACnB,wEAAwE,EACxE,EAAE,CACH,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;YACzC,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACxD,MAAM,IAAI,KAAK,CACb,mBAAmB,KAAK,kDAAkD,OAAO,GAAG,CACrF,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,2 @@
+export { PostgresStore, type PostgresSession, type PostgresStoreOptions, } from './postgres-store.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/postgres/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,41 @@
+import { SessionLockStore } from '../session/session-lock-store.ts';
+/**
+ * One connection to the Postgres server: only the methods that the store
+ * calls. A `PoolClient` of `pg` (node-postgres) fits it.
+ */
+export interface PostgresSession {
+    query(text: string, values: unknown[]): Promise<{
+        rows: Record<string, unknown>[];
+    }>;
+    on(event: 'error', listener: (error: Error) => void): unknown;
+    on(event: 'end', listener: () => void): unknown;
+    off(event: 'error' | 'end', listener: (error: Error) => void): unknown;
+    /** `true` destroys the session; `false` gives it back to its pool. */
+    release(destroy: boolean): void;
+}
+export interface PostgresStoreOptions {
+    /** Gives a new session. The store owns each session that it gets. */
+    connect(): Promise<PostgresSession>;
+    /** The name of an existing sequence for the fencing tokens. The store runs no DDL. */
+    sequence: string;
+    /**
+     * Milliseconds between two heartbeats of a holder, and the time limit of
+     * each heartbeat: the longest time that a holder can work after its session
+     * ended, before its signal aborts.
+     */
+    heartbeatInterval: number;
+}
+/**
+ * Holds a session-level advisory lock of Postgres for each key, on a session
+ * of its own. The server releases the lock when the session ends, so a
+ * holder that stops never leaves a key locked. Every process on every machine
+ * that reaches one database shares the locks.
+ *
+ * Callers in this process first line up in a queue in memory, so only the
+ * first one gets a session: one session per key per process, however many
+ * callers wait, and first-come order within the process.
+ */
+export declare class PostgresStore extends SessionLockStore<PostgresSession> {
+    constructor(options: PostgresStoreOptions);
+}
+//# sourceMappingURL=postgres-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-store.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/postgres/postgres-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,gBAAgB,EACjB,MAAM,kCAAkC,CAAC;AAE1C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,EAAE,GAChB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;IAChD,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,sEAAsE;IACtE,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAeD;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,gBAAgB,CAAC,eAAe,CAAC;gBACtD,OAAO,EAAE,oBAAoB;CAG1C"}

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

@@ -0,0 +1,83 @@
+import { untilAborted } from '@zukhruf/async';
+import { keyDigest } from "../../shared/key-digest.js";
+import { SessionLockStore, } from "../session/session-lock-store.js";
+/** The granted advisory locks of a lock number in the database of the session. */
+const lockRows = `FROM pg_catalog.pg_locks
+  WHERE locktype = 'advisory'
+    AND database = (SELECT oid FROM pg_catalog.pg_database WHERE datname = pg_catalog.current_database())
+    AND objsubid = 1
+    AND ((classid::bigint << 32) | objid::bigint) = $1::bigint
+    AND granted`;
+const heldQuery = `SELECT EXISTS (SELECT 1 ${lockRows}) AS held`;
+/** Whether the session of the heartbeat holds the lock. */
+const holdsQuery = `SELECT EXISTS (SELECT 1 ${lockRows} AND pid = pg_catalog.pg_backend_pid()) AS held`;
+/**
+ * Holds a session-level advisory lock of Postgres for each key, on a session
+ * of its own. The server releases the lock when the session ends, so a
+ * holder that stops never leaves a key locked. Every process on every machine
+ * that reaches one database shares the locks.
+ *
+ * Callers in this process first line up in a queue in memory, so only the
+ * first one gets a session: one session per key per process, however many
+ * callers wait, and first-come order within the process.
+ */
+export class PostgresStore extends SessionLockStore {
+    constructor(options) {
+        super(options, postgresDialect(options));
+    }
+}
+/**
+ * The number of the advisory lock of `key`: the first 8 bytes of the key
+ * digest, as a signed 64-bit integer. Sent as text, because a JavaScript
+ * number cannot hold 64 bits.
+ */
+function lockNumber(key) {
+    return keyDigest(key).readBigInt64BE(0).toString();
+}
+const rowsOf = async (session, text, values) => (await session.query(text, values)).rows;
+function postgresDialect(options) {
+    return {
+        server: 'Postgres',
+        lockName: lockNumber,
+        wait: async (session, { name }, signal) => {
+            // A timeout of the pool must not stop the wait.
+            await session.query('SET statement_timeout = 0; SET lock_timeout = 0', []);
+            await untilAborted(session.query('SELECT pg_advisory_lock($1::bigint)', [name]), signal);
+        },
+        try: async (session, { name }) => {
+            const [row] = await rowsOf(session, 'SELECT pg_try_advisory_lock($1::bigint) AS locked', [name]);
+            return row?.locked === true;
+        },
+        mint: async (session) => {
+            const [row] = await rowsOf(session, 'SELECT nextval($1::regclass)::text AS token', [options.sequence]);
+            if (typeof row?.token !== 'string') {
+                throw new Error(`nextval of sequence ${JSON.stringify(options.sequence)} gave no number.`);
+            }
+            return BigInt(row.token);
+        },
+        holds: async (session, { name }) => {
+            const [row] = await rowsOf(session, holdsQuery, [name]);
+            return row?.held === true;
+        },
+        release: async (session, { name }) => {
+            const [row] = await rowsOf(session, 'SELECT pg_advisory_unlock($1::bigint) AS released', [name]);
+            if (row?.released !== true)
+                return false;
+            await session.query('RESET statement_timeout; RESET lock_timeout', []);
+            return true;
+        },
+        /** Reads `pg_locks`, and never runs an advisory lock function. */
+        isHeld: async (session, { name }) => {
+            const [row] = await rowsOf(session, heldQuery, [name]);
+            return row?.held === true;
+        },
+        detach: (session, { error, end }) => {
+            session.off('error', error);
+            session.off('end', end);
+        },
+        // The session holds nothing: it goes back to the pool with its own settings.
+        giveBack: (session) => session.release(false),
+        destroy: (session) => session.release(true),
+    };
+}
+//# sourceMappingURL=postgres-store.js.map

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

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

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

@@ -0,0 +1,72 @@
+import type { LockHandle } from '../../mutex/lease.ts';
+import type { AcquireOptions, LockStore } from '../../mutex/lock-store.ts';
+/** The events of a session that tell the store that the session ended. */
+export interface SessionEvents {
+    on(event: 'error', listener: (error: Error) => void): unknown;
+    on(event: 'end', listener: () => void): unknown;
+}
+/** The listeners that the store puts on each session that it owns. */
+export interface SessionListeners {
+    error: (error: Error) => void;
+    end: () => void;
+}
+/** The lock of one key on the server. */
+export interface SessionLock {
+    key: string;
+    /** The name of the lock on the server, made from the key digest. */
+    name: string;
+}
+/** What differs between the servers of the SQL lock stores, and between their drivers. */
+export interface SessionLockDialect<Session extends SessionEvents> {
+    /** The name of the server in error messages. */
+    readonly server: string;
+    /** The name of the lock of `key` on the server. */
+    lockName(key: string): string;
+    /** Waits in the server's queue until the session holds the lock. A cancel of `signal` rejects at once. */
+    wait(session: Session, lock: SessionLock, signal: AbortSignal | undefined): Promise<void>;
+    /** Takes the lock only when no other session holds it. */
+    try(session: Session, lock: SessionLock): Promise<boolean>;
+    /** Gives the next fencing token. */
+    mint(session: Session): Promise<bigint>;
+    /** Whether this session holds the lock now. It never acquires the lock. */
+    holds(session: Session, lock: SessionLock): Promise<boolean>;
+    /** Releases the lock; `false` when the session did not hold it. */
+    release(session: Session, lock: SessionLock): Promise<boolean>;
+    /** Whether any session holds the lock now. It never acquires the lock. */
+    isHeld(session: Session, lock: SessionLock): Promise<boolean>;
+    /** Takes the store's listeners off a session that goes back to its pool. */
+    detach(session: Session, listeners: SessionListeners): void;
+    /** Gives back a session that holds nothing: to its pool, or by a close. */
+    giveBack(session: Session): void;
+    /** Ends the connection: the server then releases each lock of the session. */
+    destroy(session: Session): void;
+}
+export interface SessionLockStoreOptions<Session extends SessionEvents> {
+    /** Gives a new session. The store owns each session that it gets. */
+    connect(): Promise<Session>;
+    /**
+     * Milliseconds between two heartbeats of a holder, and the time limit of
+     * each heartbeat: the longest time that a holder can work after its session
+     * ended, before its signal aborts.
+     */
+    heartbeatInterval: number;
+}
+/**
+ * Holds a session-level lock of a SQL server for each key, on a session of
+ * its own. The server releases the lock when the session ends, so a holder
+ * that stops never leaves a key locked. Every process on every machine that
+ * reaches one database shares the locks.
+ *
+ * Callers in this process first line up in a queue in memory, so only the
+ * first one gets a session: one session per key per process, however many
+ * callers wait, and first-come order within the process.
+ */
+export declare class SessionLockStore<Session extends SessionEvents> implements LockStore {
+    #private;
+    constructor(options: SessionLockStoreOptions<Session>, dialect: SessionLockDialect<Session>);
+    acquire(key: string, options?: AcquireOptions): Promise<LockHandle>;
+    tryAcquire(key: string): Promise<LockHandle | undefined>;
+    /** Asks the server on a short session, and never acquires the lock. */
+    isHeld(key: string): Promise<boolean>;
+}
+//# sourceMappingURL=session-lock-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-lock-store.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/session/session-lock-store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG3E,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,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;CACjD;AAED,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0FAA0F;AAC1F,MAAM,WAAW,kBAAkB,CAAC,OAAO,SAAS,aAAa;IAC/D,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,0GAA0G;IAC1G,IAAI,CACF,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,0DAA0D;IAC1D,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,oCAAoC;IACpC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,2EAA2E;IAC3E,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,mEAAmE;IACnE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,0EAA0E;IAC1E,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,4EAA4E;IAC5E,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5D,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,8EAA8E;IAC9E,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,uBAAuB,CAAC,OAAO,SAAS,aAAa;IACpE,qEAAqE;IACrE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,qBAAa,gBAAgB,CAC3B,OAAO,SAAS,aAAa,CAC7B,YAAW,SAAS;;gBAMlB,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,EACzC,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC;IAMtC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IASnE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAQxD,uEAAuE;IACjE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAwC5C"}