@kuckit/sdk 1.0.2 → 2.0.0

package/dist/loader-Ct4ZivZz.js

@@ -0,0 +1,177 @@
+import { n as getModuleRegistry } from "./registry-CL_5erME.js";
+import { n as getSchemaRegistry } from "./registry-BPYpBtYx.js";
+
+//#region src/modules/loader.ts
+/**
+* Validates that a module has the correct shape
+*/
+const validateModule = (candidate, packageName) => {
+	if (!candidate || typeof candidate !== "object") throw new Error(`Invalid Kuckit module from "${packageName}": expected an object with module definition`);
+	const mod = candidate;
+	if (!mod.id || typeof mod.id !== "string") throw new Error(`Invalid Kuckit module from "${packageName}": missing or invalid 'id' property`);
+	for (const hookName of [
+		"register",
+		"registerApi",
+		"onBootstrap",
+		"onShutdown"
+	]) if (mod[hookName] !== void 0 && typeof mod[hookName] !== "function") throw new Error(`Invalid Kuckit module from "${packageName}": '${hookName}' must be a function`);
+	return mod;
+};
+/**
+* Load and initialize Kuckit modules
+*
+* This function orchestrates the module loading lifecycle:
+*
+* 1. **Import Phase**: Dynamic import each module package
+* 2. **Register Phase**: Run register() hooks (DI bindings)
+* 3. **API Phase**: Run registerApi() hooks (API routes)
+* 4. **Wire Phase**: Call onApiRegistrations callback
+* 5. **Bootstrap Phase**: Run onBootstrap() hooks
+* 6. **Complete Phase**: Call onComplete callback
+*
+* @example
+* ```ts
+* await loadKuckitModules({
+*   container,
+*   env: 'production',
+*   modules: [
+*     { package: '@kuckit/users-module' },
+*     { package: '@acme/billing-module', config: { currency: 'USD' } },
+*     { package: './src/modules/custom', disabled: process.env.DISABLE_CUSTOM === 'true' },
+*   ],
+*   onApiRegistrations: (registrations) => {
+*     // Wire up oRPC routers, REST routes, etc.
+*     for (const reg of registrations) {
+*       if (reg.type === 'rpc-router') {
+*         rootRouter.merge(reg.name, reg.router)
+*       }
+*     }
+*   },
+*   onComplete: () => {
+*     console.log('All modules loaded!')
+*   },
+* })
+* ```
+*/
+const loadKuckitModules = async (opts) => {
+	const { container, env, modules, onApiRegistrations, onComplete } = opts;
+	const apiRegistrations = [];
+	const loadedModules = [];
+	const registry = getModuleRegistry();
+	for (const spec of modules) {
+		if (spec.disabled) continue;
+		let validated;
+		if (spec.module) validated = validateModule(spec.module, spec.module.id ?? "direct-module");
+		else if (spec.package) {
+			let imported;
+			try {
+				imported = await import(spec.package);
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				throw new Error(`Failed to import module "${spec.package}": ${message}`);
+			}
+			validated = validateModule(imported.kuckitModule ?? imported.default, spec.package);
+		} else throw new Error("ModuleSpec must have either \"module\" or \"package\" property");
+		registry.register(validated);
+		loadedModules.push({
+			...validated,
+			_config: spec.config
+		});
+	}
+	for (const mod of loadedModules) if (mod.register) {
+		const schemaRegistry = getSchemaRegistry();
+		const ctx = {
+			container,
+			env,
+			config: mod._config ?? {},
+			registerSchema: (tableName, schema) => {
+				schemaRegistry.register(mod.id, tableName, schema);
+			}
+		};
+		try {
+			await mod.register(ctx);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			throw new Error(`Module "${mod.id}" register() failed: ${message}`);
+		}
+	}
+	for (const mod of loadedModules) if (mod.registerApi) {
+		const schemaRegistry = getSchemaRegistry();
+		const ctx = {
+			container,
+			env,
+			config: mod._config ?? {},
+			registerSchema: (tableName, schema) => {
+				schemaRegistry.register(mod.id, tableName, schema);
+			},
+			addApiRegistration: (reg) => {
+				apiRegistrations.push(reg);
+			}
+		};
+		try {
+			await mod.registerApi(ctx);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			throw new Error(`Module "${mod.id}" registerApi() failed: ${message}`);
+		}
+	}
+	if (onApiRegistrations && apiRegistrations.length > 0) await onApiRegistrations(apiRegistrations);
+	for (const mod of loadedModules) if (mod.onBootstrap) {
+		const schemaRegistry = getSchemaRegistry();
+		const ctx = {
+			container,
+			env,
+			config: mod._config ?? {},
+			registerSchema: (tableName, schema) => {
+				schemaRegistry.register(mod.id, tableName, schema);
+			}
+		};
+		try {
+			await mod.onBootstrap(ctx);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			throw new Error(`Module "${mod.id}" onBootstrap() failed: ${message}`);
+		}
+	}
+	if (onComplete) await onComplete();
+};
+/**
+* Create a shutdown handler for loaded modules
+*
+* Returns a function that calls onShutdown() on all modules in reverse order.
+* Call this during graceful shutdown.
+*
+* @example
+* ```ts
+* const shutdown = createModuleShutdownHandler(loadedModules, container, env)
+*
+* process.on('SIGTERM', async () => {
+*   await shutdown()
+*   process.exit(0)
+* })
+* ```
+*/
+const createModuleShutdownHandler = (modules, container, env) => {
+	return async () => {
+		for (const mod of [...modules].reverse()) if (mod.onShutdown) {
+			const schemaRegistry = getSchemaRegistry();
+			const ctx = {
+				container,
+				env,
+				config: {},
+				registerSchema: (tableName, schema) => {
+					schemaRegistry.register(mod.id, tableName, schema);
+				}
+			};
+			try {
+				await mod.onShutdown(ctx);
+			} catch (error) {
+				console.error(`Module "${mod.id}" onShutdown() failed:`, error);
+			}
+		}
+	};
+};
+
+//#endregion
+export { loadKuckitModules as n, createModuleShutdownHandler as t };
+//# sourceMappingURL=loader-Ct4ZivZz.js.map

package/dist/loader-Ct4ZivZz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-Ct4ZivZz.js","names":["apiRegistrations: ApiRegistration[]","loadedModules: LoadedModule[]","validated: KuckitModuleDefinition","imported: Record<string, unknown>"],"sources":["../src/modules/loader.ts"],"sourcesContent":["import type { CoreContainer } from '../types'\nimport type { KuckitModuleDefinition, ApiRegistration, ModuleSpec, LoadedModule } from './types'\nimport { getModuleRegistry } from './registry'\nimport { getSchemaRegistry } from '../schema'\n\nexport interface LoadModulesOptions {\n\t/** DI container to register services into */\n\tcontainer: CoreContainer\n\t/** Environment name (development, production, etc.) */\n\tenv: string\n\t/** List of modules to load */\n\tmodules: ModuleSpec[]\n\t/** Hook to wire collected API registrations into your router */\n\tonApiRegistrations?: (regs: ApiRegistration[]) => void | Promise<void>\n\t/** Hook called when all modules are loaded and bootstrapped */\n\tonComplete?: () => void | Promise<void>\n}\n\n/**\n * Validates that a module has the correct shape\n */\nconst validateModule = (candidate: unknown, packageName: string): KuckitModuleDefinition => {\n\tif (!candidate || typeof candidate !== 'object') {\n\t\tthrow new Error(\n\t\t\t`Invalid Kuckit module from \"${packageName}\": expected an object with module definition`\n\t\t)\n\t}\n\n\tconst mod = candidate as Record<string, unknown>\n\n\tif (!mod.id || typeof mod.id !== 'string') {\n\t\tthrow new Error(`Invalid Kuckit module from \"${packageName}\": missing or invalid 'id' property`)\n\t}\n\n\t// Validate hook types if present\n\tconst hookNames = ['register', 'registerApi', 'onBootstrap', 'onShutdown']\n\tfor (const hookName of hookNames) {\n\t\tif (mod[hookName] !== undefined && typeof mod[hookName] !== 'function') {\n\t\t\tthrow new Error(\n\t\t\t\t`Invalid Kuckit module from \"${packageName}\": '${hookName}' must be a function`\n\t\t\t)\n\t\t}\n\t}\n\n\treturn mod as unknown as KuckitModuleDefinition\n}\n\n/**\n * Load and initialize Kuckit modules\n *\n * This function orchestrates the module loading lifecycle:\n *\n * 1. **Import Phase**: Dynamic import each module package\n * 2. **Register Phase**: Run register() hooks (DI bindings)\n * 3. **API Phase**: Run registerApi() hooks (API routes)\n * 4. **Wire Phase**: Call onApiRegistrations callback\n * 5. **Bootstrap Phase**: Run onBootstrap() hooks\n * 6. **Complete Phase**: Call onComplete callback\n *\n * @example\n * ```ts\n * await loadKuckitModules({\n *   container,\n *   env: 'production',\n *   modules: [\n *     { package: '@kuckit/users-module' },\n *     { package: '@acme/billing-module', config: { currency: 'USD' } },\n *     { package: './src/modules/custom', disabled: process.env.DISABLE_CUSTOM === 'true' },\n *   ],\n *   onApiRegistrations: (registrations) => {\n *     // Wire up oRPC routers, REST routes, etc.\n *     for (const reg of registrations) {\n *       if (reg.type === 'rpc-router') {\n *         rootRouter.merge(reg.name, reg.router)\n *       }\n *     }\n *   },\n *   onComplete: () => {\n *     console.log('All modules loaded!')\n *   },\n * })\n * ```\n */\nexport const loadKuckitModules = async (opts: LoadModulesOptions): Promise<void> => {\n\tconst { container, env, modules, onApiRegistrations, onComplete } = opts\n\n\tconst apiRegistrations: ApiRegistration[] = []\n\tconst loadedModules: LoadedModule[] = []\n\tconst registry = getModuleRegistry()\n\n\t// Phase 1: Import and validate all modules\n\tfor (const spec of modules) {\n\t\tif (spec.disabled) {\n\t\t\tcontinue\n\t\t}\n\n\t\tlet validated: KuckitModuleDefinition\n\n\t\t// Prefer direct module reference over dynamic import\n\t\tif (spec.module) {\n\t\t\tvalidated = validateModule(spec.module, spec.module.id ?? 'direct-module')\n\t\t} else if (spec.package) {\n\t\t\tlet imported: Record<string, unknown>\n\t\t\ttry {\n\t\t\t\timported = await import(spec.package)\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error)\n\t\t\t\tthrow new Error(`Failed to import module \"${spec.package}\": ${message}`)\n\t\t\t}\n\n\t\t\t// Look for kuckitModule export (preferred) or default export\n\t\t\tconst candidate = imported.kuckitModule ?? imported.default\n\t\t\tvalidated = validateModule(candidate, spec.package)\n\t\t} else {\n\t\t\tthrow new Error('ModuleSpec must have either \"module\" or \"package\" property')\n\t\t}\n\n\t\t// Register module in the global registry (validates capabilities)\n\t\tregistry.register(validated)\n\n\t\tloadedModules.push({ ...validated, _config: spec.config })\n\t}\n\n\t// Phase 2: Run register() hooks\n\tfor (const mod of loadedModules) {\n\t\tif (mod.register) {\n\t\t\tconst schemaRegistry = getSchemaRegistry()\n\t\t\tconst ctx = {\n\t\t\t\tcontainer,\n\t\t\t\tenv,\n\t\t\t\tconfig: mod._config ?? {},\n\t\t\t\tregisterSchema: (tableName: string, schema: unknown) => {\n\t\t\t\t\tschemaRegistry.register(\n\t\t\t\t\t\tmod.id,\n\t\t\t\t\t\ttableName,\n\t\t\t\t\t\tschema as import('drizzle-orm/pg-core').PgTable\n\t\t\t\t\t)\n\t\t\t\t},\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tawait mod.register(ctx)\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error)\n\t\t\t\tthrow new Error(`Module \"${mod.id}\" register() failed: ${message}`)\n\t\t\t}\n\t\t}\n\t}\n\n\t// Phase 3: Run registerApi() hooks\n\tfor (const mod of loadedModules) {\n\t\tif (mod.registerApi) {\n\t\t\tconst schemaRegistry = getSchemaRegistry()\n\t\t\tconst ctx = {\n\t\t\t\tcontainer,\n\t\t\t\tenv,\n\t\t\t\tconfig: mod._config ?? {},\n\t\t\t\tregisterSchema: (tableName: string, schema: unknown) => {\n\t\t\t\t\tschemaRegistry.register(\n\t\t\t\t\t\tmod.id,\n\t\t\t\t\t\ttableName,\n\t\t\t\t\t\tschema as import('drizzle-orm/pg-core').PgTable\n\t\t\t\t\t)\n\t\t\t\t},\n\t\t\t\taddApiRegistration: (reg: ApiRegistration) => {\n\t\t\t\t\tapiRegistrations.push(reg)\n\t\t\t\t},\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tawait mod.registerApi(ctx)\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error)\n\t\t\t\tthrow new Error(`Module \"${mod.id}\" registerApi() failed: ${message}`)\n\t\t\t}\n\t\t}\n\t}\n\n\t// Phase 4: Wire API registrations\n\tif (onApiRegistrations && apiRegistrations.length > 0) {\n\t\tawait onApiRegistrations(apiRegistrations)\n\t}\n\n\t// Phase 5: Run onBootstrap() hooks\n\tfor (const mod of loadedModules) {\n\t\tif (mod.onBootstrap) {\n\t\t\tconst schemaRegistry = getSchemaRegistry()\n\t\t\tconst ctx = {\n\t\t\t\tcontainer,\n\t\t\t\tenv,\n\t\t\t\tconfig: mod._config ?? {},\n\t\t\t\tregisterSchema: (tableName: string, schema: unknown) => {\n\t\t\t\t\tschemaRegistry.register(\n\t\t\t\t\t\tmod.id,\n\t\t\t\t\t\ttableName,\n\t\t\t\t\t\tschema as import('drizzle-orm/pg-core').PgTable\n\t\t\t\t\t)\n\t\t\t\t},\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tawait mod.onBootstrap(ctx)\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error)\n\t\t\t\tthrow new Error(`Module \"${mod.id}\" onBootstrap() failed: ${message}`)\n\t\t\t}\n\t\t}\n\t}\n\n\t// Phase 6: Complete\n\tif (onComplete) {\n\t\tawait onComplete()\n\t}\n}\n\n/**\n * Create a shutdown handler for loaded modules\n *\n * Returns a function that calls onShutdown() on all modules in reverse order.\n * Call this during graceful shutdown.\n *\n * @example\n * ```ts\n * const shutdown = createModuleShutdownHandler(loadedModules, container, env)\n *\n * process.on('SIGTERM', async () => {\n *   await shutdown()\n *   process.exit(0)\n * })\n * ```\n */\nexport const createModuleShutdownHandler = (\n\tmodules: KuckitModuleDefinition[],\n\tcontainer: CoreContainer,\n\tenv: string\n): (() => Promise<void>) => {\n\treturn async () => {\n\t\t// Shutdown in reverse order\n\t\tfor (const mod of [...modules].reverse()) {\n\t\t\tif (mod.onShutdown) {\n\t\t\t\tconst schemaRegistry = getSchemaRegistry()\n\t\t\t\tconst ctx = {\n\t\t\t\t\tcontainer,\n\t\t\t\t\tenv,\n\t\t\t\t\tconfig: {},\n\t\t\t\t\tregisterSchema: (tableName: string, schema: unknown) => {\n\t\t\t\t\t\tschemaRegistry.register(\n\t\t\t\t\t\t\tmod.id,\n\t\t\t\t\t\t\ttableName,\n\t\t\t\t\t\t\tschema as import('drizzle-orm/pg-core').PgTable\n\t\t\t\t\t\t)\n\t\t\t\t\t},\n\t\t\t\t}\n\n\t\t\t\ttry {\n\t\t\t\t\tawait mod.onShutdown(ctx)\n\t\t\t\t} catch (error) {\n\t\t\t\t\t// Log but don't throw during shutdown\n\t\t\t\t\tconsole.error(`Module \"${mod.id}\" onShutdown() failed:`, error)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}\n"],"mappings":"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"}

package/dist/loader-DCNm6pZB.d.ts

@@ -0,0 +1,73 @@
+import { n as CoreContainer } from "./types-DKCy16X1.js";
+import { i as KuckitModuleDefinition, l as ModuleSpec, t as ApiRegistration } from "./types-ByO301S-.js";
+
+//#region src/modules/loader.d.ts
+interface LoadModulesOptions {
+  /** DI container to register services into */
+  container: CoreContainer;
+  /** Environment name (development, production, etc.) */
+  env: string;
+  /** List of modules to load */
+  modules: ModuleSpec[];
+  /** Hook to wire collected API registrations into your router */
+  onApiRegistrations?: (regs: ApiRegistration[]) => void | Promise<void>;
+  /** Hook called when all modules are loaded and bootstrapped */
+  onComplete?: () => void | Promise<void>;
+}
+/**
+ * Load and initialize Kuckit modules
+ *
+ * This function orchestrates the module loading lifecycle:
+ *
+ * 1. **Import Phase**: Dynamic import each module package
+ * 2. **Register Phase**: Run register() hooks (DI bindings)
+ * 3. **API Phase**: Run registerApi() hooks (API routes)
+ * 4. **Wire Phase**: Call onApiRegistrations callback
+ * 5. **Bootstrap Phase**: Run onBootstrap() hooks
+ * 6. **Complete Phase**: Call onComplete callback
+ *
+ * @example
+ * ```ts
+ * await loadKuckitModules({
+ *   container,
+ *   env: 'production',
+ *   modules: [
+ *     { package: '@kuckit/users-module' },
+ *     { package: '@acme/billing-module', config: { currency: 'USD' } },
+ *     { package: './src/modules/custom', disabled: process.env.DISABLE_CUSTOM === 'true' },
+ *   ],
+ *   onApiRegistrations: (registrations) => {
+ *     // Wire up oRPC routers, REST routes, etc.
+ *     for (const reg of registrations) {
+ *       if (reg.type === 'rpc-router') {
+ *         rootRouter.merge(reg.name, reg.router)
+ *       }
+ *     }
+ *   },
+ *   onComplete: () => {
+ *     console.log('All modules loaded!')
+ *   },
+ * })
+ * ```
+ */
+declare const loadKuckitModules: (opts: LoadModulesOptions) => Promise<void>;
+/**
+ * Create a shutdown handler for loaded modules
+ *
+ * Returns a function that calls onShutdown() on all modules in reverse order.
+ * Call this during graceful shutdown.
+ *
+ * @example
+ * ```ts
+ * const shutdown = createModuleShutdownHandler(loadedModules, container, env)
+ *
+ * process.on('SIGTERM', async () => {
+ *   await shutdown()
+ *   process.exit(0)
+ * })
+ * ```
+ */
+declare const createModuleShutdownHandler: (modules: KuckitModuleDefinition[], container: CoreContainer, env: string) => (() => Promise<void>);
+//#endregion
+export { createModuleShutdownHandler as n, loadKuckitModules as r, LoadModulesOptions as t };
+//# sourceMappingURL=loader-DCNm6pZB.d.ts.map

package/dist/loader-YEqdtcKI.d.ts

@@ -0,0 +1,29 @@
+import { o as LoadedKuckitConfig } from "./types-DxaDmkQo.js";
+
+//#region src/config/loader.d.ts
+
+/**
+ * Find the config file path by searching from cwd upward
+ */
+declare function findConfigFile(cwd?: string): string | null;
+/**
+ * Check if a unified config file exists
+ */
+declare function hasUnifiedConfig(cwd?: string): boolean;
+/**
+ * Load Kuckit configuration from file
+ *
+ * Uses jiti for TypeScript support at runtime.
+ * Falls back to dynamic import for JS/MJS files.
+ *
+ * @param cwd - Directory to start searching from (default: process.cwd())
+ * @throws Error if config file not found or invalid
+ */
+declare function loadKuckitConfig(cwd?: string): Promise<LoadedKuckitConfig>;
+/**
+ * Try to load config, returning null if not found
+ */
+declare function tryLoadKuckitConfig(cwd?: string): Promise<LoadedKuckitConfig | null>;
+//#endregion
+export { tryLoadKuckitConfig as i, hasUnifiedConfig as n, loadKuckitConfig as r, findConfigFile as t };
+//# sourceMappingURL=loader-YEqdtcKI.d.ts.map

package/dist/loader-lCPWCMYx.js

@@ -0,0 +1,75 @@
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+
+//#region src/config/loader.ts
+const CONFIG_FILES = [
+	"kuckit.config.ts",
+	"kuckit.config.js",
+	"kuckit.config.mjs"
+];
+/**
+* Find the config file path by searching from cwd upward
+*/
+function findConfigFile(cwd = process.cwd()) {
+	let dir = cwd;
+	while (dir !== dirname(dir)) {
+		for (const file of CONFIG_FILES) {
+			const configPath = resolve(dir, file);
+			if (existsSync(configPath)) return configPath;
+		}
+		dir = dirname(dir);
+	}
+	for (const file of CONFIG_FILES) {
+		const configPath = resolve(dir, file);
+		if (existsSync(configPath)) return configPath;
+	}
+	return null;
+}
+/**
+* Check if a unified config file exists
+*/
+function hasUnifiedConfig(cwd = process.cwd()) {
+	return findConfigFile(cwd) !== null;
+}
+/**
+* Load Kuckit configuration from file
+*
+* Uses jiti for TypeScript support at runtime.
+* Falls back to dynamic import for JS/MJS files.
+*
+* @param cwd - Directory to start searching from (default: process.cwd())
+* @throws Error if config file not found or invalid
+*/
+async function loadKuckitConfig(cwd = process.cwd()) {
+	const configPath = findConfigFile(cwd);
+	if (!configPath) throw new Error(`No Kuckit config file found. Create a kuckit.config.ts at your project root.\nSearched from: ${cwd}`);
+	let config;
+	if (configPath.endsWith(".ts")) {
+		const { createJiti } = await import("jiti");
+		const loaded = await createJiti(cwd, { interopDefault: true }).import(configPath);
+		config = loaded.default ?? loaded;
+	} else {
+		const loaded = await import(configPath);
+		config = loaded.default ?? loaded;
+	}
+	if (!config || typeof config !== "object") throw new Error(`Invalid Kuckit config at ${configPath}: expected an object`);
+	if (!Array.isArray(config.modules)) throw new Error(`Invalid Kuckit config at ${configPath}: 'modules' must be an array`);
+	return {
+		...config,
+		_configPath: configPath
+	};
+}
+/**
+* Try to load config, returning null if not found
+*/
+async function tryLoadKuckitConfig(cwd = process.cwd()) {
+	try {
+		return await loadKuckitConfig(cwd);
+	} catch {
+		return null;
+	}
+}
+
+//#endregion
+export { tryLoadKuckitConfig as i, hasUnifiedConfig as n, loadKuckitConfig as r, findConfigFile as t };
+//# sourceMappingURL=loader-lCPWCMYx.js.map

package/dist/loader-lCPWCMYx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-lCPWCMYx.js","names":["config: KuckitConfig"],"sources":["../src/config/loader.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { resolve, dirname } from 'node:path'\nimport type { KuckitConfig, LoadedKuckitConfig } from './types'\n\nconst CONFIG_FILES = ['kuckit.config.ts', 'kuckit.config.js', 'kuckit.config.mjs']\n\n/**\n * Find the config file path by searching from cwd upward\n */\nexport function findConfigFile(cwd: string = process.cwd()): string | null {\n\tlet dir = cwd\n\n\twhile (dir !== dirname(dir)) {\n\t\tfor (const file of CONFIG_FILES) {\n\t\t\tconst configPath = resolve(dir, file)\n\t\t\tif (existsSync(configPath)) {\n\t\t\t\treturn configPath\n\t\t\t}\n\t\t}\n\t\tdir = dirname(dir)\n\t}\n\n\t// Check root directory\n\tfor (const file of CONFIG_FILES) {\n\t\tconst configPath = resolve(dir, file)\n\t\tif (existsSync(configPath)) {\n\t\t\treturn configPath\n\t\t}\n\t}\n\n\treturn null\n}\n\n/**\n * Check if a unified config file exists\n */\nexport function hasUnifiedConfig(cwd: string = process.cwd()): boolean {\n\treturn findConfigFile(cwd) !== null\n}\n\n/**\n * Load Kuckit configuration from file\n *\n * Uses jiti for TypeScript support at runtime.\n * Falls back to dynamic import for JS/MJS files.\n *\n * @param cwd - Directory to start searching from (default: process.cwd())\n * @throws Error if config file not found or invalid\n */\nexport async function loadKuckitConfig(cwd: string = process.cwd()): Promise<LoadedKuckitConfig> {\n\tconst configPath = findConfigFile(cwd)\n\n\tif (!configPath) {\n\t\tthrow new Error(\n\t\t\t`No Kuckit config file found. Create a kuckit.config.ts at your project root.\\n` +\n\t\t\t\t`Searched from: ${cwd}`\n\t\t)\n\t}\n\n\tlet config: KuckitConfig\n\n\tif (configPath.endsWith('.ts')) {\n\t\t// Use jiti for TypeScript files\n\t\tconst { createJiti } = await import('jiti')\n\t\tconst jiti = createJiti(cwd, {\n\t\t\tinteropDefault: true,\n\t\t})\n\t\tconst loaded = await jiti.import(configPath)\n\t\tconfig = (loaded as { default?: KuckitConfig }).default ?? (loaded as KuckitConfig)\n\t} else {\n\t\t// Use dynamic import for JS/MJS\n\t\tconst loaded = await import(configPath)\n\t\tconfig = loaded.default ?? loaded\n\t}\n\n\t// Validate config\n\tif (!config || typeof config !== 'object') {\n\t\tthrow new Error(`Invalid Kuckit config at ${configPath}: expected an object`)\n\t}\n\n\tif (!Array.isArray(config.modules)) {\n\t\tthrow new Error(`Invalid Kuckit config at ${configPath}: 'modules' must be an array`)\n\t}\n\n\treturn {\n\t\t...config,\n\t\t_configPath: configPath,\n\t}\n}\n\n/**\n * Try to load config, returning null if not found\n */\nexport async function tryLoadKuckitConfig(\n\tcwd: string = process.cwd()\n): Promise<LoadedKuckitConfig | null> {\n\ttry {\n\t\treturn await loadKuckitConfig(cwd)\n\t} catch {\n\t\treturn null\n\t}\n}\n"],"mappings":";;;;AAIA,MAAM,eAAe;CAAC;CAAoB;CAAoB;CAAoB;;;;AAKlF,SAAgB,eAAe,MAAc,QAAQ,KAAK,EAAiB;CAC1E,IAAI,MAAM;AAEV,QAAO,QAAQ,QAAQ,IAAI,EAAE;AAC5B,OAAK,MAAM,QAAQ,cAAc;GAChC,MAAM,aAAa,QAAQ,KAAK,KAAK;AACrC,OAAI,WAAW,WAAW,CACzB,QAAO;;AAGT,QAAM,QAAQ,IAAI;;AAInB,MAAK,MAAM,QAAQ,cAAc;EAChC,MAAM,aAAa,QAAQ,KAAK,KAAK;AACrC,MAAI,WAAW,WAAW,CACzB,QAAO;;AAIT,QAAO;;;;;AAMR,SAAgB,iBAAiB,MAAc,QAAQ,KAAK,EAAW;AACtE,QAAO,eAAe,IAAI,KAAK;;;;;;;;;;;AAYhC,eAAsB,iBAAiB,MAAc,QAAQ,KAAK,EAA+B;CAChG,MAAM,aAAa,eAAe,IAAI;AAEtC,KAAI,CAAC,WACJ,OAAM,IAAI,MACT,gGACmB,MACnB;CAGF,IAAIA;AAEJ,KAAI,WAAW,SAAS,MAAM,EAAE;EAE/B,MAAM,EAAE,eAAe,MAAM,OAAO;EAIpC,MAAM,SAAS,MAHF,WAAW,KAAK,EAC5B,gBAAgB,MAChB,CAAC,CACwB,OAAO,WAAW;AAC5C,WAAU,OAAsC,WAAY;QACtD;EAEN,MAAM,SAAS,MAAM,OAAO;AAC5B,WAAS,OAAO,WAAW;;AAI5B,KAAI,CAAC,UAAU,OAAO,WAAW,SAChC,OAAM,IAAI,MAAM,4BAA4B,WAAW,sBAAsB;AAG9E,KAAI,CAAC,MAAM,QAAQ,OAAO,QAAQ,CACjC,OAAM,IAAI,MAAM,4BAA4B,WAAW,8BAA8B;AAGtF,QAAO;EACN,GAAG;EACH,aAAa;EACb;;;;;AAMF,eAAsB,oBACrB,MAAc,QAAQ,KAAK,EACU;AACrC,KAAI;AACH,SAAO,MAAM,iBAAiB,IAAI;SAC3B;AACP,SAAO"}

package/dist/modules/define-module.d.ts

@@ -0,0 +1,4 @@
+import "../types-DKCy16X1.js";
+import "../types-ByO301S-.js";
+import { t as defineKuckitModule } from "../define-module-Cw7q13EE.js";
+export { defineKuckitModule };

package/dist/modules/define-module.js

@@ -0,0 +1,3 @@
+import { t as defineKuckitModule } from "../define-module-B83hUzJz.js";
+
+export { defineKuckitModule };

package/dist/modules/index.d.ts

@@ -0,0 +1,7 @@
+import "../types-DKCy16X1.js";
+import { a as KuckitModuleHooks, c as ModuleCapability, i as KuckitModuleDefinition, l as ModuleSpec, n as BuiltInCapability, o as KuckitModuleMeta, r as KuckitModuleContext, t as ApiRegistration } from "../types-ByO301S-.js";
+import { t as defineKuckitModule } from "../define-module-Cw7q13EE.js";
+import { n as createModuleShutdownHandler, r as loadKuckitModules, t as LoadModulesOptions } from "../loader-DCNm6pZB.js";
+import { a as resetModuleRegistry, i as getModulesWithCapability, n as ModuleRegistry, r as getModuleRegistry, t as LoadedModuleInfo } from "../registry-DrTkgmtH.js";
+import "../index-Dw5cCt-A.js";
+export { ApiRegistration, BuiltInCapability, KuckitModuleContext, KuckitModuleDefinition, KuckitModuleHooks, KuckitModuleMeta, LoadModulesOptions, LoadedModuleInfo, ModuleCapability, ModuleRegistry, ModuleSpec, createModuleShutdownHandler, defineKuckitModule, getModuleRegistry, getModulesWithCapability, loadKuckitModules, resetModuleRegistry };

package/dist/modules/index.js

@@ -0,0 +1,8 @@
+import { t as defineKuckitModule } from "../define-module-B83hUzJz.js";
+import { i as resetModuleRegistry, n as getModuleRegistry, r as getModulesWithCapability, t as ModuleRegistry } from "../registry-CL_5erME.js";
+import "../registry-BPYpBtYx.js";
+import "../schema-BuA2HF_H.js";
+import { n as loadKuckitModules, t as createModuleShutdownHandler } from "../loader-Ct4ZivZz.js";
+import "../modules-BDQBjAbp.js";
+
+export { ModuleRegistry, createModuleShutdownHandler, defineKuckitModule, getModuleRegistry, getModulesWithCapability, loadKuckitModules, resetModuleRegistry };

package/dist/modules/loader.d.ts

@@ -0,0 +1,4 @@
+import "../types-DKCy16X1.js";
+import "../types-ByO301S-.js";
+import { n as createModuleShutdownHandler, r as loadKuckitModules, t as LoadModulesOptions } from "../loader-DCNm6pZB.js";
+export { LoadModulesOptions, createModuleShutdownHandler, loadKuckitModules };

package/dist/modules/loader.js

@@ -0,0 +1,6 @@
+import "../registry-CL_5erME.js";
+import "../registry-BPYpBtYx.js";
+import "../schema-BuA2HF_H.js";
+import { n as loadKuckitModules, t as createModuleShutdownHandler } from "../loader-Ct4ZivZz.js";
+
+export { createModuleShutdownHandler, loadKuckitModules };

package/dist/modules/registry.d.ts

@@ -0,0 +1,4 @@
+import "../types-DKCy16X1.js";
+import "../types-ByO301S-.js";
+import { a as resetModuleRegistry, i as getModulesWithCapability, n as ModuleRegistry, r as getModuleRegistry, t as LoadedModuleInfo } from "../registry-DrTkgmtH.js";
+export { LoadedModuleInfo, ModuleRegistry, getModuleRegistry, getModulesWithCapability, resetModuleRegistry };

package/dist/modules/registry.js

@@ -0,0 +1,3 @@
+import { i as resetModuleRegistry, n as getModuleRegistry, r as getModulesWithCapability, t as ModuleRegistry } from "../registry-CL_5erME.js";
+
+export { ModuleRegistry, getModuleRegistry, getModulesWithCapability, resetModuleRegistry };

package/dist/modules/types.d.ts

@@ -0,0 +1,3 @@
+import "../types-DKCy16X1.js";
+import { a as KuckitModuleHooks, c as ModuleCapability, i as KuckitModuleDefinition, l as ModuleSpec, n as BuiltInCapability, o as KuckitModuleMeta, r as KuckitModuleContext, s as LoadedModule, t as ApiRegistration } from "../types-ByO301S-.js";
+export { ApiRegistration, BuiltInCapability, KuckitModuleContext, KuckitModuleDefinition, KuckitModuleHooks, KuckitModuleMeta, LoadedModule, ModuleCapability, ModuleSpec };

package/dist/modules/types.js

@@ -0,0 +1 @@
+export {  };

package/dist/modules-BDQBjAbp.js

@@ -0,0 +1 @@
+export {  };

package/dist/registry-BPYpBtYx.js

@@ -0,0 +1,83 @@
+//#region src/schema/registry.ts
+/**
+* Registry for module-owned database schemas
+*
+* Allows modules to register their Drizzle schemas during the register() hook.
+* The CLI uses this registry to aggregate schemas for drizzle-kit operations.
+*/
+var SchemaRegistry = class {
+	schemas = /* @__PURE__ */ new Map();
+	/**
+	* Register a schema from a module
+	* @param moduleId - Module identifier (e.g., 'acme.billing')
+	* @param tableName - Table name identifier (e.g., 'invoices')
+	* @param schema - Drizzle PgTable schema
+	*/
+	register(moduleId, tableName, schema) {
+		const key = `${moduleId}:${tableName}`;
+		if (this.schemas.has(key)) throw new Error(`Schema "${tableName}" already registered by module "${moduleId}"`);
+		this.schemas.set(key, {
+			moduleId,
+			tableName,
+			schema
+		});
+	}
+	/**
+	* Get all registered schemas
+	*/
+	getAll() {
+		return new Map(this.schemas);
+	}
+	/**
+	* Get schemas registered by a specific module
+	*/
+	getByModule(moduleId) {
+		return Array.from(this.schemas.values()).filter((entry) => entry.moduleId === moduleId);
+	}
+	/**
+	* Get all schemas as a flat object for drizzle-kit
+	* Keys are table names, values are PgTable schemas
+	*/
+	getAllSchemas() {
+		const result = {};
+		for (const entry of this.schemas.values()) result[entry.tableName] = entry.schema;
+		return result;
+	}
+	/**
+	* Check if any schemas are registered
+	*/
+	hasSchemas() {
+		return this.schemas.size > 0;
+	}
+	/**
+	* Get the count of registered schemas
+	*/
+	get size() {
+		return this.schemas.size;
+	}
+	/**
+	* Clear all schemas (mainly for testing)
+	*/
+	clear() {
+		this.schemas.clear();
+	}
+};
+let globalSchemaRegistry = null;
+/**
+* Get the global schema registry
+* Creates one if it doesn't exist
+*/
+function getSchemaRegistry() {
+	if (!globalSchemaRegistry) globalSchemaRegistry = new SchemaRegistry();
+	return globalSchemaRegistry;
+}
+/**
+* Reset the global schema registry (mainly for testing)
+*/
+function resetSchemaRegistry() {
+	globalSchemaRegistry = null;
+}
+
+//#endregion
+export { getSchemaRegistry as n, resetSchemaRegistry as r, SchemaRegistry as t };
+//# sourceMappingURL=registry-BPYpBtYx.js.map

package/dist/registry-BPYpBtYx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-BPYpBtYx.js","names":["result: Record<string, PgTable>","globalSchemaRegistry: SchemaRegistry | null"],"sources":["../src/schema/registry.ts"],"sourcesContent":["import type { PgTable } from 'drizzle-orm/pg-core'\n\n/**\n * Entry for a registered schema\n */\nexport interface SchemaEntry {\n\t/** Module that owns this schema */\n\tmoduleId: string\n\t/** Table name identifier */\n\ttableName: string\n\t/** Drizzle table schema */\n\tschema: PgTable\n}\n\n/**\n * Registry for module-owned database schemas\n *\n * Allows modules to register their Drizzle schemas during the register() hook.\n * The CLI uses this registry to aggregate schemas for drizzle-kit operations.\n */\nexport class SchemaRegistry {\n\tprivate schemas = new Map<string, SchemaEntry>()\n\n\t/**\n\t * Register a schema from a module\n\t * @param moduleId - Module identifier (e.g., 'acme.billing')\n\t * @param tableName - Table name identifier (e.g., 'invoices')\n\t * @param schema - Drizzle PgTable schema\n\t */\n\tregister(moduleId: string, tableName: string, schema: PgTable): void {\n\t\tconst key = `${moduleId}:${tableName}`\n\t\tif (this.schemas.has(key)) {\n\t\t\tthrow new Error(`Schema \"${tableName}\" already registered by module \"${moduleId}\"`)\n\t\t}\n\t\tthis.schemas.set(key, { moduleId, tableName, schema })\n\t}\n\n\t/**\n\t * Get all registered schemas\n\t */\n\tgetAll(): Map<string, SchemaEntry> {\n\t\treturn new Map(this.schemas)\n\t}\n\n\t/**\n\t * Get schemas registered by a specific module\n\t */\n\tgetByModule(moduleId: string): SchemaEntry[] {\n\t\treturn Array.from(this.schemas.values()).filter((entry) => entry.moduleId === moduleId)\n\t}\n\n\t/**\n\t * Get all schemas as a flat object for drizzle-kit\n\t * Keys are table names, values are PgTable schemas\n\t */\n\tgetAllSchemas(): Record<string, PgTable> {\n\t\tconst result: Record<string, PgTable> = {}\n\t\tfor (const entry of this.schemas.values()) {\n\t\t\tresult[entry.tableName] = entry.schema\n\t\t}\n\t\treturn result\n\t}\n\n\t/**\n\t * Check if any schemas are registered\n\t */\n\thasSchemas(): boolean {\n\t\treturn this.schemas.size > 0\n\t}\n\n\t/**\n\t * Get the count of registered schemas\n\t */\n\tget size(): number {\n\t\treturn this.schemas.size\n\t}\n\n\t/**\n\t * Clear all schemas (mainly for testing)\n\t */\n\tclear(): void {\n\t\tthis.schemas.clear()\n\t}\n}\n\n// Global schema registry instance\nlet globalSchemaRegistry: SchemaRegistry | null = null\n\n/**\n * Get the global schema registry\n * Creates one if it doesn't exist\n */\nexport function getSchemaRegistry(): SchemaRegistry {\n\tif (!globalSchemaRegistry) {\n\t\tglobalSchemaRegistry = new SchemaRegistry()\n\t}\n\treturn globalSchemaRegistry\n}\n\n/**\n * Reset the global schema registry (mainly for testing)\n */\nexport function resetSchemaRegistry(): void {\n\tglobalSchemaRegistry = null\n}\n"],"mappings":";;;;;;;AAoBA,IAAa,iBAAb,MAA4B;CAC3B,AAAQ,0BAAU,IAAI,KAA0B;;;;;;;CAQhD,SAAS,UAAkB,WAAmB,QAAuB;EACpE,MAAM,MAAM,GAAG,SAAS,GAAG;AAC3B,MAAI,KAAK,QAAQ,IAAI,IAAI,CACxB,OAAM,IAAI,MAAM,WAAW,UAAU,kCAAkC,SAAS,GAAG;AAEpF,OAAK,QAAQ,IAAI,KAAK;GAAE;GAAU;GAAW;GAAQ,CAAC;;;;;CAMvD,SAAmC;AAClC,SAAO,IAAI,IAAI,KAAK,QAAQ;;;;;CAM7B,YAAY,UAAiC;AAC5C,SAAO,MAAM,KAAK,KAAK,QAAQ,QAAQ,CAAC,CAAC,QAAQ,UAAU,MAAM,aAAa,SAAS;;;;;;CAOxF,gBAAyC;EACxC,MAAMA,SAAkC,EAAE;AAC1C,OAAK,MAAM,SAAS,KAAK,QAAQ,QAAQ,CACxC,QAAO,MAAM,aAAa,MAAM;AAEjC,SAAO;;;;;CAMR,aAAsB;AACrB,SAAO,KAAK,QAAQ,OAAO;;;;;CAM5B,IAAI,OAAe;AAClB,SAAO,KAAK,QAAQ;;;;;CAMrB,QAAc;AACb,OAAK,QAAQ,OAAO;;;AAKtB,IAAIC,uBAA8C;;;;;AAMlD,SAAgB,oBAAoC;AACnD,KAAI,CAAC,qBACJ,wBAAuB,IAAI,gBAAgB;AAE5C,QAAO;;;;;AAMR,SAAgB,sBAA4B;AAC3C,wBAAuB"}