velocious 1.0.577 → 1.0.579

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

@@ -55,7 +55,7 @@ export default class VelociousDatabaseRecordBaseInstanceRelationship {
   /**
    * Runs build.
    * @abstract
-   * @param {Record<string, ?>} attributes - Attributes.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} attributes - Attributes.
    * @returns {InstanceType<TMC>} - The build.
    */
   build(attributes) { // eslint-disable-line no-unused-vars
@@ -126,14 +126,14 @@ export default class VelociousDatabaseRecordBaseInstanceRelationship {
   async _tryCohortPreload() {
     const relationshipDef = this.getRelationship()
     const configuration = relationshipDef.getConfiguration()
-    const cohort = /** @type {Array<import("../index.js").default> | undefined} */ (/** @type {?} */ (this.model)._loadCohort)
+    const cohort = /** @type {Array<import("../index.js").default> | undefined} */ (/** @type {ReturnType<typeof JSON.parse>} */ (this.model)._loadCohort)
 
     if (!configuration.getAutoload() || !relationshipDef.getAutoload() || !cohort || cohort.length <= 1) {
       return false
     }
 
     const relationshipName = relationshipDef.getRelationshipName()
-    const OwnerModelClass = /** @type {?} */ (this.model).constructor
+    const OwnerModelClass = /** @type {ReturnType<typeof JSON.parse>} */ (this.model).constructor
     /**
      * Batch.
      * @type {Array<import("../index.js").default>} */
@@ -245,7 +245,7 @@ export default class VelociousDatabaseRecordBaseInstanceRelationship {
    * Runs get relationship.
    * @returns {import("../relationships/base.js").default} The relationship object that this instance relationship is based on
    */
-  getRelationship() { return this.relationship }
+  getRelationship() { return this.relationship.resolveForRecord(this.model) }
 
   /**
    * Runs apply scope.

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

@@ -19,7 +19,7 @@ export default class VelociousDatabaseRecordBelongsToInstanceRelationship extend
 
   /**
    * Runs build.
-   * @param {Record<string, ?>} data - Data payload.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} data - Data payload.
    * @returns {InstanceType<TMC>} - The build.
    */
   build(data) {

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

@@ -20,7 +20,7 @@ export default class VelociousDatabaseRecordHasManyInstanceRelationship extends
 
   /**
    * Runs build.
-   * @param {Record<string, ?>} data - Data payload.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} data - Data payload.
    * @returns {InstanceType<TMC>} - The build.
    */
   build(data) {
@@ -66,7 +66,7 @@ export default class VelociousDatabaseRecordHasManyInstanceRelationship extends
       const foreignKeyValue = parentModel.readColumn(primaryKeyName)
       /**
        * Assign data.
-       * @type {Record<string, ?>} */
+       * @type {Record<string, ReturnType<typeof JSON.parse>>} */
       const assignData = {}
 
       assignData[foreignKeyAttributeName] = foreignKeyValue
@@ -81,7 +81,7 @@ export default class VelociousDatabaseRecordHasManyInstanceRelationship extends
 
   /**
    * Runs create.
-   * @param {Record<string, ?>} data - Data payload.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} data - Data payload.
    * @returns {Promise<InstanceType<TMC>>} - Resolves with the create.
    */
   async create(data) {

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

@@ -24,7 +24,7 @@ export default class VelociousDatabaseRecordHasOneInstanceRelationship extends B
 
   /**
    * Runs build.
-   * @param {Record<string, ?>} data - Data payload.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} data - Data payload.
    * @returns {InstanceType<TMC>} - The build.
    */
   build(data) {

package/build/database/record/record-not-found-error.js

@@ -1,3 +1,4 @@
 // @ts-check
 
+/** Backend missing-record error whose diagnostic message stays server-side. */
 export default class RecordNotFoundError extends Error {}

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

@@ -7,6 +7,10 @@ import * as inflection from "inflection"
  * RelationshipScopeCallback type.
  * @typedef {(query: import("../../query/model-class-query.js").default<typeof import("../index.js").default>) => (import("../../query/model-class-query.js").default<typeof import("../index.js").default> | void)} RelationshipScopeCallback
  */
+/**
+ * RelationshipRecordResolver type.
+ * @typedef {(record: import("../index.js").default) => VelociousDatabaseRecordBaseRelationship} RelationshipRecordResolver
+ */
 /**
  * RelationshipBaseArgsType type.
  * @typedef {object} RelationshipBaseArgsType
@@ -58,6 +62,24 @@ export default class VelociousDatabaseRecordBaseRelationship {
     this.type = type
   }
 
+  /**
+   * Installs metadata selection for relationships whose physical definition varies by record operation.
+   * @param {RelationshipRecordResolver} resolver - Record-owned relationship resolver.
+   * @returns {void}
+   */
+  setRecordResolver(resolver) {
+    this._recordResolver = resolver
+  }
+
+  /**
+   * Resolves this relationship for a record's captured physical database identity.
+   * @param {import("../index.js").default} record - Record owning the relationship access.
+   * @returns {VelociousDatabaseRecordBaseRelationship} - Physical relationship metadata.
+   */
+  resolveForRecord(record) {
+    return this._recordResolver ? this._recordResolver(record) : this
+  }
+
   /**
    * Runs get autoload.
    * @returns {boolean} Whether this relationship auto-batch-preloads siblings on lazy access.

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

@@ -67,7 +67,7 @@ export function stateMachine(ModelClass, definition) {
   // Store definition on the model class for introspection
   /**
    * Dynamic class.
-   * @type {?} */
+   * @type {ReturnType<typeof JSON.parse>} */
   const dynamicClass = ModelClass
 
   // Idempotent: re-declaring on the same class (or a re-evaluated module) must not
@@ -108,7 +108,7 @@ export function stateMachine(ModelClass, definition) {
   // Register event methods and guard methods on the prototype
   /**
    * Proto.
-   * @type {?} */
+   * @type {ReturnType<typeof JSON.parse>} */
   const proto = ModelClass.prototype
 
   for (const [eventName, eventDef] of Object.entries(definition.events)) {
@@ -157,7 +157,7 @@ export function stateMachine(ModelClass, definition) {
     proto[eventName] = function () {
       /**
        * Self.
-       * @type {?} */
+       * @type {ReturnType<typeof JSON.parse>} */
       const self = this
       const currentState = self.readAttribute(column)
 
@@ -192,7 +192,7 @@ export function stateMachine(ModelClass, definition) {
     proto[`${eventName}AndSave`] = async function () {
       /**
        * Self.
-       * @type {?} */
+       * @type {ReturnType<typeof JSON.parse>} */
       const self = this
       const currentState = self.readAttribute(column)
 
@@ -224,7 +224,7 @@ export function stateMachine(ModelClass, definition) {
   ModelClass.beforeSave(async function (model) {
     /**
      * Dynamic model.
-     * @type {?} */
+     * @type {ReturnType<typeof JSON.parse>} */
     const dynamicModel = model
     const pending = dynamicModel[PENDING_TRANSITION_KEY]
 
@@ -257,7 +257,7 @@ export function stateMachine(ModelClass, definition) {
   ModelClass.afterSave(async function (model) {
     /**
      * Dynamic model.
-     * @type {?} */
+     * @type {ReturnType<typeof JSON.parse>} */
     const dynamicModel = model
     const pending = dynamicModel[PENDING_TRANSITION_KEY]
 

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

@@ -5,7 +5,7 @@ export default class VelociousDatabaseRecordValidatorsBase {
    * Runs constructor.
    * @param {object} args - Options object.
    * @param {string} args.attributeName - Attribute name.
-   * @param {Record<string, ?>} args.args - Options object.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} args.args - Options object.
    */
   constructor({attributeName, args}) {
     this.attributeName = attributeName

package/build/database/structure-sql-loader.js

@@ -61,14 +61,14 @@ export default class StructureSqlLoader {
    * `exec` (a single round-trip for the whole dump), otherwise undefined so the
    * caller falls back to per-statement execution.
    * @param {import("./drivers/base.js").default} db - Database connection.
-   * @returns {{exec: (sql: string) => Promise<?>} | undefined} - Connection with exec support.
+   * @returns {{exec: (sql: string) => Promise<ReturnType<typeof JSON.parse>>} | undefined} - Connection with exec support.
    */
   executableConnection(db) {
-    const dbWithConnection = /** @type {import("./drivers/base.js").default & {connection?: ?}} */ (db)
+    const dbWithConnection = /** @type {import("./drivers/base.js").default & {connection?: ReturnType<typeof JSON.parse>}} */ (db)
     const connection = dbWithConnection.connection
 
     if (connection && typeof connection == "object" && "exec" in connection && typeof connection.exec == "function") {
-      return /** @type {{exec: (sql: string) => Promise<?>}} */ (connection)
+      return /** @type {{exec: (sql: string) => Promise<ReturnType<typeof JSON.parse>>}} */ (connection)
     }
   }
 }

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

@@ -13,7 +13,7 @@ import TableForeignKey from "./table-foreign-key.js"
  * TableColumnArgsType type.
  * @typedef {object} TableColumnArgsType
  * @property {boolean} [autoIncrement] - Whether the column auto-increments.
- * @property {?} [default] - Default value for the column.
+ * @property {ReturnType<typeof JSON.parse>} [default] - Default value for the column.
  * @property {boolean} [dropColumn] - Whether the column should be dropped.
  * @property {boolean|object} [foreignKey] - Foreign key options or flag.
  * @property {boolean|IndexArgType} [index] - Whether the column should be indexed.
@@ -99,13 +99,13 @@ export default class TableColumn {
 
   /**
    * Runs get default.
-   * @returns {? | (() => ?)} - The default value or factory.
+   * @returns {ReturnType<typeof JSON.parse> | (() => ReturnType<typeof JSON.parse>)} - The default value or factory.
    */
   getDefault() { return this.args?.default }
 
   /**
    * Runs set default.
-   * @param {?} newDefault - New default.
+   * @param {ReturnType<typeof JSON.parse>} newDefault - New default.
    * @returns {void} - No return value.
    */
   setDefault(newDefault) { this.args.default = newDefault }

package/build/database/use-live-query.js

@@ -29,7 +29,7 @@ import LiveQuery from "./live-query.js"
 /**
  * Stable empty state returned while there is no active query, so a paused hook
  * keeps a referentially stable snapshot for `useSyncExternalStore`.
- * @type {LiveQueryState<?>} */
+ * @type {LiveQueryState<ReturnType<typeof JSON.parse>>} */
 const EMPTY_STATE = {error: null, loading: false, results: []}
 
 /**
@@ -47,7 +47,7 @@ let nextQueryIdentity = 0
  * controller is rebuilt when they change. Model-class queries expose `toSql`, so
  * distinct conditions yield distinct keys; other sources fall back to a stable
  * per-object identity (such sources must be memoized by the caller).
- * @param {LiveQuerySource<?> & {toSql?: () => ?}} query - Query source.
+ * @param {LiveQuerySource<ReturnType<typeof JSON.parse>> & {toSql?: () => ReturnType<typeof JSON.parse>}} query - Query source.
  * @param {RecordModelClass[] | undefined} models - Explicit model classes to observe.
  * @returns {string} Dependency key.
  */
@@ -73,7 +73,7 @@ function liveQueryDependencyKey(query, models) {
  * whenever a watched model commits — so local writes, pull applies, and realtime
  * applies all refresh the results without any manual refresh plumbing.
  * @template T
- * @param {(LiveQuerySource<T> & {toSql?: () => ?}) | null | undefined} query - Query source, e.g. `Model.where({...})`.
+ * @param {(LiveQuerySource<T> & {toSql?: () => ReturnType<typeof JSON.parse>}) | null | undefined} query - Query source, e.g. `Model.where({...})`.
  * @param {UseLiveQueryOptions} [options] - Hook options.
  * @returns {LiveQueryState<T>} Current results, loading, and last error.
  */

package/build/environment-handlers/base.js

@@ -19,6 +19,21 @@ import {validateTimeZone} from "../time-zone.js"
  */
 
 export default class VelociousEnvironmentHandlerBase {
+  /**
+   * Mutable ambient tenant used by runtimes without async-context storage.
+   * @type {ReturnType<typeof JSON.parse> | undefined}
+   */
+  _currentTenant = undefined
+
+  /**
+   * Active ambient scopes in start order. This prevents a scope that completes
+   * out of order from restoring a tenant belonging to an already-completed scope.
+   * Ambient reads are still shared in browser runtimes; immutable handles remain
+   * the concurrency-safe database API.
+   * @type {Array<{owner: symbol, tenant: ReturnType<typeof JSON.parse>}>}
+   */
+  _tenantScopes = []
+
   /**
    * Runs debug endpoint token matches.
    * @param {string} providedToken - Token from the request.
@@ -54,8 +69,8 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs run with timezone offset.
    * @param {number} _offsetMinutes - Offset in minutes (Date#getTimezoneOffset).
-   * @param {() => Promise<?>} callback - Callback to run.
-   * @returns {Promise<?>} - Result of the callback.
+   * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback to run.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Result of the callback.
    */
   async runWithTimezoneOffset(_offsetMinutes, callback) {
     if (!this.configuration) throw new Error("Configuration hasn't been set")
@@ -74,8 +89,8 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs run with timezone.
    * @param {string} timeZone - IANA timezone identifier.
-   * @param {() => Promise<?>} callback - Callback to run.
-   * @returns {Promise<?>} - Result of the callback.
+   * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback to run.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Result of the callback.
    */
   async runWithTimezone(timeZone, callback) {
     if (!this.configuration) throw new Error("Configuration hasn't been set")
@@ -149,8 +164,8 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs run with request timing.
    * @param {import("../http-server/client/request-timing.js").default | undefined} requestTiming - Request timing collector.
-   * @param {() => Promise<?>} callback - Callback.
-   * @returns {Promise<?>} - Callback result.
+   * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Callback result.
    */
   async runWithRequestTiming(requestTiming, callback) {
     this._currentRequestTiming = requestTiming
@@ -173,8 +188,8 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs run with ability.
    * @param {import("../authorization/ability.js").default | undefined} ability - Ability to set for callback scope.
-   * @param {() => Promise<?>} callback - Callback.
-   * @returns {Promise<?>} - Callback result.
+   * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Callback result.
    */
   async runWithAbility(ability, callback) {
     this._currentAbility = ability
@@ -205,23 +220,27 @@ export default class VelociousEnvironmentHandlerBase {
 
   /**
    * Runs run with tenant.
-   * @param {?} tenant - Tenant to set for callback scope.
-   * @param {() => Promise<?>} callback - Callback.
-   * @returns {Promise<?>} - Callback result.
+   * @param {ReturnType<typeof JSON.parse>} tenant - Tenant to set for callback scope.
+   * @param {() => Promise<ReturnType<typeof JSON.parse>>} callback - Callback.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Callback result.
    */
   async runWithTenant(tenant, callback) {
-    this._currentTenant = tenant
+    const scope = {owner: Symbol("browser-tenant-scope"), tenant}
+
+    this._tenantScopes.push(scope)
 
     try {
       return await callback()
     } finally {
-      this._currentTenant = undefined
+      const scopeIndex = this._tenantScopes.findIndex((candidate) => candidate.owner === scope.owner)
+
+      if (scopeIndex !== -1) this._tenantScopes.splice(scopeIndex, 1)
     }
   }
 
   /**
    * Runs set current tenant.
-   * @param {?} tenant - Tenant to set.
+   * @param {ReturnType<typeof JSON.parse>} tenant - Tenant to set.
    * @returns {void} - No return value.
    */
   setCurrentTenant(tenant) {
@@ -230,15 +249,15 @@ export default class VelociousEnvironmentHandlerBase {
 
   /**
    * Runs get current tenant.
-   * @returns {?} - Current tenant.
+   * @returns {ReturnType<typeof JSON.parse>} - Current tenant.
    */
   getCurrentTenant() {
-    return this._currentTenant
+    return this._tenantScopes[this._tenantScopes.length - 1]?.tenant ?? this._currentTenant
   }
   /**
    * Runs cli commands generate base models.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsGenerateBaseModels(_command) {
     throw new Error("cliCommandsGenerateBaseModels not implemented")
@@ -247,7 +266,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands generate frontend models.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsGenerateFrontendModels(_command) {
     throw new Error("cliCommandsGenerateFrontendModels not implemented")
@@ -256,7 +275,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands init.
    * @param {import("../cli/base-command.js").default} command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsInit(command) { // eslint-disable-line no-unused-vars
     throw new Error("cliCommandsInit not implemented")
@@ -265,7 +284,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands migration generate.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsMigrationGenerate(_command) {
     throw new Error("cliCommandsMigrationGenerate not implemented")
@@ -274,7 +293,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands migration destroy.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsMigrationDestroy(_command) {
     throw new Error("cliCommandsMigrationDestroy not implemented")
@@ -283,7 +302,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands generate model.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsGenerateModel(_command) {
     throw new Error("cliCommandsGenerateModel not implemented")
@@ -293,7 +312,7 @@ export default class VelociousEnvironmentHandlerBase {
    * Runs cli commands lint relationships.
    * @abstract
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsLintRelationships(_command) {
     throw new Error("cliCommandsLintRelationships not implemented")
@@ -303,7 +322,7 @@ export default class VelociousEnvironmentHandlerBase {
    * Runs cli commands routes.
    * @abstract
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsRoutes(_command) {
     throw new Error("cliCommandsRoutes not implemented")
@@ -312,7 +331,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands console.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsConsole(_command) {
     throw new Error("cliCommandsConsole not implemented")
@@ -321,7 +340,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands server.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsServer(_command) {
     throw new Error("cliCommandsServer not implemented")
@@ -330,7 +349,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands test.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsTest(_command) {
     throw new Error("cliCommandsTest not implemented")
@@ -339,7 +358,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands background jobs main.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsBackgroundJobsMain(_command) {
     throw new Error("cliCommandsBackgroundJobsMain not implemented")
@@ -348,7 +367,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands background jobs worker.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsBackgroundJobsWorker(_command) {
     throw new Error("cliCommandsBackgroundJobsWorker not implemented")
@@ -357,7 +376,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands background jobs runner.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsBackgroundJobsRunner(_command) {
     throw new Error("cliCommandsBackgroundJobsRunner not implemented")
@@ -366,7 +385,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands beacon.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsBeacon(_command) {
     throw new Error("cliCommandsBeacon not implemented")
@@ -397,7 +416,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands db schema dump.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsDbSchemaDump(_command) {
     throw new Error("cliCommandsDbSchemaDump not implemented")
@@ -406,7 +425,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands db schema load.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsDbSchemaLoad(_command) {
     throw new Error("cliCommandsDbSchemaLoad not implemented")
@@ -415,7 +434,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands db seed.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsDbSeed(_command) {
     throw new Error("cliCommandsDbSeed not implemented")
@@ -424,7 +443,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands runner.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsRunner(_command) {
     throw new Error("cliCommandsRunner not implemented")
@@ -433,7 +452,7 @@ export default class VelociousEnvironmentHandlerBase {
   /**
    * Runs cli commands run script.
    * @param {import("../cli/base-command.js").default} _command - Command.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async cliCommandsRunScript(_command) {
     throw new Error("cliCommandsRunScript not implemented")
@@ -457,7 +476,7 @@ export default class VelociousEnvironmentHandlerBase {
    * Runs forward command.
    * @param {import("../cli/base-command.js").default} command - Command.
    * @param {typeof import("../cli/base-command.js").default} CommandClass - Command class.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async forwardCommand(command, CommandClass) {
     const newCommand = new CommandClass({

package/build/environment-handlers/browser.js

@@ -23,7 +23,7 @@ import Logger from "../logger.js"
 
 /**
  * TestFilesRequireContextIDFunctionType type.
- * @typedef {(id: string) => ?} TestFilesRequireContextIDFunctionType
+ * @typedef {(id: string) => ReturnType<typeof JSON.parse>} TestFilesRequireContextIDFunctionType
  * @typedef {TestFilesRequireContextIDFunctionType & {
  *   keys: () => string[],
  *   id: string

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

@@ -10,7 +10,7 @@ import repl from "node:repl"
 /**
  * Runs build console context.
  * @param {ConsoleContextArgs} args - Options object.
- * @returns {Record<string, ?>} - The console context.
+ * @returns {Record<string, ReturnType<typeof JSON.parse>>} - The console context.
  */
 function buildConsoleContext({application, configuration}) {
   /**
@@ -56,7 +56,7 @@ function buildConsoleContext({application, configuration}) {
 /**
  * Runs assign console context.
  * @param {object} args - Options object.
- * @param {Record<string, ?>} args.context - The base context.
+ * @param {Record<string, ReturnType<typeof JSON.parse>>} args.context - The base context.
  * @param {import("node:repl").REPLServer} args.replServer - The REPL server.
  * @returns {void} - No return value.
  */
@@ -76,7 +76,7 @@ function assignConsoleContext({context, replServer}) {
  * Runs start console repl.
  * @param {object} args - Options object.
  * @param {import("../../../../configuration.js").default} args.configuration - Configuration instance.
- * @param {Record<string, ?>} args.context - REPL context.
+ * @param {Record<string, ReturnType<typeof JSON.parse>>} args.context - REPL context.
  * @returns {Promise<void>} - Resolves when the console exits.
  */
 async function startConsoleRepl({configuration, context}) {
@@ -117,7 +117,7 @@ async function startConsoleRepl({configuration, context}) {
 export default class VelociousCliCommandsConsole extends BaseCommand{
   /**
    * Runs execute.
-   * @returns {Promise<?>} - Resolves with the command result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the command result.
    */
   async execute() {
     const configuration = this.getConfiguration()

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

@@ -11,7 +11,7 @@ import toImportSpecifier from "../../../../../utils/to-import-specifier.js"
 /**
  * Runs import runner function.
  * @param {string} filePath - Absolute path to script file.
- * @returns {Promise<(context: RunnerContext) => Promise<?>>} - The default-exported async function.
+ * @returns {Promise<(context: RunnerContext) => Promise<ReturnType<typeof JSON.parse>>>} - The default-exported async function.
  */
 async function importRunnerFunction(filePath) {
   const runnerImport = await import(toImportSpecifier(filePath))
@@ -28,7 +28,7 @@ async function importRunnerFunction(filePath) {
 export default class DbSeed extends BaseCommand {
   /**
    * Runs execute.
-   * @returns {Promise<?>} - Resolves with the seed function result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the seed function result.
    */
   async execute() {
     const configuration = this.getConfiguration()

package/build/environment-handlers/node/cli/commands/generate/base-models.js

@@ -317,7 +317,7 @@ export default class DbGenerateModel extends BaseCommand {
           fileContent += "\n"
           fileContent += "  /**\n"
           fileContent += "   * @abstract\n"
-          fileContent += "   * @param {Record<string, ?>} [attributes]\n"
+          fileContent += "   * @param {Record<string, ReturnType<typeof JSON.parse>>} [attributes]\n"
           fileContent += `   * @returns {import("${modelFilePath}").default}\n`
           fileContent += "   */\n"
           fileContent += `  build${inflection.camelize(relationship.getRelationshipName())}(attributes) { void attributes; throw new Error("Not implemented") }\n`

package/build/environment-handlers/node/cli/commands/run-script.js

@@ -11,7 +11,7 @@ import toImportSpecifier from "../../../../utils/to-import-specifier.js"
 /**
  * Runs import run script function.
  * @param {string} filePath - Absolute path to script file.
- * @returns {Promise<(context: RunScriptContext) => Promise<?>>} - The default-exported async function.
+ * @returns {Promise<(context: RunScriptContext) => Promise<ReturnType<typeof JSON.parse>>>} - The default-exported async function.
  */
 async function importRunScriptFunction(filePath) {
   const scriptImport = await import(toImportSpecifier(filePath))
@@ -28,7 +28,7 @@ async function importRunScriptFunction(filePath) {
 export default class RunScriptCommand extends BaseCommand {
   /**
    * Runs execute.
-   * @returns {Promise<?>} - Resolves with the script function result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the script function result.
    */
   async execute() {
     const configuration = this.getConfiguration()