@warlock.js/cascade 5.22.1 → 5.23.0

package/CHANGELOG.md

@@ -4,22 +4,34 @@ All notable changes to `@warlock.js/cascade` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
-## 5.22.1 - 2026-09-25
-
-### Changed
-
-- Lockstep patch release; package APIs are unchanged.
-
-## 5.22.0 - 2026-09-25
-
-### Added
-
-- PostgreSQL TTL indexes register purge jobs and persist retention rules in index comments so jobs restore after reconnect.
-
-### Fixed
-
-- Post-commit sync fan-out retries transient failures without failing committed writes.
-
+## 5.23.0 - 2026-09-25
+
+### Added
+
+- Postgres `naming: "snake_case"` (opt-in, default `"preserve"`): camelCase model keys map to snake_case columns in inserts, updates, `where`, `orderBy`, `select`, `groupBy` and joins, and rows come back camelCase. Table names and raw SQL are left as written.
+- Static `Model.whereRaw(expression, bindings?)`, matching the other static query entry points (`Model.query().whereRaw(...)` still works).
+
+### Fixed
+
+- Postgres `bigint`/`int8` columns (and int8 arrays) come back as numbers when they fit in a safe integer, so a bigint id passes `v.number()`; larger values stay strings. The parser is installed on Cascade's own pool, not on the global `pg.types`.
+- `unique()` / `exists()` on `StringValidator` and `NumberValidator` now return `this`, so `Infer<>` keeps the concrete output type (was `unknown`).
+
+## 5.22.1 - 2026-09-25
+
+### Changed
+
+- Lockstep patch release; package APIs are unchanged.
+
+## 5.22.0 - 2026-09-25
+
+### Added
+
+- PostgreSQL TTL indexes register purge jobs and persist retention rules in index comments so jobs restore after reconnect.
+
+### Fixed
+
+- Post-commit sync fan-out retries transient failures without failing committed writes.
+
 ## 5.21.0 - 2026-09-25
 
 ### Added
@@ -45,7 +57,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - Migrations: `.index()`/`.unique()`/`.vectorIndex()` inside `Migration.alter` `modify` now create the index, and `randomIncrement` takes effect.
 - Mongo: replica-set detection runs `hello` once per driver.
 
-
 ### Changed
 
 - Lockstep release maintenance and dependency refresh.

package/cjs/index.cjs

@@ -7189,6 +7189,12 @@ var Model = class Model {
 		return this.query().where(...args);
 	}
 	/**
+	* Use a raw where clause directly.
+	*/
+	static whereRaw(expression, bindings) {
+		return this.query().whereRaw(expression, bindings);
+	}
+	/**
 	* Count the number of records in the table
 	* @param filter - The filter to apply to the query
 	*/
@@ -15164,6 +15170,22 @@ var PostgresBlueprint = class {
 	}
 };
 
+//#endregion
+//#region ../cascade/src/drivers/postgres/naming.ts
+/** Convert a JavaScript camelCase key to a PostgreSQL snake_case column name. */
+function camelToSnake(value) {
+	if (value === "*" || value.includes("_")) return value;
+	return (value.match(/[A-Z]+(?=[A-Z][a-z]|\d|$)|[A-Z]?[a-z]+|\d+/g) ?? [value]).map((part) => part.toLowerCase()).join("_");
+}
+/** Convert a PostgreSQL snake_case column name to a JavaScript camelCase key. */
+function snakeToCamel(value) {
+	return value.replace(/_([a-z0-9])/g, (_match, character) => character.toUpperCase());
+}
+/** Convert top-level database row keys without rewriting nested JSON values. */
+function snakeKeysToCamel(row) {
+	return Object.fromEntries(Object.entries(row).map(([key, value]) => [snakeToCamel(key), value]));
+}
+
 //#endregion
 //#region ../cascade/src/drivers/postgres/postgres-dialect.ts
 /**
@@ -15186,6 +15208,10 @@ var PostgresBlueprint = class {
 * ```
 */
 var PostgresDialect = class {
+	naming;
+	constructor(options = {}) {
+		this.naming = options.naming ?? "preserve";
+	}
 	/**
 	* Dialect name identifier.
 	*/
@@ -15219,6 +15245,10 @@ var PostgresDialect = class {
 	* @returns The quoted identifier (e.g., '"user"')
 	*/
 	quoteIdentifier(identifier) {
+		return identifier.split(".").map((part) => `"${(this.naming === "snake_case" ? camelToSnake(part) : part).replace(/"/g, "\"\"")}"`).join(".");
+	}
+	/** Quote a table identifier without applying the column naming policy. */
+	quoteTableIdentifier(identifier) {
 		return identifier.split(".").map((part) => `"${part.replace(/"/g, "\"\"")}"`).join(".");
 	}
 	/**
@@ -16741,7 +16771,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 	buildSql() {
 		const parts = [];
 		parts.push(this.buildSelectClause());
-		const quotedTable = this.dialect.quoteIdentifier(this.table);
+		const quotedTable = this.quoteTable(this.table);
 		const fromClause = this.alias ? `FROM ${quotedTable} AS ${this.dialect.quoteIdentifier(this.alias)}` : `FROM ${quotedTable}`;
 		parts.push(fromClause);
 		if (this.joinClauses.length > 0) parts.push(this.joinClauses.join(" "));
@@ -16764,7 +16794,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 	*/
 	buildSelectClause() {
 		const distinct = this.isDistinct ? "DISTINCT " : "";
-		if (this.selectColumns.length === 0 && this.selectRaw.length === 0) return this.hasJoins ? `SELECT ${distinct}${this.dialect.quoteIdentifier(this.table)}.*` : `SELECT ${distinct}*`;
+		if (this.selectColumns.length === 0 && this.selectRaw.length === 0) return this.hasJoins ? `SELECT ${distinct}${this.quoteTable(this.table)}.*` : `SELECT ${distinct}*`;
 		const columns = [];
 		for (const col of this.selectColumns) if (!this.deselectColumns.includes(col)) columns.push(this.parseColumnIdentifier(col, this.table, this.alias));
 		columns.push(...this.selectRaw);
@@ -17057,16 +17087,16 @@ var PostgresQueryParser = class PostgresQueryParser {
 		const relationType = data.type;
 		const constraintOps = data.constraintOps;
 		const quotedAlias = this.dialect.quoteIdentifier(alias);
-		const quotedTable = this.dialect.quoteIdentifier(this.table);
+		const quotedTable = this.quoteTable(this.table);
 		if (!(this.selectColumns.length > 0) && !this.selectRaw.includes(`${quotedTable}.*`)) this.selectRaw.unshift(`${quotedTable}.*`);
 		if (relationType === "hasMany") {
 			const relatedTable = data.table;
 			const foreignKey = data.foreignKey;
 			const localKey = data.localKey;
-			const quotedRelatedTable = this.dialect.quoteIdentifier(relatedTable);
+			const quotedRelatedTable = this.quoteTable(relatedTable);
 			const quotedForeignKey = this.dialect.quoteIdentifier(foreignKey);
 			const quotedLocalKey = this.dialect.quoteIdentifier(localKey);
-			const quotedMainTable = this.dialect.quoteIdentifier(this.table);
+			const quotedMainTable = this.quoteTable(this.table);
 			let innerSelect;
 			if (select && select.length > 0) innerSelect = `json_agg(json_build_object(${select.map((col) => `'${escapeSqlLiteral(col)}', a.${this.dialect.quoteIdentifier(col)}`).join(", ")}))`;
 			else innerSelect = `json_agg(row_to_json(a.*))`;
@@ -17078,6 +17108,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 				const subParser = new PostgresQueryParser({
 					table: relatedTable,
 					alias: "a",
+					dialect: this.dialect,
 					operations: constraintOps
 				});
 				subParser.parse();
@@ -17095,6 +17126,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 				const subParser = new PostgresQueryParser({
 					table: data.table ?? alias,
 					alias,
+					dialect: this.dialect,
 					operations: constraintOps
 				});
 				subParser.parse();
@@ -17122,7 +17154,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 		const foreignField = "foreignField" in options ? options.foreignField : "";
 		const alias = "alias" in options ? options.alias : void 0;
 		const constraintOps = data.constraintOps ?? [];
-		const quotedTable = this.dialect.quoteIdentifier(joinTable);
+		const quotedTable = this.quoteTable(joinTable);
 		const tableRef = alias ? `${quotedTable} AS ${this.dialect.quoteIdentifier(alias)}` : quotedTable;
 		const tableAlias = alias ?? joinTable;
 		this.joinedTables.add(joinTable);
@@ -17134,6 +17166,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 				const subParser = new PostgresQueryParser({
 					table: joinTable,
 					alias: tableAlias,
+					dialect: this.dialect,
 					operations: whereOps
 				});
 				subParser.parse();
@@ -17175,11 +17208,11 @@ var PostgresQueryParser = class PostgresQueryParser {
 		const effectiveTable = tableAlias ?? defaultTable;
 		const parts = field.split(".");
 		let expression;
-		if (parts.length === 1) expression = `${this.dialect.quoteIdentifier(effectiveTable)}.${this.dialect.quoteIdentifier(field)}`;
+		if (parts.length === 1) expression = `${this.quoteTable(effectiveTable)}.${this.dialect.quoteIdentifier(field)}`;
 		else if (parts.length === 2) {
 			const [first, second] = parts;
 			if (first === void 0 || second === void 0) throw new Error(`Cannot parse field path "${field}": expected two non-empty segments.`);
-			if (this.isTableReference(first)) expression = `${this.dialect.quoteIdentifier(first)}.${this.dialect.quoteIdentifier(second)}`;
+			if (this.isTableReference(first)) expression = `${this.quoteTable(first)}.${this.dialect.quoteIdentifier(second)}`;
 			else expression = this.buildJsonbPath(effectiveTable, first, [second]);
 		} else {
 			const [first, second, ...rest] = parts;
@@ -17201,6 +17234,9 @@ var PostgresQueryParser = class PostgresQueryParser {
 		if (this.joinedTables.has(name)) return true;
 		return false;
 	}
+	quoteTable(table) {
+		return this.dialect instanceof PostgresDialect ? this.dialect.quoteTableIdentifier(table) : this.dialect.quoteIdentifier(table);
+	}
 	/**
 	* Build a JSONB path expression.
 	*
@@ -17221,7 +17257,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 	* // Returns: "posts"."createdBy"->'address'->>'city'
 	*/
 	buildJsonbPath(table, column, path) {
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.quoteTable(table);
 		const quotedColumn = this.dialect.quoteIdentifier(column);
 		if (path.length === 0) return `${quotedTable}.${quotedColumn}`;
 		let expression = `${quotedTable}.${quotedColumn}`;
@@ -17236,7 +17272,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 	*/
 	processCrossJoin(data) {
 		const table = data.table;
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.quoteTable(table);
 		this.joinClauses.push(`CROSS JOIN ${quotedTable}`);
 	}
 	/**
@@ -17585,7 +17621,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 	similarTo(column, embedding, alias = "score") {
 		const literal = `[${embedding.join(",")}]`;
 		const quotedCol = this.driver.dialect.quoteIdentifier(column);
-		const quotedTable = this.driver.dialect.quoteIdentifier(this.table);
+		const quotedTable = this.driver.dialect.quoteTableIdentifier(this.table);
 		this.addOperation("selectRaw", {
 			expression: `${quotedTable}.*`,
 			bindings: []
@@ -17679,7 +17715,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 	}
 	/** Full-text search across the whole row, plus optional equality filters. */
 	textSearch(query, filters) {
-		const table = this.driver.dialect.quoteIdentifier(this.table);
+		const table = this.driver.dialect.quoteTableIdentifier(this.table);
 		this.addOperation("whereRaw", {
 			expression: `to_tsvector('english', ${table}::text) @@ plainto_tsquery('english', ?)`,
 			bindings: [query]
@@ -17834,6 +17870,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 		if (this.fetchingCallback) await this.fetchingCallback(this);
 		const { query = "", bindings = [] } = new PostgresQueryParser({
 			table: this.table,
+			dialect: this.driver.dialect,
 			operations: toParserOps(this.operations)
 		}).parse();
 		try {
@@ -17923,6 +17960,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 			}]);
 			const inner = new PostgresQueryParser({
 				table: this.table,
+				dialect: this.driver.dialect,
 				operations: innerOps
 			}).parse();
 			query = `SELECT COUNT(*) AS "count" FROM (${inner.query}) AS "__count"`;
@@ -17934,6 +17972,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 			}]);
 			const parsed = new PostgresQueryParser({
 				table: this.table,
+				dialect: this.driver.dialect,
 				operations: countOps
 			}).parse();
 			query = parsed.query ?? "";
@@ -18001,6 +18040,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 		]);
 		const { query = "", bindings = [] } = new PostgresQueryParser({
 			table: this.table,
+			dialect: this.driver.dialect,
 			operations: probeOps
 		}).parse();
 		return (await this.driver.query(query, bindings)).rows.length > 0;
@@ -18024,7 +18064,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 		this.applyPendingScopes();
 		const { sql: filterSql, params: filterParams } = this.buildFilter();
 		const amountPlaceholder = `$${filterParams.length + 1}`;
-		const updateSql = `UPDATE ${this.driver.dialect.quoteIdentifier(this.table)} SET ${this.driver.dialect.quoteIdentifier(field)} = COALESCE(${this.driver.dialect.quoteIdentifier(field)}, 0) + ${amountPlaceholder} WHERE ctid IN (SELECT ctid FROM ${this.driver.dialect.quoteIdentifier(this.table)} ${filterSql} LIMIT 1 FOR UPDATE SKIP LOCKED) RETURNING ${this.driver.dialect.quoteIdentifier(field)}`;
+		const updateSql = `UPDATE ${this.driver.dialect.quoteTableIdentifier(this.table)} SET ${this.driver.dialect.quoteIdentifier(field)} = COALESCE(${this.driver.dialect.quoteIdentifier(field)}, 0) + ${amountPlaceholder} WHERE ctid IN (SELECT ctid FROM ${this.driver.dialect.quoteTableIdentifier(this.table)} ${filterSql} LIMIT 1 FOR UPDATE SKIP LOCKED) RETURNING ${this.driver.dialect.quoteIdentifier(field)}`;
 		return (await this.driver.query(updateSql, [...filterParams, amount])).rows[0]?.[field] ?? 0;
 	}
 	/** Decrement a numeric field. Returns new value. */
@@ -18036,7 +18076,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 		this.applyPendingScopes();
 		const { sql: filterSql, params: filterParams } = this.buildFilter();
 		const amountPlaceholder = `$${filterParams.length + 1}`;
-		const updateSql = `UPDATE ${this.driver.dialect.quoteIdentifier(this.table)} SET ${this.driver.dialect.quoteIdentifier(field)} = COALESCE(${this.driver.dialect.quoteIdentifier(field)}, 0) + ${amountPlaceholder}` + (filterSql ? ` WHERE ${filterSql.replace("WHERE ", "")}` : "");
+		const updateSql = `UPDATE ${this.driver.dialect.quoteTableIdentifier(this.table)} SET ${this.driver.dialect.quoteIdentifier(field)} = COALESCE(${this.driver.dialect.quoteIdentifier(field)}, 0) + ${amountPlaceholder}` + (filterSql ? ` WHERE ${filterSql.replace("WHERE ", "")}` : "");
 		return (await this.driver.query(updateSql, [...filterParams, amount])).rowCount ?? 0;
 	}
 	/** Decrement a field for all matching rows. Returns affected row count. */
@@ -18133,7 +18173,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 	async delete() {
 		this.applyPendingScopes();
 		const { sql, params } = this.buildFilter();
-		const deleteSql = `DELETE FROM ${this.driver.dialect.quoteIdentifier(this.table)} ${sql}`;
+		const deleteSql = `DELETE FROM ${this.driver.dialect.quoteTableIdentifier(this.table)} ${sql}`;
 		return (await this.driver.query(deleteSql, params)).rowCount ?? 0;
 	}
 	/**
@@ -18145,7 +18185,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 	async deleteOne() {
 		this.applyPendingScopes();
 		const { sql: filterSql, params } = this.buildFilter();
-		const quotedTable = this.driver.dialect.quoteIdentifier(this.table);
+		const quotedTable = this.driver.dialect.quoteTableIdentifier(this.table);
 		const deleteSql = `DELETE FROM ${quotedTable} WHERE ctid IN (SELECT ctid FROM ${quotedTable} ${filterSql} LIMIT 1 FOR UPDATE SKIP LOCKED)`;
 		return (await this.driver.query(deleteSql, params)).rowCount ?? 0;
 	}
@@ -18165,7 +18205,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 			setParams.push(value);
 		}
 		if (setClauses.length === 0) throw new Error("No update operations specified");
-		const updateSql = `UPDATE ${this.driver.dialect.quoteIdentifier(this.table)} SET ${setClauses.join(", ")}` + (filterSql ? ` ${filterSql}` : "");
+		const updateSql = `UPDATE ${this.driver.dialect.quoteTableIdentifier(this.table)} SET ${setClauses.join(", ")}` + (filterSql ? ` ${filterSql}` : "");
 		return (await this.driver.query(updateSql, [...filterParams, ...setParams])).rowCount ?? 0;
 	}
 	/**
@@ -18177,7 +18217,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 		if (fields.length === 0) throw new Error("No update operations specified");
 		const { sql: filterSql, params: filterParams } = this.buildFilter();
 		const setClauses = fields.map((field) => `${this.driver.dialect.quoteIdentifier(field)} = NULL`);
-		const updateSql = `UPDATE ${this.driver.dialect.quoteIdentifier(this.table)} SET ${setClauses.join(", ")}` + (filterSql ? ` ${filterSql}` : "");
+		const updateSql = `UPDATE ${this.driver.dialect.quoteTableIdentifier(this.table)} SET ${setClauses.join(", ")}` + (filterSql ? ` ${filterSql}` : "");
 		return (await this.driver.query(updateSql, filterParams)).rowCount ?? 0;
 	}
 	/**
@@ -18197,6 +18237,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 		this.applyGroupByAggregates();
 		return new PostgresQueryParser({
 			table: this.table,
+			dialect: this.driver.dialect,
 			operations: toParserOps(this.operations)
 		}).parse();
 	}
@@ -18348,8 +18389,8 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 	*/
 	buildHasSubquery(opType, relationName, definition, RelatedModel, constraintOps, operator, count) {
 		const dialect = this.driver.dialect;
-		const quotedSelfTable = dialect.quoteIdentifier(this.table);
-		const quotedRelatedTable = dialect.quoteIdentifier(RelatedModel.table);
+		const quotedSelfTable = dialect.quoteTableIdentifier(this.table);
+		const quotedRelatedTable = dialect.quoteTableIdentifier(RelatedModel.table);
 		const relationType = definition.type;
 		const selfModel = this.modelClass;
 		const conventions = this.dataSource?.relationDefaults;
@@ -18368,7 +18409,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 			joinCondition = `${quotedRelatedTable}.${dialect.quoteIdentifier(ownerKey)} = ${quotedSelfTable}.${dialect.quoteIdentifier(foreignKey)}`;
 		} else if (relationType === "belongsToMany") {
 			const pivotTableName = definition.pivot ?? inferPivotTable(selfModel?.name ?? "Model", RelatedModel.name, conventions);
-			const quotedPivot = dialect.quoteIdentifier(pivotTableName);
+			const quotedPivot = dialect.quoteTableIdentifier(pivotTableName);
 			const pivotLocalCol = definition.localKey ?? inferPivotKey(selfModel?.name ?? "Model", conventions);
 			const pivotForeignCol = definition.foreignKey ?? inferPivotKey(RelatedModel.name, conventions);
 			const selfPk = definition.pivotLocalKey ?? selfModel?.primaryKey ?? "id";
@@ -18426,7 +18467,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 	*/
 	ensureMainColumnsForCount() {
 		if (this.operations.some((op) => op.type === "select" || op.type === "selectRaw" || op.type === "selectRelatedColumns")) return;
-		const quotedTable = this.driver.dialect.quoteIdentifier(this.table);
+		const quotedTable = this.driver.dialect.quoteTableIdentifier(this.table);
 		this.addOperation("selectRaw", {
 			expression: `${quotedTable}.*`,
 			bindings: []
@@ -18441,8 +18482,8 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 	buildCountSubquery(alias, relationName, definition, RelatedModel, constraintOps) {
 		const dialect = this.driver.dialect;
 		const quotedAlias = dialect.quoteIdentifier(alias);
-		const quotedSelfTable = dialect.quoteIdentifier(this.table);
-		const quotedRelatedTable = dialect.quoteIdentifier(RelatedModel.table);
+		const quotedSelfTable = dialect.quoteTableIdentifier(this.table);
+		const quotedRelatedTable = dialect.quoteTableIdentifier(RelatedModel.table);
 		const relationType = definition.type;
 		const selfModel = this.modelClass;
 		const relatedMeta = RelatedModel;
@@ -18469,7 +18510,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 		}
 		if (relationType === "belongsToMany") {
 			const pivotTableName = definition.pivot ?? inferPivotTable(selfModel?.name ?? "Model", relatedMeta.name, conventions);
-			const quotedPivot = dialect.quoteIdentifier(pivotTableName);
+			const quotedPivot = dialect.quoteTableIdentifier(pivotTableName);
 			const pivotLocalCol = definition.localKey ?? inferPivotKey(selfModel?.name ?? "Model", conventions);
 			const pivotForeignCol = definition.foreignKey ?? inferPivotKey(relatedMeta.name, conventions);
 			const selfPk = definition.pivotLocalKey ?? selfModel?.primaryKey ?? "id";
@@ -18508,6 +18549,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 		};
 		const { query = "", bindings = [] } = new PostgresQueryParser({
 			table: relatedTable,
+			dialect: this.driver.dialect,
 			operations: toParserOps(whereOps)
 		}).parse();
 		const match = query.match(/WHERE\s+(.+)$/);
@@ -18650,6 +18692,7 @@ var PostgresQueryBuilder = class PostgresQueryBuilder extends QueryBuilder {
 		};
 		const { query = "", bindings = [] } = new PostgresQueryParser({
 			table: this.table,
+			dialect: this.driver.dialect,
 			operations: toParserOps(whereOps)
 		}).parse();
 		const whereMatch = query.match(/WHERE .+$/);
@@ -18997,6 +19040,34 @@ function assertPostgresUpdate(update, options) {
 *
 * @module cascade/drivers/postgres
 */
+const POSTGRES_INT8_OID = 20;
+const POSTGRES_INT8_ARRAY_OID = 1016;
+/**
+* Convert a PostgreSQL int8 result to a number only when it can be represented
+* exactly. PostgreSQL sends int8 values as strings by default to avoid silently
+* losing precision above JavaScript's safe-integer limit.
+*/
+function parsePostgresInt8(value) {
+	if (value === null) return null;
+	const numberValue = Number(value);
+	return Number.isSafeInteger(numberValue) ? numberValue : value;
+}
+/**
+* Build pool-local type overrides without changing pg's process-wide registry.
+*/
+function createPostgresTypes(types) {
+	return { getTypeParser(oid, format) {
+		if (oid === POSTGRES_INT8_OID) return parsePostgresInt8;
+		if (oid === POSTGRES_INT8_ARRAY_OID) {
+			const parseArray = types.getTypeParser(oid, format);
+			return (value) => {
+				const array = parseArray(value);
+				return Array.isArray(array) ? array.map(parsePostgresInt8) : array;
+			};
+		}
+		return types.getTypeParser(oid, format);
+	} };
+}
 /**
 * Build pg's `PoolConfig` from cascade's `PostgresPoolConfig`, coercing the
 * string-typed connection fields.
@@ -19097,7 +19168,7 @@ var PostgresDriver = class {
 	/**
 	* SQL dialect for PostgreSQL-specific syntax.
 	*/
-	dialect = new PostgresDialect();
+	dialect;
 	/**
 	* PostgreSQL driver model defaults.
 	*
@@ -19168,6 +19239,7 @@ var PostgresDriver = class {
 	*/
 	constructor(config) {
 		this.config = config;
+		this.dialect = new PostgresDialect({ naming: config.naming });
 		this._nativeArrayColumns = new Set(config.nativeArrayColumns ?? []);
 	}
 	/**
@@ -19209,6 +19281,7 @@ var PostgresDriver = class {
 		const pg = await loadPg();
 		try {
 			const poolConfig = buildPostgresPoolConfig(this.config);
+			poolConfig.types = createPostgresTypes(pg.types);
 			_warlock_js_logger.log.info("database.postgres", "connection", `Connecting to database ${_mongez_copper.colors.bold(_mongez_copper.colors.yellowBright(poolConfig.database ?? ""))}`);
 			this._pool = new pg.Pool(poolConfig);
 			this._pool.on("error", (error) => {
@@ -19390,12 +19463,11 @@ var PostgresDriver = class {
 	*/
 	deserialize(data) {
 		const columnTypes = this.rowColumnTypes.get(data);
-		if (!columnTypes) return data;
-		for (const [key, value] of Object.entries(data)) {
+		if (columnTypes) for (const [key, value] of Object.entries(data)) {
 			if (typeof value !== "string") continue;
 			data[key] = convertPostgresValue(value, columnTypes.get(key));
 		}
-		return data;
+		return this.config.naming === "snake_case" ? snakeKeysToCamel(data) : data;
 	}
 	/**
 	* Insert a single row into a table.
@@ -19418,7 +19490,7 @@ var PostgresDriver = class {
 		if (columns.length === 0) throw new Error("Cannot insert empty document");
 		const quotedColumns = columns.map((c) => this.dialect.quoteIdentifier(c)).join(", ");
 		const placeholders = columns.map((_, i) => this.dialect.placeholder(i + 1)).join(", ");
-		const sql = `INSERT INTO ${this.dialect.quoteIdentifier(table)} (${quotedColumns}) VALUES (${placeholders}) RETURNING *`;
+		const sql = `INSERT INTO ${this.dialect.quoteTableIdentifier(table)} (${quotedColumns}) VALUES (${placeholders}) RETURNING *`;
 		return { document: (await this.query(sql, values)).rows[0] };
 	}
 	/**
@@ -19440,7 +19512,7 @@ var PostgresDriver = class {
 		}
 		const columns = Array.from(allColumns);
 		const quotedColumns = columns.map((c) => this.dialect.quoteIdentifier(c)).join(", ");
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.dialect.quoteTableIdentifier(table);
 		const valueSets = [];
 		const params = [];
 		let paramIndex = 1;
@@ -19512,7 +19584,7 @@ var PostgresDriver = class {
 			const { sql, params } = this.buildUpdateQuery(table, filter, operations, 1);
 			return (await this.query(`${sql} RETURNING *`, params)).rows[0] ?? null;
 		}
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.dialect.quoteTableIdentifier(table);
 		const keyList = (qualifier) => primaryKey.map((column) => (qualifier ? `${qualifier}.` : "") + this.dialect.quoteIdentifier(column)).join(", ");
 		const set = this.buildSetClauses(table, operations, 1, returnBefore ? quotedTable : void 0);
 		if (set.clauses.length === 0) throw new Error("No update operations specified");
@@ -19558,7 +19630,7 @@ var PostgresDriver = class {
 		for (const key of Object.keys(operations.$unset ?? {})) delete insertRow[key];
 		const columns = Object.keys(insertRow).filter((key) => insertRow[key] !== void 0);
 		const params = columns.map((key) => this.serializeValue(key, insertRow[key], table));
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.dialect.quoteTableIdentifier(table);
 		const quotedColumns = columns.map((column) => this.dialect.quoteIdentifier(column)).join(", ");
 		const placeholders = columns.map((_, index) => this.dialect.placeholder(index + 1)).join(", ");
 		const set = this.buildSetClauses(table, operations, columns.length + 1, quotedTable);
@@ -19626,7 +19698,7 @@ var PostgresDriver = class {
 		const serialized = this.serialize(document, table);
 		const columns = Object.keys(serialized);
 		const values = Object.values(serialized);
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.dialect.quoteTableIdentifier(table);
 		const setClauses = columns.map((col, i) => `${this.dialect.quoteIdentifier(col)} = ${this.dialect.placeholder(i + 1)}`).join(", ");
 		const { whereClause, whereParams } = this.buildWhereClause(filter, columns.length + 1);
 		const sql = `UPDATE ${quotedTable} SET ${setClauses} ${whereClause} RETURNING *`;
@@ -19649,7 +19721,7 @@ var PostgresDriver = class {
 		const columns = Object.keys(serialized);
 		const values = Object.values(serialized);
 		if (columns.length === 0) throw new Error("Cannot upsert empty document");
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.dialect.quoteTableIdentifier(table);
 		const quotedColumns = columns.map((c) => this.dialect.quoteIdentifier(c)).join(", ");
 		const placeholders = columns.map((_, i) => this.dialect.placeholder(i + 1)).join(", ");
 		const conflictColumns = options?.conflictColumns ?? Object.keys(filter);
@@ -19672,7 +19744,7 @@ var PostgresDriver = class {
 	* @returns The deleted row or null
 	*/
 	async findOneAndDelete(table, filter, _options) {
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.dialect.quoteTableIdentifier(table);
 		const { whereClause, whereParams } = this.buildWhereClause(filter, 1);
 		const sql = `${this.singleRowTarget("DELETE FROM " + quotedTable, quotedTable, filter, whereClause)} RETURNING *`;
 		const result = await this.query(sql, whereParams);
@@ -19687,7 +19759,7 @@ var PostgresDriver = class {
 	* @returns Number of deleted rows (0 or 1)
 	*/
 	async delete(table, filter, _options) {
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.dialect.quoteTableIdentifier(table);
 		const { whereClause, whereParams } = this.buildWhereClause(filter ?? {}, 1);
 		const sql = this.singleRowTarget("DELETE FROM " + quotedTable, quotedTable, filter ?? {}, whereClause);
 		return (await this.query(sql, whereParams)).rowCount ?? 0;
@@ -19701,7 +19773,7 @@ var PostgresDriver = class {
 	* @returns Number of deleted rows
 	*/
 	async deleteMany(table, filter, _options) {
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.dialect.quoteTableIdentifier(table);
 		const { whereClause, whereParams } = this.buildWhereClause(filter ?? {}, 1);
 		const sql = `DELETE FROM ${quotedTable} ${whereClause}`;
 		return (await this.query(sql, whereParams)).rowCount ?? 0;
@@ -19717,7 +19789,7 @@ var PostgresDriver = class {
 	* @returns Number of deleted rows (always 0 for TRUNCATE)
 	*/
 	async truncateTable(table, options) {
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.dialect.quoteTableIdentifier(table);
 		const cascadeClause = options?.cascade ? " CASCADE" : "";
 		await this.query(`TRUNCATE TABLE ${quotedTable} RESTART IDENTITY${cascadeClause}`);
 		return 0;
@@ -20174,7 +20246,7 @@ var PostgresDriver = class {
 		const set = this.buildSetClauses(table, assertPostgresUpdate(update), 1);
 		if (set.clauses.length === 0) throw new Error("No update operations specified");
 		const params = [...set.params];
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.dialect.quoteTableIdentifier(table);
 		const { whereClause, whereParams } = this.buildWhereClause(filter, set.nextIndex);
 		params.push(...whereParams);
 		const head = `UPDATE ${quotedTable} SET ${set.clauses.join(", ")}`;
@@ -20380,6 +20452,7 @@ async function connectToDatabase(options) {
 				user: options.username,
 				password: options.password,
 				logging: options.logging,
+				...pickPostgresDriverOptions(options.driverOptions),
 				...options.clientOptions
 			});
 			break;
@@ -20427,6 +20500,11 @@ function getDatabaseDriver() {
 async function transaction(fn, options) {
 	return getDatabaseDriver().transaction(fn, options);
 }
+/** The Cascade-side Postgres driver options `driverOptions` may carry. */
+function pickPostgresDriverOptions(driverOptions) {
+	const naming = driverOptions?.naming;
+	return naming === void 0 ? {} : { naming };
+}
 
 //#endregion
 //#region ../cascade/src/utils/database-writer.utils.ts
@@ -25301,6 +25379,7 @@ exports.modelSync = modelSync;
 exports.objectCol = objectCol;
 exports.onceConnected = onceConnected;
 exports.onceDisconnected = onceDisconnected;
+exports.parsePostgresInt8 = parsePostgresInt8;
 exports.point = point;
 exports.polygon = polygon;
 exports.registerModelInRegistry = registerModelInRegistry;