@rahul_dadhich15/id-toolkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rahuldadhich1517-sys
+
+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

@@ -0,0 +1,36 @@
+# ID Toolkit
+
+[![npm version](https://img.shields.io/npm/v/%40rahul_dadhich15%2Fid-toolkit)](https://www.npmjs.com/package/@rahul_dadhich15/id-toolkit)
+[![npm downloads](https://img.shields.io/npm/dm/%40rahul_dadhich15%2Fid-toolkit)](https://www.npmjs.com/package/@rahul_dadhich15/id-toolkit)
+[![CI](https://github.com/rahuldadhich15/id-toolkit/actions/workflows/ci.yml/badge.svg)](https://github.com/rahuldadhich15/id-toolkit/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/rahuldadhich15/id-toolkit)](https://github.com/rahuldadhich15/id-toolkit/blob/main/LICENSE)
+
+A lightweight, dependency-free TypeScript toolkit for generating, validating, and working with UUIDs, short IDs, and cryptographically secure identifiers.
+
+Built for modern JavaScript and TypeScript applications.
+
+---
+
+## Features
+
+- Cryptographically secure random identifiers
+- UUID v4 generation
+- UUID v7 generation
+- Bulk UUID generation
+- UUID structure and version validation
+- Compact URL-friendly short IDs
+- Secure IDs using Node.js `crypto`
+- Hex and Base64URL encoding
+- Full TypeScript support
+- ESM and CommonJS support
+- Zero runtime dependencies
+- Vitest test coverage
+- Tree-shake friendly
+- Lightweight
+
+---
+
+## Installation
+
+```bash
+npm install @rahul_dadhich15/id-toolkit

package/dist/index.cjs

@@ -0,0 +1,250 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  generateSecureId: () => generateSecureId,
+  generateSecureIds: () => generateSecureIds,
+  generateShortId: () => generateShortId,
+  generateShortIds: () => generateShortIds,
+  generateUUIDs: () => generateUUIDs,
+  getUUIDVersion: () => getUUIDVersion,
+  isUUID: () => isUUID,
+  uuidV4: () => uuidV4,
+  uuidV7: () => uuidV7
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/uuid-generator/uuid-generator.ts
+var import_node_crypto = require("crypto");
+function uuidV4() {
+  const bytes = (0, import_node_crypto.randomBytes)(16);
+  bytes[6] = bytes[6] & 15 | 64;
+  bytes[8] = bytes[8] & 63 | 128;
+  return bytesToUUID(bytes);
+}
+function uuidV7() {
+  const bytes = (0, import_node_crypto.randomBytes)(16);
+  const timestamp = BigInt(Date.now());
+  bytes[0] = Number(timestamp >> 40n & 0xffn);
+  bytes[1] = Number(timestamp >> 32n & 0xffn);
+  bytes[2] = Number(timestamp >> 24n & 0xffn);
+  bytes[3] = Number(timestamp >> 16n & 0xffn);
+  bytes[4] = Number(timestamp >> 8n & 0xffn);
+  bytes[5] = Number(timestamp & 0xffn);
+  bytes[6] = bytes[6] & 15 | 112;
+  bytes[8] = bytes[8] & 63 | 128;
+  return bytesToUUID(bytes);
+}
+function generateUUIDs(count, version = "v4") {
+  validateCount(count);
+  const generator = version === "v7" ? uuidV7 : uuidV4;
+  return Array.from({ length: count }, generator);
+}
+function bytesToUUID(bytes) {
+  if (bytes.length !== 16) {
+    throw new RangeError("UUID requires exactly 16 bytes");
+  }
+  const hex = Array.from(
+    bytes,
+    (byte) => byte.toString(16).padStart(2, "0")
+  ).join("");
+  return [
+    hex.slice(0, 8),
+    hex.slice(8, 12),
+    hex.slice(12, 16),
+    hex.slice(16, 20),
+    hex.slice(20, 32)
+  ].join("-");
+}
+function validateCount(count) {
+  if (!Number.isInteger(count)) {
+    throw new TypeError("count must be an integer");
+  }
+  if (count < 1) {
+    throw new RangeError("count must be greater than 0");
+  }
+  if (count > 1e6) {
+    throw new RangeError("count cannot exceed 1,000,000");
+  }
+}
+
+// src/uuid-validator/uuid-validator.ts
+var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function isUUID(value, version) {
+  if (typeof value !== "string") {
+    return false;
+  }
+  if (!UUID_REGEX.test(value)) {
+    return false;
+  }
+  if (version !== void 0) {
+    return getUUIDVersion(value) === version;
+  }
+  return true;
+}
+function getUUIDVersion(value) {
+  if (!isUUID(value)) {
+    return null;
+  }
+  return Number(value[14]);
+}
+
+// src/short-id/short-id.ts
+var import_node_crypto2 = require("crypto");
+var DEFAULT_ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+var DEFAULT_LENGTH = 12;
+function generateShortId(options = {}) {
+  const length = options.length ?? DEFAULT_LENGTH;
+  const alphabet = options.alphabet ?? DEFAULT_ALPHABET;
+  validateLength(length);
+  validateAlphabet(alphabet);
+  const result = [];
+  const limit = Math.floor(256 / alphabet.length) * alphabet.length;
+  while (result.length < length) {
+    const bytes = (0, import_node_crypto2.randomBytes)(length - result.length);
+    for (const byte of bytes) {
+      if (byte >= limit) {
+        continue;
+      }
+      result.push(alphabet[byte % alphabet.length]);
+      if (result.length === length) {
+        break;
+      }
+    }
+  }
+  return result.join("");
+}
+function generateShortIds(count, options = {}) {
+  validateCount2(count);
+  return Array.from(
+    { length: count },
+    () => generateShortId(options)
+  );
+}
+function validateLength(length) {
+  if (!Number.isInteger(length)) {
+    throw new TypeError("length must be an integer");
+  }
+  if (length < 1) {
+    throw new RangeError("length must be greater than 0");
+  }
+  if (length > 256) {
+    throw new RangeError("length cannot exceed 256");
+  }
+}
+function validateCount2(count) {
+  if (!Number.isInteger(count)) {
+    throw new TypeError("count must be an integer");
+  }
+  if (count < 1) {
+    throw new RangeError("count must be greater than 0");
+  }
+  if (count > 1e6) {
+    throw new RangeError("count cannot exceed 1,000,000");
+  }
+}
+function validateAlphabet(alphabet) {
+  if (typeof alphabet !== "string") {
+    throw new TypeError("alphabet must be a string");
+  }
+  if (alphabet.length < 2) {
+    throw new RangeError(
+      "alphabet must contain at least 2 characters"
+    );
+  }
+  if (alphabet.length > 256) {
+    throw new RangeError(
+      "alphabet cannot contain more than 256 characters"
+    );
+  }
+  const uniqueCharacters = new Set(alphabet);
+  if (uniqueCharacters.size !== alphabet.length) {
+    throw new RangeError(
+      "alphabet must contain unique characters"
+    );
+  }
+}
+
+// src/secure-id/secure-id.ts
+var import_node_crypto3 = require("crypto");
+function generateSecureId(options = {}) {
+  const bytes = options.bytes ?? 32;
+  const encoding = options.encoding ?? "hex";
+  validateBytes(bytes);
+  validateEncoding(encoding);
+  return (0, import_node_crypto3.randomBytes)(bytes).toString(encoding);
+}
+function generateSecureIds(count, options = {}) {
+  validateCount3(count);
+  return Array.from(
+    { length: count },
+    () => generateSecureId(options)
+  );
+}
+function validateBytes(bytes) {
+  if (!Number.isInteger(bytes)) {
+    throw new TypeError("bytes must be an integer");
+  }
+  if (bytes < 1) {
+    throw new RangeError(
+      "bytes must be greater than 0"
+    );
+  }
+  if (bytes > 1024) {
+    throw new RangeError(
+      "bytes cannot exceed 1024"
+    );
+  }
+}
+function validateCount3(count) {
+  if (!Number.isInteger(count)) {
+    throw new TypeError("count must be an integer");
+  }
+  if (count < 1) {
+    throw new RangeError(
+      "count must be greater than 0"
+    );
+  }
+  if (count > 1e6) {
+    throw new RangeError(
+      "count cannot exceed 1,000,000"
+    );
+  }
+}
+function validateEncoding(encoding) {
+  if (encoding !== "hex" && encoding !== "base64url") {
+    throw new RangeError(
+      'encoding must be either "hex" or "base64url"'
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateSecureId,
+  generateSecureIds,
+  generateShortId,
+  generateShortIds,
+  generateUUIDs,
+  getUUIDVersion,
+  isUUID,
+  uuidV4,
+  uuidV7
+});

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { uuidV4, uuidV7, generateUUIDs, } from "./uuid-generator/index.js";
+export type { UUIDVersion as UUIDGeneratorVersion, } from "./uuid-generator/index.js";
+export { isUUID, getUUIDVersion, } from "./uuid-validator/index.js";
+export type { UUIDVersion as UUIDValidatorVersion, } from "./uuid-validator/index.js";
+export { generateShortId, generateShortIds, } from "./short-id/index.js";
+export type { ShortIdOptions, } from "./short-id/index.js";
+export { generateSecureId, generateSecureIds, } from "./secure-id/index.js";
+export type { SecureIdEncoding, SecureIdOptions, } from "./secure-id/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,MAAM,EACN,aAAa,GACd,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,WAAW,IAAI,oBAAoB,GACpC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,MAAM,EACN,cAAc,GACf,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,WAAW,IAAI,oBAAoB,GACpC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,215 @@
+// src/uuid-generator/uuid-generator.ts
+import { randomBytes } from "crypto";
+function uuidV4() {
+  const bytes = randomBytes(16);
+  bytes[6] = bytes[6] & 15 | 64;
+  bytes[8] = bytes[8] & 63 | 128;
+  return bytesToUUID(bytes);
+}
+function uuidV7() {
+  const bytes = randomBytes(16);
+  const timestamp = BigInt(Date.now());
+  bytes[0] = Number(timestamp >> 40n & 0xffn);
+  bytes[1] = Number(timestamp >> 32n & 0xffn);
+  bytes[2] = Number(timestamp >> 24n & 0xffn);
+  bytes[3] = Number(timestamp >> 16n & 0xffn);
+  bytes[4] = Number(timestamp >> 8n & 0xffn);
+  bytes[5] = Number(timestamp & 0xffn);
+  bytes[6] = bytes[6] & 15 | 112;
+  bytes[8] = bytes[8] & 63 | 128;
+  return bytesToUUID(bytes);
+}
+function generateUUIDs(count, version = "v4") {
+  validateCount(count);
+  const generator = version === "v7" ? uuidV7 : uuidV4;
+  return Array.from({ length: count }, generator);
+}
+function bytesToUUID(bytes) {
+  if (bytes.length !== 16) {
+    throw new RangeError("UUID requires exactly 16 bytes");
+  }
+  const hex = Array.from(
+    bytes,
+    (byte) => byte.toString(16).padStart(2, "0")
+  ).join("");
+  return [
+    hex.slice(0, 8),
+    hex.slice(8, 12),
+    hex.slice(12, 16),
+    hex.slice(16, 20),
+    hex.slice(20, 32)
+  ].join("-");
+}
+function validateCount(count) {
+  if (!Number.isInteger(count)) {
+    throw new TypeError("count must be an integer");
+  }
+  if (count < 1) {
+    throw new RangeError("count must be greater than 0");
+  }
+  if (count > 1e6) {
+    throw new RangeError("count cannot exceed 1,000,000");
+  }
+}
+
+// src/uuid-validator/uuid-validator.ts
+var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function isUUID(value, version) {
+  if (typeof value !== "string") {
+    return false;
+  }
+  if (!UUID_REGEX.test(value)) {
+    return false;
+  }
+  if (version !== void 0) {
+    return getUUIDVersion(value) === version;
+  }
+  return true;
+}
+function getUUIDVersion(value) {
+  if (!isUUID(value)) {
+    return null;
+  }
+  return Number(value[14]);
+}
+
+// src/short-id/short-id.ts
+import { randomBytes as randomBytes2 } from "crypto";
+var DEFAULT_ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+var DEFAULT_LENGTH = 12;
+function generateShortId(options = {}) {
+  const length = options.length ?? DEFAULT_LENGTH;
+  const alphabet = options.alphabet ?? DEFAULT_ALPHABET;
+  validateLength(length);
+  validateAlphabet(alphabet);
+  const result = [];
+  const limit = Math.floor(256 / alphabet.length) * alphabet.length;
+  while (result.length < length) {
+    const bytes = randomBytes2(length - result.length);
+    for (const byte of bytes) {
+      if (byte >= limit) {
+        continue;
+      }
+      result.push(alphabet[byte % alphabet.length]);
+      if (result.length === length) {
+        break;
+      }
+    }
+  }
+  return result.join("");
+}
+function generateShortIds(count, options = {}) {
+  validateCount2(count);
+  return Array.from(
+    { length: count },
+    () => generateShortId(options)
+  );
+}
+function validateLength(length) {
+  if (!Number.isInteger(length)) {
+    throw new TypeError("length must be an integer");
+  }
+  if (length < 1) {
+    throw new RangeError("length must be greater than 0");
+  }
+  if (length > 256) {
+    throw new RangeError("length cannot exceed 256");
+  }
+}
+function validateCount2(count) {
+  if (!Number.isInteger(count)) {
+    throw new TypeError("count must be an integer");
+  }
+  if (count < 1) {
+    throw new RangeError("count must be greater than 0");
+  }
+  if (count > 1e6) {
+    throw new RangeError("count cannot exceed 1,000,000");
+  }
+}
+function validateAlphabet(alphabet) {
+  if (typeof alphabet !== "string") {
+    throw new TypeError("alphabet must be a string");
+  }
+  if (alphabet.length < 2) {
+    throw new RangeError(
+      "alphabet must contain at least 2 characters"
+    );
+  }
+  if (alphabet.length > 256) {
+    throw new RangeError(
+      "alphabet cannot contain more than 256 characters"
+    );
+  }
+  const uniqueCharacters = new Set(alphabet);
+  if (uniqueCharacters.size !== alphabet.length) {
+    throw new RangeError(
+      "alphabet must contain unique characters"
+    );
+  }
+}
+
+// src/secure-id/secure-id.ts
+import { randomBytes as randomBytes3 } from "crypto";
+function generateSecureId(options = {}) {
+  const bytes = options.bytes ?? 32;
+  const encoding = options.encoding ?? "hex";
+  validateBytes(bytes);
+  validateEncoding(encoding);
+  return randomBytes3(bytes).toString(encoding);
+}
+function generateSecureIds(count, options = {}) {
+  validateCount3(count);
+  return Array.from(
+    { length: count },
+    () => generateSecureId(options)
+  );
+}
+function validateBytes(bytes) {
+  if (!Number.isInteger(bytes)) {
+    throw new TypeError("bytes must be an integer");
+  }
+  if (bytes < 1) {
+    throw new RangeError(
+      "bytes must be greater than 0"
+    );
+  }
+  if (bytes > 1024) {
+    throw new RangeError(
+      "bytes cannot exceed 1024"
+    );
+  }
+}
+function validateCount3(count) {
+  if (!Number.isInteger(count)) {
+    throw new TypeError("count must be an integer");
+  }
+  if (count < 1) {
+    throw new RangeError(
+      "count must be greater than 0"
+    );
+  }
+  if (count > 1e6) {
+    throw new RangeError(
+      "count cannot exceed 1,000,000"
+    );
+  }
+}
+function validateEncoding(encoding) {
+  if (encoding !== "hex" && encoding !== "base64url") {
+    throw new RangeError(
+      'encoding must be either "hex" or "base64url"'
+    );
+  }
+}
+export {
+  generateSecureId,
+  generateSecureIds,
+  generateShortId,
+  generateShortIds,
+  generateUUIDs,
+  getUUIDVersion,
+  isUUID,
+  uuidV4,
+  uuidV7
+};

package/dist/secure-id/index.d.ts

@@ -0,0 +1,3 @@
+export { generateSecureId, generateSecureIds, } from "./secure-id.js";
+export type { SecureIdEncoding, SecureIdOptions, } from "./secure-id.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/secure-id/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/secure-id/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/secure-id/secure-id.d.ts

@@ -0,0 +1,16 @@
+export type SecureIdEncoding = "hex" | "base64url";
+export interface SecureIdOptions {
+    bytes?: number;
+    encoding?: SecureIdEncoding;
+}
+/**
+ * Generate a cryptographically secure identifier.
+ *
+ * @param options Configuration for byte length and encoding.
+ */
+export declare function generateSecureId(options?: SecureIdOptions): string;
+/**
+ * Generate multiple cryptographically secure identifiers.
+ */
+export declare function generateSecureIds(count: number, options?: SecureIdOptions): string[];
+//# sourceMappingURL=secure-id.d.ts.map

package/dist/secure-id/secure-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-id.d.ts","sourceRoot":"","sources":["../../src/secure-id/secure-id.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,WAAW,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE,eAAoB,GAC5B,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,GAC5B,MAAM,EAAE,CAOV"}

package/dist/short-id/index.d.ts

@@ -0,0 +1,3 @@
+export { generateShortId, generateShortIds, } from "./short-id.js";
+export type { ShortIdOptions, } from "./short-id.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/short-id/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/short-id/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,cAAc,GACf,MAAM,eAAe,CAAC"}

package/dist/short-id/short-id.d.ts

@@ -0,0 +1,16 @@
+export interface ShortIdOptions {
+    length?: number;
+    alphabet?: string;
+}
+/**
+ * Generate a compact URL-friendly identifier.
+ *
+ * Uses cryptographically secure random bytes and rejection
+ * sampling to avoid modulo bias.
+ */
+export declare function generateShortId(options?: ShortIdOptions): string;
+/**
+ * Generate multiple compact identifiers.
+ */
+export declare function generateShortIds(count: number, options?: ShortIdOptions): string[];
+//# sourceMappingURL=short-id.d.ts.map

package/dist/short-id/short-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"short-id.d.ts","sourceRoot":"","sources":["../../src/short-id/short-id.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,cAAmB,GAC3B,MAAM,CA+BR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,cAAmB,GAC3B,MAAM,EAAE,CAOV"}

package/dist/uuid-generator/index.d.ts

@@ -0,0 +1,3 @@
+export { uuidV4, uuidV7, generateUUIDs, } from "./uuid-generator.js";
+export type { UUIDVersion, } from "./uuid-generator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/uuid-generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/uuid-generator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,MAAM,EACN,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,WAAW,GACZ,MAAM,qBAAqB,CAAC"}

package/dist/uuid-generator/uuid-generator.d.ts

@@ -0,0 +1,17 @@
+export type UUIDVersion = "v4" | "v7";
+/**
+ * Generate a UUID v4 using cryptographically secure random bytes.
+ */
+export declare function uuidV4(): string;
+/**
+ * Generate a UUID v7 using the current Unix timestamp.
+ *
+ * UUID v7 is time-ordered and useful for sortable identifiers,
+ * database keys, event IDs, and distributed systems.
+ */
+export declare function uuidV7(): string;
+/**
+ * Generate multiple UUIDs.
+ */
+export declare function generateUUIDs(count: number, version?: UUIDVersion): string[];
+//# sourceMappingURL=uuid-generator.d.ts.map

package/dist/uuid-generator/uuid-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid-generator.d.ts","sourceRoot":"","sources":["../../src/uuid-generator/uuid-generator.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtC;;GAEG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAQ/B;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAoB/B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAkB,GAC1B,MAAM,EAAE,CAMV"}

package/dist/uuid-validator/index.d.ts

@@ -0,0 +1,3 @@
+export { isUUID, getUUIDVersion, } from "./uuid-validator.js";
+export type { UUIDVersion, } from "./uuid-validator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/uuid-validator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/uuid-validator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,WAAW,GACZ,MAAM,qBAAqB,CAAC"}

package/dist/uuid-validator/uuid-validator.d.ts

@@ -0,0 +1,14 @@
+export type UUIDVersion = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+/**
+ * Check whether a value is a valid UUID.
+ *
+ * Optionally validates a specific UUID version.
+ */
+export declare function isUUID(value: unknown, version?: UUIDVersion): value is string;
+/**
+ * Get the UUID version.
+ *
+ * Returns null when the value is not a valid UUID.
+ */
+export declare function getUUIDVersion(value: unknown): UUIDVersion | null;
+//# sourceMappingURL=uuid-validator.d.ts.map

package/dist/uuid-validator/uuid-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid-validator.d.ts","sourceRoot":"","sources":["../../src/uuid-validator/uuid-validator.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAKxD;;;;GAIG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,WAAW,GACpB,KAAK,IAAI,MAAM,CAcjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,GACb,WAAW,GAAG,IAAI,CAMpB"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@rahul_dadhich15/id-toolkit",
+  "version": "0.1.0",
+  "description": "A lightweight, dependency-free TypeScript toolkit for UUIDs, short IDs, and secure identifiers.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rahuldadhich15/id-toolkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rahuldadhich15/id-toolkit/issues"
+  },
+  "homepage": "https://github.com/rahuldadhich15/id-toolkit#readme",
+  "keywords": [
+    "uuid",
+    "uuid-v4",
+    "uuid-v7",
+    "uuid-generator",
+    "uuid-validator",
+    "short-id",
+    "secure-id",
+    "id-generator",
+    "identifier",
+    "random-id",
+    "crypto",
+    "typescript",
+    "javascript",
+    "utilities"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "npm run clean && tsup src/index.ts --format esm,cjs && tsc",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
+  }
+}