debounced 1.0.8 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 221e144d2900e1237f3f06e9b9ef347eb2703f7c3b5d33242272ab5d1115c582
-  data.tar.gz: 7757b7afd63ade6894f5dd62ac9a2855197f0ba14229bed563e3d4a3662ad2d1
+  metadata.gz: 23ca0ee42ff088cb85dd495dc84f5cffb38b2a6af402bab7b23424f962e8f002
+  data.tar.gz: 0e218d90fb5ad2d908cd20d3557dd6bf4aa7267f9461810c34d9f30b3c62d0ae
 SHA512:
-  metadata.gz: f1e65faa3339ae66dce491120890d923213b8bbe49048525fc70ea022f6040ca9f2ab1fc78d28aa2905d0044bf8c78cffeb9811a6bfab6d01172334eb9273a0a
-  data.tar.gz: 53c8676a30eba9f9ed493055e00a0fe9d72f760240626cc999c185d6ab57a3d2823cacc64da1d885b92425862b2e86a342934ef6ba185e109631601af05fb1ad
+  metadata.gz: 2f16ed706132085f5109692d233544893edb540b1500a498f5597caef5fa856e8e1bdc06c3eae9a46251e8104537908f7b7f24aca8356c16331465fd1c2de250
+  data.tar.gz: '02438414f936b2d72c5dd185288892a9e12501e734977ae3d2103ca458c22e628c8ff83ea809f68c3c21084888ebc2fd2a7c5a1752fd42d9bdba5ab29feb7444'

data/lib/debounced/callback.rb

@@ -3,50 +3,77 @@ module Debounced
   ###
   # Represents a callback to be executed by the debounce service
   class Callback
-    attr_accessor :class_name, :method_name, :args, :kwargs
+    attr_accessor :class_name, :method_name, :args, :kwargs, :method_args, :method_kwargs
 
     ###
     # @param [String] class_name the name of the class that will receive the callback
     # @param [String] method_name the name of the method that will be called
-    # @param [Array] args the positional arguments to be passed to the method (optional)
-    # @param [Hash] kwargs the keyword arguments to be passed to the method (optional)
+    # @param [Array] args positional arguments passed to the static method, or to the initializer for instance methods (optional)
+    # @param [Hash] kwargs keyword arguments passed to the static method, or to the initializer for instance methods (optional)
+    # @param [Array] method_args positional arguments passed to the instance method (optional, ignored for static methods)
+    # @param [Hash] method_kwargs keyword arguments passed to the instance method (optional, ignored for static methods)
     #
-    # @note if the class implements the method_name, the message will be sent to the class with the args and kwargs.
-    # otherwise, an instance of the class will be created and the message will be sent to the instance. in this case,
-    # the args and kwargs will be passed to the initializer.
-    def initialize(class_name:, method_name:, args: [], kwargs: {})
+    # @note if the class implements the method_name as a class method, the message will be sent to the class with args and kwargs.
+    # otherwise, an instance of the class will be created using args and kwargs, and the message will be sent to the instance
+    # with method_args and method_kwargs.
+    #
+    # @note args and kwargs values must be JSON-native types (String, Numeric, Boolean, Array, Hash, nil).
+    # Symbol values, Date, Time, and other Ruby-specific types will not survive JSON round-trip serialization
+    # through the debounce server. Hash keys are deep-symbolized on parse, but values are preserved as-is.
+    def initialize(class_name:, method_name:, args: [], kwargs: {}, method_args: [], method_kwargs: {})
       @class_name = class_name.to_s
       @method_name = method_name.to_s
       @args = args
       @kwargs = kwargs
+      @method_args = method_args
+      @method_kwargs = method_kwargs
     end
 
     def self.parse(data)
       new(
         class_name: data['class_name'],
         method_name: data['method_name'],
-        args: data['args'],
-        kwargs: data['kwargs'].transform_keys(&:to_sym),
+        args: data['args'] || [],
+        kwargs: deep_symbolize_keys(data['kwargs'] || {}),
+        method_args: data['method_args'] || [],
+        method_kwargs: deep_symbolize_keys(data['method_kwargs'] || {}),
       )
     end
 
+    def self.deep_symbolize_keys(object)
+      case object
+      when Hash
+        object.to_h { |key, value| [key.to_sym, deep_symbolize_keys(value)] }
+      when Array
+        object.map { |item| deep_symbolize_keys(item) }
+      else
+        object
+      end
+    end
+    private_class_method :deep_symbolize_keys
+
     def as_json
       {
         class_name:,
         method_name:,
         args:,
         kwargs:,
+        method_args:,
+        method_kwargs:,
       }
     end
 
     def call
       Debounced.configuration.logger.debug("Invoking callback #{method_name}")
       klass = Object.const_get(class_name)
+      unless klass.ancestors.include?(Debounced::Callbackable)
+        raise ArgumentError, "#{class_name} is not an allowed Debounced callback target. Include Debounced::Callbackable in the class."
+      end
       if klass.respond_to?(method_name)
         klass.send(method_name, *args, **kwargs)
       else
         instance = klass.new(*args, **kwargs)
-        instance.send(method_name)
+        instance.send(method_name, *method_args, **method_kwargs)
       end
     rescue StandardError => e
       Debounced.configuration.logger.warn("Unable to invoke callback #{as_json}: #{e.message}")

data/lib/debounced/callbackable.rb

@@ -0,0 +1,4 @@
+module Debounced
+  module Callbackable
+  end
+end

data/lib/debounced/version.rb

@@ -1,3 +1,3 @@
 module Debounced
-  VERSION = "1.0.8"
+  VERSION = "2.0.0"
 end

data/lib/debounced.rb

@@ -3,6 +3,7 @@ require 'debounced/railtie' if defined?(Rails)
 require 'debounced/no_server_error'
 require 'debounced/socket_conflict_error'
 require 'debounced/service_proxy'
+require 'debounced/callbackable'
 require 'debounced/callback'
 require 'semantic_logger'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: debounced
 version: !ruby/object:Gem::Version
-  version: 1.0.8
+  version: 2.0.0
 platform: ruby
 authors:
 - Gary Passero
@@ -96,6 +96,7 @@ files:
 - README.md
 - lib/debounced.rb
 - lib/debounced/callback.rb
+- lib/debounced/callbackable.rb
 - lib/debounced/javascript/server.mjs
 - lib/debounced/javascript/service.mjs
 - lib/debounced/no_server_error.rb
@@ -117,14 +118,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Efficient event debouncing in Ruby
 test_files: []