@zukhruf/mutex 0.3.38 → 0.3.40

package/README.md

@@ -1,6 +1,6 @@
 # @zukhruf/mutex
 
-A mutex for Node.js with interchangeable lock stores. You select who shares the locks: one object, the threads of one process, a parent process and its children, or all processes on one host. The code that uses the mutex stays the same. Each lease has a fencing token, so a resource can refuse the late writes of a holder that lost its key.
+A mutex for Node.js with interchangeable lock stores. You select who shares the locks: one object, the threads of one process, a parent process and its children, all processes on one host, or all machines that reach one Postgres database. The code that uses the mutex stays the same. Each lease has a fencing token, so a resource can refuse the late writes of a holder that lost its key.
 
 The words in these documents have one meaning each. See the glossary in [CONTEXT.md](./CONTEXT.md).
 
@@ -19,7 +19,8 @@ if (stock > 0) {
 A mutex lets one holder at a time run this code for a key:
 
 ```ts
-import { MemoryStore, Mutex } from '@zukhruf/mutex';
+import { Mutex } from '@zukhruf/mutex';
+import { MemoryStore } from '@zukhruf/mutex/memory';
 
 const mutex = new Mutex(new MemoryStore());
 
@@ -35,22 +36,24 @@ The full program is in the recipe [Stop two requests from selling the last item]
 
 ## Select a lock store
 
-First find who writes to the resource. Then select the lock store with that [reach](./docs/concepts/reach.md).
+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                                                       | Reach                   | Order                                   | A holder stops                                | Needs                       |
-| ---------------------------------------------------------------- | ----------------------- | --------------------------------------- | --------------------------------------------- | --------------------------- |
-| [MemoryStore](./docs/stores/memory-store.md)                     | One object              | First come, first served                | The locks stop with the process               | Nothing                     |
-| [ThreadStore](./docs/stores/thread-store.md)                     | One process (threads)   | First come, first served                | Released when the worker exits                | `adopt(worker)`             |
-| [IpcStore](./docs/stores/ipc-store.md)                           | 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) | One host                | First come, first served                | Released after a waiter finds that it stopped | A shared directory          |
-| [LockFileStore](./docs/stores/lock-file-store.md)                | One host                | No order                                | Released after a waiter finds that it stopped | A shared directory          |
-| [SqliteStore](./docs/stores/sqlite-store.md)                     | One host                | First come, first served in one process | Released by the kernel                        | A shared directory          |
-| [SocketStore](./docs/stores/socket-store.md)                     | One host                | First come, first served                | Released in approximately 2 ms                | A shared directory          |
+| 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 |
 
 If you are not sure:
 
 - **One process:** use `MemoryStore`.
 - **Several processes on one host:** use `SqliteStore`.
+- **Many machines that already use Postgres:** use `PostgresStore`.
 
 ## Acquire modes
 
@@ -151,7 +154,8 @@ npm install @zukhruf/mutex
 ```
 
 ```ts
-import { Mutex, SqliteStore } from '@zukhruf/mutex';
+import { Mutex } from '@zukhruf/mutex';
+import { SqliteStore } from '@zukhruf/mutex/sqlite';
 ```
 
 ## Development

package/dist/index.d.ts

@@ -7,19 +7,4 @@ export type { Acquired, AcquireMode, ModeResult, NotAcquired, Outcome, OutcomeRe
 export { Modes } from './mutex/acquire-modes/modes.ts';
 export { WaitMode } from './mutex/acquire-modes/wait-mode.ts';
 export { SkipIfBusyMode, type SkipIfBusyOptions, } from './mutex/acquire-modes/skip-if-busy-mode.ts';
-export { MemoryStore, type MemoryStoreOptions, } from './lock-stores/memory/memory-store.ts';
-export { ThreadLockCoordinator, type ThreadLockCoordinatorOptions, } from './lock-stores/thread/thread-lock-coordinator.ts';
-export { ThreadStore } from './lock-stores/thread/thread-store.ts';
-export { IpcLockCoordinator, type IpcLockCoordinatorOptions, } from './lock-stores/ipc/ipc-lock-coordinator.ts';
-export { IpcStore } from './lock-stores/ipc/ipc-store.ts';
-export { CoordinatorUnavailableError } from './lock-stores/remote/coordinator-unavailable-error.ts';
-export { GrantFailedError } from './lock-stores/remote/grant-failed-error.ts';
-export { UnsupportedRequestError } from './lock-stores/remote/unsupported-request-error.ts';
-export { NetworkDirectoryError } from '@zukhruf/fs';
-export { FileLockStore, type FileLockStoreOptions, } from './lock-stores/file-system/file-lock-store.ts';
-export { TicketQueueFileStore } from './lock-stores/file-system/ticket-queue-file-store.ts';
-export { LockFileStore } from './lock-stores/file-system/lock-file-store.ts';
-export { SqliteStore } from './lock-stores/sqlite/sqlite-store.ts';
-export { ProtocolVersionError } from './lock-stores/socket/protocol-version-error.ts';
-export { SocketStore, type SocketRole, type SocketStoreOptions, } from './lock-stores/socket/socket-store.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EACV,QAAQ,EACR,WAAW,EACX,UAAU,EACV,WAAW,EACX,OAAO,EACP,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,KAAK,iBAAiB,GACvB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,GACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,uDAAuD,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,GAC1B,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AACtF,OAAO,EACL,WAAW,EACX,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EACV,QAAQ,EACR,WAAW,EACX,UAAU,EACV,WAAW,EACX,OAAO,EACP,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,KAAK,iBAAiB,GACvB,MAAM,4CAA4C,CAAC"}

package/dist/index.js

@@ -5,19 +5,4 @@ export { LeaseLostError } from '@zukhruf/lease';
 export { Modes } from "./mutex/acquire-modes/modes.js";
 export { WaitMode } from "./mutex/acquire-modes/wait-mode.js";
 export { SkipIfBusyMode, } from "./mutex/acquire-modes/skip-if-busy-mode.js";
-export { MemoryStore, } from "./lock-stores/memory/memory-store.js";
-export { ThreadLockCoordinator, } from "./lock-stores/thread/thread-lock-coordinator.js";
-export { ThreadStore } from "./lock-stores/thread/thread-store.js";
-export { IpcLockCoordinator, } from "./lock-stores/ipc/ipc-lock-coordinator.js";
-export { IpcStore } from "./lock-stores/ipc/ipc-store.js";
-export { CoordinatorUnavailableError } from "./lock-stores/remote/coordinator-unavailable-error.js";
-export { GrantFailedError } from "./lock-stores/remote/grant-failed-error.js";
-export { UnsupportedRequestError } from "./lock-stores/remote/unsupported-request-error.js";
-export { NetworkDirectoryError } from '@zukhruf/fs';
-export { FileLockStore, } from "./lock-stores/file-system/file-lock-store.js";
-export { TicketQueueFileStore } from "./lock-stores/file-system/ticket-queue-file-store.js";
-export { LockFileStore } from "./lock-stores/file-system/lock-file-store.js";
-export { SqliteStore } from "./lock-stores/sqlite/sqlite-store.js";
-export { ProtocolVersionError } from "./lock-stores/socket/protocol-version-error.js";
-export { SocketStore, } from "./lock-stores/socket/socket-store.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAmB,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAShD,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EACL,cAAc,GAEf,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EACL,WAAW,GAEZ,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,qBAAqB,GAEtB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EACL,kBAAkB,GAEnB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,uDAAuD,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,aAAa,GAEd,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AACtF,OAAO,EACL,WAAW,GAGZ,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAmB,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAShD,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EACL,cAAc,GAEf,MAAM,4CAA4C,CAAC"}

package/dist/lock-stores/file-system/index.d.ts

@@ -0,0 +1,5 @@
+export { FileLockStore, type FileLockStoreOptions } from './file-lock-store.ts';
+export { LockFileStore } from './lock-file-store.ts';
+export { TicketQueueFileStore } from './ticket-queue-file-store.ts';
+export { NetworkDirectoryError } from '@zukhruf/fs';
+//# sourceMappingURL=index.d.ts.map

package/dist/lock-stores/file-system/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/file-system/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/lock-stores/file-system/index.js

@@ -0,0 +1,5 @@
+export { FileLockStore } from "./file-lock-store.js";
+export { LockFileStore } from "./lock-file-store.js";
+export { TicketQueueFileStore } from "./ticket-queue-file-store.js";
+export { NetworkDirectoryError } from '@zukhruf/fs';
+//# sourceMappingURL=index.js.map

package/dist/lock-stores/file-system/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lock-stores/file-system/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA6B,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,5 @@
+export { IpcLockCoordinator, type IpcLockCoordinatorOptions, } from './ipc-lock-coordinator.ts';
+export { IpcStore } from './ipc-store.ts';
+export { CoordinatorUnavailableError } from '../remote/coordinator-unavailable-error.ts';
+export { GrantFailedError } from '../remote/grant-failed-error.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/ipc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

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

@@ -0,0 +1,5 @@
+export { IpcLockCoordinator, } from "./ipc-lock-coordinator.js";
+export { IpcStore } from "./ipc-store.js";
+export { CoordinatorUnavailableError } from "../remote/coordinator-unavailable-error.js";
+export { GrantFailedError } from "../remote/grant-failed-error.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lock-stores/ipc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAEnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,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/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,47 @@
+import type { LockHandle } from '../../mutex/lease.ts';
+import type { AcquireOptions, LockStore } from '../../mutex/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 implements LockStore {
+    #private;
+    constructor(options: PostgresStoreOptions);
+    acquire(key: string, options?: AcquireOptions): Promise<LockHandle>;
+    tryAcquire(key: string): Promise<LockHandle | undefined>;
+    /** Reads `pg_locks` on a short session, and never runs an advisory lock function. */
+    isHeld(key: string): Promise<boolean>;
+}
+//# 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":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG3E;;;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;AAWD;;;;;;;;;GASG;AACH,qBAAa,aAAc,YAAW,SAAS;;gBAIjC,OAAO,EAAE,oBAAoB;IAInC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAUnE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAU9D,qFAAqF;IAC/E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAkC5C"}

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

@@ -0,0 +1,254 @@
+import { createHash } from 'node:crypto';
+import { setTimeout as delay } from 'node:timers/promises';
+import { untilAborted } from '@zukhruf/async';
+import { FencingToken } from '@zukhruf/fencing';
+import { LeaseController } from '@zukhruf/lease';
+import { MemoryStore } from "../memory/memory-store.js";
+const heldQuery = `SELECT EXISTS (
+  SELECT 1 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
+) 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 {
+    #inProcess = new MemoryStore();
+    #options;
+    constructor(options) {
+        this.#options = options;
+    }
+    async acquire(key, options) {
+        const signal = options?.signal;
+        await using turn = new AsyncDisposableStack();
+        // Joining the in-process queue is synchronous, so the order is the order of the calls.
+        turn.use(await this.#inProcess.acquire(key, { signal }));
+        const session = await this.#session(key, signal);
+        await session.wait(signal);
+        return withTurn(await session.hold(), turn);
+    }
+    async tryAcquire(key) {
+        await using turn = new AsyncDisposableStack();
+        const inProcess = await this.#inProcess.tryAcquire(key);
+        if (!inProcess)
+            return undefined;
+        turn.use(inProcess);
+        const session = await this.#session(key, undefined);
+        if (!(await session.try()))
+            return undefined;
+        return withTurn(await session.hold(), turn);
+    }
+    /** Reads `pg_locks` on a short session, and never runs an advisory lock function. */
+    async isHeld(key) {
+        const session = new OwnedSession(await this.#options.connect());
+        try {
+            const [row] = await session.query(heldQuery, [lockNumber(key)]);
+            session.giveBack();
+            return row?.held === true;
+        }
+        catch (error) {
+            session.destroy();
+            throw error;
+        }
+    }
+    /** Gets a session for `key`. A cancel never waits for the pool: a session that comes later goes back at once. */
+    async #session(key, signal) {
+        const connecting = this.#options.connect();
+        try {
+            return new KeySession(new OwnedSession(await untilAborted(connecting, signal)), key, this.#options);
+        }
+        catch (error) {
+            if (signal?.aborted && error === signal.reason) {
+                void connecting.then((late) => late.release(false), () => { });
+            }
+            throw error;
+        }
+    }
+}
+/**
+ * The number of the advisory lock of `key`: the first 8 bytes of the SHA-256
+ * digest of its UTF-16 code units, as a signed 64-bit integer. The code units,
+ * not UTF-8, so that keys that differ only in a lone surrogate get different
+ * numbers. Sent as text, because a JavaScript number cannot hold 64 bits.
+ */
+function lockNumber(key) {
+    return createHash('sha256')
+        .update(Buffer.from(key, 'utf16le'))
+        .digest()
+        .readBigInt64BE(0)
+        .toString();
+}
+/**
+ * A session from `connect` that the store owns until it gives it back or
+ * destroys it, once. Its `ended` signal aborts when the session emits `error`
+ * or `end`. Its listeners stay on a destroyed session, because node-postgres
+ * can emit `error` again after the close.
+ */
+class OwnedSession {
+    #session;
+    #ended = new AbortController();
+    #owned = new AbortController();
+    #onError = (error) => this.#ended.abort(error);
+    #onEnd = () => this.#ended.abort(new Error('The Postgres session ended.'));
+    constructor(session) {
+        this.#session = session;
+        session.on('error', this.#onError);
+        session.on('end', this.#onEnd);
+    }
+    get ended() {
+        return this.#ended.signal;
+    }
+    async query(text, values) {
+        return (await this.#session.query(text, values)).rows;
+    }
+    /** The session holds nothing: it goes back to the pool with its own settings. */
+    giveBack() {
+        if (this.#owned.signal.aborted)
+            return;
+        this.#owned.abort();
+        this.#session.off('error', this.#onError);
+        this.#session.off('end', this.#onEnd);
+        this.#session.release(false);
+    }
+    /** The lock state of the session is not known: the server releases each lock of a session that ends. */
+    destroy() {
+        if (this.#owned.signal.aborted)
+            return;
+        this.#owned.abort();
+        this.#session.release(true);
+    }
+}
+/** One session for one key: it waits for the lock or tries it, then holds it with a heartbeat. */
+class KeySession {
+    #session;
+    #key;
+    #number;
+    #options;
+    #lease;
+    /** Aborts when the store stops holding: a release, or a lost session. */
+    #done = new AbortController();
+    constructor(session, key, options) {
+        this.#session = session;
+        this.#key = key;
+        this.#number = lockNumber(key);
+        this.#options = options;
+        this.#lease = new LeaseController(key);
+    }
+    /** Waits in Postgres' lock queue. A cancel closes the session, and the end of the session releases a late grant. */
+    async wait(signal) {
+        try {
+            // A timeout of the pool must not stop the wait.
+            await this.#session.query('SET statement_timeout = 0; SET lock_timeout = 0', []);
+            await untilAborted(this.#session.query('SELECT pg_advisory_lock($1::bigint)', [
+                this.#number,
+            ]), signal);
+        }
+        catch (error) {
+            this.#session.destroy();
+            throw error;
+        }
+    }
+    async try() {
+        try {
+            const [row] = await this.#session.query('SELECT pg_try_advisory_lock($1::bigint) AS locked', [this.#number]);
+            if (row?.locked === true)
+                return true;
+        }
+        catch (error) {
+            this.#session.destroy();
+            throw error;
+        }
+        this.#session.giveBack();
+        return false;
+    }
+    /** Mints the token of a granted lock and starts the heartbeat. A failed mint releases the key. */
+    async hold() {
+        let token;
+        try {
+            const [row] = await this.#session.query('SELECT nextval($1::regclass)::text AS token', [this.#options.sequence]);
+            if (typeof row?.token !== 'string') {
+                throw new Error(`nextval of sequence ${JSON.stringify(this.#options.sequence)} gave no number.`);
+            }
+            token = new FencingToken(BigInt(row.token));
+        }
+        catch (error) {
+            await this.#release();
+            throw error;
+        }
+        const ended = this.#session.ended;
+        ended.addEventListener('abort', () => this.#lose(ended.reason), {
+            once: true,
+            signal: this.#done.signal,
+        });
+        void this.#beat();
+        return {
+            token,
+            signal: this.#lease.signal,
+            [Symbol.asyncDispose]: () => this.#release(),
+        };
+    }
+    /** Sends `SELECT 1` each interval. 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 });
+                await untilAborted(this.#session.query('SELECT 1', []), AbortSignal.any([done, AbortSignal.timeout(interval)]));
+            }
+        }
+        catch (cause) {
+            if (!done.aborted)
+                this.#lose(cause);
+        }
+    }
+    /** Another holder can have the key now. */
+    #lose(cause) {
+        if (this.#done.signal.aborted)
+            return;
+        this.#done.abort();
+        this.#lease.lose(cause);
+        this.#session.destroy();
+    }
+    async #release() {
+        if (this.#done.signal.aborted)
+            return;
+        this.#done.abort();
+        try {
+            const [row] = await this.#session.query('SELECT pg_advisory_unlock($1::bigint) AS released', [this.#number]);
+            if (row?.released !== true) {
+                throw new Error(`The session did not hold the lock of ${JSON.stringify(this.#key)}.`);
+            }
+            await this.#session.query('RESET statement_timeout; RESET lock_timeout', []);
+        }
+        catch (cause) {
+            // A plain release would give the next borrower a lock that this session may still hold.
+            this.#lease.lose(cause);
+            this.#session.destroy();
+            return;
+        }
+        this.#lease.end();
+        this.#session.giveBack();
+    }
+}
+/** Releases the Postgres lock first, then lets the next caller in this process continue. */
+function withTurn(handle, turn) {
+    turn.use(handle);
+    const release = turn.move();
+    return {
+        token: handle.token,
+        signal: handle.signal,
+        [Symbol.asyncDispose]: () => release.disposeAsync(),
+    };
+}
+//# sourceMappingURL=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/socket/index.d.ts

@@ -0,0 +1,7 @@
+export { SocketStore, type SocketRole, type SocketStoreOptions, } from './socket-store.ts';
+export { ProtocolVersionError } from './protocol-version-error.ts';
+export { UnsupportedRequestError } from '../remote/unsupported-request-error.ts';
+export { CoordinatorUnavailableError } from '../remote/coordinator-unavailable-error.ts';
+export { GrantFailedError } from '../remote/grant-failed-error.ts';
+export { NetworkDirectoryError } from '@zukhruf/fs';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/socket/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,7 @@
+export { SocketStore, } from "./socket-store.js";
+export { ProtocolVersionError } from "./protocol-version-error.js";
+export { UnsupportedRequestError } from "../remote/unsupported-request-error.js";
+export { CoordinatorUnavailableError } from "../remote/coordinator-unavailable-error.js";
+export { GrantFailedError } from "../remote/grant-failed-error.js";
+export { NetworkDirectoryError } from '@zukhruf/fs';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lock-stores/socket/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAGZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,4 @@
+export { SqliteStore } from './sqlite-store.ts';
+export type { FileLockStoreOptions } from '../file-system/file-lock-store.ts';
+export { NetworkDirectoryError } from '@zukhruf/fs';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/sqlite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,3 @@
+export { SqliteStore } from "./sqlite-store.js";
+export { NetworkDirectoryError } from '@zukhruf/fs';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lock-stores/sqlite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,5 @@
+export { ThreadLockCoordinator, type ThreadLockCoordinatorOptions, } from './thread-lock-coordinator.ts';
+export { ThreadStore } from './thread-store.ts';
+export { CoordinatorUnavailableError } from '../remote/coordinator-unavailable-error.ts';
+export { GrantFailedError } from '../remote/grant-failed-error.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lock-stores/thread/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

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

@@ -0,0 +1,5 @@
+export { ThreadLockCoordinator, } from "./thread-lock-coordinator.js";
+export { ThreadStore } from "./thread-store.js";
+export { CoordinatorUnavailableError } from "../remote/coordinator-unavailable-error.js";
+export { GrantFailedError } from "../remote/grant-failed-error.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lock-stores/thread/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAEtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zukhruf/mutex",
-  "version": "0.3.38",
+  "version": "0.3.40",
   "description": "A mutex with interchangeable lock stores, from one object to every process on a host, with fencing tokens on every lease.",
   "license": "MIT",
   "repository": {
@@ -26,6 +26,13 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./remote": null,
+    "./*": {
+      "@zukhruf/source": "./src/lock-stores/*/index.ts",
+      "types": "./dist/lock-stores/*/index.d.ts",
+      "import": "./dist/lock-stores/*/index.js",
+      "default": "./dist/lock-stores/*/index.js"
     }
   },
   "files": [
@@ -38,14 +45,16 @@
     "access": "public"
   },
   "dependencies": {
-    "@zukhruf/async": "^0.3.38",
-    "@zukhruf/election": "^0.3.38",
-    "@zukhruf/fencing": "^0.3.38",
-    "@zukhruf/fs": "^0.3.38",
-    "@zukhruf/lease": "^0.3.38"
+    "@zukhruf/async": "^0.3.40",
+    "@zukhruf/election": "^0.3.40",
+    "@zukhruf/fencing": "^0.3.40",
+    "@zukhruf/fs": "^0.3.40",
+    "@zukhruf/lease": "^0.3.40"
   },
   "devDependencies": {
-    "@zukhruf/testing": "^0.3.38",
-    "hono": "^4.13.13"
+    "@types/pg": "^8.23.1",
+    "@zukhruf/testing": "^0.3.40",
+    "hono": "^4.13.13",
+    "pg": "^8.23.1"
   }
 }