active_mappers 1.5.3 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 231960e865a55f8f5326db64a3c27483074667ceadd949b7c5f92db45b9ba84c
-  data.tar.gz: 440609845994bf984c26bea417b0188f68ebd115e23188e0582bf97cdeafc488
+  metadata.gz: 43a75d246a1c97b9e8c31781bedf8e7893c58868b6dab6dce13aebf508d6b6a8
+  data.tar.gz: 569ee97b2c0db9f631012c7572e338df69795e86e0e7a5868b7867f7112ac38e
 SHA512:
-  metadata.gz: e0e40eb769230d7aef3712c760563148acde4f9a9e3f002225ffb6415562e36c84748a26a27649b6ac67b867b99d14f8ab1a090cd87ddcb763b29dc4c635bd90
-  data.tar.gz: 8a6dbf0fc2b7210c5cb9292420a3ec3c4d00bf666ef691f345a0423f030609b3e177ff97983bc7469500a7f1e72088bde0c7cd31e6408279e88256a4489e1ac1
+  metadata.gz: 22132e79ffeb517b0e163148972248bb4524e79d5e4a6827e0d91057410f7a463856613aff6a2932196a3ef09276c27aed963af6f0dcf428d4a2fb49560dc0da
+  data.tar.gz: eda34e0f9ec6a58a473abbfcfc9c4fcdc22f58b7b371327d56eabff76dd9c198600cc6e386b9b776f073a6358b621f68a71cc1cc77d62be218409580dd610a6d

data/README.md

@@ -316,6 +316,34 @@ end
 RewardMapper.with(reward, context: user)
 ```
 
+The context is **propagated to nested mappers**, both through `relation` and through
+`polymorphic`. A child mapper rendered as a relation therefore sees the same context as
+its parent, without having to walk back up the association:
+
+```ruby
+class TicketMapper < ActiveMappers::Base
+  relation :pictures, PictureMapper
+end
+
+class PictureMapper < ActiveMappers::Base
+  each do |picture, context|
+    { uri: picture.uri_for(context[:app]) }   # => 'scan_reduc'
+  end
+end
+
+TicketMapper.with(ticket, context: { app: 'scan_reduc' })
+```
+
+A context declared on the relation itself wins over the parent's — the parent's is only a
+default:
+
+```ruby
+relation :pictures, PictureMapper, context: { app: 'always_this_one' }
+```
+
+> Before 1.6.0, `relation` did not forward the context (`polymorphic` already did), so a
+> nested mapper always received `nil`.
+
 ### Scope
 
 ActiveMappers does not yet support inheritance. However we provide an even better alternative named `scope`.

data/active_mappers.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
   s.name        = 'active_mappers'
-  s.version     = '1.5.3'
-  s.date        = '2026-01-30'
+  s.version     = '1.6.0'
+  s.date        = '2026-09-25'
   s.summary     = 'Slick, fast view layer for you Rails API.'
   s.description = 'Fast, simple, declarative way to design your API\'s view layer'
   s.authors     = ['Michaël Villeneuve', 'Loïc SENCE']

data/lib/active_mappers.rb

@@ -3,6 +3,11 @@ require 'ruby2ruby'
 require 'ruby_parser'
 
 require 'active_support'
+# ⚠️ `blank?` / `present?` sont utilisés par `with` : dans une application Rails ils
+# arrivent par le require complet d'ActiveSupport, mais en test ISOLÉ la gem ne charge que
+# ce qu'elle déclare — sans cette ligne, toute la suite tombait en
+# `NoMethodError: undefined method 'present?'`.
+require 'active_support/core_ext/object/blank'
 require 'active_support/core_ext/object/try'
 require 'active_support/core_ext/hash/except'
 require 'active_support/core_ext/string/inflections'
@@ -46,9 +51,21 @@ module ActiveMappers
       end
     end
 
+    # ⚠️ Le bloc capture `context` et le passe au mapper enfant. Sans ça, un mapper rendu
+    # comme relation recevait toujours `nil` — alors que `polymorphic` le propageait déjà :
+    # l'enfant ne pouvait donc pas savoir pour qui on rendait (app appelante, scope…), et
+    # la seule parade était de remonter au parent par l'association.
+    #
+    # ⚠️ Le contexte est ajouté SOUS `options`, pas par-dessus : un `context:` passé
+    # explicitement à la déclaration (`relation :x, Mapper, context: {...}`) reste
+    # prioritaire, et celui du parent ne sert que de défaut.
+    #
+    # ⚠️ On MERGE au lieu d'écrire `options[:context] = context` : `options` est capturé par
+    # la closure et partagé par TOUS les rendus de ce mapper. Le muter ferait fuiter le
+    # contexte d'un rendu à l'autre entre threads.
     def self.relation(key, mapper = nil, **options)
       path = options[:optional_path] || key
-      each do |resource|
+      each do |resource, context|
         mapper_to_use = if mapper
           mapper
         else
@@ -59,16 +76,17 @@ module ActiveMappers
 
         raise "'#{mapper_to_use.name}' should be a mapper" unless mapper_to_use.ancestors.map(&:to_s).include?("ActiveMappers::Base")
 
-        { key => mapper_to_use.with(path.to_s.split('.').inject(resource, :try), default_options.merge(options)) }
+        { key => mapper_to_use.with(path.to_s.split('.').inject(resource, :try), { context: context }.merge(default_options.merge(options))) }
       end
     end
 
     def self.polymorphic(key, **options)
       each do |resource, context|
-        options[:context] = context
+        # Même merge non mutant que `relation` : `options[:context] = context` mutait le
+        # hash capturé par la closure, partagé par tous les rendus de ce mapper.
         if polymorphic_resource = resource.send("#{key}_type")
           resource_mapper = "#{KeyTransformer.base_namespace(self)}::#{polymorphic_resource}Mapper".constantize
-          { key => resource_mapper.with(resource.send(key), default_options.merge(options)) }
+          { key => resource_mapper.with(resource.send(key), { context: context }.merge(default_options.merge(options))) }
         else
           {}
         end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_mappers
 version: !ruby/object:Gem::Version
-  version: 1.5.3
+  version: 1.6.0
 platform: ruby
 authors:
 - Michaël Villeneuve
 - Loïc SENCE
 bindir: bin
 cert_chain: []
-date: 2026-01-30 00:00:00.000000000 Z
+date: 2026-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -115,7 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Slick, fast view layer for you Rails API.
 test_files: []