durcno 1.0.0-alpha.0

package/dist/src/columns/postgis/geography/multipolygon.mjs

@@ -0,0 +1,70 @@
+import { Column } from "../../common.mjs";
+import { Sql } from "../../../sql.mjs";
+import { MultiPolygon } from "../../../wkx/multipolygon.mjs";
+import "../../../wkx/index.mjs";
+import * as z from "zod";
+//#region src/columns/postgis/geography/multipolygon.ts
+var MultiPolygonColumn = class extends Column {
+	static id = "Column.Geography.MultiPolygon";
+	#srid;
+	#as;
+	#hasZ;
+	#hasM;
+	constructor(config) {
+		super(config);
+		this.#srid = config.srid ?? 4326;
+		this.#as = config.format ?? "xy";
+		this.#hasZ = config.format ? config.format.includes("z") : false;
+		this.#hasM = config.format ? config.format.includes("m") : false;
+	}
+	get sqlTypeScalar() {
+		return `geography(MULTIPOLYGON, ${this.#srid})`;
+	}
+	get zodTypeScaler() {
+		const pointTuple = z.tuple(this.#as ? this.#as.split("").map(() => z.number()) : [z.number(), z.number()]);
+		return z.array(z.array(z.array(pointTuple)));
+	}
+	toDriverScalar(value) {
+		if (value === null) return null;
+		if (value instanceof Sql) return value.string;
+		const multiPolygon = MultiPolygon.parseGeoJSON({
+			type: "MultiPolygon",
+			coordinates: value
+		});
+		return `SRID=${this.#srid};${multiPolygon.toWkt()}`;
+	}
+	toSQLScalar(value) {
+		if (value === null) return "NULL";
+		if (value instanceof Sql) return value.string;
+		const multiPolygon = MultiPolygon.parseGeoJSON({
+			type: "MultiPolygon",
+			coordinates: value
+		});
+		return `'SRID=${this.#srid};${multiPolygon.toWkt()}'`;
+	}
+	fromDriverScalar(value) {
+		if (value === null) return value;
+		const buffer = Buffer.from(value, "hex");
+		return MultiPolygon.parse(buffer, {
+			srid: this.#srid,
+			hasZ: this.#hasZ,
+			hasM: this.#hasM
+		}).toGeoJSON().coordinates;
+	}
+};
+/**
+* Creates a PostGIS `geography(MULTIPOLYGON)` column. Maps to an array of polygons.
+*
+* @example
+* ```ts
+* geography.multipolygon({ srid: 4326 }) // geography(MULTIPOLYGON, 4326)
+* ```
+*
+* @param config.srid - Spatial reference ID (default: 4326)
+* @param config.format - Coordinate format: `"xy"` (default: `"xy"`)
+*/
+function multipolygon(config) {
+	return new MultiPolygonColumn(config);
+}
+//#endregion
+export { multipolygon };

package/dist/src/columns/postgis/geography/point.d.mts

@@ -0,0 +1,36 @@
+import { Sql } from "../../../sql.mjs";
+import { Column, ColumnConfig } from "../../common.mjs";
+import * as z from "zod";
+
+//#region src/columns/postgis/geography/point.d.ts
+type As = "xy" | "xyz" | "xym" | "xyzm";
+type PointConfig = ColumnConfig & {
+  srid?: number;
+  format?: "xy";
+};
+type GetValType<T extends As | undefined> = T extends "xy" ? SelfOrReadonly<[number, number]> : T extends "xyz" | "xym" ? SelfOrReadonly<[number, number, number]> : T extends "xyzm" ? SelfOrReadonly<[number, number, number, number]> : SelfOrReadonly<[number, number]>;
+type GetZodType<T extends As | undefined> = T extends "xy" ? z.ZodTuple<[z.ZodNumber, z.ZodNumber], null> : T extends "xyz" | "xym" ? z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null> : T extends "xyzm" ? z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null> : z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+declare class PointColumn<TConfig extends PointConfig> extends Column<TConfig, GetValType<TConfig["format"]>> {
+  #private;
+  static readonly id = "Column.Geography.Point";
+  constructor(config: TConfig);
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): GetZodType<TConfig["format"]>;
+  toDriverScalar(value: GetValType<TConfig["format"]> | Sql | null): string | null;
+  toSQLScalar(value: GetValType<TConfig["format"]> | Sql | null): string;
+  fromDriverScalar(value: string | null): GetValType<TConfig["format"]> | null;
+}
+/**
+ * Creates a PostGIS `geography(POINT)` column. Maps to `[lon, lat]` tuple.
+ *
+ * @example
+ * ```ts
+ * geography.point({ srid: 4326 }) // geography(POINT, 4326)
+ * ```
+ *
+ * @param config.srid - Spatial reference ID (default: 4326)
+ * @param config.format - Coordinate format: `"xy"` (default: `"xy"`)
+ */
+declare function point<TConfig extends PointConfig>(config: TConfig): PointColumn<TConfig>;
+//#endregion
+export { point };

package/dist/src/columns/postgis/geography/point.mjs

@@ -0,0 +1,69 @@
+import { Column } from "../../common.mjs";
+import { Sql } from "../../../sql.mjs";
+import { Point } from "../../../wkx/point.mjs";
+import "../../../wkx/index.mjs";
+import * as z from "zod";
+//#region src/columns/postgis/geography/point.ts
+var PointColumn = class extends Column {
+	static id = "Column.Geography.Point";
+	#srid;
+	#format;
+	#hasZ;
+	#hasM;
+	constructor(config) {
+		super(config);
+		this.#srid = config.srid ?? 4326;
+		this.#format = config.format ?? "xy";
+		this.#hasZ = config.format ? config.format.includes("z") : false;
+		this.#hasM = config.format ? config.format.includes("m") : false;
+	}
+	get sqlTypeScalar() {
+		return `geography(POINT, ${this.#srid})`;
+	}
+	get zodTypeScaler() {
+		return z.tuple(this.#format ? this.#format.split("").map(() => z.number()) : [z.number(), z.number()]);
+	}
+	toDriverScalar(value) {
+		if (value === null) return null;
+		if (value instanceof Sql) return value.string;
+		const point = Point.parseGeoJSON({
+			type: "Point",
+			coordinates: value
+		});
+		return `SRID=${this.#srid};${point.toWkt()}`;
+	}
+	toSQLScalar(value) {
+		if (value === null) return "NULL";
+		if (value instanceof Sql) return value.string;
+		const point = Point.parseGeoJSON({
+			type: "Point",
+			coordinates: value
+		});
+		return `'SRID=${this.#srid};${point.toWkt()}'`;
+	}
+	fromDriverScalar(value) {
+		if (value === null) return value;
+		const buffer = Buffer.from(value, "hex");
+		return Point.parse(buffer, {
+			srid: this.#srid,
+			hasZ: this.#hasZ,
+			hasM: this.#hasM
+		}).toGeoJSON().coordinates;
+	}
+};
+/**
+* Creates a PostGIS `geography(POINT)` column. Maps to `[lon, lat]` tuple.
+*
+* @example
+* ```ts
+* geography.point({ srid: 4326 }) // geography(POINT, 4326)
+* ```
+*
+* @param config.srid - Spatial reference ID (default: 4326)
+* @param config.format - Coordinate format: `"xy"` (default: `"xy"`)
+*/
+function point(config) {
+	return new PointColumn(config);
+}
+//#endregion
+export { point };

package/dist/src/columns/postgis/geography/polygon.d.mts

@@ -0,0 +1,39 @@
+import { Sql } from "../../../sql.mjs";
+import { Column, ColumnConfig } from "../../common.mjs";
+import * as z from "zod";
+
+//#region src/columns/postgis/geography/polygon.d.ts
+type As = "xy" | "xyz" | "xym" | "xyzm";
+type PolygonConfig = ColumnConfig & {
+  srid?: number;
+  format?: "xy";
+};
+type GetPointType<T extends As | undefined> = T extends "xy" ? SelfOrReadonly<[number, number]> : T extends "xyz" | "xym" ? SelfOrReadonly<[number, number, number]> : T extends "xyzm" ? SelfOrReadonly<[number, number, number, number]> : SelfOrReadonly<[number, number]>;
+type GetRingType<T extends As | undefined> = SelfOrReadonly<GetPointType<T>[]>;
+type GetValType<T extends As | undefined> = SelfOrReadonly<GetRingType<T>[]>;
+type GetPointZodType<T extends As | undefined> = T extends "xy" ? z.ZodTuple<[z.ZodNumber, z.ZodNumber], null> : T extends "xyz" | "xym" ? z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null> : T extends "xyzm" ? z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null> : z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+type GetZodType<T extends As | undefined> = z.ZodArray<z.ZodArray<GetPointZodType<T>>>;
+declare class PolygonColumn<TConfig extends PolygonConfig> extends Column<TConfig, GetValType<TConfig["format"]>> {
+  #private;
+  static readonly id = "Column.Geography.Polygon";
+  constructor(config: TConfig);
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): GetZodType<TConfig["format"]>;
+  toDriverScalar(value: GetValType<TConfig["format"]> | Sql | null): string | null;
+  toSQLScalar(value: GetValType<TConfig["format"]> | Sql | null): string;
+  fromDriverScalar(value: string | null): GetValType<TConfig["format"]> | null;
+}
+/**
+ * Creates a PostGIS `geography(POLYGON)` column. Maps to an array of rings (arrays of `[lon, lat]` tuples).
+ *
+ * @example
+ * ```ts
+ * geography.polygon({ srid: 4326 }) // geography(POLYGON, 4326)
+ * ```
+ *
+ * @param config.srid - Spatial reference ID (default: 4326)
+ * @param config.format - Coordinate format: `"xy"` (default: `"xy"`)
+ */
+declare function polygon<TConfig extends PolygonConfig>(config: TConfig): PolygonColumn<TConfig>;
+//#endregion
+export { polygon };

package/dist/src/columns/postgis/geography/polygon.mjs

@@ -0,0 +1,70 @@
+import { Column } from "../../common.mjs";
+import { Sql } from "../../../sql.mjs";
+import { Polygon } from "../../../wkx/polygon.mjs";
+import "../../../wkx/index.mjs";
+import * as z from "zod";
+//#region src/columns/postgis/geography/polygon.ts
+var PolygonColumn = class extends Column {
+	static id = "Column.Geography.Polygon";
+	#srid;
+	#as;
+	#hasZ;
+	#hasM;
+	constructor(config) {
+		super(config);
+		this.#srid = config.srid ?? 4326;
+		this.#as = config.format ?? "xy";
+		this.#hasZ = config.format ? config.format.includes("z") : false;
+		this.#hasM = config.format ? config.format.includes("m") : false;
+	}
+	get sqlTypeScalar() {
+		return `geography(POLYGON, ${this.#srid})`;
+	}
+	get zodTypeScaler() {
+		const pointTuple = z.tuple(this.#as ? this.#as.split("").map(() => z.number()) : [z.number(), z.number()]);
+		return z.array(z.array(pointTuple));
+	}
+	toDriverScalar(value) {
+		if (value === null) return null;
+		if (value instanceof Sql) return value.string;
+		const polygon = Polygon.parseGeoJSON({
+			type: "Polygon",
+			coordinates: value
+		});
+		return `SRID=${this.#srid};${polygon.toWkt()}`;
+	}
+	toSQLScalar(value) {
+		if (value === null) return "NULL";
+		if (value instanceof Sql) return value.string;
+		const polygon = Polygon.parseGeoJSON({
+			type: "Polygon",
+			coordinates: value
+		});
+		return `'SRID=${this.#srid};${polygon.toWkt()}'`;
+	}
+	fromDriverScalar(value) {
+		if (value === null) return value;
+		const buffer = Buffer.from(value, "hex");
+		return Polygon.parse(buffer, {
+			srid: this.#srid,
+			hasZ: this.#hasZ,
+			hasM: this.#hasM
+		}).toGeoJSON().coordinates;
+	}
+};
+/**
+* Creates a PostGIS `geography(POLYGON)` column. Maps to an array of rings (arrays of `[lon, lat]` tuples).
+*
+* @example
+* ```ts
+* geography.polygon({ srid: 4326 }) // geography(POLYGON, 4326)
+* ```
+*
+* @param config.srid - Spatial reference ID (default: 4326)
+* @param config.format - Coordinate format: `"xy"` (default: `"xy"`)
+*/
+function polygon(config) {
+	return new PolygonColumn(config);
+}
+//#endregion
+export { polygon };

package/dist/src/columns/serial.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/serial.d.ts
+type SerialValType = number;
+type SerialConfig = Pick<ColumnConfig, "primaryKey" | "unique">;
+type SerialInternalConfig<TConfig extends SerialConfig> = TConfig & {
+  generated: "BY DEFAULT";
+  notNull: true;
+};
+declare class SerialColumn<TConfig extends SerialConfig> extends Column<SerialInternalConfig<TConfig>, SerialValType> {
+  static readonly id = "Column.Serial";
+  constructor(config: TConfig);
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodCoercedNumber<unknown>;
+  toDriverScalar(value: SerialValType | Sql | null): string | number | null;
+  toSQLScalar(value: number | Sql | null): string;
+  fromDriverScalar(value: number | string | null): SerialValType | null;
+}
+/** Creates a `serial` column. Auto-incrementing 32-bit integer, implicitly `NOT NULL`. Maps to `number`. */
+declare function serial<TConfig extends SerialConfig>(config: TConfig): SerialColumn<TConfig>;
+//#endregion
+export { serial };

package/dist/src/columns/serial.mjs

@@ -0,0 +1,35 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/serial.ts
+var SerialColumn = class extends Column {
+	static id = "Column.Serial";
+	constructor(config) {
+		super(config);
+	}
+	get sqlTypeScalar() {
+		return "serial";
+	}
+	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 `serial` column. Auto-incrementing 32-bit integer, implicitly `NOT NULL`. Maps to `number`. */
+function serial(config) {
+	return new SerialColumn(config);
+}
+//#endregion
+export { serial };

package/dist/src/columns/smallint.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/smallint.d.ts
+type SmallintValType = number;
+type SmallintConfig = ColumnConfig;
+declare class SmallintColumn<TConfig extends SmallintConfig> extends Column<TConfig, SmallintValType> {
+  static readonly id = "Column.Smallint";
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodCoercedNumber<unknown>;
+  toDriverScalar(value: SmallintValType | Sql | null): string | number | null;
+  toSQLScalar(value: number | Sql | null): string;
+  fromDriverScalar(value: number | string | null): SmallintValType | null;
+}
+/** Creates a `smallint` column. PostgreSQL 16-bit signed integer, maps to `number`. */
+declare function smallint<TConfig extends SmallintConfig>(config: TConfig): SmallintColumn<TConfig>;
+//#endregion
+export { smallint };

package/dist/src/columns/smallint.mjs

@@ -0,0 +1,32 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/smallint.ts
+var SmallintColumn = class extends Column {
+	static id = "Column.Smallint";
+	get sqlTypeScalar() {
+		return "smallint";
+	}
+	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 `smallint` column. PostgreSQL 16-bit signed integer, maps to `number`. */
+function smallint(config) {
+	return new SmallintColumn(config);
+}
+//#endregion
+export { smallint };

package/dist/src/columns/smallserial.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/smallserial.d.ts
+type SmallserialValType = number;
+type SmallserialConfig = Pick<ColumnConfig, "primaryKey" | "unique">;
+type SmallserialInternalConfig<TConfig extends SmallserialConfig> = TConfig & {
+  generated: "BY DEFAULT";
+  notNull: true;
+};
+declare class SmallserialColumn<TConfig extends SmallserialConfig> extends Column<SmallserialInternalConfig<TConfig>, SmallserialValType> {
+  static readonly id = "Column.Smallserial";
+  constructor(config: TConfig);
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodCoercedNumber<unknown>;
+  toDriverScalar(value: SmallserialValType | Sql | null): string | number | null;
+  toSQLScalar(value: number | Sql | null): string;
+  fromDriverScalar(value: number | string | null): SmallserialValType | null;
+}
+/** Creates a `smallserial` column. Auto-incrementing 16-bit integer, implicitly `NOT NULL`. Maps to `number`. */
+declare function smallserial<TConfig extends SmallserialConfig>(config: TConfig): SmallserialColumn<TConfig>;
+//#endregion
+export { smallserial };

package/dist/src/columns/smallserial.mjs

@@ -0,0 +1,35 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/smallserial.ts
+var SmallserialColumn = class extends Column {
+	static id = "Column.Smallserial";
+	constructor(config) {
+		super(config);
+	}
+	get sqlTypeScalar() {
+		return "smallserial";
+	}
+	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 `smallserial` column. Auto-incrementing 16-bit integer, implicitly `NOT NULL`. Maps to `number`. */
+function smallserial(config) {
+	return new SmallserialColumn(config);
+}
+//#endregion
+export { smallserial };

package/dist/src/columns/text.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/text.d.ts
+type TextValType = string;
+type TextConfig = ColumnConfig;
+declare class TextColumn<TConfig extends TextConfig> extends Column<TConfig, TextValType> {
+  static readonly id = "Column.Text";
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodString;
+  toDriverScalar(value: TextValType | Sql | null): string | null;
+  toSQLScalar(value: string | Sql | null): string;
+  fromDriverScalar(value: string | null): TextValType | null;
+}
+/** Creates a `text` column. PostgreSQL variable-length string with no length limit, maps to `string`. */
+declare function text<TConfig extends TextConfig>(config: TConfig): TextColumn<TConfig>;
+//#endregion
+export { text };

package/dist/src/columns/text.mjs

@@ -0,0 +1,30 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/text.ts
+var TextColumn = class extends Column {
+	static id = "Column.Text";
+	get sqlTypeScalar() {
+		return "text";
+	}
+	get zodTypeScaler() {
+		return z.string();
+	}
+	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;
+	}
+};
+/** Creates a `text` column. PostgreSQL variable-length string with no length limit, maps to `string`. */
+function text(config) {
+	return new TextColumn(config);
+}
+//#endregion
+export { text };

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

@@ -0,0 +1,44 @@
+import { Sql } from "../sql.mjs";
+import { Column, ColumnConfig } from "./common.mjs";
+import * as z from "zod";
+
+//#region src/columns/time.d.ts
+type TimeValType = string;
+type TimeConfig = ColumnConfig & {
+  /**
+   * Fractional seconds precision (0-6).
+   * When specified, uses `time(precision)` syntax.
+   */
+  precision?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+  /**
+   * Include timezone information in the time value.
+   * When true, uses `time with time zone`.
+   * When false, uses `time`.
+   * @default false
+   */
+  withTimezone?: boolean;
+};
+declare class TimeColumn<TConfig extends TimeConfig> extends Column<TConfig, TimeValType> {
+  #private;
+  static readonly id = "Column.Time";
+  constructor(config: TConfig);
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodISOTime;
+  toDriverScalar(value: TimeValType | Sql | null): string | null;
+  toSQLScalar(value: string | Sql | null): string;
+  fromDriverScalar(value: string | null): TimeValType | null;
+}
+/**
+ * Creates a `time` column. Time of day without date, maps to `string`.
+ *
+ * @example
+ * ```ts
+ * time({ precision: 3, withTimezone: true, notNull }) // time(3) with time zone NOT NULL
+ * ```
+ *
+ * @param config.withTimezone - Include timezone info (default: `false`)
+ * @param config.precision - Fractional seconds precision (0–6)
+ */
+declare function time<TConfig extends TimeConfig>(config: TConfig): TimeColumn<TConfig>;
+//#endregion
+export { time };

package/dist/src/columns/time.mjs

@@ -0,0 +1,47 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/time.ts
+var TimeColumn = class extends Column {
+	static id = "Column.Time";
+	#withTimezone;
+	#precision;
+	constructor(config) {
+		super(config);
+		this.#withTimezone = config.withTimezone ?? false;
+		this.#precision = config.precision;
+	}
+	get sqlTypeScalar() {
+		return `time${this.#precision !== void 0 ? `(${this.#precision})` : ""}${this.#withTimezone ? " with time zone" : ""}`;
+	}
+	get zodTypeScaler() {
+		return z.iso.time({ precision: this.#precision });
+	}
+	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;
+	}
+};
+/**
+* Creates a `time` column. Time of day without date, maps to `string`.
+*
+* @example
+* ```ts
+* time({ precision: 3, withTimezone: true, notNull }) // time(3) with time zone NOT NULL
+* ```
+*
+* @param config.withTimezone - Include timezone info (default: `false`)
+* @param config.precision - Fractional seconds precision (0–6)
+*/
+function time(config) {
+	return new TimeColumn(config);
+}
+//#endregion
+export { time };

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

@@ -0,0 +1,44 @@
+import { Sql } from "../sql.mjs";
+import { Column, ColumnConfig } from "./common.mjs";
+import * as z from "zod";
+
+//#region src/columns/timestamp.d.ts
+type TimestampValType = Date;
+type TimestampConfig = ColumnConfig & {
+  /**
+   * Fractional seconds precision (0-6).
+   * When specified, uses `timestamp(precision)` syntax.
+   */
+  precision?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+  /**
+   * Include timezone information in the timestamp.
+   * When true, uses `timestamp with time zone` (recommended for UTC round-trips).
+   * When false, uses `timestamp` (recommended for local round-trips).
+   * @default true
+   */
+  withTimezone?: boolean;
+};
+declare class TimestampColumn<TConfig extends TimestampConfig> extends Column<TConfig, TimestampValType> {
+  #private;
+  static readonly id = "Column.Timestamp";
+  constructor(config: TConfig);
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodISODateTime;
+  toDriverScalar(value: TimestampValType | Sql | null): string | null;
+  toSQLScalar(value: TimestampValType | Sql | null): string;
+  fromDriverScalar(value: Date | null): TimestampValType | null;
+}
+/**
+ * Creates a `timestamp` column. Date and time, maps to `Date`.
+ *
+ * @example
+ * ```ts
+ * timestamp({ withTimezone: true, precision: 3, notNull }) // timestamp(3) with time zone NOT NULL
+ * ```
+ *
+ * @param config.withTimezone - Include timezone info (default: `true`)
+ * @param config.precision - Fractional seconds precision (0–6)
+ */
+declare function timestamp<TConfig extends TimestampConfig>(config: TConfig): TimestampColumn<TConfig>;
+//#endregion
+export { TimestampColumn, timestamp };