drizzle-orm 1.0.0-beta.21 → 1.0.0-beta.21-af6b4cb

package/pg-core/columns/common.d.ts

@@ -8,10 +8,6 @@ import { ColumnType, GeneratedColumnConfig, GeneratedIdentityConfig } from "../.
 import { PgTable } from "../table.js";
 
 //#region src/pg-core/columns/common.d.ts
-declare const PgColumnBuilderBrand: unique symbol;
-type PgColumnBuilderBrand = typeof PgColumnBuilderBrand;
-declare const PgColumnBrand: unique symbol;
-type PgColumnBrand = typeof PgColumnBrand;
 type PgArrayDimension = 0 | 1 | 2 | 3 | 4 | 5;
 type PgArrayDimensionString = '[]' | '[][]' | '[][][]' | '[][][][]' | '[][][][][]';
 type ArrayDimensionStringToNumber<T extends PgArrayDimensionString> = T extends '[]' ? 1 : T extends '[][]' ? 2 : T extends '[][][]' ? 3 : T extends '[][][][]' ? 4 : T extends '[][][][][]' ? 5 : never;
@@ -65,45 +61,45 @@ interface PgColumnBaseConfig<out TDataType extends ColumnType = ColumnType> {
 }
 type WrapArray<T, N extends number> = N extends 1 ? T[] : N extends 2 ? T[][] : N extends 3 ? T[][][] : N extends 4 ? T[][][][] : N extends 5 ? T[][][][][] : T;
 type SetNotNull<T> = T & {
-  readonly [PgColumnBuilderBrand]: {
+  readonly _: {
     notNull: true;
   };
 };
 type SetHasDefault<T> = T & {
-  readonly [PgColumnBuilderBrand]: {
+  readonly _: {
     hasDefault: true;
   };
 };
 type SetIsPrimaryKey<T> = T & {
-  readonly [PgColumnBuilderBrand]: {
+  readonly _: {
     isPrimaryKey: true;
     notNull: true;
   };
 };
 type SetHasRuntimeDefault<T> = T & {
-  readonly [PgColumnBuilderBrand]: {
+  readonly _: {
     hasRuntimeDefault: true;
     hasDefault: true;
   };
 };
 type Set$Type<T, TType> = T & {
-  readonly [PgColumnBuilderBrand]: {
+  readonly _: {
     $type: TType;
   };
 };
 type SetHasGenerated<T> = T & {
-  readonly [PgColumnBuilderBrand]: {
+  readonly _: {
     hasDefault: true;
     generated: true;
   };
 };
 type SetDimensions<T, TDim extends PgArrayDimension> = T & {
-  readonly [PgColumnBuilderBrand]: {
+  readonly _: {
     dimensions: TDim;
   };
 };
 type SetIdentity<T, TType extends 'always' | 'byDefault'> = T & {
-  readonly [PgColumnBuilderBrand]: {
+  readonly _: {
     notNull: true;
     hasDefault: true;
     identity: TType;
@@ -133,12 +129,9 @@ type ResolvePgColumnConfig<out T extends PgColumnBuilderConfig, out TTableName e
   generated: T['generated'] extends true ? true : undefined;
 } & {};
 interface AnyPgColumnBuilder {
-  readonly [PgColumnBuilderBrand]: PgColumnBuilderConfig;
+  readonly _: PgColumnBuilderConfig;
 }
-interface AnyPostgresColumn {
-  readonly [PgColumnBrand]: PgColumnBaseConfig;
-}
-type PgBuildColumn<TTableName extends string, TBuilder extends AnyPgColumnBuilder, TBuiltConfig extends PgColumnBaseConfig<ColumnType> = ResolvePgColumnConfig<TBuilder[PgColumnBuilderBrand], TTableName>> = PgColumn<ColumnType, TBuiltConfig, {}>;
+type PgBuildColumn<TTableName extends string, TBuilder extends AnyPgColumnBuilder, TBuiltConfig extends PgColumnBaseConfig<ColumnType> = ResolvePgColumnConfig<TBuilder['_'], TTableName>> = PgColumn<ColumnType, TBuiltConfig, {}>;
 type PgBuildColumns<out TTableName extends string, out TConfigMap extends Record<string, AnyPgColumnBuilder>> = { [Key in keyof TConfigMap]: PgBuildColumn<TTableName, TConfigMap[Key]> } & {};
 type PgBuildExtraConfigColumns<out TConfigMap extends Record<string, AnyPgColumnBuilder>> = { [Key in keyof TConfigMap]: ExtraConfigColumn } & {};
 type PgColumns = Record<string, PgColumn>;
@@ -152,7 +145,7 @@ interface ReferenceConfig {
 }
 declare abstract class PgColumnBuilder<out T extends PgColumnBuilderConfig = PgColumnBuilderConfig, out TRuntimeConfig extends object = object> {
   static readonly [entityKind]: string;
-  readonly [PgColumnBuilderBrand]: T;
+  readonly _: T;
   private foreignKeyConfigs;
   protected config: PgColumnBuilderRuntimeConfig<T['data']> & TRuntimeConfig;
   constructor(name: string, dataType: ColumnType, columnType: string);
@@ -181,36 +174,36 @@ declare abstract class PgColumnBuilder<out T extends PgColumnBuilderConfig = PgC
    *
    * If you need to set a dynamic default value, use {@link $defaultFn} instead.
    */
-  default(value: (this[PgColumnBuilderBrand] extends {
+  default(value: (this['_'] extends {
     dimensions: 1 | 2 | 3 | 4 | 5;
-  } ? WrapArray<this[PgColumnBuilderBrand] extends {
+  } ? WrapArray<this['_'] extends {
     $type: infer U;
-  } ? U : this[PgColumnBuilderBrand]['data'], this[PgColumnBuilderBrand]['dimensions']> : this[PgColumnBuilderBrand] extends {
+  } ? U : this['_']['data'], this['_']['dimensions']> : this['_'] extends {
     $type: infer U;
-  } ? U : this[PgColumnBuilderBrand]['data']) | SQL): SetHasDefault<this>;
+  } ? U : this['_']['data']) | SQL): SetHasDefault<this>;
   /**
    * Adds a dynamic default value to the column.
    * The function will be called when the row is inserted, and the returned value will be used as the column value.
    *
    * **Note:** This value does not affect the `drizzle-kit` behavior, it is only used at runtime in `drizzle-orm`.
    */
-  $defaultFn(fn: () => (this[PgColumnBuilderBrand] extends {
+  $defaultFn(fn: () => (this['_'] extends {
     dimensions: 1 | 2 | 3 | 4 | 5;
-  } ? WrapArray<this[PgColumnBuilderBrand] extends {
+  } ? WrapArray<this['_'] extends {
     $type: infer U;
-  } ? U : this[PgColumnBuilderBrand]['data'], this[PgColumnBuilderBrand]['dimensions']> : this[PgColumnBuilderBrand] extends {
+  } ? U : this['_']['data'], this['_']['dimensions']> : this['_'] extends {
     $type: infer U;
-  } ? U : this[PgColumnBuilderBrand]['data']) | SQL): SetHasRuntimeDefault<this>;
+  } ? U : this['_']['data']) | SQL): SetHasRuntimeDefault<this>;
   /**
    * Alias for {@link $defaultFn}.
    */
-  $default: (fn: () => (this[PgColumnBuilderBrand] extends {
+  $default: (fn: () => (this["_"] extends {
     dimensions: 1 | 2 | 3 | 4 | 5;
-  } ? WrapArray<this[PgColumnBuilderBrand] extends {
+  } ? WrapArray<this["_"] extends {
     $type: infer U;
-  } ? U : this[PgColumnBuilderBrand]["data"], this[PgColumnBuilderBrand]["dimensions"]> : this[PgColumnBuilderBrand] extends {
+  } ? U : this["_"]["data"], this["_"]["dimensions"]> : this["_"] extends {
     $type: infer U;
-  } ? U : this[PgColumnBuilderBrand]["data"]) | SQL) => SetHasRuntimeDefault<this>;
+  } ? U : this["_"]["data"]) | SQL) => SetHasRuntimeDefault<this>;
   /**
    * Adds a dynamic update value to the column.
    * The function will be called when the row is updated, and the returned value will be used as the column value if none is provided.
@@ -218,23 +211,23 @@ declare abstract class PgColumnBuilder<out T extends PgColumnBuilderConfig = PgC
    *
    * **Note:** This value does not affect the `drizzle-kit` behavior, it is only used at runtime in `drizzle-orm`.
    */
-  $onUpdateFn(fn: () => (this[PgColumnBuilderBrand] extends {
+  $onUpdateFn(fn: () => (this['_'] extends {
     dimensions: 1 | 2 | 3 | 4 | 5;
-  } ? WrapArray<this[PgColumnBuilderBrand] extends {
+  } ? WrapArray<this['_'] extends {
     $type: infer U;
-  } ? U : this[PgColumnBuilderBrand]['data'], this[PgColumnBuilderBrand]['dimensions']> : this[PgColumnBuilderBrand] extends {
+  } ? U : this['_']['data'], this['_']['dimensions']> : this['_'] extends {
     $type: infer U;
-  } ? U : this[PgColumnBuilderBrand]['data']) | SQL): SetHasDefault<this>;
+  } ? U : this['_']['data']) | SQL): SetHasDefault<this>;
   /**
    * Alias for {@link $onUpdateFn}.
    */
-  $onUpdate: (fn: () => (this[PgColumnBuilderBrand] extends {
+  $onUpdate: (fn: () => (this["_"] extends {
     dimensions: 1 | 2 | 3 | 4 | 5;
-  } ? WrapArray<this[PgColumnBuilderBrand] extends {
+  } ? WrapArray<this["_"] extends {
     $type: infer U;
-  } ? U : this[PgColumnBuilderBrand]["data"], this[PgColumnBuilderBrand]["dimensions"]> : this[PgColumnBuilderBrand] extends {
+  } ? U : this["_"]["data"], this["_"]["dimensions"]> : this["_"] extends {
     $type: infer U;
-  } ? U : this[PgColumnBuilderBrand]["data"]) | SQL) => SetHasDefault<this>;
+  } ? U : this["_"]["data"]) | SQL) => SetHasDefault<this>;
   /**
    * Adds a `primary key` clause to the column definition. This implicitly makes the column `not null`.
    *
@@ -275,6 +268,8 @@ type IndexedExtraConfigType = {
 };
 declare class ExtraConfigColumn<out T extends PgColumnBaseConfig<ColumnType> = PgColumnBaseConfig<ColumnType>> extends PgColumn<ColumnType, T, IndexedExtraConfigType> {
   static readonly [entityKind]: string;
+  /** @itnernal */
+  readonly useCodecType: undefined;
   getSQLType(): string;
   indexConfig: IndexedExtraConfigType;
   defaultConfig: IndexedExtraConfigType;
@@ -323,5 +318,5 @@ declare class IndexedColumn {
 }
 type AnyPgColumn<TPartial extends Partial<PgColumnBaseConfig<ColumnType>> = {}> = PgColumn<any, Required<Update<PgColumnBaseConfig<ColumnType>, TPartial>>>;
 //#endregion
-export { AnyPgColumn, AnyPgColumnBuilder, AnyPostgresColumn, ExtraConfigColumn, HasIdentity, IndexedColumn, IndexedExtraConfigType, PgArrayDimension, PgBuildColumn, PgBuildColumns, PgBuildExtraConfigColumns, PgColumn, PgColumnBaseConfig, PgColumnBrand, PgColumnBuilder, PgColumnBuilderBrand, PgColumnBuilderConfig, PgColumnBuilderRuntimeConfig, PgColumns, ReferenceConfig, ResolvePgColumnConfig, Set$Type, SetDimensions, SetHasDefault, SetHasGenerated, SetHasRuntimeDefault, SetIdentity, SetIsPrimaryKey, SetNotNull };
+export { AnyPgColumn, AnyPgColumnBuilder, ExtraConfigColumn, HasIdentity, IndexedColumn, IndexedExtraConfigType, PgArrayDimension, PgBuildColumn, PgBuildColumns, PgBuildExtraConfigColumns, PgColumn, PgColumnBaseConfig, PgColumnBuilder, PgColumnBuilderConfig, PgColumnBuilderRuntimeConfig, PgColumns, ReferenceConfig, ResolvePgColumnConfig, Set$Type, SetDimensions, SetHasDefault, SetHasGenerated, SetHasRuntimeDefault, SetIdentity, SetIsPrimaryKey, SetNotNull };
 //# sourceMappingURL=common.d.ts.map

package/pg-core/columns/common.js

@@ -1,8 +1,7 @@
-import { makePgArray, parsePgArray } from "../utils/array.js";
 import { entityKind } from "../../entity.js";
+import { iife } from "../../tracing-utils.js";
 import { Column } from "../../column.js";
 import { ForeignKeyBuilder } from "../foreign-keys.js";
-import { iife } from "../../tracing-utils.js";
 
 //#region src/pg-core/columns/common.ts
 var PgColumnBuilder = class {
@@ -170,19 +169,20 @@ var PgColumn = class extends Column {
 		super(table, config);
 		this.table = table;
 		this.dimensions = config.dimensions ?? 0;
+	}
+	/** @internal */
+	postBuild() {
 		if (this.dimensions) {
 			const originalFromDriver = this.mapFromDriverValue.bind(this);
 			const originalToDriver = this.mapToDriverValue.bind(this);
-			this.mapFromDriverValue = (value) => {
-				if (value === null) return value;
-				const arr = typeof value === "string" ? parsePgArray(value) : value;
-				return this.mapArrayElements(arr, originalFromDriver, this.dimensions);
+			this.mapFromDriverValue = this.mapFromDriverValue.isNoop ? this.mapFromDriverValue : (value) => {
+				return this.mapArrayElements(value, originalFromDriver, this.dimensions);
 			};
-			this.mapToDriverValue = (value) => {
-				if (value === null) return value;
-				return makePgArray(this.mapArrayElements(value, originalToDriver, this.dimensions));
+			this.mapToDriverValue = this.mapToDriverValue.isNoop ? this.mapToDriverValue : (value) => {
+				return this.mapArrayElements(value, originalToDriver, this.dimensions);
 			};
 		}
+		return this;
 	}
 	/** @internal */
 	mapArrayElements(value, mapper, depth) {
@@ -192,6 +192,8 @@ var PgColumn = class extends Column {
 };
 var ExtraConfigColumn = class extends PgColumn {
 	static [entityKind] = "ExtraConfigColumn";
+	/** @itnernal */
+	useCodecType = void 0;
 	getSQLType() {
 		return this.getSQLType();
 	}

package/pg-core/columns/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","names":[],"sources":["../../../src/pg-core/columns/common.ts"],"sourcesContent":["import type { ColumnType, GeneratedColumnConfig, GeneratedIdentityConfig } from '~/column-builder.ts';\nimport { Column } from '~/column.ts';\nimport { entityKind } from '~/entity.ts';\nimport type { ForeignKey, UpdateDeleteAction } from '~/pg-core/foreign-keys.ts';\nimport { ForeignKeyBuilder } from '~/pg-core/foreign-keys.ts';\nimport type { AnyPgTable, PgTable } from '~/pg-core/table.ts';\nimport type { SQL } from '~/sql/sql.ts';\nimport { iife } from '~/tracing-utils.ts';\nimport type { Update } from '~/utils.ts';\nimport type { PgIndexOpClass } from '../indexes.ts';\nimport { makePgArray, parsePgArray } from '../utils/array.ts';\n\ndeclare const PgColumnBuilderBrand: unique symbol;\nexport type PgColumnBuilderBrand = typeof PgColumnBuilderBrand;\n\ndeclare const PgColumnBrand: unique symbol;\nexport type PgColumnBrand = typeof PgColumnBrand;\n\nexport type PgArrayDimension = 0 | 1 | 2 | 3 | 4 | 5;\ntype PgArrayDimensionString = '[]' | '[][]' | '[][][]' | '[][][][]' | '[][][][][]';\n\ntype ArrayDimensionStringToNumber<T extends PgArrayDimensionString> = T extends '[]' ? 1\n\t: T extends '[][]' ? 2\n\t: T extends '[][][]' ? 3\n\t: T extends '[][][][]' ? 4\n\t: T extends '[][][][][]' ? 5\n\t: never;\n\nexport interface PgColumnBuilderConfig {\n\tdataType: ColumnType;\n\tdata: unknown;\n\tdriverParam: unknown;\n\t// Optional - set via chain methods\n\tnotNull?: boolean;\n\thasDefault?: boolean;\n\tisPrimaryKey?: boolean;\n\tisAutoincrement?: boolean;\n\thasRuntimeDefault?: boolean;\n\tenumValues?: string[];\n\tidentity?: 'always' | 'byDefault';\n\tgenerated?: unknown;\n\tdimensions?: PgArrayDimension;\n\t$type?: unknown;\n}\n\nexport interface PgColumnBuilderRuntimeConfig<TData> {\n\tname: string;\n\tkeyAsName: boolean;\n\tnotNull: boolean;\n\tdefault: TData | SQL | undefined;\n\tdefaultFn: (() => TData | SQL) | undefined;\n\tonUpdateFn: (() => TData | SQL) | undefined;\n\thasDefault: boolean;\n\tprimaryKey: boolean;\n\tisUnique: boolean;\n\tuniqueName: string | undefined;\n\tuniqueType: string | undefined;\n\tdataType: string;\n\tcolumnType: string;\n\tgenerated: GeneratedColumnConfig<TData> | undefined;\n\tgeneratedIdentity: GeneratedIdentityConfig | undefined;\n\tdimensions?: PgArrayDimension;\n}\n\n// TODO: remove isAutoincrement and hasRuntimeDefault\nexport interface PgColumnBaseConfig<out TDataType extends ColumnType = ColumnType> {\n\tname: string;\n\tdataType: TDataType;\n\ttableName: string;\n\tnotNull: boolean;\n\thasDefault: boolean;\n\tisPrimaryKey: boolean;\n\tisAutoincrement: boolean;\n\thasRuntimeDefault: boolean;\n\tdata: unknown;\n\tdriverParam: unknown;\n\tenumValues: string[] | undefined;\n\tgenerated: unknown;\n\tidentity: undefined | 'always' | 'byDefault';\n\t// insertType: unknown;\n}\n\ntype WrapArray<T, N extends number> = N extends 1 ? T[]\n\t: N extends 2 ? T[][]\n\t: N extends 3 ? T[][][]\n\t: N extends 4 ? T[][][][]\n\t: N extends 5 ? T[][][][][]\n\t: T;\n\nexport type SetNotNull<T> = T & { readonly [PgColumnBuilderBrand]: { notNull: true } };\nexport type SetHasDefault<T> = T & { readonly [PgColumnBuilderBrand]: { hasDefault: true } };\nexport type SetIsPrimaryKey<T> = T & { readonly [PgColumnBuilderBrand]: { isPrimaryKey: true; notNull: true } };\nexport type SetHasRuntimeDefault<T> = T & {\n\treadonly [PgColumnBuilderBrand]: { hasRuntimeDefault: true; hasDefault: true };\n};\nexport type Set$Type<T, TType> = T & { readonly [PgColumnBuilderBrand]: { $type: TType } };\nexport type SetHasGenerated<T> = T & {\n\treadonly [PgColumnBuilderBrand]: { hasDefault: true; generated: true };\n};\nexport type SetDimensions<T, TDim extends PgArrayDimension> = T & {\n\treadonly [PgColumnBuilderBrand]: { dimensions: TDim };\n};\nexport type SetIdentity<T, TType extends 'always' | 'byDefault'> = T & {\n\treadonly [PgColumnBuilderBrand]: { notNull: true; hasDefault: true; identity: TType };\n};\n\nexport type HasIdentity<T, TType extends 'always' | 'byDefault'> = SetIdentity<T, TType>;\n\ntype GetBaseData<T> = T extends { $type: infer U } ? U : T extends { data: infer D } ? D : unknown;\n\nexport type ResolvePgColumnConfig<\n\tout T extends PgColumnBuilderConfig,\n\tout TTableName extends string,\n\tout TData = T['dimensions'] extends 1 | 2 | 3 | 4 | 5 ? WrapArray<GetBaseData<T>, T['dimensions']>\n\t\t: GetBaseData<T>,\n> = {\n\tname: string;\n\ttableName: TTableName;\n\tdataType: T['dataType'];\n\tdata: TData;\n\tdriverParam: T['dimensions'] extends 1 | 2 | 3 | 4 | 5 ? WrapArray<T['driverParam'], T['dimensions']> | string\n\t\t: T['driverParam'];\n\tnotNull: T['notNull'] extends true ? true : false;\n\thasDefault: T['hasDefault'] extends true ? true : false;\n\tisPrimaryKey: false;\n\tisAutoincrement: false;\n\thasRuntimeDefault: false;\n\tenumValues: T extends { enumValues: infer E extends string[] } ? E : undefined;\n\tidentity: T['identity'] extends 'always' | 'byDefault' ? T['identity'] : undefined;\n\tgenerated: T['generated'] extends true ? true : undefined;\n\t// insertType: T['generated'] extends true ? never\n\t// \t: T['identity'] extends 'always' ? never\n\t// \t: T['notNull'] extends true ? T['hasDefault'] extends true ? TData | undefined : TData\n\t// \t: TData | null | undefined;\n} & {};\n\nexport interface AnyPgColumnBuilder {\n\treadonly [PgColumnBuilderBrand]: PgColumnBuilderConfig;\n}\n\nexport interface AnyPostgresColumn {\n\treadonly [PgColumnBrand]: PgColumnBaseConfig;\n}\n\nexport type PgBuildColumn<\n\tTTableName extends string,\n\tTBuilder extends AnyPgColumnBuilder,\n\tTBuiltConfig extends PgColumnBaseConfig<ColumnType> = ResolvePgColumnConfig<\n\t\tTBuilder[PgColumnBuilderBrand],\n\t\tTTableName\n\t>,\n> = PgColumn<ColumnType, TBuiltConfig, {}>;\n\nexport type PgBuildColumns<\n\tout TTableName extends string,\n\tout TConfigMap extends Record<string, AnyPgColumnBuilder>,\n> =\n\t& {\n\t\t[Key in keyof TConfigMap]: PgBuildColumn<TTableName, TConfigMap[Key]>;\n\t}\n\t& {};\n\nexport type PgBuildExtraConfigColumns<\n\tout TConfigMap extends Record<string, AnyPgColumnBuilder>,\n> =\n\t& {\n\t\t[Key in keyof TConfigMap]: ExtraConfigColumn;\n\t}\n\t& {};\n\nexport type PgColumns = Record<string, PgColumn>;\n\nexport interface ReferenceConfig {\n\tref: () => PgColumn;\n\tconfig: {\n\t\tname?: string;\n\t\tonUpdate?: UpdateDeleteAction;\n\t\tonDelete?: UpdateDeleteAction;\n\t};\n}\n\nexport abstract class PgColumnBuilder<\n\tout T extends PgColumnBuilderConfig = PgColumnBuilderConfig,\n\tout TRuntimeConfig extends object = object,\n> {\n\tstatic readonly [entityKind]: string = 'PgColumnBuilder';\n\n\tdeclare readonly [PgColumnBuilderBrand]: T;\n\n\tprivate foreignKeyConfigs: ReferenceConfig[] = [];\n\n\tprotected config: PgColumnBuilderRuntimeConfig<T['data']> & TRuntimeConfig;\n\n\tconstructor(name: string, dataType: ColumnType, columnType: string) {\n\t\tthis.config = {\n\t\t\tname,\n\t\t\tkeyAsName: name === '',\n\t\t\tnotNull: false,\n\t\t\tdefault: undefined,\n\t\t\thasDefault: false,\n\t\t\tprimaryKey: false,\n\t\t\tisUnique: false,\n\t\t\tuniqueName: undefined,\n\t\t\tuniqueType: undefined,\n\t\t\tdataType,\n\t\t\tcolumnType,\n\t\t\tgenerated: undefined,\n\t\t\tdefaultFn: undefined,\n\t\t\tonUpdateFn: undefined,\n\t\t\tgeneratedIdentity: undefined,\n\t\t} as PgColumnBuilderRuntimeConfig<T['data']> & TRuntimeConfig;\n\t}\n\n\t/**\n\t * Changes the data type of the column. Commonly used with `json` columns. Also, useful for branded types.\n\t *\n\t * @example\n\t * ```ts\n\t * const users = pgTable('users', {\n\t * \tid: integer('id').$type<UserId>().primaryKey(),\n\t * \tdetails: json('details').$type<UserDetails>().notNull(),\n\t * });\n\t * ```\n\t */\n\t$type<TType>(): Set$Type<this, TType> {\n\t\treturn this as Set$Type<this, TType>;\n\t}\n\n\t/**\n\t * Adds a `not null` clause to the column definition.\n\t *\n\t * Affects the `select` model of the table - columns *without* `not null` will be nullable on select.\n\t */\n\tnotNull(): SetNotNull<this> {\n\t\tthis.config.notNull = true;\n\t\treturn this as SetNotNull<this>;\n\t}\n\n\t/**\n\t * Adds a `default <value>` clause to the column definition.\n\t *\n\t * Affects the `insert` model of the table - columns *with* `default` are optional on insert.\n\t *\n\t * If you need to set a dynamic default value, use {@link $defaultFn} instead.\n\t */\n\tdefault(\n\t\tvalue:\n\t\t\t| (this[PgColumnBuilderBrand] extends { dimensions: 1 | 2 | 3 | 4 | 5 } ? WrapArray<\n\t\t\t\t\tthis[PgColumnBuilderBrand] extends { $type: infer U } ? U : this[PgColumnBuilderBrand]['data'],\n\t\t\t\t\tthis[PgColumnBuilderBrand]['dimensions']\n\t\t\t\t>\n\t\t\t\t: this[PgColumnBuilderBrand] extends { $type: infer U } ? U\n\t\t\t\t: this[PgColumnBuilderBrand]['data'])\n\t\t\t| SQL,\n\t): SetHasDefault<this> {\n\t\tthis.config.default = value;\n\t\tthis.config.hasDefault = true;\n\t\treturn this as SetHasDefault<this>;\n\t}\n\n\t/**\n\t * Adds a dynamic default value to the column.\n\t * The function will be called when the row is inserted, and the returned value will be used as the column value.\n\t *\n\t * **Note:** This value does not affect the `drizzle-kit` behavior, it is only used at runtime in `drizzle-orm`.\n\t */\n\t$defaultFn(\n\t\tfn: () =>\n\t\t\t| (this[PgColumnBuilderBrand] extends { dimensions: 1 | 2 | 3 | 4 | 5 } ? WrapArray<\n\t\t\t\t\tthis[PgColumnBuilderBrand] extends { $type: infer U } ? U : this[PgColumnBuilderBrand]['data'],\n\t\t\t\t\tthis[PgColumnBuilderBrand]['dimensions']\n\t\t\t\t>\n\t\t\t\t: this[PgColumnBuilderBrand] extends { $type: infer U } ? U\n\t\t\t\t: this[PgColumnBuilderBrand]['data'])\n\t\t\t| SQL,\n\t): SetHasRuntimeDefault<this> {\n\t\tthis.config.defaultFn = fn;\n\t\tthis.config.hasDefault = true;\n\t\treturn this as SetHasRuntimeDefault<this>;\n\t}\n\n\t/**\n\t * Alias for {@link $defaultFn}.\n\t */\n\t$default = this.$defaultFn;\n\n\t/**\n\t * Adds a dynamic update value to the column.\n\t * The function will be called when the row is updated, and the returned value will be used as the column value if none is provided.\n\t * If no `default` (or `$defaultFn`) value is provided, the function will be called when the row is inserted as well, and the returned value will be used as the column value.\n\t *\n\t * **Note:** This value does not affect the `drizzle-kit` behavior, it is only used at runtime in `drizzle-orm`.\n\t */\n\t$onUpdateFn(\n\t\tfn: () =>\n\t\t\t| (this[PgColumnBuilderBrand] extends { dimensions: 1 | 2 | 3 | 4 | 5 } ? WrapArray<\n\t\t\t\t\tthis[PgColumnBuilderBrand] extends { $type: infer U } ? U : this[PgColumnBuilderBrand]['data'],\n\t\t\t\t\tthis[PgColumnBuilderBrand]['dimensions']\n\t\t\t\t>\n\t\t\t\t: this[PgColumnBuilderBrand] extends { $type: infer U } ? U\n\t\t\t\t: this[PgColumnBuilderBrand]['data'])\n\t\t\t| SQL,\n\t): SetHasDefault<this> {\n\t\tthis.config.onUpdateFn = fn;\n\t\tthis.config.hasDefault = true;\n\t\treturn this as SetHasDefault<this>;\n\t}\n\n\t/**\n\t * Alias for {@link $onUpdateFn}.\n\t */\n\t$onUpdate = this.$onUpdateFn;\n\n\t/**\n\t * Adds a `primary key` clause to the column definition. This implicitly makes the column `not null`.\n\t *\n\t * In SQLite, `integer primary key` implicitly makes the column auto-incrementing.\n\t */\n\tprimaryKey(): SetIsPrimaryKey<this> {\n\t\tthis.config.primaryKey = true;\n\t\tthis.config.notNull = true;\n\t\treturn this as SetIsPrimaryKey<this>;\n\t}\n\n\t/** @internal Sets the name of the column to the key within the table definition if a name was not given. */\n\tsetName(name: string) {\n\t\tif (this.config.name !== '') return;\n\t\tthis.config.name = name;\n\t}\n\n\t/**\n\t * Makes this column a PostgreSQL array column.\n\t *\n\t * @example\n\t * ```ts\n\t * const t = pgTable('t', {\n\t *   // 1D array: number[]\n\t *   tags: integer().array(),\n\t *   // Or explicitly: integer().array('[]')\n\t *   // 2D array: number[][]\n\t *   matrix: integer().array('[][]'),\n\t * });\n\t * ```\n\t */\n\tarray(): SetDimensions<this, 1>;\n\tarray<TDim extends PgArrayDimensionString>(\n\t\tdimensions: TDim,\n\t): SetDimensions<this, ArrayDimensionStringToNumber<TDim>>;\n\tarray<TDim extends PgArrayDimensionString>(\n\t\tdimensions?: TDim,\n\t): SetDimensions<this, ArrayDimensionStringToNumber<TDim>> {\n\t\t// Calculate dimensions as number from string notation\n\t\tconst dim = dimensions ?? '[]';\n\t\t(this.config as any).dimensions = (dim.length / 2) as PgArrayDimension;\n\t\treturn this as SetDimensions<this, ArrayDimensionStringToNumber<TDim>>;\n\t}\n\n\treferences(\n\t\tref: ReferenceConfig['ref'],\n\t\tconfig: ReferenceConfig['config'] = {},\n\t): this {\n\t\tthis.foreignKeyConfigs.push({ ref, config });\n\t\treturn this;\n\t}\n\n\tunique(\n\t\tname?: string,\n\t\tconfig?: { nulls: 'distinct' | 'not distinct' },\n\t): this {\n\t\tthis.config.isUnique = true;\n\t\tthis.config.uniqueName = name;\n\t\tthis.config.uniqueType = config?.nulls;\n\t\treturn this;\n\t}\n\n\tgeneratedAlwaysAs(\n\t\tas:\n\t\t\t| SQL\n\t\t\t| (() => SQL),\n\t): SetHasGenerated<this> {\n\t\tthis.config.generated = {\n\t\t\tas,\n\t\t\ttype: 'always',\n\t\t\tmode: 'stored',\n\t\t};\n\t\treturn this as SetHasGenerated<this>;\n\t}\n\n\t/** @internal */\n\tbuildForeignKeys(column: PgColumn, table: PgTable): ForeignKey[] {\n\t\treturn this.foreignKeyConfigs.map(({ ref, config }) => {\n\t\t\treturn iife(\n\t\t\t\t(ref, config) => {\n\t\t\t\t\tconst builder = new ForeignKeyBuilder(() => {\n\t\t\t\t\t\tconst foreignColumn = ref();\n\t\t\t\t\t\treturn { name: config.name, columns: [column], foreignColumns: [foreignColumn] };\n\t\t\t\t\t});\n\t\t\t\t\tif (config.onUpdate) {\n\t\t\t\t\t\tbuilder.onUpdate(config.onUpdate);\n\t\t\t\t\t}\n\t\t\t\t\tif (config.onDelete) {\n\t\t\t\t\t\tbuilder.onDelete(config.onDelete);\n\t\t\t\t\t}\n\t\t\t\t\treturn builder.build(table);\n\t\t\t\t},\n\t\t\t\tref,\n\t\t\t\tconfig,\n\t\t\t);\n\t\t});\n\t}\n\n\t/** @internal */\n\tabstract build(table: PgTable): PgColumn<any>;\n\n\t/** @internal */\n\tbuildExtraConfigColumn<TTableName extends string>(\n\t\ttable: AnyPgTable<{ name: TTableName }>,\n\t): ExtraConfigColumn {\n\t\treturn new ExtraConfigColumn(table, { ...this.config, dimensions: (this.config as any).dimensions ?? 0 });\n\t}\n}\n\n// TODO: we should potenitally do column to be\n// in charge of map value/array of values/json value and json array of values in 1 place\nexport abstract class PgColumn<\n\tout TColumnType extends ColumnType = any,\n\tout T extends PgColumnBaseConfig<TColumnType> = PgColumnBaseConfig<TColumnType>,\n\tout TRuntimeConfig extends object = {},\n> extends Column<T, TRuntimeConfig> {\n\tstatic override readonly [entityKind]: string = 'PgColumn';\n\n\t/** @internal */\n\toverride readonly table: PgTable;\n\n\treadonly dimensions: PgArrayDimension;\n\n\tconstructor(\n\t\ttable: PgTable,\n\t\tconfig: PgColumnBuilderRuntimeConfig<T['data']> & TRuntimeConfig,\n\t) {\n\t\tsuper(table, config);\n\t\tthis.table = table;\n\t\tthis.dimensions = config.dimensions ?? 0;\n\n\t\t// Wrap mapFromDriverValue/mapToDriverValue with array handling if this is an array column\n\t\tif (this.dimensions) {\n\t\t\tconst originalFromDriver = this.mapFromDriverValue.bind(this);\n\t\t\tconst originalToDriver = this.mapToDriverValue.bind(this);\n\n\t\t\tthis.mapFromDriverValue = (value: unknown): unknown => {\n\t\t\t\tif (value === null) return value;\n\t\t\t\t// Parse string representation if needed (e.g., from node-postgres for enum arrays)\n\t\t\t\tconst arr = typeof value === 'string' ? parsePgArray(value) : value as unknown[];\n\t\t\t\treturn this.mapArrayElements(arr, originalFromDriver, this.dimensions);\n\t\t\t};\n\n\t\t\tthis.mapToDriverValue = (value: unknown): unknown => {\n\t\t\t\tif (value === null) return value;\n\t\t\t\tconst mapped = this.mapArrayElements(value as unknown[], originalToDriver, this.dimensions);\n\t\t\t\treturn makePgArray(mapped as any[]);\n\t\t\t};\n\t\t}\n\t}\n\n\t/** @internal */\n\tprivate mapArrayElements(value: unknown, mapper: (v: unknown) => unknown, depth: number): unknown {\n\t\tif (depth > 0 && Array.isArray(value)) {\n\t\t\treturn value.map((v) => v === null ? null : this.mapArrayElements(v, mapper, depth - 1));\n\t\t}\n\t\treturn mapper(value);\n\t}\n}\n\nexport type IndexedExtraConfigType = { order?: 'asc' | 'desc'; nulls?: 'first' | 'last'; opClass?: string };\n\nexport class ExtraConfigColumn<\n\tout T extends PgColumnBaseConfig<ColumnType> = PgColumnBaseConfig<ColumnType>,\n> extends PgColumn<ColumnType, T, IndexedExtraConfigType> {\n\tstatic override readonly [entityKind]: string = 'ExtraConfigColumn';\n\n\toverride getSQLType(): string {\n\t\treturn this.getSQLType();\n\t}\n\n\tindexConfig: IndexedExtraConfigType = {\n\t\torder: this.config.order ?? 'asc',\n\t\tnulls: this.config.nulls ?? 'last',\n\t\topClass: this.config.opClass,\n\t};\n\tdefaultConfig: IndexedExtraConfigType = {\n\t\torder: 'asc',\n\t\tnulls: 'last',\n\t\topClass: undefined,\n\t};\n\n\tasc(): Omit<this, 'asc' | 'desc'> {\n\t\tthis.indexConfig.order = 'asc';\n\t\treturn this;\n\t}\n\n\tdesc(): Omit<this, 'asc' | 'desc'> {\n\t\tthis.indexConfig.order = 'desc';\n\t\treturn this;\n\t}\n\n\tnullsFirst(): Omit<this, 'nullsFirst' | 'nullsLast'> {\n\t\tthis.indexConfig.nulls = 'first';\n\t\treturn this;\n\t}\n\n\tnullsLast(): Omit<this, 'nullsFirst' | 'nullsLast'> {\n\t\tthis.indexConfig.nulls = 'last';\n\t\treturn this;\n\t}\n\n\t/**\n\t * ### PostgreSQL documentation quote\n\t *\n\t * > An operator class with optional parameters can be specified for each column of an index.\n\t * The operator class identifies the operators to be used by the index for that column.\n\t * For example, a B-tree index on four-byte integers would use the int4_ops class;\n\t * this operator class includes comparison functions for four-byte integers.\n\t * In practice the default operator class for the column's data type is usually sufficient.\n\t * The main point of having operator classes is that for some data types, there could be more than one meaningful ordering.\n\t * For example, we might want to sort a complex-number data type either by absolute value or by real part.\n\t * We could do this by defining two operator classes for the data type and then selecting the proper class when creating an index.\n\t * More information about operator classes check:\n\t *\n\t * ### Useful links\n\t * https://www.postgresql.org/docs/current/sql-createindex.html\n\t *\n\t * https://www.postgresql.org/docs/current/indexes-opclass.html\n\t *\n\t * https://www.postgresql.org/docs/current/xindex.html\n\t *\n\t * ### Additional types\n\t * If you have the `pg_vector` extension installed in your database, you can use the\n\t * `vector_l2_ops`, `vector_ip_ops`, `vector_cosine_ops`, `vector_l1_ops`, `bit_hamming_ops`, `bit_jaccard_ops`, `halfvec_l2_ops`, `sparsevec_l2_ops` options, which are predefined types.\n\t *\n\t * **You can always specify any string you want in the operator class, in case Drizzle doesn't have it natively in its types**\n\t *\n\t * @param opClass\n\t * @returns\n\t */\n\top(opClass: PgIndexOpClass): Omit<this, 'op'> {\n\t\tthis.indexConfig.opClass = opClass;\n\t\treturn this;\n\t}\n}\n\nexport class IndexedColumn {\n\tstatic readonly [entityKind]: string = 'IndexedColumn';\n\tconstructor(\n\t\tname: string | undefined,\n\t\tkeyAsName: boolean,\n\t\ttype: string,\n\t\tindexConfig: IndexedExtraConfigType,\n\t) {\n\t\tthis.name = name;\n\t\tthis.keyAsName = keyAsName;\n\t\tthis.type = type;\n\t\tthis.indexConfig = indexConfig;\n\t}\n\n\tname: string | undefined;\n\tkeyAsName: boolean;\n\ttype: string;\n\tindexConfig: IndexedExtraConfigType;\n}\n\nexport type AnyPgColumn<\n\tTPartial extends Partial<PgColumnBaseConfig<ColumnType>> = {},\n> = PgColumn<\n\tany,\n\tRequired<Update<PgColumnBaseConfig<ColumnType>, TPartial>>\n>;\n"],"mappings":"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"}
+{"version":3,"file":"common.js","names":[],"sources":["../../../src/pg-core/columns/common.ts"],"sourcesContent":["import type { ColumnType, GeneratedColumnConfig, GeneratedIdentityConfig } from '~/column-builder.ts';\nimport { Column } from '~/column.ts';\nimport { entityKind } from '~/entity.ts';\nimport type { ForeignKey, UpdateDeleteAction } from '~/pg-core/foreign-keys.ts';\nimport { ForeignKeyBuilder } from '~/pg-core/foreign-keys.ts';\nimport type { AnyPgTable, PgTable } from '~/pg-core/table.ts';\nimport type { SQL } from '~/sql/sql.ts';\nimport { iife } from '~/tracing-utils.ts';\nimport type { Update } from '~/utils.ts';\nimport type { PostgresType } from '../codecs.ts';\nimport type { PgIndexOpClass } from '../indexes.ts';\n\nexport type PgArrayDimension = 0 | 1 | 2 | 3 | 4 | 5;\ntype PgArrayDimensionString = '[]' | '[][]' | '[][][]' | '[][][][]' | '[][][][][]';\n\ntype ArrayDimensionStringToNumber<T extends PgArrayDimensionString> = T extends '[]' ? 1\n\t: T extends '[][]' ? 2\n\t: T extends '[][][]' ? 3\n\t: T extends '[][][][]' ? 4\n\t: T extends '[][][][][]' ? 5\n\t: never;\n\nexport interface PgColumnBuilderConfig {\n\tdataType: ColumnType;\n\tdata: unknown;\n\tdriverParam: unknown;\n\t// Optional - set via chain methods\n\tnotNull?: boolean;\n\thasDefault?: boolean;\n\tisPrimaryKey?: boolean;\n\tisAutoincrement?: boolean;\n\thasRuntimeDefault?: boolean;\n\tenumValues?: string[];\n\tidentity?: 'always' | 'byDefault';\n\tgenerated?: unknown;\n\tdimensions?: PgArrayDimension;\n\t$type?: unknown;\n}\n\nexport interface PgColumnBuilderRuntimeConfig<TData> {\n\tname: string;\n\tkeyAsName: boolean;\n\tnotNull: boolean;\n\tdefault: TData | SQL | undefined;\n\tdefaultFn: (() => TData | SQL) | undefined;\n\tonUpdateFn: (() => TData | SQL) | undefined;\n\thasDefault: boolean;\n\tprimaryKey: boolean;\n\tisUnique: boolean;\n\tuniqueName: string | undefined;\n\tuniqueType: string | undefined;\n\tdataType: string;\n\tcolumnType: string;\n\tgenerated: GeneratedColumnConfig<TData> | undefined;\n\tgeneratedIdentity: GeneratedIdentityConfig | undefined;\n\tdimensions?: PgArrayDimension;\n}\n\n// TODO: remove isAutoincrement and hasRuntimeDefault\nexport interface PgColumnBaseConfig<out TDataType extends ColumnType = ColumnType> {\n\tname: string;\n\tdataType: TDataType;\n\ttableName: string;\n\tnotNull: boolean;\n\thasDefault: boolean;\n\tisPrimaryKey: boolean;\n\tisAutoincrement: boolean;\n\thasRuntimeDefault: boolean;\n\tdata: unknown;\n\tdriverParam: unknown;\n\tenumValues: string[] | undefined;\n\tgenerated: unknown;\n\tidentity: undefined | 'always' | 'byDefault';\n}\n\ntype WrapArray<T, N extends number> = N extends 1 ? T[]\n\t: N extends 2 ? T[][]\n\t: N extends 3 ? T[][][]\n\t: N extends 4 ? T[][][][]\n\t: N extends 5 ? T[][][][][]\n\t: T;\n\nexport type SetNotNull<T> = T & { readonly _: { notNull: true } };\nexport type SetHasDefault<T> = T & { readonly _: { hasDefault: true } };\nexport type SetIsPrimaryKey<T> = T & { readonly _: { isPrimaryKey: true; notNull: true } };\nexport type SetHasRuntimeDefault<T> = T & {\n\treadonly _: { hasRuntimeDefault: true; hasDefault: true };\n};\nexport type Set$Type<T, TType> = T & { readonly _: { $type: TType } };\nexport type SetHasGenerated<T> = T & {\n\treadonly _: { hasDefault: true; generated: true };\n};\nexport type SetDimensions<T, TDim extends PgArrayDimension> = T & {\n\treadonly _: { dimensions: TDim };\n};\nexport type SetIdentity<T, TType extends 'always' | 'byDefault'> = T & {\n\treadonly _: { notNull: true; hasDefault: true; identity: TType };\n};\n\nexport type HasIdentity<T, TType extends 'always' | 'byDefault'> = SetIdentity<T, TType>;\n\ntype GetBaseData<T> = T extends { $type: infer U } ? U : T extends { data: infer D } ? D : unknown;\n\nexport type ResolvePgColumnConfig<\n\tout T extends PgColumnBuilderConfig,\n\tout TTableName extends string,\n\tout TData = T['dimensions'] extends 1 | 2 | 3 | 4 | 5 ? WrapArray<GetBaseData<T>, T['dimensions']>\n\t\t: GetBaseData<T>,\n> = {\n\tname: string;\n\ttableName: TTableName;\n\tdataType: T['dataType'];\n\tdata: TData;\n\tdriverParam: T['dimensions'] extends 1 | 2 | 3 | 4 | 5 ? WrapArray<T['driverParam'], T['dimensions']> | string\n\t\t: T['driverParam'];\n\tnotNull: T['notNull'] extends true ? true : false;\n\thasDefault: T['hasDefault'] extends true ? true : false;\n\tisPrimaryKey: false;\n\tisAutoincrement: false;\n\thasRuntimeDefault: false;\n\tenumValues: T extends { enumValues: infer E extends string[] } ? E : undefined;\n\tidentity: T['identity'] extends 'always' | 'byDefault' ? T['identity'] : undefined;\n\tgenerated: T['generated'] extends true ? true : undefined;\n} & {};\n\nexport interface AnyPgColumnBuilder {\n\treadonly _: PgColumnBuilderConfig;\n}\n\nexport type PgBuildColumn<\n\tTTableName extends string,\n\tTBuilder extends AnyPgColumnBuilder,\n\tTBuiltConfig extends PgColumnBaseConfig<ColumnType> = ResolvePgColumnConfig<\n\t\tTBuilder['_'],\n\t\tTTableName\n\t>,\n> = PgColumn<ColumnType, TBuiltConfig, {}>;\n\nexport type PgBuildColumns<\n\tout TTableName extends string,\n\tout TConfigMap extends Record<string, AnyPgColumnBuilder>,\n> =\n\t& {\n\t\t[Key in keyof TConfigMap]: PgBuildColumn<TTableName, TConfigMap[Key]>;\n\t}\n\t& {};\n\nexport type PgBuildExtraConfigColumns<\n\tout TConfigMap extends Record<string, AnyPgColumnBuilder>,\n> =\n\t& {\n\t\t[Key in keyof TConfigMap]: ExtraConfigColumn;\n\t}\n\t& {};\n\nexport type PgColumns = Record<string, PgColumn>;\n\nexport interface ReferenceConfig {\n\tref: () => PgColumn;\n\tconfig: {\n\t\tname?: string;\n\t\tonUpdate?: UpdateDeleteAction;\n\t\tonDelete?: UpdateDeleteAction;\n\t};\n}\n\nexport abstract class PgColumnBuilder<\n\tout T extends PgColumnBuilderConfig = PgColumnBuilderConfig,\n\tout TRuntimeConfig extends object = object,\n> {\n\tstatic readonly [entityKind]: string = 'PgColumnBuilder';\n\n\tdeclare readonly _: T;\n\n\tprivate foreignKeyConfigs: ReferenceConfig[] = [];\n\n\tprotected config: PgColumnBuilderRuntimeConfig<T['data']> & TRuntimeConfig;\n\n\tconstructor(name: string, dataType: ColumnType, columnType: string) {\n\t\tthis.config = {\n\t\t\tname,\n\t\t\tkeyAsName: name === '',\n\t\t\tnotNull: false,\n\t\t\tdefault: undefined,\n\t\t\thasDefault: false,\n\t\t\tprimaryKey: false,\n\t\t\tisUnique: false,\n\t\t\tuniqueName: undefined,\n\t\t\tuniqueType: undefined,\n\t\t\tdataType,\n\t\t\tcolumnType,\n\t\t\tgenerated: undefined,\n\t\t\tdefaultFn: undefined,\n\t\t\tonUpdateFn: undefined,\n\t\t\tgeneratedIdentity: undefined,\n\t\t} as PgColumnBuilderRuntimeConfig<T['data']> & TRuntimeConfig;\n\t}\n\n\t/**\n\t * Changes the data type of the column. Commonly used with `json` columns. Also, useful for branded types.\n\t *\n\t * @example\n\t * ```ts\n\t * const users = pgTable('users', {\n\t * \tid: integer('id').$type<UserId>().primaryKey(),\n\t * \tdetails: json('details').$type<UserDetails>().notNull(),\n\t * });\n\t * ```\n\t */\n\t$type<TType>(): Set$Type<this, TType> {\n\t\treturn this as Set$Type<this, TType>;\n\t}\n\n\t/**\n\t * Adds a `not null` clause to the column definition.\n\t *\n\t * Affects the `select` model of the table - columns *without* `not null` will be nullable on select.\n\t */\n\tnotNull(): SetNotNull<this> {\n\t\tthis.config.notNull = true;\n\t\treturn this as SetNotNull<this>;\n\t}\n\n\t/**\n\t * Adds a `default <value>` clause to the column definition.\n\t *\n\t * Affects the `insert` model of the table - columns *with* `default` are optional on insert.\n\t *\n\t * If you need to set a dynamic default value, use {@link $defaultFn} instead.\n\t */\n\tdefault(\n\t\tvalue:\n\t\t\t| (this['_'] extends { dimensions: 1 | 2 | 3 | 4 | 5 } ? WrapArray<\n\t\t\t\t\tthis['_'] extends { $type: infer U } ? U : this['_']['data'],\n\t\t\t\t\tthis['_']['dimensions']\n\t\t\t\t>\n\t\t\t\t: this['_'] extends { $type: infer U } ? U\n\t\t\t\t: this['_']['data'])\n\t\t\t| SQL,\n\t): SetHasDefault<this> {\n\t\tthis.config.default = value;\n\t\tthis.config.hasDefault = true;\n\t\treturn this as SetHasDefault<this>;\n\t}\n\n\t/**\n\t * Adds a dynamic default value to the column.\n\t * The function will be called when the row is inserted, and the returned value will be used as the column value.\n\t *\n\t * **Note:** This value does not affect the `drizzle-kit` behavior, it is only used at runtime in `drizzle-orm`.\n\t */\n\t$defaultFn(\n\t\tfn: () =>\n\t\t\t| (this['_'] extends { dimensions: 1 | 2 | 3 | 4 | 5 } ? WrapArray<\n\t\t\t\t\tthis['_'] extends { $type: infer U } ? U : this['_']['data'],\n\t\t\t\t\tthis['_']['dimensions']\n\t\t\t\t>\n\t\t\t\t: this['_'] extends { $type: infer U } ? U\n\t\t\t\t: this['_']['data'])\n\t\t\t| SQL,\n\t): SetHasRuntimeDefault<this> {\n\t\tthis.config.defaultFn = fn;\n\t\tthis.config.hasDefault = true;\n\t\treturn this as SetHasRuntimeDefault<this>;\n\t}\n\n\t/**\n\t * Alias for {@link $defaultFn}.\n\t */\n\t$default = this.$defaultFn;\n\n\t/**\n\t * Adds a dynamic update value to the column.\n\t * The function will be called when the row is updated, and the returned value will be used as the column value if none is provided.\n\t * If no `default` (or `$defaultFn`) value is provided, the function will be called when the row is inserted as well, and the returned value will be used as the column value.\n\t *\n\t * **Note:** This value does not affect the `drizzle-kit` behavior, it is only used at runtime in `drizzle-orm`.\n\t */\n\t$onUpdateFn(\n\t\tfn: () =>\n\t\t\t| (this['_'] extends { dimensions: 1 | 2 | 3 | 4 | 5 } ? WrapArray<\n\t\t\t\t\tthis['_'] extends { $type: infer U } ? U : this['_']['data'],\n\t\t\t\t\tthis['_']['dimensions']\n\t\t\t\t>\n\t\t\t\t: this['_'] extends { $type: infer U } ? U\n\t\t\t\t: this['_']['data'])\n\t\t\t| SQL,\n\t): SetHasDefault<this> {\n\t\tthis.config.onUpdateFn = fn;\n\t\tthis.config.hasDefault = true;\n\t\treturn this as SetHasDefault<this>;\n\t}\n\n\t/**\n\t * Alias for {@link $onUpdateFn}.\n\t */\n\t$onUpdate = this.$onUpdateFn;\n\n\t/**\n\t * Adds a `primary key` clause to the column definition. This implicitly makes the column `not null`.\n\t *\n\t * In SQLite, `integer primary key` implicitly makes the column auto-incrementing.\n\t */\n\tprimaryKey(): SetIsPrimaryKey<this> {\n\t\tthis.config.primaryKey = true;\n\t\tthis.config.notNull = true;\n\t\treturn this as SetIsPrimaryKey<this>;\n\t}\n\n\t/** @internal Sets the name of the column to the key within the table definition if a name was not given. */\n\tsetName(name: string) {\n\t\tif (this.config.name !== '') return;\n\t\tthis.config.name = name;\n\t}\n\n\t/**\n\t * Makes this column a PostgreSQL array column.\n\t *\n\t * @example\n\t * ```ts\n\t * const t = pgTable('t', {\n\t *   // 1D array: number[]\n\t *   tags: integer().array(),\n\t *   // Or explicitly: integer().array('[]')\n\t *   // 2D array: number[][]\n\t *   matrix: integer().array('[][]'),\n\t * });\n\t * ```\n\t */\n\tarray(): SetDimensions<this, 1>;\n\tarray<TDim extends PgArrayDimensionString>(\n\t\tdimensions: TDim,\n\t): SetDimensions<this, ArrayDimensionStringToNumber<TDim>>;\n\tarray<TDim extends PgArrayDimensionString>(\n\t\tdimensions?: TDim,\n\t): SetDimensions<this, ArrayDimensionStringToNumber<TDim>> {\n\t\t// Calculate dimensions as number from string notation\n\t\tconst dim = dimensions ?? '[]';\n\t\t(this.config as any).dimensions = (dim.length / 2) as PgArrayDimension;\n\t\treturn this as SetDimensions<this, ArrayDimensionStringToNumber<TDim>>;\n\t}\n\n\treferences(\n\t\tref: ReferenceConfig['ref'],\n\t\tconfig: ReferenceConfig['config'] = {},\n\t): this {\n\t\tthis.foreignKeyConfigs.push({ ref, config });\n\t\treturn this;\n\t}\n\n\tunique(\n\t\tname?: string,\n\t\tconfig?: { nulls: 'distinct' | 'not distinct' },\n\t): this {\n\t\tthis.config.isUnique = true;\n\t\tthis.config.uniqueName = name;\n\t\tthis.config.uniqueType = config?.nulls;\n\t\treturn this;\n\t}\n\n\tgeneratedAlwaysAs(\n\t\tas:\n\t\t\t| SQL\n\t\t\t| (() => SQL),\n\t): SetHasGenerated<this> {\n\t\tthis.config.generated = {\n\t\t\tas,\n\t\t\ttype: 'always',\n\t\t\tmode: 'stored',\n\t\t};\n\t\treturn this as SetHasGenerated<this>;\n\t}\n\n\t/** @internal */\n\tbuildForeignKeys(column: PgColumn, table: PgTable): ForeignKey[] {\n\t\treturn this.foreignKeyConfigs.map(({ ref, config }) => {\n\t\t\treturn iife(\n\t\t\t\t(ref, config) => {\n\t\t\t\t\tconst builder = new ForeignKeyBuilder(() => {\n\t\t\t\t\t\tconst foreignColumn = ref();\n\t\t\t\t\t\treturn { name: config.name, columns: [column], foreignColumns: [foreignColumn] };\n\t\t\t\t\t});\n\t\t\t\t\tif (config.onUpdate) {\n\t\t\t\t\t\tbuilder.onUpdate(config.onUpdate);\n\t\t\t\t\t}\n\t\t\t\t\tif (config.onDelete) {\n\t\t\t\t\t\tbuilder.onDelete(config.onDelete);\n\t\t\t\t\t}\n\t\t\t\t\treturn builder.build(table);\n\t\t\t\t},\n\t\t\t\tref,\n\t\t\t\tconfig,\n\t\t\t);\n\t\t});\n\t}\n\n\t/** @internal */\n\tabstract build(table: PgTable): PgColumn<any>;\n\n\t/** @internal */\n\tbuildExtraConfigColumn<TTableName extends string>(\n\t\ttable: AnyPgTable<{ name: TTableName }>,\n\t): ExtraConfigColumn {\n\t\treturn new ExtraConfigColumn(table, { ...this.config, dimensions: (this.config as any).dimensions ?? 0 });\n\t}\n}\n\n// TODO: we should potenitally do column to be\n// in charge of map value/array of values/json value and json array of values in 1 place\nexport abstract class PgColumn<\n\tout TColumnType extends ColumnType = any,\n\tout T extends PgColumnBaseConfig<TColumnType> = PgColumnBaseConfig<TColumnType>,\n\tout TRuntimeConfig extends object = {},\n> extends Column<T, TRuntimeConfig> {\n\tstatic override readonly [entityKind]: string = 'PgColumn';\n\n\t/** @internal */\n\tabstract override readonly useCodecType?: PostgresType;\n\n\t/** @internal */\n\toverride readonly table: PgTable;\n\n\treadonly dimensions: PgArrayDimension;\n\n\tconstructor(\n\t\ttable: PgTable,\n\t\tconfig: PgColumnBuilderRuntimeConfig<T['data']> & TRuntimeConfig,\n\t) {\n\t\tsuper(table, config);\n\t\tthis.table = table;\n\t\tthis.dimensions = config.dimensions ?? 0;\n\t}\n\n\t/** @internal */\n\toverride postBuild() {\n\t\tif (this.dimensions) {\n\t\t\tconst originalFromDriver = this.mapFromDriverValue.bind(this);\n\t\t\tconst originalToDriver = this.mapToDriverValue.bind(this);\n\n\t\t\tthis.mapFromDriverValue = this.mapFromDriverValue.isNoop\n\t\t\t\t? this.mapFromDriverValue\n\t\t\t\t: (value: unknown): unknown => {\n\t\t\t\t\treturn this.mapArrayElements(value, originalFromDriver, this.dimensions);\n\t\t\t\t};\n\n\t\t\tthis.mapToDriverValue = this.mapToDriverValue.isNoop\n\t\t\t\t? this.mapToDriverValue\n\t\t\t\t: (value: unknown): unknown => {\n\t\t\t\t\treturn this.mapArrayElements(value as unknown[], originalToDriver, this.dimensions);\n\t\t\t\t};\n\t\t}\n\n\t\treturn this;\n\t}\n\n\t/** @internal */\n\tprivate mapArrayElements(value: unknown, mapper: (v: unknown) => unknown, depth: number): unknown {\n\t\tif (depth > 0 && Array.isArray(value)) {\n\t\t\treturn value.map((v) => v === null ? null : this.mapArrayElements(v, mapper, depth - 1));\n\t\t}\n\t\treturn mapper(value);\n\t}\n}\n\nexport type IndexedExtraConfigType = { order?: 'asc' | 'desc'; nulls?: 'first' | 'last'; opClass?: string };\n\nexport class ExtraConfigColumn<\n\tout T extends PgColumnBaseConfig<ColumnType> = PgColumnBaseConfig<ColumnType>,\n> extends PgColumn<ColumnType, T, IndexedExtraConfigType> {\n\tstatic override readonly [entityKind]: string = 'ExtraConfigColumn';\n\n\t/** @itnernal */\n\toverride readonly useCodecType = undefined;\n\n\toverride getSQLType(): string {\n\t\treturn this.getSQLType();\n\t}\n\n\tindexConfig: IndexedExtraConfigType = {\n\t\torder: this.config.order ?? 'asc',\n\t\tnulls: this.config.nulls ?? 'last',\n\t\topClass: this.config.opClass,\n\t};\n\tdefaultConfig: IndexedExtraConfigType = {\n\t\torder: 'asc',\n\t\tnulls: 'last',\n\t\topClass: undefined,\n\t};\n\n\tasc(): Omit<this, 'asc' | 'desc'> {\n\t\tthis.indexConfig.order = 'asc';\n\t\treturn this;\n\t}\n\n\tdesc(): Omit<this, 'asc' | 'desc'> {\n\t\tthis.indexConfig.order = 'desc';\n\t\treturn this;\n\t}\n\n\tnullsFirst(): Omit<this, 'nullsFirst' | 'nullsLast'> {\n\t\tthis.indexConfig.nulls = 'first';\n\t\treturn this;\n\t}\n\n\tnullsLast(): Omit<this, 'nullsFirst' | 'nullsLast'> {\n\t\tthis.indexConfig.nulls = 'last';\n\t\treturn this;\n\t}\n\n\t/**\n\t * ### PostgreSQL documentation quote\n\t *\n\t * > An operator class with optional parameters can be specified for each column of an index.\n\t * The operator class identifies the operators to be used by the index for that column.\n\t * For example, a B-tree index on four-byte integers would use the int4_ops class;\n\t * this operator class includes comparison functions for four-byte integers.\n\t * In practice the default operator class for the column's data type is usually sufficient.\n\t * The main point of having operator classes is that for some data types, there could be more than one meaningful ordering.\n\t * For example, we might want to sort a complex-number data type either by absolute value or by real part.\n\t * We could do this by defining two operator classes for the data type and then selecting the proper class when creating an index.\n\t * More information about operator classes check:\n\t *\n\t * ### Useful links\n\t * https://www.postgresql.org/docs/current/sql-createindex.html\n\t *\n\t * https://www.postgresql.org/docs/current/indexes-opclass.html\n\t *\n\t * https://www.postgresql.org/docs/current/xindex.html\n\t *\n\t * ### Additional types\n\t * If you have the `pg_vector` extension installed in your database, you can use the\n\t * `vector_l2_ops`, `vector_ip_ops`, `vector_cosine_ops`, `vector_l1_ops`, `bit_hamming_ops`, `bit_jaccard_ops`, `halfvec_l2_ops`, `sparsevec_l2_ops` options, which are predefined types.\n\t *\n\t * **You can always specify any string you want in the operator class, in case Drizzle doesn't have it natively in its types**\n\t *\n\t * @param opClass\n\t * @returns\n\t */\n\top(opClass: PgIndexOpClass): Omit<this, 'op'> {\n\t\tthis.indexConfig.opClass = opClass;\n\t\treturn this;\n\t}\n}\n\nexport class IndexedColumn {\n\tstatic readonly [entityKind]: string = 'IndexedColumn';\n\tconstructor(\n\t\tname: string | undefined,\n\t\tkeyAsName: boolean,\n\t\ttype: string,\n\t\tindexConfig: IndexedExtraConfigType,\n\t) {\n\t\tthis.name = name;\n\t\tthis.keyAsName = keyAsName;\n\t\tthis.type = type;\n\t\tthis.indexConfig = indexConfig;\n\t}\n\n\tname: string | undefined;\n\tkeyAsName: boolean;\n\ttype: string;\n\tindexConfig: IndexedExtraConfigType;\n}\n\nexport type AnyPgColumn<\n\tTPartial extends Partial<PgColumnBaseConfig<ColumnType>> = {},\n> = PgColumn<\n\tany,\n\tRequired<Update<PgColumnBaseConfig<ColumnType>, TPartial>>\n>;\n"],"mappings":"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"}

package/pg-core/columns/custom.cjs

@@ -1,7 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
-const require_pg_core_utils_array = require('../utils/array.cjs');
 const require_pg_core_columns_common = require('./common.cjs');
+const require_pg_core_array = require('../array.cjs');
+const require_pg_core_codecs = require('../codecs.cjs');
 let __entity_ts = require("../../entity.cjs");
 let __utils_ts = require("../../utils.cjs");
 
@@ -20,30 +21,24 @@ var PgCustomColumnBuilder = class extends require_pg_core_columns_common.PgColum
 };
 var PgCustomColumn = class extends require_pg_core_columns_common.PgColumn {
 	static [__entity_ts.entityKind] = "PgCustomColumn";
+	/** @internal */
+	useCodecType;
 	sqlName;
-	mapTo;
-	mapFrom;
-	mapJson;
-	forJsonSelect;
+	mapFromJsonValue;
+	jsonSelectIdentifier;
 	constructor(table, config) {
 		super(table, config);
 		this.sqlName = config.customTypeParams.dataType(config.fieldConfig);
-		this.mapTo = config.customTypeParams.toDriver;
-		this.mapFrom = config.customTypeParams.fromDriver;
-		this.mapJson = config.customTypeParams.fromJson;
-		this.forJsonSelect = config.customTypeParams.forJsonSelect;
-		if (this.dimensions) {
-			const elementMapper = (value) => {
-				if (typeof this.mapJson === "function") return this.mapJson(value);
-				if (typeof this.mapFrom === "function") return this.mapFrom(value);
-				return value;
-			};
-			this.mapFromJsonValue = (value) => {
-				if (value === null) return value;
-				const arr = typeof value === "string" ? require_pg_core_utils_array.parsePgArray(value) : value;
-				return this.mapJsonArrayElements(arr, elementMapper, this.dimensions);
-			};
-		}
+		this.mapToDriverValue = config.customTypeParams.toDriver ?? this.mapToDriverValue;
+		this.mapFromDriverValue = config.customTypeParams.fromDriver ?? this.mapFromDriverValue;
+		this.mapFromJsonValue = config.customTypeParams.fromJson;
+		this.jsonSelectIdentifier = config.customTypeParams.forJsonSelect;
+		this.useCodecType = require_pg_core_codecs.resolvePgType(config.customTypeParams.codec ?? this.sqlName.slice(0, Math.min(...[this.sqlName.indexOf("("), this.sqlName.indexOf("[")].filter((e) => e !== -1))));
+		if (this.dimensions && config.customTypeParams.fromJson) this.mapFromJsonValue = (value) => {
+			if (value === null) return value;
+			const arr = typeof value === "string" ? require_pg_core_array.parsePgArray(value) : value;
+			return this.mapJsonArrayElements(arr, config.customTypeParams.fromJson, this.dimensions);
+		};
 	}
 	/** @internal */
 	mapJsonArrayElements(value, mapper, depth) {
@@ -53,31 +48,6 @@ var PgCustomColumn = class extends require_pg_core_columns_common.PgColumn {
 	getSQLType() {
 		return this.sqlName;
 	}
-	mapFromDriverValue(value) {
-		return typeof this.mapFrom === "function" ? this.mapFrom(value) : value;
-	}
-	mapFromJsonValue(value) {
-		return typeof this.mapJson === "function" ? this.mapJson(value) : this.mapFromDriverValue(value);
-	}
-	jsonSelectIdentifier(identifier, sql, arrayDimensions) {
-		if (typeof this.forJsonSelect === "function") return this.forJsonSelect(identifier, sql, arrayDimensions);
-		const rawType = this.getSQLType().toLowerCase();
-		const parenPos = rawType.indexOf("(");
-		switch (parenPos + 1 ? rawType.slice(0, parenPos) : rawType) {
-			case "bytea":
-			case "geometry":
-			case "timestamp":
-			case "numeric":
-			case "bigint": {
-				const arrVal = "[]".repeat(arrayDimensions ?? 0);
-				return sql`${identifier}::text${sql.raw(arrVal).if(arrayDimensions)}`;
-			}
-			default: return identifier;
-		}
-	}
-	mapToDriverValue(value) {
-		return typeof this.mapTo === "function" ? this.mapTo(value) : value;
-	}
 };
 /**
 * Custom pg database data type generator

package/pg-core/columns/custom.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"custom.cjs","names":["PgColumnBuilder","entityKind","PgColumn","parsePgArray"],"sources":["../../../src/pg-core/columns/custom.ts"],"sourcesContent":["import type { ColumnBuilderBaseConfig } from '~/column-builder.ts';\nimport { entityKind } from '~/entity.ts';\nimport type { PgTable } from '~/pg-core/table.ts';\nimport type { SQL, SQLGenerator } from '~/sql/sql.ts';\nimport { type Equal, getColumnNameAndConfig } from '~/utils.ts';\nimport { parsePgArray } from '../utils/array.ts';\nimport { PgColumn, PgColumnBuilder } from './common.ts';\n\nexport type ConvertCustomConfig<T extends Partial<CustomTypeValues>> =\n\t& {\n\t\tdataType: 'custom';\n\t\tdata: T['data'];\n\t\tdriverParam: T['driverData'];\n\t}\n\t& (T['notNull'] extends true ? { notNull: true } : {})\n\t& (T['default'] extends true ? { hasDefault: true } : {});\n\nexport interface PgCustomColumnInnerConfig {\n\tcustomTypeValues: CustomTypeValues;\n}\n\nexport class PgCustomColumnBuilder<T extends ColumnBuilderBaseConfig<'custom'>> extends PgColumnBuilder<\n\tT,\n\t{\n\t\tfieldConfig: CustomTypeValues['config'];\n\t\tcustomTypeParams: CustomTypeParams<any>;\n\t}\n> {\n\tstatic override readonly [entityKind]: string = 'PgCustomColumnBuilder';\n\n\tconstructor(\n\t\tname: string,\n\t\tfieldConfig: CustomTypeValues['config'],\n\t\tcustomTypeParams: CustomTypeParams<any>,\n\t) {\n\t\tsuper(name, 'custom', 'PgCustomColumn');\n\t\tthis.config.fieldConfig = fieldConfig;\n\t\tthis.config.customTypeParams = customTypeParams;\n\t}\n\n\t/** @internal */\n\toverride build(table: PgTable<any>) {\n\t\treturn new PgCustomColumn(\n\t\t\ttable,\n\t\t\tthis.config as any,\n\t\t);\n\t}\n}\n\nexport class PgCustomColumn<T extends ColumnBuilderBaseConfig<'custom'>> extends PgColumn<'custom'> {\n\tstatic override readonly [entityKind]: string = 'PgCustomColumn';\n\n\tprivate sqlName: string;\n\tprivate mapTo?: (value: T['data']) => T['driverParam'];\n\tprivate mapFrom?: (value: T['driverParam']) => T['data'];\n\tprivate mapJson?: (value: unknown) => T['data'];\n\tprivate forJsonSelect?: (identifier: SQL, sql: SQLGenerator, arrayDimensions?: number) => SQL;\n\n\tconstructor(\n\t\ttable: PgTable<any>,\n\t\tconfig: PgCustomColumnBuilder<T>['config'],\n\t) {\n\t\tsuper(table, config as any);\n\t\tthis.sqlName = config.customTypeParams.dataType(config.fieldConfig);\n\t\tthis.mapTo = config.customTypeParams.toDriver;\n\t\tthis.mapFrom = config.customTypeParams.fromDriver;\n\t\tthis.mapJson = config.customTypeParams.fromJson;\n\t\tthis.forJsonSelect = config.customTypeParams.forJsonSelect;\n\n\t\t// Wrap mapFromJsonValue with array handling if this is an array column\n\t\tif (this.dimensions) {\n\t\t\t// Create a mapper function that handles a single element\n\t\t\t// This uses the raw mapJson or mapFrom functions, not the wrapped mapFromDriverValue\n\t\t\tconst elementMapper = (value: unknown): unknown => {\n\t\t\t\tif (typeof this.mapJson === 'function') {\n\t\t\t\t\treturn this.mapJson(value);\n\t\t\t\t}\n\t\t\t\tif (typeof this.mapFrom === 'function') {\n\t\t\t\t\treturn this.mapFrom(value as T['driverParam']);\n\t\t\t\t}\n\t\t\t\treturn value;\n\t\t\t};\n\n\t\t\tthis.mapFromJsonValue = (value: unknown): unknown => {\n\t\t\t\tif (value === null) return value;\n\t\t\t\t// Parse string representation if needed\n\t\t\t\tconst arr = typeof value === 'string' ? parsePgArray(value) : value as unknown[];\n\t\t\t\treturn this.mapJsonArrayElements(arr, elementMapper, this.dimensions);\n\t\t\t};\n\t\t}\n\t}\n\n\t/** @internal */\n\tprivate mapJsonArrayElements(value: unknown, mapper: (v: unknown) => unknown, depth: number): unknown {\n\t\tif (depth > 0 && Array.isArray(value)) {\n\t\t\treturn value.map((v) => v === null ? null : this.mapJsonArrayElements(v, mapper, depth - 1));\n\t\t}\n\t\treturn mapper(value);\n\t}\n\n\tgetSQLType(): string {\n\t\treturn this.sqlName;\n\t}\n\n\toverride mapFromDriverValue(value: T['driverParam']): T['data'] {\n\t\treturn typeof this.mapFrom === 'function' ? this.mapFrom(value) : value as T['data'];\n\t}\n\n\tmapFromJsonValue(value: unknown): T['data'] {\n\t\treturn typeof this.mapJson === 'function' ? this.mapJson(value) : this.mapFromDriverValue(value) as T['data'];\n\t}\n\n\tjsonSelectIdentifier(identifier: SQL, sql: SQLGenerator, arrayDimensions?: number): SQL {\n\t\tif (typeof this.forJsonSelect === 'function') return this.forJsonSelect(identifier, sql, arrayDimensions);\n\n\t\tconst rawType = this.getSQLType().toLowerCase();\n\t\tconst parenPos = rawType.indexOf('(');\n\t\tconst type = (parenPos + 1) ? rawType.slice(0, parenPos) : rawType;\n\n\t\tswitch (type) {\n\t\t\tcase 'bytea':\n\t\t\tcase 'geometry':\n\t\t\tcase 'timestamp':\n\t\t\tcase 'numeric':\n\t\t\tcase 'bigint': {\n\t\t\t\tconst arrVal = '[]'.repeat(arrayDimensions ?? 0);\n\n\t\t\t\treturn sql`${identifier}::text${sql.raw(arrVal).if(arrayDimensions)}`;\n\t\t\t}\n\t\t\tdefault: {\n\t\t\t\treturn identifier;\n\t\t\t}\n\t\t}\n\t}\n\n\toverride mapToDriverValue(value: T['data']): T['driverParam'] {\n\t\treturn typeof this.mapTo === 'function' ? this.mapTo(value) : value as T['data'];\n\t}\n}\n\nexport interface CustomTypeValues {\n\t/**\n\t * Required type for custom column, that will infer proper type model\n\t *\n\t * Examples:\n\t *\n\t * If you want your column to be `string` type after selecting/or on inserting - use `data: string`. Like `text`, `varchar`\n\t *\n\t * If you want your column to be `number` type after selecting/or on inserting - use `data: number`. Like `integer`\n\t */\n\tdata: unknown;\n\n\t/**\n\t * Type helper, that represents what type database driver is accepting for specific database data type\n\t */\n\tdriverData?: unknown;\n\n\t/**\n\t * Type helper, that represents what type database driver is returning for specific database data type\n\t *\n\t * Needed only in case driver's output and input for type differ\n\t *\n\t * Defaults to {@link driverData}\n\t */\n\tdriverOutput?: unknown;\n\n\t/**\n\t * Type helper, that represents what type field returns after being aggregated to JSON\n\t */\n\tjsonData?: unknown;\n\n\t/**\n\t * What config type should be used for {@link CustomTypeParams} `dataType` generation\n\t */\n\tconfig?: Record<string, any>;\n\n\t/**\n\t * Whether the config argument should be required or not\n\t * @default false\n\t */\n\tconfigRequired?: boolean;\n\n\t/**\n\t * If your custom data type should be notNull by default you can use `notNull: true`\n\t *\n\t * @example\n\t * const customSerial = customType<{ data: number, notNull: true, default: true }>({\n\t * \t  dataType() {\n\t * \t    return 'serial';\n\t *    },\n\t * });\n\t */\n\tnotNull?: boolean;\n\n\t/**\n\t * If your custom data type has default you can use `default: true`\n\t *\n\t * @example\n\t * const customSerial = customType<{ data: number, notNull: true, default: true }>({\n\t * \t  dataType() {\n\t * \t    return 'serial';\n\t *    },\n\t * });\n\t */\n\tdefault?: boolean;\n}\n\nexport interface CustomTypeParams<T extends CustomTypeValues> {\n\t/**\n\t * Database data type string representation, that is used for migrations\n\t * @example\n\t * ```\n\t * `jsonb`, `text`\n\t * ```\n\t *\n\t * If database data type needs additional params you can use them from `config` param\n\t * @example\n\t * ```\n\t * `varchar(256)`, `numeric(2,3)`\n\t * ```\n\t *\n\t * To make `config` be of specific type please use config generic in {@link CustomTypeValues}\n\t *\n\t * @example\n\t * Usage example\n\t * ```\n\t *   dataType() {\n\t *     return 'boolean';\n\t *   },\n\t * ```\n\t * Or\n\t * ```\n\t *   dataType(config) {\n\t * \t   return typeof config.length !== 'undefined' ? `varchar(${config.length})` : `varchar`;\n\t * \t }\n\t * ```\n\t */\n\tdataType: (config: T['config'] | (Equal<T['configRequired'], true> extends true ? never : undefined)) => string;\n\n\t/**\n\t * Optional mapping function, that is used to transform inputs from desired to be used in code format to one suitable for driver\n\t * @example\n\t * For example, when using jsonb we need to map JS/TS object to string before writing to database\n\t * ```\n\t * toDriver(value: TData): string {\n\t * \t return JSON.stringify(value);\n\t * }\n\t * ```\n\t */\n\ttoDriver?: (value: T['data']) => T['driverData'] | SQL;\n\n\t/**\n\t * Optional mapping function, that is used for transforming data returned by driver to desired column's output format\n\t * @example\n\t * For example, when using timestamp we need to map string Date representation to JS Date\n\t * ```\n\t * fromDriver(value: string): Date {\n\t * \treturn new Date(value);\n\t * }\n\t * ```\n\t *\n\t * It'll cause the returned data to change from:\n\t * ```\n\t * {\n\t * \tcustomField: \"2025-04-07T03:25:16.635Z\";\n\t * }\n\t * ```\n\t * to:\n\t * ```\n\t * {\n\t * \tcustomField: new Date(\"2025-04-07T03:25:16.635Z\");\n\t * }\n\t * ```\n\t */\n\tfromDriver?: (value: 'driverOutput' extends keyof T ? T['driverOutput'] : T['driverData']) => T['data'];\n\n\t/**\n\t * Optional mapping function, that is used for transforming data returned by transofmed to JSON in database data to desired format\n\t *\n\t * Used by [relational queries](https://orm.drizzle.team/docs/rqb-v2)\n\t *\n\t * Defaults to {@link fromDriver} function\n\t * @example\n\t * For example, when querying bigint column via [RQB](https://orm.drizzle.team/docs/rqb-v2) or [JSON functions](https://orm.drizzle.team/docs/json-functions), the result field will be returned as it's string representation, as opposed to bigint from regular query\n\t * To handle that, we need a separate function to handle such field's mapping:\n\t * ```\n\t * fromJson(value: string): bigint {\n\t * \treturn BigInt(value);\n\t * },\n\t * ```\n\t *\n\t * It'll cause the returned data to change from:\n\t * ```\n\t * {\n\t * \tcustomField: \"5044565289845416380\";\n\t * }\n\t * ```\n\t * to:\n\t * ```\n\t * {\n\t * \tcustomField: 5044565289845416380n;\n\t * }\n\t * ```\n\t */\n\tfromJson?: (value: T['jsonData']) => T['data'];\n\n\t/**\n\t * Optional selection modifier function, that is used for modifying selection of column inside [JSON functions](https://orm.drizzle.team/docs/json-functions)\n\t *\n\t * Additional mapping that could be required for such scenarios can be handled using {@link fromJson} function\n\t *\n\t * Used by [relational queries](https://orm.drizzle.team/docs/rqb-v2)\n\t *\n\t * Following types are being casted to text by default: `bytea`, `geometry`, `timestamp`, `numeric`, `bigint`\n\t * @example\n\t * For example, when using bigint we need to cast field to text to preserve data integrity\n\t * ```\n\t * forJsonSelect(identifier: SQL, sql: SQLGenerator, arrayDimensions?: number): SQL {\n\t * \treturn sql`${identifier}::text`\n\t * },\n\t * ```\n\t *\n\t * This will change query from:\n\t * ```\n\t * SELECT\n\t * \trow_to_json(\"t\".*)\n\t * \tFROM\n\t * \t(\n\t * \t\tSELECT\n\t * \t\t\"table\".\"custom_bigint\" AS \"bigint\"\n\t * \t\tFROM\n\t * \t\t\"table\"\n\t * \t) AS \"t\"\n\t * ```\n\t * to:\n\t * ```\n\t * SELECT\n\t * \trow_to_json(\"t\".*)\n\t * \tFROM\n\t * \t(\n\t * \t\tSELECT\n\t * \t\t\"table\".\"custom_bigint\"::text AS \"bigint\"\n\t * \t\tFROM\n\t * \t\t\"table\"\n\t * \t) AS \"t\"\n\t * ```\n\t *\n\t * Returned by query object will change from:\n\t * ```\n\t * {\n\t * \tbigint: 5044565289845416000; // Partial data loss due to direct conversion to JSON format\n\t * }\n\t * ```\n\t * to:\n\t * ```\n\t * {\n\t * \tbigint: \"5044565289845416380\"; // Data is preserved due to conversion of field to text before JSON-ification\n\t * }\n\t * ```\n\t */\n\tforJsonSelect?: (identifier: SQL, sql: SQLGenerator, arrayDimensions?: number) => SQL;\n}\n\n/**\n * Custom pg database data type generator\n */\nexport function customType<T extends CustomTypeValues = CustomTypeValues>(\n\tcustomTypeParams: CustomTypeParams<T>,\n): Equal<T['configRequired'], true> extends true ? {\n\t\t<TConfig extends Record<string, any> & T['config']>(\n\t\t\tfieldConfig: TConfig,\n\t\t): PgCustomColumnBuilder<ConvertCustomConfig<T>>;\n\t\t(\n\t\t\tdbName: string,\n\t\t\tfieldConfig: T['config'],\n\t\t): PgCustomColumnBuilder<ConvertCustomConfig<T>>;\n\t}\n\t: {\n\t\t<TConfig extends Record<string, any> & T['config']>(\n\t\t\tfieldConfig?: TConfig,\n\t\t): PgCustomColumnBuilder<ConvertCustomConfig<T>>;\n\t\t(\n\t\t\tdbName: string,\n\t\t\tfieldConfig?: T['config'],\n\t\t): PgCustomColumnBuilder<ConvertCustomConfig<T>>;\n\t}\n{\n\treturn (\n\t\ta?: string | T['config'],\n\t\tb?: T['config'],\n\t): PgCustomColumnBuilder<ConvertCustomConfig<T>> => {\n\t\tconst { name, config } = getColumnNameAndConfig<T['config']>(a, b);\n\t\treturn new PgCustomColumnBuilder(name, config, customTypeParams);\n\t};\n}\n"],"mappings":";;;;;;;;AAqBA,IAAa,wBAAb,cAAwFA,+CAMtF;CACD,QAA0BC,0BAAsB;CAEhD,YACC,MACA,aACA,kBACC;AACD,QAAM,MAAM,UAAU,iBAAiB;AACvC,OAAK,OAAO,cAAc;AAC1B,OAAK,OAAO,mBAAmB;;;CAIhC,AAAS,MAAM,OAAqB;AACnC,SAAO,IAAI,eACV,OACA,KAAK,OACL;;;AAIH,IAAa,iBAAb,cAAiFC,wCAAmB;CACnG,QAA0BD,0BAAsB;CAEhD,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,YACC,OACA,QACC;AACD,QAAM,OAAO,OAAc;AAC3B,OAAK,UAAU,OAAO,iBAAiB,SAAS,OAAO,YAAY;AACnE,OAAK,QAAQ,OAAO,iBAAiB;AACrC,OAAK,UAAU,OAAO,iBAAiB;AACvC,OAAK,UAAU,OAAO,iBAAiB;AACvC,OAAK,gBAAgB,OAAO,iBAAiB;AAG7C,MAAI,KAAK,YAAY;GAGpB,MAAM,iBAAiB,UAA4B;AAClD,QAAI,OAAO,KAAK,YAAY,WAC3B,QAAO,KAAK,QAAQ,MAAM;AAE3B,QAAI,OAAO,KAAK,YAAY,WAC3B,QAAO,KAAK,QAAQ,MAA0B;AAE/C,WAAO;;AAGR,QAAK,oBAAoB,UAA4B;AACpD,QAAI,UAAU,KAAM,QAAO;IAE3B,MAAM,MAAM,OAAO,UAAU,WAAWE,yCAAa,MAAM,GAAG;AAC9D,WAAO,KAAK,qBAAqB,KAAK,eAAe,KAAK,WAAW;;;;;CAMxE,AAAQ,qBAAqB,OAAgB,QAAiC,OAAwB;AACrG,MAAI,QAAQ,KAAK,MAAM,QAAQ,MAAM,CACpC,QAAO,MAAM,KAAK,MAAM,MAAM,OAAO,OAAO,KAAK,qBAAqB,GAAG,QAAQ,QAAQ,EAAE,CAAC;AAE7F,SAAO,OAAO,MAAM;;CAGrB,aAAqB;AACpB,SAAO,KAAK;;CAGb,AAAS,mBAAmB,OAAoC;AAC/D,SAAO,OAAO,KAAK,YAAY,aAAa,KAAK,QAAQ,MAAM,GAAG;;CAGnE,iBAAiB,OAA2B;AAC3C,SAAO,OAAO,KAAK,YAAY,aAAa,KAAK,QAAQ,MAAM,GAAG,KAAK,mBAAmB,MAAM;;CAGjG,qBAAqB,YAAiB,KAAmB,iBAA+B;AACvF,MAAI,OAAO,KAAK,kBAAkB,WAAY,QAAO,KAAK,cAAc,YAAY,KAAK,gBAAgB;EAEzG,MAAM,UAAU,KAAK,YAAY,CAAC,aAAa;EAC/C,MAAM,WAAW,QAAQ,QAAQ,IAAI;AAGrC,UAFc,WAAW,IAAK,QAAQ,MAAM,GAAG,SAAS,GAAG,SAE3D;GACC,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK,UAAU;IACd,MAAM,SAAS,KAAK,OAAO,mBAAmB,EAAE;AAEhD,WAAO,GAAG,GAAG,WAAW,QAAQ,IAAI,IAAI,OAAO,CAAC,GAAG,gBAAgB;;GAEpE,QACC,QAAO;;;CAKV,AAAS,iBAAiB,OAAoC;AAC7D,SAAO,OAAO,KAAK,UAAU,aAAa,KAAK,MAAM,MAAM,GAAG;;;;;;AAsOhE,SAAgB,WACf,kBAmBD;AACC,SACC,GACA,MACmD;EACnD,MAAM,EAAE,MAAM,kDAA+C,GAAG,EAAE;AAClE,SAAO,IAAI,sBAAsB,MAAM,QAAQ,iBAAiB"}
+{"version":3,"file":"custom.cjs","names":["PgColumnBuilder","entityKind","PgColumn","resolvePgType","parsePgArray"],"sources":["../../../src/pg-core/columns/custom.ts"],"sourcesContent":["import type { ColumnBuilderBaseConfig } from '~/column-builder.ts';\nimport { entityKind } from '~/entity.ts';\nimport type { PgTable } from '~/pg-core/table.ts';\nimport type { SQL, SQLGenerator } from '~/sql/sql.ts';\nimport { type Equal, getColumnNameAndConfig } from '~/utils.ts';\nimport { parsePgArray } from '../array.ts';\nimport { type PostgresColumnType, type PostgresType, resolvePgType } from '../codecs.ts';\nimport { PgColumn, PgColumnBuilder } from './common.ts';\n\nexport type ConvertCustomConfig<T extends Partial<CustomTypeValues>> =\n\t& {\n\t\tdataType: 'custom';\n\t\tdata: T['data'];\n\t\tdriverParam: T['driverData'];\n\t}\n\t& (T['notNull'] extends true ? { notNull: true } : {})\n\t& (T['default'] extends true ? { hasDefault: true } : {});\n\nexport interface PgCustomColumnInnerConfig {\n\tcustomTypeValues: CustomTypeValues;\n}\n\nexport class PgCustomColumnBuilder<T extends ColumnBuilderBaseConfig<'custom'>> extends PgColumnBuilder<\n\tT,\n\t{\n\t\tfieldConfig: CustomTypeValues['config'];\n\t\tcustomTypeParams: CustomTypeParams<any>;\n\t}\n> {\n\tstatic override readonly [entityKind]: string = 'PgCustomColumnBuilder';\n\n\tconstructor(\n\t\tname: string,\n\t\tfieldConfig: CustomTypeValues['config'],\n\t\tcustomTypeParams: CustomTypeParams<any>,\n\t) {\n\t\tsuper(name, 'custom', 'PgCustomColumn');\n\t\tthis.config.fieldConfig = fieldConfig;\n\t\tthis.config.customTypeParams = customTypeParams;\n\t}\n\n\t/** @internal */\n\toverride build(table: PgTable<any>) {\n\t\treturn new PgCustomColumn(\n\t\t\ttable,\n\t\t\tthis.config as any,\n\t\t);\n\t}\n}\n\nexport class PgCustomColumn<T extends ColumnBuilderBaseConfig<'custom'>> extends PgColumn<'custom'> {\n\tstatic override readonly [entityKind]: string = 'PgCustomColumn';\n\n\t/** @internal */\n\toverride readonly useCodecType: PostgresType;\n\n\tprivate sqlName: string;\n\treadonly mapFromJsonValue?: (value: unknown) => T['data'];\n\treadonly jsonSelectIdentifier?: (identifier: SQL, sql: SQLGenerator, arrayDimensions?: number) => SQL;\n\n\tconstructor(\n\t\ttable: PgTable<any>,\n\t\tconfig: PgCustomColumnBuilder<T>['config'],\n\t) {\n\t\tsuper(table, config as any);\n\t\tthis.sqlName = config.customTypeParams.dataType(config.fieldConfig);\n\t\tthis.mapToDriverValue = config.customTypeParams.toDriver ?? this.mapToDriverValue;\n\t\tthis.mapFromDriverValue = config.customTypeParams.fromDriver ?? this.mapFromDriverValue;\n\t\tthis.mapFromJsonValue = config.customTypeParams.fromJson;\n\t\tthis.jsonSelectIdentifier = config.customTypeParams.forJsonSelect;\n\t\tthis.useCodecType = resolvePgType(\n\t\t\tconfig.customTypeParams.codec\n\t\t\t\t?? this.sqlName.slice(\n\t\t\t\t\t0,\n\t\t\t\t\tMath.min(...[this.sqlName.indexOf('('), this.sqlName.indexOf('[')].filter((e) => e !== -1)),\n\t\t\t\t),\n\t\t);\n\n\t\tif (this.dimensions && config.customTypeParams.fromJson) {\n\t\t\tthis.mapFromJsonValue = (value: unknown): unknown => {\n\t\t\t\tif (value === null) return value;\n\t\t\t\tconst arr = typeof value === 'string' ? parsePgArray(value) : value as unknown[];\n\t\t\t\treturn this.mapJsonArrayElements(arr, config.customTypeParams.fromJson!, this.dimensions);\n\t\t\t};\n\t\t}\n\t}\n\n\t/** @internal */\n\tprivate mapJsonArrayElements(value: unknown, mapper: (v: unknown) => unknown, depth: number): unknown {\n\t\tif (depth > 0 && Array.isArray(value)) {\n\t\t\treturn value.map((v) => v === null ? null : this.mapJsonArrayElements(v, mapper, depth - 1));\n\t\t}\n\t\treturn mapper(value);\n\t}\n\n\tgetSQLType(): string {\n\t\treturn this.sqlName;\n\t}\n}\n\nexport interface CustomTypeValues {\n\t/**\n\t * Required type for custom column, that will infer proper type model\n\t *\n\t * Examples:\n\t *\n\t * If you want your column to be `string` type after selecting/or on inserting - use `data: string`. Like `text`, `varchar`\n\t *\n\t * If you want your column to be `number` type after selecting/or on inserting - use `data: number`. Like `integer`\n\t */\n\tdata: unknown;\n\n\t/**\n\t * Type helper, that represents what type database driver is accepting for specific database data type\n\t */\n\tdriverData?: unknown;\n\n\t/**\n\t * @deprecated Use codecs instead\n\t *\n\t * Type helper, that represents what type database driver is returning for specific database data type\n\t *\n\t * Needed only in case driver's output and input for type differ\n\t *\n\t * Defaults to {@link driverData}\n\t */\n\tdriverOutput?: unknown;\n\n\t/**\n\t * @deprecated Use codecs instead\n\t *\n\t * Type helper, that represents what type field returns after being aggregated to JSON\n\t */\n\tjsonData?: unknown;\n\n\t/**\n\t * What config type should be used for {@link CustomTypeParams} `dataType` generation\n\t */\n\tconfig?: Record<string, any>;\n\n\t/**\n\t * Whether the config argument should be required or not\n\t * @default false\n\t */\n\tconfigRequired?: boolean;\n\n\t/**\n\t * If your custom data type should be notNull by default you can use `notNull: true`\n\t *\n\t * @example\n\t * const customSerial = customType<{ data: number, notNull: true, default: true }>({\n\t * \t  dataType() {\n\t * \t    return 'serial';\n\t *    },\n\t * });\n\t */\n\tnotNull?: boolean;\n\n\t/**\n\t * If your custom data type has default you can use `default: true`\n\t *\n\t * @example\n\t * const customSerial = customType<{ data: number, notNull: true, default: true }>({\n\t * \t  dataType() {\n\t * \t    return 'serial';\n\t *    },\n\t * });\n\t */\n\tdefault?: boolean;\n}\n\nexport interface CustomTypeParams<T extends CustomTypeValues> {\n\t/**\n\t * Database data type string representation, that is used for migrations\n\t * @example\n\t * ```\n\t * `jsonb`, `text`\n\t * ```\n\t *\n\t * If database data type needs additional params you can use them from `config` param\n\t * @example\n\t * ```\n\t * `varchar(256)`, `numeric(2,3)`\n\t * ```\n\t *\n\t * To make `config` be of specific type please use config generic in {@link CustomTypeValues}\n\t *\n\t * @example\n\t * Usage example\n\t * ```\n\t *   dataType() {\n\t *     return 'boolean';\n\t *   },\n\t * ```\n\t * Or\n\t * ```\n\t *   dataType(config) {\n\t * \t   return typeof config.length !== 'undefined' ? `varchar(${config.length})` : `varchar`;\n\t * \t }\n\t * ```\n\t */\n\tdataType: (config: T['config'] | (Equal<T['configRequired'], true> extends true ? never : undefined)) => string;\n\n\t/**\n\t * Optional mapping function, that is used to transform inputs from desired to be used in code format to one suitable for driver\n\t * @example\n\t * For example, when using jsonb we need to map JS/TS object to string before writing to database\n\t * ```\n\t * toDriver(value: TData): string {\n\t * \t return JSON.stringify(value);\n\t * }\n\t * ```\n\t */\n\ttoDriver?: (value: T['data']) => T['driverData'] | SQL;\n\n\t/**\n\t * Optional mapping function, that is used for transforming data returned by driver to desired column's output format\n\t * @example\n\t * For example, when using timestamp we need to map string Date representation to JS Date\n\t * ```\n\t * fromDriver(value: string): Date {\n\t * \treturn new Date(value);\n\t * }\n\t * ```\n\t *\n\t * It'll cause the returned data to change from:\n\t * ```\n\t * {\n\t * \tcustomField: \"2025-04-07T03:25:16.635Z\";\n\t * }\n\t * ```\n\t * to:\n\t * ```\n\t * {\n\t * \tcustomField: new Date(\"2025-04-07T03:25:16.635Z\");\n\t * }\n\t * ```\n\t */\n\tfromDriver?: (value: 'driverOutput' extends keyof T ? T['driverOutput'] : T['driverData']) => T['data'];\n\n\t/**\n\t * @deprecated Use codecs instead; bypasses codecs if used\n\t *\n\t * Optional mapping function, that is used for transforming data returned by transofmed to JSON in database data to desired format\n\t *\n\t * Used by [relational queries](https://orm.drizzle.team/docs/rqb-v2)\n\t *\n\t * Defaults to {@link fromDriver} function\n\t * @example\n\t * For example, when querying bigint column via [RQB](https://orm.drizzle.team/docs/rqb-v2) or [JSON functions](https://orm.drizzle.team/docs/json-functions), the result field will be returned as it's string representation, as opposed to bigint from regular query\n\t * To handle that, we need a separate function to handle such field's mapping:\n\t * ```\n\t * fromJson(value: string): bigint {\n\t * \treturn BigInt(value);\n\t * },\n\t * ```\n\t *\n\t * It'll cause the returned data to change from:\n\t * ```\n\t * {\n\t * \tcustomField: \"5044565289845416380\";\n\t * }\n\t * ```\n\t * to:\n\t * ```\n\t * {\n\t * \tcustomField: 5044565289845416380n;\n\t * }\n\t * ```\n\t */\n\tfromJson?: (value: T['jsonData']) => T['data'];\n\n\t/**\n\t * @deprecated Use codecs instead; bypasses codecs if used\n\t *\n\t * Optional selection modifier function, that is used for modifying selection of column inside [JSON functions](https://orm.drizzle.team/docs/json-functions)\n\t *\n\t * Additional mapping that could be required for such scenarios can be handled using {@link fromJson} function\n\t *\n\t * Used by [relational queries](https://orm.drizzle.team/docs/rqb-v2)\n\t *\n\t * Following types are being casted to text by default: `bytea`, `geometry`, `timestamp`, `numeric`, `bigint`\n\t * @example\n\t * For example, when using bigint we need to cast field to text to preserve data integrity\n\t * ```\n\t * forJsonSelect(identifier: SQL, sql: SQLGenerator, arrayDimensions?: number): SQL {\n\t * \treturn sql`${identifier}::text`\n\t * },\n\t * ```\n\t *\n\t * This will change query from:\n\t * ```\n\t * SELECT\n\t * \trow_to_json(\"t\".*)\n\t * \tFROM\n\t * \t(\n\t * \t\tSELECT\n\t * \t\t\"table\".\"custom_bigint\" AS \"bigint\"\n\t * \t\tFROM\n\t * \t\t\"table\"\n\t * \t) AS \"t\"\n\t * ```\n\t * to:\n\t * ```\n\t * SELECT\n\t * \trow_to_json(\"t\".*)\n\t * \tFROM\n\t * \t(\n\t * \t\tSELECT\n\t * \t\t\"table\".\"custom_bigint\"::text AS \"bigint\"\n\t * \t\tFROM\n\t * \t\t\"table\"\n\t * \t) AS \"t\"\n\t * ```\n\t *\n\t * Returned by query object will change from:\n\t * ```\n\t * {\n\t * \tbigint: 5044565289845416000; // Partial data loss due to direct conversion to JSON format\n\t * }\n\t * ```\n\t * to:\n\t * ```\n\t * {\n\t * \tbigint: \"5044565289845416380\"; // Data is preserved due to conversion of field to text before JSON-ification\n\t * }\n\t * ```\n\t */\n\tforJsonSelect?: (identifier: SQL, sql: SQLGenerator, arrayDimensions?: number) => SQL;\n\n\t/**\n\t * Select which column type codec will be used for this column\n\t *\n\t * Defaults to {@link dataType}\n\t */\n\tcodec?: PostgresColumnType;\n}\n\n/**\n * Custom pg database data type generator\n */\nexport function customType<T extends CustomTypeValues = CustomTypeValues>(\n\tcustomTypeParams: CustomTypeParams<T>,\n): Equal<T['configRequired'], true> extends true ? {\n\t\t<TConfig extends Record<string, any> & T['config']>(\n\t\t\tfieldConfig: TConfig,\n\t\t): PgCustomColumnBuilder<ConvertCustomConfig<T>>;\n\t\t(\n\t\t\tdbName: string,\n\t\t\tfieldConfig: T['config'],\n\t\t): PgCustomColumnBuilder<ConvertCustomConfig<T>>;\n\t}\n\t: {\n\t\t<TConfig extends Record<string, any> & T['config']>(\n\t\t\tfieldConfig?: TConfig,\n\t\t): PgCustomColumnBuilder<ConvertCustomConfig<T>>;\n\t\t(\n\t\t\tdbName: string,\n\t\t\tfieldConfig?: T['config'],\n\t\t): PgCustomColumnBuilder<ConvertCustomConfig<T>>;\n\t}\n{\n\treturn (\n\t\ta?: string | T['config'],\n\t\tb?: T['config'],\n\t): PgCustomColumnBuilder<ConvertCustomConfig<T>> => {\n\t\tconst { name, config } = getColumnNameAndConfig<T['config']>(a, b);\n\t\treturn new PgCustomColumnBuilder(name, config, customTypeParams);\n\t};\n}\n"],"mappings":";;;;;;;;;AAsBA,IAAa,wBAAb,cAAwFA,+CAMtF;CACD,QAA0BC,0BAAsB;CAEhD,YACC,MACA,aACA,kBACC;AACD,QAAM,MAAM,UAAU,iBAAiB;AACvC,OAAK,OAAO,cAAc;AAC1B,OAAK,OAAO,mBAAmB;;;CAIhC,AAAS,MAAM,OAAqB;AACnC,SAAO,IAAI,eACV,OACA,KAAK,OACL;;;AAIH,IAAa,iBAAb,cAAiFC,wCAAmB;CACnG,QAA0BD,0BAAsB;;CAGhD,AAAkB;CAElB,AAAQ;CACR,AAAS;CACT,AAAS;CAET,YACC,OACA,QACC;AACD,QAAM,OAAO,OAAc;AAC3B,OAAK,UAAU,OAAO,iBAAiB,SAAS,OAAO,YAAY;AACnE,OAAK,mBAAmB,OAAO,iBAAiB,YAAY,KAAK;AACjE,OAAK,qBAAqB,OAAO,iBAAiB,cAAc,KAAK;AACrE,OAAK,mBAAmB,OAAO,iBAAiB;AAChD,OAAK,uBAAuB,OAAO,iBAAiB;AACpD,OAAK,eAAeE,qCACnB,OAAO,iBAAiB,SACpB,KAAK,QAAQ,MACf,GACA,KAAK,IAAI,GAAG,CAAC,KAAK,QAAQ,QAAQ,IAAI,EAAE,KAAK,QAAQ,QAAQ,IAAI,CAAC,CAAC,QAAQ,MAAM,MAAM,GAAG,CAAC,CAC3F,CACF;AAED,MAAI,KAAK,cAAc,OAAO,iBAAiB,SAC9C,MAAK,oBAAoB,UAA4B;AACpD,OAAI,UAAU,KAAM,QAAO;GAC3B,MAAM,MAAM,OAAO,UAAU,WAAWC,mCAAa,MAAM,GAAG;AAC9D,UAAO,KAAK,qBAAqB,KAAK,OAAO,iBAAiB,UAAW,KAAK,WAAW;;;;CAM5F,AAAQ,qBAAqB,OAAgB,QAAiC,OAAwB;AACrG,MAAI,QAAQ,KAAK,MAAM,QAAQ,MAAM,CACpC,QAAO,MAAM,KAAK,MAAM,MAAM,OAAO,OAAO,KAAK,qBAAqB,GAAG,QAAQ,QAAQ,EAAE,CAAC;AAE7F,SAAO,OAAO,MAAM;;CAGrB,aAAqB;AACpB,SAAO,KAAK;;;;;;AAqPd,SAAgB,WACf,kBAmBD;AACC,SACC,GACA,MACmD;EACnD,MAAM,EAAE,MAAM,kDAA+C,GAAG,EAAE;AAClE,SAAO,IAAI,sBAAsB,MAAM,QAAQ,iBAAiB"}

package/pg-core/columns/custom.d.cts

@@ -1,3 +1,4 @@
+import { PostgresColumnType } from "../codecs.cjs";
 import { PgColumn, PgColumnBuilder } from "./common.cjs";
 import { entityKind } from "../../entity.cjs";
 import { SQL, SQLGenerator } from "../../sql/sql.cjs";
@@ -28,16 +29,10 @@ declare class PgCustomColumnBuilder<T extends ColumnBuilderBaseConfig<'custom'>>
 declare class PgCustomColumn<T extends ColumnBuilderBaseConfig<'custom'>> extends PgColumn<'custom'> {
   static readonly [entityKind]: string;
   private sqlName;
-  private mapTo?;
-  private mapFrom?;
-  private mapJson?;
-  private forJsonSelect?;
+  readonly mapFromJsonValue?: (value: unknown) => T['data'];
+  readonly jsonSelectIdentifier?: (identifier: SQL, sql: SQLGenerator, arrayDimensions?: number) => SQL;
   constructor(table: PgTable<any>, config: PgCustomColumnBuilder<T>['config']);
   getSQLType(): string;
-  mapFromDriverValue(value: T['driverParam']): T['data'];
-  mapFromJsonValue(value: unknown): T['data'];
-  jsonSelectIdentifier(identifier: SQL, sql: SQLGenerator, arrayDimensions?: number): SQL;
-  mapToDriverValue(value: T['data']): T['driverParam'];
 }
 interface CustomTypeValues {
   /**
@@ -55,6 +50,8 @@ interface CustomTypeValues {
    */
   driverData?: unknown;
   /**
+   * @deprecated Use codecs instead
+   *
    * Type helper, that represents what type database driver is returning for specific database data type
    *
    * Needed only in case driver's output and input for type differ
@@ -63,6 +60,8 @@ interface CustomTypeValues {
    */
   driverOutput?: unknown;
   /**
+   * @deprecated Use codecs instead
+   *
    * Type helper, that represents what type field returns after being aggregated to JSON
    */
   jsonData?: unknown;
@@ -165,6 +164,8 @@ interface CustomTypeParams<T extends CustomTypeValues> {
    */
   fromDriver?: (value: 'driverOutput' extends keyof T ? T['driverOutput'] : T['driverData']) => T['data'];
   /**
+   * @deprecated Use codecs instead; bypasses codecs if used
+   *
    * Optional mapping function, that is used for transforming data returned by transofmed to JSON in database data to desired format
    *
    * Used by [relational queries](https://orm.drizzle.team/docs/rqb-v2)
@@ -194,6 +195,8 @@ interface CustomTypeParams<T extends CustomTypeValues> {
    */
   fromJson?: (value: T['jsonData']) => T['data'];
   /**
+   * @deprecated Use codecs instead; bypasses codecs if used
+   *
    * Optional selection modifier function, that is used for modifying selection of column inside [JSON functions](https://orm.drizzle.team/docs/json-functions)
    *
    * Additional mapping that could be required for such scenarios can be handled using {@link fromJson} function
@@ -248,6 +251,12 @@ interface CustomTypeParams<T extends CustomTypeValues> {
    * ```
    */
   forJsonSelect?: (identifier: SQL, sql: SQLGenerator, arrayDimensions?: number) => SQL;
+  /**
+   * Select which column type codec will be used for this column
+   *
+   * Defaults to {@link dataType}
+   */
+  codec?: PostgresColumnType;
 }
 /**
  * Custom pg database data type generator