async-matrix-bridge 2.0.0 → 3.0.0

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

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+# Released under the Apache License, Version 2.0.
+# Copyright, 2026, by General Intelligence Systems.
+
+require "async/matrix"
+require "async/rest/wrapper/json"
+
+module Async
+  module Matrix
+    module Bridge
+      # What the homeserver pushed, which is to a service what a sync batch is to a client.
+      #
+      # A representation is an instance of a resource at a point in time, and that is what this is:
+      # the difference is that it was handed over rather than fetched, so the value is given at
+      # construction and never read from a response.
+      #
+      # Being a representation is what makes it match: {Async::Matrix::Representation} already
+      # deconstructs to its own document, so a whole transaction can be a pattern.
+      class Transaction < Async::Matrix::Representation
+        # Read one from a request, parsing it with the wrapper a response would have used.
+        #
+        # @parameter request [Protocol::HTTP::Request] the request the homeserver made.
+        # @parameter txn_id [String] the transaction, which the homeserver numbers.
+        # @parameter version [String] the specification version to type the events as.
+        # @returns [Transaction] the transaction it carried.
+        def self.for(request, txn_id, version: Async::Matrix::LATEST)
+          value = ::Async::REST::Wrapper::JSON::Parser.new(request.body).join
+
+          self.new(nil, value: value, metadata: request.headers, txn_id: txn_id, version: version)
+        end
+
+        # @parameter resource [Nil] nothing: there is no resource to fetch this again from.
+        # @parameter value [Hash] the document the homeserver sent.
+        # @parameter metadata [Protocol::HTTP::Headers] the headers it arrived with.
+        # @parameter txn_id [String] the transaction, which the homeserver numbers.
+        # @parameter version [String] the specification version to type the events as.
+        def initialize(resource, value:, metadata: {}, txn_id: nil, version: Async::Matrix::LATEST)
+          super(resource, value: value, metadata: metadata)
+
+          @txn_id = txn_id
+          @events = Async::Matrix::Events.registry(version)
+        end
+
+        # @attribute [String] the transaction, which makes handling it twice unnecessary.
+        attr :txn_id
+
+        # The timeline, typed as the registry describes it.
+        #
+        # @returns [Array(Async::Matrix::Events::Envelope)] the events.
+        def events
+          (self.value[:events] || []).map{|value| @events.wrap(value)}
+        end
+
+        # Read receipts, typing and presence, which arrive only when the registration asked for them.
+        #
+        # @returns [Array(Async::Matrix::Events::Envelope)] the events.
+        def ephemeral
+          (self.value[:ephemeral] || []).map{|value| @events.wrap(value)}
+        end
+
+        # @returns [Boolean] whether this transaction carried nothing at all.
+        def empty?
+          self.events.empty? and self.ephemeral.empty?
+        end
+
+        # The events of each room, in the order they were sent.
+        #
+        # Events in one room are ordered and must stay so, because a message can depend on the
+        # membership before it and a key on the session before that. Different rooms are independent,
+        # so a caller may handle them at the same time.
+        #
+        # @yields {|room_id, events| ...}
+        #   @parameter room_id [String] the room.
+        #   @parameter events [Array(Async::Matrix::Events::Envelope)] its events, in order.
+        def each_room
+          if block_given?
+            self.events.group_by(&:room_id).each do |room_id, events|
+              yield room_id, events
+            end
+          else
+            to_enum(:each_room)
+          end
+        end
+
+        def inspect = "\#<#{self.class} #{@txn_id} #{self.events.size} event(s)>"
+      end
+    end
+  end
+end

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

@@ -41,42 +41,3 @@ module Async
     end
   end
 end
-
-__END__
-  describe "Async::Matrix::Bridge::TransactionStore" do
-    it "tracks seen transaction IDs" do
-      store = Async::Matrix::Bridge::TransactionStore.new
-      store.seen?("txn1").should == false
-      store.mark_seen("txn1")
-      store.seen?("txn1").should == true
-    end
-
-    it "reports size" do
-      store = Async::Matrix::Bridge::TransactionStore.new
-      store.size.should == 0
-      store.mark_seen("a")
-      store.mark_seen("b")
-      store.size.should == 2
-    end
-
-    it "prunes oldest entries when capacity is reached" do
-      store = Async::Matrix::Bridge::TransactionStore.new(capacity: 4)
-      store.mark_seen("a")
-      store.mark_seen("b")
-      store.mark_seen("c")
-      store.mark_seen("d")
-      # This triggers prune — drops oldest half (a, b)
-      store.mark_seen("e")
-      store.seen?("a").should == false
-      store.seen?("b").should == false
-      store.seen?("d").should == true
-      store.seen?("e").should == true
-    end
-
-    it "does not prune below capacity" do
-      store = Async::Matrix::Bridge::TransactionStore.new(capacity: 10)
-      5.times { |i| store.mark_seen("txn#{i}") }
-      store.size.should == 5
-      store.seen?("txn0").should == true
-    end
-  end

data/lib/async/matrix/bridge/version.rb

@@ -6,7 +6,7 @@
 module Async
   module Matrix
     module Bridge
-      VERSION = "2.0.0"
+      VERSION = "3.0.0"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-matrix-bridge
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Nathan Kidd
@@ -29,42 +29,34 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: json_schemer
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '4.0'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: 4.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '4.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.1
 - !ruby/object:Gem::Dependency
-  name: scampi
+  name: protocol-http
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
+        version: '0.72'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '0.72'
 - !ruby/object:Gem::Dependency
   name: logger
   requirement: !ruby/object:Gem::Requirement
@@ -102,13 +94,14 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
 - lib/async/matrix/bridge.rb
-- lib/async/matrix/bridge/endpoint.rb
+- lib/async/matrix/bridge/puppet.rb
 - lib/async/matrix/bridge/registration.rb
-- lib/async/matrix/bridge/registration/schema/namespace_list.json
-- lib/async/matrix/bridge/registration/schema/registration.json
+- lib/async/matrix/bridge/service.rb
+- lib/async/matrix/bridge/transaction.rb
 - lib/async/matrix/bridge/transaction_store.rb
 - lib/async/matrix/bridge/version.rb
 homepage: https://github.com/general-intelligence-systems/async-matrix-bridge