velocious 1.0.428 → 1.0.430

package/build/src/database/drivers/base.d.ts

@@ -1,20 +1,33 @@
 export default class VelociousDatabaseDriversBase {
     /**
+     * Runs constructor.
      * @param {import("../../configuration-types.js").DatabaseConfigurationType} config - Configuration object.
      * @param {import("../../configuration.js").default} configuration - Configuration instance.
      */
     constructor(config: import("../../configuration-types.js").DatabaseConfigurationType, configuration: import("../../configuration.js").default);
-    /** @type {number | undefined} */
+    /**
+     * Id seq.
+      @type {number | undefined} */
     idSeq: number | undefined;
-    /** @type {Array<Array<() => void | Promise<void>>>} */
+    /**
+     * Narrows the runtime value to the documented type.
+      @type {Array<Array<() => void | Promise<void>>>} */
     _afterCommitCallbackFrames: Array<Array<() => void | Promise<void>>>;
-    /** @type {Map<string, Promise<unknown>>} */
+    /**
+     * Narrows the runtime value to the documented type.
+      @type {Map<string, Promise<?>>} */
     _schemaCache: Map<string, Promise<unknown>>;
-    /** @type {(() => void) | undefined} */
+    /**
+     * Narrows the runtime value to the documented type.
+      @type {(() => void) | undefined} */
     _schemaCacheInvalidator: (() => void) | undefined;
-    /** @type {string | undefined} */
+    /**
+     * Narrows the runtime value to the documented type.
+      @type {string | undefined} */
     _connectionCheckoutName: string | undefined;
-    /** @type {ActiveQueryState | null} */
+    /**
+     * Active query.
+      @type {ActiveQueryState | null} */
     _activeQuery: ActiveQueryState | null;
     _args: import("../../configuration-types.js").DatabaseConfigurationType;
     configuration: import("../../configuration.js").default;
@@ -23,6 +36,7 @@ export default class VelociousDatabaseDriversBase {
     _transactionsCount: number;
     _transactionsActionsMutex: Mutex;
     /**
+     * Runs add foreign key.
      * @param {string} tableName - Table name.
      * @param {string} columnName - Column name.
      * @param {string} referencedTableName - Referenced table name.
@@ -32,12 +46,14 @@ export default class VelociousDatabaseDriversBase {
      */
     addForeignKey(tableName: string, columnName: string, referencedTableName: string, referencedColumnName: string, args: object): Promise<void>;
     /**
+     * Runs alter table sqls.
      * @abstract
      * @param {import("../table-data/index.js").default} _tableData - Table data.
      * @returns {Promise<string[]>} - Resolves with SQL statements.
      */
     alterTableSQLs(_tableData: import("../table-data/index.js").default): Promise<string[]>;
     /**
+     * Runs connect.
      * @abstract
      * @returns {Promise<void>} - Resolves when complete.
      */
@@ -48,18 +64,24 @@ export default class VelociousDatabaseDriversBase {
      */
     close(): Promise<void>;
     /**
+     * Runs set connection checkout name.
      * @param {string | undefined} name - Human-readable name for this active checkout.
      * @returns {Promise<void>} - Resolves when complete.
      */
     setConnectionCheckoutName(name: string | undefined): Promise<void>;
     _connectionCheckedOutAtUnixMs: number | undefined;
-    /** @returns {Promise<void>} - Resolves when complete. */
+    /**
+     * Runs clear connection checkout name.
+     * @returns {Promise<void>} - Resolves when complete.
+     */
     clearConnectionCheckoutName(): Promise<void>;
     /**
+     * Runs reconnect.
      * @returns {Promise<void>} - Resolves when complete.
      */
     reconnect(): Promise<void>;
     /**
+     * Runs create database sql.
      * @abstract
      * @param {string} databaseName - Database name.
      * @param {object} [args] - Options object.
@@ -74,6 +96,7 @@ export default class VelociousDatabaseDriversBase {
         databaseCollation?: string | undefined;
     }): string[];
     /**
+     * Runs drop database sql.
      * @abstract
      * @param {string} databaseName - Database name.
      * @param {object} [args] - Options object.
@@ -84,40 +107,47 @@ export default class VelociousDatabaseDriversBase {
         ifExists?: boolean | undefined;
     }): string[];
     /**
+     * Runs create index sqls.
      * @abstract
      * @param {CreateIndexSqlArgs} indexData - Index data.
      * @returns {Promise<string[]>} - Resolves with SQL statements.
      */
     createIndexSQLs(indexData: CreateIndexSqlArgs): Promise<string[]>;
     /**
+     * Runs create table.
      * @param {import("../table-data/index.js").default} tableData - Table data.
      * @returns {Promise<void>} - Resolves when complete.
      */
     createTable(tableData: import("../table-data/index.js").default): Promise<void>;
     /**
+     * Runs create table sql.
      * @abstract
      * @param {import("../table-data/index.js").default} tableData - Table data.
      * @returns {Promise<string[]>} - Resolves with SQL statements.
      */
     createTableSql(tableData: import("../table-data/index.js").default): Promise<string[]>;
     /**
+     * Runs delete.
      * @param {DeleteSqlArgsType} args - Options object.
      * @returns {Promise<void>} - Resolves when complete.
      */
     delete(args: DeleteSqlArgsType): Promise<void>;
     /**
+     * Runs delete sql.
      * @abstract
      * @param {DeleteSqlArgsType} args - Options object.
      * @returns {string} - SQL string.
      */
     deleteSql(args: DeleteSqlArgsType): string;
     /**
+     * Runs drop table.
      * @param {string} tableName - Table name.
      * @param {DropTableSqlArgsType} [args] - Options object.
      * @returns {Promise<void>} - Resolves when complete.
      */
     dropTable(tableName: string, args?: DropTableSqlArgsType): Promise<void>;
     /**
+     * Runs drop table sqls.
      * @abstract
      * @param {string} tableName - Table name.
      * @param {DropTableSqlArgsType} [args] - Options object.
@@ -125,20 +155,24 @@ export default class VelociousDatabaseDriversBase {
      */
     dropTableSQLs(tableName: string, args?: DropTableSqlArgsType): Promise<string[]>;
     /**
+     * Runs escape.
      * @abstract
-     * @param {any} value - Value to use.
-     * @returns {any} - The escape.
+     * @param {?} value - Value to use.
+     * @returns {?} - The escape.
      */
-    escape(value: any): any;
+    escape(value: unknown): unknown;
     /**
+     * Runs get args.
      * @returns {import("../../configuration-types.js").DatabaseConfigurationType} - The args.
      */
     getArgs(): import("../../configuration-types.js").DatabaseConfigurationType;
     /**
+     * Runs get configuration.
      * @returns {import("../../configuration.js").default} - The configuration.
      */
     getConfiguration(): import("../../configuration.js").default;
     /**
+     * Runs get id seq.
      * @returns {number | undefined} - The id seq.
      */
     getIdSeq(): number | undefined;
@@ -153,15 +187,18 @@ export default class VelociousDatabaseDriversBase {
      */
     _clearLocalSchemaCache(): void;
     /**
+     * Runs set schema cache invalidator.
      * @param {() => void} invalidator - Callback used to clear schema caches that share this driver pool.
      * @returns {void} - No return value.
      */
     setSchemaCacheInvalidator(invalidator: () => void): void;
     /**
+     * Runs schema cache enabled.
      * @returns {boolean} - Whether schema metadata caching is enabled.
      */
     _schemaCacheEnabled(): boolean;
     /**
+     * Runs cached schema metadata.
      * @template T
      * @param {string} cacheKey - Schema cache key.
      * @param {() => Promise<T>} callback - Cache miss callback.
@@ -169,6 +206,7 @@ export default class VelociousDatabaseDriversBase {
      */
     _cachedSchemaMetadata<T>(cacheKey: string, callback: () => Promise<T>): Promise<T>;
     /**
+     * Runs cached table schema metadata.
      * @template T
      * @param {string} tableName - Table name.
      * @param {string} metadataName - Metadata name.
@@ -177,20 +215,24 @@ export default class VelociousDatabaseDriversBase {
      */
     _cachedTableSchemaMetadata<T>(tableName: string, metadataName: string, callback: () => Promise<T>): Promise<T>;
     /**
-     * @param {unknown} value - Cached value.
-     * @returns {unknown} - Value returned to callers.
+     * Runs schema cache return value.
+     * @param {?} value - Cached value.
+     * @returns {?} - Value returned to callers.
      */
     _schemaCacheReturnValue(value: unknown): unknown;
     /**
+     * Runs get tables.
      * @abstract
      * @returns {Promise<Array<import("./base-table.js").default>>} - Resolves with the tables.
      */
     getTables(): Promise<Array<import("./base-table.js").default>>;
     /**
+     * Runs structure sql.
      * @returns {Promise<string | null>} - Resolves with SQL string.
      */
     structureSql(): Promise<string | null>;
     /**
+     * Runs get table by name.
      * @param {string} name - Name.
      * @param {object} [args] - Options object.
      * @param {boolean} args.throwError - Whether throw error.
@@ -200,128 +242,146 @@ export default class VelociousDatabaseDriversBase {
         throwError: boolean;
     }): Promise<import("./base-table.js").default | undefined>;
     /**
+     * Runs missing table error message.
      * @param {string} name - Table name.
      * @param {string[]} tableNames - Available table names.
      * @returns {string} - Error message.
      */
     _missingTableErrorMessage(name: string, tableNames: string[]): string;
     /**
+     * Runs get table by name or fail.
      * @param {string} name - Name.
      * @returns {Promise<import("./base-table.js").default>} - Resolves with the table by name or fail.
      */
     getTableByNameOrFail(name: string): Promise<import("./base-table.js").default>;
     /**
+     * Runs get type.
      * @abstract
      * @returns {string} - The type.
      */
     getType(): string;
     /**
+     * Runs insert.
      * @param {InsertSqlArgsType} args - Options object.
      * @returns {Promise<void>} - Resolves when complete.
      */
     insert(args: InsertSqlArgsType): Promise<void>;
     /**
+     * Runs insert multiple.
      * @param {string} tableName - Table name.
      * @param {Array<string>} columns - Column names.
-     * @param {Array<Array<unknown>>} rows - Rows to insert.
+     * @param {Array<Array<?>>} rows - Rows to insert.
      * @returns {Promise<void>} - Resolves when complete.
      */
     insertMultiple(tableName: string, columns: Array<string>, rows: Array<Array<unknown>>): Promise<void>;
     /**
+     * Runs insert sql.
      * @abstract
      * @param {InsertSqlArgsType} args - Options object.
      * @returns {string} - SQL string.
      */
     insertSql(args: InsertSqlArgsType): string;
     /**
+     * Runs upsert.
      * @param {UpsertSqlArgsType} args - Options object.
      * @returns {Promise<void>} - Resolves when complete.
      */
     upsert(args: UpsertSqlArgsType): Promise<void>;
     /**
+     * Runs last insert id.
      * @abstract
      * @returns {Promise<number>} - Resolves with the last insert id.
      */
     lastInsertID(): Promise<number>;
     /**
-     * @param {any} value - Value to use.
-     * @returns {any} - The convert value.
+     * Runs convert value.
+     * @param {?} value - Value to use.
+     * @returns {?} - The convert value.
      */
-    _convertValue(value: any): any;
+    _convertValue(value: unknown): unknown;
     /**
      * 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 {any} value - Value to test.
+     * @param {?} value - Value to test.
      * @returns {boolean} - Whether to JSON-encode the value.
      */
-    _isJsonEncodableValue(value: any): boolean;
+    _isJsonEncodableValue(value: unknown): boolean;
     /**
+     * Runs options.
      * @abstract
      * @returns {import("../query-parser/options.js").default} - The options options.
      */
     options(): import("../query-parser/options.js").default;
     /**
-     * @param {any} value - Value to use.
+     * Runs quote.
+     * @param {?} value - Value to use.
      * @returns {number | string} - The quote.
      */
-    quote(value: any): number | string;
+    quote(value: unknown): number | string;
     /**
+     * Runs quote column.
      * @param {string} columnName - Column name.
      * @returns {string} - The quote column.
      */
     quoteColumn(columnName: string): string;
     /**
+     * Runs quote index.
      * @param {string} columnName - Column name.
      * @returns {string} - The quote index.
      */
     quoteIndex(columnName: string): string;
     /**
+     * Runs quote table.
      * @param {string} tableName - Table name.
      * @returns {string} - The quote table.
      */
     quoteTable(tableName: string): string;
     /**
-     * @param {any} value - Value from database.
-     * @returns {any} - Normalized value.
-     */
-    /**
+     * Runs new query.
      * @returns {Query} - The new query.
      */
     newQuery(): Query;
     /**
+     * Runs select.
      * @param {string} tableName - Table name.
      * @returns {Promise<QueryResultType>} - Resolves with the select.
      */
     select(tableName: string): Promise<QueryResultType>;
     /**
+     * Runs set id seq.
      * @param {number | undefined} newIdSeq - New id seq.
      * @returns {void} - No return value.
      */
     setIdSeq(newIdSeq: number | undefined): void;
     /**
+     * Runs should set auto increment when primary key.
      * @abstract
      * @returns {boolean} - Whether set auto increment when primary key.
      */
     shouldSetAutoIncrementWhenPrimaryKey(): boolean;
     /**
+     * Runs supports default primary key uuid.
      * @returns {boolean} - Whether supports default primary key uuid.
      */
     supportsDefaultPrimaryKeyUUID(): boolean;
     /**
+     * Runs supports insert into returning.
      * @abstract
      * @returns {boolean} - Whether supports insert into returning.
      */
     supportsInsertIntoReturning(): boolean;
     /**
+     * Runs table exists.
      * @param {string} tableName - Table name.
      * @returns {Promise<boolean>} - Resolves with Whether table exists.
      */
     tableExists(tableName: string): Promise<boolean>;
     /**
+     * Runs transaction.
      * @param {() => Promise<void>} callback - Callback function.
-     * @returns {Promise<any>} - Resolves with the transaction.
+     * @returns {Promise<?>} - Resolves with the transaction.
      */
-    transaction(callback: () => Promise<void>): Promise<any>;
+    transaction(callback: () => Promise<void>): Promise<unknown>;
     /**
      * Runs a callback after the surrounding transaction commits.
      * If no transaction is active, the callback runs immediately.
@@ -330,18 +390,22 @@ export default class VelociousDatabaseDriversBase {
      */
     afterCommit(callback: () => void | Promise<void>): Promise<void>;
     /**
+     * Runs start transaction.
      * @returns {Promise<void>} - Resolves when complete.
      */
     startTransaction(): Promise<void>;
     /**
+     * Runs start transaction action.
      * @returns {Promise<void>} - Resolves when complete.
      */
     _startTransactionAction(): Promise<void>;
     /**
+     * Runs commit transaction.
      * @returns {Promise<void>} - Resolves when complete.
      */
     commitTransaction(): Promise<void>;
     /**
+     * Runs commit transaction action.
      * @returns {Promise<void>} - Resolves when complete.
      */
     _commitTransactionAction(): Promise<void>;
@@ -351,12 +415,14 @@ export default class VelociousDatabaseDriversBase {
      */
     _commitAfterCommitCallbackFrame(): Promise<void>;
     /**
+     * Runs query.
      * @param {string} sql - SQL string.
      * @param {QueryOptions} [options] - Query options.
      * @returns {Promise<QueryResultType>} - Resolves with the query.
      */
     query(sql: string, options?: QueryOptions): Promise<QueryResultType>;
     /**
+     * Runs query actual with logging.
      * @param {object} args - Options object.
      * @param {string} args.originalSql - Original SQL string before process-list comments.
      * @param {string} args.querySql - SQL string sent to the database.
@@ -369,34 +435,43 @@ export default class VelociousDatabaseDriversBase {
         originalSql: string;
         querySql: string;
     }, options: QueryOptions, requestTiming: import("../../http-server/client/request-timing.js").default | undefined, tries: number): Promise<QueryResultType>;
-    /** @returns {DatabaseConnectionDebugSnapshot} - Diagnostic snapshot for this connection. */
+    /**
+     * Runs get debug snapshot.
+     * @returns {DatabaseConnectionDebugSnapshot} - Diagnostic snapshot for this connection.
+     */
     getDebugSnapshot(): DatabaseConnectionDebugSnapshot;
     /**
+     * Runs debug sql preview.
      * @param {string} sql - SQL to preview.
      * @returns {string} - Normalized truncated SQL preview for diagnostics.
      */
     _debugSqlPreview(sql: string): string;
     /**
+     * Runs query sql with process list comment.
      * @param {string} sql - SQL string.
      * @param {QueryOptions} options - Query options.
      * @returns {string} - SQL string with a leading process-list comment when annotations exist.
      */
     _querySqlWithProcessListComment(sql: string, options: QueryOptions): string;
     /**
+     * Runs process list comment value.
      * @param {string} value - Raw process-list comment value.
      * @returns {string} - Sanitized process-list comment value.
      */
     _processListCommentValue(value: string): string;
     /**
+     * Runs schema cache invalidating sql.
      * @param {string} sql - SQL string.
      * @returns {boolean} - Whether the SQL should invalidate schema metadata.
      */
     _schemaCacheInvalidatingSql(sql: string): boolean;
     /**
+     * Runs query logging enabled.
      * @returns {boolean} - Whether query logging is enabled for this driver.
      */
     _queryLoggingEnabled(): boolean;
     /**
+     * Runs log query.
      * @param {object} args - Options object.
      * @param {number} args.elapsedMs - Elapsed milliseconds.
      * @param {string} args.logName - Query log subject.
@@ -411,66 +486,82 @@ export default class VelociousDatabaseDriversBase {
         sql: string;
     }): Promise<void>;
     /**
+     * Runs query source line.
      * @param {string | undefined} sourceStack - Source stack.
      * @returns {string | undefined} - Source line when an application frame is available.
      */
     _querySourceLine(sourceStack: string | undefined): string | undefined;
     /**
+     * Runs query actual.
      * @abstract
      * @param {string} sql - SQL string.
      * @returns {Promise<QueryResultType>} - Resolves with the query actual.
      */
     _queryActual(sql: string): Promise<QueryResultType>;
     /**
+     * Runs query to sql.
      * @abstract
      * @param {Query} _query - Query instance.
      * @returns {string} - SQL string.
      */
     queryToSql(_query: Query): string;
     /**
+     * Runs retryable database error.
      * @param {Error} _error - Error instance.
      * @returns {RetryableDatabaseErrorResult} - Retry info.
      */
     retryableDatabaseError(_error: Error): RetryableDatabaseErrorResult;
     /**
+     * Runs assert writable query.
      * @param {string} sql - SQL string.
      * @returns {void} - No return value.
      */
     _assertWritableQuery(sql: string): void;
     /**
+     * Runs assert not read only.
      * @returns {void} - No return value.
      */
     _assertNotReadOnly(): void;
     /**
+     * Runs sql looks like write.
      * @param {string} sql - SQL string.
      * @returns {boolean} - SQL representation.
      */
     _sqlLooksLikeWrite(sql: string): boolean;
-    /** @returns {boolean} - Whether read only.  */
+    /**
+     * Runs is read only.
+     * @returns {boolean} - Whether read only.
+     */
     isReadOnly(): boolean;
     /**
+     * Runs rollback transaction.
      * @returns {Promise<void>} - Resolves when complete.
      */
     rollbackTransaction(): Promise<void>;
     /**
+     * Runs rollback transaction action.
      * @returns {Promise<void>} - Resolves when complete.
      */
     _rollbackTransactionAction(): Promise<void>;
     /**
+     * Runs generate save point name.
      * @returns {string} - The generate save point name.
      */
     generateSavePointName(): string;
     /**
+     * Runs start save point.
      * @param {string} savePointName - Save point name.
      * @returns {Promise<void>} - Resolves when complete.
      */
     startSavePoint(savePointName: string): Promise<void>;
     /**
+     * Runs start save point action.
      * @param {string} savePointName - Save point name.
      * @returns {Promise<void>} - Resolves when complete.
      */
     _startSavePointAction(savePointName: string): Promise<void>;
     /**
+     * Runs rename column.
      * @param {string} tableName - Table name.
      * @param {string} oldColumnName - Previous column name.
      * @param {string} newColumnName - New column name.
@@ -478,68 +569,78 @@ export default class VelociousDatabaseDriversBase {
      */
     renameColumn(tableName: string, oldColumnName: string, newColumnName: string): Promise<void>;
     /**
+     * Runs release save point.
      * @param {string} savePointName - Save point name.
      * @returns {Promise<void>} - Resolves when complete.
      */
     releaseSavePoint(savePointName: string): Promise<void>;
     /**
+     * Runs release save point action.
      * @param {string} savePointName - Save point name.
      * @returns {Promise<void>} - Resolves when complete.
      */
     _releaseSavePointAction(savePointName: string): Promise<void>;
     /**
+     * Runs rollback save point.
      * @param {string} savePointName - Save point name.
      * @returns {Promise<void>} - Resolves when complete.
      */
     rollbackSavePoint(savePointName: string): Promise<void>;
     /**
+     * Runs rollback save point action.
      * @param {string} savePointName - Save point name.
      * @returns {Promise<void>} - Resolves when complete.
      */
     _rollbackSavePointAction(savePointName: string): Promise<void>;
     /**
+     * Runs truncate all tables.
      * @returns {Promise<void>} - Resolves when complete.
      */
     truncateAllTables(): Promise<void>;
     /**
+     * Runs update.
      * @param {UpdateSqlArgsType} args - Options object.
      * @returns {Promise<void>} - Resolves when complete.
      */
     update(args: UpdateSqlArgsType): Promise<void>;
     /**
+     * Runs update sql.
      * @abstract
      * @param {UpdateSqlArgsType} args - Options object.
      * @returns {string} - SQL string.
      */
     updateSql(args: UpdateSqlArgsType): string;
     /**
+     * Runs upsert sql.
      * @abstract
      * @param {UpsertSqlArgsType} args - Options object.
      * @returns {string} - SQL string.
      */
     upsertSql(args: UpsertSqlArgsType): string;
     /**
+     * Runs disable foreign keys.
      * @abstract
      * @returns {Promise<void>} - Resolves when complete.
      */
     disableForeignKeys(): Promise<void>;
     /**
+     * Runs enable foreign keys.
      * @abstract
      * @returns {Promise<void>} - Resolves when complete.
      */
     enableForeignKeys(): Promise<void>;
     /**
+     * Runs with disabled foreign keys.
      * @param {function() : void} callback - Callback function.
-     * @returns {Promise<any>} - Resolves with the with disabled foreign keys.
+     * @returns {Promise<?>} - Resolves with the with disabled foreign keys.
      */
-    withDisabledForeignKeys(callback: () => void): Promise<any>;
+    withDisabledForeignKeys(callback: () => void): Promise<unknown>;
     /**
      * Blocks until a named advisory lock is acquired on this connection.
      * Advisory locks are connection-scoped and do not interact with row or
      * table locks; they are purely cooperative between callers that use the
      * same name and let you serialize functionality without blocking readers
      * or writers that do not participate in the same lock.
-     *
      * @abstract
      * @param {string} name - Lock name.
      * @param {{timeoutMs?: number | null}} [_args] - Optional timeout in milliseconds; `null` or undefined blocks forever.
@@ -550,7 +651,6 @@ export default class VelociousDatabaseDriversBase {
     }): Promise<boolean>;
     /**
      * Attempts to acquire a named advisory lock without blocking.
-     *
      * @abstract
      * @param {string} name - Lock name.
      * @returns {Promise<boolean>} - Resolves to true if the lock was acquired, false if it was already held.
@@ -558,7 +658,6 @@ export default class VelociousDatabaseDriversBase {
     tryAcquireAdvisoryLock(name: string): Promise<boolean>;
     /**
      * Releases a named advisory lock previously acquired on this connection.
-     *
      * @abstract
      * @param {string} name - Lock name.
      * @returns {Promise<boolean>} - Resolves to true if the lock was held by this session and has now been released.
@@ -568,13 +667,15 @@ export default class VelociousDatabaseDriversBase {
      * Checks whether a named advisory lock is currently held by any session.
      * Intended as an introspection helper; callers who need to act on the
      * result should prefer `tryAcquireAdvisoryLock` to avoid a TOCTOU race.
-     *
      * @abstract
      * @param {string} name - Lock name.
-     * @returns {Promise<boolean>} - Resolves to true if the lock is held by any session.
+     * @returns {Promise<boolean>} - Resolves to true if the lock is held by ? session.
      */
     isAdvisoryLockHeld(name: string): Promise<boolean>;
 }
+/**
+ * CreateIndexSqlArgs type.
+ */
 export type CreateIndexSqlArgs = {
     /**
      * - Columns to include in the index.
@@ -597,6 +698,9 @@ export type CreateIndexSqlArgs = {
      */
     tableName: string;
 };
+/**
+ * DropTableSqlArgsType type.
+ */
 export type DropTableSqlArgsType = {
     /**
      * - Whether dependent objects should be dropped too.
@@ -607,6 +711,9 @@ export type DropTableSqlArgsType = {
      */
     ifExists?: boolean | undefined;
 };
+/**
+ * DeleteSqlArgsType type.
+ */
 export type DeleteSqlArgsType = {
     /**
      * - Table name to delete from.
@@ -616,9 +723,12 @@ export type DeleteSqlArgsType = {
      * - Conditions used to build the delete WHERE clause.
      */
     conditions: {
-        [key: string]: any;
+        [key: string]: unknown;
     };
 };
+/**
+ * InsertSqlArgsType type.
+ */
 export type InsertSqlArgsType = {
     /**
      * - Column names for `rows` inserts.
@@ -647,8 +757,17 @@ export type InsertSqlArgsType = {
      */
     tableName: string;
 };
-export type QueryRowType = Record<string, any>;
+/**
+ * QueryRowType type.
+ */
+export type QueryRowType = Record<string, unknown>;
+/**
+ * QueryRowType type.
+ */
 export type QueryResultType = Array<QueryRowType>;
+/**
+ * RetryableDatabaseErrorResult type.
+ */
 export type RetryableDatabaseErrorResult = {
     /**
      * - Whether the error should be retried.
@@ -667,6 +786,9 @@ export type RetryableDatabaseErrorResult = {
      */
     waitMs?: number | undefined;
 };
+/**
+ * QueryOptions type.
+ */
 export type QueryOptions = {
     /**
      * - Query log subject.
@@ -685,6 +807,9 @@ export type QueryOptions = {
      */
     sourceStack?: string | undefined;
 };
+/**
+ * ActiveQueryDebugSnapshot type.
+ */
 export type ActiveQueryDebugSnapshot = {
     /**
      * - Database annotations active when the query started.
@@ -707,6 +832,9 @@ export type ActiveQueryDebugSnapshot = {
      */
     sqlPreview: string;
 };
+/**
+ * DatabaseConnectionDebugSnapshot type.
+ */
 export type DatabaseConnectionDebugSnapshot = {
     /**
      * - Currently running query, if any.
@@ -741,6 +869,9 @@ export type DatabaseConnectionDebugSnapshot = {
      */
     schemaCacheEntries: number;
 };
+/**
+ * ActiveQueryState type.
+ */
 export type ActiveQueryState = {
     /**
      * - Database annotations active when the query started.
@@ -759,6 +890,9 @@ export type ActiveQueryState = {
      */
     sqlPreview: string;
 };
+/**
+ * UpdateSqlArgsType type.
+ */
 export type UpdateSqlArgsType = {
     /**
      * - Conditions used to build the update WHERE clause.
@@ -773,6 +907,9 @@ export type UpdateSqlArgsType = {
      */
     tableName: string;
 };
+/**
+ * UpsertSqlArgsType type.
+ */
 export type UpsertSqlArgsType = {
     /**
      * - Columns that define a conflict.