velocious 1.0.590 → 1.0.591

package/build/src/testing/shared-transaction-broker-client.js

@@ -0,0 +1,105 @@
+// @ts-check
+import WebSocket from "ws";
+import { decodeBrokerValue, encodeBrokerValue } from "./shared-transaction-codec.js";
+export default class SharedTransactionBrokerClient {
+    /**
+     * Creates a broker client.
+     * @param {{address: string, capability: string, databaseIdentifier: string}} args - Broker coordinates.
+     */
+    constructor({ address, capability, databaseIdentifier }) {
+        this.capability = capability;
+        this.databaseIdentifier = databaseIdentifier;
+        this.nextRequestId = 1;
+        /** @type {Map<number, {reject: (error: Error) => void, resolve: (value: ReturnType<typeof decodeBrokerValue>) => void}>} */
+        this.pending = new Map();
+        this.socket = new WebSocket(address);
+        this.connectionPromise = new Promise((resolve, reject) => {
+            this.socket.once("open", resolve);
+            this.socket.once("error", reject);
+        });
+        this.socket.on("message", (data) => this.handleMessage(`${data}`));
+        this.socket.once("close", () => this.rejectPending(new Error("Shared transaction broker connection closed")));
+        this.socket.on("error", (error) => this.rejectPending(error));
+    }
+    /**
+     * Waits for the websocket to open.
+     * @returns {Promise<void>} - Resolves after the websocket opens.
+     */
+    async connected() { await this.connectionPromise; }
+    /**
+     * Calls one physical connection operation.
+     * @param {string} method - Broker operation.
+     * @param {Array<ReturnType<typeof JSON.parse>>} args - Operation arguments.
+     * @returns {Promise<ReturnType<typeof decodeBrokerValue>>} - Remote result.
+     */
+    async call(method, args) {
+        await this.connected();
+        if (this.socket.readyState !== WebSocket.OPEN)
+            throw new Error("Shared transaction broker connection is closed");
+        const requestId = this.nextRequestId++;
+        const response = new Promise((resolve, reject) => this.pending.set(requestId, { resolve, reject }));
+        this.socket.send(JSON.stringify({
+            requestId,
+            capability: this.capability,
+            databaseIdentifier: this.databaseIdentifier,
+            method,
+            args: encodeBrokerValue(args)
+        }), (error) => {
+            if (!error)
+                return;
+            const pending = this.pending.get(requestId);
+            this.pending.delete(requestId);
+            pending?.reject(error);
+        });
+        return await response;
+    }
+    /**
+     * Handles a correlated broker response.
+     * @param {string} serialized - Serialized response.
+     * @returns {void} - No return value.
+     */
+    handleMessage(serialized) {
+        const response = /** @type {{requestId: number, result?: import("./shared-transaction-codec.js").EncodedBrokerValue, error?: import("./shared-transaction-codec.js").EncodedBrokerValue}} */ (JSON.parse(serialized));
+        const pending = this.pending.get(response.requestId);
+        if (!pending)
+            return;
+        this.pending.delete(response.requestId);
+        if (response.error) {
+            const error = decodeBrokerValue(response.error);
+            pending.reject(error instanceof Error ? error : new Error(String(error)));
+        }
+        else if (response.result) {
+            pending.resolve(decodeBrokerValue(response.result));
+        }
+        else {
+            pending.reject(new Error("Invalid shared transaction broker response"));
+        }
+    }
+    /**
+     * Rejects every pending call after disconnect.
+     * @param {Error} error - Disconnect error.
+     * @returns {void} - No return value.
+     */
+    rejectPending(error) {
+        for (const { reject } of this.pending.values())
+            reject(error);
+        this.pending.clear();
+    }
+    /**
+     * Closes the client without touching the parent connection.
+     * @returns {Promise<void>} - Resolves after the websocket closes.
+     */
+    async close() {
+        if (this.socket.readyState === WebSocket.CLOSED)
+            return;
+        if (this.socket.readyState === WebSocket.CONNECTING) {
+            this.socket.terminate();
+            return;
+        }
+        await new Promise((resolve) => {
+            this.socket.once("close", resolve);
+            this.socket.close();
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2hhcmVkLXRyYW5zYWN0aW9uLWJyb2tlci1jbGllbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvdGVzdGluZy9zaGFyZWQtdHJhbnNhY3Rpb24tYnJva2VyLWNsaWVudC5qcyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxZQUFZO0FBRVosT0FBTyxTQUFTLE1BQU0sSUFBSSxDQUFBO0FBQzFCLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxpQkFBaUIsRUFBRSxNQUFNLCtCQUErQixDQUFBO0FBRXBGLE1BQU0sQ0FBQyxPQUFPLE9BQU8sNkJBQTZCO0lBQ2hEOzs7T0FHRztJQUNILFlBQVksRUFBQyxPQUFPLEVBQUUsVUFBVSxFQUFFLGtCQUFrQixFQUFDO1FBQ25ELElBQUksQ0FBQyxVQUFVLEdBQUcsVUFBVSxDQUFBO1FBQzVCLElBQUksQ0FBQyxrQkFBa0IsR0FBRyxrQkFBa0IsQ0FBQTtRQUM1QyxJQUFJLENBQUMsYUFBYSxHQUFHLENBQUMsQ0FBQTtRQUN0Qiw0SEFBNEg7UUFDNUgsSUFBSSxDQUFDLE9BQU8sR0FBRyxJQUFJLEdBQUcsRUFBRSxDQUFBO1FBQ3hCLElBQUksQ0FBQyxNQUFNLEdBQUcsSUFBSSxTQUFTLENBQUMsT0FBTyxDQUFDLENBQUE7UUFDcEMsSUFBSSxDQUFDLGlCQUFpQixHQUFHLElBQUksT0FBTyxDQUFDLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxFQUFFO1lBQ3ZELElBQUksQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxPQUFPLENBQUMsQ0FBQTtZQUNqQyxJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxPQUFPLEVBQUUsTUFBTSxDQUFDLENBQUE7UUFDbkMsQ0FBQyxDQUFDLENBQUE7UUFDRixJQUFJLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQyxTQUFTLEVBQUUsQ0FBQyxJQUFJLEVBQUUsRUFBRSxDQUFDLElBQUksQ0FBQyxhQUFhLENBQUMsR0FBRyxJQUFJ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O1FBQ3JELENBQUM7YUFBTSxDQUFDO1lBQ04sT0FBTyxDQUFDLE1BQU0sQ0FBQyxJQUFJLEtBQUssQ0FBQyw0Q0FBNEMsQ0FBQyxDQUFDLENBQUE7UUFDekUsQ0FBQztJQUNILENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsYUFBYSxDQUFDLEtBQUs7UUFDakIsS0FBSyxNQUFNLEVBQUMsTUFBTSxFQUFDLElBQUksSUFBSSxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUU7WUFBRSxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUE7UUFDM0QsSUFBSSxDQUFDLE9BQU8sQ0FBQyxLQUFLLEVBQUUsQ0FBQTtJQUN0QixDQUFDO0lBRUQ7OztPQUdHO0lBQ0gsS0FBSyxDQUFDLEtBQUs7UUFDVCxJQUFJLElBQUksQ0FBQyxNQUFNLENBQUMsVUFBVSxLQUFLLFNBQVMsQ0FBQyxNQUFNO1lBQUUsT0FBTTtRQUN2RCxJQUFJLElBQUksQ0FBQyxNQUFNLENBQUMsVUFBVSxLQUFLLFNBQVMsQ0FBQyxVQUFVLEVBQUUsQ0FBQztZQUNwRCxJQUFJLENBQUMsTUFBTSxDQUFDLFNBQVMsRUFBRSxDQUFBO1lBQ3ZCLE9BQU07UUFDUixDQUFDO1FBQ0QsTUFBTSxJQUFJLE9BQU8sQ0FBQyxDQUFDLE9BQU8sRUFBRSxFQUFFO1lBQzVCLElBQUksQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLE9BQU8sRUFBRSxPQUFPLENBQUMsQ0FBQTtZQUNsQyxJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssRUFBRSxDQUFBO1FBQ3JCLENBQUMsQ0FBQyxDQUFBO0lBQ0osQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQHRzLWNoZWNrXG5cbmltcG9ydCBXZWJTb2NrZXQgZnJvbSBcIndzXCJcbmltcG9ydCB7IGRlY29kZUJyb2tlclZhbHVlLCBlbmNvZGVCcm9rZXJWYWx1ZSB9IGZyb20gXCIuL3NoYXJlZC10cmFuc2FjdGlvbi1jb2RlYy5qc1wiXG5cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIFNoYXJlZFRyYW5zYWN0aW9uQnJva2VyQ2xpZW50IHtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYSBicm9rZXIgY2xpZW50LlxuICAgKiBAcGFyYW0ge3thZGRyZXNzOiBzdHJpbmcsIGNhcGFiaWxpdHk6IHN0cmluZywgZGF0YWJhc2VJZGVudGlmaWVyOiBzdHJpbmd9fSBhcmdzIC0gQnJva2VyIGNvb3JkaW5hdGVzLlxuICAgKi9cbiAgY29uc3RydWN0b3Ioe2FkZHJlc3MsIGNhcGFiaWxpdHksIGRhdGFiYXNlSWRlbnRpZmllcn0pIHtcbiAgICB0aGlzLmNhcGFiaWxpdHkgPSBjYXBhYmlsaXR5XG4gICAgdGhpcy5kYXRhYmFzZUlkZW50aWZpZXIgPSBkYXRhYmFzZUlkZW50aWZpZXJcbiAgICB0aGlzLm5leHRSZXF1ZXN0SWQgPSAxXG4gICAgLyoqIEB0eXBlIHtNYXA8bnVtYmVyLCB7cmVqZWN0OiAoZXJyb3I6IEVycm9yKSA9PiB2b2lkLCByZXNvbHZlOiAodmFsdWU6IFJldHVyblR5cGU8dHlwZW9mIGRlY29kZUJyb2tlclZhbHVlPikgPT4gdm9pZH0+fSAqL1xuICAgIHRoaXMucGVuZGluZyA9IG5ldyBNYXAoKVxuICAgIHRoaXMuc29ja2V0ID0gbmV3IFdlYlNvY2tldChhZGRyZXNzKVxuICAgIHRoaXMuY29ubmVjdGlvblByb21pc2UgPSBuZXcgUHJvbWlzZSgocmVzb2x2ZSwgcmVqZWN0KSA9PiB7XG4gICAgICB0aGlzLnNvY2tldC5vbmNlKFwib3BlblwiLCByZXNvbHZlKVxuICAgICAgdGhpcy5zb2NrZXQub25jZShcImVycm9yXCIsIHJlamVjdClcbiAgICB9KVxuICAgIHRoaXMuc29ja2V0Lm9uKFwibWVzc2FnZVwiLCAoZGF0YSkgPT4gdGhpcy5oYW5kbGVNZXNzYWdlKGAke2RhdGF9YCkpXG4gICAgdGhpcy5zb2NrZXQub25jZShcImNsb3NlXCIsICgpID0+IHRoaXMucmVqZWN0UGVuZGluZyhuZXcgRXJyb3IoXCJTaGFyZWQgdHJhbnNhY3Rpb24gYnJva2VyIGNvbm5lY3Rpb24gY2xvc2VkXCIpKSlcbiAgICB0aGlzLnNvY2tldC5vbihcImVycm9yXCIsIChlcnJvcikgPT4gdGhpcy5yZWplY3RQZW5kaW5nKGVycm9yKSlcbiAgfVxuXG4gIC8qKlxuICAgKiBXYWl0cyBmb3IgdGhlIHdlYnNvY2tldCB0byBvcGVuLlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTx2b2lkPn0gLSBSZXNvbHZlcyBhZnRlciB0aGUgd2Vic29ja2V0IG9wZW5zLlxuICAgKi9cbiAgYXN5bmMgY29ubmVjdGVkKCkgeyBhd2FpdCB0aGlzLmNvbm5lY3Rpb25Qcm9taXNlIH1cblxuICAvKipcbiAgICogQ2FsbHMgb25lIHBoeXNpY2FsIGNvbm5lY3Rpb24gb3BlcmF0aW9uLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gbWV0aG9kIC0gQnJva2VyIG9wZXJhdGlvbi5cbiAgICogQHBhcmFtIHtBcnJheTxSZXR1cm5UeXBlPHR5cGVvZiBKU09OLnBhcnNlPj59IGFyZ3MgLSBPcGVyYXRpb24gYXJndW1lbnRzLlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTxSZXR1cm5UeXBlPHR5cGVvZiBkZWNvZGVCcm9rZXJWYWx1ZT4+fSAtIFJlbW90ZSByZXN1bHQuXG4gICAqL1xuICBhc3luYyBjYWxsKG1ldGhvZCwgYXJncykge1xuICAgIGF3YWl0IHRoaXMuY29ubmVjdGVkKClcbiAgICBpZiAodGhpcy5zb2NrZXQucmVhZHlTdGF0ZSAhPT0gV2ViU29ja2V0Lk9QRU4pIHRocm93IG5ldyBFcnJvcihcIlNoYXJlZCB0cmFuc2FjdGlvbiBicm9rZXIgY29ubmVjdGlvbiBpcyBjbG9zZWRcIilcbiAgICBjb25zdCByZXF1ZXN0SWQgPSB0aGlzLm5leHRSZXF1ZXN0SWQrK1xuICAgIGNvbnN0IHJlc3BvbnNlID0gbmV3IFByb21pc2UoKHJlc29sdmUsIHJlamVjdCkgPT4gdGhpcy5wZW5kaW5nLnNldChyZXF1ZXN0SWQsIHtyZXNvbHZlLCByZWplY3R9KSlcblxuICAgIHRoaXMuc29ja2V0LnNlbmQoSlNPTi5zdHJpbmdpZnkoe1xuICAgICAgcmVxdWVzdElkLFxuICAgICAgY2FwYWJpbGl0eTogdGhpcy5jYXBhYmlsaXR5LFxuICAgICAgZGF0YWJhc2VJZGVudGlmaWVyOiB0aGlzLmRhdGFiYXNlSWRlbnRpZmllcixcbiAgICAgIG1ldGhvZCxcbiAgICAgIGFyZ3M6IGVuY29kZUJyb2tlclZhbHVlKGFyZ3MpXG4gICAgfSksIChlcnJvcikgPT4ge1xuICAgICAgaWYgKCFlcnJvcikgcmV0dXJuXG4gICAgICBjb25zdCBwZW5kaW5nID0gdGhpcy5wZW5kaW5nLmdldChyZXF1ZXN0SWQpXG4gICAgICB0aGlzLnBlbmRpbmcuZGVsZXRlKHJlcXVlc3RJZClcbiAgICAgIHBlbmRpbmc/LnJlamVjdChlcnJvcilcbiAgICB9KVxuXG4gICAgcmV0dXJuIGF3YWl0IHJlc3BvbnNlXG4gIH1cblxuICAvKipcbiAgICogSGFuZGxlcyBhIGNvcnJlbGF0ZWQgYnJva2VyIHJlc3BvbnNlLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gc2VyaWFsaXplZCAtIFNlcmlhbGl6ZWQgcmVzcG9uc2UuXG4gICAqIEByZXR1cm5zIHt2b2lkfSAtIE5vIHJldHVybiB2YWx1ZS5cbiAgICovXG4gIGhhbmRsZU1lc3NhZ2Uoc2VyaWFsaXplZCkge1xuICAgIGNvbnN0IHJlc3BvbnNlID0gLyoqIEB0eXBlIHt7cmVxdWVzdElkOiBudW1iZXIsIHJlc3VsdD86IGltcG9ydChcIi4vc2hhcmVkLXRyYW5zYWN0aW9uLWNvZGVjLmpzXCIpLkVuY29kZWRCcm9rZXJWYWx1ZSwgZXJyb3I/OiBpbXBvcnQoXCIuL3NoYXJlZC10cmFuc2FjdGlvbi1jb2RlYy5qc1wiKS5FbmNvZGVkQnJva2VyVmFsdWV9fSAqLyAoSlNPTi5wYXJzZShzZXJpYWxpemVkKSlcbiAgICBjb25zdCBwZW5kaW5nID0gdGhpcy5wZW5kaW5nLmdldChyZXNwb25zZS5yZXF1ZXN0SWQpXG4gICAgaWYgKCFwZW5kaW5nKSByZXR1cm5cbiAgICB0aGlzLnBlbmRpbmcuZGVsZXRlKHJlc3BvbnNlLnJlcXVlc3RJZClcblxuICAgIGlmIChyZXNwb25zZS5lcnJvcikge1xuICAgICAgY29uc3QgZXJyb3IgPSBkZWNvZGVCcm9rZXJWYWx1ZShyZXNwb25zZS5lcnJvcilcbiAgICAgIHBlbmRpbmcucmVqZWN0KGVycm9yIGluc3RhbmNlb2YgRXJyb3IgPyBlcnJvciA6IG5ldyBFcnJvcihTdHJpbmcoZXJyb3IpKSlcbiAgICB9IGVsc2UgaWYgKHJlc3BvbnNlLnJlc3VsdCkge1xuICAgICAgcGVuZGluZy5yZXNvbHZlKGRlY29kZUJyb2tlclZhbHVlKHJlc3BvbnNlLnJlc3VsdCkpXG4gICAgfSBlbHNlIHtcbiAgICAgIHBlbmRpbmcucmVqZWN0KG5ldyBFcnJvcihcIkludmFsaWQgc2hhcmVkIHRyYW5zYWN0aW9uIGJyb2tlciByZXNwb25zZVwiKSlcbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogUmVqZWN0cyBldmVyeSBwZW5kaW5nIGNhbGwgYWZ0ZXIgZGlzY29ubmVjdC5cbiAgICogQHBhcmFtIHtFcnJvcn0gZXJyb3IgLSBEaXNjb25uZWN0IGVycm9yLlxuICAgKiBAcmV0dXJucyB7dm9pZH0gLSBObyByZXR1cm4gdmFsdWUuXG4gICAqL1xuICByZWplY3RQZW5kaW5nKGVycm9yKSB7XG4gICAgZm9yIChjb25zdCB7cmVqZWN0fSBvZiB0aGlzLnBlbmRpbmcudmFsdWVzKCkpIHJlamVjdChlcnJvcilcbiAgICB0aGlzLnBlbmRpbmcuY2xlYXIoKVxuICB9XG5cbiAgLyoqXG4gICAqIENsb3NlcyB0aGUgY2xpZW50IHdpdGhvdXQgdG91Y2hpbmcgdGhlIHBhcmVudCBjb25uZWN0aW9uLlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTx2b2lkPn0gLSBSZXNvbHZlcyBhZnRlciB0aGUgd2Vic29ja2V0IGNsb3Nlcy5cbiAgICovXG4gIGFzeW5jIGNsb3NlKCkge1xuICAgIGlmICh0aGlzLnNvY2tldC5yZWFkeVN0YXRlID09PSBXZWJTb2NrZXQuQ0xPU0VEKSByZXR1cm5cbiAgICBpZiAodGhpcy5zb2NrZXQucmVhZHlTdGF0ZSA9PT0gV2ViU29ja2V0LkNPTk5FQ1RJTkcpIHtcbiAgICAgIHRoaXMuc29ja2V0LnRlcm1pbmF0ZSgpXG4gICAgICByZXR1cm5cbiAgICB9XG4gICAgYXdhaXQgbmV3IFByb21pc2UoKHJlc29sdmUpID0+IHtcbiAgICAgIHRoaXMuc29ja2V0Lm9uY2UoXCJjbG9zZVwiLCByZXNvbHZlKVxuICAgICAgdGhpcy5zb2NrZXQuY2xvc2UoKVxuICAgIH0pXG4gIH1cbn1cbiJdfQ==

package/build/src/testing/shared-transaction-broker.d.ts

@@ -0,0 +1,153 @@
+import { EventEmitter } from "node:events";
+export type ConnectionState = {
+    queue: Promise<void>;
+    rootSessions: Set<import("ws").WebSocket>;
+    lease?: {
+        operations: Promise<void>;
+        release: () => void;
+        savePointName: string;
+        socket: import("ws").WebSocket;
+    };
+};
+export default class SharedTransactionBroker extends EventEmitter {
+    connections: Record<string, object>;
+    secret: string;
+    accepting: boolean;
+    /** @type {Map<object, ConnectionState>} */
+    connectionStates: Map<object, ConnectionState>;
+    /** @type {Set<import("ws").WebSocket>} */
+    sessions: Set<import("ws").WebSocket>;
+    /** @type {Map<import("ws").WebSocket, Promise<void>>} */
+    sessionCleanup: Map<import("ws").WebSocket, Promise<void>>;
+    /** @type {Array<Error>} */
+    cleanupErrors: Array<Error>;
+    /** @type {Promise<void> | undefined} */
+    closePromise: Promise<void> | undefined;
+    /** @type {Map<object, (callback: () => Promise<ReturnType<typeof JSON.parse>>) => Promise<ReturnType<typeof JSON.parse>>>} */
+    connectionCoordinators: Map<object, (callback: () => Promise<ReturnType<typeof JSON.parse>>) => Promise<ReturnType<typeof JSON.parse>>>;
+    httpServer: import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
+    websocketServer: import("ws").Server<typeof import("ws").WebSocket, typeof import("node:http").IncomingMessage>;
+    /**
+     * Creates a broker around parent-owned physical connections.
+     * @param {{connections: Record<string, object>}} args - Parent-owned physical connections.
+     */
+    constructor({ connections }: {
+        connections: Record<string, object>;
+    });
+    /**
+     * Starts a broker on an ephemeral loopback port.
+     * @param {{connections: Record<string, object>}} args - Parent-owned physical connections.
+     * @returns {Promise<SharedTransactionBroker>} - Listening broker.
+     */
+    static start(args: {
+        connections: Record<string, object>;
+    }): Promise<SharedTransactionBroker>;
+    /**
+     * Gets the loopback websocket address.
+     * @returns {string} - Loopback websocket address.
+     */
+    address(): string;
+    /**
+     * Gets the per-attempt unguessable capability.
+     * @returns {string} - Per-attempt unguessable capability.
+     */
+    capability(): string;
+    /**
+     * Validates and handles one request.
+     * @param {import("ws").WebSocket} socket - Calling session.
+     * @param {string} serialized - Request JSON.
+     * @returns {Promise<void>} - Resolves after responding.
+     */
+    handleRequest(socket: import("ws").WebSocket, serialized: string): Promise<void>;
+    /**
+     * Gets mutable serialization state for one physical connection.
+     * @param {object} connection - Physical connection.
+     * @returns {ConnectionState} - Connection state.
+     */
+    connectionState(connection: object): ConnectionState;
+    /**
+     * Runs a validated request with root transaction lease semantics.
+     * @template T
+     * @param {{connection: object, method: string, savePointName: string | undefined, socket: import("ws").WebSocket}} args - Request identity.
+     * @param {() => Promise<T>} callback - Physical operation.
+     * @returns {Promise<T>} - Operation result.
+     */
+    runConnectionRequest<T>({ connection, method, savePointName, socket }: {
+        connection: object;
+        method: string;
+        savePointName: string | undefined;
+        socket: import("ws").WebSocket;
+    }, callback: () => Promise<T>): Promise<T>;
+    /**
+     * Acquires the FIFO physical connection lease and holds the queue until end.
+     * @template T
+     * @param {{callback: () => Promise<T>, savePointName: string, state: ConnectionState, socket: import("ws").WebSocket}} args - Lease request.
+     * @returns {Promise<T>} - Root savepoint start result.
+     */
+    startRootLease<T>({ callback, savePointName, state, socket }: {
+        callback: () => Promise<T>;
+        savePointName: string;
+        state: ConnectionState;
+        socket: import("ws").WebSocket;
+    }): Promise<T>;
+    /**
+     * Finishes the calling session's root lease.
+     * @template T
+     * @param {{callback: () => Promise<T>, savePointName: string | undefined, state: ConnectionState, socket: import("ws").WebSocket}} args - Lease end request.
+     * @returns {Promise<T>} - Savepoint end result.
+     */
+    finishRootLease<T>({ callback, savePointName, state, socket }: {
+        callback: () => Promise<T>;
+        savePointName: string | undefined;
+        state: ConnectionState;
+        socket: import("ws").WebSocket;
+    }): Promise<T>;
+    /**
+     * Serializes operations belonging to the active lease holder.
+     * @template T
+     * @param {{operations: Promise<void>}} lease - Active lease.
+     * @param {() => Promise<T>} callback - Operation.
+     * @returns {Promise<T>} - Result.
+     */
+    serializeLease<T>(lease: {
+        operations: Promise<void>;
+    }, callback: () => Promise<T>): Promise<T>;
+    /**
+     * Rolls back leases abandoned by a disconnected session.
+     * @param {import("ws").WebSocket} socket - Disconnected session.
+     * @returns {Promise<void>} - Resolves after all owned leases release.
+     */
+    releaseDisconnectedLeases(socket: import("ws").WebSocket): Promise<void>;
+    /**
+     * Tracks detached socket cleanup and records its failure for close().
+     * @param {import("ws").WebSocket} socket - Closed session.
+     * @returns {Promise<void>} - Settled tracked cleanup.
+     */
+    scheduleSessionCleanup(socket: import("ws").WebSocket): Promise<void>;
+    /**
+     * Rolls back and removes a root savepoint so it cannot remain beneath the next lease.
+     * @param {object} connection - Parent physical connection.
+     * @param {string} savePointName - Root savepoint name.
+     * @returns {Promise<void>} - Resolves after rollback and release.
+     */
+    rollbackRootSavePoint(connection: object, savePointName: string): Promise<void>;
+    /**
+     * Serializes ordinary non-holder work through the connection FIFO.
+     * @template T
+     * @param {ConnectionState} state - Connection state.
+     * @param {() => Promise<T>} callback - Work.
+     * @returns {Promise<T>} - Work result.
+     */
+    serialize<T>(state: ConnectionState, callback: () => Promise<T>): Promise<T>;
+    /**
+     * Stops admission, revokes capability, rejects clients, and drains active work.
+     * @returns {Promise<void>} - Resolves after transport shutdown.
+     */
+    close(): Promise<void>;
+    /**
+     * Performs deterministic transport shutdown and reports cleanup failures last.
+     * @returns {Promise<void>} - Resolves after shutdown or rejects with cleanup errors.
+     */
+    closeTransport(): Promise<void>;
+}
+//# sourceMappingURL=shared-transaction-broker.d.ts.map

package/build/src/testing/shared-transaction-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-transaction-broker.d.ts","sourceRoot":"","sources":["../../../src/testing/shared-transaction-broker.js"],"names":[],"mappings":"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"}