hysteria-orm 10.7.4 → 10.7.6

package/lib/index.d.cts

@@ -10,8 +10,8 @@ import { PoolConfig, PoolClient, QueryResult as QueryResult$1 } from 'pg';
 import * as mysql2_promise from 'mysql2/promise';
 import { PoolOptions, PoolConnection, QueryResult } from 'mysql2/promise';
 import { RedisOptions, Redis } from 'ioredis';
-import express from 'express';
 import { FormatOptionsWithLanguage } from 'sql-formatter';
+import express from 'express';
 import { PassThrough } from 'node:stream';
 
 type CaseConvention = "camel" | "snake" | "preserve" | RegExp | ((column: string) => string);
@@ -949,6 +949,262 @@ type OpenApiModelPropertyType = {
     nullable?: boolean;
 };
 
+interface CacheAdapter {
+    /**
+     * @description Gets a value from the cache
+     * @param key The key to get the value from
+     * @returns The value from the cache
+     */
+    get<T = void>(key: string): Promise<T>;
+    /**
+     * @description Sets a value in the cache
+     * @param key The key to set the value to
+     * @param data The value to set in the cache
+     * @param ttl The time to live for the value in milliseconds
+     */
+    set<T = any>(key: string, data: T, ttl?: number): Promise<void>;
+    /**
+     * @description Invalidates a value from the cache
+     * @param key The key to invalidate the value from
+     */
+    invalidate(key: string): Promise<void>;
+    /**
+     * @description Invalidates all values from the cache starting with the given key
+     * @param key The key to invalidate the values from
+     */
+    invalidateAll(key: string): Promise<void>;
+    /**
+     * @description Disconnects from the cache adapter if needed when the data source disconnects
+     */
+    disconnect?(): Promise<void>;
+}
+
+type CacheKeys = Record<string, (...args: any[]) => Promise<any> | any>;
+type UseCacheReturnType<C extends CacheKeys, K extends keyof C> = K extends never ? never : Awaited<ReturnType<C[K]>>;
+
+type Sqlite3ConnectionOptions = {
+    mode: number;
+};
+type SqlDriverSpecificOptions<T extends DataSourceType> = Omit<DriverSpecificOptions<T>, "mongoOptions" | "redisOptions">;
+type MysqlConnectionInstance = Awaited<ReturnType<Mysql2Import["createPool"]>>;
+type PgPoolClientInstance = InstanceType<PgImport["Pool"]>;
+type SqliteConnectionInstance = InstanceType<Sqlite3Import["Database"]>;
+type OracleDBPoolInstance = Pool;
+type MssqlPoolInstance = InstanceType<MssqlImport["ConnectionPool"]>;
+type MssqlConnectionInstance = Awaited<ReturnType<MssqlPoolInstance["connect"]>>;
+type SqlPoolType = OracleDBPoolInstance | MysqlConnectionInstance | PgPoolClientInstance | SqliteConnectionInstance | MssqlPoolInstance;
+/**
+ * @description The connection policies for the sql data source
+ * @default the connection policies are not set, so no query will be retried
+ */
+type ConnectionPolicies = {
+    /**
+     * @description The retry policy for the sql data source, it allows to retry a query if it fails
+     */
+    retry?: {
+        maxRetries?: number;
+        delay?: number;
+    };
+};
+/**
+ * Accepts both decorator-based model classes (`typeof Model` subclasses)
+ * and programmatic models created via `defineModel`.
+ */
+type SqlDataSourceModel = AnyModelConstructor;
+/**
+ * @description Base migration configuration options available for all databases
+ */
+type MigrationConfigBase = {
+    /**
+     * @description The path to the migrations folder, can be overridden in the cli command
+     * @default "database/migrations"
+     */
+    path?: string;
+    /**
+     * @description Path to the tsconfig.json file for TypeScript migration files, can be overridden in the cli command
+     * @default "./tsconfig.json"
+     */
+    tsconfig?: string;
+    /**
+     * @description Acquire advisory lock before running migrations to prevent concurrent execution, can be overridden in the cli command
+     * @default true
+     */
+    lock?: boolean;
+    /**
+     * @description Lock timeout in milliseconds for migration advisory lock acquisition, can be overridden in the cli command
+     * @default 30000
+     */
+    lockTimeout?: number;
+};
+/**
+ * @description Migration configuration with transactional support for PostgreSQL and CockroachDB
+ */
+type MigrationConfigWithTransactional = MigrationConfigBase & {
+    /**
+     * @description Runs all pending migrations in a single transaction, can be overridden in the cli command
+     * @default true
+     * @note Only available for PostgreSQL and CockroachDB
+     */
+    transactional?: boolean;
+};
+/**
+ * @description Migration configuration type based on database type
+ * @description Adds transactional option only for PostgreSQL and CockroachDB
+ */
+type MigrationConfig<D extends SqlDataSourceType = SqlDataSourceType> = D extends "postgres" | "cockroachdb" ? MigrationConfigWithTransactional : MigrationConfigBase;
+/**
+ * @description Seeder configuration options
+ */
+type SeederConfig = {
+    /**
+     * @description The path to the seeders folder
+     * @default "database/seeders"
+     */
+    path?: string;
+    /**
+     * @description Path to the tsconfig.json file for TypeScript seeder files
+     * @default "./tsconfig.json"
+     */
+    tsconfig?: string;
+};
+/**
+ * @description Common input properties shared across all SqlDataSource types
+ */
+type SqlDataSourceInputBase<T extends Record<string, SqlDataSourceModel> = {}, C extends CacheKeys = {}, D extends SqlDataSourceType = SqlDataSourceType> = {
+    /**
+     * @description Whether to log the sql queries and other debug information. Can be a boolean or a LoggerConfig object for granular control.
+     * @warning Logs are synchronous by default and add overhead — do not use in production unless you override with an async custom logger.
+     * @default false
+     */
+    readonly logs?: boolean | LoggerConfig;
+    /**
+     * @description The connection policies to use for the sql data source that are not configured in the driverOptions
+     */
+    connectionPolicies?: ConnectionPolicies;
+    /**
+     * @description The query format options to use for the sql data source, it tells how the sql queries should be formatted before being executed and logged
+     */
+    queryFormatOptions?: FormatOptionsWithLanguage;
+    /**
+     * @description The models to use for the sql data source, if used models will be registered in the sql data source instance and will be available for the models to use
+     * @description Models can still be used as standalone entities, but they won't be available for the sql data source instance
+     */
+    models?: T;
+    /**
+     * @description Migration configuration for the sql data source
+     */
+    migrations?: MigrationConfig<D>;
+    /**
+     * @description Seeder configuration for the sql data source
+     */
+    seeders?: SeederConfig;
+    /**
+     * @description The cache strategy to use for the sql data source, it's used to configure the cache strategy for the sql data source
+     */
+    cacheStrategy?: {
+        cacheAdapter?: CacheAdapter;
+        keys: C;
+    };
+    /**
+     * @description AdminJS configuration for the admin panel
+     * @description To use AdminJS, install: `npm install adminjs`
+     */
+    adminJs?: AdminJsOptions;
+};
+/**
+ * @description Maps a SqlDataSourceType to its corresponding input interface
+ */
+type MapSqlDataSourceTypeToInput<D extends SqlDataSourceType> = D extends "mysql" | "mariadb" ? MysqlSqlDataSourceInput : D extends "postgres" | "cockroachdb" ? PostgresSqlDataSourceInput : D extends "sqlite" ? SqliteDataSourceInput : D extends "mssql" ? MssqlDataSourceInput : D extends "oracledb" ? OracleDBDataSourceInput : never;
+type SlaveContext = {
+    type: SqlDataSourceType;
+    host: string;
+    port: number;
+    username: string;
+    password: string;
+    database: string;
+};
+/**
+ * @description The input type for the SqlDataSource constructor
+ * @description The connectionPolicies object is used to configure the connection policies for the sql data source
+ */
+type SqlDataSourceInput<D extends SqlDataSourceType = SqlDataSourceType, T extends Record<string, SqlDataSourceModel> = {}, C extends CacheKeys = {}> = SqlDataSourceInputBase<T, C, D> & {
+    /**
+     * @description The type of the database to connect to
+     */
+    readonly type: D;
+    /**
+     * @description The driver specific options to use for the sql data source, it's used to configure the driver specific options for the sql data source
+     * @warning For usage with types, you must have driver types installed if the driver handles types in a type package like e.g. `@types/pg`
+     */
+    driverOptions?: SqlDriverSpecificOptions<D>;
+    /**
+     * @description The replication configuration for the sql data source, it's used to configure the replication for the sql data source
+     */
+    replication?: {
+        /**
+         * @description The function to call when a slave server fails, if not provided an error will be thrown
+         */
+        onSlaveServerFailure?: (error: Error, context: SlaveContext) => void | Promise<void>;
+        /**
+         * @description The slaves data sources to use for the sql data source, slaves are automatically used for read operations unless specified otherwise
+         */
+        slaves?: Omit<UseConnectionInput<D, T, C>, "slaves" | "models" | "cacheStrategy" | "adminJs" | "logs" | "queryFormatOptions" | "migrations">[];
+        /**
+         * @description The algorithm to use for selecting the slave for read operations
+         * @default "roundRobin" - Distributes requests evenly across all slaves in sequence
+         * @option "random" - Randomly selects a slave for each request
+         */
+        slaveAlgorithm?: SlaveAlgorithm;
+    };
+} & Omit<MapSqlDataSourceTypeToInput<D>, "type">;
+/**
+ * @description Maps a SqlDataSourceType to its corresponding non-nullable input interface
+ */
+type MapSqlDataSourceTypeToNotNullableInput<D extends SqlDataSourceType> = D extends "mysql" | "mariadb" ? NotNullableMysqlSqlDataSourceInput : D extends "postgres" | "cockroachdb" ? NotNullablePostgresSqlDataSourceInput : D extends "sqlite" ? NotNullableSqliteDataSourceInput : D extends "mssql" ? NotNullableOracleMssqlDataSourceInput : D extends "oracledb" ? NotNullableOracleDBDataSourceInput : never;
+type UseConnectionInput<D extends SqlDataSourceType = SqlDataSourceType, T extends Record<string, SqlDataSourceModel> = {}, C extends CacheKeys = {}> = {
+    /**
+     * @description The type of the database to connect to
+     */
+    readonly type: D;
+    readonly logs?: boolean | LoggerConfig;
+    readonly models?: T;
+    readonly driverOptions?: SqlDriverSpecificOptions<D>;
+    connectionPolicies?: ConnectionPolicies;
+    queryFormatOptions?: FormatOptionsWithLanguage;
+    cacheStrategy?: {
+        cacheAdapter: CacheAdapter;
+        keys: C;
+    };
+    /**
+     * @description AdminJS configuration for the admin panel
+     * @description AdminJS is completely optional - dependencies are loaded at runtime via dynamic import()
+     */
+    adminJs?: AdminJsOptions;
+} & Omit<MapSqlDataSourceTypeToNotNullableInput<D>, "type">;
+type SqlDataSourceType = Exclude<DataSourceType, "mongo">;
+type SqlCloneOptions = {
+    /**
+     * @description Whether to recreate the pool of connections for the given driver, by default it's false
+     * @warning If false, the pool of connections will be reused from the caller instance
+     */
+    shouldRecreatePool?: boolean;
+};
+type getPoolReturnType<T = SqlDataSourceType> = T extends "mysql" ? MysqlConnectionInstance : T extends "mariadb" ? MysqlConnectionInstance : T extends "postgres" ? PgPoolClientInstance : T extends "cockroachdb" ? PgPoolClientInstance : T extends "sqlite" ? SqliteConnectionInstance : T extends "mssql" ? MssqlPoolInstance : T extends "oracledb" ? OracleDBPoolInstance : never;
+type GetConnectionReturnType<T = SqlDataSourceType> = T extends "mysql" ? PoolConnection : T extends "mariadb" ? PoolConnection : T extends "postgres" ? PoolClient : T extends "cockroachdb" ? PoolClient : T extends "sqlite" ? InstanceType<Sqlite3Import["Database"]> : T extends "mssql" ? Transaction$1 : T extends "oracledb" ? Connection : never;
+/** Only accepts formats `string` e `string as string` */
+type NoSpace<S extends string> = S extends `${infer _} ${infer _}` ? never : S;
+type TableFormat<S extends string> = NoSpace<S> | (S extends `${infer L} as ${infer R}` ? `${NoSpace<L>} as ${NoSpace<R>}` : never);
+type ReplicationType = "master" | "slave";
+/**
+ * @description Algorithm for selecting a slave database for read operations
+ * @option "roundRobin" - Distributes requests evenly across all slaves in sequence
+ * @option "random" - Randomly selects a slave for each request
+ */
+type SlaveAlgorithm = "roundRobin" | "random";
+type RawQueryOptions = {
+    replicationMode?: ReplicationType;
+};
+
 /**
  * @description AdminJS plugin types - All AdminJS imports are done at runtime via dynamic import()
  * @description This ensures the plugin is completely optional
@@ -976,7 +1232,7 @@ type AdminJsOptions = {
      * @description Models to expose in the AdminJS panel
      * @description If not provided, all models registered in the SqlDataSource will be used
      */
-    resources?: (typeof Model)[];
+    resources?: SqlDataSourceModel[];
     /**
      * @description Custom resource options for specific models
      */
@@ -1261,300 +1517,48 @@ type AdminJsInstance = {
     router?: ReturnType<typeof express.Router>;
 };
 
-interface CacheAdapter {
-    /**
-     * @description Gets a value from the cache
-     * @param key The key to get the value from
-     * @returns The value from the cache
-     */
-    get<T = void>(key: string): Promise<T>;
-    /**
-     * @description Sets a value in the cache
-     * @param key The key to set the value to
-     * @param data The value to set in the cache
-     * @param ttl The time to live for the value in milliseconds
-     */
-    set<T = any>(key: string, data: T, ttl?: number): Promise<void>;
-    /**
-     * @description Invalidates a value from the cache
-     * @param key The key to invalidate the value from
-     */
-    invalidate(key: string): Promise<void>;
-    /**
-     * @description Invalidates all values from the cache starting with the given key
-     * @param key The key to invalidate the values from
-     */
-    invalidateAll(key: string): Promise<void>;
-    /**
-     * @description Disconnects from the cache adapter if needed when the data source disconnects
-     */
-    disconnect?(): Promise<void>;
-}
-
-type CacheKeys = Record<string, (...args: any[]) => Promise<any> | any>;
-type UseCacheReturnType<C extends CacheKeys, K extends keyof C> = K extends never ? never : Awaited<ReturnType<C[K]>>;
-
 declare abstract class QueryNode {
     /**
-     * Sql keyword to use for the query e.g. "select"
-     */
-    keyword: string;
-    /**
-     * The current parameter index to use for the query
-     */
-    currParamIndex: number;
-    /**
-     * Whether the query node is a raw value and should not be parsed by the interpreter
-     */
-    isRawValue: boolean;
-    /**
-     * Whether the keyword can be seen multiple times in the query, e.g. "join" can be seen multiple times in a query
-     */
-    abstract canKeywordBeSeenMultipleTimes: boolean;
-    /**
-     * The string to use to chain the keyword with the next keyword
-     */
-    abstract chainsWith: string;
-    /**
-     * The folder to use for the query node, e.g. "select" is in the "select" folder inside the interpreter map
-     */
-    abstract folder: string;
-    /**
-     * The file to use for the query node, e.g. "select" is in the "select" file inside the interpreter map
-     */
-    abstract file: string;
-    constructor(keyword: string, isRawValue?: boolean);
-}
-
-declare class RawNode extends QueryNode {
-    rawValue: string;
-    canKeywordBeSeenMultipleTimes: boolean;
-    chainsWith: string;
-    currParamIndex: number;
-    isRawValue: boolean;
-    folder: string;
-    file: string;
-    constructor(value: string);
-}
-
-type Sqlite3ConnectionOptions = {
-    mode: number;
-};
-type SqlDriverSpecificOptions<T extends DataSourceType> = Omit<DriverSpecificOptions<T>, "mongoOptions" | "redisOptions">;
-type MysqlConnectionInstance = Awaited<ReturnType<Mysql2Import["createPool"]>>;
-type PgPoolClientInstance = InstanceType<PgImport["Pool"]>;
-type SqliteConnectionInstance = InstanceType<Sqlite3Import["Database"]>;
-type OracleDBPoolInstance = Pool;
-type MssqlPoolInstance = InstanceType<MssqlImport["ConnectionPool"]>;
-type MssqlConnectionInstance = Awaited<ReturnType<MssqlPoolInstance["connect"]>>;
-type SqlPoolType = OracleDBPoolInstance | MysqlConnectionInstance | PgPoolClientInstance | SqliteConnectionInstance | MssqlPoolInstance;
-/**
- * @description The connection policies for the sql data source
- * @default the connection policies are not set, so no query will be retried
- */
-type ConnectionPolicies = {
-    /**
-     * @description The retry policy for the sql data source, it allows to retry a query if it fails
-     */
-    retry?: {
-        maxRetries?: number;
-        delay?: number;
-    };
-};
-type SqlDataSourceModel = typeof Model;
-/**
- * @description Base migration configuration options available for all databases
- */
-type MigrationConfigBase = {
-    /**
-     * @description The path to the migrations folder, can be overridden in the cli command
-     * @default "database/migrations"
-     */
-    path?: string;
-    /**
-     * @description Path to the tsconfig.json file for TypeScript migration files, can be overridden in the cli command
-     * @default "./tsconfig.json"
-     */
-    tsconfig?: string;
-    /**
-     * @description Acquire advisory lock before running migrations to prevent concurrent execution, can be overridden in the cli command
-     * @default true
-     */
-    lock?: boolean;
-    /**
-     * @description Lock timeout in milliseconds for migration advisory lock acquisition, can be overridden in the cli command
-     * @default 30000
-     */
-    lockTimeout?: number;
-};
-/**
- * @description Migration configuration with transactional support for PostgreSQL and CockroachDB
- */
-type MigrationConfigWithTransactional = MigrationConfigBase & {
-    /**
-     * @description Runs all pending migrations in a single transaction, can be overridden in the cli command
-     * @default true
-     * @note Only available for PostgreSQL and CockroachDB
-     */
-    transactional?: boolean;
-};
-/**
- * @description Migration configuration type based on database type
- * @description Adds transactional option only for PostgreSQL and CockroachDB
- */
-type MigrationConfig<D extends SqlDataSourceType = SqlDataSourceType> = D extends "postgres" | "cockroachdb" ? MigrationConfigWithTransactional : MigrationConfigBase;
-/**
- * @description Seeder configuration options
- */
-type SeederConfig = {
-    /**
-     * @description The path to the seeders folder
-     * @default "database/seeders"
-     */
-    path?: string;
-    /**
-     * @description Path to the tsconfig.json file for TypeScript seeder files
-     * @default "./tsconfig.json"
-     */
-    tsconfig?: string;
-};
-/**
- * @description Common input properties shared across all SqlDataSource types
- */
-type SqlDataSourceInputBase<T extends Record<string, SqlDataSourceModel> = {}, C extends CacheKeys = {}, D extends SqlDataSourceType = SqlDataSourceType> = {
-    /**
-     * @description Whether to log the sql queries and other debug information. Can be a boolean or a LoggerConfig object for granular control.
-     * @warning Logs are synchronous by default and add overhead — do not use in production unless you override with an async custom logger.
-     * @default false
-     */
-    readonly logs?: boolean | LoggerConfig;
-    /**
-     * @description The connection policies to use for the sql data source that are not configured in the driverOptions
-     */
-    connectionPolicies?: ConnectionPolicies;
-    /**
-     * @description The query format options to use for the sql data source, it tells how the sql queries should be formatted before being executed and logged
-     */
-    queryFormatOptions?: FormatOptionsWithLanguage;
-    /**
-     * @description The models to use for the sql data source, if used models will be registered in the sql data source instance and will be available for the models to use
-     * @description Models can still be used as standalone entities, but they won't be available for the sql data source instance
-     */
-    models?: T;
-    /**
-     * @description Migration configuration for the sql data source
-     */
-    migrations?: MigrationConfig<D>;
-    /**
-     * @description Seeder configuration for the sql data source
-     */
-    seeders?: SeederConfig;
-    /**
-     * @description The cache strategy to use for the sql data source, it's used to configure the cache strategy for the sql data source
-     */
-    cacheStrategy?: {
-        cacheAdapter?: CacheAdapter;
-        keys: C;
-    };
-    /**
-     * @description AdminJS configuration for the admin panel
-     * @description To use AdminJS, install: `npm install adminjs`
-     */
-    adminJs?: AdminJsOptions;
-};
-/**
- * @description Maps a SqlDataSourceType to its corresponding input interface
- */
-type MapSqlDataSourceTypeToInput<D extends SqlDataSourceType> = D extends "mysql" | "mariadb" ? MysqlSqlDataSourceInput : D extends "postgres" | "cockroachdb" ? PostgresSqlDataSourceInput : D extends "sqlite" ? SqliteDataSourceInput : D extends "mssql" ? MssqlDataSourceInput : D extends "oracledb" ? OracleDBDataSourceInput : never;
-type SlaveContext = {
-    type: SqlDataSourceType;
-    host: string;
-    port: number;
-    username: string;
-    password: string;
-    database: string;
-};
-/**
- * @description The input type for the SqlDataSource constructor
- * @description The connectionPolicies object is used to configure the connection policies for the sql data source
- */
-type SqlDataSourceInput<D extends SqlDataSourceType = SqlDataSourceType, T extends Record<string, SqlDataSourceModel> = {}, C extends CacheKeys = {}> = SqlDataSourceInputBase<T, C, D> & {
-    /**
-     * @description The type of the database to connect to
-     */
-    readonly type: D;
-    /**
-     * @description The driver specific options to use for the sql data source, it's used to configure the driver specific options for the sql data source
-     * @warning For usage with types, you must have driver types installed if the driver handles types in a type package like e.g. `@types/pg`
-     */
-    driverOptions?: SqlDriverSpecificOptions<D>;
-    /**
-     * @description The replication configuration for the sql data source, it's used to configure the replication for the sql data source
-     */
-    replication?: {
-        /**
-         * @description The function to call when a slave server fails, if not provided an error will be thrown
-         */
-        onSlaveServerFailure?: (error: Error, context: SlaveContext) => void | Promise<void>;
-        /**
-         * @description The slaves data sources to use for the sql data source, slaves are automatically used for read operations unless specified otherwise
-         */
-        slaves?: Omit<UseConnectionInput<D, T, C>, "slaves" | "models" | "cacheStrategy" | "adminJs" | "logs" | "queryFormatOptions" | "migrations">[];
-        /**
-         * @description The algorithm to use for selecting the slave for read operations
-         * @default "roundRobin" - Distributes requests evenly across all slaves in sequence
-         * @option "random" - Randomly selects a slave for each request
-         */
-        slaveAlgorithm?: SlaveAlgorithm;
-    };
-} & Omit<MapSqlDataSourceTypeToInput<D>, "type">;
-/**
- * @description Maps a SqlDataSourceType to its corresponding non-nullable input interface
- */
-type MapSqlDataSourceTypeToNotNullableInput<D extends SqlDataSourceType> = D extends "mysql" | "mariadb" ? NotNullableMysqlSqlDataSourceInput : D extends "postgres" | "cockroachdb" ? NotNullablePostgresSqlDataSourceInput : D extends "sqlite" ? NotNullableSqliteDataSourceInput : D extends "mssql" ? NotNullableOracleMssqlDataSourceInput : D extends "oracledb" ? NotNullableOracleDBDataSourceInput : never;
-type UseConnectionInput<D extends SqlDataSourceType = SqlDataSourceType, T extends Record<string, SqlDataSourceModel> = {}, C extends CacheKeys = {}> = {
+     * Sql keyword to use for the query e.g. "select"
+     */
+    keyword: string;
     /**
-     * @description The type of the database to connect to
+     * The current parameter index to use for the query
      */
-    readonly type: D;
-    readonly logs?: boolean | LoggerConfig;
-    readonly models?: T;
-    readonly driverOptions?: SqlDriverSpecificOptions<D>;
-    connectionPolicies?: ConnectionPolicies;
-    queryFormatOptions?: FormatOptionsWithLanguage;
-    cacheStrategy?: {
-        cacheAdapter: CacheAdapter;
-        keys: C;
-    };
+    currParamIndex: number;
     /**
-     * @description AdminJS configuration for the admin panel
-     * @description AdminJS is completely optional - dependencies are loaded at runtime via dynamic import()
+     * Whether the query node is a raw value and should not be parsed by the interpreter
      */
-    adminJs?: AdminJsOptions;
-} & Omit<MapSqlDataSourceTypeToNotNullableInput<D>, "type">;
-type SqlDataSourceType = Exclude<DataSourceType, "mongo">;
-type SqlCloneOptions = {
+    isRawValue: boolean;
     /**
-     * @description Whether to recreate the pool of connections for the given driver, by default it's false
-     * @warning If false, the pool of connections will be reused from the caller instance
+     * Whether the keyword can be seen multiple times in the query, e.g. "join" can be seen multiple times in a query
      */
-    shouldRecreatePool?: boolean;
-};
-type getPoolReturnType<T = SqlDataSourceType> = T extends "mysql" ? MysqlConnectionInstance : T extends "mariadb" ? MysqlConnectionInstance : T extends "postgres" ? PgPoolClientInstance : T extends "cockroachdb" ? PgPoolClientInstance : T extends "sqlite" ? SqliteConnectionInstance : T extends "mssql" ? MssqlPoolInstance : T extends "oracledb" ? OracleDBPoolInstance : never;
-type GetConnectionReturnType<T = SqlDataSourceType> = T extends "mysql" ? PoolConnection : T extends "mariadb" ? PoolConnection : T extends "postgres" ? PoolClient : T extends "cockroachdb" ? PoolClient : T extends "sqlite" ? InstanceType<Sqlite3Import["Database"]> : T extends "mssql" ? Transaction$1 : T extends "oracledb" ? Connection : never;
-/** Only accepts formats `string` e `string as string` */
-type NoSpace<S extends string> = S extends `${infer _} ${infer _}` ? never : S;
-type TableFormat<S extends string> = NoSpace<S> | (S extends `${infer L} as ${infer R}` ? `${NoSpace<L>} as ${NoSpace<R>}` : never);
-type ReplicationType = "master" | "slave";
-/**
- * @description Algorithm for selecting a slave database for read operations
- * @option "roundRobin" - Distributes requests evenly across all slaves in sequence
- * @option "random" - Randomly selects a slave for each request
- */
-type SlaveAlgorithm = "roundRobin" | "random";
-type RawQueryOptions = {
-    replicationMode?: ReplicationType;
-};
+    abstract canKeywordBeSeenMultipleTimes: boolean;
+    /**
+     * The string to use to chain the keyword with the next keyword
+     */
+    abstract chainsWith: string;
+    /**
+     * The folder to use for the query node, e.g. "select" is in the "select" folder inside the interpreter map
+     */
+    abstract folder: string;
+    /**
+     * The file to use for the query node, e.g. "select" is in the "select" file inside the interpreter map
+     */
+    abstract file: string;
+    constructor(keyword: string, isRawValue?: boolean);
+}
+
+declare class RawNode extends QueryNode {
+    rawValue: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    chainsWith: string;
+    currParamIndex: number;
+    isRawValue: boolean;
+    folder: string;
+    file: string;
+    constructor(value: string);
+}
 
 declare abstract class BaseBuilder {
     protected nodes: QueryNode[];
@@ -3163,7 +3167,7 @@ type ColumnDataTypeOption = ColumnDataTypeOptionWithLength | ColumnDataTypeOptio
 type LazyRelationType = {
     type?: RelationEnum;
     columnName: string;
-    model: () => typeof Model;
+    model: () => AnyModelConstructor;
     foreignKey: string | (() => string);
     constraintName: string | (() => string);
     onDelete?: OnUpdateOrDelete;
@@ -3192,11 +3196,13 @@ type DateColumnOptions = {
     timezone?: Timezone;
     /**
      * @description Whether to automatically update the timestamp on record updates, uses timezone and format from the dateColumn options
+     * @warning This is a code wise implementation it does not generate a trigger in the database, works with bulk updates too
      * @default false
      */
     autoUpdate?: boolean;
     /**
      * @description Whether to automatically set the timestamp on record creation, uses timezone and format from the dateColumn options
+     * @warning This is a code wise implementation it does not generate a trigger in the database, works with bulk creations too
      * @default false
      */
     autoCreate?: boolean;
@@ -3309,11 +3315,11 @@ type ColumnType = {
         default?: string | number | null | boolean;
     };
 };
-type ThroughModelCallback<T extends typeof Model> = () => T;
+type ThroughModelCallback<T extends AnyModelConstructor> = () => T;
 type ThroughModelString = string;
-type ThroughModel<T extends typeof Model> = ThroughModelCallback<T> | ThroughModelString;
+type ThroughModel<T extends AnyModelConstructor> = ThroughModelCallback<T> | ThroughModelString;
 type ExtractModelFromTM<TM extends ThroughModel<any>> = TM extends ThroughModelCallback<infer T> ? T : never;
-type ManyToManyOptions<T extends typeof Model, TM extends ThroughModel<T>> = {
+type ManyToManyOptions<T extends AnyModelConstructor, TM extends ThroughModel<T>> = {
     /**
      * @description The foreign key of current model on the Pivot table
      * @example If the current model is User and the through model is UserAddress, the leftForeignKey will be "userId"
@@ -3659,12 +3665,12 @@ declare abstract class JoinQueryBuilder<T extends Model, S extends Record<string
      */
     innerJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, operator?: BinaryOperatorType): this;
     innerJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn?: JoinableColumn, operator?: BinaryOperatorType): this;
-    innerJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator?: BinaryOperatorType): this;
-    innerJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn?: ModelKey<T>, operator?: BinaryOperatorType): this;
+    innerJoin<R extends AnyModelConstructor>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator?: BinaryOperatorType): this;
+    innerJoin<R extends AnyModelConstructor>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn?: ModelKey<T>, operator?: BinaryOperatorType): this;
     innerJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, operator: BinaryOperatorType, callback: JoinOnCallback): this;
     innerJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, callback: JoinOnCallback): this;
-    innerJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator: BinaryOperatorType, callback: JoinOnCallback): this;
-    innerJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, callback: JoinOnCallback): this;
+    innerJoin<R extends AnyModelConstructor>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator: BinaryOperatorType, callback: JoinOnCallback): this;
+    innerJoin<R extends AnyModelConstructor>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, callback: JoinOnCallback): this;
     /**
      * @description Join a table with the current model
      * @param relationTable - The table to join
@@ -3674,12 +3680,12 @@ declare abstract class JoinQueryBuilder<T extends Model, S extends Record<string
      */
     join(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, operator?: BinaryOperatorType): this;
     join(relationTable: string, referencingColumn: JoinableColumn, primaryColumn?: JoinableColumn, operator?: BinaryOperatorType): this;
-    join<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator?: BinaryOperatorType): this;
-    join<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn?: ModelKey<T>, operator?: BinaryOperatorType): this;
+    join<R extends AnyModelConstructor>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator?: BinaryOperatorType): this;
+    join<R extends AnyModelConstructor>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn?: ModelKey<T>, operator?: BinaryOperatorType): this;
     join(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, operator: BinaryOperatorType, callback: JoinOnCallback): this;
     join(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, callback: JoinOnCallback): this;
-    join<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator: BinaryOperatorType, callback: JoinOnCallback): this;
-    join<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, callback: JoinOnCallback): this;
+    join<R extends AnyModelConstructor>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator: BinaryOperatorType, callback: JoinOnCallback): this;
+    join<R extends AnyModelConstructor>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, callback: JoinOnCallback): this;
     /**
      * @description Join a table with the current model
      * @param relationTable - The table to join
@@ -3689,12 +3695,12 @@ declare abstract class JoinQueryBuilder<T extends Model, S extends Record<string
      */
     leftJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, operator?: BinaryOperatorType): this;
     leftJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn?: JoinableColumn, operator?: BinaryOperatorType): this;
-    leftJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator?: BinaryOperatorType): this;
-    leftJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn?: ModelKey<T>, operator?: BinaryOperatorType): this;
+    leftJoin<R extends AnyModelConstructor>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator?: BinaryOperatorType): this;
+    leftJoin<R extends AnyModelConstructor>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn?: ModelKey<T>, operator?: BinaryOperatorType): this;
     leftJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, operator: BinaryOperatorType, callback: JoinOnCallback): this;
     leftJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, callback: JoinOnCallback): this;
-    leftJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator: BinaryOperatorType, callback: JoinOnCallback): this;
-    leftJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, callback: JoinOnCallback): this;
+    leftJoin<R extends AnyModelConstructor>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator: BinaryOperatorType, callback: JoinOnCallback): this;
+    leftJoin<R extends AnyModelConstructor>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, callback: JoinOnCallback): this;
     /**
      * @description Join a table with the current model
      * @param relationTable - The table to join
@@ -3704,7 +3710,7 @@ declare abstract class JoinQueryBuilder<T extends Model, S extends Record<string
      */
     rightJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn: JoinableColumn, operator?: BinaryOperatorType): this;
     rightJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn?: JoinableColumn, operator?: BinaryOperatorType): this;
-    rightJoin<R extends typeof Model>(relationTable: string | R, referencingColumnOrPrimaryColumn: ModelKey<InstanceType<R>> | JoinableColumn | ModelKey<T>, primaryColumn?: JoinableColumn | ModelKey<T>, operator?: BinaryOperatorType): this;
+    rightJoin<R extends AnyModelConstructor>(relationTable: string | R, referencingColumnOrPrimaryColumn: ModelKey<InstanceType<R>> | JoinableColumn | ModelKey<T>, primaryColumn?: JoinableColumn | ModelKey<T>, operator?: BinaryOperatorType): this;
     rightJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn: JoinableColumn, operator: BinaryOperatorType, callback: JoinOnCallback): this;
     rightJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn: JoinableColumn, callback: JoinOnCallback): this;
     /**
@@ -3716,7 +3722,7 @@ declare abstract class JoinQueryBuilder<T extends Model, S extends Record<string
      */
     fullJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn: JoinableColumn, operator?: BinaryOperatorType): this;
     fullJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn?: JoinableColumn, operator?: BinaryOperatorType): this;
-    fullJoin<R extends typeof Model>(relationTable: string | R, referencingColumnOrPrimaryColumn: ModelKey<InstanceType<R>> | JoinableColumn | ModelKey<T>, primaryColumn?: JoinableColumn | ModelKey<T>, operator?: BinaryOperatorType): this;
+    fullJoin<R extends AnyModelConstructor>(relationTable: string | R, referencingColumnOrPrimaryColumn: ModelKey<InstanceType<R>> | JoinableColumn | ModelKey<T>, primaryColumn?: JoinableColumn | ModelKey<T>, operator?: BinaryOperatorType): this;
     fullJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn: JoinableColumn, operator: BinaryOperatorType, callback: JoinOnCallback): this;
     fullJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn: JoinableColumn, callback: JoinOnCallback): this;
 }
@@ -4623,7 +4629,7 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
     finally(onfinally?: (() => void) | null | undefined): Promise<SelectedModel<T, S, R>[]>;
     chunk(chunkSize: number, options?: ManyOptions): AsyncGenerator<SelectedModel<T, S, R>[] | T[]>;
     stream(options?: ManyOptions & StreamOptions): Promise<PassThrough & AsyncGenerator<SelectedModel<T, S, R> | T>>;
-    paginateWithCursor<K extends ModelKey<T>>(page: number, options?: PaginateWithCursorOptions<T, K>, cursor?: Cursor<T, K>): Promise<[CursorPaginatedData<T, S, R>, Cursor<T, K>]>;
+    paginateWithCursor<K extends ModelKey<T>>(limit: number, options?: PaginateWithCursorOptions<T, K>, cursor?: Cursor<T, K>): Promise<[CursorPaginatedData<T, S, R>, Cursor<T, K>]>;
     /**
      * @description Inserts a new record into the database, it is not advised to use this method directly from the query builder if using a ModelQueryBuilder (`Model.query()`), use the `Model.insert` method instead.
      */
@@ -5466,7 +5472,7 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Returns a ModelQueryBuilder instance for the given model
      * @param Model The model to create the query builder from
      */
-    from<T extends typeof Model>(Model: T): ModelQueryBuilder<InstanceType<T>>;
+    from<T extends AnyModelConstructor>(model: T): ModelQueryBuilder<InstanceType<T>>;
     /**
      * @description Returns a SchemaBuilder instance for DDL operations
      * @description The builder will execute queries when awaited or when .execute() is called
@@ -5768,7 +5774,7 @@ type RawModelOptions = {
  * @example
  * type UserInstance = ModelInstanceType<typeof User>; // User
  */
-type ModelInstanceType<O> = O extends typeof Model ? InstanceType<O> : never;
+type ModelInstanceType<O> = O extends AnyModelConstructor ? InstanceType<O> : never;
 /**
  * Available fetch hook combinations for query execution.
  * Hooks can be selectively ignored when fetching data.
@@ -6522,6 +6528,480 @@ declare abstract class Model<T extends Model<T> = any> extends Entity {
     private static dispatchModelManager;
 }
 
+declare const __selfBrand: unique symbol;
+
+/**
+ * Phantom-typed descriptor for a model column.
+ * `T` carries the TypeScript type the column resolves to at the instance level.
+ */
+interface ColumnDef<T = unknown> {
+    readonly _phantom: T;
+    readonly _apply: (target: Object, propertyKey: string) => void;
+}
+/**
+ * Phantom-typed descriptor for a model relation.
+ * `T` carries the TypeScript type the relation resolves to at the instance level.
+ */
+interface RelationDef<T = any> {
+    readonly _phantom: T;
+    readonly _apply: (target: Object, propertyKey: string) => void;
+}
+type ColOptions = Omit<ColumnOptions, "primaryKey" | "serialize" | "prepare">;
+type ColPrimaryOptions = Omit<ColumnOptions, "primaryKey" | "serialize" | "prepare">;
+type ColStringOptions = Omit<ColumnOptions, "type" | "serialize" | "prepare"> & {
+    length?: number;
+};
+type ColTextOptions = Omit<ColumnOptions, "type" | "serialize" | "prepare">;
+type ColIntegerOptions = Omit<ColumnOptions, "serialize" | "prepare">;
+type ColBigIntegerOptions = Omit<ColumnOptions, "serialize" | "prepare">;
+type ColFloatOptions = Omit<ColumnOptions, "serialize" | "prepare">;
+type ColDecimalOptions = Omit<ColumnOptions, "serialize" | "prepare"> & {
+    precision?: number;
+    scale?: number;
+};
+type ColIncrementOptions = Omit<ColumnOptions, "serialize" | "prepare" | "primaryKey" | "nullable">;
+type ColBigIncrementOptions = Omit<ColumnOptions, "serialize" | "prepare" | "primaryKey" | "nullable">;
+type ColBooleanOptions = Omit<ColumnOptions, "prepare" | "serialize">;
+type ColDateOptions = Omit<DateColumnOptions, "format" | "serialize" | "prepare">;
+type ColDatetimeOptions = Omit<DatetimeColumnOptions, "serialize" | "prepare">;
+type ColTimestampOptions = Omit<DatetimeColumnOptions, "serialize" | "prepare">;
+type ColTimeOptions = Omit<DateColumnOptions, "format" | "serialize" | "prepare">;
+type ColJsonOptions = Omit<ColumnOptions, "prepare" | "serialize">;
+type ColUuidOptions = Omit<ColumnOptions, "prepare" | "serialize">;
+type ColUlidOptions = Omit<ColumnOptions, "prepare" | "serialize">;
+type ColBinaryOptions = Omit<ColumnOptions, "type" | "serialize" | "prepare">;
+type ColEnumOptions = Omit<ColumnOptions, "type" | "serialize" | "prepare">;
+type ColSymmetricOptions = Omit<SymmetricEncryptionOptions, "prepare" | "serialize">;
+type ColAsymmetricOptions = Omit<AsymmetricEncryptionOptions, "prepare" | "serialize">;
+type RelationConstraintOptions = {
+    /**
+     * Useful for auto generated migrations to specify the on delete action, it does not affect the code wise implementation
+     */
+    onDelete?: OnUpdateOrDelete;
+    /**
+     * Useful for auto generated migrations to specify the on update action, it does not affect the code wise implementation
+     */
+    onUpdate?: OnUpdateOrDelete;
+    /**
+     * Useful for auto generated migrations to specify the constraint name, it does not affect the code wise implementation
+     */
+    constraintName?: string;
+};
+type RelationNullableOption = {
+    nullable?: boolean;
+};
+/**
+ * Resolves to `Base` when `Opts` has `{ nullable: false }`, otherwise
+ * `Base | null | undefined`. This powers nullable-aware type inference
+ * for `col.*()` methods.
+ */
+type NullableColumn<Base, Opts> = Opts extends {
+    nullable: false;
+} ? Base : Base | null | undefined;
+type TypedSerialize<T> = {
+    serialize?: (value: any) => T;
+};
+type TypedPrepare<T> = {
+    prepare?: (value: T) => any;
+};
+interface ColNamespace {
+    /**
+     * Generic column — you control the TypeScript type via `col<T>()`.
+     * Use for columns whose type doesn't match any built-in helper.
+     *
+     * Supports typed `serialize` and `prepare` callbacks.
+     *
+     * ```ts
+     * col<string>({ nullable: false })
+     * col<MyCustomType>({ serialize: (raw) => parse(raw), prepare: (v) => stringify(v) })
+     * ```
+     */
+    <T = unknown>(options?: ColOptions & TypedSerialize<T> & TypedPrepare<T>): ColumnDef<T>;
+    /**
+     * Generic primary key column. Defaults to `string | number`.
+     * Override the generic when you know the exact type.
+     *
+     * ```ts
+     * col.primary<number>({ nullable: false })
+     * ```
+     */
+    primary<T = string | number>(options?: ColPrimaryOptions & TypedSerialize<T> & TypedPrepare<T>): ColumnDef<T>;
+    /**
+     * VARCHAR column. Accepts an optional `length` option.
+     * Type: `string` (nullable-aware).
+     *
+     * ```ts
+     * col.string({ length: 255, nullable: false }) // string
+     * col.string()                                  // string | null | undefined
+     * ```
+     */
+    string<O extends ColStringOptions = ColStringOptions>(options?: O & TypedSerialize<NullableColumn<string, O>> & TypedPrepare<NullableColumn<string, O>>): ColumnDef<NullableColumn<string, O>>;
+    /**
+     * LONGTEXT column for large text content.
+     * Type: `string` (nullable-aware).
+     */
+    text<O extends ColTextOptions = ColTextOptions>(options?: O & TypedSerialize<NullableColumn<string, O>> & TypedPrepare<NullableColumn<string, O>>): ColumnDef<NullableColumn<string, O>>;
+    /**
+     * Integer column.
+     * Type: `number` (nullable-aware). Only `prepare` is exposed (no `serialize`).
+     */
+    integer<O extends ColIntegerOptions = ColIntegerOptions>(options?: O & TypedPrepare<NullableColumn<number, O>>): ColumnDef<NullableColumn<number, O>>;
+    /**
+     * Big integer column for values exceeding 32-bit range.
+     * Type: `number | bigint` (nullable-aware). Only `prepare` is exposed.
+     */
+    bigInteger<O extends ColBigIntegerOptions = ColBigIntegerOptions>(options?: O & TypedPrepare<NullableColumn<number | bigint, O>>): ColumnDef<NullableColumn<number | bigint, O>>;
+    /**
+     * Floating-point column.
+     * Type: `number` (nullable-aware). Only `prepare` is exposed.
+     */
+    float<O extends ColFloatOptions = ColFloatOptions>(options?: O & TypedPrepare<NullableColumn<number, O>>): ColumnDef<NullableColumn<number, O>>;
+    /**
+     * Decimal column with optional `precision` and `scale`.
+     * Type: `number` (nullable-aware). Only `prepare` is exposed.
+     *
+     * ```ts
+     * col.decimal({ precision: 10, scale: 2, nullable: false }) // number
+     * ```
+     */
+    decimal<O extends ColDecimalOptions = ColDecimalOptions>(options?: O & TypedPrepare<NullableColumn<number, O>>): ColumnDef<NullableColumn<number, O>>;
+    /**
+     * Auto-incrementing integer primary key. Always non-nullable.
+     * Type: `number`. Only `prepare` is exposed.
+     */
+    increment(options?: ColIncrementOptions & TypedPrepare<number>): ColumnDef<number>;
+    /**
+     * Auto-incrementing bigint primary key. Always non-nullable.
+     * Type: `number`. Only `prepare` is exposed.
+     */
+    bigIncrement(options?: ColBigIncrementOptions & TypedPrepare<number>): ColumnDef<number>;
+    /**
+     * Boolean column.
+     * Type: `boolean` (nullable-aware). No `serialize` or `prepare` exposed.
+     */
+    boolean<O extends ColBooleanOptions = ColBooleanOptions>(options?: O): ColumnDef<NullableColumn<boolean, O>>;
+    /**
+     * DATE column (YYYY-MM-DD). Defaults to `Date` because database drivers
+     * return `Date` objects.
+     *
+     * To type as `string`, use `col.date<string>()` and provide a `serialize`
+     * function that converts the driver `Date` into a string:
+     *
+     * ```ts
+     * col.date<string>({ serialize: (raw) => raw.toISOString().split("T")[0] })
+     * ```
+     */
+    date<T extends Date | string = Date>(options: ColDateOptions & {
+        nullable: false;
+    } & TypedSerialize<T> & TypedPrepare<T>): ColumnDef<T>;
+    date<T extends Date | string = Date>(options?: ColDateOptions & TypedSerialize<T | null | undefined> & TypedPrepare<T | null | undefined>): ColumnDef<T | null | undefined>;
+    /**
+     * DATETIME column. Defaults to `Date` because database drivers return
+     * `Date` objects.
+     *
+     * To type as `string`, use `col.datetime<string>()` and provide a
+     * `serialize` function that converts the driver `Date` into a string:
+     *
+     * ```ts
+     * col.datetime<string>({ serialize: (raw) => new Date(raw).toISOString() })
+     * ```
+     */
+    datetime<T extends Date | string = Date>(options: ColDatetimeOptions & {
+        nullable: false;
+    } & TypedSerialize<T> & TypedPrepare<T>): ColumnDef<T>;
+    datetime<T extends Date | string = Date>(options?: ColDatetimeOptions & TypedSerialize<T | null | undefined> & TypedPrepare<T | null | undefined>): ColumnDef<T | null | undefined>;
+    /**
+     * TIMESTAMP column. Defaults to `Date` because database drivers return
+     * `Date` objects.
+     *
+     * To type as `string`, use `col.timestamp<string>()` and provide a
+     * `serialize` function that converts the driver `Date` into a string:
+     *
+     * ```ts
+     * col.timestamp<string>({ serialize: (raw) => new Date(raw).toISOString() })
+     * ```
+     */
+    timestamp<T extends Date | string = Date>(options: ColTimestampOptions & {
+        nullable: false;
+    } & TypedSerialize<T> & TypedPrepare<T>): ColumnDef<T>;
+    timestamp<T extends Date | string = Date>(options?: ColTimestampOptions & TypedSerialize<T | null | undefined> & TypedPrepare<T | null | undefined>): ColumnDef<T | null | undefined>;
+    /**
+     * TIME column. Defaults to `Date` because database drivers return
+     * `Date` objects.
+     *
+     * To type as `string`, use `col.time<string>()` and provide a
+     * `serialize` function that converts the driver `Date` into a string:
+     *
+     * ```ts
+     * col.time<string>({ serialize: (raw) => new Date(raw).toTimeString() })
+     * ```
+     */
+    time<T extends Date | string = Date>(options: ColTimeOptions & {
+        nullable: false;
+    } & TypedSerialize<T> & TypedPrepare<T>): ColumnDef<T>;
+    time<T extends Date | string = Date>(options?: ColTimeOptions & TypedSerialize<T | null | undefined> & TypedPrepare<T | null | undefined>): ColumnDef<T | null | undefined>;
+    /**
+     * JSON/JSONB column. Defaults to `unknown`.
+     * Pass a concrete type for structured JSON data: `col.json<MyType>()`.
+     *
+     * No `serialize` or `prepare` exposed — serialization is handled internally.
+     *
+     * ```ts
+     * col.json<{ theme: string }>({ nullable: false }) // { theme: string }
+     * col.json()                                        // unknown | null | undefined
+     * ```
+     */
+    json<T = unknown>(options: ColJsonOptions & {
+        nullable: false;
+    }): ColumnDef<T>;
+    json<T = unknown>(options?: ColJsonOptions): ColumnDef<T | null | undefined>;
+    /**
+     * UUID column. Auto-generates a UUID if no value is provided on insert.
+     * Type: `string` (nullable-aware). Only `serialize` is exposed.
+     */
+    uuid<O extends ColUuidOptions = ColUuidOptions>(options?: O & TypedSerialize<NullableColumn<string, O>>): ColumnDef<NullableColumn<string, O>>;
+    /**
+     * ULID column. Auto-generates a ULID if no value is provided on insert.
+     * Type: `string` (nullable-aware). Only `serialize` is exposed.
+     */
+    ulid<O extends ColUlidOptions = ColUlidOptions>(options?: O & TypedSerialize<NullableColumn<string, O>>): ColumnDef<NullableColumn<string, O>>;
+    /**
+     * Binary/blob column.
+     * Type: `Buffer | Uint8Array | string` (nullable-aware).
+     * Supports typed `serialize` and `prepare`.
+     */
+    binary<T extends Buffer | Uint8Array | string = Buffer | Uint8Array | string, O extends ColBinaryOptions = ColBinaryOptions>(options?: O & TypedSerialize<NullableColumn<T, O>> & TypedPrepare<NullableColumn<T, O>>): ColumnDef<NullableColumn<T, O>>;
+    /**
+     * Enum column constrained to the given values array.
+     * Type: `values[number]` (nullable-aware).
+     *
+     * ```ts
+     * col.enum(["active", "inactive"] as const)               // "active" | "inactive" | null | undefined
+     * col.enum(["active", "inactive"] as const, { nullable: false }) // "active" | "inactive"
+     * ```
+     */
+    enum<const V extends readonly string[], O extends ColEnumOptions = ColEnumOptions>(values: V, options?: O & TypedSerialize<NullableColumn<V[number], O>> & TypedPrepare<NullableColumn<V[number], O>>): ColumnDef<NullableColumn<V[number], O>>;
+    /** Encryption column helpers. */
+    encryption: {
+        /**
+         * Symmetric encryption column (AES). Requires `key` in options.
+         * Type: `string` (nullable-aware). No `serialize` or `prepare` exposed.
+         */
+        symmetric<O extends ColSymmetricOptions = ColSymmetricOptions>(options: O): ColumnDef<NullableColumn<string, O>>;
+        /**
+         * Asymmetric encryption column (RSA). Requires `publicKey` and
+         * `privateKey` in options.
+         * Type: `string` (nullable-aware). No `serialize` or `prepare` exposed.
+         */
+        asymmetric<O extends ColAsymmetricOptions = ColAsymmetricOptions>(options: O): ColumnDef<NullableColumn<string, O>>;
+    };
+}
+type AnyModelClass = abstract new (...args: any[]) => Model;
+type SelfModelInstance = Model & {
+    readonly [__selfBrand]: true;
+};
+type SelfToken = abstract new (...args: any[]) => SelfModelInstance;
+/**
+ * Model callback type for relation definitions.
+ * Accepts either `() => OtherModel` or `(self) => self` for self-referencing
+ * relations (tree structures, parent/child, etc.).
+ */
+type RelModelCallback<M extends AnyModelClass> = (self: SelfToken) => M;
+/**
+ * Provides autocomplete for column keys of the related model while still accepting any string
+ */
+type ForeignKeyOf<M extends AnyModelClass> = ModelKey<InstanceType<M> & Model> | (string & {});
+/**
+ * Extracts the Model instance type from a through-model callback.
+ */
+type InferThroughModelInstance<TM> = TM extends () => infer T ? T extends AnyModelClass ? InstanceType<T> & Model : Model : Model;
+interface RelNamespace {
+    /**
+     * One-to-one relation where the foreign key lives on the **related** model.
+     * The `foreignKey` parameter autocompletes with column keys of `M`.
+     *
+     * Pass `{ nullable: false }` to type the relation as non-nullable.
+     *
+     * ```ts
+     * rel.hasOne(() => Profile, "userId", { nullable: false }) // Profile
+     * rel.hasOne(() => Profile, "userId")                      // Profile | null | undefined
+     * ```
+     *
+     * @param model     Callback returning the related model class (or `(self) => self` for self-referencing).
+     * @param foreignKey Column on the related model that references the current model's primary key.
+     * @param options   `{ nullable: false }` to mark the relation as always present.
+     */
+    hasOne<M extends AnyModelClass>(model: RelModelCallback<M>, foreignKey: ForeignKeyOf<M> | undefined, options: {
+        nullable: false;
+    }): RelationDef<InstanceType<M>>;
+    hasOne<M extends AnyModelClass>(model: RelModelCallback<M>, foreignKey?: ForeignKeyOf<M>, options?: RelationNullableOption): RelationDef<InstanceType<M> | null | undefined>;
+    /**
+     * One-to-many relation where the foreign key lives on the **related** model.
+     * The `foreignKey` parameter autocompletes with column keys of `M`.
+     *
+     * Pass `{ nullable: false }` to type the relation as non-nullable (always
+     * returns an array, never `null | undefined`).
+     *
+     * ```ts
+     * rel.hasMany(() => Post, "authorId", { nullable: false }) // Post[]
+     * rel.hasMany(() => Post, "authorId")                      // Post[] | null | undefined
+     * ```
+     *
+     * @param model     Callback returning the related model class (or `(self) => self` for self-referencing).
+     * @param foreignKey Column on the related model that references the current model's primary key.
+     * @param options   `{ nullable: false }` to mark the relation as always present.
+     */
+    hasMany<M extends AnyModelClass>(model: RelModelCallback<M>, foreignKey: ForeignKeyOf<M> | undefined, options: {
+        nullable: false;
+    }): RelationDef<InstanceType<M>[]>;
+    hasMany<M extends AnyModelClass>(model: RelModelCallback<M>, foreignKey?: ForeignKeyOf<M>, options?: RelationNullableOption): RelationDef<InstanceType<M>[] | null | undefined>;
+    /**
+     * Inverse one-to-one / many-to-one relation where the foreign key lives
+     * on the **current** model.
+     *
+     * The `foreignKey` parameter autocompletes with column keys of the related
+     * model `M` as a naming hint; any string is still accepted since the
+     * actual column is on the current model.
+     *
+     * Pass `{ nullable: false }` (inside the constraint options) to type the
+     * relation as non-nullable.
+     *
+     * ```ts
+     * rel.belongsTo(() => User, "userId", { nullable: false }) // User
+     * rel.belongsTo(() => User, "userId")                      // User | null | undefined
+     * rel.belongsTo((self) => self, "parentId")                // self-referencing
+     * ```
+     *
+     * @param model     Callback returning the related model class (or `(self) => self` for self-referencing).
+     * @param foreignKey Column on the **current** model that references the related model's primary key.
+     * @param options   Constraint options (`onDelete`, `onUpdate`, `constraintName`) and `{ nullable: false }`.
+     */
+    belongsTo<M extends AnyModelClass>(model: RelModelCallback<M>, foreignKey: ForeignKeyOf<M> | undefined, options: RelationConstraintOptions & {
+        nullable: false;
+    }): RelationDef<InstanceType<M>>;
+    belongsTo<M extends AnyModelClass>(model: RelModelCallback<M>, foreignKey?: ForeignKeyOf<M>, options?: RelationConstraintOptions & RelationNullableOption): RelationDef<InstanceType<M> | null | undefined>;
+    /**
+     * Many-to-many relation through a pivot (join) table.
+     *
+     * - `throughModel`: either a string (pivot table name) or a callback
+     *   returning a Model class (`() => PivotModel`).
+     * - When a Model callback is provided:
+     *   - `leftForeignKey` autocompletes with the **through model**'s column
+     *     keys (the FK on the pivot table referencing the current model).
+     *   - `rightForeignKey` autocompletes with the **related model** `M`'s
+     *     column keys (the FK on the pivot table referencing the related model).
+     * - When a plain string is provided, both keys accept any string.
+     *
+     * Pass `{ nullable: false }` to type the relation as non-nullable.
+     *
+     * ```ts
+     * // Through model as callback — typed FK autocomplete
+     * rel.manyToMany(() => Tag, () => PostTag, {
+     *   leftForeignKey: "postId",  // autocompletes with PostTag keys
+     *   rightForeignKey: "tagId",  // autocompletes with Tag keys
+     * })
+     *
+     * // Through model as string — plain string FKs
+     * rel.manyToMany(() => Tag, "post_tags", {
+     *   leftForeignKey: "post_id",
+     *   rightForeignKey: "tag_id",
+     * })
+     * ```
+     *
+     * @param model            Callback returning the related model class.
+     * @param throughModel      Pivot model callback or table name string.
+     * @param throughModelKeys  Foreign key mapping on the pivot table.
+     * @param options          Constraint options and `{ nullable: false }`.
+     */
+    manyToMany<M extends AnyModelClass, T extends AnyModelConstructor = AnyModelConstructor, TM extends ThroughModel<T> = ThroughModel<T>>(model: RelModelCallback<M>, throughModel: TM, throughModelKeys: TM extends string ? ManyToManyStringOptions : {
+        leftForeignKey?: ModelKey<InferThroughModelInstance<TM>> | (string & {});
+        rightForeignKey?: ForeignKeyOf<M>;
+    }, options: RelationConstraintOptions & {
+        nullable: false;
+    }): RelationDef<InstanceType<M>[]>;
+    manyToMany<M extends AnyModelClass, T extends AnyModelConstructor = AnyModelConstructor, TM extends ThroughModel<T> = ThroughModel<T>>(model: RelModelCallback<M>, throughModel: TM, throughModelKeys?: TM extends string ? ManyToManyStringOptions : {
+        leftForeignKey?: ModelKey<InferThroughModelInstance<TM>> | (string & {});
+        rightForeignKey?: ForeignKeyOf<M>;
+    }, options?: RelationConstraintOptions & RelationNullableOption): RelationDef<InstanceType<M>[] | null | undefined>;
+}
+type IndexDefinition<K extends string = string> = K[] | {
+    columns: K[];
+    name?: string;
+};
+type UniqueDefinition<K extends string = string> = K[] | {
+    columns: K[];
+    name?: string;
+};
+type CheckDefinition = string | {
+    expression: string;
+    name?: string;
+};
+type HooksDefinition<T = any> = {
+    beforeFetch?: (queryBuilder: ModelQueryBuilder<any>) => Promise<void> | void;
+    afterFetch?: (data: T[]) => Promise<T[]> | T[];
+    beforeInsert?: (data: Partial<T>) => Promise<void> | void;
+    beforeInsertMany?: (data: Partial<T>[]) => Promise<void> | void;
+    beforeUpdate?: (queryBuilder: ModelQueryBuilder<any>) => Promise<void> | void;
+    beforeDelete?: (queryBuilder: ModelQueryBuilder<any>) => Promise<void> | void;
+};
+type DefineModelOptions<K extends string = string> = {
+    modelCaseConvention?: CaseConvention;
+    databaseCaseConvention?: CaseConvention;
+    softDeleteColumn?: K;
+    softDeleteValue?: boolean | string;
+};
+type InferColumns<C extends Record<string, ColumnDef>> = {
+    [K in keyof C]: C[K] extends ColumnDef<infer T> ? T : never;
+};
+/**
+ * Detects self-referencing relations (branded with `SelfModelInstance`) and
+ * replaces them with the actual column types of the defining model.
+ * Non-self relations pass through unchanged.
+ */
+type ResolveSelfRef<T, SelfType> = [T] extends [
+    SelfModelInstance[] | null | undefined
+] ? SelfType[] | Extract<T, null | undefined> : [T] extends [SelfModelInstance | null | undefined] ? SelfType | Extract<T, null | undefined> : T;
+type InferRelations<C extends Record<string, ColumnDef>, R extends Record<string, RelationDef>> = {
+    [K in keyof R]: R[K] extends RelationDef<infer T> ? ResolveSelfRef<T, InferColumns<C> & Model> : never;
+};
+/**
+ * Infers the instance type of a model defined with `defineModel`.
+ */
+type InferModel<C extends Record<string, ColumnDef>, R extends Record<string, RelationDef>> = InferColumns<C> & InferRelations<C, R>;
+type ModelDefinition<C extends Record<string, ColumnDef> = Record<string, ColumnDef>, R extends Record<string, RelationDef> = Record<string, RelationDef>> = {
+    columns: C;
+    relations?: R;
+    indexes?: IndexDefinition<keyof C & string>[];
+    uniques?: UniqueDefinition<keyof C & string>[];
+    checks?: CheckDefinition[];
+    hooks?: HooksDefinition<InferColumns<C>>;
+    options?: DefineModelOptions<keyof C & string>;
+};
+/**
+ * Public statics of `typeof Model` without the abstract constructor flag.
+ */
+type ConcreteModelStatics = {
+    [K in keyof typeof Model]: (typeof Model)[K];
+};
+/**
+ * Union type that accepts both decorator-based model classes (`typeof Model`
+ * subclasses) and programmatic models created via `defineModel`.
+ *
+ * Use this instead of `typeof Model` in any user-facing API that should
+ * accept either kind of model.
+ */
+type AnyModelConstructor = typeof Model | (ConcreteModelStatics & (new (...args: any[]) => Model));
+/**
+ * The return type of `defineModel` – a concrete Model constructor whose
+ * instances carry the inferred column + relation properties.
+ *
+ * Uses a mapped type over `typeof Model` so the abstract flag is stripped,
+ * making the result instantiable while keeping all public static members.
+ */
+type DefinedModel<C extends Record<string, ColumnDef>, R extends Record<string, RelationDef>> = ConcreteModelStatics & {
+    new (): InferModel<C, R> & Model;
+};
+
 type BaseModelRelationType = {
     onDelete?: OnUpdateOrDelete;
     onUpdate?: OnUpdateOrDelete;
@@ -6768,7 +7248,7 @@ declare function timeOnlyColumn(options?: Omit<DateColumnOptions, "format">): Ty
  * @description Defaults type to jsonb for migration generation
  */
 declare function jsonColumn(options?: Omit<ColumnOptions, "prepare" | "serialize">): TypedPropertyDecorator<unknown>;
-declare function getModelColumns(target: typeof Model): ColumnType[];
+declare function getModelColumns(target: AnyModelConstructor): ColumnType[];
 /**
  * relations
  */
@@ -6780,22 +7260,22 @@ declare function getModelColumns(target: typeof Model): ColumnType[];
  * belongsTo<typeof Post>(() => User, 'userId')
  * ```
  */
-declare function belongsTo<M extends typeof Model = any, R extends typeof Model = any>(model: () => R, foreignKey?: ModelKey<InstanceType<M>>, options?: BaseModelRelationType): TypedPropertyDecorator<InstanceType<R> | null | undefined>;
-declare function belongsTo<R extends typeof Model = any>(model: () => R, foreignKey?: string, options?: BaseModelRelationType): TypedPropertyDecorator<InstanceType<R> | null | undefined>;
+declare function belongsTo<M extends AnyModelConstructor = any, R extends AnyModelConstructor = any>(model: () => R, foreignKey?: ModelKey<InstanceType<M>>, options?: BaseModelRelationType): TypedPropertyDecorator<InstanceType<R> | null | undefined>;
+declare function belongsTo<R extends AnyModelConstructor = any>(model: () => R, foreignKey?: string, options?: BaseModelRelationType): TypedPropertyDecorator<InstanceType<R> | null | undefined>;
 /**
  * @description Establishes a has one relation with the given model
  * @default foreignKey by default will be the singular of the model name plus "_id"
  * @example User will have foreignKey "user_id" on the Post model
  */
-declare function hasOne<T extends typeof Model>(model: () => T, foreignKey?: ModelKey<InstanceType<T>>): TypedPropertyDecorator<InstanceType<T> | null | undefined>;
-declare function hasOne<T extends typeof Model>(model: () => T, foreignKey?: string): TypedPropertyDecorator<InstanceType<T> | null | undefined>;
+declare function hasOne<T extends AnyModelConstructor>(model: () => T, foreignKey?: ModelKey<InstanceType<T>>): TypedPropertyDecorator<InstanceType<T> | null | undefined>;
+declare function hasOne<T extends AnyModelConstructor>(model: () => T, foreignKey?: string): TypedPropertyDecorator<InstanceType<T> | null | undefined>;
 /**
  * @description Establishes a has many relation with the given model
  * @default foreignKey by default will be the singular of the model name plus "_id"
  * @example User will have foreignKey "user_id" on the Post model
  */
-declare function hasMany<T extends typeof Model>(model: () => T, foreignKey?: ModelKey<InstanceType<T>>): TypedPropertyDecorator<InstanceType<T>[] | null | undefined>;
-declare function hasMany<T extends typeof Model>(model: () => T, foreignKey?: string): TypedPropertyDecorator<InstanceType<T>[] | null | undefined>;
+declare function hasMany<T extends AnyModelConstructor>(model: () => T, foreignKey?: ModelKey<InstanceType<T>>): TypedPropertyDecorator<InstanceType<T>[] | null | undefined>;
+declare function hasMany<T extends AnyModelConstructor>(model: () => T, foreignKey?: string): TypedPropertyDecorator<InstanceType<T>[] | null | undefined>;
 /**
  * @description Establishes a many to many relation with the given model
  * @default foreignKey by default will be the singular of the model that establishes the relation name plus "_id"
@@ -6806,20 +7286,56 @@ declare function hasMany<T extends typeof Model>(model: () => T, foreignKey?: st
  * @param throughModelKeys.rightForeignKey The foreign key of the through model from the related model (the model you are joining to)
  * @example User will have foreignKey "user_id" on the Join table by default
  */
-declare function manyToMany<R extends typeof Model, T extends typeof Model, TM extends ThroughModel<T>>(model: () => R, throughModel: TM, throughModelKeys?: ManyToManyOptions<T, TM>, options?: BaseModelRelationType): TypedPropertyDecorator<InstanceType<R>[] | null | undefined>;
-declare function manyToMany<R extends typeof Model>(model: () => R, throughModel: string | (() => typeof Model), throughModelKeys?: ManyToManyStringOptions, options?: BaseModelRelationType): TypedPropertyDecorator<InstanceType<R>[] | null | undefined>;
-declare function getRelationsMetadata(target: typeof Model): LazyRelationType[];
+declare function manyToMany<R extends AnyModelConstructor, T extends AnyModelConstructor, TM extends ThroughModel<T>>(model: () => R, throughModel: TM, throughModelKeys?: ManyToManyOptions<T, TM>, options?: BaseModelRelationType): TypedPropertyDecorator<InstanceType<R>[] | null | undefined>;
+declare function manyToMany<R extends AnyModelConstructor>(model: () => R, throughModel: string | (() => AnyModelConstructor), throughModelKeys?: ManyToManyStringOptions, options?: BaseModelRelationType): TypedPropertyDecorator<InstanceType<R>[] | null | undefined>;
+declare function getRelationsMetadata(target: AnyModelConstructor): LazyRelationType[];
 /**
  * @description Returns the relations of the model
  */
-declare function getRelations(target: typeof Model): Relation[];
+declare function getRelations(target: AnyModelConstructor): Relation[];
 /**
  * @description Returns the primary key of the model
  */
-declare function getPrimaryKey(target: typeof Model): string | undefined;
-declare function getIndexes(target: typeof Model): IndexType[];
-declare function getUniques(target: typeof Model): UniqueType[];
-declare function getChecks(target: typeof Model): CheckType[];
+declare function getPrimaryKey(target: AnyModelConstructor): string | undefined;
+declare function getIndexes(target: AnyModelConstructor): IndexType[];
+declare function getUniques(target: AnyModelConstructor): UniqueType[];
+declare function getChecks(target: AnyModelConstructor): CheckType[];
+
+declare const col: ColNamespace;
+declare const rel: RelNamespace;
+/**
+ * Creates a fully-typed Model subclass programmatically without decorators.
+ *
+ * The returned class is a real `typeof Model` subclass that works with all
+ * existing infrastructure: `SqlDataSource`, `ModelManager`, `ModelQueryBuilder`,
+ * `SchemaDiff` (automatic migrations), hooks, etc.
+ *
+ * @example
+ * ```typescript
+ * import { defineModel, col, rel } from "hysteria-orm";
+ *
+ * const User = defineModel("users", {
+ *   columns: {
+ *     id: col.increment(),
+ *     name: col.string(),
+ *     email: col.string({ nullable: false }),
+ *     isActive: col.boolean(),
+ *     createdAt: col.datetime({ autoCreate: true }),
+ *     updatedAt: col.datetime({ autoCreate: true, autoUpdate: true }),
+ *   },
+ *   relations: {
+ *     posts: rel.hasMany(() => Post, "userId"),
+ *     profile: rel.hasOne(() => Profile),
+ *   },
+ *   indexes: [["email"]],
+ *   uniques: [["email"]],
+ *   hooks: {
+ *     beforeFetch(qb) { qb.whereNull("deleted_at"); },
+ *   },
+ * });
+ * ```
+ */
+declare function defineModel<C extends Record<string, ColumnDef>, R extends Record<string, RelationDef> = {}>(table: string, definition: ModelDefinition<C, R>): DefinedModel<C, R>;
 
 type FactoryReturnType<T extends number, O extends Model> = T extends 1 ? O : O[];
 
@@ -6829,7 +7345,7 @@ declare class ModelFactory<M extends Model> {
     /**
      * @description Constructor for the model factory
      */
-    constructor(typeofModel: typeof Model, modelData: Partial<M>);
+    constructor(typeofModel: AnyModelConstructor, modelData: Partial<M>);
     /**
      * @description Merges the provided data with the model data
      */
@@ -6841,7 +7357,7 @@ declare class ModelFactory<M extends Model> {
      */
     create<T extends number>(howMany: T): Promise<FactoryReturnType<T, M>>;
 }
-declare const createModelFactory: <M extends Model>(typeofModel: typeof Model, modelData: Partial<ModelWithoutRelations<M>>) => ModelFactory<M>;
+declare const createModelFactory: <M extends Model>(typeofModel: AnyModelConstructor, modelData: Partial<ModelWithoutRelations<M>>) => ModelFactory<M>;
 
 type Constructor<T = Model> = new (...args: any[]) => T;
 type AbstractConstructor<T = Model> = abstract new (...args: any[]) => T;
@@ -7982,4 +8498,4 @@ declare const generateOpenApiModelWithMetadata: <T extends new () => Model>(mode
     $id?: string;
 }>;
 
-export { type AbstractConstructor, type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnyConstructor, type AsymmetricEncryptionOptions, type BaseModelMethodOptions, type BaseModelRelationType, BaseSeeder, type BigIntFields, type BuildSelectType, type BuildSingleSelectType, type CacheAdapter, type CacheKeys, type CheckType, ClientMigrator, Collection, type ColumnDataTypeOption, type ColumnDataTypeOptionSimple, type ColumnDataTypeOptionWithBinary, type ColumnDataTypeOptionWithDatePrecision, type ColumnDataTypeOptionWithEnum, type ColumnDataTypeOptionWithLength, type ColumnDataTypeOptionWithPrecision, type ColumnDataTypeOptionWithScaleAndPrecision, type ColumnDataTypeOptionWithText, type ColumnOptions, type ColumnType, type CommonDataSourceInput, type ComposeBuildSelect, type ComposeSelect, type ConnectionPolicies, type Constructor, type CustomLogger, type DataSourceInput, type DataSourceType, type DateColumnOptions, type DatetimeColumnOptions, type ExcludeMethods, type ExtractColumnName, type ExtractSourceColumn, type FetchHooks, type FindReturnType, type GetColumnType, type GetConnectionReturnType, HysteriaError, InMemoryAdapter, type IncrementFields, type IndexType, type LazyRelationType, type LoggerConfig, type ManyOptions, type ManyToManyOptions, type ManyToManyStringOptions, Migration, type MigrationConfig, type MigrationConfigBase, type MixinColumns, MixinFactory, Model, type ModelDataProperties, type ModelInstanceType, type ModelKey, ModelQueryBuilder, type ModelQueryResult, type ModelRelation, type ModelSelectTuple, type ModelSelectableInput, type ModelWithoutRelations, MongoDataSource, type MongoDataSourceInput$1 as MongoDataSourceInput, type MssqlConnectionInstance, type MssqlDataSourceInput, type MssqlPoolInstance, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullableOracleDBDataSourceInput, type NotNullableOracleMssqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NumberModelKey, type OneOptions, type OracleDBDataSourceInput, type OracleDBPoolInstance, type PgPoolClientInstance, type PostgresSqlDataSourceInput, QueryBuilder, type RawModelOptions, RawNode, type RawQueryOptions, RedisCacheAdapter, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationQueryBuilderType, type ReplicationType, type ReturningColumns, type ReturningKey, Schema, SchemaBuilder, 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 SymmetricEncryptionOptions, type TableFormat, type ThroughModel, type TimestampFields, Transaction, type TransactionExecutionOptions, type TypedPropertyDecorator, type UlidFields, UlidMixin, type UniqueType, type UseCacheReturnType, type UseConnectionInput, type UuidFields, UuidMixin, WriteOperation, type WriteReturnType, belongsTo, bigIntMixin, check, column, createMixin, createModelFactory, defineMigrator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, getChecks, getCollectionProperties, getIndexes, getModelColumns, type getPoolReturnType, getPrimaryKey, getRelations, getRelationsMetadata, getUniques, hasMany, hasOne, incrementMixin, index, HysteriaLogger as logger, manyToMany, property, RedisDataSource as redis, timestampMixin, ulidMixin, unique, uuidMixin, view, withPerformance };
+export { type AbstractConstructor, type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnyConstructor, type AnyModelConstructor, type AsymmetricEncryptionOptions, type BaseModelMethodOptions, type BaseModelRelationType, BaseSeeder, type BigIntFields, type BuildSelectType, type BuildSingleSelectType, type CacheAdapter, type CacheKeys, type CheckType, ClientMigrator, Collection, type ColumnDataTypeOption, type ColumnDataTypeOptionSimple, type ColumnDataTypeOptionWithBinary, type ColumnDataTypeOptionWithDatePrecision, type ColumnDataTypeOptionWithEnum, type ColumnDataTypeOptionWithLength, type ColumnDataTypeOptionWithPrecision, type ColumnDataTypeOptionWithScaleAndPrecision, type ColumnDataTypeOptionWithText, type ColumnDef, type ColumnOptions, type ColumnType, type CommonDataSourceInput, type ComposeBuildSelect, type ComposeSelect, type ConnectionPolicies, type Constructor, type CustomLogger, type DataSourceInput, type DataSourceType, type DateColumnOptions, type DatetimeColumnOptions, type DefinedModel, type ExcludeMethods, type ExtractColumnName, type ExtractSourceColumn, type FetchHooks, type FindReturnType, type GetColumnType, type GetConnectionReturnType, HysteriaError, InMemoryAdapter, type IncrementFields, type IndexType, type LazyRelationType, type LoggerConfig, type ManyOptions, type ManyToManyOptions, type ManyToManyStringOptions, Migration, type MigrationConfig, type MigrationConfigBase, type MixinColumns, MixinFactory, Model, type ModelDataProperties, type ModelInstanceType, type ModelKey, ModelQueryBuilder, type ModelQueryResult, type ModelRelation, type ModelSelectTuple, type ModelSelectableInput, type ModelWithoutRelations, MongoDataSource, type MongoDataSourceInput$1 as MongoDataSourceInput, type MssqlConnectionInstance, type MssqlDataSourceInput, type MssqlPoolInstance, 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, QueryBuilder, type RawModelOptions, RawNode, type RawQueryOptions, RedisCacheAdapter, type RedisFetchable, type RedisStorable, type RelModelCallback, type RelatedInstance, type RelationDef, type RelationNullableOption, type RelationQueryBuilderType, type ReplicationType, type ReturningColumns, type ReturningKey, Schema, SchemaBuilder, 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 SymmetricEncryptionOptions, type TableFormat, type ThroughModel, type TimestampFields, Transaction, type TransactionExecutionOptions, type TypedPrepare, type TypedPropertyDecorator, type TypedSerialize, type UlidFields, UlidMixin, type UniqueType, type UseCacheReturnType, type UseConnectionInput, type UuidFields, UuidMixin, WriteOperation, type WriteReturnType, belongsTo, bigIntMixin, check, col, column, createMixin, createModelFactory, defineMigrator, defineModel, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, getChecks, getCollectionProperties, getIndexes, getModelColumns, type getPoolReturnType, getPrimaryKey, getRelations, getRelationsMetadata, getUniques, hasMany, hasOne, incrementMixin, index, HysteriaLogger as logger, manyToMany, property, RedisDataSource as redis, rel, timestampMixin, ulidMixin, unique, uuidMixin, view, withPerformance };