@warlock.js/cascade 5.7.0 → 5.8.0

package/esm/drivers/postgres/index.d.mts

@@ -1,6 +1,6 @@
 import { PostgresDialect } from "./postgres-dialect.mjs";
 import { PostgresConnectionConfig, PostgresCopyOptions, PostgresIsolationLevel, PostgresNotification, PostgresOperation, PostgresPoolConfig, PostgresQueryResult, PostgresTransactionOptions, PostgresWhereClause } from "./types.mjs";
-import { PostgresDriver } from "./postgres-driver.mjs";
+import { PostgresDriver, buildPostgresPoolConfig } from "./postgres-driver.mjs";
 import { PostgresBlueprint } from "./postgres-blueprint.mjs";
 import { PostgresMigrationDriver } from "./postgres-migration-driver.mjs";
 import { PostgresQueryBuilder } from "./postgres-query-builder.mjs";

package/esm/drivers/postgres/index.mjs

@@ -4,6 +4,6 @@ import { PostgresMigrationDriver } from "./postgres-migration-driver.mjs";
 import { PostgresQueryParser } from "./postgres-query-parser.mjs";
 import { PostgresQueryBuilder } from "./postgres-query-builder.mjs";
 import { PostgresSyncAdapter } from "./postgres-sync-adapter.mjs";
-import { PostgresDriver } from "./postgres-driver.mjs";
+import { PostgresDriver, buildPostgresPoolConfig } from "./postgres-driver.mjs";
 
 export {  };

package/esm/drivers/postgres/postgres-driver.d.mts

@@ -16,6 +16,23 @@ import { PostgresPoolConfig, PostgresQueryResult, PostgresTransactionOptions } f
  */
 type PgPool = import("pg").Pool;
 type PgPoolClient = import("pg").PoolClient;
+type PgPoolConfig = import("pg").PoolConfig;
+/**
+ * Build pg's `PoolConfig` from cascade's `PostgresPoolConfig`, coercing the
+ * string-typed connection fields.
+ *
+ * `env()` (@mongez/dotenv) coerces a numeric-looking value to a number, so a
+ * `DB_NAME` / `DB_USERNAME` / `DB_PASSWORD` like "12345" arrives here as a
+ * number. pg's connection fields must be strings — a number reaches deep into
+ * the driver and crashes with an inscrutable Buffer error rather than a
+ * legible "database does not exist" (finding 51639bf8). So `host`, `database`,
+ * `user` and `password` are coerced to strings; `port` is a real number and
+ * `undefined` is left untouched so pg's own defaults still apply.
+ *
+ * Exported (not inlined into `connect()`) so the coercion is unit-testable
+ * without a live database.
+ */
+declare function buildPostgresPoolConfig(config: PostgresPoolConfig): PgPoolConfig;
 /**
  * PostgreSQL database driver implementing the Cascade DriverContract.
  *
@@ -518,5 +535,5 @@ declare class PostgresDriver implements DriverContract {
   dropAllTables(): Promise<void>;
 }
 //#endregion
-export { PostgresDriver };
+export { PostgresDriver, buildPostgresPoolConfig };
 //# sourceMappingURL=postgres-driver.d.mts.map

package/esm/drivers/postgres/postgres-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-driver.d.mts","names":[],"sources":["../../../../../../../../cascade/src/drivers/postgres/postgres-driver.ts"],"mappings":"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"}
+{"version":3,"file":"postgres-driver.d.mts","names":[],"sources":["../../../../../../../../cascade/src/drivers/postgres/postgres-driver.ts"],"mappings":"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"}

package/esm/drivers/postgres/postgres-driver.mjs

@@ -24,6 +24,38 @@ import { log } from "@warlock.js/logger";
 * @module cascade/drivers/postgres
 */
 /**
+* Build pg's `PoolConfig` from cascade's `PostgresPoolConfig`, coercing the
+* string-typed connection fields.
+*
+* `env()` (@mongez/dotenv) coerces a numeric-looking value to a number, so a
+* `DB_NAME` / `DB_USERNAME` / `DB_PASSWORD` like "12345" arrives here as a
+* number. pg's connection fields must be strings — a number reaches deep into
+* the driver and crashes with an inscrutable Buffer error rather than a
+* legible "database does not exist" (finding 51639bf8). So `host`, `database`,
+* `user` and `password` are coerced to strings; `port` is a real number and
+* `undefined` is left untouched so pg's own defaults still apply.
+*
+* Exported (not inlined into `connect()`) so the coercion is unit-testable
+* without a live database.
+*/
+function buildPostgresPoolConfig(config) {
+	const asString = (value) => typeof value === "number" ? String(value) : value;
+	return {
+		host: asString(config.host) ?? "localhost",
+		port: config.port ?? 5432,
+		database: asString(config.database),
+		user: asString(config.user),
+		password: asString(config.password),
+		connectionString: config.connectionString,
+		max: config.max ?? 10,
+		min: config.min ?? 0,
+		idleTimeoutMillis: config.idleTimeoutMillis ?? 3e4,
+		connectionTimeoutMillis: config.connectionTimeoutMillis ?? 2e3,
+		application_name: config.application_name ?? "cascade",
+		ssl: config.ssl
+	};
+}
+/**
 * Cached pg module reference.
 */
 let pgModule;
@@ -187,21 +219,8 @@ var PostgresDriver = class {
 		if (this._isConnected) return;
 		const pg = await loadPg();
 		try {
-			const poolConfig = {
-				host: this.config.host ?? "localhost",
-				port: this.config.port ?? 5432,
-				database: this.config.database,
-				user: this.config.user,
-				password: this.config.password,
-				connectionString: this.config.connectionString,
-				max: this.config.max ?? 10,
-				min: this.config.min ?? 0,
-				idleTimeoutMillis: this.config.idleTimeoutMillis ?? 3e4,
-				connectionTimeoutMillis: this.config.connectionTimeoutMillis ?? 2e3,
-				application_name: this.config.application_name ?? "cascade",
-				ssl: this.config.ssl
-			};
-			log.info("database.postgres", "connection", `Connecting to database ${colors.bold(colors.yellowBright(this.config.database))}`);
+			const poolConfig = buildPostgresPoolConfig(this.config);
+			log.info("database.postgres", "connection", `Connecting to database ${colors.bold(colors.yellowBright(poolConfig.database ?? ""))}`);
 			this._pool = new pg.Pool(poolConfig);
 			(await this._pool.connect()).release();
 			log.success("database.postgres", "connection", `Connected to database ${colors.bold(colors.yellowBright(this.config.database))}`);
@@ -1018,5 +1037,5 @@ var PostgresDriver = class {
 };
 
 //#endregion
-export { PostgresDriver };
+export { PostgresDriver, buildPostgresPoolConfig };
 //# sourceMappingURL=postgres-driver.mjs.map

package/esm/drivers/postgres/postgres-driver.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-driver.mjs","names":[],"sources":["../../../../../../../../cascade/src/drivers/postgres/postgres-driver.ts"],"sourcesContent":["/**\n * PostgreSQL Driver\n *\n * Main driver implementation for PostgreSQL database operations.\n * Implements the DriverContract interface to provide a unified API\n * for CRUD operations, transactions, and query building.\n *\n * Uses the `pg` package for database connectivity with connection pooling.\n *\n * @module cascade/drivers/postgres\n */\n\nimport { colors } from \"@mongez/copper\";\nimport { log } from \"@warlock.js/logger\";\nimport { databaseTransactionContext } from \"../../context/database-transaction-context\";\nimport type {\n  CreateDatabaseOptions,\n  DriverContract,\n  DriverEventListener,\n  DriverTransactionContract,\n  DropDatabaseOptions,\n  InsertResult,\n  TransactionContext,\n  UpdateOperations,\n  UpdateResult,\n} from \"../../contracts/database-driver.contract\";\nimport type { DriverBlueprintContract } from \"../../contracts/driver-blueprint.contract\";\nimport type { MigrationDriverContract } from \"../../contracts/migration-driver.contract\";\nimport type { QueryBuilderContract } from \"../../contracts/query-builder.contract\";\nimport type { SyncAdapterContract } from \"../../contracts/sync-adapter.contract\";\nimport { TransactionRollbackError } from \"../../errors/transaction-rollback.error\";\nimport { SQLSerializer } from \"../../migration/sql-serializer\";\nimport { SqlDatabaseDirtyTracker } from \"../../sql-database-dirty-tracker\";\nimport type { ModelDefaults } from \"../../types\";\nimport { type DatabaseDriver } from \"../../utils/connect-to-database\";\nimport { isValidDateValue } from \"../../utils/is-valid-date-value\";\nimport { PostgresBlueprint } from \"./postgres-blueprint\";\nimport { PostgresDialect } from \"./postgres-dialect\";\nimport { PostgresMigrationDriver } from \"./postgres-migration-driver\";\nimport { PostgresQueryBuilder } from \"./postgres-query-builder\";\nimport { PostgresSQLSerializer } from \"./postgres-sql-serializer\";\nimport { PostgresSyncAdapter } from \"./postgres-sync-adapter\";\nimport type { PostgresPoolConfig, PostgresQueryResult, PostgresTransactionOptions } from \"./types\";\n\n/**\n * Lazily loaded pg module types.\n */\ntype PgPool = import(\"pg\").Pool;\ntype PgPoolClient = import(\"pg\").PoolClient;\ntype PgPoolConfig = import(\"pg\").PoolConfig;\n\n/**\n * Cached pg module reference.\n */\nlet pgModule: typeof import(\"pg\") | undefined;\n\n/**\n * Lazily load the pg package.\n *\n * @returns The pg module\n * @throws Error if pg is not installed\n */\nasync function loadPg(): Promise<typeof import(\"pg\")> {\n  if (pgModule) {\n    return pgModule;\n  }\n\n  try {\n    pgModule = await import(\"pg\");\n    return pgModule;\n  } catch {\n    throw new Error(\n      'The \"pg\" package is required for PostgreSQL support. ' + \"Please install it: npm install pg\",\n    );\n  }\n}\n\n/**\n * PostgreSQL database driver implementing the Cascade DriverContract.\n *\n * Provides connection pooling, CRUD operations, transactions, and\n * integration with Cascade's query builder and migration systems.\n *\n * @example\n * ```typescript\n * const driver = new PostgresDriver({\n *   host: 'localhost',\n *   port: 5432,\n *   database: 'myapp',\n *   user: 'postgres',\n *   password: 'secret'\n * });\n *\n * await driver.connect();\n *\n * // Insert a document\n * const result = await driver.insert('users', { name: 'Alice', email: 'alice@example.com' });\n *\n * // Query using the query builder\n * const users = await driver.queryBuilder('users')\n *   .where('name', 'Alice')\n *   .get();\n *\n * await driver.disconnect();\n * ```\n */\nexport class PostgresDriver implements DriverContract {\n  /**\n   * Driver name identifier.\n   */\n  public readonly name = \"postgres\" as DatabaseDriver;\n\n  /**\n   * SQL dialect for PostgreSQL-specific syntax.\n   */\n  public readonly dialect = new PostgresDialect();\n\n  /**\n   * PostgreSQL driver model defaults.\n   *\n   * PostgreSQL follows SQL conventions:\n   * - snake_case naming for columns (created_at, updated_at, deleted_at)\n   * - Native AUTO_INCREMENT for IDs (no manual generation)\n   * - Timestamps enabled by default\n   * - Permanent delete strategy (hard deletes)\n   */\n  public readonly modelDefaults: Partial<ModelDefaults> = {\n    namingConvention: \"snake_case\",\n    createdAtColumn: \"created_at\",\n    updatedAtColumn: \"updated_at\",\n    deletedAtColumn: \"deleted_at\",\n    timestamps: true,\n    autoGenerateId: false, // PostgreSQL uses SERIAL/BIGSERIAL\n    strictMode: \"fail\",\n    deleteStrategy: \"permanent\",\n  };\n\n  /**\n   * Connection pool instance.\n   */\n  private _pool: PgPool | undefined;\n\n  /**\n   * Event listeners for driver lifecycle events.\n   */\n  private readonly _eventListeners = new Map<string, Set<DriverEventListener>>();\n\n  /**\n   * Whether the driver is currently connected.\n   */\n  private _isConnected = false;\n\n  /**\n   * Blueprint instance (lazy-loaded).\n   */\n  private _blueprint: DriverBlueprintContract | undefined;\n\n  /**\n   * Migration driver instance (lazy-loaded).\n   */\n  private _migrationDriver: MigrationDriverContract | undefined;\n\n  /**\n   * Sync adapter instance (lazy-loaded).\n   */\n  private _syncAdapter: SyncAdapterContract | undefined;\n\n  /**\n   * Explicit, table-agnostic override list of column names that hold native\n   * PostgreSQL arrays (`JSONB[]`, `TEXT[]`, …) and must NOT be JSON-text\n   * encoded. Merged with (and superseded per-table by) the schema\n   * introspection below; kept as a manual escape hatch.\n   *\n   * @see PostgresPoolConfig.nativeArrayColumns\n   */\n  private readonly _nativeArrayColumns: ReadonlySet<string>;\n\n  /**\n   * Native-array columns discovered by introspecting the live schema on\n   * connect, keyed `table → { column, … }`. Authoritative and table-scoped, so\n   * a column that is `TEXT[]` in one table and `jsonb` in another is encoded\n   * correctly for each — no app configuration required.\n   */\n  private _introspectedArrayColumns: ReadonlyMap<string, ReadonlySet<string>> = new Map();\n\n  /**\n   * Create a new PostgreSQL driver instance.\n   *\n   * @param config - PostgreSQL connection configuration\n   */\n  public constructor(private readonly config: PostgresPoolConfig) {\n    this._nativeArrayColumns = new Set(config.nativeArrayColumns ?? []);\n  }\n\n  /**\n   * Get the connection pool instance.\n   *\n   * @throws Error if not connected\n   */\n  public get pool(): PgPool {\n    if (!this._pool) {\n      throw new Error(\"PostgreSQL driver is not connected. Call connect() first.\");\n    }\n    return this._pool;\n  }\n\n  /**\n   * Get database native client\n   */\n  public getClient<Client = PgPool>(): Client {\n    return this.pool as Client;\n  }\n\n  /**\n   * Check if the driver is currently connected.\n   */\n  public get isConnected(): boolean {\n    return this._isConnected;\n  }\n\n  /**\n   * Get the driver blueprint (information schema).\n   */\n  public get blueprint(): DriverBlueprintContract {\n    if (!this._blueprint) {\n      this._blueprint = new PostgresBlueprint(this);\n    }\n    return this._blueprint;\n  }\n\n  /**\n   * Establish connection to the PostgreSQL database.\n   *\n   * Creates a connection pool with the configured options.\n   * Emits 'connected' event on successful connection.\n   */\n  public async connect(): Promise<void> {\n    if (this._isConnected) {\n      return;\n    }\n\n    const pg = await loadPg();\n\n    try {\n      const poolConfig: PgPoolConfig = {\n        host: this.config.host ?? \"localhost\",\n        port: this.config.port ?? 5432,\n        database: this.config.database,\n        user: this.config.user,\n        password: this.config.password,\n        connectionString: this.config.connectionString,\n        max: this.config.max ?? 10,\n        min: this.config.min ?? 0,\n        idleTimeoutMillis: this.config.idleTimeoutMillis ?? 30000,\n        connectionTimeoutMillis: this.config.connectionTimeoutMillis ?? 2000,\n        application_name: this.config.application_name ?? \"cascade\",\n        ssl: this.config.ssl,\n      };\n\n      log.info(\n        \"database.postgres\",\n        \"connection\",\n        `Connecting to database ${colors.bold(colors.yellowBright(this.config.database))}`,\n      );\n\n      this._pool = new pg.Pool(poolConfig);\n\n      // Test the connection\n      const client = await this._pool.connect();\n      client.release();\n\n      log.success(\n        \"database.postgres\",\n        \"connection\",\n        `Connected to database ${colors.bold(colors.yellowBright(this.config.database))}`,\n      );\n\n      this._isConnected = true;\n\n      // Learn which columns are native arrays straight from the live schema so\n      // the value serializer encodes them correctly with zero app config.\n      await this.loadNativeArrayColumns();\n\n      this.emit(\"connected\");\n    } catch (error) {\n      // Boot-time database connection failure is unrecoverable in every\n      // realistic caller (app boot, CLI migrations, workers) — `fatal` makes\n      // \"page on fatal only\" alerting clean. Per-query failures stay at error.\n      log.fatal(\"database.postgres\", \"connection\", \"Failed to connect to database\");\n      throw error;\n    }\n  }\n\n  /**\n   * Close the database connection pool.\n   *\n   * Waits for all active queries to complete before closing.\n   * Emits 'disconnected' event on successful disconnection.\n   */\n  public async disconnect(): Promise<void> {\n    if (!this._isConnected || !this._pool) {\n      return;\n    }\n\n    await this._pool.end();\n    this._pool = undefined;\n    this._isConnected = false;\n    this.emit(\"disconnected\");\n  }\n\n  /**\n   * Register an event listener for driver lifecycle events.\n   *\n   * @param event - Event name ('connected', 'disconnected', etc.)\n   * @param listener - Callback function to invoke\n   */\n  public on(event: string, listener: DriverEventListener): void {\n    if (!this._eventListeners.has(event)) {\n      this._eventListeners.set(event, new Set());\n    }\n\n    this._eventListeners.get(event)!.add(listener);\n  }\n\n  /**\n   * Serialize data for storage in PostgreSQL.\n   *\n   * Handles Date objects, BigInt, and other JavaScript types\n   * that need special handling for PostgreSQL storage.\n   *\n   * @param data - The data object to serialize\n   * @param table - Optional table name; when given, columns introspected as\n   *   native arrays on that table are bound raw (see {@link serializeValue}).\n   * @returns Serialized data ready for PostgreSQL\n   */\n  public serialize(\n    data: Record<string, unknown>,\n    table?: string,\n  ): Record<string, unknown> {\n    const serialized: Record<string, unknown> = {};\n\n    for (const [key, value] of Object.entries(data)) {\n      if (value === undefined) {\n        continue; // Skip undefined values\n      }\n\n      serialized[key] = this.serializeValue(key, value, table);\n    }\n\n    return serialized;\n  }\n\n  /**\n   * Serialize a single column value into a node-pg bindable parameter.\n   *\n   * Shared by {@link serialize} (INSERT path) and {@link buildUpdateQuery}\n   * `$set` (UPDATE path) so both encode `json` / `jsonb` columns identically.\n   *\n   * Encoding rules (in order):\n   * - `Date` → ISO string.\n   * - `bigint` → decimal string (node-pg has no native bigint binding).\n   * - all-number array → pgvector literal `'[n1,n2,...]'`. node-pg would\n   *   otherwise emit a `{n1,n2,...}` array literal, which the `vector` type\n   *   rejects. This branch is preserved exactly.\n   * - any other array (object-array, string-array, mixed, empty `[]`) →\n   *   `JSON.stringify`. node-pg renders a raw JS array as a PostgreSQL array\n   *   literal `{...}` (and `[]` as `{}`), which a `json` / `jsonb` column\n   *   rejects — so we bind the value as JSON text instead, the form those\n   *   columns accept. Columns known to be native arrays — via schema\n   *   introspection or the `nativeArrayColumns` config — are exempt: their raw\n   *   array is passed through so node-pg emits the `{...}` literal a genuine\n   *   `JSONB[]` / `TEXT[]` column needs.\n   * - plain object → `JSON.stringify`. Equivalent to node-pg's own object\n   *   handling, made explicit so both write paths agree.\n   * - everything else (scalars: string, number, boolean, null) → untouched.\n   *\n   * Distinguishing native-array from `json` / `jsonb` columns: a value alone\n   * can't tell them apart, so the driver introspects the live schema on connect\n   * (see {@link loadNativeArrayColumns}) and consults that per-table map here\n   * via {@link isNativeArrayColumn}. The explicit `nativeArrayColumns` config\n   * still works as a table-agnostic override. No `::jsonb` placeholder cast is\n   * added: a JSON-text string binds correctly to `json` / `jsonb` without one,\n   * and a blind cast would misfire on columns we cannot positively identify as\n   * jsonb.\n   *\n   * @param key - Column name (used to resolve native-array columns)\n   * @param value - The raw value to serialize (never `undefined`)\n   * @param table - Optional table name; enables the per-table native-array lookup\n   * @returns The value ready to bind as a query parameter\n   */\n  private serializeValue(key: string, value: unknown, table?: string): unknown {\n    if (value instanceof Date) {\n      return value.toISOString();\n    }\n\n    if (typeof value === \"bigint\") {\n      return value.toString();\n    }\n\n    if (Array.isArray(value)) {\n      if (value.length > 0 && value.every((v) => typeof v === \"number\")) {\n        // pgvector columns expect the literal '[n1,n2,...]' format.\n        return `[${value.join(\",\")}]`;\n      }\n\n      // Genuine native PostgreSQL array columns (JSONB[], TEXT[], …) must\n      // keep their raw array so node-pg emits a '{...}' array literal.\n      if (this.isNativeArrayColumn(table, key)) {\n        return value;\n      }\n\n      // json / jsonb columns: bind as JSON text. Covers object-arrays,\n      // string-arrays, mixed arrays, and empty [] (which would otherwise\n      // store as '{}' instead of '[]').\n      return JSON.stringify(value);\n    }\n\n    if (typeof value === \"object\" && value !== null) {\n      // Plain object → JSONB. Explicit JSON.stringify matches node-pg's own\n      // object encoding while keeping both write paths consistent.\n      return JSON.stringify(value);\n    }\n\n    return value;\n  }\n\n  /**\n   * Whether `column` on `table` is a native PostgreSQL array. True when the\n   * connect-time schema introspection saw it as `data_type = 'ARRAY'` for that\n   * table (authoritative, per-table), or when it's listed in the table-agnostic\n   * `nativeArrayColumns` config override.\n   */\n  private isNativeArrayColumn(table: string | undefined, column: string): boolean {\n    if (table && this._introspectedArrayColumns.get(table)?.has(column)) {\n      return true;\n    }\n\n    return this._nativeArrayColumns.has(column);\n  }\n\n  /**\n   * Introspect the live schema for native-array columns so array values bind\n   * correctly with zero app configuration.\n   *\n   * A JS array must be bound two opposite ways depending on the column: as JSON\n   * text for a `json` / `jsonb` column, but as a raw array (which node-pg\n   * renders `{...}`) for a native `TEXT[]` / `JSONB[]` / `INTEGER[]` column. The\n   * serializer sees values, not types, so without this it JSON-stringifies\n   * every array — which a native-array column rejects with \"malformed array\n   * literal\". One `information_schema` query at connect, cached for the\n   * connection lifetime, removes the need to hand-list `nativeArrayColumns`.\n   *\n   * Best-effort: any failure (e.g. restricted catalog access) is logged and\n   * leaves the map empty so the config override still applies — it never blocks\n   * connect. A schema change made within a live connection isn't reflected\n   * until the next connect.\n   */\n  private async loadNativeArrayColumns(): Promise<void> {\n    try {\n      const result = await this.query<{ table_name: string; column_name: string }>(\n        `SELECT table_name, column_name\n         FROM information_schema.columns\n         WHERE table_schema = ANY (current_schemas(false))\n           AND data_type = 'ARRAY'`,\n      );\n\n      const map = new Map<string, Set<string>>();\n\n      for (const { table_name, column_name } of result.rows) {\n        let columns = map.get(table_name);\n\n        if (!columns) {\n          columns = new Set<string>();\n          map.set(table_name, columns);\n        }\n\n        columns.add(column_name);\n      }\n\n      this._introspectedArrayColumns = map;\n    } catch {\n      // Introspection is an optimization, never a hard dependency — fall back\n      // to the `nativeArrayColumns` config so a locked-down catalog or an\n      // unusual search_path can't break connect.\n      log.warn(\n        \"database.postgres\",\n        \"introspection\",\n        \"Could not introspect native-array columns; using the nativeArrayColumns config only\",\n      );\n    }\n  }\n\n  /**\n   * Get the dirty tracker for this driver.\n   */\n  public getDirtyTracker(data: Record<string, unknown>): SqlDatabaseDirtyTracker {\n    return new SqlDatabaseDirtyTracker(data);\n  }\n\n  /**\n   * Deserialize data retrieved from PostgreSQL.\n   *\n   * Converts PostgreSQL types back to JavaScript equivalents.\n   *\n   * @param data - The data object from PostgreSQL\n   * @returns Deserialized JavaScript object\n   */\n  public deserialize(data: Record<string, unknown>): Record<string, unknown> {\n    // PostgreSQL pg driver handles most type conversions automatically\n    // Special handling can be added here if needed\n    for (const [key, value] of Object.entries(data)) {\n      // Only re-inflate strings — pg already returns Date objects from DB reads\n      if (typeof value !== \"string\") continue;\n\n      if (isValidDateValue(value)) {\n        data[key] = new Date(value);\n        continue;\n      }\n\n      // pgvector columns are returned as '[n1,n2,...]' strings.\n      // charCodeAt is faster than startsWith/endsWith — no string allocation.\n      // '[' = 91, ']' = 93\n      if (value.charCodeAt(0) === 91 && value.charCodeAt(value.length - 1) === 93) {\n        const parts = value.slice(1, -1).split(\",\");\n        const nums = new Array<number>(parts.length);\n        let isNumericVector = parts.length > 0;\n\n        for (let i = 0; i < parts.length; i++) {\n          // `parts[i]` is `string | undefined` under noUncheckedIndexedAccess even\n          // though `i < parts.length`. `+undefined` is NaN, which the finite check\n          // below already rejects — so `?? \"\"` keeps the coercion total without\n          // changing which inputs count as a numeric vector (+\"\" is 0, but an\n          // empty segment cannot occur for i < length).\n          const n = +(parts[i] ?? \"\"); // unary + is the fastest string-to-number coercion\n          if (!Number.isFinite(n)) {\n            isNumericVector = false;\n            break; // early-exit — not a numeric vector, leave value untouched\n          }\n          nums[i] = n;\n        }\n\n        if (isNumericVector) {\n          data[key] = nums;\n        }\n      }\n    }\n\n    return data;\n  }\n\n  /**\n   * Insert a single row into a table.\n   *\n   * Uses INSERT ... RETURNING to get the inserted row with generated values.\n   *\n   * @param table - Target table name\n   * @param document - Data to insert\n   * @param options - Optional insertion options\n   * @returns The inserted document\n   */\n  public async insert(\n    table: string,\n    document: Record<string, unknown>,\n    _options?: Record<string, unknown>,\n  ): Promise<InsertResult> {\n    const serialized = this.serialize(document, table);\n\n    // Filter out id if null/undefined to let PostgreSQL SERIAL auto-generate\n    const filteredData = Object.fromEntries(\n      Object.entries(serialized).filter(([key, value]) => {\n        // Exclude id if null/undefined (let SERIAL handle it)\n        if (key === \"id\" && (value === null || value === undefined)) {\n          return false;\n        }\n        return true;\n      }),\n    );\n\n    const columns = Object.keys(filteredData);\n    const values = Object.values(filteredData);\n\n    if (columns.length === 0) {\n      throw new Error(\"Cannot insert empty document\");\n    }\n\n    const quotedColumns = columns.map((c) => this.dialect.quoteIdentifier(c)).join(\", \");\n    const placeholders = columns.map((_, i) => this.dialect.placeholder(i + 1)).join(\", \");\n    const quotedTable = this.dialect.quoteIdentifier(table);\n\n    const sql = `INSERT INTO ${quotedTable} (${quotedColumns}) VALUES (${placeholders}) RETURNING *`;\n\n    const result = await this.query<Record<string, unknown>>(sql, values);\n\n    return {\n      document: result.rows[0],\n    };\n  }\n\n  /**\n   * Insert multiple rows into a table.\n   *\n   * Uses a single INSERT statement with multiple value sets for efficiency.\n   *\n   * @param table - Target table name\n   * @param documents - Array of documents to insert\n   * @param options - Optional insertion options\n   * @returns Array of inserted documents\n   */\n  public async insertMany(\n    table: string,\n    documents: Record<string, unknown>[],\n    _options?: Record<string, unknown>,\n  ): Promise<InsertResult[]> {\n    if (documents.length === 0) {\n      return [];\n    }\n\n    // Get all unique columns across all documents\n    const allColumns = new Set<string>();\n    for (const doc of documents) {\n      const serialized = this.serialize(doc, table);\n      Object.keys(serialized).forEach((key) => allColumns.add(key));\n    }\n    const columns = Array.from(allColumns);\n\n    const quotedColumns = columns.map((c) => this.dialect.quoteIdentifier(c)).join(\", \");\n    const quotedTable = this.dialect.quoteIdentifier(table);\n\n    // Build value sets and params\n    const valueSets: string[] = [];\n    const params: unknown[] = [];\n    let paramIndex = 1;\n\n    for (const doc of documents) {\n      const serialized = this.serialize(doc, table);\n      const rowPlaceholders: string[] = [];\n\n      for (const col of columns) {\n        if (col in serialized) {\n          rowPlaceholders.push(this.dialect.placeholder(paramIndex++));\n          params.push(serialized[col]);\n        } else {\n          rowPlaceholders.push(\"DEFAULT\");\n        }\n      }\n\n      valueSets.push(`(${rowPlaceholders.join(\", \")})`);\n    }\n\n    const sql = `INSERT INTO ${quotedTable} (${quotedColumns}) VALUES ${valueSets.join(\", \")} RETURNING *`;\n\n    const result = await this.query<Record<string, unknown>>(sql, params);\n\n    return result.rows as unknown as InsertResult[];\n  }\n\n  /**\n   * Update a single row matching the filter.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param update - Update operations ($set, $unset, $inc)\n   * @param options - Optional update options\n   * @returns Update result with modified count\n   */\n  public async update(\n    table: string,\n    filter: Record<string, unknown>,\n    update: UpdateOperations,\n    _options?: Record<string, unknown>,\n  ): Promise<UpdateResult> {\n    const { sql, params } = this.buildUpdateQuery(table, filter, update, 1);\n    try {\n      const result = await this.query(sql, params);\n\n      return {\n        modifiedCount: result.rowCount ?? 0,\n      };\n    } catch (error) {\n      console.log(\"PG Query Error in:\", sql, params);\n\n      throw error;\n    }\n  }\n\n  /**\n   * Find one and update a single row matching the filter and return the updated row\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param update - Update operations ($set, $unset, $inc)\n   * @param options - Optional update options\n   * @returns The updated row or null\n   */\n  public async findOneAndUpdate<T = unknown>(\n    table: string,\n    filter: Record<string, unknown>,\n    update: UpdateOperations,\n    _options?: Record<string, unknown>,\n  ): Promise<T | null> {\n    const { sql, params } = this.buildUpdateQuery(table, filter, update, 1);\n    // Add RETURNING * to get the updated row back\n    const sqlWithReturning = `${sql} RETURNING *`;\n    const result = await this.query<T>(sqlWithReturning, params);\n    return result.rows[0] ?? null;\n  }\n\n  /**\n   * Update multiple rows matching the filter.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param update - Update operations\n   * @param options - Optional update options\n   * @returns Update result with modified count\n   */\n  public async updateMany(\n    table: string,\n    filter: Record<string, unknown>,\n    update: UpdateOperations,\n    _options?: Record<string, unknown>,\n  ): Promise<UpdateResult> {\n    const { sql, params } = this.buildUpdateQuery(table, filter, update);\n\n    const result = await this.query(sql, params);\n\n    return {\n      modifiedCount: result.rowCount ?? 0,\n    };\n  }\n\n  /**\n   * Replace a document matching the filter.\n   *\n   * Completely replaces the document (not a partial update).\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param document - New document data\n   * @param options - Optional options\n   * @returns The replaced document or null\n   */\n  public async replace<T = unknown>(\n    table: string,\n    filter: Record<string, unknown>,\n    document: Record<string, unknown>,\n    _options?: Record<string, unknown>,\n  ): Promise<T | null> {\n    const serialized = this.serialize(document, table);\n    const columns = Object.keys(serialized);\n    const values = Object.values(serialized);\n\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const setClauses = columns\n      .map((col, i) => `${this.dialect.quoteIdentifier(col)} = ${this.dialect.placeholder(i + 1)}`)\n      .join(\", \");\n\n    const { whereClause, whereParams } = this.buildWhereClause(filter, columns.length + 1);\n\n    const sql = `UPDATE ${quotedTable} SET ${setClauses} ${whereClause} RETURNING *`;\n    const params = [...values, ...whereParams];\n\n    const result = await this.query<T>(sql, params);\n\n    return result.rows[0] ?? null;\n  }\n\n  /**\n   * Upsert (insert or update) a single row.\n   *\n   * Uses PostgreSQL's INSERT ... ON CONFLICT ... DO UPDATE syntax.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions to find existing row (used for conflict detection)\n   * @param document - Document data to insert or update\n   * @param options - Upsert options (conflictColumns for conflict target)\n   * @returns The upserted row\n   */\n  public async upsert<T = unknown>(\n    table: string,\n    filter: Record<string, unknown>,\n    document: Record<string, unknown>,\n    options?: Record<string, unknown>,\n  ): Promise<T> {\n    const serialized = this.serialize(document, table);\n    const columns = Object.keys(serialized);\n    const values = Object.values(serialized);\n\n    if (columns.length === 0) {\n      throw new Error(\"Cannot upsert empty document\");\n    }\n\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const quotedColumns = columns.map((c) => this.dialect.quoteIdentifier(c)).join(\", \");\n    const placeholders = columns.map((_, i) => this.dialect.placeholder(i + 1)).join(\", \");\n\n    // Determine conflict columns from options or filter\n    const conflictColumns = (options?.conflictColumns as string[]) ?? Object.keys(filter);\n    if (conflictColumns.length === 0) {\n      throw new Error(\"Upsert requires conflictColumns option or filter with columns\");\n    }\n\n    const quotedConflictColumns = conflictColumns\n      .map((c) => this.dialect.quoteIdentifier(c))\n      .join(\", \");\n\n    // Build UPDATE clause for ON CONFLICT\n    // Update all columns except the conflict columns (they stay the same)\n    const updateColumns = columns.filter((col) => !conflictColumns.includes(col));\n    const setClauses = updateColumns\n      .map((col, i) => {\n        const valueIndex = columns.indexOf(col) + 1;\n        return `${this.dialect.quoteIdentifier(col)} = ${this.dialect.placeholder(valueIndex)}`;\n      })\n      .join(\", \");\n\n    // If there are no columns to update (all columns are conflict columns), use EXCLUDED\n    const updateClause =\n      setClauses.length > 0\n        ? setClauses\n        : columns\n            .map(\n              (col) =>\n                `${this.dialect.quoteIdentifier(col)} = EXCLUDED.${this.dialect.quoteIdentifier(col)}`,\n            )\n            .join(\", \");\n\n    const sql = `INSERT INTO ${quotedTable} (${quotedColumns}) VALUES (${placeholders}) ON CONFLICT (${quotedConflictColumns}) DO UPDATE SET ${updateClause} RETURNING *`;\n\n    const result = await this.query<T>(sql, values);\n\n    return result.rows[0]! as T;\n  }\n\n  /**\n   * Find one and delete a single row matching the filter and return the deleted row.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param options - Optional delete options\n   * @returns The deleted row or null\n   */\n  public async findOneAndDelete<T = unknown>(\n    table: string,\n    filter: Record<string, unknown>,\n    _options?: Record<string, unknown>,\n  ): Promise<T | null> {\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const { whereClause, whereParams } = this.buildWhereClause(filter, 1);\n\n    // Use ctid for single row deletion with RETURNING\n    const sql = `DELETE FROM ${quotedTable} WHERE ctid IN (SELECT ctid FROM ${quotedTable} ${whereClause} LIMIT 1) RETURNING *`;\n\n    const result = await this.query<T>(sql, whereParams);\n\n    return result.rows[0] ? (result.rows[0] as T) : null;\n  }\n\n  /**\n   * Delete a single row matching the filter.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param options - Optional options\n   * @returns Number of deleted rows (0 or 1)\n   */\n  public async delete(\n    table: string,\n    filter?: Record<string, unknown>,\n    _options?: Record<string, unknown>,\n  ): Promise<number> {\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const { whereClause, whereParams } = this.buildWhereClause(filter ?? {}, 1);\n\n    // Use ctid for single row deletion\n    const sql = `DELETE FROM ${quotedTable} WHERE ctid IN (SELECT ctid FROM ${quotedTable} ${whereClause} LIMIT 1)`;\n\n    const result = await this.query(sql, whereParams);\n\n    return result.rowCount ?? 0;\n  }\n\n  /**\n   * Delete multiple rows matching the filter.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param options - Optional options\n   * @returns Number of deleted rows\n   */\n  public async deleteMany(\n    table: string,\n    filter?: Record<string, unknown>,\n    _options?: Record<string, unknown>,\n  ): Promise<number> {\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const { whereClause, whereParams } = this.buildWhereClause(filter ?? {}, 1);\n\n    const sql = `DELETE FROM ${quotedTable} ${whereClause}`;\n\n    const result = await this.query(sql, whereParams);\n\n    return result.rowCount ?? 0;\n  }\n\n  /**\n   * Truncate a table (remove all rows).\n   *\n   * Uses TRUNCATE TABLE for fast deletion with RESTART IDENTITY.\n   *\n   * @param table - Target table name\n   * @param options - Optional options\n   * @param options.cascade - If true, automatically truncate all tables with foreign key references (use with caution)\n   * @returns Number of deleted rows (always 0 for TRUNCATE)\n   */\n  public async truncateTable(table: string, options?: { cascade?: boolean }): Promise<number> {\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const cascadeClause = options?.cascade ? \" CASCADE\" : \"\";\n    await this.query(`TRUNCATE TABLE ${quotedTable} RESTART IDENTITY${cascadeClause}`);\n    return 0; // TRUNCATE doesn't return row count\n  }\n\n  /**\n   * Get a query builder for the specified table.\n   *\n   * @param table - Target table name\n   * @returns Query builder instance\n   */\n  public queryBuilder<T = unknown>(table: string): QueryBuilderContract<T> {\n    return new PostgresQueryBuilder<T>(table) as unknown as QueryBuilderContract<T>;\n  }\n\n  /**\n   * Begin a new database transaction.\n   *\n   * Acquires a client from the pool and starts a transaction.\n   * The client is stored in AsyncLocalStorage for automatic\n   * participation by subsequent queries.\n   *\n   * @param options - Optional transaction options\n   * @returns Transaction contract with commit/rollback methods\n   */\n  public async beginTransaction(\n    options?: PostgresTransactionOptions,\n  ): Promise<DriverTransactionContract<PgPoolClient>> {\n    const client = await this.pool.connect();\n\n    let beginSql = \"BEGIN\";\n    if (options?.isolationLevel) {\n      beginSql += ` ISOLATION LEVEL ${options.isolationLevel.toUpperCase()}`;\n    }\n    if (options?.readOnly) {\n      beginSql += \" READ ONLY\";\n    }\n    if (options?.deferrable) {\n      beginSql += \" DEFERRABLE\";\n    }\n\n    await client.query(beginSql);\n\n    return {\n      context: client,\n      commit: async () => {\n        await client.query(\"COMMIT\");\n        client.release();\n      },\n      rollback: async () => {\n        await client.query(\"ROLLBACK\");\n        client.release();\n      },\n    };\n  }\n\n  /**\n   * Execute a function within a transaction scope (recommended pattern).\n   *\n   * Automatically commits on success, rolls back on any error, and guarantees\n   * resource cleanup. This is the recommended way to use transactions.\n   *\n   * @param fn - Async function to execute within transaction\n   * @param options - Transaction options (isolation level, read-only, etc.)\n   * @returns The return value of the callback function\n   * @throws {Error} If transaction fails or is explicitly rolled back\n   */\n  public async transaction<T>(\n    fn: (ctx: TransactionContext) => Promise<T>,\n    options?: Record<string, unknown>,\n  ): Promise<T> {\n    const ctx: TransactionContext = {\n      rollback(reason?: string): never {\n        throw new TransactionRollbackError(reason);\n      },\n    };\n\n    // Flat nesting: a transaction() called while one is already active JOINS it\n    // instead of opening a second, independent transaction on another pool\n    // connection. An independent inner transaction can't see the outer's\n    // uncommitted writes (a row inserted moments earlier), so a service that\n    // opens its own transaction — correct when called standalone — would hit\n    // phantom FK violations when called inside an outer transaction (e.g. a\n    // seeder that creates a row, then calls a service that references it). The\n    // outermost transaction owns BEGIN / COMMIT / ROLLBACK; the inner block\n    // runs on the same session, and a throw still unwinds the whole outer\n    // transaction. (Savepoint-based partial rollback is a separate, explicit\n    // concern — use `beginTransaction()` directly for that.)\n    if (databaseTransactionContext.hasActiveTransaction()) {\n      return fn(ctx);\n    }\n\n    const tx = await this.beginTransaction(options);\n\n    // Set transaction context for queries within callback\n    databaseTransactionContext.enter({ session: tx.context });\n\n    try {\n      // Execute callback\n      const result = await fn(ctx);\n\n      // Auto-commit on success\n      await tx.commit();\n\n      return result;\n    } catch (error) {\n      // Auto-rollback on any error (including explicit rollback)\n      await tx.rollback();\n      log.error(\n        `database.postgress`,\n        \"transaction\",\n        \"Transaction operation failed, rolled back everything\",\n      );\n      throw error;\n    } finally {\n      // Guaranteed cleanup\n      databaseTransactionContext.exit();\n    }\n  }\n\n  /**\n   * Perform an atomic update operation.\n   *\n   * Builds and executes an UPDATE query for the given filter and operations.\n   * Updates EVERY matching row — the MongoDB driver's atomic() delegates to\n   * updateMany, and Model.findAndUpdate documents multi-row semantics, so the\n   * two drivers must agree.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param operations - Update operations\n   * @param options - Optional options\n   * @returns Update result\n   */\n  public async atomic(\n    table: string,\n    filter: Record<string, unknown>,\n    operations: UpdateOperations,\n    _options?: Record<string, unknown>,\n  ): Promise<UpdateResult> {\n    const { sql, params } = this.buildUpdateQuery(table, filter, operations);\n\n    const result = await this.query(sql, params);\n\n    return {\n      modifiedCount: result.rowCount ?? 0,\n    };\n  }\n\n  /**\n   * Get the sync adapter for bulk denormalized updates.\n   *\n   * @returns Sync adapter instance\n   */\n  public syncAdapter(): SyncAdapterContract {\n    if (!this._syncAdapter) {\n      this._syncAdapter = new PostgresSyncAdapter(this);\n    }\n    return this._syncAdapter;\n  }\n\n  /**\n   * Get the migration driver for schema operations.\n   *\n   * @returns Migration driver instance\n   */\n  public migrationDriver(): MigrationDriverContract {\n    if (!this._migrationDriver) {\n      this._migrationDriver = new PostgresMigrationDriver(this);\n    }\n\n    return this._migrationDriver;\n  }\n\n  /**\n   * Return a SQL serializer for this driver's dialect.\n   * Used by Migration.toSQL() to convert pending operations to SQL strings.\n   */\n  public getSQLSerializer(): SQLSerializer {\n    return new PostgresSQLSerializer(this.dialect);\n  }\n\n  /**\n   * Execute a raw SQL query.\n   *\n   * Automatically uses the transaction client if one is active.\n   *\n   * @param sql - SQL query string\n   * @param params - Query parameters\n   * @returns Query result\n   */\n  public async query<T = Record<string, unknown>>(\n    sql: string,\n    params: unknown[] = [],\n  ): Promise<PostgresQueryResult<T>> {\n    // Check for active transaction client\n    const txClient = databaseTransactionContext.getSession() as PgPoolClient | undefined;\n\n    const startTime = this.config.logging ? performance.now() : 0;\n\n    let paramsString = \"\";\n    if (this.config.logging && params.length > 0) {\n      paramsString = JSON.stringify(params);\n      if (paramsString.length > 300) {\n        paramsString = paramsString.substring(0, 300) + \"...\";\n      }\n      paramsString = ` | Params: ${paramsString}`;\n    }\n\n    try {\n      let result;\n      if (this.config.logging) {\n        log.info({\n          module: \"database.postgres\",\n          action: \"query.executing\",\n          message: `${sql}${paramsString}`,\n          context: { params, sql },\n        });\n      }\n      if (txClient) {\n        result = await txClient.query(sql, params);\n      } else {\n        result = await this.pool.query(sql, params);\n      }\n\n      if (this.config.logging) {\n        const duration = (performance.now() - startTime).toFixed(2);\n        log.success({\n          module: \"database.postgres\",\n          action: \"query.executed\",\n          message: `[${duration}ms] ${sql}${paramsString}`,\n          context: { params, sql, duration },\n        });\n      }\n\n      return result as PostgresQueryResult<T>;\n    } catch (error) {\n      if (this.config.logging) {\n        const duration = (performance.now() - startTime).toFixed(2);\n        log.error({\n          module: \"database.postgres\",\n          action: \"query.error\",\n          message: `[${duration}ms] ${sql}${paramsString}`,\n          context: {\n            sql,\n            params,\n            error: error instanceof Error ? error.message : String(error),\n          },\n        });\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Emit an event to all registered listeners.\n   *\n   * @param event - Event name\n   * @param args - Event arguments\n   */\n  private emit(event: string, ...args: unknown[]): void {\n    const listeners = this._eventListeners.get(event);\n    if (listeners) {\n      for (const listener of listeners) {\n        listener(...args);\n      }\n    }\n  }\n\n  /**\n   * Build a simple WHERE clause from a filter object.\n   *\n   * Values are bound as plain equality, except Mongo-style operator objects\n   * (`{ $in: [...] }`, `{ $gt: 5 }`, ...) which are translated to their SQL\n   * equivalents — driver-level callers (e.g. pivot detach) build filters in\n   * that portable form. An unrecognized `$` operator throws instead of being\n   * bound literally, which would only surface as a cryptic type error from\n   * Postgres.\n   *\n   * @param filter - Filter conditions\n   * @param startParamIndex - Starting parameter index\n   * @returns Object with WHERE clause string and parameters\n   */\n  private buildWhereClause(\n    filter: Record<string, unknown>,\n    startParamIndex: number,\n  ): { whereClause: string; whereParams: unknown[] } {\n    const conditions: string[] = [];\n    const params: unknown[] = [];\n    let paramIndex = startParamIndex;\n\n    for (const [key, value] of Object.entries(filter)) {\n      const quotedKey = this.dialect.quoteIdentifier(key);\n\n      if (value === null) {\n        conditions.push(`${quotedKey} IS NULL`);\n      } else if (this.isOperatorFilter(value)) {\n        for (const [operator, operand] of Object.entries(value as Record<string, unknown>)) {\n          switch (operator) {\n            case \"$in\":\n            case \"$nin\": {\n              const list = operand as unknown[];\n              if (list.length === 0) {\n                // $in [] matches nothing; $nin [] matches everything.\n                conditions.push(operator === \"$in\" ? \"FALSE\" : \"TRUE\");\n                break;\n              }\n              const placeholders = list.map(() => this.dialect.placeholder(paramIndex++));\n              params.push(...list);\n              conditions.push(\n                `${quotedKey} ${operator === \"$in\" ? \"IN\" : \"NOT IN\"} (${placeholders.join(\", \")})`,\n              );\n              break;\n            }\n            case \"$eq\":\n              if (operand === null) {\n                conditions.push(`${quotedKey} IS NULL`);\n              } else {\n                conditions.push(`${quotedKey} = ${this.dialect.placeholder(paramIndex++)}`);\n                params.push(operand);\n              }\n              break;\n            case \"$ne\":\n              if (operand === null) {\n                conditions.push(`${quotedKey} IS NOT NULL`);\n              } else {\n                conditions.push(`${quotedKey} != ${this.dialect.placeholder(paramIndex++)}`);\n                params.push(operand);\n              }\n              break;\n            case \"$gt\":\n            case \"$gte\":\n            case \"$lt\":\n            case \"$lte\": {\n              const sqlOperator = { $gt: \">\", $gte: \">=\", $lt: \"<\", $lte: \"<=\" }[operator];\n              conditions.push(`${quotedKey} ${sqlOperator} ${this.dialect.placeholder(paramIndex++)}`);\n              params.push(operand);\n              break;\n            }\n            default:\n              throw new Error(\n                `Unsupported filter operator \"${operator}\" for column \"${key}\" on the Postgres driver.`,\n              );\n          }\n        }\n      } else {\n        conditions.push(`${quotedKey} = ${this.dialect.placeholder(paramIndex++)}`);\n        params.push(value);\n      }\n    }\n\n    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(\" AND \")}` : \"\";\n\n    return { whereClause, whereParams: params };\n  }\n\n  /**\n   * A filter value is an operator object when it is a plain object whose keys\n   * ALL start with `$`. Arrays, Dates, and value objects (e.g. jsonb equality\n   * payloads) keep their existing bind-as-value behavior.\n   */\n  private isOperatorFilter(value: unknown): boolean {\n    if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n      return false;\n    }\n\n    if (value instanceof Date || Buffer.isBuffer(value)) {\n      return false;\n    }\n\n    const keys = Object.keys(value);\n    return keys.length > 0 && keys.every((key) => key.startsWith(\"$\"));\n  }\n\n  /**\n   * Build an UPDATE query from update operations.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param update - Update operations\n   * @param limit - Optional limit (for single row update)\n   * @returns Object with SQL and parameters\n   */\n  private buildUpdateQuery(\n    table: string,\n    filter: Record<string, unknown>,\n    update: UpdateOperations,\n    limit?: number,\n  ): { sql: string; params: unknown[] } {\n    const setClauses: string[] = [];\n    const params: unknown[] = [];\n    let paramIndex = 1;\n\n    // Handle $set\n    if (update.$set) {\n      for (const [key, value] of Object.entries(update.$set)) {\n        setClauses.push(\n          `${this.dialect.quoteIdentifier(key)} = ${this.dialect.placeholder(paramIndex++)}`,\n        );\n        // Apply the same json/jsonb-aware serialization used on the INSERT\n        // path so object/array $set values aren't corrupted into Postgres\n        // array literals. undefined is skipped — never bind it.\n        params.push(value === undefined ? value : this.serializeValue(key, value, table));\n      }\n    }\n\n    // Handle $unset (set to NULL)\n    if (update.$unset) {\n      for (const key of Object.keys(update.$unset)) {\n        setClauses.push(`${this.dialect.quoteIdentifier(key)} = NULL`);\n      }\n    }\n\n    // Handle $inc\n    if (update.$inc) {\n      for (const [key, amount] of Object.entries(update.$inc)) {\n        const quotedKey = this.dialect.quoteIdentifier(key);\n        setClauses.push(\n          `${quotedKey} = COALESCE(${quotedKey}, 0) + ${this.dialect.placeholder(paramIndex++)}`,\n        );\n        params.push(amount);\n      }\n    }\n\n    // Handle $dec\n    if (update.$dec) {\n      for (const [key, amount] of Object.entries(update.$dec)) {\n        const quotedKey = this.dialect.quoteIdentifier(key);\n        setClauses.push(\n          `${quotedKey} = COALESCE(${quotedKey}, 0) - ${this.dialect.placeholder(paramIndex++)}`,\n        );\n        params.push(amount);\n      }\n    }\n\n    if (setClauses.length === 0) {\n      throw new Error(\"No update operations specified\");\n    }\n\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const { whereClause, whereParams } = this.buildWhereClause(filter, paramIndex);\n    params.push(...whereParams);\n\n    let sql = `UPDATE ${quotedTable} SET ${setClauses.join(\", \")} ${whereClause}`;\n\n    // For single row update, use ctid subquery\n    if (limit === 1 && whereClause) {\n      sql = `UPDATE ${quotedTable} SET ${setClauses.join(\", \")} WHERE ctid IN (SELECT ctid FROM ${quotedTable} ${whereClause} LIMIT 1)`;\n    }\n\n    return { sql, params };\n  }\n\n  // ============================================================\n  // Database Lifecycle Operations\n  // ============================================================\n\n  /**\n   * Create a new database.\n   *\n   * Note: This requires connecting to a system database (like 'postgres')\n   * since you cannot create a database while connected to it.\n   *\n   * @param name - Database name to create\n   * @param options - Creation options (encoding, template, etc.)\n   * @returns true if created, false if already exists\n   */\n  public async createDatabase(name: string, options?: CreateDatabaseOptions): Promise<boolean> {\n    // Check if database already exists\n    if (await this.databaseExists(name)) {\n      return false;\n    }\n\n    // Build CREATE DATABASE statement\n    const quotedName = this.dialect.quoteIdentifier(name);\n    let sql = `CREATE DATABASE ${quotedName}`;\n\n    const withClauses: string[] = [];\n\n    if (options?.encoding) {\n      withClauses.push(`ENCODING = '${options.encoding}'`);\n    }\n    if (options?.template) {\n      withClauses.push(`TEMPLATE = ${this.dialect.quoteIdentifier(options.template)}`);\n    }\n    if (options?.locale) {\n      withClauses.push(`LC_COLLATE = '${options.locale}'`);\n      withClauses.push(`LC_CTYPE = '${options.locale}'`);\n    }\n    if (options?.owner) {\n      withClauses.push(`OWNER = ${this.dialect.quoteIdentifier(options.owner)}`);\n    }\n\n    if (withClauses.length > 0) {\n      sql += ` WITH ${withClauses.join(\" \")}`;\n    }\n\n    try {\n      await this.query(sql);\n      log.success(\"database\", \"lifecycle\", `Created database ${name}`);\n      return true;\n    } catch (error) {\n      log.error(\"database\", \"lifecycle\", `Failed to create database ${name}: ${error}`);\n      throw error;\n    }\n  }\n\n  /**\n   * Drop a database.\n   *\n   * @param name - Database name to drop\n   * @param options - Drop options\n   * @returns true if dropped, false if didn't exist\n   */\n  public async dropDatabase(name: string, options?: DropDatabaseOptions): Promise<boolean> {\n    // Check if database exists first (if ifExists option not set)\n    if (!options?.ifExists && !(await this.databaseExists(name))) {\n      return false;\n    }\n\n    const quotedName = this.dialect.quoteIdentifier(name);\n    let sql = \"DROP DATABASE\";\n\n    if (options?.ifExists) {\n      sql += \" IF EXISTS\";\n    }\n\n    sql += ` ${quotedName}`;\n\n    // PostgreSQL 13+ supports WITH (FORCE) to terminate active connections\n    if (options?.force) {\n      sql += \" WITH (FORCE)\";\n    }\n\n    try {\n      await this.query(sql);\n      log.success(\"database\", \"lifecycle\", `Dropped database ${name}`);\n      return true;\n    } catch (error) {\n      log.error(\"database\", \"lifecycle\", `Failed to drop database ${name}: ${error}`);\n      throw error;\n    }\n  }\n\n  /**\n   * Check if a database exists.\n   *\n   * @param name - Database name to check\n   * @returns true if database exists\n   */\n  public async databaseExists(name: string): Promise<boolean> {\n    const result = await this.query<{ exists: boolean }>(\n      `SELECT EXISTS(SELECT 1 FROM pg_database WHERE datname = $1) as exists`,\n      [name],\n    );\n\n    return result.rows[0]?.exists ?? false;\n  }\n\n  /**\n   * List all databases.\n   *\n   * @returns Array of database names\n   */\n  public async listDatabases(): Promise<string[]> {\n    const result = await this.query<{ datname: string }>(\n      `SELECT datname FROM pg_database WHERE datistemplate = false ORDER BY datname`,\n    );\n\n    return result.rows.map((row) => row.datname);\n  }\n\n  // ============================================================\n  // Table Management Operations\n  // ============================================================\n\n  /**\n   * Drop a table.\n   *\n   * @param name - Table name to drop\n   * @throws Error if table doesn't exist\n   */\n  public async dropTable(name: string): Promise<void> {\n    const quotedName = this.dialect.quoteIdentifier(name);\n    await this.query(`DROP TABLE ${quotedName}`);\n    log.success(\"database\", \"table\", `Dropped table ${name}`);\n  }\n\n  /**\n   * Drop a table if it exists.\n   *\n   * @param name - Table name to drop\n   */\n  public async dropTableIfExists(name: string): Promise<void> {\n    const quotedName = this.dialect.quoteIdentifier(name);\n    await this.query(`DROP TABLE IF EXISTS ${quotedName}`);\n  }\n\n  /**\n   * Drop all tables in the current database.\n   *\n   * Uses CASCADE to handle foreign key dependencies.\n   * Useful for `migrate:fresh` command.\n   */\n  public async dropAllTables(): Promise<void> {\n    // Get all tables from blueprint\n    const tables = await this.blueprint.listTables();\n\n    if (tables.length === 0) {\n      return;\n    }\n\n    // Drop all tables with CASCADE to handle foreign keys\n    for (const table of tables) {\n      const quotedName = this.dialect.quoteIdentifier(table);\n      await this.query(`DROP TABLE IF EXISTS ${quotedName} CASCADE`);\n    }\n\n    log.success(\"database\", \"table\", `Dropped ${tables.length} tables`);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"postgres-driver.mjs","names":[],"sources":["../../../../../../../../cascade/src/drivers/postgres/postgres-driver.ts"],"sourcesContent":["/**\n * PostgreSQL Driver\n *\n * Main driver implementation for PostgreSQL database operations.\n * Implements the DriverContract interface to provide a unified API\n * for CRUD operations, transactions, and query building.\n *\n * Uses the `pg` package for database connectivity with connection pooling.\n *\n * @module cascade/drivers/postgres\n */\n\nimport { colors } from \"@mongez/copper\";\nimport { log } from \"@warlock.js/logger\";\nimport { databaseTransactionContext } from \"../../context/database-transaction-context\";\nimport type {\n  CreateDatabaseOptions,\n  DriverContract,\n  DriverEventListener,\n  DriverTransactionContract,\n  DropDatabaseOptions,\n  InsertResult,\n  TransactionContext,\n  UpdateOperations,\n  UpdateResult,\n} from \"../../contracts/database-driver.contract\";\nimport type { DriverBlueprintContract } from \"../../contracts/driver-blueprint.contract\";\nimport type { MigrationDriverContract } from \"../../contracts/migration-driver.contract\";\nimport type { QueryBuilderContract } from \"../../contracts/query-builder.contract\";\nimport type { SyncAdapterContract } from \"../../contracts/sync-adapter.contract\";\nimport { TransactionRollbackError } from \"../../errors/transaction-rollback.error\";\nimport { SQLSerializer } from \"../../migration/sql-serializer\";\nimport { SqlDatabaseDirtyTracker } from \"../../sql-database-dirty-tracker\";\nimport type { ModelDefaults } from \"../../types\";\nimport { type DatabaseDriver } from \"../../utils/connect-to-database\";\nimport { isValidDateValue } from \"../../utils/is-valid-date-value\";\nimport { PostgresBlueprint } from \"./postgres-blueprint\";\nimport { PostgresDialect } from \"./postgres-dialect\";\nimport { PostgresMigrationDriver } from \"./postgres-migration-driver\";\nimport { PostgresQueryBuilder } from \"./postgres-query-builder\";\nimport { PostgresSQLSerializer } from \"./postgres-sql-serializer\";\nimport { PostgresSyncAdapter } from \"./postgres-sync-adapter\";\nimport type { PostgresPoolConfig, PostgresQueryResult, PostgresTransactionOptions } from \"./types\";\n\n/**\n * Lazily loaded pg module types.\n */\ntype PgPool = import(\"pg\").Pool;\ntype PgPoolClient = import(\"pg\").PoolClient;\ntype PgPoolConfig = import(\"pg\").PoolConfig;\n\n/**\n * Build pg's `PoolConfig` from cascade's `PostgresPoolConfig`, coercing the\n * string-typed connection fields.\n *\n * `env()` (@mongez/dotenv) coerces a numeric-looking value to a number, so a\n * `DB_NAME` / `DB_USERNAME` / `DB_PASSWORD` like \"12345\" arrives here as a\n * number. pg's connection fields must be strings — a number reaches deep into\n * the driver and crashes with an inscrutable Buffer error rather than a\n * legible \"database does not exist\" (finding 51639bf8). So `host`, `database`,\n * `user` and `password` are coerced to strings; `port` is a real number and\n * `undefined` is left untouched so pg's own defaults still apply.\n *\n * Exported (not inlined into `connect()`) so the coercion is unit-testable\n * without a live database.\n */\nexport function buildPostgresPoolConfig(config: PostgresPoolConfig): PgPoolConfig {\n  const asString = (value: unknown): string | undefined =>\n    typeof value === \"number\" ? String(value) : (value as string | undefined);\n\n  return {\n    host: asString(config.host) ?? \"localhost\",\n    port: config.port ?? 5432,\n    database: asString(config.database),\n    user: asString(config.user),\n    password: asString(config.password),\n    connectionString: config.connectionString,\n    max: config.max ?? 10,\n    min: config.min ?? 0,\n    idleTimeoutMillis: config.idleTimeoutMillis ?? 30000,\n    connectionTimeoutMillis: config.connectionTimeoutMillis ?? 2000,\n    application_name: config.application_name ?? \"cascade\",\n    ssl: config.ssl,\n  };\n}\n\n/**\n * Cached pg module reference.\n */\nlet pgModule: typeof import(\"pg\") | undefined;\n\n/**\n * Lazily load the pg package.\n *\n * @returns The pg module\n * @throws Error if pg is not installed\n */\nasync function loadPg(): Promise<typeof import(\"pg\")> {\n  if (pgModule) {\n    return pgModule;\n  }\n\n  try {\n    pgModule = await import(\"pg\");\n    return pgModule;\n  } catch {\n    throw new Error(\n      'The \"pg\" package is required for PostgreSQL support. ' + \"Please install it: npm install pg\",\n    );\n  }\n}\n\n/**\n * PostgreSQL database driver implementing the Cascade DriverContract.\n *\n * Provides connection pooling, CRUD operations, transactions, and\n * integration with Cascade's query builder and migration systems.\n *\n * @example\n * ```typescript\n * const driver = new PostgresDriver({\n *   host: 'localhost',\n *   port: 5432,\n *   database: 'myapp',\n *   user: 'postgres',\n *   password: 'secret'\n * });\n *\n * await driver.connect();\n *\n * // Insert a document\n * const result = await driver.insert('users', { name: 'Alice', email: 'alice@example.com' });\n *\n * // Query using the query builder\n * const users = await driver.queryBuilder('users')\n *   .where('name', 'Alice')\n *   .get();\n *\n * await driver.disconnect();\n * ```\n */\nexport class PostgresDriver implements DriverContract {\n  /**\n   * Driver name identifier.\n   */\n  public readonly name = \"postgres\" as DatabaseDriver;\n\n  /**\n   * SQL dialect for PostgreSQL-specific syntax.\n   */\n  public readonly dialect = new PostgresDialect();\n\n  /**\n   * PostgreSQL driver model defaults.\n   *\n   * PostgreSQL follows SQL conventions:\n   * - snake_case naming for columns (created_at, updated_at, deleted_at)\n   * - Native AUTO_INCREMENT for IDs (no manual generation)\n   * - Timestamps enabled by default\n   * - Permanent delete strategy (hard deletes)\n   */\n  public readonly modelDefaults: Partial<ModelDefaults> = {\n    namingConvention: \"snake_case\",\n    createdAtColumn: \"created_at\",\n    updatedAtColumn: \"updated_at\",\n    deletedAtColumn: \"deleted_at\",\n    timestamps: true,\n    autoGenerateId: false, // PostgreSQL uses SERIAL/BIGSERIAL\n    strictMode: \"fail\",\n    deleteStrategy: \"permanent\",\n  };\n\n  /**\n   * Connection pool instance.\n   */\n  private _pool: PgPool | undefined;\n\n  /**\n   * Event listeners for driver lifecycle events.\n   */\n  private readonly _eventListeners = new Map<string, Set<DriverEventListener>>();\n\n  /**\n   * Whether the driver is currently connected.\n   */\n  private _isConnected = false;\n\n  /**\n   * Blueprint instance (lazy-loaded).\n   */\n  private _blueprint: DriverBlueprintContract | undefined;\n\n  /**\n   * Migration driver instance (lazy-loaded).\n   */\n  private _migrationDriver: MigrationDriverContract | undefined;\n\n  /**\n   * Sync adapter instance (lazy-loaded).\n   */\n  private _syncAdapter: SyncAdapterContract | undefined;\n\n  /**\n   * Explicit, table-agnostic override list of column names that hold native\n   * PostgreSQL arrays (`JSONB[]`, `TEXT[]`, …) and must NOT be JSON-text\n   * encoded. Merged with (and superseded per-table by) the schema\n   * introspection below; kept as a manual escape hatch.\n   *\n   * @see PostgresPoolConfig.nativeArrayColumns\n   */\n  private readonly _nativeArrayColumns: ReadonlySet<string>;\n\n  /**\n   * Native-array columns discovered by introspecting the live schema on\n   * connect, keyed `table → { column, … }`. Authoritative and table-scoped, so\n   * a column that is `TEXT[]` in one table and `jsonb` in another is encoded\n   * correctly for each — no app configuration required.\n   */\n  private _introspectedArrayColumns: ReadonlyMap<string, ReadonlySet<string>> = new Map();\n\n  /**\n   * Create a new PostgreSQL driver instance.\n   *\n   * @param config - PostgreSQL connection configuration\n   */\n  public constructor(private readonly config: PostgresPoolConfig) {\n    this._nativeArrayColumns = new Set(config.nativeArrayColumns ?? []);\n  }\n\n  /**\n   * Get the connection pool instance.\n   *\n   * @throws Error if not connected\n   */\n  public get pool(): PgPool {\n    if (!this._pool) {\n      throw new Error(\"PostgreSQL driver is not connected. Call connect() first.\");\n    }\n    return this._pool;\n  }\n\n  /**\n   * Get database native client\n   */\n  public getClient<Client = PgPool>(): Client {\n    return this.pool as Client;\n  }\n\n  /**\n   * Check if the driver is currently connected.\n   */\n  public get isConnected(): boolean {\n    return this._isConnected;\n  }\n\n  /**\n   * Get the driver blueprint (information schema).\n   */\n  public get blueprint(): DriverBlueprintContract {\n    if (!this._blueprint) {\n      this._blueprint = new PostgresBlueprint(this);\n    }\n    return this._blueprint;\n  }\n\n  /**\n   * Establish connection to the PostgreSQL database.\n   *\n   * Creates a connection pool with the configured options.\n   * Emits 'connected' event on successful connection.\n   */\n  public async connect(): Promise<void> {\n    if (this._isConnected) {\n      return;\n    }\n\n    const pg = await loadPg();\n\n    try {\n      const poolConfig = buildPostgresPoolConfig(this.config);\n\n      log.info(\n        \"database.postgres\",\n        \"connection\",\n        `Connecting to database ${colors.bold(colors.yellowBright(poolConfig.database ?? \"\"))}`,\n      );\n\n      this._pool = new pg.Pool(poolConfig);\n\n      // Test the connection\n      const client = await this._pool.connect();\n      client.release();\n\n      log.success(\n        \"database.postgres\",\n        \"connection\",\n        `Connected to database ${colors.bold(colors.yellowBright(this.config.database))}`,\n      );\n\n      this._isConnected = true;\n\n      // Learn which columns are native arrays straight from the live schema so\n      // the value serializer encodes them correctly with zero app config.\n      await this.loadNativeArrayColumns();\n\n      this.emit(\"connected\");\n    } catch (error) {\n      // Boot-time database connection failure is unrecoverable in every\n      // realistic caller (app boot, CLI migrations, workers) — `fatal` makes\n      // \"page on fatal only\" alerting clean. Per-query failures stay at error.\n      log.fatal(\"database.postgres\", \"connection\", \"Failed to connect to database\");\n      throw error;\n    }\n  }\n\n  /**\n   * Close the database connection pool.\n   *\n   * Waits for all active queries to complete before closing.\n   * Emits 'disconnected' event on successful disconnection.\n   */\n  public async disconnect(): Promise<void> {\n    if (!this._isConnected || !this._pool) {\n      return;\n    }\n\n    await this._pool.end();\n    this._pool = undefined;\n    this._isConnected = false;\n    this.emit(\"disconnected\");\n  }\n\n  /**\n   * Register an event listener for driver lifecycle events.\n   *\n   * @param event - Event name ('connected', 'disconnected', etc.)\n   * @param listener - Callback function to invoke\n   */\n  public on(event: string, listener: DriverEventListener): void {\n    if (!this._eventListeners.has(event)) {\n      this._eventListeners.set(event, new Set());\n    }\n\n    this._eventListeners.get(event)!.add(listener);\n  }\n\n  /**\n   * Serialize data for storage in PostgreSQL.\n   *\n   * Handles Date objects, BigInt, and other JavaScript types\n   * that need special handling for PostgreSQL storage.\n   *\n   * @param data - The data object to serialize\n   * @param table - Optional table name; when given, columns introspected as\n   *   native arrays on that table are bound raw (see {@link serializeValue}).\n   * @returns Serialized data ready for PostgreSQL\n   */\n  public serialize(\n    data: Record<string, unknown>,\n    table?: string,\n  ): Record<string, unknown> {\n    const serialized: Record<string, unknown> = {};\n\n    for (const [key, value] of Object.entries(data)) {\n      if (value === undefined) {\n        continue; // Skip undefined values\n      }\n\n      serialized[key] = this.serializeValue(key, value, table);\n    }\n\n    return serialized;\n  }\n\n  /**\n   * Serialize a single column value into a node-pg bindable parameter.\n   *\n   * Shared by {@link serialize} (INSERT path) and {@link buildUpdateQuery}\n   * `$set` (UPDATE path) so both encode `json` / `jsonb` columns identically.\n   *\n   * Encoding rules (in order):\n   * - `Date` → ISO string.\n   * - `bigint` → decimal string (node-pg has no native bigint binding).\n   * - all-number array → pgvector literal `'[n1,n2,...]'`. node-pg would\n   *   otherwise emit a `{n1,n2,...}` array literal, which the `vector` type\n   *   rejects. This branch is preserved exactly.\n   * - any other array (object-array, string-array, mixed, empty `[]`) →\n   *   `JSON.stringify`. node-pg renders a raw JS array as a PostgreSQL array\n   *   literal `{...}` (and `[]` as `{}`), which a `json` / `jsonb` column\n   *   rejects — so we bind the value as JSON text instead, the form those\n   *   columns accept. Columns known to be native arrays — via schema\n   *   introspection or the `nativeArrayColumns` config — are exempt: their raw\n   *   array is passed through so node-pg emits the `{...}` literal a genuine\n   *   `JSONB[]` / `TEXT[]` column needs.\n   * - plain object → `JSON.stringify`. Equivalent to node-pg's own object\n   *   handling, made explicit so both write paths agree.\n   * - everything else (scalars: string, number, boolean, null) → untouched.\n   *\n   * Distinguishing native-array from `json` / `jsonb` columns: a value alone\n   * can't tell them apart, so the driver introspects the live schema on connect\n   * (see {@link loadNativeArrayColumns}) and consults that per-table map here\n   * via {@link isNativeArrayColumn}. The explicit `nativeArrayColumns` config\n   * still works as a table-agnostic override. No `::jsonb` placeholder cast is\n   * added: a JSON-text string binds correctly to `json` / `jsonb` without one,\n   * and a blind cast would misfire on columns we cannot positively identify as\n   * jsonb.\n   *\n   * @param key - Column name (used to resolve native-array columns)\n   * @param value - The raw value to serialize (never `undefined`)\n   * @param table - Optional table name; enables the per-table native-array lookup\n   * @returns The value ready to bind as a query parameter\n   */\n  private serializeValue(key: string, value: unknown, table?: string): unknown {\n    if (value instanceof Date) {\n      return value.toISOString();\n    }\n\n    if (typeof value === \"bigint\") {\n      return value.toString();\n    }\n\n    if (Array.isArray(value)) {\n      if (value.length > 0 && value.every((v) => typeof v === \"number\")) {\n        // pgvector columns expect the literal '[n1,n2,...]' format.\n        return `[${value.join(\",\")}]`;\n      }\n\n      // Genuine native PostgreSQL array columns (JSONB[], TEXT[], …) must\n      // keep their raw array so node-pg emits a '{...}' array literal.\n      if (this.isNativeArrayColumn(table, key)) {\n        return value;\n      }\n\n      // json / jsonb columns: bind as JSON text. Covers object-arrays,\n      // string-arrays, mixed arrays, and empty [] (which would otherwise\n      // store as '{}' instead of '[]').\n      return JSON.stringify(value);\n    }\n\n    if (typeof value === \"object\" && value !== null) {\n      // Plain object → JSONB. Explicit JSON.stringify matches node-pg's own\n      // object encoding while keeping both write paths consistent.\n      return JSON.stringify(value);\n    }\n\n    return value;\n  }\n\n  /**\n   * Whether `column` on `table` is a native PostgreSQL array. True when the\n   * connect-time schema introspection saw it as `data_type = 'ARRAY'` for that\n   * table (authoritative, per-table), or when it's listed in the table-agnostic\n   * `nativeArrayColumns` config override.\n   */\n  private isNativeArrayColumn(table: string | undefined, column: string): boolean {\n    if (table && this._introspectedArrayColumns.get(table)?.has(column)) {\n      return true;\n    }\n\n    return this._nativeArrayColumns.has(column);\n  }\n\n  /**\n   * Introspect the live schema for native-array columns so array values bind\n   * correctly with zero app configuration.\n   *\n   * A JS array must be bound two opposite ways depending on the column: as JSON\n   * text for a `json` / `jsonb` column, but as a raw array (which node-pg\n   * renders `{...}`) for a native `TEXT[]` / `JSONB[]` / `INTEGER[]` column. The\n   * serializer sees values, not types, so without this it JSON-stringifies\n   * every array — which a native-array column rejects with \"malformed array\n   * literal\". One `information_schema` query at connect, cached for the\n   * connection lifetime, removes the need to hand-list `nativeArrayColumns`.\n   *\n   * Best-effort: any failure (e.g. restricted catalog access) is logged and\n   * leaves the map empty so the config override still applies — it never blocks\n   * connect. A schema change made within a live connection isn't reflected\n   * until the next connect.\n   */\n  private async loadNativeArrayColumns(): Promise<void> {\n    try {\n      const result = await this.query<{ table_name: string; column_name: string }>(\n        `SELECT table_name, column_name\n         FROM information_schema.columns\n         WHERE table_schema = ANY (current_schemas(false))\n           AND data_type = 'ARRAY'`,\n      );\n\n      const map = new Map<string, Set<string>>();\n\n      for (const { table_name, column_name } of result.rows) {\n        let columns = map.get(table_name);\n\n        if (!columns) {\n          columns = new Set<string>();\n          map.set(table_name, columns);\n        }\n\n        columns.add(column_name);\n      }\n\n      this._introspectedArrayColumns = map;\n    } catch {\n      // Introspection is an optimization, never a hard dependency — fall back\n      // to the `nativeArrayColumns` config so a locked-down catalog or an\n      // unusual search_path can't break connect.\n      log.warn(\n        \"database.postgres\",\n        \"introspection\",\n        \"Could not introspect native-array columns; using the nativeArrayColumns config only\",\n      );\n    }\n  }\n\n  /**\n   * Get the dirty tracker for this driver.\n   */\n  public getDirtyTracker(data: Record<string, unknown>): SqlDatabaseDirtyTracker {\n    return new SqlDatabaseDirtyTracker(data);\n  }\n\n  /**\n   * Deserialize data retrieved from PostgreSQL.\n   *\n   * Converts PostgreSQL types back to JavaScript equivalents.\n   *\n   * @param data - The data object from PostgreSQL\n   * @returns Deserialized JavaScript object\n   */\n  public deserialize(data: Record<string, unknown>): Record<string, unknown> {\n    // PostgreSQL pg driver handles most type conversions automatically\n    // Special handling can be added here if needed\n    for (const [key, value] of Object.entries(data)) {\n      // Only re-inflate strings — pg already returns Date objects from DB reads\n      if (typeof value !== \"string\") continue;\n\n      if (isValidDateValue(value)) {\n        data[key] = new Date(value);\n        continue;\n      }\n\n      // pgvector columns are returned as '[n1,n2,...]' strings.\n      // charCodeAt is faster than startsWith/endsWith — no string allocation.\n      // '[' = 91, ']' = 93\n      if (value.charCodeAt(0) === 91 && value.charCodeAt(value.length - 1) === 93) {\n        const parts = value.slice(1, -1).split(\",\");\n        const nums = new Array<number>(parts.length);\n        let isNumericVector = parts.length > 0;\n\n        for (let i = 0; i < parts.length; i++) {\n          // `parts[i]` is `string | undefined` under noUncheckedIndexedAccess even\n          // though `i < parts.length`. `+undefined` is NaN, which the finite check\n          // below already rejects — so `?? \"\"` keeps the coercion total without\n          // changing which inputs count as a numeric vector (+\"\" is 0, but an\n          // empty segment cannot occur for i < length).\n          const n = +(parts[i] ?? \"\"); // unary + is the fastest string-to-number coercion\n          if (!Number.isFinite(n)) {\n            isNumericVector = false;\n            break; // early-exit — not a numeric vector, leave value untouched\n          }\n          nums[i] = n;\n        }\n\n        if (isNumericVector) {\n          data[key] = nums;\n        }\n      }\n    }\n\n    return data;\n  }\n\n  /**\n   * Insert a single row into a table.\n   *\n   * Uses INSERT ... RETURNING to get the inserted row with generated values.\n   *\n   * @param table - Target table name\n   * @param document - Data to insert\n   * @param options - Optional insertion options\n   * @returns The inserted document\n   */\n  public async insert(\n    table: string,\n    document: Record<string, unknown>,\n    _options?: Record<string, unknown>,\n  ): Promise<InsertResult> {\n    const serialized = this.serialize(document, table);\n\n    // Filter out id if null/undefined to let PostgreSQL SERIAL auto-generate\n    const filteredData = Object.fromEntries(\n      Object.entries(serialized).filter(([key, value]) => {\n        // Exclude id if null/undefined (let SERIAL handle it)\n        if (key === \"id\" && (value === null || value === undefined)) {\n          return false;\n        }\n        return true;\n      }),\n    );\n\n    const columns = Object.keys(filteredData);\n    const values = Object.values(filteredData);\n\n    if (columns.length === 0) {\n      throw new Error(\"Cannot insert empty document\");\n    }\n\n    const quotedColumns = columns.map((c) => this.dialect.quoteIdentifier(c)).join(\", \");\n    const placeholders = columns.map((_, i) => this.dialect.placeholder(i + 1)).join(\", \");\n    const quotedTable = this.dialect.quoteIdentifier(table);\n\n    const sql = `INSERT INTO ${quotedTable} (${quotedColumns}) VALUES (${placeholders}) RETURNING *`;\n\n    const result = await this.query<Record<string, unknown>>(sql, values);\n\n    return {\n      document: result.rows[0],\n    };\n  }\n\n  /**\n   * Insert multiple rows into a table.\n   *\n   * Uses a single INSERT statement with multiple value sets for efficiency.\n   *\n   * @param table - Target table name\n   * @param documents - Array of documents to insert\n   * @param options - Optional insertion options\n   * @returns Array of inserted documents\n   */\n  public async insertMany(\n    table: string,\n    documents: Record<string, unknown>[],\n    _options?: Record<string, unknown>,\n  ): Promise<InsertResult[]> {\n    if (documents.length === 0) {\n      return [];\n    }\n\n    // Get all unique columns across all documents\n    const allColumns = new Set<string>();\n    for (const doc of documents) {\n      const serialized = this.serialize(doc, table);\n      Object.keys(serialized).forEach((key) => allColumns.add(key));\n    }\n    const columns = Array.from(allColumns);\n\n    const quotedColumns = columns.map((c) => this.dialect.quoteIdentifier(c)).join(\", \");\n    const quotedTable = this.dialect.quoteIdentifier(table);\n\n    // Build value sets and params\n    const valueSets: string[] = [];\n    const params: unknown[] = [];\n    let paramIndex = 1;\n\n    for (const doc of documents) {\n      const serialized = this.serialize(doc, table);\n      const rowPlaceholders: string[] = [];\n\n      for (const col of columns) {\n        if (col in serialized) {\n          rowPlaceholders.push(this.dialect.placeholder(paramIndex++));\n          params.push(serialized[col]);\n        } else {\n          rowPlaceholders.push(\"DEFAULT\");\n        }\n      }\n\n      valueSets.push(`(${rowPlaceholders.join(\", \")})`);\n    }\n\n    const sql = `INSERT INTO ${quotedTable} (${quotedColumns}) VALUES ${valueSets.join(\", \")} RETURNING *`;\n\n    const result = await this.query<Record<string, unknown>>(sql, params);\n\n    return result.rows as unknown as InsertResult[];\n  }\n\n  /**\n   * Update a single row matching the filter.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param update - Update operations ($set, $unset, $inc)\n   * @param options - Optional update options\n   * @returns Update result with modified count\n   */\n  public async update(\n    table: string,\n    filter: Record<string, unknown>,\n    update: UpdateOperations,\n    _options?: Record<string, unknown>,\n  ): Promise<UpdateResult> {\n    const { sql, params } = this.buildUpdateQuery(table, filter, update, 1);\n    try {\n      const result = await this.query(sql, params);\n\n      return {\n        modifiedCount: result.rowCount ?? 0,\n      };\n    } catch (error) {\n      console.log(\"PG Query Error in:\", sql, params);\n\n      throw error;\n    }\n  }\n\n  /**\n   * Find one and update a single row matching the filter and return the updated row\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param update - Update operations ($set, $unset, $inc)\n   * @param options - Optional update options\n   * @returns The updated row or null\n   */\n  public async findOneAndUpdate<T = unknown>(\n    table: string,\n    filter: Record<string, unknown>,\n    update: UpdateOperations,\n    _options?: Record<string, unknown>,\n  ): Promise<T | null> {\n    const { sql, params } = this.buildUpdateQuery(table, filter, update, 1);\n    // Add RETURNING * to get the updated row back\n    const sqlWithReturning = `${sql} RETURNING *`;\n    const result = await this.query<T>(sqlWithReturning, params);\n    return result.rows[0] ?? null;\n  }\n\n  /**\n   * Update multiple rows matching the filter.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param update - Update operations\n   * @param options - Optional update options\n   * @returns Update result with modified count\n   */\n  public async updateMany(\n    table: string,\n    filter: Record<string, unknown>,\n    update: UpdateOperations,\n    _options?: Record<string, unknown>,\n  ): Promise<UpdateResult> {\n    const { sql, params } = this.buildUpdateQuery(table, filter, update);\n\n    const result = await this.query(sql, params);\n\n    return {\n      modifiedCount: result.rowCount ?? 0,\n    };\n  }\n\n  /**\n   * Replace a document matching the filter.\n   *\n   * Completely replaces the document (not a partial update).\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param document - New document data\n   * @param options - Optional options\n   * @returns The replaced document or null\n   */\n  public async replace<T = unknown>(\n    table: string,\n    filter: Record<string, unknown>,\n    document: Record<string, unknown>,\n    _options?: Record<string, unknown>,\n  ): Promise<T | null> {\n    const serialized = this.serialize(document, table);\n    const columns = Object.keys(serialized);\n    const values = Object.values(serialized);\n\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const setClauses = columns\n      .map((col, i) => `${this.dialect.quoteIdentifier(col)} = ${this.dialect.placeholder(i + 1)}`)\n      .join(\", \");\n\n    const { whereClause, whereParams } = this.buildWhereClause(filter, columns.length + 1);\n\n    const sql = `UPDATE ${quotedTable} SET ${setClauses} ${whereClause} RETURNING *`;\n    const params = [...values, ...whereParams];\n\n    const result = await this.query<T>(sql, params);\n\n    return result.rows[0] ?? null;\n  }\n\n  /**\n   * Upsert (insert or update) a single row.\n   *\n   * Uses PostgreSQL's INSERT ... ON CONFLICT ... DO UPDATE syntax.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions to find existing row (used for conflict detection)\n   * @param document - Document data to insert or update\n   * @param options - Upsert options (conflictColumns for conflict target)\n   * @returns The upserted row\n   */\n  public async upsert<T = unknown>(\n    table: string,\n    filter: Record<string, unknown>,\n    document: Record<string, unknown>,\n    options?: Record<string, unknown>,\n  ): Promise<T> {\n    const serialized = this.serialize(document, table);\n    const columns = Object.keys(serialized);\n    const values = Object.values(serialized);\n\n    if (columns.length === 0) {\n      throw new Error(\"Cannot upsert empty document\");\n    }\n\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const quotedColumns = columns.map((c) => this.dialect.quoteIdentifier(c)).join(\", \");\n    const placeholders = columns.map((_, i) => this.dialect.placeholder(i + 1)).join(\", \");\n\n    // Determine conflict columns from options or filter\n    const conflictColumns = (options?.conflictColumns as string[]) ?? Object.keys(filter);\n    if (conflictColumns.length === 0) {\n      throw new Error(\"Upsert requires conflictColumns option or filter with columns\");\n    }\n\n    const quotedConflictColumns = conflictColumns\n      .map((c) => this.dialect.quoteIdentifier(c))\n      .join(\", \");\n\n    // Build UPDATE clause for ON CONFLICT\n    // Update all columns except the conflict columns (they stay the same)\n    const updateColumns = columns.filter((col) => !conflictColumns.includes(col));\n    const setClauses = updateColumns\n      .map((col, i) => {\n        const valueIndex = columns.indexOf(col) + 1;\n        return `${this.dialect.quoteIdentifier(col)} = ${this.dialect.placeholder(valueIndex)}`;\n      })\n      .join(\", \");\n\n    // If there are no columns to update (all columns are conflict columns), use EXCLUDED\n    const updateClause =\n      setClauses.length > 0\n        ? setClauses\n        : columns\n            .map(\n              (col) =>\n                `${this.dialect.quoteIdentifier(col)} = EXCLUDED.${this.dialect.quoteIdentifier(col)}`,\n            )\n            .join(\", \");\n\n    const sql = `INSERT INTO ${quotedTable} (${quotedColumns}) VALUES (${placeholders}) ON CONFLICT (${quotedConflictColumns}) DO UPDATE SET ${updateClause} RETURNING *`;\n\n    const result = await this.query<T>(sql, values);\n\n    return result.rows[0]! as T;\n  }\n\n  /**\n   * Find one and delete a single row matching the filter and return the deleted row.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param options - Optional delete options\n   * @returns The deleted row or null\n   */\n  public async findOneAndDelete<T = unknown>(\n    table: string,\n    filter: Record<string, unknown>,\n    _options?: Record<string, unknown>,\n  ): Promise<T | null> {\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const { whereClause, whereParams } = this.buildWhereClause(filter, 1);\n\n    // Use ctid for single row deletion with RETURNING\n    const sql = `DELETE FROM ${quotedTable} WHERE ctid IN (SELECT ctid FROM ${quotedTable} ${whereClause} LIMIT 1) RETURNING *`;\n\n    const result = await this.query<T>(sql, whereParams);\n\n    return result.rows[0] ? (result.rows[0] as T) : null;\n  }\n\n  /**\n   * Delete a single row matching the filter.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param options - Optional options\n   * @returns Number of deleted rows (0 or 1)\n   */\n  public async delete(\n    table: string,\n    filter?: Record<string, unknown>,\n    _options?: Record<string, unknown>,\n  ): Promise<number> {\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const { whereClause, whereParams } = this.buildWhereClause(filter ?? {}, 1);\n\n    // Use ctid for single row deletion\n    const sql = `DELETE FROM ${quotedTable} WHERE ctid IN (SELECT ctid FROM ${quotedTable} ${whereClause} LIMIT 1)`;\n\n    const result = await this.query(sql, whereParams);\n\n    return result.rowCount ?? 0;\n  }\n\n  /**\n   * Delete multiple rows matching the filter.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param options - Optional options\n   * @returns Number of deleted rows\n   */\n  public async deleteMany(\n    table: string,\n    filter?: Record<string, unknown>,\n    _options?: Record<string, unknown>,\n  ): Promise<number> {\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const { whereClause, whereParams } = this.buildWhereClause(filter ?? {}, 1);\n\n    const sql = `DELETE FROM ${quotedTable} ${whereClause}`;\n\n    const result = await this.query(sql, whereParams);\n\n    return result.rowCount ?? 0;\n  }\n\n  /**\n   * Truncate a table (remove all rows).\n   *\n   * Uses TRUNCATE TABLE for fast deletion with RESTART IDENTITY.\n   *\n   * @param table - Target table name\n   * @param options - Optional options\n   * @param options.cascade - If true, automatically truncate all tables with foreign key references (use with caution)\n   * @returns Number of deleted rows (always 0 for TRUNCATE)\n   */\n  public async truncateTable(table: string, options?: { cascade?: boolean }): Promise<number> {\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const cascadeClause = options?.cascade ? \" CASCADE\" : \"\";\n    await this.query(`TRUNCATE TABLE ${quotedTable} RESTART IDENTITY${cascadeClause}`);\n    return 0; // TRUNCATE doesn't return row count\n  }\n\n  /**\n   * Get a query builder for the specified table.\n   *\n   * @param table - Target table name\n   * @returns Query builder instance\n   */\n  public queryBuilder<T = unknown>(table: string): QueryBuilderContract<T> {\n    return new PostgresQueryBuilder<T>(table) as unknown as QueryBuilderContract<T>;\n  }\n\n  /**\n   * Begin a new database transaction.\n   *\n   * Acquires a client from the pool and starts a transaction.\n   * The client is stored in AsyncLocalStorage for automatic\n   * participation by subsequent queries.\n   *\n   * @param options - Optional transaction options\n   * @returns Transaction contract with commit/rollback methods\n   */\n  public async beginTransaction(\n    options?: PostgresTransactionOptions,\n  ): Promise<DriverTransactionContract<PgPoolClient>> {\n    const client = await this.pool.connect();\n\n    let beginSql = \"BEGIN\";\n    if (options?.isolationLevel) {\n      beginSql += ` ISOLATION LEVEL ${options.isolationLevel.toUpperCase()}`;\n    }\n    if (options?.readOnly) {\n      beginSql += \" READ ONLY\";\n    }\n    if (options?.deferrable) {\n      beginSql += \" DEFERRABLE\";\n    }\n\n    await client.query(beginSql);\n\n    return {\n      context: client,\n      commit: async () => {\n        await client.query(\"COMMIT\");\n        client.release();\n      },\n      rollback: async () => {\n        await client.query(\"ROLLBACK\");\n        client.release();\n      },\n    };\n  }\n\n  /**\n   * Execute a function within a transaction scope (recommended pattern).\n   *\n   * Automatically commits on success, rolls back on any error, and guarantees\n   * resource cleanup. This is the recommended way to use transactions.\n   *\n   * @param fn - Async function to execute within transaction\n   * @param options - Transaction options (isolation level, read-only, etc.)\n   * @returns The return value of the callback function\n   * @throws {Error} If transaction fails or is explicitly rolled back\n   */\n  public async transaction<T>(\n    fn: (ctx: TransactionContext) => Promise<T>,\n    options?: Record<string, unknown>,\n  ): Promise<T> {\n    const ctx: TransactionContext = {\n      rollback(reason?: string): never {\n        throw new TransactionRollbackError(reason);\n      },\n    };\n\n    // Flat nesting: a transaction() called while one is already active JOINS it\n    // instead of opening a second, independent transaction on another pool\n    // connection. An independent inner transaction can't see the outer's\n    // uncommitted writes (a row inserted moments earlier), so a service that\n    // opens its own transaction — correct when called standalone — would hit\n    // phantom FK violations when called inside an outer transaction (e.g. a\n    // seeder that creates a row, then calls a service that references it). The\n    // outermost transaction owns BEGIN / COMMIT / ROLLBACK; the inner block\n    // runs on the same session, and a throw still unwinds the whole outer\n    // transaction. (Savepoint-based partial rollback is a separate, explicit\n    // concern — use `beginTransaction()` directly for that.)\n    if (databaseTransactionContext.hasActiveTransaction()) {\n      return fn(ctx);\n    }\n\n    const tx = await this.beginTransaction(options);\n\n    // Set transaction context for queries within callback\n    databaseTransactionContext.enter({ session: tx.context });\n\n    try {\n      // Execute callback\n      const result = await fn(ctx);\n\n      // Auto-commit on success\n      await tx.commit();\n\n      return result;\n    } catch (error) {\n      // Auto-rollback on any error (including explicit rollback)\n      await tx.rollback();\n      log.error(\n        `database.postgress`,\n        \"transaction\",\n        \"Transaction operation failed, rolled back everything\",\n      );\n      throw error;\n    } finally {\n      // Guaranteed cleanup\n      databaseTransactionContext.exit();\n    }\n  }\n\n  /**\n   * Perform an atomic update operation.\n   *\n   * Builds and executes an UPDATE query for the given filter and operations.\n   * Updates EVERY matching row — the MongoDB driver's atomic() delegates to\n   * updateMany, and Model.findAndUpdate documents multi-row semantics, so the\n   * two drivers must agree.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param operations - Update operations\n   * @param options - Optional options\n   * @returns Update result\n   */\n  public async atomic(\n    table: string,\n    filter: Record<string, unknown>,\n    operations: UpdateOperations,\n    _options?: Record<string, unknown>,\n  ): Promise<UpdateResult> {\n    const { sql, params } = this.buildUpdateQuery(table, filter, operations);\n\n    const result = await this.query(sql, params);\n\n    return {\n      modifiedCount: result.rowCount ?? 0,\n    };\n  }\n\n  /**\n   * Get the sync adapter for bulk denormalized updates.\n   *\n   * @returns Sync adapter instance\n   */\n  public syncAdapter(): SyncAdapterContract {\n    if (!this._syncAdapter) {\n      this._syncAdapter = new PostgresSyncAdapter(this);\n    }\n    return this._syncAdapter;\n  }\n\n  /**\n   * Get the migration driver for schema operations.\n   *\n   * @returns Migration driver instance\n   */\n  public migrationDriver(): MigrationDriverContract {\n    if (!this._migrationDriver) {\n      this._migrationDriver = new PostgresMigrationDriver(this);\n    }\n\n    return this._migrationDriver;\n  }\n\n  /**\n   * Return a SQL serializer for this driver's dialect.\n   * Used by Migration.toSQL() to convert pending operations to SQL strings.\n   */\n  public getSQLSerializer(): SQLSerializer {\n    return new PostgresSQLSerializer(this.dialect);\n  }\n\n  /**\n   * Execute a raw SQL query.\n   *\n   * Automatically uses the transaction client if one is active.\n   *\n   * @param sql - SQL query string\n   * @param params - Query parameters\n   * @returns Query result\n   */\n  public async query<T = Record<string, unknown>>(\n    sql: string,\n    params: unknown[] = [],\n  ): Promise<PostgresQueryResult<T>> {\n    // Check for active transaction client\n    const txClient = databaseTransactionContext.getSession() as PgPoolClient | undefined;\n\n    const startTime = this.config.logging ? performance.now() : 0;\n\n    let paramsString = \"\";\n    if (this.config.logging && params.length > 0) {\n      paramsString = JSON.stringify(params);\n      if (paramsString.length > 300) {\n        paramsString = paramsString.substring(0, 300) + \"...\";\n      }\n      paramsString = ` | Params: ${paramsString}`;\n    }\n\n    try {\n      let result;\n      if (this.config.logging) {\n        log.info({\n          module: \"database.postgres\",\n          action: \"query.executing\",\n          message: `${sql}${paramsString}`,\n          context: { params, sql },\n        });\n      }\n      if (txClient) {\n        result = await txClient.query(sql, params);\n      } else {\n        result = await this.pool.query(sql, params);\n      }\n\n      if (this.config.logging) {\n        const duration = (performance.now() - startTime).toFixed(2);\n        log.success({\n          module: \"database.postgres\",\n          action: \"query.executed\",\n          message: `[${duration}ms] ${sql}${paramsString}`,\n          context: { params, sql, duration },\n        });\n      }\n\n      return result as PostgresQueryResult<T>;\n    } catch (error) {\n      if (this.config.logging) {\n        const duration = (performance.now() - startTime).toFixed(2);\n        log.error({\n          module: \"database.postgres\",\n          action: \"query.error\",\n          message: `[${duration}ms] ${sql}${paramsString}`,\n          context: {\n            sql,\n            params,\n            error: error instanceof Error ? error.message : String(error),\n          },\n        });\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Emit an event to all registered listeners.\n   *\n   * @param event - Event name\n   * @param args - Event arguments\n   */\n  private emit(event: string, ...args: unknown[]): void {\n    const listeners = this._eventListeners.get(event);\n    if (listeners) {\n      for (const listener of listeners) {\n        listener(...args);\n      }\n    }\n  }\n\n  /**\n   * Build a simple WHERE clause from a filter object.\n   *\n   * Values are bound as plain equality, except Mongo-style operator objects\n   * (`{ $in: [...] }`, `{ $gt: 5 }`, ...) which are translated to their SQL\n   * equivalents — driver-level callers (e.g. pivot detach) build filters in\n   * that portable form. An unrecognized `$` operator throws instead of being\n   * bound literally, which would only surface as a cryptic type error from\n   * Postgres.\n   *\n   * @param filter - Filter conditions\n   * @param startParamIndex - Starting parameter index\n   * @returns Object with WHERE clause string and parameters\n   */\n  private buildWhereClause(\n    filter: Record<string, unknown>,\n    startParamIndex: number,\n  ): { whereClause: string; whereParams: unknown[] } {\n    const conditions: string[] = [];\n    const params: unknown[] = [];\n    let paramIndex = startParamIndex;\n\n    for (const [key, value] of Object.entries(filter)) {\n      const quotedKey = this.dialect.quoteIdentifier(key);\n\n      if (value === null) {\n        conditions.push(`${quotedKey} IS NULL`);\n      } else if (this.isOperatorFilter(value)) {\n        for (const [operator, operand] of Object.entries(value as Record<string, unknown>)) {\n          switch (operator) {\n            case \"$in\":\n            case \"$nin\": {\n              const list = operand as unknown[];\n              if (list.length === 0) {\n                // $in [] matches nothing; $nin [] matches everything.\n                conditions.push(operator === \"$in\" ? \"FALSE\" : \"TRUE\");\n                break;\n              }\n              const placeholders = list.map(() => this.dialect.placeholder(paramIndex++));\n              params.push(...list);\n              conditions.push(\n                `${quotedKey} ${operator === \"$in\" ? \"IN\" : \"NOT IN\"} (${placeholders.join(\", \")})`,\n              );\n              break;\n            }\n            case \"$eq\":\n              if (operand === null) {\n                conditions.push(`${quotedKey} IS NULL`);\n              } else {\n                conditions.push(`${quotedKey} = ${this.dialect.placeholder(paramIndex++)}`);\n                params.push(operand);\n              }\n              break;\n            case \"$ne\":\n              if (operand === null) {\n                conditions.push(`${quotedKey} IS NOT NULL`);\n              } else {\n                conditions.push(`${quotedKey} != ${this.dialect.placeholder(paramIndex++)}`);\n                params.push(operand);\n              }\n              break;\n            case \"$gt\":\n            case \"$gte\":\n            case \"$lt\":\n            case \"$lte\": {\n              const sqlOperator = { $gt: \">\", $gte: \">=\", $lt: \"<\", $lte: \"<=\" }[operator];\n              conditions.push(`${quotedKey} ${sqlOperator} ${this.dialect.placeholder(paramIndex++)}`);\n              params.push(operand);\n              break;\n            }\n            default:\n              throw new Error(\n                `Unsupported filter operator \"${operator}\" for column \"${key}\" on the Postgres driver.`,\n              );\n          }\n        }\n      } else {\n        conditions.push(`${quotedKey} = ${this.dialect.placeholder(paramIndex++)}`);\n        params.push(value);\n      }\n    }\n\n    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(\" AND \")}` : \"\";\n\n    return { whereClause, whereParams: params };\n  }\n\n  /**\n   * A filter value is an operator object when it is a plain object whose keys\n   * ALL start with `$`. Arrays, Dates, and value objects (e.g. jsonb equality\n   * payloads) keep their existing bind-as-value behavior.\n   */\n  private isOperatorFilter(value: unknown): boolean {\n    if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n      return false;\n    }\n\n    if (value instanceof Date || Buffer.isBuffer(value)) {\n      return false;\n    }\n\n    const keys = Object.keys(value);\n    return keys.length > 0 && keys.every((key) => key.startsWith(\"$\"));\n  }\n\n  /**\n   * Build an UPDATE query from update operations.\n   *\n   * @param table - Target table name\n   * @param filter - Filter conditions\n   * @param update - Update operations\n   * @param limit - Optional limit (for single row update)\n   * @returns Object with SQL and parameters\n   */\n  private buildUpdateQuery(\n    table: string,\n    filter: Record<string, unknown>,\n    update: UpdateOperations,\n    limit?: number,\n  ): { sql: string; params: unknown[] } {\n    const setClauses: string[] = [];\n    const params: unknown[] = [];\n    let paramIndex = 1;\n\n    // Handle $set\n    if (update.$set) {\n      for (const [key, value] of Object.entries(update.$set)) {\n        setClauses.push(\n          `${this.dialect.quoteIdentifier(key)} = ${this.dialect.placeholder(paramIndex++)}`,\n        );\n        // Apply the same json/jsonb-aware serialization used on the INSERT\n        // path so object/array $set values aren't corrupted into Postgres\n        // array literals. undefined is skipped — never bind it.\n        params.push(value === undefined ? value : this.serializeValue(key, value, table));\n      }\n    }\n\n    // Handle $unset (set to NULL)\n    if (update.$unset) {\n      for (const key of Object.keys(update.$unset)) {\n        setClauses.push(`${this.dialect.quoteIdentifier(key)} = NULL`);\n      }\n    }\n\n    // Handle $inc\n    if (update.$inc) {\n      for (const [key, amount] of Object.entries(update.$inc)) {\n        const quotedKey = this.dialect.quoteIdentifier(key);\n        setClauses.push(\n          `${quotedKey} = COALESCE(${quotedKey}, 0) + ${this.dialect.placeholder(paramIndex++)}`,\n        );\n        params.push(amount);\n      }\n    }\n\n    // Handle $dec\n    if (update.$dec) {\n      for (const [key, amount] of Object.entries(update.$dec)) {\n        const quotedKey = this.dialect.quoteIdentifier(key);\n        setClauses.push(\n          `${quotedKey} = COALESCE(${quotedKey}, 0) - ${this.dialect.placeholder(paramIndex++)}`,\n        );\n        params.push(amount);\n      }\n    }\n\n    if (setClauses.length === 0) {\n      throw new Error(\"No update operations specified\");\n    }\n\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const { whereClause, whereParams } = this.buildWhereClause(filter, paramIndex);\n    params.push(...whereParams);\n\n    let sql = `UPDATE ${quotedTable} SET ${setClauses.join(\", \")} ${whereClause}`;\n\n    // For single row update, use ctid subquery\n    if (limit === 1 && whereClause) {\n      sql = `UPDATE ${quotedTable} SET ${setClauses.join(\", \")} WHERE ctid IN (SELECT ctid FROM ${quotedTable} ${whereClause} LIMIT 1)`;\n    }\n\n    return { sql, params };\n  }\n\n  // ============================================================\n  // Database Lifecycle Operations\n  // ============================================================\n\n  /**\n   * Create a new database.\n   *\n   * Note: This requires connecting to a system database (like 'postgres')\n   * since you cannot create a database while connected to it.\n   *\n   * @param name - Database name to create\n   * @param options - Creation options (encoding, template, etc.)\n   * @returns true if created, false if already exists\n   */\n  public async createDatabase(name: string, options?: CreateDatabaseOptions): Promise<boolean> {\n    // Check if database already exists\n    if (await this.databaseExists(name)) {\n      return false;\n    }\n\n    // Build CREATE DATABASE statement\n    const quotedName = this.dialect.quoteIdentifier(name);\n    let sql = `CREATE DATABASE ${quotedName}`;\n\n    const withClauses: string[] = [];\n\n    if (options?.encoding) {\n      withClauses.push(`ENCODING = '${options.encoding}'`);\n    }\n    if (options?.template) {\n      withClauses.push(`TEMPLATE = ${this.dialect.quoteIdentifier(options.template)}`);\n    }\n    if (options?.locale) {\n      withClauses.push(`LC_COLLATE = '${options.locale}'`);\n      withClauses.push(`LC_CTYPE = '${options.locale}'`);\n    }\n    if (options?.owner) {\n      withClauses.push(`OWNER = ${this.dialect.quoteIdentifier(options.owner)}`);\n    }\n\n    if (withClauses.length > 0) {\n      sql += ` WITH ${withClauses.join(\" \")}`;\n    }\n\n    try {\n      await this.query(sql);\n      log.success(\"database\", \"lifecycle\", `Created database ${name}`);\n      return true;\n    } catch (error) {\n      log.error(\"database\", \"lifecycle\", `Failed to create database ${name}: ${error}`);\n      throw error;\n    }\n  }\n\n  /**\n   * Drop a database.\n   *\n   * @param name - Database name to drop\n   * @param options - Drop options\n   * @returns true if dropped, false if didn't exist\n   */\n  public async dropDatabase(name: string, options?: DropDatabaseOptions): Promise<boolean> {\n    // Check if database exists first (if ifExists option not set)\n    if (!options?.ifExists && !(await this.databaseExists(name))) {\n      return false;\n    }\n\n    const quotedName = this.dialect.quoteIdentifier(name);\n    let sql = \"DROP DATABASE\";\n\n    if (options?.ifExists) {\n      sql += \" IF EXISTS\";\n    }\n\n    sql += ` ${quotedName}`;\n\n    // PostgreSQL 13+ supports WITH (FORCE) to terminate active connections\n    if (options?.force) {\n      sql += \" WITH (FORCE)\";\n    }\n\n    try {\n      await this.query(sql);\n      log.success(\"database\", \"lifecycle\", `Dropped database ${name}`);\n      return true;\n    } catch (error) {\n      log.error(\"database\", \"lifecycle\", `Failed to drop database ${name}: ${error}`);\n      throw error;\n    }\n  }\n\n  /**\n   * Check if a database exists.\n   *\n   * @param name - Database name to check\n   * @returns true if database exists\n   */\n  public async databaseExists(name: string): Promise<boolean> {\n    const result = await this.query<{ exists: boolean }>(\n      `SELECT EXISTS(SELECT 1 FROM pg_database WHERE datname = $1) as exists`,\n      [name],\n    );\n\n    return result.rows[0]?.exists ?? false;\n  }\n\n  /**\n   * List all databases.\n   *\n   * @returns Array of database names\n   */\n  public async listDatabases(): Promise<string[]> {\n    const result = await this.query<{ datname: string }>(\n      `SELECT datname FROM pg_database WHERE datistemplate = false ORDER BY datname`,\n    );\n\n    return result.rows.map((row) => row.datname);\n  }\n\n  // ============================================================\n  // Table Management Operations\n  // ============================================================\n\n  /**\n   * Drop a table.\n   *\n   * @param name - Table name to drop\n   * @throws Error if table doesn't exist\n   */\n  public async dropTable(name: string): Promise<void> {\n    const quotedName = this.dialect.quoteIdentifier(name);\n    await this.query(`DROP TABLE ${quotedName}`);\n    log.success(\"database\", \"table\", `Dropped table ${name}`);\n  }\n\n  /**\n   * Drop a table if it exists.\n   *\n   * @param name - Table name to drop\n   */\n  public async dropTableIfExists(name: string): Promise<void> {\n    const quotedName = this.dialect.quoteIdentifier(name);\n    await this.query(`DROP TABLE IF EXISTS ${quotedName}`);\n  }\n\n  /**\n   * Drop all tables in the current database.\n   *\n   * Uses CASCADE to handle foreign key dependencies.\n   * Useful for `migrate:fresh` command.\n   */\n  public async dropAllTables(): Promise<void> {\n    // Get all tables from blueprint\n    const tables = await this.blueprint.listTables();\n\n    if (tables.length === 0) {\n      return;\n    }\n\n    // Drop all tables with CASCADE to handle foreign keys\n    for (const table of tables) {\n      const quotedName = this.dialect.quoteIdentifier(table);\n      await this.query(`DROP TABLE IF EXISTS ${quotedName} CASCADE`);\n    }\n\n    log.success(\"database\", \"table\", `Dropped ${tables.length} tables`);\n  }\n}\n"],"mappings":"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"}

package/esm/index.d.mts

@@ -62,13 +62,13 @@ import { SqlDialectContract } from "./drivers/sql/sql-dialect.contract.mjs";
 import { SqlAggregateFunction, SqlDeleteOperation, SqlGroupClause, SqlHavingClause, SqlInsertOperation, SqlJoinClause, SqlJoinType, SqlOrderClause, SqlQueryConfig, SqlQueryResult, SqlSelectClause, SqlUpdateOperation, SqlWhereOperation, SqlWhereType } from "./drivers/sql/sql-types.mjs";
 import { PostgresDialect } from "./drivers/postgres/postgres-dialect.mjs";
 import { PostgresConnectionConfig, PostgresCopyOptions, PostgresIsolationLevel, PostgresNotification, PostgresOperation, PostgresPoolConfig, PostgresQueryResult, PostgresTransactionOptions, PostgresWhereClause } from "./drivers/postgres/types.mjs";
-import { PostgresDriver } from "./drivers/postgres/postgres-driver.mjs";
+import { PostgresDriver, buildPostgresPoolConfig } from "./drivers/postgres/postgres-driver.mjs";
 import { PostgresBlueprint } from "./drivers/postgres/postgres-blueprint.mjs";
 import { PostgresMigrationDriver } from "./drivers/postgres/postgres-migration-driver.mjs";
 import { PostgresQueryBuilder } from "./drivers/postgres/postgres-query-builder.mjs";
 import { PostgresOperationType, PostgresParserOperation, PostgresParserOptions, PostgresQueryParser } from "./drivers/postgres/postgres-query-parser.mjs";
 import { PostgresSyncAdapter } from "./drivers/postgres/postgres-sync-adapter.mjs";
 import { MongoClientOptions, TransactionOptions } from "mongodb";
-export { $agg, $expr, AggregateExpression, AggregateFunction, AlterSchema, ArithmeticExpression, type BaseQueryRuleOptions, type BaseUniqueRuleOptions, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToOptions, BuildUpdateOperationsResult, type ChildModel, ChunkCallback, ColumnBuilder, ColumnDefinition, ColumnExpression, ColumnExpressionInput, ColumnExpressionType, ColumnMap, ColumnRefExpression, ColumnType, ConnectionOptions, CreateDatabaseOptions, CreateDatabaseResult, CursorPaginationOptions, CursorPaginationResult, DEFAULT_MAX_SYNC_DEPTH, DataSource, DataSourceOptions, DataSourceRegistryEvent, DataSourceRegistryListener, DatabaseDirtyTracker, DatabaseDriver, DatabaseRemover, DatabaseRestorer, DatabaseWriter, DatabaseWriterValidationError, DefineModelOptions, DeleteStrategy, DetachedColumnBuilder, DriverContract, DriverEvent, DriverEventListener, DriverQuery, DriverTransactionContract, DropAllTablesResult, DropDatabaseOptions, type EmbedKey, type ExistsRuleOptions, ExportMigrationsSQLOptions, ForeignKeyBuilder, ForeignKeyDefinition, FullTextIndexOptions, GenerateIdOptions, GeoIndexOptions, type GlobalScopeDefinition, type GlobalScopeOptions, GroupByInput, HasMany, type HasManyOptions, HasOne, type HasOneOptions, HavingInput, IdGeneratorContract, IndexDefinition, IndexEntry, InsertResult, JoinOptions, LiteralExpression, type LoadedRelationResult, type LoadedRelationsMap, type LocalScopeCallback, LockForUpdateOptions, Migration, MigrationAlterOptions, MigrationConstructor, MigrationContract, MigrationCreateOptions, MigrationDefaults, MigrationDriverContract, MigrationDriverFactory, type MigrationRecord, type MigrationResult, MigrationRunner, type MigrationRunnerOptions, type MigrationStatus, MissingDataSourceError, Model, ModelDefaultConfig, ModelDefaults, ModelEventListener, ModelEventName, ModelEvents, ModelRef, type ModelSchema, type ModelSnapshot, type ModelSyncConfig, type ModelSyncContract, ModelSyncOperation, type ModelSyncOperationContract, ModelTransformCallback, ModelType, type MongoClientOptions, MongoDbDriver, MongoDriverOptions, MongoIdGenerator, MongoMigrationDriver, MongoQueryBuilder, MongoSyncAdapter, NamingConvention, OnDeletedEventContext, Operation, OperationType, OrderDirection, PaginationOptions, PaginationResult, PendingMigration, PendingOperation, PipelineStage, type PivotData, type PivotIds, PivotOperations, PostgresBlueprint, PostgresConnectionConfig, PostgresCopyOptions, PostgresDialect, PostgresDriver, PostgresIsolationLevel, PostgresMigrationDriver, PostgresNotification, PostgresOperation, PostgresOperationType, PostgresParserOperation, PostgresParserOptions, PostgresPoolConfig, PostgresQueryBuilder, PostgresQueryParser, PostgresQueryResult, PostgresSyncAdapter, PostgresTransactionOptions, PostgresWhereClause, QueryBuilderContract, RELATION_METADATA_KEY, RawColumnExpression, RawExpression, RawQueryResult, RegisterModel, RegisterModelOptions, type RelationConstraintCallback, type RelationConstraints, RelationDefaults, type RelationDefinition, type RelationDefinitions, RelationHydrator, RelationLoader, type RelationType, RemoverContract, RemoverOptions, RemoverResult, RestorerContract, RestorerOptions, RestorerResult, RollbackMigrationsOptions, type RollbackOptions, type RunMigrationsOptions, type ScopeTiming, type SerializedRelation, SqlAggregateFunction, SqlDeleteOperation, SqlDialectContract, SqlGroupClause, SqlHavingClause, SqlInsertOperation, SqlJoinClause, SqlJoinType, SqlOrderClause, SqlQueryConfig, SqlQueryResult, SqlSelectClause, SqlUpdateOperation, SqlWhereOperation, SqlWhereType, StrictMode, SyncAdapterContract, type SyncConfig, type SyncContext, SyncContextManager, type SyncEventPayload, SyncInstruction, type SyncInstructionOptions, SyncManager, type SyncResult, type TableIndexInformation, TransactionContext, type TransactionOptions, TransactionRollbackError, UniqueEntry, type UniqueRuleOptions, UnsafeFilterError, UnsafeRawExpressionError, UpdateOperations, UpdateResult, UuidStrategy, VectorIndexOptions, WhereCallback, WhereObject, WhereOperator, WriterContract, WriterOptions, WriterResult, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, bigInt, bigInteger, binary, blobCol, boolCol as bool, boolCol, char, cleanupModelsRegistery, connectToDatabase, createDatabase, createPivotOperations, dataSourceRegistry, databaseDataSourceContext, databaseTransactionContext, date, dateTime, decimal, defineModel, double, dropAllTables, enumCol, escapeRegex, exportMigrationsSQL, float, freshMigrate, geometry, getAllModelsFromRegistry, getDatabaseDriver, getModelFromRegistry, globalModelEvents, int, integer, ipAddress, isAggregateExpression, isColumnExpression, isMongoDBDriverLoaded, json, likePatternToRegexSource, lineString, listExecutedMigrations, listPendingMigrations, longText, macAddress, mediumText, migrate, migrationRunner, modelSync, objectCol, onceConnected, onceDisconnected, point, polygon, registerModelInRegistry, removeModelFromRegistery, resolveLikePattern, resolveModelClass, resolveModelName, rollbackMigrations, runMigrations, sanitizeFilter, sanitizeFilterValue, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, toColumnExpression, transaction, tryResolveModelClass, ulid, useModelTransformer, uuid, vector, verifyRegisteredRelations, year };
+export { $agg, $expr, AggregateExpression, AggregateFunction, AlterSchema, ArithmeticExpression, type BaseQueryRuleOptions, type BaseUniqueRuleOptions, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToOptions, BuildUpdateOperationsResult, type ChildModel, ChunkCallback, ColumnBuilder, ColumnDefinition, ColumnExpression, ColumnExpressionInput, ColumnExpressionType, ColumnMap, ColumnRefExpression, ColumnType, ConnectionOptions, CreateDatabaseOptions, CreateDatabaseResult, CursorPaginationOptions, CursorPaginationResult, DEFAULT_MAX_SYNC_DEPTH, DataSource, DataSourceOptions, DataSourceRegistryEvent, DataSourceRegistryListener, DatabaseDirtyTracker, DatabaseDriver, DatabaseRemover, DatabaseRestorer, DatabaseWriter, DatabaseWriterValidationError, DefineModelOptions, DeleteStrategy, DetachedColumnBuilder, DriverContract, DriverEvent, DriverEventListener, DriverQuery, DriverTransactionContract, DropAllTablesResult, DropDatabaseOptions, type EmbedKey, type ExistsRuleOptions, ExportMigrationsSQLOptions, ForeignKeyBuilder, ForeignKeyDefinition, FullTextIndexOptions, GenerateIdOptions, GeoIndexOptions, type GlobalScopeDefinition, type GlobalScopeOptions, GroupByInput, HasMany, type HasManyOptions, HasOne, type HasOneOptions, HavingInput, IdGeneratorContract, IndexDefinition, IndexEntry, InsertResult, JoinOptions, LiteralExpression, type LoadedRelationResult, type LoadedRelationsMap, type LocalScopeCallback, LockForUpdateOptions, Migration, MigrationAlterOptions, MigrationConstructor, MigrationContract, MigrationCreateOptions, MigrationDefaults, MigrationDriverContract, MigrationDriverFactory, type MigrationRecord, type MigrationResult, MigrationRunner, type MigrationRunnerOptions, type MigrationStatus, MissingDataSourceError, Model, ModelDefaultConfig, ModelDefaults, ModelEventListener, ModelEventName, ModelEvents, ModelRef, type ModelSchema, type ModelSnapshot, type ModelSyncConfig, type ModelSyncContract, ModelSyncOperation, type ModelSyncOperationContract, ModelTransformCallback, ModelType, type MongoClientOptions, MongoDbDriver, MongoDriverOptions, MongoIdGenerator, MongoMigrationDriver, MongoQueryBuilder, MongoSyncAdapter, NamingConvention, OnDeletedEventContext, Operation, OperationType, OrderDirection, PaginationOptions, PaginationResult, PendingMigration, PendingOperation, PipelineStage, type PivotData, type PivotIds, PivotOperations, PostgresBlueprint, PostgresConnectionConfig, PostgresCopyOptions, PostgresDialect, PostgresDriver, PostgresIsolationLevel, PostgresMigrationDriver, PostgresNotification, PostgresOperation, PostgresOperationType, PostgresParserOperation, PostgresParserOptions, PostgresPoolConfig, PostgresQueryBuilder, PostgresQueryParser, PostgresQueryResult, PostgresSyncAdapter, PostgresTransactionOptions, PostgresWhereClause, QueryBuilderContract, RELATION_METADATA_KEY, RawColumnExpression, RawExpression, RawQueryResult, RegisterModel, RegisterModelOptions, type RelationConstraintCallback, type RelationConstraints, RelationDefaults, type RelationDefinition, type RelationDefinitions, RelationHydrator, RelationLoader, type RelationType, RemoverContract, RemoverOptions, RemoverResult, RestorerContract, RestorerOptions, RestorerResult, RollbackMigrationsOptions, type RollbackOptions, type RunMigrationsOptions, type ScopeTiming, type SerializedRelation, SqlAggregateFunction, SqlDeleteOperation, SqlDialectContract, SqlGroupClause, SqlHavingClause, SqlInsertOperation, SqlJoinClause, SqlJoinType, SqlOrderClause, SqlQueryConfig, SqlQueryResult, SqlSelectClause, SqlUpdateOperation, SqlWhereOperation, SqlWhereType, StrictMode, SyncAdapterContract, type SyncConfig, type SyncContext, SyncContextManager, type SyncEventPayload, SyncInstruction, type SyncInstructionOptions, SyncManager, type SyncResult, type TableIndexInformation, TransactionContext, type TransactionOptions, TransactionRollbackError, UniqueEntry, type UniqueRuleOptions, UnsafeFilterError, UnsafeRawExpressionError, UpdateOperations, UpdateResult, UuidStrategy, VectorIndexOptions, WhereCallback, WhereObject, WhereOperator, WriterContract, WriterOptions, WriterResult, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, bigInt, bigInteger, binary, blobCol, boolCol as bool, boolCol, buildPostgresPoolConfig, char, cleanupModelsRegistery, connectToDatabase, createDatabase, createPivotOperations, dataSourceRegistry, databaseDataSourceContext, databaseTransactionContext, date, dateTime, decimal, defineModel, double, dropAllTables, enumCol, escapeRegex, exportMigrationsSQL, float, freshMigrate, geometry, getAllModelsFromRegistry, getDatabaseDriver, getModelFromRegistry, globalModelEvents, int, integer, ipAddress, isAggregateExpression, isColumnExpression, isMongoDBDriverLoaded, json, likePatternToRegexSource, lineString, listExecutedMigrations, listPendingMigrations, longText, macAddress, mediumText, migrate, migrationRunner, modelSync, objectCol, onceConnected, onceDisconnected, point, polygon, registerModelInRegistry, removeModelFromRegistery, resolveLikePattern, resolveModelClass, resolveModelName, rollbackMigrations, runMigrations, sanitizeFilter, sanitizeFilterValue, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, toColumnExpression, transaction, tryResolveModelClass, ulid, useModelTransformer, uuid, vector, verifyRegisteredRelations, year };
 import "./validation/plugins/database-rules-plugin.mjs";
 import "./validation/plugins/embed-validator-plugin.mjs";

package/esm/index.mjs

@@ -39,7 +39,7 @@ import { PostgresMigrationDriver } from "./drivers/postgres/postgres-migration-d
 import { PostgresQueryParser } from "./drivers/postgres/postgres-query-parser.mjs";
 import { PostgresQueryBuilder } from "./drivers/postgres/postgres-query-builder.mjs";
 import { PostgresSyncAdapter } from "./drivers/postgres/postgres-sync-adapter.mjs";
-import { PostgresDriver } from "./drivers/postgres/postgres-driver.mjs";
+import { PostgresDriver, buildPostgresPoolConfig } from "./drivers/postgres/postgres-driver.mjs";
 import "./drivers/postgres/index.mjs";
 import { connectToDatabase, getDatabaseDriver, transaction } from "./utils/connect-to-database.mjs";
 import { useModelTransformer } from "./utils/database-writer.utils.mjs";
@@ -55,4 +55,4 @@ import { createDatabase, dropAllTables } from "./operations/database.mjs";
 import { exportMigrationsSQL, freshMigrate, listExecutedMigrations, listPendingMigrations, rollbackMigrations, runMigrations } from "./operations/migrations.mjs";
 import "./operations/index.mjs";
 
-export { $agg, $expr, BelongsTo, BelongsToMany, ColumnBuilder, DEFAULT_MAX_SYNC_DEPTH, DataSource, DatabaseDirtyTracker, DatabaseRemover, DatabaseRestorer, DatabaseWriter, DatabaseWriterValidationError, DetachedColumnBuilder, ForeignKeyBuilder, HasMany, HasOne, Migration, MigrationRunner, MissingDataSourceError, Model, ModelEvents, ModelSyncOperation, MongoDbDriver, MongoIdGenerator, MongoMigrationDriver, MongoQueryBuilder, MongoSyncAdapter, PivotOperations, PostgresBlueprint, PostgresDialect, PostgresDriver, PostgresMigrationDriver, PostgresQueryBuilder, PostgresQueryParser, PostgresSyncAdapter, RELATION_METADATA_KEY, RegisterModel, RelationHydrator, RelationLoader, SyncContextManager, SyncManager, TransactionRollbackError, UnsafeFilterError, UnsafeRawExpressionError, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, bigInt, bigInteger, binary, blobCol, boolCol as bool, boolCol, char, cleanupModelsRegistery, connectToDatabase, createDatabase, createPivotOperations, dataSourceRegistry, databaseDataSourceContext, databaseTransactionContext, date, dateTime, decimal, defineModel, double, dropAllTables, enumCol, escapeRegex, exportMigrationsSQL, float, freshMigrate, geometry, getAllModelsFromRegistry, getDatabaseDriver, getModelFromRegistry, globalModelEvents, int, integer, ipAddress, isAggregateExpression, isColumnExpression, isMongoDBDriverLoaded, json, likePatternToRegexSource, lineString, listExecutedMigrations, listPendingMigrations, longText, macAddress, mediumText, migrate, migrationRunner, modelSync, objectCol, onceConnected, onceDisconnected, point, polygon, registerModelInRegistry, removeModelFromRegistery, resolveLikePattern, resolveModelClass, resolveModelName, rollbackMigrations, runMigrations, sanitizeFilter, sanitizeFilterValue, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, toColumnExpression, transaction, tryResolveModelClass, ulid, useModelTransformer, uuid, vector, verifyRegisteredRelations, year };
+export { $agg, $expr, BelongsTo, BelongsToMany, ColumnBuilder, DEFAULT_MAX_SYNC_DEPTH, DataSource, DatabaseDirtyTracker, DatabaseRemover, DatabaseRestorer, DatabaseWriter, DatabaseWriterValidationError, DetachedColumnBuilder, ForeignKeyBuilder, HasMany, HasOne, Migration, MigrationRunner, MissingDataSourceError, Model, ModelEvents, ModelSyncOperation, MongoDbDriver, MongoIdGenerator, MongoMigrationDriver, MongoQueryBuilder, MongoSyncAdapter, PivotOperations, PostgresBlueprint, PostgresDialect, PostgresDriver, PostgresMigrationDriver, PostgresQueryBuilder, PostgresQueryParser, PostgresSyncAdapter, RELATION_METADATA_KEY, RegisterModel, RelationHydrator, RelationLoader, SyncContextManager, SyncManager, TransactionRollbackError, UnsafeFilterError, UnsafeRawExpressionError, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, bigInt, bigInteger, binary, blobCol, boolCol as bool, boolCol, buildPostgresPoolConfig, char, cleanupModelsRegistery, connectToDatabase, createDatabase, createPivotOperations, dataSourceRegistry, databaseDataSourceContext, databaseTransactionContext, date, dateTime, decimal, defineModel, double, dropAllTables, enumCol, escapeRegex, exportMigrationsSQL, float, freshMigrate, geometry, getAllModelsFromRegistry, getDatabaseDriver, getModelFromRegistry, globalModelEvents, int, integer, ipAddress, isAggregateExpression, isColumnExpression, isMongoDBDriverLoaded, json, likePatternToRegexSource, lineString, listExecutedMigrations, listPendingMigrations, longText, macAddress, mediumText, migrate, migrationRunner, modelSync, objectCol, onceConnected, onceDisconnected, point, polygon, registerModelInRegistry, removeModelFromRegistery, resolveLikePattern, resolveModelClass, resolveModelName, rollbackMigrations, runMigrations, sanitizeFilter, sanitizeFilterValue, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, toColumnExpression, transaction, tryResolveModelClass, ulid, useModelTransformer, uuid, vector, verifyRegisteredRelations, year };

package/esm/migration/migration.d.mts

@@ -163,6 +163,14 @@ interface MigrationContract {
    * Alias for bigInteger().
    */
   bigInt(column: string): ColumnBuilder;
+  /**
+   * Add a foreign-key id column whose TYPE matches the DataSource's default
+   * primary key (`migrationDefaults.primaryKey`), so a reference to a
+   * default-PK model is always type-compatible with that model's `id`. Use it
+   * for plain (non-`.references()`) FK id columns — e.g. a polymorphic
+   * `user_id` paired with a `user_type` — instead of hardcoding one type.
+   */
+  foreignId(column: string): ColumnBuilder;
   /**
    * Add a float column.
    */
@@ -1296,6 +1304,25 @@ declare abstract class Migration implements MigrationContract {
    * ```
    */
   primaryUuid(name?: string): ColumnBuilder;
+  /**
+   * Add a foreign-key id column whose TYPE matches the DataSource's default
+   * primary key (`migrationDefaults.primaryKey`), resolved EXACTLY as the auto
+   * primary key resolves it: `migrationDefaults.primaryKey` → `"int"`.
+   *
+   * This is the column to use for a plain FK id — notably a polymorphic
+   * `user_id` paired with a `user_type` — because hardcoding a single type
+   * silently breaks every app whose models use another: an integer id written
+   * into a `uuid` column throws at insert time, and the failure surfaces as an
+   * opaque 500 (finding 5e47bdb3). Deriving the column type from the same
+   * config the model's PK derives from keeps the two in lockstep for every app.
+   *
+   * `false` (no auto PK) is treated as `"int"` here: a referencing column still
+   * needs a concrete type, and integer is the framework default.
+   *
+   * @param name - Column name
+   * @returns Column builder for chaining modifiers (`.index()`, `.nullable()`, …)
+   */
+  foreignId(name: string): ColumnBuilder;
   /**
    * Add createdAt and updatedAt timestamp columns.
    *