e

library1.4.5jsnpmunverified

The 'e' library is a modern, universal utility collection specifically designed for TypeScript and Node.js environments. Currently at version 0.2.33, it emphasizes immutability, ensuring that none of its functions mutate or alter any passed arguments, promoting predictable side-effect-free code. Its design philosophy centers on simplicity, with each exported function serving a single, clear purpose. While currently in an early 0.x.x release cycle, it aims to provide a reliable, lightweight alternative to larger utility libraries, focusing on a clean API and strong TypeScript support from the ground up. The library is actively developed and geared towards contemporary JavaScript development practices.

npm install e

github ↗package ↗

INSTALL

IMPORT

SIG · E

javascriptv1.4.5

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

sleep

✓ import { sleep } from 'e';

✗ const { sleep } = require('e');

The 'e' library is primarily designed for ES Modules (ESM). CommonJS `require()` is not officially supported and may lead to issues.

randFloat

✓ import { randFloat } from 'e';

✗ import randFloat from 'e';

All utilities are named exports; there is no default export from the 'e' package.

shuffleArr

✓ import { shuffleArr } from 'e';

Demonstrates core functionalities like asynchronous delays, random number generation, and array shuffling, emphasizing the library's non-mutating design philosophy.

import { sleep, randFloat, shuffleArr } from 'e'; async function demonstrateE() { console.log('Starting e library demonstration...'); // Demonstrate asynchronous delay console.log('Pausing for 1000 milliseconds...'); await sleep(1000); console.log('Resumed after sleep.'); // Generate a random floating-point number const randomNumericValue = randFloat(); console.log(`Generated a random float between 0 and 1: ${randomNumericValue.toFixed(4)}`); // Shuffle an array without mutating the original const originalNumbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]; console.log('Original array:', originalNumbers); const shuffledNumbers = shuffleArr(originalNumbers); console.log('Shuffled array (new instance):', shuffledNumbers); console.log('Original array remains unchanged:', originalNumbers); // Verify non-mutation explicitly if (originalNumbers === shuffledNumbers) { console.error('CRITICAL ERROR: Array mutation detected! This should not happen in \'e\'.'); } else { console.log('Non-mutation confirmed: original and shuffled arrays are distinct instances.'); } console.log('e library demonstration complete.'); } demonstrateE().catch(console.error);

Debug

Known issues

breakingAs a 0.x.x version library, the API of 'e' is considered unstable and subject to frequent breaking changes with minor version updates. Always review the changelog before upgrading.

fix

Pin to exact versions in your `package.json` (e.g., `"e": "0.2.33"` instead of `"^0.2.33"`) and manually update after reviewing release notes.

affects: >=0.1.0

gotchaAll functions in 'e' are designed to be immutable, meaning they return new instances (e.g., a new array after shuffling) rather than modifying the input arguments. Failing to reassign the return value can lead to using stale data.

fix

Always assign the return value of 'e' functions to a new variable or explicitly reassign it to the original variable if mutation is desired (though not recommended for 'e' patterns). For example: `const newArr = shuffleArr(oldArr);`

affects: >=0.1.0

gotchaThe library is primarily built for ES Modules (ESM) environments. Using CommonJS `require()` in a Node.js project not configured for dual-package mode might result in import errors or unexpected behavior.

fix

Ensure your project uses `import` statements and is configured for ESM. If you must use CommonJS, consider a transpilation step or a tool like `cjstoesm` if available, or check for dual-packaging support in future versions.

affects: >=0.1.0

Errors

Common errors & fixes

TypeError: require is not a function

Attempting to use `require()` to import `e` in an ES Module context, or in a Node.js project not configured for CommonJS compatibility.

fix

Change `const { symbol } = require('e');` to `import { symbol } from 'e';`. Ensure your `package.json` has `"type": "module"` if you are in an ESM project, or use a build tool to transpile.

TS2305: Module ''e'' has no exported member 'MyFunction'.

Attempting to import a symbol (e.g., `MyFunction`) that either does not exist, is misspelled, or is not a named export from the 'e' package.

fix

Verify the symbol name against the 'e' documentation or source code. Ensure it is a named export, as 'e' does not use default exports. For example, use `import { correctFunctionName } from 'e';`.

TypeError: Cannot read properties of undefined (reading 'length')

This error can occur if you pass `undefined` or `null` to a function expecting an array, or if you call a method on the result of an immutable operation without reassigning it, expecting the original to be modified.

fix

Always ensure arguments passed to 'e' functions are of the expected type. Also, remember that 'e' functions are immutable; always capture their return value: `const newArray = shuffleArr(myArray);`

Upgrade

Version history

1.4.5latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/gc/e ↗

packagehttps://www.npmjs.com/package/e ↗