full-utils

Lightweight, dependency-free collection of pure TypeScript/JavaScript utility functions for everyday development. It’s designed to be clear, fast, and easy to use — both in Node.js and in browser environments.

Whether you work with strings, numbers, dates, IPs, JSON, arrays, or type checks, this package provides you with a well-documented, consistent, and predictable API.

Installation

# with npm
npm install full-utils

# or with yarn
yarn add full-utils

# or with pnpm
pnpm add full-utils

Works in:

• Node.js (CommonJS & ESM)
• Browser / Front-end
• TypeScript or plain JavaScript

Concept

full-utils follows a simple philosophy: Small, pure, and type-safe utilities — reusable across any kind of project, from scripts to large applications.

All functions:

• Are pure (no side effects)
• Include TypeScript typings
• Have clear naming
• Are documented via TypeDoc
• Work without any external dependencies

Documentation

Full API documentation:

• full-utils.docs.ihor.bielchenko.com

Quick Example

import { isStrFilled, formatDateToString, rangeIPv4 } from 'full-utils';

// Check if a string has content
console.log(isStrFilled('Hello')); // true

// Format current date as 'YYYY-MM-DD HH:mm:ss'
console.log(formatDateToString(new Date()));

// Generate all IPs in a range
for (const ip of rangeIPv4('192.168.0.1', '192.168.0.5')) {
  console.log(ip);
}

Modules Overview

Number utilities (/num)

Work with numbers precisely — including BigInt-based fixed decimals.

| Function | Description | | ----------------------------------------- | ---------------------------------------------------------- | | formatToNum | Parse strings/numbers to normalized numeric values. | | parseToFixedDecimal | Convert any input to a precise fixed-decimal structure. | | roundFixedDecimal | Round a fixed-decimal number using half-up or trunc modes. | | convertExponentialToParts | Convert exponential notation into decimal components. | | fixedDecimalToNum / fixedDecimalToStr | Convert precise decimals to number or string. | | changeFixedDecimalScale | Increase or decrease the scale of a fixed decimal. |

Date utilities (/date)

| Function | Description | | ----------------------------------- | ------------------------------------------------------- | | floorDateToMinutes | Floor date to the nearest time step (e.g. every 5 min). | | formatDateToString | Convert a Date to 'YYYY-MM-DD HH:mm:ss' string. | | secondsToParts / partsToSeconds | Convert between seconds and time components. |

IP utilities (/ip-addr)

| Function | Description | | ----------------------------- | --------------------------------------------------- | | parseIPv4 / toIPv4 | Parse or format IPv4 addresses. | | cidrToRange | Convert a CIDR (e.g. 192.168.0.0/24) to IP range. | | rangeIPv4 | Generate an iterator of IP addresses in range. | | rangeIPv4ToArr | Materialize the range as an array. | | ipAddrToNum / numToIpAddr | Convert between IPv4 and integer. |

Type & Value checkers (/is)

Simple and strict predicates like isStr, isNum, isObjFilled, isFunc, etc.

| Function | Checks if... | | ------------------------------------------ | --------------------------------------------- | | isStr, isStrFilled | Value is a string (optionally non-empty). | | isNum, isNumP, isNumNZ, isNumFloat | Numeric type and positivity/zero constraints. | | isArr, isArrFilled | Array exists and optionally has elements. | | isBool, isStrBool | Boolean or boolean-like string. | | isIpAddr, isMacAddr | Valid network address formats. | | isObj, isObjFilled | Object is plain and not empty. | | isFunc, isVar | Function or valid variable identifier. | | isEmail, isPhone, isPassword | Common data validation helpers. |

Array utilities (/arr)

| Function | Description | | --------------------- | -------------------------------------------------- | | formatStrToFuncArgs | Convert a comma-separated string to argument list. | | splitArrToPortions | Split large arrays into chunks of fixed size. |

String utilities (/str)

| Function | Description | | ----------------------------------- | ---------------------------------------- | | formatToTrim | Trim string safely. | | formatToLowerCase | Lowercase string safely. | | formatToPhone | Normalize to international phone format. | | formatToNull, formatToUndefined | Convert empty strings to null/undefined. |

Common utilities (/common)

| Function | Description | | -------- | ------------------------------------------------------ | | wait | Pause execution asynchronously for given milliseconds. |

Example:

await wait(500); // waits for 0.5 seconds

Network utilities (/net)

Node-only helpers for TCP connections. | Function | Description | | -------------------------------- | -------------------------------------------- | | netTCP(message, host, options) | Send a TCP message and receive the response. |

Supports:

• Timeout controls (timeoutMs, connectTimeoutMs)
• Safe abort via AbortSignal
• Line terminator (\n / \r\n)
• Max bytes and half-close options.
• Available only in Node.js builds (import from 'full-utils/node')

URL & Host (/url)

| Function | Description | | ------------- | ---------------------------------------------- | | extractHost | Extract clean hostname from URL or raw string. |

JSON utilities (/json)

| Function | Description | | --------------------------- | ------------------------------------------------------- | | jsonEncode / jsonDecode | Safe JSON (de)serialization. | | tryParseJSON | Try parsing with graceful fallback. | | parseStringLike | Parse non-strict JSON-like strings (with quotes, etc.). |

Units (/units)

| Function | Description | | ----------------------- | --------------------------------------------------------------------- | | toH / toGH / toGB | Convert numeric values to readable units (hours, gigahash, gigabyte). |

Importing by environment

For Node.js:

import * from 'full-utils/node';

For Browser / universal code:

import * from 'full-utils/browser';

Or use tree-shakable imports directly from the source root:

import { formatDateToString, isStrFilled } from 'full-utils';

TypeScript Ready

Every function is strongly typed and documented. You’ll get autocompletion, inline JSDoc, and type inference automatically.

Versioning

Follows semantic versioning (MAJOR.MINOR.PATCH). Breaking changes are always reflected in a major version bump

License

Use freely in your own projects. Add proper notices if you publish a package (MIT/Apache-2.0, etc.).

Summary

full-utils gives you many of ready-to-use, predictable, and documented helpers that you can safely use in any project, no matter how large or small.

One toolkit. Zero dependencies. Full control.