What is the Single-or-Array pattern?

It is a design pattern where a function is defined to accept either a single object or an array of those objects, normalizing the input into an array internally for unified processing.

When should I avoid using the Single-or-Array pattern?

Skip this pattern if the single and batch versions of your function have significantly different side effects, different return types, or require distinct configuration options.

How does this pattern reduce code duplication?

Instead of writing separate 'createOne' and 'createMany' functions, you use a single public API that delegates all real logic to one internal array-only implementation.

Why use function overloads with this pattern?

Overloads provide better IDE autocompletion and type safety, ensuring the return type accurately reflects whether the user passed a single item or an array.

Single-or-Array Pattern

Name: Single-or-Array Pattern
Author: EpicenterHQ

byEpicenterHQ

•

3,817

API開発

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.

主な機能

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

ユースケース

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

概要

主な機能

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

ユースケース

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