async-matrix 0.1.0

data/lib/async/matrix/error.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+# Released under the Apache License, Version 2.0.
+# Copyright, 2026, by General Intelligence Systems.
+
+require "bundler/setup"
+
+module Async
+	module Matrix
+		class Error < StandardError
+			attr_reader :errcode, :status
+
+			def initialize(errcode, message, status: nil)
+				@errcode = errcode
+				@status = status
+				super(message)
+			end
+		end
+
+		class NotFoundError < Error; end
+		class BadJsonError < Error; end
+		class AuthError < Error; end
+		class HomeserverError < Error; end
+	end
+end
+
+test do
+	describe "Async::Matrix::Error" do
+		it "stores errcode and message" do
+			err = Async::Matrix::Error.new("M_UNKNOWN", "something broke")
+			err.errcode.should == "M_UNKNOWN"
+			err.message.should == "something broke"
+		end
+
+		it "stores optional status" do
+			err = Async::Matrix::Error.new("M_UNKNOWN", "bad", status: 400)
+			err.status.should == 400
+		end
+
+		it "defaults status to nil" do
+			Async::Matrix::Error.new("M_UNKNOWN", "bad").status.should.be.nil
+		end
+
+		it "is a StandardError" do
+			Async::Matrix::Error.new("M_UNKNOWN", "bad").should.be.kind_of StandardError
+		end
+	end
+
+	it "NotFoundError inherits from Error" do
+		Async::Matrix::NotFoundError.new("M_NOT_FOUND", "gone").should.be.kind_of Async::Matrix::Error
+	end
+
+	it "BadJsonError inherits from Error" do
+		Async::Matrix::BadJsonError.new("M_BAD_JSON", "invalid").should.be.kind_of Async::Matrix::Error
+	end
+
+	it "AuthError inherits from Error" do
+		Async::Matrix::AuthError.new("M_FORBIDDEN", "denied").should.be.kind_of Async::Matrix::Error
+	end
+
+	it "HomeserverError inherits from Error" do
+		Async::Matrix::HomeserverError.new("M_UNKNOWN", "upstream").should.be.kind_of Async::Matrix::Error
+	end
+end

data/lib/async/matrix/notifier.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+# Released under the Apache License, Version 2.0.
+# Copyright, 2026, by General Intelligence Systems.
+
+require "bundler/setup"
+require "async"
+require "async/condition"
+
+module Async
+	module Matrix
+		# Waitable event bus. Signal it when events arrive;
+		# /sync handlers wait on it with a timeout.
+		#
+		#   notifier = Async::Matrix::Notifier.new
+		#
+		#   # In a /sync handler fiber (blocks until signalled or timeout):
+		#   notifier.wait(timeout: 30) { check_for_events() }
+		#
+		#   # After persisting an event (wakes all waiting fibers):
+		#   notifier.signal
+		#
+		class Notifier
+			def initialize
+				@condition = Async::Condition.new
+			end
+
+			# Wake all waiting fibers.
+			def signal
+				@condition.signal
+			end
+
+			# Block up to +timeout+ seconds. Yields to check for data after
+			# each wake-up; returns the block's value as soon as it is truthy.
+			# Returns the block's value (possibly nil/false) when time runs out.
+			def wait(timeout: 30, &block)
+				deadline = Time.now + timeout
+
+				loop do
+					result = yield
+					return result if result
+
+					remaining = deadline - Time.now
+					return result if remaining <= 0
+
+					begin
+						Async::Task.current.with_timeout(remaining) do
+							@condition.wait
+						end
+					rescue Async::TimeoutError
+						return yield
+					end
+				end
+			end
+		end
+	end
+end
+
+test do
+	it "can be instantiated" do
+		notifier = Async::Matrix::Notifier.new
+		notifier.should.be.kind_of Async::Matrix::Notifier
+	end
+
+	it "responds to #signal" do
+		Async::Matrix::Notifier.new.should.respond_to :signal
+	end
+
+	it "responds to #wait" do
+		Async::Matrix::Notifier.new.should.respond_to :wait
+	end
+
+	it "returns truthy block value immediately without waiting" do
+		Async do
+			notifier = Async::Matrix::Notifier.new
+			result = notifier.wait(timeout: 1) { :data }
+			result.should == :data
+		end.wait
+	end
+
+	it "returns falsy block value on timeout" do
+		Async do
+			notifier = Async::Matrix::Notifier.new
+			result = notifier.wait(timeout: 0.05) { nil }
+			result.should.be.nil
+		end.wait
+	end
+
+	it "wakes waiting fibers on signal" do
+		result = nil
+		Async do |task|
+			notifier = Async::Matrix::Notifier.new
+			signalled = false
+
+			task.async do
+				result = notifier.wait(timeout: 5) { signalled }
+			end
+
+			task.async do
+				signalled = true
+				notifier.signal
+			end
+		end.wait
+		result.should == true
+	end
+end

data/lib/async/matrix/server.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Released under the Apache License, Version 2.0.
+# Copyright, 2026, by General Intelligence Systems.
+
+require "bundler/setup"
+require "async/http"
+
+module Async
+	module Matrix
+		class Server < Async::HTTP::Protocol::HTTP2::Server
+		end
+	end
+end
+
+test do
+	it "inherits from Async::HTTP::Protocol::HTTP2::Server" do
+		Async::Matrix::Server.ancestors.should.include Async::HTTP::Protocol::HTTP2::Server
+	end
+end

data/lib/async/matrix/stream.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Released under the Apache License, Version 2.0.
+ Copyright, 2026, by General Intelligence Systems.
+
+require "bundler/setup"
+require "async/http"
+
+module Async
+	module Matrix
+		class Stream < Async::HTTP::Protocol::HTTP2::Stream
+		end
+	end
+end
+
+test do
+	it "inherits from Async::HTTP::Protocol::HTTP2::Stream" do
+		Async::Matrix::Stream.ancestors.should.include Async::HTTP::Protocol::HTTP2::Stream
+	end
+end

data/lib/async/matrix/version.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# Released under the Apache License, Version 2.0.
+# Copyright, 2026, by General Intelligence Systems.
+
+module Async
+	module Matrix
+		VERSION = "0.1.0"
+	end
+end

data/lib/async/matrix.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# Released under the Apache License, Version 2.0.
+# Copyright, 2026, by General Intelligence Systems.
+
+# @namespace
+module Async
+	# @namespace
+	module Matrix
+	end
+end
+
+Dir.glob("#{__dir__}/brute/**/*.rb").sort.each do |path|
+  require path
+end
+

data/lib/async.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# Released under the Apache License, Version 2.0.
+# Copyright, 2026, by General Intelligence Systems.
+
+require_relative "async/matrix"
+
+module Async
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification
+name: async-matrix
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nathan Kidd
+bindir: bin
+cert_chain: []
+date: 1980-01-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: async-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.69'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.69'
+- !ruby/object:Gem::Dependency
+  name: scampi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.7
+- !ruby/object:Gem::Dependency
+  name: falcon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.47'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.47'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Async-native Matrix protocol primitives built on the Socketry async ecosystem.
+  Provides well-known discovery, event notification, and application service models.
+email:
+- nathankidd@hey.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- lib/async.rb
+- lib/async/matrix.rb
+- lib/async/matrix/application_service/config.rb
+- lib/async/matrix/application_service/dispatcher.rb
+- lib/async/matrix/application_service/error_response.rb
+- lib/async/matrix/application_service/event.rb
+- lib/async/matrix/application_service/server.rb
+- lib/async/matrix/application_service/transaction.rb
+- lib/async/matrix/application_service/transaction_store.rb
+- lib/async/matrix/client.rb
+- lib/async/matrix/connection.rb
+- lib/async/matrix/endpoint.rb
+- lib/async/matrix/error.rb
+- lib/async/matrix/notifier.rb
+- lib/async/matrix/server.rb
+- lib/async/matrix/stream.rb
+- lib/async/matrix/version.rb
+homepage: https://github.com/general-intelligence-systems/async-matrix
+licenses:
+- Apache-2.0
+metadata:
+  homepage_uri: https://github.com/general-intelligence-systems/async-matrix
+  source_code_uri: https://github.com/general-intelligence-systems/async-matrix
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: An asynchronous Ruby library for the Matrix protocol.
+test_files: []