genkode 1.0.1 → 1.2.0

package/.github/workflows/ci.yml

@@ -0,0 +1,60 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches:
+      - 'feature/**'
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  build-and-test:
+    name: Build & Test
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build project
+        run: npm run build
+
+      - name: Run tests
+        run: npm test
+
+  publish:
+    name: Publish to npm
+    runs-on: ubuntu-latest
+    needs: build-and-test
+    if: github.ref == 'refs/heads/master'
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org/
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build project
+        run: npm run build
+
+      - name: Publish to npm
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

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,52 @@ npm install genkode
 
 ## 🚀 Usage
 
-### 1. Generate Alphanumeric String
+### Generate using main API
 
 ```ts
-import { mumble } from 'genkode';
+import { generateCode } from 'genkode';
 
-console.log(mumble(12));
+generateCode({ length: 12 });
+// Example: rqfvYxJRWfoP  (alpha by default)
 
-// Example output:
-// vl6QLrr3xIBe
-```
+generateCode({ length: 12, type: "alphanumeric" });
+// Example: aZ8kL2pQ9xW1
 
----
+generateCode({ length: 12, type: "numeric" });
+// Example: 362128126198
 
-### 2. Generate Alphabet-only String
-
-```ts
-import { mumblealpha } from 'genkode';
-
-console.log(mumblealpha(12));
-
-// Example output:
-// rqfvYxJRWfoP
+// Cryptographically secure generation
+generateCode({ length: 12, type: "alphanumeric", secure: true });
+// Example: Tz3mW8qA1nXp
 ```
 
 ---
 
-### 3. Generate Numeric String
-
-```ts
-import { mumblenum } from 'genkode';
+## ⚙️ API
 
-console.log(mumblenum(12));
+### `generateCode(options)`
 
-// Example output:
-// 362128126198
-```
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `length` | `number` | — | Required. Length of the generated string |
+| `type` | `"alpha"` \| `"numeric"` \| `"alphanumeric"` | `"alpha"` | Character set to use |
+| `secure` | `boolean` | `false` | Use `crypto.getRandomValues` for cryptographically secure output |
 
 ---
 
-## ⚙️ 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)
+- Optional cryptographically secure mode via Web Crypto API
 
 ---
 
 ## 🧩 Use Cases
 
-These generated strings can be used for:
-
 - Database IDs  
 - Tokens / API keys  
 - Session identifiers  
@@ -84,23 +74,27 @@ These generated strings can be used for:
 
 ---
 
-## 🔒 Notes
+## 🔒 Security
 
-- This package uses standard random generation (`Math.random`)
-- Suitable for general-purpose use
-- Not recommended for cryptographic/security-critical use cases
+By default, `generateCode` uses `Math.random`, which is fast but **not cryptographically secure**.
+
+Set `secure: true` to use `crypto.getRandomValues` (Web Crypto API), which produces unbiased, cryptographically secure output. Use this when generating tokens, API keys, or any value where predictability is a security concern.
+
+```ts
+generateCode({ length: 32, type: "alphanumeric", secure: true });
+```
 
 ---
 
 ## 🔗 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
 
 ---
 
 ## 📄 License
 
-MIT
+MIT

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-export declare function mumble(input: number): string;
-export declare function mumbleaplha(input: number): string;
-export declare function mumblenum(input: number): string;
+import type { GenerateOptions } from "./kode.interface.js";
+export declare function generateCode({ length, type, secure }: GenerateOptions): 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,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAmD3D,wBAAgB,YAAY,CAAC,EAAC,MAAM,EAAC,IAAc,EAAC,MAAc,EAAC,EAAE,eAAe,GAAG,MAAM,CAS5F"}

package/dist/index.js

@@ -1,42 +1,44 @@
-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\(\)]+$");
-}
-function isNumeric(s) {
-    return s.match("^[0-9\(\)]+$");
-}
-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;
+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 uniqString;
+    return result;
 }
-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;
+function generateSecure(length, charset) {
+    const max = charset.length;
+    const result = [];
+    const randomBuffer = new Uint8Array(1);
+    while (result.length < length) {
+        crypto.getRandomValues(randomBuffer);
+        const byte = randomBuffer[0];
+        if (byte < Math.floor(256 / max) * max) {
+            result.push(charset[byte % max]);
         }
     }
-    return uniqString;
+    return result.join("");
 }
-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;
+function randomString(length) {
+    return generate(length, ALPHANUM);
+}
+function randomAlpha(length) {
+    return generate(length, ALPHA);
+}
+function randomNumeric(length) {
+    return generate(length, NUMERIC);
+}
+export function generateCode({ length, type = "alpha", secure = false }) {
+    const charset = type === "alpha" ? ALPHA :
+        type === "numeric" ? NUMERIC :
+            ALPHANUM;
+    return secure
+        ? generateSecure(length, charset)
+        : generate(length, charset);
 }
 //# 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,CAAE,CAAC;QAC1B,MAAM,EAAE,CAAC;IACX,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAGD,SAAS,cAAc,CAAC,MAAc,EAAE,OAAe;IACrD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,YAAY,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAEvC,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QAC9B,MAAM,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;QAE9B,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,CAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAGD,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,OAAO,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,OAAO,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAGD,MAAM,UAAU,YAAY,CAAC,EAAC,MAAM,EAAC,IAAI,GAAG,OAAO,EAAC,MAAM,GAAG,KAAK,EAAkB;IAClF,MAAM,OAAO,GACX,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC9B,QAAQ,CAAC;IAEX,OAAO,MAAM;QACX,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;QACjC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/kode.interface.d.ts

@@ -0,0 +1,7 @@
+export type CodeType = "alpha" | "numeric" | "alphanumeric";
+export interface GenerateOptions {
+    length: number;
+    type?: CodeType;
+    secure?: boolean;
+}
+//# 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,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,cAAc,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

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,61 @@
-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 { GenerateOptions } from "./kode.interface.js";
 
-function isLetter(s:string)
-{
-  return s.match("^[a-zA-Z\(\)]+$");    
-}
-function isNumeric(s:string)
-{
-  return s.match("^[0-9\(\)]+$");    
-}
+const ALPHA = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+const NUMERIC = "0123456789";
+const ALPHANUM = ALPHA + NUMERIC;
+
+function generate(length: number, charset: string): string {
+  let result = "";
+  const max = charset.length;
 
-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;
+  while (length > 0) {
+    const index = Math.floor(Math.random() * max);
+    result += charset[index]!;
+    length--;
   }
-  return uniqString
+
+  return result;
 }
 
-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;
+
+function generateSecure(length: number, charset: string): string {
+  const max = charset.length;
+  const result: string[] = [];
+  const randomBuffer = new Uint8Array(1);
+
+  while (result.length < length) {
+    crypto.getRandomValues(randomBuffer);
+    const byte = randomBuffer[0]!;
+
+    if (byte < Math.floor(256 / max) * max) {
+      result.push(charset[byte % max]!);
     }
   }
-  return uniqString
+
+  return result.join("");
 }
-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
+
+
+function randomString(length: number): string {
+  return generate(length, ALPHANUM);
 }
+
+function randomAlpha(length: number): string {
+  return generate(length, ALPHA);
+}
+
+function randomNumeric(length: number): string {
+  return generate(length, NUMERIC);
+}
+
+
+export function generateCode({length,type = "alpha",secure = false}: GenerateOptions): string {
+  const charset =
+    type === "alpha" ? ALPHA :
+    type === "numeric" ? NUMERIC :
+    ALPHANUM;
+
+  return secure
+    ? generateSecure(length, charset)
+    : generate(length, charset);
+}

package/kode.interface.ts

@@ -0,0 +1,7 @@
+export type CodeType = "alpha" | "numeric" | "alphanumeric";
+
+export interface GenerateOptions {
+  length: number;
+  type?: CodeType;
+  secure?: boolean;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "genkode",
-  "version": "1.0.1",
-  "description": "A node package that creates a random unique characters string (Typescript Supported)",
+  "version": "1.2.0",
+  "description": "A lightweight Node.js utility to generate random alphanumeric, alphabetic, or numeric strings.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": {
@@ -10,24 +10,43 @@
   },
   "type": "module",
   "scripts": {
+    "test": "node --test",
     "build": "tsc",
     "prepublishOnly": "npm run build"
   },
   "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": {
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "txc": "^0.0.1",
     "typescript": "^6.0.2"
   },
   "bugs": {
     "url": "https://github.com/sammitpal/genkode/issues"
   },
-  "homepage": "https://github.com/sammitpal/genkode#readme"
+  "homepage": "https://github.com/sammitpal/genkode#readme",
+  "dependencies": {
+    "crypto": "^1.0.1"
+  }
 }

package/test/genkode.test.ts

@@ -0,0 +1,64 @@
+/// <reference types="node" />
+import test from "node:test";
+import assert from "node:assert";
+import { generateCode } from "../dist/index.js";
+
+// Helper regex
+const alphaRegex = /^[A-Za-z]+$/;
+const numericRegex = /^[0-9]+$/;
+const alphanumRegex = /^[A-Za-z0-9]+$/;
+
+test("should generate string of correct length", () => {
+  const result = generateCode({ length: 20 });
+  assert.strictEqual(result.length, 20);
+});
+
+test("should generate alphabet-only string", () => {
+  const result = generateCode({ length: 30, type: "alpha" });
+  assert.ok(alphaRegex.test(result));
+});
+
+test("should generate numeric-only string", () => {
+  const result = generateCode({ length: 30, type: "numeric" });
+  assert.ok(numericRegex.test(result));
+});
+
+test("should generate alphanumeric string", () => {
+  const result = generateCode({ length: 30, type: "alphanumeric" });
+  assert.ok(alphanumRegex.test(result));
+});
+
+test("should generate secure string (alpha)", () => {
+  const result = generateCode({ length: 25, type: "alpha", secure: true });
+  assert.strictEqual(result.length, 25);
+  assert.ok(alphaRegex.test(result));
+});
+
+test("should generate secure numeric string", () => {
+  const result = generateCode({ length: 25, type: "numeric", secure: true });
+  assert.strictEqual(result.length, 25);
+  assert.ok(numericRegex.test(result));
+});
+
+test("should generate secure alphanumeric string", () => {
+  const result = generateCode({ length: 25, type: "alphanumeric", secure: true });
+  assert.strictEqual(result.length, 25);
+  assert.ok(alphanumRegex.test(result));
+});
+
+test("should generate different values each time (non-deterministic)", () => {
+  const a = generateCode({ length: 20 });
+  const b = generateCode({ length: 20 });
+
+  assert.notStrictEqual(a, b);
+});
+
+test("should handle small length", () => {
+  const result = generateCode({ length: 1 });
+  assert.strictEqual(result.length, 1);
+});
+
+test("should handle large length", () => {
+  const result = generateCode({ length: 1000 });
+  assert.strictEqual(result.length, 1000);
+});

package/tsconfig.json

@@ -3,23 +3,29 @@
     "rootDir": ".",
     "outDir": "./dist",
 
-    "module": "nodenext",
-    "target": "esnext",
-    "types": [],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "target": "ES2022",
+
+    "types": ["node"],
 
     "sourceMap": true,
     "declaration": true,
     "declarationMap": true,
 
+    "strict": true,
     "noUncheckedIndexedAccess": true,
     "exactOptionalPropertyTypes": true,
 
-
-    "strict": true,
     "verbatimModuleSyntax": true,
     "isolatedModules": true,
     "noUncheckedSideEffectImports": true,
     "moduleDetection": "force",
-    "skipLibCheck": true,
-  }
-}
+
+    "skipLibCheck": true
+  },
+
+  "include": ["index.ts"],
+
+  "exclude": ["test", "dist", "node_modules"]
+}