@kuckit/sdk 1.0.2 → 1.0.3

package/dist/registry-CL_5erME.js

@@ -0,0 +1,132 @@
+//#region src/modules/registry.ts
+/**
+* Validates that a capability string matches expected patterns
+*/
+const isValidCapability = (cap) => {
+	if ([
+		"nav.item",
+		"settings.page",
+		"dashboard.widget",
+		"api.webhook",
+		"api.public",
+		"slot.provider"
+	].includes(cap)) return true;
+	if (cap.startsWith("custom.") && cap.length > 7) return true;
+	return false;
+};
+/**
+* Registry for loaded Kuckit modules
+*
+* Tracks all loaded modules and their capabilities for querying.
+*/
+var ModuleRegistry = class {
+	modules = /* @__PURE__ */ new Map();
+	frozen = false;
+	/**
+	* Register a loaded module
+	* @throws Error if registry is frozen or module ID already exists
+	*/
+	register(module) {
+		if (this.frozen) throw new Error(`ModuleRegistry is frozen. Cannot register module "${module.id}" after finalization.`);
+		if (this.modules.has(module.id)) throw new Error(`Module with ID "${module.id}" is already registered.`);
+		const capabilities = module.capabilities ?? [];
+		for (const cap of capabilities) if (!isValidCapability(cap)) throw new Error(`Invalid capability "${cap}" in module "${module.id}". Capabilities must be built-in (nav.item, settings.page, etc.) or custom.* prefixed.`);
+		this.modules.set(module.id, {
+			id: module.id,
+			displayName: module.displayName,
+			description: module.description,
+			version: module.version,
+			capabilities
+		});
+	}
+	/**
+	* Get all registered modules
+	*/
+	getAll() {
+		return Array.from(this.modules.values());
+	}
+	/**
+	* Get a module by ID
+	*/
+	getById(id) {
+		return this.modules.get(id);
+	}
+	/**
+	* Check if a module is registered
+	*/
+	has(id) {
+		return this.modules.has(id);
+	}
+	/**
+	* Get all modules that have a specific capability
+	*/
+	getWithCapability(capability) {
+		return this.getAll().filter((mod) => mod.capabilities.includes(capability));
+	}
+	/**
+	* Check if a specific module has a capability
+	*/
+	hasCapability(moduleId, capability) {
+		const module = this.modules.get(moduleId);
+		return module ? module.capabilities.includes(capability) : false;
+	}
+	/**
+	* Get all unique capabilities across all modules
+	*/
+	getAllCapabilities() {
+		const caps = /* @__PURE__ */ new Set();
+		for (const mod of this.modules.values()) for (const cap of mod.capabilities) caps.add(cap);
+		return Array.from(caps);
+	}
+	/**
+	* Freeze the registry to prevent further modifications
+	*/
+	freeze() {
+		this.frozen = true;
+	}
+	/**
+	* Check if registry is frozen
+	*/
+	isFrozen() {
+		return this.frozen;
+	}
+	/**
+	* Get the number of registered modules
+	*/
+	get size() {
+		return this.modules.size;
+	}
+	/**
+	* Clear all modules (only works if not frozen)
+	*/
+	clear() {
+		if (this.frozen) throw new Error("ModuleRegistry is frozen. Cannot clear modules.");
+		this.modules.clear();
+	}
+};
+let globalRegistry = null;
+/**
+* Get the global module registry
+* Creates one if it doesn't exist
+*/
+function getModuleRegistry() {
+	if (!globalRegistry) globalRegistry = new ModuleRegistry();
+	return globalRegistry;
+}
+/**
+* Get all modules that have a specific capability
+* Convenience function that uses the global registry
+*/
+function getModulesWithCapability(capability) {
+	return getModuleRegistry().getWithCapability(capability);
+}
+/**
+* Reset the global registry (mainly for testing)
+*/
+function resetModuleRegistry() {
+	globalRegistry = null;
+}
+
+//#endregion
+export { resetModuleRegistry as i, getModuleRegistry as n, getModulesWithCapability as r, ModuleRegistry as t };
+//# sourceMappingURL=registry-CL_5erME.js.map

package/dist/registry-CL_5erME.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-CL_5erME.js","names":["globalRegistry: ModuleRegistry | null"],"sources":["../src/modules/registry.ts"],"sourcesContent":["import type { ModuleCapability, KuckitModuleDefinition } from './types'\n\n/**\n * Information about a loaded module\n */\nexport interface LoadedModuleInfo {\n\t/** Module unique identifier */\n\tid: string\n\t/** Human-readable name */\n\tdisplayName?: string\n\t/** Module description */\n\tdescription?: string\n\t/** Module version */\n\tversion?: string\n\t/** Capabilities this module provides */\n\tcapabilities: ModuleCapability[]\n}\n\n/**\n * Validates that a capability string matches expected patterns\n */\nconst isValidCapability = (cap: string): cap is ModuleCapability => {\n\t// Built-in capabilities\n\tconst builtIn = [\n\t\t'nav.item',\n\t\t'settings.page',\n\t\t'dashboard.widget',\n\t\t'api.webhook',\n\t\t'api.public',\n\t\t'slot.provider',\n\t]\n\tif (builtIn.includes(cap)) return true\n\n\t// Custom capabilities must start with 'custom.'\n\tif (cap.startsWith('custom.') && cap.length > 7) return true\n\n\treturn false\n}\n\n/**\n * Registry for loaded Kuckit modules\n *\n * Tracks all loaded modules and their capabilities for querying.\n */\nexport class ModuleRegistry {\n\tprivate modules: Map<string, LoadedModuleInfo> = new Map()\n\tprivate frozen = false\n\n\t/**\n\t * Register a loaded module\n\t * @throws Error if registry is frozen or module ID already exists\n\t */\n\tregister(module: KuckitModuleDefinition): void {\n\t\tif (this.frozen) {\n\t\t\tthrow new Error(\n\t\t\t\t`ModuleRegistry is frozen. Cannot register module \"${module.id}\" after finalization.`\n\t\t\t)\n\t\t}\n\t\tif (this.modules.has(module.id)) {\n\t\t\tthrow new Error(`Module with ID \"${module.id}\" is already registered.`)\n\t\t}\n\n\t\t// Validate capabilities\n\t\tconst capabilities = module.capabilities ?? []\n\t\tfor (const cap of capabilities) {\n\t\t\tif (!isValidCapability(cap)) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Invalid capability \"${cap}\" in module \"${module.id}\". ` +\n\t\t\t\t\t\t`Capabilities must be built-in (nav.item, settings.page, etc.) or custom.* prefixed.`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\n\t\tthis.modules.set(module.id, {\n\t\t\tid: module.id,\n\t\t\tdisplayName: module.displayName,\n\t\t\tdescription: module.description,\n\t\t\tversion: module.version,\n\t\t\tcapabilities,\n\t\t})\n\t}\n\n\t/**\n\t * Get all registered modules\n\t */\n\tgetAll(): LoadedModuleInfo[] {\n\t\treturn Array.from(this.modules.values())\n\t}\n\n\t/**\n\t * Get a module by ID\n\t */\n\tgetById(id: string): LoadedModuleInfo | undefined {\n\t\treturn this.modules.get(id)\n\t}\n\n\t/**\n\t * Check if a module is registered\n\t */\n\thas(id: string): boolean {\n\t\treturn this.modules.has(id)\n\t}\n\n\t/**\n\t * Get all modules that have a specific capability\n\t */\n\tgetWithCapability(capability: ModuleCapability): LoadedModuleInfo[] {\n\t\treturn this.getAll().filter((mod) => mod.capabilities.includes(capability))\n\t}\n\n\t/**\n\t * Check if a specific module has a capability\n\t */\n\thasCapability(moduleId: string, capability: ModuleCapability): boolean {\n\t\tconst module = this.modules.get(moduleId)\n\t\treturn module ? module.capabilities.includes(capability) : false\n\t}\n\n\t/**\n\t * Get all unique capabilities across all modules\n\t */\n\tgetAllCapabilities(): ModuleCapability[] {\n\t\tconst caps = new Set<ModuleCapability>()\n\t\tfor (const mod of this.modules.values()) {\n\t\t\tfor (const cap of mod.capabilities) {\n\t\t\t\tcaps.add(cap)\n\t\t\t}\n\t\t}\n\t\treturn Array.from(caps)\n\t}\n\n\t/**\n\t * Freeze the registry to prevent further modifications\n\t */\n\tfreeze(): void {\n\t\tthis.frozen = true\n\t}\n\n\t/**\n\t * Check if registry is frozen\n\t */\n\tisFrozen(): boolean {\n\t\treturn this.frozen\n\t}\n\n\t/**\n\t * Get the number of registered modules\n\t */\n\tget size(): number {\n\t\treturn this.modules.size\n\t}\n\n\t/**\n\t * Clear all modules (only works if not frozen)\n\t */\n\tclear(): void {\n\t\tif (this.frozen) {\n\t\t\tthrow new Error('ModuleRegistry is frozen. Cannot clear modules.')\n\t\t}\n\t\tthis.modules.clear()\n\t}\n}\n\n// Global module registry instance\nlet globalRegistry: ModuleRegistry | null = null\n\n/**\n * Get the global module registry\n * Creates one if it doesn't exist\n */\nexport function getModuleRegistry(): ModuleRegistry {\n\tif (!globalRegistry) {\n\t\tglobalRegistry = new ModuleRegistry()\n\t}\n\treturn globalRegistry\n}\n\n/**\n * Get all modules that have a specific capability\n * Convenience function that uses the global registry\n */\nexport function getModulesWithCapability(capability: ModuleCapability): LoadedModuleInfo[] {\n\treturn getModuleRegistry().getWithCapability(capability)\n}\n\n/**\n * Reset the global registry (mainly for testing)\n */\nexport function resetModuleRegistry(): void {\n\tglobalRegistry = null\n}\n"],"mappings":";;;;AAqBA,MAAM,qBAAqB,QAAyC;AAUnE,KARgB;EACf;EACA;EACA;EACA;EACA;EACA;EACA,CACW,SAAS,IAAI,CAAE,QAAO;AAGlC,KAAI,IAAI,WAAW,UAAU,IAAI,IAAI,SAAS,EAAG,QAAO;AAExD,QAAO;;;;;;;AAQR,IAAa,iBAAb,MAA4B;CAC3B,AAAQ,0BAAyC,IAAI,KAAK;CAC1D,AAAQ,SAAS;;;;;CAMjB,SAAS,QAAsC;AAC9C,MAAI,KAAK,OACR,OAAM,IAAI,MACT,qDAAqD,OAAO,GAAG,uBAC/D;AAEF,MAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAC9B,OAAM,IAAI,MAAM,mBAAmB,OAAO,GAAG,0BAA0B;EAIxE,MAAM,eAAe,OAAO,gBAAgB,EAAE;AAC9C,OAAK,MAAM,OAAO,aACjB,KAAI,CAAC,kBAAkB,IAAI,CAC1B,OAAM,IAAI,MACT,uBAAuB,IAAI,eAAe,OAAO,GAAG,wFAEpD;AAIH,OAAK,QAAQ,IAAI,OAAO,IAAI;GAC3B,IAAI,OAAO;GACX,aAAa,OAAO;GACpB,aAAa,OAAO;GACpB,SAAS,OAAO;GAChB;GACA,CAAC;;;;;CAMH,SAA6B;AAC5B,SAAO,MAAM,KAAK,KAAK,QAAQ,QAAQ,CAAC;;;;;CAMzC,QAAQ,IAA0C;AACjD,SAAO,KAAK,QAAQ,IAAI,GAAG;;;;;CAM5B,IAAI,IAAqB;AACxB,SAAO,KAAK,QAAQ,IAAI,GAAG;;;;;CAM5B,kBAAkB,YAAkD;AACnE,SAAO,KAAK,QAAQ,CAAC,QAAQ,QAAQ,IAAI,aAAa,SAAS,WAAW,CAAC;;;;;CAM5E,cAAc,UAAkB,YAAuC;EACtE,MAAM,SAAS,KAAK,QAAQ,IAAI,SAAS;AACzC,SAAO,SAAS,OAAO,aAAa,SAAS,WAAW,GAAG;;;;;CAM5D,qBAAyC;EACxC,MAAM,uBAAO,IAAI,KAAuB;AACxC,OAAK,MAAM,OAAO,KAAK,QAAQ,QAAQ,CACtC,MAAK,MAAM,OAAO,IAAI,aACrB,MAAK,IAAI,IAAI;AAGf,SAAO,MAAM,KAAK,KAAK;;;;;CAMxB,SAAe;AACd,OAAK,SAAS;;;;;CAMf,WAAoB;AACnB,SAAO,KAAK;;;;;CAMb,IAAI,OAAe;AAClB,SAAO,KAAK,QAAQ;;;;;CAMrB,QAAc;AACb,MAAI,KAAK,OACR,OAAM,IAAI,MAAM,kDAAkD;AAEnE,OAAK,QAAQ,OAAO;;;AAKtB,IAAIA,iBAAwC;;;;;AAM5C,SAAgB,oBAAoC;AACnD,KAAI,CAAC,eACJ,kBAAiB,IAAI,gBAAgB;AAEtC,QAAO;;;;;;AAOR,SAAgB,yBAAyB,YAAkD;AAC1F,QAAO,mBAAmB,CAAC,kBAAkB,WAAW;;;;;AAMzD,SAAgB,sBAA4B;AAC3C,kBAAiB"}

package/dist/registry-CfpVCPcW.d.ts

@@ -0,0 +1,68 @@
+import { PgTable } from "drizzle-orm/pg-core";
+
+//#region src/schema/registry.d.ts
+
+/**
+ * Entry for a registered schema
+ */
+interface SchemaEntry {
+  /** Module that owns this schema */
+  moduleId: string;
+  /** Table name identifier */
+  tableName: string;
+  /** Drizzle table schema */
+  schema: PgTable;
+}
+/**
+ * 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.
+ */
+declare class SchemaRegistry {
+  private schemas;
+  /**
+   * 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: string, tableName: string, schema: PgTable): void;
+  /**
+   * Get all registered schemas
+   */
+  getAll(): Map<string, SchemaEntry>;
+  /**
+   * Get schemas registered by a specific module
+   */
+  getByModule(moduleId: string): SchemaEntry[];
+  /**
+   * Get all schemas as a flat object for drizzle-kit
+   * Keys are table names, values are PgTable schemas
+   */
+  getAllSchemas(): Record<string, PgTable>;
+  /**
+   * Check if any schemas are registered
+   */
+  hasSchemas(): boolean;
+  /**
+   * Get the count of registered schemas
+   */
+  get size(): number;
+  /**
+   * Clear all schemas (mainly for testing)
+   */
+  clear(): void;
+}
+/**
+ * Get the global schema registry
+ * Creates one if it doesn't exist
+ */
+declare function getSchemaRegistry(): SchemaRegistry;
+/**
+ * Reset the global schema registry (mainly for testing)
+ */
+declare function resetSchemaRegistry(): void;
+//#endregion
+export { resetSchemaRegistry as i, SchemaRegistry as n, getSchemaRegistry as r, SchemaEntry as t };
+//# sourceMappingURL=registry-CfpVCPcW.d.ts.map

package/dist/registry-DrTkgmtH.d.ts

@@ -0,0 +1,90 @@
+import { c as ModuleCapability, i as KuckitModuleDefinition } from "./types-ByO301S-.js";
+
+//#region src/modules/registry.d.ts
+
+/**
+ * Information about a loaded module
+ */
+interface LoadedModuleInfo {
+  /** Module unique identifier */
+  id: string;
+  /** Human-readable name */
+  displayName?: string;
+  /** Module description */
+  description?: string;
+  /** Module version */
+  version?: string;
+  /** Capabilities this module provides */
+  capabilities: ModuleCapability[];
+}
+/**
+ * Registry for loaded Kuckit modules
+ *
+ * Tracks all loaded modules and their capabilities for querying.
+ */
+declare class ModuleRegistry {
+  private modules;
+  private frozen;
+  /**
+   * Register a loaded module
+   * @throws Error if registry is frozen or module ID already exists
+   */
+  register(module: KuckitModuleDefinition): void;
+  /**
+   * Get all registered modules
+   */
+  getAll(): LoadedModuleInfo[];
+  /**
+   * Get a module by ID
+   */
+  getById(id: string): LoadedModuleInfo | undefined;
+  /**
+   * Check if a module is registered
+   */
+  has(id: string): boolean;
+  /**
+   * Get all modules that have a specific capability
+   */
+  getWithCapability(capability: ModuleCapability): LoadedModuleInfo[];
+  /**
+   * Check if a specific module has a capability
+   */
+  hasCapability(moduleId: string, capability: ModuleCapability): boolean;
+  /**
+   * Get all unique capabilities across all modules
+   */
+  getAllCapabilities(): ModuleCapability[];
+  /**
+   * Freeze the registry to prevent further modifications
+   */
+  freeze(): void;
+  /**
+   * Check if registry is frozen
+   */
+  isFrozen(): boolean;
+  /**
+   * Get the number of registered modules
+   */
+  get size(): number;
+  /**
+   * Clear all modules (only works if not frozen)
+   */
+  clear(): void;
+}
+/**
+ * Get the global module registry
+ * Creates one if it doesn't exist
+ */
+declare function getModuleRegistry(): ModuleRegistry;
+/**
+ * Get all modules that have a specific capability
+ * Convenience function that uses the global registry
+ */
+declare function getModulesWithCapability(capability: ModuleCapability): LoadedModuleInfo[];
+/**
+ * Reset the global registry (mainly for testing)
+ */
+declare function resetModuleRegistry(): void;
+//#endregion
+export { resetModuleRegistry as a, getModulesWithCapability as i, ModuleRegistry as n, getModuleRegistry as r, LoadedModuleInfo as t };
+//# sourceMappingURL=registry-DrTkgmtH.d.ts.map

package/dist/schema/index.d.ts

@@ -0,0 +1,3 @@
+import { i as resetSchemaRegistry, n as SchemaRegistry, r as getSchemaRegistry, t as SchemaEntry } from "../registry-CfpVCPcW.js";
+import { t as PgTable } from "../index-Dfcz46Ma.js";
+export { PgTable, SchemaEntry, SchemaRegistry, getSchemaRegistry, resetSchemaRegistry };

package/dist/schema/index.js

@@ -0,0 +1,4 @@
+import { n as getSchemaRegistry, r as resetSchemaRegistry, t as SchemaRegistry } from "../registry-BPYpBtYx.js";
+import "../schema-BuA2HF_H.js";
+
+export { SchemaRegistry, getSchemaRegistry, resetSchemaRegistry };

package/dist/schema/registry.d.ts

@@ -0,0 +1,2 @@
+import { i as resetSchemaRegistry, n as SchemaRegistry, r as getSchemaRegistry, t as SchemaEntry } from "../registry-CfpVCPcW.js";
+export { SchemaEntry, SchemaRegistry, getSchemaRegistry, resetSchemaRegistry };

package/dist/schema/registry.js

@@ -0,0 +1,3 @@
+import { n as getSchemaRegistry, r as resetSchemaRegistry, t as SchemaRegistry } from "../registry-BPYpBtYx.js";
+
+export { SchemaRegistry, getSchemaRegistry, resetSchemaRegistry };

package/dist/schema-BuA2HF_H.js

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

package/dist/types-ByO301S-.d.ts

@@ -0,0 +1,112 @@
+import { n as CoreContainer } from "./types-DKCy16X1.js";
+import { PgTable } from "drizzle-orm/pg-core";
+
+//#region src/modules/types.d.ts
+
+/**
+ * Built-in capability types for common module features
+ */
+type BuiltInCapability = 'nav.item' | 'settings.page' | 'dashboard.widget' | 'api.webhook' | 'api.public' | 'slot.provider';
+/**
+ * Module capability type - built-in or custom
+ * Custom capabilities must be prefixed with 'custom.'
+ */
+type ModuleCapability = BuiltInCapability | `custom.${string}`;
+/**
+ * Module metadata for discovery and documentation
+ */
+interface KuckitModuleMeta {
+  /** Unique identifier, e.g., 'kuckit.users' or 'acme.billing' */
+  id: string;
+  /** Human-readable name */
+  displayName?: string;
+  /** Module description */
+  description?: string;
+  /** Module version */
+  version?: string;
+  /** Capabilities this module provides */
+  capabilities?: ModuleCapability[];
+}
+/**
+ * Context passed to module hooks
+ */
+interface KuckitModuleContext<TConfig = unknown> {
+  /** DI container for registering services */
+  container: CoreContainer;
+  /** Environment name (development, production, etc.) */
+  env: string;
+  /** Module-specific configuration */
+  config: TConfig;
+  /** Register a Drizzle schema for this module */
+  registerSchema: (tableName: string, schema: PgTable) => void;
+}
+/**
+ * API registration for oRPC routers or other API handlers
+ */
+interface ApiRegistration {
+  /** Type of API handler */
+  type: 'rpc-router' | 'rest-router' | 'graphql-resolver';
+  /** Router/handler name, e.g., 'users' */
+  name: string;
+  /** The actual router/handler instance */
+  router: unknown;
+  /** Optional path prefix */
+  prefix?: string;
+}
+/**
+ * Module lifecycle hooks
+ */
+interface KuckitModuleHooks<TConfig = unknown> {
+  /**
+   * Called early - register DI bindings (repositories, services, use cases)
+   * This is where you wire up your module's dependencies
+   */
+  register?(ctx: KuckitModuleContext<TConfig>): void | Promise<void>;
+  /**
+   * Called after all modules registered - register API endpoints
+   * Use addApiRegistration to contribute routes to the application
+   */
+  registerApi?(ctx: KuckitModuleContext<TConfig> & {
+    addApiRegistration: (reg: ApiRegistration) => void;
+  }): void | Promise<void>;
+  /**
+   * Called after everything is wired - final initialization
+   * Good place for startup tasks like cache warming, health checks, etc.
+   */
+  onBootstrap?(ctx: KuckitModuleContext<TConfig>): void | Promise<void>;
+  /**
+   * Optional: cleanup on shutdown
+   * Close connections, flush buffers, etc.
+   */
+  onShutdown?(ctx: KuckitModuleContext<TConfig>): void | Promise<void>;
+}
+/**
+ * Complete module definition combining metadata and hooks
+ */
+interface KuckitModuleDefinition<TConfig = unknown> extends KuckitModuleMeta, KuckitModuleHooks<TConfig> {}
+/**
+ * Module specification in application config
+ *
+ * You can specify a module in two ways:
+ * 1. `module`: Direct reference to a module definition (preferred in monorepos)
+ * 2. `package`: NPM package name for dynamic import (for published packages)
+ */
+interface ModuleSpec<TConfig = unknown> {
+  /** Direct module definition (preferred in monorepos for better type safety) */
+  module?: KuckitModuleDefinition<TConfig>;
+  /** NPM package name or relative path for dynamic import, e.g., '@acme/billing-module' */
+  package?: string;
+  /** Module-specific configuration */
+  config?: TConfig;
+  /** Whether to skip this module */
+  disabled?: boolean;
+}
+/**
+ * Internal type for loaded modules with their config
+ */
+interface LoadedModule<TConfig = unknown> extends KuckitModuleDefinition<TConfig> {
+  _config?: TConfig;
+}
+//#endregion
+export { KuckitModuleHooks as a, ModuleCapability as c, KuckitModuleDefinition as i, ModuleSpec as l, BuiltInCapability as n, KuckitModuleMeta as o, KuckitModuleContext as r, LoadedModule as s, ApiRegistration as t };
+//# sourceMappingURL=types-ByO301S-.d.ts.map

package/dist/types-DKCy16X1.d.ts

@@ -0,0 +1,51 @@
+import { AwilixContainer, Resolver } from "awilix";
+import { CacheStore, Clock, EventBus, Logger, RateLimiterStore } from "@kuckit/domain";
+import { auth } from "@kuckit/auth";
+
+//#region src/types.d.ts
+
+/**
+ * Core SDK configuration
+ * This is the minimal config needed to bootstrap the SDK
+ */
+interface CoreConfig {
+  databaseUrl: string;
+  enableFileLogging: boolean;
+  logDir: string;
+  logLevel: 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+  env: string;
+}
+/**
+ * Core cradle interface - the stable contract for all SDK consumers
+ * This defines the services available in the DI container after core registration
+ *
+ * Keep this minimal and stable; breaking changes require major version bumps
+ */
+interface CoreCradle {
+  config: CoreConfig;
+  dbPool: unknown;
+  db: unknown;
+  clock: Clock;
+  logger: Logger;
+  errorHandler: unknown;
+  auth: typeof auth;
+  aiProvider: unknown;
+  eventBus: EventBus;
+  cacheStore: CacheStore;
+  rateLimiterStore: RateLimiterStore;
+  requestId?: string;
+  session?: {
+    user?: {
+      id?: string;
+    };
+  } | null;
+  requestLogger?: Logger;
+  [key: string]: Resolver<any> | any;
+}
+/**
+ * Core container type with CoreCradle
+ */
+type CoreContainer = AwilixContainer<CoreCradle>;
+//#endregion
+export { CoreContainer as n, CoreCradle as r, CoreConfig as t };
+//# sourceMappingURL=types-DKCy16X1.d.ts.map

package/dist/types-DxaDmkQo.d.ts

@@ -0,0 +1,87 @@
+//#region src/config/types.d.ts
+/**
+ * Configuration for a single Kuckit module
+ */
+interface KuckitModuleConfig<TConfig = unknown> {
+  /** NPM package name, e.g., '@kuckit/users-module' or '@acme/billing-module' */
+  package: string;
+  /** Module-specific configuration */
+  config?: TConfig;
+  /** Whether this module is enabled (default: true). Can use environment variables. */
+  enabled?: boolean;
+}
+/**
+ * Discovery configuration for auto-detecting modules
+ */
+interface KuckitDiscoveryConfig {
+  /** Enable auto-discovery of modules in node_modules (default: false) */
+  enabled?: boolean;
+  /** Glob patterns for module detection (default: ['@star/kuckit-star-module']) */
+  patterns?: string[];
+}
+/**
+ * Client-specific configuration
+ */
+interface KuckitClientConfig {
+  /** Component registry mode: 'global' or 'context' (default: 'context') */
+  componentRegistry?: 'global' | 'context';
+  /** Enable automatic route injection (default: true) */
+  routeInjection?: boolean;
+}
+/**
+ * Server-specific configuration
+ */
+interface KuckitServerConfig {
+  /** API route prefix (default: '/api') */
+  apiPrefix?: string;
+}
+/**
+ * Unified Kuckit configuration
+ *
+ * This is the single source of truth for both server and client module configuration.
+ * Place this in `kuckit.config.ts` at your project root.
+ *
+ * @example
+ * ```typescript
+ * import { defineConfig } from '@kuckit/sdk'
+ *
+ * export default defineConfig({
+ *   modules: [
+ *     { package: '@kuckit/users-module' },
+ *     { package: '@acme/billing-module', config: { currency: 'USD' } },
+ *     {
+ *       package: '@acme/analytics-module',
+ *       enabled: process.env.NODE_ENV === 'production',
+ *     },
+ *   ],
+ *
+ *   server: {
+ *     apiPrefix: '/api',
+ *   },
+ *
+ *   client: {
+ *     routeInjection: true,
+ *   },
+ * })
+ * ```
+ */
+interface KuckitConfig {
+  /** List of modules to load */
+  modules: KuckitModuleConfig[];
+  /** Auto-discovery settings (Phase 3.2) */
+  discovery?: KuckitDiscoveryConfig;
+  /** Client-specific settings */
+  client?: KuckitClientConfig;
+  /** Server-specific settings */
+  server?: KuckitServerConfig;
+}
+/**
+ * Result of loading a Kuckit config file
+ */
+interface LoadedKuckitConfig extends KuckitConfig {
+  /** Path to the config file that was loaded */
+  _configPath: string;
+}
+//#endregion
+export { KuckitServerConfig as a, KuckitModuleConfig as i, KuckitConfig as n, LoadedKuckitConfig as o, KuckitDiscoveryConfig as r, KuckitClientConfig as t };
+//# sourceMappingURL=types-DxaDmkQo.d.ts.map

package/dist/types.d.ts

@@ -0,0 +1,2 @@
+import { n as CoreContainer, r as CoreCradle, t as CoreConfig } from "./types-DKCy16X1.js";
+export { CoreConfig, CoreContainer, CoreCradle };

package/dist/types.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kuckit/sdk",
-	"version": "1.0.2",
+	"version": "1.0.3",
 	"type": "module",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -22,13 +22,13 @@
 		"prepublishOnly": "npm run build && node ../../scripts/resolve-workspace-protocols.cjs && node ../../scripts/check-no-workspace-protocol.cjs"
 	},
 	"dependencies": {
-		"@kuckit/domain": "^1.0.2",
-		"@kuckit/application": "^1.0.2",
-		"@kuckit/infrastructure": "^1.0.2",
-		"@kuckit/api": "^1.0.2",
-		"@kuckit/contracts": "^1.0.2",
-		"@kuckit/auth": "^1.0.2",
-		"@kuckit/db": "^1.0.2",
+		"@kuckit/domain": "^1.0.3",
+		"@kuckit/application": "^1.0.3",
+		"@kuckit/infrastructure": "^1.0.3",
+		"@kuckit/api": "^1.0.3",
+		"@kuckit/contracts": "^1.0.3",
+		"@kuckit/auth": "^1.0.3",
+		"@kuckit/db": "^1.0.3",
 		"awilix": "^12.0.5",
 		"jiti": "^2.4.2"
 	},