@fragno-dev/db 0.0.1 → 0.1.0

package/dist/adapters/drizzle/drizzle-uow-compiler.js

@@ -0,0 +1,300 @@
+import { Column } from "../../schema/create.js";
+import { serialize } from "../../schema/serialize.js";
+import { decodeCursor, serializeCursorValues } from "../../query/cursor.js";
+import { buildCondition } from "../../query/condition-builder.js";
+import { sql } from "../../node_modules/.bun/drizzle-orm@0.44.6_4fae081eecb963e2/node_modules/drizzle-orm/sql/sql.js";
+import { and, eq, gt, gte, inArray, isNotNull, isNull, like, lt, lte, ne, not, notInArray, notLike, or } from "../../node_modules/.bun/drizzle-orm@0.44.6_4fae081eecb963e2/node_modules/drizzle-orm/sql/expressions/conditions.js";
+import { asc, desc } from "../../node_modules/.bun/drizzle-orm@0.44.6_4fae081eecb963e2/node_modules/drizzle-orm/sql/expressions/select.js";
+import { count } from "../../node_modules/.bun/drizzle-orm@0.44.6_4fae081eecb963e2/node_modules/drizzle-orm/sql/functions/aggregate.js";
+import { parseDrizzle } from "./shared.js";
+import { ReferenceSubquery, encodeValues } from "../../query/result-transform.js";
+import { getOrderedJoinColumns } from "./join-column-utils.js";
+
+//#region src/adapters/drizzle/drizzle-uow-compiler.ts
+/**
+* Create a Drizzle-specific Unit of Work compiler
+*
+* This compiler translates UOW operations into Drizzle query functions
+* that can be executed as a batch/transaction.
+*
+* @param schema - The database schema
+* @param config - Drizzle configuration
+* @param onQuery - Optional callback to receive compiled queries for logging/debugging
+* @returns A UOWCompiler instance for Drizzle
+*/
+function createDrizzleUOWCompiler(schema, config, onQuery) {
+	const [db, drizzleTables] = parseDrizzle(config.db);
+	const { provider } = config;
+	/**
+	* Convert a Fragno table to a Drizzle table
+	* @throws Error if table is not found in Drizzle schema
+	*/
+	function toDrizzleTable(table) {
+		const tableName = table.ormName;
+		const out = drizzleTables[tableName];
+		if (out) return out;
+		throw new Error(`[Drizzle] Unknown table name ${tableName}, is it included in your Drizzle schema?`);
+	}
+	/**
+	* Convert a Fragno column to a Drizzle column
+	* @throws Error if column is not found in Drizzle table
+	*/
+	function toDrizzleColumn(col) {
+		const fragnoTable = schema.tables[col.tableName];
+		if (!fragnoTable) throw new Error(`[Drizzle] Unknown table ${col.tableName} for column ${col.ormName}.`);
+		const out = toDrizzleTable(fragnoTable)[col.ormName];
+		if (out) return out;
+		throw new Error(`[Drizzle] Unknown column name ${col.ormName} in ${fragnoTable.ormName}.`);
+	}
+	/**
+	* Build a WHERE clause from a condition using Drizzle's query builder
+	*/
+	function buildWhere(condition) {
+		if (condition.type === "compare") {
+			const left = toDrizzleColumn(condition.a);
+			const op = condition.operator;
+			let right = condition.b;
+			if (right instanceof Column) right = toDrizzleColumn(right);
+			else right = serialize(right, condition.a, provider);
+			switch (op) {
+				case "=": return eq(left, right);
+				case "!=": return ne(left, right);
+				case ">": return gt(left, right);
+				case ">=": return gte(left, right);
+				case "<": return lt(left, right);
+				case "<=": return lte(left, right);
+				case "in": return inArray(left, right);
+				case "not in": return notInArray(left, right);
+				case "is": return right === null ? isNull(left) : eq(left, right);
+				case "is not": return right === null ? isNotNull(left) : ne(left, right);
+				case "contains":
+					right = typeof right === "string" ? `%${right}%` : sql`concat('%', ${right}, '%')`;
+					return like(left, right);
+				case "not contains":
+					right = typeof right === "string" ? `%${right}%` : sql`concat('%', ${right}, '%')`;
+					return notLike(left, right);
+				case "ends with":
+					right = typeof right === "string" ? `%${right}` : sql`concat('%', ${right})`;
+					return like(left, right);
+				case "not ends with":
+					right = typeof right === "string" ? `%${right}` : sql`concat('%', ${right})`;
+					return notLike(left, right);
+				case "starts with":
+					right = typeof right === "string" ? `${right}%` : sql`concat(${right}, '%')`;
+					return like(left, right);
+				case "not starts with":
+					right = typeof right === "string" ? `${right}%` : sql`concat(${right}, '%')`;
+					return notLike(left, right);
+				default: throw new Error(`Unsupported operator: ${op}`);
+			}
+		}
+		if (condition.type === "and") return and(...condition.items.map((item) => buildWhere(item)));
+		if (condition.type === "not") {
+			const result = buildWhere(condition.item);
+			if (!result) return;
+			return not(result);
+		}
+		return or(...condition.items.map((item) => buildWhere(item)));
+	}
+	/**
+	* Process reference subqueries in encoded values, converting them to Drizzle SQL subqueries
+	*/
+	function processReferenceSubqueries(values) {
+		const processed = {};
+		for (const [key, value] of Object.entries(values)) if (value instanceof ReferenceSubquery) {
+			const refTable = value.referencedTable;
+			const externalId = value.externalIdValue;
+			const internalIdCol = refTable.getInternalIdColumn();
+			const idCol = refTable.getIdColumn();
+			const drizzleRefTable = toDrizzleTable(refTable);
+			const drizzleIdCol = toDrizzleColumn(idCol);
+			processed[key] = db.select({ value: drizzleRefTable[internalIdCol.ormName] }).from(drizzleRefTable).where(eq(drizzleIdCol, externalId)).limit(1);
+		} else processed[key] = value;
+		return processed;
+	}
+	/**
+	* Get table from schema by name
+	* @throws Error if table is not found in schema
+	*/
+	function getTable(name) {
+		const table = schema.tables[name];
+		if (!table) throw new Error(`Invalid table name ${name}.`);
+		return table;
+	}
+	/**
+	* Get the version to check for a given ID and checkVersion flag.
+	* @returns The version to check or undefined if no check is required.
+	* @throws Error if the ID is a string and checkVersion is true.
+	*/
+	function getVersionToCheck(id, checkVersion) {
+		if (!checkVersion) return;
+		if (typeof id === "string") throw new Error(`Cannot use checkVersion with a string ID. Version checking requires a FragnoId with version information.`);
+		return id.version;
+	}
+	/**
+	* Process joins recursively to support nested joins with orderBy and limit
+	*/
+	function processJoins(joins) {
+		const result = {};
+		for (const join of joins) {
+			const { options, relation } = join;
+			if (!options) continue;
+			const targetTable = relation.table;
+			const joinName = relation.name;
+			const orderedColumns = getOrderedJoinColumns(targetTable, options.select === void 0 ? true : options.select);
+			const joinColumns = {};
+			for (const colName of orderedColumns) joinColumns[colName] = true;
+			let joinOrderBy;
+			if (options.orderBy && options.orderBy.length > 0) joinOrderBy = options.orderBy.map(([col, direction]) => {
+				const drizzleCol = toDrizzleColumn(col);
+				return direction === "asc" ? asc(drizzleCol) : desc(drizzleCol);
+			});
+			let joinWhere;
+			if (options.where) joinWhere = buildWhere(options.where);
+			const joinConfig = {
+				columns: joinColumns,
+				orderBy: joinOrderBy,
+				limit: options.limit,
+				where: joinWhere
+			};
+			if (options.join && options.join.length > 0) joinConfig.with = processJoins(options.join);
+			result[joinName] = joinConfig;
+		}
+		return result;
+	}
+	return {
+		compileRetrievalOperation(op) {
+			switch (op.type) {
+				case "count": {
+					let whereClause;
+					if (op.options.where) {
+						const condition = buildCondition(op.table.columns, op.options.where);
+						if (condition === false) return null;
+						if (condition !== true) whereClause = buildWhere(condition);
+					}
+					const drizzleTable = toDrizzleTable(op.table);
+					const query = db.select({ count: count() }).from(drizzleTable);
+					const compiledQuery = whereClause ? query.where(whereClause).toSQL() : query.toSQL();
+					onQuery?.(compiledQuery);
+					return compiledQuery;
+				}
+				case "find": {
+					const { useIndex: _useIndex, orderByIndex, joins, after, before, pageSize,...findOptions } = op.options;
+					let indexColumns = [];
+					let orderDirection = "asc";
+					if (orderByIndex) {
+						const index = op.table.indexes[orderByIndex.indexName];
+						orderDirection = orderByIndex.direction;
+						if (!index) if (orderByIndex.indexName === "_primary") indexColumns = [op.table.getIdColumn()];
+						else throw new Error(`Index "${orderByIndex.indexName}" not found on table "${op.table.name}"`);
+						else indexColumns = index.columns;
+					}
+					let orderBy;
+					if (indexColumns.length > 0) orderBy = indexColumns.map((col) => {
+						const drizzleCol = toDrizzleColumn(col);
+						return orderDirection === "asc" ? asc(drizzleCol) : desc(drizzleCol);
+					});
+					const columns = {};
+					const select = findOptions.select;
+					if (select === true || select === void 0) for (const col of Object.values(op.table.columns)) columns[col.ormName] = true;
+					else {
+						for (const k of select) columns[op.table.columns[k].ormName] = true;
+						for (const col of Object.values(op.table.columns)) if (col.isHidden && !columns[col.ormName]) columns[col.ormName] = true;
+					}
+					const whereClauses = [];
+					if (findOptions.where) {
+						const condition = buildCondition(op.table.columns, findOptions.where);
+						if (condition === false) return null;
+						if (condition !== true) {
+							const clause = buildWhere(condition);
+							if (clause) whereClauses.push(clause);
+						}
+					}
+					if ((after || before) && indexColumns.length > 0) {
+						const serializedValues = serializeCursorValues(decodeCursor(after || before), indexColumns, provider);
+						const isAfter = !!after;
+						const useGreaterThan = isAfter && orderDirection === "asc" || !isAfter && orderDirection === "desc";
+						if (indexColumns.length === 1) {
+							const col = toDrizzleColumn(indexColumns[0]);
+							const val = serializedValues[indexColumns[0].ormName];
+							whereClauses.push(useGreaterThan ? gt(col, val) : lt(col, val));
+						} else {
+							const drizzleCols = indexColumns.map((c) => toDrizzleColumn(c));
+							const vals = indexColumns.map((c) => serializedValues[c.ormName]);
+							const operator = useGreaterThan ? ">" : "<";
+							const colsSQL = sql.join(drizzleCols, sql.raw(", "));
+							const valsSQL = sql.join(vals.map((v) => sql`${v}`), sql.raw(", "));
+							whereClauses.push(sql`(${colsSQL}) ${sql.raw(operator)} (${valsSQL})`);
+						}
+					}
+					const queryConfig = {
+						columns,
+						limit: pageSize,
+						where: whereClauses.length > 0 ? and(...whereClauses) : void 0,
+						orderBy,
+						with: {}
+					};
+					if (joins) queryConfig.with = processJoins(joins);
+					const compiledQuery = db.query[op.table.ormName].findMany(queryConfig).toSQL();
+					onQuery?.(compiledQuery);
+					return compiledQuery;
+				}
+			}
+		},
+		compileMutationOperation(op) {
+			switch (op.type) {
+				case "create": {
+					const table = getTable(op.table);
+					const drizzleTable = toDrizzleTable(table);
+					const values = processReferenceSubqueries(encodeValues(op.values, table, true, provider));
+					const compiledQuery = db.insert(drizzleTable).values(values).toSQL();
+					onQuery?.(compiledQuery);
+					return {
+						query: compiledQuery,
+						expectedAffectedRows: null
+					};
+				}
+				case "update": {
+					const table = getTable(op.table);
+					const idColumn = table.getIdColumn();
+					const versionColumn = table.getVersionColumn();
+					const drizzleTable = toDrizzleTable(table);
+					const externalId = typeof op.id === "string" ? op.id : op.id.externalId;
+					const versionToCheck = getVersionToCheck(op.id, op.checkVersion);
+					const condition = versionToCheck !== void 0 ? buildCondition(table.columns, (eb) => eb.and(eb(idColumn.ormName, "=", externalId), eb(versionColumn.ormName, "=", versionToCheck))) : buildCondition(table.columns, (eb) => eb(idColumn.ormName, "=", externalId));
+					if (condition === false) return null;
+					const whereClause = condition === true ? void 0 : buildWhere(condition);
+					const setValues = processReferenceSubqueries(encodeValues(op.set, table, false, provider));
+					setValues[versionColumn.ormName] = sql.raw(`COALESCE(${versionColumn.ormName}, 0) + 1`);
+					const compiledQuery = db.update(drizzleTable).set(setValues).where(whereClause).toSQL();
+					onQuery?.(compiledQuery);
+					return {
+						query: compiledQuery,
+						expectedAffectedRows: op.checkVersion ? 1 : null
+					};
+				}
+				case "delete": {
+					const table = getTable(op.table);
+					const idColumn = table.getIdColumn();
+					const versionColumn = table.getVersionColumn();
+					const drizzleTable = toDrizzleTable(table);
+					const externalId = typeof op.id === "string" ? op.id : op.id.externalId;
+					const versionToCheck = getVersionToCheck(op.id, op.checkVersion);
+					const condition = versionToCheck !== void 0 ? buildCondition(table.columns, (eb) => eb.and(eb(idColumn.ormName, "=", externalId), eb(versionColumn.ormName, "=", versionToCheck))) : buildCondition(table.columns, (eb) => eb(idColumn.ormName, "=", externalId));
+					if (condition === false) return null;
+					const whereClause = condition === true ? void 0 : buildWhere(condition);
+					const compiledQuery = db.delete(drizzleTable).where(whereClause).toSQL();
+					onQuery?.(compiledQuery);
+					return {
+						query: compiledQuery,
+						expectedAffectedRows: op.checkVersion ? 1 : null
+					};
+				}
+			}
+		}
+	};
+}
+
+//#endregion
+export { createDrizzleUOWCompiler };
+//# sourceMappingURL=drizzle-uow-compiler.js.map

package/dist/adapters/drizzle/drizzle-uow-compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-uow-compiler.js","names":["Drizzle.eq","Drizzle.ne","Drizzle.gt","Drizzle.gte","Drizzle.lt","Drizzle.lte","Drizzle.inArray","Drizzle.notInArray","Drizzle.isNull","Drizzle.isNotNull","Drizzle.like","Drizzle.notLike","Drizzle.and","Drizzle.not","Drizzle.or","processed: Record<string, unknown>","result: Record<string, Drizzle.DBQueryConfig<\"many\", boolean>>","joinColumns: Record<string, boolean>","joinOrderBy: Drizzle.SQL[] | undefined","Drizzle.asc","Drizzle.desc","joinWhere: Drizzle.SQL | undefined","joinConfig: Drizzle.DBQueryConfig<\"many\", boolean>","whereClause: Drizzle.SQL | undefined","Drizzle.count","indexColumns: AnyColumn[]","orderDirection: \"asc\" | \"desc\"","orderBy: Drizzle.SQL[] | undefined","columns: Record<string, boolean>","whereClauses: Drizzle.SQL[]","queryConfig: Drizzle.DBQueryConfig<\"many\", boolean>"],"sources":["../../../src/adapters/drizzle/drizzle-uow-compiler.ts"],"sourcesContent":["import * as Drizzle from \"drizzle-orm\";\nimport type { AnyColumn, AnySchema, AnyTable, FragnoId } from \"../../schema/create\";\nimport { Column } from \"../../schema/create\";\nimport type {\n  CompiledMutation,\n  MutationOperation,\n  RetrievalOperation,\n  UOWCompiler,\n} from \"../../query/unit-of-work\";\nimport { buildCondition, type Condition } from \"../../query/condition-builder\";\nimport type { DrizzleConfig } from \"./drizzle-adapter\";\nimport { type ColumnType, type TableType, parseDrizzle } from \"./shared\";\nimport { encodeValues, ReferenceSubquery } from \"../../query/result-transform\";\nimport { serialize } from \"../../schema/serialize\";\nimport { decodeCursor, serializeCursorValues } from \"../../query/cursor\";\nimport type { CompiledJoin } from \"../../query/orm/orm\";\nimport { getOrderedJoinColumns } from \"./join-column-utils\";\n\nexport type DrizzleCompiledQuery = {\n  sql: string;\n  params: unknown[];\n};\n\n/**\n * Create a Drizzle-specific Unit of Work compiler\n *\n * This compiler translates UOW operations into Drizzle query functions\n * that can be executed as a batch/transaction.\n *\n * @param schema - The database schema\n * @param config - Drizzle configuration\n * @param onQuery - Optional callback to receive compiled queries for logging/debugging\n * @returns A UOWCompiler instance for Drizzle\n */\nexport function createDrizzleUOWCompiler<TSchema extends AnySchema>(\n  schema: TSchema,\n  config: DrizzleConfig,\n  onQuery?: (query: DrizzleCompiledQuery) => void,\n): UOWCompiler<TSchema, DrizzleCompiledQuery> {\n  const [db, drizzleTables] = parseDrizzle(config.db);\n  const { provider } = config;\n\n  /**\n   * Convert a Fragno table to a Drizzle table\n   * @throws Error if table is not found in Drizzle schema\n   */\n  function toDrizzleTable(table: AnyTable): TableType {\n    const tableName = table.ormName;\n    const out = drizzleTables[tableName];\n    if (out) {\n      return out;\n    }\n\n    throw new Error(\n      `[Drizzle] Unknown table name ${tableName}, is it included in your Drizzle schema?`,\n    );\n  }\n\n  /**\n   * Convert a Fragno column to a Drizzle column\n   * @throws Error if column is not found in Drizzle table\n   */\n  function toDrizzleColumn(col: AnyColumn): ColumnType {\n    const fragnoTable = schema.tables[col.tableName];\n    if (!fragnoTable) {\n      throw new Error(`[Drizzle] Unknown table ${col.tableName} for column ${col.ormName}.`);\n    }\n\n    const table = toDrizzleTable(fragnoTable);\n    const out = table[col.ormName];\n    if (out) {\n      return out;\n    }\n\n    throw new Error(`[Drizzle] Unknown column name ${col.ormName} in ${fragnoTable.ormName}.`);\n  }\n\n  /**\n   * Build a WHERE clause from a condition using Drizzle's query builder\n   */\n  function buildWhere(condition: Condition): Drizzle.SQL | undefined {\n    if (condition.type === \"compare\") {\n      const left = toDrizzleColumn(condition.a);\n      const op = condition.operator;\n      let right = condition.b;\n      if (right instanceof Column) {\n        right = toDrizzleColumn(right);\n      } else {\n        // Serialize non-Column values (e.g., FragnoId -> string, Date -> number for SQLite)\n        right = serialize(right, condition.a, provider);\n      }\n\n      switch (op) {\n        case \"=\":\n          return Drizzle.eq(left, right);\n        case \"!=\":\n          return Drizzle.ne(left, right);\n        case \">\":\n          return Drizzle.gt(left, right);\n        case \">=\":\n          return Drizzle.gte(left, right);\n        case \"<\":\n          return Drizzle.lt(left, right);\n        case \"<=\":\n          return Drizzle.lte(left, right);\n        case \"in\": {\n          return Drizzle.inArray(left, right as never[]);\n        }\n        case \"not in\":\n          return Drizzle.notInArray(left, right as never[]);\n        case \"is\":\n          return right === null ? Drizzle.isNull(left) : Drizzle.eq(left, right);\n        case \"is not\":\n          return right === null ? Drizzle.isNotNull(left) : Drizzle.ne(left, right);\n        case \"contains\": {\n          right =\n            typeof right === \"string\" ? `%${right}%` : Drizzle.sql`concat('%', ${right}, '%')`;\n          return Drizzle.like(left, right as string);\n        }\n        case \"not contains\": {\n          right =\n            typeof right === \"string\" ? `%${right}%` : Drizzle.sql`concat('%', ${right}, '%')`;\n          return Drizzle.notLike(left, right as string);\n        }\n        case \"ends with\": {\n          right = typeof right === \"string\" ? `%${right}` : Drizzle.sql`concat('%', ${right})`;\n          return Drizzle.like(left, right as string);\n        }\n        case \"not ends with\": {\n          right = typeof right === \"string\" ? `%${right}` : Drizzle.sql`concat('%', ${right})`;\n          return Drizzle.notLike(left, right as string);\n        }\n        case \"starts with\": {\n          right = typeof right === \"string\" ? `${right}%` : Drizzle.sql`concat(${right}, '%')`;\n          return Drizzle.like(left, right as string);\n        }\n        case \"not starts with\": {\n          right = typeof right === \"string\" ? `${right}%` : Drizzle.sql`concat(${right}, '%')`;\n          return Drizzle.notLike(left, right as string);\n        }\n\n        default:\n          throw new Error(`Unsupported operator: ${op}`);\n      }\n    }\n\n    if (condition.type === \"and\") {\n      return Drizzle.and(...condition.items.map((item) => buildWhere(item)));\n    }\n\n    if (condition.type === \"not\") {\n      const result = buildWhere(condition.item);\n      if (!result) return;\n\n      return Drizzle.not(result);\n    }\n\n    return Drizzle.or(...condition.items.map((item) => buildWhere(item)));\n  }\n\n  /**\n   * Process reference subqueries in encoded values, converting them to Drizzle SQL subqueries\n   */\n  function processReferenceSubqueries(values: Record<string, unknown>): Record<string, unknown> {\n    const processed: Record<string, unknown> = {};\n\n    for (const [key, value] of Object.entries(values)) {\n      if (value instanceof ReferenceSubquery) {\n        const refTable = value.referencedTable;\n        const externalId = value.externalIdValue;\n        const internalIdCol = refTable.getInternalIdColumn();\n        const idCol = refTable.getIdColumn();\n        const drizzleRefTable = toDrizzleTable(refTable);\n        const drizzleIdCol = toDrizzleColumn(idCol);\n\n        // Create a parameterized SQL subquery using Drizzle's query builder\n        // Safe cast: we're building a SQL subquery that returns a single bigint value\n        processed[key] = db\n          .select({ value: drizzleRefTable[internalIdCol.ormName] })\n          .from(drizzleRefTable)\n          .where(Drizzle.eq(drizzleIdCol, externalId))\n          .limit(1) as unknown;\n      } else {\n        processed[key] = value;\n      }\n    }\n\n    return processed;\n  }\n\n  /**\n   * Get table from schema by name\n   * @throws Error if table is not found in schema\n   */\n  function getTable(name: unknown): AnyTable {\n    const table = schema.tables[name as string];\n    if (!table) {\n      throw new Error(`Invalid table name ${name}.`);\n    }\n    return table;\n  }\n\n  /**\n   * Get the version to check for a given ID and checkVersion flag.\n   * @returns The version to check or undefined if no check is required.\n   * @throws Error if the ID is a string and checkVersion is true.\n   */\n  function getVersionToCheck(id: FragnoId | string, checkVersion: boolean): number | undefined {\n    if (!checkVersion) {\n      return undefined;\n    }\n\n    if (typeof id === \"string\") {\n      throw new Error(\n        `Cannot use checkVersion with a string ID. Version checking requires a FragnoId with version information.`,\n      );\n    }\n\n    return id.version;\n  }\n\n  /**\n   * Process joins recursively to support nested joins with orderBy and limit\n   */\n  function processJoins(\n    joins: CompiledJoin[],\n  ): Record<string, Drizzle.DBQueryConfig<\"many\", boolean>> {\n    const result: Record<string, Drizzle.DBQueryConfig<\"many\", boolean>> = {};\n\n    for (const join of joins) {\n      const { options, relation } = join;\n\n      if (!options) {\n        continue;\n      }\n\n      const targetTable = relation.table;\n      const joinName = relation.name;\n\n      // Build columns for this join using shared utility\n      const selectOption = options.select === undefined ? true : options.select;\n      const orderedColumns = getOrderedJoinColumns(targetTable, selectOption);\n      const joinColumns: Record<string, boolean> = {};\n      for (const colName of orderedColumns) {\n        joinColumns[colName] = true;\n      }\n\n      // Build orderBy for this join\n      let joinOrderBy: Drizzle.SQL[] | undefined;\n      if (options.orderBy && options.orderBy.length > 0) {\n        joinOrderBy = options.orderBy.map(([col, direction]) => {\n          const drizzleCol = toDrizzleColumn(col);\n          return direction === \"asc\" ? Drizzle.asc(drizzleCol) : Drizzle.desc(drizzleCol);\n        });\n      }\n\n      // Build WHERE clause for this join if provided\n      let joinWhere: Drizzle.SQL | undefined;\n      if (options.where) {\n        joinWhere = buildWhere(options.where);\n      }\n\n      // Build the join config\n      const joinConfig: Drizzle.DBQueryConfig<\"many\", boolean> = {\n        columns: joinColumns,\n        orderBy: joinOrderBy,\n        limit: options.limit,\n        where: joinWhere,\n      };\n\n      // Recursively process nested joins\n      if (options.join && options.join.length > 0) {\n        joinConfig.with = processJoins(options.join);\n      }\n\n      result[joinName] = joinConfig;\n    }\n\n    return result;\n  }\n\n  return {\n    compileRetrievalOperation(op: RetrievalOperation<TSchema>): DrizzleCompiledQuery | null {\n      switch (op.type) {\n        case \"count\": {\n          // Build WHERE clause\n          let whereClause: Drizzle.SQL | undefined;\n          if (op.options.where) {\n            const condition = buildCondition(op.table.columns, op.options.where);\n            if (condition === false) {\n              // Never matches - return null\n              return null;\n            }\n            if (condition !== true) {\n              whereClause = buildWhere(condition);\n            }\n          }\n\n          const drizzleTable = toDrizzleTable(op.table);\n          const query = db.select({ count: Drizzle.count() }).from(drizzleTable);\n\n          const compiledQuery = whereClause ? query.where(whereClause).toSQL() : query.toSQL();\n          onQuery?.(compiledQuery);\n          return compiledQuery;\n        }\n\n        case \"find\": {\n          const {\n            useIndex: _useIndex,\n            orderByIndex,\n            joins,\n            after,\n            before,\n            pageSize,\n            ...findOptions\n          } = op.options;\n\n          // Get index columns for ordering and cursor pagination\n          let indexColumns: AnyColumn[] = [];\n          let orderDirection: \"asc\" | \"desc\" = \"asc\";\n\n          if (orderByIndex) {\n            const index = op.table.indexes[orderByIndex.indexName];\n            orderDirection = orderByIndex.direction;\n\n            if (!index) {\n              // If _primary index doesn't exist, fall back to ID column\n              if (orderByIndex.indexName === \"_primary\") {\n                indexColumns = [op.table.getIdColumn()];\n              } else {\n                throw new Error(\n                  `Index \"${orderByIndex.indexName}\" not found on table \"${op.table.name}\"`,\n                );\n              }\n            } else {\n              indexColumns = index.columns;\n            }\n          }\n\n          // Convert orderByIndex to orderBy format\n          let orderBy: Drizzle.SQL[] | undefined;\n          if (indexColumns.length > 0) {\n            orderBy = indexColumns.map((col) => {\n              const drizzleCol = toDrizzleColumn(col);\n              return orderDirection === \"asc\" ? Drizzle.asc(drizzleCol) : Drizzle.desc(drizzleCol);\n            });\n          }\n\n          // Build query configuration\n          const columns: Record<string, boolean> = {};\n          const select = findOptions.select;\n\n          if (select === true || select === undefined) {\n            for (const col of Object.values(op.table.columns)) {\n              columns[col.ormName] = true;\n            }\n          } else {\n            for (const k of select) {\n              columns[op.table.columns[k].ormName] = true;\n            }\n            // Always include hidden columns (for FragnoId construction with internal ID and version)\n            for (const col of Object.values(op.table.columns)) {\n              if (col.isHidden && !columns[col.ormName]) {\n                columns[col.ormName] = true;\n              }\n            }\n          }\n\n          // Build WHERE clause with cursor conditions\n          const whereClauses: Drizzle.SQL[] = [];\n\n          // Add user-defined where clause\n          if (findOptions.where) {\n            const condition = buildCondition(op.table.columns, findOptions.where);\n            if (condition === false) {\n              // Never matches - return null to indicate this query should be skipped\n              return null;\n            }\n            if (condition !== true) {\n              const clause = buildWhere(condition);\n              if (clause) {\n                whereClauses.push(clause);\n              }\n            }\n          }\n\n          // Add cursor-based pagination conditions\n          if ((after || before) && indexColumns.length > 0) {\n            const cursor = after || before;\n            const cursorData = decodeCursor(cursor!);\n            const serializedValues = serializeCursorValues(cursorData, indexColumns, provider);\n\n            // Build tuple comparison for cursor pagination\n            // For \"after\" with \"asc\": (col1, col2, ...) > (val1, val2, ...)\n            // For \"before\" with \"desc\": reverse the comparison\n            const isAfter = !!after;\n            const useGreaterThan =\n              (isAfter && orderDirection === \"asc\") || (!isAfter && orderDirection === \"desc\");\n\n            if (indexColumns.length === 1) {\n              // Simple single-column case\n              const col = toDrizzleColumn(indexColumns[0]!);\n              const val = serializedValues[indexColumns[0]!.ormName];\n              whereClauses.push(useGreaterThan ? Drizzle.gt(col, val) : Drizzle.lt(col, val));\n            } else {\n              // Multi-column tuple comparison using SQL\n              const drizzleCols = indexColumns.map((c) => toDrizzleColumn(c));\n              const vals = indexColumns.map((c) => serializedValues[c.ormName]);\n              const operator = useGreaterThan ? \">\" : \"<\";\n              // Safe cast: building a SQL comparison expression for cursor pagination\n              // Build the tuple comparison: (col1, col2) > (val1, val2)\n              const colsSQL = Drizzle.sql.join(drizzleCols, Drizzle.sql.raw(\", \"));\n              const valsSQL = Drizzle.sql.join(\n                vals.map((v) => Drizzle.sql`${v}`),\n                Drizzle.sql.raw(\", \"),\n              );\n              whereClauses.push(\n                Drizzle.sql`(${colsSQL}) ${Drizzle.sql.raw(operator)} (${valsSQL})`,\n              );\n            }\n          }\n\n          const whereClause = whereClauses.length > 0 ? Drizzle.and(...whereClauses) : undefined;\n\n          const queryConfig: Drizzle.DBQueryConfig<\"many\", boolean> = {\n            columns,\n            limit: pageSize,\n            where: whereClause,\n            orderBy,\n            with: {},\n          };\n\n          // Process joins recursively to support nested joins\n          if (joins) {\n            queryConfig.with = processJoins(joins);\n          }\n\n          const compiledQuery = db.query[op.table.ormName].findMany(queryConfig).toSQL();\n          onQuery?.(compiledQuery);\n          return compiledQuery;\n        }\n      }\n    },\n\n    compileMutationOperation(\n      op: MutationOperation<TSchema>,\n    ): CompiledMutation<DrizzleCompiledQuery> | null {\n      switch (op.type) {\n        case \"create\": {\n          const table = getTable(op.table);\n          const drizzleTable = toDrizzleTable(table);\n          // encodeValues now handles runtime defaults automatically\n          const encodedValues = encodeValues(op.values, table, true, provider);\n          const values = processReferenceSubqueries(encodedValues);\n\n          const compiledQuery = db.insert(drizzleTable).values(values).toSQL();\n          onQuery?.(compiledQuery);\n          return {\n            query: compiledQuery,\n            expectedAffectedRows: null, // creates don't need affected row checks\n          };\n        }\n\n        case \"update\": {\n          const table = getTable(op.table);\n          const idColumn = table.getIdColumn();\n          const versionColumn = table.getVersionColumn();\n          const drizzleTable = toDrizzleTable(table);\n\n          const externalId = typeof op.id === \"string\" ? op.id : op.id.externalId;\n          const versionToCheck = getVersionToCheck(op.id, op.checkVersion);\n\n          // Build WHERE clause that filters by ID and optionally by version\n          const condition =\n            versionToCheck !== undefined\n              ? buildCondition(table.columns, (eb) =>\n                  eb.and(\n                    eb(idColumn.ormName, \"=\", externalId),\n                    eb(versionColumn.ormName, \"=\", versionToCheck),\n                  ),\n                )\n              : buildCondition(table.columns, (eb) => eb(idColumn.ormName, \"=\", externalId));\n\n          // Handle boolean cases\n          if (condition === false) {\n            // Never matches - skip this operation\n            return null;\n          }\n\n          const whereClause = condition === true ? undefined : buildWhere(condition);\n          const encodedSetValues = encodeValues(op.set, table, false, provider);\n          const setValues = processReferenceSubqueries(encodedSetValues);\n\n          // Automatically increment _version for optimistic concurrency control\n          // Safe cast: we're building a SQL expression for incrementing the version\n          setValues[versionColumn.ormName] = Drizzle.sql.raw(\n            `COALESCE(${versionColumn.ormName}, 0) + 1`,\n          ) as unknown;\n\n          const compiledQuery = db.update(drizzleTable).set(setValues).where(whereClause).toSQL();\n          onQuery?.(compiledQuery);\n          return {\n            query: compiledQuery,\n            expectedAffectedRows: op.checkVersion ? 1 : null,\n          };\n        }\n\n        case \"delete\": {\n          const table = getTable(op.table);\n          const idColumn = table.getIdColumn();\n          const versionColumn = table.getVersionColumn();\n          const drizzleTable = toDrizzleTable(table);\n\n          const externalId = typeof op.id === \"string\" ? op.id : op.id.externalId;\n          const versionToCheck = getVersionToCheck(op.id, op.checkVersion);\n\n          // Build WHERE clause that filters by ID and optionally by version\n          const condition =\n            versionToCheck !== undefined\n              ? buildCondition(table.columns, (eb) =>\n                  eb.and(\n                    eb(idColumn.ormName, \"=\", externalId),\n                    eb(versionColumn.ormName, \"=\", versionToCheck),\n                  ),\n                )\n              : buildCondition(table.columns, (eb) => eb(idColumn.ormName, \"=\", externalId));\n\n          // Handle boolean cases\n          if (condition === false) {\n            // Never matches - skip this operation\n            return null;\n          }\n\n          const whereClause = condition === true ? undefined : buildWhere(condition);\n\n          const compiledQuery = db.delete(drizzleTable).where(whereClause).toSQL();\n          onQuery?.(compiledQuery);\n          return {\n            query: compiledQuery,\n            expectedAffectedRows: op.checkVersion ? 1 : null,\n          };\n        }\n      }\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/adapters/drizzle/drizzle-uow-decoder.js

@@ -0,0 +1,82 @@
+import { decodeResult } from "../../query/result-transform.js";
+import { getOrderedJoinColumns } from "./join-column-utils.js";
+
+//#region src/adapters/drizzle/drizzle-uow-decoder.ts
+/**
+* Recursively transform join arrays to objects, handling nested joins.
+*
+* Drizzle joins use `json_build_array` where nested join data is appended after the parent's columns.
+* For example, if post has columns [id, title, content, _internalId, _version] and a nested author join,
+* the array will be: [id, title, content, _internalId, _version, authorArray]
+*
+* @param value - The join array from Drizzle
+* @param joinInfo - Join metadata including nested joins
+* @param relationName - Name of the current relation (for prefixing column names)
+* @returns Object with flattened keys (relationName:columnName) for all levels
+*/
+function transformJoinArray(value, joinInfo, relationName) {
+	const result = {};
+	if (joinInfo.options === false) return result;
+	const targetTable = joinInfo.relation.table;
+	const orderedSelectedColumns = getOrderedJoinColumns(targetTable, joinInfo.options.select);
+	for (let i = 0; i < orderedSelectedColumns.length && i < value.length; i++) {
+		const columnName = orderedSelectedColumns[i];
+		if (columnName) result[`${relationName}:${columnName}`] = value[i];
+	}
+	if (joinInfo.options.join && joinInfo.options.join.length > 0) {
+		let nestedArrayIndex = orderedSelectedColumns.length;
+		for (const nestedJoin of joinInfo.options.join) {
+			const nestedRelationName = `${relationName}:${nestedJoin.relation.name}`;
+			const nestedValue = value[nestedArrayIndex];
+			if (Array.isArray(nestedValue)) {
+				const nestedResult = transformJoinArray(nestedValue, nestedJoin, nestedRelationName);
+				Object.assign(result, nestedResult);
+			}
+			nestedArrayIndex++;
+		}
+	}
+	return result;
+}
+/**
+* Drizzle joins using `json_build_array` so the result is a tuple of values that we need to map to
+* the correct columns. This function handles nested joins recursively.
+*
+* @param row - Raw database result row that may contain join arrays
+* @param op - The retrieval operation containing join information
+* @returns Transformed row with join arrays converted to objects
+*/
+function transformJoinArraysToObjects(row, op) {
+	if (op.type !== "find" || !op.options?.joins) return row;
+	const transformedRow = { ...row };
+	for (const join of op.options.joins) {
+		const relationName = join.relation.name;
+		const value = row[relationName];
+		if (!Array.isArray(value)) continue;
+		if (join.options === false) continue;
+		if (!op.table.relations[relationName]) continue;
+		const joinResult = transformJoinArray(value, join, relationName);
+		Object.assign(transformedRow, joinResult);
+		delete transformedRow[relationName];
+	}
+	return transformedRow;
+}
+function createDrizzleUOWDecoder(_schema, provider) {
+	return (rawResults, ops) => {
+		if (rawResults.length !== ops.length) throw new Error("rawResults and ops must have the same length");
+		return rawResults.map((result, index) => {
+			const op = ops[index];
+			if (!op) throw new Error("op must be defined");
+			if (op.type === "count") {
+				if (result.rows.length > 0 && result.rows[0]) return result.rows[0]["count"];
+				return 0;
+			}
+			return result.rows.map((row) => {
+				return decodeResult(transformJoinArraysToObjects(row, op), op.table, provider);
+			});
+		});
+	};
+}
+
+//#endregion
+export { createDrizzleUOWDecoder };
+//# sourceMappingURL=drizzle-uow-decoder.js.map

package/dist/adapters/drizzle/drizzle-uow-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-uow-decoder.js","names":["result: Record<string, unknown>"],"sources":["../../../src/adapters/drizzle/drizzle-uow-decoder.ts"],"sourcesContent":["import type { AnySchema, AnyTable } from \"../../schema/create\";\nimport type { SQLProvider } from \"../../shared/providers\";\nimport type { RetrievalOperation, UOWDecoder } from \"../../query/unit-of-work\";\nimport { decodeResult } from \"../../query/result-transform\";\nimport type { DrizzleResult } from \"./drizzle-query\";\nimport { getOrderedJoinColumns } from \"./join-column-utils\";\n\n/**\n * Join information with nested join support\n */\ninterface JoinInfo {\n  relation: { name: string; table: AnyTable };\n  options:\n    | {\n        select: true | string[];\n        join?: JoinInfo[];\n      }\n    | false;\n}\n\n/**\n * Recursively transform join arrays to objects, handling nested joins.\n *\n * Drizzle joins use `json_build_array` where nested join data is appended after the parent's columns.\n * For example, if post has columns [id, title, content, _internalId, _version] and a nested author join,\n * the array will be: [id, title, content, _internalId, _version, authorArray]\n *\n * @param value - The join array from Drizzle\n * @param joinInfo - Join metadata including nested joins\n * @param relationName - Name of the current relation (for prefixing column names)\n * @returns Object with flattened keys (relationName:columnName) for all levels\n */\nfunction transformJoinArray(\n  value: unknown[],\n  joinInfo: JoinInfo,\n  relationName: string,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n\n  if (joinInfo.options === false) {\n    return result;\n  }\n\n  const targetTable = joinInfo.relation.table;\n\n  // Get ordered columns using shared utility (must match compiler's column order)\n  const orderedSelectedColumns = getOrderedJoinColumns(targetTable, joinInfo.options.select);\n\n  // Map column values to flattened format: relationName:columnName\n  for (let i = 0; i < orderedSelectedColumns.length && i < value.length; i++) {\n    const columnName = orderedSelectedColumns[i];\n    if (columnName) {\n      result[`${relationName}:${columnName}`] = value[i];\n    }\n  }\n\n  // Handle nested joins - they appear after all columns in the array\n  if (joinInfo.options.join && joinInfo.options.join.length > 0) {\n    let nestedArrayIndex = orderedSelectedColumns.length;\n\n    for (const nestedJoin of joinInfo.options.join) {\n      const nestedRelationName = `${relationName}:${nestedJoin.relation.name}`;\n      const nestedValue = value[nestedArrayIndex];\n\n      if (Array.isArray(nestedValue)) {\n        // Recursively transform nested join\n        const nestedResult = transformJoinArray(nestedValue, nestedJoin, nestedRelationName);\n        Object.assign(result, nestedResult);\n      }\n\n      nestedArrayIndex++;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Drizzle joins using `json_build_array` so the result is a tuple of values that we need to map to\n * the correct columns. This function handles nested joins recursively.\n *\n * @param row - Raw database result row that may contain join arrays\n * @param op - The retrieval operation containing join information\n * @returns Transformed row with join arrays converted to objects\n */\nfunction transformJoinArraysToObjects(\n  row: Record<string, unknown>,\n  op: {\n    type: string;\n    table: AnyTable;\n    options?: {\n      joins?: JoinInfo[];\n    };\n  },\n): Record<string, unknown> {\n  // Only process find operations with joins\n  if (op.type !== \"find\" || !op.options?.joins) {\n    return row;\n  }\n\n  const transformedRow = { ...row };\n\n  for (const join of op.options.joins) {\n    const relationName = join.relation.name;\n    const value = row[relationName];\n\n    // Skip if not an array (join didn't return data)\n    if (!Array.isArray(value)) {\n      continue;\n    }\n\n    // Skip if join options are false (join was disabled)\n    if (join.options === false) {\n      continue;\n    }\n\n    // Get the target table for this relation\n    const relation = op.table.relations[relationName];\n    if (!relation) {\n      continue;\n    }\n\n    // Recursively transform this join and its nested joins\n    const joinResult = transformJoinArray(value, join, relationName);\n    Object.assign(transformedRow, joinResult);\n\n    // Remove the original array property\n    delete transformedRow[relationName];\n  }\n\n  return transformedRow;\n}\n\nexport function createDrizzleUOWDecoder<TSchema extends AnySchema>(\n  _schema: TSchema,\n  provider: SQLProvider,\n): UOWDecoder<TSchema, DrizzleResult> {\n  return (rawResults, ops) => {\n    if (rawResults.length !== ops.length) {\n      throw new Error(\"rawResults and ops must have the same length\");\n    }\n\n    return rawResults.map((result, index) => {\n      const op = ops[index] as RetrievalOperation<TSchema>;\n      if (!op) {\n        throw new Error(\"op must be defined\");\n      }\n\n      // Handle count operations - return the count value directly\n      if (op.type === \"count\") {\n        if (result.rows.length > 0 && result.rows[0]) {\n          const row = result.rows[0];\n          return (row as Record<string, unknown>)[\"count\"] as number;\n        }\n        return 0;\n      }\n\n      // Handle find operations - decode each row\n      return result.rows.map((row) => {\n        const transformedRow = transformJoinArraysToObjects(row, op);\n        return decodeResult(transformedRow, op.table, provider);\n      });\n    });\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgCA,SAAS,mBACP,OACA,UACA,cACyB;CACzB,MAAMA,SAAkC,EAAE;AAE1C,KAAI,SAAS,YAAY,MACvB,QAAO;CAGT,MAAM,cAAc,SAAS,SAAS;CAGtC,MAAM,yBAAyB,sBAAsB,aAAa,SAAS,QAAQ,OAAO;AAG1F,MAAK,IAAI,IAAI,GAAG,IAAI,uBAAuB,UAAU,IAAI,MAAM,QAAQ,KAAK;EAC1E,MAAM,aAAa,uBAAuB;AAC1C,MAAI,WACF,QAAO,GAAG,aAAa,GAAG,gBAAgB,MAAM;;AAKpD,KAAI,SAAS,QAAQ,QAAQ,SAAS,QAAQ,KAAK,SAAS,GAAG;EAC7D,IAAI,mBAAmB,uBAAuB;AAE9C,OAAK,MAAM,cAAc,SAAS,QAAQ,MAAM;GAC9C,MAAM,qBAAqB,GAAG,aAAa,GAAG,WAAW,SAAS;GAClE,MAAM,cAAc,MAAM;AAE1B,OAAI,MAAM,QAAQ,YAAY,EAAE;IAE9B,MAAM,eAAe,mBAAmB,aAAa,YAAY,mBAAmB;AACpF,WAAO,OAAO,QAAQ,aAAa;;AAGrC;;;AAIJ,QAAO;;;;;;;;;;AAWT,SAAS,6BACP,KACA,IAOyB;AAEzB,KAAI,GAAG,SAAS,UAAU,CAAC,GAAG,SAAS,MACrC,QAAO;CAGT,MAAM,iBAAiB,EAAE,GAAG,KAAK;AAEjC,MAAK,MAAM,QAAQ,GAAG,QAAQ,OAAO;EACnC,MAAM,eAAe,KAAK,SAAS;EACnC,MAAM,QAAQ,IAAI;AAGlB,MAAI,CAAC,MAAM,QAAQ,MAAM,CACvB;AAIF,MAAI,KAAK,YAAY,MACnB;AAKF,MAAI,CADa,GAAG,MAAM,UAAU,cAElC;EAIF,MAAM,aAAa,mBAAmB,OAAO,MAAM,aAAa;AAChE,SAAO,OAAO,gBAAgB,WAAW;AAGzC,SAAO,eAAe;;AAGxB,QAAO;;AAGT,SAAgB,wBACd,SACA,UACoC;AACpC,SAAQ,YAAY,QAAQ;AAC1B,MAAI,WAAW,WAAW,IAAI,OAC5B,OAAM,IAAI,MAAM,+CAA+C;AAGjE,SAAO,WAAW,KAAK,QAAQ,UAAU;GACvC,MAAM,KAAK,IAAI;AACf,OAAI,CAAC,GACH,OAAM,IAAI,MAAM,qBAAqB;AAIvC,OAAI,GAAG,SAAS,SAAS;AACvB,QAAI,OAAO,KAAK,SAAS,KAAK,OAAO,KAAK,GAExC,QADY,OAAO,KAAK,GACgB;AAE1C,WAAO;;AAIT,UAAO,OAAO,KAAK,KAAK,QAAQ;AAE9B,WAAO,aADgB,6BAA6B,KAAK,GAAG,EACxB,GAAG,OAAO,SAAS;KACvD;IACF"}

package/dist/adapters/drizzle/drizzle-uow-executor.js

@@ -0,0 +1,125 @@
+import { SQL, StringChunk, sql } from "../../node_modules/.bun/drizzle-orm@0.44.6_4fae081eecb963e2/node_modules/drizzle-orm/sql/sql.js";
+
+//#region src/adapters/drizzle/drizzle-uow-executor.ts
+/**
+* Convert a DrizzleCompiledQuery (SQL string + params) to a Drizzle SQL object
+*
+* This reconstructs the SQL object with proper parameter chunks by parsing
+* the SQL string and replacing placeholders ($1, $2, etc.) with Param objects.
+* Uses Drizzle's exported classes (StringChunk, Param, SQL) to build the queryChunks.
+*/
+function toSQL(query) {
+	const { sql: sqlString, params } = query;
+	const placeholderRegex = /\$(\d+)/g;
+	const queryChunks = [];
+	let lastIndex = 0;
+	let match;
+	while ((match = placeholderRegex.exec(sqlString)) !== null) {
+		const textBefore = sqlString.substring(lastIndex, match.index);
+		if (textBefore) queryChunks.push(new StringChunk(textBefore));
+		const paramIndex = parseInt(match[1], 10) - 1;
+		queryChunks.push(sql.param(params[paramIndex]));
+		lastIndex = match.index + match[0].length;
+	}
+	const textAfter = sqlString.substring(lastIndex);
+	if (textAfter) queryChunks.push(new StringChunk(textAfter));
+	return new SQL(queryChunks);
+}
+/**
+* Get the number of affected rows from a Drizzle query result
+*/
+function getAffectedRows(result) {
+	if (Array.isArray(result)) return result.length;
+	if (result && typeof result === "object" && "affectedRows" in result && typeof result["affectedRows"] === "number") return result["affectedRows"];
+	if (result && typeof result === "object" && "rowCount" in result && (typeof result["rowCount"] === "number" || typeof result["rowCount"] === "bigint")) {
+		const rowCount = result["rowCount"];
+		if (rowCount > Number.MAX_SAFE_INTEGER) throw new Error(`rowCount BigInt value ${rowCount.toString()} exceeds JS safe integer range`);
+		return Number(rowCount);
+	}
+	if (result && typeof result === "object") {
+		if ("changes" in result && typeof result["changes"] === "number") return result["changes"];
+	}
+	throw new Error(`Unable to determine affected rows from result: ${JSON.stringify(result)}`);
+}
+/**
+* Execute the retrieval phase of a Unit of Work using Drizzle
+*
+* All retrieval queries are executed inside a single transaction to ensure
+* snapshot isolation - all reads see a consistent view of the database.
+*
+* @param db - The Drizzle database instance
+* @param retrievalBatch - Array of Drizzle SQL queries
+* @returns Array of query results matching the retrieval operations order
+*
+* @example
+* ```ts
+* const retrievalResults = await executeDrizzleRetrievalPhase(db, compiled.retrievalBatch);
+* const [users, posts] = retrievalResults;
+* ```
+*/
+async function executeDrizzleRetrievalPhase(db, retrievalBatch) {
+	if (retrievalBatch.length === 0) return [];
+	const retrievalResults = [];
+	await db.transaction(async (tx) => {
+		for (const query of retrievalBatch) {
+			const result = await tx.execute(toSQL(query));
+			retrievalResults.push(result);
+		}
+	});
+	return retrievalResults;
+}
+/**
+* Execute the mutation phase of a Unit of Work using Drizzle
+*
+* All mutation queries are executed in a transaction with optimistic locking.
+* If any version check fails, the entire transaction is rolled back and
+* success=false is returned.
+*
+* @param db - The Drizzle database instance
+* @param mutationBatch - Array of compiled mutation SQL queries with expected affected rows
+* @returns Object with success flag and internal IDs from create operations
+*
+* @example
+* ```ts
+* const { success } = await executeDrizzleMutationPhase(db, compiled.mutationBatch);
+* if (!success) {
+*   console.log("Version conflict detected, retrying...");
+* }
+* ```
+*/
+async function executeDrizzleMutationPhase(db, mutationBatch) {
+	if (mutationBatch.length === 0) return {
+		success: true,
+		createdInternalIds: []
+	};
+	const createdInternalIds = [];
+	try {
+		await db.transaction(async (tx) => {
+			for (const compiledMutation of mutationBatch) {
+				const result = await tx.execute(toSQL(compiledMutation.query));
+				if (compiledMutation.expectedAffectedRows === null) if (Array.isArray(result) && result.length > 0) {
+					const row = result[0];
+					if ("_internalId" in row || "_internal_id" in row) {
+						const internalId = row["_internalId"] ?? row["_internal_id"];
+						createdInternalIds.push(internalId);
+					} else createdInternalIds.push(null);
+				} else createdInternalIds.push(null);
+				else {
+					const affectedRows = getAffectedRows(result);
+					if (affectedRows !== compiledMutation.expectedAffectedRows) throw new Error(`Version conflict: expected ${compiledMutation.expectedAffectedRows} rows affected, but got ${affectedRows}`);
+				}
+			}
+		});
+		return {
+			success: true,
+			createdInternalIds
+		};
+	} catch (error) {
+		if (error instanceof Error && error.message.includes("Version conflict")) return { success: false };
+		throw error;
+	}
+}
+
+//#endregion
+export { executeDrizzleMutationPhase, executeDrizzleRetrievalPhase };
+//# sourceMappingURL=drizzle-uow-executor.js.map

package/dist/adapters/drizzle/drizzle-uow-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle-uow-executor.js","names":["queryChunks: SQLChunk[]","match: RegExpExecArray | null","retrievalResults: DrizzleResult[]","createdInternalIds: (bigint | null)[]"],"sources":["../../../src/adapters/drizzle/drizzle-uow-executor.ts"],"sourcesContent":["import { SQL, StringChunk, sql, type SQLChunk } from \"drizzle-orm\";\nimport type { CompiledMutation, MutationResult } from \"../../query/unit-of-work\";\nimport type { DBType } from \"./shared\";\nimport type { DrizzleCompiledQuery } from \"./drizzle-uow-compiler\";\nimport type { DrizzleResult } from \"./drizzle-query\";\n\n/**\n * Convert a DrizzleCompiledQuery (SQL string + params) to a Drizzle SQL object\n *\n * This reconstructs the SQL object with proper parameter chunks by parsing\n * the SQL string and replacing placeholders ($1, $2, etc.) with Param objects.\n * Uses Drizzle's exported classes (StringChunk, Param, SQL) to build the queryChunks.\n */\nfunction toSQL(query: DrizzleCompiledQuery): SQL {\n  const { sql: sqlString, params } = query;\n\n  // Match parameter placeholders like $1, $2, etc.\n  const placeholderRegex = /\\$(\\d+)/g;\n  const queryChunks: SQLChunk[] = [];\n  let lastIndex = 0;\n  let match: RegExpExecArray | null;\n\n  while ((match = placeholderRegex.exec(sqlString)) !== null) {\n    // Add the string chunk before the placeholder\n    const textBefore = sqlString.substring(lastIndex, match.index);\n    if (textBefore) {\n      queryChunks.push(new StringChunk(textBefore));\n    }\n\n    // Add the parameter value as a Param\n    const paramIndex = parseInt(match[1]!, 10) - 1; // $1 is index 0\n    queryChunks.push(sql.param(params[paramIndex]));\n\n    lastIndex = match.index + match[0].length;\n  }\n\n  // Add any remaining string after the last placeholder\n  const textAfter = sqlString.substring(lastIndex);\n  if (textAfter) {\n    queryChunks.push(new StringChunk(textAfter));\n  }\n\n  // Construct SQL object directly with queryChunks (same pattern as sql`` tagged template)\n  // Safe: We're reusing Drizzle's SQL constructor the same way the sql`` function does\n  return new SQL(queryChunks);\n}\n\n/**\n * Get the number of affected rows from a Drizzle query result\n */\nfunction getAffectedRows(result: unknown): number {\n  // Drizzle returns different formats depending on the database\n  // For MySQL: array with affectedRows property\n  // For PostgreSQL/SQLite: array with rowCount or similar\n  if (Array.isArray(result)) {\n    // This is likely a select/returning result\n    return result.length;\n  }\n\n  // Check for MySQL-style result\n  if (\n    result &&\n    typeof result === \"object\" &&\n    \"affectedRows\" in result &&\n    typeof result[\"affectedRows\"] === \"number\"\n  ) {\n    return result[\"affectedRows\"];\n  }\n\n  // Check for PostgreSQL-style result with rowCount\n  if (\n    result &&\n    typeof result === \"object\" &&\n    \"rowCount\" in result &&\n    (typeof result[\"rowCount\"] === \"number\" || typeof result[\"rowCount\"] === \"bigint\")\n  ) {\n    const rowCount = result[\"rowCount\"];\n    if (rowCount > Number.MAX_SAFE_INTEGER) {\n      throw new Error(`rowCount BigInt value ${rowCount.toString()} exceeds JS safe integer range`);\n    }\n    return Number(rowCount);\n  }\n\n  // For update/delete operations, Drizzle might return an object with affected rows info\n  // Try to extract it from common patterns\n  if (result && typeof result === \"object\") {\n    // Check for changes/changes count\n    if (\"changes\" in result && typeof result[\"changes\"] === \"number\") {\n      return result[\"changes\"];\n    }\n  }\n\n  throw new Error(`Unable to determine affected rows from result: ${JSON.stringify(result)}`);\n}\n\n/**\n * Execute the retrieval phase of a Unit of Work using Drizzle\n *\n * All retrieval queries are executed inside a single transaction to ensure\n * snapshot isolation - all reads see a consistent view of the database.\n *\n * @param db - The Drizzle database instance\n * @param retrievalBatch - Array of Drizzle SQL queries\n * @returns Array of query results matching the retrieval operations order\n *\n * @example\n * ```ts\n * const retrievalResults = await executeDrizzleRetrievalPhase(db, compiled.retrievalBatch);\n * const [users, posts] = retrievalResults;\n * ```\n */\nexport async function executeDrizzleRetrievalPhase(\n  db: DBType,\n  retrievalBatch: DrizzleCompiledQuery[],\n): Promise<DrizzleResult[]> {\n  // If no retrieval operations, return empty array immediately\n  if (retrievalBatch.length === 0) {\n    return [];\n  }\n\n  const retrievalResults: DrizzleResult[] = [];\n\n  // Execute all retrieval queries inside a transaction for snapshot isolation\n  await db.transaction(async (tx) => {\n    for (const query of retrievalBatch) {\n      const result = (await tx.execute(toSQL(query))) as DrizzleResult;\n      retrievalResults.push(result);\n    }\n  });\n\n  return retrievalResults;\n}\n\n/**\n * Execute the mutation phase of a Unit of Work using Drizzle\n *\n * All mutation queries are executed in a transaction with optimistic locking.\n * If any version check fails, the entire transaction is rolled back and\n * success=false is returned.\n *\n * @param db - The Drizzle database instance\n * @param mutationBatch - Array of compiled mutation SQL queries with expected affected rows\n * @returns Object with success flag and internal IDs from create operations\n *\n * @example\n * ```ts\n * const { success } = await executeDrizzleMutationPhase(db, compiled.mutationBatch);\n * if (!success) {\n *   console.log(\"Version conflict detected, retrying...\");\n * }\n * ```\n */\nexport async function executeDrizzleMutationPhase(\n  db: DBType,\n  mutationBatch: CompiledMutation<DrizzleCompiledQuery>[],\n): Promise<MutationResult> {\n  // If there are no mutations, return success immediately\n  if (mutationBatch.length === 0) {\n    return { success: true, createdInternalIds: [] };\n  }\n\n  const createdInternalIds: (bigint | null)[] = [];\n\n  // Execute mutation batch in a transaction\n  try {\n    await db.transaction(async (tx) => {\n      for (const compiledMutation of mutationBatch) {\n        const result = await tx.execute(toSQL(compiledMutation.query));\n\n        // For creates (expectedAffectedRows === null), try to extract internal ID\n        if (compiledMutation.expectedAffectedRows === null) {\n          // Check if result is an array with rows (RETURNING clause supported)\n          if (Array.isArray(result) && result.length > 0) {\n            const row = result[0] as Record<string, unknown>;\n            // Look for _internalId column in the returned row\n            if (\"_internalId\" in row || \"_internal_id\" in row) {\n              const internalId = (row[\"_internalId\"] ?? row[\"_internal_id\"]) as bigint;\n              createdInternalIds.push(internalId);\n            } else {\n              // RETURNING supported but _internalId not found\n              createdInternalIds.push(null);\n            }\n          } else {\n            // No RETURNING support (e.g., MySQL)\n            createdInternalIds.push(null);\n          }\n        } else {\n          // Check affected rows for updates/deletes\n          const affectedRows = getAffectedRows(result);\n\n          if (affectedRows !== compiledMutation.expectedAffectedRows) {\n            // Version conflict detected - the UPDATE/DELETE didn't affect the expected number of rows\n            // This means either the row doesn't exist or the version has changed\n            throw new Error(\n              `Version conflict: expected ${compiledMutation.expectedAffectedRows} rows affected, but got ${affectedRows}`,\n            );\n          }\n        }\n      }\n    });\n\n    return { success: true, createdInternalIds };\n  } catch (error) {\n    // Transaction failed - could be version conflict or other constraint violation\n    // Return success=false to indicate the UOW should be retried\n    if (error instanceof Error && error.message.includes(\"Version conflict\")) {\n      return { success: false };\n    }\n\n    // Other database errors should be thrown\n    throw error;\n  }\n}\n"],"mappings":";;;;;;;;;;AAaA,SAAS,MAAM,OAAkC;CAC/C,MAAM,EAAE,KAAK,WAAW,WAAW;CAGnC,MAAM,mBAAmB;CACzB,MAAMA,cAA0B,EAAE;CAClC,IAAI,YAAY;CAChB,IAAIC;AAEJ,SAAQ,QAAQ,iBAAiB,KAAK,UAAU,MAAM,MAAM;EAE1D,MAAM,aAAa,UAAU,UAAU,WAAW,MAAM,MAAM;AAC9D,MAAI,WACF,aAAY,KAAK,IAAI,YAAY,WAAW,CAAC;EAI/C,MAAM,aAAa,SAAS,MAAM,IAAK,GAAG,GAAG;AAC7C,cAAY,KAAK,IAAI,MAAM,OAAO,YAAY,CAAC;AAE/C,cAAY,MAAM,QAAQ,MAAM,GAAG;;CAIrC,MAAM,YAAY,UAAU,UAAU,UAAU;AAChD,KAAI,UACF,aAAY,KAAK,IAAI,YAAY,UAAU,CAAC;AAK9C,QAAO,IAAI,IAAI,YAAY;;;;;AAM7B,SAAS,gBAAgB,QAAyB;AAIhD,KAAI,MAAM,QAAQ,OAAO,CAEvB,QAAO,OAAO;AAIhB,KACE,UACA,OAAO,WAAW,YAClB,kBAAkB,UAClB,OAAO,OAAO,oBAAoB,SAElC,QAAO,OAAO;AAIhB,KACE,UACA,OAAO,WAAW,YAClB,cAAc,WACb,OAAO,OAAO,gBAAgB,YAAY,OAAO,OAAO,gBAAgB,WACzE;EACA,MAAM,WAAW,OAAO;AACxB,MAAI,WAAW,OAAO,iBACpB,OAAM,IAAI,MAAM,yBAAyB,SAAS,UAAU,CAAC,gCAAgC;AAE/F,SAAO,OAAO,SAAS;;AAKzB,KAAI,UAAU,OAAO,WAAW,UAE9B;MAAI,aAAa,UAAU,OAAO,OAAO,eAAe,SACtD,QAAO,OAAO;;AAIlB,OAAM,IAAI,MAAM,kDAAkD,KAAK,UAAU,OAAO,GAAG;;;;;;;;;;;;;;;;;;AAmB7F,eAAsB,6BACpB,IACA,gBAC0B;AAE1B,KAAI,eAAe,WAAW,EAC5B,QAAO,EAAE;CAGX,MAAMC,mBAAoC,EAAE;AAG5C,OAAM,GAAG,YAAY,OAAO,OAAO;AACjC,OAAK,MAAM,SAAS,gBAAgB;GAClC,MAAM,SAAU,MAAM,GAAG,QAAQ,MAAM,MAAM,CAAC;AAC9C,oBAAiB,KAAK,OAAO;;GAE/B;AAEF,QAAO;;;;;;;;;;;;;;;;;;;;;AAsBT,eAAsB,4BACpB,IACA,eACyB;AAEzB,KAAI,cAAc,WAAW,EAC3B,QAAO;EAAE,SAAS;EAAM,oBAAoB,EAAE;EAAE;CAGlD,MAAMC,qBAAwC,EAAE;AAGhD,KAAI;AACF,QAAM,GAAG,YAAY,OAAO,OAAO;AACjC,QAAK,MAAM,oBAAoB,eAAe;IAC5C,MAAM,SAAS,MAAM,GAAG,QAAQ,MAAM,iBAAiB,MAAM,CAAC;AAG9D,QAAI,iBAAiB,yBAAyB,KAE5C,KAAI,MAAM,QAAQ,OAAO,IAAI,OAAO,SAAS,GAAG;KAC9C,MAAM,MAAM,OAAO;AAEnB,SAAI,iBAAiB,OAAO,kBAAkB,KAAK;MACjD,MAAM,aAAc,IAAI,kBAAkB,IAAI;AAC9C,yBAAmB,KAAK,WAAW;WAGnC,oBAAmB,KAAK,KAAK;UAI/B,oBAAmB,KAAK,KAAK;SAE1B;KAEL,MAAM,eAAe,gBAAgB,OAAO;AAE5C,SAAI,iBAAiB,iBAAiB,qBAGpC,OAAM,IAAI,MACR,8BAA8B,iBAAiB,qBAAqB,0BAA0B,eAC/F;;;IAIP;AAEF,SAAO;GAAE,SAAS;GAAM;GAAoB;UACrC,OAAO;AAGd,MAAI,iBAAiB,SAAS,MAAM,QAAQ,SAAS,mBAAmB,CACtE,QAAO,EAAE,SAAS,OAAO;AAI3B,QAAM"}