ts-id-lite 2.0.0 → 2.0.16

package/README.md

@@ -0,0 +1,45 @@
+# ts-id-lite
+
+Lightweight, type-safe ID generation utility library for web developers.
+
+## Installation
+
+```bash
+npm install ts-id-lite
+```
+
+## Usage
+
+```typescript
+import { Injectable } from '@angular/core';
+import { IdUtils } from 'ts-id-lite';
+
+@Injectable({ providedIn: 'root' })
+export class MyService {
+  constructor(private id: IdUtils) { }
+  
+  myMethod(): void {
+    this.id.uuid();                  // '550e8400-e29b-41d4-a716-446655440000'
+    this.id.nanoid();                // 'V1StGXR8_Z'
+    this.id.shortId();               // random short ID
+    this.id.hash('text');            // hash string
+    this.id.snowflake();             // snowflake ID
+    this.id.generateCode(6, 'numeric');  // '482931'
+  }
+}
+```
+
+## Methods
+
+| Method | Description | Example |
+|--------|-------------|---------|
+| `uuid` | Generate UUID v4 | → `'550e8400-...' ` |
+| `nanoid` | Generate nanoid | → `'V1StGXR8_Z'` |
+| `shortId` | Generate short ID | → random short string |
+| `hash` | Hash string | `'text'` → hash |
+| `snowflake` | Generate snowflake ID | → timestamp-based ID |
+| `generateCode` | Generate code | `6, 'numeric'` → `'482931'` |
+
+## License
+
+MIT

package/dist/id.d.ts

@@ -0,0 +1,10 @@
+export declare class IdUtils {
+    private readonly base36Chars;
+    uuid(): string;
+    nanoid(size?: number): string;
+    shortId(length?: number): string;
+    snowflake(): string;
+    hash(input: string): string;
+    generateCode(length?: number, charset?: 'numeric' | 'alpha' | 'alphanumeric'): string;
+    generateToken(length?: number): string;
+}

package/dist/id.js

@@ -0,0 +1,50 @@
+export class IdUtils {
+    constructor() {
+        this.base36Chars = '0123456789abcdefghijklmnopqrstuvwxyz';
+    }
+    uuid() {
+        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+            const r = Math.random() * 16 | 0;
+            const v = c === 'x' ? r : (r & 0x3 | 0x8);
+            return v.toString(16);
+        });
+    }
+    nanoid(size = 21) {
+        const bytes = new Uint8Array(size);
+        crypto.getRandomValues(bytes);
+        return Array.from(bytes, b => this.base36Chars[b & 63]).join('');
+    }
+    shortId(length = 10) {
+        return this.nanoid(length).replace(/[_=-]/g, '');
+    }
+    snowflake() {
+        const timestamp = BigInt(Date.now() - 1700000000000);
+        const machineId = BigInt(Math.floor(Math.random() * 1024));
+        const sequence = BigInt(Math.floor(Math.random() * 4096));
+        const id = (timestamp << 22n) | (machineId << 12n) | sequence;
+        return id.toString();
+    }
+    hash(input) {
+        let hash = 0;
+        for (let i = 0; i < input.length; i++) {
+            const char = input.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash;
+        }
+        return Math.abs(hash).toString(36);
+    }
+    generateCode(length = 6, charset = 'numeric') {
+        const charsets = {
+            numeric: '0123456789',
+            alpha: 'abcdefghijklmnopqrstuvwxyz',
+            alphanumeric: '0123456789abcdefghijklmnopqrstuvwxyz'
+        };
+        const chars = charsets[charset];
+        return Array(length).fill(0).map(() => chars[Math.floor(Math.random() * chars.length)]).join('');
+    }
+    generateToken(length = 32) {
+        const bytes = new Uint8Array(length);
+        crypto.getRandomValues(bytes);
+        return Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './id';

package/dist/index.js

@@ -0,0 +1 @@
+export * from './id';

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "ts-id-lite",
-  "version": "2.0.0",
+  "version": "2.0.16",
+  "deprecated": "Previous versions are deprecated. Please upgrade to 2.0.15 or later.",
   "description": "Lightweight, type-safe ID generation utility library for web developers",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -27,5 +28,9 @@
     "lite"
   ],
   "author": "Gaurang Mody - G8X",
-  "license": "MIT"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gbmrocks/ts-utils-lite.git"
+  }
 }