@haskou/ddd-kernel 1.1.0 → 1.2.0

package/dist/adapters/ui/routes/index.js

@@ -268,6 +268,14 @@ var DependencyInjection = class _DependencyInjection {
   }
 };
 
+// src/kernel/KernelEnvironmentValidationError.ts
+var KernelEnvironmentValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "KernelEnvironmentValidationError";
+  }
+};
+
 // src/Kernel.ts
 var Kernel = class _Kernel {
   constructor(options = {}) {
@@ -287,6 +295,7 @@ var Kernel = class _Kernel {
   schedulersList = [];
   shutdownHooks = [];
   dependencyInjectionInstance;
+  environmentVariables = process.env;
   static get state() {
     const stateContainer = globalThis;
     stateContainer[_Kernel.stateKey] = stateContainer[_Kernel.stateKey] ?? {};
@@ -331,18 +340,82 @@ var Kernel = class _Kernel {
     }
     return _Kernel.state.activeKernel;
   }
+  static assertRequiredEnvironmentVariable(name, value, schema) {
+    if (schema[name]?.required === true && value === void 0) {
+      throw new KernelEnvironmentValidationError(
+        `Missing required environment variable "${name}".`
+      );
+    }
+  }
   static getEnvironmentVariablesPath(environment, options) {
     return path2.resolve(
       _Kernel.rootDirectory,
       options.path ?? (environment ? `.env.${environment}` : ".env")
     );
   }
+  static parseBooleanEnvironmentVariable(name, value) {
+    if (["1", "true", "yes", "on"].includes(value.toLowerCase())) {
+      return true;
+    }
+    if (["0", "false", "no", "off"].includes(value.toLowerCase())) {
+      return false;
+    }
+    throw new KernelEnvironmentValidationError(
+      `Environment variable "${name}" must be a boolean.`
+    );
+  }
+  static parseNumberEnvironmentVariable(name, value) {
+    if (value.trim() === "") {
+      throw new KernelEnvironmentValidationError(
+        `Environment variable "${name}" must be a number.`
+      );
+    }
+    const parsedValue = Number(value);
+    if (Number.isFinite(parsedValue)) {
+      return parsedValue;
+    }
+    throw new KernelEnvironmentValidationError(
+      `Environment variable "${name}" must be a number.`
+    );
+  }
+  static parseEnvironmentVariable(name, value, schema) {
+    const definition = schema[name];
+    if (definition.type === "boolean") {
+      return _Kernel.parseBooleanEnvironmentVariable(name, value);
+    }
+    if (definition.type === "number") {
+      return _Kernel.parseNumberEnvironmentVariable(name, value);
+    }
+    return value;
+  }
+  static validateEnvironmentVariables(schema) {
+    const environmentVariables = {};
+    for (const [name, definition] of Object.entries(schema)) {
+      const value = process.env[name] ?? definition.defaultValue?.toString();
+      _Kernel.assertRequiredEnvironmentVariable(name, value, schema);
+      if (value !== void 0) {
+        environmentVariables[name] = _Kernel.parseEnvironmentVariable(
+          name,
+          value,
+          schema
+        );
+      }
+    }
+    return {
+      ...process.env,
+      ...environmentVariables
+    };
+  }
   static loadEnvironmentVariables(environment, options = {}) {
     const environmentName = environment ?? process.env.NODE_ENV ?? "local";
-    return dotenv.config({
+    const result = dotenv.config({
       override: options.override,
       path: _Kernel.getEnvironmentVariablesPath(environmentName, options)
     });
+    if (options.schema) {
+      _Kernel.validateEnvironmentVariables(options.schema);
+    }
+    return result;
   }
   async closeCandidate(candidate) {
     if (candidate.shutdown) {
@@ -386,7 +459,7 @@ var Kernel = class _Kernel {
     return this.dependencyInjectionInstance;
   }
   get environment() {
-    return _Kernel.environment;
+    return this.environmentVariables;
   }
   get logger() {
     return this.loggerInstance;
@@ -414,7 +487,12 @@ var Kernel = class _Kernel {
     _Kernel.state.activeKernel = this;
   }
   loadEnvironmentVariables(environment, options = {}) {
-    return _Kernel.loadEnvironmentVariables(environment, options);
+    const result = _Kernel.loadEnvironmentVariables(environment, {
+      ...options,
+      schema: options.schema ?? this.options.environmentSchema
+    });
+    this.environmentVariables = this.options.environmentSchema ? _Kernel.validateEnvironmentVariables(this.options.environmentSchema) : process.env;
+    return result;
   }
   getRoutes() {
     return this.routes;

package/dist/adapters/ui/routes/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/Kernel.ts","../../../../src/adapters/kernel/console/ConsoleKernelLogger.ts","../../../../src/infrastructure/dependency-injection/DependencyInjection.ts","../../../../src/adapters/ui/routes/Route.ts"],"sourcesContent":["import dotenv, { type DotenvConfigOutput } from 'dotenv';\nimport path from 'node:path';\n\nimport type { Consumer } from './adapters/pubsub/index.js';\nimport type { Route } from './adapters/ui/routes/index.js';\nimport type {\n  ConsumerMiddleware,\n  KernelLogger,\n  ShutdownHook,\n} from './contracts/index.js';\nimport type { ServiceClass } from './infrastructure/dependency-injection/index.js';\nimport type { Initializer, Runtime } from './infrastructure/lifecycle/index.js';\nimport type { Scheduler } from './infrastructure/scheduler/index.js';\nimport type { KernelDependencyInjectionOptions } from './kernel/KernelDependencyInjectionOptions.js';\nimport type { KernelEnvironmentVariablesOptions } from './kernel/KernelEnvironmentVariablesOptions.js';\nimport type { KernelOptions } from './kernel/KernelOptions.js';\nimport type { ShutdownCandidate } from './kernel/ShutdownCandidate.js';\n\nimport { ConsoleKernelLogger } from './adapters/kernel/index.js';\nimport { DependencyInjection } from './infrastructure/dependency-injection/index.js';\n\nexport type { KernelDependencyInjectionOptions } from './kernel/KernelDependencyInjectionOptions.js';\nexport type { KernelEnvironmentVariablesOptions } from './kernel/KernelEnvironmentVariablesOptions.js';\nexport type { KernelOptions } from './kernel/KernelOptions.js';\n\nexport class Kernel {\n  private static readonly stateKey = Symbol.for(\n    '@haskou/ddd-kernel/kernel-state',\n  );\n\n  private readonly consumerMiddlewares: ConsumerMiddleware[] = [];\n  private readonly consumersList: Consumer[] = [];\n  private readonly loggerInstance: KernelLogger;\n  private readonly routesList: ServiceClass<Route>[] = [];\n  private readonly schedulersList: Scheduler[] = [];\n  private readonly shutdownHooks: ShutdownHook[] = [];\n  private dependencyInjectionInstance: DependencyInjection | undefined;\n\n  private static get state(): { activeKernel?: Kernel } {\n    const stateContainer = globalThis as typeof globalThis & {\n      [Kernel.stateKey]?: { activeKernel?: Kernel };\n    };\n\n    stateContainer[Kernel.stateKey] = stateContainer[Kernel.stateKey] ?? {};\n\n    return stateContainer[Kernel.stateKey] as { activeKernel?: Kernel };\n  }\n\n  public static get configDirectory(): string {\n    return path.resolve(Kernel.rootDirectory, 'config');\n  }\n\n  public static get consumers(): Consumer[] {\n    return Kernel.getActiveKernel().consumers;\n  }\n\n  public static get consumerMiddleware(): ConsumerMiddleware[] {\n    return Kernel.getActiveKernel().consumerMiddleware;\n  }\n\n  public static get di(): DependencyInjection {\n    return Kernel.getActiveKernel().di;\n  }\n\n  public static get environment(): NodeJS.ProcessEnv {\n    return process.env;\n  }\n\n  public static get logger(): KernelLogger {\n    return Kernel.getActiveKernel().logger;\n  }\n\n  public static get active(): Kernel {\n    return Kernel.getActiveKernel();\n  }\n\n  public static get rootDirectory(): string {\n    return process.cwd();\n  }\n\n  public static get routes(): ServiceClass<Route>[] {\n    return Kernel.getActiveKernel().routes;\n  }\n\n  public static get schedulers(): Scheduler[] {\n    return Kernel.getActiveKernel().schedulers;\n  }\n\n  public static get sourceDirectory(): string {\n    return path.resolve(Kernel.rootDirectory, 'src');\n  }\n\n  private static getActiveKernel(): Kernel {\n    if (!Kernel.state.activeKernel) {\n      Kernel.state.activeKernel = new Kernel();\n    }\n\n    return Kernel.state.activeKernel;\n  }\n\n  private static getEnvironmentVariablesPath(\n    environment: string,\n    options: KernelEnvironmentVariablesOptions,\n  ): string {\n    return path.resolve(\n      Kernel.rootDirectory,\n      options.path ?? (environment ? `.env.${environment}` : '.env'),\n    );\n  }\n\n  public static loadEnvironmentVariables(\n    environment?: string,\n    options: KernelEnvironmentVariablesOptions = {},\n  ): DotenvConfigOutput {\n    const environmentName = environment ?? process.env.NODE_ENV ?? 'local';\n\n    return dotenv.config({\n      override: options.override,\n      path: Kernel.getEnvironmentVariablesPath(environmentName, options),\n    });\n  }\n\n  constructor(private readonly options: KernelOptions = {}) {\n    this.loggerInstance = options.logger ?? new ConsoleKernelLogger();\n    this.dependencyInjectionInstance = options.di;\n    Kernel.state.activeKernel = this;\n  }\n\n  private async closeCandidate(candidate: ShutdownCandidate): Promise<void> {\n    if (candidate.shutdown) {\n      await candidate.shutdown();\n\n      return;\n    }\n\n    if (candidate.close) {\n      await candidate.close();\n\n      return;\n    }\n\n    if (candidate.stop) {\n      await candidate.stop();\n\n      return;\n    }\n\n    if (candidate.flush) {\n      await candidate.flush();\n    }\n  }\n\n  private getConsumerFromClass(\n    ClassDefinition: ServiceClass<Consumer>,\n  ): Consumer {\n    return this.di.getService<Consumer>(ClassDefinition);\n  }\n\n  private getInitializerFromClass(\n    ClassDefinition: ServiceClass<Initializer>,\n  ): Initializer {\n    return this.di.getService<Initializer>(ClassDefinition);\n  }\n\n  private getRuntimeFromClass(ClassDefinition: ServiceClass<Runtime>): Runtime {\n    return this.di.getService<Runtime>(ClassDefinition);\n  }\n\n  private getSchedulerFromClass(\n    ClassDefinition: ServiceClass<Scheduler>,\n  ): Scheduler {\n    return this.di.getService<Scheduler>(ClassDefinition);\n  }\n\n  public get consumers(): Consumer[] {\n    return this.consumersList;\n  }\n\n  public get consumerMiddleware(): ConsumerMiddleware[] {\n    return this.consumerMiddlewares;\n  }\n\n  public get di(): DependencyInjection {\n    if (!this.dependencyInjectionInstance) {\n      throw new Error('Kernel dependency injection has not been initialized.');\n    }\n\n    return this.dependencyInjectionInstance;\n  }\n\n  public get environment(): NodeJS.ProcessEnv {\n    return Kernel.environment;\n  }\n\n  public get logger(): KernelLogger {\n    return this.loggerInstance;\n  }\n\n  public get routes(): ServiceClass<Route>[] {\n    return this.routesList;\n  }\n\n  public get schedulers(): Scheduler[] {\n    return this.schedulersList;\n  }\n\n  private getDependencyInjectionOptions(\n    options: KernelDependencyInjectionOptions = {},\n  ): Required<KernelDependencyInjectionOptions> {\n    return {\n      containerBuild:\n        options.containerBuild ?? process.env.CONTAINER_BUILD === 'true',\n      overrides: options.overrides ?? [],\n      servicesYamlPath:\n        options.servicesYamlPath ??\n        this.options.servicesYamlPath ??\n        path.resolve(Kernel.configDirectory, 'container', 'services.yaml'),\n      sourceDirectory:\n        options.sourceDirectory ??\n        this.options.sourceDirectory ??\n        Kernel.sourceDirectory,\n    };\n  }\n\n  public async dependencyInjection(\n    options: KernelDependencyInjectionOptions = {},\n  ): Promise<void> {\n    Kernel.state.activeKernel = this;\n    this.dependencyInjectionInstance =\n      this.dependencyInjectionInstance ??\n      DependencyInjection.configure(\n        this.getDependencyInjectionOptions(options),\n      );\n\n    await this.dependencyInjectionInstance.compile();\n    Kernel.state.activeKernel = this;\n  }\n\n  public loadEnvironmentVariables(\n    environment?: string,\n    options: KernelEnvironmentVariablesOptions = {},\n  ): DotenvConfigOutput {\n    return Kernel.loadEnvironmentVariables(environment, options);\n  }\n\n  public getRoutes(): ServiceClass<Route>[] {\n    return this.routes;\n  }\n\n  public registerConsumerMiddleware(\n    ...middlewares: ConsumerMiddleware[]\n  ): void {\n    this.consumerMiddlewares.push(...middlewares);\n  }\n\n  public registerConsumers(\n    ...ClassDefinitions: ServiceClass<Consumer>[]\n  ): void {\n    for (const ClassDefinition of ClassDefinitions) {\n      this.consumersList.push(this.getConsumerFromClass(ClassDefinition));\n    }\n  }\n\n  public registerConsumerInstances(...consumers: Consumer[]): void {\n    this.consumersList.push(...consumers);\n  }\n\n  public registerRoutes(...ClassDefinitions: ServiceClass<Route>[]): void {\n    this.routesList.push(...ClassDefinitions);\n  }\n\n  public registerSchedulers(\n    ...ClassDefinitions: ServiceClass<Scheduler>[]\n  ): void {\n    for (const ClassDefinition of ClassDefinitions) {\n      this.schedulersList.push(this.getSchedulerFromClass(ClassDefinition));\n    }\n  }\n\n  public registerSchedulerInstances(...schedulers: Scheduler[]): void {\n    this.schedulersList.push(...schedulers);\n  }\n\n  public registerShutdownHook(hook: ShutdownHook): void {\n    this.shutdownHooks.push(hook);\n  }\n\n  public removeConsumers(): void {\n    this.consumersList.length = 0;\n  }\n\n  public removeRoutes(): void {\n    this.routesList.length = 0;\n  }\n\n  public removeSchedulers(): void {\n    this.schedulersList.length = 0;\n  }\n\n  public async runConsumers(): Promise<void> {\n    for (const consumer of this.consumersList) {\n      await consumer.init();\n    }\n  }\n\n  public async runInitializers(\n    ...ClassDefinitions: ServiceClass<Initializer>[]\n  ): Promise<void> {\n    for (const ClassDefinition of ClassDefinitions) {\n      await this.getInitializerFromClass(ClassDefinition).ensure();\n    }\n  }\n\n  public async runRuntimes(\n    ...ClassDefinitions: ServiceClass<Runtime>[]\n  ): Promise<void> {\n    for (const ClassDefinition of ClassDefinitions) {\n      const runtime = this.getRuntimeFromClass(ClassDefinition);\n\n      await runtime.run();\n      this.registerShutdownHook(() =>\n        this.closeCandidate(runtime as ShutdownCandidate),\n      );\n    }\n  }\n\n  public async runSchedulerNowAndSchedule(\n    ClassDefinition: ServiceClass<Scheduler>,\n  ): Promise<void> {\n    const scheduler = this.getSchedulerFromClass(ClassDefinition);\n\n    await scheduler.runOnce();\n    await scheduler.init();\n    this.schedulersList.push(scheduler);\n  }\n\n  public async runSchedulers(): Promise<void> {\n    for (const scheduler of this.schedulersList) {\n      await scheduler.init();\n    }\n  }\n\n  public async shutdown(): Promise<void> {\n    for (const consumer of [...this.consumersList].reverse()) {\n      await this.closeCandidate(consumer as ShutdownCandidate);\n    }\n\n    for (const scheduler of [...this.schedulersList].reverse()) {\n      await this.closeCandidate(scheduler as ShutdownCandidate);\n    }\n\n    for (const hook of [...this.shutdownHooks].reverse()) {\n      await hook();\n    }\n\n    await this.closeCandidate(this.loggerInstance as ShutdownCandidate);\n  }\n}\n\nexport function createKernel(options?: KernelOptions): Kernel {\n  return new Kernel(options);\n}\n\nexport default Kernel;\n","import type { KernelLogger } from '../../../contracts/index.js';\n\nexport class ConsoleKernelLogger implements KernelLogger {\n  public debug(message: string): void {\n    // eslint-disable-next-line no-console\n    console.debug(message);\n  }\n\n  public error(message: string): void {\n    // eslint-disable-next-line no-console\n    console.error(message);\n  }\n\n  public info(message: string): void {\n    // eslint-disable-next-line no-console\n    console.info(message);\n  }\n\n  public warn(message: string): void {\n    // eslint-disable-next-line no-console\n    console.warn(message);\n  }\n}\n","import fs from 'fs-extra';\nimport {\n  Autowire,\n  ContainerBuilder,\n  ServiceFile,\n  YamlFileLoader,\n} from 'node-dependency-injection';\nimport path from 'node:path';\n\nimport type { ServiceResolver } from '../../contracts/index.js';\nimport type { ContainerInternals } from './ContainerInternals.js';\nimport type { DefinitionMetadata } from './DefinitionMetadata.js';\nimport type { DependencyInjectionOptions } from './DependencyInjectionOptions.js';\nimport type { DependencyOverride } from './DependencyOverride.js';\n\nexport class DependencyInjection implements ServiceResolver {\n  private static configuredInstance: DependencyInjection | undefined;\n  private autowire: Autowire | undefined;\n  private loader: YamlFileLoader | undefined;\n  private readonly container: ContainerBuilder;\n  private readonly overrideTokenIds = new Map<unknown, string>();\n\n  public static configure(\n    options: DependencyInjectionOptions,\n  ): DependencyInjection {\n    DependencyInjection.configuredInstance = new DependencyInjection(options);\n\n    return DependencyInjection.configuredInstance;\n  }\n\n  public static get instance(): DependencyInjection {\n    if (!DependencyInjection.configuredInstance) {\n      throw new Error('DependencyInjection has not been configured.');\n    }\n\n    return DependencyInjection.configuredInstance;\n  }\n\n  constructor(\n    private readonly options: DependencyInjectionOptions = {\n      containerBuild: process.env.CONTAINER_BUILD === 'true',\n      servicesYamlPath: path.resolve(\n        process.cwd(),\n        'config',\n        'container',\n        'services.yaml',\n      ),\n      sourceDirectory: path.resolve(process.cwd(), 'src'),\n    },\n  ) {\n    this.container = new ContainerBuilder(false, this.options.sourceDirectory);\n  }\n\n  private get definitions(): Map<string, DefinitionMetadata> {\n    const container = this.container as unknown as ContainerInternals;\n\n    return container._definitions || new Map();\n  }\n\n  private get aliases(): Map<string, string> {\n    const container = this.container as unknown as ContainerInternals;\n\n    return container._alias || new Map();\n  }\n\n  private async ensureFolderExists(filePath: string): Promise<void> {\n    await fs.mkdir(path.dirname(filePath), { recursive: true });\n  }\n\n  private getServiceClassName(serviceName: unknown): string | undefined {\n    return typeof serviceName === 'function' ? serviceName.name : undefined;\n  }\n\n  private getOverrideId(prefix: string, token: unknown): string {\n    const tokenName = this.getServiceClassName(token) ?? String(token);\n\n    return `ddd-kernel.override.${prefix}.${tokenName}`;\n  }\n\n  private ensureSyntheticService(id: string, value: unknown): void {\n    const definition = this.container.register(id);\n\n    definition.public = true;\n    definition.synthetic = true;\n    this.container.set(id, value);\n  }\n\n  private parentMatchesService(\n    parentId: string | null | undefined,\n    serviceClassName: string,\n  ): boolean {\n    if (!parentId) {\n      return false;\n    }\n\n    const parentName = Buffer.from(parentId, 'base64').toString('utf8');\n\n    return parentName.endsWith(`__${serviceClassName}__${serviceClassName}`);\n  }\n\n  private serviceIdMatchesService(\n    serviceId: string,\n    serviceClassName: string,\n  ): boolean {\n    const serviceName = Buffer.from(serviceId, 'base64').toString('utf8');\n\n    return serviceName.endsWith(`__${serviceClassName}__${serviceClassName}`);\n  }\n\n  private serviceIdReferencesService(\n    serviceId: string,\n    serviceClassName: string,\n  ): boolean {\n    const serviceName = Buffer.from(serviceId, 'base64').toString('utf8');\n\n    return serviceName.endsWith(`__${serviceClassName}`);\n  }\n\n  private getReferenceId(value: unknown): string | undefined {\n    if (\n      typeof value === 'object' &&\n      value !== null &&\n      'id' in value &&\n      typeof value.id === 'string'\n    ) {\n      return value.id;\n    }\n\n    return undefined;\n  }\n\n  private getDefinitionArgumentReferences(\n    definition: DefinitionMetadata,\n  ): string[] {\n    return [\n      ...(definition._args ?? []),\n      ...(definition._appendArgs ?? []),\n      ...(definition._overrideArgs ?? []),\n    ].flatMap((argument) => {\n      const referenceId = this.getReferenceId(argument);\n\n      return referenceId ? [referenceId] : [];\n    });\n  }\n\n  private findConcreteChildServiceId(serviceName: unknown): string | undefined {\n    const serviceClassName = this.getServiceClassName(serviceName);\n\n    if (!serviceClassName) {\n      return undefined;\n    }\n\n    const matches = [...this.definitions.entries()]\n      .filter(([, definition]) => definition._abstract !== true)\n      .filter(([, definition]) =>\n        this.parentMatchesService(definition._parent, serviceClassName),\n      )\n      .map(([id]) => id);\n\n    return matches[matches.length - 1];\n  }\n\n  private findRegisteredServiceId(serviceName: unknown): string | undefined {\n    const serviceClassName = this.getServiceClassName(serviceName);\n\n    if (!serviceClassName) {\n      return undefined;\n    }\n\n    const matches = [...this.definitions.keys()].filter((id) =>\n      this.serviceIdMatchesService(id, serviceClassName),\n    );\n\n    return matches[matches.length - 1];\n  }\n\n  private findAliasServiceId(serviceName: unknown): string | undefined {\n    const serviceClassName = this.getServiceClassName(serviceName);\n\n    if (!serviceClassName) {\n      return undefined;\n    }\n\n    const matches = [...this.aliases.keys()].filter((id) =>\n      this.serviceIdMatchesService(id, serviceClassName),\n    );\n\n    return matches[matches.length - 1];\n  }\n\n  private findReferencedServiceIds(serviceName: unknown): string[] {\n    const serviceClassName = this.getServiceClassName(serviceName);\n\n    if (!serviceClassName) {\n      return [];\n    }\n\n    return [\n      ...new Set(\n        [...this.definitions.values()]\n          .flatMap((definition) =>\n            this.getDefinitionArgumentReferences(definition),\n          )\n          .filter((id) =>\n            this.serviceIdReferencesService(id, serviceClassName),\n          ),\n      ),\n    ];\n  }\n\n  private getOverrideTokenIds(token: unknown): string[] {\n    const tokenIds = [\n      this.findRegisteredServiceId(token),\n      this.findAliasServiceId(token),\n      ...this.findReferencedServiceIds(token),\n    ].filter((id): id is string => id !== undefined);\n    const existingTokenIds = [...new Set(tokenIds)];\n\n    if (existingTokenIds.length > 0) {\n      return existingTokenIds;\n    }\n\n    const overrideTokenId = this.getOverrideId('token', token);\n\n    this.ensureSyntheticService(overrideTokenId, undefined);\n\n    return [overrideTokenId];\n  }\n\n  private getOverrideClassServiceId(\n    ClassDefinition: new () => unknown,\n  ): string {\n    const registeredServiceId = this.findRegisteredServiceId(ClassDefinition);\n\n    if (registeredServiceId) {\n      return registeredServiceId;\n    }\n\n    const overrideClassId = this.getOverrideId('class', ClassDefinition);\n\n    this.container.register(overrideClassId, ClassDefinition);\n\n    return overrideClassId;\n  }\n\n  private applyClassOverride(override: DependencyOverride): void {\n    if (!('useClass' in override)) {\n      return;\n    }\n\n    const tokenIds = this.getOverrideTokenIds(override.token);\n    const classId = this.getOverrideClassServiceId(override.useClass);\n\n    this.overrideTokenIds.set(override.token, tokenIds[0]);\n    for (const tokenId of tokenIds) {\n      this.container.setAlias(tokenId, classId);\n    }\n  }\n\n  private applyFactoryOverride(override: DependencyOverride): void {\n    if (!('useFactory' in override)) {\n      return;\n    }\n\n    const tokenIds = this.getOverrideTokenIds(override.token);\n    const factoryId = this.getOverrideId('factory', override.token);\n\n    this.ensureSyntheticService(factoryId, override.useFactory(this));\n    this.overrideTokenIds.set(override.token, tokenIds[0]);\n    for (const tokenId of tokenIds) {\n      this.container.setAlias(tokenId, factoryId);\n    }\n  }\n\n  private applyValueOverride(override: DependencyOverride): void {\n    if (!('useValue' in override)) {\n      return;\n    }\n\n    const tokenIds = this.getOverrideTokenIds(override.token);\n    const valueId = this.getOverrideId('value', override.token);\n\n    this.ensureSyntheticService(valueId, override.useValue);\n    this.overrideTokenIds.set(override.token, tokenIds[0]);\n    for (const tokenId of tokenIds) {\n      this.container.setAlias(tokenId, valueId);\n    }\n  }\n\n  private applyOverrides(): void {\n    for (const override of this.options.overrides ?? []) {\n      this.applyClassOverride(override);\n      this.applyFactoryOverride(override);\n      this.applyValueOverride(override);\n    }\n  }\n\n  private registerParentAliases(): void {\n    for (const [id, definition] of this.definitions.entries()) {\n      if (definition._abstract === true || !definition._parent) {\n        continue;\n      }\n\n      this.container.setAlias(definition._parent, id);\n    }\n  }\n\n  public async compile(): Promise<void> {\n    if (this.options.containerBuild) {\n      await this.ensureFolderExists(this.options.servicesYamlPath);\n      this.autowire = new Autowire(this.container);\n      this.autowire.serviceFile = new ServiceFile(\n        this.options.servicesYamlPath,\n        false,\n      );\n      await this.autowire.process();\n    } else {\n      this.loader = new YamlFileLoader(this.container);\n      await this.loader.load(this.options.servicesYamlPath);\n    }\n\n    this.registerParentAliases();\n    this.applyOverrides();\n    await this.container.compile();\n  }\n\n  public getService<T>(serviceName: unknown): T {\n    const overrideTokenId = this.overrideTokenIds.get(serviceName);\n\n    if (overrideTokenId) {\n      return this.container.get<T>(overrideTokenId);\n    }\n\n    const aliasServiceId = this.findAliasServiceId(serviceName);\n\n    if (aliasServiceId) {\n      return this.container.get<T>(aliasServiceId);\n    }\n\n    const childServiceId = this.findConcreteChildServiceId(serviceName);\n\n    if (childServiceId) {\n      return this.container.get<T>(childServiceId);\n    }\n\n    const registeredServiceId = this.findRegisteredServiceId(serviceName);\n\n    if (registeredServiceId) {\n      return this.container.get<T>(registeredServiceId);\n    }\n\n    return this.container.get<T>(serviceName);\n  }\n}\n\nexport default DependencyInjection;\n","import { Kernel } from '../../../Kernel.js';\n\nexport abstract class Route {\n  public get<T>(service: unknown): T {\n    return Kernel.di.getService<T>(service);\n  }\n}\n\nexport default Route;\n"],"mappings":"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","names":["path","path"]}
+{"version":3,"sources":["../../../../src/Kernel.ts","../../../../src/adapters/kernel/console/ConsoleKernelLogger.ts","../../../../src/infrastructure/dependency-injection/DependencyInjection.ts","../../../../src/kernel/KernelEnvironmentValidationError.ts","../../../../src/adapters/ui/routes/Route.ts"],"sourcesContent":["import dotenv, { type DotenvConfigOutput } from 'dotenv';\nimport path from 'node:path';\n\nimport type { Consumer } from './adapters/pubsub/index.js';\nimport type { Route } from './adapters/ui/routes/index.js';\nimport type {\n  ConsumerMiddleware,\n  KernelLogger,\n  ShutdownHook,\n} from './contracts/index.js';\nimport type { ServiceClass } from './infrastructure/dependency-injection/index.js';\nimport type { Initializer, Runtime } from './infrastructure/lifecycle/index.js';\nimport type { Scheduler } from './infrastructure/scheduler/index.js';\nimport type { KernelDependencyInjectionOptions } from './kernel/KernelDependencyInjectionOptions.js';\nimport type { KernelEnvironmentForSchema } from './kernel/KernelEnvironmentForSchema.js';\nimport type { KernelEnvironmentSchema } from './kernel/KernelEnvironmentSchema.js';\nimport type { KernelEnvironmentValue } from './kernel/KernelEnvironmentValue.js';\nimport type { KernelEnvironmentVariablesOptions } from './kernel/KernelEnvironmentVariablesOptions.js';\nimport type { KernelOptions } from './kernel/KernelOptions.js';\nimport type { ShutdownCandidate } from './kernel/ShutdownCandidate.js';\n\nimport { ConsoleKernelLogger } from './adapters/kernel/index.js';\nimport { DependencyInjection } from './infrastructure/dependency-injection/index.js';\nimport { KernelEnvironmentValidationError } from './kernel/KernelEnvironmentValidationError.js';\n\nexport type { KernelDependencyInjectionOptions } from './kernel/KernelDependencyInjectionOptions.js';\nexport type { KernelDefaultEnvironment } from './kernel/KernelDefaultEnvironment.js';\nexport type { KernelEnvironment } from './kernel/KernelEnvironment.js';\nexport type { KernelEnvironmentForSchema } from './kernel/KernelEnvironmentForSchema.js';\nexport type { KernelEnvironmentSchema } from './kernel/KernelEnvironmentSchema.js';\nexport type { KernelEnvironmentValue } from './kernel/KernelEnvironmentValue.js';\nexport type { KernelEnvironmentVariableDefinition } from './kernel/KernelEnvironmentVariableDefinition.js';\nexport type { KernelEnvironmentVariablePrimitive } from './kernel/KernelEnvironmentVariablePrimitive.js';\nexport type { KernelEnvironmentVariableType } from './kernel/KernelEnvironmentVariableType.js';\nexport type { KernelEnvironmentVariablesOptions } from './kernel/KernelEnvironmentVariablesOptions.js';\nexport type { KernelOptions } from './kernel/KernelOptions.js';\nexport { KernelEnvironmentValidationError } from './kernel/KernelEnvironmentValidationError.js';\n\nexport class Kernel<\n  TEnvironmentSchema extends KernelEnvironmentSchema | undefined = undefined,\n> {\n  private static readonly stateKey = Symbol.for(\n    '@haskou/ddd-kernel/kernel-state',\n  );\n\n  private readonly consumerMiddlewares: ConsumerMiddleware[] = [];\n  private readonly consumersList: Consumer[] = [];\n  private readonly loggerInstance: KernelLogger;\n  private readonly routesList: ServiceClass<Route>[] = [];\n  private readonly schedulersList: Scheduler[] = [];\n  private readonly shutdownHooks: ShutdownHook[] = [];\n  private dependencyInjectionInstance: DependencyInjection | undefined;\n  private environmentVariables =\n    process.env as KernelEnvironmentForSchema<TEnvironmentSchema>;\n\n  private static get state(): {\n    activeKernel?: Kernel<KernelEnvironmentSchema | undefined>;\n  } {\n    const stateContainer = globalThis as typeof globalThis & {\n      [Kernel.stateKey]?: {\n        activeKernel?: Kernel<KernelEnvironmentSchema | undefined>;\n      };\n    };\n\n    stateContainer[Kernel.stateKey] = stateContainer[Kernel.stateKey] ?? {};\n\n    return stateContainer[Kernel.stateKey] as {\n      activeKernel?: Kernel<KernelEnvironmentSchema | undefined>;\n    };\n  }\n\n  public static get configDirectory(): string {\n    return path.resolve(Kernel.rootDirectory, 'config');\n  }\n\n  public static get consumers(): Consumer[] {\n    return Kernel.getActiveKernel().consumers;\n  }\n\n  public static get consumerMiddleware(): ConsumerMiddleware[] {\n    return Kernel.getActiveKernel().consumerMiddleware;\n  }\n\n  public static get di(): DependencyInjection {\n    return Kernel.getActiveKernel().di;\n  }\n\n  public static get environment(): NodeJS.ProcessEnv {\n    return process.env;\n  }\n\n  public static get logger(): KernelLogger {\n    return Kernel.getActiveKernel().logger;\n  }\n\n  public static get active(): Kernel<KernelEnvironmentSchema | undefined> {\n    return Kernel.getActiveKernel();\n  }\n\n  public static get rootDirectory(): string {\n    return process.cwd();\n  }\n\n  public static get routes(): ServiceClass<Route>[] {\n    return Kernel.getActiveKernel().routes;\n  }\n\n  public static get schedulers(): Scheduler[] {\n    return Kernel.getActiveKernel().schedulers;\n  }\n\n  public static get sourceDirectory(): string {\n    return path.resolve(Kernel.rootDirectory, 'src');\n  }\n\n  private static getActiveKernel(): Kernel<\n    KernelEnvironmentSchema | undefined\n  > {\n    if (!Kernel.state.activeKernel) {\n      Kernel.state.activeKernel = new Kernel();\n    }\n\n    return Kernel.state.activeKernel;\n  }\n\n  private static assertRequiredEnvironmentVariable(\n    name: string,\n    value: string | undefined,\n    schema: KernelEnvironmentSchema,\n  ): void {\n    if (schema[name]?.required === true && value === undefined) {\n      throw new KernelEnvironmentValidationError(\n        `Missing required environment variable \"${name}\".`,\n      );\n    }\n  }\n\n  private static getEnvironmentVariablesPath(\n    environment: string,\n    options: KernelEnvironmentVariablesOptions<\n      KernelEnvironmentSchema | undefined\n    >,\n  ): string {\n    return path.resolve(\n      Kernel.rootDirectory,\n      options.path ?? (environment ? `.env.${environment}` : '.env'),\n    );\n  }\n\n  private static parseBooleanEnvironmentVariable(\n    name: string,\n    value: string,\n  ): boolean {\n    if (['1', 'true', 'yes', 'on'].includes(value.toLowerCase())) {\n      return true;\n    }\n\n    if (['0', 'false', 'no', 'off'].includes(value.toLowerCase())) {\n      return false;\n    }\n\n    throw new KernelEnvironmentValidationError(\n      `Environment variable \"${name}\" must be a boolean.`,\n    );\n  }\n\n  private static parseNumberEnvironmentVariable(\n    name: string,\n    value: string,\n  ): number {\n    if (value.trim() === '') {\n      throw new KernelEnvironmentValidationError(\n        `Environment variable \"${name}\" must be a number.`,\n      );\n    }\n\n    const parsedValue = Number(value);\n\n    if (Number.isFinite(parsedValue)) {\n      return parsedValue;\n    }\n\n    throw new KernelEnvironmentValidationError(\n      `Environment variable \"${name}\" must be a number.`,\n    );\n  }\n\n  private static parseEnvironmentVariable(\n    name: string,\n    value: string,\n    schema: KernelEnvironmentSchema,\n  ): KernelEnvironmentValue {\n    const definition = schema[name];\n\n    if (definition.type === 'boolean') {\n      return Kernel.parseBooleanEnvironmentVariable(name, value);\n    }\n\n    if (definition.type === 'number') {\n      return Kernel.parseNumberEnvironmentVariable(name, value);\n    }\n\n    return value;\n  }\n\n  private static validateEnvironmentVariables<\n    TSchema extends KernelEnvironmentSchema,\n  >(schema: TSchema): KernelEnvironmentForSchema<TSchema> {\n    const environmentVariables: Record<string, KernelEnvironmentValue> = {};\n\n    for (const [name, definition] of Object.entries(schema)) {\n      const value = process.env[name] ?? definition.defaultValue?.toString();\n\n      Kernel.assertRequiredEnvironmentVariable(name, value, schema);\n\n      if (value !== undefined) {\n        environmentVariables[name] = Kernel.parseEnvironmentVariable(\n          name,\n          value,\n          schema,\n        );\n      }\n    }\n\n    return {\n      ...process.env,\n      ...environmentVariables,\n    } as KernelEnvironmentForSchema<TSchema>;\n  }\n\n  public static loadEnvironmentVariables(\n    environment?: string,\n    options: KernelEnvironmentVariablesOptions<\n      KernelEnvironmentSchema | undefined\n    > = {},\n  ): DotenvConfigOutput {\n    const environmentName = environment ?? process.env.NODE_ENV ?? 'local';\n\n    const result = dotenv.config({\n      override: options.override,\n      path: Kernel.getEnvironmentVariablesPath(environmentName, options),\n    });\n\n    if (options.schema) {\n      Kernel.validateEnvironmentVariables(options.schema);\n    }\n\n    return result;\n  }\n\n  constructor(\n    private readonly options: KernelOptions<TEnvironmentSchema> = {},\n  ) {\n    this.loggerInstance = options.logger ?? new ConsoleKernelLogger();\n    this.dependencyInjectionInstance = options.di;\n    Kernel.state.activeKernel = this;\n  }\n\n  private async closeCandidate(candidate: ShutdownCandidate): Promise<void> {\n    if (candidate.shutdown) {\n      await candidate.shutdown();\n\n      return;\n    }\n\n    if (candidate.close) {\n      await candidate.close();\n\n      return;\n    }\n\n    if (candidate.stop) {\n      await candidate.stop();\n\n      return;\n    }\n\n    if (candidate.flush) {\n      await candidate.flush();\n    }\n  }\n\n  private getConsumerFromClass(\n    ClassDefinition: ServiceClass<Consumer>,\n  ): Consumer {\n    return this.di.getService<Consumer>(ClassDefinition);\n  }\n\n  private getInitializerFromClass(\n    ClassDefinition: ServiceClass<Initializer>,\n  ): Initializer {\n    return this.di.getService<Initializer>(ClassDefinition);\n  }\n\n  private getRuntimeFromClass(ClassDefinition: ServiceClass<Runtime>): Runtime {\n    return this.di.getService<Runtime>(ClassDefinition);\n  }\n\n  private getSchedulerFromClass(\n    ClassDefinition: ServiceClass<Scheduler>,\n  ): Scheduler {\n    return this.di.getService<Scheduler>(ClassDefinition);\n  }\n\n  public get consumers(): Consumer[] {\n    return this.consumersList;\n  }\n\n  public get consumerMiddleware(): ConsumerMiddleware[] {\n    return this.consumerMiddlewares;\n  }\n\n  public get di(): DependencyInjection {\n    if (!this.dependencyInjectionInstance) {\n      throw new Error('Kernel dependency injection has not been initialized.');\n    }\n\n    return this.dependencyInjectionInstance;\n  }\n\n  public get environment(): KernelEnvironmentForSchema<TEnvironmentSchema> {\n    return this.environmentVariables;\n  }\n\n  public get logger(): KernelLogger {\n    return this.loggerInstance;\n  }\n\n  public get routes(): ServiceClass<Route>[] {\n    return this.routesList;\n  }\n\n  public get schedulers(): Scheduler[] {\n    return this.schedulersList;\n  }\n\n  private getDependencyInjectionOptions(\n    options: KernelDependencyInjectionOptions = {},\n  ): Required<KernelDependencyInjectionOptions> {\n    return {\n      containerBuild:\n        options.containerBuild ?? process.env.CONTAINER_BUILD === 'true',\n      overrides: options.overrides ?? [],\n      servicesYamlPath:\n        options.servicesYamlPath ??\n        this.options.servicesYamlPath ??\n        path.resolve(Kernel.configDirectory, 'container', 'services.yaml'),\n      sourceDirectory:\n        options.sourceDirectory ??\n        this.options.sourceDirectory ??\n        Kernel.sourceDirectory,\n    };\n  }\n\n  public async dependencyInjection(\n    options: KernelDependencyInjectionOptions = {},\n  ): Promise<void> {\n    Kernel.state.activeKernel = this;\n    this.dependencyInjectionInstance =\n      this.dependencyInjectionInstance ??\n      DependencyInjection.configure(\n        this.getDependencyInjectionOptions(options),\n      );\n\n    await this.dependencyInjectionInstance.compile();\n    Kernel.state.activeKernel = this;\n  }\n\n  public loadEnvironmentVariables(\n    environment?: string,\n    options: KernelEnvironmentVariablesOptions<\n      KernelEnvironmentSchema | undefined\n    > = {},\n  ): DotenvConfigOutput {\n    const result = Kernel.loadEnvironmentVariables(environment, {\n      ...options,\n      schema: options.schema ?? this.options.environmentSchema,\n    });\n\n    this.environmentVariables = this.options.environmentSchema\n      ? Kernel.validateEnvironmentVariables(this.options.environmentSchema)\n      : (process.env as KernelEnvironmentForSchema<TEnvironmentSchema>);\n\n    return result;\n  }\n\n  public getRoutes(): ServiceClass<Route>[] {\n    return this.routes;\n  }\n\n  public registerConsumerMiddleware(\n    ...middlewares: ConsumerMiddleware[]\n  ): void {\n    this.consumerMiddlewares.push(...middlewares);\n  }\n\n  public registerConsumers(\n    ...ClassDefinitions: ServiceClass<Consumer>[]\n  ): void {\n    for (const ClassDefinition of ClassDefinitions) {\n      this.consumersList.push(this.getConsumerFromClass(ClassDefinition));\n    }\n  }\n\n  public registerConsumerInstances(...consumers: Consumer[]): void {\n    this.consumersList.push(...consumers);\n  }\n\n  public registerRoutes(...ClassDefinitions: ServiceClass<Route>[]): void {\n    this.routesList.push(...ClassDefinitions);\n  }\n\n  public registerSchedulers(\n    ...ClassDefinitions: ServiceClass<Scheduler>[]\n  ): void {\n    for (const ClassDefinition of ClassDefinitions) {\n      this.schedulersList.push(this.getSchedulerFromClass(ClassDefinition));\n    }\n  }\n\n  public registerSchedulerInstances(...schedulers: Scheduler[]): void {\n    this.schedulersList.push(...schedulers);\n  }\n\n  public registerShutdownHook(hook: ShutdownHook): void {\n    this.shutdownHooks.push(hook);\n  }\n\n  public removeConsumers(): void {\n    this.consumersList.length = 0;\n  }\n\n  public removeRoutes(): void {\n    this.routesList.length = 0;\n  }\n\n  public removeSchedulers(): void {\n    this.schedulersList.length = 0;\n  }\n\n  public async runConsumers(): Promise<void> {\n    for (const consumer of this.consumersList) {\n      await consumer.init();\n    }\n  }\n\n  public async runInitializers(\n    ...ClassDefinitions: ServiceClass<Initializer>[]\n  ): Promise<void> {\n    for (const ClassDefinition of ClassDefinitions) {\n      await this.getInitializerFromClass(ClassDefinition).ensure();\n    }\n  }\n\n  public async runRuntimes(\n    ...ClassDefinitions: ServiceClass<Runtime>[]\n  ): Promise<void> {\n    for (const ClassDefinition of ClassDefinitions) {\n      const runtime = this.getRuntimeFromClass(ClassDefinition);\n\n      await runtime.run();\n      this.registerShutdownHook(() =>\n        this.closeCandidate(runtime as ShutdownCandidate),\n      );\n    }\n  }\n\n  public async runSchedulerNowAndSchedule(\n    ClassDefinition: ServiceClass<Scheduler>,\n  ): Promise<void> {\n    const scheduler = this.getSchedulerFromClass(ClassDefinition);\n\n    await scheduler.runOnce();\n    await scheduler.init();\n    this.schedulersList.push(scheduler);\n  }\n\n  public async runSchedulers(): Promise<void> {\n    for (const scheduler of this.schedulersList) {\n      await scheduler.init();\n    }\n  }\n\n  public async shutdown(): Promise<void> {\n    for (const consumer of [...this.consumersList].reverse()) {\n      await this.closeCandidate(consumer as ShutdownCandidate);\n    }\n\n    for (const scheduler of [...this.schedulersList].reverse()) {\n      await this.closeCandidate(scheduler as ShutdownCandidate);\n    }\n\n    for (const hook of [...this.shutdownHooks].reverse()) {\n      await hook();\n    }\n\n    await this.closeCandidate(this.loggerInstance as ShutdownCandidate);\n  }\n}\n\nexport function createKernel<\n  TEnvironmentSchema extends KernelEnvironmentSchema | undefined = undefined,\n>(options?: KernelOptions<TEnvironmentSchema>): Kernel<TEnvironmentSchema> {\n  return new Kernel(options);\n}\n\nexport default Kernel;\n","import type { KernelLogger } from '../../../contracts/index.js';\n\nexport class ConsoleKernelLogger implements KernelLogger {\n  public debug(message: string): void {\n    // eslint-disable-next-line no-console\n    console.debug(message);\n  }\n\n  public error(message: string): void {\n    // eslint-disable-next-line no-console\n    console.error(message);\n  }\n\n  public info(message: string): void {\n    // eslint-disable-next-line no-console\n    console.info(message);\n  }\n\n  public warn(message: string): void {\n    // eslint-disable-next-line no-console\n    console.warn(message);\n  }\n}\n","import fs from 'fs-extra';\nimport {\n  Autowire,\n  ContainerBuilder,\n  ServiceFile,\n  YamlFileLoader,\n} from 'node-dependency-injection';\nimport path from 'node:path';\n\nimport type { ServiceResolver } from '../../contracts/index.js';\nimport type { ContainerInternals } from './ContainerInternals.js';\nimport type { DefinitionMetadata } from './DefinitionMetadata.js';\nimport type { DependencyInjectionOptions } from './DependencyInjectionOptions.js';\nimport type { DependencyOverride } from './DependencyOverride.js';\n\nexport class DependencyInjection implements ServiceResolver {\n  private static configuredInstance: DependencyInjection | undefined;\n  private autowire: Autowire | undefined;\n  private loader: YamlFileLoader | undefined;\n  private readonly container: ContainerBuilder;\n  private readonly overrideTokenIds = new Map<unknown, string>();\n\n  public static configure(\n    options: DependencyInjectionOptions,\n  ): DependencyInjection {\n    DependencyInjection.configuredInstance = new DependencyInjection(options);\n\n    return DependencyInjection.configuredInstance;\n  }\n\n  public static get instance(): DependencyInjection {\n    if (!DependencyInjection.configuredInstance) {\n      throw new Error('DependencyInjection has not been configured.');\n    }\n\n    return DependencyInjection.configuredInstance;\n  }\n\n  constructor(\n    private readonly options: DependencyInjectionOptions = {\n      containerBuild: process.env.CONTAINER_BUILD === 'true',\n      servicesYamlPath: path.resolve(\n        process.cwd(),\n        'config',\n        'container',\n        'services.yaml',\n      ),\n      sourceDirectory: path.resolve(process.cwd(), 'src'),\n    },\n  ) {\n    this.container = new ContainerBuilder(false, this.options.sourceDirectory);\n  }\n\n  private get definitions(): Map<string, DefinitionMetadata> {\n    const container = this.container as unknown as ContainerInternals;\n\n    return container._definitions || new Map();\n  }\n\n  private get aliases(): Map<string, string> {\n    const container = this.container as unknown as ContainerInternals;\n\n    return container._alias || new Map();\n  }\n\n  private async ensureFolderExists(filePath: string): Promise<void> {\n    await fs.mkdir(path.dirname(filePath), { recursive: true });\n  }\n\n  private getServiceClassName(serviceName: unknown): string | undefined {\n    return typeof serviceName === 'function' ? serviceName.name : undefined;\n  }\n\n  private getOverrideId(prefix: string, token: unknown): string {\n    const tokenName = this.getServiceClassName(token) ?? String(token);\n\n    return `ddd-kernel.override.${prefix}.${tokenName}`;\n  }\n\n  private ensureSyntheticService(id: string, value: unknown): void {\n    const definition = this.container.register(id);\n\n    definition.public = true;\n    definition.synthetic = true;\n    this.container.set(id, value);\n  }\n\n  private parentMatchesService(\n    parentId: string | null | undefined,\n    serviceClassName: string,\n  ): boolean {\n    if (!parentId) {\n      return false;\n    }\n\n    const parentName = Buffer.from(parentId, 'base64').toString('utf8');\n\n    return parentName.endsWith(`__${serviceClassName}__${serviceClassName}`);\n  }\n\n  private serviceIdMatchesService(\n    serviceId: string,\n    serviceClassName: string,\n  ): boolean {\n    const serviceName = Buffer.from(serviceId, 'base64').toString('utf8');\n\n    return serviceName.endsWith(`__${serviceClassName}__${serviceClassName}`);\n  }\n\n  private serviceIdReferencesService(\n    serviceId: string,\n    serviceClassName: string,\n  ): boolean {\n    const serviceName = Buffer.from(serviceId, 'base64').toString('utf8');\n\n    return serviceName.endsWith(`__${serviceClassName}`);\n  }\n\n  private getReferenceId(value: unknown): string | undefined {\n    if (\n      typeof value === 'object' &&\n      value !== null &&\n      'id' in value &&\n      typeof value.id === 'string'\n    ) {\n      return value.id;\n    }\n\n    return undefined;\n  }\n\n  private getDefinitionArgumentReferences(\n    definition: DefinitionMetadata,\n  ): string[] {\n    return [\n      ...(definition._args ?? []),\n      ...(definition._appendArgs ?? []),\n      ...(definition._overrideArgs ?? []),\n    ].flatMap((argument) => {\n      const referenceId = this.getReferenceId(argument);\n\n      return referenceId ? [referenceId] : [];\n    });\n  }\n\n  private findConcreteChildServiceId(serviceName: unknown): string | undefined {\n    const serviceClassName = this.getServiceClassName(serviceName);\n\n    if (!serviceClassName) {\n      return undefined;\n    }\n\n    const matches = [...this.definitions.entries()]\n      .filter(([, definition]) => definition._abstract !== true)\n      .filter(([, definition]) =>\n        this.parentMatchesService(definition._parent, serviceClassName),\n      )\n      .map(([id]) => id);\n\n    return matches[matches.length - 1];\n  }\n\n  private findRegisteredServiceId(serviceName: unknown): string | undefined {\n    const serviceClassName = this.getServiceClassName(serviceName);\n\n    if (!serviceClassName) {\n      return undefined;\n    }\n\n    const matches = [...this.definitions.keys()].filter((id) =>\n      this.serviceIdMatchesService(id, serviceClassName),\n    );\n\n    return matches[matches.length - 1];\n  }\n\n  private findAliasServiceId(serviceName: unknown): string | undefined {\n    const serviceClassName = this.getServiceClassName(serviceName);\n\n    if (!serviceClassName) {\n      return undefined;\n    }\n\n    const matches = [...this.aliases.keys()].filter((id) =>\n      this.serviceIdMatchesService(id, serviceClassName),\n    );\n\n    return matches[matches.length - 1];\n  }\n\n  private findReferencedServiceIds(serviceName: unknown): string[] {\n    const serviceClassName = this.getServiceClassName(serviceName);\n\n    if (!serviceClassName) {\n      return [];\n    }\n\n    return [\n      ...new Set(\n        [...this.definitions.values()]\n          .flatMap((definition) =>\n            this.getDefinitionArgumentReferences(definition),\n          )\n          .filter((id) =>\n            this.serviceIdReferencesService(id, serviceClassName),\n          ),\n      ),\n    ];\n  }\n\n  private getOverrideTokenIds(token: unknown): string[] {\n    const tokenIds = [\n      this.findRegisteredServiceId(token),\n      this.findAliasServiceId(token),\n      ...this.findReferencedServiceIds(token),\n    ].filter((id): id is string => id !== undefined);\n    const existingTokenIds = [...new Set(tokenIds)];\n\n    if (existingTokenIds.length > 0) {\n      return existingTokenIds;\n    }\n\n    const overrideTokenId = this.getOverrideId('token', token);\n\n    this.ensureSyntheticService(overrideTokenId, undefined);\n\n    return [overrideTokenId];\n  }\n\n  private getOverrideClassServiceId(\n    ClassDefinition: new () => unknown,\n  ): string {\n    const registeredServiceId = this.findRegisteredServiceId(ClassDefinition);\n\n    if (registeredServiceId) {\n      return registeredServiceId;\n    }\n\n    const overrideClassId = this.getOverrideId('class', ClassDefinition);\n\n    this.container.register(overrideClassId, ClassDefinition);\n\n    return overrideClassId;\n  }\n\n  private applyClassOverride(override: DependencyOverride): void {\n    if (!('useClass' in override)) {\n      return;\n    }\n\n    const tokenIds = this.getOverrideTokenIds(override.token);\n    const classId = this.getOverrideClassServiceId(override.useClass);\n\n    this.overrideTokenIds.set(override.token, tokenIds[0]);\n    for (const tokenId of tokenIds) {\n      this.container.setAlias(tokenId, classId);\n    }\n  }\n\n  private applyFactoryOverride(override: DependencyOverride): void {\n    if (!('useFactory' in override)) {\n      return;\n    }\n\n    const tokenIds = this.getOverrideTokenIds(override.token);\n    const factoryId = this.getOverrideId('factory', override.token);\n\n    this.ensureSyntheticService(factoryId, override.useFactory(this));\n    this.overrideTokenIds.set(override.token, tokenIds[0]);\n    for (const tokenId of tokenIds) {\n      this.container.setAlias(tokenId, factoryId);\n    }\n  }\n\n  private applyValueOverride(override: DependencyOverride): void {\n    if (!('useValue' in override)) {\n      return;\n    }\n\n    const tokenIds = this.getOverrideTokenIds(override.token);\n    const valueId = this.getOverrideId('value', override.token);\n\n    this.ensureSyntheticService(valueId, override.useValue);\n    this.overrideTokenIds.set(override.token, tokenIds[0]);\n    for (const tokenId of tokenIds) {\n      this.container.setAlias(tokenId, valueId);\n    }\n  }\n\n  private applyOverrides(): void {\n    for (const override of this.options.overrides ?? []) {\n      this.applyClassOverride(override);\n      this.applyFactoryOverride(override);\n      this.applyValueOverride(override);\n    }\n  }\n\n  private registerParentAliases(): void {\n    for (const [id, definition] of this.definitions.entries()) {\n      if (definition._abstract === true || !definition._parent) {\n        continue;\n      }\n\n      this.container.setAlias(definition._parent, id);\n    }\n  }\n\n  public async compile(): Promise<void> {\n    if (this.options.containerBuild) {\n      await this.ensureFolderExists(this.options.servicesYamlPath);\n      this.autowire = new Autowire(this.container);\n      this.autowire.serviceFile = new ServiceFile(\n        this.options.servicesYamlPath,\n        false,\n      );\n      await this.autowire.process();\n    } else {\n      this.loader = new YamlFileLoader(this.container);\n      await this.loader.load(this.options.servicesYamlPath);\n    }\n\n    this.registerParentAliases();\n    this.applyOverrides();\n    await this.container.compile();\n  }\n\n  public getService<T>(serviceName: unknown): T {\n    const overrideTokenId = this.overrideTokenIds.get(serviceName);\n\n    if (overrideTokenId) {\n      return this.container.get<T>(overrideTokenId);\n    }\n\n    const aliasServiceId = this.findAliasServiceId(serviceName);\n\n    if (aliasServiceId) {\n      return this.container.get<T>(aliasServiceId);\n    }\n\n    const childServiceId = this.findConcreteChildServiceId(serviceName);\n\n    if (childServiceId) {\n      return this.container.get<T>(childServiceId);\n    }\n\n    const registeredServiceId = this.findRegisteredServiceId(serviceName);\n\n    if (registeredServiceId) {\n      return this.container.get<T>(registeredServiceId);\n    }\n\n    return this.container.get<T>(serviceName);\n  }\n}\n\nexport default DependencyInjection;\n","export class KernelEnvironmentValidationError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'KernelEnvironmentValidationError';\n  }\n}\n","import { Kernel } from '../../../Kernel.js';\n\nexport abstract class Route {\n  public get<T>(service: unknown): T {\n    return Kernel.di.getService<T>(service);\n  }\n}\n\nexport default Route;\n"],"mappings":"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","names":["path","path"]}

package/dist/contracts/index.d.cts

@@ -1,8 +1,8 @@
 export { R as Repository } from '../Repository-D9CuAyCV.cjs';
 export { UnitOfWork } from './db/index.cjs';
-export { a as ConsumerExecutionContext, b as ConsumerMiddleware, c as ConsumerNext, S as ShutdownHook } from '../ShutdownHook-BUvR2Ii7.cjs';
+export { a as ConsumerExecutionContext, b as ConsumerMiddleware, c as ConsumerNext, S as ShutdownHook } from '../ShutdownHook-BsEGvnEf.cjs';
 export { D as DomainEvent, H as HandlerContext, M as Message, a as MessageMetadata } from '../HandlerContext-Lm89pSeG.cjs';
-export { I as IdempotencyStore, R as RetryDelayResolver, a as RetryPredicate } from '../RetryPredicate-CBlnBUDO.cjs';
+export { I as IdempotencyStore, R as RetryDelayResolver, a as RetryPredicate } from '../RetryPredicate-ZjioTYXn.cjs';
 export { K as KernelLogger } from '../KernelLogger-BESOFrpW.cjs';
 export { KernelMiddleware } from './kernel/index.cjs';
 export { S as ServiceResolver } from '../ServiceResolver-D2Jz-l_Z.cjs';

package/dist/contracts/index.d.ts

@@ -1,8 +1,8 @@
 export { R as Repository } from '../Repository-D9CuAyCV.js';
 export { UnitOfWork } from './db/index.js';
-export { a as ConsumerExecutionContext, b as ConsumerMiddleware, c as ConsumerNext, S as ShutdownHook } from '../ShutdownHook-3Gc1yyHI.js';
+export { a as ConsumerExecutionContext, b as ConsumerMiddleware, c as ConsumerNext, S as ShutdownHook } from '../ShutdownHook-B03Mcke-.js';
 export { D as DomainEvent, H as HandlerContext, M as Message, a as MessageMetadata } from '../HandlerContext-DUUExVo3.js';
-export { I as IdempotencyStore, R as RetryDelayResolver, a as RetryPredicate } from '../RetryPredicate-DAv_7ve2.js';
+export { I as IdempotencyStore, R as RetryDelayResolver, a as RetryPredicate } from '../RetryPredicate-Bl3SMnbL.js';
 export { K as KernelLogger } from '../KernelLogger-BESOFrpW.js';
 export { KernelMiddleware } from './kernel/index.js';
 export { S as ServiceResolver } from '../ServiceResolver-D2Jz-l_Z.js';

package/dist/contracts/kernel/index.d.cts

@@ -1,6 +1,6 @@
-export { a as ConsumerExecutionContext, b as ConsumerMiddleware, c as ConsumerNext, S as ShutdownHook } from '../../ShutdownHook-BUvR2Ii7.cjs';
+export { a as ConsumerExecutionContext, b as ConsumerMiddleware, c as ConsumerNext, S as ShutdownHook } from '../../ShutdownHook-BsEGvnEf.cjs';
 import { M as Message, H as HandlerContext } from '../../HandlerContext-Lm89pSeG.cjs';
-export { I as IdempotencyStore, R as RetryDelayResolver, a as RetryPredicate } from '../../RetryPredicate-CBlnBUDO.cjs';
+export { I as IdempotencyStore, R as RetryDelayResolver, a as RetryPredicate } from '../../RetryPredicate-ZjioTYXn.cjs';
 export { K as KernelLogger } from '../../KernelLogger-BESOFrpW.cjs';
 export { S as ServiceResolver } from '../../ServiceResolver-D2Jz-l_Z.cjs';
 import '../../DomainEvent-mXWEtr_J.cjs';

package/dist/contracts/kernel/index.d.ts

@@ -1,6 +1,6 @@
-export { a as ConsumerExecutionContext, b as ConsumerMiddleware, c as ConsumerNext, S as ShutdownHook } from '../../ShutdownHook-3Gc1yyHI.js';
+export { a as ConsumerExecutionContext, b as ConsumerMiddleware, c as ConsumerNext, S as ShutdownHook } from '../../ShutdownHook-B03Mcke-.js';
 import { M as Message, H as HandlerContext } from '../../HandlerContext-DUUExVo3.js';
-export { I as IdempotencyStore, R as RetryDelayResolver, a as RetryPredicate } from '../../RetryPredicate-DAv_7ve2.js';
+export { I as IdempotencyStore, R as RetryDelayResolver, a as RetryPredicate } from '../../RetryPredicate-Bl3SMnbL.js';
 export { K as KernelLogger } from '../../KernelLogger-BESOFrpW.js';
 export { S as ServiceResolver } from '../../ServiceResolver-D2Jz-l_Z.js';
 import '../../DomainEvent-mXWEtr_J.js';

package/dist/index.cjs

@@ -34,6 +34,7 @@ __export(src_exports, {
   HandlerNotFoundError: () => HandlerNotFoundError,
   HttpRouteStatusEnum: () => HttpRouteStatusEnum,
   Kernel: () => Kernel,
+  KernelEnvironmentValidationError: () => KernelEnvironmentValidationError,
   KernelError: () => KernelError,
   createKernel: () => createKernel,
   default: () => Kernel_default
@@ -347,6 +348,14 @@ var DependencyInjection = class _DependencyInjection {
   }
 };
 
+// src/kernel/KernelEnvironmentValidationError.ts
+var KernelEnvironmentValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "KernelEnvironmentValidationError";
+  }
+};
+
 // src/Kernel.ts
 var Kernel = class _Kernel {
   constructor(options = {}) {
@@ -366,6 +375,7 @@ var Kernel = class _Kernel {
   schedulersList = [];
   shutdownHooks = [];
   dependencyInjectionInstance;
+  environmentVariables = process.env;
   static get state() {
     const stateContainer = globalThis;
     stateContainer[_Kernel.stateKey] = stateContainer[_Kernel.stateKey] ?? {};
@@ -410,18 +420,82 @@ var Kernel = class _Kernel {
     }
     return _Kernel.state.activeKernel;
   }
+  static assertRequiredEnvironmentVariable(name, value, schema) {
+    if (schema[name]?.required === true && value === void 0) {
+      throw new KernelEnvironmentValidationError(
+        `Missing required environment variable "${name}".`
+      );
+    }
+  }
   static getEnvironmentVariablesPath(environment, options) {
     return import_node_path2.default.resolve(
       _Kernel.rootDirectory,
       options.path ?? (environment ? `.env.${environment}` : ".env")
     );
   }
+  static parseBooleanEnvironmentVariable(name, value) {
+    if (["1", "true", "yes", "on"].includes(value.toLowerCase())) {
+      return true;
+    }
+    if (["0", "false", "no", "off"].includes(value.toLowerCase())) {
+      return false;
+    }
+    throw new KernelEnvironmentValidationError(
+      `Environment variable "${name}" must be a boolean.`
+    );
+  }
+  static parseNumberEnvironmentVariable(name, value) {
+    if (value.trim() === "") {
+      throw new KernelEnvironmentValidationError(
+        `Environment variable "${name}" must be a number.`
+      );
+    }
+    const parsedValue = Number(value);
+    if (Number.isFinite(parsedValue)) {
+      return parsedValue;
+    }
+    throw new KernelEnvironmentValidationError(
+      `Environment variable "${name}" must be a number.`
+    );
+  }
+  static parseEnvironmentVariable(name, value, schema) {
+    const definition = schema[name];
+    if (definition.type === "boolean") {
+      return _Kernel.parseBooleanEnvironmentVariable(name, value);
+    }
+    if (definition.type === "number") {
+      return _Kernel.parseNumberEnvironmentVariable(name, value);
+    }
+    return value;
+  }
+  static validateEnvironmentVariables(schema) {
+    const environmentVariables = {};
+    for (const [name, definition] of Object.entries(schema)) {
+      const value = process.env[name] ?? definition.defaultValue?.toString();
+      _Kernel.assertRequiredEnvironmentVariable(name, value, schema);
+      if (value !== void 0) {
+        environmentVariables[name] = _Kernel.parseEnvironmentVariable(
+          name,
+          value,
+          schema
+        );
+      }
+    }
+    return {
+      ...process.env,
+      ...environmentVariables
+    };
+  }
   static loadEnvironmentVariables(environment, options = {}) {
     const environmentName = environment ?? process.env.NODE_ENV ?? "local";
-    return import_dotenv.default.config({
+    const result = import_dotenv.default.config({
       override: options.override,
       path: _Kernel.getEnvironmentVariablesPath(environmentName, options)
     });
+    if (options.schema) {
+      _Kernel.validateEnvironmentVariables(options.schema);
+    }
+    return result;
   }
   async closeCandidate(candidate) {
     if (candidate.shutdown) {
@@ -465,7 +539,7 @@ var Kernel = class _Kernel {
     return this.dependencyInjectionInstance;
   }
   get environment() {
-    return _Kernel.environment;
+    return this.environmentVariables;
   }
   get logger() {
     return this.loggerInstance;
@@ -493,7 +567,12 @@ var Kernel = class _Kernel {
     _Kernel.state.activeKernel = this;
   }
   loadEnvironmentVariables(environment, options = {}) {
-    return _Kernel.loadEnvironmentVariables(environment, options);
+    const result = _Kernel.loadEnvironmentVariables(environment, {
+      ...options,
+      schema: options.schema ?? this.options.environmentSchema
+    });
+    this.environmentVariables = this.options.environmentSchema ? _Kernel.validateEnvironmentVariables(this.options.environmentSchema) : process.env;
+    return result;
   }
   getRoutes() {
     return this.routes;
@@ -585,6 +664,7 @@ var Kernel_default = Kernel;
   HandlerNotFoundError,
   HttpRouteStatusEnum,
   Kernel,
+  KernelEnvironmentValidationError,
   KernelError,
   createKernel
 });