hanami-action 3.0.0 → 3.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cfd2248b12d546b250ad80e1c7115aa23dbcfab93eb7620dca331a4939af34f0
-  data.tar.gz: aa6a3f85fe8328a8e5d796be22b9d802cff6f74d643a8f1189f8cef89aafc3d8
+  metadata.gz: 8ca2d8098c5bfeaaf4d1422c04eb56980cda8bc806b03f327f4ecf19d82a7ff3
+  data.tar.gz: f9f4e24aa1bac023962e562b1dcba5c232dfa3c7dc74610c983108b3f7eaa0f7
 SHA512:
-  metadata.gz: 687db93c36b074e4015349842759091cbbb7fb35dda5f30ca1097cc629a1ee48767a2e3740ae54df491b4aee33e315b81e3e0e09a07b0fc0c37995f44c422a4f
-  data.tar.gz: 29676466bb1d6aba7f7724aadc8c4bdc80f04d7c02bcb11414ad507e09fb623e628b75a23892b7fc10876a8141c180e49443cd503f61c26122196b7e89731088
+  metadata.gz: 5377fc1b6c6cf1c5b1be0832ba55e388cf47d8ad07dc3e4a594a506a080c32e641f1cd01685a370b9a9dbab61143e6ecac8b96646ccb77c821da57e43e9e8478
+  data.tar.gz: 50b96bbc3419ca3727708944e4f7d5e35b8de9d81ecb340ada4162c72d15114b3330cc22f03990f73bb3e4757f16b25283c93b7b48a43906baa2000de6859c37

data/CHANGELOG.md

@@ -9,8 +9,12 @@ and this project adheres to [Break Versioning](https://www.taoensso.com/break-ve
 
 ### Added
 
+- Support additional `Cache-Control` directives in `response.cache_control`: `:immutable`, `:must_understand`, `stale_while_revalidate:` (requires a duration) and `stale_if_error:` (requires a duration). (@timriley in #522)
+
 ### Changed
 
+- `response.cache_control` raises `ArgumentError` for unknown directives instead of silently dropping them. (@timriley in #522)
+
 ### Deprecated
 
 ### Removed
@@ -19,7 +23,21 @@ and this project adheres to [Break Versioning](https://www.taoensso.com/break-ve
 
 ### Security
 
-[Unreleased]: https://github.com/hanami/hanami-action/compare/v3.0.0...HEAD
+[Unreleased]: https://github.com/hanami/hanami-action/compare/v3.0.1...HEAD
+
+## [3.0.1] - 2026-07-03
+
+Adding an improvement that was originally intended for 3.0.0.
+
+### Added
+
+- Support additional `Cache-Control` directives in `response.cache_control`: `:immutable`, `:must_understand`, `stale_while_revalidate:` (requires a duration) and `stale_if_error:` (requires a duration). (@timriley in #522)
+
+### Changed
+
+- `response.cache_control` raises `ArgumentError` for unknown directives instead of silently dropping them. (@timriley in #522)
+
+[3.0.1]: https://github.com/hanami/hanami-action/compare/v3.0.0...v3.0.1
 
 ## [3.0.0] - 2026-06-30
 

data/lib/hanami/action/cache/directives.rb

@@ -7,13 +7,30 @@ module Hanami
       #
       # @since 0.3.0
       # @api private
-      VALUE_DIRECTIVES      = %i[max_age s_maxage min_fresh max_stale].freeze
+      VALUE_DIRECTIVES = %i[
+        max_age
+        max_stale
+        min_fresh
+        s_maxage
+        stale_if_error
+        stale_while_revalidate
+      ].freeze
 
       # Cache-Control directives which are implicitly true
       #
       # @since 0.3.0
       # @api private
-      NON_VALUE_DIRECTIVES  = %i[public private no_cache no_store no_transform must_revalidate proxy_revalidate].freeze
+      NON_VALUE_DIRECTIVES = %i[
+        immutable
+        must_revalidate
+        must_understand
+        no_cache
+        no_store
+        no_transform
+        private
+        proxy_revalidate
+        public
+      ].freeze
 
       # Class representing value directives
       #
@@ -41,7 +58,7 @@ module Hanami
         # @since 0.3.0
         # @api private
         def valid?
-          VALUE_DIRECTIVES.include? @name
+          VALUE_DIRECTIVES.include?(@name)
         end
       end
 
@@ -71,7 +88,7 @@ module Hanami
         # @since 0.3.0
         # @api private
         def valid?
-          NON_VALUE_DIRECTIVES.include? @name
+          NON_VALUE_DIRECTIVES.include?(@name)
         end
       end
 
@@ -104,7 +121,11 @@ module Hanami
         # @since 0.3.0
         # @api private
         def <<(directive)
-          @directives << directive if directive.valid?
+          unless directive.valid?
+            raise ArgumentError.new("Unknown cache control directive: #{directive.name.inspect}")
+          end
+
+          @directives << directive
         end
 
         # @since 0.3.0

data/lib/hanami/action/response.rb

@@ -332,12 +332,17 @@ module Hanami
 
       # Specifies the response freshness policy for HTTP caches using the `Cache-Control` header.
       #
-      # Any number of non-value directives (`:public`, `:private`, `:no_cache`, `:no_store`,
-      # `:must_revalidate`, `:proxy_revalidate`) may be passed along with a Hash of value directives
-      # (`:max_age`, `:min_stale`, `:s_max_age`).
+      # Directives come in two forms:
       #
-      # See [RFC 2616 / 14.9](http://tools.ietf.org/html/rfc2616#section-14.9.1) for more on
-      # standard cache control directives.
+      # - Non-value directives (such as `:public` or `:no_store`) are passed as bare symbols.
+      # - Value directives (such as `max_age:` or `s_maxage:`) are passed as a trailing Hash.
+      #
+      # See the `@option` entries below for the full set of supported directives. Passing an unknown
+      # directive raises an `ArgumentError`.
+      #
+      # See [MDN's Cache-Control reference][mdn] for more on the standard cache control directives.
+      #
+      # [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control
       #
       # @example
       #   # Set Cache-Control directives
@@ -349,15 +354,21 @@ module Hanami
       #   response.get_header("Cache-Control") # => "private, no-store, max-age=900"
       #
       # @param values [Array<Symbol, Hash>] values to map to `Cache-Control` directives
-      # @option values [Symbol] :public
-      # @option values [Symbol] :private
+      # @option values [Symbol] :immutable
+      # @option values [Symbol] :must_revalidate
+      # @option values [Symbol] :must_understand
       # @option values [Symbol] :no_cache
       # @option values [Symbol] :no_store
-      # @option values [Symbol] :must_validate
+      # @option values [Symbol] :no_transform
+      # @option values [Symbol] :private
       # @option values [Symbol] :proxy_revalidate
+      # @option values [Symbol] :public
       # @option values [Hash] :max_age
-      # @option values [Hash] :min_stale
-      # @option values [Hash] :s_max_age
+      # @option values [Hash] :max_stale
+      # @option values [Hash] :min_fresh
+      # @option values [Hash] :s_maxage
+      # @option values [Hash] :stale_if_error
+      # @option values [Hash] :stale_while_revalidate
       #
       # @return void
       #

data/lib/hanami/action/version.rb

@@ -8,6 +8,6 @@ module Hanami
     #
     # @since 3.0.0
     # @api public
-    VERSION = "3.0.0"
+    VERSION = "3.0.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hanami-action
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.0.1
 platform: ruby
 authors:
 - Hanakai team