velocious 1.0.449 → 1.0.451

package/build/database/record/instance-relationships/base.js

@@ -21,15 +21,15 @@ import HasOnePreloader from "../../query/preloader/has-one.js"
 export default class VelociousDatabaseRecordBaseInstanceRelationship {
   /**
    * Auto save.
-    @type {boolean | undefined} */
+   * @type {boolean | undefined} */
   _autoSave = undefined
   /**
    * Preloaded.
-    @type {boolean | undefined} */
+   * @type {boolean | undefined} */
   _preloaded = undefined
   /**
    * Loaded.
-    @type {InstanceType<TMC> | Array<InstanceType<TMC>> | undefined} */
+   * @type {InstanceType<TMC> | Array<InstanceType<TMC>> | undefined} */
   _loaded = undefined
 
   /**
@@ -128,9 +128,9 @@ export default class VelociousDatabaseRecordBaseInstanceRelationship {
     const configuration = relationshipDef.getConfiguration()
     const cohort = /**
                     * Narrows the runtime value to the documented type.
-                     @type {Array<import("../index.js").default> | undefined} */ (/**
+                    * @type {Array<import("../index.js").default> | undefined} */ (/**
                                                                                    * Narrows the runtime value to the documented type.
-                                                                                    @type {?} */ (this.model)._loadCohort)
+                                                                                   * @type {?} */ (this.model)._loadCohort)
 
     if (!configuration.getAutoload() || !relationshipDef.getAutoload() || !cohort || cohort.length <= 1) {
       return false
@@ -139,10 +139,10 @@ export default class VelociousDatabaseRecordBaseInstanceRelationship {
     const relationshipName = relationshipDef.getRelationshipName()
     const OwnerModelClass = /**
                              * Narrows the runtime value to the documented type.
-                              @type {?} */ (this.model).constructor
+                             * @type {?} */ (this.model).constructor
     /**
      * Batch.
-      @type {Array<import("../index.js").default>} */
+     * @type {Array<import("../index.js").default>} */
     const batch = []
 
     // Exact same class, persisted, no existing in-memory relationship state.
@@ -168,21 +168,21 @@ export default class VelociousDatabaseRecordBaseInstanceRelationship {
     if (type == "belongsTo") {
       const belongsToRelationship = /**
                                      * Narrows the runtime value to the documented type.
-                                      @type {import("../relationships/belongs-to.js").default} */ (relationshipDef)
+                                     * @type {import("../relationships/belongs-to.js").default} */ (relationshipDef)
       const preloader = new BelongsToPreloader({models: batch, relationship: belongsToRelationship})
 
       await preloader.run()
     } else if (type == "hasMany") {
       const hasManyRelationship = /**
                                    * Narrows the runtime value to the documented type.
-                                    @type {import("../relationships/has-many.js").default} */ (relationshipDef)
+                                   * @type {import("../relationships/has-many.js").default} */ (relationshipDef)
       const preloader = new HasManyPreloader({models: batch, relationship: hasManyRelationship})
 
       await preloader.run()
     } else if (type == "hasOne") {
       const hasOneRelationship = /**
                                   * Narrows the runtime value to the documented type.
-                                   @type {import("../relationships/has-one.js").default} */ (relationshipDef)
+                                  * @type {import("../relationships/has-one.js").default} */ (relationshipDef)
       const preloader = new HasOnePreloader({models: batch, relationship: hasOneRelationship})
 
       await preloader.run()
@@ -276,7 +276,7 @@ export default class VelociousDatabaseRecordBaseInstanceRelationship {
   getTargetModelClass() {
     const TargetModelClass = /**
                               * Narrows the runtime value to the documented type.
-                               @type {TMC} */ (this.getRelationship().getTargetModelClass())
+                              * @type {TMC} */ (this.getRelationship().getTargetModelClass())
 
     return TargetModelClass
   }

package/build/database/record/instance-relationships/belongs-to.js

@@ -25,13 +25,13 @@ export default class VelociousDatabaseRecordBelongsToInstanceRelationship extend
   build(data) {
     const TargetModelClass = /**
                               * Narrows the runtime value to the documented type.
-                               @type {TMC} */ (this.getTargetModelClass())
+                              * @type {TMC} */ (this.getTargetModelClass())
 
     if (!TargetModelClass) throw new Error("Can't build a new record without a target model")
 
     const newInstance = /**
                          * Narrows the runtime value to the documented type.
-                          @type {InstanceType<TMC>} */ (new TargetModelClass(data))
+                         * @type {InstanceType<TMC>} */ (new TargetModelClass(data))
 
     this._loaded = newInstance
 
@@ -84,7 +84,7 @@ export default class VelociousDatabaseRecordBelongsToInstanceRelationship extend
     const primaryKey = TargetModelClass.primaryKey()
     /**
      * Where args.
-      @type {Record<string, string | number | null | undefined>} */
+     * @type {Record<string, string | number | null | undefined>} */
     const whereArgs = {}
 
     whereArgs[primaryKey] = foreignModelID

package/build/database/record/instance-relationships/has-many.js

@@ -31,7 +31,7 @@ export default class VelociousDatabaseRecordHasManyInstanceRelationship extends
 
     const newInstance = /**
                          * Narrows the runtime value to the documented type.
-                          @type {InstanceType<TMC>} */ (new targetModelClass(data))
+                         * @type {InstanceType<TMC>} */ (new targetModelClass(data))
 
 
     // Add it to the loaded models of this relationship
@@ -67,7 +67,7 @@ export default class VelociousDatabaseRecordHasManyInstanceRelationship extends
       const foreignKeyValue = parentModel.readColumn(primaryKeyName)
       /**
        * Assign data.
-        @type {Record<string, ?>} */
+       * @type {Record<string, ?>} */
       const assignData = {}
 
       assignData[foreignKeyAttributeName] = foreignKeyValue
@@ -109,12 +109,12 @@ export default class VelociousDatabaseRecordHasManyInstanceRelationship extends
     const batched = await this._tryCohortPreload()
 
     if (batched) {
-      return /** Narrows the runtime value to the documented type. @type {InstanceType<TMC>[]} */ (Array.isArray(this._loaded) ? this._loaded : [])
+      return /** @type {InstanceType<TMC>[]} */ (Array.isArray(this._loaded) ? this._loaded : [])
     }
 
     const foreignModels = /**
                            * Narrows the runtime value to the documented type.
-                            @type {InstanceType<TMC>[]} */ (await this.query().load())
+                           * @type {InstanceType<TMC>[]} */ (await this.query().load())
 
     this.setLoaded(foreignModels)
     this.setDirty(false)
@@ -168,7 +168,7 @@ export default class VelociousDatabaseRecordHasManyInstanceRelationship extends
    * @returns {Promise<InstanceType<TMC>>} - Resolves with the find.
    */
   async find(modelID) {
-    return /** Narrows the runtime value to the documented type. @type {Promise<InstanceType<TMC>>} */ (this.query().find(modelID))
+    return /** @type {Promise<InstanceType<TMC>>} */ (this.query().find(modelID))
   }
 
   /**
@@ -204,7 +204,7 @@ export default class VelociousDatabaseRecordHasManyInstanceRelationship extends
       const parentPrimaryKey = this.getPrimaryKey()
       const parentId = /**
                         * Narrows the runtime value to the documented type.
-                         @type {string | number} */ (this.getModel().readColumn(parentPrimaryKey))
+                        * @type {string | number} */ (this.getModel().readColumn(parentPrimaryKey))
       const joinSql = `LEFT JOIN ${driver.quoteTable(throughTable)} ON ${driver.quoteTable(throughTable)}.${driver.quoteColumn(throughPrimaryKey)} = ${driver.quoteTable(targetTable)}.${driver.quoteColumn(targetForeignKey)}`
       const whereSql = `${driver.quoteTable(throughTable)}.${driver.quoteColumn(throughForeignKey)} = ${driver.options().quote(parentId)}`
 
@@ -217,11 +217,11 @@ export default class VelociousDatabaseRecordHasManyInstanceRelationship extends
     const primaryKey = this.getPrimaryKey()
     const primaryModelID = /**
                             * Narrows the runtime value to the documented type.
-                             @type {string | number} */ (this.getModel().readColumn(primaryKey))
+                            * @type {string | number} */ (this.getModel().readColumn(primaryKey))
 
     /**
      * Where args.
-      @type {Record<string, string | number>} */
+     * @type {Record<string, string | number>} */
     const whereArgs = {}
 
     whereArgs[foreignKey] = primaryModelID

package/build/database/record/instance-relationships/has-one.js

@@ -19,7 +19,7 @@ export default class VelociousDatabaseRecordHasOneInstanceRelationship extends B
 
   /**
    * Loaded.
-    @type {InstanceType<TMC> | undefined} */
+   * @type {InstanceType<TMC> | undefined} */
   _loaded = undefined
 
   /**
@@ -30,13 +30,13 @@ export default class VelociousDatabaseRecordHasOneInstanceRelationship extends B
   build(data) {
     const TargetModelClass = /**
                               * Narrows the runtime value to the documented type.
-                               @type {TMC} */ (this.getTargetModelClass())
+                              * @type {TMC} */ (this.getTargetModelClass())
 
     if (!TargetModelClass) throw new Error("Can't build a new record without a target model class")
 
     const newInstance = /**
                          * Narrows the runtime value to the documented type.
-                          @type {InstanceType<TMC>} */ (new TargetModelClass(data))
+                         * @type {InstanceType<TMC>} */ (new TargetModelClass(data))
 
     this._loaded = newInstance
 
@@ -58,16 +58,16 @@ export default class VelociousDatabaseRecordHasOneInstanceRelationship extends B
     const primaryKey = this.getPrimaryKey()
     const primaryModelID = /**
                             * Narrows the runtime value to the documented type.
-                             @type {string | number} */ (this.getModel().readColumn(primaryKey))
+                            * @type {string | number} */ (this.getModel().readColumn(primaryKey))
     const TargetModelClass = /**
                               * Narrows the runtime value to the documented type.
-                               @type {TMC} */ (this.getTargetModelClass())
+                              * @type {TMC} */ (this.getTargetModelClass())
 
     if (!TargetModelClass) throw new Error("Can't load without a target model class")
 
     /**
      * Where args.
-      @type {Record<string, string | number>} */
+     * @type {Record<string, string | number>} */
     const whereArgs = {}
 
     whereArgs[foreignKey] = primaryModelID
@@ -113,5 +113,5 @@ export default class VelociousDatabaseRecordHasOneInstanceRelationship extends B
     this._loaded = model
   }
 
-  getTargetModelClass() { return /** Narrows the runtime value to the documented type. @type {TMC | undefined} */ (this.relationship.getTargetModelClass()) }
+  getTargetModelClass() { return /** @type {TMC | undefined} */ (this.relationship.getTargetModelClass()) }
 }

package/build/database/record/relationships/base.js

@@ -135,9 +135,9 @@ export default class VelociousDatabaseRecordBaseRelationship {
 
     const scopedQuery = /**
                          * Narrows the runtime value to the documented type.
-                          @type {T | void} */ (scope.call(query, /**
+                         * @type {T | void} */ (scope.call(query, /**
                                                                   * Narrows the runtime value to the documented type.
-                                                                    @type {import("../../query/model-class-query.js").default<typeof import("../index.js").default>} */ (query)))
+                                                                  * @type {import("../../query/model-class-query.js").default<typeof import("../index.js").default>} */ (query)))
 
     return scopedQuery || query
   }

package/build/database/record/state-machine.js

@@ -23,7 +23,7 @@
 
 /**
  * Pending transition key.
-  @type {string} */
+ * @type {string} */
 const PENDING_TRANSITION_KEY = "_stateMachinePendingTransition"
 
 /**
@@ -65,7 +65,7 @@ export function stateMachine(ModelClass, definition) {
   // Store definition on the model class for introspection
   /**
    * Dynamic class.
-    @type {?} */
+   * @type {?} */
   const dynamicClass = ModelClass
 
   dynamicClass._stateMachineDefinition = definition
@@ -98,7 +98,7 @@ export function stateMachine(ModelClass, definition) {
   // Register event methods and guard methods on the prototype
   /**
    * Proto.
-    @type {?} */
+   * @type {?} */
   const proto = ModelClass.prototype
 
   for (const [eventName, eventDef] of Object.entries(definition.events)) {
@@ -147,7 +147,7 @@ export function stateMachine(ModelClass, definition) {
     proto[eventName] = function () {
       /**
        * Self.
-        @type {?} */
+       * @type {?} */
       const self = this
       const currentState = self.readAttribute(column)
 
@@ -182,7 +182,7 @@ export function stateMachine(ModelClass, definition) {
     proto[`${eventName}AndSave`] = async function () {
       /**
        * Self.
-        @type {?} */
+       * @type {?} */
       const self = this
       const currentState = self.readAttribute(column)
 
@@ -214,7 +214,7 @@ export function stateMachine(ModelClass, definition) {
   ModelClass.beforeSave(async function (model) {
     /**
      * Dynamic model.
-      @type {?} */
+     * @type {?} */
     const dynamicModel = model
     const pending = dynamicModel[PENDING_TRANSITION_KEY]
 
@@ -241,7 +241,7 @@ export function stateMachine(ModelClass, definition) {
   ModelClass.afterSave(async function (model) {
     /**
      * Dynamic model.
-      @type {?} */
+     * @type {?} */
     const dynamicModel = model
     const pending = dynamicModel[PENDING_TRANSITION_KEY]
 

package/build/database/record/validators/presence.js

@@ -12,7 +12,7 @@ export default class VelociousDatabaseRecordValidatorsPresence extends Base {
   async validate({model, attributeName}) {
     const rawValue = /**
                       * Narrows the runtime value to the documented type.
-                       @type {string | undefined} */ (model.readAttribute(attributeName))
+                      * @type {string | undefined} */ (model.readAttribute(attributeName))
     const attributeValue = rawValue?.trim()
 
     if (!attributeValue) {

package/build/database/record/validators/uniqueness.js

@@ -14,18 +14,18 @@ export default class VelociousDatabaseRecordValidatorsUniqueness extends Base {
   async validate({model, attributeName}) {
     const modelClass = /**
                         * Narrows the runtime value to the documented type.
-                         @type {typeof import("../index.js").default} */ (model.constructor)
+                        * @type {typeof import("../index.js").default} */ (model.constructor)
 
     const connection = modelClass.connection()
     const tableName = modelClass._getTable().getName()
     const attributeValue = /**
                             * Narrows the runtime value to the documented type.
-                             @type {string | number} */ (model.readAttribute(attributeName))
+                            * @type {string | number} */ (model.readAttribute(attributeName))
     const attributeNameUnderscore = inflection.underscore(attributeName)
 
     /**
      * Where args.
-      @type {Record<string, string | number>} */
+     * @type {Record<string, string | number>} */
     const whereArgs = {}
 
     whereArgs[attributeNameUnderscore] = attributeValue
@@ -51,7 +51,7 @@ export default class VelociousDatabaseRecordValidatorsUniqueness extends Base {
 
       whereArgs[scopeUnderscore] = /**
                                     * Narrows the runtime value to the documented type.
-                                     @type {string | number} */ (scopeValue)
+                                    * @type {string | number} */ (scopeValue)
     }
 
     let existingRecordQuery = modelClass
@@ -84,7 +84,7 @@ export default class VelociousDatabaseRecordValidatorsUniqueness extends Base {
   _resolveScopeValueFromRelationship(model, scopeColumn) {
     const modelClass = /**
                         * Narrows the runtime value to the documented type.
-                         @type {typeof import("../index.js").default} */ (model.constructor)
+                        * @type {typeof import("../index.js").default} */ (model.constructor)
     const relationships = modelClass.getRelationshipsMap()
 
     for (const relationshipName in relationships) {

package/build/database/table-data/index.js

@@ -13,22 +13,22 @@ import TableReference from "./table-reference.js"
 export default class TableData {
   /**
    * Columns.
-    @type {TableColumn[]} */
+   * @type {TableColumn[]} */
   _columns = []
 
   /**
    * Foreign keys.
-    @type {import("./table-foreign-key.js").default[]} */
+   * @type {import("./table-foreign-key.js").default[]} */
   _foreignKeys = []
 
   /**
    * Indexes.
-    @type {TableIndex[]} */
+   * @type {TableIndex[]} */
   _indexes = []
 
   /**
    * References.
-    @type {TableReference[]} */
+   * @type {TableReference[]} */
   _references = []
 
   /**

package/build/environment-handlers/base.js

@@ -79,7 +79,7 @@ export default class VelociousEnvironmentHandlerBase {
 
     /**
      * Narrows the runtime value to the documented type.
-      @type {number} */
+     * @type {number} */
     this.configuration._timezoneOffsetMinutes = _offsetMinutes
   }
 
@@ -97,7 +97,7 @@ export default class VelociousEnvironmentHandlerBase {
       return activeConfiguration._timezoneOffsetMinutes
     }
 
-    return /** Narrows the runtime value to the documented type. @type {number} */ (activeConfiguration.getTimezoneOffsetMinutes())
+    return /** @type {number} */ (activeConfiguration.getTimezoneOffsetMinutes())
   }
 
   /**

package/build/environment-handlers/browser.js

@@ -42,17 +42,17 @@ function isMigrationObject(migration) {
 export default class VelociousEnvironmentsHandlerBrowser extends Base {
   /**
    * Find commands require context result.
-    @type {CommandsRequireContextType | undefined} */
+   * @type {CommandsRequireContextType | undefined} */
   findCommandsRequireContextResult = undefined
 
   /**
    * Migrations require context result.
-    @type {MigrationsRequireContextType | undefined} */
+   * @type {MigrationsRequireContextType | undefined} */
   _migrationsRequireContextResult = undefined
 
   /**
    * Test files require context result.
-    @type {TestFilesRequireContextType | undefined} */
+   * @type {TestFilesRequireContextType | undefined} */
   _testFilesRequireContextResult = undefined
 
   /**
@@ -117,7 +117,7 @@ export default class VelociousEnvironmentsHandlerBrowser extends Base {
    */
   _findCommandsRequireContext() {
     // @ts-expect-error
-    this.findCommandsRequireContextResult ||= /** Narrows the runtime value to the documented type. @type {CommandsRequireContextType} */ (require.context("../cli/commands", true, /\.js$/))
+    this.findCommandsRequireContextResult ||= /** @type {CommandsRequireContextType} */ (require.context("../cli/commands", true, /\.js$/))
 
     return this.findCommandsRequireContextResult
   }
@@ -195,7 +195,7 @@ export default class VelociousEnvironmentsHandlerBrowser extends Base {
     const migrationsRequireContext = await this.migrationsRequireContext()
     /**
      * Migrations.
-      @type {Array<import("./base.js").MigrationObjectType | null>} */
+     * @type {Array<import("./base.js").MigrationObjectType | null>} */
     const migrations = migrationsRequireContext
       .keys()
       .map((file) => {
@@ -228,10 +228,10 @@ export default class VelociousEnvironmentsHandlerBrowser extends Base {
       .filter(isMigrationObject)
     /**
      * Files.
-      @type {import("./base.js").MigrationObjectType[]} */
+     * @type {import("./base.js").MigrationObjectType[]} */
     const files = /**
                    * Narrows the runtime value to the documented type.
-                    @type {import("./base.js").MigrationObjectType[]} */ (migrations)
+                   * @type {import("./base.js").MigrationObjectType[]} */ (migrations)
 
     files.sort((migration1, migration2) => migration1.date - migration2.date)
 

package/build/environment-handlers/node/cli/commands/cli-command-context.js

@@ -19,7 +19,7 @@ export default function buildCliCommandContext(command, argsOffset) {
   const identifiers = Object.keys(dbs)
   /**
    * Process args.
-    @type {string[]} */
+   * @type {string[]} */
   const processArgs = command.processArgs || []
 
   return {

package/build/environment-handlers/node/cli/commands/console.js

@@ -5,7 +5,7 @@ import repl from "node:repl"
 
 /**
  * Defines this typedef.
-  @typedef {{application: import("../../../../application.js").default, configuration: import("../../../../configuration.js").default}} ConsoleContextArgs */
+ * @typedef {{application: import("../../../../application.js").default, configuration: import("../../../../configuration.js").default}} ConsoleContextArgs */
 
 /**
  * Runs build console context.
@@ -15,7 +15,7 @@ import repl from "node:repl"
 function buildConsoleContext({application, configuration}) {
   /**
    * Dbs.
-    @type {Record<string, import("../../../../database/drivers/base.js").default>} */
+   * @type {Record<string, import("../../../../database/drivers/base.js").default>} */
   const dbs = configuration.getCurrentConnections()
 
   for (const identifier of configuration.getDatabaseIdentifiers()) {
@@ -24,7 +24,7 @@ function buildConsoleContext({application, configuration}) {
     const pool = configuration.getDatabasePool(identifier)
     const poolWithGlobal = /**
                             * Narrows the runtime value to the documented type.
-                             @type {{getGlobalConnection?: () => import("../../../../database/drivers/base.js").default | undefined}} */ (pool)
+                            * @type {{getGlobalConnection?: () => import("../../../../database/drivers/base.js").default | undefined}} */ (pool)
     const globalConnection = poolWithGlobal.getGlobalConnection?.()
 
     if (globalConnection) {
@@ -67,7 +67,7 @@ function assignConsoleContext({context, replServer}) {
 
   const modelClasses = /**
                         * Narrows the runtime value to the documented type.
-                         @type {Record<string, typeof import("../../../../database/record/index.js").default>} */ (
+                        * @type {Record<string, typeof import("../../../../database/record/index.js").default>} */ (
     context.models || {}
   )
 

package/build/environment-handlers/node/cli/commands/db/schema/dump.js

@@ -6,7 +6,7 @@ import path from "path"
 export default class DbSchemaDump extends BaseCommand {
   /**
    * Runs execute.
-    @returns {Promise<void>} */
+   * @returns {Promise<void>} */
   async execute() {
     await this.getConfiguration().ensureConnections({name: "DB schema dump"}, async (dbs) => {
       const shouldGenerate = await this.shouldGenerateStructureSql({dbs})

package/build/environment-handlers/node/cli/commands/db/schema/load.js

@@ -7,7 +7,7 @@ import splitSqlStatements from "../../../../../../utils/split-sql-statements.js"
 export default class DbSchemaLoad extends BaseCommand {
   /**
    * Runs execute.
-    @returns {Promise<void>} */
+   * @returns {Promise<void>} */
   async execute() {
     await this.getConfiguration().ensureConnections({name: "DB schema load"}, async (dbs) => {
       const dbDir = path.join(this.directory(), "db")
@@ -59,11 +59,11 @@ export default class DbSchemaLoad extends BaseCommand {
   executableConnection(db) {
     const dbWithConnection = /**
                               * Narrows the runtime value to the documented type.
-                               @type {import("../../../../../../database/drivers/base.js").default & {connection?: ?}} */ (db)
+                              * @type {import("../../../../../../database/drivers/base.js").default & {connection?: ?}} */ (db)
     const connection = dbWithConnection.connection
 
     if (connection && typeof connection == "object" && "exec" in connection && typeof connection.exec == "function") {
-      return /** Narrows the runtime value to the documented type. @type {{exec: (sql: string) => Promise<?>}} */ (connection)
+      return /** @type {{exec: (sql: string) => Promise<?>}} */ (connection)
     }
   }
 }