@fragno-dev/db 0.2.2 → 0.3.0

package/dist/hooks/hooks.js

@@ -1,6 +1,12 @@
 import { ExponentialBackoffRetryPolicy } from "../query/unit-of-work/retry-policy.js";
 
 //#region src/hooks/hooks.ts
+const DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES = 10;
+function resolveStuckProcessingTimeoutMinutes(value) {
+	if (value === false) return false;
+	if (typeof value === "number") return value > 0 ? value : false;
+	return DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES;
+}
 /**
 * Add hook events as mutation operations to the UOW.
 * This should be called before executeMutations() so hook records are created
@@ -15,6 +21,7 @@ function prepareHookMutations(uow, config) {
 	const internalUow = uow.forSchema(internalSchema);
 	for (const hook of triggeredHooks) {
 		const maxAttempts = (hook.options?.retryPolicy ?? retryPolicy).shouldRetry(4) ? 5 : 1;
+		const nextRetryAt = (hook.options?.processAt ? new Date(hook.options.processAt) : null) ?? null;
 		internalUow.create("fragno_hooks", {
 			namespace,
 			hookName: hook.hookName,
@@ -23,7 +30,7 @@ function prepareHookMutations(uow, config) {
 			attempts: 0,
 			maxAttempts,
 			lastAttemptAt: null,
-			nextRetryAt: null,
+			nextRetryAt,
 			error: null,
 			nonce: uow.idempotencyKey
 		});
@@ -36,10 +43,32 @@ function prepareHookMutations(uow, config) {
 async function processHooks(config) {
 	const { hooks, namespace, internalFragment, defaultRetryPolicy } = config;
 	const retryPolicy = defaultRetryPolicy ?? new ExponentialBackoffRetryPolicy({ maxRetries: 5 });
+	const stuckProcessingTimeoutMinutes = resolveStuckProcessingTimeoutMinutes(config.stuckProcessingTimeoutMinutes);
+	const getDbNow = async () => {
+		const services = internalFragment.services;
+		if (services.getDbNow) return services.getDbNow();
+		return /* @__PURE__ */ new Date();
+	};
+	const dbNow = await getDbNow();
+	if (stuckProcessingTimeoutMinutes !== false) {
+		const staleBefore = /* @__PURE__ */ new Date(dbNow.getTime() - stuckProcessingTimeoutMinutes * 6e4);
+		const stuckEvents = await internalFragment.inContext(async function() {
+			return await this.handlerTx().withServiceCalls(() => [internalFragment.services.hookService.requeueStuckProcessingHooks(namespace, staleBefore)]).transform(({ serviceResult: [events] }) => events).execute();
+		});
+		if (stuckEvents.length > 0) try {
+			config.onStuckProcessingHooks?.({
+				namespace,
+				timeoutMinutes: stuckProcessingTimeoutMinutes,
+				events: stuckEvents
+			});
+		} catch (error) {
+			console.error("Error calling onStuckProcessingHooks", error);
+		}
+	}
 	const pendingEvents = await internalFragment.inContext(async function() {
-		return await this.handlerTx().withServiceCalls(() => [internalFragment.services.hookService.getPendingHookEvents(namespace)]).transform(({ serviceResult: [events] }) => events).execute();
+		return await this.handlerTx().withServiceCalls(() => [internalFragment.services.hookService.claimPendingHookEvents(namespace)]).transform(({ serviceResult: [events] }) => events).execute();
 	});
-	if (pendingEvents.length === 0) return;
+	if (pendingEvents.length === 0) return 0;
 	const processedEvents = await Promise.allSettled(pendingEvents.map(async (event) => {
 		const hookFn = hooks[event.hookName];
 		if (!hookFn) return {
@@ -50,7 +79,10 @@ async function processHooks(config) {
 			maxAttempts: event.maxAttempts
 		};
 		try {
-			const hookContext = { idempotencyKey: event.idempotencyKey };
+			const hookContext = {
+				idempotencyKey: event.idempotencyKey,
+				handlerTx: config.handlerTx
+			};
 			await hookFn.call(hookContext, event.payload);
 			return {
 				eventId: event.id,
@@ -76,14 +108,48 @@ async function processHooks(config) {
 				if (status === "completed") txResults.push(internalFragment.services.hookService.markHookCompleted(eventId));
 				else if (status === "failed") {
 					const { error, attempts } = processedEvent.value;
-					txResults.push(internalFragment.services.hookService.markHookFailed(eventId, error, attempts, retryPolicy));
+					txResults.push(internalFragment.services.hookService.markHookFailed(eventId, error, attempts, retryPolicy, dbNow));
 				}
 			}
 			return txResults;
 		}).execute();
 	});
+	return processedEvents.reduce((count, result) => count + (result.status === "fulfilled" ? 1 : 0), 0);
+}
+function createHookScheduler(config) {
+	let processing = false;
+	let queued = false;
+	let currentPromise = null;
+	const schedule = async () => {
+		if (processing) {
+			queued = true;
+			return currentPromise ?? Promise.resolve(0);
+		}
+		processing = true;
+		currentPromise = (async () => {
+			let lastCount = 0;
+			try {
+				do {
+					queued = false;
+					lastCount = await processHooks(config);
+				} while (queued);
+				return lastCount;
+			} finally {
+				processing = false;
+				queued = false;
+			}
+		})();
+		return currentPromise;
+	};
+	const drain = async () => {
+		while (true) if (await schedule() === 0) return;
+	};
+	return {
+		schedule,
+		drain
+	};
 }
 
 //#endregion
-export { prepareHookMutations, processHooks };
+export { createHookScheduler, prepareHookMutations };
 //# sourceMappingURL=hooks.js.map

package/dist/hooks/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","names":["hookContext: HookContext","txResults: TxResult<void>[]"],"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\";\nimport type { TxResult } from \"../query/unit-of-work/execute-unit-of-work\";\n\n/**\n * Context available in hook functions via `this`.\n * Contains the idempotency key for idempotency and database access.\n */\nexport interface HookContext {\n  /**\n   * Unique idempotency key for this transaction.\n   * Use this for idempotency checks in your hook implementation.\n   */\n  idempotencyKey: 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.idempotencyKey,\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  // Get pending events\n  const pendingEvents = await internalFragment.inContext(async function () {\n    return await this.handlerTx()\n      .withServiceCalls(\n        () => [internalFragment.services.hookService.getPendingHookEvents(namespace)] as const,\n      )\n      .transform(({ serviceResult: [events] }) => events)\n      .execute();\n  });\n\n  if (pendingEvents.length === 0) {\n    return;\n  }\n\n  // Process events (async work outside transaction)\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 = { idempotencyKey: event.idempotencyKey };\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  // Mark events as completed/failed\n  await internalFragment.inContext(async function () {\n    await this.handlerTx()\n      .withServiceCalls(() => {\n        const txResults: TxResult<void>[] = [];\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            txResults.push(internalFragment.services.hookService.markHookCompleted(eventId));\n          } else if (status === \"failed\") {\n            const { error, attempts } = processedEvent.value;\n            txResults.push(\n              internalFragment.services.hookService.markHookFailed(\n                eventId,\n                error,\n                attempts,\n                retryPolicy,\n              ),\n            );\n          }\n        }\n        return txResults;\n      })\n      .execute();\n  });\n}\n"],"mappings":";;;;;;;;AAwEA,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;CAG9F,MAAM,gBAAgB,MAAM,iBAAiB,UAAU,iBAAkB;AACvE,SAAO,MAAM,KAAK,WAAW,CAC1B,uBACO,CAAC,iBAAiB,SAAS,YAAY,qBAAqB,UAAU,CAAC,CAC9E,CACA,WAAW,EAAE,eAAe,CAAC,cAAc,OAAO,CAClD,SAAS;GACZ;AAEF,KAAI,cAAc,WAAW,EAC3B;CAIF,MAAM,kBAAkB,MAAM,QAAQ,WACpC,cAAc,IAAI,OAAO,UAAU;EACjC,MAAM,SAAS,MAAM,MAAM;AAC3B,MAAI,CAAC,OACH,QAAO;GACL,SAAS,MAAM;GACf,QAAQ;GACR,OAAO,SAAS,MAAM,SAAS;GAC/B,UAAU,MAAM;GAChB,aAAa,MAAM;GACpB;AAGH,MAAI;GACF,MAAMA,cAA2B,EAAE,gBAAgB,MAAM,gBAAgB;AACzE,SAAM,OAAO,KAAK,aAAa,MAAM,QAAQ;AAC7C,UAAO;IACL,SAAS,MAAM;IACf,QAAQ;IACT;WACM,OAAO;GACd,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAC3E,UAAO;IACL,SAAS,MAAM;IACf,QAAQ;IACR,OAAO;IACP,UAAU,MAAM;IAChB,aAAa,MAAM;IACpB;;GAEH,CACH;AAGD,OAAM,iBAAiB,UAAU,iBAAkB;AACjD,QAAM,KAAK,WAAW,CACnB,uBAAuB;GACtB,MAAMC,YAA8B,EAAE;AACtC,QAAK,MAAM,kBAAkB,iBAAiB;AAC5C,QAAI,eAAe,WAAW,WAC5B;IAGF,MAAM,EAAE,SAAS,WAAW,eAAe;AAE3C,QAAI,WAAW,YACb,WAAU,KAAK,iBAAiB,SAAS,YAAY,kBAAkB,QAAQ,CAAC;aACvE,WAAW,UAAU;KAC9B,MAAM,EAAE,OAAO,aAAa,eAAe;AAC3C,eAAU,KACR,iBAAiB,SAAS,YAAY,eACpC,SACA,OACA,UACA,YACD,CACF;;;AAGL,UAAO;IACP,CACD,SAAS;GACZ"}
+{"version":3,"file":"hooks.js","names":["hookContext: HookContext","txResults: TxResult<void>[]","currentPromise: Promise<number> | null"],"sources":["../../src/hooks/hooks.ts"],"sourcesContent":["import type {\n  ExecuteTxOptions,\n  HandlerTxBuilder,\n} from \"../query/unit-of-work/execute-unit-of-work\";\nimport 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\";\nimport type { TxResult } from \"../query/unit-of-work/execute-unit-of-work\";\nimport type { FragnoId } from \"../schema/create\";\n\n/**\n * Context available in hook functions via `this`.\n * Contains the idempotency key for idempotency and database access.\n */\nexport interface HookContext {\n  /**\n   * Unique idempotency key for this transaction.\n   * Use this for idempotency checks in your hook implementation.\n   */\n  idempotencyKey: string;\n  /**\n   * Create a handler transaction builder to run atomic operations.\n   */\n  handlerTx: HookHandlerTx;\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   * Absolute time for the first attempt. If in the future, the hook is\n   * scheduled for that time; if in the past, it runs immediately.\n   */\n  processAt?: Date;\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\nexport type HookScheduler = {\n  schedule: () => Promise<number>;\n  drain: () => Promise<void>;\n};\n\n/**\n * Configuration for hook processing.\n */\nexport interface HookProcessorConfig<THooks extends HooksMap = HooksMap> {\n  hooks: THooks;\n  namespace: string;\n  internalFragment: InternalFragmentInstance;\n  handlerTx: HookHandlerTx;\n  /**\n   * Internal hook scheduler used to coordinate processing/drain.\n   */\n  scheduler?: HookScheduler;\n  defaultRetryPolicy?: RetryPolicy;\n  /**\n   * Re-queue hooks that have been in `processing` for at least this many minutes.\n   * Use `false` to disable stuck-processing recovery entirely.\n   * Values <= 0 are treated as `false`.\n   *\n   * Default: 10 minutes.\n   */\n  stuckProcessingTimeoutMinutes?: StuckHookProcessingTimeoutMinutes;\n  /**\n   * Called when stuck processing hooks are detected and re-queued.\n   * Invoked after the hooks are moved back to `pending`.\n   */\n  onStuckProcessingHooks?: (info: StuckHookProcessingInfo) => void;\n}\n\nexport type StuckHookProcessingTimeoutMinutes = number | false;\n\nexport type StuckHookProcessingEvent = {\n  id: FragnoId;\n  hookName: string;\n  attempts: number;\n  maxAttempts: number;\n  lastAttemptAt: Date | null;\n  nextRetryAt: Date | null;\n};\n\nexport type StuckHookProcessingInfo = {\n  namespace: string;\n  timeoutMinutes: number;\n  events: StuckHookProcessingEvent[];\n};\n\nexport type DurableHooksProcessingOptions = {\n  /**\n   * Re-queue hooks that have been in `processing` for at least this many minutes.\n   * Use `false` to disable stuck-processing recovery entirely.\n   * Values <= 0 are treated as `false`.\n   *\n   * Default: 10 minutes.\n   */\n  stuckProcessingTimeoutMinutes?: StuckHookProcessingTimeoutMinutes;\n  /**\n   * Called when stuck processing hooks are detected and re-queued.\n   * Invoked after the hooks are moved back to `pending`.\n   */\n  onStuckProcessingHooks?: (info: StuckHookProcessingInfo) => void;\n};\n\nexport type HookHandlerTx = (\n  execOptions?: Omit<ExecuteTxOptions, \"createUnitOfWork\">,\n) => HandlerTxBuilder<readonly [], [], [], unknown, unknown, false, false, false, false, HooksMap>;\n\nconst DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES = 10;\n\nfunction resolveStuckProcessingTimeoutMinutes(\n  value: StuckHookProcessingTimeoutMinutes | undefined,\n): number | false {\n  if (value === false) {\n    return false;\n  }\n  if (typeof value === \"number\") {\n    return value > 0 ? value : false;\n  }\n  return DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES;\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<THooks extends HooksMap>(\n  uow: IUnitOfWork,\n  config: HookProcessorConfig<THooks>,\n): 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    const processAt = hook.options?.processAt ? new Date(hook.options.processAt) : null;\n    const nextRetryAt = processAt ?? null;\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,\n      error: null,\n      nonce: uow.idempotencyKey,\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<THooks extends HooksMap>(\n  config: HookProcessorConfig<THooks>,\n): Promise<number> {\n  const { hooks, namespace, internalFragment, defaultRetryPolicy } = config;\n  const retryPolicy = defaultRetryPolicy ?? new ExponentialBackoffRetryPolicy({ maxRetries: 5 });\n  const stuckProcessingTimeoutMinutes = resolveStuckProcessingTimeoutMinutes(\n    config.stuckProcessingTimeoutMinutes,\n  );\n  const getDbNow = async () => {\n    const services = internalFragment.services as { getDbNow?: () => Promise<Date> };\n    if (services.getDbNow) {\n      return services.getDbNow();\n    }\n    return new Date();\n  };\n  const dbNow = await getDbNow();\n\n  if (stuckProcessingTimeoutMinutes !== false) {\n    const staleBefore = new Date(dbNow.getTime() - stuckProcessingTimeoutMinutes * 60_000);\n    const stuckEvents = await internalFragment.inContext(async function () {\n      return await this.handlerTx()\n        .withServiceCalls(\n          () =>\n            [\n              internalFragment.services.hookService.requeueStuckProcessingHooks(\n                namespace,\n                staleBefore,\n              ),\n            ] as const,\n        )\n        .transform(({ serviceResult: [events] }) => events)\n        .execute();\n    });\n\n    if (stuckEvents.length > 0) {\n      try {\n        config.onStuckProcessingHooks?.({\n          namespace,\n          timeoutMinutes: stuckProcessingTimeoutMinutes,\n          events: stuckEvents,\n        });\n      } catch (error) {\n        console.error(\"Error calling onStuckProcessingHooks\", error);\n      }\n    }\n  }\n\n  // Claim pending events in the same transaction to avoid double-processing.\n  const pendingEvents = await internalFragment.inContext(async function () {\n    return await this.handlerTx()\n      .withServiceCalls(\n        () => [internalFragment.services.hookService.claimPendingHookEvents(namespace)] as const,\n      )\n      .transform(({ serviceResult: [events] }) => events)\n      .execute();\n  });\n\n  if (pendingEvents.length === 0) {\n    return 0;\n  }\n\n  // Process events (async work outside transaction)\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 = {\n          idempotencyKey: event.idempotencyKey,\n          handlerTx: config.handlerTx,\n        };\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  // Mark events as completed/failed\n  await internalFragment.inContext(async function () {\n    await this.handlerTx()\n      .withServiceCalls(() => {\n        const txResults: TxResult<void>[] = [];\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            txResults.push(internalFragment.services.hookService.markHookCompleted(eventId));\n          } else if (status === \"failed\") {\n            const { error, attempts } = processedEvent.value;\n            txResults.push(\n              internalFragment.services.hookService.markHookFailed(\n                eventId,\n                error,\n                attempts,\n                retryPolicy,\n                dbNow,\n              ),\n            );\n          }\n        }\n        return txResults;\n      })\n      .execute();\n  });\n\n  const processedCount = processedEvents.reduce(\n    (count, result) => count + (result.status === \"fulfilled\" ? 1 : 0),\n    0,\n  );\n\n  return processedCount;\n}\n\nexport function createHookScheduler(config: HookProcessorConfig): HookScheduler {\n  let processing = false;\n  let queued = false;\n  let currentPromise: Promise<number> | null = null;\n\n  const schedule = async () => {\n    if (processing) {\n      queued = true;\n      return currentPromise ?? Promise.resolve(0);\n    }\n\n    processing = true;\n    currentPromise = (async () => {\n      let lastCount = 0;\n      try {\n        do {\n          queued = false;\n          lastCount = await processHooks(config);\n        } while (queued);\n        return lastCount;\n      } finally {\n        processing = false;\n        queued = false;\n      }\n    })();\n\n    return currentPromise;\n  };\n\n  const drain = async () => {\n    while (true) {\n      const processed = await schedule();\n      if (processed === 0) {\n        return;\n      }\n    }\n  };\n\n  return { schedule, drain };\n}\n"],"mappings":"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"}

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

@@ -16,7 +16,7 @@ import "../schema/create.js";
 *
 * @example
 * ```ts
-* const mySchema = schema(s => s
+* const mySchema = schema("my", s => s
 *   .addTable("users", t => t.addColumn("id", idColumn()))       // version 1
 *   .addTable("posts", t => t.addColumn("id", idColumn()))       // version 2
 * );
@@ -92,16 +92,19 @@ function generateMigrationFromSchema(targetSchema, fromVersion, toVersion) {
 			columns: subOp.columns,
 			unique: subOp.unique
 		});
-	} else if (op.type === "add-reference") migrationOperations.push({
-		type: "add-foreign-key",
-		table: op.tableName,
-		value: {
-			name: `${op.tableName}_${op.config.to.table}_${op.referenceName}_fk`,
-			columns: [op.config.from.column],
-			referencedTable: op.config.to.table,
-			referencedColumns: [op.config.to.column]
-		}
-	});
+	} else if (op.type === "add-reference") {
+		if (!op.referenceName || op.referenceName.trim().length === 0) throw new Error(`referenceName is required for add-reference on ${op.tableName}`);
+		migrationOperations.push({
+			type: "add-foreign-key",
+			table: op.tableName,
+			value: {
+				name: op.referenceName,
+				columns: [op.config.from.column],
+				referencedTable: op.config.to.table,
+				referencedColumns: [op.config.to.column]
+			}
+		});
+	}
 	return migrationOperations;
 }
 

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

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

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

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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"generation-engine.js","names":["generatedFiles: GenerationInternalResult[]","results: ExecuteMigrationResult[]","migrationsToExecute: Array<{\n    namespace: string;\n    fromVersion: number;\n    toVersion: number;\n    execute: () => Promise<void>;\n  }>"],"sources":["../../src/migration-engine/generation-engine.ts"],"sourcesContent":["import type { FragnoDatabase } from \"../mod\";\nimport type { AnySchema } from \"../schema/create\";\nimport {\n  fragnoDatabaseAdapterNameFakeSymbol,\n  fragnoDatabaseAdapterVersionFakeSymbol,\n} from \"../adapters/adapters\";\nimport {\n  internalFragmentDef,\n  internalSchema,\n  SETTINGS_NAMESPACE,\n  getSchemaVersionFromDatabase,\n} from \"../fragments/internal-fragment\";\nimport { instantiate } from \"@fragno-dev/core\";\n\nexport interface GenerationEngineResult {\n  schema: string;\n  path: string;\n  namespace: string;\n}\n\nexport interface GenerationInternalResult {\n  schema: string;\n  path: string;\n  namespace: string;\n  fromVersion: number;\n  toVersion: number;\n}\n\nexport interface ExecuteMigrationResult {\n  namespace: string;\n  didMigrate: boolean;\n  fromVersion: number;\n  toVersion: number;\n}\n\nexport async function generateMigrationsOrSchema<\n  // oxlint-disable-next-line no-explicit-any\n  const TDatabases extends FragnoDatabase<AnySchema, any>[],\n>(\n  databases: TDatabases,\n  options?: {\n    path?: string;\n    toVersion?: number;\n    fromVersion?: number;\n  },\n): Promise<GenerationEngineResult[]> {\n  if (databases.length === 0) {\n    throw new Error(\"No databases provided for schema generation\");\n  }\n\n  const firstDb = databases[0];\n  const adapter = firstDb.adapter;\n\n  // If adapter has createSchemaGenerator, use it for combined generation (e.g., Drizzle)\n  if (adapter.createSchemaGenerator) {\n    if (options?.toVersion !== undefined || options?.fromVersion !== undefined) {\n      console.warn(\n        \"⚠️ Warning: --from and --to version options are not supported when generating schemas for multiple fragments and will be ignored.\",\n      );\n    }\n\n    // Collect all schemas, de-duplicating by namespace.\n    // The internal fragment (settings schema) is always included first since all database\n    // fragments automatically link to it via withDatabase().\n    const fragmentsMap = new Map<string, { schema: AnySchema; namespace: string }>();\n\n    // Include internal fragment first with empty namespace (settings table has no prefix)\n    fragmentsMap.set(\"\", {\n      schema: internalSchema,\n      namespace: \"\",\n    });\n\n    // Add user fragments, de-duplicating by namespace\n    // Each FragnoDatabase has a unique namespace, so this prevents duplicate schema generation\n    for (const db of databases) {\n      if (!fragmentsMap.has(db.namespace)) {\n        fragmentsMap.set(db.namespace, {\n          schema: db.schema,\n          namespace: db.namespace,\n        });\n      }\n    }\n\n    const allFragments = Array.from(fragmentsMap.values());\n    const generator = adapter.createSchemaGenerator(allFragments, {\n      path: options?.path,\n    });\n\n    return [\n      {\n        ...generator.generateSchema(),\n        namespace: firstDb.namespace,\n      },\n    ];\n  }\n\n  // Otherwise, use migration engine for individual generation (e.g., Kysely, GenericSQL)\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Adapter does not support migration-based schema generation. Ensure your adapter implements prepareMigrations.\",\n    );\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  // Use the internal fragment for settings management\n  const internalFragment = instantiate(internalFragmentDef)\n    .withConfig({})\n    .withOptions({ databaseAdapter: adapter })\n    .build();\n\n  const settingsSourceVersion = await getSchemaVersionFromDatabase(\n    internalFragment,\n    SETTINGS_NAMESPACE,\n  );\n\n  const generatedFiles: GenerationInternalResult[] = [];\n\n  // Use empty namespace for settings (SETTINGS_NAMESPACE is for prefixing keys, not the database namespace)\n  const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, \"\");\n  const settingsTargetVersion = internalSchema.version;\n\n  // Generate settings table migration\n  const settingsSql = settingsPreparedMigrations.getSQL(\n    settingsSourceVersion,\n    settingsTargetVersion,\n  );\n\n  if (settingsSql.trim()) {\n    generatedFiles.push({\n      schema: settingsSql,\n      path: \"settings-migration.sql\", // Placeholder, will be renamed in post-processing\n      namespace: \"\", // Empty namespace for settings table\n      fromVersion: settingsSourceVersion,\n      toVersion: settingsTargetVersion,\n    });\n  }\n\n  // Generate migration for each fragment\n  for (const db of databases) {\n    const dbAdapter = db.adapter;\n\n    // Use migration engine\n    if (!dbAdapter.prepareMigrations) {\n      throw new Error(\n        `Adapter for ${db.namespace} does not support schema generation. ` +\n          `Ensure your adapter implements either createSchemaGenerator or prepareMigrations.`,\n      );\n    }\n\n    const preparedMigrations = dbAdapter.prepareMigrations(db.schema, db.namespace);\n    const targetVersion = options?.toVersion ?? db.schema.version;\n    const sourceVersion = options?.fromVersion ?? 0;\n\n    // Generate migration from source to target version\n    const sql = preparedMigrations.getSQL(sourceVersion, targetVersion);\n\n    // If no migrations needed, skip this fragment\n    if (sql.trim()) {\n      generatedFiles.push({\n        schema: sql,\n        path: \"schema.sql\", // Placeholder, will be renamed in post-processing\n        namespace: db.namespace,\n        fromVersion: sourceVersion,\n        toVersion: targetVersion,\n      });\n    }\n  }\n\n  // Post-process filenames with ordering\n  return postProcessMigrationFilenames(generatedFiles);\n}\n\n/**\n * Execute migrations for all fragments in the correct order.\n * Migrates settings table first, then fragments alphabetically.\n *\n * @param databases - Array of FragnoDatabase instances to migrate\n * @returns Array of execution results for each migration\n */\nexport async function executeMigrations<const TDatabases extends FragnoDatabase<AnySchema>[]>(\n  databases: TDatabases,\n): Promise<ExecuteMigrationResult[]> {\n  if (databases.length === 0) {\n    throw new Error(\"No databases provided for migration\");\n  }\n\n  const firstDb = databases[0];\n  const adapter = firstDb.adapter;\n\n  // Validate adapter supports migrations\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Adapter does not support running migrations. The adapter only supports schema generation.\\n\" +\n        \"Try using 'generateMigrationsOrSchema' instead to generate schema files.\",\n    );\n  }\n\n  // Validate all use same adapter name and version\n  const firstAdapterName = adapter[fragnoDatabaseAdapterNameFakeSymbol];\n  const firstAdapterVersion = adapter[fragnoDatabaseAdapterVersionFakeSymbol];\n\n  for (const db of databases) {\n    const dbAdapterName = db.adapter[fragnoDatabaseAdapterNameFakeSymbol];\n    const dbAdapterVersion = db.adapter[fragnoDatabaseAdapterVersionFakeSymbol];\n\n    if (dbAdapterName !== firstAdapterName || dbAdapterVersion !== firstAdapterVersion) {\n      throw new Error(\n        `All fragments must use the same database adapter. ` +\n          `Found: ${firstAdapterName}@${firstAdapterVersion} and ${dbAdapterName}@${dbAdapterVersion}`,\n      );\n    }\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  const results: ExecuteMigrationResult[] = [];\n  const migrationsToExecute: Array<{\n    namespace: string;\n    fromVersion: number;\n    toVersion: number;\n    execute: () => Promise<void>;\n  }> = [];\n\n  // 1. Prepare settings table migration\n  // Use the internal fragment for settings management\n  const internalFragment = instantiate(internalFragmentDef)\n    .withConfig({})\n    .withOptions({ databaseAdapter: adapter })\n    .build();\n\n  const settingsSourceVersion = await getSchemaVersionFromDatabase(\n    internalFragment,\n    SETTINGS_NAMESPACE,\n  );\n\n  // Use empty namespace for settings (SETTINGS_NAMESPACE is for prefixing keys, not the database namespace)\n  const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, \"\");\n  const settingsTargetVersion = internalSchema.version;\n\n  if (settingsSourceVersion < settingsTargetVersion) {\n    const compiledMigration = settingsPreparedMigrations.compile(\n      settingsSourceVersion,\n      settingsTargetVersion,\n      { updateVersionInMigration: true },\n    );\n\n    if (compiledMigration.statements.length > 0) {\n      migrationsToExecute.push({\n        namespace: \"\", // Empty namespace for settings table\n        fromVersion: settingsSourceVersion,\n        toVersion: settingsTargetVersion,\n        execute: () =>\n          settingsPreparedMigrations.execute(settingsSourceVersion, settingsTargetVersion, {\n            updateVersionInMigration: true,\n          }),\n      });\n    }\n  }\n\n  // 2. Prepare fragment migrations (sorted alphabetically)\n  const sortedDatabases = [...databases].sort((a, b) => a.namespace.localeCompare(b.namespace));\n\n  for (const fragnoDb of sortedDatabases) {\n    const preparedMigrations = adapter.prepareMigrations(fragnoDb.schema, fragnoDb.namespace);\n    const currentVersion = await getSchemaVersionFromDatabase(internalFragment, fragnoDb.namespace);\n    const targetVersion = fragnoDb.schema.version;\n\n    if (currentVersion < targetVersion) {\n      const compiledMigration = preparedMigrations.compile(currentVersion, targetVersion, {\n        updateVersionInMigration: true,\n      });\n\n      if (compiledMigration.statements.length > 0) {\n        migrationsToExecute.push({\n          namespace: fragnoDb.namespace,\n          fromVersion: currentVersion,\n          toVersion: targetVersion,\n          execute: () =>\n            preparedMigrations.execute(currentVersion, targetVersion, {\n              updateVersionInMigration: true,\n            }),\n        });\n      }\n    }\n  }\n\n  // 3. Execute all migrations in order\n  for (const migration of migrationsToExecute) {\n    await migration.execute();\n    results.push({\n      namespace: migration.namespace,\n      didMigrate: true,\n      fromVersion: migration.fromVersion,\n      toVersion: migration.toVersion,\n    });\n  }\n\n  // 4. Add skipped migrations (already up-to-date)\n  for (const fragnoDb of databases) {\n    if (!results.find((r) => r.namespace === fragnoDb.namespace)) {\n      results.push({\n        namespace: fragnoDb.namespace,\n        didMigrate: false,\n        fromVersion: fragnoDb.schema.version,\n        toVersion: fragnoDb.schema.version,\n      });\n    }\n  }\n\n  return results;\n}\n\n/**\n * Post-processes migration files to add ordering and standardize naming.\n *\n * Sorts files with settings namespace first, then alphabetically by namespace,\n * and assigns ordering numbers. Transforms filenames to format:\n * `<date>_<n>_f<from>_t<to>_<namespace>.sql`\n *\n * @param files - Array of generated migration files with version information\n * @returns Array of files with standardized paths and ordering\n */\nexport function postProcessMigrationFilenames(\n  files: GenerationInternalResult[],\n): GenerationEngineResult[] {\n  if (files.length === 0) {\n    return [];\n  }\n\n  // Sort files: settings namespace first (empty string), then alphabetically by namespace\n  const sortedFiles = [...files].sort((a, b) => {\n    // Settings table has empty namespace - sort it first\n    if (a.namespace === \"\") {\n      return -1;\n    }\n    if (b.namespace === \"\") {\n      return 1;\n    }\n    return a.namespace.localeCompare(b.namespace);\n  });\n\n  // Generate date prefix for filenames\n  const date = new Date().toISOString().split(\"T\")[0].replace(/-/g, \"\");\n\n  // Rename files with ordering\n  return sortedFiles.map((file, index) => {\n    const fromVersion = file.fromVersion ?? 0;\n    const toVersion = file.toVersion ?? 0;\n\n    // Create new filename with ordering\n    const orderNum = (index + 1).toString().padStart(3, \"0\");\n    const fromPadded = fromVersion.toString().padStart(3, \"0\");\n    const toPadded = toVersion.toString().padStart(3, \"0\");\n\n    // For settings table (empty namespace), use \"fragno_db_settings\" in the filename\n    // For other tables, use their namespace\n    const safeName =\n      file.namespace === \"\" ? \"fragno_db_settings\" : file.namespace.replace(/[^a-z0-9-]/gi, \"_\");\n    const newPath = `${date}_${orderNum}_f${fromPadded}_t${toPadded}_${safeName}.sql`;\n\n    return {\n      schema: file.schema,\n      path: newPath,\n      namespace: file.namespace,\n    };\n  });\n}\n"],"mappings":";;;;;AAmCA,eAAsB,2BAIpB,WACA,SAKmC;AACnC,KAAI,UAAU,WAAW,EACvB,OAAM,IAAI,MAAM,8CAA8C;CAGhE,MAAM,UAAU,UAAU;CAC1B,MAAM,UAAU,QAAQ;AAGxB,KAAI,QAAQ,uBAAuB;AACjC,MAAI,SAAS,cAAc,UAAa,SAAS,gBAAgB,OAC/D,SAAQ,KACN,oIACD;EAMH,MAAM,+BAAe,IAAI,KAAuD;AAGhF,eAAa,IAAI,IAAI;GACnB,QAAQ;GACR,WAAW;GACZ,CAAC;AAIF,OAAK,MAAM,MAAM,UACf,KAAI,CAAC,aAAa,IAAI,GAAG,UAAU,CACjC,cAAa,IAAI,GAAG,WAAW;GAC7B,QAAQ,GAAG;GACX,WAAW,GAAG;GACf,CAAC;EAIN,MAAM,eAAe,MAAM,KAAK,aAAa,QAAQ,CAAC;AAKtD,SAAO,CACL;GACE,GANc,QAAQ,sBAAsB,cAAc,EAC5D,MAAM,SAAS,MAChB,CAAC,CAIe,gBAAgB;GAC7B,WAAW,QAAQ;GACpB,CACF;;AAIH,KAAI,CAAC,QAAQ,kBACX,OAAM,IAAI,MACR,gHACD;AAGH,KAAI,CAAE,MAAM,QAAQ,qBAAqB,CACvC,OAAM,IAAI,MACR,2FACD;CASH,MAAM,wBAAwB,MAAM,6BALX,YAAY,oBAAoB,CACtD,WAAW,EAAE,CAAC,CACd,YAAY,EAAE,iBAAiB,SAAS,CAAC,CACzC,OAAO,EAIR,mBACD;CAED,MAAMA,iBAA6C,EAAE;CAGrD,MAAM,6BAA6B,QAAQ,kBAAkB,gBAAgB,GAAG;CAChF,MAAM,wBAAwB,eAAe;CAG7C,MAAM,cAAc,2BAA2B,OAC7C,uBACA,sBACD;AAED,KAAI,YAAY,MAAM,CACpB,gBAAe,KAAK;EAClB,QAAQ;EACR,MAAM;EACN,WAAW;EACX,aAAa;EACb,WAAW;EACZ,CAAC;AAIJ,MAAK,MAAM,MAAM,WAAW;EAC1B,MAAM,YAAY,GAAG;AAGrB,MAAI,CAAC,UAAU,kBACb,OAAM,IAAI,MACR,eAAe,GAAG,UAAU,wHAE7B;EAGH,MAAM,qBAAqB,UAAU,kBAAkB,GAAG,QAAQ,GAAG,UAAU;EAC/E,MAAM,gBAAgB,SAAS,aAAa,GAAG,OAAO;EACtD,MAAM,gBAAgB,SAAS,eAAe;EAG9C,MAAM,MAAM,mBAAmB,OAAO,eAAe,cAAc;AAGnE,MAAI,IAAI,MAAM,CACZ,gBAAe,KAAK;GAClB,QAAQ;GACR,MAAM;GACN,WAAW,GAAG;GACd,aAAa;GACb,WAAW;GACZ,CAAC;;AAKN,QAAO,8BAA8B,eAAe;;;;;;;;;AAUtD,eAAsB,kBACpB,WACmC;AACnC,KAAI,UAAU,WAAW,EACvB,OAAM,IAAI,MAAM,sCAAsC;CAIxD,MAAM,UADU,UAAU,GACF;AAGxB,KAAI,CAAC,QAAQ,kBACX,OAAM,IAAI,MACR,sKAED;CAIH,MAAM,mBAAmB,QAAQ;CACjC,MAAM,sBAAsB,QAAQ;AAEpC,MAAK,MAAM,MAAM,WAAW;EAC1B,MAAM,gBAAgB,GAAG,QAAQ;EACjC,MAAM,mBAAmB,GAAG,QAAQ;AAEpC,MAAI,kBAAkB,oBAAoB,qBAAqB,oBAC7D,OAAM,IAAI,MACR,4DACY,iBAAiB,GAAG,oBAAoB,OAAO,cAAc,GAAG,mBAC7E;;AAIL,KAAI,CAAE,MAAM,QAAQ,qBAAqB,CACvC,OAAM,IAAI,MACR,2FACD;CAGH,MAAMC,UAAoC,EAAE;CAC5C,MAAMC,sBAKD,EAAE;CAIP,MAAM,mBAAmB,YAAY,oBAAoB,CACtD,WAAW,EAAE,CAAC,CACd,YAAY,EAAE,iBAAiB,SAAS,CAAC,CACzC,OAAO;CAEV,MAAM,wBAAwB,MAAM,6BAClC,kBACA,mBACD;CAGD,MAAM,6BAA6B,QAAQ,kBAAkB,gBAAgB,GAAG;CAChF,MAAM,wBAAwB,eAAe;AAE7C,KAAI,wBAAwB,uBAO1B;MAN0B,2BAA2B,QACnD,uBACA,uBACA,EAAE,0BAA0B,MAAM,CACnC,CAEqB,WAAW,SAAS,EACxC,qBAAoB,KAAK;GACvB,WAAW;GACX,aAAa;GACb,WAAW;GACX,eACE,2BAA2B,QAAQ,uBAAuB,uBAAuB,EAC/E,0BAA0B,MAC3B,CAAC;GACL,CAAC;;CAKN,MAAM,kBAAkB,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,MAAM,EAAE,UAAU,cAAc,EAAE,UAAU,CAAC;AAE7F,MAAK,MAAM,YAAY,iBAAiB;EACtC,MAAM,qBAAqB,QAAQ,kBAAkB,SAAS,QAAQ,SAAS,UAAU;EACzF,MAAM,iBAAiB,MAAM,6BAA6B,kBAAkB,SAAS,UAAU;EAC/F,MAAM,gBAAgB,SAAS,OAAO;AAEtC,MAAI,iBAAiB,eAKnB;OAJ0B,mBAAmB,QAAQ,gBAAgB,eAAe,EAClF,0BAA0B,MAC3B,CAAC,CAEoB,WAAW,SAAS,EACxC,qBAAoB,KAAK;IACvB,WAAW,SAAS;IACpB,aAAa;IACb,WAAW;IACX,eACE,mBAAmB,QAAQ,gBAAgB,eAAe,EACxD,0BAA0B,MAC3B,CAAC;IACL,CAAC;;;AAMR,MAAK,MAAM,aAAa,qBAAqB;AAC3C,QAAM,UAAU,SAAS;AACzB,UAAQ,KAAK;GACX,WAAW,UAAU;GACrB,YAAY;GACZ,aAAa,UAAU;GACvB,WAAW,UAAU;GACtB,CAAC;;AAIJ,MAAK,MAAM,YAAY,UACrB,KAAI,CAAC,QAAQ,MAAM,MAAM,EAAE,cAAc,SAAS,UAAU,CAC1D,SAAQ,KAAK;EACX,WAAW,SAAS;EACpB,YAAY;EACZ,aAAa,SAAS,OAAO;EAC7B,WAAW,SAAS,OAAO;EAC5B,CAAC;AAIN,QAAO;;;;;;;;;;;;AAaT,SAAgB,8BACd,OAC0B;AAC1B,KAAI,MAAM,WAAW,EACnB,QAAO,EAAE;CAIX,MAAM,cAAc,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM;AAE5C,MAAI,EAAE,cAAc,GAClB,QAAO;AAET,MAAI,EAAE,cAAc,GAClB,QAAO;AAET,SAAO,EAAE,UAAU,cAAc,EAAE,UAAU;GAC7C;CAGF,MAAM,wBAAO,IAAI,MAAM,EAAC,aAAa,CAAC,MAAM,IAAI,CAAC,GAAG,QAAQ,MAAM,GAAG;AAGrE,QAAO,YAAY,KAAK,MAAM,UAAU;EACtC,MAAM,cAAc,KAAK,eAAe;EACxC,MAAM,YAAY,KAAK,aAAa;EAWpC,MAAM,UAAU,GAAG,KAAK,IARN,QAAQ,GAAG,UAAU,CAAC,SAAS,GAAG,IAAI,CAQpB,IAPjB,YAAY,UAAU,CAAC,SAAS,GAAG,IAAI,CAOP,IANlC,UAAU,UAAU,CAAC,SAAS,GAAG,IAAI,CAMU,GAD9D,KAAK,cAAc,KAAK,uBAAuB,KAAK,UAAU,QAAQ,gBAAgB,IAAI,CAChB;AAE5E,SAAO;GACL,QAAQ,KAAK;GACb,MAAM;GACN,WAAW,KAAK;GACjB;GACD"}
+{"version":3,"file":"generation-engine.js","names":["generatedFiles: GenerationInternalResult[]","results: ExecuteMigrationResult[]","migrationsToExecute: Array<{\n    namespace: string | null;\n    namespaceKey: string;\n    fromVersion: number;\n    toVersion: number;\n    execute: () => Promise<void>;\n  }>"],"sources":["../../src/migration-engine/generation-engine.ts"],"sourcesContent":["import type { FragnoDatabase } from \"../mod\";\nimport type { AnySchema } from \"../schema/create\";\nimport {\n  fragnoDatabaseAdapterNameFakeSymbol,\n  fragnoDatabaseAdapterVersionFakeSymbol,\n} from \"../adapters/adapters\";\nimport { generateDrizzleSchema } from \"../schema-output/drizzle\";\nimport { generatePrismaSchema } from \"../schema-output/prisma\";\nimport { internalFragmentDef, getSchemaVersionFromDatabase } from \"../fragments/internal-fragment\";\nimport { internalSchema, SETTINGS_TABLE_NAME } from \"../fragments/internal-fragment.schema\";\nimport { instantiate } from \"@fragno-dev/core\";\nimport { supportedDatabases, type SupportedDatabase } from \"../adapters/generic-sql/driver-config\";\n\nexport interface GenerationEngineResult {\n  schema: string;\n  path: string;\n  namespace: string | null;\n}\n\nexport type SchemaOutputFormat = \"sql\" | \"drizzle\" | \"prisma\";\n\nexport interface GenerateSchemaOptions {\n  format?: SchemaOutputFormat;\n  path?: string;\n  toVersion?: number;\n  fromVersion?: number;\n}\n\nexport interface GenerationInternalResult {\n  schema: string;\n  path: string;\n  namespace: string | null;\n  namespaceKey: string;\n  schemaName: string;\n  isSettings: boolean;\n  fromVersion: number;\n  toVersion: number;\n}\n\nexport interface ExecuteMigrationResult {\n  namespace: string | null;\n  didMigrate: boolean;\n  fromVersion: number;\n  toVersion: number;\n}\n\nconst DEFAULT_DRIZZLE_PATH = \"fragno-schema.ts\";\nconst DEFAULT_PRISMA_PATH = \"fragno.prisma\";\n\nconst isSupportedDatabase = (value: string): value is SupportedDatabase =>\n  supportedDatabases.includes(value as SupportedDatabase);\n\nexport async function generateSchemaArtifacts<\n  // oxlint-disable-next-line no-explicit-any\n  const TDatabases extends FragnoDatabase<AnySchema, any>[],\n>(databases: TDatabases, options?: GenerateSchemaOptions): Promise<GenerationEngineResult[]> {\n  if (databases.length === 0) {\n    throw new Error(\"No databases provided for schema generation\");\n  }\n\n  const firstDb = databases[0];\n  const adapter = firstDb.adapter;\n  const format = options?.format ?? \"sql\";\n\n  if (format !== \"sql\") {\n    if (options?.toVersion !== undefined || options?.fromVersion !== undefined) {\n      throw new Error(\"--from and --to are only supported when generating SQL migrations.\");\n    }\n\n    const databaseType = adapter.adapterMetadata?.databaseType;\n    if (!databaseType || !isSupportedDatabase(databaseType)) {\n      throw new Error(\n        \"Adapter does not expose databaseType metadata required for schema output generation.\",\n      );\n    }\n\n    // Collect all schemas, de-duplicating by namespace.\n    // The internal fragment (settings schema) is always included first since all database\n    // fragments automatically link to it via withDatabase().\n    const fragmentsMap = new Map<string, { schema: AnySchema; namespace: string | null }>();\n\n    // Include internal fragment first with empty namespace (settings table has no prefix)\n    fragmentsMap.set(internalSchema.name, {\n      schema: internalSchema,\n      namespace: null,\n    });\n\n    // Add user fragments, de-duplicating by namespace\n    // Each FragnoDatabase has a unique namespace, so this prevents duplicate schema generation\n    for (const db of databases) {\n      const namespaceKey = db.namespace ?? db.schema.name;\n      if (!fragmentsMap.has(namespaceKey)) {\n        fragmentsMap.set(namespaceKey, {\n          schema: db.schema,\n          namespace: db.namespace,\n        });\n      }\n    }\n\n    const allFragments = Array.from(fragmentsMap.values());\n    const defaultPath = format === \"drizzle\" ? DEFAULT_DRIZZLE_PATH : DEFAULT_PRISMA_PATH;\n    const schema =\n      format === \"drizzle\"\n        ? generateDrizzleSchema(allFragments, databaseType, {\n            namingStrategy: adapter.namingStrategy,\n          })\n        : generatePrismaSchema(allFragments, databaseType, {\n            sqliteStorageMode: adapter.adapterMetadata?.sqliteStorageMode,\n            namingStrategy: adapter.namingStrategy,\n          });\n\n    return [\n      {\n        schema,\n        path: options?.path ?? defaultPath,\n        namespace: firstDb.namespace,\n      },\n    ];\n  }\n\n  // Otherwise, use migration engine for SQL migration generation.\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Adapter does not support migration generation. Ensure your adapter implements prepareMigrations.\",\n    );\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  // Use the internal fragment for settings management\n  const internalFragment = instantiate(internalFragmentDef)\n    .withConfig({})\n    .withOptions({ databaseAdapter: adapter, databaseNamespace: null })\n    .build();\n\n  const settingsSourceVersion = await getSchemaVersionFromDatabase(internalFragment, \"\");\n\n  const generatedFiles: GenerationInternalResult[] = [];\n\n  // Internal fragment uses empty-string namespace: no table suffix, version key is \".schema_version\"\n  const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, \"\");\n  const settingsTargetVersion = internalSchema.version;\n\n  // Generate settings table migration\n  const settingsSql = settingsPreparedMigrations.getSQL(\n    settingsSourceVersion,\n    settingsTargetVersion,\n  );\n\n  if (settingsSql.trim()) {\n    generatedFiles.push({\n      schema: settingsSql,\n      path: \"settings-migration.sql\", // Placeholder, will be renamed in post-processing\n      namespace: null,\n      namespaceKey: SETTINGS_TABLE_NAME,\n      schemaName: internalSchema.name,\n      isSettings: true,\n      fromVersion: settingsSourceVersion,\n      toVersion: settingsTargetVersion,\n    });\n  }\n\n  // Generate migration for each fragment\n  for (const db of databases) {\n    const dbAdapter = db.adapter;\n\n    // Use migration engine\n    if (!dbAdapter.prepareMigrations) {\n      throw new Error(\n        `Adapter for ${db.namespace ?? db.schema.name} does not support migration generation. ` +\n          `Ensure your adapter implements prepareMigrations.`,\n      );\n    }\n\n    const preparedMigrations = dbAdapter.prepareMigrations(db.schema, db.namespace);\n    const targetVersion = options?.toVersion ?? db.schema.version;\n    const sourceVersion = options?.fromVersion ?? 0;\n\n    // Generate migration from source to target version\n    const sql = preparedMigrations.getSQL(sourceVersion, targetVersion);\n\n    // If no migrations needed, skip this fragment\n    if (sql.trim()) {\n      generatedFiles.push({\n        schema: sql,\n        path: \"schema.sql\", // Placeholder, will be renamed in post-processing\n        namespace: db.namespace,\n        namespaceKey: db.namespace ?? db.schema.name,\n        schemaName: db.schema.name,\n        isSettings: false,\n        fromVersion: sourceVersion,\n        toVersion: targetVersion,\n      });\n    }\n  }\n\n  // Post-process filenames with ordering\n  return postProcessMigrationFilenames(generatedFiles);\n}\n\n/**\n * Execute migrations for all fragments in the correct order.\n * Migrates settings table first, then fragments alphabetically.\n *\n * @param databases - Array of FragnoDatabase instances to migrate\n * @returns Array of execution results for each migration\n */\nexport async function executeMigrations<const TDatabases extends FragnoDatabase<AnySchema>[]>(\n  databases: TDatabases,\n): Promise<ExecuteMigrationResult[]> {\n  if (databases.length === 0) {\n    throw new Error(\"No databases provided for migration\");\n  }\n\n  const firstDb = databases[0];\n  const adapter = firstDb.adapter;\n\n  // Validate adapter supports migrations\n  if (!adapter.prepareMigrations) {\n    throw new Error(\n      \"Adapter does not support running migrations. The adapter only supports schema generation.\\n\" +\n        \"Try using 'generateSchemaArtifacts' instead to generate schema files.\",\n    );\n  }\n\n  // Validate all use same adapter name and version\n  const firstAdapterName = adapter[fragnoDatabaseAdapterNameFakeSymbol];\n  const firstAdapterVersion = adapter[fragnoDatabaseAdapterVersionFakeSymbol];\n\n  for (const db of databases) {\n    const dbAdapterName = db.adapter[fragnoDatabaseAdapterNameFakeSymbol];\n    const dbAdapterVersion = db.adapter[fragnoDatabaseAdapterVersionFakeSymbol];\n\n    if (dbAdapterName !== firstAdapterName || dbAdapterVersion !== firstAdapterVersion) {\n      throw new Error(\n        `All fragments must use the same database adapter. ` +\n          `Found: ${firstAdapterName}@${firstAdapterVersion} and ${dbAdapterName}@${dbAdapterVersion}`,\n      );\n    }\n  }\n\n  if (!(await adapter.isConnectionHealthy())) {\n    throw new Error(\n      \"Database connection is not healthy. Please check your database connection and try again.\",\n    );\n  }\n\n  const results: ExecuteMigrationResult[] = [];\n  const migrationsToExecute: Array<{\n    namespace: string | null;\n    namespaceKey: string;\n    fromVersion: number;\n    toVersion: number;\n    execute: () => Promise<void>;\n  }> = [];\n\n  // 1. Prepare settings table migration\n  // Use the internal fragment for settings management\n  const internalFragment = instantiate(internalFragmentDef)\n    .withConfig({})\n    .withOptions({ databaseAdapter: adapter, databaseNamespace: null })\n    .build();\n\n  const settingsSourceVersion = await getSchemaVersionFromDatabase(internalFragment, \"\");\n\n  // Internal fragment uses empty-string namespace: no table suffix, version key is \".schema_version\"\n  const settingsPreparedMigrations = adapter.prepareMigrations(internalSchema, \"\");\n  const settingsTargetVersion = internalSchema.version;\n\n  if (settingsSourceVersion < settingsTargetVersion) {\n    const compiledMigration = settingsPreparedMigrations.compile(\n      settingsSourceVersion,\n      settingsTargetVersion,\n      { updateVersionInMigration: true },\n    );\n\n    if (compiledMigration.statements.length > 0) {\n      migrationsToExecute.push({\n        namespace: null,\n        namespaceKey: SETTINGS_TABLE_NAME,\n        fromVersion: settingsSourceVersion,\n        toVersion: settingsTargetVersion,\n        execute: () =>\n          settingsPreparedMigrations.execute(settingsSourceVersion, settingsTargetVersion, {\n            updateVersionInMigration: true,\n          }),\n      });\n    }\n  }\n\n  // 2. Prepare fragment migrations (sorted alphabetically)\n  const getNamespaceKey = (db: FragnoDatabase<AnySchema>) => db.namespace ?? db.schema.name;\n  const sortedDatabases = [...databases].sort((a, b) =>\n    getNamespaceKey(a).localeCompare(getNamespaceKey(b)),\n  );\n\n  for (const fragnoDb of sortedDatabases) {\n    const namespaceKey = getNamespaceKey(fragnoDb);\n    const preparedMigrations = adapter.prepareMigrations(fragnoDb.schema, fragnoDb.namespace);\n    const currentVersion = await getSchemaVersionFromDatabase(internalFragment, namespaceKey);\n    const targetVersion = fragnoDb.schema.version;\n\n    if (currentVersion < targetVersion) {\n      const compiledMigration = preparedMigrations.compile(currentVersion, targetVersion, {\n        updateVersionInMigration: true,\n      });\n\n      if (compiledMigration.statements.length > 0) {\n        migrationsToExecute.push({\n          namespace: fragnoDb.namespace,\n          namespaceKey,\n          fromVersion: currentVersion,\n          toVersion: targetVersion,\n          execute: () =>\n            preparedMigrations.execute(currentVersion, targetVersion, {\n              updateVersionInMigration: true,\n            }),\n        });\n      }\n    }\n  }\n\n  // 3. Execute all migrations in order\n  const executedNamespaceKeys = new Set<string>();\n  for (const migration of migrationsToExecute) {\n    await migration.execute();\n    results.push({\n      namespace: migration.namespace,\n      didMigrate: true,\n      fromVersion: migration.fromVersion,\n      toVersion: migration.toVersion,\n    });\n    executedNamespaceKeys.add(migration.namespaceKey);\n  }\n\n  // 4. Add skipped migrations (already up-to-date)\n  for (const fragnoDb of databases) {\n    const namespaceKey = getNamespaceKey(fragnoDb);\n    if (!executedNamespaceKeys.has(namespaceKey)) {\n      results.push({\n        namespace: fragnoDb.namespace,\n        didMigrate: false,\n        fromVersion: fragnoDb.schema.version,\n        toVersion: fragnoDb.schema.version,\n      });\n    }\n  }\n\n  return results;\n}\n\n/**\n * Post-processes migration files to add ordering and standardize naming.\n *\n * Sorts files with settings namespace first, then alphabetically by namespace key,\n * and assigns ordering numbers. Transforms filenames to format:\n * `<date>_<n>_f<from>_t<to>_<namespace>.sql`\n *\n * @param files - Array of generated migration files with version information\n * @returns Array of files with standardized paths and ordering\n */\nexport function postProcessMigrationFilenames(\n  files: GenerationInternalResult[],\n): GenerationEngineResult[] {\n  if (files.length === 0) {\n    return [];\n  }\n\n  // Sort files: settings first, then alphabetically by namespace key\n  const sortedFiles = [...files].sort((a, b) => {\n    if (a.isSettings) {\n      return -1;\n    }\n    if (b.isSettings) {\n      return 1;\n    }\n    return a.namespaceKey.localeCompare(b.namespaceKey);\n  });\n\n  // Generate date prefix for filenames\n  const date = new Date().toISOString().split(\"T\")[0].replace(/-/g, \"\");\n\n  // Rename files with ordering\n  return sortedFiles.map((file, index) => {\n    const fromVersion = file.fromVersion ?? 0;\n    const toVersion = file.toVersion ?? 0;\n\n    // Create new filename with ordering\n    const orderNum = (index + 1).toString().padStart(3, \"0\");\n    const fromPadded = fromVersion.toString().padStart(3, \"0\");\n    const toPadded = toVersion.toString().padStart(3, \"0\");\n\n    const safeName = file.namespaceKey.replace(/[^a-z0-9-]/gi, \"_\");\n    const newPath = `${date}_${orderNum}_f${fromPadded}_t${toPadded}_${safeName}.sql`;\n\n    return {\n      schema: file.schema,\n      path: newPath,\n      namespace: file.namespace,\n    };\n  });\n}\n"],"mappings":"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"}