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.