velocious 1.0.449 → 1.0.451

package/src/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/src/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/src/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/src/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]

package/src/database/query/model-class-query.js

@@ -90,7 +90,7 @@ function normalizeScopePath(path) {
 function clonePreloadSelectMap(map) {
   /**
    * Result.
-    @type {Record<string, string[]>} */
+   * @type {Record<string, string[]>} */
   const result = {}
 
   for (const [modelName, attributes] of Object.entries(map)) {
@@ -115,7 +115,7 @@ function normalizePreloadRecord(preload) {
   if (Array.isArray(preload)) {
     /**
      * Result.
-      @type {import("./index.js").NestedPreloadRecord} */
+     * @type {import("./index.js").NestedPreloadRecord} */
     const result = {}
 
     for (const entry of preload) {
@@ -141,7 +141,7 @@ function normalizePreloadRecord(preload) {
 
   /**
    * Result.
-    @type {import("./index.js").NestedPreloadRecord} */
+   * @type {import("./index.js").NestedPreloadRecord} */
   const result = {}
 
   for (const [key, value] of Object.entries(preload)) {
@@ -190,24 +190,24 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {MC} */
+     * @type {MC} */
     this.modelClass = modelClass
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {string[]} */
+     * @type {string[]} */
     this._joinBasePath = args.joinBasePath || []
     this._joinTracker = args.joinTracker || new JoinTracker({modelClass: this.modelClass})
     this._forceQualifyBaseTable = Boolean(args.forceQualifyBaseTable)
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {import("./with-count.js").WithCountEntry[]} */
+     * @type {import("./with-count.js").WithCountEntry[]} */
     this._withCount = args.withCount ? [...args.withCount] : []
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {import("./query-data.js").QueryDataEntry[]} */
+     * @type {import("./query-data.js").QueryDataEntry[]} */
     this._queryData = args.queryData ? [...args.queryData] : []
   }
 
@@ -218,7 +218,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
   clone() {
     const newQuery = /**
                       * Narrows the runtime value to the documented type.
-                       @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (new VelociousDatabaseQueryModelClassQuery({
+                      * @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (new VelociousDatabaseQueryModelClassQuery({
       driver: this._driverFn,
       froms: [...this._froms],
       handler: this.handler.clone(),
@@ -340,7 +340,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
 
     const results = /**
                      * Narrows the runtime value to the documented type.
-                      @type {{count: number}[]} */ (await countQuery._executeQuery({
+                     * @type {{count: number}[]} */ (await countQuery._executeQuery({
       logName: countQuery.queryLogName("Count")
     }))
 
@@ -376,7 +376,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
     ].join(" ")
     const results = /**
                      * Narrows the runtime value to the documented type.
-                      @type {{count: number}[]} */ (await this.driver.query(
+                     * @type {{count: number}[]} */ (await this.driver.query(
       sql,
       {logName: this.queryLogName("Count")}
     ))
@@ -472,16 +472,16 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
 
     if (lastFrom && typeof /**
                             * Narrows the runtime value to the documented type.
-                             @type {?} */ (lastFrom).tableName === "string") {
-      return /** Narrows the runtime value to the documented type. @type {?} */ (lastFrom).tableName
+                            * @type {?} */ (lastFrom).tableName === "string") {
+      return /** @type {?} */ (lastFrom).tableName
     }
 
     if (lastFrom && typeof /**
                             * Narrows the runtime value to the documented type.
-                             @type {?} */ (lastFrom).plain === "string") {
+                            * @type {?} */ (lastFrom).plain === "string") {
       const parsedReference = parseFromPlainTableReference(/**
                                                             * Narrows the runtime value to the documented type.
-                                                             @type {?} */ (lastFrom).plain)
+                                                            * @type {?} */ (lastFrom).plain)
 
       if (parsedReference) return parsedReference
     }
@@ -541,7 +541,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
   withJoinPath(joinBasePath) {
     const scopedQuery = /**
                          * Narrows the runtime value to the documented type.
-                          @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (this.clone())
+                         * @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (this.clone())
 
     scopedQuery._joinBasePath = joinBasePath
     scopedQuery._joinTracker = this._joinTracker
@@ -640,7 +640,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
     return this._applyJoinPathScope({
       joinPath: normalizeScopePath(/**
                                     * Narrows the runtime value to the documented type.
-                                     @type {string | string[]} */ (pathOrScopeDescriptor)),
+                                    * @type {string | string[]} */ (pathOrScopeDescriptor)),
       scopeDescriptor: maybeScopeDescriptor
     })
   }
@@ -661,7 +661,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
 
     const scopedQuery = /**
                          * Narrows the runtime value to the documented type.
-                          @type {this | void} */ (scopeDescriptor.callback({
+                         * @type {this | void} */ (scopeDescriptor.callback({
       driver: this.driver,
       modelClass: this.getModelClass(),
       query: this,
@@ -695,7 +695,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
     const originalWhereCount = scopedQuery._wheres.length
     const appliedQuery = /**
                           * Narrows the runtime value to the documented type.
-                           @type {typeof scopedQuery | void} */ (scopeDescriptor.callback({
+                          * @type {typeof scopedQuery | void} */ (scopeDescriptor.callback({
       driver: scopedQuery.driver,
       modelClass: targetModelClass,
       path: [...fullJoinPath],
@@ -744,7 +744,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
   buildJoinScopeQuery(targetModelClass, joinPath) {
     const scopedQuery = /**
                          * Narrows the runtime value to the documented type.
-                          @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (targetModelClass._newQuery())
+                         * @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (targetModelClass._newQuery())
 
     scopedQuery._joinTracker = this._joinTracker
     scopedQuery._joinBasePath = joinPath
@@ -812,14 +812,14 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
   async find(recordId) {
     /**
      * Conditions.
-      @type {{[key: string]: number | string}} */
+     * @type {{[key: string]: number | string}} */
     const conditions = {}
 
     conditions[this.getModelClass().primaryKey()] = recordId
 
     const newQuery = /**
                       * Narrows the runtime value to the documented type.
-                       @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (this.clone())
+                      * @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (this.clone())
 
     newQuery.where(conditions)
 
@@ -840,7 +840,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
   async findBy(conditions) {
     const newQuery = /**
                       * Narrows the runtime value to the documented type.
-                       @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (this.clone())
+                      * @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (this.clone())
 
     newQuery.where(conditions)
 
@@ -892,7 +892,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
     const ModelClass = this.getModelClass()
     const newRecord = /**
                        * Narrows the runtime value to the documented type.
-                        @type {InstanceType<MC>} */ (new ModelClass(conditions))
+                       * @type {InstanceType<MC>} */ (new ModelClass(conditions))
 
     if (callback) {
       callback(newRecord)
@@ -947,7 +947,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
       const ModelClass = this.getModelClass()
       const model = /**
                      * Narrows the runtime value to the documented type.
-                      @type {InstanceType<MC>} */ (new ModelClass())
+                     * @type {InstanceType<MC>} */ (new ModelClass())
 
       model.loadExistingRecord(result)
       models.push(model)
@@ -1015,7 +1015,7 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
 
     const query = /**
                    * Narrows the runtime value to the documented type.
-                    @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (this.clone())
+                   * @type {VelociousDatabaseQueryModelClassQuery<MC>} */ (this.clone())
 
     query._preload = {}
     query._selects = []
@@ -1032,13 +1032,13 @@ export default class VelociousDatabaseQueryModelClassQuery extends DatabaseQuery
       const [columnName] = columnNames
       return rows.map((row) => /**
                                 * Narrows the runtime value to the documented type.
-                                 @type {Record<string, ?>} */ (row)[columnName])
+                                * @type {Record<string, ?>} */ (row)[columnName])
     }
 
     return rows.map((row) => {
       const rowHash = /**
                        * Narrows the runtime value to the documented type.
-                        @type {Record<string, ?>} */ (row)
+                       * @type {Record<string, ?>} */ (row)
 
       return columnNames.map((columnName) => rowHash[columnName])
     })
@@ -1177,7 +1177,7 @@ function applyRansackGroup({group, query}) {
 function buildRansackGroupWhere({group, query}) {
   /**
    * Wheres.
-    @type {import("./where-base.js").default[]} */
+   * @type {import("./where-base.js").default[]} */
   const wheres = []
 
   for (const condition of group.conditions) {
@@ -1212,7 +1212,7 @@ function buildRansackGroupWhere({group, query}) {
 function buildRansackConditionWhere({condition, query}) {
   /**
    * Wheres.
-    @type {import("./where-base.js").default[]} */
+   * @type {import("./where-base.js").default[]} */
   const wheres = []
 
   for (const attribute of condition.attributes) {
@@ -1296,7 +1296,7 @@ function buildRansackAttributeHash({attribute, condition}) {
 function buildNestedRansackHash({attribute, value}) {
   /**
    * Hash.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   let hash = {[attribute.attributeName]: value}
 
   for (let index = attribute.path.length - 1; index >= 0; index -= 1) {
@@ -1317,7 +1317,7 @@ function buildNestedRansackHash({attribute, value}) {
 function buildNestedRansackTupleHash({attribute, operator, value}) {
   /**
    * Hash.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   let hash = {
     [attribute.attributeName]: [[attribute.attributeName, operator, value]]
   }
@@ -1392,11 +1392,11 @@ function resolveColumnName(modelClass, key) {
 function splitWhereHash({hash, modelClass}) {
   /**
    * Resolved hash.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   const resolvedHash = {}
   /**
    * Fallback hash.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   const fallbackHash = {}
 
   for (const key in hash) {
@@ -1454,7 +1454,7 @@ function splitWhereHash({hash, modelClass}) {
 function buildJoinObjectFromWhereHash({hash, modelClass}) {
   /**
    * Join object.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   const joinObject = {}
 
   for (const key in hash) {
@@ -1495,10 +1495,10 @@ function normalizeRelationshipWhereOperator(operator) {
     ">=": "gteq"
   }
 
-  return /** Narrows the runtime value to the documented type. @type {"eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like"} */ (
+  return /** @type {"eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like"} */ (
     operatorAliases[/**
                      * Narrows the runtime value to the documented type.
-                      @type {"<" | "<=" | ">" | ">="} */ (operator)] || operator
+                     * @type {"<" | "<=" | ">" | ">="} */ (operator)] || operator
   )
 }
 
@@ -1529,7 +1529,7 @@ function normalizeRelationshipWhereOperatorTuples(value) {
 
   /**
    * Normalized.
-    @type {Array<[string, "eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like", unknown]>} */
+   * @type {Array<[string, "eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like", unknown]>} */
   const normalized = []
     /**
      * Add condition.
@@ -1539,7 +1539,7 @@ function normalizeRelationshipWhereOperatorTuples(value) {
       if (isRelationshipWhereOperatorTuple(conditionValue)) {
         const tuple = /**
                        * Narrows the runtime value to the documented type.
-                        @type {[string, "eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like" | ">" | ">=" | "<" | "<=", unknown, ...Array<unknown>]} */ (conditionValue)
+                       * @type {[string, "eq" | "notEq" | "gt" | "gteq" | "lt" | "lteq" | "like" | ">" | ">=" | "<" | "<=", unknown, ...Array<unknown>]} */ (conditionValue)
         const normalizedOperator = normalizeRelationshipWhereOperator(tuple[1])
 
         normalized.push([
@@ -1563,7 +1563,7 @@ function normalizeRelationshipWhereOperatorTuples(value) {
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {Array<?>} */ (conditionValue).forEach((nestedConditionValue) => {
+     * @type {Array<?>} */ (conditionValue).forEach((nestedConditionValue) => {
       addCondition(nestedConditionValue)
     })
   }

package/src/database/query/preloader/belongs-to.js

@@ -35,11 +35,11 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
 
     /**
      * Satisfied targets.
-      @type {import("../../record/index.js").default[]} */
+     * @type {import("../../record/index.js").default[]} */
     const satisfiedTargets = []
     /**
      * Models to load.
-      @type {import("../../record/index.js").default[]} */
+     * @type {import("../../record/index.js").default[]} */
     const modelsToLoad = []
 
     for (const model of this.models) {
@@ -48,7 +48,7 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
       if (this.selection.isSatisfied({instanceRelationship, targetModelClass, mappingColumns: [primaryKey]})) {
         const loaded = /**
                         * Narrows the runtime value to the documented type.
-                         @type {import("../../record/index.js").default | undefined} */ (instanceRelationship.getLoadedOrUndefined())
+                        * @type {import("../../record/index.js").default | undefined} */ (instanceRelationship.getLoadedOrUndefined())
 
         if (loaded) satisfiedTargets.push(loaded)
       } else {
@@ -60,13 +60,13 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
 
     /**
      * Foreign key values.
-      @type {Array<number | string>} */
+     * @type {Array<number | string>} */
     const foreignKeyValues = []
 
     for (const model of modelsToLoad) {
       const foreignKeyValue = /**
                                * Narrows the runtime value to the documented type.
-                                @type {string | number | null | undefined} */ (model.readColumn(foreignKey))
+                               * @type {string | number | null | undefined} */ (model.readColumn(foreignKey))
 
       // Skip null/undefined foreign keys: a belongsTo with no foreign key has no
       // target, and including them would serialize to e.g. `IN (null)` which
@@ -78,12 +78,12 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
 
     /**
      * Target models by id.
-      @type {Record<string, import("../../record/index.js").default>} */
+     * @type {Record<string, import("../../record/index.js").default>} */
     const targetModelsById = {}
 
     /**
      * Target models.
-      @type {import("../../record/index.js").default[]} */
+     * @type {import("../../record/index.js").default[]} */
     let targetModels = []
 
     // Only query when at least one model has a non-null foreign key.
@@ -92,7 +92,7 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
 
       /**
        * Where args.
-        @type {Record<string, string | number | Array<string | number>>} */
+       * @type {Record<string, string | number | Array<string | number>>} */
       const whereArgs = {}
 
       whereArgs[primaryKey] = foreignKeyValues
@@ -108,7 +108,7 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
       for (const targetModel of targetModels) {
         const primaryKeyValue = /**
                                  * Narrows the runtime value to the documented type.
-                                  @type {string | number} */ (targetModel.readColumn(primaryKey))
+                                 * @type {string | number} */ (targetModel.readColumn(primaryKey))
 
         targetModelsById[primaryKeyValue] = targetModel
       }
@@ -118,7 +118,7 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
     for (const model of modelsToLoad) {
       const foreignKeyValue = /**
                                * Narrows the runtime value to the documented type.
-                                @type {string | number} */ (model.readColumn(foreignKey))
+                               * @type {string | number} */ (model.readColumn(foreignKey))
       const targetModel = targetModelsById[foreignKeyValue]
       const modelRelationship = model.getRelationshipByName(relationshipName)
 
@@ -144,37 +144,37 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
 
     /**
      * Model meta.
-      @type {{foreignKeyValue: number | string | undefined, model: import("../../record/index.js").default, targetType: string | undefined}[]} */
+     * @type {{foreignKeyValue: number | string | undefined, model: import("../../record/index.js").default, targetType: string | undefined}[]} */
     const modelMeta = []
 
     /**
      * Satisfied targets.
-      @type {import("../../record/index.js").default[]} */
+     * @type {import("../../record/index.js").default[]} */
     const satisfiedTargets = []
 
     /**
      * Target models by class name.
-      @type {Record<string, import("../../record/index.js").default[]>} */
+     * @type {Record<string, import("../../record/index.js").default[]>} */
     const targetModelsByClassName = {}
 
     for (const model of this.models) {
       const targetType = /**
                           * Narrows the runtime value to the documented type.
-                           @type {string | undefined} */ (model.readColumn(typeColumn))
+                          * @type {string | undefined} */ (model.readColumn(typeColumn))
       const instanceRelationship = model.getRelationshipByName(relationshipName)
       const targetModelClass = targetType ? configuration.getModelClass(targetType) : undefined
 
       if (targetModelClass && this.selection.isSatisfied({instanceRelationship, targetModelClass, mappingColumns: [primaryKey]})) {
         const loaded = /**
                         * Narrows the runtime value to the documented type.
-                         @type {import("../../record/index.js").default | undefined} */ (instanceRelationship.getLoadedOrUndefined())
+                        * @type {import("../../record/index.js").default | undefined} */ (instanceRelationship.getLoadedOrUndefined())
 
         if (loaded) {
           satisfiedTargets.push(loaded)
 
           const className = /**
                              * Narrows the runtime value to the documented type.
-                              @type {typeof import("../../record/index.js").default} */ (loaded.constructor).getModelName()
+                             * @type {typeof import("../../record/index.js").default} */ (loaded.constructor).getModelName()
 
           if (!targetModelsByClassName[className]) targetModelsByClassName[className] = []
           targetModelsByClassName[className].push(loaded)
@@ -186,7 +186,7 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
       modelMeta.push({
         foreignKeyValue: /**
                           * Narrows the runtime value to the documented type.
-                           @type {string | number | undefined} */ (model.readColumn(foreignKey)),
+                          * @type {string | number | undefined} */ (model.readColumn(foreignKey)),
         model,
         targetType
       })
@@ -194,7 +194,7 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
 
     /**
      * Foreign key values by type.
-      @type {Record<string, Array<number | string>>} */
+     * @type {Record<string, Array<number | string>>} */
     const foreignKeyValuesByType = {}
 
     for (const meta of modelMeta) {
@@ -207,12 +207,12 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
 
     /**
      * Target models by type and id.
-      @type {Record<string, Record<number | string, import("../../record/index.js").default>>} */
+     * @type {Record<string, Record<number | string, import("../../record/index.js").default>>} */
     const targetModelsByTypeAndId = {}
 
     /**
      * Target models.
-      @type {import("../../record/index.js").default[]} */
+     * @type {import("../../record/index.js").default[]} */
     const targetModels = []
 
     for (const targetType in foreignKeyValuesByType) {
@@ -222,7 +222,7 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
 
       /**
        * Where args.
-        @type {Record<string, string | number | Array<string | number>>} */
+       * @type {Record<string, string | number | Array<string | number>>} */
       const whereArgs = {}
 
       whereArgs[primaryKey] = foreignKeyValuesByType[targetType]
@@ -246,7 +246,7 @@ export default class VelociousDatabaseQueryPreloaderBelongsTo {
       for (const targetModel of foundTargetModels) {
         const primaryKeyValue = /**
                                  * Narrows the runtime value to the documented type.
-                                  @type {string | number} */ (targetModel.readColumn(primaryKey))
+                                 * @type {string | number} */ (targetModel.readColumn(primaryKey))
 
         targetModelsByTypeAndId[targetType][primaryKeyValue] = targetModel
       }