durcno 1.0.0-alpha.0

package/dist/src/columns/jsonb.mjs

@@ -0,0 +1,68 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/jsonb.ts
+/**
+* PostgreSQL JSONB column type.
+* Stores JSON data in a decomposed binary format for efficient processing.
+*
+* Key differences from JSON:
+* - Does not preserve whitespace or key ordering
+* - Supports GIN indexing for fast path queries
+* - Slightly slower to insert (parsing overhead)
+* - Faster to query (no reparsing needed)
+* - Supports containment and existence operators (@>, ?, ?|, ?&)
+*
+* Use $type<T>() to specify a TypeScript type for the column value.
+*
+* @example
+* ```ts
+* // Basic JSONB column
+* const table = table('users', {
+*   metadata: jsonb({}),
+* });
+*
+* // Typed JSONB column
+* interface UserSettings {
+*   theme: 'light' | 'dark';
+*   notifications: boolean;
+* }
+* const table = table('users', {
+*   settings: jsonb({}).$type<UserSettings>(),
+* });
+* ```
+*/
+var JsonbColumn = class extends Column {
+	static id = "Column.Jsonb";
+	get sqlTypeScalar() {
+		return "jsonb";
+	}
+	get zodTypeScaler() {
+		return z.unknown();
+	}
+	toDriverScalar(value) {
+		if (value === null) return null;
+		if (value instanceof Sql) return value.string;
+		return JSON.stringify(value);
+	}
+	toSQLScalar(value) {
+		if (value === null) return "NULL";
+		if (value instanceof Sql) return value.string;
+		return `'${JSON.stringify(value).replace(/'/g, "''")}'::jsonb`;
+	}
+	fromDriverScalar(value) {
+		if (value === null) return null;
+		if (typeof value === "string") try {
+			return JSON.parse(value);
+		} catch {
+			return value;
+		}
+		return value;
+	}
+};
+/** Creates a `jsonb` column. Stores JSON in decomposed binary format for efficient querying. Maps to `unknown` (use `$type<T>()` to narrow). */
+function jsonb(config) {
+	return new JsonbColumn(config);
+}
+//#endregion
+export { jsonb };

package/dist/src/columns/macaddr.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/macaddr.d.ts
+type MacaddrValType = string;
+type MacaddrConfig = ColumnConfig;
+declare class MacaddrColumn<TConfig extends MacaddrConfig> extends Column<TConfig, MacaddrValType> {
+  static readonly id = "Column.Macaddr";
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodMAC;
+  toDriverScalar(value: MacaddrValType | Sql | null): string | null;
+  toSQLScalar(value: string | Sql | null): string;
+  fromDriverScalar(value: string | null): MacaddrValType | null;
+}
+/** Creates a `macaddr` column. PostgreSQL MAC address type, maps to `string`. */
+declare function macaddr<TConfig extends MacaddrConfig>(config: TConfig): MacaddrColumn<TConfig>;
+//#endregion
+export { macaddr };

package/dist/src/columns/macaddr.mjs

@@ -0,0 +1,31 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/macaddr.ts
+var MacaddrColumn = class extends Column {
+	static id = "Column.Macaddr";
+	get sqlTypeScalar() {
+		return "macaddr";
+	}
+	get zodTypeScaler() {
+		return z.mac();
+	}
+	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 `macaddr` column. PostgreSQL MAC address type, maps to `string`. */
+function macaddr(config) {
+	return new MacaddrColumn(config);
+}
+//#endregion
+export { macaddr };

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

@@ -0,0 +1,42 @@
+import { Sql } from "../sql.mjs";
+import { Column, ColumnConfig } from "./common.mjs";
+import * as z from "zod";
+
+//#region src/columns/numeric.d.ts
+type NumericValType = string;
+type NumericConfig = ColumnConfig & {
+  /**
+   * The total number of significant digits (1-1000).
+   * If omitted, values of any precision can be stored.
+   */
+  precision?: number;
+  /**
+   * The number of digits after the decimal point.
+   * If omitted, defaults to 0 when precision is specified.
+   */
+  scale?: number;
+};
+declare class NumericColumn<TConfig extends NumericConfig> extends Column<TConfig, NumericValType> {
+  #private;
+  static readonly id = "Column.Numeric";
+  constructor(config: TConfig);
+  get sqlTypeScalar(): string;
+  get zodTypeScaler(): z.ZodString;
+  toDriverScalar(value: NumericValType | Sql | null): string | null;
+  toSQLScalar(value: string | Sql | null): string;
+  fromDriverScalar(value: string | null): NumericValType | null;
+}
+/**
+ * Creates a `numeric` column. Arbitrary-precision number, maps to `string` to avoid floating-point loss.
+ *
+ * @example
+ * ```ts
+ * numeric({ precision: 10, scale: 2, notNull }) // numeric(10,2) NOT NULL
+ * ```
+ *
+ * @param config.precision - Total significant digits (1–1000). Omit for unlimited.
+ * @param config.scale - Digits after the decimal point. Defaults to 0 when precision is set.
+ */
+declare function numeric<TConfig extends NumericConfig>(config: TConfig): NumericColumn<TConfig>;
+//#endregion
+export { numeric };

package/dist/src/columns/numeric.mjs

@@ -0,0 +1,57 @@
+import { Column } from "./common.mjs";
+import { Sql } from "../sql.mjs";
+import * as z from "zod";
+//#region src/columns/numeric.ts
+var NumericColumn = class extends Column {
+	static id = "Column.Numeric";
+	#precision;
+	#scale;
+	constructor(config) {
+		super(config);
+		this.#precision = config.precision;
+		this.#scale = config.scale;
+	}
+	get sqlTypeScalar() {
+		if (this.#precision !== void 0) {
+			if (this.#scale !== void 0) return `numeric(${this.#precision},${this.#scale})`;
+			return `numeric(${this.#precision})`;
+		}
+		return "numeric";
+	}
+	get zodTypeScaler() {
+		return z.string().refine((val) => {
+			const num = Number(val);
+			return !Number.isNaN(num) && Number.isFinite(num);
+		}, { message: "Invalid numeric value" });
+	}
+	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;
+		Number(value);
+		return value;
+	}
+	fromDriverScalar(value) {
+		if (value === null) return null;
+		return typeof value === "string" ? value : String(value);
+	}
+};
+/**
+* Creates a `numeric` column. Arbitrary-precision number, maps to `string` to avoid floating-point loss.
+*
+* @example
+* ```ts
+* numeric({ precision: 10, scale: 2, notNull }) // numeric(10,2) NOT NULL
+* ```
+*
+* @param config.precision - Total significant digits (1–1000). Omit for unlimited.
+* @param config.scale - Digits after the decimal point. Defaults to 0 when precision is set.
+*/
+function numeric(config) {
+	return new NumericColumn(config);
+}
+//#endregion
+export { numeric };

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

@@ -0,0 +1,18 @@
+import { linestring } from "./linestring.mjs";
+import { multilinestring } from "./multilinestring.mjs";
+import { multipoint } from "./multipoint.mjs";
+import { multipolygon } from "./multipolygon.mjs";
+import { point } from "./point.mjs";
+import { polygon } from "./polygon.mjs";
+
+//#region src/columns/postgis/geography/index.d.ts
+declare const geography: {
+  point: typeof point;
+  multipoint: typeof multipoint;
+  linestring: typeof linestring;
+  multilinestring: typeof multilinestring;
+  polygon: typeof polygon;
+  multipolygon: typeof multipolygon;
+};
+//#endregion
+export { geography };

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

@@ -0,0 +1,17 @@
+import { linestring } from "./linestring.mjs";
+import { multilinestring } from "./multilinestring.mjs";
+import { multipoint } from "./multipoint.mjs";
+import { multipolygon } from "./multipolygon.mjs";
+import { point } from "./point.mjs";
+import { polygon } from "./polygon.mjs";
+//#region src/columns/postgis/geography/index.ts
+const geography = {
+	point,
+	multipoint,
+	linestring,
+	multilinestring,
+	polygon,
+	multipolygon
+};
+//#endregion
+export { geography };

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

@@ -0,0 +1,38 @@
+import { Sql } from "../../../sql.mjs";
+import { Column, ColumnConfig } from "../../common.mjs";
+import * as z from "zod";
+
+//#region src/columns/postgis/geography/linestring.d.ts
+type As = "xy" | "xyz" | "xym" | "xyzm";
+type LineStringConfig = 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 GetValType<T extends As | undefined> = SelfOrReadonly<GetPointType<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<GetPointZodType<T>>;
+declare class LineStringColumn<TConfig extends LineStringConfig> extends Column<TConfig, GetValType<TConfig["format"]>> {
+  #private;
+  static readonly id = "Column.Geography.LineString";
+  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(LINESTRING)` column. Maps to an array of `[lon, lat]` tuples.
+ *
+ * @example
+ * ```ts
+ * geography.linestring({ srid: 4326 }) // geography(LINESTRING, 4326)
+ * ```
+ *
+ * @param config.srid - Spatial reference ID (default: 4326)
+ * @param config.format - Coordinate format: `"xy"` (default: `"xy"`)
+ */
+declare function linestring<TConfig extends LineStringConfig>(config: TConfig): LineStringColumn<TConfig>;
+//#endregion
+export { linestring };

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

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

package/dist/src/columns/postgis/geography/multilinestring.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/multilinestring.d.ts
+type As = "xy" | "xyz" | "xym" | "xyzm";
+type MultiLineStringConfig = 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 GetLineType<T extends As | undefined> = SelfOrReadonly<GetPointType<T>[]>;
+type GetValType<T extends As | undefined> = SelfOrReadonly<GetLineType<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 MultiLineStringColumn<TConfig extends MultiLineStringConfig> extends Column<TConfig, GetValType<TConfig["format"]>> {
+  #private;
+  static readonly id = "Column.Geography.MultiLineString";
+  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(MULTILINESTRING)` column. Maps to an array of linestrings.
+ *
+ * @example
+ * ```ts
+ * geography.multilinestring({ srid: 4326 }) // geography(MULTILINESTRING, 4326)
+ * ```
+ *
+ * @param config.srid - Spatial reference ID (default: 4326)
+ * @param config.format - Coordinate format: `"xy"` (default: `"xy"`)
+ */
+declare function multilinestring<TConfig extends MultiLineStringConfig>(config: TConfig): MultiLineStringColumn<TConfig>;
+//#endregion
+export { multilinestring };

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

@@ -0,0 +1,70 @@
+import { Column } from "../../common.mjs";
+import { Sql } from "../../../sql.mjs";
+import { MultiLineString } from "../../../wkx/multilinestring.mjs";
+import "../../../wkx/index.mjs";
+import * as z from "zod";
+//#region src/columns/postgis/geography/multilinestring.ts
+var MultiLineStringColumn = class extends Column {
+	static id = "Column.Geography.MultiLineString";
+	#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(MULTILINESTRING, ${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 multiLineString = MultiLineString.parseGeoJSON({
+			type: "MultiLineString",
+			coordinates: value
+		});
+		return `SRID=${this.#srid};${multiLineString.toWkt()}`;
+	}
+	toSQLScalar(value) {
+		if (value === null) return "NULL";
+		if (value instanceof Sql) return value.string;
+		const multiLineString = MultiLineString.parseGeoJSON({
+			type: "MultiLineString",
+			coordinates: value
+		});
+		return `'SRID=${this.#srid};${multiLineString.toWkt()}'`;
+	}
+	fromDriverScalar(value) {
+		if (value === null) return value;
+		const buffer = Buffer.from(value, "hex");
+		return MultiLineString.parse(buffer, {
+			srid: this.#srid,
+			hasZ: this.#hasZ,
+			hasM: this.#hasM
+		}).toGeoJSON().coordinates;
+	}
+};
+/**
+* Creates a PostGIS `geography(MULTILINESTRING)` column. Maps to an array of linestrings.
+*
+* @example
+* ```ts
+* geography.multilinestring({ srid: 4326 }) // geography(MULTILINESTRING, 4326)
+* ```
+*
+* @param config.srid - Spatial reference ID (default: 4326)
+* @param config.format - Coordinate format: `"xy"` (default: `"xy"`)
+*/
+function multilinestring(config) {
+	return new MultiLineStringColumn(config);
+}
+//#endregion
+export { multilinestring };

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

@@ -0,0 +1,38 @@
+import { Sql } from "../../../sql.mjs";
+import { Column, ColumnConfig } from "../../common.mjs";
+import * as z from "zod";
+
+//#region src/columns/postgis/geography/multipoint.d.ts
+type As = "xy" | "xyz" | "xym" | "xyzm";
+type MultiPointConfig = 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 GetValType<T extends As | undefined> = SelfOrReadonly<GetPointType<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<GetPointZodType<T>>;
+declare class MultiPointColumn<TConfig extends MultiPointConfig> extends Column<TConfig, GetValType<TConfig["format"]>> {
+  #private;
+  static readonly id = "Column.Geography.MultiPoint";
+  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(MULTIPOINT)` column. Maps to an array of `[lon, lat]` tuples.
+ *
+ * @example
+ * ```ts
+ * geography.multipoint({ srid: 4326 }) // geography(MULTIPOINT, 4326)
+ * ```
+ *
+ * @param config.srid - Spatial reference ID (default: 4326)
+ * @param config.format - Coordinate format: `"xy"` (default: `"xy"`)
+ */
+declare function multipoint<TConfig extends MultiPointConfig>(config: TConfig): MultiPointColumn<TConfig>;
+//#endregion
+export { multipoint };

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

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

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

@@ -0,0 +1,40 @@
+import { Sql } from "../../../sql.mjs";
+import { Column, ColumnConfig } from "../../common.mjs";
+import * as z from "zod";
+
+//#region src/columns/postgis/geography/multipolygon.d.ts
+type As = "xy" | "xyz" | "xym" | "xyzm";
+type MultiPolygonConfig = 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 GetPolygonType<T extends As | undefined> = SelfOrReadonly<GetRingType<T>[]>;
+type GetValType<T extends As | undefined> = SelfOrReadonly<GetPolygonType<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<z.ZodArray<GetPointZodType<T>>>>;
+declare class MultiPolygonColumn<TConfig extends MultiPolygonConfig> extends Column<TConfig, GetValType<TConfig["format"]>> {
+  #private;
+  static readonly id = "Column.Geography.MultiPolygon";
+  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(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"`)
+ */
+declare function multipolygon<TConfig extends MultiPolygonConfig>(config: TConfig): MultiPolygonColumn<TConfig>;
+//#endregion
+export { multipolygon };