genkode 1.0.1 → 1.1.0

package/README.md

@@ -1,11 +1,10 @@
-# genkode
+# genkode - Random String & ID Generator for Node.js
 
 ![npm version](https://img.shields.io/npm/v/genkode)
 ![npm downloads](https://img.shields.io/npm/dw/genkode)
 ![license](https://img.shields.io/npm/l/genkode)
 ![types](https://img.shields.io/npm/types/genkode)
 
-
 A lightweight Node.js utility to generate random alphanumeric, alphabetic, or numeric strings.  
 Fully compatible with TypeScript. No external dependencies.
 
@@ -21,61 +20,58 @@ npm install genkode
 
 ## 🚀 Usage
 
-### 1. Generate Alphanumeric String
+### Generate using main API
 
 ```ts
-import { mumble } from 'genkode';
+import { generateCode } from 'genkode';
+
+generateCode({ length: 12 });
+// Example: aZ8kL2pQ9xW1
 
-console.log(mumble(12));
+generateCode({ length: 12, type: "alpha" });
+// Example: rqfvYxJRWfoP
 
-// Example output:
-// vl6QLrr3xIBe
+generateCode({ length: 12, type: "numeric" });
+// Example: 362128126198
 ```
 
 ---
 
-### 2. Generate Alphabet-only String
+### Simple helper functions
 
 ```ts
-import { mumblealpha } from 'genkode';
-
-console.log(mumblealpha(12));
+import { randomString, randomAlpha, randomNumeric } from 'genkode';
 
-// Example output:
-// rqfvYxJRWfoP
+randomString(12);   // alphanumeric
+randomAlpha(12);    // alphabets only
+randomNumeric(12);  // numbers only
 ```
 
 ---
 
-### 3. Generate Numeric String
-
-```ts
-import { mumblenum } from 'genkode';
+## ⚙️ API
 
-console.log(mumblenum(12));
+### generateCode(options)
 
-// Example output:
-// 362128126198
-```
+| Property | Type | Description |
+|----------|------|-------------|
+| length   | number | Required length of string |
+| type     | "alpha" \| "numeric" \| "alphanumeric" | Optional (default: alphanumeric) |
 
 ---
 
-## ⚙️ API
+## ⚡ Why genkode?
 
-| Function        | Description                          |
-|----------------|--------------------------------------|
-| `mumble(n)`     | Returns alphanumeric string          |
-| `mumblealpha(n)`| Returns alphabet-only string         |
-| `mumblenum(n)`  | Returns numeric string               |
-
-- `n` → Length of the required string
+- Zero dependencies
+- Fast and lightweight
+- TypeScript support
+- Simple and flexible API
+- Multiple formats (alpha, numeric, alphanumeric)
 
 ---
 
 ## 🧩 Use Cases
 
-These generated strings can be used for:
-
 - Database IDs  
 - Tokens / API keys  
 - Session identifiers  
@@ -86,17 +82,16 @@ These generated strings can be used for:
 
 ## 🔒 Notes
 
-- This package uses standard random generation (`Math.random`)
-- Suitable for general-purpose use
-- Not recommended for cryptographic/security-critical use cases
+- Uses Math.random (not cryptographically secure)
+- Suitable for general-purpose usage
 
 ---
 
 ## 🔗 Related Package
 
-This package is also available as a JavaScript-only version:
+JavaScript-only version:
 
-**node-mumble** (by the same developer)  
+node-mumble (by same developer)  
 https://www.npmjs.com/package/node-mumble
 
 ---

package/dist/index.d.ts

@@ -1,4 +1,6 @@
-export declare function mumble(input: number): string;
-export declare function mumbleaplha(input: number): string;
-export declare function mumblenum(input: number): string;
+import type { GenerateCodeOptions } from "./kode.interface.js";
+export declare function generateCode({ length, type }: GenerateCodeOptions): string;
+export declare function randomString(length: number): string;
+export declare function randomAlpha(length: number): string;
+export declare function randomNumeric(length: number): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAWA,wBAAgB,MAAM,CAAC,KAAK,EAAC,MAAM,GAAE,MAAM,CAS1C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAC,MAAM,GAAG,MAAM,CAWhD;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAC,MAAM,GAAG,MAAM,CAW9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAmB/D,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,IAAqB,EAAE,EAAE,mBAAmB,GAAG,MAAM,CAI3F;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/index.js

@@ -1,42 +1,30 @@
-const arr = ["A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z", "a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9"];
-function isLetter(s) {
-    return s.match("^[a-zA-Z\(\)]+$");
+const ALPHA = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+const NUMERIC = "0123456789";
+const ALPHANUM = ALPHA + NUMERIC;
+function generate(length, charset) {
+    let result = "";
+    const max = charset.length;
+    while (length > 0) {
+        const index = Math.floor(Math.random() * max);
+        result += charset[index];
+        length--;
+    }
+    return result;
 }
-function isNumeric(s) {
-    return s.match("^[0-9\(\)]+$");
+export function generateCode({ length, type = "alphanumeric" }) {
+    if (type === "alpha")
+        return generate(length, ALPHA);
+    if (type === "numeric")
+        return generate(length, NUMERIC);
+    return generate(length, ALPHANUM);
 }
-export function mumble(input) {
-    let uniqString = "";
-    const length = arr.length;
-    while (input != 0) {
-        const randomIndex = Math.floor(Math.random() * length);
-        uniqString = uniqString + arr[randomIndex];
-        input = input - 1;
-    }
-    return uniqString;
+export function randomString(length) {
+    return generate(length, ALPHANUM);
 }
-export function mumbleaplha(input) {
-    let uniqString = "";
-    const length = arr.length;
-    while (input != 0) {
-        const randomIndex = Math.floor(Math.random() * length);
-        if (isLetter(arr[randomIndex])) {
-            uniqString = uniqString + arr[randomIndex];
-            input = input - 1;
-        }
-    }
-    return uniqString;
+export function randomAlpha(length) {
+    return generate(length, ALPHA);
 }
-export function mumblenum(input) {
-    let uniqString = "";
-    const length = arr.length;
-    while (input != 0) {
-        const randomIndex = Math.floor(Math.random() * length);
-        if (isNumeric(arr[randomIndex])) {
-            uniqString = uniqString + arr[randomIndex];
-            input = input - 1;
-        }
-    }
-    return uniqString;
+export function randomNumeric(length) {
+    return generate(length, NUMERIC);
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,MAAM,GAAG,GAAG,CAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,EAAC,GAAG,CAAC,CAAC;AAEtQ,SAAS,QAAQ,CAAC,CAAQ;IAExB,OAAO,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACpC,CAAC;AACD,SAAS,SAAS,CAAC,CAAQ;IAEzB,OAAO,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAY;IACjC,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAA;IACzB,OAAO,KAAK,IAAE,CAAC,EAAE,CAAC;QAChB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAC,MAAM,CAAC,CAAA;QACpD,UAAU,GAAG,UAAU,GAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzC,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAA;IACzB,OAAO,KAAK,IAAE,CAAC,EAAE,CAAC;QAChB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAC,MAAM,CAAC,CAAA;QACpD,IAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC,EAAC,CAAC;YAC9B,UAAU,GAAG,UAAU,GAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACzC,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,KAAY;IACpC,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAA;IACzB,OAAO,KAAK,IAAE,CAAC,EAAE,CAAC;QAChB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAC,MAAM,CAAC,CAAA;QACpD,IAAG,SAAS,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC,EAAC,CAAC;YAC/B,UAAU,GAAG,UAAU,GAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACzC,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAG,sDAAsD,CAAC;AACrE,MAAM,OAAO,GAAG,YAAY,CAAC;AAC7B,MAAM,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;AAEjC,SAAS,QAAQ,CAAC,MAAc,EAAE,OAAe;IAC/C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAE3B,OAAO,MAAM,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;QAC9C,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,EAAE,CAAC;IACX,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,cAAc,EAAuB;IACjF,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,OAAO,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/dist/kode.interface.d.ts

@@ -0,0 +1,5 @@
+export interface GenerateCodeOptions {
+    length: number;
+    type?: "alpha" | "numeric" | "alphanumeric";
+}
+//# sourceMappingURL=kode.interface.d.ts.map

package/dist/kode.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kode.interface.d.ts","sourceRoot":"","sources":["../kode.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,cAAc,CAAC;CAC7C"}

package/dist/kode.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=kode.interface.js.map

package/dist/kode.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kode.interface.js","sourceRoot":"","sources":["../kode.interface.ts"],"names":[],"mappings":""}

package/index.ts

@@ -1,46 +1,36 @@
-const arr = ["A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z","a","b","c","d","e","f","g","h","i","j","k","l","m","n","o","p","q","r","s","t","u","v","w","x","y","z","0","1","2","3","4","5","6","7","8","9"];
+import type { GenerateCodeOptions } from "./kode.interface.js";
 
-function isLetter(s:string)
-{
-  return s.match("^[a-zA-Z\(\)]+$");    
+const ALPHA = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+const NUMERIC = "0123456789";
+const ALPHANUM = ALPHA + NUMERIC;
+
+function generate(length: number, charset: string): string {
+  let result = "";
+  const max = charset.length;
+
+  while (length > 0) {
+    const index = Math.floor(Math.random() * max);
+    result += charset[index];
+    length--;
+  }
+
+  return result;
 }
-function isNumeric(s:string)
-{
-  return s.match("^[0-9\(\)]+$");    
+
+export function generateCode({ length, type = "alphanumeric" }: GenerateCodeOptions): string {
+  if (type === "alpha") return generate(length, ALPHA);
+  if (type === "numeric") return generate(length, NUMERIC);
+  return generate(length, ALPHANUM);
 }
 
-export function mumble(input:number):string {
-  let uniqString = "";
-  const length = arr.length
-  while (input!=0) {
-    const randomIndex = Math.floor(Math.random()*length)
-    uniqString = uniqString+arr[randomIndex];
-    input = input - 1;
-  }
-  return uniqString
+export function randomString(length: number): string {
+  return generate(length, ALPHANUM);
 }
 
-export function mumbleaplha(input:number): string {
-  let uniqString = "";
-  const length = arr.length
-  while (input!=0) {
-    const randomIndex = Math.floor(Math.random()*length)
-    if(isLetter(arr[randomIndex]!)){
-      uniqString = uniqString+arr[randomIndex];
-      input = input - 1;
-    }
-  }
-  return uniqString
+export function randomAlpha(length: number): string {
+  return generate(length, ALPHA);
 }
-export function mumblenum(input:number): string {
-  let uniqString = "";
-  const length = arr.length
-  while (input!=0) {
-    const randomIndex = Math.floor(Math.random()*length)
-    if(isNumeric(arr[randomIndex]!)){
-      uniqString = uniqString+arr[randomIndex];
-      input = input - 1;
-    }
-  }
-  return uniqString
+
+export function randomNumeric(length: number): string {
+  return generate(length, NUMERIC);
 }

package/kode.interface.ts

@@ -0,0 +1,4 @@
+export interface GenerateCodeOptions {
+  length: number;
+  type?: "alpha" | "numeric" | "alphanumeric";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genkode",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "A node package that creates a random unique characters string (Typescript Supported)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,15 +15,29 @@
   },
   "keywords": [
     "random",
-    "string",
-    "generator",
-    "id",
+    "random-string",
+    "string-generator",
+    "random-id",
+    "id-generator",
     "token",
-    "alphanumeric"
+    "token-generator",
+    "alphanumeric",
+    "alphabet",
+    "numeric",
+    "random-code",
+    "code-generator",
+    "unique-id",
+    "lightweight",
+    "zero-dependency",
+    "typescript",
+    "nodejs",
+    "utility"
   ],
   "author": "",
   "license": "MIT",
   "devDependencies": {
+    "tsx": "^4.21.0",
+    "txc": "^0.0.1",
     "typescript": "^6.0.2"
   },
   "bugs": {