idchunk 1.1.1 → 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Garv Thakral
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,6 @@
 # ⚡ idchunk — Tiny, Fast & Customizable ID Generator
 
-<table width="100%" border="0">
+<table width="100%">
   <tr>
     <td>
       <a href="https://www.npmjs.com/package/idchunk">
@@ -14,28 +14,26 @@
       </a>
     </td>
     <td>
-      <a href="https://idchunk.netlify.app/" onclick="window.open('https://idchunk.netlify.app/', '_blank'); return false;">
-        <img  src="https://i.pinimg.com/736x/d0/68/64/d06864b8b20b18921e465d401fa605e4.jpg" alt="idchunk barcode" width="50" />
+      <a href="https://idchunk.netlify.app/">
+        <img src="https://i.pinimg.com/736x/d0/68/64/d06864b8b20b18921e465d401fa605e4.jpg" alt="idchunk barcode" width="60"/>
       </a>
     </td>
   </tr>
 </table>
 
-
-> Generate short, unique, and customizable IDs for your applications in milliseconds.
+> Generate short, secure, and customizable IDs for your applications in **milliseconds**.
 
 ---
 
-## Features
-
-- **Tiny:** Minimal footprint, zero dependencies.
-- **Fast:** Uses Node.js `crypto` for secure random generation.
-- **Customizable:** Specify ID length as needed.
-- **Reliable:** Generates collision-resistant IDs.
+## ✨ Features
+- **Tiny:** Zero dependencies, minimal footprint.
+- **Secure & Fast:** Uses Node.js [`crypto`](https://nodejs.org/api/crypto.html).
+- **Customizable:** Choose length *and* your own character set.
+- **Reliable:** Collision-resistant random IDs.
 
 ---
 
-## Installation
+## 📦 Installation
 
 ```bash
 npm install idchunk
@@ -50,26 +48,38 @@ By default, `idchunk()` generates a random ID of length **10**:
 ```js
 const idchunk = require("idchunk");
 
-console.log(idchunk()); // Example output: "aZ8_-kL2pQ"
+console.log(idchunk()); 
+// Example: "aZ8_-kL2pQ"
 ```
 
 You can specify a custom length:
 
 ```js
-const idchunk = require("idchunk");
+console.log(idchunk(16)); 
+// Example: "bQ9pL2_-aZ8kL2pQ"
+```
 
-console.log(idchunk(16)); // Example output: "bQ9pL2_-aZ8kL2pQ"
+Custom character set:
+
+```js
+const customValues = "ABC123";
+console.log(idchunk(8, customValues)); 
+// Example: "1A23BCAB"
 ```
 
+
+
 ---
 
 ## API
 
-### `idchunk(length?: number): string`
+### `idchunk(length?: number, customValues?: string): string`
 
-- `length` (optional): Number. Length of the generated ID. Default is `10`.
-- Returns: A random string ID.
+- `length` (optional) → Length of the ID (default: 10).
 
+- `customValues` (optional) → String of allowed characters (default: a-zA-Z0-9_-).
+
+- Returns: Random string ID.
 ---
 
 ## How It Works
@@ -79,16 +89,6 @@ console.log(idchunk(16)); // Example output: "bQ9pL2_-aZ8kL2pQ"
 
 ---
 
-## Testing
-
-To test locally:
-
-```bash
-node test/index.test.js
-```
-
----
-
 ## 📄 License
 
 MIT © [Garv Thakral](https://github.com/codebygarv)

package/package.json

@@ -1,16 +1,29 @@
 {
   "name": "idchunk",
-  "version": "1.1.1",
-  "description": "A tiny, fast and customizable ID generator ",
+  "version": "2.1.0",
+  "description": "Tiny, Fast & Customizable ID Generator",
   "main": "src/index.js",
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node test/index.test.js",
+    "release": "npm version"
+  },
   "keywords": [
     "id",
-    "nanoid",
     "generator",
-    "random",
-    "unique",
-    "uid"
+    "crypto",
+    "uuid",
+    "shortid",
+    "random"
   ],
   "author": "Garv Thakral",
-  "license": "MIT"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codebygarv/idchunk.git"
+  }
 }

package/src/index.js

@@ -1,18 +1,26 @@
-const values = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-';
-const crypto = require('crypto');
+const crypto = require("crypto");
 
-const idchunk = (length) => {
-    length = length || 10;
-    let result = '';
-    const valuesLength = values.length;
+const DEFAULT_VALUES = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-";
 
-    for (let i = 0; i < length; i++) {
-        const randomIndex = crypto.randomInt(0, valuesLength);
-        result += values[randomIndex];
+function getRandomInt(max) {
+    if (typeof crypto.randomInt === "function") {
+        return crypto.randomInt(0, max);
+    }
+    const byte = crypto.randomBytes(1)[0]; 
+    return byte % max; 
+}
+
+function idchunk(length = 10, customValues = DEFAULT_VALUES) {
+    if (typeof customValues !== "string" || customValues.length === 0) {
+        throw new Error("customValues must be a non-empty string");
     }
 
+    let result = "";
+    for (let i = 0; i < length; i++) {
+        const randomIndex = getRandomInt(customValues.length);
+        result += customValues[randomIndex];
+    }
     return result;
 }
 
-const randomNumber = idchunk(3);
-module.exports = idchunk;
+module.exports = idchunk;

package/.gitattributes

@@ -1,2 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto

package/test/index.test.js

@@ -1,3 +0,0 @@
-const idchunk = require('../src/index.js');
-
-console.log("Generated ID:", idchunk());