Extract @Shopify/organizations package with org listing and selection utilities

Creates a standalone package for organization fetching and selection,
calling the Business Platform Destinations API directly. Includes
GraphQL codegen pipeline, fetchOrganizations (with GID decoding),
selectOrganizationPrompt (auto-select for single org, duplicate name
disambiguation), and selectOrg helper.

Wires packages/app to use @Shopify/organizations for org fetching
in AppManagementClient.organizations() and for the org selection
prompt, eliminating duplicated Destinations API and prompt logic.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: amcaplan

.changeset/config.json

@@ -7,6 +7,7 @@
     "@shopify/cli",
     "@shopify/app",
     "@shopify/store",
+    "@shopify/organizations",
     "@shopify/create-app",
     "@shopify/cli-kit",
     "@shopify/theme",

bin/get-graphql-schemas.js

@@ -48,7 +48,10 @@ const schemas = [
     owner: 'shop',
     repo: 'world',
     pathToFile: 'areas/platforms/organizations/db/graphql/destinations_schema.graphql',
-    localPaths: ['./packages/app/src/cli/api/graphql/business-platform-destinations/destinations_schema.graphql'],
+    localPaths: [
+      './packages/app/src/cli/api/graphql/business-platform-destinations/destinations_schema.graphql',
+      './packages/organizations/src/cli/api/graphql/business-platform-destinations/destinations_schema.graphql',
+    ],
   },
   {
     owner: 'shop',

configurations/vite.config.ts

@@ -82,5 +82,7 @@ export const aliases = (packagePath: string) => {
       },
     },
     {find: '@shopify/theme', replacement: path.join(packagePath, '../theme/src/index')},
+    {find: '@shopify/organizations', replacement: path.join(packagePath, '../organizations/src/index')},
+    {find: '@shopify/store', replacement: path.join(packagePath, '../store/src/index')},
   ]
 }

graphql.config.ts

@@ -85,5 +85,6 @@ export default {
     webhooks: projectFactory('webhooks', 'webhooks_schema.graphql'),
     functions: projectFactory('functions', 'functions_cli_schema.graphql', 'app'),
     adminAsApp: projectFactory('admin', 'admin_schema.graphql'),
+    organizationsDestinations: projectFactory('business-platform-destinations', 'destinations_schema.graphql', 'organizations'),
   },
 }

package.json

@@ -203,6 +203,23 @@
           ]
         }
       },
+      "packages/organizations": {
+        "entry": [
+          "**/index.ts!"
+        ],
+        "project": "**/*.ts!",
+        "ignore": [
+          "**/graphql/**/generated/*.ts"
+        ],
+        "ignoreDependencies": [
+          "@graphql-typed-document-node/core"
+        ],
+        "vite": {
+          "config": [
+            "vite.config.ts"
+          ]
+        }
+      },
       "packages/cli": {
         "entry": [
           "**/{commands,hooks}/**/*.ts!",

packages/app/package.json

@@ -51,6 +51,7 @@
     "@luckycatfactory/esbuild-graphql-loader": "3.8.1",
     "@oclif/core": "4.5.3",
     "@shopify/cli-kit": "3.93.0",
+    "@shopify/organizations": "3.93.0",
     "@shopify/plugin-cloudflare": "3.93.0",
     "@shopify/polaris": "12.27.0",
     "@shopify/polaris-icons": "8.11.1",

packages/app/src/cli/models/organization.ts

@@ -1,14 +1,13 @@
 import {AppConfigurationUsedByCli} from './extensions/specifications/types/app_config.js'
 import {Flag, DeveloperPlatformClient} from '../utilities/developer-platform-client.js'
+import {Organization as BaseOrganization} from '@shopify/organizations'
 
 export enum OrganizationSource {
   Partners = 'Partners',
   BusinessPlatform = 'BusinessPlatform',
 }
 
-export interface Organization {
-  id: string
-  businessName: string
+export interface Organization extends BaseOrganization {
   source: OrganizationSource
 }
 

packages/app/src/cli/prompts/dev.test.ts

@@ -3,7 +3,6 @@ import {
   createAsNewAppPrompt,
   reloadStoreListPrompt,
   selectAppPrompt,
-  selectOrganizationPrompt,
   selectStorePrompt,
   updateURLsPrompt,
 } from './dev.js'
@@ -68,85 +67,6 @@ beforeEach(() => {
   vi.mocked(getTomls).mockResolvedValue({})
 })
 
-describe('selectOrganization', () => {
-  test('request org selection if passing more than 1 org', async () => {
-    // Given
-    vi.mocked(renderAutocompletePrompt).mockResolvedValue('1')
-
-    // When
-    const got = await selectOrganizationPrompt([ORG1, ORG2])
-
-    // Then
-    expect(got).toEqual(ORG1)
-    expect(renderAutocompletePrompt).toHaveBeenCalledWith({
-      message: 'Which organization is this work for?',
-      choices: [
-        {label: 'org1', value: '1'},
-        {label: 'org2', value: '2'},
-      ],
-    })
-  })
-
-  test('returns directly if passing only 1 org', async () => {
-    // Given
-    const orgs = [ORG2]
-
-    // When
-    const got = await selectOrganizationPrompt(orgs)
-
-    // Then
-    expect(got).toEqual(ORG2)
-    expect(renderAutocompletePrompt).not.toBeCalled()
-  })
-
-  // Intentional: when ANY duplicates exist, ALL orgs get ID suffix for consistent formatting
-  test('appends ID to label when duplicate names exist', async () => {
-    // Given
-    const orgsWithDuplicates = [
-      {id: '1', businessName: 'My Org', source: OrganizationSource.BusinessPlatform},
-      {id: '2', businessName: 'My Org', source: OrganizationSource.BusinessPlatform},
-      {id: '3', businessName: 'Other Org', source: OrganizationSource.BusinessPlatform},
-    ]
-    vi.mocked(renderAutocompletePrompt).mockResolvedValue('1')
-
-    // When
-    await selectOrganizationPrompt(orgsWithDuplicates)
-
-    // Then - note: Other Org also gets ID suffix for consistency
-    expect(renderAutocompletePrompt).toHaveBeenCalledWith({
-      message: 'Which organization is this work for?',
-      choices: [
-        {label: 'My Org (1)', value: '1'},
-        {label: 'My Org (2)', value: '2'},
-        {label: 'Other Org (3)', value: '3'},
-      ],
-    })
-  })
-
-  test('appends ID to all labels when all names are identical', async () => {
-    // Given
-    const orgsAllSameName = [
-      {id: '1', businessName: 'Same Org', source: OrganizationSource.BusinessPlatform},
-      {id: '2', businessName: 'Same Org', source: OrganizationSource.BusinessPlatform},
-      {id: '3', businessName: 'Same Org', source: OrganizationSource.BusinessPlatform},
-    ]
-    vi.mocked(renderAutocompletePrompt).mockResolvedValue('2')
-
-    // When
-    await selectOrganizationPrompt(orgsAllSameName)
-
-    // Then
-    expect(renderAutocompletePrompt).toHaveBeenCalledWith({
-      message: 'Which organization is this work for?',
-      choices: [
-        {label: 'Same Org (1)', value: '1'},
-        {label: 'Same Org (2)', value: '2'},
-        {label: 'Same Org (3)', value: '3'},
-      ],
-    })
-  })
-})
-
 describe('selectApp', () => {
   test('returns app if user selects one', async () => {
     // Given

packages/app/src/cli/prompts/dev.ts

@@ -12,25 +12,6 @@ import {
 } from '@shopify/cli-kit/node/ui'
 import {outputCompleted} from '@shopify/cli-kit/node/output'
 
-export async function selectOrganizationPrompt(organizations: Organization[]): Promise<Organization> {
-  if (organizations.length === 1) {
-    return organizations[0]!
-  }
-
-  // Add ID suffix to disambiguate when duplicate names exist
-  const uniqueNames = new Set(organizations.map((org) => org.businessName))
-  const hasDuplicates = uniqueNames.size < organizations.length
-  const orgList = organizations.map((org) => ({
-    label: hasDuplicates ? `${org.businessName} (${org.id})` : org.businessName,
-    value: org.id,
-  }))
-  const id = await renderAutocompletePrompt({
-    message: `Which organization is this work for?`,
-    choices: orgList,
-  })
-  return organizations.find((org) => org.id === id)!
-}
-
 export async function selectAppPrompt(
   onSearchForAppsByName: (term: string) => Promise<{apps: MinimalOrganizationApp[]; hasMorePages: boolean}>,
   apps: MinimalOrganizationApp[],

packages/app/src/cli/services/app/config/link-service.test.ts

@@ -2,14 +2,16 @@ import link from './link.js'
 import {testOrganizationApp, testDeveloperPlatformClient} from '../../../models/app/app.test-data.js'
 import {DeveloperPlatformClient, selectDeveloperPlatformClient} from '../../../utilities/developer-platform-client.js'
 import {OrganizationApp, OrganizationSource} from '../../../models/organization.js'
-import {appNamePrompt, createAsNewAppPrompt, selectOrganizationPrompt} from '../../../prompts/dev.js'
+import {appNamePrompt, createAsNewAppPrompt} from '../../../prompts/dev.js'
 import {selectConfigName} from '../../../prompts/config.js'
+import {selectOrganizationPrompt} from '@shopify/organizations'
 import {beforeEach, describe, expect, test, vi} from 'vitest'
 import {inTemporaryDirectory, readFile, writeFileSync} from '@shopify/cli-kit/node/fs'
 import {joinPath} from '@shopify/cli-kit/node/path'
 
 vi.mock('./use.js')
 vi.mock('../../../prompts/dev.js')
+vi.mock('@shopify/organizations')
 vi.mock('../../../prompts/config.js')
 vi.mock('../../local-storage')
 vi.mock('@shopify/cli-kit/node/ui')
@@ -84,7 +86,6 @@ api_version = "2024-01"
       vi.mocked(selectOrganizationPrompt).mockResolvedValue({
         id: '12345',
         businessName: 'test',
-        source: OrganizationSource.BusinessPlatform,
       })
       vi.mocked(selectConfigName).mockResolvedValue('shopify.app.toml')
 
@@ -178,7 +179,6 @@ api_version = "2025-07"
       vi.mocked(selectOrganizationPrompt).mockResolvedValue({
         id: '12345',
         businessName: 'test',
-        source: OrganizationSource.BusinessPlatform,
       })
 
       const options = {
@@ -227,7 +227,6 @@ required = true
       vi.mocked(selectOrganizationPrompt).mockResolvedValue({
         id: '12345',
         businessName: 'test',
-        source: OrganizationSource.BusinessPlatform,
       })
 
       const options = {