@elsikora/cladi 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ElsiKora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,325 @@
+<p align="center">
+  <img src="https://6jft62zmy9nx2oea.public.blob.vercel-storage.com/cladi-eBDDJPOc5fj21RO45PzAwrdkkqGCHi.png" width="500" alt="project-logo">
+</p>
+
+<h1 align="center">ClaDI 🧩</h1>
+<p align="center"><em>ClaDI is a library for creating and managing classes in TypeScript</em></p>
+
+<p align="center">
+    <a aria-label="ElsiKora logo" href="https://elsikora.com">
+  <img src="https://img.shields.io/badge/MADE%20BY%20ElsiKora-333333.svg?style=for-the-badge" alt="ElsiKora">
+</a> <img src="https://img.shields.io/badge/typescript-blue.svg?style=for-the-badge&logo=typescript&logoColor=white" alt="typescript"> <img src="https://img.shields.io/badge/npm-red.svg?style=for-the-badge&logo=npm&logoColor=white" alt="npm"> <img src="https://img.shields.io/badge/license-MIT-yellow.svg?style=for-the-badge&logo=license&logoColor=white" alt="license-MIT"> <img src="https://img.shields.io/badge/Node.js-green.svg?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js"> <img src="https://img.shields.io/badge/ESM-orange.svg?style=for-the-badge&logo=javascript&logoColor=white" alt="ESM"> <img src="https://img.shields.io/badge/CJS-teal.svg?style=for-the-badge&logo=javascript&logoColor=white" alt="CJS"> <img src="https://img.shields.io/badge/zero-deps-brightgreen.svg?style=for-the-badge&logo=checkmarx&logoColor=white" alt="zero-deps">
+</p>
+
+
+## 📚 Table of Contents
+- [Description](#-description)
+- [Features](#-features)
+- [Installation](#-installation)
+- [Usage](#-usage)
+- [Roadmap](#-roadmap)
+- [FAQ](#-faq)
+- [License](#-license)
+
+
+## 📖 Description
+ClaDI is a powerful TypeScript library that provides a robust foundation for building scalable applications through class-based dependency injection. With ClaDI, you can easily create, manage, and organize your application's classes and dependencies with a clean, modular architecture. The library offers a comprehensive set of tools for class instantiation, dependency registration, and lifecycle management, making it ideal for both small projects and enterprise-level applications. Whether you're building a simple utility or a complex system, ClaDI helps establish a solid architectural foundation with minimal overhead.
+
+## 🚀 Features
+- ✨ **🚀 Zero dependencies - Lightweight footprint with no external runtime dependencies**
+- ✨ **📦 Registry system - Store, retrieve, and manage class templates efficiently**
+- ✨ **🏭 Factory pattern - Create class instances with automatic deep cloning**
+- ✨ **💉 Dependency injection - Simple yet powerful container for managing application services**
+- ✨ **🔄 Caching mechanism - Performance optimization for frequently used classes**
+- ✨ **🧩 Modular architecture - Clean separation of concerns with domain, infrastructure, and presentation layers**
+- ✨ **📝 Comprehensive logging - Built-in logging system with multiple log levels and context support**
+- ✨ **🔌 Multiple format support - Works with both ESM and CommonJS module systems**
+- ✨ **✅ Fully tested - Extensive unit and E2E test coverage ensures reliability**
+
+## 🛠 Installation
+```bash
+# Using npm
+npm install @elsikora/cladi
+
+# Using yarn
+yarn add @elsikora/cladi
+
+# Using pnpm
+pnpm add @elsikora/cladi
+
+# Using bun
+bun add @elsikora/cladi
+```
+
+## 💡 Usage
+## Basic Usage
+
+The following example demonstrates how to create and use the core components of ClaDI:
+
+```typescript
+import { createContainer, createFactory, createLogger, createRegistry, ELoggerLogLevel } from '@elsikora/cladi';
+
+// Define a simple model with required 'name' property
+interface User {
+  name: string;
+  email: string;
+  role: string;
+}
+
+// Create a logger
+const logger = createLogger({ 
+  level: ELoggerLogLevel.DEBUG,
+  source: 'UserModule' 
+});
+
+// Create a registry to store user templates
+const registry = createRegistry<User>({ logger });
+
+// Register user templates
+registry.register({ name: 'admin', email: 'admin@example.com', role: 'admin' });
+registry.register({ name: 'user', email: 'user@example.com', role: 'user' });
+
+// Create a factory to instantiate users from templates
+const factory = createFactory<User>({ registry, logger });
+
+// Create a user instance (returns a deep clone of the template)
+const adminUser = factory.create('admin');
+console.log(adminUser); // { name: 'admin', email: 'admin@example.com', role: 'admin' }
+
+// Modify instance (won't affect the original template)
+adminUser.email = 'new-admin@example.com';
+```
+
+## Dependency Injection Container
+
+Use the container to manage application services:
+
+```typescript
+import { createContainer, ELoggerLogLevel, type ILogger } from '@elsikora/cladi';
+
+// Create symbols for service identification
+const LoggerToken = Symbol('Logger');
+const DatabaseToken = Symbol('Database');
+
+// Create a container
+const container = createContainer({});
+
+// Register services
+container.register(LoggerToken, createLogger({ 
+  level: ELoggerLogLevel.INFO,
+  source: 'AppRoot' 
+}));
+
+container.register(DatabaseToken, {
+  connect: () => console.log('Connected to database'),
+  query: (sql: string) => console.log(`Executing query: ${sql}`)
+});
+
+// Retrieve services
+const logger = container.get<ILogger>(LoggerToken);
+const db = container.get(DatabaseToken);
+
+logger?.info('Application started');
+db?.connect();
+db?.query('SELECT * FROM users');
+```
+
+## Advanced Logging
+
+The built-in logger provides extensive capabilities:
+
+```typescript
+import { createLogger, ELoggerLogLevel } from '@elsikora/cladi';
+
+const logger = createLogger({
+  level: ELoggerLogLevel.TRACE,  // Most detailed logging level
+  source: 'PaymentService'
+});
+
+// Basic logging
+logger.info('Processing payment');
+
+// Logging with context data
+logger.debug('Payment details received', {
+  context: {
+    paymentId: '12345',
+    amount: 99.99,
+    currency: 'USD'
+  }
+});
+
+// Method-specific source
+logger.warn('Retry attempt required', {
+  source: 'PaymentGateway',  // Will be combined with constructor source
+  context: {
+    attempt: 2,
+    maxAttempts: 3
+  }
+});
+
+// Sample output:
+// [2023-07-15T12:34:56.789Z] INFO: [PaymentService] Processing payment
+// [2023-07-15T12:34:56.790Z] DEBUG: [PaymentService] Payment details received {"paymentId":"12345","amount":99.99,"currency":"USD"}
+// [2023-07-15T12:34:56.791Z] WARN: [PaymentService → PaymentGateway] Retry attempt required {"attempt":2,"maxAttempts":3}
+```
+
+## Core Factory Pattern
+
+For more advanced scenarios, use the CoreFactory singleton:
+
+```typescript
+import { CoreFactory, ELoggerLogLevel, type IRegistry, type IFactory, type IContainer } from '@elsikora/cladi';
+
+// Create the core factory instance with options
+const coreFactory = CoreFactory.getInstance({
+  logger: createLogger({
+    level: ELoggerLogLevel.INFO,
+    source: 'CoreFactory'
+  })
+});
+
+// Define a product model
+interface Product {
+  name: string;
+  price: number;
+  inStock: boolean;
+}
+
+// Create infrastructure components
+const productRegistry = coreFactory.createRegistry<Product>({});
+const productFactory = coreFactory.createFactory<Product>({ registry: productRegistry });
+const appContainer = coreFactory.createContainer({});
+
+// Register product templates
+productRegistry.register({ name: 'Basic Widget', price: 9.99, inStock: true });
+productRegistry.register({ name: 'Premium Widget', price: 19.99, inStock: false });
+
+// Create product instances
+const basicWidget = productFactory.create('Basic Widget');
+console.log(basicWidget); // { name: 'Basic Widget', price: 9.99, inStock: true }
+```
+
+## Custom Transformers
+
+You can provide custom transformers to modify objects during instantiation:
+
+```typescript
+import { createFactory, createRegistry } from '@elsikora/cladi';
+
+interface OrderTemplate {
+  name: string;
+  basePrice: number;
+  discountPercent: number;
+}
+
+// Create registry and register templates
+const orderRegistry = createRegistry<OrderTemplate>({});
+orderRegistry.register({
+  name: 'standard',
+  basePrice: 100,
+  discountPercent: 0
+});
+orderRegistry.register({
+  name: 'sale',
+  basePrice: 100,
+  discountPercent: 20
+});
+
+// Custom transformer that adds calculated fields
+const orderTransformer = (template: OrderTemplate) => {
+  const discount = template.basePrice * (template.discountPercent / 100);
+  return {
+    ...template,
+    discount,
+    finalPrice: template.basePrice - discount,
+    timestamp: new Date().toISOString()
+  };
+};
+
+// Create factory with custom transformer
+const orderFactory = createFactory<ReturnType<typeof orderTransformer>>({
+  registry: orderRegistry as any,
+  transformer: orderTransformer
+});
+
+// Create instances with transformed properties
+const standardOrder = orderFactory.create('standard');
+console.log(standardOrder);
+// {
+//   name: 'standard',
+//   basePrice: 100,
+//   discountPercent: 0,
+//   discount: 0,
+//   finalPrice: 100,
+//   timestamp: '2023-07-15T12:34:56.789Z'
+// }
+
+const saleOrder = orderFactory.create('sale');
+console.log(saleOrder);
+// {
+//   name: 'sale',
+//   basePrice: 100,
+//   discountPercent: 20,
+//   discount: 20,
+//   finalPrice: 80,
+//   timestamp: '2023-07-15T12:34:56.790Z'
+// }
+```
+
+## 🛣 Roadmap
+| Task / Feature | Status |
+|----------------|--------|
+| Core Registry implementation | ✅ Done |
+| Core Factory implementation | ✅ Done |
+| Dependency Injection Container | ✅ Done |
+| Logging System | ✅ Done |
+| Support for ESM and CJS modules | ✅ Done |
+| Registry caching mechanism | ✅ Done |
+| Factory deep cloning | ✅ Done |
+| Custom transformers | ✅ Done |
+| API documentation | 🚧 In Progress |
+| Type safety improvements | 🚧 In Progress |
+| Async factory support | 🚧 In Progress |
+| Schema validation | 🚧 In Progress |
+| Event system | 🚧 In Progress |
+| Circular dependency detection | 🚧 In Progress |
+| Lifecycle hooks | 🚧 In Progress |
+| Lazy loading | 🚧 In Progress |
+| Serialization/deserialization utilities | 🚧 In Progress |
+| Performance benchmarks | 🚧 In Progress |
+| Web framework integrations | 🚧 In Progress |
+
+## ❓ FAQ
+## Frequently Asked Questions
+
+### Is ClaDI suitable for small projects?
+Yes, ClaDI is designed to be scalable for projects of all sizes. For small projects, you can use just the components you need, such as the Registry and Factory, without implementing the full dependency injection system.
+
+### How does ClaDI compare to other DI frameworks like InversifyJS or TypeDI?
+ClaDI is more lightweight and focused, with zero external dependencies. It provides core building blocks rather than a full-featured DI framework. It's suitable for projects that need a clean, extensible foundation with minimal overhead.
+
+### Does ClaDI work with browser environments?
+Yes, ClaDI is designed to work in both Node.js and browser environments. It's built with ES modules and also provides CommonJS compatibility.
+
+### How does the registry's caching mechanism work?
+The registry implements an internal cache for `getAll()` and `getMany()` operations. When you register or unregister items, the cache is automatically cleared to ensure you always get fresh data.
+
+### Can I use ClaDI with React, Angular, or Vue?
+Yes, ClaDI can be used with any frontend framework. It's framework-agnostic and provides core infrastructure that can be integrated into your component system.
+
+### How do I handle circular dependencies?
+Currently, circular dependencies must be managed manually. However, the roadmap includes adding circular dependency detection to help identify and resolve these issues.
+
+### Is there a performance penalty for using the factory pattern?
+The factory performs deep cloning of templates using `structuredClone()`, which has better performance than JSON serialization methods. For most applications, this overhead is negligible, and the benefits of immutability outweigh the performance cost.
+
+## 🔒 License
+This project is licensed under **MIT License
+
+Copyright (c) 2025 ElsiKora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.**.

package/dist/cjs/domain/enum/index.d.ts

@@ -0,0 +1,3 @@
+export { ELoggerLogLevel } from "./logger-log-level.enum";
+export { EServiceToken } from "./service-token.enum";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/enum/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/cjs/domain/enum/logger-log-level.enum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Log levels.
+ */
+export declare enum ELoggerLogLevel {
+    DEBUG = "debug",
+    ERROR = "error",
+    INFO = "info",
+    TRACE = "trace",
+    WARN = "warn"
+}
+//# sourceMappingURL=logger-log-level.enum.d.ts.map

package/dist/cjs/domain/enum/logger-log-level.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-log-level.enum.d.ts","sourceRoot":"","sources":["../../../../src/domain/enum/logger-log-level.enum.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,eAAe;IAC1B,KAAK,UAAU;IACf,KAAK,UAAU;IACf,IAAI,SAAS;IACb,KAAK,UAAU;IACf,IAAI,SAAS;CACb"}

package/dist/cjs/domain/enum/logger-log-level.enum.js

@@ -0,0 +1,14 @@
+'use strict';
+
+/**
+ * Log levels.
+ */
+exports.ELoggerLogLevel = void 0;
+(function (ELoggerLogLevel) {
+    ELoggerLogLevel["DEBUG"] = "debug";
+    ELoggerLogLevel["ERROR"] = "error";
+    ELoggerLogLevel["INFO"] = "info";
+    ELoggerLogLevel["TRACE"] = "trace";
+    ELoggerLogLevel["WARN"] = "warn";
+})(exports.ELoggerLogLevel || (exports.ELoggerLogLevel = {}));
+//# sourceMappingURL=logger-log-level.enum.js.map

package/dist/cjs/domain/enum/logger-log-level.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-log-level.enum.js","sources":["../../../../../src/domain/enum/logger-log-level.enum.ts"],"sourcesContent":[null],"names":["ELoggerLogLevel"],"mappings":";;AAAA;;AAEG;AACSA;AAAZ,CAAA,UAAY,eAAe,EAAA;AAC1B,IAAA,eAAA,CAAA,OAAA,CAAA,GAAA,OAAe;AACf,IAAA,eAAA,CAAA,OAAA,CAAA,GAAA,OAAe;AACf,IAAA,eAAA,CAAA,MAAA,CAAA,GAAA,MAAa;AACb,IAAA,eAAA,CAAA,OAAA,CAAA,GAAA,OAAe;AACf,IAAA,eAAA,CAAA,MAAA,CAAA,GAAA,MAAa;AACd,CAAC,EANWA,uBAAe,KAAfA,uBAAe,GAM1B,EAAA,CAAA,CAAA;;"}

package/dist/cjs/domain/enum/service-token.enum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Service tokens for dependency injection.
+ */
+export declare enum EServiceToken {
+    CONTAINER = "container",
+    FACTORY = "factory",
+    LOGGER = "logger",
+    REGISTRY = "registry"
+}
+//# sourceMappingURL=service-token.enum.d.ts.map

package/dist/cjs/domain/enum/service-token.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-token.enum.d.ts","sourceRoot":"","sources":["../../../../src/domain/enum/service-token.enum.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,aAAa;IACxB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACrB"}

package/dist/cjs/domain/enum/service-token.enum.js

@@ -0,0 +1,13 @@
+'use strict';
+
+/**
+ * Service tokens for dependency injection.
+ */
+exports.EServiceToken = void 0;
+(function (EServiceToken) {
+    EServiceToken["CONTAINER"] = "container";
+    EServiceToken["FACTORY"] = "factory";
+    EServiceToken["LOGGER"] = "logger";
+    EServiceToken["REGISTRY"] = "registry";
+})(exports.EServiceToken || (exports.EServiceToken = {}));
+//# sourceMappingURL=service-token.enum.js.map

package/dist/cjs/domain/enum/service-token.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-token.enum.js","sources":["../../../../../src/domain/enum/service-token.enum.ts"],"sourcesContent":[null],"names":["EServiceToken"],"mappings":";;AAAA;;AAEG;AACSA;AAAZ,CAAA,UAAY,aAAa,EAAA;AACxB,IAAA,aAAA,CAAA,WAAA,CAAA,GAAA,WAAuB;AACvB,IAAA,aAAA,CAAA,SAAA,CAAA,GAAA,SAAmB;AACnB,IAAA,aAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,aAAA,CAAA,UAAA,CAAA,GAAA,UAAqB;AACtB,CAAC,EALWA,qBAAa,KAAbA,qBAAa,GAKxB,EAAA,CAAA,CAAA;;"}

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

@@ -0,0 +1,3 @@
+export * from "./enum";
+export type * from "./interface";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,mBAAmB,aAAa,CAAC"}

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

@@ -0,0 +1,55 @@
+/**
+ * Simple dependency injection container interface.
+ */
+export interface IContainer {
+    /**
+     * Clear all dependencies from the container.
+     */
+    clear(): void;
+    /**
+     * Get a dependency from the container.
+     * @param token Token that identifies the dependency.
+     * @returns The dependency, or undefined if it doesn't exist.
+     */
+    get<T>(token: symbol): T | undefined;
+    /**
+     * Get all dependencies from the container.
+     * @returns An array of all dependencies.
+     */
+    getAll(): Array<unknown>;
+    /**
+     * Get multiple dependencies from the container.
+     * @param tokens Tokens that identify the dependencies.
+     * @returns An array of dependencies.
+     */
+    getMany<T>(tokens: Array<symbol>): Array<T>;
+    /**
+     * Check if a dependency exists in the container.
+     * @param token Token that identifies the dependency.
+     * @returns 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.
+     */
+    register<T>(token: symbol, implementation: T): void;
+    /**
+     * Register a dependency in the container.
+     * @param {Array<symbol>} tokens Tokens that identify the dependencies.
+     * @param {Record<symbol, T>} implementations Implementations of the dependencies.
+     */
+    registerMany<T>(tokens: Array<symbol>, implementations: Record<symbol, T>): void;
+    /**
+     * Unregister a dependency from the container.
+     * @param token Token that identifies the dependency.
+     */
+    unregister(token: symbol): void;
+    /**
+     * Unregister multiple dependencies from the container.
+     * @param tokens Tokens that identify the dependencies.
+     */
+    unregisterMany(tokens: Array<symbol>): void;
+}
+//# sourceMappingURL=container.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"container.interface.d.ts","sourceRoot":"","sources":["../../../../src/domain/interface/container.interface.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAErC;;;OAGG;IACH,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAEzB;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAE5C;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAEjF;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAC5C"}

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

@@ -0,0 +1,18 @@
+/**
+ * Standard error interface for all application errors.
+ */
+export interface IError extends Error {
+    /**
+     * Original error that caused this error, if any.
+     */
+    CAUSE?: Error;
+    /**
+     * Error code to uniquely identify error types.
+     */
+    CODE: string;
+    /**
+     * Additional context about the error.
+     */
+    context?: Record<string, unknown>;
+}
+//# sourceMappingURL=error.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.interface.d.ts","sourceRoot":"","sources":["../../../../src/domain/interface/error.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAO,SAAQ,KAAK;IACpC;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC"}

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

@@ -0,0 +1,19 @@
+import type { IRegistry } from "./registry.interface";
+/**
+ * Generic factory interface for creating items by name.
+ * @template T The type of items created by the factory.
+ */
+export interface IFactory<T> {
+    /**
+     * Create an item by name.
+     * @param name The name of the item to create.
+     * @returns The created item.
+     */
+    create(name: string): T;
+    /**
+     * Get the registry associated with this factory.
+     * @returns The registry instance.
+     */
+    getRegistry(): IRegistry<T>;
+}
+//# sourceMappingURL=factory.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.interface.d.ts","sourceRoot":"","sources":["../../../../src/domain/interface/factory.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IAC1B;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;IAExB;;;OAGG;IACH,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC;CAC5B"}

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

@@ -0,0 +1,6 @@
+export type { IContainer } from "./container.interface";
+export type { IError } from "./error.interface";
+export type { IFactory } from "./factory.interface";
+export type * from "./logger/index";
+export type { IRegistry } from "./registry.interface";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/interface/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,mBAAmB,gBAAgB,CAAC;AACpC,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/cjs/domain/interface/logger/index.d.ts

@@ -0,0 +1,3 @@
+export { type ILogger } from "./interface";
+export { type ILoggerMethodOptions } from "./method-options.interface";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/domain/interface/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/domain/interface/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

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

@@ -0,0 +1,37 @@
+import type { ILoggerMethodOptions } from "./method-options.interface";
+/**
+ * Logger interface.
+ */
+export interface ILogger {
+    /**
+     * Log a debug message.
+     * @param message Message to log.
+     * @param options Optional logging options.
+     */
+    debug(message: string, options?: ILoggerMethodOptions): void;
+    /**
+     * Log an error message.
+     * @param message Message to log.
+     * @param options Optional logging options.
+     */
+    error(message: string, options?: ILoggerMethodOptions): void;
+    /**
+     * Log an info message.
+     * @param message Message to log.
+     * @param options Optional logging options.
+     */
+    info(message: string, options?: ILoggerMethodOptions): void;
+    /**
+     * Log a trace message.
+     * @param message Message to log.
+     * @param options Optional logging options.
+     */
+    trace(message: string, options?: ILoggerMethodOptions): void;
+    /**
+     * Log a warning message.
+     * @param message Message to log.
+     * @param options Optional logging options.
+     */
+    warn(message: string, options?: ILoggerMethodOptions): void;
+}
+//# sourceMappingURL=interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../../../src/domain/interface/logger/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,OAAO;IACvB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAE7D;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAE7D;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAE5D;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAE7D;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC5D"}

package/dist/cjs/domain/interface/logger/method-options.interface.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Log options interface.
+ */
+export interface ILoggerMethodOptions {
+    /**
+     * Optional context to include with the log.
+     */
+    context?: Record<string, unknown>;
+    /**
+     * Optional source identifier (e.g. "React", "NestJS Scheduler").
+     */
+    source?: string;
+}
+//# sourceMappingURL=method-options.interface.d.ts.map

package/dist/cjs/domain/interface/logger/method-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-options.interface.d.ts","sourceRoot":"","sources":["../../../../../src/domain/interface/logger/method-options.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB"}