@carno.js/core 1.1.1 → 1.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 carno.js
-
-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.
+MIT License
+
+Copyright (c) 2026 carno.js
+
+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

@@ -1,188 +1,188 @@
-# @carno.js/core
-
-Ultra-fast, performance-first HTTP framework for Bun.
-
-## Installation
-
-```bash
-bun add @carno.js/core
-```
-
-## Prerequisites
-
-Enable decorators in your `tsconfig.json`:
-
-```json
-{
-  "compilerOptions": {
-    "experimentalDecorators": true,
-    "emitDecoratorMetadata": true
-  }
-}
-```
-
-## Quick Start
-
-```typescript
-import { Carno, Controller, Get, Service, Param } from '@carno.js/core';
-
-@Service()
-class GreetService {
-  greet(name: string) {
-    return `Hello, ${name}!`;
-  }
-}
-
-@Controller('/greet')
-class GreetController {
-  constructor(private greetService: GreetService) {}
-
-  @Get('/:name')
-  greet(@Param('name') name: string) {
-    return { message: this.greetService.greet(name) };
-  }
-}
-
-const app = new Carno();
-app.services([GreetService]);
-app.controllers([GreetController]);
-app.listen(3000);
-```
-
-## API Overview
-
-### Application
-
-```typescript
-const app = new Carno(config?: CarnoConfig);
-
-app.controllers([...]);     // Register controllers
-app.services([...]);        // Register services
-app.middlewares([...]);     // Register global middlewares
-app.use(plugin);            // Use a plugin/module
-await app.listen(3000);     // Start server
-await app.stop();           // Stop server
-```
-
-### Decorators
-
-#### Controllers & Routes
-
-| Decorator | Description |
-| :--- | :--- |
-| `@Controller(path?)` | Define a controller with optional base path |
-| `@Get(path?)` | Handle GET requests |
-| `@Post(path?)` | Handle POST requests |
-| `@Put(path?)` | Handle PUT requests |
-| `@Delete(path?)` | Handle DELETE requests |
-| `@Patch(path?)` | Handle PATCH requests |
-
-#### Parameters
-
-| Decorator | Description |
-| :--- | :--- |
-| `@Param(key?)` | Route parameters |
-| `@Query(key?)` | Query string parameters |
-| `@Body(key?)` | Request body |
-| `@Header(key?)` | Request headers |
-| `@Req()` | Raw Request object |
-| `@Ctx()` | Full Context object |
-
-#### Dependency Injection
-
-| Decorator | Description |
-| :--- | :--- |
-| `@Service(options?)` | Mark class as injectable service |
-| `@Inject(token)` | Inject by token (for interfaces) |
-
-#### Middleware
-
-| Decorator | Description |
-| :--- | :--- |
-| `@Middleware(middleware)` | Apply middleware to controller/route |
-
-#### Lifecycle
-
-| Decorator | Description |
-| :--- | :--- |
-| `@OnApplicationInit()` | Called after DI container is ready |
-| `@OnApplicationBoot()` | Called when server starts listening |
-| `@OnApplicationShutdown()` | Called when server is stopping |
-
-### Validation
-
-```typescript
-import { z } from 'zod';
-import { Schema, ZodAdapter } from '@carno.js/core';
-
-@Schema(z.object({
-  name: z.string().min(2),
-  email: z.string().email(),
-}))
-class CreateUserDto {
-  name!: string;
-  email!: string;
-}
-
-const app = new Carno({ validation: new ZodAdapter() });
-```
-
-### CORS
-
-```typescript
-const app = new Carno({
-  cors: {
-    origins: '*',           // or specific origin(s)
-    methods: ['GET', 'POST'],
-    headers: ['Content-Type'],
-    credentials: true,
-    maxAge: 86400,
-  }
-});
-```
-
-### Exceptions
-
-```typescript
-import {
-  BadRequestException,
-  UnauthorizedException,
-  ForbiddenException,
-  NotFoundException,
-  ConflictException,
-  InternalServerErrorException,
-} from '@carno.js/core';
-
-throw new NotFoundException('User not found');
-```
-
-### Testing
-
-```typescript
-import { withTestApp } from '@carno.js/core';
-
-await withTestApp(
-  async (harness) => {
-    const res = await harness.get('/users');
-    expect(res.status).toBe(200);
-  },
-  { controllers: [UserController], listen: true }
-);
-```
-
-## Configuration
-
-```typescript
-interface CarnoConfig {
-  exports?: (Token | ProviderConfig)[];
-  globalMiddlewares?: MiddlewareHandler[];
-  disableStartupLog?: boolean;
-  cors?: CorsConfig;
-  validation?: ValidatorAdapter | boolean;
-  cache?: CacheConfig | boolean;
-}
-```
-
-## License
-
-MIT
+# @carno.js/core
+
+Ultra-fast, performance-first HTTP framework for Bun.
+
+## Installation
+
+```bash
+bun add @carno.js/core
+```
+
+## Prerequisites
+
+Enable decorators in your `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+## Quick Start
+
+```typescript
+import { Carno, Controller, Get, Service, Param } from '@carno.js/core';
+
+@Service()
+class GreetService {
+  greet(name: string) {
+    return `Hello, ${name}!`;
+  }
+}
+
+@Controller('/greet')
+class GreetController {
+  constructor(private greetService: GreetService) {}
+
+  @Get('/:name')
+  greet(@Param('name') name: string) {
+    return { message: this.greetService.greet(name) };
+  }
+}
+
+const app = new Carno();
+app.services([GreetService]);
+app.controllers([GreetController]);
+app.listen(3000);
+```
+
+## API Overview
+
+### Application
+
+```typescript
+const app = new Carno(config?: CarnoConfig);
+
+app.controllers([...]);     // Register controllers
+app.services([...]);        // Register services
+app.middlewares([...]);     // Register global middlewares
+app.use(plugin);            // Use a plugin/module
+await app.listen(3000);     // Start server
+await app.stop();           // Stop server
+```
+
+### Decorators
+
+#### Controllers & Routes
+
+| Decorator | Description |
+| :--- | :--- |
+| `@Controller(path?)` | Define a controller with optional base path |
+| `@Get(path?)` | Handle GET requests |
+| `@Post(path?)` | Handle POST requests |
+| `@Put(path?)` | Handle PUT requests |
+| `@Delete(path?)` | Handle DELETE requests |
+| `@Patch(path?)` | Handle PATCH requests |
+
+#### Parameters
+
+| Decorator | Description |
+| :--- | :--- |
+| `@Param(key?)` | Route parameters |
+| `@Query(key?)` | Query string parameters |
+| `@Body(key?)` | Request body |
+| `@Header(key?)` | Request headers |
+| `@Req()` | Raw Request object |
+| `@Ctx()` | Full Context object |
+
+#### Dependency Injection
+
+| Decorator | Description |
+| :--- | :--- |
+| `@Service(options?)` | Mark class as injectable service |
+| `@Inject(token)` | Inject by token (for interfaces) |
+
+#### Middleware
+
+| Decorator | Description |
+| :--- | :--- |
+| `@Middleware(middleware)` | Apply middleware to controller/route |
+
+#### Lifecycle
+
+| Decorator | Description |
+| :--- | :--- |
+| `@OnApplicationInit()` | Called after DI container is ready |
+| `@OnApplicationBoot()` | Called when server starts listening |
+| `@OnApplicationShutdown()` | Called when server is stopping |
+
+### Validation
+
+```typescript
+import { z } from 'zod';
+import { Schema, ZodAdapter } from '@carno.js/core';
+
+@Schema(z.object({
+  name: z.string().min(2),
+  email: z.string().email(),
+}))
+class CreateUserDto {
+  name!: string;
+  email!: string;
+}
+
+const app = new Carno({ validation: new ZodAdapter() });
+```
+
+### CORS
+
+```typescript
+const app = new Carno({
+  cors: {
+    origins: '*',           // or specific origin(s)
+    methods: ['GET', 'POST'],
+    headers: ['Content-Type'],
+    credentials: true,
+    maxAge: 86400,
+  }
+});
+```
+
+### Exceptions
+
+```typescript
+import {
+  BadRequestException,
+  UnauthorizedException,
+  ForbiddenException,
+  NotFoundException,
+  ConflictException,
+  InternalServerErrorException,
+} from '@carno.js/core';
+
+throw new NotFoundException('User not found');
+```
+
+### Testing
+
+```typescript
+import { withTestApp } from '@carno.js/core';
+
+await withTestApp(
+  async (harness) => {
+    const res = await harness.get('/users');
+    expect(res.status).toBe(200);
+  },
+  { controllers: [UserController], listen: true }
+);
+```
+
+## Configuration
+
+```typescript
+interface CarnoConfig {
+  exports?: (Token | ProviderConfig)[];
+  globalMiddlewares?: MiddlewareHandler[];
+  disableStartupLog?: boolean;
+  cors?: CorsConfig;
+  validation?: ValidatorAdapter | boolean;
+  cache?: CacheConfig | boolean;
+}
+```
+
+## License
+
+MIT

package/dist/Carno.js

@@ -216,37 +216,56 @@ class Carno {
   }
   createHandler(compiled, params, middlewares, bodyDtoType) {
     const handler = compiled.fn, hasMiddlewares = middlewares.length > 0, hasParams = params.length > 0, applyCors = this.hasCors ? this.applyCors.bind(this) : null, validator = bodyDtoType ? this.validator : null, hasMiddlewaresOrValidation = hasMiddlewares || !!validator;
-    return !hasMiddlewaresOrValidation && !hasParams ? compiled.isAsync ? async (req) => {
-      const ctx = new import_Context.Context(req), result = await handler(ctx), response = this.buildResponse(result);
-      return applyCors ? applyCors(response, req) : response;
-    } : (req) => {
-      const ctx = new import_Context.Context(req), result = handler(ctx), response = this.buildResponse(result);
-      return applyCors ? applyCors(response, req) : response;
-    } : !hasMiddlewaresOrValidation && hasParams ? compiled.isAsync ? async (req) => {
-      const ctx = new import_Context.Context(req, req.params), result = await handler(ctx), response = this.buildResponse(result);
-      return applyCors ? applyCors(response, req) : response;
-    } : (req) => {
-      const ctx = new import_Context.Context(req, req.params), result = handler(ctx), response = this.buildResponse(result);
-      return applyCors ? applyCors(response, req) : response;
-    } : async (req) => {
-      const ctx = new import_Context.Context(req, req.params || {});
-      for (const middleware of middlewares) {
-        const result2 = await middleware(ctx);
-        if (result2 instanceof Response)
-          return applyCors ? applyCors(result2, req) : result2;
-      }
-      validator && bodyDtoType && (await ctx.parseBody(), validator.validateOrThrow(bodyDtoType, ctx.body));
-      const result = compiled.isAsync ? await handler(ctx) : handler(ctx), response = this.buildResponse(result);
+    if (!hasMiddlewaresOrValidation && !hasParams)
+      return compiled.isAsync ? async (req) => {
+        const ctx = new import_Context.Context(req), result = await handler(ctx), response = this.buildResponse(result);
+        return applyCors ? applyCors(response, req) : response;
+      } : (req) => {
+        const ctx = new import_Context.Context(req), result = handler(ctx), response = this.buildResponse(result);
+        return applyCors ? applyCors(response, req) : response;
+      };
+    if (!hasMiddlewaresOrValidation && hasParams)
+      return compiled.isAsync ? async (req) => {
+        const ctx = new import_Context.Context(req, req.params), result = await handler(ctx), response = this.buildResponse(result);
+        return applyCors ? applyCors(response, req) : response;
+      } : (req) => {
+        const ctx = new import_Context.Context(req, req.params), result = handler(ctx), response = this.buildResponse(result);
+        return applyCors ? applyCors(response, req) : response;
+      };
+    const coreHandler = async (ctx) => (validator && bodyDtoType && (await ctx.parseBody(), validator.validateOrThrow(bodyDtoType, ctx.body)), compiled.isAsync ? await handler(ctx) : handler(ctx)), chain = this.buildMiddlewareChain(
+      middlewares,
+      coreHandler,
+      this.buildResponse.bind(this)
+    );
+    return async (req) => {
+      const ctx = new import_Context.Context(req, req.params || {}), response = await chain(ctx);
       return applyCors ? applyCors(response, req) : response;
     };
   }
   resolveMiddleware(middleware) {
-    if (typeof middleware == "function" && middleware.prototype?.handle) {
-      const instance = this.container.get(middleware);
-      return (ctx) => instance.handle(ctx, () => {
-      });
+    return typeof middleware == "function" && middleware.prototype?.handle ? { kind: "class", instance: this.container.get(middleware) } : typeof middleware == "object" && middleware !== null && "handle" in middleware ? { kind: "class", instance: middleware } : { kind: "function", handler: middleware };
+  }
+  /**
+   * Build an onion-style middleware chain.
+   * Wraps from inside-out so each middleware can run code before and after next().
+   */
+  buildMiddlewareChain(middlewares, coreHandler, buildResponseFn) {
+    let chain = async (ctx) => {
+      const result = await coreHandler(ctx);
+      return buildResponseFn(result);
+    };
+    for (let i = middlewares.length - 1; i >= 0; i--) {
+      const mw = middlewares[i], nextLayer = chain;
+      mw.kind === "function" ? chain = async (ctx) => {
+        const result = await mw.handler(ctx);
+        return result instanceof Response ? result : nextLayer(ctx);
+      } : chain = async (ctx) => {
+        let response;
+        const result = await mw.instance.handle(ctx, async () => (response = await nextLayer(ctx), response));
+        return result instanceof Response ? result : response ?? new Response(null, { status: 200 });
+      };
     }
-    return middleware;
+    return chain;
   }
   /**
    * Apply CORS headers to a response.

package/dist/Carno.mjs

@@ -208,37 +208,56 @@ class Carno {
   }
   createHandler(compiled, params, middlewares, bodyDtoType) {
     const handler = compiled.fn, hasMiddlewares = middlewares.length > 0, hasParams = params.length > 0, applyCors = this.hasCors ? this.applyCors.bind(this) : null, validator = bodyDtoType ? this.validator : null, hasMiddlewaresOrValidation = hasMiddlewares || !!validator;
-    return !hasMiddlewaresOrValidation && !hasParams ? compiled.isAsync ? async (req) => {
-      const ctx = new Context(req), result = await handler(ctx), response = this.buildResponse(result);
-      return applyCors ? applyCors(response, req) : response;
-    } : (req) => {
-      const ctx = new Context(req), result = handler(ctx), response = this.buildResponse(result);
-      return applyCors ? applyCors(response, req) : response;
-    } : !hasMiddlewaresOrValidation && hasParams ? compiled.isAsync ? async (req) => {
-      const ctx = new Context(req, req.params), result = await handler(ctx), response = this.buildResponse(result);
-      return applyCors ? applyCors(response, req) : response;
-    } : (req) => {
-      const ctx = new Context(req, req.params), result = handler(ctx), response = this.buildResponse(result);
-      return applyCors ? applyCors(response, req) : response;
-    } : async (req) => {
-      const ctx = new Context(req, req.params || {});
-      for (const middleware of middlewares) {
-        const result2 = await middleware(ctx);
-        if (result2 instanceof Response)
-          return applyCors ? applyCors(result2, req) : result2;
-      }
-      validator && bodyDtoType && (await ctx.parseBody(), validator.validateOrThrow(bodyDtoType, ctx.body));
-      const result = compiled.isAsync ? await handler(ctx) : handler(ctx), response = this.buildResponse(result);
+    if (!hasMiddlewaresOrValidation && !hasParams)
+      return compiled.isAsync ? async (req) => {
+        const ctx = new Context(req), result = await handler(ctx), response = this.buildResponse(result);
+        return applyCors ? applyCors(response, req) : response;
+      } : (req) => {
+        const ctx = new Context(req), result = handler(ctx), response = this.buildResponse(result);
+        return applyCors ? applyCors(response, req) : response;
+      };
+    if (!hasMiddlewaresOrValidation && hasParams)
+      return compiled.isAsync ? async (req) => {
+        const ctx = new Context(req, req.params), result = await handler(ctx), response = this.buildResponse(result);
+        return applyCors ? applyCors(response, req) : response;
+      } : (req) => {
+        const ctx = new Context(req, req.params), result = handler(ctx), response = this.buildResponse(result);
+        return applyCors ? applyCors(response, req) : response;
+      };
+    const coreHandler = async (ctx) => (validator && bodyDtoType && (await ctx.parseBody(), validator.validateOrThrow(bodyDtoType, ctx.body)), compiled.isAsync ? await handler(ctx) : handler(ctx)), chain = this.buildMiddlewareChain(
+      middlewares,
+      coreHandler,
+      this.buildResponse.bind(this)
+    );
+    return async (req) => {
+      const ctx = new Context(req, req.params || {}), response = await chain(ctx);
       return applyCors ? applyCors(response, req) : response;
     };
   }
   resolveMiddleware(middleware) {
-    if (typeof middleware == "function" && middleware.prototype?.handle) {
-      const instance = this.container.get(middleware);
-      return (ctx) => instance.handle(ctx, () => {
-      });
+    return typeof middleware == "function" && middleware.prototype?.handle ? { kind: "class", instance: this.container.get(middleware) } : typeof middleware == "object" && middleware !== null && "handle" in middleware ? { kind: "class", instance: middleware } : { kind: "function", handler: middleware };
+  }
+  /**
+   * Build an onion-style middleware chain.
+   * Wraps from inside-out so each middleware can run code before and after next().
+   */
+  buildMiddlewareChain(middlewares, coreHandler, buildResponseFn) {
+    let chain = async (ctx) => {
+      const result = await coreHandler(ctx);
+      return buildResponseFn(result);
+    };
+    for (let i = middlewares.length - 1; i >= 0; i--) {
+      const mw = middlewares[i], nextLayer = chain;
+      mw.kind === "function" ? chain = async (ctx) => {
+        const result = await mw.handler(ctx);
+        return result instanceof Response ? result : nextLayer(ctx);
+      } : chain = async (ctx) => {
+        let response;
+        const result = await mw.instance.handle(ctx, async () => (response = await nextLayer(ctx), response));
+        return result instanceof Response ? result : response ?? new Response(null, { status: 200 });
+      };
     }
-    return middleware;
+    return chain;
   }
   /**
    * Apply CORS headers to a response.