@haskou/ddd-kernel 1.2.0 → 2.0.0

package/README.md

@@ -65,6 +65,9 @@ according to the source branch prefix:
 | `feat/*`      | Minor            |
 | `break/*`     | Major            |
 
+Renovate runtime dependency PRs use `renovate/*` branches. They publish a patch
+release only when the PR title starts with `fix(`.
+
 Other branch names run validation only and do not publish.
 
 ## License

package/dist/{DomainEventConsumer-Bg-bOwmh.d.cts → DomainEventConsumer-BiTSbfMw.d.cts}

@@ -1,5 +1,9 @@
 import { D as DomainEvent } from './DomainEvent-mXWEtr_J.cjs';
 
+type Constructor<T> = {
+    new (...args: unknown[]): T;
+};
+
 interface DomainEventConsumerContext {
     readonly metadata: Readonly<Record<string, unknown>>;
 }
@@ -8,4 +12,4 @@ declare abstract class DomainEventConsumer {
     abstract consume(queueName: string, bindingKey: string, domainEvent: typeof DomainEvent, exchange: string, handler: (event: DomainEvent, context?: DomainEventConsumerContext) => Promise<void>): Promise<void>;
 }
 
-export { DomainEventConsumer as D, type DomainEventConsumerContext as a };
+export { type Constructor as C, DomainEventConsumer as D, type DomainEventConsumerContext as a };

package/dist/{DomainEventConsumer-BroJmVty.d.ts → DomainEventConsumer-D1P4oXoj.d.ts}

@@ -1,5 +1,9 @@
 import { D as DomainEvent } from './DomainEvent-mXWEtr_J.js';
 
+type Constructor<T> = {
+    new (...args: unknown[]): T;
+};
+
 interface DomainEventConsumerContext {
     readonly metadata: Readonly<Record<string, unknown>>;
 }
@@ -8,4 +12,4 @@ declare abstract class DomainEventConsumer {
     abstract consume(queueName: string, bindingKey: string, domainEvent: typeof DomainEvent, exchange: string, handler: (event: DomainEvent, context?: DomainEventConsumerContext) => Promise<void>): Promise<void>;
 }
 
-export { DomainEventConsumer as D, type DomainEventConsumerContext as a };
+export { type Constructor as C, DomainEventConsumer as D, type DomainEventConsumerContext as a };

package/dist/{DomainMessageBus-OyliPu3Z.d.cts → DomainMessageBus-CQSFU6A6.d.cts}

@@ -1,5 +1,5 @@
 import { M as MessageBus } from './MessageBus-BtUXnd0Y.cjs';
-import { D as DomainEventConsumer } from './DomainEventConsumer-Bg-bOwmh.cjs';
+import { D as DomainEventConsumer } from './DomainEventConsumer-BiTSbfMw.cjs';
 import { D as DomainEvent } from './DomainEvent-mXWEtr_J.cjs';
 
 declare abstract class DomainEventPublisher {

package/dist/{DomainMessageBus-3jYk7TPw.d.ts → DomainMessageBus-kjMVNGfv.d.ts}

@@ -1,5 +1,5 @@
 import { M as MessageBus } from './MessageBus-oQ9BnW84.js';
-import { D as DomainEventConsumer } from './DomainEventConsumer-BroJmVty.js';
+import { D as DomainEventConsumer } from './DomainEventConsumer-D1P4oXoj.js';
 import { D as DomainEvent } from './DomainEvent-mXWEtr_J.js';
 
 declare abstract class DomainEventPublisher {

package/dist/KernelRoute-B7mVPrEx.d.cts

@@ -0,0 +1,5 @@
+declare abstract class KernelRoute {
+    protected readonly kernelRouteContract: never;
+}
+
+export { KernelRoute as K };

package/dist/KernelRoute-B7mVPrEx.d.ts

@@ -0,0 +1,5 @@
+declare abstract class KernelRoute {
+    protected readonly kernelRouteContract: never;
+}
+
+export { KernelRoute as K };

package/dist/{NoFailedMessagesError-BjxYoKTR.d.cts → NoFailedMessagesError-Dm5AFcJV.d.cts}

@@ -1,10 +1,9 @@
 import { a as PublisherHook } from './Subscription-4vuAAxax.cjs';
-import { L as Log } from './Log-36L3Z84a.cjs';
 import { P as PublisherHookErrorPolicy } from './PublisherHookErrorPolicy-CjouTcSR.cjs';
+import { L as Log } from './Log-36L3Z84a.cjs';
 import { Channel } from 'amqplib';
 import { D as DomainEvent } from './DomainEvent-mXWEtr_J.cjs';
-import { C as Constructor } from './Constructor-fyZLLIh8.cjs';
-import { a as DomainEventConsumerContext } from './DomainEventConsumer-Bg-bOwmh.cjs';
+import { a as DomainEventConsumerContext, C as Constructor } from './DomainEventConsumer-BiTSbfMw.cjs';
 
 type AmqpMessage = {
     readonly aggregate_id: string;

package/dist/{NoFailedMessagesError-BLpGI-G4.d.ts → NoFailedMessagesError-z-6ffelK.d.ts}

@@ -1,10 +1,9 @@
 import { a as PublisherHook } from './Subscription-vtF0lEHP.js';
-import { L as Log } from './Log-36L3Z84a.js';
 import { P as PublisherHookErrorPolicy } from './PublisherHookErrorPolicy-DSsCNE6O.js';
+import { L as Log } from './Log-36L3Z84a.js';
 import { Channel } from 'amqplib';
 import { D as DomainEvent } from './DomainEvent-mXWEtr_J.js';
-import { C as Constructor } from './Constructor-fyZLLIh8.js';
-import { a as DomainEventConsumerContext } from './DomainEventConsumer-BroJmVty.js';
+import { a as DomainEventConsumerContext, C as Constructor } from './DomainEventConsumer-D1P4oXoj.js';
 
 type AmqpMessage = {
     readonly aggregate_id: string;

package/dist/{RetryPredicate-Bl3SMnbL.d.ts → RetryPredicate-CD9n6cE8.d.ts}

@@ -1,4 +1,4 @@
-import { a as ConsumerExecutionContext } from './ShutdownHook-B03Mcke-.js';
+import { C as ConsumerExecutionContext } from './ShutdownHook-CUl7zYwd.js';
 
 interface IdempotencyStore {
     claim?(key: string): Promise<boolean> | boolean;

package/dist/{RetryPredicate-ZjioTYXn.d.cts → RetryPredicate-DNdxY_KR.d.cts}

@@ -1,4 +1,4 @@
-import { a as ConsumerExecutionContext } from './ShutdownHook-BsEGvnEf.cjs';
+import { C as ConsumerExecutionContext } from './ShutdownHook-D23WfIIc.cjs';
 
 interface IdempotencyStore {
     claim?(key: string): Promise<boolean> | boolean;

package/dist/{ShutdownHook-B03Mcke-.d.ts → ShutdownHook-CUl7zYwd.d.ts}

@@ -1,24 +1,10 @@
 import { D as DomainEvent } from './DomainEvent-mXWEtr_J.js';
 import { DotenvConfigOutput } from 'dotenv';
-import { D as DomainEventConsumer } from './DomainEventConsumer-BroJmVty.js';
-import { Route } from './adapters/ui/routes/index.js';
 import { b as DependencyOverride, D as DependencyInjection, S as ServiceClass } from './ServiceClass-Bq_fBC5R.js';
 import { Initializer, Runtime } from './infrastructure/lifecycle/index.js';
 import { a as Scheduler } from './Scheduler-BW-U5Ccg.js';
 import { K as KernelLogger } from './KernelLogger-BESOFrpW.js';
-
-declare abstract class Consumer {
-    private readonly consumer;
-    constructor(consumer: DomainEventConsumer);
-    private runMiddleware;
-    abstract get domainEvent(): typeof DomainEvent;
-    abstract get eventName(): string;
-    abstract get exchange(): string;
-    abstract get queueName(): string;
-    abstract handler(event: DomainEvent): Promise<void>;
-    init(): Promise<void>;
-    get<T>(service: unknown): T;
-}
+import { K as KernelRoute } from './KernelRoute-B7mVPrEx.js';
 
 interface KernelDependencyInjectionOptions {
     readonly containerBuild?: boolean;
@@ -33,9 +19,12 @@ type KernelEnvironmentVariableType = 'boolean' | 'number' | 'string';
 
 type KernelEnvironmentVariablePrimitive<TType extends KernelEnvironmentVariableType> = TType extends 'boolean' ? boolean : TType extends 'number' ? number : string;
 
-interface KernelEnvironmentVariableDefinition<TType extends KernelEnvironmentVariableType = KernelEnvironmentVariableType, TRequired extends boolean = boolean> {
-    readonly defaultValue?: KernelEnvironmentVariablePrimitive<TType>;
+interface KernelEnvironmentVariableDefinition<TType extends KernelEnvironmentVariableType = KernelEnvironmentVariableType, TRequired extends boolean = boolean, TChoices extends readonly KernelEnvironmentVariablePrimitive<TType>[] | undefined = readonly KernelEnvironmentVariablePrimitive<TType>[] | undefined> {
+    readonly choices?: TChoices;
+    readonly defaultValue?: TChoices extends readonly KernelEnvironmentVariablePrimitive<TType>[] ? TChoices[number] : KernelEnvironmentVariablePrimitive<TType>;
+    readonly description?: string;
     readonly required?: TRequired;
+    readonly sensitive?: boolean;
     readonly type: TType;
 }
 
@@ -43,9 +32,15 @@ type KernelEnvironmentSchema = Readonly<Record<string, KernelEnvironmentVariable
 
 type KernelEnvironmentValue = boolean | number | string;
 
-type KernelEnvironmentVariable<TDefinition extends KernelEnvironmentVariableDefinition> = TDefinition extends KernelEnvironmentVariableDefinition<infer TType extends KernelEnvironmentVariableType, infer TRequired extends boolean> ? TDefinition extends {
+type KernelEnvironmentVariableResolvedValue<TDefinition extends KernelEnvironmentVariableDefinition> = TDefinition extends {
+    readonly choices: readonly (infer TChoice extends KernelEnvironmentValue)[];
+} ? TChoice : TDefinition extends KernelEnvironmentVariableDefinition<infer TType extends KernelEnvironmentVariableType> ? KernelEnvironmentVariablePrimitive<TType> : never;
+
+type KernelEnvironmentVariable<TDefinition extends KernelEnvironmentVariableDefinition> = TDefinition extends {
     readonly defaultValue: unknown;
-} ? KernelEnvironmentVariablePrimitive<TType> : TRequired extends true ? KernelEnvironmentVariablePrimitive<TType> : KernelEnvironmentVariablePrimitive<TType> | undefined : never;
+} ? KernelEnvironmentVariableResolvedValue<TDefinition> : TDefinition extends {
+    readonly required: true;
+} ? KernelEnvironmentVariableResolvedValue<TDefinition> : KernelEnvironmentVariableResolvedValue<TDefinition> | undefined;
 
 type KernelEnvironment<TSchema extends KernelEnvironmentSchema> = {
     readonly [key: string]: KernelEnvironmentValue | undefined;
@@ -55,15 +50,28 @@ type KernelEnvironment<TSchema extends KernelEnvironmentSchema> = {
 
 type KernelEnvironmentForSchema<TSchema extends KernelEnvironmentSchema | undefined> = TSchema extends KernelEnvironmentSchema ? KernelEnvironment<TSchema> : KernelDefaultEnvironment;
 
+type KernelEnvironmentSchemaInput<TSchema extends KernelEnvironmentSchema> = {
+    readonly [TKey in keyof TSchema]: TSchema[TKey] extends {
+        readonly choices: infer TChoices extends readonly KernelEnvironmentVariablePrimitive<TSchema[TKey]['type']>[];
+        readonly type: infer TType extends KernelEnvironmentVariableType;
+    } ? KernelEnvironmentVariableDefinition<TType, TSchema[TKey] extends {
+        readonly required: true;
+    } ? true : boolean, TChoices> : TSchema[TKey] extends {
+        readonly type: infer TType extends KernelEnvironmentVariableType;
+    } ? KernelEnvironmentVariableDefinition<TType, TSchema[TKey] extends {
+        readonly required: true;
+    } ? true : boolean> : never;
+};
+
 interface KernelEnvironmentVariablesOptions<TSchema extends KernelEnvironmentSchema | undefined = undefined> {
     readonly override?: boolean;
     readonly path?: string;
-    readonly schema?: TSchema;
+    readonly schema?: TSchema extends KernelEnvironmentSchema ? TSchema & KernelEnvironmentSchemaInput<TSchema> : TSchema;
 }
 
 interface KernelOptions<TEnvironmentSchema extends KernelEnvironmentSchema | undefined = undefined> {
     readonly di?: DependencyInjection;
-    readonly environmentSchema?: TEnvironmentSchema;
+    readonly environmentSchema?: TEnvironmentSchema extends KernelEnvironmentSchema ? TEnvironmentSchema & KernelEnvironmentSchemaInput<TEnvironmentSchema> : TEnvironmentSchema;
     readonly logger?: KernelLogger;
     readonly servicesYamlPath?: string;
     readonly sourceDirectory?: string;
@@ -82,18 +90,19 @@ declare class Kernel<TEnvironmentSchema extends KernelEnvironmentSchema | undefi
     private environmentVariables;
     private static get state();
     static get configDirectory(): string;
-    static get consumers(): Consumer[];
+    static get consumers(): KernelConsumer[];
     static get consumerMiddleware(): ConsumerMiddleware[];
     static get di(): DependencyInjection;
     static get environment(): NodeJS.ProcessEnv;
     static get logger(): KernelLogger;
     static get active(): Kernel<KernelEnvironmentSchema | undefined>;
     static get rootDirectory(): string;
-    static get routes(): ServiceClass<Route>[];
+    static get routes(): ServiceClass<KernelRoute>[];
     static get schedulers(): Scheduler[];
     static get sourceDirectory(): string;
     private static getActiveKernel;
     private static assertRequiredEnvironmentVariable;
+    private static assertEnvironmentVariableChoice;
     private static getEnvironmentVariablesPath;
     private static parseBooleanEnvironmentVariable;
     private static parseNumberEnvironmentVariable;
@@ -106,21 +115,21 @@ declare class Kernel<TEnvironmentSchema extends KernelEnvironmentSchema | undefi
     private getInitializerFromClass;
     private getRuntimeFromClass;
     private getSchedulerFromClass;
-    get consumers(): Consumer[];
+    get consumers(): KernelConsumer[];
     get consumerMiddleware(): ConsumerMiddleware[];
     get di(): DependencyInjection;
     get environment(): KernelEnvironmentForSchema<TEnvironmentSchema>;
     get logger(): KernelLogger;
-    get routes(): ServiceClass<Route>[];
+    get routes(): ServiceClass<KernelRoute>[];
     get schedulers(): Scheduler[];
     private getDependencyInjectionOptions;
     dependencyInjection(options?: KernelDependencyInjectionOptions): Promise<void>;
     loadEnvironmentVariables(environment?: string, options?: KernelEnvironmentVariablesOptions<KernelEnvironmentSchema | undefined>): DotenvConfigOutput;
-    getRoutes(): ServiceClass<Route>[];
+    getRoutes(): ServiceClass<KernelRoute>[];
     registerConsumerMiddleware(...middlewares: ConsumerMiddleware[]): void;
-    registerConsumers(...ClassDefinitions: ServiceClass<Consumer>[]): void;
-    registerConsumerInstances(...consumers: Consumer[]): void;
-    registerRoutes(...ClassDefinitions: ServiceClass<Route>[]): void;
+    registerConsumers(...ClassDefinitions: ServiceClass<KernelConsumer>[]): void;
+    registerConsumerInstances(...consumers: KernelConsumer[]): void;
+    registerRoutes(...ClassDefinitions: ServiceClass<KernelRoute>[]): void;
     registerSchedulers(...ClassDefinitions: ServiceClass<Scheduler>[]): void;
     registerSchedulerInstances(...schedulers: Scheduler[]): void;
     registerShutdownHook(hook: ShutdownHook): void;
@@ -154,6 +163,11 @@ interface ConsumerMiddleware {
     handle(event: DomainEvent, next: ConsumerNext, context: ConsumerExecutionContext): Promise<void>;
 }
 
+interface KernelConsumer {
+    readonly queueName: string;
+    init(): Promise<void>;
+}
+
 type ShutdownHook = () => Promise<void> | void;
 
-export { Consumer as C, Kernel as K, type ShutdownHook as S, type ConsumerExecutionContext as a, type ConsumerMiddleware as b, type ConsumerNext as c, type KernelDefaultEnvironment as d, type KernelDependencyInjectionOptions as e, type KernelEnvironment as f, type KernelEnvironmentForSchema as g, type KernelEnvironmentSchema as h, type KernelEnvironmentValue as i, type KernelEnvironmentVariableDefinition as j, type KernelEnvironmentVariablePrimitive as k, type KernelEnvironmentVariableType as l, type KernelEnvironmentVariablesOptions as m, type KernelOptions as n, createKernel as o };
+export { type ConsumerExecutionContext as C, type KernelConsumer as K, type ShutdownHook as S, type ConsumerMiddleware as a, type ConsumerNext as b, Kernel as c, type KernelDefaultEnvironment as d, type KernelDependencyInjectionOptions as e, type KernelEnvironment as f, type KernelEnvironmentForSchema as g, type KernelEnvironmentSchema as h, type KernelEnvironmentSchemaInput as i, type KernelEnvironmentValue as j, type KernelEnvironmentVariableDefinition as k, type KernelEnvironmentVariablePrimitive as l, type KernelEnvironmentVariableResolvedValue as m, type KernelEnvironmentVariableType as n, type KernelEnvironmentVariablesOptions as o, type KernelOptions as p, createKernel as q };

package/dist/{ShutdownHook-BsEGvnEf.d.cts → ShutdownHook-D23WfIIc.d.cts}

@@ -1,24 +1,10 @@
 import { D as DomainEvent } from './DomainEvent-mXWEtr_J.cjs';
 import { DotenvConfigOutput } from 'dotenv';
-import { D as DomainEventConsumer } from './DomainEventConsumer-Bg-bOwmh.cjs';
-import { Route } from './adapters/ui/routes/index.cjs';
 import { b as DependencyOverride, D as DependencyInjection, S as ServiceClass } from './ServiceClass-BkEHcXDi.cjs';
 import { Initializer, Runtime } from './infrastructure/lifecycle/index.cjs';
 import { a as Scheduler } from './Scheduler-BW-U5Ccg.cjs';
 import { K as KernelLogger } from './KernelLogger-BESOFrpW.cjs';
-
-declare abstract class Consumer {
-    private readonly consumer;
-    constructor(consumer: DomainEventConsumer);
-    private runMiddleware;
-    abstract get domainEvent(): typeof DomainEvent;
-    abstract get eventName(): string;
-    abstract get exchange(): string;
-    abstract get queueName(): string;
-    abstract handler(event: DomainEvent): Promise<void>;
-    init(): Promise<void>;
-    get<T>(service: unknown): T;
-}
+import { K as KernelRoute } from './KernelRoute-B7mVPrEx.cjs';
 
 interface KernelDependencyInjectionOptions {
     readonly containerBuild?: boolean;
@@ -33,9 +19,12 @@ type KernelEnvironmentVariableType = 'boolean' | 'number' | 'string';
 
 type KernelEnvironmentVariablePrimitive<TType extends KernelEnvironmentVariableType> = TType extends 'boolean' ? boolean : TType extends 'number' ? number : string;
 
-interface KernelEnvironmentVariableDefinition<TType extends KernelEnvironmentVariableType = KernelEnvironmentVariableType, TRequired extends boolean = boolean> {
-    readonly defaultValue?: KernelEnvironmentVariablePrimitive<TType>;
+interface KernelEnvironmentVariableDefinition<TType extends KernelEnvironmentVariableType = KernelEnvironmentVariableType, TRequired extends boolean = boolean, TChoices extends readonly KernelEnvironmentVariablePrimitive<TType>[] | undefined = readonly KernelEnvironmentVariablePrimitive<TType>[] | undefined> {
+    readonly choices?: TChoices;
+    readonly defaultValue?: TChoices extends readonly KernelEnvironmentVariablePrimitive<TType>[] ? TChoices[number] : KernelEnvironmentVariablePrimitive<TType>;
+    readonly description?: string;
     readonly required?: TRequired;
+    readonly sensitive?: boolean;
     readonly type: TType;
 }
 
@@ -43,9 +32,15 @@ type KernelEnvironmentSchema = Readonly<Record<string, KernelEnvironmentVariable
 
 type KernelEnvironmentValue = boolean | number | string;
 
-type KernelEnvironmentVariable<TDefinition extends KernelEnvironmentVariableDefinition> = TDefinition extends KernelEnvironmentVariableDefinition<infer TType extends KernelEnvironmentVariableType, infer TRequired extends boolean> ? TDefinition extends {
+type KernelEnvironmentVariableResolvedValue<TDefinition extends KernelEnvironmentVariableDefinition> = TDefinition extends {
+    readonly choices: readonly (infer TChoice extends KernelEnvironmentValue)[];
+} ? TChoice : TDefinition extends KernelEnvironmentVariableDefinition<infer TType extends KernelEnvironmentVariableType> ? KernelEnvironmentVariablePrimitive<TType> : never;
+
+type KernelEnvironmentVariable<TDefinition extends KernelEnvironmentVariableDefinition> = TDefinition extends {
     readonly defaultValue: unknown;
-} ? KernelEnvironmentVariablePrimitive<TType> : TRequired extends true ? KernelEnvironmentVariablePrimitive<TType> : KernelEnvironmentVariablePrimitive<TType> | undefined : never;
+} ? KernelEnvironmentVariableResolvedValue<TDefinition> : TDefinition extends {
+    readonly required: true;
+} ? KernelEnvironmentVariableResolvedValue<TDefinition> : KernelEnvironmentVariableResolvedValue<TDefinition> | undefined;
 
 type KernelEnvironment<TSchema extends KernelEnvironmentSchema> = {
     readonly [key: string]: KernelEnvironmentValue | undefined;
@@ -55,15 +50,28 @@ type KernelEnvironment<TSchema extends KernelEnvironmentSchema> = {
 
 type KernelEnvironmentForSchema<TSchema extends KernelEnvironmentSchema | undefined> = TSchema extends KernelEnvironmentSchema ? KernelEnvironment<TSchema> : KernelDefaultEnvironment;
 
+type KernelEnvironmentSchemaInput<TSchema extends KernelEnvironmentSchema> = {
+    readonly [TKey in keyof TSchema]: TSchema[TKey] extends {
+        readonly choices: infer TChoices extends readonly KernelEnvironmentVariablePrimitive<TSchema[TKey]['type']>[];
+        readonly type: infer TType extends KernelEnvironmentVariableType;
+    } ? KernelEnvironmentVariableDefinition<TType, TSchema[TKey] extends {
+        readonly required: true;
+    } ? true : boolean, TChoices> : TSchema[TKey] extends {
+        readonly type: infer TType extends KernelEnvironmentVariableType;
+    } ? KernelEnvironmentVariableDefinition<TType, TSchema[TKey] extends {
+        readonly required: true;
+    } ? true : boolean> : never;
+};
+
 interface KernelEnvironmentVariablesOptions<TSchema extends KernelEnvironmentSchema | undefined = undefined> {
     readonly override?: boolean;
     readonly path?: string;
-    readonly schema?: TSchema;
+    readonly schema?: TSchema extends KernelEnvironmentSchema ? TSchema & KernelEnvironmentSchemaInput<TSchema> : TSchema;
 }
 
 interface KernelOptions<TEnvironmentSchema extends KernelEnvironmentSchema | undefined = undefined> {
     readonly di?: DependencyInjection;
-    readonly environmentSchema?: TEnvironmentSchema;
+    readonly environmentSchema?: TEnvironmentSchema extends KernelEnvironmentSchema ? TEnvironmentSchema & KernelEnvironmentSchemaInput<TEnvironmentSchema> : TEnvironmentSchema;
     readonly logger?: KernelLogger;
     readonly servicesYamlPath?: string;
     readonly sourceDirectory?: string;
@@ -82,18 +90,19 @@ declare class Kernel<TEnvironmentSchema extends KernelEnvironmentSchema | undefi
     private environmentVariables;
     private static get state();
     static get configDirectory(): string;
-    static get consumers(): Consumer[];
+    static get consumers(): KernelConsumer[];
     static get consumerMiddleware(): ConsumerMiddleware[];
     static get di(): DependencyInjection;
     static get environment(): NodeJS.ProcessEnv;
     static get logger(): KernelLogger;
     static get active(): Kernel<KernelEnvironmentSchema | undefined>;
     static get rootDirectory(): string;
-    static get routes(): ServiceClass<Route>[];
+    static get routes(): ServiceClass<KernelRoute>[];
     static get schedulers(): Scheduler[];
     static get sourceDirectory(): string;
     private static getActiveKernel;
     private static assertRequiredEnvironmentVariable;
+    private static assertEnvironmentVariableChoice;
     private static getEnvironmentVariablesPath;
     private static parseBooleanEnvironmentVariable;
     private static parseNumberEnvironmentVariable;
@@ -106,21 +115,21 @@ declare class Kernel<TEnvironmentSchema extends KernelEnvironmentSchema | undefi
     private getInitializerFromClass;
     private getRuntimeFromClass;
     private getSchedulerFromClass;
-    get consumers(): Consumer[];
+    get consumers(): KernelConsumer[];
     get consumerMiddleware(): ConsumerMiddleware[];
     get di(): DependencyInjection;
     get environment(): KernelEnvironmentForSchema<TEnvironmentSchema>;
     get logger(): KernelLogger;
-    get routes(): ServiceClass<Route>[];
+    get routes(): ServiceClass<KernelRoute>[];
     get schedulers(): Scheduler[];
     private getDependencyInjectionOptions;
     dependencyInjection(options?: KernelDependencyInjectionOptions): Promise<void>;
     loadEnvironmentVariables(environment?: string, options?: KernelEnvironmentVariablesOptions<KernelEnvironmentSchema | undefined>): DotenvConfigOutput;
-    getRoutes(): ServiceClass<Route>[];
+    getRoutes(): ServiceClass<KernelRoute>[];
     registerConsumerMiddleware(...middlewares: ConsumerMiddleware[]): void;
-    registerConsumers(...ClassDefinitions: ServiceClass<Consumer>[]): void;
-    registerConsumerInstances(...consumers: Consumer[]): void;
-    registerRoutes(...ClassDefinitions: ServiceClass<Route>[]): void;
+    registerConsumers(...ClassDefinitions: ServiceClass<KernelConsumer>[]): void;
+    registerConsumerInstances(...consumers: KernelConsumer[]): void;
+    registerRoutes(...ClassDefinitions: ServiceClass<KernelRoute>[]): void;
     registerSchedulers(...ClassDefinitions: ServiceClass<Scheduler>[]): void;
     registerSchedulerInstances(...schedulers: Scheduler[]): void;
     registerShutdownHook(hook: ShutdownHook): void;
@@ -154,6 +163,11 @@ interface ConsumerMiddleware {
     handle(event: DomainEvent, next: ConsumerNext, context: ConsumerExecutionContext): Promise<void>;
 }
 
+interface KernelConsumer {
+    readonly queueName: string;
+    init(): Promise<void>;
+}
+
 type ShutdownHook = () => Promise<void> | void;
 
-export { Consumer as C, Kernel as K, type ShutdownHook as S, type ConsumerExecutionContext as a, type ConsumerMiddleware as b, type ConsumerNext as c, type KernelDefaultEnvironment as d, type KernelDependencyInjectionOptions as e, type KernelEnvironment as f, type KernelEnvironmentForSchema as g, type KernelEnvironmentSchema as h, type KernelEnvironmentValue as i, type KernelEnvironmentVariableDefinition as j, type KernelEnvironmentVariablePrimitive as k, type KernelEnvironmentVariableType as l, type KernelEnvironmentVariablesOptions as m, type KernelOptions as n, createKernel as o };
+export { type ConsumerExecutionContext as C, type KernelConsumer as K, type ShutdownHook as S, type ConsumerMiddleware as a, type ConsumerNext as b, Kernel as c, type KernelDefaultEnvironment as d, type KernelDependencyInjectionOptions as e, type KernelEnvironment as f, type KernelEnvironmentForSchema as g, type KernelEnvironmentSchema as h, type KernelEnvironmentSchemaInput as i, type KernelEnvironmentValue as j, type KernelEnvironmentVariableDefinition as k, type KernelEnvironmentVariablePrimitive as l, type KernelEnvironmentVariableResolvedValue as m, type KernelEnvironmentVariableType as n, type KernelEnvironmentVariablesOptions as o, type KernelOptions as p, createKernel as q };

package/dist/adapters/index.cjs

@@ -444,6 +444,14 @@ var Kernel = class _Kernel {
       );
     }
   }
+  static assertEnvironmentVariableChoice(name, value, schema) {
+    const choices = schema[name]?.choices;
+    if (choices && !choices.includes(value)) {
+      throw new KernelEnvironmentValidationError(
+        `Environment variable "${name}" must be one of: ${choices.join(", ")}.`
+      );
+    }
+  }
   static getEnvironmentVariablesPath(environment, options) {
     return import_node_path2.default.resolve(
       _Kernel.rootDirectory,
@@ -478,11 +486,16 @@ var Kernel = class _Kernel {
   static parseEnvironmentVariable(name, value, schema) {
     const definition = schema[name];
     if (definition.type === "boolean") {
-      return _Kernel.parseBooleanEnvironmentVariable(name, value);
+      const parsedValue = _Kernel.parseBooleanEnvironmentVariable(name, value);
+      _Kernel.assertEnvironmentVariableChoice(name, parsedValue, schema);
+      return parsedValue;
     }
     if (definition.type === "number") {
-      return _Kernel.parseNumberEnvironmentVariable(name, value);
+      const parsedValue = _Kernel.parseNumberEnvironmentVariable(name, value);
+      _Kernel.assertEnvironmentVariableChoice(name, parsedValue, schema);
+      return parsedValue;
     }
+    _Kernel.assertEnvironmentVariableChoice(name, value, schema);
     return value;
   }
   static validateEnvironmentVariables(schema) {
@@ -1349,8 +1362,12 @@ var RoutePrefix = class _RoutePrefix {
   }
 };
 
+// src/contracts/kernel/KernelRoute.ts
+var KernelRoute = class {
+};
+
 // src/adapters/ui/routes/Route.ts
-var Route = class {
+var Route = class extends KernelRoute {
   get(service) {
     return Kernel.di.getService(service);
   }