add support for integer IDs in bulk status

Author: nickwesselman

packages/app/src/cli/commands/app/bulk/status.ts

@@ -1,7 +1,11 @@
 import {appFlags} from '../../../flags.js'
 import AppLinkedCommand, {AppLinkedCommandOutput} from '../../../utilities/app-linked-command.js'
 import {prepareAppStoreContext} from '../../../utilities/execute-command-helpers.js'
-import {getBulkOperationStatus, listBulkOperations} from '../../../services/bulk-operations/bulk-operation-status.js'
+import {
+  getBulkOperationStatus,
+  listBulkOperations,
+  normalizeBulkOperationId,
+} from '../../../services/bulk-operations/bulk-operation-status.js'
 import {Flags} from '@oclif/core'
 import {globalFlags} from '@shopify/cli-kit/node/cli'
 import {normalizeStoreFqdn} from '@shopify/cli-kit/node/context/fqdn'
@@ -18,7 +22,8 @@ export default class BulkStatus extends AppLinkedCommand {
     ...globalFlags,
     ...appFlags,
     id: Flags.string({
-      description: 'The bulk operation ID. If not provided, lists all bulk operations in the last 7 days.',
+      description:
+        'The bulk operation ID (numeric ID or full GID). If not provided, lists all bulk operations in the last 7 days.',
       env: 'SHOPIFY_FLAG_ID',
     }),
     store: Flags.string({
@@ -38,7 +43,7 @@ export default class BulkStatus extends AppLinkedCommand {
       await getBulkOperationStatus({
         organization: appContextResult.organization,
         storeFqdn: store.shopDomain,
-        operationId: flags.id,
+        operationId: normalizeBulkOperationId(flags.id),
         remoteApp: appContextResult.remoteApp,
       })
     } else {

packages/app/src/cli/services/bulk-operations/bulk-operation-status.test.ts

@@ -1,4 +1,4 @@
-import {getBulkOperationStatus, listBulkOperations} from './bulk-operation-status.js'
+import {getBulkOperationStatus, listBulkOperations, normalizeBulkOperationId} from './bulk-operation-status.js'
 import {GetBulkOperationByIdQuery} from '../../api/graphql/bulk-operations/generated/get-bulk-operation-by-id.js'
 import {OrganizationApp, Organization, OrganizationSource} from '../../models/organization.js'
 import {ListBulkOperationsQuery} from '../../api/graphql/bulk-operations/generated/list-bulk-operations.js'
@@ -36,6 +36,23 @@ afterEach(() => {
   mockAndCaptureOutput().clear()
 })
 
+describe('normalizeBulkOperationId', () => {
+  test('returns GID as-is when already in GID format', () => {
+    const gid = 'gid://shopify/BulkOperation/123'
+    expect(normalizeBulkOperationId(gid)).toBe(gid)
+  })
+
+  test('converts numeric ID to GID format', () => {
+    expect(normalizeBulkOperationId('123')).toBe('gid://shopify/BulkOperation/123')
+    expect(normalizeBulkOperationId('456789')).toBe('gid://shopify/BulkOperation/456789')
+  })
+
+  test('returns non-numeric, non-GID string as-is', () => {
+    const invalidId = 'invalid-id'
+    expect(normalizeBulkOperationId(invalidId)).toBe(invalidId)
+  })
+})
+
 describe('getBulkOperationStatus', () => {
   function mockBulkOperation(
     overrides?: Partial<NonNullable<GetBulkOperationByIdQuery['bulkOperation']>>,

packages/app/src/cli/services/bulk-operations/bulk-operation-status.ts

@@ -21,6 +21,21 @@ import colors from '@shopify/cli-kit/node/colors'
 
 const API_VERSION = '2026-01'
 
+export function normalizeBulkOperationId(id: string): string {
+  // If already a GID, return as-is
+  if (id.startsWith('gid://')) {
+    return id
+  }
+
+  // If numeric, convert to GID
+  if (/^\d+$/.test(id)) {
+    return `gid://shopify/BulkOperation/${id}`
+  }
+
+  // Otherwise return as-is (let API handle any errors)
+  return id
+}
+
 interface GetBulkOperationStatusOptions {
   organization: Organization
   storeFqdn: string