stratal 0.0.1

package/dist/module/errors/module-already-registered.error.js

@@ -0,0 +1,14 @@
+import { ERROR_CODES } from '../../errors';
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * ModuleAlreadyRegisteredError
+ *
+ * Thrown when attempting to register a module that is already registered.
+ * This prevents duplicate module registration which could cause unexpected behavior.
+ */
+export class ModuleAlreadyRegisteredError extends ApplicationError {
+    constructor(moduleName) {
+        super('errors.moduleAlreadyRegistered', ERROR_CODES.SYSTEM.MODULE_ALREADY_REGISTERED, { moduleName });
+    }
+}
+//# sourceMappingURL=module-already-registered.error.js.map

package/dist/module/errors/module-already-registered.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-already-registered.error.js","sourceRoot":"","sources":["../../../src/module/errors/module-already-registered.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,MAAM,OAAO,4BAA6B,SAAQ,gBAAgB;IAChE,YAAY,UAAkB;QAC5B,KAAK,CACH,gCAAgC,EAChC,WAAW,CAAC,MAAM,CAAC,yBAAyB,EAC5C,EAAE,UAAU,EAAE,CACf,CAAA;IACH,CAAC;CACF"}

package/dist/module/errors/module-circular-dependency.error.d.ts

@@ -0,0 +1,11 @@
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * ModuleCircularDependencyError
+ *
+ * Thrown when a circular dependency is detected in the module dependency graph.
+ * This prevents infinite loops during module initialization.
+ */
+export declare class ModuleCircularDependencyError extends ApplicationError {
+    constructor(dependencyPath: string[]);
+}
+//# sourceMappingURL=module-circular-dependency.error.d.ts.map

package/dist/module/errors/module-circular-dependency.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-circular-dependency.error.d.ts","sourceRoot":"","sources":["../../../src/module/errors/module-circular-dependency.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,qBAAa,6BAA8B,SAAQ,gBAAgB;gBACrD,cAAc,EAAE,MAAM,EAAE;CAQrC"}

package/dist/module/errors/module-circular-dependency.error.js

@@ -0,0 +1,15 @@
+import { ERROR_CODES } from '../../errors';
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * ModuleCircularDependencyError
+ *
+ * Thrown when a circular dependency is detected in the module dependency graph.
+ * This prevents infinite loops during module initialization.
+ */
+export class ModuleCircularDependencyError extends ApplicationError {
+    constructor(dependencyPath) {
+        const cycle = dependencyPath.join(' -> ');
+        super('errors.moduleCircularDependency', ERROR_CODES.SYSTEM.MODULE_CIRCULAR_DEPENDENCY, { cycle });
+    }
+}
+//# sourceMappingURL=module-circular-dependency.error.js.map

package/dist/module/errors/module-circular-dependency.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-circular-dependency.error.js","sourceRoot":"","sources":["../../../src/module/errors/module-circular-dependency.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,MAAM,OAAO,6BAA8B,SAAQ,gBAAgB;IACjE,YAAY,cAAwB;QAClC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACzC,KAAK,CACH,iCAAiC,EACjC,WAAW,CAAC,MAAM,CAAC,0BAA0B,EAC7C,EAAE,KAAK,EAAE,CACV,CAAA;IACH,CAAC;CACF"}

package/dist/module/errors/module-dependency-not-found.error.d.ts

@@ -0,0 +1,11 @@
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * ModuleDependencyNotFoundError
+ *
+ * Thrown when a module declares a dependency on another module that hasn't been registered.
+ * This indicates a missing module or incorrect dependency declaration.
+ */
+export declare class ModuleDependencyNotFoundError extends ApplicationError {
+    constructor(dependency: string, moduleName?: string);
+}
+//# sourceMappingURL=module-dependency-not-found.error.d.ts.map

package/dist/module/errors/module-dependency-not-found.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-dependency-not-found.error.d.ts","sourceRoot":"","sources":["../../../src/module/errors/module-dependency-not-found.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,qBAAa,6BAA8B,SAAQ,gBAAgB;gBACrD,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAOpD"}

package/dist/module/errors/module-dependency-not-found.error.js

@@ -0,0 +1,14 @@
+import { ERROR_CODES } from '../../errors';
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * ModuleDependencyNotFoundError
+ *
+ * Thrown when a module declares a dependency on another module that hasn't been registered.
+ * This indicates a missing module or incorrect dependency declaration.
+ */
+export class ModuleDependencyNotFoundError extends ApplicationError {
+    constructor(dependency, moduleName) {
+        super('errors.moduleDependencyNotFound', ERROR_CODES.SYSTEM.MODULE_DEPENDENCY_NOT_FOUND, { dependency, moduleName });
+    }
+}
+//# sourceMappingURL=module-dependency-not-found.error.js.map

package/dist/module/errors/module-dependency-not-found.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-dependency-not-found.error.js","sourceRoot":"","sources":["../../../src/module/errors/module-dependency-not-found.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;GAKG;AACH,MAAM,OAAO,6BAA8B,SAAQ,gBAAgB;IACjE,YAAY,UAAkB,EAAE,UAAmB;QACjD,KAAK,CACH,iCAAiC,EACjC,WAAW,CAAC,MAAM,CAAC,2BAA2B,EAC9C,EAAE,UAAU,EAAE,UAAU,EAAE,CAC3B,CAAA;IACH,CAAC;CACF"}

package/dist/module/index.d.ts

@@ -0,0 +1,4 @@
+export * from './module.decorator';
+export * from './module-registry';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/module/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/module/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAA;AAGlC,cAAc,mBAAmB,CAAA;AAGjC,cAAc,SAAS,CAAA"}

package/dist/module/index.js

@@ -0,0 +1,7 @@
+// Module decorator and utilities
+export * from './module.decorator';
+// Module registry
+export * from './module-registry';
+// Types
+export * from './types';
+//# sourceMappingURL=index.js.map

package/dist/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/module/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,cAAc,oBAAoB,CAAA;AAElC,kBAAkB;AAClB,cAAc,mBAAmB,CAAA;AAEjC,QAAQ;AACR,cAAc,SAAS,CAAA"}

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

@@ -0,0 +1,101 @@
+/**
+ * Module Registry
+ *
+ * Manages module lifecycle for the @Module decorator pattern.
+ * Simplified for tsyringe's flat container model:
+ * - Imports are traversed for registration (organization only)
+ * - Modules registered in declaration order
+ * - Lifecycle hooks: onInitialize, onShutdown
+ */
+import type { Container } from '../di/container';
+import type { LoggerService } from '../logger';
+import { type MiddlewareConfigEntry } from '../middleware';
+import type { Constructor } from '../types';
+import type { DynamicModule, ModuleClass } from './types';
+/**
+ * ModuleRegistry - manages module lifecycle
+ *
+ * @example
+ * ```typescript
+ * const registry = new ModuleRegistry(container, logger)
+ * registry.register(AppModule)  // Traverses imports recursively
+ * await registry.initialize()
+ * // ... application running ...
+ * await registry.shutdown()
+ * ```
+ */
+export declare class ModuleRegistry {
+    private readonly container;
+    private readonly logger;
+    private modules;
+    private registeredClasses;
+    private initialized;
+    private allControllers;
+    private allConsumers;
+    private allJobs;
+    private allMiddlewareConfigs;
+    constructor(container: Container, logger: LoggerService);
+    /**
+     * Register a module (static or dynamic)
+     *
+     * @param moduleOrDynamic - Module class decorated with @Module or DynamicModule from configure()
+     */
+    register(moduleOrDynamic: ModuleClass | DynamicModule): void;
+    /**
+     * Register multiple modules in order
+     */
+    registerAll(modules: (ModuleClass | DynamicModule)[]): void;
+    /**
+     * Initialize all modules (call configure and onInitialize hooks)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get all controllers registered from all modules
+     */
+    getAllControllers(): Constructor[];
+    /**
+     * Get all consumers registered from all modules
+     */
+    getAllConsumers(): Constructor[];
+    /**
+     * Get all jobs registered from all modules
+     */
+    getAllJobs(): Constructor[];
+    /**
+     * Get all middleware configurations from all modules
+     */
+    getAllMiddlewareConfigs(): MiddlewareConfigEntry[];
+    /**
+     * Shutdown all modules (call onShutdown hooks in reverse order)
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Type guard for MiddlewareConfigurable
+     */
+    private hasMiddlewareConfigurable;
+    /**
+     * Type guard for OnInitialize
+     */
+    private hasOnInitialize;
+    /**
+     * Type guard for OnShutdown
+     */
+    private hasOnShutdown;
+    /**
+     * Resolve module class and options from static or dynamic module
+     *
+     * For DynamicModules, merges the decorator metadata (consumers, controllers, jobs)
+     * with the DynamicModule options (providers, imports). This ensures modules using
+     * forRoot/forRootAsync patterns still have their decorator-defined consumers registered.
+     */
+    private resolveModule;
+    /**
+     * Type guard for DynamicModule
+     */
+    private isDynamicModule;
+    /**
+     * Register a single provider in the container
+     */
+    private registerProvider;
+}
+//# sourceMappingURL=module-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module-registry.d.ts","sourceRoot":"","sources":["../../src/module/module-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EAMZ,MAAM,SAAS,CAAA;AAQhB;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IAYvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAZzB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,iBAAiB,CAAyB;IAClD,OAAO,CAAC,WAAW,CAAQ;IAG3B,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,oBAAoB,CAA8B;gBAGvC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,aAAa;IAGxC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,WAAW,GAAG,aAAa,GAAG,IAAI;IAsD5D;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,CAAC,WAAW,GAAG,aAAa,CAAC,EAAE,GAAG,IAAI;IAM3D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCjC;;OAEG;IACH,iBAAiB,IAAI,WAAW,EAAE;IAIlC;;OAEG;IACH,eAAe,IAAI,WAAW,EAAE;IAIhC;;OAEG;IACH,UAAU,IAAI,WAAW,EAAE;IAI3B;;OAEG;IACH,uBAAuB,IAAI,qBAAqB,EAAE;IAIlD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB/B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IASjC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA0BzB"}

package/dist/module/module-registry.js

@@ -0,0 +1,278 @@
+/**
+ * Module Registry
+ *
+ * Manages module lifecycle for the @Module decorator pattern.
+ * Simplified for tsyringe's flat container model:
+ * - Imports are traversed for registration (organization only)
+ * - Modules registered in declaration order
+ * - Lifecycle hooks: onInitialize, onShutdown
+ */
+import { instancePerContainerCachingFactory } from 'tsyringe';
+import { Scope } from '../di/types';
+import { createMiddlewareConsumer, } from '../middleware';
+import { getModuleOptions } from './module.decorator';
+/**
+ * ModuleRegistry - manages module lifecycle
+ *
+ * @example
+ * ```typescript
+ * const registry = new ModuleRegistry(container, logger)
+ * registry.register(AppModule)  // Traverses imports recursively
+ * await registry.initialize()
+ * // ... application running ...
+ * await registry.shutdown()
+ * ```
+ */
+export class ModuleRegistry {
+    container;
+    logger;
+    modules = [];
+    registeredClasses = new Set();
+    initialized = false;
+    // Collected items from all modules for Application to use
+    allControllers = [];
+    allConsumers = [];
+    allJobs = [];
+    allMiddlewareConfigs = [];
+    constructor(container, logger) {
+        this.container = container;
+        this.logger = logger;
+    }
+    /**
+     * Register a module (static or dynamic)
+     *
+     * @param moduleOrDynamic - Module class decorated with @Module or DynamicModule from configure()
+     */
+    register(moduleOrDynamic) {
+        const { moduleClass, options } = this.resolveModule(moduleOrDynamic);
+        const isDynamic = this.isDynamicModule(moduleOrDynamic);
+        // Check for duplicate registration
+        if (this.registeredClasses.has(moduleClass)) {
+            // For DynamicModules: Still register the additional providers
+            // This allows withRoot() to add configuration even if base module is registered
+            if (isDynamic) {
+                this.logger.debug(`Module ${moduleClass.name} already registered, registering DynamicModule providers`);
+                for (const provider of options.providers ?? []) {
+                    this.registerProvider(provider);
+                }
+            }
+            else {
+                this.logger.debug(`Module ${moduleClass.name} already registered, skipping`);
+            }
+            return;
+        }
+        this.registeredClasses.add(moduleClass);
+        this.logger.info(`Registering module: ${moduleClass.name}`);
+        // First, register imported modules recursively
+        for (const ImportedModule of options.imports ?? []) {
+            this.register(ImportedModule);
+        }
+        // Register providers in container
+        for (const provider of options.providers ?? []) {
+            this.registerProvider(provider);
+        }
+        // Register controllers and collect them
+        for (const controller of options.controllers ?? []) {
+            this.container.register(controller);
+            this.allControllers.push(controller);
+        }
+        // Register consumers as singletons by default and collect them
+        for (const consumer of options.consumers ?? []) {
+            this.container.register(consumer, Scope.Singleton);
+            this.allConsumers.push(consumer);
+            this.logger.info(`Collected consumer: ${consumer.name}`, { queueCount: this.allConsumers.length });
+        }
+        // Register jobs as singletons by default and collect them
+        for (const job of options.jobs ?? []) {
+            this.container.register(job, Scope.Singleton);
+            this.allJobs.push(job);
+        }
+        this.modules.push({ moduleClass, options, instance: null });
+    }
+    /**
+     * Register multiple modules in order
+     */
+    registerAll(modules) {
+        for (const module of modules) {
+            this.register(module);
+        }
+    }
+    /**
+     * Initialize all modules (call configure and onInitialize hooks)
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        this.logger.info('Initializing modules...');
+        const context = {
+            container: this.container,
+            logger: this.logger,
+        };
+        for (const registered of this.modules) {
+            // Instantiate module class
+            const instance = new registered.moduleClass();
+            registered.instance = instance;
+            // Call configure() for middleware configuration if implemented
+            if (this.hasMiddlewareConfigurable(instance)) {
+                this.logger.debug(`Configuring middleware for: ${registered.moduleClass.name}`);
+                const consumer = createMiddlewareConsumer();
+                instance.configure(consumer);
+                const entries = consumer.getEntries();
+                this.allMiddlewareConfigs.push(...entries);
+                this.logger.debug(`Collected ${entries.length} middleware config(s) from ${registered.moduleClass.name}`);
+            }
+            // Call onInitialize if implemented
+            if (this.hasOnInitialize(instance)) {
+                this.logger.info(`Initializing: ${registered.moduleClass.name}`);
+                await instance.onInitialize(context);
+            }
+        }
+        this.initialized = true;
+        this.logger.info('All modules initialized');
+    }
+    /**
+     * Get all controllers registered from all modules
+     */
+    getAllControllers() {
+        return this.allControllers;
+    }
+    /**
+     * Get all consumers registered from all modules
+     */
+    getAllConsumers() {
+        return this.allConsumers;
+    }
+    /**
+     * Get all jobs registered from all modules
+     */
+    getAllJobs() {
+        return this.allJobs;
+    }
+    /**
+     * Get all middleware configurations from all modules
+     */
+    getAllMiddlewareConfigs() {
+        return this.allMiddlewareConfigs;
+    }
+    /**
+     * Shutdown all modules (call onShutdown hooks in reverse order)
+     */
+    async shutdown() {
+        this.logger.info('Shutting down modules...');
+        const context = {
+            container: this.container,
+            logger: this.logger,
+        };
+        // Reverse order for shutdown
+        const reversed = [...this.modules].reverse();
+        for (const { moduleClass, instance } of reversed) {
+            if (instance && this.hasOnShutdown(instance)) {
+                try {
+                    await instance.onShutdown(context);
+                }
+                catch (error) {
+                    this.logger.error(`Error shutting down ${moduleClass.name}:`, error);
+                }
+            }
+        }
+        this.logger.info('All modules shut down');
+    }
+    /**
+     * Type guard for MiddlewareConfigurable
+     */
+    hasMiddlewareConfigurable(instance) {
+        return (typeof instance === 'object' &&
+            instance !== null &&
+            'configure' in instance &&
+            typeof instance.configure === 'function');
+    }
+    /**
+     * Type guard for OnInitialize
+     */
+    hasOnInitialize(instance) {
+        return (typeof instance === 'object' &&
+            instance !== null &&
+            'onInitialize' in instance &&
+            typeof instance.onInitialize === 'function');
+    }
+    /**
+     * Type guard for OnShutdown
+     */
+    hasOnShutdown(instance) {
+        return (typeof instance === 'object' &&
+            instance !== null &&
+            'onShutdown' in instance &&
+            typeof instance.onShutdown === 'function');
+    }
+    /**
+     * Resolve module class and options from static or dynamic module
+     *
+     * For DynamicModules, merges the decorator metadata (consumers, controllers, jobs)
+     * with the DynamicModule options (providers, imports). This ensures modules using
+     * forRoot/forRootAsync patterns still have their decorator-defined consumers registered.
+     */
+    resolveModule(moduleOrDynamic) {
+        // DynamicModule (from forRoot/forRootAsync) - has module property
+        if (this.isDynamicModule(moduleOrDynamic)) {
+            const { module: moduleClass, ...dynamicRest } = moduleOrDynamic;
+            // Get decorator options and merge with dynamic options
+            // This ensures consumers/controllers/jobs from @Module decorator are included
+            const decoratorOptions = getModuleOptions(moduleClass) ?? {};
+            const mergedOptions = {
+                ...decoratorOptions,
+                ...dynamicRest,
+                // Merge arrays: decorator providers first, then dynamic providers
+                providers: [...(decoratorOptions.providers ?? []), ...(dynamicRest.providers ?? [])],
+                imports: [...(decoratorOptions.imports ?? [])],
+            };
+            return { moduleClass: moduleClass, options: mergedOptions };
+        }
+        // Static module (decorated with @Module)
+        const moduleClass = moduleOrDynamic;
+        const options = getModuleOptions(moduleClass) ?? {};
+        return { moduleClass, options };
+    }
+    /**
+     * Type guard for DynamicModule
+     */
+    isDynamicModule(value) {
+        return (typeof value === 'object' &&
+            value !== null &&
+            'module' in value && // Required property for dynamic modules
+            typeof value.module === 'function');
+    }
+    /**
+     * Register a single provider in the container
+     */
+    registerProvider(provider) {
+        if (typeof provider === 'function') {
+            // Class-only provider - transient by default
+            this.container.register(provider);
+        }
+        else if ('useClass' in provider) {
+            // ClassProvider with optional scope
+            this.container.register(provider.provide, provider.useClass, provider.scope);
+        }
+        else if ('useValue' in provider) {
+            // ValueProvider - no scope needed (values are inherently singleton)
+            this.container.registerValue(provider.provide, provider.useValue);
+        }
+        else if ('useFactory' in provider) {
+            // FactoryProvider - use instancePerContainerCachingFactory to:
+            // 1. Get the actual container at resolution time (global vs request)
+            // 2. Cache result per container
+            const { provide, useFactory, inject = [] } = provider;
+            this.container.getTsyringeContainer().register(provide, {
+                useFactory: instancePerContainerCachingFactory((dependencyContainer) => {
+                    const deps = inject.map((token) => dependencyContainer.resolve(token));
+                    return useFactory(...deps);
+                })
+            });
+        }
+        else if ('useExisting' in provider) {
+            // ExistingProvider - alias to another token
+            this.container.registerExisting(provider.provide, provider.useExisting);
+        }
+    }
+}
+//# sourceMappingURL=module-registry.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * Module Decorator
+ *
+ * NestJS-style @Module decorator for defining modules with providers, controllers, etc.
+ * Encapsulates tsyringe's @registry decorator for auto-registration.
+ */
+import type { Constructor } from '../types';
+import type { ModuleOptions } from './types';
+export declare const MODULE_OPTIONS_KEY: unique symbol;
+/**
+ * @Module decorator - defines a module with imports, providers, controllers, consumers, jobs
+ *
+ * Uses tsyringe's @registry internally to auto-register providers when module is imported.
+ *
+ * @example
+ * ```typescript
+ * @Module({
+ *   imports: [OtherModule],
+ *   providers: [MyService, MyRepository],
+ *   controllers: [MyController],
+ * })
+ * export class MyModule {}
+ * ```
+ */
+export declare function Module(options: ModuleOptions): <TFunction extends abstract new (...args: never[]) => unknown>(target: TFunction) => TFunction;
+/**
+ * Get module options from decorated class
+ */
+export declare function getModuleOptions(target: Constructor): ModuleOptions | undefined;
+/**
+ * Check if a class is decorated with @Module
+ */
+export declare function isModuleClass(target: unknown): target is Constructor;
+//# sourceMappingURL=module.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.decorator.d.ts","sourceRoot":"","sources":["../../src/module/module.decorator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,SAAS,CAAA;AAEtD,eAAO,MAAM,kBAAkB,eAA2B,CAAA;AAU1D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,IACnC,SAAS,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EAAE,QAAQ,SAAS,KAAG,SAAS,CAcpG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAE/E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,WAAW,CAKpE"}

package/dist/module/module.decorator.js

@@ -0,0 +1,107 @@
+/**
+ * Module Decorator
+ *
+ * NestJS-style @Module decorator for defining modules with providers, controllers, etc.
+ * Encapsulates tsyringe's @registry decorator for auto-registration.
+ */
+import { instancePerContainerCachingFactory, registry } from 'tsyringe';
+import { InvalidModuleProviderError } from './errors';
+export const MODULE_OPTIONS_KEY = Symbol('module:options');
+/**
+ * @Module decorator - defines a module with imports, providers, controllers, consumers, jobs
+ *
+ * Uses tsyringe's @registry internally to auto-register providers when module is imported.
+ *
+ * @example
+ * ```typescript
+ * @Module({
+ *   imports: [OtherModule],
+ *   providers: [MyService, MyRepository],
+ *   controllers: [MyController],
+ * })
+ * export class MyModule {}
+ * ```
+ */
+export function Module(options) {
+    return (target) => {
+        // Store module options for runtime access
+        Reflect.defineMetadata(MODULE_OPTIONS_KEY, options, target);
+        // Build tsyringe registry entries from providers
+        const registryEntries = buildRegistryEntries(options.providers ?? []);
+        // Apply tsyringe @registry decorator (encapsulated)
+        if (registryEntries.length > 0) {
+            registry(registryEntries)(target);
+        }
+        return target;
+    };
+}
+/**
+ * Get module options from decorated class
+ */
+export function getModuleOptions(target) {
+    return Reflect.getMetadata(MODULE_OPTIONS_KEY, target);
+}
+/**
+ * Check if a class is decorated with @Module
+ */
+export function isModuleClass(target) {
+    return (typeof target === 'function' &&
+        Reflect.hasMetadata(MODULE_OPTIONS_KEY, target));
+}
+/**
+ * Convert our Provider types to tsyringe registry format
+ *
+ * Maps provider scope to tsyringe's lifecycle option.
+ * Scope enum values map directly to Lifecycle enum values.
+ */
+function buildRegistryEntries(providers) {
+    return providers.map((provider) => {
+        // Class-only provider - transient by default
+        if (typeof provider === 'function') {
+            return {
+                token: provider,
+                useClass: provider,
+            };
+        }
+        // ClassProvider with optional scope
+        if ('useClass' in provider) {
+            return {
+                token: provider.provide,
+                useClass: provider.useClass,
+                options: provider.scope !== undefined
+                    ? { lifecycle: provider.scope }
+                    : undefined,
+            };
+        }
+        // ValueProvider - no scope needed (values are inherently singleton)
+        if ('useValue' in provider) {
+            return {
+                token: provider.provide,
+                useValue: provider.useValue,
+            };
+        }
+        // FactoryProvider - use instancePerContainerCachingFactory to:
+        // 1. Get the actual container at resolution time (global vs request)
+        // 2. Cache result per container
+        if ('useFactory' in provider) {
+            const { provide, useFactory, inject = [] } = provider;
+            return {
+                token: provide,
+                useFactory: instancePerContainerCachingFactory((dependencyContainer) => {
+                    const deps = inject.map((token) => dependencyContainer.resolve(token));
+                    return useFactory(...deps);
+                }),
+            };
+        }
+        // ExistingProvider - alias to another token (uses tsyringe's useToken)
+        if ('useExisting' in provider) {
+            return {
+                token: provider.provide,
+                useToken: provider.useExisting,
+            };
+        }
+        // Fallback (should not reach here with proper types)
+        throw new InvalidModuleProviderError(provider);
+    });
+}
+//# sourceMappingURL=module.decorator.js.map