stimulus_reflex 3.4.0.pre5 → 3.4.0

data/lib/generators/stimulus_reflex/templates/app/javascript/controllers/application_controller.js.tt

@@ -39,14 +39,22 @@ export default class extends Controller {
   }
 
   reflexSuccess (element, reflex, noop, reflexId) {
-    // show success message etc...
+    // show success message
   }
 
   reflexError (element, reflex, error, reflexId) {
-    // show error message etc...
+    // show error message
+  }
+
+  reflexHalted (element, reflex, error, reflexId) {
+    // handle aborted Reflex action
   }
 
   afterReflex (element, reflex, noop, reflexId) {
     // document.body.classList.remove('wait')
   }
+
+  finalizeReflex (element, reflex, noop, reflexId) {
+    // all operations have completed, animation etc is now safe
+  }
 }

data/lib/generators/stimulus_reflex/templates/app/reflexes/%file_name%_reflex.rb.tt

@@ -3,24 +3,34 @@
 class <%= class_name %>Reflex < ApplicationReflex
   # Add Reflex methods in this file.
   #
-  # All Reflex instances expose the following properties:
+  # All Reflex instances include CableReady::Broadcaster and expose the following properties:
   #
-  #   - connection - the ActionCable connection
-  #   - channel - the ActionCable channel
-  #   - request - an ActionDispatch::Request proxy for the socket connection
-  #   - session - the ActionDispatch::Session store for the current visitor
-  #   - url - the URL of the page that triggered the reflex
-  #   - element - a Hash like object that represents the HTML element that triggered the reflex
-  #   - params - parameters from the element's closest form (if any)
+  #   - connection  - the ActionCable connection
+  #   - channel     - the ActionCable channel
+  #   - request     - an ActionDispatch::Request proxy for the socket connection
+  #   - session     - the ActionDispatch::Session store for the current visitor
+  #   - flash       - the ActionDispatch::Flash::FlashHash for the current request
+  #   - url         - the URL of the page that triggered the reflex
+  #   - params      - parameters from the element's closest form (if any)
+  #   - element     - a Hash like object that represents the HTML element that triggered the reflex
+  #     - signed    - use a signed Global ID to map dataset attribute to a model eg. element.signed[:foo]
+  #     - unsigned  - use an unsigned Global ID to map dataset attribute to a model  eg. element.unsigned[:foo]
+  #   - cable_ready - a special cable_ready that can broadcast to the current visitor (no brackets needed)
+  #   - reflex_id   - a UUIDv4 that uniquely identies each Reflex
   #
   # Example:
   #
+  #   before_reflex do
+  #     # throw :abort # this will prevent the Reflex from continuing
+  #     # learn more about callbacks at https://docs.stimulusreflex.com/lifecycle
+  #   end
+  #
   #   def example(argument=true)
   #     # Your logic here...
   #     # Any declared instance variables will be made available to the Rails controller and view.
   #   end
   #
-  # Learn more at: https://docs.stimulusreflex.com
+  # Learn more at: https://docs.stimulusreflex.com/reflexes#reflex-classes
 
 <% actions.each do |action| -%>
   def <%= action %>

data/lib/generators/stimulus_reflex/templates/app/reflexes/application_reflex.rb.tt

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 class ApplicationReflex < StimulusReflex::Reflex
-  # Put application wide Reflex behavior in this file.
+  # Put application-wide Reflex behavior and callbacks in this file. 
   #
   # Example:
   #
   #   # If your ActionCable connection is: `identified_by :current_user`
   #   delegate :current_user, to: :connection
   #
-  # Learn more at: https://docs.stimulusreflex.com
+  # Learn more at: https://docs.stimulusreflex.com/reflexes#reflex-classes
 end

data/lib/generators/stimulus_reflex/templates/config/initializers/stimulus_reflex.rb

@@ -12,9 +12,18 @@ StimulusReflex.configure do |config|
 
   # Customize server-side Reflex logging format, with optional colorization:
   # Available tokens: session_id, session_id_full, reflex_info, operation, reflex_id, reflex_id_full, mode, selector, operation_counter, connection_id, connection_id_full, timestamp
-  # Available colors: green, yellow, blue, magenta, cyan, white
+  # Available colors: red, green, yellow, blue, magenta, cyan, white
   # You can also use attributes from your ActionCable Connection's identifiers that resolve to valid ActiveRecord models
   # eg. if your connection is `identified_by :current_user` and your User model has an email attribute, you can access r.email (it will display `-` if the user isn't logged in)
+  # Learn more at: https://docs.stimulusreflex.com/troubleshooting#stimulusreflex-logging
 
   # config.logging = proc { "[#{session_id}] #{operation_counter.magenta} #{reflex_info.green} -> #{selector.cyan} via #{mode} Morph (#{operation.yellow})" }
+
+  # Optimized for speed, StimulusReflex doesn't enable Rack middleware by default.
+  # If you are using Page Morphs and your app uses Rack middleware to rewrite part of the request path, you must enable those middleware modules in StimulusReflex.
+  #
+  # Learn more about registering Rack middleware in Rails here: https://guides.rubyonrails.org/rails_on_rack.html#configuring-middleware-stack
+
+  # config.middleware.use FirstRackMiddleware
+  # config.middleware.use SecondRackMiddleware
 end

data/lib/stimulus_reflex.rb

@@ -9,6 +9,7 @@ require "action_cable"
 require "nokogiri"
 require "cable_ready"
 require "stimulus_reflex/version"
+require "stimulus_reflex/cable_ready_channels"
 require "stimulus_reflex/configuration"
 require "stimulus_reflex/reflex"
 require "stimulus_reflex/element"
@@ -23,7 +24,7 @@ require "stimulus_reflex/logger"
 module StimulusReflex
   class Engine < Rails::Engine
     initializer "stimulus_reflex.sanity_check" do
-      SanityChecker.check!
+      SanityChecker.check! unless Rails.env.production?
     end
   end
 end

data/lib/stimulus_reflex/broadcasters/broadcaster.rb

@@ -2,10 +2,8 @@
 
 module StimulusReflex
   class Broadcaster
-    include CableReady::Broadcaster
-
     attr_reader :reflex, :logger, :operations
-    delegate :permanent_attribute_name, :stream_name, to: :reflex
+    delegate :cable_ready, :permanent_attribute_name, to: :reflex
 
     def initialize(reflex)
       @reflex = reflex
@@ -28,7 +26,7 @@ module StimulusReflex
     def broadcast_message(subject:, body: nil, data: {}, error: nil)
       logger.error "\e[31m#{body}\e[0m" if subject == "error"
       operations << ["document", :dispatch_event]
-      cable_ready[stream_name].dispatch_event(
+      cable_ready.dispatch_event(
         name: "stimulus-reflex:server-message",
         detail: {
           reflexId: data["reflexId"],

data/lib/stimulus_reflex/broadcasters/page_broadcaster.rb

@@ -13,7 +13,7 @@ module StimulusReflex
       selectors.each do |selector|
         operations << [selector, :morph]
         html = document.css(selector).inner_html
-        cable_ready[stream_name].morph(
+        cable_ready.morph(
           selector: selector,
           html: html,
           children_only: true,
@@ -23,6 +23,7 @@ module StimulusReflex
           })
         )
       end
+
       cable_ready.broadcast
     end
 

data/lib/stimulus_reflex/broadcasters/selector_broadcaster.rb

@@ -12,7 +12,7 @@ module StimulusReflex
           match = fragment.at_css(selector)
           if match.present?
             operations << [selector, :morph]
-            cable_ready[stream_name].morph(
+            cable_ready.morph(
               selector: selector,
               html: match.inner_html,
               children_only: true,
@@ -23,7 +23,7 @@ module StimulusReflex
             )
           else
             operations << [selector, :inner_html]
-            cable_ready[stream_name].inner_html(
+            cable_ready.inner_html(
               selector: selector,
               html: fragment.to_html,
               stimulus_reflex: data.merge({

data/lib/stimulus_reflex/cable_ready_channels.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module StimulusReflex
+  class CableReadyChannels
+    stimulus_reflex_channel_methods = CableReady::Channels.instance.operations.keys + [:broadcast, :broadcast_to]
+    delegate(*stimulus_reflex_channel_methods, to: "stimulus_reflex_channel")
+    delegate :[], to: "cable_ready_channels"
+
+    def initialize(stream_name)
+      @stream_name = stream_name
+    end
+
+    def cable_ready_channels
+      CableReady::Channels.instance
+    end
+
+    def stimulus_reflex_channel
+      CableReady::Channels.instance[@stream_name]
+    end
+  end
+end

data/lib/stimulus_reflex/configuration.rb

@@ -14,7 +14,7 @@ module StimulusReflex
   end
 
   class Configuration
-    attr_accessor :on_failed_sanity_checks, :parent_channel, :logging
+    attr_accessor :on_failed_sanity_checks, :parent_channel, :logging, :middleware
 
     DEFAULT_LOGGING = proc { "[#{session_id}] #{operation_counter.magenta} #{reflex_info.green} -> #{selector.cyan} via #{mode} Morph (#{operation.yellow})" }
 
@@ -22,6 +22,7 @@ module StimulusReflex
       @on_failed_sanity_checks = :exit
       @parent_channel = "ApplicationCable::Channel"
       @logging = DEFAULT_LOGGING
+      @middleware = ActionDispatch::MiddlewareStack.new
     end
   end
 end

data/lib/stimulus_reflex/reflex.rb

@@ -5,7 +5,6 @@ ClientAttributes = Struct.new(:reflex_id, :reflex_controller, :xpath, :c_xpath,
 class StimulusReflex::Reflex
   include ActiveSupport::Rescuable
   include ActiveSupport::Callbacks
-  include CableReady::Broadcaster
 
   define_callbacks :process, skip_after_callbacks_if_terminated: true
 
@@ -45,14 +44,16 @@ class StimulusReflex::Reflex
     end
   end
 
-  attr_reader :channel, :url, :element, :selectors, :method_name, :broadcaster, :client_attributes, :logger
+  attr_reader :cable_ready, :channel, :url, :element, :selectors, :method_name, :broadcaster, :client_attributes, :logger
 
   alias_method :action_name, :method_name # for compatibility with controller libraries like Pundit that expect an action name
 
   delegate :connection, :stream_name, to: :channel
-  delegate :flash, :session, to: :request
+  delegate :controller_class, :flash, :session, to: :request
   delegate :broadcast, :broadcast_message, to: :broadcaster
   delegate :reflex_id, :reflex_controller, :xpath, :c_xpath, :permanent_attribute_name, to: :client_attributes
+  delegate :render, to: :controller_class
+  delegate :dom_id, to: "ActionView::RecordIdentifier"
 
   def initialize(channel, url: nil, element: nil, selectors: [], method_name: nil, params: {}, client_attributes: {})
     @channel = channel
@@ -64,6 +65,7 @@ class StimulusReflex::Reflex
     @broadcaster = StimulusReflex::PageBroadcaster.new(self)
     @logger = StimulusReflex::Logger.new(self)
     @client_attributes = ClientAttributes.new(client_attributes)
+    @cable_ready = StimulusReflex::CableReadyChannels.new(stream_name)
     self.params
   end
 
@@ -86,6 +88,14 @@ class StimulusReflex::Reflex
       )
 
       env = connection.env.merge(mock_env)
+
+      middleware = StimulusReflex.config.middleware
+
+      if middleware.any?
+        stack = middleware.build(Rails.application.routes)
+        stack.call(env)
+      end
+
       req = ActionDispatch::Request.new(env)
 
       path_params = Rails.application.routes.recognize_path_with_request(req, url, req.env[:extras] || {})
@@ -114,11 +124,11 @@ class StimulusReflex::Reflex
 
   def controller
     @controller ||= begin
-      request.controller_class.new.tap do |c|
+      controller_class.new.tap do |c|
         c.instance_variable_set :"@stimulus_reflex", true
         instance_variables.each { |name| c.instance_variable_set name, instance_variable_get(name) }
-        c.request = request
-        c.response = ActionDispatch::Response.new
+        c.set_request! request
+        c.set_response! controller_class.make_response!(request)
       end
     end
   end

data/lib/stimulus_reflex/sanity_checker.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
 class StimulusReflex::SanityChecker
+  NODE_VERSION_FORMAT = /(\d+\.\d+\.\d+.*):/
   JSON_VERSION_FORMAT = /(\d+\.\d+\.\d+.*)"/
 
   class << self
     def check!
       return if StimulusReflex.config.on_failed_sanity_checks == :ignore
+      return if called_by_installer?
       return if called_by_generate_config?
 
       instance = new
@@ -15,6 +17,12 @@ class StimulusReflex::SanityChecker
 
     private
 
+    def called_by_installer?
+      Rake.application.top_level_tasks.include? "stimulus_reflex:install"
+    rescue
+      false
+    end
+
     def called_by_generate_config?
       ARGV.include? "stimulus_reflex:config"
     end
@@ -79,6 +87,8 @@ class StimulusReflex::SanityChecker
   def find_javascript_package_version
     if (match = search_file(package_json_path, regex: /version/))
       match[JSON_VERSION_FORMAT, 1]
+    elsif (match = search_file(yarn_lock_path, regex: /^stimulus_reflex/))
+      match[NODE_VERSION_FORMAT, 1]
     end
   end
 
@@ -91,6 +101,10 @@ class StimulusReflex::SanityChecker
     Rails.root.join("node_modules", "stimulus_reflex", "package.json")
   end
 
+  def yarn_lock_path
+    Rails.root.join("yarn.lock")
+  end
+
   def initializer_path
     @_initializer_path ||= Rails.root.join("config", "initializers", "stimulus_reflex.rb")
   end
@@ -120,13 +134,13 @@ class StimulusReflex::SanityChecker
       puts <<~INFO
         If you know what you are doing and you want to start the application anyway,
         you can create a StimulusReflex initializer with the command:
-      
+
         bundle exec rails generate stimulus_reflex:config
-      
+
         Then open your initializer at
-      
+
         <RAILS_ROOT>/config/initializers/stimulus_reflex.rb
-      
+
         and then add the following directive:
 
           StimulusReflex.configure do |config|

data/lib/stimulus_reflex/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StimulusReflex
-  VERSION = "3.4.0.pre5"
+  VERSION = "3.4.0"
 end

data/lib/tasks/stimulus_reflex/install.rake

@@ -6,9 +6,10 @@ require "stimulus_reflex/version"
 namespace :stimulus_reflex do
   desc "Install StimulusReflex in this application"
   task install: :environment do
-    system "bundle exec rails webpacker:install:stimulus"
+    system "rails dev:cache" unless Rails.root.join("tmp", "caching-dev.txt").exist?
     gem_version = StimulusReflex::VERSION.gsub(".pre", "-pre")
     system "yarn add stimulus_reflex@#{gem_version}"
+    system "bundle exec rails webpacker:install:stimulus"
     main_folder = defined?(Webpacker) ? Webpacker.config.source_path.to_s.gsub("#{Rails.root}/", "") : "app/javascript"
 
     FileUtils.mkdir_p Rails.root.join("#{main_folder}/controllers"), verbose: true
@@ -39,7 +40,7 @@ namespace :stimulus_reflex do
 
     unless lines.find { |line| line.start_with?("import controller") }
       matches = lines.select { |line| line =~ /\A(require|import)/ }
-      lines.insert lines.index(matches.last).to_i + 1, "import controller from './application_controller'\n"
+      lines.insert lines.index(matches.last).to_i + 1, "import controller from '../controllers/application_controller'\n"
     end
 
     initialize_line = lines.find { |line| line.start_with?("StimulusReflex.initialize") }
@@ -67,6 +68,10 @@ namespace :stimulus_reflex do
     system "bundle exec rails generate stimulus_reflex example"
     puts "Generating default StimulusReflex configuration file into your application config/initializers directory"
     system "bundle exec rails generate stimulus_reflex:config"
-    system "rails dev:cache" unless Rails.root.join("tmp", "caching-dev.txt").exist?
+
+    puts
+    puts "StimulusReflex and CableReady have been successfully installed!"
+    puts "Go to https://docs.stimulusreflex.com/quickstart if you need help getting started."
+    puts
   end
 end

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stimulus_reflex",
-  "version": "3.4.0-pre4",
+  "version": "3.4.0-pre9",
   "description": "Build reactive applications with the Rails tooling you already know and love.",
   "keywords": [
     "ruby",
@@ -41,7 +41,7 @@
   },
   "dependencies": {
     "@rails/actioncable": ">= 6.0",
-    "cable_ready": ">= 4.3.0"
+    "cable_ready": ">= 4.4"
   },
   "devDependencies": {
     "@babel/core": "^7.6.2",
@@ -52,6 +52,6 @@
     "jsdom": "^16.0.1",
     "mocha": "^8.0.1",
     "prettier-standard": "^16.1.0",
-    "stimulus": "^1.1.1"
+    "stimulus": ">= 1.1"
   }
 }

data/stimulus_reflex.gemspec

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require File.expand_path("../lib/stimulus_reflex/version", __FILE__)
 
 Gem::Specification.new do |gem|
@@ -30,7 +32,7 @@ Gem::Specification.new do |gem|
   gem.add_dependency "nokogiri"
   gem.add_dependency "rails", ">= 5.2"
   gem.add_dependency "redis"
-  gem.add_dependency "cable_ready", ">= 4.3.0"
+  gem.add_dependency "cable_ready", ">= 4.4"
 
   gem.add_development_dependency "bundler", "~> 2.0"
   gem.add_development_dependency "pry-nav"

data/tags

@@ -4,95 +4,153 @@
 !_TAG_PROGRAM_NAME	Exuberant Ctags	//
 !_TAG_PROGRAM_URL	http://ctags.sourceforge.net	/official site/
 !_TAG_PROGRAM_VERSION	5.8	//
+ActionDispatch	test/test_helper.rb	/^class ActionDispatch::Request$/;"	c
+ApplicationController	test/test_helper.rb	/^class ApplicationController < ActionController::Base; end$/;"	c
 ApplicationReflex	test/tmp/app/reflexes/application_reflex.rb	/^class ApplicationReflex < StimulusReflex::Reflex$/;"	c
 Broadcaster	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^  class Broadcaster$/;"	c	class:StimulusReflex
-CompareXML	lib/stimulus_reflex/compare_xml.rb	/^module CompareXML$/;"	m
+CableReadyChannels	lib/stimulus_reflex/cable_ready_channels.rb	/^  class CableReadyChannels$/;"	c	class:StimulusReflex
+Colorize	lib/stimulus_reflex/utils/colorize.rb	/^    module Colorize$/;"	m	class:StimulusReflex.Utils
+ConfigGenerator	lib/generators/stimulus_reflex/config_generator.rb	/^  class ConfigGenerator < Rails::Generators::Base$/;"	c	class:StimulusReflex
+Configuration	lib/stimulus_reflex/configuration.rb	/^  class Configuration$/;"	c
 Engine	lib/stimulus_reflex.rb	/^  class Engine < Rails::Engine$/;"	c	class:StimulusReflex
+Logger	lib/stimulus_reflex/logger.rb	/^  class Logger$/;"	c	class:StimulusReflex
 NothingBroadcaster	lib/stimulus_reflex/broadcasters/nothing_broadcaster.rb	/^  class NothingBroadcaster < Broadcaster$/;"	c	class:StimulusReflex
 PageBroadcaster	lib/stimulus_reflex/broadcasters/page_broadcaster.rb	/^  class PageBroadcaster < Broadcaster$/;"	c	class:StimulusReflex
 SelectorBroadcaster	lib/stimulus_reflex/broadcasters/selector_broadcaster.rb	/^  class SelectorBroadcaster < Broadcaster$/;"	c	class:StimulusReflex
+SessionMock	test/test_helper.rb	/^class SessionMock$/;"	c
+StimulusReflex	app/channels/stimulus_reflex/channel.rb	/^class StimulusReflex::Channel < StimulusReflex.configuration.parent_channel.constantize$/;"	c
+StimulusReflex	lib/generators/stimulus_reflex/config_generator.rb	/^module StimulusReflex$/;"	m
 StimulusReflex	lib/stimulus_reflex.rb	/^module StimulusReflex$/;"	m
 StimulusReflex	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^module StimulusReflex$/;"	m
 StimulusReflex	lib/stimulus_reflex/broadcasters/nothing_broadcaster.rb	/^module StimulusReflex$/;"	m
 StimulusReflex	lib/stimulus_reflex/broadcasters/page_broadcaster.rb	/^module StimulusReflex$/;"	m
 StimulusReflex	lib/stimulus_reflex/broadcasters/selector_broadcaster.rb	/^module StimulusReflex$/;"	m
-StimulusReflex	lib/stimulus_reflex/channel.rb	/^class StimulusReflex::Channel < ActionCable::Channel::Base$/;"	c
+StimulusReflex	lib/stimulus_reflex/cable_ready_channels.rb	/^module StimulusReflex$/;"	m
+StimulusReflex	lib/stimulus_reflex/configuration.rb	/^module StimulusReflex$/;"	m
 StimulusReflex	lib/stimulus_reflex/element.rb	/^class StimulusReflex::Element < OpenStruct$/;"	c
+StimulusReflex	lib/stimulus_reflex/logger.rb	/^module StimulusReflex$/;"	m
 StimulusReflex	lib/stimulus_reflex/reflex.rb	/^class StimulusReflex::Reflex$/;"	c
+StimulusReflex	lib/stimulus_reflex/sanity_checker.rb	/^class StimulusReflex::SanityChecker$/;"	c
+StimulusReflex	lib/stimulus_reflex/utils/colorize.rb	/^module StimulusReflex$/;"	m
 StimulusReflex	lib/stimulus_reflex/version.rb	/^module StimulusReflex$/;"	m
-StimulusReflexGenerator	lib/generators/stimulus_reflex_generator.rb	/^class StimulusReflexGenerator < Rails::Generators::NamedBase$/;"	c
+StimulusReflex	test/broadcasters/broadcaster_test.rb	/^class StimulusReflex::BroadcasterTest < StimulusReflex::BroadcasterTestCase$/;"	c
+StimulusReflex	test/broadcasters/broadcaster_test_case.rb	/^class StimulusReflex::BroadcasterTestCase < ActionCable::Channel::TestCase$/;"	c
+StimulusReflex	test/broadcasters/nothing_broadcaster_test.rb	/^class StimulusReflex::NothingBroadcasterTest < StimulusReflex::BroadcasterTestCase$/;"	c
+StimulusReflex	test/broadcasters/page_broadcaster_test.rb	/^class StimulusReflex::PageBroadcasterTest < StimulusReflex::BroadcasterTestCase$/;"	c
+StimulusReflex	test/reflex_test.rb	/^class StimulusReflex::ReflexTest < ActionCable::Channel::TestCase$/;"	c
+StimulusReflexGenerator	lib/generators/stimulus_reflex/stimulus_reflex_generator.rb	/^class StimulusReflexGenerator < Rails::Generators::NamedBase$/;"	c
 StimulusReflexGeneratorTest	test/generators/stimulus_reflex_generator_test.rb	/^class StimulusReflexGeneratorTest < Rails::Generators::TestCase$/;"	c
+TestApp	test/test_helper.rb	/^class TestApp < Rails::Application$/;"	c
+TestController	test/test_helper.rb	/^class TestController < ApplicationController$/;"	c
 UserReflex	test/tmp/app/reflexes/user_reflex.rb	/^class UserReflex < ApplicationReflex$/;"	c
-addDifference	lib/stimulus_reflex/compare_xml.rb	/^    def addDifference(node1, node2, diff1, diff2, opts, differences)$/;"	f	class:CompareXML
+Utils	lib/stimulus_reflex/utils/colorize.rb	/^  module Utils$/;"	m	class:StimulusReflex
 add_callback	lib/stimulus_reflex/reflex.rb	/^    def add_callback(kind, *args, &block)$/;"	f	class:StimulusReflex
 after_reflex	lib/stimulus_reflex/reflex.rb	/^    def after_reflex(*args, &block)$/;"	f	class:StimulusReflex
+append_morph	lib/stimulus_reflex/broadcasters/selector_broadcaster.rb	/^    def append_morph(selectors, html)$/;"	f	class:StimulusReflex.SelectorBroadcaster
 around_reflex	lib/stimulus_reflex/reflex.rb	/^    def around_reflex(*args, &block)$/;"	f	class:StimulusReflex
-attrContentExcluded?	lib/stimulus_reflex/compare_xml.rb	/^    def attrContentExcluded?(a1, a2, opts)$/;"	f	class:CompareXML
-attrNameExcluded?	lib/stimulus_reflex/compare_xml.rb	/^    def attrNameExcluded?(a1, a2, opts)$/;"	f	class:CompareXML
-attrsExcluded?	lib/stimulus_reflex/compare_xml.rb	/^    def attrsExcluded?(a1, a2, opts)$/;"	f	class:CompareXML
 before_reflex	lib/stimulus_reflex/reflex.rb	/^    def before_reflex(*args, &block)$/;"	f	class:StimulusReflex
+body	test/broadcasters/page_broadcaster_test.rb	/^      def body$/;"	f
 broadcast	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^    def broadcast(*args)$/;"	f	class:StimulusReflex.Broadcaster
 broadcast	lib/stimulus_reflex/broadcasters/nothing_broadcaster.rb	/^    def broadcast(_, data)$/;"	f	class:StimulusReflex.NothingBroadcaster
 broadcast	lib/stimulus_reflex/broadcasters/page_broadcaster.rb	/^    def broadcast(selectors, data)$/;"	f	class:StimulusReflex.PageBroadcaster
 broadcast	lib/stimulus_reflex/broadcasters/selector_broadcaster.rb	/^    def broadcast(_, data = {})$/;"	f	class:StimulusReflex.SelectorBroadcaster
-broadcast_message	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^    def broadcast_message(subject:, body: nil, data: {})$/;"	f	class:StimulusReflex.Broadcaster
-collapse	lib/stimulus_reflex/compare_xml.rb	/^    def collapse(text)$/;"	f	class:CompareXML
-commit_session	lib/stimulus_reflex/channel.rb	/^  def commit_session(reflex)$/;"	f	class:StimulusReflex
-compareAttributeSets	lib/stimulus_reflex/compare_xml.rb	/^    def compareAttributeSets(n1, n2, a1_set, a2_set, opts, differences)$/;"	f	class:CompareXML
-compareAttributes	lib/stimulus_reflex/compare_xml.rb	/^    def compareAttributes(n1, n2, a1, a2, opts, differences, status = EQUIVALENT)$/;"	f	class:CompareXML
-compareChildren	lib/stimulus_reflex/compare_xml.rb	/^    def compareChildren(n1_set, n2_set, opts, differences, diffchildren = false, status = EQUIVALENT)$/;"	f	class:CompareXML
-compareCommentNodes	lib/stimulus_reflex/compare_xml.rb	/^    def compareCommentNodes(n1, n2, opts, differences, status = EQUIVALENT)$/;"	f	class:CompareXML
-compareDocumentNodes	lib/stimulus_reflex/compare_xml.rb	/^    def compareDocumentNodes(n1, n2, opts, differences, childopts = {}, diffchildren = false, status = EQUIVALENT)$/;"	f	class:CompareXML
-compareElementNodes	lib/stimulus_reflex/compare_xml.rb	/^    def compareElementNodes(n1, n2, opts, differences, childopts = {}, diffchildren = false, status = EQUIVALENT)$/;"	f	class:CompareXML
-compareNodes	lib/stimulus_reflex/compare_xml.rb	/^    def compareNodes(n1, n2, opts, differences, childopts = {}, diffchildren = false, status = EQUIVALENT)$/;"	f	class:CompareXML
-compareSortedAttributeSets	lib/stimulus_reflex/compare_xml.rb	/^    def compareSortedAttributeSets(n1, n2, a1_set, a2_set, opts, differences, status = EQUIVALENT)$/;"	f	class:CompareXML
-compareTextNodes	lib/stimulus_reflex/compare_xml.rb	/^    def compareTextNodes(n1, n2, opts, differences, status = EQUIVALENT)$/;"	f	class:CompareXML
-compareUnsortedAttributeSets	lib/stimulus_reflex/compare_xml.rb	/^    def compareUnsortedAttributeSets(n1, n2, a1_set, a2_set, opts, differences, status = EQUIVALENT)$/;"	f	class:CompareXML
+broadcast_message	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^    def broadcast_message(subject:, body: nil, data: {}, error: nil)$/;"	f	class:StimulusReflex.Broadcaster
+cable_ready_channels	lib/stimulus_reflex/cable_ready_channels.rb	/^    def cable_ready_channels$/;"	f	class:StimulusReflex.CableReadyChannels
+caching_enabled?	lib/stimulus_reflex/sanity_checker.rb	/^  def caching_enabled?$/;"	f
+called_by_generate_config?	lib/stimulus_reflex/sanity_checker.rb	/^    def called_by_generate_config?$/;"	f	class:StimulusReflex
+called_by_installer?	lib/stimulus_reflex/sanity_checker.rb	/^    def called_by_installer?$/;"	f	class:StimulusReflex
+check!	lib/stimulus_reflex/sanity_checker.rb	/^    def check!$/;"	f	class:StimulusReflex
+check_caching_enabled	lib/stimulus_reflex/sanity_checker.rb	/^  def check_caching_enabled$/;"	f
+check_javascript_package_version	lib/stimulus_reflex/sanity_checker.rb	/^  def check_javascript_package_version$/;"	f
+commit_session	app/channels/stimulus_reflex/channel.rb	/^  def commit_session(reflex)$/;"	f	class:StimulusReflex
+config_logging	lib/stimulus_reflex/logger.rb	/^    def config_logging$/;"	f	class:StimulusReflex.Logger
+configuration	lib/stimulus_reflex/configuration.rb	/^    def configuration$/;"	f	class:StimulusReflex
+configure	lib/stimulus_reflex/configuration.rb	/^    def configure$/;"	f	class:StimulusReflex
+connection_id	lib/stimulus_reflex/logger.rb	/^    def connection_id$/;"	f	class:StimulusReflex.Logger
+connection_id_full	lib/stimulus_reflex/logger.rb	/^    def connection_id_full$/;"	f	class:StimulusReflex.Logger
 controller	lib/stimulus_reflex/reflex.rb	/^  def controller$/;"	f
-copy_application_files	lib/generators/stimulus_reflex_generator.rb	/^  def copy_application_files$/;"	f	class:StimulusReflexGenerator
+copy_application_files	lib/generators/stimulus_reflex/stimulus_reflex_generator.rb	/^  def copy_application_files$/;"	f	class:StimulusReflexGenerator
+copy_config_file	lib/generators/stimulus_reflex/config_generator.rb	/^    def copy_config_file$/;"	f	class:StimulusReflex.ConfigGenerator
 dataset	lib/stimulus_reflex/element.rb	/^  def dataset$/;"	f	class:StimulusReflex
 default_reflex	lib/stimulus_reflex/reflex.rb	/^  def default_reflex$/;"	f
-delegate_call_to_reflex	lib/stimulus_reflex/channel.rb	/^  def delegate_call_to_reflex(reflex, method_name, arguments = [])$/;"	f	class:StimulusReflex
+delegate_call_to_reflex	app/channels/stimulus_reflex/channel.rb	/^  def delegate_call_to_reflex(reflex, method_name, arguments = [])$/;"	f	class:StimulusReflex
 do_more_stuff	test/tmp/app/reflexes/user_reflex.rb	/^  def do_more_stuff$/;"	f	class:UserReflex
 do_stuff	test/tmp/app/reflexes/user_reflex.rb	/^  def do_stuff$/;"	f	class:UserReflex
-enqueue_message	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^    def enqueue_message(subject:, body: nil, data: {})$/;"	f	class:StimulusReflex.Broadcaster
-equivalent?	lib/stimulus_reflex/compare_xml.rb	/^    def equivalent?(n1, n2, opts = {}, childopts = {}, diffchildren = false)$/;"	f	class:CompareXML
-error	javascript/log.js	/^function error (response) {$/;"	f
-exception_message_with_backtrace	lib/stimulus_reflex/channel.rb	/^  def exception_message_with_backtrace(exception)$/;"	f	class:StimulusReflex
-execute	lib/generators/stimulus_reflex_generator.rb	/^  def execute$/;"	f	class:StimulusReflexGenerator
+env	test/broadcasters/broadcaster_test_case.rb	/^    def connection.env$/;"	F	class:StimulusReflex
+env	test/reflex_test.rb	/^    def connection.env$/;"	F	class:StimulusReflex
+exception_message_with_backtrace	app/channels/stimulus_reflex/channel.rb	/^  def exception_message_with_backtrace(exception)$/;"	f	class:StimulusReflex
+execute	lib/generators/stimulus_reflex/stimulus_reflex_generator.rb	/^  def execute$/;"	f	class:StimulusReflexGenerator
+exit_with_info	lib/stimulus_reflex/sanity_checker.rb	/^  def exit_with_info$/;"	f
 export.reflexAttribute	javascript/schema.js	/^  reflexAttribute: 'data-reflex',$/;"	p
 export.reflexDatasetAttribute	javascript/schema.js	/^  reflexDatasetAttribute: 'data-reflex-dataset'$/;"	p
 export.reflexPermanentAttribute	javascript/schema.js	/^  reflexPermanentAttribute: 'data-reflex-permanent',$/;"	p
 export.reflexRootAttribute	javascript/schema.js	/^  reflexRootAttribute: 'data-reflex-root',$/;"	p
 findConsumer	javascript/consumer.js	/^function findConsumer (object, depth = 0) {$/;"	f
-function.success	javascript/log.js	/^function success (response, options = { halted: false }) {$/;"	f
+find_javascript_package_version	lib/stimulus_reflex/sanity_checker.rb	/^  def find_javascript_package_version$/;"	f
+fix_environment!	app/channels/stimulus_reflex/channel.rb	/^  def fix_environment!$/;"	f	class:StimulusReflex
+function.error	javascript/log.js	/^function error (event) {$/;"	f
+gem_version	lib/stimulus_reflex/sanity_checker.rb	/^  def gem_version$/;"	f
 halted?	lib/stimulus_reflex/reflex.rb	/^  def halted?$/;"	f
+index	test/test_helper.rb	/^  def index$/;"	f	class:TestController
 initialize	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^    def initialize(reflex)$/;"	f	class:StimulusReflex.Broadcaster
+initialize	lib/stimulus_reflex/cable_ready_channels.rb	/^    def initialize(stream_name)$/;"	f	class:StimulusReflex.CableReadyChannels
+initialize	lib/stimulus_reflex/configuration.rb	/^    def initialize$/;"	f	class:Configuration
 initialize	lib/stimulus_reflex/element.rb	/^  def initialize(data = {})$/;"	f	class:StimulusReflex
-initialize	lib/stimulus_reflex/reflex.rb	/^  def initialize(channel, url: nil, element: nil, selectors: [], method_name: nil, permanent_attribute_name: nil, params: {})$/;"	f
-is_reflex?	lib/stimulus_reflex/channel.rb	/^  def is_reflex?(reflex_class)$/;"	f	class:StimulusReflex
+initialize	lib/stimulus_reflex/logger.rb	/^    def initialize(reflex)$/;"	f	class:StimulusReflex.Logger
+initialize	lib/stimulus_reflex/reflex.rb	/^  def initialize(channel, url: nil, element: nil, selectors: [], method_name: nil, params: {}, client_attributes: {})$/;"	f
+initializer_path	lib/stimulus_reflex/sanity_checker.rb	/^  def initializer_path$/;"	f
+is_reflex?	app/channels/stimulus_reflex/channel.rb	/^  def is_reflex?(reflex_class)$/;"	f	class:StimulusReflex
+javascript_package_version	lib/stimulus_reflex/sanity_checker.rb	/^  def javascript_package_version$/;"	f
+javascript_version_matches?	lib/stimulus_reflex/sanity_checker.rb	/^  def javascript_version_matches?$/;"	f
+load!	test/test_helper.rb	/^  def load!$/;"	f	class:SessionMock
+method_missing	lib/stimulus_reflex/logger.rb	/^    def method_missing method$/;"	f	class:StimulusReflex.Logger
+mode	lib/stimulus_reflex/logger.rb	/^    def mode$/;"	f	class:StimulusReflex.Logger
 morph	lib/stimulus_reflex/reflex.rb	/^  def morph(selectors, html = "")$/;"	f
 morphs	lib/stimulus_reflex/broadcasters/selector_broadcaster.rb	/^    def morphs$/;"	f	class:StimulusReflex.SelectorBroadcaster
-nodeExcluded?	lib/stimulus_reflex/compare_xml.rb	/^    def nodeExcluded?(n, opts)$/;"	f	class:CompareXML
 normalize_callback_option!	lib/stimulus_reflex/reflex.rb	/^    def normalize_callback_option!(options, from, to)$/;"	f	class:StimulusReflex
 normalize_callback_options!	lib/stimulus_reflex/reflex.rb	/^    def normalize_callback_options!(options)$/;"	f	class:StimulusReflex
+not_null_store?	lib/stimulus_reflex/sanity_checker.rb	/^  def not_null_store?$/;"	f
 nothing?	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^    def nothing?$/;"	f	class:StimulusReflex.Broadcaster
 nothing?	lib/stimulus_reflex/broadcasters/nothing_broadcaster.rb	/^    def nothing?$/;"	f	class:StimulusReflex.NothingBroadcaster
-object_with_indifferent_access	lib/stimulus_reflex/channel.rb	/^  def object_with_indifferent_access(object)$/;"	f	class:StimulusReflex
+object_with_indifferent_access	app/channels/stimulus_reflex/channel.rb	/^  def object_with_indifferent_access(object)$/;"	f	class:StimulusReflex
+operation	lib/stimulus_reflex/logger.rb	/^    def operation$/;"	f	class:StimulusReflex.Logger
+operation_counter	lib/stimulus_reflex/logger.rb	/^    def operation_counter$/;"	f	class:StimulusReflex.Logger
+package_json_path	lib/stimulus_reflex/sanity_checker.rb	/^  def package_json_path$/;"	f
 page?	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^    def page?$/;"	f	class:StimulusReflex.Broadcaster
 page?	lib/stimulus_reflex/broadcasters/page_broadcaster.rb	/^    def page?$/;"	f	class:StimulusReflex.PageBroadcaster
-page_cache	lib/stimulus_reflex/channel.rb	/^  def page_cache$/;"	f	class:StimulusReflex
 params	lib/stimulus_reflex/reflex.rb	/^  def params$/;"	f
+print	lib/stimulus_reflex/logger.rb	/^    def print$/;"	f	class:StimulusReflex.Logger
+private_instance_methods	lib/stimulus_reflex/logger.rb	/^    def private_instance_methods$/;"	f	class:StimulusReflex.Logger
 process	lib/stimulus_reflex/reflex.rb	/^  def process(name, *args)$/;"	f
-receive	lib/stimulus_reflex/channel.rb	/^  def receive(data)$/;"	f	class:StimulusReflex
+receive	app/channels/stimulus_reflex/channel.rb	/^  def receive(data)$/;"	f	class:StimulusReflex
+reflex	javascript/lifecycle.js	/^  const detail = { reflex: target, controller, reflexId }$/;"	p
+reflex_id	lib/stimulus_reflex/logger.rb	/^    def reflex_id$/;"	f	class:StimulusReflex.Logger
+reflex_id_full	lib/stimulus_reflex/logger.rb	/^    def reflex_id_full$/;"	f	class:StimulusReflex.Logger
+reflex_info	lib/stimulus_reflex/logger.rb	/^    def reflex_info$/;"	f	class:StimulusReflex.Logger
+request	javascript/log.js	/^function request (reflexId, target, args, controller, element) {$/;"	f
 request	lib/stimulus_reflex/reflex.rb	/^  def request$/;"	f
+request.success	javascript/log.js	/^function success (event) {$/;"	f
+respond_to_missing?	lib/stimulus_reflex/logger.rb	/^    def respond_to_missing? method$/;"	f	class:StimulusReflex.Logger
+search_file	lib/stimulus_reflex/sanity_checker.rb	/^  def search_file(path, regex:)$/;"	f
+selector	lib/stimulus_reflex/logger.rb	/^    def selector$/;"	f	class:StimulusReflex.Logger
 selector?	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^    def selector?$/;"	f	class:StimulusReflex.Broadcaster
 selector?	lib/stimulus_reflex/broadcasters/selector_broadcaster.rb	/^    def selector?$/;"	f	class:StimulusReflex.SelectorBroadcaster
-stream_name	lib/stimulus_reflex/channel.rb	/^  def stream_name$/;"	f	class:StimulusReflex
-subscribed	lib/stimulus_reflex/channel.rb	/^  def subscribed$/;"	f	class:StimulusReflex
+session	test/test_helper.rb	/^  def session$/;"	f	class:ActionDispatch
+session_id	lib/stimulus_reflex/logger.rb	/^    def session_id$/;"	f	class:StimulusReflex.Logger
+session_id_full	lib/stimulus_reflex/logger.rb	/^    def session_id_full$/;"	f	class:StimulusReflex.Logger
+signed	lib/stimulus_reflex/element.rb	/^  def signed$/;"	f	class:StimulusReflex
+stimulus_reflex_channel	lib/stimulus_reflex/cable_ready_channels.rb	/^    def stimulus_reflex_channel$/;"	f	class:StimulusReflex.CableReadyChannels
+stream_name	app/channels/stimulus_reflex/channel.rb	/^  def stream_name$/;"	f	class:StimulusReflex
+subscribed	app/channels/stimulus_reflex/channel.rb	/^  def subscribed$/;"	f	class:StimulusReflex
+timestamp	lib/stimulus_reflex/logger.rb	/^    def timestamp$/;"	f	class:StimulusReflex.Logger
+to_s	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^    def to_s$/;"	f	class:StimulusReflex.Broadcaster
+to_s	lib/stimulus_reflex/broadcasters/nothing_broadcaster.rb	/^    def to_s$/;"	f	class:StimulusReflex.NothingBroadcaster
+to_s	lib/stimulus_reflex/broadcasters/page_broadcaster.rb	/^    def to_s$/;"	f	class:StimulusReflex.PageBroadcaster
+to_s	lib/stimulus_reflex/broadcasters/selector_broadcaster.rb	/^    def to_s$/;"	f	class:StimulusReflex.SelectorBroadcaster
 to_sym	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^    def to_sym$/;"	f	class:StimulusReflex.Broadcaster
 to_sym	lib/stimulus_reflex/broadcasters/nothing_broadcaster.rb	/^    def to_sym$/;"	f	class:StimulusReflex.NothingBroadcaster
 to_sym	lib/stimulus_reflex/broadcasters/page_broadcaster.rb	/^    def to_sym$/;"	f	class:StimulusReflex.PageBroadcaster
 to_sym	lib/stimulus_reflex/broadcasters/selector_broadcaster.rb	/^    def to_sym$/;"	f	class:StimulusReflex.SelectorBroadcaster
+unsigned	lib/stimulus_reflex/element.rb	/^  def unsigned$/;"	f	class:StimulusReflex
 update	test/tmp/app/reflexes/user_reflex.rb	/^  def update$/;"	f	class:UserReflex
-url_params	lib/stimulus_reflex/reflex.rb	/^  def url_params$/;"	f
+warn_and_exit	lib/stimulus_reflex/sanity_checker.rb	/^  def warn_and_exit(text)$/;"	f