hysteria-orm 11.0.0 → 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"
@@ -213,7 +206,7 @@ declare class RawNode extends QueryNode {
 }
 
 type BaseValues$2 = string | number | boolean | undefined | null | RawNode;
-type BinaryOperatorType$2 = "=" | "!=" | "<>" | ">" | "<" | ">=" | "<=" | "is" | "is not" | "like" | "not like" | "is null" | "is not null" | "ilike" | "in" | "not in" | "between" | "not between" | "regexp" | "not regexp" | "not ilike";
+type BinaryOperatorType$2 = "=" | "!=" | "<>" | ">" | "<" | ">=" | "<=" | "is" | "is not" | "like" | "not like" | "is null" | "is not null" | "ilike" | "in" | "not in" | "between" | "not between" | "regexp" | "not regexp" | "not ilike" | (string & {});
 declare class WhereNode extends QueryNode {
     column: string;
     isNegated: boolean;
@@ -840,6 +833,11 @@ type SqlDataSourceInputBase<T extends Record<string, SqlDataSourceModel> = {}, C
      * @description To use AdminJS, install: `npm install adminjs`
      */
     adminJs?: AdminJsOptions;
+    /**
+     * @description If true, the data source will not throw when unconnected — it will auto-connect on the first query execution.
+     * @default false
+     */
+    lazyLoad?: boolean;
 };
 /**
  * @description Maps a SqlDataSourceType to its corresponding input interface
@@ -934,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";
@@ -1795,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[];
@@ -1969,8 +2016,6 @@ declare class ModelManager<T extends Model> {
     private applyFieldCondition;
 }
 
-type JsonPathInput = string | (string | number)[];
-
 declare class DeleteNode extends QueryNode {
     fromNode: FromNode;
     returning?: string[];
@@ -2107,6 +2152,8 @@ declare class MongoQueryBuilder<T extends Collection> {
     protected logs: boolean | LoggerConfig;
     protected session?: ReturnType<MongoDataSource["startSession"]>;
     constructor(model: typeof Collection, mongoDataSource: MongoDataSource, _session?: ReturnType<MongoDataSource["startSession"]>, logs?: boolean | LoggerConfig);
+    private initCollection;
+    protected ensureInitialized(): Promise<void>;
     one(options?: OneOptions$1): Promise<T | null>;
     oneOrFail(options?: OneOptions$1): Promise<T>;
     many(options?: ManyOptions$1): Promise<T[]>;
@@ -2414,6 +2461,8 @@ declare class CollectionManager<T extends Collection> {
     protected collectionInstance: MongoClientImport["Collection"]["prototype"];
     protected session?: ReturnType<MongoDataSource["startSession"]>;
     constructor(_collection: typeof Collection, mongoDataSource: MongoDataSource, session?: ReturnType<MongoDataSource["startSession"]>, logs?: boolean | LoggerConfig);
+    private initConnection;
+    protected ensureInitialized(): Promise<void>;
     /**
      * @description Finds all records that match the input
      */
@@ -2460,17 +2509,24 @@ interface MongoDataSourceInput {
     url?: string;
     options?: MongoConnectionOptions;
     logs?: boolean | LoggerConfig;
+    lazyLoad?: boolean;
 }
 declare class MongoDataSource extends DataSource {
     url: string;
     isConnected: boolean;
     private mongoClient;
     private mongoOptions?;
+    private lazyLoad;
+    private connecting;
     constructor(input?: MongoDataSourceInput);
     /**
      * @description Establishes the connection to MongoDB
      */
     connect(): Promise<void>;
+    /**
+     * @description Ensures the connection is established. If lazyLoad is true and not connected, connects automatically.
+     */
+    ensureConnected(): Promise<void>;
     /**
      * @description Returns the current connection to the mongo client to execute direct statements using the mongo client from `mongodb` package
      */
@@ -2488,18 +2544,29 @@ declare class MongoDataSource extends DataSource {
      * @alias disconnect
      */
     closeConnection(): Promise<void>;
-    /**
-     * @description Returns a raw MongoQueryBuilder for a collection name string
-     */
-    query(collectionName: string): MongoQueryBuilder<Collection>;
     /**
      * @description Returns a CollectionManager for the given collection class,
      * providing query(), find(), findOne(), insert(), etc.
+     * When a string is passed, returns a raw MongoQueryBuilder for the collection name.
      */
     from<T extends Collection>(collection: (new (...args: any[]) => T) & Record<string, any>, options?: {
         session?: InstanceType<MongoClientImport["ClientSession"]>;
     }): 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;
@@ -2543,7 +2610,7 @@ declare class HavingNode extends QueryNode {
     constructor(column: string, chainsWith: "and" | "or", isNegated: boolean | undefined, operator: BinaryOperatorType, value: BaseValues | BaseValues[], isRawValue?: boolean);
 }
 
-type SubqueryOperatorType = "in" | "not in" | "exists" | "not exists" | "between" | "not between" | ">" | "<" | ">=" | "<=";
+type SubqueryOperatorType = "in" | "not in" | "exists" | "not exists" | "between" | "not between" | ">" | "<" | ">=" | "<=" | (string & {});
 declare class WhereSubqueryNode extends QueryNode {
     column: string;
     operator: SubqueryOperatorType;
@@ -2564,199 +2631,439 @@ 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.
- * @example
- * col<string>({ type: "varchar", length: 255 }) // built-in
- * col<string>({ type: "vector", length: 1536 })  // custom (pgvector)
+ * A tuple type for selecting a column with an alias.
+ * @example ["id", "userId"] selects "id" column as "userId"
  */
-type ColumnDataType = BaseColumnDataType | (string & {}) | readonly string[];
-type ColumnDataTypeOptionWithLength = {
-    type?: "char" | "varchar" | "string" | "uuid" | "ulid" | "varbinary" | "integer" | "tinyint" | "smallint" | "mediumint" | "bigint" | "increment" | "bigIncrement";
-    length?: number;
-};
-type ColumnDataTypeOptionWithEnum = {
-    type?: readonly string[];
-};
-type ColumnDataTypeOptionWithPrecision = {
-    type?: "float" | "double" | "real";
-    precision?: number;
-};
-type ColumnDataTypeOptionWithScaleAndPrecision = {
-    type?: "decimal" | "numeric";
-    precision?: number;
-    scale?: number;
-};
-type ColumnDataTypeOptionWithText = {
-    type?: "text" | "longtext" | "mediumtext" | "tinytext";
-};
-type ColumnDataTypeOptionWithBinary = {
-    type?: "binary" | "blob" | "tinyblob" | "mediumblob" | "longblob";
-};
-type ColumnDataTypeOptionWithDatePrecision = {
-    type?: "date" | "time" | "datetime" | "timestamp";
-    precision?: number;
-    withTimezone?: boolean;
-};
-type ColumnDataTypeOptionSimple = {
-    type?: "year" | "boolean" | "json" | "jsonb";
-};
+type SelectTuple<C extends string = string, A extends string = string> = readonly [column: C, alias: A];
 /**
- * Custom column type for database extensions (e.g., pgvector).
- * The type string is passed through as-is to the SQL interpreter.
+ * Input type for select() method in raw query builder.
+ * Accepts either a column string or a [column, alias] tuple.
+ *
  * @example
- * col<string>({ type: "vector", length: 1536 }) // PostgreSQL pgvector
- * col<string>({ type: "geometry" })              // PostGIS
+ * .select("id", "name")                    // Simple columns
+ * .select(["id", "userId"], ["name", "n"]) // Columns with aliases
+ * .select("id", ["name", "userName"])      // Mixed
  */
-type ColumnDataTypeOptionCustom = {
-    /**
-     * Custom database column type. Passes through as-is to SQL.
-     * Supports extensions like pgvector, PostGIS, etc.
-     */
-    type?: string & {};
-    /**
-     * Optional length for custom types (e.g., vector(1536)).
-     */
-    length?: number;
-};
-type ColumnDataTypeOption = ColumnDataTypeOptionWithLength | ColumnDataTypeOptionWithPrecision | ColumnDataTypeOptionWithScaleAndPrecision | ColumnDataTypeOptionWithText | ColumnDataTypeOptionWithBinary | ColumnDataTypeOptionWithDatePrecision | ColumnDataTypeOptionWithEnum | ColumnDataTypeOptionSimple | ColumnDataTypeOptionCustom;
-type LazyRelationType = {
-    type?: RelationEnum;
-    columnName: string;
-    model: () => AnyModelConstructor;
-    foreignKey: string | (() => string);
-    constraintName: string | (() => string);
-    onDelete?: OnUpdateOrDelete;
-    onUpdate?: OnUpdateOrDelete;
-    /**
-     * @description Only for many to many relations
-     */
-    manyToManyOptions?: {
-        primaryModel: string;
-        throughModel: string | (() => string);
-        leftForeignKey: string | (() => string);
-        rightForeignKey: string | (() => string);
-        wasModelProvided: boolean;
-    };
-};
+type Selectable = string | SelectTuple;
 /**
- * Callback type for autoCreate/autoUpdate hooks on date columns.
- * Returns `Date` when used with date-mode columns (e.g. `col.datetime()`),
+ * 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;
+};
+type ColumnDataTypeOptionWithEnum = {
+    type?: readonly string[];
+};
+type ColumnDataTypeOptionWithPrecision = {
+    type?: "float" | "double" | "real";
+    precision?: number;
+};
+type ColumnDataTypeOptionWithScaleAndPrecision = {
+    type?: "decimal" | "numeric";
+    precision?: number;
+    scale?: number;
+};
+type ColumnDataTypeOptionWithText = {
+    type?: "text" | "longtext" | "mediumtext" | "tinytext";
+};
+type ColumnDataTypeOptionWithBinary = {
+    type?: "binary" | "blob" | "tinyblob" | "mediumblob" | "longblob";
+};
+type ColumnDataTypeOptionWithDatePrecision = {
+    type?: "date" | "time" | "datetime" | "timestamp";
+    precision?: number;
+    withTimezone?: boolean;
+};
+type ColumnDataTypeOptionSimple = {
+    type?: "year" | "boolean" | "json" | "jsonb";
+};
+/**
+ * Custom column type for database extensions (e.g., pgvector).
+ * The type string is passed through as-is to the SQL interpreter.
+ * @example
+ * col<string>({ type: "vector", length: 1536 }) // PostgreSQL pgvector
+ * col<string>({ type: "geometry" })              // PostGIS
+ */
+type ColumnDataTypeOptionCustom = {
+    /**
+     * Custom database column type. Passes through as-is to SQL.
+     * Supports extensions like pgvector, PostGIS, etc.
+     */
+    type?: string & {};
+    /**
+     * Optional length for custom types (e.g., vector(1536)).
+     */
+    length?: number;
+};
+type ColumnDataTypeOption = ColumnDataTypeOptionWithLength | ColumnDataTypeOptionWithPrecision | ColumnDataTypeOptionWithScaleAndPrecision | ColumnDataTypeOptionWithText | ColumnDataTypeOptionWithBinary | ColumnDataTypeOptionWithDatePrecision | ColumnDataTypeOptionWithEnum | ColumnDataTypeOptionSimple | ColumnDataTypeOptionCustom;
+type LazyRelationType = {
+    type?: RelationEnum;
+    columnName: string;
+    model: () => AnyModelConstructor;
+    foreignKey: string | (() => string);
+    constraintName: string | (() => string);
+    onDelete?: OnUpdateOrDelete;
+    onUpdate?: OnUpdateOrDelete;
+    /**
+     * @description Only for many to many relations
+     */
+    manyToManyOptions?: {
+        primaryModel: string;
+        throughModel: string | (() => string);
+        leftForeignKey: string | (() => string);
+        rightForeignKey: string | (() => string);
+        wasModelProvided: boolean;
+    };
+};
+/**
+ * Callback type for autoCreate/autoUpdate hooks on date columns.
+ * Returns `Date` when used with date-mode columns (e.g. `col.datetime()`),
  * returns `string` when used with string-mode columns (e.g. `col.datetime.string()`).
  */
 type DateAutoHook = (() => Date) | (() => string);
@@ -2860,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
@@ -2889,6 +3200,7 @@ type ColumnType = {
         nullable?: boolean;
         default?: string | number | null | boolean;
     };
+    validate?: Validator | Validator[];
 };
 type IndexType = {
     columns: string[];
@@ -2935,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
      */
@@ -2944,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
      */
@@ -2971,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.
      */
@@ -3295,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
@@ -3342,29 +3654,54 @@ 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 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.
+     * @param column - The column containing JSON data (model column name or raw string).
+     * @param path - The JSON path to extract. Accepts dot notation (`"user.name"`), `$`-prefixed
+     *   paths (`"$.user.name"`), or an array of segments (`["user", "name"]`).
+     *   When the column has a typed JSON schema, IDE autocompletion suggests valid paths.
+     * @param alias - The alias for the extracted value in the result set.
      */
-    selectJson<A extends string>(column: ModelKey<T>, path: JsonPathInput, alias: A): this;
+    selectJson<K extends ModelKey<T>, A extends string>(column: K, path: TypedJsonPathInput<ResolveColumnType<T, K & string>>, alias: A): this;
     selectJson<A extends string>(column: string, path: JsonPathInput, alias: A): this;
     /**
-     * @description Selects a JSON value at the specified path and returns it as text
+     * @description Selects a JSON value at the specified path and returns it as text.
+     * @description Path format is standardized across all databases — the ORM converts to DB-specific syntax.
+     * @param column - The column containing JSON data (model column name or raw string).
+     * @param path - The JSON path to extract. Accepts dot notation (`"user.name"`), `$`-prefixed
+     *   paths (`"$.user.name"`), or an array of segments (`["user", "name"]`).
+     *   When the column has a typed JSON schema, IDE autocompletion suggests valid paths.
+     * @param alias - The alias for the extracted text value in the result set.
      */
-    selectJsonText<A extends string>(column: ModelKey<T>, path: JsonPathInput, alias: A): this;
+    selectJsonText<K extends ModelKey<T>, A extends string>(column: K, path: TypedJsonPathInput<ResolveColumnType<T, K & string>>, alias: A): this;
     selectJsonText<A extends string>(column: string, path: JsonPathInput, alias: A): this;
     /**
-     * @description Selects the length of a JSON array
+     * @description Selects the length of a JSON array at the specified path.
+     * @description Path format is standardized across all databases — the ORM converts to DB-specific syntax.
+     * @param column - The column containing JSON array data (model column name or raw string).
+     * @param path - The JSON path to the array. Use `"$"` or `""` for the root array.
+     *   When the column has a typed JSON schema, IDE autocompletion suggests valid paths.
+     * @param alias - The alias for the array length value in the result set.
      */
-    selectJsonArrayLength<A extends string>(column: ModelKey<T>, path: JsonPathInput, alias: A): this;
+    selectJsonArrayLength<K extends ModelKey<T>, A extends string>(column: K, path: TypedJsonPathInput<ResolveColumnType<T, K & string>>, alias: A): this;
     selectJsonArrayLength<A extends string>(column: string, path: JsonPathInput, alias: A): this;
     /**
-     * @description Selects the keys of a JSON object
+     * @description Selects the keys of a JSON object at the specified path.
+     * @description Path format is standardized across all databases — the ORM converts to DB-specific syntax.
+     * @param column - The column containing JSON object data (model column name or raw string).
+     * @param path - The JSON path to the object. Use `"$"` or `""` for the root object.
+     *   When the column has a typed JSON schema, IDE autocompletion suggests valid paths.
+     * @param alias - The alias for the keys array in the result set.
      */
-    selectJsonKeys<A extends string>(column: ModelKey<T>, path: JsonPathInput, alias: A): this;
+    selectJsonKeys<K extends ModelKey<T>, A extends string>(column: K, path: TypedJsonPathInput<ResolveColumnType<T, K & string>>, alias: A): this;
     selectJsonKeys<A extends string>(column: string, path: JsonPathInput, alias: A): this;
     /**
-     * @description Adds a raw JSON select expression
+     * @description Adds a raw JSON select expression using database-specific SQL syntax.
+     * @description Bypasses path standardization — you must write DB-specific SQL.
+     * @param raw - The raw SQL expression (e.g., `"data->>'email'"` for PostgreSQL).
+     * @param alias - The alias for the result in the result set.
      */
     selectJsonRaw<A extends string>(raw: string, alias: A): this;
 }
@@ -3498,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.
@@ -3600,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.
      */
@@ -3838,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[];
@@ -3859,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
@@ -4265,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
@@ -4448,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
@@ -4541,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
      */
@@ -4553,10 +4841,26 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Callback to handle slave server failures
      */
     private onSlaveServerFailure?;
+    private lazyLoad;
+    private connecting;
     /**
      * @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.
@@ -4607,6 +4911,10 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Returns true if the connection is established
      */
     get isConnected(): boolean;
+    /**
+     * @description Ensures the connection is established. If lazyLoad is true and not connected, connects automatically.
+     */
+    ensureConnected(): Promise<void>;
     /**
      * @description Returns true if this instance is in a global transaction
      */
@@ -4753,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
@@ -4846,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')
@@ -5044,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".
@@ -5066,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"
@@ -5081,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.
@@ -5199,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>;
 /**
@@ -5436,244 +5758,98 @@ type FindReturnType<T extends Model, S extends ModelKey<T>[] = any[], R extends
     [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;
+} & {
+    [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;
@@ -5729,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.
@@ -6039,12 +6159,16 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
      */
     clearSelect(): ModelQueryBuilder<T, ModelWithoutRelations<T>, R>;
     /**
-     * @description Selects a JSON value at the specified path and returns it as JSON
-     * @param column The column containing JSON data
-     * @param path The JSON path to extract (standardized format: "$.user.name", "user.name", or ["user", "name"])
-     * @param alias The alias for the selected value
-     * @description Path format is standardized across all databases - ORM converts to DB-specific syntax
-     * @description Result is available as a direct property on the model with the alias name
+     * @description Selects a JSON value at the specified path and returns it as JSON.
+     * @param column - The column containing JSON data. Accepts model column names (with IDE autocompletion)
+     *   or raw column strings for joins/aliases.
+     * @param path - The JSON path to extract. Accepts dot notation (`"user.name"`), `$`-prefixed paths
+     *   (`"$.user.name"`), or an array of segments (`["user", "name"]`).
+     *   When the column has a typed JSON schema (e.g. `col.jsonb<{ user: { name: string } }>()`),
+     *   IDE autocompletion suggests valid paths into the JSON structure.
+     * @param alias - The alias for the extracted value. The result is available as a typed property
+     *   on the returned model with this alias name.
+     * @description Path format is standardized across all databases - ORM converts to DB-specific syntax.
      * @example
      * ```ts
      * // All these path formats are supported:
@@ -6072,16 +6196,19 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
      * console.log(user?.userName); // Typed as string
      * ```
      */
-    selectJson<ValueType = any, Alias extends string = string>(column: ModelKey<T> | string, path: JsonPathInput, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: ValueType;
+    selectJson<K extends ModelKey<T> | (string & {}), P extends [K] extends [ModelKey<T>] ? TypedJsonPathInput<ResolveColumnType<T, K & string>> : JsonPathInput, Alias extends string = string>(column: K, path: P, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
+        [Q in Alias]: [K] extends [ModelKey<T>] ? P extends string ? ResolveJsonPathType<NonNullable<ResolveColumnType<T, K & string>>, P> extends infer R ? unknown extends R ? any : R : any : any : any;
     }>, R>;
     /**
-     * @description Selects a JSON value at the specified path and returns it as text
-     * @param column The column containing JSON data
-     * @param path The JSON path to extract (standardized format)
-     * @param alias The alias for the selected value
-     * @description Path format is standardized across all databases - ORM converts to DB-specific syntax
-     * @description Result is available as a direct property on the model with the alias name
+     * @description Selects a JSON value at the specified path and returns it as text.
+     * @param column - The column containing JSON data. Accepts model column names (with IDE autocompletion)
+     *   or raw column strings for joins/aliases.
+     * @param path - The JSON path to extract. Accepts dot notation (`"user.email"`), `$`-prefixed paths
+     *   (`"$.user.email"`), or an array of segments (`["user", "email"]`).
+     *   When the column has a typed JSON schema, IDE autocompletion suggests valid paths.
+     * @param alias - The alias for the extracted text value. The result is available as a typed property
+     *   on the returned model with this alias name.
+     * @description Path format is standardized across all databases - ORM converts to DB-specific syntax.
      * @example
      * ```ts
      * // All these path formats are supported:
@@ -6107,17 +6234,19 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
      * console.log(user?.userEmail); // Typed as string
      * ```
      */
-    selectJsonText<ValueType = string, Alias extends string = string>(column: ModelKey<T> | string, path: JsonPathInput, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: ValueType;
+    selectJsonText<K extends ModelKey<T> | (string & {}), ValueType = string, Alias extends string = string>(column: K, path: K extends ModelKey<T> ? TypedJsonPathInput<ResolveColumnType<T, K & string>> : JsonPathInput, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
+        [P in Alias]: ValueType;
     }>, R>;
     /**
-     * @description Selects the length of a JSON array
-     * @param column The column containing JSON array data
-     * @param path The JSON path to the array (standardized format, use "$" or "" for root)
-     * @param alias The alias for the length value
-     * @description Path format is standardized across all databases - ORM converts to DB-specific syntax
-     * @description Result is available as a direct property on the model with the alias name
-     * @warning Not supported in SQLite
+     * @description Selects the length of a JSON array at the specified path.
+     * @param column - The column containing JSON array data. Accepts model column names (with IDE autocompletion)
+     *   or raw column strings for joins/aliases.
+     * @param path - The JSON path to the array. Use `"$"` or `""` for root.
+     *   When the column has a typed JSON schema, IDE autocompletion suggests valid paths.
+     * @param alias - The alias for the array length value. The result is available as a typed property
+     *   on the returned model with this alias name.
+     * @description Path format is standardized across all databases - ORM converts to DB-specific syntax.
+     * @warning Not supported in SQLite.
      * @example
      * ```ts
      * // All these path formats are supported:
@@ -6147,19 +6276,21 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
      * console.log(user?.count); // Typed as number
      * ```
      */
-    selectJsonArrayLength<ValueType = number, Alias extends string = string>(column: ModelKey<T> | string, path: JsonPathInput, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: ValueType;
+    selectJsonArrayLength<K extends ModelKey<T> | (string & {}), ValueType = number, Alias extends string = string>(column: K, path: K extends ModelKey<T> ? TypedJsonPathInput<ResolveColumnType<T, K & string>> : JsonPathInput, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
+        [P in Alias]: ValueType;
     }>, R>;
     /**
-     * @description Selects the keys of a JSON object
-     * @param column The column containing JSON object data
-     * @param path The JSON path to the object (standardized format, use "$" or "" for root)
-     * @param alias The alias for the keys
-     * @description Path format is standardized across all databases - ORM converts to DB-specific syntax
-     * @description Result is available as a direct property on the model with the alias name
-     * @warning Not supported in SQLite or MSSQL
-     * @postgresql Returns a native array of keys
-     * @mysql Returns a JSON array of keys
+     * @description Selects the keys of a JSON object at the specified path.
+     * @param column - The column containing JSON object data. Accepts model column names (with IDE autocompletion)
+     *   or raw column strings for joins/aliases.
+     * @param path - The JSON path to the object. Use `"$"` or `""` for root.
+     *   When the column has a typed JSON schema, IDE autocompletion suggests valid paths.
+     * @param alias - The alias for the keys array. The result is available as a typed property
+     *   on the returned model with this alias name.
+     * @description Path format is standardized across all databases - ORM converts to DB-specific syntax.
+     * @warning Not supported in SQLite or MSSQL.
+     * @postgresql Returns a native array of keys.
+     * @mysql Returns a JSON array of keys.
      * @example
      * ```ts
      * // All these path formats are supported:
@@ -6189,16 +6320,18 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
      * console.log(user?.keys); // Typed as string[] - ["theme", "fontSize", "autoSave"]
      * ```
      */
-    selectJsonKeys<ValueType = string[], Alias extends string = string>(column: ModelKey<T> | string, path: JsonPathInput, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: ValueType;
+    selectJsonKeys<K extends ModelKey<T> | (string & {}), ValueType = string[], Alias extends string = string>(column: K, path: K extends ModelKey<T> ? TypedJsonPathInput<ResolveColumnType<T, K & string>> : JsonPathInput, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
+        [P in Alias]: ValueType;
     }>, R>;
     /**
-     * @description Adds a raw JSON select expression for database-specific operations
-     * @param raw The raw SQL expression (database-specific syntax)
-     * @param alias The alias for the selected value
-     * @description Result is available as a direct property on the model with the alias name
-     * @description Use this for advanced JSON operations not covered by other selectJson* methods
-     * @warning This bypasses path standardization - you must write database-specific SQL
+     * @description Adds a raw JSON select expression using database-specific SQL syntax.
+     * @param raw - The raw SQL expression (database-specific syntax). Bypasses path standardization —
+     *   you must write DB-specific SQL (e.g., `"data->>'email'"` for PostgreSQL,
+     *   `"json_extract(data, '$.email')"` for SQLite).
+     * @param alias - The alias for the extracted value. The result is available as a typed property
+     *   on the returned model with this alias name.
+     * @description Use this for advanced JSON operations not covered by other selectJson* methods.
+     * @warning This bypasses path standardization - you must write database-specific SQL.
      * @example
      * ```ts
      * // PostgreSQL - Extract as text with ->> operator
@@ -6365,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;
 }
 
 /**
@@ -6430,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[]>;
+    }>;
 }
 
 /**
@@ -6459,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"> & {
@@ -6549,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`.
      */
@@ -7290,79 +7415,33 @@ type RedisFetchable = string | number | boolean | Record<string, any> | Array<an
  * @description Type for Redis message handler callback
  */
 type RedisMessageHandler = (channel: string, message: string) => void;
+interface RedisDataSourceInput extends RedisOptions {
+    lazyLoad?: boolean;
+}
 /**
  * @description The RedisDataSource class is a wrapper around the ioredis library that provides a simple interface to interact with a redis database
  */
 declare class RedisDataSource {
-    static readonly OK = "OK";
     readonly OK = "OK";
-    static isConnected: boolean;
-    protected static redisDataSourceInstance: RedisDataSource;
     isConnected: boolean;
-    protected ioRedisConnection: Redis;
-    constructor(ioRedisConnection: Redis);
-    /**
-     * @description Returns the raw ioredis connection
-     * @returns {Redis}
-     */
-    static get ioredis(): Redis;
+    protected ioRedisConnection: Redis | null;
+    private inputOptions;
+    private lazyLoad;
+    private connecting;
+    constructor(input?: RedisDataSourceInput);
     /**
      * @description Returns the raw ioredis connection
      * @returns {Redis}
      */
     get ioredis(): Redis;
     /**
-     * @description Connects to the redis database establishing a connection. If no connection details are provided, the default values from the env will be taken instead
-     * @description The User input connection details will always come first
-     * @description This is intended as a singleton connection to the redis database, if you need multiple connections, use the getConnection method
-     */
-    static connect(input?: RedisOptions): Promise<void>;
-    /**
-     * @description Establishes a connection to the redis database and returns the connection
-     * @param input
-     * @returns
-     */
-    static getConnection(input?: RedisOptions): Promise<RedisDataSource>;
-    /**
-     * @description Sets a key-value pair in the redis database
-     * @param {string} key - The key
-     * @param {string} value - The value
-     * @param {number} expirationTime - The expiration time in milliseconds
-     */
-    static set(key: string, value: RedisStorable, expirationTime?: number): Promise<void>;
-    /**
-     * @description Gets the value of a key in the redis database
-     * @param {string} key - The key
-     * @returns {Promise<string>}
-     */
-    static get<T = RedisFetchable>(key: string): Promise<T | null>;
-    /**
-     * @description Gets the value of a key in the redis database as a buffer
-     */
-    static getBuffer(key: string): Promise<Buffer | null>;
-    /**
-     * @description Gets the value of a key in the redis database and deletes the key
-     * @param {string} key - The key
-     * @returns {Promise
-     * <T | null>}
-     */
-    static consume<T = RedisFetchable>(key: string): Promise<T | null>;
-    /**
-     * @description Deletes a key from the redis database
-     * @param {string} key - The key
-     * @returns {Promise<void>}
-     */
-    static delete(key: string): Promise<void>;
-    /**
-     * @description Flushes all the data in the redis database
-     * @returns {Promise<void>}
+     * @description Establishes a connection to the redis database. The ioredis driver is dynamically imported.
      */
-    static flushAll(): Promise<void>;
+    connect(): Promise<void>;
     /**
-     * @description Disconnects from the redis database
-     * @returns {Promise<void>}
+     * @description Ensures the connection is established. If lazyLoad is true and not connected, connects automatically.
      */
-    static disconnect(): Promise<void>;
+    private ensureConnected;
     /**
      * @description Sets a key-value pair in the redis database
      * @param {string} key - The key
@@ -7396,54 +7475,14 @@ declare class RedisDataSource {
     delete(key: string): Promise<void>;
     /**
      * @description Flushes all the data in the redis database
-     * @returns {Promise<void>}
-     */
-    flushAll(): Promise<void>;
-    /**
-     * @description Disconnects from the redis database
-     * @returns {Promise<void>}
-     */
-    disconnect(forceError?: boolean): Promise<void>;
-    /**
-     * @description Adds one or more values to the beginning of a list
-     * @param {string} key - The key of the list
-     * @param {RedisStorable[]} values - The values to add
-     * @returns {Promise<number>} - The length of the list after the push operation
-     */
-    static lpush(key: string, ...values: RedisStorable[]): Promise<number>;
-    /**
-     * @description Adds one or more values to the end of a list
-     * @param {string} key - The key of the list
-     * @param {RedisStorable[]} values - The values to add
-     * @returns {Promise<number>} - The length of the list after the push operation
-     */
-    static rpush(key: string, ...values: RedisStorable[]): Promise<number>;
-    /**
-     * @description Removes and returns the first element of a list
-     * @param {string} key - The key of the list
-     * @returns {Promise<T | null>} - The popped value
-     */
-    static lpop<T = RedisFetchable>(key: string): Promise<T | null>;
-    /**
-     * @description Removes and returns the last element of a list
-     * @param {string} key - The key of the list
-     * @returns {Promise<T | null>} - The popped value
-     */
-    static rpop<T = RedisFetchable>(key: string): Promise<T | null>;
-    /**
-     * @description Gets a range of elements from a list
-     * @param {string} key - The key of the list
-     * @param {number} start - The starting index
-     * @param {number} stop - The stopping index
-     * @returns {Promise<T[]>} - Array of elements in the specified range
+     * @returns {Promise<void>}
      */
-    static lrange<T = RedisFetchable>(key: string, start: number, stop: number): Promise<T[]>;
+    flushAll(): Promise<void>;
     /**
-     * @description Gets the length of a list
-     * @param {string} key - The key of the list
-     * @returns {Promise<number>} - The length of the list
+     * @description Disconnects from the redis database
+     * @returns {Promise<void>}
      */
-    static llen(key: string): Promise<number>;
+    disconnect(forceError?: boolean): Promise<void>;
     /**
      * @description Adds one or more values to the beginning of a list
      * @param {string} key - The key of the list
@@ -7484,67 +7523,6 @@ declare class RedisDataSource {
      * @returns {Promise<number>} - The length of the list
      */
     llen(key: string): Promise<number>;
-    /**
-     * @description Sets field in the hash stored at key to value
-     * @param {string} key - The key of the hash
-     * @param {string} field - The field to set
-     * @param {RedisStorable} value - The value to set
-     * @returns {Promise<number>} - 1 if field is a new field and value was set, 0 if field already exists and the value was updated
-     */
-    static hset(key: string, field: string, value: RedisStorable): Promise<number>;
-    /**
-     * @description Sets multiple fields in the hash stored at key to their respective values
-     * @param {string} key - The key of the hash
-     * @param {Record<string, RedisStorable>} hash - Object containing field-value pairs
-     * @returns {Promise<string>} - "OK" if successful
-     */
-    static hmset(key: string, hash: Record<string, RedisStorable>): Promise<string>;
-    /**
-     * @description Gets the value of a field in a hash
-     * @param {string} key - The key of the hash
-     * @param {string} field - The field to get
-     * @returns {Promise<T | null>} - The value of the field
-     */
-    static hget<T = RedisFetchable>(key: string, field: string): Promise<T | null>;
-    /**
-     * @description Gets all the fields and values in a hash
-     * @param {string} key - The key of the hash
-     * @returns {Promise<Record<string, T>>} - Object containing field-value pairs
-     */
-    static hgetall<T = RedisFetchable>(key: string): Promise<Record<string, T>>;
-    /**
-     * @description Gets values for multiple fields in a hash
-     * @param {string} key - The key of the hash
-     * @param {string[]} fields - The fields to get
-     * @returns {Promise<Array<T | null>>} - Array of values
-     */
-    static hmget<T = RedisFetchable>(key: string, ...fields: string[]): Promise<Array<T | null>>;
-    /**
-     * @description Deletes one or more fields from a hash
-     * @param {string} key - The key of the hash
-     * @param {string[]} fields - The fields to delete
-     * @returns {Promise<number>} - The number of fields that were removed
-     */
-    static hdel(key: string, ...fields: string[]): Promise<number>;
-    /**
-     * @description Checks if a field exists in a hash
-     * @param {string} key - The key of the hash
-     * @param {string} field - The field to check
-     * @returns {Promise<number>} - 1 if the field exists, 0 if not
-     */
-    static hexists(key: string, field: string): Promise<number>;
-    /**
-     * @description Gets all the fields in a hash
-     * @param {string} key - The key of the hash
-     * @returns {Promise<string[]>} - Array of field names
-     */
-    static hkeys(key: string): Promise<string[]>;
-    /**
-     * @description Gets the number of fields in a hash
-     * @param {string} key - The key of the hash
-     * @returns {Promise<number>} - The number of fields
-     */
-    static hlen(key: string): Promise<number>;
     /**
      * @description Sets field in the hash stored at key to value
      * @param {string} key - The key of the hash
@@ -7606,57 +7584,6 @@ declare class RedisDataSource {
      * @returns {Promise<number>} - The number of fields
      */
     hlen(key: string): Promise<number>;
-    /**
-     * @description Adds one or more members to a set
-     * @param {string} key - The key of the set
-     * @param {RedisStorable[]} members - The members to add
-     * @returns {Promise<number>} - The number of elements added to the set
-     */
-    static sadd(key: string, ...members: RedisStorable[]): Promise<number>;
-    /**
-     * @description Gets all members of a set
-     * @param {string} key - The key of the set
-     * @returns {Promise<T[]>} - Array of set members
-     */
-    static smembers<T = RedisFetchable>(key: string): Promise<T[]>;
-    /**
-     * @description Removes one or more members from a set
-     * @param {string} key - The key of the set
-     * @param {RedisStorable[]} members - The members to remove
-     * @returns {Promise<number>} - The number of members that were removed
-     */
-    static srem(key: string, ...members: RedisStorable[]): Promise<number>;
-    /**
-     * @description Determines whether a member belongs to a set
-     * @param {string} key - The key of the set
-     * @param {RedisStorable} member - The member to check
-     * @returns {Promise<number>} - 1 if the member exists in the set, 0 if not
-     */
-    static sismember(key: string, member: RedisStorable): Promise<number>;
-    /**
-     * @description Gets the number of members in a set
-     * @param {string} key - The key of the set
-     * @returns {Promise<number>} - The number of members in the set
-     */
-    static scard(key: string): Promise<number>;
-    /**
-     * @description Returns the intersection of multiple sets
-     * @param {string[]} keys - The keys of the sets to intersect
-     * @returns {Promise<T[]>} - Array of members in the intersection
-     */
-    static sinter<T = RedisFetchable>(...keys: string[]): Promise<T[]>;
-    /**
-     * @description Returns the union of multiple sets
-     * @param {string[]} keys - The keys of the sets to union
-     * @returns {Promise<T[]>} - Array of members in the union
-     */
-    static sunion<T = RedisFetchable>(...keys: string[]): Promise<T[]>;
-    /**
-     * @description Returns the difference between the first set and all successive sets
-     * @param {string[]} keys - The keys of the sets to diff
-     * @returns {Promise<T[]>} - Array of members in the difference
-     */
-    static sdiff<T = RedisFetchable>(...keys: string[]): Promise<T[]>;
     /**
      * @description Adds one or more members to a set
      * @param {string} key - The key of the set
@@ -7708,59 +7635,6 @@ declare class RedisDataSource {
      * @returns {Promise<T[]>} - Array of members in the difference
      */
     sdiff<T = RedisFetchable>(...keys: string[]): Promise<T[]>;
-    /**
-     * @description Adds a member to a sorted set, or updates the score of an existing member
-     * @param {string} key - The key of the sorted set
-     * @param {number} score - The score associated with the member
-     * @param {RedisStorable} member - The member to add or update
-     * @returns {Promise<number>} - The number of new members added to the sorted set
-     */
-    static zadd(key: string, score: number, member: RedisStorable): Promise<number>;
-    static zadd(key: string, scoreMembers: Array<[number, RedisStorable]>): Promise<number>;
-    /**
-     * @description Gets a range of members from a sorted set, ordered by score
-     * @param {string} key - The key of the sorted set
-     * @param {number} start - The starting index
-     * @param {number} stop - The stopping index
-     * @param {boolean} withScores - Whether to return the scores along with the members
-     * @returns {Promise<T[] | Array<{value: T, score: number}>>} - Array of members or [member, score] pairs
-     */
-    static zrange<T = RedisFetchable>(key: string, start: number, stop: number, withScores?: boolean): Promise<T[] | Array<{
-        value: T;
-        score: number;
-    }>>;
-    /**
-     * @description Gets a range of members from a sorted set, ordered by score in descending order
-     * @param {string} key - The key of the sorted set
-     * @param {number} start - The starting index
-     * @param {number} stop - The stopping index
-     * @param {boolean} withScores - Whether to return the scores along with the members
-     * @returns {Promise<T[] | Array<{value: T, score: number}>>} - Array of members or [member, score] pairs
-     */
-    static zrevrange<T = RedisFetchable>(key: string, start: number, stop: number, withScores?: boolean): Promise<T[] | Array<{
-        value: T;
-        score: number;
-    }>>;
-    /**
-     * @description Removes one or more members from a sorted set
-     * @param {string} key - The key of the sorted set
-     * @param {RedisStorable[]} members - The members to remove
-     * @returns {Promise<number>} - The number of members removed
-     */
-    static zrem(key: string, ...members: RedisStorable[]): Promise<number>;
-    /**
-     * @description Gets the score of a member in a sorted set
-     * @param {string} key - The key of the sorted set
-     * @param {RedisStorable} member - The member to get the score of
-     * @returns {Promise<number | null>} - The score of the member, or null if the member does not exist
-     */
-    static zscore(key: string, member: RedisStorable): Promise<number | null>;
-    /**
-     * @description Gets the number of members in a sorted set
-     * @param {string} key - The key of the sorted set
-     * @returns {Promise<number>} - The number of members in the sorted set
-     */
-    static zcard(key: string): Promise<number>;
     /**
      * @description Adds a member to a sorted set, or updates the score of an existing member
      * @param {string} key - The key of the sorted set
@@ -7814,39 +7688,6 @@ declare class RedisDataSource {
      * @returns {Promise<number>} - The number of members in the sorted set
      */
     zcard(key: string): Promise<number>;
-    /**
-     * @description Subscribes to one or more channels
-     * @param {string[]} channels - The channels to subscribe to
-     * @param {RedisMessageHandler} handler - The function to call when a message is received
-     * @returns {Promise<void>}
-     */
-    static subscribe(channels: string[], handler: RedisMessageHandler): Promise<void>;
-    /**
-     * @description Unsubscribes from one or more channels
-     * @param {string[]} channels - The channels to unsubscribe from
-     * @returns {Promise<void>}
-     */
-    static unsubscribe(...channels: string[]): Promise<void>;
-    /**
-     * @description Publishes a message to a channel
-     * @param {string} channel - The channel to publish to
-     * @param {RedisStorable} message - The message to publish
-     * @returns {Promise<number>} - The number of clients that received the message
-     */
-    static publish(channel: string, message: RedisStorable): Promise<number>;
-    /**
-     * @description Pattern subscribe to channels
-     * @param {string[]} patterns - The patterns to subscribe to
-     * @param {RedisMessageHandler} handler - The function to call when a message is received
-     * @returns {Promise<void>}
-     */
-    static psubscribe(patterns: string[], handler: RedisMessageHandler): Promise<void>;
-    /**
-     * @description Pattern unsubscribe from channels
-     * @param {string[]} patterns - The patterns to unsubscribe from
-     * @returns {Promise<void>}
-     */
-    static punsubscribe(...patterns: string[]): Promise<void>;
     /**
      * @description Subscribes to one or more channels
      * @param {string[]} channels - The channels to subscribe to
@@ -7880,70 +7721,6 @@ declare class RedisDataSource {
      * @returns {Promise<void>}
      */
     punsubscribe(...patterns: string[]): Promise<void>;
-    /**
-     * @description Checks if a key exists
-     * @param {string} key - The key to check
-     * @returns {Promise<number>} - 1 if the key exists, 0 if not
-     */
-    static exists(key: string): Promise<number>;
-    /**
-     * @description Sets the expiration time of a key
-     * @param {string} key - The key to set the expiration for
-     * @param {number} seconds - The expiration time in seconds
-     * @returns {Promise<number>} - 1 if the timeout was set, 0 if not
-     */
-    static expire(key: string, seconds: number): Promise<number>;
-    /**
-     * @description Sets the expiration time of a key using a UNIX timestamp
-     * @param {string} key - The key to set the expiration for
-     * @param {number} timestamp - UNIX timestamp in seconds
-     * @returns {Promise<number>} - 1 if the timeout was set, 0 if not
-     */
-    static expireat(key: string, timestamp: number): Promise<number>;
-    /**
-     * @description Sets the expiration time of a key in milliseconds
-     * @param {string} key - The key to set the expiration for
-     * @param {number} milliseconds - The expiration time in milliseconds
-     * @returns {Promise<number>} - 1 if the timeout was set, 0 if not
-     */
-    static pexpire(key: string, milliseconds: number): Promise<number>;
-    /**
-     * @description Gets the remaining time to live of a key in seconds
-     * @param {string} key - The key to get the TTL for
-     * @returns {Promise<number>} - TTL in seconds, -1 if no expiry, -2 if key doesn't exist
-     */
-    static ttl(key: string): Promise<number>;
-    /**
-     * @description Gets the remaining time to live of a key in milliseconds
-     * @param {string} key - The key to get the TTL for
-     * @returns {Promise<number>} - TTL in milliseconds, -1 if no expiry, -2 if key doesn't exist
-     */
-    static pttl(key: string): Promise<number>;
-    /**
-     * @description Removes the expiration time from a key
-     * @param {string} key - The key to persist
-     * @returns {Promise<number>} - 1 if the timeout was removed, 0 if not
-     */
-    static persist(key: string): Promise<number>;
-    /**
-     * @description Gets all keys matching a pattern
-     * @param {string} pattern - The pattern to match
-     * @returns {Promise<string[]>} - Array of matching keys
-     */
-    static keys(pattern: string): Promise<string[]>;
-    /**
-     * @description Renames a key
-     * @param {string} key - The key to rename
-     * @param {string} newKey - The new name for the key
-     * @returns {Promise<string>} - "OK" if successful
-     */
-    static rename(key: string, newKey: string): Promise<string>;
-    /**
-     * @description Returns the type of value stored at a key
-     * @param {string} key - The key to check
-     * @returns {Promise<string>} - Type of key (string, list, set, zset, hash, or none if key doesn't exist)
-     */
-    static type(key: string): Promise<string>;
     /**
      * @description Checks if a key exists
      * @param {string} key - The key to check
@@ -8011,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;
@@ -8202,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;
@@ -8219,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;
@@ -8299,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 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 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 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 };