velocious 1.0.448 → 1.0.450

package/src/database/query/preloader/has-many.js

@@ -72,11 +72,11 @@ export default class VelociousDatabaseQueryPreloaderHasMany {
     const relationshipName = this.relationship.getRelationshipName()
     /**
      * Models to load.
-      @type {import("../../record/index.js").default[]} */
+     * @type {import("../../record/index.js").default[]} */
     const modelsToLoad = []
     /**
      * Satisfied targets.
-      @type {import("../../record/index.js").default[]} */
+     * @type {import("../../record/index.js").default[]} */
     const satisfiedTargets = []
 
     for (const model of this.models) {
@@ -107,7 +107,7 @@ export default class VelociousDatabaseQueryPreloaderHasMany {
 
     const throughRelationshipName = /**
                                      * Narrows the runtime value to the documented type.
-                                      @type {string} */ (this.relationship.through)
+                                     * @type {string} */ (this.relationship.through)
     const parentModelClass = this.relationship.getModelClass()
     const throughRelationship = parentModelClass.getRelationshipByName(throughRelationshipName)
     const throughModelClass = throughRelationship.getTargetModelClass()
@@ -132,23 +132,23 @@ export default class VelociousDatabaseQueryPreloaderHasMany {
 
     /**
      * Models primary key values.
-      @type {Array<number | string>} */
+     * @type {Array<number | string>} */
     const modelsPrimaryKeyValues = []
 
     /**
      * Models by primary key value.
-      @type {Record<number | string, Array<import("../../record/index.js").default>>} */
+     * @type {Record<number | string, Array<import("../../record/index.js").default>>} */
     const modelsByPrimaryKeyValue = {}
 
     /**
      * Preload collections.
-      @type {Record<number | string, Array<import("../../record/index.js").default>>} */
+     * @type {Record<number | string, Array<import("../../record/index.js").default>>} */
     const preloadCollections = {}
 
     for (const model of modelsToLoad) {
       const primaryKeyValue = /**
                                * Narrows the runtime value to the documented type.
-                                @type {string | number} */ (model.readColumn(primaryKey))
+                               * @type {string | number} */ (model.readColumn(primaryKey))
 
       preloadCollections[primaryKeyValue] = []
 
@@ -165,21 +165,21 @@ export default class VelociousDatabaseQueryPreloaderHasMany {
 
     /**
      * Parent to target ids.
-      @type {Record<string | number, Array<string | number>>} */
+     * @type {Record<string | number, Array<string | number>>} */
     const parentToTargetIds = {}
 
     /**
      * All target ids.
-      @type {Set<string | number>} */
+     * @type {Set<string | number>} */
     const allTargetIds = new Set()
 
     for (const throughModel of throughModels) {
       const parentId = /**
                         * Narrows the runtime value to the documented type.
-                         @type {string | number} */ (throughModel.readColumn(throughForeignKey))
+                        * @type {string | number} */ (throughModel.readColumn(throughForeignKey))
       const throughId = /**
                          * Narrows the runtime value to the documented type.
-                          @type {string | number} */ (throughModel.readColumn(throughModelClass.primaryKey()))
+                         * @type {string | number} */ (throughModel.readColumn(throughModelClass.primaryKey()))
 
       if (!(parentId in parentToTargetIds)) parentToTargetIds[parentId] = []
 
@@ -190,7 +190,7 @@ export default class VelociousDatabaseQueryPreloaderHasMany {
     // Step 2: Load target models by the foreign key that points to the through table
     /**
      * Target models.
-      @type {import("../../record/index.js").default[]} */
+     * @type {import("../../record/index.js").default[]} */
     let targetModels = []
 
     if (allTargetIds.size > 0) {
@@ -204,13 +204,13 @@ export default class VelociousDatabaseQueryPreloaderHasMany {
     // Step 3: Index target models by their foreign key (maps to through model ID)
     /**
      * Target models by foreign key.
-      @type {Record<string | number, Array<import("../../record/index.js").default>>} */
+     * @type {Record<string | number, Array<import("../../record/index.js").default>>} */
     const targetModelsByForeignKey = {}
 
     for (const targetModel of targetModels) {
       const fkValue = /**
                        * Narrows the runtime value to the documented type.
-                        @type {string | number} */ (targetModel.readColumn(targetForeignKey))
+                       * @type {string | number} */ (targetModel.readColumn(targetForeignKey))
 
       if (!(fkValue in targetModelsByForeignKey)) targetModelsByForeignKey[fkValue] = []
 
@@ -270,23 +270,23 @@ export default class VelociousDatabaseQueryPreloaderHasMany {
 
     /**
      * Models primary key values.
-      @type {Array<number | string>} */
+     * @type {Array<number | string>} */
     const modelsPrimaryKeyValues = []
 
     /**
      * Models by primary key value.
-      @type {Record<number | string, Array<import("../../record/index.js").default>>} */
+     * @type {Record<number | string, Array<import("../../record/index.js").default>>} */
     const modelsByPrimaryKeyValue = {}
 
     /**
      * Preload collections.
-      @type {Record<number | string, Array<import("../../record/index.js").default>>} */
+     * @type {Record<number | string, Array<import("../../record/index.js").default>>} */
     const preloadCollections = {}
 
     for (const model of modelsToLoad) {
       const primaryKeyValue = /**
                                * Narrows the runtime value to the documented type.
-                                @type {string | number} */ (model.readColumn(primaryKey))
+                               * @type {string | number} */ (model.readColumn(primaryKey))
 
       preloadCollections[primaryKeyValue] = []
 
@@ -298,7 +298,7 @@ export default class VelociousDatabaseQueryPreloaderHasMany {
 
     /**
      * Where args.
-      @type {Record<string, string | number | Array<string | number>>} */
+     * @type {Record<string, string | number | Array<string | number>>} */
     const whereArgs = {}
 
     whereArgs[foreignKey] = modelsPrimaryKeyValues
@@ -321,7 +321,7 @@ export default class VelociousDatabaseQueryPreloaderHasMany {
     for (const targetModel of targetModels) {
       const foreignKeyValue = /**
                                * Narrows the runtime value to the documented type.
-                                @type {string | number} */ (targetModel.readColumn(foreignKey))
+                               * @type {string | number} */ (targetModel.readColumn(foreignKey))
 
       preloadCollections[foreignKeyValue].push(targetModel)
     }

package/src/database/query/preloader/has-one.js

@@ -23,12 +23,12 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
   async run() {
     /**
      * Models primary key values.
-      @type {Array<number | string>} */
+     * @type {Array<number | string>} */
     const modelsPrimaryKeyValues = []
 
     /**
      * Models by primary key value.
-      @type {Record<number | string, Array<import("../../record/index.js").default>>} */
+     * @type {Record<number | string, Array<import("../../record/index.js").default>>} */
     const modelsByPrimaryKeyValue = {}
 
     const foreignKey = this.relationship.getForeignKey()
@@ -41,12 +41,12 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
 
     /**
      * Preload collections.
-      @type {Record<number | string, import("../../record/index.js").default | undefined>} */
+     * @type {Record<number | string, import("../../record/index.js").default | undefined>} */
     const preloadCollections = {}
 
     /**
      * Satisfied targets.
-      @type {import("../../record/index.js").default[]} */
+     * @type {import("../../record/index.js").default[]} */
     const satisfiedTargets = []
 
     for (const model of this.models) {
@@ -55,7 +55,7 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
       if (this.selection.isSatisfied({instanceRelationship, targetModelClass, mappingColumns: [foreignKey]})) {
         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)
         continue
@@ -63,7 +63,7 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
 
       const primaryKeyValue = /**
                                * Narrows the runtime value to the documented type.
-                                @type {string | number} */ (model.readColumn(primaryKey))
+                               * @type {string | number} */ (model.readColumn(primaryKey))
 
       preloadCollections[primaryKeyValue] = undefined
 
@@ -77,7 +77,7 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
 
     /**
      * Where args.
-      @type {Record<string, string | number | Array<string | number>>} */
+     * @type {Record<string, string | number | Array<string | number>>} */
     const whereArgs = {}
 
     whereArgs[foreignKey] = modelsPrimaryKeyValues
@@ -101,7 +101,7 @@ export default class VelociousDatabaseQueryPreloaderHasOne {
     for (const targetModel of targetModels) {
       const foreignKeyValue = /**
                                * Narrows the runtime value to the documented type.
-                                @type {string | number} */ (targetModel.readColumn(foreignKey))
+                               * @type {string | number} */ (targetModel.readColumn(foreignKey))
 
       preloadCollections[foreignKeyValue] = targetModel
     }

package/src/database/query/preloader/selection.js

@@ -70,13 +70,13 @@ export default class VelociousDatabaseQueryPreloaderSelection {
     if (narrowing) {
       const selects = [...new Set([...narrowing, ...mappingColumns, ...(extra || [])])]
 
-      return /** Narrows the runtime value to the documented type. @type {T} */ (query.select(selects))
+      return /** @type {T} */ (query.select(selects))
     }
 
     if (extra) {
       const allColumns = `${query.driver.quoteTable(targetModelClass.tableName())}.*`
 
-      return /** Narrows the runtime value to the documented type. @type {T} */ (query.select([allColumns, ...extra]))
+      return /** @type {T} */ (query.select([allColumns, ...extra]))
     }
 
     return query
@@ -129,7 +129,7 @@ export default class VelociousDatabaseQueryPreloaderSelection {
     const extra = this._extraFor(targetModelClass)
     /**
      * Columns.
-      @type {string[]} */
+     * @type {string[]} */
     const columns = []
 
     if (narrowing) {

package/src/database/query/preloader.js

@@ -21,7 +21,7 @@ function normalizeNestedPreload(preload) {
   if (Array.isArray(preload)) {
     /**
      * Result.
-      @type {import("../query/index.js").NestedPreloadRecord} */
+     * @type {import("../query/index.js").NestedPreloadRecord} */
     const result = {}
 
     for (const entry of preload) {
@@ -50,7 +50,7 @@ function normalizeNestedPreload(preload) {
   if (preload && typeof preload == "object") {
     /**
      * Result.
-      @type {import("../query/index.js").NestedPreloadRecord} */
+     * @type {import("../query/index.js").NestedPreloadRecord} */
     const result = {}
 
     for (const [key, value] of Object.entries(preload)) {
@@ -90,17 +90,17 @@ export default class VelociousDatabaseQueryPreloader {
 
     const modelClass = /**
                         * Narrows the runtime value to the documented type.
-                         @type {typeof import("../record/index.js").default} */ (models[0].constructor)
+                        * @type {typeof import("../record/index.js").default} */ (models[0].constructor)
     const isQuery = Boolean(queryOrSpec) && typeof queryOrSpec == "object" && "_preload" in queryOrSpec
     // Reuse the query builder's preload/select normalization for raw specs
     // instead of duplicating it here.
     const query = isQuery
       ? /**
          * Narrows the runtime value to the documented type.
-          @type {import("./model-class-query.js").default} */ (queryOrSpec)
+         * @type {import("./model-class-query.js").default} */ (queryOrSpec)
       : modelClass.preload(/**
                             * Narrows the runtime value to the documented type.
-                             @type {?} */ (queryOrSpec))
+                            * @type {?} */ (queryOrSpec))
 
     const preloader = new VelociousDatabaseQueryPreloader({
       modelClass,
@@ -143,21 +143,21 @@ export default class VelociousDatabaseQueryPreloader {
       if (relationship.getType() == "belongsTo") {
         const belongsToRelationship = /**
                                        * Narrows the runtime value to the documented type.
-                                        @type {import("../record/relationships/belongs-to.js").default} */ (relationship)
+                                       * @type {import("../record/relationships/belongs-to.js").default} */ (relationship)
         const hasManyPreloader = new BelongsToPreloader({models: this.models, relationship: belongsToRelationship, selection: this.selection})
 
         preloadResult = await hasManyPreloader.run()
       } else if (relationship.getType() == "hasMany") {
         const hasManyRelationship = /**
                                      * Narrows the runtime value to the documented type.
-                                      @type {import("../record/relationships/has-many.js").default} */ (relationship)
+                                     * @type {import("../record/relationships/has-many.js").default} */ (relationship)
         const hasManyPreloader = new HasManyPreloader({models: this.models, relationship: hasManyRelationship, selection: this.selection})
 
         preloadResult = await hasManyPreloader.run()
       } else if (relationship.getType() == "hasOne") {
         const hasOneRelationship = /**
                                     * Narrows the runtime value to the documented type.
-                                     @type {import("../record/relationships/has-one.js").default} */ (relationship)
+                                    * @type {import("../record/relationships/has-one.js").default} */ (relationship)
         const hasOnePreloader = new HasOnePreloader({models: this.models, relationship: hasOneRelationship, selection: this.selection})
 
         preloadResult = await hasOnePreloader.run()

package/src/database/query/query-data.js

@@ -59,7 +59,7 @@ export function normalizeQueryDataSpec(spec, chain = []) {
   if (Array.isArray(spec)) {
     /**
      * Entries.
-      @type {QueryDataEntry[]} */
+     * @type {QueryDataEntry[]} */
     const entries = []
 
     for (const item of spec) {
@@ -71,7 +71,7 @@ export function normalizeQueryDataSpec(spec, chain = []) {
       if (isPlainObject(item)) {
         for (const nested of normalizeQueryDataSpec(/**
                                                      * Narrows the runtime value to the documented type.
-                                                      @type {?} */ (item), chain)) {
+                                                     * @type {?} */ (item), chain)) {
           entries.push(nested)
         }
         continue
@@ -86,7 +86,7 @@ export function normalizeQueryDataSpec(spec, chain = []) {
   if (isPlainObject(spec)) {
     /**
      * Entries.
-      @type {QueryDataEntry[]} */
+     * @type {QueryDataEntry[]} */
     const entries = []
 
     for (const [key, value] of Object.entries(spec)) {
@@ -100,7 +100,7 @@ export function normalizeQueryDataSpec(spec, chain = []) {
       if (typeof value === "string" || Array.isArray(value) || isPlainObject(value)) {
         for (const nested of normalizeQueryDataSpec(/**
                                                      * Narrows the runtime value to the documented type.
-                                                      @type {?} */ (value), [...chain, key])) {
+                                                     * @type {?} */ (value), [...chain, key])) {
           entries.push(nested)
         }
         continue
@@ -128,7 +128,7 @@ function buildNestedJoinDescriptor(chain) {
 
   /**
    * Obj.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   const obj = {}
   let cursor = obj
 
@@ -195,7 +195,7 @@ export async function runQueryData({rootModelClass, rootModels, entries}) {
   const primaryKey = rootModelClass.primaryKey()
   const rootIds = rootModels.map((model) => /**
                                              * Narrows the runtime value to the documented type.
-                                              @type {string | number} */ (model.readColumn(primaryKey)))
+                                             * @type {string | number} */ (model.readColumn(primaryKey)))
 
   for (const entry of entries) {
     await runEntry({entry, primaryKey, rootIds, rootModelClass, rootModels})
@@ -239,7 +239,7 @@ async function runEntry({entry, primaryKey, rootIds, rootModelClass, rootModels}
 
   /**
    * Root where.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   const rootWhere = {}
   rootWhere[primaryKey] = rootIds
   query.where(rootWhere)
@@ -272,7 +272,7 @@ async function runEntry({entry, primaryKey, rootIds, rootModelClass, rootModels}
 
   const rows = /**
                 * Narrows the runtime value to the documented type.
-                 @type {Array<Record<string, ?>>} */ (await query._executeQuery())
+                * @type {Array<Record<string, ?>>} */ (await query._executeQuery())
   const byParent = new Map()
 
   for (const row of rows) {
@@ -286,7 +286,7 @@ async function runEntry({entry, primaryKey, rootIds, rootModelClass, rootModels}
   for (const model of rootModels) {
     const modelId = /**
                      * Narrows the runtime value to the documented type.
-                      @type {string | number} */ (model.readColumn(primaryKey))
+                     * @type {string | number} */ (model.readColumn(primaryKey))
     // Driver-type tolerance: MySQL can return PKs as strings even when
     // the column is numeric. Fall back to a string lookup so results
     // still land on the right model.

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

@@ -25,10 +25,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
   )
 }
 
@@ -68,7 +68,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
 
     const modelQuery = /**
                         * Narrows the runtime value to the documented type.
-                         @type {import("./model-class-query.js").default} */ (this.query)
+                        * @type {import("./model-class-query.js").default} */ (this.query)
     const baseTableName = this.qualifyBaseTable
       ? modelQuery.getTableReferenceForJoin()
       : undefined
@@ -136,7 +136,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
 
     /**
      * 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.
@@ -146,7 +146,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
       if (this._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([
@@ -395,7 +395,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
     const options = this.getOptions()
     const modelQuery = /**
                         * Narrows the runtime value to the documented type.
-                         @type {import("./model-class-query.js").default} */ (this.query)
+                        * @type {import("./model-class-query.js").default} */ (this.query)
     let sql = ""
 
     for (const whereKey in hash) {
@@ -443,7 +443,7 @@ export default class VelociousDatabaseQueryWhereModelClassHash extends WhereBase
 
         const nestedHash = /**
                             * Narrows the runtime value to the documented type.
-                             @type {WhereHash} */ (whereValue)
+                            * @type {WhereHash} */ (whereValue)
         const nestedPath = path.concat([whereKey])
         const nestedTableName = modelQuery.getTableReferenceForJoin(...nestedPath)
 

package/src/database/query/with-count.js

@@ -47,7 +47,7 @@ export function normalizeWithCount(spec) {
   if (typeof spec === "object") {
     /**
      * Entries.
-      @type {WithCountEntry[]} */
+     * @type {WithCountEntry[]} */
     const entries = []
 
     for (const [key, value] of Object.entries(spec)) {
@@ -63,7 +63,7 @@ export function normalizeWithCount(spec) {
       if (typeof value === "object" && value !== null) {
         /**
          * Options.
-          @type {{relationship?: string, where?: Record<string, ?>}} */
+         * @type {{relationship?: string, where?: Record<string, ?>}} */
         const options = value
         entries.push({
           attributeName: key,
@@ -112,7 +112,7 @@ export async function runWithCount({models, modelClass, entries}) {
   const primaryKey = modelClass.primaryKey()
   const parentIds = models.map((model) => /**
                                            * Narrows the runtime value to the documented type.
-                                            @type {string | number} */ (model.readColumn(primaryKey)))
+                                           * @type {string | number} */ (model.readColumn(primaryKey)))
 
   for (const entry of entries) {
     const counts = await countForEntry({entries, entry, modelClass, parentIds})
@@ -120,14 +120,14 @@ export async function runWithCount({models, modelClass, entries}) {
     for (const model of models) {
       const modelPrimaryKeyValue = /**
                                     * Narrows the runtime value to the documented type.
-                                     @type {string | number} */ (model.readColumn(primaryKey))
+                                    * @type {string | number} */ (model.readColumn(primaryKey))
       // Tolerate driver differences in numeric return types: SQLite
       // returns integers as JS numbers, but MySQL's raw driver can
       // return count primary keys as strings. Try both.
       const resolvedCount = counts.has(modelPrimaryKeyValue)
         ? /**
            * Narrows the runtime value to the documented type.
-            @type {number} */ (counts.get(modelPrimaryKeyValue))
+           * @type {number} */ (counts.get(modelPrimaryKeyValue))
         : Number(counts.get(String(modelPrimaryKeyValue)) ?? 0)
 
       // Counts go on the record's dedicated association-count map,
@@ -170,7 +170,7 @@ async function countForEntry({entries, entry, modelClass, parentIds}) {
   const foreignKey = relationship.getForeignKey()
   /**
    * Where conditions.
-    @type {Record<string, ?>} */
+   * @type {Record<string, ?>} */
   const whereConditions = {[foreignKey]: parentIds}
 
   if (relationship.getPolymorphic && relationship.getPolymorphic()) {
@@ -198,19 +198,19 @@ async function countForEntry({entries, entry, modelClass, parentIds}) {
 
   const rows = /**
                 * Narrows the runtime value to the documented type.
-                 @type {Array<{parent_id: string | number, count_value: string | number}>} */ (
+                * @type {Array<{parent_id: string | number, count_value: string | number}>} */ (
     await countQuery._executeQuery()
   )
 
   /**
    * Counts.
-    @type {Map<string | number, number>} */
+   * @type {Map<string | number, number>} */
   const counts = new Map()
 
   for (const row of rows) {
     const parentId = /**
                       * Narrows the runtime value to the documented type.
-                       @type {string | number} */ (row.parent_id)
+                      * @type {string | number} */ (row.parent_id)
     const countValue = Number(row.count_value) || 0
     counts.set(parentId, countValue)
   }

package/src/database/record/acts-as-list.js

@@ -64,7 +64,7 @@ export default function registerActsAsListCallbacks(modelClass, positionColumn,
 
     const modelClass = /**
                         * Narrows the runtime value to the documented type.
-                         @type {typeof import("./index.js").default} */ (record.constructor)
+                        * @type {typeof import("./index.js").default} */ (record.constructor)
     const posColumn = modelClass.getColumnNameForAttributeName(positionColumn)
     const scopeCol = modelClass.getColumnNameForAttributeName(scope)
     /** @type {Record<string, ?>} */
@@ -81,24 +81,24 @@ export default function registerActsAsListCallbacks(modelClass, positionColumn,
 
     const oldPosition = posChanged ? /**
                                       * Narrows the runtime value to the documented type.
-                                       @type {number} */ (rawAttributes[posColumn]) : /**
+                                      * @type {number} */ (rawAttributes[posColumn]) : /**
                                                                                        * Narrows the runtime value to the documented type.
-                                                                                        @type {number} */ (record.readAttribute(positionColumn))
+                                                                                       * @type {number} */ (record.readAttribute(positionColumn))
     const newPosition = posChanged ? /**
                                       * Narrows the runtime value to the documented type.
-                                       @type {number} */ (changes[posColumn]) : /**
+                                      * @type {number} */ (changes[posColumn]) : /**
                                                                                  * Narrows the runtime value to the documented type.
-                                                                                  @type {number} */ (record.readAttribute(positionColumn))
+                                                                                 * @type {number} */ (record.readAttribute(positionColumn))
     const oldScopeValue = scopeChanged ? /**
                                           * Narrows the runtime value to the documented type.
-                                           @type {number} */ (rawAttributes[scopeCol]) : /**
+                                          * @type {number} */ (rawAttributes[scopeCol]) : /**
                                                                                           * Narrows the runtime value to the documented type.
-                                                                                           @type {number} */ (record.readAttribute(scope))
+                                                                                          * @type {number} */ (record.readAttribute(scope))
     const newScopeValue = scopeChanged ? /**
                                           * Narrows the runtime value to the documented type.
-                                           @type {number} */ (changes[scopeCol]) : /**
+                                          * @type {number} */ (changes[scopeCol]) : /**
                                                                                     * Narrows the runtime value to the documented type.
-                                                                                     @type {number} */ (record.readAttribute(scope))
+                                                                                    * @type {number} */ (record.readAttribute(scope))
 
     if (oldPosition == null || newPosition == null) return
     if (newPosition === oldPosition && newScopeValue === oldScopeValue) return
@@ -212,7 +212,7 @@ function clearBelongsToChangeForScope(record) {
 async function shiftPositionsUp({record, positionColumn, scope, fromPosition, toPosition, scopeValue, excludeRecordId}) {
   const modelClass = /**
                       * Narrows the runtime value to the documented type.
-                       @type {typeof import("./index.js").default} */ (record.constructor)
+                      * @type {typeof import("./index.js").default} */ (record.constructor)
   const connection = modelClass.connection()
   const tableName = modelClass._getTable().getName()
   const resolvedScopeValue = scopeValue != null ? scopeValue : resolveScopeValue(record, scope)
@@ -279,7 +279,7 @@ async function shiftPositionsUp({record, positionColumn, scope, fromPosition, to
 async function shiftPositionsDown({record, positionColumn, scope, fromPosition, toPosition, scopeValue}) {
   const modelClass = /**
                       * Narrows the runtime value to the documented type.
-                       @type {typeof import("./index.js").default} */ (record.constructor)
+                      * @type {typeof import("./index.js").default} */ (record.constructor)
   const connection = modelClass.connection()
   const tableName = modelClass._getTable().getName()
   const resolvedScopeValue = scopeValue != null ? scopeValue : resolveScopeValue(record, scope)
@@ -337,7 +337,7 @@ async function shiftPositionsDown({record, positionColumn, scope, fromPosition,
 async function highestPositionInScope({record, positionColumn, scope, scopeValue}) {
   const modelClass = /**
                       * Narrows the runtime value to the documented type.
-                       @type {typeof import("./index.js").default} */ (record.constructor)
+                      * @type {typeof import("./index.js").default} */ (record.constructor)
   const connection = modelClass.connection()
   const scopeColumnName = modelClass.getColumnNameForAttributeName(scope)
   const positionColumnName = modelClass.getColumnNameForAttributeName(positionColumn)
@@ -370,11 +370,11 @@ async function highestPositionInScope({record, positionColumn, scope, scopeValue
 function resolveScopeValue(record, scope) {
   const attrValue = record.readAttribute(scope)
 
-  if (attrValue != null) return /** Narrows the runtime value to the documented type. @type {string | number} */ (attrValue)
+  if (attrValue != null) return /** @type {string | number} */ (attrValue)
 
   const modelClass = /**
                       * Narrows the runtime value to the documented type.
-                       @type {typeof import("./index.js").default} */ (record.constructor)
+                      * @type {typeof import("./index.js").default} */ (record.constructor)
   const relationships = modelClass.getRelationshipsMap()
   const scopeColumnName = modelClass.getColumnNameForAttributeName(scope)
 
@@ -412,7 +412,7 @@ function resolveScopeValue(record, scope) {
 async function moveOutOfWay({record, positionColumn, scope, scopeValue, targetScopeValue}) {
   const modelClass = /**
                       * Narrows the runtime value to the documented type.
-                       @type {typeof import("./index.js").default} */ (record.constructor)
+                      * @type {typeof import("./index.js").default} */ (record.constructor)
   const connection = modelClass.connection()
   const tableName = modelClass._getTable().getName()
   const resolvedScopeValue = scopeValue != null ? scopeValue : resolveScopeValue(record, scope)

package/src/database/record/attachments/handle.js

@@ -39,7 +39,7 @@ function isArray(value) {
 export default class RecordAttachmentHandle {
   /**
    * Pending inputs.
-    @type {Array<?>} */
+   * @type {Array<?>} */
   pendingInputs = []
 
   /**
@@ -155,7 +155,7 @@ export default class RecordAttachmentHandle {
     const rows = await store.findMany({model: this.model, name: this.name})
     /**
      * Downloads.
-      @type {RecordAttachmentDownload[]} */
+     * @type {RecordAttachmentDownload[]} */
     const downloads = []
 
     for (const row of rows) {