stimulus_reflex 3.3.0 → 3.4.0.pre4

data/lib/stimulus_reflex/sanity_checker.rb

@@ -1,36 +1,53 @@
 # frozen_string_literal: true
 
 class StimulusReflex::SanityChecker
-  NODE_VERSION_FORMAT = /(\d+\.\d+\.\d+.*):/
   JSON_VERSION_FORMAT = /(\d+\.\d+\.\d+.*)"/
 
-  def self.check!
-    instance = new
-    instance.check_caching_enabled
-    instance.check_javascript_package_version
+  class << self
+    def check!
+      return if StimulusReflex.config.on_failed_sanity_checks == :ignore
+      return if called_by_generate_config?
+
+      instance = new
+      instance.check_caching_enabled
+      instance.check_javascript_package_version
+    end
+
+    private
+
+    def called_by_generate_config?
+      ARGV.include? "stimulus_reflex:config"
+    end
   end
 
   def check_caching_enabled
     unless caching_enabled?
-      puts <<~WARN
-        WARNING: Stimulus Reflex requires caching to be enabled. Caching allows the session to be modified during ActionCable requests.
+      warn_and_exit <<~WARN
+        Stimulus Reflex requires caching to be enabled. Caching allows the session to be modified during ActionCable requests.
         To enable caching in development, run:
             rails dev:cache
       WARN
     end
+
+    unless not_null_store?
+      warn_and_exit <<~WARN
+        Stimulus Reflex requires caching to be enabled. Caching allows the session to be modified during ActionCable requests.
+        But your config.cache_store is set to :null_store, so it won't work.
+      WARN
+    end
   end
 
   def check_javascript_package_version
     if javascript_package_version.nil?
-      puts <<~WARN
-        WARNING: Can't locate the stimulus_reflex NPM package.
+      warn_and_exit <<~WARN
+        Can't locate the stimulus_reflex NPM package.
         Either add it to your package.json as a dependency or use "yarn link stimulus_reflex" if you are doing development.
       WARN
     end
 
     unless javascript_version_matches?
-      puts <<~WARN
-        WARNING: The Stimulus Reflex javascript package version (#{javascript_package_version}) does not match the Rubygem version (#{gem_version}).
+      warn_and_exit <<~WARN
+        The Stimulus Reflex javascript package version (#{javascript_package_version}) does not match the Rubygem version (#{gem_version}).
         To update the Stimulus Reflex npm package:
             yarn upgrade stimulus_reflex@#{gem_version}
       WARN
@@ -40,8 +57,11 @@ class StimulusReflex::SanityChecker
   private
 
   def caching_enabled?
-    Rails.application.config.action_controller.perform_caching &&
-      Rails.application.config.cache_store != :null_store
+    Rails.application.config.action_controller.perform_caching
+  end
+
+  def not_null_store?
+    Rails.application.config.cache_store != :null_store
   end
 
   def javascript_version_matches?
@@ -53,14 +73,11 @@ class StimulusReflex::SanityChecker
   end
 
   def javascript_package_version
-    return @_js_version if defined?(@_js_version)
-    @_js_version = find_javascript_package_version
+    @_js_version ||= find_javascript_package_version
   end
 
   def find_javascript_package_version
-    if (match = search_file(yarn_lock_path, regex: /^stimulus_reflex/))
-      match[NODE_VERSION_FORMAT, 1]
-    elsif (match = search_file(yarn_link_path, regex: /version/))
+    if (match = search_file(package_json_path, regex: /version/))
       match[JSON_VERSION_FORMAT, 1]
     end
   end
@@ -70,11 +87,54 @@ class StimulusReflex::SanityChecker
     File.foreach(path).grep(regex).first
   end
 
-  def yarn_lock_path
-    Rails.root.join("yarn.lock")
+  def package_json_path
+    Rails.root.join("node_modules", "stimulus_reflex", "package.json")
+  end
+
+  def initializer_path
+    @_initializer_path ||= Rails.root.join("config", "initializers", "stimulus_reflex.rb")
   end
 
-  def yarn_link_path
-    Rails.root.join("node_modules", "stimulus_reflex", "package.json")
+  def warn_and_exit(text)
+    puts "WARNING:"
+    puts text
+    exit_with_info if StimulusReflex.config.on_failed_sanity_checks == :exit
+  end
+
+  def exit_with_info
+    puts
+
+    # bundle exec rails generate stimulus_reflex:config
+    if File.exist?(initializer_path)
+      puts <<~INFO
+        If you know what you are doing and you want to start the application anyway,
+        you can add the following directive to the StimulusReflex initializer,
+        which is located at #{initializer_path}
+
+          StimulusReflex.configure do |config|
+            config.on_failed_sanity_checks = :warn
+          end
+
+      INFO
+    else
+      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|
+            config.on_failed_sanity_checks = :warn
+          end
+
+      INFO
+    end
+    exit
   end
 end

data/lib/stimulus_reflex/utils/colorize.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module StimulusReflex
+  module Utils
+    module Colorize
+      COLORS = {
+        red: "31",
+        green: "32",
+        yellow: "33",
+        blue: "34",
+        magenta: "35",
+        cyan: "36",
+        white: "37"
+      }
+
+      refine String do
+        COLORS.each do |name, code|
+          define_method(name) { "\e[#{code}m#{self}\e[0m" }
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_reflex/version.rb

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

data/lib/tasks/stimulus_reflex/install.rake

@@ -9,15 +9,16 @@ namespace :stimulus_reflex do
     system "bundle exec rails webpacker:install:stimulus"
     gem_version = StimulusReflex::VERSION.gsub(".pre", "-pre")
     system "yarn add stimulus_reflex@#{gem_version}"
+    main_folder = defined?(Webpacker) ? Webpacker.config.source_path.to_s.gsub("#{Rails.root}/", "") : "app/javascript"
 
-    FileUtils.mkdir_p Rails.root.join("app/javascript/controllers"), verbose: true
+    FileUtils.mkdir_p Rails.root.join("#{main_folder}/controllers"), verbose: true
     FileUtils.mkdir_p Rails.root.join("app/reflexes"), verbose: true
 
-    filepath = %w[
-      app/javascript/controllers/index.js
-      app/javascript/controllers/index.ts
-      app/javascript/packs/application.js
-      app/javascript/packs/application.ts
+    filepath = [
+      "#{main_folder}/controllers/index.js",
+      "#{main_folder}/controllers/index.ts",
+      "#{main_folder}/packs/application.js",
+      "#{main_folder}/packs/application.ts"
     ]
       .select { |path| File.exist?(path) }
       .map { |path| Rails.root.join(path) }
@@ -42,7 +43,8 @@ namespace :stimulus_reflex do
     end
 
     initialize_line = lines.find { |line| line.start_with?("StimulusReflex.initialize") }
-    lines << "StimulusReflex.initialize(application, { consumer, controller, debug: false })\n" unless initialize_line
+    lines << "StimulusReflex.initialize(application, { consumer, controller, isolate: true })\n" unless initialize_line
+    lines << "StimulusReflex.debug = process.env.RAILS_ENV === 'development'\n" unless initialize_line
     File.open(filepath, "w") { |f| f.write lines.join }
 
     filepath = Rails.root.join("config/environments/development.rb")
@@ -58,11 +60,13 @@ namespace :stimulus_reflex do
       lines.delete_at 1
       lines.insert 1, "  adapter: redis\n"
       lines.insert 2, "  url: <%= ENV.fetch(\"REDIS_URL\") { \"redis://localhost:6379/1\" } %>\n"
-      lines.insert 3, "  channel_prefix: " + Rails.application.class.module_parent.to_s.underscore + "_development\n"
+      lines.insert 3, "  channel_prefix: " + File.basename(Rails.root.to_s).underscore + "_development\n"
       File.open(filepath, "w") { |f| f.write lines.join }
     end
 
     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?
   end
 end

data/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "stimulus_reflex",
+  "version": "3.4.0-pre3",
+  "description": "Build reactive applications with the Rails tooling you already know and love.",
+  "keywords": [
+    "ruby",
+    "rails",
+    "websockets",
+    "actioncable",
+    "turbolinks",
+    "reactive",
+    "cable",
+    "ujs",
+    "ssr",
+    "stimulus",
+    "reflex",
+    "stimulus_reflex",
+    "dom",
+    "morphdom"
+  ],
+  "homepage": "https://docs.stimulusreflex.com/",
+  "bugs": {
+    "url": "https://github.com/hopsoft/stimulus_reflex/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com:hopsoft/stimulus_reflex.git"
+  },
+  "license": "MIT",
+  "author": "Nathan Hopkins <natehop@gmail.com>",
+  "main": "./javascript/stimulus_reflex.js",
+  "module": "./javascript/stimulus_reflex.js",
+  "scripts": {
+    "postinstall": "node javascript/scripts/post_install.js",
+    "prettier-standard:check": "yarn run prettier-standard --check *.js **/*.js",
+    "prettier-standard:format": "yarn run prettier-standard *.js **/*.js",
+    "test": "yarn run mocha --require @babel/register --require esm ./javascript/test"
+  },
+  "peerDependencies": {
+    "stimulus": ">= 1.1"
+  },
+  "dependencies": {
+    "@rails/actioncable": ">= 6.0",
+    "cable_ready": ">= 4.3.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.6.2",
+    "@babel/preset-env": "^7.6.2",
+    "@babel/register": "^7.6.2",
+    "assert": "^2.0.0",
+    "esm": "^3.2.25",
+    "jsdom": "^16.0.1",
+    "mocha": "^8.0.1",
+    "prettier-standard": "^16.1.0",
+    "stimulus": "^1.1.1"
+  }
+}

data/stimulus_reflex.gemspec

@@ -0,0 +1,40 @@
+require File.expand_path("../lib/stimulus_reflex/version", __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.name = "stimulus_reflex"
+  gem.license = "MIT"
+  gem.version = StimulusReflex::VERSION
+  gem.authors = ["Nathan Hopkins"]
+  gem.email = ["natehop@gmail.com"]
+  gem.homepage = "https://github.com/hopsoft/stimulus_reflex"
+  gem.summary = "Build reactive applications with the Rails tooling you already know and love."
+  gem.post_install_message = <<~MESSAGE
+    Friendly reminder: When updating the stimulus_reflex gem,
+    don't forget to update your npm package as well.
+
+    See https://www.npmjs.com/package/stimulus_reflex
+  MESSAGE
+
+  gem.metadata = {
+    "bug_tracker_uri" => "https://github.com/hopsoft/stimulus_reflex/issues",
+    "changelog_uri" => "https://github.com/hopsoft/stimulus_reflex/CHANGELOG.md",
+    "documentation_uri" => "https://docs.stimulusreflex.com",
+    "homepage_uri" => gem.homepage,
+    "source_code_uri" => gem.homepage
+  }
+
+  gem.files = Dir["app/**/*", "lib/**/*", "bin/*", "[A-Z]*"]
+  gem.test_files = Dir["test/**/*.rb"]
+
+  gem.add_dependency "rack"
+  gem.add_dependency "nokogiri"
+  gem.add_dependency "rails", ">= 5.2"
+  gem.add_dependency "redis"
+  gem.add_dependency "cable_ready", ">= 4.3.0"
+
+  gem.add_development_dependency "bundler", "~> 2.0"
+  gem.add_development_dependency "pry-nav"
+  gem.add_development_dependency "pry"
+  gem.add_development_dependency "rake"
+  gem.add_development_dependency "standardrb"
+end

data/tags

@@ -0,0 +1,98 @@
+!_TAG_FILE_FORMAT	2	/extended format; --format=1 will not append ;" to lines/
+!_TAG_FILE_SORTED	1	/0=unsorted, 1=sorted, 2=foldcase/
+!_TAG_PROGRAM_AUTHOR	Darren Hiebert	/dhiebert@users.sourceforge.net/
+!_TAG_PROGRAM_NAME	Exuberant Ctags	//
+!_TAG_PROGRAM_URL	http://ctags.sourceforge.net	/official site/
+!_TAG_PROGRAM_VERSION	5.8	//
+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
+Engine	lib/stimulus_reflex.rb	/^  class Engine < Rails::Engine$/;"	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
+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/element.rb	/^class StimulusReflex::Element < OpenStruct$/;"	c
+StimulusReflex	lib/stimulus_reflex/reflex.rb	/^class StimulusReflex::Reflex$/;"	c
+StimulusReflex	lib/stimulus_reflex/version.rb	/^module StimulusReflex$/;"	m
+StimulusReflexGenerator	lib/generators/stimulus_reflex_generator.rb	/^class StimulusReflexGenerator < Rails::Generators::NamedBase$/;"	c
+StimulusReflexGeneratorTest	test/generators/stimulus_reflex_generator_test.rb	/^class StimulusReflexGeneratorTest < Rails::Generators::TestCase$/;"	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
+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
+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
+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
+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
+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
+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
+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
+halted?	lib/stimulus_reflex/reflex.rb	/^  def halted?$/;"	f
+initialize	lib/stimulus_reflex/broadcasters/broadcaster.rb	/^    def initialize(reflex)$/;"	f	class:StimulusReflex.Broadcaster
+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
+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
+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
+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
+process	lib/stimulus_reflex/reflex.rb	/^  def process(name, *args)$/;"	f
+receive	lib/stimulus_reflex/channel.rb	/^  def receive(data)$/;"	f	class:StimulusReflex
+request	lib/stimulus_reflex/reflex.rb	/^  def request$/;"	f
+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
+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
+update	test/tmp/app/reflexes/user_reflex.rb	/^  def update$/;"	f	class:UserReflex
+url_params	lib/stimulus_reflex/reflex.rb	/^  def url_params$/;"	f

data/test/broadcasters/broadcaster_test.rb

@@ -0,0 +1,15 @@
+require_relative "../test_helper"
+
+class StimulusReflex::BroadcasterTest < ActiveSupport::TestCase
+  setup do
+    @reflex = Minitest::Mock.new
+    @reflex.expect :stream_name, "TestStream"
+  end
+
+  test "raises a NotImplementedError if called directly" do
+    broadcaster = StimulusReflex::Broadcaster.new(@reflex)
+
+    assert_raises(NotImplementedError) { broadcaster.broadcast }
+    assert_raises(NotImplementedError) { broadcaster.broadcast_message(subject: "Test") }
+  end
+end

data/test/broadcasters/nothing_broadcaster_test.rb

@@ -0,0 +1,34 @@
+require_relative "../test_helper"
+
+class StimulusReflex::NothingBroadcasterTest < ActiveSupport::TestCase
+  setup do
+    @reflex = Minitest::Mock.new
+    @reflex.expect :stream_name, "TestStream"
+  end
+
+  test "broadcasts a server message when called" do
+    broadcaster = StimulusReflex::NothingBroadcaster.new(@reflex)
+
+    cable_ready_channels = Minitest::Mock.new
+    cable_ready_channel = Minitest::Mock.new
+    CableReady::Channels.stub :instance, cable_ready_channels do
+      cable_ready_channel.expect(:dispatch_event, nil, [{name: "stimulus-reflex:server-message",
+                                                         detail: {
+                                                           reflexId: nil,
+                                                           stimulus_reflex: {
+                                                             some: :data,
+                                                             morph: :nothing,
+                                                             server_message: {
+                                                               subject: "nothing", body: nil
+                                                             }
+                                                           }
+                                                         }}])
+      cable_ready_channels.expect(:[], cable_ready_channel, ["TestStream"])
+      cable_ready_channels.expect(:broadcast, nil)
+      broadcaster.broadcast(nil, {some: :data})
+    end
+
+    assert_mock cable_ready_channels
+    assert_mock cable_ready_channel
+  end
+end