velocious 1.0.449 → 1.0.451

package/build/database/drivers/base.js

@@ -139,27 +139,27 @@ function formatElapsedMs(elapsedMs) {
 export default class VelociousDatabaseDriversBase {
   /**
    * Id seq.
-    @type {number | undefined} */
+   * @type {number | undefined} */
   idSeq = undefined
   /**
    * Narrows the runtime value to the documented type.
-    @type {Array<Array<() => void | Promise<void>>>} */
+   * @type {Array<Array<() => void | Promise<void>>>} */
   _afterCommitCallbackFrames
   /**
    * Narrows the runtime value to the documented type.
-    @type {Map<string, Promise<?>>} */
+   * @type {Map<string, Promise<?>>} */
   _schemaCache
   /**
    * Narrows the runtime value to the documented type.
-    @type {(() => void) | undefined} */
+   * @type {(() => void) | undefined} */
   _schemaCacheInvalidator
   /**
    * Narrows the runtime value to the documented type.
-    @type {string | undefined} */
+   * @type {string | undefined} */
   _connectionCheckoutName
   /**
    * Active query.
-    @type {ActiveQueryState | null} */
+   * @type {ActiveQueryState | null} */
   _activeQuery = null
 
   /**
@@ -457,7 +457,7 @@ export default class VelociousDatabaseDriversBase {
     const existingPromise = this._schemaCache.get(cacheKey)
 
     if (existingPromise) {
-      return /** Narrows the runtime value to the documented type. @type {T} */ (this._schemaCacheReturnValue(await existingPromise))
+      return /** @type {T} */ (this._schemaCacheReturnValue(await existingPromise))
     }
 
     const promise = (async () => await callback())()
@@ -465,7 +465,7 @@ export default class VelociousDatabaseDriversBase {
     this._schemaCache.set(cacheKey, promise)
 
     try {
-      return /** Narrows the runtime value to the documented type. @type {T} */ (this._schemaCacheReturnValue(await promise))
+      return /** @type {T} */ (this._schemaCacheReturnValue(await promise))
     } catch (error) {
       if (this._schemaCache.get(cacheKey) === promise) {
         this._schemaCache.delete(cacheKey)
@@ -565,7 +565,7 @@ export default class VelociousDatabaseDriversBase {
    * @returns {Promise<import("./base-table.js").default>} - Resolves with the table by name or fail.
    */
   async getTableByNameOrFail(name) {
-    return /** Narrows the runtime value to the documented type. @type {import("./base-table.js").default} */ (await this.getTableByName(name, {throwError: true}))
+    return /** @type {import("./base-table.js").default} */ (await this.getTableByName(name, {throwError: true}))
   }
 
   /**
@@ -813,7 +813,7 @@ export default class VelociousDatabaseDriversBase {
     const savePointName = this.generateSavePointName()
     /**
      * Callback frame.
-      @type {Array<() => void | Promise<void>>} */
+     * @type {Array<() => void | Promise<void>>} */
     const callbackFrame = []
     let transactionStarted = false
     let savePointStarted = false

package/build/database/drivers/mssql/index.js

@@ -344,7 +344,7 @@ export default class VelociousDatabaseDriversMssql extends Base{
       for (const row of result) {
         const table = new Table(this, /**
                                        * Narrows the runtime value to the documented type.
-                                        @type {Record<string, string>} */ (row))
+                                       * @type {Record<string, string>} */ (row))
 
         tables.push(table)
       }

package/build/database/drivers/mssql/table.js

@@ -121,7 +121,7 @@ export default class VelociousDatabaseDriversMssqlTable extends BaseTable {
    * @returns {string} - The table name.
    */
   getName() {
-    return /** Narrows the runtime value to the documented type. @type {string} */ (digg(this.data, "TABLE_NAME"))
+    return /** @type {string} */ (digg(this.data, "TABLE_NAME"))
   }
 
   /**

package/build/database/drivers/mysql/index.js

@@ -85,7 +85,7 @@ export default class VelociousDatabaseDriversMysql extends Base{
 
     /**
      * Connect args.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     const connectArgs = {charset: "utf8mb4"}
 
     for (const forwardValue of forward) {
@@ -221,7 +221,7 @@ export default class VelociousDatabaseDriversMysql extends Base{
   retryableDatabaseError(error) {
     const errorCode = /**
                        * Narrows the runtime value to the documented type.
-                        @type {?} */ (error).code
+                       * @type {?} */ (error).code
     const message = error.message || ""
     const shouldRetry = (
       errorCode == "ECONNREFUSED" ||
@@ -335,7 +335,7 @@ export default class VelociousDatabaseDriversMysql extends Base{
       for (const row of result) {
         const table = new Table(this, /**
                                        * Narrows the runtime value to the documented type.
-                                        @type {Record<string, string>} */ (row))
+                                       * @type {Record<string, string>} */ (row))
 
         tables.push(table)
       }

package/build/database/drivers/mysql/query.js

@@ -17,7 +17,7 @@ export default async function query(pool, sql) {
         for (const rowData of resultRows) {
           /**
            * Result.
-            @type {Record<string, ?>} */
+           * @type {Record<string, ?>} */
           const result = {}
 
           for (const fieldData of resultFields) {

package/build/database/drivers/mysql/table.js

@@ -116,6 +116,6 @@ export default class VelociousDatabaseDriversMysqlTable extends BaseTable {
    * @returns {string} - The table name.
    */
   getName() {
-    return /** Narrows the runtime value to the documented type. @type {string} */ (Object.values(this.data)[0])
+    return /** @type {string} */ (Object.values(this.data)[0])
   }
 }

package/build/database/drivers/pgsql/index.js

@@ -43,7 +43,7 @@ export default class VelociousDatabaseDriversPgsql extends Base{
 
     /**
      * Connect args.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     const connectArgs = {}
 
     for (const forwardValue of forward) {
@@ -283,7 +283,7 @@ export default class VelociousDatabaseDriversPgsql extends Base{
       for (const row of result) {
         const table = new Table(this, /**
                                        * Narrows the runtime value to the documented type.
-                                        @type {Record<string, string>} */ (row))
+                                       * @type {Record<string, string>} */ (row))
 
         tables.push(table)
       }

package/build/database/drivers/sqlite/base.js

@@ -20,15 +20,15 @@ import Update from "./sql/update.js"
 export default class VelociousDatabaseDriversSqliteBase extends Base {
   /**
    * Version major.
-    @type {number | undefined} */
+   * @type {number | undefined} */
   versionMajor = undefined
   /**
    * Version minor.
-    @type {number | undefined} */
+   * @type {number | undefined} */
   versionMinor = undefined
   /**
    * Version patch.
-    @type {number | undefined} */
+   * @type {number | undefined} */
   versionPatch = undefined
 
   /**
@@ -89,7 +89,7 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
   async dropTableSQLs(tableName, args = {}) {
     const driver = /**
                     * Narrows the runtime value to the documented type.
-                     @type {import("../base.js").default} */ (this)
+                    * @type {import("../base.js").default} */ (this)
     const dropArgs = Object.assign({tableName, driver}, args)
     const dropTable = new DropTable(dropArgs)
 
@@ -128,7 +128,7 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
       for (const row of result) {
         const table = new Table({driver: this, row: /**
                                                      * Narrows the runtime value to the documented type.
-                                                      @type {Record<string, string | number | null>} */ (row)})
+                                                     * @type {Record<string, string | number | null>} */ (row)})
 
         tables.push(table)
       }
@@ -162,15 +162,15 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
   supportsMultipleInsertValues() {
     /**
      * Version major.
-      @type {number} */
+     * @type {number} */
     const versionMajor = this.versionMajor || 0
     /**
      * Version minor.
-      @type {number} */
+     * @type {number} */
     const versionMinor = this.versionMinor || 0
     /**
      * Version patch.
-      @type {number} */
+     * @type {number} */
     const versionPatch = this.versionPatch || 0
 
     if (versionMajor >= 4) return true
@@ -187,11 +187,11 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
   supportsInsertIntoReturning() {
     /**
      * Version major.
-      @type {number} */
+     * @type {number} */
     const versionMajor = this.versionMajor || 0
     /**
      * Version minor.
-      @type {number} */
+     * @type {number} */
     const versionMinor = this.versionMinor || 0
 
     if (versionMajor >= 4) return true
@@ -225,13 +225,13 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
     this._assertNotReadOnly()
     /**
      * Sqls.
-      @type {string[]} */
+     * @type {string[]} */
     const sqls = []
 
     for (const row of rows) {
       /**
        * Data.
-        @type {Record<string, ?>} */
+       * @type {Record<string, ?>} */
       const data = {}
 
       for (const columnIndex in columns) {
@@ -340,7 +340,7 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
 
     const type = typeof value
 
-    if (type == "number") return /** Narrows the runtime value to the documented type. @type {number} */ (value)
+    if (type == "number") return /** @type {number} */ (value)
     if (type != "string") value = String(value)
 
     return escapeString(value, null)
@@ -398,11 +398,11 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
         const waiters = state.waitersByName.get(name) || []
         /**
          * Timeout handle.
-          @type {NodeJS.Timeout | null} */
+         * @type {NodeJS.Timeout | null} */
         let timeoutHandle = null
         /**
          * Remove and resolve.
-          @type {(() => void) | null} */
+         * @type {(() => void) | null} */
         let removeAndResolve = null
 
         removeAndResolve = () => {
@@ -411,7 +411,7 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
           const current = state.waitersByName.get(name) || []
           const index = current.indexOf(/**
                                          * Narrows the runtime value to the documented type.
-                                          @type {() => void} */ (removeAndResolve))
+                                         * @type {() => void} */ (removeAndResolve))
 
           if (index >= 0) current.splice(index, 1)
           if (current.length === 0) state.waitersByName.delete(name)

package/build/database/drivers/sqlite/index.js

@@ -15,12 +15,12 @@ import fileExists from "../../../utils/file-exists.js"
 export default class VelociousDatabaseDriversSqliteNode extends Base {
   /**
    * Connection.
-    @type {import("sqlite3").Database | undefined} */
+   * @type {import("sqlite3").Database | undefined} */
   connection = undefined
 
   /**
    * Advisory lock directory.
-    @type {string | undefined} */
+   * @type {string | undefined} */
   _advisoryLockDirectory = undefined
 
   async connect() {
@@ -40,7 +40,7 @@ export default class VelociousDatabaseDriversSqliteNode extends Base {
 
     try {
       // @ts-expect-error
-      this.connection = /** Narrows the runtime value to the documented type. @type {import("sqlite3").Database} */ (await open({
+      this.connection = /** @type {import("sqlite3").Database} */ (await open({
         filename: databasePath,
         driver: sqlite3.Database
       }))
@@ -176,7 +176,7 @@ export default class VelociousDatabaseDriversSqliteNode extends Base {
 
   /**
    * Runs resolve advisory lock directory.
-    @returns {string} */
+   * @returns {string} */
   _resolveAdvisoryLockDirectory() {
     if (!this._advisoryLockDirectory) {
       // Fall back to deriving the directory for callers that invoked
@@ -203,7 +203,7 @@ export default class VelociousDatabaseDriversSqliteNode extends Base {
 
   /**
    * Runs ensure advisory lock directory.
-    @returns {Promise<void>} */
+   * @returns {Promise<void>} */
   async _ensureAdvisoryLockDirectory() {
     await fs.mkdir(this._resolveAdvisoryLockDirectory(), {recursive: true})
   }
@@ -249,7 +249,7 @@ export default class VelociousDatabaseDriversSqliteNode extends Base {
       } catch (error) {
         if (/**
              * Narrows the runtime value to the documented type.
-              @type {NodeJS.ErrnoException} */ (error)?.code !== "EEXIST") throw error
+             * @type {NodeJS.ErrnoException} */ (error)?.code !== "EEXIST") throw error
 
         if (await this._isAdvisoryLockStale(lockPath)) {
           await fs.rm(lockPath, {recursive: true, force: true})
@@ -287,7 +287,7 @@ export default class VelociousDatabaseDriversSqliteNode extends Base {
     } catch (error) {
       if (/**
            * Narrows the runtime value to the documented type.
-            @type {NodeJS.ErrnoException} */ (error)?.code !== "EEXIST") throw error
+           * @type {NodeJS.ErrnoException} */ (error)?.code !== "EEXIST") throw error
 
       if (await this._isAdvisoryLockStale(lockPath)) {
         await fs.rm(lockPath, {recursive: true, force: true})
@@ -300,7 +300,7 @@ export default class VelociousDatabaseDriversSqliteNode extends Base {
         } catch (retryError) {
           if (/**
                * Narrows the runtime value to the documented type.
-                @type {NodeJS.ErrnoException} */ (retryError)?.code === "EEXIST") return false
+               * @type {NodeJS.ErrnoException} */ (retryError)?.code === "EEXIST") return false
 
           throw retryError
         }
@@ -356,7 +356,7 @@ export default class VelociousDatabaseDriversSqliteNode extends Base {
   async _isAdvisoryLockStale(lockPath) {
     /**
      * Defines rawOwner.
-      @type {string} */
+     * @type {string} */
     let rawOwner
 
     try {
@@ -368,7 +368,7 @@ export default class VelociousDatabaseDriversSqliteNode extends Base {
 
     /**
      * Defines owner.
-      @type {{pid?: number, hostname?: string}} */
+     * @type {{pid?: number, hostname?: string}} */
     let owner
 
     try {
@@ -388,7 +388,7 @@ export default class VelociousDatabaseDriversSqliteNode extends Base {
 
       return false
     } catch (error) {
-      return /** Narrows the runtime value to the documented type. @type {NodeJS.ErrnoException} */ (error)?.code === "ESRCH"
+      return /** @type {NodeJS.ErrnoException} */ (error)?.code === "ESRCH"
     }
   }
 }

package/build/database/drivers/sqlite/index.native.js

@@ -41,7 +41,7 @@ export default class VelociousDatabaseDriversSqliteNative extends Base {
     const args = this.getArgs()
     /**
      * Connect args.
-      @type {Record<string, ?>} */
+     * @type {Record<string, ?>} */
     const connectArgs = {}
     const forward = ["database", "host", "password"]
 

package/build/database/drivers/sqlite/index.web.js

@@ -14,11 +14,11 @@ import Base from "./base.js"
 export default class VelociousDatabaseDriversSqliteWeb extends Base {
   /**
    * Better local storage.
-    @type {BetterLocalStorage | undefined} */
+   * @type {BetterLocalStorage | undefined} */
   betterLocalStorage = undefined
   /**
    * Connection.
-    @type {ConnectionSqlJs | undefined} */
+   * @type {ConnectionSqlJs | undefined} */
   _connection = undefined
 
   /**
@@ -64,7 +64,7 @@ export default class VelociousDatabaseDriversSqliteWeb extends Base {
    */
   getConnection() {
     if (this.args?.getConnection) {
-      return /** Narrows the runtime value to the documented type. @type {SqliteWebConnection} */ (this.args.getConnection())
+      return /** @type {SqliteWebConnection} */ (this.args.getConnection())
     } else {
       if (!this._connection) throw new Error("SQLite web connection has not been initialized")
       return this._connection

package/build/database/drivers/sqlite/query.js

@@ -10,7 +10,7 @@ export default async function query(connection, sql) {
   try {
     /**
      * Defines result.
-      @type {Record<string, ?>[]} */
+     * @type {Record<string, ?>[]} */
     let result
 
     // @ts-expect-error

package/build/database/drivers/sqlite/query.web.js

@@ -34,7 +34,7 @@ export default async function query(connection, sql) {
     for (const rowValues of result[0].values) {
       /**
        * Row.
-        @type {Record<string, ?>} */
+       * @type {Record<string, ?>} */
       const row = {}
 
       for (const columnIndex in columns) {

package/build/database/drivers/sqlite/sql/alter-table.js

@@ -79,13 +79,13 @@ export default class VelociousDatabaseConnectionDriversSqliteSqlAlterTable exten
     const targetTableData = new TableData(currentTableData.getName())
     /**
      * Column pairs.
-      @type {Array<[string, string]>} */
+     * @type {Array<[string, string]>} */
     const columnPairs = []
     const alterColumns = alterTableData.getColumns()
     const existingNames = new Set(currentTableData.getColumns().map((column) => column.getName()))
     /**
      * Column renames.
-      @type {Map<string, string>} */
+     * @type {Map<string, string>} */
     const columnRenames = new Map()
 
     for (const alterColumn of alterColumns) {

package/build/database/drivers/sqlite/table.js

@@ -73,7 +73,7 @@ export default class VelociousDatabaseDriversSqliteTable extends BaseTable {
 
         const indexData = /**
                            * Narrows the runtime value to the documented type.
-                            @type {typeof columnsIndex.data & {columnNames?: string[]}} */ (columnsIndex.data)
+                           * @type {typeof columnsIndex.data & {columnNames?: string[]}} */ (columnsIndex.data)
 
         indexData.columnNames = this._parseColumnsFromSQL(String(sql))
 

package/build/database/migrator/files-finder.js

@@ -28,7 +28,7 @@ export default class VelociousDatabaseMigratorFilesFinder {
 
     /**
      * Result.
-      @type {import("./types.js").MigrationObjectType[]} */
+     * @type {import("./types.js").MigrationObjectType[]} */
     let result = []
 
     for (const file of files) {

package/build/database/migrator.js

@@ -10,7 +10,7 @@ import TableData from "./table-data/index.js"
 export default class VelociousDatabaseMigrator {
   /**
    * Migrations versions.
-    @type {Record<string, Record<string, boolean>>} */
+   * @type {Record<string, Record<string, boolean>>} */
   migrationsVersions = {}
 
   /**
@@ -158,7 +158,7 @@ export default class VelociousDatabaseMigrator {
   async migrateFilesFromRequireContext(requireContext) {
     /**
      * Files.
-      @type {import("./migrator/types.js").MigrationObjectType[]} */
+     * @type {import("./migrator/types.js").MigrationObjectType[]} */
     let files = []
 
     for (const file of requireContext.keys()) {
@@ -289,7 +289,7 @@ export default class VelociousDatabaseMigrator {
 
     /**
      * Files.
-      @type {import("./migrator/types.js").MigrationObjectType[]} */
+     * @type {import("./migrator/types.js").MigrationObjectType[]} */
     let files = []
 
     for (const file of migrationFiles) {
@@ -303,7 +303,7 @@ export default class VelociousDatabaseMigrator {
 
       const migrationObject = /**
                                * Narrows the runtime value to the documented type.
-                                @type {import("./migrator/types.js").MigrationObjectType} */ ({
+                               * @type {import("./migrator/types.js").MigrationObjectType} */ ({
         file,
         date,
         migrationClassName
@@ -404,7 +404,7 @@ export default class VelociousDatabaseMigrator {
 
     /**
      * Defines highestVersion.
-      @type {string | undefined} */
+     * @type {string | undefined} */
     let highestVersion
 
     for (const dbIdentifier in this.migrationsVersions) {
@@ -436,7 +436,7 @@ export default class VelociousDatabaseMigrator {
 
     /**
      * Db identifiers needing migration versions.
-      @type {string[]} */
+     * @type {string[]} */
     const dbIdentifiersNeedingMigrationVersions = []
 
     // migrateFiles() wraps execution in ensureConnections(), so the current