pqb 0.67.3 → 0.67.5

package/dist/index.d.ts

@@ -2742,7 +2742,7 @@ type SelectArgs<T extends SelectSelf> = ('*' | keyof T['__selectable'])[];
 interface SubQueryAddition<T extends PickQueryWithData> extends IsSubQuery {
   withData: T['withData'];
 }
-type SelectAsFnArg<T extends PickQueryRelationsWithData> = EmptyObject extends T['relations'] ? T : { [K in keyof T['relations'] | keyof T]: K extends keyof T['relations'] ? T['relations'][K]['maybeSingle'] & SubQueryAddition<T> : K extends keyof T ? T[K] : never };
+type SelectAsFnArg<T extends PickQueryRelationsWithData> = EmptyObject extends T['relations'] ? T : { [K in keyof T['relations'] | keyof T]: K extends keyof T['relations'] ? RelationQueryMaybeSingle<T['relations'][K]> & SubQueryAddition<T> : K extends keyof T ? T[K] : never };
 interface SelectAsArg<T extends SelectSelf> {
   [K: string]: keyof T['__selectable'] | Expression | ((q: SelectAsFnArg<T>) => unknown);
 }
@@ -4822,6 +4822,7 @@ interface QueryInternal<SinglePrimaryKey = any, UniqueColumns = any, UniqueColum
   noPrimaryKey: boolean;
   comment?: string;
   readOnly?: boolean;
+  materialized?: boolean;
   primaryKeys?: string[];
   singlePrimaryKey: SinglePrimaryKey;
   uniqueColumns: UniqueColumns;
@@ -4835,6 +4836,14 @@ interface QueryInternal<SinglePrimaryKey = any, UniqueColumns = any, UniqueColum
   rls?: Rls.Options;
   tableRls?: Rls.TableConfig;
   tableGrants?: Grant.TableClassGrant[];
+  viewData?: {
+    sql?: string | RawSqlBase;
+    recursive?: boolean;
+    checkOption?: 'LOCAL' | 'CASCADED';
+    securityBarrier?: boolean;
+    securityInvoker?: boolean;
+    withData?: boolean;
+  };
   managedRolesSql?: string;
   defaultGrantedBy?: string;
   grants?: Grant.InternalPrivilege[];
@@ -4915,6 +4924,10 @@ interface DbTableOptions<ColumnTypes, Table extends string | undefined, Shape ex
    * Disallow runtime create, update, and delete operations.
    */
   readOnly?: true | undefined;
+  /**
+   * Mark query objects as backed by a materialized relation.
+   */
+  materialized?: true | undefined;
   /**
    * Computed SQL or JS columns definitions
    */
@@ -4928,7 +4941,7 @@ type DbTableOptionScopes<Table extends string | undefined, Shape extends Column.
 interface QueryBuilder extends Query.NotReadOnlyQuery {
   returnType: undefined;
 }
-declare class Db<Table extends string | undefined = undefined, Shape extends Column.QueryColumnsInit = Column.QueryColumnsInit, PrimaryKeys = never, UniqueColumns = never, UniqueColumnTuples = never, UniqueConstraints = never, ColumnTypes = DefaultColumnTypes<ColumnSchemaConfig>, ShapeWithComputed extends Column.QueryColumnsInit = Shape, Scopes extends RecordUnknown | undefined = EmptyObject, DefaultSelect extends keyof Shape = keyof Shape, ReadOnly extends true | undefined = undefined> extends QueryMethods<ColumnTypes> implements Query {
+declare class Db<Table extends string | undefined = undefined, Shape extends Column.QueryColumnsInit = Column.QueryColumnsInit, PrimaryKeys = never, UniqueColumns = never, UniqueColumnTuples = never, UniqueConstraints = never, ColumnTypes = DefaultColumnTypes<ColumnSchemaConfig>, ShapeWithComputed extends Column.QueryColumnsInit = Shape, Scopes extends RecordUnknown | undefined = EmptyObject, DefaultSelect extends keyof Shape = keyof Shape, ReadOnly extends true | undefined = undefined, Materialized extends true | undefined = undefined> extends QueryMethods<ColumnTypes> implements Query {
   adapterNotInTransaction: Adapter;
   qb: QueryBuilder;
   table: Table;
@@ -4937,7 +4950,8 @@ declare class Db<Table extends string | undefined = undefined, Shape extends Col
   __isQuery: true;
   __as: Table & string;
   __selectable: SelectableFromShape<ShapeWithComputed, Table>;
-  readOnly: ReadOnly;
+  __readOnly: ReadOnly;
+  __materialized: Materialized;
   __hasSelect: boolean;
   __hasWhere: boolean;
   __defaults: { [K in { [K in keyof Shape]: unknown extends Shape[K]['data']['default'] ? never : K }[keyof Shape]]: true };
@@ -4958,7 +4972,7 @@ declare class Db<Table extends string | undefined = undefined, Shape extends Col
   internal: QueryInternal<{ [K in keyof PrimaryKeys]: (keyof PrimaryKeys extends K ? never : keyof PrimaryKeys) extends never ? PrimaryKeys[K] : never }[keyof PrimaryKeys], PrimaryKeys | UniqueColumns, { [K in keyof Shape]: Shape[K]['data']['unique'] extends string ? K : never }[keyof Shape] | keyof PrimaryKeys, UniqueColumnTuples, UniqueConstraints>;
   catch: QueryCatch;
   shape: ShapeWithComputed;
-  constructor(adapterNotInTransaction: Adapter, qb: QueryBuilder, table: Table | undefined, shape: ShapeWithComputed, columnTypes: ColumnTypes, asyncStorage: AsyncLocalStorage<AsyncState>, options: DbTableOptions<ColumnTypes, Table, ShapeWithComputed>, tableData?: TableData);
+  constructor(adapterNotInTransaction: Adapter, qb: QueryBuilder, table: Table | undefined, shape: ShapeWithComputed, columnTypes: ColumnTypes, asyncStorage: AsyncLocalStorage<AsyncState>, options: DbTableOptions<ColumnTypes, Table, ShapeWithComputed>, tableData?: TableData, viewData?: QueryInternal['viewData']);
   /**
    * When in transaction, returns a db adapter object for the transaction,
    * returns a default adapter object otherwise.
@@ -5027,7 +5041,7 @@ declare class Db<Table extends string | undefined = undefined, Shape extends Col
   queryArrays<R extends any[] = any[]>(...args: SQLQueryArgs): Promise<QueryResult<R>>;
 }
 interface DbTableConstructor<ColumnTypes> {
-  <Table extends string, Shape extends Column.QueryColumnsInit, Data extends MaybeArray<TableDataItem>, Options extends DbTableOptions<ColumnTypes, Table, Shape>>(table: Table, shape?: ((t: ColumnTypes) => Shape) | Shape, tableData?: TableDataFn<Shape, Data>, options?: Options): Db<Table, Shape, keyof ShapeColumnPrimaryKeys<Shape> extends never ? never : ShapeColumnPrimaryKeys<Shape>, ShapeUniqueColumns<Shape> | TableDataItemsUniqueColumns<Shape, Data>, TableDataItemsUniqueColumnTuples<Shape, Data>, UniqueConstraints<Shape> | TableDataItemsUniqueConstraints<Data>, ColumnTypes, Shape & ComputedColumnsFromOptions<Options['computed']>, MapTableScopesOption<Options>, ColumnsShape.DefaultSelectKeys<Shape>, Options['readOnly'] extends true ? true : undefined>;
+  <Table extends string, Shape extends Column.QueryColumnsInit, Data extends MaybeArray<TableDataItem>, Options extends DbTableOptions<ColumnTypes, Table, Shape>>(table: Table, shape?: ((t: ColumnTypes) => Shape) | Shape, tableData?: TableDataFn<Shape, Data>, options?: Options): Db<Table, Shape, keyof ShapeColumnPrimaryKeys<Shape> extends never ? never : ShapeColumnPrimaryKeys<Shape>, ShapeUniqueColumns<Shape> | TableDataItemsUniqueColumns<Shape, Data>, TableDataItemsUniqueColumnTuples<Shape, Data>, UniqueConstraints<Shape> | TableDataItemsUniqueConstraints<Data>, ColumnTypes, Shape & ComputedColumnsFromOptions<Options['computed']>, MapTableScopesOption<Options>, ColumnsShape.DefaultSelectKeys<Shape>, Options['readOnly'] extends true ? true : undefined, Options['materialized'] extends true ? true : undefined>;
 }
 interface DbSqlMethod<ColumnTypes> {
   <T>(...args: StaticSQLArgs): RawSql<Column.Pick.QueryColumnOfType<T>, ColumnTypes>;
@@ -6255,6 +6269,14 @@ declare abstract class QueryHooks {
    */
   catchAfterCommitError<T>(this: T, fn: AfterCommitErrorHandler): T;
 }
+interface ColumnDataSelectSqlProp {
+  selectSql?: Expression;
+  selectSqlFn?: SelectSqlCallback;
+}
+interface SelectSqlCallback {
+  (column: ColumnRefExpression<Column.Pick.QueryColumn>): Expression;
+}
+type SelectSqlColumn<T extends Column.Pick.DataAndDataType, Expr extends Expression> = unknown extends Expr['result']['value']['outputType'] ? T : { [K in keyof T]: K extends 'outputType' ? Expr['result']['value']['outputType'] : T[K] };
 declare namespace Column {
   export namespace Modifiers {
     export interface IsPrimaryKey<Name extends string> {
@@ -6895,6 +6917,13 @@ declare abstract class Column<Schema extends ColumnTypeSchemaArg = ColumnTypeSch
    * ```
    */
   select<T extends Column.Pick.Data, Value extends boolean>(this: T, value: Value): Column.Modifiers.DefaultSelect<T, Value>;
+  /**
+   * Set SQL to use when selecting this column.
+   *
+   * The column remains a regular writable database column. Create, update,
+   * filters, ordering, grouping, and migrations still use the physical column.
+   */
+  selectSql<T extends Column.Pick.DataAndDataType, Expr extends Expression>(this: T, fn: (column: ColumnRefExpression<T & Column.Pick.QueryColumn>) => Expr): SelectSqlColumn<T, Expr>;
   /**
    * Forbid the column to be used in [create](/guide/create-update-delete.html#create-insert) and [update](/guide/create-update-delete.html#update) methods.
    *
@@ -7496,8 +7525,8 @@ type CreateData<T extends CreateSelf> = EmptyObject extends T['relations'] ? Cre
 type CreateDataWithDefaults<T extends CreateSelf, Defaults extends PropertyKey> = { [K in keyof T['inputType'] as K extends Defaults ? never : K]: K extends Defaults ? never : CreateColumn<T, K> } & { [K in Defaults]?: K extends keyof T['inputType'] ? CreateColumn<T, K> : never };
 type CreateDataWithDefaultsForRelations<T extends CreateSelf, Defaults extends keyof T['inputType'], OmitFKeys extends PropertyKey> = { [K in keyof T['inputType'] as K extends Defaults | OmitFKeys ? never : K]: K extends Defaults | OmitFKeys ? never : CreateColumn<T, K> } & { [K in Defaults as K extends OmitFKeys ? never : K]?: CreateColumn<T, K> };
 type CreateColumn<T extends CreateSelf, K extends keyof T['inputType']> = T['inputType'][K] | ((q: T) => QueryOrExpression<T['inputType'][K]>);
-type CreateRelationsData<T extends CreateSelf> = CreateDataWithDefaultsForRelations<T, keyof T['__defaults'], T['relations'][keyof T['relations']]['omitForeignKeyInCreate']> & CreateRelationsDataOmittingFKeys<T, T['relations'][keyof T['relations']]['dataForCreate']> & T['relations'][keyof T['relations']]['optionalDataForCreate'];
-type CreateRelationsDataOmittingFKeys<T extends CreateSelf, Union> = (Union extends RelationConfigDataForCreate ? (u: Union['columns'] extends keyof T['__defaults'] ? { [P in Exclude<Union['columns'] & keyof T['inputType'], keyof T['__defaults']>]: CreateColumn<T, P> } & { [P in keyof T['__defaults'] & Union['columns']]?: CreateColumn<T, P> } & Partial<Union['nested']> : { [P in Union['columns'] & keyof T['inputType']]: CreateColumn<T, P> } | Union['nested']) => void : never) extends ((u: infer Obj) => void) ? Obj : never;
+type CreateRelationsData<T extends CreateSelf> = CreateDataWithDefaultsForRelations<T, keyof T['__defaults'], T['relations'][keyof T['relations']]['omitForeignKeyInCreate']> & CreateRelationsDataOmittingFKeys<T, T['relations'][keyof T['relations']]['dataForCreate']>;
+type CreateRelationsDataOmittingFKeys<T extends CreateSelf, Union> = (Union extends RelationConfigDataForCreate ? (u: Union['columns'] extends keyof T['__defaults'] ? Pick<CreateDataWithDefaults<T, keyof T['__defaults']>, Union['columns']> & Partial<Union['nested']> : (Pick<{ [P in keyof T['inputType']]: CreateColumn<T, P> }, Union['columns'] & keyof T['inputType']> & { [K in keyof Union['nested']]?: never }) | Union['nested']) => void : (u: Union) => void) extends ((u: infer Obj) => void) ? Obj : never;
 type CreateResult<T extends CreateSelf, Data> = T extends {
   isCount: true;
 } ? T : T['returnType'] extends undefined | 'all' ? SetQueryReturnsOneResult<T, NarrowCreateResult<T, Data>> : T['returnType'] extends 'pluck' ? SetQueryReturnsColumnResult<T, NarrowCreateResult<T, Data>> : SetQueryResult<T, NarrowCreateResult<T, Data>>;
@@ -8369,7 +8398,7 @@ declare const setColumnParse: (column: Column.Pick.Data, fn: (input: any) => unk
 declare const setColumnParseNull: (column: Column.Pick.Data, fn: () => unknown, nullSchema?: unknown) => any;
 declare const setColumnEncode: (column: Column.Pick.Data, fn: (input: any) => unknown, inputSchema?: unknown) => any;
 declare const getColumnBaseType: (column: Column.Pick.Data, domainsMap: DbStructureDomainsMap, type: string) => string;
-interface ColumnDataComputedProp {
+interface ColumnDataComputedProp extends ColumnDataSelectSqlProp {
   computed?: Expression;
 }
 type ComputedColumnsFromOptions<T extends ComputedOptionsFactory<never, never> | undefined> = T extends ((...args: any[]) => infer R extends ComputedOptionsConfig) ? { [K in keyof R]: R[K] extends QueryOrExpression<unknown> ? R[K]['result']['value'] : R[K] extends (() => {
@@ -8590,6 +8619,10 @@ type QueryType = undefined | null | 'upsert' | 'insert' | 'update' | 'delete';
 interface AsFn {
   (as: string): void;
 }
+interface SelectAllColumnExpression {
+  (ctx: ToSQLCtx, quotedAs?: string): string;
+}
+type SelectAllColumn = string | SelectAllColumnExpression;
 interface QueryData extends QueryDataAliases, PickQueryDataParsers, HasHookSelect, MutativeQueriesSelectRelationsQueryData {
   type: QueryType;
   adapter: Adapter;
@@ -8625,7 +8658,7 @@ interface QueryData extends QueryDataAliases, PickQueryDataParsers, HasHookSelec
     sql: string;
     aliases: string[];
   };
-  selectAllColumns?: string[];
+  selectAllColumns?: SelectAllColumn[];
   /**
    * Subset of the `shape` that only includes columns with no `data.explicitSelect`.
    */
@@ -10212,8 +10245,8 @@ declare class QueryMethods<ColumnTypes> {
   if<T extends PickQueryResultReturnType, R extends PickQueryResult>(this: T, condition: boolean | null | undefined, fn: (q: T) => R & {
     returnType: T['returnType'];
   }): QueryIfResult<T, R>;
-  queryRelated<T extends PickQueryRelations, RelName extends keyof T['relations']>(this: T, relName: RelName, params: T['relations'][RelName]['params']): T['relations'][RelName]['maybeSingle'];
-  chain<T extends PickQuerySelectableShapeRelationsReturnTypeIsSubQuery, RelName extends keyof T['relations']>(this: T, relName: RelName): T['__subQuery'] extends true | undefined ? [T['returnType'], T['relations'][RelName]['returnsOne']] extends ['one' | 'oneOrThrow', true] ? { [K in keyof T['relations'][RelName]['maybeSingle']]: K extends '__selectable' ? T['relations'][RelName]['maybeSingle']['__selectable'] & Omit<T['__selectable'], keyof T['shape']> : T['relations'][RelName]['maybeSingle'][K] } & IsSubQuery : JoinResultRequireMain<T['relations'][RelName]['query'], Omit<T['__selectable'], keyof T['shape']>> : T['relations'][RelName]['query'];
+  queryRelated<T extends PickQueryRelations, RelName extends keyof T['relations']>(this: T, relName: RelName, params: T['relations'][RelName]['params']): RelationQueryMaybeSingle<T['relations'][RelName]>;
+  chain<T extends PickQuerySelectableShapeRelationsReturnTypeIsSubQuery, RelName extends keyof T['relations']>(this: T, relName: RelName): T['__subQuery'] extends true | undefined ? [T['returnType'], T['relations'][RelName]['returnsOne']] extends ['one' | 'oneOrThrow', true] ? { [K in keyof RelationQueryMaybeSingle<T['relations'][RelName]>]: K extends '__selectable' ? RelationQueryMaybeSingle<T['relations'][RelName]>['__selectable'] & Omit<T['__selectable'], keyof T['shape']> : RelationQueryMaybeSingle<T['relations'][RelName]>[K] } & IsSubQuery : JoinResultRequireMain<T['relations'][RelName]['query'], Omit<T['__selectable'], keyof T['shape']>> : T['relations'][RelName]['query'];
 }
 interface DbExtension {
   name: string;
@@ -10225,6 +10258,8 @@ interface GeneratorIgnore {
   domains?: string[];
   extensions?: string[];
   tables?: string[];
+  /** Regular views to ignore during migration generation. */
+  views?: (string | RegExp)[];
   grants?: Grant.Ignore;
 }
 interface DbDomainArg<ColumnTypes> {
@@ -10288,11 +10323,15 @@ interface Query extends IsQuery, PickQueryTable, PickQueryShape, PickQuerySelect
   relations: RelationsBase;
   relationQueries: IsQueries;
   error: new (message: string, length: number, name: QueryErrorName) => QueryError;
-  readOnly: true | undefined;
+  __readOnly: true | undefined;
+  __materialized: true | undefined;
 }
 declare namespace Query {
   interface NotReadOnlyQuery extends Query {
-    readOnly: undefined;
+    __readOnly: undefined;
+  }
+  interface MaterializedQuery extends Query {
+    __materialized: true;
   }
   namespace Order {
     type Arg<T extends Order.ArgThis> = Order.Arg<T>;
@@ -10306,7 +10345,10 @@ declare namespace Query {
       returnType: 'value' | 'valueOrThrow';
     }
     interface IsNotReadOnly {
-      readOnly: undefined;
+      __readOnly: undefined;
+    }
+    interface IsMaterialized {
+      __materialized: true;
     }
   }
 }
@@ -10367,19 +10409,18 @@ declare const isQueryReturnsAll: (q: Query) => boolean;
 interface RelationJoinQuery {
   (joiningQuery: IsQuery, baseQuery: IsQuery): IsQuery;
 }
-interface RelationConfigQuery extends PickQueryResult, PickQuerySelectable, PickQueryShape, PickQueryTable, PickQueryAs, PickQueryRelations {}
+interface RelationConfigQuery extends PickQueryResult, PickQuerySelectable, PickQueryShape, PickQueryTable, PickQueryAs, PickQueryRelations, PickQueryReturnType {}
 interface RelationConfigBase extends IsQuery {
   returnsOne: boolean;
+  required?: unknown;
   query: RelationConfigQuery;
   joinQuery: RelationJoinQuery;
   reverseJoin: RelationJoinQuery;
   params: unknown;
   queryRelated(params: unknown): unknown;
   modifyRelatedQuery?(relatedQuery: IsQuery): (query: IsQuery) => void;
-  maybeSingle: PickQuerySelectableReturnType;
   omitForeignKeyInCreate: PropertyKey;
-  dataForCreate: RelationConfigDataForCreate | undefined;
-  optionalDataForCreate: unknown;
+  dataForCreate: unknown;
   dataForUpdate: unknown;
   dataForUpdateOne: unknown;
   primaryKeys: string[];
@@ -10391,6 +10432,7 @@ interface RelationConfigDataForCreate {
 interface RelationsBase {
   [K: string]: RelationConfigBase;
 }
+type RelationQueryMaybeSingle<T extends RelationConfigBase> = T['returnsOne'] extends true ? T['required'] extends true ? QueryManyTake<T['query']> : QueryManyTakeOptional<T['query']> : T['query'];
 interface PickQueryTable {
   table?: string;
 }
@@ -10438,7 +10480,6 @@ interface PickQuerySelectableResultRelationsWithDataReturnTypeShapeAs extends Pi
 interface PickQuerySelectableShape extends PickQuerySelectable, PickQueryShape {}
 interface PickQuerySelectableColumnTypes extends PickQuerySelectable, PickQueryColumTypes {}
 interface PickQuerySelectableShapeRelationsReturnTypeIsSubQuery extends PickQueryIsSubQuery, PickQuerySelectable, PickQueryShape, PickQueryRelations, PickQueryReturnType {}
-interface PickQuerySelectableReturnType extends PickQuerySelectable, PickQueryReturnType {}
 interface PickQuerySelectableResultInputTypeAs extends PickQuerySelectableResult, PickQueryInputType, PickQueryAs {}
 interface PickQuerySelectableResultAs extends PickQuerySelectable, PickQueryResult, PickQueryAs {}
 interface PickQueryIsSubQuery {
@@ -10542,6 +10583,20 @@ declare abstract class QueryAsMethods {
 }
 declare const _appendQuery: (main: Query, append: Query, asFn: (as: string) => void) => Query;
 declare const _appendQueryOnUpsertCreate: (main: Query, append: Query, asFn: (as: string) => void) => Query;
+interface RefreshMaterializedViewOptions {
+  /**
+   * Refresh the materialized view without blocking concurrent selects.
+   */
+  concurrently?: boolean;
+  /**
+   * Use `WITH DATA` or `WITH NO DATA` for the refreshed materialized view.
+   */
+  withData?: boolean;
+}
+/**
+ * Refresh a materialized view.
+ */
+declare const refreshMaterializedView: <T extends Query.MaterializedQuery>(query: T, options?: RefreshMaterializedViewOptions) => Promise<void>;
 declare const getPrimaryKeys: (q: Query) => string[];
 /**
  * Set value into the object in query data, create the object if it doesn't yet exist.
@@ -10697,4 +10752,4 @@ declare const testTransaction: {
    */
   close(arg: Arg$1): Promise<void>;
 };
-export { type Adapter, AdapterClass, type AdapterConfigBase, type AdapterParams, type AdapterSchemaConfigOptions, type AfterCommitStandaloneHook, type AfterHook, ArrayColumn, type ArrayColumnValue, type ArrayData, type AsyncState, type BaseNumberData, BigIntColumn, BigSerialColumn, BitColumn, BitVaryingColumn, BooleanColumn, BoxColumn, ByteaColumn, CidrColumn, CircleColumn, CitextColumn, type Code, type Codes, Column, type ColumnFromDbParams, type ColumnSchemaConfig, type ColumnSchemaGetterColumns, type ColumnSchemaGetterTableClass, type ColumnToCodeCtx, type ColumnTypeSchemaArg, type ColumnsByType, type ColumnsShape, type ComputedColumnsFromOptions, type ComputedOptionsConfig, type ComputedOptionsFactory, type CreateCtx, type CreateData, type CreateManyMethodsNames, type CreateMethodsNames, type CreateSelf, CustomTypeColumn, DateBaseColumn, DateColumn, type DateColumnData, DateTimeBaseClass, DateTimeTzBaseClass, Db, type DbDomainArg, type DbExtension, type DbOptions, type DbResult, type DbSharedOptions, type DbSqlMethod, type DbStructureDomainsMap, type DbTableOptionScopes, type DbTableOptions, DecimalColumn, type DecimalColumnData, type DefaultColumnTypes, type DefaultPrivileges, type DefaultSchemaConfig, type DeleteMethodsNames, DomainColumn, DoublePrecisionColumn, type DriverAdapter, DynamicRawSQL, type EmptyObject, type EmptyTuple, EnumColumn, Expression, type FromArg, type FromResult, type GeneratorIgnore, type Grant, type HookSelectValue, InetColumn, IntegerBaseColumn, IntegerColumn, IntervalColumn, type IsQuery, type IsolationLevel, JSONColumn, JSONTextColumn, type JoinQueryMethod, type JoinedShapes, LimitedTextBaseColumn, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, type MapTableScopesOption, type MaybeArray, type MaybePromise, type MergeQuery, MoneyColumn, type NoPrimaryKeyOption, type NonUniqDataItem, NotFoundError, NumberAsStringBaseColumn, NumberBaseColumn, type NumberColumnData, Operators, type OperatorsArray, type OperatorsJson, type OperatorsOrdinalText, OrchidOrmInternalError, type Ord, PathColumn, type PickQueryInputType, type PickQueryInternal, type PickQueryQ, type PickQueryRelations, type PickQuerySelectableRelations, type PickQueryShape, PointColumn, PolygonColumn, PostgisGeographyPointColumn, type Query, type QueryAfterHook, type QueryBeforeActionHook, type QueryBeforeHook, type QueryData, QueryError, type QueryHasWhere, type QueryHelperResult, QueryHookUtils, QueryHooks, type QueryInternal, type QueryLogObject, type QueryLogOptions, type QueryLogger, type QueryManyTake, type QueryManyTakeOptional, type QueryOrExpression, type QueryResult, type QueryResultRow, type QueryReturnType, type QuerySchema, type QueryScopes, RawSql, type RawSqlBase, RealColumn, type RecordKeyTrue, type RecordOptionalString, type RecordString, type RecordStringOrNumber, type RecordUnknown, type RelationConfigBase, type RelationJoinQuery, type RelationsBase, type Rls, type RlsPolicy, type SchemaConfigFnWithOptions, type SearchWeight, type SelectableFromShape, SerialColumn, type SerialColumnData, type ShallowSimplify, type ShapeColumnPrimaryKeys, type ShapeUniqueColumns, type SingleSql, type SingleSqlItem, SmallIntColumn, SmallSerialColumn, type Sql, type SqlFn, type SqlSessionState, type StorageOptions, StringColumn, type StringData, type TableData, type TableDataFn, type TableDataInput, type TableDataItem, type TableDataItemsUniqueColumnTuples, type TableDataItemsUniqueColumns, type TableDataItemsUniqueConstraints, type TableDataMethods, type TemplateLiteralArgs, TextBaseColumn, TextColumn, TimeColumn, TimestampColumn, TimestampTZColumn, type Timestamps, type TransactionAdapter, TransactionAdapterClass, type TransactionOptions, TsQueryColumn, TsVectorColumn, UUIDColumn, type UniqueConstraints, type UniqueTableDataItem, UnknownColumn, type UpdateData, type UpsertData, type UpsertThis, VarCharColumn, VirtualColumn, type WhereArg, XMLColumn, _appendQuery, _appendQueryOnUpsertCreate, _clone, _createDbSqlMethod, _hookSelectColumns, _initQueryBuilder, _orCreate, _prependWith, _queryCreate, _queryCreateMany, _queryCreateManyFrom, _queryDefaults, _queryDelete, _queryFindBy, _queryFindByOptional, _queryHookAfterCreate, _queryHookAfterUpdate, _queryInsert, _queryInsertMany, _queryJoinOn, _queryRows, _querySelect, _queryTake, _queryTakeOptional, _queryUpdate, _queryUpdateOrThrow, _queryUpsert, _queryWhere, _queryWhereExists, _queryWhereIn, addCode, addTopCte, addTopCteSql, applyMixins, assignDbDataToColumn, backtickQuote, cloneQueryBaseUnscoped, codeToString, colors, columnsShapeToCode, constraintInnerToCode, consumeColumnName, copyTableData, createDbWithAdapter, deepCompare, defaultSchemaConfig, emptyArray, emptyObject, escapeForMigration, escapeString, excludeInnerToCode, exhaustive, getCallerFilePath, getClonedQueryData, getColumnBaseType, getColumnInfo, getColumnTypes, getDateAsDateFn, getDateAsNumberFn, getDriverErrorCode, getFreeAlias, getFreeSetAlias, getImportPath, getPrimaryKeys, getQueryAs, getQuerySchema, getShapeFromSelect, getSqlText, getStackTrace, getSupportedDefaultPrivileges, indexInnerToCode, internalSchemaConfig, isExpression, isQueryReturnsAll, isRawSQL, logColors, logParamToLogObject, makeColumnNullable, makeColumnTypes, makeColumnsByType, makeConnectRetryConfig, noop, objectHasValues, omit, parseTableData, parseTableDataInput, pathToLog, pick, pluralize, prepareSubQueryForSql, primaryKeyInnerToCode, pushQueryOnForOuter, pushQueryValueImmutable, pushTableDataCode, quoteIdentifier, quoteObjectKey, quoteTableWithSchema, raw, rawSqlToCode, referencesArgsToCode, returnArg, setColumnData, setColumnEncode, setColumnParse, setColumnParseNull, setCurrentColumnName, setDataValue, setDefaultLanguage, setFreeAlias, setQueryObjectValueImmutable, singleQuote, tableDataMethods, testTransaction, toArray, toCamelCase, toPascalCase, toSnakeCase, wrapAdapterFnWithConnectRetry };
+export { type Adapter, AdapterClass, type AdapterConfigBase, type AdapterParams, type AdapterSchemaConfigOptions, type AfterCommitStandaloneHook, type AfterHook, ArrayColumn, type ArrayColumnValue, type ArrayData, type AsyncState, type BaseNumberData, BigIntColumn, BigSerialColumn, BitColumn, BitVaryingColumn, BooleanColumn, BoxColumn, ByteaColumn, CidrColumn, CircleColumn, CitextColumn, type Code, type Codes, Column, type ColumnFromDbParams, type ColumnSchemaConfig, type ColumnSchemaGetterColumns, type ColumnSchemaGetterTableClass, type ColumnToCodeCtx, type ColumnTypeSchemaArg, type ColumnsByType, type ColumnsShape, type ComputedColumnsFromOptions, type ComputedOptionsConfig, type ComputedOptionsFactory, type CreateCtx, type CreateData, type CreateManyMethodsNames, type CreateMethodsNames, type CreateSelf, CustomTypeColumn, DateBaseColumn, DateColumn, type DateColumnData, DateTimeBaseClass, DateTimeTzBaseClass, Db, type DbDomainArg, type DbExtension, type DbOptions, type DbResult, type DbSharedOptions, type DbSqlMethod, type DbStructureDomainsMap, type DbTableOptionScopes, type DbTableOptions, DecimalColumn, type DecimalColumnData, type DefaultColumnTypes, type DefaultPrivileges, type DefaultSchemaConfig, type DeleteMethodsNames, DomainColumn, DoublePrecisionColumn, type DriverAdapter, DynamicRawSQL, type EmptyObject, type EmptyTuple, EnumColumn, Expression, type ExpressionData, type FromArg, type FromResult, type GeneratorIgnore, type Grant, type HookSelectValue, InetColumn, IntegerBaseColumn, IntegerColumn, IntervalColumn, type IsQuery, type IsolationLevel, JSONColumn, JSONTextColumn, type JoinQueryMethod, type JoinedShapes, LimitedTextBaseColumn, LineColumn, LsegColumn, MacAddr8Column, MacAddrColumn, type MapTableScopesOption, type MaybeArray, type MaybePromise, type MergeQuery, MoneyColumn, type NoPrimaryKeyOption, type NonUniqDataItem, NotFoundError, NumberAsStringBaseColumn, NumberBaseColumn, type NumberColumnData, Operators, type OperatorsArray, type OperatorsJson, type OperatorsOrdinalText, OrchidOrmInternalError, type Ord, PathColumn, type PickQueryInputType, type PickQueryInternal, type PickQueryQ, type PickQueryRelations, type PickQuerySelectableRelations, type PickQueryShape, PointColumn, PolygonColumn, PostgisGeographyPointColumn, type Query, type QueryAfterHook, type QueryBeforeActionHook, type QueryBeforeHook, type QueryData, QueryError, type QueryHasWhere, type QueryHelperResult, QueryHookUtils, QueryHooks, type QueryInternal, type QueryLogObject, type QueryLogOptions, type QueryLogger, type QueryManyTake, type QueryManyTakeOptional, type QueryOrExpression, type QueryResult, type QueryResultRow, type QueryReturnType, type QuerySchema, type QueryScopes, RawSql, type RawSqlBase, RealColumn, type RecordKeyTrue, type RecordOptionalString, type RecordString, type RecordStringOrNumber, type RecordUnknown, type RefreshMaterializedViewOptions, type RelationConfigBase, type RelationJoinQuery, type RelationsBase, type Rls, type RlsPolicy, type SchemaConfigFnWithOptions, type SearchWeight, type SelectableFromShape, SerialColumn, type SerialColumnData, type ShallowSimplify, type ShapeColumnPrimaryKeys, type ShapeUniqueColumns, type SingleSql, type SingleSqlItem, SmallIntColumn, SmallSerialColumn, type Sql, type SqlFn, type SqlSessionState, type StorageOptions, StringColumn, type StringData, type TableData, type TableDataFn, type TableDataInput, type TableDataItem, type TableDataItemsUniqueColumnTuples, type TableDataItemsUniqueColumns, type TableDataItemsUniqueConstraints, type TableDataMethods, type TemplateLiteralArgs, TextBaseColumn, TextColumn, TimeColumn, TimestampColumn, TimestampTZColumn, type Timestamps, type ToSQLCtx, type ToSqlValues, type TransactionAdapter, TransactionAdapterClass, type TransactionOptions, TsQueryColumn, TsVectorColumn, UUIDColumn, type UniqueConstraints, type UniqueTableDataItem, UnknownColumn, type UpdateData, type UpsertData, type UpsertThis, VarCharColumn, VirtualColumn, type WhereArg, XMLColumn, _appendQuery, _appendQueryOnUpsertCreate, _clone, _createDbSqlMethod, _hookSelectColumns, _initQueryBuilder, _orCreate, _prependWith, _queryCreate, _queryCreateMany, _queryCreateManyFrom, _queryDefaults, _queryDelete, _queryFindBy, _queryFindByOptional, _queryHookAfterCreate, _queryHookAfterUpdate, _queryInsert, _queryInsertMany, _queryJoinOn, _queryRows, _querySelect, _queryTake, _queryTakeOptional, _queryUpdate, _queryUpdateOrThrow, _queryUpsert, _queryWhere, _queryWhereExists, _queryWhereIn, addCode, addTopCte, addTopCteSql, applyMixins, assignDbDataToColumn, backtickQuote, cloneQueryBaseUnscoped, codeToString, colors, columnsShapeToCode, constraintInnerToCode, consumeColumnName, copyTableData, createDbWithAdapter, deepCompare, defaultSchemaConfig, emptyArray, emptyObject, escapeForMigration, escapeString, excludeInnerToCode, exhaustive, getCallerFilePath, getClonedQueryData, getColumnBaseType, getColumnInfo, getColumnTypes, getDateAsDateFn, getDateAsNumberFn, getDriverErrorCode, getFreeAlias, getFreeSetAlias, getImportPath, getPrimaryKeys, getQueryAs, getQuerySchema, getShapeFromSelect, getSqlText, getStackTrace, getSupportedDefaultPrivileges, indexInnerToCode, internalSchemaConfig, isExpression, isQueryReturnsAll, isRawSQL, logColors, logParamToLogObject, makeColumnNullable, makeColumnTypes, makeColumnsByType, makeConnectRetryConfig, noop, objectHasValues, omit, parseTableData, parseTableDataInput, pathToLog, pick, pluralize, prepareSubQueryForSql, primaryKeyInnerToCode, pushQueryOnForOuter, pushQueryValueImmutable, pushTableDataCode, quoteIdentifier, quoteObjectKey, quoteTableWithSchema, raw, rawSqlToCode, referencesArgsToCode, refreshMaterializedView, returnArg, setColumnData, setColumnEncode, setColumnParse, setColumnParseNull, setCurrentColumnName, setDataValue, setDefaultLanguage, setFreeAlias, setQueryObjectValueImmutable, singleQuote, tableDataMethods, testTransaction, toArray, toCamelCase, toPascalCase, toSnakeCase, wrapAdapterFnWithConnectRetry };

package/dist/index.js

@@ -771,6 +771,15 @@ var Column = class {
 		return setColumnData(this, "explicitSelect", !value);
 	}
 	/**
+	* Set SQL to use when selecting this column.
+	*
+	* The column remains a regular writable database column. Create, update,
+	* filters, ordering, grouping, and migrations still use the physical column.
+	*/
+	selectSql(fn) {
+		return setColumnData(this, "selectSqlFn", fn);
+	}
+	/**
 	* Forbid the column to be used in [create](/guide/create-update-delete.html#create-insert) and [update](/guide/create-update-delete.html#update) methods.
 	*
 	* `readOnly` column is still can be set from a [hook](http://localhost:5173/guide/hooks.html#set-values-before-create-or-update).
@@ -3992,6 +4001,7 @@ const applyComputedColumns = (q, fn) => {
 			q.shape[key] = col;
 			const { data } = col;
 			data.computed = item;
+			data.selectSql = item;
 			data.explicitSelect = true;
 			data.readOnly = true;
 			const parse = col._parse;
@@ -6527,6 +6537,15 @@ const columnToSql = (ctx, data, shape, column, quotedAs, select) => {
 	if (index !== -1) return columnWithDotToSql(ctx, data, shape, column, index, quotedAs, select);
 	return simpleColumnToSQL(ctx, column, shape[column], quotedAs);
 };
+const selectedColumnToSql = (ctx, data, shape, column, quotedAs) => {
+	const index = column.indexOf(".");
+	return index !== -1 ? selectedColumnWithDotToSql(ctx, data, shape, column, index, quotedAs) : selectedSimpleColumnToSql(ctx, column, shape[column], quotedAs);
+};
+const selectedSimpleColumnToSql = (ctx, key, column, quotedAs) => {
+	if (!column) return `"${key}"`;
+	const { data } = column;
+	return data.selectSql ? `(${data.selectSql.toSQL(ctx, quotedAs)})` : `${quotedAs ? `${quotedAs}.` : ""}"${data.name || key}"`;
+};
 /**
 * in a case when ordering or grouping by a column which was selected as expression:
 * ```ts
@@ -6552,7 +6571,7 @@ const columnWithDotToSql = (ctx, data, shape, column, index, quotedAs, select) =
 	const key = column.slice(index + 1);
 	if (key === "*") {
 		const shape = data.joinedShapes?.[table];
-		return shape ? select ? makeRowToJson(table, shape, true) : `"${table}".*` : column;
+		return shape ? select ? makeRowToJson(ctx, table, shape, true) : `"${table}".*` : column;
 	}
 	const tableName = _getQueryAliasOrName(data, table);
 	const quoted = `"${table}"`;
@@ -6564,6 +6583,22 @@ const columnWithDotToSql = (ctx, data, shape, column, index, quotedAs, select) =
 	}
 	return `"${tableName}"."${key}"`;
 };
+const selectedColumnWithDotToSql = (ctx, data, shape, column, index, quotedAs) => {
+	const table = column.slice(0, index);
+	const key = column.slice(index + 1);
+	if (key === "*") {
+		const shape = data.joinedShapes?.[table];
+		return shape ? makeRowToJson(ctx, table, shape, true) : column;
+	}
+	const tableName = _getQueryAliasOrName(data, table);
+	const quoted = `"${table}"`;
+	const col = quoted === quotedAs ? shape[key] : data.joinedShapes?.[tableName]?.[key];
+	if (col) {
+		if (col.data.selectSql) return `(${col.data.selectSql.toSQL(ctx, quoted)})`;
+		if (col.data.name) return `"${tableName}"."${col.data.name}"`;
+	}
+	return `"${tableName}"."${key}"`;
+};
 const columnToSqlWithAs = (ctx, data, column, as, quotedAs, select, jsonList) => {
 	const index = column.indexOf(".");
 	return index !== -1 ? tableColumnToSqlWithAs(ctx, data, column, column.slice(0, index), column.slice(index + 1), as, quotedAs, select, jsonList) : ownColumnToSqlWithAs(ctx, data, column, as, quotedAs, select, jsonList);
@@ -6573,7 +6608,7 @@ const tableColumnToSqlWithAs = (ctx, data, column, table, key, as, quotedAs, sel
 		if (jsonList) jsonList[as] = void 0;
 		const shape = data.joinedShapes?.[table];
 		if (shape) {
-			if (select) return makeRowToJson(table, shape, true) + ` "${as}"`;
+			if (select) return makeRowToJson(ctx, table, shape, true) + ` "${as}"`;
 			return `"${table}"."${table}" "${as}"`;
 		}
 		return column;
@@ -6581,10 +6616,10 @@ const tableColumnToSqlWithAs = (ctx, data, column, table, key, as, quotedAs, sel
 	const tableName = _getQueryAliasOrName(data, table);
 	const quoted = `"${table}"`;
 	const col = quoted === quotedAs ? data.shape[key] : data.joinedShapes?.[tableName][key];
-	if (jsonList) jsonList[as] = col;
+	if (jsonList) jsonList[as] = col && getSelectedColumnData(col);
 	if (col) {
+		if (col.data.selectSql) return `(${col.data.selectSql.toSQL(ctx, quoted)}) "${as}"`;
 		if (col.data.name && col.data.name !== key) return `"${tableName}"."${col.data.name}" "${as}"`;
-		if (col.data.computed) return `(${col.data.computed.toSQL(ctx, quoted)}) "${as}"`;
 	}
 	return `"${tableName}"."${key}"${key === as ? "" : ` "${as}"`}`;
 };
@@ -6594,10 +6629,10 @@ const ownColumnToSqlWithAs = (ctx, data, column, as, quotedAs, select, jsonList)
 		return `"${column}"."${column}" "${as}"`;
 	}
 	const col = data.shape[column];
-	if (jsonList) jsonList[as] = col;
+	if (jsonList) jsonList[as] = col && getSelectedColumnData(col);
 	if (col) {
+		if (col.data.selectSql) return `(${col.data.selectSql.toSQL(ctx, quotedAs)}) "${as}"`;
 		if (col.data.name && col.data.name !== column) return `${quotedAs ? `${quotedAs}.` : ""}"${col.data.name}"${col.data.name === as ? "" : ` "${as}"`}`;
-		if (col.data.computed) return `(${col.data.computed.toSQL(ctx, quotedAs)}) "${as}"`;
 	}
 	return `${quotedAs ? `${quotedAs}.` : ""}"${column}"${column === as ? "" : ` "${as}"`}`;
 };
@@ -6753,7 +6788,7 @@ var SelectItemExpression = class extends Expression {
 	}
 	makeSQL(ctx, quotedAs) {
 		const q = this.q;
-		return typeof this.item === "string" ? this.item === "*" ? selectAllSql(q, quotedAs).join(", ") : columnToSql(ctx, q, q.shape, this.item, quotedAs, true) : this.item.toSQL(ctx, quotedAs);
+		return typeof this.item === "string" ? this.item === "*" ? selectAllSql(q, quotedAs, void 0, ctx).join(", ") : selectedColumnToSql(ctx, q, q.shape, this.item, quotedAs) : this.item.toSQL(ctx, quotedAs);
 	}
 };
 const _getSelectableColumn = (q, arg) => {
@@ -7110,12 +7145,12 @@ const selectToSqlList = (ctx, table, query, quotedAs, hookSelect = query.hookSel
 				quotedTable = `"${tableName}"`;
 				columnName = select.slice(index + 1);
 				col = table.q.joinedShapes?.[tableName]?.[columnName];
-				sql = col?.data.computed ? col.data.computed.toSQL(ctx, `"${tableName}"`) : `"${tableName}"."${col?.data.name || columnName}"`;
+				sql = selectedColumnToSql(ctx, table.q, table.q.shape, select, void 0);
 			} else {
 				quotedTable = quotedAs;
 				columnName = select;
 				col = query.shape[select];
-				sql = simpleColumnToSQL(ctx, select, col, quotedAs);
+				sql = selectedColumnToSql(ctx, table.q, query.shape, select, quotedAs);
 			}
 		} else {
 			columnName = column;
@@ -7155,17 +7190,24 @@ const selectToSql = (ctx, table, query, quotedAs, hookSelect = query.hookSelect,
 	return selectToSqlList(ctx, table, query, quotedAs, hookSelect, isSubSql, aliases, jsonList, delayedRelationSelect).join(", ");
 };
 const internalSelectAllSql = (ctx, query, quotedAs, jsonList) => {
-	if (jsonList) Object.assign(jsonList, query.selectAllShape);
+	if (jsonList) for (const key in query.selectAllShape) {
+		const column = query.selectAllShape[key];
+		jsonList[key] = getSelectedColumnData(column);
+	}
 	let columnsCount;
 	if (query.shape !== anyShape) {
 		columnsCount = 0;
 		for (const key in query.shape) if (!query.shape[key].data.explicitSelect) columnsCount++;
 		ctx.selectedCount += columnsCount;
 	}
-	return selectAllSql(query, quotedAs, columnsCount);
+	return selectAllSql(query, quotedAs, columnsCount, ctx);
+};
+const selectAllSql = (q, quotedAs, columnsCount, ctx) => {
+	return q.join?.length || q.updateFrom || q.updateMany ? q.selectAllColumns?.map((item) => selectAllColumnToSql(item, ctx, quotedAs, true)) || (isEmptySelect(q.shape, columnsCount) ? [] : [`${quotedAs}.*`]) : q.selectAllColumns ? q.selectAllColumns.map((item) => selectAllColumnToSql(item, ctx, quotedAs)) : isEmptySelect(q.shape, columnsCount) ? [] : ["*"];
 };
-const selectAllSql = (q, quotedAs, columnsCount) => {
-	return q.join?.length || q.updateFrom || q.updateMany ? q.selectAllColumns?.map((item) => `${quotedAs}.${item}`) || (isEmptySelect(q.shape, columnsCount) ? [] : [`${quotedAs}.*`]) : q.selectAllColumns ? [...q.selectAllColumns] : isEmptySelect(q.shape, columnsCount) ? [] : ["*"];
+const selectAllColumnToSql = (item, ctx, quotedAs, prefix) => {
+	if (typeof item !== "string") return item(ctx, quotedAs);
+	return prefix ? `${quotedAs}.${item}` : item;
 };
 const isEmptySelect = (shape, columnsCount) => columnsCount === void 0 ? shape === anyShape ? false : isObjectEmpty(shape) : !columnsCount;
 const pushSubQuerySql = (ctx, mainQuery, query, as, list, quotedAs, aliases) => {
@@ -7199,7 +7241,7 @@ const pushSubQuerySql = (ctx, mainQuery, query, as, list, quotedAs, aliases) =>
 			case "oneOrThrow": {
 				const table = query.q.joinedForSelect;
 				const shape = mainQuery.joinedShapes?.[as];
-				sql = makeRowToJson(table, shape, false);
+				sql = makeRowToJson(ctx, table, shape, false);
 				break;
 			}
 			case "all":
@@ -7991,12 +8033,12 @@ var FnExpression = class extends Expression {
 		if (options.distinct && !options.withinGroup) sql.push("DISTINCT ");
 		const q = this.q;
 		sql.push(this.args.map((arg) => {
-			if (typeof arg === "string") return arg === "*" ? "*" : columnToSql(ctx, q, q.shape, arg, quotedAs);
+			if (typeof arg === "string") return arg === "*" ? "*" : fnArgToSql(ctx, q, arg, quotedAs);
 			else if (arg instanceof Expression) return arg.toSQL(ctx, quotedAs);
 			else if ("pairs" in arg) {
 				const args = [];
 				const { pairs } = arg;
-				for (const key in pairs) args.push(`${addValue(values, key)}::text, ${rawOrColumnToSql(ctx, q, pairs[key], quotedAs)}`);
+				for (const key in pairs) args.push(`${addValue(values, key)}::text, ${fnArgToSql(ctx, q, pairs[key], quotedAs)}`);
 				return args.join(", ");
 			} else return addValue(values, arg.value);
 		}).join(", "));
@@ -8020,6 +8062,13 @@ var FnExpression = class extends Expression {
 		return sql.join("");
 	}
 };
+const fnArgToSql = (ctx, data, arg, quotedAs) => {
+	if (typeof arg === "string") {
+		if (arg.endsWith(".*") || data.valuesJoinedAs?.[arg]) return columnToSql(ctx, data, data.shape, arg, quotedAs);
+		return selectedColumnToSql(ctx, data, data.shape, arg, quotedAs);
+	}
+	return arg.toSQL(ctx, quotedAs);
+};
 function makeFnExpression(self, type, fn, args, options) {
 	const q = extendQuery(self, type.operators);
 	q.baseQuery.type = ExpressionTypeMethod.prototype.type;
@@ -9667,7 +9716,7 @@ const toSql = (table, type, topCtx, isSubSql, cteName, calledByThen, dontAddTabl
 			if (ctx.topCtx.cteHooks.hasSelect) {
 				if (prependedSelectParenthesis) result.text += ")";
 				const { tableHooks, ensureCount } = ctx.topCtx.cteHooks;
-				const keyValues = [...tableHooks ? Object.entries(tableHooks).map(([cteName, data]) => `'${cteName}', (SELECT json_agg(${makeRowToJson(cteName, data.shape, false, true)}) FROM "${cteName}")`) : emptyArray, ...ensureCount ? Object.entries(ensureCount).map(([cteName, item]) => `'#${cteName}', CASE WHEN ${"count" in item ? `(SELECT count(*) FROM "${cteName}") < ${item.count}` : `(SELECT "${cteName}"."${item.jsonNotNull}" FROM "${cteName}") IS NULL`} THEN (SELECT 'not-found')::int END`) : emptyArray];
+				const keyValues = [...tableHooks ? Object.entries(tableHooks).map(([cteName, data]) => `'${cteName}', (SELECT json_agg(${makeRowToJson(ctx, cteName, data.shape, false, true)}) FROM "${cteName}")`) : emptyArray, ...ensureCount ? Object.entries(ensureCount).map(([cteName, item]) => `'#${cteName}', CASE WHEN ${"count" in item ? `(SELECT count(*) FROM "${cteName}") < ${item.count}` : `(SELECT "${cteName}"."${item.jsonNotNull}" FROM "${cteName}") IS NULL`} THEN (SELECT 'not-found')::int END`) : emptyArray];
 				result.text += ` UNION ALL SELECT ${"NULL, ".repeat(ctx.selectedCount || 0)}json_build_object(${keyValues.join(", ")})`;
 			}
 		}
@@ -9795,17 +9844,23 @@ const quoteFromWithSchema = (schema, table) => {
 	const s = typeof schema === "function" ? schema() : schema;
 	return s ? `"${s}"."${table}"` : `"${table}"`;
 };
-const makeRowToJson = (table, shape, aliasName, includingExplicitSelect) => {
+const makeRowToJson = (ctx, table, shape, aliasName, includingExplicitSelect) => {
 	let isSimple = true;
 	const list = [];
 	for (const key in shape) {
 		const column = shape[key];
 		if (!includingExplicitSelect && column.data.explicitSelect) continue;
-		if (aliasName && column.data.name || column.data.jsonCast) isSimple = false;
-		list.push(`'${key}', "${table}"."${aliasName && column.data.name || key}"${column.data.jsonCast ? `::${column.data.jsonCast}` : ""}`);
+		const selectSql = !column.data.computed ? column.data.selectSql : void 0;
+		const outputColumn = getSelectedColumnData(column);
+		if (aliasName && column.data.name || outputColumn.data.jsonCast || selectSql) isSimple = false;
+		const value = selectSql ? selectSql.toSQL(ctx, `"${table}"`) : `"${table}"."${aliasName && column.data.name || key}"`;
+		list.push(`'${key}', ${value}${outputColumn.data.jsonCast ? `::${outputColumn.data.jsonCast}` : ""}`);
 	}
 	return isSimple ? `row_to_json("${table}".*)` : `CASE WHEN to_jsonb("${table}") IS NULL THEN NULL ELSE json_build_object(` + list.join(", ") + ") END";
 };
+const getSelectedColumnData = (column) => {
+	return column.data.selectSql?.result.value || column;
+};
 const getSqlText = (sql) => {
 	if ("text" in sql) return sql.text;
 	throw new Error(`Batch SQL is not supported in this query`);
@@ -12444,6 +12499,10 @@ var MergeQueryMethods = class {
 		return query;
 	}
 };
+const applyColumnSelectSql = (column) => {
+	const { selectSqlFn } = column.data;
+	if (selectSqlFn) column.data.selectSql = selectSqlFn(new ColumnRefExpression(column, column.data.key));
+};
 const DEFAULT_PRIVILEGE = {
 	OBJECT_TYPES: [
 		"TABLES",
@@ -12514,6 +12573,25 @@ function getSupportedDefaultPrivileges(version) {
 	supportedPrivilegesCache.set(version, result);
 	return result;
 }
+const makeRefreshMaterializedViewSql = (query, options) => {
+	if (options?.concurrently && options.withData === false) throw new Error("Cannot refresh a materialized view concurrently with WITH NO DATA");
+	const sql = ["REFRESH MATERIALIZED VIEW"];
+	if (options?.concurrently) sql.push("CONCURRENTLY");
+	sql.push(quoteTableWithSchema(query));
+	if (options?.withData === true) sql.push("WITH DATA");
+	else if (options?.withData === false) sql.push("WITH NO DATA");
+	return {
+		text: sql.join(" "),
+		values: []
+	};
+};
+/**
+* Refresh a materialized view.
+*/
+const refreshMaterializedView = async (query, options) => {
+	const sql = makeRefreshMaterializedViewSql(query, options);
+	await (query.internal.asyncStorage.getStore()?.transactionAdapter || query.q.adapter).query(sql.text, sql.values);
+};
 var QueryJsonMethods = class {
 	/**
 	* Wraps the query in a way to select a single JSON string.
@@ -13772,7 +13850,7 @@ const performQuery = async (q, args, method) => {
 	}
 };
 var Db = class extends QueryMethods {
-	constructor(adapterNotInTransaction, qb, table = void 0, shape, columnTypes, asyncStorage, options, tableData = {}) {
+	constructor(adapterNotInTransaction, qb, table = void 0, shape, columnTypes, asyncStorage, options, tableData = {}, viewData) {
 		super();
 		this.adapterNotInTransaction = adapterNotInTransaction;
 		this.qb = qb;
@@ -13814,6 +13892,10 @@ var Db = class extends QueryMethods {
 			}
 			if (column.data.explicitSelect) prepareSelectAll = true;
 			else selectAllCount++;
+			if (column.data.selectSqlFn) {
+				applyColumnSelectSql(column);
+				prepareSelectAll = true;
+			}
 			const { modifyQuery: mq } = column.data;
 			if (mq) modifyQuery = pushOrNewArray(modifyQuery, (q) => mq(q, column));
 			if (typeof column.data.default === "function") {
@@ -13834,7 +13916,9 @@ var Db = class extends QueryMethods {
 			noPrimaryKey: options.noPrimaryKey === "ignore",
 			comment: options.comment,
 			readOnly: options.readOnly,
+			materialized: options.materialized,
 			nowSQL: options.nowSQL,
+			viewData,
 			tableData,
 			selectAllCount
 		};
@@ -13871,7 +13955,12 @@ var Db = class extends QueryMethods {
 			for (const key in shape) {
 				const column = shape[key];
 				if (!column.data.explicitSelect) {
-					list.push(column.data.name ? `"${column.data.name}" "${key}"` : `"${key}"`);
+					const { data } = column;
+					const { selectSql } = data;
+					let item;
+					if (selectSql) item = (ctx, quotedAs) => `(${selectSql.toSQL(ctx, quotedAs)}) "${key}"`;
+					else item = data.name ? `"${data.name}" "${key}"` : `"${key}"`;
+					list.push(item);
 					selectAllShape[key] = column;
 				}
 			}
@@ -14528,6 +14617,7 @@ exports.quoteTableWithSchema = quoteTableWithSchema;
 exports.raw = raw;
 exports.rawSqlToCode = rawSqlToCode;
 exports.referencesArgsToCode = referencesArgsToCode;
+exports.refreshMaterializedView = refreshMaterializedView;
 exports.returnArg = returnArg;
 exports.setColumnData = setColumnData;
 exports.setColumnEncode = setColumnEncode;