velocious 1.0.577 → 1.0.579

package/build/src/database/pool/single-multi-use.d.ts

@@ -1,21 +1,254 @@
+import BasePool from "./base.js";
+export type SinglePoolConnectionEntry = {
+    /**
+     * - Active users of the connection.
+     */
+    activeCheckoutCount: number;
+    /**
+     * - Nested checkout names.
+     */
+    checkoutNames: string[];
+    /**
+     * - Owned driver.
+     */
+    connection: import("../drivers/base.js").default;
+    /**
+     * - Whether normal ambient use retains this idle entry.
+     */
+    retained: boolean;
+    /**
+     * - Physical configuration reuse key.
+     */
+    reuseKey: string;
+};
+export type SinglePoolPendingCheckout = {
+    /**
+     * - Checkout name.
+     */
+    checkoutName: string | undefined;
+    /**
+     * - Rejects if closeAll owns cancellation.
+     */
+    closePromise?: Promise<void>;
+    /**
+     * - Enqueue timestamp.
+     */
+    enqueuedAt: number;
+    /**
+     * - Rejects a capacity waiter during closeAll.
+     */
+    reject: (error: Error) => void;
+    /**
+     * - Physical configuration reuse key.
+     */
+    reuseKey: string;
+    /**
+     * - Timeout timestamp.
+     */
+    timeoutAt: number | null;
+    /**
+     * - Configured timeout.
+     */
+    timeoutMillis: number | null;
+};
 export default class VelociousDatabasePoolSingleMultiUser extends BasePool {
+    connection: import("../drivers/base.js").default | undefined;
     activeCheckoutCount: number;
     suppressedConnectionContextCount: number;
     operationLeaseQueue: Promise<void>;
+    connectionsBeingSpawned: number;
+    /** @type {Map<string, SinglePoolConnectionEntry>} */
+    connectionEntries: Map<string, SinglePoolConnectionEntry>;
+    /** @type {Map<string, Promise<SinglePoolConnectionEntry>>} */
+    connectionEntrySpawnPromises: Map<string, Promise<SinglePoolConnectionEntry>>;
+    /** @type {Map<string, Promise<void>>} */
+    capturedOperationQueues: Map<string, Promise<void>>;
+    /** @type {SinglePoolPendingCheckout[]} */
+    pendingCheckouts: SinglePoolPendingCheckout[];
+    /** @type {Set<() => boolean>} */
+    capacityWaiters: Set<() => boolean>;
+    closeGeneration: number;
+    /**
+     * Checks a connection back into its keyed physical entry.
+     * @param {import("../drivers/base.js").default} connection - Connection.
+     * @returns {Promise<void>} - Resolves when cleanup completes.
+     */
+    checkin(connection: import("../drivers/base.js").default): Promise<void>;
+    /**
+     * Checks out the ambient configuration and retains it as the single mutable
+     * browser fallback connection.
+     * @param {import("./base.js").ConnectionCheckoutOptions} [options] - Checkout options.
+     * @returns {Promise<import("../drivers/base.js").default>} - Checked-out connection.
+     */
+    checkout(options?: import("./base.js").ConnectionCheckoutOptions): Promise<import("../drivers/base.js").default>;
+    /**
+     * Checks out an explicitly captured physical configuration.
+     * @param {import("../../configuration-types.js").DatabaseConfigurationType} databaseConfiguration - Captured configuration.
+     * @param {import("./base.js").ConnectionCheckoutOptions} options - Checkout options.
+     * @param {{retain: boolean}} args - Whether this becomes the ambient retained connection.
+     * @returns {Promise<import("../drivers/base.js").default>} - Checked-out connection.
+     */
+    checkoutForConfiguration(databaseConfiguration: import("../../configuration-types.js").DatabaseConfigurationType, options: import("./base.js").ConnectionCheckoutOptions, { retain }: {
+        retain: boolean;
+    }): Promise<import("../drivers/base.js").default>;
+    /**
+     * Ensures capacity exists for another physical connection.
+     * @param {import("../../configuration-types.js").DatabaseConfigurationType} databaseConfiguration - Requested configuration.
+     * @param {{name?: string, reuseKey: string}} options - Pending checkout identity.
+     * @returns {Promise<void>} - Resolves when capacity is available.
+     */
+    reserveConnectionCapacity(databaseConfiguration: import("../../configuration-types.js").DatabaseConfigurationType, options: {
+        name?: string;
+        reuseKey: string;
+    }): Promise<void>;
+    /**
+     * Waits for pool capacity with normal timeout and closeAll ownership.
+     * @param {import("../../configuration-types.js").DatabaseConfigurationType} databaseConfiguration - Requested configuration.
+     * @param {{name?: string, reuseKey: string}} options - Pending checkout identity.
+     * @returns {Promise<void>} - Resolves on a capacity change.
+     */
+    waitForCapacity(databaseConfiguration: import("../../configuration-types.js").DatabaseConfigurationType, options: {
+        name?: string;
+        reuseKey: string;
+    }): Promise<void>;
+    /**
+     * Runs with connection.
+     * @template T
+     * @param {import("./base.js").ConnectionCheckoutOptions | ((arg: import("../drivers/base.js").default) => Promise<T>)} optionsOrCallback - Options or callback.
+     * @param {(arg: import("../drivers/base.js").default) => Promise<T>} [callback] - Callback.
+     * @returns {Promise<T>} - Callback result.
+     */
+    withConnection<T>(optionsOrCallback: import("./base.js").ConnectionCheckoutOptions | ((arg: import("../drivers/base.js").default) => Promise<T>), callback?: (arg: import("../drivers/base.js").default) => Promise<T>): Promise<T>;
+    /**
+     * Runs a legacy ambient operation under one pool-wide FIFO lease.
+     * @template T
+     * @param {import("./base.js").ConnectionCheckoutOptions} options - Checkout options.
+     * @param {(connection: import("../drivers/base.js").default, owner: symbol) => Promise<T>} callback - Callback.
+     * @returns {Promise<T>} - Callback result.
+     */
+    withOperationConnection<T>(options: import("./base.js").ConnectionCheckoutOptions, callback: (connection: import("../drivers/base.js").default, owner: symbol) => Promise<T>): Promise<T>;
+    /**
+     * Runs a captured operation under a FIFO lease scoped only to its physical
+     * database identity, so unrelated tenant databases remain concurrent.
+     * @template T
+     * @param {import("./base.js").CapturedConnectionOptions} options - Captured options.
+     * @param {(connection: import("../drivers/base.js").default, owner: symbol) => Promise<T>} callback - Callback.
+     * @returns {Promise<T>} - Callback result.
+     */
+    withCapturedOperationConnection<T>({ databaseConfiguration, name }: import("./base.js").CapturedConnectionOptions, callback: (connection: import("../drivers/base.js").default, owner: symbol) => Promise<T>): Promise<T>;
+    /**
+     * Runs one callback with an installed driver operation lease.
+     * @template T
+     * @param {import("../../configuration-types.js").DatabaseConfigurationType} databaseConfiguration - Physical configuration.
+     * @param {import("./base.js").ConnectionCheckoutOptions} options - Checkout options.
+     * @param {{retain: boolean}} checkoutArgs - Checkout retention.
+     * @param {(connection: import("../drivers/base.js").default, owner: symbol) => Promise<T>} callback - Callback.
+     * @returns {Promise<T>} - Callback result.
+     */
+    runOwnedOperation<T>(databaseConfiguration: import("../../configuration-types.js").DatabaseConfigurationType, options: import("./base.js").ConnectionCheckoutOptions, checkoutArgs: {
+        retain: boolean;
+    }, callback: (connection: import("../drivers/base.js").default, owner: symbol) => Promise<T>): Promise<T>;
+    /**
+     * Waits for a same-physical-database operation queue turn.
+     * @param {Promise<void>} previousTurn - Previous queue tail.
+     * @param {SinglePoolPendingCheckout | undefined} pending - Pending debug entry.
+     * @returns {Promise<void>} - Resolves when the previous turn releases.
+     */
+    waitForOperationTurn(previousTurn: Promise<void>, pending: SinglePoolPendingCheckout | undefined): Promise<void>;
+    /**
+     * Runs without current connection context.
+     * @template T
+     * @param {() => T} callback - Callback.
+     * @returns {T} - Callback result.
+     */
+    withoutCurrentConnectionContext<T>(callback: () => T): T;
+    /** Clears schema metadata on every live physical connection. */
+    clearSchemaCache(): void;
+    /** Closes every pool-owned connection and rejects queued capacity requests. */
+    closeAll(): Promise<void>;
+    /**
+     * Returns the mutable ambient fallback connection.
+     * @returns {import("../drivers/base.js").default} - Mutable ambient fallback connection.
+     */
+    getCurrentConnection(): import("../drivers/base.js").default;
+    /**
+     * Returns the current context fallback connection when it is not suppressed.
+     * @returns {import("../drivers/base.js").default | undefined} - Current fallback connection.
+     */
+    getCurrentContextConnection(): import("../drivers/base.js").default | undefined;
+    /**
+     * Returns whether fallback context is available.
+     * @returns {boolean} - Whether fallback context is available.
+     */
+    hasCurrentConnectionContext(): boolean;
     /**
-     * Checkout names of the currently-active nested checkouts, innermost last. The
-     * shared connection carries a single checkout name, so nesting requires restoring
-     * the enclosing scope's name when an inner checkout checks in.
-     * @type {Array<string | undefined>}
+     * Returns pool diagnostics for retained and temporary keyed connections.
+     * @returns {import("./base.js").DatabasePoolDebugSnapshot} - Pool diagnostics.
      */
-    checkoutNameStack: Array<string | undefined>;
+    getDebugSnapshot(): import("./base.js").DatabasePoolDebugSnapshot;
     /**
-     * Runs checkin.
+     * Returns the configured connection maximum.
+     * @param {import("../../configuration-types.js").DatabaseConfigurationType} databaseConfiguration - Physical configuration.
+     * @returns {number | null} - Configured connection maximum.
+     */
+    maxConnections(databaseConfiguration: import("../../configuration-types.js").DatabaseConfigurationType): number | null;
+    /**
+     * Returns the configured checkout timeout.
+     * @param {import("../../configuration-types.js").DatabaseConfigurationType} databaseConfiguration - Physical configuration.
+     * @returns {number | null} - Configured checkout timeout.
+     */
+    checkoutTimeoutMillis(databaseConfiguration: import("../../configuration-types.js").DatabaseConfigurationType): number | null;
+    /**
+     * Returns whether another physical connection may be spawned.
+     * @param {import("../../configuration-types.js").DatabaseConfigurationType} databaseConfiguration - Physical configuration.
+     * @returns {boolean} - Whether another physical connection may be spawned.
+     */
+    canSpawnConnection(databaseConfiguration: import("../../configuration-types.js").DatabaseConfigurationType): boolean;
+    /**
+     * Atomically claims one connection slot without yielding.
+     * @param {import("../../configuration-types.js").DatabaseConfigurationType} databaseConfiguration - Physical configuration whose maximum applies.
+     * @returns {boolean} - Whether a slot was reserved.
+     */
+    tryReserveConnectionCapacity(databaseConfiguration: import("../../configuration-types.js").DatabaseConfigurationType): boolean;
+    /** Releases one previously claimed connection slot. */
+    releaseConnectionCapacityReservation(): void;
+    /**
+     * Spawns and tracks a physical connection entry.
+     * @param {import("../../configuration-types.js").DatabaseConfigurationType} databaseConfiguration - Physical configuration.
+     * @param {string} reuseKey - Physical reuse key.
+     * @param {number} closeGeneration - Pool lifecycle generation at spawn start.
+     * @returns {Promise<SinglePoolConnectionEntry>} - New entry.
+     */
+    spawnConnectionEntry(databaseConfiguration: import("../../configuration-types.js").DatabaseConfigurationType, reuseKey: string, closeGeneration: number): Promise<SinglePoolConnectionEntry>;
+    /**
+     * Removes and closes an entry.
      * @param {import("../drivers/base.js").default} connection - Connection.
-     * @returns {Promise<void>} - Resolves when complete.
+     * @returns {SinglePoolConnectionEntry | undefined} - Entry owning a connection.
      */
-    checkin(connection: import("../drivers/base.js").default): Promise<void>;
-    connection: import("../drivers/base.js").default | undefined;
+    entryForConnection(connection: import("../drivers/base.js").default): SinglePoolConnectionEntry | undefined;
+    /**
+     * Adds a same-key operation pending entry.
+     * @param {SinglePoolConnectionEntry} entry - Entry to close.
+     * @returns {Promise<void>} - Resolves after close.
+     */
+    removeAndCloseEntry(entry: SinglePoolConnectionEntry): Promise<void>;
+    /** Wakes all capacity waiters to re-check the bounded pool. */
+    notifyCapacityWaiters(): void;
+    /**
+     * Adds a same-key operation pending entry.
+     * @param {import("../../configuration-types.js").DatabaseConfigurationType} databaseConfiguration - Physical configuration.
+     * @param {{name?: string, reuseKey: string}} options - Pending identity.
+     * @returns {SinglePoolPendingCheckout} - Added same-key operation pending entry.
+     */
+    addOperationPendingCheckout(databaseConfiguration: import("../../configuration-types.js").DatabaseConfigurationType, { name, reuseKey }: {
+        name?: string;
+        reuseKey: string;
+    }): SinglePoolPendingCheckout;
+    /**
+     * Removes a pending checkout debug entry.
+     * @param {SinglePoolPendingCheckout} pending - Pending entry.
+     * @returns {void}
+     */
+    removePendingCheckout(pending: SinglePoolPendingCheckout): void;
 }
-import BasePool from "./base.js";
 //# sourceMappingURL=single-multi-use.d.ts.map

package/build/src/database/pool/single-multi-use.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"single-multi-use.d.ts","sourceRoot":"","sources":["../../../../src/database/pool/single-multi-use.js"],"names":[],"mappings":"AAKA;IACE,4BAAuB;IACvB,yCAAoC;IACpC,mCAAuC;IAEvC;;;;;OAKG;IACH,mBAFU,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAEb;IAEtB;;;;OAIG;IACH,oBAHW,OAAO,oBAAoB,EAAE,OAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CAsCzB;IAdK,6DAA2B;CA+MlC;qBA1PoB,WAAW"}
+{"version":3,"file":"single-multi-use.d.ts","sourceRoot":"","sources":["../../../../src/database/pool/single-multi-use.js"],"names":[],"mappings":"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"}