idea-toolbox

library7.2.0jsnpmunverified

A collection of utility functions and data structures maintained by iter IDEA for internal projects. The current stable version is 7.2.0. It provides commonly needed tools like Address, DateUtils, and other helpers, all with TypeScript type definitions. It is designed for modern JavaScript/TypeScript environments and is released periodically alongside iter IDEA's projects. Key differentiators: full TypeScript support, comprehensive documentation via TypeDoc, and a focus on practical utilities needed in production applications.

productivity

npm install idea-toolbox

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · IDEA-TOOLBOX

idea-toolbox

productivityjavascriptv7.2.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

Address

✓ import { Address } from 'idea-toolbox'

✗ import Address from 'idea-toolbox'

Address is a named export, not a default one.

DateUtils

✓ import { DateUtils } from 'idea-toolbox'

✗ const DateUtils = require('idea-toolbox').DateUtils

The package is ESM-only, use import statements.

Utils

✓ import { Utils } from 'idea-toolbox'

✗ import { Utils } from 'idea-toolbox/src/utils'

Do not import from internal paths; use the package root.

Demonstrates importing and using Address and DateUtils from idea-toolbox to validate an Ethereum address and format a date.

import { Address, DateUtils } from 'idea-toolbox'; // Validate an Ethereum address const addr = '0x742d35Cc6634C0532925a3b844Bc7dC125a432b0'; console.log(Address.isAddress(addr)); // true // Format a date const formattedDate = DateUtils.format(new Date(), 'YYYY-MM-DD'); console.log(formattedDate);

Debug

Known issues

breakingVersion 5.0.0 removed the old ObjectUtils functions. Use built-in methods instead.

fix

Replace ObjectUtils.deepClone with structuredClone or JSON.parse(JSON.stringify(obj)).

affects: >=5.0.0

breakingVersion 6.0.0 changed Address.isAddress to only accept strings; previously it accepted other types.

fix

Ensure addresses are passed as strings.

affects: >=6.0.0

deprecatedThe StringUtils class is deprecated since v7.0.0; use native JavaScript string methods instead.

fix

Replace StringUtils.capitalize with str.charAt(0).toUpperCase() + str.slice(1).

affects: >=7.0.0

Errors

Common errors & fixes

SyntaxError: Cannot use import statement outside a module

The package is ESM-only but the project uses CommonJS without 'type':'module' in package.json.

fix

Add 'type':'module' to your package.json or rename files to .mjs.

TypeError: Address.isAddress is not a function

Importing the package incorrectly (e.g., using default import instead of named import).

fix

Use 'import { Address } from 'idea-toolbox'' instead of 'import Address from 'idea-toolbox''.

Module not found: Error: Can't resolve 'idea-toolbox/src/utils'

Trying to import from internal source path instead of package root.

fix

Import from 'idea-toolbox' only: 'import { Utils } from 'idea-toolbox''.

Upgrade

Version history

7.2.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

27 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/iter-idea/IDEA-toolbox ↗

packageidea-toolbox ↗

homepagehttps://iter-idea.github.io/IDEA-toolbox/ ↗