Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
koa-x-router
Advanced tools
Readme
koa-x-router
is a library that extends the functionality of @koa/router
by providing validation and automatic API documentation features. It simplifies the process of defining routes, validating request data, and generating API documentation.
Validation: With koa-x-router
, you can perform validation using various validation libraries. The library provides adapters such as JoiAdaptor
and YupAdaptor
that allow you to define validation schemas using popular validation libraries like Joi
or Yup
. You can also implement your own custom adapter by implementing the XRouterAdaptor
interface.
Automatic API Documentation: koa-x-router
automatically generates API documentation based on your route definitions. It extracts information about route paths, request methods, request/response data structures, and validation rules. The generated documentation can be accessed through an endpoint, making it convenient for developers to understand and consume your API.
You can install koa-x-router using npm:
npm install koa @koa/router koa-x-router joi
npm install @types/koa @types/koa__router -D
To use koa-x-router
, import it and initialize it with an instance of @koa/router
. Here's a basic example:
import Koa from "koa";
import bodyParser from "koa-bodyparser";
import { Router, JoiAdaptor } from "koa-x-router";
const app = new Koa();
const router = new Router({
adaptors: [JoiAdaptor], // <== Important!
});
const docRouter = new Router();
// Define a route with validation
router.add({
method: "get",
path: "/users",
validate: {
query: Joi.object({
name: Joi.string(),
}),
output: {
200: {
body: Joi.array().items(
Joi.object({
name: Joi.string().required(),
age: Joi.number().positive().required(),
})
),
},
},
},
handler: async (ctx) => {
// code...
},
});
docRouter.get("/", (ctx) => {
ctx.body = `<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>API Documentation</title>
<link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
<style>body{margin: 0;padding: 0;}</style>
</head>
<body>
<redoc spec-url='/openapi.json' lazy-rendering></redoc>
<script src="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"></script>
</body>
</html>`;
});
docRouter.get("/openapi.json", (ctx) => {
ctx.body = router.generateOpenApiSpecJson({
info: {
title: "koa-x-router Demo API Docs",
version: "1.0.0",
},
});
});
app.use(docRouter.routes());
app.use(bodyParser());
app.use(router.routes());
app.listen(3000, () => {
console.log("Server listening on port 3000");
});
You can also implement your custom adapter by implementing the XRouterAdaptor
interface.
This allows you to use your preferred validation library for route validation.
Contributions are welcome! If you have any suggestions, bug reports, or feature requests, please open an issue.
This project is licensed under the Apache License 2.0.
FAQs
`koa-x-router` is a library that extends the functionality of `koa-router` by providing validation and automatic API documentation features. It simplifies the process of defining routes, validating request data, and generating API documentation.
The npm package koa-x-router receives a total of 186 weekly downloads. As such, koa-x-router popularity was classified as not popular.
We found that koa-x-router demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.