fix: improve error handling for deploy command

.changeset/thick-tools-jam.md

@@ -0,0 +1,5 @@
+---
+'@graphprotocol/graph-cli': patch
+---
+
+improve error handling for `graph deploy`

packages/cli/src/commands/deploy.ts

@@ -12,6 +12,7 @@
 import { chooseNodeUrl, getHostedServiceSubgraphId } from '../command-helpers/node';
 import { assertGraphTsVersion, assertManifestApiVersion } from '../command-helpers/version';
 import { GRAPH_CLI_SHARED_HEADERS } from '../constants';
+import debugFactory from '../debug';
 import Protocol from '../protocols';
 
 const headersFlag = Flags.custom<Record<string, string>>({
@@ -23,6 +24,8 @@
 
 const productOptions = ['subgraph-studio', 'hosted-service'];
 
+const deployDebugger = debugFactory('graph-cli:deploy');
+
 export default class DeployCommand extends Command {
   static description = 'Deploys a subgraph to a Graph node.';
 
@@ -205,17 +208,21 @@
           // @ts-expect-error TODO: why are the arguments not typed?
           res,
         ) => {
+          deployDebugger('requestError: %O', requestError);
+          deployDebugger('jsonRpcError: %O', jsonRpcError);
           if (jsonRpcError) {
-            let errorMessage = `Failed to deploy to Graph node ${requestUrl}: ${jsonRpcError.message}`;
+            const message = jsonRpcError?.message || jsonRpcError?.code?.toString();
+            deployDebugger('message: %O', message);
+            let errorMessage = `Failed to deploy to Graph node ${requestUrl}: ${message}`;
 
             // Provide helpful advice when the subgraph has not been created yet
-            if (jsonRpcError.message.match(/subgraph name not found/)) {
+            if (message?.match(/subgraph name not found/)) {
               errorMessage += `
         Make sure to create the subgraph first by running the following command:
         $ graph create --node ${node} ${subgraphName}`;
             }
 
-            if (jsonRpcError.message.match(/auth failure/)) {
+            if (message?.match(/auth failure/)) {
               errorMessage += '\nYou may need to authenticate first.';
             }
 
@@ -336,11 +343,15 @@
           // @ts-expect-error TODO: why are the arguments not typed?
           res,
         ) => {
+          deployDebugger('requestError: %O', requestError);
+          deployDebugger('jsonRpcError: %O', jsonRpcError);
           if (jsonRpcError) {
-            let errorMessage = `Failed to deploy to Graph node ${requestUrl}: ${jsonRpcError.message}`;
+            const message = jsonRpcError?.message || jsonRpcError?.code?.toString();
+            deployDebugger('message: %O', message);
+            let errorMessage = `Failed to deploy to Graph node ${requestUrl}: ${message}`;
 
             // Provide helpful advice when the subgraph has not been created yet
-            if (jsonRpcError.message.match(/subgraph name not found/)) {
+            if (message?.match(/subgraph name not found/)) {
               if (isHostedService) {
                 errorMessage +=
                   '\nYou may need to create it at https://thegraph.com/explorer/dashboard.';
@@ -350,7 +361,7 @@
       $ graph create --node ${node} ${subgraphName}`;
               }
             }
-            if (jsonRpcError.message.match(/auth failure/)) {
+            if (message?.match(/auth failure/)) {
               errorMessage += '\nYou may need to authenticate first.';
             }
             spinner.fail(errorMessage);
@@ -434,7 +445,7 @@
     }
 
     if (network) {
       const identifierName = protocol.getContract()!.identifierName();
       await updateSubgraphNetwork(manifest, network, networkFile, identifierName);
     }