discord_rda 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53c5128ffda5f61e3d0e5aea868f9e93bafa82d98151d79f7c6739e8d185f1f9
-  data.tar.gz: 9d73432141274e3bbc8905fe7ddba98691ea64e7fd2381ffd9de1833a0a733f8
+  metadata.gz: d960d7a22ca5c98ca29977ef83f97a4f4e3c21356d824f4ab444cd32784d946a
+  data.tar.gz: e2582c65742fc5d336b8a0b3456ca2ecc9c6d40f93fbd85e6448583a4757305a
 SHA512:
-  metadata.gz: 568d5fcbb987b97e5ba71f793346d536a6433b22398cdc32f04d2df43ced244f7a8215f818f942313e19a8b95e9c02d31dd99aac39fc1cb557648cbe7783081b
-  data.tar.gz: 861a6cbd6e0dba4b88e1ce6fcec261c700541493a0802384321d4bd3975ba64fc952d17c41736e28854e602ea58df9361e048bb148c74fdbd4cc9ea743bbe7ae
+  metadata.gz: 7a39158b307ed8d71bd6ca5ddbe2a12e375ef138faef0c64ee615dda22e61d41ef52c5e2ef8841c1940bef440208e46a06c9c2a73fba2dd05635158eea26d980
+  data.tar.gz: 94f2dc665860f7d34d9719e58111420d5b841d5abe77b32768e0d8115f68ca662f776288a0dd22e6cd42ee9b9514ddd4168d212f311086b05775bb66307f63f7

data/README.md

@@ -7,6 +7,8 @@
 
 DiscordRDA (Ruby Development API) is a high-performance Ruby library for building Discord bots with modern async patterns, comprehensive Slash Command support, Component V2 architecture, and enterprise-grade scalability features.
 
+The library now exposes a much broader Discord REST surface than the original quick-start examples show, including thread lifecycle helpers, webhook message management, invite creation, guild widget and onboarding endpoints, and current-user OAuth2 convenience methods.
+
 ## Features
 
 ### Core Capabilities
@@ -26,11 +28,20 @@ DiscordRDA (Ruby Development API) is a high-performance Ruby library for buildin
 - **Component V2**: Latest Discord components (buttons, selects, containers)
 
 ### Enterprise Features
+- **Instant Restarts**: Exec-based restart flow that preserves gateway resume state
 - **Zero-Downtime Resharding**: Add shards without stopping the bot
 - **Hot Reload**: File system event-based code reloading
 - **Session Transfer**: Migrate guilds between shards seamlessly
 - **REST Proxy Support**: Horizontal scaling with proxy servers
 - **State Preservation**: Maintain sessions across reloads
+- **Execution Supervision**: Command timeouts, concurrency limits, and failure circuit breaking
+
+### Extended REST Coverage
+- **Threads**: Create, join, leave, archive, and manage thread members
+- **Webhooks**: Fetch, mutate, and edit webhook-owned messages
+- **Guild Admin**: Invites, prune, widget, vanity URL, welcome screen, onboarding
+- **Current User**: DM creation, guild listing, connections, role connections
+- **Persistence**: Built-in ActiveRecord bootstrap and migration helpers
 
 ## Installation
 
@@ -142,6 +153,58 @@ bot.context_menu(type: :user, name: 'High Five') do |interaction|
 end
 ```
 
+## REST Helpers
+
+```ruby
+# Create a thread from a message
+thread = bot.start_thread_from_message(
+  channel_id,
+  message_id,
+  name: 'incident-review',
+  auto_archive_duration: 1440
+)
+
+# Create a channel invite with the DSL builder
+invite = bot.create_channel_invite(channel_id) do |builder|
+  builder.max_age(3600).max_uses(5).temporary
+end
+
+# Edit a webhook message
+bot.edit_webhook_message(webhook_id, webhook_token, message_id, content: 'Updated from DiscordRDA')
+```
+
+## Resilience
+
+```ruby
+bot.slash('rebuild', 'Run a risky rebuild task') do |cmd|
+  cmd.timeout(10)
+  cmd.max_concurrency(1)
+  cmd.circuit_breaker(failures: 3, cooldown: 120)
+
+  cmd.handler do |interaction|
+    interaction.respond(content: 'Started safely', ephemeral: true)
+  end
+end
+
+# For memory-bound or untrusted work, use an isolated subprocess:
+result = bot.supervisor.run_isolated(
+  ruby_code: "puts({ ok: true }.to_json)",
+  timeout_seconds: 5,
+  memory_limit_mb: 128
+)
+```
+
+## ActiveRecord
+
+```ruby
+bot.enable_active_record(database_url: ENV['DATABASE_URL'])
+
+class GuildSetting < DiscordRDA::Record
+end
+
+bot.active_record.migrate
+```
+
 ## Components
 
 ### Button Components