@fragno-dev/db 0.1.11 → 0.1.13

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

@@ -1,3 +1,4 @@
+import { createCursorFromRecord } from "../../query/cursor.js";
 import { decodeResult } from "../../query/result-transform.js";
 import { getOrderedJoinColumns } from "./join-column-utils.js";
 
@@ -80,9 +81,32 @@ function createDrizzleUOWDecoder(_schema, provider) {
 				}
 				return 0;
 			}
-			return result.rows.map((row) => {
+			const decodedRows = result.rows.map((row) => {
 				return decodeResult(transformJoinArraysToObjects(row, op, provider), op.table, provider);
 			});
+			if (op.withCursor) {
+				let cursor;
+				if (decodedRows.length > 0 && op.options.orderByIndex && op.options.pageSize) {
+					const lastItem = decodedRows[decodedRows.length - 1];
+					const indexName = op.options.orderByIndex.indexName;
+					let indexColumns;
+					if (indexName === "_primary") indexColumns = [op.table.getIdColumn()];
+					else {
+						const index$1 = op.table.indexes[indexName];
+						if (index$1) indexColumns = index$1.columns;
+					}
+					if (indexColumns && lastItem) cursor = createCursorFromRecord(lastItem, indexColumns, {
+						indexName: op.options.orderByIndex.indexName,
+						orderDirection: op.options.orderByIndex.direction,
+						pageSize: op.options.pageSize
+					});
+				}
+				return {
+					items: decodedRows,
+					cursor
+				};
+			}
+			return decodedRows;
 		});
 	};
 }

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

@@ -1 +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 { getOrderedJoinColumns } from \"./join-column-utils\";\nimport type { DrizzleResult } from \"./shared\";\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  provider: SQLProvider,\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    let value = row[relationName];\n\n    // For SQLite, json_array returns a JSON string that needs to be parsed\n    if (provider === \"sqlite\" && typeof value === \"string\") {\n      try {\n        value = JSON.parse(value) as unknown;\n      } catch {\n        // If parsing fails, skip this join\n        continue;\n      }\n    }\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] as Record<string, unknown>;\n          const countValue = row[\"count\"] ?? row[\"count(*)\"];\n\n          if (typeof countValue !== \"number\") {\n            throw new Error(`Unexpected result for count, received: ${countValue}`);\n          }\n\n          return countValue;\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, provider);\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,IAOA,UACyB;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,IAAI,QAAQ,IAAI;AAGhB,MAAI,aAAa,YAAY,OAAO,UAAU,SAC5C,KAAI;AACF,WAAQ,KAAK,MAAM,MAAM;UACnB;AAEN;;AAKJ,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,IAAI;KAC5C,MAAM,MAAM,OAAO,KAAK;KACxB,MAAM,aAAa,IAAI,YAAY,IAAI;AAEvC,SAAI,OAAO,eAAe,SACxB,OAAM,IAAI,MAAM,0CAA0C,aAAa;AAGzE,YAAO;;AAET,WAAO;;AAIT,UAAO,OAAO,KAAK,KAAK,QAAQ;AAE9B,WAAO,aADgB,6BAA6B,KAAK,IAAI,SAAS,EAClC,GAAG,OAAO,SAAS;KACvD;IACF"}
+{"version":3,"file":"drizzle-uow-decoder.js","names":["result: Record<string, unknown>","cursor: Cursor | undefined","index"],"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 { getOrderedJoinColumns } from \"./join-column-utils\";\nimport type { DrizzleResult } from \"./shared\";\nimport { createCursorFromRecord, Cursor, type CursorResult } from \"../../query/cursor\";\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  provider: SQLProvider,\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    let value = row[relationName];\n\n    // For SQLite, json_array returns a JSON string that needs to be parsed\n    if (provider === \"sqlite\" && typeof value === \"string\") {\n      try {\n        value = JSON.parse(value) as unknown;\n      } catch {\n        // If parsing fails, skip this join\n        continue;\n      }\n    }\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] as Record<string, unknown>;\n          const countValue = row[\"count\"] ?? row[\"count(*)\"];\n\n          if (typeof countValue !== \"number\") {\n            throw new Error(`Unexpected result for count, received: ${countValue}`);\n          }\n\n          return countValue;\n        }\n        return 0;\n      }\n\n      // Handle find operations - decode each row\n      const decodedRows = result.rows.map((row) => {\n        const transformedRow = transformJoinArraysToObjects(row, op, provider);\n        return decodeResult(transformedRow, op.table, provider);\n      });\n\n      // If cursor generation is requested, wrap in CursorResult\n      if (op.withCursor) {\n        let cursor: Cursor | undefined;\n\n        // Generate cursor from last item if results exist\n        if (decodedRows.length > 0 && op.options.orderByIndex && op.options.pageSize) {\n          const lastItem = decodedRows[decodedRows.length - 1];\n          const indexName = op.options.orderByIndex.indexName;\n\n          // Get index columns\n          let indexColumns;\n          if (indexName === \"_primary\") {\n            indexColumns = [op.table.getIdColumn()];\n          } else {\n            const index = op.table.indexes[indexName];\n            if (index) {\n              indexColumns = index.columns;\n            }\n          }\n\n          if (indexColumns && lastItem) {\n            cursor = createCursorFromRecord(lastItem as Record<string, unknown>, indexColumns, {\n              indexName: op.options.orderByIndex.indexName,\n              orderDirection: op.options.orderByIndex.direction,\n              pageSize: op.options.pageSize,\n            });\n          }\n        }\n\n        const cursorResult: CursorResult<unknown> = {\n          items: decodedRows,\n          cursor,\n        };\n        return cursorResult;\n      }\n\n      return decodedRows;\n    });\n  };\n}\n"],"mappings":"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"}

package/dist/adapters/drizzle/generate.js

@@ -1,6 +1,6 @@
 import { InternalIdColumn } from "../../schema/create.js";
-import { SETTINGS_TABLE_NAME, settingsSchema } from "../../shared/settings-schema.js";
 import { schemaToDBType } from "../../schema/serialize.js";
+import { SETTINGS_TABLE_NAME, settingsSchema } from "../../shared/settings-schema.js";
 import { importGenerator } from "../../util/import-generator.js";
 import { ident, parseVarchar } from "../../util/parse.js";
 import { createTableNameMapper, sanitizeNamespace } from "./shared.js";

package/dist/adapters/kysely/kysely-adapter.d.ts

@@ -1,8 +1,9 @@
 import { AnySchema } from "../../schema/create.js";
 import { Migrator } from "../../migration-engine/create.js";
+import { SQLProvider } from "../../shared/providers.js";
 import { AbstractQuery } from "../../query/query.js";
 import { DatabaseAdapter, fragnoDatabaseAdapterNameFakeSymbol, fragnoDatabaseAdapterVersionFakeSymbol } from "../adapters.js";
-import { SQLProvider } from "../../shared/providers.js";
+import { KyselyUOWConfig } from "./kysely-query.js";
 import { Kysely } from "kysely";
 
 //#region src/adapters/kysely/kysely-adapter.d.ts
@@ -11,13 +12,13 @@ interface KyselyConfig {
   db: KyselyAny | (() => KyselyAny | Promise<KyselyAny>);
   provider: SQLProvider;
 }
-declare class KyselyAdapter implements DatabaseAdapter {
+declare class KyselyAdapter implements DatabaseAdapter<KyselyUOWConfig> {
   #private;
   constructor(config: KyselyConfig);
   get [fragnoDatabaseAdapterNameFakeSymbol](): string;
   get [fragnoDatabaseAdapterVersionFakeSymbol](): number;
   close(): Promise<void>;
-  createQueryEngine<T extends AnySchema>(schema: T, namespace: string): AbstractQuery<T>;
+  createQueryEngine<T extends AnySchema>(schema: T, namespace: string): AbstractQuery<T, KyselyUOWConfig>;
   isConnectionHealthy(): Promise<boolean>;
   createMigrationEngine(schema: AnySchema, namespace: string): Migrator;
   getSchemaVersion(namespace: string): Promise<string | undefined>;

package/dist/adapters/kysely/kysely-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kysely-adapter.d.ts","names":[],"sources":["../../../src/adapters/kysely/kysely-adapter.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAoBK,SAAA,GAAY;UAEA,YAAA;EAFZ,EAAA,EAGC,SAHQ,GAAA,CAAA,GAAA,GAGW,SAHF,GAGc,OAHd,CAGsB,SAHtB,CAAA,CAAA;EAEN,QAAA,EAEL,WAFiB;;AACJ,cAIZ,aAAA,YAAyB,eAJb,CAAA;EAAoB,CAAA,OAAA;EAAR,WAAA,CAAA,MAAA,EAQf,YARe;EACzB,KAYL,mCAAA,GAZK,EAAA,MAAA;EAAW,KAgBhB,sCAAA,GAhBgB,EAAA,MAAA;EAGV,KAAA,CAAA,CAAA,EAiBI,OAjBU,CAAA,IAAA,CAAA;EAIL,iBAAA,CAAA,UAiBQ,SAjBR,CAAA,CAAA,MAAA,EAiB2B,CAjB3B,EAAA,SAAA,EAAA,MAAA,CAAA,EAiBkD,aAjBlD,CAiBgE,CAjBhE,CAAA;EAKf,mBAAA,CAAA,CAAA,EAkBwB,OAlBxB,CAAA,OAAA,CAAA;EAIA,qBAAA,CAAA,MAAA,EA0ByB,SA1BzB,EAAA,SAAA,EAAA,MAAA,CAAA,EA0BwD,QA1BxD;EAIU,gBAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EAgJ4B,OAhJ5B,CAAA,MAAA,GAAA,SAAA,CAAA"}
+{"version":3,"file":"kysely-adapter.d.ts","names":[],"sources":["../../../src/adapters/kysely/kysely-adapter.ts"],"sourcesContent":[],"mappings":";;;;;;;;;KAoBK,SAAA,GAAY;UAEA,YAAA;EAFZ,EAAA,EAGC,SAHQ,GAAA,CAAA,GAAA,GAGW,SAHF,GAGc,OAHd,CAGsB,SAHtB,CAAA,CAAA;EAEN,QAAA,EAEL,WAFiB;;AACJ,cAIZ,aAAA,YAAyB,eAJb,CAI6B,eAJ7B,CAAA,CAAA;EAAoB,CAAA,OAAA;EAAR,WAAA,CAAA,MAAA,EAQf,YARe;EACzB,KAYL,mCAAA,GAZK,EAAA,MAAA;EAAW,KAgBhB,sCAAA,GAhBgB,EAAA,MAAA;EAGV,KAAA,CAAA,CAAA,EAiBI,OAjBU,CAAA,IAAA,CAAA;EAA2B,iBAAA,CAAA,UAqBxB,SArBwB,CAAA,CAAA,MAAA,EAsB1C,CAtB0C,EAAA,SAAA,EAAA,MAAA,CAAA,EAwBjD,aAxBiD,CAwBnC,CAxBmC,EAwBhC,eAxBgC,CAAA;EAIhC,mBAAA,CAAA,CAAA,EA0BS,OA1BT,CAAA,OAAA,CAAA;EAKf,qBAAA,CAAA,MAAA,EAiCyB,SAjCzB,EAAA,SAAA,EAAA,MAAA,CAAA,EAiCwD,QAjCxD;EAIA,gBAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EAuJsC,OAvJtC,CAAA,MAAA,GAAA,SAAA,CAAA"}

package/dist/adapters/kysely/kysely-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"kysely-adapter.js","names":["#connectionPool","#provider","db","config: KyselyConfig","parts: string[]"],"sources":["../../../src/adapters/kysely/kysely-adapter.ts"],"sourcesContent":["import { sql, type Kysely } from \"kysely\";\nimport type { SQLProvider } from \"../../shared/providers\";\nimport {\n  fragnoDatabaseAdapterNameFakeSymbol,\n  fragnoDatabaseAdapterVersionFakeSymbol,\n  type DatabaseAdapter,\n} from \"../adapters\";\nimport { createMigrator, type Migrator } from \"../../migration-engine/create\";\nimport type { AnySchema } from \"../../schema/create\";\nimport type { CustomOperation, MigrationOperation } from \"../../migration-engine/shared\";\nimport { execute, preprocessOperations } from \"./migration/execute\";\nimport type { AbstractQuery } from \"../../query/query\";\nimport { fromKysely } from \"./kysely-query\";\nimport { createTableNameMapper } from \"./kysely-shared\";\nimport { createHash } from \"node:crypto\";\nimport { SETTINGS_TABLE_NAME } from \"../../shared/settings-schema\";\nimport type { ConnectionPool } from \"../../shared/connection-pool\";\nimport { createKyselyConnectionPool } from \"./kysely-connection-pool\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype KyselyAny = Kysely<any>;\n\nexport interface KyselyConfig {\n  db: KyselyAny | (() => KyselyAny | Promise<KyselyAny>);\n  provider: SQLProvider;\n}\n\nexport class KyselyAdapter implements DatabaseAdapter {\n  #connectionPool: ConnectionPool<KyselyAny>;\n  #provider: SQLProvider;\n\n  constructor(config: KyselyConfig) {\n    this.#connectionPool = createKyselyConnectionPool(config.db);\n    this.#provider = config.provider;\n  }\n\n  get [fragnoDatabaseAdapterNameFakeSymbol](): string {\n    return \"kysely\";\n  }\n\n  get [fragnoDatabaseAdapterVersionFakeSymbol](): number {\n    return 0;\n  }\n\n  async close(): Promise<void> {\n    await this.#connectionPool.close();\n  }\n\n  createQueryEngine<T extends AnySchema>(schema: T, namespace: string): AbstractQuery<T> {\n    // Only create mapper if namespace is non-empty\n    const mapper = namespace ? createTableNameMapper(namespace) : undefined;\n    return fromKysely(schema, this.#connectionPool, this.#provider, mapper);\n  }\n\n  async isConnectionHealthy(): Promise<boolean> {\n    const conn = await this.#connectionPool.connect();\n    try {\n      const result = await conn.db.executeQuery(sql`SELECT 1 as healthy`.compile(conn.db));\n      return (result.rows[0] as Record<string, unknown>)[\"healthy\"] === 1;\n    } catch {\n      return false;\n    } finally {\n      await conn.release();\n    }\n  }\n\n  createMigrationEngine(schema: AnySchema, namespace: string): Migrator {\n    const mapper = namespace ? createTableNameMapper(namespace) : undefined;\n\n    const preprocessMigrationOperations = (operations: MigrationOperation[], db: KyselyAny) => {\n      // Preprocess operations using the provided db instance\n      const config: KyselyConfig = {\n        db,\n        provider: this.#provider,\n      };\n      let preprocessed = preprocessOperations(operations, config);\n\n      if (this.#provider === \"mysql\") {\n        preprocessed.unshift({ type: \"custom\", sql: \"SET FOREIGN_KEY_CHECKS = 0\" });\n        preprocessed.push({ type: \"custom\", sql: \"SET FOREIGN_KEY_CHECKS = 1\" });\n      }\n\n      return preprocessed;\n    };\n\n    // Convert operations to executable nodes bound to specific db instance\n    const toExecutableNodes = (operations: MigrationOperation[], db: KyselyAny) => {\n      const onCustomNode = (node: CustomOperation, db: KyselyAny) => {\n        const statement = sql.raw(node[\"sql\"] as string);\n\n        return {\n          compile() {\n            return statement.compile(db);\n          },\n          execute() {\n            return statement.execute(db);\n          },\n        };\n      };\n\n      const config: KyselyConfig = { db, provider: this.#provider };\n      return operations.flatMap((op) =>\n        execute(op, config, (node) => onCustomNode(node, db), mapper),\n      );\n    };\n\n    const migrator = createMigrator({\n      schema,\n      executor: async (operations) => {\n        const conn = await this.#connectionPool.connect();\n        try {\n          // For SQLite, execute PRAGMA defer_foreign_keys BEFORE transaction\n          if (this.#provider === \"sqlite\") {\n            await sql.raw(\"PRAGMA defer_foreign_keys = ON\").execute(conn.db);\n          }\n\n          await conn.db.transaction().execute(async (tx) => {\n            // Use the transaction instance for both preprocessing and execution\n            const preprocessed = preprocessMigrationOperations(operations, tx);\n            const nodes = toExecutableNodes(preprocessed, tx);\n            for (const node of nodes) {\n              try {\n                await node.execute();\n              } catch (e) {\n                console.error(\"failed at\", node.compile(), e);\n                throw e;\n              }\n            }\n          });\n        } finally {\n          await conn.release();\n        }\n      },\n      sql: {\n        toSql: (operations) => {\n          const parts: string[] = [];\n\n          // Add SQLite PRAGMA at the beginning\n          if (this.#provider === \"sqlite\") {\n            parts.push(\"PRAGMA defer_foreign_keys = ON;\");\n          }\n\n          // Use getDatabaseSync for SQL generation (doesn't execute, just builds SQL strings)\n          const db = this.#connectionPool.getDatabaseSync();\n          const preprocessed = preprocessMigrationOperations(operations, db);\n          const nodes = toExecutableNodes(preprocessed, db);\n          const compiled = nodes.map((node) => `${node.compile().sql};`);\n\n          parts.push(...compiled);\n\n          return parts.join(\"\\n\\n\");\n        },\n      },\n\n      settings: {\n        getVersion: async () => {\n          const conn = await this.#connectionPool.connect();\n          try {\n            const manager = createSettingsManager(conn.db, namespace);\n            const v = await manager.get(`schema_version`);\n            return v ? parseInt(v) : 0;\n          } finally {\n            await conn.release();\n          }\n        },\n        updateSettingsInMigration: async (fromVersion, toVersion) => {\n          const conn = await this.#connectionPool.connect();\n          try {\n            const manager = createSettingsManager(conn.db, namespace);\n            return [\n              {\n                type: \"custom\",\n                sql:\n                  fromVersion === 0\n                    ? manager.insert(`schema_version`, toVersion.toString())\n                    : manager.update(`schema_version`, toVersion.toString()),\n              },\n            ];\n          } finally {\n            await conn.release();\n          }\n        },\n      },\n    });\n\n    return migrator;\n  }\n\n  async getSchemaVersion(namespace: string): Promise<string | undefined> {\n    const conn = await this.#connectionPool.connect();\n    try {\n      const manager = createSettingsManager(conn.db, namespace);\n      return await manager.get(`schema_version`);\n    } finally {\n      await conn.release();\n    }\n  }\n}\n\nfunction createSettingsManager(db: KyselyAny, namespace: string) {\n  // Settings table is never namespaced, but keys include namespace prefix\n  const tableName = SETTINGS_TABLE_NAME;\n\n  return {\n    async get(key: string): Promise<string | undefined> {\n      try {\n        const result = await db\n          .selectFrom(tableName)\n          .where(\"key\", \"=\", sql.lit(`${namespace}.${key}`))\n          .select([\"value\"])\n          .executeTakeFirstOrThrow();\n        return result.value as string;\n      } catch {\n        return;\n      }\n    },\n\n    insert(key: string, value: string) {\n      return db\n        .insertInto(tableName)\n        .values({\n          id: sql.lit(\n            createHash(\"md5\").update(`${namespace}.${key}`).digest(\"base64url\").replace(/=/g, \"\"),\n          ),\n          key: sql.lit(`${namespace}.${key}`),\n          value: sql.lit(value),\n        })\n        .compile().sql;\n    },\n\n    update(key: string, value: string) {\n      return db\n        .updateTable(tableName)\n        .set({\n          value: sql.lit(value),\n        })\n        .where(\"key\", \"=\", sql.lit(`${namespace}.${key}`))\n        .compile().sql;\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"kysely-adapter.js","names":["#connectionPool","#provider","db","config: KyselyConfig","parts: string[]"],"sources":["../../../src/adapters/kysely/kysely-adapter.ts"],"sourcesContent":["import { sql, type Kysely } from \"kysely\";\nimport type { SQLProvider } from \"../../shared/providers\";\nimport {\n  fragnoDatabaseAdapterNameFakeSymbol,\n  fragnoDatabaseAdapterVersionFakeSymbol,\n  type DatabaseAdapter,\n} from \"../adapters\";\nimport { createMigrator, type Migrator } from \"../../migration-engine/create\";\nimport type { AnySchema } from \"../../schema/create\";\nimport type { CustomOperation, MigrationOperation } from \"../../migration-engine/shared\";\nimport { execute, preprocessOperations } from \"./migration/execute\";\nimport type { AbstractQuery } from \"../../query/query\";\nimport { fromKysely, type KyselyUOWConfig } from \"./kysely-query\";\nimport { createTableNameMapper } from \"./kysely-shared\";\nimport { createHash } from \"node:crypto\";\nimport { SETTINGS_TABLE_NAME } from \"../../shared/settings-schema\";\nimport type { ConnectionPool } from \"../../shared/connection-pool\";\nimport { createKyselyConnectionPool } from \"./kysely-connection-pool\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype KyselyAny = Kysely<any>;\n\nexport interface KyselyConfig {\n  db: KyselyAny | (() => KyselyAny | Promise<KyselyAny>);\n  provider: SQLProvider;\n}\n\nexport class KyselyAdapter implements DatabaseAdapter<KyselyUOWConfig> {\n  #connectionPool: ConnectionPool<KyselyAny>;\n  #provider: SQLProvider;\n\n  constructor(config: KyselyConfig) {\n    this.#connectionPool = createKyselyConnectionPool(config.db);\n    this.#provider = config.provider;\n  }\n\n  get [fragnoDatabaseAdapterNameFakeSymbol](): string {\n    return \"kysely\";\n  }\n\n  get [fragnoDatabaseAdapterVersionFakeSymbol](): number {\n    return 0;\n  }\n\n  async close(): Promise<void> {\n    await this.#connectionPool.close();\n  }\n\n  createQueryEngine<T extends AnySchema>(\n    schema: T,\n    namespace: string,\n  ): AbstractQuery<T, KyselyUOWConfig> {\n    // Only create mapper if namespace is non-empty\n    const mapper = namespace ? createTableNameMapper(namespace) : undefined;\n    return fromKysely(schema, this.#connectionPool, this.#provider, mapper);\n  }\n\n  async isConnectionHealthy(): Promise<boolean> {\n    const conn = await this.#connectionPool.connect();\n    try {\n      const result = await conn.db.executeQuery(sql`SELECT 1 as healthy`.compile(conn.db));\n      return (result.rows[0] as Record<string, unknown>)[\"healthy\"] === 1;\n    } catch {\n      return false;\n    } finally {\n      await conn.release();\n    }\n  }\n\n  createMigrationEngine(schema: AnySchema, namespace: string): Migrator {\n    const mapper = namespace ? createTableNameMapper(namespace) : undefined;\n\n    const preprocessMigrationOperations = (operations: MigrationOperation[], db: KyselyAny) => {\n      // Preprocess operations using the provided db instance\n      const config: KyselyConfig = {\n        db,\n        provider: this.#provider,\n      };\n      let preprocessed = preprocessOperations(operations, config);\n\n      if (this.#provider === \"mysql\") {\n        preprocessed.unshift({ type: \"custom\", sql: \"SET FOREIGN_KEY_CHECKS = 0\" });\n        preprocessed.push({ type: \"custom\", sql: \"SET FOREIGN_KEY_CHECKS = 1\" });\n      }\n\n      return preprocessed;\n    };\n\n    // Convert operations to executable nodes bound to specific db instance\n    const toExecutableNodes = (operations: MigrationOperation[], db: KyselyAny) => {\n      const onCustomNode = (node: CustomOperation, db: KyselyAny) => {\n        const statement = sql.raw(node[\"sql\"] as string);\n\n        return {\n          compile() {\n            return statement.compile(db);\n          },\n          execute() {\n            return statement.execute(db);\n          },\n        };\n      };\n\n      const config: KyselyConfig = { db, provider: this.#provider };\n      return operations.flatMap((op) =>\n        execute(op, config, (node) => onCustomNode(node, db), mapper),\n      );\n    };\n\n    const migrator = createMigrator({\n      schema,\n      executor: async (operations) => {\n        const conn = await this.#connectionPool.connect();\n        try {\n          // For SQLite, execute PRAGMA defer_foreign_keys BEFORE transaction\n          if (this.#provider === \"sqlite\") {\n            await sql.raw(\"PRAGMA defer_foreign_keys = ON\").execute(conn.db);\n          }\n\n          await conn.db.transaction().execute(async (tx) => {\n            // Use the transaction instance for both preprocessing and execution\n            const preprocessed = preprocessMigrationOperations(operations, tx);\n            const nodes = toExecutableNodes(preprocessed, tx);\n            for (const node of nodes) {\n              try {\n                await node.execute();\n              } catch (e) {\n                console.error(\"failed at\", node.compile(), e);\n                throw e;\n              }\n            }\n          });\n        } finally {\n          await conn.release();\n        }\n      },\n      sql: {\n        toSql: (operations) => {\n          const parts: string[] = [];\n\n          // Add SQLite PRAGMA at the beginning\n          if (this.#provider === \"sqlite\") {\n            parts.push(\"PRAGMA defer_foreign_keys = ON;\");\n          }\n\n          // Use getDatabaseSync for SQL generation (doesn't execute, just builds SQL strings)\n          const db = this.#connectionPool.getDatabaseSync();\n          const preprocessed = preprocessMigrationOperations(operations, db);\n          const nodes = toExecutableNodes(preprocessed, db);\n          const compiled = nodes.map((node) => `${node.compile().sql};`);\n\n          parts.push(...compiled);\n\n          return parts.join(\"\\n\\n\");\n        },\n      },\n\n      settings: {\n        getVersion: async () => {\n          const conn = await this.#connectionPool.connect();\n          try {\n            const manager = createSettingsManager(conn.db, namespace);\n            const v = await manager.get(`schema_version`);\n            return v ? parseInt(v) : 0;\n          } finally {\n            await conn.release();\n          }\n        },\n        updateSettingsInMigration: async (fromVersion, toVersion) => {\n          const conn = await this.#connectionPool.connect();\n          try {\n            const manager = createSettingsManager(conn.db, namespace);\n            return [\n              {\n                type: \"custom\",\n                sql:\n                  fromVersion === 0\n                    ? manager.insert(`schema_version`, toVersion.toString())\n                    : manager.update(`schema_version`, toVersion.toString()),\n              },\n            ];\n          } finally {\n            await conn.release();\n          }\n        },\n      },\n    });\n\n    return migrator;\n  }\n\n  async getSchemaVersion(namespace: string): Promise<string | undefined> {\n    const conn = await this.#connectionPool.connect();\n    try {\n      const manager = createSettingsManager(conn.db, namespace);\n      return await manager.get(`schema_version`);\n    } finally {\n      await conn.release();\n    }\n  }\n}\n\nfunction createSettingsManager(db: KyselyAny, namespace: string) {\n  // Settings table is never namespaced, but keys include namespace prefix\n  const tableName = SETTINGS_TABLE_NAME;\n\n  return {\n    async get(key: string): Promise<string | undefined> {\n      try {\n        const result = await db\n          .selectFrom(tableName)\n          .where(\"key\", \"=\", sql.lit(`${namespace}.${key}`))\n          .select([\"value\"])\n          .executeTakeFirstOrThrow();\n        return result.value as string;\n      } catch {\n        return;\n      }\n    },\n\n    insert(key: string, value: string) {\n      return db\n        .insertInto(tableName)\n        .values({\n          id: sql.lit(\n            createHash(\"md5\").update(`${namespace}.${key}`).digest(\"base64url\").replace(/=/g, \"\"),\n          ),\n          key: sql.lit(`${namespace}.${key}`),\n          value: sql.lit(value),\n        })\n        .compile().sql;\n    },\n\n    update(key: string, value: string) {\n      return db\n        .updateTable(tableName)\n        .set({\n          value: sql.lit(value),\n        })\n        .where(\"key\", \"=\", sql.lit(`${namespace}.${key}`))\n        .compile().sql;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/adapters/kysely/kysely-query.d.ts

@@ -0,0 +1,22 @@
+import { CompiledQuery, Kysely } from "kysely";
+
+//#region src/adapters/kysely/kysely-query.d.ts
+
+/**
+ * Configuration options for creating a Kysely Unit of Work
+ */
+interface KyselyUOWConfig {
+  /**
+   * Optional callback to receive compiled SQL queries for logging/debugging
+   * This callback is invoked for each query as it's compiled
+   */
+  onQuery?: (query: CompiledQuery) => void;
+  /**
+   * If true, the query will not be executed and the query will be returned. Not respected for UOWs
+   * since those have to be manually executed.
+   */
+  dryRun?: boolean;
+}
+//#endregion
+export { KyselyUOWConfig };
+//# sourceMappingURL=kysely-query.d.ts.map

package/dist/adapters/kysely/kysely-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-query.d.ts","names":[],"sources":["../../../src/adapters/kysely/kysely-query.ts"],"sourcesContent":[],"mappings":";;;;;;;UAwBiB,eAAA;;;;;oBAKG"}

package/dist/adapters/kysely/kysely-query.js

@@ -1,3 +1,4 @@
+import { createCursorFromRecord } from "../../query/cursor.js";
 import { UnitOfWork } from "../../query/unit-of-work.js";
 import { decodeResult } from "../../query/result-transform.js";
 import { createKyselyUOWCompiler } from "./kysely-uow-compiler.js";
@@ -5,6 +6,30 @@ import { executeKyselyMutationPhase, executeKyselyRetrievalPhase } from "./kysel
 
 //#region src/adapters/kysely/kysely-query.ts
 /**
+* Special builder for updateMany operations that captures configuration
+*/
+var UpdateManySpecialBuilder = class {
+	#indexName;
+	#condition;
+	#setValues;
+	whereIndex(indexName, condition) {
+		this.#indexName = indexName;
+		this.#condition = condition;
+		return this;
+	}
+	set(values) {
+		this.#setValues = values;
+		return this;
+	}
+	getConfig() {
+		return {
+			indexName: this.#indexName,
+			condition: this.#condition,
+			setValues: this.#setValues
+		};
+	}
+};
+/**
 * Creates a Kysely-based query engine for the given schema.
 *
 * This is the main entry point for creating a database query interface using Kysely.
@@ -28,11 +53,12 @@ import { executeKyselyMutationPhase, executeKyselyRetrievalPhase } from "./kysel
 * });
 * ```
 */
-function fromKysely(schema, pool, provider, mapper) {
-	function createUOW(name) {
+function fromKysely(schema, pool, provider, mapper, uowConfig) {
+	function createUOW(opts) {
 		const uowCompiler = createKyselyUOWCompiler(schema, pool, provider, mapper);
 		const executor = {
 			async executeRetrievalPhase(retrievalBatch) {
+				if (opts.config?.dryRun) return retrievalBatch.map(() => []);
 				const conn = await pool.connect();
 				try {
 					return await executeKyselyRetrievalPhase(conn.db, retrievalBatch);
@@ -41,6 +67,10 @@ function fromKysely(schema, pool, provider, mapper) {
 				}
 			},
 			async executeMutationPhase(mutationBatch) {
+				if (opts.config?.dryRun) return {
+					success: true,
+					createdInternalIds: mutationBatch.map(() => null)
+				};
 				const conn = await pool.connect();
 				try {
 					return await executeKyselyMutationPhase(conn.db, mutationBatch);
@@ -61,107 +91,127 @@ function fromKysely(schema, pool, provider, mapper) {
 					if (Number.isNaN(count)) throw new Error(`Unexpected result for count, received: ${count}`);
 					return count;
 				}
-				return rows.map((row) => decodeResult(row, op.table, provider));
+				const decodedRows = rows.map((row) => decodeResult(row, op.table, provider));
+				if (op.withCursor) {
+					let cursor;
+					if (decodedRows.length > 0 && op.options.orderByIndex && op.options.pageSize) {
+						const lastItem = decodedRows[decodedRows.length - 1];
+						const indexName = op.options.orderByIndex.indexName;
+						let indexColumns;
+						if (indexName === "_primary") indexColumns = [op.table.getIdColumn()];
+						else {
+							const index$1 = op.table.indexes[indexName];
+							if (index$1) indexColumns = index$1.columns;
+						}
+						if (indexColumns && lastItem) cursor = createCursorFromRecord(lastItem, indexColumns, {
+							indexName: op.options.orderByIndex.indexName,
+							orderDirection: op.options.orderByIndex.direction,
+							pageSize: op.options.pageSize
+						});
+					}
+					return {
+						items: decodedRows,
+						cursor
+					};
+				}
+				return decodedRows;
 			});
 		};
-		return new UnitOfWork(schema, uowCompiler, executor, decoder, name);
+		const { onQuery,...restUowConfig } = opts.config ?? {};
+		return new UnitOfWork(schema, uowCompiler, executor, decoder, opts.name, {
+			...restUowConfig,
+			onQuery: (query) => {
+				const actualQuery = query && typeof query === "object" && "expectedAffectedRows" in query ? query.query : query;
+				opts.config?.onQuery?.(actualQuery);
+			}
+		});
 	}
 	return {
 		async find(tableName, builderFn) {
-			const uow = createUOW();
+			const uow = createUOW({ config: uowConfig });
 			uow.find(tableName, builderFn);
 			const [result] = await uow.executeRetrieve();
 			return result ?? [];
 		},
+		async findWithCursor(tableName, builderFn) {
+			const [result] = await createUOW({ config: uowConfig }).findWithCursor(tableName, builderFn).executeRetrieve();
+			return result;
+		},
 		async findFirst(tableName, builderFn) {
-			const uow = createUOW();
-			if (builderFn) uow.find(tableName, (b) => builderFn(b).pageSize(1));
+			const uow = createUOW({ config: uowConfig });
+			if (builderFn) uow.find(tableName, (b) => {
+				builderFn(b);
+				return b.pageSize(1);
+			});
 			else uow.find(tableName, (b) => b.whereIndex("primary").pageSize(1));
 			const [result] = await uow.executeRetrieve();
 			return result?.[0] ?? null;
 		},
 		async create(tableName, values) {
-			const uow = createUOW();
+			const uow = createUOW({ config: uowConfig });
 			uow.create(tableName, values);
 			const { success } = await uow.executeMutations();
 			if (!success) throw new Error("Failed to create record");
-			const [createdId] = uow.getCreatedIds();
+			const createdId = uow.getCreatedIds()[0];
 			if (!createdId) throw new Error("Failed to get created ID");
 			return createdId;
 		},
 		async createMany(tableName, valuesArray) {
-			const uow = createUOW();
+			const uow = createUOW({ config: uowConfig });
 			for (const values of valuesArray) uow.create(tableName, values);
 			const { success } = await uow.executeMutations();
 			if (!success) throw new Error("Failed to create records");
 			return uow.getCreatedIds();
 		},
 		async update(tableName, id, builderFn) {
-			const uow = createUOW();
+			const uow = createUOW({ config: uowConfig });
 			uow.update(tableName, id, builderFn);
 			const { success } = await uow.executeMutations();
 			if (!success) throw new Error("Failed to update record (version conflict or record not found)");
 		},
 		async updateMany(tableName, builderFn) {
-			let whereConfig = {};
-			let setValues;
-			builderFn({
-				whereIndex(indexName, condition) {
-					whereConfig = {
-						indexName,
-						condition
-					};
-					return this;
-				},
-				set(values) {
-					setValues = values;
-					return this;
-				}
-			});
-			if (!whereConfig.indexName) throw new Error("whereIndex() must be called in updateMany");
+			if (!schema.tables[tableName]) throw new Error(`Table ${tableName} not found in schema`);
+			const specialBuilder = new UpdateManySpecialBuilder();
+			builderFn(specialBuilder);
+			const { indexName, condition, setValues } = specialBuilder.getConfig();
+			if (!indexName) throw new Error("whereIndex() must be called in updateMany");
 			if (!setValues) throw new Error("set() must be called in updateMany");
-			const findUow = createUOW();
+			const findUow = createUOW({ config: uowConfig });
 			findUow.find(tableName, (b) => {
-				if (whereConfig.condition) return b.whereIndex(whereConfig.indexName, whereConfig.condition);
-				return b.whereIndex(whereConfig.indexName);
+				if (condition) return b.whereIndex(indexName, condition);
+				return b.whereIndex(indexName);
 			});
-			const records = (await findUow.executeRetrieve())[0];
+			const [records] = await findUow.executeRetrieve();
 			if (!records || records.length === 0) return;
-			const updateUow = createUOW();
+			const updateUow = createUOW({ config: uowConfig });
 			for (const record of records) updateUow.update(tableName, record.id, (b) => b.set(setValues));
 			const { success } = await updateUow.executeMutations();
 			if (!success) throw new Error("Failed to update records (version conflict)");
 		},
 		async delete(tableName, id, builderFn) {
-			const uow = createUOW();
+			const uow = createUOW({ config: uowConfig });
 			uow.delete(tableName, id, builderFn);
 			const { success } = await uow.executeMutations();
 			if (!success) throw new Error("Failed to delete record (version conflict or record not found)");
 		},
 		async deleteMany(tableName, builderFn) {
-			let whereConfig = {};
-			builderFn({ whereIndex(indexName, condition) {
-				whereConfig = {
-					indexName,
-					condition
-				};
-				return this;
-			} });
-			if (!whereConfig.indexName) throw new Error("whereIndex() must be called in deleteMany");
-			const findUow = createUOW();
-			findUow.find(tableName, (b) => {
-				if (whereConfig.condition) return b.whereIndex(whereConfig.indexName, whereConfig.condition);
-				return b.whereIndex(whereConfig.indexName);
-			});
-			const records = (await findUow.executeRetrieve())[0];
+			const findUow = createUOW({ config: uowConfig });
+			findUow.find(tableName, builderFn);
+			const [records] = await findUow.executeRetrieve();
 			if (!records || records.length === 0) return;
-			const deleteUow = createUOW();
+			const deleteUow = createUOW({ config: uowConfig });
 			for (const record of records) deleteUow.delete(tableName, record.id);
 			const { success } = await deleteUow.executeMutations();
 			if (!success) throw new Error("Failed to delete records (version conflict)");
 		},
-		createUnitOfWork(name) {
-			return createUOW(name);
+		createUnitOfWork(name, nestedUowConfig) {
+			return createUOW({
+				name,
+				config: {
+					...uowConfig,
+					...nestedUowConfig
+				}
+			});
 		}
 	};
 }

package/dist/adapters/kysely/kysely-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"kysely-query.js","names":["executor: UOWExecutor<CompiledQuery, unknown>","decoder: UOWDecoder<T>","whereConfig: { indexName?: string; condition?: unknown }","setValues: unknown"],"sources":["../../../src/adapters/kysely/kysely-query.ts"],"sourcesContent":["import type { AbstractQuery } from \"../../query/query\";\nimport type { AnySchema } from \"../../schema/create\";\nimport type { CompiledMutation, UOWDecoder, UOWExecutor } from \"../../query/unit-of-work\";\nimport { decodeResult } from \"../../query/result-transform\";\nimport { createKyselyUOWCompiler } from \"./kysely-uow-compiler\";\nimport { executeKyselyRetrievalPhase, executeKyselyMutationPhase } from \"./kysely-uow-executor\";\nimport { UnitOfWork } from \"../../query/unit-of-work\";\nimport type { CompiledQuery, Kysely } from \"kysely\";\nimport type { TableNameMapper } from \"./kysely-shared\";\nimport type { ConnectionPool } from \"../../shared/connection-pool\";\nimport type { SQLProvider } from \"../../shared/providers\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype KyselyAny = Kysely<any>;\n\n/**\n * Creates a Kysely-based query engine for the given schema.\n *\n * This is the main entry point for creating a database query interface using Kysely.\n * It uses a compiler-based architecture where queries are compiled to SQL and then executed,\n * enabling features like SQL snapshot testing.\n *\n * @param schema - The database schema definition\n * @param pool - Connection pool for acquiring database connections\n * @param provider - SQL provider (postgresql, mysql, sqlite, etc.)\n * @param mapper - Optional table name mapper for namespace prefixing\n * @returns An AbstractQuery instance for performing database operations\n *\n * @example\n * ```ts\n * const pool = createSimpleConnectionPool(kysely);\n * const queryEngine = fromKysely(mySchema, pool, 'postgresql');\n *\n * const users = await queryEngine.findMany('users', {\n *   where: (b) => b('age', '>', 18),\n *   orderBy: [['name', 'asc']]\n * });\n * ```\n */\nexport function fromKysely<T extends AnySchema>(\n  schema: T,\n  pool: ConnectionPool<KyselyAny>,\n  provider: SQLProvider,\n  mapper?: TableNameMapper,\n): AbstractQuery<T> {\n  function createUOW(name?: string): UnitOfWork<T, []> {\n    const uowCompiler = createKyselyUOWCompiler(schema, pool, provider, mapper);\n\n    const executor: UOWExecutor<CompiledQuery, unknown> = {\n      async executeRetrievalPhase(retrievalBatch: CompiledQuery[]) {\n        const conn = await pool.connect();\n        try {\n          return await executeKyselyRetrievalPhase(conn.db, retrievalBatch);\n        } finally {\n          await conn.release();\n        }\n      },\n      async executeMutationPhase(mutationBatch: CompiledMutation<CompiledQuery>[]) {\n        const conn = await pool.connect();\n        try {\n          return await executeKyselyMutationPhase(conn.db, mutationBatch);\n        } finally {\n          await conn.release();\n        }\n      },\n    };\n\n    // Create a decoder function to transform raw results into application format\n    const decoder: UOWDecoder<T> = (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((rows, index) => {\n        const op = ops[index];\n        if (!op) {\n          throw new Error(\"op must be defined\");\n        }\n\n        // Handle count operations differently - return the count number directly\n        if (op.type === \"count\") {\n          const rowArray = rows as Record<string, unknown>[];\n          const firstRow = rowArray[0];\n          if (!firstRow) {\n            return 0;\n          }\n          const count = Number(firstRow[\"count\"]);\n          if (Number.isNaN(count)) {\n            throw new Error(`Unexpected result for count, received: ${count}`);\n          }\n          return count;\n        }\n\n        // Each result is an array of rows - decode each row\n        const rowArray = rows as Record<string, unknown>[];\n        return rowArray.map((row) => decodeResult(row, op.table, provider));\n      });\n    };\n\n    return new UnitOfWork(schema, uowCompiler, executor, decoder, name);\n  }\n\n  return {\n    async find(tableName, builderFn) {\n      const uow = createUOW();\n      uow.find(tableName, builderFn);\n      // executeRetrieve returns an array of results (one per find operation)\n      // Since we only have one find, unwrap the first result\n      const [result]: unknown[][] = await uow.executeRetrieve();\n      return result ?? [];\n    },\n\n    async findFirst(tableName, builderFn) {\n      const uow = createUOW();\n      if (builderFn) {\n        uow.find(tableName, (b) => builderFn(b as never).pageSize(1));\n      } else {\n        uow.find(tableName, (b) => b.whereIndex(\"primary\").pageSize(1));\n      }\n      // executeRetrieve runs an array of `find` operation results, which each return an array of rows\n      const [result]: unknown[][] = await uow.executeRetrieve();\n      return result?.[0] ?? null;\n    },\n\n    async create(tableName, values) {\n      const uow = createUOW();\n      uow.create(tableName, values);\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        // This should not happen because we don't `.check()` this call.\n        // TODO: Verify what happens when there are unique constraints\n        throw new Error(\"Failed to create record\");\n      }\n\n      const [createdId] = uow.getCreatedIds();\n      if (!createdId) {\n        throw new Error(\"Failed to get created ID\");\n      }\n      return createdId;\n    },\n\n    async createMany(tableName, valuesArray) {\n      const uow = createUOW();\n      for (const values of valuesArray) {\n        uow.create(tableName, values);\n      }\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to create records\");\n      }\n\n      return uow.getCreatedIds();\n    },\n\n    async update(tableName, id, builderFn) {\n      const uow = createUOW();\n      uow.update(tableName, id, builderFn as never);\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to update record (version conflict or record not found)\");\n      }\n    },\n\n    async updateMany(tableName, builderFn) {\n      // Create a special builder that captures both where and set operations\n      let whereConfig: { indexName?: string; condition?: unknown } = {};\n      let setValues: unknown;\n\n      const specialBuilder = {\n        whereIndex(indexName: string, condition?: unknown) {\n          whereConfig = { indexName, condition };\n          return this;\n        },\n        set(values: unknown) {\n          setValues = values;\n          return this;\n        },\n      };\n\n      builderFn(specialBuilder);\n\n      if (!whereConfig.indexName) {\n        throw new Error(\"whereIndex() must be called in updateMany\");\n      }\n      if (!setValues) {\n        throw new Error(\"set() must be called in updateMany\");\n      }\n\n      // First, find all matching records\n      const findUow = createUOW();\n      findUow.find(tableName, (b) => {\n        if (whereConfig.condition) {\n          return b.whereIndex(whereConfig.indexName as never, whereConfig.condition as never);\n        }\n        return b.whereIndex(whereConfig.indexName as never);\n      });\n      const findResults: unknown[][] = await findUow.executeRetrieve();\n      const records = findResults[0];\n\n      if (!records || records.length === 0) {\n        return;\n      }\n\n      // Now update all found records\n      const updateUow = createUOW();\n      for (const record of records as never as Array<{ id: unknown }>) {\n        updateUow.update(tableName as string, record.id as string, (b) =>\n          b.set(setValues as never),\n        );\n      }\n      const { success } = await updateUow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to update records (version conflict)\");\n      }\n    },\n\n    async delete(tableName, id, builderFn) {\n      const uow = createUOW();\n      uow.delete(tableName, id, builderFn as never);\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to delete record (version conflict or record not found)\");\n      }\n    },\n\n    async deleteMany(tableName, builderFn) {\n      // Create a special builder that captures where configuration\n      let whereConfig: { indexName?: string; condition?: unknown } = {};\n\n      const specialBuilder = {\n        whereIndex(indexName: string, condition?: unknown) {\n          whereConfig = { indexName, condition };\n          return this;\n        },\n      };\n\n      // Safe: Call builderFn to capture the configuration\n      builderFn(specialBuilder as never);\n\n      if (!whereConfig.indexName) {\n        throw new Error(\"whereIndex() must be called in deleteMany\");\n      }\n\n      // First, find all matching records\n      const findUow = createUOW();\n      findUow.find(tableName as string, (b) => {\n        if (whereConfig.condition) {\n          return b.whereIndex(whereConfig.indexName as never, whereConfig.condition as never);\n        }\n        return b.whereIndex(whereConfig.indexName as never);\n      });\n      const findResults2 = await findUow.executeRetrieve();\n      const records = (findResults2 as unknown as [unknown])[0];\n\n      // @ts-expect-error - Type narrowing doesn't work through unknown cast\n      if (!records || records.length === 0) {\n        return;\n      }\n\n      // Now delete all found records\n      const deleteUow = createUOW();\n      for (const record of records as never as Array<{ id: unknown }>) {\n        deleteUow.delete(tableName as string, record.id as string);\n      }\n      const { success } = await deleteUow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to delete records (version conflict)\");\n      }\n    },\n\n    createUnitOfWork(name) {\n      return createUOW(name);\n    },\n  } as AbstractQuery<T>;\n}\n"],"mappings":"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"}
+{"version":3,"file":"kysely-query.js","names":["#indexName","#condition","#setValues","executor: UOWExecutor<CompiledQuery, unknown>","decoder: UOWDecoder<T>","cursor: Cursor | undefined","index"],"sources":["../../../src/adapters/kysely/kysely-query.ts"],"sourcesContent":["import type { AbstractQuery, TableToUpdateValues } from \"../../query/query\";\nimport type { AnySchema, AnyTable } from \"../../schema/create\";\nimport type {\n  CompiledMutation,\n  UOWDecoder,\n  UOWExecutor,\n  ValidIndexName,\n} from \"../../query/unit-of-work\";\nimport { decodeResult } from \"../../query/result-transform\";\nimport { createKyselyUOWCompiler } from \"./kysely-uow-compiler\";\nimport { executeKyselyRetrievalPhase, executeKyselyMutationPhase } from \"./kysely-uow-executor\";\nimport { UnitOfWork } from \"../../query/unit-of-work\";\nimport type { CompiledQuery, Kysely } from \"kysely\";\nimport type { TableNameMapper } from \"./kysely-shared\";\nimport type { ConnectionPool } from \"../../shared/connection-pool\";\nimport type { SQLProvider } from \"../../shared/providers\";\nimport { createCursorFromRecord, Cursor, type CursorResult } from \"../../query/cursor\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype KyselyAny = Kysely<any>;\n\n/**\n * Configuration options for creating a Kysely Unit of Work\n */\nexport interface KyselyUOWConfig {\n  /**\n   * Optional callback to receive compiled SQL queries for logging/debugging\n   * This callback is invoked for each query as it's compiled\n   */\n  onQuery?: (query: CompiledQuery) => void;\n  /**\n   * If true, the query will not be executed and the query will be returned. Not respected for UOWs\n   * since those have to be manually executed.\n   */\n  dryRun?: boolean;\n}\n\n/**\n * Special builder for updateMany operations that captures configuration\n */\nclass UpdateManySpecialBuilder<TTable extends AnyTable> {\n  #indexName?: string;\n  #condition?: unknown;\n  #setValues?: TableToUpdateValues<TTable>;\n\n  whereIndex<TIndexName extends ValidIndexName<TTable>>(\n    indexName: TIndexName,\n    condition?: unknown,\n  ): this {\n    this.#indexName = indexName as string;\n    this.#condition = condition;\n    return this;\n  }\n\n  set(values: TableToUpdateValues<TTable>): this {\n    this.#setValues = values;\n    return this;\n  }\n\n  getConfig() {\n    return {\n      indexName: this.#indexName,\n      condition: this.#condition,\n      setValues: this.#setValues,\n    };\n  }\n}\n\n/**\n * Creates a Kysely-based query engine for the given schema.\n *\n * This is the main entry point for creating a database query interface using Kysely.\n * It uses a compiler-based architecture where queries are compiled to SQL and then executed,\n * enabling features like SQL snapshot testing.\n *\n * @param schema - The database schema definition\n * @param pool - Connection pool for acquiring database connections\n * @param provider - SQL provider (postgresql, mysql, sqlite, etc.)\n * @param mapper - Optional table name mapper for namespace prefixing\n * @returns An AbstractQuery instance for performing database operations\n *\n * @example\n * ```ts\n * const pool = createSimpleConnectionPool(kysely);\n * const queryEngine = fromKysely(mySchema, pool, 'postgresql');\n *\n * const users = await queryEngine.findMany('users', {\n *   where: (b) => b('age', '>', 18),\n *   orderBy: [['name', 'asc']]\n * });\n * ```\n */\nexport function fromKysely<T extends AnySchema>(\n  schema: T,\n  pool: ConnectionPool<KyselyAny>,\n  provider: SQLProvider,\n  mapper?: TableNameMapper,\n  uowConfig?: KyselyUOWConfig,\n): AbstractQuery<T, KyselyUOWConfig> {\n  function createUOW(opts: { name?: string; config?: KyselyUOWConfig }) {\n    const uowCompiler = createKyselyUOWCompiler(schema, pool, provider, mapper);\n\n    const executor: UOWExecutor<CompiledQuery, unknown> = {\n      async executeRetrievalPhase(retrievalBatch: CompiledQuery[]) {\n        // In dryRun mode, skip execution and return empty results\n        if (opts.config?.dryRun) {\n          return retrievalBatch.map(() => []);\n        }\n\n        const conn = await pool.connect();\n        try {\n          return await executeKyselyRetrievalPhase(conn.db, retrievalBatch);\n        } finally {\n          await conn.release();\n        }\n      },\n      async executeMutationPhase(mutationBatch: CompiledMutation<CompiledQuery>[]) {\n        // In dryRun mode, skip execution and return success with mock internal IDs\n        if (opts.config?.dryRun) {\n          return {\n            success: true,\n            createdInternalIds: mutationBatch.map(() => null),\n          };\n        }\n\n        const conn = await pool.connect();\n        try {\n          return await executeKyselyMutationPhase(conn.db, mutationBatch);\n        } finally {\n          await conn.release();\n        }\n      },\n    };\n\n    // Create a decoder function to transform raw results into application format\n    const decoder: UOWDecoder<T> = (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((rows, index) => {\n        const op = ops[index];\n        if (!op) {\n          throw new Error(\"op must be defined\");\n        }\n\n        // Handle count operations differently - return the count number directly\n        if (op.type === \"count\") {\n          const rowArray = rows as Record<string, unknown>[];\n          const firstRow = rowArray[0];\n          if (!firstRow) {\n            return 0;\n          }\n          const count = Number(firstRow[\"count\"]);\n          if (Number.isNaN(count)) {\n            throw new Error(`Unexpected result for count, received: ${count}`);\n          }\n          return count;\n        }\n\n        // Each result is an array of rows - decode each row\n        const rowArray = rows as Record<string, unknown>[];\n        const decodedRows = rowArray.map((row) => decodeResult(row, op.table, provider));\n\n        // If cursor generation is requested, wrap in CursorResult\n        if (op.withCursor) {\n          let cursor: Cursor | undefined;\n\n          // Generate cursor from last item if results exist\n          if (decodedRows.length > 0 && op.options.orderByIndex && op.options.pageSize) {\n            const lastItem = decodedRows[decodedRows.length - 1];\n            const indexName = op.options.orderByIndex.indexName;\n\n            // Get index columns\n            let indexColumns;\n            if (indexName === \"_primary\") {\n              indexColumns = [op.table.getIdColumn()];\n            } else {\n              const index = op.table.indexes[indexName];\n              if (index) {\n                indexColumns = index.columns;\n              }\n            }\n\n            if (indexColumns && lastItem) {\n              cursor = createCursorFromRecord(lastItem as Record<string, unknown>, indexColumns, {\n                indexName: op.options.orderByIndex.indexName,\n                orderDirection: op.options.orderByIndex.direction,\n                pageSize: op.options.pageSize,\n              });\n            }\n          }\n\n          const result: CursorResult<unknown> = {\n            items: decodedRows,\n            cursor,\n          };\n          return result;\n        }\n\n        return decodedRows;\n      });\n    };\n\n    const { onQuery, ...restUowConfig } = opts.config ?? {};\n\n    return new UnitOfWork(schema, uowCompiler, executor, decoder, opts.name, {\n      ...restUowConfig,\n      onQuery: (query) => {\n        // CompiledMutation has { query: CompiledQuery, expectedAffectedRows: number | null }\n        // CompiledQuery has { query: QueryAST, sql: string, parameters: unknown[] }\n        // Check for expectedAffectedRows to distinguish CompiledMutation from CompiledQuery\n        const actualQuery =\n          query && typeof query === \"object\" && \"expectedAffectedRows\" in query\n            ? (query as CompiledMutation<CompiledQuery>).query\n            : (query as CompiledQuery);\n\n        opts.config?.onQuery?.(actualQuery);\n      },\n    });\n  }\n\n  return {\n    async find(tableName, builderFn) {\n      const uow = createUOW({ config: uowConfig });\n      // Safe: builderFn returns a FindBuilder (or void), which matches UnitOfWork signature\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      uow.find(tableName, builderFn as any);\n      // executeRetrieve returns an array of results (one per find operation)\n      // Since we only have one find, unwrap the first result\n      const [result]: unknown[][] = await uow.executeRetrieve();\n      return result ?? [];\n    },\n\n    async findWithCursor(tableName, builderFn) {\n      // Safe: builderFn returns a FindBuilder, which matches UnitOfWork signature\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const uow = createUOW({ config: uowConfig }).findWithCursor(tableName, builderFn as any);\n      // executeRetrieve returns an array of results (one per find operation)\n      // Since we only have one findWithCursor, unwrap the first result\n      const [result] = await uow.executeRetrieve();\n      return result as CursorResult<unknown>;\n    },\n\n    async findFirst(tableName, builderFn) {\n      const uow = createUOW({ config: uowConfig });\n      if (builderFn) {\n        uow.find(tableName, (b) => {\n          builderFn(b);\n          return b.pageSize(1);\n        });\n      } else {\n        uow.find(tableName, (b) => b.whereIndex(\"primary\").pageSize(1));\n      }\n      // executeRetrieve runs an array of `find` operation results, which each return an array of rows\n      const [result]: unknown[][] = await uow.executeRetrieve();\n      return result?.[0] ?? null;\n    },\n\n    async create(tableName, values) {\n      const uow = createUOW({ config: uowConfig });\n      uow.create(tableName, values);\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to create record\");\n      }\n\n      const createdIds = uow.getCreatedIds();\n      const createdId = createdIds[0];\n      if (!createdId) {\n        throw new Error(\"Failed to get created ID\");\n      }\n      return createdId;\n    },\n\n    async createMany(tableName, valuesArray) {\n      const uow = createUOW({ config: uowConfig });\n      for (const values of valuesArray) {\n        uow.create(tableName, values);\n      }\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to create records\");\n      }\n\n      return uow.getCreatedIds();\n    },\n\n    async update(tableName, id, builderFn) {\n      const uow = createUOW({ config: uowConfig });\n      uow.update(tableName, id, builderFn);\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to update record (version conflict or record not found)\");\n      }\n    },\n\n    async updateMany(tableName, builderFn) {\n      const table = schema.tables[tableName];\n      if (!table) {\n        throw new Error(`Table ${tableName} not found in schema`);\n      }\n\n      const specialBuilder = new UpdateManySpecialBuilder<typeof table>();\n      builderFn(specialBuilder);\n\n      const { indexName, condition, setValues } = specialBuilder.getConfig();\n\n      if (!indexName) {\n        throw new Error(\"whereIndex() must be called in updateMany\");\n      }\n      if (!setValues) {\n        throw new Error(\"set() must be called in updateMany\");\n      }\n\n      const findUow = createUOW({ config: uowConfig });\n      findUow.find(tableName, (b) => {\n        if (condition) {\n          // Safe: condition is captured from whereIndex call with proper typing\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          return b.whereIndex(indexName as ValidIndexName<typeof table>, condition as any);\n        }\n        return b.whereIndex(indexName as ValidIndexName<typeof table>);\n      });\n      const [records]: unknown[][] = await findUow.executeRetrieve();\n\n      if (!records || records.length === 0) {\n        return;\n      }\n\n      const updateUow = createUOW({ config: uowConfig });\n      for (const record of records as Array<{ id: unknown }>) {\n        updateUow.update(tableName, record.id as string, (b) => b.set(setValues));\n      }\n      const { success } = await updateUow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to update records (version conflict)\");\n      }\n    },\n\n    async delete(tableName, id, builderFn) {\n      const uow = createUOW({ config: uowConfig });\n      uow.delete(tableName, id, builderFn);\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to delete record (version conflict or record not found)\");\n      }\n    },\n\n    async deleteMany(tableName, builderFn) {\n      const findUow = createUOW({ config: uowConfig });\n      findUow.find(tableName, builderFn);\n      const [records]: unknown[][] = await findUow.executeRetrieve();\n\n      if (!records || records.length === 0) {\n        return;\n      }\n\n      const deleteUow = createUOW({ config: uowConfig });\n      for (const record of records as Array<{ id: unknown }>) {\n        deleteUow.delete(tableName, record.id as string);\n      }\n      const { success } = await deleteUow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to delete records (version conflict)\");\n      }\n    },\n\n    createUnitOfWork(name, nestedUowConfig) {\n      return createUOW({\n        name,\n        config: {\n          ...uowConfig,\n          ...nestedUowConfig,\n        },\n      });\n    },\n  } as AbstractQuery<T, KyselyUOWConfig>;\n}\n"],"mappings":"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"}

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

@@ -43,7 +43,8 @@ function createKyselyUOWCompiler(schema, pool, provider, mapper) {
 					if (indexColumns.length > 0) orderBy = indexColumns.map((col) => [col, orderDirection]);
 					let cursorCondition;
 					if ((after || before) && indexColumns.length > 0) {
-						const serializedValues = serializeCursorValues(decodeCursor(after || before), indexColumns, provider);
+						const cursor = after || before;
+						const serializedValues = serializeCursorValues(typeof cursor === "string" ? decodeCursor(cursor) : cursor, indexColumns, provider);
 						const isAfter = !!after;
 						const useGreaterThan = isAfter && orderDirection === "asc" || !isAfter && orderDirection === "desc";
 						if (indexColumns.length === 1) {

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

@@ -1 +1 @@
-{"version":3,"file":"kysely-uow-compiler.js","names":["indexColumns: AnyColumn[]","orderDirection: \"asc\" | \"desc\"","orderBy: [AnyColumn, \"asc\" | \"desc\"][] | undefined","cursorCondition: Condition | undefined","combinedWhere: Condition | undefined"],"sources":["../../../src/adapters/kysely/kysely-uow-compiler.ts"],"sourcesContent":["import type { CompiledQuery, Kysely } from \"kysely\";\nimport type { AnyColumn, AnySchema, FragnoId } from \"../../schema/create\";\nimport type {\n  CompiledMutation,\n  MutationOperation,\n  RetrievalOperation,\n  UOWCompiler,\n} from \"../../query/unit-of-work\";\nimport { createKyselyQueryCompiler } from \"./kysely-query-compiler\";\nimport { createKyselyQueryBuilder } from \"./kysely-query-builder\";\nimport { buildCondition, type Condition } from \"../../query/condition-builder\";\nimport { decodeCursor, serializeCursorValues } from \"../../query/cursor\";\nimport type { AnySelectClause } from \"../../query/query\";\nimport type { TableNameMapper } from \"./kysely-shared\";\nimport type { ConnectionPool } from \"../../shared/connection-pool\";\nimport type { SQLProvider } from \"../../shared/providers\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype KyselyAny = Kysely<any>;\n\n/**\n * Create a Kysely-specific Unit of Work compiler\n *\n * This compiler translates UOW operations into Kysely CompiledQuery objects\n * that can be executed as a batch/transaction.\n *\n * @param schema - The database schema\n * @param pool - Connection pool for acquiring database connections\n * @param provider - SQL provider (postgresql, mysql, sqlite, etc.)\n * @param mapper - Optional table name mapper for namespace prefixing\n * @returns A UOWCompiler instance for Kysely\n */\nexport function createKyselyUOWCompiler<TSchema extends AnySchema>(\n  schema: TSchema,\n  pool: ConnectionPool<KyselyAny>,\n  provider: SQLProvider,\n  mapper?: TableNameMapper,\n): UOWCompiler<TSchema, CompiledQuery> {\n  const queryCompiler = createKyselyQueryCompiler(schema, pool, provider, mapper);\n  // Get kysely instance for query building (compilation doesn't execute, just builds SQL)\n  const kysely = pool.getDatabaseSync();\n  const queryBuilder = createKyselyQueryBuilder(kysely, provider, mapper);\n\n  function toTable(name: unknown) {\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  return {\n    compileRetrievalOperation(op: RetrievalOperation<TSchema>): CompiledQuery | null {\n      switch (op.type) {\n        case \"count\": {\n          return queryCompiler.count(op.table.name, {\n            where: op.options.where,\n          });\n        }\n\n        case \"find\": {\n          // Map UOW FindOptions to query compiler's FindManyOptions\n          const {\n            useIndex: _useIndex,\n            orderByIndex,\n            joins: join,\n            after,\n            before,\n            pageSize,\n            ...findManyOptions\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 internal ID column\n              // (which is the actual primary key and maintains insertion order)\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              // Order by all columns in the index with the specified direction\n              indexColumns = index.columns;\n            }\n          }\n\n          // Convert orderByIndex to orderBy format\n          let orderBy: [AnyColumn, \"asc\" | \"desc\"][] | undefined;\n          if (indexColumns.length > 0) {\n            orderBy = indexColumns.map((col) => [col, orderDirection]);\n          }\n\n          // Handle cursor pagination - build a cursor condition\n          let cursorCondition: Condition | undefined;\n\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 = indexColumns[0]!;\n              const val = serializedValues[col.ormName];\n              const operator = useGreaterThan ? \">\" : \"<\";\n              cursorCondition = {\n                type: \"compare\",\n                a: col,\n                operator,\n                b: val,\n              };\n            } else {\n              // Multi-column tuple comparison - not yet supported for Kysely\n              throw new Error(\n                \"Multi-column cursor pagination is not yet supported in Kysely Unit of Work implementation\",\n              );\n            }\n          }\n\n          // Combine user where clause with cursor condition\n          let combinedWhere: Condition | undefined;\n          if (findManyOptions.where) {\n            const whereResult = buildCondition(op.table.columns, findManyOptions.where);\n            if (whereResult === true) {\n              combinedWhere = undefined;\n            } else if (whereResult === false) {\n              return null;\n            } else {\n              combinedWhere = whereResult;\n            }\n          }\n\n          if (cursorCondition) {\n            if (combinedWhere) {\n              combinedWhere = {\n                type: \"and\",\n                items: [combinedWhere, cursorCondition],\n              };\n            } else {\n              combinedWhere = cursorCondition;\n            }\n          }\n\n          // When we have joins or need to bypass buildFindOptions, use queryBuilder directly\n          if (join && join.length > 0) {\n            return queryBuilder.findMany(op.table, {\n              // Safe cast: select from UOW matches SimplifyFindOptions requirement\n              select: (findManyOptions.select ?? true) as AnySelectClause,\n              where: combinedWhere,\n              orderBy,\n              limit: pageSize,\n              join,\n            });\n          }\n\n          return queryCompiler.findMany(op.table.name, {\n            ...findManyOptions,\n            where: combinedWhere ? () => combinedWhere! : undefined,\n            orderBy: orderBy?.map(([col, dir]) => [col.ormName, dir]),\n            limit: pageSize,\n          });\n        }\n      }\n    },\n\n    compileMutationOperation(\n      op: MutationOperation<TSchema>,\n    ): CompiledMutation<CompiledQuery> | null {\n      switch (op.type) {\n        case \"create\":\n          // queryCompiler.create() calls encodeValues() which handles runtime defaults\n          return {\n            query: queryCompiler.create(op.table, op.values),\n            expectedAffectedRows: null, // creates don't need affected row checks\n          };\n\n        case \"update\": {\n          const table = toTable(op.table);\n          const idColumn = table.getIdColumn();\n          const versionColumn = table.getVersionColumn();\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 whereClause =\n            versionToCheck !== undefined\n              ? () =>\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          const query = queryCompiler.updateMany(op.table, {\n            where: whereClause,\n            set: op.set,\n          });\n\n          return query\n            ? {\n                query,\n                expectedAffectedRows: op.checkVersion ? 1 : null,\n              }\n            : null;\n        }\n\n        case \"delete\": {\n          const table = toTable(op.table);\n          const idColumn = table.getIdColumn();\n          const versionColumn = table.getVersionColumn();\n\n          // Extract external ID based on whether op.id is FragnoId or string\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 whereClause =\n            versionToCheck !== undefined\n              ? () =>\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          const query = queryCompiler.deleteMany(op.table, {\n            where: whereClause,\n          });\n\n          return query\n            ? {\n                query,\n                expectedAffectedRows: op.checkVersion ? 1 : null,\n              }\n            : null;\n        }\n      }\n    },\n  };\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 */\nfunction 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"],"mappings":"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"}
+{"version":3,"file":"kysely-uow-compiler.js","names":["indexColumns: AnyColumn[]","orderDirection: \"asc\" | \"desc\"","orderBy: [AnyColumn, \"asc\" | \"desc\"][] | undefined","cursorCondition: Condition | undefined","combinedWhere: Condition | undefined"],"sources":["../../../src/adapters/kysely/kysely-uow-compiler.ts"],"sourcesContent":["import type { CompiledQuery, Kysely } from \"kysely\";\nimport type { AnyColumn, AnySchema, FragnoId } from \"../../schema/create\";\nimport type {\n  CompiledMutation,\n  MutationOperation,\n  RetrievalOperation,\n  UOWCompiler,\n} from \"../../query/unit-of-work\";\nimport { createKyselyQueryCompiler } from \"./kysely-query-compiler\";\nimport { createKyselyQueryBuilder } from \"./kysely-query-builder\";\nimport { buildCondition, type Condition } from \"../../query/condition-builder\";\nimport { decodeCursor, serializeCursorValues } from \"../../query/cursor\";\nimport type { AnySelectClause } from \"../../query/query\";\nimport type { TableNameMapper } from \"./kysely-shared\";\nimport type { ConnectionPool } from \"../../shared/connection-pool\";\nimport type { SQLProvider } from \"../../shared/providers\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype KyselyAny = Kysely<any>;\n\n/**\n * Create a Kysely-specific Unit of Work compiler\n *\n * This compiler translates UOW operations into Kysely CompiledQuery objects\n * that can be executed as a batch/transaction.\n *\n * @param schema - The database schema\n * @param pool - Connection pool for acquiring database connections\n * @param provider - SQL provider (postgresql, mysql, sqlite, etc.)\n * @param mapper - Optional table name mapper for namespace prefixing\n * @returns A UOWCompiler instance for Kysely\n */\nexport function createKyselyUOWCompiler<TSchema extends AnySchema>(\n  schema: TSchema,\n  pool: ConnectionPool<KyselyAny>,\n  provider: SQLProvider,\n  mapper?: TableNameMapper,\n): UOWCompiler<TSchema, CompiledQuery> {\n  const queryCompiler = createKyselyQueryCompiler(schema, pool, provider, mapper);\n  // Get kysely instance for query building (compilation doesn't execute, just builds SQL)\n  const kysely = pool.getDatabaseSync();\n  const queryBuilder = createKyselyQueryBuilder(kysely, provider, mapper);\n\n  function toTable(name: unknown) {\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  return {\n    compileRetrievalOperation(op: RetrievalOperation<TSchema>): CompiledQuery | null {\n      switch (op.type) {\n        case \"count\": {\n          return queryCompiler.count(op.table.name, {\n            where: op.options.where,\n          });\n        }\n\n        case \"find\": {\n          // Map UOW FindOptions to query compiler's FindManyOptions\n          const {\n            useIndex: _useIndex,\n            orderByIndex,\n            joins: join,\n            after,\n            before,\n            pageSize,\n            ...findManyOptions\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 internal ID column\n              // (which is the actual primary key and maintains insertion order)\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              // Order by all columns in the index with the specified direction\n              indexColumns = index.columns;\n            }\n          }\n\n          // Convert orderByIndex to orderBy format\n          let orderBy: [AnyColumn, \"asc\" | \"desc\"][] | undefined;\n          if (indexColumns.length > 0) {\n            orderBy = indexColumns.map((col) => [col, orderDirection]);\n          }\n\n          // Handle cursor pagination - build a cursor condition\n          let cursorCondition: Condition | undefined;\n\n          if ((after || before) && indexColumns.length > 0) {\n            const cursor = after || before;\n            // Decode cursor if it's a string, otherwise use it as-is\n            const cursorObj = typeof cursor === \"string\" ? decodeCursor(cursor!) : cursor!;\n            const serializedValues = serializeCursorValues(cursorObj, 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 = indexColumns[0]!;\n              const val = serializedValues[col.ormName];\n              const operator = useGreaterThan ? \">\" : \"<\";\n              cursorCondition = {\n                type: \"compare\",\n                a: col,\n                operator,\n                b: val,\n              };\n            } else {\n              // Multi-column tuple comparison - not yet supported for Kysely\n              throw new Error(\n                \"Multi-column cursor pagination is not yet supported in Kysely Unit of Work implementation\",\n              );\n            }\n          }\n\n          // Combine user where clause with cursor condition\n          let combinedWhere: Condition | undefined;\n          if (findManyOptions.where) {\n            const whereResult = buildCondition(op.table.columns, findManyOptions.where);\n            if (whereResult === true) {\n              combinedWhere = undefined;\n            } else if (whereResult === false) {\n              return null;\n            } else {\n              combinedWhere = whereResult;\n            }\n          }\n\n          if (cursorCondition) {\n            if (combinedWhere) {\n              combinedWhere = {\n                type: \"and\",\n                items: [combinedWhere, cursorCondition],\n              };\n            } else {\n              combinedWhere = cursorCondition;\n            }\n          }\n\n          // When we have joins or need to bypass buildFindOptions, use queryBuilder directly\n          if (join && join.length > 0) {\n            return queryBuilder.findMany(op.table, {\n              // Safe cast: select from UOW matches SimplifyFindOptions requirement\n              select: (findManyOptions.select ?? true) as AnySelectClause,\n              where: combinedWhere,\n              orderBy,\n              limit: pageSize,\n              join,\n            });\n          }\n\n          return queryCompiler.findMany(op.table.name, {\n            ...findManyOptions,\n            where: combinedWhere ? () => combinedWhere! : undefined,\n            orderBy: orderBy?.map(([col, dir]) => [col.ormName, dir]),\n            limit: pageSize,\n          });\n        }\n      }\n    },\n\n    compileMutationOperation(\n      op: MutationOperation<TSchema>,\n    ): CompiledMutation<CompiledQuery> | null {\n      switch (op.type) {\n        case \"create\":\n          // queryCompiler.create() calls encodeValues() which handles runtime defaults\n          return {\n            query: queryCompiler.create(op.table, op.values),\n            expectedAffectedRows: null, // creates don't need affected row checks\n          };\n\n        case \"update\": {\n          const table = toTable(op.table);\n          const idColumn = table.getIdColumn();\n          const versionColumn = table.getVersionColumn();\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 whereClause =\n            versionToCheck !== undefined\n              ? () =>\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          const query = queryCompiler.updateMany(op.table, {\n            where: whereClause,\n            set: op.set,\n          });\n\n          return query\n            ? {\n                query,\n                expectedAffectedRows: op.checkVersion ? 1 : null,\n              }\n            : null;\n        }\n\n        case \"delete\": {\n          const table = toTable(op.table);\n          const idColumn = table.getIdColumn();\n          const versionColumn = table.getVersionColumn();\n\n          // Extract external ID based on whether op.id is FragnoId or string\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 whereClause =\n            versionToCheck !== undefined\n              ? () =>\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          const query = queryCompiler.deleteMany(op.table, {\n            where: whereClause,\n          });\n\n          return query\n            ? {\n                query,\n                expectedAffectedRows: op.checkVersion ? 1 : null,\n              }\n            : null;\n        }\n      }\n    },\n  };\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 */\nfunction 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"],"mappings":"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"}