🌟 Overview

Foundry utils is a pure, agnostic logic library designed to serve as the data processing core for the Foundry suite. This library is entirely independent of frameworks and UI libraries, making it fully compatible with any JavaScript or TypeScript environment.

It features zero-dependency modules tailored for deep object manipulation, secure cryptography, data validation, and advanced timing functions.

🚀 Key features & philosophy

• Zero dependencies: The library is entirely self-contained. It strictly avoids third-party dependencies to ensure minimal bundle size and maximum security.

• Full agnosticism: It does not rely on browser-specific APIs or the Angular framework in its logical core, meaning it can run anywhere.

• Semantic naming: All cryptic abbreviations have been removed in favor of code that is self-documenting, explicit, and clear.

• Pure functions: Most utilities are stateless pure functions, which greatly enhances predictability and simplifies unit testing.

📦 Installation

Install the package via npm:

npm install @antoniocorraliza/foundry-utils

🧩 Architecture & ecosystem

The library is organized into static function modules with highly descriptive naming conventions:

• FoundryApiNormalizationUtils: Handles data consistency between Backend and Frontend by normalizing snake_case keys to camelCase and vice versa.

• FoundryCommonUtils: General utilities such as random code/UUID generators, array lists, and asynchronous delay functions (sleep).

• FoundryCryptUtils: Simple data obfuscation functions using hexadecimal conversion.

• FoundryCsvUtils: Manages the importation and exportation of data using the standard CSV format.

• FoundryDateUtils: A powerful engine for date processing, interval calculations, formatting, and week management.

• FoundryDebounceUtils: Execution timing control to optimize events and reduce unnecessary processing.

• FoundryFormatUtils: Formatter for currency, URL-friendly slugs, text truncation, string capitalization, and boolean normalization.

• FoundryFormDataUtils: Utilities for the rapid conversion of complex objects into FormData structures for HTTP requests.

• FoundryHashUtils: Native asynchronous implementation of the SHA-256 and SHA-512 algorithms for secure signature generation.

• FoundryObjectUtils: Deep object manipulation tools, including deep cloning, comparison, difference detection, subset extraction, and null-value cleaning.

• FoundryValidationUtils: Robust validators for Spanish DNI/NIE, email addresses, URLs, phone numbers, valid JSON structures, and password strength.

💻 Integration examples

For comprehensive documentation, advanced use cases, and fully developed integration examples across the entire utility ecosystem, please visit our official site:

🌐 https://www.foundry-suite.com

🛡️ Environment compatibility

Unlike other Foundry packages, Foundry utils is entirely framework-agnostic. It requires no specific version of Angular and can be seamlessly integrated into any modern TypeScript/JavaScript project (Node.js, React, Vue, Angular, Vanilla JS).

📄 License

Property of Antonio Corraliza León as part of the Foundry development suite. All rights reserved.