Express API-і з абсалютной безпекай прыменню Zod і OpenAPI ў адным кантракце

У гэтым керавані практычна адгуктва ствараецца рабочы маршрут для: стварэння Type-Safe Express API з Zod і OpenAPI. Акцэнт ставіцца на кантракты, пераконтроўкі і код, які можна прынясіць у репозітарый без неабязковасці з’ясоўваць намеры. Для загальнага адгледжэння, перш чым зменяць код, неабходна визначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыі должны магчымае пераўталачваць крок з вядомай точкі контролю без неабязковасці з’ясоўваць схованы стан. Валідзіце маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выйшоў, прычына неудачы должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны процес.

Ідея

Для рэалізацыі гэйтары неабяжна прадзефінаваць вхідныя даны, адпраўніка крока і критэрыя завершэння пры змены коду. Аперацыйныя працавнікі должны магчымае перайсці на выкананне крока з вядомага пункта контролю, не прымуджаючыся з’ясавіць захаваны стан. Спрыятлівае ставленне да гэтага этапу павінна выглядаць як кантракт межа вхіднымі даннымі і перакананымі выходнымі рэзультатамі. Назваць всі неабяжныя элементы, прадзефінаваць критэрыя успеху і не падтрымляць тых варыянтаў, калі задача выканана часткова без паведамлення. Практыкуваць перакананне на межах сістэмы за дапамою шэмаў, якія таксама генеруюць документацыю. Адна аднозначная правда кращая, чым расхілы межа OpenAPI і працоўнікамі обробкі дадзеных.

const CreateUserSchema = z.object({
  name: z.string(),
  email: z.string().email(),
});

api.post("/users", {
  body: CreateUserSchema,
  response: {
    201: UserSchema,
  },
  handler: async (req) => {
    const user = await createUser(req.body);
    return {
      status: 201,
      body: user,
    };
  },
});

Чаму ствараць ўтолькі іншую бібліятэку Express?

Для падзеўкі «Чаму ствараць ўтолькі іншых бібліятэкаў Express?» неабходна пазначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння пры перадзмене коду. Аперацыйныя працавнікі должны магчымае перзапускаць крок з вядомай точкі контролю, не прабуючы спадарацца пра схованы стан. Запісваюцься час выконання і витраты разам з функцыйнальнымі рэзултатамі. Раннія відкрытасць усіх параметраў запобегае неспакойным рахункам, калі процес пераходзіць з дэмаверсіі ў спяльныя сераўы. Автаперакананне на межы ведзецца за дапамогою схем, якія таксама генеруюць документацыю. Адна аднозначная правда кращая, чым расхіл межа OpenAPI і працоўнікаў.

Якое ўжо становішча сёньня

Для проекта «Where it is today» неабяжна прадзефінавацыя вхідных дадзеных, адпраўніка крока і крэтарыяў завершэння працы перад зменым коду. Аперацыйныя працавнікі павінны магчымаецца перзапускаць крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Конфігурацыю трэба захаваць праза код аплікацыі. Файлы сераўнавання, хранальнікі секрэтных дадзеных і флагі функцыйяў павінны знаходзіцца ў адном месцы, якое аперацыйныя працавнікі могу пераглядаць, не чытаючы весь ланцуг аператаў. Прабавайце пераканаць данні на межы за дапамойю схем, якія таксама генеруюць документацыю. Адна аднозначная правда кращая, чым расхіл межа OpenAPI і працоўнікаў обробкі. Для проекта «Where it is today» неабяжна прадзефінавацыя вхідных дадзеных, адпраўніка крока і крэтарыяў завершэння працы перад зменым коду. Аперацыйныя працавнікі павінны магчымаецца перзапускаць крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Валідуйце маленькія, тэставальныя елементы замест большых скрыптов. Калі крок не выйшоў, прычына неудачы павінна вказываць на адную адпраўнічую функцыю, а не на заплутаны ланцуг аператаў.

Вам будзе корисныя адказы разработчыкаў

Калі вам будзе корисныя адказы разработчыкаў, перад змінай коду неабходна визначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аператары должны магчымае перайсці заўтра крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Спрыяйце цім этапу як кантракту межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Дайце назвы артыфактам, визначыце критэрыя успеху і адмовіцеся ад безсловеснага частковага завершэння. Вяртайце структураваныя паказчыкі аб будзь-яых кашточках, якія кліенты можаць выкарыстоўваць для далейшых дзеянняў. Строгая працэса типавання выклікае неабходнасць здагадвацца.

Чэк-ліст для эксплуатацыі

Для чэк-ліста для эксплуатацыі, перад змінай коду неабходна визначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аператары должны магчымае перайсці заўтра крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан.

Запісвайце адно часова шлях і шлях вярнення ў нормальны стан. Практыкі павторных спроб, людзкія контралеры і обработка некоректных паведамленняў ёсць часткай продукту, а не чымсь, што дадаецца пазней.

Вяртайце структураваныя адказы пра аберанні, на якія можаць спрыяць кліент. Недастатак строгай пераканальнай верыфікацыі вымушвае працаваць на здогадкі.

Волейце простую надзяйнасць за розумныя, ексклюзыўныя дэманстраціі.

Волейце маленькія, тэставаныя елементы за велікія скрыпты. Калі якісь крок збываецца, аберанне должна паказваць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцужок задач.

Вяртайце структураваныя адказы пра аберанні, на якія можаць спрыяць кліент. Недастатак строгай пераканальнай верыфікацыі вымушвае працаваць на здогадкі.

Перш чым пераводзіць стэк у наступны ўровень, заморозьце версіі, зафіксавайце ідеальны транскрыпт для критычнага шляху і паказвайце крокі для вярнення да пачатковага стану. У спільных средах неабходны ліміты частоты запытоў, пераканальнія перагляды тэнансаў і чысткі власнік для ротацыі секрэтных даных. Волейце простую надзяйнасць за розумныя, ексклюзыўныя дэманстраціі.