@atscript/moost-validator

Use Atscript models as runtime validation contracts in Moost handlers.

@atscript/moost-validator gives you two small integration points:

• validatorPipe() validates handler arguments whose runtime type comes from an .as model
• validationErrorTransform() turns ValidatorError into HttpError(400) for HTTP apps

Best Path For New Users

If you are evaluating this package for the first time, read these in order:

1. Why Atscript In Moost?
2. Validation Pipe
3. Error Handling

What This Package Gives You

• one .as model for TypeScript types and runtime validation
• automatic validation in Moost handlers
• the same Atscript validator options you already use elsewhere
• optional HTTP-friendly error conversion when you use @moostjs/event-http

Installation

pnpm

pnpm add @atscript/moost-validator

npm

npm install @atscript/moost-validator

Peer Dependencies

You also need:

• @atscript/core
• @atscript/typescript
• moost
• @moostjs/event-http

Non-HTTP setups

@moostjs/event-http is a hard peer because the package re-exports validationErrorTransform(), which references HttpError from that package. If you build a non-HTTP Moost app you can still install @moostjs/event-http to satisfy the peer and simply ignore the HTTP transform — only validatorPipe() is used in that case.

Quick Start

1. Define A DTO In Atscript

export interface CreateUserDto {
    @meta.label 'Display Name'
    @expect.minLength 2, 'Name must be at least 2 characters'
    name: string

    email: string.email

    @expect.minLength 8, 'Password must be at least 8 characters'
    password: string
}

2. Register The Pipe And HTTP Error Transform

import { Moost } from 'moost'
import { MoostHttp } from '@moostjs/event-http'
import { validatorPipe, validationErrorTransform } from '@atscript/moost-validator'
import { UsersController } from './users.controller'

const app = new Moost()
app.adapter(new MoostHttp())

app.applyGlobalPipes(validatorPipe())
app.applyGlobalInterceptors(validationErrorTransform())

app.registerControllers(UsersController)
await app.init()

3. Use The DTO In A Controller

import { Controller } from 'moost'
import { Body, Post } from '@moostjs/event-http'
import { CreateUserDto } from './create-user.dto.as'

@Controller('users')
export class UsersController {
  @Post()
  async create(@Body() dto: CreateUserDto) {
    // dto has already been validated
    return { id: '123', ...dto }
  }
}

Without the pipe, the TypeScript annotation alone does not validate request data. With the pipe in place, your handler runs only after Atscript validation succeeds.

HTTP And Non-HTTP Usage

• validatorPipe() is the core integration and works anywhere Moost resolves handler arguments
• validationErrorTransform() is HTTP-specific because it converts ValidatorError into HttpError

If you are not building an HTTP app, keep validatorPipe() and use your own error interceptor for your adapter or event format.

Next Steps

• Why Atscript In Moost? — what this package removes from your handlers
• Validation Pipe — global setup, PATCH payloads, unknown props, and common options
• Error Handling — how the built-in HTTP error transform works