@dofe/infra-module-registry 0.1.0

package/dist/dynamic-feature.module.d.ts

@@ -0,0 +1,88 @@
+import { DynamicModule, Provider, Type } from '@nestjs/common';
+import { ModuleRegistration } from './module-registry.service';
+/**
+ * Feature module configuration
+ */
+export interface FeatureConfig {
+    /** Feature identifier */
+    id: string;
+    /** Module IDs to include */
+    modules: string[];
+    /** Additional providers to register */
+    providers?: Provider[];
+    /** Additional exports */
+    exports?: (string | Type<any>)[];
+}
+/**
+ * Options for DynamicFeatureModule
+ */
+export interface DynamicFeatureModuleOptions {
+    /** Feature configurations */
+    features: FeatureConfig[];
+    /** Auto-register modules to registry */
+    autoRegister?: boolean;
+    /** Global module (available everywhere) */
+    isGlobal?: boolean;
+}
+/**
+ * Dynamic module that loads feature-specific modules on demand.
+ *
+ * Reduces the "dependency explosion" problem by grouping related modules
+ * and loading them conditionally based on feature flags or configuration.
+ *
+ * @example
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     DynamicFeatureModule.register({
+ *       features: [
+ *         {
+ *           id: 'bot-management',
+ *           modules: ['bot-query', 'bot-sse', 'bot-config-resolver'],
+ *         },
+ *         {
+ *           id: 'model-management',
+ *           modules: ['model-sync', 'model-verification'],
+ *         },
+ *       ],
+ *     }),
+ *   ],
+ * })
+ * export class BotApiModule {}
+ * ```
+ */
+export declare class DynamicFeatureModule {
+    /**
+     * Create a dynamic module with feature-based loading
+     */
+    static register(options: DynamicFeatureModuleOptions): DynamicModule;
+    /**
+     * Create a dynamic module with pre-configured module map
+     *
+     * Use this when you have a static mapping of module IDs to classes
+     */
+    static withModuleMap(moduleMap: Record<string, Type<any>>, featureIds: string[], options?: {
+        isGlobal?: boolean;
+    }): DynamicModule;
+    /**
+     * Create a dynamic module with registry integration
+     *
+     * This approach registers all modules to the registry first,
+     * then uses dependency resolution to determine load order
+     */
+    static withRegistry(registrations: ModuleRegistration[], options?: {
+        categories?: string[];
+        includeOptional?: boolean;
+        isGlobal?: boolean;
+    }): DynamicModule;
+    /**
+     * Resolve module ID to class
+     *
+     * In a real implementation, this could use:
+     * - A static module map
+     * - Dynamic import()
+     * - ModuleRegistry lookup
+     */
+    private static resolveModule;
+}
+//# sourceMappingURL=dynamic-feature.module.d.ts.map

package/dist/dynamic-feature.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-feature.module.d.ts","sourceRoot":"","sources":["../src/dynamic-feature.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,QAAQ,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAkB,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uCAAuC;IACvC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,yBAAyB;IACzB,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,6BAA6B;IAC7B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,wCAAwC;IACxC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,oBAAoB;IAC/B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,2BAA2B,GAAG,aAAa;IAiCpE;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EACpC,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,aAAa;IAiBhB;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CACjB,aAAa,EAAE,kBAAkB,EAAE,EACnC,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,GACA,aAAa;IAoBhB;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;CAY7B"}

package/dist/dynamic-feature.module.js

@@ -0,0 +1,139 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var DynamicFeatureModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamicFeatureModule = void 0;
+const common_1 = require("@nestjs/common");
+const module_registry_service_1 = require("./module-registry.service");
+/**
+ * Dynamic module that loads feature-specific modules on demand.
+ *
+ * Reduces the "dependency explosion" problem by grouping related modules
+ * and loading them conditionally based on feature flags or configuration.
+ *
+ * @example
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     DynamicFeatureModule.register({
+ *       features: [
+ *         {
+ *           id: 'bot-management',
+ *           modules: ['bot-query', 'bot-sse', 'bot-config-resolver'],
+ *         },
+ *         {
+ *           id: 'model-management',
+ *           modules: ['model-sync', 'model-verification'],
+ *         },
+ *       ],
+ *     }),
+ *   ],
+ * })
+ * export class BotApiModule {}
+ * ```
+ */
+let DynamicFeatureModule = DynamicFeatureModule_1 = class DynamicFeatureModule {
+    /**
+     * Create a dynamic module with feature-based loading
+     */
+    static register(options) {
+        const { features, autoRegister = true, isGlobal = false } = options;
+        // Collect all module classes from features
+        const moduleClasses = [];
+        const providers = [];
+        const exports = [];
+        for (const feature of features) {
+            for (const moduleId of feature.modules) {
+                // In a real implementation, we would resolve module IDs to actual classes
+                // For now, this requires pre-registered modules in ModuleRegistry
+                moduleClasses.push(this.resolveModule(moduleId));
+            }
+            if (feature.providers) {
+                providers.push(...feature.providers);
+            }
+            if (feature.exports) {
+                exports.push(...feature.exports);
+            }
+        }
+        return {
+            module: DynamicFeatureModule_1,
+            imports: moduleClasses,
+            providers: autoRegister ? [module_registry_service_1.ModuleRegistry, ...providers] : providers,
+            exports: [...exports],
+            global: isGlobal,
+        };
+    }
+    /**
+     * Create a dynamic module with pre-configured module map
+     *
+     * Use this when you have a static mapping of module IDs to classes
+     */
+    static withModuleMap(moduleMap, featureIds, options) {
+        const modules = [];
+        for (const id of featureIds) {
+            const moduleClass = moduleMap[id];
+            if (moduleClass) {
+                modules.push(moduleClass);
+            }
+        }
+        return {
+            module: DynamicFeatureModule_1,
+            imports: modules,
+            global: options?.isGlobal,
+        };
+    }
+    /**
+     * Create a dynamic module with registry integration
+     *
+     * This approach registers all modules to the registry first,
+     * then uses dependency resolution to determine load order
+     */
+    static withRegistry(registrations, options) {
+        // Create a temporary registry for resolution
+        const registry = new module_registry_service_1.ModuleRegistry();
+        registry.registerAll(registrations);
+        // Get modules in dependency order
+        const modules = registry.getModuleClasses({
+            categories: options?.categories,
+            includeOptional: options?.includeOptional,
+        });
+        return {
+            module: DynamicFeatureModule_1,
+            imports: modules,
+            providers: [module_registry_service_1.ModuleRegistry],
+            exports: [module_registry_service_1.ModuleRegistry],
+            global: options?.isGlobal,
+        };
+    }
+    /**
+     * Resolve module ID to class
+     *
+     * In a real implementation, this could use:
+     * - A static module map
+     * - Dynamic import()
+     * - ModuleRegistry lookup
+     */
+    static resolveModule(moduleId) {
+        // Placeholder - in real implementation, this would resolve to actual module class
+        // For now, return a dummy module that will be replaced
+        let PlaceholderModule = class PlaceholderModule {
+        };
+        PlaceholderModule = __decorate([
+            (0, common_1.Module)({})
+        ], PlaceholderModule);
+        Object.defineProperty(PlaceholderModule, 'name', {
+            value: `Placeholder_${moduleId}`,
+        });
+        return PlaceholderModule;
+    }
+};
+exports.DynamicFeatureModule = DynamicFeatureModule;
+exports.DynamicFeatureModule = DynamicFeatureModule = DynamicFeatureModule_1 = __decorate([
+    (0, common_1.Module)({})
+], DynamicFeatureModule);
+//# sourceMappingURL=dynamic-feature.module.js.map

package/dist/dynamic-feature.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-feature.module.js","sourceRoot":"","sources":["../src/dynamic-feature.module.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ModuleRegistry 模块导出
+ *
+ * 提供通用的模块注册和动态加载功能，不包含任何业务模块定义。
+ * 业务模块映射应放在各自的 API 模块或 domain 层。
+ */
+export { ModuleRegistryModule } from './module-registry.module';
+export { ModuleRegistry } from './module-registry.service';
+export type { ModuleRegistration, ModuleCategory, ModuleGroupConfig, } from './module-registry.service';
+export { DynamicFeatureModule } from './dynamic-feature.module';
+export { RegisterModule, type RegisterModuleMetadata, } from './register-module.decorator';
+export { ModuleScanner, MODULE_SCANNER_OPTIONS, type ModuleScannerOptions, } from './module-scanner.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,EACL,cAAc,EACd,KAAK,sBAAsB,GAC5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * ModuleRegistry 模块导出
+ *
+ * 提供通用的模块注册和动态加载功能，不包含任何业务模块定义。
+ * 业务模块映射应放在各自的 API 模块或 domain 层。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODULE_SCANNER_OPTIONS = exports.ModuleScanner = exports.RegisterModule = exports.DynamicFeatureModule = exports.ModuleRegistry = exports.ModuleRegistryModule = void 0;
+var module_registry_module_1 = require("./module-registry.module");
+Object.defineProperty(exports, "ModuleRegistryModule", { enumerable: true, get: function () { return module_registry_module_1.ModuleRegistryModule; } });
+var module_registry_service_1 = require("./module-registry.service");
+Object.defineProperty(exports, "ModuleRegistry", { enumerable: true, get: function () { return module_registry_service_1.ModuleRegistry; } });
+var dynamic_feature_module_1 = require("./dynamic-feature.module");
+Object.defineProperty(exports, "DynamicFeatureModule", { enumerable: true, get: function () { return dynamic_feature_module_1.DynamicFeatureModule; } });
+// Auto-registration
+var register_module_decorator_1 = require("./register-module.decorator");
+Object.defineProperty(exports, "RegisterModule", { enumerable: true, get: function () { return register_module_decorator_1.RegisterModule; } });
+var module_scanner_service_1 = require("./module-scanner.service");
+Object.defineProperty(exports, "ModuleScanner", { enumerable: true, get: function () { return module_scanner_service_1.ModuleScanner; } });
+Object.defineProperty(exports, "MODULE_SCANNER_OPTIONS", { enumerable: true, get: function () { return module_scanner_service_1.MODULE_SCANNER_OPTIONS; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAC7B,qEAA2D;AAAlD,yHAAA,cAAc,OAAA;AAMvB,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAE7B,oBAAoB;AACpB,yEAGqC;AAFnC,2HAAA,cAAc,OAAA;AAGhB,mEAIkC;AAHhC,uHAAA,aAAa,OAAA;AACb,gIAAA,sBAAsB,OAAA"}

package/dist/module-registry.module.d.ts

@@ -0,0 +1,13 @@
+import { DynamicModule } from '@nestjs/common';
+import { ModuleScannerOptions } from './module-scanner.service';
+export declare class ModuleRegistryModule {
+    /**
+     * Register with custom scanner options
+     */
+    static withOptions(options: ModuleScannerOptions): DynamicModule;
+    /**
+     * Register without auto-scan (manual registration only)
+     */
+    static withoutAutoScan(): DynamicModule;
+}
+//# sourceMappingURL=module-registry.module.d.ts.map

package/dist/module-registry.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-registry.module.d.ts","sourceRoot":"","sources":["../src/module-registry.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,aAAa,EAAY,MAAM,gBAAgB,CAAC;AAEzE,OAAO,EAGL,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAElC,qBAKa,oBAAoB;IAC/B;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa;IAchE;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,aAAa;CAGxC"}

package/dist/module-registry.module.js

@@ -0,0 +1,45 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var ModuleRegistryModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModuleRegistryModule = void 0;
+const common_1 = require("@nestjs/common");
+const module_registry_service_1 = require("./module-registry.service");
+const module_scanner_service_1 = require("./module-scanner.service");
+let ModuleRegistryModule = ModuleRegistryModule_1 = class ModuleRegistryModule {
+    /**
+     * Register with custom scanner options
+     */
+    static withOptions(options) {
+        const optionsProvider = {
+            provide: module_scanner_service_1.MODULE_SCANNER_OPTIONS,
+            useValue: options,
+        };
+        return {
+            module: ModuleRegistryModule_1,
+            providers: [module_registry_service_1.ModuleRegistry, module_scanner_service_1.ModuleScanner, optionsProvider],
+            exports: [module_registry_service_1.ModuleRegistry, module_scanner_service_1.ModuleScanner],
+            global: true,
+        };
+    }
+    /**
+     * Register without auto-scan (manual registration only)
+     */
+    static withoutAutoScan() {
+        return this.withOptions({ autoScan: false });
+    }
+};
+exports.ModuleRegistryModule = ModuleRegistryModule;
+exports.ModuleRegistryModule = ModuleRegistryModule = ModuleRegistryModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [module_registry_service_1.ModuleRegistry, module_scanner_service_1.ModuleScanner],
+        exports: [module_registry_service_1.ModuleRegistry, module_scanner_service_1.ModuleScanner],
+    })
+], ModuleRegistryModule);
+//# sourceMappingURL=module-registry.module.js.map

package/dist/module-registry.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-registry.module.js","sourceRoot":"","sources":["../src/module-registry.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAyE;AACzE,uEAA2D;AAC3D,qEAIkC;AAO3B,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAC/B;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAA6B;QAC9C,MAAM,eAAe,GAAa;YAChC,OAAO,EAAE,+CAAsB;YAC/B,QAAQ,EAAE,OAAO;SAClB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,sBAAoB;YAC5B,SAAS,EAAE,CAAC,wCAAc,EAAE,sCAAa,EAAE,eAAe,CAAC;YAC3D,OAAO,EAAE,CAAC,wCAAc,EAAE,sCAAa,CAAC;YACxC,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe;QACpB,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;CACF,CAAA;AAxBY,oDAAoB;+BAApB,oBAAoB;IALhC,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,wCAAc,EAAE,sCAAa,CAAC;QAC1C,OAAO,EAAE,CAAC,wCAAc,EAAE,sCAAa,CAAC;KACzC,CAAC;GACW,oBAAoB,CAwBhC"}

package/dist/module-registry.service.d.ts

@@ -0,0 +1,130 @@
+import { OnModuleInit, Type } from '@nestjs/common';
+/**
+ * Module feature category for grouping related modules
+ */
+export type ModuleCategory = 'database' | 'cache' | 'queue' | 'client' | 'domain' | 'infrastructure' | 'integration' | 'feature' | 'monitoring' | 'optional';
+/**
+ * Module registration metadata
+ */
+export interface ModuleRegistration {
+    /** Unique module identifier */
+    id: string;
+    /** Module category for grouping */
+    category: ModuleCategory;
+    /** Module class reference */
+    module: Type<any>;
+    /** Human-readable name */
+    name?: string;
+    /** Module description */
+    description?: string;
+    /** Dependencies (module IDs that must be loaded first) */
+    dependencies?: string[];
+    /** Whether module is required for app to function */
+    required?: boolean;
+    /** Whether module is enabled (can be toggled via config) */
+    enabled?: boolean;
+    /** Priority for load order (lower = earlier) */
+    priority?: number;
+}
+/**
+ * Module group configuration
+ */
+export interface ModuleGroupConfig {
+    /** Group ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Module IDs in this group */
+    modules: string[];
+    /** Whether all modules in group are required */
+    required?: boolean;
+    /** Whether group is enabled by default */
+    enabled?: boolean;
+}
+/**
+ * Registry for dynamic module loading and dependency management.
+ *
+ * Provides:
+ * - Module registration with metadata
+ * - Dependency resolution
+ * - Conditional loading based on config
+ * - Load order optimization
+ *
+ * @example
+ * ```typescript
+ * // Register a module
+ * moduleRegistry.register({
+ *   id: 'bot-query',
+ *   category: 'domain',
+ *   module: BotQueryModule,
+ *   dependencies: ['prisma', 'redis'],
+ * });
+ *
+ * // Get modules for a feature
+ * const modules = moduleRegistry.getModulesForFeature('bot-management');
+ * ```
+ */
+export declare class ModuleRegistry implements OnModuleInit {
+    private readonly logger;
+    private readonly registrations;
+    private readonly categories;
+    private initialized;
+    onModuleInit(): Promise<void>;
+    /**
+     * Register a module with metadata
+     */
+    register(registration: ModuleRegistration): void;
+    /**
+     * Register multiple modules at once
+     */
+    registerAll(registrations: ModuleRegistration[]): void;
+    /**
+     * Get a module registration by ID
+     */
+    get(id: string): ModuleRegistration | undefined;
+    /**
+     * Check if a module is registered
+     */
+    has(id: string): boolean;
+    /**
+     * Get all registered module IDs
+     */
+    getAllIds(): string[];
+    /**
+     * Get all registrations
+     */
+    getAllRegistrations(): ModuleRegistration[];
+    /**
+     * Get modules by category
+     */
+    getByCategory(category: ModuleCategory): ModuleRegistration[];
+    /**
+     * Get module classes for dynamic import, sorted by dependencies and priority
+     */
+    getModuleClasses(options?: {
+        categories?: ModuleCategory[];
+        includeOptional?: boolean;
+        onlyEnabled?: boolean;
+    }): Type<any>[];
+    /**
+     * Get module classes for a specific feature set
+     */
+    getModulesForFeature(featureIds: string[]): Type<any>[];
+    /**
+     * Validate all module dependencies exist
+     */
+    private validateDependencies;
+    /**
+     * Get all dependencies for a module recursively
+     */
+    private getDependenciesRecursive;
+    /**
+     * Topological sort for dependency-ordered loading
+     */
+    private topologicalSort;
+    /**
+     * Log registration summary
+     */
+    private logRegistrationSummary;
+}
+//# sourceMappingURL=module-registry.service.d.ts.map

package/dist/module-registry.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-registry.service.d.ts","sourceRoot":"","sources":["../src/module-registry.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,OAAO,GACP,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,gBAAgB,GAChB,aAAa,GACb,SAAS,GACT,YAAY,GACZ,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,QAAQ,EAAE,cAAc,CAAC;IACzB,6BAA6B;IAC7B,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,cAAe,YAAW,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IACvE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0C;IACrE,OAAO,CAAC,WAAW,CAAS;IAEtB,YAAY;IAYlB;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI;IAoBhD;;OAEG;IACH,WAAW,CAAC,aAAa,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAMtD;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI/C;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,mBAAmB,IAAI,kBAAkB,EAAE;IAI3C;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,kBAAkB,EAAE;IAS7D;;OAEG;IACH,gBAAgB,CAAC,OAAO,CAAC,EAAE;QACzB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;QAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE;IA+Bf;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE;IAqBvD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAkBhC;;OAEG;IACH,OAAO,CAAC,eAAe;IA2CvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAe/B"}

package/dist/module-registry.service.js

@@ -0,0 +1,239 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var ModuleRegistry_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModuleRegistry = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Registry for dynamic module loading and dependency management.
+ *
+ * Provides:
+ * - Module registration with metadata
+ * - Dependency resolution
+ * - Conditional loading based on config
+ * - Load order optimization
+ *
+ * @example
+ * ```typescript
+ * // Register a module
+ * moduleRegistry.register({
+ *   id: 'bot-query',
+ *   category: 'domain',
+ *   module: BotQueryModule,
+ *   dependencies: ['prisma', 'redis'],
+ * });
+ *
+ * // Get modules for a feature
+ * const modules = moduleRegistry.getModulesForFeature('bot-management');
+ * ```
+ */
+let ModuleRegistry = ModuleRegistry_1 = class ModuleRegistry {
+    logger = new common_1.Logger(ModuleRegistry_1.name);
+    registrations = new Map();
+    categories = new Map();
+    initialized = false;
+    async onModuleInit() {
+        if (this.initialized)
+            return;
+        // Validate dependencies after all registrations
+        this.validateDependencies();
+        // Log registration summary
+        this.logRegistrationSummary();
+        this.initialized = true;
+    }
+    /**
+     * Register a module with metadata
+     */
+    register(registration) {
+        if (this.registrations.has(registration.id)) {
+            this.logger.warn(`Module "${registration.id}" already registered, overwriting`);
+        }
+        this.registrations.set(registration.id, registration);
+        // Add to category index
+        if (!this.categories.has(registration.category)) {
+            this.categories.set(registration.category, new Set());
+        }
+        this.categories.get(registration.category).add(registration.id);
+        this.logger.debug(`Registered module: ${registration.id} [${registration.category}]`);
+    }
+    /**
+     * Register multiple modules at once
+     */
+    registerAll(registrations) {
+        for (const reg of registrations) {
+            this.register(reg);
+        }
+    }
+    /**
+     * Get a module registration by ID
+     */
+    get(id) {
+        return this.registrations.get(id);
+    }
+    /**
+     * Check if a module is registered
+     */
+    has(id) {
+        return this.registrations.has(id);
+    }
+    /**
+     * Get all registered module IDs
+     */
+    getAllIds() {
+        return Array.from(this.registrations.keys());
+    }
+    /**
+     * Get all registrations
+     */
+    getAllRegistrations() {
+        return Array.from(this.registrations.values());
+    }
+    /**
+     * Get modules by category
+     */
+    getByCategory(category) {
+        const ids = this.categories.get(category);
+        if (!ids)
+            return [];
+        return Array.from(ids)
+            .map((id) => this.registrations.get(id))
+            .filter(Boolean);
+    }
+    /**
+     * Get module classes for dynamic import, sorted by dependencies and priority
+     */
+    getModuleClasses(options) {
+        const { categories, includeOptional = true, onlyEnabled = true, } = options || {};
+        // Filter registrations
+        let filtered = this.getAllRegistrations();
+        // Filter by category
+        if (categories?.length) {
+            filtered = filtered.filter((r) => categories.includes(r.category));
+        }
+        // Filter by enabled status
+        if (onlyEnabled) {
+            filtered = filtered.filter((r) => r.enabled !== false);
+        }
+        // Filter optional modules
+        if (!includeOptional) {
+            filtered = filtered.filter((r) => r.required !== false);
+        }
+        // Sort by dependencies and priority
+        const sorted = this.topologicalSort(filtered);
+        return sorted.map((r) => r.module);
+    }
+    /**
+     * Get module classes for a specific feature set
+     */
+    getModulesForFeature(featureIds) {
+        const featureModules = [];
+        for (const id of featureIds) {
+            const reg = this.registrations.get(id);
+            if (reg) {
+                featureModules.push(reg);
+                // Include dependencies
+                const deps = this.getDependenciesRecursive(id);
+                for (const depId of deps) {
+                    const depReg = this.registrations.get(depId);
+                    if (depReg && !featureModules.find((m) => m.id === depId)) {
+                        featureModules.push(depReg);
+                    }
+                }
+            }
+        }
+        return this.topologicalSort(featureModules).map((r) => r.module);
+    }
+    /**
+     * Validate all module dependencies exist
+     */
+    validateDependencies() {
+        const errors = [];
+        for (const reg of this.registrations.values()) {
+            if (reg.dependencies) {
+                for (const depId of reg.dependencies) {
+                    if (!this.registrations.has(depId)) {
+                        errors.push(`Module "${reg.id}" depends on "${depId}" which is not registered`);
+                    }
+                }
+            }
+        }
+        if (errors.length > 0) {
+            this.logger.warn(`Module dependency validation found ${errors.length} issues:\n${errors.join('\n')}`);
+        }
+    }
+    /**
+     * Get all dependencies for a module recursively
+     */
+    getDependenciesRecursive(moduleId, visited = new Set()) {
+        const reg = this.registrations.get(moduleId);
+        if (!reg?.dependencies)
+            return [];
+        const deps = [];
+        for (const depId of reg.dependencies) {
+            if (!visited.has(depId)) {
+                visited.add(depId);
+                deps.push(depId);
+                deps.push(...this.getDependenciesRecursive(depId, visited));
+            }
+        }
+        return deps;
+    }
+    /**
+     * Topological sort for dependency-ordered loading
+     */
+    topologicalSort(registrations) {
+        const sorted = [];
+        const visited = new Set();
+        const visiting = new Set();
+        const visit = (reg) => {
+            if (visited.has(reg.id))
+                return;
+            if (visiting.has(reg.id)) {
+                this.logger.warn(`Circular dependency detected at: ${reg.id}`);
+                return;
+            }
+            visiting.add(reg.id);
+            // Visit dependencies first
+            if (reg.dependencies) {
+                for (const depId of reg.dependencies) {
+                    const depReg = this.registrations.get(depId);
+                    if (depReg && registrations.includes(depReg)) {
+                        visit(depReg);
+                    }
+                }
+            }
+            visiting.delete(reg.id);
+            visited.add(reg.id);
+            sorted.push(reg);
+        };
+        // Sort by priority first (lower priority = earlier)
+        const byPriority = [...registrations].sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+        for (const reg of byPriority) {
+            visit(reg);
+        }
+        return sorted;
+    }
+    /**
+     * Log registration summary
+     */
+    logRegistrationSummary() {
+        const byCategory = {};
+        for (const [category, ids] of this.categories) {
+            byCategory[category] = ids.size;
+        }
+        this.logger.log(`Module registry initialized: ${this.registrations.size} modules across ${this.categories.size} categories`);
+        for (const [category, count] of Object.entries(byCategory)) {
+            this.logger.debug(`  ${category}: ${count} modules`);
+        }
+    }
+};
+exports.ModuleRegistry = ModuleRegistry;
+exports.ModuleRegistry = ModuleRegistry = ModuleRegistry_1 = __decorate([
+    (0, common_1.Injectable)()
+], ModuleRegistry);
+//# sourceMappingURL=module-registry.service.js.map

package/dist/module-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-registry.service.js","sourceRoot":"","sources":["../src/module-registry.service.ts"],"names":[],"mappings":"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"}

package/dist/module-scanner.service.d.ts

@@ -0,0 +1,73 @@
+import { OnModuleInit, Type } from '@nestjs/common';
+import { ModulesContainer } from '@nestjs/core';
+import { ModuleRegistry, ModuleRegistration } from './module-registry.service';
+/**
+ * Options for ModuleScanner
+ */
+export interface ModuleScannerOptions {
+    /** Whether to scan all modules automatically on init */
+    autoScan?: boolean;
+    /** Module IDs to exclude from registration */
+    excludeIds?: string[];
+    /** Categories to exclude from registration */
+    excludeCategories?: string[];
+    /** Log discovered modules */
+    verbose?: boolean;
+}
+/** DI token for scanner options */
+export declare const MODULE_SCANNER_OPTIONS = "MODULE_SCANNER_OPTIONS";
+/**
+ * ModuleScanner - Auto-discovers and registers modules with ModuleRegistry.
+ *
+ * This service scans all loaded NestJS modules and automatically registers
+ * those decorated with @RegisterModule() to the ModuleRegistry.
+ *
+ * @example
+ * ```typescript
+ * // In app.module.ts
+ * @Module({
+ *   imports: [
+ *     ModuleRegistryModule,
+ *     // Scanner will auto-discover modules below
+ *     BotQueryModule,
+ *     BotSseModule,
+ *   ],
+ *   providers: [
+ *     {
+ *       provide: MODULE_SCANNER_OPTIONS,
+ *       useValue: { verbose: true },
+ *     },
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare class ModuleScanner implements OnModuleInit {
+    private readonly registry;
+    private readonly modulesContainer;
+    private readonly logger;
+    private readonly options;
+    constructor(registry: ModuleRegistry, modulesContainer: ModulesContainer, options?: ModuleScannerOptions);
+    onModuleInit(): Promise<void>;
+    /**
+     * Scan all modules and register those with @RegisterModule decorator
+     */
+    scanAndRegister(): Promise<number>;
+    /**
+     * Extract registration metadata from a module
+     */
+    private extractModuleRegistration;
+    /**
+     * Get all modules that would be registered (without actually registering)
+     */
+    previewModules(): ModuleRegistration[];
+    /**
+     * Manually register a specific module
+     */
+    registerModule(moduleClass: Type<any>): boolean;
+    /**
+     * Log discovered modules for debugging
+     */
+    private logDiscoveredModules;
+}
+//# sourceMappingURL=module-scanner.service.d.ts.map

package/dist/module-scanner.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-scanner.service.d.ts","sourceRoot":"","sources":["../src/module-scanner.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,EAGZ,IAAI,EACL,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,mCAAmC;AACnC,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBACa,aAAc,YAAW,YAAY;IAK9C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IALnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;gBAG5B,QAAQ,EAAE,cAAc,EACxB,gBAAgB,EAAE,gBAAgB,EAGnD,OAAO,CAAC,EAAE,oBAAoB;IAS1B,YAAY;IAMlB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAyCxC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA8BjC;;OAEG;IACH,cAAc,IAAI,kBAAkB,EAAE;IAatC;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO;IAsB/C;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAsB7B"}

package/dist/module-scanner.service.js

@@ -0,0 +1,182 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var ModuleScanner_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModuleScanner = exports.MODULE_SCANNER_OPTIONS = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const module_registry_service_1 = require("./module-registry.service");
+const register_module_decorator_1 = require("./register-module.decorator");
+/** DI token for scanner options */
+exports.MODULE_SCANNER_OPTIONS = 'MODULE_SCANNER_OPTIONS';
+/**
+ * ModuleScanner - Auto-discovers and registers modules with ModuleRegistry.
+ *
+ * This service scans all loaded NestJS modules and automatically registers
+ * those decorated with @RegisterModule() to the ModuleRegistry.
+ *
+ * @example
+ * ```typescript
+ * // In app.module.ts
+ * @Module({
+ *   imports: [
+ *     ModuleRegistryModule,
+ *     // Scanner will auto-discover modules below
+ *     BotQueryModule,
+ *     BotSseModule,
+ *   ],
+ *   providers: [
+ *     {
+ *       provide: MODULE_SCANNER_OPTIONS,
+ *       useValue: { verbose: true },
+ *     },
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+let ModuleScanner = ModuleScanner_1 = class ModuleScanner {
+    registry;
+    modulesContainer;
+    logger = new common_1.Logger(ModuleScanner_1.name);
+    options;
+    constructor(registry, modulesContainer, options) {
+        this.registry = registry;
+        this.modulesContainer = modulesContainer;
+        this.options = {
+            autoScan: true,
+            verbose: false,
+            ...options,
+        };
+    }
+    async onModuleInit() {
+        if (this.options.autoScan) {
+            await this.scanAndRegister();
+        }
+    }
+    /**
+     * Scan all modules and register those with @RegisterModule decorator
+     */
+    async scanAndRegister() {
+        const discovered = [];
+        const excludedIds = new Set(this.options.excludeIds || []);
+        const excludedCategories = new Set(this.options.excludeCategories || []);
+        // Scan all modules in the container
+        for (const [, moduleRef] of this.modulesContainer) {
+            const registration = this.extractModuleRegistration(moduleRef);
+            if (registration) {
+                // Check exclusions
+                if (excludedIds.has(registration.id)) {
+                    this.logger.debug(`Skipping excluded module: ${registration.id}`);
+                    continue;
+                }
+                if (excludedCategories.has(registration.category)) {
+                    this.logger.debug(`Skipping excluded category: ${registration.category} (${registration.id})`);
+                    continue;
+                }
+                discovered.push(registration);
+            }
+        }
+        // Register all discovered modules
+        this.registry.registerAll(discovered);
+        this.logger.log(`ModuleScanner discovered ${discovered.length} modules with @RegisterModule()`);
+        if (this.options.verbose) {
+            this.logDiscoveredModules(discovered);
+        }
+        return discovered.length;
+    }
+    /**
+     * Extract registration metadata from a module
+     */
+    extractModuleRegistration(moduleRef) {
+        // Get the module class
+        const moduleClass = moduleRef.metatype;
+        if (!moduleClass) {
+            return null;
+        }
+        // Check for @RegisterModule decorator
+        const metadata = Reflect.getMetadata(register_module_decorator_1.MODULE_REGISTRATION_METADATA, moduleClass);
+        if (!metadata) {
+            return null;
+        }
+        // Build full registration
+        const registration = {
+            ...metadata,
+            module: moduleClass,
+            enabled: true,
+        };
+        return registration;
+    }
+    /**
+     * Get all modules that would be registered (without actually registering)
+     */
+    previewModules() {
+        const discovered = [];
+        for (const [, moduleRef] of this.modulesContainer) {
+            const registration = this.extractModuleRegistration(moduleRef);
+            if (registration) {
+                discovered.push(registration);
+            }
+        }
+        return discovered;
+    }
+    /**
+     * Manually register a specific module
+     */
+    registerModule(moduleClass) {
+        const metadata = Reflect.getMetadata(register_module_decorator_1.MODULE_REGISTRATION_METADATA, moduleClass);
+        if (!metadata) {
+            this.logger.warn(`Module ${moduleClass.name} does not have @RegisterModule decorator`);
+            return false;
+        }
+        this.registry.register({
+            ...metadata,
+            module: moduleClass,
+            enabled: true,
+        });
+        return true;
+    }
+    /**
+     * Log discovered modules for debugging
+     */
+    logDiscoveredModules(modules) {
+        const byCategory = {};
+        for (const mod of modules) {
+            const cat = mod.category;
+            if (!byCategory[cat]) {
+                byCategory[cat] = [];
+            }
+            byCategory[cat].push(mod);
+        }
+        this.logger.debug('Discovered modules by category:');
+        for (const [category, mods] of Object.entries(byCategory)) {
+            this.logger.debug(`  ${category}:`);
+            for (const mod of mods) {
+                const deps = mod.dependencies?.length
+                    ? ` deps: [${mod.dependencies.join(', ')}]`
+                    : '';
+                this.logger.debug(`    - ${mod.id}${deps}`);
+            }
+        }
+    }
+};
+exports.ModuleScanner = ModuleScanner;
+exports.ModuleScanner = ModuleScanner = ModuleScanner_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(2, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Inject)(exports.MODULE_SCANNER_OPTIONS)),
+    __metadata("design:paramtypes", [module_registry_service_1.ModuleRegistry,
+        core_1.ModulesContainer, Object])
+], ModuleScanner);
+//# sourceMappingURL=module-scanner.service.js.map

package/dist/module-scanner.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-scanner.service.js","sourceRoot":"","sources":["../src/module-scanner.service.ts"],"names":[],"mappings":"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"}

package/dist/register-module.decorator.d.ts

@@ -0,0 +1,47 @@
+import type { ModuleCategory } from './module-registry.service';
+/**
+ * Module registration metadata for auto-discovery
+ */
+export interface RegisterModuleMetadata {
+    /** Unique module identifier */
+    id: string;
+    /** Module category for grouping */
+    category: ModuleCategory;
+    /** Human-readable name */
+    name?: string;
+    /** Module description */
+    description?: string;
+    /** Dependencies (module IDs that must be loaded first) */
+    dependencies?: string[];
+    /** Whether module is required for app to function */
+    required?: boolean;
+    /** Priority for load order (lower = earlier) */
+    priority?: number;
+    /** Feature IDs this module belongs to */
+    features?: string[];
+}
+/**
+ * Metadata key for module registration
+ */
+export declare const MODULE_REGISTRATION_METADATA = "module:registration";
+/**
+ * Decorator to mark a module for auto-registration with ModuleRegistry.
+ *
+ * The ModuleScanner will discover all modules with this decorator
+ * and register them with the ModuleRegistry during application bootstrap.
+ *
+ * @example
+ * ```typescript
+ * @RegisterModule({
+ *   id: 'bot-query',
+ *   category: 'domain',
+ *   name: 'Bot Query Module',
+ *   dependencies: ['prisma', 'redis'],
+ *   features: ['bot-management'],
+ * })
+ * @Module({})
+ * export class BotQueryModule {}
+ * ```
+ */
+export declare function RegisterModule(metadata: RegisterModuleMetadata): ClassDecorator;
+//# sourceMappingURL=register-module.decorator.d.ts.map

package/dist/register-module.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-module.decorator.d.ts","sourceRoot":"","sources":["../src/register-module.decorator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,QAAQ,EAAE,cAAc,CAAC;IACzB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,wBAAwB,CAAC;AAElE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,sBAAsB,GAC/B,cAAc,CAIhB"}

package/dist/register-module.decorator.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODULE_REGISTRATION_METADATA = void 0;
+exports.RegisterModule = RegisterModule;
+const common_1 = require("@nestjs/common");
+/**
+ * Metadata key for module registration
+ */
+exports.MODULE_REGISTRATION_METADATA = 'module:registration';
+/**
+ * Decorator to mark a module for auto-registration with ModuleRegistry.
+ *
+ * The ModuleScanner will discover all modules with this decorator
+ * and register them with the ModuleRegistry during application bootstrap.
+ *
+ * @example
+ * ```typescript
+ * @RegisterModule({
+ *   id: 'bot-query',
+ *   category: 'domain',
+ *   name: 'Bot Query Module',
+ *   dependencies: ['prisma', 'redis'],
+ *   features: ['bot-management'],
+ * })
+ * @Module({})
+ * export class BotQueryModule {}
+ * ```
+ */
+function RegisterModule(metadata) {
+    return (target) => {
+        (0, common_1.SetMetadata)(exports.MODULE_REGISTRATION_METADATA, metadata)(target);
+    };
+}
+//# sourceMappingURL=register-module.decorator.js.map

package/dist/register-module.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-module.decorator.js","sourceRoot":"","sources":["../src/register-module.decorator.ts"],"names":[],"mappings":";;;AAiDA,wCAMC;AAvDD,2CAA6C;AAyB7C;;GAEG;AACU,QAAA,4BAA4B,GAAG,qBAAqB,CAAC;AAElE;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,cAAc,CAC5B,QAAgC;IAEhC,OAAO,CAAC,MAAuB,EAAE,EAAE;QACjC,IAAA,oBAAW,EAAC,oCAA4B,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@dofe/infra-module-registry",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "reflect-metadata": "^0.2.0",
+    "rxjs": "^7.8.0"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.0",
+    "typescript": "^5.4.5"
+  },
+  "type": "commonjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist"
+  }
+}