faf-cli 2.1.7 → 2.2.0

package/dist/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAgClE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAC1E,EAAE,EAAE,CAAC,EACL,OAAO,CAAC,EAAE,YAAY,GACrB,CAAC,CAWH;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACrE,EAAE,EAAE,CAAC,EACL,OAAO,CAAC,EAAE,YAAY,GACrB,CAAC,CAWH;AAsED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAM3E"}

package/dist/utils/error-handler.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Error handling wrapper for consistent error management
+ * Provides clean error messages and telemetry
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleError = handleError;
+exports.withErrorHandling = withErrorHandling;
+exports.withSyncErrorHandling = withSyncErrorHandling;
+exports.createUserError = createUserError;
+const championship_style_1 = require("./championship-style");
+const colors_1 = require("../fix-once/colors");
+/**
+ * Standardized error handler
+ */
+function handleError(err, context) {
+    // In quiet mode, only show critical errors
+    if (championship_style_1.OUTPUT_CONFIG.quiet && !isCriticalError(err)) {
+        process.exit(1);
+    }
+    // Format error message based on environment
+    const errorMessage = formatErrorMessage(err, context);
+    if (!championship_style_1.OUTPUT_CONFIG.quiet) {
+        (0, championship_style_1.error)(colors_1.colors.error('─'.repeat(50)));
+        (0, championship_style_1.error)(colors_1.colors.error('❌ ERROR'));
+        (0, championship_style_1.error)(colors_1.colors.error('─'.repeat(50)));
+    }
+    (0, championship_style_1.error)(errorMessage);
+    if (championship_style_1.OUTPUT_CONFIG.verbose && err.stack) {
+        (0, championship_style_1.error)(colors_1.colors.secondary('\nStack trace:'));
+        (0, championship_style_1.error)(colors_1.colors.secondary(err.stack));
+    }
+    // Log context if available
+    if (context && !championship_style_1.OUTPUT_CONFIG.quiet) {
+        if (context.command)
+            (0, championship_style_1.error)(`Command: ${context.command}`);
+        if (context.file)
+            (0, championship_style_1.error)(`File: ${context.file}`);
+        if (context.operation)
+            (0, championship_style_1.error)(`Operation: ${context.operation}`);
+    }
+    // Exit with appropriate code
+    const exitCode = getExitCode(err);
+    process.exit(exitCode);
+}
+/**
+ * Wrapper for async functions with error handling
+ */
+function withErrorHandling(fn, context) {
+    return (async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (err) {
+            handleError(err, {
+                ...context,
+                details: { args }
+            });
+        }
+    });
+}
+/**
+ * Wrapper for sync functions with error handling
+ */
+function withSyncErrorHandling(fn, context) {
+    return ((...args) => {
+        try {
+            return fn(...args);
+        }
+        catch (err) {
+            handleError(err, {
+                ...context,
+                details: { args }
+            });
+        }
+    });
+}
+/**
+ * Format error message based on error type
+ */
+function formatErrorMessage(err, context) {
+    // File not found
+    if (err.code === 'ENOENT') {
+        const file = err.path || context?.file || 'unknown file';
+        return `File not found: ${file}`;
+    }
+    // Permission denied
+    if (err.code === 'EACCES' || err.code === 'EPERM') {
+        const file = err.path || context?.file || 'unknown file';
+        return `Permission denied: ${file}`;
+    }
+    // Network errors
+    if (err.code === 'ECONNREFUSED' || err.code === 'ETIMEDOUT') {
+        return `Network error: ${err.message}`;
+    }
+    // JSON parse errors
+    if (err instanceof SyntaxError && err.message.includes('JSON')) {
+        return `Invalid JSON: ${err.message}`;
+    }
+    // FAF-specific errors
+    if (err.message?.includes('FAF')) {
+        return err.message;
+    }
+    // Default
+    return err.message || 'An unexpected error occurred';
+}
+/**
+ * Determine if error is critical (should show even in quiet mode)
+ */
+function isCriticalError(err) {
+    // Permission errors are critical
+    if (err.code === 'EACCES' || err.code === 'EPERM')
+        return true;
+    // Out of memory/space
+    if (err.code === 'ENOMEM' || err.code === 'ENOSPC')
+        return true;
+    // FAF corruption
+    if (err.message?.includes('corrupt') || err.message?.includes('invalid format'))
+        return true;
+    return false;
+}
+/**
+ * Get appropriate exit code for error type
+ */
+function getExitCode(err) {
+    // Standard POSIX codes
+    if (err.code === 'ENOENT')
+        return 2; // File not found
+    if (err.code === 'EACCES' || err.code === 'EPERM')
+        return 126; // Permission denied
+    if (err.code === 'EINVAL')
+        return 22; // Invalid argument
+    // FAF-specific codes
+    if (err.message?.includes('score'))
+        return 10; // Scoring error
+    if (err.message?.includes('sync'))
+        return 11; // Sync error
+    if (err.message?.includes('trust'))
+        return 12; // Trust error
+    return 1; // General error
+}
+/**
+ * Create a user-friendly error for common issues
+ */
+function createUserError(message, suggestion) {
+    const err = new Error(message);
+    if (suggestion) {
+        err.message += `\n\n💡 Suggestion: ${suggestion}`;
+    }
+    return err;
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-cli",
-  "version": "2.1.7",
+  "version": "2.2.0",
   "description": "🏎️🏁 STOP faffing About! - AI-context ⚡️ FAST AF | Universal, shareable AI-context for any AI, human or team",
   "icon": "https://faf.one/orange-smiley.svg",
   "logo": "https://faf.one/orange-smiley.svg",