velocious 1.0.577 → 1.0.579

package/build/database/annotations.js

@@ -2,7 +2,7 @@
 
 /**
  * Defines this typedef.
- * @typedef {{getDatabaseAnnotations?: () => string[], withDatabaseAnnotation?: (annotation: string, callback: () => Promise<?>) => Promise<?>}} DatabaseAnnotationsRuntime */
+ * @typedef {{getDatabaseAnnotations?: () => string[], withDatabaseAnnotation?: (annotation: string, callback: () => Promise<ReturnType<typeof JSON.parse>>) => Promise<ReturnType<typeof JSON.parse>>}} DatabaseAnnotationsRuntime */
 /**
  * Database annotations global.
  * @type {typeof globalThis & {velociousDatabaseAnnotations?: DatabaseAnnotationsRuntime}} */

package/build/database/drivers/base-column.js

@@ -21,7 +21,7 @@ export default class VelociousDatabaseDriversBaseColumn {
   /**
    * Runs get default.
    * @abstract
-   * @returns {?} - The default.
+   * @returns {ReturnType<typeof JSON.parse>} - The default.
    */
   getDefault() {
     throw new Error("getDefault not implemented")

package/build/database/drivers/base-foreign-key.js

@@ -10,7 +10,7 @@ export default class VelociousDatabaseDriversBaseForeignKey {
 
   /**
    * Runs constructor.
-   * @param {Record<string, ?>} data - Data payload.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} data - Data payload.
    */
   constructor(data) {
     this.data = data

package/build/database/drivers/base-table.js

@@ -135,7 +135,7 @@ export default class VelociousDatabaseDriversBaseTable {
   /**
    * Runs truncate.
    * @param {{cascade: boolean}} [args] - Truncate options.
-   * @returns {Promise<Array<Record<string, ?>>>} - Resolves with the truncate.
+   * @returns {Promise<Array<Record<string, ReturnType<typeof JSON.parse>>>>} - Resolves with the truncate.
    */
   async truncate(args) {
     this.getDriver()._assertNotReadOnly()

package/build/database/drivers/base.js

@@ -25,21 +25,21 @@
  * DeleteSqlArgsType type.
  * @typedef {object} DeleteSqlArgsType
  * @property {string} tableName - Table name to delete from.
- * @property {{[key: string]: ?}} conditions - Conditions used to build the delete WHERE clause.
+ * @property {{[key: string]: ReturnType<typeof JSON.parse>}} conditions - Conditions used to build the delete WHERE clause.
  */
 /**
  * InsertSqlArgsType type.
  * @typedef {object} InsertSqlArgsType
  * @property {string[]} [columns] - Column names for `rows` inserts.
- * @property {{[key: string]: ?}} [data] - Column/value pairs for a single-row insert.
+ * @property {{[key: string]: ReturnType<typeof JSON.parse>}} [data] - Column/value pairs for a single-row insert.
  * @property {boolean} [multiple] - Whether this insert should be treated as multi-row.
  * @property {string[]} [returnLastInsertedColumnNames] - Column names to return after insert.
- * @property {Array<Array<?>>} [rows] - Row values for a multi-row insert.
+ * @property {Array<Array<ReturnType<typeof JSON.parse>>>} [rows] - Row values for a multi-row insert.
  * @property {string} tableName - Table name to insert into.
  */
 /**
  * QueryRowType type.
- * @typedef {Record<string, ?>} QueryRowType
+ * @typedef {Record<string, ReturnType<typeof JSON.parse>>} QueryRowType
  * @typedef {Array<QueryRowType>} QueryResultType
  */
 /**
@@ -141,7 +141,7 @@ import {optionalPositiveInteger} from "typanic"
 class VelociousDatabaseAfterCommitCallbackError extends Error {
   /**
    * Runs constructor.
-   * @param {?} callbackError - Original callback failure.
+   * @param {ReturnType<typeof JSON.parse>} callbackError - Original callback failure.
    */
   constructor(callbackError) {
     super("Database afterCommit callback failed")
@@ -181,7 +181,7 @@ export default class VelociousDatabaseDriversBase {
   _transactionCallbackFrames
   /**
    * Narrows the runtime value to the documented type.
-   * @type {Map<string, Promise<?>>} */
+   * @type {Map<string, Promise<ReturnType<typeof JSON.parse>>>} */
   _schemaCache
   /**
    * Narrows the runtime value to the documented type.
@@ -490,8 +490,8 @@ export default class VelociousDatabaseDriversBase {
   /**
    * Runs escape.
    * @abstract
-   * @param {?} value - Value to use.
-   * @returns {?} - The escape.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to use.
+   * @returns {ReturnType<typeof JSON.parse>} - The escape.
    */
   escape(value) { // eslint-disable-line no-unused-vars
     throw new Error("'escape' not implemented")
@@ -654,8 +654,8 @@ export default class VelociousDatabaseDriversBase {
 
   /**
    * Runs schema cache return value.
-   * @param {?} value - Cached value.
-   * @returns {?} - Value returned to callers.
+   * @param {ReturnType<typeof JSON.parse>} value - Cached value.
+   * @returns {ReturnType<typeof JSON.parse>} - Value returned to callers.
    */
   _schemaCacheReturnValue(value) {
     if (Array.isArray(value)) return value.slice()
@@ -770,7 +770,7 @@ export default class VelociousDatabaseDriversBase {
    * Runs insert multiple.
    * @param {string} tableName - Table name.
    * @param {Array<string>} columns - Column names.
-   * @param {Array<Array<?>>} rows - Rows to insert.
+   * @param {Array<Array<ReturnType<typeof JSON.parse>>>} rows - Rows to insert.
    * @returns {Promise<void>} - Resolves when complete.
    */
   async insertMultiple(tableName, columns, rows) {
@@ -815,8 +815,8 @@ export default class VelociousDatabaseDriversBase {
 
   /**
    * Runs convert value.
-   * @param {?} value - Value to use.
-   * @returns {?} - The convert value.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to use.
+   * @returns {ReturnType<typeof JSON.parse>} - The convert value.
    */
   _convertValue(value) {
     if (typeof value === "boolean") {
@@ -846,7 +846,7 @@ export default class VelociousDatabaseDriversBase {
   /**
    * Whether a value is a plain object or array that should be JSON-encoded for a
    * JSON/text column. Excludes Buffers and class instances (e.g. model records).
-   * @param {?} value - Value to test.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to test.
    * @returns {boolean} - Whether to JSON-encode the value.
    */
   _isJsonEncodableValue(value) {
@@ -870,7 +870,7 @@ export default class VelociousDatabaseDriversBase {
 
   /**
    * Runs quote.
-   * @param {?} value - Value to use.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to use.
    * @returns {number | string} - The quote.
    */
   quote(value) {
@@ -1087,7 +1087,7 @@ export default class VelociousDatabaseDriversBase {
    * @template T
    * @param {() => Promise<T>} callback - Callback function.
    * @param {Pick<QueryOptions, "operationOwner">} options - Transaction ownership.
-   * @returns {Promise<?>} - Resolves with the transaction result.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the transaction result.
    */
   async _runTransactionAttempt(callback, options) {
     const savePointName = this.generateSavePointName()
@@ -2002,8 +2002,8 @@ export default class VelociousDatabaseDriversBase {
 
   /**
    * Runs with disabled foreign keys.
-   * @param {function() : void} callback - Callback function.
-   * @returns {Promise<?>} - Resolves with the with disabled foreign keys.
+   * @param {() => void} callback - Callback function.
+   * @returns {Promise<ReturnType<typeof JSON.parse>>} - Resolves with the with disabled foreign keys.
    */
   async withDisabledForeignKeys(callback) {
     await this.disableForeignKeys()

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

@@ -7,7 +7,7 @@ export default class VelociousDatabaseDriversMssqlColumn extends BaseColumn {
   /**
    * Runs constructor.
    * @param {import("../base-table.js").default} table - Table.
-   * @param {Record<string, ?>} data - Data payload.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} data - Data payload.
    */
   constructor(table, data) {
     super()

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

@@ -407,7 +407,7 @@ export default class VelociousDatabaseDriversMssql extends Base{
 
   /**
    * Runs escape.
-   * @param {?} value - Value to use.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to use.
    * @returns {string} - The escape.
    */
   escape(value) {
@@ -422,7 +422,7 @@ export default class VelociousDatabaseDriversMssql extends Base{
 
   /**
    * Runs quote.
-   * @param {?} value - Value to use.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to use.
    * @returns {string | number} - The quoted value.
    */
   quote(value) {

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

@@ -22,7 +22,7 @@ export default class VelociousDatabaseDriversMssqlOptions extends QueryParserOpt
 
   /**
    * Runs quote.
-   * @param {?} string - String.
+   * @param {ReturnType<typeof JSON.parse>} string - String.
    * @returns {number | string} - The quote.
    */
   quote(string) {

package/build/database/drivers/mssql/structure-sql.js

@@ -71,7 +71,7 @@ export default class VelociousDatabaseDriversMssqlStructureSql {
 
   /**
    * Runs column definition.
-   * @param {Record<string, ?>} column - Column.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} column - Column.
    * @returns {string | null} - The column definition.
    */
   _columnDefinition(column) {

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

@@ -171,7 +171,7 @@ export default class VelociousDatabaseDriversMssqlTable extends BaseTable {
   /**
    * Runs truncate.
    * @param {{cascade: boolean}} [args] - Truncate options.
-   * @returns {Promise<Array<Record<string, ?>>>} - Resolves with the truncate.
+   * @returns {Promise<Array<Record<string, ReturnType<typeof JSON.parse>>>>} - Resolves with the truncate.
    */
   async truncate(args) { // eslint-disable-line no-unused-vars
     this.getDriver()._assertNotReadOnly()

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

@@ -8,7 +8,7 @@ export default class VelociousDatabaseDriversMysqlColumn extends BaseColumn {
   /**
    * Runs constructor.
    * @param {import("../base-table.js").default} table - Table.
-   * @param {Record<string, ?>} data - Data payload.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} data - Data payload.
    */
   constructor(table, data) {
     super()

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

@@ -174,7 +174,7 @@ export default class VelociousDatabaseDriversMysql extends Base{
 
   /**
    * Runs connect args.
-   * @returns {Record<string, ?>} - The connect args.
+   * @returns {Record<string, ReturnType<typeof JSON.parse>>} - The connect args.
    */
   connectArgs() {
     const args = this.getArgs()
@@ -182,7 +182,7 @@ export default class VelociousDatabaseDriversMysql extends Base{
 
     /**
      * Connect args.
-     * @type {Record<string, ?>} */
+     * @type {Record<string, ReturnType<typeof JSON.parse>>} */
     const connectArgs = {charset: "utf8mb4", timezone: "Z"}
 
     for (const forwardValue of forward) {
@@ -480,8 +480,8 @@ export default class VelociousDatabaseDriversMysql extends Base{
 
   /**
    * Runs escape.
-   * @param {?} value - Value to use.
-   * @returns {?} - The escape.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to use.
+   * @returns {ReturnType<typeof JSON.parse>} - The escape.
    */
   escape(value) {
     const escapedValueWithQuotes = this.pool

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

@@ -22,7 +22,7 @@ export default class VelociousDatabaseDriversMysqlOptions extends QueryParserOpt
 
   /**
    * Runs quote.
-   * @param {?} string - String.
+   * @param {ReturnType<typeof JSON.parse>} string - String.
    * @returns {number | string} - The quote.
    */
   quote(string) {

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

@@ -84,7 +84,7 @@ function killServerQuery(pool, threadId) {
     let killConnection
 
     try {
-      killConnection = mysql.createConnection(/** @type {?} */ (connectionConfig))
+      killConnection = mysql.createConnection(/** @type {ReturnType<typeof JSON.parse>} */ (connectionConfig))
     } catch {
       resolve()
 
@@ -111,7 +111,7 @@ function killServerQuery(pool, threadId) {
  * @param {import("mysql").Pool} pool - Pool.
  * @param {string} sql - SQL string.
  * @param {{signal?: AbortSignal}} [options] - Query options.
- * @returns {Promise<Record<string, ?>[]>} - Resolves with the mapped rows.
+ * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>[]>} - Resolves with the mapped rows.
  */
 export default async function query(pool, sql, {signal} = {}) {
   if (signal?.aborted) throw new QueryAbortedError({sql})
@@ -157,7 +157,7 @@ export default async function query(pool, sql, {signal} = {}) {
       return
     }
 
-    connection.query(sql, (/** @type {?} */ error, /** @type {?} */ results, /** @type {?} */ fields) => {
+    connection.query(sql, (/** @type {ReturnType<typeof JSON.parse>} */ error, /** @type {ReturnType<typeof JSON.parse>} */ results, /** @type {ReturnType<typeof JSON.parse>} */ fields) => {
       if (settled) return
 
       settle()
@@ -184,9 +184,9 @@ export default async function query(pool, sql, {signal} = {}) {
 
 /**
  * Materializes the driver rows as isolated plain records keyed by field name.
- * @param {?} results - Driver result rows.
- * @param {?} fields - Driver result fields.
- * @returns {Record<string, ?>[]} - Mapped rows.
+ * @param {ReturnType<typeof JSON.parse>} results - Driver result rows.
+ * @param {ReturnType<typeof JSON.parse>} fields - Driver result fields.
+ * @returns {Record<string, ReturnType<typeof JSON.parse>>[]} - Mapped rows.
  */
 function mapRows(results, fields) {
   const rows = []
@@ -196,7 +196,7 @@ function mapRows(results, fields) {
   for (const rowData of resultRows) {
     /**
      * Result.
-     * @type {Record<string, ?>} */
+     * @type {Record<string, ReturnType<typeof JSON.parse>>} */
     const result = {}
 
     for (const fieldData of resultFields) {

package/build/database/drivers/mysql/structure-sql.js

@@ -20,6 +20,9 @@ export default class VelociousDatabaseDriversMysqlStructureSql {
     const {driver} = this
     const isMariaDb = await this._isMariaDb()
     const rows = await driver.query("SELECT table_name, table_type FROM information_schema.tables WHERE table_schema = DATABASE() ORDER BY table_type, table_name")
+    const foreignKeyRows = await driver.query("SELECT table_name, referenced_table_name FROM information_schema.key_column_usage WHERE table_schema = DATABASE() AND referenced_table_schema = DATABASE() AND referenced_table_name IS NOT NULL")
+    const baseTableNames = []
+    const views = []
     const statements = []
 
     for (const row of rows) {
@@ -31,24 +34,82 @@ export default class VelociousDatabaseDriversMysqlStructureSql {
       if (!tableName || !tableType) continue
 
       if (tableType == "BASE TABLE") {
-        const createRows = await driver.query(`SHOW CREATE TABLE ${driver.quoteTable(tableName)}`)
-        const rawCreateStatement = this._mysqlCreateStatement(createRows?.[0])
-        const createStatement = rawCreateStatement ? this._stripAutoIncrement(rawCreateStatement) : null
-
-        if (createStatement) statements.push(normalizeSqlStatement(createStatement))
+        baseTableNames.push(tableName)
       } else if (tableType == "VIEW" || (isMariaDb && tableType == "SYSTEM VIEW")) {
-        const createRows = await driver.query(`SHOW CREATE VIEW ${driver.quoteTable(tableName)}`)
-        const createStatement = this._mysqlCreateStatement(createRows?.[0])
-
-        if (createStatement) statements.push(normalizeSqlStatement(createStatement))
+        views.push(tableName)
       }
     }
 
+    for (const tableName of this._orderBaseTables({foreignKeyRows, tableNames: baseTableNames})) {
+      const createRows = await driver.query(`SHOW CREATE TABLE ${driver.quoteTable(tableName)}`)
+      const rawCreateStatement = this._mysqlCreateStatement(createRows?.[0])
+      const createStatement = rawCreateStatement ? this._stripAutoIncrement(rawCreateStatement) : null
+
+      if (createStatement) statements.push(normalizeSqlStatement(createStatement))
+    }
+
+    for (const tableName of views) {
+      const createRows = await driver.query(`SHOW CREATE VIEW ${driver.quoteTable(tableName)}`)
+      const createStatement = this._mysqlCreateStatement(createRows?.[0])
+
+      if (createStatement) statements.push(normalizeSqlStatement(createStatement))
+    }
+
     if (statements.length == 0) return null
 
     return `${statements.join("\n\n")}\n`
   }
 
+  /**
+   * Orders tables so referenced tables are created before their dependents.
+   * @param {object} args - Options object.
+   * @param {Array<Record<string, ReturnType<typeof JSON.parse>>>} args.foreignKeyRows - Foreign key metadata rows.
+   * @param {string[]} args.tableNames - Base table names in their existing order.
+   * @returns {string[]} - Ordered table names.
+   */
+  _orderBaseTables({foreignKeyRows, tableNames}) {
+    const pendingTableNames = new Set(tableNames)
+    /** @type {Record<string, Set<string>>} */
+    const dependenciesByTableName = {}
+    const orderedTableNames = []
+
+    for (const tableName of tableNames) {
+      dependenciesByTableName[tableName] = new Set()
+    }
+
+    for (const row of foreignKeyRows) {
+      const tableNameValue = row.table_name || row.TABLE_NAME
+      const referencedTableNameValue = row.referenced_table_name || row.REFERENCED_TABLE_NAME
+      const tableName = tableNameValue ? String(tableNameValue) : ""
+      const referencedTableName = referencedTableNameValue ? String(referencedTableNameValue) : ""
+
+      if (tableName == referencedTableName || !pendingTableNames.has(tableName) || !pendingTableNames.has(referencedTableName)) continue
+
+      dependenciesByTableName[tableName].add(referencedTableName)
+    }
+
+    while (pendingTableNames.size > 0) {
+      const nextTableName = tableNames.find((tableName) => {
+        if (!pendingTableNames.has(tableName)) return false
+
+        return Array.from(dependenciesByTableName[tableName]).every((dependencyTableName) => !pendingTableNames.has(dependencyTableName))
+      })
+
+      if (!nextTableName) {
+        for (const tableName of tableNames) {
+          if (pendingTableNames.has(tableName)) orderedTableNames.push(tableName)
+        }
+
+        break
+      }
+
+      orderedTableNames.push(nextTableName)
+      pendingTableNames.delete(nextTableName)
+    }
+
+    return orderedTableNames
+  }
+
   /**
    * Runs is maria db.
    * @returns {Promise<boolean>} - Resolves with Whether maria db.
@@ -65,7 +126,7 @@ export default class VelociousDatabaseDriversMysqlStructureSql {
 
   /**
    * Runs mysql create statement.
-   * @param {Record<string, ?> | undefined} row - Row data.
+   * @param {Record<string, ReturnType<typeof JSON.parse>> | undefined} row - Row data.
    * @returns {string | null} - SQL string.
    */
   _mysqlCreateStatement(row) {

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

@@ -7,7 +7,7 @@ export default class VelociousDatabaseDriversPgsqlColumn extends BaseColumn {
   /**
    * Runs constructor.
    * @param {import("../base-table.js").default} table - Table.
-   * @param {Record<string, ?>} data - Data payload.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} data - Data payload.
    */
   constructor(table, data) {
     super()

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

@@ -48,7 +48,7 @@ export default class VelociousDatabaseDriversPgsql extends Base{
 
     /**
      * Connect args.
-     * @type {Record<string, ?>} */
+     * @type {Record<string, ReturnType<typeof JSON.parse>>} */
     const connectArgs = {}
 
     for (const forwardValue of forward) {
@@ -250,8 +250,8 @@ export default class VelociousDatabaseDriversPgsql extends Base{
 
   /**
    * Runs convert value.
-   * @param {?} value - Value to use.
-   * @returns {?} - The converted value.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to use.
+   * @returns {ReturnType<typeof JSON.parse>} - The converted value.
    */
   _convertValue(value) {
     if (typeof value === "boolean") {
@@ -263,8 +263,8 @@ export default class VelociousDatabaseDriversPgsql extends Base{
 
   /**
    * Runs escape.
-   * @param {?} value - Value to use.
-   * @returns {?} - The escape.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to use.
+   * @returns {ReturnType<typeof JSON.parse>} - The escape.
    */
   escape(value) {
     if (!this.connection) throw new Error("Can't escape before connected")
@@ -277,7 +277,7 @@ export default class VelociousDatabaseDriversPgsql extends Base{
 
   /**
    * Runs quote.
-   * @param {?} value - Value to use.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to use.
    * @returns {string | number} - The quoted value.
    */
   quote(value) {

package/build/database/drivers/pgsql/structure-sql.js

@@ -79,7 +79,7 @@ export default class VelociousDatabaseDriversPgsqlStructureSql {
 
   /**
    * Runs column definition.
-   * @param {Record<string, ?>} column - Column.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} column - Column.
    * @returns {string | null} - The column definition.
    */
   _columnDefinition(column) {

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

@@ -150,7 +150,7 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
    * Runs insert multiple.
    * @param {string} tableName - Table name.
    * @param {Array<string>} columns - Column names.
-   * @param {Array<Array<?>>} rows - Rows to insert.
+   * @param {Array<Array<ReturnType<typeof JSON.parse>>>} rows - Rows to insert.
    * @returns {Promise<void>} - Resolves when complete.
    */
   async insertMultiple(tableName, columns, rows) {
@@ -213,7 +213,7 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
    * Runs insert multiple with single insert.
    * @param {string} tableName - Table name.
    * @param {Array<string>} columns - Column names.
-   * @param {Array<Array<?>>} rows - Rows to insert.
+   * @param {Array<Array<ReturnType<typeof JSON.parse>>>} rows - Rows to insert.
    * @returns {Promise<void>} - Resolves when complete.
    */
   async insertMultipleWithSingleInsert(tableName, columns, rows) {
@@ -227,7 +227,7 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
    * Runs insert multiple with transaction.
    * @param {string} tableName - Table name.
    * @param {Array<string>} columns - Column names.
-   * @param {Array<Array<?>>} rows - Rows to insert.
+   * @param {Array<Array<ReturnType<typeof JSON.parse>>>} rows - Rows to insert.
    * @returns {Promise<void>} - Resolves when complete.
    */
   async insertMultipleWithTransaction(tableName, columns, rows) {
@@ -240,7 +240,7 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
     for (const row of rows) {
       /**
        * Data.
-       * @type {Record<string, ?>} */
+       * @type {Record<string, ReturnType<typeof JSON.parse>>} */
       const data = {}
 
       for (const columnIndex in columns) {
@@ -302,8 +302,8 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
 
   /**
    * Runs escape.
-   * @param {?} value - Value to use.
-   * @returns {?} - The escape.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to use.
+   * @returns {ReturnType<typeof JSON.parse>} - The escape.
    */
   escape(value) {
     value = this._convertValue(value)
@@ -335,7 +335,7 @@ export default class VelociousDatabaseDriversSqliteBase extends Base {
 
   /**
    * Runs quote.
-   * @param {?} value - Value to use.
+   * @param {ReturnType<typeof JSON.parse>} value - Value to use.
    * @returns {string | number} - The quoted value.
    */
   quote(value) {

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

@@ -7,7 +7,7 @@ export default class VelociousDatabaseDriversSqliteColumn extends BaseColumn {
   /**
    * Runs constructor.
    * @param {object} args - Options object.
-   * @param {Record<string, ?>} args.column - Column.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} args.column - Column.
    * @param {import("../base.js").default} args.driver - Database driver instance.
    * @param {import("../base-table.js").default} args.table - Table.
    */

package/build/database/drivers/sqlite/connection-sql-js.js

@@ -85,7 +85,7 @@ export default class VelociousDatabaseDriversSqliteConnectionSqlJs {
   /**
    * Runs query.
    * @param {string} sql - SQL string.
-   * @returns {Promise<Record<string, ?>[]>} - Resolves with the query.
+   * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>[]>} - Resolves with the query.
    */
   async query(sql) {
     const result = await queryWeb(this.connection, sql)

package/build/database/drivers/sqlite/foreign-key.js

@@ -6,7 +6,7 @@ import {digg} from "diggerize"
 export default class VelociousDatabaseDriversSqliteForeignKey extends BaseForeignKey {
   /**
    * Runs constructor.
-   * @param {Record<string, ?>} data - Data payload.
+   * @param {Record<string, ReturnType<typeof JSON.parse>>} data - Data payload.
    * @param {object} args - Options object.
    * @param {string} args.tableName - Table name.
    */

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

@@ -70,7 +70,7 @@ export default class VelociousDatabaseDriversSqliteNode extends Base {
   /**
    * Runs query actual.
    * @param {string} sql - SQL string.
-   * @returns {Promise<Record<string, ?>[]>} - Resolves with the query actual.
+   * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>[]>} - Resolves with the query actual.
    */
   async _queryActual(sql) {
     if (!this.connection) throw new Error("No connection")

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

@@ -51,7 +51,7 @@ export default class VelociousDatabaseDriversSqliteNative extends Base {
     const args = this.getArgs()
     /**
      * Connect args.
-     * @type {Record<string, ?>} */
+     * @type {Record<string, ReturnType<typeof JSON.parse>>} */
     const connectArgs = {}
     const forward = ["database", "host", "password"]
 
@@ -72,7 +72,7 @@ export default class VelociousDatabaseDriversSqliteNative extends Base {
   /**
    * Runs query actual.
    * @param {string} sql - SQL string.
-   * @returns {Promise<Record<string, ?>[]>} - Query result rows.
+   * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>[]>} - Query result rows.
    */
   async _queryActual(sql) {
     return await this._queryMutex.sync(() => {

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

@@ -8,7 +8,7 @@ import Base from "./base.js"
 
 /**
  * VelociousDatabaseDriversSqliteWeb class.
- * @typedef {{query: (sql: string) => Promise<Record<string, ?>[]>, affectedRows: (sql: string) => Promise<number>, close: () => Promise<void>}} SqliteWebConnection
+ * @typedef {{query: (sql: string) => Promise<Record<string, ReturnType<typeof JSON.parse>>[]>, affectedRows: (sql: string) => Promise<number>, close: () => Promise<void>}} SqliteWebConnection
  */
 
 export default class VelociousDatabaseDriversSqliteWeb extends Base {
@@ -170,7 +170,7 @@ export default class VelociousDatabaseDriversSqliteWeb extends Base {
   /**
    * Runs query actual.
    * @param {string} sql - SQL string.
-   * @returns {Promise<Record<string, ?>[]>} - Resolves with the query actual.
+   * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>[]>} - Resolves with the query actual.
    */
   async _queryActual(sql) {
     const result = await this.getConnection().query(sql)

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

@@ -4,13 +4,13 @@
  * Runs query.
  * @param {import("sqlite").Database} connection - Connection.
  * @param {string} sql - SQL string.
- * @returns {Promise<Record<string, ?>[]>} - Resolves with string value.
+ * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>[]>} - Resolves with string value.
  */
 export default async function query(connection, sql) {
   try {
     /**
      * Defines result.
-     * @type {Record<string, ?>[]} */
+     * @type {Record<string, ReturnType<typeof JSON.parse>>[]} */
     let result
 
     result = await connection.all(sql)

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

@@ -1,8 +1,8 @@
 /**
  * Run a query using the native SQLite async API.
- * @param {import("sqlite3").Database & {getAllAsync: (sql: string) => Promise<Record<string, ?>[]>}} connection - SQLite connection instance.
+ * @param {import("sqlite3").Database & {getAllAsync: (sql: string) => Promise<Record<string, ReturnType<typeof JSON.parse>>[]>}} connection - SQLite connection instance.
  * @param {string} sql - SQL string to execute.
- * @returns {Promise<Record<string, ?>[]>} - Resolves with the result rows.
+ * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>>[]>} - Resolves with the result rows.
  */
 export default async function query(connection, sql) {
   const rows = []