Cloudflare представила Forge — відкритий конвеєр для генерації SDK і CLI

Cloudflare представила Forge — відкритий модульний конвеєр генерації, який перетворює описи API на SDK, CLI, документацію та бібліотеки. За словами компанії, будь-хто може розгорнути й запускати його безкоштовно.

Проєкт ще на ранньому етапі, але вже генерує результат, потрібний для cf CLI. Протягом наступних місяців він живитиме документацію та SDK для API Cloudflare.

Навіщо Cloudflare створила Forge

API Cloudflare налічує понад 3 500 операцій, а сотні сервісів за ними написані мовами Rust, Go, TypeScript і Python. Для єдиного CLI до всього API знадобився конвеєр генерації, здатний працювати з таким масштабом.

Forge працює в CI, у репозиторіях API кожної команди. Він перевіряє кожну зміну й створює попередні збірки CLI, документації та SDK, де підсвічено лише нові зміни. Ідея повторює Workers Previews, але для генерації SDK.

Трансформери та ланцюжкова генерація

Трансформери Forge можна об'єднувати в ланцюжки, створюючи одні результати з інших. Початковий опис OpenAPI вбудовується в TypeScript SDK, з якого потім генеруються специфікації cf CLI та Cap'n Web.

Сьогодні Forge підтримує OpenAPI як вхідний формат, але спроєктований так, щоб згодом додати AsyncAPI, GraphQL, Cap'n Proto, Protobuf та інші. Завдяки ланцюжкам трансформерів можна генерувати прив'язки TanStack Query, схеми Zod чи Valibot, сервери MCP, панелі керування й цілі застосунки.

Версіонування та відкритий код

Forge також підтримує краще версіонування API. Версія v4 залишається головною вже десять років, і компанія працює над підходом, який дозволить випускати нові мажорні версії API, не ламаючи старі клієнти чи SDK.

Нові SDK заплановані для TypeScript, Rust, Python, Go, PHP і Terraform. Forge випущено за ліцензією Apache 2.0: його можна запускати для будь-яких цілей, зі змінами, приватно й безкоштовно.