Dreamdata Shared Utils & Constants - v1.19.0

A comprehensive TypeScript utility library for Dreamdata applications, providing reusable functions and constants across multiple projects.

📚 Documentation

The complete API documentation is available at: shared-utils-and-constants.dreamdata.io

Quick Start

pnpm install @dreamdata_io/shared-utils-and-constants
Copy

import {
  ArrayUtils,
  DateTimeUtils,
  NumberUtils
} from "@dreamdata_io/shared-utils-and-constants";

// Use utility classes
const arrayUtils = new ArrayUtils();
const numberUtils = new NumberUtils();
const dateTimeUtils = new DateTimeUtils();

// Example usage
const numbers = [1, 2, 3, 4, 5];
const nearest = arrayUtils.findNearest(3.2, numbers); // 3

const formatted = numberUtils.formatWithThousandsSuffix(1500); // "1.5k"

const displayDate = dateTimeUtils.getDisplayValue(1640995200); // "1/1/2022"
Copy

🛠️ Available Utilities

Array Utils

• ArrayUtils: Array manipulation, sorting, filtering, and transformation utilities

Number Utils

• NumberUtils: Number formatting, clamping, and mathematical operations

Date & Time Utils

• DateTimeUtils: Date/time parsing, formatting, and calculations
• TimeUtils: Asynchronous timing utilities

String Utils

• StringUtils: String hashing, random number generation, and text utilities

URL Utils

• URLUtils: URL validation, protocol handling, and URL extraction

Email Utils

• EmailUtils: Email validation, domain extraction, and business email detection

Country Utils

• CountryUtils: Country code conversion and localization

Object Utils

• ObjectUtils: Object manipulation and deep freezing

Access Control Utils

• AccessControlUtils: Role-based permissions and feature flags

Dreamdata Helpers

• DreamdataHelpers: Dreamdata-specific utility functions

🧪 Testing

# Run all tests
pnpm test

# Run tests with coverage
pnpm test:run

# Run tests in watch mode
pnpm test:ui
Copy

📖 Development

# Install dependencies
pnpm install

# Build the library
pnpm build

# Generate documentation
pnpm docs:generate

# Generate and serve documentation locally (opens browser automatically)
pnpm docs:serve
Copy

📝 License

MIT License - see LICENSE file for details.

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Run the test suite
6. Submit a pull request

📊 Coverage

This library maintains 100% test coverage across all utility methods and functions.