shopify-cli 2.9.0 → 2.11.0

data/lib/project_types/script/messages/messages.rb

@@ -5,90 +5,91 @@ module Script
     MESSAGES = {
       script: {
         help: <<~HELP,
-          Suite of commands for developing script applications. See {{command:%1$s script <command> --help}} for usage of each command.
+          Suite of commands for developing script applications. Run {{command:%1$s script <command> --help}} for usage of each command.
             Usage: {{command:%1$s script [ %2$s ]}}
         HELP
 
         error: {
-          deprecated_ep: "This project uses a Script API (%s) that has been deprecated. "\
-                         "This Script won't work in production.",
-          deprecated_ep_cause: "Try using a different Script API.",
+          deprecated_ep: "This script won't run in a store because "\
+                         "it uses a deprecated Script API (%s).",
+          deprecated_ep_cause: "Recreate this script using a supported Script API.",
           generic: "{{red:{{x}} Error}}",
           eacces_cause: "You don't have permission to write to this directory.",
-          eacces_help: "Try again and choose a different directory.",
+          eacces_help: "Get permission for this directory or choose a different one.",
 
           enospc_cause: "You don't have enough disk space to do this action.",
-          enospc_help: "Free up some space and try again.",
+          enospc_help: "Free up more space.",
 
           oauth_cause: "Something went wrong while authenticating your account with the Partner Dashboard.",
-          oauth_help: "Try again.",
+          oauth_help: "Wait a few minutes and try again.",
 
-          invalid_context_cause: "Your .shopify-cli.yml file is not correct. Values are missing for "\
+          invalid_context_cause: "Your .shopify-cli.yml is formatted incorrectly. It's missing values for "\
                                  "extension_point_type or script_name.",
-          invalid_context_help: "Add these values and try again.",
+          invalid_context_help: "Add these values.",
 
-          invalid_script_name_cause: "Invalid script name.",
-          invalid_script_name_help: "Replace or remove unsupported characters. Valid characters "\
-                                    "are numbers, letters, hyphens, or underscores.",
+          invalid_script_name_cause: "Script name contains unsupported characters.",
+          invalid_script_name_help: "Use only numbers, letters, hyphens, or underscores.",
 
-          no_existing_apps_cause: "You don't have any apps in your Partner Dashboard.",
-          no_existing_apps_help: "Create an app with {{command:shopify [node|rails] create}}" \
-                                 " or visit https://partners.shopify.com/.",
+          no_existing_apps_cause: "Your script can't be pushed to an app because your Partner account "\
+                                  "doesn't have any apps.",
+          no_existing_apps_help: "Create an app.",
 
-          no_existing_orgs_cause: "You don't have any partner organizations.",
-          no_existing_orgs_help: "Visit https://partners.shopify.com/ to create a partners account.",
+          no_existing_orgs_cause: "Your account doesn't belong to a Partner Organization.",
+          no_existing_orgs_help: "Visit https://partners.shopify.com/ to create an account.",
 
           project_exists_cause: "A directory with this same name already exists.",
-          project_exists_help: "Try again and enter a different name for the script.",
+          project_exists_help: "Choose a different name for your script.",
 
-          invalid_extension_cause: "Invalid Script API %s.",
-          invalid_extension_help: "Allowed values: %s.",
+          invalid_extension_cause: "The name of the Script API is incorrect: %s.",
+          invalid_extension_help: "Choose a supported API: %s.",
 
-          invalid_language_cause: "Invalid language %s.",
-          invalid_language_help: "Allowed values: %s.",
+          invalid_language_cause: "The language is not supported: %s.",
+          invalid_language_help: "Choose a supported language: %s.",
 
-          missing_script_config_yml_field_cause: "The script.config.yml file is missing the required %s field.",
-          missing_script_config_yml_field_help: "Add the field and try again.",
+          missing_script_config_field_cause: "The %{filename} file is missing the required %{field} field.",
+          missing_script_config_field_help: "Add the field.",
 
-          missing_script_json_field_cause: "The script.json file is missing the required %s field.",
-          missing_script_json_field_help: "Add the field and try again.",
+          script_config_parse_error_cause: "The %{filename} file contains incorrect %{serialization_format}.",
+          script_config_parse_error_help: "Correct the errors.",
 
-          invalid_script_json_definition_cause: "The script.json file contains invalid JSON.",
-          invalid_script_json_definition_help: "Fix the errors and try again.",
+          no_script_config_file_cause: "The %{filename} file is missing.",
+          no_script_config_file_help: "Create this file.",
 
-          invalid_script_config_yml_definition_cause: "The script.config.yml file contains invalid YAML.",
-          invalid_script_config_yml_definition_help: "Fix the errors and try again.",
+          app_not_connected_cause: "The script is not connected to an app.",
+          app_not_connected_help: "Run {{command:%{tool_name} script connect}}.",
 
-          no_script_config_yml_file_cause: "The script.config.yml file is missing.",
-          no_script_config_yml_file_help: "Create this file and try again.",
+          configuration_definition_error_cause: "In %{filename} there is a problem with the "\
+                                                "configuration. %{message}",
+          configuration_definition_error_help: "Fix the error.",
 
-          app_not_connected_cause: "Script is not connected to an app.",
-          app_not_connected_help: "Run shopify connect or enter fields for api-key and api-secret.",
+          configuration_definition_errors_cause: "In %{filename}, there are %{error_count} problems with "\
+                                                 "the configuration:\n%{concatenated_messages}\n",
+          configuration_definition_errors_help: "Correct the errors.",
 
-          configuration_syntax_error_cause: "The script.json is not formatted properly.",
-          configuration_syntax_error_help: "Fix the errors and try again.",
+          configuration_syntax_error_cause: "The %{filename} is not formatted correctly.",
+          configuration_syntax_error_help: "Fix the errors.",
 
-          configuration_missing_keys_error_cause: "The script.json file is missing required keys: "\
+          configuration_missing_keys_error_cause: "The %{filename} is missing required keys: "\
                                               "%{missing_keys}.",
-          configuration_missing_keys_error_help: "Add the keys and try again.",
+          configuration_missing_keys_error_help: "Add the keys.",
 
-          configuration_invalid_value_error_cause: "The script.json configuration only accepts "\
+          configuration_invalid_value_error_cause: "The %{filename} configuration accepts "\
                                                    "one of the following types(s): %{valid_input_modes}.",
-          configuration_invalid_value_error_help: "Change the type and try again.",
+          configuration_invalid_value_error_help: "Change the value of the type.",
 
-          configuration_schema_field_missing_keys_error_cause: "A configuration entry in the script.json file "\
+          configuration_schema_field_missing_keys_error_cause: "A configuration entry in the %{filename} file "\
                                                      "is missing required keys: %{missing_keys}.",
-          configuration_definition_schema_field_missing_keys_error_help: "Add the keys and try again.",
+          configuration_definition_schema_field_missing_keys_error_help: "Add the keys.",
 
           configuration_schema_field_invalid_value_error_cause: "The configuration entries in the "\
-                                                     "script.json file only accept one of the following "\
+                                                     "%{filename} file accept one of the following "\
                                                      "type(s): %{valid_types}.",
-          configuration_schema_field_invalid_value_error_help: "Change the types and try again.",
+          configuration_schema_field_invalid_value_error_help: "Change the value of the type.",
 
-          script_not_found_cause: "Couldn't find a script %s for the Script API %s",
+          script_not_found_cause: "Can't find script %s for Script API %s",
 
-          system_call_failure_cause: "An error was returned while running {{command:%{cmd}}}.",
-          system_call_failure_help: "Review the following error and try again.\n{{red:%{out}}}",
+          system_call_failure_cause: "Something went wrong while running: {{command:%{cmd}}}.",
+          system_call_failure_help: "Correct the error.\n{{red:%{out}}}",
 
           metadata_validation_cause: "The Script API metadata is incorrect.",
           metadata_validation_help: "The 'schemaVersions.major' field contains an unsupported version.",
@@ -102,57 +103,58 @@ module Script
           metadata_schema_versions_missing_minor: "Invalid Script API metadata:" \
                                                   " 'schemaVersions' is missing the 'minor' field",
 
-          metadata_not_found_cause: "Script version file (%s) cannot be found.",
-          metadata_not_found_help: "Ensure the 'shopify/scripts-toolchain-as' package is up to date and " \
-                                     "'package.json' contains a 'scripts/build' entry with a " \
-                                     "'--metadata build/metadata.json' argument",
+          metadata_not_found_cause: "Can't find the script version file (%{filename}).",
+          metadata_not_found_help: "Make sure your project is up-to-date and a script metadata file " \
+                                   "is accessible at %{filename}.",
 
           build_error_cause: "Something went wrong while building the script.",
-          build_error_help: "Correct the errors and try again.",
+          build_error_help: "Correct the errors.",
 
           dependency_install_cause: "Something went wrong while installing the needed dependencies.",
-          dependency_install_help: "Correct the errors and try again.",
+          dependency_install_help: "Correct the errors.",
 
           failed_api_request_cause: "Something went wrong while communicating with Shopify.",
           failed_api_request_help: "Try again.",
 
-          forbidden_error_cause: "You do not have permission to do this action.",
+          forbidden_error_cause: "You don't have permission to do this action.",
 
           graphql_error_cause: "An error was returned: %s.",
-          graphql_error_help: "\nReview the error and try again.",
+          graphql_error_help: "\nCorrect the error.",
 
-          script_repush_cause: "A version of this script already exists on the app.",
+          script_repush_cause: "Can’t push the script because a version of this script already exists on the app.",
           script_repush_help: "Use {{cyan:--force}} to replace the existing script.",
 
           build_script_not_found: "The root package.json is missing the build command that " \
-                                  "is needed to compile your script to WebAssembly.",
+                                  "is needed to compile your script to Wasm.",
           # rubocop:disable Layout/LineLength
           build_script_suggestion: "\n\nFor example, your package.json needs the following command:" \
             "\nbuild: npx shopify-scripts-toolchain-as build --src src/shopify_main.ts --binary build/<script_name>.wasm --metadata build/metadata.json -- --lib node_modules --optimize --use Date=",
 
-          web_assembly_binary_not_found: "WebAssembly binary not found.",
-          web_assembly_binary_not_found_suggestion: "No WebAssembly binary found." \
-            "Check that your build npm script outputs the generated binary to the root of the directory." \
-            "Generated binary should match the script name: <script_name>.wasm",
+          web_assembly_binary_not_found: "Wasm binary not found.",
+          web_assembly_binary_not_found_suggestion: "Check that there is a valid Wasm binary in the root directory" \
+          "Your Wasm binary should match the script name: <script_name>.wasm",
 
           project_config_not_found: "Internal error - Script can't be created because the project's config file is missing from the repository.",
 
           invalid_project_config: "Internal error - Script can't be created because the project's config file is invalid in the repository.",
 
-          script_upload_cause: "Fail to upload script.",
+          script_upload_cause: "Something went wrong and your script couldn't be pushed.",
           script_upload_help: "Try again.",
 
+          script_too_large_cause: "The size of your Wasm binary file is too large.",
+          script_too_large_help: "It must be less than %{max_size}.",
+
           api_library_not_found_cause: "Script can't be created because API library %{library_name} is missing from the dependencies",
-          api_library_not_found_help: "This error can occur because the API library was removed from your system or there is a problem with dependencies in the repository.",
+          api_library_not_found_help: "This can occur because the API library was removed from your system or there is a problem with dependencies in the repository.",
 
           language_library_for_api_not_found_cause: "Script can’t be pushed because the %{language} library for API %{api} is missing.",
           language_library_for_api_not_found_help: "Make sure extension_point.yml contains the correct API library.",
-          no_scripts_found_in_app: "The selected apps have no scripts. Please, create them first on the partners' dashboard.",
+          no_scripts_found_in_app: "The selected apps have no scripts. Create them first on the partners' dashboard.",
           missing_env_file_variables: "The following variables are missing in the .env file: %s."\
-            " It might happen when the script hasn't been previously connected to an app."\
+            " This can occur when the script hasn't been connected to an app."\
             " To connect the script to an app, run {{command:%s script connect}}",
-          missing_push_options: "The following options are required: %s."\
-            " You can obtain them from the .env file generated after connecting the script to an app.",
+          missing_push_options: "The following options are missing from .env: %s."\
+            " Run {{command:%s script connect}} to connect the script to an app and generate these options.",
         },
 
         create: {
@@ -160,26 +162,29 @@ module Script
             {{command:%1$s script create}}: Creates a script project.
               Usage: {{command:%1$s script create}}
               Options:
-                {{command:--name=NAME}} Script project name. Use any string.
-                {{command:--api=TYPE}} Script API name. Allowed values: %2$s.
-                {{command:--language=LANGUAGE}} Programming language. Allowed values: %3$s.
+                {{command:--name=NAME}} Script project name.
+                {{command:--api=TYPE}} Script API name. Supported values: %2$s.
+                {{command:--language=LANGUAGE}} Programming language. Supported values: %3$s.
           HELP
 
           error: {
-            operation_failed: "Script not created.",
+            operation_failed: "Something went wrong and the script wasn't created.",
           },
 
-          change_directory_notice: "{{*}} Change directories to {{green:%s}} to run script commands",
-          creating: "Creating script",
-          created: "Created script",
+          change_directory_notice: "{{*}} Change directories to {{green:%s}} to run script commands.",
+          creating: "Creating script.",
+          created: "Created script.",
+          preparing_project: "Preparing script project structure.",
+          creating_wasm: "Creating configuration files.",
+          created_wasm: "Configuration files created.",
         },
 
         push: {
           help: <<~HELP,
-            Build the script, upload it to Shopify, and register it to an app.  If you've already pushed the script to this app, then use --force to replace the existing version on the app.
+            Build the script, upload it to Shopify, and register it to an app.
               Usage: {{command:%s script push}}
               Options:
-                {{command:[--force]}} Replaces the existing script on the app with this version.
+                {{command:[--force]}} Replace the existing script with this version.
                 {{command:[--api-key=API_KEY]}} The API key used to register an app with the script. This can be found on the app page on Partners Dashboard. Overrides the value in the .env file, if present.
                 {{command:[--api-secret=API_SECRET]}} The API secret of the app the script is registered with. Overrides the value in the .env file, if present.
                 {{command:[--uuid=UUID]}} The uuid of the script. Overrides the value in the .env file, if present.
@@ -202,34 +207,34 @@ module Script
           error: {
             operation_failed: "Couldn't connect script to app.",
             missing_env_file_variables: "The following variables are missing in the .env file: %s."\
-            " To connect the script to an app, either enter the value into the .env file or delete the .env file, then run {{command:%s script connect}}",
+            " To connect the script to an app, enter the value into the .env file or delete the .env file, and then run {{command:%s script connect}}",
           },
         },
         javy: {
           help: <<~HELP,
-            Compile the JavaScript code into WebAssembly.
+            Compile the JavaScript code into Wasm.
               Usage: {{command:%s script javy}}
               Options:
                 {{command:--in}} The name of the JavaScript file that will be compiled.
-                {{command:--out}} The name of the file that the WebAssembly should be written to.
+                {{command:--out}} The name of the file that the Wasm should be written to.
           HELP
           errors: {
-            invalid_arguments: "Javy was run with invalid arguments. Run {{command: %s script javy --help}} for more information.",
+            invalid_arguments: "Javy was run with invalid arguments. Run {{command: %s script javy --help}}.",
           },
         },
 
         project_deps: {
-          none_required: "{{v}} None required",
-          checking_with_npm: "Checking dependencies with npm",
-          installing: "Dependencies installing",
-          installed: "Missing dependencies installed",
+          none_required: "{{v}} Dependencies are up to date.",
+          checking: "Checking dependencies.",
+          installing: "Installing dependencies.",
+          installed: "Installed missing dependencies.",
         },
 
         forms: {
           create: {
             select_extension_point: "Which Script API do you want to use?",
             select_language: "Which language do you want to use?",
-            script_name: "Script name",
+            script_name: "What do you want to name your script?",
           },
         },
 
@@ -238,14 +243,15 @@ module Script
           building_script: "Building script",
           built: "Built",
           pushing: "Pushing",
+          pushing_script: "Pushing script",
           pushed: "Pushed",
           ensure_env: {
             organization: "Partner organization {{green:%s (%s)}}.",
             organization_select: "Which partner organization do you want to use?",
-            app: "Script will be pushed to app {{green:%s}}.",
+            app: "Push script to app {{green:%s}}.",
             app_select: "Which app do you want to push this script to?",
-            ask_connect_to_existing_script: "The selected app has some scripts. Do you want to replace any of the "\
-              "existing scripts on the app with this script?",
+            ask_connect_to_existing_script: "This app contains scripts. Do you want to replace an "\
+              "existing script on the app with this script?",
             ask_which_script_to_connect_to: "Which script do you want to replace?",
           },
         },

data/lib/project_types/script/ui/error_handler.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "cli/ui"
 
 module Script
@@ -5,9 +7,9 @@ module Script
     module ErrorHandler
       def self.display(failed_op:, cause_of_error:, help_suggestion:)
         $stderr.puts(CLI::UI.fmt(ShopifyCLI::Context.message("script.error.generic")))
-        full_msg = failed_op ? failed_op.dup : ""
-        full_msg << " #{cause_of_error}" if cause_of_error
-        full_msg << " #{help_suggestion}" if help_suggestion
+        full_msg = failed_op ? failed_op.dup : String.new
+        append_msg(full_msg, cause_of_error) if cause_of_error
+        append_msg(full_msg, help_suggestion) if help_suggestion
         $stderr.puts(CLI::UI.fmt(full_msg.strip))
       end
 
@@ -22,6 +24,11 @@ module Script
         display_and_raise(failed_op: failed_op, **messages)
       end
 
+      private_class_method def self.append_msg(full_msg, msg_to_append)
+        full_msg << " " unless /\s$/.match?(full_msg)
+        full_msg << msg_to_append
+      end
+
       def self.error_messages(e)
         case e
         when Errno::EACCES
@@ -100,59 +107,81 @@ module Script
           }
         when Layers::Domain::Errors::MetadataNotFoundError
           {
-            cause_of_error: ShopifyCLI::Context.message("script.error.metadata_not_found_cause"),
-            help_suggestion: ShopifyCLI::Context.message("script.error.metadata_not_found_help"),
+            cause_of_error: ShopifyCLI::Context.message("script.error.metadata_not_found_cause", filename: e.filename),
+            help_suggestion: ShopifyCLI::Context.message("script.error.metadata_not_found_help", filename: e.filename),
+          }
+        when Layers::Domain::Errors::MissingScriptConfigFieldError
+          {
+            cause_of_error: ShopifyCLI::Context.message(
+              "script.error.missing_script_config_field_cause",
+              field: e.field,
+              filename: e.filename,
+            ),
+            help_suggestion: ShopifyCLI::Context.message("script.error.missing_script_config_field_help"),
           }
         when Layers::Infrastructure::Errors::BuildError
           {
             cause_of_error: ShopifyCLI::Context.message("script.error.build_error_cause"),
             help_suggestion: ShopifyCLI::Context.message("script.error.build_error_help"),
           }
-        when Layers::Infrastructure::Errors::InvalidScriptConfigYmlDefinitionError
-          {
-            cause_of_error: ShopifyCLI::Context.message("script.error.invalid_script_config_yml_definition_cause"),
-            help_suggestion: ShopifyCLI::Context.message("script.error.invalid_script_config_yml_definition_help"),
-          }
-        when Layers::Infrastructure::Errors::InvalidScriptJsonDefinitionError
-          {
-            cause_of_error: ShopifyCLI::Context.message("script.error.invalid_script_json_definition_cause"),
-            help_suggestion: ShopifyCLI::Context.message("script.error.invalid_script_json_definition_help"),
-          }
-        when Layers::Infrastructure::Errors::MissingScriptConfigYmlFieldError
-          {
-            cause_of_error: ShopifyCLI::Context.message("script.error.missing_script_config_yml_field_cause", e.field),
-            help_suggestion: ShopifyCLI::Context.message("script.error.missing_script_config_yml_field_help"),
-          }
-        when Layers::Infrastructure::Errors::MissingScriptConfigYmlFieldError
+        when Layers::Infrastructure::Errors::ScriptConfigParseError
           {
-            cause_of_error: ShopifyCLI::Context.message("script.error.missing_script_config_yml_field_cause", e.field),
-            help_suggestion: ShopifyCLI::Context.message("script.error.missing_script_config_yml_field_help"),
-          }
-        when Layers::Infrastructure::Errors::MissingScriptJsonFieldError
-          {
-            cause_of_error: ShopifyCLI::Context.message("script.error.missing_script_json_field_cause", e.field),
-            help_suggestion: ShopifyCLI::Context.message("script.error.missing_script_json_field_help"),
+            cause_of_error: ShopifyCLI::Context.message(
+              "script.error.script_config_parse_error_cause",
+              filename: e.filename,
+              serialization_format: e.serialization_format,
+            ),
+            help_suggestion: ShopifyCLI::Context.message("script.error.script_config_parse_error_help"),
           }
-        when Layers::Infrastructure::Errors::NoScriptConfigYmlFileError
+        when Layers::Infrastructure::Errors::NoScriptConfigFileError
           {
-            cause_of_error: ShopifyCLI::Context.message("script.error.no_script_config_yml_file_cause"),
-            help_suggestion: ShopifyCLI::Context.message("script.error.no_script_config_yml_file_help"),
-          }
+            cause_of_error: ShopifyCLI::Context.message(
+              "script.error.no_script_config_file_cause",
+              filename: e.filename,
+            ),
+            help_suggestion: ShopifyCLI::Context.message("script.error.no_script_config_file_help"),
+          }
+        when Layers::Infrastructure::Errors::ScriptConfigurationDefinitionError
+          if e.messages.count == 1
+            {
+              cause_of_error: ShopifyCLI::Context.message(
+                "script.error.configuration_definition_error_cause",
+                message: e.messages.fetch(0),
+                filename: e.filename,
+              ),
+              help_suggestion: ShopifyCLI::Context.message("script.error.configuration_definition_error_help"),
+            }
+          else
+            {
+              cause_of_error: ShopifyCLI::Context.message(
+                "script.error.configuration_definition_errors_cause",
+                concatenated_messages: e.messages.map { |m| "{{x}} #{m}" }.join("\n"),
+                filename: e.filename,
+                error_count: e.messages.count,
+              ),
+              help_suggestion: ShopifyCLI::Context.message("script.error.configuration_definition_errors_help"),
+            }
+          end
         when Layers::Infrastructure::Errors::ScriptConfigSyntaxError
           {
-            cause_of_error: ShopifyCLI::Context.message("script.error.configuration_syntax_error_cause"),
+            cause_of_error: ShopifyCLI::Context.message(
+              "script.error.configuration_syntax_error_cause",
+              filename: e.filename,
+            ),
             help_suggestion: ShopifyCLI::Context.message("script.error.configuration_syntax_error_help"),
           }
         when Layers::Infrastructure::Errors::ScriptEnvAppNotConnectedError
           {
             cause_of_error: ShopifyCLI::Context.message("script.error.app_not_connected_cause"),
-            help_suggestion: ShopifyCLI::Context.message("script.error.app_not_connected_help"),
+            help_suggestion: ShopifyCLI::Context.message("script.error.app_not_connected_help",
+              tool_name: ShopifyCLI::TOOL_NAME),
           }
         when Layers::Infrastructure::Errors::ScriptConfigMissingKeysError
           {
             cause_of_error: ShopifyCLI::Context.message(
               "script.error.configuration_missing_keys_error_cause",
-              missing_keys: e.missing_keys
+              missing_keys: e.missing_keys,
+              filename: e.filename,
             ),
             help_suggestion: ShopifyCLI::Context.message("script.error.configuration_missing_keys_error_help"),
           }
@@ -160,7 +189,8 @@ module Script
           {
             cause_of_error: ShopifyCLI::Context.message(
               "script.error.configuration_invalid_value_error_cause",
-              valid_input_modes: e.valid_input_modes
+              valid_input_modes: e.valid_input_modes,
+              filename: e.filename,
             ),
             help_suggestion: ShopifyCLI::Context.message("script.error.configuration_invalid_value_error_help"),
           }
@@ -168,7 +198,8 @@ module Script
           {
             cause_of_error: ShopifyCLI::Context.message(
               "script.error.configuration_schema_field_missing_keys_error_cause",
-              missing_keys: e.missing_keys
+              missing_keys: e.missing_keys,
+              filename: e.filename,
             ),
             help_suggestion: ShopifyCLI::Context.message(
               "script.error.configuration_definition_schema_field_missing_keys_error_help"
@@ -178,7 +209,8 @@ module Script
           {
             cause_of_error: ShopifyCLI::Context.message(
               "script.error.configuration_schema_field_invalid_value_error_cause",
-              valid_types: e.valid_types
+              valid_types: e.valid_types,
+              filename: e.filename,
             ),
             help_suggestion: ShopifyCLI::Context.message(
               "script.error.configuration_schema_field_invalid_value_error_help"
@@ -239,6 +271,11 @@ module Script
             cause_of_error: ShopifyCLI::Context.message("script.error.script_upload_cause"),
             help_suggestion: ShopifyCLI::Context.message("script.error.script_upload_help"),
           }
+        when Layers::Infrastructure::Errors::ScriptTooLargeError
+          {
+            cause_of_error: ShopifyCLI::Context.message("script.error.script_too_large_cause"),
+            help_suggestion: ShopifyCLI::Context.message("script.error.script_too_large_help", max_size: e.max_size),
+          }
         when Layers::Infrastructure::Errors::APILibraryNotFoundError
           {
             cause_of_error: ShopifyCLI::Context

data/lib/project_types/theme/commands/check.rb

@@ -4,6 +4,9 @@ require "theme_check"
 module Theme
   class Command
     class Check < ShopifyCLI::Command::SubCommand
+      recommend_default_node_range
+      recommend_default_ruby_range
+
       class Options < ShopifyCLI::Options
         def initialize(theme_check)
           super()

data/lib/project_types/theme/commands/delete.rb

@@ -5,6 +5,9 @@ require "shopify_cli/theme/development_theme"
 module Theme
   class Command
     class Delete < ShopifyCLI::Command::SubCommand
+      recommend_default_node_range
+      recommend_default_ruby_range
+
       options do |parser, flags|
         parser.on("-d", "--development") { flags[:development] = true }
         parser.on("-a", "--show-all") { flags[:show_all] = true }

data/lib/project_types/theme/commands/init.rb

@@ -3,6 +3,9 @@
 module Theme
   class Command
     class Init < ShopifyCLI::Command::SubCommand
+      recommend_default_node_range
+      recommend_default_ruby_range
+
       options do |parser, flags|
         parser.on("-u", "--clone-url URL") { |url| flags[:clone_url] = url }
       end

data/lib/project_types/theme/commands/language_server.rb

@@ -4,6 +4,9 @@ require "theme_check"
 module Theme
   class Command
     class LanguageServer < ShopifyCLI::Command::SubCommand
+      recommend_default_node_range
+      recommend_default_ruby_range
+
       def call(*)
         ThemeCheck::LanguageServer.start
       end

data/lib/project_types/theme/commands/package.rb

@@ -5,6 +5,9 @@ require "json"
 module Theme
   class Command
     class Package < ShopifyCLI::Command::SubCommand
+      recommend_default_node_range
+      recommend_default_ruby_range
+
       THEME_DIRECTORIES = %w[
         assets
         config

data/lib/project_types/theme/commands/publish.rb

@@ -4,6 +4,9 @@ require "shopify_cli/theme/theme"
 module Theme
   class Command
     class Publish < ShopifyCLI::Command::SubCommand
+      recommend_default_node_range
+      recommend_default_ruby_range
+
       options do |parser, flags|
         parser.on("-f", "--force") { flags[:force] = true }
       end

data/lib/project_types/theme/commands/pull.rb

@@ -1,17 +1,25 @@
 # frozen_string_literal: true
 require "shopify_cli/theme/theme"
 require "shopify_cli/theme/ignore_filter"
+require "shopify_cli/theme/include_filter"
 require "shopify_cli/theme/syncer"
 
 module Theme
   class Command
     class Pull < ShopifyCLI::Command::SubCommand
+      recommend_default_node_range
+      recommend_default_ruby_range
+
       options do |parser, flags|
         parser.on("-n", "--nodelete") { flags[:nodelete] = true }
         parser.on("-i", "--themeid=ID") { |theme_id| flags[:theme_id] = theme_id }
         parser.on("-t", "--theme=NAME_OR_ID") { |theme| flags[:theme] = theme }
         parser.on("-l", "--live") { flags[:live] = true }
         parser.on("-d", "--development") { flags[:development] = true }
+        parser.on("-o", "--only=PATTERN") do |pattern|
+          flags[:includes] ||= []
+          flags[:includes] << pattern
+        end
         parser.on("-x", "--ignore=PATTERN") do |pattern|
           flags[:ignores] ||= []
           flags[:ignores] << pattern
@@ -24,10 +32,13 @@ module Theme
         theme = find_theme(root, **options.flags)
         return if theme.nil?
 
+        include_filter = ShopifyCLI::Theme::IncludeFilter.new(options.flags[:includes])
         ignore_filter = ShopifyCLI::Theme::IgnoreFilter.from_path(root)
         ignore_filter.add_patterns(options.flags[:ignores]) if options.flags[:ignores]
 
-        syncer = ShopifyCLI::Theme::Syncer.new(@ctx, theme: theme, ignore_filter: ignore_filter)
+        syncer = ShopifyCLI::Theme::Syncer.new(@ctx, theme: theme,
+                                               include_filter: include_filter,
+                                               ignore_filter: ignore_filter)
         begin
           syncer.start_threads
           CLI::UI::Frame.open(@ctx.message("theme.pull.pulling", theme.name, theme.id, theme.shop)) do