@zgok-api/zgok-express

zgok-api is an API developed in TypeScript for both front-end and back-end, ensuring safe request and response code through schema definitions using zod.

Usage

npm install --save @zgok-api/zgok-core or yarn add @zgok-api/zgok-core

Creating Schemas

Define schemas using zod. The schemas should be shared between the front-end and back-end. You can use symlinks or submodules.

import { z } from "zod";
import {
  postFunction,
  getFunction,
  patchFunction,
  zgokDate,
} from "@zgok-api/zgok-core";

export const SampleSchema = {
  dir1: {
    hoge1: postFunction({
      req: z.object({ id: z.number() }),
      res: z.object({ name1: z.string(), date1: zgokDate() }),
    }),
    hoge2: getFunction({
      req: z.object({ id: z.number() }),
      res: z.object({ name2: z.string() }),
    }),
  },
  dir2: {
    moge: patchFunction({
      req: z.object({ key: z.string() }),
      res: z.object({ kind: z.object({ name: z.string() }) }),
    }),
  },
};

Backend Setup

npm install --save zgok-express or yarn add zgok-express

zgok-express generates middleware from zgokSchema for handling processes in Express. Requests are validated by zod and set to req.zbody. Responses are validated by zod and sent with res.send.

This code creates a route for POST: /api/zgokExpress/dir1/hoge1.

const router = express.Router();
import { ZgokExpress } from "@zgok-api/zgok-express";

const zgokExpress = ZgokExpress(SampleSchema);
router.use(
  zgokExpress.dir1.hoge1(async (req, res) => {
    console.log("hoge3 zbody", req.zbody);
    return { name3: `${req.zbody.id}さん` };
  })
);
app.use("/api", router);