@fragno-dev/db 0.1.13 → 0.1.15

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

@@ -1,8 +1,8 @@
 //#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`);
+	const affectedRows = result.numAffectedRows ?? result.numChangedRows ?? ("affectedRows" in result && (typeof result["affectedRows"] === "number" || typeof result["affectedRows"] === "bigint") ? result["affectedRows"] : void 0) ?? ("numUpdatedRows" in result && (typeof result["numUpdatedRows"] === "number" || typeof result["numUpdatedRows"] === "bigint") ? result["numUpdatedRows"] : void 0);
+	if (affectedRows === void 0) throw new Error(`No affected rows found: ${JSON.stringify(result)}`);
+	if (typeof affectedRows === "bigint" && affectedRows > Number.MAX_SAFE_INTEGER) throw new Error(`affectedRows BigInt value ${affectedRows.toString()} exceeds JS safe integer range`);
 	return Number(affectedRows);
 }
 /**
@@ -68,10 +68,14 @@ async function executeKyselyMutationPhase(kysely, mutationBatch) {
 						createdInternalIds.push(internalId);
 					} else createdInternalIds.push(null);
 				} else createdInternalIds.push(null);
-				else {
+				else if (compiledMutation.expectedAffectedRows !== null) {
 					const affectedRows = getAffectedRows(result);
 					if (affectedRows !== compiledMutation.expectedAffectedRows) throw new Error(`Version conflict: expected ${compiledMutation.expectedAffectedRows} rows affected, but got ${affectedRows}`);
 				}
+				if (compiledMutation.expectedReturnedRows !== null) {
+					const rowCount = Array.isArray(result.rows) ? result.rows.length : 0;
+					if (rowCount !== compiledMutation.expectedReturnedRows) throw new Error(`Version conflict: expected ${compiledMutation.expectedReturnedRows} rows returned, but got ${rowCount}`);
+				}
 			}
 		});
 		return {

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

@@ -1 +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 { CompiledQuery, 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: CompiledQuery[],\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 compiledQuery of retrievalBatch) {\n      const result = await tx.executeQuery(compiledQuery);\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<CompiledQuery>[],\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,gBACoB;AAEpB,KAAI,eAAe,WAAW,EAC5B,QAAO,EAAE;CAGX,MAAMA,mBAA8B,EAAE;AAGtC,OAAM,OAAO,aAAa,CAAC,QAAQ,OAAO,OAAO;AAC/C,OAAK,MAAM,iBAAiB,gBAAgB;GAC1C,MAAM,SAAS,MAAM,GAAG,aAAa,cAAc;AACnD,oBAAiB,KAAK,OAAO,KAAK;;GAEpC;AAEF,QAAO;;;;;;;;;;;;;;;;;;;;;AAsBT,eAAsB,2BAEpB,QACA,eACyB;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"}
+{"version":3,"file":"kysely-uow-executor.js","names":["retrievalResults: unknown[]","createdInternalIds: (bigint | null)[]"],"sources":["../../../src/adapters/kysely/kysely-uow-executor.ts"],"sourcesContent":["import type { CompiledQuery, 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    // SQLite via SQLocal returns `numUpdatedRows` as BigInt\n    (\"numUpdatedRows\" in result &&\n    (typeof result[\"numUpdatedRows\"] === \"number\" || typeof result[\"numUpdatedRows\"] === \"bigint\")\n      ? result[\"numUpdatedRows\"]\n      : undefined);\n\n  if (affectedRows === undefined) {\n    throw new Error(`No affected rows found: ${JSON.stringify(result)}`);\n  }\n\n  if (typeof affectedRows === \"bigint\" && 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: CompiledQuery[],\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 compiledQuery of retrievalBatch) {\n      const result = await tx.executeQuery(compiledQuery);\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<CompiledQuery>[],\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        // Best-effort extraction: Try to get internal ID if available\n        // This is optional - the system works without it by using subqueries for references\n        if (compiledMutation.expectedAffectedRows === null) {\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 - that's okay\n              createdInternalIds.push(null);\n            }\n          } else {\n            // No rows returned (no RETURNING clause, or SQLite via executeQuery)\n            // This is fine - references will use subqueries based on external IDs\n            createdInternalIds.push(null);\n          }\n        } else if (compiledMutation.expectedAffectedRows !== null) {\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        if (compiledMutation.expectedReturnedRows !== null) {\n          // For SELECT queries (check operations), verify row count\n          const rowCount = Array.isArray(result.rows) ? result.rows.length : 0;\n\n          if (rowCount !== compiledMutation.expectedReturnedRows) {\n            // Version conflict detected - the SELECT didn't return 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.expectedReturnedRows} rows returned, but got ${rowCount}`,\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,YAEH,oBAAoB,WACpB,OAAO,OAAO,sBAAsB,YAAY,OAAO,OAAO,sBAAsB,YACjF,OAAO,oBACP;AAEN,KAAI,iBAAiB,OACnB,OAAM,IAAI,MAAM,2BAA2B,KAAK,UAAU,OAAO,GAAG;AAGtE,KAAI,OAAO,iBAAiB,YAAY,eAAe,OAAO,iBAC5D,OAAM,IAAI,MACR,6BAA6B,aAAa,UAAU,CAAC,gCACtD;AAGH,QAAO,OAAO,aAAa;;;;;;;;;;;;;;;;;;AAmB7B,eAAsB,4BAEpB,QACA,gBACoB;AAEpB,KAAI,eAAe,WAAW,EAC5B,QAAO,EAAE;CAGX,MAAMA,mBAA8B,EAAE;AAGtC,OAAM,OAAO,aAAa,CAAC,QAAQ,OAAO,OAAO;AAC/C,OAAK,MAAM,iBAAiB,gBAAgB;GAC1C,MAAM,SAAS,MAAM,GAAG,aAAa,cAAc;AACnD,oBAAiB,KAAK,OAAO,KAAK;;GAEpC;AAEF,QAAO;;;;;;;;;;;;;;;;;;;;;AAsBT,eAAsB,2BAEpB,QACA,eACyB;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;AAI5D,QAAI,iBAAiB,yBAAyB,KAC5C,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;UAK/B,oBAAmB,KAAK,KAAK;aAEtB,iBAAiB,yBAAyB,MAAM;KAEzD,MAAM,eAAe,gBAAgB,OAAO;AAE5C,SAAI,iBAAiB,iBAAiB,qBAGpC,OAAM,IAAI,MACR,8BAA8B,iBAAiB,qBAAqB,0BAA0B,eAC/F;;AAIL,QAAI,iBAAiB,yBAAyB,MAAM;KAElD,MAAM,WAAW,MAAM,QAAQ,OAAO,KAAK,GAAG,OAAO,KAAK,SAAS;AAEnE,SAAI,aAAa,iBAAiB,qBAGhC,OAAM,IAAI,MACR,8BAA8B,iBAAiB,qBAAqB,0BAA0B,WAC/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-base.js

@@ -1,5 +1,5 @@
 import { schemaToDBType } from "../../../schema/serialize.js";
-import { SETTINGS_TABLE_NAME } from "../../../shared/settings-schema.js";
+import { SETTINGS_TABLE_NAME } from "../../../fragments/internal-fragment.js";
 import { sql } from "kysely";
 
 //#region src/adapters/kysely/migration/execute-base.ts

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

@@ -1 +1 @@
-{"version":3,"file":"execute-base.js","names":["db: KyselyAny","provider: SQLProvider"],"sources":["../../../../src/adapters/kysely/migration/execute-base.ts"],"sourcesContent":["import { type ColumnBuilderCallback, type Kysely, type RawBuilder, sql } from \"kysely\";\nimport type {\n  ColumnInfo,\n  MigrationOperation,\n  MigrationOperationMetadata,\n} from \"../../../migration-engine/shared\";\nimport type { SQLProvider } from \"../../../shared/providers\";\nimport { schemaToDBType } from \"../../../schema/serialize\";\nimport type { TableNameMapper } from \"../kysely-shared\";\nimport { SETTINGS_TABLE_NAME } from \"../../../shared/settings-schema\";\n\nexport type ExecuteNode = {\n  compile(): { sql: string; parameters: readonly unknown[] };\n  execute(): Promise<unknown>;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype KyselyAny = Kysely<any>;\n\n/**\n * Migration executor interface.\n * Each provider implements this to handle database-specific migration execution.\n */\nexport interface MigrationExecutor<\n  TMeta extends MigrationOperationMetadata = MigrationOperationMetadata,\n> {\n  /**\n   * Preprocess operations before execution.\n   * Allows executors to combine, split, or transform operations based on provider capabilities.\n   *\n   * For example, SQLite can merge add-foreign-key operations into create-table operations.\n   */\n  preprocessOperations(operations: MigrationOperation[]): MigrationOperation<TMeta>[];\n\n  /**\n   * Execute a single migration operation.\n   */\n  executeOperation(\n    operation: MigrationOperation<TMeta>,\n    mapper?: TableNameMapper,\n  ): ExecuteNode | ExecuteNode[];\n}\n\n/**\n * Base migration executor with common functionality.\n * Provider-specific executors should extend this class.\n */\nexport abstract class BaseMigrationExecutor<\n  TMeta extends MigrationOperationMetadata = MigrationOperationMetadata,\n> implements MigrationExecutor<TMeta>\n{\n  constructor(\n    protected readonly db: KyselyAny,\n    protected readonly provider: SQLProvider,\n  ) {}\n\n  /**\n   * Default implementation: no preprocessing, no metadata.\n   * Providers can override to transform operations.\n   */\n  preprocessOperations(operations: MigrationOperation[]): MigrationOperation<TMeta>[] {\n    return operations as MigrationOperation<TMeta>[];\n  }\n\n  /**\n   * Execute a single migration operation.\n   * Must be implemented by provider-specific executors.\n   */\n  abstract executeOperation(\n    operation: MigrationOperation<TMeta>,\n    mapper?: TableNameMapper,\n  ): ExecuteNode | ExecuteNode[];\n\n  /**\n   * Get table name, applying namespace mapping if provided.\n   * Settings table is never namespaced.\n   */\n  protected getTableName(tableName: string, mapper?: TableNameMapper): string {\n    return tableName === SETTINGS_TABLE_NAME\n      ? tableName\n      : mapper\n        ? mapper.toPhysical(tableName)\n        : tableName;\n  }\n\n  /**\n   * Get column builder callback for creating/altering columns.\n   */\n  protected getColumnBuilderCallback(col: ColumnInfo): 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 (this.provider === \"postgresql\" || this.provider === \"cockroachdb\") {\n          // SERIAL/BIGSERIAL handles auto-increment\n          // Already handled in schemaToDBType\n        } else if (this.provider === \"mysql\") {\n          build = build.autoIncrement();\n        } else if (this.provider === \"sqlite\") {\n          build = build.autoIncrement();\n        } else if (this.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 = this.defaultValueToDB(col);\n      if (defaultValue) {\n        build = build.defaultTo(defaultValue);\n      }\n      return build;\n    };\n  }\n\n  /**\n   * Convert column default value to database representation.\n   */\n  protected defaultValueToDB(column: ColumnInfo): RawBuilder<unknown> | undefined {\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 (this.provider === \"mysql\" && column.type === \"string\") {\n      return undefined;\n    }\n\n    // Static default values: defaultTo(value)\n    if (\"value\" in value && value.value !== undefined) {\n      return sql.lit(value.value);\n    }\n\n    // Database-level special functions: defaultTo(b => b.now())\n    if (\"dbSpecial\" in value && value.dbSpecial === \"now\") {\n      return sql`CURRENT_TIMESTAMP`;\n    }\n\n    // Runtime defaults (defaultTo$) are NOT generated in SQL - they're handled in application code\n    if (\"runtime\" in value) {\n      return undefined;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Wrap a raw SQL builder in an ExecuteNode.\n   */\n  protected rawToNode(raw: RawBuilder<unknown>): ExecuteNode {\n    return {\n      compile: () => raw.compile(this.db),\n      execute: () => raw.execute(this.db),\n    };\n  }\n\n  /**\n   * Get the database type string for a column.\n   */\n  protected getDBType(col: ColumnInfo): string {\n    return schemaToDBType(col, this.provider);\n  }\n}\n\n// ============================================================================\n// Provider-Specific Helper Functions\n// ============================================================================\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 */\nexport function 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 */\nexport function 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\n/**\n * Generate SQL to drop MSSQL default constraint.\n */\nexport function 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\n/**\n * Create a unique index with provider-specific handling.\n */\nexport function 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\n/**\n * Drop a unique index with provider-specific handling.\n */\nexport function dropUniqueIndex(\n  db: KyselyAny,\n  name: string,\n  tableName: string,\n  provider: SQLProvider,\n) {\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"],"mappings":";;;;;;;;;AA+CA,IAAsB,wBAAtB,MAGA;CACE,YACE,AAAmBA,IACnB,AAAmBC,UACnB;EAFmB;EACA;;;;;;CAOrB,qBAAqB,YAA+D;AAClF,SAAO;;;;;;CAgBT,AAAU,aAAa,WAAmB,QAAkC;AAC1E,SAAO,cAAc,sBACjB,YACA,SACE,OAAO,WAAW,UAAU,GAC5B;;;;;CAMR,AAAU,yBAAyB,KAAwC;AACzE,UAAQ,UAAU;AAChB,OAAI,CAAC,IAAI,WACP,SAAQ,MAAM,SAAS;AAIzB,OAAI,IAAI,SAAS,eAAe;AAC9B,YAAQ,MAAM,YAAY;AAE1B,QAAI,KAAK,aAAa,gBAAgB,KAAK,aAAa,eAAe,YAG5D,KAAK,aAAa,QAC3B,SAAQ,MAAM,eAAe;aACpB,KAAK,aAAa,SAC3B,SAAQ,MAAM,eAAe;aACpB,KAAK,aAAa,QAC3B,SAAQ,MAAM,UAAU;;AAK5B,OAAI,IAAI,SAAS,cACf,SAAQ,MAAM,QAAQ;GAGxB,MAAM,eAAe,KAAK,iBAAiB,IAAI;AAC/C,OAAI,aACF,SAAQ,MAAM,UAAU,aAAa;AAEvC,UAAO;;;;;;CAOX,AAAU,iBAAiB,QAAqD;EAC9E,MAAM,QAAQ,OAAO;AACrB,MAAI,CAAC,MACH;AAIF,MAAI,KAAK,aAAa,WAAW,OAAO,SAAS,SAC/C;AAIF,MAAI,WAAW,SAAS,MAAM,UAAU,OACtC,QAAO,IAAI,IAAI,MAAM,MAAM;AAI7B,MAAI,eAAe,SAAS,MAAM,cAAc,MAC9C,QAAO,GAAG;AAIZ,MAAI,aAAa,MACf;;;;;CASJ,AAAU,UAAU,KAAuC;AACzD,SAAO;GACL,eAAe,IAAI,QAAQ,KAAK,GAAG;GACnC,eAAe,IAAI,QAAQ,KAAK,GAAG;GACpC;;;;;CAMH,AAAU,UAAU,KAAyB;AAC3C,SAAO,eAAe,KAAK,KAAK,SAAS;;;;;;;AAY7C,SAAgB,oBAAoB,UAAiD;AACnF,QAAO,aAAa,UAAU,cAAc;;;;;AAM9C,SAAgB,8BAA8B,WAAmB,YAA4B;AAE3F,QAAO,MAAsC,UAAU,GAAG;;;;;AAM5D,SAAgB,2BAA2B,WAAmB,YAAoB;AAChF,QAAO,GAAG;;;;;;;;oCAQwB,IAAI,IAAI,UAAU,CAAC,gBAAgB,IAAI,IAAI,WAAW,CAAC;;;;mCAIxD,IAAI,IAAI,UAAU,CAAC;;;;;;AAOtD,SAAgB,kBACd,IACA,MACA,WACA,MACA,UACA;CACA,MAAM,QAAQ,GAAG,OAAO,YAAY,KAAK,CAAC,GAAG,UAAU,CAAC,QAAQ,KAAK,CAAC,QAAQ;AAE9E,KAAI,aAAa,QAEf,QAAO,MAAM,OAAO,MAAM;AACxB,SAAO,EAAE,IAAI,KAAK,KAAK,QAAQ,EAAE,KAAK,UAAU,KAAK,CAAC,CAAC;GACvD;AAGJ,QAAO;;;;;AAMT,SAAgB,gBACd,IACA,MACA,WACA,UACA;CACA,IAAI,QAAQ,GAAG,OAAO,UAAU,KAAK,CAAC,UAAU;AAEhD,KAAI,aAAa,cACf,SAAQ,MAAM,SAAS;AAGzB,KAAI,aAAa,QACf,SAAQ,MAAM,GAAG,UAAU;AAG7B,QAAO"}
+{"version":3,"file":"execute-base.js","names":["db: KyselyAny","provider: SQLProvider"],"sources":["../../../../src/adapters/kysely/migration/execute-base.ts"],"sourcesContent":["import { type ColumnBuilderCallback, type Kysely, type RawBuilder, sql } from \"kysely\";\nimport type {\n  ColumnInfo,\n  MigrationOperation,\n  MigrationOperationMetadata,\n} from \"../../../migration-engine/shared\";\nimport type { SQLProvider } from \"../../../shared/providers\";\nimport { schemaToDBType } from \"../../../schema/serialize\";\nimport type { TableNameMapper } from \"../kysely-shared\";\nimport { SETTINGS_TABLE_NAME } from \"../../../fragments/internal-fragment\";\n\nexport type ExecuteNode = {\n  compile(): { sql: string; parameters: readonly unknown[] };\n  execute(): Promise<unknown>;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype KyselyAny = Kysely<any>;\n\n/**\n * Migration executor interface.\n * Each provider implements this to handle database-specific migration execution.\n */\nexport interface MigrationExecutor<\n  TMeta extends MigrationOperationMetadata = MigrationOperationMetadata,\n> {\n  /**\n   * Preprocess operations before execution.\n   * Allows executors to combine, split, or transform operations based on provider capabilities.\n   *\n   * For example, SQLite can merge add-foreign-key operations into create-table operations.\n   */\n  preprocessOperations(operations: MigrationOperation[]): MigrationOperation<TMeta>[];\n\n  /**\n   * Execute a single migration operation.\n   */\n  executeOperation(\n    operation: MigrationOperation<TMeta>,\n    mapper?: TableNameMapper,\n  ): ExecuteNode | ExecuteNode[];\n}\n\n/**\n * Base migration executor with common functionality.\n * Provider-specific executors should extend this class.\n */\nexport abstract class BaseMigrationExecutor<\n  TMeta extends MigrationOperationMetadata = MigrationOperationMetadata,\n> implements MigrationExecutor<TMeta>\n{\n  constructor(\n    protected readonly db: KyselyAny,\n    protected readonly provider: SQLProvider,\n  ) {}\n\n  /**\n   * Default implementation: no preprocessing, no metadata.\n   * Providers can override to transform operations.\n   */\n  preprocessOperations(operations: MigrationOperation[]): MigrationOperation<TMeta>[] {\n    return operations as MigrationOperation<TMeta>[];\n  }\n\n  /**\n   * Execute a single migration operation.\n   * Must be implemented by provider-specific executors.\n   */\n  abstract executeOperation(\n    operation: MigrationOperation<TMeta>,\n    mapper?: TableNameMapper,\n  ): ExecuteNode | ExecuteNode[];\n\n  /**\n   * Get table name, applying namespace mapping if provided.\n   * Settings table is never namespaced.\n   */\n  protected getTableName(tableName: string, mapper?: TableNameMapper): string {\n    return tableName === SETTINGS_TABLE_NAME\n      ? tableName\n      : mapper\n        ? mapper.toPhysical(tableName)\n        : tableName;\n  }\n\n  /**\n   * Get column builder callback for creating/altering columns.\n   */\n  protected getColumnBuilderCallback(col: ColumnInfo): 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 (this.provider === \"postgresql\" || this.provider === \"cockroachdb\") {\n          // SERIAL/BIGSERIAL handles auto-increment\n          // Already handled in schemaToDBType\n        } else if (this.provider === \"mysql\") {\n          build = build.autoIncrement();\n        } else if (this.provider === \"sqlite\") {\n          build = build.autoIncrement();\n        } else if (this.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 = this.defaultValueToDB(col);\n      if (defaultValue) {\n        build = build.defaultTo(defaultValue);\n      }\n      return build;\n    };\n  }\n\n  /**\n   * Convert column default value to database representation.\n   */\n  protected defaultValueToDB(column: ColumnInfo): RawBuilder<unknown> | undefined {\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 (this.provider === \"mysql\" && column.type === \"string\") {\n      return undefined;\n    }\n\n    // Static default values: defaultTo(value)\n    if (\"value\" in value && value.value !== undefined) {\n      return sql.lit(value.value);\n    }\n\n    // Database-level special functions: defaultTo(b => b.now())\n    if (\"dbSpecial\" in value && value.dbSpecial === \"now\") {\n      return sql`CURRENT_TIMESTAMP`;\n    }\n\n    // Runtime defaults (defaultTo$) are NOT generated in SQL - they're handled in application code\n    if (\"runtime\" in value) {\n      return undefined;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Wrap a raw SQL builder in an ExecuteNode.\n   */\n  protected rawToNode(raw: RawBuilder<unknown>): ExecuteNode {\n    return {\n      compile: () => raw.compile(this.db),\n      execute: () => raw.execute(this.db),\n    };\n  }\n\n  /**\n   * Get the database type string for a column.\n   */\n  protected getDBType(col: ColumnInfo): string {\n    return schemaToDBType(col, this.provider);\n  }\n}\n\n// ============================================================================\n// Provider-Specific Helper Functions\n// ============================================================================\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 */\nexport function 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 */\nexport function 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\n/**\n * Generate SQL to drop MSSQL default constraint.\n */\nexport function 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\n/**\n * Create a unique index with provider-specific handling.\n */\nexport function 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\n/**\n * Drop a unique index with provider-specific handling.\n */\nexport function dropUniqueIndex(\n  db: KyselyAny,\n  name: string,\n  tableName: string,\n  provider: SQLProvider,\n) {\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"],"mappings":";;;;;;;;;AA+CA,IAAsB,wBAAtB,MAGA;CACE,YACE,AAAmBA,IACnB,AAAmBC,UACnB;EAFmB;EACA;;;;;;CAOrB,qBAAqB,YAA+D;AAClF,SAAO;;;;;;CAgBT,AAAU,aAAa,WAAmB,QAAkC;AAC1E,SAAO,cAAc,sBACjB,YACA,SACE,OAAO,WAAW,UAAU,GAC5B;;;;;CAMR,AAAU,yBAAyB,KAAwC;AACzE,UAAQ,UAAU;AAChB,OAAI,CAAC,IAAI,WACP,SAAQ,MAAM,SAAS;AAIzB,OAAI,IAAI,SAAS,eAAe;AAC9B,YAAQ,MAAM,YAAY;AAE1B,QAAI,KAAK,aAAa,gBAAgB,KAAK,aAAa,eAAe,YAG5D,KAAK,aAAa,QAC3B,SAAQ,MAAM,eAAe;aACpB,KAAK,aAAa,SAC3B,SAAQ,MAAM,eAAe;aACpB,KAAK,aAAa,QAC3B,SAAQ,MAAM,UAAU;;AAK5B,OAAI,IAAI,SAAS,cACf,SAAQ,MAAM,QAAQ;GAGxB,MAAM,eAAe,KAAK,iBAAiB,IAAI;AAC/C,OAAI,aACF,SAAQ,MAAM,UAAU,aAAa;AAEvC,UAAO;;;;;;CAOX,AAAU,iBAAiB,QAAqD;EAC9E,MAAM,QAAQ,OAAO;AACrB,MAAI,CAAC,MACH;AAIF,MAAI,KAAK,aAAa,WAAW,OAAO,SAAS,SAC/C;AAIF,MAAI,WAAW,SAAS,MAAM,UAAU,OACtC,QAAO,IAAI,IAAI,MAAM,MAAM;AAI7B,MAAI,eAAe,SAAS,MAAM,cAAc,MAC9C,QAAO,GAAG;AAIZ,MAAI,aAAa,MACf;;;;;CASJ,AAAU,UAAU,KAAuC;AACzD,SAAO;GACL,eAAe,IAAI,QAAQ,KAAK,GAAG;GACnC,eAAe,IAAI,QAAQ,KAAK,GAAG;GACpC;;;;;CAMH,AAAU,UAAU,KAAyB;AAC3C,SAAO,eAAe,KAAK,KAAK,SAAS;;;;;;;AAY7C,SAAgB,oBAAoB,UAAiD;AACnF,QAAO,aAAa,UAAU,cAAc;;;;;AAM9C,SAAgB,8BAA8B,WAAmB,YAA4B;AAE3F,QAAO,MAAsC,UAAU,GAAG;;;;;AAM5D,SAAgB,2BAA2B,WAAmB,YAAoB;AAChF,QAAO,GAAG;;;;;;;;oCAQwB,IAAI,IAAI,UAAU,CAAC,gBAAgB,IAAI,IAAI,WAAW,CAAC;;;;mCAIxD,IAAI,IAAI,UAAU,CAAC;;;;;;AAOtD,SAAgB,kBACd,IACA,MACA,WACA,MACA,UACA;CACA,MAAM,QAAQ,GAAG,OAAO,YAAY,KAAK,CAAC,GAAG,UAAU,CAAC,QAAQ,KAAK,CAAC,QAAQ;AAE9E,KAAI,aAAa,QAEf,QAAO,MAAM,OAAO,MAAM;AACxB,SAAO,EAAE,IAAI,KAAK,KAAK,QAAQ,EAAE,KAAK,UAAU,KAAK,CAAC,CAAC;GACvD;AAGJ,QAAO;;;;;AAMT,SAAgB,gBACd,IACA,MACA,WACA,UACA;CACA,IAAI,QAAQ,GAAG,OAAO,UAAU,KAAK,CAAC,UAAU;AAEhD,KAAI,aAAa,cACf,SAAQ,MAAM,SAAS;AAGzB,KAAI,aAAa,QACf,SAAQ,MAAM,GAAG,UAAU;AAG7B,QAAO"}

package/dist/db-fragment-definition-builder.d.ts

@@ -0,0 +1,152 @@
+import { AnySchema } from "./schema/create.js";
+import { IUnitOfWork, TypedUnitOfWork } from "./query/unit-of-work.js";
+import { AbstractQuery } from "./query/query.js";
+import { DatabaseAdapter } from "./adapters/adapters.js";
+import { AwaitedPromisesInObject, ExecuteRestrictedUnitOfWorkOptions } from "./query/execute-unit-of-work.js";
+import { FragmentDefinition, FragmentDefinitionBuilder, FragnoPublicConfig, RequestThisContext, ServiceConstructorFn } from "@fragno-dev/core";
+
+//#region src/db-fragment-definition-builder.d.ts
+
+/**
+ * Extended FragnoPublicConfig that includes a database adapter.
+ * Use this type when creating fragments with database support.
+ */
+type FragnoPublicConfigWithDatabase = FragnoPublicConfig & {
+  databaseAdapter: DatabaseAdapter<any>;
+};
+/**
+ * Implicit dependencies that database fragments get automatically.
+ * These are injected without requiring explicit configuration.
+ */
+type ImplicitDatabaseDependencies<TSchema extends AnySchema> = {
+  /**
+   * Database query engine for the fragment's schema.
+   */
+  db: AbstractQuery<TSchema>;
+  /**
+   * The schema definition for this fragment.
+   */
+  schema: TSchema;
+  /**
+   * The database namespace for this fragment.
+   */
+  namespace: string;
+  /**
+   * Create a new Unit of Work for database operations.
+   */
+  createUnitOfWork: () => IUnitOfWork;
+};
+/**
+ * Service context for database fragments - provides restricted UOW access without execute methods.
+ */
+type DatabaseServiceContext = RequestThisContext & {
+  /**
+   * Get a typed, restricted Unit of Work for the given schema.
+   * @param schema - Schema to get a typed view for
+   * @returns TypedUnitOfWork (restricted version without execute methods)
+   */
+  uow<TSchema extends AnySchema>(schema: TSchema): TypedUnitOfWork<TSchema, [], unknown>;
+};
+/**
+ * Handler context for database fragments - provides UOW execution with automatic retry support.
+ */
+type DatabaseHandlerContext = RequestThisContext & {
+  /**
+   * Execute a Unit of Work with explicit phase control and automatic retry support.
+   * This method provides an API where users call forSchema to create a schema-specific
+   * UOW, then call executeRetrieve() and executeMutate() to execute the phases. The entire
+   * callback is re-executed on optimistic concurrency conflicts, ensuring retries work properly.
+   * Automatically provides the UOW factory from context.
+   * Promises in the returned object are awaited 1 level deep.
+   *
+   * @param callback - Async function that receives a context with forSchema, executeRetrieve, executeMutate, nonce, and currentAttempt
+   * @param options - Optional configuration for retry policy and abort signal
+   * @returns Promise resolving to the callback's return value with promises awaited 1 level deep
+   * @throws Error if retries are exhausted or callback throws an error
+   *
+   * @example
+   * ```ts
+   * const result = await this.uow(async ({ forSchema, executeRetrieve, executeMutate, nonce, currentAttempt }) => {
+   *   const uow = forSchema(schema);
+   *   const userId = uow.create("users", { name: "John" });
+   *
+   *   // Execute retrieval phase
+   *   await executeRetrieve();
+   *
+   *   const profileId = uow.create("profiles", { userId });
+   *
+   *   // Execute mutation phase
+   *   await executeMutate();
+   *
+   *   return { userId, profileId };
+   * });
+   * ```
+   */
+  uow<TResult>(callback: (context: {
+    forSchema: <S extends AnySchema>(schema: S) => TypedUnitOfWork<S, [], unknown>;
+    executeRetrieve: () => Promise<void>;
+    executeMutate: () => Promise<void>;
+    nonce: string;
+    currentAttempt: number;
+  }) => Promise<TResult> | TResult, options?: Omit<ExecuteRestrictedUnitOfWorkOptions, "createUnitOfWork">): Promise<AwaitedPromisesInObject<TResult>>;
+};
+/**
+ * Database fragment context provided to user callbacks.
+ */
+type DatabaseFragmentContext<TSchema extends AnySchema> = {
+  /**
+   * Database adapter instance.
+   */
+  databaseAdapter: DatabaseAdapter<any>;
+  /**
+   * ORM query engine for the fragment's schema.
+   */
+  db: AbstractQuery<TSchema>;
+};
+/**
+ * Storage type for database fragments - stores the Unit of Work.
+ */
+type DatabaseRequestStorage = {
+  uow: IUnitOfWork;
+};
+/**
+ * Builder for database fragments that wraps the core fragment builder
+ * and provides database-specific functionality.
+ *
+ * Database fragments always require FragnoPublicConfigWithDatabase (which includes databaseAdapter).
+ */
+declare class DatabaseFragmentDefinitionBuilder<TSchema extends AnySchema, TConfig, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices, TServiceThisContext extends RequestThisContext = DatabaseHandlerContext, THandlerThisContext extends RequestThisContext = DatabaseHandlerContext> {
+  #private;
+  constructor(baseBuilder: FragmentDefinitionBuilder<TConfig, FragnoPublicConfigWithDatabase, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices, TServiceThisContext, THandlerThisContext, DatabaseRequestStorage>, schema: TSchema, namespace?: string);
+  /**
+   * Define dependencies for this database fragment.
+   * The context includes database adapter and ORM instance.
+   */
+  withDependencies<TNewDeps>(fn: (context: {
+    config: TConfig;
+    options: FragnoPublicConfigWithDatabase;
+    db: AbstractQuery<TSchema>;
+    databaseAdapter: DatabaseAdapter<any>;
+  }) => TNewDeps): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TNewDeps & ImplicitDatabaseDependencies<TSchema>, {}, {}, TServiceDependencies, {}, TServiceThisContext, THandlerThisContext>;
+  providesBaseService<TNewService>(fn: ServiceConstructorFn<TConfig, FragnoPublicConfigWithDatabase, TDeps, TServiceDependencies, TPrivateServices, TNewService, TServiceThisContext>): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps, TNewService, TServices, TServiceDependencies, TPrivateServices, TServiceThisContext, THandlerThisContext>;
+  providesService<TServiceName extends string, TService>(serviceName: TServiceName, fn: ServiceConstructorFn<TConfig, FragnoPublicConfigWithDatabase, TDeps, TServiceDependencies, TPrivateServices, TService, TServiceThisContext>): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps, TBaseServices, TServices & { [K in TServiceName]: TService }, TServiceDependencies, TPrivateServices, TServiceThisContext, THandlerThisContext>;
+  /**
+   * Declare that this fragment uses a required service provided by the runtime.
+   * Delegates to the base builder.
+   */
+  usesService<TServiceName extends string, TService>(serviceName: TServiceName): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps, TBaseServices, TServices, TServiceDependencies & { [K in TServiceName]: TService }, TPrivateServices, TServiceThisContext, THandlerThisContext>;
+  /**
+   * Declare that this fragment uses an optional service provided by the runtime.
+   * Delegates to the base builder.
+   */
+  usesOptionalService<TServiceName extends string, TService>(serviceName: TServiceName): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps, TBaseServices, TServices, TServiceDependencies & { [K in TServiceName]: TService | undefined }, TPrivateServices, TServiceThisContext, THandlerThisContext>;
+  /**
+   * Build the final database fragment definition.
+   * This includes the request context setup for UnitOfWork management.
+   * Note: TDeps already includes ImplicitDatabaseDependencies from withDatabase().
+   */
+  build(): FragmentDefinition<TConfig, FragnoPublicConfigWithDatabase, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices, DatabaseServiceContext, DatabaseHandlerContext, DatabaseRequestStorage>;
+}
+//#endregion
+export { DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, DatabaseHandlerContext, DatabaseRequestStorage, DatabaseServiceContext, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies };
+//# sourceMappingURL=db-fragment-definition-builder.d.ts.map

package/dist/db-fragment-definition-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-fragment-definition-builder.d.ts","names":[],"sources":["../src/db-fragment-definition-builder.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/db-fragment-definition-builder.js

@@ -0,0 +1,137 @@
+import "./query/unit-of-work.js";
+import { executeRestrictedUnitOfWork } from "./query/execute-unit-of-work.js";
+
+//#region src/db-fragment-definition-builder.ts
+/**
+* Create database context from options.
+* This extracts the database adapter and creates the ORM instance.
+*/
+function createDatabaseContext(options, schema, namespace) {
+	const databaseAdapter = options.databaseAdapter;
+	if (!databaseAdapter) throw new Error("Database fragment requires a database adapter to be provided in options.databaseAdapter");
+	return {
+		databaseAdapter,
+		db: databaseAdapter.createQueryEngine(schema, namespace)
+	};
+}
+/**
+* Builder for database fragments that wraps the core fragment builder
+* and provides database-specific functionality.
+*
+* Database fragments always require FragnoPublicConfigWithDatabase (which includes databaseAdapter).
+*/
+var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder {
+	#baseBuilder;
+	#schema;
+	#namespace;
+	constructor(baseBuilder, schema, namespace) {
+		this.#baseBuilder = baseBuilder;
+		this.#schema = schema;
+		this.#namespace = namespace ?? baseBuilder.name + "-db";
+	}
+	/**
+	* Define dependencies for this database fragment.
+	* The context includes database adapter and ORM instance.
+	*/
+	withDependencies(fn) {
+		const wrappedFn = (context) => {
+			const dbContext = createDatabaseContext(context.options, this.#schema, this.#namespace);
+			const userDeps = fn({
+				config: context.config,
+				options: context.options,
+				db: dbContext.db,
+				databaseAdapter: dbContext.databaseAdapter
+			});
+			const createUow = () => dbContext.db.createUnitOfWork();
+			const implicitDeps = {
+				db: dbContext.db,
+				schema: this.#schema,
+				namespace: this.#namespace,
+				createUnitOfWork: createUow
+			};
+			return {
+				...userDeps,
+				...implicitDeps
+			};
+		};
+		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.withDependencies(wrappedFn), this.#schema, this.#namespace);
+	}
+	providesBaseService(fn) {
+		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.providesBaseService(fn), this.#schema, this.#namespace);
+	}
+	providesService(serviceName, fn) {
+		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.providesService(serviceName, fn), this.#schema, this.#namespace);
+	}
+	/**
+	* Declare that this fragment uses a required service provided by the runtime.
+	* Delegates to the base builder.
+	*/
+	usesService(serviceName) {
+		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.usesService(serviceName), this.#schema, this.#namespace);
+	}
+	/**
+	* Declare that this fragment uses an optional service provided by the runtime.
+	* Delegates to the base builder.
+	*/
+	usesOptionalService(serviceName) {
+		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.usesOptionalService(serviceName), this.#schema, this.#namespace);
+	}
+	/**
+	* Build the final database fragment definition.
+	* This includes the request context setup for UnitOfWork management.
+	* Note: TDeps already includes ImplicitDatabaseDependencies from withDatabase().
+	*/
+	build() {
+		const dependencies = (context) => {
+			const userDeps = this.#baseBuilder.build().dependencies?.(context);
+			const { db } = createDatabaseContext(context.options, this.#schema, this.#namespace);
+			const implicitDeps = {
+				db,
+				schema: this.#schema,
+				namespace: this.#namespace,
+				createUnitOfWork: () => db.createUnitOfWork()
+			};
+			return {
+				...userDeps,
+				...implicitDeps
+			};
+		};
+		return {
+			...this.#baseBuilder.withExternalRequestStorage(({ options }) => {
+				return createDatabaseContext(options, this.#schema, this.#namespace).databaseAdapter.contextStorage;
+			}).withRequestStorage(({ options }) => {
+				return { uow: createDatabaseContext(options, this.#schema, this.#namespace).db.createUnitOfWork() };
+			}).withThisContext(({ storage }) => {
+				function forSchema(schema) {
+					const uow$1 = storage.getStore()?.uow;
+					if (!uow$1) throw new Error("No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.");
+					return uow$1.restrict().forSchema(schema);
+				}
+				const serviceContext = { uow: forSchema };
+				async function uow(callback, options) {
+					const currentStorage = storage.getStore();
+					if (!currentStorage) throw new Error("No storage in context. Handler must be called within a request context.");
+					const wrappedCallback = async (context) => {
+						return await callback(context);
+					};
+					return executeRestrictedUnitOfWork(wrappedCallback, {
+						...options,
+						createUnitOfWork: () => {
+							currentStorage.uow.reset();
+							return currentStorage.uow;
+						}
+					});
+				}
+				return {
+					serviceContext,
+					handlerContext: { uow }
+				};
+			}).build(),
+			dependencies
+		};
+	}
+};
+
+//#endregion
+export { DatabaseFragmentDefinitionBuilder };
+//# sourceMappingURL=db-fragment-definition-builder.js.map

package/dist/db-fragment-definition-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-fragment-definition-builder.js","names":["#baseBuilder","#schema","#namespace","implicitDeps: ImplicitDatabaseDependencies<TSchema>","uow","serviceContext: DatabaseServiceContext"],"sources":["../src/db-fragment-definition-builder.ts"],"sourcesContent":["import type { AnySchema } from \"./schema/create\";\nimport type { AbstractQuery } from \"./query/query\";\nimport type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type { IUnitOfWork } from \"./query/unit-of-work\";\nimport { TypedUnitOfWork, UnitOfWork } from \"./query/unit-of-work\";\nimport type { RequestThisContext, FragnoPublicConfig } from \"@fragno-dev/core\";\nimport {\n  FragmentDefinitionBuilder,\n  type FragmentDefinition,\n  type ServiceConstructorFn,\n} from \"@fragno-dev/core\";\nimport {\n  executeRestrictedUnitOfWork,\n  type AwaitedPromisesInObject,\n  type ExecuteRestrictedUnitOfWorkOptions,\n} from \"./query/execute-unit-of-work\";\n\n/**\n * Extended FragnoPublicConfig that includes a database adapter.\n * Use this type when creating fragments with database support.\n */\nexport type FragnoPublicConfigWithDatabase = FragnoPublicConfig & {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  databaseAdapter: DatabaseAdapter<any>;\n};\n\n/**\n * Implicit dependencies that database fragments get automatically.\n * These are injected without requiring explicit configuration.\n */\nexport type ImplicitDatabaseDependencies<TSchema extends AnySchema> = {\n  /**\n   * Database query engine for the fragment's schema.\n   */\n  db: AbstractQuery<TSchema>;\n  /**\n   * The schema definition for this fragment.\n   */\n  schema: TSchema;\n  /**\n   * The database namespace for this fragment.\n   */\n  namespace: string;\n  /**\n   * Create a new Unit of Work for database operations.\n   */\n  createUnitOfWork: () => IUnitOfWork;\n};\n\n/**\n * Service context for database fragments - provides restricted UOW access without execute methods.\n */\nexport type DatabaseServiceContext = RequestThisContext & {\n  /**\n   * Get a typed, restricted Unit of Work for the given schema.\n   * @param schema - Schema to get a typed view for\n   * @returns TypedUnitOfWork (restricted version without execute methods)\n   */\n  uow<TSchema extends AnySchema>(schema: TSchema): TypedUnitOfWork<TSchema, [], unknown>;\n};\n\n/**\n * Handler context for database fragments - provides UOW execution with automatic retry support.\n */\nexport type DatabaseHandlerContext = RequestThisContext & {\n  /**\n   * Execute a Unit of Work with explicit phase control and automatic retry support.\n   * This method provides an API where users call forSchema to create a schema-specific\n   * UOW, then call executeRetrieve() and executeMutate() to execute the phases. The entire\n   * callback is re-executed on optimistic concurrency conflicts, ensuring retries work properly.\n   * Automatically provides the UOW factory from context.\n   * Promises in the returned object are awaited 1 level deep.\n   *\n   * @param callback - Async function that receives a context with forSchema, executeRetrieve, executeMutate, nonce, and currentAttempt\n   * @param options - Optional configuration for retry policy and abort signal\n   * @returns Promise resolving to the callback's return value with promises awaited 1 level deep\n   * @throws Error if retries are exhausted or callback throws an error\n   *\n   * @example\n   * ```ts\n   * const result = await this.uow(async ({ forSchema, executeRetrieve, executeMutate, nonce, currentAttempt }) => {\n   *   const uow = forSchema(schema);\n   *   const userId = uow.create(\"users\", { name: \"John\" });\n   *\n   *   // Execute retrieval phase\n   *   await executeRetrieve();\n   *\n   *   const profileId = uow.create(\"profiles\", { userId });\n   *\n   *   // Execute mutation phase\n   *   await executeMutate();\n   *\n   *   return { userId, profileId };\n   * });\n   * ```\n   */\n  uow<TResult>(\n    callback: (context: {\n      forSchema: <S extends AnySchema>(schema: S) => TypedUnitOfWork<S, [], unknown>;\n      executeRetrieve: () => Promise<void>;\n      executeMutate: () => Promise<void>;\n      nonce: string;\n      currentAttempt: number;\n    }) => Promise<TResult> | TResult,\n    options?: Omit<ExecuteRestrictedUnitOfWorkOptions, \"createUnitOfWork\">,\n  ): Promise<AwaitedPromisesInObject<TResult>>;\n};\n\n/**\n * Database fragment context provided to user callbacks.\n */\nexport type DatabaseFragmentContext<TSchema extends AnySchema> = {\n  /**\n   * Database adapter instance.\n   */\n  databaseAdapter: DatabaseAdapter<any>; // eslint-disable-line @typescript-eslint/no-explicit-any\n  /**\n   * ORM query engine for the fragment's schema.\n   */\n  db: AbstractQuery<TSchema>;\n};\n\n/**\n * Create database context from options.\n * This extracts the database adapter and creates the ORM instance.\n */\nfunction createDatabaseContext<TSchema extends AnySchema>(\n  options: FragnoPublicConfigWithDatabase,\n  schema: TSchema,\n  namespace: string,\n): DatabaseFragmentContext<TSchema> {\n  const databaseAdapter = options.databaseAdapter;\n\n  if (!databaseAdapter) {\n    throw new Error(\n      \"Database fragment requires a database adapter to be provided in options.databaseAdapter\",\n    );\n  }\n\n  const db = databaseAdapter.createQueryEngine(schema, namespace);\n\n  return { databaseAdapter, db };\n}\n\n/**\n * Storage type for database fragments - stores the Unit of Work.\n */\nexport type DatabaseRequestStorage = {\n  uow: IUnitOfWork;\n};\n\n/**\n * Builder for database fragments that wraps the core fragment builder\n * and provides database-specific functionality.\n *\n * Database fragments always require FragnoPublicConfigWithDatabase (which includes databaseAdapter).\n */\nexport class DatabaseFragmentDefinitionBuilder<\n  TSchema extends AnySchema,\n  TConfig,\n  TDeps,\n  TBaseServices,\n  TServices,\n  TServiceDependencies,\n  TPrivateServices,\n  TServiceThisContext extends RequestThisContext = DatabaseHandlerContext,\n  THandlerThisContext extends RequestThisContext = DatabaseHandlerContext,\n> {\n  // Store the base builder - we'll replace its storage and context setup when building\n  #baseBuilder: FragmentDefinitionBuilder<\n    TConfig,\n    FragnoPublicConfigWithDatabase,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    DatabaseRequestStorage\n  >;\n  #schema: TSchema;\n  #namespace: string;\n\n  constructor(\n    baseBuilder: FragmentDefinitionBuilder<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      DatabaseRequestStorage\n    >,\n    schema: TSchema,\n    namespace?: string,\n  ) {\n    this.#baseBuilder = baseBuilder;\n    this.#schema = schema;\n    this.#namespace = namespace ?? baseBuilder.name + \"-db\";\n  }\n\n  /**\n   * Define dependencies for this database fragment.\n   * The context includes database adapter and ORM instance.\n   */\n  withDependencies<TNewDeps>(\n    fn: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n      db: AbstractQuery<TSchema>;\n      databaseAdapter: DatabaseAdapter<any>; // eslint-disable-line @typescript-eslint/no-explicit-any\n    }) => TNewDeps,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TNewDeps & ImplicitDatabaseDependencies<TSchema>,\n    {},\n    {},\n    TServiceDependencies,\n    {},\n    TServiceThisContext,\n    THandlerThisContext\n  > {\n    // Wrap user function to inject DB context\n    const wrappedFn = (context: { config: TConfig; options: FragnoPublicConfigWithDatabase }) => {\n      const dbContext = createDatabaseContext(context.options, this.#schema, this.#namespace);\n\n      // Call user function with enriched context\n      const userDeps = fn({\n        config: context.config,\n        options: context.options,\n        db: dbContext.db,\n        databaseAdapter: dbContext.databaseAdapter,\n      });\n\n      // Create implicit dependencies\n      const createUow = () => dbContext.db.createUnitOfWork();\n      const implicitDeps: ImplicitDatabaseDependencies<TSchema> = {\n        db: dbContext.db,\n        schema: this.#schema,\n        namespace: this.#namespace,\n        createUnitOfWork: createUow,\n      };\n\n      return {\n        ...userDeps,\n        ...implicitDeps,\n      };\n    };\n\n    // Create new base builder with wrapped function\n    const newBaseBuilder = this.#baseBuilder.withDependencies(wrappedFn);\n\n    // Return new database builder with updated base\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#namespace);\n  }\n\n  providesBaseService<TNewService>(\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TNewService,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesBaseService<TNewService>(fn);\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#namespace);\n  }\n\n  providesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices & { [K in TServiceName]: TService },\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesService<TServiceName, TService>(\n      serviceName,\n      fn,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#namespace);\n  }\n\n  /**\n   * Declare that this fragment uses a required service provided by the runtime.\n   * Delegates to the base builder.\n   */\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService },\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext\n  > {\n    const newBaseBuilder = this.#baseBuilder.usesService<TServiceName, TService>(serviceName);\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#namespace);\n  }\n\n  /**\n   * Declare that this fragment uses an optional service provided by the runtime.\n   * Delegates to the base builder.\n   */\n  usesOptionalService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService | undefined },\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext\n  > {\n    const newBaseBuilder = this.#baseBuilder.usesOptionalService<TServiceName, TService>(\n      serviceName,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#namespace);\n  }\n\n  /**\n   * Build the final database fragment definition.\n   * This includes the request context setup for UnitOfWork management.\n   * Note: TDeps already includes ImplicitDatabaseDependencies from withDatabase().\n   */\n  build(): FragmentDefinition<\n    TConfig,\n    FragnoPublicConfigWithDatabase,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    DatabaseServiceContext,\n    DatabaseHandlerContext,\n    DatabaseRequestStorage\n  > {\n    // Ensure dependencies callback always exists for database fragments\n    // If no user dependencies were defined, create a minimal one that only adds implicit deps\n    const dependencies = (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }): TDeps => {\n      const baseDef = this.#baseBuilder.build();\n      const userDeps = baseDef.dependencies?.(context);\n\n      const { db } = createDatabaseContext(context.options, this.#schema, this.#namespace);\n\n      const implicitDeps: ImplicitDatabaseDependencies<TSchema> = {\n        db,\n        schema: this.#schema,\n        namespace: this.#namespace,\n        createUnitOfWork: () => db.createUnitOfWork(),\n      };\n\n      return {\n        ...userDeps,\n        ...implicitDeps,\n      } as TDeps;\n    };\n\n    // Use the adapter's shared context storage (all fragments using the same adapter share this storage)\n    const builderWithExternalStorage = this.#baseBuilder.withExternalRequestStorage(\n      ({ options }) => {\n        const dbContext = createDatabaseContext(options, this.#schema, this.#namespace);\n        return dbContext.databaseAdapter.contextStorage;\n      },\n    );\n\n    // Set up request storage to initialize the Unit of Work\n    const builderWithStorage = builderWithExternalStorage.withRequestStorage(\n      ({ options }): DatabaseRequestStorage => {\n        // Create database context - needed here to create the UOW\n        const dbContextForStorage = createDatabaseContext(options, this.#schema, this.#namespace);\n\n        // Create a new Unit of Work for this request\n        const uow: IUnitOfWork = dbContextForStorage.db.createUnitOfWork();\n\n        return { uow };\n      },\n    );\n\n    // Services get restricted context (no execute methods), handlers get execution context\n    const builderWithContext = builderWithStorage.withThisContext<\n      DatabaseServiceContext,\n      DatabaseHandlerContext\n    >(({ storage }) => {\n      // Service context - forSchema method to get restricted typed UOW\n      function forSchema<TSchema extends AnySchema>(\n        schema: TSchema,\n      ): TypedUnitOfWork<TSchema, [], unknown> {\n        const uow = storage.getStore()?.uow;\n        if (!uow) {\n          throw new Error(\n            \"No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.\",\n          );\n        }\n\n        // Return typed view of restricted UOW\n        return uow.restrict().forSchema(schema);\n      }\n\n      const serviceContext: DatabaseServiceContext = {\n        uow: forSchema,\n      };\n\n      // Handler context - only executeRestrictedUnitOfWork\n      async function uow<TResult>(\n        callback: (context: {\n          forSchema: <S extends AnySchema>(schema: S) => TypedUnitOfWork<S, [], unknown>;\n          executeRetrieve: () => Promise<void>;\n          executeMutate: () => Promise<void>;\n          nonce: string;\n          currentAttempt: number;\n        }) => Promise<TResult> | TResult,\n        options?: Omit<ExecuteRestrictedUnitOfWorkOptions, \"createUnitOfWork\">,\n      ): Promise<AwaitedPromisesInObject<TResult>> {\n        const currentStorage = storage.getStore();\n        if (!currentStorage) {\n          throw new Error(\n            \"No storage in context. Handler must be called within a request context.\",\n          );\n        }\n\n        // Wrap callback to ensure it always returns a Promise\n        const wrappedCallback = async (context: {\n          forSchema: <S extends AnySchema>(schema: S) => TypedUnitOfWork<S, [], unknown>;\n          executeRetrieve: () => Promise<void>;\n          executeMutate: () => Promise<void>;\n          nonce: string;\n          currentAttempt: number;\n        }): Promise<TResult> => {\n          return await callback(context);\n        };\n\n        // Use the UOW from storage - reset it before each attempt for retry support\n        // Cast is safe because IUnitOfWork is actually implemented by UnitOfWork\n        return executeRestrictedUnitOfWork(wrappedCallback, {\n          ...options,\n          createUnitOfWork: () => {\n            currentStorage.uow.reset();\n            return currentStorage.uow as UnitOfWork;\n          },\n        });\n      }\n\n      const handlerContext: DatabaseHandlerContext = {\n        uow,\n      };\n\n      return { serviceContext, handlerContext };\n    });\n\n    // Build the final definition\n    const finalDef = builderWithContext.build();\n\n    // Return the complete definition with proper typing and dependencies\n    return {\n      ...finalDef,\n      dependencies,\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/fragments/internal-fragment.d.ts

@@ -0,0 +1,19 @@
+import { AnyColumn, AnyRelation, Column, FragnoId, IdColumn, Index, Schema, Table } from "../schema/create.js";
+import { DatabaseHandlerContext, DatabaseRequestStorage, DatabaseServiceContext, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies } from "../db-fragment-definition-builder.js";
+import * as _fragno_dev_core0 from "@fragno-dev/core";
+
+//#region src/fragments/internal-fragment.d.ts
+declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies<Schema<Record<"fragno_db_settings", Table<Record<string, AnyColumn> & Record<"id", IdColumn<"varchar(30)", string | FragnoId | null, FragnoId>> & Record<"key", Column<"string", string, string>> & Record<"value", Column<"string", string, string>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"unique_key", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["key"]>>>>>>, {}, {
+  settingsService: {
+    get(key: string): Promise<{
+      id: FragnoId;
+      key: string;
+      value: string;
+    } | undefined>;
+    set(key: string, value: string): Promise<void>;
+    delete(id: FragnoId): Promise<void>;
+  };
+}, {}, {}, DatabaseServiceContext, DatabaseHandlerContext, DatabaseRequestStorage, {}>;
+//#endregion
+export { internalFragmentDef };
+//# sourceMappingURL=internal-fragment.d.ts.map

package/dist/fragments/internal-fragment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-fragment.d.ts","names":[],"sources":["../../src/fragments/internal-fragment.ts"],"sourcesContent":[],"mappings":";;;;;AA6Ba,cAAA,mBAuDH,oBAvDsB,kBAuDtB,CAAA,CAAA,CAAA,EAvDsB,8BAuDtB,EAvDsB,4BAuDtB,CAvDsB,MAuDtB,CAvDsB,MAuDtB,CAAA,oBAAA,EAvDsB,KAuDtB,CAvDsB,MAuDtB,CAAA,MAAA,EAvDsB,SAAA,CAuDtB,GAvDsB,MAuDtB,CAAA,IAAA,EAvDsB,QAuDtB,CAAA,aAAA,EAAA,MAAA,GAvDsB,QAuDtB,GAAA,IAAA,EAvDsB,QAuDtB,CAAA,CAAA,GAvDsB,MAuDtB,CAAA,KAAA,EAvDsB,MAuDtB,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,GAvDsB,MAuDtB,CAAA,OAAA,EAvDsB,MAuDtB,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,EAvDsB,MAuDtB,CAAA,MAAA,EAvDsB,WAAA,CAuDtB,EAvDsB,MAuDtB,CAAA,MAAA,EAvDsB,KAuDtB,CAvDsB,SAAA,EAuDtB,EAAA,SAAA,MAAA,EAAA,CAAA,CAAA,GAvDsB,MAuDtB,CAAA,YAAA,EAvDsB,KAuDtB,CAAA,SAAA,CAvDsB,MAuDtB,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,GAvDsB,SAAA,EAuDtB,EAAA,SAAA,CAAA,KAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,EAAA;EAvDsB,eAAA,EAAA;IAAA,GAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAkBF,OAlBE,CAAA;MAAA,EAAA,EAkBY,QAlBZ;MAAA,GAAA,EAAA,MAAA;MAAA,KAAA,EAAA,MAAA;IAAA,CAAA,GAAA,SAAA,CAAA;IAAA,GAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAAA,MAAA,CAAA,EA0BU,OA1BV,CAAA,IAAA,CAAA;IAAA,MAAA,CAAA,EAAA,EAgDT,QAhDS,CAAA,EAgDD,OAhDC,CAAA,IAAA,CAAA;EAAA,CAAA;CAAA,EAAA,CAAA,CAAA,EAAA,CAAA,CAAA,wBAAA,wBAAA,wBAAA,EAAA,CAAA,CAAA,CAAA"}

package/dist/fragments/internal-fragment.js

@@ -0,0 +1,39 @@
+import { column, idColumn, schema } from "../schema/create.js";
+import { FragmentDefinitionBuilder } from "../packages/fragno/dist/api/fragment-definition-builder.js";
+import { DatabaseFragmentDefinitionBuilder } from "../db-fragment-definition-builder.js";
+
+//#region src/fragments/internal-fragment.ts
+const SETTINGS_TABLE_NAME = "fragno_db_settings";
+const SETTINGS_NAMESPACE = "fragno-db-settings";
+const settingsSchema = schema((s) => {
+	return s.addTable(SETTINGS_TABLE_NAME, (t) => {
+		return t.addColumn("id", idColumn()).addColumn("key", column("string")).addColumn("value", column("string")).createIndex("unique_key", ["key"], { unique: true });
+	});
+});
+const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDefinitionBuilder("$fragno-internal-fragment"), settingsSchema, "").providesService("settingsService", ({ defineService }) => {
+	return defineService({
+		async get(key) {
+			const [results] = await this.uow(settingsSchema).find(SETTINGS_TABLE_NAME, (b) => b.whereIndex("unique_key", (eb) => eb("key", "=", `${SETTINGS_NAMESPACE}.${key}`))).retrievalPhase;
+			return results?.[0];
+		},
+		async set(key, value) {
+			const uow = this.uow(settingsSchema);
+			const [existing] = await uow.find(SETTINGS_TABLE_NAME, (b) => b.whereIndex("unique_key", (eb) => eb("key", "=", `${SETTINGS_NAMESPACE}.${key}`))).retrievalPhase;
+			if (existing?.[0]) uow.update(SETTINGS_TABLE_NAME, existing[0].id, (b) => b.set({ value }).check());
+			else uow.create(SETTINGS_TABLE_NAME, {
+				key: `${SETTINGS_NAMESPACE}.${key}`,
+				value
+			});
+			await uow.mutationPhase;
+		},
+		async delete(id) {
+			const uow = this.uow(settingsSchema);
+			uow.delete(SETTINGS_TABLE_NAME, id);
+			await uow.mutationPhase;
+		}
+	});
+}).build();
+
+//#endregion
+export { SETTINGS_NAMESPACE, SETTINGS_TABLE_NAME, internalFragmentDef, settingsSchema };
+//# sourceMappingURL=internal-fragment.js.map

package/dist/fragments/internal-fragment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-fragment.js","names":[],"sources":["../../src/fragments/internal-fragment.ts"],"sourcesContent":["import { FragmentDefinitionBuilder } from \"@fragno-dev/core\";\nimport {\n  DatabaseFragmentDefinitionBuilder,\n  type DatabaseHandlerContext,\n  type DatabaseRequestStorage,\n  type DatabaseServiceContext,\n  type FragnoPublicConfigWithDatabase,\n  type ImplicitDatabaseDependencies,\n} from \"../db-fragment-definition-builder\";\nimport type { FragnoId } from \"../schema/create\";\nimport { schema, idColumn, column } from \"../schema/create\";\n\n// Constants for Fragno's internal settings table\nexport const SETTINGS_TABLE_NAME = \"fragno_db_settings\" as const;\nexport const SETTINGS_NAMESPACE = \"fragno-db-settings\" as const;\n\n// Settings schema for storing Fragno's internal key-value settings\nexport const settingsSchema = schema((s) => {\n  return s.addTable(SETTINGS_TABLE_NAME, (t) => {\n    return t\n      .addColumn(\"id\", idColumn())\n      .addColumn(\"key\", column(\"string\"))\n      .addColumn(\"value\", column(\"string\"))\n      .createIndex(\"unique_key\", [\"key\"], { unique: true });\n  });\n});\n\n// This uses DatabaseFragmentDefinitionBuilder directly\n// to avoid circular dependency (it doesn't need to link to itself)\nexport const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(\n  new FragmentDefinitionBuilder<\n    {},\n    FragnoPublicConfigWithDatabase,\n    ImplicitDatabaseDependencies<typeof settingsSchema>,\n    {},\n    {},\n    {},\n    {},\n    DatabaseServiceContext,\n    DatabaseHandlerContext,\n    DatabaseRequestStorage\n  >(\"$fragno-internal-fragment\"),\n  settingsSchema,\n  \"\", // intentionally blank namespace so there is no prefix\n)\n  .providesService(\"settingsService\", ({ defineService }) => {\n    return defineService({\n      async get(key: string): Promise<{ id: FragnoId; key: string; value: string } | undefined> {\n        const uow = this.uow(settingsSchema).find(SETTINGS_TABLE_NAME, (b) =>\n          b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", `${SETTINGS_NAMESPACE}.${key}`)),\n        );\n        const [results] = await uow.retrievalPhase;\n        return results?.[0];\n      },\n\n      async set(key: string, value: string) {\n        const uow = this.uow(settingsSchema);\n\n        // First, find if the key already exists\n        const findUow = uow.find(SETTINGS_TABLE_NAME, (b) =>\n          b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", `${SETTINGS_NAMESPACE}.${key}`)),\n        );\n        const [existing] = await findUow.retrievalPhase;\n\n        if (existing?.[0]) {\n          uow.update(SETTINGS_TABLE_NAME, existing[0].id, (b) => b.set({ value }).check());\n        } else {\n          uow.create(SETTINGS_TABLE_NAME, {\n            key: `${SETTINGS_NAMESPACE}.${key}`,\n            value,\n          });\n        }\n\n        // Await mutation phase - will throw if mutation fails\n        await uow.mutationPhase;\n      },\n\n      async delete(id: FragnoId) {\n        const uow = this.uow(settingsSchema);\n        uow.delete(SETTINGS_TABLE_NAME, id);\n        await uow.mutationPhase;\n      },\n    });\n  })\n  .build();\n"],"mappings":";;;;;AAaA,MAAa,sBAAsB;AACnC,MAAa,qBAAqB;AAGlC,MAAa,iBAAiB,QAAQ,MAAM;AAC1C,QAAO,EAAE,SAAS,sBAAsB,MAAM;AAC5C,SAAO,EACJ,UAAU,MAAM,UAAU,CAAC,CAC3B,UAAU,OAAO,OAAO,SAAS,CAAC,CAClC,UAAU,SAAS,OAAO,SAAS,CAAC,CACpC,YAAY,cAAc,CAAC,MAAM,EAAE,EAAE,QAAQ,MAAM,CAAC;GACvD;EACF;AAIF,MAAa,sBAAsB,IAAI,kCACrC,IAAI,0BAWF,4BAA4B,EAC9B,gBACA,GACD,CACE,gBAAgB,oBAAoB,EAAE,oBAAoB;AACzD,QAAO,cAAc;EACnB,MAAM,IAAI,KAAgF;GAIxF,MAAM,CAAC,WAAW,MAHN,KAAK,IAAI,eAAe,CAAC,KAAK,sBAAsB,MAC9D,EAAE,WAAW,eAAe,OAAO,GAAG,OAAO,KAAK,GAAG,mBAAmB,GAAG,MAAM,CAAC,CACnF,CAC2B;AAC5B,UAAO,UAAU;;EAGnB,MAAM,IAAI,KAAa,OAAe;GACpC,MAAM,MAAM,KAAK,IAAI,eAAe;GAMpC,MAAM,CAAC,YAAY,MAHH,IAAI,KAAK,sBAAsB,MAC7C,EAAE,WAAW,eAAe,OAAO,GAAG,OAAO,KAAK,GAAG,mBAAmB,GAAG,MAAM,CAAC,CACnF,CACgC;AAEjC,OAAI,WAAW,GACb,KAAI,OAAO,qBAAqB,SAAS,GAAG,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC;OAEhF,KAAI,OAAO,qBAAqB;IAC9B,KAAK,GAAG,mBAAmB,GAAG;IAC9B;IACD,CAAC;AAIJ,SAAM,IAAI;;EAGZ,MAAM,OAAO,IAAc;GACzB,MAAM,MAAM,KAAK,IAAI,eAAe;AACpC,OAAI,OAAO,qBAAqB,GAAG;AACnC,SAAM,IAAI;;EAEb,CAAC;EACF,CACD,OAAO"}

package/dist/migration-engine/generation-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generation-engine.d.ts","names":[],"sources":["../../src/migration-engine/generation-engine.ts"],"sourcesContent":[],"mappings":";;;;;UAaiB,sBAAA;;EAAA,IAAA,EAAA,MAAA;EAMA,SAAA,EAAA,MAAA;AASjB;AAOsB,UAhBL,wBAAA,CAgB+B;EAEN,MAAA,EAAA,MAAA;EAAf,IAAA,EAAA,MAAA;EAEd,SAAA,EAAA,MAAA;EAMF,WAAA,EAAA,MAAA;EAAR,SAAA,EAAA,MAAA;EAAO,iBAAA,CAAA,EApBY,iBAoBZ;AAiJV;AAAgF,UAlK/D,sBAAA,CAkK+D;EAAf,SAAA,EAAA,MAAA;EACpD,UAAA,EAAA,OAAA;EACF,WAAA,EAAA,MAAA;EAAR,SAAA,EAAA,MAAA;;AAyIa,iBAtSM,0BAuSb,CAAA,yBArSkB,cAsSxB,CAtSuC,SAsSjB,EAAA,GAAA,CAAA,EAAA,CAAA,CAAA,SAAA,EApSZ,UAoSY,EAAA,QAAA,EAAA;;;;IA9RtB,QAAQ;;;;;;;;iBAiJW,2CAA2C,eAAe,yBACnE,aACV,QAAQ;;;;;;;;;;;iBAyIK,6BAAA,QACP,6BACN"}
+{"version":3,"file":"generation-engine.d.ts","names":[],"sources":["../../src/migration-engine/generation-engine.ts"],"sourcesContent":[],"mappings":";;;;;UAeiB,sBAAA;;EAAA,IAAA,EAAA,MAAA;EAMA,SAAA,EAAA,MAAA;AASjB;AAOsB,UAhBL,wBAAA,CAgB+B;EAEN,MAAA,EAAA,MAAA;EAAf,IAAA,EAAA,MAAA;EAEd,SAAA,EAAA,MAAA;EAMF,WAAA,EAAA,MAAA;EAAR,SAAA,EAAA,MAAA;EAAO,iBAAA,CAAA,EApBY,iBAoBZ;AA8KV;AAAgF,UA/L/D,sBAAA,CA+L+D;EAAf,SAAA,EAAA,MAAA;EACpD,UAAA,EAAA,OAAA;EACF,WAAA,EAAA,MAAA;EAAR,SAAA,EAAA,MAAA;;AA0Ja,iBApVM,0BAqVb,CAAA,yBAnVkB,cAoVxB,CApVuC,SAoVjB,EAAA,GAAA,CAAA,EAAA,CAAA,CAAA,SAAA,EAlVZ,UAkVY,EAAA,QAAA,EAAA;;;;IA5UtB,QAAQ;;;;;;;;iBA8KW,2CAA2C,eAAe,yBACnE,aACV,QAAQ;;;;;;;;;;;iBA0JK,6BAAA,QACP,6BACN"}