hysteria-orm 11.0.4 → 11.0.5

package/lib/index.d.cts

@@ -695,7 +695,7 @@ interface SqliteDataSourceInput extends CommonDataSourceInput {
      * @description The filename of the database file for SQLite
      * @default ":memory:"
      */
-    readonly database?: ":memory:" | (string & {});
+    readonly database?: ":memory:" | "file::memory:?cache=shared" | (string & {});
 }
 interface NotNullableSqliteDataSourceInput extends SqliteDataSourceInput {
     readonly type?: "sqlite";
@@ -735,6 +735,26 @@ type ConnectionPolicies = {
  * and programmatic models created via `defineModel`.
  */
 type SqlDataSourceModel = AnyModelConstructor;
+/**
+ * @description Migration lock configuration
+ */
+type MigrationLockConfig = {
+    /**
+     * @description Enable/disable migration locking
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * @description Lock timeout in milliseconds for migration advisory lock acquisition
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * @description Custom lock key value - can be string, number, or function returning string|number
+     * @default "hysteria_migration_lock"
+     */
+    customValue?: string | number | (() => string | number);
+};
 /**
  * @description Base migration configuration options available for all databases
  */
@@ -750,12 +770,13 @@ type MigrationConfigBase = {
      */
     tsconfig?: string;
     /**
-     * @description Acquire advisory lock before running migrations to prevent concurrent execution, can be overridden in the cli command
+     * @description Migration lock configuration - can be boolean to enable/disable, or an object for advanced options
      * @default true
      */
-    lock?: boolean;
+    lock?: boolean | MigrationLockConfig;
     /**
-     * @description Lock timeout in milliseconds for migration advisory lock acquisition, can be overridden in the cli command
+     * @deprecated Use lock.timeout instead. Kept for backward compatibility.
+     * @description Lock timeout in milliseconds for migration advisory lock acquisition
      * @default 30000
      */
     lockTimeout?: number;
@@ -801,6 +822,13 @@ type SqlDataSourceInputBase<T extends Record<string, SqlDataSourceModel> = {}, C
      * @default false
      */
     readonly logs?: boolean | LoggerConfig;
+    /**
+     * @description Enable AsyncLocalStorage (CLS) for automatic transaction propagation.
+     * When enabled, queries inside `sql.transaction(callback)` automatically use the active
+     * transaction without explicit passing.
+     * @default true
+     */
+    readonly clsEnabled?: boolean;
     /**
      * @description The connection policies to use for the sql data source that are not configured in the driverOptions
      */
@@ -1803,6 +1831,93 @@ declare class SchemaBuilder implements PromiseLike<void> {
      * @description Returns true if the builder execution failed
      */
     hasFailed(): boolean;
+    /**
+     * @description Checks if a table exists in the database
+     * @param tableName - The name of the table to check
+     * @returns Promise<boolean> - true if table exists, false otherwise
+     */
+    hasTable(tableName: string): Promise<boolean>;
+    /**
+     * @description Checks if a column exists in a table
+     * @param tableName - The name of the table
+     * @param columnName - The name of the column to check
+     * @returns Promise<boolean> - true if column exists in table, false otherwise
+     */
+    hasColumn(tableName: string, columnName: string): Promise<boolean>;
+    /**
+     * @description Checks if multiple columns exist in a table
+     * @param tableName - The name of the table
+     * @param columnNames - Array of column names to check
+     * @returns Promise<boolean> - true if all columns exist in table, false otherwise
+     */
+    hasColumns(tableName: string, ...columnNames: string[]): Promise<boolean>;
+    /**
+     * @description Checks if an index exists on a table
+     * @param tableName - The name of the table
+     * @param indexName - The name of the index to check
+     * @returns Promise<boolean> - true if index exists on table, false otherwise
+     */
+    hasIndex(tableName: string, indexName: string): Promise<boolean>;
+    /**
+     * @description Checks if a table has a primary key
+     * @param tableName - The name of the table
+     * @returns Promise<boolean> - true if table has primary key, false otherwise
+     */
+    hasPrimaryKey(tableName: string): Promise<boolean>;
+    /**
+     * @description Checks if a unique constraint exists on a table for given columns
+     * @param tableName - The name of the table
+     * @param columns - Array of column names (or single string) that form the unique constraint
+     * @returns Promise<boolean> - true if unique constraint exists, false otherwise
+     */
+    hasUnique(tableName: string, columns: string[] | string): Promise<boolean>;
+    /**
+     * @description Checks if a foreign key constraint exists on a table for given columns
+     * @param tableName - The name of the table
+     * @param columns - Array of column names that form the foreign key
+     * @returns Promise<boolean> - true if foreign key exists, false otherwise
+     */
+    hasForeignKey(tableName: string, columns: string[]): Promise<boolean>;
+    /**
+     * @description Checks if a check constraint exists on a table
+     * @param tableName - The name of the table
+     * @param constraintName - The name of the check constraint to check
+     * @returns Promise<boolean> - true if check constraint exists, false otherwise
+     */
+    hasCheckConstraint(tableName: string, constraintName: string): Promise<boolean>;
+    /**
+     * @description Gets all table names in the database
+     * @returns Promise<string[]> - Array of table names
+     */
+    getTables(): Promise<string[]>;
+    /**
+     * @description Gets all column names for a table
+     * @param tableName - The name of the table
+     * @returns Promise<string[]> - Array of column names
+     */
+    getColumnListing(tableName: string): Promise<string[]>;
+    /**
+     * @description Drops a table if it exists
+     * @param table - The name of the table to drop
+     * @returns this for chaining
+     */
+    dropTableIfExists(table: string): this;
+    /**
+     * @description Drops an index if it exists
+     * @param indexName - The name of the index
+     * @param table - Table name (required for existence check)
+     * @returns Promise<void> - executes immediately, not chainable
+     * @mysql requires table name for existence check
+     */
+    dropIndexIfExists(indexName: string, table: string): Promise<void>;
+    /**
+     * @description Renames a column in a table
+     * @param tableName - The name of the table
+     * @param oldName - The current column name
+     * @param newName - The new column name
+     * @returns this for chaining
+     */
+    renameColumn(tableName: string, oldName: string, newName: string): this;
 }
 
 interface IntrospectedColumn {
@@ -4791,6 +4906,15 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Options provided in the sql data source initialization
      */
     inputDetails: SqlDataSourceInput<D, T, C>;
+    /**
+     * @description Unique identifier shared across all clones of the same logical data source.
+     * Used to verify ALS transactions belong to this instance.
+     */
+    id: string;
+    /**
+     * @description Whether AsyncLocalStorage (CLS) transaction auto-propagation is enabled.
+     */
+    private readonly clsEnabled;
     /**
      * @description Adapter for `useCache`, uses an in memory strategy by default
      */
@@ -4805,7 +4929,7 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
     migrationConfig: {
         path: string;
         tsconfig?: string;
-        lock: boolean;
+        lock: boolean | MigrationLockConfig;
         transactional: boolean;
         lockTimeout?: number;
     };
@@ -4925,6 +5049,11 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @returns A slave SqlDataSource instance or null if no slaves are available
      */
     getSlave(): SqlDataSource<D, T, C> | null;
+    /**
+     * @description Returns the SqlDataSource that should execute the next query,
+     * respecting (in order): explicit global transaction, ALS transaction, then self.
+     */
+    getTransactionBoundSqlDataSource(): SqlDataSource | null;
     /**
      * @description Uses the cache adapter to get a value from the cache
      * @param key The key to get the value from
@@ -5027,6 +5156,9 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @param cb if a callback is provided, it will execute the callback and commit or rollback the transaction based on the callback's success or failure
      * @param options.isolationLevel The isolation level to use for the transaction
      * @sqlite ignores the isolation level
+     * @warning SQLite `:memory:` databases use `file::memory:?cache=shared`
+     * to allow transaction connections to share the same in-memory database.
+     * Without shared cache each connection would see an empty fresh database.
      */
     transaction(options?: StartTransactionOptions): Promise<Transaction>;
     transaction<T>(cb: (trx: Transaction) => Promise<T>, options?: StartTransactionOptions): Promise<T>;
@@ -5135,6 +5267,71 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Introspects table columns metadata
      */
     getTableInfo(table: string): Promise<TableColumnInfo[]>;
+    /**
+     * @description Checks if a table exists in the database
+     * @param tableName - The name of the table to check
+     * @returns Promise<boolean> - true if table exists, false otherwise
+     */
+    hasTable(tableName: string): Promise<boolean>;
+    /**
+     * @description Checks if a column exists in a table
+     * @param tableName - The name of the table
+     * @param columnName - The name of the column to check
+     * @returns Promise<boolean> - true if column exists in table, false otherwise
+     */
+    hasColumn(tableName: string, columnName: string): Promise<boolean>;
+    /**
+     * @description Checks if multiple columns exist in a table
+     * @param tableName - The name of the table
+     * @param columnNames - Array of column names to check
+     * @returns Promise<boolean> - true if all columns exist in table, false otherwise
+     */
+    hasColumns(tableName: string, ...columnNames: string[]): Promise<boolean>;
+    /**
+     * @description Checks if an index exists on a table
+     * @param tableName - The name of the table
+     * @param indexName - The name of the index to check
+     * @returns Promise<boolean> - true if index exists on table, false otherwise
+     */
+    hasIndex(tableName: string, indexName: string): Promise<boolean>;
+    /**
+     * @description Checks if a table has a primary key
+     * @param tableName - The name of the table
+     * @returns Promise<boolean> - true if table has primary key, false otherwise
+     */
+    hasPrimaryKey(tableName: string): Promise<boolean>;
+    /**
+     * @description Checks if a unique constraint exists on a table for given columns
+     * @param tableName - The name of the table
+     * @param columns - Array of column names (or single string) that form the unique constraint
+     * @returns Promise<boolean> - true if unique constraint exists, false otherwise
+     */
+    hasUnique(tableName: string, columns: string[] | string): Promise<boolean>;
+    /**
+     * @description Checks if a foreign key constraint exists on a table for given columns
+     * @param tableName - The name of the table
+     * @param columns - Array of column names that form the foreign key
+     * @returns Promise<boolean> - true if foreign key exists, false otherwise
+     */
+    hasForeignKey(tableName: string, columns: string[]): Promise<boolean>;
+    /**
+     * @description Checks if a check constraint exists on a table
+     * @param tableName - The name of the table
+     * @param constraintName - The name of the check constraint to check
+     * @returns Promise<boolean> - true if check constraint exists, false otherwise
+     */
+    hasCheckConstraint(tableName: string, constraintName: string): Promise<boolean>;
+    /**
+     * @description Gets all table names in the database
+     * @returns Promise<string[]> - Array of table names
+     */
+    getTables(): Promise<string[]>;
+    /**
+     * @description Gets all column names for a table
+     * @param tableName - The name of the table
+     * @returns Promise<string[]> - Array of column names
+     */
+    getColumnListing(tableName: string): Promise<string[]>;
     /**
      * @description Introspects table indexes metadata
      */
@@ -8143,4 +8340,4 @@ declare const generateOpenApiModelWithMetadata: <T extends new () => Model>(mode
     $id?: string;
 }>;
 
-export { type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnyModelConstructor, type BaseModelMethodOptions, BaseSeeder, type BuildSelectType, type BuildSingleSelectType, type CacheAdapter, type CacheKeys, ClientMigrator, type ColCharOptions, type ColJsonbOptions, type ColMediumIntOptions, type ColSmallIntOptions, type ColTinyIntOptions, type ColVarbinaryOptions, Collection, type CollectionDefinition, type ColumnDef, type CommonDataSourceInput, type ComposeBuildSelect, type ComposeSelect, type ConnectionPolicies, type CreateSchemaResult, type CustomLogger, type DataSourceInput, type DataSourceType, type DateAutoHook, type DefinedCollection, type DefinedModel, type DefinedView, type ExcludeMethods, type ExtractColumnName, type ExtractSourceColumn, type FetchHooks, type FindReturnType, type GetColumnType, type GetConnectionReturnType, HysteriaError, InMemoryAdapter, type InferPK, type IntrospectedColumn, type IntrospectedForeignKey, type IntrospectedSchema, type IntrospectedTable, type JsonPathInput, type JsonPaths, type LoadOptions, type LoggerConfig, type ManyOptions, Migration, type MigrationConfig, type MigrationConfigBase, type ModelColumns, type ModelDataProperties, type ModelInstanceType, type ModelKey, ModelQueryBuilder, type ModelQueryResult, type ModelRelation, type ModelSelectTuple, type ModelSelectableInput, type ModelWithoutRelations, type ModelsProxy, MongoDataSource, type MongoDataSourceInput$1 as MongoDataSourceInput, type MssqlConnectionInstance, type MssqlDataSourceInput, type MssqlPoolInstance, type MutationReturningResult, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullableOracleDBDataSourceInput, type NotNullableOracleMssqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NullableColumn, type NumberModelKey, ObserverChain, ObserverChainWrapper, type OneOptions, type Operation, type OracleDBDataSourceInput, type OracleDBPoolInstance, type PgPoolClientInstance, type PingResult, type PostgresSqlDataSourceInput, type PrimaryColumnDef, type PropNamespace, type PropertyDef, QueryBuilder, type QueryContext, type QueryContextWithDuration, type QueryObserver, type RawModelKey, type RawModelOptions, RawNode, type RawQueryOptions, RedisCacheAdapter, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationDef, type RelationDefinitions, type RelationHelpers, type RelationLoadStrategy, type RelationQueryBuilderType, type ReplicationType, type ResolveColumnType, type ResolveJsonPathType, type ReturningColumns, type ReturningKey, type ReturningParam, type ReturningResult, type ReturningResultMany, type ReturningSupported, Schema, SchemaBuilder, type SchemaLookup, type SchemaRelDef, type SeederConfig, type SelectBrand, type SelectableColumn, type SelectedModel, type SlaveAlgorithm, type SlaveContext, type SqlCloneOptions, SqlDataSource, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDriverSpecificOptions, type SqlPoolType, type Sqlite3ConnectionOptions, type SqliteConnectionInstance, type SqliteDataSourceInput, type StartTransactionOptions, type StripTablePrefix, type SubQueryable, type TableFormat, Transaction, type TransactionExecutionOptions, type TypedDefault, type TypedJsonPathInput, type TypedPrepare, type TypedSerialize, type UseCacheReturnType, type UseConnectionInput, type ValidationContext, ValidationError, type ValidationResult, type Validator, type ViewDefinition, WriteOperation, type WriteReturnType, col, createSchema, defineCollection, defineMigrator, defineModel, defineModelFactory, defineRelations, defineView, deriveOperationFromQuery, email, enumValidator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, type getPoolReturnType, HysteriaLogger as logger, max, maxLength, min, minLength, pattern, prop, RedisDataSource as redis, required, url };
+export { type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnyModelConstructor, type BaseModelMethodOptions, BaseSeeder, type BuildSelectType, type BuildSingleSelectType, type CacheAdapter, type CacheKeys, ClientMigrator, type ColCharOptions, type ColJsonbOptions, type ColMediumIntOptions, type ColSmallIntOptions, type ColTinyIntOptions, type ColVarbinaryOptions, Collection, type CollectionDefinition, type ColumnDef, type CommonDataSourceInput, type ComposeBuildSelect, type ComposeSelect, type ConnectionPolicies, type CreateSchemaResult, type CustomLogger, type DataSourceInput, type DataSourceType, type DateAutoHook, type DefinedCollection, type DefinedModel, type DefinedView, type ExcludeMethods, type ExtractColumnName, type ExtractSourceColumn, type FetchHooks, type FindReturnType, type GetColumnType, type GetConnectionReturnType, HysteriaError, InMemoryAdapter, type InferPK, type IntrospectedColumn, type IntrospectedForeignKey, type IntrospectedSchema, type IntrospectedTable, type JsonPathInput, type JsonPaths, type LoadOptions, type LoggerConfig, type ManyOptions, Migration, type MigrationConfig, type MigrationConfigBase, type MigrationLockConfig, type ModelColumns, type ModelDataProperties, type ModelInstanceType, type ModelKey, ModelQueryBuilder, type ModelQueryResult, type ModelRelation, type ModelSelectTuple, type ModelSelectableInput, type ModelWithoutRelations, type ModelsProxy, MongoDataSource, type MongoDataSourceInput$1 as MongoDataSourceInput, type MssqlConnectionInstance, type MssqlDataSourceInput, type MssqlPoolInstance, type MutationReturningResult, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullableOracleDBDataSourceInput, type NotNullableOracleMssqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NullableColumn, type NumberModelKey, ObserverChain, ObserverChainWrapper, type OneOptions, type Operation, type OracleDBDataSourceInput, type OracleDBPoolInstance, type PgPoolClientInstance, type PingResult, type PostgresSqlDataSourceInput, type PrimaryColumnDef, type PropNamespace, type PropertyDef, QueryBuilder, type QueryContext, type QueryContextWithDuration, type QueryObserver, type RawModelKey, type RawModelOptions, RawNode, type RawQueryOptions, RedisCacheAdapter, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationDef, type RelationDefinitions, type RelationHelpers, type RelationLoadStrategy, type RelationQueryBuilderType, type ReplicationType, type ResolveColumnType, type ResolveJsonPathType, type ReturningColumns, type ReturningKey, type ReturningParam, type ReturningResult, type ReturningResultMany, type ReturningSupported, Schema, SchemaBuilder, type SchemaLookup, type SchemaRelDef, type SeederConfig, type SelectBrand, type SelectableColumn, type SelectedModel, type SlaveAlgorithm, type SlaveContext, type SqlCloneOptions, SqlDataSource, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDriverSpecificOptions, type SqlPoolType, type Sqlite3ConnectionOptions, type SqliteConnectionInstance, type SqliteDataSourceInput, type StartTransactionOptions, type StripTablePrefix, type SubQueryable, type TableFormat, Transaction, type TransactionExecutionOptions, type TypedDefault, type TypedJsonPathInput, type TypedPrepare, type TypedSerialize, type UseCacheReturnType, type UseConnectionInput, type ValidationContext, ValidationError, type ValidationResult, type Validator, type ViewDefinition, WriteOperation, type WriteReturnType, col, createSchema, defineCollection, defineMigrator, defineModel, defineModelFactory, defineRelations, defineView, deriveOperationFromQuery, email, enumValidator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, type getPoolReturnType, HysteriaLogger as logger, max, maxLength, min, minLength, pattern, prop, RedisDataSource as redis, required, url };

package/lib/index.d.ts

@@ -695,7 +695,7 @@ interface SqliteDataSourceInput extends CommonDataSourceInput {
      * @description The filename of the database file for SQLite
      * @default ":memory:"
      */
-    readonly database?: ":memory:" | (string & {});
+    readonly database?: ":memory:" | "file::memory:?cache=shared" | (string & {});
 }
 interface NotNullableSqliteDataSourceInput extends SqliteDataSourceInput {
     readonly type?: "sqlite";
@@ -735,6 +735,26 @@ type ConnectionPolicies = {
  * and programmatic models created via `defineModel`.
  */
 type SqlDataSourceModel = AnyModelConstructor;
+/**
+ * @description Migration lock configuration
+ */
+type MigrationLockConfig = {
+    /**
+     * @description Enable/disable migration locking
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * @description Lock timeout in milliseconds for migration advisory lock acquisition
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * @description Custom lock key value - can be string, number, or function returning string|number
+     * @default "hysteria_migration_lock"
+     */
+    customValue?: string | number | (() => string | number);
+};
 /**
  * @description Base migration configuration options available for all databases
  */
@@ -750,12 +770,13 @@ type MigrationConfigBase = {
      */
     tsconfig?: string;
     /**
-     * @description Acquire advisory lock before running migrations to prevent concurrent execution, can be overridden in the cli command
+     * @description Migration lock configuration - can be boolean to enable/disable, or an object for advanced options
      * @default true
      */
-    lock?: boolean;
+    lock?: boolean | MigrationLockConfig;
     /**
-     * @description Lock timeout in milliseconds for migration advisory lock acquisition, can be overridden in the cli command
+     * @deprecated Use lock.timeout instead. Kept for backward compatibility.
+     * @description Lock timeout in milliseconds for migration advisory lock acquisition
      * @default 30000
      */
     lockTimeout?: number;
@@ -801,6 +822,13 @@ type SqlDataSourceInputBase<T extends Record<string, SqlDataSourceModel> = {}, C
      * @default false
      */
     readonly logs?: boolean | LoggerConfig;
+    /**
+     * @description Enable AsyncLocalStorage (CLS) for automatic transaction propagation.
+     * When enabled, queries inside `sql.transaction(callback)` automatically use the active
+     * transaction without explicit passing.
+     * @default true
+     */
+    readonly clsEnabled?: boolean;
     /**
      * @description The connection policies to use for the sql data source that are not configured in the driverOptions
      */
@@ -1803,6 +1831,93 @@ declare class SchemaBuilder implements PromiseLike<void> {
      * @description Returns true if the builder execution failed
      */
     hasFailed(): boolean;
+    /**
+     * @description Checks if a table exists in the database
+     * @param tableName - The name of the table to check
+     * @returns Promise<boolean> - true if table exists, false otherwise
+     */
+    hasTable(tableName: string): Promise<boolean>;
+    /**
+     * @description Checks if a column exists in a table
+     * @param tableName - The name of the table
+     * @param columnName - The name of the column to check
+     * @returns Promise<boolean> - true if column exists in table, false otherwise
+     */
+    hasColumn(tableName: string, columnName: string): Promise<boolean>;
+    /**
+     * @description Checks if multiple columns exist in a table
+     * @param tableName - The name of the table
+     * @param columnNames - Array of column names to check
+     * @returns Promise<boolean> - true if all columns exist in table, false otherwise
+     */
+    hasColumns(tableName: string, ...columnNames: string[]): Promise<boolean>;
+    /**
+     * @description Checks if an index exists on a table
+     * @param tableName - The name of the table
+     * @param indexName - The name of the index to check
+     * @returns Promise<boolean> - true if index exists on table, false otherwise
+     */
+    hasIndex(tableName: string, indexName: string): Promise<boolean>;
+    /**
+     * @description Checks if a table has a primary key
+     * @param tableName - The name of the table
+     * @returns Promise<boolean> - true if table has primary key, false otherwise
+     */
+    hasPrimaryKey(tableName: string): Promise<boolean>;
+    /**
+     * @description Checks if a unique constraint exists on a table for given columns
+     * @param tableName - The name of the table
+     * @param columns - Array of column names (or single string) that form the unique constraint
+     * @returns Promise<boolean> - true if unique constraint exists, false otherwise
+     */
+    hasUnique(tableName: string, columns: string[] | string): Promise<boolean>;
+    /**
+     * @description Checks if a foreign key constraint exists on a table for given columns
+     * @param tableName - The name of the table
+     * @param columns - Array of column names that form the foreign key
+     * @returns Promise<boolean> - true if foreign key exists, false otherwise
+     */
+    hasForeignKey(tableName: string, columns: string[]): Promise<boolean>;
+    /**
+     * @description Checks if a check constraint exists on a table
+     * @param tableName - The name of the table
+     * @param constraintName - The name of the check constraint to check
+     * @returns Promise<boolean> - true if check constraint exists, false otherwise
+     */
+    hasCheckConstraint(tableName: string, constraintName: string): Promise<boolean>;
+    /**
+     * @description Gets all table names in the database
+     * @returns Promise<string[]> - Array of table names
+     */
+    getTables(): Promise<string[]>;
+    /**
+     * @description Gets all column names for a table
+     * @param tableName - The name of the table
+     * @returns Promise<string[]> - Array of column names
+     */
+    getColumnListing(tableName: string): Promise<string[]>;
+    /**
+     * @description Drops a table if it exists
+     * @param table - The name of the table to drop
+     * @returns this for chaining
+     */
+    dropTableIfExists(table: string): this;
+    /**
+     * @description Drops an index if it exists
+     * @param indexName - The name of the index
+     * @param table - Table name (required for existence check)
+     * @returns Promise<void> - executes immediately, not chainable
+     * @mysql requires table name for existence check
+     */
+    dropIndexIfExists(indexName: string, table: string): Promise<void>;
+    /**
+     * @description Renames a column in a table
+     * @param tableName - The name of the table
+     * @param oldName - The current column name
+     * @param newName - The new column name
+     * @returns this for chaining
+     */
+    renameColumn(tableName: string, oldName: string, newName: string): this;
 }
 
 interface IntrospectedColumn {
@@ -4791,6 +4906,15 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Options provided in the sql data source initialization
      */
     inputDetails: SqlDataSourceInput<D, T, C>;
+    /**
+     * @description Unique identifier shared across all clones of the same logical data source.
+     * Used to verify ALS transactions belong to this instance.
+     */
+    id: string;
+    /**
+     * @description Whether AsyncLocalStorage (CLS) transaction auto-propagation is enabled.
+     */
+    private readonly clsEnabled;
     /**
      * @description Adapter for `useCache`, uses an in memory strategy by default
      */
@@ -4805,7 +4929,7 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
     migrationConfig: {
         path: string;
         tsconfig?: string;
-        lock: boolean;
+        lock: boolean | MigrationLockConfig;
         transactional: boolean;
         lockTimeout?: number;
     };
@@ -4925,6 +5049,11 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @returns A slave SqlDataSource instance or null if no slaves are available
      */
     getSlave(): SqlDataSource<D, T, C> | null;
+    /**
+     * @description Returns the SqlDataSource that should execute the next query,
+     * respecting (in order): explicit global transaction, ALS transaction, then self.
+     */
+    getTransactionBoundSqlDataSource(): SqlDataSource | null;
     /**
      * @description Uses the cache adapter to get a value from the cache
      * @param key The key to get the value from
@@ -5027,6 +5156,9 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @param cb if a callback is provided, it will execute the callback and commit or rollback the transaction based on the callback's success or failure
      * @param options.isolationLevel The isolation level to use for the transaction
      * @sqlite ignores the isolation level
+     * @warning SQLite `:memory:` databases use `file::memory:?cache=shared`
+     * to allow transaction connections to share the same in-memory database.
+     * Without shared cache each connection would see an empty fresh database.
      */
     transaction(options?: StartTransactionOptions): Promise<Transaction>;
     transaction<T>(cb: (trx: Transaction) => Promise<T>, options?: StartTransactionOptions): Promise<T>;
@@ -5135,6 +5267,71 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Introspects table columns metadata
      */
     getTableInfo(table: string): Promise<TableColumnInfo[]>;
+    /**
+     * @description Checks if a table exists in the database
+     * @param tableName - The name of the table to check
+     * @returns Promise<boolean> - true if table exists, false otherwise
+     */
+    hasTable(tableName: string): Promise<boolean>;
+    /**
+     * @description Checks if a column exists in a table
+     * @param tableName - The name of the table
+     * @param columnName - The name of the column to check
+     * @returns Promise<boolean> - true if column exists in table, false otherwise
+     */
+    hasColumn(tableName: string, columnName: string): Promise<boolean>;
+    /**
+     * @description Checks if multiple columns exist in a table
+     * @param tableName - The name of the table
+     * @param columnNames - Array of column names to check
+     * @returns Promise<boolean> - true if all columns exist in table, false otherwise
+     */
+    hasColumns(tableName: string, ...columnNames: string[]): Promise<boolean>;
+    /**
+     * @description Checks if an index exists on a table
+     * @param tableName - The name of the table
+     * @param indexName - The name of the index to check
+     * @returns Promise<boolean> - true if index exists on table, false otherwise
+     */
+    hasIndex(tableName: string, indexName: string): Promise<boolean>;
+    /**
+     * @description Checks if a table has a primary key
+     * @param tableName - The name of the table
+     * @returns Promise<boolean> - true if table has primary key, false otherwise
+     */
+    hasPrimaryKey(tableName: string): Promise<boolean>;
+    /**
+     * @description Checks if a unique constraint exists on a table for given columns
+     * @param tableName - The name of the table
+     * @param columns - Array of column names (or single string) that form the unique constraint
+     * @returns Promise<boolean> - true if unique constraint exists, false otherwise
+     */
+    hasUnique(tableName: string, columns: string[] | string): Promise<boolean>;
+    /**
+     * @description Checks if a foreign key constraint exists on a table for given columns
+     * @param tableName - The name of the table
+     * @param columns - Array of column names that form the foreign key
+     * @returns Promise<boolean> - true if foreign key exists, false otherwise
+     */
+    hasForeignKey(tableName: string, columns: string[]): Promise<boolean>;
+    /**
+     * @description Checks if a check constraint exists on a table
+     * @param tableName - The name of the table
+     * @param constraintName - The name of the check constraint to check
+     * @returns Promise<boolean> - true if check constraint exists, false otherwise
+     */
+    hasCheckConstraint(tableName: string, constraintName: string): Promise<boolean>;
+    /**
+     * @description Gets all table names in the database
+     * @returns Promise<string[]> - Array of table names
+     */
+    getTables(): Promise<string[]>;
+    /**
+     * @description Gets all column names for a table
+     * @param tableName - The name of the table
+     * @returns Promise<string[]> - Array of column names
+     */
+    getColumnListing(tableName: string): Promise<string[]>;
     /**
      * @description Introspects table indexes metadata
      */
@@ -8143,4 +8340,4 @@ declare const generateOpenApiModelWithMetadata: <T extends new () => Model>(mode
     $id?: string;
 }>;
 
-export { type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnyModelConstructor, type BaseModelMethodOptions, BaseSeeder, type BuildSelectType, type BuildSingleSelectType, type CacheAdapter, type CacheKeys, ClientMigrator, type ColCharOptions, type ColJsonbOptions, type ColMediumIntOptions, type ColSmallIntOptions, type ColTinyIntOptions, type ColVarbinaryOptions, Collection, type CollectionDefinition, type ColumnDef, type CommonDataSourceInput, type ComposeBuildSelect, type ComposeSelect, type ConnectionPolicies, type CreateSchemaResult, type CustomLogger, type DataSourceInput, type DataSourceType, type DateAutoHook, type DefinedCollection, type DefinedModel, type DefinedView, type ExcludeMethods, type ExtractColumnName, type ExtractSourceColumn, type FetchHooks, type FindReturnType, type GetColumnType, type GetConnectionReturnType, HysteriaError, InMemoryAdapter, type InferPK, type IntrospectedColumn, type IntrospectedForeignKey, type IntrospectedSchema, type IntrospectedTable, type JsonPathInput, type JsonPaths, type LoadOptions, type LoggerConfig, type ManyOptions, Migration, type MigrationConfig, type MigrationConfigBase, type ModelColumns, type ModelDataProperties, type ModelInstanceType, type ModelKey, ModelQueryBuilder, type ModelQueryResult, type ModelRelation, type ModelSelectTuple, type ModelSelectableInput, type ModelWithoutRelations, type ModelsProxy, MongoDataSource, type MongoDataSourceInput$1 as MongoDataSourceInput, type MssqlConnectionInstance, type MssqlDataSourceInput, type MssqlPoolInstance, type MutationReturningResult, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullableOracleDBDataSourceInput, type NotNullableOracleMssqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NullableColumn, type NumberModelKey, ObserverChain, ObserverChainWrapper, type OneOptions, type Operation, type OracleDBDataSourceInput, type OracleDBPoolInstance, type PgPoolClientInstance, type PingResult, type PostgresSqlDataSourceInput, type PrimaryColumnDef, type PropNamespace, type PropertyDef, QueryBuilder, type QueryContext, type QueryContextWithDuration, type QueryObserver, type RawModelKey, type RawModelOptions, RawNode, type RawQueryOptions, RedisCacheAdapter, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationDef, type RelationDefinitions, type RelationHelpers, type RelationLoadStrategy, type RelationQueryBuilderType, type ReplicationType, type ResolveColumnType, type ResolveJsonPathType, type ReturningColumns, type ReturningKey, type ReturningParam, type ReturningResult, type ReturningResultMany, type ReturningSupported, Schema, SchemaBuilder, type SchemaLookup, type SchemaRelDef, type SeederConfig, type SelectBrand, type SelectableColumn, type SelectedModel, type SlaveAlgorithm, type SlaveContext, type SqlCloneOptions, SqlDataSource, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDriverSpecificOptions, type SqlPoolType, type Sqlite3ConnectionOptions, type SqliteConnectionInstance, type SqliteDataSourceInput, type StartTransactionOptions, type StripTablePrefix, type SubQueryable, type TableFormat, Transaction, type TransactionExecutionOptions, type TypedDefault, type TypedJsonPathInput, type TypedPrepare, type TypedSerialize, type UseCacheReturnType, type UseConnectionInput, type ValidationContext, ValidationError, type ValidationResult, type Validator, type ViewDefinition, WriteOperation, type WriteReturnType, col, createSchema, defineCollection, defineMigrator, defineModel, defineModelFactory, defineRelations, defineView, deriveOperationFromQuery, email, enumValidator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, type getPoolReturnType, HysteriaLogger as logger, max, maxLength, min, minLength, pattern, prop, RedisDataSource as redis, required, url };
+export { type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnyModelConstructor, type BaseModelMethodOptions, BaseSeeder, type BuildSelectType, type BuildSingleSelectType, type CacheAdapter, type CacheKeys, ClientMigrator, type ColCharOptions, type ColJsonbOptions, type ColMediumIntOptions, type ColSmallIntOptions, type ColTinyIntOptions, type ColVarbinaryOptions, Collection, type CollectionDefinition, type ColumnDef, type CommonDataSourceInput, type ComposeBuildSelect, type ComposeSelect, type ConnectionPolicies, type CreateSchemaResult, type CustomLogger, type DataSourceInput, type DataSourceType, type DateAutoHook, type DefinedCollection, type DefinedModel, type DefinedView, type ExcludeMethods, type ExtractColumnName, type ExtractSourceColumn, type FetchHooks, type FindReturnType, type GetColumnType, type GetConnectionReturnType, HysteriaError, InMemoryAdapter, type InferPK, type IntrospectedColumn, type IntrospectedForeignKey, type IntrospectedSchema, type IntrospectedTable, type JsonPathInput, type JsonPaths, type LoadOptions, type LoggerConfig, type ManyOptions, Migration, type MigrationConfig, type MigrationConfigBase, type MigrationLockConfig, type ModelColumns, type ModelDataProperties, type ModelInstanceType, type ModelKey, ModelQueryBuilder, type ModelQueryResult, type ModelRelation, type ModelSelectTuple, type ModelSelectableInput, type ModelWithoutRelations, type ModelsProxy, MongoDataSource, type MongoDataSourceInput$1 as MongoDataSourceInput, type MssqlConnectionInstance, type MssqlDataSourceInput, type MssqlPoolInstance, type MutationReturningResult, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullableOracleDBDataSourceInput, type NotNullableOracleMssqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NullableColumn, type NumberModelKey, ObserverChain, ObserverChainWrapper, type OneOptions, type Operation, type OracleDBDataSourceInput, type OracleDBPoolInstance, type PgPoolClientInstance, type PingResult, type PostgresSqlDataSourceInput, type PrimaryColumnDef, type PropNamespace, type PropertyDef, QueryBuilder, type QueryContext, type QueryContextWithDuration, type QueryObserver, type RawModelKey, type RawModelOptions, RawNode, type RawQueryOptions, RedisCacheAdapter, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationDef, type RelationDefinitions, type RelationHelpers, type RelationLoadStrategy, type RelationQueryBuilderType, type ReplicationType, type ResolveColumnType, type ResolveJsonPathType, type ReturningColumns, type ReturningKey, type ReturningParam, type ReturningResult, type ReturningResultMany, type ReturningSupported, Schema, SchemaBuilder, type SchemaLookup, type SchemaRelDef, type SeederConfig, type SelectBrand, type SelectableColumn, type SelectedModel, type SlaveAlgorithm, type SlaveContext, type SqlCloneOptions, SqlDataSource, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDriverSpecificOptions, type SqlPoolType, type Sqlite3ConnectionOptions, type SqliteConnectionInstance, type SqliteDataSourceInput, type StartTransactionOptions, type StripTablePrefix, type SubQueryable, type TableFormat, Transaction, type TransactionExecutionOptions, type TypedDefault, type TypedJsonPathInput, type TypedPrepare, type TypedSerialize, type UseCacheReturnType, type UseConnectionInput, type ValidationContext, ValidationError, type ValidationResult, type Validator, type ViewDefinition, WriteOperation, type WriteReturnType, col, createSchema, defineCollection, defineMigrator, defineModel, defineModelFactory, defineRelations, defineView, deriveOperationFromQuery, email, enumValidator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, type getPoolReturnType, HysteriaLogger as logger, max, maxLength, min, minLength, pattern, prop, RedisDataSource as redis, required, url };