@shopify/cli-kit 0.0.0-snapshot-20261009114709 → 0.0.0-snapshot-20261009150933

package/dist/private/node/json-error.d.ts

@@ -1,16 +1,3 @@
-interface FatalErrorLike {
-    type?: number;
-    message?: unknown;
-    formattedMessage?: unknown;
-    tryMessage?: unknown;
-    nextSteps?: unknown;
-    customSections?: unknown;
-    stack?: unknown;
-    command?: unknown;
-    args?: unknown;
-    details?: unknown;
-    code?: unknown;
-}
 /**
  * Writes the public JSON representation of a fatal error to stdout.
  *
@@ -19,5 +6,4 @@ interface FatalErrorLike {
  *
  * @param error - Fatal error to serialize.
  */
-export declare function renderFatalErrorAsJson(error: FatalErrorLike): void;
-export {};
+export declare function renderFatalErrorAsJson(error: unknown): void;

package/dist/private/node/json-error.js

@@ -1,101 +1,7 @@
-import { tokenItemToJsonString } from './ui/components/token-item.js';
 import { FatalErrorType } from '../../public/node/error.js';
 import { jsonErrorOutputSchema } from '../../public/node/error/schema.js';
-import { outputResult, unstyled } from '../../public/node/output.js';
-function externalCommand(error) {
-    if (typeof error.command !== 'string' || !Array.isArray(error.args))
-        return;
-    if (!error.args.every((arg) => typeof arg === 'string'))
-        return;
-    return { command: error.command, args: error.args };
-}
-function jsonErrorType(error, external) {
-    if (error.type === FatalErrorType.Abort) {
-        return external ? 'external' : 'abort';
-    }
-    return 'bug';
-}
-function jsonTokenItem(token) {
-    if (token === null || token === undefined)
-        return;
-    try {
-        const message = tokenItemToJsonString(token);
-        return typeof message === 'string' ? unstyled(message) : undefined;
-    }
-    catch (error) {
-        if (error instanceof TypeError)
-            return undefined;
-        throw error;
-    }
-}
-function jsonTokenItems(items) {
-    if (!Array.isArray(items))
-        return;
-    const renderedItems = items.map(jsonTokenItem).filter((item) => item !== undefined);
-    return renderedItems.length > 0 ? renderedItems : undefined;
-}
-function jsonTable(data) {
-    if (!Array.isArray(data))
-        return;
-    return data
-        .filter((row) => Array.isArray(row))
-        .map((row) => row.map((cell) => jsonTokenItem(cell) ?? ''));
-}
-function jsonCustomSection(section) {
-    if (typeof section !== 'object' || section === null || !('body' in section))
-        return;
-    const title = 'title' in section && typeof section.title === 'string' ? unstyled(section.title) : undefined;
-    const sectionBody = section.body;
-    const body = typeof sectionBody === 'object' && sectionBody !== null && 'tabularData' in sectionBody
-        ? jsonTable(sectionBody.tabularData)
-        : jsonTokenItem(sectionBody);
-    if (body === undefined)
-        return;
-    return { ...(title ? { title } : {}), body };
-}
-function jsonCustomSections(sections) {
-    if (!Array.isArray(sections))
-        return;
-    const renderedSections = sections
-        .map(jsonCustomSection)
-        .filter((section) => section !== undefined);
-    return renderedSections.length > 0 ? renderedSections : undefined;
-}
-function jsonErrorDocument(error) {
-    if (error.type === FatalErrorType.AbortSilent)
-        return;
-    const external = externalCommand(error);
-    const type = jsonErrorType(error, external);
-    const formattedMessage = jsonTokenItem(error.formattedMessage);
-    const message = formattedMessage ?? (typeof error.message === 'string' ? unstyled(error.message) : 'Unknown error');
-    const tryMessage = jsonTokenItem(error.tryMessage);
-    const nextSteps = jsonTokenItems(error.nextSteps);
-    const customSections = jsonCustomSections(error.customSections);
-    const details = error.details;
-    const commonFields = {
-        message,
-        ...(typeof error.code === 'string' && error.code.length > 0 ? { code: error.code } : {}),
-        ...(tryMessage === undefined ? {} : { tryMessage }),
-        ...(nextSteps === undefined ? {} : { nextSteps }),
-        ...(customSections === undefined ? {} : { customSections }),
-        ...(details === undefined ? {} : { details }),
-    };
-    let jsonError;
-    if (type === 'bug') {
-        jsonError = {
-            type,
-            ...commonFields,
-            ...(typeof error.stack === 'string' ? { stack: unstyled(error.stack) } : {}),
-        };
-    }
-    else if (type === 'external' && external) {
-        jsonError = { type, ...commonFields, ...external };
-    }
-    else {
-        jsonError = { type: 'abort', ...commonFields };
-    }
-    return { error: jsonError };
-}
+import { errorToJson } from '../../public/node/error/serialization.js';
+import { outputResult } from '../../public/node/output.js';
 /**
  * Writes the public JSON representation of a fatal error to stdout.
  *
@@ -107,9 +13,9 @@ function jsonErrorDocument(error) {
 export function renderFatalErrorAsJson(error) {
     let serializedDocument;
     try {
-        const document = jsonErrorDocument(error);
-        if (!document)
+        if (typeof error === 'object' && error !== null && 'type' in error && error.type === FatalErrorType.AbortSilent)
             return;
+        const document = { error: errorToJson(error) };
         serializedDocument = JSON.stringify(jsonErrorOutputSchema.validate(document));
         // Serialization must not replace the JSON contract with a text banner.
         // eslint-disable-next-line no-catch-all/no-catch-all

package/dist/private/node/json-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"json-error.js","sourceRoot":"","sources":["../../../src/private/node/json-error.ts"],"names":[],"mappings":"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","sourcesContent":["import {tokenItemToJsonString, type TokenItem} from './ui/components/token-item.js'\nimport {FatalErrorType} from '../../public/node/error.js'\nimport {jsonErrorOutputSchema} from '../../public/node/error/schema.js'\nimport {outputResult, unstyled} from '../../public/node/output.js'\nimport type {\n  JsonError,\n  JsonErrorCustomSection,\n  JsonErrorDocument,\n  JsonErrorType,\n} from '../../public/node/error/types.js'\n\ninterface FatalErrorLike {\n  type?: number\n  message?: unknown\n  formattedMessage?: unknown\n  tryMessage?: unknown\n  nextSteps?: unknown\n  customSections?: unknown\n  stack?: unknown\n  command?: unknown\n  args?: unknown\n  details?: unknown\n  code?: unknown\n}\n\ninterface ExternalCommand {\n  command: string\n  args: string[]\n}\n\nfunction externalCommand(error: FatalErrorLike): ExternalCommand | undefined {\n  if (typeof error.command !== 'string' || !Array.isArray(error.args)) return\n  if (!error.args.every((arg) => typeof arg === 'string')) return\n\n  return {command: error.command, args: error.args}\n}\n\nfunction jsonErrorType(error: FatalErrorLike, external: ExternalCommand | undefined): JsonErrorType {\n  if (error.type === FatalErrorType.Abort) {\n    return external ? 'external' : 'abort'\n  }\n  return 'bug'\n}\n\nfunction jsonTokenItem(token: unknown): string | undefined {\n  if (token === null || token === undefined) return\n\n  try {\n    const message = tokenItemToJsonString(token as TokenItem)\n    return typeof message === 'string' ? unstyled(message) : undefined\n  } catch (error) {\n    if (error instanceof TypeError) return undefined\n    throw error\n  }\n}\n\nfunction jsonTokenItems(items: unknown): string[] | undefined {\n  if (!Array.isArray(items)) return\n\n  const renderedItems = items.map(jsonTokenItem).filter((item): item is string => item !== undefined)\n  return renderedItems.length > 0 ? renderedItems : undefined\n}\n\nfunction jsonTable(data: unknown): string[][] | undefined {\n  if (!Array.isArray(data)) return\n\n  return data\n    .filter((row): row is unknown[] => Array.isArray(row))\n    .map((row) => row.map((cell) => jsonTokenItem(cell) ?? ''))\n}\n\nfunction jsonCustomSection(section: unknown): JsonErrorCustomSection | undefined {\n  if (typeof section !== 'object' || section === null || !('body' in section)) return\n\n  const title = 'title' in section && typeof section.title === 'string' ? unstyled(section.title) : undefined\n  const sectionBody = section.body\n  const body =\n    typeof sectionBody === 'object' && sectionBody !== null && 'tabularData' in sectionBody\n      ? jsonTable(sectionBody.tabularData)\n      : jsonTokenItem(sectionBody)\n\n  if (body === undefined) return\n  return {...(title ? {title} : {}), body}\n}\n\nfunction jsonCustomSections(sections: unknown): JsonErrorCustomSection[] | undefined {\n  if (!Array.isArray(sections)) return\n\n  const renderedSections = sections\n    .map(jsonCustomSection)\n    .filter((section): section is JsonErrorCustomSection => section !== undefined)\n  return renderedSections.length > 0 ? renderedSections : undefined\n}\n\nfunction jsonErrorDocument(error: FatalErrorLike): JsonErrorDocument | undefined {\n  if (error.type === FatalErrorType.AbortSilent) return\n\n  const external = externalCommand(error)\n  const type = jsonErrorType(error, external)\n  const formattedMessage = jsonTokenItem(error.formattedMessage)\n  const message = formattedMessage ?? (typeof error.message === 'string' ? unstyled(error.message) : 'Unknown error')\n  const tryMessage = jsonTokenItem(error.tryMessage)\n  const nextSteps = jsonTokenItems(error.nextSteps)\n  const customSections = jsonCustomSections(error.customSections)\n  const details = error.details\n\n  const commonFields = {\n    message,\n    ...(typeof error.code === 'string' && error.code.length > 0 ? {code: error.code} : {}),\n    ...(tryMessage === undefined ? {} : {tryMessage}),\n    ...(nextSteps === undefined ? {} : {nextSteps}),\n    ...(customSections === undefined ? {} : {customSections}),\n    ...(details === undefined ? {} : {details}),\n  }\n\n  let jsonError: JsonError\n  if (type === 'bug') {\n    jsonError = {\n      type,\n      ...commonFields,\n      ...(typeof error.stack === 'string' ? {stack: unstyled(error.stack)} : {}),\n    }\n  } else if (type === 'external' && external) {\n    jsonError = {type, ...commonFields, ...external}\n  } else {\n    jsonError = {type: 'abort', ...commonFields}\n  }\n\n  return {error: jsonError}\n}\n\n/**\n * Writes the public JSON representation of a fatal error to stdout.\n *\n * The allow-list mirrors the meaningful content of the regular fatal-error renderer.\n * Arbitrary error properties remain private and are never copied to stdout.\n *\n * @param error - Fatal error to serialize.\n */\nexport function renderFatalErrorAsJson(error: FatalErrorLike): void {\n  let serializedDocument: string\n  try {\n    const document = jsonErrorDocument(error)\n    if (!document) return\n    serializedDocument = JSON.stringify(jsonErrorOutputSchema.validate(document))\n    // Serialization must not replace the JSON contract with a text banner.\n    // eslint-disable-next-line no-catch-all/no-catch-all\n  } catch {\n    serializedDocument = JSON.stringify({error: {type: 'bug', message: 'Failed to serialize the error as JSON.'}})\n  }\n\n  // Keep write failures separate: retrying after a partial write could corrupt stdout.\n  outputResult(serializedDocument)\n}\n"]}
+{"version":3,"file":"json-error.js","sourceRoot":"","sources":["../../../src/private/node/json-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAC,qBAAqB,EAAC,MAAM,mCAAmC,CAAA;AACvE,OAAO,EAAC,WAAW,EAAC,MAAM,0CAA0C,CAAA;AACpE,OAAO,EAAC,YAAY,EAAC,MAAM,6BAA6B,CAAA;AAExD;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,IAAI,kBAA0B,CAAA;IAC9B,IAAI,CAAC;QACH,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,WAAW;YAC7G,OAAM;QACR,MAAM,QAAQ,GAAG,EAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EAAC,CAAA;QAC5C,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC7E,uEAAuE;QACvE,qDAAqD;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAC,KAAK,EAAE,EAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,wCAAwC,EAAC,EAAC,CAAC,CAAA;IAChH,CAAC;IAED,qFAAqF;IACrF,YAAY,CAAC,kBAAkB,CAAC,CAAA;AAClC,CAAC","sourcesContent":["import {FatalErrorType} from '../../public/node/error.js'\nimport {jsonErrorOutputSchema} from '../../public/node/error/schema.js'\nimport {errorToJson} from '../../public/node/error/serialization.js'\nimport {outputResult} from '../../public/node/output.js'\n\n/**\n * Writes the public JSON representation of a fatal error to stdout.\n *\n * The allow-list mirrors the meaningful content of the regular fatal-error renderer.\n * Arbitrary error properties remain private and are never copied to stdout.\n *\n * @param error - Fatal error to serialize.\n */\nexport function renderFatalErrorAsJson(error: unknown): void {\n  let serializedDocument: string\n  try {\n    if (typeof error === 'object' && error !== null && 'type' in error && error.type === FatalErrorType.AbortSilent)\n      return\n    const document = {error: errorToJson(error)}\n    serializedDocument = JSON.stringify(jsonErrorOutputSchema.validate(document))\n    // Serialization must not replace the JSON contract with a text banner.\n    // eslint-disable-next-line no-catch-all/no-catch-all\n  } catch {\n    serializedDocument = JSON.stringify({error: {type: 'bug', message: 'Failed to serialize the error as JSON.'}})\n  }\n\n  // Keep write failures separate: retrying after a partial write could corrupt stdout.\n  outputResult(serializedDocument)\n}\n"]}

package/dist/public/common/version.d.ts

@@ -1 +1 @@
-export declare const CLI_KIT_VERSION = "0.0.0-snapshot-20261009114709";
+export declare const CLI_KIT_VERSION = "0.0.0-snapshot-20261009150933";

package/dist/public/common/version.js

@@ -1,2 +1,2 @@
-export const CLI_KIT_VERSION = '0.0.0-snapshot-20261009114709';
+export const CLI_KIT_VERSION = '0.0.0-snapshot-20261009150933';
 //# sourceMappingURL=version.js.map

package/dist/public/common/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/public/common/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,+BAA+B,CAAA","sourcesContent":["export const CLI_KIT_VERSION = '0.0.0-snapshot-20261009114709'\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/public/common/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,+BAA+B,CAAA","sourcesContent":["export const CLI_KIT_VERSION = '0.0.0-snapshot-20261009150933'\n"]}

package/dist/public/node/error/serialization.d.ts

@@ -0,0 +1,8 @@
+import type { JsonError } from './types.js';
+/**
+ * Projects an error into the shared JSON error contract, retaining only allowlisted fields.
+ *
+ * @param source - Error to project.
+ * @returns The error classification, message, and available recovery information.
+ */
+export declare function errorToJson(source: unknown): JsonError;

package/dist/public/node/error/serialization.js

@@ -0,0 +1,103 @@
+import { FatalErrorType } from './index.js';
+import { tokenItemToJsonString } from '../../../private/node/ui/components/token-item.js';
+import { unstyled } from '../output.js';
+function externalCommand(error) {
+    if (typeof error.command !== 'string' || !Array.isArray(error.args))
+        return;
+    if (!error.args.every((arg) => typeof arg === 'string'))
+        return;
+    return { command: error.command, args: error.args };
+}
+function jsonErrorType(error, external) {
+    if (error.type === FatalErrorType.Abort) {
+        return external ? 'external' : 'abort';
+    }
+    return 'bug';
+}
+function jsonTokenItem(token) {
+    if (token === null || token === undefined)
+        return;
+    try {
+        const message = tokenItemToJsonString(token);
+        return typeof message === 'string' ? unstyled(message) : undefined;
+    }
+    catch (error) {
+        if (error instanceof TypeError)
+            return undefined;
+        throw error;
+    }
+}
+function jsonTokenItems(items) {
+    if (!Array.isArray(items))
+        return;
+    const renderedItems = items.map(jsonTokenItem).filter((item) => item !== undefined);
+    return renderedItems.length > 0 ? renderedItems : undefined;
+}
+function jsonTable(data) {
+    if (!Array.isArray(data))
+        return;
+    return data
+        .filter((row) => Array.isArray(row))
+        .map((row) => row.map((cell) => jsonTokenItem(cell) ?? ''));
+}
+function jsonCustomSection(section) {
+    if (typeof section !== 'object' || section === null || !('body' in section))
+        return;
+    const title = 'title' in section && typeof section.title === 'string' ? unstyled(section.title) : undefined;
+    const sectionBody = section.body;
+    const body = typeof sectionBody === 'object' && sectionBody !== null && 'tabularData' in sectionBody
+        ? jsonTable(sectionBody.tabularData)
+        : jsonTokenItem(sectionBody);
+    if (body === undefined)
+        return;
+    return { ...(title ? { title } : {}), body };
+}
+function jsonCustomSections(sections) {
+    if (!Array.isArray(sections))
+        return;
+    const renderedSections = sections
+        .map(jsonCustomSection)
+        .filter((section) => section !== undefined);
+    return renderedSections.length > 0 ? renderedSections : undefined;
+}
+/**
+ * Projects an error into the shared JSON error contract, retaining only allowlisted fields.
+ *
+ * @param source - Error to project.
+ * @returns The error classification, message, and available recovery information.
+ */
+export function errorToJson(source) {
+    const error = typeof source === 'object' && source !== null ? source : { message: source };
+    const external = externalCommand(error);
+    const type = jsonErrorType(error, external);
+    const formattedMessage = jsonTokenItem(error.formattedMessage);
+    const message = formattedMessage ?? (typeof error.message === 'string' ? unstyled(error.message) : 'Unknown error');
+    const tryMessage = jsonTokenItem(error.tryMessage);
+    const nextSteps = jsonTokenItems(error.nextSteps);
+    const customSections = jsonCustomSections(error.customSections);
+    const details = error.details;
+    const commonFields = {
+        message,
+        ...(typeof error.code === 'string' && error.code.length > 0 ? { code: error.code } : {}),
+        ...(tryMessage === undefined ? {} : { tryMessage }),
+        ...(nextSteps === undefined ? {} : { nextSteps }),
+        ...(customSections === undefined ? {} : { customSections }),
+        ...(details === undefined ? {} : { details }),
+    };
+    let jsonError;
+    if (type === 'bug') {
+        jsonError = {
+            type,
+            ...commonFields,
+            ...(typeof error.stack === 'string' ? { stack: unstyled(error.stack) } : {}),
+        };
+    }
+    else if (type === 'external' && external) {
+        jsonError = { type, ...commonFields, ...external };
+    }
+    else {
+        jsonError = { type: 'abort', ...commonFields };
+    }
+    return jsonError;
+}
+//# sourceMappingURL=serialization.js.map

package/dist/public/node/error/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../../../src/public/node/error/serialization.ts"],"names":[],"mappings":"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","sourcesContent":["import {FatalErrorType} from './index.js'\nimport {tokenItemToJsonString, type TokenItem} from '../../../private/node/ui/components/token-item.js'\nimport {unstyled} from '../output.js'\nimport type {JsonError, JsonErrorCustomSection, JsonErrorType} from './types.js'\n\ninterface FatalErrorLike {\n  type?: number\n  message?: unknown\n  formattedMessage?: unknown\n  tryMessage?: unknown\n  nextSteps?: unknown\n  customSections?: unknown\n  stack?: unknown\n  command?: unknown\n  args?: unknown\n  details?: unknown\n  code?: unknown\n}\n\ninterface ExternalCommand {\n  command: string\n  args: string[]\n}\n\nfunction externalCommand(error: FatalErrorLike): ExternalCommand | undefined {\n  if (typeof error.command !== 'string' || !Array.isArray(error.args)) return\n  if (!error.args.every((arg) => typeof arg === 'string')) return\n\n  return {command: error.command, args: error.args}\n}\n\nfunction jsonErrorType(error: FatalErrorLike, external: ExternalCommand | undefined): JsonErrorType {\n  if (error.type === FatalErrorType.Abort) {\n    return external ? 'external' : 'abort'\n  }\n  return 'bug'\n}\n\nfunction jsonTokenItem(token: unknown): string | undefined {\n  if (token === null || token === undefined) return\n\n  try {\n    const message = tokenItemToJsonString(token as TokenItem)\n    return typeof message === 'string' ? unstyled(message) : undefined\n  } catch (error) {\n    if (error instanceof TypeError) return undefined\n    throw error\n  }\n}\n\nfunction jsonTokenItems(items: unknown): string[] | undefined {\n  if (!Array.isArray(items)) return\n\n  const renderedItems = items.map(jsonTokenItem).filter((item): item is string => item !== undefined)\n  return renderedItems.length > 0 ? renderedItems : undefined\n}\n\nfunction jsonTable(data: unknown): string[][] | undefined {\n  if (!Array.isArray(data)) return\n\n  return data\n    .filter((row): row is unknown[] => Array.isArray(row))\n    .map((row) => row.map((cell) => jsonTokenItem(cell) ?? ''))\n}\n\nfunction jsonCustomSection(section: unknown): JsonErrorCustomSection | undefined {\n  if (typeof section !== 'object' || section === null || !('body' in section)) return\n\n  const title = 'title' in section && typeof section.title === 'string' ? unstyled(section.title) : undefined\n  const sectionBody = section.body\n  const body =\n    typeof sectionBody === 'object' && sectionBody !== null && 'tabularData' in sectionBody\n      ? jsonTable(sectionBody.tabularData)\n      : jsonTokenItem(sectionBody)\n\n  if (body === undefined) return\n  return {...(title ? {title} : {}), body}\n}\n\nfunction jsonCustomSections(sections: unknown): JsonErrorCustomSection[] | undefined {\n  if (!Array.isArray(sections)) return\n\n  const renderedSections = sections\n    .map(jsonCustomSection)\n    .filter((section): section is JsonErrorCustomSection => section !== undefined)\n  return renderedSections.length > 0 ? renderedSections : undefined\n}\n\n/**\n * Projects an error into the shared JSON error contract, retaining only allowlisted fields.\n *\n * @param source - Error to project.\n * @returns The error classification, message, and available recovery information.\n */\nexport function errorToJson(source: unknown): JsonError {\n  const error: FatalErrorLike = typeof source === 'object' && source !== null ? source : {message: source}\n\n  const external = externalCommand(error)\n  const type = jsonErrorType(error, external)\n  const formattedMessage = jsonTokenItem(error.formattedMessage)\n  const message = formattedMessage ?? (typeof error.message === 'string' ? unstyled(error.message) : 'Unknown error')\n  const tryMessage = jsonTokenItem(error.tryMessage)\n  const nextSteps = jsonTokenItems(error.nextSteps)\n  const customSections = jsonCustomSections(error.customSections)\n  const details = error.details\n\n  const commonFields = {\n    message,\n    ...(typeof error.code === 'string' && error.code.length > 0 ? {code: error.code} : {}),\n    ...(tryMessage === undefined ? {} : {tryMessage}),\n    ...(nextSteps === undefined ? {} : {nextSteps}),\n    ...(customSections === undefined ? {} : {customSections}),\n    ...(details === undefined ? {} : {details}),\n  }\n\n  let jsonError: JsonError\n  if (type === 'bug') {\n    jsonError = {\n      type,\n      ...commonFields,\n      ...(typeof error.stack === 'string' ? {stack: unstyled(error.stack)} : {}),\n    }\n  } else if (type === 'external' && external) {\n    jsonError = {type, ...commonFields, ...external}\n  } else {\n    jsonError = {type: 'abort', ...commonFields}\n  }\n\n  return jsonError\n}\n"]}

package/dist/public/node/upgrade/output.d.ts

@@ -0,0 +1,17 @@
+import { Writable } from 'node:stream';
+/**
+ * Keeps package-manager output off the result channel in JSON mode.
+ *
+ * @returns Streams for package-manager diagnostics, or the original terminal streams.
+ */
+export declare function upgradeOutputStreams(): {
+    stdout: Writable;
+    stderr: Writable;
+};
+/**
+ * Runs a global upgrade with terminal input and format-appropriate diagnostics.
+ *
+ * @param command - The package-manager executable.
+ * @param args - The install arguments.
+ */
+export declare function execUpgradeCommand(command: string, args: string[]): Promise<void>;

package/dist/public/node/upgrade/output.js

@@ -0,0 +1,51 @@
+import { commandEventOutputMode } from '../command-events.js';
+import { outputInfo } from '../output.js';
+import { exec } from '../system.js';
+import { Writable } from 'node:stream';
+import { StringDecoder } from 'node:string_decoder';
+/**
+ * Keeps package-manager output off the result channel in JSON mode.
+ *
+ * @returns Streams for package-manager diagnostics, or the original terminal streams.
+ */
+export function upgradeOutputStreams() {
+    if (commandEventOutputMode() !== 'json')
+        return { stdout: process.stdout, stderr: process.stderr };
+    return { stdout: diagnosticStream(), stderr: diagnosticStream() };
+}
+function diagnosticStream() {
+    const decoder = new StringDecoder('utf8');
+    return new Writable({
+        write(chunk, _encoding, callback) {
+            const message = decoder.write(chunk);
+            if (message)
+                outputInfo(message);
+            callback();
+        },
+        final(callback) {
+            const message = decoder.end();
+            if (message)
+                outputInfo(message);
+            callback();
+        },
+    });
+}
+/**
+ * Runs a global upgrade with terminal input and format-appropriate diagnostics.
+ *
+ * @param command - The package-manager executable.
+ * @param args - The install arguments.
+ */
+export async function execUpgradeCommand(command, args) {
+    const streams = upgradeOutputStreams();
+    try {
+        await exec(command, args, streams.stdout === process.stdout ? { stdio: 'inherit' } : { stdin: 'inherit', ...streams });
+    }
+    finally {
+        if (streams.stdout !== process.stdout)
+            streams.stdout.end();
+        if (streams.stderr !== process.stderr)
+            streams.stderr.end();
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/public/node/upgrade/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../../src/public/node/upgrade/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,sBAAsB,EAAC,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA;AACvC,OAAO,EAAC,IAAI,EAAC,MAAM,cAAc,CAAA;AACjC,OAAO,EAAC,QAAQ,EAAC,MAAM,aAAa,CAAA;AACpC,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAA;AAEjD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,sBAAsB,EAAE,KAAK,MAAM;QAAE,OAAO,EAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAC,CAAA;IAEhG,OAAO,EAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAC,CAAA;AACjE,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAA;IACzC,OAAO,IAAI,QAAQ,CAAC;QAClB,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ;YAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YACpC,IAAI,OAAO;gBAAE,UAAU,CAAC,OAAO,CAAC,CAAA;YAChC,QAAQ,EAAE,CAAA;QACZ,CAAC;QACD,KAAK,CAAC,QAAQ;YACZ,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;YAC7B,IAAI,OAAO;gBAAE,UAAU,CAAC,OAAO,CAAC,CAAA;YAChC,QAAQ,EAAE,CAAA;QACZ,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAe,EAAE,IAAc;IACtE,MAAM,OAAO,GAAG,oBAAoB,EAAE,CAAA;IACtC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,SAAS,EAAC,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,EAAC,CAAC,CAAA;IACpH,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAA;QAC3D,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAA;IAC7D,CAAC;AACH,CAAC","sourcesContent":["import {commandEventOutputMode} from '../command-events.js'\nimport {outputInfo} from '../output.js'\nimport {exec} from '../system.js'\nimport {Writable} from 'node:stream'\nimport {StringDecoder} from 'node:string_decoder'\n\n/**\n * Keeps package-manager output off the result channel in JSON mode.\n *\n * @returns Streams for package-manager diagnostics, or the original terminal streams.\n */\nexport function upgradeOutputStreams(): {stdout: Writable; stderr: Writable} {\n  if (commandEventOutputMode() !== 'json') return {stdout: process.stdout, stderr: process.stderr}\n\n  return {stdout: diagnosticStream(), stderr: diagnosticStream()}\n}\n\nfunction diagnosticStream(): Writable {\n  const decoder = new StringDecoder('utf8')\n  return new Writable({\n    write(chunk, _encoding, callback) {\n      const message = decoder.write(chunk)\n      if (message) outputInfo(message)\n      callback()\n    },\n    final(callback) {\n      const message = decoder.end()\n      if (message) outputInfo(message)\n      callback()\n    },\n  })\n}\n\n/**\n * Runs a global upgrade with terminal input and format-appropriate diagnostics.\n *\n * @param command - The package-manager executable.\n * @param args - The install arguments.\n */\nexport async function execUpgradeCommand(command: string, args: string[]): Promise<void> {\n  const streams = upgradeOutputStreams()\n  try {\n    await exec(command, args, streams.stdout === process.stdout ? {stdio: 'inherit'} : {stdin: 'inherit', ...streams})\n  } finally {\n    if (streams.stdout !== process.stdout) streams.stdout.end()\n    if (streams.stderr !== process.stderr) streams.stderr.end()\n  }\n}\n"]}

package/dist/public/node/upgrade/result.d.ts

@@ -0,0 +1,8 @@
+import { type UpgradeResult } from './types.js';
+/**
+ * Presents the upgrade result without changing progress or package-manager output.
+ *
+ * @param result - The completed upgrade outcome.
+ * @param format - The output format selected by the caller.
+ */
+export declare function presentUpgradeResult(result: UpgradeResult, format: 'json' | 'text'): void;

package/dist/public/node/upgrade/result.js

@@ -0,0 +1,21 @@
+import { upgradeJsonOutputSchema } from './types.js';
+import { outputResult } from '../output.js';
+import { renderSuccess } from '../ui.js';
+/**
+ * Presents the upgrade result without changing progress or package-manager output.
+ *
+ * @param result - The completed upgrade outcome.
+ * @param format - The output format selected by the caller.
+ */
+export function presentUpgradeResult(result, format) {
+    if (format === 'json') {
+        outputResult(upgradeJsonOutputSchema.encode(result));
+    }
+    else if (result.status === 'success' && result.scope === 'global') {
+        renderSuccess({
+            headline: 'Shopify CLI upgraded.',
+            body: `You're now on version ${result.version}.`,
+        });
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/public/node/upgrade/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../../src/public/node/upgrade/result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,uBAAuB,EAAqB,MAAM,YAAY,CAAA;AACtE,OAAO,EAAC,YAAY,EAAC,MAAM,cAAc,CAAA;AACzC,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAA;AAEtC;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAqB,EAAE,MAAuB;IACjF,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,YAAY,CAAC,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;IACtD,CAAC;SAAM,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACpE,aAAa,CAAC;YACZ,QAAQ,EAAE,uBAAuB;YACjC,IAAI,EAAE,yBAAyB,MAAM,CAAC,OAAO,GAAG;SACjD,CAAC,CAAA;IACJ,CAAC;AACH,CAAC","sourcesContent":["import {upgradeJsonOutputSchema, type UpgradeResult} from './types.js'\nimport {outputResult} from '../output.js'\nimport {renderSuccess} from '../ui.js'\n\n/**\n * Presents the upgrade result without changing progress or package-manager output.\n *\n * @param result - The completed upgrade outcome.\n * @param format - The output format selected by the caller.\n */\nexport function presentUpgradeResult(result: UpgradeResult, format: 'json' | 'text'): void {\n  if (format === 'json') {\n    outputResult(upgradeJsonOutputSchema.encode(result))\n  } else if (result.status === 'success' && result.scope === 'global') {\n    renderSuccess({\n      headline: 'Shopify CLI upgraded.',\n      body: `You're now on version ${result.version}.`,\n    })\n  }\n}\n"]}

package/dist/public/node/upgrade/types.d.ts

@@ -0,0 +1,61 @@
+import { type InferJsonOutputSchema } from '../json-output-schema.js';
+import { zod } from '../schema.js';
+export declare const upgradeJsonOutputSchema: import("../json-output-schema.js").JsonOutputSchema<zod.ZodUnion<[zod.ZodObject<{
+    status: zod.ZodLiteral<"success">;
+    changed: zod.ZodBoolean;
+    scope: zod.ZodLiteral<"global">;
+    previousVersion: zod.ZodString;
+    version: zod.ZodString;
+    packageManager: zod.ZodEnum<["npm", "pnpm", "yarn", "bun", "homebrew"]>;
+}, "strict", zod.ZodTypeAny, {
+    status: "success";
+    version: string;
+    scope: "global";
+    changed: boolean;
+    previousVersion: string;
+    packageManager: "yarn" | "npm" | "pnpm" | "bun" | "homebrew";
+}, {
+    status: "success";
+    version: string;
+    scope: "global";
+    changed: boolean;
+    previousVersion: string;
+    packageManager: "yarn" | "npm" | "pnpm" | "bun" | "homebrew";
+}>, zod.ZodObject<{
+    status: zod.ZodLiteral<"success">;
+    changed: zod.ZodNull;
+    scope: zod.ZodLiteral<"local">;
+    directory: zod.ZodEffects<zod.ZodEffects<zod.ZodString, string, string>, string, string>;
+    previousVersion: zod.ZodString;
+    availableVersion: zod.ZodNullable<zod.ZodString>;
+    packages: zod.ZodArray<zod.ZodString, "many">;
+}, "strict", zod.ZodTypeAny, {
+    status: "success";
+    directory: string;
+    scope: "local";
+    changed: null;
+    previousVersion: string;
+    availableVersion: string | null;
+    packages: string[];
+}, {
+    status: "success";
+    directory: string;
+    scope: "local";
+    changed: null;
+    previousVersion: string;
+    availableVersion: string | null;
+    packages: string[];
+}>, zod.ZodObject<{
+    status: zod.ZodLiteral<"skipped">;
+    reason: zod.ZodEnum<["development", "local-autoupgrade", "dependency-not-found"]>;
+    scope: zod.ZodEnum<["global", "local"]>;
+}, "strict", zod.ZodTypeAny, {
+    status: "skipped";
+    scope: "local" | "global";
+    reason: "development" | "local-autoupgrade" | "dependency-not-found";
+}, {
+    status: "skipped";
+    scope: "local" | "global";
+    reason: "development" | "local-autoupgrade" | "dependency-not-found";
+}>]>>;
+export type UpgradeResult = InferJsonOutputSchema<typeof upgradeJsonOutputSchema>;

package/dist/public/node/upgrade/types.js

@@ -0,0 +1,46 @@
+import { defineJsonOutputSchema } from '../json-output-schema.js';
+import { isAbsolutePath } from '../path.js';
+import { zod } from '../schema.js';
+// eslint-disable-next-line no-restricted-imports -- JSON filesystem paths use native platform separators.
+import { resolve } from 'node:path';
+export const upgradeJsonOutputSchema = defineJsonOutputSchema({
+    name: 'UpgradeResult',
+    schema: zod.union([
+        zod
+            .object({
+            status: zod.literal('success'),
+            changed: zod.boolean().describe('Whether the verified installed version differs from previousVersion.'),
+            scope: zod.literal('global'),
+            previousVersion: zod.string().min(1),
+            version: zod.string().min(1),
+            packageManager: zod.enum(['npm', 'pnpm', 'yarn', 'bun', 'homebrew']),
+        })
+            .strict(),
+        zod
+            .object({
+            status: zod.literal('success'),
+            changed: zod.null().describe('Null because local dependency changes and installed versions are not verified.'),
+            scope: zod.literal('local'),
+            directory: zod
+                .string()
+                .refine(isAbsolutePath, 'Must be an absolute filesystem path.')
+                .transform((directory) => resolve(directory)),
+            previousVersion: zod.string().min(1),
+            availableVersion: zod
+                .string()
+                .min(1)
+                .nullable()
+                .describe('The available registry version, or null when unknown.'),
+            packages: zod.array(zod.string().min(1)),
+        })
+            .strict(),
+        zod
+            .object({
+            status: zod.literal('skipped'),
+            reason: zod.enum(['development', 'local-autoupgrade', 'dependency-not-found']),
+            scope: zod.enum(['global', 'local']),
+        })
+            .strict(),
+    ]),
+});
+//# sourceMappingURL=types.js.map

package/dist/public/node/upgrade/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/public/node/upgrade/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,sBAAsB,EAA6B,MAAM,0BAA0B,CAAA;AAC3F,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AACzC,OAAO,EAAC,GAAG,EAAC,MAAM,cAAc,CAAA;AAChC,0GAA0G;AAC1G,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AAEjC,MAAM,CAAC,MAAM,uBAAuB,GAAG,sBAAsB,CAAC;IAC5D,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC;QAChB,GAAG;aACA,MAAM,CAAC;YACN,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;YAC9B,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;YACvG,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC5B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACpC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5B,cAAc,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;SACrE,CAAC;aACD,MAAM,EAAE;QACX,GAAG;aACA,MAAM,CAAC;YACN,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;YAC9B,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,gFAAgF,CAAC;YAC9G,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;YAC3B,SAAS,EAAE,GAAG;iBACX,MAAM,EAAE;iBACR,MAAM,CAAC,cAAc,EAAE,sCAAsC,CAAC;iBAC9D,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC/C,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACpC,gBAAgB,EAAE,GAAG;iBAClB,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,uDAAuD,CAAC;YACpE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACzC,CAAC;aACD,MAAM,EAAE;QACX,GAAG;aACA,MAAM,CAAC;YACN,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;YAC9B,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,mBAAmB,EAAE,sBAAsB,CAAC,CAAC;YAC9E,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;SACrC,CAAC;aACD,MAAM,EAAE;KACZ,CAAC;CACH,CAAC,CAAA","sourcesContent":["import {defineJsonOutputSchema, type InferJsonOutputSchema} from '../json-output-schema.js'\nimport {isAbsolutePath} from '../path.js'\nimport {zod} from '../schema.js'\n// eslint-disable-next-line no-restricted-imports -- JSON filesystem paths use native platform separators.\nimport {resolve} from 'node:path'\n\nexport const upgradeJsonOutputSchema = defineJsonOutputSchema({\n  name: 'UpgradeResult',\n  schema: zod.union([\n    zod\n      .object({\n        status: zod.literal('success'),\n        changed: zod.boolean().describe('Whether the verified installed version differs from previousVersion.'),\n        scope: zod.literal('global'),\n        previousVersion: zod.string().min(1),\n        version: zod.string().min(1),\n        packageManager: zod.enum(['npm', 'pnpm', 'yarn', 'bun', 'homebrew']),\n      })\n      .strict(),\n    zod\n      .object({\n        status: zod.literal('success'),\n        changed: zod.null().describe('Null because local dependency changes and installed versions are not verified.'),\n        scope: zod.literal('local'),\n        directory: zod\n          .string()\n          .refine(isAbsolutePath, 'Must be an absolute filesystem path.')\n          .transform((directory) => resolve(directory)),\n        previousVersion: zod.string().min(1),\n        availableVersion: zod\n          .string()\n          .min(1)\n          .nullable()\n          .describe('The available registry version, or null when unknown.'),\n        packages: zod.array(zod.string().min(1)),\n      })\n      .strict(),\n    zod\n      .object({\n        status: zod.literal('skipped'),\n        reason: zod.enum(['development', 'local-autoupgrade', 'dependency-not-found']),\n        scope: zod.enum(['global', 'local']),\n      })\n      .strict(),\n  ]),\n})\n\nexport type UpgradeResult = InferJsonOutputSchema<typeof upgradeJsonOutputSchema>\n"]}

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

@@ -1,4 +1,5 @@
 import { getAutoUpgradeEnabled, setAutoUpgradeEnabled } from '../../private/node/conf-store.js';
+import type { UpgradeResult } from './upgrade/types.js';
 export { getAutoUpgradeEnabled, setAutoUpgradeEnabled };
 /**
  * Utility function for generating an install command for the user to run
@@ -27,6 +28,13 @@ export interface RunCLIUpgradeOptions {
  * @throws AbortError if the package manager or command cannot be determined.
  */
 export declare function runCLIUpgrade(options?: RunCLIUpgradeOptions): Promise<void>;
+/**
+ * Upgrades the CLI and returns the outcome independently of final presentation.
+ *
+ * @param options - Whether the upgrade was triggered automatically.
+ * @returns The verified global version, local dependency update, or skip reason.
+ */
+export declare function upgradeCLI(options?: RunCLIUpgradeOptions): Promise<UpgradeResult>;
 /**
  * Returns the version to auto-upgrade to, or undefined if auto-upgrade should be skipped.
  * Auto-upgrade is enabled by default and can be disabled via `setAutoUpgradeEnabled(false)`.