exy-router

exy-router is a modified version of the popular Express.js router with enhanced functionality for request and response validation using Ajv.js. It automatically generates OpenAPI documentation based on JSON schemas, simplifying API documentation tasks.

Features

• Request Validation: Validate request bodies, parameters, and query strings against JSON schemas using Ajv.js.
• Response Validation: Validate response JSON data against a JSON schema.
• OpenAPI Documentation: Automatically generate OpenAPI documentation based on your route configurations and JSON schemas.
• Express.js Compatibility: exy-router maintains compatibility with Express.js, making it easy to integrate into existing Express applications.
• Middleware Support: Use middleware functions with exy-router for authentication, logging, and more.
• Easy to Use: Define routes and schema validations with a simple and intuitive syntax.

Installation

Install exy-router using npm:

1npm install exy-router --save

Usage

Here's a quick example of how to set up a route with request and response validation and OpenAPI documentation:

1const express = require("express");
2const cors = require("cors");
3const createRouter = require("exy-router");
4
5const app = express();
6const router = createRouter(express.Router)();
7
8app.use(express.json());
9app.use(cors());
10
11// Setup OpenAPI
12router.setupDocs("/api-docs", {
13  openapi: "3.1.0",
14  info: {
15    title: "exy-router",
16    version: "1.0.0",
17  },
18  servers: [
19    {
20      url: "http://127.0.0.1:3000/api",
21      description: "Production server (uses live data)",
22    },
23  ],
24});
25
26// Define a schema for request validation
27const requestSchema = {
28  type: "object",
29  properties: {
30    username: { type: "string", minLength: 3 },
31    password: { type: "string", minLength: 8 },
32  },
33  required: ["username", "password"],
34};
35
36// Define a schema for response validation
37const responseSchema = {
38  type: "object",
39  description: "Logged in successfully",
40  properties: {
41    message: { type: "string" },
42  },
43  required: ["message"],
44};
45
46// Create a route with request and response validation
47router.post(
48  "/login",
49  {
50    schema: {
51      body: requestSchema,
52      response: {
53        200: responseSchema,
54      },
55    },
56  },
57  (req, res) => {
58    // Your route logic here
59    res.json({ message: "Logged in successfully" });
60  }
61);
62
63// Create a route with params validation
64router.get(
65  "/product/:id",
66  {
67    schema: {
68      params: {
69        type: "object",
70        properties: {
71          id: { type: "string" },
72        },
73        required: ["id"],
74      },
75      response: {
76        200: {
77          description: "This API will return your product id",
78        },
79      },
80    },
81  },
82  (req, res) => {
83    // Your route logic here
84    res.json({ message: `Your product id is ${req.params.id}` });
85  }
86);
87
88// Create a route with query string validation
89router.get(
90  "/order",
91  {
92    schema: {
93      query: {
94        type: "object",
95        properties: {
96          id: { type: "string" },
97          page: { type: "string" },
98        },
99        required: ["id"],
100      },
101    },
102  },
103  (req, res) => {
104    // Your route logic here
105    res.json({ message: `Your order id is ${req.query.id}` });
106  }
107);
108
109app.use("/api", router);
110
111app.listen(3000, () => {
112  console.log("Server is running on port 3000");
113});

Documentation

For JSON Schema documentation and examples, please visit json-schema.org

Contributing

We welcome contributions from the community! If you'd like to contribute to exy-router, please email us.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

This package is inspired by Fastify.js. Special thanks to the open-source community for their contributions and support.