async-matrix 1.2.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a0c3eee197effa06e2abe173a328734d5c0e2db5c033c26a24030813d7ad69b
-  data.tar.gz: 597a3fdae49b1fdf17584bdb181067c27f3fc6e2877e56ec4607f60bff242c06
+  metadata.gz: 2b22a524df6b1dabf1a9b39a5d483f42185ffa33dea24ec714da460dee7d4350
+  data.tar.gz: 79307bffc1d8461fc9e31c8395545d5ec43181b9298f21c3a5e23179af1a66ee
 SHA512:
-  metadata.gz: d596428929e71d223463ac9bd28f78941cd9ced8e6dde5ccb9450f9c5fd7e0e527ae2953c5592a6d3ffa93b7a5557f74935a58fddee6de687d466d7540c7b426
-  data.tar.gz: 87faa2828aba3103c88feb145a0b53bb1bbfb2f05adaa795e05f7020c6cc15aa1bc81b51a260e5485b986eb2d4196b18d82e954309cdbbae2b56a99a73c1bd12
+  metadata.gz: fae7b428ac3c1f896dc01684710dd41f115551ec0bdc31719110ca0be0a352e9ce6a656b69f3805db1a5949eb1c675e1d1c2b8703ffdbedd295aea79b95d21c0
+  data.tar.gz: 959d7af1a0c7b2adab25f608e8834ff8493b7055a4bf9f4a0ba8673c6e5ab62f0320d78a6d559aa6e71c62157fae32b9db23bb18242fdebc42599925922cdbf2

data/lib/async/discord/api/path_tree.rb

@@ -3,12 +3,10 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
 require "json"
 require "pathname"
 require "uri"
-require "async/discord"
-require "async/matrix"
+require_relative "../../matrix/api/path_tree"
 
 module Async
   module Discord
@@ -75,7 +73,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Discord::Api::PathTree" do
     it "loads from the Discord OpenAPI spec" do
       tree = Async::Discord::Api::PathTree.load
@@ -127,4 +125,3 @@ test do
       result[:operation_id].should == "testAction"
     end
   end
-end

data/lib/async/discord/api.rb

@@ -3,10 +3,6 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/discord"
-require "async/matrix"
-
 module Async
   module Discord
     # Runtime-generated Discord HTTP API built from the official OpenAPI spec.
@@ -72,7 +68,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Discord::Api::Gateway" do
     # Stub client that records calls instead of making HTTP requests.
     StubDiscordClient = Struct.new(:calls) do
@@ -153,4 +149,3 @@ test do
       lambda { gw.totally.bogus.endpoint.get }.should.raise Async::Matrix::InvalidEndpointError
     end
   end
-end

data/lib/async/discord/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/discord"
 require "json"
 require "erb"
 require "console"
@@ -223,7 +221,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Discord::Client" do
     it "sets authorization header with Bot prefix" do
       client = Async::Discord::Client.new(token: "test_token_123")
@@ -283,4 +281,3 @@ test do
       lambda { client.close }.should.not.raise
     end
   end
-end

data/lib/async/discord/error.rb

@@ -3,9 +3,6 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/discord"
-
 module Async
   module Discord
     # Base error for all Discord API errors.
@@ -39,7 +36,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Discord::Error" do
     it "stores code and message" do
       err = Async::Discord::Error.new("DISCORD_ERROR", "something broke")
@@ -85,4 +82,3 @@ test do
   it "GatewayError inherits from Error" do
     Async::Discord::GatewayError.new("GW", "disconnected").should.be.kind_of Async::Discord::Error
   end
-end

data/lib/async/discord/gateway.rb

@@ -3,13 +3,11 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
 require "async"
 require "async/http/endpoint"
 require "async/websocket/client"
 require "json"
 require "console"
-require "async/discord"
 
 module Async
   module Discord
@@ -269,7 +267,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Discord::Gateway" do
     it "initializes with token and intents" do
       gw = Async::Discord::Gateway.new(token: "test_token", intents: 0x30001)
@@ -359,4 +357,3 @@ test do
       gw.instance_variable_get(:@gateway_url).should == "wss://custom.gateway.example.com"
     end
   end
-end

data/lib/async/discord.rb

@@ -4,7 +4,6 @@
 # Copyright, 2026, by General Intelligence Systems.
 
 require "async/http"
-require "scampi"
 
 module Async
   module Discord

data/lib/async/matrix/api/chain.rb

@@ -3,8 +3,6 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/matrix"
 require "string_builder"
 require "erb"
 
@@ -231,7 +229,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Api::Chain" do
     def make_tree
       tree = Async::Matrix::Api::PathTree.new
@@ -578,4 +576,3 @@ test do
       client.calls.last.last[:max_retries].should.be.nil
     end
   end
-end

data/lib/async/matrix/api/concat.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 Api
@@ -63,7 +60,7 @@ module Async
   end
 end
 
-test do
+__END__
   require "string_builder"
 
   describe "Async::Matrix::Api::Concat" do
@@ -102,4 +99,3 @@ test do
       segments.should == %w[account whoami]
     end
   end
-end

data/lib/async/matrix/api/path_tree.rb

@@ -3,8 +3,6 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
-require "async/matrix"
 require "yaml"
 require "pathname"
 
@@ -130,7 +128,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Api::PathTree" do
     def make_tree
       tree = Async::Matrix::Api::PathTree.new
@@ -205,4 +203,3 @@ test do
       result[:valid].should == false
     end
   end
-end

data/lib/async/matrix/api.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
     # Runtime-generated Matrix Client-Server API built from official OpenAPI schemas.
@@ -74,7 +71,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::Api::Gateway" do
     # Stub client that records calls instead of making HTTP requests.
     StubClient = Struct.new(:calls) do
@@ -201,4 +198,3 @@ test do
       client.calls[1][1].should == "/_matrix/client/v3/createRoom"
     end
   end
-end

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

@@ -3,18 +3,16 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
 require "console"
-require "async/matrix"
 
 module Async
   module Matrix
     module ApplicationService
       # DSL wrapper that pairs a Client with event handlers.
       #
-      # A Bot produces handler objects that conform to the Dispatcher's
+      # A Bot produces handler objects that conform to the TransactionHandler's
       # duck-type contract (#event_types, #call). Register a bot on a
-      # Server (or Dispatcher) the same way you would register a plain handler.
+      # Server (or TransactionHandler) the same way you would register a plain handler.
       #
       #   bot = Bot.new(client) do
       #     on "m.room.member" do |event|
@@ -61,7 +59,7 @@ module Async
         end
 
         # Internal handler object produced by the #on DSL method.
-        # Conforms to the Dispatcher duck-type: #event_types, #call.
+        # Conforms to the TransactionHandler duck-type: #event_types, #call.
         class Handler
           attr_reader :event_types
 
@@ -128,7 +126,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::ApplicationService::Bot" do
     def make_config
       Async::Matrix::ApplicationService::Config.new({
@@ -232,4 +230,3 @@ test do
       }.should.raise(ArgumentError)
     end
   end
-end

data/lib/async/matrix/application_service/config/vivify.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
@@ -60,7 +57,7 @@ module Async
   end
 end
 
-test do
+__END__
   V = Async::Matrix::ApplicationService::Config::Vivify
 
   describe "Vivify" do
@@ -110,4 +107,3 @@ test do
       result.b.should == true
     end
   end
-end

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

@@ -3,12 +3,10 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
 require "forwardable"
 require "json_schemer"
 require "pathname"
 require "yaml"
-require "async/matrix"
 require_relative "config/vivify"
 
 module Async
@@ -89,7 +87,7 @@ module Async
   end
 end
 
-test do
+__END__
   require "tempfile"
 
   describe "Async::Matrix::ApplicationService::Config" do
@@ -225,4 +223,3 @@ test do
       config.bridge.permissions[:"@admin:localhost"].should == "admin"
     end
   end
-end

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

@@ -3,9 +3,7 @@
 # Released under the Apache License, Version 2.0.
 # Copyright, 2026, by General Intelligence Systems.
 
-require "bundler/setup"
 require "console"
-require "async/matrix"
 
 module Async
   module Matrix
@@ -16,14 +14,38 @@ module Async
       # When an event arrives, the dispatcher finds all matching handlers
       # and calls them. Errors in one handler do not prevent others from running.
       class Dispatcher
-        def initialize
-          @handlers = Hash.new { |h, k| h[k] = [] }
+        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)
-          handler.event_types.each do |type|
-            @handlers[type] << handler
-            Console.info(self) { "Registered #{handler.class.name} for #{type}" }
+          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 dispatcher 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
 
@@ -59,7 +81,7 @@ module Async
   end
 end
 
-test do
+__END__
   describe "Async::Matrix::ApplicationService::Dispatcher" do
     it "registers and dispatches to handlers" do
       received = []
@@ -125,5 +147,39 @@ test do
       })
       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] }
+
+      dispatcher = Async::Matrix::ApplicationService::Dispatcher.new
+      dispatcher.register(bot)
+      dispatcher.handler_count.should == 1
+
+      dispatcher.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 }
+
+      dispatcher = Async::Matrix::ApplicationService::Dispatcher.new
+      dispatcher.register(handler)
+
+      body = {"events" => [{"type" => "m.room.message", "content" => {"body" => "hi"}}]}
+
+      dispatcher.receive_transaction("txn1", body).should == :processed
+      dispatcher.receive_transaction("txn1", body).should == :duplicate
+      received.length.should == 1
+    end
   end
-end

data/lib/async/matrix/application_service/error_response.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::ErrorResponse" do
     it "parses errcode and error" do
       resp = Async::Matrix::ApplicationService::ErrorResponse.new({
@@ -38,4 +35,3 @@ test do
       resp.error.should.be.nil
     end
   end
-end

data/lib/async/matrix/application_service/event.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
@@ -115,7 +112,7 @@ module Async
 	end
 end
 
-test do
+__END__
 	describe "Async::Matrix::ApplicationService::Content" do
 		it "parses msgtype, body, and membership" do
 			content = Async::Matrix::ApplicationService::Content.new({
@@ -286,4 +283,3 @@ test do
 			props.should.include "membership"
 		end
 	end
-end