@harperfast/harper 5.0.0-alpha.10

package/dist/resources/DatabaseTransaction.js

@@ -0,0 +1,354 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImmediateTransaction = exports.DatabaseTransaction = exports.TRANSACTION_STATE = void 0;
+exports.replicationConfirmation = replicationConfirmation;
+exports.setTxnExpiration = setTxnExpiration;
+const commonUtility_js_1 = require("../utility/lmdb/commonUtility.js");
+const hdbError_js_1 = require("../utility/errors/hdbError.js");
+const harperLogger = __importStar(require("../utility/logging/harper_logger.js"));
+const envMngr = __importStar(require("../utility/environment/environmentManager.js"));
+const hdbTerms_ts_1 = require("../utility/hdbTerms.js");
+const common_utils_js_1 = require("../utility/common_utils.js");
+const when_ts_1 = require("../utility/when.js");
+const rocksdb_js_1 = require("@harperfast/rocksdb-js");
+const trackedTxns = new Set();
+const MAX_OUTSTANDING_TXN_DURATION = (0, common_utils_js_1.convertToMS)(envMngr.get(hdbTerms_ts_1.CONFIG_PARAMS.STORAGE_MAXTRANSACTIONQUEUETIME)) || 45000; // Allow write transactions to be queued for up to 25 seconds before we start rejecting them
+const DEBUG_LONG_TXNS = envMngr.get(hdbTerms_ts_1.CONFIG_PARAMS.STORAGE_DEBUGLONGTRANSACTIONS);
+exports.TRANSACTION_STATE = {
+    CLOSED: 0, // the transaction has been committed or aborted and can no longer be used for writes (if read txn is active, it can be used for reads)
+    OPEN: 1, // the transaction is open and can be used for reads and writes
+    LINGERING: 2, // the transaction has completed a read, but can be used for immediate writes
+};
+let outstandingCommit, outstandingCommitStart;
+let confirmReplication;
+function replicationConfirmation(callback) {
+    confirmReplication = callback;
+}
+let txnExpiration = envMngr.get(hdbTerms_ts_1.CONFIG_PARAMS.STORAGE_MAXTRANSACTIONOPENTIME) ?? 30000;
+class StartedTransaction extends Error {
+}
+class DatabaseTransaction {
+    #context;
+    writes = []; // the set of writes to commit if the conditions are met
+    completions = []; // the set of outstanding async operations to complete
+    db;
+    transaction;
+    readTxn;
+    readTxnRefCount;
+    readTxnsUsed;
+    timeout;
+    validated = 0;
+    timestamp = 0;
+    retries = 0;
+    overloadChecked;
+    open = exports.TRANSACTION_STATE.OPEN;
+    replicatedConfirmation;
+    getReadTxn() {
+        this.readTxnRefCount = (this.readTxnRefCount || 0) + 1;
+        this.timeout = txnExpiration; // reset the timeout
+        if (this.transaction) {
+            if (this.transaction.openTimer)
+                this.transaction.openTimer = 0;
+            return this.transaction;
+        }
+        if (this.open !== exports.TRANSACTION_STATE.OPEN)
+            return; // can not start a new read transaction as there is no future commit that will take place, just have to allow the read to latest database state
+        this.transaction = new rocksdb_js_1.Transaction(this.db.store);
+        if (this.timestamp) {
+            this.transaction.setTimestamp(this.timestamp);
+        }
+        this.readTxnsUsed = 1;
+        if (DEBUG_LONG_TXNS) {
+            this.stackTraces = [new StartedTransaction()];
+        }
+        if (this.transaction.openTimer)
+            this.transaction.openTimer = 0;
+        trackedTxns.add(this);
+        return this.transaction;
+    }
+    useReadTxn() {
+        const readTxn = this.getReadTxn();
+        if (DEBUG_LONG_TXNS)
+            this.stackTraces.push(new StartedTransaction());
+        this.readTxnsUsed++;
+        return readTxn;
+    }
+    doneReadTxn() {
+        if (!this.transaction)
+            return;
+        if (--this.readTxnsUsed === 0) {
+            trackedTxns.delete(this);
+            this.transaction?.abort();
+            this.transaction = null;
+        }
+    }
+    disregardReadTxn() {
+        if (--this.readTxnRefCount === 0 && this.readTxnsUsed === 1) {
+            this.doneReadTxn();
+        }
+    }
+    checkOverloaded() {
+        if (outstandingCommit &&
+            !this.overloadChecked &&
+            performance.now() - outstandingCommitStart > MAX_OUTSTANDING_TXN_DURATION) {
+            throw new hdbError_js_1.ServerError('Outstanding write transactions have too long of queue, please try again later', 503);
+        }
+        this.overloadChecked = true; // only check this once, don't interrupt ongoing transactions that have already made writes
+    }
+    addWrite(operation) {
+        if (this.open === exports.TRANSACTION_STATE.CLOSED) {
+            throw new Error('Can not use a transaction that is no longer open');
+        }
+        this.writes.push(operation);
+        if (!operation.deferSave) {
+            // Setting saved to false means to defer saving
+            this.save(operation);
+        }
+        return operation;
+    }
+    save(operation, reloadEntry = false) {
+        let txnTime = this.timestamp;
+        if (!this.transaction) {
+            this.transaction = new rocksdb_js_1.Transaction(this.db.store);
+            if (txnTime) {
+                this.transaction.setTimestamp(txnTime);
+            }
+        }
+        if (this.retries > 0) {
+            // this is marks the rocks transaction as a retry so we don't write the transaction log again
+            this.transaction.isRetry = true;
+        }
+        if (!txnTime)
+            txnTime = this.timestamp = this.transaction.getTimestamp();
+        if (reloadEntry || operation.entry === undefined) {
+            operation.entry = operation.store.getEntry(operation.key, { transaction: this.transaction });
+        }
+        operation.saved = true;
+        // immediately execute in this transaction
+        if (operation.validate?.(txnTime) === false)
+            return;
+        let result = operation.before?.();
+        if (result?.then)
+            this.completions.push(result);
+        result = operation.beforeIntermediate?.();
+        if (result?.then)
+            this.completions.push(result);
+        operation.commit(txnTime, operation.entry, this.retries > 0, this.transaction);
+    }
+    /**
+     * Resolves with information on the timestamp and success of the commit
+     */
+    commit(options = {}) {
+        for (let i = 0; i < this.writes.length; i++) {
+            let operation = this.writes[i];
+            if (this.retries === 0 && operation.saved)
+                continue;
+            this.save(operation, i < this.validated);
+        }
+        this.validated = this.writes.length;
+        return (0, when_ts_1.when)(this.completions.length > 0 ? Promise.all(this.completions) : null, () => {
+            let commitResolution;
+            if (--this.readTxnsUsed > 0) {
+                // we still have outstanding iterators using the transaction, we can't just commit/abort it, we will still
+                // need to use it
+                commitResolution =
+                    this.writes.length > 0
+                        ? this.transaction?.commit({ renewAfterCommit: true /* Try to use RocksDB's CommitAndTryCreateSnapshot */ })
+                        : // don't abort, we still have outstanding reads to complete
+                            null;
+            }
+            else {
+                // no more reads need to be performed, just commit/abort based if there are any writes
+                trackedTxns.delete(this);
+                if (this.transaction) {
+                    if (this.writes.length > 0) {
+                        commitResolution = this.transaction.commit();
+                    }
+                    else {
+                        commitResolution = this.transaction.abort();
+                        this.transaction = null; // immediately clear transaction, no need to wait
+                    }
+                }
+            }
+            if (commitResolution) {
+                if (!outstandingCommit) {
+                    outstandingCommit = commitResolution;
+                    outstandingCommitStart = performance.now();
+                    outstandingCommit.finally(() => {
+                        outstandingCommit = null;
+                    });
+                }
+                const completions = [];
+                return commitResolution.then(() => {
+                    this.transaction.onCommit?.();
+                    this.transaction = null; // the native transaction is done (reset if needed)
+                    if (this.next) {
+                        completions.push(this.next.commit(options));
+                    }
+                    if (options?.flush) {
+                        completions.push(this.writes[0].store.flushed);
+                    }
+                    if (this.replicatedConfirmation) {
+                        // if we want to wait for replication confirmation, we need to track the transaction times
+                        // and when replication notifications come in, we count the number of confirms until we reach the desired number
+                        const databaseName = this.writes[0].store.rootStore.databaseName;
+                        const lastWrite = this.writes[this.writes.length - 1];
+                        if (confirmReplication && lastWrite) {
+                            completions.push(confirmReplication(databaseName, lastWrite.store.getEntry(lastWrite.key).version, this.replicatedConfirmation));
+                        }
+                    }
+                    // now reset transactions tracking; this transaction be reused and committed again
+                    this.writes = [];
+                    if (this.#context?.resourceCache)
+                        this.#context.resourceCache = null;
+                    this.next = null;
+                    let txnTime = this.timestamp;
+                    this.timestamp = 0; // reset the timestamp as well
+                    return Promise.all(completions).then(() => {
+                        return {
+                            txnTime,
+                        };
+                    });
+                }, (error) => {
+                    if (error.code === 'ERR_BUSY') {
+                        // if the transaction failed due to concurrent changes, we need to retry. First record this as an increased risk of contention/retry
+                        // for future transactions
+                        this.retries++;
+                        return this.commit(options); // try again
+                    }
+                    else
+                        throw error;
+                });
+            }
+            const txnResolution = {
+                txnTime: this.timestamp,
+            };
+            if (this.next) {
+                // now run any other transactions
+                options.timestamp = this.timestamp;
+                const nextResolution = this.next?.commit(options);
+                if (nextResolution?.then)
+                    return nextResolution?.then((nextResolution) => ({
+                        txnTime: this.timestamp,
+                        next: nextResolution,
+                    }));
+                txnResolution.next = nextResolution;
+            }
+            return txnResolution;
+        });
+    }
+    abort() {
+        while (this.readTxnsUsed > 0)
+            this.doneReadTxn(); // release the read snapshot when we abort, we assume we don't need it
+        this.open = exports.TRANSACTION_STATE.CLOSED;
+        // reset the transaction
+        this.writes = [];
+        if (this.#context?.resourceCache)
+            this.#context.resourceCache = null;
+    }
+    directCommitSync() {
+        trackedTxns.delete(this);
+        this.transaction?.commitSync();
+    }
+    getContext() {
+        return this.#context;
+    }
+    setContext(context) {
+        this.#context = context;
+    }
+}
+exports.DatabaseTransaction = DatabaseTransaction;
+class ImmediateTransaction extends DatabaseTransaction {
+    isCommitting = false;
+    constructor(db) {
+        super();
+        this.db = db;
+    }
+    save(transaction) {
+        if (this.isCommitting) {
+            // if we are in the commit, do the save and force a reload so we get a read within the transaction
+            super.save(transaction, true);
+        }
+        else {
+            this.isCommitting = true;
+            return (0, when_ts_1.when)(this.commit(), () => {
+                this.isCommitting = false;
+            });
+        }
+    }
+    get timestamp() {
+        return this._timestamp || (this._timestamp = (0, commonUtility_js_1.getNextMonotonicTime)());
+    }
+    getReadTxn() {
+        return; // no transaction means read latest
+    }
+}
+exports.ImmediateTransaction = ImmediateTransaction;
+let timer;
+function startMonitoringTxns() {
+    timer = setInterval(function () {
+        for (const txn of trackedTxns) {
+            if (txn.timeout <= 0) {
+                const url = txn.getContext()?.url;
+                harperLogger.error(`Transaction was open too long and has been committed, from table: ${txn.db?.name + (url ? ' path: ' + url : '')}`, ...(txn.startedFrom ? [`was started from ${txn.startedFrom.resourceName}.${txn.startedFrom.method}`] : []), ...(DEBUG_LONG_TXNS ? ['starting stack trace', txn.stackTraces] : []));
+                // reset the transaction
+                try {
+                    const result = txn.commit();
+                    if (result?.then) {
+                        result.catch((error) => {
+                            harperLogger.debug?.(`Error committing timed out transaction: ${error.message}`);
+                        });
+                    }
+                }
+                catch (error) {
+                    harperLogger.debug?.(`Error committing timed out transaction: ${error.message}`);
+                }
+                txn.timeout = txnExpiration;
+            }
+            else {
+                txn.timeout -= txnExpiration;
+            }
+        }
+    }, txnExpiration).unref();
+}
+startMonitoringTxns();
+function setTxnExpiration(ms) {
+    clearInterval(timer);
+    txnExpiration = ms;
+    startMonitoringTxns();
+    return trackedTxns;
+}
+//# sourceMappingURL=DatabaseTransaction.js.map

package/dist/resources/DatabaseTransaction.js.map

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

package/dist/resources/ErrorResource.d.ts

@@ -0,0 +1,26 @@
+import { Resource } from './Resource.ts';
+import type { Context } from './ResourceInterface.ts';
+/**
+ * ErrorResource is a Resource that throws an error on any request, communicating to the client when attempts are made
+ * to access endpoints/resources that had an internal error in their configuration or setup. This helps ensure that
+ * if there is a problem with a resource, it is immediately apparent and can be fixed.
+ */
+export declare class ErrorResource implements Resource {
+    error: Error;
+    constructor(error: Error);
+    isError: boolean;
+    allowRead(): never;
+    allowUpdate(): never;
+    allowCreate(): never;
+    allowDelete(): never;
+    getId(): never;
+    getContext(): Context;
+    get(): never;
+    post(): never;
+    put(): never;
+    delete(): never;
+    connect(): never;
+    getResource(): this;
+    publish(): never;
+    subscribe(): never;
+}

package/dist/resources/ErrorResource.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorResource = void 0;
+/**
+ * ErrorResource is a Resource that throws an error on any request, communicating to the client when attempts are made
+ * to access endpoints/resources that had an internal error in their configuration or setup. This helps ensure that
+ * if there is a problem with a resource, it is immediately apparent and can be fixed.
+ */
+class ErrorResource {
+    error;
+    constructor(error) {
+        this.error = error;
+    }
+    isError = true;
+    allowRead() {
+        throw this.error;
+    }
+    allowUpdate() {
+        throw this.error;
+    }
+    allowCreate() {
+        throw this.error;
+    }
+    allowDelete() {
+        throw this.error;
+    }
+    getId() {
+        throw this.error;
+    }
+    getContext() {
+        throw this.error;
+    }
+    get() {
+        throw this.error;
+    }
+    post() {
+        throw this.error;
+    }
+    put() {
+        throw this.error;
+    }
+    delete() {
+        throw this.error;
+    }
+    connect() {
+        throw this.error;
+    }
+    getResource() {
+        // all child paths resolve back to reporting this error
+        return this;
+    }
+    publish() {
+        throw this.error;
+    }
+    subscribe() {
+        throw this.error;
+    }
+}
+exports.ErrorResource = ErrorResource;
+//# sourceMappingURL=ErrorResource.js.map

package/dist/resources/ErrorResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorResource.js","sourceRoot":"","sources":["../../resources/ErrorResource.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,aAAa;IACzB,KAAK,CAAQ;IACb,YAAY,KAAY;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IACD,OAAO,GAAG,IAAI,CAAC;IACf,SAAS;QACR,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,WAAW;QACV,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,WAAW;QACV,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,WAAW;QACV,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,KAAK;QACJ,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,UAAU;QACT,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,GAAG;QACF,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,IAAI;QACH,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,GAAG;QACF,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,MAAM;QACL,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,OAAO;QACN,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,WAAW;QACV,uDAAuD;QACvD,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO;QACN,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,SAAS;QACR,MAAM,IAAI,CAAC,KAAK,CAAC;IAClB,CAAC;CACD;AAjDD,sCAiDC"}

package/dist/resources/IterableEventQueue.d.ts

@@ -0,0 +1,19 @@
+import { EventEmitter } from 'events';
+export declare class IterableEventQueue<Event extends object = any> extends EventEmitter {
+    resolveNext: null | ((args: {
+        value: Event;
+    }) => void);
+    queue: any[];
+    hasDataListeners: boolean;
+    drainCloseListener: boolean;
+    currentDrainResolver: null | ((draining: boolean) => void);
+    [Symbol.asyncIterator](): AsyncIterator<Event>;
+    push(message: Event): void;
+    send(message: Event): void;
+    getNextMessage(): any;
+    /**
+     * Wait for the queue to be drained, resolving to true to continue or false if the queue was closed before draining.
+     */
+    waitForDrain(): Promise<boolean>;
+    on(eventName: 'data' | string, listener: ((data: Event) => void) | any): any;
+}

package/dist/resources/IterableEventQueue.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IterableEventQueue = void 0;
+const events_1 = require("events");
+class IterableEventQueue extends events_1.EventEmitter {
+    resolveNext = null;
+    queue;
+    hasDataListeners;
+    drainCloseListener;
+    currentDrainResolver = null;
+    [Symbol.asyncIterator]() {
+        const iterator = new EventQueueIterator();
+        iterator.queue = this;
+        // @ts-expect-error The EventQueueIterator is acceptable as an AsyncIterator
+        return iterator;
+    }
+    push(message) {
+        this.send(message);
+    }
+    send(message) {
+        if (this.resolveNext) {
+            this.resolveNext({ value: message });
+            this.resolveNext = null;
+        }
+        else if (this.hasDataListeners) {
+            this.emit('data', message);
+        }
+        else {
+            if (!this.queue)
+                this.queue = [];
+            this.queue.push(message);
+        }
+    }
+    getNextMessage() {
+        const message = this.queue?.shift();
+        if (!message)
+            this.emit('drained');
+        return message;
+    }
+    /**
+     * Wait for the queue to be drained, resolving to true to continue or false if the queue was closed before draining.
+     */
+    waitForDrain() {
+        return new Promise((resolve) => {
+            if (!this.queue || this.queue.length === 0)
+                resolve(true);
+            else {
+                this.once('drained', () => resolve(true));
+                this.currentDrainResolver = resolve;
+                if (!this.drainCloseListener) {
+                    this.drainCloseListener = true;
+                    this.on('close', () => {
+                        this.currentDrainResolver?.(false);
+                    });
+                }
+            }
+        });
+    }
+    on(eventName, listener) {
+        if (eventName === 'data' && !this.hasDataListeners) {
+            this.hasDataListeners = true;
+            while (this.queue?.length > 0)
+                listener(this.queue.shift());
+        }
+        return super.on(eventName, listener);
+    }
+}
+exports.IterableEventQueue = IterableEventQueue;
+class EventQueueIterator {
+    queue;
+    push(message) {
+        this.queue.send(message);
+    }
+    // @ts-expect-error TypeScript is wrong, the JS engine accepts MaybePromise<...>
+    next() {
+        const message = this.queue.getNextMessage();
+        if (message) {
+            return {
+                value: message,
+            };
+        }
+        else {
+            return new Promise((resolve) => (this.queue.resolveNext = resolve));
+        }
+    }
+    // @ts-expect-error TypeScript is wrong, the JS engine accepts MaybePromise<...>
+    return(value) {
+        this.queue.emit('close');
+        return {
+            value,
+            done: true,
+        };
+    }
+    // @ts-expect-error TypeScript is wrong, the JS engine accepts MaybePromise<...>
+    throw(error) {
+        this.queue.emit('close', error);
+        return {
+            done: true,
+            value: undefined,
+        };
+    }
+}
+//# sourceMappingURL=IterableEventQueue.js.map

package/dist/resources/IterableEventQueue.js.map

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

package/dist/resources/LMDBTransaction.d.ts

@@ -0,0 +1,43 @@
+import { Transaction as LMDBNativeTransaction } from 'lmdb';
+import { DatabaseTransaction, type CommitOptions, type TransactionWrite, type CommitResolution } from './DatabaseTransaction';
+import type { RootDatabaseKind } from './databases.ts';
+export declare const TRANSACTION_STATE: {
+    CLOSED: number;
+    OPEN: number;
+    LINGERING: number;
+};
+export declare function replicationConfirmation(callback: any): void;
+type ReadTransaction = LMDBNativeTransaction & {
+    openTimer?: number;
+    retryRisk?: number;
+};
+export declare class LMDBTransaction extends DatabaseTransaction {
+    #private;
+    writes: TransactionWrite[];
+    validated: number;
+    _timestamp: number;
+    next: DatabaseTransaction;
+    stale: boolean;
+    overloadChecked: boolean;
+    open: number;
+    getReadTxn(): ReadTransaction;
+    useReadTxn(): any;
+    doneReadTxn(): void;
+    disregardReadTxn(): void;
+    addWrite(operation: TransactionWrite): Promise<CommitResolution>;
+    removeWrite(operation: TransactionWrite): void;
+    /**
+     * Resolves with information on the timestamp and success of the commit
+     */
+    commit(options?: CommitOptions): Promise<CommitResolution>;
+    abort(): void;
+    save(): void;
+}
+export declare class ImmediateTransaction extends LMDBTransaction {
+    constructor(db: RootDatabaseKind);
+    save(_transaction: ImmediateTransaction, _isRetry?: boolean): Promise<CommitResolution>;
+    get timestamp(): number;
+    getReadTxn(): void;
+}
+export declare function setTxnExpiration(ms: any): Set<DatabaseTransaction>;
+export {};