shopify-cli 2.15.0 → 2.15.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5861ffd7a22ca4048791e4993469dff421162159c7dabbf06b413522297c4a8
-  data.tar.gz: b5593ee5d6cfbf5c9b616b050263eb825d2d7a9846f5bf71953b4d7f708ee06e
+  metadata.gz: 8f795330308fe8098043f9757452c62c5366eebcd724a90b3e81aafceb82a4f0
+  data.tar.gz: b5bac3e2def77bb94b993d39230a489d646bee5848cf4500e523da2b413e517f
 SHA512:
-  metadata.gz: 8cf0ff62f5bf1687d5d98f4d808bf9f7d0bb921322483a5e446e34ef6638ff5a67a5ae15b3e34916a9c4fe627f4aee581f8630d4182925928eb67a762624c103
-  data.tar.gz: 161eba94f7e0fd3ca350a162eef9706c8f5a76da972eb4b3cbefdc2f9f3fdc8a37a72b7a48f47d81e1860dca4367eb8c2ceae6fe1bd57d4a9a61c7df3ecd0209
+  metadata.gz: 05ffb12d03f75fd4bd1f5f8e0709445b51364cd8d8576407473c2f7ccc8ae1fa6d202181005041dd258ede96a1cd4a2382d9572cc427f936d62a9071229ce997
+  data.tar.gz: 2afbac5fe6fc03aa52858b00118661faac907cb23bb9c37368e46e4eb79feb3a309482d7ac59828b964c7a43d6de3c2446e750b6412344729e115f422b42bb84

data/.github/workflows/stale.yml

@@ -8,6 +8,7 @@ name: Mark stale issues and pull requests
 on:
   schedule:
   - cron: '31 3 * * *' # randomly chosen time of day
+  workflow_dispatch:
 
 jobs:
   stale:
@@ -18,7 +19,7 @@ jobs:
       pull-requests: write
 
     steps:
-    - uses: actions/stale@v3
+    - uses: actions/stale@v4
       with:
         repo-token: ${{ secrets.GITHUB_TOKEN }}
         days-before-issue-stale: 90
@@ -38,4 +39,8 @@ jobs:
           Thanks for helping to improve Shopify's dev tooling and experience.
         stale-issue-label: 'no-issue-activity'
         stale-pr-label: 'no-pr-activity'
-        operations-per-run: 10 # temporary so we can ease into staling and see what happens
+        ascending: true
+        # The math seems a bit fuzzy, but this should amount to a max of 50 issues daily.
+        # But then the same issues get checked first so we don't end up progressing too quickly until we can close what we started.
+        # Hopefully https://github.com/actions/stale/issues/692 will be closed and fix some of this mess.
+        operations-per-run: 200

data/.vscode/settings.json

@@ -5,5 +5,4 @@
     "**/.DS_Store": true
   },
   "editor.formatOnSave": false,
-  "workbench.colorTheme": "Dracula Soft",
-}
+}

data/CHANGELOG.md

@@ -2,7 +2,44 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 
 ## [Unreleased]
 
-## Version 2.15.0
+## Version 2.15.3 - 2022-04-07
+
+### Changed
+* [#2188](https://github.com/Shopify/shopify-cli/pull/2188): Update URLs by default on serve and add --no-update flag to skip it
+* [#2203](https://github.com/Shopify/shopify-cli/pull/2203): Use javy version 0.3.0
+
+### Fixed
+* [#2162](https://github.com/Shopify/shopify-cli/pull/2162): Improve encoding error handling for Checkout Extension localization
+* [#2187](https://github.com/Shopify/shopify-cli/pull/2187): Fix app serve after rails update
+* [#2191](https://github.com/Shopify/shopify-cli/pull/2191): Directories with the `.json` extension should not be handled as JSON files
+* [#2018](https://github.com/Shopify/shopify-cli/pull/2018): Run theme-check as a code dependency, not a pseudo-CLI invocation
+* [#2211](https://github.com/Shopify/shopify-cli/pull/2211): Fix the `theme open` command to open the theme in the browser
+* [#2183](https://github.com/Shopify/shopify-cli/pull/2183): Improve error message when suspended users run `theme serve`
+* [#2219](https://github.com/Shopify/shopify-cli/pull/2219): Fix issues when creating Rails apps after the release of `shopify_app` v19
+
+### Added
+* [#2190](https://github.com/Shopify/shopify-cli/pull/2190): Better login experience with spinner
+* [#2200](https://github.com/Shopify/shopify-cli/pull/2200): Add `theme share` command
+
+## Version 2.15.2 - 2022-03-28
+
+### Fixed
+* [#2121](https://github.com/Shopify/shopify-cli/pull/2121): Fix the hot-reload to work when the section name is not equal to the type
+
+### Added
+* [#2174](https://github.com/Shopify/shopify-cli/pull/2174): Add optional 2-way sync between the CLI (`theme serve`) and the Theme Editor
+
+## Version 2.15.1 - 2022-03-24
+
+### Added
+* [#1934](https://github.com/Shopify/shopify-cli/pull/1934): Block directories in theme assets
+* [#1880](https://github.com/Shopify/shopify-cli/pull/1880): Recognize attempts to pass a store name and suggest correction
+
+### Fixed
+* [#1874](https://github.com/Shopify/shopify-cli/pull/1874): Make ngrok errors more robust and helpful
+* [#2172](https://github.com/Shopify/shopify-cli/pull/2172): Fix Ruby check for Rails app creation
+
+## Version 2.15.0 - 2022-03-21
 
 ### Fixed
 * [#2086](https://github.com/Shopify/shopify-cli/pull/2086): Improve check of dependency versions
@@ -10,7 +47,7 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 * [#2122](https://github.com/Shopify/shopify-cli/pull/2122): Fix `--only`/`--ignore` flags parser to support multiple occurrences without quotes
 * [#2146](https://github.com/Shopify/shopify-cli/pull/2146): Prevent duplicate locales for Checkout extension localization
 
-## Version 2.14.0
+## Version 2.14.0 - 2022-03-15
 
 ### Changed
 * [#2126](https://github.com/Shopify/shopify-cli/pull/2126): Use javy version 0.2.1
@@ -24,7 +61,7 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 * [#2130](https://github.com/Shopify/shopify-cli/pull/2130): Fix Homebrew installation.
 * [#2133](https://github.com/Shopify/shopify-cli/pull/2133): Fix ignore file handling in DevServer::Watcher.
 
-## Version 2.13.0
+## Version 2.13.0 - 2022-03-02
 
 ### Added
 * [#2087](https://github.com/Shopify/shopify-cli/pull/2087): Add new Theme CLI commands: `theme list` and `theme open`
@@ -38,7 +75,8 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 ### Removed
 * [#2102](https://github.com/Shopify/shopify-cli/pull/2102): Remove AssemblyScript as a supported script language.
 
-## Version 2.12.0
+## Version 2.12.0 - 2022-02-23
+
 ### 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
@@ -53,21 +91,24 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 * [#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
+## Version 2.11.2 - 2022-02-14
+
 ### 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
+## Version 2.11.1 - 2022-02-09
+
 ### Fixed
 * [#1973](https://github.com/Shopify/shopify-cli/pull/1973): Fix `theme serve` to preview generated files (`*.css.liquid`)
 * [#2034](https://github.com/Shopify/shopify-cli/pull/2034): Fix `theme serve` to accept parameters with multiple values
 * [#2033](https://github.com/Shopify/shopify-cli/pull/2033): Pin Homebrew Ruby to 3.0
 * [#2032](https://github.com/Shopify/shopify-cli/pull/2032): Runtime error checking the Node version if Node is not present in the environment.
 
-## Version 2.11.0
+## Version 2.11.0 - 2022-02-07
+
 ### Fixed
 * [#2005](https://github.com/Shopify/shopify-cli/pull/2005): Fix PHP app serve on Windows environments
 
@@ -82,17 +123,20 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 * [#2002](https://github.com/Shopify/shopify-cli/pull/2002): Update `-o`/`--only` parameter to allow multiple patterns on `theme push`/`theme pull` commands
 * [#2022](https://github.com/Shopify/shopify-cli/pull/2022): Don't warn the user if the Ruby version is in the range 3.0.x.
 
-## Version 2.10.2
+## Version 2.10.2 - 2022-01-31
+
 ### Fixed
 * [#1983](https://github.com/Shopify/shopify-cli/pull/1983): Improve Windows compatibility
 * [#1928](https://github.com/Shopify/shopify-cli/pull/1928): Ensure script Wasm file sizes don't exceed the limit
 * [#2006](https://github.com/Shopify/shopify-cli/pull/2006): Fix: More defensive URL generation
 
-## Version 2.10.1
+## Version 2.10.1 - 2022-01-28
+
 ### Fixed
 * [#1985](https://github.com/Shopify/shopify-cli/pull/1985): Revert "Fix CORS (Cross-origin resource sharing) errors (#1952)"
 
-## Version 2.10.0
+## Version 2.10.0 - 2022-01-25
+
 ### Fixed
 * [#1937](https://github.com/Shopify/shopify-cli/pull/1937): Fix `theme pull` to no longer add empty lines on Windows
 * [#1952](https://github.com/Shopify/shopify-cli/pull/1952): Fix CORS (cross-origin resource sharing) errors
@@ -101,7 +145,8 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 ### Added
 * [#1892](https://github.com/Shopify/shopify-cli/pull/1892): Add `-o`/`--only` parameter to filter files on `theme push`/`theme pull` commands
 
-## Version 2.9.0
+## Version 2.9.0 - 2022-01-17
+
 ### Fixed
 * [#1922](https://github.com/Shopify/shopify-cli/pull/1922): Respect RUBY_BINDIR from Homebrew for installing gem
 * [#1906](https://github.com/Shopify/shopify-cli/pull/1906): Fix Ngrok incompatibility with some Apple ARM environments
@@ -115,13 +160,15 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 * [#1871](https://github.com/Shopify/shopify-cli/pull/1871): Add a new `--live-reload` parameter to the `theme serve` command
 
 ### Changed
-- [#1929](https://github.com/Shopify/shopify-cli/pull/1929): Rename `--registration-id` to `--extension-id` in `shopify extension push`.
+* [#1929](https://github.com/Shopify/shopify-cli/pull/1929): Rename `--registration-id` to `--extension-id` in `shopify extension push`.
+
+## Version 2.8.0 - 2022-01-06
 
-## Version 2.8.0
 ### Fixed
 * [#1879](https://github.com/Shopify/shopify-cli/pull/1879): Disambiguate -s as store option
 
-## Version 2.7.4
+## Version 2.7.4 - 2021-12-22
+
 ### Added
 * [#1825](https://github.com/Shopify/shopify-cli/pull/1825): Support passing the connection information through arguments
 
@@ -132,10 +179,11 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 * [#1850](https://github.com/Shopify/shopify-cli/pull/1850): Fix `shopify extension` commands timeout when organization has too many apps
 * [#1860](https://github.com/Shopify/shopify-cli/pull/1860): Fix `theme serve` hot reload when there are many tabs active
 
-## Version 2.7.3
+## Version 2.7.3 - 2021-12-13
+
 ### Added
 * [#1826](https://github.com/Shopify/shopify-cli/pull/1826): Support using `script.config.yml` file for script configuration
-* [#1843](https://github.com/Shopify/shopify-cli/pull/1826): Support using javy on Apple ARM processors
+* [#1843](https://github.com/Shopify/shopify-cli/pull/1843): Support using javy on Apple ARM processors
 * [#1847](https://github.com/Shopify/shopify-cli/pull/1847): `shopify script connect` command.
 
 ### Fixed
@@ -148,7 +196,8 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 * [#1830](https://github.com/Shopify/shopify-cli/pull/1830): Fix hot reload when users update many files "simultaneously"
 * [#1837](https://github.com/Shopify/shopify-cli/pull/1837): Fix `ShopifyCLI::Theme::DevServer::CdnFonts` class to support any font
 
-## Version 2.7.2
+## Version 2.7.2 - 2021-11-30
+
 ### Fixed
 * [#1763](https://github.com/Shopify/shopify-cli/pull/1763): Fix: Tunnel --PORT parameter not working in Node.js app.
 * [#1769](https://github.com/Shopify/shopify-cli/pull/1769): Fix `theme push --development --json` to output the proper exit code
@@ -159,14 +208,16 @@ From version 2.6.0, the sections in this file adhere to the [keep a changelog](h
 * [#1788](https://github.com/Shopify/shopify-cli/pull/1788): Improve `theme serve` errors and add logs for successful operations
 * [#1794](https://github.com/Shopify/shopify-cli/pull/1794): Fix bug where hidden subcommands appear in the help menu.
 
-## Version 2.7.1
+## Version 2.7.1 - 2021-11-17
+
 ### Fixed
 * [#1722](https://github.com/Shopify/shopify-cli/pull/1722): Fix `theme serve` failing when the port is already being used
 * [#1751](https://github.com/Shopify/shopify-cli/pull/1751): A bug in the app creation flow that caused the CLI to abort when the form validation failed.
 * [#1750](https://github.com/Shopify/shopify-cli/pull/1750): Runtime errors in Windows' environments when the `PATHEXT` environment variable is not defined.
 * [#1758](https://github.com/Shopify/shopify-cli/pull/1758): Fix tunnel creation for expired anonymous tunnels
 
-## Version 2.7.0
+## Version 2.7.0 - 2021-11-15
+
 ### Changed
 * [#1650](https://github.com/Shopify/shopify-cli/pull/1650): **Breaking** Move app commands under `shopify app`.
 

data/Gemfile

@@ -15,6 +15,7 @@ group :development, :test do
   gem "rubocop-rake", require: false
   gem "iniparse", "~> 1.5"
   gem "colorize", "~> 0.8.1"
+  gem "octokit", "~> 4.0"
 end
 
 group :test do

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    shopify-cli (2.15.0)
+    shopify-cli (2.15.3)
       bugsnag (~> 6.22)
       listen (~> 3.7.0)
       theme-check (~> 1.10.1)
@@ -13,13 +13,13 @@ GEM
       public_suffix (>= 2.0.2, < 5.0)
     ansi (1.5.0)
     ast (2.4.2)
-    bugsnag (6.23.0)
+    bugsnag (6.24.2)
       concurrent-ruby (~> 1.0)
     builder (3.2.4)
     byebug (11.1.3)
     coderay (1.1.3)
     colorize (0.8.1)
-    concurrent-ruby (1.1.9)
+    concurrent-ruby (1.1.10)
     crack (0.4.5)
       rexml
     cucumber (7.0.0)
@@ -55,11 +55,34 @@ GEM
       cucumber-messages (~> 17.0, >= 17.0.1)
     diff-lcs (1.4.4)
     fakefs (1.3.2)
+    faraday (1.10.0)
+      faraday-em_http (~> 1.0)
+      faraday-em_synchrony (~> 1.0)
+      faraday-excon (~> 1.1)
+      faraday-httpclient (~> 1.0)
+      faraday-multipart (~> 1.0)
+      faraday-net_http (~> 1.0)
+      faraday-net_http_persistent (~> 1.0)
+      faraday-patron (~> 1.0)
+      faraday-rack (~> 1.0)
+      faraday-retry (~> 1.0)
+      ruby2_keywords (>= 0.0.4)
+    faraday-em_http (1.0.0)
+    faraday-em_synchrony (1.0.0)
+    faraday-excon (1.1.0)
+    faraday-httpclient (1.0.1)
+    faraday-multipart (1.0.3)
+      multipart-post (>= 1.2, < 3)
+    faraday-net_http (1.0.1)
+    faraday-net_http_persistent (1.2.0)
+    faraday-patron (1.0.0)
+    faraday-rack (1.0.0)
+    faraday-retry (1.0.3)
     ffi (1.15.4)
     hashdiff (1.0.1)
     iniparse (1.5.0)
-    liquid (5.1.0)
-    listen (3.7.0)
+    liquid (5.3.0)
+    listen (3.7.1)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     method_source (1.0.0)
@@ -77,9 +100,13 @@ GEM
       ruby-progressbar
     mocha (1.13.0)
     multi_test (0.1.2)
+    multipart-post (2.1.1)
     nokogiri (1.13.3)
       mini_portile2 (~> 2.8.0)
       racc (~> 1.4)
+    octokit (4.22.0)
+      faraday (>= 0.9)
+      sawyer (~> 0.8.0, >= 0.5.3)
     parallel (1.21.0)
     parser (3.1.1.0)
       ast (~> 2.4.1)
@@ -94,7 +121,7 @@ GEM
     rack (2.2.3)
     rainbow (3.1.1)
     rake (13.0.6)
-    rb-fsevent (0.11.0)
+    rb-fsevent (0.11.1)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
     regexp_parser (2.2.0)
@@ -117,9 +144,13 @@ GEM
     rubocop-shopify (2.0.1)
       rubocop (~> 1.11)
     ruby-progressbar (1.11.0)
+    ruby2_keywords (0.0.5)
+    sawyer (0.8.2)
+      addressable (>= 2.3.5)
+      faraday (> 0.8, < 2.0)
     sys-uname (1.2.2)
       ffi (~> 1.1)
-    theme-check (1.10.1)
+    theme-check (1.10.2)
       liquid (>= 5.1.0)
       nokogiri (>= 1.12)
       parser (~> 3)
@@ -144,6 +175,7 @@ DEPENDENCIES
   minitest-fail-fast
   minitest-reporters
   mocha
+  octokit (~> 4.0)
   pry-byebug
   rack
   rake

data/Rakefile

@@ -129,6 +129,54 @@ end
 desc("Builds all distribution packages of the CLI")
 task(package: "package:all")
 
+namespace :changelog do
+  require "shopify_cli/changelog"
+
+  task :update do
+    ShopifyCLI::Changelog.new.update!
+  end
+end
+
+namespace :release do
+  require "shopify_cli/release"
+
+  task :prepare, [:new_version] do |_t, args|
+    new_version = args[:new_version]
+    unless new_version
+      raise <<~NO_NEW_VERSION
+        New version must be provided, e.g.:
+
+        $ GITHUB_ACCESS_TOKEN=abcdef rake "release:prepare[1.2.3]"
+
+      NO_NEW_VERSION
+    end
+    github_access_token = ENV["GITHUB_ACCESS_TOKEN"]
+    unless github_access_token
+      raise <<~NO_GITHUB_ACCESS_TOKEN
+        GitHub access token must be provided, e.g.:
+
+        $ GITHUB_ACCESS_TOKEN=abcdef rake "release:prepare[1.2.3]"
+      NO_GITHUB_ACCESS_TOKEN
+    end
+
+    ShopifyCLI::Release.new(new_version, github_access_token).prepare!
+    puts "Completed!"
+  end
+
+  task :package do
+    github_access_token = ENV["GITHUB_ACCESS_TOKEN"]
+    unless github_access_token
+      raise <<~NO_GITHUB_ACCESS_TOKEN
+        GitHub access token must be provided, e.g.:
+
+        $ GITHUB_ACCESS_TOKEN=abcdef rake release:package
+      NO_GITHUB_ACCESS_TOKEN
+    end
+    ShopifyCLI::Release.new(ShopifyCLI::VERSION, github_access_token).package!
+    puts "Completed!"
+  end
+end
+
 namespace :extensions do
   task :update do
     version = ENV.fetch("VERSION").strip

data/ext/javy/hashes/javy-arm-macos-v0.3.0.gz.sha256

@@ -0,0 +1 @@
+c7e97d166e46d96fa43a70046c80607035101b4a96e40edcf4643a6c92913692

data/ext/javy/hashes/javy-x86_64-linux-v0.3.0.gz.sha256

@@ -0,0 +1 @@
+877e6383b921de2b93ecaf5d1d902c7305d65bdab52758b9d5c02d9c5cea45ab

data/ext/javy/hashes/javy-x86_64-macos-v0.3.0.gz.sha256

@@ -0,0 +1 @@
+c8a40adf83cacae33f819fa78501355eee9077dce3818ab4a483b2473952941e

data/ext/javy/hashes/javy-x86_64-windows-v0.3.0.gz.sha256

@@ -0,0 +1 @@
+9ca1e65b0f7a2645f408cb65e683d243069f03828d4b3eeaf59f3012e5d41e73

data/ext/javy/version

@@ -1 +1 @@
-v0.2.1
+v0.3.0

data/ext/shopify-extensions/version

@@ -1 +1 @@
-v0.1.0
+v0.2.0

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

@@ -32,7 +32,12 @@ module Extension
 
       def call(*)
         if project.specification_identifier == "THEME_APP_EXTENSION"
-          @theme_check.run
+          begin
+            @theme_check.run!
+          rescue ThemeCheck::Cli::Abort, ThemeCheck::ThemeCheckError => e
+            raise ShopifyCLI::Abort,
+              ShopifyCLI::Context.message("theme.check.error", e.full_message)
+          end
         else
           @ctx.abort(@ctx.message("check.unsupported", project.specification_identifier))
         end

data/lib/project_types/extension/forms/questions/ask_template.rb

@@ -11,21 +11,18 @@ module Extension
           default: -> { CLI::UI::Prompt.method(:ask) }
 
         def call(project_details)
-          return project_details unless template_required?(project_details)
-          project_details.template = template || choose_interactively
+          if template_required?(project_details)
+            project_details.template = template || choose_interactively
+          end
           project_details
         end
 
         private
 
         def template_required?(project_details)
-          return false unless extension_server_beta?
           type = project_details&.type&.identifier
-          Models::DevelopmentServerRequirements::SUPPORTED_EXTENSION_TYPES.include?(type.downcase)
-        end
-
-        def extension_server_beta?
-          ShopifyCLI::Shopifolk.check && ShopifyCLI::Feature.enabled?(:extension_server_beta)
+          (Models::DevelopmentServerRequirements.beta_enabled? &&
+            Models::DevelopmentServerRequirements.type_supported?(type.downcase))
         end
 
         def choose_interactively

data/lib/project_types/extension/messages/messages.rb

@@ -41,7 +41,7 @@ module Extension
         invalid_api_key: "The API key %s does not match any of your apps.",
         ask_app: "Which app would you like to register this extension with?",
         no_apps: "{{x}} You don’t have any apps.",
-        learn_about_apps: "{{*}} Learn more about building apps at <https://shopify.dev/concepts/apps>, " \
+        learn_about_apps: "{{*}} Learn more about building apps at <https://shopify.dev/apps>, " \
           "or try creating a new app using {{command:shopify [node|rails] create}}.",
         loading_apps: "Loading your apps…",
         no_available_extensions: "{{x}} There are no available extensions for this app.",
@@ -73,8 +73,6 @@ module Extension
         help: <<~HELP,
           Register your local extension to a Shopify app
               Usage: {{command:%s extension register}}
-              Options:
-                {{command:--api-key=API_KEY}} The API key used to register an app with the extension. This can be found on the app page on Partners Dashboard.
         HELP
         frame_title: "Registering Extension",
         waiting_text: "Registering with Shopify…",
@@ -115,6 +113,16 @@ module Extension
         tunnel_already_running: "A tunnel running on another port has been detected. Close the tunnel and try again.",
       },
       tunnel: {
+        duplicate_session: <<~MESSAGE,
+          Another ngrok tunnel is currently running with your auth token, possibly on another machine.
+
+          Terminate that tunnel before opening a new one.
+        MESSAGE
+        invalid_token: <<~MESSAGE,
+          The ngrok token currently configured is invalid.
+
+          After generating a new token, update your local ngrok configuration using {{command:shopify app tunnel auth <token>}}
+        MESSAGE
         missing_token: "{{x}} {{red:auth requires a token argument}}. "\
           "Find it on your ngrok dashboard: {{underline:https://dashboard.ngrok.com/auth/your-authtoken}}.",
         invalid_port: "%s is not a valid port.",

data/lib/project_types/extension/models/development_server_requirements.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 require "shopify_cli"
 
 module Extension
@@ -8,25 +9,31 @@ module Extension
         "checkout_ui_extension",
         "checkout_post_purchase",
         "product_subscription",
+        "beacon_extension",
       ]
 
       class << self
         def supported?(type)
-          binary_installed? && type_supported?(type) && beta_enabled?
+          binary_installed? && type_supported?(type) && type_enabled?(type)
         end
 
-        private
-
-        def binary_installed?
-          Models::DevelopmentServer.new.executable_installed?
+        def beta_enabled?
+          ShopifyCLI::Feature.enabled?(:extension_server_beta)
         end
 
         def type_supported?(type)
           SUPPORTED_EXTENSION_TYPES.include?(type.downcase)
         end
 
-        def beta_enabled?
-          ShopifyCLI::Shopifolk.check && ShopifyCLI::Feature.enabled?(:extension_server_beta)
+        private
+
+        def binary_installed?
+          Models::DevelopmentServer.new.executable_installed?
+        end
+
+        # Some types are enabled unconditionally; others require beta_enabled
+        def type_enabled?(type)
+          beta_enabled? || "checkout_ui_extension" == type.downcase
         end
       end
     end

data/lib/project_types/extension/models/server_config/root.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "yaml"
+
 module Extension
   module Models
     module ServerConfig

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

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+require "base64"
+require "fileutils"
+require "json"
+require_relative "beacon_extension_utils/script_config"
+require_relative "beacon_extension_utils/script_config_repository"
+
+module Extension
+  module Models
+    module SpecificationHandlers
+      class BeaconExtension < Default
+        SCRIPT_FILE = "build/main.js"
+
+        def name
+          "Beacon Extension"
+        end
+
+        def read_configuration
+        end
+
+        def access_config_property(context, ext_config, key, &process_value)
+          context.abort(context.message("core.extension.push.beacon_extension.error.missing_config_key_error",
+            key)) unless ext_config.key?(key)
+
+          begin
+            process_value.nil? ? ext_config[key] : process_value.call(ext_config[key])
+          rescue StandardError
+            context.abort(context.message("core.extension.push.beacon_extension.error.invalid_config_value_error", key))
+          end
+        end
+
+        def config(context)
+          begin
+            ext_config = BeaconExtensionUtils::ScriptConfigYmlRepository.new(ctx: context).get!.content
+          rescue StandardError
+            context.abort(context.message("core.extension.push.beacon_extension.error.file_read_error",
+              BeaconExtensionUtils::ScriptConfigYmlRepository.filename))
+          end
+
+          begin
+            script_contents = File.read(File.join(context.root, SCRIPT_FILE)).chomp
+          rescue
+            context.abort(context.message("core.extension.push.beacon_extension.error.file_read_error", SCRIPT_FILE))
+          end
+          {
+            runtime_context: access_config_property(context, ext_config, "runtime_context"),
+            serialized_script: Base64.strict_encode64(script_contents),
+            runtime_configuration_definition: access_config_property(context, ext_config,
+              "configuration", &:to_json),
+            config_version: access_config_property(context, ext_config,
+              "version", &:to_s),
+          }
+        end
+      end
+    end
+  end
+end

data/lib/project_types/extension/models/specification_handlers/beacon_extension_utils/script_config.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Extension
+  module Models
+    module SpecificationHandlers
+      module BeaconExtensionUtils
+        class ScriptConfig
+          attr_reader :content, :version, :configuration, :filename
+
+          REQUIRED_FIELDS = %w(version)
+
+          def initialize(content:, filename:)
+            @filename = filename
+            validate_content!(content)
+            @content = content
+            @version = @content["version"].to_s
+            @configuration = @content["configuration"]
+          end
+
+          private
+
+          def validate_content!(content)
+            REQUIRED_FIELDS.each do |field|
+              if content[field].nil?
+                raise "invalid field:#{field}, filename:#{filename}"
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end