gemstack-cli 0.2.3 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b7ea1041a871d84d72d33529ee4b303145363665a6605d0cc5d533fd4604157
-  data.tar.gz: 02625e8747b1efe7fae2191d356376bc8bdde1500d892cef5f945badb1d5451d
+  metadata.gz: 4fece916078245099b1b1a2772b7e53645d7e2420dd1fe28703593beb5e99d6f
+  data.tar.gz: 5f4d02f6371f8d95e05a2d9b8b942a70c7806f0848970d8be8d023bc6fc26d72
 SHA512:
-  metadata.gz: 96aabfd8af652f60639dd4aa4b155351b654be18ff569a262520c1fec6a1d7f73a1f192c62b7dba551eb4bbdce86fc3e4ad1a00f100d4b4ad6ba51e5a3e56f21
-  data.tar.gz: 2efe2c5964c8a597efae119096f5293b635574b1b2db68b5be483a203d2d3228ec3ff87018f37865a5caf081b1efd7b97708b55d44465cba61bab223aed6d210
+  metadata.gz: f2c6ca47b6f4d6297d5d5a4e1ef7fe54013c479319de64f8db9ffec9a9ad6816c079d956979fbbe0c0fdef720234e3c0dabe3319702d852dfbe2949aa25c101a
+  data.tar.gz: fb4a50901dc646436500d6e934d9e0a51f9f211315740c887f147b476d96a3dd0f457993082b0b86c2ecafe4a7e19e5149ea8cc1b6a360423bb59eb55222ff5e

data/CHANGELOG.md

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

data/lib/gemstack/cli/app_generator.rb

@@ -35,7 +35,7 @@ module GemStack
       # 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.
+      # .nvmrc, .tool-versions).
       def ruby_version = RUBY_VERSION
       def node_version = @node_version ||= Dev::Toolchain.pinned_node_version
       def frontend? = !@options[:skip_frontend]

data/lib/gemstack/cli/deploy_generator.rb

@@ -4,7 +4,7 @@ module GemStack
   class CLI < Thor
     # `gemstack generate deploy` — Dockerfile (api + web targets), compose.yaml
     # (Postgres, migrations, API, jobs, Next.js, Caddy), Caddyfile, Procfile and
-    # .dockerignore (DECISIONS D-058). Nothing is deployed anywhere.
+    # .dockerignore. Nothing is deployed anywhere.
     class DeployGenerator < Generator
       def initialize(root:, output: $stdout, force: false)
         super(output: output, force: force)

data/lib/gemstack/cli/doctor.rb

@@ -7,7 +7,7 @@ require "gemstack/dev"
 module GemStack
   class CLI < Thor
     # `gemstack doctor` — checks that an application can run, and says how to
-    # fix what can't (DECISIONS D-057). Every check is independent: one
+    # fix what can't. Every check is independent: one
     # failure never hides the others. `--production` checks the settings a
     # deploy needs.
     class Doctor

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/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/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.3
+  version: 0.2.5
 platform: ruby
 authors:
 - Adware Technologies
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.3
+        version: 0.2.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.3
+        version: 0.2.5
 - !ruby/object:Gem::Dependency
   name: gemstack-dev
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.3
+        version: 0.2.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.3
+        version: 0.2.5
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement