idmint 1.0.5 → 1.1.0

package/README.md

@@ -91,6 +91,11 @@ idmint.medium();   // 21 characters (default, recommended)
 idmint.long();     // 32 characters
 ```
 
+## Error handling
+
+All public APIs validate input and throw descriptive errors.
+This is intentional to avoid silent failures in production.
+
 ## 🔒 How uniqueness is ensured
 
 idmint does not store IDs in any database.

package/dist/index.js

@@ -8,17 +8,29 @@ const ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz
  */
 function getRandomBytes(size) {
     if (!globalThis.crypto || !globalThis.crypto.getRandomValues) {
-        throw new Error("Secure crypto API not available. This environment is not supported.");
+        throw new Error("[idmint] Secure crypto API not available in this environment");
     }
     return globalThis.crypto.getRandomValues(new Uint8Array(size));
 }
+/**
+ * Validate ID size
+ */
+function validateSize(size) {
+    if (typeof size !== "number") {
+        throw new TypeError(`[idmint] size must be a number, received ${typeof size}`);
+    }
+    if (!Number.isInteger(size)) {
+        throw new RangeError("[idmint] size must be an integer");
+    }
+    if (size < 4 || size > 64) {
+        throw new RangeError("[idmint] size must be between 4 and 64");
+    }
+}
 /**
  * Generate a secure unique ID
  */
 export function generateId(size = 21) {
-    if (!Number.isInteger(size) || size < 4 || size > 64) {
-        throw new Error("size must be an integer between 4 and 64");
-    }
+    validateSize(size);
     const bytes = getRandomBytes(size);
     let id = "";
     for (let i = 0; i < size; i++) {
@@ -30,8 +42,8 @@ export function generateId(size = 21) {
  * Generate ID with prefix
  */
 export function generateIdWithPrefix(prefix, size = 21) {
-    if (!prefix) {
-        throw new Error("prefix is required");
+    if (typeof prefix !== "string" || prefix.trim() === "") {
+        throw new TypeError("[idmint] prefix must be a non-empty string");
     }
     return `${prefix}_${generateId(size)}`;
 }
@@ -39,9 +51,10 @@ export function generateIdWithPrefix(prefix, size = 21) {
  * Time-based sortable ID
  */
 export function timeBasedId(size = 21) {
+    validateSize(size);
     const time = Date.now().toString(36);
     if (size <= time.length) {
-        throw new Error("size too small for time-based ID");
+        throw new RangeError(`[idmint] size must be greater than ${time.length} for timeBasedId`);
     }
     const randomPart = generateId(size - time.length);
     return time + randomPart;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "idmint",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Enterprise-grade, collision-resistant unique ID generator",
   "type": "module",
   "main": "./dist/index.js",