view_component_reflex 0.2.4 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5ffa83358af12b225a6a5d4e7fc16a27275e1f2815b2f5e6105a555d7d3faa8
-  data.tar.gz: 2822a3c179dac3550eb1be5c7d30f997cd8942422429d2af92f167880652f28c
+  metadata.gz: 730dc20cb5c31f500fb8c6fd63c5e21286a4a3ea28f63a64aaa06c1640ef4844
+  data.tar.gz: 911b8665fd95a69b28de2bf366ffa9edb4240070c8e29c145090d27ba8eaf271
 SHA512:
-  metadata.gz: f85e4d51fef8d3ba242a48b9b8c3f5c800cbd746582c055d0cb68eba6b6309b2678362fd18b55fec103a1a26d08df728603304ccb5c2f7d0f9bca6c96ce24de6
-  data.tar.gz: 0a9624dff9b4127e59d28ecb0a574186dda9214f772cf332cd23aeca740ef8a3633ff0066d9c8e323fc4c612efb87e81fb9ac24c70aaaab3fc8ece07561bd243
+  metadata.gz: 679abeb33702936136cfc32244be5bd7ed85cbe8526594eb3f3ed8138b0aec7e004507eab5c4624fa0accd19958999a62641122dbfd67693ab9c3bf11424fd9f
+  data.tar.gz: 97f3b2645a43893d09a253c3d8c780ce1c141aab599c67db3fb6bd47ed443780960d831da6b10ff2930a1bdb0eb063ff667c5292b1c23f1e6eb9f1292f890c40

data/README.md

@@ -11,15 +11,19 @@ To add a reflex to your component, use the `reflex` method.
 ```ruby
     reflex :my_cool_reflex do
       # do stuff
+      refresh!
     end
 ```
 
 This will act as if you created a reflex with the method `my_cool_stuff`. To call this reflex, add `data-reflex="click->MyComponentReflex#my_cool_reflex"`, just like you're
 using stimulus reflex.
 
+#####note: A reflex will not automatically re-render the component upon its completion. A component will re-render whenever the `set_state` or `refresh!` method is called.
+
 In addition to calling reflexes, there is a rudimentary state system. You can initialize component-local state with `initialize_state(obj)`, where `obj` is a hash.
 
-You can access state with the `state` helper. See the code below for an example.
+You can access state with the `state` helper. See the code below for an example. Calling `set_state` will set the state, 
+and also re-render your component.
 
 If you're using state add `data-key="<%= key %>"` to any html element using a reflex. This 
 lets ViewComponentReflex keep track of which state belongs to which component.
@@ -36,7 +40,7 @@ lets ViewComponentReflex keep track of which state belongs to which component.
       end
     
       reflex :increment do
-        state[:count] = state[:count] + 1
+        set_state(count: state[:count] + 1)
       end
     end
 ```
@@ -49,6 +53,64 @@ lets ViewComponentReflex keep track of which state belongs to which component.
 </div>
 ```
 
+## Custom State Adapters
+
+ViewComponentReflex uses session for its state by default. To change this, add
+an initializer to `config/initializers/view_component_reflex.rb`.
+
+```ruby
+ViewComponentReflex.configure do |config|
+  config.state_adapter = YourAdapter
+end
+```
+
+`YourAdapter` should implement 
+
+```ruby
+class YourAdapter
+  ##
+  # request - a rails request object
+  # key - a unique string that identifies the component instance
+  def self.state(request, key)
+    # Return state for a given key
+  end
+
+  ##
+  # reflex - The reflex instance that's trying to set the state
+  # key - a unique string that identifies the component
+  # new_state - the new state to set
+  def self.set_state(reflex, key, new_state)
+  end
+
+
+  ##
+  # request - a rails request object
+  # key - a unique string that identifies the component instance
+  # new_state - a hash containing the component state
+  def self.store_state(request, key, new_state = {})
+    # store the state 
+    # this will be called twice, once with key, once with key_initial
+    # key_initial contains the initial, unmodified state.
+    # it should be used in reconcile_state to decide whether or not
+    # to re-initialize the state
+  end
+  
+  ##
+  # request - a rails request object
+  # key - a unique string that identifies the component instance
+  # new_state - a hash containing the component state
+  def self.reconcile_state(request, key, new_state)
+  # The passed state should always match the initial state of the component
+  # if it doesn't, we need to reset the state to the passed value.
+  #
+  # This handles cases where your initialize_state param computes some value that changes
+  # initialize_state({ transaction: @customer.transactions.first })
+  # if you delete the first transaction, that ^ is no longer valid. We need to update the state.
+  end
+end
+```
+
+
 ## Installation
 Add this line to your application's Gemfile:
 

data/app/components/view_component_reflex/component.rb

@@ -9,7 +9,33 @@ module ViewComponentReflex
         klass = self
         @stimulus_reflex ||= Object.const_set(name + "Reflex", Class.new(StimulusReflex::Reflex) {
           def state
-            session[element.dataset[:key]] ||= {}
+            ViewComponentReflex::Engine.state_adapter.state(request, element.dataset[:key])
+          end
+
+          def refresh!
+            @channel.send :render_page_and_broadcast_morph, self, ["[data-controller=\"#{stimulus_controller}\"]"], {
+              dataset: element.dataset.to_h,
+              args: [],
+              attrs: element.attributes.to_h,
+              selectors: ['body'],
+              target: "#{self.class.name}##{method_name}",
+              url: request.url,
+              permanentAttributeName: "data-reflex-permanent"
+            }
+          end
+
+          def set_state(new_state = {})
+            ViewComponentReflex::Engine.state_adapter.set_state(self, element.dataset[:key], new_state)
+            refresh!
+          end
+
+          before_reflex do |reflex, *args|
+            instance_exec(*args, &self.class.callbacks[self.method_name.to_sym]) if self.class.callbacks.include?(self.method_name.to_sym)
+            throw :abort
+          end
+
+          def self.callbacks
+            @callbacks ||= {}
           end
 
           define_method :stimulus_controller do
@@ -17,8 +43,8 @@ module ViewComponentReflex
           end
 
           define_singleton_method(:reflex) do |name, &blk|
+            callbacks[name] = blk
             define_method(name) do |*args|
-              instance_exec(*args, &blk)
             end
           end
         })
@@ -29,25 +55,29 @@ module ViewComponentReflex
       @state = obj
     end
 
+    def stimulus_reflex?
+      helpers.controller.instance_variable_get(:@stimulus_reflex)
+    end
+
     # key is required if you're using state
-    # We can't initialize the session state in the initiale method
+    # We can't initialize the session state in the initial method
     # because it doesn't have a view_context yet
     # This is the next best place to do it
     def key
       @key ||= caller.find { |p| p.include? ".html.erb" }&.hash.to_s
 
       # initialize session state
-      if session[@key].nil?
-        session[@key] = {}
-        (@state ||= {}).each do |key, v|
-          session[@key][key] = v
-        end
+      if !stimulus_reflex? || session[@key].nil?
+        ViewComponentReflex::Engine.state_adapter.store_state(request, @key, @state)
+        ViewComponentReflex::Engine.state_adapter.store_state(request, "#{@key}_initial", @state)
+      else
+        # ViewComponentReflex::Engine.state_adapter.reconcile_state(request, @key, @state)
       end
       @key
     end
 
     def state
-      session[key]
+      ViewComponentReflex::Engine.state_adapter.state(request, key)
     end
   end
 end

data/lib/view_component_reflex.rb

@@ -1,3 +1,4 @@
+require "view_component_reflex/state_adapter/session"
 require "view_component_reflex/engine"
 require 'stimulus_reflex'
 

data/lib/view_component_reflex/engine.rb

@@ -1,16 +1,13 @@
 module ViewComponentReflex
   class Engine < ::Rails::Engine
-    config.to_prepare do
-      class StimulusReflex::Channel < ActionCable::Channel::Base
-        def render_page_and_broadcast_morph(reflex, selectors, data = {})
-          html = render_page(reflex)
-          if reflex.respond_to? :stimulus_controller
-            selectors = ["[data-controller=\"#{reflex.stimulus_controller}\"]"]
-          end
-          broadcast_morphs selectors, data, html if html.present?
-        end
-      end
+    class << self
+      mattr_accessor :state_adapter
 
+      self.state_adapter = StateAdapter::Session
+    end
+
+    def self.configure
+      yield self if block_given?
     end
   end
 end

data/lib/view_component_reflex/state_adapter/session.rb

@@ -0,0 +1,38 @@
+module ViewComponentReflex
+  module StateAdapter
+    class Session
+      def self.state(request, key)
+        request.session[key] ||= {}
+      end
+
+      def self.set_state(reflex, key, new_state)
+        new_state.each do |k, v|
+          state(reflex.request, key)[k] = v
+        end
+        store = reflex.request.session.instance_variable_get("@by")
+        store.commit_session reflex.request, reflex.controller.response
+      end
+
+      def self.store_state(request, key, new_state = {})
+        request.session[key] = {}
+        new_state.each do |k, v|
+          request.session[key][k] = v
+        end
+      end
+
+      # The passed state should always match the initial state of the component
+      # if it doesn't, we need to reset the state to the passed value.
+      #
+      # This handles cases where your initialize_state param computes some value that changes
+      # initialize_state({ transaction: @customer.transactions.first })
+      # if you delete the first transaction, that ^ is no longer valid. We need to update the state.
+      def self.reconcile_state(request, key, new_state)
+        request.session["#{key}_initial"].each do |k, v|
+          if new_state[k] != v
+            request.session[key][k] = new_state[k]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/view_component_reflex/version.rb

@@ -1,3 +1,3 @@
 module ViewComponentReflex
-  VERSION = '0.2.4'
+  VERSION = '0.5.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: view_component_reflex
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.5.1
 platform: ruby
 authors:
 - Joshua LeBlanc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-04 00:00:00.000000000 Z
+date: 2020-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -71,6 +71,7 @@ files:
 - app/components/view_component_reflex/component.rb
 - lib/view_component_reflex.rb
 - lib/view_component_reflex/engine.rb
+- lib/view_component_reflex/state_adapter/session.rb
 - lib/view_component_reflex/version.rb
 homepage: https://github.com/joshleblanc/view_component_reflex
 licenses: