@nasriya/atomix

Atomix.

Visit us at www.nasriya.net.

Made with ❤️ in Palestine 🇵🇸

Overview

A lightweight, zero-dependency utility library for TypeScript and JavaScript, providing modular, well-typed helpers across common domains like strings, arrays, numbers, and time. Designed for consistency, reusability, and seamless integration in Node.js and modern server-side environments.

[!IMPORTANT]

🌟 Support Our Open-Source Development! 🌟 We need your support to keep our projects going! If you find our work valuable, please consider contributing. Your support helps us continue to develop and maintain these tools.

Click here to support us!

Every contribution, big or small, makes a difference. Thank you for your generosity and support!

Installation

npm i @nasriya/atomix

Importing

Import in ES6 module

import atomix from '@nasriya/atomix';

Import in CommonJS (CJS)

const atomix = require('@nasriya/atomix').default;

Usage Overview

Import the default instance and use the modular helper methods grouped by domain: Here's a quick example:

import atomix from '@nasriya/atomix';

// Normalize a file path
const normalizedPath = atomix.path.normalizePath('/Users/Ahmad/Docs/../Downloads');

// Check if a value is a string
if (atomix.valueIs.string('hello world')) {
  console.log('Confirmed string!');
}

Detailed Domain Usage

You can access each domain via the main atomix instance followed by the domain name. For example:

atomix.dataTypes;   // Access the Data Types domain
atomix.valueIs;     // Access the Value Is domain for generic validations
atomix.fs;          // Access the File System domain

Domain (Module)	Description	Examples
Data Types (dataTypes)	Helpers for arrays, strings, numbers, and more	Examples
Value Is (valueIs)	Generic validations & type guards across multiple domains, including instanceOf and more	Examples
Path (path)	File and directory path utilities	Examples
File System (fs)	Sync and async file operations, access checks	Examples
HTTP (http)	HTTP request/response utilities	Examples
Network (networks)	Network utilities	Examples
Runtime (runtime)	Runtime environment helpers	Examples
General (utils)	Common utilities and guards	Examples
Tools (tools)	Advanced utility classes such as TasksQueue for managing async workflows	Examples

Compatibility

This package is built and tested on Node.js v22.16.x and later.
Earlier versions of Node.js are not guaranteed to be compatible.

Also supports:

• Bun (tested on v1.2.15+)
• Deno (untested, may require polyfills)

License

This software is licensed under the Nasriya Open License (NOL), version 1.0. Please read the license from here.