gemstack-cli 0.2.2 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f9ebe8567d9943d054f3baaf1427483fd75242677bc8a461034d63a826b197e
-  data.tar.gz: 816d6520c304822b290f30b417f574dfe8bd771586d5bc8a6df2b929ec144b4f
+  metadata.gz: 7896a4b00040ddd5556a6923b290c0fc08bcad07884246023343f5a84e7356c7
+  data.tar.gz: 30d763aa7d951a808183769dce19cd92b4c577b7aabc9c17af29ec7197b8eda2
 SHA512:
-  metadata.gz: 7068ec73cee6b4f0e87cb5c84a4f0531bbfd8444df9170a994e6223f8a32cf7d5b814ef089bc5c5854ce539e919bc9a5dde10118dcfcd035ac02099bff5e5e28
-  data.tar.gz: f1c8ddf36a3b0eb81f7a1a680b5c95bfa8df8328dbbf0804f927bfb85339f02fba020cb6e8d66e16f0c14fff3902a2183bd49a212dc1a39bf3ce650365b55b62
+  metadata.gz: 65e7fbeb0df98c81341c1cbb4f0a65ad7d8a13b590479fb47b7f100aec542504cd56c1e1f06154ab75b7ea02278a3ccf98ef62e998e71b81026132480bfdb71b
+  data.tar.gz: b35aff968928d09ca121b29607d579ede74c74829cd55713b001462f5d73e6b69087a31b0389239a53278e637ee678e1877d59497e3f7e201727d96f89a7948a

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.4
+
+See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).
+
+## 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).

data/lib/gemstack/cli/app_generator.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "gemstack/dev"
+
 module GemStack
   class CLI < Thor
     # `gemstack new NAME` — a Ruby API + Next.js application containing the
@@ -30,8 +32,12 @@ module GemStack
 
       def version = GemStack::VERSION
 
-      # Pins the app to the Ruby that generated it (.ruby-version, .tool-versions).
+      # Pins the app to the Ruby that generated it, in files every version
+      # manager reads (.ruby-version: rbenv, rvm, chruby, asdf, mise;
+      # .tool-versions: asdf, mise), and Node.js likewise (.node-version,
+      # .nvmrc, .tool-versions) — DECISIONS D-066.
       def ruby_version = RUBY_VERSION
+      def node_version = @node_version ||= Dev::Toolchain.pinned_node_version
       def frontend? = !@options[:skip_frontend]
       def database? = !@options[:skip_database]
 
@@ -54,7 +60,8 @@ module GemStack
         database_adapter if database? # fail early on an unknown --database
         @output.puts("Creating GemStack application #{name} in #{destination}")
         render_directory("app", destination, skip: lambda { |rel|
-          !database? && (rel.start_with?("db/", "app/models/") || rel == "config/database.yml.tt")
+          (!database? && (rel.start_with?("db/", "app/models/") || rel == "config/database.yml.tt")) ||
+            (!frontend? && %w[dot_node-version.tt dot_nvmrc.tt].include?(rel))
         })
         render_directory("frontend", File.join(destination, "frontend")) if frontend?
         install unless @options[:skip_install]

data/lib/gemstack/cli/doctor.rb

@@ -2,6 +2,7 @@
 
 require "open3"
 require "socket"
+require "gemstack/dev"
 
 module GemStack
   class CLI < Thor
@@ -50,11 +51,11 @@ module GemStack
 
       def check_ruby
         wanted = read(".ruby-version")&.strip&.delete_prefix("ruby-")
-        if wanted && !wanted.empty? && !RUBY_VERSION.start_with?(wanted)
-          caution("Ruby #{RUBY_VERSION}",
-                  "the app pins #{wanted} (.ruby-version) — install it: asdf install ruby #{wanted}")
-        elsif Gem::Version.new(RUBY_VERSION) < Gem::Version.new("4.0")
-          problem("Ruby #{RUBY_VERSION}", "GemStack needs Ruby 4.0 or newer")
+        if !Dev::Toolchain.ruby_ok?
+          problem("Ruby #{RUBY_VERSION}", "GemStack needs Ruby #{Dev::Toolchain::MIN_RUBY} or newer — " \
+                                          "#{Dev::Toolchain.ruby_hint(wanted.to_s.empty? ? "3.4" : wanted)}")
+        elsif wanted && !wanted.empty? && !RUBY_VERSION.start_with?(wanted)
+          caution("Ruby #{RUBY_VERSION}", "the app pins #{wanted} (.ruby-version) — #{Dev::Toolchain.ruby_hint(wanted)}")
         else
           pass("Ruby #{RUBY_VERSION}#{" (YJIT available)" if defined?(RubyVM::YJIT)}")
         end
@@ -63,17 +64,17 @@ module GemStack
       def check_node
         return unless File.directory?(path("frontend"))
 
-        out, status = @run.call("node", "--version")
-        version = status.success? ? out.strip.delete_prefix("v") : nil
-        if version.nil?
-          problem("Node.js not found", "install Node.js #{MIN_NODE.join(".")}+ (the frontend is Next.js)")
-        elsif (version.split(".").map(&:to_i) <=> MIN_NODE).negative?
-          problem("Node.js #{version}", "Next.js 16 needs Node.js #{MIN_NODE.join(".")} or newer")
+        node = Dev::Toolchain.node(@run)
+        wanted = read(".node-version")&.strip || read(".nvmrc")&.strip || Dev::Toolchain::LTS_NODE
+        if node.nil?
+          problem("Node.js not found", Dev::Toolchain.node_hint(wanted, nil))
+        elsif !Dev::Toolchain.node_ok?(node[:version])
+          problem("Node.js #{node[:version]} (#{node[:path]})",
+                  "Next.js 16 needs #{MIN_NODE.join(".")}+ — " \
+                  "#{Dev::Toolchain.node_hint(wanted, Dev::Toolchain.node_manager(node[:path]))}")
         else
-          pass("Node.js #{version}")
+          pass("Node.js #{node[:version]}")
         end
-      rescue SystemCallError
-        problem("Node.js not found", "install Node.js #{MIN_NODE.join(".")}+ (the frontend is Next.js)")
       end
 
       def check_frontend_dependencies

data/lib/gemstack/cli.rb

@@ -86,7 +86,7 @@ module GemStack
     method_option :grep, aliases: "-g", type: :string, desc: "Only routes matching this text"
     def routes
       root = Project.ensure_bundle!(self.class.argv)
-      ENV["GEMSTACK_ENV"] ||= "development"
+      use_environment!
       Project.load_config!(root)
       GemStack.config.reload_code = false
       GemStack.config.logger.level = :warn
@@ -101,7 +101,7 @@ module GemStack
     desc "console", "Start an IRB session with the application loaded (alias: c)"
     def console
       root = Project.ensure_bundle!(self.class.argv)
-      ENV["GEMSTACK_ENV"] = options[:environment] || ENV["GEMSTACK_ENV"] || "development"
+      use_environment!
       Project.load_config!(root)
       GemStack.boot!
       require "irb"
@@ -228,6 +228,9 @@ module GemStack
     end
 
     no_commands do
+      # -e ENV, else GEMSTACK_ENV, else development.
+      def use_environment! = ENV["GEMSTACK_ENV"] = options[:environment] || ENV["GEMSTACK_ENV"] || "development"
+
       def generate_model(root, name, args)
         abort("Usage: gemstack generate model NAME field:type ...") unless name && !args.empty?
         spec = ResourceSpec.new(name, args)

data/templates/app/Gemfile.tt

@@ -38,7 +38,7 @@ gem "<%= driver_gem %>", "<%= driver_version %>" # the <%= database_adapter %> d
 # gem "stripe"
 
 group :development, :test do
-  gem "irb" # `gemstack console`; a bundled (not default) gem since Ruby 4.0
+  gem "irb" # `gemstack console` (a bundled gem, not a default one, in newer Rubies)
   gem "minitest", "~> 5.25"
   gem "rack-test", "~> 2.2"
 end

data/templates/app/config/app.rb.tt

@@ -12,19 +12,43 @@ Bundler.require(:default, GemStack.env.to_sym)
 GemStack.configure do |config|
   config.name = "<%= name %>"
 
-  # Everything below is optional — these are the defaults. See docs/configuration.md.
-  #
+  # Settings for every environment. Everything below is optional: each line
+  # shows the default — uncomment one to change it. Per-environment settings go
+  # in config/environments/*.rb. All settings: docs/configuration.md.
+
+  # ── HTTP ────────────────────────────────────────────────────────────────
   # config.http.api_path = "/api"                  # where the API lives (routes are relative to it)
   # config.http.max_body_size = 10 * 1024 * 1024   # bytes; larger requests get 413
   # config.http.json = :json                       # or :oj (add gem "oj"), or your own codec
   # config.http.cors.origins = []                  # only for frontends on another domain
   # config.http.middleware.use MyMiddleware        # add / insert_before / swap / delete
-  # config.logger.level = :debug
-  # config.filter_parameters += %w[iban]           # masked in logs
+
+  # ── Pagination: paginate(...) in controllers, ?page=2&per_page=50 (docs/pagination.md) ──
+  # config.http.pagination.per_page = 25           # records per page when the client doesn't say
+  # config.http.pagination.max_per_page = 100      # the most a client may ask for with ?per_page=
+
+  # ── Responses ───────────────────────────────────────────────────────────
+  # config.http.compression.enabled = true         # gzip/Brotli responses over 1 KB (add gem "brotli" for br)
+  # config.http.etags = true                       # ETag + 304 Not Modified for GET responses
+
+  # ── Logging ─────────────────────────────────────────────────────────────
+  # config.logger.level = :debug                   # :info in production (or GEMSTACK_LOG_LEVEL)
+  # config.filter_parameters += %w[iban]           # masked in logs, next to password, token, secret…
 <% if database? -%>
-  #
-  # Connection: config/database.yml (DATABASE_URL / TEST_DATABASE_URL override it).
+
+  # ── Database — the connection is in config/database.yml (DATABASE_URL overrides it) ──
   # config.db.pool_size = 5                        # default: GEMSTACK_MAX_THREADS (one per Puma thread)
   # config.db.statement_timeout = 5_000            # ms
 <% end -%>
+
+  # ── Cache (GemStack.cache) ──────────────────────────────────────────────
+  # config.cache.store = :memory                   # :redis to share it between processes (gem "redis-client")
+  # config.cache.default_expires_in = nil          # seconds; nil = until evicted
+
+  # ── Background jobs ─────────────────────────────────────────────────────
+  # config.jobs.default_queue = "default"
+  # config.jobs.default_max_attempts = 10          # then the job is kept as failed
+
+  # ── Mail ────────────────────────────────────────────────────────────────
+  # config.mail.default_from = "<%= name %> <no-reply@localhost>"   # or MAIL_FROM
 end

data/templates/app/dot_node-version.tt

@@ -0,0 +1 @@
+<%= node_version %>

data/templates/app/dot_nvmrc.tt

@@ -0,0 +1 @@
+<%= node_version %>

data/templates/app/dot_tool-versions.tt

@@ -1 +1,4 @@
 ruby <%= ruby_version %>
+<% if frontend? -%>
+nodejs <%= node_version %>
+<% end -%>

data/templates/resource/frontend/frontend/lib/queries/%url_segment%.ts.tt

@@ -11,10 +11,11 @@ export const <%= spec.variable %>Keys = {
 };
 <% if spec.action?(:index) -%>
 
-export function use<%= spec.plural_class %>(page = 1) {
+// perPage: records per page; omit it to use the API's default (config.http.pagination.per_page).
+export function use<%= spec.plural_class %>(page = 1, perPage?: number) {
   return useQuery({
-    queryKey: [...<%= spec.variable %>Keys.all, "page", page],
-    queryFn: () => <%= spec.client_name %>.list({ page }),
+    queryKey: [...<%= spec.variable %>Keys.all, "page", page, perPage],
+    queryFn: () => <%= spec.client_name %>.list({ page, per_page: perPage }),
     placeholderData: keepPreviousData, // keep the current page visible while the next one loads
   });
 }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gemstack-cli
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.4
 platform: ruby
 authors:
 - Adware Technologies
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.2
+        version: 0.2.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.2
+        version: 0.2.4
 - !ruby/object:Gem::Dependency
   name: gemstack-dev
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.2
+        version: 0.2.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.2
+        version: 0.2.4
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -99,6 +99,8 @@ files:
 - templates/app/db/seeds.rb
 - templates/app/dot_env.example.tt
 - templates/app/dot_gitignore
+- templates/app/dot_node-version.tt
+- templates/app/dot_nvmrc.tt
 - templates/app/dot_ruby-version.tt
 - templates/app/dot_tool-versions.tt
 - templates/app/test/health_test.rb
@@ -190,7 +192,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:
   - - ">="