@composed-di/core 0.5.0-alpha

package/dist/serviceModule.js

@@ -0,0 +1,329 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceModule = void 0;
+const serviceKey_1 = require("./serviceKey");
+const serviceFactory_1 = require("./serviceFactory");
+const serviceSelector_1 = require("./serviceSelector");
+const errors_1 = require("./errors");
+/**
+ * ServiceModule is a container for service factories and manages dependency resolution.
+ *
+ * It provides a way to retrieve service instances based on their ServiceKey,
+ * ensuring that all dependencies are resolved and initialized in the correct order.
+ * It also handles circular dependency detection and missing dependency validation
+ * at the time of module creation.
+ */
+class ServiceModule {
+    /**
+     * Private constructor to enforce module creation through the `static from` method.
+     *
+     * @param factories An array of service factories that this module will manage.
+     */
+    constructor(factories) {
+        this.factories = factories;
+        checkCircularDependencies(this.factories);
+        factories.forEach((factory) => {
+            checkMissingDependencies(factory, this.factories);
+        });
+    }
+    /**
+     * Retrieves an instance for the given ServiceKey.
+     *
+     * @param key - The key of the service to retrieve.
+     * @return A promise that resolves to the service instance.
+     * @throws {ServiceFactoryNotFoundError} If no suitable factory is found for the given key.
+     */
+    get(key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            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 errors_1.ServiceFactoryNotFoundError(`Could not find a suitable factory for ${key.name}`);
+            }
+            // Resolve all dependencies first
+            const dependencies = yield Promise.all(factory.dependsOn.map((dependencyKey) => {
+                // If the dependency is a ServiceSelectorKey, create a ServiceSelector instance
+                if (dependencyKey instanceof serviceKey_1.ServiceSelectorKey) {
+                    return new serviceSelector_1.ServiceSelector(this, dependencyKey);
+                }
+                return this.get(dependencyKey);
+            }));
+            // Call the factory to retrieve the dependency
+            return factory.initialize(...dependencies);
+        });
+    }
+    /**
+     * Retrieves the value associated with the given service key or returns null if the service is not found.
+     *
+     * @param key - The key used to retrieve the associated service.
+     * @return A promise that resolves to the service value if found, or null if the service is not found.
+     */
+    getOrNull(key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                return yield this.get(key);
+            }
+            catch (error) {
+                if (error instanceof errors_1.ServiceFactoryNotFoundError) {
+                    return null;
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * Disposes of service factories within the specified scope or all factories if no scope is provided.
+     *
+     * This method is useful for cleaning up resources and instances held by service factories,
+     * such as singleton factories, as they may hold database connections or other resources that need to be released.
+     *
+     * @param scope The scope to filter the factories to be disposed.
+     * If not provided, all factories are disposed of.
+     * @return No return value.
+     */
+    dispose(scope) {
+        const factories = scope
+            ? this.factories.filter((f) => f.scope === scope)
+            : this.factories;
+        factories.forEach((factory) => { var _a; return (_a = factory.dispose) === null || _a === void 0 ? void 0 : _a.call(factory); });
+    }
+    /**
+     * Creates a new ServiceModule instance by aggregating and deduplicating a list of
+     * ServiceModule or GenericFactory instances.
+     * If multiple factories provide the same
+     * ServiceKey, the last one in the list takes precedence.
+     *
+     * When a listener is provided, every factory is wrapped with instrumentation:
+     * the listener is notified when a service is initialized or disposed and when
+     * a method is called on a service instance, and may return an EventSpan per
+     * operation to observe its completion. Service instances are wrapped in a
+     * Proxy to observe method calls, and errors are rethrown after being
+     * reported, so behavior is otherwise unchanged.
+     *
+     * @param entries - An array of ServiceModule or GenericFactory
+     * instances to be processed into a single ServiceModule.
+     * @param listener - An optional ServiceEventListener notified of service
+     * lifecycle events and method calls in the resulting module.
+     * @return A new ServiceModule containing the deduplicated factories.
+     * @throws {ServiceModuleInitError} If circular or missing dependencies are detected during module creation.
+     */
+    static from(entries, listener) {
+        // Flatten entries and keep only the last factory for each ServiceKey
+        const flattened = entries.flatMap((e) => e instanceof ServiceModule ? e.factories : [e]);
+        const byKey = new Map();
+        // Later factories overwrite earlier ones (last-wins)
+        for (const f of flattened) {
+            byKey.set(f.provides.symbol, f);
+        }
+        if (listener) {
+            return new ServiceModule(Array.from(byKey.values()).map((factory) => {
+                return makeObservable(listener, factory);
+            }));
+        }
+        return new ServiceModule(Array.from(byKey.values()));
+    }
+}
+exports.ServiceModule = ServiceModule;
+/**
+ * Validates that there are no circular dependencies among the provided factories.
+ *
+ * @param factories The list of factories to check for cycles.
+ * @throws {ServiceModuleInitError} If a circular dependency is detected.
+ */
+function checkCircularDependencies(factories) {
+    const factoryMap = new Map();
+    for (const f of factories) {
+        factoryMap.set(f.provides.symbol, f);
+    }
+    const visited = new Set();
+    const stack = new Set();
+    function walk(factory, path) {
+        const symbol = factory.provides.symbol;
+        if (stack.has(symbol)) {
+            const cyclePath = [...path, factory.provides.name].join(' -> ');
+            throw new errors_1.ServiceModuleInitError(`Circular dependency detected: ${cyclePath}`);
+        }
+        if (visited.has(symbol)) {
+            return;
+        }
+        visited.add(symbol);
+        stack.add(symbol);
+        for (const depKey of factory.dependsOn) {
+            const keysToCheck = depKey instanceof serviceKey_1.ServiceSelectorKey ? depKey.values : [depKey];
+            for (const key of keysToCheck) {
+                const depFactory = factoryMap.get(key.symbol);
+                if (depFactory) {
+                    walk(depFactory, [...path, factory.provides.name]);
+                }
+            }
+        }
+        stack.delete(symbol);
+    }
+    for (const factory of factories) {
+        walk(factory, []);
+    }
+}
+/**
+ * Validates that all dependencies of a given factory are present in the list of factories.
+ *
+ * @param factory The factory whose dependencies are to be checked.
+ * @param factories The list of available factories in the module.
+ * @throws {ServiceModuleInitError} If any dependency is missing.
+ */
+function checkMissingDependencies(factory, factories) {
+    const missingDependencies = [];
+    factory.dependsOn.forEach((dependencyKey) => {
+        // For ServiceSelectorKey, check all contained keys are registered
+        if (dependencyKey instanceof serviceKey_1.ServiceSelectorKey) {
+            dependencyKey.values.forEach((key) => {
+                if (!isRegistered(key, factories)) {
+                    missingDependencies.push(key);
+                }
+            });
+        }
+        else if (!isRegistered(dependencyKey, factories)) {
+            missingDependencies.push(dependencyKey);
+        }
+    });
+    if (missingDependencies.length === 0) {
+        return;
+    }
+    const dependencyList = missingDependencies
+        .map((dependencyKey) => ` -> ${dependencyKey.name}`)
+        .join('\n');
+    throw new errors_1.ServiceModuleInitError(`${factory.provides.name} will fail because it depends on:\n ${dependencyList}`);
+}
+/**
+ * Checks if a ServiceKey is registered among the provided factories.
+ *
+ * @param key The ServiceKey to look for.
+ * @param factories The list of factories to search in.
+ * @returns True if a factory provides the given key, false otherwise.
+ */
+function isRegistered(key, factories) {
+    return factories.some((factory) => { var _a; return ((_a = factory.provides) === null || _a === void 0 ? void 0 : _a.symbol) === (key === null || key === void 0 ? void 0 : key.symbol); });
+}
+/**
+ * Determines if a factory is suitable for providing a specific ServiceKey.
+ *
+ * @param key The ServiceKey being requested.
+ * @param factory The factory to check.
+ * @returns True if the factory provides the key, false otherwise.
+ */
+function isSuitable(key, factory) {
+    var _a;
+    return ((_a = factory === null || factory === void 0 ? void 0 : factory.provides) === null || _a === void 0 ? void 0 : _a.symbol) === (key === null || key === void 0 ? void 0 : key.symbol);
+}
+/**
+ * Wraps a given service factory with instrumentation to notify a listener of
+ * lifecycle events and method calls.
+ *
+ * For each of initialize, dispose, and method calls, the listener is invoked
+ * at the start of the operation and may return an EventSpan whose `end` or
+ * `error` is called when the operation finishes. Errors are rethrown after
+ * being reported.
+ *
+ * @param listener The listener notified of lifecycle and method call events.
+ * @param delegate The original service factory to be instrumented.
+ * @return A new service factory that provides the same dependencies but includes event notification logic.
+ */
+function makeObservable(listener, delegate) {
+    const key = delegate.provides;
+    return serviceFactory_1.ServiceFactory.singleton({
+        scope: delegate.scope,
+        provides: delegate.provides,
+        dependsOn: delegate.dependsOn,
+        dispose: () => {
+            var _a, _b, _c;
+            const dispose = delegate.dispose;
+            if (dispose) {
+                const span = (_a = listener.onDispose) === null || _a === void 0 ? void 0 : _a.call(listener, { key });
+                try {
+                    dispose();
+                }
+                catch (error) {
+                    (_b = span === null || span === void 0 ? void 0 : span.error) === null || _b === void 0 ? void 0 : _b.call(span, error);
+                    throw error;
+                }
+                (_c = span === null || span === void 0 ? void 0 : span.end) === null || _c === void 0 ? void 0 : _c.call(span);
+            }
+        },
+        initialize: (...args) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const span = (_a = listener.onInitialize) === null || _a === void 0 ? void 0 : _a.call(listener, { key });
+            try {
+                const instance = observeMethodCalls(yield delegate.initialize(...args), listener, key);
+                (_b = span === null || span === void 0 ? void 0 : span.end) === null || _b === void 0 ? void 0 : _b.call(span, { result: instance });
+                return instance;
+            }
+            catch (error) {
+                (_c = span === null || span === void 0 ? void 0 : span.error) === null || _c === void 0 ? void 0 : _c.call(span, error);
+                throw error;
+            }
+        }),
+    });
+}
+/**
+ * Wraps an object with a Proxy to notify the listener of method calls.
+ *
+ * Methods returning a promise report end/error when the promise settles,
+ * not when the method returns.
+ *
+ * @param thing The object whose method calls need to be observed.
+ * @param listener The listener notified of method call events.
+ * @param key The service key used to identify the service in events.
+ * @return A Proxy wrapping the input object, with all method calls being reported.
+ */
+function observeMethodCalls(thing, listener, key) {
+    if (typeof thing !== 'object' || thing === null) {
+        return thing;
+    }
+    return new Proxy(thing, {
+        get(target, prop) {
+            const value = Reflect.get(target, prop);
+            if (typeof value === 'function' && typeof prop === 'string') {
+                return (...args) => {
+                    var _a, _b, _c;
+                    const span = (_a = listener.onMethodCall) === null || _a === void 0 ? void 0 : _a.call(listener, {
+                        key,
+                        methodName: prop,
+                        args,
+                    });
+                    try {
+                        const result = value.apply(target, args);
+                        if (result instanceof Promise) {
+                            return result.then((resolved) => {
+                                var _a;
+                                (_a = span === null || span === void 0 ? void 0 : span.end) === null || _a === void 0 ? void 0 : _a.call(span, { result: resolved });
+                                return resolved;
+                            }, (error) => {
+                                var _a;
+                                (_a = span === null || span === void 0 ? void 0 : span.error) === null || _a === void 0 ? void 0 : _a.call(span, error);
+                                throw error;
+                            });
+                        }
+                        (_b = span === null || span === void 0 ? void 0 : span.end) === null || _b === void 0 ? void 0 : _b.call(span, { result });
+                        return result;
+                    }
+                    catch (error) {
+                        (_c = span === null || span === void 0 ? void 0 : span.error) === null || _c === void 0 ? void 0 : _c.call(span, error);
+                        throw error;
+                    }
+                };
+            }
+            return value;
+        },
+    });
+}
+//# sourceMappingURL=serviceModule.js.map

package/dist/serviceModule.js.map

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

package/dist/serviceScope.d.ts

@@ -0,0 +1,6 @@
+export declare class ServiceScope {
+    readonly name: string;
+    readonly symbol: symbol;
+    constructor(name: string);
+}
+//# sourceMappingURL=serviceScope.d.ts.map

package/dist/serviceScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceScope.d.ts","sourceRoot":"","sources":["../src/serviceScope.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IAGX,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEH,IAAI,EAAE,MAAM;CAGlC"}

package/dist/serviceScope.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceScope = void 0;
+class ServiceScope {
+    constructor(name) {
+        this.name = name;
+        this.symbol = Symbol(name);
+    }
+}
+exports.ServiceScope = ServiceScope;
+//# sourceMappingURL=serviceScope.js.map

package/dist/serviceScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceScope.js","sourceRoot":"","sources":["../src/serviceScope.ts"],"names":[],"mappings":";;;AAAA,MAAa,YAAY;IAGvB,YAAqB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAND,oCAMC"}

package/dist/serviceSelector.d.ts

@@ -0,0 +1,64 @@
+import { ServiceKey, ServiceSelectorKey } from './serviceKey';
+import { ServiceModule } from './serviceModule';
+/**
+ * A runtime selector that provides access to multiple service implementations of the same type.
+ *
+ * ServiceSelector is automatically created and injected when a factory depends on a
+ * `ServiceSelectorKey<T>`. It allows the dependent service to dynamically choose which
+ * implementation to use at runtime, rather than being bound to a single implementation
+ * at configuration time.
+ *
+ * @template T The common type shared by all services accessible through this selector.
+ *
+ * @example
+ * ```ts
+ * // In a factory that depends on ServiceSelectorKey
+ * const appFactory = ServiceFactory.singleton({
+ *   provides: AppKey,
+ *   dependsOn: [LoggerSelectorKey] as const,
+ *   initialize: (loggerSelector: ServiceSelector<Logger>) => {
+ *     return {
+ *       logWithConsole: async () => {
+ *         const logger = await loggerSelector.get(ConsoleLoggerKey);
+ *         logger.log('Using console logger');
+ *       },
+ *       logWithFile: async () => {
+ *         const logger = await loggerSelector.get(FileLoggerKey);
+ *         logger.log('Using file logger');
+ *       },
+ *     };
+ *   },
+ * });
+ * ```
+ */
+export declare class ServiceSelector<T> {
+    readonly serviceModule: ServiceModule;
+    readonly selectorKey: ServiceSelectorKey<T>;
+    /**
+     * Creates a new ServiceSelector instance.
+     *
+     * Note: ServiceSelector instances are created automatically by ServiceModule
+     * when resolving dependencies. You typically don't need to create them manually.
+     *
+     * @param serviceModule The ServiceModule used to resolve the selected service.
+     * @param selectorKey The ServiceSelectorKey that defines which services can be selected.
+     */
+    constructor(serviceModule: ServiceModule, selectorKey: ServiceSelectorKey<T>);
+    /**
+     * Retrieves a service instance by its key from the available services in this selector.
+     *
+     * The key must be one of the keys that were included in the `ServiceSelectorKey`
+     * used to create this selector.
+     *
+     * @param key The ServiceKey identifying which service implementation to retrieve.
+     * @returns A Promise that resolves to the requested service instance.
+     *
+     * @example
+     * ```ts
+     * const logger = await loggerSelector.get(ConsoleLoggerKey);
+     * logger.log('Hello!');
+     * ```
+     */
+    get(key: ServiceKey<T>): Promise<T>;
+}
+//# sourceMappingURL=serviceSelector.d.ts.map

package/dist/serviceSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceSelector.d.ts","sourceRoot":"","sources":["../src/serviceSelector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,eAAe,CAAC,CAAC;IAW1B,QAAQ,CAAC,aAAa,EAAE,aAAa;IACrC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAX7C;;;;;;;;OAQG;gBAEQ,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAG7C;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAGpC"}

package/dist/serviceSelector.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceSelector = void 0;
+/**
+ * A runtime selector that provides access to multiple service implementations of the same type.
+ *
+ * ServiceSelector is automatically created and injected when a factory depends on a
+ * `ServiceSelectorKey<T>`. It allows the dependent service to dynamically choose which
+ * implementation to use at runtime, rather than being bound to a single implementation
+ * at configuration time.
+ *
+ * @template T The common type shared by all services accessible through this selector.
+ *
+ * @example
+ * ```ts
+ * // In a factory that depends on ServiceSelectorKey
+ * const appFactory = ServiceFactory.singleton({
+ *   provides: AppKey,
+ *   dependsOn: [LoggerSelectorKey] as const,
+ *   initialize: (loggerSelector: ServiceSelector<Logger>) => {
+ *     return {
+ *       logWithConsole: async () => {
+ *         const logger = await loggerSelector.get(ConsoleLoggerKey);
+ *         logger.log('Using console logger');
+ *       },
+ *       logWithFile: async () => {
+ *         const logger = await loggerSelector.get(FileLoggerKey);
+ *         logger.log('Using file logger');
+ *       },
+ *     };
+ *   },
+ * });
+ * ```
+ */
+class ServiceSelector {
+    /**
+     * Creates a new ServiceSelector instance.
+     *
+     * Note: ServiceSelector instances are created automatically by ServiceModule
+     * when resolving dependencies. You typically don't need to create them manually.
+     *
+     * @param serviceModule The ServiceModule used to resolve the selected service.
+     * @param selectorKey The ServiceSelectorKey that defines which services can be selected.
+     */
+    constructor(serviceModule, selectorKey) {
+        this.serviceModule = serviceModule;
+        this.selectorKey = selectorKey;
+    }
+    /**
+     * Retrieves a service instance by its key from the available services in this selector.
+     *
+     * The key must be one of the keys that were included in the `ServiceSelectorKey`
+     * used to create this selector.
+     *
+     * @param key The ServiceKey identifying which service implementation to retrieve.
+     * @returns A Promise that resolves to the requested service instance.
+     *
+     * @example
+     * ```ts
+     * const logger = await loggerSelector.get(ConsoleLoggerKey);
+     * logger.log('Hello!');
+     * ```
+     */
+    get(key) {
+        return this.serviceModule.get(key);
+    }
+}
+exports.ServiceSelector = ServiceSelector;
+//# sourceMappingURL=serviceSelector.js.map

package/dist/serviceSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceSelector.js","sourceRoot":"","sources":["../src/serviceSelector.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAa,eAAe;IAC1B;;;;;;;;OAQG;IACH,YACW,aAA4B,EAC5B,WAAkC;QADlC,kBAAa,GAAb,aAAa,CAAe;QAC5B,gBAAW,GAAX,WAAW,CAAuB;IAC1C,CAAC;IAEJ;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,GAAkB;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;CACF;AAjCD,0CAiCC"}

package/dist/utils.d.ts

@@ -0,0 +1,61 @@
+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;
+}
+export interface MermaidGraphOptions {
+    /** Graph direction: 'TB' (top-bottom), 'LR' (left-right), 'BT' (bottom-top), 'RL' (right-left) */
+    direction?: 'TB' | 'LR' | 'BT' | 'RL';
+    /** 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;
+/**
+ * Prints a DOT representation of a service module graph to the console.
+ * The output can be used to visualize the graph using online graph visualization tools.
+ *
+ * @param module - The service module representing the graph to be converted into DOT format.
+ * @param options - Optional configurations to customize the output of the DOT graph.
+ */
+export declare function printDotGraph(module: ServiceModule, options?: DotGraphOptions): void;
+/**
+ * Generates a Mermaid flowchart from a ServiceModule.
+ * The output can be visualized using Mermaid-compatible tools or online viewers like:
+ * - https://mermaid.live/
+ *
+ * Arrows point from dependents to dependencies (what needs it -> what provides it).
+ *
+ * @param module - The ServiceModule to convert to Mermaid notation
+ * @param options - Optional configuration for the graph appearance
+ * @returns A string containing the Mermaid flowchart
+ */
+export declare function createMermaidGraph(module: ServiceModule, { direction, highlightLeaves, highlightRoots }?: MermaidGraphOptions): string;
+/**
+ * Prints a Mermaid representation of a service module graph to the console.
+ * The output can be used to visualize the graph using online Mermaid tools.
+ *
+ * @param module - The service module representing the graph to be converted into Mermaid format.
+ * @param options - Optional configurations to customize the output of the Mermaid graph.
+ */
+export declare function printMermaidGraph(module: ServiceModule, options?: MermaidGraphOptions): 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;AAED,MAAM,WAAW,mBAAmB;IAClC,kGAAkG;IAClG,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACtC,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,GAAE,eAKtD,GACA,MAAM,CA6FR;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,eAAe,GACxB,IAAI,CAIN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,GAAE,mBAI/C,GACA,MAAM,CA0ER;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAIN"}