velocious 1.0.449 → 1.0.451

package/build/database/pool/async-tracked-multi-connection.js

@@ -43,32 +43,32 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
 
   /**
    * Connections.
-    @type {import("../drivers/base.js").default[]} */
+   * @type {import("../drivers/base.js").default[]} */
   connections = []
 
   /**
    * Connections in use.
-    @type {Record<number, import("../drivers/base.js").default>} */
+   * @type {Record<number, import("../drivers/base.js").default>} */
   connectionsInUse = {}
 
   /**
    * Pending checkouts.
-    @type {PendingCheckout[]} */
+   * @type {PendingCheckout[]} */
   pendingCheckouts = []
 
   /**
    * Connections being spawned.
-    @type {number} */
+   * @type {number} */
   connectionsBeingSpawned = 0
 
   /**
    * Pending checkout drain promise.
-    @type {Promise<void> | undefined} */
+   * @type {Promise<void> | undefined} */
   pendingCheckoutDrainPromise = undefined
 
   /**
    * Idle connection reaper timer.
-    @type {ReturnType<typeof setTimeout> | undefined} */
+   * @type {ReturnType<typeof setTimeout> | undefined} */
   idleConnectionReaperTimer = undefined
 
   /**
@@ -101,7 +101,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
     super({configuration, identifier})
     this._withoutCurrentConnectionContext = /**
                                              * Narrows the runtime value to the documented type.
-                                              @type {(callback: () => ?) => ?} */ ((callback) => this.asyncLocalStorage.run(undefined, callback))
+                                             * @type {(callback: () => ?) => ?} */ ((callback) => this.asyncLocalStorage.run(undefined, callback))
   }
 
   /**
@@ -113,7 +113,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
     const id = connection.getIdSeq()
     const trackedConnection = /**
                                * Narrows the runtime value to the documented type.
-                                @type {import("../drivers/base.js").default & {[CLOSED_CONNECTION]?: boolean, [CONNECTION_CHECKED_OUT_AT]?: number, [IDLE_CONNECTION_CHECKED_IN_AT]?: number}} */ (connection)
+                               * @type {import("../drivers/base.js").default & {[CLOSED_CONNECTION]?: boolean, [CONNECTION_CHECKED_OUT_AT]?: number, [IDLE_CONNECTION_CHECKED_IN_AT]?: number}} */ (connection)
 
     if (trackedConnection[CLOSED_CONNECTION]) {
       this.untrackConnectionInUse(connection, id)
@@ -245,7 +245,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
   connectionMatchesReuseKey(connection, reuseKey) {
     const connectionWithPoolKey = /**
                                    * Narrows the runtime value to the documented type.
-                                    @type {import("../drivers/base.js").default & {[POOL_CONFIGURATION_KEY]?: string}} */ (connection)
+                                   * @type {import("../drivers/base.js").default & {[POOL_CONFIGURATION_KEY]?: string}} */ (connection)
 
     return connectionWithPoolKey[POOL_CONFIGURATION_KEY] === reuseKey
   }
@@ -263,7 +263,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
 
     const trackedConnection = /**
                                * Narrows the runtime value to the documented type.
-                                @type {import("../drivers/base.js").default & {[CONNECTION_CHECKED_OUT_AT]?: number, [IDLE_CONNECTION_CHECKED_IN_AT]?: number}} */ (connection)
+                               * @type {import("../drivers/base.js").default & {[CONNECTION_CHECKED_OUT_AT]?: number, [IDLE_CONNECTION_CHECKED_IN_AT]?: number}} */ (connection)
     delete trackedConnection[IDLE_CONNECTION_CHECKED_IN_AT]
     trackedConnection[CONNECTION_CHECKED_OUT_AT] = Date.now()
 
@@ -364,7 +364,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
       const connection = await this.spawnConnectionWithConfiguration(databaseConfig)
       const connectionWithPoolKey = /**
                                      * Narrows the runtime value to the documented type.
-                                      @type {import("../drivers/base.js").default & {[POOL_CONFIGURATION_KEY]?: string}} */ (connection)
+                                     * @type {import("../drivers/base.js").default & {[POOL_CONFIGURATION_KEY]?: string}} */ (connection)
 
       connectionWithPoolKey[POOL_CONFIGURATION_KEY] = reuseKey
       connection.setSchemaCacheInvalidator(() => {
@@ -711,7 +711,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
   setGlobalConnection(connection) {
     const klass = /**
                    * Narrows the runtime value to the documented type.
-                    @type {typeof VelociousDatabasePoolAsyncTrackedMultiConnection} */ (this.constructor)
+                   * @type {typeof VelociousDatabasePoolAsyncTrackedMultiConnection} */ (this.constructor)
     let mapForConfiguration = klass.globalConnections.get(this.configuration)
 
     if (!mapForConfiguration) {
@@ -752,7 +752,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
 
   /**
    * Runs clear test shared connection.
-    @returns {void} */
+   * @returns {void} */
   clearTestSharedConnection() {
     this._testSharedConnection = undefined
   }
@@ -798,7 +798,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
   debugConnectionSnapshots(now) {
     /**
      * Connections.
-      @type {Array<Record<string, ?>>} */
+     * @type {Array<Record<string, ?>>} */
     const connections = []
     const seenConnections = new Set()
 
@@ -818,7 +818,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
     for (const [id, connection] of Object.entries(this.connectionsInUse)) {
       const trackedConnection = /**
                                  * Narrows the runtime value to the documented type.
-                                  @type {import("../drivers/base.js").default & {[CONNECTION_CHECKED_OUT_AT]?: number}} */ (connection)
+                                 * @type {import("../drivers/base.js").default & {[CONNECTION_CHECKED_OUT_AT]?: number}} */ (connection)
       const checkedOutAt = trackedConnection[CONNECTION_CHECKED_OUT_AT]
       const checkedOutForMs = typeof checkedOutAt === "number" ? Math.max(0, now - checkedOutAt) : undefined
 
@@ -840,7 +840,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
 
       const trackedConnection = /**
                                  * Narrows the runtime value to the documented type.
-                                  @type {import("../drivers/base.js").default & {[IDLE_CONNECTION_CHECKED_IN_AT]?: number}} */ (connection)
+                                 * @type {import("../drivers/base.js").default & {[IDLE_CONNECTION_CHECKED_IN_AT]?: number}} */ (connection)
       const checkedInAt = trackedConnection[IDLE_CONNECTION_CHECKED_IN_AT]
       const idleForMs = typeof checkedInAt === "number" ? Math.max(0, now - checkedInAt) : undefined
 
@@ -908,7 +908,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
   getGlobalConnectionForIdentifier() {
     const klass = /**
                    * Narrows the runtime value to the documented type.
-                    @type {typeof VelociousDatabasePoolAsyncTrackedMultiConnection} */ (this.constructor)
+                   * @type {typeof VelociousDatabasePoolAsyncTrackedMultiConnection} */ (this.constructor)
     const mapForConfiguration = klass.globalConnections.get(this.configuration)
 
     return mapForConfiguration?.[this.identifier]
@@ -921,7 +921,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
   clearGlobalConnectionForIdentifier() {
     const klass = /**
                    * Narrows the runtime value to the documented type.
-                    @type {typeof VelociousDatabasePoolAsyncTrackedMultiConnection} */ (this.constructor)
+                   * @type {typeof VelociousDatabasePoolAsyncTrackedMultiConnection} */ (this.constructor)
     const mapForConfiguration = klass.globalConnections.get(this.configuration)
 
     if (!mapForConfiguration) return
@@ -970,14 +970,14 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
 
   /**
    * Runs schedule idle connection reaper.
-    @returns {void} */
+   * @returns {void} */
   scheduleIdleConnectionReaper() {
     if (this.idleConnectionReaperTimer) return
     if (!this.hasIdleConnectionsToReap()) return
 
     const delay = this.nextIdleConnectionReapDelay(/**
                                                     * Narrows the runtime value to the documented type.
-                                                     @type {number} */ (this.idleTimeoutMillis()))
+                                                    * @type {number} */ (this.idleTimeoutMillis()))
 
     this.idleConnectionReaperTimer = setTimeout(() => {
       this.idleConnectionReaperTimer = undefined
@@ -1013,7 +1013,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
 
       const trackedConnection = /**
                                  * Narrows the runtime value to the documented type.
-                                  @type {import("../drivers/base.js").default & {[IDLE_CONNECTION_CHECKED_IN_AT]?: number}} */ (connection)
+                                 * @type {import("../drivers/base.js").default & {[IDLE_CONNECTION_CHECKED_IN_AT]?: number}} */ (connection)
       const checkedInAt = trackedConnection[IDLE_CONNECTION_CHECKED_IN_AT]
 
       if (typeof checkedInAt !== "number") continue
@@ -1072,11 +1072,11 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
   classifyIdleConnectionsForReaping({idleTimeoutMillis, now}) {
     /**
      * Kept connections.
-      @type {import("../drivers/base.js").default[]} */
+     * @type {import("../drivers/base.js").default[]} */
     const keptConnections = []
     /**
      * Expired connections.
-      @type {import("../drivers/base.js").default[]} */
+     * @type {import("../drivers/base.js").default[]} */
     const expiredConnections = []
 
     for (const connection of this.connections) {
@@ -1111,7 +1111,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
   connectionIsClosed(connection) {
     const trackedConnection = /**
                                * Narrows the runtime value to the documented type.
-                                @type {import("../drivers/base.js").default & {[CLOSED_CONNECTION]?: boolean}} */ (connection)
+                               * @type {import("../drivers/base.js").default & {[CLOSED_CONNECTION]?: boolean}} */ (connection)
 
     return Boolean(trackedConnection[CLOSED_CONNECTION])
   }
@@ -1124,7 +1124,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
   idleConnectionExpired({connection, idleTimeoutMillis, now}) {
     const trackedConnection = /**
                                * Narrows the runtime value to the documented type.
-                                @type {import("../drivers/base.js").default & {[IDLE_CONNECTION_CHECKED_IN_AT]?: number}} */ (connection)
+                               * @type {import("../drivers/base.js").default & {[IDLE_CONNECTION_CHECKED_IN_AT]?: number}} */ (connection)
     const checkedInAt = trackedConnection[IDLE_CONNECTION_CHECKED_IN_AT]
 
     return typeof checkedInAt === "number" && now - checkedInAt >= idleTimeoutMillis
@@ -1176,7 +1176,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
 
     const trackedConnection = /**
                                * Narrows the runtime value to the documented type.
-                                @type {import("../drivers/base.js").default & {[CLOSED_CONNECTION]?: boolean, [CONNECTION_CHECKED_OUT_AT]?: number, [IDLE_CONNECTION_CHECKED_IN_AT]?: number}} */ (connection)
+                               * @type {import("../drivers/base.js").default & {[CLOSED_CONNECTION]?: boolean, [CONNECTION_CHECKED_OUT_AT]?: number, [IDLE_CONNECTION_CHECKED_IN_AT]?: number}} */ (connection)
 
     trackedConnection[CLOSED_CONNECTION] = true
     delete trackedConnection[CONNECTION_CHECKED_OUT_AT]
@@ -1198,7 +1198,7 @@ export default class VelociousDatabasePoolAsyncTrackedMultiConnection extends Ba
 
   /**
    * Runs clear idle connection reaper timer.
-    @returns {void} */
+   * @returns {void} */
   clearIdleConnectionReaperTimer() {
     if (!this.idleConnectionReaperTimer) return
 

package/build/database/pool/base-methods-forward.js

@@ -30,18 +30,18 @@ export default function baseMethodsForward(PoolBase) {
 
   const prototype = /**
                      * Narrows the runtime value to the documented type.
-                      @type {Record<string, (...args: Array<?>) => ?>} */ (/**
+                     * @type {Record<string, (...args: Array<?>) => ?>} */ (/**
                                                                             * Narrows the runtime value to the documented type.
-                                                                             @type {?} */ (PoolBase.prototype))
+                                                                            * @type {?} */ (PoolBase.prototype))
 
   for (const forwardMethod of forwardMethods) {
     prototype[forwardMethod] = function(...args) {
       const connection = this.getCurrentConnection()
       const connectionRecord = /**
                                 * Narrows the runtime value to the documented type.
-                                 @type {Record<string, (...args: Array<?>) => ?>} */ (/**
+                                * @type {Record<string, (...args: Array<?>) => ?>} */ (/**
                                                                                        * Narrows the runtime value to the documented type.
-                                                                                        @type {?} */ (connection))
+                                                                                       * @type {?} */ (connection))
       const connectionMethod = connectionRecord[forwardMethod]
 
       if (!connectionMethod) throw new Error(`${forwardMethod} isn't defined on driver`)

package/build/database/pool/base.js

@@ -41,7 +41,7 @@ export const POOL_CONFIGURATION_KEY = Symbol("velociousPoolConfigurationKey")
 
 /**
  * Shared.
-  @type {{currentPool: VelociousDatabasePoolBase | null}} */
+ * @type {{currentPool: VelociousDatabasePoolBase | null}} */
 const shared = {
   currentPool: null
 }
@@ -60,11 +60,11 @@ function stableStringify(value) {
     const entries = Object
       .keys(/**
              * Narrows the runtime value to the documented type.
-              @type {Record<string, ?>} */ (value))
+             * @type {Record<string, ?>} */ (value))
       .sort()
       .map((key) => `${JSON.stringify(key)}:${stableStringify(/**
                                                                * Narrows the runtime value to the documented type.
-                                                                @type {Record<string, ?>} */ (value)[key])}`)
+                                                               * @type {Record<string, ?>} */ (value)[key])}`)
 
     return `{${entries.join(",")}}`
   }
@@ -75,7 +75,7 @@ function stableStringify(value) {
 class VelociousDatabasePoolBase {
   /**
    * Without current connection context.
-    @type {undefined | ((callback: () => ?) => ?)} */
+   * @type {undefined | ((callback: () => ?) => ?)} */
   _withoutCurrentConnectionContext = undefined
 
   /**
@@ -154,7 +154,7 @@ class VelociousDatabasePoolBase {
    * @returns {T} - Callback result.
    */
   withoutCurrentConnectionContext(callback) {
-    if (this._withoutCurrentConnectionContext) return /** Narrows the runtime value to the documented type. @type {T} */ (this._withoutCurrentConnectionContext(callback))
+    if (this._withoutCurrentConnectionContext) return /** @type {T} */ (this._withoutCurrentConnectionContext(callback))
 
     return callback()
   }
@@ -196,7 +196,7 @@ class VelociousDatabasePoolBase {
   connectionMatchesCurrentConfiguration(connection) {
     const connectionWithPoolKey = /**
                                    * Narrows the runtime value to the documented type.
-                                    @type {import("../drivers/base.js").default & {[POOL_CONFIGURATION_KEY]?: string}} */ (connection)
+                                   * @type {import("../drivers/base.js").default & {[POOL_CONFIGURATION_KEY]?: string}} */ (connection)
 
     return connectionWithPoolKey[POOL_CONFIGURATION_KEY] === this.getConfigurationReuseKey()
   }
@@ -257,7 +257,7 @@ class VelociousDatabasePoolBase {
 
     const connectionWithPoolKey = /**
                                    * Narrows the runtime value to the documented type.
-                                    @type {import("../drivers/base.js").default & {[POOL_CONFIGURATION_KEY]?: string}} */ (connection)
+                                   * @type {import("../drivers/base.js").default & {[POOL_CONFIGURATION_KEY]?: string}} */ (connection)
     connectionWithPoolKey[POOL_CONFIGURATION_KEY] = this.getConfigurationReuseKey()
     connection.setSchemaCacheInvalidator(() => {
       this.clearSchemaCache()
@@ -372,7 +372,7 @@ class VelociousDatabasePoolBase {
   debugConnectionSnapshot(connection, details = {}) {
     const connectionWithPoolKey = /**
                                    * Narrows the runtime value to the documented type.
-                                    @type {import("../drivers/base.js").default & {[POOL_CONFIGURATION_KEY]?: string}} */ (connection)
+                                   * @type {import("../drivers/base.js").default & {[POOL_CONFIGURATION_KEY]?: string}} */ (connection)
 
     return {
       ...connection.getDebugSnapshot(),

package/build/database/query/from-base.js

@@ -3,7 +3,7 @@
 export default class VelociousDatabaseQueryFromBase {
   /**
    * Query.
-    @type {import("./index.js").default  | null} */
+   * @type {import("./index.js").default  | null} */
   query = null
 
   /**

package/build/database/query/index.js

@@ -37,7 +37,7 @@ function normalizeJoinObject(join) {
   if (Array.isArray(join)) {
     /**
      * Result.
-      @type {import("./join-object.js").JoinObject} */
+     * @type {import("./join-object.js").JoinObject} */
     const result = {}
 
     for (const entry of join) {
@@ -69,7 +69,7 @@ function normalizeJoinObject(join) {
 
   /**
    * Result.
-    @type {import("./join-object.js").JoinObject} */
+   * @type {import("./join-object.js").JoinObject} */
   const result = {}
 
   for (const [key, value] of Object.entries(join)) {
@@ -157,7 +157,7 @@ export default class VelociousDatabaseQuery {
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {() => import("../drivers/base.js").default} */
+     * @type {() => import("../drivers/base.js").default} */
     this._driverFn = typeof driver === "function" ? driver : () => driver
     this.handler = handler
     this.logger = new Logger(this)
@@ -173,24 +173,24 @@ export default class VelociousDatabaseQuery {
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {Record<string, string[]>} */
+     * @type {Record<string, string[]>} */
     this._preloadSelects = preloadSelects
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {Record<string, string[]>} */
+     * @type {Record<string, string[]>} */
     this._preloadSelectsExtra = preloadSelectsExtra
     this._distinct = distinct
     this._selects = selects
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {import("./where-base.js").default[]} */
+     * @type {import("./where-base.js").default[]} */
     this._wheres = wheres
 
     const boundWhere = /**
                         * Narrows the runtime value to the documented type.
-                         @type {?} */ (this.where.bind(this))
+                        * @type {?} */ (this.where.bind(this))
     boundWhere.not = this.whereNot.bind(this)
     this.where = boundWhere
   }
@@ -202,7 +202,7 @@ export default class VelociousDatabaseQuery {
   clone() {
     const QueryClass = /**
                         * Narrows the runtime value to the documented type.
-                         @type {new (args: QueryArgsType) => this} */ (this.constructor)
+                        * @type {new (args: QueryArgsType) => this} */ (this.constructor)
     const newQuery = new QueryClass({
       driver: this._driverFn,
       froms: [...this._froms],
@@ -496,7 +496,7 @@ export default class VelociousDatabaseQuery {
     } else if (typeof where == "object" && (where.constructor.name == "object" || where.constructor.name == "Object")) {
       this._wheres.push(new WhereHash(this, /**
                                              * Narrows the runtime value to the documented type.
-                                              @type {import("./where-hash.js").WhereHash} */ (where)))
+                                             * @type {import("./where-hash.js").WhereHash} */ (where)))
     } else {
       throw new Error(`Invalid type of where: ${typeof where} (${where.constructor.name})`)
     }
@@ -515,7 +515,7 @@ export default class VelociousDatabaseQuery {
     } else if (typeof where == "object" && (where.constructor.name == "object" || where.constructor.name == "Object")) {
       this._wheres.push(new WhereNot(new WhereHash(this, /**
                                                           * Narrows the runtime value to the documented type.
-                                                           @type {import("./where-hash.js").WhereHash} */ (where))))
+                                                          * @type {import("./where-hash.js").WhereHash} */ (where))))
     } else {
       throw new Error(`Invalid type of where: ${typeof where} (${where.constructor.name})`)
     }

package/build/database/query/join-object.js

@@ -31,10 +31,10 @@ export default class VelociousDatabaseQueryJoinObject extends JoinBase {
 
     const modelQuery = /**
                         * Narrows the runtime value to the documented type.
-                         @type {import("./model-class-query.js").default} */ (query)
+                        * @type {import("./model-class-query.js").default} */ (query)
     const ModelClass = /**
                         * Narrows the runtime value to the documented type.
-                         @type {typeof import("../record/index.js").default} */ (
+                        * @type {typeof import("../record/index.js").default} */ (
       this.basePath.length > 0 ? modelQuery._resolveModelClassForJoinPath(this.basePath) : modelQuery.modelClass
     )
 
@@ -55,7 +55,7 @@ export default class VelociousDatabaseQueryJoinObject extends JoinBase {
     const conn = this.getQuery().driver
     const query = /**
                    * Narrows the runtime value to the documented type.
-                    @type {import("./model-class-query.js").default} */ (this.getQuery())
+                   * @type {import("./model-class-query.js").default} */ (this.getQuery())
 
     for (const joinKey in join) {
       const joinValue = join[joinKey]