hysteria-orm 11.0.11 → 11.1.0

package/lib/index.d.cts

@@ -1999,6 +1999,33 @@ declare class InterpreterUtils {
     private readonly autoUpdateColumns;
     constructor(model: typeof Model);
     formatStringColumn(dbType: SqlDataSourceType, column: string): string;
+    /**
+     * @description Returns the raw SQL expression of a computed column, if the given
+     * reference points to one. Strips an optional table prefix before looking up the
+     * model column metadata. Returns `undefined` for non-computed columns.
+     * @internal
+     */
+    resolveComputedExpression(column: string): string | undefined;
+    /**
+     * @description Returns true if the given column name (model property name)
+     * refers to a computed (virtual) column.
+     * @internal
+     */
+    isComputedColumn(column: string): boolean;
+    /**
+     * @description Removes computed (virtual) columns from a list of column names.
+     * Computed columns are never persisted and must not appear in INSERT, UPDATE,
+     * or ON CONFLICT / ON DUPLICATE KEY UPDATE clauses.
+     * @internal
+     */
+    filterComputedColumns(columns: string[]): string[];
+    /**
+     * @description Strips computed (virtual) columns from a data object.
+     * Used before building AST nodes so computed columns never appear in
+     * generated SQL (neither in execution nor in `toSql()` / `unWrap()` previews).
+     * @internal
+     */
+    stripComputedFromData<T extends Record<string, any>>(data: T): T;
     /**
      * @description Formats a column WITHOUT table qualification.
      * ON CONFLICT target lists (Postgres/SQLite) and `excluded.<col>` refs require
@@ -2942,12 +2969,13 @@ type StreamOptions = {
     /** Mysql only */
     objectMode?: boolean;
 };
+type CursorValue = string | number;
 type Cursor<T extends Model, K extends ModelKey<T>> = {
-    key: K;
-    value: string | number;
+    key: K | K[];
+    value: CursorValue | CursorValue[];
 };
 type PaginateWithCursorOptions<T extends Model, K extends ModelKey<T>> = {
-    discriminator: K;
+    discriminator: K | K[];
     operator?: "<" | ">";
     orderBy?: "asc" | "desc";
 };
@@ -3307,6 +3335,15 @@ type ColumnOptions = {
      * @migration Only affects auto-generated migrations
      */
     zerofill?: boolean;
+    /**
+     * @description Marks the column as a computed (virtual) column. The value is
+     * computed by the database at query time from this raw SQL expression instead
+     * of being stored as a physical column.
+     * @description Computed columns are excluded from migrations and never written
+     * on insert/update. They only appear in results when explicitly selected.
+     * @internal Set via `col.computed()` / `@column.computed()`.
+     */
+    expression?: string;
 } & 
 /**
  * @description The data type of the column
@@ -3338,6 +3375,12 @@ type ColumnType = {
         default?: string | number | null | boolean;
     };
     validate?: Validator | Validator[];
+    /**
+     * @description Raw SQL expression for computed (virtual) columns set via
+     * `col.computed()` / `@column.computed()`. The value is computed by the
+     * database at query time and is not a physical column.
+     */
+    expression?: string;
 };
 type IndexType = {
     columns: string[];
@@ -3766,6 +3809,17 @@ declare class SelectQueryBuilder<T extends Model, S extends Record<string, any>
      * @description Clears the SELECT clause
      */
     clearSelect(): this;
+    /**
+     * @description Resolves a column reference to a computed column definition, if any.
+     * @description Strips an optional table prefix, looks the column up in the model's
+     * column metadata, and returns its raw SQL expression plus the database-convention
+     * alias to use in the SELECT clause. Returns `undefined` for non-computed columns.
+     * @internal
+     */
+    protected resolveComputedColumn(column: string): {
+        expression: string;
+        alias: string;
+    } | undefined;
     /**
      * @description Clears the FROM clause
      */
@@ -4463,7 +4517,7 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
      * @description Allows to avoid offset clause that can be inefficient for large datasets
      * @description If using a model query builder, primary key is used as discriminator by default
      * @param options - The options for the paginate with cursor
-     * @param options.discriminator - The discriminator to use for the paginate with Cursor pagination
+     * @param options.discriminator - The discriminator (or array of discriminators) to use for the paginate with Cursor pagination. Passing an array enables composite cursor pagination across multiple columns.
      * @param options.operator - The operator to use for the paginate with Cursor pagination
      * @param options.orderBy - The order by to use for the paginate with Cursor pagination
      * @param cursor - The cursor to use for the paginate with Cursor pagination
@@ -6826,6 +6880,24 @@ interface ColumnDef<T = unknown> {
 interface PrimaryColumnDef<T = unknown> extends ColumnDef<T> {
     readonly _isPrimary: true;
 }
+/**
+ * A column descriptor for a computed (virtual) column defined with
+ * `col.computed()` / `@column.computed()`.
+ *
+ * The value is computed by the database at query time from a raw SQL expression.
+ * Computed columns:
+ * - are excluded from auto-generated migrations (they carry no `type`)
+ * - are never written on insert/update
+ * - only appear in query results when explicitly selected
+ * - resolve to the raw expression when referenced in WHERE/ORDER BY/GROUP BY/HAVING
+ *
+ * `T` carries the TypeScript type the column resolves to when selected.
+ * Inferred instance types treat computed columns as `T | undefined` since they
+ * are absent from results unless explicitly selected.
+ */
+interface ComputedColumnDef<T = unknown> extends ColumnDef<T> {
+    readonly __computed: true;
+}
 /**
  * Phantom-typed descriptor for a model relation.
  * `T` carries the TypeScript type the relation resolves to at the instance level.
@@ -6896,6 +6968,13 @@ type ColMediumIntOptions = Omit<ColumnOptions, "type" | "serialize" | "prepare"
     unsigned?: boolean;
     zerofill?: boolean;
 };
+type ColComputedOptions = Omit<ColumnOptions, "type" | "primaryKey" | "serialize" | "prepare" | "default" | "autoUpdate"> & {
+    /**
+     * Optional callback applied to the value returned from the database before
+     * it is placed on the model instance.
+     */
+    serialize?: (value: any) => any;
+};
 type RelationConstraintOptions = {
     /**
      * Useful for auto generated migrations to specify the on delete action, it does not affect the code wise implementation
@@ -7243,6 +7322,47 @@ interface ColNamespace {
          */
         asymmetric<O extends ColAsymmetricOptions = ColAsymmetricOptions>(options: O): ColumnDef<NullableColumn<string, O>>;
     };
+    /**
+     * Computed (virtual) column. The value is computed by the database at query
+     * time from the given raw SQL expression instead of being stored as a
+     * physical column (and instead of being computed in TypeScript). Because the
+     * expression is pushed down into the generated SQL, the computation is done
+     * by the database engine — efficient for filtering, sorting and aggregation
+     * directly on the server.
+     *
+     * @param expression The raw SQL expression evaluated by the database at
+     *   query time. It references physical columns as they exist in the database
+     *   (no case conversion is applied), so it must be written in the database's
+     *   own dialect, e.g. `"concat(first_name, last_name)"` or
+     *   `"price * quantity"`.
+     * @param options Optional column options (e.g. `databaseName` for a custom
+     *   result alias, or `serialize` to transform the returned value).
+     *
+     * Computed columns:
+     * - are excluded from auto-generated migrations
+     * - are never written on insert/update
+     * - only appear in results when explicitly selected (`.select(User.fullName)`
+     *   or `[User.fullName, "alias"]` tuples)
+     * - resolve to the raw expression when referenced in WHERE / ORDER BY /
+     *   GROUP BY / HAVING
+     *
+     * ```ts
+     * const User = defineModel("users", {
+     *   columns: {
+     *     id: col.increment(),
+     *     firstName: col.string(),
+     *     lastName: col.string(),
+     *     fullName: col.computed<string>("concat(first_name, last_name)"),
+     *   },
+     * });
+     *
+     * // Selected explicitly - result has fullName: string (computed by the DB)
+     * const user = await sql.from(User).select(User.fullName).one();
+     * // Not selected - fullName is absent from the result
+     * const user = await sql.from(User).one();
+     * ```
+     */
+    computed<T = unknown>(expression: string, options?: ColComputedOptions): ComputedColumnDef<T>;
 }
 type IndexDefinition<K extends string = string> = K[] | {
     columns: K[];
@@ -7282,7 +7402,7 @@ type InferPK<C extends Record<string, ColumnDef>> = [
     ExtractPKType<C>
 ] extends [never] ? string | number : ExtractPKType<C>;
 type InferColumns<C extends Record<string, ColumnDef>> = {
-    [K in keyof C]: C[K] extends ColumnDef<infer T> ? T : never;
+    [K in keyof C]: C[K] extends ComputedColumnDef<infer T> ? T | undefined : C[K] extends ColumnDef<infer T> ? T : never;
 };
 type InferRelations<R extends Record<string, RelationDef>> = {
     [K in keyof R]: R[K] extends RelationDef<infer V> ? V : never;
@@ -8499,4 +8619,4 @@ type BetterAuthAdapterConfig = Partial<Pick<AdapterFactoryConfig, "usePlural" |
  */
 declare function betterAuthAdapter(sql: SqlDataSource, config?: BetterAuthAdapterConfig): (options: BetterAuthOptions) => DBAdapter;
 
-export { type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnyModelConstructor, type AtomicOptions, type BaseModelMethodOptions, BaseSeeder, type BetterAuthAdapterConfig, 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, type HysteriaErrorCode, 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 MigrationLockConfig, 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, atomic, betterAuthAdapter, 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 };
+export { type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnyModelConstructor, type AtomicOptions, type BaseModelMethodOptions, BaseSeeder, type BetterAuthAdapterConfig, type BuildSelectType, type BuildSingleSelectType, type CacheAdapter, type CacheKeys, ClientMigrator, type ColCharOptions, type ColComputedOptions, type ColJsonbOptions, type ColMediumIntOptions, type ColSmallIntOptions, type ColTinyIntOptions, type ColVarbinaryOptions, Collection, type CollectionDefinition, type ColumnDef, type CommonDataSourceInput, type ComposeBuildSelect, type ComposeSelect, type ComputedColumnDef, type ConnectionPolicies, type CreateSchemaResult, type CustomLogger, type DataSourceInput, type DataSourceType, type DateAutoHook, type DefinedCollection, type DefinedModel, type DefinedView, type ExcludeMethods, type ExtractColumnName, type ExtractSourceColumn, type FetchHooks, type FindReturnType, type GetColumnType, type GetConnectionReturnType, HysteriaError, type HysteriaErrorCode, 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 MigrationLockConfig, 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, atomic, betterAuthAdapter, 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 };

package/lib/index.d.ts

@@ -1999,6 +1999,33 @@ declare class InterpreterUtils {
     private readonly autoUpdateColumns;
     constructor(model: typeof Model);
     formatStringColumn(dbType: SqlDataSourceType, column: string): string;
+    /**
+     * @description Returns the raw SQL expression of a computed column, if the given
+     * reference points to one. Strips an optional table prefix before looking up the
+     * model column metadata. Returns `undefined` for non-computed columns.
+     * @internal
+     */
+    resolveComputedExpression(column: string): string | undefined;
+    /**
+     * @description Returns true if the given column name (model property name)
+     * refers to a computed (virtual) column.
+     * @internal
+     */
+    isComputedColumn(column: string): boolean;
+    /**
+     * @description Removes computed (virtual) columns from a list of column names.
+     * Computed columns are never persisted and must not appear in INSERT, UPDATE,
+     * or ON CONFLICT / ON DUPLICATE KEY UPDATE clauses.
+     * @internal
+     */
+    filterComputedColumns(columns: string[]): string[];
+    /**
+     * @description Strips computed (virtual) columns from a data object.
+     * Used before building AST nodes so computed columns never appear in
+     * generated SQL (neither in execution nor in `toSql()` / `unWrap()` previews).
+     * @internal
+     */
+    stripComputedFromData<T extends Record<string, any>>(data: T): T;
     /**
      * @description Formats a column WITHOUT table qualification.
      * ON CONFLICT target lists (Postgres/SQLite) and `excluded.<col>` refs require
@@ -2942,12 +2969,13 @@ type StreamOptions = {
     /** Mysql only */
     objectMode?: boolean;
 };
+type CursorValue = string | number;
 type Cursor<T extends Model, K extends ModelKey<T>> = {
-    key: K;
-    value: string | number;
+    key: K | K[];
+    value: CursorValue | CursorValue[];
 };
 type PaginateWithCursorOptions<T extends Model, K extends ModelKey<T>> = {
-    discriminator: K;
+    discriminator: K | K[];
     operator?: "<" | ">";
     orderBy?: "asc" | "desc";
 };
@@ -3307,6 +3335,15 @@ type ColumnOptions = {
      * @migration Only affects auto-generated migrations
      */
     zerofill?: boolean;
+    /**
+     * @description Marks the column as a computed (virtual) column. The value is
+     * computed by the database at query time from this raw SQL expression instead
+     * of being stored as a physical column.
+     * @description Computed columns are excluded from migrations and never written
+     * on insert/update. They only appear in results when explicitly selected.
+     * @internal Set via `col.computed()` / `@column.computed()`.
+     */
+    expression?: string;
 } & 
 /**
  * @description The data type of the column
@@ -3338,6 +3375,12 @@ type ColumnType = {
         default?: string | number | null | boolean;
     };
     validate?: Validator | Validator[];
+    /**
+     * @description Raw SQL expression for computed (virtual) columns set via
+     * `col.computed()` / `@column.computed()`. The value is computed by the
+     * database at query time and is not a physical column.
+     */
+    expression?: string;
 };
 type IndexType = {
     columns: string[];
@@ -3766,6 +3809,17 @@ declare class SelectQueryBuilder<T extends Model, S extends Record<string, any>
      * @description Clears the SELECT clause
      */
     clearSelect(): this;
+    /**
+     * @description Resolves a column reference to a computed column definition, if any.
+     * @description Strips an optional table prefix, looks the column up in the model's
+     * column metadata, and returns its raw SQL expression plus the database-convention
+     * alias to use in the SELECT clause. Returns `undefined` for non-computed columns.
+     * @internal
+     */
+    protected resolveComputedColumn(column: string): {
+        expression: string;
+        alias: string;
+    } | undefined;
     /**
      * @description Clears the FROM clause
      */
@@ -4463,7 +4517,7 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
      * @description Allows to avoid offset clause that can be inefficient for large datasets
      * @description If using a model query builder, primary key is used as discriminator by default
      * @param options - The options for the paginate with cursor
-     * @param options.discriminator - The discriminator to use for the paginate with Cursor pagination
+     * @param options.discriminator - The discriminator (or array of discriminators) to use for the paginate with Cursor pagination. Passing an array enables composite cursor pagination across multiple columns.
      * @param options.operator - The operator to use for the paginate with Cursor pagination
      * @param options.orderBy - The order by to use for the paginate with Cursor pagination
      * @param cursor - The cursor to use for the paginate with Cursor pagination
@@ -6826,6 +6880,24 @@ interface ColumnDef<T = unknown> {
 interface PrimaryColumnDef<T = unknown> extends ColumnDef<T> {
     readonly _isPrimary: true;
 }
+/**
+ * A column descriptor for a computed (virtual) column defined with
+ * `col.computed()` / `@column.computed()`.
+ *
+ * The value is computed by the database at query time from a raw SQL expression.
+ * Computed columns:
+ * - are excluded from auto-generated migrations (they carry no `type`)
+ * - are never written on insert/update
+ * - only appear in query results when explicitly selected
+ * - resolve to the raw expression when referenced in WHERE/ORDER BY/GROUP BY/HAVING
+ *
+ * `T` carries the TypeScript type the column resolves to when selected.
+ * Inferred instance types treat computed columns as `T | undefined` since they
+ * are absent from results unless explicitly selected.
+ */
+interface ComputedColumnDef<T = unknown> extends ColumnDef<T> {
+    readonly __computed: true;
+}
 /**
  * Phantom-typed descriptor for a model relation.
  * `T` carries the TypeScript type the relation resolves to at the instance level.
@@ -6896,6 +6968,13 @@ type ColMediumIntOptions = Omit<ColumnOptions, "type" | "serialize" | "prepare"
     unsigned?: boolean;
     zerofill?: boolean;
 };
+type ColComputedOptions = Omit<ColumnOptions, "type" | "primaryKey" | "serialize" | "prepare" | "default" | "autoUpdate"> & {
+    /**
+     * Optional callback applied to the value returned from the database before
+     * it is placed on the model instance.
+     */
+    serialize?: (value: any) => any;
+};
 type RelationConstraintOptions = {
     /**
      * Useful for auto generated migrations to specify the on delete action, it does not affect the code wise implementation
@@ -7243,6 +7322,47 @@ interface ColNamespace {
          */
         asymmetric<O extends ColAsymmetricOptions = ColAsymmetricOptions>(options: O): ColumnDef<NullableColumn<string, O>>;
     };
+    /**
+     * Computed (virtual) column. The value is computed by the database at query
+     * time from the given raw SQL expression instead of being stored as a
+     * physical column (and instead of being computed in TypeScript). Because the
+     * expression is pushed down into the generated SQL, the computation is done
+     * by the database engine — efficient for filtering, sorting and aggregation
+     * directly on the server.
+     *
+     * @param expression The raw SQL expression evaluated by the database at
+     *   query time. It references physical columns as they exist in the database
+     *   (no case conversion is applied), so it must be written in the database's
+     *   own dialect, e.g. `"concat(first_name, last_name)"` or
+     *   `"price * quantity"`.
+     * @param options Optional column options (e.g. `databaseName` for a custom
+     *   result alias, or `serialize` to transform the returned value).
+     *
+     * Computed columns:
+     * - are excluded from auto-generated migrations
+     * - are never written on insert/update
+     * - only appear in results when explicitly selected (`.select(User.fullName)`
+     *   or `[User.fullName, "alias"]` tuples)
+     * - resolve to the raw expression when referenced in WHERE / ORDER BY /
+     *   GROUP BY / HAVING
+     *
+     * ```ts
+     * const User = defineModel("users", {
+     *   columns: {
+     *     id: col.increment(),
+     *     firstName: col.string(),
+     *     lastName: col.string(),
+     *     fullName: col.computed<string>("concat(first_name, last_name)"),
+     *   },
+     * });
+     *
+     * // Selected explicitly - result has fullName: string (computed by the DB)
+     * const user = await sql.from(User).select(User.fullName).one();
+     * // Not selected - fullName is absent from the result
+     * const user = await sql.from(User).one();
+     * ```
+     */
+    computed<T = unknown>(expression: string, options?: ColComputedOptions): ComputedColumnDef<T>;
 }
 type IndexDefinition<K extends string = string> = K[] | {
     columns: K[];
@@ -7282,7 +7402,7 @@ type InferPK<C extends Record<string, ColumnDef>> = [
     ExtractPKType<C>
 ] extends [never] ? string | number : ExtractPKType<C>;
 type InferColumns<C extends Record<string, ColumnDef>> = {
-    [K in keyof C]: C[K] extends ColumnDef<infer T> ? T : never;
+    [K in keyof C]: C[K] extends ComputedColumnDef<infer T> ? T | undefined : C[K] extends ColumnDef<infer T> ? T : never;
 };
 type InferRelations<R extends Record<string, RelationDef>> = {
     [K in keyof R]: R[K] extends RelationDef<infer V> ? V : never;
@@ -8499,4 +8619,4 @@ type BetterAuthAdapterConfig = Partial<Pick<AdapterFactoryConfig, "usePlural" |
  */
 declare function betterAuthAdapter(sql: SqlDataSource, config?: BetterAuthAdapterConfig): (options: BetterAuthOptions) => DBAdapter;
 
-export { type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnyModelConstructor, type AtomicOptions, type BaseModelMethodOptions, BaseSeeder, type BetterAuthAdapterConfig, 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, type HysteriaErrorCode, 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 MigrationLockConfig, 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, atomic, betterAuthAdapter, 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 };
+export { type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnyModelConstructor, type AtomicOptions, type BaseModelMethodOptions, BaseSeeder, type BetterAuthAdapterConfig, type BuildSelectType, type BuildSingleSelectType, type CacheAdapter, type CacheKeys, ClientMigrator, type ColCharOptions, type ColComputedOptions, type ColJsonbOptions, type ColMediumIntOptions, type ColSmallIntOptions, type ColTinyIntOptions, type ColVarbinaryOptions, Collection, type CollectionDefinition, type ColumnDef, type CommonDataSourceInput, type ComposeBuildSelect, type ComposeSelect, type ComputedColumnDef, type ConnectionPolicies, type CreateSchemaResult, type CustomLogger, type DataSourceInput, type DataSourceType, type DateAutoHook, type DefinedCollection, type DefinedModel, type DefinedView, type ExcludeMethods, type ExtractColumnName, type ExtractSourceColumn, type FetchHooks, type FindReturnType, type GetColumnType, type GetConnectionReturnType, HysteriaError, type HysteriaErrorCode, 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 MigrationLockConfig, 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, atomic, betterAuthAdapter, 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 };