@sentzunhat/zacatl 0.0.24 → 0.0.25

package/build/dependency-injection/container.d.ts

@@ -5,5 +5,7 @@ export declare const registerDependency: <T>(token: InjectionToken<T>, implement
 export declare const registerSingleton: <T>(token: InjectionToken<T>, implementation: new (...args: unknown[]) => T) => void;
 export declare const registerValue: <T>(token: InjectionToken<T>, value: T) => void;
 export declare const resolveDependency: <T>(token: InjectionToken<T>) => T;
+export declare const registerWithDependencies: <T>(serviceClass: new (...args: unknown[]) => T, dependencies?: Array<new (...args: unknown[]) => unknown>) => void;
+export declare const registerSingletonWithDependencies: <T>(serviceClass: new (...args: unknown[]) => T, dependencies?: Array<new (...args: unknown[]) => unknown>) => void;
 export declare const clearContainer: () => void;
 //# sourceMappingURL=container.d.ts.map

package/build/dependency-injection/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"./src/","sources":["dependency-injection/container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAiCpE,eAAO,MAAM,YAAY,QAAO,mBAE/B,CAAC;AAQF,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAClC,OAAO,cAAc,CAAC,CAAC,CAAC,EACxB,gBAAgB,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,KAC5C,IAEF,CAAC;AAQF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EACjC,OAAO,cAAc,CAAC,CAAC,CAAC,EACxB,gBAAgB,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,KAC5C,IAEF,CAAC;AAQF,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KAAG,IAErE,CAAC;AAQF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,OAAO,cAAc,CAAC,CAAC,CAAC,KAAG,CAE/D,CAAC;AAKF,eAAO,MAAM,cAAc,QAAO,IAGjC,CAAC"}
+{"version":3,"file":"container.d.ts","sourceRoot":"./src/","sources":["dependency-injection/container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAiCpE,eAAO,MAAM,YAAY,QAAO,mBAE/B,CAAC;AAQF,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAClC,OAAO,cAAc,CAAC,CAAC,CAAC,EACxB,gBAAgB,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,KAC5C,IAEF,CAAC;AAQF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EACjC,OAAO,cAAc,CAAC,CAAC,CAAC,EACxB,gBAAgB,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,KAC5C,IAEF,CAAC;AAQF,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KAAG,IAErE,CAAC;AAQF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,OAAO,cAAc,CAAC,CAAC,CAAC,KAAG,CAE/D,CAAC;AAoBF,eAAO,MAAM,wBAAwB,GAAI,CAAC,EACxC,cAAc,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAC3C,eAAc,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAM,KAC5D,IAOF,CAAC;AAiBF,eAAO,MAAM,iCAAiC,GAAI,CAAC,EACjD,cAAc,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAC3C,eAAc,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAM,KAC5D,IAOF,CAAC;AAKF,eAAO,MAAM,cAAc,QAAO,IAGjC,CAAC"}

package/build/dependency-injection/container.js

@@ -15,6 +15,22 @@ export const registerValue = (token, value) => {
 export const resolveDependency = (token) => {
     return tsyringeContainer.resolve(token);
 };
+export const registerWithDependencies = (serviceClass, dependencies = []) => {
+    tsyringeContainer.register(serviceClass, {
+        useFactory: (c) => {
+            const resolvedDeps = dependencies.map((dep) => c.resolve(dep));
+            return new serviceClass(...resolvedDeps);
+        },
+    });
+};
+export const registerSingletonWithDependencies = (serviceClass, dependencies = []) => {
+    tsyringeContainer.registerSingleton(serviceClass, {
+        useFactory: (c) => {
+            const resolvedDeps = dependencies.map((dep) => c.resolve(dep));
+            return new serviceClass(...resolvedDeps);
+        },
+    });
+};
 export const clearContainer = () => {
     tsyringeContainer.clearInstances();
     tsyringeContainer.reset();

package/build/dependency-injection/container.js.map

@@ -1 +1 @@
-{"version":3,"file":"container.js","sourceRoot":"./src/","sources":["dependency-injection/container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,IAAI,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAkC1D,MAAM,CAAC,MAAM,YAAY,GAAG,GAAwB,EAAE;IACpD,OAAO,iBAAiB,CAAC;AAC3B,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAwB,EACxB,cAA6C,EACvC,EAAE;IACR,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;AAClE,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,KAAwB,EACxB,cAA6C,EACvC,EAAE;IACR,iBAAiB,CAAC,iBAAiB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AAC7D,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAI,KAAwB,EAAE,KAAQ,EAAQ,EAAE;IAC3E,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACzD,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAI,KAAwB,EAAK,EAAE;IAClE,OAAO,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC,CAAC;AAKF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAS,EAAE;IACvC,iBAAiB,CAAC,cAAc,EAAE,CAAC;IACnC,iBAAiB,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC,CAAC","sourcesContent":["import \"reflect-metadata\";\nimport { container as tsyringeContainer } from \"tsyringe\";\nimport type { DependencyContainer, InjectionToken } from \"tsyringe\";\n\n/**\n * Standalone DI container decoupled from microservice architecture.\n * Automatically used by Service architecture - typically no manual registration needed.\n *\n * For advanced use cases, you can register dependencies manually:\n *\n * @example\n * ```typescript\n * import { registerDependency, resolveDependency } from '@sentzunhat/zacatl';\n *\n * // Manual registration (advanced use case)\n * class CustomService { ... }\n * registerDependency('CustomService', CustomService);\n *\n * // Resolve manually\n * const service = resolveDependency<CustomService>('CustomService');\n * ```\n *\n * Preferred approach (automatic registration through Service):\n * ```typescript\n * const service = new Service({\n *   architecture: {\n *     domain: { providers: [CustomService] }\n *   }\n * });\n * ```\n */\n\n/**\n * Get the global DI container instance\n */\nexport const getContainer = (): DependencyContainer => {\n  return tsyringeContainer;\n};\n\n/**\n * Register a dependency in the container\n *\n * @param token - Unique identifier for the dependency\n * @param implementation - Class or value to register\n */\nexport const registerDependency = <T>(\n  token: InjectionToken<T>,\n  implementation: new (...args: unknown[]) => T,\n): void => {\n  tsyringeContainer.register(token, { useClass: implementation });\n};\n\n/**\n * Register a singleton dependency (shared instance)\n *\n * @param token - Unique identifier for the dependency\n * @param implementation - Class to register as singleton\n */\nexport const registerSingleton = <T>(\n  token: InjectionToken<T>,\n  implementation: new (...args: unknown[]) => T,\n): void => {\n  tsyringeContainer.registerSingleton(token, implementation);\n};\n\n/**\n * Register a value (instance) in the container\n *\n * @param token - Unique identifier for the dependency\n * @param value - Instance to register\n */\nexport const registerValue = <T>(token: InjectionToken<T>, value: T): void => {\n  tsyringeContainer.register(token, { useValue: value });\n};\n\n/**\n * Resolve a dependency from the container\n *\n * @param token - Unique identifier for the dependency\n * @returns Resolved instance\n */\nexport const resolveDependency = <T>(token: InjectionToken<T>): T => {\n  return tsyringeContainer.resolve(token);\n};\n\n/**\n * Clear all registrations (useful for testing)\n */\nexport const clearContainer = (): void => {\n  tsyringeContainer.clearInstances();\n  tsyringeContainer.reset();\n};\n"]}
+{"version":3,"file":"container.js","sourceRoot":"./src/","sources":["dependency-injection/container.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,IAAI,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAkC1D,MAAM,CAAC,MAAM,YAAY,GAAG,GAAwB,EAAE;IACpD,OAAO,iBAAiB,CAAC;AAC3B,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAwB,EACxB,cAA6C,EACvC,EAAE;IACR,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;AAClE,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,KAAwB,EACxB,cAA6C,EACvC,EAAE;IACR,iBAAiB,CAAC,iBAAiB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AAC7D,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAI,KAAwB,EAAE,KAAQ,EAAQ,EAAE;IAC3E,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACzD,CAAC,CAAC;AAQF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAI,KAAwB,EAAK,EAAE;IAClE,OAAO,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC,CAAC;AAoBF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,YAA2C,EAC3C,eAA2D,EAAE,EACvD,EAAE;IACR,iBAAiB,CAAC,QAAQ,CAAC,YAAY,EAAE;QACvC,UAAU,EAAE,CAAC,CAAsB,EAAE,EAAE;YACrC,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/D,OAAO,IAAI,YAAY,CAAC,GAAG,YAAY,CAAC,CAAC;QAC3C,CAAC;KACO,CAAC,CAAC;AACd,CAAC,CAAC;AAiBF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,YAA2C,EAC3C,eAA2D,EAAE,EACvD,EAAE;IACR,iBAAiB,CAAC,iBAAiB,CAAC,YAAY,EAAE;QAChD,UAAU,EAAE,CAAC,CAAsB,EAAE,EAAE;YACrC,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/D,OAAO,IAAI,YAAY,CAAC,GAAG,YAAY,CAAC,CAAC;QAC3C,CAAC;KACO,CAAC,CAAC;AACd,CAAC,CAAC;AAKF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAS,EAAE;IACvC,iBAAiB,CAAC,cAAc,EAAE,CAAC;IACnC,iBAAiB,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC,CAAC","sourcesContent":["import \"reflect-metadata\";\nimport { container as tsyringeContainer } from \"tsyringe\";\nimport type { DependencyContainer, InjectionToken } from \"tsyringe\";\n\n/**\n * Standalone DI container decoupled from microservice architecture.\n * Automatically used by Service architecture - typically no manual registration needed.\n *\n * For advanced use cases, you can register dependencies manually:\n *\n * @example\n * ```typescript\n * import { registerDependency, resolveDependency } from '@sentzunhat/zacatl';\n *\n * // Manual registration (advanced use case)\n * class CustomService { ... }\n * registerDependency('CustomService', CustomService);\n *\n * // Resolve manually\n * const service = resolveDependency<CustomService>('CustomService');\n * ```\n *\n * Preferred approach (automatic registration through Service):\n * ```typescript\n * const service = new Service({\n *   architecture: {\n *     domain: { providers: [CustomService] }\n *   }\n * });\n * ```\n */\n\n/**\n * Get the global DI container instance\n */\nexport const getContainer = (): DependencyContainer => {\n  return tsyringeContainer;\n};\n\n/**\n * Register a dependency in the container\n *\n * @param token - Unique identifier for the dependency\n * @param implementation - Class or value to register\n */\nexport const registerDependency = <T>(\n  token: InjectionToken<T>,\n  implementation: new (...args: unknown[]) => T,\n): void => {\n  tsyringeContainer.register(token, { useClass: implementation });\n};\n\n/**\n * Register a singleton dependency (shared instance)\n *\n * @param token - Unique identifier for the dependency\n * @param implementation - Class to register as singleton\n */\nexport const registerSingleton = <T>(\n  token: InjectionToken<T>,\n  implementation: new (...args: unknown[]) => T,\n): void => {\n  tsyringeContainer.registerSingleton(token, implementation);\n};\n\n/**\n * Register a value (instance) in the container\n *\n * @param token - Unique identifier for the dependency\n * @param value - Instance to register\n */\nexport const registerValue = <T>(token: InjectionToken<T>, value: T): void => {\n  tsyringeContainer.register(token, { useValue: value });\n};\n\n/**\n * Resolve a dependency from the container\n *\n * @param token - Unique identifier for the dependency\n * @returns Resolved instance\n */\nexport const resolveDependency = <T>(token: InjectionToken<T>): T => {\n  return tsyringeContainer.resolve(token);\n};\n\n/**\n * Register a dependency with explicit dependencies (no decorator metadata required)\n * Useful for tsx/ts-node/ESM environments where decorator metadata is not available\n *\n * @param serviceClass - Class to register\n * @param dependencies - Array of dependency classes to inject (in constructor order)\n *\n * @example\n * ```typescript\n * import { registerWithDependencies } from '@sentzunhat/zacatl';\n *\n * // Register with no deps\n * registerWithDependencies(MachineRepository, []);\n *\n * // Register with explicit deps\n * registerWithDependencies(MachineService, [MachineRepository]);\n * ```\n */\nexport const registerWithDependencies = <T>(\n  serviceClass: new (...args: unknown[]) => T,\n  dependencies: Array<new (...args: unknown[]) => unknown> = [],\n): void => {\n  tsyringeContainer.register(serviceClass, {\n    useFactory: (c: DependencyContainer) => {\n      const resolvedDeps = dependencies.map((dep) => c.resolve(dep));\n      return new serviceClass(...resolvedDeps);\n    },\n  } as never);\n};\n\n/**\n * Register a singleton with explicit dependencies (no decorator metadata required)\n * Useful for tsx/ts-node/ESM environments where decorator metadata is not available\n *\n * @param serviceClass - Class to register as singleton\n * @param dependencies - Array of dependency classes to inject (in constructor order)\n *\n * @example\n * ```typescript\n * import { registerSingletonWithDependencies } from '@sentzunhat/zacatl';\n *\n * // Register singleton with deps\n * registerSingletonWithDependencies(MachineService, [MachineRepository]);\n * ```\n */\nexport const registerSingletonWithDependencies = <T>(\n  serviceClass: new (...args: unknown[]) => T,\n  dependencies: Array<new (...args: unknown[]) => unknown> = [],\n): void => {\n  tsyringeContainer.registerSingleton(serviceClass, {\n    useFactory: (c: DependencyContainer) => {\n      const resolvedDeps = dependencies.map((dep) => c.resolve(dep));\n      return new serviceClass(...resolvedDeps);\n    },\n  } as never);\n};\n\n/**\n * Clear all registrations (useful for testing)\n */\nexport const clearContainer = (): void => {\n  tsyringeContainer.clearInstances();\n  tsyringeContainer.reset();\n};\n"]}

package/build/service/architecture/architecture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"architecture.d.ts","sourceRoot":"./src/","sources":["service/architecture/architecture.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAErE,KAAK,YAAY,GAAG;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,8BAAsB,oBAAqB,YAAW,YAAY;IAKhE,SAAS,CAAC,oBAAoB,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAe5E,SAAS,CAAC,4BAA4B,CAAC,CAAC,EACtC,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,EAChC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,GAChB,IAAI;aAaS,KAAK,IAAI,IAAI;CAC9B"}
+{"version":3,"file":"architecture.d.ts","sourceRoot":"./src/","sources":["service/architecture/architecture.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAErE,KAAK,YAAY,GAAG;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,8BAAsB,oBAAqB,YAAW,YAAY;IAKhE,SAAS,CAAC,oBAAoB,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAc5E,SAAS,CAAC,4BAA4B,CAAC,CAAC,EACtC,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,EAChC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,GAChB,IAAI;aAaS,KAAK,IAAI,IAAI;CAC9B"}

package/build/service/architecture/architecture.js

@@ -2,7 +2,6 @@ import { container } from "tsyringe";
 export class AbstractArchitecture {
     registerDependencies(dependencies) {
         for (const dependency of dependencies) {
-            const instance = new dependency();
             container.register(dependency.name, {
                 useClass: dependency,
             });

package/build/service/architecture/architecture.js.map

@@ -1 +1 @@
-{"version":3,"file":"architecture.js","sourceRoot":"./src/","sources":["service/architecture/architecture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAQrC,MAAM,OAAgB,oBAAoB;IAK9B,oBAAoB,CAAI,YAAmC;QACnE,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,IAAI,UAAU,EAAE,CAAC;YAElC,SAAS,CAAC,QAAQ,CAAkB,UAAU,CAAC,IAAI,EAAE;gBACnD,QAAQ,EAAE,UAAU;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAOS,4BAA4B,CACpC,YAAgC,EAChC,OAAiB;QAEjB,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;YACtC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAE9D,MAAM,QAAQ,GAAG,IAAI,UAAU,EAAE,CAAC;YAElC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAkB,UAAU,CAAC,IAAI,CAAC,CAAC;YAEzE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CAIF","sourcesContent":["import { container } from \"tsyringe\";\n\nexport type Constructor<T = unknown> = new (...args: unknown[]) => T;\n\ntype Architecture = {\n  start: () => void;\n};\n\nexport abstract class AbstractArchitecture implements Architecture {\n  /**\n   * A generic helper method to register an array of handler classes.\n   * @param handlers - An array of class constructors that implement the handler functionality.\n   */\n  protected registerDependencies<T>(dependencies: Array<Constructor<T>>): void {\n    for (const dependency of dependencies) {\n      const instance = new dependency();\n\n      container.register<typeof instance>(dependency.name, {\n        useClass: dependency,\n      });\n    }\n  }\n\n  /**\n   * A generic helper method to register an array of handler classes.\n   * @param handlers - An array of class constructors that implement the handler functionality.\n   * @param storage - An array where the resolved instances of handlers will be stored.\n   */\n  protected registerAndStoreDependencies<T>(\n    dependencies: Array<new () => T>,\n    storage: Array<T>\n  ): void {\n    for (const dependency of dependencies) {\n      container.register(dependency.name, { useClass: dependency });\n\n      const instance = new dependency();\n\n      const routeHandler = container.resolve<typeof instance>(dependency.name);\n\n      storage.push(routeHandler);\n    }\n  }\n\n  // Abstract start method, to be implemented by subclasses.\n  public abstract start(): void;\n}\n"]}
+{"version":3,"file":"architecture.js","sourceRoot":"./src/","sources":["service/architecture/architecture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAQrC,MAAM,OAAgB,oBAAoB;IAK9B,oBAAoB,CAAI,YAAmC;QACnE,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;YAEtC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE;gBAClC,QAAQ,EAAE,UAAU;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAOS,4BAA4B,CACpC,YAAgC,EAChC,OAAiB;QAEjB,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;YACtC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAE9D,MAAM,QAAQ,GAAG,IAAI,UAAU,EAAE,CAAC;YAElC,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAkB,UAAU,CAAC,IAAI,CAAC,CAAC;YAEzE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;CAIF","sourcesContent":["import { container } from \"tsyringe\";\n\nexport type Constructor<T = unknown> = new (...args: unknown[]) => T;\n\ntype Architecture = {\n  start: () => void;\n};\n\nexport abstract class AbstractArchitecture implements Architecture {\n  /**\n   * A generic helper method to register an array of handler classes.\n   * @param handlers - An array of class constructors that implement the handler functionality.\n   */\n  protected registerDependencies<T>(dependencies: Array<Constructor<T>>): void {\n    for (const dependency of dependencies) {\n      // Register class directly - tsyringe handles instantiation with DI\n      container.register(dependency.name, {\n        useClass: dependency,\n      });\n    }\n  }\n\n  /**\n   * A generic helper method to register an array of handler classes.\n   * @param handlers - An array of class constructors that implement the handler functionality.\n   * @param storage - An array where the resolved instances of handlers will be stored.\n   */\n  protected registerAndStoreDependencies<T>(\n    dependencies: Array<new () => T>,\n    storage: Array<T>,\n  ): void {\n    for (const dependency of dependencies) {\n      container.register(dependency.name, { useClass: dependency });\n\n      const instance = new dependency();\n\n      const routeHandler = container.resolve<typeof instance>(dependency.name);\n\n      storage.push(routeHandler);\n    }\n  }\n\n  // Abstract start method, to be implemented by subclasses.\n  public abstract start(): void;\n}\n"]}

package/package.json

@@ -4,7 +4,7 @@
   "main": "build/index.js",
   "module": "build/index.js",
   "types": "build/index.d.ts",
-  "version": "0.0.24",
+  "version": "0.0.25",
   "packageManager": "npm@10.9.0",
   "exports": {
     ".": {

package/src/dependency-injection/container.ts

@@ -83,6 +83,63 @@ export const resolveDependency = <T>(token: InjectionToken<T>): T => {
   return tsyringeContainer.resolve(token);
 };
 
+/**
+ * Register a dependency with explicit dependencies (no decorator metadata required)
+ * Useful for tsx/ts-node/ESM environments where decorator metadata is not available
+ *
+ * @param serviceClass - Class to register
+ * @param dependencies - Array of dependency classes to inject (in constructor order)
+ *
+ * @example
+ * ```typescript
+ * import { registerWithDependencies } from '@sentzunhat/zacatl';
+ *
+ * // Register with no deps
+ * registerWithDependencies(MachineRepository, []);
+ *
+ * // Register with explicit deps
+ * registerWithDependencies(MachineService, [MachineRepository]);
+ * ```
+ */
+export const registerWithDependencies = <T>(
+  serviceClass: new (...args: unknown[]) => T,
+  dependencies: Array<new (...args: unknown[]) => unknown> = [],
+): void => {
+  tsyringeContainer.register(serviceClass, {
+    useFactory: (c: DependencyContainer) => {
+      const resolvedDeps = dependencies.map((dep) => c.resolve(dep));
+      return new serviceClass(...resolvedDeps);
+    },
+  } as never);
+};
+
+/**
+ * Register a singleton with explicit dependencies (no decorator metadata required)
+ * Useful for tsx/ts-node/ESM environments where decorator metadata is not available
+ *
+ * @param serviceClass - Class to register as singleton
+ * @param dependencies - Array of dependency classes to inject (in constructor order)
+ *
+ * @example
+ * ```typescript
+ * import { registerSingletonWithDependencies } from '@sentzunhat/zacatl';
+ *
+ * // Register singleton with deps
+ * registerSingletonWithDependencies(MachineService, [MachineRepository]);
+ * ```
+ */
+export const registerSingletonWithDependencies = <T>(
+  serviceClass: new (...args: unknown[]) => T,
+  dependencies: Array<new (...args: unknown[]) => unknown> = [],
+): void => {
+  tsyringeContainer.registerSingleton(serviceClass, {
+    useFactory: (c: DependencyContainer) => {
+      const resolvedDeps = dependencies.map((dep) => c.resolve(dep));
+      return new serviceClass(...resolvedDeps);
+    },
+  } as never);
+};
+
 /**
  * Clear all registrations (useful for testing)
  */

package/src/service/architecture/architecture.ts

@@ -13,9 +13,8 @@ export abstract class AbstractArchitecture implements Architecture {
    */
   protected registerDependencies<T>(dependencies: Array<Constructor<T>>): void {
     for (const dependency of dependencies) {
-      const instance = new dependency();
-
-      container.register<typeof instance>(dependency.name, {
+      // Register class directly - tsyringe handles instantiation with DI
+      container.register(dependency.name, {
         useClass: dependency,
       });
     }
@@ -28,7 +27,7 @@ export abstract class AbstractArchitecture implements Architecture {
    */
   protected registerAndStoreDependencies<T>(
     dependencies: Array<new () => T>,
-    storage: Array<T>
+    storage: Array<T>,
   ): void {
     for (const dependency of dependencies) {
       container.register(dependency.name, { useClass: dependency });