railpack 1.2.11 → 1.2.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2255e81346b6fe1ed60e139f49f747e24c13589cc70771e39e2ede97780b081
-  data.tar.gz: 0065d985425006c7f084214bbaa7c44d1423367c95e47bb879f02b21a9274fce
+  metadata.gz: 7d46c8ec7498a0fb02c689c31efebb07356d887ceb4f2c71b37bc1df4fbf88c2
+  data.tar.gz: 2c72739906a7b8639929cf79262d5da8df504449e33c7b9aee6a49af25058550
 SHA512:
-  metadata.gz: 37f8ef74dce0b9d689f95f20c49ed7b997e90e5aa8dbe657652bb8e1a4cb5bd709cf2acc53cfb199bb042443d1992a80605a19cf9d74be1ab96a8cc41e6b55ca
-  data.tar.gz: bc795780c31ab2b7e815eaf4e878c9f3ac4d222a88df601422420b6ef73de3c21a47eb07a6ba2cdae5f46cd218ba25445adbaa95b978b4e024cec9d97bef2f97
+  metadata.gz: 95345502072a45a61e3e1b4524c9a49958a7d67c9f99164ddf9e57cefb3fd7beebefcc38e2fd8869bf080151f37003a267a2e92998b9681ef6794b7ed6f5559d
+  data.tar.gz: c5a2e13d273eb5a3c765fa02cc0287b35a5600af8723564bef78caa571a5ff34e7cd690d56b61a5695264881fb0c538858088e7fc46e86a8561ad32415044431

data/lib/railpack/config.rb

@@ -1,13 +1,38 @@
 require "yaml"
 
 module Railpack
+  # Configuration handler for Railpack bundling settings.
+  #
+  # This class provides immutable, environment-aware configuration management with:
+  # - YAML-based config loading from config/railpack.yml
+  # - Three-level merge order: defaults → bundler-specific → environment-specific
+  # - Deep-frozen configs for immutability and thread safety
+  # - Explicit accessors for common config keys with method_missing fallback
+  #
+  # Example config/railpack.yml:
+  #   default:
+  #     bundler: bun
+  #     outdir: app/assets/builds
+  #   development:
+  #     sourcemap: true
+  #   production:
+  #     minify: true
+  #
+  # All configs are immutable after loading. Set values in config/railpack.yml only.
   class Config
     class Error < StandardError; end
 
+    # Known config keys that get explicit accessors
+    CONFIG_KEYS = %w[
+      target format minify sourcemap splitting
+      entrypoint entrypoints outdir platform mode analyze_bundle
+    ].freeze
+
     attr_reader :config
 
     def initialize
       @config = load_config
+      @merged_cache = {}
     end
 
     def current_env
@@ -18,13 +43,35 @@ module Railpack
       end
     end
 
+    # Explicit accessors for known config keys
+    CONFIG_KEYS.each do |key|
+      define_method(key) do |env = current_env|
+        for_environment(env)[key]
+      end
+    end
+
     def for_environment(env = current_env)
-      base_config = @config["default"] || {}
-      bundler_config = bundler_config(env)
-      env_config = @config[env.to_s] || {}
+      @merged_cache[env.to_s] ||= begin
+        base_config = @config["default"] || {}
+        bundler_config = bundler_config(env)
+        env_config = @config[env.to_s] || {}
+
+        # Merge: default <- bundler <- environment
+        merged = deep_merge(deep_merge(base_config, bundler_config), env_config)
 
-      # Merge: default <- bundler <- environment
-      deep_merge(deep_merge(base_config, bundler_config), env_config)
+        # Validate critical config values
+        validate_config!(merged, env)
+
+        # Deep freeze for immutability
+        deep_freeze(merged)
+      end
+    end
+
+    # Reload configuration (useful for development/testing)
+    def reload!
+      @config = load_config
+      @merged_cache.clear
+      self
     end
 
     def bundler(env = current_env)
@@ -42,12 +89,10 @@ module Railpack
     def method_missing(method, *args)
       config_key = method.to_s
       if method.end_with?('=')
-        # Setter - allow initializer to override config
-        key = config_key.chomp('=')
-        @config[current_env.to_s] ||= {}
-        @config[current_env.to_s][key] = args.first
+        # Setter - no longer allowed, config is immutable
+        raise Error, "Config is immutable. Set values in config/railpack.yml"
       else
-        # Getter - read from merged config
+        # Getter - read from merged config (backward compatibility)
         env = args.first || current_env
         return for_environment(env)[config_key] if for_environment(env).key?(config_key)
         super
@@ -105,7 +150,7 @@ module Railpack
 
     def load_config
       if config_path.exist?
-        YAML.safe_load(File.read(config_path), aliases: true)
+        YAML.safe_load(File.read(config_path), permitted_classes: [], aliases: false)
       else
         default_config
       end
@@ -161,5 +206,36 @@ module Railpack
         end
       end
     end
+
+    def validate_config!(config, env)
+      # Validate critical config values in production
+      if env.to_s == 'production'
+        if config['outdir'].nil? || config['outdir'].to_s.empty?
+          raise Error, "Production config must specify 'outdir'"
+        end
+
+        bundler_name = config['bundler']
+        if bundler_name.nil? || bundler_name.to_s.empty?
+          raise Error, "Production config must specify 'bundler'"
+        end
+      end
+
+      # Validate bundler name exists in known bundlers
+      bundler_name = config['bundler']
+      if bundler_name && !@config.key?(bundler_name)
+        warn "Warning: Unknown bundler '#{bundler_name}'. Known bundlers: #{@config.keys.grep(/^(bun|esbuild|rollup|webpack)$/).join(', ')}"
+      end
+    end
+
+    def deep_freeze(object)
+      case object
+      when Hash
+        object.each_value { |v| deep_freeze(v) }.freeze
+      when Array
+        object.each { |v| deep_freeze(v) }.freeze
+      else
+        object.freeze
+      end
+    end
   end
 end

data/lib/railpack/version.rb

@@ -1,3 +1,3 @@
 module Railpack
-  VERSION = "1.2.11"
+  VERSION = "1.2.13"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: railpack
 version: !ruby/object:Gem::Version
-  version: 1.2.11
+  version: 1.2.13
 platform: ruby
 authors:
 - 21tycoons LLC
 bindir: exe
 cert_chain: []
-date: 2026-01-26 00:00:00.000000000 Z
+date: 2026-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -47,7 +47,6 @@ files:
 - lib/railpack/manager.rb
 - lib/railpack/version.rb
 - lib/tasks/railpack.rake
-- sig/railpack.rbs
 - test/bundler_test.rb
 - test/config_test.rb
 - test/manager_test.rb

data/sig/railpack.rbs

@@ -1,4 +0,0 @@
-module Railpack
-  VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-end