zen-service 2.2.0 → 2.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12dcff33c206c08f710f8cedf505f663387054b22aa6429556b20c47eac6b410
-  data.tar.gz: b314175b5a9a5634480ac0c4fbec0777fa895e68687eedbaad8382f1b26600fe
+  metadata.gz: 207425486ecb408db660e845768e30e9cd19aa3ed1d6a7214d41fc0eecd46590
+  data.tar.gz: 74787fb37ce4bc2e6d7c139e7ca7b245c25fcafd6711a1aba434c0e681007b9b
 SHA512:
-  metadata.gz: 3bb64af64bf4641e01b686bf4b8bda93e5efcd8188d1ed6d1a864c74e0f2d916b03383345476c0aa1a860b3bae9ba6fbf370f6e309905d7ef5cb1186fd561b7d
-  data.tar.gz: b2678a54e99637e8d1706a6ccd913346d9e64d7ea0ef46e2c7e5637683844ab21220b6c1422601fc8466178358377e6da092cc0320cc5f6e427052b5e1b786f1
+  metadata.gz: 4bc0fe9454e82c5b49f9ab87e3812e002691002d1476b9258417fa12ddae5419ea3621de952c821b27716078e9008745acf02e00946a5538570dd89c3a020972
+  data.tar.gz: e26b152b882e1fc74ef35a99644bcc3b976c8710eb8c5833b5393edf0843f190006a019c157ba2958a082d03cedcf4c989fd2b6d5788c0bb27f36d0e9f63391f

data/.github/copilot-instructions.md

@@ -12,7 +12,8 @@ The entire gem is built around `Zen::Service::Plugins` - a dynamic plugin regist
 
 - Plugins auto-register using `extend Zen::Service::Plugins::Plugin` (converts module name to snake_case key)
 - Services use plugins via `use :plugin_name, **options`
-- Plugin lifecycle: `used(service_class)` → includes module → `configure(service_class)` if defined
+- Plugin lifecycle (first use): `used(service_class)` → includes module → `configure(service_class)` if defined
+- Plugin reconfiguration (ancestor already used): only `configure(service_class)` is called, module not re-included
 - See [plugin.rb](lib/zen/service/plugins/plugin.rb) for the DSL: `register_as`, `default_options`, `service_extension`
 
 ### Core Plugins Architecture
@@ -97,6 +98,13 @@ end
 - Use `default_options foo: 5` in plugin definition
 - Access via `self.class.plugins[:plugin_name].options[:foo]`
 - Options merge with defaults when using plugin
+- Blocks passed to `use` are stored in `reflection.block`, separate from options (not polluting options hash)
+
+### Plugin Inheritance & Reconfiguration
+
+- When a child class uses a plugin already used by an ancestor, only `configure` callback is invoked (not `used`)
+- This allows child classes to reconfigure plugin behavior without re-including the module
+- Example: `BaseService` uses `:persisted_result` with default options, `ChildService` can reconfigure with different options
 
 ### Inheritance Behavior
 

data/README.md

@@ -116,6 +116,26 @@ However, `zen-service` still provides a couple of helpfull plugins out-of-the-bo
     end
   ```
 
+#### Plugin Lifecycle
+
+When using a plugin on a service class:
+
+- If the plugin is used for the first time, both `used` and `configure` callbacks are invoked
+- If the plugin was already used by an ancestor class, only the `configure` callback is invoked,
+  allowing reconfiguration without re-including the module
+
+This design allows child classes to customize plugin behavior inherited from parent classes:
+
+```rb
+class BaseService < Zen::Service
+  use :persisted_result, call_unless_called: false
+end
+
+class ChildService < BaseService
+  use :persisted_result, call_unless_called: true  # Only reconfigures, doesn't re-include
+end
+```
+
 Bellow you can see sample implementation of a plugin that transforms resulting objects
 to camel-case notation (relying on ActiveSupport's core extensions)
 

data/lib/zen/service/plugins/pluggable.rb

@@ -3,7 +3,7 @@
 module Zen
   module Service::Plugins
     module Pluggable
-      Reflection = Struct.new(:extension, :options)
+      Reflection = Struct.new(:extension, :options, :block)
 
       def use(name, **opts, &block)
         extension = Service::Plugins.fetch(name)
@@ -11,7 +11,7 @@ module Zen
         defaults = extension.config[:default_options]
         opts = defaults.merge(opts) unless defaults.nil?
 
-        if service_plugins.key?(name)
+        if plugins.key?(name)
           extension.configure(self, **opts, &block) if extension.respond_to?(:configure)
           return extension
         end
@@ -45,7 +45,7 @@ module Zen
         extension.used(self, **opts, &block) if extension.respond_to?(:used)
         extension.configure(self, **opts, &block) if extension.respond_to?(:configure)
 
-        service_plugins[name] = Reflection.new(extension, opts.merge(block:))
+        service_plugins[name] = Reflection.new(extension, opts, block)
 
         extension
       end

data/lib/zen/service/version.rb

@@ -2,6 +2,6 @@
 
 module Zen
   class Service
-    VERSION = "2.2.0"
+    VERSION = "2.2.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zen-service
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.2.1
 platform: ruby
 authors:
 - Artem Kuzko
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-12-28 00:00:00.000000000 Z
+date: 2025-12-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry