@asenajs/asena 0.3.2 → 0.4.0

package/README.md

@@ -1,226 +1,251 @@
 # Asena
 
-Asena is a NestJS-like IoC web framework built on top of Bun. It combines the power of dependency injection
-with the performance of Bun runtime and the flexibility of Adapter design system.
+A high-performance, NestJS-like IoC web framework built on Bun runtime with full dependency injection support.
 
 ## Documentation
 
-For detailed documentation, please visit [not ready yet](https://asena.sh). Documentation is still in progress, but updates are being made regularly. You can check this project [AsenaExample](https://github.com/LibirSoft/AsenaExample). I am always updating it to latest usages.
+For detailed documentation, visit [asena.sh](https://asena.sh).
+
+Also check out [AsenaExample](https://github.com/LibirSoft/AsenaExample) for latest usage patterns.
 
 ## Key Features
 
-- **Dependency Injection**: Built-in IoC container for managing dependencies
-- **Decorator-based Development**: Similar to NestJS, using TypeScript decorators for routing and DI
-- **High Performance**: Leverages Bun runtime for optimal performance
-- **WebSocket Support**: Built-in WebSocket handling capabilities
-- **Middleware System**: Flexible middleware architecture
-- **HTTP Adapters**: Extensible adapter system with Hono as default
-- **Zero Dependencies**: Only uses reflect-metadata for dependency injection
-- **TypeScript Support**: Full TypeScript support with strict mode
-- **Modular Architecture**: Easy to extend and customize
+- **Full IoC Container**: Field-based dependency injection for all components
+- **Decorator-based**: TypeScript decorators for routing and DI (similar to NestJS)
+- **High Performance**: Built on Bun runtime for optimal speed
+- **WebSocket Support**: Native WebSocket handling
+- **Flexible Middleware**: Multi-level middleware system (global, controller, route)
+- **Adapter System**: Pluggable HTTP adapters (Hono default)
+- **Type-Safe**: Full TypeScript support with strict mode
+- **Zero Config**: Minimal setup required
 
 ## Quick Start
 
-The easiest way to create a new Asena project is using the CLI:
+### Using CLI (Recommended)
 
 ```bash
-# Create a new project
 bun add -D @asenajs/asena-cli
-asena create
-```
-
-This will create a new project with the following structure:
-
-```
-├── src/
-│ ├── controllers/
-│ │ └── AsenaController.ts
-│ └── index.ts
-├── package.json
-├── tsconfig.json
-├── .eslintrc.js
-├── .eslintignore
-└── .prettierrc.js
+asena create my-project
+cd my-project
+asena dev start
 ```
-## Alternative start
-
 
-Alternatively, you can create a project manually:
+### Manual Setup
 
-First, create a new project using Bun:
+Install dependencies:
 
 ```bash
-bun init
+bun add @asenajs/asena @asenajs/hono-adapter @asenajs/asena-logger
+bun add -D @asenajs/asena-cli
 ```
 
-For decorators working properly, you need to add some settings to your tsconfig. Here is a recommended file:
+Configure TypeScript (`tsconfig.json`):
 
 ```json
 {
   "compilerOptions": {
-    // Enable latest features
-    "lib": ["ESNext", "DOM"],
     "target": "ESNext",
     "module": "ESNext",
-    "moduleDetection": "force",
-    "jsx": "react-jsx",
-    "allowJs": true,
+    "moduleResolution": "bundler",
     "experimentalDecorators": true,
     "emitDecoratorMetadata": true,
-
-    // Bundler mode
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true,
-
-    // Best practices
     "strict": true,
-    "skipLibCheck": true,
-    "noFallthroughCasesInSwitch": true,
-
-    // Some stricter flags
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noPropertyAccessFromIndexSignature": true
+    "skipLibCheck": true
   }
 }
 ```
-After that you need to make sure to edit your tsConfig.json it should look like this
-Then, install these packages:
-* `@asenajs/asena`: Base package
-* `@asenajs/hono-adapter`: For web-server. Asena currently only support hono adapter.
-* `@asenajs/asena-logger`: For better logs
-* **OPTIONAL** `@asenajs/asena-drizzle`: For better drizzle integration (completely **optional**) you can check package from here [asena-drizzle](https://github.com/AsenaJs/asena-drizzle) 
-```bash
-bun install @asenajs/asena @asenajs/hono-adapter @asenajs/asena-logger
-```
 
-* `@asenajs/asena-cli`: This package provides a CLI for creating and managing Asena projects.
-
-```bash
-bun install -D @asenajs/asena-cli
-```
-After installation, you need to create asena-config.ts file you can create it with asena-cli
+Initialize config:
 
 ```bash
 asena init
 ```
-this will create you asena-config file.
-
-`Note`: Built options directly copy of bun options, you can check bun documentation for more
-options. [Bun Documentation](https://bun.sh/docs/bundler#reference)
 
-Create index.ts file under your src folder:
+Create your server (`src/index.ts`):
 
 ```typescript
-// src/index.ts
-import {AsenaServer} from '@asenajs/asena';
-import {createHonoAdapter} from '@asenajs/hono-adapter';
-import {logger} from './logger/logger';
+import { AsenaServerFactory } from '@asenajs/asena';
+import { createHonoAdapter } from '@asenajs/hono-adapter';
+import { logger } from './logger';
 
-const [honoAdapter,asenaLogger] = createHonoAdapter(logger);
+const [adapter, asenaLogger] = createHonoAdapter(logger);
 
+const server = await AsenaServerFactory.create({
+  adapter,
+  logger: asenaLogger,
+  port: 3000
+});
 
-await new AsenaServer(honoAdapter, asenaLogger).port(3000).start();
+await server.start();
 ```
 
-To run asena you need at least one controller. Create a new controller:
+Create a controller (`src/controllers/HelloController.ts`):
 
 ```typescript
-// src/controllers/TestController.ts
-import type { Context } from '@asenajs/hono-adapter';
 import { Controller } from '@asenajs/asena/server';
 import { Get } from '@asenajs/asena/web';
+import type { Context } from '@asenajs/hono-adapter';
 
 @Controller('/hello')
-export class TestController {
+export class HelloController {
   @Get('/world')
-  public async getHello(context: Context) {
+  async getHello(context: Context) {
     return context.send('Hello World');
   }
 }
 ```
 
-Finally, run the project:
+## Core Concepts
 
-```bash
-## only for fast developing purposes
-asena dev start
-```
+### Controllers
 
-```bash
-## or you can simply build then run your bundled project
-asena build
-## then go to dist folder and run the project this way it will consume less memory and it will be faster.
-bun index.asena.js
+Handle HTTP requests with decorators:
+
+```typescript
+@Controller('/users')
+export class UserController {
+  @Get('/:id')
+  async getUser(context: Context) {
+    const id = context.req.param('id');
+    return context.json({ id, name: 'John' });
+  }
+
+  @Post('/')
+  async createUser(context: Context) {
+    const body = await context.req.json();
+    return context.json({ success: true });
+  }
+}
 ```
 
-## CLI Commands
+### Services
+
+Business logic with dependency injection:
 
-For more information about CLI commands and usage, please visit:
-[Asena CLI Documentation](https://asena.sh/docs/cli/overview.html)
+```typescript
+@Service()
+export class UserService {
+  async findUser(id: string) {
+    // Your business logic
+    return { id, name: 'John' };
+  }
+}
 
-## Project Structure
+@Controller('/users')
+export class UserController {
+  @Inject(UserService)
+  private userService: UserService;
 
+  @Get('/:id')
+  async getUser(context: Context) {
+    const user = await this.userService.findUser(context.req.param('id'));
+    return context.json(user);
+  }
+}
 ```
-lib/
-├── adapter/     # HTTP adapter implementations
-├── server/      # Core server functionality
-├── ioc/         # Dependency injection container
-├── utils/       # Utility functions
-├── test/        # Test utilities
+
+### Middleware
+
+Multi-level middleware support:
+
+```typescript
+@Middleware()
+export class AuthMiddleware extends MiddlewareService {
+  async handle(context: Context, next: Function) {
+    // Check authentication
+    await next();
+  }
+}
+
+// Global middleware via Config
+@Config()
+export class AppConfig {
+  globalMiddlewares() {
+    return [
+      LoggerMiddleware,  // Apply to all routes
+
+      // Pattern-based
+      {
+        middleware: AuthMiddleware,
+        routes: { include: ['/api/*', '/admin/*'] }
+      },
+      {
+        middleware: RateLimitMiddleware,
+        routes: { exclude: ['/health', '/metrics'] }
+      }
+    ];
+  }
+}
+
+// Controller-level
+@Controller({ path: '/admin', middlewares: [AuthMiddleware] })
+export class AdminController { }
+
+// Route-level
+@Get({ path: '/users', middlewares: [AuthMiddleware] })
+async getUsers(context: Context) { }
 ```
 
-## Core Concepts
+### WebSocket
 
-- **Controllers**: Handle incoming requests using decorators
-- **Services**: Business logic containers that can be injected
-- **Middleware**: Request/Response interceptors
-- **WebSocket**: Built-in WebSocket support
-- **HTTP Status**: Standard HTTP status codes and utilities
+Built-in WebSocket support:
 
-## Performance
+```typescript
+@WebSocket('/chat')
+export class ChatSocket extends AsenaWebSocketService {
+  onOpen(ws: Socket) {
+    ws.send('Welcome!');
+  }
 
-Built on Bun runtime, Asena provides:
+  onMessage(ws: Socket, message: string) {
+    ws.send(`Echo: ${message}`);
+  }
+}
+```
 
-- Fast startup time
-- Low memory footprint
-- Quick request processing
-- Efficient WebSocket handling
+## CLI Commands
 
-Here is the benchmark result of Asena with Hono adapter (Basic hello world example) in every test we used bun to run
-the project:
+```bash
+asena create          # Create new project
+asena init            # Initialize config
+asena dev start       # Development mode
+asena build           # Production build
+```
+
+Full CLI documentation: [asena.sh/docs/cli](https://asena.sh/docs/cli/overview.html)
+
+## Performance
 
-### Performance Comparison (Fastest to Slowest)
+Built on Bun runtime for exceptional performance:
 
-| Framework                            | Requests/sec | Latency (avg) | Transfer/sec |
-| ------------------------------------ | ------------ | ------------- | ------------ |
-| Hono                                 | 147,031.08   | 2.69ms        | 18.09MB      |
-| Asena + Hono-adapter                 | 137,148.80   | 2.89ms        | 16.74MB      |
-| NestJS (Bun + Fastify)               | 81,652.05    | 6.01ms        | 13.78MB      |
-| NestJS (Bun)                         | 64,435.83    | 6.14ms        | 11.80MB      |
-| NestJS (Bun + kiyasov/platform-hono) | 45,082.27    | 8.79ms        | 5.55MB       |
-| NestJS (Node)                        | 17,649.89    | 24.43ms       | 4.02MB       |
+| Framework                | Requests/sec          | Latency (avg) |
+|--------------------------|-----------------------|---------------|
+| **Asena + Ergenecore**   | **294962.61**         | **1.34ms**    |
+| Hono                     | 266476.83             | 1.49ms        |
+| **Asena + Hono-adapter** | **233182.35**         | **1.70ms**    |
+| NestJS (Bun)             | 100975.20             | 3.92ms        |
+| NestJS (Node)            | 88083.22              | 5.33ms        |
 
-> Benchmark conditions:
->
-> - 12 threads
-> - 400 connections
-> - 120 seconds duration
-> - Simple "Hello World" endpoint
-> - Running on same hardware
+> Benchmark: 12 threads, 400 connections, 120s duration, Hello World endpoint
 
-_Note: Lower latency and higher requests/sec indicate better performance_
+## Architecture
+
+```
+lib/
+├── ioc/           # IoC container & dependency injection
+├── server/        # Core server & routing
+├── adapter/       # HTTP adapter abstraction
+└── utils/         # Utilities & helpers
+```
 
 ## Contributing
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+Contributions welcome! Submit a Pull Request on [GitHub](https://github.com/AsenaJs/Asena).
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+MIT License - see [LICENSE](LICENSE) file.
 
 ## Support
 
-If you encounter any issues or have questions, please open an issue on the [GitHub repository](https://github.com/AsenaJs/Asena/issues).
+Issues or questions? Open an issue on [GitHub](https://github.com/AsenaJs/Asena/issues).

package/dist/index.d.ts

@@ -1 +1,2 @@
-export { AsenaServer } from './lib/server';
+export { AsenaServerFactory, AsenaServer } from './lib/server';
+export { ICoreServiceNames, ComponentConstants } from './lib/ioc';

package/dist/index.js

@@ -1,2 +1,3 @@
-export { AsenaServer } from './lib/server';
+export { AsenaServerFactory, AsenaServer } from './lib/server';
+export { ICoreServiceNames, ComponentConstants } from './lib/ioc';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}

package/dist/lib/adapter/AsenaAdapter.d.ts

@@ -3,6 +3,7 @@ import type { Server } from 'bun';
 import type { AsenaWebsocketAdapter } from './AsenaWebsocketAdapter';
 import type { ServerLogger } from '../logger';
 import type { AsenaContext } from './AsenaContext';
+import type { GlobalMiddlewareRouteConfig } from '../server/config';
 /**
  * Abstract class representing an adapter for the Asena framework.
  * This adapter serves as a base interface between the framework and different server implementations.
@@ -40,10 +41,25 @@ export declare abstract class AsenaAdapter<C extends AsenaContext<any, any>, VS>
     abstract setPort(port: number): void;
     /**
      * Registers middleware to the application
+     *
      * @param middleware - Middleware implementation
-     * @param path - Optional path to apply the middleware to
+     * @param config - Optional route configuration for pattern matching
+     *
+     * @example
+     * ```typescript
+     * // Old API (still supported)
+     * adapter.use(middleware);
+     *
+     * // New API with pattern matching
+     * adapter.use(middleware, {
+     *   routes: {
+     *     include: ['/api/*'],
+     *     exclude: ['/api/health']
+     *   }
+     * });
+     * ```
      */
-    abstract use(middleware: BaseMiddleware<C>, path?: string): Promise<void> | void;
+    abstract use(middleware: BaseMiddleware<C>, config?: GlobalMiddlewareRouteConfig): Promise<void> | void;
     /**
      * Registers a new route with the application
      * @param params - Route configuration parameters
@@ -63,7 +79,7 @@ export declare abstract class AsenaAdapter<C extends AsenaContext<any, any>, VS>
      * Initializes and starts the server
      * @returns Server instance
      */
-    abstract start(): Promise<Server> | Server;
+    abstract start(): Promise<Server<any>> | Server<any>;
     /**
      * Sets up global error handling
      * @param errorHandler - Error handler implementation

package/dist/lib/adapter/AsenaAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsenaAdapter.js","sourceRoot":"","sources":["../../../lib/adapter/AsenaAdapter.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,OAAgB,YAAY;IAEhC;;OAEG;IACa,IAAI,CAAS;IAE7B;;OAEG;IACO,IAAI,CAAS;IAEvB;;OAEG;IACO,MAAM,GAAiB,OAAO,CAAC;IAEzC;;OAEG;IACO,gBAAgB,CAAwB;IAElD;;;;OAIG;IACH,YAAsB,MAAoB,EAAE,gBAAwC;QAClF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QAC3C,CAAC;IACH,CAAC;CAwDF"}
+{"version":3,"file":"AsenaAdapter.js","sourceRoot":"","sources":["../../../lib/adapter/AsenaAdapter.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,OAAgB,YAAY;IAEhC;;OAEG;IACa,IAAI,CAAS;IAE7B;;OAEG;IACO,IAAI,CAAS;IAEvB;;OAEG;IACO,MAAM,GAAiB,OAAO,CAAC;IAEzC;;OAEG;IACO,gBAAgB,CAAwB;IAElD;;;;OAIG;IACH,YAAsB,MAAoB,EAAE,gBAAwC;QAClF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QAC3C,CAAC;IACH,CAAC;CAuEF"}

package/dist/lib/adapter/AsenaWebsocketAdapter.d.ts

@@ -61,11 +61,11 @@ export declare abstract class AsenaWebsocketAdapter {
     /**
      * Gets the WebSocket handler
      */
-    get websocket(): WebSocketHandler;
+    get websocket(): WebSocketHandler<any>;
     /**
      * Sets the WebSocket handler
      */
-    set websocket(value: WebSocketHandler);
+    set websocket(value: WebSocketHandler<any>);
     /**
      * Gets the logger instance
      */

package/dist/lib/adapter/AsenaWebsocketAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsenaWebsocketAdapter.js","sourceRoot":"","sources":["../../../lib/adapter/AsenaWebsocketAdapter.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,OAAgB,qBAAqB;IAEzB,IAAI,CAAS;IAE7B;;;;;;;;OAQG;IACO,WAAW,CAAoB;IAEzC;;;OAGG;IACK,UAAU,CAAmB;IAErC;;;OAGG;IACK,OAAO,GAAiB,OAAO,CAAC;IAExC;;;OAGG;IACH,YAAsB,MAAoB;QACxC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAoBD;;OAEG;IACH,IAAc,UAAU;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAc,UAAU,CAAC,KAAwB;QAC/C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAW,SAAS,CAAC,KAAuB;QAC1C,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAW,MAAM,CAAC,KAAmB;QACnC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;CAEF"}
+{"version":3,"file":"AsenaWebsocketAdapter.js","sourceRoot":"","sources":["../../../lib/adapter/AsenaWebsocketAdapter.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,OAAgB,qBAAqB;IAEzB,IAAI,CAAS;IAE7B;;;;;;;;OAQG;IACO,WAAW,CAAoB;IAEzC;;;OAGG;IACK,UAAU,CAAwB;IAE1C;;;OAGG;IACK,OAAO,GAAiB,OAAO,CAAC;IAExC;;;OAGG;IACH,YAAsB,MAAoB;QACxC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAoBD;;OAEG;IACH,IAAc,UAAU;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAc,UAAU,CAAC,KAAwB;QAC/C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAW,SAAS,CAAC,KAA4B;QAC/C,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAW,MAAM,CAAC,KAAmB;QACnC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;CAEF"}

package/dist/lib/adapter/types/RouteParams.d.ts

@@ -11,9 +11,12 @@ export interface RouteParams<C extends AsenaContext<any, any>, VS, E = any> {
     handler: AsenaHandler<C>;
     staticServe: BaseStaticServeParams<C, E>;
     validator: BaseValidator<VS>;
+    controllerName?: string;
+    controllerBasePath?: string;
 }
 export interface WebsocketRouteParams<C extends AsenaContext<any, any>> {
     path: string;
     middlewares: BaseMiddleware<C>[];
     websocketService: AsenaWebSocketService<any>;
+    controllerName?: string;
 }

package/dist/lib/adapter/types/ServeOptions.d.ts

@@ -1,6 +1,6 @@
-import type { ServeOptions, TLSServeOptions, UnixServeOptions, UnixTLSServeOptions } from 'bun';
+import type { ServeOptions } from 'bun';
 import type { WSOptions } from '../../server/web/websocket';
-export type AsenaServerOptions = ServeOptions | TLSServeOptions | UnixServeOptions | UnixTLSServeOptions;
+export type AsenaServerOptions = ServeOptions;
 export interface AsenaServeOptions {
     serveOptions?: AsenaServerOptions;
     wsOptions?: WSOptions;

package/dist/lib/adapter/types/index.d.ts

@@ -5,7 +5,7 @@ export * from './RouteParams';
 export * from './SendOptions';
 export * from './WebSocketRegistry';
 export * from './ServeOptions';
-export * from "./BaseMiddleware";
-export * from "./ApiParams";
-export * from "./AsenaHandler";
-export * from "./BaseStaticServeParams";
+export * from './BaseMiddleware';
+export * from './ApiParams';
+export * from './AsenaHandler';
+export * from './BaseStaticServeParams';

package/dist/lib/adapter/types/index.js

@@ -5,8 +5,8 @@ export * from './RouteParams';
 export * from './SendOptions';
 export * from './WebSocketRegistry';
 export * from './ServeOptions';
-export * from "./BaseMiddleware";
-export * from "./ApiParams";
-export * from "./AsenaHandler";
-export * from "./BaseStaticServeParams";
+export * from './BaseMiddleware';
+export * from './ApiParams';
+export * from './AsenaHandler';
+export * from './BaseStaticServeParams';
 //# sourceMappingURL=index.js.map

package/dist/lib/adapter/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/adapter/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/adapter/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC"}

package/dist/lib/ioc/CircularDependencyDetector.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @description Custom error class for circular dependency detection
+ * Provides detailed information about the circular dependency chain
+ */
+export declare class CircularDependencyError extends Error {
+    constructor(message: string);
+}
+/**
+ * @description Detector for circular dependencies in the IoC container
+ * Tracks the resolution stack and detects cycles during dependency injection
+ */
+export declare class CircularDependencyDetector {
+    private resolutionStack;
+    /**
+     * @description Check if service creates circular dependency
+     * @param {string} serviceName - The service being resolved
+     * @throws {CircularDependencyError} If circular dependency is detected
+     * @returns {void}
+     */
+    checkCircular(serviceName: string): void;
+    /**
+     * @description Push service to resolution stack
+     * @param {string} serviceName - The service being resolved
+     * @returns {void}
+     */
+    push(serviceName: string): void;
+    /**
+     * @description Pop service from resolution stack
+     * @param {string} serviceName - The service that was resolved
+     * @returns {void}
+     */
+    pop(serviceName: string): void;
+    /**
+     * @description Clear the resolution stack
+     * Useful for testing or manual stack reset
+     * @returns {void}
+     */
+    clear(): void;
+    /**
+     * @description Get current resolution stack as array
+     * @returns {string[]} Array of service names in resolution order
+     */
+    getStack(): string[];
+    /**
+     * @description Check if stack is empty
+     * @returns {boolean}
+     */
+    isEmpty(): boolean;
+}

package/dist/lib/ioc/CircularDependencyDetector.js

@@ -0,0 +1,69 @@
+/**
+ * @description Custom error class for circular dependency detection
+ * Provides detailed information about the circular dependency chain
+ */
+export class CircularDependencyError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CircularDependencyError';
+    }
+}
+/**
+ * @description Detector for circular dependencies in the IoC container
+ * Tracks the resolution stack and detects cycles during dependency injection
+ */
+export class CircularDependencyDetector {
+    resolutionStack = new Set();
+    /**
+     * @description Check if service creates circular dependency
+     * @param {string} serviceName - The service being resolved
+     * @throws {CircularDependencyError} If circular dependency is detected
+     * @returns {void}
+     */
+    checkCircular(serviceName) {
+        if (this.resolutionStack.has(serviceName)) {
+            const stack = Array.from(this.resolutionStack);
+            const chain = [...stack, serviceName].join(' -> ');
+            throw new CircularDependencyError(`Circular dependency detected: ${chain}`);
+        }
+    }
+    /**
+     * @description Push service to resolution stack
+     * @param {string} serviceName - The service being resolved
+     * @returns {void}
+     */
+    push(serviceName) {
+        this.resolutionStack.add(serviceName);
+    }
+    /**
+     * @description Pop service from resolution stack
+     * @param {string} serviceName - The service that was resolved
+     * @returns {void}
+     */
+    pop(serviceName) {
+        this.resolutionStack.delete(serviceName);
+    }
+    /**
+     * @description Clear the resolution stack
+     * Useful for testing or manual stack reset
+     * @returns {void}
+     */
+    clear() {
+        this.resolutionStack.clear();
+    }
+    /**
+     * @description Get current resolution stack as array
+     * @returns {string[]} Array of service names in resolution order
+     */
+    getStack() {
+        return Array.from(this.resolutionStack);
+    }
+    /**
+     * @description Check if stack is empty
+     * @returns {boolean}
+     */
+    isEmpty() {
+        return this.resolutionStack.size === 0;
+    }
+}
+//# sourceMappingURL=CircularDependencyDetector.js.map

package/dist/lib/ioc/CircularDependencyDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircularDependencyDetector.js","sourceRoot":"","sources":["../../../lib/ioc/CircularDependencyDetector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAEhD,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CAEF;AAED;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAE7B,eAAe,GAAgB,IAAI,GAAG,EAAE,CAAC;IAEjD;;;;;OAKG;IACI,aAAa,CAAC,WAAmB;QACtC,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC/C,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAEnD,MAAM,IAAI,uBAAuB,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,IAAI,CAAC,WAAmB;QAC7B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,WAAmB;QAC5B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACI,KAAK;QACV,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACI,QAAQ;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACI,OAAO;QACZ,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,CAAC;IACzC,CAAC;CAEF"}