composed-di 0.0.3 → 0.0.5-alpha

package/dist/serviceFactory.js

@@ -9,36 +9,46 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.singletonFactory = singletonFactory;
-exports.oneShotFactory = oneShotFactory;
-function singletonFactory({ provides, dependsOn = [], initialize, dispose = () => { }, }) {
-    let instance;
-    return {
-        provides,
-        dependsOn,
-        initialize(...dependencies) {
-            return __awaiter(this, void 0, void 0, function* () {
-                if (instance) {
+exports.ServiceFactory = void 0;
+class ServiceFactory {
+    /**
+     * Creates a singleton service factory that ensures a single instance of the provided service is initialized
+     * and used throughout its lifecycle.
+     */
+    static singleton({ provides, dependsOn = [], initialize, dispose = () => { }, }) {
+        let instance;
+        return {
+            provides,
+            dependsOn,
+            initialize(...dependencies) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    if (instance) {
+                        return instance;
+                    }
+                    instance = yield initialize(...dependencies);
                     return instance;
+                });
+            },
+            dispose(serviceInstance) {
+                if (instance === serviceInstance) {
+                    dispose(serviceInstance);
+                    instance = undefined;
                 }
-                instance = yield initialize(...dependencies);
-                return instance;
-            });
-        },
-        dispose(serviceInstance) {
-            if (instance === serviceInstance) {
-                dispose(serviceInstance);
-                instance = undefined;
-            }
-        },
-    };
+            },
+        };
+    }
+    /**
+     * Creates a one-shot service factory that initializes a new instance of the provided service
+     * every time it is requested.
+     */
+    static oneShot({ provides, dependsOn, initialize, dispose = () => { }, }) {
+        return {
+            provides,
+            dependsOn,
+            initialize,
+            dispose,
+        };
+    }
 }
-function oneShotFactory({ provides, dependsOn, initialize, dispose = () => { }, }) {
-    return {
-        provides,
-        dependsOn,
-        initialize,
-        dispose,
-    };
-}
-//# sourceMappingURL=serviceFactory.js.map
+exports.ServiceFactory = ServiceFactory;
+//# sourceMappingURL=ServiceFactory.js.map

package/dist/serviceFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"serviceFactory.js","sourceRoot":"","sources":["../src/serviceFactory.ts"],"names":[],"mappings":";;;;;;;;;;;AAmBA,4CA8BC;AAED,wCAiBC;AAjDD,SAAgB,gBAAgB,CAA0C,EACxE,QAAQ,EACR,SAAS,GAAG,EAAkB,EAC9B,UAAU,EACV,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,GAMnB;IACC,IAAI,QAAuB,CAAC;IAE5B,OAAO;QACL,QAAQ;QACR,SAAS;QACH,UAAU,CAAC,GAAG,YAAgC;;gBAClD,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,QAAQ,GAAG,MAAM,UAAU,CAAC,GAAG,YAAY,CAAC,CAAC;gBAC7C,OAAO,QAAQ,CAAC;YAClB,CAAC;SAAA;QACD,OAAO,CAAC,eAAkB;YACxB,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;gBACjC,OAAO,CAAC,eAAe,CAAC,CAAC;gBACzB,QAAQ,GAAG,SAAS,CAAC;YACvB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,cAAc,CAA0C,EACtE,QAAQ,EACR,SAAS,EACT,UAAU,EACV,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,GAMnB;IACC,OAAO;QACL,QAAQ;QACR,SAAS;QACT,UAAU;QACV,OAAO;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ServiceFactory.js","sourceRoot":"","sources":["../src/ServiceFactory.ts"],"names":[],"mappings":";;;;;;;;;;;;AAUA,MAAsB,cAAc;IAWlC;;;OAGG;IACH,MAAM,CAAC,SAAS,CAGd,EACA,QAAQ,EACR,SAAS,GAAG,EAAkB,EAC9B,UAAU,EACV,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,GAMnB;QACC,IAAI,QAAuB,CAAC;QAE5B,OAAO;YACL,QAAQ;YACR,SAAS;YACH,UAAU,CAAC,GAAG,YAAgC;;oBAClD,IAAI,QAAQ,EAAE,CAAC;wBACb,OAAO,QAAQ,CAAC;oBAClB,CAAC;oBACD,QAAQ,GAAG,MAAM,UAAU,CAAC,GAAG,YAAY,CAAC,CAAC;oBAC7C,OAAO,QAAQ,CAAC;gBAClB,CAAC;aAAA;YACD,OAAO,CAAC,eAAkB;gBACxB,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;oBACjC,OAAO,CAAC,eAAe,CAAC,CAAC;oBACzB,QAAQ,GAAG,SAAS,CAAC;gBACvB,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAO,CAA+D,EAC3E,QAAQ,EACR,SAAS,EACT,UAAU,EACV,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,GAMnB;QACC,OAAO;YACL,QAAQ;YACR,SAAS;YACT,UAAU;YACV,OAAO;SACR,CAAC;IACJ,CAAC;CACF;AAxED,wCAwEC"}

package/dist/serviceKey.d.ts

@@ -3,4 +3,4 @@ export declare class ServiceKey<T> {
     private readonly symbol;
     constructor(name: string);
 }
-//# sourceMappingURL=serviceKey.d.ts.map
+//# sourceMappingURL=ServiceKey.d.ts.map

package/dist/serviceKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serviceKey.d.ts","sourceRoot":"","sources":["../src/serviceKey.ts"],"names":[],"mappings":"AACA,qBAAa,UAAU,CAAC,CAAC;aAGK,IAAI,EAAE,MAAM;IAFxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEJ,IAAI,EAAE,MAAM;CAGzC"}
+{"version":3,"file":"ServiceKey.d.ts","sourceRoot":"","sources":["../src/ServiceKey.ts"],"names":[],"mappings":"AACA,qBAAa,UAAU,CAAC,CAAC;aAGK,IAAI,EAAE,MAAM;IAFxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEJ,IAAI,EAAE,MAAM;CAGzC"}

package/dist/serviceKey.js

@@ -9,4 +9,4 @@ class ServiceKey {
     }
 }
 exports.ServiceKey = ServiceKey;
-//# sourceMappingURL=serviceKey.js.map
+//# sourceMappingURL=ServiceKey.js.map

package/dist/serviceKey.js.map

@@ -1 +1 @@
-{"version":3,"file":"serviceKey.js","sourceRoot":"","sources":["../src/serviceKey.ts"],"names":[],"mappings":";;;AAAA,aAAa;AACb,MAAa,UAAU;IAGrB,YAA4B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAND,gCAMC"}
+{"version":3,"file":"ServiceKey.js","sourceRoot":"","sources":["../src/ServiceKey.ts"],"names":[],"mappings":";;;AAAA,aAAa;AACb,MAAa,UAAU;IAGrB,YAA4B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAND,gCAMC"}

package/dist/serviceModule.d.ts

@@ -1,10 +1,9 @@
-import { ServiceKey } from './serviceKey';
-import { ServiceFactory } from './serviceFactory';
-import { ServiceProvider } from './serviceProvider';
-export declare class ServiceModule implements ServiceProvider {
-    private readonly factories;
-    constructor(factories: Set<ServiceFactory<unknown, ServiceKey<unknown>[]>>);
+import { ServiceKey } from './ServiceKey';
+import { ServiceFactory } from './ServiceFactory';
+export declare class ServiceModule {
+    readonly factories: ServiceFactory<any, any>[];
+    constructor(factories: Set<ServiceFactory<unknown, readonly ServiceKey<unknown>[]>>);
     get<T>(key: ServiceKey<T>): Promise<T>;
-    static from(entries: (ServiceModule | ServiceFactory<unknown, ServiceKey<unknown>[]>)[]): ServiceModule;
+    static from(entries: (ServiceModule | ServiceFactory<unknown, readonly ServiceKey<unknown>[]>)[]): ServiceModule;
 }
-//# sourceMappingURL=serviceModule.d.ts.map
+//# sourceMappingURL=ServiceModule.d.ts.map

package/dist/serviceModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serviceModule.d.ts","sourceRoot":"","sources":["../src/serviceModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qBAAa,aAAc,YAAW,eAAe;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;gBAEhD,SAAS,EAAE,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAQ7D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBnD,MAAM,CAAC,IAAI,CACT,OAAO,EAAE,CAAC,aAAa,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,GAC1E,aAAa;CAajB"}
+{"version":3,"file":"ServiceModule.d.ts","sourceRoot":"","sources":["../src/ServiceModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,qBAAa,aAAa;IACxB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAM;gBAGlD,SAAS,EAAE,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAS5D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBnD,MAAM,CAAC,IAAI,CACT,OAAO,EAAE,CAAC,aAAa,GAAG,cAAc,CAAC,OAAO,EAAE,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,GACnF,aAAa;CAajB"}

package/dist/serviceModule.js

@@ -74,4 +74,4 @@ function isRegistered(key, factories) {
 function isSuitable(key, factory) {
     return (factory === null || factory === void 0 ? void 0 : factory.provides) === key;
 }
-//# sourceMappingURL=serviceModule.js.map
+//# sourceMappingURL=ServiceModule.js.map

package/dist/serviceModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"serviceModule.js","sourceRoot":"","sources":["../src/serviceModule.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ServiceModule.js","sourceRoot":"","sources":["../src/ServiceModule.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -0,0 +1,26 @@
+import { ServiceModule } from './ServiceModule';
+export interface DotGraphOptions {
+    /** Graph direction: 'TB' (top-bottom), 'LR' (left-right), 'BT' (bottom-top), 'RL' (right-left) */
+    direction?: 'TB' | 'LR' | 'BT' | 'RL';
+    /** Title for the graph */
+    title?: string;
+    /** Show nodes with no dependencies in a different color */
+    highlightLeaves?: boolean;
+    /** Show nodes with no dependents in a different color */
+    highlightRoots?: boolean;
+}
+/**
+ * Generates a DOT notation graph from a ServiceModule.
+ * The output can be visualized using Graphviz tools or online viewers like:
+ * - https://dreampuf.github.io/GraphvizOnline/
+ * - https://edotor.net/
+ *
+ * Arrows point from dependencies to dependents (from what is needed to what needs it).
+ *
+ * @param module - The ServiceModule to convert to DOT notation
+ * @param options - Optional configuration for the graph appearance
+ * @returns A string containing the DOT notation graph
+ */
+export declare function createDotGraph(module: ServiceModule, { direction, title, highlightLeaves, highlightRoots }?: DotGraphOptions): string;
+export declare function printDotGraph(module: ServiceModule): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,WAAW,eAAe;IAC9B,kGAAkG;IAClG,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACtC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,GAAE,eAKtD,GACA,MAAM,CA6FR;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,QAIlD"}

package/dist/utils.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDotGraph = createDotGraph;
+exports.printDotGraph = printDotGraph;
+/**
+ * Escapes special characters in strings for DOT notation
+ */
+function escapeDotString(str) {
+    return str.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+}
+/**
+ * Generates a DOT notation graph from a ServiceModule.
+ * The output can be visualized using Graphviz tools or online viewers like:
+ * - https://dreampuf.github.io/GraphvizOnline/
+ * - https://edotor.net/
+ *
+ * Arrows point from dependencies to dependents (from what is needed to what needs it).
+ *
+ * @param module - The ServiceModule to convert to DOT notation
+ * @param options - Optional configuration for the graph appearance
+ * @returns A string containing the DOT notation graph
+ */
+function createDotGraph(module, { direction, title, highlightLeaves, highlightRoots } = {
+    direction: 'BT',
+    title: 'Service Dependency Graph',
+    highlightLeaves: true,
+    highlightRoots: true,
+}) {
+    const factories = module.factories;
+    const lines = [];
+    // Start the digraph
+    lines.push('digraph ServiceDependencies {');
+    lines.push(`  label="${title}";`);
+    lines.push('  labelloc="t";');
+    lines.push('  fontsize=16;');
+    lines.push(`  rankdir=${direction};`);
+    lines.push('');
+    // Default node styling
+    lines.push('  node [');
+    lines.push('    shape=box,');
+    lines.push('    style="rounded,filled",');
+    lines.push('    fillcolor="#e1f5ff",');
+    lines.push('    color="#0288d1",');
+    lines.push('    fontname="Arial",');
+    lines.push('    fontsize=12');
+    lines.push('  ];');
+    lines.push('');
+    // Default edge styling
+    lines.push('  edge [');
+    lines.push('    color="#666666",');
+    lines.push('    arrowsize=0.8');
+    lines.push('  ];');
+    lines.push('');
+    // Build dependency maps to identify leaves and roots
+    const hasDependencies = new Set();
+    const hasDependents = new Set();
+    factories.forEach((factory) => {
+        const serviceName = factory.provides.name;
+        if (factory.dependsOn.length > 0) {
+            hasDependencies.add(serviceName);
+        }
+        factory.dependsOn.forEach((dependency) => {
+            hasDependents.add(dependency.name);
+        });
+    });
+    // Define nodes with special styling for leaves and roots
+    const nodeIds = new Map();
+    let nodeCounter = 0;
+    factories.forEach((factory) => {
+        const serviceName = factory.provides.name;
+        const nodeId = `node${nodeCounter++}`;
+        nodeIds.set(serviceName, nodeId);
+        const isLeaf = !hasDependencies.has(serviceName);
+        const isRoot = !hasDependents.has(serviceName);
+        let nodeStyle = '';
+        if (highlightLeaves && isLeaf) {
+            nodeStyle = ' [fillcolor="#c8e6c9", color="#388e3c"]';
+        }
+        else if (highlightRoots && isRoot) {
+            nodeStyle = ' [fillcolor="#ffccbc", color="#d84315"]';
+        }
+        lines.push(`  ${nodeId} [label="${escapeDotString(serviceName)}"]${nodeStyle};`);
+    });
+    lines.push('');
+    // Define edges (dependencies)
+    factories.forEach((factory) => {
+        const serviceName = factory.provides.name;
+        const serviceNodeId = nodeIds.get(serviceName);
+        factory.dependsOn.forEach((dependency) => {
+            const depName = dependency.name;
+            const depNodeId = nodeIds.get(depName);
+            if (depNodeId) {
+                // Arrow points from dependency to dependent (what provides -> what needs it)
+                lines.push(`  ${depNodeId} -> ${serviceNodeId};`);
+            }
+        });
+    });
+    // Close the digraph
+    lines.push('}');
+    return lines.join('\n');
+}
+function printDotGraph(module) {
+    console.log(createDotGraph(module));
+    console.log('\n\nCopy the DOT output above and paste it into:');
+    console.log('https://dreampuf.github.io/GraphvizOnline/');
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "composed-di",
   "private": false,
-  "version": "0.0.3",
+  "version": "0.0.5-alpha",
   "author": "Juan Herrera juanhr454@gmail.com",
   "type": "commonjs",
   "main": "./dist/index.js",

package/src/ServiceFactory.ts

@@ -0,0 +1,83 @@
+import { ServiceKey } from './ServiceKey';
+
+// Helper types to extract the type from ServiceKey
+type ServiceType<T> = T extends ServiceKey<infer U> ? U : never;
+
+// Helper types to convert an array/tuple of ServiceKey to tuple of their types
+type DependencyTypes<T extends readonly ServiceKey<unknown>[]> = {
+  [K in keyof T]: ServiceType<T[K]>;
+};
+
+export abstract class ServiceFactory<
+  const T,
+  const D extends readonly ServiceKey<unknown>[] = [],
+> {
+  abstract provides: ServiceKey<T>;
+  abstract dependsOn: D;
+
+  abstract initialize(...dependencies: DependencyTypes<D>): T | Promise<T>;
+
+  abstract dispose(instance: T): void;
+
+  /**
+   * Creates a singleton service factory that ensures a single instance of the provided service is initialized
+   * and used throughout its lifecycle.
+   */
+  static singleton<
+    const T,
+    const D extends readonly ServiceKey<unknown>[] = [],
+  >({
+    provides,
+    dependsOn = [] as unknown as D,
+    initialize,
+    dispose = () => {},
+  }: {
+    provides: ServiceKey<T>;
+    dependsOn?: D;
+    initialize: (...dependencies: DependencyTypes<D>) => T | Promise<T>;
+    dispose?: (instance: T) => void;
+  }): ServiceFactory<T, D> {
+    let instance: T | undefined;
+
+    return {
+      provides,
+      dependsOn,
+      async initialize(...dependencies: DependencyTypes<D>): Promise<T> {
+        if (instance) {
+          return instance;
+        }
+        instance = await initialize(...dependencies);
+        return instance;
+      },
+      dispose(serviceInstance: T): void {
+        if (instance === serviceInstance) {
+          dispose(serviceInstance);
+          instance = undefined;
+        }
+      },
+    };
+  }
+
+  /**
+   * Creates a one-shot service factory that initializes a new instance of the provided service
+   * every time it is requested.
+   */
+  static oneShot<const T, const D extends readonly ServiceKey<unknown>[] = []>({
+    provides,
+    dependsOn,
+    initialize,
+    dispose = () => {},
+  }: {
+    provides: ServiceKey<T>;
+    dependsOn: D;
+    initialize: (...dependencies: DependencyTypes<D>) => T | Promise<T>;
+    dispose?: (instance: T) => void;
+  }): ServiceFactory<T, D> {
+    return {
+      provides,
+      dependsOn,
+      initialize,
+      dispose,
+    };
+  }
+}

package/src/{serviceModule.ts → ServiceModule.ts}

@@ -1,101 +1,102 @@
-import { ServiceKey } from './serviceKey';
-import { ServiceFactory } from './serviceFactory';
-import { ServiceProvider } from './serviceProvider';
-
-export class ServiceModule implements ServiceProvider {
-  private readonly factories: ServiceFactory<any, any>[] = [];
-
-  constructor(factories: Set<ServiceFactory<unknown, ServiceKey<unknown>[]>>) {
-    this.factories = Array.from(factories);
-    this.factories.forEach((factory) => {
-      checkRecursiveDependencies(factory);
-      checkMissingDependencies(factory, this.factories);
-    });
-  }
-
-  public async get<T>(key: ServiceKey<T>): Promise<T> {
-    const factory = this.factories.find((factory) => {
-      return isSuitable(key, factory);
-    });
-
-    // Check if a factory to supply the requested key was not found
-    if (!factory) {
-      throw new Error(`Could not find a suitable factory for ${key.name}`);
-    }
-
-    // Resolve all dependencies first
-    const dependencies = await Promise.all(
-      factory.dependsOn.map((dependencyKey: ServiceKey<unknown>) => {
-        return this.get(dependencyKey);
-      }),
-    );
-
-    // Call the factory to retrieve the dependency
-    return factory.initialize(...dependencies);
-  }
-
-  static from(
-    entries: (ServiceModule | ServiceFactory<unknown, ServiceKey<unknown>[]>)[],
-  ): ServiceModule {
-    return new ServiceModule(
-      new Set(
-        entries.flatMap((e) => {
-          if (e instanceof ServiceModule) {
-            return e.factories;
-          } else {
-            return [e];
-          }
-        }),
-      ),
-    );
-  }
-}
-
-function checkRecursiveDependencies(
-  factory: ServiceFactory<unknown, ServiceKey<unknown>[]>,
-) {
-  const recursive = factory.dependsOn.some((dependencyKey) => {
-    return dependencyKey === factory.provides;
-  });
-
-  if (recursive) {
-    throw new Error(
-      'Recursive dependency detected on: ' + factory.provides.name,
-    );
-  }
-}
-
-function checkMissingDependencies(
-  factory: ServiceFactory<unknown, ServiceKey<unknown>[]>,
-  factories: ServiceFactory<unknown>[],
-) {
-  const missingDependencies = factory.dependsOn.filter(
-    (dependencyKey: ServiceKey<any>) => {
-      return !isRegistered(dependencyKey, factories);
-    },
-  );
-  if (missingDependencies.length === 0) {
-    return;
-  }
-
-  const dependencyList = missingDependencies
-    .map((dependencyKey) => ` -> ${dependencyKey.name}`)
-    .join('\n');
-  throw new Error(
-    `${factory.provides.name} will fail because it depends on:\n ${dependencyList}`,
-  );
-}
-
-function isRegistered(
-  key: ServiceKey<unknown>,
-  factories: ServiceFactory<unknown>[],
-) {
-  return factories.some((factory) => factory.provides === key);
-}
-
-function isSuitable<T, D extends ServiceKey<unknown>[]>(
-  key: ServiceKey<T>,
-  factory: ServiceFactory<unknown, D>,
-): factory is ServiceFactory<T, D> {
-  return factory?.provides === key;
-}
+import { ServiceKey } from './ServiceKey';
+import { ServiceFactory } from './ServiceFactory';
+
+export class ServiceModule {
+  readonly factories: ServiceFactory<any, any>[] = [];
+
+  constructor(
+    factories: Set<ServiceFactory<unknown, readonly ServiceKey<unknown>[]>>,
+  ) {
+    this.factories = Array.from(factories);
+    this.factories.forEach((factory) => {
+      checkRecursiveDependencies(factory);
+      checkMissingDependencies(factory, this.factories);
+    });
+  }
+
+  public async get<T>(key: ServiceKey<T>): Promise<T> {
+    const factory = this.factories.find((factory) => {
+      return isSuitable(key, factory);
+    });
+
+    // Check if a factory to supply the requested key was not found
+    if (!factory) {
+      throw new Error(`Could not find a suitable factory for ${key.name}`);
+    }
+
+    // Resolve all dependencies first
+    const dependencies = await Promise.all(
+      factory.dependsOn.map((dependencyKey: ServiceKey<unknown>) => {
+        return this.get(dependencyKey);
+      }),
+    );
+
+    // Call the factory to retrieve the dependency
+    return factory.initialize(...dependencies);
+  }
+
+  static from(
+    entries: (ServiceModule | ServiceFactory<unknown, readonly ServiceKey<unknown>[]>)[],
+  ): ServiceModule {
+    return new ServiceModule(
+      new Set(
+        entries.flatMap((e) => {
+          if (e instanceof ServiceModule) {
+            return e.factories;
+          } else {
+            return [e];
+          }
+        }),
+      ),
+    );
+  }
+}
+
+function checkRecursiveDependencies(
+  factory: ServiceFactory<unknown, readonly ServiceKey<unknown>[]>,
+) {
+  const recursive = factory.dependsOn.some((dependencyKey) => {
+    return dependencyKey === factory.provides;
+  });
+
+  if (recursive) {
+    throw new Error(
+      'Recursive dependency detected on: ' + factory.provides.name,
+    );
+  }
+}
+
+function checkMissingDependencies(
+  factory: ServiceFactory<unknown, readonly ServiceKey<unknown>[]>,
+  factories: ServiceFactory<unknown>[],
+) {
+  const missingDependencies = factory.dependsOn.filter(
+    (dependencyKey: ServiceKey<any>) => {
+      return !isRegistered(dependencyKey, factories);
+    },
+  );
+  if (missingDependencies.length === 0) {
+    return;
+  }
+
+  const dependencyList = missingDependencies
+    .map((dependencyKey) => ` -> ${dependencyKey.name}`)
+    .join('\n');
+  throw new Error(
+    `${factory.provides.name} will fail because it depends on:\n ${dependencyList}`,
+  );
+}
+
+function isRegistered(
+  key: ServiceKey<unknown>,
+  factories: ServiceFactory<unknown>[],
+) {
+  return factories.some((factory) => factory.provides === key);
+}
+
+function isSuitable<T, D extends readonly ServiceKey<unknown>[]>(
+  key: ServiceKey<T>,
+  factory: ServiceFactory<unknown, D>,
+): factory is ServiceFactory<T, D> {
+  return factory?.provides === key;
+}

package/src/index.ts

@@ -1,4 +1,4 @@
-export { ServiceKey } from './serviceKey';
-export { ServiceModule } from './serviceModule';
-export { type ServiceFactory, singletonFactory, oneShotFactory } from './serviceFactory';
-export { type ServiceProvider } from './serviceProvider';
+export * from './ServiceKey';
+export * from './ServiceModule';
+export * from './ServiceFactory';
+export * from './utils'