@ecosy/core

A modular, tree-shakable collection of essential utilities, serialization primitives, and event-driven patterns for modern TypeScript applications.

Installation

yarn add @ecosy/core

Features

Subpath Imports

| Entry point | Description | | ------------------------ | --------------------------------------------- | | @ecosy/core | Re-exports all modules (except syhemo) | | @ecosy/core/types | TypeScript type utilities | | @ecosy/core/utilities | Runtime utility functions | | @ecosy/core/env | getEnv() — safe process.env access | | @ecosy/core/subscriber | Pub/sub event emitter with state | | @ecosy/core/http | HTTP client, Endpoint registry, uploads | | @ecosy/core/logger | Structured logger with log levels | | @ecosy/core/syhemo | System health monitor (Node-only) | | @ecosy/core/serialize | Serialization engine (JSON, URL, queryString) | | @ecosy/core/slugify | Unicode-safe string slugifier | | @ecosy/core/searchify | Diacritic-insensitive fuzzy search |

Types

Deep utility types for TypeScript — Freezable<T>, PartialLiteral<T>, Promisable<V>, ToString<T>, and more.

Utilities

• clone — Deep clone with circular reference handling
• freeze — Deep freeze via clone + Object.freeze
• isEqual — Structural deep equality (Date, Map, Set, TypedArrays)
• merge — Deep merge with prototype pollution protection
• flatten / flattenToArray — Object flattening
• get — Safe deep path resolution ("a.b[0].c")
• defer / deferAsync — rAF + setTimeout scheduling with cancel
• sanitizeMime / MIME_REGEX — validate and normalize MIME strings
• isFormData / objectToFormData — FormData detection and conversion
• toString / ucfirst / pascalToKebab — string helpers
• Type guards: isFunction, isObject, isLiteralObject, isComplexObject, isObjectable, hasOwnProperty

Subscriber

Pub/sub event emitter with built-in state management, async once, and typed wiring.

Http

Configurable HTTP client with request/response interceptors, auth token injection, URL interpolation via Serialize, XHR-based upload with progress tracking, and multipart/related upload for Google-style APIs.

• Endpoint — Central registry for grouping service endpoints (Endpoint.register("drive", { … })), also exposed as Http.Endpoint
• HttpMethod / HttpUpload — Enums covering HTTP verbs and upload modes (UPLOAD, RELATED)
• http.upload(url, files, options) — XHR upload with progress events
• http.related(url, bytes, { metadata, contentType }) — multipart/related upload with JSON metadata + binary body
• Http.createFactory({ http, endpoint }) — Typed endpoint factory keyed by registered service names

Serialize

Centralized serialization engine:

• Serialize.Primitive — Type guards and deep normalization (BigInt, Date, undefined stripping)
• Serialize.JSON — Safe stringify/parse that never throws
• Serialize.URL — Robust encode/decode with :param URL building
• Serialize.queryString — Advanced parse/stringify (bracket, index, comma formats)

Slugify & Searchify

• slugify — Unicode-safe slug generation with custom transformer map
• searchify — Diacritic-insensitive fuzzy search using sliding window algorithm

Documentation

Full API reference and guides: docs.ecosy.io

Related Packages

| Package | Description | | -------------------------------------------------------------------- | --------------------------------------------------------------- | | @ecosy/datekit | Headless date utilities (Dateify, Dayify, Monthify, Yearify) | | @ecosy/mailer | Email engine with template formatting, retry, and rate limiting | | @ecosy/store | State management with slices, reducers, and configureStore | | @ecosy/react | React hooks for @ecosy/store | | @ecosy/googleapis | Google Drive / OAuth2 client built on @ecosy/core/http |

License

MIT