@fragno-dev/db 0.0.1 → 0.1.0

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

@@ -0,0 +1,139 @@
+import { decodeCursor, serializeCursorValues } from "../../query/cursor.js";
+import { buildCondition } from "../../query/condition-builder.js";
+import { createKyselyQueryBuilder } from "./kysely-query-builder.js";
+import { createKyselyQueryCompiler } from "./kysely-query-compiler.js";
+
+//#region src/adapters/kysely/kysely-uow-compiler.ts
+/**
+* Create a Kysely-specific Unit of Work compiler
+*
+* This compiler translates UOW operations into Kysely CompiledQuery objects
+* that can be executed as a batch/transaction.
+*
+* @param schema - The database schema
+* @param config - Kysely configuration
+* @returns A UOWCompiler instance for Kysely
+*/
+function createKyselyUOWCompiler(schema, config) {
+	const queryCompiler = createKyselyQueryCompiler(schema, config);
+	const queryBuilder = createKyselyQueryBuilder(config.db, config.provider);
+	const { provider } = config;
+	function toTable(name) {
+		const table = schema.tables[name];
+		if (!table) throw new Error(`Invalid table name ${name}.`);
+		return table;
+	}
+	return {
+		compileRetrievalOperation(op) {
+			switch (op.type) {
+				case "count": return queryCompiler.count(op.table.name, { where: op.options.where });
+				case "find": {
+					const { useIndex: _useIndex, orderByIndex, joins: join, after, before, pageSize,...findManyOptions } = op.options;
+					let indexColumns = [];
+					let orderDirection = "asc";
+					if (orderByIndex) {
+						const index = op.table.indexes[orderByIndex.indexName];
+						orderDirection = orderByIndex.direction;
+						if (!index) if (orderByIndex.indexName === "_primary") indexColumns = [op.table.getIdColumn()];
+						else throw new Error(`Index "${orderByIndex.indexName}" not found on table "${op.table.name}"`);
+						else indexColumns = index.columns;
+					}
+					let orderBy;
+					if (indexColumns.length > 0) orderBy = indexColumns.map((col) => [col, orderDirection]);
+					let cursorCondition;
+					if ((after || before) && indexColumns.length > 0) {
+						const serializedValues = serializeCursorValues(decodeCursor(after || before), indexColumns, provider);
+						const isAfter = !!after;
+						const useGreaterThan = isAfter && orderDirection === "asc" || !isAfter && orderDirection === "desc";
+						if (indexColumns.length === 1) {
+							const col = indexColumns[0];
+							const val = serializedValues[col.ormName];
+							cursorCondition = {
+								type: "compare",
+								a: col,
+								operator: useGreaterThan ? ">" : "<",
+								b: val
+							};
+						} else throw new Error("Multi-column cursor pagination is not yet supported in Kysely Unit of Work implementation");
+					}
+					let combinedWhere;
+					if (findManyOptions.where) {
+						const whereResult = buildCondition(op.table.columns, findManyOptions.where);
+						if (whereResult === true) combinedWhere = void 0;
+						else if (whereResult === false) return null;
+						else combinedWhere = whereResult;
+					}
+					if (cursorCondition) if (combinedWhere) combinedWhere = {
+						type: "and",
+						items: [combinedWhere, cursorCondition]
+					};
+					else combinedWhere = cursorCondition;
+					if (join && join.length > 0) return queryBuilder.findMany(op.table, {
+						select: findManyOptions.select ?? true,
+						where: combinedWhere,
+						orderBy,
+						limit: pageSize,
+						join
+					});
+					return queryCompiler.findMany(op.table.name, {
+						...findManyOptions,
+						where: combinedWhere ? () => combinedWhere : void 0,
+						orderBy: orderBy?.map(([col, dir]) => [col.ormName, dir]),
+						limit: pageSize
+					});
+				}
+			}
+		},
+		compileMutationOperation(op) {
+			switch (op.type) {
+				case "create": return {
+					query: queryCompiler.create(op.table, op.values),
+					expectedAffectedRows: null
+				};
+				case "update": {
+					const table = toTable(op.table);
+					const idColumn = table.getIdColumn();
+					const versionColumn = table.getVersionColumn();
+					const externalId = typeof op.id === "string" ? op.id : op.id.externalId;
+					const versionToCheck = getVersionToCheck(op.id, op.checkVersion);
+					const whereClause = versionToCheck !== void 0 ? () => buildCondition(table.columns, (eb) => eb.and(eb(idColumn.ormName, "=", externalId), eb(versionColumn.ormName, "=", versionToCheck))) : () => buildCondition(table.columns, (eb) => eb(idColumn.ormName, "=", externalId));
+					const query = queryCompiler.updateMany(op.table, {
+						where: whereClause,
+						set: op.set
+					});
+					return query ? {
+						query,
+						expectedAffectedRows: op.checkVersion ? 1 : null
+					} : null;
+				}
+				case "delete": {
+					const table = toTable(op.table);
+					const idColumn = table.getIdColumn();
+					const versionColumn = table.getVersionColumn();
+					const externalId = typeof op.id === "string" ? op.id : op.id.externalId;
+					const versionToCheck = getVersionToCheck(op.id, op.checkVersion);
+					const whereClause = versionToCheck !== void 0 ? () => buildCondition(table.columns, (eb) => eb.and(eb(idColumn.ormName, "=", externalId), eb(versionColumn.ormName, "=", versionToCheck))) : () => buildCondition(table.columns, (eb) => eb(idColumn.ormName, "=", externalId));
+					const query = queryCompiler.deleteMany(op.table, { where: whereClause });
+					return query ? {
+						query,
+						expectedAffectedRows: op.checkVersion ? 1 : null
+					} : null;
+				}
+			}
+		}
+	};
+}
+/**
+* Get the version to check for a given ID and checkVersion flag.
+* @returns The version to check or undefined if no check is required.
+* @throws Error if the ID is a string and checkVersion is true.
+*/
+function getVersionToCheck(id, checkVersion) {
+	if (!checkVersion) return;
+	if (typeof id === "string") throw new Error(`Cannot use checkVersion with a string ID. Version checking requires a FragnoId with version information.`);
+	return id.version;
+}
+
+//#endregion
+export { createKyselyUOWCompiler };
+//# sourceMappingURL=kysely-uow-compiler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-uow-compiler.js","names":["indexColumns: AnyColumn[]","orderDirection: \"asc\" | \"desc\"","orderBy: [AnyColumn, \"asc\" | \"desc\"][] | undefined","cursorCondition: Condition | undefined","combinedWhere: Condition | undefined"],"sources":["../../../src/adapters/kysely/kysely-uow-compiler.ts"],"sourcesContent":["import type { CompiledQuery } from \"kysely\";\nimport type { AnyColumn, AnySchema, FragnoId } from \"../../schema/create\";\nimport type {\n  CompiledMutation,\n  MutationOperation,\n  RetrievalOperation,\n  UOWCompiler,\n} from \"../../query/unit-of-work\";\nimport type { KyselyConfig } from \"./kysely-adapter\";\nimport { createKyselyQueryCompiler } from \"./kysely-query-compiler\";\nimport { createKyselyQueryBuilder } from \"./kysely-query-builder\";\nimport { buildCondition, type Condition } from \"../../query/condition-builder\";\nimport { decodeCursor, serializeCursorValues } from \"../../query/cursor\";\nimport type { AnySelectClause } from \"../../query/query\";\n\n/**\n * Create a Kysely-specific Unit of Work compiler\n *\n * This compiler translates UOW operations into Kysely CompiledQuery objects\n * that can be executed as a batch/transaction.\n *\n * @param schema - The database schema\n * @param config - Kysely configuration\n * @returns A UOWCompiler instance for Kysely\n */\nexport function createKyselyUOWCompiler<TSchema extends AnySchema>(\n  schema: TSchema,\n  config: KyselyConfig,\n): UOWCompiler<TSchema, CompiledQuery> {\n  const queryCompiler = createKyselyQueryCompiler(schema, config);\n  const queryBuilder = createKyselyQueryBuilder(config.db, config.provider);\n  const { provider } = config;\n\n  function toTable(name: unknown) {\n    const table = schema.tables[name as string];\n    if (!table) {\n      throw new Error(`Invalid table name ${name}.`);\n    }\n    return table;\n  }\n\n  return {\n    compileRetrievalOperation(op: RetrievalOperation<TSchema>): CompiledQuery | null {\n      switch (op.type) {\n        case \"count\": {\n          return queryCompiler.count(op.table.name, {\n            where: op.options.where,\n          });\n        }\n\n        case \"find\": {\n          // Map UOW FindOptions to query compiler's FindManyOptions\n          const {\n            useIndex: _useIndex,\n            orderByIndex,\n            joins: join,\n            after,\n            before,\n            pageSize,\n            ...findManyOptions\n          } = op.options;\n\n          // Get index columns for ordering and cursor pagination\n          let indexColumns: AnyColumn[] = [];\n          let orderDirection: \"asc\" | \"desc\" = \"asc\";\n\n          if (orderByIndex) {\n            const index = op.table.indexes[orderByIndex.indexName];\n            orderDirection = orderByIndex.direction;\n\n            if (!index) {\n              // If _primary index doesn't exist, fall back to internal ID column\n              // (which is the actual primary key and maintains insertion order)\n              if (orderByIndex.indexName === \"_primary\") {\n                indexColumns = [op.table.getIdColumn()];\n              } else {\n                throw new Error(\n                  `Index \"${orderByIndex.indexName}\" not found on table \"${op.table.name}\"`,\n                );\n              }\n            } else {\n              // Order by all columns in the index with the specified direction\n              indexColumns = index.columns;\n            }\n          }\n\n          // Convert orderByIndex to orderBy format\n          let orderBy: [AnyColumn, \"asc\" | \"desc\"][] | undefined;\n          if (indexColumns.length > 0) {\n            orderBy = indexColumns.map((col) => [col, orderDirection]);\n          }\n\n          // Handle cursor pagination - build a cursor condition\n          let cursorCondition: Condition | undefined;\n\n          if ((after || before) && indexColumns.length > 0) {\n            const cursor = after || before;\n            const cursorData = decodeCursor(cursor!);\n            const serializedValues = serializeCursorValues(cursorData, indexColumns, provider);\n\n            // Build tuple comparison for cursor pagination\n            // For \"after\" with \"asc\": (col1, col2, ...) > (val1, val2, ...)\n            // For \"before\" with \"desc\": reverse the comparison\n            const isAfter = !!after;\n            const useGreaterThan =\n              (isAfter && orderDirection === \"asc\") || (!isAfter && orderDirection === \"desc\");\n\n            if (indexColumns.length === 1) {\n              // Simple single-column case\n              const col = indexColumns[0]!;\n              const val = serializedValues[col.ormName];\n              const operator = useGreaterThan ? \">\" : \"<\";\n              cursorCondition = {\n                type: \"compare\",\n                a: col,\n                operator,\n                b: val,\n              };\n            } else {\n              // Multi-column tuple comparison - not yet supported for Kysely\n              throw new Error(\n                \"Multi-column cursor pagination is not yet supported in Kysely Unit of Work implementation\",\n              );\n            }\n          }\n\n          // Combine user where clause with cursor condition\n          let combinedWhere: Condition | undefined;\n          if (findManyOptions.where) {\n            const whereResult = buildCondition(op.table.columns, findManyOptions.where);\n            if (whereResult === true) {\n              combinedWhere = undefined;\n            } else if (whereResult === false) {\n              return null;\n            } else {\n              combinedWhere = whereResult;\n            }\n          }\n\n          if (cursorCondition) {\n            if (combinedWhere) {\n              combinedWhere = {\n                type: \"and\",\n                items: [combinedWhere, cursorCondition],\n              };\n            } else {\n              combinedWhere = cursorCondition;\n            }\n          }\n\n          // When we have joins or need to bypass buildFindOptions, use queryBuilder directly\n          if (join && join.length > 0) {\n            return queryBuilder.findMany(op.table, {\n              // Safe cast: select from UOW matches SimplifyFindOptions requirement\n              select: (findManyOptions.select ?? true) as AnySelectClause,\n              where: combinedWhere,\n              orderBy,\n              limit: pageSize,\n              join,\n            });\n          }\n\n          return queryCompiler.findMany(op.table.name, {\n            ...findManyOptions,\n            where: combinedWhere ? () => combinedWhere! : undefined,\n            orderBy: orderBy?.map(([col, dir]) => [col.ormName, dir]),\n            limit: pageSize,\n          });\n        }\n      }\n    },\n\n    compileMutationOperation(\n      op: MutationOperation<TSchema>,\n    ): CompiledMutation<CompiledQuery> | null {\n      switch (op.type) {\n        case \"create\":\n          // queryCompiler.create() calls encodeValues() which handles runtime defaults\n          return {\n            query: queryCompiler.create(op.table, op.values),\n            expectedAffectedRows: null, // creates don't need affected row checks\n          };\n\n        case \"update\": {\n          const table = toTable(op.table);\n          const idColumn = table.getIdColumn();\n          const versionColumn = table.getVersionColumn();\n\n          const externalId = typeof op.id === \"string\" ? op.id : op.id.externalId;\n          const versionToCheck = getVersionToCheck(op.id, op.checkVersion);\n\n          // Build WHERE clause that filters by ID and optionally by version\n          const whereClause =\n            versionToCheck !== undefined\n              ? () =>\n                  buildCondition(table.columns, (eb) =>\n                    eb.and(\n                      eb(idColumn.ormName, \"=\", externalId),\n                      eb(versionColumn.ormName, \"=\", versionToCheck),\n                    ),\n                  )\n              : () => buildCondition(table.columns, (eb) => eb(idColumn.ormName, \"=\", externalId));\n\n          const query = queryCompiler.updateMany(op.table, {\n            where: whereClause,\n            set: op.set,\n          });\n\n          return query\n            ? {\n                query,\n                expectedAffectedRows: op.checkVersion ? 1 : null,\n              }\n            : null;\n        }\n\n        case \"delete\": {\n          const table = toTable(op.table);\n          const idColumn = table.getIdColumn();\n          const versionColumn = table.getVersionColumn();\n\n          // Extract external ID based on whether op.id is FragnoId or string\n          const externalId = typeof op.id === \"string\" ? op.id : op.id.externalId;\n          const versionToCheck = getVersionToCheck(op.id, op.checkVersion);\n\n          // Build WHERE clause that filters by ID and optionally by version\n          const whereClause =\n            versionToCheck !== undefined\n              ? () =>\n                  buildCondition(table.columns, (eb) =>\n                    eb.and(\n                      eb(idColumn.ormName, \"=\", externalId),\n                      eb(versionColumn.ormName, \"=\", versionToCheck),\n                    ),\n                  )\n              : () => buildCondition(table.columns, (eb) => eb(idColumn.ormName, \"=\", externalId));\n\n          const query = queryCompiler.deleteMany(op.table, {\n            where: whereClause,\n          });\n\n          return query\n            ? {\n                query,\n                expectedAffectedRows: op.checkVersion ? 1 : null,\n              }\n            : null;\n        }\n      }\n    },\n  };\n}\n\n/**\n * Get the version to check for a given ID and checkVersion flag.\n * @returns The version to check or undefined if no check is required.\n * @throws Error if the ID is a string and checkVersion is true.\n */\nfunction getVersionToCheck(id: FragnoId | string, checkVersion: boolean): number | undefined {\n  if (!checkVersion) {\n    return undefined;\n  }\n\n  if (typeof id === \"string\") {\n    throw new Error(\n      `Cannot use checkVersion with a string ID. Version checking requires a FragnoId with version information.`,\n    );\n  }\n\n  return id.version;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,89 @@
+//#region src/adapters/kysely/kysely-uow-executor.ts
+function getAffectedRows(result) {
+	const affectedRows = result.numAffectedRows ?? result.numChangedRows ?? ("affectedRows" in result && (typeof result["affectedRows"] === "number" || typeof result["affectedRows"] === "bigint") ? result["affectedRows"] : void 0);
+	if (affectedRows === void 0) throw new Error("No affected rows found");
+	if (affectedRows > Number.MAX_SAFE_INTEGER) throw new Error(`affectedRows BigInt value ${affectedRows.toString()} exceeds JS safe integer range`);
+	return Number(affectedRows);
+}
+/**
+* Execute the retrieval phase of a Unit of Work using Kysely
+*
+* All retrieval queries are executed inside a single transaction to ensure
+* snapshot isolation - all reads see a consistent view of the database.
+*
+* @param kysely - The Kysely database instance
+* @param retrievalBatch - Array of compiled retrieval queries
+* @returns Array of query results matching the retrieval operations order
+*
+* @example
+* ```ts
+* const retrievalResults = await executeKyselyRetrievalPhase(kysely, compiled.retrievalBatch);
+* const [users, posts] = retrievalResults;
+* ```
+*/
+async function executeKyselyRetrievalPhase(kysely, retrievalBatch) {
+	if (retrievalBatch.length === 0) return [];
+	const retrievalResults = [];
+	await kysely.transaction().execute(async (tx) => {
+		for (const query of retrievalBatch) {
+			const result = await tx.executeQuery(query);
+			retrievalResults.push(result.rows);
+		}
+	});
+	return retrievalResults;
+}
+/**
+* Execute the mutation phase of a Unit of Work using Kysely
+*
+* All mutation queries are executed in a transaction with optimistic locking.
+* If any version check fails, the entire transaction is rolled back and
+* success=false is returned.
+*
+* @param kysely - The Kysely database instance
+* @param mutationBatch - Array of compiled mutation queries with expected affected rows
+* @returns Object with success flag and internal IDs from create operations
+*
+* @example
+* ```ts
+* const { success, createdInternalIds } = await executeKyselyMutationPhase(kysely, compiled.mutationBatch);
+* if (!success) {
+*   console.log("Version conflict detected, retrying...");
+* }
+* ```
+*/
+async function executeKyselyMutationPhase(kysely, mutationBatch) {
+	if (mutationBatch.length === 0) return {
+		success: true,
+		createdInternalIds: []
+	};
+	const createdInternalIds = [];
+	try {
+		await kysely.transaction().execute(async (tx) => {
+			for (const compiledMutation of mutationBatch) {
+				const result = await tx.executeQuery(compiledMutation.query);
+				if (compiledMutation.expectedAffectedRows === null) if (Array.isArray(result.rows) && result.rows.length > 0) {
+					const row = result.rows[0];
+					if ("_internalId" in row || "_internal_id" in row) {
+						const internalId = row["_internalId"] ?? row["_internal_id"];
+						createdInternalIds.push(internalId);
+					} else createdInternalIds.push(null);
+				} else createdInternalIds.push(null);
+				else {
+					const affectedRows = getAffectedRows(result);
+					if (affectedRows !== compiledMutation.expectedAffectedRows) throw new Error(`Version conflict: expected ${compiledMutation.expectedAffectedRows} rows affected, but got ${affectedRows}`);
+				}
+			}
+		});
+		return {
+			success: true,
+			createdInternalIds
+		};
+	} catch (error) {
+		if (error instanceof Error && error.message.includes("Version conflict")) return { success: false };
+		throw error;
+	}
+}
+
+//#endregion
+export { executeKyselyMutationPhase, executeKyselyRetrievalPhase };
+//# sourceMappingURL=kysely-uow-executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-uow-executor.js","names":["retrievalResults: unknown[]","createdInternalIds: (bigint | null)[]"],"sources":["../../../src/adapters/kysely/kysely-uow-executor.ts"],"sourcesContent":["import type { Kysely, QueryResult } from \"kysely\";\nimport type { CompiledMutation, MutationResult } from \"../../query/unit-of-work\";\n\nfunction getAffectedRows(result: QueryResult<unknown>): number {\n  const affectedRows =\n    result.numAffectedRows ??\n    result.numChangedRows ??\n    // PGLite returns `affectedRows` instead of `numAffectedRows` or `numChangedRows`\n    (\"affectedRows\" in result &&\n    (typeof result[\"affectedRows\"] === \"number\" || typeof result[\"affectedRows\"] === \"bigint\")\n      ? result[\"affectedRows\"]\n      : undefined);\n\n  if (affectedRows === undefined) {\n    throw new Error(\"No affected rows found\");\n  }\n\n  if (affectedRows > Number.MAX_SAFE_INTEGER) {\n    throw new Error(\n      `affectedRows BigInt value ${affectedRows.toString()} exceeds JS safe integer range`,\n    );\n  }\n\n  return Number(affectedRows);\n}\n\n/**\n * Execute the retrieval phase of a Unit of Work using Kysely\n *\n * All retrieval queries are executed inside a single transaction to ensure\n * snapshot isolation - all reads see a consistent view of the database.\n *\n * @param kysely - The Kysely database instance\n * @param retrievalBatch - Array of compiled retrieval queries\n * @returns Array of query results matching the retrieval operations order\n *\n * @example\n * ```ts\n * const retrievalResults = await executeKyselyRetrievalPhase(kysely, compiled.retrievalBatch);\n * const [users, posts] = retrievalResults;\n * ```\n */\nexport async function executeKyselyRetrievalPhase(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  kysely: Kysely<any>,\n  retrievalBatch: (Kysely<unknown>[\"executeQuery\"] extends (query: infer Q) => unknown\n    ? Q\n    : never)[],\n): Promise<unknown[]> {\n  // If no retrieval operations, return empty array immediately\n  if (retrievalBatch.length === 0) {\n    return [];\n  }\n\n  const retrievalResults: unknown[] = [];\n\n  // Execute all retrieval queries inside a transaction for snapshot isolation\n  await kysely.transaction().execute(async (tx) => {\n    for (const query of retrievalBatch) {\n      const result = await tx.executeQuery(query);\n      retrievalResults.push(result.rows);\n    }\n  });\n\n  return retrievalResults;\n}\n\n/**\n * Execute the mutation phase of a Unit of Work using Kysely\n *\n * All mutation queries are executed in a transaction with optimistic locking.\n * If any version check fails, the entire transaction is rolled back and\n * success=false is returned.\n *\n * @param kysely - The Kysely database instance\n * @param mutationBatch - Array of compiled mutation queries with expected affected rows\n * @returns Object with success flag and internal IDs from create operations\n *\n * @example\n * ```ts\n * const { success, createdInternalIds } = await executeKyselyMutationPhase(kysely, compiled.mutationBatch);\n * if (!success) {\n *   console.log(\"Version conflict detected, retrying...\");\n * }\n * ```\n */\nexport async function executeKyselyMutationPhase(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  kysely: Kysely<any>,\n  mutationBatch: CompiledMutation<\n    Kysely<unknown>[\"executeQuery\"] extends (query: infer Q) => unknown ? Q : never\n  >[],\n): Promise<MutationResult> {\n  // If there are no mutations, return success immediately\n  if (mutationBatch.length === 0) {\n    return { success: true, createdInternalIds: [] };\n  }\n\n  const createdInternalIds: (bigint | null)[] = [];\n\n  // Execute mutation batch in a transaction\n  try {\n    await kysely.transaction().execute(async (tx) => {\n      for (const compiledMutation of mutationBatch) {\n        const result = await tx.executeQuery(compiledMutation.query);\n\n        // For creates (expectedAffectedRows === null), try to extract internal ID\n        if (compiledMutation.expectedAffectedRows === null) {\n          // Check if result has rows (RETURNING clause supported)\n          if (Array.isArray(result.rows) && result.rows.length > 0) {\n            const row = result.rows[0] as Record<string, unknown>;\n            if (\"_internalId\" in row || \"_internal_id\" in row) {\n              const internalId = (row[\"_internalId\"] ?? row[\"_internal_id\"]) as bigint;\n              createdInternalIds.push(internalId);\n            } else {\n              // RETURNING supported but _internalId not found\n              createdInternalIds.push(null);\n            }\n          } else {\n            // No RETURNING support (e.g., MySQL)\n            createdInternalIds.push(null);\n          }\n        } else {\n          // Check affected rows for updates/deletes\n          const affectedRows = getAffectedRows(result);\n\n          if (affectedRows !== compiledMutation.expectedAffectedRows) {\n            // Version conflict detected - the UPDATE/DELETE didn't affect the expected number of rows\n            // This means either the row doesn't exist or the version has changed\n            throw new Error(\n              `Version conflict: expected ${compiledMutation.expectedAffectedRows} rows affected, but got ${affectedRows}`,\n            );\n          }\n        }\n      }\n    });\n\n    return { success: true, createdInternalIds };\n  } catch (error) {\n    // Transaction failed - could be version conflict or other constraint violation\n    // Return success=false to indicate the UOW should be retried\n    if (error instanceof Error && error.message.includes(\"Version conflict\")) {\n      return { success: false };\n    }\n\n    // Other database errors should be thrown\n    throw error;\n  }\n}\n"],"mappings":";AAGA,SAAS,gBAAgB,QAAsC;CAC7D,MAAM,eACJ,OAAO,mBACP,OAAO,mBAEN,kBAAkB,WAClB,OAAO,OAAO,oBAAoB,YAAY,OAAO,OAAO,oBAAoB,YAC7E,OAAO,kBACP;AAEN,KAAI,iBAAiB,OACnB,OAAM,IAAI,MAAM,yBAAyB;AAG3C,KAAI,eAAe,OAAO,iBACxB,OAAM,IAAI,MACR,6BAA6B,aAAa,UAAU,CAAC,gCACtD;AAGH,QAAO,OAAO,aAAa;;;;;;;;;;;;;;;;;;AAmB7B,eAAsB,4BAEpB,QACA,gBAGoB;AAEpB,KAAI,eAAe,WAAW,EAC5B,QAAO,EAAE;CAGX,MAAMA,mBAA8B,EAAE;AAGtC,OAAM,OAAO,aAAa,CAAC,QAAQ,OAAO,OAAO;AAC/C,OAAK,MAAM,SAAS,gBAAgB;GAClC,MAAM,SAAS,MAAM,GAAG,aAAa,MAAM;AAC3C,oBAAiB,KAAK,OAAO,KAAK;;GAEpC;AAEF,QAAO;;;;;;;;;;;;;;;;;;;;;AAsBT,eAAsB,2BAEpB,QACA,eAGyB;AAEzB,KAAI,cAAc,WAAW,EAC3B,QAAO;EAAE,SAAS;EAAM,oBAAoB,EAAE;EAAE;CAGlD,MAAMC,qBAAwC,EAAE;AAGhD,KAAI;AACF,QAAM,OAAO,aAAa,CAAC,QAAQ,OAAO,OAAO;AAC/C,QAAK,MAAM,oBAAoB,eAAe;IAC5C,MAAM,SAAS,MAAM,GAAG,aAAa,iBAAiB,MAAM;AAG5D,QAAI,iBAAiB,yBAAyB,KAE5C,KAAI,MAAM,QAAQ,OAAO,KAAK,IAAI,OAAO,KAAK,SAAS,GAAG;KACxD,MAAM,MAAM,OAAO,KAAK;AACxB,SAAI,iBAAiB,OAAO,kBAAkB,KAAK;MACjD,MAAM,aAAc,IAAI,kBAAkB,IAAI;AAC9C,yBAAmB,KAAK,WAAW;WAGnC,oBAAmB,KAAK,KAAK;UAI/B,oBAAmB,KAAK,KAAK;SAE1B;KAEL,MAAM,eAAe,gBAAgB,OAAO;AAE5C,SAAI,iBAAiB,iBAAiB,qBAGpC,OAAM,IAAI,MACR,8BAA8B,iBAAiB,qBAAqB,0BAA0B,eAC/F;;;IAIP;AAEF,SAAO;GAAE,SAAS;GAAM;GAAoB;UACrC,OAAO;AAGd,MAAI,iBAAiB,SAAS,MAAM,QAAQ,SAAS,mBAAmB,CACtE,QAAO,EAAE,SAAS,OAAO;AAI3B,QAAM"}

package/dist/adapters/kysely/migration/execute.js

@@ -0,0 +1,176 @@
+import { schemaToDBType } from "../../../schema/serialize.js";
+import { isUpdated } from "../../../migration-engine/shared.js";
+import { sql } from "kysely";
+
+//#region src/adapters/kysely/migration/execute.ts
+const errors = {
+	IdColumnUpdate: "ID columns cannot be updated. Not every database supports updating primary keys and often requires workarounds.",
+	SQLiteUpdateColumn: "SQLite doesn't support updating columns. Recreate the table instead.",
+	SQLiteUpdateForeignKeys: "SQLite doesn't support modifying foreign keys directly. Use `recreate-table` instead."
+};
+/**
+* Returns the appropriate foreign key action based on the provider.
+* MSSQL doesn't support RESTRICT, so we use NO ACTION (functionally equivalent).
+*/
+function getForeignKeyAction(provider) {
+	return provider === "mssql" ? "no action" : "restrict";
+}
+/**
+* Generates MSSQL default constraint name following the DF_tableName_columnName pattern.
+*/
+function getMssqlDefaultConstraintName(tableName, columnName) {
+	return `DF_${tableName}_${columnName}`;
+}
+function createUniqueIndex(db, name, tableName, cols, provider) {
+	const query = db.schema.createIndex(name).on(tableName).columns(cols).unique();
+	if (provider === "mssql") return query.where((b) => {
+		return b.and(cols.map((col) => b(col, "is not", null)));
+	});
+	return query;
+}
+function dropUniqueIndex(db, name, tableName, provider) {
+	let query = db.schema.dropIndex(name).ifExists();
+	if (provider === "cockroachdb") query = query.cascade();
+	if (provider === "mssql") query = query.on(tableName);
+	return query;
+}
+function executeColumn(tableName, operation, config) {
+	const { db, provider } = config;
+	const next = () => db.schema.alterTable(tableName);
+	const results = [];
+	switch (operation.type) {
+		case "rename-column":
+			results.push(next().renameColumn(operation.from, operation.to));
+			return results;
+		case "drop-column":
+			results.push(next().dropColumn(operation.name));
+			return results;
+		case "create-column": {
+			const col = operation.value;
+			results.push(next().addColumn(col.name, sql.raw(schemaToDBType(col, provider)), getColumnBuilderCallback(col, provider)));
+			return results;
+		}
+		case "update-column": {
+			const col = operation.value;
+			if (col.role === "external-id" || col.role === "internal-id") throw new Error(errors.IdColumnUpdate);
+			if (provider === "sqlite") throw new Error(errors.SQLiteUpdateColumn);
+			if (!isUpdated(operation)) return results;
+			if (provider === "mysql") {
+				results.push(next().modifyColumn(operation.name, sql.raw(schemaToDBType(col, provider)), getColumnBuilderCallback(col, provider)));
+				return results;
+			}
+			const mssqlRecreateDefaultConstraint = operation.updateDataType || operation.updateDefault;
+			if (provider === "mssql" && mssqlRecreateDefaultConstraint) results.push(rawToNode(db, mssqlDropDefaultConstraint(tableName, col.name)));
+			if (operation.updateDataType) {
+				const dbType = sql.raw(schemaToDBType(col, provider));
+				if (provider === "postgresql" || provider === "cockroachdb") results.push(rawToNode(db, sql`ALTER TABLE ${sql.ref(tableName)} ALTER COLUMN ${sql.ref(operation.name)} TYPE ${dbType} USING (${sql.ref(operation.name)}::${dbType})`));
+				else results.push(next().alterColumn(operation.name, (b) => b.setDataType(dbType)));
+			}
+			if (operation.updateNullable) results.push(next().alterColumn(operation.name, (build) => col.isNullable ? build.dropNotNull() : build.setNotNull()));
+			if (provider === "mssql" && mssqlRecreateDefaultConstraint) {
+				const defaultValue = defaultValueToDB(col, provider);
+				if (defaultValue) {
+					const constraintName = getMssqlDefaultConstraintName(tableName, col.name);
+					results.push(rawToNode(db, sql`ALTER TABLE ${sql.ref(tableName)} ADD CONSTRAINT ${sql.ref(constraintName)} DEFAULT ${defaultValue} FOR ${sql.ref(col.name)}`));
+				}
+			} else if (operation.updateDefault) {
+				const defaultValue = defaultValueToDB(col, provider);
+				results.push(next().alterColumn(operation.name, (build) => {
+					if (!defaultValue) return build.dropDefault();
+					return build.setDefault(defaultValue);
+				}));
+			}
+			return results;
+		}
+	}
+}
+function execute(operation, config, onCustomNode) {
+	const { db, provider } = config;
+	function createTable(tableName, columns) {
+		let builder = db.schema.createTable(tableName);
+		for (const columnInfo of columns) builder = builder.addColumn(columnInfo.name, sql.raw(schemaToDBType(columnInfo, provider)), getColumnBuilderCallback(columnInfo, provider));
+		return builder;
+	}
+	switch (operation.type) {
+		case "create-table": return createTable(operation.name, operation.columns);
+		case "rename-table":
+			if (provider === "mssql") return rawToNode(db, sql`EXEC sp_rename ${sql.lit(operation.from)}, ${sql.lit(operation.to)}`);
+			return db.schema.alterTable(operation.from).renameTo(operation.to);
+		case "alter-table": {
+			const results = [];
+			for (const op of operation.value) results.push(...executeColumn(operation.name, op, config));
+			return results;
+		}
+		case "drop-table": return db.schema.dropTable(operation.name);
+		case "custom": return onCustomNode(operation);
+		case "add-foreign-key": {
+			if (provider === "sqlite") throw new Error(errors.SQLiteUpdateForeignKeys);
+			const { table, value } = operation;
+			const action = getForeignKeyAction(provider);
+			return db.schema.alterTable(table).addForeignKeyConstraint(value.name, value.columns, value.referencedTable, value.referencedColumns, (b) => b.onUpdate(action).onDelete(action));
+		}
+		case "drop-foreign-key": {
+			if (provider === "sqlite") throw new Error(errors.SQLiteUpdateForeignKeys);
+			const { table, name } = operation;
+			let query = db.schema.alterTable(table).dropConstraint(name);
+			if (provider !== "mysql") query = query.ifExists();
+			return query;
+		}
+		case "add-index":
+			if (operation.unique) return createUniqueIndex(db, operation.name, operation.table, operation.columns, provider);
+			return db.schema.createIndex(operation.name).on(operation.table).columns(operation.columns);
+		case "drop-index": return dropUniqueIndex(db, operation.name, operation.table, provider);
+	}
+}
+function getColumnBuilderCallback(col, provider) {
+	return (build) => {
+		if (!col.isNullable) build = build.notNull();
+		if (col.role === "internal-id") {
+			build = build.primaryKey();
+			if (provider === "postgresql" || provider === "cockroachdb") {} else if (provider === "mysql") build = build.autoIncrement();
+			else if (provider === "sqlite") build = build.autoIncrement();
+			else if (provider === "mssql") build = build.identity();
+		}
+		if (col.role === "external-id") build = build.unique();
+		const defaultValue = defaultValueToDB(col, provider);
+		if (defaultValue) build = build.defaultTo(defaultValue);
+		return build;
+	};
+}
+function rawToNode(db, raw) {
+	return {
+		compile() {
+			return raw.compile(db);
+		},
+		execute() {
+			return raw.execute(db);
+		}
+	};
+}
+function mssqlDropDefaultConstraint(tableName, columnName) {
+	return sql`
+DECLARE @ConstraintName NVARCHAR(200);
+
+SELECT @ConstraintName = dc.name
+FROM sys.default_constraints dc
+JOIN sys.columns c ON dc.parent_object_id = c.object_id AND dc.parent_column_id = c.column_id
+JOIN sys.tables t ON t.object_id = c.object_id
+JOIN sys.schemas s ON t.schema_id = s.schema_id
+WHERE s.name = 'dbo' AND t.name = ${sql.lit(tableName)} AND c.name = ${sql.lit(columnName)};
+
+IF @ConstraintName IS NOT NULL
+BEGIN
+    EXEC('ALTER TABLE [dbo].[' + ${sql.lit(tableName)} + '] DROP CONSTRAINT [' + @ConstraintName + ']');
+END`;
+}
+function defaultValueToDB(column, provider) {
+	const value = column.default;
+	if (!value) return;
+	if (provider === "mysql" && column.type === "string") return;
+	if ("runtime" in value && value.runtime === "now") return sql`CURRENT_TIMESTAMP`;
+	if ("value" in value && value.value !== void 0) return sql.lit(value.value);
+}
+
+//#endregion
+export { execute };
+//# sourceMappingURL=execute.js.map

package/dist/adapters/kysely/migration/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","names":["results: ExecuteNode[]"],"sources":["../../../../src/adapters/kysely/migration/execute.ts"],"sourcesContent":["import {\n  type ColumnBuilderCallback,\n  type Compilable,\n  type CreateTableBuilder,\n  type Kysely,\n  type RawBuilder,\n  sql,\n} from \"kysely\";\nimport {\n  type CustomOperation,\n  isUpdated,\n  type ColumnOperation,\n  type MigrationOperation,\n  type ColumnInfo,\n} from \"../../../migration-engine/shared\";\nimport type { SQLProvider } from \"../../../shared/providers\";\nimport { schemaToDBType } from \"../../../schema/serialize\";\nimport type { KyselyConfig } from \"../kysely-adapter\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype KyselyAny = Kysely<any>;\n\nexport type ExecuteNode = Compilable & {\n  execute(): Promise<unknown>;\n};\n\nconst errors = {\n  IdColumnUpdate:\n    \"ID columns cannot be updated. Not every database supports updating primary keys and often requires workarounds.\",\n  SQLiteUpdateColumn: \"SQLite doesn't support updating columns. Recreate the table instead.\",\n  SQLiteUpdateForeignKeys:\n    \"SQLite doesn't support modifying foreign keys directly. Use `recreate-table` instead.\",\n} as const;\n\n/**\n * Returns the appropriate foreign key action based on the provider.\n * MSSQL doesn't support RESTRICT, so we use NO ACTION (functionally equivalent).\n */\nfunction getForeignKeyAction(provider: SQLProvider): \"restrict\" | \"no action\" {\n  return provider === \"mssql\" ? \"no action\" : \"restrict\";\n}\n\n/**\n * Generates MSSQL default constraint name following the DF_tableName_columnName pattern.\n */\nfunction getMssqlDefaultConstraintName(tableName: string, columnName: string): string {\n  const MSSQL_DEFAULT_CONSTRAINT_PREFIX = \"DF\" as const;\n  return `${MSSQL_DEFAULT_CONSTRAINT_PREFIX}_${tableName}_${columnName}`;\n}\n\nfunction createUniqueIndex(\n  db: KyselyAny,\n  name: string,\n  tableName: string,\n  cols: string[],\n  provider: SQLProvider,\n) {\n  const query = db.schema.createIndex(name).on(tableName).columns(cols).unique();\n\n  if (provider === \"mssql\") {\n    // MSSQL: ignore null values in unique indexes by default\n    return query.where((b) => {\n      return b.and(cols.map((col) => b(col, \"is not\", null)));\n    });\n  }\n\n  return query;\n}\n\nfunction dropUniqueIndex(db: KyselyAny, name: string, tableName: string, provider: SQLProvider) {\n  let query = db.schema.dropIndex(name).ifExists();\n\n  if (provider === \"cockroachdb\") {\n    query = query.cascade();\n  }\n\n  if (provider === \"mssql\") {\n    query = query.on(tableName);\n  }\n\n  return query;\n}\n\nfunction executeColumn(\n  tableName: string,\n  operation: ColumnOperation,\n  config: KyselyConfig,\n): ExecuteNode[] {\n  const { db, provider } = config;\n  const next = () => db.schema.alterTable(tableName);\n  const results: ExecuteNode[] = [];\n\n  switch (operation.type) {\n    case \"rename-column\":\n      results.push(next().renameColumn(operation.from, operation.to));\n      return results;\n\n    case \"drop-column\":\n      results.push(next().dropColumn(operation.name));\n\n      return results;\n    case \"create-column\": {\n      const col = operation.value;\n\n      results.push(\n        next().addColumn(\n          col.name,\n          sql.raw(schemaToDBType(col, provider)),\n          getColumnBuilderCallback(col, provider),\n        ),\n      );\n\n      return results;\n    }\n    case \"update-column\": {\n      const col = operation.value;\n\n      if (col.role === \"external-id\" || col.role === \"internal-id\") {\n        throw new Error(errors.IdColumnUpdate);\n      }\n      if (provider === \"sqlite\") {\n        throw new Error(errors.SQLiteUpdateColumn);\n      }\n\n      if (!isUpdated(operation)) {\n        return results;\n      }\n      if (provider === \"mysql\") {\n        results.push(\n          next().modifyColumn(\n            operation.name,\n            sql.raw(schemaToDBType(col, provider)),\n            getColumnBuilderCallback(col, provider),\n          ),\n        );\n        return results;\n      }\n\n      // MSSQL requires dropping and recreating default constraints when changing data type or default value\n      const mssqlRecreateDefaultConstraint = operation.updateDataType || operation.updateDefault;\n\n      if (provider === \"mssql\" && mssqlRecreateDefaultConstraint) {\n        results.push(rawToNode(db, mssqlDropDefaultConstraint(tableName, col.name)));\n      }\n\n      // TODO: We should maybe do some of these operations in a single query\n\n      if (operation.updateDataType) {\n        const dbType = sql.raw(schemaToDBType(col, provider));\n\n        if (provider === \"postgresql\" || provider === \"cockroachdb\") {\n          // PostgreSQL/CockroachDB: Use explicit USING clause for type conversion\n          results.push(\n            rawToNode(\n              db,\n              sql`ALTER TABLE ${sql.ref(tableName)} ALTER COLUMN ${sql.ref(operation.name)} TYPE ${dbType} USING (${sql.ref(operation.name)}::${dbType})`,\n            ),\n          );\n        } else {\n          results.push(next().alterColumn(operation.name, (b) => b.setDataType(dbType)));\n        }\n      }\n\n      if (operation.updateNullable) {\n        results.push(\n          next().alterColumn(operation.name, (build) =>\n            col.isNullable ? build.dropNotNull() : build.setNotNull(),\n          ),\n        );\n      }\n\n      if (provider === \"mssql\" && mssqlRecreateDefaultConstraint) {\n        const defaultValue = defaultValueToDB(col, provider);\n\n        if (defaultValue) {\n          const constraintName = getMssqlDefaultConstraintName(tableName, col.name);\n\n          results.push(\n            rawToNode(\n              db,\n              sql`ALTER TABLE ${sql.ref(tableName)} ADD CONSTRAINT ${sql.ref(constraintName)} DEFAULT ${defaultValue} FOR ${sql.ref(col.name)}`,\n            ),\n          );\n        }\n      } else if (operation.updateDefault) {\n        const defaultValue = defaultValueToDB(col, provider);\n\n        results.push(\n          next().alterColumn(operation.name, (build) => {\n            if (!defaultValue) {\n              return build.dropDefault();\n            }\n            return build.setDefault(defaultValue);\n          }),\n        );\n      }\n\n      return results;\n    }\n  }\n}\n\nexport function execute(\n  operation: MigrationOperation,\n  config: KyselyConfig,\n  onCustomNode: (op: CustomOperation) => ExecuteNode | ExecuteNode[],\n): ExecuteNode | ExecuteNode[] {\n  const { db, provider } = config;\n\n  function createTable(tableName: string, columns: ColumnInfo[]) {\n    let builder = db.schema.createTable(tableName) as CreateTableBuilder<string, string>;\n\n    // Add columns from the column info array\n    for (const columnInfo of columns) {\n      builder = builder.addColumn(\n        columnInfo.name,\n        sql.raw(schemaToDBType(columnInfo, provider)),\n        getColumnBuilderCallback(columnInfo, provider),\n      );\n    }\n\n    return builder;\n  }\n\n  switch (operation.type) {\n    case \"create-table\":\n      return createTable(operation.name, operation.columns);\n    case \"rename-table\":\n      if (provider === \"mssql\") {\n        return rawToNode(\n          db,\n          sql`EXEC sp_rename ${sql.lit(operation.from)}, ${sql.lit(operation.to)}`,\n        );\n      }\n\n      return db.schema.alterTable(operation.from).renameTo(operation.to);\n    case \"alter-table\": {\n      const results: ExecuteNode[] = [];\n\n      for (const op of operation.value) {\n        results.push(...executeColumn(operation.name, op, config));\n      }\n\n      return results;\n    }\n    case \"drop-table\":\n      return db.schema.dropTable(operation.name);\n    case \"custom\":\n      return onCustomNode(operation);\n    case \"add-foreign-key\": {\n      if (provider === \"sqlite\") {\n        throw new Error(errors.SQLiteUpdateForeignKeys);\n      }\n\n      const { table, value } = operation;\n      const action = getForeignKeyAction(provider);\n\n      return db.schema\n        .alterTable(table)\n        .addForeignKeyConstraint(\n          value.name,\n          value.columns,\n          value.referencedTable,\n          value.referencedColumns,\n          (b) => b.onUpdate(action).onDelete(action),\n        );\n    }\n    case \"drop-foreign-key\": {\n      if (provider === \"sqlite\") {\n        throw new Error(errors.SQLiteUpdateForeignKeys);\n      }\n\n      const { table, name } = operation;\n      let query = db.schema.alterTable(table).dropConstraint(name);\n\n      // MySQL doesn't support IF EXISTS for dropping constraints\n      if (provider !== \"mysql\") {\n        query = query.ifExists();\n      }\n\n      return query;\n    }\n    case \"add-index\": {\n      if (operation.unique) {\n        return createUniqueIndex(db, operation.name, operation.table, operation.columns, provider);\n      }\n      return db.schema.createIndex(operation.name).on(operation.table).columns(operation.columns);\n    }\n    case \"drop-index\": {\n      return dropUniqueIndex(db, operation.name, operation.table, provider);\n    }\n  }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\nfunction getColumnBuilderCallback(col: ColumnInfo, provider: SQLProvider): ColumnBuilderCallback {\n  return (build) => {\n    if (!col.isNullable) {\n      build = build.notNull();\n    }\n\n    // Internal ID is the primary key with auto-increment\n    if (col.role === \"internal-id\") {\n      build = build.primaryKey();\n      // Auto-increment for internal ID\n      if (provider === \"postgresql\" || provider === \"cockroachdb\") {\n        // SERIAL/BIGSERIAL handles auto-increment\n        // Already handled in schemaToDBType\n      } else if (provider === \"mysql\") {\n        build = build.autoIncrement();\n      } else if (provider === \"sqlite\") {\n        build = build.autoIncrement();\n      } else if (provider === \"mssql\") {\n        build = build.identity();\n      }\n    }\n\n    // External ID must be unique\n    if (col.role === \"external-id\") {\n      build = build.unique();\n    }\n\n    const defaultValue = defaultValueToDB(col, provider);\n    if (defaultValue) {\n      build = build.defaultTo(defaultValue);\n    }\n    return build;\n  };\n}\n\nfunction rawToNode(db: KyselyAny, raw: RawBuilder<unknown>): ExecuteNode {\n  return {\n    compile() {\n      return raw.compile(db);\n    },\n    execute() {\n      return raw.execute(db);\n    },\n  };\n}\n\nfunction mssqlDropDefaultConstraint(tableName: string, columnName: string) {\n  return sql`\nDECLARE @ConstraintName NVARCHAR(200);\n\nSELECT @ConstraintName = dc.name\nFROM sys.default_constraints dc\nJOIN sys.columns c ON dc.parent_object_id = c.object_id AND dc.parent_column_id = c.column_id\nJOIN sys.tables t ON t.object_id = c.object_id\nJOIN sys.schemas s ON t.schema_id = s.schema_id\nWHERE s.name = 'dbo' AND t.name = ${sql.lit(tableName)} AND c.name = ${sql.lit(columnName)};\n\nIF @ConstraintName IS NOT NULL\nBEGIN\n    EXEC('ALTER TABLE [dbo].[' + ${sql.lit(tableName)} + '] DROP CONSTRAINT [' + @ConstraintName + ']');\nEND`;\n}\n\nfunction defaultValueToDB(column: ColumnInfo, provider: SQLProvider) {\n  const value = column.default;\n  if (!value) {\n    return undefined;\n  }\n\n  // MySQL doesn't support default values for TEXT columns\n  if (provider === \"mysql\" && column.type === \"string\") {\n    return undefined;\n  }\n\n  if (\"runtime\" in value && value.runtime === \"now\") {\n    return sql`CURRENT_TIMESTAMP`;\n  }\n\n  if (\"value\" in value && value.value !== undefined) {\n    return sql.lit(value.value);\n  }\n\n  return undefined;\n}\n"],"mappings":"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"}

package/dist/fragment.d.ts

@@ -0,0 +1,54 @@
+import { AnySchema } from "./schema/create.js";
+import { AbstractQuery } from "./query/query.js";
+import { DatabaseAdapter } from "./adapters/adapters.js";
+import { FragmentDefinition, FragnoPublicConfig } from "@fragno-dev/core";
+
+//#region src/fragment.d.ts
+
+/**
+ * Extended FragnoPublicConfig that includes a database adapter.
+ * Use this type when creating fragments with database support.
+ */
+type FragnoPublicConfigWithDatabase = FragnoPublicConfig & {
+  databaseAdapter: DatabaseAdapter<any>;
+};
+/**
+ * Additional context provided to database fragments containing the database adapter and ORM instance.
+ */
+type DatabaseFragmentContext<TSchema extends AnySchema> = {
+  databaseAdapter: DatabaseAdapter<any>;
+  orm: AbstractQuery<TSchema>;
+};
+declare class DatabaseFragmentBuilder<const TSchema extends AnySchema, const TConfig, const TDeps = {}, const TServices extends Record<string, unknown> = {}> {
+  #private;
+  constructor(options: {
+    name: string;
+    schema?: TSchema;
+    namespace?: string;
+    dependencies?: (context: {
+      config: TConfig;
+      fragnoConfig: FragnoPublicConfig;
+    } & DatabaseFragmentContext<TSchema>) => TDeps;
+    services?: (context: {
+      config: TConfig;
+      fragnoConfig: FragnoPublicConfig;
+      deps: TDeps;
+    } & DatabaseFragmentContext<TSchema>) => TServices;
+  });
+  get $requiredOptions(): FragnoPublicConfigWithDatabase;
+  get definition(): FragmentDefinition<TConfig, TDeps, TServices>;
+  withDatabase<TNewSchema extends AnySchema>(schema: TNewSchema, namespace?: string): DatabaseFragmentBuilder<TNewSchema, TConfig, TDeps, TServices>;
+  withDependencies<TNewDeps>(fn: (context: {
+    config: TConfig;
+    fragnoConfig: FragnoPublicConfig;
+  } & DatabaseFragmentContext<TSchema>) => TNewDeps): DatabaseFragmentBuilder<TSchema, TConfig, TNewDeps, {}>;
+  withServices<TNewServices extends Record<string, unknown>>(fn: (context: {
+    config: TConfig;
+    fragnoConfig: FragnoPublicConfig;
+    deps: TDeps;
+  } & DatabaseFragmentContext<TSchema>) => TNewServices): DatabaseFragmentBuilder<TSchema, TConfig, TDeps, TNewServices>;
+}
+declare function defineFragmentWithDatabase<TConfig = {}>(name: string): DatabaseFragmentBuilder<never, TConfig, {}, {}>;
+//#endregion
+export { DatabaseFragmentBuilder, DatabaseFragmentContext, FragnoPublicConfigWithDatabase, defineFragmentWithDatabase };
+//# sourceMappingURL=fragment.d.ts.map

package/dist/fragment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment.d.ts","names":[],"sources":["../src/fragment.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AASA;AAQA;AAAoD,KARxC,8BAAA,GAAiC,kBAQO,GAAA;EAEjC,eAAA,EARA,eAQA,CAAA,GAAA,CAAA;CACE;;;AAGrB;AACwB,KAPZ,uBAOY,CAAA,gBAP4B,SAO5B,CAAA,GAAA;EAGE,eAAA,EARP,eAQO,CAAA,GAAA,CAAA;EAqBb,GAAA,EA5BN,aA4BM,CA5BQ,OA4BR,CAAA;CAIG;AACM,cA9BT,uBA8BS,CAAA,sBA7BE,SA6BF,EAAA,aAAA,EAAA,cAAA,CAAA,CAAA,EAAA,wBA1BI,MA0BJ,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,CAAA,CAAA,CAAA,CAAA;EACY,CAAA,OAAA;EAAxB,WAAA,CAAA,OAAA,EAAA;IACD,IAAA,EAAA,MAAA;IAGO,MAAA,CAAA,EAVH,OAUG;IACM,SAAA,CAAA,EAAA,MAAA;IACR,YAAA,CAAA,EAAA,CAAA,OAAA,EAAA;MACoB,MAAA,EATlB,OASkB;MAAxB,YAAA,EARY,kBAQZ;IACD,CAAA,GARC,uBAQD,CARyB,OAQzB,CAAA,EAAA,GAPA,KAOA;IASiB,QAAA,CAAA,EAAA,CAAA,OAAA,EAAA;MAIa,MAAA,EAjBvB,OAiBuB;MAAS,YAAA,EAhB1B,kBAgB0B;MAAO,IAAA,EAfzC,KAeyC;IAAnC,CAAA,GAdV,uBAcU,CAdc,OAcd,CAAA,EAAA,GAbX,SAaW;EAoDc,CAAA;EACtB,IAAA,gBAAA,CAAA,CAAA,EAzDc,8BAyDd;EAEiB,IAAA,UAAA,CAAA,CAAA,EAvDT,kBAuDS,CAvDU,OAuDV,EAvDmB,KAuDnB,EAvD0B,SAuD1B,CAAA;EAAY,YAAA,CAAA,mBAHP,SAGO,CAAA,CAAA,MAAA,EAF7B,UAE6B,EAAA,SAAA,CAAA,EAAA,MAAA,CAAA,EAApC,uBAAoC,CAAZ,UAAY,EAAA,OAAA,EAAS,KAAT,EAAgB,SAAhB,CAAA;EAAS,gBAAA,CAAA,QAAA,CAAA,CAAA,EAAA,EAAA,CAAA,OAAA,EAAA;IAAO,MAAA,EA4BzC,OA5ByC;IAApD,YAAA,EA6BiB,kBA7BjB;EA4BW,CAAA,GAEN,uBAFM,CAEkB,OAFlB,CAAA,EAAA,GAGP,QAHO,CAAA,EAIX,uBAJW,CAIa,OAJb,EAIsB,OAJtB,EAI+B,QAJ/B,EAAA,CAAA,CAAA,CAAA;EACM,YAAA,CAAA,qBAac,MAbd,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,CAAA,EAAA,EAAA,CAAA,OAAA,EAAA;IACY,MAAA,EAelB,OAfkB;IAAxB,YAAA,EAgBY,kBAhBZ;IACD,IAAA,EAgBK,KAhBL;EACoB,CAAA,GAgBnB,uBAhBmB,CAgBK,OAhBL,CAAA,EAAA,GAiBpB,YAjBoB,CAAA,EAkBxB,uBAlBwB,CAkBA,OAlBA,EAkBS,OAlBT,EAkBkB,KAlBlB,EAkByB,YAlBzB,CAAA;;AAAkB,iBA6B/B,0BA7B+B,CAAA,UAAA,CAAA,CAAA,CAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EA+B5C,uBA/B4C,CAAA,KAAA,EA+Bb,OA/Ba,EAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA"}

package/dist/fragment.js

@@ -0,0 +1,92 @@
+//#region src/fragment.ts
+var DatabaseFragmentBuilder = class DatabaseFragmentBuilder {
+	#name;
+	#schema;
+	#namespace;
+	#dependencies;
+	#services;
+	constructor(options) {
+		this.#name = options.name;
+		this.#schema = options.schema;
+		this.#namespace = options.namespace;
+		this.#dependencies = options.dependencies;
+		this.#services = options.services;
+	}
+	get $requiredOptions() {
+		throw new Error("Type only method. Do not call.");
+	}
+	get definition() {
+		const schema = this.#schema;
+		const namespace = this.#namespace ?? "";
+		const name = this.#name;
+		const dependencies = this.#dependencies;
+		const services = this.#services;
+		return {
+			name,
+			dependencies: (config, options) => {
+				const dbContext = this.#createDatabaseContext(options, schema, namespace, name);
+				return dependencies?.({
+					config,
+					fragnoConfig: options,
+					...dbContext
+				}) ?? {};
+			},
+			services: (config, options, deps) => {
+				const dbContext = this.#createDatabaseContext(options, schema, namespace, name);
+				return services?.({
+					config,
+					fragnoConfig: options,
+					deps,
+					...dbContext
+				}) ?? {};
+			},
+			additionalContext: {
+				databaseSchema: schema,
+				databaseNamespace: namespace
+			}
+		};
+	}
+	#createDatabaseContext(options, schema, namespace, name) {
+		const databaseAdapter = options.databaseAdapter;
+		if (!databaseAdapter) throw new Error(`Fragment '${name}' requires a database adapter in options.databaseAdapter`);
+		if (!schema) throw new Error(`Fragment '${name}' requires a schema. Use withDatabase() to provide one.`);
+		return {
+			databaseAdapter,
+			orm: databaseAdapter.createQueryEngine(schema, namespace)
+		};
+	}
+	withDatabase(schema, namespace) {
+		return new DatabaseFragmentBuilder({
+			name: this.#name,
+			schema,
+			namespace: namespace ?? this.#name + "-db",
+			dependencies: this.#dependencies,
+			services: this.#services
+		});
+	}
+	withDependencies(fn) {
+		return new DatabaseFragmentBuilder({
+			name: this.#name,
+			schema: this.#schema,
+			namespace: this.#namespace,
+			dependencies: fn,
+			services: void 0
+		});
+	}
+	withServices(fn) {
+		return new DatabaseFragmentBuilder({
+			name: this.#name,
+			schema: this.#schema,
+			namespace: this.#namespace,
+			dependencies: this.#dependencies,
+			services: fn
+		});
+	}
+};
+function defineFragmentWithDatabase(name) {
+	return new DatabaseFragmentBuilder({ name });
+}
+
+//#endregion
+export { DatabaseFragmentBuilder, defineFragmentWithDatabase };
+//# sourceMappingURL=fragment.js.map