stratal 0.0.21 → 0.0.23

package/dist/module-registry-Dm-pqHd3.mjs

@@ -0,0 +1,554 @@
+import { c as Transient, d as inject, n as CONTAINER_TOKEN, r as DI_TOKENS } from "./di-DseMn-z9.mjs";
+import { a as ApplicationError } from "./container-storage-BmOJ4_Na.mjs";
+import { n as __decorateParam, t as __decorate } from "./decorate-CuAoSZvs.mjs";
+import { LOGGER_TOKENS } from "./logger/index.mjs";
+import { u as HttpException } from "./errors-mXYxG0XB.mjs";
+import { s as isListener } from "./events-BXJGZjpG.mjs";
+import { r as getModuleOptions } from "./module.decorator-CYHY6pG5.mjs";
+import { t as isCommand } from "./is-command-CEPO9n8c.mjs";
+import { t as isSeeder } from "./is-seeder-Gvh_AM71.mjs";
+//#region src/module/module-ref.ts
+/**
+* Handle to a lazily loaded module, returned by {@link LazyModuleLoader.load}.
+*
+* Resolves providers from the global container, so singletons registered by the
+* lazy module persist across requests.
+*
+* Note: request-scoped providers resolved via {@link ModuleRef.get} degrade to
+* transient instances (there is no ambient request scope here). To obtain a
+* true per-request instance, resolve the token from the request container
+* inside a request scope instead.
+*/
+var ModuleRef = class {
+	container;
+	moduleClass;
+	constructor(container, moduleClass) {
+		this.container = container;
+		this.moduleClass = moduleClass;
+	}
+	/** Resolve a provider from the lazily loaded module (global scope). */
+	get(token) {
+		return this.container.resolve(token);
+	}
+	/** Async variant of {@link ModuleRef.get}, matching the NestJS API shape. */
+	resolve(token) {
+		return Promise.resolve(this.container.resolve(token));
+	}
+};
+//#endregion
+//#region src/module/lazy-module-loader.ts
+let LazyModuleLoader = class LazyModuleLoader {
+	registry;
+	container;
+	logger;
+	cache = /* @__PURE__ */ new Map();
+	inFlight = /* @__PURE__ */ new Map();
+	constructor(registry, container, logger) {
+		this.registry = registry;
+		this.container = container;
+		this.logger = logger;
+	}
+	async load(loaderFn) {
+		const loaded = await loaderFn();
+		const { moduleClass } = this.registry.resolveModule(loaded);
+		const cached = this.cache.get(moduleClass);
+		if (cached) return cached;
+		const inFlight = this.inFlight.get(moduleClass);
+		if (inFlight) return inFlight;
+		const promise = this.registerAndBuild(moduleClass, loaded);
+		this.inFlight.set(moduleClass, promise);
+		try {
+			return await promise;
+		} finally {
+			this.inFlight.delete(moduleClass);
+		}
+	}
+	async registerAndBuild(moduleClass, loaded) {
+		this.logger.debug(`Lazy loading module: ${moduleClass.name}`);
+		await this.registry.registerLazy(loaded);
+		const ref = new ModuleRef(this.container.getRootContainer(), moduleClass);
+		this.cache.set(moduleClass, ref);
+		return ref;
+	}
+};
+LazyModuleLoader = __decorate([
+	__decorateParam(0, inject(DI_TOKENS.ModuleRegistry)),
+	__decorateParam(1, inject(DI_TOKENS.Container)),
+	__decorateParam(2, inject(LOGGER_TOKENS.LoggerService))
+], LazyModuleLoader);
+//#endregion
+//#region src/rate-limiter/errors.ts
+/**
+* Thrown when a request exceeds a configured rate limit.
+*
+* HTTP Status: 429 Too Many Requests
+*
+* The {@link ExceptionHandler} renders the body via content negotiation
+* (HTML for HTML clients, JSON for everything else). Standard rate-limit
+* headers (`Retry-After`, `X-RateLimit-*`) are injected by the
+* `respond()` callback registered via `RateLimiterModule.onException`.
+*/
+var TooManyRequestsError = class extends HttpException {
+	info;
+	constructor(info) {
+		super(429, "Too many requests");
+		this.info = info;
+	}
+};
+var RateLimiterError = class extends ApplicationError {};
+//#endregion
+//#region src/rate-limiter/rate-limiter.tokens.ts
+const RATE_LIMITER_TOKENS = {
+	Registry: Symbol.for("stratal:rate-limiter:registry"),
+	Store: Symbol.for("stratal:rate-limiter:store"),
+	StoreFactory: Symbol.for("stratal:rate-limiter:store-factory"),
+	Options: Symbol.for("stratal:rate-limiter:options"),
+	/**
+	* Per-app marker registered by RateLimiterModule.onInitialize. Used by
+	* ThrottleMiddleware to detect "module not imported".
+	*/
+	ModuleMarker: Symbol.for("stratal:rate-limiter:module-marker")
+};
+//#endregion
+//#region src/rate-limiter/throttle.middleware.ts
+const cache = /* @__PURE__ */ new Map();
+/**
+* Memoized factory that produces a Stratal `Middleware` class bound to a
+* named limiter. Calling twice with the same name returns the *same* class
+* — important for `Router.middleware` deduplication via class identity.
+*
+* Detection of "module not imported" works against a per-app marker
+* registered by `RateLimiterModule.onInitialize`. We check
+* `isRegistered(marker)` at request time before resolving Registry.
+*/
+function createThrottleMiddleware(name) {
+	const existing = cache.get(name);
+	if (existing) return existing;
+	let ThrottleMiddleware = class ThrottleMiddleware {
+		container;
+		constructor(container) {
+			this.container = container;
+		}
+		handle(ctx, next) {
+			if (!this.container.isRegistered(RATE_LIMITER_TOKENS.ModuleMarker)) throw new RateLimiterError(`RateLimiterModule was not imported. Cannot resolve throttle "${name}". Import RateLimiterModule.forRoot({ store: ... }) in your AppModule.`);
+			return this.container.resolve(RATE_LIMITER_TOKENS.Registry).handle(name, ctx, next);
+		}
+	};
+	ThrottleMiddleware = __decorate([Transient(), __decorateParam(0, inject(CONTAINER_TOKEN))], ThrottleMiddleware);
+	Object.defineProperty(ThrottleMiddleware, "name", { value: `Throttle(${name})` });
+	cache.set(name, ThrottleMiddleware);
+	return ThrottleMiddleware;
+}
+//#endregion
+//#region src/router/router.error.ts
+var RouterError = class extends ApplicationError {};
+//#endregion
+//#region src/router/router.internals.ts
+/**
+* Symbol keys for Router internal accessors.
+*
+* These symbols are NOT exported from the public `stratal/router` barrel.
+* Only internal modules (RouterResolver) import them, keeping the Router's
+* public API clean — users never see these methods.
+*
+* Declared as individual unique symbols so TypeScript can distinguish
+* their return types in computed property access.
+*
+* @internal
+*/
+/** @internal */
+const getDefaultEntry = Symbol("Router.getDefaultEntry");
+/** @internal */
+const getGroups = Symbol("Router.getGroups");
+/** @internal */
+const getGlobalMiddleware = Symbol("Router.getGlobalMiddleware");
+//#endregion
+//#region src/router/router.ts
+/**
+* Fluent builder for route and middleware configuration.
+*
+* Scoped methods (`middleware()`, `prefix()`, `domain()`, `name()`, `version()`, `hideFromDocs()`)
+* apply only to this module's controllers or the sub-group's controllers.
+*
+* `use()` registers global middleware (all routes in the entire app).
+* Only callable on the root Router — throws inside `group()` callbacks.
+*
+* `group()` creates sub-groups for specific controllers with a callback.
+* Controllers in a sub-group are excluded from the parent scope.
+*/
+var Router = class Router {
+	_isChild;
+	_defaultEntry = { middleware: [] };
+	_groups = [];
+	_globalMiddleware = [];
+	constructor(isChild = false) {
+		this._isChild = isChild;
+	}
+	/** Dynamic path prefix. For shared segments like `/:companyId` */
+	prefix(path, params) {
+		this._defaultEntry.prefix = path;
+		this._defaultEntry.params = params;
+		return this;
+	}
+	/** Domain pattern for controllers in this scope */
+	domain(pattern) {
+		this._defaultEntry.domain = pattern;
+		return this;
+	}
+	/** Name prefix for routes in this scope */
+	name(prefix) {
+		this._defaultEntry.name = prefix;
+		return this;
+	}
+	/** Middleware applied to controllers in this scope */
+	middleware(...middlewares) {
+		this._defaultEntry.middleware.push(...middlewares);
+		return this;
+	}
+	/**
+	* Apply a named rate limiter to controllers in this scope.
+	*
+	* The named limiter must be registered via `RateLimiterRegistry.for(name, ...)`
+	* (typically inside a module's `onInitialize` hook), and the user must
+	* import `RateLimiterModule.forRoot({ store: ... })` in their AppModule.
+	*
+	* @example
+	* ```typescript
+	* router.prefix('/uploads').throttle('uploads')
+	* router.group([AdminController], (admin) => admin.throttle('admin'))
+	* ```
+	*/
+	throttle(name) {
+		this._defaultEntry.middleware.push(createThrottleMiddleware(name));
+		return this;
+	}
+	/** API version for controllers in this scope */
+	version(version) {
+		this._defaultEntry.version = version;
+		return this;
+	}
+	/** Hide/show routes in this scope from OpenAPI docs */
+	hideFromDocs(hide = true) {
+		this._defaultEntry.hideFromDocs = hide;
+		return this;
+	}
+	/**
+	* Global middleware — applied to ALL routes in the entire app.
+	* Only callable on the root Router. Throws if called inside `group()`.
+	*/
+	use(...middlewares) {
+		if (this._isChild) throw new RouterError("router.use() is only allowed on the root Router. It cannot be called inside a group() callback.");
+		this._globalMiddleware.push(...middlewares);
+		return this;
+	}
+	/**
+	* Create a sub-group for specific controllers/gateways.
+	* Controllers in a sub-group are excluded from the parent (default) scope.
+	* The callback receives a new Router (without `use()`) for fluent configuration.
+	*/
+	group(controllers, callback) {
+		const childRouter = new Router(true);
+		callback(childRouter);
+		this._groups.push({
+			...childRouter._defaultEntry,
+			controllers
+		});
+		return this;
+	}
+	[getDefaultEntry]() {
+		return this._defaultEntry;
+	}
+	[getGroups]() {
+		return this._groups;
+	}
+	[getGlobalMiddleware]() {
+		return this._globalMiddleware;
+	}
+};
+//#endregion
+//#region src/module/module-registry.ts
+var ModuleRegistry = class {
+	container;
+	logger;
+	modules = [];
+	registeredClasses = /* @__PURE__ */ new Set();
+	initialized = false;
+	allControllers = [];
+	allConsumers = [];
+	allJobs = [];
+	allListeners = [];
+	allCommands = [];
+	allSeeders = [];
+	allRouterConfigs = [];
+	constructor(container, logger) {
+		this.container = container;
+		this.logger = logger;
+	}
+	register(moduleOrDynamic) {
+		const { moduleClass, options } = this.resolveModule(moduleOrDynamic);
+		if (this.handleAlreadyRegistered(moduleClass, moduleOrDynamic)) return;
+		this.registeredClasses.add(moduleClass);
+		this.logger.info(`Registering module: ${moduleClass.name}`);
+		for (const ImportedModule of options.imports ?? []) this.register(ImportedModule);
+		const registered = this.registerModuleNode(moduleClass, options, { includeHttpWiring: true });
+		if (this.initialized && registered.hasLifecycle) this.logger.warn(`Module ${moduleClass.name} was registered eagerly after initialization; its onInitialize/onShutdown/configureRoutes hooks will not run. Load it via LazyModuleLoader instead.`);
+	}
+	/**
+	* Register a module on demand (NestJS-style lazy loading). Registers nested
+	* imports recursively and providers, then runs `onInitialize` immediately
+	* (the bootstrap-time batch {@link initialize} has already completed).
+	*
+	* Controllers, queue consumers, and cron jobs are SKIPPED — route, queue, and
+	* cron wiring is finalized at bootstrap and cannot be extended at runtime.
+	*/
+	async registerLazy(moduleOrDynamic) {
+		const { moduleClass, options } = this.resolveModule(moduleOrDynamic);
+		if (this.handleAlreadyRegistered(moduleClass, moduleOrDynamic)) return;
+		this.registeredClasses.add(moduleClass);
+		this.logger.info(`Lazily registering module: ${moduleClass.name}`);
+		for (const ImportedModule of options.imports ?? []) await this.registerLazy(ImportedModule);
+		const registered = this.registerModuleNode(moduleClass, options, { includeHttpWiring: false });
+		if (registered.hasLifecycle) {
+			const instance = new registered.moduleClass();
+			registered.instance = instance;
+			if (this.hasOnInitialize(instance)) {
+				const context = {
+					container: this.container,
+					logger: this.logger
+				};
+				this.logger.info(`Initializing (lazy): ${registered.moduleClass.name}`);
+				await instance.onInitialize(context);
+			}
+		}
+	}
+	registerAll(modules) {
+		for (const module of modules) this.register(module);
+	}
+	hasRegistered(moduleClass) {
+		return this.registeredClasses.has(moduleClass);
+	}
+	/**
+	* Handle re-registration of an already-known module. For a DynamicModule,
+	* its extra providers are wired (without re-running lifecycle); for a plain
+	* class it is a no-op. Returns true when the module was already registered.
+	*/
+	handleAlreadyRegistered(moduleClass, moduleOrDynamic) {
+		if (!this.registeredClasses.has(moduleClass)) return false;
+		if (this.isDynamicModule(moduleOrDynamic)) {
+			this.logger.debug(`Module ${moduleClass.name} already registered, registering DynamicModule providers`);
+			const { module: _, ...dynamicRest } = moduleOrDynamic;
+			for (const provider of dynamicRest.providers ?? []) this.registerProvider(provider);
+		} else this.logger.debug(`Module ${moduleClass.name} already registered, skipping`);
+		return true;
+	}
+	/**
+	* Register a single module's providers (and, for eager registration, its
+	* controllers/consumers/jobs), detect lifecycle hooks, and record it.
+	* Assumes the module's `imports` have already been registered by the caller.
+	*/
+	registerModuleNode(moduleClass, options, { includeHttpWiring }) {
+		for (const provider of options.providers ?? []) this.registerProvider(provider, {
+			lazy: !includeHttpWiring,
+			moduleName: moduleClass.name
+		});
+		if (includeHttpWiring) {
+			for (const controller of options.controllers ?? []) {
+				this.container.register(controller);
+				this.allControllers.push(controller);
+			}
+			for (const consumer of options.consumers ?? []) {
+				this.container.register(consumer);
+				this.allConsumers.push(consumer);
+				this.logger.info(`Collected consumer: ${consumer.name}`, { queueCount: this.allConsumers.length });
+			}
+			for (const job of options.jobs ?? []) {
+				this.container.register(job);
+				this.allJobs.push(job);
+			}
+		} else {
+			const skipped = [];
+			if (options.controllers?.length) skipped.push("controllers");
+			if (options.consumers?.length) skipped.push("consumers");
+			if (options.jobs?.length) skipped.push("jobs");
+			if ("configureRoutes" in moduleClass.prototype) skipped.push("configureRoutes");
+			if ("onException" in moduleClass.prototype) skipped.push("onException");
+			if (skipped.length) this.logger.warn(`Lazy module ${moduleClass.name} declares ${skipped.join("/")} which are skipped — route, queue, cron, and exception-handler wiring is finalized at bootstrap`);
+		}
+		const registered = {
+			moduleClass,
+			options,
+			instance: null,
+			hasLifecycle: "onInitialize" in moduleClass.prototype || "onShutdown" in moduleClass.prototype || "onException" in moduleClass.prototype || "configureRoutes" in moduleClass.prototype
+		};
+		this.modules.push(registered);
+		return registered;
+	}
+	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]) {
+			if (!registered.hasLifecycle) continue;
+			const instance = new registered.moduleClass();
+			registered.instance = instance;
+			if (this.hasOnInitialize(instance)) {
+				this.logger.info(`Initializing: ${registered.moduleClass.name}`);
+				await instance.onInitialize(context);
+			}
+		}
+		this.initialized = true;
+		this.logger.info("All modules initialized");
+	}
+	getAllControllers() {
+		return this.allControllers;
+	}
+	getAllConsumers() {
+		return this.allConsumers;
+	}
+	getAllJobs() {
+		return this.allJobs;
+	}
+	getAllListeners() {
+		return this.allListeners;
+	}
+	getAllCommands() {
+		return this.allCommands;
+	}
+	getAllSeeders() {
+		return this.allSeeders;
+	}
+	getAllRouterConfigs() {
+		if (this.allRouterConfigs.length === 0) {
+			for (const { moduleClass, options, instance } of this.modules) if (instance && this.hasRouteConfigurable(instance)) {
+				this.logger.debug(`Configuring routes for: ${moduleClass.name}`);
+				const router = new Router();
+				instance.configureRoutes(router);
+				const moduleControllers = options.controllers ?? [];
+				this.allRouterConfigs.push({
+					router,
+					controllers: moduleControllers
+				});
+			}
+		}
+		return this.allRouterConfigs;
+	}
+	configureExceptionHandlers(handler) {
+		for (const { moduleClass, instance } of this.modules) if (instance && this.hasOnException(instance)) {
+			this.logger.debug(`Configuring exception handlers for: ${moduleClass.name}`);
+			instance.onException(handler);
+		}
+	}
+	async shutdown() {
+		this.logger.info("Shutting down modules...");
+		const context = {
+			container: this.container,
+			logger: this.logger
+		};
+		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");
+	}
+	hasRouteConfigurable(instance) {
+		return typeof instance === "object" && instance !== null && "configureRoutes" in instance && typeof instance.configureRoutes === "function";
+	}
+	hasOnInitialize(instance) {
+		return typeof instance === "object" && instance !== null && "onInitialize" in instance && typeof instance.onInitialize === "function";
+	}
+	hasOnShutdown(instance) {
+		return typeof instance === "object" && instance !== null && "onShutdown" in instance && typeof instance.onShutdown === "function";
+	}
+	hasOnException(instance) {
+		return typeof instance === "object" && instance !== null && "onException" in instance && typeof instance.onException === "function";
+	}
+	resolveModule(moduleOrDynamic) {
+		if (this.isDynamicModule(moduleOrDynamic)) {
+			const { module: moduleClass, ...dynamicRest } = moduleOrDynamic;
+			const decoratorOptions = getModuleOptions(moduleClass) ?? {};
+			return {
+				moduleClass,
+				options: {
+					...decoratorOptions,
+					...dynamicRest,
+					providers: [...decoratorOptions.providers ?? [], ...dynamicRest.providers ?? []],
+					imports: [...decoratorOptions.imports ?? []]
+				}
+			};
+		}
+		const moduleClass = moduleOrDynamic;
+		return {
+			moduleClass,
+			options: getModuleOptions(moduleClass) ?? {}
+		};
+	}
+	isDynamicModule(value) {
+		return typeof value === "object" && value !== null && "module" in value && typeof value.module === "function";
+	}
+	registerProvider(provider, { lazy = false, moduleName } = {}) {
+		if (lazy) {
+			const token = this.providerToken(provider);
+			if (token !== null && this.container.isRegistered(token)) {
+				this.logger.warn(`Lazy module ${moduleName ?? "(unknown)"} provides ${this.describeToken(token)}, which is already registered by another module — keeping the existing binding and ignoring the lazy provider.`);
+				return;
+			}
+		}
+		if (typeof provider === "function") {
+			this.container.register(provider);
+			this.collectIfListener(provider);
+			this.collectIfCommand(provider);
+			this.collectIfSeeder(provider);
+		} else if ("useClass" in provider) {
+			this.container.register(provider.provide, provider.useClass);
+			this.collectIfListener(provider.useClass);
+			this.collectIfCommand(provider.useClass);
+			this.collectIfSeeder(provider.useClass);
+		} else if ("useValue" in provider) this.container.registerValue(provider.provide, provider.useValue);
+		else if ("useFactory" in provider) {
+			const { provide, useFactory, inject = [] } = provider;
+			this.container.registerFactory(provide, (c) => {
+				return useFactory(...inject.map((token) => c.resolve(token)));
+			});
+		} else if ("useExisting" in provider) this.container.registerExisting(provider.provide, provider.useExisting);
+	}
+	/** The DI token a provider binds, for collision detection. */
+	providerToken(provider) {
+		if (typeof provider === "function") return provider;
+		if ("provide" in provider) return provider.provide;
+		return null;
+	}
+	describeToken(token) {
+		if (typeof token === "function") return token.name;
+		if (typeof token === "symbol") return token.toString();
+		if (typeof token === "string") return token;
+		return "lazy token";
+	}
+	collectIfCommand(providerClass) {
+		if (isCommand(providerClass) && !this.allCommands.includes(providerClass)) {
+			this.allCommands.push(providerClass);
+			this.logger.debug(`Collected command: ${providerClass.name}`);
+		}
+	}
+	collectIfSeeder(providerClass) {
+		if (isSeeder(providerClass) && !this.allSeeders.includes(providerClass)) {
+			this.allSeeders.push(providerClass);
+			this.logger.debug(`Collected seeder: ${providerClass.name}`);
+		}
+	}
+	collectIfListener(providerClass) {
+		if (isListener(providerClass)) {
+			this.container.register(providerClass);
+			this.allListeners.push(providerClass);
+			this.logger.debug(`Collected listener: ${providerClass.name}`);
+		}
+	}
+};
+//#endregion
+export { getGroups as a, RATE_LIMITER_TOKENS as c, LazyModuleLoader as d, ModuleRef as f, getGlobalMiddleware as i, RateLimiterError as l, Router as n, RouterError as o, getDefaultEntry as r, createThrottleMiddleware as s, ModuleRegistry as t, TooManyRequestsError as u };
+
+//# sourceMappingURL=module-registry-Dm-pqHd3.mjs.map

package/dist/module-registry-Dm-pqHd3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-registry-Dm-pqHd3.mjs","names":["internal.getDefaultEntry","internal.getGroups","internal.getGlobalMiddleware"],"sources":["../src/module/module-ref.ts","../src/module/lazy-module-loader.ts","../src/rate-limiter/errors.ts","../src/rate-limiter/rate-limiter.tokens.ts","../src/rate-limiter/throttle.middleware.ts","../src/router/router.error.ts","../src/router/router.internals.ts","../src/router/router.ts","../src/module/module-registry.ts"],"sourcesContent":["import type { Container } from '../di/container'\nimport type { InjectionToken } from '../di/types'\nimport type { Constructor } from '../types'\n\n/**\n * Handle to a lazily loaded module, returned by {@link LazyModuleLoader.load}.\n *\n * Resolves providers from the global container, so singletons registered by the\n * lazy module persist across requests.\n *\n * Note: request-scoped providers resolved via {@link ModuleRef.get} degrade to\n * transient instances (there is no ambient request scope here). To obtain a\n * true per-request instance, resolve the token from the request container\n * inside a request scope instead.\n */\nexport class ModuleRef {\n  constructor(\n    private readonly container: Container,\n    /** The module class this ref was loaded from. */\n    readonly moduleClass: Constructor,\n  ) { }\n\n  /** Resolve a provider from the lazily loaded module (global scope). */\n  get<T>(token: InjectionToken<T>): T {\n    return this.container.resolve(token)\n  }\n\n  /** Async variant of {@link ModuleRef.get}, matching the NestJS API shape. */\n  resolve<T>(token: InjectionToken<T>): Promise<T> {\n    return Promise.resolve(this.container.resolve(token))\n  }\n}\n","import { inject } from '../di/decorators'\nimport type { Container } from '../di/container'\nimport { DI_TOKENS } from '../di/tokens'\nimport { LOGGER_TOKENS, type LoggerService } from '../logger'\nimport type { Constructor } from '../types'\nimport { ModuleRef } from './module-ref'\nimport type { ModuleRegistry } from './module-registry'\nimport type { DynamicModule, ModuleClass } from './types'\n\n/**\n * Loads modules on demand (NestJS-style), so optional features stay out of the\n * cold-start path until first use.\n *\n * Inject {@link DI_TOKENS.LazyModuleLoader} and call {@link load}:\n *\n * ```ts\n * const ref = await loader.load(() => import('./reports.module').then(m => m.ReportsModule))\n * const reports = ref.get(ReportService)\n * ```\n *\n * The loaded module's nested `imports` and `providers` are registered into the\n * global container and its `onInitialize` hook runs once. Controllers, queue\n * consumers, and cron jobs are skipped — that wiring is finalized at bootstrap.\n * Repeat loads of the same module return the cached {@link ModuleRef} without\n * re-registering.\n */\nexport class LazyModuleLoader {\n  private readonly cache = new Map<Constructor, ModuleRef>()\n  private readonly inFlight = new Map<Constructor, Promise<ModuleRef>>()\n\n  constructor(\n    @inject(DI_TOKENS.ModuleRegistry) private readonly registry: ModuleRegistry,\n    @inject(DI_TOKENS.Container) private readonly container: Container,\n    @inject(LOGGER_TOKENS.LoggerService) private readonly logger: LoggerService,\n  ) { }\n\n  async load(loaderFn: () => Promise<ModuleClass | DynamicModule>): Promise<ModuleRef> {\n    const loaded = await loaderFn()\n    const { moduleClass } = this.registry.resolveModule(loaded)\n\n    const cached = this.cache.get(moduleClass)\n    if (cached) return cached\n\n    const inFlight = this.inFlight.get(moduleClass)\n    if (inFlight) return inFlight\n\n    const promise = this.registerAndBuild(moduleClass, loaded)\n    this.inFlight.set(moduleClass, promise)\n    try {\n      return await promise\n    } finally {\n      this.inFlight.delete(moduleClass)\n    }\n  }\n\n  private async registerAndBuild(\n    moduleClass: Constructor,\n    loaded: ModuleClass | DynamicModule,\n  ): Promise<ModuleRef> {\n    this.logger.debug(`Lazy loading module: ${moduleClass.name}`)\n    await this.registry.registerLazy(loaded)\n    const ref = new ModuleRef(this.container.getRootContainer(), moduleClass)\n    this.cache.set(moduleClass, ref)\n    return ref\n  }\n}\n","import { ApplicationError, HttpException } from '../errors'\n\n/**\n * Thrown when a request exceeds a configured rate limit.\n *\n * HTTP Status: 429 Too Many Requests\n *\n * The {@link ExceptionHandler} renders the body via content negotiation\n * (HTML for HTML clients, JSON for everything else). Standard rate-limit\n * headers (`Retry-After`, `X-RateLimit-*`) are injected by the\n * `respond()` callback registered via `RateLimiterModule.onException`.\n */\nexport class TooManyRequestsError extends HttpException {\n  constructor(\n    public readonly info: { retryAfter: number; limit: number; resetAt: number },\n  ) {\n    super(429, 'Too many requests')\n  }\n}\n\nexport class RateLimiterError extends ApplicationError {}\n","export const RATE_LIMITER_TOKENS = {\n  Registry: Symbol.for('stratal:rate-limiter:registry'),\n  Store: Symbol.for('stratal:rate-limiter:store'),\n  StoreFactory: Symbol.for('stratal:rate-limiter:store-factory'),\n  Options: Symbol.for('stratal:rate-limiter:options'),\n  /**\n   * Per-app marker registered by RateLimiterModule.onInitialize. Used by\n   * ThrottleMiddleware to detect \"module not imported\".\n   */\n  ModuleMarker: Symbol.for('stratal:rate-limiter:module-marker'),\n} as const\n\nexport type RateLimiterToken = (typeof RATE_LIMITER_TOKENS)[keyof typeof RATE_LIMITER_TOKENS]\n","import { inject } from '../di'\nimport { CONTAINER_TOKEN, type Container } from '../di'\nimport { Transient } from '../di/decorators'\nimport type { Middleware, Next } from '../router/middleware.interface'\nimport type { RouterContext } from '../router/router-context'\nimport type { Constructor } from '../types'\nimport { RateLimiterError } from './errors'\nimport type { RateLimiterRegistry } from './rate-limiter-registry'\nimport { RATE_LIMITER_TOKENS } from './rate-limiter.tokens'\n\nconst cache = new Map<string, Constructor<Middleware>>()\n\n/**\n * Memoized factory that produces a Stratal `Middleware` class bound to a\n * named limiter. Calling twice with the same name returns the *same* class\n * — important for `Router.middleware` deduplication via class identity.\n *\n * Detection of \"module not imported\" works against a per-app marker\n * registered by `RateLimiterModule.onInitialize`. We check\n * `isRegistered(marker)` at request time before resolving Registry.\n */\nexport function createThrottleMiddleware(name: string): Constructor<Middleware> {\n  const existing = cache.get(name)\n  if (existing) return existing\n\n  @Transient()\n  class ThrottleMiddleware implements Middleware {\n    constructor(\n      @inject(CONTAINER_TOKEN) private readonly container: Container,\n    ) {}\n\n    handle(ctx: RouterContext, next: Next): Promise<Response | void> {\n      if (!this.container.isRegistered(RATE_LIMITER_TOKENS.ModuleMarker)) {\n        throw new RateLimiterError(`RateLimiterModule was not imported. Cannot resolve throttle \"${name}\". Import RateLimiterModule.forRoot({ store: ... }) in your AppModule.`)\n      }\n      const registry = this.container.resolve<RateLimiterRegistry>(RATE_LIMITER_TOKENS.Registry)\n      return registry.handle(name, ctx, next)\n    }\n  }\n\n  Object.defineProperty(ThrottleMiddleware, 'name', { value: `Throttle(${name})` })\n  cache.set(name, ThrottleMiddleware)\n  return ThrottleMiddleware\n}\n\n/**\n * Test-only escape hatch: clear the per-name middleware class cache.\n * Production code never needs this.\n */\nexport function _resetThrottleMiddlewareCache(): void {\n  cache.clear()\n}\n","import { ApplicationError } from '../errors'\n\nexport class RouterError extends ApplicationError {}\n","/**\n * Symbol keys for Router internal accessors.\n *\n * These symbols are NOT exported from the public `stratal/router` barrel.\n * Only internal modules (RouterResolver) import them, keeping the Router's\n * public API clean — users never see these methods.\n *\n * Declared as individual unique symbols so TypeScript can distinguish\n * their return types in computed property access.\n *\n * @internal\n */\n\n/** @internal */\nexport const getDefaultEntry: unique symbol = Symbol('Router.getDefaultEntry')\n/** @internal */\nexport const getGroups: unique symbol = Symbol('Router.getGroups')\n/** @internal */\nexport const getGlobalMiddleware: unique symbol = Symbol('Router.getGlobalMiddleware')\n","import type { ZodObject } from '../i18n/validation/zod'\nimport { createThrottleMiddleware } from '../rate-limiter/throttle.middleware'\nimport type { Constructor } from '../types'\nimport { RouterError } from './router.error'\nimport type { Middleware } from './middleware.interface'\nimport * as internal from './router.internals'\n\n/**\n * Configuration for a sub-group created via `router.group()`.\n */\nexport interface RouterGroupConfig {\n  prefix?: string\n  domain?: string\n  name?: string\n  middleware?: Constructor<Middleware>[]\n  version?: string | string[]\n  hideFromDocs?: boolean\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- ZodObject generics require any for flexible shape parameter\n  params?: ZodObject<any>\n}\n\n/**\n * Internal entry representing a sub-group or the default scope.\n * @internal — used by RouterResolver, not exported publicly.\n */\nexport interface RouterEntry {\n  prefix?: string\n  domain?: string\n  name?: string\n  middleware: Constructor<Middleware>[]\n  version?: string | string[]\n  hideFromDocs?: boolean\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- ZodObject generics require any for flexible shape parameter\n  params?: ZodObject<any>\n  /** Controllers in this entry. undefined = all controllers not in any sub-group */\n  controllers?: Constructor[]\n}\n\n/**\n * Modules implement this to configure routes and middleware.\n * Replaces `MiddlewareConfigurable`.\n *\n * @example\n * ```typescript\n * @Module({ controllers: [UsersController, PostsController] })\n * export class ApiModule implements RouteConfigurable {\n *   configureRoutes(router: Router): void {\n *     router\n *       .name('api.')\n *       .middleware(CorsMiddleware)\n *       .version('1')\n *   }\n * }\n * ```\n */\nexport interface RouteConfigurable {\n  configureRoutes(router: Router): void\n}\n\n/**\n * Fluent builder for route and middleware configuration.\n *\n * Scoped methods (`middleware()`, `prefix()`, `domain()`, `name()`, `version()`, `hideFromDocs()`)\n * apply only to this module's controllers or the sub-group's controllers.\n *\n * `use()` registers global middleware (all routes in the entire app).\n * Only callable on the root Router — throws inside `group()` callbacks.\n *\n * `group()` creates sub-groups for specific controllers with a callback.\n * Controllers in a sub-group are excluded from the parent scope.\n */\nexport class Router {\n  private readonly _isChild: boolean\n  private readonly _defaultEntry: RouterEntry = { middleware: [] }\n  private readonly _groups: RouterEntry[] = []\n  private readonly _globalMiddleware: Constructor<Middleware>[] = []\n\n  constructor(isChild = false) {\n    this._isChild = isChild\n  }\n\n  /** Dynamic path prefix. For shared segments like `/:companyId` */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- ZodObject generics require any for flexible shape parameter\n  prefix(path: string, params?: ZodObject<any>): this {\n    this._defaultEntry.prefix = path\n    this._defaultEntry.params = params\n    return this\n  }\n\n  /** Domain pattern for controllers in this scope */\n  domain(pattern: string): this {\n    this._defaultEntry.domain = pattern\n    return this\n  }\n\n  /** Name prefix for routes in this scope */\n  name(prefix: string): this {\n    this._defaultEntry.name = prefix\n    return this\n  }\n\n  /** Middleware applied to controllers in this scope */\n  middleware(...middlewares: Constructor<Middleware>[]): this {\n    this._defaultEntry.middleware.push(...middlewares)\n    return this\n  }\n\n  /**\n   * Apply a named rate limiter to controllers in this scope.\n   *\n   * The named limiter must be registered via `RateLimiterRegistry.for(name, ...)`\n   * (typically inside a module's `onInitialize` hook), and the user must\n   * import `RateLimiterModule.forRoot({ store: ... })` in their AppModule.\n   *\n   * @example\n   * ```typescript\n   * router.prefix('/uploads').throttle('uploads')\n   * router.group([AdminController], (admin) => admin.throttle('admin'))\n   * ```\n   */\n  throttle(name: string): this {\n    this._defaultEntry.middleware.push(createThrottleMiddleware(name))\n    return this\n  }\n\n  /** API version for controllers in this scope */\n  version(version: string | string[]): this {\n    this._defaultEntry.version = version\n    return this\n  }\n\n  /** Hide/show routes in this scope from OpenAPI docs */\n  hideFromDocs(hide = true): this {\n    this._defaultEntry.hideFromDocs = hide\n    return this\n  }\n\n  /**\n   * Global middleware — applied to ALL routes in the entire app.\n   * Only callable on the root Router. Throws if called inside `group()`.\n   */\n  use(...middlewares: Constructor<Middleware>[]): this {\n    if (this._isChild) {\n      throw new RouterError('router.use() is only allowed on the root Router. It cannot be called inside a group() callback.')\n    }\n    this._globalMiddleware.push(...middlewares)\n    return this\n  }\n\n  /**\n   * Create a sub-group for specific controllers/gateways.\n   * Controllers in a sub-group are excluded from the parent (default) scope.\n   * The callback receives a new Router (without `use()`) for fluent configuration.\n   */\n  group(controllers: Constructor[], callback: (router: Omit<Router, 'use'>) => void): this {\n    const childRouter = new Router(true)\n    callback(childRouter)\n\n    this._groups.push({\n      ...childRouter._defaultEntry,\n      controllers,\n    })\n    return this\n  }\n\n  // --- Internal accessors via symbol keys (invisible to consumers) ---\n\n  [internal.getDefaultEntry](): RouterEntry {\n    return this._defaultEntry\n  }\n\n  [internal.getGroups](): RouterEntry[] {\n    return this._groups\n  }\n\n  [internal.getGlobalMiddleware](): Constructor<Middleware>[] {\n    return this._globalMiddleware\n  }\n}\n","import type { Container } from '../di/container'\nimport { isListener } from '../events'\nimport type { LoggerService } from '../logger'\nimport { Router, type RouteConfigurable } from '../router/router'\nimport { isCommand } from '../quarry/is-command'\nimport { isSeeder } from '../seeder/is-seeder'\nimport type { Constructor } from '../types'\nimport { getModuleOptions } from './module.decorator'\nimport type { ExceptionHandler } from '../errors/exception-handler'\nimport type {\n  DynamicModule,\n  InjectionToken,\n  ModuleClass,\n  ModuleContext,\n  ModuleOptions,\n  OnException,\n  OnInitialize,\n  OnShutdown,\n  Provider,\n} from './types'\n\n\ninterface RegisteredModule {\n  moduleClass: Constructor\n  options: ModuleOptions\n  instance: object | null\n  hasLifecycle: boolean\n}\n\nexport class ModuleRegistry {\n  private modules: RegisteredModule[] = []\n  private registeredClasses = new Set<Constructor>()\n  private initialized = false\n\n  private allControllers: Constructor[] = []\n  private allConsumers: Constructor[] = []\n  private allJobs: Constructor[] = []\n  private allListeners: Constructor[] = []\n  private allCommands: Constructor[] = []\n  private allSeeders: Constructor[] = []\n  private allRouterConfigs: { router: Router; controllers: Constructor[] }[] = []\n\n  constructor(\n    private readonly container: Container,\n    private readonly logger: LoggerService\n  ) { }\n\n  register(moduleOrDynamic: ModuleClass | DynamicModule): void {\n    const { moduleClass, options } = this.resolveModule(moduleOrDynamic)\n\n    if (this.handleAlreadyRegistered(moduleClass, moduleOrDynamic)) return\n\n    this.registeredClasses.add(moduleClass)\n    this.logger.info(`Registering module: ${moduleClass.name}`)\n\n    for (const ImportedModule of options.imports ?? []) {\n      this.register(ImportedModule)\n    }\n\n    const registered = this.registerModuleNode(moduleClass, options, { includeHttpWiring: true })\n\n    // Eager register() is synchronous and assumes the bootstrap initialize()\n    // batch will run lifecycle hooks. If it's called AFTER initialization (e.g. a\n    // built-in subsystem registered on first use), that batch has finished and\n    // won't revisit this module — so a lifecycle hook would be silently dropped.\n    // Surface it instead of failing silently; load such modules via\n    // LazyModuleLoader (registerLazy), which runs onInitialize immediately.\n    if (this.initialized && registered.hasLifecycle) {\n      this.logger.warn(\n        `Module ${moduleClass.name} was registered eagerly after initialization; its onInitialize/onShutdown/configureRoutes hooks will not run. Load it via LazyModuleLoader instead.`,\n      )\n    }\n  }\n\n  /**\n   * Register a module on demand (NestJS-style lazy loading). Registers nested\n   * imports recursively and providers, then runs `onInitialize` immediately\n   * (the bootstrap-time batch {@link initialize} has already completed).\n   *\n   * Controllers, queue consumers, and cron jobs are SKIPPED — route, queue, and\n   * cron wiring is finalized at bootstrap and cannot be extended at runtime.\n   */\n  async registerLazy(moduleOrDynamic: ModuleClass | DynamicModule): Promise<void> {\n    const { moduleClass, options } = this.resolveModule(moduleOrDynamic)\n\n    if (this.handleAlreadyRegistered(moduleClass, moduleOrDynamic)) return\n\n    this.registeredClasses.add(moduleClass)\n    this.logger.info(`Lazily registering module: ${moduleClass.name}`)\n\n    for (const ImportedModule of options.imports ?? []) {\n      await this.registerLazy(ImportedModule)\n    }\n\n    const registered = this.registerModuleNode(moduleClass, options, { includeHttpWiring: false })\n\n    if (registered.hasLifecycle) {\n      const instance = new registered.moduleClass()\n      registered.instance = instance\n      if (this.hasOnInitialize(instance)) {\n        const context: ModuleContext = { container: this.container, logger: this.logger }\n        this.logger.info(`Initializing (lazy): ${registered.moduleClass.name}`)\n        await instance.onInitialize(context)\n      }\n    }\n  }\n\n  registerAll(modules: (ModuleClass | DynamicModule)[]): void {\n    for (const module of modules) {\n      this.register(module)\n    }\n  }\n\n  hasRegistered(moduleClass: Constructor): boolean {\n    return this.registeredClasses.has(moduleClass)\n  }\n\n  /**\n   * Handle re-registration of an already-known module. For a DynamicModule,\n   * its extra providers are wired (without re-running lifecycle); for a plain\n   * class it is a no-op. Returns true when the module was already registered.\n   */\n  private handleAlreadyRegistered(\n    moduleClass: Constructor,\n    moduleOrDynamic: ModuleClass | DynamicModule,\n  ): boolean {\n    if (!this.registeredClasses.has(moduleClass)) return false\n\n    if (this.isDynamicModule(moduleOrDynamic)) {\n      this.logger.debug(`Module ${moduleClass.name} already registered, registering DynamicModule providers`)\n      const { module: _, ...dynamicRest } = moduleOrDynamic\n      for (const provider of dynamicRest.providers ?? []) {\n        this.registerProvider(provider)\n      }\n    } else {\n      this.logger.debug(`Module ${moduleClass.name} already registered, skipping`)\n    }\n    return true\n  }\n\n  /**\n   * Register a single module's providers (and, for eager registration, its\n   * controllers/consumers/jobs), detect lifecycle hooks, and record it.\n   * Assumes the module's `imports` have already been registered by the caller.\n   */\n  private registerModuleNode(\n    moduleClass: Constructor,\n    options: ModuleOptions,\n    { includeHttpWiring }: { includeHttpWiring: boolean },\n  ): RegisteredModule {\n    for (const provider of options.providers ?? []) {\n      this.registerProvider(provider, { lazy: !includeHttpWiring, moduleName: moduleClass.name })\n    }\n\n    if (includeHttpWiring) {\n      for (const controller of options.controllers ?? []) {\n        this.container.register(controller)\n        this.allControllers.push(controller)\n      }\n\n      for (const consumer of options.consumers ?? []) {\n        this.container.register(consumer)\n        this.allConsumers.push(consumer)\n        this.logger.info(`Collected consumer: ${consumer.name}`, { queueCount: this.allConsumers.length })\n      }\n\n      for (const job of options.jobs ?? []) {\n        this.container.register(job)\n        this.allJobs.push(job)\n      }\n    } else {\n      const skipped: string[] = []\n      if (options.controllers?.length) skipped.push('controllers')\n      if (options.consumers?.length) skipped.push('consumers')\n      if (options.jobs?.length) skipped.push('jobs')\n      if ('configureRoutes' in moduleClass.prototype) skipped.push('configureRoutes')\n      if ('onException' in moduleClass.prototype) skipped.push('onException')\n      if (skipped.length) {\n        this.logger.warn(\n          `Lazy module ${moduleClass.name} declares ${skipped.join('/')} which are skipped — ` +\n            `route, queue, cron, and exception-handler wiring is finalized at bootstrap`,\n        )\n      }\n    }\n\n    const hasLifecycle =\n      'onInitialize' in moduleClass.prototype ||\n      'onShutdown' in moduleClass.prototype ||\n      'onException' in moduleClass.prototype ||\n      'configureRoutes' in moduleClass.prototype\n\n    const registered: RegisteredModule = { moduleClass, options, instance: null, hasLifecycle }\n    this.modules.push(registered)\n    return registered\n  }\n\n  async initialize(): Promise<void> {\n    if (this.initialized) return\n\n    this.logger.info('Initializing modules...')\n\n    const context: ModuleContext = {\n      container: this.container,\n      logger: this.logger,\n    }\n\n    // Snapshot: a module's onInitialize may lazily load another module\n    // (LazyModuleLoader.load → registerLazy), which pushes to this.modules and\n    // initializes it itself. Iterating a snapshot prevents the batch loop from\n    // re-visiting (and double-initializing) those lazily-added modules.\n    for (const registered of [...this.modules]) {\n      if (!registered.hasLifecycle) continue\n\n      const instance = new registered.moduleClass()\n      registered.instance = instance\n\n      if (this.hasOnInitialize(instance)) {\n        this.logger.info(`Initializing: ${registered.moduleClass.name}`)\n        await instance.onInitialize(context)\n      }\n    }\n\n    this.initialized = true\n    this.logger.info('All modules initialized')\n  }\n\n  getAllControllers(): Constructor[] {\n    return this.allControllers\n  }\n\n  getAllConsumers(): Constructor[] {\n    return this.allConsumers\n  }\n\n  getAllJobs(): Constructor[] {\n    return this.allJobs\n  }\n\n  getAllListeners(): Constructor[] {\n    return this.allListeners\n  }\n\n  getAllCommands(): Constructor[] {\n    return this.allCommands\n  }\n\n  getAllSeeders(): Constructor[] {\n    return this.allSeeders\n  }\n\n  getAllRouterConfigs(): { router: Router; controllers: Constructor[] }[] {\n    if (this.allRouterConfigs.length === 0) {\n      for (const { moduleClass, options, instance } of this.modules) {\n        if (instance && this.hasRouteConfigurable(instance)) {\n          this.logger.debug(`Configuring routes for: ${moduleClass.name}`)\n          const router = new Router()\n          instance.configureRoutes(router)\n          const moduleControllers = options.controllers ?? []\n          this.allRouterConfigs.push({ router, controllers: moduleControllers })\n        }\n      }\n    }\n    return this.allRouterConfigs\n  }\n\n  configureExceptionHandlers(handler: ExceptionHandler): void {\n    for (const { moduleClass, instance } of this.modules) {\n      if (instance && this.hasOnException(instance)) {\n        this.logger.debug(`Configuring exception handlers for: ${moduleClass.name}`)\n        instance.onException(handler)\n      }\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    this.logger.info('Shutting down modules...')\n\n    const context: ModuleContext = {\n      container: this.container,\n      logger: this.logger,\n    }\n\n    const reversed = [...this.modules].reverse()\n\n    for (const { moduleClass, instance } of reversed) {\n      if (instance && this.hasOnShutdown(instance)) {\n        try {\n          await instance.onShutdown(context)\n        } catch (error) {\n          this.logger.error(`Error shutting down ${moduleClass.name}:`, error as Error)\n        }\n      }\n    }\n\n    this.logger.info('All modules shut down')\n  }\n\n  private hasRouteConfigurable(instance: unknown): instance is RouteConfigurable {\n    return (\n      typeof instance === 'object' &&\n      instance !== null &&\n      'configureRoutes' in instance &&\n      typeof (instance as RouteConfigurable).configureRoutes === 'function'\n    )\n  }\n\n  private hasOnInitialize(instance: unknown): instance is OnInitialize {\n    return (\n      typeof instance === 'object' &&\n      instance !== null &&\n      'onInitialize' in instance &&\n      typeof (instance as OnInitialize).onInitialize === 'function'\n    )\n  }\n\n  private hasOnShutdown(instance: unknown): instance is OnShutdown {\n    return (\n      typeof instance === 'object' &&\n      instance !== null &&\n      'onShutdown' in instance &&\n      typeof (instance as OnShutdown).onShutdown === 'function'\n    )\n  }\n\n  private hasOnException(instance: unknown): instance is OnException {\n    return (\n      typeof instance === 'object' &&\n      instance !== null &&\n      'onException' in instance &&\n      typeof (instance as OnException).onException === 'function'\n    )\n  }\n\n  resolveModule(moduleOrDynamic: ModuleClass | DynamicModule): {\n    moduleClass: Constructor\n    options: ModuleOptions\n  } {\n    if (this.isDynamicModule(moduleOrDynamic)) {\n      const { module: moduleClass, ...dynamicRest } = moduleOrDynamic\n\n      const decoratorOptions = getModuleOptions(moduleClass) ?? {}\n      const mergedOptions: ModuleOptions = {\n        ...decoratorOptions,\n        ...dynamicRest,\n        providers: [...(decoratorOptions.providers ?? []), ...(dynamicRest.providers ?? [])],\n        imports: [...(decoratorOptions.imports ?? [])],\n      }\n\n      return { moduleClass: moduleClass, options: mergedOptions }\n    }\n\n    const moduleClass = moduleOrDynamic as Constructor\n    const options = getModuleOptions(moduleClass) ?? {}\n    return { moduleClass, options }\n  }\n\n  isDynamicModule(value: unknown): value is DynamicModule {\n    return (\n      typeof value === 'object' &&\n      value !== null &&\n      'module' in value &&\n      typeof (value as DynamicModule).module === 'function'\n    )\n  }\n\n  private registerProvider(\n    provider: Provider,\n    { lazy = false, moduleName }: { lazy?: boolean; moduleName?: string } = {},\n  ): void {\n    if (lazy) {\n      const token = this.providerToken(provider)\n      // A lazy module registers onto the shared root container. If its token is\n      // already bound (by an eagerly-registered or previously-loaded module),\n      // overriding would silently clobber that binding — and break any\n      // shared-singleton rendezvous. Keep the existing binding and warn.\n      if (token !== null && this.container.isRegistered(token)) {\n        this.logger.warn(\n          `Lazy module ${moduleName ?? '(unknown)'} provides ${this.describeToken(token)}, ` +\n            `which is already registered by another module — keeping the existing binding and ignoring the lazy provider.`,\n        )\n        return\n      }\n    }\n\n    if (typeof provider === 'function') {\n      this.container.register(provider as Constructor)\n      this.collectIfListener(provider as Constructor)\n      this.collectIfCommand(provider as Constructor)\n      this.collectIfSeeder(provider as Constructor)\n    } else if ('useClass' in provider) {\n      this.container.register(provider.provide, provider.useClass as Constructor)\n      this.collectIfListener(provider.useClass as Constructor)\n      this.collectIfCommand(provider.useClass as Constructor)\n      this.collectIfSeeder(provider.useClass as Constructor)\n    } else if ('useValue' in provider) {\n      this.container.registerValue(provider.provide, provider.useValue)\n    } else if ('useFactory' in provider) {\n      const { provide, useFactory, inject = [] } = provider\n      this.container.registerFactory(provide, (c) => {\n        const deps = inject.map((token) => c.resolve(token))\n        return useFactory(...deps)\n      })\n    } else if ('useExisting' in provider) {\n      this.container.registerExisting(provider.provide, provider.useExisting)\n    }\n  }\n\n  /** The DI token a provider binds, for collision detection. */\n  private providerToken(provider: Provider): InjectionToken | null {\n    if (typeof provider === 'function') return provider as Constructor\n    if ('provide' in provider) return provider.provide\n    return null\n  }\n\n  private describeToken(token: InjectionToken): string {\n    if (typeof token === 'function') return token.name\n    if (typeof token === 'symbol') return token.toString()\n    if (typeof token === 'string') return token\n    return 'lazy token'\n  }\n\n  private collectIfCommand(providerClass: Constructor): void {\n    if (isCommand(providerClass) && !this.allCommands.includes(providerClass)) {\n      this.allCommands.push(providerClass)\n      this.logger.debug(`Collected command: ${providerClass.name}`)\n    }\n  }\n\n  private collectIfSeeder(providerClass: Constructor): void {\n    if (isSeeder(providerClass) && !this.allSeeders.includes(providerClass)) {\n      this.allSeeders.push(providerClass)\n      this.logger.debug(`Collected seeder: ${providerClass.name}`)\n    }\n  }\n\n  private collectIfListener(providerClass: Constructor): void {\n    if (isListener(providerClass)) {\n      // Register with the listener's own scope (`@Listener()` applies\n      // `@Transient()`) rather than forcing a singleton: listeners are resolved\n      // fresh per event from the emitting request scope, so a listener may inject\n      // request-scoped providers (i18n, queue senders, auth context, …).\n      this.container.register(providerClass)\n      this.allListeners.push(providerClass)\n      this.logger.debug(`Collected listener: ${providerClass.name}`)\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/module.decorator-CYHY6pG5.mjs

@@ -0,0 +1,19 @@
+import { n as getMetadata, r as hasMetadata, t as defineMetadata } from "./metadata-DzzprcID.mjs";
+//#region src/module/module.decorator.ts
+const MODULE_OPTIONS_KEY = Symbol.for("stratal:module:options");
+function Module(options) {
+	return (target) => {
+		defineMetadata(MODULE_OPTIONS_KEY, options, target);
+		return target;
+	};
+}
+function getModuleOptions(target) {
+	return getMetadata(MODULE_OPTIONS_KEY, target);
+}
+function isModuleClass(target) {
+	return typeof target === "function" && hasMetadata(MODULE_OPTIONS_KEY, target);
+}
+//#endregion
+export { isModuleClass as i, Module as n, getModuleOptions as r, MODULE_OPTIONS_KEY as t };
+
+//# sourceMappingURL=module.decorator-CYHY6pG5.mjs.map

package/dist/module.decorator-CYHY6pG5.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.decorator-CYHY6pG5.mjs","names":[],"sources":["../src/module/module.decorator.ts"],"sourcesContent":["import { defineMetadata, getMetadata, hasMetadata } from '../di/metadata'\nimport type { Constructor } from '../types'\nimport type { ModuleOptions } from './types'\n\nexport const MODULE_OPTIONS_KEY = Symbol.for('stratal:module:options')\n\nexport function Module(options: ModuleOptions) {\n  return <TFunction extends abstract new (...args: never[]) => unknown>(target: TFunction): TFunction => {\n    defineMetadata(MODULE_OPTIONS_KEY, options, target)\n    return target\n  }\n}\n\nexport function getModuleOptions(target: Constructor): ModuleOptions | undefined {\n  return getMetadata<ModuleOptions>(MODULE_OPTIONS_KEY, target)\n}\n\nexport function isModuleClass(target: unknown): target is Constructor {\n  return typeof target === 'function' && hasMetadata(MODULE_OPTIONS_KEY, target)\n}\n"],"mappings":";;AAIA,MAAa,qBAAqB,OAAO,IAAI,wBAAwB;AAErE,SAAgB,OAAO,SAAwB;CAC7C,QAAsE,WAAiC;EACrG,eAAe,oBAAoB,SAAS,MAAM;EAClD,OAAO;CACT;AACF;AAEA,SAAgB,iBAAiB,QAAgD;CAC/E,OAAO,YAA2B,oBAAoB,MAAM;AAC9D;AAEA,SAAgB,cAAc,QAAwC;CACpE,OAAO,OAAO,WAAW,cAAc,YAAY,oBAAoB,MAAM;AAC/E"}