@elsikora/cladi 1.0.1

package/dist/cjs/domain/interface/registry.interface.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Generic registry interface for managing items by name.
+ * @template T The type of items stored in the registry.
+ */
+export interface IRegistry<T> {
+    /**
+     * Clear the registry.
+     */
+    clear(): void;
+    /**
+     * Get a single item from the registry by name.
+     * @param name The name of the item to get.
+     * @returns The item or undefined if it doesn't exist.
+     */
+    get(name: string): T | undefined;
+    /**
+     * Get all items from the registry.
+     * @returns An array of all items.
+     */
+    getAll(): Array<T>;
+    /**
+     * Get multiple items from the registry by their names.
+     * @param names The names of the items to get.
+     * @returns An array of items.
+     */
+    getMany(names: Array<string>): Array<T>;
+    /**
+     * Check if an item exists in the registry by name.
+     * @param name The name of the item to check.
+     * @returns True if the item exists, false otherwise.
+     */
+    has(name: string): boolean;
+    /**
+     * Register a single item in the registry.
+     * @param item The item to register.
+     */
+    register(item: T): void;
+    /**
+     * Register multiple items in the registry.
+     * @param items The items to register.
+     */
+    registerMany(items: Array<T>): void;
+    /**
+     * Unregister a single item from the registry by name.
+     * @param name The name of the item to unregister.
+     */
+    unregister(name: string): void;
+    /**
+     * Unregister multiple items from the registry by their names.
+     * @param names The names of the items to unregister.
+     */
+    unregisterMany(names: Array<string>): void;
+}
+//# sourceMappingURL=registry.interface.d.ts.map

package/dist/cjs/domain/interface/registry.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.interface.d.ts","sourceRoot":"","sources":["../../../../src/domain/interface/registry.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC3B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAEjC;;;OAGG;IACH,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAExC;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAExB;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAEpC;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAC3C"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./domain";
+export * from "./infrastructure";
+export * from "./presentation/utility/create";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,38 @@
+'use strict';
+
+var loggerLogLevel_enum = require('./domain/enum/logger-log-level.enum.js');
+var serviceToken_enum = require('./domain/enum/service-token.enum.js');
+var container_class = require('./infrastructure/class/base/container.class.js');
+var error_class = require('./infrastructure/class/base/error.class.js');
+var factory_class = require('./infrastructure/class/base/factory.class.js');
+var registry_class = require('./infrastructure/class/base/registry.class.js');
+var consoleLoggerDefaultOptions_constant = require('./infrastructure/constant/console-logger-default-options.constant.js');
+var core_factory = require('./infrastructure/factory/core.factory.js');
+var consoleLogger_service = require('./infrastructure/service/console-logger.service.js');
+var container_utility = require('./presentation/utility/create/container.utility.js');
+var factory_utility = require('./presentation/utility/create/factory.utility.js');
+var logger_utility = require('./presentation/utility/create/logger.utility.js');
+var registry_utility = require('./presentation/utility/create/registry.utility.js');
+
+
+
+Object.defineProperty(exports, "ELoggerLogLevel", {
+	enumerable: true,
+	get: function () { return loggerLogLevel_enum.ELoggerLogLevel; }
+});
+Object.defineProperty(exports, "EServiceToken", {
+	enumerable: true,
+	get: function () { return serviceToken_enum.EServiceToken; }
+});
+exports.BaseContainer = container_class.BaseContainer;
+exports.BaseError = error_class.BaseError;
+exports.BaseFactory = factory_class.BaseFactory;
+exports.BaseRegistry = registry_class.BaseRegistry;
+exports.CONSOLE_LOGGER_DEFAULT_OPTIONS = consoleLoggerDefaultOptions_constant.CONSOLE_LOGGER_DEFAULT_OPTIONS;
+exports.CoreFactory = core_factory.CoreFactory;
+exports.ConsoleLoggerService = consoleLogger_service.ConsoleLoggerService;
+exports.createContainer = container_utility.createContainer;
+exports.createFactory = factory_utility.createFactory;
+exports.createLogger = logger_utility.createLogger;
+exports.createRegistry = registry_utility.createRegistry;
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/infrastructure/class/base/container.class.d.ts

@@ -0,0 +1,67 @@
+import type { IContainer } from '../../../src/domain/interface/container.interface';
+import type { IBaseContainerOptions } from '../../../src/infrastructure/interface/index';
+/**
+ * Simple dependency injection container implementation.
+ */
+export declare class BaseContainer implements IContainer {
+    private readonly DEPENDENCIES;
+    private readonly LOGGER;
+    /**
+     * Create a new container.
+     * @param {IBaseContainerOptions} options - The options to use for the container.
+     */
+    constructor(options: IBaseContainerOptions);
+    /**
+     * Clear all dependencies from the container.
+     */
+    clear(): void;
+    /**
+     * Get a dependency from the container.
+     * @param {symbol} token Token that identifies the dependency.
+     * @returns {T | undefined} The dependency, or undefined if it doesn't exist.
+     * @template T The type of the dependency.
+     */
+    get<T>(token: symbol): T | undefined;
+    /**
+     * Get all dependencies from the container.
+     * @returns {Array<unknown>} An array of all dependencies.
+     */
+    getAll(): Array<unknown>;
+    /**
+     * Get multiple dependencies from the container.
+     * @param {Array<symbol>} tokens Tokens that identify the dependencies.
+     * @returns {Array<unknown>} An array of dependencies.
+     */
+    getMany<T>(tokens: Array<symbol>): Array<T>;
+    /**
+     * Check if a dependency exists in the container.
+     * @param {symbol} token Token that identifies the dependency.
+     * @returns {boolean} True if the dependency exists, false otherwise.
+     */
+    has(token: symbol): boolean;
+    /**
+     * Register a dependency in the container.
+     * @param {symbol} token Token that identifies the dependency.
+     * @param {T} implementation Implementation of the dependency.
+     * @template T The type of the dependency.
+     */
+    register(token: symbol, implementation: unknown): void;
+    /**
+     * Register multiple dependencies in the container.
+     * @param {Array<symbol>} tokens Tokens that identify the dependencies.
+     * @param {Array<T>} implementations Implementations of the dependencies.
+     * @template T The type of the dependencies.
+     */
+    registerMany(tokens: Array<symbol>, implementations: Record<symbol, unknown>): void;
+    /**
+     * Remove a dependency from the container.
+     * @param {symbol} token Token that identifies the dependency.
+     */
+    unregister(token: symbol): void;
+    /**
+     * Remove multiple dependencies from the container.
+     * @param {Array<symbol>} tokens Tokens that identify the dependencies.
+     */
+    unregisterMany(tokens: Array<symbol>): void;
+}
+//# sourceMappingURL=container.class.d.ts.map

package/dist/cjs/infrastructure/class/base/container.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.class.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/class/base/container.class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAExE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAMvE;;GAEG;AACH,qBAAa,aAAc,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IAEpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC;;;OAGG;gBACS,OAAO,EAAE,qBAAqB;IAK1C;;OAEG;IACI,KAAK,IAAI,IAAI;IAMpB;;;;;OAKG;IAEI,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAoB3C;;;OAGG;IACI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC;IAQ/B;;;;OAIG;IACI,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAwBlD;;;;OAIG;IACI,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAclC;;;;;OAKG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,IAAI;IAsB7D;;;;;OAKG;IAEI,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAyB1F;;;OAGG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAmBtC;;;OAGG;IACI,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI;CAwBlD"}

package/dist/cjs/infrastructure/class/base/container.class.js

@@ -0,0 +1,193 @@
+'use strict';
+
+var consoleLogger_service = require('../../service/console-logger.service.js');
+var error_class = require('./error.class.js');
+
+/**
+ * Simple dependency injection container implementation.
+ */
+class BaseContainer {
+    DEPENDENCIES;
+    LOGGER;
+    /**
+     * Create a new container.
+     * @param {IBaseContainerOptions} options - The options to use for the container.
+     */
+    constructor(options) {
+        this.DEPENDENCIES = new Map();
+        this.LOGGER = options.logger ?? new consoleLogger_service.ConsoleLoggerService();
+    }
+    /**
+     * Clear all dependencies from the container.
+     */
+    clear() {
+        this.LOGGER.debug("Clearing all dependencies from container", { source: "Container" });
+        this.DEPENDENCIES.clear();
+        this.LOGGER.debug("Container cleared successfully", { source: "Container" });
+    }
+    /**
+     * Get a dependency from the container.
+     * @param {symbol} token Token that identifies the dependency.
+     * @returns {T | undefined} The dependency, or undefined if it doesn't exist.
+     * @template T The type of the dependency.
+     */
+    // eslint-disable-next-line @elsikora/typescript/no-unnecessary-type-parameters
+    get(token) {
+        if (!token) {
+            this.LOGGER.warn("Attempted to get dependency with empty token", { source: "Container" });
+            return undefined;
+        }
+        this.LOGGER.debug(`Getting dependency with token: ${String(token.description)}`, { source: "Container" });
+        const dependency = this.DEPENDENCIES.get(token);
+        if (dependency) {
+            this.LOGGER.debug(`Dependency found: ${String(token.description)}`, { source: "Container" });
+        }
+        else {
+            this.LOGGER.debug(`Dependency not found: ${String(token.description)}`, { source: "Container" });
+        }
+        return dependency;
+    }
+    /**
+     * Get all dependencies from the container.
+     * @returns {Array<unknown>} An array of all dependencies.
+     */
+    getAll() {
+        this.LOGGER.debug("Getting all dependencies", { source: "Container" });
+        const dependencies = [...this.DEPENDENCIES.values()];
+        this.LOGGER.debug(`Retrieved ${String(dependencies.length)} dependencies`, { source: "Container" });
+        return dependencies;
+    }
+    /**
+     * Get multiple dependencies from the container.
+     * @param {Array<symbol>} tokens Tokens that identify the dependencies.
+     * @returns {Array<unknown>} An array of dependencies.
+     */
+    getMany(tokens) {
+        if (!tokens) {
+            throw new error_class.BaseError("Tokens cannot be null or undefined", {
+                code: "CONTAINER_TOKENS_NOT_NULL_OR_UNDEFINED",
+                source: "Container",
+            });
+        }
+        if (!Array.isArray(tokens)) {
+            throw new error_class.BaseError("Tokens must be an array", {
+                code: "CONTAINER_TOKENS_NOT_ARRAY",
+                source: "Container",
+            });
+        }
+        this.LOGGER.debug(`Getting ${String(tokens.length)} dependencies by token`, { source: "Container" });
+        const result = tokens.map((token) => this.get(token)).filter((item) => item !== undefined);
+        this.LOGGER.debug(`Retrieved ${String(result.length)} dependencies`, { source: "Container" });
+        return result;
+    }
+    /**
+     * Check if a dependency exists in the container.
+     * @param {symbol} token Token that identifies the dependency.
+     * @returns {boolean} True if the dependency exists, false otherwise.
+     */
+    has(token) {
+        if (!token) {
+            return false;
+        }
+        this.LOGGER.debug(`Checking if dependency exists: ${String(token.description)}`, { source: "Container" });
+        const isExists = this.DEPENDENCIES.has(token);
+        this.LOGGER.debug(`Dependency ${isExists ? "exists" : "does not exist"}: ${String(token.description)}`, { source: "Container" });
+        return isExists;
+    }
+    /**
+     * Register a dependency in the container.
+     * @param {symbol} token Token that identifies the dependency.
+     * @param {T} implementation Implementation of the dependency.
+     * @template T The type of the dependency.
+     */
+    register(token, implementation) {
+        if (!token) {
+            throw new error_class.BaseError("Token cannot be null or undefined", {
+                code: "CONTAINER_TOKEN_NOT_NULL_OR_UNDEFINED",
+                source: "Container",
+            });
+        }
+        this.LOGGER.debug(`Registering dependency with token: ${String(token.description)}`, { source: "Container" });
+        if (this.has(token)) {
+            throw new error_class.BaseError("Dependency already exists in container", {
+                code: "CONTAINER_DEPENDENCY_ALREADY_EXISTS",
+                source: "Container",
+            });
+        }
+        this.DEPENDENCIES.set(token, implementation);
+        this.LOGGER.debug(`Dependency registered successfully: ${String(token.description)}`, { source: "Container" });
+    }
+    /**
+     * Register multiple dependencies in the container.
+     * @param {Array<symbol>} tokens Tokens that identify the dependencies.
+     * @param {Array<T>} implementations Implementations of the dependencies.
+     * @template T The type of the dependencies.
+     */
+    registerMany(tokens, implementations) {
+        if (!tokens) {
+            throw new error_class.BaseError("Tokens cannot be null or undefined", {
+                code: "CONTAINER_TOKENS_NOT_NULL_OR_UNDEFINED",
+                source: "Container",
+            });
+        }
+        if (!Array.isArray(tokens)) {
+            throw new error_class.BaseError("Tokens must be an array", {
+                code: "CONTAINER_TOKENS_NOT_ARRAY",
+                source: "Container",
+            });
+        }
+        this.LOGGER.debug(`Registering ${String(tokens.length)} dependencies`, { source: "Container" });
+        // eslint-disable-next-line @elsikora/no-secrets/no-pattern-match
+        for (const token of tokens) {
+            this.register(token, implementations[token]);
+        }
+        this.LOGGER.debug(`${String(tokens.length)} dependencies registered successfully`, { source: "Container" });
+    }
+    /**
+     * Remove a dependency from the container.
+     * @param {symbol} token Token that identifies the dependency.
+     */
+    unregister(token) {
+        if (!token) {
+            throw new error_class.BaseError("Token cannot be null or undefined", {
+                code: "CONTAINER_TOKEN_NOT_NULL_OR_UNDEFINED",
+                source: "Container",
+            });
+        }
+        this.LOGGER.debug(`Unregistering dependency with token: ${String(token.description)}`, { source: "Container" });
+        const wasDeleted = this.DEPENDENCIES.delete(token);
+        if (wasDeleted) {
+            this.LOGGER.debug(`Dependency unregistered successfully: ${String(token.description)}`, { source: "Container" });
+        }
+        else {
+            this.LOGGER.debug(`Dependency not found for unregistering: ${String(token.description)}`, { source: "Container" });
+        }
+    }
+    /**
+     * Remove multiple dependencies from the container.
+     * @param {Array<symbol>} tokens Tokens that identify the dependencies.
+     */
+    unregisterMany(tokens) {
+        if (!tokens) {
+            throw new error_class.BaseError("Tokens cannot be null or undefined", {
+                code: "CONTAINER_TOKENS_NOT_NULL_OR_UNDEFINED",
+                source: "Container",
+            });
+        }
+        if (!Array.isArray(tokens)) {
+            throw new error_class.BaseError("Tokens must be an array", {
+                code: "CONTAINER_TOKENS_NOT_ARRAY",
+                source: "Container",
+            });
+        }
+        this.LOGGER.debug(`Unregistering ${String(tokens.length)} dependencies`, { source: "Container" });
+        // eslint-disable-next-line @elsikora/no-secrets/no-pattern-match
+        for (const token of tokens) {
+            this.unregister(token);
+        }
+        this.LOGGER.debug(`${String(tokens.length)} dependencies unregistered`, { source: "Container" });
+    }
+}
+
+exports.BaseContainer = BaseContainer;
+//# sourceMappingURL=container.class.js.map

package/dist/cjs/infrastructure/class/base/container.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.class.js","sources":["../../../../../../src/infrastructure/class/base/container.class.ts"],"sourcesContent":[null],"names":["ConsoleLoggerService","BaseError"],"mappings":"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"}

package/dist/cjs/infrastructure/class/base/error.class.d.ts

@@ -0,0 +1,18 @@
+import type { IError } from '../../../src/domain/interface/index';
+import type { IBaseErrorOptions } from '../../../src/infrastructure/interface/base/index';
+/**
+ * Base error class.
+ */
+export declare class BaseError extends Error implements IError {
+    readonly CAUSE?: Error;
+    readonly CODE: string;
+    readonly CONTEXT?: Record<string, unknown>;
+    readonly SOURCE?: string;
+    /**
+     * Creates a new base error.
+     * @param {string} message Error message.
+     * @param {IBaseErrorOptions} options Error options.
+     */
+    constructor(message: string, options: IBaseErrorOptions);
+}
+//# sourceMappingURL=error.class.d.ts.map

package/dist/cjs/infrastructure/class/base/error.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.class.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/class/base/error.class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAM,YAAW,MAAM;IACrD,SAAgB,KAAK,CAAC,EAAE,KAAK,CAAC;IAE9B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElD,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhC;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB;CAYvD"}

package/dist/cjs/infrastructure/class/base/error.class.js

@@ -0,0 +1,30 @@
+'use strict';
+
+/**
+ * Base error class.
+ */
+class BaseError extends Error {
+    CAUSE;
+    CODE;
+    CONTEXT;
+    SOURCE;
+    /**
+     * Creates a new base error.
+     * @param {string} message Error message.
+     * @param {IBaseErrorOptions} options Error options.
+     */
+    constructor(message, options) {
+        super(message);
+        this.name = this.constructor.name;
+        this.CAUSE = options.cause;
+        this.CODE = options.code;
+        this.CONTEXT = options.context;
+        this.SOURCE = options.source;
+        if (typeof Error.captureStackTrace === "function") {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+
+exports.BaseError = BaseError;
+//# sourceMappingURL=error.class.js.map

package/dist/cjs/infrastructure/class/base/error.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.class.js","sources":["../../../../../../src/infrastructure/class/base/error.class.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA;;AAEG;AACG,MAAO,SAAU,SAAQ,KAAK,CAAA;AACnB,IAAA,KAAK;AAEL,IAAA,IAAI;AAEJ,IAAA,OAAO;AAEP,IAAA,MAAM;AAEtB;;;;AAIG;IACH,WAAY,CAAA,OAAe,EAAE,OAA0B,EAAA;QACtD,KAAK,CAAC,OAAO,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI;AACjC,QAAA,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK;AAC1B,QAAA,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;AACxB,QAAA,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO;AAC9B,QAAA,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAE5B,QAAA,IAAI,OAAO,KAAK,CAAC,iBAAiB,KAAK,UAAU,EAAE;YAClD,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC;;;AAGjD;;;;"}

package/dist/cjs/infrastructure/class/base/factory.class.d.ts

@@ -0,0 +1,38 @@
+import type { IFactory } from '../../../src/domain/interface/factory.interface';
+import type { IRegistry } from '../../../src/domain/interface/registry.interface';
+import type { IBaseFactoryOptions } from '../../../src/infrastructure/interface/base/index';
+/**
+ * Generic factory implementation that creates items by name using a registry as data source.
+ * @template T The type of items created by the factory.
+ */
+export declare class BaseFactory<T> implements IFactory<T> {
+    private readonly CACHE;
+    private readonly LOGGER;
+    private readonly REGISTRY;
+    private readonly TRANSFORMER?;
+    /**
+     * Creates a new factory instance.
+     * @param {IBaseFactoryOptions<T>} options Factory creation options including registry, optional transformer, and logger.
+     */
+    constructor(options: IBaseFactoryOptions<T>);
+    /**
+     * Clear the factory's item cache.
+     * This should be called when the registry changes to ensure the factory
+     * doesn't return stale items.
+     * @param {string} [name] Optional name of the item to clear from cache. If not provided, all items are cleared.
+     */
+    clearCache(name?: string): void;
+    /**
+     * Create an item by name.
+     * @param {string} name The name of the item to create.
+     * @returns {T} The created item.
+     * @throws RegistryItemNotFoundError if no item with the given name exists in the registry.
+     */
+    create(name: string): T;
+    /**
+     * Get the registry associated with this factory.
+     * @returns {IRegistry<T>} The registry instance.
+     */
+    getRegistry(): IRegistry<T>;
+}
+//# sourceMappingURL=factory.class.d.ts.map

package/dist/cjs/infrastructure/class/base/factory.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.class.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/class/base/factory.class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAM1E;;;GAGG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IAEvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IAExC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAqB;IAElD;;;OAGG;gBACS,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAO3C;;;;;OAKG;IACI,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAUtC;;;;;OAKG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC;IAgC9B;;;OAGG;IACI,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC;CAGlC"}

package/dist/cjs/infrastructure/class/base/factory.class.js

@@ -0,0 +1,79 @@
+'use strict';
+
+var consoleLogger_service = require('../../service/console-logger.service.js');
+var error_class = require('./error.class.js');
+
+/**
+ * Generic factory implementation that creates items by name using a registry as data source.
+ * @template T The type of items created by the factory.
+ */
+class BaseFactory {
+    CACHE;
+    LOGGER;
+    REGISTRY;
+    TRANSFORMER;
+    /**
+     * Creates a new factory instance.
+     * @param {IBaseFactoryOptions<T>} options Factory creation options including registry, optional transformer, and logger.
+     */
+    constructor(options) {
+        this.REGISTRY = options.registry;
+        this.TRANSFORMER = options.transformer;
+        this.LOGGER = options.logger ?? new consoleLogger_service.ConsoleLoggerService();
+        this.CACHE = new Map();
+    }
+    /**
+     * Clear the factory's item cache.
+     * This should be called when the registry changes to ensure the factory
+     * doesn't return stale items.
+     * @param {string} [name] Optional name of the item to clear from cache. If not provided, all items are cleared.
+     */
+    clearCache(name) {
+        if (name) {
+            this.CACHE.delete(name);
+            this.LOGGER.debug(`Cache cleared for item: ${name}`, { source: "Factory" });
+        }
+        else {
+            this.CACHE.clear();
+            this.LOGGER.debug("Factory cache cleared", { source: "Factory" });
+        }
+    }
+    /**
+     * Create an item by name.
+     * @param {string} name The name of the item to create.
+     * @returns {T} The created item.
+     * @throws RegistryItemNotFoundError if no item with the given name exists in the registry.
+     */
+    create(name) {
+        this.LOGGER.debug(`Creating item: ${name}`, { source: "Factory" });
+        const cachedItem = this.CACHE.get(name);
+        if (cachedItem) {
+            this.LOGGER.debug(`Retrieved item from cache: ${name}`, { source: "Factory" });
+            // eslint-disable-next-line @elsikora/node/no-unsupported-features/node-builtins
+            return structuredClone(cachedItem);
+        }
+        const template = this.REGISTRY.get(name);
+        if (!template) {
+            throw new error_class.BaseError("Template not found", {
+                code: "TEMPLATE_NOT_FOUND",
+                source: "Factory",
+            });
+        }
+        // eslint-disable-next-line @elsikora/node/no-unsupported-features/node-builtins
+        const result = this.TRANSFORMER ? this.TRANSFORMER(template) : structuredClone(template);
+        this.CACHE.set(name, result);
+        this.LOGGER.debug(`Created item: ${name}`, { source: "Factory" });
+        // eslint-disable-next-line @elsikora/node/no-unsupported-features/node-builtins
+        return structuredClone(result);
+    }
+    /**
+     * Get the registry associated with this factory.
+     * @returns {IRegistry<T>} The registry instance.
+     */
+    getRegistry() {
+        return this.REGISTRY;
+    }
+}
+
+exports.BaseFactory = BaseFactory;
+//# sourceMappingURL=factory.class.js.map

package/dist/cjs/infrastructure/class/base/factory.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.class.js","sources":["../../../../../../src/infrastructure/class/base/factory.class.ts"],"sourcesContent":[null],"names":["ConsoleLoggerService","BaseError"],"mappings":";;;;;AASA;;;AAGG;MACU,WAAW,CAAA;AACN,IAAA,KAAK;AAEL,IAAA,MAAM;AAEN,IAAA,QAAQ;AAER,IAAA,WAAW;AAE5B;;;AAGG;AACH,IAAA,WAAA,CAAY,OAA+B,EAAA;AAC1C,QAAA,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ;AAChC,QAAA,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW;QACtC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAIA,0CAAoB,EAAE;AAC1D,QAAA,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAa;;AAGlC;;;;;AAKG;AACI,IAAA,UAAU,CAAC,IAAa,EAAA;QAC9B,IAAI,IAAI,EAAE;AACT,YAAA,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;AACvB,YAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAA2B,wBAAA,EAAA,IAAI,CAAE,CAAA,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;;aACrE;AACN,YAAA,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE;AAClB,YAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;;;AAInE;;;;;AAKG;AACI,IAAA,MAAM,CAAC,IAAY,EAAA;AACzB,QAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAkB,eAAA,EAAA,IAAI,CAAE,CAAA,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAElE,MAAM,UAAU,GAAkB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAEtD,IAAI,UAAU,EAAE;AACf,YAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAA8B,2BAAA,EAAA,IAAI,CAAE,CAAA,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;;AAG9E,YAAA,OAAO,eAAe,CAAI,UAAU,CAAC;;QAGtC,MAAM,QAAQ,GAAkB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QAEvD,IAAI,CAAC,QAAQ,EAAE;AACd,YAAA,MAAM,IAAIC,qBAAS,CAAC,oBAAoB,EAAE;AACzC,gBAAA,IAAI,EAAE,oBAAoB;AAC1B,gBAAA,MAAM,EAAE,SAAS;AACjB,aAAA,CAAC;;;QAIH,MAAM,MAAM,GAAM,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAI,QAAQ,CAAC;QAE9F,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC;AAE5B,QAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAiB,cAAA,EAAA,IAAI,CAAE,CAAA,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;;AAGjE,QAAA,OAAO,eAAe,CAAI,MAAM,CAAC;;AAGlC;;;AAGG;IACI,WAAW,GAAA;QACjB,OAAO,IAAI,CAAC,QAAQ;;AAErB;;;;"}

package/dist/cjs/infrastructure/class/base/index.d.ts

@@ -0,0 +1,5 @@
+export { BaseContainer } from "./container.class";
+export { BaseError } from "./error.class";
+export { BaseFactory } from "./factory.class";
+export { BaseRegistry } from "./registry.class";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/infrastructure/class/base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/class/base/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}