async-matrix 1.2.0 → 2.0.0

data/lib/async/matrix/application_service/transaction.rb

@@ -3,9 +3,6 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/matrix"
-
 module Async
   module Matrix
     module ApplicationService
@@ -21,7 +18,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::ApplicationService::Transaction" do
     it "wraps events array" do
       txn = Async::Matrix::ApplicationService::Transaction.new({
@@ -67,4 +64,3 @@ test do
       txn.ephemeral.should.be.empty
     end
   end
-end

data/lib/async/matrix/application_service/transaction_handler.rb

@@ -0,0 +1,185 @@
+# frozen_string_literal: true
+
+# Released under the Apache License, Version 2.0.
+# Copyright, 2026, by General Intelligence Systems.
+
+require "console"
+
+module Async
+  module Matrix
+    module ApplicationService
+      # Routes incoming Matrix events to registered handler objects.
+      #
+      # Each handler declares the event types it handles via `#event_types`.
+      # When an event arrives, the transaction_handler finds all matching handlers
+      # and calls them. Errors in one handler do not prevent others from running.
+      class TransactionHandler
+        def initialize(txn_store: TransactionStore.new)
+          @handlers  = Hash.new { |h, k| h[k] = [] }
+          @txn_store = txn_store
+        end
+
+        # Register a Bot (responds to #handlers) or a plain handler (responds
+        # to #event_types and #call). Bots are expanded into their handlers.
+        def register(handler)
+          if handler.respond_to?(:handlers)
+            handler.handlers.each { |h| register(h) }
+          else
+            handler.event_types.each do |type|
+              @handlers[type] << handler
+              Console.info(self) { "Registered #{handler.class.name} for #{type}" }
+            end
+          end
+        end
+
+        # Idempotently process a homeserver transaction. Duplicate transaction
+        # IDs (already seen) are skipped. Returns :processed or :duplicate.
+        #
+        # The idempotency store lives here rather than in the HTTP layer because
+        # the Grape server is stateless across requests — the transaction_handler is the
+        # stable, long-lived object.
+        def receive_transaction(txn_id, body)
+          if @txn_store.seen?(txn_id)
+            Console.debug(self) { "Duplicate transaction #{txn_id} — skipping" }
+            :duplicate
+          else
+            dispatch_transaction(body)
+            @txn_store.mark_seen(txn_id)
+            :processed
+          end
+        end
+
+        def dispatch_transaction(body)
+          Transaction.new(body).then do |txn|
+            txn.events.each    { |event| dispatch(event) }
+            txn.ephemeral.each { |event| dispatch(event) }
+          end
+        end
+
+          def dispatch(event)
+            type     = event.type
+            handlers = @handlers[type]
+
+            if handlers.empty?
+              Console.debug(self) { "No handler for event type: #{type}" }
+            else
+              handlers.each do |handler|
+                begin
+                  handler.call(event)
+                rescue => e
+                  Console.error(self) { "Handler #{handler.class.name} raised #{e.class}: #{e.message}" }
+                end
+              end
+            end
+          end
+
+          def handler_count
+            @handlers.values.flatten.size
+          end
+      end
+    end
+  end
+end
+
+__END__
+  describe "Async::Matrix::ApplicationService::TransactionHandler" do
+    it "registers and dispatches to handlers" do
+      received = []
+      handler = Object.new
+      handler.define_singleton_method(:event_types) { ["m.room.message"] }
+      handler.define_singleton_method(:call) { |event| received << event }
+
+      transaction_handler = Async::Matrix::ApplicationService::TransactionHandler.new
+      transaction_handler.register(handler)
+      transaction_handler.handler_count.should == 1
+
+      event = Async::Matrix::ApplicationService::Event.new({
+        "type" => "m.room.message",
+        "content" => {"body" => "hi"}
+      })
+      transaction_handler.dispatch(event)
+      received.length.should == 1
+      received.first.content.body.should == "hi"
+    end
+
+    it "ignores events with no matching handler" do
+      transaction_handler = Async::Matrix::ApplicationService::TransactionHandler.new
+      event = Async::Matrix::ApplicationService::Event.new({"type" => "m.unknown"})
+      lambda { transaction_handler.dispatch(event) }.should.not.raise
+    end
+
+    it "continues dispatching when a handler raises" do
+      results = []
+      bad_handler = Object.new
+      bad_handler.define_singleton_method(:event_types) { ["m.room.message"] }
+      bad_handler.define_singleton_method(:call) { |_| raise "boom" }
+
+      good_handler = Object.new
+      good_handler.define_singleton_method(:event_types) { ["m.room.message"] }
+      good_handler.define_singleton_method(:call) { |e| results << e }
+
+      transaction_handler = Async::Matrix::ApplicationService::TransactionHandler.new
+      transaction_handler.register(bad_handler)
+      transaction_handler.register(good_handler)
+
+      event = Async::Matrix::ApplicationService::Event.new({
+        "type" => "m.room.message",
+        "content" => {"body" => "test"}
+      })
+      transaction_handler.dispatch(event)
+      results.length.should == 1
+    end
+
+    it "dispatches a full transaction" do
+      received = []
+      handler = Object.new
+      handler.define_singleton_method(:event_types) { ["m.room.message"] }
+      handler.define_singleton_method(:call) { |e| received << e }
+
+      transaction_handler = Async::Matrix::ApplicationService::TransactionHandler.new
+      transaction_handler.register(handler)
+
+      transaction_handler.dispatch_transaction({
+        "events" => [
+          {"type" => "m.room.message", "content" => {"body" => "one"}},
+          {"type" => "m.room.message", "content" => {"body" => "two"}}
+        ]
+      })
+      received.length.should == 2
+    end
+
+    it "registers a bot (object responding to #handlers)" do
+      received = []
+      handler = Object.new
+      handler.define_singleton_method(:event_types) { ["m.room.message"] }
+      handler.define_singleton_method(:call) { |e| received << e }
+
+      bot = Object.new
+      bot.define_singleton_method(:handlers) { [handler] }
+
+      transaction_handler = Async::Matrix::ApplicationService::TransactionHandler.new
+      transaction_handler.register(bot)
+      transaction_handler.handler_count.should == 1
+
+      transaction_handler.dispatch_transaction({
+        "events" => [{"type" => "m.room.message", "content" => {"body" => "hi"}}]
+      })
+      received.length.should == 1
+    end
+
+    it "processes a transaction idempotently via receive_transaction" do
+      received = []
+      handler = Object.new
+      handler.define_singleton_method(:event_types) { ["m.room.message"] }
+      handler.define_singleton_method(:call) { |e| received << e }
+
+      transaction_handler = Async::Matrix::ApplicationService::TransactionHandler.new
+      transaction_handler.register(handler)
+
+      body = {"events" => [{"type" => "m.room.message", "content" => {"body" => "hi"}}]}
+
+      transaction_handler.receive_transaction("txn1", body).should == :processed
+      transaction_handler.receive_transaction("txn1", body).should == :duplicate
+      received.length.should == 1
+    end
+  end

data/lib/async/matrix/application_service/transaction_store.rb

@@ -3,9 +3,6 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/matrix"
-
 module Async
   module Matrix
     module ApplicationService
@@ -43,7 +40,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::ApplicationService::TransactionStore" do
     it "tracks seen transaction IDs" do
       store = Async::Matrix::ApplicationService::TransactionStore.new
@@ -81,4 +78,3 @@ test do
       store.seen?("txn0").should == true
     end
   end
-end

data/lib/async/matrix/bridge/discord/db/connection.rb

@@ -3,7 +3,6 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
 require "sequel"
 
 module Async
@@ -80,7 +79,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Bridge::Discord::DB::Connection" do
     it "connects to an in-memory SQLite database" do
       config = Object.new
@@ -140,4 +139,3 @@ test do
       }.should.raise(ArgumentError)
     end
   end
-end

data/lib/async/matrix/bridge/discord/db/file.rb

@@ -3,8 +3,7 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/matrix"
+require_relative "schema"
 
 module Async
   module Matrix
@@ -44,7 +43,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Bridge::Discord::DB::CachedFile" do
     def setup_db
       db = Sequel.sqlite
@@ -117,4 +116,3 @@ test do
       db.disconnect
     end
   end
-end

data/lib/async/matrix/bridge/discord/db/guild.rb

@@ -3,8 +3,7 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/matrix"
+require_relative "schema"
 
 module Async
   module Matrix
@@ -54,7 +53,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Bridge::Discord::DB::Guild" do
     def setup_db
       db = Sequel.sqlite
@@ -119,4 +118,3 @@ test do
       db.disconnect
     end
   end
-end

data/lib/async/matrix/bridge/discord/db/message.rb

@@ -3,8 +3,7 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/matrix"
+require_relative "schema"
 
 module Async
   module Matrix
@@ -57,7 +56,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Bridge::Discord::DB::Message" do
     def setup_db
       db = Sequel.sqlite
@@ -159,4 +158,3 @@ test do
       db.disconnect
     end
   end
-end

data/lib/async/matrix/bridge/discord/db/portal.rb

@@ -3,8 +3,7 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/matrix"
+require_relative "schema"
 
 module Async
   module Matrix
@@ -55,7 +54,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Bridge::Discord::DB::Portal" do
     def setup_db
       db = Sequel.sqlite
@@ -149,4 +148,3 @@ test do
       db.disconnect
     end
   end
-end

data/lib/async/matrix/bridge/discord/db/puppet.rb

@@ -3,8 +3,7 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/matrix"
+require_relative "schema"
 
 module Async
   module Matrix
@@ -40,7 +39,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Bridge::Discord::DB::Puppet" do
     def setup_db
       db = Sequel.sqlite
@@ -127,4 +126,3 @@ test do
       db.disconnect
     end
   end
-end

data/lib/async/matrix/bridge/discord/db/reaction.rb

@@ -3,8 +3,7 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/matrix"
+require_relative "schema"
 
 module Async
   module Matrix
@@ -60,7 +59,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Bridge::Discord::DB::Reaction" do
     def setup_db
       db = Sequel.sqlite
@@ -164,4 +163,3 @@ test do
       db.disconnect
     end
   end
-end

data/lib/async/matrix/bridge/discord/db/schema.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Released under the Apache License, Version 2.0.
+# Copyright, 2026, by General Intelligence Systems.
+
+require "sequel"
+
+# Sequel::Model requires a database connection at subclass definition time.
+# Set a placeholder in-memory SQLite so models can be defined at load time.
+# The real database is bound later via DB.connect / DB.bind_models.
+#
+# require_valid_table = false suppresses the column introspection that Sequel
+# normally does on inheritance — critical because the placeholder DB has no
+# tables.
+unless Sequel::Model.instance_variable_get(:@db)
+  Sequel::Model.db = Sequel.sqlite
+  Sequel::Model.require_valid_table = false
+end

data/lib/async/matrix/bridge/discord/db/user.rb

@@ -3,8 +3,7 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/matrix"
+require_relative "schema"
 
 module Async
   module Matrix
@@ -37,7 +36,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Bridge::Discord::DB::User" do
     def setup_db
       db = Sequel.sqlite
@@ -111,4 +110,3 @@ test do
       db.disconnect
     end
   end
-end

data/lib/async/matrix/bridge/discord/db.rb

@@ -3,22 +3,21 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
 require "sequel"
 require "sequel/extensions/migration"
-require "async/matrix"
-
-# Sequel::Model requires a database connection at subclass definition time.
-# Set a placeholder in-memory SQLite so models can be defined at require
-# time. The real database is bound later via DB.connect.
-#
-# require_valid_table = false suppresses the column introspection that
-# Sequel normally does on inherited — critical because the placeholder
-# DB has no tables.
-unless Sequel::Model.instance_variable_get(:@db)
-  Sequel::Model.db = Sequel.sqlite
-  Sequel::Model.require_valid_table = false
-end
+
+# The Discord bridge's database layer. Requiring this file loads the whole
+# subsystem: the Sequel placeholder (schema), the connection helper, and every
+# model class, so DB.connect can bind them all.
+require_relative "db/schema"
+require_relative "db/connection"
+require_relative "db/user"
+require_relative "db/guild"
+require_relative "db/portal"
+require_relative "db/puppet"
+require_relative "db/message"
+require_relative "db/reaction"
+require_relative "db/file"
 
 module Async
   module Matrix
@@ -75,7 +74,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Bridge::Discord::DB" do
     it "connects, migrates, and binds models from config" do
       database_config = Object.new
@@ -137,4 +136,3 @@ test do
       db.disconnect
     end
   end
-end

data/lib/async/matrix/client.rb

@@ -3,9 +3,7 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
 require "async/http/internet"
-require "async/matrix"
 require "json"
 require "erb"
 require "console"
@@ -323,7 +321,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Client" do
     def make_config
       Async::Matrix::ApplicationService::Config.new({
@@ -934,4 +932,3 @@ test do
       result.should.be.nil
     end
   end
-end

data/lib/async/matrix/connection.rb

@@ -3,9 +3,7 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
 require "async/http"
-require "async/matrix"
 
 module Async
   module Matrix
@@ -15,8 +13,7 @@ module Async
   end
 end
 
-test do
+__END__
   it "includes Async::HTTP::Protocol::HTTP2::Connection" do
     Async::Matrix::Connection.ancestors.should.include Async::HTTP::Protocol::HTTP2::Connection
   end
-end

data/lib/async/matrix/double_puppet_client.rb

@@ -3,8 +3,7 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/matrix"
+require_relative "client"
 
 module Async
   module Matrix
@@ -27,7 +26,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::DoublePuppetClient" do
     def make_config
       Async::Matrix::ApplicationService::Config.new({
@@ -81,4 +80,3 @@ test do
       puppet.should.be.kind_of Async::Matrix::Client
     end
   end
-end

data/lib/async/matrix/e2ee.rb

@@ -27,7 +27,7 @@ end
 # rake-compiler installs the shared object alongside this file.
 require_relative "async_matrix_e2ee"
 
-test do
+__END__
   describe "Async::Matrix::E2EE" do
     it "exposes account identity keys as base64" do
       account = Async::Matrix::E2EE::Account.new
@@ -82,4 +82,3 @@ test do
       restored.session_id.should == group.session_id
     end
   end
-end

data/lib/async/matrix/endpoint.rb

@@ -3,10 +3,8 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
 require "json"
 require "async/http"
-require "async/matrix"
 
 module Async
   module Matrix
@@ -38,7 +36,7 @@ module Async
   end
 end
 
-test do
+__END__
   it "defines the WELL_KNOWN constant" do
     Async::Matrix::Endpoint::WELL_KNOWN.should == "/.well-known/matrix/client"
   end
@@ -57,4 +55,3 @@ test do
       endpoint.to_s.should =~ /nonexistent\.invalid/
     end.wait
   end
-end

data/lib/async/matrix/error.rb

@@ -3,8 +3,6 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-
 module Async
   module Matrix
     class Error < StandardError
@@ -26,7 +24,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Error" do
     it "stores errcode and message" do
       err = Async::Matrix::Error.new("M_UNKNOWN", "something broke")
@@ -67,4 +65,3 @@ test do
   it "ResponseTooLargeError inherits from Error" do
     Async::Matrix::ResponseTooLargeError.new("M_TOO_LARGE", "too big").should.be.kind_of Async::Matrix::Error
   end
-end

data/lib/async/matrix/media_client.rb

@@ -3,9 +3,7 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
 require "async/http/internet"
-require "async/matrix"
 require "json"
 require "console"
 
@@ -150,7 +148,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::MediaClient" do
     def make_config
       Async::Matrix::ApplicationService::Config.new({
@@ -170,4 +168,3 @@ test do
       lambda { client.close }.should.not.raise
     end
   end
-end

data/lib/async/matrix/notifier.rb

@@ -3,10 +3,8 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
 require "async"
 require "async/condition"
-require "async/matrix"
 
 module Async
   module Matrix
@@ -57,7 +55,7 @@ module Async
   end
 end
 
-test do
+__END__
   it "can be instantiated" do
     notifier = Async::Matrix::Notifier.new
     notifier.should.be.kind_of Async::Matrix::Notifier
@@ -104,4 +102,3 @@ test do
     end.wait
     result.should == true
   end
-end

data/lib/async/matrix/schema/registry.rb

@@ -234,7 +234,7 @@ module Async
 	end
 end
 
-test do
+__END__
 	describe "Async::Matrix::Schema::Registry" do
 		it "loads schemas from disk" do
 			Async::Matrix::Schema::Registry.instance.size.should.be > 0
@@ -352,4 +352,3 @@ test do
 			Async::Matrix::Schema::Registry.instance.validate(event).should == []
 		end
 	end
-end