Proposal: @suaveplan/utils — Universal Utility Library

Change ID

enterprise-utils

Status

Shipped

Summary

Introduce @suaveplan/utils as a comprehensive universal utility library under universal/data/utils. This package provides commonly needed utilities: debug logging with deduplication, object manipulation (deep merge, clone, pick/omit, nested path access), platform detection (Node/Browser/Bun), float encoding utilities (Float16/32/64 pack/unpack), and pseudo-random array selection.

Motivation

Shared utility functions currently duplicated across packages. Centralizing them in a single well-tested package reduces redundancy, increases reuse, and ensures consistent error handling with OTel instrumentation.

Scope (Part 1)

debug: Circular-buffer deduplication logger
object: 15 object manipulation utilities with OTel spans
platform: Injectable platform adapter with Node/Browser/Bun detection
number: Float16/32/64 pack/unpack with DataView
random: Deterministic pseudo-random array selection

Part 2 (follow-on)

email, sound, string, validate, validation modules

Dependencies

@suaveplan/error — error substrate
@suaveplan/types — shared type interfaces
@opentelemetry/api — observability
zod — schema validation
tslib — TypeScript helpers

1.3 KiB Raw Permalink Blame History