@fragno-dev/db 0.1.14 → 0.2.0

package/dist/adapters/generic-sql/uow-encoder.js

@@ -0,0 +1,93 @@
+import { createSQLSerializer } from "../../query/serialize/create-sql-serializer.js";
+import { encodeValues } from "../../query/value-encoding.js";
+import { processReferenceSubqueries } from "./query/where-builder.js";
+
+//#region src/adapters/generic-sql/uow-encoder.ts
+/**
+* Encoder class for Unit of Work mutation operations.
+*
+* Handles the complete transformation from application values to database-ready values
+* in three clear steps:
+* 1. Resolution - Resolve FragnoId/FragnoReference objects and generate defaults
+* 2. Reference Processing - Create subqueries for external ID lookups
+* 3. Serialization - Apply database-specific type conversions
+*
+* This class mirrors the UnitOfWorkDecoder pattern for symmetry.
+*/
+var UnitOfWorkEncoder = class {
+	#serializer;
+	#db;
+	#mapper;
+	constructor(driverConfig, db, mapper) {
+		this.#serializer = createSQLSerializer(driverConfig);
+		this.#db = db;
+		this.#mapper = mapper;
+	}
+	/**
+	* Encode application values to database-ready format.
+	*
+	* This is the main entry point that handles all encoding steps:
+	* 1. **Resolution**: Transform ORM names to DB columns, resolve FragnoId/FragnoReference,
+	*    generate defaults (CUIDs for IDs, etc.)
+	* 2. **Reference Processing**: Convert external ID strings to subqueries for internal ID lookup
+	* 3. **Serialization**: Apply database-specific conversions (Date → number for SQLite, etc.)
+	*
+	* @param options - Encoding options
+	* @param options.values - Application values to encode
+	* @param options.table - Table schema definition
+	* @param options.generateDefaults - Whether to generate default values for undefined columns
+	* @returns Database-ready values
+	*
+	* @example
+	* ```ts
+	* const encoded = encoder.encodeForDatabase({
+	*   values: { userId: FragnoId(...), createdAt: new Date(), isActive: true },
+	*   table: usersTable,
+	*   generateDefaults: true
+	* });
+	* // For SQLite: { user_id: 456, created_at: 1705316400000, is_active: 1 }
+	* ```
+	*/
+	encodeForDatabase(options) {
+		const processed = processReferenceSubqueries(encodeValues(options.values, options.table, options.generateDefaults), this.#db, this.#mapper);
+		return this.serializeValues(processed, options.table);
+	}
+	/**
+	* Serialize resolved values to database format.
+	*
+	* Applies database-specific type conversions:
+	* - SQLite: Date → number, boolean → 0/1, bigint → Buffer (or Number for reference columns)
+	* - PostgreSQL: Mostly pass-through (database handles types natively)
+	* - MySQL: Mostly pass-through
+	*
+	* @param values - Resolved values (after resolution and reference processing)
+	* @param table - The table schema definition
+	* @returns Serialized values ready for database driver
+	*/
+	serializeValues(values, table) {
+		const result = {};
+		for (const [dbColumnName, value] of Object.entries(values)) {
+			const col = this.findColumnByDbName(table, dbColumnName);
+			if (!col) {
+				result[dbColumnName] = value;
+				continue;
+			}
+			result[dbColumnName] = this.#serializer.serialize(value, col);
+		}
+		return result;
+	}
+	/**
+	* Find a column definition by its database column name.
+	*
+	* @param table - The table to search
+	* @param dbColumnName - The database column name (e.g., "user_id")
+	* @returns The column definition or undefined if not found
+	*/
+	findColumnByDbName(table, dbColumnName) {
+		for (const col of Object.values(table.columns)) if (col.name === dbColumnName) return col;
+	}
+};
+
+//#endregion
+export { UnitOfWorkEncoder };
+//# sourceMappingURL=uow-encoder.js.map

package/dist/adapters/generic-sql/uow-encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uow-encoder.js","names":["#serializer","#db","#mapper","result: Record<string, unknown>"],"sources":["../../../src/adapters/generic-sql/uow-encoder.ts"],"sourcesContent":["import type { AnyTable, AnyColumn } from \"../../schema/create\";\nimport type { DriverConfig } from \"./driver-config\";\nimport {\n  createSQLSerializer,\n  type SQLSerializer,\n} from \"../../query/serialize/create-sql-serializer\";\nimport { encodeValues } from \"../../query/value-encoding\";\nimport { processReferenceSubqueries } from \"./query/where-builder\";\nimport type { TableNameMapper } from \"../shared/table-name-mapper\";\nimport type { Kysely } from \"kysely\";\n\n/**\n * Encoder class for Unit of Work mutation operations.\n *\n * Handles the complete transformation from application values to database-ready values\n * in three clear steps:\n * 1. Resolution - Resolve FragnoId/FragnoReference objects and generate defaults\n * 2. Reference Processing - Create subqueries for external ID lookups\n * 3. Serialization - Apply database-specific type conversions\n *\n * This class mirrors the UnitOfWorkDecoder pattern for symmetry.\n */\nexport class UnitOfWorkEncoder {\n  readonly #serializer: SQLSerializer;\n  readonly #db: Kysely<any>; // eslint-disable-line @typescript-eslint/no-explicit-any\n  readonly #mapper?: TableNameMapper;\n\n  constructor(\n    driverConfig: DriverConfig,\n    db: Kysely<any>, // eslint-disable-line @typescript-eslint/no-explicit-any\n    mapper?: TableNameMapper,\n  ) {\n    this.#serializer = createSQLSerializer(driverConfig);\n    this.#db = db;\n    this.#mapper = mapper;\n  }\n\n  /**\n   * Encode application values to database-ready format.\n   *\n   * This is the main entry point that handles all encoding steps:\n   * 1. **Resolution**: Transform ORM names to DB columns, resolve FragnoId/FragnoReference,\n   *    generate defaults (CUIDs for IDs, etc.)\n   * 2. **Reference Processing**: Convert external ID strings to subqueries for internal ID lookup\n   * 3. **Serialization**: Apply database-specific conversions (Date → number for SQLite, etc.)\n   *\n   * @param options - Encoding options\n   * @param options.values - Application values to encode\n   * @param options.table - Table schema definition\n   * @param options.generateDefaults - Whether to generate default values for undefined columns\n   * @returns Database-ready values\n   *\n   * @example\n   * ```ts\n   * const encoded = encoder.encodeForDatabase({\n   *   values: { userId: FragnoId(...), createdAt: new Date(), isActive: true },\n   *   table: usersTable,\n   *   generateDefaults: true\n   * });\n   * // For SQLite: { user_id: 456, created_at: 1705316400000, is_active: 1 }\n   * ```\n   */\n  encodeForDatabase(options: {\n    values: Record<string, unknown>;\n    table: AnyTable;\n    generateDefaults: boolean;\n  }): Record<string, unknown> {\n    // Step 1: Resolution - Resolve FragnoId/FragnoReference and generate defaults\n    const resolved = encodeValues(options.values, options.table, options.generateDefaults);\n\n    // Step 2: Reference Processing - Convert external IDs to subqueries\n    const processed = processReferenceSubqueries(resolved, this.#db, this.#mapper);\n\n    // Step 3: Serialization - Apply database-specific type conversions\n    const serialized = this.serializeValues(processed, options.table);\n\n    return serialized;\n  }\n\n  /**\n   * Serialize resolved values to database format.\n   *\n   * Applies database-specific type conversions:\n   * - SQLite: Date → number, boolean → 0/1, bigint → Buffer (or Number for reference columns)\n   * - PostgreSQL: Mostly pass-through (database handles types natively)\n   * - MySQL: Mostly pass-through\n   *\n   * @param values - Resolved values (after resolution and reference processing)\n   * @param table - The table schema definition\n   * @returns Serialized values ready for database driver\n   */\n  private serializeValues(\n    values: Record<string, unknown>,\n    table: AnyTable,\n  ): Record<string, unknown> {\n    const result: Record<string, unknown> = {};\n\n    for (const [dbColumnName, value] of Object.entries(values)) {\n      // Find the column definition by database column name\n      const col = this.findColumnByDbName(table, dbColumnName);\n\n      if (!col) {\n        // Not a regular column (might be a special value like sql.raw())\n        // Pass through as-is\n        result[dbColumnName] = value;\n        continue;\n      }\n\n      // Serialize the value using the column definition and database type\n      result[dbColumnName] = this.#serializer.serialize(value, col);\n    }\n\n    return result;\n  }\n\n  /**\n   * Find a column definition by its database column name.\n   *\n   * @param table - The table to search\n   * @param dbColumnName - The database column name (e.g., \"user_id\")\n   * @returns The column definition or undefined if not found\n   */\n  private findColumnByDbName(table: AnyTable, dbColumnName: string): AnyColumn | undefined {\n    for (const col of Object.values(table.columns)) {\n      if (col.name === dbColumnName) {\n        return col;\n      }\n    }\n    return undefined;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAsBA,IAAa,oBAAb,MAA+B;CAC7B,CAASA;CACT,CAASC;CACT,CAASC;CAET,YACE,cACA,IACA,QACA;AACA,QAAKF,aAAc,oBAAoB,aAAa;AACpD,QAAKC,KAAM;AACX,QAAKC,SAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BjB,kBAAkB,SAIU;EAK1B,MAAM,YAAY,2BAHD,aAAa,QAAQ,QAAQ,QAAQ,OAAO,QAAQ,iBAAiB,EAG/B,MAAKD,IAAK,MAAKC,OAAQ;AAK9E,SAFmB,KAAK,gBAAgB,WAAW,QAAQ,MAAM;;;;;;;;;;;;;;CAiBnE,AAAQ,gBACN,QACA,OACyB;EACzB,MAAMC,SAAkC,EAAE;AAE1C,OAAK,MAAM,CAAC,cAAc,UAAU,OAAO,QAAQ,OAAO,EAAE;GAE1D,MAAM,MAAM,KAAK,mBAAmB,OAAO,aAAa;AAExD,OAAI,CAAC,KAAK;AAGR,WAAO,gBAAgB;AACvB;;AAIF,UAAO,gBAAgB,MAAKH,WAAY,UAAU,OAAO,IAAI;;AAG/D,SAAO;;;;;;;;;CAUT,AAAQ,mBAAmB,OAAiB,cAA6C;AACvF,OAAK,MAAM,OAAO,OAAO,OAAO,MAAM,QAAQ,CAC5C,KAAI,IAAI,SAAS,aACf,QAAO"}

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

@@ -1,10 +1,7 @@
-import { AnySchema } from "../../schema/create.js";
-import { Migrator } from "../../migration-engine/create.js";
+import { TableNameMapper } from "../shared/table-name-mapper.js";
+import { DatabaseAdapter } from "../adapters.js";
+import { GenericSQLAdapter, GenericSQLOptions, UnitOfWorkConfig } from "../generic-sql/generic-sql-adapter.js";
 import { SQLProvider } from "../../shared/providers.js";
-import { AbstractQuery } from "../../query/query.js";
-import { DatabaseAdapter, fragnoDatabaseAdapterNameFakeSymbol, fragnoDatabaseAdapterVersionFakeSymbol } from "../adapters.js";
-import { TableNameMapper } from "./kysely-shared.js";
-import { KyselyUOWConfig } from "./kysely-query.js";
 import { Kysely } from "kysely";
 
 //#region src/adapters/kysely/kysely-adapter.d.ts
@@ -13,17 +10,9 @@ interface KyselyConfig {
   db: KyselyAny | (() => KyselyAny | Promise<KyselyAny>);
   provider: SQLProvider;
 }
-declare class KyselyAdapter implements DatabaseAdapter<KyselyUOWConfig> {
-  #private;
-  constructor(config: KyselyConfig);
-  get [fragnoDatabaseAdapterNameFakeSymbol](): string;
-  get [fragnoDatabaseAdapterVersionFakeSymbol](): number;
-  close(): Promise<void>;
+declare class KyselyAdapter extends GenericSQLAdapter implements DatabaseAdapter<UnitOfWorkConfig> {
+  constructor(options: GenericSQLOptions);
   createTableNameMapper(namespace: string): TableNameMapper;
-  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>;
 }
 //#endregion
 export { KyselyAdapter, KyselyConfig };

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;MACX,mBAAmB,YAAY,QAAQ;EAHxC,QAAA,EAIO,WAJE;AAEd;AACM,cAIO,aAAA,YAAyB,eAJhC,CAIgD,eAJhD,CAAA,CAAA;EAAmB,CAAA,OAAA;EAAoB,WAAA,CAAA,MAAA,EASvB,YATuB;EAAR,KAc9B,mCAAA,GAd8B,EAAA,MAAA;EACzB,KAiBL,sCAAA,GAjBK,EAAA,MAAA;EAAW,KAAA,CAAA,CAAA,EAqBN,OArBM,CAAA,IAAA,CAAA;EAGV,qBAAc,CAAA,SAAA,EAAA,MAAA,CAAA,EAkBH,eAlBG;EAA2B,iBAAA,CAAA,UA0BxB,SA1BwB,CAAA,CAAA,MAAA,EA2B1C,CA3B0C,EAAA,SAAA,EAAA,MAAA,CAAA,EA6BjD,aA7BiD,CA6BnC,CA7BmC,EA6BhC,eA7BgC,CAAA;EAKhC,mBAAA,CAAA,CAAA,EAwCS,OAxCT,CAAA,OAAA,CAAA;EAKf,qBAAA,CAAA,MAAA,EA+CyB,SA/CzB,EAAA,SAAA,EAAA,MAAA,CAAA,EA+CwD,QA/CxD;EAIA,gBAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EAqKsC,OArKtC,CAAA,MAAA,GAAA,SAAA,CAAA"}
+{"version":3,"file":"kysely-adapter.d.ts","names":[],"sources":["../../../src/adapters/kysely/kysely-adapter.ts"],"sourcesContent":[],"mappings":";;;;;;;KAWK,SAAA,GAAY;UAEA,YAAA;MACX,mBAAmB,YAAY,QAAQ;EAHxC,QAAA,EAIO,WAJE;AAEd;AACM,cAIO,aAAA,SAAsB,iBAAA,YAA6B,eAJ1D,CAI0E,gBAJ1E,CAAA,CAAA;EAAmB,WAAA,CAAA,OAAA,EAKF,iBALE;EAAoB,qBAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EAKL,eALK"}

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

@@ -1,169 +1,16 @@
-import { fragnoDatabaseAdapterNameFakeSymbol, fragnoDatabaseAdapterVersionFakeSymbol } from "../adapters.js";
-import { SETTINGS_TABLE_NAME } from "../../shared/settings-schema.js";
-import { createMigrator } from "../../migration-engine/create.js";
-import { execute, preprocessOperations } from "./migration/execute.js";
-import { createTableNameMapper } from "./kysely-shared.js";
-import { fromKysely } from "./kysely-query.js";
-import { createKyselyConnectionPool } from "./kysely-connection-pool.js";
-import { sql } from "kysely";
-import { createHash } from "node:crypto";
+import { createTableNameMapper } from "../shared/table-name-mapper.js";
+import { GenericSQLAdapter } from "../generic-sql/generic-sql-adapter.js";
+import "kysely";
 
 //#region src/adapters/kysely/kysely-adapter.ts
-var KyselyAdapter = class {
-	#connectionPool;
-	#provider;
-	#schemaNamespaceMap = /* @__PURE__ */ new WeakMap();
-	constructor(config) {
-		this.#connectionPool = createKyselyConnectionPool(config.db);
-		this.#provider = config.provider;
-	}
-	get [fragnoDatabaseAdapterNameFakeSymbol]() {
-		return "kysely";
-	}
-	get [fragnoDatabaseAdapterVersionFakeSymbol]() {
-		return 0;
-	}
-	async close() {
-		await this.#connectionPool.close();
+var KyselyAdapter = class extends GenericSQLAdapter {
+	constructor(options) {
+		super(options);
 	}
 	createTableNameMapper(namespace) {
 		return createTableNameMapper(namespace);
 	}
-	createQueryEngine(schema, namespace) {
-		this.#schemaNamespaceMap.set(schema, namespace);
-		const mapper = namespace ? createTableNameMapper(namespace) : void 0;
-		return fromKysely(schema, this.#connectionPool, this.#provider, mapper, void 0, this.#schemaNamespaceMap);
-	}
-	async isConnectionHealthy() {
-		const conn = await this.#connectionPool.connect();
-		try {
-			return (await conn.db.executeQuery(sql`SELECT 1 as healthy`.compile(conn.db))).rows[0]["healthy"] === 1;
-		} catch {
-			return false;
-		} finally {
-			await conn.release();
-		}
-	}
-	createMigrationEngine(schema, namespace) {
-		const mapper = namespace ? createTableNameMapper(namespace) : void 0;
-		const preprocessMigrationOperations = (operations, db) => {
-			let preprocessed = preprocessOperations(operations, {
-				db,
-				provider: this.#provider
-			});
-			if (this.#provider === "mysql") {
-				preprocessed.unshift({
-					type: "custom",
-					sql: "SET FOREIGN_KEY_CHECKS = 0"
-				});
-				preprocessed.push({
-					type: "custom",
-					sql: "SET FOREIGN_KEY_CHECKS = 1"
-				});
-			}
-			return preprocessed;
-		};
-		const toExecutableNodes = (operations, db) => {
-			const onCustomNode = (node, db$1) => {
-				const statement = sql.raw(node["sql"]);
-				return {
-					compile() {
-						return statement.compile(db$1);
-					},
-					execute() {
-						return statement.execute(db$1);
-					}
-				};
-			};
-			const config = {
-				db,
-				provider: this.#provider
-			};
-			return operations.flatMap((op) => execute(op, config, (node) => onCustomNode(node, db), mapper));
-		};
-		return createMigrator({
-			schema,
-			executor: async (operations) => {
-				const conn = await this.#connectionPool.connect();
-				try {
-					if (this.#provider === "sqlite") await sql.raw("PRAGMA defer_foreign_keys = ON").execute(conn.db);
-					await conn.db.transaction().execute(async (tx) => {
-						const nodes = toExecutableNodes(preprocessMigrationOperations(operations, tx), tx);
-						for (const node of nodes) try {
-							await node.execute();
-						} catch (e) {
-							console.error("failed at", node.compile(), e);
-							throw e;
-						}
-					});
-				} finally {
-					await conn.release();
-				}
-			},
-			sql: { toSql: (operations) => {
-				const parts = [];
-				if (this.#provider === "sqlite") parts.push("PRAGMA defer_foreign_keys = ON;");
-				const db = this.#connectionPool.getDatabaseSync();
-				const compiled = toExecutableNodes(preprocessMigrationOperations(operations, db), db).map((node) => `${node.compile().sql};`);
-				parts.push(...compiled);
-				return parts.join("\n\n");
-			} },
-			settings: {
-				getVersion: async () => {
-					const conn = await this.#connectionPool.connect();
-					try {
-						const v = await createSettingsManager(conn.db, namespace).get(`schema_version`);
-						return v ? parseInt(v) : 0;
-					} finally {
-						await conn.release();
-					}
-				},
-				updateSettingsInMigration: async (fromVersion, toVersion) => {
-					const conn = await this.#connectionPool.connect();
-					try {
-						const manager = createSettingsManager(conn.db, namespace);
-						return [{
-							type: "custom",
-							sql: fromVersion === 0 ? manager.insert(`schema_version`, toVersion.toString()) : manager.update(`schema_version`, toVersion.toString())
-						}];
-					} finally {
-						await conn.release();
-					}
-				}
-			}
-		});
-	}
-	async getSchemaVersion(namespace) {
-		const conn = await this.#connectionPool.connect();
-		try {
-			return await createSettingsManager(conn.db, namespace).get(`schema_version`);
-		} finally {
-			await conn.release();
-		}
-	}
 };
-function createSettingsManager(db, namespace) {
-	const tableName = SETTINGS_TABLE_NAME;
-	return {
-		async get(key) {
-			try {
-				return (await db.selectFrom(tableName).where("key", "=", sql.lit(`${namespace}.${key}`)).select(["value"]).executeTakeFirstOrThrow()).value;
-			} catch {
-				return;
-			}
-		},
-		insert(key, value) {
-			return db.insertInto(tableName).values({
-				id: sql.lit(createHash("md5").update(`${namespace}.${key}`).digest("base64url").replace(/=/g, "")),
-				key: sql.lit(`${namespace}.${key}`),
-				value: sql.lit(value)
-			}).compile().sql;
-		},
-		update(key, value) {
-			return db.updateTable(tableName).set({ value: sql.lit(value) }).where("key", "=", sql.lit(`${namespace}.${key}`)).compile().sql;
-		}
-	};
-}
 
 //#endregion
 export { KyselyAdapter };

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

@@ -1 +1 @@
-{"version":3,"file":"kysely-adapter.js","names":["#connectionPool","#provider","#schemaNamespaceMap","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  #schemaNamespaceMap = new WeakMap<AnySchema, string>();\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  createTableNameMapper(namespace: string) {\n    return createTableNameMapper(namespace);\n  }\n\n  createQueryEngine<T extends AnySchema>(\n    schema: T,\n    namespace: string,\n  ): AbstractQuery<T, KyselyUOWConfig> {\n    // Register schema-namespace mapping\n    this.#schemaNamespaceMap.set(schema, namespace);\n\n    // Only create mapper if namespace is non-empty\n    const mapper = namespace ? createTableNameMapper(namespace) : undefined;\n    return fromKysely(\n      schema,\n      this.#connectionPool,\n      this.#provider,\n      mapper,\n      undefined,\n      this.#schemaNamespaceMap,\n    );\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":[],"sources":["../../../src/adapters/kysely/kysely-adapter.ts"],"sourcesContent":["import { type Kysely } from \"kysely\";\nimport type { SQLProvider } from \"../../shared/providers\";\nimport { type DatabaseAdapter } from \"../adapters\";\nimport { createTableNameMapper } from \"../shared/table-name-mapper\";\nimport {\n  GenericSQLAdapter,\n  type GenericSQLOptions,\n  type UnitOfWorkConfig,\n} from \"../generic-sql/generic-sql-adapter\";\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 extends GenericSQLAdapter implements DatabaseAdapter<UnitOfWorkConfig> {\n  constructor(options: GenericSQLOptions) {\n    super(options);\n  }\n\n  createTableNameMapper(namespace: string) {\n    return createTableNameMapper(namespace);\n  }\n}\n"],"mappings":";;;;;AAkBA,IAAa,gBAAb,cAAmC,kBAA+D;CAChG,YAAY,SAA4B;AACtC,QAAM,QAAQ;;CAGhB,sBAAsB,WAAmB;AACvC,SAAO,sBAAsB,UAAU"}

package/dist/adapters/{drizzle/drizzle-query.js → shared/from-unit-of-work-compiler.js}

@@ -1,13 +1,18 @@
-import { UnitOfWork } from "../../query/unit-of-work.js";
-import { parseDrizzle } from "./shared.js";
-import { createDrizzleUOWCompiler } from "./drizzle-uow-compiler.js";
-import { executeDrizzleMutationPhase, executeDrizzleRetrievalPhase } from "./drizzle-uow-executor.js";
-import { createDrizzleUOWDecoder } from "./drizzle-uow-decoder.js";
+import { UnitOfWork } from "../../query/unit-of-work/unit-of-work.js";
 
-//#region src/adapters/drizzle/drizzle-query.ts
+//#region src/adapters/shared/from-unit-of-work-compiler.ts
 /**
-* Special builder for updateMany operations that captures configuration
+* Type guard to check if a query is a CompiledMutation
 */
+function isCompiledMutation(query) {
+	return query !== null && typeof query === "object" && "expectedAffectedRows" in query && "query" in query;
+}
+/**
+* Type guard to check if a record has an id field
+*/
+function hasIdField(record) {
+	return record !== null && typeof record === "object" && "id" in record;
+}
 var UpdateManySpecialBuilder = class {
 	#indexName;
 	#condition;
@@ -30,73 +35,48 @@ var UpdateManySpecialBuilder = class {
 	}
 };
 /**
-* Creates a Drizzle-based query engine for the given schema.
+* Creates a generic SQL-based query engine for the given schema using a UnitOfWorkFactory.
 *
-* This is the main entry point for creating a database query interface using Drizzle.
+* This is the main entry point for creating a database query interface using a Unit of Work compiler.
 * It uses a compiler-based architecture where queries are compiled to SQL and then executed,
 * enabling features like SQL snapshot testing.
 *
 * @param schema - The database schema definition
-* @param pool - Connection pool for acquiring database connections
-* @param provider - SQL provider (sqlite, mysql, postgresql)
-* @param mapper - Optional table name mapper for namespace prefixing
-* @param uowConfig - Optional UOW configuration
-* @param schemaNamespaceMap - Optional WeakMap for schema-to-namespace lookups
-* @returns An AbstractQuery instance for performing database operations
+* @param factory - Factory containing compiler, executor, decoder, and optional configuration
+* @returns An SimpleQueryInterface instance for performing database operations
 *
 * @example
 * ```ts
-* const pool = createSimpleConnectionPool(drizzle);
-* const queryEngine = fromDrizzle(mySchema, pool, 'postgresql');
+* const operationCompiler = new GenericSQLUOWOperationCompiler(driverConfig);
+* const factory: UnitOfWorkFactory = {
+*   compiler: createUOWCompilerFromOperationCompiler(operationCompiler),
+*   executor: createExecutor(sqlDriver),
+*   decoder: createKyselyUOWDecoder(driverConfig.databaseType),
+* };
+* const queryEngine = fromUnitOfWorkCompiler(mySchema, factory);
 *
-* const uow = queryEngine.createUnitOfWork('myOperation');
+* const users = await queryEngine.find('users', (b) =>
+*   b.whereIndex('age').where((eb) => eb('age', '>', 18))
+* );
 * ```
 */
-function fromDrizzle(schema, pool, provider, mapper, uowConfig, schemaNamespaceMap) {
+function fromUnitOfWorkCompiler(schema, factory) {
+	const { compiler, executor, decoder, uowConfig, schemaNamespaceMap } = factory;
 	function createUOW(opts) {
-		const uowCompiler = createDrizzleUOWCompiler(pool, provider, mapper);
-		const executor = {
-			async executeRetrievalPhase(retrievalBatch) {
-				if (opts.config?.dryRun) return retrievalBatch.map(() => ({
-					rows: [],
-					affectedRows: 0
-				}));
-				const conn = await pool.connect();
-				try {
-					const db = parseDrizzle(conn.db)[0];
-					return await executeDrizzleRetrievalPhase(db, retrievalBatch, provider);
-				} finally {
-					await conn.release();
-				}
-			},
-			async executeMutationPhase(mutationBatch) {
-				if (opts.config?.dryRun) return {
-					success: true,
-					createdInternalIds: mutationBatch.map(() => null)
-				};
-				const conn = await pool.connect();
-				try {
-					const db = parseDrizzle(conn.db)[0];
-					return await executeDrizzleMutationPhase(db, mutationBatch, provider);
-				} finally {
-					await conn.release();
-				}
-			}
-		};
-		const decoder = createDrizzleUOWDecoder(provider);
 		const { onQuery,...restUowConfig } = opts.config ?? {};
-		return new UnitOfWork(schema, uowCompiler, executor, decoder, opts.name, {
+		return new UnitOfWork(compiler, executor, decoder, opts.name, {
 			...restUowConfig,
-			onQuery: (query) => {
-				const actualQuery = query && typeof query === "object" && "query" in query ? query.query : query;
-				opts.config?.onQuery?.(actualQuery);
-			}
-		}, schemaNamespaceMap);
+			onQuery: onQuery ? (query) => {
+				onQuery(isCompiledMutation(query) ? query.query : query);
+			} : void 0
+		}, schemaNamespaceMap).forSchema(schema);
 	}
 	return {
 		async find(tableName, builderFn) {
-			const [result] = await createUOW({ config: uowConfig }).find(tableName, builderFn).executeRetrieve();
-			return result;
+			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();
@@ -143,13 +123,16 @@ function fromDrizzle(schema, pool, provider, mapper, uowConfig, schemaNamespaceM
 			if (!setValues) throw new Error("set() must be called in updateMany");
 			const findUow = createUOW({ config: uowConfig });
 			findUow.find(tableName, (b) => {
-				if (condition) return b.whereIndex(indexName, condition);
+				if (condition !== void 0 && condition !== null) return b.whereIndex(indexName, condition);
 				return b.whereIndex(indexName);
 			});
 			const [records] = await findUow.executeRetrieve();
 			if (!records || records.length === 0) return;
 			const updateUow = createUOW({ config: uowConfig });
-			for (const record of records) updateUow.update(tableName, record.id, (b) => b.set(setValues));
+			for (const record of records) {
+				if (!hasIdField(record)) throw new Error("Record missing id field");
+				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)");
 		},
@@ -165,7 +148,10 @@ function fromDrizzle(schema, pool, provider, mapper, uowConfig, schemaNamespaceM
 			const [records] = await findUow.executeRetrieve();
 			if (!records || records.length === 0) return;
 			const deleteUow = createUOW({ config: uowConfig });
-			for (const record of records) deleteUow.delete(tableName, record.id);
+			for (const record of records) {
+				if (!hasIdField(record)) throw new Error("Record missing id field");
+				deleteUow.delete(tableName, record.id);
+			}
 			const { success } = await deleteUow.executeMutations();
 			if (!success) throw new Error("Failed to delete records (version conflict)");
 		},
@@ -182,5 +168,5 @@ function fromDrizzle(schema, pool, provider, mapper, uowConfig, schemaNamespaceM
 }
 
 //#endregion
-export { fromDrizzle };
-//# sourceMappingURL=drizzle-query.js.map
+export { fromUnitOfWorkCompiler };
+//# sourceMappingURL=from-unit-of-work-compiler.js.map

package/dist/adapters/shared/from-unit-of-work-compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-unit-of-work-compiler.js","names":["#indexName","#condition","#setValues"],"sources":["../../../src/adapters/shared/from-unit-of-work-compiler.ts"],"sourcesContent":["import type { SimpleQueryInterface, TableToUpdateValues } from \"../../query/simple-query-interface\";\nimport type { AnySchema, AnyTable, FragnoId } from \"../../schema/create\";\nimport type {\n  CompiledMutation,\n  UOWCompiler,\n  UOWDecoder,\n  UOWExecutor,\n  ValidIndexName,\n} from \"../../query/unit-of-work/unit-of-work\";\nimport { UnitOfWork } from \"../../query/unit-of-work/unit-of-work\";\nimport type { CursorResult } from \"../../query/cursor\";\nimport type { CompiledQuery } from \"../../sql-driver/sql-driver\";\n\n/**\n * Configuration options for creating a Unit of Work with generic SQL\n */\nexport interface UnitOfWorkConfig {\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 * Factory interface for creating Unit of Work instances\n */\nexport interface UnitOfWorkFactory {\n  /**\n   * UOW compiler for compiling operations to SQL\n   */\n  compiler: UOWCompiler<CompiledQuery>;\n  /**\n   * UOW executor for running compiled queries\n   */\n  executor: UOWExecutor<CompiledQuery, unknown>;\n  /**\n   * UOW decoder for transforming raw results\n   */\n  decoder: UOWDecoder<unknown>;\n  /**\n   * Optional UOW configuration\n   */\n  uowConfig?: UnitOfWorkConfig;\n  /**\n   * Optional WeakMap for schema-to-namespace lookups\n   */\n  schemaNamespaceMap?: WeakMap<AnySchema, string>;\n}\n\n/**\n * Type guard to check if a query is a CompiledMutation\n */\nfunction isCompiledMutation(query: unknown): query is CompiledMutation<CompiledQuery> {\n  return (\n    query !== null &&\n    typeof query === \"object\" &&\n    \"expectedAffectedRows\" in query &&\n    \"query\" in query\n  );\n}\n\n/**\n * Type guard to check if a record has an id field\n */\nfunction hasIdField(record: unknown): record is { id: string | FragnoId } {\n  return record !== null && typeof record === \"object\" && \"id\" in record;\n}\n\nclass UpdateManySpecialBuilder<TTable extends AnyTable> {\n  #indexName?: ValidIndexName<TTable>;\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;\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 generic SQL-based query engine for the given schema using a UnitOfWorkFactory.\n *\n * This is the main entry point for creating a database query interface using a Unit of Work compiler.\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 factory - Factory containing compiler, executor, decoder, and optional configuration\n * @returns An SimpleQueryInterface instance for performing database operations\n *\n * @example\n * ```ts\n * const operationCompiler = new GenericSQLUOWOperationCompiler(driverConfig);\n * const factory: UnitOfWorkFactory = {\n *   compiler: createUOWCompilerFromOperationCompiler(operationCompiler),\n *   executor: createExecutor(sqlDriver),\n *   decoder: createKyselyUOWDecoder(driverConfig.databaseType),\n * };\n * const queryEngine = fromUnitOfWorkCompiler(mySchema, factory);\n *\n * const users = await queryEngine.find('users', (b) =>\n *   b.whereIndex('age').where((eb) => eb('age', '>', 18))\n * );\n * ```\n */\nexport function fromUnitOfWorkCompiler<T extends AnySchema>(\n  schema: T,\n  factory: UnitOfWorkFactory,\n): SimpleQueryInterface<T, UnitOfWorkConfig> {\n  const { compiler, executor, decoder, uowConfig, schemaNamespaceMap } = factory;\n\n  function createUOW(opts: { name?: string; config?: UnitOfWorkConfig }) {\n    const { onQuery, ...restUowConfig } = opts.config ?? {};\n\n    return new UnitOfWork(\n      compiler,\n      executor,\n      decoder,\n      opts.name,\n      {\n        ...restUowConfig,\n        onQuery: onQuery\n          ? (query) => {\n              // Extract the actual query from CompiledMutation if needed\n              const actualQuery = isCompiledMutation(query)\n                ? query.query\n                : (query as CompiledQuery);\n              onQuery(actualQuery);\n            }\n          : undefined,\n      },\n      schemaNamespaceMap,\n    ).forSchema(schema);\n  }\n\n  return {\n    async find(tableName, builderFn) {\n      const uow = createUOW({ config: uowConfig });\n      uow.find(tableName, builderFn);\n      const [result]: unknown[][] = await uow.executeRetrieve();\n      return result ?? [];\n    },\n\n    async findWithCursor(tableName, builderFn) {\n      const uow = createUOW({ config: uowConfig }).findWithCursor(tableName, builderFn);\n      const [result] = await uow.executeRetrieve();\n      // Result from findWithCursor is always a CursorResult - the UOW decoder handles the conversion\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        // Condition might be null or undefined, only pass if defined and not null\n        if (condition !== undefined && condition !== null) {\n          // TypeScript can't infer the complex condition type from the builder\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          return b.whereIndex(indexName, condition as any);\n        }\n        return b.whereIndex(indexName);\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) {\n        if (!hasIdField(record)) {\n          throw new Error(\"Record missing id field\");\n        }\n        updateUow.update(tableName, record.id, (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) {\n        if (!hasIdField(record)) {\n          throw new Error(\"Record missing id field\");\n        }\n        deleteUow.delete(tableName, record.id);\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 SimpleQueryInterface<T, UnitOfWorkConfig>;\n}\n"],"mappings":";;;;;;AA0DA,SAAS,mBAAmB,OAA0D;AACpF,QACE,UAAU,QACV,OAAO,UAAU,YACjB,0BAA0B,SAC1B,WAAW;;;;;AAOf,SAAS,WAAW,QAAsD;AACxE,QAAO,WAAW,QAAQ,OAAO,WAAW,YAAY,QAAQ;;AAGlE,IAAM,2BAAN,MAAwD;CACtD;CACA;CACA;CAEA,WACE,WACA,WACM;AACN,QAAKA,YAAa;AAClB,QAAKC,YAAa;AAClB,SAAO;;CAGT,IAAI,QAA2C;AAC7C,QAAKC,YAAa;AAClB,SAAO;;CAGT,YAAY;AACV,SAAO;GACL,WAAW,MAAKF;GAChB,WAAW,MAAKC;GAChB,WAAW,MAAKC;GACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BL,SAAgB,uBACd,QACA,SAC2C;CAC3C,MAAM,EAAE,UAAU,UAAU,SAAS,WAAW,uBAAuB;CAEvE,SAAS,UAAU,MAAoD;EACrE,MAAM,EAAE,QAAS,GAAG,kBAAkB,KAAK,UAAU,EAAE;AAEvD,SAAO,IAAI,WACT,UACA,UACA,SACA,KAAK,MACL;GACE,GAAG;GACH,SAAS,WACJ,UAAU;AAKT,YAHoB,mBAAmB,MAAM,GACzC,MAAM,QACL,MACe;OAEtB;GACL,EACD,mBACD,CAAC,UAAU,OAAO;;AAGrB,QAAO;EACL,MAAM,KAAK,WAAW,WAAW;GAC/B,MAAM,MAAM,UAAU,EAAE,QAAQ,WAAW,CAAC;AAC5C,OAAI,KAAK,WAAW,UAAU;GAC9B,MAAM,CAAC,UAAuB,MAAM,IAAI,iBAAiB;AACzD,UAAO,UAAU,EAAE;;EAGrB,MAAM,eAAe,WAAW,WAAW;GAEzC,MAAM,CAAC,UAAU,MADL,UAAU,EAAE,QAAQ,WAAW,CAAC,CAAC,eAAe,WAAW,UAAU,CACtD,iBAAiB;AAE5C,UAAO;;EAGT,MAAM,UAAU,WAAW,WAAW;GACpC,MAAM,MAAM,UAAU,EAAE,QAAQ,WAAW,CAAC;AAC5C,OAAI,UACF,KAAI,KAAK,YAAY,MAAM;AACzB,cAAU,EAAE;AACZ,WAAO,EAAE,SAAS,EAAE;KACpB;OAEF,KAAI,KAAK,YAAY,MAAM,EAAE,WAAW,UAAU,CAAC,SAAS,EAAE,CAAC;GAGjE,MAAM,CAAC,UAAuB,MAAM,IAAI,iBAAiB;AACzD,UAAO,SAAS,MAAM;;EAGxB,MAAM,OAAO,WAAW,QAAQ;GAC9B,MAAM,MAAM,UAAU,EAAE,QAAQ,WAAW,CAAC;AAC5C,OAAI,OAAO,WAAW,OAAO;GAC7B,MAAM,EAAE,YAAY,MAAM,IAAI,kBAAkB;AAChD,OAAI,CAAC,QACH,OAAM,IAAI,MAAM,0BAA0B;GAI5C,MAAM,YADa,IAAI,eAAe,CACT;AAC7B,OAAI,CAAC,UACH,OAAM,IAAI,MAAM,2BAA2B;AAE7C,UAAO;;EAGT,MAAM,WAAW,WAAW,aAAa;GACvC,MAAM,MAAM,UAAU,EAAE,QAAQ,WAAW,CAAC;AAC5C,QAAK,MAAM,UAAU,YACnB,KAAI,OAAO,WAAW,OAAO;GAE/B,MAAM,EAAE,YAAY,MAAM,IAAI,kBAAkB;AAChD,OAAI,CAAC,QACH,OAAM,IAAI,MAAM,2BAA2B;AAG7C,UAAO,IAAI,eAAe;;EAG5B,MAAM,OAAO,WAAW,IAAI,WAAW;GACrC,MAAM,MAAM,UAAU,EAAE,QAAQ,WAAW,CAAC;AAC5C,OAAI,OAAO,WAAW,IAAI,UAAU;GACpC,MAAM,EAAE,YAAY,MAAM,IAAI,kBAAkB;AAChD,OAAI,CAAC,QACH,OAAM,IAAI,MAAM,iEAAiE;;EAIrF,MAAM,WAAW,WAAW,WAAW;AAErC,OAAI,CADU,OAAO,OAAO,WAE1B,OAAM,IAAI,MAAM,SAAS,UAAU,sBAAsB;GAG3D,MAAM,iBAAiB,IAAI,0BAAwC;AACnE,aAAU,eAAe;GAEzB,MAAM,EAAE,WAAW,WAAW,cAAc,eAAe,WAAW;AAEtE,OAAI,CAAC,UACH,OAAM,IAAI,MAAM,4CAA4C;AAE9D,OAAI,CAAC,UACH,OAAM,IAAI,MAAM,qCAAqC;GAGvD,MAAM,UAAU,UAAU,EAAE,QAAQ,WAAW,CAAC;AAChD,WAAQ,KAAK,YAAY,MAAM;AAE7B,QAAI,cAAc,UAAa,cAAc,KAG3C,QAAO,EAAE,WAAW,WAAW,UAAiB;AAElD,WAAO,EAAE,WAAW,UAAU;KAC9B;GACF,MAAM,CAAC,WAAwB,MAAM,QAAQ,iBAAiB;AAE9D,OAAI,CAAC,WAAW,QAAQ,WAAW,EACjC;GAGF,MAAM,YAAY,UAAU,EAAE,QAAQ,WAAW,CAAC;AAClD,QAAK,MAAM,UAAU,SAAS;AAC5B,QAAI,CAAC,WAAW,OAAO,CACrB,OAAM,IAAI,MAAM,0BAA0B;AAE5C,cAAU,OAAO,WAAW,OAAO,KAAK,MAAM,EAAE,IAAI,UAAU,CAAC;;GAEjE,MAAM,EAAE,YAAY,MAAM,UAAU,kBAAkB;AACtD,OAAI,CAAC,QACH,OAAM,IAAI,MAAM,8CAA8C;;EAIlE,MAAM,OAAO,WAAW,IAAI,WAAW;GACrC,MAAM,MAAM,UAAU,EAAE,QAAQ,WAAW,CAAC;AAC5C,OAAI,OAAO,WAAW,IAAI,UAAU;GACpC,MAAM,EAAE,YAAY,MAAM,IAAI,kBAAkB;AAChD,OAAI,CAAC,QACH,OAAM,IAAI,MAAM,iEAAiE;;EAIrF,MAAM,WAAW,WAAW,WAAW;GACrC,MAAM,UAAU,UAAU,EAAE,QAAQ,WAAW,CAAC;AAChD,WAAQ,KAAK,WAAW,UAAU;GAClC,MAAM,CAAC,WAAwB,MAAM,QAAQ,iBAAiB;AAE9D,OAAI,CAAC,WAAW,QAAQ,WAAW,EACjC;GAGF,MAAM,YAAY,UAAU,EAAE,QAAQ,WAAW,CAAC;AAClD,QAAK,MAAM,UAAU,SAAS;AAC5B,QAAI,CAAC,WAAW,OAAO,CACrB,OAAM,IAAI,MAAM,0BAA0B;AAE5C,cAAU,OAAO,WAAW,OAAO,GAAG;;GAExC,MAAM,EAAE,YAAY,MAAM,UAAU,kBAAkB;AACtD,OAAI,CAAC,QACH,OAAM,IAAI,MAAM,8CAA8C;;EAIlE,iBAAiB,MAAM,iBAAiB;AACtC,UAAO,UAAU;IACf;IACA,QAAQ;KACN,GAAG;KACH,GAAG;KACJ;IACF,CAAC;;EAEL"}

package/dist/adapters/{kysely/kysely-shared.d.ts → shared/table-name-mapper.d.ts}

@@ -1,4 +1,5 @@
-//#region src/adapters/kysely/kysely-shared.d.ts
+//#region src/adapters/shared/table-name-mapper.d.ts
+
 /**
  * Maps logical table names (used by fragment authors) to physical table names (with namespace suffix)
  */
@@ -8,4 +9,4 @@ interface TableNameMapper {
 }
 //#endregion
 export { TableNameMapper };
-//# sourceMappingURL=kysely-shared.d.ts.map
+//# sourceMappingURL=table-name-mapper.d.ts.map

package/dist/adapters/shared/table-name-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-name-mapper.d.ts","names":[],"sources":["../../../src/adapters/shared/table-name-mapper.ts"],"sourcesContent":[],"mappings":";;;;;UAeiB,eAAA"}

package/dist/adapters/shared/table-name-mapper.js

@@ -0,0 +1,43 @@
+//#region src/adapters/shared/table-name-mapper.ts
+/**
+* Sanitizes a namespace for use in database table names and TypeScript exports.
+* Converts dashes to underscores to ensure compatibility with SQL identifiers
+* and Drizzle's relational query system.
+*
+* @example
+* sanitizeNamespace("my-fragment") // => "my_fragment"
+*/
+function sanitizeNamespace(namespace) {
+	return namespace.replace(/-/g, "_");
+}
+/**
+* Creates a table name mapper for a given namespace.
+* Physical names have format: {logicalName}_{namespace} (or {logicalName}_{sanitizedNamespace} if sanitize is true)
+*
+* @param namespace - The namespace to use for table name prefixing
+* @param sanitize - Whether to sanitize the namespace by converting dashes to underscores (default: false)
+* @returns A table name mapper with toPhysical and toLogical methods
+*
+* @example
+* const mapper = createTableNameMapper("my-fragment");
+* mapper.toPhysical("users") // => "users_my-fragment"
+*
+* @example
+* const mapper = createTableNameMapper("my-fragment", true);
+* mapper.toPhysical("users") // => "users_my_fragment"
+* mapper.toLogical("users_my_fragment") // => "users"
+*/
+function createTableNameMapper(namespace, sanitize = false) {
+	const processedNamespace = sanitize ? sanitizeNamespace(namespace) : namespace;
+	return {
+		toPhysical: (logicalName) => `${logicalName}_${processedNamespace}`,
+		toLogical: (physicalName) => {
+			if (physicalName.endsWith(`_${processedNamespace}`)) return physicalName.slice(0, -(processedNamespace.length + 1));
+			return physicalName;
+		}
+	};
+}
+
+//#endregion
+export { createTableNameMapper, sanitizeNamespace };
+//# sourceMappingURL=table-name-mapper.js.map

package/dist/adapters/shared/table-name-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-name-mapper.js","names":[],"sources":["../../../src/adapters/shared/table-name-mapper.ts"],"sourcesContent":["/**\n * Sanitizes a namespace for use in database table names and TypeScript exports.\n * Converts dashes to underscores to ensure compatibility with SQL identifiers\n * and Drizzle's relational query system.\n *\n * @example\n * sanitizeNamespace(\"my-fragment\") // => \"my_fragment\"\n */\nexport function sanitizeNamespace(namespace: string): string {\n  return namespace.replace(/-/g, \"_\");\n}\n\n/**\n * Maps logical table names (used by fragment authors) to physical table names (with namespace suffix)\n */\nexport interface TableNameMapper {\n  toPhysical(logicalName: string): string;\n  toLogical(physicalName: string): string;\n}\n\n/**\n * Creates a table name mapper for a given namespace.\n * Physical names have format: {logicalName}_{namespace} (or {logicalName}_{sanitizedNamespace} if sanitize is true)\n *\n * @param namespace - The namespace to use for table name prefixing\n * @param sanitize - Whether to sanitize the namespace by converting dashes to underscores (default: false)\n * @returns A table name mapper with toPhysical and toLogical methods\n *\n * @example\n * const mapper = createTableNameMapper(\"my-fragment\");\n * mapper.toPhysical(\"users\") // => \"users_my-fragment\"\n *\n * @example\n * const mapper = createTableNameMapper(\"my-fragment\", true);\n * mapper.toPhysical(\"users\") // => \"users_my_fragment\"\n * mapper.toLogical(\"users_my_fragment\") // => \"users\"\n */\nexport function createTableNameMapper(namespace: string, sanitize = false): TableNameMapper {\n  const processedNamespace = sanitize ? sanitizeNamespace(namespace) : namespace;\n\n  return {\n    toPhysical: (logicalName: string) => `${logicalName}_${processedNamespace}`,\n    toLogical: (physicalName: string) => {\n      if (physicalName.endsWith(`_${processedNamespace}`)) {\n        return physicalName.slice(0, -(processedNamespace.length + 1));\n      }\n      return physicalName;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAQA,SAAgB,kBAAkB,WAA2B;AAC3D,QAAO,UAAU,QAAQ,MAAM,IAAI;;;;;;;;;;;;;;;;;;;AA4BrC,SAAgB,sBAAsB,WAAmB,WAAW,OAAwB;CAC1F,MAAM,qBAAqB,WAAW,kBAAkB,UAAU,GAAG;AAErE,QAAO;EACL,aAAa,gBAAwB,GAAG,YAAY,GAAG;EACvD,YAAY,iBAAyB;AACnC,OAAI,aAAa,SAAS,IAAI,qBAAqB,CACjD,QAAO,aAAa,MAAM,GAAG,EAAE,mBAAmB,SAAS,GAAG;AAEhE,UAAO;;EAEV"}