hysteria-orm 10.2.2 → 10.2.3

package/lib/index.d.cts

@@ -1,3 +1,5 @@
+import * as mssql from 'mssql';
+import { config, Transaction as Transaction$1 } from 'mssql';
 import * as mongodb from 'mongodb';
 import { Collection as Collection$1 } from 'mongodb';
 import * as sqlite3 from 'sqlite3';
@@ -32,7 +34,15 @@ declare abstract class Entity {
 /**
  * @description Creates a datasource for the selected database type with the provided credentials
  */
-type DataSourceType = "cockroachdb" | "mysql" | "postgres" | "mariadb" | "sqlite" | "mongo";
+type DataSourceType = "cockroachdb" | "mysql" | "postgres" | "mariadb" | "sqlite" | "mssql" | "mongo";
+interface MssqlDataSourceInput extends CommonDataSourceInput {
+    readonly type: "mssql";
+    readonly host?: string;
+    readonly port?: number;
+    readonly username?: string;
+    readonly password?: string;
+    readonly database?: string;
+}
 interface CommonDataSourceInput {
     readonly type?: DataSourceType;
     readonly logs?: boolean;
@@ -85,16 +95,20 @@ interface NotNullableSqliteDataSourceInput extends SqliteDataSourceInput {
 /**
  * @description By default the connection details can be provided in the .env file, you can still override each prop with your actual connection details in the input
  */
-type DataSourceInput = MysqlSqlDataSourceInput | SqliteDataSourceInput | PostgresSqlDataSourceInput | MongoDataSourceInput;
+type DataSourceInput = MssqlDataSourceInput | MysqlSqlDataSourceInput | SqliteDataSourceInput | PostgresSqlDataSourceInput | MongoDataSourceInput;
 
 type Mysql2Import = typeof mysql2_promise;
 type PgImport = typeof pg;
 type Sqlite3Import = typeof sqlite3;
 type MongoClientImport = typeof mongodb;
+type MssqlImport = typeof mssql;
 type MysqlCreateConnectionOptions = PoolOptions;
 type PgClientOptions = ClientConfig;
+type MssqlConnectionOptions = Omit<config, "options"> & {
+    options?: Omit<NonNullable<config["options"]>, "abortTransactionOnError" | "enableImplicitTransactions">;
+};
 type MongoConnectionOptions = NonNullable<ConstructorParameters<MongoClientImport["MongoClient"]>[1]>;
-type DriverSpecificOptions<T extends DataSourceType> = T extends "mongo" ? MongoConnectionOptions : T extends "cockroachdb" | "postgres" ? PgClientOptions : T extends "redis" ? RedisOptions : T extends "mysql" | "mariadb" ? MysqlCreateConnectionOptions : never;
+type DriverSpecificOptions<T extends DataSourceType> = T extends "mongo" ? MongoConnectionOptions : T extends "cockroachdb" | "postgres" ? PgClientOptions : T extends "redis" ? RedisOptions : T extends "mysql" | "mariadb" ? MysqlCreateConnectionOptions : T extends "mssql" ? MssqlConnectionOptions : never;
 
 type MongoCollectionKey<T> = T extends Collection ? T : never;
 type BaseModelMethodOptions$1 = {
@@ -436,6 +450,7 @@ declare abstract class DataSource {
     protected handleMysqlSource(input?: MysqlSqlDataSourceInput): void;
     protected handleSqliteSource(input?: SqliteDataSourceInput): void;
     protected handleMongoSource(input?: MongoDataSourceInput): void;
+    protected handleMssqlSource(input?: MssqlDataSourceInput): void;
 }
 
 type MongoFindOneOptions<T extends Collection> = {
@@ -1099,7 +1114,7 @@ declare class ConstraintNode extends QueryNode {
     constraintName?: string;
     onDelete?: "cascade" | "restrict" | "set null" | "no action";
     onUpdate?: "cascade" | "restrict" | "set null" | "no action";
-    defaultValue?: string;
+    defaultValue?: string | RawNode | undefined;
     checkExpression?: string;
     chainsWith: string;
     canKeywordBeSeenMultipleTimes: boolean;
@@ -1114,7 +1129,7 @@ declare class ConstraintNode extends QueryNode {
         constraintName?: string;
         onDelete?: "cascade" | "restrict" | "set null" | "no action";
         onUpdate?: "cascade" | "restrict" | "set null" | "no action";
-        defaultValue?: string;
+        defaultValue?: string | RawNode | undefined;
         checkExpression?: string;
     }, isRawValue?: boolean);
 }
@@ -1217,7 +1232,7 @@ declare class ConstraintBuilder extends BaseBuilder {
      * @description Sets the default value for the column
      * @param value is the default value for the column
      */
-    default(value: string | number | boolean | null): this;
+    default(value: string | number | boolean | null | RawNode): this;
     /**
      * @description Sets the column to unique
      * @param options is the options for the unique constraint
@@ -1523,35 +1538,42 @@ declare class AlterTableBuilder extends BaseBuilder {
     /**
      * @description Adds a column to the table
      * @param cb is the callback that will be used to build the column
+     * @mssql Auto-generates default constraint names (DF__table__col__xxxxx) which are hard to drop later
      */
     addColumn(cb: (col: CreateTableBuilder) => ConstraintBuilder): void;
     /**
      * @description Alters a column, can generate multiple sql statements depending on the constraints
      * @throws HysteriaError if sqlite database
+     * @mssql Cannot alter columns with DEFAULT/CHECK constraints or indexes - drop them first
      */
     alterColumn(columnBuilder: (col: CreateTableBuilder) => ConstraintBuilder): void;
     /**
      * @description Drops a column
+     * @mssql Must drop all dependent constraints and indexes before dropping the column
      */
     dropColumn(name: string): void;
     /**
      * @description Renames a column
+     * @mssql Uses sp_rename procedure; does not update references in views/procedures/triggers
      */
     renameColumn(oldName: string, newName: string): void;
     /**
      * @description Drops a default value from a column
      * @sqlite not supported and will throw error
+     * @mssql Requires constraint name; use dropConstraint() with name from sys.default_constraints
      */
     dropDefault(columnName: string): void;
     /**
      * @description Adds a primary key constraint to a column
      * @param columnName is the column name to add the primary key to
      * @sqlite not supported and will throw error
+     * @mssql Column must be NOT NULL before adding primary key
      */
     addPrimaryKey(columnName: string): void;
     /**
      * @description Raw non type safe way builder to add a constraint
      * @sqlite not supported and will throw error
+     * @mssql UNIQUE does not allow multiple NULLs (unlike PostgreSQL)
      */
     addConstraint(...options: ConstructorParameters<typeof ConstraintNode>): void;
     /**
@@ -1597,6 +1619,7 @@ declare class AlterTableBuilder extends BaseBuilder {
      * @postgres not supported, use `dropConstraint` instead with the pk constraint name
      * @sqlite not supported and will throw error
      * @throws HysteriaError if postgres and table is not provided
+     * @mssql Foreign keys referencing this primary key must be dropped first
      */
     dropPrimaryKey(table?: string): void;
 }
@@ -1616,12 +1639,14 @@ declare class Schema {
     runFile(filePath: string): void;
     /**
      * @description Create table constructor
+     * @mssql Does not support ifNotExists option
      */
     createTable(table: string, cb: (table: CreateTableBuilder) => void, options?: {
         ifNotExists?: boolean;
     }): void;
     /**
      * @description Alter table constructor
+     * @mssql Limited support - cannot modify columns with constraints; see AlterTableBuilder methods for details
      */
     alterTable(table: string, cb: (t: AlterTableBuilder) => void): void;
     /**
@@ -1630,6 +1655,7 @@ declare class Schema {
     dropTable(table: string, ifExists?: boolean): void;
     /**
      * @description Rename table in the database
+     * @mssql Uses sp_rename procedure; does not update references in views/procedures/triggers
      */
     renameTable(oldTable: string, newTable: string): void;
     /**
@@ -2582,23 +2608,44 @@ declare abstract class WhereQueryBuilder<T extends Model> extends SelectQueryBui
     orWhereNotNull<S extends string>(column: SelectableColumn<S>): this;
     /**
      * @description Adds a WHERE REGEXP condition to the query.
+     * @mssql doesn't support REGEXP syntax
+     * @sqlite doesn't support REGEXP syntax
      */
     whereRegexp(column: ModelKey<T>, regexp: RegExp): this;
     whereRegexp<S extends string>(column: SelectableColumn<S>, regexp: RegExp): this;
     /**
      * @description Adds an AND WHERE REGEXP condition to the query.
+     * @mssql doesn't support REGEXP syntax
+     * @sqlite doesn't support REGEXP syntax
      */
     andWhereRegexp(column: ModelKey<T>, regexp: RegExp): this;
     andWhereRegexp<S extends string>(column: SelectableColumn<S>, regexp: RegExp): this;
     /**
      * @description Adds an OR WHERE REGEXP condition to the query.
+     * @mssql doesn't support REGEXP syntax
+     * @sqlite doesn't support REGEXP syntax
      */
     orWhereRegexp(column: ModelKey<T>, regexp: RegExp): this;
     orWhereRegexp<S extends string>(column: SelectableColumn<S>, regexp: RegExp): this;
+    /**
+     * @description Adds a WHERE NOT REGEXP condition to the query.
+     * @mssql doesn't support REGEXP syntax
+     * @sqlite doesn't support REGEXP syntax
+     */
     whereNotRegexp(column: ModelKey<T>, regexp: RegExp): this;
     whereNotRegexp<S extends string>(column: SelectableColumn<S>, regexp: RegExp): this;
+    /**
+     * @description Adds an AND WHERE NOT REGEXP condition to the query.
+     * @mssql doesn't support REGEXP syntax
+     * @sqlite doesn't support REGEXP syntax
+     */
     andWhereNotRegexp(column: ModelKey<T>, regexp: RegExp): this;
     andWhereNotRegexp<S extends string>(column: SelectableColumn<S>, regexp: RegExp): this;
+    /**
+     * @description Adds an OR WHERE NOT REGEXP condition to the query.
+     * @mssql doesn't support REGEXP syntax
+     * @sqlite doesn't support REGEXP syntax
+     */
     orWhereNotRegexp(column: ModelKey<T>, regexp: RegExp): this;
     orWhereNotRegexp<S extends string>(column: SelectableColumn<S>, regexp: RegExp): this;
     /**
@@ -2680,47 +2727,55 @@ declare class JsonQueryBuilder<T extends Model> extends WhereQueryBuilder<T> {
     whereJson(column: string, value: JsonParam): this;
     /**
      * @description Filters records matching the given JSON value.
+     * @mssql Partial JSON matching not supported - only exact matches work
      */
     andWhereJson(column: ModelKey<T>, value: JsonParam): this;
     andWhereJson(column: string, value: JsonParam): this;
     /**
      * @description Filters records matching the given JSON value.
+     * @mssql Partial JSON matching not supported - only exact matches work
      */
     orWhereJson(column: ModelKey<T>, value: JsonParam): this;
     orWhereJson(column: string, value: JsonParam): this;
     /**
      * @description Filters records where JSON column does NOT contain the given value.
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
+     * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
     whereJsonNotContains(column: ModelKey<T>, value: JsonParam): this;
     whereJsonNotContains(column: string, value: JsonParam): this;
     /**
      * @description Filters records where JSON column does NOT contain the given value (AND).
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
+     * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
     andWhereJsonNotContains(column: ModelKey<T>, value: JsonParam): this;
     andWhereJsonNotContains(column: string, value: JsonParam): this;
     /**
      * @description Filters records where JSON column does NOT contain the given value (OR).
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
+     * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
     orWhereJsonNotContains(column: ModelKey<T>, value: JsonParam): this;
     orWhereJsonNotContains(column: string, value: JsonParam): this;
     /**
      * @description Filters records where JSON column contains the given value.
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
+     * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
     whereJsonContains(column: ModelKey<T>, value: JsonParam): this;
     whereJsonContains(column: string, value: JsonParam): this;
     /**
      * @description Filters records where JSON column contains the given value (AND).
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
+     * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
     andWhereJsonContains(column: ModelKey<T>, value: JsonParam): this;
     andWhereJsonContains(column: string, value: JsonParam): this;
     /**
      * @description Filters records where JSON column contains the given value (OR).
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
+     * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
     orWhereJsonContains(column: ModelKey<T>, value: JsonParam): this;
     orWhereJsonContains(column: string, value: JsonParam): this;
@@ -2913,6 +2968,7 @@ declare class Transaction {
     private releaseConnection;
     private getIsolationLevelQuery;
     private getSavePointName;
+    private getMssqlTransactionLevel;
 }
 
 type ModelWithoutRelations<T extends Model> = Pick<T, ExcludeRelations<Omit<T, "*">>>;
@@ -3127,6 +3183,8 @@ declare class ModelQueryBuilder<T extends Model, A extends Record<string, any> =
      * @warning Many to many relations have special behavior, since they require a join, a join clause will always be added to the query.
      * @warning Many to many relations uses the model foreign key for mapping in the `$annotations` property, this property will be removed from the model after the relation is filled.
      * @warning Foreign keys should always be selected in the relation query builder, otherwise the relation will not be filled.
+     * @mssql HasMany relations with limit/offset and orderByRaw may fail with "Ambiguous column name" error - use fully qualified column names (e.g., `table.column`) in orderByRaw
+     * @cockroachdb HasMany relations with limit/offset and orderByRaw may fail with "Ambiguous column name" error - use fully qualified column names (e.g., `table.column`) in orderByRaw
      */
     load<RelationKey extends ModelRelation<T>, IA extends Record<string, any> = {}, IR extends Record<string, any> = {}>(relation: RelationKey, cb: (queryBuilder: RelationQueryBuilderType<RelatedInstance<T, RelationKey>>) => RelationQueryBuilderType<RelatedInstance<T, RelationKey>, IA, IR>): ModelQueryBuilder<T, A, R & {
         [K in RelationKey]: Awaited<ReturnType<ModelQueryBuilder<RelatedInstance<T, K>, IA, IR>[RelationRetrieveMethod<T[K]>]>>;
@@ -3292,6 +3350,10 @@ declare class ModelManager<T extends Model> {
      */
     insertMany(models: Partial<T>[], options?: InsertOptions<T>): Promise<AnnotatedModel<T, {}>[]>;
     upsertMany(conflictColumns: string[], columnsToUpdate: string[], data: ModelWithoutRelations<T>[], options?: UpsertOptions<T>): Promise<AnnotatedModel<T, {}>[]>;
+    /**
+     * @description Executes a MERGE statement for MSSQL upsert operations
+     */
+    private executeMssqlMerge;
     /**
      * @description Updates a record, returns the updated record
      * @description Model is retrieved from the database using the primary key regardless of any model hooks
@@ -3384,6 +3446,10 @@ declare class SqlDataSource extends DataSource {
      * @description Maps global keys to specific handlers for cache handling
      */
     cacheKeys: CacheKeys;
+    /**
+     * @description The path to the migrations folder for the sql data source, it's used to configure the migrations path for the sql data source
+     */
+    migrationsPath: string;
     /**
      * @description AdminJS configuration options
      */
@@ -3778,7 +3844,9 @@ type SqlDriverSpecificOptions<T extends DataSourceType> = Omit<DriverSpecificOpt
 type MysqlConnectionInstance = Awaited<ReturnType<Mysql2Import["createPool"]>>;
 type PgPoolClientInstance = InstanceType<PgImport["Pool"]>;
 type SqliteConnectionInstance = InstanceType<Sqlite3Import["Database"]>;
-type SqlPoolType = MysqlConnectionInstance | PgPoolClientInstance | SqliteConnectionInstance;
+type MssqlPoolInstance = InstanceType<MssqlImport["ConnectionPool"]>;
+type MssqlConnectionInstance = Awaited<ReturnType<MssqlPoolInstance["connect"]>>;
+type SqlPoolType = MysqlConnectionInstance | PgPoolClientInstance | SqliteConnectionInstance | MssqlPoolInstance;
 /**
  * @description The connection policies for the sql data source
  * @default By default, the connection policies are not set, so no query will be retried
@@ -3821,6 +3889,11 @@ type SqlDataSourceInput<D extends SqlDataSourceType, T extends Record<string, Sq
      * @warning For usage with types, you must have driver types installed if the driver handles types in a type package like e.g. `@types/pg`
      */
     driverOptions?: SqlDriverSpecificOptions<D>;
+    /**
+     * @description The path to the migrations folder for the sql data source, it's used to configure the migrations path for the sql data source
+     * @default "database/migrations"
+     */
+    migrationsPath?: string;
     /**
      * @description The cache strategy to use for the sql data source, it's used to configure the cache strategy for the sql data source
      */
@@ -3833,7 +3906,7 @@ type SqlDataSourceInput<D extends SqlDataSourceType, T extends Record<string, Sq
      * @description To use AdminJS, install: `npm install adminjs`
      */
     adminJs?: AdminJsOptions;
-} & (MysqlSqlDataSourceInput | PostgresSqlDataSourceInput | SqliteDataSourceInput);
+} & (MysqlSqlDataSourceInput | MssqlDataSourceInput | PostgresSqlDataSourceInput | SqliteDataSourceInput);
 type UseConnectionInput<D extends SqlDataSourceType, T extends Record<string, SqlDataSourceModel> = {}, C extends CacheKeys = {}> = {
     readonly type: Exclude<DataSourceType, "mongo">;
     readonly logs?: boolean;
@@ -3859,8 +3932,8 @@ type SqlCloneOptions = {
      */
     shouldRecreatePool?: boolean;
 };
-type getPoolReturnType<T = SqlDataSourceType> = T extends "mysql" ? MysqlConnectionInstance : T extends "mariadb" ? MysqlConnectionInstance : T extends "postgres" ? PgPoolClientInstance : T extends "cockroachdb" ? PgPoolClientInstance : T extends "sqlite" ? SqliteConnectionInstance : never;
-type GetConnectionReturnType<T = SqlDataSourceType> = T extends "mysql" ? PoolConnection : T extends "mariadb" ? PoolConnection : T extends "postgres" ? PoolClient : T extends "cockroachdb" ? PoolClient : T extends "sqlite" ? InstanceType<Sqlite3Import["Database"]> : never;
+type getPoolReturnType<T = SqlDataSourceType> = T extends "mysql" ? MysqlConnectionInstance : T extends "mariadb" ? MysqlConnectionInstance : T extends "postgres" ? PgPoolClientInstance : T extends "cockroachdb" ? PgPoolClientInstance : T extends "sqlite" ? SqliteConnectionInstance : T extends "mssql" ? MssqlPoolInstance : never;
+type GetConnectionReturnType<T = SqlDataSourceType> = T extends "mysql" ? PoolConnection : T extends "mariadb" ? PoolConnection : T extends "postgres" ? PoolClient : T extends "cockroachdb" ? PoolClient : T extends "sqlite" ? InstanceType<Sqlite3Import["Database"]> : T extends "mssql" ? Transaction$1 : never;
 type UseCacheOverloads<C extends CacheKeys> = {
     <K extends keyof C>(key: K, ...args: Parameters<C[K]>): Promise<UseCacheReturnType<C, K>>;
     <K extends keyof C>(key: K, ttl: number, ...args: Parameters<C[K]>): Promise<UseCacheReturnType<C, K>>;
@@ -3895,6 +3968,12 @@ declare class AstParser {
      * Map the database type to a common type if shares the same driver (e.g. mysql and mariadb)
      */
     private mapCommonDbType;
+    /**
+     * @description Generates MSSQL table hints from lock node
+     * MSSQL uses WITH (UPDLOCK), WITH (HOLDLOCK), etc. as table hints
+     * READPAST is the MSSQL equivalent of SKIP LOCKED
+     */
+    private getMssqlTableHints;
 }
 
 declare class DeleteNode extends QueryNode {
@@ -4196,6 +4275,7 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
     with(alias: string, cb: (qb: QueryBuilder<T>) => void): this;
     /**
      * @description Adds a recursive CTE to the query using a callback to build the subquery.
+     * @mssql not supported
      */
     withRecursive(alias: string, cb: (qb: QueryBuilder<T>) => void): this;
     /**
@@ -4232,6 +4312,10 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
      * @param options Upsert options including updateOnConflict and returning columns
      */
     upsertMany<O extends Record<string, any>>(conflictColumns: string[], columnsToUpdate: string[], data: O[], options?: UpsertOptionsRawBuilder): Promise<T[]>;
+    /**
+     * @description Executes a MERGE statement for MSSQL upsert operations (raw query builder)
+     */
+    private executeMssqlMergeRaw;
     /**
      * @description Updates records from a table
      * @returns the number of affected rows
@@ -4318,6 +4402,15 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
     private softDeleteWithPerformance;
     private deleteWithPerformance;
     private truncateWithPerformance;
+    /**
+     * @description Checks if the current context is an MSSQL transaction
+     * @description MSSQL transactions can only handle one request at a time
+     */
+    protected isMssqlTransaction(): boolean;
+    /**
+     * @description Executes pagination queries, serializing them for MSSQL transactions
+     */
+    protected executePaginateQueries<M, C>(modelsQuery: () => Promise<M>, countQuery: () => Promise<C>): Promise<[M, C]>;
 }
 
 type UnionCallBack<T extends Model> = (queryBuilder: QueryBuilder<T>) => QueryBuilder<T>;
@@ -5770,7 +5863,7 @@ type WithPerformanceResult<R = any> = [string, R];
  */
 declare const withPerformance: <A extends any[], R>(fn: (...args: A) => Promise<R>, returnType?: "millis" | "seconds", fix?: number) => (...args: A) => Promise<WithPerformanceResult<R>>;
 
-type HysteriaErrorCode = "ROW_NOT_FOUND" | `UNSUPPORTED_DATABASE_TYPE_${string}` | `RELATION_TYPE_NOT_SUPPORTED_${string}` | `NOT_SUPPORTED_IN_${string}` | `RELATION_NOT_FOUND_IN_MODEL_${string}` | `UNKNOWN_RELATION_TYPE_${string}` | `DISTINCT_ON_NOT_SUPPORTED_IN_${string}` | `CONFLICT_COLUMNS_NOT_PRESENT_IN_DATA` | `CONFLICT_COLUMNS_NOT_PRESENT_IN_DATA_${string}` | `FOREIGN_KEY_VALUES_MISSING_FOR_HAS_ONE_RELATION_${string}` | `FOREIGN_KEY_VALUES_MISSING_FOR_BELONGS_TO_RELATION_${string}` | `PRIMARY_KEY_VALUES_MISSING_FOR_HAS_MANY_RELATION_${string}` | `MANY_TO_MANY_RELATION_NOT_FOUND_FOR_RELATED_MODEL_${string}` | `PRIMARY_KEY_VALUES_MISSING_FOR_MANY_TO_MANY_RELATION_${string}` | `RELATED_MODEL_DOES_NOT_HAVE_A_PRIMARY_KEY_${string}` | `FOR_SHARE_NOT_SUPPORTED_IN_${string}` | `SKIP_LOCKED_NOT_SUPPORTED_IN_${string}` | `LOCK_FOR_UPDATE_NOT_SUPPORTED_${string}` | `KEY_${string}_HAS_NO_HANDLER_IN_CACHE_KEYS_CONFIG` | `CACHE_ADAPTER_NOT_CONFIGURED` | `SQLITE_NOT_SUPPORTED` | `COCKROACHDB_NOT_SUPPORTED` | `RELATION_NOT_FOUND` | `POSTGRES_TABLE_REQUIRED` | `MODEL_HAS_NO_PRIMARY_KEY_VALUE` | `RELATION_NOT_MANY_TO_MANY` | "MATERIALIZED_CTE_NOT_SUPPORTED" | "DUPLICATE_MODEL_KEYS_WHILE_INSTANTIATING_MODELS" | "INVALID_ONE_PARAMETER_WHERE_CONDITION" | "INVALID_PAGINATION_PARAMETERS" | "MISSING_ALIAS_FOR_SUBQUERY" | "MODEL_HAS_NO_PRIMARY_KEY" | "PRIMARY_KEY_NOT_FOUND" | "SQLITE_ONLY_SUPPORTS_SERIALIZABLE_ISOLATION_LEVEL" | "MUST_CALL_BUILD_CTE_AT_LEAST_ONCE" | "REGEXP_NOT_SUPPORTED_IN_SQLITE" | "MANY_TO_MANY_RELATION_MUST_HAVE_A_THROUGH_MODEL" | "INSERT_FAILED" | "MULTIPLE_PRIMARY_KEYS_NOT_ALLOWED" | "FILE_NOT_A_SQL_OR_TXT_FILE" | "CONNECTION_NOT_ESTABLISHED" | "TRANSACTION_NOT_ACTIVE" | "DEVELOPMENT_ERROR" | "MIGRATION_MODULE_NOT_FOUND" | "DRIVER_NOT_FOUND" | "FILE_NOT_FOUND_OR_NOT_ACCESSIBLE" | "ENV_NOT_SET" | "REQUIRED_VALUE_NOT_SET" | "SET_FAILED" | "GET_FAILED" | "REFERENCES_OPTION_REQUIRED" | "DELETE_FAILED" | "INVALID_DEFAULT_VALUE" | "DISCONNECT_FAILED" | "FLUSH_FAILED" | "LEFT_COLUMN_NOT_PROVIDED_FOR_JOIN" | "RIGHT_COLUMN_NOT_PROVIDED_FOR_JOIN" | "MODEL_HAS_NO_PRIMARY_KEY" | "GLOBAL_TRANSACTION_ALREADY_STARTED" | "GLOBAL_TRANSACTION_NOT_STARTED" | "MYSQL_REQUIRES_TABLE_NAME_FOR_INDEX_DROP" | "INVALID_DATE_OBJECT" | "INVALID_DATE_STRING" | "FAILED_TO_PARSE_DATE" | "MIGRATION_MODULE_REQUIRES_TS_NODE" | "FAILED_TO_ENCRYPT_SYMMETRICALLY" | "FAILED_TO_DECRYPT_SYMMETRICALLY" | "FAILED_TO_ENCRYPT_ASYMMETRICALLY" | "FAILED_TO_DECRYPT_ASYMMETRICALLY" | "UNSUPPORTED_RELATION_TYPE" | "LPUSH_FAILED" | "RPUSH_FAILED" | "LPOP_FAILED" | "RPOP_FAILED" | "LRANGE_FAILED" | "LLEN_FAILED" | "HSET_FAILED" | "HMSET_FAILED" | "HGET_FAILED" | "HGETALL_FAILED" | "HMGET_FAILED" | "HDEL_FAILED" | "HEXISTS_FAILED" | "HKEYS_FAILED" | "HLEN_FAILED" | "SADD_FAILED" | "SMEMBERS_FAILED" | "SREM_FAILED" | "SISMEMBER_FAILED" | "SCARD_FAILED" | "SINTER_FAILED" | "SUNION_FAILED" | "SDIFF_FAILED" | "ZADD_FAILED" | "ZRANGE_FAILED" | "ZREVRANGE_FAILED" | "ZREM_FAILED" | "ZSCORE_FAILED" | "ZCARD_FAILED" | "SUBSCRIBE_FAILED" | "UNSUBSCRIBE_FAILED" | "PUBLISH_FAILED" | "PSUBSCRIBE_FAILED" | "PUNSUBSCRIBE_FAILED" | "EXISTS_FAILED" | "EXPIRE_FAILED" | "EXPIREAT_FAILED" | "PEXPIRE_FAILED" | "TTL_FAILED" | "PTTL_FAILED" | "PERSIST_FAILED" | "KEYS_FAILED" | "RENAME_FAILED" | "TYPE_FAILED" | "SCAN_FAILED" | "ADMINJS_NOT_ENABLED" | "ADMINJS_INITIALIZATION_FAILED" | "ADMINJS_NO_MODELS_PROVIDED";
+type HysteriaErrorCode = `UNSUPPORTED_ISOLATION_LEVEL_${string}` | "ROW_NOT_FOUND" | `UNSUPPORTED_DATABASE_TYPE_${string}` | `RELATION_TYPE_NOT_SUPPORTED_${string}` | `NOT_SUPPORTED_IN_${string}` | `RELATION_NOT_FOUND_IN_MODEL_${string}` | `UNKNOWN_RELATION_TYPE_${string}` | `DISTINCT_ON_NOT_SUPPORTED_IN_${string}` | `CONFLICT_COLUMNS_NOT_PRESENT_IN_DATA` | `CONFLICT_COLUMNS_NOT_PRESENT_IN_DATA_${string}` | `FOREIGN_KEY_VALUES_MISSING_FOR_HAS_ONE_RELATION_${string}` | `FOREIGN_KEY_VALUES_MISSING_FOR_BELONGS_TO_RELATION_${string}` | `PRIMARY_KEY_VALUES_MISSING_FOR_HAS_MANY_RELATION_${string}` | `MANY_TO_MANY_RELATION_NOT_FOUND_FOR_RELATED_MODEL_${string}` | `PRIMARY_KEY_VALUES_MISSING_FOR_MANY_TO_MANY_RELATION_${string}` | `RELATED_MODEL_DOES_NOT_HAVE_A_PRIMARY_KEY_${string}` | `FOR_SHARE_NOT_SUPPORTED_IN_${string}` | `SKIP_LOCKED_NOT_SUPPORTED_IN_${string}` | `LOCK_FOR_UPDATE_NOT_SUPPORTED_${string}` | `KEY_${string}_HAS_NO_HANDLER_IN_CACHE_KEYS_CONFIG` | `CACHE_ADAPTER_NOT_CONFIGURED` | `SQLITE_NOT_SUPPORTED` | `COCKROACHDB_NOT_SUPPORTED` | `RELATION_NOT_FOUND` | `POSTGRES_TABLE_REQUIRED` | `MODEL_HAS_NO_PRIMARY_KEY_VALUE` | `RELATION_NOT_MANY_TO_MANY` | "MATERIALIZED_CTE_NOT_SUPPORTED" | "DUPLICATE_MODEL_KEYS_WHILE_INSTANTIATING_MODELS" | "INVALID_ONE_PARAMETER_WHERE_CONDITION" | "INVALID_PAGINATION_PARAMETERS" | "MISSING_ALIAS_FOR_SUBQUERY" | "MODEL_HAS_NO_PRIMARY_KEY" | "PRIMARY_KEY_NOT_FOUND" | "SQLITE_ONLY_SUPPORTS_SERIALIZABLE_ISOLATION_LEVEL" | "MUST_CALL_BUILD_CTE_AT_LEAST_ONCE" | "REGEXP_NOT_SUPPORTED_IN_SQLITE" | "MANY_TO_MANY_RELATION_MUST_HAVE_A_THROUGH_MODEL" | "INSERT_FAILED" | "MULTIPLE_PRIMARY_KEYS_NOT_ALLOWED" | "FILE_NOT_A_SQL_OR_TXT_FILE" | "CONNECTION_NOT_ESTABLISHED" | "TRANSACTION_NOT_ACTIVE" | "DEVELOPMENT_ERROR" | "MIGRATION_MODULE_NOT_FOUND" | "DRIVER_NOT_FOUND" | "FILE_NOT_FOUND_OR_NOT_ACCESSIBLE" | "ENV_NOT_SET" | "REQUIRED_VALUE_NOT_SET" | "SET_FAILED" | "GET_FAILED" | "REFERENCES_OPTION_REQUIRED" | "DELETE_FAILED" | "INVALID_DEFAULT_VALUE" | "DISCONNECT_FAILED" | "FLUSH_FAILED" | "LEFT_COLUMN_NOT_PROVIDED_FOR_JOIN" | "RIGHT_COLUMN_NOT_PROVIDED_FOR_JOIN" | "MODEL_HAS_NO_PRIMARY_KEY" | "GLOBAL_TRANSACTION_ALREADY_STARTED" | "GLOBAL_TRANSACTION_NOT_STARTED" | "MYSQL_REQUIRES_TABLE_NAME_FOR_INDEX_DROP" | "INVALID_DATE_OBJECT" | "INVALID_DATE_STRING" | "FAILED_TO_PARSE_DATE" | "MIGRATION_MODULE_REQUIRES_TS_NODE" | "FAILED_TO_ENCRYPT_SYMMETRICALLY" | "FAILED_TO_DECRYPT_SYMMETRICALLY" | "FAILED_TO_ENCRYPT_ASYMMETRICALLY" | "FAILED_TO_DECRYPT_ASYMMETRICALLY" | "UNSUPPORTED_RELATION_TYPE" | "LPUSH_FAILED" | "RPUSH_FAILED" | "LPOP_FAILED" | "RPOP_FAILED" | "LRANGE_FAILED" | "LLEN_FAILED" | "HSET_FAILED" | "HMSET_FAILED" | "HGET_FAILED" | "HGETALL_FAILED" | "HMGET_FAILED" | "HDEL_FAILED" | "HEXISTS_FAILED" | "HKEYS_FAILED" | "HLEN_FAILED" | "SADD_FAILED" | "SMEMBERS_FAILED" | "SREM_FAILED" | "SISMEMBER_FAILED" | "SCARD_FAILED" | "SINTER_FAILED" | "SUNION_FAILED" | "SDIFF_FAILED" | "ZADD_FAILED" | "ZRANGE_FAILED" | "ZREVRANGE_FAILED" | "ZREM_FAILED" | "ZSCORE_FAILED" | "ZCARD_FAILED" | "SUBSCRIBE_FAILED" | "UNSUBSCRIBE_FAILED" | "PUBLISH_FAILED" | "PSUBSCRIBE_FAILED" | "PUNSUBSCRIBE_FAILED" | "EXISTS_FAILED" | "EXPIRE_FAILED" | "EXPIREAT_FAILED" | "PEXPIRE_FAILED" | "TTL_FAILED" | "PTTL_FAILED" | "PERSIST_FAILED" | "KEYS_FAILED" | "RENAME_FAILED" | "TYPE_FAILED" | "SCAN_FAILED" | "ADMINJS_NOT_ENABLED" | "ADMINJS_INITIALIZATION_FAILED" | "ADMINJS_NO_MODELS_PROVIDED";
 
 declare class HysteriaError extends Error {
     code: HysteriaErrorCode;
@@ -5795,4 +5888,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 AnnotatedModel, type AsymmetricEncryptionOptions, type AugmentedSqlDataSource, AutogeneratedModel, type BaseModelMethodOptions, type BaseModelRelationType, type CacheAdapter, type CacheKeys, ClientMigrator, Collection, type ColumnDataTypeOption, type ColumnDataTypeOptionSimple, type ColumnDataTypeOptionWithBinary, type ColumnDataTypeOptionWithDatePrecision, type ColumnDataTypeOptionWithEnum, type ColumnDataTypeOptionWithLength, type ColumnDataTypeOptionWithPrecision, type ColumnDataTypeOptionWithScaleAndPrecision, type ColumnDataTypeOptionWithText, type ColumnOptions, type ColumnType, type CommonDataSourceInput, type CommonSqlMethodReturnType, type ConnectionPolicies, type DataSourceInput, type DataSourceType, type DateColumnOptions, DryModelQueryBuilder, DryQueryBuilder, type FetchHooks, type GetConnectionReturnType, HysteriaError, InMemoryAdapter, type IndexType, type LazyRelationType, type ManyOptions, type ManyToManyOptions, type ManyToManyStringOptions, Migration, Model, type ModelInstanceType, ModelQueryBuilder, type ModelWithoutRelations, MongoDataSource, type MongoDataSourceInput, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NumberModelKey, type OneOptions, type PgPoolClientInstance, type PostgresSqlDataSourceInput, QueryBuilder, type RawModelOptions, RedisCacheAdapter, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationQueryBuilderType, type SqlCloneOptions, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDataSourceWithoutTransaction, type SqlDriverSpecificOptions, type SqlPoolType, type Sqlite3ConnectionOptions, type SqliteConnectionInstance, type SqliteDataSourceInput, type StartTransactionOptions, type SymmetricEncryptionOptions, type TableFormat, type ThroughModel, TimestampedModel, Transaction, type TransactionExecutionOptions, type UniqueType, type UseCacheReturnType, type UseConnectionInput, UserMixin, UuidModel, belongsTo, column, createModelFactory, defineMigrator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, getCollectionProperties, getIndexes, getModelColumns, type getPoolReturnType, getPrimaryKey, getRelations, getRelationsMetadata, getUniques, hasMany, hasOne, index, HysteriaLogger as logger, manyToMany, MongoDataSource as mongo, property, RedisDataSource as redis, SqlDataSource as sql, unique, view, withPerformance };
+export { type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnnotatedModel, type AsymmetricEncryptionOptions, type AugmentedSqlDataSource, AutogeneratedModel, type BaseModelMethodOptions, type BaseModelRelationType, type CacheAdapter, type CacheKeys, ClientMigrator, Collection, type ColumnDataTypeOption, type ColumnDataTypeOptionSimple, type ColumnDataTypeOptionWithBinary, type ColumnDataTypeOptionWithDatePrecision, type ColumnDataTypeOptionWithEnum, type ColumnDataTypeOptionWithLength, type ColumnDataTypeOptionWithPrecision, type ColumnDataTypeOptionWithScaleAndPrecision, type ColumnDataTypeOptionWithText, type ColumnOptions, type ColumnType, type CommonDataSourceInput, type CommonSqlMethodReturnType, type ConnectionPolicies, type DataSourceInput, type DataSourceType, type DateColumnOptions, DryModelQueryBuilder, DryQueryBuilder, type FetchHooks, type GetConnectionReturnType, HysteriaError, InMemoryAdapter, type IndexType, type LazyRelationType, type ManyOptions, type ManyToManyOptions, type ManyToManyStringOptions, Migration, Model, type ModelInstanceType, ModelQueryBuilder, type ModelWithoutRelations, MongoDataSource, type MongoDataSourceInput, type MssqlConnectionInstance, type MssqlDataSourceInput, type MssqlPoolInstance, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NumberModelKey, type OneOptions, type PgPoolClientInstance, type PostgresSqlDataSourceInput, QueryBuilder, type RawModelOptions, RawNode, RedisCacheAdapter, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationQueryBuilderType, type SqlCloneOptions, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDataSourceWithoutTransaction, type SqlDriverSpecificOptions, type SqlPoolType, type Sqlite3ConnectionOptions, type SqliteConnectionInstance, type SqliteDataSourceInput, type StartTransactionOptions, type SymmetricEncryptionOptions, type TableFormat, type ThroughModel, TimestampedModel, Transaction, type TransactionExecutionOptions, type UniqueType, type UseCacheReturnType, type UseConnectionInput, UserMixin, UuidModel, belongsTo, column, createModelFactory, defineMigrator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, getCollectionProperties, getIndexes, getModelColumns, type getPoolReturnType, getPrimaryKey, getRelations, getRelationsMetadata, getUniques, hasMany, hasOne, index, HysteriaLogger as logger, manyToMany, MongoDataSource as mongo, property, RedisDataSource as redis, SqlDataSource as sql, unique, view, withPerformance };