durcno 1.0.0-alpha.0

package/dist/src/_virtual/_rolldown/runtime.mjs

@@ -0,0 +1,28 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+//#endregion
+export { __esmMin, __exportAll, __toCommonJS };

package/dist/src/cli/helpers.mjs

@@ -0,0 +1,16 @@
+//#region src/cli/helpers.ts
+function getUrlFromDbCredentials(dbCredentials) {
+	if ("url" in dbCredentials) return dbCredentials.url;
+	const { host, port, user, password, database, ssl } = dbCredentials;
+	const url = `postgresql://${encodeURIComponent(user) + (password ? `:${encodeURIComponent(password)}` : "")}@${port !== void 0 ? `${host}:${port}` : host}/${encodeURIComponent(database)}`;
+	const params = {};
+	if (ssl !== void 0) {
+		if (typeof ssl === "boolean") {
+			if (ssl) params.ssl = "true";
+		} else if (typeof ssl === "string") params.sslmode = ssl;
+		else if (typeof ssl === "object") throw new Error("Cannot convert 'ssl' ConnectionOptions object into a URL. Provide dbCredentials.url or use a boolean/string ssl value (e.g. 'require').");
+	}
+	return `${url}${Object.keys(params).length ? `?${Object.entries(params).map(([k, v]) => `${k}=${encodeURIComponent(v)}`).join("&")}` : ""}`;
+}
+//#endregion
+export { getUrlFromDbCredentials };

package/dist/src/columns/bigint.d.mts

@@ -0,0 +1,19 @@
+import { Sql } from "../sql.mjs";
+import { Column, ColumnConfig } from "./common.mjs";
+import * as z from "zod";
+
+//#region src/columns/bigint.d.ts
+type BigintValType = number;
+type BigintConfig = ColumnConfig;
+declare class BigintColumn<TConfig extends BigintConfig> extends Column<TConfig, BigintValType> {
+  static readonly id = "Column.Bigint";
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodCoercedNumber<unknown>;
+  toDriverScalar(value: BigintValType | Sql | null): string | number | null;
+  toSQLScalar(value: number | Sql | null): string;
+  fromDriverScalar(value: number | string | null): BigintValType | null;
+}
+/** Creates a `bigint` column. PostgreSQL 64-bit signed integer, maps to `number`. */
+declare function bigint<TConfig extends BigintConfig>(config: TConfig): BigintColumn<TConfig>;
+//#endregion
+export { BigintColumn, bigint };

package/dist/src/columns/bigint.mjs

@@ -0,0 +1,32 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/bigint.ts
+var BigintColumn = class extends Column {
+	static id = "Column.Bigint";
+	get sqlTypeScalar() {
+		return "bigint";
+	}
+	get zodTypeScaler() {
+		return z.coerce.number();
+	}
+	toDriverScalar(value) {
+		if (value === null) return null;
+		return value instanceof Sql ? value.string : value;
+	}
+	toSQLScalar(value) {
+		if (value === null) return "NULL";
+		if (value instanceof Sql) return value.string;
+		return value.toString();
+	}
+	fromDriverScalar(value) {
+		if (value === null) return null;
+		return typeof value === "string" ? parseInt(value, 10) : value;
+	}
+};
+/** Creates a `bigint` column. PostgreSQL 64-bit signed integer, maps to `number`. */
+function bigint(config) {
+	return new BigintColumn(config);
+}
+//#endregion
+export { bigint };

package/dist/src/columns/bigserial.d.mts

@@ -0,0 +1,24 @@
+import { Sql } from "../sql.mjs";
+import { Column, ColumnConfig } from "./common.mjs";
+import * as z from "zod";
+
+//#region src/columns/bigserial.d.ts
+type BigserialValType = number;
+type BigserialConfig = Pick<ColumnConfig, "primaryKey" | "unique">;
+type BigserialInternalConfig<TConfig extends BigserialConfig> = TConfig & {
+  generated: "BY DEFAULT";
+  notNull: true;
+};
+declare class BigserialColumn<TConfig extends BigserialConfig> extends Column<BigserialInternalConfig<TConfig>, BigserialValType> {
+  static readonly id = "Column.Bigserial";
+  constructor(config: TConfig);
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodCoercedNumber<unknown>;
+  toDriverScalar(value: BigserialValType | Sql | null): string | number | null;
+  toSQLScalar(value: number | Sql | null): string;
+  fromDriverScalar(value: number | string | null): BigserialValType | null;
+}
+/** Creates a `bigserial` column. Auto-incrementing 64-bit integer, implicitly `NOT NULL`. Maps to `number`. */
+declare function bigserial<TConfig extends BigserialConfig>(config: TConfig): BigserialColumn<TConfig>;
+//#endregion
+export { bigserial };

package/dist/src/columns/bigserial.mjs

@@ -0,0 +1,35 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/bigserial.ts
+var BigserialColumn = class extends Column {
+	static id = "Column.Bigserial";
+	constructor(config) {
+		super(config);
+	}
+	get sqlTypeScalar() {
+		return "bigserial";
+	}
+	get zodTypeScaler() {
+		return z.coerce.number();
+	}
+	toDriverScalar(value) {
+		if (value === null) return null;
+		return value instanceof Sql ? value.string : value;
+	}
+	toSQLScalar(value) {
+		if (value === null) return "NULL";
+		if (value instanceof Sql) return value.string;
+		return value.toString();
+	}
+	fromDriverScalar(value) {
+		if (value === null) return null;
+		return typeof value === "string" ? parseInt(value, 10) : value;
+	}
+};
+/** Creates a `bigserial` column. Auto-incrementing 64-bit integer, implicitly `NOT NULL`. Maps to `number`. */
+function bigserial(config) {
+	return new BigserialColumn(config);
+}
+//#endregion
+export { bigserial };

package/dist/src/columns/boolean.d.mts

@@ -0,0 +1,19 @@
+import { Sql } from "../sql.mjs";
+import { Column, ColumnConfig } from "./common.mjs";
+import * as z from "zod";
+
+//#region src/columns/boolean.d.ts
+type BooleanValType = boolean;
+type BooleanConfig = ColumnConfig;
+declare class BooleanColumn<TConfig extends BooleanConfig> extends Column<TConfig, BooleanValType> {
+  static readonly id = "Column.Boolean";
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodBoolean;
+  toDriverScalar(value: BooleanValType | Sql | null): string | null;
+  toSQLScalar(value: boolean | Sql | null): string;
+  fromDriverScalar(value: boolean): BooleanValType | null;
+}
+/** Creates a `boolean` column. PostgreSQL true/false type, maps to `boolean`. */
+declare function boolean<TConfig extends BooleanConfig>(config: TConfig): BooleanColumn<TConfig>;
+//#endregion
+export { boolean };

package/dist/src/columns/boolean.mjs

@@ -0,0 +1,31 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/boolean.ts
+var BooleanColumn = class extends Column {
+	static id = "Column.Boolean";
+	get sqlTypeScalar() {
+		return "boolean";
+	}
+	get zodTypeScaler() {
+		return z.boolean();
+	}
+	toDriverScalar(value) {
+		if (value === null) return null;
+		return value instanceof Sql ? value.string : `${value ? "1" : "0"}`;
+	}
+	toSQLScalar(value) {
+		if (value === null) return "NULL";
+		return value instanceof Sql ? value.string : `${value ? "'1'" : "'0'"}`;
+	}
+	fromDriverScalar(value) {
+		if (value === null) return null;
+		return value;
+	}
+};
+/** Creates a `boolean` column. PostgreSQL true/false type, maps to `boolean`. */
+function boolean(config) {
+	return new BooleanColumn(config);
+}
+//#endregion
+export { boolean };

package/dist/src/columns/bytea.d.mts

@@ -0,0 +1,19 @@
+import { Sql } from "../sql.mjs";
+import { Column, ColumnConfig } from "./common.mjs";
+import * as z from "zod";
+
+//#region src/columns/bytea.d.ts
+type ByteaValType = Buffer;
+type ByteaConfig = ColumnConfig;
+declare class ByteaColumn<TConfig extends ByteaConfig> extends Column<TConfig, ByteaValType> {
+  static readonly id = "Column.Bytea";
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>;
+  toDriverScalar(value: ByteaValType | Sql | null): string | null;
+  toSQLScalar(value: ByteaValType | Sql | null): string;
+  fromDriverScalar(value: Buffer | null): ByteaValType | null;
+}
+/** Creates a `bytea` column. PostgreSQL binary data type, maps to `Buffer`. */
+declare function bytea<TConfig extends ByteaConfig>(config: TConfig): ByteaColumn<TConfig>;
+//#endregion
+export { bytea };

package/dist/src/columns/bytea.mjs

@@ -0,0 +1,33 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/bytea.ts
+var ByteaColumn = class extends Column {
+	static id = "Column.Bytea";
+	get sqlTypeScalar() {
+		return "bytea";
+	}
+	get zodTypeScaler() {
+		return z.instanceof(Buffer);
+	}
+	toDriverScalar(value) {
+		if (value === null) return null;
+		if (value instanceof Sql) return value.string;
+		return `\\x${value.toString("hex")}`;
+	}
+	toSQLScalar(value) {
+		if (value === null) return "NULL";
+		if (value instanceof Sql) return value.string;
+		return `'\\x${value.toString("hex")}'`;
+	}
+	fromDriverScalar(value) {
+		if (value === null) return null;
+		return value;
+	}
+};
+/** Creates a `bytea` column. PostgreSQL binary data type, maps to `Buffer`. */
+function bytea(config) {
+	return new ByteaColumn(config);
+}
+//#endregion
+export { bytea };

package/dist/src/columns/char.d.mts

@@ -0,0 +1,32 @@
+import { Sql } from "../sql.mjs";
+import { Column, ColumnConfig } from "./common.mjs";
+import * as z from "zod";
+
+//#region src/columns/char.d.ts
+type CharValType = string;
+type CharConfig = ColumnConfig & {
+  /** Fixed character length (default: 1) */length?: number;
+};
+declare class CharColumn<TConfig extends CharConfig> extends Column<TConfig, CharValType> {
+  #private;
+  static readonly id = "Column.Char";
+  constructor(config: TConfig);
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodString;
+  toDriverScalar(value: CharValType | Sql | null): string | null;
+  toSQLScalar(value: string | Sql | null): string;
+  fromDriverScalar(value: string | null): CharValType | null;
+}
+/**
+ * Creates a `char` column. Fixed-length, blank-padded string. Maps to `string`.
+ *
+ * @example
+ * ```ts
+ * char({ length: 2, notNull }) // char(2) NOT NULL
+ * ```
+ *
+ * @param config.length - Fixed character length (default: 1)
+ */
+declare function char<TConfig extends CharConfig>(config: TConfig): CharColumn<TConfig>;
+//#endregion
+export { char };

package/dist/src/columns/char.mjs

@@ -0,0 +1,44 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/char.ts
+var CharColumn = class extends Column {
+	static id = "Column.Char";
+	#length;
+	constructor(config) {
+		super(config);
+		this.#length = config.length ?? 1;
+	}
+	get sqlTypeScalar() {
+		return `char(${this.#length})`;
+	}
+	get zodTypeScaler() {
+		return z.string().length(this.#length);
+	}
+	toDriverScalar(value) {
+		if (value === null) return null;
+		return value instanceof Sql ? value.string : value;
+	}
+	toSQLScalar(value) {
+		if (value === null) return "NULL";
+		return value instanceof Sql ? value.string : `'${value.replace(/'/g, "''")}'`;
+	}
+	fromDriverScalar(value) {
+		return value === null ? null : value.trimEnd();
+	}
+};
+/**
+* Creates a `char` column. Fixed-length, blank-padded string. Maps to `string`.
+*
+* @example
+* ```ts
+* char({ length: 2, notNull }) // char(2) NOT NULL
+* ```
+*
+* @param config.length - Fixed character length (default: 1)
+*/
+function char(config) {
+	return new CharColumn(config);
+}
+//#endregion
+export { char };

package/dist/src/columns/cidr.d.mts

@@ -0,0 +1,19 @@
+import { Sql } from "../sql.mjs";
+import { Column, ColumnConfig } from "./common.mjs";
+import * as z from "zod";
+
+//#region src/columns/cidr.d.ts
+type CidrValType = string;
+type CidrConfig = ColumnConfig;
+declare class CidrColumn<TConfig extends CidrConfig> extends Column<TConfig, CidrValType> {
+  static readonly id = "Column.Cidr";
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodUnion<readonly [z.ZodCIDRv4, z.ZodCIDRv6]>;
+  toDriverScalar(value: CidrValType | Sql | null): string | null;
+  toSQLScalar(value: string | Sql | null): string;
+  fromDriverScalar(value: string | null): CidrValType | null;
+}
+/** Creates a `cidr` column. PostgreSQL IPv4/IPv6 network address type, maps to `string`. */
+declare function cidr<TConfig extends CidrConfig>(config: TConfig): CidrColumn<TConfig>;
+//#endregion
+export { cidr };

package/dist/src/columns/cidr.mjs

@@ -0,0 +1,31 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/cidr.ts
+var CidrColumn = class extends Column {
+	static id = "Column.Cidr";
+	get sqlTypeScalar() {
+		return "cidr";
+	}
+	get zodTypeScaler() {
+		return z.union([z.cidrv4(), z.cidrv6()]);
+	}
+	toDriverScalar(value) {
+		if (value === null) return null;
+		return value instanceof Sql ? value.string : value;
+	}
+	toSQLScalar(value) {
+		if (value === null) return "NULL";
+		if (value instanceof Sql) return value.string;
+		return `'${value.replace(/'/g, "''")}'`;
+	}
+	fromDriverScalar(value) {
+		return value;
+	}
+};
+/** Creates a `cidr` column. PostgreSQL IPv4/IPv6 network address type, maps to `string`. */
+function cidr(config) {
+	return new CidrColumn(config);
+}
+//#endregion
+export { cidr };

package/dist/src/columns/common.d.mts

@@ -0,0 +1,233 @@
+import { Sql } from "../sql.mjs";
+import { entityType } from "../symbols.mjs";
+import { Arg } from "../query-builders/pre.mjs";
+import { StdTableColumn, TableColumn } from "../table.mjs";
+import * as z from "zod";
+
+//#region src/columns/common.d.ts
+declare const notNull: true;
+declare const unique: true;
+declare const primaryKey: true;
+type Tuple<T, L extends number, Acc extends T[] = []> = Acc["length"] extends L ? Acc : Tuple<T, L, [...Acc, T]>;
+type MultiDimValueArray<T, D extends readonly (number | null)[]> = D extends readonly [infer First, ...infer Rest] ? First extends number ? Rest extends readonly (number | null)[] ? MultiDimValueArray<Tuple<T, First>, Rest> : never : First extends null ? Rest extends readonly (number | null)[] ? MultiDimValueArray<T[], Rest> : never : never : T;
+type GetValueArray<T, TConfig> = TConfig extends {
+  dimension: infer D;
+} ? D extends readonly (number | null)[] ? MultiDimValueArray<T, D> : T : T;
+type MultiDimZodTypeArray<T extends z.ZodType, D extends readonly (number | null)[]> = D extends readonly [infer First, ...infer Rest] ? First extends number ? Rest extends readonly (number | null)[] ? MultiDimZodTypeArray<z.ZodTuple<Tuple<T, First>, null>, Rest> : never : First extends null ? Rest extends readonly (number | null)[] ? MultiDimZodTypeArray<z.ZodArray<T>, Rest> : never : never : T;
+type GetZodTypeArray<T extends z.ZodType, TConfig> = TConfig extends {
+  dimension: infer D;
+} ? D extends readonly (number | null)[] ? MultiDimZodTypeArray<T, D> : T : T;
+interface TableLike {
+  _: {
+    schema: string;
+    name: string;
+  };
+}
+type OnDeleteAction = "CASCADE" | "SET NULL" | "SET DEFAULT" | "RESTRICT" | "NO ACTION";
+type ColumnConfig = {
+  /**
+   * SQL equivalent: `GENERATED <ALWAYS|BY DEFAULT> AS ...`
+   */
+  generated?: "ALWAYS" | "BY DEFAULT";
+  /**
+   * SQL equivalent: the value following `AS`, e.g. `IDENTITY` or `(START WITH 1)`
+   */
+  as?: "IDENTITY" | `(${string})`;
+  /**
+   * The dimension of the array column.
+   */
+  dimension?: Readonly<[number | null, ...(number | null)[]]>;
+  /**
+   * SQL equivalent: `PRIMARY KEY`
+   */
+  primaryKey?: true;
+  /**
+   * SQL equivalent: `UNIQUE`
+   */
+  unique?: true;
+  /**
+   * SQL equivalent: `NOT NULL`
+   */
+  notNull?: true;
+};
+/**
+ * Type that augments C with a `hasDefault` property set to true.
+ * Used as the return type of `default()` method.
+ */
+type HasDefault<C> = C & {
+  hasDefault: true;
+};
+/**
+ * Type that augments C with a `hasInsertFn` property set to true.
+ * Used as the return type of `$insertFn()` method.
+ */
+type HasInsertFn<C> = C & {
+  hasInsertFn: true;
+};
+/**
+ * Type that augments C with a `hasUpdateFn` property set to true.
+ * Used as the return type of `$updateFn()` method.
+ */
+type HasUpdateFn<C> = C & {
+  hasUpdateFn: true;
+};
+/**
+ * Describes a foreign key reference target for `references()`.
+ * Supports either a direct column resolver function or an object with
+ * a resolver and optional `onDelete` action.
+ */
+type BuildRef<ValType> = (() => TableColumn<string, string, Key, Column<any, ValType>>) | {
+  column: () => TableColumn<string, string, Key, Column<any, ValType>>;
+  onDelete?: OnDeleteAction;
+};
+/**
+ * Type that augments C with a `hasReferences` property set to true.
+ * Used for columns that have foreign key references.
+ */
+type HasReferences<C> = C & {
+  hasReferences: true;
+};
+/**
+ * Type that augments C with a `ValTypeOverriden` property set to true and a `ValTypeOverride` property set to U.
+ */
+type SetValueType<C, U> = C & {
+  $: {
+    HasValTypeOverridde: true;
+    ValTypeOverride: U;
+  };
+};
+declare abstract class Column<TConfig extends ColumnConfig, TColVal> {
+  #private;
+  static readonly [entityType] = "Column";
+  readonly config: TConfig;
+  readonly $: {
+    ColValType: TColVal;
+    ValTypeBase: GetValueArray<TColVal, TConfig>;
+    HasValTypeOverridde: {};
+    ValTypeOverride: {};
+  };
+  readonly ValType: this["$"]["HasValTypeOverridde"] extends true ? this["$"]["ValTypeOverride"] : this["$"]["ValTypeBase"];
+  readonly ValTypeInsert: TConfig extends {
+    generated: "ALWAYS";
+  } ? never : TConfig extends {
+    generated: "BY DEFAULT";
+  } ? this["ValType"] | undefined : this extends {
+    hasDefault: true;
+  } ? this["ValType"] | Sql | null | undefined : this extends {
+    hasInsertFn: true;
+  } ? this["ValType"] | Sql | null | undefined : TConfig extends {
+    notNull: true;
+  } ? this["ValType"] | Sql : this["ValType"] | Sql | null | undefined;
+  readonly ValTypeUpdate: TConfig extends {
+    primaryKey: true;
+  } ? never : TConfig extends {
+    notNull: true;
+  } ? this["ValType"] : this["ValType"] | null;
+  readonly ValTypeSelect: TConfig extends {
+    generated: string;
+  } ? this["ValType"] : TConfig extends {
+    primaryKey: true;
+  } ? this["ValType"] : TConfig extends {
+    notNull: true;
+  } ? this["ValType"] : this["ValType"] | null;
+  constructor(config: TConfig);
+  _: {
+    setName: (name: string) => void;
+    setTable: (table: TableLike) => void;
+  };
+  get name(): string | undefined;
+  get nameSnake(): string | undefined;
+  get table(): TableLike | undefined;
+  get generated(): TConfig extends {
+    generated: string;
+  } ? TConfig["generated"] : undefined;
+  get as(): TConfig extends {
+    as: string;
+  } ? TConfig["as"] : undefined;
+  get isPrimaryKey(): TConfig extends {
+    primaryKey: true;
+  } ? true : false;
+  get isGenerated(): TConfig extends {
+    generated: string;
+  } ? true : false;
+  get isUnique(): TConfig extends {
+    unique: true;
+  } ? true : false;
+  get isNotNull(): TConfig extends {
+    notNull: true;
+  } ? true : false;
+  abstract get sqlTypeScalar(): string;
+  get sqlType(): string;
+  abstract get zodTypeScaler(): z.ZodType;
+  get zodType(): GetZodTypeArray<this["zodTypeScaler"], this["config"]>;
+  /**
+   * Returns the fully-qualified, double-quoted column identifier separated by a dot.
+   * @returns string `"table"."column"`
+   */
+  get fullName(): string;
+  abstract toDriverScalar(value: TColVal | Sql | null): string | number | null;
+  abstract toSQLScalar(value: TColVal | Sql | null): string;
+  abstract fromDriverScalar(value: unknown): TColVal | null;
+  /**
+   * Converts a JavaScript value to the PostgreSQL driver format.
+   * Handles array dimensions if configured, otherwise delegates to scalar implementation.
+   */
+  toDriver(value: this["ValType"] | Sql | null): string | number | null;
+  /**
+   * Converts a JavaScript value to SQL string literal.
+   * Handles array dimensions with ARRAY[...] syntax if configured.
+   */
+  toSQL(value: this["ValType"] | Sql | null): string;
+  /**
+   * Converts a PostgreSQL result back to JavaScript value.
+   * Handles array dimensions if configured, otherwise delegates to scalar implementation.
+   */
+  fromDriver(value: unknown): this["ValType"] | null;
+  /**
+   * Sets a default value for this column.
+   * SQL equivalent: `DEFAULT <value>`
+   * @param value - The default value or SQL expression
+   * @returns this column instance
+   */
+  default(value: this["ValType"] | Sql): HasDefault<this>;
+  get hasDefault(): boolean;
+  defaultToSQL(): string | undefined;
+  /**
+   * Sets a foreign key reference for this column.
+   * SQL equivalent: `REFERENCES <table>(<column>) [ON DELETE <action>]`
+   * @param ref - A function returning the referenced column, or an object with column and onDelete
+   * @returns this column instance
+   */
+  references(ref: BuildRef<this["ValType"]>): HasReferences<this>;
+  get hasReferences(): boolean;
+  get referencesCol(): StdTableColumn | null;
+  get referencesOnDelete(): OnDeleteAction | null;
+  /**
+   * Sets a function to be called during INSERT queries to generate a value.
+   * @param fn - A function that returns the value to insert
+   * @returns HasInsertFn<this>
+   */
+  $insertFn(fn: () => this["ValType"]): HasInsertFn<this>;
+  get hasInsertFn(): boolean;
+  getInsertFnVal(): this["ValType"] | null;
+  /**
+   * Sets a function to be called during UPDATE queries to generate a value.
+   * @param fn - A function that returns the value to use in updates
+   * @returns HasUpdateFn<this>
+   */
+  $updateFn(fn: () => this["ValType"]): HasUpdateFn<this>;
+  get hasUpdateFn(): boolean;
+  getUpdateFnVal(): this["ValType"] | null;
+  /**
+   * Specifies the TypeScript type for this column's value.
+   * This is a compile-time only operation and does not affect runtime behavior.
+   * @returns this column with the specified value type
+   */
+  $type<T>(): SetValueType<this, T>;
+  /** Creates an `Arg` instance for this column, to be used in prepared queries.
+   * @returns an `Arg` instance with the type of this column
+   */
+  arg(): Arg<this["ValType"]>;
+}
+//#endregion
+export { Column, ColumnConfig, OnDeleteAction, notNull, primaryKey, unique };