@shopify/cli-kit 4.8.4 → 4.9.0

package/dist/public/node/api/admin.js

@@ -2,7 +2,7 @@ import { graphqlRequest, graphqlRequestDoc, } from './graphql.js';
 import { outputContent, outputToken } from '../output.js';
 import { AbortError, BugError } from '../error.js';
 import { restRequestBody, restRequestHeaders, restRequestUrl, isThemeAccessSession, } from '../../../private/node/api/rest.js';
-import { isNetworkError } from '../../../private/node/api.js';
+import { isAbortedFetchError, isNetworkError } from '../../../private/node/api.js';
 import { shopifyFetch } from '../http.js';
 import { PublicApiVersions } from '../../../cli/api/graphql/admin/generated/public_api_versions.js';
 import { themeKitAccessDomain } from '../../../private/node/constants.js';
@@ -126,6 +126,23 @@ export async function fetchApiVersions(session, preferredBehaviour) {
         if (error instanceof ClientError && (error.response.status === 401 || error.response.status === 404)) {
             throw new AbortError(`Error connecting to your store ${session.storeFqdn}: ${error.message} ${error.response.status} ${error.response.data}`);
         }
+        // HTTP 402 means the shop is frozen, paused, or closed. That is a store state the user can
+        // fix, not a CLI bug, so it must not reach the BugError below.
+        if (error instanceof ClientError && error.response.status === 402) {
+            throw new AbortError(`The store ${session.storeFqdn} is currently unavailable.`, 'This usually means the store is frozen, paused, or closed. Check the store in the Shopify admin and try again once it is reactivated.');
+        }
+        // HTTP 5xx is a Shopify-side failure. This query takes no user input, so the user's command
+        // cannot have caused it. `isExpectedApiError` covers 502/503/504, but only for raw errors, so
+        // it never sees one we have already wrapped in a BugError.
+        if (error instanceof ClientError && error.response.status >= 500) {
+            throw new AbortError(`The Admin API for ${session.storeFqdn} returned a server error (HTTP ${error.response.status}).`, 'This is a problem on the Shopify side, not with your command. Wait a moment and try again.');
+        }
+        // A cancelled request is neither a store-state failure nor a CLI bug. Checked before
+        // `isNetworkError` so the message says the request was aborted instead of blaming the
+        // user's connection.
+        if (isAbortedFetchError(error)) {
+            throw new AbortError(`Request to ${session.storeFqdn} was aborted before it completed.`, 'The request was cancelled or timed out before the store responded. Try running the command again.');
+        }
         // Check for network-level errors (connection issues, timeouts, DNS failures, TLS/certificate errors, etc.)
         // All network errors should be treated as user-facing errors, not CLI bugs
         // Note: Some of these may have been retried already by lower-level retry logic

package/dist/public/node/api/admin.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../../../src/public/node/api/admin.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  graphqlRequest,\n  graphqlRequestDoc,\n  GraphQLResponseOptions,\n  GraphQLVariables,\n  UnauthorizedHandler,\n} from './graphql.js'\nimport {AdminSession} from '../session.js'\nimport {outputContent, outputToken} from '../output.js'\nimport {AbortError, BugError} from '../error.js'\nimport {\n  restRequestBody,\n  restRequestHeaders,\n  restRequestUrl,\n  isThemeAccessSession,\n} from '../../../private/node/api/rest.js'\nimport {isNetworkError} from '../../../private/node/api.js'\nimport {RequestModeInput, shopifyFetch} from '../http.js'\nimport {PublicApiVersions} from '../../../cli/api/graphql/admin/generated/public_api_versions.js'\nimport {themeKitAccessDomain} from '../../../private/node/constants.js'\nimport {serviceEnvironment} from '../../../private/node/context/service.js'\nimport {DevServerCore} from '../vendor/dev_server/index.js'\nimport {ClientError, Variables} from 'graphql-request'\n\nimport {TypedDocumentNode} from '@graphql-typed-document-node/core'\n\nconst LatestApiVersionByFQDN = new Map<string, string>()\n\n/**\n * Executes a GraphQL query against the Admin API.\n *\n * @param query - GraphQL query to execute.\n * @param session - Shopify admin session including token and Store FQDN.\n * @param variables - GraphQL variables to pass to the query.\n * @param version - API version.\n * @returns The response of the query of generic type <T>.\n */\nexport async function adminRequest<T>(\n  query: string,\n  session: AdminSession,\n  variables?: GraphQLVariables,\n  version?: string,\n): Promise<T> {\n  const api = 'Admin'\n  const apiVersion = version ?? (await fetchLatestSupportedApiVersion(session))\n  let storeDomain = session.storeFqdn\n  const addedHeaders = themeAccessHeaders(session)\n\n  if (serviceEnvironment() === 'local') {\n    addedHeaders['x-forwarded-host'] = storeDomain\n    storeDomain = new DevServerCore().host('app')\n  }\n\n  const url = adminUrl(storeDomain, apiVersion, session)\n  return graphqlRequest({query, api, addedHeaders, url, token: session.token, variables})\n}\n\nexport interface AdminRequestOptions<TResult, TVariables extends Variables> {\n  /** GraphQL query to execute. */\n  query: TypedDocumentNode<TResult, TVariables>\n  /** Shopify admin session including token and Store FQDN. */\n  session: AdminSession\n  /** GraphQL variables to pass to the query. */\n  variables?: TVariables\n  /** API version. */\n  version?: string\n  /** Control how API responses will be handled. */\n  responseOptions?: GraphQLResponseOptions<TResult>\n  /** Custom request behaviour for retries and timeouts. */\n  preferredBehaviour?: RequestModeInput\n}\n\n/**\n * Executes a GraphQL query against the Admin API. Uses typed documents.\n *\n * @param options - Admin request options.\n * @returns The response of the query of generic type <TResult>.\n */\nexport async function adminRequestDoc<TResult, TVariables extends Variables>(\n  options: AdminRequestOptions<TResult, TVariables>,\n): Promise<TResult> {\n  const {query, session, variables, version, responseOptions, preferredBehaviour} = options\n\n  let apiVersion = version ?? LatestApiVersionByFQDN.get(session.storeFqdn)\n  apiVersion ??= await fetchLatestSupportedApiVersion(session, preferredBehaviour)\n  let storeDomain = session.storeFqdn\n  const addedHeaders = themeAccessHeaders(session)\n\n  if (serviceEnvironment() === 'local') {\n    addedHeaders['x-forwarded-host'] = storeDomain\n    storeDomain = new DevServerCore().host('app')\n  }\n\n  const opts = {\n    url: adminUrl(storeDomain, apiVersion, session),\n    api: 'Admin',\n    token: session.token,\n    addedHeaders,\n  }\n  let unauthorizedHandler: UnauthorizedHandler | undefined\n  if ('refresh' in session) {\n    unauthorizedHandler = {type: 'token_refresh', handler: session.refresh as () => Promise<{token: string}>}\n  }\n  const result = graphqlRequestDoc<TResult, TVariables>({\n    ...opts,\n    query,\n    variables,\n    responseOptions,\n    unauthorizedHandler,\n    preferredBehaviour,\n  })\n  return result\n}\n\nfunction themeAccessHeaders(session: AdminSession): Record<string, string> {\n  return isThemeAccessSession(session)\n    ? {'X-Shopify-Shop': session.storeFqdn, 'X-Shopify-Access-Token': session.token}\n    : {}\n}\n\n/**\n * GraphQL query to retrieve the latest supported API version.\n *\n * @param session - Shopify admin session including token and Store FQDN.\n * @param preferredBehaviour - Custom request behaviour for retries and timeouts.\n * @returns - The latest supported API version.\n */\nasync function fetchLatestSupportedApiVersion(\n  session: AdminSession,\n  preferredBehaviour?: RequestModeInput,\n): Promise<string> {\n  const apiVersions = await supportedApiVersions(session, preferredBehaviour)\n\n  const latest = apiVersions.reverse()[0]!\n  LatestApiVersionByFQDN.set(session.storeFqdn, latest)\n  return latest\n}\n\n/**\n * GraphQL query to retrieve all supported API versions.\n *\n * @param session - Shopify admin session including token and Store FQDN.\n * @param preferredBehaviour - Custom request behaviour for retries and timeouts.\n * @returns - An array of supported API versions.\n */\nexport async function supportedApiVersions(\n  session: AdminSession,\n  preferredBehaviour?: RequestModeInput,\n): Promise<string[]> {\n  const apiVersions = await fetchApiVersions(session, preferredBehaviour)\n  return apiVersions\n    .filter((item) => item.supported)\n    .map((item) => item.handle)\n    .sort()\n}\n\n/**\n * GraphQL query to retrieve all API versions.\n *\n * @param session - Shopify admin session including token and Store FQDN.\n * @param preferredBehaviour - Custom request behaviour for retries and timeouts.\n * @returns - An array of supported and unsupported API versions.\n */\nexport async function fetchApiVersions(\n  session: AdminSession,\n  preferredBehaviour?: RequestModeInput,\n): Promise<ApiVersion[]> {\n  try {\n    const response = await adminRequestDoc({\n      query: PublicApiVersions,\n      session,\n      variables: {},\n      version: 'unstable',\n      responseOptions: {handleErrors: false},\n      preferredBehaviour,\n    })\n    return response.publicApiVersions\n  } catch (error) {\n    if (error instanceof ClientError && error.response.status === 403) {\n      const storeName = session.storeFqdn.replace('.myshopify.com', '')\n      throw new AbortError(\n        outputContent`Looks like you don't have access to this dev store: (${outputToken.link(\n          storeName,\n          `https://${session.storeFqdn}`,\n        )})`,\n        outputContent`If you're not the owner, create a dev store staff account for yourself`,\n      )\n    }\n    if (error instanceof ClientError && (error.response.status === 401 || error.response.status === 404)) {\n      throw new AbortError(\n        `Error connecting to your store ${session.storeFqdn}: ${error.message} ${error.response.status} ${error.response.data}`,\n      )\n    }\n\n    // Check for network-level errors (connection issues, timeouts, DNS failures, TLS/certificate errors, etc.)\n    // All network errors should be treated as user-facing errors, not CLI bugs\n    // Note: Some of these may have been retried already by lower-level retry logic\n    if (isNetworkError(error)) {\n      throw new AbortError(\n        `Network error connecting to your store ${session.storeFqdn}: ${\n          error instanceof Error ? error.message : String(error)\n        }`,\n        'Check your internet connection and try again.',\n      )\n    }\n\n    // Unknown errors are likely bugs in the CLI\n    throw new BugError(\n      `Unknown error connecting to your store ${session.storeFqdn}: ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n    )\n  }\n}\n\n/**\n * Returns the Admin API URL for the given store and version.\n *\n * @param store - Store FQDN.\n * @param version - API version.\n * @param session - User session.\n * @returns - Admin API URL.\n */\nexport function adminUrl(store: string, version: string | undefined, session?: AdminSession): string {\n  const realVersion = version ?? 'unstable'\n\n  const url =\n    session && isThemeAccessSession(session)\n      ? `https://${themeKitAccessDomain}/cli/admin/api/${realVersion}/graphql.json`\n      : `https://${store}/admin/api/${realVersion}/graphql.json`\n  return url\n}\n\ninterface ApiVersion {\n  handle: string\n  supported: boolean\n}\n\n/**\n * Executes a REST request against the Admin API.\n *\n * @param method - Request's HTTP method.\n * @param path - Path of the REST resource.\n * @param session - Shopify Admin session including token and Store FQDN.\n * @param requestBody - Request body of including REST resource specific parameters.\n * @param searchParams - Search params, appended to the URL.\n * @param apiVersion - Admin API version.\n * @returns - The {@link RestResponse}.\n */\nexport async function restRequest<T>(\n  method: string,\n  path: string,\n  session: AdminSession,\n  requestBody?: T,\n  searchParams: Record<string, string> = {},\n  apiVersion = 'unstable',\n): Promise<RestResponse> {\n  const url = restRequestUrl(session, apiVersion, path, searchParams)\n  const body = restRequestBody<T>(requestBody)\n\n  const headers = restRequestHeaders(session)\n  const response = await shopifyFetch(url, {\n    headers,\n    method,\n    body,\n  })\n\n  const json = await response.json().catch(() => ({}))\n\n  return {\n    json,\n    status: response.status,\n    headers: response.headers.raw(),\n  }\n}\n\n/**\n * Respose of a REST request.\n */\nexport interface RestResponse {\n  /**\n   * REST JSON respose.\n   */\n  // Using `any` to avoid introducing extra DTO layers.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  json: any\n\n  /**\n   * HTTP response status.\n   */\n  status: number\n\n  /**\n   * HTTP response headers.\n   */\n  headers: Record<string, string[]>\n}\n"]}
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../../../src/public/node/api/admin.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  graphqlRequest,\n  graphqlRequestDoc,\n  GraphQLResponseOptions,\n  GraphQLVariables,\n  UnauthorizedHandler,\n} from './graphql.js'\nimport {AdminSession} from '../session.js'\nimport {outputContent, outputToken} from '../output.js'\nimport {AbortError, BugError} from '../error.js'\nimport {\n  restRequestBody,\n  restRequestHeaders,\n  restRequestUrl,\n  isThemeAccessSession,\n} from '../../../private/node/api/rest.js'\nimport {isAbortedFetchError, isNetworkError} from '../../../private/node/api.js'\nimport {RequestModeInput, shopifyFetch} from '../http.js'\nimport {PublicApiVersions} from '../../../cli/api/graphql/admin/generated/public_api_versions.js'\nimport {themeKitAccessDomain} from '../../../private/node/constants.js'\nimport {serviceEnvironment} from '../../../private/node/context/service.js'\nimport {DevServerCore} from '../vendor/dev_server/index.js'\nimport {ClientError, Variables} from 'graphql-request'\n\nimport {TypedDocumentNode} from '@graphql-typed-document-node/core'\n\nconst LatestApiVersionByFQDN = new Map<string, string>()\n\n/**\n * Executes a GraphQL query against the Admin API.\n *\n * @param query - GraphQL query to execute.\n * @param session - Shopify admin session including token and Store FQDN.\n * @param variables - GraphQL variables to pass to the query.\n * @param version - API version.\n * @returns The response of the query of generic type <T>.\n */\nexport async function adminRequest<T>(\n  query: string,\n  session: AdminSession,\n  variables?: GraphQLVariables,\n  version?: string,\n): Promise<T> {\n  const api = 'Admin'\n  const apiVersion = version ?? (await fetchLatestSupportedApiVersion(session))\n  let storeDomain = session.storeFqdn\n  const addedHeaders = themeAccessHeaders(session)\n\n  if (serviceEnvironment() === 'local') {\n    addedHeaders['x-forwarded-host'] = storeDomain\n    storeDomain = new DevServerCore().host('app')\n  }\n\n  const url = adminUrl(storeDomain, apiVersion, session)\n  return graphqlRequest({query, api, addedHeaders, url, token: session.token, variables})\n}\n\nexport interface AdminRequestOptions<TResult, TVariables extends Variables> {\n  /** GraphQL query to execute. */\n  query: TypedDocumentNode<TResult, TVariables>\n  /** Shopify admin session including token and Store FQDN. */\n  session: AdminSession\n  /** GraphQL variables to pass to the query. */\n  variables?: TVariables\n  /** API version. */\n  version?: string\n  /** Control how API responses will be handled. */\n  responseOptions?: GraphQLResponseOptions<TResult>\n  /** Custom request behaviour for retries and timeouts. */\n  preferredBehaviour?: RequestModeInput\n}\n\n/**\n * Executes a GraphQL query against the Admin API. Uses typed documents.\n *\n * @param options - Admin request options.\n * @returns The response of the query of generic type <TResult>.\n */\nexport async function adminRequestDoc<TResult, TVariables extends Variables>(\n  options: AdminRequestOptions<TResult, TVariables>,\n): Promise<TResult> {\n  const {query, session, variables, version, responseOptions, preferredBehaviour} = options\n\n  let apiVersion = version ?? LatestApiVersionByFQDN.get(session.storeFqdn)\n  apiVersion ??= await fetchLatestSupportedApiVersion(session, preferredBehaviour)\n  let storeDomain = session.storeFqdn\n  const addedHeaders = themeAccessHeaders(session)\n\n  if (serviceEnvironment() === 'local') {\n    addedHeaders['x-forwarded-host'] = storeDomain\n    storeDomain = new DevServerCore().host('app')\n  }\n\n  const opts = {\n    url: adminUrl(storeDomain, apiVersion, session),\n    api: 'Admin',\n    token: session.token,\n    addedHeaders,\n  }\n  let unauthorizedHandler: UnauthorizedHandler | undefined\n  if ('refresh' in session) {\n    unauthorizedHandler = {type: 'token_refresh', handler: session.refresh as () => Promise<{token: string}>}\n  }\n  const result = graphqlRequestDoc<TResult, TVariables>({\n    ...opts,\n    query,\n    variables,\n    responseOptions,\n    unauthorizedHandler,\n    preferredBehaviour,\n  })\n  return result\n}\n\nfunction themeAccessHeaders(session: AdminSession): Record<string, string> {\n  return isThemeAccessSession(session)\n    ? {'X-Shopify-Shop': session.storeFqdn, 'X-Shopify-Access-Token': session.token}\n    : {}\n}\n\n/**\n * GraphQL query to retrieve the latest supported API version.\n *\n * @param session - Shopify admin session including token and Store FQDN.\n * @param preferredBehaviour - Custom request behaviour for retries and timeouts.\n * @returns - The latest supported API version.\n */\nasync function fetchLatestSupportedApiVersion(\n  session: AdminSession,\n  preferredBehaviour?: RequestModeInput,\n): Promise<string> {\n  const apiVersions = await supportedApiVersions(session, preferredBehaviour)\n\n  const latest = apiVersions.reverse()[0]!\n  LatestApiVersionByFQDN.set(session.storeFqdn, latest)\n  return latest\n}\n\n/**\n * GraphQL query to retrieve all supported API versions.\n *\n * @param session - Shopify admin session including token and Store FQDN.\n * @param preferredBehaviour - Custom request behaviour for retries and timeouts.\n * @returns - An array of supported API versions.\n */\nexport async function supportedApiVersions(\n  session: AdminSession,\n  preferredBehaviour?: RequestModeInput,\n): Promise<string[]> {\n  const apiVersions = await fetchApiVersions(session, preferredBehaviour)\n  return apiVersions\n    .filter((item) => item.supported)\n    .map((item) => item.handle)\n    .sort()\n}\n\n/**\n * GraphQL query to retrieve all API versions.\n *\n * @param session - Shopify admin session including token and Store FQDN.\n * @param preferredBehaviour - Custom request behaviour for retries and timeouts.\n * @returns - An array of supported and unsupported API versions.\n */\nexport async function fetchApiVersions(\n  session: AdminSession,\n  preferredBehaviour?: RequestModeInput,\n): Promise<ApiVersion[]> {\n  try {\n    const response = await adminRequestDoc({\n      query: PublicApiVersions,\n      session,\n      variables: {},\n      version: 'unstable',\n      responseOptions: {handleErrors: false},\n      preferredBehaviour,\n    })\n    return response.publicApiVersions\n  } catch (error) {\n    if (error instanceof ClientError && error.response.status === 403) {\n      const storeName = session.storeFqdn.replace('.myshopify.com', '')\n      throw new AbortError(\n        outputContent`Looks like you don't have access to this dev store: (${outputToken.link(\n          storeName,\n          `https://${session.storeFqdn}`,\n        )})`,\n        outputContent`If you're not the owner, create a dev store staff account for yourself`,\n      )\n    }\n    if (error instanceof ClientError && (error.response.status === 401 || error.response.status === 404)) {\n      throw new AbortError(\n        `Error connecting to your store ${session.storeFqdn}: ${error.message} ${error.response.status} ${error.response.data}`,\n      )\n    }\n\n    // HTTP 402 means the shop is frozen, paused, or closed. That is a store state the user can\n    // fix, not a CLI bug, so it must not reach the BugError below.\n    if (error instanceof ClientError && error.response.status === 402) {\n      throw new AbortError(\n        `The store ${session.storeFqdn} is currently unavailable.`,\n        'This usually means the store is frozen, paused, or closed. Check the store in the Shopify admin and try again once it is reactivated.',\n      )\n    }\n\n    // HTTP 5xx is a Shopify-side failure. This query takes no user input, so the user's command\n    // cannot have caused it. `isExpectedApiError` covers 502/503/504, but only for raw errors, so\n    // it never sees one we have already wrapped in a BugError.\n    if (error instanceof ClientError && error.response.status >= 500) {\n      throw new AbortError(\n        `The Admin API for ${session.storeFqdn} returned a server error (HTTP ${error.response.status}).`,\n        'This is a problem on the Shopify side, not with your command. Wait a moment and try again.',\n      )\n    }\n\n    // A cancelled request is neither a store-state failure nor a CLI bug. Checked before\n    // `isNetworkError` so the message says the request was aborted instead of blaming the\n    // user's connection.\n    if (isAbortedFetchError(error)) {\n      throw new AbortError(\n        `Request to ${session.storeFqdn} was aborted before it completed.`,\n        'The request was cancelled or timed out before the store responded. Try running the command again.',\n      )\n    }\n\n    // Check for network-level errors (connection issues, timeouts, DNS failures, TLS/certificate errors, etc.)\n    // All network errors should be treated as user-facing errors, not CLI bugs\n    // Note: Some of these may have been retried already by lower-level retry logic\n    if (isNetworkError(error)) {\n      throw new AbortError(\n        `Network error connecting to your store ${session.storeFqdn}: ${\n          error instanceof Error ? error.message : String(error)\n        }`,\n        'Check your internet connection and try again.',\n      )\n    }\n\n    // Unknown errors are likely bugs in the CLI\n    throw new BugError(\n      `Unknown error connecting to your store ${session.storeFqdn}: ${\n        error instanceof Error ? error.message : String(error)\n      }`,\n    )\n  }\n}\n\n/**\n * Returns the Admin API URL for the given store and version.\n *\n * @param store - Store FQDN.\n * @param version - API version.\n * @param session - User session.\n * @returns - Admin API URL.\n */\nexport function adminUrl(store: string, version: string | undefined, session?: AdminSession): string {\n  const realVersion = version ?? 'unstable'\n\n  const url =\n    session && isThemeAccessSession(session)\n      ? `https://${themeKitAccessDomain}/cli/admin/api/${realVersion}/graphql.json`\n      : `https://${store}/admin/api/${realVersion}/graphql.json`\n  return url\n}\n\ninterface ApiVersion {\n  handle: string\n  supported: boolean\n}\n\n/**\n * Executes a REST request against the Admin API.\n *\n * @param method - Request's HTTP method.\n * @param path - Path of the REST resource.\n * @param session - Shopify Admin session including token and Store FQDN.\n * @param requestBody - Request body of including REST resource specific parameters.\n * @param searchParams - Search params, appended to the URL.\n * @param apiVersion - Admin API version.\n * @returns - The {@link RestResponse}.\n */\nexport async function restRequest<T>(\n  method: string,\n  path: string,\n  session: AdminSession,\n  requestBody?: T,\n  searchParams: Record<string, string> = {},\n  apiVersion = 'unstable',\n): Promise<RestResponse> {\n  const url = restRequestUrl(session, apiVersion, path, searchParams)\n  const body = restRequestBody<T>(requestBody)\n\n  const headers = restRequestHeaders(session)\n  const response = await shopifyFetch(url, {\n    headers,\n    method,\n    body,\n  })\n\n  const json = await response.json().catch(() => ({}))\n\n  return {\n    json,\n    status: response.status,\n    headers: response.headers.raw(),\n  }\n}\n\n/**\n * Respose of a REST request.\n */\nexport interface RestResponse {\n  /**\n   * REST JSON respose.\n   */\n  // Using `any` to avoid introducing extra DTO layers.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  json: any\n\n  /**\n   * HTTP response status.\n   */\n  status: number\n\n  /**\n   * HTTP response headers.\n   */\n  headers: Record<string, string[]>\n}\n"]}

package/dist/public/node/api/app-management.d.ts

@@ -7,6 +7,7 @@ export declare const appManagementAppLogsUrl: (organizationId: string, cursor?:
     status?: string;
     source?: string;
 }) => Promise<string>;
+export declare const appManagementChannelSpecExportUrl: (organizationId: string, appId: string) => Promise<string>;
 export interface RequestOptions {
     requestMode: RequestModeInput;
 }

package/dist/public/node/api/app-management.js

@@ -30,6 +30,10 @@ export const appManagementAppLogsUrl = async (organizationId, cursor, filters) =
     const url = `https://${fqdn}/app_management/unstable/organizations/${organizationId}/app_logs/poll`;
     return addCursorAndFiltersToAppLogsUrl(url, cursor, filters);
 };
+export const appManagementChannelSpecExportUrl = async (organizationId, appId) => {
+    const fqdn = await appManagementFqdn();
+    return `https://${fqdn}/app_management/unstable/organizations/${encodeURIComponent(organizationId)}/apps/${encodeURIComponent(appId)}/channel_spec_export.json`;
+};
 /**
  * Executes an org-scoped GraphQL query against the App Management API. Uses typed documents.
  *

package/dist/public/node/api/app-management.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-management.js","sourceRoot":"","sources":["../../../../src/public/node/api/app-management.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,+BAA+B,EAAC,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAqD,iBAAiB,EAAC,MAAM,cAAc,CAAA;AAClG,OAAO,EAAC,iBAAiB,EAAC,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAC,sBAAsB,EAAC,MAAM,qDAAqD,CAAA;AAC1F,OAAO,EAAC,YAAY,EAAC,MAAM,sCAAsC,CAAA;AAEjE,OAAO,UAAU,MAAM,YAAY,CAAA;AAKnC,sEAAsE;AACtE,yEAAyE;AACzE,iDAAiD;AACjD,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC;IAC7B,OAAO,EAAE,GAAG;IACZ,aAAa,EAAE,EAAE;CAClB,CAAC,CAAA;AAEF,KAAK,UAAU,YAAY,CAAC,KAAa;IACvC,MAAM,GAAG,GAAG,gBAAgB,CAAA;IAC5B,MAAM,IAAI,GAAG,MAAM,iBAAiB,EAAE,CAAA;IACtC,MAAM,GAAG,GAAG,WAAW,IAAI,uCAAuC,CAAA;IAClE,OAAO;QACL,KAAK;QACL,GAAG;QACH,GAAG;QACH,eAAe,EAAE,EAAC,UAAU,EAAE,kBAAkB,EAAC;KAClD,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAA0B,EAAE;IAC5E,OAAO,YAAY,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAC1C,cAAsB,EACtB,MAAe,EACf,OAGC,EACgB,EAAE;IACnB,MAAM,IAAI,GAAG,MAAM,iBAAiB,EAAE,CAAA;IACtC,MAAM,GAAG,GAAG,WAAW,IAAI,0CAA0C,cAAc,gBAAgB,CAAA;IACnG,OAAO,+BAA+B,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;AAC9D,CAAC,CAAA;AAwBD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAyD;IAEzD,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,aAAa,IAAI,EAAE,CAAA;IAC/D,MAAM,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAC,GAAG,OAAO,CAAC,YAAY,EAAE,aAAa,EAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAEnG,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAU,KAAK,IAAI,EAAE,CAClD,iBAAiB,CAAsB;QACrC,GAAG,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY,EAAE,eAAe;QAC7B,kBAAkB,EAAE,OAAO,CAAC,cAAc,EAAE,WAAW;QACvD,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;KACjD,CAAC,CACH,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAUD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAI,QAA4B;IAChE,IAAI,CAAC,QAAQ,CAAC,UAAU;QAAE,OAAM;IAEhC,MAAM,gBAAgB,GAAW,EAAE,CAAA;IACnC,KAAK,MAAM,WAAW,IAAK,QAAQ,CAAC,UAA+B,CAAC,YAAY,EAAE,CAAC;QACjF,IAAI,WAAW,CAAC,kBAAkB,EAAE,CAAC;YACnC,gBAAgB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;IAED,sBAAsB,CAAC,gBAAgB,CAAC,CAAA;AAC1C,CAAC","sourcesContent":["import {addCursorAndFiltersToAppLogsUrl} from './utilities.js'\nimport {CacheOptions, GraphQLResponse, UnauthorizedHandler, graphqlRequestDoc} from './graphql.js'\nimport {appManagementFqdn} from '../context/fqdn.js'\nimport {setNextDeprecationDate} from '../../../private/node/context/deprecations-store.js'\nimport {buildHeaders} from '../../../private/node/api/headers.js'\nimport {RequestModeInput} from '../http.js'\nimport Bottleneck from 'bottleneck'\n\nimport {TypedDocumentNode} from '@graphql-typed-document-node/core'\nimport {Variables} from 'graphql-request'\n\n// API Rate limiter for partners API (Limit is 10 requests per second)\n// Jobs are launched every 150ms to add an extra 50ms margin per request.\n// Only 10 requests can be executed concurrently.\nconst limiter = new Bottleneck({\n  minTime: 150,\n  maxConcurrent: 10,\n})\n\nasync function setupRequest(token: string) {\n  const api = 'App Management'\n  const fqdn = await appManagementFqdn()\n  const url = `https://${fqdn}/app_management/unstable/graphql.json`\n  return {\n    token,\n    api,\n    url,\n    responseOptions: {onResponse: handleDeprecations},\n  }\n}\n\nexport const appManagementHeaders = (token: string): Record<string, string> => {\n  return buildHeaders(token)\n}\n\nexport const appManagementAppLogsUrl = async (\n  organizationId: string,\n  cursor?: string,\n  filters?: {\n    status?: string\n    source?: string\n  },\n): Promise<string> => {\n  const fqdn = await appManagementFqdn()\n  const url = `https://${fqdn}/app_management/unstable/organizations/${organizationId}/app_logs/poll`\n  return addCursorAndFiltersToAppLogsUrl(url, cursor, filters)\n}\n\nexport interface RequestOptions {\n  requestMode: RequestModeInput\n}\n\n/**\n * @param orgId - The organization ID.\n * @param query - GraphQL query to execute.\n * @param token - Partners token.\n * @param variables - GraphQL variables to pass to the query.\n * @param cacheOptions - Cache options for the request. If not present, the request will not be cached.\n * @param requestOptions - Preferred behaviour for the request.\n * @param unauthorizedHandler - Optional handler for unauthorized requests.\n */\nexport interface AppManagementRequestOptions<TResult, TVariables extends Variables> {\n  query: TypedDocumentNode<TResult, TVariables>\n  token: string\n  variables?: TVariables\n  cacheOptions?: CacheOptions\n  requestOptions?: RequestOptions\n  unauthorizedHandler: UnauthorizedHandler\n}\n\n/**\n * Executes an org-scoped GraphQL query against the App Management API. Uses typed documents.\n *\n * @param options - The options for the request.\n * @returns The response of the query of generic type <T>.\n */\nexport async function appManagementRequestDoc<TResult, TVariables extends Variables>(\n  options: AppManagementRequestOptions<TResult, TVariables>,\n): Promise<TResult> {\n  const cacheExtraKey = options.cacheOptions?.cacheExtraKey ?? ''\n  const newCacheOptions = options.cacheOptions ? {...options.cacheOptions, cacheExtraKey} : undefined\n\n  const result = limiter.schedule<TResult>(async () =>\n    graphqlRequestDoc<TResult, TVariables>({\n      ...(await setupRequest(options.token)),\n      query: options.query,\n      variables: options.variables,\n      cacheOptions: newCacheOptions,\n      preferredBehaviour: options.requestOptions?.requestMode,\n      unauthorizedHandler: options.unauthorizedHandler,\n    }),\n  )\n\n  return result\n}\n\ninterface Deprecation {\n  supportedUntilDate?: string\n}\n\ninterface WithDeprecations {\n  deprecations: Deprecation[]\n}\n\n/**\n * Sets the next deprecation date from [GraphQL response extensions](https://www.apollographql.com/docs/resources/graphql-glossary/#extensions)\n * if `response.extensions.deprecations` objects contain a `supportedUntilDate` (ISO 8601-formatted string).\n *\n * @param response - The response of the query.\n */\nexport function handleDeprecations<T>(response: GraphQLResponse<T>): void {\n  if (!response.extensions) return\n\n  const deprecationDates: Date[] = []\n  for (const deprecation of (response.extensions as WithDeprecations).deprecations) {\n    if (deprecation.supportedUntilDate) {\n      deprecationDates.push(new Date(deprecation.supportedUntilDate))\n    }\n  }\n\n  setNextDeprecationDate(deprecationDates)\n}\n"]}
+{"version":3,"file":"app-management.js","sourceRoot":"","sources":["../../../../src/public/node/api/app-management.ts"],"names":[],"mappings":"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","sourcesContent":["import {addCursorAndFiltersToAppLogsUrl} from './utilities.js'\nimport {CacheOptions, GraphQLResponse, UnauthorizedHandler, graphqlRequestDoc} from './graphql.js'\nimport {appManagementFqdn} from '../context/fqdn.js'\nimport {setNextDeprecationDate} from '../../../private/node/context/deprecations-store.js'\nimport {buildHeaders} from '../../../private/node/api/headers.js'\nimport {RequestModeInput} from '../http.js'\nimport Bottleneck from 'bottleneck'\n\nimport {TypedDocumentNode} from '@graphql-typed-document-node/core'\nimport {Variables} from 'graphql-request'\n\n// API Rate limiter for partners API (Limit is 10 requests per second)\n// Jobs are launched every 150ms to add an extra 50ms margin per request.\n// Only 10 requests can be executed concurrently.\nconst limiter = new Bottleneck({\n  minTime: 150,\n  maxConcurrent: 10,\n})\n\nasync function setupRequest(token: string) {\n  const api = 'App Management'\n  const fqdn = await appManagementFqdn()\n  const url = `https://${fqdn}/app_management/unstable/graphql.json`\n  return {\n    token,\n    api,\n    url,\n    responseOptions: {onResponse: handleDeprecations},\n  }\n}\n\nexport const appManagementHeaders = (token: string): Record<string, string> => {\n  return buildHeaders(token)\n}\n\nexport const appManagementAppLogsUrl = async (\n  organizationId: string,\n  cursor?: string,\n  filters?: {\n    status?: string\n    source?: string\n  },\n): Promise<string> => {\n  const fqdn = await appManagementFqdn()\n  const url = `https://${fqdn}/app_management/unstable/organizations/${organizationId}/app_logs/poll`\n  return addCursorAndFiltersToAppLogsUrl(url, cursor, filters)\n}\n\nexport const appManagementChannelSpecExportUrl = async (organizationId: string, appId: string): Promise<string> => {\n  const fqdn = await appManagementFqdn()\n  return `https://${fqdn}/app_management/unstable/organizations/${encodeURIComponent(\n    organizationId,\n  )}/apps/${encodeURIComponent(appId)}/channel_spec_export.json`\n}\n\nexport interface RequestOptions {\n  requestMode: RequestModeInput\n}\n\n/**\n * @param orgId - The organization ID.\n * @param query - GraphQL query to execute.\n * @param token - Partners token.\n * @param variables - GraphQL variables to pass to the query.\n * @param cacheOptions - Cache options for the request. If not present, the request will not be cached.\n * @param requestOptions - Preferred behaviour for the request.\n * @param unauthorizedHandler - Optional handler for unauthorized requests.\n */\nexport interface AppManagementRequestOptions<TResult, TVariables extends Variables> {\n  query: TypedDocumentNode<TResult, TVariables>\n  token: string\n  variables?: TVariables\n  cacheOptions?: CacheOptions\n  requestOptions?: RequestOptions\n  unauthorizedHandler: UnauthorizedHandler\n}\n\n/**\n * Executes an org-scoped GraphQL query against the App Management API. Uses typed documents.\n *\n * @param options - The options for the request.\n * @returns The response of the query of generic type <T>.\n */\nexport async function appManagementRequestDoc<TResult, TVariables extends Variables>(\n  options: AppManagementRequestOptions<TResult, TVariables>,\n): Promise<TResult> {\n  const cacheExtraKey = options.cacheOptions?.cacheExtraKey ?? ''\n  const newCacheOptions = options.cacheOptions ? {...options.cacheOptions, cacheExtraKey} : undefined\n\n  const result = limiter.schedule<TResult>(async () =>\n    graphqlRequestDoc<TResult, TVariables>({\n      ...(await setupRequest(options.token)),\n      query: options.query,\n      variables: options.variables,\n      cacheOptions: newCacheOptions,\n      preferredBehaviour: options.requestOptions?.requestMode,\n      unauthorizedHandler: options.unauthorizedHandler,\n    }),\n  )\n\n  return result\n}\n\ninterface Deprecation {\n  supportedUntilDate?: string\n}\n\ninterface WithDeprecations {\n  deprecations: Deprecation[]\n}\n\n/**\n * Sets the next deprecation date from [GraphQL response extensions](https://www.apollographql.com/docs/resources/graphql-glossary/#extensions)\n * if `response.extensions.deprecations` objects contain a `supportedUntilDate` (ISO 8601-formatted string).\n *\n * @param response - The response of the query.\n */\nexport function handleDeprecations<T>(response: GraphQLResponse<T>): void {\n  if (!response.extensions) return\n\n  const deprecationDates: Date[] = []\n  for (const deprecation of (response.extensions as WithDeprecations).deprecations) {\n    if (deprecation.supportedUntilDate) {\n      deprecationDates.push(new Date(deprecation.supportedUntilDate))\n    }\n  }\n\n  setNextDeprecationDate(deprecationDates)\n}\n"]}

package/dist/public/node/api/bulk-operations/download-bulk-operation-results.d.ts

@@ -6,12 +6,12 @@
  */
 export declare function downloadBulkOperationResults(url: string): Promise<string>;
 /**
- * Checks whether any line of a JSONL bulk operation result reports GraphQL user errors.
+ * Checks whether any line of a JSONL bulk operation result reports top-level GraphQL errors or nested user errors.
  *
  * Blank result files, such as a completed operation that matched nothing, are treated as having
- * no user errors instead of crashing the JSON parser.
+ * no errors instead of crashing the JSON parser.
  *
  * @param results - The raw JSONL results string.
- * @returns True if any result line reports user errors.
+ * @returns True if any result line reports errors.
  */
 export declare function resultsContainUserErrors(results: string): boolean;

package/dist/public/node/api/bulk-operations/download-bulk-operation-results.js

@@ -14,13 +14,13 @@ export async function downloadBulkOperationResults(url) {
     return response.text();
 }
 /**
- * Checks whether any line of a JSONL bulk operation result reports GraphQL user errors.
+ * Checks whether any line of a JSONL bulk operation result reports top-level GraphQL errors or nested user errors.
  *
  * Blank result files, such as a completed operation that matched nothing, are treated as having
- * no user errors instead of crashing the JSON parser.
+ * no errors instead of crashing the JSON parser.
  *
  * @param results - The raw JSONL results string.
- * @returns True if any result line reports user errors.
+ * @returns True if any result line reports errors.
  */
 export function resultsContainUserErrors(results) {
     const lines = results
@@ -39,6 +39,8 @@ export function resultsContainUserErrors(results) {
                 return false;
             throw error;
         }
+        if (Array.isArray(parsed.errors) && parsed.errors.length > 0)
+            return true;
         if (!parsed.data)
             return false;
         const result = Object.values(parsed.data)[0];

package/dist/public/node/api/bulk-operations/download-bulk-operation-results.js.map

@@ -1 +1 @@
-{"version":3,"file":"download-bulk-operation-results.js","sourceRoot":"","sources":["../../../../../src/public/node/api/bulk-operations/download-bulk-operation-results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,eAAe,CAAA;AACnC,OAAO,EAAC,UAAU,EAAC,MAAM,gBAAgB,CAAA;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,GAAW;IAC5D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAEjC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,UAAU,CAAC,8CAA8C,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;IAC3F,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;AACxB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,MAAM,KAAK,GAAG,OAAO;SAClB,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAE3C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,IAAI,MAAM,CAAA;QACV,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0FAA0F;YAC1F,gFAAgF;YAChF,IAAI,KAAK,YAAY,WAAW;gBAAE,OAAO,KAAK,CAAA;YAC9C,MAAM,KAAK,CAAA;QACb,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,OAAO,KAAK,CAAA;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAyC,CAAA;QACpF,OAAO,MAAM,EAAE,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import {fetch} from '../../http.js'\nimport {AbortError} from '../../error.js'\n\n/**\n * Downloads the results of a completed bulk operation.\n *\n * @param url - The results URL returned by the Admin API.\n * @returns The raw JSONL results as a string.\n */\nexport async function downloadBulkOperationResults(url: string): Promise<string> {\n  const response = await fetch(url)\n\n  if (!response.ok) {\n    throw new AbortError(`Failed to download bulk operation results: ${response.statusText}`)\n  }\n\n  return response.text()\n}\n\n/**\n * Checks whether any line of a JSONL bulk operation result reports GraphQL user errors.\n *\n * Blank result files, such as a completed operation that matched nothing, are treated as having\n * no user errors instead of crashing the JSON parser.\n *\n * @param results - The raw JSONL results string.\n * @returns True if any result line reports user errors.\n */\nexport function resultsContainUserErrors(results: string): boolean {\n  const lines = results\n    .trim()\n    .split('\\n')\n    .filter((line) => line.trim().length > 0)\n\n  return lines.some((line) => {\n    let parsed\n    try {\n      parsed = JSON.parse(line)\n    } catch (error) {\n      // A single malformed line (truncated download, partial flush, etc.) shouldn't dictate the\n      // overall result; skip it rather than throwing an uncontextualized SyntaxError.\n      if (error instanceof SyntaxError) return false\n      throw error\n    }\n    if (!parsed.data) return false\n    const result = Object.values(parsed.data)[0] as {userErrors?: unknown[]} | undefined\n    return result?.userErrors !== undefined && result.userErrors.length > 0\n  })\n}\n"]}
+{"version":3,"file":"download-bulk-operation-results.js","sourceRoot":"","sources":["../../../../../src/public/node/api/bulk-operations/download-bulk-operation-results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,eAAe,CAAA;AACnC,OAAO,EAAC,UAAU,EAAC,MAAM,gBAAgB,CAAA;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,GAAW;IAC5D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAEjC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,UAAU,CAAC,8CAA8C,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;IAC3F,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;AACxB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,MAAM,KAAK,GAAG,OAAO;SAClB,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAE3C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,IAAI,MAAM,CAAA;QACV,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0FAA0F;YAC1F,gFAAgF;YAChF,IAAI,KAAK,YAAY,WAAW;gBAAE,OAAO,KAAK,CAAA;YAC9C,MAAM,KAAK,CAAA;QACb,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QACzE,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,OAAO,KAAK,CAAA;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAyC,CAAA;QACpF,OAAO,MAAM,EAAE,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import {fetch} from '../../http.js'\nimport {AbortError} from '../../error.js'\n\n/**\n * Downloads the results of a completed bulk operation.\n *\n * @param url - The results URL returned by the Admin API.\n * @returns The raw JSONL results as a string.\n */\nexport async function downloadBulkOperationResults(url: string): Promise<string> {\n  const response = await fetch(url)\n\n  if (!response.ok) {\n    throw new AbortError(`Failed to download bulk operation results: ${response.statusText}`)\n  }\n\n  return response.text()\n}\n\n/**\n * Checks whether any line of a JSONL bulk operation result reports top-level GraphQL errors or nested user errors.\n *\n * Blank result files, such as a completed operation that matched nothing, are treated as having\n * no errors instead of crashing the JSON parser.\n *\n * @param results - The raw JSONL results string.\n * @returns True if any result line reports errors.\n */\nexport function resultsContainUserErrors(results: string): boolean {\n  const lines = results\n    .trim()\n    .split('\\n')\n    .filter((line) => line.trim().length > 0)\n\n  return lines.some((line) => {\n    let parsed\n    try {\n      parsed = JSON.parse(line)\n    } catch (error) {\n      // A single malformed line (truncated download, partial flush, etc.) shouldn't dictate the\n      // overall result; skip it rather than throwing an uncontextualized SyntaxError.\n      if (error instanceof SyntaxError) return false\n      throw error\n    }\n    if (Array.isArray(parsed.errors) && parsed.errors.length > 0) return true\n    if (!parsed.data) return false\n    const result = Object.values(parsed.data)[0] as {userErrors?: unknown[]} | undefined\n    return result?.userErrors !== undefined && result.userErrors.length > 0\n  })\n}\n"]}

package/dist/public/node/base-command.d.ts

@@ -1,3 +1,4 @@
+import { type JsonOutputSchema } from './json-output-schema.js';
 import { Command } from '@oclif/core';
 import { OutputFlags, Input, ParserOutput, FlagInput, OutputArgs } from '@oclif/core/parser';
 export type ArgOutput = OutputArgs<any>;
@@ -10,14 +11,19 @@ export interface NonTTYFlagRequirement {
 }
 declare abstract class BaseCommand extends Command {
     static baseFlags: FlagInput<{}>;
+    static descriptionWithMarkdown?: string;
+    static get jsonOutputSchema(): JsonOutputSchema | undefined;
     static get requiresSyncAnalytics(): boolean;
     static nonTTYFlagRequirements(_flags: FlagOutput): NonTTYFlagRequirement[];
+    static descriptionForHelp(): string | undefined;
+    /** @deprecated Use descriptionForHelp instead. */
     static descriptionWithoutMarkdown(): string | undefined;
     static analyticsNameOverride(): string | undefined;
     static analyticsStopCommand(): string | undefined;
     catch(error: Error & {
         skipOclifErrorHandling: boolean;
     }): Promise<void>;
+    protected _run<T>(): Promise<T>;
     protected init(): Promise<unknown>;
     protected showNpmFlagWarning(): void;
     protected exitWithTimestampWhenEnvVariablePresent(): void;

package/dist/public/node/base-command.js

@@ -1,6 +1,7 @@
 import { isDevelopment } from './context/local.js';
 import { addPublicMetadata } from './metadata.js';
 import { AbortError } from './error.js';
+import { runWithCommandEventsForCommand } from './command-events.js';
 import { outputContent, outputResult, outputToken } from './output.js';
 import { setCurrentSessionAlias } from './session.js';
 import { terminalSupportsPrompting } from './system.js';
@@ -8,19 +9,32 @@ import { hashString } from './crypto.js';
 import { isTruthy } from './context/utilities.js';
 import { setCurrentCommandId } from './global-context.js';
 import { underscore } from '../common/string.js';
-import { Command, Errors } from '@oclif/core';
+import { Command, Errors, Flags } from '@oclif/core';
 class BaseCommand extends Command {
-    static baseFlags = {};
+    static baseFlags = {
+        'json-schema': Flags.boolean({
+            description: "Print the command's JSON schemas.",
+            env: 'SHOPIFY_FLAG_JSON_SCHEMA',
+        }),
+    };
+    static descriptionWithMarkdown;
+    static get jsonOutputSchema() {
+        return undefined;
+    }
     static get requiresSyncAnalytics() {
         return false;
     }
     static nonTTYFlagRequirements(_flags) {
         return [];
     }
-    // Replace markdown links to plain text like: "link label" (url)
+    // Include the JSON result schema and convert Markdown links to plain text for command help.
+    static descriptionForHelp() {
+        const description = (this.descriptionWithMarkdown ?? '').replace(/(\[)(.*?)(])(\()(.*?)(\))/gm, '"$2" ($5)');
+        return appendJsonOutputSchema(description, this.jsonOutputSchema);
+    }
+    /** @deprecated Use descriptionForHelp instead. */
     static descriptionWithoutMarkdown() {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return (this.descriptionWithMarkdown ?? '').replace(/(\[)(.*?)(])(\()(.*?)(\))/gm, '"$2" ($5)');
+        return this.descriptionForHelp();
     }
     static analyticsNameOverride() {
         return undefined;
@@ -34,6 +48,9 @@ class BaseCommand extends Command {
         await errorHandler(error, this.config);
         return Errors.handle(error);
     }
+    async _run() {
+        return runWithCommandEventsForCommand(this.argv, () => super._run());
+    }
     async init() {
         this.exitWithTimestampWhenEnvVariablePresent();
         setCurrentCommandId(this.id ?? '');
@@ -278,6 +295,18 @@ function argsFromEnvironment(environment, options, noDefaultsResult) {
 function commandSupportsFlag(flags, flagName) {
     return Boolean(flags) && Object.prototype.hasOwnProperty.call(flags, flagName);
 }
+function appendJsonOutputSchema(description, outputSchema) {
+    if (!outputSchema)
+        return description;
+    const jsonOutputDescription = `Use \`--json-schema\` to print the result, error, and event schemas.
+
+Output from \`--json\` conforms to the \`${outputSchema.name}\` schema.
+
+\`\`\`json
+${JSON.stringify(outputSchema.jsonSchema, null, 2)}
+\`\`\``;
+    return [description, jsonOutputDescription].filter(Boolean).join('\n\n');
+}
 async function removeDuplicatedPlugins(config) {
     const plugins = Array.from(config.plugins.values());
     const bundlePlugins = ['@shopify/app', '@shopify/plugin-cloudflare'];

package/dist/public/node/base-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../../../src/public/node/base-command.ts"],"names":[],"mappings":"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","sourcesContent":["import {isDevelopment} from './context/local.js'\nimport {addPublicMetadata} from './metadata.js'\nimport {AbortError} from './error.js'\nimport {outputContent, outputResult, outputToken} from './output.js'\nimport {setCurrentSessionAlias} from './session.js'\nimport {terminalSupportsPrompting} from './system.js'\nimport {hashString} from './crypto.js'\nimport {isTruthy} from './context/utilities.js'\nimport {setCurrentCommandId} from './global-context.js'\nimport {JsonMap} from '../../private/common/json.js'\nimport {underscore} from '../common/string.js'\nimport {Command, Config, Errors} from '@oclif/core'\nimport {OutputFlags, Input, ParserOutput, FlagInput, OutputArgs} from '@oclif/core/parser'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type ArgOutput = OutputArgs<any>\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type FlagOutput = OutputFlags<any>\n\nexport interface NonTTYFlagRequirement {\n  /** At least one of these flags must be present when the requirement applies. */\n  flags: string[]\n  /** Determines whether the requirement applies to the parsed flags. */\n  when?: (flags: FlagOutput) => boolean\n}\n\ninterface EnvironmentFlags {\n  'auth-alias'?: string\n  environment?: string[]\n  path?: string\n}\n\nabstract class BaseCommand extends Command {\n  static baseFlags: FlagInput<{}> = {}\n\n  public static get requiresSyncAnalytics(): boolean {\n    return false\n  }\n\n  public static nonTTYFlagRequirements(_flags: FlagOutput): NonTTYFlagRequirement[] {\n    return []\n  }\n\n  // Replace markdown links to plain text like: \"link label\" (url)\n  public static descriptionWithoutMarkdown(): string | undefined {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return ((this as any).descriptionWithMarkdown ?? '').replace(/(\\[)(.*?)(])(\\()(.*?)(\\))/gm, '\"$2\" ($5)')\n  }\n\n  public static analyticsNameOverride(): string | undefined {\n    return undefined\n  }\n\n  public static analyticsStopCommand(): string | undefined {\n    return undefined\n  }\n\n  async catch(error: Error & {skipOclifErrorHandling: boolean}): Promise<void> {\n    error.skipOclifErrorHandling = true\n    const {errorHandler} = await import('./error-handler.js')\n    await errorHandler(error, this.config)\n    return Errors.handle(error)\n  }\n\n  protected async init(): Promise<unknown> {\n    this.exitWithTimestampWhenEnvVariablePresent()\n    setCurrentCommandId(this.id ?? '')\n    if (!isDevelopment()) {\n      // This function runs just prior to `run`\n      const {registerCleanBugsnagErrorsFromWithinPlugins} = await import('./error-handler.js')\n      await registerCleanBugsnagErrorsFromWithinPlugins(this.config)\n    }\n    await removeDuplicatedPlugins(this.config)\n    this.showNpmFlagWarning()\n    const {showNotificationsIfNeeded} = await import('./notifications-system.js')\n    await showNotificationsIfNeeded()\n    return super.init()\n  }\n\n  // NPM creates an environment variable for every flag passed to a script.\n  // This function checks for the presence of any of the available CLI flags\n  // and warns the user to use the `--` separator.\n  protected showNpmFlagWarning(): void {\n    const commandVariables = this.constructor as unknown as {flags: JsonMap}\n    const commandFlags = Object.keys(commandVariables.flags || {})\n    const possibleNpmEnvVars = commandFlags.map((key) => `npm_config_${underscore(key).replace(/^no_/, '')}`)\n\n    if (possibleNpmEnvVars.some((flag) => process.env[flag] !== undefined)) {\n      // eslint-disable-next-line no-void\n      void import('./ui.js').then(({renderWarning}) => {\n        renderWarning({\n          body: [\n            'NPM scripts require an extra',\n            {command: '--'},\n            'separator to pass the flags. Example:',\n            {command: 'npm run dev -- --reset'},\n          ],\n        })\n      })\n    }\n  }\n\n  protected exitWithTimestampWhenEnvVariablePresent() {\n    if (isTruthy(process.env.SHOPIFY_CLI_ENV_STARTUP_PERFORMANCE_RUN)) {\n      outputResult(`\n      SHOPIFY_CLI_TIMESTAMP_START\n      { \"timestamp\": ${Date.now()} }\n      SHOPIFY_CLI_TIMESTAMP_END\n      `)\n      process.exit(0)\n    }\n  }\n\n  protected async parse<\n    TFlags extends FlagOutput & {path?: string; verbose?: boolean; 'auth-alias'?: string},\n    TGlobalFlags extends FlagOutput,\n    TArgs extends ArgOutput,\n  >(\n    options?: Input<TFlags, TGlobalFlags, TArgs>,\n    argv?: string[],\n  ): Promise<ParserOutput<TFlags, TGlobalFlags, TArgs> & {argv: string[]}> {\n    let result = await super.parse<TFlags, TGlobalFlags, TArgs>(options, argv)\n    result = await this.resultWithEnvironment<TFlags, TGlobalFlags, TArgs>(result, options, argv)\n    await setCurrentSessionAlias(result.flags['auth-alias'])\n    await addFromParsedFlags(result.flags)\n    this.failMissingNonTTYFlagRequirements(result.flags, this.applicableNonTTYFlagRequirements(result.flags))\n    return {...result, ...{argv: result.argv as string[]}}\n  }\n\n  protected environmentsFilename(): string | undefined {\n    // To be re-implemented if needed\n    return undefined\n  }\n\n  protected failMissingNonTTYFlags(flags: FlagOutput, requiredFlags: string[]): void {\n    this.failMissingNonTTYFlagRequirements(\n      flags,\n      requiredFlags.map((flag) => ({flags: [flag]})),\n    )\n  }\n\n  private failMissingNonTTYFlagRequirements(flags: FlagOutput, requirements: NonTTYFlagRequirement[]): void {\n    if (terminalSupportsPrompting()) return\n\n    const missingRequirements = requirements.filter((requirement) =>\n      requirement.flags.every((flag) => flags[flag] === undefined || flags[flag] === false),\n    )\n    if (missingRequirements.length === 0) return\n\n    const heading = missingRequirements.length === 1 ? 'Flag not specified' : 'Flags not specified'\n    const formattedRequirements = missingRequirements\n      .map((requirement) => requirement.flags.map((flag) => `--${flag}`).join(' or '))\n      .join('\\n')\n    const explanation = missingRequirements.length === 1 ? 'This flag is required' : 'These flags are required'\n\n    throw new AbortError(\n      outputContent`${heading}:\n\n${outputToken.cyan(formattedRequirements)}\n\n${explanation} in non-interactive terminal environments, such as a CI environment, or when piping input from another process.`,\n      'To resolve this, specify the options in the command, or run the command in an interactive environment such as your local terminal.',\n    )\n  }\n\n  private applicableNonTTYFlagRequirements(flags: FlagOutput): NonTTYFlagRequirement[] {\n    const command = this.constructor as unknown as {\n      flags?: FlagInput\n      baseFlags?: FlagInput\n      nonTTYFlagRequirements?: (flags: FlagOutput) => NonTTYFlagRequirement[]\n    }\n    const allFlags = {...command.baseFlags, ...command.flags}\n    const requirementsFromFlags = Object.entries(allFlags)\n      .filter(([, flag]) => Boolean((flag as {requiredIfNonInteractive?: boolean}).requiredIfNonInteractive))\n      .map(([name]) => ({flags: [name]}))\n    const commandRequirements = (command.nonTTYFlagRequirements?.(flags) ?? []).filter(\n      (requirement) => requirement.when?.(flags) ?? true,\n    )\n\n    return [...requirementsFromFlags, ...commandRequirements]\n  }\n\n  private async resultWithEnvironment<\n    TFlags extends FlagOutput & {path?: string; verbose?: boolean},\n    TGlobalFlags extends FlagOutput,\n    TArgs extends ArgOutput,\n  >(\n    originalResult: ParserOutput<TFlags, TGlobalFlags, TArgs>,\n    options?: Input<TFlags, TGlobalFlags, TArgs>,\n    argv?: string[],\n  ): Promise<ParserOutput<TFlags, TGlobalFlags, TArgs>> {\n    const flags = originalResult.flags as EnvironmentFlags\n    const environmentsFileName = this.environmentsFilename()\n\n    if (!environmentsFileName) return originalResult\n\n    const {environmentFilePath} = await import('./environments.js')\n    const environmentFileExists = await environmentFilePath(environmentsFileName, {from: flags.path})\n\n    // Handle both string and array cases for environment flag\n    let environments: string[] = []\n    if (flags.environment) {\n      environments = Array.isArray(flags.environment) ? flags.environment : [flags.environment]\n    }\n\n    const environmentSpecified = environments.length > 0\n\n    // Noop if no environment file exists and none was specified\n    if (!environmentFileExists && !environmentSpecified) return originalResult\n\n    // Noop if multiple environments were specified (let commands handle this)\n    if (environmentSpecified && environments.length > 1) return originalResult\n\n    const {environment, isDefaultEnvironment} = await this.loadEnvironmentForCommand(\n      flags.path,\n      environmentsFileName,\n      environments[0],\n    )\n\n    if (!environment) return originalResult\n    if (isDefaultEnvironment && !commandSupportsFlag(options?.flags, 'environment')) return originalResult\n\n    // Parse using noDefaultsOptions to derive a list of flags specified as\n    // command-line arguments.\n    const noDefaultsResult = await super.parse<TFlags, TGlobalFlags, TArgs>(noDefaultsOptions(options), argv)\n\n    // Add the environment's settings to argv and pass them to `super.parse`. This\n    // invokes oclif's validation system without breaking the oclif black box.\n    // Replace the original result with this one.\n    const result = await super.parse<TFlags, TGlobalFlags, TArgs>(options, [\n      // Need to specify argv default because we're merging with argsFromEnvironment.\n      ...(argv ?? this.argv),\n      ...argsFromEnvironment<TFlags, TGlobalFlags, TArgs>(environment, options, noDefaultsResult),\n      ...(isDefaultEnvironment ? ['--environment', 'default'] : []),\n    ])\n\n    // Report successful application of the environment.\n    reportEnvironmentApplication<TFlags, TGlobalFlags, TArgs>(\n      noDefaultsResult.flags,\n      result.flags,\n      isDefaultEnvironment ? 'default' : (environments[0] as string),\n      environment,\n    )\n\n    return result\n  }\n\n  /**\n   * Tries to load an environment to forward to the command. If no environment\n   * is specified it will try to load a default environment.\n   */\n  private async loadEnvironmentForCommand(\n    path: string | undefined,\n    environmentsFileName: string,\n    specifiedEnvironment: string | undefined,\n  ): Promise<{environment: JsonMap | undefined; isDefaultEnvironment: boolean}> {\n    const {loadEnvironment} = await import('./environments.js')\n    if (specifiedEnvironment) {\n      const environment = await loadEnvironment(specifiedEnvironment, environmentsFileName, {from: path})\n      return {environment, isDefaultEnvironment: false}\n    }\n\n    const environment = await loadEnvironment('default', environmentsFileName, {from: path, silent: true})\n    return {environment, isDefaultEnvironment: true}\n  }\n}\n\nexport async function addFromParsedFlags(flags: {path?: string; verbose?: boolean}): Promise<void> {\n  await addPublicMetadata(() => ({\n    cmd_all_verbose: flags.verbose,\n    cmd_all_path_override: flags.path !== undefined,\n    cmd_all_path_override_hash: flags.path === undefined ? undefined : hashString(flags.path),\n  }))\n}\n\n/**\n * Any flag which is:\n *\n * 1. Present in the final set of flags\n * 2. Specified in the environment\n * 3. Not specified by the user as a command line argument\n *\n * should be reported.\n *\n * It doesn't matter if the environment flag's value was the same as the default; from\n * the user's perspective, they want to know their environment was applied.\n */\nfunction reportEnvironmentApplication<\n  TFlags extends FlagOutput,\n  TGlobalFlags extends FlagOutput,\n  TArgs extends ArgOutput,\n>(\n  noDefaultsFlags: ParserOutput<TFlags, TGlobalFlags, TArgs>['flags'],\n  flagsWithEnvironments: ParserOutput<TFlags, TGlobalFlags, TArgs>['flags'],\n  environmentName: string,\n  environment: JsonMap,\n): void {\n  const changes: JsonMap = {}\n  for (const [name, value] of Object.entries(flagsWithEnvironments)) {\n    const userSpecifiedThisFlag = Object.prototype.hasOwnProperty.call(noDefaultsFlags, name)\n    const environmentContainsFlag = Object.prototype.hasOwnProperty.call(environment, name)\n    if (!userSpecifiedThisFlag && environmentContainsFlag) {\n      const valueToReport = name === 'password' ? `********${value.substr(-4)}` : value\n      changes[name] = valueToReport\n    }\n  }\n  if (Object.keys(changes).length === 0) return\n\n  const items = Object.entries(changes).map(([name, value]) => `${name}: ${value}`)\n  // eslint-disable-next-line no-void\n  void import('./ui.js').then(({renderInfo}) => {\n    renderInfo({\n      headline: ['Using applicable flags from', {userInput: environmentName}, 'environment:'],\n      body: [{list: {items}}],\n    })\n  })\n}\n\n/**\n * Strips the defaults from configured flags. For example, if flags contains:\n *\n * ```\n *   someFlag: Flags.boolean({\n *     description: 'some flag',\n *     default: false\n *   })\n * ```\n *\n * it becomes:\n *\n * ```\n *   someFlag: Flags.boolean({\n *     description: 'some flag'\n *   })\n * ```\n *\n * If we parse using this configuration, the only specified flags will be those\n * the user actually passed on the command line.\n */\nexport function noDefaultsOptions<TFlags extends FlagOutput, TGlobalFlags extends FlagOutput, TArgs extends ArgOutput>(\n  options: Input<TFlags, TGlobalFlags, TArgs> | undefined,\n): Input<TFlags, TGlobalFlags, TArgs> | undefined {\n  if (!options?.flags) return options\n  return {\n    ...options,\n    flags: Object.fromEntries(\n      Object.entries(options.flags).map(([label, settings]) => {\n        const copiedSettings = {...(settings as {default?: unknown})}\n        delete copiedSettings.default\n        return [label, copiedSettings]\n      }),\n    ) as FlagInput<TFlags>,\n  }\n}\n\n/**\n * Converts the environment's settings to arguments as though passed on the command\n * line, skipping any arguments the user specified on the command line.\n */\nfunction argsFromEnvironment<TFlags extends FlagOutput, TGlobalFlags extends FlagOutput, TArgs extends ArgOutput>(\n  environment: JsonMap,\n  options: Input<TFlags, TGlobalFlags, TArgs> | undefined,\n  noDefaultsResult: ParserOutput<TFlags, TArgs>,\n): string[] {\n  const args: string[] = []\n  for (const [label, value] of Object.entries(environment)) {\n    const flagIsRelevantToCommand = commandSupportsFlag(options?.flags, label)\n    const userSpecifiedThisFlag =\n      noDefaultsResult.flags && Object.prototype.hasOwnProperty.call(noDefaultsResult.flags, label)\n    if (flagIsRelevantToCommand && !userSpecifiedThisFlag) {\n      if (typeof value === 'boolean') {\n        if (value) {\n          args.push(`--${label}`)\n        } else {\n          throw new AbortError(\n            outputContent`Environments can only specify true for boolean flags. Attempted to set ${outputToken.yellow(\n              label,\n            )} to false.`,\n          )\n        }\n      } else if (Array.isArray(value)) {\n        value.forEach((element) => args.push(`--${label}`, `${element}`))\n      } else {\n        args.push(`--${label}`, `${value}`)\n      }\n    }\n  }\n  return args\n}\n\nfunction commandSupportsFlag(flags: FlagInput | undefined, flagName: string): boolean {\n  return Boolean(flags) && Object.prototype.hasOwnProperty.call(flags, flagName)\n}\n\nasync function removeDuplicatedPlugins(config: Config): Promise<void> {\n  const plugins = Array.from(config.plugins.values())\n  const bundlePlugins = ['@shopify/app', '@shopify/plugin-cloudflare']\n  const pluginsToRemove = plugins.filter((plugin) => bundlePlugins.includes(plugin.name))\n  if (pluginsToRemove.length > 0) {\n    const commandsToRun = pluginsToRemove.map((plugin) => `  - shopify plugins remove ${plugin.name}`).join('\\n')\n    const {renderWarning} = await import('./ui.js')\n    renderWarning({\n      headline: `Unsupported plugins detected: ${pluginsToRemove.map((plugin) => plugin.name).join(', ')}`,\n      body: [\n        'They are already included in the CLI and installing them as custom plugins can cause conflicts.',\n        `You can fix it by running:\\n${commandsToRun}`,\n      ],\n    })\n  }\n  const filteredPlugins = plugins.filter((plugin) => !bundlePlugins.includes(plugin.name))\n  // eslint-disable-next-line require-atomic-updates -- config.plugins won't be modified by renderWarning above\n  config.plugins = new Map(filteredPlugins.map((plugin) => [plugin.name, plugin]))\n}\n\nexport default BaseCommand\n"]}
+{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../../../src/public/node/base-command.ts"],"names":[],"mappings":"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","sourcesContent":["import {isDevelopment} from './context/local.js'\nimport {addPublicMetadata} from './metadata.js'\nimport {AbortError} from './error.js'\nimport {runWithCommandEventsForCommand} from './command-events.js'\nimport {outputContent, outputResult, outputToken} from './output.js'\nimport {setCurrentSessionAlias} from './session.js'\nimport {terminalSupportsPrompting} from './system.js'\nimport {hashString} from './crypto.js'\nimport {isTruthy} from './context/utilities.js'\nimport {setCurrentCommandId} from './global-context.js'\nimport {type JsonOutputSchema} from './json-output-schema.js'\nimport {JsonMap} from '../../private/common/json.js'\nimport {underscore} from '../common/string.js'\nimport {Command, Config, Errors, Flags} from '@oclif/core'\nimport {OutputFlags, Input, ParserOutput, FlagInput, OutputArgs} from '@oclif/core/parser'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type ArgOutput = OutputArgs<any>\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type FlagOutput = OutputFlags<any>\n\nexport interface NonTTYFlagRequirement {\n  /** At least one of these flags must be present when the requirement applies. */\n  flags: string[]\n  /** Determines whether the requirement applies to the parsed flags. */\n  when?: (flags: FlagOutput) => boolean\n}\n\ninterface EnvironmentFlags {\n  'auth-alias'?: string\n  environment?: string[]\n  path?: string\n}\n\nabstract class BaseCommand extends Command {\n  static baseFlags: FlagInput<{}> = {\n    'json-schema': Flags.boolean({\n      description: \"Print the command's JSON schemas.\",\n      env: 'SHOPIFY_FLAG_JSON_SCHEMA',\n    }),\n  }\n\n  static descriptionWithMarkdown?: string\n\n  public static get jsonOutputSchema(): JsonOutputSchema | undefined {\n    return undefined\n  }\n\n  public static get requiresSyncAnalytics(): boolean {\n    return false\n  }\n\n  public static nonTTYFlagRequirements(_flags: FlagOutput): NonTTYFlagRequirement[] {\n    return []\n  }\n\n  // Include the JSON result schema and convert Markdown links to plain text for command help.\n  public static descriptionForHelp(): string | undefined {\n    const description = (this.descriptionWithMarkdown ?? '').replace(/(\\[)(.*?)(])(\\()(.*?)(\\))/gm, '\"$2\" ($5)')\n    return appendJsonOutputSchema(description, this.jsonOutputSchema)\n  }\n\n  /** @deprecated Use descriptionForHelp instead. */\n  public static descriptionWithoutMarkdown(): string | undefined {\n    return this.descriptionForHelp()\n  }\n\n  public static analyticsNameOverride(): string | undefined {\n    return undefined\n  }\n\n  public static analyticsStopCommand(): string | undefined {\n    return undefined\n  }\n\n  async catch(error: Error & {skipOclifErrorHandling: boolean}): Promise<void> {\n    error.skipOclifErrorHandling = true\n    const {errorHandler} = await import('./error-handler.js')\n    await errorHandler(error, this.config)\n    return Errors.handle(error)\n  }\n\n  protected async _run<T>(): Promise<T> {\n    return runWithCommandEventsForCommand(this.argv, () => super._run<T>())\n  }\n\n  protected async init(): Promise<unknown> {\n    this.exitWithTimestampWhenEnvVariablePresent()\n    setCurrentCommandId(this.id ?? '')\n    if (!isDevelopment()) {\n      // This function runs just prior to `run`\n      const {registerCleanBugsnagErrorsFromWithinPlugins} = await import('./error-handler.js')\n      await registerCleanBugsnagErrorsFromWithinPlugins(this.config)\n    }\n    await removeDuplicatedPlugins(this.config)\n    this.showNpmFlagWarning()\n    const {showNotificationsIfNeeded} = await import('./notifications-system.js')\n    await showNotificationsIfNeeded()\n    return super.init()\n  }\n\n  // NPM creates an environment variable for every flag passed to a script.\n  // This function checks for the presence of any of the available CLI flags\n  // and warns the user to use the `--` separator.\n  protected showNpmFlagWarning(): void {\n    const commandVariables = this.constructor as unknown as {flags: JsonMap}\n    const commandFlags = Object.keys(commandVariables.flags || {})\n    const possibleNpmEnvVars = commandFlags.map((key) => `npm_config_${underscore(key).replace(/^no_/, '')}`)\n\n    if (possibleNpmEnvVars.some((flag) => process.env[flag] !== undefined)) {\n      // eslint-disable-next-line no-void\n      void import('./ui.js').then(({renderWarning}) => {\n        renderWarning({\n          body: [\n            'NPM scripts require an extra',\n            {command: '--'},\n            'separator to pass the flags. Example:',\n            {command: 'npm run dev -- --reset'},\n          ],\n        })\n      })\n    }\n  }\n\n  protected exitWithTimestampWhenEnvVariablePresent() {\n    if (isTruthy(process.env.SHOPIFY_CLI_ENV_STARTUP_PERFORMANCE_RUN)) {\n      outputResult(`\n      SHOPIFY_CLI_TIMESTAMP_START\n      { \"timestamp\": ${Date.now()} }\n      SHOPIFY_CLI_TIMESTAMP_END\n      `)\n      process.exit(0)\n    }\n  }\n\n  protected async parse<\n    TFlags extends FlagOutput & {path?: string; verbose?: boolean; 'auth-alias'?: string},\n    TGlobalFlags extends FlagOutput,\n    TArgs extends ArgOutput,\n  >(\n    options?: Input<TFlags, TGlobalFlags, TArgs>,\n    argv?: string[],\n  ): Promise<ParserOutput<TFlags, TGlobalFlags, TArgs> & {argv: string[]}> {\n    let result = await super.parse<TFlags, TGlobalFlags, TArgs>(options, argv)\n    result = await this.resultWithEnvironment<TFlags, TGlobalFlags, TArgs>(result, options, argv)\n    await setCurrentSessionAlias(result.flags['auth-alias'])\n    await addFromParsedFlags(result.flags)\n    this.failMissingNonTTYFlagRequirements(result.flags, this.applicableNonTTYFlagRequirements(result.flags))\n    return {...result, ...{argv: result.argv as string[]}}\n  }\n\n  protected environmentsFilename(): string | undefined {\n    // To be re-implemented if needed\n    return undefined\n  }\n\n  protected failMissingNonTTYFlags(flags: FlagOutput, requiredFlags: string[]): void {\n    this.failMissingNonTTYFlagRequirements(\n      flags,\n      requiredFlags.map((flag) => ({flags: [flag]})),\n    )\n  }\n\n  private failMissingNonTTYFlagRequirements(flags: FlagOutput, requirements: NonTTYFlagRequirement[]): void {\n    if (terminalSupportsPrompting()) return\n\n    const missingRequirements = requirements.filter((requirement) =>\n      requirement.flags.every((flag) => flags[flag] === undefined || flags[flag] === false),\n    )\n    if (missingRequirements.length === 0) return\n\n    const heading = missingRequirements.length === 1 ? 'Flag not specified' : 'Flags not specified'\n    const formattedRequirements = missingRequirements\n      .map((requirement) => requirement.flags.map((flag) => `--${flag}`).join(' or '))\n      .join('\\n')\n    const explanation = missingRequirements.length === 1 ? 'This flag is required' : 'These flags are required'\n\n    throw new AbortError(\n      outputContent`${heading}:\n\n${outputToken.cyan(formattedRequirements)}\n\n${explanation} in non-interactive terminal environments, such as a CI environment, or when piping input from another process.`,\n      'To resolve this, specify the options in the command, or run the command in an interactive environment such as your local terminal.',\n    )\n  }\n\n  private applicableNonTTYFlagRequirements(flags: FlagOutput): NonTTYFlagRequirement[] {\n    const command = this.constructor as unknown as {\n      flags?: FlagInput\n      baseFlags?: FlagInput\n      nonTTYFlagRequirements?: (flags: FlagOutput) => NonTTYFlagRequirement[]\n    }\n    const allFlags = {...command.baseFlags, ...command.flags}\n    const requirementsFromFlags = Object.entries(allFlags)\n      .filter(([, flag]) => Boolean((flag as {requiredIfNonInteractive?: boolean}).requiredIfNonInteractive))\n      .map(([name]) => ({flags: [name]}))\n    const commandRequirements = (command.nonTTYFlagRequirements?.(flags) ?? []).filter(\n      (requirement) => requirement.when?.(flags) ?? true,\n    )\n\n    return [...requirementsFromFlags, ...commandRequirements]\n  }\n\n  private async resultWithEnvironment<\n    TFlags extends FlagOutput & {path?: string; verbose?: boolean},\n    TGlobalFlags extends FlagOutput,\n    TArgs extends ArgOutput,\n  >(\n    originalResult: ParserOutput<TFlags, TGlobalFlags, TArgs>,\n    options?: Input<TFlags, TGlobalFlags, TArgs>,\n    argv?: string[],\n  ): Promise<ParserOutput<TFlags, TGlobalFlags, TArgs>> {\n    const flags = originalResult.flags as EnvironmentFlags\n    const environmentsFileName = this.environmentsFilename()\n\n    if (!environmentsFileName) return originalResult\n\n    const {environmentFilePath} = await import('./environments.js')\n    const environmentFileExists = await environmentFilePath(environmentsFileName, {from: flags.path})\n\n    // Handle both string and array cases for environment flag\n    let environments: string[] = []\n    if (flags.environment) {\n      environments = Array.isArray(flags.environment) ? flags.environment : [flags.environment]\n    }\n\n    const environmentSpecified = environments.length > 0\n\n    // Noop if no environment file exists and none was specified\n    if (!environmentFileExists && !environmentSpecified) return originalResult\n\n    // Noop if multiple environments were specified (let commands handle this)\n    if (environmentSpecified && environments.length > 1) return originalResult\n\n    const {environment, isDefaultEnvironment} = await this.loadEnvironmentForCommand(\n      flags.path,\n      environmentsFileName,\n      environments[0],\n    )\n\n    if (!environment) return originalResult\n    if (isDefaultEnvironment && !commandSupportsFlag(options?.flags, 'environment')) return originalResult\n\n    // Parse using noDefaultsOptions to derive a list of flags specified as\n    // command-line arguments.\n    const noDefaultsResult = await super.parse<TFlags, TGlobalFlags, TArgs>(noDefaultsOptions(options), argv)\n\n    // Add the environment's settings to argv and pass them to `super.parse`. This\n    // invokes oclif's validation system without breaking the oclif black box.\n    // Replace the original result with this one.\n    const result = await super.parse<TFlags, TGlobalFlags, TArgs>(options, [\n      // Need to specify argv default because we're merging with argsFromEnvironment.\n      ...(argv ?? this.argv),\n      ...argsFromEnvironment<TFlags, TGlobalFlags, TArgs>(environment, options, noDefaultsResult),\n      ...(isDefaultEnvironment ? ['--environment', 'default'] : []),\n    ])\n\n    // Report successful application of the environment.\n    reportEnvironmentApplication<TFlags, TGlobalFlags, TArgs>(\n      noDefaultsResult.flags,\n      result.flags,\n      isDefaultEnvironment ? 'default' : (environments[0] as string),\n      environment,\n    )\n\n    return result\n  }\n\n  /**\n   * Tries to load an environment to forward to the command. If no environment\n   * is specified it will try to load a default environment.\n   */\n  private async loadEnvironmentForCommand(\n    path: string | undefined,\n    environmentsFileName: string,\n    specifiedEnvironment: string | undefined,\n  ): Promise<{environment: JsonMap | undefined; isDefaultEnvironment: boolean}> {\n    const {loadEnvironment} = await import('./environments.js')\n    if (specifiedEnvironment) {\n      const environment = await loadEnvironment(specifiedEnvironment, environmentsFileName, {from: path})\n      return {environment, isDefaultEnvironment: false}\n    }\n\n    const environment = await loadEnvironment('default', environmentsFileName, {from: path, silent: true})\n    return {environment, isDefaultEnvironment: true}\n  }\n}\n\nexport async function addFromParsedFlags(flags: {path?: string; verbose?: boolean}): Promise<void> {\n  await addPublicMetadata(() => ({\n    cmd_all_verbose: flags.verbose,\n    cmd_all_path_override: flags.path !== undefined,\n    cmd_all_path_override_hash: flags.path === undefined ? undefined : hashString(flags.path),\n  }))\n}\n\n/**\n * Any flag which is:\n *\n * 1. Present in the final set of flags\n * 2. Specified in the environment\n * 3. Not specified by the user as a command line argument\n *\n * should be reported.\n *\n * It doesn't matter if the environment flag's value was the same as the default; from\n * the user's perspective, they want to know their environment was applied.\n */\nfunction reportEnvironmentApplication<\n  TFlags extends FlagOutput,\n  TGlobalFlags extends FlagOutput,\n  TArgs extends ArgOutput,\n>(\n  noDefaultsFlags: ParserOutput<TFlags, TGlobalFlags, TArgs>['flags'],\n  flagsWithEnvironments: ParserOutput<TFlags, TGlobalFlags, TArgs>['flags'],\n  environmentName: string,\n  environment: JsonMap,\n): void {\n  const changes: JsonMap = {}\n  for (const [name, value] of Object.entries(flagsWithEnvironments)) {\n    const userSpecifiedThisFlag = Object.prototype.hasOwnProperty.call(noDefaultsFlags, name)\n    const environmentContainsFlag = Object.prototype.hasOwnProperty.call(environment, name)\n    if (!userSpecifiedThisFlag && environmentContainsFlag) {\n      const valueToReport = name === 'password' ? `********${value.substr(-4)}` : value\n      changes[name] = valueToReport\n    }\n  }\n  if (Object.keys(changes).length === 0) return\n\n  const items = Object.entries(changes).map(([name, value]) => `${name}: ${value}`)\n  // eslint-disable-next-line no-void\n  void import('./ui.js').then(({renderInfo}) => {\n    renderInfo({\n      headline: ['Using applicable flags from', {userInput: environmentName}, 'environment:'],\n      body: [{list: {items}}],\n    })\n  })\n}\n\n/**\n * Strips the defaults from configured flags. For example, if flags contains:\n *\n * ```\n *   someFlag: Flags.boolean({\n *     description: 'some flag',\n *     default: false\n *   })\n * ```\n *\n * it becomes:\n *\n * ```\n *   someFlag: Flags.boolean({\n *     description: 'some flag'\n *   })\n * ```\n *\n * If we parse using this configuration, the only specified flags will be those\n * the user actually passed on the command line.\n */\nexport function noDefaultsOptions<TFlags extends FlagOutput, TGlobalFlags extends FlagOutput, TArgs extends ArgOutput>(\n  options: Input<TFlags, TGlobalFlags, TArgs> | undefined,\n): Input<TFlags, TGlobalFlags, TArgs> | undefined {\n  if (!options?.flags) return options\n  return {\n    ...options,\n    flags: Object.fromEntries(\n      Object.entries(options.flags).map(([label, settings]) => {\n        const copiedSettings = {...(settings as {default?: unknown})}\n        delete copiedSettings.default\n        return [label, copiedSettings]\n      }),\n    ) as FlagInput<TFlags>,\n  }\n}\n\n/**\n * Converts the environment's settings to arguments as though passed on the command\n * line, skipping any arguments the user specified on the command line.\n */\nfunction argsFromEnvironment<TFlags extends FlagOutput, TGlobalFlags extends FlagOutput, TArgs extends ArgOutput>(\n  environment: JsonMap,\n  options: Input<TFlags, TGlobalFlags, TArgs> | undefined,\n  noDefaultsResult: ParserOutput<TFlags, TArgs>,\n): string[] {\n  const args: string[] = []\n  for (const [label, value] of Object.entries(environment)) {\n    const flagIsRelevantToCommand = commandSupportsFlag(options?.flags, label)\n    const userSpecifiedThisFlag =\n      noDefaultsResult.flags && Object.prototype.hasOwnProperty.call(noDefaultsResult.flags, label)\n    if (flagIsRelevantToCommand && !userSpecifiedThisFlag) {\n      if (typeof value === 'boolean') {\n        if (value) {\n          args.push(`--${label}`)\n        } else {\n          throw new AbortError(\n            outputContent`Environments can only specify true for boolean flags. Attempted to set ${outputToken.yellow(\n              label,\n            )} to false.`,\n          )\n        }\n      } else if (Array.isArray(value)) {\n        value.forEach((element) => args.push(`--${label}`, `${element}`))\n      } else {\n        args.push(`--${label}`, `${value}`)\n      }\n    }\n  }\n  return args\n}\n\nfunction commandSupportsFlag(flags: FlagInput | undefined, flagName: string): boolean {\n  return Boolean(flags) && Object.prototype.hasOwnProperty.call(flags, flagName)\n}\n\nfunction appendJsonOutputSchema(description: string, outputSchema: JsonOutputSchema | undefined): string {\n  if (!outputSchema) return description\n\n  const jsonOutputDescription = `Use \\`--json-schema\\` to print the result, error, and event schemas.\n\nOutput from \\`--json\\` conforms to the \\`${outputSchema.name}\\` schema.\n\n\\`\\`\\`json\n${JSON.stringify(outputSchema.jsonSchema, null, 2)}\n\\`\\`\\``\n\n  return [description, jsonOutputDescription].filter(Boolean).join('\\n\\n')\n}\n\nasync function removeDuplicatedPlugins(config: Config): Promise<void> {\n  const plugins = Array.from(config.plugins.values())\n  const bundlePlugins = ['@shopify/app', '@shopify/plugin-cloudflare']\n  const pluginsToRemove = plugins.filter((plugin) => bundlePlugins.includes(plugin.name))\n  if (pluginsToRemove.length > 0) {\n    const commandsToRun = pluginsToRemove.map((plugin) => `  - shopify plugins remove ${plugin.name}`).join('\\n')\n    const {renderWarning} = await import('./ui.js')\n    renderWarning({\n      headline: `Unsupported plugins detected: ${pluginsToRemove.map((plugin) => plugin.name).join(', ')}`,\n      body: [\n        'They are already included in the CLI and installing them as custom plugins can cause conflicts.',\n        `You can fix it by running:\\n${commandsToRun}`,\n      ],\n    })\n  }\n  const filteredPlugins = plugins.filter((plugin) => !bundlePlugins.includes(plugin.name))\n  // eslint-disable-next-line require-atomic-updates -- config.plugins won't be modified by renderWarning above\n  config.plugins = new Map(filteredPlugins.map((plugin) => [plugin.name, plugin]))\n}\n\nexport default BaseCommand\n"]}

package/dist/public/node/cli-launcher.js

@@ -1,3 +1,4 @@
+import { isTruthy } from './context/utilities.js';
 import { fileURLToPath } from 'node:url';
 /**
  * Launches the CLI.
@@ -20,14 +21,31 @@ export async function launchCLI(options) {
         if (options.lazyCommandLoader) {
             config.setLazyCommandLoader(options.lazyCommandLoader);
         }
-        await run(options.argv, config);
+        const argv = options.argv ?? process.argv.slice(2);
+        const passthroughIndex = argv.indexOf('--');
+        const commandArguments = passthroughIndex === -1 ? argv : argv.slice(0, passthroughIndex);
+        if (commandArguments.includes('--json-schema') || isTruthy(process.env.SHOPIFY_FLAG_JSON_SCHEMA)) {
+            // Inspect the command before Oclif runs init or prerun hooks, which may require a project or start background work.
+            const { printCommandJsonSchema } = await import('../../private/node/command-json-schema.js');
+            await printCommandJsonSchema(config, argv, options.lazyCommandLoader);
+            return;
+        }
+        await run(argv, config);
         await flush();
         // eslint-disable-next-line no-catch-all/no-catch-all
     }
     catch (error) {
         const { errorHandler } = await import('./error-handler.js');
         await errorHandler(error);
-        return Errors.handle(error);
+        const handledError = error;
+        // Suppress duplicate output without mutating the thrown value, which may be frozen or null.
+        return Errors.handle({
+            ...handledError,
+            name: handledError?.name ?? 'Error',
+            message: handledError?.message ?? String(error),
+            stack: handledError?.stack,
+            skipOclifErrorHandling: true,
+        });
     }
 }
 //# sourceMappingURL=cli-launcher.js.map

package/dist/public/node/cli-launcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-launcher.js","sourceRoot":"","sources":["../../../src/public/node/cli-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAA;AAStC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAgB;IAC9C,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAA;IAC1D,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAA;IAEhE,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;IAC/C,4FAA4F;IAC5F,MAAM,EAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAC,GACjC,WAAiD,CAAC,OAAO,IAAI,WAAW,CAAA;IAE3E,IAAI,aAAa,EAAE,EAAE,CAAC;QACpB,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAA;IACvB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,EAAC,CAAC,CAAA;QAC1E,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QAEnB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC9B,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QACxD,CAAC;QAED,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC/B,MAAM,KAAK,EAAE,CAAA;QACb,qDAAqD;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAC,YAAY,EAAC,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAA;QACzD,MAAM,YAAY,CAAC,KAAc,CAAC,CAAA;QAClC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAc,CAAC,CAAA;IACtC,CAAC;AACH,CAAC","sourcesContent":["import {fileURLToPath} from 'node:url'\nimport type {LazyCommandLoader} from './custom-oclif-loader.js'\n\ninterface Options {\n  moduleURL: string\n  argv?: string[]\n  lazyCommandLoader?: LazyCommandLoader\n}\n\n/**\n * Launches the CLI.\n *\n * @param options - Options.\n * @returns A promise that resolves when the CLI has been launched.\n */\nexport async function launchCLI(options: Options): Promise<void> {\n  const {isDevelopment} = await import('./context/local.js')\n  const {ShopifyConfig} = await import('./custom-oclif-loader.js')\n  type OclifCore = typeof import('@oclif/core')\n  const oclifModule = await import('@oclif/core')\n  // esbuild wraps CJS dynamic imports under .default when bundling as ESM with code splitting\n  const {run, flush, Errors, settings}: OclifCore =\n    (oclifModule as OclifCore & {default?: OclifCore}).default ?? oclifModule\n\n  if (isDevelopment()) {\n    settings.debug = true\n  }\n\n  try {\n    const config = new ShopifyConfig({root: fileURLToPath(options.moduleURL)})\n    await config.load()\n\n    if (options.lazyCommandLoader) {\n      config.setLazyCommandLoader(options.lazyCommandLoader)\n    }\n\n    await run(options.argv, config)\n    await flush()\n    // eslint-disable-next-line no-catch-all/no-catch-all\n  } catch (error) {\n    const {errorHandler} = await import('./error-handler.js')\n    await errorHandler(error as Error)\n    return Errors.handle(error as Error)\n  }\n}\n"]}
+{"version":3,"file":"cli-launcher.js","sourceRoot":"","sources":["../../../src/public/node/cli-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAA;AAC/C,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAA;AAStC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAgB;IAC9C,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAA;IAC1D,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAA;IAEhE,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;IAC/C,4FAA4F;IAC5F,MAAM,EAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAC,GACjC,WAAiD,CAAC,OAAO,IAAI,WAAW,CAAA;IAE3E,IAAI,aAAa,EAAE,EAAE,CAAC;QACpB,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAA;IACvB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,EAAC,CAAC,CAAA;QAC1E,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QAEnB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC9B,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QACxD,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QAClD,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC3C,MAAM,gBAAgB,GAAG,gBAAgB,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAA;QACzF,IAAI,gBAAgB,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,CAAC;YACjG,oHAAoH;YACpH,MAAM,EAAC,sBAAsB,EAAC,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAA;YAC1F,MAAM,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;YACrE,OAAM;QACR,CAAC;QAED,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACvB,MAAM,KAAK,EAAE,CAAA;QACb,qDAAqD;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAC,YAAY,EAAC,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAA;QACzD,MAAM,YAAY,CAAC,KAAc,CAAC,CAAA;QAClC,MAAM,YAAY,GAAG,KAAiC,CAAA;QACtD,4FAA4F;QAC5F,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,YAAY;YACf,IAAI,EAAE,YAAY,EAAE,IAAI,IAAI,OAAO;YACnC,OAAO,EAAE,YAAY,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC;YAC/C,KAAK,EAAE,YAAY,EAAE,KAAK;YAC1B,sBAAsB,EAAE,IAAI;SAC7B,CAAC,CAAA;IACJ,CAAC;AACH,CAAC","sourcesContent":["import {isTruthy} from './context/utilities.js'\nimport {fileURLToPath} from 'node:url'\nimport type {LazyCommandLoader} from './custom-oclif-loader.js'\n\ninterface Options {\n  moduleURL: string\n  argv?: string[]\n  lazyCommandLoader?: LazyCommandLoader\n}\n\n/**\n * Launches the CLI.\n *\n * @param options - Options.\n * @returns A promise that resolves when the CLI has been launched.\n */\nexport async function launchCLI(options: Options): Promise<void> {\n  const {isDevelopment} = await import('./context/local.js')\n  const {ShopifyConfig} = await import('./custom-oclif-loader.js')\n  type OclifCore = typeof import('@oclif/core')\n  const oclifModule = await import('@oclif/core')\n  // esbuild wraps CJS dynamic imports under .default when bundling as ESM with code splitting\n  const {run, flush, Errors, settings}: OclifCore =\n    (oclifModule as OclifCore & {default?: OclifCore}).default ?? oclifModule\n\n  if (isDevelopment()) {\n    settings.debug = true\n  }\n\n  try {\n    const config = new ShopifyConfig({root: fileURLToPath(options.moduleURL)})\n    await config.load()\n\n    if (options.lazyCommandLoader) {\n      config.setLazyCommandLoader(options.lazyCommandLoader)\n    }\n\n    const argv = options.argv ?? process.argv.slice(2)\n    const passthroughIndex = argv.indexOf('--')\n    const commandArguments = passthroughIndex === -1 ? argv : argv.slice(0, passthroughIndex)\n    if (commandArguments.includes('--json-schema') || isTruthy(process.env.SHOPIFY_FLAG_JSON_SCHEMA)) {\n      // Inspect the command before Oclif runs init or prerun hooks, which may require a project or start background work.\n      const {printCommandJsonSchema} = await import('../../private/node/command-json-schema.js')\n      await printCommandJsonSchema(config, argv, options.lazyCommandLoader)\n      return\n    }\n\n    await run(argv, config)\n    await flush()\n    // eslint-disable-next-line no-catch-all/no-catch-all\n  } catch (error) {\n    const {errorHandler} = await import('./error-handler.js')\n    await errorHandler(error as Error)\n    const handledError = error as Error | null | undefined\n    // Suppress duplicate output without mutating the thrown value, which may be frozen or null.\n    return Errors.handle({\n      ...handledError,\n      name: handledError?.name ?? 'Error',\n      message: handledError?.message ?? String(error),\n      stack: handledError?.stack,\n      skipOclifErrorHandling: true,\n    })\n  }\n}\n"]}

package/dist/public/node/cli.d.ts

@@ -35,6 +35,7 @@ export declare function runCreateCLI(options: RunCLIOptions, launchCLI?: (option
 export declare const globalFlags: {
     'no-color': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    'no-input': import("@oclif/core/interfaces").BooleanFlag<boolean>;
 };
 export declare const jsonFlag: {
     json: import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/public/node/cli.js

@@ -1,4 +1,5 @@
 import { isTruthy } from './context/utilities.js';
+import { noInputFlag } from './no-input.js';
 import { launchCLI as defaultLaunchCli } from './cli-launcher.js';
 import { environmentVariables } from '../../private/node/constants.js';
 import { Flags } from '@oclif/core';
@@ -87,6 +88,7 @@ export async function runCreateCLI(options, launchCLI = defaultLaunchCli, argv =
  * are shared across all the commands.
  */
 export const globalFlags = {
+    ...noInputFlag,
     'no-color': Flags.boolean({
         hidden: false,
         description: 'Disable color output.',