railpack 1.2.12 → 1.2.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21ff002773c07ac74af2a193632392fd1530c3ff81c1fcc4e98fc6aee54c685a
-  data.tar.gz: a1e8080cb6ad3b1e0ec5918212c0f412cb44e8a2d510848b5e400e11e35e3d8a
+  metadata.gz: 180f2842cd9e28804b7e3a2e4c3bead7d59d96f1a94dba1a376afb2c00ccbe87
+  data.tar.gz: e6f59e92f1e7b71532cc3419a8453c967f5805f5fc09d61e5f6f9bee095d2bb5
 SHA512:
-  metadata.gz: 3b1167de6777d81b2ba4d1818ad323eba5310fc32e0cf592f777db16a9d276c75451a6c2e372570e2d367e8fabb91055efe68e356d68932f6074c72ef535e47d
-  data.tar.gz: 07f6a5a9438f11a53cf552c4bdc302a9be6a83938d595d416a3051ec4c2398ca2569ad9c9882413acfb1aa165581a7c872a4cdb90a5c57fc523079732fc1750f
+  metadata.gz: 00dfe7f2f5b0dc5ab4223353d31cc5e72ddc2017276a64b45d2da375f779db1a3ffccd7060a5bb2a6150a9b7f16ef9fade80b7d765bb5df417902fa90db6a7b5
+  data.tar.gz: 16eac4d8a85abd5ba9302adfc41c1f0a2c6e1ddad6a13cd955eb883e4f9f7d6b44d112094c6736045e2b4d7e59ea23414b271337cc4762f0b6e40bf8d5aa3303

data/lib/railpack/config.rb

@@ -1,6 +1,24 @@
 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
 
@@ -41,11 +59,21 @@ module Railpack
         # Merge: default <- bundler <- environment
         merged = 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)
       # Look directly in config to avoid circular dependency
       env_config = @config[env.to_s] || {}
@@ -65,6 +93,8 @@ module Railpack
         raise Error, "Config is immutable. Set values in config/railpack.yml"
       else
         # Getter - read from merged config (backward compatibility)
+        # TODO: In v2.0, remove this fallback and require explicit accessors
+        warn "DEPRECATED: Dynamic config access via '#{config_key}' will be removed in v2.0. Use explicit accessors instead." if defined?(Rails) && Rails.logger
         env = args.first || current_env
         return for_environment(env)[config_key] if for_environment(env).key?(config_key)
         super
@@ -179,6 +209,26 @@ module Railpack
       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

data/lib/railpack/version.rb

@@ -1,3 +1,3 @@
 module Railpack
-  VERSION = "1.2.12"
+  VERSION = "1.2.14"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: railpack
 version: !ruby/object:Gem::Version
-  version: 1.2.12
+  version: 1.2.14
 platform: ruby
 authors:
 - 21tycoons LLC