joist-core 2.4.0-next.2 → 2.4.0-next.4

package/build/queries/sql/execute.js

@@ -4,8 +4,8 @@ import { asNode, isExpr } from "./Expr.js";
 import { fail } from "../../utils.js";
 import { AliasAssigner } from "./AliasAssigner.js";
 import "./custom.js";
-import { getTableMgmt, isCustomTable, isEntityTable, isTable, tableSqlName } from "./Tables.js";
-import { Ctx, conditionToSql, injectedConditions, isReadQueryValue, parseNestedQuery, parseUserQuery, projectionToSql, pruneCtes, registerCtes, withFragment } from "./query.js";
+import { getTableMgmt, isCustomTable, isEntityTable, tableSqlName } from "./Tables.js";
+import { Ctx, checkPojoKeys, conditionToSql, injectedConditions, isReadQueryValue, parseNestedQuery, parseUserQuery, projectionToSql, pruneCtes, registerCtes, withFragment } from "./query.js";
 import { isEntity } from "../../Entity.js";
 //#region src/queries/sql/execute.ts
 /** Classifies mutation roots before EntityManager applies write permissions, including malformed roots. */
@@ -31,7 +31,7 @@ function parseStatement(arg) {
 	].filter((key) => key in statement);
 	if (roots.length !== 1) fail("A mutation requires exactly one insert, update, or delete root");
 	const operation = roots[0];
-	checkPojo(statement, operation === "insert" ? [
+	const allowed = operation === "insert" ? [
 		"insert",
 		"values",
 		"from",
@@ -45,28 +45,26 @@ function parseStatement(arg) {
 		"returning",
 		"with",
 		...operation === "update" ? ["set"] : []
-	], `SQL ${operation}`);
-	const target = statement[operation];
-	if (!isTable(target)) fail("A mutation target must be a table");
-	const mgmt = getTableMgmt(target);
-	const meta = isEntityTable(target) ? getTableMgmt(target).meta : void 0;
-	const custom = isCustomTable(target) ? getTableMgmt(target) : void 0;
+	];
+	checkPojoKeys(statement, allowed, `SQL ${operation}`);
+	const target = mutationTarget(statement[operation]);
+	const { meta } = target;
 	if (meta) {
 		if (meta.inheritanceType || meta.baseType || meta.baseTypes.length || meta.subTypes.length) fail("SQL mutations do not support CTI/STI targets or inherited table families");
 		if (meta.supportsEmExecute !== true) fail(`SQL mutations require supported physical metadata for ${meta.type}; run codegen`);
-		for (const field of Object.values(meta.columns)) requireColumnMetadata(meta, field);
+		for (const column of Object.values(meta.columns)) requireColumnMetadata(target, column);
 	} else if (statement.softDeletes !== void 0) fail("Custom table mutations do not support softDeletes");
-	const fields = Object.entries(meta?.columns ?? custom.columns);
+	const fields = Object.entries(target.columns);
 	const assigner = new AliasAssigner();
 	const withCtx = new Ctx(assigner, void 0);
 	const ctes = registerCtes(statement, withCtx, assigner);
 	const refs = [];
 	const ctx = new Ctx(assigner, withCtx);
-	const alias = assigner.getAlias(mgmt.tableName);
-	ctx.register(mgmt, alias);
+	const alias = assigner.getAlias(target.mgmt.tableName);
+	ctx.register(target.mgmt, alias);
 	const returning = statement.returning === void 0 ? void 0 : projectionToSql(statement.returning, ctx);
 	if (returning) for (const select of returning.selects) refs.push(...select.refs);
-	let sql = `${operation === "delete" ? "DELETE FROM" : operation.toUpperCase() + (operation === "insert" ? " INTO" : "")} ${tableSqlName(mgmt)} AS ${kq(alias)}`;
+	let sql = `${operation === "delete" ? "DELETE FROM" : operation.toUpperCase() + (operation === "insert" ? " INTO" : "")} ${tableSqlName(target.mgmt)} AS ${kq(alias)}`;
 	const bindings = [];
 	if (operation === "insert") {
 		if ("values" in statement === "from" in statement) fail("INSERT requires exactly one of values or from");
@@ -75,8 +73,8 @@ function parseStatement(arg) {
 			if (!Array.isArray(statement.values)) fail("INSERT values must be an array of field POJOs");
 			const rows = statement.values;
 			const valuesCtx = new Ctx(assigner, withCtx);
-			const entries = rows.map((row) => meta ? assignments(meta, row, "insert") : customAssignments(custom, row, "insert"));
-			for (const row of entries) for (const [key] of required) if (!row.some((entry) => entry[0] === key)) fail(`INSERT requires ${meta?.type ?? custom.tableName}.${key}`);
+			const entries = rows.map((row) => assignments(target, row, "insert"));
+			for (const row of entries) for (const [key] of required) if (!row.some((entry) => entry[0] === key)) fail(`INSERT requires ${target.name}.${key}`);
 			if (rows.length === 0) return void 0;
 			const keys = fields.filter(([key]) => entries.some((row) => row.some((entry) => entry[0] === key))).map(([key, field]) => [key, field.columnName]);
 			sql += ` (${keys.map(([, column]) => kq(column)).join(", ")}) VALUES `;
@@ -84,7 +82,7 @@ function parseStatement(arg) {
 				return `(${keys.map(([key]) => {
 					const entry = row.find((entry) => entry[0] === key);
 					if (!entry) return "DEFAULT";
-					const cell = meta ? assignmentToSql(meta, writableField(meta, key, "insert"), entry[1], valuesCtx) : customAssignmentToSql(custom, customWritableField(custom, key, "insert"), entry[1], valuesCtx);
+					const cell = assignmentToSql(target, writableField(target, key, "insert"), entry[1], valuesCtx);
 					bindings.push(...cell.bindings);
 					refs.push(...cell.refs);
 					return cell.sql;
@@ -94,13 +92,13 @@ function parseStatement(arg) {
 			const source = parseNestedQuery(statement.from, withCtx, assigner);
 			if (source.output.kind !== "pojo") fail("INSERT SELECT requires named POJO output columns");
 			const columns = source.output.columns;
-			for (const [key] of required) if (!columns.some((column) => column[0] === key)) fail(`INSERT requires ${meta?.type ?? custom.tableName}.${key}`);
+			for (const [key] of required) if (!columns.some((column) => column[0] === key)) fail(`INSERT requires ${target.name}.${key}`);
 			for (const [key, expr] of columns) {
-				const field = meta ? writableField(meta, key, "insert") : customWritableField(custom, key, "insert");
+				const field = writableField(target, key, "insert");
 				const left = field.outputType;
 				const right = expr.outputType;
-				if (!left || !right || left.dbType !== right.dbType || left.domain !== right.domain || left.idMeta !== right.idMeta) fail(`INSERT SELECT ${meta?.type ?? custom.tableName}.${key} has incompatible or unknown storage codecs`);
-				if (!field.sqlNullable && expr.sqlNullable === true) fail(`INSERT SELECT ${meta?.type ?? custom.tableName}.${key} cannot accept a nullable output`);
+				if (!left || !right || left.dbType !== right.dbType || left.domain !== right.domain || left.idMeta !== right.idMeta) fail(`INSERT SELECT ${target.name}.${key} has incompatible or unknown storage codecs`);
+				if (!field.sqlNullable && expr.sqlNullable === true) fail(`INSERT SELECT ${target.name}.${key} cannot accept a nullable output`);
 			}
 			const keys = fields.filter(([key]) => columns.some((column) => column[0] === key)).map(([key, field]) => [key, field.columnName]);
 			const sourceAlias = safeKq(assigner.getLiteralAlias("sq"));
@@ -114,11 +112,11 @@ function parseStatement(arg) {
 		const whereCondition = mutationCondition(statement.where, ctx);
 		if (Object.hasOwn(statement, "where") && !whereCondition && statement.allowAll !== true) fail("UPDATE and DELETE require allowAll: true when a supplied where is undefined or fully pruned");
 		if (operation === "update") {
-			const entries = meta ? assignments(meta, statement.set, "update") : customAssignments(custom, statement.set, "update");
+			const entries = assignments(target, statement.set, "update");
 			sql += " SET " + entries.map((entry) => {
 				const [key, value] = entry;
-				const field = meta ? writableField(meta, key, "update") : customWritableField(custom, key, "update");
-				const cell = meta ? assignmentToSql(meta, field, value, ctx) : customAssignmentToSql(custom, field, value, ctx);
+				const field = writableField(target, key, "update");
+				const cell = assignmentToSql(target, field, value, ctx);
 				bindings.push(...cell.bindings);
 				refs.push(...cell.refs);
 				return `${kq(field.columnName)} = ${cell.sql}`;
@@ -165,55 +163,66 @@ function decodeStatementResult(em, plan, result) {
 		rows: plan.decodeRows(em, result.rows)
 	};
 }
+/** Reads the writable columns from either kind of table handle, so the compiler has one target shape. */
+function mutationTarget(target) {
+	if (isEntityTable(target)) {
+		const mgmt = getTableMgmt(target);
+		return {
+			mgmt,
+			name: mgmt.meta.type,
+			columns: mgmt.meta.columns,
+			meta: mgmt.meta
+		};
+	}
+	if (isCustomTable(target)) {
+		const mgmt = getTableMgmt(target);
+		return {
+			mgmt,
+			name: mgmt.tableName,
+			columns: mgmt.columns,
+			meta: void 0
+		};
+	}
+	return fail("A mutation target must be a table");
+}
 /** SQL mutations require complete physical metadata. */
-function requireColumnMetadata(meta, column) {
-	if (typeof column.sqlNullable !== "boolean" || typeof column.hasDefault !== "boolean" || typeof column.isGenerated !== "boolean") fail(`Missing physical metadata for ${meta.type}.${column.columnName}; run codegen`);
+function requireColumnMetadata(target, column) {
+	if (typeof column.sqlNullable !== "boolean" || typeof column.hasDefault !== "boolean" || typeof column.isGenerated !== "boolean") fail(`Missing physical metadata for ${target.name}.${column.columnName}; run codegen`);
 }
 /** Validates every supplied key, including undefined fields, before pruning omitted values. */
-function assignments(meta, value, operation) {
+function assignments(target, value, operation) {
 	if (!value || typeof value !== "object" || Array.isArray(value) || isExpr(value) || isEntity(value)) fail(`${operation} assignments must be a field POJO`);
 	const entries = Object.entries(value);
-	for (const [key] of entries) writableField(meta, key, operation);
-	checkPojo(value, Object.keys(meta.columns), `${operation} assignments`);
+	for (const [key] of entries) writableField(target, key, operation);
+	checkPojoKeys(value, Object.keys(target.columns), `${operation} assignments`);
 	const defined = entries.filter((entry) => entry[1] !== void 0);
 	if (!defined.length) fail(`${operation} requires at least one defined field; empty rows/sets are not DEFAULT VALUES`);
 	return defined;
 }
-/** Validates assignment keys against a custom table's declared writable columns. */
-function customAssignments(table, value, operation) {
-	if (!value || typeof value !== "object" || Array.isArray(value) || isExpr(value) || isEntity(value)) fail(`${operation} assignments must be a field POJO`);
-	const entries = Object.entries(value);
-	for (const [key] of entries) customWritableField(table, key, operation);
-	checkPojo(value, Object.keys(table.columns), `${operation} assignments`);
-	const defined = entries.filter((entry) => entry[1] !== void 0);
-	if (!defined.length) fail(`${operation} requires at least one defined field; empty rows/sets are not DEFAULT VALUES`);
-	return defined;
-}
-/** Applies physical write restrictions declared by `declareTable`. */
-function customWritableField(table, key, operation) {
-	const column = Object.hasOwn(table.columns, key) ? table.columns[key] : void 0;
-	if (!column) fail(`Unsupported SQL mutation field ${table.tableName}.${key}`);
-	if (operation === "update" ? !column.update : column.insert === "never") fail(`Unsupported SQL mutation field ${table.tableName}.${key}`);
-	return column;
-}
-/** Applies physical write restrictions, not ORM-derived, protected, or business-immutable flags. */
-function writableField(meta, key, operation) {
-	const column = Object.hasOwn(meta.columns, key) ? meta.columns[key] : void 0;
-	if (!column) fail(`Unsupported SQL mutation field ${meta.type}.${key}`);
-	requireColumnMetadata(meta, column);
-	if (operation === "update" && key === "id") fail("UPDATE primary-key assignments are not supported");
-	if (column.isGenerated) fail(`Generated field ${meta.type}.${key} is omit-only`);
-	if (operation === "update" ? !column.update : column.insert === "never") fail(`Unsupported SQL mutation field ${meta.type}.${key}`);
+/**
+* Applies physical write restrictions, not ORM-derived, protected, or business-immutable flags.
+*
+* The primary-key and generated checks only sharpen the message: `Column` already denies both through
+* `insert: "never"` and `update: false`, for declared custom columns as well as generated ones.
+*/
+function writableField(target, key, operation) {
+	const column = Object.hasOwn(target.columns, key) ? target.columns[key] : void 0;
+	if (!column) fail(`Unsupported SQL mutation field ${target.name}.${key}`);
+	if (operation === "update" && column.columnName === "id") fail("UPDATE primary-key assignments are not supported");
+	if (column.isGenerated) fail(`Generated field ${target.name}.${key} is omit-only`);
+	if (operation === "update" ? !column.update : column.insert === "never") fail(`Unsupported SQL mutation field ${target.name}.${key}`);
 	return column;
 }
 /**
 * Classifies SQL expressions and SQL NULL before invoking the column's entity-independent write codec.
 * Normalizes public PK/FK ids to internal tagged ids using the target entity's idType.
+*
+* A custom table's columns never carry `idMetadata`, so they take the literal path below unchanged.
 */
-function assignmentToSql(meta, column, value, ctx) {
+function assignmentToSql(target, column, value, ctx) {
 	if (isExpr(value)) return asNode(value).toSql(ctx);
 	if (value === null) {
-		if (!column.sqlNullable) fail(`${meta.type}.${column.columnName} is physically NOT NULL`);
+		if (!column.sqlNullable) fail(`${target.name}.${column.columnName} is physically NOT NULL`);
 		return {
 			sql: "NULL",
 			bindings: [],
@@ -229,24 +238,7 @@ function assignmentToSql(meta, column, value, ctx) {
 		} else if (typeof value !== (other.idType === "number" ? "number" : "string")) fail(`Expected a persisted ${other.type} or its ID; nested creation is not supported`);
 		else value = other.idType === "untagged-string" ? keyToTaggedId(other, value) : toTaggedId(other, value);
 	}
-	if (!column.codec.mapToDbValue) fail(`The codec for ${meta.type}.${column.columnName} does not support SQL value writes`);
-	return {
-		sql: "?",
-		bindings: [column.mapToDbValue(value)],
-		refs: []
-	};
-}
-/** Encodes a custom-table literal through its declared primitive codec. */
-function customAssignmentToSql(table, column, value, ctx) {
-	if (isExpr(value)) return asNode(value).toSql(ctx);
-	if (value === null) {
-		if (!column.sqlNullable) fail(`${table.tableName}.${column.columnName} is physically NOT NULL`);
-		return {
-			sql: "NULL",
-			bindings: [],
-			refs: []
-		};
-	}
+	if (!column.codec.mapToDbValue) fail(`The codec for ${target.name}.${column.columnName} does not support SQL value writes`);
 	return {
 		sql: "?",
 		bindings: [column.mapToDbValue(value)],
@@ -259,14 +251,6 @@ function mutationCondition(value, ctx) {
 	if (Array.isArray(value)) return conditionToSql({ and: value }, ctx, true);
 	return conditionToSql(value, ctx, true);
 }
-/** Only own enumerable POJO clauses count as input or explicit full-table consent. */
-function checkPojo(value, allowed, description) {
-	if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) fail(`${description} must be a plain POJO`);
-	for (const key of Reflect.ownKeys(value)) {
-		if (!allowed.includes(key)) fail(`${description} does not support '${String(key)}'`);
-		if (typeof key === "string" && !Object.prototype.propertyIsEnumerable.call(value, key)) fail(`${description} requires enumerable fields`);
-	}
-}
 //#endregion
 export { decodeStatementResult, isMutation, parseStatement };
 

package/build/queries/sql/execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute.js","names":[],"sources":["../../../src/queries/sql/execute.ts"],"sourcesContent":["import type { DriverQueryResult } from \"src/drivers/Driver.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\nimport type { IdOf } from \"src/EntityManager.ts\";\nimport type { EntityMetadata } from \"src/EntityMetadata.ts\";\nimport { keyToTaggedId, toTaggedId } from \"src/keys.ts\";\nimport type { SqlCondition } from \"src/queries/conditions.ts\";\nimport { AliasAssigner } from \"src/queries/sql/AliasAssigner.ts\";\nimport {\n  type CustomColumnInputs,\n  type CustomColumnValue,\n  type CustomColumnsOf,\n  type CustomTableFor,\n  type CustomTableMgmt,\n} from \"src/queries/sql/custom.ts\";\nimport { type ExprBrand, type ExprLike, type SqlFragment, asNode, exprBrand, isExpr } from \"src/queries/sql/Expr.ts\";\nimport { kq, safeKq } from \"src/queries/sql/keywords.ts\";\nimport {\n  type CheckReadQuery,\n  type CheckScope,\n  type CheckSetQuery,\n  Ctx,\n  type EntityHydrator,\n  type NameOf,\n  type Plan,\n  type Query,\n  type QueryJoinInput,\n  type QueryRow,\n  type ReadQueryRow,\n  type SetOperand,\n  type SetOperation,\n  type SetQuery,\n  type Subquery,\n  type WithInput,\n  conditionToSql,\n  entityQueryBrand,\n  injectedConditions,\n  isReadQueryValue,\n  parseNestedQuery,\n  parseUserQuery,\n  projectionToSql,\n  pruneCtes,\n  registerCtes,\n  subqueryBrand,\n  withFragment,\n} from \"src/queries/sql/query.ts\";\nimport {\n  type TableFor,\n  getTableMgmt,\n  isCustomTable,\n  isEntityTable,\n  isTable,\n  tableMgmt,\n  tableSqlName,\n} from \"src/queries/sql/Tables.ts\";\nimport type { Column } from \"src/serde/columns.ts\";\nimport type { ColumnsOf, TypeMapEntry } from \"src/typeMap.ts\";\nimport { fail } from \"src/utils.ts\";\n\n/** The native command count and decoded rows from one immediate SQL statement. */\nexport interface ExecuteResult<R> {\n  rowCount: number;\n  rows: R[];\n}\n\n/** A mutation's RETURNING projection: one SQL expression or a named object of expressions. */\nexport type MutationReturning = (ExprLike<unknown> | Readonly<Record<string, ExprLike<unknown>>>) & {\n  readonly [tableMgmt]?: never;\n  readonly [subqueryBrand]?: never;\n  readonly [entityQueryBrand]?: never;\n};\n\n/** SQL INSERT inputs, based on physical storage rather than entity creation options. */\nexport type InsertValues<T extends Entity> = {\n  [K in RequiredInsertKey<T>]: Assignment<T, K>;\n} & {\n  [K in Exclude<InsertKey<T>, RequiredInsertKey<T>>]?: Assignment<T, K> | undefined;\n};\n\n/** SQL UPDATE inputs include persisted derived columns, but never primary keys. */\nexport type UpdateValues<T extends Entity> = {\n  [K in UpdateKey<T>]?: Assignment<T, K> | undefined;\n};\n\n/** A reusable INSERT POJO; use a concrete Q for annotated INSERT SELECT source checking. */\nexport type InsertStatement<\n  T extends Entity,\n  R extends MutationReturning | undefined = MutationReturning | undefined,\n  Q extends SetOperand = Query<InsertProjection<T>, []> | Subquery<InsertSourceRow<T>, string>,\n> = {\n  readonly insert: MutationTarget<T>;\n  readonly returning?: R;\n  readonly update?: never;\n  readonly delete?: never;\n  readonly set?: never;\n  readonly where?: never;\n  readonly allowAll?: never;\n  readonly softDeletes?: never;\n  /** CTEs to add to a `WITH` before the INSERT; see `Clauses.with`. */\n  readonly with?: WithInput;\n} & NoMutationReadClauses &\n  (\n    | { readonly values: readonly InsertValues<T>[]; readonly from?: never }\n    | { readonly from: Q & CheckInsertSource<T, Q>; readonly values?: never }\n  );\n\n/** A reusable guarded UPDATE POJO. Undefined assignments leave existing columns unchanged. */\nexport type UpdateStatement<\n  T extends Entity,\n  R extends MutationReturning | undefined = MutationReturning | undefined,\n> = {\n  readonly update: MutationTarget<T>;\n  readonly set: UpdateValues<T>;\n  readonly returning?: R;\n  readonly insert?: never;\n  readonly delete?: never;\n  readonly values?: never;\n  readonly from?: never;\n  /** CTEs to add to a `WITH` before the UPDATE; see `Clauses.with`. */\n  readonly with?: WithInput;\n} & MutationFilter &\n  NoMutationReadClauses;\n\n/** A reusable guarded physical DELETE POJO, not an ORM soft delete. */\nexport type DeleteStatement<\n  T extends Entity,\n  R extends MutationReturning | undefined = MutationReturning | undefined,\n> = {\n  readonly delete: MutationTarget<T>;\n  readonly returning?: R;\n  readonly insert?: never;\n  readonly update?: never;\n  readonly values?: never;\n  readonly from?: never;\n  readonly set?: never;\n  /** CTEs to add to a `WITH` before the DELETE; see `Clauses.with`. */\n  readonly with?: WithInput;\n} & MutationFilter &\n  NoMutationReadClauses;\n\n/** Public statement annotations retain the target's physical field policy. */\nexport type MutationStatement<\n  T extends Entity,\n  R extends MutationReturning | undefined = MutationReturning | undefined,\n> = InsertStatement<T, R> | UpdateStatement<T, R> | DeleteStatement<T, R>;\n\n/** Inference starts with the literal POJO; CheckMutation checks its target and every supplied key. */\nexport type MutationInput = (\n  | { readonly insert: TableFor<Entity>; readonly values: readonly object[]; readonly from?: never }\n  | { readonly insert: TableFor<Entity>; readonly from: SetOperand; readonly values?: never }\n  | { readonly update: TableFor<Entity>; readonly set: object }\n  | { readonly delete: TableFor<Entity> }\n  | {\n      readonly insert: CustomTableFor;\n      readonly values: readonly object[];\n      readonly from?: never;\n    }\n  | { readonly insert: CustomTableFor; readonly from: SetOperand; readonly values?: never }\n  | { readonly update: CustomTableFor; readonly set: object }\n  | { readonly delete: CustomTableFor }\n) & { readonly returning?: MutationReturning; readonly with?: WithInput } & MutationFilter;\n\n/** Without RETURNING the row type is never; scalar expressions produce scalar rows. */\nexport type MutationRow<M> = M extends { readonly returning?: infer R }\n  ? R extends MutationReturning\n    ? R extends ExprLike<unknown>\n      ? QueryRow<R>\n      : { -readonly [K in keyof QueryRow<R>]: QueryRow<R>[K] }\n    : never\n  : never;\n\n/** Checks nonliteral statements as well as fresh literals without widening their inferred result. */\nexport type CheckMutation<M> = M extends unknown\n  ? [CustomColumnsOf<TargetTable<M>>] extends [never]\n    ? TargetEntity<M> extends infer T extends Entity\n      ? TypeMapEntry<T, \"supportsEmExecute\"> extends true\n        ? { readonly [K in keyof M]: K extends MutationClause<M> ? unknown : never } & {\n            readonly returning?: M extends { readonly returning?: infer R }\n              ? CheckReturning<R, NameOf<TargetTable<M>>>\n              : never;\n          } & (\n              | (M extends { readonly values: infer V extends readonly unknown[] }\n                  ? { readonly values: CheckValues<T, V> }\n                  : never)\n              | (M extends { readonly from: infer Q extends SetOperand }\n                  ? { readonly from: CheckInsertSource<T, Q> }\n                  : never)\n              | (M extends { readonly set: infer V }\n                  ? { readonly set: CheckAssignments<V, UpdateValues<T>, NameOf<TargetTable<M>>> }\n                  : never)\n              | (M extends { readonly delete: unknown } ? unknown : never)\n            )\n        : \"SQL mutations require a supported non-inherited target and regenerated metadata\"\n      : never\n    : CheckCustomMutation<M>\n  : never;\n\n/** Classifies mutation roots before EntityManager applies write permissions, including malformed roots. */\nexport function isMutation(arg: unknown): boolean {\n  return (\n    typeof arg === \"object\" &&\n    arg !== null &&\n    !isReadQueryValue(arg) &&\n    [\"insert\", \"update\", \"delete\"].some((key) => key in arg)\n  );\n}\n\n/**\n * Compiles one immediate statement using the read compiler's scopes, projections, and codecs.\n * INSERT SELECT keeps source rows in PostgreSQL; only RETURNING rows pass through JS decoders.\n * An undefined plan represents a validated standalone empty VALUES array, not DEFAULT VALUES.\n */\nexport function parseStatement(arg: unknown): Plan | undefined {\n  if (!isMutation(arg)) return parseUserQuery(arg);\n  const statement = arg as Record<string, unknown>;\n  const roots = [\"insert\", \"update\", \"delete\"].filter((key) => key in statement);\n  if (roots.length !== 1) fail(\"A mutation requires exactly one insert, update, or delete root\");\n  const operation = roots[0];\n  const allowed =\n    operation === \"insert\"\n      ? [\"insert\", \"values\", \"from\", \"returning\", \"with\"]\n      : [\n          operation,\n          \"where\",\n          \"allowAll\",\n          \"softDeletes\",\n          \"returning\",\n          \"with\",\n          ...(operation === \"update\" ? [\"set\"] : []),\n        ];\n  checkPojo(statement, allowed, `SQL ${operation}`);\n  const target = statement[operation];\n  if (!isTable(target)) fail(\"A mutation target must be a table\");\n  const mgmt = getTableMgmt(target);\n  const meta = isEntityTable(target) ? getTableMgmt(target).meta : undefined;\n  const custom = isCustomTable(target) ? getTableMgmt(target) : undefined;\n  if (meta) {\n    if (meta.inheritanceType || meta.baseType || meta.baseTypes.length || meta.subTypes.length) {\n      fail(\"SQL mutations do not support CTI/STI targets or inherited table families\");\n    }\n    if (meta.supportsEmExecute !== true)\n      fail(`SQL mutations require supported physical metadata for ${meta.type}; run codegen`);\n    for (const field of Object.values(meta.columns)) requireColumnMetadata(meta, field);\n  } else if (statement.softDeletes !== undefined) {\n    fail(\"Custom table mutations do not support softDeletes\");\n  }\n  const fields = Object.entries(meta?.columns ?? custom!.columns);\n  const assigner = new AliasAssigner();\n  // A CTE is in scope for the whole statement, so its scope is the parent of every other one here. It\n  // deliberately holds no target alias, which is what lets INSERT VALUES cells and the INSERT SELECT\n  // source read the CTEs without also seeing the row being written.\n  const withCtx = new Ctx(assigner, undefined);\n  const ctes = registerCtes(statement, withCtx, assigner);\n  // Aliases the rest of the statement reads, so an unread CTE prunes like it does on a read query.\n  const refs: string[] = [];\n  const ctx = new Ctx(assigner, withCtx);\n  const alias = assigner.getAlias(mgmt.tableName);\n  ctx.register(mgmt, alias);\n  const returning = statement.returning === undefined ? undefined : projectionToSql(statement.returning, ctx);\n  if (returning) for (const select of returning.selects) refs.push(...select.refs);\n  let sql = `${operation === \"delete\" ? \"DELETE FROM\" : operation.toUpperCase() + (operation === \"insert\" ? \" INTO\" : \"\")} ${tableSqlName(mgmt)} AS ${kq(alias)}`;\n  const bindings: unknown[] = [];\n  if (operation === \"insert\") {\n    if (\"values\" in statement === \"from\" in statement) fail(\"INSERT requires exactly one of values or from\");\n    const required = fields.filter(([, column]) => column.insert === \"required\");\n    if (\"values\" in statement) {\n      if (!Array.isArray(statement.values)) fail(\"INSERT values must be an array of field POJOs\");\n      const rows = statement.values;\n      // A VALUES cell *is* the new row, so there is no existing row for it to read: this scope skips\n      // the `ctx.register(mgmt, alias)` above, so a cell naming the target fails instead of emitting a\n      // `b` with no FROM clause. I.e. an UPDATE can say `set: { title: b.title }`; an INSERT cannot.\n      // A value subquery still works, because it brings its own sources, and the parent here is the CTE\n      // scope rather than `ctx`, so a cell can read a `with` entry but not the row being written.\n      const valuesCtx = new Ctx(assigner, withCtx);\n      const entries = rows.map((row) =>\n        meta ? assignments(meta, row, \"insert\") : customAssignments(custom!, row, \"insert\"),\n      );\n      for (const row of entries) {\n        for (const [key] of required) {\n          if (!row.some((entry) => entry[0] === key)) fail(`INSERT requires ${meta?.type ?? custom!.tableName}.${key}`);\n        }\n      }\n      if (rows.length === 0) return undefined;\n      const keys = fields\n        .filter(([key]) => entries.some((row) => row.some((entry) => entry[0] === key)))\n        .map(([key, field]) => [key, field.columnName] as const);\n      sql += ` (${keys.map(([, column]) => kq(column)).join(\", \")}) VALUES `;\n      sql += entries\n        .map((row) => {\n          const cells = keys.map(([key]) => {\n            const entry = row.find((entry) => entry[0] === key);\n            if (!entry) return \"DEFAULT\";\n            const cell = meta\n              ? assignmentToSql(meta, writableField(meta, key, \"insert\"), entry[1], valuesCtx)\n              : customAssignmentToSql(custom!, customWritableField(custom!, key, \"insert\"), entry[1], valuesCtx);\n            bindings.push(...cell.bindings);\n            refs.push(...cell.refs);\n            return cell.sql;\n          });\n          return `(${cells.join(\", \")})`;\n        })\n        .join(\", \");\n    } else {\n      const source = parseNestedQuery(statement.from, withCtx, assigner);\n      if (source.output.kind !== \"pojo\") fail(\"INSERT SELECT requires named POJO output columns\");\n      const columns = source.output.columns;\n      for (const [key] of required) {\n        if (!columns.some((column) => column[0] === key)) {\n          fail(`INSERT requires ${meta?.type ?? custom!.tableName}.${key}`);\n        }\n      }\n      for (const [key, expr] of columns) {\n        const field = meta ? writableField(meta, key, \"insert\") : customWritableField(custom!, key, \"insert\");\n        const left = field.outputType;\n        const right = expr.outputType;\n        if (\n          !left ||\n          !right ||\n          left.dbType !== right.dbType ||\n          left.domain !== right.domain ||\n          left.idMeta !== right.idMeta\n        ) {\n          fail(`INSERT SELECT ${meta?.type ?? custom!.tableName}.${key} has incompatible or unknown storage codecs`);\n        }\n        if (!field.sqlNullable && expr.sqlNullable === true)\n          fail(`INSERT SELECT ${meta?.type ?? custom!.tableName}.${key} cannot accept a nullable output`);\n      }\n      const keys = fields\n        .filter(([key]) => columns.some((column) => column[0] === key))\n        .map(([key, field]) => [key, field.columnName] as const);\n      const sourceAlias = safeKq(assigner.getLiteralAlias(\"sq\"));\n      sql += ` (${keys.map(([, column]) => kq(column)).join(\", \")}) SELECT ${keys.map(([key]) => `${sourceAlias}.${safeKq(key)}`).join(\", \")} FROM (${source.sql}) AS ${sourceAlias}`;\n      bindings.push(...source.bindings);\n      refs.push(...source.outerRefs);\n    }\n  } else {\n    if (statement.allowAll !== undefined && typeof statement.allowAll !== \"boolean\") fail(\"allowAll must be a boolean\");\n    if (\n      statement.softDeletes !== undefined &&\n      statement.softDeletes !== \"include\" &&\n      statement.softDeletes !== \"exclude\"\n    )\n      fail(\"softDeletes must be 'include' or 'exclude'\");\n    const whereCondition = mutationCondition(statement.where, ctx);\n    if (Object.hasOwn(statement, \"where\") && !whereCondition && statement.allowAll !== true)\n      fail(\"UPDATE and DELETE require allowAll: true when a supplied where is undefined or fully pruned\");\n    if (operation === \"update\") {\n      const entries = meta\n        ? assignments(meta, statement.set, \"update\")\n        : customAssignments(custom!, statement.set, \"update\");\n      sql +=\n        \" SET \" +\n        entries\n          .map((entry) => {\n            const [key, value] = entry;\n            const field = meta ? writableField(meta, key, \"update\") : customWritableField(custom!, key, \"update\");\n            const cell = meta\n              ? assignmentToSql(meta, field, value, ctx)\n              : customAssignmentToSql(custom!, field, value, ctx);\n            bindings.push(...cell.bindings);\n            refs.push(...cell.refs);\n            return `${kq(field.columnName)} = ${cell.sql}`;\n          })\n          .join(\", \");\n    }\n    const injected = meta\n      ? conditionToSql({ and: injectedConditions({ meta, alias }, statement.softDeletes ?? \"exclude\") }, ctx, true)\n      : undefined;\n    const conditions = [whereCondition, injected].filter((condition) => condition !== undefined);\n    if (conditions.length) {\n      sql += ` WHERE ${conditions.map((condition) => `(${condition.sql})`).join(\" AND \")}`;\n      for (const condition of conditions) {\n        bindings.push(...condition.bindings);\n        refs.push(...condition.refs);\n      }\n    }\n  }\n  if (returning) {\n    sql += ` RETURNING ${returning.selects.map((select) => select.sql).join(\", \")}`;\n    for (const select of returning.selects) bindings.push(...select.bindings);\n  }\n  const keptCtes = pruneCtes(ctes, new Set(refs));\n  if (keptCtes.length > 0) {\n    const clause = withFragment(keptCtes);\n    sql = clause.sql + sql;\n    bindings.unshift(...clause.bindings);\n  }\n  return {\n    sql,\n    bindings,\n    outerRefs: [],\n    output: returning?.output ?? { kind: \"pojo\", columns: [] },\n    decodeRows: returning?.decodeRows ?? (() => []),\n  };\n}\n\n/** Retains native counts even when no rows return, and propagates decoding failures after execution. */\nexport function decodeStatementResult(\n  em: EntityHydrator,\n  plan: Plan,\n  result: DriverQueryResult,\n): ExecuteResult<unknown> {\n  if (typeof result.rowCount !== \"number\" || !Number.isInteger(result.rowCount) || result.rowCount < 0)\n    fail(\"The driver did not return a numeric command rowCount\");\n  return { rowCount: result.rowCount, rows: plan.decodeRows(em, result.rows) };\n}\n\n/** An entity table whose generated metadata permits direct SQL mutations. */\ntype MutationTarget<T extends Entity> = TableFor<T> &\n  (TypeMapEntry<T, \"supportsEmExecute\"> extends true ? unknown : never);\n\n/** Shared filtering and full-table consent clauses for UPDATE and DELETE. */\ntype MutationFilter = {\n  /**\n   * An `{ and: [...] }` or `{ or: [...] }` group, a boolean expression, or a bare condition such as `a.age.gte(18)`.\n   *\n   * Arrays are shorthand for `{ and: [...] }`; undefined conditions are pruned.\n   */\n  readonly where?: SqlCondition | ExprLike<boolean> | readonly (SqlCondition | undefined)[];\n  /** Allows a supplied where to be undefined or fully pruned; unnecessary when where is omitted. */\n  readonly allowAll?: boolean;\n  readonly softDeletes?: \"include\" | \"exclude\";\n};\n\n/** Read-only query clauses that mutations explicitly reject. */\ntype NoMutationReadClauses = Partial<\n  Record<\n    | \"select\"\n    | \"join\"\n    | \"groupBy\"\n    | \"having\"\n    | \"orderBy\"\n    | \"limit\"\n    | \"offset\"\n    | \"distinct\"\n    | \"pruneJoins\"\n    | \"as\"\n    | \"union\"\n    | \"unionAll\"\n    | \"intersect\"\n    | \"intersectAll\"\n    | \"except\"\n    | \"exceptAll\"\n    | \"ctes\"\n    | \"using\"\n    | \"onConflict\",\n    never\n  >\n>;\n\n/** Column keys allowed in INSERT, i.e. Book's optional `id` and required `authorId`. */\ntype InsertKey<T> = {\n  [K in keyof ColumnsOf<T>]: ColumnsOf<T>[K] extends { insert: \"required\" | \"optional\" } ? K : never;\n}[keyof ColumnsOf<T>];\n\n/** Column keys that each INSERT row must supply, i.e. Book's `authorId` despite its ORM default. */\ntype RequiredInsertKey<T> = {\n  [K in keyof ColumnsOf<T>]: ColumnsOf<T>[K] extends { insert: \"required\" } ? K : never;\n}[keyof ColumnsOf<T>];\n\n/** Column keys allowed in UPDATE SET, i.e. Book's `title` and `authorId`, but not `id`. */\ntype UpdateKey<T> = {\n  [K in keyof ColumnsOf<T>]: ColumnsOf<T>[K] extends { update: true } ? K : never;\n}[keyof ColumnsOf<T>];\n\n/** A column's domain value before SQL nullability is added, i.e. Book's `id` is BookId and `authorId` is AuthorId. */\ntype DomainValue<T, K extends keyof ColumnsOf<T>> = K extends \"id\"\n  ? IdOf<T>\n  : ColumnsOf<T>[K] extends { entity: infer U }\n    ? IdOf<U>\n    : ColumnsOf<T>[K] extends { type: infer V }\n      ? V\n      : never;\n\n/** A modeled column's domain value with SQL nullability applied. */\ntype SqlValue<T, K extends keyof ColumnsOf<T>> =\n  | DomainValue<T, K>\n  | (ColumnsOf<T>[K] extends { nullable: true } ? null : never);\n\n/** A modeled-column value, entity reference, or SQL expression that produces one. */\ntype Assignment<T, K extends keyof ColumnsOf<T>> =\n  | SqlValue<T, K>\n  | ExprLike<SqlValue<T, K>>\n  | (K extends \"id\" ? never : ColumnsOf<T>[K] extends { entity: infer U } ? U : never);\n\n/** A custom column's declared value with SQL nullability applied. */\ntype CustomSqlValue<I> = CustomColumnValue<I> | (I extends { nullable: true } ? null : never);\n\n/** A custom-column value or SQL expression that produces one. */\ntype CustomAssignment<I> = CustomSqlValue<I> | ExprLike<CustomSqlValue<I>>;\n\n/** Custom-column keys accepted by INSERT, excluding generated columns. */\ntype CustomInsertKey<C extends CustomColumnInputs> = {\n  [K in keyof C]: C[K] extends { generated: true } ? never : K;\n}[keyof C];\n\n/** Custom-column keys each INSERT row must supply because they have no default and are not nullable. */\ntype CustomRequiredInsertKey<C extends CustomColumnInputs> = {\n  [K in CustomInsertKey<C>]: C[K] extends { nullable: true } | { hasDefault: true } ? never : K;\n}[CustomInsertKey<C>];\n\n/** Custom-column keys accepted by UPDATE, excluding generated columns and the physical primary key. */\ntype CustomUpdateKey<C extends CustomColumnInputs> = {\n  [K in keyof C]: C[K] extends { generated: true }\n    ? never\n    : K extends \"id\"\n      ? never\n      : C[K] extends { columnName: \"id\" }\n        ? never\n        : K;\n}[keyof C];\n\n/** Values accepted by INSERT for a custom table's declared columns. */\ntype CustomInsertValues<C extends CustomColumnInputs> = {\n  [K in CustomRequiredInsertKey<C>]: CustomAssignment<C[K]>;\n} & {\n  [K in Exclude<CustomInsertKey<C>, CustomRequiredInsertKey<C>>]?: CustomAssignment<C[K]> | undefined;\n};\n\n/** Assignments accepted by UPDATE for a custom table's writable columns. */\ntype CustomUpdateValues<C extends CustomColumnInputs> = {\n  [K in CustomUpdateKey<C>]?: CustomAssignment<C[K]> | undefined;\n};\n\n/** Named row shape that an INSERT SELECT source must produce for a custom table. */\ntype CustomInsertSourceRow<C extends CustomColumnInputs> = {\n  [K in CustomRequiredInsertKey<C>]: CustomSqlValue<C[K]>;\n} & {\n  [K in Exclude<CustomInsertKey<C>, CustomRequiredInsertKey<C>>]?: CustomSqlValue<C[K]>;\n};\n\n/** Named row shape that an entity INSERT SELECT source must produce. */\ntype InsertSourceRow<T> = { [K in RequiredInsertKey<T>]: SqlValue<T, K> } & {\n  [K in Exclude<InsertKey<T>, RequiredInsertKey<T>>]?: SqlValue<T, K>;\n};\n\n/** Named expression projection accepted from an entity INSERT SELECT source. */\ntype InsertProjection<T> = { [K in RequiredInsertKey<T>]: ExprLike<SqlValue<T, K>> } & {\n  [K in Exclude<InsertKey<T>, RequiredInsertKey<T>>]?: ExprLike<SqlValue<T, K>>;\n};\n\n/** Collects the keys from every member of a union instead of only their shared keys. */\ntype UnionKeys<V> = V extends unknown ? keyof V : never;\n\n/** Collects every alternative before scope checking; a valid branch cannot hide an unrelated alias. */\ntype UnionValue<V, K extends PropertyKey> = V extends unknown ? (K extends keyof V ? V[K] : never) : never;\n\n/** Extracts the source names carried by a SQL expression. */\ntype ExprSource<V> = V extends { readonly [exprBrand]: ExprBrand<unknown, infer Src> } ? Src : never;\n\n/** Rejects expressions that reference tables outside the statement's allowed scope. */\ntype CheckExprScope<V, Scope> =\n  string extends ExprSource<V>\n    ? unknown\n    : [Exclude<ExprSource<V>, Scope>] extends [never]\n      ? unknown\n      : \"Expression source is not in the statement scope\";\n\n/** Extracts each expression from a scalar or named RETURNING projection. */\ntype ReturningExpr<R> = R extends ExprLike<unknown> ? R : R extends undefined ? never : R[keyof R];\n\n/** Detects an empty named RETURNING projection. */\ntype EmptyReturning<R> = R extends object ? (keyof R extends never ? true : false) : false;\n\n/** Rejects empty RETURNING objects and expressions outside the target scope. */\ntype CheckReturning<R, Scope> = true extends EmptyReturning<R> ? never : CheckExprScope<ReturningExpr<R>, Scope>;\n\n/** Validates assignment keys, values, and expression sources without distributing union inputs. */\ntype CheckAssignments<V, Allowed, Scope> = [Exclude<UnionKeys<V>, keyof Allowed>] extends [never]\n  ? Allowed & {\n      [K in UnionKeys<V>]?: CheckExprScope<UnionValue<V, K>, Scope>;\n    }\n  : \"SQL assignments have unknown target fields\";\n\n/** Checks every entity INSERT row in a readonly collection against writable columns. */\ntype CheckValues<T extends Entity, V extends readonly unknown[]> = readonly CheckAssignments<\n  V[number],\n  InsertValues<T>,\n  never\n>[];\n\n/**\n * Checks a custom-table mutation against its declared primitive columns.\n *\n * Only clauses for the selected operation are allowed, and `softDeletes` is rejected because there is no entity\n * policy. Assignments use declaration keys and honor nullability, defaults, and generated columns. INSERT VALUES\n * cannot read the target row, while UPDATE SET and RETURNING can. INSERT SELECT must be a valid named read with all\n * required columns and compatible declared value types; runtime checks also compare its SQL codecs and nullability.\n */\ntype CheckCustomMutation<M> = {\n  // Reject clauses outside the selected operation, plus softDeletes because custom tables have no entity policy.\n  readonly [K in keyof M]: K extends MutationClause<M> ? (K extends \"softDeletes\" ? never : unknown) : never;\n} & {\n  readonly returning?: M extends { readonly returning?: infer R } ? CheckReturning<R, NameOf<TargetTable<M>>> : never;\n} &\n  // INSERT VALUES checks every row against the custom table's writable columns.\n  (\n    | (M extends { readonly values: infer V extends readonly unknown[] }\n        ? { readonly values: CheckCustomValues<CustomColumnsOf<TargetTable<M>>, V> }\n        : never)\n    // INSERT SELECT checks the source's names, values, and expression scopes.\n    | (M extends { readonly from: infer Q extends SetOperand }\n        ? { readonly from: CheckCustomInsertSource<CustomColumnsOf<TargetTable<M>>, Q> }\n        : never)\n    // UPDATE checks assignments against writable columns and permits target-scoped expressions.\n    | (M extends { readonly set: infer V }\n        ? {\n            readonly set: CheckAssignments<\n              V,\n              CustomUpdateValues<CustomColumnsOf<TargetTable<M>>>,\n              NameOf<TargetTable<M>>\n            >;\n          }\n        : never)\n    // DELETE has no assignments or source that needs further type checking.\n    | (M extends { readonly delete: unknown } ? unknown : never)\n  );\n\n/** Checks every custom INSERT row in a readonly collection against declared writable columns. */\ntype CheckCustomValues<C extends CustomColumnInputs, V extends readonly unknown[]> = readonly CheckAssignments<\n  V[number],\n  CustomInsertValues<C>,\n  never\n>[];\n\n/** Checks a custom INSERT SELECT's named outputs, required columns, values, and read source. */\ntype CheckCustomInsertSource<C extends CustomColumnInputs, Q> = SetOperand extends Q\n  ? \"INSERT source type lost its select keys; use `satisfies Query` or `satisfies SetQuery` instead of a type annotation\"\n  : ReadQueryRow<Q> extends CustomInsertSourceRow<C>\n    ? Exclude<UnionKeys<ReadQueryRow<Q>>, CustomInsertKey<C>> extends never\n      ? CheckReadQuery<Q> &\n          CheckSourceScope<Q> &\n          (Q extends SetQuery<readonly SetOperand[]> ? CheckSetQuery<Q> : unknown)\n      : \"INSERT SELECT has unknown target fields\"\n    : \"INSERT SELECT requires compatible values for all SQL-required fields\";\n\n/** Checks every SELECT expression against the tables visible within its read-query branch. */\ntype CheckSourceScope<Q> = Q extends { readonly select: infer S; readonly from: infer F }\n  ? CheckScope<S, F, \"join\" extends keyof Q ? Extract<Q[keyof Q & \"join\"], QueryJoinInput> : []>\n  : {\n      [K in keyof Q]: K extends SetOperation\n        ? Q[K] extends readonly unknown[]\n          ? { [I in keyof Q[K]]: CheckSourceScope<Q[K][I]> }\n          : unknown\n        : unknown;\n    };\n\n/** Checks an entity INSERT SELECT's named outputs, required columns, values, and read source. */\ntype CheckInsertSource<T, Q extends SetOperand> = SetOperand extends Q\n  ? \"INSERT source type lost its select keys; use `satisfies Query` or `satisfies SetQuery` instead of a type annotation\"\n  : ReadQueryRow<Q> extends InsertSourceRow<T>\n    ? Exclude<UnionKeys<ReadQueryRow<Q>>, InsertKey<T>> extends never\n      ? CheckReadQuery<Q> &\n          CheckSourceScope<Q> &\n          (Q extends SetQuery<readonly SetOperand[]> ? CheckSetQuery<Q> : unknown)\n      : \"INSERT SELECT has unknown target fields\"\n    : \"INSERT SELECT requires compatible values for all SQL-required fields\";\n\n/** Extracts the entity type from any mutation target clause. */\ntype TargetEntity<M> = M extends\n  | { readonly insert: TableFor<infer T> }\n  | { readonly update: TableFor<infer T> }\n  | { readonly delete: TableFor<infer T> }\n  ? T\n  : never;\n\n/** Extracts the table handle from any mutation target clause. */\ntype TargetTable<M> = M extends\n  | { readonly insert: infer A }\n  | { readonly update: infer A }\n  | { readonly delete: infer A }\n  ? A\n  : never;\n\n/** Clauses permitted by the selected INSERT, UPDATE, or DELETE operation. */\ntype MutationClause<M> =\n  | \"returning\"\n  | \"with\"\n  | (M extends { readonly insert: unknown }\n      ? \"insert\" | (M extends { readonly values: unknown } ? \"values\" : \"from\")\n      : \"where\" | \"allowAll\" | \"softDeletes\" | (M extends { readonly update: unknown } ? \"update\" | \"set\" : \"delete\"));\n\n/** SQL mutations require complete physical metadata. */\nfunction requireColumnMetadata(meta: EntityMetadata, column: Column): void {\n  if (\n    typeof column.sqlNullable !== \"boolean\" ||\n    typeof column.hasDefault !== \"boolean\" ||\n    typeof column.isGenerated !== \"boolean\"\n  )\n    fail(`Missing physical metadata for ${meta.type}.${column.columnName}; run codegen`);\n}\n\n/** Validates every supplied key, including undefined fields, before pruning omitted values. */\nfunction assignments(meta: EntityMetadata, value: unknown, operation: \"insert\" | \"update\"): [string, unknown][] {\n  if (!value || typeof value !== \"object\" || Array.isArray(value) || isExpr(value) || isEntity(value))\n    fail(`${operation} assignments must be a field POJO`);\n  const entries = Object.entries(value);\n  for (const [key] of entries) writableField(meta, key, operation);\n  checkPojo(value, Object.keys(meta.columns), `${operation} assignments`);\n  const defined = entries.filter((entry) => entry[1] !== undefined);\n  if (!defined.length) fail(`${operation} requires at least one defined field; empty rows/sets are not DEFAULT VALUES`);\n  return defined;\n}\n\n/** Validates assignment keys against a custom table's declared writable columns. */\nfunction customAssignments(\n  table: CustomTableMgmt,\n  value: unknown,\n  operation: \"insert\" | \"update\",\n): [string, unknown][] {\n  if (!value || typeof value !== \"object\" || Array.isArray(value) || isExpr(value) || isEntity(value)) {\n    fail(`${operation} assignments must be a field POJO`);\n  }\n  const entries = Object.entries(value);\n  for (const [key] of entries) customWritableField(table, key, operation);\n  checkPojo(value, Object.keys(table.columns), `${operation} assignments`);\n  const defined = entries.filter((entry) => entry[1] !== undefined);\n  if (!defined.length) fail(`${operation} requires at least one defined field; empty rows/sets are not DEFAULT VALUES`);\n  return defined;\n}\n\n/** Applies physical write restrictions declared by `declareTable`. */\nfunction customWritableField(table: CustomTableMgmt, key: string, operation: \"insert\" | \"update\"): Column {\n  const column = Object.hasOwn(table.columns, key) ? table.columns[key] : undefined;\n  if (!column) fail(`Unsupported SQL mutation field ${table.tableName}.${key}`);\n  if (operation === \"update\" ? !column.update : column.insert === \"never\") {\n    fail(`Unsupported SQL mutation field ${table.tableName}.${key}`);\n  }\n  return column;\n}\n\n/** Applies physical write restrictions, not ORM-derived, protected, or business-immutable flags. */\nfunction writableField(meta: EntityMetadata, key: string, operation: \"insert\" | \"update\"): Column {\n  const column = Object.hasOwn(meta.columns, key) ? meta.columns[key] : undefined;\n  if (!column) fail(`Unsupported SQL mutation field ${meta.type}.${key}`);\n  requireColumnMetadata(meta, column);\n  if (operation === \"update\" && key === \"id\") fail(\"UPDATE primary-key assignments are not supported\");\n  if (column.isGenerated) fail(`Generated field ${meta.type}.${key} is omit-only`);\n  if (operation === \"update\" ? !column.update : column.insert === \"never\")\n    fail(`Unsupported SQL mutation field ${meta.type}.${key}`);\n  return column;\n}\n\n/**\n * Classifies SQL expressions and SQL NULL before invoking the column's entity-independent write codec.\n * Normalizes public PK/FK ids to internal tagged ids using the target entity's idType.\n */\nfunction assignmentToSql(meta: EntityMetadata, column: Column, value: unknown, ctx: Ctx): SqlFragment {\n  if (isExpr(value)) return asNode(value).toSql(ctx);\n  if (value === null) {\n    if (!column.sqlNullable) fail(`${meta.type}.${column.columnName} is physically NOT NULL`);\n    return { sql: \"NULL\", bindings: [], refs: [] };\n  }\n  if (column.idMetadata) {\n    const other = column.idMetadata();\n    if (isEntity(value)) {\n      if (column.columnName === \"id\" || !(value instanceof other.cstr)) fail(`Expected a ${other.type} reference`);\n      if (value.isNewEntity || value.idTaggedMaybe === undefined)\n        fail(`Cannot reference an unflushed ${other.type}, even with an assigned ID`);\n      value = value.idTaggedMaybe;\n    } else if (typeof value !== (other.idType === \"number\" ? \"number\" : \"string\")) {\n      fail(`Expected a persisted ${other.type} or its ID; nested creation is not supported`);\n    } else {\n      // Public untagged TEXT ids may contain delimiters or start with the entity tag.\n      value =\n        other.idType === \"untagged-string\"\n          ? keyToTaggedId(other, value as string)\n          : toTaggedId(other, value as string | number);\n    }\n  }\n  if (!column.codec.mapToDbValue)\n    fail(`The codec for ${meta.type}.${column.columnName} does not support SQL value writes`);\n  return { sql: \"?\", bindings: [column.mapToDbValue(value)], refs: [] };\n}\n\n/** Encodes a custom-table literal through its declared primitive codec. */\nfunction customAssignmentToSql(table: CustomTableMgmt, column: Column, value: unknown, ctx: Ctx): SqlFragment {\n  if (isExpr(value)) return asNode(value).toSql(ctx);\n  if (value === null) {\n    if (!column.sqlNullable) fail(`${table.tableName}.${column.columnName} is physically NOT NULL`);\n    return { sql: \"NULL\", bindings: [], refs: [] };\n  }\n  return { sql: \"?\", bindings: [column.mapToDbValue(value)], refs: [] };\n}\n\n/** Checks the user predicate independently so metadata filters cannot turn a pruned guard into consent. */\nfunction mutationCondition(value: unknown, ctx: Ctx): SqlFragment | undefined {\n  if (isExpr(value)) return asNode(value).toSql(ctx);\n  if (Array.isArray(value)) return conditionToSql({ and: value }, ctx, true);\n  return conditionToSql(value as SqlCondition | undefined, ctx, true);\n}\n\n/** Only own enumerable POJO clauses count as input or explicit full-table consent. */\nfunction checkPojo(value: object, allowed: readonly PropertyKey[], description: string): void {\n  if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)\n    fail(`${description} must be a plain POJO`);\n  for (const key of Reflect.ownKeys(value)) {\n    if (!allowed.includes(key)) fail(`${description} does not support '${String(key)}'`);\n    if (typeof key === \"string\" && !Object.prototype.propertyIsEnumerable.call(value, key))\n      fail(`${description} requires enumerable fields`);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"execute.js","names":[],"sources":["../../../src/queries/sql/execute.ts"],"sourcesContent":["import type { DriverQueryResult } from \"src/drivers/Driver.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\nimport type { IdOf } from \"src/EntityManager.ts\";\nimport type { EntityMetadata } from \"src/EntityMetadata.ts\";\nimport { keyToTaggedId, toTaggedId } from \"src/keys.ts\";\nimport type { SqlCondition } from \"src/queries/conditions.ts\";\nimport { AliasAssigner } from \"src/queries/sql/AliasAssigner.ts\";\nimport {\n  type CustomColumnInputs,\n  type CustomColumnValue,\n  type CustomColumnsOf,\n  type CustomTableFor,\n} from \"src/queries/sql/custom.ts\";\nimport { type ExprBrand, type ExprLike, type SqlFragment, asNode, exprBrand, isExpr } from \"src/queries/sql/Expr.ts\";\nimport { kq, safeKq } from \"src/queries/sql/keywords.ts\";\nimport {\n  type CheckReadQuery,\n  type CheckScope,\n  type CheckSetQuery,\n  Ctx,\n  type EntityHydrator,\n  type NameOf,\n  type Plan,\n  type Query,\n  type QueryJoinInput,\n  type QueryRow,\n  type ReadQueryRow,\n  type SetOperand,\n  type SetOperation,\n  type SetQuery,\n  type Subquery,\n  type WithInput,\n  checkPojoKeys,\n  conditionToSql,\n  entityQueryBrand,\n  injectedConditions,\n  isReadQueryValue,\n  parseNestedQuery,\n  parseUserQuery,\n  projectionToSql,\n  pruneCtes,\n  registerCtes,\n  subqueryBrand,\n  withFragment,\n} from \"src/queries/sql/query.ts\";\nimport {\n  type TableFor,\n  type TableSourceMgmt,\n  getTableMgmt,\n  isCustomTable,\n  isEntityTable,\n  tableMgmt,\n  tableSqlName,\n} from \"src/queries/sql/Tables.ts\";\nimport type { Column, ColumnDescriptors } from \"src/serde/columns.ts\";\nimport type { ColumnsOf, TypeMapEntry } from \"src/typeMap.ts\";\nimport { fail } from \"src/utils.ts\";\n\n/** The native command count and decoded rows from one immediate SQL statement. */\nexport interface ExecuteResult<R> {\n  rowCount: number;\n  rows: R[];\n}\n\n/** A mutation's RETURNING projection: one SQL expression or a named object of expressions. */\nexport type MutationReturning = (ExprLike<unknown> | Readonly<Record<string, ExprLike<unknown>>>) & {\n  readonly [tableMgmt]?: never;\n  readonly [subqueryBrand]?: never;\n  readonly [entityQueryBrand]?: never;\n};\n\n/** SQL INSERT inputs, based on physical storage rather than entity creation options. */\nexport type InsertValues<T extends Entity> = {\n  [K in RequiredInsertKey<T>]: Assignment<T, K>;\n} & {\n  [K in Exclude<InsertKey<T>, RequiredInsertKey<T>>]?: Assignment<T, K> | undefined;\n};\n\n/** SQL UPDATE inputs include persisted derived columns, but never primary keys. */\nexport type UpdateValues<T extends Entity> = {\n  [K in UpdateKey<T>]?: Assignment<T, K> | undefined;\n};\n\n/** A reusable INSERT POJO; use a concrete Q for annotated INSERT SELECT source checking. */\nexport type InsertStatement<\n  T extends Entity,\n  R extends MutationReturning | undefined = MutationReturning | undefined,\n  Q extends SetOperand = Query<InsertProjection<T>, []> | Subquery<InsertSourceRow<T>, string>,\n> = {\n  readonly insert: MutationTargetTable<T>;\n  readonly returning?: R;\n  readonly update?: never;\n  readonly delete?: never;\n  readonly set?: never;\n  readonly where?: never;\n  readonly allowAll?: never;\n  readonly softDeletes?: never;\n  /** CTEs to add to a `WITH` before the INSERT; see `Clauses.with`. */\n  readonly with?: WithInput;\n} & NoMutationReadClauses &\n  (\n    | { readonly values: readonly InsertValues<T>[]; readonly from?: never }\n    | { readonly from: Q & CheckInsertSource<T, Q>; readonly values?: never }\n  );\n\n/** A reusable guarded UPDATE POJO. Undefined assignments leave existing columns unchanged. */\nexport type UpdateStatement<\n  T extends Entity,\n  R extends MutationReturning | undefined = MutationReturning | undefined,\n> = {\n  readonly update: MutationTargetTable<T>;\n  readonly set: UpdateValues<T>;\n  readonly returning?: R;\n  readonly insert?: never;\n  readonly delete?: never;\n  readonly values?: never;\n  readonly from?: never;\n  /** CTEs to add to a `WITH` before the UPDATE; see `Clauses.with`. */\n  readonly with?: WithInput;\n} & MutationFilter &\n  NoMutationReadClauses;\n\n/** A reusable guarded physical DELETE POJO, not an ORM soft delete. */\nexport type DeleteStatement<\n  T extends Entity,\n  R extends MutationReturning | undefined = MutationReturning | undefined,\n> = {\n  readonly delete: MutationTargetTable<T>;\n  readonly returning?: R;\n  readonly insert?: never;\n  readonly update?: never;\n  readonly values?: never;\n  readonly from?: never;\n  readonly set?: never;\n  /** CTEs to add to a `WITH` before the DELETE; see `Clauses.with`. */\n  readonly with?: WithInput;\n} & MutationFilter &\n  NoMutationReadClauses;\n\n/** Public statement annotations retain the target's physical field policy. */\nexport type MutationStatement<\n  T extends Entity,\n  R extends MutationReturning | undefined = MutationReturning | undefined,\n> = InsertStatement<T, R> | UpdateStatement<T, R> | DeleteStatement<T, R>;\n\n/** Inference starts with the literal POJO; CheckMutation checks its target and every supplied key. */\nexport type MutationInput = (\n  | { readonly insert: TableFor<Entity>; readonly values: readonly object[]; readonly from?: never }\n  | { readonly insert: TableFor<Entity>; readonly from: SetOperand; readonly values?: never }\n  | { readonly update: TableFor<Entity>; readonly set: object }\n  | { readonly delete: TableFor<Entity> }\n  | {\n      readonly insert: CustomTableFor;\n      readonly values: readonly object[];\n      readonly from?: never;\n    }\n  | { readonly insert: CustomTableFor; readonly from: SetOperand; readonly values?: never }\n  | { readonly update: CustomTableFor; readonly set: object }\n  | { readonly delete: CustomTableFor }\n) & { readonly returning?: MutationReturning; readonly with?: WithInput } & MutationFilter;\n\n/** Without RETURNING the row type is never; scalar expressions produce scalar rows. */\nexport type MutationRow<M> = M extends { readonly returning?: infer R }\n  ? R extends MutationReturning\n    ? R extends ExprLike<unknown>\n      ? QueryRow<R>\n      : { -readonly [K in keyof QueryRow<R>]: QueryRow<R>[K] }\n    : never\n  : never;\n\n/** Checks nonliteral statements as well as fresh literals without widening their inferred result. */\nexport type CheckMutation<M> = M extends unknown\n  ? [CustomColumnsOf<TargetTable<M>>] extends [never]\n    ? TargetEntity<M> extends infer T extends Entity\n      ? TypeMapEntry<T, \"supportsEmExecute\"> extends true\n        ? { readonly [K in keyof M]: K extends MutationClause<M> ? unknown : never } & {\n            readonly returning?: M extends { readonly returning?: infer R }\n              ? CheckReturning<R, NameOf<TargetTable<M>>>\n              : never;\n          } & (\n              | (M extends { readonly values: infer V extends readonly unknown[] }\n                  ? { readonly values: CheckValues<T, V> }\n                  : never)\n              | (M extends { readonly from: infer Q extends SetOperand }\n                  ? { readonly from: CheckInsertSource<T, Q> }\n                  : never)\n              | (M extends { readonly set: infer V }\n                  ? { readonly set: CheckAssignments<V, UpdateValues<T>, NameOf<TargetTable<M>>> }\n                  : never)\n              | (M extends { readonly delete: unknown } ? unknown : never)\n            )\n        : \"SQL mutations require a supported non-inherited target and regenerated metadata\"\n      : never\n    : CheckCustomMutation<M>\n  : never;\n\n/** Classifies mutation roots before EntityManager applies write permissions, including malformed roots. */\nexport function isMutation(arg: unknown): boolean {\n  return (\n    typeof arg === \"object\" &&\n    arg !== null &&\n    !isReadQueryValue(arg) &&\n    [\"insert\", \"update\", \"delete\"].some((key) => key in arg)\n  );\n}\n\n/**\n * Compiles one immediate statement using the read compiler's scopes, projections, and codecs.\n * INSERT SELECT keeps source rows in PostgreSQL; only RETURNING rows pass through JS decoders.\n * An undefined plan represents a validated standalone empty VALUES array, not DEFAULT VALUES.\n */\nexport function parseStatement(arg: unknown): Plan | undefined {\n  if (!isMutation(arg)) return parseUserQuery(arg);\n  const statement = arg as Record<string, unknown>;\n  const roots = [\"insert\", \"update\", \"delete\"].filter((key) => key in statement);\n  if (roots.length !== 1) fail(\"A mutation requires exactly one insert, update, or delete root\");\n  const operation = roots[0];\n  const allowed =\n    operation === \"insert\"\n      ? [\"insert\", \"values\", \"from\", \"returning\", \"with\"]\n      : [\n          operation,\n          \"where\",\n          \"allowAll\",\n          \"softDeletes\",\n          \"returning\",\n          \"with\",\n          ...(operation === \"update\" ? [\"set\"] : []),\n        ];\n  checkPojoKeys(statement, allowed, `SQL ${operation}`);\n  const target = mutationTarget(statement[operation]);\n  const { meta } = target;\n  if (meta) {\n    if (meta.inheritanceType || meta.baseType || meta.baseTypes.length || meta.subTypes.length) {\n      fail(\"SQL mutations do not support CTI/STI targets or inherited table families\");\n    }\n    if (meta.supportsEmExecute !== true)\n      fail(`SQL mutations require supported physical metadata for ${meta.type}; run codegen`);\n    // Every column is checked here, so the writable-column lookups below can trust their metadata.\n    for (const column of Object.values(meta.columns)) requireColumnMetadata(target, column);\n  } else if (statement.softDeletes !== undefined) {\n    fail(\"Custom table mutations do not support softDeletes\");\n  }\n  const fields = Object.entries(target.columns);\n  const assigner = new AliasAssigner();\n  // A CTE is in scope for the whole statement, so its scope is the parent of every other one here. It\n  // deliberately holds no target alias, which is what lets INSERT VALUES cells and the INSERT SELECT\n  // source read the CTEs without also seeing the row being written.\n  const withCtx = new Ctx(assigner, undefined);\n  const ctes = registerCtes(statement, withCtx, assigner);\n  // Aliases the rest of the statement reads, so an unread CTE prunes like it does on a read query.\n  const refs: string[] = [];\n  const ctx = new Ctx(assigner, withCtx);\n  const alias = assigner.getAlias(target.mgmt.tableName);\n  ctx.register(target.mgmt, alias);\n  const returning = statement.returning === undefined ? undefined : projectionToSql(statement.returning, ctx);\n  if (returning) for (const select of returning.selects) refs.push(...select.refs);\n  let sql = `${operation === \"delete\" ? \"DELETE FROM\" : operation.toUpperCase() + (operation === \"insert\" ? \" INTO\" : \"\")} ${tableSqlName(target.mgmt)} AS ${kq(alias)}`;\n  const bindings: unknown[] = [];\n  if (operation === \"insert\") {\n    if (\"values\" in statement === \"from\" in statement) fail(\"INSERT requires exactly one of values or from\");\n    const required = fields.filter(([, column]) => column.insert === \"required\");\n    if (\"values\" in statement) {\n      if (!Array.isArray(statement.values)) fail(\"INSERT values must be an array of field POJOs\");\n      const rows = statement.values;\n      // A VALUES cell *is* the new row, so there is no existing row for it to read: this scope skips\n      // the `ctx.register(mgmt, alias)` above, so a cell naming the target fails instead of emitting a\n      // `b` with no FROM clause. I.e. an UPDATE can say `set: { title: b.title }`; an INSERT cannot.\n      // A value subquery still works, because it brings its own sources, and the parent here is the CTE\n      // scope rather than `ctx`, so a cell can read a `with` entry but not the row being written.\n      const valuesCtx = new Ctx(assigner, withCtx);\n      const entries = rows.map((row) => assignments(target, row, \"insert\"));\n      for (const row of entries) {\n        for (const [key] of required) {\n          if (!row.some((entry) => entry[0] === key)) fail(`INSERT requires ${target.name}.${key}`);\n        }\n      }\n      if (rows.length === 0) return undefined;\n      const keys = fields\n        .filter(([key]) => entries.some((row) => row.some((entry) => entry[0] === key)))\n        .map(([key, field]) => [key, field.columnName] as const);\n      sql += ` (${keys.map(([, column]) => kq(column)).join(\", \")}) VALUES `;\n      sql += entries\n        .map((row) => {\n          const cells = keys.map(([key]) => {\n            const entry = row.find((entry) => entry[0] === key);\n            if (!entry) return \"DEFAULT\";\n            const cell = assignmentToSql(target, writableField(target, key, \"insert\"), entry[1], valuesCtx);\n            bindings.push(...cell.bindings);\n            refs.push(...cell.refs);\n            return cell.sql;\n          });\n          return `(${cells.join(\", \")})`;\n        })\n        .join(\", \");\n    } else {\n      const source = parseNestedQuery(statement.from, withCtx, assigner);\n      if (source.output.kind !== \"pojo\") fail(\"INSERT SELECT requires named POJO output columns\");\n      const columns = source.output.columns;\n      for (const [key] of required) {\n        if (!columns.some((column) => column[0] === key)) {\n          fail(`INSERT requires ${target.name}.${key}`);\n        }\n      }\n      for (const [key, expr] of columns) {\n        const field = writableField(target, key, \"insert\");\n        const left = field.outputType;\n        const right = expr.outputType;\n        if (\n          !left ||\n          !right ||\n          left.dbType !== right.dbType ||\n          left.domain !== right.domain ||\n          left.idMeta !== right.idMeta\n        ) {\n          fail(`INSERT SELECT ${target.name}.${key} has incompatible or unknown storage codecs`);\n        }\n        if (!field.sqlNullable && expr.sqlNullable === true)\n          fail(`INSERT SELECT ${target.name}.${key} cannot accept a nullable output`);\n      }\n      const keys = fields\n        .filter(([key]) => columns.some((column) => column[0] === key))\n        .map(([key, field]) => [key, field.columnName] as const);\n      const sourceAlias = safeKq(assigner.getLiteralAlias(\"sq\"));\n      sql += ` (${keys.map(([, column]) => kq(column)).join(\", \")}) SELECT ${keys.map(([key]) => `${sourceAlias}.${safeKq(key)}`).join(\", \")} FROM (${source.sql}) AS ${sourceAlias}`;\n      bindings.push(...source.bindings);\n      refs.push(...source.outerRefs);\n    }\n  } else {\n    if (statement.allowAll !== undefined && typeof statement.allowAll !== \"boolean\") fail(\"allowAll must be a boolean\");\n    if (\n      statement.softDeletes !== undefined &&\n      statement.softDeletes !== \"include\" &&\n      statement.softDeletes !== \"exclude\"\n    )\n      fail(\"softDeletes must be 'include' or 'exclude'\");\n    const whereCondition = mutationCondition(statement.where, ctx);\n    if (Object.hasOwn(statement, \"where\") && !whereCondition && statement.allowAll !== true)\n      fail(\"UPDATE and DELETE require allowAll: true when a supplied where is undefined or fully pruned\");\n    if (operation === \"update\") {\n      const entries = assignments(target, statement.set, \"update\");\n      sql +=\n        \" SET \" +\n        entries\n          .map((entry) => {\n            const [key, value] = entry;\n            const field = writableField(target, key, \"update\");\n            const cell = assignmentToSql(target, field, value, ctx);\n            bindings.push(...cell.bindings);\n            refs.push(...cell.refs);\n            return `${kq(field.columnName)} = ${cell.sql}`;\n          })\n          .join(\", \");\n    }\n    const injected = meta\n      ? conditionToSql({ and: injectedConditions({ meta, alias }, statement.softDeletes ?? \"exclude\") }, ctx, true)\n      : undefined;\n    const conditions = [whereCondition, injected].filter((condition) => condition !== undefined);\n    if (conditions.length) {\n      sql += ` WHERE ${conditions.map((condition) => `(${condition.sql})`).join(\" AND \")}`;\n      for (const condition of conditions) {\n        bindings.push(...condition.bindings);\n        refs.push(...condition.refs);\n      }\n    }\n  }\n  if (returning) {\n    sql += ` RETURNING ${returning.selects.map((select) => select.sql).join(\", \")}`;\n    for (const select of returning.selects) bindings.push(...select.bindings);\n  }\n  const keptCtes = pruneCtes(ctes, new Set(refs));\n  if (keptCtes.length > 0) {\n    const clause = withFragment(keptCtes);\n    sql = clause.sql + sql;\n    bindings.unshift(...clause.bindings);\n  }\n  return {\n    sql,\n    bindings,\n    outerRefs: [],\n    output: returning?.output ?? { kind: \"pojo\", columns: [] },\n    decodeRows: returning?.decodeRows ?? (() => []),\n  };\n}\n\n/** Retains native counts even when no rows return, and propagates decoding failures after execution. */\nexport function decodeStatementResult(\n  em: EntityHydrator,\n  plan: Plan,\n  result: DriverQueryResult,\n): ExecuteResult<unknown> {\n  if (typeof result.rowCount !== \"number\" || !Number.isInteger(result.rowCount) || result.rowCount < 0)\n    fail(\"The driver did not return a numeric command rowCount\");\n  return { rowCount: result.rowCount, rows: plan.decodeRows(em, result.rows) };\n}\n\n/** An entity table whose generated metadata permits direct SQL mutations. */\ntype MutationTargetTable<T extends Entity> = TableFor<T> &\n  (TypeMapEntry<T, \"supportsEmExecute\"> extends true ? unknown : never);\n\n/**\n * What a mutation needs from its target, an entity table or a `declareTable` table alike.\n *\n * Both kinds describe their storage with the same `Column`, so the INSERT/UPDATE/DELETE compiler reads\n * `columns` without caring which it has; `meta` is the one thing only an entity table brings.\n */\ninterface MutationTarget {\n  /** The SQL identity, for the alias and the qualified table name; also the key `Ctx` registers. */\n  mgmt: TableSourceMgmt;\n  /** Names the target in errors: the entity type, i.e. `Book`, or the table name, i.e. `book_reviews`. */\n  name: string;\n  columns: ColumnDescriptors;\n  /** Entity tables only; a custom table has no soft-delete, inheritance, or ID-tagging policy. */\n  meta: EntityMetadata | undefined;\n}\n\n/** Shared filtering and full-table consent clauses for UPDATE and DELETE. */\ntype MutationFilter = {\n  /**\n   * An `{ and: [...] }` or `{ or: [...] }` group, a boolean expression, or a bare condition such as `a.age.gte(18)`.\n   *\n   * Arrays are shorthand for `{ and: [...] }`; undefined conditions are pruned.\n   */\n  readonly where?: SqlCondition | ExprLike<boolean> | readonly (SqlCondition | undefined)[];\n  /** Allows a supplied where to be undefined or fully pruned; unnecessary when where is omitted. */\n  readonly allowAll?: boolean;\n  readonly softDeletes?: \"include\" | \"exclude\";\n};\n\n/** Read-only query clauses that mutations explicitly reject. */\ntype NoMutationReadClauses = Partial<\n  Record<\n    | \"select\"\n    | \"join\"\n    | \"groupBy\"\n    | \"having\"\n    | \"orderBy\"\n    | \"limit\"\n    | \"offset\"\n    | \"distinct\"\n    | \"pruneJoins\"\n    | \"as\"\n    | \"union\"\n    | \"unionAll\"\n    | \"intersect\"\n    | \"intersectAll\"\n    | \"except\"\n    | \"exceptAll\"\n    | \"ctes\"\n    | \"using\"\n    | \"onConflict\",\n    never\n  >\n>;\n\n/** Column keys allowed in INSERT, i.e. Book's optional `id` and required `authorId`. */\ntype InsertKey<T> = {\n  [K in keyof ColumnsOf<T>]: ColumnsOf<T>[K] extends { insert: \"required\" | \"optional\" } ? K : never;\n}[keyof ColumnsOf<T>];\n\n/** Column keys that each INSERT row must supply, i.e. Book's `authorId` despite its ORM default. */\ntype RequiredInsertKey<T> = {\n  [K in keyof ColumnsOf<T>]: ColumnsOf<T>[K] extends { insert: \"required\" } ? K : never;\n}[keyof ColumnsOf<T>];\n\n/** Column keys allowed in UPDATE SET, i.e. Book's `title` and `authorId`, but not `id`. */\ntype UpdateKey<T> = {\n  [K in keyof ColumnsOf<T>]: ColumnsOf<T>[K] extends { update: true } ? K : never;\n}[keyof ColumnsOf<T>];\n\n/** A column's domain value before SQL nullability is added, i.e. Book's `id` is BookId and `authorId` is AuthorId. */\ntype DomainValue<T, K extends keyof ColumnsOf<T>> = K extends \"id\"\n  ? IdOf<T>\n  : ColumnsOf<T>[K] extends { entity: infer U }\n    ? IdOf<U>\n    : ColumnsOf<T>[K] extends { type: infer V }\n      ? V\n      : never;\n\n/** A modeled column's domain value with SQL nullability applied. */\ntype SqlValue<T, K extends keyof ColumnsOf<T>> =\n  | DomainValue<T, K>\n  | (ColumnsOf<T>[K] extends { nullable: true } ? null : never);\n\n/** A modeled-column value, entity reference, or SQL expression that produces one. */\ntype Assignment<T, K extends keyof ColumnsOf<T>> =\n  | SqlValue<T, K>\n  | ExprLike<SqlValue<T, K>>\n  | (K extends \"id\" ? never : ColumnsOf<T>[K] extends { entity: infer U } ? U : never);\n\n/** A custom column's declared value with SQL nullability applied. */\ntype CustomSqlValue<I> = CustomColumnValue<I> | (I extends { nullable: true } ? null : never);\n\n/** A custom-column value or SQL expression that produces one. */\ntype CustomAssignment<I> = CustomSqlValue<I> | ExprLike<CustomSqlValue<I>>;\n\n/** Custom-column keys accepted by INSERT, excluding generated columns. */\ntype CustomInsertKey<C extends CustomColumnInputs> = {\n  [K in keyof C]: C[K] extends { generated: true } ? never : K;\n}[keyof C];\n\n/** Custom-column keys each INSERT row must supply because they have no default and are not nullable. */\ntype CustomRequiredInsertKey<C extends CustomColumnInputs> = {\n  [K in CustomInsertKey<C>]: C[K] extends { nullable: true } | { hasDefault: true } ? never : K;\n}[CustomInsertKey<C>];\n\n/** Custom-column keys accepted by UPDATE, excluding generated columns and the physical primary key. */\ntype CustomUpdateKey<C extends CustomColumnInputs> = {\n  [K in keyof C]: C[K] extends { generated: true }\n    ? never\n    : K extends \"id\"\n      ? never\n      : C[K] extends { columnName: \"id\" }\n        ? never\n        : K;\n}[keyof C];\n\n/** Values accepted by INSERT for a custom table's declared columns. */\ntype CustomInsertValues<C extends CustomColumnInputs> = {\n  [K in CustomRequiredInsertKey<C>]: CustomAssignment<C[K]>;\n} & {\n  [K in Exclude<CustomInsertKey<C>, CustomRequiredInsertKey<C>>]?: CustomAssignment<C[K]> | undefined;\n};\n\n/** Assignments accepted by UPDATE for a custom table's writable columns. */\ntype CustomUpdateValues<C extends CustomColumnInputs> = {\n  [K in CustomUpdateKey<C>]?: CustomAssignment<C[K]> | undefined;\n};\n\n/** Named row shape that an INSERT SELECT source must produce for a custom table. */\ntype CustomInsertSourceRow<C extends CustomColumnInputs> = {\n  [K in CustomRequiredInsertKey<C>]: CustomSqlValue<C[K]>;\n} & {\n  [K in Exclude<CustomInsertKey<C>, CustomRequiredInsertKey<C>>]?: CustomSqlValue<C[K]>;\n};\n\n/** Named row shape that an entity INSERT SELECT source must produce. */\ntype InsertSourceRow<T> = { [K in RequiredInsertKey<T>]: SqlValue<T, K> } & {\n  [K in Exclude<InsertKey<T>, RequiredInsertKey<T>>]?: SqlValue<T, K>;\n};\n\n/** Named expression projection accepted from an entity INSERT SELECT source. */\ntype InsertProjection<T> = { [K in RequiredInsertKey<T>]: ExprLike<SqlValue<T, K>> } & {\n  [K in Exclude<InsertKey<T>, RequiredInsertKey<T>>]?: ExprLike<SqlValue<T, K>>;\n};\n\n/** Collects the keys from every member of a union instead of only their shared keys. */\ntype UnionKeys<V> = V extends unknown ? keyof V : never;\n\n/** Collects every alternative before scope checking; a valid branch cannot hide an unrelated alias. */\ntype UnionValue<V, K extends PropertyKey> = V extends unknown ? (K extends keyof V ? V[K] : never) : never;\n\n/** Extracts the source names carried by a SQL expression. */\ntype ExprSource<V> = V extends { readonly [exprBrand]: ExprBrand<unknown, infer Src> } ? Src : never;\n\n/** Rejects expressions that reference tables outside the statement's allowed scope. */\ntype CheckExprScope<V, Scope> =\n  string extends ExprSource<V>\n    ? unknown\n    : [Exclude<ExprSource<V>, Scope>] extends [never]\n      ? unknown\n      : \"Expression source is not in the statement scope\";\n\n/** Extracts each expression from a scalar or named RETURNING projection. */\ntype ReturningExpr<R> = R extends ExprLike<unknown> ? R : R extends undefined ? never : R[keyof R];\n\n/** Detects an empty named RETURNING projection. */\ntype EmptyReturning<R> = R extends object ? (keyof R extends never ? true : false) : false;\n\n/** Rejects empty RETURNING objects and expressions outside the target scope. */\ntype CheckReturning<R, Scope> = true extends EmptyReturning<R> ? never : CheckExprScope<ReturningExpr<R>, Scope>;\n\n/** Validates assignment keys, values, and expression sources without distributing union inputs. */\ntype CheckAssignments<V, Allowed, Scope> = [Exclude<UnionKeys<V>, keyof Allowed>] extends [never]\n  ? Allowed & {\n      [K in UnionKeys<V>]?: CheckExprScope<UnionValue<V, K>, Scope>;\n    }\n  : \"SQL assignments have unknown target fields\";\n\n/** Checks every entity INSERT row in a readonly collection against writable columns. */\ntype CheckValues<T extends Entity, V extends readonly unknown[]> = readonly CheckAssignments<\n  V[number],\n  InsertValues<T>,\n  never\n>[];\n\n/**\n * Checks a custom-table mutation against its declared primitive columns.\n *\n * Only clauses for the selected operation are allowed, and `softDeletes` is rejected because there is no entity\n * policy. Assignments use declaration keys and honor nullability, defaults, and generated columns. INSERT VALUES\n * cannot read the target row, while UPDATE SET and RETURNING can. INSERT SELECT must be a valid named read with all\n * required columns and compatible declared value types; runtime checks also compare its SQL codecs and nullability.\n */\ntype CheckCustomMutation<M> = {\n  // Reject clauses outside the selected operation, plus softDeletes because custom tables have no entity policy.\n  readonly [K in keyof M]: K extends MutationClause<M> ? (K extends \"softDeletes\" ? never : unknown) : never;\n} & {\n  readonly returning?: M extends { readonly returning?: infer R } ? CheckReturning<R, NameOf<TargetTable<M>>> : never;\n} &\n  // INSERT VALUES checks every row against the custom table's writable columns.\n  (\n    | (M extends { readonly values: infer V extends readonly unknown[] }\n        ? { readonly values: CheckCustomValues<CustomColumnsOf<TargetTable<M>>, V> }\n        : never)\n    // INSERT SELECT checks the source's names, values, and expression scopes.\n    | (M extends { readonly from: infer Q extends SetOperand }\n        ? { readonly from: CheckCustomInsertSource<CustomColumnsOf<TargetTable<M>>, Q> }\n        : never)\n    // UPDATE checks assignments against writable columns and permits target-scoped expressions.\n    | (M extends { readonly set: infer V }\n        ? {\n            readonly set: CheckAssignments<\n              V,\n              CustomUpdateValues<CustomColumnsOf<TargetTable<M>>>,\n              NameOf<TargetTable<M>>\n            >;\n          }\n        : never)\n    // DELETE has no assignments or source that needs further type checking.\n    | (M extends { readonly delete: unknown } ? unknown : never)\n  );\n\n/** Checks every custom INSERT row in a readonly collection against declared writable columns. */\ntype CheckCustomValues<C extends CustomColumnInputs, V extends readonly unknown[]> = readonly CheckAssignments<\n  V[number],\n  CustomInsertValues<C>,\n  never\n>[];\n\n/** Checks a custom INSERT SELECT's named outputs, required columns, values, and read source. */\ntype CheckCustomInsertSource<C extends CustomColumnInputs, Q> = SetOperand extends Q\n  ? \"INSERT source type lost its select keys; use `satisfies Query` or `satisfies SetQuery` instead of a type annotation\"\n  : ReadQueryRow<Q> extends CustomInsertSourceRow<C>\n    ? Exclude<UnionKeys<ReadQueryRow<Q>>, CustomInsertKey<C>> extends never\n      ? CheckReadQuery<Q> &\n          CheckSourceScope<Q> &\n          (Q extends SetQuery<readonly SetOperand[]> ? CheckSetQuery<Q> : unknown)\n      : \"INSERT SELECT has unknown target fields\"\n    : \"INSERT SELECT requires compatible values for all SQL-required fields\";\n\n/** Checks every SELECT expression against the tables visible within its read-query branch. */\ntype CheckSourceScope<Q> = Q extends { readonly select: infer S; readonly from: infer F }\n  ? CheckScope<S, F, \"join\" extends keyof Q ? Extract<Q[keyof Q & \"join\"], QueryJoinInput> : []>\n  : {\n      [K in keyof Q]: K extends SetOperation\n        ? Q[K] extends readonly unknown[]\n          ? { [I in keyof Q[K]]: CheckSourceScope<Q[K][I]> }\n          : unknown\n        : unknown;\n    };\n\n/** Checks an entity INSERT SELECT's named outputs, required columns, values, and read source. */\ntype CheckInsertSource<T, Q extends SetOperand> = SetOperand extends Q\n  ? \"INSERT source type lost its select keys; use `satisfies Query` or `satisfies SetQuery` instead of a type annotation\"\n  : ReadQueryRow<Q> extends InsertSourceRow<T>\n    ? Exclude<UnionKeys<ReadQueryRow<Q>>, InsertKey<T>> extends never\n      ? CheckReadQuery<Q> &\n          CheckSourceScope<Q> &\n          (Q extends SetQuery<readonly SetOperand[]> ? CheckSetQuery<Q> : unknown)\n      : \"INSERT SELECT has unknown target fields\"\n    : \"INSERT SELECT requires compatible values for all SQL-required fields\";\n\n/** Extracts the entity type from any mutation target clause. */\ntype TargetEntity<M> = M extends\n  | { readonly insert: TableFor<infer T> }\n  | { readonly update: TableFor<infer T> }\n  | { readonly delete: TableFor<infer T> }\n  ? T\n  : never;\n\n/** Extracts the table handle from any mutation target clause. */\ntype TargetTable<M> = M extends\n  | { readonly insert: infer A }\n  | { readonly update: infer A }\n  | { readonly delete: infer A }\n  ? A\n  : never;\n\n/** Clauses permitted by the selected INSERT, UPDATE, or DELETE operation. */\ntype MutationClause<M> =\n  | \"returning\"\n  | \"with\"\n  | (M extends { readonly insert: unknown }\n      ? \"insert\" | (M extends { readonly values: unknown } ? \"values\" : \"from\")\n      : \"where\" | \"allowAll\" | \"softDeletes\" | (M extends { readonly update: unknown } ? \"update\" | \"set\" : \"delete\"));\n\n/** Reads the writable columns from either kind of table handle, so the compiler has one target shape. */\nfunction mutationTarget(target: unknown): MutationTarget {\n  if (isEntityTable(target)) {\n    const mgmt = getTableMgmt(target);\n    return { mgmt, name: mgmt.meta.type, columns: mgmt.meta.columns, meta: mgmt.meta };\n  }\n  if (isCustomTable(target)) {\n    const mgmt = getTableMgmt(target);\n    return { mgmt, name: mgmt.tableName, columns: mgmt.columns, meta: undefined };\n  }\n  return fail(\"A mutation target must be a table\");\n}\n\n/** SQL mutations require complete physical metadata. */\nfunction requireColumnMetadata(target: MutationTarget, column: Column): void {\n  if (\n    typeof column.sqlNullable !== \"boolean\" ||\n    typeof column.hasDefault !== \"boolean\" ||\n    typeof column.isGenerated !== \"boolean\"\n  )\n    fail(`Missing physical metadata for ${target.name}.${column.columnName}; run codegen`);\n}\n\n/** Validates every supplied key, including undefined fields, before pruning omitted values. */\nfunction assignments(target: MutationTarget, value: unknown, operation: \"insert\" | \"update\"): [string, unknown][] {\n  if (!value || typeof value !== \"object\" || Array.isArray(value) || isExpr(value) || isEntity(value))\n    fail(`${operation} assignments must be a field POJO`);\n  const entries = Object.entries(value);\n  for (const [key] of entries) writableField(target, key, operation);\n  checkPojoKeys(value, Object.keys(target.columns), `${operation} assignments`);\n  const defined = entries.filter((entry) => entry[1] !== undefined);\n  if (!defined.length) fail(`${operation} requires at least one defined field; empty rows/sets are not DEFAULT VALUES`);\n  return defined;\n}\n\n/**\n * Applies physical write restrictions, not ORM-derived, protected, or business-immutable flags.\n *\n * The primary-key and generated checks only sharpen the message: `Column` already denies both through\n * `insert: \"never\"` and `update: false`, for declared custom columns as well as generated ones.\n */\nfunction writableField(target: MutationTarget, key: string, operation: \"insert\" | \"update\"): Column {\n  const column = Object.hasOwn(target.columns, key) ? target.columns[key] : undefined;\n  if (!column) fail(`Unsupported SQL mutation field ${target.name}.${key}`);\n  if (operation === \"update\" && column.columnName === \"id\") fail(\"UPDATE primary-key assignments are not supported\");\n  if (column.isGenerated) fail(`Generated field ${target.name}.${key} is omit-only`);\n  if (operation === \"update\" ? !column.update : column.insert === \"never\")\n    fail(`Unsupported SQL mutation field ${target.name}.${key}`);\n  return column;\n}\n\n/**\n * Classifies SQL expressions and SQL NULL before invoking the column's entity-independent write codec.\n * Normalizes public PK/FK ids to internal tagged ids using the target entity's idType.\n *\n * A custom table's columns never carry `idMetadata`, so they take the literal path below unchanged.\n */\nfunction assignmentToSql(target: MutationTarget, column: Column, value: unknown, ctx: Ctx): SqlFragment {\n  if (isExpr(value)) return asNode(value).toSql(ctx);\n  if (value === null) {\n    if (!column.sqlNullable) fail(`${target.name}.${column.columnName} is physically NOT NULL`);\n    return { sql: \"NULL\", bindings: [], refs: [] };\n  }\n  if (column.idMetadata) {\n    const other = column.idMetadata();\n    if (isEntity(value)) {\n      if (column.columnName === \"id\" || !(value instanceof other.cstr)) fail(`Expected a ${other.type} reference`);\n      if (value.isNewEntity || value.idTaggedMaybe === undefined)\n        fail(`Cannot reference an unflushed ${other.type}, even with an assigned ID`);\n      value = value.idTaggedMaybe;\n    } else if (typeof value !== (other.idType === \"number\" ? \"number\" : \"string\")) {\n      fail(`Expected a persisted ${other.type} or its ID; nested creation is not supported`);\n    } else {\n      // Public untagged TEXT ids may contain delimiters or start with the entity tag.\n      value =\n        other.idType === \"untagged-string\"\n          ? keyToTaggedId(other, value as string)\n          : toTaggedId(other, value as string | number);\n    }\n  }\n  if (!column.codec.mapToDbValue)\n    fail(`The codec for ${target.name}.${column.columnName} does not support SQL value writes`);\n  return { sql: \"?\", bindings: [column.mapToDbValue(value)], refs: [] };\n}\n\n/** Checks the user predicate independently so metadata filters cannot turn a pruned guard into consent. */\nfunction mutationCondition(value: unknown, ctx: Ctx): SqlFragment | undefined {\n  if (isExpr(value)) return asNode(value).toSql(ctx);\n  if (Array.isArray(value)) return conditionToSql({ and: value }, ctx, true);\n  return conditionToSql(value as SqlCondition | undefined, ctx, true);\n}\n"],"mappings":"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"}

package/build/queries/sql/query.cjs

@@ -1294,19 +1294,19 @@ function checkCondition(value) {
 	if ("and" in condition || "or" in condition) {
 		if ("and" in condition === "or" in condition) require_utils.fail("Query conditions require exactly one and/or group");
 		const key = "and" in condition ? "and" : "or";
-		checkConditionKeys(condition, [key, "pruneIfUndefined"], "Query condition group");
+		checkPojoKeys(condition, [key, "pruneIfUndefined"], "Query condition group");
 		if (!Array.isArray(condition[key])) require_utils.fail("Query condition groups require an array");
 		if (condition.pruneIfUndefined !== void 0 && condition.pruneIfUndefined !== "any" && condition.pruneIfUndefined !== "all") require_utils.fail("Invalid query pruneIfUndefined policy");
 		for (const child of condition[key]) checkCondition(child);
 	} else if ("exists" in condition || "notExists" in condition) {
 		const key = "exists" in condition ? "exists" : "notExists";
-		checkConditionKeys(condition, [key], "Query existence condition");
+		checkPojoKeys(condition, [key], "Query existence condition");
 		const query = condition[key];
 		if (query === void 0) return;
 		if (!(query instanceof SubqueryExpr) && !isReadQueryValue(query)) require_utils.fail(`Query ${key} requires a query(...) value`);
 		toQuery(query);
 	} else if (condition.kind === "raw") {
-		checkConditionKeys(condition, [
+		checkPojoKeys(condition, [
 			"kind",
 			"aliases",
 			"condition",
@@ -1317,7 +1317,7 @@ function checkCondition(value) {
 		], "Query raw condition");
 		if (typeof condition.condition !== "string" || !Array.isArray(condition.aliases) || !condition.aliases.every((alias) => typeof alias === "string") || !Array.isArray(condition.bindings) || typeof condition.pruneable !== "boolean") require_utils.fail("Malformed query raw condition");
 	} else if (condition.kind === "column") {
-		checkConditionKeys(condition, [
+		checkPojoKeys(condition, [
 			"kind",
 			"alias",
 			"column",
@@ -1329,7 +1329,7 @@ function checkCondition(value) {
 		if (typeof condition.alias !== "string" || typeof condition.column !== "string" || typeof condition.dbType !== "string" || condition.pruneable !== void 0 && typeof condition.pruneable !== "boolean") require_utils.fail("Malformed query column condition");
 		const filter = condition.cond;
 		if (!filter) require_utils.fail("Malformed query column filter");
-		checkConditionKeys(filter, ["kind", "value"], "Query column filter");
+		checkPojoKeys(filter, ["kind", "value"], "Query column filter");
 		const unary = filter.kind === "is-null" || filter.kind === "not-null";
 		if (!unary && (![
 			"eq",
@@ -1360,8 +1360,18 @@ function checkCondition(value) {
 		if (unary && "value" in filter) require_utils.fail("Unary query filters do not accept values");
 	} else require_utils.fail("Unknown query condition");
 }
-/** Conditions use own enumerable POJO fields, with predicate-brand and SQL-resolver symbols allowed. */
-function checkConditionKeys(value, allowed, description) {
+/**
+* Accepts only own enumerable POJO fields, so nothing a caller supplied can be silently ignored: the
+* compilers read these POJOs back with `Object.entries`/`Object.keys`, which skip inherited,
+* non-enumerable, and symbol keys, so a field hidden behind one of those would never reach the SQL.
+* I.e. an UPDATE whose `set` carries `title` on a prototype would leave `title` unchanged and still
+* report success.
+*
+* Conditions, mutation clauses, and assignment POJOs all share this rule; `allowed` may include symbol
+* keys, i.e. a condition's predicate brand and SQL resolver. Read-query clauses instead use
+* `validateQueryKeys`, which walks the prototype chain and reports mutation clauses by name.
+*/
+function checkPojoKeys(value, allowed, description) {
 	if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null) require_utils.fail(`${description} must be a plain POJO`);
 	for (const key of Reflect.ownKeys(value)) {
 		if (!allowed.includes(key)) require_utils.fail(`${description} does not support '${String(key)}'`);
@@ -1590,6 +1600,7 @@ function typedSql(strings, ...values) {
 //#endregion
 exports.Ctx = Ctx;
 exports.SubqueryHandle = SubqueryHandle;
+exports.checkPojoKeys = checkPojoKeys;
 exports.conditionToSql = conditionToSql;
 exports.entityQueryBrand = entityQueryBrand;
 exports.injectedConditions = injectedConditions;