Schema Parsing

body, params, query and headers decorators can be used to inject request context into route handlers.

The decorators each have the same function signature that can be used to extract, validate and transform values.

However, before they add any real value, a SCHEMA_PARSER service must be added.

Zod

In this example, zod will be used, where an adapter can be consumed but any implementation can be used by satisfying this interface.

yarn add zod

Then add the schema parser service in the main file

src/index.ts

import { BaseZodParserService } from '@lindeneg/funkallero';

setup(service) {
    service.registerSingletonService(SERVICE.SCHEMA_PARSER, BaseZodParserService);
}

Update DTO

src/contracts/create-user.ts

import { z } from 'zod';
import type User from '@/domain/user';

export const createUserSchema = z.object({
    name: z.string().min(2).max(20),
    email: z.string().email(),
});

export interface ICreateUserDto extends z.infer<typeof createUserSchema> {}

export interface ICreateUserResponse {
    id: User['id'];
}

Inject request context

src/api/user-controller.ts

import {
    controller,
    httpGet,
    httpPost,
    params,
    body,
} from '@lindeneg/funkallero';
import BaseController from './base-controller';
import { createUserSchema, type ICreateUserDto } from '@/contracts/create-user';

@controller('user')
class UserController extends BaseController {
    @httpGet()
    public async getUsers() {
        return this.mediator.send('GetUsersQuery');
    }

    @httpGet('/:id')
    public async getUser(@params('id') id: string) {
        return this.mediator.send('GetUserQuery', {
            id,
        });
    }

    @httpPost()
    public async createUser(@body(createUserSchema) dto: ICreateUserDto) {
        return this.mediator.send('CreateUserCommand', dto);
    }
}