standard_id 0.51.2 → 0.52.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18c7955706f1fbe444d4bd7db052f615acfb01d7310f1a9c7088717017b864c5
-  data.tar.gz: 65435d9e1d57e2bfcbd479b5ecd81353d2961f831ad3f53db911bf830d20d89e
+  metadata.gz: d91a49478fd5f477e7a20395c4c2f5b142b3bd813e96145af349143935a96482
+  data.tar.gz: 00d708402823a344e451032db69e6097c62ecc77d80ce66d4d1d68b24fed478a
 SHA512:
-  metadata.gz: ec9734a8609d74823eb5b5a1b7b395d28f11c38268a19ff305618145777543ac13a5671c54f66cf2ecae5f68a9924e54dfeed495726dbc554f591d7f52f07078
-  data.tar.gz: 8616544546bd160e81490b665f40e5d4b64b03b2a612128efe896c4aacea446dbd240a8518e9d9c9a1e8bed1ef491421a406deb22ccfc52bd73f03fc6dab6a8e
+  metadata.gz: 101b91f61aa5d72e333322c21c0fbe160105a9adda2bc851046ea625400e4fcda61cbc6131fdcefd8f6c7927f54f1308834be383e2d4fec1d83110276a3b9087
+  data.tar.gz: 853ef8ee5ea04b8feb98c1343025b692c8c41d9a597c3e2ae82bf31c32e16f03d810375849d0d04e5412ff96966643bdaf8529fdddeb3f30cca7f73d32edb282

data/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.52.0] - 2026-10-22
+
+### Added
+
+- **`c.preset :inertia_web`.** Applies the settings an Inertia app with
+  passwordless or social sign-in flips: `use_inertia` and `alias_current_user`
+  true; `web.signup`, `web.password_login` and `web.password_reset` false;
+  `oauth.discovery_endpoint_base = :request`. Four of the five estate apps set
+  exactly this by hand. A preset fills only settings the host has not assigned
+  (via `Scope#assigned?`), so explicit assignments win in either order; an
+  unknown name raises `ArgumentError`. The public defaults are unchanged.
+  Presets live in `StandardId::Config::Presets`.
+
 ## [0.51.2] - 2026-10-21
 
 ### Fixed

data/README.md

@@ -629,6 +629,23 @@ StandardId.configure do |config|
 end
 ```
 
+   Or start from the `:inertia_web` preset, which bundles the settings an
+   Inertia app with passwordless or social sign-in usually flips:
+
+```ruby
+StandardId.configure do |config|
+  config.preset :inertia_web
+  # use_inertia = true, alias_current_user = true,
+  # web.signup / web.password_login / web.password_reset = false,
+  # oauth.discovery_endpoint_base = :request
+  config.web.passwordless_login = true # not part of the preset: your call
+end
+```
+
+   A preset fills only the settings you haven't assigned, so an explicit
+   assignment wins whether it comes before or after `preset`. An unknown name
+   raises `ArgumentError`. The public defaults are unchanged.
+
 3. Create the corresponding frontend components. The component path follows the pattern:
    `{namespace}/{ControllerName}/{action}`
 

data/lib/generators/standard_id/install/templates/standard_id.rb

@@ -5,6 +5,13 @@
 # Commented-out lines show defaults; uncomment and edit to override.
 
 StandardId.configure do |c|
+  # An Inertia app whose users sign in passwordlessly or socially can start
+  # from a preset instead of setting each option below. :inertia_web sets
+  # use_inertia, alias_current_user, web.signup/password_login/password_reset
+  # = false and oauth.discovery_endpoint_base = :request. Anything you assign
+  # yourself wins, before or after this line.
+  # c.preset :inertia_web
+
   # ---------------------------------------------------------------------------
   # Required
   # ---------------------------------------------------------------------------

data/lib/standard_id/config/presets.rb

@@ -0,0 +1,45 @@
+module StandardId
+  module Config
+    # Named bundles of settings, applied with `c.preset :name`.
+    #
+    # The public defaults suit a classic server-rendered app with password
+    # sign-up. Apps built the other way round (Inertia pages, passwordless or
+    # social sign-in, ApiEngine under a path prefix) flip the same handful of
+    # settings, so a preset names that bundle instead of changing the defaults
+    # for everyone else.
+    #
+    # A preset fills only settings the host has not assigned, so an explicit
+    # `c.web.signup = true` wins whether it comes before or after the preset.
+    module Presets
+      PRESETS = {
+        # Inertia-rendered web surface with no password sign-up, login or
+        # reset (sign-in is passwordless or social; which of those is on stays
+        # the host's call), and discovery endpoints built from the request so
+        # an ApiEngine mounted under a prefix advertises the right URLs.
+        inertia_web: {
+          base: { use_inertia: true, alias_current_user: true },
+          web: { signup: false, password_login: false, password_reset: false },
+          oauth: { discovery_endpoint_base: :request }
+        }
+      }.freeze
+
+      module_function
+
+      # @param config [StandardId::ConfigSchema::Config]
+      # @param name [Symbol, String]
+      # @raise [ArgumentError] for an unknown preset name
+      # @return [config]
+      def apply(config, name)
+        settings = PRESETS.fetch(name.to_sym) do
+          raise ArgumentError, "Unknown StandardId config preset: #{name.inspect}. Valid presets: #{PRESETS.keys.map(&:inspect).join(", ")}"
+        end
+
+        settings.each do |scope_name, values|
+          scope = config[scope_name]
+          values.each { |key, value| scope[key] = value unless scope.assigned?(key) }
+        end
+        config
+      end
+    end
+  end
+end

data/lib/standard_id/config_schema.rb

@@ -266,6 +266,16 @@ module StandardId
 
       def registered?(scope_name) = !!self[scope_name.to_sym]&.resolver
 
+      # Applies a named settings bundle (StandardId::Config::Presets). Only
+      # settings the host has not assigned are filled, so explicit
+      # assignments win in either order.
+      #
+      #   StandardId.configure do |c|
+      #     c.preset :inertia_web
+      #     c.web.passwordless_login = true
+      #   end
+      def preset(name) = StandardId::Config::Presets.apply(self, name)
+
       def [](key)
         sym = key.to_sym
         return super if key?(sym) || __schema__.nil? || __schema__.scope?(sym)

data/lib/standard_id/version.rb

@@ -1,3 +1,3 @@
 module StandardId
-  VERSION = "0.51.2"
+  VERSION = "0.52.0"
 end

data/lib/standard_id.rb

@@ -7,6 +7,7 @@ require "standard_id/web_engine"
 require "standard_id/api_engine"
 require "standard_id/config_schema"
 require "standard_id/config/schema"
+require "standard_id/config/presets"
 require "standard_id/scope_config"
 require "standard_id/association_strict_loading"
 require "standard_id/migration_check"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: standard_id
 version: !ruby/object:Gem::Version
-  version: 0.51.2
+  version: 0.52.0
 platform: ruby
 authors:
 - Jaryl Sim
@@ -259,6 +259,7 @@ files:
 - lib/standard_id/bearer_token_extraction.rb
 - lib/standard_id/checks/migrations.rb
 - lib/standard_id/config/callable_validator.rb
+- lib/standard_id/config/presets.rb
 - lib/standard_id/config/schema.rb
 - lib/standard_id/config/scope_claims_validator.rb
 - lib/standard_id/config_schema.rb