@velajs/vela 0.4.1 → 0.4.2

package/dist/http/route.manager.js

@@ -148,6 +148,8 @@ export class RouteManager {
     }
     createHandler(instance, route, controller, allParamMetadata) {
         const paramMetadata = (allParamMetadata.get(route.handlerName) || []).sort((a, b)=>a.index - b.index);
+        // Read param types once at build time for metatype population
+        const paramTypes = Reflect.getMetadata('design:paramtypes', instance.constructor.prototype, route.handlerName);
         // Pre-resolve controller + method level components at build time
         const methodGuards = ComponentManager.getComponents('guard', controller, route.handlerName);
         const methodPipes = ComponentManager.getComponents('pipe', controller, route.handlerName);
@@ -188,7 +190,7 @@ export class RouteManager {
             const executionContext = this.createExecutionContext(c, controller, route);
             try {
                 // 1. Extract args + run pipes
-                const args = await this.extractArguments(c, paramMetadata, pipes);
+                const args = await this.extractArguments(c, paramMetadata, pipes, paramTypes);
                 // 2. Guards (fail-fast)
                 for (const guard of guards){
                     const canActivate = await guard.canActivate(executionContext);
@@ -245,7 +247,7 @@ export class RouteManager {
             }
         };
     }
-    async extractArguments(c, paramMetadata, pipes) {
+    async extractArguments(c, paramMetadata, pipes, paramTypes) {
         if (paramMetadata.length === 0) {
             return [
                 c
@@ -258,7 +260,7 @@ export class RouteManager {
             const metadata = {
                 type: param.type,
                 data: param.name,
-                metatype: undefined
+                metatype: paramTypes?.[param.index]
             };
             // Run shared pipes (global + controller + method)
             for (const pipe of pipes){

package/dist/index.d.ts

@@ -34,3 +34,6 @@ export { MetadataRegistry } from './registry/index';
 export { RouteManager } from './http/index';
 export { ModuleLoader } from './module/index';
 export { ComponentManager } from './pipeline/index';
+export { createZodDto, ValidationPipe } from './validation/index';
+export { Serialize, SerializerInterceptor, SERIALIZE_METADATA } from './serialization/index';
+export { Test, TestingModule, TestingModuleBuilder } from './testing/index';

package/dist/index.js

@@ -40,3 +40,9 @@ export { RouteManager } from "./http/index.js";
 export { ModuleLoader } from "./module/index.js";
 // Component Manager (for advanced usage)
 export { ComponentManager } from "./pipeline/index.js";
+// Validation
+export { createZodDto, ValidationPipe } from "./validation/index.js";
+// Serialization
+export { Serialize, SerializerInterceptor, SERIALIZE_METADATA } from "./serialization/index.js";
+// Testing
+export { Test, TestingModule, TestingModuleBuilder } from "./testing/index.js";

package/dist/serialization/index.d.ts

@@ -0,0 +1,2 @@
+export { Serialize, SERIALIZE_METADATA } from './serialize.decorator';
+export { SerializerInterceptor } from './serializer.interceptor';

package/dist/serialization/index.js

@@ -0,0 +1,2 @@
+export { Serialize, SERIALIZE_METADATA } from "./serialize.decorator.js";
+export { SerializerInterceptor } from "./serializer.interceptor.js";

package/dist/serialization/serialize.decorator.d.ts

@@ -0,0 +1,6 @@
+export declare const SERIALIZE_METADATA = "vela:serialize";
+export declare function Serialize(dto: {
+    schema: {
+        parse(data: unknown): unknown;
+    };
+}): MethodDecorator;

package/dist/serialization/serialize.decorator.js

@@ -0,0 +1,7 @@
+import { MetadataRegistry } from "../registry/metadata.registry.js";
+export const SERIALIZE_METADATA = 'vela:serialize';
+export function Serialize(dto) {
+    return (target, propertyKey)=>{
+        MetadataRegistry.setCustomHandlerMeta(target.constructor, propertyKey, SERIALIZE_METADATA, dto);
+    };
+}

package/dist/serialization/serializer.interceptor.d.ts

@@ -0,0 +1,4 @@
+import type { CallHandler, ExecutionContext, NestInterceptor } from '../pipeline/types';
+export declare class SerializerInterceptor implements NestInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Promise<unknown>;
+}

package/dist/serialization/serializer.interceptor.js

@@ -0,0 +1,16 @@
+import { MetadataRegistry } from "../registry/metadata.registry.js";
+import { SERIALIZE_METADATA } from "./serialize.decorator.js";
+export class SerializerInterceptor {
+    async intercept(context, next) {
+        const result = await next.handle();
+        const controller = context.getClass();
+        const handler = context.getHandler();
+        const dto = MetadataRegistry.getCustomHandlerMeta(controller, handler, SERIALIZE_METADATA);
+        const schema = dto?.schema;
+        if (!schema?.parse) return result;
+        if (Array.isArray(result)) {
+            return result.map((item)=>schema.parse(item));
+        }
+        return schema.parse(result);
+    }
+}

package/dist/testing/index.d.ts

@@ -0,0 +1,2 @@
+export { Test, TestingModuleBuilder, OverrideBy } from './testing.builder';
+export { TestingModule } from './testing.module';

package/dist/testing/index.js

@@ -0,0 +1,2 @@
+export { Test, TestingModuleBuilder, OverrideBy } from "./testing.builder.js";
+export { TestingModule } from "./testing.module.js";

package/dist/testing/testing.builder.d.ts

@@ -0,0 +1,29 @@
+import type { Token, Type } from '../container/types';
+import type { ModuleOptions } from '../module/types';
+import { TestingModule } from './testing.module';
+export declare class OverrideBy {
+    private readonly builder;
+    private readonly token;
+    constructor(builder: TestingModuleBuilder, token: Token);
+    useValue(value: unknown): TestingModuleBuilder;
+    useClass(cls: Type): TestingModuleBuilder;
+    useFactory(options: {
+        factory: (...args: unknown[]) => unknown;
+        inject?: Token[];
+    }): TestingModuleBuilder;
+}
+export declare class TestingModuleBuilder {
+    private readonly metadata;
+    private overrides;
+    constructor(metadata: ModuleOptions);
+    overrideProvider(token: Token): OverrideBy;
+    overrideGuard(guard: Type): OverrideBy;
+    overridePipe(pipe: Type): OverrideBy;
+    overrideInterceptor(interceptor: Type): OverrideBy;
+    overrideFilter(filter: Type): OverrideBy;
+    private addOverride;
+    compile(): Promise<TestingModule>;
+}
+export declare class Test {
+    static createTestingModule(metadata: ModuleOptions): TestingModuleBuilder;
+}

package/dist/testing/testing.builder.js

@@ -0,0 +1,134 @@
+import { VelaApplication } from "../application.js";
+import { METADATA_KEYS } from "../constants.js";
+import { Container } from "../container/container.js";
+import { RouteManager } from "../http/route.manager.js";
+import { defineMetadata } from "../metadata.js";
+import { ModuleLoader } from "../module/module-loader.js";
+import { ComponentManager } from "../pipeline/component.manager.js";
+import { APP_FILTER, APP_GUARD, APP_INTERCEPTOR, APP_MIDDLEWARE, APP_PIPE } from "../pipeline/tokens.js";
+import { MetadataRegistry } from "../registry/metadata.registry.js";
+import { TestingModule } from "./testing.module.js";
+export class OverrideBy {
+    builder;
+    token;
+    constructor(builder, token){
+        this.builder = builder;
+        this.token = token;
+    }
+    useValue(value) {
+        this.builder['addOverride']({
+            token: this.token,
+            provider: {
+                token: this.token,
+                useValue: value
+            }
+        });
+        return this.builder;
+    }
+    useClass(cls) {
+        this.builder['addOverride']({
+            token: this.token,
+            provider: {
+                token: this.token,
+                useFactory: ()=>new cls()
+            }
+        });
+        return this.builder;
+    }
+    useFactory(options) {
+        this.builder['addOverride']({
+            token: this.token,
+            provider: {
+                token: this.token,
+                useFactory: options.factory,
+                inject: options.inject
+            }
+        });
+        return this.builder;
+    }
+}
+export class TestingModuleBuilder {
+    metadata;
+    overrides = [];
+    constructor(metadata){
+        this.metadata = metadata;
+    }
+    overrideProvider(token) {
+        return new OverrideBy(this, token);
+    }
+    overrideGuard(guard) {
+        return new OverrideBy(this, guard);
+    }
+    overridePipe(pipe) {
+        return new OverrideBy(this, pipe);
+    }
+    overrideInterceptor(interceptor) {
+        return new OverrideBy(this, interceptor);
+    }
+    overrideFilter(filter) {
+        return new OverrideBy(this, filter);
+    }
+    addOverride(entry) {
+        // Replace existing override for same token if any
+        const idx = this.overrides.findIndex((o)=>o.token === entry.token);
+        if (idx !== -1) {
+            this.overrides[idx] = entry;
+        } else {
+            this.overrides.push(entry);
+        }
+    }
+    async compile() {
+        // Create a temporary module class with the provided metadata
+        let TestRootModule = class TestRootModule {
+        };
+        MetadataRegistry.setModuleOptions(TestRootModule, {
+            imports: this.metadata.imports,
+            providers: this.metadata.providers,
+            controllers: this.metadata.controllers,
+            exports: this.metadata.exports
+        });
+        defineMetadata(METADATA_KEYS.MODULE, true, TestRootModule);
+        // Bootstrap (mirrors VelaFactory.create)
+        const container = new Container();
+        container.register({
+            token: Container,
+            useValue: container
+        });
+        // Register overrides BEFORE module loading so ModuleLoader skips originals
+        for (const override of this.overrides){
+            container.register(override.provider);
+        }
+        const routeManager = new RouteManager(container);
+        ComponentManager.init(container);
+        const loader = new ModuleLoader(container, routeManager);
+        loader.load(TestRootModule);
+        // Resolve APP_* tokens
+        if (container.has(APP_GUARD)) {
+            routeManager.useGlobalGuards(container.resolve(APP_GUARD));
+        }
+        if (container.has(APP_PIPE)) {
+            routeManager.useGlobalPipes(container.resolve(APP_PIPE));
+        }
+        if (container.has(APP_INTERCEPTOR)) {
+            routeManager.useGlobalInterceptors(container.resolve(APP_INTERCEPTOR));
+        }
+        if (container.has(APP_FILTER)) {
+            routeManager.useGlobalFilters(container.resolve(APP_FILTER));
+        }
+        if (container.has(APP_MIDDLEWARE)) {
+            routeManager.useGlobalMiddleware(container.resolve(APP_MIDDLEWARE));
+        }
+        const app = new VelaApplication(container, routeManager);
+        const instances = loader.resolveAllInstances();
+        app.setInstances(instances);
+        await app.callOnModuleInit();
+        await app.callOnApplicationBootstrap();
+        await app.initRoutes();
+        return new TestingModule(app);
+    }
+}
+export class Test {
+    static createTestingModule(metadata) {
+        return new TestingModuleBuilder(metadata);
+    }
+}

package/dist/testing/testing.module.d.ts

@@ -0,0 +1,9 @@
+import type { VelaApplication } from '../application';
+import type { Token } from '../container/types';
+export declare class TestingModule {
+    private readonly app;
+    constructor(app: VelaApplication);
+    get<T>(token: Token<T>): T;
+    close(signal?: string): Promise<void>;
+    createNestApplication(): VelaApplication;
+}

package/dist/testing/testing.module.js

@@ -0,0 +1,15 @@
+export class TestingModule {
+    app;
+    constructor(app){
+        this.app = app;
+    }
+    get(token) {
+        return this.app.get(token);
+    }
+    async close(signal) {
+        await this.app.close(signal);
+    }
+    createNestApplication() {
+        return this.app;
+    }
+}

package/dist/validation/create-zod-dto.d.ts

@@ -0,0 +1,8 @@
+interface ZodSchema {
+    parse(data: unknown): unknown;
+}
+export declare function createZodDto<T extends ZodSchema>(schema: T): {
+    new (): unknown;
+    schema: T;
+};
+export {};

package/dist/validation/create-zod-dto.js

@@ -0,0 +1,6 @@
+export function createZodDto(schema) {
+    let ZodDto = class ZodDto {
+        static schema = schema;
+    };
+    return ZodDto;
+}

package/dist/validation/index.d.ts

@@ -0,0 +1,2 @@
+export { createZodDto } from './create-zod-dto';
+export { ValidationPipe } from './validation.pipe';

package/dist/validation/index.js

@@ -0,0 +1,2 @@
+export { createZodDto } from "./create-zod-dto.js";
+export { ValidationPipe } from "./validation.pipe.js";

package/dist/validation/validation.pipe.d.ts

@@ -0,0 +1,4 @@
+import type { ArgumentMetadata, PipeTransform } from '../pipeline/types';
+export declare class ValidationPipe implements PipeTransform {
+    transform(value: unknown, metadata: ArgumentMetadata): unknown;
+}

package/dist/validation/validation.pipe.js

@@ -0,0 +1,19 @@
+import { BadRequestException } from "../errors/http-exception.js";
+export class ValidationPipe {
+    transform(value, metadata) {
+        const metatype = metadata.metatype;
+        if (!metatype?.schema?.parse) return value;
+        try {
+            return metatype.schema.parse(value);
+        } catch (error) {
+            if (error && typeof error === 'object' && 'issues' in error && Array.isArray(error.issues)) {
+                throw new BadRequestException('Validation failed', {
+                    statusCode: 400,
+                    message: 'Validation failed',
+                    errors: error.issues
+                });
+            }
+            throw error;
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velajs/vela",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "NestJS-compatible framework for edge runtimes, powered by Hono",
   "type": "module",
   "main": "./dist/index.js",
@@ -66,7 +66,8 @@
     "@types/bun": "latest",
     "typescript": "^5",
     "unplugin-swc": "^1.5.9",
-    "vitest": "^4.0.18"
+    "vitest": "^4.0.18",
+    "zod": "^4.3.6"
   },
   "scripts": {
     "build": "rm -rf dist && swc src -d dist --strip-leading-paths && tsc --emitDeclarationOnly",