🔧 azure-net-tools

A collection of universal utilities. Port of azure-net-tools to RN Covering a wide range of tasks: object and string manipulation, event bus logic, and more.

📦 Installation

npm install @azure-net/tools-react-native

🧩 Utilities

All utilities can be imported directly from the package.

📡 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' });

✍️ 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.

📊 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 |

📄 License

MIT