@haskou/ddd-kernel 0.1.0 → 1.0.0

package/dist/infrastructure/dependency-injection/index.d.cts

@@ -1,4 +1,4 @@
-export { D as DependencyInjection, a as DependencyInjectionOptions, S as ServiceClass } from '../../ServiceClass-BmNw8fJj.cjs';
+export { C as ClassDependencyOverride, D as DependencyInjection, a as DependencyInjectionOptions, b as DependencyOverride, c as DependencyOverrideFactory, d as DependencyOverrideToken, F as FactoryDependencyOverride, S as ServiceClass, V as ValueDependencyOverride } from '../../ServiceClass-BkEHcXDi.cjs';
 import '../../ServiceResolver-D2Jz-l_Z.cjs';
 
 type ExplicitServiceClass = {
@@ -11,6 +11,9 @@ type ContainerDefinition = {
 
 type DefinitionMetadata = {
     readonly _abstract?: boolean;
+    readonly _appendArgs?: unknown[];
+    readonly _args?: unknown[];
+    readonly _overrideArgs?: unknown[];
     readonly _parent?: string | null;
 };
 

package/dist/infrastructure/dependency-injection/index.d.ts

@@ -1,4 +1,4 @@
-export { D as DependencyInjection, a as DependencyInjectionOptions, S as ServiceClass } from '../../ServiceClass-C7NCKdSS.js';
+export { C as ClassDependencyOverride, D as DependencyInjection, a as DependencyInjectionOptions, b as DependencyOverride, c as DependencyOverrideFactory, d as DependencyOverrideToken, F as FactoryDependencyOverride, S as ServiceClass, V as ValueDependencyOverride } from '../../ServiceClass-Bq_fBC5R.js';
 import '../../ServiceResolver-D2Jz-l_Z.js';
 
 type ExplicitServiceClass = {
@@ -11,6 +11,9 @@ type ContainerDefinition = {
 
 type DefinitionMetadata = {
     readonly _abstract?: boolean;
+    readonly _appendArgs?: unknown[];
+    readonly _args?: unknown[];
+    readonly _overrideArgs?: unknown[];
     readonly _parent?: string | null;
 };
 

package/dist/infrastructure/dependency-injection/index.js

@@ -26,6 +26,7 @@ var DependencyInjection = class _DependencyInjection {
   autowire;
   loader;
   container;
+  overrideTokenIds = /* @__PURE__ */ new Map();
   static configure(options) {
     _DependencyInjection.configuredInstance = new _DependencyInjection(options);
     return _DependencyInjection.configuredInstance;
@@ -50,6 +51,16 @@ var DependencyInjection = class _DependencyInjection {
   getServiceClassName(serviceName) {
     return typeof serviceName === "function" ? serviceName.name : void 0;
   }
+  getOverrideId(prefix, token) {
+    const tokenName = this.getServiceClassName(token) ?? String(token);
+    return `ddd-kernel.override.${prefix}.${tokenName}`;
+  }
+  ensureSyntheticService(id, value) {
+    const definition = this.container.register(id);
+    definition.public = true;
+    definition.synthetic = true;
+    this.container.set(id, value);
+  }
   parentMatchesService(parentId, serviceClassName) {
     if (!parentId) {
       return false;
@@ -61,6 +72,26 @@ var DependencyInjection = class _DependencyInjection {
     const serviceName = Buffer.from(serviceId, "base64").toString("utf8");
     return serviceName.endsWith(`__${serviceClassName}__${serviceClassName}`);
   }
+  serviceIdReferencesService(serviceId, serviceClassName) {
+    const serviceName = Buffer.from(serviceId, "base64").toString("utf8");
+    return serviceName.endsWith(`__${serviceClassName}`);
+  }
+  getReferenceId(value) {
+    if (typeof value === "object" && value !== null && "id" in value && typeof value.id === "string") {
+      return value.id;
+    }
+    return void 0;
+  }
+  getDefinitionArgumentReferences(definition) {
+    return [
+      ...definition._args ?? [],
+      ...definition._appendArgs ?? [],
+      ...definition._overrideArgs ?? []
+    ].flatMap((argument) => {
+      const referenceId = this.getReferenceId(argument);
+      return referenceId ? [referenceId] : [];
+    });
+  }
   findConcreteChildServiceId(serviceName) {
     const serviceClassName = this.getServiceClassName(serviceName);
     if (!serviceClassName) {
@@ -91,6 +122,86 @@ var DependencyInjection = class _DependencyInjection {
     );
     return matches[matches.length - 1];
   }
+  findReferencedServiceIds(serviceName) {
+    const serviceClassName = this.getServiceClassName(serviceName);
+    if (!serviceClassName) {
+      return [];
+    }
+    return [
+      ...new Set(
+        [...this.definitions.values()].flatMap(
+          (definition) => this.getDefinitionArgumentReferences(definition)
+        ).filter(
+          (id) => this.serviceIdReferencesService(id, serviceClassName)
+        )
+      )
+    ];
+  }
+  getOverrideTokenIds(token) {
+    const tokenIds = [
+      this.findRegisteredServiceId(token),
+      this.findAliasServiceId(token),
+      ...this.findReferencedServiceIds(token)
+    ].filter((id) => id !== void 0);
+    const existingTokenIds = [...new Set(tokenIds)];
+    if (existingTokenIds.length > 0) {
+      return existingTokenIds;
+    }
+    const overrideTokenId = this.getOverrideId("token", token);
+    this.ensureSyntheticService(overrideTokenId, void 0);
+    return [overrideTokenId];
+  }
+  getOverrideClassServiceId(ClassDefinition) {
+    const registeredServiceId = this.findRegisteredServiceId(ClassDefinition);
+    if (registeredServiceId) {
+      return registeredServiceId;
+    }
+    const overrideClassId = this.getOverrideId("class", ClassDefinition);
+    this.container.register(overrideClassId, ClassDefinition);
+    return overrideClassId;
+  }
+  applyClassOverride(override) {
+    if (!("useClass" in override)) {
+      return;
+    }
+    const tokenIds = this.getOverrideTokenIds(override.token);
+    const classId = this.getOverrideClassServiceId(override.useClass);
+    this.overrideTokenIds.set(override.token, tokenIds[0]);
+    for (const tokenId of tokenIds) {
+      this.container.setAlias(tokenId, classId);
+    }
+  }
+  applyFactoryOverride(override) {
+    if (!("useFactory" in override)) {
+      return;
+    }
+    const tokenIds = this.getOverrideTokenIds(override.token);
+    const factoryId = this.getOverrideId("factory", override.token);
+    this.ensureSyntheticService(factoryId, override.useFactory(this));
+    this.overrideTokenIds.set(override.token, tokenIds[0]);
+    for (const tokenId of tokenIds) {
+      this.container.setAlias(tokenId, factoryId);
+    }
+  }
+  applyValueOverride(override) {
+    if (!("useValue" in override)) {
+      return;
+    }
+    const tokenIds = this.getOverrideTokenIds(override.token);
+    const valueId = this.getOverrideId("value", override.token);
+    this.ensureSyntheticService(valueId, override.useValue);
+    this.overrideTokenIds.set(override.token, tokenIds[0]);
+    for (const tokenId of tokenIds) {
+      this.container.setAlias(tokenId, valueId);
+    }
+  }
+  applyOverrides() {
+    for (const override of this.options.overrides ?? []) {
+      this.applyClassOverride(override);
+      this.applyFactoryOverride(override);
+      this.applyValueOverride(override);
+    }
+  }
   registerParentAliases() {
     for (const [id, definition] of this.definitions.entries()) {
       if (definition._abstract === true || !definition._parent) {
@@ -113,17 +224,22 @@ var DependencyInjection = class _DependencyInjection {
       await this.loader.load(this.options.servicesYamlPath);
     }
     this.registerParentAliases();
+    this.applyOverrides();
     await this.container.compile();
   }
   getService(serviceName) {
-    const childServiceId = this.findConcreteChildServiceId(serviceName);
-    if (childServiceId) {
-      return this.container.get(childServiceId);
+    const overrideTokenId = this.overrideTokenIds.get(serviceName);
+    if (overrideTokenId) {
+      return this.container.get(overrideTokenId);
     }
     const aliasServiceId = this.findAliasServiceId(serviceName);
     if (aliasServiceId) {
       return this.container.get(aliasServiceId);
     }
+    const childServiceId = this.findConcreteChildServiceId(serviceName);
+    if (childServiceId) {
+      return this.container.get(childServiceId);
+    }
     const registeredServiceId = this.findRegisteredServiceId(serviceName);
     if (registeredServiceId) {
       return this.container.get(registeredServiceId);

package/dist/infrastructure/dependency-injection/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/infrastructure/dependency-injection/DependencyInjection.ts"],"sourcesContent":["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';\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\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 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 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 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    await this.container.compile();\n  }\n\n  public getService<T>(serviceName: unknown): T {\n    const childServiceId = this.findConcreteChildServiceId(serviceName);\n\n    if (childServiceId) {\n      return this.container.get<T>(childServiceId);\n    }\n\n    const aliasServiceId = this.findAliasServiceId(serviceName);\n\n    if (aliasServiceId) {\n      return this.container.get<T>(aliasServiceId);\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"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/infrastructure/dependency-injection/DependencyInjection.ts"],"sourcesContent":["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"],"mappings":"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","names":[]}

package/dist/infrastructure/express/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,39 +17,114 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/infrastructure/express/index.ts
 var express_exports = {};
 __export(express_exports, {
   ExpressKernelServer: () => ExpressKernelServer,
+  HttpErrorHandler: () => HttpErrorHandler,
   RoutePrefix: () => RoutePrefix
 });
 module.exports = __toCommonJS(express_exports);
 
 // src/adapters/ui/express/ExpressKernelServer.ts
-var import_routing_controllers = require("routing-controllers");
+var import_node_module = require("module");
+var import_node_path = __toESM(require("path"), 1);
 var ExpressKernelServer = class {
   constructor(options) {
     this.options = options;
+    this.afterControllersHooks = this.copy(options.afterControllersHooks);
+    this.beforeControllersHooks = this.copy(options.beforeControllersHooks);
+    this.controllers = this.copy(options.controllers);
+    this.errorHandlers = this.copy(options.errorHandlers);
+    this.hooks = this.copy(options.hooks);
+    this.middlewares = this.copy(options.middlewares);
+    this.postControllerMiddlewares = this.copy(
+      options.postControllerMiddlewares
+    );
+    this.preControllerMiddlewares = this.copy(options.preControllerMiddlewares);
+    this.staticHooks = this.copy(options.staticHooks);
+    this.swaggerHooks = this.copy(options.swaggerHooks);
   }
   options;
+  applicationRequire = (0, import_node_module.createRequire)(
+    import_node_path.default.resolve(process.cwd(), "package.json")
+  );
+  afterControllersHooks;
   appInstance;
+  beforeControllersHooks;
+  controllers;
+  errorHandlers;
+  hooks;
+  middlewares;
+  postControllerMiddlewares;
+  preControllerMiddlewares;
   serverInstance;
-  registerErrorHandlers(app) {
-    const handlers = this.options.errorHandlers ?? [this.defaultErrorHandler()];
+  staticHooks;
+  swaggerHooks;
+  copy(items) {
+    return [...items ?? []];
+  }
+  configureControllerContainer() {
+    const { useContainer } = this.getRoutingControllers();
+    useContainer(
+      {
+        /* c8 ignore next */
+        get: (ClassDefinition) => this.options.kernel.di.getService(ClassDefinition)
+      },
+      {
+        fallback: true,
+        fallbackOnErrors: true
+      }
+    );
+  }
+  getExpress() {
+    return this.applicationRequire("express");
+  }
+  getRoutingControllers() {
+    return this.applicationRequire("routing-controllers");
+  }
+  applyErrorHandlers(app) {
+    const handlers = this.errorHandlers.length > 0 ? this.errorHandlers : [this.defaultErrorHandler()];
     for (const handler of handlers) {
       app.use(handler);
     }
   }
   defaultErrorHandler() {
-    return (error, request, response) => {
+    return (error, request, response, next) => {
+      void next;
       void request;
       response.status(500).json({
         error: error instanceof Error ? error.message : String(error)
       });
     };
   }
+  async runHooks(hooks, app) {
+    for (const hook of hooks) {
+      await hook(app);
+    }
+  }
+  async runPhaseHooks(phase, app) {
+    for (const hook of this.hooks) {
+      if (hook.phase === phase) {
+        await hook.handle(app);
+      }
+    }
+  }
+  applyMiddlewares(app, middlewares) {
+    for (const middleware of middlewares) {
+      app.use(middleware);
+    }
+  }
   get app() {
     if (!this.appInstance) {
       throw new Error("HTTP server is not running.");
@@ -60,6 +137,11 @@ var ExpressKernelServer = class {
     }
     return this.serverInstance;
   }
+  assertServerIsNotRunning() {
+    if (this.serverInstance) {
+      throw new Error("HTTP server is already running.");
+    }
+  }
   close() {
     if (!this.serverInstance) {
       return Promise.resolve();
@@ -76,15 +158,74 @@ var ExpressKernelServer = class {
       });
     });
   }
-  run() {
-    const app = (0, import_routing_controllers.createExpressServer)({
-      controllers: this.options.kernel.getRoutes(),
+  registerAfterControllersHooks(...hooks) {
+    this.assertServerIsNotRunning();
+    this.afterControllersHooks?.push(...hooks);
+    return this;
+  }
+  registerBeforeControllersHooks(...hooks) {
+    this.assertServerIsNotRunning();
+    this.beforeControllersHooks?.push(...hooks);
+    return this;
+  }
+  registerControllers(...controllers) {
+    this.assertServerIsNotRunning();
+    this.controllers.push(...controllers);
+    return this;
+  }
+  registerErrorHandlers(...handlers) {
+    this.assertServerIsNotRunning();
+    this.errorHandlers.push(...handlers);
+    return this;
+  }
+  registerHooks(...hooks) {
+    this.assertServerIsNotRunning();
+    this.hooks.push(...hooks);
+    return this;
+  }
+  registerMiddlewares(...middlewares) {
+    this.assertServerIsNotRunning();
+    this.middlewares.push(...middlewares);
+    return this;
+  }
+  registerPostControllerMiddlewares(...middlewares) {
+    this.assertServerIsNotRunning();
+    this.postControllerMiddlewares.push(...middlewares);
+    return this;
+  }
+  registerPreControllerMiddlewares(...middlewares) {
+    this.assertServerIsNotRunning();
+    this.preControllerMiddlewares.push(...middlewares);
+    return this;
+  }
+  async run() {
+    if (this.serverInstance) {
+      throw new Error("HTTP server is already running.");
+    }
+    const controllers = [
+      ...this.options.kernel.getRoutes(),
+      ...this.controllers
+    ];
+    const express = this.getExpress();
+    const { useExpressServer } = this.getRoutingControllers();
+    const app = express();
+    this.applyMiddlewares(app, this.middlewares);
+    this.applyMiddlewares(app, this.preControllerMiddlewares);
+    await this.runHooks(this.beforeControllersHooks, app);
+    await this.runPhaseHooks("beforeControllers", app);
+    this.configureControllerContainer();
+    useExpressServer(app, {
+      ...this.options.routingControllersOptions,
+      controllers,
       routePrefix: this.options.routePrefix
     });
-    for (const middleware of this.options.middlewares ?? []) {
-      app.use(middleware);
-    }
-    this.registerErrorHandlers(app);
+    this.applyMiddlewares(app, this.postControllerMiddlewares);
+    await this.runHooks(this.afterControllersHooks, app);
+    await this.runPhaseHooks("afterControllers", app);
+    await this.runHooks(this.swaggerHooks, app);
+    await this.runHooks(this.staticHooks, app);
+    await this.runPhaseHooks("beforeErrors", app);
+    this.applyErrorHandlers(app);
     this.appInstance = app;
     return new Promise((resolve) => {
       this.serverInstance = app.listen(this.options.port ?? 3e3, () => {
@@ -94,6 +235,132 @@ var ExpressKernelServer = class {
   }
 };
 
+// src/adapters/ui/express/HttpErrorHandler.ts
+var import_routing_controllers = require("routing-controllers");
+
+// src/contracts/ui/HttpRouteStatusEnum.ts
+var HttpRouteStatusEnum = {
+  BAD_REQUEST: 400,
+  CONFLICT: 409,
+  CREATED: 201,
+  DEPRECATED: 299,
+  FORBIDDEN: 403,
+  INTERNAL_SERVER_ERROR: 500,
+  NO_CONTENT: 204,
+  NOT_FOUND: 404,
+  OK: 200,
+  PAYLOAD_TOO_LARGE: 413,
+  SERVICE_UNAVAILABLE: 503,
+  TOO_MANY_REQUESTS: 429,
+  UNAUTHORIZED: 401,
+  UNPROCESSABLE_ENTITY: 422
+};
+
+// src/adapters/ui/express/HttpErrorHandler.ts
+var HttpErrorHandler = class {
+  constructor(options = {}) {
+    this.options = options;
+    this.handlers = options.handlers ?? [];
+    this.exposeUnhandledErrorsIn = options.exposeUnhandledErrorsIn ?? [
+      "local",
+      "test"
+    ];
+  }
+  options;
+  handlers;
+  exposeUnhandledErrorsIn;
+  formatValidationErrors(errors) {
+    return errors.flatMap((error) => {
+      if (error.children && error.children.length > 0) {
+        return this.formatValidationErrors(error.children);
+      }
+      return [
+        {
+          details: error.constraints,
+          property: error.property,
+          value: error.value
+        }
+      ];
+    });
+  }
+  getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+  }
+  getHttpStatus(error) {
+    return error.httpCode ?? error.statusCode ?? error.status;
+  }
+  isPayloadTooLargeError(error) {
+    return error.type === "entity.too.large" || this.getHttpStatus(error) === HttpRouteStatusEnum.PAYLOAD_TOO_LARGE;
+  }
+  logUnhandledError(error) {
+    this.options.logger?.error(`Unhandled error: ${error.message}`);
+    this.options.logger?.debug(error.stack ?? "No stack trace available");
+  }
+  handleSyntaxError(error, response) {
+    if (!(error instanceof SyntaxError)) {
+      return false;
+    }
+    response.status(HttpRouteStatusEnum.BAD_REQUEST).json({
+      code: "SyntaxError",
+      message: "Malformed JSON"
+    });
+    return true;
+  }
+  handlePayloadTooLargeError(error, response) {
+    if (!this.isPayloadTooLargeError(error)) {
+      return false;
+    }
+    response.status(HttpRouteStatusEnum.PAYLOAD_TOO_LARGE).json({
+      code: "PayloadTooLargeError",
+      httpStatus: HttpRouteStatusEnum.PAYLOAD_TOO_LARGE,
+      message: "Request entity too large."
+    });
+    return true;
+  }
+  handleHttpError(error, response) {
+    const httpError = error;
+    const httpStatus = this.getHttpStatus(httpError);
+    if (!httpStatus && !(error instanceof import_routing_controllers.HttpError)) {
+      return false;
+    }
+    response.status(httpStatus ?? HttpRouteStatusEnum.INTERNAL_SERVER_ERROR).json({
+      code: error.name,
+      errors: this.formatValidationErrors(
+        error.errors ?? []
+      ),
+      httpStatus: httpStatus ?? HttpRouteStatusEnum.INTERNAL_SERVER_ERROR,
+      message: error.message
+    });
+    return true;
+  }
+  handleUnhandledError(error, response) {
+    if (this.exposeUnhandledErrorsIn.includes(process.env.NODE_ENV ?? "")) {
+      this.logUnhandledError(error);
+    }
+    response.status(HttpRouteStatusEnum.INTERNAL_SERVER_ERROR).json({
+      code: error.constructor.name || String(HttpRouteStatusEnum.INTERNAL_SERVER_ERROR),
+      message: error.message || "Unknown error"
+    });
+  }
+  error(error, request, response, next) {
+    void request;
+    const handlers = [
+      this.handleSyntaxError.bind(this),
+      this.handlePayloadTooLargeError.bind(this),
+      ...this.handlers,
+      this.handleHttpError.bind(this)
+    ];
+    if (handlers.some((handler) => handler(error, response))) {
+      return;
+    }
+    void next;
+    this.handleUnhandledError(error, response);
+  }
+  handle = (error, request, response, next) => {
+    this.error(error, request, response, next);
+  };
+};
+
 // src/adapters/ui/express/RoutePrefix.ts
 var RoutePrefix = class _RoutePrefix {
   value;
@@ -121,6 +388,7 @@ var RoutePrefix = class _RoutePrefix {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ExpressKernelServer,
+  HttpErrorHandler,
   RoutePrefix
 });
 //# sourceMappingURL=index.cjs.map