@shopify/cli-kit 0.0.0-nightly-20230110194301

package/dist/public/node/ruby.js

@@ -0,0 +1,234 @@
+import { coerceSemverVersion } from './semver.js';
+import { platformAndArch } from './os.js';
+import * as file from '../../file.js';
+import * as ui from '../../ui.js';
+import * as system from '../../system.js';
+import { Abort, AbortSilent } from '../../error.js';
+import { glob, join } from '../../path.js';
+import constants from '../../constants.js';
+import { content, token } from '../../output.js';
+import { Writable } from 'stream';
+const RubyCLIVersion = '2.33.1';
+const ThemeCheckVersion = '1.12.1';
+const MinBundlerVersion = '2.3.8';
+const MinRubyVersion = '2.7.5';
+/**
+ * Execute CLI 2.0 commands.
+ * Installs a version of RubyCLI as a vendor dependency in a hidden folder in the system.
+ * User must have a valid ruby+bundler environment to run any command.
+ *
+ * @param args - List of argumets to execute. (ex: ['theme', 'pull'])
+ * @param options - Options to customize the execution of cli2.
+ */
+export async function execCLI2(args, { adminSession, storefrontToken, token, directory, signal } = {}) {
+    await installCLIDependencies();
+    const env = {
+        ...process.env,
+        SHOPIFY_CLI_STOREFRONT_RENDERER_AUTH_TOKEN: storefrontToken,
+        SHOPIFY_CLI_ADMIN_AUTH_TOKEN: adminSession?.token,
+        SHOPIFY_SHOP: adminSession?.storeFqdn,
+        SHOPIFY_CLI_AUTH_TOKEN: token,
+        SHOPIFY_CLI_RUN_AS_SUBPROCESS: 'true',
+        // Bundler uses this Gemfile to understand which gems are available in the
+        // environment. We use this to specify our own Gemfile for CLI2, which exists
+        // outside the user's project directory.
+        BUNDLE_GEMFILE: join(shopifyCLIDirectory(), 'Gemfile'),
+    };
+    try {
+        await system.exec(bundleExecutable(), ['exec', 'shopify'].concat(args), {
+            stdio: 'inherit',
+            cwd: directory ?? process.cwd(),
+            env,
+            signal,
+        });
+    }
+    catch (error) {
+        // CLI2 will show it's own errors, we don't need to show an additional CLI3 error
+        throw new AbortSilent();
+    }
+}
+/**
+ * A function that installs (if needed) and runs the theme-check CLI.
+ * @param options - Options to customize the execution of theme-check.
+ * @returns A promise that resolves or rejects depending on the result of the underlying theme-check process.
+ */
+export async function execThemeCheckCLI({ directories, args, stdout, stderr, }) {
+    await installThemeCheckCLIDependencies(stdout);
+    const processes = directories.map(async (directory) => {
+        // Check that there are files aside from the extension TOML config file,
+        // otherwise theme-check will return a false failure.
+        const files = await glob(join(directory, '/**/*'));
+        const fileCount = files.filter((file) => !file.match(/\.toml$/)).length;
+        if (fileCount === 0)
+            return;
+        const customStderr = new Writable({
+            write(chunk, ...args) {
+                // For some reason, theme-check reports this initial status line to stderr
+                // See https://github.com/Shopify/theme-check/blob/1092737cfb58a73ca397ffb1371665dc55df2976/lib/theme_check/language_server/diagnostics_engine.rb#L31
+                // which leads to https://github.com/Shopify/theme-check/blob/1092737cfb58a73ca397ffb1371665dc55df2976/lib/theme_check/language_server/io_messenger.rb#L65
+                if (chunk.toString('ascii').match(/^Checking/)) {
+                    stdout.write(chunk, ...args);
+                }
+                else {
+                    stderr.write(chunk, ...args);
+                }
+            },
+        });
+        await system.exec(bundleExecutable(), ['exec', 'theme-check'].concat([directory, ...(args || [])]), {
+            stdout,
+            stderr: customStderr,
+            cwd: themeCheckDirectory(),
+        });
+    });
+    return Promise.all(processes);
+}
+/**
+ * Validate Ruby Enviroment
+ * Install Theme Check CLI and its dependencies
+ * Shows a loading message if it's the first time installing dependencies
+ * or if we are installing a new version of Theme Check CLI
+ */
+async function installThemeCheckCLIDependencies(stdout) {
+    const exists = await file.exists(themeCheckDirectory());
+    if (!exists)
+        stdout.write('Installing theme dependencies...');
+    const list = ui.newListr([
+        {
+            title: 'Installing theme dependencies',
+            task: async () => {
+                await validateRubyEnv();
+                await createThemeCheckCLIWorkingDirectory();
+                await createThemeCheckGemfile();
+                await bundleInstallThemeCheck();
+            },
+        },
+    ], { renderer: 'silent' });
+    await list.run();
+    if (!exists)
+        stdout.write('Installed theme dependencies!');
+}
+/**
+ * Validate Ruby Enviroment
+ * Install RubyCLI and its dependencies
+ * Shows a loading spinner if it's the first time installing dependencies
+ * or if we are installing a new version of RubyCLI
+ */
+async function installCLIDependencies() {
+    const exists = await file.exists(shopifyCLIDirectory());
+    const renderer = exists ? 'silent' : 'default';
+    const list = ui.newListr([
+        {
+            title: 'Installing theme dependencies',
+            task: async () => {
+                const usingLocalCLI2 = Boolean(process.env.SHOPIFY_CLI_2_0_DIRECTORY);
+                await validateRubyEnv();
+                if (usingLocalCLI2) {
+                    await bundleInstallLocalShopifyCLI();
+                }
+                else {
+                    await createShopifyCLIWorkingDirectory();
+                    await createShopifyCLIGemfile();
+                    await bundleInstallShopifyCLI();
+                }
+            },
+        },
+    ], { renderer });
+    await list.run();
+}
+async function validateRubyEnv() {
+    await validateRuby();
+    await validateBundler();
+}
+async function validateRuby() {
+    let version;
+    try {
+        const stdout = await system.captureOutput(rubyExecutable(), ['-v']);
+        version = coerceSemverVersion(stdout);
+    }
+    catch {
+        throw new Abort('Ruby environment not found', `Make sure you have Ruby installed on your system. ${content `${token.link('Documentation.', 'https://www.ruby-lang.org/en/documentation/installation/')}`.value}`);
+    }
+    const isValid = version?.compare(MinRubyVersion);
+    if (isValid === -1 || isValid === undefined) {
+        throw new Abort(`Ruby version ${content `${token.yellow(version.raw)}`.value} is not supported`, `Make sure you have at least Ruby ${content `${token.yellow(MinRubyVersion)}`.value} installed on your system. ${content `${token.link('Documentation.', 'https://www.ruby-lang.org/en/documentation/installation/')}`.value}`);
+    }
+}
+async function validateBundler() {
+    let version;
+    try {
+        const stdout = await system.captureOutput(bundleExecutable(), ['-v']);
+        version = coerceSemverVersion(stdout);
+    }
+    catch {
+        throw new Abort('Bundler not found', `To install the latest version of Bundler, run ${content `${token.genericShellCommand(`${gemExecutable()} install bundler`)}`.value}`);
+    }
+    const isValid = version?.compare(MinBundlerVersion);
+    if (isValid === -1 || isValid === undefined) {
+        throw new Abort(`Bundler version ${content `${token.yellow(version.raw)}`.value} is not supported`, `To update to the latest version of Bundler, run ${content `${token.genericShellCommand(`${gemExecutable()} install bundler`)}`.value}`);
+    }
+}
+function createShopifyCLIWorkingDirectory() {
+    return file.mkdir(shopifyCLIDirectory());
+}
+function createThemeCheckCLIWorkingDirectory() {
+    return file.mkdir(themeCheckDirectory());
+}
+async function createShopifyCLIGemfile() {
+    const gemPath = join(shopifyCLIDirectory(), 'Gemfile');
+    const gemFileContent = ["source 'https://rubygems.org'", `gem 'shopify-cli', '${RubyCLIVersion}'`];
+    const { platform } = platformAndArch();
+    if (platform === 'windows') {
+        // 'wdm' is required by 'listen', see https://github.com/Shopify/cli/issues/780
+        gemFileContent.push("gem 'wdm', '>= 0.1.0'");
+    }
+    await file.write(gemPath, gemFileContent.join('\n'));
+}
+async function createThemeCheckGemfile() {
+    const gemPath = join(themeCheckDirectory(), 'Gemfile');
+    await file.write(gemPath, `source 'https://rubygems.org'\ngem 'theme-check', '${ThemeCheckVersion}'`);
+}
+async function bundleInstallLocalShopifyCLI() {
+    await system.exec(bundleExecutable(), ['install'], { cwd: shopifyCLIDirectory() });
+}
+async function bundleInstallShopifyCLI() {
+    await system.exec(bundleExecutable(), ['config', 'set', '--local', 'path', shopifyCLIDirectory()], {
+        cwd: shopifyCLIDirectory(),
+    });
+    await system.exec(bundleExecutable(), ['install'], { cwd: shopifyCLIDirectory() });
+}
+async function bundleInstallThemeCheck() {
+    await system.exec(bundleExecutable(), ['config', 'set', '--local', 'path', themeCheckDirectory()], {
+        cwd: themeCheckDirectory(),
+    });
+    await system.exec(bundleExecutable(), ['install'], { cwd: themeCheckDirectory() });
+}
+function shopifyCLIDirectory() {
+    return (process.env.SHOPIFY_CLI_2_0_DIRECTORY ??
+        join(constants.paths.directories.cache.vendor.path(), 'ruby-cli', RubyCLIVersion));
+}
+function themeCheckDirectory() {
+    return join(constants.paths.directories.cache.vendor.path(), 'theme-check', ThemeCheckVersion);
+}
+export async function version() {
+    const parseOutput = (version) => version.match(/ruby (\d+\.\d+\.\d+)/)?.[1];
+    return system
+        .captureOutput(rubyExecutable(), ['-v'])
+        .then(parseOutput)
+        .catch(() => undefined);
+}
+function getRubyBinDir() {
+    return process.env.SHOPIFY_RUBY_BINDIR;
+}
+function rubyExecutable() {
+    const rubyBinDir = getRubyBinDir();
+    return rubyBinDir ? join(rubyBinDir, 'ruby') : 'ruby';
+}
+function bundleExecutable() {
+    const rubyBinDir = getRubyBinDir();
+    return rubyBinDir ? join(rubyBinDir, 'bundle') : 'bundle';
+}
+function gemExecutable() {
+    const rubyBinDir = getRubyBinDir();
+    return rubyBinDir ? join(rubyBinDir, 'gem') : 'gem';
+}
+//# sourceMappingURL=ruby.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ruby.js","sourceRoot":"","sources":["../../../src/public/node/ruby.ts"],"names":[],"mappings":"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","sourcesContent":["import {coerceSemverVersion} from './semver.js'\nimport {AbortSignal} from './abort.js'\nimport {platformAndArch} from './os.js'\nimport * as file from '../../file.js'\nimport * as ui from '../../ui.js'\nimport * as system from '../../system.js'\nimport {Abort, AbortSilent} from '../../error.js'\nimport {glob, join} from '../../path.js'\nimport constants from '../../constants.js'\nimport {AdminSession} from '../../session.js'\nimport {content, token} from '../../output.js'\nimport {Writable} from 'stream'\n\nconst RubyCLIVersion = '2.33.1'\nconst ThemeCheckVersion = '1.12.1'\nconst MinBundlerVersion = '2.3.8'\nconst MinRubyVersion = '2.7.5'\n\ninterface ExecCLI2Options {\n  // Contains token and store to pass to CLI 2.0, which will be set as environment variables\n  adminSession?: AdminSession\n  // Contains token for storefront access to pass to CLI 2.0 as environment variable\n  storefrontToken?: string\n  // Contains token for partners access to pass to CLI 2.0 as environment variable\n  token?: string\n  // Directory in which to execute the command. Otherwise the current directory will be used.\n  directory?: string\n\n  signal?: AbortSignal\n}\n/**\n * Execute CLI 2.0 commands.\n * Installs a version of RubyCLI as a vendor dependency in a hidden folder in the system.\n * User must have a valid ruby+bundler environment to run any command.\n *\n * @param args - List of argumets to execute. (ex: ['theme', 'pull'])\n * @param options - Options to customize the execution of cli2.\n */\nexport async function execCLI2(\n  args: string[],\n  {adminSession, storefrontToken, token, directory, signal}: ExecCLI2Options = {},\n): Promise<void> {\n  await installCLIDependencies()\n  const env = {\n    ...process.env,\n    SHOPIFY_CLI_STOREFRONT_RENDERER_AUTH_TOKEN: storefrontToken,\n    SHOPIFY_CLI_ADMIN_AUTH_TOKEN: adminSession?.token,\n    SHOPIFY_SHOP: adminSession?.storeFqdn,\n    SHOPIFY_CLI_AUTH_TOKEN: token,\n    SHOPIFY_CLI_RUN_AS_SUBPROCESS: 'true',\n    // Bundler uses this Gemfile to understand which gems are available in the\n    // environment. We use this to specify our own Gemfile for CLI2, which exists\n    // outside the user's project directory.\n    BUNDLE_GEMFILE: join(shopifyCLIDirectory(), 'Gemfile'),\n  }\n\n  try {\n    await system.exec(bundleExecutable(), ['exec', 'shopify'].concat(args), {\n      stdio: 'inherit',\n      cwd: directory ?? process.cwd(),\n      env,\n      signal,\n    })\n  } catch (error) {\n    // CLI2 will show it's own errors, we don't need to show an additional CLI3 error\n    throw new AbortSilent()\n  }\n}\n\ninterface ExecThemeCheckCLIOptions {\n  /** A list of directories in which theme-check should run */\n  directories: string[]\n  /** Arguments to pass to the theme-check CLI */\n  args?: string[]\n  /** Writable to send standard output content through */\n  stdout: Writable\n  /** Writable to send standard error content through */\n  stderr: Writable\n}\n\n/**\n * A function that installs (if needed) and runs the theme-check CLI.\n * @param options - Options to customize the execution of theme-check.\n * @returns A promise that resolves or rejects depending on the result of the underlying theme-check process.\n */\nexport async function execThemeCheckCLI({\n  directories,\n  args,\n  stdout,\n  stderr,\n}: ExecThemeCheckCLIOptions): Promise<void[]> {\n  await installThemeCheckCLIDependencies(stdout)\n\n  const processes = directories.map(async (directory): Promise<void> => {\n    // Check that there are files aside from the extension TOML config file,\n    // otherwise theme-check will return a false failure.\n    const files = await glob(join(directory, '/**/*'))\n    const fileCount = files.filter((file) => !file.match(/\\.toml$/)).length\n    if (fileCount === 0) return\n\n    const customStderr = new Writable({\n      write(chunk, ...args) {\n        // For some reason, theme-check reports this initial status line to stderr\n        // See https://github.com/Shopify/theme-check/blob/1092737cfb58a73ca397ffb1371665dc55df2976/lib/theme_check/language_server/diagnostics_engine.rb#L31\n        // which leads to https://github.com/Shopify/theme-check/blob/1092737cfb58a73ca397ffb1371665dc55df2976/lib/theme_check/language_server/io_messenger.rb#L65\n        if (chunk.toString('ascii').match(/^Checking/)) {\n          stdout.write(chunk, ...args)\n        } else {\n          stderr.write(chunk, ...args)\n        }\n      },\n    })\n    await system.exec(bundleExecutable(), ['exec', 'theme-check'].concat([directory, ...(args || [])]), {\n      stdout,\n      stderr: customStderr,\n      cwd: themeCheckDirectory(),\n    })\n  })\n  return Promise.all(processes)\n}\n\n/**\n * Validate Ruby Enviroment\n * Install Theme Check CLI and its dependencies\n * Shows a loading message if it's the first time installing dependencies\n * or if we are installing a new version of Theme Check CLI\n */\nasync function installThemeCheckCLIDependencies(stdout: Writable) {\n  const exists = await file.exists(themeCheckDirectory())\n\n  if (!exists) stdout.write('Installing theme dependencies...')\n  const list = ui.newListr(\n    [\n      {\n        title: 'Installing theme dependencies',\n        task: async () => {\n          await validateRubyEnv()\n          await createThemeCheckCLIWorkingDirectory()\n          await createThemeCheckGemfile()\n          await bundleInstallThemeCheck()\n        },\n      },\n    ],\n    {renderer: 'silent'},\n  )\n  await list.run()\n  if (!exists) stdout.write('Installed theme dependencies!')\n}\n\n/**\n * Validate Ruby Enviroment\n * Install RubyCLI and its dependencies\n * Shows a loading spinner if it's the first time installing dependencies\n * or if we are installing a new version of RubyCLI\n */\nasync function installCLIDependencies() {\n  const exists = await file.exists(shopifyCLIDirectory())\n  const renderer = exists ? 'silent' : 'default'\n\n  const list = ui.newListr(\n    [\n      {\n        title: 'Installing theme dependencies',\n        task: async () => {\n          const usingLocalCLI2 = Boolean(process.env.SHOPIFY_CLI_2_0_DIRECTORY)\n          await validateRubyEnv()\n          if (usingLocalCLI2) {\n            await bundleInstallLocalShopifyCLI()\n          } else {\n            await createShopifyCLIWorkingDirectory()\n            await createShopifyCLIGemfile()\n            await bundleInstallShopifyCLI()\n          }\n        },\n      },\n    ],\n    {renderer},\n  )\n  await list.run()\n}\n\nasync function validateRubyEnv() {\n  await validateRuby()\n  await validateBundler()\n}\n\nasync function validateRuby() {\n  let version\n  try {\n    const stdout = await system.captureOutput(rubyExecutable(), ['-v'])\n    version = coerceSemverVersion(stdout)\n  } catch {\n    throw new Abort(\n      'Ruby environment not found',\n      `Make sure you have Ruby installed on your system. ${\n        content`${token.link('Documentation.', 'https://www.ruby-lang.org/en/documentation/installation/')}`.value\n      }`,\n    )\n  }\n\n  const isValid = version?.compare(MinRubyVersion)\n  if (isValid === -1 || isValid === undefined) {\n    throw new Abort(\n      `Ruby version ${content`${token.yellow(version.raw)}`.value} is not supported`,\n      `Make sure you have at least Ruby ${content`${token.yellow(MinRubyVersion)}`.value} installed on your system. ${\n        content`${token.link('Documentation.', 'https://www.ruby-lang.org/en/documentation/installation/')}`.value\n      }`,\n    )\n  }\n}\n\nasync function validateBundler() {\n  let version\n  try {\n    const stdout = await system.captureOutput(bundleExecutable(), ['-v'])\n    version = coerceSemverVersion(stdout)\n  } catch {\n    throw new Abort(\n      'Bundler not found',\n      `To install the latest version of Bundler, run ${\n        content`${token.genericShellCommand(`${gemExecutable()} install bundler`)}`.value\n      }`,\n    )\n  }\n\n  const isValid = version?.compare(MinBundlerVersion)\n  if (isValid === -1 || isValid === undefined) {\n    throw new Abort(\n      `Bundler version ${content`${token.yellow(version.raw)}`.value} is not supported`,\n      `To update to the latest version of Bundler, run ${\n        content`${token.genericShellCommand(`${gemExecutable()} install bundler`)}`.value\n      }`,\n    )\n  }\n}\n\nfunction createShopifyCLIWorkingDirectory() {\n  return file.mkdir(shopifyCLIDirectory())\n}\n\nfunction createThemeCheckCLIWorkingDirectory() {\n  return file.mkdir(themeCheckDirectory())\n}\n\nasync function createShopifyCLIGemfile() {\n  const gemPath = join(shopifyCLIDirectory(), 'Gemfile')\n  const gemFileContent = [\"source 'https://rubygems.org'\", `gem 'shopify-cli', '${RubyCLIVersion}'`]\n  const {platform} = platformAndArch()\n  if (platform === 'windows') {\n    // 'wdm' is required by 'listen', see https://github.com/Shopify/cli/issues/780\n    gemFileContent.push(\"gem 'wdm', '>= 0.1.0'\")\n  }\n  await file.write(gemPath, gemFileContent.join('\\n'))\n}\n\nasync function createThemeCheckGemfile() {\n  const gemPath = join(themeCheckDirectory(), 'Gemfile')\n  await file.write(gemPath, `source 'https://rubygems.org'\\ngem 'theme-check', '${ThemeCheckVersion}'`)\n}\n\nasync function bundleInstallLocalShopifyCLI() {\n  await system.exec(bundleExecutable(), ['install'], {cwd: shopifyCLIDirectory()})\n}\n\nasync function bundleInstallShopifyCLI() {\n  await system.exec(bundleExecutable(), ['config', 'set', '--local', 'path', shopifyCLIDirectory()], {\n    cwd: shopifyCLIDirectory(),\n  })\n  await system.exec(bundleExecutable(), ['install'], {cwd: shopifyCLIDirectory()})\n}\n\nasync function bundleInstallThemeCheck() {\n  await system.exec(bundleExecutable(), ['config', 'set', '--local', 'path', themeCheckDirectory()], {\n    cwd: themeCheckDirectory(),\n  })\n  await system.exec(bundleExecutable(), ['install'], {cwd: themeCheckDirectory()})\n}\n\nfunction shopifyCLIDirectory() {\n  return (\n    process.env.SHOPIFY_CLI_2_0_DIRECTORY ??\n    join(constants.paths.directories.cache.vendor.path(), 'ruby-cli', RubyCLIVersion)\n  )\n}\n\nfunction themeCheckDirectory() {\n  return join(constants.paths.directories.cache.vendor.path(), 'theme-check', ThemeCheckVersion)\n}\n\nexport async function version(): Promise<string | undefined> {\n  const parseOutput = (version: string) => version.match(/ruby (\\d+\\.\\d+\\.\\d+)/)?.[1]\n  return system\n    .captureOutput(rubyExecutable(), ['-v'])\n    .then(parseOutput)\n    .catch(() => undefined)\n}\n\nfunction getRubyBinDir(): string | undefined {\n  return process.env.SHOPIFY_RUBY_BINDIR\n}\n\nfunction rubyExecutable(): string {\n  const rubyBinDir = getRubyBinDir()\n  return rubyBinDir ? join(rubyBinDir, 'ruby') : 'ruby'\n}\n\nfunction bundleExecutable(): string {\n  const rubyBinDir = getRubyBinDir()\n  return rubyBinDir ? join(rubyBinDir, 'bundle') : 'bundle'\n}\n\nfunction gemExecutable(): string {\n  const rubyBinDir = getRubyBinDir()\n  return rubyBinDir ? join(rubyBinDir, 'gem') : 'gem'\n}\n"]}

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

@@ -0,0 +1,3 @@
+declare const coerce: any, SemVer: any;
+export { SemVer as Version };
+export { coerce as coerceSemverVersion };

package/dist/public/node/semver.js

@@ -0,0 +1,6 @@
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const { coerce, SemVer } = require('semver');
+export { SemVer as Version };
+export { coerce as coerceSemverVersion };
+//# sourceMappingURL=semver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semver.js","sourceRoot":"","sources":["../../../src/public/node/semver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,QAAQ,CAAA;AAEpC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,EAAC,MAAM,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE1C,OAAO,EAAC,MAAM,IAAI,OAAO,EAAC,CAAA;AAC1B,OAAO,EAAC,MAAM,IAAI,mBAAmB,EAAC,CAAA","sourcesContent":["import {createRequire} from 'module'\n\nconst require = createRequire(import.meta.url)\nconst {coerce, SemVer} = require('semver')\n\nexport {SemVer as Version}\nexport {coerce as coerceSemverVersion}\n"]}

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

@@ -0,0 +1,5 @@
+/**
+ * Returns an available port in the current environment.
+ * @returns A promise that resolves with an availabe port.
+ */
+export declare function getAvailableTCPPort(): Promise<number>;

package/dist/public/node/tcp.js

@@ -0,0 +1,35 @@
+import { debug, content, token } from '../../output.js';
+import { Abort } from '../../error.js';
+import { sleep } from '../../system.js';
+import * as port from 'get-port-please';
+/**
+ * Returns an available port in the current environment.
+ * @returns A promise that resolves with an availabe port.
+ */
+export async function getAvailableTCPPort() {
+    debug(content `Getting a random port...`);
+    const randomPort = await retryOnError(() => port.getRandomPort());
+    debug(content `Random port obtained: ${token.raw(`${randomPort}`)}`);
+    return randomPort;
+}
+async function retryOnError(execute, maxTries = 5, waitTimeInSeconds = 1) {
+    let retryCount = 1;
+    while (true) {
+        try {
+            // eslint-disable-next-line no-await-in-loop
+            return await execute();
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        }
+        catch (error) {
+            if (retryCount++ < maxTries) {
+                debug(content `Unknown problem getting a random port: ${error.message}`);
+                // eslint-disable-next-line no-await-in-loop
+                await sleep(waitTimeInSeconds);
+            }
+            else {
+                throw new Abort(error.message);
+            }
+        }
+    }
+}
+//# sourceMappingURL=tcp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tcp.js","sourceRoot":"","sources":["../../../src/public/node/tcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAC,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAC,KAAK,EAAC,MAAM,gBAAgB,CAAA;AACpC,OAAO,EAAC,KAAK,EAAC,MAAM,iBAAiB,CAAA;AACrC,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAA;AAEvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,KAAK,CAAC,OAAO,CAAA,0BAA0B,CAAC,CAAA;IACxC,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAA;IACjE,KAAK,CAAC,OAAO,CAAA,yBAAyB,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,CAAC,CAAA;IACnE,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,KAAK,UAAU,YAAY,CAAI,OAAgB,EAAE,QAAQ,GAAG,CAAC,EAAE,iBAAiB,GAAG,CAAC;IAClF,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,OAAO,IAAI,EAAE;QACX,IAAI;YACF,4CAA4C;YAC5C,OAAO,MAAM,OAAO,EAAE,CAAA;YACtB,8DAA8D;SAC/D;QAAC,OAAO,KAAU,EAAE;YACnB,IAAI,UAAU,EAAE,GAAG,QAAQ,EAAE;gBAC3B,KAAK,CAAC,OAAO,CAAA,0CAA0C,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;gBACvE,4CAA4C;gBAC5C,MAAM,KAAK,CAAC,iBAAiB,CAAC,CAAA;aAC/B;iBAAM;gBACL,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;aAC/B;SACF;KACF;AACH,CAAC","sourcesContent":["import {debug, content, token} from '../../output.js'\nimport {Abort} from '../../error.js'\nimport {sleep} from '../../system.js'\nimport * as port from 'get-port-please'\n\n/**\n * Returns an available port in the current environment.\n * @returns A promise that resolves with an availabe port.\n */\nexport async function getAvailableTCPPort(): Promise<number> {\n  debug(content`Getting a random port...`)\n  const randomPort = await retryOnError(() => port.getRandomPort())\n  debug(content`Random port obtained: ${token.raw(`${randomPort}`)}`)\n  return randomPort\n}\n\nasync function retryOnError<T>(execute: () => T, maxTries = 5, waitTimeInSeconds = 1) {\n  let retryCount = 1\n  while (true) {\n    try {\n      // eslint-disable-next-line no-await-in-loop\n      return await execute()\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (error: any) {\n      if (retryCount++ < maxTries) {\n        debug(content`Unknown problem getting a random port: ${error.message}`)\n        // eslint-disable-next-line no-await-in-loop\n        await sleep(waitTimeInSeconds)\n      } else {\n        throw new Abort(error.message)\n      }\n    }\n  }\n}\n"]}

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

@@ -0,0 +1,184 @@
+import { OutputProcess } from '../../output.js';
+import { Fatal } from '../../error.js';
+import { AlertProps } from '../../private/node/ui/components/Alert.js';
+import { Props as SelectPromptProps } from '../../private/node/ui/components/SelectPrompt.js';
+import { Task } from '../../private/node/ui/components/Tasks.js';
+import { Props as TextPromptProps } from '../../private/node/ui/components/TextPrompt.js';
+import { RenderOptions } from 'ink';
+import { AbortController } from '@shopify/cli-kit/node/abort';
+interface RenderConcurrentOptions {
+    processes: OutputProcess[];
+    abortController?: AbortController;
+    showTimestamps?: boolean;
+    renderOptions?: RenderOptions;
+}
+/**
+ * Renders output from concurrent processes to the terminal with {@link ConcurrentOutput}.
+ */
+export declare function renderConcurrent({ processes, abortController, showTimestamps, renderOptions, }: RenderConcurrentOptions): Promise<void>;
+declare type RenderAlertOptions = Omit<AlertProps, 'type'>;
+/**
+ * Renders an information banner to the console.
+ *
+ * Basic:
+ *
+ * ```
+ * ╭─ info ───────────────────────────────────────────────────╮
+ * │                                                          │
+ * │  Body                                                    │
+ * │                                                          │
+ * ╰──────────────────────────────────────────────────────────╯
+ * ```
+ *
+ * Complete:
+ * ```
+ * ╭─ info ───────────────────────────────────────────────────╮
+ * │                                                          │
+ * │  Title                                                   │
+ * │                                                          │
+ * │  Body                                                    │
+ * │                                                          │
+ * │  Next steps                                              │
+ * │    • Run `cd santorini-goods`                            │
+ * │    • To preview your project, run `npm app dev`          │
+ * │    • To add extensions, run `npm generate extension`     │
+ * │                                                          │
+ * │  Reference                                               │
+ * │    • Run `npm shopify help`                              │
+ * │    • Press 'return' to open the dev docs:                │
+ * │      https://shopify.dev                                 │
+ * │                                                          │
+ * │  Link: https://shopify.com                               │
+ * │                                                          │
+ * ╰──────────────────────────────────────────────────────────╯
+ * ```
+ */
+export declare function renderInfo(options: RenderAlertOptions): void;
+/**
+ * Renders a success banner to the console.
+ *
+ * Basic:
+ *
+ * ```
+ * ╭─ success ────────────────────────────────────────────────╮
+ * │                                                          │
+ * │  Title                                                   │
+ * │                                                          │
+ * ╰──────────────────────────────────────────────────────────╯
+ * ```
+ *
+ * Complete:
+ * ```
+ * ╭─ success ────────────────────────────────────────────────╮
+ * │                                                          │
+ * │  Title                                                   │
+ * │                                                          │
+ * │  Body                                                    │
+ * │                                                          │
+ * │  Next steps                                              │
+ * │    • Run `cd santorini-goods`                              │
+ * │    • To preview your project, run `npm app dev`            │
+ * │    • To add extensions, run `npm generate extension`       │
+ * │                                                          │
+ * │  Reference                                               │
+ * │    • Run `npm shopify help`                                │
+ * │    • Press 'return' to open the dev docs:                │
+ * │      https://shopify.dev                                 │
+ * │                                                          │
+ * │  Link: https://shopify.com                               │
+ * │                                                          │
+ * ╰──────────────────────────────────────────────────────────╯
+ * ```
+ */
+export declare function renderSuccess(options: RenderAlertOptions): void;
+/**
+ * Renders a warning banner to the console.
+ *
+ * Basic:
+ *
+ * ```
+ * ╭─ warning ────────────────────────────────────────────────╮
+ * │                                                          │
+ * │  Title                                                   │
+ * │                                                          │
+ * ╰──────────────────────────────────────────────────────────╯
+ * ```
+ *
+ * Complete:
+ * ```
+ * ╭─ warning ────────────────────────────────────────────────╮
+ * │                                                          │
+ * │  Title                                                   │
+ * │                                                          │
+ * │  Body                                                    │
+ * │                                                          │
+ * │  Next steps                                              │
+ * │    • Run `cd santorini-goods`                            │
+ * │    • To preview your project, run `npm app dev`          │
+ * │    • To add extensions, run `npm generate extension`     │
+ * │                                                          │
+ * │  Reference                                               │
+ * │    • Run `npm shopify help`                              │
+ * │    • Press 'return' to open the dev docs:                │
+ * │      https://shopify.dev                                 │
+ * │                                                          │
+ * │  Link: https://shopify.com                               │
+ * │                                                          │
+ * ╰──────────────────────────────────────────────────────────╯
+ * ```
+ */
+export declare function renderWarning(options: RenderAlertOptions): void;
+/**
+ * Renders a Fatal error to the console inside a banner.
+ *
+ * ```
+ * ╭─ error ──────────────────────────────────────────────────╮
+ * │                                                          │
+ * │  Couldn't connect to the Shopify Partner Dashboard.      │
+ * │                                                          │
+ * │  Check your internet connection and try again.           │
+ * │                                                          │
+ * ╰──────────────────────────────────────────────────────────╯
+ * ```
+ */
+export declare function renderFatalError(error: Fatal): void;
+/**
+ * Renders a select prompt to the console.
+ *
+ * ?  Associate your project with the org Castile Ventures?
+ *
+ *      Add:     • new-ext
+ *
+ *      Remove:  • integrated-demand-ext
+ *               • order-discount
+
+ * \>  (f) first
+ *     (s) second
+ *     (3) third
+ *     (4) fourth
+ *     (5) seventh
+ *     (6) tenth
+
+ *     Automations
+ *     (7) fifth
+ *     (8) sixth
+
+ *     Merchant Admin
+ *     (9) eighth
+ *     (10) ninth
+
+ *     navigate with arrows, enter to select
+ */
+export declare function renderSelectPrompt<T>(props: Omit<SelectPromptProps<T>, 'onSubmit'>): Promise<unknown>;
+/**
+ * Runs async tasks and displays their progress to the console.
+ */
+export declare function renderTasks(tasks: Task[]): Promise<void>;
+/**
+ * Renders a text prompt to the console.
+ *
+ * ?  What is your name?
+ * \>  John
+ */
+export declare function renderTextPrompt(props: Omit<TextPromptProps, 'onSubmit'>): Promise<unknown>;
+export {};