Release of Zodpress 1.0

[strblr]

Hi folks!

I'm releasing the first version of Zodpress. It's a tiny wrapper over Express that offers the following features:

• Strongly-typed request handlers
• Runtime request validation
• OpenAPI generation
• Fully compatible with regular Express
• Preserves the core Express philosophy

Docs: https://strblr.github.io/zodpress
GitHub: https://github.com/strblr/zodpress

Demo:

const app = zodpress({
  get: {
    "/hello": {
      summary: "Say hello",
      query: z.object({
        name: z.string().describe("Name to greet")
      }),
      responses: {
        200: z.object({
          message: z.string()
        })
      }
    }
  }
});

// Create a nested router
const router = zodpress.Router({
  tags: "Users",
  post: {
    "/": {
      summary: "Create user",
      body: z.object({
        username: z.string().describe("Username"),
        email: z.string().email().describe("Email address")
      }),
      responses: {
        201: z.object({
          id: z.string(),
          username: z.string(),
          email: z.string()
        }).openapi("User")
      }
    }
  }
});

// Regular express
app.use(express.json());
app.use("/users", router);

app.get("/other", (req, res) => {
  res.status(200).send("Weakly typed request handler")
})

// Strongly typed zodpress
app.z.get("/hello", (req, res) => {
  res.status(200).json({
    message: `Hello ${req.query.name}`
  });
});

router.z.post("/", (req, res) => {
  res.status(201).json({
    id: "user_123",
    ...req.body
  });
});

const openApiDoc = app.z.openapi.generate({
  openapi: "3.0.0",
  info: {
    title: "Demo API",
    version: "1.0.0",
    description: "A simple demo"
  }
});

app.use("/docs", swagger.serve, swagger.setup(openApiDoc));

app.listen(3000, () => {
  console.log("Server running");
});

Built it because none of the existing solutions were a good match for me in a use case that I had. I needed something that allows for incremental adoption on top of a big Express server, doesn't break existing code and doesn't require a big refactoring (it's basically just defining a contract, swapping express() for zodpress(), and app.[method] for app.z.[method]).

I hope you enjoy it!