safe-try-with-ai 1.0.0 → 1.1.0

package/README.md

@@ -1,8 +1,49 @@
-# safe-try
+# safe-try-with-ai
 
-A lightweight JavaScript utility for clean error handling without repetitive try/catch blocks.
+A lightweight JavaScript utility for **clean error handling** with optional **AI-style runtime suggestions**, without repetitive try/catch blocks.
+
+---
 
 ## Installation
+
 ```bash
-npm install safe-try
+npm install safe-try-with-ai
+
+
+## Usage
+
+### Synchronous example
+
+```js
+const { safeTry } = require("safe-try-with-ai");
+
+const [err, result] = safeTry(() => JSON.parse('{"x":1}'));
+
+if (err) {
+  console.error(err); // Original error
+} else {
+  console.log(result); // { x: 1 }
+}
+
+## Optional AI Runtime Suggestions
+
+Enable AI-style runtime suggestions by passing `{ analyze: true }` as the second argument.
+
+### Synchronous example
+
+```js
+const [err, result] = safeTry(() => JSON.parse("invalid"), { analyze: true });
+
+if (err) {
+  console.error("Error:", err.message);       // Original error
+  console.log("Suggestion:", err.suggestion); // AI suggestion
+  console.log("Fix:", err.fix);               // Suggested fix
+}
+
+## Features
 
+- Works with synchronous and asynchronous functions  
+- Eliminates repetitive try/catch blocks  
+- Optional AI-style runtime error suggestions  
+- Zero dependencies  
+- Lightweight and fast

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "safe-try-with-ai",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Clean error handling for JavaScript",
   "keywords": [
     "error-handling",

package/src/index.js

@@ -1,3 +1,64 @@
+// src/index.js
+
+/**
+ * Rule-based AI-style error analyzer
+ * Returns enriched error object with suggestion and optional fix
+ */
+function analyzeError(error) {
+  // Handle undefined variable
+  if (/undefined/.test(error.message)) {
+    return {
+      name: error.name,
+      message: error.message,
+      suggestion: "Check if the variable exists before accessing it",
+      fix: "Use optional chaining (?.) or input validation"
+    };
+  }
+
+  // Handle property access errors
+  if (/Cannot read property/.test(error.message)) {
+    return {
+      name: error.name,
+      message: error.message,
+      suggestion: "Verify the object exists before accessing its property",
+      fix: "Use optional chaining (?.) or null checks"
+    };
+  }
+
+  // Handle JSON parsing errors
+  if (/JSON/.test(error.message)) {
+    return {
+      name: error.name,
+      message: error.message,
+      suggestion: "Check your JSON syntax",
+      fix: "Use JSON validators or wrap JSON.parse in safeTry"
+    };
+  }
+
+  // Handle fetch/network errors
+  if (/fetch/.test(error.message)) {
+    return {
+      name: error.name,
+      message: error.message,
+      suggestion: "Check network connection and URL validity",
+      fix: "Ensure network is online and URL is correct"
+    };
+  }
+
+  // Default fallback
+  return {
+    name: error.name,
+    message: error.message,
+    suggestion: "Check stack trace and input values",
+  };
+}
+
+/**
+ * Safe synchronous try wrapper
+ * @param {Function} fn - Function to execute
+ * @param {Object} options - { analyze: boolean } optional runtime suggestions
+ * @returns {[Error|null, any]} tuple of error and result
+ */
 function safeTry(fn, options = {}) {
   try {
     const result = fn();
@@ -10,6 +71,12 @@ function safeTry(fn, options = {}) {
   }
 }
 
+/**
+ * Safe asynchronous try wrapper
+ * @param {Function} fn - Async function to execute
+ * @param {Object} options - { analyze: boolean } optional runtime suggestions
+ * @returns {Promise<[Error|null, any]>} tuple of error and result
+ */
 async function safeTryAsync(fn, options = {}) {
   try {
     const result = await fn();
@@ -22,21 +89,4 @@ async function safeTryAsync(fn, options = {}) {
   }
 }
 
-function analyzeError(error) {
-  if (/undefined/.test(error.message)) {
-    return {
-      name: error.name,
-      message: error.message,
-      suggestion: "Check if the variable exists before access",
-      fix: "Use optional chaining or input validation"
-    };
-  }
-
-  return {
-    name: error.name,
-    message: error.message,
-    suggestion: "Check stack trace and input values"
-  };
-}
-
 module.exports = { safeTry, safeTryAsync };