async-matrix 0.1.3 → 1.1.0

data/lib/async/matrix/bridge/discord/db/migrations/001_create_users.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+Sequel.migration do
+  change do
+    create_table(:users) do
+      String :mxid, primary_key: true
+      String :discord_id, unique: true
+      String :discord_token
+      String :management_room
+      String :space_room
+      String :dm_space_room
+    end
+  end
+end

data/lib/async/matrix/bridge/discord/db/migrations/002_create_guilds.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+Sequel.migration do
+  change do
+    create_table(:guilds) do
+      String :discord_id, primary_key: true
+      String :mxid, unique: true
+      String :name
+      String :avatar_hash
+      String :avatar_url
+      Integer :bridging_mode, default: 0, null: false
+    end
+  end
+end

data/lib/async/matrix/bridge/discord/db/migrations/003_create_portals.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+Sequel.migration do
+  change do
+    create_table(:portals) do
+      String :discord_id, null: false
+      String :receiver, null: false, default: ""
+      String :mxid, unique: true
+      String :discord_guild_id
+      String :name
+      String :topic
+      String :avatar_hash
+      String :avatar_url
+      TrueClass :encrypted, default: false, null: false
+      Integer :channel_type, default: 0, null: false
+      String :relay_webhook_id
+      String :relay_webhook_secret
+
+      primary_key [:discord_id, :receiver]
+      foreign_key [:discord_guild_id], :guilds, key: :discord_id
+    end
+  end
+end

data/lib/async/matrix/bridge/discord/db/migrations/004_create_puppets.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+Sequel.migration do
+  change do
+    create_table(:puppets) do
+      String :discord_id, primary_key: true
+      String :name
+      String :avatar_hash
+      String :avatar_url
+      String :username
+      String :global_name
+      TrueClass :is_bot, default: false, null: false
+      TrueClass :is_webhook, default: false, null: false
+      TrueClass :contact_info_set, default: false, null: false
+      String :custom_mxid
+      String :access_token
+    end
+  end
+end

data/lib/async/matrix/bridge/discord/db/migrations/005_create_messages.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+Sequel.migration do
+  change do
+    create_table(:messages) do
+      primary_key :id
+      String :discord_id, null: false
+      String :discord_attachment_id, null: false, default: ""
+      String :discord_channel_id, null: false
+      String :discord_channel_receiver, null: false, default: ""
+      String :discord_sender, null: false
+      String :mxid, null: false
+      Bignum :timestamp, null: false
+      String :discord_thread_id
+
+      unique [:discord_id, :discord_attachment_id, :discord_channel_id, :discord_channel_receiver]
+      index :mxid
+    end
+  end
+end

data/lib/async/matrix/bridge/discord/db/migrations/006_create_reactions.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+Sequel.migration do
+  change do
+    create_table(:reactions) do
+      primary_key :id
+      String :discord_message_id, null: false
+      String :discord_sender, null: false
+      String :discord_emoji_name, null: false
+      String :mxid, null: false
+      String :discord_channel_id, null: false
+      String :discord_channel_receiver, null: false, default: ""
+      String :discord_thread_id
+
+      unique [:discord_message_id, :discord_sender, :discord_emoji_name]
+      index :mxid
+    end
+  end
+end

data/lib/async/matrix/bridge/discord/db/migrations/007_create_files.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+Sequel.migration do
+  change do
+    create_table(:files) do
+      String :url, null: false
+      TrueClass :encrypted, null: false, default: false
+      String :mxc, null: false
+      String :mime_type
+      Bignum :size
+      Integer :width
+      Integer :height
+      String :decryption_info
+
+      primary_key [:url, :encrypted]
+    end
+  end
+end

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

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+# 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 Bridge
+      module Discord
+        module DB
+          # Maps a Discord channel to a Matrix room.
+          #
+          # Uses a composite primary key of (discord_id, receiver). For guild
+          # channels, receiver is an empty string. For DMs, receiver is the
+          # Discord user ID of the bridge user who owns the portal.
+          #
+          #   portal = Portal.create(discord_id: "chan123", receiver: "", mxid: "!room:x")
+          #   portal.guild      # => Guild or nil
+          #   portal.messages   # => [Message, ...]
+          #
+          class Portal < Sequel::Model
+            unrestrict_primary_key
+
+            many_to_one :guild,
+              class: "Async::Matrix::Bridge::Discord::DB::Guild",
+              key: :discord_guild_id,
+              primary_key: :discord_id
+
+            one_to_many :messages,
+              class: "Async::Matrix::Bridge::Discord::DB::Message",
+              key: [:discord_channel_id, :discord_channel_receiver],
+              primary_key: [:discord_id, :receiver]
+
+            def validate
+              super
+              errors.add(:discord_id, "cannot be empty") if discord_id.nil? || discord_id.empty?
+            end
+
+            # Is this a DM portal? (has a receiver)
+            def dm?
+              receiver && !receiver.empty?
+            end
+
+            # Is this a guild channel portal?
+            def guild_channel?
+              !dm?
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+test do
+  describe "Async::Matrix::Bridge::Discord::DB::Portal" do
+    def setup_db
+      db = Sequel.sqlite
+      Sequel::Migrator.run(db, File.join(__dir__, "migrations"))
+      db
+    end
+
+    def set_datasets(db)
+      Async::Matrix::Bridge::Discord::DB::Portal.dataset = db[:portals]
+      Async::Matrix::Bridge::Discord::DB::Guild.dataset = db[:guilds]
+      Async::Matrix::Bridge::Discord::DB::Message.dataset = db[:messages]
+    end
+
+    it "creates a guild channel portal" do
+      db = setup_db
+      set_datasets(db)
+
+      portal = Async::Matrix::Bridge::Discord::DB::Portal.create(
+        discord_id: "chan1", receiver: "", mxid: "!room:x", name: "general"
+      )
+      portal.discord_id.should == "chan1"
+      portal.receiver.should == ""
+      portal.guild_channel?.should == true
+      portal.dm?.should == false
+      db.disconnect
+    end
+
+    it "creates a DM portal with receiver" do
+      db = setup_db
+      set_datasets(db)
+
+      portal = Async::Matrix::Bridge::Discord::DB::Portal.create(
+        discord_id: "dm1", receiver: "user123", mxid: "!dm:x"
+      )
+      portal.dm?.should == true
+      portal.guild_channel?.should == false
+      db.disconnect
+    end
+
+    it "finds by composite primary key" do
+      db = setup_db
+      set_datasets(db)
+
+      Async::Matrix::Bridge::Discord::DB::Portal.create(discord_id: "c1", receiver: "")
+      Async::Matrix::Bridge::Discord::DB::Portal.create(discord_id: "c1", receiver: "u1")
+
+      found = Async::Matrix::Bridge::Discord::DB::Portal["c1", ""]
+      found.should.not.be.nil
+      found.receiver.should == ""
+
+      found2 = Async::Matrix::Bridge::Discord::DB::Portal["c1", "u1"]
+      found2.receiver.should == "u1"
+      db.disconnect
+    end
+
+    it "associates with a guild" do
+      db = setup_db
+      set_datasets(db)
+
+      guild = Async::Matrix::Bridge::Discord::DB::Guild.create(discord_id: "g_assoc", name: "Guild")
+      portal = Async::Matrix::Bridge::Discord::DB::Portal.create(
+        discord_id: "c_assoc", receiver: "", discord_guild_id: "g_assoc"
+      )
+      # Query through the db directly to avoid races with parallel tests
+      # that rebind the class-level dataset on Sequel models.
+      portal.discord_guild_id.should == "g_assoc"
+      linked_guild = db[:guilds].where(discord_id: portal.discord_guild_id).first
+      linked_guild[:discord_id].should == "g_assoc"
+      linked_portals = db[:portals].where(discord_guild_id: guild.discord_id).all
+      linked_portals.length.should == 1
+      db.disconnect
+    end
+
+    it "enforces unique mxid" do
+      db = setup_db
+      set_datasets(db)
+
+      Async::Matrix::Bridge::Discord::DB::Portal.create(discord_id: "a", receiver: "", mxid: "!r:x")
+      lambda {
+        Async::Matrix::Bridge::Discord::DB::Portal.create(discord_id: "b", receiver: "", mxid: "!r:x")
+      }.should.raise(Sequel::UniqueConstraintViolation)
+      db.disconnect
+    end
+
+    it "defaults encrypted to false" do
+      db = setup_db
+      set_datasets(db)
+
+      portal = Async::Matrix::Bridge::Discord::DB::Portal.create(discord_id: "e1", receiver: "")
+      portal.encrypted.should == false
+      db.disconnect
+    end
+  end
+end

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

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+# 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 Bridge
+      module Discord
+        module DB
+          # Maps a Discord user to a Matrix ghost user.
+          #
+          # The ghost's Matrix ID is derived from the username template in the
+          # bridge config (e.g., @discord_123456:example.com). This model
+          # tracks the Discord user's profile info for syncing to Matrix.
+          #
+          #   puppet = Puppet.create(discord_id: "123", username: "alice", name: "Alice")
+          #   puppet.is_bot?          # => false
+          #   puppet.double_puppet?   # => true  (if custom_mxid is set)
+          #
+          class Puppet < Sequel::Model
+            unrestrict_primary_key
+
+            def validate
+              super
+              errors.add(:discord_id, "cannot be empty") if discord_id.nil? || discord_id.empty?
+            end
+
+            # Is this puppet configured for double puppeting?
+            def double_puppet?
+              !custom_mxid.nil? && !custom_mxid.empty?
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+test do
+  describe "Async::Matrix::Bridge::Discord::DB::Puppet" do
+    def setup_db
+      db = Sequel.sqlite
+      Sequel::Migrator.run(db, File.join(__dir__, "migrations"))
+      db
+    end
+
+    it "creates and retrieves a puppet" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::Puppet.dataset = db[:puppets]
+
+      puppet = Async::Matrix::Bridge::Discord::DB::Puppet.create(
+        discord_id: "123",
+        name: "Alice",
+        username: "alice",
+        global_name: "Alice Wonderland"
+      )
+      puppet.discord_id.should == "123"
+      puppet.name.should == "Alice"
+      puppet.username.should == "alice"
+      puppet.global_name.should == "Alice Wonderland"
+      db.disconnect
+    end
+
+    it "defaults boolean flags to false" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::Puppet.dataset = db[:puppets]
+
+      puppet = Async::Matrix::Bridge::Discord::DB::Puppet.create(discord_id: "200")
+      puppet.is_bot.should == false
+      puppet.is_webhook.should == false
+      puppet.contact_info_set.should == false
+      db.disconnect
+    end
+
+    it "tracks bot and webhook puppets" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::Puppet.dataset = db[:puppets]
+
+      bot = Async::Matrix::Bridge::Discord::DB::Puppet.create(discord_id: "300", is_bot: true)
+      bot.is_bot.should == true
+
+      webhook = Async::Matrix::Bridge::Discord::DB::Puppet.create(discord_id: "301", is_webhook: true)
+      webhook.is_webhook.should == true
+      db.disconnect
+    end
+
+    it "detects double puppet configuration" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::Puppet.dataset = db[:puppets]
+
+      regular = Async::Matrix::Bridge::Discord::DB::Puppet.create(discord_id: "400")
+      regular.double_puppet?.should == false
+
+      double = Async::Matrix::Bridge::Discord::DB::Puppet.create(
+        discord_id: "401",
+        custom_mxid: "@alice:example.com",
+        access_token: "syt_token"
+      )
+      double.double_puppet?.should == true
+      double.access_token.should == "syt_token"
+      db.disconnect
+    end
+
+    it "validates discord_id is present" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::Puppet.dataset = db[:puppets]
+
+      puppet = Async::Matrix::Bridge::Discord::DB::Puppet.new(discord_id: "")
+      puppet.valid?.should == false
+      puppet.errors[:discord_id].should.not.be.empty
+      db.disconnect
+    end
+
+    it "updates avatar info" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::Puppet.dataset = db[:puppets]
+
+      puppet = Async::Matrix::Bridge::Discord::DB::Puppet.create(discord_id: "500")
+      puppet.update(avatar_hash: "abc123", avatar_url: "mxc://example.com/abc")
+      puppet.refresh
+      puppet.avatar_hash.should == "abc123"
+      puppet.avatar_url.should == "mxc://example.com/abc"
+      db.disconnect
+    end
+  end
+end

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

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+
+# 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 Bridge
+      module Discord
+        module DB
+          # Maps a Discord reaction to a Matrix reaction event.
+          #
+          # Uniquely identified by (discord_message_id, discord_sender,
+          # discord_emoji_name) — one reaction per emoji per user per message.
+          #
+          #   reaction = Reaction.create(
+          #     discord_message_id: "msg1", discord_sender: "user1",
+          #     discord_emoji_name: "\u{1f44d}", mxid: "$react1",
+          #     discord_channel_id: "ch1"
+          #   )
+          #
+          class Reaction < Sequel::Model
+            def validate
+              super
+              errors.add(:discord_message_id, "cannot be empty") if discord_message_id.nil? || discord_message_id.empty?
+              errors.add(:discord_sender, "cannot be empty") if discord_sender.nil? || discord_sender.empty?
+              errors.add(:discord_emoji_name, "cannot be empty") if discord_emoji_name.nil? || discord_emoji_name.empty?
+              errors.add(:mxid, "cannot be empty") if mxid.nil? || mxid.empty?
+            end
+
+            # Find all reactions on a Discord message.
+            def self.by_discord_message(message_id, channel_id, receiver = "")
+              where(
+                discord_message_id: message_id,
+                discord_channel_id: channel_id,
+                discord_channel_receiver: receiver
+              ).all
+            end
+
+            # Find a specific reaction by its Matrix event ID.
+            def self.by_mxid(mxid)
+              first(mxid: mxid)
+            end
+
+            # Find a specific reaction by Discord compound key.
+            def self.by_discord_key(message_id:, sender:, emoji_name:)
+              first(
+                discord_message_id: message_id,
+                discord_sender: sender,
+                discord_emoji_name: emoji_name
+              )
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+test do
+  describe "Async::Matrix::Bridge::Discord::DB::Reaction" do
+    def setup_db
+      db = Sequel.sqlite
+      Sequel::Migrator.run(db, File.join(__dir__, "migrations"))
+      db
+    end
+
+    it "creates and retrieves a reaction" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::Reaction.dataset = db[:reactions]
+
+      reaction = Async::Matrix::Bridge::Discord::DB::Reaction.create(
+        discord_message_id: "msg1",
+        discord_sender: "user1",
+        discord_emoji_name: "\u{1f44d}",
+        mxid: "$react1",
+        discord_channel_id: "ch1"
+      )
+      reaction.discord_emoji_name.should == "\u{1f44d}"
+      reaction.mxid.should == "$react1"
+      db.disconnect
+    end
+
+    it "finds reactions by discord message" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::Reaction.dataset = db[:reactions]
+
+      Async::Matrix::Bridge::Discord::DB::Reaction.create(
+        discord_message_id: "msg2", discord_sender: "u1",
+        discord_emoji_name: "\u{1f44d}", mxid: "$r1", discord_channel_id: "ch1"
+      )
+      Async::Matrix::Bridge::Discord::DB::Reaction.create(
+        discord_message_id: "msg2", discord_sender: "u2",
+        discord_emoji_name: "\u{2764}", mxid: "$r2", discord_channel_id: "ch1"
+      )
+
+      reactions = Async::Matrix::Bridge::Discord::DB::Reaction.by_discord_message("msg2", "ch1")
+      reactions.length.should == 2
+      db.disconnect
+    end
+
+    it "finds by Discord compound key" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::Reaction.dataset = db[:reactions]
+
+      Async::Matrix::Bridge::Discord::DB::Reaction.create(
+        discord_message_id: "msg3", discord_sender: "u1",
+        discord_emoji_name: "custom_emoji", mxid: "$r3", discord_channel_id: "ch1"
+      )
+
+      found = Async::Matrix::Bridge::Discord::DB::Reaction.by_discord_key(
+        message_id: "msg3", sender: "u1", emoji_name: "custom_emoji"
+      )
+      found.should.not.be.nil
+      found.mxid.should == "$r3"
+      db.disconnect
+    end
+
+    it "finds by Matrix event ID" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::Reaction.dataset = db[:reactions]
+
+      Async::Matrix::Bridge::Discord::DB::Reaction.create(
+        discord_message_id: "msg4", discord_sender: "u1",
+        discord_emoji_name: "x", mxid: "$find_react", discord_channel_id: "ch1"
+      )
+
+      found = Async::Matrix::Bridge::Discord::DB::Reaction.by_mxid("$find_react")
+      found.discord_message_id.should == "msg4"
+      db.disconnect
+    end
+
+    it "enforces unique reaction per user per emoji per message" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::Reaction.dataset = db[:reactions]
+
+      Async::Matrix::Bridge::Discord::DB::Reaction.create(
+        discord_message_id: "msg5", discord_sender: "u1",
+        discord_emoji_name: "x", mxid: "$r5", discord_channel_id: "ch1"
+      )
+      lambda {
+        Async::Matrix::Bridge::Discord::DB::Reaction.create(
+          discord_message_id: "msg5", discord_sender: "u1",
+          discord_emoji_name: "x", mxid: "$r6", discord_channel_id: "ch1"
+        )
+      }.should.raise(Sequel::UniqueConstraintViolation)
+      db.disconnect
+    end
+
+    it "validates required fields" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::Reaction.dataset = db[:reactions]
+
+      r = Async::Matrix::Bridge::Discord::DB::Reaction.new(
+        discord_message_id: "", discord_sender: "",
+        discord_emoji_name: "", mxid: ""
+      )
+      r.valid?.should == false
+      r.errors[:discord_message_id].should.not.be.empty
+      r.errors[:mxid].should.not.be.empty
+      db.disconnect
+    end
+  end
+end

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

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+# 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 Bridge
+      module Discord
+        module DB
+          # Maps a Matrix user to their Discord identity and session state.
+          #
+          #   user = User.create(mxid: "@alice:example.com", discord_id: "123456789")
+          #   user.discord_id     # => "123456789"
+          #   user.space_room     # => "!space:example.com"
+          #   user.portals        # => [Portal, ...]
+          #
+          class User < Sequel::Model
+            unrestrict_primary_key
+
+            one_to_many :portals,
+              class: "Async::Matrix::Bridge::Discord::DB::Portal",
+              key: :receiver,
+              primary_key: :discord_id
+
+            def validate
+              super
+              errors.add(:mxid, "cannot be empty") if mxid.nil? || mxid.empty?
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+test do
+  describe "Async::Matrix::Bridge::Discord::DB::User" do
+    def setup_db
+      db = Sequel.sqlite
+      Sequel::Migrator.run(db, File.join(__dir__, "migrations"))
+      db
+    end
+
+    it "creates and retrieves a user by mxid" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::User.dataset = db[:users]
+
+      user = Async::Matrix::Bridge::Discord::DB::User.create(
+        mxid: "@alice:example.com",
+        discord_id: "123456789"
+      )
+      user.mxid.should == "@alice:example.com"
+      user.discord_id.should == "123456789"
+
+      found = Async::Matrix::Bridge::Discord::DB::User["@alice:example.com"]
+      found.discord_id.should == "123456789"
+      db.disconnect
+    end
+
+    it "stores optional session fields" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::User.dataset = db[:users]
+
+      user = Async::Matrix::Bridge::Discord::DB::User.create(
+        mxid: "@bob:example.com",
+        discord_token: "secret_token",
+        management_room: "!mgmt:example.com",
+        space_room: "!space:example.com",
+        dm_space_room: "!dm:example.com"
+      )
+      user.discord_token.should == "secret_token"
+      user.management_room.should == "!mgmt:example.com"
+      user.space_room.should == "!space:example.com"
+      user.dm_space_room.should == "!dm:example.com"
+      db.disconnect
+    end
+
+    it "enforces unique discord_id" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::User.dataset = db[:users]
+
+      Async::Matrix::Bridge::Discord::DB::User.create(mxid: "@a:x", discord_id: "111")
+      lambda {
+        Async::Matrix::Bridge::Discord::DB::User.create(mxid: "@b:x", discord_id: "111")
+      }.should.raise(Sequel::UniqueConstraintViolation)
+      db.disconnect
+    end
+
+    it "validates mxid is present" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::User.dataset = db[:users]
+
+      user = Async::Matrix::Bridge::Discord::DB::User.new(mxid: "")
+      user.valid?.should == false
+      user.errors[:mxid].should.not.be.empty
+      db.disconnect
+    end
+
+    it "updates discord token" do
+      db = setup_db
+      Async::Matrix::Bridge::Discord::DB::User.dataset = db[:users]
+
+      user = Async::Matrix::Bridge::Discord::DB::User.create(mxid: "@c:x")
+      user.update(discord_token: "new_token")
+      user.refresh
+      user.discord_token.should == "new_token"
+      db.disconnect
+    end
+  end
+end