typescript-api-client

What problem does it solve?

This Skill helps developers build robust TypeScript REST API clients by enforcing a schema-first approach with Zod, a resource-based architecture, and a lightweight HTTP client (ky). It reduces boilerplate, improves type safety at compile time and runtime, and provides a maintainable pattern for APIs with pagination and retries.

Core Features & Use Cases

• Schema-first development: define schemas with Zod and infer TS types to ensure runtime validation.
• Resource-based client: organize code into resources per API group with a common BaseResource for shared logic.
• Ky-powered HTTP with built-in retry and structured error handling, including a typed error hierarchy.
• Use Case: quickly scaffold a typed SDK for internal services or public APIs, with pagination support and robust error handling.

Quick Start

Install dependencies (zod, ky) and create a client following the patterns in this skill, then instantiate and call an endpoint to verify end-to-end type safety.