@fragno-dev/db 0.2.1 → 0.3.0

package/dist/migration-engine/auto-from-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto-from-schema.js","names":["migrationOperations: MigrationOperation[]","columns: ColumnInfo[]"],"sources":["../../src/migration-engine/auto-from-schema.ts"],"sourcesContent":["import { type AnySchema } from \"../schema/create\";\nimport type { MigrationOperation, ColumnInfo } from \"./shared\";\n\n/**\n * Generate migration operations from a schema's operation history\n *\n * The schema version number represents the cumulative number of operations applied.\n * This function takes operations from the schema between fromVersion and toVersion,\n * and converts them into migration operations.\n *\n * @param targetSchema - The schema containing the operations history\n * @param fromVersion - The current database version (e.g., 0)\n * @param toVersion - The target version to migrate to (e.g., 5)\n * @param options - Migration generation options\n * @returns Array of migration operations to apply\n *\n * @example\n * ```ts\n * const mySchema = schema(s => s\n *   .addTable(\"users\", t => t.addColumn(\"id\", idColumn()))       // version 1\n *   .addTable(\"posts\", t => t.addColumn(\"id\", idColumn()))       // version 2\n * );\n *\n * // Generate operations from version 0 to 1 (only creates users table)\n * const operations = generateMigrationFromSchema(mySchema, 0, 1);\n * ```\n */\nexport function generateMigrationFromSchema(\n  targetSchema: AnySchema,\n  fromVersion: number,\n  toVersion: number,\n): MigrationOperation[] {\n  if (fromVersion < 0) {\n    throw new Error(`fromVersion cannot be negative: ${fromVersion}`);\n  }\n\n  if (fromVersion > targetSchema.version) {\n    throw new Error(\n      `fromVersion (${fromVersion}) exceeds schema version (${targetSchema.version})`,\n    );\n  }\n\n  if (toVersion > targetSchema.version) {\n    throw new Error(`toVersion (${toVersion}) exceeds schema version (${targetSchema.version})`);\n  }\n\n  if (toVersion < fromVersion) {\n    throw new Error(\n      `Cannot migrate backwards: toVersion (${toVersion}) < fromVersion (${fromVersion})`,\n    );\n  }\n\n  // Get operations between fromVersion and toVersion\n  // Operations are 1-indexed (operation 0 is version 0→1)\n  const relevantOperations = targetSchema.operations.slice(fromVersion, toVersion);\n\n  // Convert schema operations to migration operations\n  const migrationOperations: MigrationOperation[] = [];\n\n  for (const op of relevantOperations) {\n    if (op.type === \"add-table\") {\n      // Collect columns for create-table operation\n      const columns: ColumnInfo[] = [];\n\n      for (const subOp of op.operations) {\n        if (subOp.type === \"add-column\") {\n          const col = subOp.column;\n          columns.push({\n            name: subOp.columnName,\n            type: col.type,\n            isNullable: col.isNullable,\n            role: col.role,\n            default: col.default\n              ? \"value\" in col.default\n                ? { value: col.default.value }\n                : \"dbSpecial\" in col.default\n                  ? { dbSpecial: col.default.dbSpecial }\n                  : \"runtime\" in col.default && typeof col.default.runtime === \"string\"\n                    ? { runtime: col.default.runtime }\n                    : undefined\n              : undefined,\n          });\n        }\n      }\n\n      migrationOperations.push({\n        type: \"create-table\",\n        name: op.tableName,\n        columns,\n      });\n\n      // Add indexes and foreign keys as separate operations\n      for (const subOp of op.operations) {\n        if (subOp.type === \"add-index\") {\n          migrationOperations.push({\n            type: \"add-index\",\n            table: op.tableName,\n            name: subOp.name,\n            columns: subOp.columns,\n            unique: subOp.unique,\n          });\n        } else if (subOp.type === \"add-foreign-key\") {\n          migrationOperations.push({\n            type: \"add-foreign-key\",\n            table: op.tableName,\n            value: {\n              name: subOp.name,\n              columns: subOp.columns,\n              referencedTable: subOp.referencedTable,\n              referencedColumns: subOp.referencedColumns,\n            },\n          });\n        }\n      }\n    } else if (op.type === \"alter-table\") {\n      const columnOps = op.operations.filter((o) => o.type === \"add-column\");\n\n      if (columnOps.length > 0) {\n        migrationOperations.push({\n          type: \"alter-table\",\n          name: op.tableName,\n          value: columnOps.map((o) => {\n            const col = o.column;\n            return {\n              type: \"create-column\" as const,\n              value: {\n                name: o.columnName,\n                type: col.type,\n                isNullable: col.isNullable,\n                role: col.role,\n                default: col.default\n                  ? \"value\" in col.default\n                    ? { value: col.default.value }\n                    : \"dbSpecial\" in col.default\n                      ? { dbSpecial: col.default.dbSpecial }\n                      : \"runtime\" in col.default && typeof col.default.runtime === \"string\"\n                        ? { runtime: col.default.runtime }\n                        : undefined\n                  : undefined,\n              },\n            };\n          }),\n        });\n      }\n\n      // Add indexes as separate operations\n      for (const subOp of op.operations) {\n        if (subOp.type === \"add-index\") {\n          migrationOperations.push({\n            type: \"add-index\",\n            table: op.tableName,\n            name: subOp.name,\n            columns: subOp.columns,\n            unique: subOp.unique,\n          });\n        }\n      }\n    } else if (op.type === \"add-reference\") {\n      migrationOperations.push({\n        type: \"add-foreign-key\",\n        table: op.tableName,\n        value: {\n          name: `${op.tableName}_${op.config.to.table}_${op.referenceName}_fk`,\n          columns: [op.config.from.column],\n          referencedTable: op.config.to.table,\n          referencedColumns: [op.config.to.column],\n        },\n      });\n    }\n  }\n\n  return migrationOperations;\n}\n"],"mappings":"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"}
+{"version":3,"file":"auto-from-schema.js","names":["migrationOperations: MigrationOperation[]","columns: ColumnInfo[]"],"sources":["../../src/migration-engine/auto-from-schema.ts"],"sourcesContent":["import { type AnySchema } from \"../schema/create\";\nimport type { MigrationOperation, ColumnInfo } from \"./shared\";\n\n/**\n * Generate migration operations from a schema's operation history\n *\n * The schema version number represents the cumulative number of operations applied.\n * This function takes operations from the schema between fromVersion and toVersion,\n * and converts them into migration operations.\n *\n * @param targetSchema - The schema containing the operations history\n * @param fromVersion - The current database version (e.g., 0)\n * @param toVersion - The target version to migrate to (e.g., 5)\n * @param options - Migration generation options\n * @returns Array of migration operations to apply\n *\n * @example\n * ```ts\n * const mySchema = schema(\"my\", s => s\n *   .addTable(\"users\", t => t.addColumn(\"id\", idColumn()))       // version 1\n *   .addTable(\"posts\", t => t.addColumn(\"id\", idColumn()))       // version 2\n * );\n *\n * // Generate operations from version 0 to 1 (only creates users table)\n * const operations = generateMigrationFromSchema(mySchema, 0, 1);\n * ```\n */\nexport function generateMigrationFromSchema(\n  targetSchema: AnySchema,\n  fromVersion: number,\n  toVersion: number,\n): MigrationOperation[] {\n  if (fromVersion < 0) {\n    throw new Error(`fromVersion cannot be negative: ${fromVersion}`);\n  }\n\n  if (fromVersion > targetSchema.version) {\n    throw new Error(\n      `fromVersion (${fromVersion}) exceeds schema version (${targetSchema.version})`,\n    );\n  }\n\n  if (toVersion > targetSchema.version) {\n    throw new Error(`toVersion (${toVersion}) exceeds schema version (${targetSchema.version})`);\n  }\n\n  if (toVersion < fromVersion) {\n    throw new Error(\n      `Cannot migrate backwards: toVersion (${toVersion}) < fromVersion (${fromVersion})`,\n    );\n  }\n\n  // Get operations between fromVersion and toVersion\n  // Operations are 1-indexed (operation 0 is version 0→1)\n  const relevantOperations = targetSchema.operations.slice(fromVersion, toVersion);\n\n  // Convert schema operations to migration operations\n  const migrationOperations: MigrationOperation[] = [];\n\n  for (const op of relevantOperations) {\n    if (op.type === \"add-table\") {\n      // Collect columns for create-table operation\n      const columns: ColumnInfo[] = [];\n\n      for (const subOp of op.operations) {\n        if (subOp.type === \"add-column\") {\n          const col = subOp.column;\n          columns.push({\n            name: subOp.columnName,\n            type: col.type,\n            isNullable: col.isNullable,\n            role: col.role,\n            default: col.default\n              ? \"value\" in col.default\n                ? { value: col.default.value }\n                : \"dbSpecial\" in col.default\n                  ? { dbSpecial: col.default.dbSpecial }\n                  : \"runtime\" in col.default && typeof col.default.runtime === \"string\"\n                    ? { runtime: col.default.runtime }\n                    : undefined\n              : undefined,\n          });\n        }\n      }\n\n      migrationOperations.push({\n        type: \"create-table\",\n        name: op.tableName,\n        columns,\n      });\n\n      // Add indexes and foreign keys as separate operations\n      for (const subOp of op.operations) {\n        if (subOp.type === \"add-index\") {\n          migrationOperations.push({\n            type: \"add-index\",\n            table: op.tableName,\n            name: subOp.name,\n            columns: subOp.columns,\n            unique: subOp.unique,\n          });\n        } else if (subOp.type === \"add-foreign-key\") {\n          migrationOperations.push({\n            type: \"add-foreign-key\",\n            table: op.tableName,\n            value: {\n              name: subOp.name,\n              columns: subOp.columns,\n              referencedTable: subOp.referencedTable,\n              referencedColumns: subOp.referencedColumns,\n            },\n          });\n        }\n      }\n    } else if (op.type === \"alter-table\") {\n      const columnOps = op.operations.filter((o) => o.type === \"add-column\");\n\n      if (columnOps.length > 0) {\n        migrationOperations.push({\n          type: \"alter-table\",\n          name: op.tableName,\n          value: columnOps.map((o) => {\n            const col = o.column;\n            return {\n              type: \"create-column\" as const,\n              value: {\n                name: o.columnName,\n                type: col.type,\n                isNullable: col.isNullable,\n                role: col.role,\n                default: col.default\n                  ? \"value\" in col.default\n                    ? { value: col.default.value }\n                    : \"dbSpecial\" in col.default\n                      ? { dbSpecial: col.default.dbSpecial }\n                      : \"runtime\" in col.default && typeof col.default.runtime === \"string\"\n                        ? { runtime: col.default.runtime }\n                        : undefined\n                  : undefined,\n              },\n            };\n          }),\n        });\n      }\n\n      // Add indexes as separate operations\n      for (const subOp of op.operations) {\n        if (subOp.type === \"add-index\") {\n          migrationOperations.push({\n            type: \"add-index\",\n            table: op.tableName,\n            name: subOp.name,\n            columns: subOp.columns,\n            unique: subOp.unique,\n          });\n        }\n      }\n    } else if (op.type === \"add-reference\") {\n      if (!op.referenceName || op.referenceName.trim().length === 0) {\n        throw new Error(`referenceName is required for add-reference on ${op.tableName}`);\n      }\n      migrationOperations.push({\n        type: \"add-foreign-key\",\n        table: op.tableName,\n        value: {\n          name: op.referenceName,\n          columns: [op.config.from.column],\n          referencedTable: op.config.to.table,\n          referencedColumns: [op.config.to.column],\n        },\n      });\n    }\n  }\n\n  return migrationOperations;\n}\n"],"mappings":"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"}

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

@@ -5,26 +5,32 @@ import { FragnoDatabase } from "../mod.js";
 interface GenerationEngineResult {
   schema: string;
   path: string;
-  namespace: string;
+  namespace: string | null;
+}
+type SchemaOutputFormat = "sql" | "drizzle" | "prisma";
+interface GenerateSchemaOptions {
+  format?: SchemaOutputFormat;
+  path?: string;
+  toVersion?: number;
+  fromVersion?: number;
 }
 interface GenerationInternalResult {
   schema: string;
   path: string;
-  namespace: string;
+  namespace: string | null;
+  namespaceKey: string;
+  schemaName: string;
+  isSettings: boolean;
   fromVersion: number;
   toVersion: number;
 }
 interface ExecuteMigrationResult {
-  namespace: string;
+  namespace: string | null;
   didMigrate: boolean;
   fromVersion: number;
   toVersion: number;
 }
-declare function generateMigrationsOrSchema<const TDatabases extends FragnoDatabase<AnySchema, any>[]>(databases: TDatabases, options?: {
-  path?: string;
-  toVersion?: number;
-  fromVersion?: number;
-}): Promise<GenerationEngineResult[]>;
+declare function generateSchemaArtifacts<const TDatabases extends FragnoDatabase<AnySchema, any>[]>(databases: TDatabases, options?: GenerateSchemaOptions): Promise<GenerationEngineResult[]>;
 /**
  * Execute migrations for all fragments in the correct order.
  * Migrates settings table first, then fragments alphabetically.
@@ -36,7 +42,7 @@ declare function executeMigrations<const TDatabases extends FragnoDatabase<AnySc
 /**
  * Post-processes migration files to add ordering and standardize naming.
  *
- * Sorts files with settings namespace first, then alphabetically by namespace,
+ * Sorts files with settings namespace first, then alphabetically by namespace key,
  * and assigns ordering numbers. Transforms filenames to format:
  * `<date>_<n>_f<from>_t<to>_<namespace>.sql`
  *
@@ -45,5 +51,5 @@ declare function executeMigrations<const TDatabases extends FragnoDatabase<AnySc
  */
 declare function postProcessMigrationFilenames(files: GenerationInternalResult[]): GenerationEngineResult[];
 //#endregion
-export { ExecuteMigrationResult, GenerationEngineResult, GenerationInternalResult, executeMigrations, generateMigrationsOrSchema, postProcessMigrationFilenames };
+export { ExecuteMigrationResult, GenerateSchemaOptions, GenerationEngineResult, GenerationInternalResult, SchemaOutputFormat, executeMigrations, generateSchemaArtifacts, postProcessMigrationFilenames };
 //# sourceMappingURL=generation-engine.d.ts.map

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":";;;;UAciB,sBAAA;;EAAA,IAAA,EAAA,MAAA;EAMA,SAAA,EAAA,MAAA;AAQjB;AAOsB,UAfL,wBAAA,CAe+B;EAEN,MAAA,EAAA,MAAA;EAAf,IAAA,EAAA,MAAA;EAEd,SAAA,EAAA,MAAA;EAMF,WAAA,EAAA,MAAA;EAAR,SAAA,EAAA,MAAA;;AA2ImB,UA5JL,sBAAA,CA4JsB;EAAyC,SAAA,EAAA,MAAA;EAAf,UAAA,EAAA,OAAA;EACpD,WAAA,EAAA,MAAA;EACF,SAAA,EAAA,MAAA;;AAAD,iBAvJY,0BAuJZ,CAAA,yBArJiB,cAqJjB,CArJgC,SAqJhC,EAAA,GAAA,CAAA,EAAA,CAAA,CAAA,SAAA,EAnJG,UAmJH,EAAA,QAAA,EAAA;EAiJM,IAAA,CAAA,EAAA,MAAA;;;IA9Rb,QAAQ;;;;;;;;iBA2IW,2CAA2C,eAAe,yBACnE,aACV,QAAQ;;;;;;;;;;;iBAiJK,6BAAA,QACP,6BACN"}
+{"version":3,"file":"generation-engine.d.ts","names":[],"sources":["../../src/migration-engine/generation-engine.ts"],"sourcesContent":[],"mappings":";;;;UAaiB,sBAAA;;EAAA,IAAA,EAAA,MAAA;EAML,SAAA,EAAA,MAAA,GAAA,IAAkB;AAE9B;AAOiB,KATL,kBAAA,GAS6B,KAAA,GAAA,SAAA,GAAA,QAAA;AAWxB,UAlBA,qBAAA,CAkBsB;EAajB,MAAA,CAAA,EA9BX,kBA8BkC;EAEH,IAAA,CAAA,EAAA,MAAA;EAAf,SAAA,CAAA,EAAA,MAAA;EACd,WAAA,CAAA,EAAA,MAAA;;AAAsD,UA3BlD,wBAAA,CA2BkD;EAAR,MAAA,EAAA,MAAA;EAAO,IAAA,EAAA,MAAA;EA4J5C,SAAA,EAAA,MAAA,GAAiB,IAAA;EAAyC,YAAA,EAAA,MAAA;EAAf,UAAA,EAAA,MAAA;EACpD,UAAA,EAAA,OAAA;EACF,WAAA,EAAA,MAAA;EAAR,SAAA,EAAA,MAAA;;AAwJa,UAtUC,sBAAA,CAsU4B;;;;;;iBAzTvB,iDAEK,eAAe,8BAC7B,sBAAsB,wBAAwB,QAAQ;;;;;;;;iBA4J7C,2CAA2C,eAAe,yBACnE,aACV,QAAQ;;;;;;;;;;;iBAwJK,6BAAA,QACP,6BACN"}

package/dist/migration-engine/generation-engine.js

@@ -1,32 +1,53 @@
 import { instantiate } from "../packages/fragno/dist/api/fragment-instantiator.js";
-import { SETTINGS_NAMESPACE, getSchemaVersionFromDatabase, internalFragmentDef, internalSchema } from "../fragments/internal-fragment.js";
 import { fragnoDatabaseAdapterNameFakeSymbol, fragnoDatabaseAdapterVersionFakeSymbol } from "../adapters/adapters.js";
+import { SETTINGS_TABLE_NAME, internalSchema } from "../fragments/internal-fragment.schema.js";
+import { supportedDatabases } from "../adapters/generic-sql/driver-config.js";
+import { getSchemaVersionFromDatabase, internalFragmentDef } from "../fragments/internal-fragment.js";
+import { generateDrizzleSchema } from "../schema-output/drizzle.js";
+import { generatePrismaSchema } from "../schema-output/prisma.js";
 
 //#region src/migration-engine/generation-engine.ts
-async function generateMigrationsOrSchema(databases, options) {
+const DEFAULT_DRIZZLE_PATH = "fragno-schema.ts";
+const DEFAULT_PRISMA_PATH = "fragno.prisma";
+const isSupportedDatabase = (value) => supportedDatabases.includes(value);
+async function generateSchemaArtifacts(databases, options) {
 	if (databases.length === 0) throw new Error("No databases provided for schema generation");
 	const firstDb = databases[0];
 	const adapter = firstDb.adapter;
-	if (adapter.createSchemaGenerator) {
-		if (options?.toVersion !== void 0 || options?.fromVersion !== void 0) console.warn("⚠️ Warning: --from and --to version options are not supported when generating schemas for multiple fragments and will be ignored.");
+	const format = options?.format ?? "sql";
+	if (format !== "sql") {
+		if (options?.toVersion !== void 0 || options?.fromVersion !== void 0) throw new Error("--from and --to are only supported when generating SQL migrations.");
+		const databaseType = adapter.adapterMetadata?.databaseType;
+		if (!databaseType || !isSupportedDatabase(databaseType)) throw new Error("Adapter does not expose databaseType metadata required for schema output generation.");
 		const fragmentsMap = /* @__PURE__ */ new Map();
-		fragmentsMap.set("", {
+		fragmentsMap.set(internalSchema.name, {
 			schema: internalSchema,
-			namespace: ""
-		});
-		for (const db of databases) if (!fragmentsMap.has(db.namespace)) fragmentsMap.set(db.namespace, {
-			schema: db.schema,
-			namespace: db.namespace
+			namespace: null
 		});
+		for (const db of databases) {
+			const namespaceKey = db.namespace ?? db.schema.name;
+			if (!fragmentsMap.has(namespaceKey)) fragmentsMap.set(namespaceKey, {
+				schema: db.schema,
+				namespace: db.namespace
+			});
+		}
 		const allFragments = Array.from(fragmentsMap.values());
+		const defaultPath = format === "drizzle" ? DEFAULT_DRIZZLE_PATH : DEFAULT_PRISMA_PATH;
 		return [{
-			...adapter.createSchemaGenerator(allFragments, { path: options?.path }).generateSchema(),
+			schema: format === "drizzle" ? generateDrizzleSchema(allFragments, databaseType, { namingStrategy: adapter.namingStrategy }) : generatePrismaSchema(allFragments, databaseType, {
+				sqliteStorageMode: adapter.adapterMetadata?.sqliteStorageMode,
+				namingStrategy: adapter.namingStrategy
+			}),
+			path: options?.path ?? defaultPath,
 			namespace: firstDb.namespace
 		}];
 	}
-	if (!adapter.prepareMigrations) throw new Error("Adapter does not support migration-based schema generation. Ensure your adapter implements prepareMigrations.");
+	if (!adapter.prepareMigrations) throw new Error("Adapter does not support migration generation. Ensure your adapter implements prepareMigrations.");
 	if (!await adapter.isConnectionHealthy()) throw new Error("Database connection is not healthy. Please check your database connection and try again.");
-	const settingsSourceVersion = await getSchemaVersionFromDatabase(instantiate(internalFragmentDef).withConfig({}).withOptions({ databaseAdapter: adapter }).build(), SETTINGS_NAMESPACE);
+	const settingsSourceVersion = await getSchemaVersionFromDatabase(instantiate(internalFragmentDef).withConfig({}).withOptions({
+		databaseAdapter: adapter,
+		databaseNamespace: null
+	}).build(), "");
 	const generatedFiles = [];
 	const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, "");
 	const settingsTargetVersion = internalSchema.version;
@@ -34,13 +55,16 @@ async function generateMigrationsOrSchema(databases, options) {
 	if (settingsSql.trim()) generatedFiles.push({
 		schema: settingsSql,
 		path: "settings-migration.sql",
-		namespace: "",
+		namespace: null,
+		namespaceKey: SETTINGS_TABLE_NAME,
+		schemaName: internalSchema.name,
+		isSettings: true,
 		fromVersion: settingsSourceVersion,
 		toVersion: settingsTargetVersion
 	});
 	for (const db of databases) {
 		const dbAdapter = db.adapter;
-		if (!dbAdapter.prepareMigrations) throw new Error(`Adapter for ${db.namespace} does not support schema generation. Ensure your adapter implements either createSchemaGenerator or prepareMigrations.`);
+		if (!dbAdapter.prepareMigrations) throw new Error(`Adapter for ${db.namespace ?? db.schema.name} does not support migration generation. Ensure your adapter implements prepareMigrations.`);
 		const preparedMigrations = dbAdapter.prepareMigrations(db.schema, db.namespace);
 		const targetVersion = options?.toVersion ?? db.schema.version;
 		const sourceVersion = options?.fromVersion ?? 0;
@@ -49,6 +73,9 @@ async function generateMigrationsOrSchema(databases, options) {
 			schema: sql,
 			path: "schema.sql",
 			namespace: db.namespace,
+			namespaceKey: db.namespace ?? db.schema.name,
+			schemaName: db.schema.name,
+			isSettings: false,
 			fromVersion: sourceVersion,
 			toVersion: targetVersion
 		});
@@ -65,7 +92,7 @@ async function generateMigrationsOrSchema(databases, options) {
 async function executeMigrations(databases) {
 	if (databases.length === 0) throw new Error("No databases provided for migration");
 	const adapter = databases[0].adapter;
-	if (!adapter.prepareMigrations) throw new Error("Adapter does not support running migrations. The adapter only supports schema generation.\nTry using 'generateMigrationsOrSchema' instead to generate schema files.");
+	if (!adapter.prepareMigrations) throw new Error("Adapter does not support running migrations. The adapter only supports schema generation.\nTry using 'generateSchemaArtifacts' instead to generate schema files.");
 	const firstAdapterName = adapter[fragnoDatabaseAdapterNameFakeSymbol];
 	const firstAdapterVersion = adapter[fragnoDatabaseAdapterVersionFakeSymbol];
 	for (const db of databases) {
@@ -76,32 +103,40 @@ async function executeMigrations(databases) {
 	if (!await adapter.isConnectionHealthy()) throw new Error("Database connection is not healthy. Please check your database connection and try again.");
 	const results = [];
 	const migrationsToExecute = [];
-	const internalFragment = instantiate(internalFragmentDef).withConfig({}).withOptions({ databaseAdapter: adapter }).build();
-	const settingsSourceVersion = await getSchemaVersionFromDatabase(internalFragment, SETTINGS_NAMESPACE);
+	const internalFragment = instantiate(internalFragmentDef).withConfig({}).withOptions({
+		databaseAdapter: adapter,
+		databaseNamespace: null
+	}).build();
+	const settingsSourceVersion = await getSchemaVersionFromDatabase(internalFragment, "");
 	const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, "");
 	const settingsTargetVersion = internalSchema.version;
 	if (settingsSourceVersion < settingsTargetVersion) {
 		if (settingsPreparedMigrations.compile(settingsSourceVersion, settingsTargetVersion, { updateVersionInMigration: true }).statements.length > 0) migrationsToExecute.push({
-			namespace: "",
+			namespace: null,
+			namespaceKey: SETTINGS_TABLE_NAME,
 			fromVersion: settingsSourceVersion,
 			toVersion: settingsTargetVersion,
 			execute: () => settingsPreparedMigrations.execute(settingsSourceVersion, settingsTargetVersion, { updateVersionInMigration: true })
 		});
 	}
-	const sortedDatabases = [...databases].sort((a, b) => a.namespace.localeCompare(b.namespace));
+	const getNamespaceKey = (db) => db.namespace ?? db.schema.name;
+	const sortedDatabases = [...databases].sort((a, b) => getNamespaceKey(a).localeCompare(getNamespaceKey(b)));
 	for (const fragnoDb of sortedDatabases) {
+		const namespaceKey = getNamespaceKey(fragnoDb);
 		const preparedMigrations = adapter.prepareMigrations(fragnoDb.schema, fragnoDb.namespace);
-		const currentVersion = await getSchemaVersionFromDatabase(internalFragment, fragnoDb.namespace);
+		const currentVersion = await getSchemaVersionFromDatabase(internalFragment, namespaceKey);
 		const targetVersion = fragnoDb.schema.version;
 		if (currentVersion < targetVersion) {
 			if (preparedMigrations.compile(currentVersion, targetVersion, { updateVersionInMigration: true }).statements.length > 0) migrationsToExecute.push({
 				namespace: fragnoDb.namespace,
+				namespaceKey,
 				fromVersion: currentVersion,
 				toVersion: targetVersion,
 				execute: () => preparedMigrations.execute(currentVersion, targetVersion, { updateVersionInMigration: true })
 			});
 		}
 	}
+	const executedNamespaceKeys = /* @__PURE__ */ new Set();
 	for (const migration of migrationsToExecute) {
 		await migration.execute();
 		results.push({
@@ -110,19 +145,23 @@ async function executeMigrations(databases) {
 			fromVersion: migration.fromVersion,
 			toVersion: migration.toVersion
 		});
+		executedNamespaceKeys.add(migration.namespaceKey);
+	}
+	for (const fragnoDb of databases) {
+		const namespaceKey = getNamespaceKey(fragnoDb);
+		if (!executedNamespaceKeys.has(namespaceKey)) results.push({
+			namespace: fragnoDb.namespace,
+			didMigrate: false,
+			fromVersion: fragnoDb.schema.version,
+			toVersion: fragnoDb.schema.version
+		});
 	}
-	for (const fragnoDb of databases) if (!results.find((r) => r.namespace === fragnoDb.namespace)) results.push({
-		namespace: fragnoDb.namespace,
-		didMigrate: false,
-		fromVersion: fragnoDb.schema.version,
-		toVersion: fragnoDb.schema.version
-	});
 	return results;
 }
 /**
 * Post-processes migration files to add ordering and standardize naming.
 *
-* Sorts files with settings namespace first, then alphabetically by namespace,
+* Sorts files with settings namespace first, then alphabetically by namespace key,
 * and assigns ordering numbers. Transforms filenames to format:
 * `<date>_<n>_f<from>_t<to>_<namespace>.sql`
 *
@@ -132,15 +171,15 @@ async function executeMigrations(databases) {
 function postProcessMigrationFilenames(files) {
 	if (files.length === 0) return [];
 	const sortedFiles = [...files].sort((a, b) => {
-		if (a.namespace === "") return -1;
-		if (b.namespace === "") return 1;
-		return a.namespace.localeCompare(b.namespace);
+		if (a.isSettings) return -1;
+		if (b.isSettings) return 1;
+		return a.namespaceKey.localeCompare(b.namespaceKey);
 	});
 	const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0].replace(/-/g, "");
 	return sortedFiles.map((file, index) => {
 		const fromVersion = file.fromVersion ?? 0;
 		const toVersion = file.toVersion ?? 0;
-		const newPath = `${date}_${(index + 1).toString().padStart(3, "0")}_f${fromVersion.toString().padStart(3, "0")}_t${toVersion.toString().padStart(3, "0")}_${file.namespace === "" ? "fragno_db_settings" : file.namespace.replace(/[^a-z0-9-]/gi, "_")}.sql`;
+		const newPath = `${date}_${(index + 1).toString().padStart(3, "0")}_f${fromVersion.toString().padStart(3, "0")}_t${toVersion.toString().padStart(3, "0")}_${file.namespaceKey.replace(/[^a-z0-9-]/gi, "_")}.sql`;
 		return {
 			schema: file.schema,
 			path: newPath,
@@ -150,5 +189,5 @@ function postProcessMigrationFilenames(files) {
 }
 
 //#endregion
-export { executeMigrations, generateMigrationsOrSchema, postProcessMigrationFilenames };
+export { executeMigrations, generateSchemaArtifacts, postProcessMigrationFilenames };
 //# sourceMappingURL=generation-engine.js.map

package/dist/migration-engine/generation-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"generation-engine.js","names":["generatedFiles: GenerationInternalResult[]","results: ExecuteMigrationResult[]","migrationsToExecute: Array<{\n    namespace: string;\n    fromVersion: number;\n    toVersion: number;\n    execute: () => Promise<void>;\n  }>"],"sources":["../../src/migration-engine/generation-engine.ts"],"sourcesContent":["import type { FragnoDatabase } from \"../mod\";\nimport type { AnySchema } from \"../schema/create\";\nimport {\n  fragnoDatabaseAdapterNameFakeSymbol,\n  fragnoDatabaseAdapterVersionFakeSymbol,\n} from \"../adapters/adapters\";\nimport {\n  internalFragmentDef,\n  internalSchema,\n  SETTINGS_NAMESPACE,\n  getSchemaVersionFromDatabase,\n} from \"../fragments/internal-fragment\";\nimport { instantiate } from \"@fragno-dev/core\";\n\nexport interface GenerationEngineResult {\n  schema: string;\n  path: string;\n  namespace: string;\n}\n\nexport interface GenerationInternalResult {\n  schema: string;\n  path: string;\n  namespace: string;\n  fromVersion: number;\n  toVersion: number;\n}\n\nexport interface ExecuteMigrationResult {\n  namespace: string;\n  didMigrate: boolean;\n  fromVersion: number;\n  toVersion: number;\n}\n\nexport async function generateMigrationsOrSchema<\n  // oxlint-disable-next-line no-explicit-any\n  const TDatabases extends FragnoDatabase<AnySchema, any>[],\n>(\n  databases: TDatabases,\n  options?: {\n    path?: string;\n    toVersion?: number;\n    fromVersion?: number;\n  },\n): Promise<GenerationEngineResult[]> {\n  if (databases.length === 0) {\n    throw new Error(\"No databases provided for schema generation\");\n  }\n\n  const firstDb = databases[0];\n  const adapter = firstDb.adapter;\n\n  // If adapter has createSchemaGenerator, use it for combined generation (e.g., Drizzle)\n  if (adapter.createSchemaGenerator) {\n    if (options?.toVersion !== undefined || options?.fromVersion !== undefined) {\n      console.warn(\n        \"⚠️ Warning: --from and --to version options are not supported when generating schemas for multiple fragments and will be ignored.\",\n      );\n    }\n\n    // Collect all schemas, de-duplicating by namespace.\n    // The internal fragment (settings schema) is always included first since all database\n    // fragments automatically link to it via withDatabase().\n    const fragmentsMap = new Map<string, { schema: AnySchema; namespace: string }>();\n\n    // Include internal fragment first with empty namespace (settings table has no prefix)\n    fragmentsMap.set(\"\", {\n      schema: internalSchema,\n      namespace: \"\",\n    });\n\n    // Add user fragments, de-duplicating by namespace\n    // Each FragnoDatabase has a unique namespace, so this prevents duplicate schema generation\n    for (const db of databases) {\n      if (!fragmentsMap.has(db.namespace)) {\n        fragmentsMap.set(db.namespace, {\n          schema: db.schema,\n          namespace: db.namespace,\n        });\n      }\n    }\n\n    const allFragments = Array.from(fragmentsMap.values());\n    const generator = adapter.createSchemaGenerator(allFragments, {\n      path: options?.path,\n    });\n\n    return [\n      {\n        ...generator.generateSchema(),\n        namespace: firstDb.namespace,\n      },\n    ];\n  }\n\n  // Otherwise, use migration engine for individual generation (e.g., Kysely, GenericSQL)\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Adapter does not support migration-based schema generation. Ensure your adapter implements prepareMigrations.\",\n    );\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  // Use the internal fragment for settings management\n  const internalFragment = instantiate(internalFragmentDef)\n    .withConfig({})\n    .withOptions({ databaseAdapter: adapter })\n    .build();\n\n  const settingsSourceVersion = await getSchemaVersionFromDatabase(\n    internalFragment,\n    SETTINGS_NAMESPACE,\n  );\n\n  const generatedFiles: GenerationInternalResult[] = [];\n\n  // Use empty namespace for settings (SETTINGS_NAMESPACE is for prefixing keys, not the database namespace)\n  const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, \"\");\n  const settingsTargetVersion = internalSchema.version;\n\n  // Generate settings table migration\n  const settingsSql = settingsPreparedMigrations.getSQL(\n    settingsSourceVersion,\n    settingsTargetVersion,\n  );\n\n  if (settingsSql.trim()) {\n    generatedFiles.push({\n      schema: settingsSql,\n      path: \"settings-migration.sql\", // Placeholder, will be renamed in post-processing\n      namespace: \"\", // Empty namespace for settings table\n      fromVersion: settingsSourceVersion,\n      toVersion: settingsTargetVersion,\n    });\n  }\n\n  // Generate migration for each fragment\n  for (const db of databases) {\n    const dbAdapter = db.adapter;\n\n    // Use migration engine\n    if (!dbAdapter.prepareMigrations) {\n      throw new Error(\n        `Adapter for ${db.namespace} does not support schema generation. ` +\n          `Ensure your adapter implements either createSchemaGenerator or prepareMigrations.`,\n      );\n    }\n\n    const preparedMigrations = dbAdapter.prepareMigrations(db.schema, db.namespace);\n    const targetVersion = options?.toVersion ?? db.schema.version;\n    const sourceVersion = options?.fromVersion ?? 0;\n\n    // Generate migration from source to target version\n    const sql = preparedMigrations.getSQL(sourceVersion, targetVersion);\n\n    // If no migrations needed, skip this fragment\n    if (sql.trim()) {\n      generatedFiles.push({\n        schema: sql,\n        path: \"schema.sql\", // Placeholder, will be renamed in post-processing\n        namespace: db.namespace,\n        fromVersion: sourceVersion,\n        toVersion: targetVersion,\n      });\n    }\n  }\n\n  // Post-process filenames with ordering\n  return postProcessMigrationFilenames(generatedFiles);\n}\n\n/**\n * Execute migrations for all fragments in the correct order.\n * Migrates settings table first, then fragments alphabetically.\n *\n * @param databases - Array of FragnoDatabase instances to migrate\n * @returns Array of execution results for each migration\n */\nexport async function executeMigrations<const TDatabases extends FragnoDatabase<AnySchema>[]>(\n  databases: TDatabases,\n): Promise<ExecuteMigrationResult[]> {\n  if (databases.length === 0) {\n    throw new Error(\"No databases provided for migration\");\n  }\n\n  const firstDb = databases[0];\n  const adapter = firstDb.adapter;\n\n  // Validate adapter supports migrations\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Adapter does not support running migrations. The adapter only supports schema generation.\\n\" +\n        \"Try using 'generateMigrationsOrSchema' instead to generate schema files.\",\n    );\n  }\n\n  // Validate all use same adapter name and version\n  const firstAdapterName = adapter[fragnoDatabaseAdapterNameFakeSymbol];\n  const firstAdapterVersion = adapter[fragnoDatabaseAdapterVersionFakeSymbol];\n\n  for (const db of databases) {\n    const dbAdapterName = db.adapter[fragnoDatabaseAdapterNameFakeSymbol];\n    const dbAdapterVersion = db.adapter[fragnoDatabaseAdapterVersionFakeSymbol];\n\n    if (dbAdapterName !== firstAdapterName || dbAdapterVersion !== firstAdapterVersion) {\n      throw new Error(\n        `All fragments must use the same database adapter. ` +\n          `Found: ${firstAdapterName}@${firstAdapterVersion} and ${dbAdapterName}@${dbAdapterVersion}`,\n      );\n    }\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  const results: ExecuteMigrationResult[] = [];\n  const migrationsToExecute: Array<{\n    namespace: string;\n    fromVersion: number;\n    toVersion: number;\n    execute: () => Promise<void>;\n  }> = [];\n\n  // 1. Prepare settings table migration\n  // Use the internal fragment for settings management\n  const internalFragment = instantiate(internalFragmentDef)\n    .withConfig({})\n    .withOptions({ databaseAdapter: adapter })\n    .build();\n\n  const settingsSourceVersion = await getSchemaVersionFromDatabase(\n    internalFragment,\n    SETTINGS_NAMESPACE,\n  );\n\n  // Use empty namespace for settings (SETTINGS_NAMESPACE is for prefixing keys, not the database namespace)\n  const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, \"\");\n  const settingsTargetVersion = internalSchema.version;\n\n  if (settingsSourceVersion < settingsTargetVersion) {\n    const compiledMigration = settingsPreparedMigrations.compile(\n      settingsSourceVersion,\n      settingsTargetVersion,\n      { updateVersionInMigration: true },\n    );\n\n    if (compiledMigration.statements.length > 0) {\n      migrationsToExecute.push({\n        namespace: \"\", // Empty namespace for settings table\n        fromVersion: settingsSourceVersion,\n        toVersion: settingsTargetVersion,\n        execute: () =>\n          settingsPreparedMigrations.execute(settingsSourceVersion, settingsTargetVersion, {\n            updateVersionInMigration: true,\n          }),\n      });\n    }\n  }\n\n  // 2. Prepare fragment migrations (sorted alphabetically)\n  const sortedDatabases = [...databases].sort((a, b) => a.namespace.localeCompare(b.namespace));\n\n  for (const fragnoDb of sortedDatabases) {\n    const preparedMigrations = adapter.prepareMigrations(fragnoDb.schema, fragnoDb.namespace);\n    const currentVersion = await getSchemaVersionFromDatabase(internalFragment, fragnoDb.namespace);\n    const targetVersion = fragnoDb.schema.version;\n\n    if (currentVersion < targetVersion) {\n      const compiledMigration = preparedMigrations.compile(currentVersion, targetVersion, {\n        updateVersionInMigration: true,\n      });\n\n      if (compiledMigration.statements.length > 0) {\n        migrationsToExecute.push({\n          namespace: fragnoDb.namespace,\n          fromVersion: currentVersion,\n          toVersion: targetVersion,\n          execute: () =>\n            preparedMigrations.execute(currentVersion, targetVersion, {\n              updateVersionInMigration: true,\n            }),\n        });\n      }\n    }\n  }\n\n  // 3. Execute all migrations in order\n  for (const migration of migrationsToExecute) {\n    await migration.execute();\n    results.push({\n      namespace: migration.namespace,\n      didMigrate: true,\n      fromVersion: migration.fromVersion,\n      toVersion: migration.toVersion,\n    });\n  }\n\n  // 4. Add skipped migrations (already up-to-date)\n  for (const fragnoDb of databases) {\n    if (!results.find((r) => r.namespace === fragnoDb.namespace)) {\n      results.push({\n        namespace: fragnoDb.namespace,\n        didMigrate: false,\n        fromVersion: fragnoDb.schema.version,\n        toVersion: fragnoDb.schema.version,\n      });\n    }\n  }\n\n  return results;\n}\n\n/**\n * Post-processes migration files to add ordering and standardize naming.\n *\n * Sorts files with settings namespace first, then alphabetically by namespace,\n * and assigns ordering numbers. Transforms filenames to format:\n * `<date>_<n>_f<from>_t<to>_<namespace>.sql`\n *\n * @param files - Array of generated migration files with version information\n * @returns Array of files with standardized paths and ordering\n */\nexport function postProcessMigrationFilenames(\n  files: GenerationInternalResult[],\n): GenerationEngineResult[] {\n  if (files.length === 0) {\n    return [];\n  }\n\n  // Sort files: settings namespace first (empty string), then alphabetically by namespace\n  const sortedFiles = [...files].sort((a, b) => {\n    // Settings table has empty namespace - sort it first\n    if (a.namespace === \"\") {\n      return -1;\n    }\n    if (b.namespace === \"\") {\n      return 1;\n    }\n    return a.namespace.localeCompare(b.namespace);\n  });\n\n  // Generate date prefix for filenames\n  const date = new Date().toISOString().split(\"T\")[0].replace(/-/g, \"\");\n\n  // Rename files with ordering\n  return sortedFiles.map((file, index) => {\n    const fromVersion = file.fromVersion ?? 0;\n    const toVersion = file.toVersion ?? 0;\n\n    // Create new filename with ordering\n    const orderNum = (index + 1).toString().padStart(3, \"0\");\n    const fromPadded = fromVersion.toString().padStart(3, \"0\");\n    const toPadded = toVersion.toString().padStart(3, \"0\");\n\n    // For settings table (empty namespace), use \"fragno_db_settings\" in the filename\n    // For other tables, use their namespace\n    const safeName =\n      file.namespace === \"\" ? \"fragno_db_settings\" : file.namespace.replace(/[^a-z0-9-]/gi, \"_\");\n    const newPath = `${date}_${orderNum}_f${fromPadded}_t${toPadded}_${safeName}.sql`;\n\n    return {\n      schema: file.schema,\n      path: newPath,\n      namespace: file.namespace,\n    };\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"generation-engine.js","names":["generatedFiles: GenerationInternalResult[]","results: ExecuteMigrationResult[]","migrationsToExecute: Array<{\n    namespace: string | null;\n    namespaceKey: string;\n    fromVersion: number;\n    toVersion: number;\n    execute: () => Promise<void>;\n  }>"],"sources":["../../src/migration-engine/generation-engine.ts"],"sourcesContent":["import type { FragnoDatabase } from \"../mod\";\nimport type { AnySchema } from \"../schema/create\";\nimport {\n  fragnoDatabaseAdapterNameFakeSymbol,\n  fragnoDatabaseAdapterVersionFakeSymbol,\n} from \"../adapters/adapters\";\nimport { generateDrizzleSchema } from \"../schema-output/drizzle\";\nimport { generatePrismaSchema } from \"../schema-output/prisma\";\nimport { internalFragmentDef, getSchemaVersionFromDatabase } from \"../fragments/internal-fragment\";\nimport { internalSchema, SETTINGS_TABLE_NAME } from \"../fragments/internal-fragment.schema\";\nimport { instantiate } from \"@fragno-dev/core\";\nimport { supportedDatabases, type SupportedDatabase } from \"../adapters/generic-sql/driver-config\";\n\nexport interface GenerationEngineResult {\n  schema: string;\n  path: string;\n  namespace: string | null;\n}\n\nexport type SchemaOutputFormat = \"sql\" | \"drizzle\" | \"prisma\";\n\nexport interface GenerateSchemaOptions {\n  format?: SchemaOutputFormat;\n  path?: string;\n  toVersion?: number;\n  fromVersion?: number;\n}\n\nexport interface GenerationInternalResult {\n  schema: string;\n  path: string;\n  namespace: string | null;\n  namespaceKey: string;\n  schemaName: string;\n  isSettings: boolean;\n  fromVersion: number;\n  toVersion: number;\n}\n\nexport interface ExecuteMigrationResult {\n  namespace: string | null;\n  didMigrate: boolean;\n  fromVersion: number;\n  toVersion: number;\n}\n\nconst DEFAULT_DRIZZLE_PATH = \"fragno-schema.ts\";\nconst DEFAULT_PRISMA_PATH = \"fragno.prisma\";\n\nconst isSupportedDatabase = (value: string): value is SupportedDatabase =>\n  supportedDatabases.includes(value as SupportedDatabase);\n\nexport async function generateSchemaArtifacts<\n  // oxlint-disable-next-line no-explicit-any\n  const TDatabases extends FragnoDatabase<AnySchema, any>[],\n>(databases: TDatabases, options?: GenerateSchemaOptions): Promise<GenerationEngineResult[]> {\n  if (databases.length === 0) {\n    throw new Error(\"No databases provided for schema generation\");\n  }\n\n  const firstDb = databases[0];\n  const adapter = firstDb.adapter;\n  const format = options?.format ?? \"sql\";\n\n  if (format !== \"sql\") {\n    if (options?.toVersion !== undefined || options?.fromVersion !== undefined) {\n      throw new Error(\"--from and --to are only supported when generating SQL migrations.\");\n    }\n\n    const databaseType = adapter.adapterMetadata?.databaseType;\n    if (!databaseType || !isSupportedDatabase(databaseType)) {\n      throw new Error(\n        \"Adapter does not expose databaseType metadata required for schema output generation.\",\n      );\n    }\n\n    // Collect all schemas, de-duplicating by namespace.\n    // The internal fragment (settings schema) is always included first since all database\n    // fragments automatically link to it via withDatabase().\n    const fragmentsMap = new Map<string, { schema: AnySchema; namespace: string | null }>();\n\n    // Include internal fragment first with empty namespace (settings table has no prefix)\n    fragmentsMap.set(internalSchema.name, {\n      schema: internalSchema,\n      namespace: null,\n    });\n\n    // Add user fragments, de-duplicating by namespace\n    // Each FragnoDatabase has a unique namespace, so this prevents duplicate schema generation\n    for (const db of databases) {\n      const namespaceKey = db.namespace ?? db.schema.name;\n      if (!fragmentsMap.has(namespaceKey)) {\n        fragmentsMap.set(namespaceKey, {\n          schema: db.schema,\n          namespace: db.namespace,\n        });\n      }\n    }\n\n    const allFragments = Array.from(fragmentsMap.values());\n    const defaultPath = format === \"drizzle\" ? DEFAULT_DRIZZLE_PATH : DEFAULT_PRISMA_PATH;\n    const schema =\n      format === \"drizzle\"\n        ? generateDrizzleSchema(allFragments, databaseType, {\n            namingStrategy: adapter.namingStrategy,\n          })\n        : generatePrismaSchema(allFragments, databaseType, {\n            sqliteStorageMode: adapter.adapterMetadata?.sqliteStorageMode,\n            namingStrategy: adapter.namingStrategy,\n          });\n\n    return [\n      {\n        schema,\n        path: options?.path ?? defaultPath,\n        namespace: firstDb.namespace,\n      },\n    ];\n  }\n\n  // Otherwise, use migration engine for SQL migration generation.\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Adapter does not support migration generation. Ensure your adapter implements prepareMigrations.\",\n    );\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  // Use the internal fragment for settings management\n  const internalFragment = instantiate(internalFragmentDef)\n    .withConfig({})\n    .withOptions({ databaseAdapter: adapter, databaseNamespace: null })\n    .build();\n\n  const settingsSourceVersion = await getSchemaVersionFromDatabase(internalFragment, \"\");\n\n  const generatedFiles: GenerationInternalResult[] = [];\n\n  // Internal fragment uses empty-string namespace: no table suffix, version key is \".schema_version\"\n  const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, \"\");\n  const settingsTargetVersion = internalSchema.version;\n\n  // Generate settings table migration\n  const settingsSql = settingsPreparedMigrations.getSQL(\n    settingsSourceVersion,\n    settingsTargetVersion,\n  );\n\n  if (settingsSql.trim()) {\n    generatedFiles.push({\n      schema: settingsSql,\n      path: \"settings-migration.sql\", // Placeholder, will be renamed in post-processing\n      namespace: null,\n      namespaceKey: SETTINGS_TABLE_NAME,\n      schemaName: internalSchema.name,\n      isSettings: true,\n      fromVersion: settingsSourceVersion,\n      toVersion: settingsTargetVersion,\n    });\n  }\n\n  // Generate migration for each fragment\n  for (const db of databases) {\n    const dbAdapter = db.adapter;\n\n    // Use migration engine\n    if (!dbAdapter.prepareMigrations) {\n      throw new Error(\n        `Adapter for ${db.namespace ?? db.schema.name} does not support migration generation. ` +\n          `Ensure your adapter implements prepareMigrations.`,\n      );\n    }\n\n    const preparedMigrations = dbAdapter.prepareMigrations(db.schema, db.namespace);\n    const targetVersion = options?.toVersion ?? db.schema.version;\n    const sourceVersion = options?.fromVersion ?? 0;\n\n    // Generate migration from source to target version\n    const sql = preparedMigrations.getSQL(sourceVersion, targetVersion);\n\n    // If no migrations needed, skip this fragment\n    if (sql.trim()) {\n      generatedFiles.push({\n        schema: sql,\n        path: \"schema.sql\", // Placeholder, will be renamed in post-processing\n        namespace: db.namespace,\n        namespaceKey: db.namespace ?? db.schema.name,\n        schemaName: db.schema.name,\n        isSettings: false,\n        fromVersion: sourceVersion,\n        toVersion: targetVersion,\n      });\n    }\n  }\n\n  // Post-process filenames with ordering\n  return postProcessMigrationFilenames(generatedFiles);\n}\n\n/**\n * Execute migrations for all fragments in the correct order.\n * Migrates settings table first, then fragments alphabetically.\n *\n * @param databases - Array of FragnoDatabase instances to migrate\n * @returns Array of execution results for each migration\n */\nexport async function executeMigrations<const TDatabases extends FragnoDatabase<AnySchema>[]>(\n  databases: TDatabases,\n): Promise<ExecuteMigrationResult[]> {\n  if (databases.length === 0) {\n    throw new Error(\"No databases provided for migration\");\n  }\n\n  const firstDb = databases[0];\n  const adapter = firstDb.adapter;\n\n  // Validate adapter supports migrations\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Adapter does not support running migrations. The adapter only supports schema generation.\\n\" +\n        \"Try using 'generateSchemaArtifacts' instead to generate schema files.\",\n    );\n  }\n\n  // Validate all use same adapter name and version\n  const firstAdapterName = adapter[fragnoDatabaseAdapterNameFakeSymbol];\n  const firstAdapterVersion = adapter[fragnoDatabaseAdapterVersionFakeSymbol];\n\n  for (const db of databases) {\n    const dbAdapterName = db.adapter[fragnoDatabaseAdapterNameFakeSymbol];\n    const dbAdapterVersion = db.adapter[fragnoDatabaseAdapterVersionFakeSymbol];\n\n    if (dbAdapterName !== firstAdapterName || dbAdapterVersion !== firstAdapterVersion) {\n      throw new Error(\n        `All fragments must use the same database adapter. ` +\n          `Found: ${firstAdapterName}@${firstAdapterVersion} and ${dbAdapterName}@${dbAdapterVersion}`,\n      );\n    }\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  const results: ExecuteMigrationResult[] = [];\n  const migrationsToExecute: Array<{\n    namespace: string | null;\n    namespaceKey: string;\n    fromVersion: number;\n    toVersion: number;\n    execute: () => Promise<void>;\n  }> = [];\n\n  // 1. Prepare settings table migration\n  // Use the internal fragment for settings management\n  const internalFragment = instantiate(internalFragmentDef)\n    .withConfig({})\n    .withOptions({ databaseAdapter: adapter, databaseNamespace: null })\n    .build();\n\n  const settingsSourceVersion = await getSchemaVersionFromDatabase(internalFragment, \"\");\n\n  // Internal fragment uses empty-string namespace: no table suffix, version key is \".schema_version\"\n  const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, \"\");\n  const settingsTargetVersion = internalSchema.version;\n\n  if (settingsSourceVersion < settingsTargetVersion) {\n    const compiledMigration = settingsPreparedMigrations.compile(\n      settingsSourceVersion,\n      settingsTargetVersion,\n      { updateVersionInMigration: true },\n    );\n\n    if (compiledMigration.statements.length > 0) {\n      migrationsToExecute.push({\n        namespace: null,\n        namespaceKey: SETTINGS_TABLE_NAME,\n        fromVersion: settingsSourceVersion,\n        toVersion: settingsTargetVersion,\n        execute: () =>\n          settingsPreparedMigrations.execute(settingsSourceVersion, settingsTargetVersion, {\n            updateVersionInMigration: true,\n          }),\n      });\n    }\n  }\n\n  // 2. Prepare fragment migrations (sorted alphabetically)\n  const getNamespaceKey = (db: FragnoDatabase<AnySchema>) => db.namespace ?? db.schema.name;\n  const sortedDatabases = [...databases].sort((a, b) =>\n    getNamespaceKey(a).localeCompare(getNamespaceKey(b)),\n  );\n\n  for (const fragnoDb of sortedDatabases) {\n    const namespaceKey = getNamespaceKey(fragnoDb);\n    const preparedMigrations = adapter.prepareMigrations(fragnoDb.schema, fragnoDb.namespace);\n    const currentVersion = await getSchemaVersionFromDatabase(internalFragment, namespaceKey);\n    const targetVersion = fragnoDb.schema.version;\n\n    if (currentVersion < targetVersion) {\n      const compiledMigration = preparedMigrations.compile(currentVersion, targetVersion, {\n        updateVersionInMigration: true,\n      });\n\n      if (compiledMigration.statements.length > 0) {\n        migrationsToExecute.push({\n          namespace: fragnoDb.namespace,\n          namespaceKey,\n          fromVersion: currentVersion,\n          toVersion: targetVersion,\n          execute: () =>\n            preparedMigrations.execute(currentVersion, targetVersion, {\n              updateVersionInMigration: true,\n            }),\n        });\n      }\n    }\n  }\n\n  // 3. Execute all migrations in order\n  const executedNamespaceKeys = new Set<string>();\n  for (const migration of migrationsToExecute) {\n    await migration.execute();\n    results.push({\n      namespace: migration.namespace,\n      didMigrate: true,\n      fromVersion: migration.fromVersion,\n      toVersion: migration.toVersion,\n    });\n    executedNamespaceKeys.add(migration.namespaceKey);\n  }\n\n  // 4. Add skipped migrations (already up-to-date)\n  for (const fragnoDb of databases) {\n    const namespaceKey = getNamespaceKey(fragnoDb);\n    if (!executedNamespaceKeys.has(namespaceKey)) {\n      results.push({\n        namespace: fragnoDb.namespace,\n        didMigrate: false,\n        fromVersion: fragnoDb.schema.version,\n        toVersion: fragnoDb.schema.version,\n      });\n    }\n  }\n\n  return results;\n}\n\n/**\n * Post-processes migration files to add ordering and standardize naming.\n *\n * Sorts files with settings namespace first, then alphabetically by namespace key,\n * and assigns ordering numbers. Transforms filenames to format:\n * `<date>_<n>_f<from>_t<to>_<namespace>.sql`\n *\n * @param files - Array of generated migration files with version information\n * @returns Array of files with standardized paths and ordering\n */\nexport function postProcessMigrationFilenames(\n  files: GenerationInternalResult[],\n): GenerationEngineResult[] {\n  if (files.length === 0) {\n    return [];\n  }\n\n  // Sort files: settings first, then alphabetically by namespace key\n  const sortedFiles = [...files].sort((a, b) => {\n    if (a.isSettings) {\n      return -1;\n    }\n    if (b.isSettings) {\n      return 1;\n    }\n    return a.namespaceKey.localeCompare(b.namespaceKey);\n  });\n\n  // Generate date prefix for filenames\n  const date = new Date().toISOString().split(\"T\")[0].replace(/-/g, \"\");\n\n  // Rename files with ordering\n  return sortedFiles.map((file, index) => {\n    const fromVersion = file.fromVersion ?? 0;\n    const toVersion = file.toVersion ?? 0;\n\n    // Create new filename with ordering\n    const orderNum = (index + 1).toString().padStart(3, \"0\");\n    const fromPadded = fromVersion.toString().padStart(3, \"0\");\n    const toPadded = toVersion.toString().padStart(3, \"0\");\n\n    const safeName = file.namespaceKey.replace(/[^a-z0-9-]/gi, \"_\");\n    const newPath = `${date}_${orderNum}_f${fromPadded}_t${toPadded}_${safeName}.sql`;\n\n    return {\n      schema: file.schema,\n      path: newPath,\n      namespace: file.namespace,\n    };\n  });\n}\n"],"mappings":"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"}

package/dist/migration-engine/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","names":[],"sources":["../../src/migration-engine/shared.ts"],"sourcesContent":["export interface ForeignKeyInfo {\n  name: string;\n  columns: string[];\n  referencedTable: string;\n  referencedColumns: string[];\n}\n\n/**\n * Provider-specific metadata that can be attached to operations during preprocessing.\n * This allows providers to add additional context without polluting the core operation types.\n */\nexport interface MigrationOperationMetadata {\n  [key: string]: unknown;\n}\n\n/**\n * SQLite-specific metadata for create-table operations.\n * Includes foreign keys that should be created inline with the table.\n */\nexport interface SqliteCreateTableMetadata extends MigrationOperationMetadata {\n  inlineForeignKeys?: ForeignKeyInfo[];\n}\n\nexport interface ColumnInfo {\n  name: string;\n  type:\n    | \"string\"\n    | \"integer\"\n    | \"bigint\"\n    | \"decimal\"\n    | \"bool\"\n    | \"date\"\n    | \"timestamp\"\n    | \"json\"\n    | \"binary\"\n    | `varchar(${number})`;\n  isNullable: boolean;\n  role: \"external-id\" | \"internal-id\" | \"version\" | \"reference\" | \"regular\";\n  default?: { value: unknown } | { dbSpecial: \"now\" } | { runtime: \"cuid\" | \"now\" };\n}\n\nexport type MigrationOperation<\n  TMeta extends MigrationOperationMetadata = MigrationOperationMetadata,\n> =\n  | (TableOperation & { metadata?: TMeta })\n  | ({\n      // warning: not supported by SQLite\n      type: \"add-foreign-key\";\n      table: string;\n      value: ForeignKeyInfo;\n    } & { metadata?: TMeta })\n  | ({\n      // warning: not supported by SQLite\n      type: \"drop-foreign-key\";\n      table: string;\n      name: string;\n    } & { metadata?: TMeta })\n  | ({\n      type: \"drop-index\";\n      table: string;\n      name: string;\n    } & { metadata?: TMeta })\n  | ({\n      type: \"add-index\";\n      table: string;\n      columns: string[];\n      name: string;\n      unique: boolean;\n    } & { metadata?: TMeta })\n  | (CustomOperation & { metadata?: TMeta });\n\nexport type CustomOperation = {\n  type: \"custom\";\n} & Record<string, unknown>;\n\nexport type TableOperation =\n  | {\n      type: \"create-table\";\n      name: string;\n      columns: ColumnInfo[];\n    }\n  | {\n      type: \"drop-table\";\n      name: string;\n    }\n  | {\n      type: \"alter-table\";\n      name: string;\n      value: ColumnOperation[];\n    }\n  | {\n      type: \"rename-table\";\n      from: string;\n      to: string;\n    };\n\nexport type ColumnOperation =\n  | {\n      type: \"rename-column\";\n      from: string;\n      to: string;\n    }\n  | {\n      type: \"drop-column\";\n      name: string;\n    }\n  | {\n      /**\n       * Note: unique constraints are not created, please use dedicated operations like `add-index` instead\n       */\n      type: \"create-column\";\n      value: ColumnInfo;\n    }\n  | {\n      /**\n       * warning: Not supported by SQLite\n       */\n      type: \"update-column\";\n      name: string;\n      /**\n       * For databases like MySQL, it requires the full definition for any modify column statement.\n       * Hence, you need to specify the full information of your column here.\n       *\n       * Then, opt-in for in-detail modification for other databases that supports changing data type/nullable/default separately, such as PostgreSQL.\n       *\n       * Note: unique constraints are not updated, please use dedicated operations like `add-index` instead\n       */\n      value: ColumnInfo;\n\n      updateNullable: boolean;\n      updateDefault: boolean;\n      updateDataType: boolean;\n    };\n\nexport function isUpdated(op: Extract<ColumnOperation, { type: \"update-column\" }>): boolean {\n  return op.updateDataType || op.updateDefault || op.updateNullable;\n}\n"],"mappings":";AAsIA,SAAgB,UAAU,IAAkE;AAC1F,QAAO,GAAG,kBAAkB,GAAG,iBAAiB,GAAG"}
+{"version":3,"file":"shared.js","names":[],"sources":["../../src/migration-engine/shared.ts"],"sourcesContent":["export interface ForeignKeyInfo {\n  name: string;\n  columns: string[];\n  referencedTable: string;\n  referencedColumns: string[];\n}\n\n/**\n * Provider-specific metadata that can be attached to operations during preprocessing.\n * This allows providers to add additional context without polluting the core operation types.\n */\nexport interface MigrationOperationMetadata {\n  [key: string]: unknown;\n}\n\n/**\n * SQLite-specific metadata for create-table operations.\n * Includes foreign keys that should be created inline with the table.\n */\nexport interface SqliteCreateTableMetadata extends MigrationOperationMetadata {\n  inlineForeignKeys?: ForeignKeyInfo[];\n}\n\nexport interface ColumnInfo {\n  name: string;\n  type:\n    | \"string\"\n    | \"integer\"\n    | \"bigint\"\n    | \"decimal\"\n    | \"bool\"\n    | \"date\"\n    | \"timestamp\"\n    | \"json\"\n    | \"binary\"\n    | `varchar(${number})`;\n  isNullable: boolean;\n  role: \"external-id\" | \"internal-id\" | \"version\" | \"reference\" | \"regular\";\n  default?: { value: unknown } | { dbSpecial: \"now\" } | { runtime: \"cuid\" | \"now\" };\n}\n\nexport type MigrationOperation<\n  TMeta extends MigrationOperationMetadata = MigrationOperationMetadata,\n> =\n  | (TableOperation & { metadata?: TMeta })\n  | ({\n      // warning: not supported by SQLite\n      type: \"add-foreign-key\";\n      table: string;\n      value: ForeignKeyInfo;\n    } & { metadata?: TMeta })\n  | ({\n      // warning: not supported by SQLite\n      type: \"drop-foreign-key\";\n      table: string;\n      name: string;\n      referencedTable: string;\n    } & { metadata?: TMeta })\n  | ({\n      type: \"drop-index\";\n      table: string;\n      name: string;\n    } & { metadata?: TMeta })\n  | ({\n      type: \"add-index\";\n      table: string;\n      columns: string[];\n      name: string;\n      unique: boolean;\n    } & { metadata?: TMeta })\n  | (CustomOperation & { metadata?: TMeta });\n\nexport type CustomOperation = {\n  type: \"custom\";\n} & Record<string, unknown>;\n\nexport type TableOperation =\n  | {\n      type: \"create-table\";\n      name: string;\n      columns: ColumnInfo[];\n    }\n  | {\n      type: \"drop-table\";\n      name: string;\n    }\n  | {\n      type: \"alter-table\";\n      name: string;\n      value: ColumnOperation[];\n    }\n  | {\n      type: \"rename-table\";\n      from: string;\n      to: string;\n    };\n\nexport type ColumnOperation =\n  | {\n      type: \"rename-column\";\n      from: string;\n      to: string;\n    }\n  | {\n      type: \"drop-column\";\n      name: string;\n    }\n  | {\n      /**\n       * Note: unique constraints are not created, please use dedicated operations like `add-index` instead\n       */\n      type: \"create-column\";\n      value: ColumnInfo;\n    }\n  | {\n      /**\n       * warning: Not supported by SQLite\n       */\n      type: \"update-column\";\n      name: string;\n      /**\n       * For databases like MySQL, it requires the full definition for any modify column statement.\n       * Hence, you need to specify the full information of your column here.\n       *\n       * Then, opt-in for in-detail modification for other databases that supports changing data type/nullable/default separately, such as PostgreSQL.\n       *\n       * Note: unique constraints are not updated, please use dedicated operations like `add-index` instead\n       */\n      value: ColumnInfo;\n\n      updateNullable: boolean;\n      updateDefault: boolean;\n      updateDataType: boolean;\n    };\n\nexport function isUpdated(op: Extract<ColumnOperation, { type: \"update-column\" }>): boolean {\n  return op.updateDataType || op.updateDefault || op.updateNullable;\n}\n"],"mappings":";AAuIA,SAAgB,UAAU,IAAkE;AAC1F,QAAO,GAAG,kBAAkB,GAAG,iBAAiB,GAAG"}

package/dist/mod.d.ts

@@ -1,20 +1,27 @@
+import { DbNow, dbNow } from "./query/db-now.js";
 import { AnySchema } from "./schema/create.js";
 import { Cursor, CursorData, CursorResult, decodeCursor } from "./query/cursor.js";
 import { ExponentialBackoffRetryPolicy, LinearBackoffRetryPolicy, NoRetryPolicy, RetryPolicy } from "./query/unit-of-work/retry-policy.js";
-import { ExecuteUnitOfWorkCallbacks, ExecuteUnitOfWorkOptions, ExecuteUnitOfWorkResult, executeUnitOfWork } from "./query/unit-of-work/execute-unit-of-work.js";
-import { DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, DatabaseHandlerContext, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies } from "./db-fragment-definition-builder.js";
+import { BuilderTransformContextWithMutate, BuilderTransformContextWithoutMutate, ConcurrencyConflictError, ExtractServiceFinalResults, ExtractServiceRetrieveResults, HandlerBuilderMutateContext, HandlerTxBuilder, ServiceBuilderMutateContext, ServiceTxBuilder, TxResult, createHandlerTxBuilder, createServiceTxBuilder } from "./query/unit-of-work/execute-unit-of-work.js";
+import { DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, DatabaseHandlerContext, DatabaseServiceContext, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies } from "./db-fragment-definition-builder.js";
+import { InMemoryAdapterOptions } from "./adapters/in-memory/options.js";
+import { InMemoryAdapter } from "./adapters/in-memory/in-memory-adapter.js";
+import "./adapters/in-memory/index.js";
+import { withDatabase } from "./with-database.js";
+import { OutboxConfig, OutboxEntry, OutboxMutation, OutboxPayload, OutboxRefMap } from "./outbox/outbox.js";
+import { DurableHooksProcessor, createDurableHooksProcessor } from "./hooks/durable-hooks-processor.js";
+import { internalSchema } from "./fragments/internal-fragment.schema.js";
 import { InternalFragmentInstance, internalFragmentDef } from "./fragments/internal-fragment.js";
-import { HookContext, HookFn, HookPayload, HooksMap, TriggerHookOptions } from "./hooks/hooks.js";
+import { DurableHooksProcessingOptions, HookContext, HookFn, HookPayload, HooksMap, StuckHookProcessingEvent, StuckHookProcessingInfo, StuckHookProcessingTimeoutMinutes, TriggerHookOptions } from "./hooks/hooks.js";
 import { IUnitOfWork, IUnitOfWorkRestricted, TypedUnitOfWork, UOWCompiler, UOWDecoder, UOWExecutor, UnitOfWork, createUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
 import { DatabaseAdapter } from "./adapters/adapters.js";
-import { withDatabase } from "./with-database.js";
 import { AnyFragnoInstantiatedFragment, BoundServices, FragnoInstantiatedFragment } from "@fragno-dev/core";
 
 //#region src/mod.d.ts
 declare const fragnoDatabaseFakeSymbol: "$fragno-database";
 declare const fragnoDatabaseLibraryVersion: "0.1";
 interface CreateFragnoDatabaseDefinitionOptions<T extends AnySchema> {
-  namespace: string;
+  namespace: string | null;
   schema: T;
 }
 declare function isFragnoDatabase(value: unknown): value is FragnoDatabase<AnySchema>;
@@ -25,16 +32,16 @@ declare function isFragnoDatabase(value: unknown): value is FragnoDatabase<AnySc
 declare class FragnoDatabase<const T extends AnySchema, TUOWConfig = void> {
   #private;
   constructor(options: {
-    namespace: string;
+    namespace: string | null;
     schema: T;
     adapter: DatabaseAdapter<TUOWConfig>;
   });
   get [fragnoDatabaseFakeSymbol](): typeof fragnoDatabaseFakeSymbol;
-  get namespace(): string;
+  get namespace(): string | null;
   get schema(): T;
   get adapter(): DatabaseAdapter<TUOWConfig>;
 }
-type AnyFragnoInstantiatedDatabaseFragment = FragnoInstantiatedFragment<any, ImplicitDatabaseDependencies<AnySchema>, any, any, any, any, FragnoPublicConfigWithDatabase, {
+type AnyFragnoInstantiatedDatabaseFragment<TSchema extends AnySchema = AnySchema> = FragnoInstantiatedFragment<any, ImplicitDatabaseDependencies<TSchema>, any, any, any, any, FragnoPublicConfigWithDatabase, {
   _fragno_internal: InternalFragmentInstance;
 } & Record<string, AnyFragnoInstantiatedFragment>>;
 /**
@@ -59,7 +66,7 @@ type AnyFragnoInstantiatedDatabaseFragment = FragnoInstantiatedFragment<any, Imp
  * await migrate(fragment);
  * ```
  */
-declare function migrate(fragment: AnyFragnoInstantiatedDatabaseFragment): Promise<void>;
+declare function migrate<TSchema extends AnySchema>(fragment: AnyFragnoInstantiatedDatabaseFragment<TSchema>): Promise<void>;
 //#endregion
-export { AnyFragnoInstantiatedDatabaseFragment, type BoundServices, CreateFragnoDatabaseDefinitionOptions, Cursor, type CursorData, type CursorResult, type DatabaseAdapter, type DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, type DatabaseHandlerContext as DatabaseRequestContext, type ExecuteUnitOfWorkCallbacks, type ExecuteUnitOfWorkOptions, type ExecuteUnitOfWorkResult, ExponentialBackoffRetryPolicy, FragnoDatabase, type FragnoPublicConfigWithDatabase, type HookContext, type HookFn, type HookPayload, type HooksMap, type IUnitOfWork, type IUnitOfWorkRestricted, type ImplicitDatabaseDependencies, type InternalFragmentInstance, LinearBackoffRetryPolicy, NoRetryPolicy, type RetryPolicy, type TriggerHookOptions, TypedUnitOfWork, type UOWCompiler, type UOWDecoder, type UOWExecutor, UnitOfWork, createUnitOfWork, decodeCursor, executeUnitOfWork, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, internalFragmentDef, isFragnoDatabase, migrate, withDatabase };
+export { AnyFragnoInstantiatedDatabaseFragment, type BoundServices, type BuilderTransformContextWithMutate, type BuilderTransformContextWithoutMutate, ConcurrencyConflictError, CreateFragnoDatabaseDefinitionOptions, Cursor, type CursorData, type CursorResult, type DatabaseAdapter, type DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, type DatabaseHandlerContext as DatabaseRequestContext, type DatabaseServiceContext, type DbNow, type DurableHooksProcessingOptions, type DurableHooksProcessor, ExponentialBackoffRetryPolicy, type ExtractServiceFinalResults, type ExtractServiceRetrieveResults, FragnoDatabase, type FragnoPublicConfigWithDatabase, type HandlerBuilderMutateContext, HandlerTxBuilder, type HookContext, type HookFn, type HookPayload, type HooksMap, type IUnitOfWork, type IUnitOfWorkRestricted, type ImplicitDatabaseDependencies, InMemoryAdapter, type InMemoryAdapterOptions, type InternalFragmentInstance, LinearBackoffRetryPolicy, NoRetryPolicy, type OutboxConfig, type OutboxEntry, type OutboxMutation, type OutboxPayload, type OutboxRefMap, type RetryPolicy, type ServiceBuilderMutateContext, ServiceTxBuilder, type StuckHookProcessingEvent, type StuckHookProcessingInfo, type StuckHookProcessingTimeoutMinutes, type TriggerHookOptions, type TxResult, TypedUnitOfWork, type UOWCompiler, type UOWDecoder, type UOWExecutor, UnitOfWork, createDurableHooksProcessor, createHandlerTxBuilder, createServiceTxBuilder, createUnitOfWork, dbNow, decodeCursor, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, internalFragmentDef, internalSchema, isFragnoDatabase, migrate, withDatabase };
 //# sourceMappingURL=mod.d.ts.map

package/dist/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;cAiBa;cACA;UAEI,gDAAgD;;EAHpD,MAAA,EAKH,CALG;AACb;AAEiB,iBAKD,gBAAA,CALC,KAAqC,EAAA,OAAA,CAAA,EAAW,KAAA,IAKN,cAHhD,CAG+D,SAH/D,CAAA;AAGX;AAmBA;;;AAKgF,cALnE,cAKmE,CAAA,gBALpC,SAKoC,EAAA,aAAA,IAAA,CAAA,CAAA;EAAhB,CAAA,OAAA;EAMrB,WAAA,CAAA,OAAA,EAAA;IAApC,SAAA,EAAA,MAAA;IAQK,MAAA,EAdwC,CAcxC;IAIqB,OAAA,EAlB+B,eAkB/B,CAlB+C,UAkB/C,CAAA;EAAhB,CAAA;EAAe,KAZzB,wBAAA,GAYyB,EAAA,OAZW,wBAYX;EAiDpB,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA;EAGmB,IAAA,MAAA,CAAA,CAAA,EAxDnB,CAwDmB;EAA7B,IAAA,OAAA,CAAA,CAAA,EApDe,eAoDf,CApD+B,UAoD/B,CAAA;;KAHU,qCAAA,GAAwC,gCAGlD,6BAA6B,gCAS7B;oBAEoB;IAA6B,eAAe;;;;;;;;;;;;;;;;;;;;;;;iBAyB5C,OAAA,WAAkB,wCAAwC"}
+{"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;cAuBa;cACA;UAEI,gDAAgD;;UAEvD;;AALG,iBAQG,gBAAA,CARmD,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IAQR,cARQ,CAQO,SARP,CAAA;AACnE;AAEA;AAKA;AAmBA;AAA4C,cAA/B,cAA+B,CAAA,gBAAA,SAAA,EAAA,aAAA,IAAA,CAAA,CAAA;EAOhC,CAAA,OAAA;EACiB,WAAA,CAAA,OAAA,EAAA;IAAhB,SAAA,EAAA,MAAA,GAAA,IAAA;IAO8B,MAAA,EAR/B,CAQ+B;IAApC,OAAA,EAPM,eAON,CAPsB,UAOtB,CAAA;EAQK,CAAA;EAIqB,KAZ1B,wBAAA,GAY0B,EAAA,OAZU,wBAYV;EAAhB,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAAe,IAAA,MAAA,CAAA,CAAA,EAJpB,CAIoB;EAiFpB,IAAA,OAAA,CAAA,CAAA,EAjFK,eAiFL,CAjFqB,UAiFgB,CAAA;;AAyCrC,KAzCA,qCAyCA,CAAA,gBAzCsD,SAyCtD,GAzCkE,SAyClE,CAAA,GAxCV,0BAwCU,CAAA,GAAA,EArCR,4BAqCQ,CArCqB,OAqCrB,CAAA,EAAA,GAAA,EAAA,GAAA,EAAA,GAAA,EAAA,GAAA,EA5BR,8BA4BQ,EAAA;EACT,gBAAA,EA3BqB,wBA2BrB;CAAO,GA3B2C,MA2B3C,CAAA,MAAA,EA3B0D,6BA2B1D,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;iBAFY,wBAAwB,qBAClC,sCAAsC,WAC/C"}

package/dist/mod.js

@@ -1,10 +1,16 @@
+import { ExponentialBackoffRetryPolicy, LinearBackoffRetryPolicy, NoRetryPolicy } from "./query/unit-of-work/retry-policy.js";
+import { ConcurrencyConflictError, HandlerTxBuilder, ServiceTxBuilder, createHandlerTxBuilder, createServiceTxBuilder } from "./query/unit-of-work/execute-unit-of-work.js";
+import { internalSchema } from "./fragments/internal-fragment.schema.js";
 import { Cursor, decodeCursor } from "./query/cursor.js";
+import { dbNow } from "./query/db-now.js";
 import { TypedUnitOfWork, UnitOfWork, createUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
-import { ExponentialBackoffRetryPolicy, LinearBackoffRetryPolicy, NoRetryPolicy } from "./query/unit-of-work/retry-policy.js";
-import { executeUnitOfWork } from "./query/unit-of-work/execute-unit-of-work.js";
+import { resolveDatabaseAdapter } from "./util/default-database-adapter.js";
 import { DatabaseFragmentDefinitionBuilder } from "./db-fragment-definition-builder.js";
 import { getSchemaVersionFromDatabase, internalFragmentDef } from "./fragments/internal-fragment.js";
+import { InMemoryAdapter } from "./adapters/in-memory/in-memory-adapter.js";
+import "./adapters/in-memory/index.js";
 import { withDatabase } from "./with-database.js";
+import { createDurableHooksProcessor } from "./hooks/durable-hooks-processor.js";
 
 //#region src/mod.ts
 const fragnoDatabaseFakeSymbol = "$fragno-database";
@@ -64,18 +70,18 @@ var FragnoDatabase = class {
 */
 async function migrate(fragment) {
 	const { options, deps, linkedFragments } = fragment.$internal;
-	const adapter = options.databaseAdapter;
+	const adapter = resolveDatabaseAdapter(options, deps.schema);
 	if (!adapter.prepareMigrations) throw new Error("Database adapter does not support prepareMigrations. Please use an adapter that implements this method.");
 	const schema = deps.schema;
-	const namespace = deps.namespace;
+	const namespace = deps.namespace ?? schema.name;
 	const internalFragment = linkedFragments._fragno_internal;
 	if (!internalFragment) throw new Error("Internal fragment not found. Please ensure the internal fragment is linked.");
 	if (!await adapter.isConnectionHealthy()) throw new Error("Database connection is not healthy. Please check your database connection and try again.");
 	const internalDeps = internalFragment.$internal.deps;
-	const internalSchema = internalDeps.schema;
-	const internalNamespace = internalDeps.namespace;
+	const internalSchema$1 = internalDeps.schema;
+	const internalNamespace = internalDeps.namespace ?? "";
 	const internalCurrentVersion = await getSchemaVersionFromDatabase(internalFragment, internalNamespace);
-	if (internalCurrentVersion < internalSchema.version) await adapter.prepareMigrations(internalSchema, internalNamespace).execute(internalCurrentVersion, internalSchema.version);
+	if (internalCurrentVersion < internalSchema$1.version) await adapter.prepareMigrations(internalSchema$1, internalNamespace).execute(internalCurrentVersion, internalSchema$1.version);
 	const currentVersion = await getSchemaVersionFromDatabase(internalFragment, namespace);
 	const targetVersion = schema.version;
 	if (currentVersion === targetVersion) return;
@@ -84,5 +90,5 @@ async function migrate(fragment) {
 }
 
 //#endregion
-export { Cursor, DatabaseFragmentDefinitionBuilder, ExponentialBackoffRetryPolicy, FragnoDatabase, LinearBackoffRetryPolicy, NoRetryPolicy, TypedUnitOfWork, UnitOfWork, createUnitOfWork, decodeCursor, executeUnitOfWork, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, internalFragmentDef, isFragnoDatabase, migrate, withDatabase };
+export { ConcurrencyConflictError, Cursor, DatabaseFragmentDefinitionBuilder, ExponentialBackoffRetryPolicy, FragnoDatabase, HandlerTxBuilder, InMemoryAdapter, LinearBackoffRetryPolicy, NoRetryPolicy, ServiceTxBuilder, TypedUnitOfWork, UnitOfWork, createDurableHooksProcessor, createHandlerTxBuilder, createServiceTxBuilder, createUnitOfWork, dbNow, decodeCursor, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, internalFragmentDef, internalSchema, isFragnoDatabase, migrate, withDatabase };
 //# sourceMappingURL=mod.js.map

package/dist/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","names":["#namespace","#schema","#adapter"],"sources":["../src/mod.ts"],"sourcesContent":["import type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type { AnySchema } from \"./schema/create\";\nimport type { CursorResult } from \"./query/cursor\";\nimport { Cursor } from \"./query/cursor\";\nimport type { FragnoInstantiatedFragment, AnyFragnoInstantiatedFragment } from \"@fragno-dev/core\";\nimport type {\n  FragnoPublicConfigWithDatabase,\n  ImplicitDatabaseDependencies,\n} from \"./db-fragment-definition-builder\";\nimport {\n  getSchemaVersionFromDatabase,\n  type InternalFragmentInstance,\n} from \"./fragments/internal-fragment\";\n\nexport type { DatabaseAdapter, CursorResult };\nexport { Cursor };\n\nexport const fragnoDatabaseFakeSymbol = \"$fragno-database\" as const;\nexport const fragnoDatabaseLibraryVersion = \"0.1\" as const;\n\nexport interface CreateFragnoDatabaseDefinitionOptions<T extends AnySchema> {\n  namespace: string;\n  schema: T;\n}\n\nexport function isFragnoDatabase(value: unknown): value is FragnoDatabase<AnySchema> {\n  if (value instanceof FragnoDatabase) {\n    return true;\n  }\n\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  return (\n    fragnoDatabaseFakeSymbol in value &&\n    value[fragnoDatabaseFakeSymbol] === fragnoDatabaseFakeSymbol\n  );\n}\n\n/**\n * A Fragno database instance with a bound adapter.\n * Created from a FragnoDatabaseDefinition by calling .create(adapter).\n */\nexport class FragnoDatabase<const T extends AnySchema, TUOWConfig = void> {\n  #namespace: string;\n  #schema: T;\n  #adapter: DatabaseAdapter<TUOWConfig>;\n\n  constructor(options: { namespace: string; schema: T; adapter: DatabaseAdapter<TUOWConfig> }) {\n    this.#namespace = options.namespace;\n    this.#schema = options.schema;\n    this.#adapter = options.adapter;\n  }\n\n  get [fragnoDatabaseFakeSymbol](): typeof fragnoDatabaseFakeSymbol {\n    return fragnoDatabaseFakeSymbol;\n  }\n\n  get namespace() {\n    return this.#namespace;\n  }\n\n  get schema() {\n    return this.#schema;\n  }\n\n  get adapter(): DatabaseAdapter<TUOWConfig> {\n    return this.#adapter;\n  }\n}\n\nexport {\n  DatabaseFragmentDefinitionBuilder,\n  type FragnoPublicConfigWithDatabase,\n  type DatabaseFragmentContext,\n  type DatabaseHandlerContext as DatabaseRequestContext,\n  type ImplicitDatabaseDependencies,\n} from \"./db-fragment-definition-builder\";\n\nexport { withDatabase } from \"./with-database\";\n\nexport { decodeCursor, type CursorData } from \"./query/cursor\";\n\nexport {\n  createUnitOfWork,\n  UnitOfWork,\n  TypedUnitOfWork,\n  type IUnitOfWork,\n  type IUnitOfWorkRestricted,\n  type UOWCompiler,\n  type UOWExecutor,\n  type UOWDecoder,\n} from \"./query/unit-of-work/unit-of-work\";\n\nexport {\n  type RetryPolicy,\n  NoRetryPolicy,\n  ExponentialBackoffRetryPolicy,\n  LinearBackoffRetryPolicy,\n} from \"./query/unit-of-work/retry-policy\";\n\nexport {\n  executeUnitOfWork,\n  type ExecuteUnitOfWorkResult,\n  type ExecuteUnitOfWorkCallbacks,\n  type ExecuteUnitOfWorkOptions,\n} from \"./query/unit-of-work/execute-unit-of-work\";\n\nexport type { BoundServices } from \"@fragno-dev/core\";\n\nexport { internalFragmentDef } from \"./fragments/internal-fragment\";\nexport type { InternalFragmentInstance } from \"./fragments/internal-fragment\";\n\nexport type { HookContext, HooksMap, HookFn, HookPayload, TriggerHookOptions } from \"./hooks/hooks\";\n\nexport type AnyFragnoInstantiatedDatabaseFragment = FragnoInstantiatedFragment<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  ImplicitDatabaseDependencies<AnySchema>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  any,\n  FragnoPublicConfigWithDatabase,\n  // Ensure the fragment has the internal fragment linked\n  { _fragno_internal: InternalFragmentInstance } & Record<string, AnyFragnoInstantiatedFragment>\n>;\n\n/**\n * Helper function to run migrations for a database fragment.\n * Extracts the database adapter, schema, and namespace from the fragment and runs migrations.\n * This function:\n * 1. Ensures the internal settings fragment is migrated first\n * 2. Retrieves the current database version from the internal fragment\n * 3. Runs migration from current version to target version\n *\n * @param fragment - The instantiated fragment to run migrations for\n * @throws Error if the fragment doesn't have database support or the adapter doesn't support migrations\n *\n * @example\n * ```typescript\n * const fragment = instantiate(myFragmentDef)\n *   .withConfig({})\n *   .withRoutes([])\n *   .withOptions({ databaseAdapter: myAdapter })\n *   .build();\n *\n * await migrate(fragment);\n * ```\n */\nexport async function migrate(fragment: AnyFragnoInstantiatedDatabaseFragment): Promise<void> {\n  const { options, deps, linkedFragments } = fragment.$internal;\n  const adapter = options.databaseAdapter;\n\n  // Check if adapter supports prepareMigrations\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Database adapter does not support prepareMigrations. Please use an adapter that implements this method.\",\n    );\n  }\n\n  const schema = deps.schema;\n  const namespace = deps.namespace;\n\n  // Step 1: Ensure the internal fragment (settings table) is migrated first\n  const internalFragment = linkedFragments._fragno_internal;\n\n  if (!internalFragment) {\n    throw new Error(\"Internal fragment not found. Please ensure the internal fragment is linked.\");\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  const internalDeps = internalFragment.$internal.deps;\n  const internalSchema = internalDeps.schema;\n  const internalNamespace = internalDeps.namespace;\n\n  const internalCurrentVersion = await getSchemaVersionFromDatabase(\n    internalFragment,\n    internalNamespace,\n  );\n\n  // Migrate internal fragment if needed\n  if (internalCurrentVersion < internalSchema.version) {\n    const internalMigrations = adapter.prepareMigrations(internalSchema, internalNamespace);\n    await internalMigrations.execute(internalCurrentVersion, internalSchema.version);\n  }\n\n  // Step 2: Get current database version for this fragment's namespace\n  const currentVersion = await getSchemaVersionFromDatabase(internalFragment, namespace);\n\n  // Step 3: Run the migration from current version to target version\n  const targetVersion = schema.version;\n\n  if (currentVersion === targetVersion) {\n    return;\n  }\n\n  if (currentVersion > targetVersion) {\n    throw new Error(\n      `Cannot migrate backwards: current version (${currentVersion}) > target version (${targetVersion})`,\n    );\n  }\n\n  const migrations = adapter.prepareMigrations(schema, namespace);\n  await migrations.execute(currentVersion, targetVersion);\n}\n"],"mappings":";;;;;;;;;AAiBA,MAAa,2BAA2B;AACxC,MAAa,+BAA+B;AAO5C,SAAgB,iBAAiB,OAAoD;AACnF,KAAI,iBAAiB,eACnB,QAAO;AAGT,KAAI,OAAO,UAAU,YAAY,UAAU,KACzC,QAAO;AAGT,QACE,4BAA4B,SAC5B,MAAM,8BAA8B;;;;;;AAQxC,IAAa,iBAAb,MAA0E;CACxE;CACA;CACA;CAEA,YAAY,SAAiF;AAC3F,QAAKA,YAAa,QAAQ;AAC1B,QAAKC,SAAU,QAAQ;AACvB,QAAKC,UAAW,QAAQ;;CAG1B,KAAK,4BAA6D;AAChE,SAAO;;CAGT,IAAI,YAAY;AACd,SAAO,MAAKF;;CAGd,IAAI,SAAS;AACX,SAAO,MAAKC;;CAGd,IAAI,UAAuC;AACzC,SAAO,MAAKC;;;;;;;;;;;;;;;;;;;;;;;;;AAuFhB,eAAsB,QAAQ,UAAgE;CAC5F,MAAM,EAAE,SAAS,MAAM,oBAAoB,SAAS;CACpD,MAAM,UAAU,QAAQ;AAGxB,KAAI,CAAC,QAAQ,kBACX,OAAM,IAAI,MACR,0GACD;CAGH,MAAM,SAAS,KAAK;CACpB,MAAM,YAAY,KAAK;CAGvB,MAAM,mBAAmB,gBAAgB;AAEzC,KAAI,CAAC,iBACH,OAAM,IAAI,MAAM,8EAA8E;AAGhG,KAAI,CAAE,MAAM,QAAQ,qBAAqB,CACvC,OAAM,IAAI,MACR,2FACD;CAGH,MAAM,eAAe,iBAAiB,UAAU;CAChD,MAAM,iBAAiB,aAAa;CACpC,MAAM,oBAAoB,aAAa;CAEvC,MAAM,yBAAyB,MAAM,6BACnC,kBACA,kBACD;AAGD,KAAI,yBAAyB,eAAe,QAE1C,OAD2B,QAAQ,kBAAkB,gBAAgB,kBAAkB,CAC9D,QAAQ,wBAAwB,eAAe,QAAQ;CAIlF,MAAM,iBAAiB,MAAM,6BAA6B,kBAAkB,UAAU;CAGtF,MAAM,gBAAgB,OAAO;AAE7B,KAAI,mBAAmB,cACrB;AAGF,KAAI,iBAAiB,cACnB,OAAM,IAAI,MACR,8CAA8C,eAAe,sBAAsB,cAAc,GAClG;AAIH,OADmB,QAAQ,kBAAkB,QAAQ,UAAU,CAC9C,QAAQ,gBAAgB,cAAc"}
+{"version":3,"file":"mod.js","names":["#namespace","#schema","#adapter","internalSchema"],"sources":["../src/mod.ts"],"sourcesContent":["import type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type { AnySchema } from \"./schema/create\";\nimport type { CursorResult } from \"./query/cursor\";\nimport { Cursor } from \"./query/cursor\";\nimport { dbNow, type DbNow } from \"./query/db-now\";\nimport type { FragnoInstantiatedFragment, AnyFragnoInstantiatedFragment } from \"@fragno-dev/core\";\nimport type {\n  FragnoPublicConfigWithDatabase,\n  ImplicitDatabaseDependencies,\n} from \"./db-fragment-definition-builder\";\nimport {\n  getSchemaVersionFromDatabase,\n  type InternalFragmentInstance,\n} from \"./fragments/internal-fragment\";\nimport { resolveDatabaseAdapter } from \"./util/default-database-adapter\";\n\nexport type { DatabaseAdapter, CursorResult };\nexport { Cursor };\nexport { dbNow };\nexport type { DbNow };\nexport { InMemoryAdapter, type InMemoryAdapterOptions } from \"./adapters/in-memory\";\nexport { internalSchema } from \"./fragments/internal-fragment\";\n\nexport const fragnoDatabaseFakeSymbol = \"$fragno-database\" as const;\nexport const fragnoDatabaseLibraryVersion = \"0.1\" as const;\n\nexport interface CreateFragnoDatabaseDefinitionOptions<T extends AnySchema> {\n  namespace: string | null;\n  schema: T;\n}\n\nexport function isFragnoDatabase(value: unknown): value is FragnoDatabase<AnySchema> {\n  if (value instanceof FragnoDatabase) {\n    return true;\n  }\n\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  return (\n    fragnoDatabaseFakeSymbol in value &&\n    value[fragnoDatabaseFakeSymbol] === fragnoDatabaseFakeSymbol\n  );\n}\n\n/**\n * A Fragno database instance with a bound adapter.\n * Created from a FragnoDatabaseDefinition by calling .create(adapter).\n */\nexport class FragnoDatabase<const T extends AnySchema, TUOWConfig = void> {\n  #namespace: string | null;\n  #schema: T;\n  #adapter: DatabaseAdapter<TUOWConfig>;\n\n  constructor(options: {\n    namespace: string | null;\n    schema: T;\n    adapter: DatabaseAdapter<TUOWConfig>;\n  }) {\n    this.#namespace = options.namespace;\n    this.#schema = options.schema;\n    this.#adapter = options.adapter;\n  }\n\n  get [fragnoDatabaseFakeSymbol](): typeof fragnoDatabaseFakeSymbol {\n    return fragnoDatabaseFakeSymbol;\n  }\n\n  get namespace() {\n    return this.#namespace;\n  }\n\n  get schema() {\n    return this.#schema;\n  }\n\n  get adapter(): DatabaseAdapter<TUOWConfig> {\n    return this.#adapter;\n  }\n}\n\nexport {\n  DatabaseFragmentDefinitionBuilder,\n  type FragnoPublicConfigWithDatabase,\n  type DatabaseFragmentContext,\n  type DatabaseServiceContext,\n  type DatabaseHandlerContext as DatabaseRequestContext,\n  type ImplicitDatabaseDependencies,\n} from \"./db-fragment-definition-builder\";\n\nexport { withDatabase } from \"./with-database\";\n\nexport { decodeCursor, type CursorData } from \"./query/cursor\";\n\nexport {\n  createUnitOfWork,\n  UnitOfWork,\n  TypedUnitOfWork,\n  type IUnitOfWork,\n  type IUnitOfWorkRestricted,\n  type UOWCompiler,\n  type UOWExecutor,\n  type UOWDecoder,\n} from \"./query/unit-of-work/unit-of-work\";\n\nexport {\n  type RetryPolicy,\n  NoRetryPolicy,\n  ExponentialBackoffRetryPolicy,\n  LinearBackoffRetryPolicy,\n} from \"./query/unit-of-work/retry-policy\";\n\nexport {\n  ConcurrencyConflictError,\n  // Builder pattern exports\n  ServiceTxBuilder,\n  HandlerTxBuilder,\n  createServiceTxBuilder,\n  createHandlerTxBuilder,\n  type TxResult,\n  // Builder context types\n  type ServiceBuilderMutateContext,\n  type HandlerBuilderMutateContext,\n  type BuilderTransformContextWithMutate,\n  type BuilderTransformContextWithoutMutate,\n  type ExtractServiceRetrieveResults,\n  type ExtractServiceFinalResults,\n} from \"./query/unit-of-work/execute-unit-of-work\";\n\nexport type { BoundServices } from \"@fragno-dev/core\";\n\nexport { internalFragmentDef } from \"./fragments/internal-fragment\";\nexport type { InternalFragmentInstance } from \"./fragments/internal-fragment\";\nexport type {\n  OutboxConfig,\n  OutboxEntry,\n  OutboxPayload,\n  OutboxMutation,\n  OutboxRefMap,\n} from \"./outbox/outbox\";\n\nexport type {\n  HookContext,\n  HooksMap,\n  HookFn,\n  HookPayload,\n  TriggerHookOptions,\n  DurableHooksProcessingOptions,\n  StuckHookProcessingInfo,\n  StuckHookProcessingEvent,\n  StuckHookProcessingTimeoutMinutes,\n} from \"./hooks/hooks\";\nexport {\n  createDurableHooksProcessor,\n  type DurableHooksProcessor,\n} from \"./hooks/durable-hooks-processor\";\n\nexport type AnyFragnoInstantiatedDatabaseFragment<TSchema extends AnySchema = AnySchema> =\n  FragnoInstantiatedFragment<\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    any,\n    ImplicitDatabaseDependencies<TSchema>,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    any,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    any,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    any,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    any,\n    FragnoPublicConfigWithDatabase,\n    // Ensure the fragment has the internal fragment linked\n    { _fragno_internal: InternalFragmentInstance } & Record<string, AnyFragnoInstantiatedFragment>\n  >;\n\n/**\n * Helper function to run migrations for a database fragment.\n * Extracts the database adapter, schema, and namespace from the fragment and runs migrations.\n * This function:\n * 1. Ensures the internal settings fragment is migrated first\n * 2. Retrieves the current database version from the internal fragment\n * 3. Runs migration from current version to target version\n *\n * @param fragment - The instantiated fragment to run migrations for\n * @throws Error if the fragment doesn't have database support or the adapter doesn't support migrations\n *\n * @example\n * ```typescript\n * const fragment = instantiate(myFragmentDef)\n *   .withConfig({})\n *   .withRoutes([])\n *   .withOptions({ databaseAdapter: myAdapter })\n *   .build();\n *\n * await migrate(fragment);\n * ```\n */\nexport async function migrate<TSchema extends AnySchema>(\n  fragment: AnyFragnoInstantiatedDatabaseFragment<TSchema>,\n): Promise<void> {\n  const { options, deps, linkedFragments } = fragment.$internal;\n  const adapter = resolveDatabaseAdapter(options, deps.schema);\n\n  // Check if adapter supports prepareMigrations\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Database adapter does not support prepareMigrations. Please use an adapter that implements this method.\",\n    );\n  }\n\n  const schema = deps.schema;\n  const namespace = deps.namespace ?? schema.name;\n\n  // Step 1: Ensure the internal fragment (settings table) is migrated first\n  const internalFragment = linkedFragments._fragno_internal;\n\n  if (!internalFragment) {\n    throw new Error(\"Internal fragment not found. Please ensure the internal fragment is linked.\");\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  const internalDeps = internalFragment.$internal.deps;\n  const internalSchema = internalDeps.schema;\n  // Internal fragment uses databaseNamespace: null (no table suffix).\n  // Version tracking uses empty string so the key is \".schema_version\",\n  // which matches both the legacy format and how the internal fragment was designed.\n  const internalNamespace = internalDeps.namespace ?? \"\";\n\n  const internalCurrentVersion = await getSchemaVersionFromDatabase(\n    internalFragment,\n    internalNamespace,\n  );\n\n  // Migrate internal fragment if needed\n  if (internalCurrentVersion < internalSchema.version) {\n    const internalMigrations = adapter.prepareMigrations(internalSchema, internalNamespace);\n    await internalMigrations.execute(internalCurrentVersion, internalSchema.version);\n  }\n\n  // Step 2: Get current database version for this fragment's namespace\n  const currentVersion = await getSchemaVersionFromDatabase(internalFragment, namespace);\n\n  // Step 3: Run the migration from current version to target version\n  const targetVersion = schema.version;\n\n  if (currentVersion === targetVersion) {\n    return;\n  }\n\n  if (currentVersion > targetVersion) {\n    throw new Error(\n      `Cannot migrate backwards: current version (${currentVersion}) > target version (${targetVersion})`,\n    );\n  }\n\n  const migrations = adapter.prepareMigrations(schema, namespace);\n  await migrations.execute(currentVersion, targetVersion);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuBA,MAAa,2BAA2B;AACxC,MAAa,+BAA+B;AAO5C,SAAgB,iBAAiB,OAAoD;AACnF,KAAI,iBAAiB,eACnB,QAAO;AAGT,KAAI,OAAO,UAAU,YAAY,UAAU,KACzC,QAAO;AAGT,QACE,4BAA4B,SAC5B,MAAM,8BAA8B;;;;;;AAQxC,IAAa,iBAAb,MAA0E;CACxE;CACA;CACA;CAEA,YAAY,SAIT;AACD,QAAKA,YAAa,QAAQ;AAC1B,QAAKC,SAAU,QAAQ;AACvB,QAAKC,UAAW,QAAQ;;CAG1B,KAAK,4BAA6D;AAChE,SAAO;;CAGT,IAAI,YAAY;AACd,SAAO,MAAKF;;CAGd,IAAI,SAAS;AACX,SAAO,MAAKC;;CAGd,IAAI,UAAuC;AACzC,SAAO,MAAKC;;;;;;;;;;;;;;;;;;;;;;;;;AAwHhB,eAAsB,QACpB,UACe;CACf,MAAM,EAAE,SAAS,MAAM,oBAAoB,SAAS;CACpD,MAAM,UAAU,uBAAuB,SAAS,KAAK,OAAO;AAG5D,KAAI,CAAC,QAAQ,kBACX,OAAM,IAAI,MACR,0GACD;CAGH,MAAM,SAAS,KAAK;CACpB,MAAM,YAAY,KAAK,aAAa,OAAO;CAG3C,MAAM,mBAAmB,gBAAgB;AAEzC,KAAI,CAAC,iBACH,OAAM,IAAI,MAAM,8EAA8E;AAGhG,KAAI,CAAE,MAAM,QAAQ,qBAAqB,CACvC,OAAM,IAAI,MACR,2FACD;CAGH,MAAM,eAAe,iBAAiB,UAAU;CAChD,MAAMC,mBAAiB,aAAa;CAIpC,MAAM,oBAAoB,aAAa,aAAa;CAEpD,MAAM,yBAAyB,MAAM,6BACnC,kBACA,kBACD;AAGD,KAAI,yBAAyBA,iBAAe,QAE1C,OAD2B,QAAQ,kBAAkBA,kBAAgB,kBAAkB,CAC9D,QAAQ,wBAAwBA,iBAAe,QAAQ;CAIlF,MAAM,iBAAiB,MAAM,6BAA6B,kBAAkB,UAAU;CAGtF,MAAM,gBAAgB,OAAO;AAE7B,KAAI,mBAAmB,cACrB;AAGF,KAAI,iBAAiB,cACnB,OAAM,IAAI,MACR,8CAA8C,eAAe,sBAAsB,cAAc,GAClG;AAIH,OADmB,QAAQ,kBAAkB,QAAQ,UAAU,CAC9C,QAAQ,gBAAgB,cAAc"}