@fragno-dev/db 0.1.14 → 0.2.0

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

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

package/dist/fragments/internal-fragment.js

@@ -0,0 +1,111 @@
+import { column, idColumn, schema } from "../schema/create.js";
+import { FragmentDefinitionBuilder } from "../packages/fragno/dist/api/fragment-definition-builder.js";
+import { DatabaseFragmentDefinitionBuilder } from "../db-fragment-definition-builder.js";
+
+//#region src/fragments/internal-fragment.ts
+const SETTINGS_TABLE_NAME = "fragno_db_settings";
+const SETTINGS_NAMESPACE = "fragno-db-settings";
+const internalSchema = schema((s) => {
+	return s.addTable(SETTINGS_TABLE_NAME, (t) => {
+		return t.addColumn("id", idColumn()).addColumn("key", column("string")).addColumn("value", column("string")).createIndex("unique_key", ["key"], { unique: true });
+	}).addTable("fragno_hooks", (t) => {
+		return t.addColumn("id", idColumn()).addColumn("namespace", column("string")).addColumn("hookName", column("string")).addColumn("payload", column("json")).addColumn("status", column("string")).addColumn("attempts", column("integer").defaultTo(0)).addColumn("maxAttempts", column("integer").defaultTo(5)).addColumn("lastAttemptAt", column("timestamp").nullable()).addColumn("nextRetryAt", column("timestamp").nullable()).addColumn("error", column("string").nullable()).addColumn("createdAt", column("timestamp").defaultTo((b) => b.now())).addColumn("nonce", column("string")).createIndex("idx_namespace_status_retry", [
+			"namespace",
+			"status",
+			"nextRetryAt"
+		]).createIndex("idx_nonce", ["nonce"]);
+	});
+});
+const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDefinitionBuilder("$fragno-internal-fragment"), internalSchema, "").providesService("settingsService", ({ defineService }) => {
+	return defineService({
+		async get(namespace, key) {
+			const fullKey = `${namespace}.${key}`;
+			const [results] = await this.uow(internalSchema).find(SETTINGS_TABLE_NAME, (b) => b.whereIndex("unique_key", (eb) => eb("key", "=", fullKey))).retrievalPhase;
+			return results?.[0];
+		},
+		async set(namespace, key, value) {
+			const fullKey = `${namespace}.${key}`;
+			const uow = this.uow(internalSchema);
+			const [existing] = await uow.find(SETTINGS_TABLE_NAME, (b) => b.whereIndex("unique_key", (eb) => eb("key", "=", fullKey))).retrievalPhase;
+			if (existing?.[0]) uow.update(SETTINGS_TABLE_NAME, existing[0].id, (b) => b.set({ value }).check());
+			else uow.create(SETTINGS_TABLE_NAME, {
+				key: fullKey,
+				value
+			});
+			await uow.mutationPhase;
+		},
+		async delete(id) {
+			const uow = this.uow(internalSchema);
+			uow.delete(SETTINGS_TABLE_NAME, id);
+			await uow.mutationPhase;
+		}
+	});
+}).providesService("hookService", ({ defineService }) => {
+	return defineService({
+		async getPendingHookEvents(namespace) {
+			const [events] = await this.uow(internalSchema).find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_retry", (eb) => eb.and(eb("namespace", "=", namespace), eb("status", "=", "pending")))).retrievalPhase;
+			const now = /* @__PURE__ */ new Date();
+			return events.filter((event) => {
+				if (!event.nextRetryAt) return true;
+				return event.nextRetryAt <= now;
+			}).map((event) => ({
+				id: event.id,
+				hookName: event.hookName,
+				payload: event.payload,
+				attempts: event.attempts,
+				maxAttempts: event.maxAttempts,
+				nonce: event.nonce
+			}));
+		},
+		markHookCompleted(eventId) {
+			this.uow(internalSchema).update("fragno_hooks", eventId, (b) => b.set({
+				status: "completed",
+				lastAttemptAt: /* @__PURE__ */ new Date()
+			}).check());
+		},
+		markHookFailed(eventId, error, attempts, retryPolicy) {
+			const uow = this.uow(internalSchema);
+			const newAttempts = attempts + 1;
+			if (retryPolicy.shouldRetry(newAttempts - 1)) {
+				const delayMs = retryPolicy.getDelayMs(newAttempts - 1);
+				const nextRetryAt = new Date(Date.now() + delayMs);
+				uow.update("fragno_hooks", eventId, (b) => b.set({
+					status: "pending",
+					attempts: newAttempts,
+					lastAttemptAt: /* @__PURE__ */ new Date(),
+					nextRetryAt,
+					error
+				}).check());
+			} else uow.update("fragno_hooks", eventId, (b) => b.set({
+				status: "failed",
+				attempts: newAttempts,
+				lastAttemptAt: /* @__PURE__ */ new Date(),
+				error
+			}).check());
+		},
+		markHookProcessing(eventId) {
+			this.uow(internalSchema).update("fragno_hooks", eventId, (b) => b.set({
+				status: "processing",
+				lastAttemptAt: /* @__PURE__ */ new Date()
+			}).check());
+		}
+	});
+}).build();
+async function getSchemaVersionFromDatabase(fragment, namespace) {
+	try {
+		return await fragment.inContext(async function() {
+			const version = await this.uow(async ({ executeRetrieve }) => {
+				const version$1 = fragment.services.settingsService.get(namespace, "schema_version");
+				await executeRetrieve();
+				return version$1;
+			});
+			return version ? parseInt(version.value, 10) : 0;
+		});
+	} catch {
+		return 0;
+	}
+}
+
+//#endregion
+export { SETTINGS_NAMESPACE, SETTINGS_TABLE_NAME, getSchemaVersionFromDatabase, internalFragmentDef, internalSchema };
+//# sourceMappingURL=internal-fragment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal-fragment.js","names":["version"],"sources":["../../src/fragments/internal-fragment.ts"],"sourcesContent":["import { FragmentDefinitionBuilder } from \"@fragno-dev/core\";\nimport type { InstantiatedFragmentFromDefinition } from \"@fragno-dev/core\";\nimport {\n  DatabaseFragmentDefinitionBuilder,\n  type DatabaseHandlerContext,\n  type DatabaseRequestStorage,\n  type DatabaseServiceContext,\n  type FragnoPublicConfigWithDatabase,\n  type ImplicitDatabaseDependencies,\n} from \"../db-fragment-definition-builder\";\nimport type { FragnoId } from \"../schema/create\";\nimport { schema, idColumn, column } from \"../schema/create\";\nimport type { RetryPolicy } from \"../query/unit-of-work/retry-policy\";\n\n// Constants for Fragno's internal settings table\nexport const SETTINGS_TABLE_NAME = \"fragno_db_settings\" as const;\n// FIXME: In some places we simply use empty string \"\" as namespace, which is not correct.\nexport const SETTINGS_NAMESPACE = \"fragno-db-settings\" as const;\n\nexport const internalSchema = schema((s) => {\n  return s\n    .addTable(SETTINGS_TABLE_NAME, (t) => {\n      return t\n        .addColumn(\"id\", idColumn())\n        .addColumn(\"key\", column(\"string\"))\n        .addColumn(\"value\", column(\"string\"))\n        .createIndex(\"unique_key\", [\"key\"], { unique: true });\n    })\n    .addTable(\"fragno_hooks\", (t) => {\n      return t\n        .addColumn(\"id\", idColumn())\n        .addColumn(\"namespace\", column(\"string\"))\n        .addColumn(\"hookName\", column(\"string\"))\n        .addColumn(\"payload\", column(\"json\"))\n        .addColumn(\"status\", column(\"string\")) // \"pending\" | \"processing\" | \"completed\" | \"failed\"\n        .addColumn(\"attempts\", column(\"integer\").defaultTo(0))\n        .addColumn(\"maxAttempts\", column(\"integer\").defaultTo(5))\n        .addColumn(\"lastAttemptAt\", column(\"timestamp\").nullable())\n        .addColumn(\"nextRetryAt\", column(\"timestamp\").nullable())\n        .addColumn(\"error\", column(\"string\").nullable())\n        .addColumn(\n          \"createdAt\",\n          column(\"timestamp\").defaultTo((b) => b.now()),\n        )\n        .addColumn(\"nonce\", column(\"string\"))\n        .createIndex(\"idx_namespace_status_retry\", [\"namespace\", \"status\", \"nextRetryAt\"])\n        .createIndex(\"idx_nonce\", [\"nonce\"]);\n    });\n});\n\n// This uses DatabaseFragmentDefinitionBuilder directly\n// to avoid circular dependency (it doesn't need to link to itself)\nexport const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(\n  new FragmentDefinitionBuilder<\n    {},\n    FragnoPublicConfigWithDatabase,\n    ImplicitDatabaseDependencies<typeof internalSchema>,\n    {},\n    {},\n    {},\n    {},\n    DatabaseServiceContext<{}>,\n    DatabaseHandlerContext,\n    DatabaseRequestStorage\n  >(\"$fragno-internal-fragment\"),\n  internalSchema,\n  \"\", // intentionally blank namespace so there is no prefix\n)\n  .providesService(\"settingsService\", ({ defineService }) => {\n    return defineService({\n      async get(\n        namespace: string,\n        key: string,\n      ): Promise<{ id: FragnoId; key: string; value: string } | undefined> {\n        const fullKey = `${namespace}.${key}`;\n        const uow = this.uow(internalSchema).find(SETTINGS_TABLE_NAME, (b) =>\n          b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", fullKey)),\n        );\n        const [results] = await uow.retrievalPhase;\n        return results?.[0];\n      },\n\n      async set(namespace: string, key: string, value: string) {\n        const fullKey = `${namespace}.${key}`;\n        const uow = this.uow(internalSchema);\n\n        // First, find if the key already exists\n        const findUow = uow.find(SETTINGS_TABLE_NAME, (b) =>\n          b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", fullKey)),\n        );\n        const [existing] = await findUow.retrievalPhase;\n\n        if (existing?.[0]) {\n          uow.update(SETTINGS_TABLE_NAME, existing[0].id, (b) => b.set({ value }).check());\n        } else {\n          uow.create(SETTINGS_TABLE_NAME, {\n            key: fullKey,\n            value,\n          });\n        }\n\n        // Await mutation phase - will throw if mutation fails\n        await uow.mutationPhase;\n      },\n\n      async delete(id: FragnoId) {\n        const uow = this.uow(internalSchema);\n        uow.delete(SETTINGS_TABLE_NAME, id);\n        await uow.mutationPhase;\n      },\n    });\n  })\n  .providesService(\"hookService\", ({ defineService }) => {\n    // TODO(Wilco): re-implement this better\n    return defineService({\n      /**\n       * Get pending hook events for processing.\n       * Returns all pending events for the given namespace that are ready to be processed.\n       */\n      async getPendingHookEvents(namespace: string): Promise<\n        {\n          id: FragnoId;\n          hookName: string;\n          payload: unknown;\n          attempts: number;\n          maxAttempts: number;\n          nonce: string;\n        }[]\n      > {\n        const uow = this.uow(internalSchema).find(\"fragno_hooks\", (b) =>\n          b.whereIndex(\"idx_namespace_status_retry\", (eb) =>\n            eb.and(eb(\"namespace\", \"=\", namespace), eb(\"status\", \"=\", \"pending\")),\n          ),\n        );\n\n        const [events] = await uow.retrievalPhase;\n\n        // Filter for pending status and events ready for retry\n        const now = new Date();\n        const ready = events.filter((event) => {\n          // FIXME(Wilco): this should be handled by the database query, but there seems to be an issue.\n          if (!event.nextRetryAt) {\n            return true; // Newly created events (nextRetryAt = null) are ready\n          }\n          return event.nextRetryAt <= now; // Only include if retry time has passed\n        });\n\n        return ready.map((event) => ({\n          id: event.id,\n          hookName: event.hookName,\n          payload: event.payload,\n          attempts: event.attempts,\n          maxAttempts: event.maxAttempts,\n          nonce: event.nonce,\n        }));\n      },\n\n      /**\n       * Mark a hook event as completed.\n       */\n      markHookCompleted(eventId: FragnoId): void {\n        const uow = this.uow(internalSchema);\n        uow.update(\"fragno_hooks\", eventId, (b) =>\n          b.set({ status: \"completed\", lastAttemptAt: new Date() }).check(),\n        );\n      },\n\n      /**\n       * Mark a hook event as failed and schedule next retry.\n       */\n      markHookFailed(\n        eventId: FragnoId,\n        error: string,\n        attempts: number,\n        retryPolicy: RetryPolicy,\n      ): void {\n        const uow = this.uow(internalSchema);\n\n        const newAttempts = attempts + 1;\n        const shouldRetry = retryPolicy.shouldRetry(newAttempts - 1);\n\n        if (shouldRetry) {\n          const delayMs = retryPolicy.getDelayMs(newAttempts - 1);\n          const nextRetryAt = new Date(Date.now() + delayMs);\n          uow.update(\"fragno_hooks\", eventId, (b) =>\n            b\n              .set({\n                status: \"pending\",\n                attempts: newAttempts,\n                lastAttemptAt: new Date(),\n                nextRetryAt,\n                error,\n              })\n              .check(),\n          );\n        } else {\n          uow.update(\"fragno_hooks\", eventId, (b) =>\n            b\n              .set({\n                status: \"failed\",\n                attempts: newAttempts,\n                lastAttemptAt: new Date(),\n                error,\n              })\n              .check(),\n          );\n        }\n      },\n\n      /**\n       * Mark a hook event as processing (to prevent concurrent execution).\n       */\n      markHookProcessing(eventId: FragnoId): void {\n        const uow = this.uow(internalSchema);\n        uow.update(\"fragno_hooks\", eventId, (b) =>\n          b.set({ status: \"processing\", lastAttemptAt: new Date() }).check(),\n        );\n      },\n    });\n  })\n  .build();\n\n/**\n * Type representing an instantiated internal fragment.\n * This is the fragment that manages Fragno's internal settings table.\n */\nexport type InternalFragmentInstance = InstantiatedFragmentFromDefinition<\n  typeof internalFragmentDef\n>;\n\nexport async function getSchemaVersionFromDatabase(\n  fragment: InternalFragmentInstance,\n  namespace: string,\n): Promise<number> {\n  try {\n    const version = await fragment.inContext(async function () {\n      const version = await this.uow(async ({ executeRetrieve }) => {\n        const version = fragment.services.settingsService.get(namespace, \"schema_version\");\n        await executeRetrieve();\n        return version;\n      });\n\n      return version ? parseInt(version.value, 10) : 0;\n    });\n    return version;\n  } catch {\n    return 0;\n  }\n}\n"],"mappings":"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"}

package/dist/hooks/hooks.d.ts

@@ -0,0 +1,51 @@
+import { RetryPolicy } from "../query/unit-of-work/retry-policy.js";
+
+//#region src/hooks/hooks.d.ts
+
+/**
+ * Context available in hook functions via `this`.
+ * Contains the nonce for idempotency and database access.
+ */
+interface HookContext {
+  /**
+   * Unique nonce for this transaction.
+   * Use this for idempotency checks in your hook implementation.
+   */
+  nonce: string;
+}
+/**
+ * A hook function signature.
+ * Hooks receive a typed payload and access context via `this`.
+ */
+type HookFn<TPayload = unknown> = (payload: TPayload) => void | Promise<void>;
+/**
+ * Map of hook names to hook functions.
+ * Used for type-safe hook definitions and triggering.
+ */
+type HooksMap = Record<string, HookFn<any>>;
+/**
+ * Extract the payload type from a hook function.
+ */
+type HookPayload<T> = T extends HookFn<infer P> ? P : never;
+/**
+ * Options for triggering a hook.
+ */
+interface TriggerHookOptions {
+  /**
+   * Optional retry policy override for this specific hook trigger.
+   * If not provided, uses the default retry policy.
+   */
+  retryPolicy?: RetryPolicy;
+}
+/**
+ * Internal representation of a triggered hook.
+ * Stored in the Unit of Work before execution.
+ */
+interface TriggeredHook {
+  hookName: string;
+  payload: unknown;
+  options?: TriggerHookOptions;
+}
+//#endregion
+export { HookContext, HookFn, HookPayload, HooksMap, TriggerHookOptions, TriggeredHook };
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","names":[],"sources":["../../src/hooks/hooks.ts"],"sourcesContent":[],"mappings":";;;;AASA;AAYA;AAOA;AAKA;AAA6B,UAxBZ,WAAA,CAwBY;EAAU;;;AAKvC;EAYiB,KAAA,EAAA,MAAA;;;;;;KA7BL,uCAAuC,oBAAoB;;;;;KAO3D,QAAA,GAAW,eAAe;;;;KAK1B,iBAAiB,UAAU,kBAAkB;;;;UAKxC,kBAAA;;;;;gBAKD;;;;;;UAOC,aAAA;;;YAGL"}

package/dist/hooks/hooks.js

@@ -0,0 +1,88 @@
+import { ExponentialBackoffRetryPolicy } from "../query/unit-of-work/retry-policy.js";
+
+//#region src/hooks/hooks.ts
+/**
+* Add hook events as mutation operations to the UOW.
+* This should be called before executeMutations() so hook records are created
+* in the same transaction as the user's mutations.
+*/
+function prepareHookMutations(uow, config) {
+	const { namespace, internalFragment, defaultRetryPolicy } = config;
+	const retryPolicy = defaultRetryPolicy ?? new ExponentialBackoffRetryPolicy({ maxRetries: 5 });
+	const triggeredHooks = uow.getTriggeredHooks();
+	if (triggeredHooks.length === 0) return;
+	const internalSchema = internalFragment.$internal.deps.schema;
+	const internalUow = uow.forSchema(internalSchema);
+	for (const hook of triggeredHooks) {
+		const maxAttempts = (hook.options?.retryPolicy ?? retryPolicy).shouldRetry(4) ? 5 : 1;
+		internalUow.create("fragno_hooks", {
+			namespace,
+			hookName: hook.hookName,
+			payload: hook.payload,
+			status: "pending",
+			attempts: 0,
+			maxAttempts,
+			lastAttemptAt: null,
+			nextRetryAt: null,
+			error: null,
+			nonce: uow.nonce
+		});
+	}
+}
+/**
+* Process pending hook events after the transaction has committed.
+* This should be called in the onSuccess callback after executeMutations().
+*/
+async function processHooks(config) {
+	const { hooks, namespace, internalFragment, defaultRetryPolicy } = config;
+	const retryPolicy = defaultRetryPolicy ?? new ExponentialBackoffRetryPolicy({ maxRetries: 5 });
+	await internalFragment.inContext(async function() {
+		return await this.uow(async ({ executeRetrieve, executeMutate }) => {
+			const pendingEventsPromise = internalFragment.services.hookService.getPendingHookEvents(namespace);
+			await executeRetrieve();
+			const pendingEvents = await pendingEventsPromise;
+			if (pendingEvents.length === 0) return;
+			const processedEvents = await Promise.allSettled(pendingEvents.map(async (event) => {
+				const hookFn = hooks[event.hookName];
+				if (!hookFn) return {
+					eventId: event.id,
+					status: "failed",
+					error: `Hook '${event.hookName}' not found in hooks map`,
+					attempts: event.attempts,
+					maxAttempts: event.maxAttempts
+				};
+				try {
+					const hookContext = { nonce: event.nonce };
+					await hookFn.call(hookContext, event.payload);
+					return {
+						eventId: event.id,
+						status: "completed"
+					};
+				} catch (error) {
+					const errorMessage = error instanceof Error ? error.message : String(error);
+					return {
+						eventId: event.id,
+						status: "failed",
+						error: errorMessage,
+						attempts: event.attempts,
+						maxAttempts: event.maxAttempts
+					};
+				}
+			}));
+			for (const processedEvent of processedEvents) {
+				if (processedEvent.status === "rejected") continue;
+				const { eventId, status } = processedEvent.value;
+				if (status === "completed") internalFragment.services.hookService.markHookCompleted(eventId);
+				else if (status === "failed") {
+					const { error, attempts } = processedEvent.value;
+					internalFragment.services.hookService.markHookFailed(eventId, error, attempts, retryPolicy);
+				}
+			}
+			await executeMutate();
+		});
+	});
+}
+
+//#endregion
+export { prepareHookMutations, processHooks };
+//# sourceMappingURL=hooks.js.map

package/dist/hooks/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","names":["hookContext: HookContext"],"sources":["../../src/hooks/hooks.ts"],"sourcesContent":["import type { RetryPolicy } from \"../query/unit-of-work/retry-policy\";\nimport { ExponentialBackoffRetryPolicy } from \"../query/unit-of-work/retry-policy\";\nimport type { IUnitOfWork } from \"../query/unit-of-work/unit-of-work\";\nimport type { InternalFragmentInstance } from \"../fragments/internal-fragment\";\n\n/**\n * Context available in hook functions via `this`.\n * Contains the nonce for idempotency and database access.\n */\nexport interface HookContext {\n  /**\n   * Unique nonce for this transaction.\n   * Use this for idempotency checks in your hook implementation.\n   */\n  nonce: string;\n}\n\n/**\n * A hook function signature.\n * Hooks receive a typed payload and access context via `this`.\n */\nexport type HookFn<TPayload = unknown> = (payload: TPayload) => void | Promise<void>;\n\n/**\n * Map of hook names to hook functions.\n * Used for type-safe hook definitions and triggering.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type HooksMap = Record<string, HookFn<any>>;\n\n/**\n * Extract the payload type from a hook function.\n */\nexport type HookPayload<T> = T extends HookFn<infer P> ? P : never;\n\n/**\n * Options for triggering a hook.\n */\nexport interface TriggerHookOptions {\n  /**\n   * Optional retry policy override for this specific hook trigger.\n   * If not provided, uses the default retry policy.\n   */\n  retryPolicy?: RetryPolicy;\n}\n\n/**\n * Internal representation of a triggered hook.\n * Stored in the Unit of Work before execution.\n */\nexport interface TriggeredHook {\n  hookName: string;\n  payload: unknown;\n  options?: TriggerHookOptions;\n}\n\n/**\n * Configuration for hook processing.\n */\nexport interface HookProcessorConfig {\n  hooks: HooksMap;\n  namespace: string;\n  internalFragment: InternalFragmentInstance;\n  defaultRetryPolicy?: RetryPolicy;\n}\n\n/**\n * Add hook events as mutation operations to the UOW.\n * This should be called before executeMutations() so hook records are created\n * in the same transaction as the user's mutations.\n */\nexport function prepareHookMutations(uow: IUnitOfWork, config: HookProcessorConfig): void {\n  const { namespace, internalFragment, defaultRetryPolicy } = config;\n  const retryPolicy = defaultRetryPolicy ?? new ExponentialBackoffRetryPolicy({ maxRetries: 5 });\n\n  const triggeredHooks = uow.getTriggeredHooks();\n\n  if (triggeredHooks.length === 0) {\n    return;\n  }\n\n  const internalSchema = internalFragment.$internal.deps.schema;\n  const internalUow = uow.forSchema(internalSchema);\n\n  for (const hook of triggeredHooks) {\n    const hookRetryPolicy = hook.options?.retryPolicy ?? retryPolicy;\n    const maxAttempts = hookRetryPolicy.shouldRetry(4) ? 5 : 1;\n    internalUow.create(\"fragno_hooks\", {\n      namespace,\n      hookName: hook.hookName,\n      payload: hook.payload,\n      status: \"pending\",\n      attempts: 0,\n      maxAttempts,\n      lastAttemptAt: null,\n      nextRetryAt: null,\n      error: null,\n      nonce: uow.nonce,\n    });\n  }\n}\n\n/**\n * Process pending hook events after the transaction has committed.\n * This should be called in the onSuccess callback after executeMutations().\n */\nexport async function processHooks(config: HookProcessorConfig): Promise<void> {\n  const { hooks, namespace, internalFragment, defaultRetryPolicy } = config;\n  const retryPolicy = defaultRetryPolicy ?? new ExponentialBackoffRetryPolicy({ maxRetries: 5 });\n\n  await internalFragment.inContext(async function () {\n    return await this.uow(async ({ executeRetrieve, executeMutate }) => {\n      const pendingEventsPromise =\n        internalFragment.services.hookService.getPendingHookEvents(namespace);\n      await executeRetrieve();\n\n      const pendingEvents = await pendingEventsPromise;\n\n      if (pendingEvents.length === 0) {\n        return;\n      }\n\n      const processedEvents = await Promise.allSettled(\n        pendingEvents.map(async (event) => {\n          const hookFn = hooks[event.hookName];\n          if (!hookFn) {\n            return {\n              eventId: event.id,\n              status: \"failed\" as const,\n              error: `Hook '${event.hookName}' not found in hooks map`,\n              attempts: event.attempts,\n              maxAttempts: event.maxAttempts,\n            };\n          }\n\n          try {\n            const hookContext: HookContext = { nonce: event.nonce };\n            await hookFn.call(hookContext, event.payload);\n            return {\n              eventId: event.id,\n              status: \"completed\" as const,\n            };\n          } catch (error) {\n            const errorMessage = error instanceof Error ? error.message : String(error);\n            return {\n              eventId: event.id,\n              status: \"failed\" as const,\n              error: errorMessage,\n              attempts: event.attempts,\n              maxAttempts: event.maxAttempts,\n            };\n          }\n        }),\n      );\n\n      for (const processedEvent of processedEvents) {\n        if (processedEvent.status === \"rejected\") {\n          continue;\n        }\n\n        const { eventId, status } = processedEvent.value;\n\n        if (status === \"completed\") {\n          internalFragment.services.hookService.markHookCompleted(eventId);\n        } else if (status === \"failed\") {\n          const { error, attempts } = processedEvent.value;\n          internalFragment.services.hookService.markHookFailed(\n            eventId,\n            error,\n            attempts,\n            retryPolicy,\n          );\n        }\n      }\n\n      await executeMutate();\n    });\n  });\n}\n"],"mappings":";;;;;;;;AAuEA,SAAgB,qBAAqB,KAAkB,QAAmC;CACxF,MAAM,EAAE,WAAW,kBAAkB,uBAAuB;CAC5D,MAAM,cAAc,sBAAsB,IAAI,8BAA8B,EAAE,YAAY,GAAG,CAAC;CAE9F,MAAM,iBAAiB,IAAI,mBAAmB;AAE9C,KAAI,eAAe,WAAW,EAC5B;CAGF,MAAM,iBAAiB,iBAAiB,UAAU,KAAK;CACvD,MAAM,cAAc,IAAI,UAAU,eAAe;AAEjD,MAAK,MAAM,QAAQ,gBAAgB;EAEjC,MAAM,eADkB,KAAK,SAAS,eAAe,aACjB,YAAY,EAAE,GAAG,IAAI;AACzD,cAAY,OAAO,gBAAgB;GACjC;GACA,UAAU,KAAK;GACf,SAAS,KAAK;GACd,QAAQ;GACR,UAAU;GACV;GACA,eAAe;GACf,aAAa;GACb,OAAO;GACP,OAAO,IAAI;GACZ,CAAC;;;;;;;AAQN,eAAsB,aAAa,QAA4C;CAC7E,MAAM,EAAE,OAAO,WAAW,kBAAkB,uBAAuB;CACnE,MAAM,cAAc,sBAAsB,IAAI,8BAA8B,EAAE,YAAY,GAAG,CAAC;AAE9F,OAAM,iBAAiB,UAAU,iBAAkB;AACjD,SAAO,MAAM,KAAK,IAAI,OAAO,EAAE,iBAAiB,oBAAoB;GAClE,MAAM,uBACJ,iBAAiB,SAAS,YAAY,qBAAqB,UAAU;AACvE,SAAM,iBAAiB;GAEvB,MAAM,gBAAgB,MAAM;AAE5B,OAAI,cAAc,WAAW,EAC3B;GAGF,MAAM,kBAAkB,MAAM,QAAQ,WACpC,cAAc,IAAI,OAAO,UAAU;IACjC,MAAM,SAAS,MAAM,MAAM;AAC3B,QAAI,CAAC,OACH,QAAO;KACL,SAAS,MAAM;KACf,QAAQ;KACR,OAAO,SAAS,MAAM,SAAS;KAC/B,UAAU,MAAM;KAChB,aAAa,MAAM;KACpB;AAGH,QAAI;KACF,MAAMA,cAA2B,EAAE,OAAO,MAAM,OAAO;AACvD,WAAM,OAAO,KAAK,aAAa,MAAM,QAAQ;AAC7C,YAAO;MACL,SAAS,MAAM;MACf,QAAQ;MACT;aACM,OAAO;KACd,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAC3E,YAAO;MACL,SAAS,MAAM;MACf,QAAQ;MACR,OAAO;MACP,UAAU,MAAM;MAChB,aAAa,MAAM;MACpB;;KAEH,CACH;AAED,QAAK,MAAM,kBAAkB,iBAAiB;AAC5C,QAAI,eAAe,WAAW,WAC5B;IAGF,MAAM,EAAE,SAAS,WAAW,eAAe;AAE3C,QAAI,WAAW,YACb,kBAAiB,SAAS,YAAY,kBAAkB,QAAQ;aACvD,WAAW,UAAU;KAC9B,MAAM,EAAE,OAAO,aAAa,eAAe;AAC3C,sBAAiB,SAAS,YAAY,eACpC,SACA,OACA,UACA,YACD;;;AAIL,SAAM,eAAe;IACrB;GACF"}

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

@@ -1,5 +1,4 @@
 import { AnySchema } from "../schema/create.js";
-import { PreparedMigration } from "./create.js";
 import { FragnoDatabase } from "../mod.js";
 
 //#region src/migration-engine/generation-engine.d.ts
@@ -14,7 +13,6 @@ interface GenerationInternalResult {
   namespace: string;
   fromVersion: number;
   toVersion: number;
-  preparedMigration?: PreparedMigration;
 }
 interface ExecuteMigrationResult {
   namespace: string;

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

@@ -1 +1 @@
-{"version":3,"file":"generation-engine.d.ts","names":[],"sources":["../../src/migration-engine/generation-engine.ts"],"sourcesContent":[],"mappings":";;;;;UAaiB,sBAAA;;EAAA,IAAA,EAAA,MAAA;EAMA,SAAA,EAAA,MAAA;AASjB;AAOsB,UAhBL,wBAAA,CAgB+B;EAEN,MAAA,EAAA,MAAA;EAAf,IAAA,EAAA,MAAA;EAEd,SAAA,EAAA,MAAA;EAMF,WAAA,EAAA,MAAA;EAAR,SAAA,EAAA,MAAA;EAAO,iBAAA,CAAA,EApBY,iBAoBZ;AAiJV;AAAgF,UAlK/D,sBAAA,CAkK+D;EAAf,SAAA,EAAA,MAAA;EACpD,UAAA,EAAA,OAAA;EACF,WAAA,EAAA,MAAA;EAAR,SAAA,EAAA,MAAA;;AAyIa,iBAtSM,0BAuSb,CAAA,yBArSkB,cAsSxB,CAtSuC,SAsSjB,EAAA,GAAA,CAAA,EAAA,CAAA,CAAA,SAAA,EApSZ,UAoSY,EAAA,QAAA,EAAA;;;;IA9RtB,QAAQ;;;;;;;;iBAiJW,2CAA2C,eAAe,yBACnE,aACV,QAAQ;;;;;;;;;;;iBAyIK,6BAAA,QACP,6BACN"}
+{"version":3,"file":"generation-engine.d.ts","names":[],"sources":["../../src/migration-engine/generation-engine.ts"],"sourcesContent":[],"mappings":";;;;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"}

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

@@ -1,5 +1,6 @@
+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_NAMESPACE, createSettingsManager, settingsSchema } from "../shared/settings-schema.js";
 
 //#region src/migration-engine/generation-engine.ts
 async function generateMigrationsOrSchema(databases, options) {
@@ -8,56 +9,48 @@ async function generateMigrationsOrSchema(databases, options) {
 	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 fragments = databases.map((db) => ({
+		const fragmentsMap = /* @__PURE__ */ new Map();
+		fragmentsMap.set("", {
+			schema: internalSchema,
+			namespace: ""
+		});
+		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());
 		return [{
-			...adapter.createSchemaGenerator(fragments, { path: options?.path }).generateSchema(),
+			...adapter.createSchemaGenerator(allFragments, { path: options?.path }).generateSchema(),
 			namespace: firstDb.namespace
 		}];
 	}
-	if (!adapter.createMigrationEngine) throw new Error("Adapter does not support migration-based schema generation. Ensure your adapter implements createMigrationEngine.");
+	if (!adapter.prepareMigrations) throw new Error("Adapter does not support migration-based schema 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 settingsManager = createSettingsManager(adapter.createQueryEngine(settingsSchema, ""), SETTINGS_NAMESPACE);
-	let settingsSourceVersion;
-	try {
-		const result = await settingsManager.get("version");
-		if (!result) settingsSourceVersion = 0;
-		else settingsSourceVersion = parseInt(result.value);
-	} catch {
-		settingsSourceVersion = 0;
-	}
+	const settingsSourceVersion = await getSchemaVersionFromDatabase(instantiate(internalFragmentDef).withConfig({}).withOptions({ databaseAdapter: adapter }).build(), SETTINGS_NAMESPACE);
 	const generatedFiles = [];
-	const settingsMigrator = adapter.createMigrationEngine(settingsSchema, SETTINGS_NAMESPACE);
-	const settingsTargetVersion = settingsSchema.version;
-	const settingsMigration = await settingsMigrator.prepareMigrationTo(settingsTargetVersion, { fromVersion: settingsSourceVersion });
-	if (!settingsMigration.getSQL) throw new Error("Migration engine does not support SQL generation. Ensure your adapter's migration engine provides getSQL().");
-	const settingsSql = settingsMigration.getSQL();
+	const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, "");
+	const settingsTargetVersion = internalSchema.version;
+	const settingsSql = settingsPreparedMigrations.getSQL(settingsSourceVersion, settingsTargetVersion);
 	if (settingsSql.trim()) generatedFiles.push({
 		schema: settingsSql,
 		path: "settings-migration.sql",
-		namespace: SETTINGS_NAMESPACE,
+		namespace: "",
 		fromVersion: settingsSourceVersion,
-		toVersion: settingsTargetVersion,
-		preparedMigration: settingsMigration
+		toVersion: settingsTargetVersion
 	});
 	for (const db of databases) {
 		const dbAdapter = db.adapter;
-		if (!dbAdapter.createMigrationEngine) throw new Error(`Adapter for ${db.namespace} does not support schema generation. Ensure your adapter implements either createSchemaGenerator or createMigrationEngine.`);
-		const migrator = dbAdapter.createMigrationEngine(db.schema, db.namespace);
+		if (!dbAdapter.prepareMigrations) throw new Error(`Adapter for ${db.namespace} does not support schema generation. Ensure your adapter implements either createSchemaGenerator or prepareMigrations.`);
+		const preparedMigrations = dbAdapter.prepareMigrations(db.schema, db.namespace);
 		const targetVersion = options?.toVersion ?? db.schema.version;
 		const sourceVersion = options?.fromVersion ?? 0;
-		const preparedMigration = await migrator.prepareMigrationTo(targetVersion, { fromVersion: sourceVersion });
-		if (!preparedMigration.getSQL) throw new Error("Migration engine does not support SQL generation. Ensure your adapter's migration engine provides getSQL().");
-		const sql = preparedMigration.getSQL();
+		const sql = preparedMigrations.getSQL(sourceVersion, targetVersion);
 		if (sql.trim()) generatedFiles.push({
 			schema: sql,
 			path: "schema.sql",
 			namespace: db.namespace,
 			fromVersion: sourceVersion,
-			toVersion: targetVersion,
-			preparedMigration
+			toVersion: targetVersion
 		});
 	}
 	return postProcessMigrationFilenames(generatedFiles);
@@ -72,7 +65,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.createMigrationEngine) 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 'generateMigrationsOrSchema' instead to generate schema files.");
 	const firstAdapterName = adapter[fragnoDatabaseAdapterNameFakeSymbol];
 	const firstAdapterVersion = adapter[fragnoDatabaseAdapterVersionFakeSymbol];
 	for (const db of databases) {
@@ -83,45 +76,34 @@ 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 settingsManager = createSettingsManager(adapter.createQueryEngine(settingsSchema, ""), SETTINGS_NAMESPACE);
-	let settingsSourceVersion;
-	try {
-		const result = await settingsManager.get("version");
-		settingsSourceVersion = result ? parseInt(result.value) : 0;
-	} catch {
-		settingsSourceVersion = 0;
-	}
-	const settingsMigrator = adapter.createMigrationEngine(settingsSchema, SETTINGS_NAMESPACE);
-	const settingsTargetVersion = settingsSchema.version;
+	const internalFragment = instantiate(internalFragmentDef).withConfig({}).withOptions({ databaseAdapter: adapter }).build();
+	const settingsSourceVersion = await getSchemaVersionFromDatabase(internalFragment, SETTINGS_NAMESPACE);
+	const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, "");
+	const settingsTargetVersion = internalSchema.version;
 	if (settingsSourceVersion < settingsTargetVersion) {
-		const settingsMigration = await settingsMigrator.prepareMigrationTo(settingsTargetVersion, {
-			fromVersion: settingsSourceVersion,
-			updateSettings: true
-		});
-		if (settingsMigration.operations.length > 0) migrationsToExecute.push({
-			namespace: SETTINGS_NAMESPACE,
+		if (settingsPreparedMigrations.compile(settingsSourceVersion, settingsTargetVersion, { updateVersionInMigration: true }).statements.length > 0) migrationsToExecute.push({
+			namespace: "",
 			fromVersion: settingsSourceVersion,
 			toVersion: settingsTargetVersion,
-			preparedMigration: settingsMigration
+			execute: () => settingsPreparedMigrations.execute(settingsSourceVersion, settingsTargetVersion, { updateVersionInMigration: true })
 		});
 	}
 	const sortedDatabases = [...databases].sort((a, b) => a.namespace.localeCompare(b.namespace));
 	for (const fragnoDb of sortedDatabases) {
-		const migrator = adapter.createMigrationEngine(fragnoDb.schema, fragnoDb.namespace);
-		const currentVersion = await migrator.getVersion();
+		const preparedMigrations = adapter.prepareMigrations(fragnoDb.schema, fragnoDb.namespace);
+		const currentVersion = await getSchemaVersionFromDatabase(internalFragment, fragnoDb.namespace);
 		const targetVersion = fragnoDb.schema.version;
 		if (currentVersion < targetVersion) {
-			const preparedMigration = await migrator.prepareMigrationTo(targetVersion, { updateSettings: true });
-			if (preparedMigration.operations.length > 0) migrationsToExecute.push({
+			if (preparedMigrations.compile(currentVersion, targetVersion, { updateVersionInMigration: true }).statements.length > 0) migrationsToExecute.push({
 				namespace: fragnoDb.namespace,
 				fromVersion: currentVersion,
 				toVersion: targetVersion,
-				preparedMigration
+				execute: () => preparedMigrations.execute(currentVersion, targetVersion, { updateVersionInMigration: true })
 			});
 		}
 	}
 	for (const migration of migrationsToExecute) {
-		await migration.preparedMigration.execute();
+		await migration.execute();
 		results.push({
 			namespace: migration.namespace,
 			didMigrate: true,
@@ -150,15 +132,15 @@ async function executeMigrations(databases) {
 function postProcessMigrationFilenames(files) {
 	if (files.length === 0) return [];
 	const sortedFiles = [...files].sort((a, b) => {
-		if (a.namespace === SETTINGS_NAMESPACE) return -1;
-		if (b.namespace === SETTINGS_NAMESPACE) return 1;
+		if (a.namespace === "") return -1;
+		if (b.namespace === "") return 1;
 		return a.namespace.localeCompare(b.namespace);
 	});
 	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.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.namespace === "" ? "fragno_db_settings" : file.namespace.replace(/[^a-z0-9-]/gi, "_")}.sql`;
 		return {
 			schema: file.schema,
 			path: newPath,

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

@@ -1 +1 @@
-{"version":3,"file":"generation-engine.js","names":["settingsSourceVersion: number","generatedFiles: GenerationInternalResult[]","results: ExecuteMigrationResult[]","migrationsToExecute: Array<{\n    namespace: string;\n    fromVersion: number;\n    toVersion: number;\n    preparedMigration: PreparedMigration;\n  }>"],"sources":["../../src/migration-engine/generation-engine.ts"],"sourcesContent":["import type { FragnoDatabase } from \"../mod\";\nimport type { AnySchema } from \"../schema/create\";\nimport type { PreparedMigration } from \"./create\";\nimport {\n  settingsSchema,\n  SETTINGS_NAMESPACE,\n  createSettingsManager,\n} from \"../shared/settings-schema\";\nimport {\n  fragnoDatabaseAdapterNameFakeSymbol,\n  fragnoDatabaseAdapterVersionFakeSymbol,\n} from \"../adapters/adapters\";\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  preparedMigration?: PreparedMigration;\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    const fragments = databases.map((db) => ({\n      schema: db.schema,\n      namespace: db.namespace,\n    }));\n\n    const generator = adapter.createSchemaGenerator(fragments, {\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)\n  if (!adapter.createMigrationEngine) {\n    throw new Error(\n      \"Adapter does not support migration-based schema generation. Ensure your adapter implements createMigrationEngine.\",\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 settingsQueryEngine = adapter.createQueryEngine(settingsSchema, \"\");\n  const settingsManager = createSettingsManager(settingsQueryEngine, SETTINGS_NAMESPACE);\n\n  let settingsSourceVersion: number;\n  try {\n    const result = await settingsManager.get(\"version\");\n\n    if (!result) {\n      settingsSourceVersion = 0;\n    } else {\n      settingsSourceVersion = parseInt(result.value);\n    }\n  } catch {\n    // We don't really have a way to verify this error happens because the key doesn't exist in the database\n    settingsSourceVersion = 0;\n  }\n\n  const generatedFiles: GenerationInternalResult[] = [];\n\n  const settingsMigrator = adapter.createMigrationEngine(settingsSchema, SETTINGS_NAMESPACE);\n  const settingsTargetVersion = settingsSchema.version;\n\n  // Generate settings table migration\n  const settingsMigration = await settingsMigrator.prepareMigrationTo(settingsTargetVersion, {\n    fromVersion: settingsSourceVersion,\n  });\n\n  if (!settingsMigration.getSQL) {\n    throw new Error(\n      \"Migration engine does not support SQL generation. Ensure your adapter's migration engine provides getSQL().\",\n    );\n  }\n\n  const settingsSql = settingsMigration.getSQL();\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: SETTINGS_NAMESPACE,\n      fromVersion: settingsSourceVersion,\n      toVersion: settingsTargetVersion,\n      preparedMigration: settingsMigration,\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.createMigrationEngine) {\n      throw new Error(\n        `Adapter for ${db.namespace} does not support schema generation. ` +\n          `Ensure your adapter implements either createSchemaGenerator or createMigrationEngine.`,\n      );\n    }\n\n    const migrator = dbAdapter.createMigrationEngine(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 preparedMigration = await migrator.prepareMigrationTo(targetVersion, {\n      fromVersion: sourceVersion,\n    });\n\n    if (!preparedMigration.getSQL) {\n      throw new Error(\n        \"Migration engine does not support SQL generation. Ensure your adapter's migration engine provides getSQL().\",\n      );\n    }\n\n    const sql = preparedMigration.getSQL();\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        preparedMigration: preparedMigration,\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.createMigrationEngine) {\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    preparedMigration: PreparedMigration;\n  }> = [];\n\n  // 1. Prepare settings table migration\n  const settingsQueryEngine = adapter.createQueryEngine(settingsSchema, \"\");\n  const settingsManager = createSettingsManager(settingsQueryEngine, SETTINGS_NAMESPACE);\n\n  let settingsSourceVersion: number;\n  try {\n    const result = await settingsManager.get(\"version\");\n    settingsSourceVersion = result ? parseInt(result.value) : 0;\n  } catch {\n    settingsSourceVersion = 0;\n  }\n\n  const settingsMigrator = adapter.createMigrationEngine(settingsSchema, SETTINGS_NAMESPACE);\n  const settingsTargetVersion = settingsSchema.version;\n\n  if (settingsSourceVersion < settingsTargetVersion) {\n    const settingsMigration = await settingsMigrator.prepareMigrationTo(settingsTargetVersion, {\n      fromVersion: settingsSourceVersion,\n      updateSettings: true,\n    });\n\n    if (settingsMigration.operations.length > 0) {\n      migrationsToExecute.push({\n        namespace: SETTINGS_NAMESPACE,\n        fromVersion: settingsSourceVersion,\n        toVersion: settingsTargetVersion,\n        preparedMigration: settingsMigration,\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 migrator = adapter.createMigrationEngine(fragnoDb.schema, fragnoDb.namespace);\n    const currentVersion = await migrator.getVersion();\n    const targetVersion = fragnoDb.schema.version;\n\n    if (currentVersion < targetVersion) {\n      const preparedMigration = await migrator.prepareMigrationTo(targetVersion, {\n        updateSettings: true,\n      });\n\n      if (preparedMigration.operations.length > 0) {\n        migrationsToExecute.push({\n          namespace: fragnoDb.namespace,\n          fromVersion: currentVersion,\n          toVersion: targetVersion,\n          preparedMigration: preparedMigration,\n        });\n      }\n    }\n  }\n\n  // 3. Execute all migrations in order\n  for (const migration of migrationsToExecute) {\n    await migration.preparedMigration.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, then alphabetically by namespace\n  const sortedFiles = [...files].sort((a, b) => {\n    if (a.namespace === SETTINGS_NAMESPACE) {\n      return -1;\n    }\n    if (b.namespace === SETTINGS_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    const safeName = 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;\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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"}