actioncable_nats_adapter 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 57974d22efe8e7f98ff01e1db48094c86b294eccaf9909f17e914d5e280c4f90
+  data.tar.gz: 8184da81e7d233c9f741880e941e2c0c86a51753c1e29db9d608aba7e7f4c1f2
+SHA512:
+  metadata.gz: 722a6bbaff38f85d9be69930c5ab8713eea6a4b04b791cdd9479d94f1e75be98691400c2ed4ea63373e72de858b260eca342eeab45a19bc3193e5291fce05582
+  data.tar.gz: 7678d76a28bacac4f78deac68f81b834284f2109162d36ec9c81b77189fb855ad90ffb162aa4a59e186ca5775d772596922c0ecde99fc84cb553dc067037b2a6

data/README.md

@@ -0,0 +1,35 @@
+# ActioncableNatsAdapter
+
+Use this as a subscription adapter in Rails 6+ with NATs.
+
+## Installation
+
+Add to your Gemfile:
+
+```bash
+bundle add actioncable_nats_adapter
+```
+
+TODO: publish action_cable_nats to rubygems.org
+
+
+## Usage
+
+Set the `config/cable.yaml` adapter to nats.
+
+Example:
+
+```yaml
+development:
+  adapter: nats
+  url: "nats://127.0.0.1:4222"
+
+test:
+  adapter: test
+
+production:
+  adapter: nats
+  channel_prefix: natscable_production
+  url: <%= ENV.fetch("NATS_URL") { "nats://127.0.0.1:4222" } %>
+
+```

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+task default: %i[]

data/lib/action_cable/subscription_adapter/nats.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+gem 'nats-pure'
+require 'nats/client'
+require 'action_cable'
+
+module ActionCable
+  module SubscriptionAdapter
+    class Nats < Inline # :nodoc:
+      prepend ChannelPrefix
+
+      def initialize(server)
+        super
+        nconf = server.config.cable.deep_symbolize_keys
+        @nats_conn = ::NATS.connect(nconf[:url], nconf[:cluster] || {})
+        @nats_conn.on_error do |e|
+          @logger.error "NATS Error: #{e}"
+        end
+
+        @nats_conn.on_reconnect do
+          @logger.info "NATS Reconnected to server at #{@nats_conn.connected_server}"
+        end
+
+        @nats_conn.on_disconnect do
+          @logger.warn "NATS Disconnected"
+        end
+
+        @nats_conn.on_close do
+          @logger.info "NATS connection close"
+        end
+      end
+
+      def broadcast(channel, payload)
+        @nats_conn.publish(channel, payload)
+      end
+
+      class Listener < SubscriberMap # :nodoc:
+        def initialize(nats_conn)
+          super()
+          @nats_conn = nats_conn
+          @nats_subs = {}
+        end
+
+        def add_channel(channel, on_success)
+          @nats_subs[channel] = @nats_conn.subscribe(channel) do |msg|
+            broadcast(channel, msg.data)
+          end
+          super
+        end
+
+        def remove_channel(channel)
+          @nats_subs[channel].unsubscribe
+          super
+        end
+      end
+
+      private
+
+      # Returns the channel name, including channel_prefix specified in cable.yml
+      def channel_with_prefix(channel)
+        [@server.config.cable[:channel_prefix], channel].compact.join('.')
+      end
+
+      def new_subscriber_map
+        Listener.new(@nats_conn)
+      end
+    end
+  end
+end

data/lib/actioncable_nats_adapter/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ActioncableNatsAdapter
+  VERSION = '0.1.0'
+end

data/lib/actioncable_nats_adapter.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative 'actioncable_nats_adapter/version'
+
+module ActioncableNatsAdapter
+  class Error < StandardError; end
+end

data/sig/actioncable_nats_adapter.rbs

@@ -0,0 +1,4 @@
+module ActioncableNatsAdapter
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: actioncable_nats_adapter
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Grant Gongaware
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-08-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nats-pure
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: actioncable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6'
+description: Use nats.io as the pub/sub backend for ActionCable
+email:
+- grant@telmate.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- lib/action_cable/subscription_adapter/nats.rb
+- lib/actioncable_nats_adapter.rb
+- lib/actioncable_nats_adapter/version.rb
+- sig/actioncable_nats_adapter.rbs
+homepage: https://github.com/telmate/actioncable_nats_adapter
+licenses: []
+metadata:
+  homepage_uri: https://github.com/telmate/actioncable_nats_adapter
+  source_code_uri: https://github.com/telmate/actioncable_nats_adapter
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.9
+signing_key:
+specification_version: 4
+summary: ActionCable subscription adapter in Rails 6+ with NATs.
+test_files: []