velocious 1.0.510 → 1.0.512

package/build/database/record-changes.js

@@ -0,0 +1,135 @@
+// @ts-check
+
+import EventEmitter from "../utils/event-emitter.js"
+
+/**
+ * RecordModelClass type.
+ * @typedef {typeof import("./record/index.js").default} RecordModelClass */
+
+/**
+ * RecordChangeOperation type.
+ * @typedef {"create" | "update" | "destroy"} RecordChangeOperation */
+
+/**
+ * RecordChangeEvent type.
+ * @typedef {object} RecordChangeEvent
+ * @property {RecordModelClass} modelClass - Model class whose row changed.
+ * @property {RecordChangeOperation} operation - The committed operation.
+ * @property {InstanceType<RecordModelClass>} record - The committed record instance.
+ */
+
+/**
+ * RecordChangeListener type.
+ * @typedef {(event: RecordChangeEvent) => void} RecordChangeListener */
+
+/**
+ * Framework-level bus for committed local model changes. Records emit here once
+ * per commit (see `VelociousDatabaseRecord.save`/`destroy`), so local writes,
+ * pull applies, and realtime applies converge on one uniform signal that live
+ * queries subscribe to. Emission is keyed by model name; a `batch(...)` window
+ * coalesces a burst of commits into a single event per model class.
+ */
+class RecordChanges {
+  /**
+   * Underlying event bus keyed by model name.
+   * @type {import("eventemitter3").EventEmitter} */
+  _emitter = new EventEmitter()
+
+  /**
+   * Number of open batch windows; while positive, emits buffer instead of dispatching.
+   * @type {number} */
+  _batchDepth = 0
+
+  /**
+   * Latest buffered event per model name, dispatched once when the outermost batch ends.
+   * @type {Map<string, RecordChangeEvent>} */
+  _bufferedEvents = new Map()
+
+  /**
+   * Subscribes a listener to committed changes of a model class.
+   * @param {RecordModelClass} modelClass - Model class to observe.
+   * @param {RecordChangeListener} listener - Listener called with each change event.
+   * @returns {() => void} Unsubscribe callback.
+   */
+  subscribe(modelClass, listener) {
+    const eventName = modelClass.getModelName()
+
+    this._emitter.on(eventName, listener)
+
+    return () => {
+      this._emitter.off(eventName, listener)
+    }
+  }
+
+  /**
+   * Whether any listener is currently observing the given model class. Callers on
+   * the write path use this to skip emitting entirely when nothing is watching,
+   * keeping server-side saves free of live-query overhead.
+   * @param {RecordModelClass} modelClass - Model class to check.
+   * @returns {boolean} Whether listeners exist for the model class.
+   */
+  hasListeners(modelClass) {
+    return this._emitter.listenerCount(modelClass.getModelName()) > 0
+  }
+
+  /**
+   * Emits a committed change. While a batch window is open the event is buffered
+   * and deduplicated by model class, so a batch of N commits dispatches a single
+   * event per model class when the outermost batch ends.
+   * @param {RecordChangeEvent} event - Change event to dispatch.
+   * @returns {void}
+   */
+  emit(event) {
+    if (this._batchDepth > 0) {
+      this._bufferedEvents.set(event.modelClass.getModelName(), event)
+
+      return
+    }
+
+    this._emitter.emit(event.modelClass.getModelName(), event)
+  }
+
+  /**
+   * Runs a callback with change dispatch coalesced: every change committed while
+   * the callback runs buffers, and the outermost batch flushes a single event per
+   * changed model class after it resolves. Nested batches share one flush. Sync
+   * appliers wrap their per-row apply loop in this so a large pull or realtime
+   * push triggers one re-run per live query instead of one per applied row.
+   * @template T
+   * @param {() => Promise<T> | T} callback - Work whose committed changes should coalesce.
+   * @returns {Promise<T>} The callback result.
+   */
+  async batch(callback) {
+    this._batchDepth++
+
+    try {
+      return await callback()
+    } finally {
+      this._batchDepth--
+
+      if (this._batchDepth === 0) this._flushBufferedEvents()
+    }
+  }
+
+  /**
+   * Dispatches and clears the buffered per-model events collected during a batch.
+   * @returns {void}
+   */
+  _flushBufferedEvents() {
+    const bufferedEvents = this._bufferedEvents
+
+    this._bufferedEvents = new Map()
+
+    for (const event of bufferedEvents.values()) {
+      this._emitter.emit(event.modelClass.getModelName(), event)
+    }
+  }
+}
+
+/**
+ * Shared singleton so record commits and live queries meet on one bus.
+ * @type {RecordChanges} */
+const recordChanges = new RecordChanges()
+
+export default recordChanges
+export {RecordChanges}

package/build/database/use-live-query.js

@@ -0,0 +1,118 @@
+// @ts-check
+
+import {useCallback, useEffect, useMemo, useRef, useSyncExternalStore} from "react"
+
+import LiveQuery from "./live-query.js"
+
+/**
+ * RecordModelClass type.
+ * @typedef {typeof import("./record/index.js").default} RecordModelClass */
+
+/**
+ * LiveQuerySource type.
+ * @template T
+ * @typedef {import("./live-query.js").LiveQuerySource<T>} LiveQuerySource */
+
+/**
+ * LiveQueryState type.
+ * @template T
+ * @typedef {import("./live-query.js").LiveQueryState<T>} LiveQueryState */
+
+/**
+ * UseLiveQueryOptions type.
+ * @typedef {object} UseLiveQueryOptions
+ * @property {boolean} [active] - Whether the query is active. Default true; pass false to pause and return the empty state.
+ * @property {number} [debounce] - Trailing debounce in ms for re-runs. Defaults to microtask coalescing.
+ * @property {RecordModelClass[]} [models] - Model classes to observe. Defaults to the query's model class; pass this to also react to joined models.
+ */
+
+/**
+ * Stable empty state returned while there is no active query, so a paused hook
+ * keeps a referentially stable snapshot for `useSyncExternalStore`.
+ * @type {LiveQueryState<?>} */
+const EMPTY_STATE = {error: null, loading: false, results: []}
+
+/**
+ * Assigns and stores a stable identity key for query sources without a `toSql`.
+ * @type {WeakMap<object, string>} */
+const queryIdentityKeys = new WeakMap()
+
+/**
+ * Monotonic counter backing the queryIdentityKeys registry.
+ * @type {number} */
+let nextQueryIdentity = 0
+
+/**
+ * Builds a dependency key identifying a query's semantics so the underlying
+ * controller is rebuilt when they change. Model-class queries expose `toSql`, so
+ * distinct conditions yield distinct keys; other sources fall back to a stable
+ * per-object identity (such sources must be memoized by the caller).
+ * @param {LiveQuerySource<?> & {toSql?: () => ?}} query - Query source.
+ * @param {RecordModelClass[] | undefined} models - Explicit model classes to observe.
+ * @returns {string} Dependency key.
+ */
+function liveQueryDependencyKey(query, models) {
+  const modelNames = (models ?? [query.getModelClass()]).map((modelClass) => modelClass.getModelName()).join(",")
+
+  if (typeof query.toSql === "function") return `${modelNames}::${String(query.toSql())}`
+
+  let identityKey = queryIdentityKeys.get(query)
+
+  if (identityKey === undefined) {
+    identityKey = `#${++nextQueryIdentity}`
+    queryIdentityKeys.set(query, identityKey)
+  }
+
+  return `${modelNames}::${identityKey}`
+}
+
+/**
+ * React hook declaring what a screen shows and keeping it current from committed
+ * local model changes. Runs `query.toArray()` once, subscribes to the query's
+ * model class(es) on the record-change bus, and re-runs (coalesced, stale-safe)
+ * whenever a watched model commits — so local writes, pull applies, and realtime
+ * applies all refresh the results without any manual refresh plumbing.
+ * @template T
+ * @param {(LiveQuerySource<T> & {toSql?: () => ?}) | null | undefined} query - Query source, e.g. `Model.where({...})`.
+ * @param {UseLiveQueryOptions} [options] - Hook options.
+ * @returns {LiveQueryState<T>} Current results, loading, and last error.
+ */
+export default function useLiveQuery(query, options = {}) {
+  const {active = true, debounce, models} = options
+  const enabled = active && Boolean(query)
+  const dependencyKey = enabled && query ? liveQueryDependencyKey(query, models) : "disabled"
+
+  const queryRef = useRef(query)
+  const modelsRef = useRef(models)
+
+  queryRef.current = query
+  modelsRef.current = models
+
+  const liveQuery = useMemo(() => {
+    if (!enabled || !queryRef.current) return null
+
+    return new LiveQuery({debounce, models: modelsRef.current, query: queryRef.current})
+  }, [dependencyKey, debounce, enabled])
+
+  useEffect(() => {
+    if (!liveQuery) return undefined
+
+    liveQuery.start()
+
+    return () => liveQuery.close()
+  }, [liveQuery])
+
+  const subscribe = useCallback((/** @type {() => void} */ listener) => {
+    if (!liveQuery) return () => {}
+
+    return liveQuery.subscribe(listener)
+  }, [liveQuery])
+
+  const getSnapshot = useCallback(() => {
+    if (!liveQuery) return /** @type {LiveQueryState<T>} */ (EMPTY_STATE)
+
+    return liveQuery.getState()
+  }, [liveQuery])
+
+  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot)
+}

package/build/src/configuration-types.d.ts

@@ -775,7 +775,7 @@ export type DatabaseConfigurationType = {
     /**
      * - Database type identifier.
      */
-    type?: "sqlite" | "pgsql" | "mysql" | "mssql" | undefined;
+    type?: "sqlite" | "mysql" | "pgsql" | "mssql" | undefined;
     /**
      * - Database to switch to after connecting.
      */

package/build/src/configuration.d.ts

@@ -383,7 +383,7 @@ export default class VelociousConfiguration {
      * @returns {typeof import("./database/pool/base.js").default} - The database pool type.
      */
     getDatabasePoolType(identifier?: string): typeof import("./database/pool/base.js").default;
-    getDatabaseType(identifier?: string): "sqlite" | "pgsql" | "mysql" | "mssql";
+    getDatabaseType(identifier?: string): "sqlite" | "mysql" | "pgsql" | "mssql";
     /**
      * Runs get directory.
      * @returns {string} - The directory.

package/build/src/database/advisory-lock-runner.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Runs advisory locks on the caller connection by default, using a dedicated
+ * lock connection only when a positive hold timeout needs separate ownership.
+ */
+export default class AdvisoryLockRunner {
+    /**
+     * Runs `callback`, rejecting with `AdvisoryLockHoldTimeoutError` if it has
+     * not settled within `holdTimeoutMs`. The callback is not cancelled; callers
+     * use a dedicated advisory-lock connection so the lock can still be released.
+     * @template T
+     * @param {string} name - Lock name (for the error message).
+     * @param {() => Promise<T>} callback - Callback holding the lock.
+     * @param {number | null} [holdTimeoutMs] - Max hold time; falsy disables the timeout.
+     * @returns {Promise<T>} - Resolves with the callback result.
+     */
+    static runWithAdvisoryLockHoldTimeout<T>(name: string, callback: () => Promise<T>, holdTimeoutMs?: number | null): Promise<T>;
+    /**
+     * Creates an advisory-lock runner for one model database identifier.
+     * @param {{configuration: import("../configuration.js").default, connectionProvider: () => import("./drivers/base.js").default, databaseIdentifier: string}} args - Runner dependencies.
+     */
+    constructor({ configuration, connectionProvider, databaseIdentifier }: {
+        configuration: import("../configuration.js").default;
+        connectionProvider: () => import("./drivers/base.js").default;
+        databaseIdentifier: string;
+    });
+    configuration: import("../configuration.js").default;
+    connectionProvider: () => import("./drivers/base.js").default;
+    databaseIdentifier: string;
+    /**
+     * Runs a callback after acquiring the advisory lock, waiting up to `timeoutMs`.
+     * @template T
+     * @param {string} name - Lock name.
+     * @param {() => Promise<T>} callback - Callback to invoke while the lock is held.
+     * @param {{timeoutMs?: number | null, holdTimeoutMs?: number | null}} [args] - Lock and hold timeout options.
+     * @returns {Promise<T>} - Resolves with the callback result.
+     */
+    withAdvisoryLock<T>(name: string, callback: () => Promise<T>, args?: {
+        timeoutMs?: number | null;
+        holdTimeoutMs?: number | null;
+    }): Promise<T>;
+    /**
+     * Runs a callback only if the advisory lock can be acquired immediately.
+     * @template T
+     * @param {string} name - Lock name.
+     * @param {() => Promise<T>} callback - Callback to invoke while the lock is held.
+     * @param {{holdTimeoutMs?: number | null}} [args] - Hold timeout options.
+     * @returns {Promise<T>} - Resolves with the callback result.
+     */
+    withAdvisoryLockOrFail<T>(name: string, callback: () => Promise<T>, args?: {
+        holdTimeoutMs?: number | null;
+    }): Promise<T>;
+    /**
+     * Runs the lock holder callback and releases the lock from its owning connection.
+     * @template T
+     * @param {{callback: () => Promise<T>, connection: import("./drivers/base.js").default, holdTimeoutMs?: number | null, name: string}} args - Locked callback args.
+     * @returns {Promise<T>} - Resolves with the callback result.
+     */
+    runLockedCallback<T>({ callback, connection, holdTimeoutMs, name }: {
+        callback: () => Promise<T>;
+        connection: import("./drivers/base.js").default;
+        holdTimeoutMs?: number | null;
+        name: string;
+    }): Promise<T>;
+    /**
+     * Runs lock work on the caller connection unless a positive hold timeout needs
+     * its own lock connection.
+     * @template T
+     * @param {number | null | undefined} holdTimeoutMs - Max hold time; positive values use a dedicated lock connection.
+     * @param {(connection: import("./drivers/base.js").default) => Promise<T>} callback - Callback receiving the connection that owns the advisory lock.
+     * @returns {Promise<T>} - Resolves with the callback result.
+     */
+    withLockConnection<T>(holdTimeoutMs: number | null | undefined, callback: (connection: import("./drivers/base.js").default) => Promise<T>): Promise<T>;
+    /**
+     * Spawns a hold-timeout lock connection and closes it after lock work completes when
+     * the spawned driver owns the underlying physical connection.
+     * @template T
+     * @param {(connection: import("./drivers/base.js").default) => Promise<T>} callback - Callback that receives the dedicated lock connection.
+     * @returns {Promise<T>} - Resolves with the callback result.
+     */
+    withDedicatedConnection<T>(callback: (connection: import("./drivers/base.js").default) => Promise<T>): Promise<T>;
+}
+/**
+ * Thrown when `withAdvisoryLockOrFail` finds the lock already held.
+ */
+export class AdvisoryLockBusyError extends Error {
+    /**
+     * Runs constructor.
+     * @param {string} message - Error message.
+     * @param {{name: string}} args - The advisory lock name that was already held.
+     */
+    constructor(message: string, { name }: {
+        name: string;
+    });
+    lockName: string;
+}
+/**
+ * Thrown when a callback holds an advisory lock longer than `holdTimeoutMs`.
+ */
+export class AdvisoryLockHoldTimeoutError extends Error {
+    /**
+     * Runs constructor.
+     * @param {string} message - Error message.
+     * @param {{name: string}} args - The advisory lock name whose hold timed out.
+     */
+    constructor(message: string, { name }: {
+        name: string;
+    });
+    lockName: string;
+}
+/**
+ * Thrown when an advisory lock could not be acquired before `timeoutMs` elapsed.
+ */
+export class AdvisoryLockTimeoutError extends Error {
+    /**
+     * Runs constructor.
+     * @param {string} message - Error message.
+     * @param {{name: string}} args - The advisory lock name that timed out.
+     */
+    constructor(message: string, { name }: {
+        name: string;
+    });
+    lockName: string;
+}
+//# sourceMappingURL=advisory-lock-runner.d.ts.map

package/build/src/database/advisory-lock-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advisory-lock-runner.d.ts","sourceRoot":"","sources":["../../../src/database/advisory-lock-runner.js"],"names":[],"mappings":"AAoDA;;;GAGG;AACH;IAoGE;;;;;;;;;OASG;IACH,sCANa,CAAC,QACH,MAAM,YACN,MAAM,OAAO,CAAC,CAAC,CAAC,kBAChB,MAAM,GAAG,IAAI,GACX,OAAO,CAAC,CAAC,CAAC,CAwBtB;IAnID;;;OAGG;IACH,uEAFW;QAAC,aAAa,EAAE,OAAO,qBAAqB,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,OAAO,mBAAmB,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAC,EAM3J;IAHC,qDAAkC;IAClC,0BAJ0F,OAAO,mBAAmB,EAAE,OAAO,CAIjF;IAC5C,2BAA4C;IAG9C;;;;;;;OAOG;IACH,iBANa,CAAC,QACH,MAAM,YACN,MAAM,OAAO,CAAC,CAAC,CAAC,SAChB;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAC,GACxD,OAAO,CAAC,CAAC,CAAC,CAYtB;IAED;;;;;;;OAOG;IACH,uBANa,CAAC,QACH,MAAM,YACN,MAAM,OAAO,CAAC,CAAC,CAAC,SAChB;QAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CAYtB;IAED;;;;;OAKG;IACH,kBAJa,CAAC,iDACH;QAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;QAAC,UAAU,EAAE,OAAO,mBAAmB,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GACxH,OAAO,CAAC,CAAC,CAAC,CAQtB;IAED;;;;;;;OAOG;IACH,mBALa,CAAC,iBACH,MAAM,GAAG,IAAI,GAAG,SAAS,YACzB,CAAC,UAAU,EAAE,OAAO,mBAAmB,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7D,OAAO,CAAC,CAAC,CAAC,CAQtB;IAED;;;;;;OAMG;IACH,wBAJa,CAAC,YACH,CAAC,UAAU,EAAE,OAAO,mBAAmB,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7D,OAAO,CAAC,CAAC,CAAC,CAYtB;CAmCF;AAzKD;;GAEG;AACH;IACE;;;;OAIG;IACH,qBAHW,MAAM,YACN;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,EAMxB;IADC,iBAAoB;CAEvB;AAED;;GAEG;AACH;IACE;;;;OAIG;IACH,qBAHW,MAAM,YACN;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,EAMxB;IADC,iBAAoB;CAEvB;AA9CD;;GAEG;AACH;IACE;;;;OAIG;IACH,qBAHW,MAAM,YACN;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,EAMxB;IADC,iBAAoB;CAEvB"}

package/build/src/database/advisory-lock-runner.js

@@ -0,0 +1,176 @@
+// @ts-check
+import timeout from "awaitery/build/timeout.js";
+/**
+ * Thrown when an advisory lock could not be acquired before `timeoutMs` elapsed.
+ */
+class AdvisoryLockTimeoutError extends Error {
+    /**
+     * Runs constructor.
+     * @param {string} message - Error message.
+     * @param {{name: string}} args - The advisory lock name that timed out.
+     */
+    constructor(message, { name }) {
+        super(message);
+        this.name = "AdvisoryLockTimeoutError";
+        this.lockName = name;
+    }
+}
+/**
+ * Thrown when `withAdvisoryLockOrFail` finds the lock already held.
+ */
+class AdvisoryLockBusyError extends Error {
+    /**
+     * Runs constructor.
+     * @param {string} message - Error message.
+     * @param {{name: string}} args - The advisory lock name that was already held.
+     */
+    constructor(message, { name }) {
+        super(message);
+        this.name = "AdvisoryLockBusyError";
+        this.lockName = name;
+    }
+}
+/**
+ * Thrown when a callback holds an advisory lock longer than `holdTimeoutMs`.
+ */
+class AdvisoryLockHoldTimeoutError extends Error {
+    /**
+     * Runs constructor.
+     * @param {string} message - Error message.
+     * @param {{name: string}} args - The advisory lock name whose hold timed out.
+     */
+    constructor(message, { name }) {
+        super(message);
+        this.name = "AdvisoryLockHoldTimeoutError";
+        this.lockName = name;
+    }
+}
+/**
+ * Runs advisory locks on the caller connection by default, using a dedicated
+ * lock connection only when a positive hold timeout needs separate ownership.
+ */
+export default class AdvisoryLockRunner {
+    /**
+     * Creates an advisory-lock runner for one model database identifier.
+     * @param {{configuration: import("../configuration.js").default, connectionProvider: () => import("./drivers/base.js").default, databaseIdentifier: string}} args - Runner dependencies.
+     */
+    constructor({ configuration, connectionProvider, databaseIdentifier }) {
+        this.configuration = configuration;
+        this.connectionProvider = connectionProvider;
+        this.databaseIdentifier = databaseIdentifier;
+    }
+    /**
+     * Runs a callback after acquiring the advisory lock, waiting up to `timeoutMs`.
+     * @template T
+     * @param {string} name - Lock name.
+     * @param {() => Promise<T>} callback - Callback to invoke while the lock is held.
+     * @param {{timeoutMs?: number | null, holdTimeoutMs?: number | null}} [args] - Lock and hold timeout options.
+     * @returns {Promise<T>} - Resolves with the callback result.
+     */
+    async withAdvisoryLock(name, callback, args = {}) {
+        return await this.withLockConnection(args.holdTimeoutMs, async (connection) => {
+            const acquired = await connection.acquireAdvisoryLock(name, args);
+            if (!acquired) {
+                throw new AdvisoryLockTimeoutError(`Timed out waiting for advisory lock ${JSON.stringify(name)}`, { name });
+            }
+            return await this.runLockedCallback({ callback, connection, holdTimeoutMs: args.holdTimeoutMs, name });
+        });
+    }
+    /**
+     * Runs a callback only if the advisory lock can be acquired immediately.
+     * @template T
+     * @param {string} name - Lock name.
+     * @param {() => Promise<T>} callback - Callback to invoke while the lock is held.
+     * @param {{holdTimeoutMs?: number | null}} [args] - Hold timeout options.
+     * @returns {Promise<T>} - Resolves with the callback result.
+     */
+    async withAdvisoryLockOrFail(name, callback, args = {}) {
+        return await this.withLockConnection(args.holdTimeoutMs, async (connection) => {
+            const acquired = await connection.tryAcquireAdvisoryLock(name);
+            if (!acquired) {
+                throw new AdvisoryLockBusyError(`Advisory lock ${JSON.stringify(name)} is already held`, { name });
+            }
+            return await this.runLockedCallback({ callback, connection, holdTimeoutMs: args.holdTimeoutMs, name });
+        });
+    }
+    /**
+     * Runs the lock holder callback and releases the lock from its owning connection.
+     * @template T
+     * @param {{callback: () => Promise<T>, connection: import("./drivers/base.js").default, holdTimeoutMs?: number | null, name: string}} args - Locked callback args.
+     * @returns {Promise<T>} - Resolves with the callback result.
+     */
+    async runLockedCallback({ callback, connection, holdTimeoutMs, name }) {
+        try {
+            return await AdvisoryLockRunner.runWithAdvisoryLockHoldTimeout(name, callback, holdTimeoutMs);
+        }
+        finally {
+            await connection.releaseAdvisoryLock(name);
+        }
+    }
+    /**
+     * Runs lock work on the caller connection unless a positive hold timeout needs
+     * its own lock connection.
+     * @template T
+     * @param {number | null | undefined} holdTimeoutMs - Max hold time; positive values use a dedicated lock connection.
+     * @param {(connection: import("./drivers/base.js").default) => Promise<T>} callback - Callback receiving the connection that owns the advisory lock.
+     * @returns {Promise<T>} - Resolves with the callback result.
+     */
+    async withLockConnection(holdTimeoutMs, callback) {
+        if (holdTimeoutMs && holdTimeoutMs > 0) {
+            return await this.withDedicatedConnection(callback);
+        }
+        return await callback(this.connectionProvider());
+    }
+    /**
+     * Spawns a hold-timeout lock connection and closes it after lock work completes when
+     * the spawned driver owns the underlying physical connection.
+     * @template T
+     * @param {(connection: import("./drivers/base.js").default) => Promise<T>} callback - Callback that receives the dedicated lock connection.
+     * @returns {Promise<T>} - Resolves with the callback result.
+     */
+    async withDedicatedConnection(callback) {
+        const connection = await this.configuration.getDatabasePool(this.databaseIdentifier).spawnConnection();
+        try {
+            return await callback(connection);
+        }
+        finally {
+            if (!connection.getArgs().getConnection) {
+                await connection.close();
+            }
+        }
+    }
+    /**
+     * Runs `callback`, rejecting with `AdvisoryLockHoldTimeoutError` if it has
+     * not settled within `holdTimeoutMs`. The callback is not cancelled; callers
+     * use a dedicated advisory-lock connection so the lock can still be released.
+     * @template T
+     * @param {string} name - Lock name (for the error message).
+     * @param {() => Promise<T>} callback - Callback holding the lock.
+     * @param {number | null} [holdTimeoutMs] - Max hold time; falsy disables the timeout.
+     * @returns {Promise<T>} - Resolves with the callback result.
+     */
+    static async runWithAdvisoryLockHoldTimeout(name, callback, holdTimeoutMs) {
+        if (!holdTimeoutMs || holdTimeoutMs <= 0) {
+            return await callback();
+        }
+        let callbackSettled = false;
+        try {
+            return await timeout({ timeout: holdTimeoutMs }, async () => {
+                try {
+                    return await callback();
+                }
+                finally {
+                    callbackSettled = true;
+                }
+            });
+        }
+        catch (error) {
+            if (!callbackSettled) {
+                throw new AdvisoryLockHoldTimeoutError(`Advisory lock ${JSON.stringify(name)} held longer than ${holdTimeoutMs}ms`, { name });
+            }
+            throw error;
+        }
+    }
+}
+export { AdvisoryLockBusyError, AdvisoryLockHoldTimeoutError, AdvisoryLockTimeoutError };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWR2aXNvcnktbG9jay1ydW5uZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZGF0YWJhc2UvYWR2aXNvcnktbG9jay1ydW5uZXIuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sT0FBTyxNQUFNLDJCQUEyQixDQUFBO0FBRS9DOztHQUVHO0FBQ0gsTUFBTSx3QkFBeUIsU0FBUSxLQUFLO0lBQzFDOzs7O09BSUc7SUFDSCxZQUFZLE9BQU8sRUFBRSxFQUFDLElBQUksRUFBQztRQUN6QixLQUFLLENBQUMsT0FBTyxDQUFDLENBQUE7UUFDZCxJQUFJLENBQUMsSUFBSSxHQUFHLDBCQUEwQixDQUFBO1FBQ3RDLElBQUksQ0FBQyxRQUFRLEdBQUcsSUFBSSxDQUFBO0lBQ3RCLENBQUM7Q0FDRjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxxQkFBc0IsU0FBUSxLQUFLO0lBQ3ZDOzs7O09BSUc7SUFDSCxZQUFZLE9BQU8sRUFBRSxFQUFDLElBQUksRUFBQztRQUN6QixLQUFLLENBQUMsT0FBTyxDQUFDLENBQUE7UUFDZCxJQUFJLENBQUMsSUFBSSxHQUFHLHVCQUF1QixDQUFBO1FBQ25DLElBQUksQ0FBQyxRQUFRLEdBQUcsSUFBSSxDQUFBO0lBQ3RCLENBQUM7Q0FDRjtBQUVEOztHQUVHO0FBQ0gsTUFBTSw0QkFBNkIsU0FBUSxLQUFLO0lBQzlDOzs7O09BSUc7SUFDSCxZQUFZLE9BQU8sRUFBRSxFQUFDLElBQUksRUFBQztRQUN6QixLQUFLLENBQUMsT0FBTyxDQUFDLENBQUE7UUFDZCxJQUFJLENBQUMsSUFBSSxHQUFHLDhCQUE4QixDQUFBO1FBQzFDLElBQUksQ0FBQyxRQUFRLEdBQUcsSUFBSSxDQUFBO0lBQ3RCLENBQUM7Q0FDRjtBQUVEOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxPQUFPLE9BQU8sa0JBQWtCO0lBQ3JDOzs7T0FHRztJQUNILFlBQVksRUFBQyxhQUFhLEVBQUUsa0JBQWtCLEVB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QkFBNEIsRUFBRSx3QkFBd0IsRUFBQyxDQUFBIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQHRzLWNoZWNrXG5cbmltcG9ydCB0aW1lb3V0IGZyb20gXCJhd2FpdGVyeS9idWlsZC90aW1lb3V0LmpzXCJcblxuLyoqXG4gKiBUaHJvd24gd2hlbiBhbiBhZHZpc29yeSBsb2NrIGNvdWxkIG5vdCBiZSBhY3F1aXJlZCBiZWZvcmUgYHRpbWVvdXRNc2AgZWxhcHNlZC5cbiAqL1xuY2xhc3MgQWR2aXNvcnlMb2NrVGltZW91dEVycm9yIGV4dGVuZHMgRXJyb3Ige1xuICAvKipcbiAgICogUnVucyBjb25zdHJ1Y3Rvci5cbiAgICogQHBhcmFtIHtzdHJpbmd9IG1lc3NhZ2UgLSBFcnJvciBtZXNzYWdlLlxuICAgKiBAcGFyYW0ge3tuYW1lOiBzdHJpbmd9fSBhcmdzIC0gVGhlIGFkdmlzb3J5IGxvY2sgbmFtZSB0aGF0IHRpbWVkIG91dC5cbiAgICovXG4gIGNvbnN0cnVjdG9yKG1lc3NhZ2UsIHtuYW1lfSkge1xuICAgIHN1cGVyKG1lc3NhZ2UpXG4gICAgdGhpcy5uYW1lID0gXCJBZHZpc29yeUxvY2tUaW1lb3V0RXJyb3JcIlxuICAgIHRoaXMubG9ja05hbWUgPSBuYW1lXG4gIH1cbn1cblxuLyoqXG4gKiBUaHJvd24gd2hlbiBgd2l0aEFkdmlzb3J5TG9ja09yRmFpbGAgZmluZHMgdGhlIGxvY2sgYWxyZWFkeSBoZWxkLlxuICovXG5jbGFzcyBBZHZpc29yeUxvY2tCdXN5RXJyb3IgZXh0ZW5kcyBFcnJvciB7XG4gIC8qKlxuICAgKiBSdW5zIGNvbnN0cnVjdG9yLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gbWVzc2FnZSAtIEVycm9yIG1lc3NhZ2UuXG4gICAqIEBwYXJhbSB7e25hbWU6IHN0cmluZ319IGFyZ3MgLSBUaGUgYWR2aXNvcnkgbG9jayBuYW1lIHRoYXQgd2FzIGFscmVhZHkgaGVsZC5cbiAgICovXG4gIGNvbnN0cnVjdG9yKG1lc3NhZ2UsIHtuYW1lfSkge1xuICAgIHN1cGVyKG1lc3NhZ2UpXG4gICAgdGhpcy5uYW1lID0gXCJBZHZpc29yeUxvY2tCdXN5RXJyb3JcIlxuICAgIHRoaXMubG9ja05hbWUgPSBuYW1lXG4gIH1cbn1cblxuLyoqXG4gKiBUaHJvd24gd2hlbiBhIGNhbGxiYWNrIGhvbGRzIGFuIGFkdmlzb3J5IGxvY2sgbG9uZ2VyIHRoYW4gYGhvbGRUaW1lb3V0TXNgLlxuICovXG5jbGFzcyBBZHZpc29yeUxvY2tIb2xkVGltZW91dEVycm9yIGV4dGVuZHMgRXJyb3Ige1xuICAvKipcbiAgICogUnVucyBjb25zdHJ1Y3Rvci5cbiAgICogQHBhcmFtIHtzdHJpbmd9IG1lc3NhZ2UgLSBFcnJvciBtZXNzYWdlLlxuICAgKiBAcGFyYW0ge3tuYW1lOiBzdHJpbmd9fSBhcmdzIC0gVGhlIGFkdmlzb3J5IGxvY2sgbmFtZSB3aG9zZSBob2xkIHRpbWVkIG91dC5cbiAgICovXG4gIGNvbnN0cnVjdG9yKG1lc3NhZ2UsIHtuYW1lfSkge1xuICAgIHN1cGVyKG1lc3NhZ2UpXG4gICAgdGhpcy5uYW1lID0gXCJBZHZpc29yeUxvY2tIb2xkVGltZW91dEVycm9yXCJcbiAgICB0aGlzLmxvY2tOYW1lID0gbmFtZVxuICB9XG59XG5cbi8qKlxuICogUnVucyBhZHZpc29yeSBsb2NrcyBvbiB0aGUgY2FsbGVyIGNvbm5lY3Rpb24gYnkgZGVmYXVsdCwgdXNpbmcgYSBkZWRpY2F0ZWRcbiAqIGxvY2sgY29ubmVjdGlvbiBvbmx5IHdoZW4gYSBwb3NpdGl2ZSBob2xkIHRpbWVvdXQgbmVlZHMgc2VwYXJhdGUgb3duZXJzaGlwLlxuICovXG5leHBvcnQgZGVmYXVsdCBjbGFzcyBBZHZpc29yeUxvY2tSdW5uZXIge1xuICAvKipcbiAgICogQ3JlYXRlcyBhbiBhZHZpc29yeS1sb2NrIHJ1bm5lciBmb3Igb25lIG1vZGVsIGRhdGFiYXNlIGlkZW50aWZpZXIuXG4gICAqIEBwYXJhbSB7e2NvbmZpZ3VyYXRpb246IGltcG9ydChcIi4uL2NvbmZpZ3VyYXRpb24uanNcIikuZGVmYXVsdCwgY29ubmVjdGlvblByb3ZpZGVyOiAoKSA9PiBpbXBvcnQoXCIuL2RyaXZlcnMvYmFzZS5qc1wiKS5kZWZhdWx0LCBkYXRhYmFzZUlkZW50aWZpZXI6IHN0cmluZ319IGFyZ3MgLSBSdW5uZXIgZGVwZW5kZW5jaWVzLlxuICAgKi9cbiAgY29uc3RydWN0b3Ioe2NvbmZpZ3VyYXRpb24sIGNvbm5lY3Rpb25Qcm92aWRlciwgZGF0YWJhc2VJZGVudGlmaWVyfSkge1xuICAgIHRoaXMuY29uZmlndXJhdGlvbiA9IGNvbmZpZ3VyYXRpb25cbiAgICB0aGlzLmNvbm5lY3Rpb25Qcm92aWRlciA9IGNvbm5lY3Rpb25Qcm92aWRlclxuICAgIHRoaXMuZGF0YWJhc2VJZGVudGlmaWVyID0gZGF0YWJhc2VJZGVudGlmaWVyXG4gIH1cblxuICAvKipcbiAgICogUnVucyBhIGNhbGxiYWNrIGFmdGVyIGFjcXVpcmluZyB0aGUgYWR2aXNvcnkgbG9jaywgd2FpdGluZyB1cCB0byBgdGltZW91dE1zYC5cbiAgICogQHRlbXBsYXRlIFRcbiAgICogQHBhcmFtIHtzdHJpbmd9IG5hbWUgLSBMb2NrIG5hbWUuXG4gICAqIEBwYXJhbSB7KCkgPT4gUHJvbWlzZTxUPn0gY2FsbGJhY2sgLSBDYWxsYmFjayB0byBpbnZva2Ugd2hpbGUgdGhlIGxvY2sgaXMgaGVsZC5cbiAgICogQHBhcmFtIHt7dGltZW91dE1zPzogbnVtYmVyIHwgbnVsbCwgaG9sZFRpbWVvdXRNcz86IG51bWJlciB8IG51bGx9fSBbYXJnc10gLSBMb2NrIGFuZCBob2xkIHRpbWVvdXQgb3B0aW9ucy5cbiAgICogQHJldHVybnMge1Byb21pc2U8VD59IC0gUmVzb2x2ZXMgd2l0aCB0aGUgY2FsbGJhY2sgcmVzdWx0LlxuICAgKi9cbiAgYXN5bmMgd2l0aEFkdmlzb3J5TG9jayhuYW1lLCBjYWxsYmFjaywgYXJncyA9IHt9KSB7XG4gICAgcmV0dXJuIGF3YWl0IHRoaXMud2l0aExvY2tDb25uZWN0aW9uKGFyZ3MuaG9sZFRpbWVvdXRNcywgYXN5bmMgKGNvbm5lY3Rpb24pID0+IHtcbiAgICAgIGNvbnN0IGFjcXVpcmVkID0gYXdhaXQgY29ubmVjdGlvbi5hY3F1aXJlQWR2aXNvcnlMb2NrKG5hbWUsIGFyZ3MpXG5cbiAgICAgIGlmICghYWNxdWlyZWQpIHtcbiAgICAgICAgdGhyb3cgbmV3IEFkdmlzb3J5TG9ja1RpbWVvdXRFcnJvcihgVGltZWQgb3V0IHdhaXRpbmcgZm9yIGFkdmlzb3J5IGxvY2sgJHtKU09OLnN0cmluZ2lmeShuYW1lKX1gLCB7bmFtZX0pXG4gICAgICB9XG5cbiAgICAgIHJldHVybiBhd2FpdCB0aGlzLnJ1bkxvY2tlZENhbGxiYWNrKHtjYWxsYmFjaywgY29ubmVjdGlvbiwgaG9sZFRpbWVvdXRNczogYXJncy5ob2xkVGltZW91dE1zLCBuYW1lfSlcbiAgICB9KVxuICB9XG5cbiAgLyoqXG4gICAqIFJ1bnMgYSBjYWxsYmFjayBvbmx5IGlmIHRoZSBhZHZpc29yeSBsb2NrIGNhbiBiZSBhY3F1aXJlZCBpbW1lZGlhdGVseS5cbiAgICogQHRlbXBsYXRlIFRcbiAgICogQHBhcmFtIHtzdHJpbmd9IG5hbWUgLSBMb2NrIG5hbWUuXG4gICAqIEBwYXJhbSB7KCkgPT4gUHJvbWlzZTxUPn0gY2FsbGJhY2sgLSBDYWxsYmFjayB0byBpbnZva2Ugd2hpbGUgdGhlIGxvY2sgaXMgaGVsZC5cbiAgICogQHBhcmFtIHt7aG9sZFRpbWVvdXRNcz86IG51bWJlciB8IG51bGx9fSBbYXJnc10gLSBIb2xkIHRpbWVvdXQgb3B0aW9ucy5cbiAgICogQHJldHVybnMge1Byb21pc2U8VD59IC0gUmVzb2x2ZXMgd2l0aCB0aGUgY2FsbGJhY2sgcmVzdWx0LlxuICAgKi9cbiAgYXN5bmMgd2l0aEFkdmlzb3J5TG9ja09yRmFpbChuYW1lLCBjYWxsYmFjaywgYXJncyA9IHt9KSB7XG4gICAgcmV0dXJuIGF3YWl0IHRoaXMud2l0aExvY2tDb25uZWN0aW9uKGFyZ3MuaG9sZFRpbWVvdXRNcywgYXN5bmMgKGNvbm5lY3Rpb24pID0+IHtcbiAgICAgIGNvbnN0IGFjcXVpcmVkID0gYXdhaXQgY29ubmVjdGlvbi50cnlBY3F1aXJlQWR2aXNvcnlMb2NrKG5hbWUpXG5cbiAgICAgIGlmICghYWNxdWlyZWQpIHtcbiAgICAgICAgdGhyb3cgbmV3IEFkdmlzb3J5TG9ja0J1c3lFcnJvcihgQWR2aXNvcnkgbG9jayAke0pTT04uc3RyaW5naWZ5KG5hbWUpfSBpcyBhbHJlYWR5IGhlbGRgLCB7bmFtZX0pXG4gICAgICB9XG5cbiAgICAgIHJldHVybiBhd2FpdCB0aGlzLnJ1bkxvY2tlZENhbGxiYWNrKHtjYWxsYmFjaywgY29ubmVjdGlvbiwgaG9sZFRpbWVvdXRNczogYXJncy5ob2xkVGltZW91dE1zLCBuYW1lfSlcbiAgICB9KVxuICB9XG5cbiAgLyoqXG4gICAqIFJ1bnMgdGhlIGxvY2sgaG9sZGVyIGNhbGxiYWNrIGFuZCByZWxlYXNlcyB0aGUgbG9jayBmcm9tIGl0cyBvd25pbmcgY29ubmVjdGlvbi5cbiAgICogQHRlbXBsYXRlIFRcbiAgICogQHBhcmFtIHt7Y2FsbGJhY2s6ICgpID0+IFByb21pc2U8VD4sIGNvbm5lY3Rpb246IGltcG9ydChcIi4vZHJpdmVycy9iYXNlLmpzXCIpLmRlZmF1bHQsIGhvbGRUaW1lb3V0TXM/OiBudW1iZXIgfCBudWxsLCBuYW1lOiBzdHJpbmd9fSBhcmdzIC0gTG9ja2VkIGNhbGxiYWNrIGFyZ3MuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPFQ+fSAtIFJlc29sdmVzIHdpdGggdGhlIGNhbGxiYWNrIHJlc3VsdC5cbiAgICovXG4gIGFzeW5jIHJ1bkxvY2tlZENhbGxiYWNrKHtjYWxsYmFjaywgY29ubmVjdGlvbiwgaG9sZFRpbWVvdXRNcywgbmFtZX0pIHtcbiAgICB0cnkge1xuICAgICAgcmV0dXJuIGF3YWl0IEFkdmlzb3J5TG9ja1J1bm5lci5ydW5XaXRoQWR2aXNvcnlMb2NrSG9sZFRpbWVvdXQobmFtZSwgY2FsbGJhY2ssIGhvbGRUaW1lb3V0TXMpXG4gICAgfSBmaW5hbGx5IHtcbiAgICAgIGF3YWl0IGNvbm5lY3Rpb24ucmVsZWFzZUFkdmlzb3J5TG9jayhuYW1lKVxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBSdW5zIGxvY2sgd29yayBvbiB0aGUgY2FsbGVyIGNvbm5lY3Rpb24gdW5sZXNzIGEgcG9zaXRpdmUgaG9sZCB0aW1lb3V0IG5lZWRzXG4gICAqIGl0cyBvd24gbG9jayBjb25uZWN0aW9uLlxuICAgKiBAdGVtcGxhdGUgVFxuICAgKiBAcGFyYW0ge251bWJlciB8IG51bGwgfCB1bmRlZmluZWR9IGhvbGRUaW1lb3V0TXMgLSBNYXggaG9sZCB0aW1lOyBwb3NpdGl2ZSB2YWx1ZXMgdXNlIGEgZGVkaWNhdGVkIGxvY2sgY29ubmVjdGlvbi5cbiAgICogQHBhcmFtIHsoY29ubmVjdGlvbjogaW1wb3J0KFwiLi9kcml2ZXJzL2Jhc2UuanNcIikuZGVmYXVsdCkgPT4gUHJvbWlzZTxUPn0gY2FsbGJhY2sgLSBDYWxsYmFjayByZWNlaXZpbmcgdGhlIGNvbm5lY3Rpb24gdGhhdCBvd25zIHRoZSBhZHZpc29yeSBsb2NrLlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTxUPn0gLSBSZXNvbHZlcyB3aXRoIHRoZSBjYWxsYmFjayByZXN1bHQuXG4gICAqL1xuICBhc3luYyB3aXRoTG9ja0Nvbm5lY3Rpb24oaG9sZFRpbWVvdXRNcywgY2FsbGJhY2spIHtcbiAgICBpZiAoaG9sZFRpbWVvdXRNcyAmJiBob2xkVGltZW91dE1zID4gMCkge1xuICAgICAgcmV0dXJuIGF3YWl0IHRoaXMud2l0aERlZGljYXRlZENvbm5lY3Rpb24oY2FsbGJhY2spXG4gICAgfVxuXG4gICAgcmV0dXJuIGF3YWl0IGNhbGxiYWNrKHRoaXMuY29ubmVjdGlvblByb3ZpZGVyKCkpXG4gIH1cblxuICAvKipcbiAgICogU3Bhd25zIGEgaG9sZC10aW1lb3V0IGxvY2sgY29ubmVjdGlvbiBhbmQgY2xvc2VzIGl0IGFmdGVyIGxvY2sgd29yayBjb21wbGV0ZXMgd2hlblxuICAgKiB0aGUgc3Bhd25lZCBkcml2ZXIgb3ducyB0aGUgdW5kZXJseWluZyBwaHlzaWNhbCBjb25uZWN0aW9uLlxuICAgKiBAdGVtcGxhdGUgVFxuICAgKiBAcGFyYW0geyhjb25uZWN0aW9uOiBpbXBvcnQoXCIuL2RyaXZlcnMvYmFzZS5qc1wiKS5kZWZhdWx0KSA9PiBQcm9taXNlPFQ+fSBjYWxsYmFjayAtIENhbGxiYWNrIHRoYXQgcmVjZWl2ZXMgdGhlIGRlZGljYXRlZCBsb2NrIGNvbm5lY3Rpb24uXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPFQ+fSAtIFJlc29sdmVzIHdpdGggdGhlIGNhbGxiYWNrIHJlc3VsdC5cbiAgICovXG4gIGFzeW5jIHdpdGhEZWRpY2F0ZWRDb25uZWN0aW9uKGNhbGxiYWNrKSB7XG4gICAgY29uc3QgY29ubmVjdGlvbiA9IGF3YWl0IHRoaXMuY29uZmlndXJhdGlvbi5nZXREYXRhYmFzZVBvb2wodGhpcy5kYXRhYmFzZUlkZW50aWZpZXIpLnNwYXduQ29ubmVjdGlvbigpXG5cbiAgICB0cnkge1xuICAgICAgcmV0dXJuIGF3YWl0IGNhbGxiYWNrKGNvbm5lY3Rpb24pXG4gICAgfSBmaW5hbGx5IHtcbiAgICAgIGlmICghY29ubmVjdGlvbi5nZXRBcmdzKCkuZ2V0Q29ubmVjdGlvbikge1xuICAgICAgICBhd2FpdCBjb25uZWN0aW9uLmNsb3NlKClcbiAgICAgIH1cbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogUnVucyBgY2FsbGJhY2tgLCByZWplY3Rpbmcgd2l0aCBgQWR2aXNvcnlMb2NrSG9sZFRpbWVvdXRFcnJvcmAgaWYgaXQgaGFzXG4gICAqIG5vdCBzZXR0bGVkIHdpdGhpbiBgaG9sZFRpbWVvdXRNc2AuIFRoZSBjYWxsYmFjayBpcyBub3QgY2FuY2VsbGVkOyBjYWxsZXJzXG4gICAqIHVzZSBhIGRlZGljYXRlZCBhZHZpc29yeS1sb2NrIGNvbm5lY3Rpb24gc28gdGhlIGxvY2sgY2FuIHN0aWxsIGJlIHJlbGVhc2VkLlxuICAgKiBAdGVtcGxhdGUgVFxuICAgKiBAcGFyYW0ge3N0cmluZ30gbmFtZSAtIExvY2sgbmFtZSAoZm9yIHRoZSBlcnJvciBtZXNzYWdlKS5cbiAgICogQHBhcmFtIHsoKSA9PiBQcm9taXNlPFQ+fSBjYWxsYmFjayAtIENhbGxiYWNrIGhvbGRpbmcgdGhlIGxvY2suXG4gICAqIEBwYXJhbSB7bnVtYmVyIHwgbnVsbH0gW2hvbGRUaW1lb3V0TXNdIC0gTWF4IGhvbGQgdGltZTsgZmFsc3kgZGlzYWJsZXMgdGhlIHRpbWVvdXQuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPFQ+fSAtIFJlc29sdmVzIHdpdGggdGhlIGNhbGxiYWNrIHJlc3VsdC5cbiAgICovXG4gIHN0YXRpYyBhc3luYyBydW5XaXRoQWR2aXNvcnlMb2NrSG9sZFRpbWVvdXQobmFtZSwgY2FsbGJhY2ssIGhvbGRUaW1lb3V0TXMpIHtcbiAgICBpZiAoIWhvbGRUaW1lb3V0TXMgfHwgaG9sZFRpbWVvdXRNcyA8PSAwKSB7XG4gICAgICByZXR1cm4gYXdhaXQgY2FsbGJhY2soKVxuICAgIH1cblxuICAgIGxldCBjYWxsYmFja1NldHRsZWQgPSBmYWxzZVxuXG4gICAgdHJ5IHtcbiAgICAgIHJldHVybiBhd2FpdCB0aW1lb3V0KHt0aW1lb3V0OiBob2xkVGltZW91dE1zfSwgYXN5bmMgKCkgPT4ge1xuICAgICAgICB0cnkge1xuICAgICAgICAgIHJldHVybiBhd2FpdCBjYWxsYmFjaygpXG4gICAgICAgIH0gZmluYWxseSB7XG4gICAgICAgICAgY2FsbGJhY2tTZXR0bGVkID0gdHJ1ZVxuICAgICAgICB9XG4gICAgICB9KVxuICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICBpZiAoIWNhbGxiYWNrU2V0dGxlZCkge1xuICAgICAgICB0aHJvdyBuZXcgQWR2aXNvcnlMb2NrSG9sZFRpbWVvdXRFcnJvcihgQWR2aXNvcnkgbG9jayAke0pTT04uc3RyaW5naWZ5KG5hbWUpfSBoZWxkIGxvbmdlciB0aGFuICR7aG9sZFRpbWVvdXRNc31tc2AsIHtuYW1lfSlcbiAgICAgIH1cblxuICAgICAgdGhyb3cgZXJyb3JcbiAgICB9XG4gIH1cbn1cblxuZXhwb3J0IHtBZHZpc29yeUxvY2tCdXN5RXJyb3IsIEFkdmlzb3J5TG9ja0hvbGRUaW1lb3V0RXJyb3IsIEFkdmlzb3J5TG9ja1RpbWVvdXRFcnJvcn1cbiJdfQ==

package/build/src/database/drivers/mysql/index.d.ts

@@ -1,9 +1,10 @@
 export default class VelociousDatabaseDriversMysql extends Base {
+    /** @type {import("mysql").Pool | undefined} */
+    pool: import("mysql").Pool | undefined;
     /** @type {string | null} */
     _desiredSessionTimeZone: string | null;
     /** @type {string | null} */
     _currentSessionTimeZone: string | null;
-    pool: mysql.Pool | undefined;
     /**
      * On pool error.
      * @param {Error} error - Error from the connection attempt.
@@ -68,6 +69,5 @@ export default class VelociousDatabaseDriversMysql extends Base {
     _options: Options | undefined;
 }
 import Base from "../base.js";
-import mysql from "mysql";
 import Options from "./options.js";
 //# sourceMappingURL=index.d.ts.map

package/build/src/database/drivers/mysql/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/database/drivers/mysql/index.js"],"names":[],"mappings":"AAgCA;IACE,4BAA4B;IAC5B,yBADW,MAAM,GAAG,IAAI,CACU;IAElC,4BAA4B;IAC5B,yBADW,MAAM,GAAG,IAAI,CACM;IAQ5B,6BAAqF;IAIvF;;;OAGG;IACH,cAAe,OAFJ,KAES,UAEnB;IAyCD;;;OAGG;IACH,6BAFa,MAAM,GAAG,IAAI,CAIzB;IAED;;;OAGG;IACH,oCAFW,MAAM,GAAG,IAAI,QAIvB;IAED;;;OAGG;IACH,6BAFa,MAAM,GAAG,IAAI,CAIzB;IAED;;OAEG;IACH,oCAEC;IAED;;;OAGG;IACH,yBAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAED;;;;OAIG;IACH,6BAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAS5B;IAED;;;OAGG;IACH,eAFa,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAmB7B;IAcD;;;;;;OAMG;IACH,gCALW,MAAM,SAEd;QAAuB,WAAW;KAClC,GAAU,MAAM,EAAE,CAOpB;IAoDD;;;OAGG;IACH,mBAFa,OAAO,CAAC,MAAM,CAAC,CAM3B;IA4GD;;;;OAIG;IACH,aAHW,MAAM,GACJ,MAAM,CAQlB;IAoEqB,8BAA2C;CAuGlE;iBAriBgB,YAAY;kBAUX,OAAO;oBADL,cAAc"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/database/drivers/mysql/index.js"],"names":[],"mappings":"AAgCA;IACE,+CAA+C;IAC/C,MADW,OAAO,OAAO,EAAE,IAAI,GAAG,SAAS,CAC3B;IAEhB,4BAA4B;IAC5B,yBADW,MAAM,GAAG,IAAI,CACU;IAElC,4BAA4B;IAC5B,yBADW,MAAM,GAAG,IAAI,CACM;IAY9B;;;OAGG;IACH,cAAe,OAFJ,KAES,UAEnB;IAyCD;;;OAGG;IACH,6BAFa,MAAM,GAAG,IAAI,CAIzB;IAED;;;OAGG;IACH,oCAFW,MAAM,GAAG,IAAI,QAIvB;IAED;;;OAGG;IACH,6BAFa,MAAM,GAAG,IAAI,CAIzB;IAED;;OAEG;IACH,oCAEC;IAED;;;OAGG;IACH,yBAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAED;;;;OAIG;IACH,6BAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAS5B;IAED;;;OAGG;IACH,eAFa,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAmB7B;IAcD;;;;;;OAMG;IACH,gCALW,MAAM,SAEd;QAAuB,WAAW;KAClC,GAAU,MAAM,EAAE,CAOpB;IAoDD;;;OAGG;IACH,mBAFa,OAAO,CAAC,MAAM,CAAC,CAM3B;IA4GD;;;;OAIG;IACH,aAHW,MAAM,GACJ,MAAM,CAQlB;IAoEqB,8BAA2C;CAuGlE;iBAxiBgB,YAAY;oBAST,cAAc"}