discord_store 0.1.0

data/lib/discord_store.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+require_relative "discord_store/version"
+require_relative "discord_store/errors"
+require_relative "discord_store/snowflake"
+require_relative "discord_store/configuration"
+require_relative "discord_store/cipher"
+require_relative "discord_store/channel_shard"
+require_relative "discord_store/codec"
+require_relative "discord_store/log"
+require_relative "discord_store/guild_limits"
+require_relative "discord_store/blob_store"
+require_relative "discord_store/kv"
+require_relative "discord_store/transport/http"
+require_relative "discord_store/transport/quota"
+require_relative "discord_store/transport/bucket"
+require_relative "discord_store/transport/rate_limiter"
+require_relative "discord_store/transport/rest"
+require_relative "discord_store/transport/fake"
+
+# Uses Discord as a database.
+#
+# It works, in the sense that the data goes in and comes back out. It is also an
+# explicit violation of the Discord Developer Terms of Service, it is capped at
+# a few megabytes per second by rate limits nobody can raise for you, and every
+# byte of it lives at the pleasure of a company that has already shipped one
+# change (signed, expiring CDN links) that broke this entire category of project
+# overnight.
+#
+# Read {Configuration#i_understand_this_violates_discord_tos} before using it.
+module DiscordStore
+  class << self
+    # @return [Configuration]
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    # @yieldparam config [Configuration]
+    # @return [Configuration]
+    def configure
+      yield(configuration) if block_given?
+      configuration
+    end
+
+    # Resets configuration and any memoized client. Mainly for tests.
+    #
+    # @return [void]
+    def reset!
+      @configuration = nil
+      @client = nil
+    end
+
+    # The process-wide client.
+    #
+    # @return [Client]
+    def client
+      @client ||= Client.new(config: configuration)
+    end
+
+    # Replaces the process-wide client, e.g. with one wired to the fake.
+    #
+    # @param client [Client]
+    # @return [Client]
+    attr_writer :client
+
+    # @return [String] a fresh base64 encryption key
+    def generate_key = Cipher.generate_key
+  end
+
+  # Ties the layers together: one transport, one rate limiter, and the stores
+  # built on top of them.
+  class Client
+    attr_reader :config, :rest
+
+    # @param config [Configuration]
+    # @param http [#call, nil] injectable HTTP backend; pass a
+    #   {Transport::Fake} to run the whole stack without a token
+    def initialize(config: DiscordStore.configuration, http: nil)
+      @config = config.validate!
+      @rest = Transport::REST.new(config: @config, http: http)
+    end
+
+    # @return [Log]
+    def log
+      @log ||= Log.new(rest: @rest, config: @config)
+    end
+
+    # @return [BlobStore]
+    def blobs
+      @blobs ||= BlobStore.new(rest: @rest, config: @config)
+    end
+
+    # @return [KV]
+    def kv
+      @kv ||= KV.new(rest: @rest, config: @config)
+    end
+
+    # @return [GuildLimits]
+    def limits
+      @limits ||= GuildLimits.new(rest: @rest, config: @config)
+    end
+
+    # Confirms the token works and that the configured application_id matches
+    # the token's actual identity. Worth calling at boot: a mismatched
+    # application_id silently makes every read return nothing, because the
+    # own-messages guard rejects our own writes.
+    #
+    # @return [Hash] the bot user
+    # @raise [ConfigurationError] on an application_id mismatch
+    def verify!
+      user = @rest.current_user
+
+      if @config.own_messages_only && user["id"].to_s != @config.application_id.to_s
+        raise ConfigurationError,
+              "configured application_id #{@config.application_id.inspect} is not this token's " \
+              "identity (#{user["id"].inspect}). Every read would silently return nothing."
+      end
+
+      user
+    end
+
+    # @return [void]
+    def close = @rest.close
+  end
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: discord_store
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Chayut
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-09-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: |
+  A rate-limit-aware transport, an encrypted append-only log, an ActiveStorage
+  service and an ActiveRecord adapter, all backed by Discord messages and
+  attachments. Snowflake IDs as log sequence numbers, channels as partitions,
+  tombstones instead of deletes, and CDN links re-resolved on every read
+  instead of cached. An extended argument about what an ActiveRecord adapter
+  is allowed to be, which happens to work.
+email:
+- chayut_o@hotmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/active_record/connection_adapters/discord_adapter.rb
+- lib/active_storage/service/discord_service.rb
+- lib/discord_store.rb
+- lib/discord_store/blob_store.rb
+- lib/discord_store/channel_shard.rb
+- lib/discord_store/cipher.rb
+- lib/discord_store/codec.rb
+- lib/discord_store/configuration.rb
+- lib/discord_store/errors.rb
+- lib/discord_store/guild_limits.rb
+- lib/discord_store/journal.rb
+- lib/discord_store/kv.rb
+- lib/discord_store/log.rb
+- lib/discord_store/log/record.rb
+- lib/discord_store/railtie.rb
+- lib/discord_store/replay.rb
+- lib/discord_store/snowflake.rb
+- lib/discord_store/tasks.rake
+- lib/discord_store/transport/bucket.rb
+- lib/discord_store/transport/fake.rb
+- lib/discord_store/transport/http.rb
+- lib/discord_store/transport/quota.rb
+- lib/discord_store/transport/rate_limiter.rb
+- lib/discord_store/transport/rest.rb
+- lib/discord_store/version.rb
+homepage: https://github.com/chayuto/discord_store
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/chayuto/discord_store
+  bug_tracker_uri: https://github.com/chayuto/discord_store/issues
+  changelog_uri: https://github.com/chayuto/discord_store/blob/main/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/discord_store
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Use Discord as a database. Against your better judgement, and its Terms of
+  Service.
+test_files: []