Skip to content

Releases: dobosmarton/typeful-api

v0.1.2

22 Mar 19:25

Choose a tag to compare

What's New

Features

  • CLI config file support — Define options in typeful.config.ts (or .js/.mjs/.json) instead of passing CLI flags every time. Includes defineConfig() helper for type-safe configuration.

Testing

  • Integration tests for Express and Fastify adapters — Full HTTP-level test suites covering route mounting, validation (body/query/params), middleware ordering (global → version → group), error propagation, async handlers, and edge cases.

Maintenance

  • Removed dead useNativeValidation option from Fastify adapter types
  • Type improvements across packages
  • Pagination and error handling helpers

Docs

  • Updated framework comparison table

v0.1.0

06 Feb 12:40

Choose a tag to compare

🎉 Initial Release

typeful-api - End-to-end type-safe OpenAPI-first APIs with minimal boilerplate.

📦 Packages

Package Description
@typeful-api/core Framework-agnostic core with route builder and spec generation
@typeful-api/hono Hono adapter with OpenAPI integration
@typeful-api/express Express adapter with validation middleware
@typeful-api/fastify Fastify adapter with preHandler hooks
@typeful-api/cli CLI for spec and client generation

✨ Features

  • 🔒 Full Type Safety - From Zod schemas to handler implementations
  • 📝 OpenAPI First - Auto-generate valid OpenAPI 3.0 specs
  • 🔌 Framework Agnostic - Hono, Express, and Fastify adapters
  • 🎯 Minimal Boilerplate - Define a CRUD API in ~30 lines
  • 🏗️ Hierarchical Middleware - Apply middleware at version, group, or route level
  • 📦 First-class API Versioning - v1, v2, etc. built into the design
  • 🔧 CLI Tools - Generate specs and client types from the command line

🚀 Quick Start

# Install core and your framework adapter
pnpm add @typeful-api/core zod
pnpm add @typeful-api/hono hono @hono/zod-openapi

See the https://github.com/dobosmarton/typeful-api#readme for full documentation.

📚 Resources