@shopify/cli-kit 4.8.5 → 4.9.1

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

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/public/node/cli.ts"],"names":[],"mappings":"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","sourcesContent":["import {isTruthy} from './context/utilities.js'\nimport {launchCLI as defaultLaunchCli} from './cli-launcher.js'\nimport {environmentVariables} from '../../private/node/constants.js'\nimport {Flags} from '@oclif/core'\nimport type {LazyCommandLoader} from './custom-oclif-loader.js'\n\n/**\n * IMPORTANT NOTE: Imports in this module are dynamic to ensure that \"setupEnvironmentVariables\" can dynamically\n * set the DEBUG environment variable before the 'debug' package sets up its configuration when modules\n * are loaded statically.\n */\ninterface RunCLIOptions {\n  /** The value of import.meta.url of the CLI executable module */\n  moduleURL: string\n  development: boolean\n  /** Optional lazy command loader for on-demand command loading */\n  lazyCommandLoader?: LazyCommandLoader\n}\n\nasync function exitIfOldNodeVersion(versions: NodeJS.ProcessVersions = process.versions) {\n  const nodeVersion = versions.node\n  const nodeMajorVersion = Number(nodeVersion.split('.')[0])\n\n  const currentSupportedNodeVersion = 22\n  if (nodeMajorVersion < currentSupportedNodeVersion) {\n    const {renderError} = await import('./ui.js')\n    renderError({\n      headline: 'Upgrade to a supported Node version now.',\n      body: [\n        `Node ${nodeMajorVersion} has reached end-of-life and poses security risks. When you upgrade to a`,\n        {\n          link: {\n            url: 'https://nodejs.dev/en/about/previous-releases',\n            label: 'supported version',\n          },\n        },\n        {char: ','},\n        \"you'll be able to use Shopify CLI without interruption.\",\n      ],\n    })\n    process.exit(1)\n  }\n}\n\nfunction setupEnvironmentVariables(\n  options: Pick<RunCLIOptions, 'development'>,\n  argv: string[] = process.argv,\n  env: NodeJS.ProcessEnv = process.env,\n) {\n  /**\n   * By setting DEBUG=* when --verbose is passed we are increasing the\n   * verbosity of oclif. Oclif uses debug (https://www.npmjs.com/package/debug)\n   * for logging, and it's configured through the DEBUG= environment variable.\n   */\n  if (argv.includes('--verbose')) {\n    env.DEBUG = env.DEBUG ?? '*'\n  }\n  if (options.development) {\n    env.SHOPIFY_CLI_ENV = env.SHOPIFY_CLI_ENV ?? 'development'\n  }\n}\n\nfunction forceNoColor(argv: string[] = process.argv, env: NodeJS.ProcessEnv = process.env) {\n  if (\n    argv.includes('--no-color') ||\n    argv.includes('--json') ||\n    argv.includes('-j') ||\n    isTruthy(env.NO_COLOR) ||\n    isTruthy(env.SHOPIFY_FLAG_NO_COLOR) ||\n    isTruthy(env[environmentVariables.json]) ||\n    env.TERM === 'dumb'\n  ) {\n    env.FORCE_COLOR = '0'\n  }\n}\n\n/**\n * A function that abstracts away setting up the environment and running\n * a CLI\n * @param options - Options.\n */\nexport async function runCLI(\n  options: RunCLIOptions & {runInCreateMode?: boolean},\n  launchCLI: (options: {moduleURL: string; lazyCommandLoader?: LazyCommandLoader}) => Promise<void> = defaultLaunchCli,\n  argv: string[] = process.argv,\n  env: NodeJS.ProcessEnv = process.env,\n  versions: NodeJS.ProcessVersions = process.versions,\n): Promise<void> {\n  setupEnvironmentVariables(options, argv, env)\n  if (options.runInCreateMode) {\n    await addInitToArgvWhenRunningCreateCLI(options, argv)\n  }\n  forceNoColor(argv, env)\n  await exitIfOldNodeVersion(versions)\n  return launchCLI({moduleURL: options.moduleURL, lazyCommandLoader: options.lazyCommandLoader})\n}\n\nasync function addInitToArgvWhenRunningCreateCLI(\n  options: Pick<RunCLIOptions, 'moduleURL'>,\n  argv: string[] = process.argv,\n): Promise<void> {\n  const {findUpAndReadPackageJson} = await import('./node-package-manager.js')\n  const {moduleDirectory} = await import('./path.js')\n\n  const packageJson = await findUpAndReadPackageJson(moduleDirectory(options.moduleURL))\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const packageName = (packageJson.content as any).name as string\n  const name = packageName.replace('@shopify/create-', '')\n  const initIndex = argv.findIndex((arg) => arg.includes('init'))\n  if (initIndex === -1) {\n    const initIndex = argv.findIndex((arg) => arg.match(new RegExp(`bin(\\\\/|\\\\\\\\)+(create-${name}|dev|run)`))) + 1\n    argv.splice(initIndex, 0, 'init')\n  }\n}\n\n/**\n * A function for create-x CLIs that automatically runs the \"init\" command.\n */\nexport async function runCreateCLI(\n  options: RunCLIOptions,\n  launchCLI: (options: {moduleURL: string}) => Promise<void> = defaultLaunchCli,\n  argv: string[] = process.argv,\n  env: NodeJS.ProcessEnv = process.env,\n  versions: NodeJS.ProcessVersions = process.versions,\n): Promise<void> {\n  return runCLI({...options, runInCreateMode: true}, launchCLI, argv, env, versions)\n}\n\n/**\n * An object that contains the flags that\n * are shared across all the commands.\n */\nexport const globalFlags = {\n  'no-color': Flags.boolean({\n    hidden: false,\n    description: 'Disable color output.',\n    env: 'SHOPIFY_FLAG_NO_COLOR',\n  }),\n  verbose: Flags.boolean({\n    hidden: false,\n    description: 'Increase the verbosity of the output. May include sensitive data.',\n    env: 'SHOPIFY_FLAG_VERBOSE',\n  }),\n}\n\nexport const jsonFlag = {\n  json: Flags.boolean({\n    char: 'j',\n    description: 'Output the result as JSON. Automatically disables color output.',\n    hidden: false,\n    default: false,\n    env: environmentVariables.json,\n  }),\n}\n\nexport const authAliasFlag = {\n  'auth-alias': Flags.string({\n    description: 'Alias of the Shopify account to use for authentication.',\n    env: 'SHOPIFY_FLAG_AUTH_ALIAS',\n  }),\n}\n\n/**\n * Builds a `--port` flag that only accepts a valid port number. The flag parses its\n * value as an integer and rejects anything that isn't a whole number between 1 and\n * 65535, so commands fail with a clear message instead of crashing on an out-of-range\n * port. The accepted range is appended to the description so it shows up in `--help`.\n * @param options - Optional overrides for the flag's description, environment variable, and visibility.\n * @returns An oclif integer flag constrained to the valid port range.\n */\nexport const portFlag = (options: {description?: string; env?: string; hidden?: boolean} = {}) => {\n  const description = [options.description, 'Must be between 1 and 65535.'].filter(Boolean).join(' ')\n  return Flags.integer({min: 1, max: 65535, ...options, description})\n}\n\n/**\n * Marks a flag as required when the CLI cannot prompt for a value.\n *\n * The flag remains optional in interactive terminals. In non-interactive environments,\n * `BaseCommand` validates the flag automatically and the requirement is shown in `--help`.\n * Use `BaseCommand.nonTTYFlagRequirements` for conditional or alternative requirements.\n *\n * @param flag - An oclif flag definition.\n * @returns A new flag definition annotated for non-interactive validation and help output.\n */\nexport function requiredIfNonInteractive<TFlag extends {description?: string}>(flag: TFlag): TFlag {\n  const existingDescription = flag.description?.trimEnd()\n  const punctuatedDescription =\n    existingDescription && !existingDescription.endsWith('.') ? `${existingDescription}.` : existingDescription\n  const description = [punctuatedDescription, 'Required if non interactive.'].filter(Boolean).join(' ')\n\n  return {...flag, description, requiredIfNonInteractive: true}\n}\n\n/**\n * Clear the CLI cache, used to store some API responses and handle notifications status\n */\nexport async function clearCache(): Promise<void> {\n  const {cacheClear} = await import('../../private/node/conf-store.js')\n  cacheClear()\n}\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/public/node/cli.ts"],"names":[],"mappings":"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","sourcesContent":["import {isTruthy} from './context/utilities.js'\nimport {noInputFlag} from './no-input.js'\nimport {launchCLI as defaultLaunchCli} from './cli-launcher.js'\nimport {environmentVariables} from '../../private/node/constants.js'\nimport {Flags} from '@oclif/core'\nimport type {LazyCommandLoader} from './custom-oclif-loader.js'\n\n/**\n * IMPORTANT NOTE: Imports in this module are dynamic to ensure that \"setupEnvironmentVariables\" can dynamically\n * set the DEBUG environment variable before the 'debug' package sets up its configuration when modules\n * are loaded statically.\n */\ninterface RunCLIOptions {\n  /** The value of import.meta.url of the CLI executable module */\n  moduleURL: string\n  development: boolean\n  /** Optional lazy command loader for on-demand command loading */\n  lazyCommandLoader?: LazyCommandLoader\n}\n\nasync function exitIfOldNodeVersion(versions: NodeJS.ProcessVersions = process.versions) {\n  const nodeVersion = versions.node\n  const nodeMajorVersion = Number(nodeVersion.split('.')[0])\n\n  const currentSupportedNodeVersion = 22\n  if (nodeMajorVersion < currentSupportedNodeVersion) {\n    const {renderError} = await import('./ui.js')\n    renderError({\n      headline: 'Upgrade to a supported Node version now.',\n      body: [\n        `Node ${nodeMajorVersion} has reached end-of-life and poses security risks. When you upgrade to a`,\n        {\n          link: {\n            url: 'https://nodejs.dev/en/about/previous-releases',\n            label: 'supported version',\n          },\n        },\n        {char: ','},\n        \"you'll be able to use Shopify CLI without interruption.\",\n      ],\n    })\n    process.exit(1)\n  }\n}\n\nfunction setupEnvironmentVariables(\n  options: Pick<RunCLIOptions, 'development'>,\n  argv: string[] = process.argv,\n  env: NodeJS.ProcessEnv = process.env,\n) {\n  /**\n   * By setting DEBUG=* when --verbose is passed we are increasing the\n   * verbosity of oclif. Oclif uses debug (https://www.npmjs.com/package/debug)\n   * for logging, and it's configured through the DEBUG= environment variable.\n   */\n  if (argv.includes('--verbose')) {\n    env.DEBUG = env.DEBUG ?? '*'\n  }\n  if (options.development) {\n    env.SHOPIFY_CLI_ENV = env.SHOPIFY_CLI_ENV ?? 'development'\n  }\n}\n\nfunction forceNoColor(argv: string[] = process.argv, env: NodeJS.ProcessEnv = process.env) {\n  if (\n    argv.includes('--no-color') ||\n    argv.includes('--json') ||\n    argv.includes('-j') ||\n    isTruthy(env.NO_COLOR) ||\n    isTruthy(env.SHOPIFY_FLAG_NO_COLOR) ||\n    isTruthy(env[environmentVariables.json]) ||\n    env.TERM === 'dumb'\n  ) {\n    env.FORCE_COLOR = '0'\n  }\n}\n\n/**\n * A function that abstracts away setting up the environment and running\n * a CLI\n * @param options - Options.\n */\nexport async function runCLI(\n  options: RunCLIOptions & {runInCreateMode?: boolean},\n  launchCLI: (options: {moduleURL: string; lazyCommandLoader?: LazyCommandLoader}) => Promise<void> = defaultLaunchCli,\n  argv: string[] = process.argv,\n  env: NodeJS.ProcessEnv = process.env,\n  versions: NodeJS.ProcessVersions = process.versions,\n): Promise<void> {\n  setupEnvironmentVariables(options, argv, env)\n  if (options.runInCreateMode) {\n    await addInitToArgvWhenRunningCreateCLI(options, argv)\n  }\n  forceNoColor(argv, env)\n  await exitIfOldNodeVersion(versions)\n  return launchCLI({moduleURL: options.moduleURL, lazyCommandLoader: options.lazyCommandLoader})\n}\n\nasync function addInitToArgvWhenRunningCreateCLI(\n  options: Pick<RunCLIOptions, 'moduleURL'>,\n  argv: string[] = process.argv,\n): Promise<void> {\n  const {findUpAndReadPackageJson} = await import('./node-package-manager.js')\n  const {moduleDirectory} = await import('./path.js')\n\n  const packageJson = await findUpAndReadPackageJson(moduleDirectory(options.moduleURL))\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const packageName = (packageJson.content as any).name as string\n  const name = packageName.replace('@shopify/create-', '')\n  const initIndex = argv.findIndex((arg) => arg.includes('init'))\n  if (initIndex === -1) {\n    const initIndex = argv.findIndex((arg) => arg.match(new RegExp(`bin(\\\\/|\\\\\\\\)+(create-${name}|dev|run)`))) + 1\n    argv.splice(initIndex, 0, 'init')\n  }\n}\n\n/**\n * A function for create-x CLIs that automatically runs the \"init\" command.\n */\nexport async function runCreateCLI(\n  options: RunCLIOptions,\n  launchCLI: (options: {moduleURL: string}) => Promise<void> = defaultLaunchCli,\n  argv: string[] = process.argv,\n  env: NodeJS.ProcessEnv = process.env,\n  versions: NodeJS.ProcessVersions = process.versions,\n): Promise<void> {\n  return runCLI({...options, runInCreateMode: true}, launchCLI, argv, env, versions)\n}\n\n/**\n * An object that contains the flags that\n * are shared across all the commands.\n */\nexport const globalFlags = {\n  ...noInputFlag,\n  'no-color': Flags.boolean({\n    hidden: false,\n    description: 'Disable color output.',\n    env: 'SHOPIFY_FLAG_NO_COLOR',\n  }),\n  verbose: Flags.boolean({\n    hidden: false,\n    description: 'Increase the verbosity of the output. May include sensitive data.',\n    env: 'SHOPIFY_FLAG_VERBOSE',\n  }),\n}\n\nexport const jsonFlag = {\n  json: Flags.boolean({\n    char: 'j',\n    description: 'Output the result as JSON. Automatically disables color output.',\n    hidden: false,\n    default: false,\n    env: environmentVariables.json,\n  }),\n}\n\nexport const authAliasFlag = {\n  'auth-alias': Flags.string({\n    description: 'Alias of the Shopify account to use for authentication.',\n    env: 'SHOPIFY_FLAG_AUTH_ALIAS',\n  }),\n}\n\n/**\n * Builds a `--port` flag that only accepts a valid port number. The flag parses its\n * value as an integer and rejects anything that isn't a whole number between 1 and\n * 65535, so commands fail with a clear message instead of crashing on an out-of-range\n * port. The accepted range is appended to the description so it shows up in `--help`.\n * @param options - Optional overrides for the flag's description, environment variable, and visibility.\n * @returns An oclif integer flag constrained to the valid port range.\n */\nexport const portFlag = (options: {description?: string; env?: string; hidden?: boolean} = {}) => {\n  const description = [options.description, 'Must be between 1 and 65535.'].filter(Boolean).join(' ')\n  return Flags.integer({min: 1, max: 65535, ...options, description})\n}\n\n/**\n * Marks a flag as required when the CLI cannot prompt for a value.\n *\n * The flag remains optional in interactive terminals. In non-interactive environments,\n * `BaseCommand` validates the flag automatically and the requirement is shown in `--help`.\n * Use `BaseCommand.nonTTYFlagRequirements` for conditional or alternative requirements.\n *\n * @param flag - An oclif flag definition.\n * @returns A new flag definition annotated for non-interactive validation and help output.\n */\nexport function requiredIfNonInteractive<TFlag extends {description?: string}>(flag: TFlag): TFlag {\n  const existingDescription = flag.description?.trimEnd()\n  const punctuatedDescription =\n    existingDescription && !existingDescription.endsWith('.') ? `${existingDescription}.` : existingDescription\n  const description = [punctuatedDescription, 'Required if non interactive.'].filter(Boolean).join(' ')\n\n  return {...flag, description, requiredIfNonInteractive: true}\n}\n\n/**\n * Clear the CLI cache, used to store some API responses and handle notifications status\n */\nexport async function clearCache(): Promise<void> {\n  const {cacheClear} = await import('../../private/node/conf-store.js')\n  cacheClear()\n}\n"]}

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

@@ -0,0 +1,65 @@
+import { type CommandEvent } from '../common/command-events.js';
+export { commandEventOutputMode, emitCommandEvent, runWithCommandEvents, type CommandEventOutputMode, } from '../../private/node/command-event-context.js';
+/**
+ * Runs the complete CLI lifecycle with the event presentation selected by its arguments.
+ *
+ * @param argv - The command arguments used to determine whether JSON output is enabled.
+ * @param execute - The command lifecycle to run.
+ * @returns The result of the command lifecycle.
+ */
+export declare function runWithCommandEventsForCommand<TResult>(argv: string[], execute: () => TResult): TResult;
+export declare const commandEventOutputSchema: import("./json-output-schema.js").JsonOutputSchema<import("zod").ZodDiscriminatedUnion<"type", [import("zod").ZodObject<{
+    type: import("zod").ZodLiteral<"diagnostic">;
+    timestamp: import("zod").ZodString;
+    level: import("zod").ZodEnum<["debug", "info", "warning", "error"]>;
+    message: import("zod").ZodString;
+    code: import("zod").ZodOptional<import("zod").ZodString>;
+}, "strict", import("zod").ZodTypeAny, {
+    type: "diagnostic";
+    message: string;
+    timestamp: string;
+    level: "info" | "error" | "debug" | "warning";
+    code?: string | undefined;
+}, {
+    type: "diagnostic";
+    message: string;
+    timestamp: string;
+    level: "info" | "error" | "debug" | "warning";
+    code?: string | undefined;
+}>, import("zod").ZodObject<{
+    type: import("zod").ZodLiteral<"progress">;
+    timestamp: import("zod").ZodString;
+    status: import("zod").ZodEnum<["started", "updated", "retrying", "completed", "failed"]>;
+    operation: import("zod").ZodString;
+    message: import("zod").ZodOptional<import("zod").ZodString>;
+    current: import("zod").ZodOptional<import("zod").ZodNumber>;
+    total: import("zod").ZodOptional<import("zod").ZodNumber>;
+}, "strict", import("zod").ZodTypeAny, {
+    type: "progress";
+    status: "started" | "updated" | "retrying" | "completed" | "failed";
+    timestamp: string;
+    operation: string;
+    message?: string | undefined;
+    current?: number | undefined;
+    total?: number | undefined;
+}, {
+    type: "progress";
+    status: "started" | "updated" | "retrying" | "completed" | "failed";
+    timestamp: string;
+    operation: string;
+    message?: string | undefined;
+    current?: number | undefined;
+    total?: number | undefined;
+}>]>>;
+/**
+ * Renders a command side event to stderr using the existing CLI output behavior.
+ *
+ * @param event - The event to render.
+ */
+export declare function renderCommandEvent(event: CommandEvent): void;
+/**
+ * Renders a command side event as compact JSON to stderr.
+ *
+ * @param event - The event to render.
+ */
+export declare function renderCommandEventAsJson(event: CommandEvent): void;

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

@@ -0,0 +1,71 @@
+import { outputDebug, outputInfo, outputWarn } from './output.js';
+import { jsonOutputEnabled } from './environment.js';
+import { defineJsonOutputSchema } from './json-output-schema.js';
+import { commandDiagnosticEventSchema, commandEventSchema, commandProgressEventSchema, } from '../common/command-events.js';
+import { outputCommandEventAsJson } from '../../private/node/command-event-output.js';
+import { output } from '../../private/node/output.js';
+import { commandEventOutputMode, runWithCommandEvents } from '../../private/node/command-event-context.js';
+export { commandEventOutputMode, emitCommandEvent, runWithCommandEvents, } from '../../private/node/command-event-context.js';
+/**
+ * Runs the complete CLI lifecycle with the event presentation selected by its arguments.
+ *
+ * @param argv - The command arguments used to determine whether JSON output is enabled.
+ * @param execute - The command lifecycle to run.
+ * @returns The result of the command lifecycle.
+ */
+export function runWithCommandEventsForCommand(argv, execute) {
+    if (commandEventOutputMode() !== undefined)
+        return execute();
+    const outputMode = jsonOutputEnabled(process.env, argv) ? 'json' : 'text';
+    return runWithCommandEvents({
+        outputMode,
+        sink: outputMode === 'json'
+            ? renderCommandEventAsJson
+            : (event, options) => {
+                if (!options?.alreadyRendered)
+                    renderCommandEvent(event);
+            },
+    }, execute);
+}
+export const commandEventOutputSchema = defineJsonOutputSchema({
+    name: 'CommandEvent',
+    schema: commandEventSchema,
+    definitions: {
+        CommandDiagnosticEvent: commandDiagnosticEventSchema,
+        CommandProgressEvent: commandProgressEventSchema,
+    },
+});
+/**
+ * Renders a command side event to stderr using the existing CLI output behavior.
+ *
+ * @param event - The event to render.
+ */
+export function renderCommandEvent(event) {
+    if (event.type === 'progress') {
+        outputInfo(event.message ?? event.operation);
+        return;
+    }
+    switch (event.level) {
+        case 'debug':
+            outputDebug(event.message);
+            break;
+        case 'info':
+            outputInfo(event.message);
+            break;
+        case 'warning':
+            outputWarn(event.message);
+            break;
+        case 'error':
+            output(event.message, 'error');
+            break;
+    }
+}
+/**
+ * Renders a command side event as compact JSON to stderr.
+ *
+ * @param event - The event to render.
+ */
+export function renderCommandEventAsJson(event) {
+    outputCommandEventAsJson(event);
+}
+//# sourceMappingURL=command-events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-events.js","sourceRoot":"","sources":["../../../src/public/node/command-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAE,UAAU,EAAE,UAAU,EAAC,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAC,iBAAiB,EAAC,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAC,sBAAsB,EAAC,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,GAE3B,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAC,wBAAwB,EAAC,MAAM,4CAA4C,CAAA;AACnF,OAAO,EAAC,MAAM,EAAC,MAAM,8BAA8B,CAAA;AACnD,OAAO,EAAC,sBAAsB,EAAE,oBAAoB,EAAC,MAAM,6CAA6C,CAAA;AAExG,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,GAErB,MAAM,6CAA6C,CAAA;AAEpD;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAAU,IAAc,EAAE,OAAsB;IAC5F,IAAI,sBAAsB,EAAE,KAAK,SAAS;QAAE,OAAO,OAAO,EAAE,CAAA;IAE5D,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;IACzE,OAAO,oBAAoB,CACzB;QACE,UAAU;QACV,IAAI,EACF,UAAU,KAAK,MAAM;YACnB,CAAC,CAAC,wBAAwB;YAC1B,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;gBACjB,IAAI,CAAC,OAAO,EAAE,eAAe;oBAAE,kBAAkB,CAAC,KAAK,CAAC,CAAA;YAC1D,CAAC;KACR,EACD,OAAO,CACR,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;IAC7D,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,kBAAkB;IAC1B,WAAW,EAAE;QACX,sBAAsB,EAAE,4BAA4B;QACpD,oBAAoB,EAAE,0BAA0B;KACjD;CACF,CAAC,CAAA;AAEF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC9B,UAAU,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,SAAS,CAAC,CAAA;QAC5C,OAAM;IACR,CAAC;IAED,QAAQ,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YAC1B,MAAK;QACP,KAAK,MAAM;YACT,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACzB,MAAK;QACP,KAAK,SAAS;YACZ,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACzB,MAAK;QACP,KAAK,OAAO;YACV,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC9B,MAAK;IACT,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAmB;IAC1D,wBAAwB,CAAC,KAAK,CAAC,CAAA;AACjC,CAAC","sourcesContent":["import {outputDebug, outputInfo, outputWarn} from './output.js'\nimport {jsonOutputEnabled} from './environment.js'\nimport {defineJsonOutputSchema} from './json-output-schema.js'\nimport {\n  commandDiagnosticEventSchema,\n  commandEventSchema,\n  commandProgressEventSchema,\n  type CommandEvent,\n} from '../common/command-events.js'\nimport {outputCommandEventAsJson} from '../../private/node/command-event-output.js'\nimport {output} from '../../private/node/output.js'\nimport {commandEventOutputMode, runWithCommandEvents} from '../../private/node/command-event-context.js'\n\nexport {\n  commandEventOutputMode,\n  emitCommandEvent,\n  runWithCommandEvents,\n  type CommandEventOutputMode,\n} from '../../private/node/command-event-context.js'\n\n/**\n * Runs the complete CLI lifecycle with the event presentation selected by its arguments.\n *\n * @param argv - The command arguments used to determine whether JSON output is enabled.\n * @param execute - The command lifecycle to run.\n * @returns The result of the command lifecycle.\n */\nexport function runWithCommandEventsForCommand<TResult>(argv: string[], execute: () => TResult): TResult {\n  if (commandEventOutputMode() !== undefined) return execute()\n\n  const outputMode = jsonOutputEnabled(process.env, argv) ? 'json' : 'text'\n  return runWithCommandEvents(\n    {\n      outputMode,\n      sink:\n        outputMode === 'json'\n          ? renderCommandEventAsJson\n          : (event, options) => {\n              if (!options?.alreadyRendered) renderCommandEvent(event)\n            },\n    },\n    execute,\n  )\n}\n\nexport const commandEventOutputSchema = defineJsonOutputSchema({\n  name: 'CommandEvent',\n  schema: commandEventSchema,\n  definitions: {\n    CommandDiagnosticEvent: commandDiagnosticEventSchema,\n    CommandProgressEvent: commandProgressEventSchema,\n  },\n})\n\n/**\n * Renders a command side event to stderr using the existing CLI output behavior.\n *\n * @param event - The event to render.\n */\nexport function renderCommandEvent(event: CommandEvent): void {\n  if (event.type === 'progress') {\n    outputInfo(event.message ?? event.operation)\n    return\n  }\n\n  switch (event.level) {\n    case 'debug':\n      outputDebug(event.message)\n      break\n    case 'info':\n      outputInfo(event.message)\n      break\n    case 'warning':\n      outputWarn(event.message)\n      break\n    case 'error':\n      output(event.message, 'error')\n      break\n  }\n}\n\n/**\n * Renders a command side event as compact JSON to stderr.\n *\n * @param event - The event to render.\n */\nexport function renderCommandEventAsJson(event: CommandEvent): void {\n  outputCommandEventAsJson(event)\n}\n"]}

package/dist/public/node/context/local.d.ts

@@ -11,6 +11,12 @@ export declare function isTerminalInteractive(): boolean;
  * @returns The path to the user's home directory.
  */
 export declare function homeDirectory(): string;
+/**
+ * Clears the memoized result of isUnitTest so the environment variable is re-read.
+ *
+ * Only intended for test helpers that temporarily toggle unit-test detection.
+ */
+export declare function resetMemoizedIsUnitTest(): void;
 /**
  * Returns true if the CLI is running in debug mode.
  *

package/dist/public/node/context/local.js

@@ -1,4 +1,5 @@
 import { isTruthy } from './utilities.js';
+import { isInputDisabled } from '../no-input.js';
 import { getCIMetadata, isSet } from '../../../private/node/context/utilities.js';
 import { defaultThemeKitAccessDomain, environmentVariables, pathConstants } from '../../../private/node/constants.js';
 import { randomUUID } from 'crypto';
@@ -19,7 +20,7 @@ async function lazyExec(command, args) {
  * @returns True if the terminal is interactive.
  */
 export function isTerminalInteractive() {
-    return Boolean(process.stdout.isTTY && process.env.TERM !== 'dumb' && !('CI' in process.env));
+    return Boolean(!isInputDisabled() && process.stdout.isTTY && process.env.TERM !== 'dumb' && !('CI' in process.env));
 }
 /**
  * Returns the path to the user's home directory.
@@ -37,6 +38,14 @@ let memoizedIsVerbose;
  * Memoized value for the unit test check.
  */
 let memoizedIsUnitTest;
+/**
+ * Clears the memoized result of isUnitTest so the environment variable is re-read.
+ *
+ * Only intended for test helpers that temporarily toggle unit-test detection.
+ */
+export function resetMemoizedIsUnitTest() {
+    memoizedIsUnitTest = undefined;
+}
 /**
  * Returns true if the CLI is running in debug mode.
  *

package/dist/public/node/context/local.js.map

@@ -1 +1 @@
-{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../src/public/node/context/local.ts"],"names":[],"mappings":"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","sourcesContent":["import {isTruthy} from './utilities.js'\nimport {getCIMetadata, isSet, Metadata} from '../../../private/node/context/utilities.js'\nimport {defaultThemeKitAccessDomain, environmentVariables, pathConstants} from '../../../private/node/constants.js'\nimport {randomUUID} from 'crypto'\nimport {homedir, networkInterfaces} from 'os'\n\n// Dynamic imports to avoid circular dependency: context/local → fs → output → context/local\n// fileExists and exec are only used in specific async functions, not at module init.\nasync function lazyFileExists(path: string): Promise<boolean> {\n  const {fileExists} = await import('../fs.js')\n  return fileExists(path)\n}\n\nasync function lazyExec(command: string, args: string[]): Promise<void> {\n  const {exec} = await import('../system.js')\n  await exec(command, args)\n}\n\n/**\n * It returns true if the terminal is interactive.\n *\n * @returns True if the terminal is interactive.\n */\nexport function isTerminalInteractive(): boolean {\n  return Boolean(process.stdout.isTTY && process.env.TERM !== 'dumb' && !('CI' in process.env))\n}\n\n/**\n * Returns the path to the user's home directory.\n *\n * @returns The path to the user's home directory.\n */\nexport function homeDirectory(): string {\n  return homedir()\n}\n\n/**\n * Memoized value for the verbose check.\n */\nlet memoizedIsVerbose: boolean | undefined\n\n/**\n * Memoized value for the unit test check.\n */\nlet memoizedIsUnitTest: boolean | undefined\n\n/**\n * Returns true if the CLI is running in debug mode.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if SHOPIFY_ENV is development.\n */\nexport function isDevelopment(env = process.env): boolean {\n  return env[environmentVariables.env] === 'development'\n}\n\n/**\n * Returns true if the CLI is running in verbose mode.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if SHOPIFY_FLAG_VERBOSE is truthy or the flag --verbose has been passed.\n */\nexport function isVerbose(env = process.env): boolean {\n  if (env === process.env) {\n    // Memoize the result to avoid repeated scans of process.argv and env lookups\n    // in high-frequency paths like outputDebug.\n    return (memoizedIsVerbose ??= isTruthy(env[environmentVariables.verbose]) || process.argv.includes('--verbose'))\n  }\n  return isTruthy(env[environmentVariables.verbose]) || process.argv.includes('--verbose')\n}\n\n/**\n * Returns true if the environment in which the CLI is running is either\n * a local environment (where dev is present).\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if the CLI is used in a Shopify environment.\n */\nexport async function isShopify(env = process.env): Promise<boolean> {\n  if (Object.prototype.hasOwnProperty.call(env, environmentVariables.runAsUser)) {\n    return !isTruthy(env[environmentVariables.runAsUser])\n  }\n  const devInstalled = await lazyFileExists(pathConstants.executables.dev)\n  return devInstalled\n}\n\n/**\n * This variable is used when running unit tests to indicate that the CLI's business logic\n * is run as a subject of a unit test. We can use this variable to disable output through\n * the standard streams.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if the SHOPIFY_UNIT_TEST environment variable is truthy.\n */\nexport function isUnitTest(env = process.env): boolean {\n  if (env === process.env) {\n    // Memoize the result as SHOPIFY_UNIT_TEST is static during execution\n    // and checked frequently to suppress output.\n    return (memoizedIsUnitTest ??= isTruthy(env[environmentVariables.unitTest]))\n  }\n  return isTruthy(env[environmentVariables.unitTest])\n}\n\n/**\n * Returns true if reporting analytics is enabled.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True unless SHOPIFY_CLI_NO_ANALYTICS or OPT_OUT_INSTRUMENTATION is truthy, or debug mode is enabled.\n */\nexport function analyticsDisabled(env = process.env): boolean {\n  return (\n    isTruthy(env[environmentVariables.noAnalytics]) ||\n    isTruthy(env[environmentVariables.optOutInstrumentation]) ||\n    isDevelopment(env)\n  )\n}\n\n/**\n * Returns true if reporting analytics should always happen, regardless of DEBUG mode etc.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if SHOPIFY_CLI_ALWAYS_LOG_ANALYTICS is truthy.\n */\nexport function alwaysLogAnalytics(env = process.env): boolean {\n  return isTruthy(env[environmentVariables.alwaysLogAnalytics])\n}\n\n/**\n * Returns true if reporting metrics should always happen, regardless of DEBUG mode etc.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if SHOPIFY_CLI_ALWAYS_LOG_METRICS is truthy.\n */\nexport function alwaysLogMetrics(env = process.env): boolean {\n  return isTruthy(env[environmentVariables.alwaysLogMetrics])\n}\n\n/**\n * Returns true if the CLI can run the \"doctor-release\" command.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if the CLI can run the \"doctor-release\" command.\n */\nexport function canRunDoctorRelease(env = process.env): boolean {\n  return isTruthy(env[environmentVariables.doctor])\n}\n\n/**\n * Return gitpodURL if we are running in gitpod.\n * Https://www.gitpod.io/docs/environment-variables#default-environment-variables.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns The gitpod URL.\n */\nexport function gitpodURL(env = process.env): string | undefined {\n  return env[environmentVariables.gitpod]\n}\n\n/**\n * Return codespaceURL if we are running in codespaces.\n * Https://docs.github.com/en/codespaces/developing-in-codespaces/default-environment-variables-for-your-codespace#list-of-default-environment-variables.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns The codespace URL.\n */\nexport function codespaceURL(env = process.env): string | undefined {\n  return env[environmentVariables.codespaceName]\n}\n\n/**\n * Return codespacePortForwardingDomain if we are running in codespaces.\n * Https://docs.github.com/en/codespaces/developing-in-codespaces/default-environment-variables-for-your-codespace#list-of-default-environment-variables.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns The codespace port forwarding domain.\n */\nexport function codespacePortForwardingDomain(env = process.env): string | undefined {\n  return env[environmentVariables.codespacePortForwardingDomain]\n}\n\n/**\n * Checks if the CLI is run from a cloud environment.\n *\n * @param env - Environment variables used when the cli is launched.\n * @returns True in case the CLI is run from a cloud environment.\n */\nexport function isCloudEnvironment(env: NodeJS.ProcessEnv = process.env): boolean {\n  return cloudEnvironment(env).platform !== 'localhost'\n}\n\n/**\n * The token used to run a theme command with a custom password.\n *\n * @param env - Environment variables used when the cli is launched.\n * @returns A string with the token.\n */\nexport function themeToken(env = process.env): string | undefined {\n  return env[environmentVariables.themeToken]\n}\n\n/**\n * Returns the cloud environment platform name and if the platform support online IDE in case the CLI is run from one of\n * them. Platform name 'localhost' is returned otherwise.\n *\n * @param env - Environment variables used when the cli is launched.\n * @returns Cloud platform information.\n */\nexport function cloudEnvironment(env: NodeJS.ProcessEnv = process.env): {\n  platform: 'codespaces' | 'gitpod' | 'cloudShell' | 'localhost'\n  editor: boolean\n} {\n  if (isSet(env[environmentVariables.codespaces])) {\n    return {platform: 'codespaces', editor: true}\n  }\n  if (isSet(env[environmentVariables.gitpod])) {\n    return {platform: 'gitpod', editor: true}\n  }\n  if (isSet(env[environmentVariables.cloudShell])) {\n    return {platform: 'cloudShell', editor: true}\n  }\n  return {platform: 'localhost', editor: false}\n}\n\n/**\n * Returns whether the environment has Git available.\n *\n * @returns A promise that resolves with the value.\n */\nexport async function hasGit(): Promise<boolean> {\n  try {\n    await lazyExec('git', ['--version'])\n    return true\n    // eslint-disable-next-line no-catch-all/no-catch-all\n  } catch {\n    return false\n  }\n}\n\n/**\n * Gets info on the CI platform the CLI is running on, if applicable.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns The CI platform info.\n */\nexport function ciPlatform(\n  env = process.env,\n): {isCI: true; name: string; metadata: Metadata} | {isCI: false; name?: undefined; metadata?: undefined} {\n  if (isTruthy(env.CI)) {\n    let name = 'unknown'\n    if (isSet(env.BITBUCKET_BUILD_NUMBER)) {\n      name = 'bitbucket'\n    } else if (isTruthy(env.CIRCLECI)) {\n      name = 'circleci'\n    } else if (isSet(env.GITHUB_ACTION)) {\n      name = 'github'\n    } else if (isTruthy(env.GITLAB_CI)) {\n      name = 'gitlab'\n    } else if (isSet(env.BUILDKITE)) {\n      name = 'buildkite'\n    }\n\n    return {\n      isCI: true,\n      name,\n      metadata: getCIMetadata(name, env),\n    }\n  } else if (isTruthy(env.TF_BUILD)) {\n    return {\n      isCI: true,\n      name: 'azure',\n      metadata: getCIMetadata('azure', env),\n    }\n  }\n  return {\n    isCI: false,\n  }\n}\n\n/**\n * Returns the first mac address found, preferring external interfaces. Returns a random\n * value when no interface has a MAC, so callers hashing it as a device id don't group\n * unrelated devices together.\n *\n * @returns Mac address.\n */\nexport async function macAddress(): Promise<string> {\n  const emptyMac = '00:00:00:00:00:00'\n  const interfacesWithMac = Object.values(networkInterfaces())\n    .flat()\n    .filter((iface): iface is NonNullable<typeof iface> => Boolean(iface && iface.mac !== emptyMac))\n  const bestInterface = interfacesWithMac.find((iface) => !iface.internal) ?? interfacesWithMac[0]\n  return bestInterface?.mac ?? randomUUID()\n}\n\n/**\n * Get the domain for theme kit access.\n *\n * It can be overridden via the SHOPIFY_CLI_THEME_KIT_ACCESS_DOMAIN environment\n * variable.\n *\n * @param env - The environment variables from the environment of the process.\n *\n * @returns The domain for theme kit access.\n */\nexport function getThemeKitAccessDomain(env = process.env): string {\n  const domain = env[environmentVariables.themeKitAccessDomain]\n\n  return isSet(domain) ? domain : defaultThemeKitAccessDomain\n}\n\n/**\n * Get the domain to send OTEL metrics to.\n *\n * It can be overridden via the SHOPIFY_CLI_OTEL_EXPORTER_OTLP_ENDPOINT environment variable.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns The domain to send OTEL metrics to.\n */\nexport function opentelemetryDomain(env = process.env): string {\n  const domain = env[environmentVariables.otelURL]\n\n  return isSet(domain) ? domain : 'https://otlp-http-production-cli.shopifysvc.com'\n}\n\nexport type CIMetadata = Metadata\n"]}
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../src/public/node/context/local.ts"],"names":[],"mappings":"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","sourcesContent":["import {isTruthy} from './utilities.js'\nimport {isInputDisabled} from '../no-input.js'\nimport {getCIMetadata, isSet, Metadata} from '../../../private/node/context/utilities.js'\nimport {defaultThemeKitAccessDomain, environmentVariables, pathConstants} from '../../../private/node/constants.js'\nimport {randomUUID} from 'crypto'\nimport {homedir, networkInterfaces} from 'os'\n\n// Dynamic imports to avoid circular dependency: context/local → fs → output → context/local\n// fileExists and exec are only used in specific async functions, not at module init.\nasync function lazyFileExists(path: string): Promise<boolean> {\n  const {fileExists} = await import('../fs.js')\n  return fileExists(path)\n}\n\nasync function lazyExec(command: string, args: string[]): Promise<void> {\n  const {exec} = await import('../system.js')\n  await exec(command, args)\n}\n\n/**\n * It returns true if the terminal is interactive.\n *\n * @returns True if the terminal is interactive.\n */\nexport function isTerminalInteractive(): boolean {\n  return Boolean(!isInputDisabled() && process.stdout.isTTY && process.env.TERM !== 'dumb' && !('CI' in process.env))\n}\n\n/**\n * Returns the path to the user's home directory.\n *\n * @returns The path to the user's home directory.\n */\nexport function homeDirectory(): string {\n  return homedir()\n}\n\n/**\n * Memoized value for the verbose check.\n */\nlet memoizedIsVerbose: boolean | undefined\n\n/**\n * Memoized value for the unit test check.\n */\nlet memoizedIsUnitTest: boolean | undefined\n\n/**\n * Clears the memoized result of isUnitTest so the environment variable is re-read.\n *\n * Only intended for test helpers that temporarily toggle unit-test detection.\n */\nexport function resetMemoizedIsUnitTest(): void {\n  memoizedIsUnitTest = undefined\n}\n\n/**\n * Returns true if the CLI is running in debug mode.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if SHOPIFY_ENV is development.\n */\nexport function isDevelopment(env = process.env): boolean {\n  return env[environmentVariables.env] === 'development'\n}\n\n/**\n * Returns true if the CLI is running in verbose mode.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if SHOPIFY_FLAG_VERBOSE is truthy or the flag --verbose has been passed.\n */\nexport function isVerbose(env = process.env): boolean {\n  if (env === process.env) {\n    // Memoize the result to avoid repeated scans of process.argv and env lookups\n    // in high-frequency paths like outputDebug.\n    return (memoizedIsVerbose ??= isTruthy(env[environmentVariables.verbose]) || process.argv.includes('--verbose'))\n  }\n  return isTruthy(env[environmentVariables.verbose]) || process.argv.includes('--verbose')\n}\n\n/**\n * Returns true if the environment in which the CLI is running is either\n * a local environment (where dev is present).\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if the CLI is used in a Shopify environment.\n */\nexport async function isShopify(env = process.env): Promise<boolean> {\n  if (Object.prototype.hasOwnProperty.call(env, environmentVariables.runAsUser)) {\n    return !isTruthy(env[environmentVariables.runAsUser])\n  }\n  const devInstalled = await lazyFileExists(pathConstants.executables.dev)\n  return devInstalled\n}\n\n/**\n * This variable is used when running unit tests to indicate that the CLI's business logic\n * is run as a subject of a unit test. We can use this variable to disable output through\n * the standard streams.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if the SHOPIFY_UNIT_TEST environment variable is truthy.\n */\nexport function isUnitTest(env = process.env): boolean {\n  if (env === process.env) {\n    // Memoize the result as SHOPIFY_UNIT_TEST is static during execution\n    // and checked frequently to suppress output.\n    return (memoizedIsUnitTest ??= isTruthy(env[environmentVariables.unitTest]))\n  }\n  return isTruthy(env[environmentVariables.unitTest])\n}\n\n/**\n * Returns true if reporting analytics is enabled.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True unless SHOPIFY_CLI_NO_ANALYTICS or OPT_OUT_INSTRUMENTATION is truthy, or debug mode is enabled.\n */\nexport function analyticsDisabled(env = process.env): boolean {\n  return (\n    isTruthy(env[environmentVariables.noAnalytics]) ||\n    isTruthy(env[environmentVariables.optOutInstrumentation]) ||\n    isDevelopment(env)\n  )\n}\n\n/**\n * Returns true if reporting analytics should always happen, regardless of DEBUG mode etc.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if SHOPIFY_CLI_ALWAYS_LOG_ANALYTICS is truthy.\n */\nexport function alwaysLogAnalytics(env = process.env): boolean {\n  return isTruthy(env[environmentVariables.alwaysLogAnalytics])\n}\n\n/**\n * Returns true if reporting metrics should always happen, regardless of DEBUG mode etc.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if SHOPIFY_CLI_ALWAYS_LOG_METRICS is truthy.\n */\nexport function alwaysLogMetrics(env = process.env): boolean {\n  return isTruthy(env[environmentVariables.alwaysLogMetrics])\n}\n\n/**\n * Returns true if the CLI can run the \"doctor-release\" command.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns True if the CLI can run the \"doctor-release\" command.\n */\nexport function canRunDoctorRelease(env = process.env): boolean {\n  return isTruthy(env[environmentVariables.doctor])\n}\n\n/**\n * Return gitpodURL if we are running in gitpod.\n * Https://www.gitpod.io/docs/environment-variables#default-environment-variables.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns The gitpod URL.\n */\nexport function gitpodURL(env = process.env): string | undefined {\n  return env[environmentVariables.gitpod]\n}\n\n/**\n * Return codespaceURL if we are running in codespaces.\n * Https://docs.github.com/en/codespaces/developing-in-codespaces/default-environment-variables-for-your-codespace#list-of-default-environment-variables.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns The codespace URL.\n */\nexport function codespaceURL(env = process.env): string | undefined {\n  return env[environmentVariables.codespaceName]\n}\n\n/**\n * Return codespacePortForwardingDomain if we are running in codespaces.\n * Https://docs.github.com/en/codespaces/developing-in-codespaces/default-environment-variables-for-your-codespace#list-of-default-environment-variables.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns The codespace port forwarding domain.\n */\nexport function codespacePortForwardingDomain(env = process.env): string | undefined {\n  return env[environmentVariables.codespacePortForwardingDomain]\n}\n\n/**\n * Checks if the CLI is run from a cloud environment.\n *\n * @param env - Environment variables used when the cli is launched.\n * @returns True in case the CLI is run from a cloud environment.\n */\nexport function isCloudEnvironment(env: NodeJS.ProcessEnv = process.env): boolean {\n  return cloudEnvironment(env).platform !== 'localhost'\n}\n\n/**\n * The token used to run a theme command with a custom password.\n *\n * @param env - Environment variables used when the cli is launched.\n * @returns A string with the token.\n */\nexport function themeToken(env = process.env): string | undefined {\n  return env[environmentVariables.themeToken]\n}\n\n/**\n * Returns the cloud environment platform name and if the platform support online IDE in case the CLI is run from one of\n * them. Platform name 'localhost' is returned otherwise.\n *\n * @param env - Environment variables used when the cli is launched.\n * @returns Cloud platform information.\n */\nexport function cloudEnvironment(env: NodeJS.ProcessEnv = process.env): {\n  platform: 'codespaces' | 'gitpod' | 'cloudShell' | 'localhost'\n  editor: boolean\n} {\n  if (isSet(env[environmentVariables.codespaces])) {\n    return {platform: 'codespaces', editor: true}\n  }\n  if (isSet(env[environmentVariables.gitpod])) {\n    return {platform: 'gitpod', editor: true}\n  }\n  if (isSet(env[environmentVariables.cloudShell])) {\n    return {platform: 'cloudShell', editor: true}\n  }\n  return {platform: 'localhost', editor: false}\n}\n\n/**\n * Returns whether the environment has Git available.\n *\n * @returns A promise that resolves with the value.\n */\nexport async function hasGit(): Promise<boolean> {\n  try {\n    await lazyExec('git', ['--version'])\n    return true\n    // eslint-disable-next-line no-catch-all/no-catch-all\n  } catch {\n    return false\n  }\n}\n\n/**\n * Gets info on the CI platform the CLI is running on, if applicable.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns The CI platform info.\n */\nexport function ciPlatform(\n  env = process.env,\n): {isCI: true; name: string; metadata: Metadata} | {isCI: false; name?: undefined; metadata?: undefined} {\n  if (isTruthy(env.CI)) {\n    let name = 'unknown'\n    if (isSet(env.BITBUCKET_BUILD_NUMBER)) {\n      name = 'bitbucket'\n    } else if (isTruthy(env.CIRCLECI)) {\n      name = 'circleci'\n    } else if (isSet(env.GITHUB_ACTION)) {\n      name = 'github'\n    } else if (isTruthy(env.GITLAB_CI)) {\n      name = 'gitlab'\n    } else if (isSet(env.BUILDKITE)) {\n      name = 'buildkite'\n    }\n\n    return {\n      isCI: true,\n      name,\n      metadata: getCIMetadata(name, env),\n    }\n  } else if (isTruthy(env.TF_BUILD)) {\n    return {\n      isCI: true,\n      name: 'azure',\n      metadata: getCIMetadata('azure', env),\n    }\n  }\n  return {\n    isCI: false,\n  }\n}\n\n/**\n * Returns the first mac address found, preferring external interfaces. Returns a random\n * value when no interface has a MAC, so callers hashing it as a device id don't group\n * unrelated devices together.\n *\n * @returns Mac address.\n */\nexport async function macAddress(): Promise<string> {\n  const emptyMac = '00:00:00:00:00:00'\n  const interfacesWithMac = Object.values(networkInterfaces())\n    .flat()\n    .filter((iface): iface is NonNullable<typeof iface> => Boolean(iface && iface.mac !== emptyMac))\n  const bestInterface = interfacesWithMac.find((iface) => !iface.internal) ?? interfacesWithMac[0]\n  return bestInterface?.mac ?? randomUUID()\n}\n\n/**\n * Get the domain for theme kit access.\n *\n * It can be overridden via the SHOPIFY_CLI_THEME_KIT_ACCESS_DOMAIN environment\n * variable.\n *\n * @param env - The environment variables from the environment of the process.\n *\n * @returns The domain for theme kit access.\n */\nexport function getThemeKitAccessDomain(env = process.env): string {\n  const domain = env[environmentVariables.themeKitAccessDomain]\n\n  return isSet(domain) ? domain : defaultThemeKitAccessDomain\n}\n\n/**\n * Get the domain to send OTEL metrics to.\n *\n * It can be overridden via the SHOPIFY_CLI_OTEL_EXPORTER_OTLP_ENDPOINT environment variable.\n *\n * @param env - The environment variables from the environment of the current process.\n * @returns The domain to send OTEL metrics to.\n */\nexport function opentelemetryDomain(env = process.env): string {\n  const domain = env[environmentVariables.otelURL]\n\n  return isSet(domain) ? domain : 'https://otlp-http-production-cli.shopifysvc.com'\n}\n\nexport type CIMetadata = Metadata\n"]}

package/dist/public/node/custom-oclif-loader.d.ts

@@ -17,6 +17,12 @@ export declare class ShopifyConfig extends Config {
      * @param loader - The lazy command loader function.
      */
     setLazyCommandLoader(loader: LazyCommandLoader): void;
+    /**
+     * Override load to protect oclif's shell detection from a failing OS user lookup.
+     *
+     * @returns A promise that resolves once the config is loaded.
+     */
+    load(): Promise<void>;
     /**
      * Override runCommand to use lazy loading when available.
      * Instead of calling cmd.load() which triggers loading ALL commands via index.js,

package/dist/public/node/custom-oclif-loader.js

@@ -1,4 +1,6 @@
+import { runWithCommandEventsForCommand } from './command-events.js';
 import { Config } from '@oclif/core';
+import os from 'os';
 /**
  * Subclass of oclif's Config that loads command classes on demand for faster CLI startup.
  */
@@ -13,6 +15,15 @@ export class ShopifyConfig extends Config {
     setLazyCommandLoader(loader) {
         this.lazyCommandLoader = loader;
     }
+    /**
+     * Override load to protect oclif's shell detection from a failing OS user lookup.
+     *
+     * @returns A promise that resolves once the config is loaded.
+     */
+    async load() {
+        setShellVariableWhenUserLookupFails();
+        return super.load();
+    }
     /**
      * Override runCommand to use lazy loading when available.
      * Instead of calling cmd.load() which triggers loading ALL commands via index.js,
@@ -24,25 +35,40 @@ export class ShopifyConfig extends Config {
      * @returns The command result.
      */
     async runCommand(id, argv = [], cachedCommand = null) {
-        if (!this.lazyCommandLoader) {
-            return super.runCommand(id, argv, cachedCommand);
-        }
-        const cmd = cachedCommand ?? this.findCommand(id);
-        if (!cmd) {
-            return super.runCommand(id, argv, cachedCommand);
-        }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const commandClass = (await this.lazyCommandLoader(id));
-        if (!commandClass) {
-            return super.runCommand(id, argv, cachedCommand);
-        }
-        commandClass.id = id;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        commandClass.plugin = cmd.plugin ?? this.rootPlugin;
-        await this.runHook('prerun', { argv, Command: commandClass });
-        const result = (await commandClass.run(argv, this));
-        await this.runHook('postrun', { argv, Command: commandClass, result });
-        return result;
+        return runWithCommandEventsForCommand(argv, async () => {
+            if (!this.lazyCommandLoader) {
+                return super.runCommand(id, argv, cachedCommand);
+            }
+            const cmd = cachedCommand ?? this.findCommand(id);
+            if (!cmd) {
+                return super.runCommand(id, argv, cachedCommand);
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const commandClass = (await this.lazyCommandLoader(id));
+            if (!commandClass) {
+                return super.runCommand(id, argv, cachedCommand);
+            }
+            commandClass.id = id;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            commandClass.plugin = cmd.plugin ?? this.rootPlugin;
+            await this.runHook('prerun', { argv, Command: commandClass });
+            const result = (await commandClass.run(argv, this));
+            await this.runHook('postrun', { argv, Command: commandClass, result });
+            return result;
+        });
+    }
+}
+// oclif reads SHELL and falls back to os.userInfo(), which throws when the OS can't resolve the current
+// user, killing the CLI during load. Remove once oclif guards that call.
+function setShellVariableWhenUserLookupFails() {
+    if (process.env.SHELL !== undefined)
+        return;
+    try {
+        os.userInfo();
+        // eslint-disable-next-line no-catch-all/no-catch-all
+    }
+    catch {
+        process.env.SHELL = 'unknown';
     }
 }
 //# sourceMappingURL=custom-oclif-loader.js.map

package/dist/public/node/custom-oclif-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"custom-oclif-loader.js","sourceRoot":"","sources":["../../../src/public/node/custom-oclif-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,MAAM,EAAC,MAAM,aAAa,CAAA;AAS3C;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,MAAM;IAC/B,iBAAiB,CAAoB;IAE7C;;;;;OAKG;IACH,oBAAoB,CAAC,MAAyB;QAC5C,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAA;IACjC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,UAAU,CACd,EAAU,EACV,OAAiB,EAAE,EACnB,gBAAyC,IAAI;QAE7C,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC,UAAU,CAAI,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,CAAA;QACrD,CAAC;QAED,MAAM,GAAG,GAAG,aAAa,IAAI,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QACjD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,KAAK,CAAC,UAAU,CAAI,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,CAAA;QACrD,CAAC;QAED,8DAA8D;QAC9D,MAAM,YAAY,GAAG,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAQ,CAAA;QAC9D,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC,UAAU,CAAI,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,CAAA;QACrD,CAAC;QAED,YAAY,CAAC,EAAE,GAAG,EAAE,CAAA;QACpB,8DAA8D;QAC9D,YAAY,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,IAAK,IAAY,CAAC,UAAU,CAAA;QAC5D,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAC,CAAC,CAAA;QAC3D,MAAM,MAAM,GAAG,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAM,CAAA;QACxD,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAC,CAAC,CAAA;QACpE,OAAO,MAAM,CAAA;IACf,CAAC;CACF","sourcesContent":["import {Command, Config} from '@oclif/core'\n\n/**\n * Optional lazy command loader function.\n * If set, ShopifyConfig will use it to load individual commands on demand\n * instead of importing the entire COMMANDS module (which triggers loading all packages).\n */\nexport type LazyCommandLoader = (id: string) => Promise<typeof Command | undefined>\n\n/**\n * Subclass of oclif's Config that loads command classes on demand for faster CLI startup.\n */\nexport class ShopifyConfig extends Config {\n  private lazyCommandLoader?: LazyCommandLoader\n\n  /**\n   * Set a lazy command loader that will be used to load individual command classes on demand,\n   * bypassing the default oclif behavior of importing the entire COMMANDS module.\n   *\n   * @param loader - The lazy command loader function.\n   */\n  setLazyCommandLoader(loader: LazyCommandLoader): void {\n    this.lazyCommandLoader = loader\n  }\n\n  /**\n   * Override runCommand to use lazy loading when available.\n   * Instead of calling cmd.load() which triggers loading ALL commands via index.js,\n   * we directly import only the needed command module.\n   *\n   * @param id - The command ID to run.\n   * @param argv - The arguments to pass to the command.\n   * @param cachedCommand - An optional cached command loadable.\n   * @returns The command result.\n   */\n  async runCommand<T = unknown>(\n    id: string,\n    argv: string[] = [],\n    cachedCommand: Command.Loadable | null = null,\n  ): Promise<T> {\n    if (!this.lazyCommandLoader) {\n      return super.runCommand<T>(id, argv, cachedCommand)\n    }\n\n    const cmd = cachedCommand ?? this.findCommand(id)\n    if (!cmd) {\n      return super.runCommand<T>(id, argv, cachedCommand)\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const commandClass = (await this.lazyCommandLoader(id)) as any\n    if (!commandClass) {\n      return super.runCommand<T>(id, argv, cachedCommand)\n    }\n\n    commandClass.id = id\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    commandClass.plugin = cmd.plugin ?? (this as any).rootPlugin\n    await this.runHook('prerun', {argv, Command: commandClass})\n    const result = (await commandClass.run(argv, this)) as T\n    await this.runHook('postrun', {argv, Command: commandClass, result})\n    return result\n  }\n}\n"]}
+{"version":3,"file":"custom-oclif-loader.js","sourceRoot":"","sources":["../../../src/public/node/custom-oclif-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,8BAA8B,EAAC,MAAM,qBAAqB,CAAA;AAClE,OAAO,EAAU,MAAM,EAAC,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,MAAM,IAAI,CAAA;AASnB;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,MAAM;IAC/B,iBAAiB,CAAoB;IAE7C;;;;;OAKG;IACH,oBAAoB,CAAC,MAAyB;QAC5C,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAA;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI;QACR,mCAAmC,EAAE,CAAA;QACrC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAA;IACrB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,UAAU,CACd,EAAU,EACV,OAAiB,EAAE,EACnB,gBAAyC,IAAI;QAE7C,OAAO,8BAA8B,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YACrD,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC5B,OAAO,KAAK,CAAC,UAAU,CAAI,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,CAAA;YACrD,CAAC;YAED,MAAM,GAAG,GAAG,aAAa,IAAI,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;YACjD,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,KAAK,CAAC,UAAU,CAAI,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,CAAA;YACrD,CAAC;YAED,8DAA8D;YAC9D,MAAM,YAAY,GAAG,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAQ,CAAA;YAC9D,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,OAAO,KAAK,CAAC,UAAU,CAAI,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,CAAA;YACrD,CAAC;YAED,YAAY,CAAC,EAAE,GAAG,EAAE,CAAA;YACpB,8DAA8D;YAC9D,YAAY,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,IAAK,IAAY,CAAC,UAAU,CAAA;YAC5D,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAC,CAAC,CAAA;YAC3D,MAAM,MAAM,GAAG,CAAC,MAAM,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAM,CAAA;YACxD,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAC,CAAC,CAAA;YACpE,OAAO,MAAM,CAAA;QACf,CAAC,CAAC,CAAA;IACJ,CAAC;CACF;AAED,wGAAwG;AACxG,yEAAyE;AACzE,SAAS,mCAAmC;IAC1C,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS;QAAE,OAAM;IAE3C,IAAI,CAAC;QACH,EAAE,CAAC,QAAQ,EAAE,CAAA;QACb,qDAAqD;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,SAAS,CAAA;IAC/B,CAAC;AACH,CAAC","sourcesContent":["import {runWithCommandEventsForCommand} from './command-events.js'\nimport {Command, Config} from '@oclif/core'\nimport os from 'os'\n\n/**\n * Optional lazy command loader function.\n * If set, ShopifyConfig will use it to load individual commands on demand\n * instead of importing the entire COMMANDS module (which triggers loading all packages).\n */\nexport type LazyCommandLoader = (id: string) => Promise<typeof Command | undefined>\n\n/**\n * Subclass of oclif's Config that loads command classes on demand for faster CLI startup.\n */\nexport class ShopifyConfig extends Config {\n  private lazyCommandLoader?: LazyCommandLoader\n\n  /**\n   * Set a lazy command loader that will be used to load individual command classes on demand,\n   * bypassing the default oclif behavior of importing the entire COMMANDS module.\n   *\n   * @param loader - The lazy command loader function.\n   */\n  setLazyCommandLoader(loader: LazyCommandLoader): void {\n    this.lazyCommandLoader = loader\n  }\n\n  /**\n   * Override load to protect oclif's shell detection from a failing OS user lookup.\n   *\n   * @returns A promise that resolves once the config is loaded.\n   */\n  async load(): Promise<void> {\n    setShellVariableWhenUserLookupFails()\n    return super.load()\n  }\n\n  /**\n   * Override runCommand to use lazy loading when available.\n   * Instead of calling cmd.load() which triggers loading ALL commands via index.js,\n   * we directly import only the needed command module.\n   *\n   * @param id - The command ID to run.\n   * @param argv - The arguments to pass to the command.\n   * @param cachedCommand - An optional cached command loadable.\n   * @returns The command result.\n   */\n  async runCommand<T = unknown>(\n    id: string,\n    argv: string[] = [],\n    cachedCommand: Command.Loadable | null = null,\n  ): Promise<T> {\n    return runWithCommandEventsForCommand(argv, async () => {\n      if (!this.lazyCommandLoader) {\n        return super.runCommand<T>(id, argv, cachedCommand)\n      }\n\n      const cmd = cachedCommand ?? this.findCommand(id)\n      if (!cmd) {\n        return super.runCommand<T>(id, argv, cachedCommand)\n      }\n\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const commandClass = (await this.lazyCommandLoader(id)) as any\n      if (!commandClass) {\n        return super.runCommand<T>(id, argv, cachedCommand)\n      }\n\n      commandClass.id = id\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      commandClass.plugin = cmd.plugin ?? (this as any).rootPlugin\n      await this.runHook('prerun', {argv, Command: commandClass})\n      const result = (await commandClass.run(argv, this)) as T\n      await this.runHook('postrun', {argv, Command: commandClass, result})\n      return result\n    })\n  }\n}\n\n// oclif reads SHELL and falls back to os.userInfo(), which throws when the OS can't resolve the current\n// user, killing the CLI during load. Remove once oclif guards that call.\nfunction setShellVariableWhenUserLookupFails(): void {\n  if (process.env.SHELL !== undefined) return\n\n  try {\n    os.userInfo()\n    // eslint-disable-next-line no-catch-all/no-catch-all\n  } catch {\n    process.env.SHELL = 'unknown'\n  }\n}\n"]}

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

@@ -42,9 +42,10 @@ export declare function getIdentityTokenInformation(): {
  * Checks if the JSON output is enabled via flag (--json or -j) or environment variable (SHOPIFY_FLAG_JSON).
  *
  * @param environment - Process environment variables.
+ * @param argv - Command arguments to inspect for JSON flags.
  * @returns True if the JSON output is enabled, false otherwise.
  */
-export declare function jsonOutputEnabled(environment?: NodeJS.ProcessEnv): boolean;
+export declare function jsonOutputEnabled(environment?: NodeJS.ProcessEnv, argv?: string[]): boolean;
 /**
  * If true, the CLI should not use the network level retry.
  *

package/dist/public/node/environment.js

@@ -67,10 +67,11 @@ export function getIdentityTokenInformation() {
  * Checks if the JSON output is enabled via flag (--json or -j) or environment variable (SHOPIFY_FLAG_JSON).
  *
  * @param environment - Process environment variables.
+ * @param argv - Command arguments to inspect for JSON flags.
  * @returns True if the JSON output is enabled, false otherwise.
  */
-export function jsonOutputEnabled(environment = getEnvironmentVariables()) {
-    return sniffForJson() || isTruthy(environment[environmentVariables.json]);
+export function jsonOutputEnabled(environment = getEnvironmentVariables(), argv = process.argv) {
+    return sniffForJson(argv) || isTruthy(environment[environmentVariables.json]);
 }
 /**
  * If true, the CLI should not use the network level retry.

package/dist/public/node/environment.js.map

@@ -1 +1 @@
-{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/public/node/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,aAAa,CAAA;AACzC,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAA;AAC/C,OAAO,EAAC,YAAY,EAAC,MAAM,WAAW,CAAA;AACtC,OAAO,EAAC,oBAAoB,EAAE,0BAA0B,EAAC,MAAM,iCAAiC,CAAA;AAEhG;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,OAAO,CAAC,GAAG,CAAA;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;IACrC,OAAO,GAAG,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,IAAI,GAAG,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAA;AAChG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,uBAAuB,EAAE,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAA;AACrE,CAAC;AAED,SAAS,cAAc,CAAC,KAAyB;IAC/C,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,cAAc,CAAC,uBAAuB,EAAE,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC,CAAA;AAC1F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,aAAa,GAAG,uBAAuB,EAAE,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAA;IACnF,MAAM,YAAY,GAAG,uBAAuB,EAAE,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAA;IACjF,IAAI,CAAC,aAAa,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAA;IACrD,OAAO;QACL,WAAW,EAAE,aAAa;QAC1B,YAAY;QACZ,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC;KACrC,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAW,GAAG,uBAAuB,EAAE;IACvE,OAAO,YAAY,EAAE,IAAI,QAAQ,CAAC,WAAW,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAA;AAC3E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAW,GAAG,uBAAuB,EAAE;IAC3E,OAAO,QAAQ,CAAC,WAAW,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC,CAAA;AAC1E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,+BAA+B,CAAC,WAAW,GAAG,uBAAuB,EAAE;IACrF,OAAO,cAAc,CAAC,WAAW,CAAC,oBAAoB,CAAC,6BAA6B,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,CAAA;AACrG,CAAC","sourcesContent":["import {nonRandomUUID} from './crypto.js'\nimport {isTruthy} from './context/utilities.js'\nimport {sniffForJson} from './path.js'\nimport {environmentVariables, systemEnvironmentVariables} from '../../private/node/constants.js'\n\n/**\n * It returns the environment variables of the environment\n * where the Node process is running.\n *\n * This function exists to prevent the access of the process\n * global variable which is discouraged via the no-process-env\n * ESLint rule.\n *\n * @returns Current process environment variables.\n */\nexport function getEnvironmentVariables(): NodeJS.ProcessEnv {\n  return process.env\n}\n\n/**\n * Returns the value of the SHOPIFY_APP_AUTOMATION_TOKEN environment variable,\n * falling back to the deprecated SHOPIFY_CLI_PARTNERS_TOKEN.\n *\n * @returns The app automation token value, or undefined if neither env var is set.\n */\nexport function getAppAutomationToken(): string | undefined {\n  const env = getEnvironmentVariables()\n  return env[environmentVariables.appAutomationToken] ?? env[environmentVariables.partnersToken]\n}\n\n/**\n * Returns the value of the organization id from the environment variables.\n *\n * @returns True if the current proccess is running using the partners token.\n */\nexport function getOrganization(): string | undefined {\n  return getEnvironmentVariables()[environmentVariables.organization]\n}\n\nfunction parseEnvNumber(value: string | undefined): number | undefined {\n  if (value && !isNaN(Number(value))) {\n    return Number(value)\n  }\n  return undefined\n}\n\n/**\n * Return the backend port value.\n *\n * @returns The port as a number. Undefined otherwise.\n */\nexport function getBackendPort(): number | undefined {\n  return parseEnvNumber(getEnvironmentVariables()[systemEnvironmentVariables.backendPort])\n}\n\n/**\n * Returns the information of the identity & refresh tokens, provided by environment variables.\n *\n * @returns The identity token information in case it exists.\n */\nexport function getIdentityTokenInformation(): {accessToken: string; refreshToken: string; userId: string} | undefined {\n  const identityToken = getEnvironmentVariables()[environmentVariables.identityToken]\n  const refreshToken = getEnvironmentVariables()[environmentVariables.refreshToken]\n  if (!identityToken || !refreshToken) return undefined\n  return {\n    accessToken: identityToken,\n    refreshToken,\n    userId: nonRandomUUID(identityToken),\n  }\n}\n\n/**\n * Checks if the JSON output is enabled via flag (--json or -j) or environment variable (SHOPIFY_FLAG_JSON).\n *\n * @param environment - Process environment variables.\n * @returns True if the JSON output is enabled, false otherwise.\n */\nexport function jsonOutputEnabled(environment = getEnvironmentVariables()): boolean {\n  return sniffForJson() || isTruthy(environment[environmentVariables.json])\n}\n\n/**\n * If true, the CLI should not use the network level retry.\n *\n * If there is an error when calling a network API that looks like a DNS or connectivity issue, the CLI will by default\n * automatically retry the request.\n *\n * @param environment - Process environment variables.\n * @returns True if the SHOPIFY_CLI_SKIP_NETWORK_LEVEL_RETRY environment variable is set.\n */\nexport function skipNetworkLevelRetry(environment = getEnvironmentVariables()): boolean {\n  return isTruthy(environment[environmentVariables.skipNetworkLevelRetry])\n}\n\n/**\n * Returns the default maximum request time for network calls in milliseconds.\n *\n * After this long, API requests may be cancelled by an AbortSignal. The limit can be overridden by setting the\n * SHOPIFY_CLI_MAX_REQUEST_TIME_FOR_NETWORK_CALLS environment variable.\n *\n * @param environment - Process environment variables.\n * @returns The maximum request time in milliseconds.\n */\nexport function maxRequestTimeForNetworkCallsMs(environment = getEnvironmentVariables()): number {\n  return parseEnvNumber(environment[environmentVariables.maxRequestTimeForNetworkCalls]) ?? 30 * 1000\n}\n"]}
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/public/node/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,aAAa,CAAA;AACzC,OAAO,EAAC,QAAQ,EAAC,MAAM,wBAAwB,CAAA;AAC/C,OAAO,EAAC,YAAY,EAAC,MAAM,WAAW,CAAA;AACtC,OAAO,EAAC,oBAAoB,EAAE,0BAA0B,EAAC,MAAM,iCAAiC,CAAA;AAEhG;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,OAAO,CAAC,GAAG,CAAA;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAA;IACrC,OAAO,GAAG,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,IAAI,GAAG,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAA;AAChG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,uBAAuB,EAAE,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAA;AACrE,CAAC;AAED,SAAS,cAAc,CAAC,KAAyB;IAC/C,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,cAAc,CAAC,uBAAuB,EAAE,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC,CAAA;AAC1F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,aAAa,GAAG,uBAAuB,EAAE,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAA;IACnF,MAAM,YAAY,GAAG,uBAAuB,EAAE,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAA;IACjF,IAAI,CAAC,aAAa,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAA;IACrD,OAAO;QACL,WAAW,EAAE,aAAa;QAC1B,YAAY;QACZ,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC;KACrC,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAW,GAAG,uBAAuB,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI;IAC5F,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAA;AAC/E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAW,GAAG,uBAAuB,EAAE;IAC3E,OAAO,QAAQ,CAAC,WAAW,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC,CAAA;AAC1E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,+BAA+B,CAAC,WAAW,GAAG,uBAAuB,EAAE;IACrF,OAAO,cAAc,CAAC,WAAW,CAAC,oBAAoB,CAAC,6BAA6B,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,CAAA;AACrG,CAAC","sourcesContent":["import {nonRandomUUID} from './crypto.js'\nimport {isTruthy} from './context/utilities.js'\nimport {sniffForJson} from './path.js'\nimport {environmentVariables, systemEnvironmentVariables} from '../../private/node/constants.js'\n\n/**\n * It returns the environment variables of the environment\n * where the Node process is running.\n *\n * This function exists to prevent the access of the process\n * global variable which is discouraged via the no-process-env\n * ESLint rule.\n *\n * @returns Current process environment variables.\n */\nexport function getEnvironmentVariables(): NodeJS.ProcessEnv {\n  return process.env\n}\n\n/**\n * Returns the value of the SHOPIFY_APP_AUTOMATION_TOKEN environment variable,\n * falling back to the deprecated SHOPIFY_CLI_PARTNERS_TOKEN.\n *\n * @returns The app automation token value, or undefined if neither env var is set.\n */\nexport function getAppAutomationToken(): string | undefined {\n  const env = getEnvironmentVariables()\n  return env[environmentVariables.appAutomationToken] ?? env[environmentVariables.partnersToken]\n}\n\n/**\n * Returns the value of the organization id from the environment variables.\n *\n * @returns True if the current proccess is running using the partners token.\n */\nexport function getOrganization(): string | undefined {\n  return getEnvironmentVariables()[environmentVariables.organization]\n}\n\nfunction parseEnvNumber(value: string | undefined): number | undefined {\n  if (value && !isNaN(Number(value))) {\n    return Number(value)\n  }\n  return undefined\n}\n\n/**\n * Return the backend port value.\n *\n * @returns The port as a number. Undefined otherwise.\n */\nexport function getBackendPort(): number | undefined {\n  return parseEnvNumber(getEnvironmentVariables()[systemEnvironmentVariables.backendPort])\n}\n\n/**\n * Returns the information of the identity & refresh tokens, provided by environment variables.\n *\n * @returns The identity token information in case it exists.\n */\nexport function getIdentityTokenInformation(): {accessToken: string; refreshToken: string; userId: string} | undefined {\n  const identityToken = getEnvironmentVariables()[environmentVariables.identityToken]\n  const refreshToken = getEnvironmentVariables()[environmentVariables.refreshToken]\n  if (!identityToken || !refreshToken) return undefined\n  return {\n    accessToken: identityToken,\n    refreshToken,\n    userId: nonRandomUUID(identityToken),\n  }\n}\n\n/**\n * Checks if the JSON output is enabled via flag (--json or -j) or environment variable (SHOPIFY_FLAG_JSON).\n *\n * @param environment - Process environment variables.\n * @param argv - Command arguments to inspect for JSON flags.\n * @returns True if the JSON output is enabled, false otherwise.\n */\nexport function jsonOutputEnabled(environment = getEnvironmentVariables(), argv = process.argv): boolean {\n  return sniffForJson(argv) || isTruthy(environment[environmentVariables.json])\n}\n\n/**\n * If true, the CLI should not use the network level retry.\n *\n * If there is an error when calling a network API that looks like a DNS or connectivity issue, the CLI will by default\n * automatically retry the request.\n *\n * @param environment - Process environment variables.\n * @returns True if the SHOPIFY_CLI_SKIP_NETWORK_LEVEL_RETRY environment variable is set.\n */\nexport function skipNetworkLevelRetry(environment = getEnvironmentVariables()): boolean {\n  return isTruthy(environment[environmentVariables.skipNetworkLevelRetry])\n}\n\n/**\n * Returns the default maximum request time for network calls in milliseconds.\n *\n * After this long, API requests may be cancelled by an AbortSignal. The limit can be overridden by setting the\n * SHOPIFY_CLI_MAX_REQUEST_TIME_FOR_NETWORK_CALLS environment variable.\n *\n * @param environment - Process environment variables.\n * @returns The maximum request time in milliseconds.\n */\nexport function maxRequestTimeForNetworkCallsMs(environment = getEnvironmentVariables()): number {\n  return parseEnvNumber(environment[environmentVariables.maxRequestTimeForNetworkCalls]) ?? 30 * 1000\n}\n"]}

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

@@ -0,0 +1,91 @@
+import { OutputMessage } from '../output.js';
+import { type InlineToken, type TokenItem } from '../../../private/node/ui/components/token-item.js';
+import type { AlertCustomSection } from '../ui.js';
+export declare enum FatalErrorType {
+    Abort = 0,
+    AbortSilent = 1,
+    Bug = 2
+}
+export declare class CancelExecution extends Error {
+}
+/**
+ * A fatal error represents an error shouldn't be rescued and that causes the execution to terminate.
+ * There shouldn't be code that catches fatal errors.
+ */
+export declare abstract class FatalError extends Error {
+    tryMessage: TokenItem | null;
+    type: FatalErrorType;
+    nextSteps?: TokenItem<InlineToken>[];
+    formattedMessage?: TokenItem;
+    customSections?: AlertCustomSection[];
+    /** A stable code for JSON consumers to identify this error, included only when known. */
+    code?: string;
+    /** Selected JSON-serializable data to include in JSON errors. Never attach the raw error or request. */
+    details?: unknown;
+    skipOclifErrorHandling: boolean;
+    /**
+     * Creates a new FatalError error.
+     *
+     * @param message - The error message.
+     * @param type - The type of fatal error.
+     * @param tryMessage - The message that recommends next steps to the user.
+     * You can pass a string a {@link TokenizedString} or a {@link TokenItem}
+     * if you need to style the message inside the error Banner component.
+     * @param nextSteps - Message to show as "next steps" with suggestions to solve the issue.
+     * @param customSections - Custom sections to show in the error banner. To be used if nextSteps is not enough.
+     */
+    constructor(message: TokenItem | OutputMessage, type: FatalErrorType, tryMessage?: TokenItem | OutputMessage | null, nextSteps?: TokenItem<InlineToken>[], customSections?: AlertCustomSection[]);
+}
+/**
+ * An abort error is a fatal error that shouldn't be reported as a bug.
+ * Those usually represent unexpected scenarios that we can't handle and that usually require some action from the developer.
+ */
+export declare class AbortError extends FatalError {
+    constructor(message: TokenItem | OutputMessage, tryMessage?: TokenItem | OutputMessage | null, nextSteps?: TokenItem<InlineToken>[], customSections?: AlertCustomSection[]);
+}
+/**
+ * An external error is similar to Abort but has extra command and args attributes.
+ * This is useful to represent errors coming from external commands, usually executed by execa.
+ */
+export declare class ExternalError extends FatalError {
+    command: string;
+    args: string[];
+    constructor(message: OutputMessage, command: string, args: string[], tryMessage?: TokenItem | OutputMessage | null);
+}
+export declare class AbortSilentError extends FatalError {
+    constructor();
+}
+/**
+ * A bug error is an error that represents a bug and therefore should be reported.
+ */
+export declare class BugError extends FatalError {
+    constructor(message: TokenItem | OutputMessage, tryMessage?: TokenItem | OutputMessage | null);
+}
+/**
+ * A function that handles errors that blow up in the CLI.
+ *
+ * @param error - Error to be handled.
+ * @returns A promise that resolves with the error passed.
+ */
+export declare function handler(error: unknown): Promise<unknown>;
+/**
+ * A function that maps an error to an Abort with the stack trace when coming from the CLI.
+ *
+ * @param error - Error to be mapped.
+ * @returns A promise that resolves with the new error object.
+ */
+export declare function errorMapper(error: unknown): Promise<unknown>;
+/**
+ * A function that checks if an error should be reported as unexpected.
+ *
+ * @param error - Error to be checked.
+ * @returns A boolean indicating if the error should be reported as unexpected.
+ */
+export declare function shouldReportErrorAsUnexpected(error: unknown): boolean;
+/**
+ * Stack traces usually have file:// - we strip that and also remove the Windows drive designation.
+ *
+ * @param filePath - Path to be cleaned.
+ * @returns The cleaned path.
+ */
+export declare function cleanSingleStackTracePath(filePath: string): string;