@fragno-dev/db 0.2.2 → 0.4.1

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

@@ -1,32 +1,65 @@
-import { instantiate } from "../packages/fragno/dist/api/fragment-instantiator.js";
-import { SETTINGS_NAMESPACE, getSchemaVersionFromDatabase, internalFragmentDef, internalSchema } from "../fragments/internal-fragment.js";
+import { supportedDatabases } from "../adapters/generic-sql/driver-config.js";
 import { fragnoDatabaseAdapterNameFakeSymbol, fragnoDatabaseAdapterVersionFakeSymbol } from "../adapters/adapters.js";
+import { SETTINGS_TABLE_NAME, internalSchema } from "../fragments/internal-fragment.schema.js";
+import { getSchemaVersionFromDatabase, internalFragmentDef } from "../fragments/internal-fragment.js";
+import { getRegistryForAdapterSync } from "../internal/adapter-registry.js";
+import { generateDrizzleSchema } from "../schema-output/drizzle.js";
+import { generatePrismaSchema } from "../schema-output/prisma.js";
+import { instantiate } from "@fragno-dev/core";
 
 //#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: ""
+			namespace: null
 		});
-		for (const db of databases) if (!fragmentsMap.has(db.namespace)) fragmentsMap.set(db.namespace, {
-			schema: db.schema,
-			namespace: db.namespace
-		});
-		const allFragments = Array.from(fragmentsMap.values());
+		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.entries()).map(([namespaceKey, fragment]) => ({
+			...fragment,
+			namespaceKey,
+			isInternal: fragment.schema === internalSchema
+		})).sort((a, b) => {
+			if (a.isInternal) return -1;
+			if (b.isInternal) return 1;
+			return a.schema.name.localeCompare(b.schema.name);
+		}).map(({ schema, namespace }) => ({
+			schema,
+			namespace
+		}));
+		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({ registry: getRegistryForAdapterSync(adapter) }).withOptions({
+		databaseAdapter: adapter,
+		databaseNamespace: null
+	}).build(), "");
 	const generatedFiles = [];
 	const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, "");
 	const settingsTargetVersion = internalSchema.version;
@@ -34,13 +67,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 +85,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 +104,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 +115,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({ registry: getRegistryForAdapterSync(adapter) }).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 +157,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 +183,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 +201,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 { instantiate } from \"@fragno-dev/core\";\n\nimport {\n  fragnoDatabaseAdapterNameFakeSymbol,\n  fragnoDatabaseAdapterVersionFakeSymbol,\n} from \"../adapters/adapters\";\nimport { supportedDatabases, type SupportedDatabase } from \"../adapters/generic-sql/driver-config\";\nimport {\n  internalFragmentDef,\n  internalSchema,\n  SETTINGS_TABLE_NAME,\n  getSchemaVersionFromDatabase,\n} from \"../fragments/internal-fragment\";\nimport { getRegistryForAdapterSync } from \"../internal/adapter-registry\";\nimport type { FragnoDatabase } from \"../mod\";\nimport { generateDrizzleSchema } from \"../schema-output/drizzle\";\nimport { generatePrismaSchema } from \"../schema-output/prisma\";\nimport type { AnySchema } from \"../schema/create\";\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 share it via the adapter registry.\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.entries())\n      .map(([namespaceKey, fragment]) => ({\n        ...fragment,\n        namespaceKey,\n        isInternal: fragment.schema === internalSchema,\n      }))\n      .sort((a, b) => {\n        if (a.isInternal) {\n          return -1;\n        }\n        if (b.isInternal) {\n          return 1;\n        }\n        return a.schema.name.localeCompare(b.schema.name);\n      })\n      .map(({ schema, namespace }) => ({ schema, namespace }));\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({ registry: getRegistryForAdapterSync(adapter) })\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({ registry: getRegistryForAdapterSync(adapter) })\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.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","names":[],"sources":["../../src/migration-engine/shared.ts"],"sourcesContent":[],"mappings":";UAAiB,cAAA;EAAA,IAAA,EAAA,MAAA;EAWA,OAAA,EAAA,MAAA,EAAA;EAYA,eAAU,EAAA,MAAA;EA+Bf,iBAAA,EAAA,MAAkB,EAAA;;;;;;AAST,UApDJ,0BAAA,CAoDI;EAOA,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;UA/CJ,UAAA;;;;;;;;;;;;;KA+BL,iCACI,6BAA6B,+BAExC;aAA8B;;;;SAKtB;;aACQ;;;;;;;aAOA;;;;;;aAKA;;;;;;;;aAOA;MAChB;aAA+B;;KAExB,eAAA;;IAER;KAEQ,cAAA;;;WAIG;;;;;;;SASF;;;;;;KAQD,eAAA;;;;;;;;;;;;SAeC;;;;;;;;;;;;;;;SAgBA"}

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 interface SqliteRecreateTableInfo {\n  columns: ColumnInfo[];\n  copyColumns: SqliteCopyColumn[];\n  indexes: { name: string; columns: string[]; unique: boolean }[];\n  foreignKeys: ForeignKeyInfo[];\n}\n\nexport type SqliteCopyColumn = string | { from: string; to: string };\n\nexport interface SqliteAlterTableMetadata extends MigrationOperationMetadata {\n  recreateTable?: SqliteRecreateTableInfo;\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":";AAoJA,SAAgB,UAAU,IAAkE;AAC1F,QAAO,GAAG,kBAAkB,GAAG,iBAAiB,GAAG"}

package/dist/mod.d.ts

@@ -1,20 +1,30 @@
+import { DbInterval, DbIntervalInput, DbNow, dbInterval, 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 { 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, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies } from "./db-fragment-definition-builder.js";
+import { BuilderTransformContextWithMutate, BuilderTransformContextWithoutMutate, ConcurrencyConflictError, ExtractServiceFinalResults, ExtractServiceRetrieveResults, HandlerBuilderMutateContext, HandlerTxBuilder, HandlerTxContext, ServiceBuilderMutateContext, ServiceTxBuilder, TxResult, createHandlerTxBuilder, createServiceTxBuilder, serviceCalls } from "./query/unit-of-work/execute-unit-of-work.js";
+import { OutboxConfig, OutboxEntry, OutboxMutation, OutboxPayload, OutboxRefMap } from "./outbox/outbox.js";
+import { SubmitAppliedResponse, SubmitConflictReason, SubmitConflictResponse, SubmitRequest, SubmitResponse, SyncCommandDefinition, SyncCommandHandler, SyncCommandRegistry, SyncCommandTxFactory } from "./sync/types.js";
+import { DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, DatabaseHandlerContext, DatabaseServiceContext, DbRoundtripGuardConfig, 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 { getInternalFragment } from "./internal/adapter-registry.js";
 import { withDatabase } from "./with-database.js";
+import { defineSyncCommands } from "./sync/commands.js";
+import { DurableHookRecord, DurableHookStatus, DurableHooksAccessor, DurableHooksService, getDurableHooksService } from "./durable-hooks.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, HookHandlerTx, 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 { AnyFragnoInstantiatedFragment, BoundServices, FragnoInstantiatedFragment } from "@fragno-dev/core";
+import { 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,18 +35,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, {
-  _fragno_internal: InternalFragmentInstance;
-} & Record<string, AnyFragnoInstantiatedFragment>>;
+type AnyFragnoInstantiatedDatabaseFragment<TSchema extends AnySchema = AnySchema> = FragnoInstantiatedFragment<any, ImplicitDatabaseDependencies<TSchema>, any, any, DatabaseHandlerContext, any, FragnoPublicConfigWithDatabase>;
 /**
  * Helper function to run migrations for a database fragment.
  * Extracts the database adapter, schema, and namespace from the fragment and runs migrations.
@@ -59,7 +67,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, type BuilderTransformContextWithMutate, type BuilderTransformContextWithoutMutate, ConcurrencyConflictError, CreateFragnoDatabaseDefinitionOptions, Cursor, type CursorData, type CursorResult, type DatabaseAdapter, type DatabaseFragmentContext, DatabaseFragmentDefinitionBuilder, type DatabaseHandlerContext as DatabaseRequestContext, 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, type InternalFragmentInstance, LinearBackoffRetryPolicy, NoRetryPolicy, type RetryPolicy, type ServiceBuilderMutateContext, ServiceTxBuilder, type TriggerHookOptions, type TxResult, TypedUnitOfWork, type UOWCompiler, type UOWDecoder, type UOWExecutor, UnitOfWork, createHandlerTxBuilder, createServiceTxBuilder, createUnitOfWork, decodeCursor, 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 DbInterval, type DbIntervalInput, type DbNow, type DbRoundtripGuardConfig, type DurableHookRecord, type DurableHookStatus, type DurableHooksAccessor, type DurableHooksProcessingOptions, type DurableHooksService, ExponentialBackoffRetryPolicy, type ExtractServiceFinalResults, type ExtractServiceRetrieveResults, FragnoDatabase, type FragnoPublicConfigWithDatabase, type HandlerBuilderMutateContext, HandlerTxBuilder, type HandlerTxContext, type HookContext, type HookFn, type HookHandlerTx, 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 SubmitAppliedResponse, type SubmitConflictReason, type SubmitConflictResponse, type SubmitRequest, type SubmitResponse, type SyncCommandDefinition, type SyncCommandHandler, type SyncCommandRegistry, type SyncCommandTxFactory, type TriggerHookOptions, type TxResult, TypedUnitOfWork, type UOWCompiler, type UOWDecoder, type UOWExecutor, UnitOfWork, createHandlerTxBuilder, createServiceTxBuilder, createUnitOfWork, dbInterval, dbNow, decodeCursor, defineSyncCommands, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, getDurableHooksService, getInternalFragment, internalFragmentDef, internalSchema, isFragnoDatabase, migrate, serviceCalls, 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,CAAW,EAAA,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;EA2DpB,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA;EAGmB,IAAA,MAAA,CAAA,CAAA,EAlEnB,CAkEmB;EAA7B,IAAA,OAAA,CAAA,CAAA,EA9De,eA8Df,CA9D+B,UA8D/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":";;;;;;;;;;;;;;;;;;;;;;;cA6Ba;cACA;UAEI,gDAAgD;;UAEvD;;iBAGM,gBAAA,2BAA2C,eAAe;;;AAR1E;AACA;AAEiB,cAwBJ,cAxBI,CAAA,gBAwB2B,SAxBqB,EAAA,aAEtD,IAAA,CAAA,CAAA;EAGK,CAAA,OAAA;EAmBH,WAAA,CAAA,OAAc,EAAA;IAAiB,SAAA,EAAA,MAAA,GAAA,IAAA;IAOhC,MAAA,EAAA,CAAA;IACiB,OAAA,EAAhB,eAAgB,CAAA,UAAA,CAAA;EAAhB,CAAA;EAO8B,KAApC,wBAAA,GAAoC,EAAA,OAAA,wBAAA;EAApC,IAAA,SAAA,CAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAQK,IAAA,MAAA,CAAA,CAAA,EAAA,CAAA;EAIqB,IAAA,OAAA,CAAA,CAAA,EAAhB,eAAgB,CAAA,UAAA,CAAA;;AA2IvB,KAvCE,qCAuCF,CAAA,gBAvCwD,SAuCxD,GAvCoE,SAuCpE,CAAA,GAtCR,0BAsCQ,CAAA,GAAA,EAnCN,4BAmCM,CAnCuB,OAmCvB,CAAA,EAAA,GAAA,EAAA,GAAA,EA9BN,sBA8BM,EAAA,GAAA,EA3BN,8BA2BM,CAAA;;;;;;;;;;;;;;;;;;;;;;;iBAFY,wBAAwB,qBAClC,sCAAsC,WAC/C"}

package/dist/mod.js

@@ -1,10 +1,17 @@
+import { dbInterval, dbNow } from "./query/db-now.js";
 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 { DatabaseFragmentDefinitionBuilder } from "./db-fragment-definition-builder.js";
+import { ConcurrencyConflictError, HandlerTxBuilder, ServiceTxBuilder, createHandlerTxBuilder, createServiceTxBuilder, serviceCalls } from "./query/unit-of-work/execute-unit-of-work.js";
 import { Cursor, decodeCursor } from "./query/cursor.js";
+import { TypedUnitOfWork, UnitOfWork, createUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
+import { internalSchema } from "./fragments/internal-fragment.schema.js";
+import { DatabaseFragmentDefinitionBuilder } from "./db-fragment-definition-builder.js";
 import { getSchemaVersionFromDatabase, internalFragmentDef } from "./fragments/internal-fragment.js";
+import { getInternalFragment } from "./internal/adapter-registry.js";
+import { getDurableHooksService } from "./durable-hooks.js";
+import { InMemoryAdapter } from "./adapters/in-memory/in-memory-adapter.js";
+import "./adapters/in-memory/index.js";
 import { withDatabase } from "./with-database.js";
-import { TypedUnitOfWork, UnitOfWork, createUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
+import { defineSyncCommands } from "./sync/commands.js";
 
 //#region src/mod.ts
 const fragnoDatabaseFakeSymbol = "$fragno-database";
@@ -63,19 +70,18 @@ var FragnoDatabase = class {
 * ```
 */
 async function migrate(fragment) {
-	const { options, deps, linkedFragments } = fragment.$internal;
-	const adapter = options.databaseAdapter;
+	const { deps } = fragment.$internal;
+	const adapter = deps.databaseAdapter;
 	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 internalFragment = linkedFragments._fragno_internal;
-	if (!internalFragment) throw new Error("Internal fragment not found. Please ensure the internal fragment is linked.");
+	const namespace = deps.namespace ?? schema.name;
+	const internalFragment = getInternalFragment(adapter);
 	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 { ConcurrencyConflictError, Cursor, DatabaseFragmentDefinitionBuilder, ExponentialBackoffRetryPolicy, FragnoDatabase, HandlerTxBuilder, LinearBackoffRetryPolicy, NoRetryPolicy, ServiceTxBuilder, TypedUnitOfWork, UnitOfWork, createHandlerTxBuilder, createServiceTxBuilder, createUnitOfWork, decodeCursor, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, internalFragmentDef, isFragnoDatabase, migrate, withDatabase };
+export { ConcurrencyConflictError, Cursor, DatabaseFragmentDefinitionBuilder, ExponentialBackoffRetryPolicy, FragnoDatabase, HandlerTxBuilder, InMemoryAdapter, LinearBackoffRetryPolicy, NoRetryPolicy, ServiceTxBuilder, TypedUnitOfWork, UnitOfWork, createHandlerTxBuilder, createServiceTxBuilder, createUnitOfWork, dbInterval, dbNow, decodeCursor, defineSyncCommands, fragnoDatabaseFakeSymbol, fragnoDatabaseLibraryVersion, getDurableHooksService, getInternalFragment, internalFragmentDef, internalSchema, isFragnoDatabase, migrate, serviceCalls, withDatabase };
 //# sourceMappingURL=mod.js.map