hysteria-orm 12.2.2 → 12.3.0

package/lib/index.d.ts

@@ -921,22 +921,24 @@ declare class UnionNode extends QueryNode {
     query: QueryNode | QueryNode[] | string;
     isAll: boolean;
     type: SetOperationType;
+    bindings?: any[];
     chainsWith: string;
     canKeywordBeSeenMultipleTimes: boolean;
     folder: string;
     file: string;
-    constructor(query: QueryNode | QueryNode[] | string, isAll?: boolean, type?: SetOperationType);
+    constructor(query: QueryNode | QueryNode[] | string, isAll?: boolean, type?: SetOperationType, bindings?: any[]);
 }
 
 declare class WithNode extends QueryNode {
     alias: string;
     body: QueryNode | QueryNode[];
     clause: string;
+    columns?: string[];
     chainsWith: string;
     canKeywordBeSeenMultipleTimes: boolean;
     folder: string;
     file: string;
-    constructor(clause: string, alias: string, body: QueryNode | QueryNode[]);
+    constructor(clause: string, alias: string, body: QueryNode | QueryNode[], columns?: string[]);
 }
 
 declare abstract class DataSource {
@@ -1929,6 +1931,12 @@ declare class InterpreterUtils {
      * @description Formats the from node for write operations removing the "from" keyword
      */
     getFromForWriteOperations(dbType: SqlDataSourceType, fromNode: FromNode): string;
+    /**
+     * @description Renders CTE nodes as a leading `with ...` clause. Used by writes
+     * whose dialect places the CTE inside the statement body (INSERT) rather than
+     * as a sibling node.
+     */
+    renderWithNodes(dbType: SqlDataSourceType, withNodes: WithNode[] | undefined, startIndex: number): ReturnType<typeof AstParser.prototype.parse>;
 }
 
 /**
@@ -1972,6 +1980,48 @@ declare class WriteOperation<T> implements PromiseLike<T> {
     unWrap(): ReturnType<typeof AstParser.prototype.parse>;
 }
 
+type InsertConflictMode = "update" | "ignore";
+type InsertConflictConfig = {
+    conflictColumns: string[];
+    mode: InsertConflictMode;
+    columnsToUpdate: string[];
+};
+/**
+ * @description A WriteOperation for inserts that can be given a conflict action
+ * (`onConflict(...).merge()` or `.ignore()`) before it is awaited.
+ */
+declare class InsertWriteOperation<T, K extends string = string> extends WriteOperation<T> {
+    private conflictState;
+    private conflictColumns;
+    private readonly commit;
+    private readonly insertColumns;
+    private readonly caller;
+    constructor(unWrapFn: () => ReturnType<typeof AstParser.prototype.parse>, toSqlFn: () => ReturnType<typeof AstParser.prototype.parse>, toQueryFn: () => string, executor: () => Promise<T>, commit: (config: InsertConflictConfig) => void, insertColumns: readonly string[], caller: string);
+    /**
+     * @description Sets the column(s) that identify a conflict
+     * @description With no arguments the conflict has no explicit target, which is
+     * only valid with `ignore()`
+     * @description Must be followed by `merge()` or `ignore()`
+     */
+    onConflict(): this;
+    onConflict(column: K): this;
+    onConflict(columns: K[]): this;
+    /**
+     * @description Updates the inserted columns when the conflict target already exists
+     * @description Without arguments every inserted column except the conflict target is updated
+     */
+    merge(): this;
+    merge(column: K): this;
+    merge(columns: K[]): this;
+    /**
+     * @description Leaves the existing row untouched when the conflict target already exists
+     * @description Works with or without an explicit conflict target
+     */
+    ignore(): this;
+    private requireConflictTarget;
+    private commitConflict;
+}
+
 type TransactionIsolationLevel = "READ UNCOMMITTED" | "READ COMMITTED" | "REPEATABLE READ" | "SERIALIZABLE";
 type StartTransactionOptions = {
     isolationLevel?: TransactionIsolationLevel;
@@ -2076,6 +2126,21 @@ type ModelDataProperties = Pick<Model, ExcludeMethods<Model>>;
  * Includes only data columns from the model, excluding foreign keys and relation accessors.
  */
 type ModelWithoutRelations<T extends Model> = Pick<Omit<T, "*">, ExcludeRelations<Omit<T, "*">>> & ModelDataProperties;
+/**
+ * A JSON mutation helper writes a path rather than a value, so it is accepted only
+ * where the column is JSON: `unknown` from an untyped `col.json()`, or an object
+ * type from a structured `col.jsonb<T>()`.
+ */
+type JsonMutationFor<V> = [unknown] extends [NonNullable<V>] ? JsonMutationNode : [NonNullable<V>] extends [object] ? JsonMutationNode : never;
+/**
+ * Values accepted by a model insert or update: the column's own type, or an
+ * expression node such as `sql.rawStatement("LOWER(email)")`. The JSON mutation
+ * helpers (`sql.jsonSet`, `sql.jsonInsert`, `sql.jsonRemove`) are limited to JSON
+ * columns, since they emit a path write rather than a value.
+ */
+type ModelWriteData<T extends Model> = {
+    [K in keyof ModelWithoutRelations<T>]?: ModelWithoutRelations<T>[K] | RawNode | SqlFuncNode | JsonMutationFor<ModelWithoutRelations<T>[K]>;
+};
 /**
  * Return type for Model query/mutation methods.
  * Represents data-only properties without any business logic.
@@ -2197,17 +2262,25 @@ declare class ModelManager<T extends Model> {
      * @throws {HysteriaError} if the model has no primary key
      */
     findOneByPrimaryKey(value: string | number, returning?: ModelKey<T>[]): Promise<ModelWithoutRelations<T> | null>;
+    /**
+     * @description Places the CTEs ahead of the insert, except on MySQL/MariaDB which only
+     * accept them inline after the column list (rendered by the insert interpreter).
+     */
+    private withInsertNodes;
     /**
      * @description Creates a new record in the database
      * @returns WriteOperation that executes when awaited
      */
-    insert(model: Partial<T>, options?: InsertOptions<T>): WriteOperation<ModelWithoutRelations<T>>;
+    insert(model: ModelWriteData<T>, options?: InsertOptions<T>): InsertWriteOperation<ModelWithoutRelations<T>>;
     /**
      * @description Creates multiple records in the database
      * @returns WriteOperation that executes when awaited
      */
-    insertMany(models: Partial<T>[], options?: InsertOptions<T>): WriteOperation<ModelWithoutRelations<T>[]>;
+    insertMany(models: ModelWriteData<T>[], options?: InsertOptions<T>): InsertWriteOperation<ModelWithoutRelations<T>[]>;
+    private insertManyInternal;
     upsertMany(conflictColumns: string[], columnsToUpdate: string[], data: ModelWithoutRelations<T>[], options?: UpsertOptions<T>): WriteOperation<ModelWithoutRelations<T>[]>;
+    private executeInsertConflict;
+    private refetchByConflictColumn;
     /**
      * @description Executes a MERGE statement for MSSQL upsert operations
      */
@@ -2290,16 +2363,28 @@ type TableForeignKeyInfo = {
     onUpdate?: string | null;
 };
 
+type InsertNodeOptions = {
+    withNodes?: WithNode[];
+    source?: QueryNode[];
+    targetColumns?: string[];
+    ignoreInto?: boolean;
+    disambiguateSource?: boolean;
+};
 declare class InsertNode extends QueryNode {
     fromNode: FromNode;
     records: Record<string, any>[];
     returning?: string[];
     disableReturning: boolean;
+    withNodes?: WithNode[];
+    source?: QueryNode[];
+    targetColumns?: string[];
+    ignoreInto: boolean;
+    disambiguateSource: boolean;
     chainsWith: string;
     canKeywordBeSeenMultipleTimes: boolean;
     folder: string;
     file: string;
-    constructor(fromNode: FromNode, records?: Record<string, any>[], returning?: string[], disableReturning?: boolean, isRawValue?: boolean);
+    constructor(fromNode: FromNode, records?: Record<string, any>[], returning?: string[], disableReturning?: boolean, isRawValue?: boolean, options?: InsertNodeOptions);
 }
 
 declare class OnDuplicateNode extends QueryNode {
@@ -2333,13 +2418,19 @@ declare class ReturningNode extends QueryNode {
 
 type UnionCallBack<T extends Model> = (queryBuilder: QueryBuilder<T>) => QueryBuilder<T>;
 
+type TruncateOptions = {
+    cascade?: boolean;
+    restartIdentity?: boolean;
+    continueIdentity?: boolean;
+};
 declare class TruncateNode extends QueryNode {
     fromNode: FromNode | string;
+    options?: TruncateOptions;
     chainsWith: string;
     canKeywordBeSeenMultipleTimes: boolean;
     folder: string;
     file: string;
-    constructor(fromNode: FromNode | string, isRawValue?: boolean);
+    constructor(fromNode: FromNode | string, isRawValue?: boolean, options?: TruncateOptions);
 }
 
 declare class UpdateNode extends QueryNode {
@@ -2919,7 +3010,9 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
     protected _interpreterUtils: InterpreterUtils | null;
     protected get interpreterUtils(): InterpreterUtils;
     protected insertNode: InsertNode | null;
+    protected insertNodeSource: QueryNode[] | undefined;
     protected onDuplicateNode: OnDuplicateNode | null;
+    protected insertConflictConfig: InsertConflictConfig | null;
     protected updateNode: UpdateNode | null;
     protected deleteNode: DeleteNode | null;
     protected returningNode: ReturningNode | null;
@@ -3188,12 +3281,12 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
     /**
      * @description Adds an INTERSECT to the query (keeps only rows present in both queries).
      */
-    intersect(query: string): this;
+    intersect(query: string, bindings?: any[]): this;
     intersect(cb: UnionCallBack<T>): this;
     /**
      * @description Adds an EXCEPT to the query (keeps rows from the first query not present in the second).
      */
-    except(query: string): this;
+    except(query: string, bindings?: any[]): this;
     except(cb: UnionCallBack<T>): this;
     private resolveSetOperationNodes;
     /**
@@ -3275,8 +3368,10 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
     fromRaw(raw: string, bindings?: any[]): this;
     /**
      * @description Adds a CTE to the query using a callback to build the subquery.
+     * @param columns - Optional explicit column list for the CTE (`with t (a, b) as (...)`)
      */
     with(alias: string, cb: (qb: QueryBuilder<T>) => void | SubQueryable): this;
+    with(alias: string, columns: string[], cb: (qb: QueryBuilder<T>) => void | SubQueryable): this;
     /**
      * @description Adds a recursive CTE to the query using a callback to build the subquery.
      * @mssql not supported
@@ -3299,15 +3394,15 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
      * @param returning - The columns to return from the query, only supported by postgres and cockroachdb - default is "*"
      * @returns WriteOperation that executes when awaited
      */
-    insert(data: Record<string, WriteQueryParam>, returning: string[]): WriteOperation<T>;
-    insert(data: Record<string, WriteQueryParam>): WriteOperation<void>;
+    insert(data: Record<string, WriteQueryParam>, returning: string[]): InsertWriteOperation<T>;
+    insert(data: Record<string, WriteQueryParam>): InsertWriteOperation<void>;
     /**
      * @description Insert multiple records into a table
      * @param returning - The columns to return from the query, only supported by postgres and cockroachdb - default is "*"
      * @returns WriteOperation that executes when awaited
      */
-    insertMany(data: Record<string, WriteQueryParam>[], returning: string[]): WriteOperation<T[]>;
-    insertMany(data: Record<string, WriteQueryParam>[]): WriteOperation<void>;
+    insertMany(data: Record<string, WriteQueryParam>[], returning: string[]): InsertWriteOperation<T[]>;
+    insertMany(data: Record<string, WriteQueryParam>[]): InsertWriteOperation<void>;
     /**
      * @description Updates or creates a new record using upsert functionality
      * @param data The data to insert or update
@@ -3325,6 +3420,18 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
      * @returns WriteOperation that executes when awaited
      */
     upsertMany<O extends Record<string, any>>(conflictColumns: string[], columnsToUpdate: string[], data: O[], options?: UpsertOptionsRawBuilder): WriteOperation<T[]>;
+    private buildRawUpsert;
+    private buildInsertConflictCommit;
+    /**
+     * @description Inserts the rows produced by a SELECT (or a CTE feeding one) into the table.
+     * @param targetColumns - Optional destination column list; positional when omitted
+     * @param source - A builder (or callback) whose SELECT becomes the insert source
+     * @returns InsertWriteOperation, so `onConflict(...).merge()/.ignore()` chains onto it
+     * @warning Rows come from the database, so no validation, hooks or autoCreate columns run
+     */
+    insertFrom(source: QueryBuilder<any> | ((qb: QueryBuilder<any>) => QueryBuilder<any> | void)): InsertWriteOperation<T[]>;
+    insertFrom<C extends string>(targetColumns: C[], source: QueryBuilder<any> | ((qb: QueryBuilder<any>) => QueryBuilder<any> | void)): InsertWriteOperation<T[]>;
+    protected buildInsertFrom(sourceNodes: QueryNode[], targetColumns?: string[]): InsertWriteOperation<T[]>;
     /**
      * @description Executes a MERGE statement for MSSQL upsert operations (raw query builder)
      */
@@ -3347,10 +3454,11 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
     protected withReturningNode<N>(nodes: N[]): (N | ReturningNode)[];
     /**
      * @description Deletes all records from a table
+     * @param options - `RESTART IDENTITY` / `CONTINUE IDENTITY` / `CASCADE` (PostgreSQL and CockroachDB only)
      * @warning This operation does not trigger any hook
      * @returns WriteOperation that executes when awaited
      */
-    truncate(): WriteOperation<void>;
+    truncate(options?: TruncateOptions): WriteOperation<void>;
     /**
      * @description Deletes records from a table
      * @param returning - Optional array of column names to return from the deleted rows.
@@ -3406,6 +3514,17 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
      * @description Removes any with query
      */
     clearWithQuery(): this;
+    /**
+     * @description Rejects clause state that would otherwise be silently dropped on a
+     * write. Thrown at call time so the failure points at the builder call.
+     * @param allowOrderByLimit - MySQL/MariaDB accept ORDER BY / LIMIT on UPDATE and DELETE
+     */
+    protected assertWriteClausesSupported(method: string, allowOrderByLimit?: boolean, allowCte?: boolean): void;
+    /**
+     * @description Single source of truth for a write statement's node list. Preview
+     * (`extractQueryNodes`) and execution both go through it so they cannot diverge.
+     */
+    protected extractWriteNodes(): QueryNode[];
     extractQueryNodes(): QueryNode[];
     protected clearForFunctions(): this;
     /**
@@ -6285,6 +6404,7 @@ type UpsertOptions<T extends Model> = {
 };
 type InsertOptions<T extends Model> = {
     returning?: ReturningKey<T>[];
+    withNodes?: WithNode[];
 };
 type ExcludeRelations<T> = {
     [K in keyof T]: K extends "__tableName" ? never : T[K] extends NullableAndUndefinable<Model> | NullableAndUndefinable<Model[]> | ((...args: any[]) => any) ? never : K;
@@ -6909,17 +7029,26 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
     /**
      * @description Inserts a new record into the database.
      */
-    insert<const Ret extends readonly (RawModelKey<T> | "*")[] = never[]>(modelData: Partial<ModelWithoutRelations<T>>, options?: {
+    insert<const Ret extends readonly (RawModelKey<T> | "*")[] = never[]>(modelData: ModelWriteData<T>, options?: {
         returning?: Ret;
         trx?: Transaction;
-    }): WriteOperation<ReturningResult<T, Ret>>;
+    }): InsertWriteOperation<ReturningResult<T, Ret>, Extract<ModelKey<T>, string>>;
     /**
      * @description Inserts multiple records into the database.
      */
-    insertMany<const Ret extends readonly (RawModelKey<T> | "*")[] = never[]>(modelsData: Partial<ModelWithoutRelations<T>>[], options?: {
+    insertMany<const Ret extends readonly (RawModelKey<T> | "*")[] = never[]>(modelsData: ModelWriteData<T>[], options?: {
         returning?: Ret;
         trx?: Transaction;
-    }): WriteOperation<ReturningResultMany<T, Ret>>;
+    }): InsertWriteOperation<ReturningResultMany<T, Ret>, Extract<ModelKey<T>, string>>;
+    /**
+     * @description Inserts the rows produced by a SELECT (or a CTE feeding one) into the table.
+     * @param targetColumns - Optional destination model columns; positional when omitted
+     * @param source - A model builder (or callback) whose SELECT becomes the insert source
+     * @returns InsertWriteOperation, so `onConflict(...).merge()/.ignore()` chains onto it
+     * @warning Rows come from the database, so no validation, hooks or autoCreate columns run
+     */
+    insertFrom(source: ModelQueryBuilder<any> | ((qb: ModelQueryBuilder<any>) => ModelQueryBuilder<any> | void)): InsertWriteOperation<T[]>;
+    insertFrom<C extends ModelKey<T>>(targetColumns: C[], source: ModelQueryBuilder<any> | ((qb: ModelQueryBuilder<any>) => ModelQueryBuilder<any> | void)): InsertWriteOperation<T[]>;
     /**
      * @description Upserts a record (insert or update on conflict).
      */
@@ -7017,8 +7146,9 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
     }): Promise<void>;
     /**
      * @description Truncates the table by deleting all records.
+     * @param options - `RESTART IDENTITY` / `CONTINUE IDENTITY` / `CASCADE` (PostgreSQL and CockroachDB only)
      */
-    truncate(): WriteOperation<void>;
+    truncate(options?: TruncateOptions): WriteOperation<void>;
     /**
      * @description Updates records matching the current query conditions.
      * @param data - The columns and values to update.
@@ -7026,7 +7156,7 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
      * @param options.returning - Columns to return from updated rows. Only supported on PostgreSQL, CockroachDB, SQLite, and MSSQL. Not available on MySQL or MariaDB.
      * @returns WriteOperation resolving to the number of affected rows, or the returned columns if `returning` is specified (supported databases only).
      */
-    update<const Ret extends ReturningParam<T, D> = never[]>(data: Partial<ModelWithoutRelations<T>>, options?: UpdateOptions & {
+    update<const Ret extends ReturningParam<T, D> = never[]>(data: ModelWriteData<T>, options?: UpdateOptions & {
         returning?: Ret;
     }): WriteOperation<MutationReturningResult<T, Ret>>;
     softDelete(options?: SoftDeleteOptions<T>): WriteOperation<number>;
@@ -9162,7 +9292,7 @@ declare abstract class BaseSeeder {
     abstract run(): Promise<void>;
 }
 
-type HysteriaErrorCode = "VALIDATION_ERROR" | "CONNECTION_ALREADY_ESTABLISHED" | `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_STRENGTH_NOT_SUPPORTED_IN_${string}` | "QUERY_TIMEOUT" | `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" | "NOT_MATERIALIZED_CTE_NOT_SUPPORTED" | "USING_REQUIRES_JOIN" | "USING_NOT_SUPPORTED_IN_MSSQL" | "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" | "ORDER_BY_REQUIRED" | "ORDER_BY_RAW_NOT_SUPPORTED" | "INVALID_SQL_COMMENT" | "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" | `BETTER_AUTH_MISSING_ID_${string}` | `BETTER_AUTH_INVALID_INCREMENT_${string}` | "ZOD_ENGINE_NOT_LOADED" | "ATOMIC_DATASOURCE_RESOLUTION_FAILED" | "ATOMIC_INVALID_METHOD" | "ATOMIC_CLS_DISABLED" | `SCOPE_NOT_FOUND_${string}`;
+type HysteriaErrorCode = "VALIDATION_ERROR" | "CONNECTION_ALREADY_ESTABLISHED" | `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_STRENGTH_NOT_SUPPORTED_IN_${string}` | "QUERY_TIMEOUT" | `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" | "NOT_MATERIALIZED_CTE_NOT_SUPPORTED" | "USING_REQUIRES_JOIN" | "USING_NOT_SUPPORTED_IN_MSSQL" | "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" | "ORDER_BY_REQUIRED" | "ORDER_BY_RAW_NOT_SUPPORTED" | "INVALID_SQL_COMMENT" | "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" | `BETTER_AUTH_MISSING_ID_${string}` | `BETTER_AUTH_INVALID_INCREMENT_${string}` | "ZOD_ENGINE_NOT_LOADED" | "ATOMIC_DATASOURCE_RESOLUTION_FAILED" | "ATOMIC_INVALID_METHOD" | "ATOMIC_CLS_DISABLED" | `SCOPE_NOT_FOUND_${string}` | "ON_CONFLICT_REQUIRES_MERGE_OR_IGNORE" | "MERGE_REQUIRES_ON_CONFLICT" | "ON_CONFLICT_COLUMNS_REQUIRED" | "JOIN_NOT_SUPPORTED_ON_WRITE" | "ORDER_BY_LIMIT_NOT_SUPPORTED_ON_WRITE" | "SELECT_ONLY_CLAUSE_ON_WRITE" | "CTE_NOT_SUPPORTED_ON_INSERT" | "CTE_NOT_SUPPORTED_ON_TRUNCATE" | "CTE_NOT_SUPPORTED_ON_WRITE" | "TRUNCATE_OPTION_NOT_SUPPORTED" | "UPDATE_REQUIRES_COLUMNS";
 
 declare class HysteriaError extends Error {
     code: HysteriaErrorCode;
@@ -9325,4 +9455,4 @@ type BetterAuthAdapterConfig = Partial<Pick<AdapterFactoryConfig, "usePlural" |
  */
 declare function betterAuthAdapter(sql: SqlDataSource, config?: BetterAuthAdapterConfig): (options: BetterAuthOptions) => DBAdapter;
 
-export { type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AllowedDrivers, type AnyModelConstructor, type AnySqlDataSourceInput, type AtomicOptions, type BaseModelMethodOptions, BaseSeeder, type BeginTransactionOptions, type BetterAuthAdapterConfig, type BuildSelectType, type BuildSingleSelectType, type BuiltinDriverName, type CacheAdapter, type CacheKeys, ClientMigrator, type ColCharOptions, type ColComputedOptions, type ColJsonbOptions, type ColMediumIntOptions, type ColSmallIntOptions, type ColTinyIntOptions, type ColVarbinaryOptions, Collection, type CollectionDefinition, type ColumnDef, type CommonDataSourceInput, type ComposeBuildSelect, type ComposeSelect, type ComputedColumnDef, type ConnectionPolicies, type CreateSchemaResult, type CustomLogger, type DataSourceInput, type DataSourceType, type DateAutoHook, type DefinedCollection, type DefinedModel, type DefinedView, type DriverAdapter, type DriverAdapterFactory, type DriverAdapterFactoryContext, type EndTransactionOptions, type ExcludeMethods, type ExecuteOptions, type ExtractColumnName, type ExtractSourceColumn, type FindReturnType, type GetColumnType, type GetConnectionReturnType, HysteriaError, type HysteriaErrorCode, InMemoryAdapter, type InferPK, type IntrospectedColumn, type IntrospectedForeignKey, type IntrospectedSchema, type IntrospectedTable, type JsEnvironmentValue, type JsonPathInput, type JsonPaths, type LoadOptions, type LoggerConfig, 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 ModelStream, type ModelWithoutRelations, type ModelsProxy, MongoDataSource, type MongoDataSourceInput$1 as MongoDataSourceInput, type MssqlComment, type MssqlConnectionInstance, type MssqlDataSourceInput, type MssqlPoolInstance, type MutationReturningResult, type MySqlComment, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullableOracleMssqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NullableColumn, type NumberModelKey, ObserverChain, ObserverChainWrapper, type Operation, type PgComment, type PgPoolClientInstance, type PingResult, type PlatformAdapter, type PlatformFs, type PlatformPath, PlatformUnsupportedError, 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 ResolvedJsEnvironment, 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, type SqlComment, SqlDataSource, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDriverSpecificOptions, SqlFuncNode, type SqlFuncRenderer, type SqlHint, type SqlPoolType, type Sqlite3ConnectionOptions, type SqliteComment, 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, atomic, betterAuthAdapter, col, createSchema, defineCollection, defineMigrator, defineModel, defineModelFactory, defineRelations, defineView, deriveOperationFromQuery, email, enumValidator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, type getPoolReturnType, loadPlatform, HysteriaLogger as logger, max, maxLength, min, minLength, pattern, prop, RedisDataSource as redis, registerDriverAdapter, registerSqlFuncRenderer, required, sqlFunc, url };
+export { type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AllowedDrivers, type AnyModelConstructor, type AnySqlDataSourceInput, type AtomicOptions, type BaseModelMethodOptions, BaseSeeder, type BeginTransactionOptions, type BetterAuthAdapterConfig, type BuildSelectType, type BuildSingleSelectType, type BuiltinDriverName, type CacheAdapter, type CacheKeys, ClientMigrator, type ColCharOptions, type ColComputedOptions, type ColJsonbOptions, type ColMediumIntOptions, type ColSmallIntOptions, type ColTinyIntOptions, type ColVarbinaryOptions, Collection, type CollectionDefinition, type ColumnDef, type CommonDataSourceInput, type ComposeBuildSelect, type ComposeSelect, type ComputedColumnDef, type ConnectionPolicies, type CreateSchemaResult, type CustomLogger, type DataSourceInput, type DataSourceType, type DateAutoHook, type DefinedCollection, type DefinedModel, type DefinedView, type DriverAdapter, type DriverAdapterFactory, type DriverAdapterFactoryContext, type EndTransactionOptions, type ExcludeMethods, type ExecuteOptions, type ExtractColumnName, type ExtractSourceColumn, type FindReturnType, type GetColumnType, type GetConnectionReturnType, HysteriaError, type HysteriaErrorCode, InMemoryAdapter, type InferPK, type InsertConflictConfig, type InsertConflictMode, InsertWriteOperation, type IntrospectedColumn, type IntrospectedForeignKey, type IntrospectedSchema, type IntrospectedTable, type JsEnvironmentValue, type JsonMutationFor, type JsonPathInput, type JsonPaths, type LoadOptions, type LoggerConfig, 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 ModelStream, type ModelWithoutRelations, type ModelWriteData, type ModelsProxy, MongoDataSource, type MongoDataSourceInput$1 as MongoDataSourceInput, type MssqlComment, type MssqlConnectionInstance, type MssqlDataSourceInput, type MssqlPoolInstance, type MutationReturningResult, type MySqlComment, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullableOracleMssqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NullableColumn, type NumberModelKey, ObserverChain, ObserverChainWrapper, type Operation, type PgComment, type PgPoolClientInstance, type PingResult, type PlatformAdapter, type PlatformFs, type PlatformPath, PlatformUnsupportedError, 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 ResolvedJsEnvironment, 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, type SqlComment, SqlDataSource, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDriverSpecificOptions, SqlFuncNode, type SqlFuncRenderer, type SqlHint, type SqlPoolType, type Sqlite3ConnectionOptions, type SqliteComment, 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, atomic, betterAuthAdapter, col, createSchema, defineCollection, defineMigrator, defineModel, defineModelFactory, defineRelations, defineView, deriveOperationFromQuery, email, enumValidator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, type getPoolReturnType, loadPlatform, HysteriaLogger as logger, max, maxLength, min, minLength, pattern, prop, RedisDataSource as redis, registerDriverAdapter, registerSqlFuncRenderer, required, sqlFunc, url };