composed-di 0.0.4-alpha → 0.0.5-alpha

package/README.md

@@ -4,8 +4,8 @@ A tiny, type-friendly dependency injection helper for composing services via key
 
 It provides:
 - ServiceKey<T>: a typed token used to identify a service
-- ServiceFactory<T>: a contract to create a service (with helpers singletonFactory and oneShotFactory)
-- ServiceModule: a resolver that wires factories, validates dependencies, and injects services
+- ServiceFactory<T>: a contract to create a service (with static methods `singleton` and `oneShot`)
+- ServiceModule: a resolver that wires factories, validates dependencies, and provides services
 
 ServiceModule will:
 - detect recursive dependencies (a factory that depends on its own key)
@@ -13,7 +13,13 @@ ServiceModule will:
 
 ## Install
 
-This repository is set up as a library. Build artifacts are generated under `dist/` by running:
+Install from npm:
+
+- npm: `npm install composed-di`
+- pnpm: `pnpm add composed-di`
+- yarn: `yarn add composed-di`
+
+If you're working on this repo locally, build artifacts are generated under `dist/` by running:
 
 ```
 npm run build
@@ -21,15 +27,14 @@ npm run build
 
 ## Usage
 
-Below is an example based on the previous sample `main.ts` usage pattern.
+Below is a minimal example using the public API.
 
 ```ts
 import {
   ServiceKey,
   ServiceModule,
-  singletonFactory,
-  oneShotFactory,
-} from 'composed-di'; // if used locally, import from the relative path to `src/index`
+  ServiceFactory,
+} from 'composed-di'; // when developing this repo locally, import from './src'
 
 // 1) Define service types
 interface Config {
@@ -53,50 +58,84 @@ const LoggerKey = new ServiceKey<Logger>('Logger');
 const AppKey = new ServiceKey<App>('App');
 
 // 3) Create factories (singleton or one-shot)
-const configFactory = singletonFactory({
+const configFactory = ServiceFactory.singleton({
   provides: ConfigKey,
-  dependsOn: [] as const,
-  async initialize() {
+  dependsOn: [],
+  initialize: () => {
     return { baseUrl: 'https://api.example.com' } satisfies Config;
   },
 });
 
-const loggerFactory = singletonFactory({
+const loggerFactory = ServiceFactory.singleton({
   provides: LoggerKey,
-  dependsOn: [] as const,
-  async initialize() {
+  dependsOn: [],
+  initialize: () => {
     return console as unknown as Logger;
   },
 });
 
-const appFactory = oneShotFactory({
+const appFactory = ServiceFactory.oneShot({
   provides: AppKey,
-  dependsOn: [ConfigKey, LoggerKey] as const,
-  async initialize(config, logger) {
+  dependsOn: [ConfigKey, LoggerKey],
+  initialize: (config, logger) => {
     return new App(config, logger);
   },
 });
 
-// 4) Compose a module
+// 4) Compose a module (you can pass factories and/or other ServiceModule instances)
 const module = ServiceModule.from([configFactory, loggerFactory, appFactory]);
 
-// 5) Inject and use
+// 5) Resolve and use
 (async () => {
-  const app = await module.inject(AppKey);
+  const app = await module.get(AppKey);
   app.start();
 })();
 ```
 
 Notes:
-- Use `as const` on your `dependsOn` list to preserve tuple types and keep constructor parameters strongly typed.
-- `ServiceModule.inject` resolves dependencies recursively, so factories can depend on other services.
+- `ServiceModule.get` resolves dependencies recursively, so factories can depend on other services.
 - If a dependency is missing or recursive, `ServiceModule` throws with a helpful error message.
 
+## Visualizing Dependencies
+
+The library includes utilities to generate a DOT graph representation of your service dependencies, which can be visualized using Graphviz tools.
+
+```ts
+import { ServiceModule, printDotGraph, createDotGraph } from 'composed-di';
+
+// After creating your ServiceModule
+const module = ServiceModule.from([configFactory, loggerFactory, appFactory]);
+
+// Option 1: Print the DOT graph to console with instructions
+printDotGraph(module);
+
+// Option 2: Generate DOT graph with custom options
+const dotGraph = createDotGraph(module, {
+  direction: 'LR',  // 'TB' (top-bottom), 'LR' (left-right), 'BT', 'RL'
+  title: 'My Service Dependencies',
+  highlightLeaves: true,  // Highlight services with no dependencies (green)
+  highlightRoots: true,   // Highlight services with no dependents (orange)
+});
+console.log(dotGraph);
+```
+
+The generated DOT notation can be visualized using:
+- [GraphvizOnline](https://dreampuf.github.io/GraphvizOnline/)
+- [Edotor](https://edotor.net/)
+
 ## API
 
-- `class ServiceKey<T>(name: string)`
-- `interface ServiceFactory<T, D extends ServiceKey<unknown>[]>` with `provides`, `dependsOn`, `initialize`, `dispose`
-- `singletonFactory({ provides, dependsOn?, initialize, dispose? })`
-- `oneShotFactory({ provides, dependsOn, initialize, dispose? })`
-- `class ServiceModule` with `static from(factories)`, `inject(key)`
+- `class ServiceKey<T>(name: string)` - Creates a typed token to identify a service
+- `abstract class ServiceFactory<T, D extends readonly ServiceKey<unknown>[]>` with:
+  - `provides: ServiceKey<T>` - The service key this factory provides
+  - `dependsOn: D` - Array of service keys this factory depends on
+  - `initialize(...dependencies)` - Creates the service instance
+  - `dispose(instance)` - Cleans up the service instance
+  - `static singleton({ provides, dependsOn?, initialize, dispose? })` - Creates a singleton factory
+  - `static oneShot({ provides, dependsOn, initialize, dispose? })` - Creates a one-shot factory
+- `class ServiceModule` with:
+  - `static from(factoriesOrModules)` - Creates a module from factories and/or other modules
+  - `async get(key)` - Resolves and returns a service by its key
+- `createDotGraph(module, options?)` - Generates DOT notation graph from a ServiceModule
+- `printDotGraph(module)` - Prints DOT graph to console with visualization instructions
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,KAAK,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -1,11 +1,21 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.oneShotFactory = exports.singletonFactory = exports.ServiceModule = exports.ServiceKey = void 0;
-var serviceKey_1 = require("./serviceKey");
-Object.defineProperty(exports, "ServiceKey", { enumerable: true, get: function () { return serviceKey_1.ServiceKey; } });
-var serviceModule_1 = require("./serviceModule");
-Object.defineProperty(exports, "ServiceModule", { enumerable: true, get: function () { return serviceModule_1.ServiceModule; } });
-var serviceFactory_1 = require("./serviceFactory");
-Object.defineProperty(exports, "singletonFactory", { enumerable: true, get: function () { return serviceFactory_1.singletonFactory; } });
-Object.defineProperty(exports, "oneShotFactory", { enumerable: true, get: function () { return serviceFactory_1.oneShotFactory; } });
+__exportStar(require("./ServiceKey"), exports);
+__exportStar(require("./ServiceModule"), exports);
+__exportStar(require("./ServiceFactory"), exports);
+__exportStar(require("./utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,mDAAyF;AAA3D,kHAAA,gBAAgB,OAAA;AAAE,gHAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,kDAAgC;AAChC,mDAAiC;AACjC,0CAAuB"}

package/dist/serviceFactory.d.ts

@@ -1,25 +1,33 @@
-import { ServiceKey } from './serviceKey';
+import { ServiceKey } from './ServiceKey';
 type ServiceType<T> = T extends ServiceKey<infer U> ? U : never;
 type DependencyTypes<T extends readonly ServiceKey<unknown>[]> = {
     [K in keyof T]: ServiceType<T[K]>;
 };
-export interface ServiceFactory<T, D extends readonly ServiceKey<unknown>[] = []> {
-    provides: ServiceKey<T>;
-    dependsOn: D;
-    initialize(...dependencies: DependencyTypes<D>): T | Promise<T>;
-    dispose(instance: T): void;
+export declare 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, initialize, dispose, }: {
+        provides: ServiceKey<T>;
+        dependsOn?: D;
+        initialize: (...dependencies: DependencyTypes<D>) => T | Promise<T>;
+        dispose?: (instance: T) => void;
+    }): ServiceFactory<T, D>;
+    /**
+     * 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>;
 }
-export declare function singletonFactory<T, 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>;
-export declare function oneShotFactory<T, 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>;
 export {};
-//# sourceMappingURL=serviceFactory.d.ts.map
+//# sourceMappingURL=ServiceFactory.d.ts.map

package/dist/serviceFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serviceFactory.d.ts","sourceRoot":"","sources":["../src/serviceFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAGhE,KAAK,eAAe,CAAC,CAAC,SAAS,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI;KAC9D,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,WAAW,cAAc,CAC7B,CAAC,EACD,CAAC,SAAS,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE;IAE7C,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACxB,SAAS,EAAE,CAAC,CAAC;IAEb,UAAU,CAAC,GAAG,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhE,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAC9B,CAAC,EACD,CAAC,SAAS,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,EAC7C,EACA,QAAQ,EACR,SAA8B,EAC9B,UAAU,EACV,OAAkB,GACnB,EAAE;IACD,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACxB,SAAS,CAAC,EAAE,CAAC,CAAC;IACd,UAAU,EAAE,CAAC,GAAG,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAC;CACjC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAoBvB;AAED,wBAAgB,cAAc,CAC5B,CAAC,EACD,CAAC,SAAS,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,EAC7C,EACA,QAAQ,EACR,SAAS,EACT,UAAU,EACV,OAAkB,GACnB,EAAE;IACD,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACxB,SAAS,EAAE,CAAC,CAAC;IACb,UAAU,EAAE,CAAC,GAAG,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAC;CACjC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAOvB"}
+{"version":3,"file":"ServiceFactory.d.ts","sourceRoot":"","sources":["../src/ServiceFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAGhE,KAAK,eAAe,CAAC,CAAC,SAAS,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI;KAC9D,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,CAAC;AAEF,8BAAsB,cAAc,CAClC,KAAK,CAAC,CAAC,EACP,KAAK,CAAC,CAAC,SAAS,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE;IAEnD,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IAEtB,QAAQ,CAAC,UAAU,CAAC,GAAG,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAExE,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI;IAEnC;;;OAGG;IACH,MAAM,CAAC,SAAS,CACd,KAAK,CAAC,CAAC,EACP,KAAK,CAAC,CAAC,SAAS,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,EACnD,EACA,QAAQ,EACR,SAA8B,EAC9B,UAAU,EACV,OAAkB,GACnB,EAAE;QACD,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,SAAS,CAAC,EAAE,CAAC,CAAC;QACd,UAAU,EAAE,CAAC,GAAG,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAC;KACjC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAsBxB;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,SAAS,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,EAAE,EAC3E,QAAQ,EACR,SAAS,EACT,UAAU,EACV,OAAkB,GACnB,EAAE;QACD,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,SAAS,EAAE,CAAC,CAAC;QACb,UAAU,EAAE,CAAC,GAAG,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAC;KACjC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;CAQzB"}

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":";;;;;;;;;;;AAsBA,4CAiCC;AAED,wCAoBC;AAvDD,SAAgB,gBAAgB,CAG9B,EACA,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,CAG5B,EACA,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;
+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, 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;gBAG1D,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"}
+{"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.4-alpha",
+  "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,103 +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, 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;
-}
+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'

package/src/utils.ts

@@ -0,0 +1,141 @@
+import { ServiceModule } from './ServiceModule';
+import { ServiceKey } from './ServiceKey';
+
+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;
+}
+
+/**
+ * Escapes special characters in strings for DOT notation
+ */
+function escapeDotString(str: string): string {
+  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
+ */
+export function createDotGraph(
+  module: ServiceModule,
+  { direction, title, highlightLeaves, highlightRoots }: DotGraphOptions = {
+    direction: 'BT',
+    title: 'Service Dependency Graph',
+    highlightLeaves: true,
+    highlightRoots: true,
+  },
+): string {
+  const factories = module.factories;
+  const lines: string[] = [];
+
+  // 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<string>();
+  const hasDependents = new Set<string>();
+
+  factories.forEach((factory) => {
+    const serviceName = factory.provides.name;
+
+    if (factory.dependsOn.length > 0) {
+      hasDependencies.add(serviceName);
+    }
+
+    factory.dependsOn.forEach((dependency: ServiceKey<unknown>) => {
+      hasDependents.add(dependency.name);
+    });
+  });
+
+  // Define nodes with special styling for leaves and roots
+  const nodeIds = new Map<string, string>();
+  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: ServiceKey<unknown>) => {
+      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');
+}
+
+export function printDotGraph(module: ServiceModule) {
+  console.log(createDotGraph(module));
+  console.log('\n\nCopy the DOT output above and paste it into:');
+  console.log('https://dreampuf.github.io/GraphvizOnline/');
+}

package/src/main.ts

@@ -1,19 +0,0 @@
-import { ServiceKey } from './serviceKey';
-import { singletonFactory } from './serviceFactory';
-
-const TEST_SERVICE_KEY = new ServiceKey<TestService>('testService');
-const FOO_KEY = new ServiceKey<string>('foo');
-const BAR_KEY = new ServiceKey<number>('bar');
-
-interface TestService {
-  foo: string;
-  bar: number;
-}
-
-const TestServiceFactory = singletonFactory({
-  provides: TEST_SERVICE_KEY,
-  dependsOn: [FOO_KEY, BAR_KEY] as const,
-  initialize: (foo, bar) => {
-    return { foo, bar };
-  },
-});

package/src/serviceFactory.ts

@@ -1,78 +0,0 @@
-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 interface ServiceFactory<
-  T,
-  D extends readonly ServiceKey<unknown>[] = [],
-> {
-  provides: ServiceKey<T>;
-  dependsOn: D;
-
-  initialize(...dependencies: DependencyTypes<D>): T | Promise<T>;
-
-  dispose(instance: T): void;
-}
-
-export function singletonFactory<
-  T,
-  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;
-      }
-    },
-  };
-}
-
-export function oneShotFactory<
-  T,
-  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/serviceProvider.ts

@@ -1,5 +0,0 @@
-import { ServiceKey } from './serviceKey';
-
-export interface ServiceProvider {
-  get<T>(key: ServiceKey<T>): Promise<T>;
-}