hysteria-orm 11.0.1 → 11.0.2

package/lib/index.d.cts

@@ -1,3 +1,4 @@
+import { PassThrough } from 'node:stream';
 import * as mssql from 'mssql';
 import { config, Transaction as Transaction$1, IResult } from 'mssql';
 import * as mysql2_promise from 'mysql2/promise';
@@ -12,9 +13,8 @@ import { Collection as Collection$1 } from 'mongodb';
 import * as sqlite3 from 'sqlite3';
 import { RunResult } from 'sqlite3';
 import { RedisOptions, Redis } from 'ioredis';
-import { PassThrough } from 'node:stream';
 
-type CaseConvention = "camel" | "snake" | "preserve" | RegExp | ((column: string) => string);
+type CaseConvention = "camel" | "snake" | "pascal" | "preserve" | RegExp | ((column: string) => string);
 
 type CommonConstraintOptions = {
     constraintName?: string;
@@ -162,13 +162,6 @@ type DateTimeOptions = {
  */
 type DatabaseTableOptions = MysqlTableOptions | PostgresTableOptions | SqliteTableOptions | MssqlTableOptions | OracledbTableOptions | MysqlAdvancedTableOptions;
 
-/**
- * Simplifies complex return types like SelectedModel to make it more readable and strips out whatever is passed as the second type parameter (e.g. SELECT_BRAND) to avoid showing it in the IDE autocomplete.
- */
-type Simplify<T, Strip> = T extends infer U ? {
-    [K in keyof U as K extends Strip ? never : K]: U[K];
-} : never;
-
 declare abstract class QueryNode {
     /**
      * Sql keyword to use for the query e.g. "select"
@@ -939,6 +932,17 @@ type SlaveAlgorithm = "roundRobin" | "random";
 type RawQueryOptions = {
     replicationMode?: ReplicationType;
 };
+/**
+ * @description Result of a health check ping operation
+ */
+type PingResult = {
+    /** Whether the ping was successful */
+    ok: boolean;
+    /** Latency in milliseconds */
+    latencyMs: number;
+    /** Database dialect/type */
+    dialect: SqlDataSourceType;
+};
 
 type OpenApiModelType = {
     type: "object";
@@ -1800,6 +1804,44 @@ declare class SchemaBuilder implements PromiseLike<void> {
     hasFailed(): boolean;
 }
 
+interface IntrospectedColumn {
+    name: string;
+    type: string;
+    nullable: boolean;
+    default?: string | null;
+    length?: number;
+    isPrimaryKey?: boolean;
+    isForeignKey?: boolean;
+    references?: {
+        table: string;
+        column: string;
+    };
+}
+interface IntrospectedForeignKey {
+    column: string;
+    references: {
+        table: string;
+        column: string;
+    };
+    onDelete?: string;
+    onUpdate?: string;
+}
+interface IntrospectedTable {
+    name: string;
+    columns: IntrospectedColumn[];
+    primaryKeys?: string[];
+    foreignKeys?: IntrospectedForeignKey[];
+    indices?: {
+        name: string;
+        columns: string[];
+        unique?: boolean;
+    }[];
+}
+interface IntrospectedSchema {
+    dialect: string;
+    tables: IntrospectedTable[];
+}
+
 type AstParserType = {
     sql: string;
     bindings: any[];
@@ -1974,81 +2016,6 @@ declare class ModelManager<T extends Model> {
     private applyFieldCondition;
 }
 
-type JsonPathInput = string | (string | number)[];
-/**
- * Recursively generates all valid dot-separated JSON path strings from an
- * object type `T`.
- *
- * Handles nested objects, arrays (via numeric indices), and stops recursion at
- * a configurable depth (default 5) to prevent infinite expansion with deeply
- * nested or self-referential types.
- *
- * @typeParam T - The root object type to extract paths from.
- *
- * @example
- * ```ts
- * type Data = { user: { name: string; roles: string[] }; count: number };
- * type P = JsonPaths<Data>;
- * // "user" | "user.name" | "user.roles" | "user.roles.${number}" | "count"
- * ```
- */
-type JsonPaths<T, Depth extends number[] = []> = Depth["length"] extends 5 ? never : T extends readonly (infer E)[] ? `${number}` | (NonNullable<E> extends object ? `${number}.${JsonPaths<NonNullable<E>, [...Depth, 1]>}` : never) : T extends object ? {
-    [K in keyof T & string]: K | (NonNullable<T[K]> extends object ? `${K}.${JsonPaths<NonNullable<T[K]>, [...Depth, 1]>}` : never);
-}[keyof T & string] : never;
-/**
- * Resolves the TypeScript type of a model column given its `ModelKey` string.
- * Strips any table prefix (e.g. `"users.metadata"` → `"metadata"`) before
- * indexing into the model.
- *
- * @typeParam T - The Model instance type.
- * @typeParam K - The column key (plain or table-prefixed).
- */
-type ResolveColumnType<T extends Model, K extends string> = T[StripTablePrefix<K> & keyof T];
-/**
- * Type-safe JSON path input that provides IDE autocompletion for known JSON
- * column structures while still accepting arbitrary strings as a fallback.
- *
- * - When `ColumnType` is a known object/array type: suggests all valid
- *   dot-separated paths via {@link JsonPaths}, plus `(string & {})` as a
- *   catch-all and `(string | number)[]` for the array form.
- * - When `ColumnType` is `unknown`, a primitive, or `never`: falls back to the
- *   original untyped {@link JsonPathInput}.
- *
- * Uses the `SpecificLiteral | (string & {})` pattern so TypeScript's
- * autocomplete shows the known paths first without blocking custom strings.
- *
- * @typeParam ColumnType - The TypeScript type of the JSON column value.
- *
- * @example
- * ```ts
- * type Settings = { theme: string; notifications: { email: boolean } };
- * type P = TypedJsonPathInput<Settings | null>;
- * // "theme" | "notifications" | "notifications.email" | (string & {}) | (string | number)[]
- * ```
- */
-/**
- * Resolves the TypeScript type at a given dot-separated JSON path within a
- * root type. Handles `$` prefix, dot notation, and array numeric indices.
- *
- * Falls back to `unknown` when the path does not match the type structure.
- *
- * @typeParam T - The root JSON object type to traverse.
- * @typeParam Path - A dot-separated string path.
- *
- * @example
- * ```ts
- * type Data = { user: { name: string; roles: string[] } };
- * type A = ResolveJsonPathType<Data, "user.name">;    // string
- * type B = ResolveJsonPathType<Data, "user.roles">;   // string[]
- * type C = ResolveJsonPathType<Data, "user">;          // { name: string; roles: string[] }
- * type D = ResolveJsonPathType<Data, "$">;             // Data
- * ```
- */
-type ResolveJsonPathType<T, Path extends string> = Path extends `$.${infer Rest}` ? ResolveJsonPathType<T, Rest> : Path extends "$" | "" ? T : Path extends `${infer Head}.${infer Rest}` ? Head extends keyof NonNullable<T> ? ResolveJsonPathType<NonNullable<T>[Head], Rest> : NonNullable<T> extends readonly (infer E)[] ? Head extends `${number}` ? ResolveJsonPathType<E, Rest> : unknown : unknown : Path extends keyof NonNullable<T> ? NonNullable<T>[Path] : NonNullable<T> extends readonly (infer E)[] ? Path extends `${number}` ? E : unknown : unknown;
-type TypedJsonPathInput<ColumnType> = [NonNullable<ColumnType>] extends [
-    never
-] ? JsonPathInput : unknown extends NonNullable<ColumnType> ? JsonPathInput : NonNullable<ColumnType> extends object ? JsonPaths<NonNullable<ColumnType>> | (string & {}) | (string | number)[] : JsonPathInput;
-
 declare class DeleteNode extends QueryNode {
     fromNode: FromNode;
     returning?: string[];
@@ -2587,6 +2554,19 @@ declare class MongoDataSource extends DataSource {
     }): CollectionManager<T>;
     from(collectionName: string): MongoQueryBuilder<Collection>;
     getModelManager<T extends Collection>(model: typeof Collection, mongoDataSource: MongoDataSource, session?: InstanceType<MongoClientImport["ClientSession"]>): CollectionManager<T>;
+    /**
+     * @description Executes a lightweight health check ping
+     * @returns Promise resolving to PingResult with ok status, latency in ms, and dialect 'mongo'
+     */
+    ping(): Promise<{
+        ok: boolean;
+        latencyMs: number;
+        dialect: "mongo";
+    }>;
+    /**
+     * @description Returns true if the MongoDB connection is healthy, false on error (never throws)
+     */
+    isHealthy(): Promise<boolean>;
 }
 
 type MongoCollectionKey<T> = T extends Collection ? T : never;
@@ -2651,129 +2631,369 @@ declare class WhereGroupNode extends QueryNode {
     constructor(nodes: (WhereNode | WhereGroupNode | WhereSubqueryNode)[], chainsWith?: "and" | "or");
 }
 
-declare class DistinctNode extends QueryNode {
-    chainsWith: string;
-    canKeywordBeSeenMultipleTimes: boolean;
-    folder: string;
-    file: string;
-    constructor();
-}
-
-declare class DistinctOnNode extends QueryNode {
-    columns: string[];
-    chainsWith: string;
-    canKeywordBeSeenMultipleTimes: boolean;
-    folder: string;
-    file: string;
-    constructor(columns: string[]);
-}
-
-declare class SelectNode extends QueryNode {
-    column: string | QueryNode | QueryNode[];
-    alias?: string;
-    sqlFunction?: string;
-    chainsWith: string;
-    canKeywordBeSeenMultipleTimes: boolean;
-    folder: string;
-    file: string;
-    constructor(column: string | QueryNode | QueryNode[], alias?: string, sqlFunction?: string, isRaw?: boolean);
-}
-
-declare class JoinNode extends QueryNode {
-    table: string;
-    left: string;
-    right: string;
-    on?: {
-        left?: string;
-        right?: string;
-        operator: string;
-    };
-    chainsWith: string;
-    canKeywordBeSeenMultipleTimes: boolean;
-    folder: string;
-    file: string;
-    type: "inner" | "left" | "right" | "full" | "cross" | "natural";
-    additionalConditions?: (WhereNode | WhereGroupNode | WhereSubqueryNode)[];
-    constructor(table: string, left: string, right: string, type: "inner" | "left" | "right" | "full" | "cross" | "natural" | undefined, on: {
-        left?: string;
-        right?: string;
-        operator: string;
-    }, isRawValue?: boolean, additionalConditions?: (WhereNode | WhereGroupNode | WhereSubqueryNode)[]);
-}
-
-declare class GroupByNode extends QueryNode {
-    column: string;
-    chainsWith: string;
-    canKeywordBeSeenMultipleTimes: boolean;
-    folder: string;
-    file: string;
-    constructor(column: string, isRawValue?: boolean);
-}
-
-declare class LimitNode extends QueryNode {
-    limit: number;
-    chainsWith: string;
-    canKeywordBeSeenMultipleTimes: boolean;
-    folder: string;
-    file: string;
-    constructor(limit: number);
-}
-
-declare class OffsetNode extends QueryNode {
-    offset: number;
-    chainsWith: string;
-    canKeywordBeSeenMultipleTimes: boolean;
-    folder: string;
-    file: string;
-    constructor(offset: number);
-}
-
-declare class OrderByNode extends QueryNode {
-    column: string;
-    direction: "asc" | "desc";
-    chainsWith: string;
-    canKeywordBeSeenMultipleTimes: boolean;
-    folder: string;
-    file: string;
-    constructor(column: string, direction?: "asc" | "desc", isRawValue?: boolean);
-}
-
-type DateFormat = "ISO" | "TIMESTAMP" | "DATE_ONLY" | "TIME_ONLY";
-type Timezone = "UTC" | "LOCAL";
+/**
+ * Simplifies complex return types like SelectedModel to make it more readable and strips out whatever is passed as the second type parameter (e.g. SELECT_BRAND) to avoid showing it in the IDE autocomplete.
+ */
+type Simplify<T, Strip> = T extends infer U ? {
+    [K in keyof U as K extends Strip ? never : K]: U[K];
+} : never;
 
+type PluckReturnType<T extends Model, K extends RawModelKey<T>> = T[StripTablePrefix<K & string> & keyof T] extends infer U ? U[] : never;
 /**
- * @description Options for the relation
- * @property {string} softDeleteColumn - The column name for the soft delete column, if set, the relation will only return rows that have not been soft deleted
- * @property {string} softDeleteType - The type of the soft delete column
+ * Common SQL functions with intellisense support.
+ * Provides autocomplete for standard SQL aggregate and scalar functions,
+ * while still allowing any custom function name via string fallback.
+ *
+ * @example
+ * selectFunc("count", "*", "total")     // Intellisense suggests "count"
+ * selectFunc("custom_fn", "col", "res") // Custom functions still work
  */
-declare enum RelationEnum {
-    hasOne = "hasOne",// One to One without foreign key
-    belongsTo = "belongsTo",// One to One with foreign key
-    hasMany = "hasMany",
-    manyToMany = "manyToMany"
-}
+type SqlFunction = "count" | "sum" | "avg" | "min" | "max" | "upper" | "lower" | "length" | "trim" | "abs" | "round" | "coalesce" | "ceil" | "floor" | "sqrt" | (string & {});
 /**
- * Main Relation Class
+ * Maps SQL function names to their return types.
+ * Used by selectFunc to auto-infer the result type.
+ *
+ * - Numeric functions (count, sum, avg, etc.) → number
+ * - String functions (upper, lower, trim) → string
+ * - Unknown functions → any
  */
-declare abstract class Relation {
-    abstract type: RelationEnum;
-    model: typeof Model;
-    columnName: string;
-    foreignKey?: string;
-    relatedModel: string;
-    protected constructor(model: typeof Model, columnName: string);
-}
-
-type BaseColumnDataType = Exclude<keyof CreateTableBuilder, "enum" | "rawColumn" | "custom">;
+type SqlFunctionReturnType<F extends string> = F extends "count" | "sum" | "avg" | "min" | "max" | "length" | "abs" | "round" | "ceil" | "floor" | "sqrt" ? number : F extends "upper" | "lower" | "trim" ? string : any;
 /**
- * Column data type - supports built-in types with intellisense and custom string types.
- * Built-in types get autocomplete, custom types pass through as-is for extensions like pgvector.
+ * A tuple type for selecting a column with an alias.
+ * @example ["id", "userId"] selects "id" column as "userId"
+ */
+type SelectTuple<C extends string = string, A extends string = string> = readonly [column: C, alias: A];
+/**
+ * Input type for select() method in raw query builder.
+ * Accepts either a column string or a [column, alias] tuple.
+ *
  * @example
- * col<string>({ type: "varchar", length: 255 }) // built-in
- * col<string>({ type: "vector", length: 1536 })  // custom (pgvector)
+ * .select("id", "name")                    // Simple columns
+ * .select(["id", "userId"], ["name", "n"]) // Columns with aliases
+ * .select("id", ["name", "userName"])      // Mixed
  */
-type ColumnDataType = BaseColumnDataType | (string & {}) | readonly string[];
-type ColumnDataTypeOptionWithLength = {
+type Selectable = string | SelectTuple;
+/**
+ * Unique symbol used internally to mark that a raw select() has been called.
+ */
+declare const RAW_SELECT_BRAND: unique symbol;
+/**
+ * Marker type to indicate that a raw select() has been called.
+ * @internal
+ */
+type RawSelectBrand = {
+    [RAW_SELECT_BRAND]?: never;
+};
+/**
+ * Utility type to convert a union to an intersection.
+ * @internal
+ */
+type UnionToIntersection$1<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+/**
+ * Extracts the final property name from a column selection for raw queries.
+ * Supports both string columns and [column, alias] tuples.
+ *
+ * | Input                        | Output        |
+ * |------------------------------|---------------|
+ * | `"name"`                     | `"name"`      |
+ * | `"users.name"`               | `"name"`      |
+ * | `["name", "userName"]`       | `"userName"`  |
+ * | `["users.id", "id"]`         | `"id"`        |
+ * | `"*"`                        | `never`       |
+ * | `"users.*"`                  | `never`       |
+ */
+type ExtractRawColumnName<S> = S extends readonly [
+    string,
+    infer Alias extends string
+] ? Alias : S extends string ? S extends "*" ? never : S extends `${string}.*` ? never : S extends `${string}.${infer Column}` ? Column extends "*" ? never : Column : S : never;
+/**
+ * Builds the type for a single selected column in a raw query.
+ * All column types are `any` since we don't have model type information.
+ * Supports both string columns and [column, alias] tuples.
+ *
+ * | Selection              | Result Type                           |
+ * |------------------------|---------------------------------------|
+ * | `"*"`                  | `Record<string, any>`                 |
+ * | `"table.*"`            | `Record<string, any>`                 |
+ * | `"column"`             | `{ column: any }`                     |
+ * | `["col", "alias"]`     | `{ alias: any }`                      |
+ *
+ * @internal
+ */
+type BuildRawSingleSelectType<S> = S extends readonly [
+    string,
+    infer Alias extends string
+] ? {
+    [K in Alias]: any;
+} : S extends string ? S extends "*" ? Record<string, any> : S extends `${string}.*` ? Record<string, any> : ExtractRawColumnName<S> extends never ? {} : {
+    [K in ExtractRawColumnName<S> & string]: any;
+} : {};
+/**
+ * Checks if a column selection includes wildcards or is empty.
+ * @internal
+ */
+type HasRawStarOrEmpty<Columns extends readonly Selectable[]> = Columns["length"] extends 0 ? true : "*" extends Columns[number] ? true : false;
+/**
+ * Builds the combined TypeScript type for multiple selected columns in a raw query.
+ * Supports both string columns and [column, alias] tuples.
+ *
+ * ## Rules
+ *
+ * 1. **Empty selection or `*`**: Returns `Record<string, any>`
+ * 2. **Specific columns**: Returns intersection of all selected column types (all `any`)
+ * 3. **With `table.*`**: Adds `Record<string, any>` to allow unknown properties
+ *
+ * @example
+ * // .select("name", ["age", "userAge"])
+ * BuildRawSelectType<["name", ["age", "userAge"]]>
+ * // Result: { name: any; userAge: any } & RawSelectBrand
+ *
+ * @example
+ * // .select("*")
+ * BuildRawSelectType<["*"]>
+ * // Result: Record<string, any>
+ */
+type BuildRawSelectType<Columns extends readonly Selectable[]> = HasRawStarOrEmpty<Columns> extends true ? Record<string, any> : UnionToIntersection$1<{
+    [K in keyof Columns]: BuildRawSingleSelectType<Columns[K]>;
+}[number]> extends infer Result ? Result extends Record<string, any> ? keyof Result extends never ? Record<string, any> : Result & RawSelectBrand : Record<string, any> : Record<string, any>;
+/**
+ * Composes a new selection with the existing selection state for raw queries.
+ *
+ * - If S is the default Record<string, any> (no previous select), returns just the new selection
+ * - If S is a typed selection from a prior select/selectRaw, composes with new selection
+ *
+ * Detection uses `string extends keyof S`: true for untyped `Record<string, any>`, false for any
+ * specific typed record (e.g. `{ userName: any }`). This avoids relying on the RAW_SELECT_BRAND
+ * symbol, which gets stripped by Simplify in intermediate types.
+ *
+ * @typeParam S - Current selection state
+ * @typeParam Added - New fields being added by the select
+ *
+ * @example
+ * // First selectRaw - creates new selection
+ * ComposeRawSelect<Record<string, any>, { count: number }>
+ * // Result: { count: number }
+ *
+ * @example
+ * // Chained after select - composes with previous
+ * ComposeRawSelect<{ userName: any }, { nameLength: number }>
+ * // Result: { userName: any; nameLength: number }
+ */
+type ComposeRawSelect<S extends Record<string, any>, Added extends Record<string, any>> = Simplify<(string extends keyof S ? RawSelectBrand : S) & Added, typeof RAW_SELECT_BRAND>;
+/**
+ * Composes a BuildRawSelectType result with the existing selection state.
+ *
+ * Similar to ComposeRawSelect but designed for use with BuildRawSelectType.
+ *
+ * @typeParam S - Current selection state
+ * @typeParam Columns - The columns being selected
+ */
+type ComposeBuildRawSelect<S extends Record<string, any>, Columns extends readonly Selectable[]> = Simplify<(string extends keyof S ? {} : S) & BuildRawSelectType<Columns>, typeof RAW_SELECT_BRAND>;
+type WhereOnlyQueryBuilder<T extends Model> = Pick<WhereQueryBuilder<T>, "where" | "andWhere" | "orWhere" | "whereNot" | "andWhereNot" | "orWhereNot" | "whereIn" | "andWhereIn" | "orWhereIn" | "whereNotIn" | "andWhereNotIn" | "orWhereNotIn" | "whereBetween" | "andWhereBetween" | "orWhereBetween" | "whereNotBetween" | "andWhereNotBetween" | "orWhereNotBetween" | "whereNull" | "andWhereNull" | "orWhereNull" | "whereNotNull" | "andWhereNotNull" | "orWhereNotNull" | "whereLike" | "andWhereLike" | "orWhereLike" | "whereILike" | "andWhereILike" | "orWhereILike" | "whereNotLike" | "andWhereNotLike" | "orWhereNotLike" | "whereNotILike" | "andWhereNotILike" | "orWhereNotILike" | "whereRegexp" | "andWhereRegexp" | "orWhereRegexp" | "whereNotRegexp" | "andWhereNotRegexp" | "orWhereNotRegexp" | "whereRaw" | "andWhereRaw" | "orWhereRaw" | "whereExists" | "orWhereExists" | "andWhereExists" | "whereNotExists" | "orWhereNotExists" | "andWhereNotExists" | "whereColumn" | "andWhereColumn" | "orWhereColumn"> & Pick<JsonQueryBuilder<T>, "whereJson" | "andWhereJson" | "orWhereJson" | "whereJsonContains" | "andWhereJsonContains" | "orWhereJsonContains" | "whereJsonNotContains" | "andWhereJsonNotContains" | "orWhereJsonNotContains" | "whereJsonNotContains" | "andWhereJsonNotContains" | "orWhereJsonNotContains" | "whereJsonRaw" | "andWhereJsonRaw" | "orWhereJsonRaw" | "whereJsonNotContains" | "andWhereJsonNotContains" | "orWhereJsonNotContains">;
+type RelationRetrieveMethod<P> = NonNullable<P> extends any[] ? "many" : "one";
+/**
+ * Validates a column string for raw query builder select().
+ * Use [column, alias] tuple format for aliases instead of "column as alias".
+ * Use selectFunction() for SQL functions instead of embedding them in select().
+ */
+type SelectableColumn$1<T extends string = string> = T extends `${string}.${string}.${string}` ? never : T extends `${string} ${string}` ? never : T extends `.${string}` | `${string}.` ? never : T extends `${string}-${string}` ? never : T extends `${string}.${string}` ? T : T;
+/**
+ * @description A column that can be used in a join statement e.g. `users.id`
+ */
+type JoinableColumn = `${string}.${string}`;
+/**
+ * @description Options for streaming queries
+ * @sqlite Ignores the options below
+ */
+type StreamOptions = {
+    highWaterMark?: number;
+    /** Postgres only */
+    rowMode?: "array";
+    /** Postgres only */
+    batchSize?: number;
+    /** Postgres only */
+    types?: any;
+    /** Mysql only */
+    objectMode?: boolean;
+};
+type Cursor<T extends Model, K extends ModelKey<T>> = {
+    key: K;
+    value: string | number;
+};
+type PaginateWithCursorOptions<T extends Model, K extends ModelKey<T>> = {
+    discriminator: K;
+    operator?: "<" | ">";
+    orderBy?: "asc" | "desc";
+};
+type UpsertOptionsRawBuilder = {
+    updateOnConflict?: boolean;
+    returning?: readonly string[];
+};
+type WriteQueryParam = string | number | boolean | Date | RawNode | object | null | undefined;
+/**
+ * Simple paginated data type for raw query builders (without Model constraint)
+ */
+type RawPaginatedData<S extends Record<string, any>> = {
+    paginationMetadata: {
+        perPage: number;
+        currentPage: number;
+        firstPage: number;
+        isEmpty: boolean;
+        total: number;
+        lastPage: number;
+        hasMorePages: boolean;
+        hasPages: boolean;
+    };
+    data: S[];
+};
+/**
+ * Simple cursor paginated data type for raw query builders (without Model constraint)
+ */
+type RawCursorPaginatedData<S extends Record<string, any>> = {
+    paginationMetadata: {
+        perPage: number;
+        firstPage: number;
+        isEmpty: boolean;
+        total: number;
+    };
+    data: S[];
+};
+
+declare class DistinctNode extends QueryNode {
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor();
+}
+
+declare class DistinctOnNode extends QueryNode {
+    columns: string[];
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(columns: string[]);
+}
+
+declare class SelectNode extends QueryNode {
+    column: string | QueryNode | QueryNode[];
+    alias?: string;
+    sqlFunction?: string;
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(column: string | QueryNode | QueryNode[], alias?: string, sqlFunction?: string, isRaw?: boolean);
+}
+
+declare class JoinNode extends QueryNode {
+    table: string;
+    left: string;
+    right: string;
+    on?: {
+        left?: string;
+        right?: string;
+        operator: string;
+    };
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    type: "inner" | "left" | "right" | "full" | "cross" | "natural";
+    additionalConditions?: (WhereNode | WhereGroupNode | WhereSubqueryNode)[];
+    constructor(table: string, left: string, right: string, type: "inner" | "left" | "right" | "full" | "cross" | "natural" | undefined, on: {
+        left?: string;
+        right?: string;
+        operator: string;
+    }, isRawValue?: boolean, additionalConditions?: (WhereNode | WhereGroupNode | WhereSubqueryNode)[]);
+}
+
+declare class GroupByNode extends QueryNode {
+    column: string;
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(column: string, isRawValue?: boolean);
+}
+
+declare class LimitNode extends QueryNode {
+    limit: number;
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(limit: number);
+}
+
+declare class OffsetNode extends QueryNode {
+    offset: number;
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(offset: number);
+}
+
+declare class OrderByNode extends QueryNode {
+    column: string;
+    direction: "asc" | "desc";
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(column: string, direction?: "asc" | "desc", isRawValue?: boolean);
+}
+
+type DateFormat = "ISO" | "TIMESTAMP" | "DATE_ONLY" | "TIME_ONLY";
+type Timezone = "UTC" | "LOCAL";
+
+/**
+ * @description Options for the relation
+ * @property {string} softDeleteColumn - The column name for the soft delete column, if set, the relation will only return rows that have not been soft deleted
+ * @property {string} softDeleteType - The type of the soft delete column
+ */
+declare enum RelationEnum {
+    hasOne = "hasOne",// One to One without foreign key
+    belongsTo = "belongsTo",// One to One with foreign key
+    hasMany = "hasMany",
+    manyToMany = "manyToMany"
+}
+/**
+ * Main Relation Class
+ */
+declare abstract class Relation {
+    abstract type: RelationEnum;
+    model: typeof Model;
+    columnName: string;
+    foreignKey?: string;
+    relatedModel: string;
+    protected constructor(model: typeof Model, columnName: string);
+}
+
+type ValidationResult = {
+    valid: boolean;
+    message?: string;
+};
+type ValidationContext = {
+    model: any;
+    column: string;
+    operation: "insert" | "update";
+    data: any;
+};
+type Validator = (value: any, context: ValidationContext) => ValidationResult | Promise<ValidationResult>;
+
+type BaseColumnDataType = Exclude<keyof CreateTableBuilder, "enum" | "rawColumn" | "custom">;
+/**
+ * Column data type - supports built-in types with intellisense and custom string types.
+ * Built-in types get autocomplete, custom types pass through as-is for extensions like pgvector.
+ * @example
+ * col<string>({ type: "varchar", length: 255 }) // built-in
+ * col<string>({ type: "vector", length: 1536 })  // custom (pgvector)
+ */
+type ColumnDataType = BaseColumnDataType | (string & {}) | readonly string[];
+type ColumnDataTypeOptionWithLength = {
     type?: "char" | "varchar" | "string" | "uuid" | "ulid" | "varbinary" | "integer" | "tinyint" | "smallint" | "mediumint" | "bigint" | "increment" | "bigIncrement";
     length?: number;
 };
@@ -2947,6 +3167,10 @@ type ColumnOptions = {
      * @migration Only affects auto-generated migrations (CREATE TABLE / ALTER TABLE). Does NOT set a default value during insert operations — use `prepare` for that.
      */
     default?: string | number | null | boolean;
+    /**
+     * @description Per-column validators applied on insert/update
+     */
+    validate?: Validator | Validator[];
 } & 
 /**
  * @description The data type of the column
@@ -2976,6 +3200,7 @@ type ColumnType = {
         nullable?: boolean;
         default?: string | number | null | boolean;
     };
+    validate?: Validator | Validator[];
 };
 type IndexType = {
     columns: string[];
@@ -3022,7 +3247,7 @@ declare abstract class FooterQueryBuilder<T extends Model, S extends Record<stri
      * @description Adds a group by query
      */
     groupBy(...columns: ModelKey<T>[]): this;
-    groupBy<S extends string>(...columns: SelectableColumn<S>[]): this;
+    groupBy<S extends string>(...columns: SelectableColumn$1<S>[]): this;
     /**
      * @description Adds a raw group by query, GROUP BY clause is not necessary and will be added automatically
      */
@@ -3031,7 +3256,7 @@ declare abstract class FooterQueryBuilder<T extends Model, S extends Record<stri
      * @description Adds an order by query
      */
     orderBy(column: ModelKey<T>, order: OrderByChoices): this;
-    orderBy<S extends string>(column: SelectableColumn<S>, order: OrderByChoices): this;
+    orderBy<S extends string>(column: SelectableColumn$1<S>, order: OrderByChoices): this;
     /**
      * @description Adds a raw order by query, ORDER BY clause is not necessary and will be added automatically
      */
@@ -3058,180 +3283,180 @@ declare class JoinOnQueryBuilder {
     /**
      * @description Adds a WHERE condition to the query.
      */
-    where(column: SelectableColumn<string>, operator: BinaryOperatorType$2, value: BaseValues$2): this;
+    where(column: SelectableColumn$1<string>, operator: BinaryOperatorType$2, value: BaseValues$2): this;
     where(cb: (queryBuilder: JoinOnQueryBuilder) => void): this;
-    where(column: SelectableColumn<string>, value: BaseValues$2): this;
+    where(column: SelectableColumn$1<string>, value: BaseValues$2): this;
     /**
      * @description Adds an AND WHERE condition to the query.
      */
-    andWhere(column: SelectableColumn<string>, operator: BinaryOperatorType$2, value: BaseValues$2): this;
-    andWhere(column: SelectableColumn<string>, value: BaseValues$2): this;
+    andWhere(column: SelectableColumn$1<string>, operator: BinaryOperatorType$2, value: BaseValues$2): this;
+    andWhere(column: SelectableColumn$1<string>, value: BaseValues$2): this;
     andWhere(cb: (queryBuilder: JoinOnQueryBuilder) => void): this;
     /**
      * @description Adds an OR WHERE condition to the query.
      */
-    orWhere(column: SelectableColumn<string>, operator: BinaryOperatorType$2, value: BaseValues$2): this;
-    orWhere(column: SelectableColumn<string>, value: BaseValues$2): this;
+    orWhere(column: SelectableColumn$1<string>, operator: BinaryOperatorType$2, value: BaseValues$2): this;
+    orWhere(column: SelectableColumn$1<string>, value: BaseValues$2): this;
     orWhere(cb: (queryBuilder: JoinOnQueryBuilder) => void): this;
     /**
      * @description Adds a negated WHERE condition to the query.
      */
-    whereNot(column: SelectableColumn<string>, operator: BinaryOperatorType$2, value: BaseValues$2): this;
-    whereNot(column: SelectableColumn<string>, value: BaseValues$2): this;
+    whereNot(column: SelectableColumn$1<string>, operator: BinaryOperatorType$2, value: BaseValues$2): this;
+    whereNot(column: SelectableColumn$1<string>, value: BaseValues$2): this;
     /**
      * @description Adds a negated AND WHERE condition to the query.
      */
-    andWhereNot(column: SelectableColumn<string>, operator: BinaryOperatorType$2, value: BaseValues$2): this;
-    andWhereNot(column: SelectableColumn<string>, value: BaseValues$2): this;
+    andWhereNot(column: SelectableColumn$1<string>, operator: BinaryOperatorType$2, value: BaseValues$2): this;
+    andWhereNot(column: SelectableColumn$1<string>, value: BaseValues$2): this;
     /**
      * @description Adds a negated OR WHERE condition to the query.
      */
-    orWhereNot(column: SelectableColumn<string>, operator: BinaryOperatorType$2, value: BaseValues$2): this;
-    orWhereNot(column: SelectableColumn<string>, value: BaseValues$2): this;
+    orWhereNot(column: SelectableColumn$1<string>, operator: BinaryOperatorType$2, value: BaseValues$2): this;
+    orWhereNot(column: SelectableColumn$1<string>, value: BaseValues$2): this;
     /**
      * @description Adds a WHERE BETWEEN condition to the query.
      */
-    whereBetween(column: SelectableColumn<string>, min: BaseValues$2, max: BaseValues$2): this;
+    whereBetween(column: SelectableColumn$1<string>, min: BaseValues$2, max: BaseValues$2): this;
     /**
      * @description Adds an AND WHERE BETWEEN condition to the query.
      */
-    andWhereBetween(column: SelectableColumn<string>, min: BaseValues$2, max: BaseValues$2): this;
+    andWhereBetween(column: SelectableColumn$1<string>, min: BaseValues$2, max: BaseValues$2): this;
     /**
      * @description Adds an OR WHERE BETWEEN condition to the query.
      */
-    orWhereBetween(column: SelectableColumn<string>, min: BaseValues$2, max: BaseValues$2): this;
+    orWhereBetween(column: SelectableColumn$1<string>, min: BaseValues$2, max: BaseValues$2): this;
     /**
      * @description Adds a WHERE NOT BETWEEN condition to the query.
      */
-    whereNotBetween(column: SelectableColumn<string>, min: BaseValues$2, max: BaseValues$2): this;
+    whereNotBetween(column: SelectableColumn$1<string>, min: BaseValues$2, max: BaseValues$2): this;
     /**
      * @description Adds an AND WHERE NOT BETWEEN condition to the query.
      */
-    andWhereNotBetween(column: SelectableColumn<string>, min: BaseValues$2, max: BaseValues$2): this;
+    andWhereNotBetween(column: SelectableColumn$1<string>, min: BaseValues$2, max: BaseValues$2): this;
     /**
      * @description Adds an OR WHERE NOT BETWEEN condition to the query.
      */
-    orWhereNotBetween(column: SelectableColumn<string>, min: BaseValues$2, max: BaseValues$2): this;
+    orWhereNotBetween(column: SelectableColumn$1<string>, min: BaseValues$2, max: BaseValues$2): this;
     /**
      * @description Adds a WHERE LIKE condition to the query.
      */
-    whereLike(column: SelectableColumn<string>, value: string): this;
+    whereLike(column: SelectableColumn$1<string>, value: string): this;
     /**
      * @description Adds an AND WHERE LIKE condition to the query.
      */
-    andWhereLike(column: SelectableColumn<string>, value: string): this;
+    andWhereLike(column: SelectableColumn$1<string>, value: string): this;
     /**
      * @description Adds an OR WHERE LIKE condition to the query.
      */
-    orWhereLike(column: SelectableColumn<string>, value: string): this;
+    orWhereLike(column: SelectableColumn$1<string>, value: string): this;
     /**
      * @description Adds a WHERE ILIKE condition to the query.
      */
-    whereILike(column: SelectableColumn<string>, value: string): this;
+    whereILike(column: SelectableColumn$1<string>, value: string): this;
     /**
      * @description Adds an AND WHERE ILIKE condition to the query.
      */
-    andWhereILike(column: SelectableColumn<string>, value: string): this;
+    andWhereILike(column: SelectableColumn$1<string>, value: string): this;
     /**
      * @description Adds an OR WHERE ILIKE condition to the query.
      */
-    orWhereILike(column: SelectableColumn<string>, value: string): this;
+    orWhereILike(column: SelectableColumn$1<string>, value: string): this;
     /**
      * @description Adds a WHERE NOT LIKE condition to the query.
      */
-    whereNotLike(column: SelectableColumn<string>, value: string): this;
+    whereNotLike(column: SelectableColumn$1<string>, value: string): this;
     /**
      * @description Adds an AND WHERE NOT LIKE condition to the query.
      */
-    andWhereNotLike(column: SelectableColumn<string>, value: string): this;
+    andWhereNotLike(column: SelectableColumn$1<string>, value: string): this;
     /**
      * @description Adds an OR WHERE NOT LIKE condition to the query.
      */
-    orWhereNotLike(column: SelectableColumn<string>, value: string): this;
+    orWhereNotLike(column: SelectableColumn$1<string>, value: string): this;
     /**
      * @description Adds a WHERE NOT ILIKE condition to the query.
      */
-    whereNotILike(column: SelectableColumn<string>, value: string): this;
+    whereNotILike(column: SelectableColumn$1<string>, value: string): this;
     /**
      * @description Adds an AND WHERE NOT ILIKE condition to the query.
      */
-    andWhereNotILike(column: SelectableColumn<string>, value: string): this;
+    andWhereNotILike(column: SelectableColumn$1<string>, value: string): this;
     /**
      * @description Adds an OR WHERE NOT ILIKE condition to the query.
      */
-    orWhereNotILike(column: SelectableColumn<string>, value: string): this;
+    orWhereNotILike(column: SelectableColumn$1<string>, value: string): this;
     /**
      * @description Adds a WHERE IN condition to the query.
      */
-    whereIn(column: SelectableColumn<string>, values: BaseValues$2[]): this;
+    whereIn(column: SelectableColumn$1<string>, values: BaseValues$2[]): this;
     /**
      * @description Adds an AND WHERE IN condition to the query.
      */
-    andWhereIn(column: SelectableColumn<string>, values: BaseValues$2[]): this;
+    andWhereIn(column: SelectableColumn$1<string>, values: BaseValues$2[]): this;
     /**
      * @description Adds an OR WHERE IN condition to the query.
      */
-    orWhereIn(column: SelectableColumn<string>, values: BaseValues$2[]): this;
+    orWhereIn(column: SelectableColumn$1<string>, values: BaseValues$2[]): this;
     /**
      * @description Adds a WHERE NOT IN condition to the query.
      */
-    whereNotIn(column: SelectableColumn<string>, values: BaseValues$2[]): this;
+    whereNotIn(column: SelectableColumn$1<string>, values: BaseValues$2[]): this;
     /**
      * @description Adds an AND WHERE NOT IN condition to the query.
      */
-    andWhereNotIn(column: SelectableColumn<string>, values: BaseValues$2[]): this;
+    andWhereNotIn(column: SelectableColumn$1<string>, values: BaseValues$2[]): this;
     /**
      * @description Adds an OR WHERE NOT IN condition to the query.
      */
-    orWhereNotIn(column: SelectableColumn<string>, values: BaseValues$2[]): this;
+    orWhereNotIn(column: SelectableColumn$1<string>, values: BaseValues$2[]): this;
     /**
      * @description Adds a WHERE NULL condition to the query.
      */
-    whereNull(column: SelectableColumn<string>): this;
+    whereNull(column: SelectableColumn$1<string>): this;
     /**
      * @description Adds an AND WHERE NULL condition to the query.
      */
-    andWhereNull(column: SelectableColumn<string>): this;
+    andWhereNull(column: SelectableColumn$1<string>): this;
     /**
      * @description Adds an OR WHERE NULL condition to the query.
      */
-    orWhereNull(column: SelectableColumn<string>): this;
+    orWhereNull(column: SelectableColumn$1<string>): this;
     /**
      * @description Adds a WHERE NOT NULL condition to the query.
      */
-    whereNotNull(column: SelectableColumn<string>): this;
+    whereNotNull(column: SelectableColumn$1<string>): this;
     /**
      * @description Adds an AND WHERE NOT NULL condition to the query.
      */
-    andWhereNotNull(column: SelectableColumn<string>): this;
+    andWhereNotNull(column: SelectableColumn$1<string>): this;
     /**
      * @description Adds an OR WHERE NOT NULL condition to the query.
      */
-    orWhereNotNull(column: SelectableColumn<string>): this;
+    orWhereNotNull(column: SelectableColumn$1<string>): this;
     /**
      * @description Adds a WHERE REGEXP condition to the query.
      */
-    whereRegexp(column: SelectableColumn<string>, regexp: RegExp): this;
+    whereRegexp(column: SelectableColumn$1<string>, regexp: RegExp): this;
     /**
      * @description Adds an AND WHERE REGEXP condition to the query.
      */
-    andWhereRegexp(column: SelectableColumn<string>, regexp: RegExp): this;
+    andWhereRegexp(column: SelectableColumn$1<string>, regexp: RegExp): this;
     /**
      * @description Adds an OR WHERE REGEXP condition to the query.
      */
-    orWhereRegexp(column: SelectableColumn<string>, regexp: RegExp): this;
+    orWhereRegexp(column: SelectableColumn$1<string>, regexp: RegExp): this;
     /**
      * @description Adds a WHERE NOT REGEXP condition to the query.
      */
-    whereNotRegexp(column: SelectableColumn<string>, regexp: RegExp): this;
+    whereNotRegexp(column: SelectableColumn$1<string>, regexp: RegExp): this;
     /**
      * @description Adds an AND WHERE NOT REGEXP condition to the query.
      */
-    andWhereNotRegexp(column: SelectableColumn<string>, regexp: RegExp): this;
+    andWhereNotRegexp(column: SelectableColumn$1<string>, regexp: RegExp): this;
     /**
      * @description Adds an OR WHERE NOT REGEXP condition to the query.
      */
-    orWhereNotRegexp(column: SelectableColumn<string>, regexp: RegExp): this;
+    orWhereNotRegexp(column: SelectableColumn$1<string>, regexp: RegExp): this;
     /**
      * @description Adds a WHERE group condition with AND.
      */
@@ -3382,7 +3607,7 @@ declare class SelectQueryBuilder<T extends Model, S extends Record<string, any>
      * .select(["id", "userId"], ["name", "userName"]) // Columns with aliases
      * .select("id", ["name", "userName"])             // Mixed
      */
-    select<C extends string>(...columns: (SelectableColumn<C> | Selectable)[]): this;
+    select<C extends string>(...columns: (SelectableColumn$1<C> | Selectable)[]): this;
     select(...columns: (ModelKey<T> | "*" | Selectable)[]): this;
     /**
      * @description Adds a raw SELECT statement to the query
@@ -3429,7 +3654,7 @@ declare class SelectQueryBuilder<T extends Model, S extends Record<string, any>
      * @postgresql Only usable with PostgreSQL
      */
     distinctOn(...columns: ModelKey<T>[]): this;
-    distinctOn<C extends string>(...columns: SelectableColumn<C>[]): this;
+    distinctOn<C extends string>(...columns: SelectableColumn$1<C>[]): this;
     /**
      * @description Selects a JSON value at the specified path and returns it as JSON.
      * @description Path format is standardized across all databases — the ORM converts to DB-specific syntax.
@@ -3610,62 +3835,62 @@ declare abstract class WhereQueryBuilder<T extends Model, S extends Record<strin
      * @description Adds a WHERE LIKE condition to the query.
      */
     whereLike(column: ModelKey<T>, value: string): this;
-    whereLike<S extends string>(column: SelectableColumn<S>, value: string): this;
+    whereLike<S extends string>(column: SelectableColumn$1<S>, value: string): this;
     /**
      * @description Adds an AND WHERE LIKE condition to the query.
      */
     andWhereLike(column: ModelKey<T>, value: string): this;
-    andWhereLike<S extends string>(column: SelectableColumn<S>, value: string): this;
+    andWhereLike<S extends string>(column: SelectableColumn$1<S>, value: string): this;
     /**
      * @description Adds an OR WHERE LIKE condition to the query.
      */
     orWhereLike(column: ModelKey<T>, value: string): this;
-    orWhereLike<S extends string>(column: SelectableColumn<S>, value: string): this;
+    orWhereLike<S extends string>(column: SelectableColumn$1<S>, value: string): this;
     /**
      * @description Adds a WHERE ILIKE condition to the query.
      */
     whereILike(column: ModelKey<T>, value: string): this;
-    whereILike<S extends string>(column: SelectableColumn<S>, value: string): this;
+    whereILike<S extends string>(column: SelectableColumn$1<S>, value: string): this;
     /**
      * @description Adds an AND WHERE ILIKE condition to the query.
      */
     andWhereILike(column: ModelKey<T>, value: string): this;
-    andWhereILike<S extends string>(column: SelectableColumn<S>, value: string): this;
+    andWhereILike<S extends string>(column: SelectableColumn$1<S>, value: string): this;
     /**
      * @description Adds an OR WHERE ILIKE condition to the query.
      */
     orWhereILike(column: ModelKey<T>, value: string): this;
-    orWhereILike<S extends string>(column: SelectableColumn<S>, value: string): this;
+    orWhereILike<S extends string>(column: SelectableColumn$1<S>, value: string): this;
     /**
      * @description Adds a WHERE NOT LIKE condition to the query.
      */
     whereNotLike(column: ModelKey<T>, value: string): this;
-    whereNotLike<S extends string>(column: SelectableColumn<S>, value: string): this;
+    whereNotLike<S extends string>(column: SelectableColumn$1<S>, value: string): this;
     /**
      * @description Adds an AND WHERE NOT LIKE condition to the query.
      */
     andWhereNotLike(column: ModelKey<T>, value: string): this;
-    andWhereNotLike<S extends string>(column: SelectableColumn<S>, value: string): this;
+    andWhereNotLike<S extends string>(column: SelectableColumn$1<S>, value: string): this;
     /**
      * @description Adds an OR WHERE NOT LIKE condition to the query.
      */
     orWhereNotLike(column: ModelKey<T>, value: string): this;
-    orWhereNotLike<S extends string>(column: SelectableColumn<S>, value: string): this;
+    orWhereNotLike<S extends string>(column: SelectableColumn$1<S>, value: string): this;
     /**
      * @description Adds a WHERE NOT ILIKE condition to the query.
      */
     whereNotILike(column: ModelKey<T>, value: string): this;
-    whereNotILike<S extends string>(column: SelectableColumn<S>, value: string): this;
+    whereNotILike<S extends string>(column: SelectableColumn$1<S>, value: string): this;
     /**
      * @description Adds an AND WHERE NOT ILIKE condition to the query.
      */
     andWhereNotILike(column: ModelKey<T>, value: string): this;
-    andWhereNotILike<S extends string>(column: SelectableColumn<S>, value: string): this;
+    andWhereNotILike<S extends string>(column: SelectableColumn$1<S>, value: string): this;
     /**
      * @description Adds an OR WHERE NOT ILIKE condition to the query.
      */
     orWhereNotILike(column: ModelKey<T>, value: string): this;
-    orWhereNotILike<S extends string>(column: SelectableColumn<S>, value: string): this;
+    orWhereNotILike<S extends string>(column: SelectableColumn$1<S>, value: string): this;
     /**
      * @description Adds a WHERE IN condition to the query.
      * @warning If the array is empty, it will add an impossible condition.
@@ -3712,74 +3937,74 @@ declare abstract class WhereQueryBuilder<T extends Model, S extends Record<strin
      * @description Adds a WHERE NULL condition to the query.
      */
     whereNull(column: ModelKey<T>): this;
-    whereNull<S extends string>(column: SelectableColumn<S>): this;
+    whereNull<S extends string>(column: SelectableColumn$1<S>): this;
     /**
      * @description Adds an AND WHERE NULL condition to the query.
      */
     andWhereNull(column: ModelKey<T>): this;
-    andWhereNull<S extends string>(column: SelectableColumn<S>): this;
+    andWhereNull<S extends string>(column: SelectableColumn$1<S>): this;
     /**
      * @description Adds an OR WHERE NULL condition to the query.
      */
     orWhereNull(column: ModelKey<T>): this;
-    orWhereNull<S extends string>(column: SelectableColumn<S>): this;
+    orWhereNull<S extends string>(column: SelectableColumn$1<S>): this;
     /**
      * @description Adds a WHERE NOT NULL condition to the query.
      */
     whereNotNull(column: ModelKey<T>): this;
-    whereNotNull<S extends string>(column: SelectableColumn<S>): this;
+    whereNotNull<S extends string>(column: SelectableColumn$1<S>): this;
     /**
      * @description Adds an AND WHERE NOT NULL condition to the query.
      */
     andWhereNotNull(column: ModelKey<T>): this;
-    andWhereNotNull<S extends string>(column: SelectableColumn<S>): this;
+    andWhereNotNull<S extends string>(column: SelectableColumn$1<S>): this;
     /**
      * @description Adds an OR WHERE NOT NULL condition to the query.
      */
     orWhereNotNull(column: ModelKey<T>): this;
-    orWhereNotNull<S extends string>(column: SelectableColumn<S>): this;
+    orWhereNotNull<S extends string>(column: SelectableColumn$1<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;
+    whereRegexp<S extends string>(column: SelectableColumn$1<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;
+    andWhereRegexp<S extends string>(column: SelectableColumn$1<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;
+    orWhereRegexp<S extends string>(column: SelectableColumn$1<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;
+    whereNotRegexp<S extends string>(column: SelectableColumn$1<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;
+    andWhereNotRegexp<S extends string>(column: SelectableColumn$1<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;
+    orWhereNotRegexp<S extends string>(column: SelectableColumn$1<S>, regexp: RegExp): this;
     /**
      * @description Adds a AND WHERE EXISTS condition to the query. By default uses the same table, you can use the `from` method to change the table.
      */
@@ -3950,8 +4175,7 @@ declare class JsonQueryBuilder<T extends Model, S extends Record<string, any> =
 /**
  * @description Minimal interface satisfied by both QueryBuilder and ModelQueryBuilder.
  * Used as the return type for subquery callbacks so that both QB and MQB can be
- * returned without TypeScript complaining about structural incompatibilities in
- * the `performance` property.
+ * returned without TypeScript complaining about structural incompatibilities.
  */
 interface SubQueryable {
     extractQueryNodes(): QueryNode[];
@@ -3971,63 +4195,6 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
     protected deleteNode: DeleteNode | null;
     protected truncateNode: TruncateNode | null;
     protected replicationMode: ReplicationType | null;
-    /**
-     * @description Performance methods that return the time that took to execute the query with the result
-     */
-    performance: {
-        many: (returnType?: "millis" | "seconds") => Promise<{
-            data: S[];
-            time: number;
-        }>;
-        one: (returnType?: "millis" | "seconds") => Promise<{
-            data: S | null;
-            time: number;
-        }>;
-        oneOrFail: (returnType?: "millis" | "seconds") => Promise<{
-            data: S;
-            time: number;
-        }>;
-        paginate: (page: number, perPage: number, returnType?: "millis" | "seconds") => Promise<{
-            data: RawPaginatedData<S>;
-            time: number;
-        }>;
-        paginateWithCursor: (page: number, options: PaginateWithCursorOptions<T, ModelKey<T>>, cursor?: Cursor<T, ModelKey<T>>, returnType?: "millis" | "seconds") => Promise<{
-            data: [RawCursorPaginatedData<S>, Cursor<T, ModelKey<T>>];
-            time: number;
-        }>;
-        exists: (returnType?: "millis" | "seconds") => Promise<{
-            data: boolean;
-            time: number;
-        }>;
-        truncate: (returnType?: "millis" | "seconds") => Promise<{
-            data: void;
-            time: number;
-        }>;
-        delete: (returnType?: "millis" | "seconds") => Promise<{
-            data: any;
-            time: number;
-        }>;
-        insert: (data: Record<string, any>, returnType?: "millis" | "seconds") => Promise<{
-            data: void;
-            time: number;
-        }>;
-        insertMany: (data: Record<string, any>[], returnType?: "millis" | "seconds") => Promise<{
-            data: void;
-            time: number;
-        }>;
-        update: (data: Record<string, any>, returnType?: "millis" | "seconds") => Promise<{
-            data: any;
-            time: number;
-        }>;
-        softDelete: (options?: Omit<SoftDeleteOptions<T>, "ignoreBeforeDeleteHook">, returnType?: "millis" | "seconds") => Promise<{
-            data: number;
-            time: number;
-        }>;
-        pluck: (key: RawModelKey<T>, returnType?: "millis" | "seconds") => Promise<{
-            data: PluckReturnType<T, RawModelKey<T>>;
-            time: number;
-        }>;
-    };
     constructor(model: typeof Model, sqlDataSource: SqlDataSource);
     /**
      * @description Sets the replication mode for the query builder
@@ -4377,36 +4544,6 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
     clearWithQuery(): this;
     extractQueryNodes(): QueryNode[];
     protected clearForFunctions(): this;
-    /**
-     * @description Makes a many query and returns the time that took to execute that query
-     */
-    private manyWithPerformance;
-    /**
-     * @description Makes a one query and returns the time that took to execute that query
-     */
-    private oneWithPerformance;
-    /**
-     * @alias oneOrFailWithPerformance
-     */
-    private firstOrFailWithPerformance;
-    private paginateWithPerformance;
-    private paginateWithCursorWithPerformance;
-    /**
-     * @description Makes a one or fail query and returns the time that took to execute that query
-     */
-    private oneOrFailWithPerformance;
-    /**
-     * @description Executes the query and returns true if the query returns at least one result, false otherwise.
-     * @description Returns the time that took to execute the query
-     */
-    private existsWithPerformance;
-    private pluckWithPerformance;
-    private updateWithPerformance;
-    private insertWithPerformance;
-    private insertManyWithPerformance;
-    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
@@ -4560,6 +4697,41 @@ declare class Transaction {
     private getMssqlTransactionLevel;
 }
 
+type Operation = "SELECT" | "INSERT" | "UPDATE" | "DELETE" | "OTHER";
+interface QueryContext {
+    sql: string;
+    params: any[];
+    model?: any;
+    operation?: string;
+    timestamp: number;
+}
+/**
+ * Query context extended with execution metadata.
+ * @property duration - Query execution time in milliseconds (ms)
+ */
+type QueryContextWithDuration = QueryContext & {
+    duration: number;
+    result?: any;
+};
+interface QueryObserver {
+    onBeforeQuery?(ctx: QueryContext): Promise<void> | void;
+    onAfterQuery?(ctx: QueryContextWithDuration): Promise<void> | void;
+    onQueryError?(ctx: QueryContext & {
+        error: Error;
+    }): Promise<void> | void;
+}
+declare class ObserverChain {
+    private observers;
+    constructor(observers?: QueryObserver[]);
+    add(observer: QueryObserver): void;
+    notifyBefore(ctx: QueryContext): Promise<void>;
+    notifyAfter(ctx: QueryContextWithDuration, result?: any): Promise<void>;
+    notifyError(ctx: QueryContext & {
+        error: Error;
+    }): Promise<void>;
+}
+declare const deriveOperationFromQuery: (sql: string) => string;
+
 declare const SQL_DATA_SOURCE_SYMBOL: unique symbol;
 /**
  * @description The SqlDataSource class is the main class for interacting with the database, it's used to create connections, execute queries, and manage transactions
@@ -4653,6 +4825,10 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
         path: string;
         tsconfig?: string;
     };
+    /**
+     * Optional observer chain for query middleware. See src/sql/observers for details.
+     */
+    observerChain?: ObserverChain;
     /**
      * @description AdminJS configuration options
      */
@@ -4671,6 +4847,20 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Returns the configured slave failure callback
      */
     getOnSlaveServerFailure(): ((error: Error, context: SlaveContext) => void | Promise<void>) | undefined;
+    /**
+     * @description Add a single observer to the query middleware chain.
+     * Can be called multiple times to add multiple observers.
+     * @param observer A QueryObserver with onBeforeQuery, onAfterQuery, and/or onQueryError handlers
+     * @example
+     * ```ts
+     * sql.addObserver({
+     *   onBeforeQuery: (ctx) => console.log("Before:", ctx.sql),
+     *   onAfterQuery: (ctx) => console.log("After:", ctx.sql),
+     *   onQueryError: (ctx) => console.log("Error:", ctx.sql)
+     * });
+     * ```
+     */
+    addObserver(observer: QueryObserver): this;
     /**
      * @description Creates a new SqlDataSource instance. Call `.connect()` to establish the connection.
      * @param input Configuration options for the database connection. If not provided, uses env variables.
@@ -4871,6 +5061,11 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Returns the connection details
      */
     getConnectionDetails(): SqlDataSourceInput<D, T, C>;
+    /**
+     * @description Introspects database schema and returns a basic introspection structure.
+     * This is a scaffold for dialect-aware introspection to be expanded.
+     */
+    introspectSchema(): Promise<IntrospectedSchema[]>;
     /**
      * @description Syncs the schema of the database with the models metadata
      * @warning This will drop and recreate all the indexes and constraints, use with caution
@@ -4964,6 +5159,15 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @returns true if lock was acquired, false otherwise
      */
     acquireLock(lockKey?: string, timeoutMs?: number): Promise<boolean>;
+    /**
+     * @description Executes a lightweight health check query
+     * @returns Promise resolving to PingResult with ok status, latency in ms, and dialect
+     */
+    ping(): Promise<PingResult>;
+    /**
+     * @description Returns true if the database connection is healthy, false on error (never throws)
+     */
+    isHealthy(): Promise<boolean>;
     /**
      * @description Releases an advisory lock
      * @param lockKey - The lock identifier (defaults to 'hysteria_lock')
@@ -5162,7 +5366,7 @@ type RelatedInstance<M extends Model, K extends ModelRelation<M>> = NonNullable<
  *
  * @internal
  */
-type UnionToIntersection$1<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 /**
  * Represents valid string column selection formats with intellisense support.
  * Use [column, alias] tuple format for aliases instead of "column as alias".
@@ -5184,7 +5388,7 @@ type UnionToIntersection$1<U> = (U extends any ? (k: U) => void : never) extends
  *   "*"                        // All columns
  * );
  */
-type SelectableColumn$1<T extends Model> = ModelKey<T> | `${string}.${string | "*"}` | "*";
+type SelectableColumn<T extends Model> = ModelKey<T> | `${string}.${string | "*"}` | "*";
 /**
  * A tuple type for selecting a column with an alias in ModelQueryBuilder.
  * @example ["id", "userId"] selects "id" column as "userId"
@@ -5199,7 +5403,7 @@ type ModelSelectTuple<T extends Model, C extends ModelKey<T> | `${string}.${stri
  * .select(["id", "userId"], ["name", "userName"]) // Columns with aliases
  * .select("id", ["name", "userName"])             // Mixed
  */
-type ModelSelectableInput<T extends Model> = SelectableColumn$1<T> | ModelSelectTuple<T>;
+type ModelSelectableInput<T extends Model> = SelectableColumn<T> | ModelSelectTuple<T>;
 /**
  * Extracts the final property name from a column selection.
  * Supports both string columns and [column, alias] tuples.
@@ -5317,7 +5521,7 @@ type SelectBrand = {
  * BuildSelectType<User, ["*"]>
  * // Result: ModelWithoutRelations<User> (all columns)
  */
-type BuildSelectType<T extends Model, Columns extends readonly (string | readonly [string, string])[]> = HasStarOrEmpty<Columns> extends true ? ModelWithoutRelations<T> : UnionToIntersection$1<{
+type BuildSelectType<T extends Model, Columns extends readonly (string | readonly [string, string])[]> = HasStarOrEmpty<Columns> extends true ? ModelWithoutRelations<T> : UnionToIntersection<{
     [K in keyof Columns]: BuildSingleSelectType<T, Columns[K]>;
 }[number]> extends infer Result ? Result extends Record<string, any> ? keyof Result extends never ? ModelWithoutRelations<T> : Result & ModelDataProperties & SelectBrand : ModelWithoutRelations<T> : ModelWithoutRelations<T>;
 /**
@@ -5544,254 +5748,108 @@ type FindOneType<T extends Model, S extends ModelKey<T>[] = any[], R extends Mod
     relations?: R;
     orderBy?: OrderByType<T>;
     groupBy?: ModelKey<T>[];
-    where?: WhereType<T>;
-    ignoreHooks?: FetchHooks;
-};
-type FindType<T extends Model, S extends ModelKey<T>[] = any[], R extends ModelRelation<T>[] = never[]> = Omit<FindOneType<T, S, R>, "throwErrorOnNull"> & {
-    limit?: number;
-};
-type FindReturnType<T extends Model, S extends ModelKey<T>[] = any[], R extends ModelRelation<T>[] = never[]> = S extends readonly any[] ? S[number] extends never ? ModelWithoutRelations<T> & {
-    [K in R[number] & keyof T]: T[K];
-} : {
-    [K in StripTablePrefix<S[number] & string> & keyof T]: T[K];
-} & {
-    [K in R[number] & keyof T]: T[K];
-} : ModelWithoutRelations<T> & {
-    [K in R[number] & keyof T]: T[K];
-};
-/**
- * Return type for write operations (insert/upsert) based on the returning columns.
- * - `undefined` or `[]` -> `void` (no data fetched)
- * - `["*"]` -> `ModelQueryResult<T>` (full model)
- * - `["col1", "col2"]` -> `{ col1: ...; col2: ... } & ModelDataProperties`
- *
- * @typeParam T - The Model type
- * @typeParam R - The returning columns array (literal tuple for type inference)
- */
-type WriteReturnType<T extends Model, R extends ReturningColumns<T>> = R extends undefined ? void : R extends readonly [] ? void : R extends readonly ReturningKey<T>[] ? "*" extends R[number] ? ModelQueryResult<T> : {
-    [K in R[number] & string & keyof T]: T[K];
-} & ModelDataProperties : never;
-
-type PluckReturnType<T extends Model, K extends RawModelKey<T>> = T[StripTablePrefix<K & string> & keyof T] extends infer U ? U[] : never;
-/**
- * Common SQL functions with intellisense support.
- * Provides autocomplete for standard SQL aggregate and scalar functions,
- * while still allowing any custom function name via string fallback.
- *
- * @example
- * selectFunc("count", "*", "total")     // Intellisense suggests "count"
- * selectFunc("custom_fn", "col", "res") // Custom functions still work
- */
-type SqlFunction = "count" | "sum" | "avg" | "min" | "max" | "upper" | "lower" | "length" | "trim" | "abs" | "round" | "coalesce" | "ceil" | "floor" | "sqrt" | (string & {});
-/**
- * Maps SQL function names to their return types.
- * Used by selectFunc to auto-infer the result type.
- *
- * - Numeric functions (count, sum, avg, etc.) → number
- * - String functions (upper, lower, trim) → string
- * - Unknown functions → any
- */
-type SqlFunctionReturnType<F extends string> = F extends "count" | "sum" | "avg" | "min" | "max" | "length" | "abs" | "round" | "ceil" | "floor" | "sqrt" ? number : F extends "upper" | "lower" | "trim" ? string : any;
-/**
- * A tuple type for selecting a column with an alias.
- * @example ["id", "userId"] selects "id" column as "userId"
- */
-type SelectTuple<C extends string = string, A extends string = string> = readonly [column: C, alias: A];
-/**
- * Input type for select() method in raw query builder.
- * Accepts either a column string or a [column, alias] tuple.
- *
- * @example
- * .select("id", "name")                    // Simple columns
- * .select(["id", "userId"], ["name", "n"]) // Columns with aliases
- * .select("id", ["name", "userName"])      // Mixed
- */
-type Selectable = string | SelectTuple;
-/**
- * Unique symbol used internally to mark that a raw select() has been called.
- */
-declare const RAW_SELECT_BRAND: unique symbol;
-/**
- * Marker type to indicate that a raw select() has been called.
- * @internal
- */
-type RawSelectBrand = {
-    [RAW_SELECT_BRAND]?: never;
+    where?: WhereType<T>;
+    ignoreHooks?: FetchHooks;
+};
+type FindType<T extends Model, S extends ModelKey<T>[] = any[], R extends ModelRelation<T>[] = never[]> = Omit<FindOneType<T, S, R>, "throwErrorOnNull"> & {
+    limit?: number;
+};
+type FindReturnType<T extends Model, S extends ModelKey<T>[] = any[], R extends ModelRelation<T>[] = never[]> = S extends readonly any[] ? S[number] extends never ? ModelWithoutRelations<T> & {
+    [K in R[number] & keyof T]: T[K];
+} : {
+    [K in StripTablePrefix<S[number] & string> & keyof T]: T[K];
+} & {
+    [K in R[number] & keyof T]: T[K];
+} : ModelWithoutRelations<T> & {
+    [K in R[number] & keyof T]: T[K];
 };
 /**
- * Utility type to convert a union to an intersection.
- * @internal
- */
-type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
-/**
- * Extracts the final property name from a column selection for raw queries.
- * Supports both string columns and [column, alias] tuples.
+ * Return type for write operations (insert/upsert) based on the returning columns.
+ * - `undefined` or `[]` -> `void` (no data fetched)
+ * - `["*"]` -> `ModelQueryResult<T>` (full model)
+ * - `["col1", "col2"]` -> `{ col1: ...; col2: ... } & ModelDataProperties`
  *
- * | Input                        | Output        |
- * |------------------------------|---------------|
- * | `"name"`                     | `"name"`      |
- * | `"users.name"`               | `"name"`      |
- * | `["name", "userName"]`       | `"userName"`  |
- * | `["users.id", "id"]`         | `"id"`        |
- * | `"*"`                        | `never`       |
- * | `"users.*"`                  | `never`       |
+ * @typeParam T - The Model type
+ * @typeParam R - The returning columns array (literal tuple for type inference)
  */
-type ExtractRawColumnName<S> = S extends readonly [
-    string,
-    infer Alias extends string
-] ? Alias : S extends string ? S extends "*" ? never : S extends `${string}.*` ? never : S extends `${string}.${infer Column}` ? Column extends "*" ? never : Column : S : never;
+type WriteReturnType<T extends Model, R extends ReturningColumns<T>> = R extends undefined ? void : R extends readonly [] ? void : R extends readonly ReturningKey<T>[] ? "*" extends R[number] ? ModelQueryResult<T> : {
+    [K in R[number] & string & keyof T]: T[K];
+} & ModelDataProperties : never;
+
+type JsonPathInput = string | (string | number)[];
 /**
- * Builds the type for a single selected column in a raw query.
- * All column types are `any` since we don't have model type information.
- * Supports both string columns and [column, alias] tuples.
+ * Recursively generates all valid dot-separated JSON path strings from an
+ * object type `T`.
  *
- * | Selection              | Result Type                           |
- * |------------------------|---------------------------------------|
- * | `"*"`                  | `Record<string, any>`                 |
- * | `"table.*"`            | `Record<string, any>`                 |
- * | `"column"`             | `{ column: any }`                     |
- * | `["col", "alias"]`     | `{ alias: any }`                      |
+ * Handles nested objects, arrays (via numeric indices), and stops recursion at
+ * a configurable depth (default 5) to prevent infinite expansion with deeply
+ * nested or self-referential types.
  *
- * @internal
+ * @typeParam T - The root object type to extract paths from.
+ *
+ * @example
+ * ```ts
+ * type Data = { user: { name: string; roles: string[] }; count: number };
+ * type P = JsonPaths<Data>;
+ * // "user" | "user.name" | "user.roles" | "user.roles.${number}" | "count"
+ * ```
  */
-type BuildRawSingleSelectType<S> = S extends readonly [
-    string,
-    infer Alias extends string
-] ? {
-    [K in Alias]: any;
-} : S extends string ? S extends "*" ? Record<string, any> : S extends `${string}.*` ? Record<string, any> : ExtractRawColumnName<S> extends never ? {} : {
-    [K in ExtractRawColumnName<S> & string]: any;
-} : {};
+type JsonPaths<T, Depth extends number[] = []> = Depth["length"] extends 5 ? never : T extends readonly (infer E)[] ? `${number}` | (NonNullable<E> extends object ? `${number}.${JsonPaths<NonNullable<E>, [...Depth, 1]>}` : never) : T extends object ? {
+    [K in keyof T & string]: K | (NonNullable<T[K]> extends object ? `${K}.${JsonPaths<NonNullable<T[K]>, [...Depth, 1]>}` : never);
+}[keyof T & string] : never;
 /**
- * Checks if a column selection includes wildcards or is empty.
- * @internal
+ * Resolves the TypeScript type of a model column given its `ModelKey` string.
+ * Strips any table prefix (e.g. `"users.metadata"` → `"metadata"`) before
+ * indexing into the model.
+ *
+ * @typeParam T - The Model instance type.
+ * @typeParam K - The column key (plain or table-prefixed).
  */
-type HasRawStarOrEmpty<Columns extends readonly Selectable[]> = Columns["length"] extends 0 ? true : "*" extends Columns[number] ? true : false;
+type ResolveColumnType<T extends Model, K extends string> = T[StripTablePrefix<K> & keyof T];
 /**
- * Builds the combined TypeScript type for multiple selected columns in a raw query.
- * Supports both string columns and [column, alias] tuples.
+ * Type-safe JSON path input that provides IDE autocompletion for known JSON
+ * column structures while still accepting arbitrary strings as a fallback.
  *
- * ## Rules
+ * - When `ColumnType` is a known object/array type: suggests all valid
+ *   dot-separated paths via {@link JsonPaths}, plus `(string & {})` as a
+ *   catch-all and `(string | number)[]` for the array form.
+ * - When `ColumnType` is `unknown`, a primitive, or `never`: falls back to the
+ *   original untyped {@link JsonPathInput}.
  *
- * 1. **Empty selection or `*`**: Returns `Record<string, any>`
- * 2. **Specific columns**: Returns intersection of all selected column types (all `any`)
- * 3. **With `table.*`**: Adds `Record<string, any>` to allow unknown properties
+ * Uses the `SpecificLiteral | (string & {})` pattern so TypeScript's
+ * autocomplete shows the known paths first without blocking custom strings.
  *
- * @example
- * // .select("name", ["age", "userAge"])
- * BuildRawSelectType<["name", ["age", "userAge"]]>
- * // Result: { name: any; userAge: any } & RawSelectBrand
+ * @typeParam ColumnType - The TypeScript type of the JSON column value.
  *
  * @example
- * // .select("*")
- * BuildRawSelectType<["*"]>
- * // Result: Record<string, any>
+ * ```ts
+ * type Settings = { theme: string; notifications: { email: boolean } };
+ * type P = TypedJsonPathInput<Settings | null>;
+ * // "theme" | "notifications" | "notifications.email" | (string & {}) | (string | number)[]
+ * ```
  */
-type BuildRawSelectType<Columns extends readonly Selectable[]> = HasRawStarOrEmpty<Columns> extends true ? Record<string, any> : UnionToIntersection<{
-    [K in keyof Columns]: BuildRawSingleSelectType<Columns[K]>;
-}[number]> extends infer Result ? Result extends Record<string, any> ? keyof Result extends never ? Record<string, any> : Result & RawSelectBrand : Record<string, any> : Record<string, any>;
 /**
- * Composes a new selection with the existing selection state for raw queries.
- *
- * - If S is the default Record<string, any> (no previous select), returns just the new selection
- * - If S is a typed selection from a prior select/selectRaw, composes with new selection
- *
- * Detection uses `string extends keyof S`: true for untyped `Record<string, any>`, false for any
- * specific typed record (e.g. `{ userName: any }`). This avoids relying on the RAW_SELECT_BRAND
- * symbol, which gets stripped by Simplify in intermediate types.
+ * Resolves the TypeScript type at a given dot-separated JSON path within a
+ * root type. Handles `$` prefix, dot notation, and array numeric indices.
  *
- * @typeParam S - Current selection state
- * @typeParam Added - New fields being added by the select
+ * Falls back to `unknown` when the path does not match the type structure.
  *
- * @example
- * // First selectRaw - creates new selection
- * ComposeRawSelect<Record<string, any>, { count: number }>
- * // Result: { count: number }
+ * @typeParam T - The root JSON object type to traverse.
+ * @typeParam Path - A dot-separated string path.
  *
  * @example
- * // Chained after select - composes with previous
- * ComposeRawSelect<{ userName: any }, { nameLength: number }>
- * // Result: { userName: any; nameLength: number }
- */
-type ComposeRawSelect<S extends Record<string, any>, Added extends Record<string, any>> = Simplify<(string extends keyof S ? RawSelectBrand : S) & Added, typeof RAW_SELECT_BRAND>;
-/**
- * Composes a BuildRawSelectType result with the existing selection state.
- *
- * Similar to ComposeRawSelect but designed for use with BuildRawSelectType.
- *
- * @typeParam S - Current selection state
- * @typeParam Columns - The columns being selected
- */
-type ComposeBuildRawSelect<S extends Record<string, any>, Columns extends readonly Selectable[]> = Simplify<(string extends keyof S ? {} : S) & BuildRawSelectType<Columns>, typeof RAW_SELECT_BRAND>;
-type WhereOnlyQueryBuilder<T extends Model> = Pick<WhereQueryBuilder<T>, "where" | "andWhere" | "orWhere" | "whereNot" | "andWhereNot" | "orWhereNot" | "whereIn" | "andWhereIn" | "orWhereIn" | "whereNotIn" | "andWhereNotIn" | "orWhereNotIn" | "whereBetween" | "andWhereBetween" | "orWhereBetween" | "whereNotBetween" | "andWhereNotBetween" | "orWhereNotBetween" | "whereNull" | "andWhereNull" | "orWhereNull" | "whereNotNull" | "andWhereNotNull" | "orWhereNotNull" | "whereLike" | "andWhereLike" | "orWhereLike" | "whereILike" | "andWhereILike" | "orWhereILike" | "whereNotLike" | "andWhereNotLike" | "orWhereNotLike" | "whereNotILike" | "andWhereNotILike" | "orWhereNotILike" | "whereRegexp" | "andWhereRegexp" | "orWhereRegexp" | "whereNotRegexp" | "andWhereNotRegexp" | "orWhereNotRegexp" | "whereRaw" | "andWhereRaw" | "orWhereRaw" | "whereExists" | "orWhereExists" | "andWhereExists" | "whereNotExists" | "orWhereNotExists" | "andWhereNotExists" | "whereColumn" | "andWhereColumn" | "orWhereColumn"> & Pick<JsonQueryBuilder<T>, "whereJson" | "andWhereJson" | "orWhereJson" | "whereJsonContains" | "andWhereJsonContains" | "orWhereJsonContains" | "whereJsonNotContains" | "andWhereJsonNotContains" | "orWhereJsonNotContains" | "whereJsonNotContains" | "andWhereJsonNotContains" | "orWhereJsonNotContains" | "whereJsonRaw" | "andWhereJsonRaw" | "orWhereJsonRaw" | "whereJsonNotContains" | "andWhereJsonNotContains" | "orWhereJsonNotContains">;
-type RelationRetrieveMethod<P> = NonNullable<P> extends any[] ? "many" : "one";
-/**
- * Validates a column string for raw query builder select().
- * Use [column, alias] tuple format for aliases instead of "column as alias".
- * Use selectFunction() for SQL functions instead of embedding them in select().
- */
-type SelectableColumn<T extends string = string> = T extends `${string}.${string}.${string}` ? never : T extends `${string} ${string}` ? never : T extends `.${string}` | `${string}.` ? never : T extends `${string}-${string}` ? never : T extends `${string}.${string}` ? T : T;
-/**
- * @description A column that can be used in a join statement e.g. `users.id`
- */
-type JoinableColumn = `${string}.${string}`;
-/**
- * @description Options for streaming queries
- * @sqlite Ignores the options below
- */
-type StreamOptions = {
-    highWaterMark?: number;
-    /** Postgres only */
-    rowMode?: "array";
-    /** Postgres only */
-    batchSize?: number;
-    /** Postgres only */
-    types?: any;
-    /** Mysql only */
-    objectMode?: boolean;
-};
-type Cursor<T extends Model, K extends ModelKey<T>> = {
-    key: K;
-    value: string | number;
-};
-type PaginateWithCursorOptions<T extends Model, K extends ModelKey<T>> = {
-    discriminator: K;
-    operator?: "<" | ">";
-    orderBy?: "asc" | "desc";
-};
-type UpsertOptionsRawBuilder = {
-    updateOnConflict?: boolean;
-    returning?: readonly string[];
-};
-type WriteQueryParam = string | number | boolean | Date | RawNode | object | null | undefined;
-/**
- * Simple paginated data type for raw query builders (without Model constraint)
- */
-type RawPaginatedData<S extends Record<string, any>> = {
-    paginationMetadata: {
-        perPage: number;
-        currentPage: number;
-        firstPage: number;
-        isEmpty: boolean;
-        total: number;
-        lastPage: number;
-        hasMorePages: boolean;
-        hasPages: boolean;
-    };
-    data: S[];
-};
-/**
- * Simple cursor paginated data type for raw query builders (without Model constraint)
+ * ```ts
+ * type Data = { user: { name: string; roles: string[] } };
+ * type A = ResolveJsonPathType<Data, "user.name">;    // string
+ * type B = ResolveJsonPathType<Data, "user.roles">;   // string[]
+ * type C = ResolveJsonPathType<Data, "user">;          // { name: string; roles: string[] }
+ * type D = ResolveJsonPathType<Data, "$">;             // Data
+ * ```
  */
-type RawCursorPaginatedData<S extends Record<string, any>> = {
-    paginationMetadata: {
-        perPage: number;
-        firstPage: number;
-        isEmpty: boolean;
-        total: number;
-    };
-    data: S[];
-};
+type ResolveJsonPathType<T, Path extends string> = Path extends `$.${infer Rest}` ? ResolveJsonPathType<T, Rest> : Path extends "$" | "" ? T : Path extends `${infer Head}.${infer Rest}` ? Head extends keyof NonNullable<T> ? ResolveJsonPathType<NonNullable<T>[Head], Rest> : NonNullable<T> extends readonly (infer E)[] ? Head extends `${number}` ? ResolveJsonPathType<E, Rest> : unknown : unknown : Path extends keyof NonNullable<T> ? NonNullable<T>[Path] : NonNullable<T> extends readonly (infer E)[] ? Path extends `${number}` ? E : unknown : unknown;
+type TypedJsonPathInput<ColumnType> = [NonNullable<ColumnType>] extends [
+    never
+] ? JsonPathInput : unknown extends NonNullable<ColumnType> ? JsonPathInput : NonNullable<ColumnType> extends object ? JsonPaths<NonNullable<ColumnType>> | (string & {}) | (string | number)[] : JsonPathInput;
 
 declare class SqlModelManagerUtils<T extends Model> {
     protected dbType: SqlDataSourceType;
@@ -5847,62 +5905,6 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
     protected offsetValue?: number;
     /** Options for relation loading strategy */
     protected loadOptions: LoadOptions;
-    performance: {
-        many: (options?: ManyOptions, returnType?: "millis" | "seconds") => Promise<{
-            data: SelectedModel<T, S, R>[];
-            time: number;
-        }>;
-        one: (options?: OneOptions, returnType?: "millis" | "seconds") => Promise<{
-            data: SelectedModel<T, S, R> | null;
-            time: number;
-        }>;
-        oneOrFail: (options?: OneOptions, returnType?: "millis" | "seconds") => Promise<{
-            data: SelectedModel<T, S, R>;
-            time: number;
-        }>;
-        paginate: (page: number, perPage: number, options?: {
-            ignoreHooks?: boolean;
-        }, returnType?: "millis" | "seconds") => Promise<{
-            data: PaginatedData<T, S, R>;
-            time: number;
-        }>;
-        exists: (returnType?: "millis" | "seconds") => Promise<{
-            data: boolean;
-            time: number;
-        }>;
-        paginateWithCursor: (page: number, options: PaginateWithCursorOptions<T, ModelKey<T>>, cursor?: Cursor<T, ModelKey<T>>, returnType?: "millis" | "seconds") => Promise<{
-            data: [CursorPaginatedData<T, S, R>, Cursor<T, ModelKey<T>>];
-            time: number;
-        }>;
-        truncate: (returnType?: "millis" | "seconds") => Promise<{
-            data: void;
-            time: number;
-        }>;
-        delete: (returnType?: "millis" | "seconds") => Promise<{
-            data: number;
-            time: number;
-        }>;
-        update: (data: Partial<ModelWithoutRelations<T>>, options?: UpdateOptions, returnType?: "millis" | "seconds") => Promise<{
-            data: MutationReturningResult<T, ReturningParam<T, D>>;
-            time: number;
-        }>;
-        softDelete: (options?: Omit<SoftDeleteOptions<T>, "ignoreBeforeDeleteHook">, returnType?: "millis" | "seconds") => Promise<{
-            data: number;
-            time: number;
-        }>;
-        pluck: (key: RawModelKey<T>, returnType?: "millis" | "seconds") => Promise<{
-            data: PluckReturnType<T, RawModelKey<T>>;
-            time: number;
-        }>;
-        insert: (data: Partial<ModelWithoutRelations<T>>, returnType?: "millis" | "seconds") => Promise<{
-            data: "*" extends "*" | RawModelKey<T> ? Simplify<ModelQueryResult<T>, never> : Simplify<{ [K in ("*" | RawModelKey<T>) & string & keyof T]: T[K]; }, never>;
-            time: number;
-        }>;
-        insertMany: (data: Partial<ModelWithoutRelations<T>>[], returnType?: "millis" | "seconds") => Promise<{
-            data: "*" extends "*" | RawModelKey<T> ? Simplify<ModelQueryResult<T>, never>[] : Simplify<{ [K in ("*" | RawModelKey<T>) & string & keyof T]: T[K]; }, never>[];
-            time: number;
-        }>;
-    };
     constructor(model: typeof Model, sqlDataSource: SqlDataSource);
     /**
      * @description Returns true if the query builder is a relation query builder, this changes the behavior of the query builder like limit, offset, etc.
@@ -6496,19 +6498,6 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
     protected getFilterValuesFromModelsForRelation(relation: Relation, models: T[]): any[];
     protected applyHavingRelatedFilter(relationQueryBuilder: ModelQueryBuilder<any>, relation: Relation, operator?: BinaryOperatorType$2, value?: BaseValues$2): void;
     protected addAdditionalColumnsToModel(row: any): Record<string, any>;
-    private manyWithPerformance;
-    private oneWithPerformance;
-    private oneOrFailWithPerformance;
-    private paginateWithPerformance;
-    private paginateWithCursorWithPerformance;
-    private existsWithPerformance;
-    private pluckWithPerformance;
-    private softDeleteWithPerformance;
-    private updateWithPerformance;
-    private deleteWithPerformance;
-    private truncateWithPerformance;
-    private insertWithPerformance;
-    private insertManyWithPerformance;
 }
 
 /**
@@ -6561,6 +6550,10 @@ declare abstract class Model<T extends Model<T> = any> extends Entity {
     static getIndexes(): IndexType[];
     static getUniques(): UniqueType[];
     static getChecks(): CheckType[];
+    static validate(data: any): Promise<{
+        valid: boolean;
+        errors?: Record<string, string[]>;
+    }>;
 }
 
 /**
@@ -6590,6 +6583,8 @@ interface RelationDef<T = any> {
 }
 type ColOptions = Omit<ColumnOptions, "primaryKey" | "serialize" | "prepare" | "default"> & {
     length?: number;
+    /** Per-column validators (optional) */
+    validate?: Validator | Validator[];
 };
 type ColPrimaryOptions = Omit<ColumnOptions, "primaryKey" | "serialize" | "prepare" | "default">;
 type ColStringOptions = Omit<ColumnOptions, "type" | "serialize" | "prepare" | "default"> & {
@@ -6680,7 +6675,6 @@ type TypedPrepare<T> = {
 };
 type TypedDefault<T> = {
     /**
-     * Narrows the `default` property to the column's base type.
      * @migration Migration-only metadata. Sets the DEFAULT clause in CREATE TABLE / ALTER TABLE.
      * Does **not** enforce a value during `insert()` — pass the value explicitly or use `prepare`.
      */
@@ -7794,6 +7788,13 @@ declare class RedisDataSource {
     protected static getValue<T = RedisFetchable>(value: string | null): T | null;
 }
 
+declare class ObserverChainWrapper {
+    private chain;
+    constructor(observers?: QueryObserver[]);
+    get chainInstance(): ObserverChain;
+    add(observer: QueryObserver): void;
+}
+
 declare class Schema {
     queryStatements: string[];
     sqlType: SqlDataSourceType;
@@ -7985,16 +7986,7 @@ declare abstract class BaseSeeder {
     abstract run(): Promise<void>;
 }
 
-type WithPerformanceResult<R = any> = [string, R];
-/**
- * @description executes the async function with a timer to check how long it took
- * @param `returnType` of the performance in milliseconds or seconds
- * @param `fix` Number of digits in the decimal part of the performance result
- * @returns An array with the millis or seconds that the function took as first element, and the result of the async function as second element
- */
-declare const withPerformance: <A extends any[], R>(fn: (...args: A) => Promise<R>, returnType?: "millis" | "seconds", fix?: number) => (...args: A) => Promise<WithPerformanceResult<R>>;
-
-type HysteriaErrorCode = "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_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 = "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_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" | `SCOPE_NOT_FOUND_${string}`;
 
 declare class HysteriaError extends Error {
     code: HysteriaErrorCode;
@@ -8002,6 +7994,56 @@ declare class HysteriaError extends Error {
     error?: Error;
     constructor(caller: string, code: HysteriaErrorCode, error?: Error);
 }
+declare class ValidationError extends HysteriaError {
+    errors: Record<string, string[]>;
+    constructor(errors: Record<string, string[]>);
+}
+
+/**
+ * @description Field is required and will throw if not provided
+ * @throws HysteriaError with code VALIDATION_ERROR
+ */
+declare const required: Validator;
+/**
+ * @description Field must have a minimum length, null is allowed
+ * @throws HysteriaError with code VALIDATION_ERROR
+ */
+declare const minLength: (min: number) => Validator;
+/**
+ * @description Field must have a maximum length, null is allowed
+ * @throws HysteriaError with code VALIDATION_ERROR
+ */
+declare const maxLength: (max: number) => Validator;
+/**
+ * @description Field must have a minimum value, null is allowed
+ * @throws HysteriaError with code VALIDATION_ERROR
+ */
+declare const min: (minValue: number) => Validator;
+/**
+ * @description Field must have a maximum value, null is allowed
+ * @throws HysteriaError with code VALIDATION_ERROR
+ */
+declare const max: (maxValue: number) => Validator;
+/**
+ * @description Field must match a regex, null is allowed
+ * @throws HysteriaError with code VALIDATION_ERROR
+ */
+declare const pattern: (regex: RegExp) => Validator;
+/**
+ * @description Field must be a valid email, null is allowed
+ * @throws HysteriaError with code VALIDATION_ERROR
+ */
+declare const email: Validator;
+/**
+ * @description Field must be a valid url, null is allowed
+ * @throws HysteriaError with code VALIDATION_ERROR
+ */
+declare const url: Validator;
+/**
+ * @description Field must be a valid enum value, null is allowed
+ * @throws HysteriaError with code VALIDATION_ERROR
+ */
+declare const enumValidator: (allowed: readonly string[]) => Validator;
 
 interface PropertyDef<T = unknown> {
     _phantom: T;
@@ -8082,4 +8124,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 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, type OneOptions, type OracleDBDataSourceInput, type OracleDBPoolInstance, type PgPoolClientInstance, type PostgresSqlDataSourceInput, type PrimaryColumnDef, type PropNamespace, type PropertyDef, QueryBuilder, 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$1 as 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 ViewDefinition, WriteOperation, type WriteReturnType, col, createSchema, defineCollection, defineMigrator, defineModel, defineModelFactory, defineRelations, defineView, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, type getPoolReturnType, HysteriaLogger as logger, prop, RedisDataSource as redis, withPerformance };
+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 };