gemstack-dev 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 232c6e46cd3a64ee5e389bbfad4fed124547e86e1a79d7edba7ff7512983dd54
-  data.tar.gz: 7233f446b4440574a6cac4b44356cec680b1f1cd34e9743c7076d74e0f50165f
+  metadata.gz: 4367307a1f2096e2672373427947112d9415a4e1b6563e5bf378ec8b730f7399
+  data.tar.gz: 83db91725ba722e334d68056f3063633e4c56ee43af1e89f90e3ebb8fbe77c6e
 SHA512:
-  metadata.gz: 255943a7f5f16acfa8f5a438ea46d30e58a4c0d72725142404ee999a8f5b8710c2f5f79ec70cf277b772a8d479c441c033305e06def6cf82df93a46dc62c87af
-  data.tar.gz: 56cd408b00b494071b98c4cfdd54f0073da358ca6bb056efbda5572c6d513c0926d64686004aee5177da36eb2ead2c454651a97224e08dac1737e5ddf25bb093
+  metadata.gz: 3ea6107e79bc7c419c5302a37f0d67e9f7a83d29153fb81c75343ca7e37f512b33f39f4c3b4631bbe7e75e651606f0bfc02a38bdd08e5a90cc3c39c51c6a5225
+  data.tar.gz: 435533d5e3f323d4a6cb85e3dba4c7de7cf9e534f8ff383157279ce65ca8b7e6525f7d9524363f982f347d3866215efec0264f517dfeb26b0140a86bf0e3e3e1

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.3
+
+See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).
+
+## 0.2.2
+
+See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).
+
 ## 0.2.1
 
 See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).

data/LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Shoaib Malik
+Copyright (c) 2026 Adware Technologies (https://www.adwaretech.com)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -3,7 +3,7 @@
 GemStack development server: single-origin gateway and process supervisor.
 
 Part of [GemStack](https://github.com/gemstack-rb/gemstack), a modular Ruby API framework for Next.js
-applications. All GemStack gems are developed together in that repository and released with the same
+applications by [Adware Technologies](https://www.adwaretech.com). All GemStack gems are developed together in that repository and released with the same
 version.
 
 ## Installation
@@ -21,4 +21,4 @@ Source, issues and pull requests: [gemstack-rb/gemstack](https://github.com/gems
 
 ## License
 
-MIT — see [LICENSE.txt](LICENSE.txt).
+Open source under the MIT License — © [Adware Technologies](https://www.adwaretech.com). See [LICENSE.txt](LICENSE.txt).

data/lib/gemstack/dev/supervisor.rb

@@ -22,7 +22,10 @@ module GemStack
       end
 
       def run
-        prepare_frontend if frontend?
+        if frontend?
+          check_node!
+          prepare_frontend
+        end
         start
         install_signal_handlers
         loop_until_stopped
@@ -108,6 +111,18 @@ module GemStack
         [frontend_dir.join("node_modules/.bin/next").to_s, "dev", "--hostname", LOOPBACK, "--port", port.to_s]
       end
 
+      # Next.js exits at once on an old Node.js with a line that's easy to miss
+      # among the other output; say it up front, with the command that fixes it.
+      def check_node!(node = Toolchain.node)
+        return if node && Toolchain.node_ok?(node[:version])
+
+        wanted = [@root.join(".node-version"), @root.join(".nvmrc")].find(&:file?)&.read&.strip
+        wanted = Toolchain::LTS_NODE if wanted.nil? || wanted.empty?
+        found = node ? "Node.js #{node[:version]} (#{node[:path]})" : "no `node` on the PATH"
+        raise Error, "Next.js needs Node.js #{Toolchain::MIN_NODE.join(".")} or newer; found #{found}.\n  " \
+                     "→ #{Toolchain.node_hint(wanted, Toolchain.node_manager(node&.fetch(:path)))}"
+      end
+
       # Installs frontend dependencies on first run so `gemstack new && gemstack dev`
       # works even with --skip-install.
       def prepare_frontend

data/lib/gemstack/dev/toolchain.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require "open3"
+require "rbconfig"
+
+module GemStack
+  module Dev
+    # The Ruby and Node.js a developer runs, and how to change them — for
+    # whichever version manager installed them (rbenv, rvm, asdf, mise,
+    # chruby, nvm, fnm, nodenv, Volta, Homebrew…). GemStack pins versions in
+    # files every manager reads (.ruby-version, .node-version, .nvmrc,
+    # .tool-versions) and never assumes one manager (DECISIONS D-066).
+    module Toolchain
+      MIN_RUBY = "3.3"
+      MIN_NODE = [20, 9].freeze # Next.js 16
+      LTS_NODE = "22"
+
+      # [pattern in the executable's path, manager name]; the first match wins.
+      RUBY_MANAGERS = [
+        [%r{/\.rbenv/}, :rbenv], [%r{/\.rvm/|/rvm/rubies/}, :rvm], [%r{/\.asdf/|/asdf/installs/}, :asdf],
+        [%r{/mise/installs/|/\.local/share/mise/}, :mise], [%r{/\.rubies/|/opt/rubies/}, :chruby],
+        [%r{/(?:opt/)?homebrew/|/usr/local/Cellar/}, :homebrew]
+      ].freeze
+      NODE_MANAGERS = [
+        [%r{/\.nvm/}, :nvm], [%r{/fnm/|/\.fnm/|fnm_multishells}, :fnm], [%r{/\.nodenv/}, :nodenv],
+        [%r{/\.asdf/|/asdf/installs/}, :asdf], [%r{/mise/installs/|/\.local/share/mise/}, :mise],
+        [%r{/\.volta/}, :volta], [%r{/(?:opt/)?homebrew/|/usr/local/Cellar/}, :homebrew]
+      ].freeze
+
+      module_function
+
+      def ruby_manager(path = RbConfig.ruby) = detect(RUBY_MANAGERS, path)
+      def node_manager(path) = path && detect(NODE_MANAGERS, path)
+
+      def detect(managers, path)
+        managers.find { |pattern, _| path.to_s.match?(pattern) }&.last
+      end
+
+      # How to install and select a Ruby, with the manager in use.
+      def ruby_hint(version, manager = ruby_manager)
+        {
+          rbenv: "rbenv install #{version} && rbenv local #{version}",
+          rvm: "rvm install #{version} && rvm use #{version}",
+          asdf: "asdf install ruby #{version} && asdf set ruby #{version}",
+          mise: "mise use ruby@#{version}",
+          chruby: "ruby-install ruby #{version}, then: chruby #{version}",
+          homebrew: "brew upgrade ruby (or install #{version} with rbenv, rvm, asdf or mise)"
+        }.fetch(manager, "install Ruby #{version} (e.g. with rbenv, rvm, asdf or mise) and make it the active Ruby")
+      end
+
+      # How to install and select a Node.js, with the manager in use.
+      def node_hint(version, manager)
+        {
+          nvm: "nvm install #{version} && nvm use #{version}",
+          fnm: "fnm install #{version} && fnm use #{version}",
+          nodenv: "nodenv install #{version} && nodenv local #{version}",
+          asdf: "asdf install nodejs #{version} && asdf set nodejs #{version}",
+          mise: "mise use node@#{version}",
+          volta: "volta install node@#{version}",
+          homebrew: "brew install node@#{version} (or use nvm, fnm, asdf or mise)"
+        }.fetch(manager, "install Node.js #{version} (e.g. with nvm, fnm, asdf or mise) and make it the active node")
+      end
+
+      # { version: "22.11.0", path: "/…/bin/node" } or nil when there's no node.
+      def node(run = ->(*cmd) { Open3.capture2e(*cmd) })
+        out, status = run.call("node", "-p", "process.version + ' ' + process.execPath")
+        return nil unless status.success?
+
+        version, path = out.strip.split(" ", 2)
+        { version: version.delete_prefix("v"), path: path }
+      rescue SystemCallError
+        nil
+      end
+
+      def node_ok?(version) = (version.to_s.split(".").map(&:to_i) <=> MIN_NODE) >= 0
+      def ruby_ok?(version = RUBY_VERSION) = Gem::Version.new(version) >= Gem::Version.new(MIN_RUBY)
+
+      # The Node.js version new apps pin: the one running `gemstack new` when
+      # it's new enough, else the current LTS line.
+      def pinned_node_version(run = ->(*cmd) { Open3.capture2e(*cmd) })
+        found = node(run)
+        found && node_ok?(found[:version]) ? found[:version] : LTS_NODE
+      end
+    end
+  end
+end

data/lib/gemstack/dev.rb

@@ -13,6 +13,7 @@ module GemStack
     autoload :Ports, "gemstack/dev/ports"
     autoload :Supervisor, "gemstack/dev/supervisor"
     autoload :Terminal, "gemstack/dev/terminal"
+    autoload :Toolchain, "gemstack/dev/toolchain"
 
     class Config < Settings
       # The single public port.

metadata

@@ -1,9 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: gemstack-dev
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.3
 platform: ruby
 authors:
+- Adware Technologies
 - Shoaib Malik
 bindir: bin
 cert_chain: []
@@ -15,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.1
+        version: 0.2.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.1
+        version: 0.2.3
 email:
 - gemstack26@gmail.com
 executables: []
@@ -39,6 +40,7 @@ files:
 - lib/gemstack/dev/ports.rb
 - lib/gemstack/dev/supervisor.rb
 - lib/gemstack/dev/terminal.rb
+- lib/gemstack/dev/toolchain.rb
 homepage: https://github.com/gemstack-rb/gemstack
 licenses:
 - MIT
@@ -55,7 +57,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '4.0'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="