🔧 azure-net-tools

A collection of universal utilities. Ideal for TypeScript/JavaScript projects, covering a wide range of tasks: object and string manipulation, DOM observation, event bus logic, and more.

📦 Installation

npm install azure-net-tools

🧩 Utilities

All utilities can be imported directly from the package.

🧠 EnvironmentUtil

Detects the current execution environment:

• EnvironmentUtil.isBrowser
• EnvironmentUtil.isServer
• EnvironmentUtil.isWebWorker
• EnvironmentUtil.currentEnvironment() → 'browser' | 'server' | 'webWorker' | 'unknown'

💾 DownloadUtil

Triggers file download in the browser:

DownloadUtil.download('https://example.com/file.pdf', 'myFile.pdf');

📡 EventBus<D>

A lightweight event bus implementation.

const bus = new EventBus<'loaded' | 'error'>();

bus.subscribe('loaded', (data) => console.log('Loaded:', data));
bus.publish('loaded', { status: 'ok' });

👀 IntersectionObserverUtil<T>

Simplified wrapper for IntersectionObserver.

const observer = new IntersectionObserverUtil(element, {
	callback(entry) {
		console.log('Element is visible:', entry);
	},
	once: true
});

✍️ TextUtil

String utilities:

• formatText(number, ['one', 'few', 'many']) — pluralization.
• truncate('long text...', 10)
• capitalize('hello') → 'Hello'
• decapitalize('Hello') → 'hello'
• isEmptyOrWhitespace(' ') → true

🧱 ObjectUtil

Object utilities:

• clone(obj) — shallow clone.
• deepClone(obj, structured = false) — deep clone (via structuredClone or JSON).
• compareAsString(obj1, obj2) — compares objects via their stringified forms.
• equals(obj1, obj2) — deep equality check (supports functions).
• isAllKeysEmpty(obj) — checks if all properties are null or undefined.
• isObjectEmpty(obj) — checks if object has no keys.
• renderAsString(obj) — HTML-highlighted JSON representation.

📊 FormDataUtil

Utility class for converting between FormData and deeply nested JavaScript objects, supporting complex structures including arrays, nested objects, Maps, Sets, Dates, and Blob/File objects.

• Converts FormData keys with bracket notation (e.g., foo[bar][baz]) into nested objects.
• Supports serialization of objects with nested structures into FormData.
• Detects cyclic references during serialization and throws an error.
• Handles special types like Date, Blob, File, Map, and Set.

Example usage

import { FormDataUtil } from 'azure-net-tools';

// Convert FormData to object
const formData = new FormData();
formData.append('user[name]', 'Alice');
formData.append('user[age]', '30');
const obj = FormDataUtil.toObject<{ user: { name: string; age: string } }>(formData);
console.log(obj.user.name); // Alice

// Convert object to FormData
const objToSerialize = {
	user: {
		name: 'Bob',
		age: 25,
		files: [new File(['content'], 'file.txt')],
		birthDate: new Date('1995-12-17')
	}
};
const fd = FormDataUtil.fromObject(objToSerialize);

📅 DateUtil

The DateUtil class offers helper methods to format and manipulate dates and times, including support for different locales.

Features

• Global locale setting (en, ru, and custom).
• Flexible date and time formatting.
• Locale-aware month name rendering.
• Custom formatting with tokens (yyyy, MM, dd, HH, etc.).
• Optional UTC or local time formatting.

Example Usage

DateUtil.setLocale('en'); // or 'ru' or custom

DateUtil.toDate('2025-05-23'); // "23.05.2025"
DateUtil.toDateTime(new Date()); // "23.05.2025 14:32"
DateUtil.toDayMonth('2025-08-15'); // "15 August" (locale-aware)
DateUtil.toFormat('2025-12-01', 'dd MM yyyy'); // "01 December 2025"

Supported Format Tokens

| Token | Description | | ------ | ------------------------------ | | yyyy | Full year (e.g., 2025) | | yy | Short year (e.g., 25) | | MM | Month name from locale | | mm | Month number with leading zero | | dd | Day with leading zero | | d | Day without leading zero | | HH | Hours with leading zero | | ii | Minutes with leading zero | | ss | Seconds with leading zero |

🍪 Cookies

The Cookies class provides a simple interface for interacting with cookies in the browser.

Features

• Set, get, delete, and clear cookies.
• Supports JSON-serializable values.
• Custom options (expiration, path, domain, secure, SameSite).
• Auto-check for browser environment.

Example Usage

Cookies.set('theme', 'dark', { expires: 7 }); // expires in 7 days
const theme = Cookies.get('theme'); // "dark"

Cookies.set('user', { name: 'Alice' });
const user = Cookies.get<{ name: string }>('user'); // { name: 'Alice' }

Cookies.delete('theme');

📘 Usage Example

import { EnvironmentUtil, TextUtil, ObjectUtil } from 'azure-net-tools';

if (EnvironmentUtil.isBrowser) {
	console.log(TextUtil.capitalize('hello world'));
}

📄 License

MIT