Type-Safe API Contracts

概要

This skill provides a comprehensive framework for developing resilient TypeScript APIs by mandating explicit return types and implementing strict runtime validation via Zod. It offers standardized patterns for API response wrappers, clear guidance on choosing between interfaces and types, and provides a suite of utility types for efficient data transformation. By eliminating anti-patterns like the 'any' type and unsafe non-null assertions, it ensures that your API contracts are self-documenting, reliable, and easy to maintain across the full stack.

主な機能

• Mandatory explicit return types for increased code predictability
• 0 GitHub stars
• Best practices for Interface vs Type usage in object modeling
• Built-in utility types for efficient field picking and transformation
• Seamless Zod integration for rigorous runtime schema validation
• Generic API response wrappers for standardized communication

ユースケース

• Standardizing communication layers between frontend and backend services
• Designing robust REST or GraphQL API endpoints with end-to-end type safety
• Implementing strict schema validation for incoming user-submitted request data