closes: Shopify/develop-app-inner-loop#2460

- Updates the CLI banner message to include better next steps when an app could not be found

Co-authored-by: Kenneth Ye <kenneth.ye@shopify.com>

packages/app/src/cli/services/context.test.ts

@@ -2,7 +2,7 @@ import {fetchOrganizations, fetchOrgFromId} from './dev/fetch.js'
 import {selectOrCreateApp} from './dev/select-app.js'
 import {selectStore} from './dev/select-store.js'
 import {ensureDeploymentIdsPresence} from './context/identifiers.js'
-import {ensureDeployContext, ensureThemeExtensionDevContext} from './context.js'
+import {appFromIdentifiers, ensureDeployContext, ensureThemeExtensionDevContext} from './context.js'
 import {createExtension} from './dev/create-extension.js'
 import {CachedAppInfo} from './local-storage.js'
 import link from './app/config/link.js'
@@ -38,6 +38,8 @@ import {afterEach, beforeAll, beforeEach, describe, expect, test, vi} from 'vite
 import {mockAndCaptureOutput} from '@shopify/cli-kit/node/testing/output'
 import {getPackageManager} from '@shopify/cli-kit/node/node-package-manager'
 import {renderConfirmationPrompt, renderInfo, renderTasks, renderWarning, Task} from '@shopify/cli-kit/node/ui'
+import {AbortError} from '@shopify/cli-kit/node/error'
+import {isServiceAccount, isUserAccount} from './context/partner-account-info.js'
 
 const APP1: OrganizationApp = testOrganizationApp({
   id: '1',
@@ -221,11 +223,11 @@ describe('ensureDeployContext', () => {
           },
         },
         '\n',
-        'You can pass ',
+        'You can pass',
         {
           command: '--reset',
         },
-        ' to your command to reset your app configuration.',
+        'to your command to reset your app configuration.',
       ],
       headline: 'Using shopify.app.toml for default values:',
     })
@@ -270,11 +272,11 @@ describe('ensureDeployContext', () => {
           },
         },
         '\n',
-        'You can pass ',
+        'You can pass',
         {
           command: '--reset',
         },
-        ' to your command to reset your app configuration.',
+        'to your command to reset your app configuration.',
       ],
       headline: 'Using shopify.app.toml for default values:',
     })
@@ -320,11 +322,11 @@ describe('ensureDeployContext', () => {
           },
         },
         '\n',
-        'You can pass ',
+        'You can pass',
         {
           command: '--reset',
         },
-        ' to your command to reset your app configuration.',
+        'to your command to reset your app configuration.',
       ],
       headline: 'Using shopify.app.toml for default values:',
     })
@@ -370,11 +372,11 @@ describe('ensureDeployContext', () => {
           },
         },
         '\n',
-        'You can pass ',
+        'You can pass',
         {
           command: '--reset',
         },
-        ' to your command to reset your app configuration.',
+        'to your command to reset your app configuration.',
       ],
       headline: 'Using shopify.app.toml for default values:',
     })
@@ -426,11 +428,11 @@ describe('ensureDeployContext', () => {
           },
         },
         '\n',
-        'You can pass ',
+        'You can pass',
         {
           command: '--reset',
         },
-        ' to your command to reset your app configuration.',
+        'to your command to reset your app configuration.',
       ],
       headline: 'Using shopify.app.toml for default values:',
     })
@@ -470,11 +472,11 @@ describe('ensureDeployContext', () => {
           },
         },
         '\n',
-        'You can pass ',
+        'You can pass',
         {
           command: '--reset',
         },
-        ' to your command to reset your app configuration.',
+        'to your command to reset your app configuration.',
       ],
       headline: 'Using shopify.app.toml for default values:',
     })
@@ -511,11 +513,11 @@ describe('ensureDeployContext', () => {
           },
         },
         '\n',
-        'You can pass ',
+        'You can pass',
         {
           command: '--reset',
         },
-        ' to your command to reset your app configuration.',
+        'to your command to reset your app configuration.',
       ],
       headline: 'Using shopify.app.toml for default values:',
     })
@@ -689,11 +691,72 @@ describe('ensureThemeExtensionDevContext', () => {
   })
 })
 
-async function mockApp(directory: string, app?: Partial<AppInterface>) {
-  const versionSchema = await buildVersionedAppSchema()
-  const localApp = testApp(app)
-  localApp.configSchema = versionSchema.schema
-  localApp.specifications = versionSchema.configSpecifications
-  localApp.directory = directory
-  return localApp
-}
+describe('appFromIdentifiers', () => {
+  test('renders the org name when an app cannot be found and the account is a service account ', async () => {
+    vi.mocked(isServiceAccount).mockReturnValue(true)
+
+    await expect(
+      appFromIdentifiers({
+        apiKey: 'apiKey-12345',
+        developerPlatformClient: testDeveloperPlatformClient({
+          appFromIdentifiers: () => Promise.resolve(undefined),
+          accountInfo: () =>
+            Promise.resolve({
+              type: 'ServiceAccount',
+              orgName: 'My Test Org',
+            }),
+        }),
+        organizationId: 'orgId',
+      }),
+    ).rejects.toThrowError(
+      expect.objectContaining({
+        message: 'No app with client ID apiKey-12345 found',
+        tryMessage: renderTryMessage(true, 'My Test Org'),
+      }),
+    )
+  })
+
+  test('renders the user email when an app cannot be found and the account is a user account ', async () => {
+    vi.mocked(isUserAccount).mockReturnValue(true)
+
+    await expect(
+      appFromIdentifiers({
+        apiKey: 'apiKey-12345',
+        developerPlatformClient: testDeveloperPlatformClient({
+          appFromIdentifiers: () => Promise.resolve(undefined),
+          accountInfo: () =>
+            Promise.resolve({
+              type: 'UserAccount',
+              email: 'user@example.com',
+            }),
+        }),
+        organizationId: 'orgId',
+      }),
+    ).rejects.toThrowError(
+      expect.objectContaining({
+        message: 'No app with client ID apiKey-12345 found',
+        tryMessage: renderTryMessage(false, 'user@example.com'),
+      }),
+    )
+  })
+})
+
+const renderTryMessage = (isOrg: boolean, identifier: string) => [
+  {
+    list: {
+      title: 'Next steps:',
+      items: [
+        'Check that your account has permission to develop apps for this organization or contact the owner of the organization to grant you permission',
+        [
+          'Run',
+          {command: 'shopify auth logout'},
+          'to log into a different',
+          isOrg ? 'organization' : 'account',
+          'than',
+          {bold: identifier},
+        ],
+        ['Pass', {command: '--reset'}, 'to your command to create a new app'],
+      ],
+    },
+  },
+]

packages/app/src/cli/services/context.ts

@@ -30,6 +30,8 @@ import {Token, TokenItem, renderConfirmationPrompt, renderInfo, renderWarning} f
 import {AbortError} from '@shopify/cli-kit/node/error'
 import {outputContent} from '@shopify/cli-kit/node/output'
 import {basename, sniffForJson} from '@shopify/cli-kit/node/path'
+import {getCurrentAccountInfo} from '../api/graphql/current_account_info.js'
+import {isServiceAccount, isUserAccount} from './context/partner-account-info.js'
 
 export const InvalidApiKeyErrorMessage = (apiKey: string) => {
   return {
@@ -38,10 +40,30 @@ export const InvalidApiKeyErrorMessage = (apiKey: string) => {
   }
 }
 
-export const resetHelpMessage: Token[] = [
-  'You can pass ',
+export const resetHelpMessage = [
+  'You can pass',
   {command: '--reset'},
-  ' to your command to reset your app configuration.',
+  'to your command to reset your app configuration.',
+]
+
+const appNotFoundHelpMessage = (accountIdentifier: string, isOrg: boolean = false) => [
+  {
+    list: {
+      title: 'Next steps:',
+      items: [
+        'Check that your account has permission to develop apps for this organization or contact the owner of the organization to grant you permission',
+        [
+          'Run',
+          {command: 'shopify auth logout'},
+          'to log into a different',
+          isOrg ? 'organization' : 'account',
+          'than',
+          {bold: accountIdentifier},
+        ],
+        ['Pass', {command: '--reset'}, 'to your command to create a new app'],
+      ],
+    },
+  },
 ]
 
 interface AppFromIdOptions {
@@ -65,7 +87,23 @@ export const appFromIdentifiers = async (options: AppFromIdOptions): Promise<Org
     apiKey: options.apiKey,
     organizationId,
   })
-  if (!app) throw new AbortError([`Couldn't find the app with Client ID`, {command: options.apiKey}], resetHelpMessage)
+  if (!app) {
+    const accountInfo = await developerPlatformClient.accountInfo()
+    let identifier = 'Unknown account'
+    let isOrg = false
+
+    if (isServiceAccount(accountInfo)) {
+      identifier = accountInfo.orgName
+      isOrg = true
+    } else if (isUserAccount(accountInfo)) {
+      identifier = accountInfo.email
+    }
+
+    throw new AbortError(
+      [`No app with client ID`, {command: options.apiKey}, 'found'],
+      appNotFoundHelpMessage(identifier, isOrg),
+    )
+  }
   return app
 }
 

packages/app/src/cli/services/logs.test.ts

@@ -237,11 +237,11 @@ describe('logs', () => {
           },
         },
         '\n',
-        'You can pass ',
+        'You can pass',
         {
           command: '--reset',
         },
-        ' to your command to reset your app configuration.',
+        'to your command to reset your app configuration.',
       ],
       headline: 'Using shopify.app.toml for default values:',
     })