AJV + Express.js + JSONSchema + OpenAPI builder
npm install aejo(AJV + Express.js + JSON Schema + OAS 3.x) API Builder
A library for building fully documented and validated Express API endpoints
- Composable functions based on OpenAPI 3.x schemas (fully typed)
- Generates OAS 3.x schemas
- Express.js Param, Query, Body validations via AJV
- Scoped auth strategies
``typescriptlimit
// Validate against req.query`
Query({
name: 'limit',
description: 'max number',
schema: {
type: 'integer',
minimum: 1,
},
})
`typescript/api/users
// Define a new controller using the path/api/users
Controller({
prefix: '/api/users',
// DI express router
route: (router: Router): AppRoute =>
Route(
router,
// Define a new path under the controller``
Path(
'/',
AsyncGet({
tags: ['users'],
description: 'List Users',
// Define path parameters
parameters: [
Query({
name: 'limit',
description: 'max number',
schema: {
type: 'integer',
minimum: 1,
},
}),
],
// Middleware handlers
middleware: [
async (req: Request, res: Response, next: NextFunction) => {
const users = await UserService(req.query)
res.status(200).send(users)
},
],
// Endpoint Responses (testable)
responses: {
'200': {
description: 'Success',
content: UserListResponse,
},
},
})
)
),
})
- [ ] Actual documentation
- [x] Publish npm
- [x] Better OAS support
- [x] More Tests