🧪 Lab: API طلبات الكشري بالـ Express والـ Fastify

mkdir ajv-lab && cd ajv-lab && pnpm initpnpm pkg set type=module scripts.start="node server.js"pnpm add ajv ajv-formats expressmkdir schemas

{  "$schema": "https://json-schema.org/draft/2020-12/schema",  "$id": "https://koshary.example/schemas/order.json",  "title": "CreateOrder",  "type": "object",  "properties": {    "customer": { "$ref": "#/$defs/customer" },    "items": {      "type": "array",      "minItems": 1,      "maxItems": 20,      "items": { "$ref": "#/$defs/item" }    },    "payment": { "enum": ["cash", "card", "wallet"] },    "notes": { "type": "string", "maxLength": 200 }  },  "required": ["customer", "items", "payment"],  "additionalProperties": false,  "$defs": {    "customer": {      "type": "object",      "properties": {        "name": { "type": "string", "minLength": 2, "maxLength": 50 },        "phone": { "type": "string", "pattern": "^01[0125][0-9]{8}$" },        "email": { "type": "string", "format": "email", "maxLength": 254 }      },      "required": ["name", "phone"],      "additionalProperties": false    },    "item": {      "type": "object",      "properties": {        "sku": { "enum": ["koshary-small", "koshary-large", "rice-pudding"] },        "qty": { "type": "integer", "minimum": 1, "maximum": 10 }      },      "required": ["sku", "qty"],      "additionalProperties": false    }  }}

import { readFileSync } from "node:fs";import Ajv from "ajv/dist/2020.js";import addFormats from "ajv-formats";// instance واحد للتطبيق كلهexport const ajv = new Ajv({ allErrors: true, strict: true });addFormats(ajv);const load = (file) => JSON.parse(readFileSync(new URL(`./schemas/${file}`, import.meta.url)));ajv.addSchema(load("order.json"));// يحوّل errors بتاعة Ajv لشكل نضيف يرجع للـ clientexport function formatErrors(errors = []) {  return errors.map((e) => {    let field = e.instancePath || "/";    if (e.keyword === "required") field = `${e.instancePath}/${e.params.missingProperty}`;    if (e.keyword === "additionalProperties") field = `${e.instancePath}/${e.params.additionalProperty}`;    return { field, rule: e.keyword, message: e.message };  });}// middleware: بياخد الـ $id بتاع الـ schemaexport function validateBody(schemaId) {  const validate = ajv.getSchema(schemaId);  if (!validate) throw new Error(`schema not found: ${schemaId}`);  return (req, res, next) => {    if (validate(req.body)) return next();    res.status(400).json({ error: "ValidationError", details: formatErrors(validate.errors) });  };}

import express from "express";import { validateBody } from "./validate.js";const app = express();app.use(express.json({ limit: "10kb" })); // حد للحجم قبل الـ validationapp.post("/orders", validateBody("https://koshary.example/schemas/order.json"), (req, res) => {  // هنا الـ body مضمون شكله  const count = req.body.items.reduce((sum, i) => sum + i.qty, 0);  res.status(201).json({ ok: true, customer: req.body.customer.name, count });});// errors الـ JSON parser نفسه (قبل الـ schema)app.use((err, req, res, next) => {  if (err.type === "entity.parse.failed") return res.status(400).json({ error: "InvalidJSON" });  if (err.type === "entity.too.large") return res.status(413).json({ error: "PayloadTooLarge" });  next(err);});const port = process.env.PORT ?? 3000;app.listen(port, () => console.log(`listening on http://localhost:${port}`));

pnpm start# في terminal تانيH='content-type: application/json'U=localhost:3000/orders# 1) طلب سليمcurl -s -X POST $U -H "$H" -d '{"customer":{"name":"سعيد","phone":"01012345678"},"items":[{"sku":"koshary-large","qty":2},{"sku":"rice-pudding","qty":1}],"payment":"cash"}'# 2) كل حاجة غلطcurl -s -X POST $U -H "$H" -d '{"customer":{"name":"س","phone":"123"},"items":[{"sku":"pizza","qty":"2"}],"payment":"bitcoin","isAdmin":true}'# 3) حقول ناقصةcurl -s -X POST $U -H "$H" -d '{"customer":{"name":"سعيد"},"payment":"cash"}'# 4) JSON بايظcurl -s -X POST $U -H "$H" -d '{bad json'# 5) من غير content-typecurl -s -X POST $U -d 'hello'

# 1{"ok":true,"customer":"سعيد","count":3}# 2{"error":"ValidationError","details":[  {"field":"/isAdmin","rule":"additionalProperties","message":"must NOT have additional properties"},  {"field":"/customer/name","rule":"minLength","message":"must NOT have fewer than 2 characters"},  {"field":"/customer/phone","rule":"pattern","message":"must match pattern \"^01[0125][0-9]{8}$\""},  {"field":"/items/0/sku","rule":"enum","message":"must be equal to one of the allowed values"},  {"field":"/items/0/qty","rule":"type","message":"must be integer"},  {"field":"/payment","rule":"enum","message":"must be equal to one of the allowed values"}]}# 3{"error":"ValidationError","details":[  {"field":"/items","rule":"required","message":"must have required property 'items'"},  {"field":"/customer/phone","rule":"required","message":"must have required property 'phone'"}]}# 4{"error":"InvalidJSON"}# 5{"error":"ValidationError","details":[{"field":"/","rule":"type","message":"must be object"}]}

import Fastify from "fastify";const app = Fastify();app.post("/users", {  schema: {    body: {      type: "object",      properties: {        name: { type: "string", minLength: 2 },        age: { type: "integer", minimum: 0 },      },      required: ["name"],      additionalProperties: false,    },    response: {      201: {        type: "object",        properties: { id: { type: "integer" }, name: { type: "string" } },      },    },  },}, async (req, reply) => {  reply.code(201);  return { id: 7, name: req.body.name, age: req.body.age, password: "secret123" };});await app.ready();for (const payload of [{ name: "Saeed", age: "30" }, { name: "S", isAdmin: true }, { age: 5 }]) {  const r = await app.inject({ method: "POST", url: "/users", payload });  console.log(r.statusCode, r.body);}

201 {"id":7,"name":"Saeed"}400 {"statusCode":400,"code":"FST_ERR_VALIDATION","error":"Bad Request","message":"body/name must NOT have fewer than 2 characters"}400 {"statusCode":400,"code":"FST_ERR_VALIDATION","error":"Bad Request","message":"body must have required property 'name'"}

const app = Fastify({  ajv: { customOptions: { removeAdditional: false, coerceTypes: false } },});// {"name":"Saeed","isAdmin":true} ← 400 body must NOT have additional properties// {"name":"Saeed","age":"30"}     ← 400 body/age must be integer