@griffin-app/griffin-cli 1.0.26 → 1.0.28

package/dist/utils/sdk-error.js

@@ -1,106 +1,136 @@
 import { terminal } from "./terminal.js";
-/**
- * Handle SDK errors with user-friendly messaging
- */
-export function handleSDKError(error, context) {
-    const sdkError = error;
+function getSDKErrorCodeAndMessage(sdkError, context) {
     const contextMsg = context ? `${context}: ` : "";
-    terminal.blank();
-    // Handle network/connection errors
     if (sdkError.message?.includes("ECONNREFUSED")) {
-        terminal.error(`${contextMsg}Unable to connect to Griffin Hub`);
-        terminal.dim("Make sure the hub is running and the URL is correct.");
-        return terminal.exit(1);
+        return {
+            code: "CONNECTION_REFUSED",
+            message: `${contextMsg}Unable to connect to Griffin Hub`,
+            hint: "Make sure the hub is running and the URL is correct.",
+        };
     }
     if (sdkError.message?.includes("ENOTFOUND")) {
-        terminal.error(`${contextMsg}Hub host not found`);
-        terminal.dim("Check your hub URL configuration.");
-        return terminal.exit(1);
+        return {
+            code: "HOST_NOT_FOUND",
+            message: `${contextMsg}Hub host not found`,
+            hint: "Check your hub URL configuration.",
+        };
     }
     if (sdkError.message?.includes("ETIMEDOUT")) {
-        terminal.error(`${contextMsg}Connection to hub timed out`);
-        terminal.dim("The hub may be unresponsive or the network is slow.");
-        return terminal.exit(1);
+        return {
+            code: "TIMEOUT",
+            message: `${contextMsg}Connection to hub timed out`,
+            hint: "The hub may be unresponsive or the network is slow.",
+        };
     }
-    // Handle HTTP status codes
     if (sdkError.status) {
         switch (sdkError.status) {
             case 401:
-                terminal.error(`${contextMsg}Authentication failed`);
-                terminal.dim("Your API token may be invalid or expired.");
-                terminal.dim("Run 'griffin auth login' to authenticate again.");
-                return terminal.exit(1);
+                return {
+                    code: "AUTH_FAILED",
+                    message: `${contextMsg}Authentication failed`,
+                    hint: "Your API token may be invalid or expired. Run 'griffin auth login' to authenticate again.",
+                };
             case 403:
-                terminal.error(`${contextMsg}Access denied`);
-                terminal.dim("You don't have permission to perform this action.");
-                return terminal.exit(1);
+                return {
+                    code: "ACCESS_DENIED",
+                    message: `${contextMsg}Access denied`,
+                    hint: "You don't have permission to perform this action.",
+                };
             case 404:
-                terminal.error(`${contextMsg}Resource not found`);
-                if (sdkError.url) {
-                    terminal.dim(`URL: ${sdkError.url}`);
-                }
-                terminal.dim("The requested resource may not exist on the hub.");
-                return terminal.exit(1);
+                return {
+                    code: "NOT_FOUND",
+                    message: `${contextMsg}Resource not found`,
+                    details: sdkError.url ? { url: sdkError.url } : undefined,
+                    hint: "The requested resource may not exist on the hub.",
+                };
             case 409:
-                terminal.error(`${contextMsg}Conflict`);
-                if (sdkError.body?.message) {
-                    terminal.dim(sdkError.body.message);
-                }
-                else {
-                    terminal.dim("The operation conflicts with the current state.");
-                }
-                return terminal.exit(1);
+                return {
+                    code: "CONFLICT",
+                    message: `${contextMsg}Conflict`,
+                    details: sdkError.body?.message ? { message: sdkError.body.message } : undefined,
+                    hint: "The operation conflicts with the current state.",
+                };
             case 422:
-                terminal.error(`${contextMsg}Validation error`);
-                if (sdkError.body?.message) {
-                    terminal.dim(sdkError.body.message);
-                }
-                else if (sdkError.body?.errors) {
-                    terminal.dim("Validation failed:");
-                    for (const err of sdkError.body.errors) {
-                        terminal.dim(`  - ${err.message || err}`);
-                    }
-                }
-                else {
-                    terminal.dim("The request data is invalid.");
-                }
-                return terminal.exit(1);
+                return {
+                    code: "VALIDATION_ERROR",
+                    message: `${contextMsg}Validation error`,
+                    details: sdkError.body?.message
+                        ? { message: sdkError.body.message }
+                        : sdkError.body?.errors
+                            ? { errors: sdkError.body.errors }
+                            : undefined,
+                    hint: "The request data is invalid.",
+                };
             case 429:
-                terminal.error(`${contextMsg}Rate limit exceeded`);
-                terminal.dim("Too many requests. Please wait and try again.");
-                return terminal.exit(1);
+                return {
+                    code: "RATE_LIMITED",
+                    message: `${contextMsg}Rate limit exceeded`,
+                    hint: "Too many requests. Please wait and try again.",
+                };
             case 500:
             case 502:
             case 503:
             case 504:
-                terminal.error(`${contextMsg}Hub server error`);
-                terminal.dim(`Status: ${sdkError.status} ${sdkError.statusText || ""}`);
-                if (sdkError.body?.message) {
-                    terminal.dim(sdkError.body.message);
-                }
-                else {
-                    terminal.dim("The hub encountered an internal error.");
-                }
-                return terminal.exit(1);
+                return {
+                    code: "SERVER_ERROR",
+                    message: `${contextMsg}Hub server error`,
+                    details: {
+                        status: sdkError.status,
+                        statusText: sdkError.statusText,
+                        ...(sdkError.body?.message && { bodyMessage: sdkError.body.message }),
+                    },
+                    hint: "The hub encountered an internal error.",
+                };
             default:
-                terminal.error(`${contextMsg}Request failed`);
-                terminal.dim(`Status: ${sdkError.status} ${sdkError.statusText || ""}`);
-                if (sdkError.body?.message) {
-                    terminal.dim(sdkError.body.message);
-                }
-                else if (sdkError.message) {
-                    terminal.dim(sdkError.message);
-                }
-                return terminal.exit(1);
+                return {
+                    code: "UNKNOWN_ERROR",
+                    message: `${contextMsg}Request failed`,
+                    details: {
+                        status: sdkError.status,
+                        statusText: sdkError.statusText,
+                        ...(sdkError.body?.message && { bodyMessage: sdkError.body.message }),
+                        ...(sdkError.message && { message: sdkError.message }),
+                    },
+                };
         }
     }
-    // Fallback for unknown errors
-    terminal.error(`${contextMsg}${sdkError.message || "An unexpected error occurred"}`);
-    if (sdkError.stack) {
-        terminal.dim("Run with DEBUG=* for more details.");
+    return {
+        code: "UNKNOWN_ERROR",
+        message: `${contextMsg}${sdkError.message || "An unexpected error occurred"}`,
+        hint: sdkError.stack ? "Run with DEBUG=* for more details." : undefined,
+    };
+}
+/**
+ * Handle SDK errors with user-friendly messaging (terminal output)
+ */
+export function handleSDKError(error, context) {
+    const sdkError = error;
+    const { message, details, hint } = getSDKErrorCodeAndMessage(sdkError, context);
+    terminal.blank();
+    terminal.error(message);
+    if (hint)
+        terminal.dim(hint);
+    if (details !== undefined && details !== null) {
+        if (typeof details === "object" && "message" in details) {
+            terminal.dim(String(details.message));
+        }
+        else if (typeof details === "object" && "errors" in details) {
+            terminal.dim("Validation failed:");
+            for (const err of details.errors) {
+                terminal.dim(`  - ${err.message || err}`);
+            }
+        }
     }
     return terminal.exit(1);
 }
+/**
+ * Handle SDK errors using OutputContext (JSON or human output)
+ */
+export function handleSDKErrorWithOutput(error, output, context) {
+    const sdkError = error;
+    const { code, message, details, hint } = getSDKErrorCodeAndMessage(sdkError, context);
+    output.flushError(code, message, details, hint);
+}
 /**
  * Wrap an SDK call with error handling
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@griffin-app/griffin-cli",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "CLI tool for running and managing griffin API tests",
   "type": "module",
   "main": "dist/index.js",
@@ -26,7 +26,7 @@
   "dependencies": {
     "@griffin-app/griffin-hub-sdk": "1.0.25",
     "@griffin-app/griffin-executor": "0.1.1",
-    "@griffin-app/griffin-core": "0.2.0",
+    "@griffin-app/griffin-core": "0.2.2",
     "better-auth": "^1.4.17",
     "cli-table3": "^0.6.5",
     "commander": "^12.1.0",