durcno 1.0.0-alpha.1 → 1.0.0-alpha.3

package/README.md

@@ -1,8 +1,11 @@
 <p align="center">
-  <img src="https://img.shields.io/npm/v/durcno?style=flat&color=blue" alt="npm version" />
+  <a href="https://npmjs.com/package/durcno" target="_blank">
+    <img src="https://img.shields.io/npm/v/durcno?style=flat&logo=npm&color=339933" alt="npm version" />
+  </a>
+  <img src="https://img.shields.io/badge/Node.js-24%2B-339933?style=flat&logo=node.js&logoColor=white" alt="Node.js 24+" />
   <img src="https://img.shields.io/badge/PostgreSQL-14%2B-336791?style=flat&logo=postgresql&logoColor=white" alt="PostgreSQL 14+" />
-  <img src="https://img.shields.io/badge/Node.js-25%2B-339933?style=flat&logo=node.js&logoColor=white" alt="Node.js" />
   <img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=flat" alt="License" />
+  <img src="https://img.shields.io/badge/vitest--green?logo=vitest" alt="License" />
 </p>
 
 <h1 align="center">Durcno</h1>
@@ -32,7 +35,7 @@ npm install durcno
 ```
 
 ```bash
-npx durcno init
+npm exec durcno init
 ```
 
 ## Getting Started

package/dist/bin.cjs

@@ -8903,19 +8903,17 @@ function resolveConfigPath(argPath) {
   }
   return (0, import_node_path2.resolve)(process.cwd(), DURCNO_CONFIG_NAME);
 }
-function getSetup(argPath) {
-  const absPath = resolveConfigPath(argPath);
-  const mod = require(absPath);
-  const { default: setup } = mod;
-  return setup;
+async function loadConfig(absPath) {
+  const mod = await import(absPath);
+  return mod.default;
 }
 
 // src/cli/commands/down.ts
 var { bgGreen, dim, cyan: cyan2, yellow: yellow2, red: red2 } = source_default;
 async function down(m, options) {
   const configPath = resolveConfigPath(options.config);
-  const { connector, config: config2 } = getSetup(configPath);
-  config2.pool = { ...config2.pool, max: 1 };
+  const config2 = await loadConfig(configPath);
+  const { connector } = config2;
   const migrationsDir = (0, import_node_path3.resolve)(
     (0, import_node_path3.dirname)(configPath),
     config2.out || DEFAULT_MIGRATIONS_DIR
@@ -8925,7 +8923,7 @@ async function down(m, options) {
   const client = connector.getClient();
   await client.connect();
   if (await migrationsTableExists(client)) {
-    const db = (0, import_durcno2.database)({ Migrations: import_durcno2.Migrations }, { connector, config: config2 });
+    const db = (0, import_durcno2.database)({ Migrations: import_durcno2.Migrations }, config2);
     const migrations = await db.from(import_durcno2.Migrations).select();
     const migrationDirsReversed = migrationDirNames.sort().reverse();
     for (let i = 0; i < migrationDirsReversed.length; i++) {
@@ -8939,7 +8937,7 @@ async function down(m, options) {
           migrationDirName,
           isFirstMigration,
           migrationsDir,
-          { connector, config: config2 },
+          config2,
           client
         );
         if (migration.name === m) {
@@ -8954,7 +8952,7 @@ async function down(m, options) {
   await client.close();
   process.exit(0);
 }
-async function runDownMigration(migrationDirName, isFirstMigration, migrationsDirPath, setup, client) {
+async function runDownMigration(migrationDirName, isFirstMigration, migrationsDirPath, config2, client) {
   const migrationName = (0, import_node_path3.basename)(migrationDirName);
   const downPath = (0, import_node_path3.join)(migrationsDirPath, migrationName, "down.ts");
   try {
@@ -8987,7 +8985,9 @@ async function runDownMigration(migrationDirName, isFirstMigration, migrationsDi
       throw e;
     }
     if (!isFirstMigration) {
-      const db = (0, import_durcno2.database)({ Migrations: import_durcno2.Migrations }, setup);
+      config2.connector.pool = { ...config2.connector.pool, max: 1 };
+      config2.connector.logger = void 0;
+      const db = (0, import_durcno2.database)({ Migrations: import_durcno2.Migrations }, config2);
       await db.delete(import_durcno2.Migrations).where((0, import_durcno2.eq)(import_durcno2.Migrations.name, migrationName));
       await db.close();
     }
@@ -11695,8 +11695,11 @@ var Arg = class {
   index = 0;
   key = "";
   handler;
-  constructor(handler) {
+  /** PostgreSQL cast type suffix (e.g. `"boolean"`, `"geography"`), or `null` if no cast needed. */
+  cast = null;
+  constructor(handler, cast = null) {
     this.handler = handler;
+    this.cast = cast;
   }
 };
 
@@ -11802,6 +11805,14 @@ var Column = class {
     const suffix = this.config.dimension.map((d) => d === null ? "[]" : `[${d}]`).join("");
     return `${base}${suffix}`;
   }
+  /** Returns the full PostgreSQL cast type including array dimensions, or `null` if no cast is needed. */
+  get sqlCast() {
+    const base = this.sqlCastScalar;
+    if (base === null) return null;
+    if (!this.config.dimension) return base;
+    const suffix = this.config.dimension.map((d) => d === null ? "[]" : `[${d}]`).join("");
+    return `${base}${suffix}`;
+  }
   get zodType() {
     let schema = this.zodTypeScaler;
     if (!this.config.dimension) {
@@ -11852,29 +11863,33 @@ var Column = class {
    * Converts a JavaScript value to SQL string literal.
    * Handles array dimensions with ARRAY[...] syntax if configured.
    */
-  toSQL(value) {
+  toSQL(value, options) {
+    if (value === null) return "NULL";
     if (value instanceof Sql) return value.string;
     if (!this.config.dimension) {
-      return this.toSQLScalar(value);
+      if (!options?.cast || !this.sqlCastScalar) return this.toSQLScalar(value);
+      return `${this.toSQLScalar(value)}::${this.sqlCastScalar}`;
     }
-    return this.#toSQLArray(value, 0);
+    return this.#toSQLArray(value, 0, options);
   }
   /**
    * Helper to recursively process multi-dimensional arrays for toSQL.
    */
-  #toSQLArray(arr, dimIndex) {
+  #toSQLArray(arr, dimIndex, options) {
     const dimensions = this.config.dimension;
     if (arr.length === 0) {
       return "'{}'";
     }
     if (dimIndex >= dimensions.length - 1) {
-      const elements2 = arr.map(
-        (item) => this.toSQLScalar(item)
-      );
+      const elements2 = arr.map((item) => {
+        if (!options?.cast || !this.sqlCastScalar)
+          return this.toSQLScalar(item);
+        return `${this.toSQLScalar(item)}::${this.sqlCastScalar}`;
+      });
       return `ARRAY[${elements2.join(", ")}]`;
     }
     const elements = arr.map(
-      (item) => this.#toSQLArray(item, dimIndex + 1)
+      (item) => this.#toSQLArray(item, dimIndex + 1, options)
     );
     return `ARRAY[${elements.join(", ")}]`;
   }
@@ -12044,7 +12059,7 @@ var Column = class {
    * @returns an `Arg` instance with the type of this column
    */
   arg() {
-    return new Arg(this.toDriver.bind(this));
+    return new Arg(this.toDriver.bind(this), this.sqlCast);
   }
 };
 
@@ -12219,7 +12234,7 @@ async function promptColumnRenames(prev, curr, renamedTables) {
 }
 async function generate(options) {
   const configPath = resolveConfigPath(options.config);
-  const { config: config2 } = getSetup(configPath);
+  const config2 = await loadConfig(configPath);
   const migrationsDir = (0, import_node_path4.resolve)(
     (0, import_node_path4.dirname)(configPath),
     config2.out || DEFAULT_MIGRATIONS_DIR
@@ -12231,7 +12246,7 @@ async function generate(options) {
   const ssPrevious = (0, import_migration2.createEmptySnapshot)();
   for (const migrationFolder of migrationFolderNames.sort()) {
     const upTsPath = (0, import_node_path4.resolve)(migrationsDir, migrationFolder, "up.ts");
-    const upModule = require(upTsPath);
+    const upModule = await import(upTsPath);
     const statements = upModule.statements;
     for (const statement of statements) {
       statement.applyToSnapshot(ssPrevious);
@@ -12241,7 +12256,7 @@ async function generate(options) {
     configPath ? (0, import_node_path4.dirname)(configPath) : process.cwd(),
     config2.schema
   );
-  const exports2 = require(schemaFile);
+  const exports2 = await import(schemaFile);
   ensureNoEntityCollisions(exports2);
   const entities = Object.values(exports2);
   const ssCurrent = (0, import_migration2.snapshot)(entities);
@@ -12584,6 +12599,22 @@ function generateAlterTableStmts(prevTable, currTable, tableName, curr, statemen
           alterStatements.push(`.dropDefault("${colName}")`);
         }
       }
+      const prevRefJson = JSON.stringify(prevCol.references ?? null);
+      const currRefJson = JSON.stringify(currCol.references ?? null);
+      if (prevRefJson !== currRefJson) {
+        if (prevCol.references) {
+          const constraintName = `${currTable.name}_${colName}_fkey`;
+          alterStatements.push(
+            `.dropForeignKey("${constraintName}", "${colName}")`
+          );
+        }
+        if (currCol.references) {
+          const constraintName = `${currTable.name}_${colName}_fkey`;
+          alterStatements.push(
+            `.addForeignKey("${constraintName}", "${colName}", ${JSON.stringify(currCol.references)})`
+          );
+        }
+      }
     }
   }
   for (const idxName in currTable.indexes) {
@@ -12772,12 +12803,14 @@ function generateConfigFile(config2) {
   return `${envLoader}import { defineConfig } from "durcno";
 import { ${funcName} } from "durcno/connectors/${connector}";
 
-export default defineConfig(${funcName}(), {
+export default defineConfig({
   schema: "${schemaPath}",
   out: "${migrationsDir}",
-  dbCredentials: {
-    url: ${urlValue},
-  },
+  connector: ${funcName}({
+    dbCredentials: {
+      url: ${urlValue},
+    },
+  }),
 });
 `;
 }
@@ -12799,40 +12832,11 @@ function generateIndexFile(schemaPath) {
   const schemaImport = schemaPath.replace(/^db\//, "./");
   return `import { database } from "durcno";
 import * as schema from "${schemaImport}";
-import setup from "../durcno.config.ts";
+import config from "../durcno.config.ts";
 
-export const db = database(schema, setup);
+export const db = database(schema, config);
 `;
 }
-function setTypeModule() {
-  const pkgPath = (0, import_node_path5.resolve)(process.cwd(), "package.json");
-  if (!(0, import_node_fs3.existsSync)(pkgPath)) {
-    (0, import_node_fs3.writeFileSync)(pkgPath, `${JSON.stringify({ type: "module" }, null, 2)}
-`);
-    console.log(
-      bold(
-        `${green("\u2714")} Created ${cyan4("package.json")} with "type": "module"`
-      )
-    );
-    return;
-  }
-  try {
-    const pkgContent = (0, import_node_fs3.readFileSync)(pkgPath, "utf-8");
-    const pkg = JSON.parse(pkgContent);
-    if (pkg.type !== "module") {
-      pkg.type = "module";
-      (0, import_node_fs3.writeFileSync)(pkgPath, `${JSON.stringify(pkg, null, 2)}
-`);
-      console.log(
-        bold(
-          `${green("\u2714")} Updated ${cyan4("package.json")} with "type": "module"`
-        )
-      );
-    }
-  } catch (err) {
-    console.log(yellow4(`Warning: Failed to update package.json: ${err}`));
-  }
-}
 async function promptConfig() {
   const response = await (0, import_prompts2.default)(
     [
@@ -12925,7 +12929,6 @@ async function init(options) {
     config2 = DEFAULTS;
   }
   await writeFiles(config2, options);
-  setTypeModule();
   console.log(green.bold("\n\u{1F4E6} Setup dependencies\n"));
   const toInstall = [];
   const toInstallDrivers = [];
@@ -12979,7 +12982,7 @@ Installation failed with exit code ${exitCode}`)
   }
   console.log(green.bold("\n\u2728 Durcno Setuped!\n"));
   console.log(dim2("Next steps:"));
-  const execCmd = pm === "npm" ? "npx" : pm === "pnpm" ? "pnpm exec" : pm === "bun" ? "bun x" : pm;
+  const execCmd = pm === "npm" ? "npm exec" : pm === "pnpm" ? "pnpm exec" : pm === "bun" ? "bunx" : pm;
   const nextSteps = [
     ["Edit your schema in", magenta.bold(config2.schemaPath)],
     ["Run", cyan4.bold(`${execCmd} durcno generate`), "to create migrations"],
@@ -13000,8 +13003,8 @@ var import_durcno3 = require("durcno");
 var { bgGreen: bgGreen3, bgYellow, dim: dim3, gray: gray4, yellow: yellow5, green: green2, cyan: cyan5 } = source_default;
 async function migrate(options) {
   const configPath = resolveConfigPath(options.config);
-  const { connector, config: config2 } = getSetup(configPath);
-  config2.pool = { ...config2.pool, max: 1 };
+  const config2 = await loadConfig(configPath);
+  const { connector } = config2;
   const migrationsDir = (0, import_node_path6.resolve)(
     (0, import_node_path6.dirname)(configPath),
     config2.out || DEFAULT_MIGRATIONS_DIR
@@ -13014,16 +13017,13 @@ async function migrate(options) {
   try {
     let previouslyApplied = [];
     if (await migrationsTableExists(client)) {
-      const db = (0, import_durcno3.database)({ Migrations: import_durcno3.Migrations }, { connector, config: config2 });
+      const db = (0, import_durcno3.database)({ Migrations: import_durcno3.Migrations }, config2);
       const records = await db.from(import_durcno3.Migrations).select();
       previouslyApplied = records.map((r) => r.name);
     }
     for (const migrationDirName of migrationDirNames.sort()) {
       if (!previouslyApplied.includes(migrationDirName)) {
-        await runUpMigration(migrationDirName, migrationsDir, client, {
-          connector,
-          config: config2
-        });
+        await runUpMigration(migrationDirName, migrationsDir, client, config2);
         appliedMigrations.push(migrationDirName);
       }
     }
@@ -13039,7 +13039,7 @@ async function migrate(options) {
           migrationFolder,
           isFirstMigration,
           migrationsDir,
-          { connector, config: config2 },
+          config2,
           client
         );
       }
@@ -13053,7 +13053,7 @@ async function migrate(options) {
   await client.close();
   process.exit(0);
 }
-async function runUpMigration(migrationDirName, migrationsDir, client, setup) {
+async function runUpMigration(migrationDirName, migrationsDir, client, config2) {
   const upPath = (0, import_node_path6.join)(migrationsDir, migrationDirName, "up.ts");
   const migrationModule = await import(upPath);
   const statements = migrationModule.statements;
@@ -13080,7 +13080,9 @@ async function runUpMigration(migrationDirName, migrationsDir, client, setup) {
     console.log(
       bgGreen3.white.bold("[APPLIED]") + " " + green2(`Migration ${cyan5(migrationDirName)}`) + dim3(".")
     );
-    const db = (0, import_durcno3.database)({ Migrations: import_durcno3.Migrations }, setup);
+    config2.connector.pool = { ...config2.connector.pool, max: 1 };
+    config2.connector.logger = void 0;
+    const db = (0, import_durcno3.database)({ Migrations: import_durcno3.Migrations }, config2);
     await db.insert(import_durcno3.Migrations).values({
       name: migrationDirName,
       createdAt: /* @__PURE__ */ new Date()
@@ -13105,7 +13107,7 @@ var import_node_readline = require("node:readline");
 var { cyan: cyan6, green: green3, red: red4, yellow: yellow6, gray: gray5, bgCyan, bold: bold2 } = source_default;
 async function shell(options) {
   const configPath = resolveConfigPath(options.config);
-  const { connector } = getSetup(configPath);
+  const { connector } = await loadConfig(configPath);
   const client = connector.getClient();
   console.log(gray5("Connecting to database..."));
   await client.connect();
@@ -13351,7 +13353,7 @@ var import_migration3 = require("durcno/migration");
 var { bgGreen: bgGreen4, bgRed: bgRed2, yellow: yellow7, red: red5, green: green4, cyan: cyan7, gray: gray6 } = source_default;
 async function squash(start, end, options) {
   const configPath = resolveConfigPath(options.config);
-  const { config: config2 } = getSetup(configPath);
+  const config2 = await loadConfig(configPath);
   const migrationsDir = (0, import_node_path7.resolve)(
     (0, import_node_path7.dirname)(configPath),
     config2.out || DEFAULT_MIGRATIONS_DIR
@@ -13389,7 +13391,7 @@ async function squash(start, end, options) {
   let hasCustomStatements = false;
   for (const migrationDirName of range) {
     const upPath = (0, import_node_path7.join)(migrationsDir, migrationDirName, "up.ts");
-    const upModule = require(upPath);
+    const upModule = await import(upPath);
     const statements = upModule.statements;
     if (statements.some((st) => st.isCustom)) {
       hasCustomStatements = true;
@@ -13407,7 +13409,7 @@ async function squash(start, end, options) {
   const beforeSnapshot = (0, import_migration3.createEmptySnapshot)();
   for (const migrationDirName of before) {
     const upPath = (0, import_node_path7.join)(migrationsDir, migrationDirName, "up.ts");
-    const upModule = require(upPath);
+    const upModule = await import(upPath);
     const statements = upModule.statements;
     for (const statement of statements) {
       statement.applyToSnapshot(beforeSnapshot);
@@ -13416,7 +13418,7 @@ async function squash(start, end, options) {
   const afterRangeSnapshot = (0, import_migration3.createEmptySnapshot)();
   for (const migrationDirName of [...before, ...range]) {
     const upPath = (0, import_node_path7.join)(migrationsDir, migrationDirName, "up.ts");
-    const upModule = require(upPath);
+    const upModule = await import(upPath);
     const statements = upModule.statements;
     for (const statement of statements) {
       statement.applyToSnapshot(afterRangeSnapshot);
@@ -13458,8 +13460,8 @@ var import_durcno4 = require("durcno");
 var { dim: dim4, cyan: cyan8, yellow: yellow8, green: green5 } = source_default;
 async function status(options) {
   const configPath = resolveConfigPath(options.config);
-  const { connector, config: config2 } = getSetup(configPath);
-  config2.pool = { ...config2.pool, max: 1 };
+  const config2 = await loadConfig(configPath);
+  const { connector } = config2;
   const migrationsDir = (0, import_node_path8.resolve)(
     (0, import_node_path8.dirname)(configPath),
     config2.out || DEFAULT_MIGRATIONS_DIR
@@ -13470,7 +13472,7 @@ async function status(options) {
     console.log(source_default.yellow("No migrations found."));
     process.exit(0);
   }
-  const db = (0, import_durcno4.database)({ Migrations: import_durcno4.Migrations }, { connector, config: config2 });
+  const db = (0, import_durcno4.database)({ Migrations: import_durcno4.Migrations }, config2);
   const migrationsQuery = db.from(import_durcno4.Migrations).select();
   let migrations;
   const client = connector.getClient();
@@ -13503,7 +13505,7 @@ async function status(options) {
 }
 
 // src/cli/index.ts
-program.version("1.0.0-alpha.0");
+program.version("1.0.0-alpha.2");
 var Options = {
   config: ["--config <path>", "Path to the config file"]
 };

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

@@ -8,6 +8,7 @@ type BigintConfig = ColumnConfig;
 declare class BigintColumn<TConfig extends BigintConfig> extends Column<TConfig, BigintValType> {
   static readonly id = "Column.Bigint";
   get sqlTypeScalar(): string;
+  get sqlCastScalar(): null;
   get zodTypeScaler(): z.ZodCoercedNumber<unknown>;
   toDriverScalar(value: BigintValType | Sql | null): string | number | null;
   toSQLScalar(value: number | Sql | null): string;

package/dist/src/columns/bigint.mjs

@@ -7,6 +7,9 @@ var BigintColumn = class extends Column {
 	get sqlTypeScalar() {
 		return "bigint";
 	}
+	get sqlCastScalar() {
+		return null;
+	}
 	get zodTypeScaler() {
 		return z.coerce.number();
 	}

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

@@ -13,6 +13,7 @@ declare class BigserialColumn<TConfig extends BigserialConfig> extends Column<Bi
   static readonly id = "Column.Bigserial";
   constructor(config: TConfig);
   get sqlTypeScalar(): string;
+  get sqlCastScalar(): null;
   get zodTypeScaler(): z.ZodCoercedNumber<unknown>;
   toDriverScalar(value: BigserialValType | Sql | null): string | number | null;
   toSQLScalar(value: number | Sql | null): string;

package/dist/src/columns/bigserial.mjs

@@ -10,6 +10,9 @@ var BigserialColumn = class extends Column {
 	get sqlTypeScalar() {
 		return "bigserial";
 	}
+	get sqlCastScalar() {
+		return null;
+	}
 	get zodTypeScaler() {
 		return z.coerce.number();
 	}

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

@@ -8,6 +8,7 @@ type BooleanConfig = ColumnConfig;
 declare class BooleanColumn<TConfig extends BooleanConfig> extends Column<TConfig, BooleanValType> {
   static readonly id = "Column.Boolean";
   get sqlTypeScalar(): string;
+  get sqlCastScalar(): string;
   get zodTypeScaler(): z.ZodBoolean;
   toDriverScalar(value: BooleanValType | Sql | null): string | null;
   toSQLScalar(value: boolean | Sql | null): string;

package/dist/src/columns/boolean.mjs

@@ -7,6 +7,9 @@ var BooleanColumn = class extends Column {
 	get sqlTypeScalar() {
 		return "boolean";
 	}
+	get sqlCastScalar() {
+		return "boolean";
+	}
 	get zodTypeScaler() {
 		return z.boolean();
 	}

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

@@ -8,6 +8,7 @@ type ByteaConfig = ColumnConfig;
 declare class ByteaColumn<TConfig extends ByteaConfig> extends Column<TConfig, ByteaValType> {
   static readonly id = "Column.Bytea";
   get sqlTypeScalar(): string;
+  get sqlCastScalar(): string;
   get zodTypeScaler(): z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>;
   toDriverScalar(value: ByteaValType | Sql | null): string | null;
   toSQLScalar(value: ByteaValType | Sql | null): string;

package/dist/src/columns/bytea.mjs

@@ -7,6 +7,9 @@ var ByteaColumn = class extends Column {
 	get sqlTypeScalar() {
 		return "bytea";
 	}
+	get sqlCastScalar() {
+		return "bytea";
+	}
 	get zodTypeScaler() {
 		return z.instanceof(Buffer);
 	}

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

@@ -12,6 +12,7 @@ declare class CharColumn<TConfig extends CharConfig> extends Column<TConfig, Cha
   static readonly id = "Column.Char";
   constructor(config: TConfig);
   get sqlTypeScalar(): string;
+  get sqlCastScalar(): null;
   get zodTypeScaler(): z.ZodString;
   toDriverScalar(value: CharValType | Sql | null): string | null;
   toSQLScalar(value: string | Sql | null): string;

package/dist/src/columns/char.mjs

@@ -12,6 +12,9 @@ var CharColumn = class extends Column {
 	get sqlTypeScalar() {
 		return `char(${this.#length})`;
 	}
+	get sqlCastScalar() {
+		return null;
+	}
 	get zodTypeScaler() {
 		return z.string().length(this.#length);
 	}

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

@@ -8,6 +8,7 @@ type CidrConfig = ColumnConfig;
 declare class CidrColumn<TConfig extends CidrConfig> extends Column<TConfig, CidrValType> {
   static readonly id = "Column.Cidr";
   get sqlTypeScalar(): string;
+  get sqlCastScalar(): string;
   get zodTypeScaler(): z.ZodUnion<readonly [z.ZodCIDRv4, z.ZodCIDRv6]>;
   toDriverScalar(value: CidrValType | Sql | null): string | null;
   toSQLScalar(value: string | Sql | null): string;

package/dist/src/columns/cidr.mjs

@@ -7,6 +7,9 @@ var CidrColumn = class extends Column {
 	get sqlTypeScalar() {
 		return "cidr";
 	}
+	get sqlCastScalar() {
+		return "cidr";
+	}
 	get zodTypeScaler() {
 		return z.union([z.cidrv4(), z.cidrv6()]);
 	}

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

@@ -1,7 +1,7 @@
 import { Sql } from "../sql.mjs";
 import { entityType } from "../symbols.mjs";
-import { Arg } from "../query-builders/pre.mjs";
 import { StdTableColumn, TableColumn } from "../table.mjs";
+import { Arg } from "../query-builders/pre.mjs";
 import * as z from "zod";
 
 //#region src/columns/common.d.ts
@@ -158,6 +158,10 @@ declare abstract class Column<TConfig extends ColumnConfig, TColVal> {
   } ? true : false;
   abstract get sqlTypeScalar(): string;
   get sqlType(): string;
+  /** Returns the PostgreSQL cast type for this column's scalar value, or `null` if no cast is needed. */
+  abstract get sqlCastScalar(): string | null;
+  /** Returns the full PostgreSQL cast type including array dimensions, or `null` if no cast is needed. */
+  get sqlCast(): string | null;
   abstract get zodTypeScaler(): z.ZodType;
   get zodType(): GetZodTypeArray<this["zodTypeScaler"], this["config"]>;
   /**
@@ -177,7 +181,9 @@ declare abstract class Column<TConfig extends ColumnConfig, TColVal> {
    * Converts a JavaScript value to SQL string literal.
    * Handles array dimensions with ARRAY[...] syntax if configured.
    */
-  toSQL(value: this["ValType"] | Sql | null): string;
+  toSQL(value: this["ValType"] | Sql | null, options?: {
+    cast?: boolean;
+  }): string;
   /**
    * Converts a PostgreSQL result back to JavaScript value.
    * Handles array dimensions if configured, otherwise delegates to scalar implementation.

package/dist/src/columns/common.mjs

@@ -77,6 +77,13 @@ var Column = class {
 		if (!this.config.dimension) return base;
 		return `${base}${this.config.dimension.map((d) => d === null ? "[]" : `[${d}]`).join("")}`;
 	}
+	/** Returns the full PostgreSQL cast type including array dimensions, or `null` if no cast is needed. */
+	get sqlCast() {
+		const base = this.sqlCastScalar;
+		if (base === null) return null;
+		if (!this.config.dimension) return base;
+		return `${base}${this.config.dimension.map((d) => d === null ? "[]" : `[${d}]`).join("")}`;
+	}
 	get zodType() {
 		let schema = this.zodTypeScaler;
 		if (!this.config.dimension) return schema;
@@ -112,19 +119,26 @@ var Column = class {
 	* Converts a JavaScript value to SQL string literal.
 	* Handles array dimensions with ARRAY[...] syntax if configured.
 	*/
-	toSQL(value) {
+	toSQL(value, options) {
+		if (value === null) return "NULL";
 		if (value instanceof Sql) return value.string;
-		if (!this.config.dimension) return this.toSQLScalar(value);
-		return this.#toSQLArray(value, 0);
+		if (!this.config.dimension) {
+			if (!options?.cast || !this.sqlCastScalar) return this.toSQLScalar(value);
+			return `${this.toSQLScalar(value)}::${this.sqlCastScalar}`;
+		}
+		return this.#toSQLArray(value, 0, options);
 	}
 	/**
 	* Helper to recursively process multi-dimensional arrays for toSQL.
 	*/
-	#toSQLArray(arr, dimIndex) {
+	#toSQLArray(arr, dimIndex, options) {
 		const dimensions = this.config.dimension;
 		if (arr.length === 0) return "'{}'";
-		if (dimIndex >= dimensions.length - 1) return `ARRAY[${arr.map((item) => this.toSQLScalar(item)).join(", ")}]`;
-		return `ARRAY[${arr.map((item) => this.#toSQLArray(item, dimIndex + 1)).join(", ")}]`;
+		if (dimIndex >= dimensions.length - 1) return `ARRAY[${arr.map((item) => {
+			if (!options?.cast || !this.sqlCastScalar) return this.toSQLScalar(item);
+			return `${this.toSQLScalar(item)}::${this.sqlCastScalar}`;
+		}).join(", ")}]`;
+		return `ARRAY[${arr.map((item) => this.#toSQLArray(item, dimIndex + 1, options)).join(", ")}]`;
 	}
 	/**
 	* Converts a PostgreSQL result back to JavaScript value.
@@ -269,7 +283,7 @@ var Column = class {
 	* @returns an `Arg` instance with the type of this column
 	*/
 	arg() {
-		return new Arg(this.toDriver.bind(this));
+		return new Arg(this.toDriver.bind(this), this.sqlCast);
 	}
 };
 //#endregion

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

@@ -8,6 +8,7 @@ type DateConfig = ColumnConfig;
 declare class DateColumn<TConfig extends DateConfig> extends Column<TConfig, DateValType> {
   static readonly id = "Column.Date";
   get sqlTypeScalar(): string;
+  get sqlCastScalar(): string;
   get zodTypeScaler(): z.ZodDate;
   toDriverScalar(value: DateValType | Sql | null): string | null;
   toSQLScalar(value: Date | Sql | null): string;

package/dist/src/columns/date.mjs

@@ -7,6 +7,9 @@ var DateColumn = class extends Column {
 	get sqlTypeScalar() {
 		return "date";
 	}
+	get sqlCastScalar() {
+		return "date";
+	}
 	get zodTypeScaler() {
 		return z.date();
 	}

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

@@ -10,6 +10,7 @@ declare class EnumedColumn<TValue extends string, TConfig extends EnumedConfig>
   static readonly id = "Column.Enumed";
   constructor(enm: Enum<TValue>, config: TConfig);
   get sqlTypeScalar(): string;
+  get sqlCastScalar(): string;
   get zodTypeScaler(): z.ZodEnum<{ [k_1 in TValue]: k_1 } extends infer T ? { [k in keyof T]: T[k] } : never>;
   toDriverScalar(value: TValue | Sql | null): string | null;
   toSQLScalar(value: TValue | Sql | null): string;