Single-or-Array Pattern

•
3.8k
•

Normalizes functions to accept both single items and arrays for flexible, type-safe API design and batch processing.

This skill provides a standardized implementation pattern for TypeScript/JavaScript functions that need to handle either a single input or a collection of inputs seamlessly. By using function overloads and internal normalization, it allows developers to create intuitive APIs for CRUD operations and batch processing that eliminate logic duplication. It ensures that functions remain easy to use for single items while remaining powerful enough for bulk operations, providing a cleaner developer experience and more maintainable codebases.

주요 기능

01Standardized naming conventions for parameters and variables
02Pre-defined patterns for CRUD, batch APIs, and factory functions
03Input normalization logic using Array.isArray() checks
043,817 GitHub stars
05Centralized internal implementation to prevent logic duplication
06TypeScript function overload patterns for enhanced IDE intelligence

사용 사례

01Creating batch processing APIs that don't force single items into arrays
02Designing flexible CRUD operations that handle single or multiple records
03Building service factories that accept variable dependency configurations