@shopify/cli-kit 0.0.0-nightly-20230110194301

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

@@ -0,0 +1,172 @@
+import { errorHandler, registerCleanBugsnagErrorsFromWithinPlugins } from './error-handler.js';
+import { loadPresetsFromDirectory } from './presets.js';
+import { isDevelopment } from '../../environment/local.js';
+import { Abort } from '../../error.js';
+import { addPublic } from '../../metadata.js';
+import { content, info, token } from '../../output.js';
+import { hashString } from '../../string.js';
+import { isTruthy } from '../../environment/utilities.js';
+import { Command } from '@oclif/core';
+class BaseCommand extends Command {
+    static analyticsNameOverride() {
+        return undefined;
+    }
+    async catch(error) {
+        await errorHandler(error, this.config);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async init() {
+        this.exitWithTimestampWhenEnvVariablePresent();
+        if (!isDevelopment()) {
+            // This function runs just prior to `run`
+            await registerCleanBugsnagErrorsFromWithinPlugins(this.config);
+        }
+        return super.init();
+    }
+    // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+    exitWithTimestampWhenEnvVariablePresent() {
+        if (isTruthy(process.env.SHOPIFY_CLI_ENV_STARTUP_PERFORMANCE_RUN)) {
+            info(`
+      SHOPIFY_CLI_TIMESTAMP_START
+      { "timestamp": ${Date.now()} }
+      SHOPIFY_CLI_TIMESTAMP_END
+      `);
+            process.exit(0);
+        }
+    }
+    async parse(options, argv) {
+        let result = await super.parse(options, argv);
+        result = await this.resultWithPreset(result, options, argv);
+        await addFromParsedFlags(result.flags);
+        return result;
+    }
+    async resultWithPreset(originalResult, options, argv) {
+        // If no preset is specified, don't modify the results
+        const flags = originalResult.flags;
+        if (!flags.preset)
+            return originalResult;
+        // If the specified preset isn't found, don't modify the results
+        const presets = await loadPresetsFromDirectory(await this.presetsPath(flags), { findUp: this.findUpForPresets() });
+        const preset = presets[flags.preset];
+        if (!preset)
+            return originalResult;
+        // Parse using noDefaultsOptions to derive a list of flags specified as
+        // command-line arguments.
+        const noDefaultsResult = await super.parse(noDefaultsOptions(options), argv);
+        // Add the preset's settings to argv and pass them to `super.parse`. This
+        // invokes oclif's validation system without breaking the oclif black box.
+        // Replace the original result with this one.
+        const result = await super.parse(options, [
+            // Need to specify argv default because we're merging with argsFromPreset.
+            ...(argv || this.argv),
+            ...argsFromPreset(preset, options, noDefaultsResult),
+        ]);
+        // Report successful application of the preset.
+        reportPresetApplication(noDefaultsResult.flags, result.flags, flags.preset, preset);
+        return result;
+    }
+    async presetsPath(rawFlags) {
+        return rawFlags.path || process.cwd();
+    }
+    findUpForPresets() {
+        return true;
+    }
+}
+export async function addFromParsedFlags(flags) {
+    await addPublic(() => ({
+        cmd_all_verbose: flags.verbose,
+        cmd_all_path_override: flags.path !== undefined,
+        cmd_all_path_override_hash: flags.path === undefined ? undefined : hashString(flags.path),
+    }));
+}
+/**
+ * Any flag which is:
+ *
+ * 1. Present in the final set of flags
+ * 2. Specified in the preset
+ * 3. Not specified by the user as a command line argument
+ *
+ * should be reported.
+ *
+ * It doesn't matter if the preset flag's value was the same as the default; from
+ * the user's perspective, they want to know their preset was applied.
+ */
+function reportPresetApplication(noDefaultsFlags, flagsWithPresets, presetName, preset) {
+    const changes = {};
+    for (const [name, value] of Object.entries(flagsWithPresets)) {
+        const userSpecifiedThisFlag = Object.prototype.hasOwnProperty.call(noDefaultsFlags, name);
+        const presetContainsFlag = Object.prototype.hasOwnProperty.call(preset, name);
+        if (!userSpecifiedThisFlag && presetContainsFlag)
+            changes[name] = value;
+    }
+    if (Object.keys(changes).length === 0)
+        return;
+    info(content `Using applicable flags from the preset ${token.yellow(presetName)}:
+
+${Object.entries(changes)
+        .map(([name, value]) => `• ${name} = ${value}`)
+        .join('\n')}\n`);
+}
+/**
+ * Strips the defaults from configured flags. For example, if flags contains:
+ *
+ * ```
+ *   someFlag: Flags.boolean({
+ *     description: 'some flag',
+ *     default: false
+ *   })
+ * ```
+ *
+ * it becomes:
+ *
+ * ```
+ *   someFlag: Flags.boolean({
+ *     description: 'some flag'
+ *   })
+ * ```
+ *
+ * If we parse using this configuration, the only specified flags will be those
+ * the user actually passed on the command line.
+ */
+function noDefaultsOptions(options) {
+    if (!options?.flags)
+        return options;
+    return {
+        ...options,
+        flags: Object.fromEntries(Object.entries(options.flags).map(([label, settings]) => {
+            const copiedSettings = { ...settings };
+            delete copiedSettings.default;
+            return [label, copiedSettings];
+        })),
+    };
+}
+/**
+ * Converts the preset's settings to arguments as though passed on the command
+ * line, skipping any arguments the user specified on the command line.
+ */
+function argsFromPreset(preset, options, noDefaultsResult) {
+    const args = [];
+    for (const [label, value] of Object.entries(preset)) {
+        const flagIsRelevantToCommand = options?.flags && Object.prototype.hasOwnProperty.call(options.flags, label);
+        const userSpecifiedThisFlag = noDefaultsResult.flags && Object.prototype.hasOwnProperty.call(noDefaultsResult.flags, label);
+        if (flagIsRelevantToCommand && !userSpecifiedThisFlag) {
+            if (typeof value === 'boolean') {
+                if (value === true) {
+                    args.push(`--${label}`);
+                }
+                else {
+                    throw new Abort(content `Presets can only specify true for boolean flags. Attempted to set ${token.yellow(label)} to false.`);
+                }
+            }
+            else if (Array.isArray(value)) {
+                value.forEach((element) => args.push(`--${label}`, `${element}`));
+            }
+            else {
+                args.push(`--${label}`, `${value}`);
+            }
+        }
+    }
+    return args;
+}
+export default BaseCommand;
+//# sourceMappingURL=base-command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../../../src/public/node/base-command.ts"],"names":[],"mappings":"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","sourcesContent":["import {errorHandler, registerCleanBugsnagErrorsFromWithinPlugins} from './error-handler.js'\nimport {loadPresetsFromDirectory} from './presets.js'\nimport {JsonMap} from '../../private/common/json.js'\nimport {isDevelopment} from '../../environment/local.js'\nimport {Abort} from '../../error.js'\nimport {addPublic} from '../../metadata.js'\nimport {content, info, token} from '../../output.js'\nimport {hashString} from '../../string.js'\nimport {isTruthy} from '../../environment/utilities.js'\nimport {Command, Interfaces} from '@oclif/core'\n\ninterface PresettableFlags {\n  preset?: string\n  path?: string\n}\n\nabstract class BaseCommand extends Command {\n  public static analyticsNameOverride(): string | undefined {\n    return undefined\n  }\n\n  async catch(error: Error & {exitCode?: number | undefined}): Promise<void> {\n    await errorHandler(error, this.config)\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  protected async init(): Promise<any> {\n    this.exitWithTimestampWhenEnvVariablePresent()\n    if (!isDevelopment()) {\n      // This function runs just prior to `run`\n      await registerCleanBugsnagErrorsFromWithinPlugins(this.config)\n    }\n    return super.init()\n  }\n\n  // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types\n  protected exitWithTimestampWhenEnvVariablePresent() {\n    if (isTruthy(process.env.SHOPIFY_CLI_ENV_STARTUP_PERFORMANCE_RUN)) {\n      info(`\n      SHOPIFY_CLI_TIMESTAMP_START\n      { \"timestamp\": ${Date.now()} }\n      SHOPIFY_CLI_TIMESTAMP_END\n      `)\n      process.exit(0)\n    }\n  }\n\n  protected async parse<\n    TFlags extends Interfaces.FlagOutput & {path?: string; verbose?: boolean},\n    TGlobalFlags extends Interfaces.FlagOutput,\n    TArgs extends Interfaces.OutputArgs,\n  >(\n    options?: Interfaces.Input<TFlags, TGlobalFlags>,\n    argv?: string[],\n  ): Promise<Interfaces.ParserOutput<TFlags, TGlobalFlags, TArgs>> {\n    let result = await super.parse<TFlags, TGlobalFlags, TArgs>(options, argv)\n    result = await this.resultWithPreset<TFlags, TGlobalFlags, TArgs>(result, options, argv)\n    await addFromParsedFlags(result.flags)\n    return result\n  }\n\n  protected async resultWithPreset<\n    TFlags extends Interfaces.FlagOutput & {path?: string; verbose?: boolean},\n    TGlobalFlags extends Interfaces.FlagOutput,\n    TArgs extends Interfaces.OutputArgs,\n  >(\n    originalResult: Interfaces.ParserOutput<TFlags, TGlobalFlags, TArgs>,\n    options?: Interfaces.Input<TFlags, TGlobalFlags>,\n    argv?: string[],\n  ): Promise<Interfaces.ParserOutput<TFlags, TGlobalFlags, TArgs>> {\n    // If no preset is specified, don't modify the results\n    const flags = originalResult.flags as PresettableFlags\n    if (!flags.preset) return originalResult\n\n    // If the specified preset isn't found, don't modify the results\n    const presets = await loadPresetsFromDirectory(await this.presetsPath(flags), {findUp: this.findUpForPresets()})\n    const preset = presets[flags.preset]\n    if (!preset) return originalResult\n\n    // Parse using noDefaultsOptions to derive a list of flags specified as\n    // command-line arguments.\n    const noDefaultsResult = await super.parse<TFlags, TGlobalFlags, TArgs>(noDefaultsOptions(options), argv)\n\n    // Add the preset's settings to argv and pass them to `super.parse`. This\n    // invokes oclif's validation system without breaking the oclif black box.\n    // Replace the original result with this one.\n    const result = await super.parse<TFlags, TGlobalFlags, TArgs>(options, [\n      // Need to specify argv default because we're merging with argsFromPreset.\n      ...(argv || this.argv),\n      ...argsFromPreset<TFlags, TGlobalFlags, TArgs>(preset, options, noDefaultsResult),\n    ])\n\n    // Report successful application of the preset.\n    reportPresetApplication<TFlags, TGlobalFlags, TArgs>(noDefaultsResult.flags, result.flags, flags.preset, preset)\n\n    return result\n  }\n\n  protected async presetsPath(rawFlags: {path?: string}): Promise<string> {\n    return rawFlags.path || process.cwd()\n  }\n\n  protected findUpForPresets(): boolean {\n    return true\n  }\n}\n\nexport async function addFromParsedFlags(flags: {path?: string; verbose?: boolean}): Promise<void> {\n  await addPublic(() => ({\n    cmd_all_verbose: flags.verbose,\n    cmd_all_path_override: flags.path !== undefined,\n    cmd_all_path_override_hash: flags.path === undefined ? undefined : hashString(flags.path),\n  }))\n}\n\n/**\n * Any flag which is:\n *\n * 1. Present in the final set of flags\n * 2. Specified in the preset\n * 3. Not specified by the user as a command line argument\n *\n * should be reported.\n *\n * It doesn't matter if the preset flag's value was the same as the default; from\n * the user's perspective, they want to know their preset was applied.\n */\nfunction reportPresetApplication<\n  TFlags extends Interfaces.FlagOutput,\n  TGlobalFlags extends Interfaces.FlagOutput,\n  TArgs extends Interfaces.OutputArgs,\n>(\n  noDefaultsFlags: Interfaces.ParserOutput<TFlags, TGlobalFlags, TArgs>['flags'],\n  flagsWithPresets: Interfaces.ParserOutput<TFlags, TGlobalFlags, TArgs>['flags'],\n  presetName: string,\n  preset: JsonMap,\n): void {\n  const changes: JsonMap = {}\n  for (const [name, value] of Object.entries(flagsWithPresets)) {\n    const userSpecifiedThisFlag = Object.prototype.hasOwnProperty.call(noDefaultsFlags, name)\n    const presetContainsFlag = Object.prototype.hasOwnProperty.call(preset, name)\n    if (!userSpecifiedThisFlag && presetContainsFlag) changes[name] = value\n  }\n  if (Object.keys(changes).length === 0) return\n  info(content`Using applicable flags from the preset ${token.yellow(presetName)}:\n\n${Object.entries(changes)\n  .map(([name, value]) => `• ${name} = ${value}`)\n  .join('\\n')}\\n`)\n}\n\n/**\n * Strips the defaults from configured flags. For example, if flags contains:\n *\n * ```\n *   someFlag: Flags.boolean({\n *     description: 'some flag',\n *     default: false\n *   })\n * ```\n *\n * it becomes:\n *\n * ```\n *   someFlag: Flags.boolean({\n *     description: 'some flag'\n *   })\n * ```\n *\n * If we parse using this configuration, the only specified flags will be those\n * the user actually passed on the command line.\n */\n\nfunction noDefaultsOptions<TFlags extends Interfaces.FlagOutput, TGlobalFlags extends Interfaces.FlagOutput>(\n  options: Interfaces.Input<TFlags, TGlobalFlags> | undefined,\n): Interfaces.Input<TFlags, TGlobalFlags> | undefined {\n  if (!options?.flags) return options\n  return {\n    ...options,\n    flags: Object.fromEntries(\n      Object.entries(options.flags).map(([label, settings]) => {\n        const copiedSettings = {...(settings as {default?: unknown})}\n        delete copiedSettings.default\n        return [label, copiedSettings]\n      }),\n    ) as Interfaces.FlagInput<TFlags>,\n  }\n}\n\n/**\n * Converts the preset's settings to arguments as though passed on the command\n * line, skipping any arguments the user specified on the command line.\n */\nfunction argsFromPreset<\n  TFlags extends Interfaces.FlagOutput,\n  TGlobalFlags extends Interfaces.FlagOutput,\n  TArgs extends Interfaces.OutputArgs,\n>(\n  preset: JsonMap,\n  options: Interfaces.Input<TFlags, TGlobalFlags> | undefined,\n  noDefaultsResult: Interfaces.ParserOutput<TFlags, TArgs>,\n): string[] {\n  const args: string[] = []\n  for (const [label, value] of Object.entries(preset)) {\n    const flagIsRelevantToCommand = options?.flags && Object.prototype.hasOwnProperty.call(options.flags, label)\n    const userSpecifiedThisFlag =\n      noDefaultsResult.flags && Object.prototype.hasOwnProperty.call(noDefaultsResult.flags, label)\n    if (flagIsRelevantToCommand && !userSpecifiedThisFlag) {\n      if (typeof value === 'boolean') {\n        if (value === true) {\n          args.push(`--${label}`)\n        } else {\n          throw new Abort(\n            content`Presets can only specify true for boolean flags. Attempted to set ${token.yellow(label)} to false.`,\n          )\n        }\n      } else if (Array.isArray(value)) {\n        value.forEach((element) => args.push(`--${label}`, `${element}`))\n      } else {\n        args.push(`--${label}`, `${value}`)\n      }\n    }\n  }\n  return args\n}\n\nexport default BaseCommand\n"]}

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

@@ -0,0 +1,20 @@
+import { AbortError } from './error.js';
+/**
+ * An error that's thrown when a file's MD5 doesn't match the expected value.
+ * @param options - An options object that includes the file path, and the expected and actual MD5.
+ * @returns An instance of Abort.
+ */
+export declare const InvalidChecksumError: ({ file, expected, got, }: {
+    file: string;
+    expected: string;
+    got: string;
+}) => AbortError;
+/**
+ * Given a local file and a URL pointing to a remote file representing the MD5 of a local file,
+ * it validates the authenticity of the binary using an MD5 checksum.
+ * @param options - The file to validate and the URL that points to the file containing the MD5.
+ */
+export declare function validateMD5({ file, md5FileURL }: {
+    file: string;
+    md5FileURL: string;
+}): Promise<void>;

package/dist/public/node/checksum.js

@@ -0,0 +1,32 @@
+import { AbortError } from './error.js';
+import { fetch } from '../../http.js';
+import { debug, token } from '../../output.js';
+import md5File from 'md5-file';
+/**
+ * An error that's thrown when a file's MD5 doesn't match the expected value.
+ * @param options - An options object that includes the file path, and the expected and actual MD5.
+ * @returns An instance of Abort.
+ */
+export const InvalidChecksumError = ({ file, expected, got, }) => {
+    return new AbortError(`The validation of ${file} failed. We expected the checksum ${expected}, but got ${got})`);
+};
+/**
+ * Given a local file and a URL pointing to a remote file representing the MD5 of a local file,
+ * it validates the authenticity of the binary using an MD5 checksum.
+ * @param options - The file to validate and the URL that points to the file containing the MD5.
+ */
+export async function validateMD5({ file, md5FileURL }) {
+    debug(`Checking MD5 of file ${token.path(file)} against the MD5 in ${token.link('URL', md5FileURL)}`);
+    const md5Digest = await md5File(file);
+    const md5Response = await fetch(md5FileURL);
+    const md5Contents = await md5Response.text();
+    const canonicalMD5 = md5Contents.split(' ')[0];
+    if (!(canonicalMD5 === md5Digest)) {
+        throw InvalidChecksumError({
+            file,
+            got: md5Digest,
+            expected: canonicalMD5,
+        });
+    }
+}
+//# sourceMappingURL=checksum.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sourceRoot":"","sources":["../../../src/public/node/checksum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AACrC,OAAO,EAAC,KAAK,EAAC,MAAM,eAAe,CAAA;AACnC,OAAO,EAAC,KAAK,EAAE,KAAK,EAAC,MAAM,iBAAiB,CAAA;AAC5C,OAAO,OAAO,MAAM,UAAU,CAAA;AAE9B;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,EACnC,IAAI,EACJ,QAAQ,EACR,GAAG,GAKJ,EAAc,EAAE;IACf,OAAO,IAAI,UAAU,CAAC,qBAAqB,IAAI,qCAAqC,QAAQ,aAAa,GAAG,GAAG,CAAC,CAAA;AAClH,CAAC,CAAA;AACD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAC,IAAI,EAAE,UAAU,EAAqC;IACtF,KAAK,CAAC,wBAAwB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC,CAAA;IACrG,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,CAAA;IAC3C,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,CAAA;IAC5C,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;IAC/C,IAAI,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,EAAE;QACjC,MAAM,oBAAoB,CAAC;YACzB,IAAI;YACJ,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,YAAY;SACvB,CAAC,CAAA;KACH;AACH,CAAC","sourcesContent":["import {AbortError} from './error.js'\nimport {fetch} from '../../http.js'\nimport {debug, token} from '../../output.js'\nimport md5File from 'md5-file'\n\n/**\n * An error that's thrown when a file's MD5 doesn't match the expected value.\n * @param options - An options object that includes the file path, and the expected and actual MD5.\n * @returns An instance of Abort.\n */\nexport const InvalidChecksumError = ({\n  file,\n  expected,\n  got,\n}: {\n  file: string\n  expected: string\n  got: string\n}): AbortError => {\n  return new AbortError(`The validation of ${file} failed. We expected the checksum ${expected}, but got ${got})`)\n}\n/**\n * Given a local file and a URL pointing to a remote file representing the MD5 of a local file,\n * it validates the authenticity of the binary using an MD5 checksum.\n * @param options - The file to validate and the URL that points to the file containing the MD5.\n */\nexport async function validateMD5({file, md5FileURL}: {file: string; md5FileURL: string}): Promise<void> {\n  debug(`Checking MD5 of file ${token.path(file)} against the MD5 in ${token.link('URL', md5FileURL)}`)\n  const md5Digest = await md5File(file)\n  const md5Response = await fetch(md5FileURL)\n  const md5Contents = await md5Response.text()\n  const canonicalMD5 = md5Contents.split(' ')[0]!\n  if (!(canonicalMD5 === md5Digest)) {\n    throw InvalidChecksumError({\n      file,\n      got: md5Digest,\n      expected: canonicalMD5,\n    })\n  }\n}\n"]}

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

@@ -0,0 +1,29 @@
+/**
+ * IMPORTANT NOTE: Imports in this module are dynamic to ensure that "setupEnvironmentVariables" can dynamically
+ * set the DEBUG environment variable before the 'debug' package sets up its configuration when modules
+ * are loaded statically.
+ */
+interface RunCLIOptions {
+    /** The value of import.meta.url of the CLI executable module */
+    moduleURL: string;
+    development: boolean;
+}
+/**
+ * A function that abstracts away setting up the environment and running
+ * a CLI
+ * @param options - Options.
+ */
+export declare function runCLI(options: RunCLIOptions): Promise<void>;
+/**
+ * A function for create-x CLIs that automatically runs the "init" command.
+ */
+export declare function runCreateCLI(options: RunCLIOptions): Promise<void>;
+export declare function useLocalCLIIfDetected(filepath: string): Promise<boolean>;
+interface CliPackageInfo {
+    path: string;
+    bin: {
+        shopify: string;
+    };
+}
+export declare function localCliPackage(): Promise<CliPackageInfo | undefined>;
+export default runCLI;

package/dist/public/node/cli.js

@@ -0,0 +1,106 @@
+function setupEnvironmentVariables(options) {
+    /**
+     * By setting DEBUG=* when --verbose is passed we are increasing the
+     * verbosity of oclif. Oclif uses debug (https://www.npmjs.com/package/debug)
+     * for logging, and it's configured through the DEBUG= environment variable.
+     */
+    if (process.argv.includes('--verbose')) {
+        process.env.DEBUG = process.env.DEBUG ?? '*';
+    }
+    if (options.development) {
+        process.env.SHOPIFY_CLI_ENV = process.env.SHOPIFY_CLI_ENV ?? 'development';
+    }
+}
+/**
+ * A function that abstracts away setting up the environment and running
+ * a CLI
+ * @param options - Options.
+ */
+export async function runCLI(options) {
+    setupEnvironmentVariables(options);
+    /**
+     * These imports need to be dynamic because if they are static
+     * they are loaded before we set the DEBUG=* environment variable
+     * and therefore it has no effect.
+     */
+    const { errorHandler } = await import('./error-handler.js');
+    const { isDevelopment } = await import('../../environment/local.js');
+    const { run, settings, flush } = await import('@oclif/core');
+    if (isDevelopment()) {
+        settings.debug = true;
+    }
+    run(undefined, options.moduleURL)
+        .then(() => flush())
+        .catch(errorHandler);
+}
+/**
+ * A function for create-x CLIs that automatically runs the "init" command.
+ */
+export async function runCreateCLI(options) {
+    setupEnvironmentVariables(options);
+    const { findUpAndReadPackageJson } = await import('./node-package-manager.js');
+    const { moduleDirectory } = await import('../../path.js');
+    const packageJson = await findUpAndReadPackageJson(moduleDirectory(options.moduleURL));
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const packageName = packageJson.content.name;
+    const name = packageName.replace('@shopify/create-', '');
+    const initIndex = process.argv.findIndex((arg) => arg.includes('init'));
+    if (initIndex === -1) {
+        const initIndex = process.argv.findIndex((arg) => arg.match(new RegExp(`bin(\\/|\\\\)+(create-${name}|dev|run)`))) + 1;
+        process.argv.splice(initIndex, 0, 'init');
+    }
+    await runCLI(options);
+}
+export async function useLocalCLIIfDetected(filepath) {
+    const { isTruthy } = await import('../../environment/utilities.js');
+    const constants = await import('../../constants.js');
+    const { join } = await import('../../path.js');
+    const { exec } = await import('../../system.js');
+    // Temporary flag while we test out this feature and ensure it won't break anything!
+    if (!isTruthy(process.env[constants.default.environmentVariables.enableCliRedirect]))
+        return false;
+    // Setting an env variable in the child process prevents accidental recursion.
+    if (isTruthy(process.env[constants.default.environmentVariables.skipCliRedirect]))
+        return false;
+    // If already running via package manager, we can assume it's running correctly already.
+    if (process.env.npm_config_user_agent)
+        return false;
+    const cliPackage = await localCliPackage();
+    if (!cliPackage)
+        return false;
+    const correctExecutablePath = join(cliPackage.path, cliPackage.bin.shopify);
+    if (correctExecutablePath === filepath)
+        return false;
+    try {
+        await exec(correctExecutablePath, process.argv.slice(2, process.argv.length), {
+            stdio: 'inherit',
+            env: { [constants.default.environmentVariables.skipCliRedirect]: '1' },
+        });
+        // eslint-disable-next-line no-catch-all/no-catch-all, @typescript-eslint/no-explicit-any
+    }
+    catch (processError) {
+        process.exit(processError.exitCode);
+    }
+    return true;
+}
+export async function localCliPackage() {
+    const { captureOutput } = await import('../../system.js');
+    let npmListOutput = '';
+    let localShopifyCLI = {};
+    try {
+        npmListOutput = await captureOutput('npm', ['list', '@shopify/cli', '--json', '-l']);
+        localShopifyCLI = JSON.parse(npmListOutput);
+        // eslint-disable-next-line no-catch-all/no-catch-all
+    }
+    catch (err) {
+        return;
+    }
+    const dependenciesList = {
+        ...localShopifyCLI.peerDependencies,
+        ...localShopifyCLI.devDependencies,
+        ...localShopifyCLI.dependencies,
+    };
+    return dependenciesList['@shopify/cli'];
+}
+export default runCLI;
+//# sourceMappingURL=cli.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/public/node/cli.ts"],"names":[],"mappings":"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","sourcesContent":["/**\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}\n\nfunction setupEnvironmentVariables(options: Pick<RunCLIOptions, 'development'>) {\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 (process.argv.includes('--verbose')) {\n    process.env.DEBUG = process.env.DEBUG ?? '*'\n  }\n  if (options.development) {\n    process.env.SHOPIFY_CLI_ENV = process.env.SHOPIFY_CLI_ENV ?? 'development'\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(options: RunCLIOptions): Promise<void> {\n  setupEnvironmentVariables(options)\n  /**\n   * These imports need to be dynamic because if they are static\n   * they are loaded before we set the DEBUG=* environment variable\n   * and therefore it has no effect.\n   */\n  const {errorHandler} = await import('./error-handler.js')\n  const {isDevelopment} = await import('../../environment/local.js')\n  const {run, settings, flush} = await import('@oclif/core')\n\n  if (isDevelopment()) {\n    settings.debug = true\n  }\n\n  run(undefined, options.moduleURL)\n    .then(() => flush())\n    .catch(errorHandler)\n}\n\n/**\n * A function for create-x CLIs that automatically runs the \"init\" command.\n */\nexport async function runCreateCLI(options: RunCLIOptions): Promise<void> {\n  setupEnvironmentVariables(options)\n\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 = process.argv.findIndex((arg) => arg.includes('init'))\n  if (initIndex === -1) {\n    const initIndex =\n      process.argv.findIndex((arg) => arg.match(new RegExp(`bin(\\\\/|\\\\\\\\)+(create-${name}|dev|run)`))) + 1\n    process.argv.splice(initIndex, 0, 'init')\n  }\n  await runCLI(options)\n}\n\nexport async function useLocalCLIIfDetected(filepath: string): Promise<boolean> {\n  const {isTruthy} = await import('../../environment/utilities.js')\n  const constants = await import('../../constants.js')\n  const {join} = await import('../../path.js')\n  const {exec} = await import('../../system.js')\n\n  // Temporary flag while we test out this feature and ensure it won't break anything!\n  if (!isTruthy(process.env[constants.default.environmentVariables.enableCliRedirect])) return false\n\n  // Setting an env variable in the child process prevents accidental recursion.\n  if (isTruthy(process.env[constants.default.environmentVariables.skipCliRedirect])) return false\n\n  // If already running via package manager, we can assume it's running correctly already.\n  if (process.env.npm_config_user_agent) return false\n\n  const cliPackage = await localCliPackage()\n  if (!cliPackage) return false\n\n  const correctExecutablePath = join(cliPackage.path, cliPackage.bin.shopify)\n  if (correctExecutablePath === filepath) return false\n  try {\n    await exec(correctExecutablePath, process.argv.slice(2, process.argv.length), {\n      stdio: 'inherit',\n      env: {[constants.default.environmentVariables.skipCliRedirect]: '1'},\n    })\n    // eslint-disable-next-line no-catch-all/no-catch-all, @typescript-eslint/no-explicit-any\n  } catch (processError: any) {\n    process.exit(processError.exitCode)\n  }\n  return true\n}\n\ninterface CliPackageInfo {\n  path: string\n  bin: {shopify: string}\n}\n\ninterface PackageJSON {\n  dependencies?: {[packageName: string]: CliPackageInfo}\n  devDependencies?: {[packageName: string]: CliPackageInfo}\n  peerDependencies?: {[packageName: string]: CliPackageInfo}\n}\n\nexport async function localCliPackage(): Promise<CliPackageInfo | undefined> {\n  const {captureOutput} = await import('../../system.js')\n\n  let npmListOutput = ''\n  let localShopifyCLI: PackageJSON = {}\n  try {\n    npmListOutput = await captureOutput('npm', ['list', '@shopify/cli', '--json', '-l'])\n    localShopifyCLI = JSON.parse(npmListOutput)\n    // eslint-disable-next-line no-catch-all/no-catch-all\n  } catch (err) {\n    return\n  }\n  const dependenciesList = {\n    ...localShopifyCLI.peerDependencies,\n    ...localShopifyCLI.devDependencies,\n    ...localShopifyCLI.dependencies,\n  }\n  return dependenciesList['@shopify/cli']\n}\n\nexport default runCLI\n"]}

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

@@ -0,0 +1,2 @@
+import chalk from 'chalk';
+export { chalk as default };

package/dist/public/node/colors.js

@@ -0,0 +1,3 @@
+import chalk from 'chalk';
+export { chalk as default };
+//# sourceMappingURL=colors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../../src/public/node/colors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAC,KAAK,IAAI,OAAO,EAAC,CAAA","sourcesContent":["import chalk from 'chalk'\n\nexport {chalk as default}\n"]}

package/dist/public/node/dot-env.d.ts

@@ -0,0 +1,42 @@
+import { AbortError } from './error.js';
+/**
+ * Error that's thrown when the .env is not found.
+ * @param path - Path to the .env file.
+ * @returns An abort error.
+ */
+export declare const DotEnvNotFoundError: (path: string) => AbortError;
+/**
+ * This interface represents a .env file.
+ */
+export interface DotEnvFile {
+    /**
+     * Path to the .env file.
+     */
+    path: string;
+    /**
+     * Variables of the .env file.
+     */
+    variables: {
+        [name: string]: string;
+    };
+}
+/**
+ * Reads and parses a .env file.
+ * @param path - Path to the .env file
+ * @returns An in-memory representation of the .env file.
+ */
+export declare function readAndParseDotEnv(path: string): Promise<DotEnvFile>;
+/**
+ * Writes a .env file to disk.
+ * @param file - .env file to be written.
+ */
+export declare function writeDotEnv(file: DotEnvFile): Promise<void>;
+/**
+ * Given an .env file content, generates a new one with new values
+ * without removing already existing lines.
+ * @param envFileContent - .env file contents.
+ * @param updatedValues - object containing new env variables values.
+ */
+export declare function patchEnvFile(envFileContent: string | null, updatedValues: {
+    [key: string]: string | undefined;
+}): string;

package/dist/public/node/dot-env.js

@@ -0,0 +1,67 @@
+import { AbortError } from './error.js';
+import { exists, read as readFile, write as writeFile } from '../../file.js';
+import { debug, content as outputContent, token } from '../../output.js';
+import { parse, stringify } from 'envfile';
+/**
+ * Error that's thrown when the .env is not found.
+ * @param path - Path to the .env file.
+ * @returns An abort error.
+ */
+export const DotEnvNotFoundError = (path) => {
+    return new AbortError(`The environment file at ${path} does not exist.`);
+};
+/**
+ * Reads and parses a .env file.
+ * @param path - Path to the .env file
+ * @returns An in-memory representation of the .env file.
+ */
+export async function readAndParseDotEnv(path) {
+    debug(outputContent `Reading the .env file at ${token.path(path)}`);
+    if (!(await exists(path))) {
+        throw DotEnvNotFoundError(path);
+    }
+    const content = await readFile(path);
+    return {
+        path,
+        variables: parse(content),
+    };
+}
+/**
+ * Writes a .env file to disk.
+ * @param file - .env file to be written.
+ */
+export async function writeDotEnv(file) {
+    await writeFile(file.path, stringify(file.variables));
+}
+/**
+ * Given an .env file content, generates a new one with new values
+ * without removing already existing lines.
+ * @param envFileContent - .env file contents.
+ * @param updatedValues - object containing new env variables values.
+ */
+export function patchEnvFile(envFileContent, updatedValues) {
+    const outputLines = [];
+    const lines = envFileContent === null ? [] : envFileContent.split('\n');
+    const alreadyPresentKeys = [];
+    const toLine = (key, value) => `${key}=${value}`;
+    for (const line of lines) {
+        const match = line.match(/^([^=:#]+?)[=:](.*)/);
+        let lineToWrite = line;
+        if (match) {
+            const key = match[1].trim();
+            const newValue = updatedValues[key];
+            if (newValue) {
+                alreadyPresentKeys.push(key);
+                lineToWrite = toLine(key, newValue);
+            }
+        }
+        outputLines.push(lineToWrite);
+    }
+    for (const [patchKey, updatedValue] of Object.entries(updatedValues)) {
+        if (!alreadyPresentKeys.includes(patchKey)) {
+            outputLines.push(toLine(patchKey, updatedValue));
+        }
+    }
+    return outputLines.join('\n');
+}
+//# sourceMappingURL=dot-env.js.map

package/dist/public/node/dot-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dot-env.js","sourceRoot":"","sources":["../../../src/public/node/dot-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AACrC,OAAO,EAAC,MAAM,EAAE,IAAI,IAAI,QAAQ,EAAE,KAAK,IAAI,SAAS,EAAC,MAAM,eAAe,CAAA;AAC1E,OAAO,EAAC,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,KAAK,EAAC,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAC,KAAK,EAAE,SAAS,EAAC,MAAM,SAAS,CAAA;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAc,EAAE;IAC9D,OAAO,IAAI,UAAU,CAAC,2BAA2B,IAAI,kBAAkB,CAAC,CAAA;AAC1E,CAAC,CAAA;AAgBD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,KAAK,CAAC,aAAa,CAAA,4BAA4B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClE,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE;QACzB,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAA;KAChC;IACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;IACpC,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;KAC1B,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAgB;IAChD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,cAA6B,EAC7B,aAAkD;IAElD,MAAM,WAAW,GAAa,EAAE,CAAA;IAChC,MAAM,KAAK,GAAG,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAEvE,MAAM,kBAAkB,GAAa,EAAE,CAAA;IAEvC,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,KAAc,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAA;IAEjE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAA;QAC/C,IAAI,WAAW,GAAG,IAAI,CAAA;QAEtB,IAAI,KAAK,EAAE;YACT,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAA;YAC5B,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;YACnC,IAAI,QAAQ,EAAE;gBACZ,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBAC5B,WAAW,GAAG,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;aACpC;SACF;QAED,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;KAC9B;IAED,KAAK,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE;QACpE,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;YAC1C,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAA;SACjD;KACF;IAED,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC/B,CAAC","sourcesContent":["import {AbortError} from './error.js'\nimport {exists, read as readFile, write as writeFile} from '../../file.js'\nimport {debug, content as outputContent, token} from '../../output.js'\nimport {parse, stringify} from 'envfile'\n\n/**\n * Error that's thrown when the .env is not found.\n * @param path - Path to the .env file.\n * @returns An abort error.\n */\nexport const DotEnvNotFoundError = (path: string): AbortError => {\n  return new AbortError(`The environment file at ${path} does not exist.`)\n}\n\n/**\n * This interface represents a .env file.\n */\nexport interface DotEnvFile {\n  /**\n   * Path to the .env file.\n   */\n  path: string\n  /**\n   * Variables of the .env file.\n   */\n  variables: {[name: string]: string}\n}\n\n/**\n * Reads and parses a .env file.\n * @param path - Path to the .env file\n * @returns An in-memory representation of the .env file.\n */\nexport async function readAndParseDotEnv(path: string): Promise<DotEnvFile> {\n  debug(outputContent`Reading the .env file at ${token.path(path)}`)\n  if (!(await exists(path))) {\n    throw DotEnvNotFoundError(path)\n  }\n  const content = await readFile(path)\n  return {\n    path,\n    variables: parse(content),\n  }\n}\n\n/**\n * Writes a .env file to disk.\n * @param file - .env file to be written.\n */\nexport async function writeDotEnv(file: DotEnvFile): Promise<void> {\n  await writeFile(file.path, stringify(file.variables))\n}\n\n/**\n * Given an .env file content, generates a new one with new values\n * without removing already existing lines.\n * @param envFileContent - .env file contents.\n * @param updatedValues - object containing new env variables values.\n */\nexport function patchEnvFile(\n  envFileContent: string | null,\n  updatedValues: {[key: string]: string | undefined},\n): string {\n  const outputLines: string[] = []\n  const lines = envFileContent === null ? [] : envFileContent.split('\\n')\n\n  const alreadyPresentKeys: string[] = []\n\n  const toLine = (key: string, value?: string) => `${key}=${value}`\n\n  for (const line of lines) {\n    const match = line.match(/^([^=:#]+?)[=:](.*)/)\n    let lineToWrite = line\n\n    if (match) {\n      const key = match[1]!.trim()\n      const newValue = updatedValues[key]\n      if (newValue) {\n        alreadyPresentKeys.push(key)\n        lineToWrite = toLine(key, newValue)\n      }\n    }\n\n    outputLines.push(lineToWrite)\n  }\n\n  for (const [patchKey, updatedValue] of Object.entries(updatedValues)) {\n    if (!alreadyPresentKeys.includes(patchKey)) {\n      outputLines.push(toLine(patchKey, updatedValue))\n    }\n  }\n\n  return outputLines.join('\\n')\n}\n"]}

package/dist/public/node/error-handler.d.ts

@@ -0,0 +1,41 @@
+import { AbortSilent, CancelExecution } from '../../error.js';
+import { Interfaces } from '@oclif/core';
+import { Event } from '@bugsnag/js';
+export declare function errorHandler(error: (CancelExecution | AbortSilent) & {
+    exitCode?: number | undefined;
+}, config?: Interfaces.Config): void;
+export declare function errorHandler(error: Error & {
+    exitCode?: number | undefined;
+}, config?: Interfaces.Config): Promise<void>;
+/**
+ * Sends an error to Bugsnag. This is configured automatically for uncaught errors from CLI commands, but can also be used to manually record an error.
+ *
+ * @returns the reported error (this may have been tweaked for better reporting), and a bool to indicate if the error was actually submitted or not
+ */
+export declare function sendErrorToBugsnag(error: unknown): Promise<{
+    reported: false;
+    error: unknown;
+} | {
+    error: Error;
+    reported: true;
+}>;
+/**
+ * If the given file path is within a node_modules folder, remove prefix up
+ * to and including the node_modules folder.
+ *
+ * This gives us very consistent paths for errors generated by the CLI.
+ */
+export declare function cleanStackFrameFilePath({ currentFilePath, projectRoot, pluginLocations, }: {
+    currentFilePath: string;
+    projectRoot: string;
+    pluginLocations: {
+        name: string;
+        pluginPath: string;
+    }[];
+}): string;
+/**
+ * Register a Bugsnag error listener to clean up stack traces for errors within plugin code.
+ *
+ */
+export declare function registerCleanBugsnagErrorsFromWithinPlugins(config: Interfaces.Config): Promise<void>;
+export declare function addBugsnagMetadata(event: Event, config: Interfaces.Config): Promise<void>;