{"id":29041881,"url":"https://github.com/nasriyasoftware/atomix","last_synced_at":"2026-05-04T10:35:33.075Z","repository":{"id":301316475,"uuid":"991304963","full_name":"nasriyasoftware/Atomix","owner":"nasriyasoftware","description":"Cross-runtime networking utilities for Node.js, Bun, and Deno — fetch public IPs, inspect local interfaces, perform traceroutes, scan subnets, and more. Built for reliability and portability across modern JavaScript runtimes.","archived":false,"fork":false,"pushed_at":"2025-06-26T08:19:22.000Z","size":116,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-26T08:41:49.523Z","etag":null,"topics":["bun","cross-runtime","deno","dns","ip-address","ip-address-geolocation","ip-address-lookup","net-tools","networking","nodejs","port-scanner","subnet-scanner","traceroute","utilities","utility-library"],"latest_commit_sha":null,"homepage":"https://package.nasriya.net/Atomix","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nasriyasoftware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":["https://fund.nasriya.net"]}},"created_at":"2025-05-27T12:33:01.000Z","updated_at":"2025-06-26T08:18:37.000Z","dependencies_parsed_at":"2025-06-26T08:55:22.761Z","dependency_job_id":null,"html_url":"https://github.com/nasriyasoftware/Atomix","commit_stats":null,"previous_names":["nasriyasoftware/atomix"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/nasriyasoftware/Atomix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasriyasoftware%2FAtomix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasriyasoftware%2FAtomix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasriyasoftware%2FAtomix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasriyasoftware%2FAtomix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nasriyasoftware","download_url":"https://codeload.github.com/nasriyasoftware/Atomix/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nasriyasoftware%2FAtomix/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262090185,"owners_count":23257125,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bun","cross-runtime","deno","dns","ip-address","ip-address-geolocation","ip-address-lookup","net-tools","networking","nodejs","port-scanner","subnet-scanner","traceroute","utilities","utility-library"],"created_at":"2025-06-26T15:04:41.416Z","updated_at":"2026-05-04T10:35:33.063Z","avatar_url":"https://github.com/nasriyasoftware.png","language":"TypeScript","funding_links":["https://fund.nasriya.net"],"categories":[],"sub_categories":[],"readme":"[![N|Solid](https://static.wixstatic.com/media/72ffe6_da8d2142d49c42b29c96ba80c8a91a6c~mv2.png)](https://nasriya.net)\n\n# Atomix.\n[![NPM License](https://img.shields.io/npm/l/%40nasriya%2Fatomix?color=lightgreen)](https://github.com/nasriyasoftware/Atomix?tab=License-1-ov-file) ![NPM Version](https://img.shields.io/npm/v/%40nasriya%2Fatomix) ![NPM Unpacked Size](https://img.shields.io/npm/unpacked-size/%40nasriya%2Fatomix) ![Last Commit](https://img.shields.io/github/last-commit/nasriyasoftware/Atomix.svg) [![Status](https://img.shields.io/badge/Status-Stable-lightgreen.svg)](link-to-your-status-page)\n\n##### Visit us at [www.nasriya.net](https://nasriya.net).\n\nMade with ❤️ in **Palestine** 🇵🇸\n___\n### Overview\nA 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.\n\n\u003e [!IMPORTANT]\n\u003e \n\u003e 🌟 **Support Our Open-Source Development!** 🌟\n\u003e 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.\n\u003e \n\u003e **[Click here to support us!](https://fund.nasriya.net/)**\n\u003e \n\u003e Every contribution, big or small, makes a difference. Thank you for your generosity and support!\n___\n### Installation\n```shell\nnpm i @nasriya/atomix\n```\n\n### Importing\nImport in **ES6** module\n```ts\nimport atomix from '@nasriya/atomix';\n```\n\nImport in **CommonJS (CJS)**\n```js\nconst atomix = require('@nasriya/atomix').default;\n```\n___\n## Usage Overview\n\nImport the default instance and use the modular helper methods grouped by domain:\nHere's a quick example:\n\n```ts\nimport atomix from '@nasriya/atomix';\n\n// Normalize a file path\nconst normalizedPath = atomix.path.normalizePath('/Users/Ahmad/Docs/../Downloads');\n\n// Check if a value is a string\nif (atomix.valueIs.string('hello world')) {\n  console.log('Confirmed string!');\n}\n```\n\n### Detailed Domain Usage\nYou can access each domain via the main `atomix` instance followed by the domain name. For example:\n\n```ts\natomix.dataTypes;   // Access the Data Types domain\natomix.valueIs;     // Access the Value Is domain for generic validations\natomix.fs;          // Access the File System domain\n```\n\n| Domain (Module)          | Description                                                                                | Examples                                      |\n| ------------------------ | ------------------------------------------------------------------------------------------ | --------------------------------------------- |\n| Data Types (`dataTypes`) | Helpers for `arrays`, `strings`, `numbers`, and more                                       | [Examples](./examples/dataTypes/dataTypes.md) |\n| Value Is (`valueIs`)     | Generic validations \u0026 type guards across multiple domains, including `instanceOf` and more | [Examples](./examples/valueIs.md)             |\n| Path (`path`)            | File and directory path utilities                                                          | [Examples](./examples/path.md)                |\n| File System (`fs`)       | Sync and async file operations, access checks                                              | [Examples](./examples/fs.md)                  |\n| HTTP (`http`)            | HTTP request/response utilities                                                            | [Examples](./examples/http.md)                |\n| Network (`networks`)     | Network utilities                                                                          | [Examples](./examples/networks.md)            |\n| Runtime (`runtime`)      | Runtime environment helpers                                                                | [Examples](./examples/runtime.md)             |\n| General (`utils`)        | Common utilities and guards                                                                | [Examples](./examples/utils.md)               |\n| Tools (`tools`)          | Advanced utility classes such as `TasksQueue` for managing async workflows                  | [Examples](./examples/tools/tools.md)         |\n\n---\n## Compatibility\n\nThis package is built and tested on **Node.js v22.16.x** and later.  \nEarlier versions of Node.js are not guaranteed to be compatible.\n\nAlso supports:\n- Bun (tested on v1.2.15+)\n- Deno (untested, may require polyfills)\n___\n## License\nThis software is licensed under the **Nasriya Open License (NOL)**, version 1.0.\nPlease read the license from [here](https://github.com/nasriyasoftware/Atomix?tab=License-1-ov-file).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasriyasoftware%2Fatomix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnasriyasoftware%2Fatomix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnasriyasoftware%2Fatomix/lists"}