@fragno-dev/db 0.1.14 → 0.2.0

package/dist/adapters/generic-sql/query/select-builder.js

@@ -0,0 +1,69 @@
+//#region src/adapters/generic-sql/query/select-builder.ts
+/**
+* Maps a select clause to SQL column names with optional aliases.
+*
+* Converts application-level select clauses (either array of keys or "select all")
+* into SQL-compatible column selections with proper aliasing for relations.
+*
+* @param select - The select clause (array of keys or true for all columns)
+* @param table - The table schema containing column definitions
+* @param options - Optional configuration
+* @param options.relation - Relation name to prefix in aliases (for joined data)
+* @param options.tableName - Override the table name in the SQL (defaults to table.name)
+* @returns Array of SQL select strings in the format "tableName.columnName as alias"
+* @internal
+*/
+function mapSelect(select, table, options = {}) {
+	const { relation, tableName = table.name } = options;
+	const out = [];
+	const keys = Array.isArray(select) ? select : Object.keys(table.columns);
+	for (const key of keys) {
+		const col = table.columns[key];
+		if (Array.isArray(select) && col.isHidden) continue;
+		const name = relation ? `${relation}:${key}` : key;
+		out.push(`${tableName}.${col.name} as ${name}`);
+	}
+	for (const key in table.columns) {
+		const col = table.columns[key];
+		if (col.isHidden && !keys.includes(key)) {
+			const name = relation ? `${relation}:${key}` : key;
+			out.push(`${tableName}.${col.name} as ${name}`);
+		}
+	}
+	return out;
+}
+/**
+* Creates a builder that can extend a select clause with additional keys.
+*
+* This is useful when you need to temporarily include columns for join operations
+* or other internal processing, but don't want them in the final result.
+*
+* @param original - The original select clause from the user
+* @returns A select builder with extend() and compile() methods
+* @internal
+*/
+function extendSelect(original) {
+	const select = Array.isArray(original) ? new Set(original) : true;
+	const extendedKeys = [];
+	return {
+		extend(key) {
+			if (select === true || select.has(key)) return;
+			select.add(key);
+			extendedKeys.push(key);
+		},
+		compile() {
+			return {
+				result: select instanceof Set ? Array.from(select) : true,
+				extendedKeys,
+				removeExtendedKeys(record) {
+					for (const key of extendedKeys) delete record[key];
+					return record;
+				}
+			};
+		}
+	};
+}
+
+//#endregion
+export { extendSelect, mapSelect };
+//# sourceMappingURL=select-builder.js.map

package/dist/adapters/generic-sql/query/select-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-builder.js","names":["out: string[]","extendedKeys: string[]"],"sources":["../../../../src/adapters/generic-sql/query/select-builder.ts"],"sourcesContent":["import type { AnyTable } from \"../../../schema/create\";\nimport type { AnySelectClause } from \"../../../query/simple-query-interface\";\n\n/**\n * Maps a select clause to SQL column names with optional aliases.\n *\n * Converts application-level select clauses (either array of keys or \"select all\")\n * into SQL-compatible column selections with proper aliasing for relations.\n *\n * @param select - The select clause (array of keys or true for all columns)\n * @param table - The table schema containing column definitions\n * @param options - Optional configuration\n * @param options.relation - Relation name to prefix in aliases (for joined data)\n * @param options.tableName - Override the table name in the SQL (defaults to table.name)\n * @returns Array of SQL select strings in the format \"tableName.columnName as alias\"\n * @internal\n */\nexport function mapSelect(\n  select: AnySelectClause,\n  table: AnyTable,\n  options: {\n    relation?: string;\n    tableName?: string;\n  } = {},\n): string[] {\n  const { relation, tableName = table.name } = options;\n  const out: string[] = [];\n  const keys = Array.isArray(select) ? select : Object.keys(table.columns);\n\n  for (const key of keys) {\n    const col = table.columns[key];\n\n    // Skip hidden columns when explicitly selecting\n    if (Array.isArray(select) && col.isHidden) {\n      continue;\n    }\n\n    // Add the column to the select list\n    const name = relation ? `${relation}:${key}` : key;\n    out.push(`${tableName}.${col.name} as ${name}`);\n  }\n\n  // Always include hidden columns (for FragnoId construction with internal ID and version)\n  for (const key in table.columns) {\n    const col = table.columns[key];\n    if (col.isHidden && !keys.includes(key)) {\n      const name = relation ? `${relation}:${key}` : key;\n      out.push(`${tableName}.${col.name} as ${name}`);\n    }\n  }\n\n  return out;\n}\n\n/**\n * Result type from compiling a select clause with extensions.\n * @internal\n */\nexport interface CompiledSelect {\n  /**\n   * The final select clause to use in the query\n   */\n  result: AnySelectClause;\n\n  /**\n   * Keys that were added to the select clause (not originally requested)\n   */\n  extendedKeys: string[];\n\n  /**\n   * Removes the extended keys from a record (mutates the record).\n   * Used to clean up keys that were only needed for join operations.\n   *\n   * @param record - The record to remove extended keys from\n   * @returns The same record with extended keys removed\n   */\n  removeExtendedKeys: (record: Record<string, unknown>) => Record<string, unknown>;\n}\n\n/**\n * Builder for extending a select clause with additional keys.\n * @internal\n */\nexport interface SelectBuilder {\n  /**\n   * Adds a key to the select clause if not already present.\n   * Tracks which keys were added for later removal.\n   *\n   * @param key - The key to add to the select clause\n   */\n  extend: (key: string) => void;\n\n  /**\n   * Compiles the select clause into its final form.\n   *\n   * @returns The compiled select information\n   */\n  compile: () => CompiledSelect;\n}\n\n/**\n * Creates a builder that can extend a select clause with additional keys.\n *\n * This is useful when you need to temporarily include columns for join operations\n * or other internal processing, but don't want them in the final result.\n *\n * @param original - The original select clause from the user\n * @returns A select builder with extend() and compile() methods\n * @internal\n */\nexport function extendSelect(original: AnySelectClause): SelectBuilder {\n  const select = Array.isArray(original) ? new Set(original) : true;\n  const extendedKeys: string[] = [];\n\n  return {\n    extend(key) {\n      if (select === true || select.has(key)) {\n        return;\n      }\n\n      select.add(key);\n      extendedKeys.push(key);\n    },\n    compile() {\n      return {\n        result: select instanceof Set ? Array.from(select) : true,\n        extendedKeys,\n        removeExtendedKeys(record) {\n          for (const key of extendedKeys) {\n            delete record[key];\n          }\n          return record;\n        },\n      };\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAiBA,SAAgB,UACd,QACA,OACA,UAGI,EAAE,EACI;CACV,MAAM,EAAE,UAAU,YAAY,MAAM,SAAS;CAC7C,MAAMA,MAAgB,EAAE;CACxB,MAAM,OAAO,MAAM,QAAQ,OAAO,GAAG,SAAS,OAAO,KAAK,MAAM,QAAQ;AAExE,MAAK,MAAM,OAAO,MAAM;EACtB,MAAM,MAAM,MAAM,QAAQ;AAG1B,MAAI,MAAM,QAAQ,OAAO,IAAI,IAAI,SAC/B;EAIF,MAAM,OAAO,WAAW,GAAG,SAAS,GAAG,QAAQ;AAC/C,MAAI,KAAK,GAAG,UAAU,GAAG,IAAI,KAAK,MAAM,OAAO;;AAIjD,MAAK,MAAM,OAAO,MAAM,SAAS;EAC/B,MAAM,MAAM,MAAM,QAAQ;AAC1B,MAAI,IAAI,YAAY,CAAC,KAAK,SAAS,IAAI,EAAE;GACvC,MAAM,OAAO,WAAW,GAAG,SAAS,GAAG,QAAQ;AAC/C,OAAI,KAAK,GAAG,UAAU,GAAG,IAAI,KAAK,MAAM,OAAO;;;AAInD,QAAO;;;;;;;;;;;;AA2DT,SAAgB,aAAa,UAA0C;CACrE,MAAM,SAAS,MAAM,QAAQ,SAAS,GAAG,IAAI,IAAI,SAAS,GAAG;CAC7D,MAAMC,eAAyB,EAAE;AAEjC,QAAO;EACL,OAAO,KAAK;AACV,OAAI,WAAW,QAAQ,OAAO,IAAI,IAAI,CACpC;AAGF,UAAO,IAAI,IAAI;AACf,gBAAa,KAAK,IAAI;;EAExB,UAAU;AACR,UAAO;IACL,QAAQ,kBAAkB,MAAM,MAAM,KAAK,OAAO,GAAG;IACrD;IACA,mBAAmB,QAAQ;AACzB,UAAK,MAAM,OAAO,aAChB,QAAO,OAAO;AAEhB,YAAO;;IAEV;;EAEJ"}

package/dist/adapters/generic-sql/query/sql-query-compiler.js

@@ -0,0 +1,145 @@
+import { buildWhere, fullSQLName } from "./where-builder.js";
+import { extendSelect, mapSelect } from "./select-builder.js";
+import { UnitOfWorkEncoder } from "../uow-encoder.js";
+import { sql } from "kysely";
+
+//#region src/adapters/generic-sql/query/sql-query-compiler.ts
+/**
+* Abstract base class for SQL query compilation.
+*
+* Similar to SQLGenerator for migrations, this class provides a framework
+* for compiling runtime queries with dialect-specific behavior.
+*
+* Each database dialect extends this class and implements the abstract methods
+* to handle database-specific SQL generation (like .limit() vs .top()).
+*/
+var SQLQueryCompiler = class {
+	db;
+	driverConfig;
+	database;
+	mapper;
+	encoder;
+	constructor(db, driverConfig, mapper) {
+		this.db = db;
+		this.driverConfig = driverConfig;
+		this.database = driverConfig.databaseType;
+		this.mapper = mapper;
+		this.encoder = new UnitOfWorkEncoder(driverConfig, db, mapper);
+	}
+	/**
+	* Get the physical table name, applying namespace mapping if provided.
+	*/
+	getTableName(table) {
+		return this.mapper ? this.mapper.toPhysical(table.name) : table.name;
+	}
+	/**
+	* Build WHERE clause from a condition tree.
+	*/
+	buildWhereClause(condition, eb, table) {
+		return buildWhere(condition, eb, this.driverConfig, this.mapper, table);
+	}
+	/**
+	* Process joins recursively to support nested joins.
+	*/
+	processJoins(query, joins, parentTable, parentTableName, mappedSelect, parentPath = "") {
+		let result = query;
+		for (const join of joins) {
+			const { options: joinOptions, relation } = join;
+			if (joinOptions === false) continue;
+			const targetTable = relation.table;
+			const fullPath = parentPath ? `${parentPath}:${relation.name}` : relation.name;
+			const joinName = fullPath.replace(/:/g, "_");
+			mappedSelect.push(...mapSelect(joinOptions.select, targetTable, {
+				relation: fullPath,
+				tableName: joinName
+			}));
+			result = result.leftJoin(`${this.getTableName(targetTable)} as ${joinName}`, (b) => b.on((eb) => {
+				const conditions = [];
+				for (const [left, right] of relation.on) {
+					const actualRight = targetTable.columns[right]?.role === "external-id" ? "_internalId" : right;
+					conditions.push(eb(`${parentTableName}.${parentTable.columns[left].name}`, "=", eb.ref(`${joinName}.${targetTable.columns[actualRight].name}`)));
+				}
+				if (joinOptions.where) conditions.push(this.buildWhereClause(joinOptions.where, eb, targetTable));
+				return eb.and(conditions);
+			}));
+			if (joinOptions.join && joinOptions.join.length > 0) result = this.processJoins(result, joinOptions.join, targetTable, joinName, mappedSelect, fullPath);
+		}
+		return result;
+	}
+	/**
+	* Compile a COUNT query.
+	*/
+	compileCount(table, options) {
+		let query = this.db.selectFrom(this.getTableName(table)).select(this.db.fn.countAll().as("count"));
+		if (options.where) query = query.where((b) => this.buildWhereClause(options.where, b, table));
+		return query.compile();
+	}
+	/**
+	* Compile a FIND MANY query.
+	*/
+	compileFindMany(table, options) {
+		let query = this.db.selectFrom(this.getTableName(table));
+		const whereQuery = options.where;
+		if (whereQuery) query = query.where((eb) => this.buildWhereClause(whereQuery, eb, table));
+		if (options.offset !== void 0) query = this.applyOffset(query, options.offset);
+		if (options.limit !== void 0) query = this.applyLimit(query, options.limit);
+		if (options.orderBy) for (const [col, mode] of options.orderBy) query = query.orderBy(fullSQLName(col, this.mapper), mode);
+		const selectBuilder = extendSelect(options.select);
+		const mappedSelect = [];
+		if (options.join && options.join.length > 0) query = this.processJoins(query, options.join, table, this.getTableName(table), mappedSelect);
+		const compiledSelect = selectBuilder.compile();
+		mappedSelect.push(...mapSelect(compiledSelect.result, table, { tableName: this.getTableName(table) }));
+		return query.select(mappedSelect).compile();
+	}
+	/**
+	* Compile a CREATE (INSERT) query.
+	*/
+	compileCreate(table, values) {
+		const encodedValues = this.encoder.encodeForDatabase({
+			values,
+			table,
+			generateDefaults: true
+		});
+		let insert = this.db.insertInto(this.getTableName(table)).values(encodedValues);
+		if (this.driverConfig.supportsReturning) {
+			const columns = mapSelect(true, table, { tableName: this.getTableName(table) });
+			insert = this.applyReturning(insert, columns);
+		}
+		return insert.compile();
+	}
+	/**
+	* Compile an UPDATE query.
+	*/
+	compileUpdate(table, options) {
+		const encoded = this.encoder.encodeForDatabase({
+			values: options.set,
+			table,
+			generateDefaults: false
+		});
+		const versionCol = table.getVersionColumn();
+		encoded[versionCol.name] = sql.raw(`COALESCE(${versionCol.name}, 0) + 1`);
+		let query = this.db.updateTable(this.getTableName(table)).set(encoded);
+		if (options.where) query = query.where((eb) => this.buildWhereClause(options.where, eb, table));
+		if (options.returning && this.driverConfig.supportsReturning) return query.returning(sql`1`.as("_returned")).compile();
+		return query.compile();
+	}
+	/**
+	* Compile a DELETE query.
+	*/
+	compileDelete(table, options) {
+		let query = this.db.deleteFrom(this.getTableName(table));
+		if (options.where) query = query.where((eb) => this.buildWhereClause(options.where, eb, table));
+		if (options.returning && this.driverConfig.supportsReturning) return query.returning(sql`1`.as("_returned")).compile();
+		return query.compile();
+	}
+	/**
+	* Compile a CHECK query (SELECT 1 to verify a row exists).
+	*/
+	compileCheck(table, where) {
+		return this.db.selectFrom(this.getTableName(table)).select(sql`1`.as("exists")).where((eb) => this.buildWhereClause(where, eb, table)).limit(1).compile();
+	}
+};
+
+//#endregion
+export { SQLQueryCompiler };
+//# sourceMappingURL=sql-query-compiler.js.map

package/dist/adapters/generic-sql/query/sql-query-compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-query-compiler.js","names":["mappedSelect: string[]","insert: AnyInsertQueryBuilder"],"sources":["../../../../src/adapters/generic-sql/query/sql-query-compiler.ts"],"sourcesContent":["import type {\n  CompiledQuery,\n  Kysely,\n  ExpressionBuilder,\n  ExpressionWrapper,\n  SelectQueryBuilder,\n  InsertQueryBuilder,\n} from \"kysely\";\nimport { sql } from \"kysely\";\nimport type { SqlBool } from \"kysely\";\nimport type { AnyColumn, AnyTable } from \"../../../schema/create\";\nimport type { Condition } from \"../../../query/condition-builder\";\nimport type { DriverConfig, SupportedDatabase } from \"../driver-config\";\nimport type { TableNameMapper } from \"../../shared/table-name-mapper\";\nimport { buildWhere, fullSQLName } from \"./where-builder\";\nimport { mapSelect, extendSelect } from \"./select-builder\";\nimport type { CompiledJoin } from \"../../../query/orm/orm\";\nimport { UnitOfWorkEncoder } from \"../uow-encoder\";\n\n/**\n * Type helpers for Kysely query builders.\n *\n * These use `any` for database schema types because at this abstraction layer,\n * we cannot know the specific database schema - we work with generic query\n * compilation that needs to work across any schema.\n */\n\n// oxlint-disable-next-line no-explicit-any\nexport type AnyKysely = Kysely<any>;\n\n// oxlint-disable-next-line no-explicit-any\nexport type AnyExpressionBuilder = ExpressionBuilder<any, any>;\n\n// oxlint-disable-next-line no-explicit-any\nexport type AnyExpressionWrapper = ExpressionWrapper<any, any, SqlBool>;\n\n// oxlint-disable-next-line no-explicit-any\nexport type AnySelectQueryBuilder<O = any> = SelectQueryBuilder<any, any, O>;\n\n// oxlint-disable-next-line no-explicit-any\nexport type AnyInsertQueryBuilder<O = any> = InsertQueryBuilder<any, any, O>;\n\n/**\n * Options for compiling a find operation\n */\nexport interface FindManyCompilerOptions {\n  select: true | string[];\n  where?: Condition;\n  orderBy?: [AnyColumn, \"asc\" | \"desc\"][];\n  limit?: number;\n  offset?: number;\n  join?: CompiledJoin[];\n}\n\n/**\n * Options for compiling a count operation\n */\nexport interface CountCompilerOptions {\n  where?: Condition;\n}\n\n/**\n * Options for compiling an update operation\n */\nexport interface UpdateCompilerOptions {\n  where?: Condition;\n  set: Record<string, unknown>;\n  /**\n   * Whether to add RETURNING clause to the UPDATE query.\n   * Used for version conflict detection when driver supports RETURNING but not affected rows.\n   */\n  returning?: boolean;\n}\n\n/**\n * Options for compiling a delete operation\n */\nexport interface DeleteCompilerOptions {\n  where?: Condition;\n  /**\n   * Whether to add RETURNING clause to the DELETE query.\n   * Used for version conflict detection when driver supports RETURNING but not affected rows.\n   */\n  returning?: boolean;\n}\n\n/**\n * Abstract base class for SQL query compilation.\n *\n * Similar to SQLGenerator for migrations, this class provides a framework\n * for compiling runtime queries with dialect-specific behavior.\n *\n * Each database dialect extends this class and implements the abstract methods\n * to handle database-specific SQL generation (like .limit() vs .top()).\n */\nexport abstract class SQLQueryCompiler {\n  protected readonly db: AnyKysely;\n  protected readonly driverConfig: DriverConfig;\n  protected readonly database: SupportedDatabase;\n  protected readonly mapper?: TableNameMapper;\n  protected readonly encoder: UnitOfWorkEncoder;\n\n  constructor(db: AnyKysely, driverConfig: DriverConfig, mapper?: TableNameMapper) {\n    this.db = db;\n    this.driverConfig = driverConfig;\n    this.database = driverConfig.databaseType;\n    this.mapper = mapper;\n    this.encoder = new UnitOfWorkEncoder(driverConfig, db, mapper);\n  }\n\n  /**\n   * Apply LIMIT clause to a query.\n   * Different databases use different syntax (.limit() vs .top()).\n   */\n  protected abstract applyLimit<T>(query: T & { limit(limit: number): T }, limit: number): T;\n\n  /**\n   * Apply OFFSET clause to a query.\n   * Some databases may not support offset.\n   */\n  protected abstract applyOffset<T>(query: T & { offset(offset: number): T }, offset: number): T;\n\n  /**\n   * Apply RETURNING clause to an insert/update query.\n   * Returns the query with RETURNING if supported, otherwise returns as-is.\n   */\n  protected abstract applyReturning<T>(\n    query: T & { returning(columns: string[]): T },\n    columns: string[],\n  ): T;\n\n  /**\n   * Get the physical table name, applying namespace mapping if provided.\n   */\n  protected getTableName(table: AnyTable): string {\n    return this.mapper ? this.mapper.toPhysical(table.name) : table.name;\n  }\n\n  /**\n   * Build WHERE clause from a condition tree.\n   */\n  protected buildWhereClause(condition: Condition, eb: AnyExpressionBuilder, table: AnyTable) {\n    return buildWhere(condition, eb, this.driverConfig, this.mapper, table);\n  }\n\n  /**\n   * Process joins recursively to support nested joins.\n   */\n  protected processJoins<O>(\n    query: AnySelectQueryBuilder<O>,\n    joins: CompiledJoin[],\n    parentTable: AnyTable,\n    parentTableName: string,\n    mappedSelect: string[],\n    parentPath: string = \"\",\n  ): AnySelectQueryBuilder<O> {\n    let result = query;\n\n    for (const join of joins) {\n      const { options: joinOptions, relation } = join;\n\n      if (joinOptions === false) {\n        continue;\n      }\n\n      const targetTable = relation.table;\n      // Build the full path for this join (e.g., \"author:inviter\")\n      const fullPath = parentPath ? `${parentPath}:${relation.name}` : relation.name;\n      // SQL table alias uses underscores (e.g., \"author_inviter\")\n      const joinName = fullPath.replace(/:/g, \"_\");\n\n      // Update select\n      mappedSelect.push(\n        ...mapSelect(joinOptions.select, targetTable, {\n          relation: fullPath, // Use full path with colons for column aliases\n          tableName: joinName, // Use underscore version for table name\n        }),\n      );\n\n      result = result.leftJoin(`${this.getTableName(targetTable)} as ${joinName}`, (b) =>\n        b.on((eb) => {\n          const conditions = [];\n          for (const [left, right] of relation.on) {\n            // Foreign keys always use internal IDs\n            // If the relation references an external ID column (any name), translate to \"_internalId\"\n            const rightCol = targetTable.columns[right];\n            const actualRight = rightCol?.role === \"external-id\" ? \"_internalId\" : right;\n\n            conditions.push(\n              eb(\n                `${parentTableName}.${parentTable.columns[left].name}`,\n                \"=\",\n                eb.ref(`${joinName}.${targetTable.columns[actualRight].name}`),\n              ),\n            );\n          }\n\n          if (joinOptions.where) {\n            conditions.push(this.buildWhereClause(joinOptions.where, eb, targetTable));\n          }\n\n          return eb.and(conditions);\n        }),\n      );\n\n      // Recursively process nested joins with the full path\n      if (joinOptions.join && joinOptions.join.length > 0) {\n        result = this.processJoins(\n          result,\n          joinOptions.join,\n          targetTable,\n          joinName,\n          mappedSelect,\n          fullPath,\n        );\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Compile a COUNT query.\n   */\n  compileCount(table: AnyTable, options: CountCompilerOptions): CompiledQuery {\n    let query = this.db\n      .selectFrom(this.getTableName(table))\n      .select(this.db.fn.countAll().as(\"count\"));\n\n    if (options.where) {\n      query = query.where((b) => this.buildWhereClause(options.where!, b, table));\n    }\n\n    return query.compile();\n  }\n\n  /**\n   * Compile a FIND MANY query.\n   */\n  compileFindMany(table: AnyTable, options: FindManyCompilerOptions): CompiledQuery {\n    let query = this.db.selectFrom(this.getTableName(table));\n\n    // Apply WHERE clause\n    const whereQuery = options.where;\n    if (whereQuery) {\n      query = query.where((eb) => this.buildWhereClause(whereQuery, eb, table));\n    }\n\n    // Apply OFFSET\n    if (options.offset !== undefined) {\n      query = this.applyOffset(query, options.offset);\n    }\n\n    // Apply LIMIT\n    if (options.limit !== undefined) {\n      query = this.applyLimit(query, options.limit);\n    }\n\n    // Apply ORDER BY\n    if (options.orderBy) {\n      for (const [col, mode] of options.orderBy) {\n        query = query.orderBy(fullSQLName(col, this.mapper), mode);\n      }\n    }\n\n    // Build SELECT with joins\n    const selectBuilder = extendSelect(options.select);\n    const mappedSelect: string[] = [];\n\n    // Process joins if provided\n    if (options.join && options.join.length > 0) {\n      query = this.processJoins(query, options.join, table, this.getTableName(table), mappedSelect);\n    }\n\n    const compiledSelect = selectBuilder.compile();\n    mappedSelect.push(\n      ...mapSelect(compiledSelect.result, table, { tableName: this.getTableName(table) }),\n    );\n\n    return query.select(mappedSelect).compile();\n  }\n\n  /**\n   * Compile a CREATE (INSERT) query.\n   */\n  compileCreate(table: AnyTable, values: Record<string, unknown>): CompiledQuery {\n    // Encode application values to database format (resolves FragnoId, generates defaults, serializes)\n    const encodedValues = this.encoder.encodeForDatabase({\n      values,\n      table,\n      generateDefaults: true,\n    });\n\n    let insert: AnyInsertQueryBuilder = this.db\n      .insertInto(this.getTableName(table))\n      .values(encodedValues);\n\n    // Apply RETURNING if supported\n    if (this.driverConfig.supportsReturning) {\n      const columns = mapSelect(true, table, { tableName: this.getTableName(table) });\n      insert = this.applyReturning(insert, columns);\n    }\n\n    return insert.compile();\n  }\n\n  /**\n   * Compile an UPDATE query.\n   */\n  compileUpdate(table: AnyTable, options: UpdateCompilerOptions): CompiledQuery {\n    const encoded = this.encoder.encodeForDatabase({\n      values: options.set,\n      table,\n      generateDefaults: false,\n    });\n\n    // Add version increment (must be added after encoding, as a raw SQL expression)\n    const versionCol = table.getVersionColumn();\n    encoded[versionCol.name] = sql.raw(`COALESCE(${versionCol.name}, 0) + 1`);\n\n    let query = this.db.updateTable(this.getTableName(table)).set(encoded);\n\n    if (options.where) {\n      query = query.where((eb) => this.buildWhereClause(options.where!, eb, table));\n    }\n\n    // Apply RETURNING if requested and supported\n    // Use sql template tag for literal value (not a column name)\n    if (options.returning && this.driverConfig.supportsReturning) {\n      return query.returning(sql<number>`1`.as(\"_returned\")).compile();\n    }\n\n    return query.compile();\n  }\n\n  /**\n   * Compile a DELETE query.\n   */\n  compileDelete(table: AnyTable, options: DeleteCompilerOptions): CompiledQuery {\n    let query = this.db.deleteFrom(this.getTableName(table));\n\n    if (options.where) {\n      query = query.where((eb) => this.buildWhereClause(options.where!, eb, table));\n    }\n\n    // Apply RETURNING if requested and supported\n    // Use sql template tag for literal value (not a column name)\n    if (options.returning && this.driverConfig.supportsReturning) {\n      return query.returning(sql<number>`1`.as(\"_returned\")).compile();\n    }\n\n    return query.compile();\n  }\n\n  /**\n   * Compile a CHECK query (SELECT 1 to verify a row exists).\n   */\n  compileCheck(table: AnyTable, where: Condition): CompiledQuery {\n    const query = this.db\n      .selectFrom(this.getTableName(table))\n      .select(sql<number>`1`.as(\"exists\"))\n      .where((eb) => this.buildWhereClause(where, eb, table))\n      .limit(1);\n\n    return query.compile();\n  }\n}\n"],"mappings":"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"}

package/dist/adapters/generic-sql/query/where-builder.js

@@ -0,0 +1,129 @@
+import { Column, FragnoId, FragnoReference } from "../../../schema/create.js";
+import { createSQLSerializer } from "../../../query/serialize/create-sql-serializer.js";
+import { ReferenceSubquery, resolveFragnoIdValue } from "../../../query/value-encoding.js";
+import { sql } from "kysely";
+
+//#region src/adapters/generic-sql/query/where-builder.ts
+/**
+* Returns the fully qualified SQL name for a column (table.column).
+*
+* @param column - The column to get the full name for
+* @param mapper - Optional table name mapper for namespace prefixing
+* @returns The fully qualified SQL name in the format "tableName.columnName"
+* @internal
+*/
+function fullSQLName(column, mapper) {
+	return `${mapper ? mapper.toPhysical(column.tableName) : column.tableName}.${column.name}`;
+}
+/**
+* Builds a WHERE clause expression from a Condition tree.
+*
+* Recursively processes condition objects to build Kysely WHERE expressions.
+* Handles comparison operators, logical AND/OR/NOT, and special string operators
+* like "contains", "starts with", and "ends with".
+*
+* @param condition - The condition tree to build the WHERE clause from
+* @param eb - Kysely expression builder for constructing SQL expressions
+* @param database - The database type (affects SQL generation)
+* @param mapper - Optional table name mapper for namespace prefixing
+* @param table - The table being queried (used for resolving reference columns)
+* @returns A Kysely expression wrapper representing the WHERE clause
+* @internal
+*/
+function buildWhere(condition, eb, driverConfig, mapper, table) {
+	const serializer = createSQLSerializer(driverConfig);
+	if (condition.type === "compare") {
+		const left = condition.a;
+		const op = condition.operator;
+		let val = condition.b;
+		if (!(val instanceof Column)) if (left.role === "reference" && table) if (typeof val === "string") {
+			const relation = Object.values(table.relations).find((rel) => rel.on.some(([localCol]) => localCol === left.ormName));
+			if (relation) {
+				const refTable = relation.table;
+				const internalIdCol = refTable.getInternalIdColumn();
+				const idCol = refTable.getIdColumn();
+				const physicalTableName = mapper ? mapper.toPhysical(refTable.ormName) : refTable.ormName;
+				val = eb.selectFrom(physicalTableName).select(internalIdCol.name).where(idCol.name, "=", val).limit(1);
+			}
+		} else if (val instanceof FragnoId && val.internalId !== void 0) val = val.internalId;
+		else if (val instanceof FragnoId && val.internalId === void 0) {
+			const relation = Object.values(table.relations).find((rel) => rel.on.some(([localCol]) => localCol === left.ormName));
+			if (relation) {
+				const refTable = relation.table;
+				const internalIdCol = refTable.getInternalIdColumn();
+				const idCol = refTable.getIdColumn();
+				const physicalTableName = mapper ? mapper.toPhysical(refTable.ormName) : refTable.ormName;
+				val = eb.selectFrom(physicalTableName).select(internalIdCol.name).where(idCol.name, "=", val.externalId).limit(1);
+			}
+		} else if (val instanceof FragnoReference) val = val.internalId;
+		else {
+			const resolvedVal = resolveFragnoIdValue(val, left);
+			val = serializer.serialize(resolvedVal, left);
+		}
+		else {
+			const resolvedVal = resolveFragnoIdValue(val, left);
+			val = serializer.serialize(resolvedVal, left);
+		}
+		let v;
+		let rhs;
+		switch (op) {
+			case "contains":
+				v = "like";
+				rhs = val instanceof Column ? sql`concat('%', ${eb.ref(fullSQLName(val, mapper))}, '%')` : `%${val}%`;
+				break;
+			case "not contains":
+				v = "not like";
+				rhs = val instanceof Column ? sql`concat('%', ${eb.ref(fullSQLName(val, mapper))}, '%')` : `%${val}%`;
+				break;
+			case "starts with":
+				v = "like";
+				rhs = val instanceof Column ? sql`concat(${eb.ref(fullSQLName(val, mapper))}, '%')` : `${val}%`;
+				break;
+			case "not starts with":
+				v = "not like";
+				rhs = val instanceof Column ? sql`concat(${eb.ref(fullSQLName(val, mapper))}, '%')` : `${val}%`;
+				break;
+			case "ends with":
+				v = "like";
+				rhs = val instanceof Column ? sql`concat('%', ${eb.ref(fullSQLName(val, mapper))})` : `%${val}`;
+				break;
+			case "not ends with":
+				v = "not like";
+				rhs = val instanceof Column ? sql`concat('%', ${eb.ref(fullSQLName(val, mapper))})` : `%${val}`;
+				break;
+			default:
+				v = op;
+				rhs = val instanceof Column ? eb.ref(fullSQLName(val, mapper)) : val;
+		}
+		return eb(fullSQLName(left, mapper), v, rhs);
+	}
+	if (condition.type === "and") return eb.and(condition.items.map((v) => buildWhere(v, eb, driverConfig, mapper, table)));
+	if (condition.type === "not") return eb.not(buildWhere(condition.item, eb, driverConfig, mapper, table));
+	return eb.or(condition.items.map((v) => buildWhere(v, eb, driverConfig, mapper, table)));
+}
+/**
+* Process reference subqueries in encoded values, converting them to Kysely SQL subqueries
+*
+* @param values - The encoded values that may contain ReferenceSubquery objects
+* @param kysely - The Kysely database instance for building subqueries
+* @param mapper - Optional table name mapper for namespace prefixing
+* @returns Processed values with subqueries in place of ReferenceSubquery markers
+* @internal
+*/
+function processReferenceSubqueries(values, kysely, mapper) {
+	const processed = {};
+	const getTableName = (table) => mapper ? mapper.toPhysical(table.name) : table.name;
+	for (const [key, value] of Object.entries(values)) if (value instanceof ReferenceSubquery) {
+		const refTable = value.referencedTable;
+		const externalId = value.externalIdValue;
+		const tableName = getTableName(refTable);
+		const internalIdCol = refTable.getInternalIdColumn().name;
+		const idCol = refTable.getIdColumn().name;
+		processed[key] = kysely.selectFrom(tableName).select(internalIdCol).where(idCol, "=", externalId).limit(1);
+	} else processed[key] = value;
+	return processed;
+}
+
+//#endregion
+export { buildWhere, fullSQLName, processReferenceSubqueries };
+//# sourceMappingURL=where-builder.js.map

package/dist/adapters/generic-sql/query/where-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"where-builder.js","names":["v: BinaryOperator","rhs: unknown","processed: Record<string, unknown>"],"sources":["../../../../src/adapters/generic-sql/query/where-builder.ts"],"sourcesContent":["import { sql, type BinaryOperator } from \"kysely\";\nimport {\n  type AnyColumn,\n  type AnyTable,\n  Column,\n  FragnoId,\n  FragnoReference,\n} from \"../../../schema/create\";\nimport type { Condition } from \"../../../query/condition-builder\";\nimport { createSQLSerializer } from \"../../../query/serialize/create-sql-serializer\";\nimport type { TableNameMapper } from \"../../shared/table-name-mapper\";\nimport type { DriverConfig } from \"../driver-config\";\nimport { ReferenceSubquery, resolveFragnoIdValue } from \"../../../query/value-encoding\";\nimport type { AnyKysely, AnyExpressionBuilder, AnyExpressionWrapper } from \"./sql-query-compiler\";\n\n/**\n * Returns the fully qualified SQL name for a column (table.column).\n *\n * @param column - The column to get the full name for\n * @param mapper - Optional table name mapper for namespace prefixing\n * @returns The fully qualified SQL name in the format \"tableName.columnName\"\n * @internal\n */\nexport function fullSQLName(column: AnyColumn, mapper?: TableNameMapper): string {\n  const tableName = mapper ? mapper.toPhysical(column.tableName) : column.tableName;\n  return `${tableName}.${column.name}`;\n}\n\n/**\n * Builds a WHERE clause expression from a Condition tree.\n *\n * Recursively processes condition objects to build Kysely WHERE expressions.\n * Handles comparison operators, logical AND/OR/NOT, and special string operators\n * like \"contains\", \"starts with\", and \"ends with\".\n *\n * @param condition - The condition tree to build the WHERE clause from\n * @param eb - Kysely expression builder for constructing SQL expressions\n * @param database - The database type (affects SQL generation)\n * @param mapper - Optional table name mapper for namespace prefixing\n * @param table - The table being queried (used for resolving reference columns)\n * @returns A Kysely expression wrapper representing the WHERE clause\n * @internal\n */\nexport function buildWhere(\n  condition: Condition,\n  eb: AnyExpressionBuilder,\n  driverConfig: DriverConfig,\n  mapper?: TableNameMapper,\n  table?: AnyTable,\n): AnyExpressionWrapper {\n  const serializer = createSQLSerializer(driverConfig);\n\n  if (condition.type === \"compare\") {\n    const left = condition.a;\n    const op = condition.operator;\n    let val = condition.b;\n\n    if (!(val instanceof Column)) {\n      // Handle reference columns specially\n      if (left.role === \"reference\" && table) {\n        if (typeof val === \"string\") {\n          // String external ID - create subquery to lookup internal ID\n          const relation = Object.values(table.relations).find((rel) =>\n            rel.on.some(([localCol]) => localCol === left.ormName),\n          );\n          if (relation) {\n            const refTable = relation.table;\n            const internalIdCol = refTable.getInternalIdColumn();\n            const idCol = refTable.getIdColumn();\n            const physicalTableName = mapper\n              ? mapper.toPhysical(refTable.ormName)\n              : refTable.ormName;\n\n            val = eb\n              .selectFrom(physicalTableName)\n              .select(internalIdCol.name)\n              .where(idCol.name, \"=\", val)\n              .limit(1);\n          }\n        } else if (val instanceof FragnoId && val.internalId !== undefined) {\n          // FragnoId with internal ID - use it directly (no serialization needed)\n          val = val.internalId;\n        } else if (val instanceof FragnoId && val.internalId === undefined) {\n          // FragnoId without internal ID - create subquery using external ID\n          const relation = Object.values(table.relations).find((rel) =>\n            rel.on.some(([localCol]) => localCol === left.ormName),\n          );\n          if (relation) {\n            const refTable = relation.table;\n            const internalIdCol = refTable.getInternalIdColumn();\n            const idCol = refTable.getIdColumn();\n            const physicalTableName = mapper\n              ? mapper.toPhysical(refTable.ormName)\n              : refTable.ormName;\n\n            val = eb\n              .selectFrom(physicalTableName)\n              .select(internalIdCol.name)\n              .where(idCol.name, \"=\", val.externalId)\n              .limit(1);\n          }\n        } else if (val instanceof FragnoReference) {\n          // FragnoReference - use internal ID directly (no serialization needed)\n          val = val.internalId;\n        } else {\n          // Other values - resolve and serialize\n          const resolvedVal = resolveFragnoIdValue(val, left);\n          val = serializer.serialize(resolvedVal, left);\n        }\n      } else {\n        // Non-reference columns - resolve FragnoId/FragnoReference and serialize\n        const resolvedVal = resolveFragnoIdValue(val, left);\n        val = serializer.serialize(resolvedVal, left);\n      }\n    }\n\n    let v: BinaryOperator;\n    let rhs: unknown;\n\n    switch (op) {\n      case \"contains\":\n        v = \"like\";\n        rhs =\n          val instanceof Column\n            ? sql`concat('%', ${eb.ref(fullSQLName(val, mapper))}, '%')`\n            : `%${val}%`;\n        break;\n      case \"not contains\":\n        v = \"not like\";\n        rhs =\n          val instanceof Column\n            ? sql`concat('%', ${eb.ref(fullSQLName(val, mapper))}, '%')`\n            : `%${val}%`;\n        break;\n      case \"starts with\":\n        v = \"like\";\n        rhs =\n          val instanceof Column ? sql`concat(${eb.ref(fullSQLName(val, mapper))}, '%')` : `${val}%`;\n        break;\n      case \"not starts with\":\n        v = \"not like\";\n        rhs =\n          val instanceof Column ? sql`concat(${eb.ref(fullSQLName(val, mapper))}, '%')` : `${val}%`;\n        break;\n      case \"ends with\":\n        v = \"like\";\n        rhs =\n          val instanceof Column ? sql`concat('%', ${eb.ref(fullSQLName(val, mapper))})` : `%${val}`;\n        break;\n      case \"not ends with\":\n        v = \"not like\";\n        rhs =\n          val instanceof Column ? sql`concat('%', ${eb.ref(fullSQLName(val, mapper))})` : `%${val}`;\n        break;\n      default:\n        v = op;\n        rhs = val instanceof Column ? eb.ref(fullSQLName(val, mapper)) : val;\n    }\n\n    return eb(fullSQLName(left, mapper), v, rhs);\n  }\n\n  // Nested conditions\n  if (condition.type === \"and\") {\n    return eb.and(condition.items.map((v) => buildWhere(v, eb, driverConfig, mapper, table)));\n  }\n\n  if (condition.type === \"not\") {\n    return eb.not(buildWhere(condition.item, eb, driverConfig, mapper, table));\n  }\n\n  return eb.or(condition.items.map((v) => buildWhere(v, eb, driverConfig, mapper, table)));\n}\n\n/**\n * Process reference subqueries in encoded values, converting them to Kysely SQL subqueries\n *\n * @param values - The encoded values that may contain ReferenceSubquery objects\n * @param kysely - The Kysely database instance for building subqueries\n * @param mapper - Optional table name mapper for namespace prefixing\n * @returns Processed values with subqueries in place of ReferenceSubquery markers\n * @internal\n */\nexport function processReferenceSubqueries(\n  values: Record<string, unknown>,\n  kysely: AnyKysely,\n  mapper?: TableNameMapper,\n): Record<string, unknown> {\n  const processed: Record<string, unknown> = {};\n  const getTableName = (table: AnyTable) => (mapper ? mapper.toPhysical(table.name) : table.name);\n\n  for (const [key, value] of Object.entries(values)) {\n    if (value instanceof ReferenceSubquery) {\n      const refTable = value.referencedTable;\n      const externalId = value.externalIdValue;\n      const tableName = getTableName(refTable);\n      const internalIdCol = refTable.getInternalIdColumn().name;\n      const idCol = refTable.getIdColumn().name;\n\n      processed[key] = kysely\n        .selectFrom(tableName)\n        .select(internalIdCol)\n        .where(idCol, \"=\", externalId)\n        .limit(1);\n    } else {\n      processed[key] = value;\n    }\n  }\n\n  return processed;\n}\n"],"mappings":"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"}

package/dist/adapters/generic-sql/result-interpreter.js

@@ -0,0 +1,74 @@
+//#region src/adapters/generic-sql/result-interpreter.ts
+/**
+* Interprets query results from different SQL drivers.
+*
+* Different drivers return affected rows information in different formats.
+* This class uses the driver-specific extraction logic defined in DriverConfig
+* to normalize the affected rows count to a bigint value.
+*/
+var ResultInterpreter = class {
+	#driverConfig;
+	constructor(driverConfig) {
+		this.#driverConfig = driverConfig;
+	}
+	/**
+	* Extract the number of affected rows from a query result.
+	* Only works for drivers that support affected rows reporting.
+	*
+	* @param result - The query result from the SQL driver
+	* @returns The number of rows affected by the operation as bigint
+	* @throws Error if driver doesn't support affected rows or extraction fails
+	*/
+	getAffectedRows(result) {
+		if (!this.#driverConfig.extractAffectedRows) throw new Error(`Driver ${this.#driverConfig.driverType} does not support affected rows reporting.`);
+		return this.#driverConfig.extractAffectedRows(result);
+	}
+	/**
+	* Extract internal ID from INSERT result (RETURNING clause).
+	*
+	* @param result - The query result from the SQL driver
+	* @returns The internal ID as bigint
+	* @throws Error if driver doesn't support RETURNING, no rows returned, or column not found
+	*/
+	getCreatedInternalId(result) {
+		if (!this.#driverConfig.supportsReturning || !this.#driverConfig.internalIdColumn) throw new Error(`Driver ${this.#driverConfig.driverType} does not support RETURNING clause.`);
+		if (!Array.isArray(result.rows) || result.rows.length === 0) throw new Error(`No rows returned from INSERT with RETURNING clause.`);
+		const row = result.rows[0];
+		const columnName = this.#driverConfig.internalIdColumn;
+		if (!(columnName in row)) throw new Error(`Expected column "${columnName}" not found in RETURNING result.`);
+		const rawId = row[columnName];
+		return this.#normalizeIntegerId(rawId);
+	}
+	/**
+	* Get count of returned rows as bigint.
+	*
+	* @param result - The query result from the SQL driver
+	* @returns The number of rows returned as bigint
+	*/
+	getReturnedRowCount(result) {
+		if (!Array.isArray(result.rows)) return BigInt(0);
+		return BigInt(result.rows.length);
+	}
+	/**
+	* Normalize integer values to bigint.
+	* Handles different driver return types (bigint, number, string).
+	*
+	* @param value - The value to normalize
+	* @returns The normalized bigint value
+	* @throws Error if value cannot be converted to bigint
+	*/
+	#normalizeIntegerId(value) {
+		if (value === null || value === void 0) throw new Error(`Cannot normalize null or undefined value to bigint`);
+		if (typeof value === "bigint") return value;
+		if (typeof value === "number") {
+			if (Number.isNaN(value) || !Number.isFinite(value)) throw new Error(`Cannot normalize NaN or non-finite number to bigint`);
+			return BigInt(value);
+		}
+		if (typeof value === "string") return BigInt(value);
+		throw new Error(`Cannot normalize value to bigint: ${typeof value}`);
+	}
+};
+
+//#endregion
+export { ResultInterpreter };
+//# sourceMappingURL=result-interpreter.js.map

package/dist/adapters/generic-sql/result-interpreter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-interpreter.js","names":["#driverConfig","#normalizeIntegerId"],"sources":["../../../src/adapters/generic-sql/result-interpreter.ts"],"sourcesContent":["import type { QueryResult } from \"../../sql-driver/sql-driver\";\nimport type { DriverConfig } from \"./driver-config\";\n\n/**\n * Interprets query results from different SQL drivers.\n *\n * Different drivers return affected rows information in different formats.\n * This class uses the driver-specific extraction logic defined in DriverConfig\n * to normalize the affected rows count to a bigint value.\n */\nexport class ResultInterpreter {\n  readonly #driverConfig: DriverConfig;\n  constructor(driverConfig: DriverConfig) {\n    this.#driverConfig = driverConfig;\n  }\n\n  /**\n   * Extract the number of affected rows from a query result.\n   * Only works for drivers that support affected rows reporting.\n   *\n   * @param result - The query result from the SQL driver\n   * @returns The number of rows affected by the operation as bigint\n   * @throws Error if driver doesn't support affected rows or extraction fails\n   */\n  getAffectedRows(result: QueryResult<unknown>): bigint {\n    if (!this.#driverConfig.extractAffectedRows) {\n      throw new Error(\n        `Driver ${this.#driverConfig.driverType} does not support affected rows reporting.`,\n      );\n    }\n\n    // QueryResult doesn't have an index signature, but drivers return objects with dynamic properties\n    return this.#driverConfig.extractAffectedRows(result as unknown as Record<string, unknown>);\n  }\n\n  /**\n   * Extract internal ID from INSERT result (RETURNING clause).\n   *\n   * @param result - The query result from the SQL driver\n   * @returns The internal ID as bigint\n   * @throws Error if driver doesn't support RETURNING, no rows returned, or column not found\n   */\n  getCreatedInternalId(result: QueryResult<unknown>): bigint {\n    if (!this.#driverConfig.supportsReturning || !this.#driverConfig.internalIdColumn) {\n      throw new Error(`Driver ${this.#driverConfig.driverType} does not support RETURNING clause.`);\n    }\n\n    if (!Array.isArray(result.rows) || result.rows.length === 0) {\n      throw new Error(`No rows returned from INSERT with RETURNING clause.`);\n    }\n\n    const row = result.rows[0] as Record<string, unknown>;\n    const columnName = this.#driverConfig.internalIdColumn;\n\n    if (!(columnName in row)) {\n      throw new Error(`Expected column \"${columnName}\" not found in RETURNING result.`);\n    }\n\n    const rawId = row[columnName];\n    return this.#normalizeIntegerId(rawId);\n  }\n\n  /**\n   * Get count of returned rows as bigint.\n   *\n   * @param result - The query result from the SQL driver\n   * @returns The number of rows returned as bigint\n   */\n  getReturnedRowCount(result: QueryResult<unknown>): bigint {\n    if (!Array.isArray(result.rows)) {\n      return BigInt(0);\n    }\n    return BigInt(result.rows.length);\n  }\n\n  /**\n   * Normalize integer values to bigint.\n   * Handles different driver return types (bigint, number, string).\n   *\n   * @param value - The value to normalize\n   * @returns The normalized bigint value\n   * @throws Error if value cannot be converted to bigint\n   */\n  #normalizeIntegerId(value: unknown): bigint {\n    if (value === null || value === undefined) {\n      throw new Error(`Cannot normalize null or undefined value to bigint`);\n    }\n    if (typeof value === \"bigint\") {\n      return value;\n    }\n    if (typeof value === \"number\") {\n      if (Number.isNaN(value) || !Number.isFinite(value)) {\n        throw new Error(`Cannot normalize NaN or non-finite number to bigint`);\n      }\n      return BigInt(value);\n    }\n    if (typeof value === \"string\") {\n      return BigInt(value);\n    }\n    throw new Error(`Cannot normalize value to bigint: ${typeof value}`);\n  }\n}\n"],"mappings":";;;;;;;;AAUA,IAAa,oBAAb,MAA+B;CAC7B,CAASA;CACT,YAAY,cAA4B;AACtC,QAAKA,eAAgB;;;;;;;;;;CAWvB,gBAAgB,QAAsC;AACpD,MAAI,CAAC,MAAKA,aAAc,oBACtB,OAAM,IAAI,MACR,UAAU,MAAKA,aAAc,WAAW,4CACzC;AAIH,SAAO,MAAKA,aAAc,oBAAoB,OAA6C;;;;;;;;;CAU7F,qBAAqB,QAAsC;AACzD,MAAI,CAAC,MAAKA,aAAc,qBAAqB,CAAC,MAAKA,aAAc,iBAC/D,OAAM,IAAI,MAAM,UAAU,MAAKA,aAAc,WAAW,qCAAqC;AAG/F,MAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,IAAI,OAAO,KAAK,WAAW,EACxD,OAAM,IAAI,MAAM,sDAAsD;EAGxE,MAAM,MAAM,OAAO,KAAK;EACxB,MAAM,aAAa,MAAKA,aAAc;AAEtC,MAAI,EAAE,cAAc,KAClB,OAAM,IAAI,MAAM,oBAAoB,WAAW,kCAAkC;EAGnF,MAAM,QAAQ,IAAI;AAClB,SAAO,MAAKC,mBAAoB,MAAM;;;;;;;;CASxC,oBAAoB,QAAsC;AACxD,MAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,CAC7B,QAAO,OAAO,EAAE;AAElB,SAAO,OAAO,OAAO,KAAK,OAAO;;;;;;;;;;CAWnC,oBAAoB,OAAwB;AAC1C,MAAI,UAAU,QAAQ,UAAU,OAC9B,OAAM,IAAI,MAAM,qDAAqD;AAEvE,MAAI,OAAO,UAAU,SACnB,QAAO;AAET,MAAI,OAAO,UAAU,UAAU;AAC7B,OAAI,OAAO,MAAM,MAAM,IAAI,CAAC,OAAO,SAAS,MAAM,CAChD,OAAM,IAAI,MAAM,sDAAsD;AAExE,UAAO,OAAO,MAAM;;AAEtB,MAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAEtB,QAAM,IAAI,MAAM,qCAAqC,OAAO,QAAQ"}

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

@@ -0,0 +1,105 @@
+import { createCursorFromRecord } from "../../query/cursor.js";
+import { decodeResult } from "../../query/value-decoding.js";
+
+//#region src/adapters/generic-sql/uow-decoder.ts
+/**
+* Decoder class for Unit of Work retrieval results.
+*
+* Transforms raw database results into application format (e.g., converting raw columns
+* into FragnoId objects with external ID, internal ID, and version).
+*/
+var UnitOfWorkDecoder = class {
+	#driverConfig;
+	constructor(driverConfig) {
+		this.#driverConfig = driverConfig;
+	}
+	/**
+	* Decode raw database results from the retrieval phase
+	*
+	* @param rawResults - Array of raw result sets from database queries
+	* @param operations - Array of retrieval operations that produced these results
+	* @returns Decoded results in application format
+	*/
+	decode(rawResults, operations) {
+		if (rawResults.length !== operations.length) throw new Error("rawResults and ops must have the same length");
+		return rawResults.map((rows, index) => {
+			const op = operations[index];
+			if (!op) throw new Error("op must be defined");
+			const rowArray = rows;
+			return this.decodeResultSet(rowArray, op);
+		});
+	}
+	/**
+	* Decodes a result set based on the operation type.
+	*
+	* This is the main entry point for decoding query results, routing to the
+	* appropriate decoder based on whether it's a count, cursor, or regular query.
+	*
+	* @param rows - The raw database rows
+	* @param operation - The retrieval operation defining how to decode the result
+	* @returns The decoded result (number for count, CursorResult for cursor, array otherwise)
+	*/
+	decodeResultSet(rows, operation) {
+		if (operation.type === "count") return this.decodeCountResult(rows);
+		const decodedRows = rows.map((row) => decodeResult(row, operation.table, this.#driverConfig));
+		if (operation.withCursor) return this.decodeCursorResult(decodedRows, operation.table, operation);
+		return decodedRows;
+	}
+	/**
+	* Decodes a count query result to a number.
+	*
+	* @param rows - The raw database rows (should contain a single row with a count column)
+	* @returns The count as a number
+	* @throws If the count value is invalid or missing
+	*/
+	decodeCountResult(rows) {
+		const firstRow = rows[0];
+		if (!firstRow) return 0;
+		const count = Number(firstRow["count"]);
+		if (Number.isNaN(count)) throw new Error(`Unexpected result for count, received: ${count}`);
+		return count;
+	}
+	/**
+	* Handles cursor generation and hasNextPage detection for cursor-paginated queries.
+	*
+	* Checks if we received more rows than the requested pageSize (we fetch pageSize + 1).
+	*
+	* @param decodedRows - The already-decoded database rows (pageSize + 1 rows)
+	* @param table - The table schema definition (needed for cursor generation)
+	* @param operation - The find operation containing pagination options
+	* @returns A CursorResult with items, cursor, and hasNextPage
+	*/
+	decodeCursorResult(decodedRows, table, operation) {
+		let cursor;
+		let hasNextPage = false;
+		let items = decodedRows;
+		if (operation.options.pageSize && operation.options.pageSize > 0 && decodedRows.length > operation.options.pageSize) {
+			hasNextPage = true;
+			items = decodedRows.slice(0, operation.options.pageSize);
+			if (operation.options.orderByIndex) {
+				const lastItem = items[items.length - 1];
+				const indexName = operation.options.orderByIndex.indexName;
+				let indexColumns;
+				if (indexName === "_primary") indexColumns = [table.getIdColumn()];
+				else {
+					const index = table.indexes[indexName];
+					if (index) indexColumns = index.columns;
+				}
+				if (indexColumns && lastItem) cursor = createCursorFromRecord(lastItem, indexColumns, {
+					indexName: operation.options.orderByIndex.indexName,
+					orderDirection: operation.options.orderByIndex.direction,
+					pageSize: operation.options.pageSize
+				});
+			}
+		}
+		return {
+			items,
+			cursor,
+			hasNextPage
+		};
+	}
+};
+
+//#endregion
+export { UnitOfWorkDecoder };
+//# sourceMappingURL=uow-decoder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uow-decoder.js","names":["#driverConfig","cursor: Cursor | undefined"],"sources":["../../../src/adapters/generic-sql/uow-decoder.ts"],"sourcesContent":["import type { UOWDecoder } from \"../../query/unit-of-work/unit-of-work\";\nimport type { RetrievalOperation } from \"../../query/unit-of-work/unit-of-work\";\nimport type { AnySchema, AnyTable } from \"../../schema/create\";\nimport { decodeResult } from \"../../query/value-decoding\";\nimport { createCursorFromRecord, type Cursor, type CursorResult } from \"../../query/cursor\";\nimport type { DriverConfig } from \"./driver-config\";\n\n/**\n * Decoder class for Unit of Work retrieval results.\n *\n * Transforms raw database results into application format (e.g., converting raw columns\n * into FragnoId objects with external ID, internal ID, and version).\n */\nexport class UnitOfWorkDecoder implements UOWDecoder<unknown> {\n  readonly #driverConfig: DriverConfig;\n\n  constructor(driverConfig: DriverConfig) {\n    this.#driverConfig = driverConfig;\n  }\n\n  /**\n   * Decode raw database results from the retrieval phase\n   *\n   * @param rawResults - Array of raw result sets from database queries\n   * @param operations - Array of retrieval operations that produced these results\n   * @returns Decoded results in application format\n   */\n  decode(rawResults: unknown[], operations: RetrievalOperation<AnySchema>[]): unknown[] {\n    if (rawResults.length !== operations.length) {\n      throw new Error(\"rawResults and ops must have the same length\");\n    }\n\n    return rawResults.map((rows, index) => {\n      const op = operations[index];\n      if (!op) {\n        throw new Error(\"op must be defined\");\n      }\n\n      const rowArray = rows as Record<string, unknown>[];\n      return this.decodeResultSet(rowArray, op);\n    });\n  }\n\n  /**\n   * Decodes a result set based on the operation type.\n   *\n   * This is the main entry point for decoding query results, routing to the\n   * appropriate decoder based on whether it's a count, cursor, or regular query.\n   *\n   * @param rows - The raw database rows\n   * @param operation - The retrieval operation defining how to decode the result\n   * @returns The decoded result (number for count, CursorResult for cursor, array otherwise)\n   */\n  private decodeResultSet(\n    rows: Record<string, unknown>[],\n    operation: RetrievalOperation<AnySchema>,\n  ): number | Record<string, unknown>[] | CursorResult<unknown> {\n    // Handle count operations\n    if (operation.type === \"count\") {\n      return this.decodeCountResult(rows);\n    }\n\n    const decodedRows = rows.map((row) => decodeResult(row, operation.table, this.#driverConfig));\n\n    if (operation.withCursor) {\n      return this.decodeCursorResult(decodedRows, operation.table, operation);\n    }\n\n    return decodedRows;\n  }\n\n  /**\n   * Decodes a count query result to a number.\n   *\n   * @param rows - The raw database rows (should contain a single row with a count column)\n   * @returns The count as a number\n   * @throws If the count value is invalid or missing\n   */\n  private decodeCountResult(rows: Record<string, unknown>[]): number {\n    const firstRow = rows[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  /**\n   * Handles cursor generation and hasNextPage detection for cursor-paginated queries.\n   *\n   * Checks if we received more rows than the requested pageSize (we fetch pageSize + 1).\n   *\n   * @param decodedRows - The already-decoded database rows (pageSize + 1 rows)\n   * @param table - The table schema definition (needed for cursor generation)\n   * @param operation - The find operation containing pagination options\n   * @returns A CursorResult with items, cursor, and hasNextPage\n   */\n  private decodeCursorResult(\n    decodedRows: Record<string, unknown>[],\n    table: AnyTable,\n    operation: Extract<RetrievalOperation<AnySchema>, { type: \"find\" }>,\n  ): CursorResult<unknown> {\n    let cursor: Cursor | undefined;\n    let hasNextPage = false;\n    let items = decodedRows;\n\n    // Check if there are more results (we fetched pageSize + 1)\n    if (\n      operation.options.pageSize &&\n      operation.options.pageSize > 0 &&\n      decodedRows.length > operation.options.pageSize\n    ) {\n      hasNextPage = true;\n      // Trim to requested pageSize\n      items = decodedRows.slice(0, operation.options.pageSize);\n\n      // Generate cursor from the last item we're returning\n      if (operation.options.orderByIndex) {\n        const lastItem = items[items.length - 1];\n        const indexName = operation.options.orderByIndex.indexName;\n\n        // Get index columns\n        let indexColumns;\n        if (indexName === \"_primary\") {\n          indexColumns = [table.getIdColumn()];\n        } else {\n          const index = table.indexes[indexName];\n          if (index) {\n            indexColumns = index.columns;\n          }\n        }\n\n        if (indexColumns && lastItem) {\n          cursor = createCursorFromRecord(lastItem, indexColumns, {\n            indexName: operation.options.orderByIndex.indexName,\n            orderDirection: operation.options.orderByIndex.direction,\n            pageSize: operation.options.pageSize,\n          });\n        }\n      }\n    }\n\n    return {\n      items,\n      cursor,\n      hasNextPage,\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;AAaA,IAAa,oBAAb,MAA8D;CAC5D,CAASA;CAET,YAAY,cAA4B;AACtC,QAAKA,eAAgB;;;;;;;;;CAUvB,OAAO,YAAuB,YAAwD;AACpF,MAAI,WAAW,WAAW,WAAW,OACnC,OAAM,IAAI,MAAM,+CAA+C;AAGjE,SAAO,WAAW,KAAK,MAAM,UAAU;GACrC,MAAM,KAAK,WAAW;AACtB,OAAI,CAAC,GACH,OAAM,IAAI,MAAM,qBAAqB;GAGvC,MAAM,WAAW;AACjB,UAAO,KAAK,gBAAgB,UAAU,GAAG;IACzC;;;;;;;;;;;;CAaJ,AAAQ,gBACN,MACA,WAC4D;AAE5D,MAAI,UAAU,SAAS,QACrB,QAAO,KAAK,kBAAkB,KAAK;EAGrC,MAAM,cAAc,KAAK,KAAK,QAAQ,aAAa,KAAK,UAAU,OAAO,MAAKA,aAAc,CAAC;AAE7F,MAAI,UAAU,WACZ,QAAO,KAAK,mBAAmB,aAAa,UAAU,OAAO,UAAU;AAGzE,SAAO;;;;;;;;;CAUT,AAAQ,kBAAkB,MAAyC;EACjE,MAAM,WAAW,KAAK;AACtB,MAAI,CAAC,SACH,QAAO;EAET,MAAM,QAAQ,OAAO,SAAS,SAAS;AACvC,MAAI,OAAO,MAAM,MAAM,CACrB,OAAM,IAAI,MAAM,0CAA0C,QAAQ;AAEpE,SAAO;;;;;;;;;;;;CAaT,AAAQ,mBACN,aACA,OACA,WACuB;EACvB,IAAIC;EACJ,IAAI,cAAc;EAClB,IAAI,QAAQ;AAGZ,MACE,UAAU,QAAQ,YAClB,UAAU,QAAQ,WAAW,KAC7B,YAAY,SAAS,UAAU,QAAQ,UACvC;AACA,iBAAc;AAEd,WAAQ,YAAY,MAAM,GAAG,UAAU,QAAQ,SAAS;AAGxD,OAAI,UAAU,QAAQ,cAAc;IAClC,MAAM,WAAW,MAAM,MAAM,SAAS;IACtC,MAAM,YAAY,UAAU,QAAQ,aAAa;IAGjD,IAAI;AACJ,QAAI,cAAc,WAChB,gBAAe,CAAC,MAAM,aAAa,CAAC;SAC/B;KACL,MAAM,QAAQ,MAAM,QAAQ;AAC5B,SAAI,MACF,gBAAe,MAAM;;AAIzB,QAAI,gBAAgB,SAClB,UAAS,uBAAuB,UAAU,cAAc;KACtD,WAAW,UAAU,QAAQ,aAAa;KAC1C,gBAAgB,UAAU,QAAQ,aAAa;KAC/C,UAAU,UAAU,QAAQ;KAC7B,CAAC;;;AAKR,SAAO;GACL;GACA;GACA;GACD"}