shopify-cli 2.11.2 → 2.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a98682c26b1f02a7a24648c23bb987ceab5a70939e031957e80785c1068d849
-  data.tar.gz: bfddf7b2f92004d654a66fa8746619d724789c65da7b236e413857fd8705c65f
+  metadata.gz: ee0786bedc79f0e7fb3646adc5161faeb0fb2f4f15c6147394782db33236f425
+  data.tar.gz: 13d805804c7764151bfdd80747e879bd480ffcf85ba91fa280b776b93f784855
 SHA512:
-  metadata.gz: 33830ff754743290463c4744cd6e76c37fcf72f6119bcc8d43c9d5a752c3acaab7e9f0e9365f0b0083bae8be2b930d1c1a35affc508210e72998abc11b483d3b
-  data.tar.gz: e89c4a64ac97093c8973ccd482ca76b11f3852e29eb124904301c72f930cdce1774fabd1c1d1a3bdb775e065a7e27364a6bb7bbbdcf631c0587ee5e473f793b1
+  metadata.gz: 8347252541e765517a6bc485cc7bc1b811771a55610543549d676d5321944185e9a446bed4c8a3909f21f336fd56ae76b91ede2e3731f30ea66c0916d1a3e591
+  data.tar.gz: 930367d81adf351b66aa7365daaf9f4406067db80a4959409e68ddd5ab7041ed10db4f983f81d1af3d8f2457b8d79543cbf33c927e69bfbde027a31da4b166a8

data/CHANGELOG.md

@@ -2,11 +2,27 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 
 ## [Unreleased]
 
+## Version 2.12.0
+### Added
+* [#1866](https://github.com/Shopify/shopify-cli/pull/1866): Enforce git dependency
+* [#2009](https://github.com/Shopify/shopify-cli/pull/2009): Add localization support for Checkout Extensions
+* [#2060](https://github.com/Shopify/shopify-cli/pull/2060): Improve CLI error messages for token-based auth (scripts)
+* [#2076](https://github.com/Shopify/shopify-cli/pull/2076): Release Wasm Script Projects
+* [#2051](https://github.com/Shopify/shopify-cli/pull/2051): Update `theme serve` to accept `root` argument
+* [#2025](https://github.com/Shopify/shopify-cli/pull/2025): Improve `theme pull`/`push` help messages to indicate multiple `--only`/`--ignore` flags are allowed.
+
+### Fixed
+* [#2030](https://github.com/Shopify/shopify-cli/pull/2030): Fix Theme::Syncer handling of file deletions in `download_file!`
+* [#2071](https://github.com/Shopify/shopify-cli/pull/2071): Fix `theme pull` error message when dev theme doesn't exist
+* [#2066](https://github.com/Shopify/shopify-cli/pull/2066): Improve `--only`/`--ignore` parameters on Theme `pull`/`push` commands to work without quotes
+* [#2078](https://github.com/Shopify/shopify-cli/pull/2078): Fix errors on section rendering caused by CORS issues
+
 ## Version 2.11.2
 ### Fixed
 * [#2047](https://github.com/Shopify/shopify-cli/pull/2047): Fix the Homebrew installation
 * [#2019](https://github.com/Shopify/shopify-cli/pull/2019): Provide helpful link when nokogiri fails to load
 * [#2055](https://github.com/Shopify/shopify-cli/pull/2055): Remove unneeded Node requirements
+* [#2020](https://github.com/Shopify/shopify-cli/pull/2020): Fix `theme pull` so that correct dev theme is used with `-d` option
 
 ## Version 2.11.1
 ### Fixed
@@ -18,7 +34,6 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 ## Version 2.11.0
 ### Fixed
 * [#2005](https://github.com/Shopify/shopify-cli/pull/2005): Fix PHP app serve on Windows environments
-* [#2020](https://github.com/Shopify/shopify-cli/pull/2020): Fix `theme pull` so that correct dev theme is used with `-d` option
 
 ### Added
 * [#1998](https://github.com/Shopify/shopify-cli/pull/1998): Add support for Rails 7

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    shopify-cli (2.11.2)
+    shopify-cli (2.12.0)
       bugsnag (~> 6.22)
       listen (~> 3.7.0)
       theme-check (~> 1.9.0)

data/bin/shopify

@@ -16,10 +16,14 @@ module Kernel
     raise if name == "#{RUBY_VERSION.split(".")[0, 2].join(".")}/ffi_c"
     # Special case for nokogiri, which might install the wrong architecture
     if name == "nokogiri/nokogiri"
-      STDERR.puts "[Note] Nokogiri is failing to load, which most likely means " \
-        "it is installed with the wrong architecture for your system. This link " \
-        "has instructions for how to install the correct version for your system: " \
-        "https://nokogiri.org/tutorials/installing_nokogiri.html"
+      STDERR.puts(<<~MESSAGE)
+        The Nokogiri gem is failing to load, due to an installation or architecture issue.
+
+        To fix this, reinstall Nokogiri.
+
+        • Installation guide: https://nokogiri.org/tutorials/installing_nokogiri.html
+
+      MESSAGE
       STDERR.puts e.full_message
       exit(1)
     end

data/docs/users/installation.md

@@ -1,46 +1,3 @@
 # Installation
 
-## Installation through RubyGems
-
-The easiest method to install the Shopify CLI is through RubyGems:
-
-```shell
-$ gem install shopify-cli
-```
-
-## Installation for macOS Users
-
-- Make sure you have [Homebrew](https://brew.sh/) installed
-- Open your terminal app
-- Run `brew tap shopify/shopify`
-- Run `brew install shopify-cli`
-- After the installation is completed, run `shopify version`, if this outputs a version number you've successfully installed the CLI.
-
-### To upgrade Shopify CLI
-
-#### Homebrew (Mac OS)
-
-```shell
-$ brew update
-$ brew upgrade shopify-cli
-```
-
-## Installation for Debian and Ubuntu users through `apt`
-
-1.- Download the latest `.deb` binary for Shopify CLI from the releases page.
-
-2.- Install the downloaded file and make sure to replace /path/to/download/shopify-cli-x.y.z.deb with the path to your file's location:
-
-```shell
-$ sudo apt install /path/to/downloaded/shopify-cli-x.y.z.deb
-```
-
-## Installation for CentOS 8+, Fedora, Red Hat, and SUSE users through `yum`
-
-1.- Download the latest .rpm file for Shopify App CLI from the releases page.
-
-2.- Install the downloaded file and make sure to replace /path/to/downloaded/shopify-cli-x.y.x.rpm with the path to your file's location:
-
-```shell
- $ sudo yum install /path/to/downloaded/shopify-cli-x.y.x.rpm
-```
+The installation guide can be found here: https://shopify.dev/apps/tools/cli/installation

data/lib/project_types/extension/models/specification_handlers/checkout_ui_extension.rb

@@ -4,12 +4,24 @@ module Extension
   module Models
     module SpecificationHandlers
       class CheckoutUiExtension < Default
+        L10N_ERROR_PREFIX = "core.extension.push.checkout_ui_extension.localization.error"
+        L10N_FILE_SIZE_LIMIT = 16 * 1024 # 16kb
+        L10N_BUNDLE_SIZE_LIMIT = 256 * 1024 # 256kb
+        LOCALE_CODE_FORMAT = %r{
+          \A
+          (?<language>[a-zA-Z]{2,3}) # Language tag
+          (?:
+           -
+           (?<region>[a-zA-Z]{2}) # Optional region subtag
+          )?
+          \z}x
         PERMITTED_CONFIG_KEYS = [:extension_points, :metafields, :name]
 
         def config(context)
           {
             **Features::ArgoConfig.parse_yaml(context, PERMITTED_CONFIG_KEYS),
             **argo.config(context, include_renderer_version: false),
+            **localization(context),
           }
         end
 
@@ -22,6 +34,108 @@ module Extension
           return unless product
           format("/cart/%<variant_id>d:%<quantity>d", variant_id: product.variant_id, quantity: 1)
         end
+
+        private
+
+        def localization(context)
+          Dir.chdir(context.root) do
+            locale_filenames = Dir["locales/*"].select { |filename| valid_l10n_file?(filename) }
+            # Localization is optional
+            return {} if locale_filenames.empty?
+
+            validate_total_size(locale_filenames)
+            default_locale = single_default_locale(locale_filenames)
+
+            locale_filenames.map do |filename|
+              locale = basename_for_locale_filename(filename)
+              [locale.to_sym, Base64.strict_encode64(File.read(filename, mode: "rt", encoding: "UTF-8").strip)]
+            end
+              .yield_self do |encoded_files_by_locale|
+              {
+                localization: {
+                  default_locale: default_locale,
+                  translations: encoded_files_by_locale.to_h,
+                },
+              }
+            end
+          end
+        end
+
+        def validate_total_size(locale_filenames)
+          total_size = locale_filenames.sum { |filename| File.size(filename) }
+          if total_size > L10N_BUNDLE_SIZE_LIMIT
+            raise(
+              ShopifyCLI::Abort,
+              ShopifyCLI::Context.message(
+                "#{L10N_ERROR_PREFIX}.bundle_too_large",
+                CLI::Kit::Util.to_filesize(L10N_BUNDLE_SIZE_LIMIT)
+              )
+            )
+          end
+        end
+
+        def single_default_locale(locale_filenames)
+          default_locale_matches = locale_filenames.grep(/default/)
+          if default_locale_matches.size != 1
+            raise(ShopifyCLI::Abort, ShopifyCLI::Context.message("#{L10N_ERROR_PREFIX}.single_default_locale"))
+          end
+          basename_for_locale_filename(default_locale_matches.first)
+        end
+
+        def valid_l10n_file?(filename)
+          return false unless File.file?(filename)
+          return false unless File.dirname(filename) == "locales"
+
+          validate_file_extension(filename)
+          validate_file_locale_code(filename)
+          validate_file_size(filename)
+          validate_file_not_empty(filename)
+
+          true
+        end
+
+        def validate_file_extension(filename)
+          if File.extname(filename) != ".json"
+            raise(
+              ShopifyCLI::Abort, ShopifyCLI::Context.message("#{L10N_ERROR_PREFIX}.invalid_file_extension", filename)
+            )
+          end
+        end
+
+        def validate_file_locale_code(filename)
+          unless valid_locale_code?(basename_for_locale_filename(filename))
+            raise(
+              ShopifyCLI::Abort, ShopifyCLI::Context.message("#{L10N_ERROR_PREFIX}.invalid_locale_code", filename)
+            )
+          end
+        end
+
+        def validate_file_size(filename)
+          if File.size(filename) > L10N_FILE_SIZE_LIMIT
+            raise(
+              ShopifyCLI::Abort,
+              ShopifyCLI::Context.message(
+                "#{L10N_ERROR_PREFIX}.file_too_large",
+                filename,
+                CLI::Kit::Util.to_filesize(L10N_FILE_SIZE_LIMIT)
+              )
+            )
+          end
+        end
+
+        def validate_file_not_empty(filename)
+          if File.zero?(filename)
+            raise(ShopifyCLI::Abort, ShopifyCLI::Context.message("#{L10N_ERROR_PREFIX}.file_empty", filename))
+          end
+        end
+
+        def valid_locale_code?(locale_code)
+          LOCALE_CODE_FORMAT.match?(locale_code)
+        end
+
+        def basename_for_locale_filename(filename)
+          File.basename(File.basename(filename, ".json"), ".default")
+        end
       end
     end
   end

data/lib/project_types/script/cli.rb

@@ -78,6 +78,8 @@ module Script
           Project.project_filepath("layers/infrastructure/languages/wasm_project_creator.rb")
         autoload :WasmTaskRunner,
           Project.project_filepath("layers/infrastructure/languages/wasm_task_runner.rb")
+        autoload :ToolVersionChecker,
+          Project.project_filepath("layers/infrastructure/languages/tool_version_checker.rb")
       end
 
       module ApiClients

data/lib/project_types/script/commands/create.rb

@@ -18,13 +18,13 @@ module Script
         form = Forms::Create.ask(@ctx, args, options.flags)
         return @ctx.puts(self.class.help) if form.nil?
 
-        unless !form.name.empty? && form.extension_point && form.language
+        unless !form.name.empty? && form.extension_point
           return @ctx.puts(self.class.help)
         end
 
         project = Layers::Application::CreateScript.call(
           ctx: @ctx,
-          language: form.language,
+          language: options.flags[:language]&.downcase || "wasm",
           sparse_checkout_branch: options.flags[:branch] || "master",
           script_name: form.name,
           extension_point_type: form.extension_point,

data/lib/project_types/script/commands/push.rb

@@ -5,10 +5,6 @@ module Script
     class Push < ShopifyCLI::Command::SubCommand
       prerequisite_task ensure_project_type: :script
 
-      recommend_node(
-        from: ::Script::Layers::Infrastructure::Languages::TypeScriptProjectCreator::MIN_NODE_VERSION,
-        to: ShopifyCLI::Constants::SupportedVersions::Node::TO
-      )
       recommend_default_ruby_range
 
       options do |parser, flags|
@@ -26,7 +22,7 @@ module Script
         push(project: project)
       rescue StandardError => e
         UI::ErrorHandler.pretty_print_and_raise(e,
-          failed_op: @ctx.message("script.push.error.operation_failed_no_api_key"))
+          failed_op: @ctx.message("script.push.error.operation_failed"))
       end
 
       def push(project:)
@@ -38,7 +34,9 @@ module Script
           Layers::Application::PushScript.call(ctx: @ctx, force: force, project: project)
           @ctx.puts(@ctx.message("script.push.script_pushed", api_key: api_key))
         else
-          raise ShopifyCLI::Abort, @ctx.message("script.push.error.operation_failed_no_uuid")
+          message = @ctx.message("script.error.missing_push_options_ci", "--uuid")
+          message += @ctx.message("script.error.missing_push_options_ci_solution", ShopifyCLI::TOOL_NAME)
+          raise ShopifyCLI::Abort, message
         end
       end
 

data/lib/project_types/script/config/extension_points.yml

@@ -9,7 +9,6 @@ payment_methods:
       package: "@shopify/scripts-checkout-apis"
       repo: "https://github.com/Shopify/scripts-apis-examples"
     wasm:
-      beta: true
       repo: "https://github.com/Shopify/scripts-apis-examples"
 shipping_methods:
   domain: 'checkout'
@@ -22,7 +21,6 @@ shipping_methods:
       package: "@shopify/scripts-checkout-apis"
       repo: "https://github.com/Shopify/scripts-apis-examples"
     wasm:
-      beta: true
       repo: "https://github.com/Shopify/scripts-apis-examples"
 merchandise_discount_types:
   beta: true
@@ -33,7 +31,6 @@ merchandise_discount_types:
       package: "@shopify/scripts-discounts-apis"
       repo: "https://github.com/Shopify/scripts-apis-examples"
     wasm:
-      beta: true
       repo: "https://github.com/Shopify/scripts-apis-examples"
 delivery_discount_types:
   beta: true
@@ -44,5 +41,4 @@ delivery_discount_types:
       package: "@shopify/scripts-discounts-apis"
       repo: "https://github.com/Shopify/scripts-apis-examples"
     wasm:
-      beta: true
       repo: "https://github.com/Shopify/scripts-apis-examples"

data/lib/project_types/script/forms/create.rb

@@ -3,12 +3,11 @@
 module Script
   module Forms
     class Create < ShopifyCLI::Form
-      flag_arguments :extension_point, :name, :language
+      flag_arguments :extension_point, :name
 
       def ask
         self.name = valid_name
         self.extension_point ||= ask_extension_point
-        self.language = ask_language
       end
 
       private
@@ -29,18 +28,6 @@ module Script
         return n if n.match?(/^[0-9A-Za-z_-]*$/)
         raise Errors::InvalidScriptNameError
       end
-
-      def ask_language
-        return language.downcase if language
-
-        all_languages = Layers::Application::ExtensionPoints.languages(type: extension_point)
-        return all_languages.first if all_languages.count == 1
-
-        CLI::UI::Prompt.ask(
-          ctx.message("script.forms.create.select_language"),
-          options: all_languages
-        )
-      end
     end
   end
 end

data/lib/project_types/script/layers/application/connect_app.rb

@@ -55,9 +55,10 @@ module Script
           def handle_error(error, context:)
             properties_hash = { api_key: "SHOPIFY_API_KEY", secret: "SHOPIFY_API_SECRET" }
             missing_env_variables = error.properties.map { |p| properties_hash[p.name] }.compact.join(", ")
+            message = context.message("script.error.missing_env_file_variables", missing_env_variables)
+            message += context.message("script.error.missing_env_file_variables_solution", ShopifyCLI::TOOL_NAME)
             raise ShopifyCLI::Abort,
-              context.message("script.connect.error.missing_env_file_variables", missing_env_variables,
-                ShopifyCLI::TOOL_NAME)
+              message
           end
 
           private

data/lib/project_types/script/layers/infrastructure/errors.rb

@@ -105,6 +105,17 @@ module Script
 
         class DependencyInstallError < ScriptProjectError; end
         class EmptyResponseError < ScriptProjectError; end
+
+        class InvalidEnvironmentError < ScriptProjectError
+          attr_reader :tool, :env_version, :minimum_version
+          def initialize(tool, env_version, minimum_version)
+            super()
+            @tool = tool
+            @env_version = env_version
+            @minimum_version = minimum_version
+          end
+        end
+
         class InvalidResponseError < ScriptProjectError; end
         class ForbiddenError < ScriptProjectError; end
         class InvalidContextError < ScriptProjectError; end

data/lib/project_types/script/layers/infrastructure/languages/assemblyscript_project_creator.rb

@@ -5,18 +5,14 @@ module Script
     module Infrastructure
       module Languages
         class AssemblyScriptProjectCreator < ProjectCreator
-          MIN_NODE_VERSION = "14.5.0" # kept because task_runner uses this
-          NPM_SET_REGISTRY_COMMAND = "npm --userconfig ./.npmrc config set @shopify:registry https://registry.npmjs.com"
-          NPM_SET_ENGINE_STRICT_COMMAND = "npm --userconfig ./.npmrc config set engine-strict true"
-
           def self.config_file
             "package.json"
           end
 
           def setup_dependencies
+            task_runner = Infrastructure::Languages::AssemblyScriptTaskRunner.new(ctx)
+            task_runner.set_npm_config
             super
-            command_runner.call(NPM_SET_REGISTRY_COMMAND)
-            command_runner.call(NPM_SET_ENGINE_STRICT_COMMAND)
           end
         end
       end

data/lib/project_types/script/layers/infrastructure/languages/assemblyscript_task_runner.rb

@@ -5,9 +5,15 @@ module Script
     module Infrastructure
       module Languages
         class AssemblyScriptTaskRunner < TaskRunner
+          NODE_MIN_VERSION = "14.15.0"
+          NPM_MIN_VERSION = "5.2.0"
+
           BYTECODE_FILE = "build/script.wasm"
           METADATA_FILE = "build/metadata.json"
           SCRIPT_SDK_BUILD = "npm run build"
+          NPM_SET_REGISTRY_COMMAND = "npm --userconfig ./.npmrc config set @shopify:registry https://registry.npmjs.com"
+          NPM_SET_ENGINE_STRICT_COMMAND = "npm --userconfig ./.npmrc config set engine-strict true"
+          NPM_INSTALL_COMMAND = "npm install --no-audit --no-optional --legacy-peer-deps --loglevel error"
 
           def build
             compile
@@ -15,10 +21,10 @@ module Script
           end
 
           def install_dependencies
-            check_node_version!
+            run_cmd_with_env_check(NPM_INSTALL_COMMAND)
 
-            output, status = ctx.capture2e("npm install --no-audit --no-optional --legacy-peer-deps --loglevel error")
-            raise Errors::DependencyInstallError, output unless status.success?
+          rescue Errors::SystemCallFailureError => e
+            raise Errors::DependencyInstallError, e.out
           end
 
           def dependencies_installed?
@@ -31,14 +37,32 @@ module Script
           end
 
           def library_version(library_name)
-            output = JSON.parse(CommandRunner.new(ctx: ctx).call("npm -s list --json"))
+            output = JSON.parse(run_cmd_with_env_check("npm -s list --json"))
             library_version_from_npm_list(output, library_name)
           rescue Errors::SystemCallFailureError => error
             library_version_from_npm_list_error_output(error, library_name)
           end
 
+          def set_npm_config
+            run_cmd_with_env_check(NPM_SET_REGISTRY_COMMAND)
+            run_cmd_with_env_check(NPM_SET_ENGINE_STRICT_COMMAND)
+          end
+
           private
 
+          def ensure_environment
+            return if defined?(@environment_checked)
+            @environment_checked = true
+
+            ToolVersionChecker.check_node(minimum_version: NODE_MIN_VERSION)
+            ToolVersionChecker.check_npm(minimum_version: NPM_MIN_VERSION)
+          end
+
+          def run_cmd_with_env_check(cmd)
+            ensure_environment
+            CommandRunner.new(ctx: ctx).call(cmd)
+          end
+
           def library_version_from_npm_list_error_output(error, library_name)
             # npm list can return a failure status code, even when returning the correct data.
             # This causes the CommandRunner to throw a SystemCallFailure error that contains the data.
@@ -57,22 +81,9 @@ module Script
             end
           end
 
-          def check_node_version!
-            output, status = @ctx.capture2e("node", "--version")
-            raise Errors::DependencyInstallError, output unless status.success?
-
-            require "semantic/semantic"
-            version = ::Semantic::Version.new(output[1..-1])
-            unless version >= ::Semantic::Version.new(AssemblyScriptProjectCreator::MIN_NODE_VERSION)
-              raise Errors::DependencyInstallError,
-                "Node version must be >= v#{AssemblyScriptProjectCreator::MIN_NODE_VERSION}. "\
-                "Current version: #{output.strip}."
-            end
-          end
-
           def compile
             check_compilation_dependencies!
-            CommandRunner.new(ctx: ctx).call(SCRIPT_SDK_BUILD)
+            run_cmd_with_env_check(SCRIPT_SDK_BUILD)
           end
 
           def check_compilation_dependencies!

data/lib/project_types/script/layers/infrastructure/languages/tool_version_checker.rb

@@ -0,0 +1,26 @@
+module Script
+  module Layers
+    module Infrastructure
+      module Languages
+        class ToolVersionChecker
+          class << self
+            def check_node(minimum_version:)
+              check_version("node", ShopifyCLI::Environment.node_version, minimum_version)
+            end
+
+            def check_npm(minimum_version:)
+              check_version("npm", ShopifyCLI::Environment.npm_version, minimum_version)
+            end
+
+            private
+
+            def check_version(tool, env_version, minimum_version)
+              return if env_version >= ::Semantic::Version.new(minimum_version)
+              raise Errors::InvalidEnvironmentError.new(tool, env_version, minimum_version)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/project_types/script/layers/infrastructure/languages/typescript_project_creator.rb

@@ -5,18 +5,15 @@ module Script
     module Infrastructure
       module Languages
         class TypeScriptProjectCreator < ProjectCreator
-          MIN_NODE_VERSION = "14.15.0"
-          NPM_SET_REGISTRY_COMMAND = "npm --userconfig ./.npmrc config set @shopify:registry https://registry.npmjs.com"
-          NPM_SET_ENGINE_STRICT_COMMAND = "npm --userconfig ./.npmrc config set engine-strict true"
-
           def self.config_file
             "package.json"
           end
 
           def setup_dependencies
+            task_runner = Infrastructure::Languages::TypeScriptTaskRunner.new(ctx)
+            task_runner.set_npm_config
+
             super
-            command_runner.call(NPM_SET_REGISTRY_COMMAND)
-            command_runner.call(NPM_SET_ENGINE_STRICT_COMMAND)
 
             if ctx.file_exist?("yarn.lock")
               ctx.rm("yarn.lock")

data/lib/project_types/script/layers/infrastructure/languages/typescript_task_runner.rb

@@ -5,10 +5,16 @@ module Script
     module Infrastructure
       module Languages
         class TypeScriptTaskRunner < TaskRunner
+          NODE_MIN_VERSION = "14.15.0"
+          NPM_MIN_VERSION = "5.2.0"
+
           BYTECODE_FILE = "build/index.wasm"
           METADATA_FILE = "build/metadata.json"
           SCRIPT_SDK_BUILD = "npm run build"
           GEN_METADATA = "npm run gen-metadata"
+          NPM_SET_REGISTRY_COMMAND = "npm --userconfig ./.npmrc config set @shopify:registry https://registry.npmjs.com"
+          NPM_SET_ENGINE_STRICT_COMMAND = "npm --userconfig ./.npmrc config set engine-strict true"
+          NPM_INSTALL_COMMAND = "npm install --no-audit --no-optional --legacy-peer-deps --loglevel error"
 
           def build
             compile
@@ -16,10 +22,10 @@ module Script
           end
 
           def install_dependencies
-            check_node_version!
+            run_cmd_with_env_check(NPM_INSTALL_COMMAND)
 
-            output, status = ctx.capture2e("npm install --no-audit --no-optional --legacy-peer-deps --loglevel error")
-            raise Errors::DependencyInstallError, output unless status.success?
+          rescue Errors::SystemCallFailureError => e
+            raise Errors::DependencyInstallError, e.out
           end
 
           def dependencies_installed?
@@ -32,14 +38,32 @@ module Script
           end
 
           def library_version(library_name)
-            output = JSON.parse(CommandRunner.new(ctx: ctx).call("npm -s list --json"))
+            output = JSON.parse(run_cmd_with_env_check("npm -s list --json"))
             library_version_from_npm_list(output, library_name)
           rescue Errors::SystemCallFailureError => error
             library_version_from_npm_list_error_output(error, library_name)
           end
 
+          def set_npm_config
+            run_cmd_with_env_check(NPM_SET_REGISTRY_COMMAND)
+            run_cmd_with_env_check(NPM_SET_ENGINE_STRICT_COMMAND)
+          end
+
           private
 
+          def ensure_environment
+            return if defined?(@environment_checked)
+            @environment_checked = true
+
+            ToolVersionChecker.check_node(minimum_version: NODE_MIN_VERSION)
+            ToolVersionChecker.check_npm(minimum_version: NPM_MIN_VERSION)
+          end
+
+          def run_cmd_with_env_check(cmd)
+            ensure_environment
+            CommandRunner.new(ctx: ctx).call(cmd)
+          end
+
           def library_version_from_npm_list_error_output(error, library_name)
             # npm list can return a failure status code, even when returning the correct data.
             # This causes the CommandRunner to throw a SystemCallFailure error that contains the data.
@@ -58,23 +82,10 @@ module Script
             end
           end
 
-          def check_node_version!
-            output, status = @ctx.capture2e("node", "--version")
-            raise Errors::DependencyInstallError, output unless status.success?
-
-            require "semantic/semantic"
-            version = ::Semantic::Version.new(output[1..-1])
-            unless version >= ::Semantic::Version.new(TypeScriptProjectCreator::MIN_NODE_VERSION)
-              raise Errors::DependencyInstallError,
-                "Node version must be >= v#{TypeScriptProjectCreator::MIN_NODE_VERSION}. "\
-            "Current version: #{output.strip}."
-            end
-          end
-
           def compile
             check_compilation_dependencies!
-            CommandRunner.new(ctx: ctx).call(SCRIPT_SDK_BUILD)
-            CommandRunner.new(ctx: ctx).call(GEN_METADATA)
+            run_cmd_with_env_check(SCRIPT_SDK_BUILD)
+            run_cmd_with_env_check(GEN_METADATA)
           end
 
           def check_compilation_dependencies!