feat(automations,events): add Automations and Events API namespaces

- Add Resend::Automations with create, get, update, remove, stop, list
- Add Resend::Automations::Runs with list and get (nested namespace)
- Add Resend::Events with create, get, update, remove, send, list
- Add specs and examples for both namespaces
- Add base64 as explicit runtime dependency (removed from Ruby 3.4 stdlib)
- Move rails to Gemfile development group, remove from gemspec
- Update Dockerfile to bundle install --without development

Author: drish

Dockerfile

@@ -7,4 +7,4 @@ WORKDIR /app
 
 ADD . /app/
 
-RUN bundle install
+RUN bundle install --without development

Gemfile

@@ -11,6 +11,10 @@ gem "rspec", "~> 3.0"
 
 gem "rubocop", "~> 1.21"
 
-gem "httparty", "~> 0.21.0"
+gem "httparty", "~> 0.22.0"
 
 gem "pry-byebug"
+
+group :development do
+  gem "rails"
+end

Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    resend (1.0.1)
-      httparty (>= 0.21.0)
+    resend (1.1.0)
+      base64
+      httparty (>= 0.21.0, < 1)
 
 GEM
   remote: https://rubygems.org/
@@ -73,17 +74,21 @@ GEM
       minitest (>= 5.1)
       tzinfo (~> 2.0)
     ast (2.4.3)
+    base64 (0.3.0)
+    bigdecimal (4.1.1)
     builder (3.2.4)
     byebug (11.1.3)
     coderay (1.1.3)
     concurrent-ruby (1.1.10)
     crass (1.0.6)
+    csv (3.3.5)
     date (3.3.3)
     diff-lcs (1.5.1)
     erubi (1.12.0)
     globalid (1.0.0)
       activesupport (>= 5.0)
-    httparty (0.21.0)
+    httparty (0.22.0)
+      csv
       mini_mime (>= 1.0.0)
       multi_xml (>= 0.5.2)
     i18n (1.12.0)
@@ -101,10 +106,11 @@ GEM
       net-smtp
     marcel (1.0.2)
     method_source (1.0.0)
-    mini_mime (1.1.2)
+    mini_mime (1.1.5)
     mini_portile2 (2.8.1)
     minitest (5.16.3)
-    multi_xml (0.6.0)
+    multi_xml (0.8.1)
+      bigdecimal (>= 3.1, < 5)
     net-imap (0.3.4)
       date
       net-protocol
@@ -203,12 +209,13 @@ GEM
 PLATFORMS
   aarch64-linux
   arm64-darwin-22
+  arm64-darwin-25
   x86_64-darwin-20
   x86_64-darwin-21
   x86_64-linux
 
 DEPENDENCIES
-  httparty (~> 0.21.0)
+  httparty (~> 0.22.0)
   pry-byebug
   rails
   rake (~> 13.0)

examples/automations.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+require_relative "../lib/resend"
+
+raise if ENV["RESEND_API_KEY"].nil?
+
+Resend.api_key = ENV["RESEND_API_KEY"]
+
+# 1. Create a template (needed for the send_email step config)
+template = Resend::Templates.create({
+  name: "Welcome Email",
+  from: "onboarding@resend.dev",
+  subject: "Welcome!",
+  html: "<p>Welcome to our platform!</p>"
+})
+template_id = template[:id]
+puts "created template: #{template_id}"
+
+Resend::Templates.publish(template_id)
+puts "published template: #{template_id}"
+
+# 2. Create a simple automation: trigger → send_email
+simple_automation = Resend::Automations.create({
+  name: "Simple Welcome Automation",
+  steps: [
+    {
+      key: "trigger",
+      type: "trigger",
+      config: { event_name: "user.created" }
+    },
+    {
+      key: "send_welcome",
+      type: "send_email",
+      config: { template: { id: template_id } }
+    }
+  ],
+  connections: [
+    { from: "trigger", to: "send_welcome", type: "default" }
+  ]
+})
+automation_id = simple_automation[:id]
+puts "created simple automation: #{automation_id}"
+
+# 3. Get automation
+retrieved = Resend::Automations.get(automation_id)
+puts "retrieved automation: #{retrieved[:id]}, status: #{retrieved[:status]}"
+
+# 4. Update automation (change status to enabled)
+updated = Resend::Automations.update({
+  automation_id: automation_id,
+  status: "enabled"
+})
+puts "updated automation: #{updated[:id]}"
+
+# 5. List automations (without filter)
+all_automations = Resend::Automations.list
+puts "automations: #{all_automations[:data].length}, has_more: #{all_automations[:has_more]}"
+
+# List automations with status filter
+enabled_automations = Resend::Automations.list({ status: "enabled" })
+puts "enabled automations: #{enabled_automations[:data].length}"
+
+# 6. Stop automation
+stopped = Resend::Automations.stop(automation_id)
+puts "stopped automation: #{stopped[:id]}"
+
+# 7. List runs (Resend::Automations::Runs.list)
+runs = Resend::Automations::Runs.list(automation_id)
+puts "runs: #{runs[:data].length}, has_more: #{runs[:has_more]}"
+
+# 8. Get a run if any exist (Resend::Automations::Runs.get)
+if runs[:data].any?
+  run_id = runs[:data].first[:id]
+  run = Resend::Automations::Runs.get(automation_id, run_id)
+  puts "run: #{run[:id]}, status: #{run[:status]}"
+else
+  puts "no runs yet for this automation"
+end
+
+# 9. Multi-step automation: trigger → delay → wait_for_event → send_email
+multi_automation = Resend::Automations.create({
+  name: "Multi-step Onboarding Automation",
+  steps: [
+    {
+      key: "trigger",
+      type: "trigger",
+      config: { event_name: "user.created" }
+    },
+    {
+      key: "wait_30_min",
+      type: "delay",
+      config: { duration: "30 minutes" }
+    },
+    {
+      key: "wait_verified",
+      type: "wait_for_event",
+      config: { event_name: "user.verified", timeout: "1 hour" }
+    },
+    {
+      key: "send_welcome",
+      type: "send_email",
+      config: { template: { id: template_id } }
+    }
+  ],
+  connections: [
+    { from: "trigger", to: "wait_30_min", type: "default" },
+    { from: "wait_30_min", to: "wait_verified", type: "default" },
+    { from: "wait_verified", to: "send_welcome", type: "event_received" }
+  ]
+})
+multi_automation_id = multi_automation[:id]
+puts "created multi-step automation: #{multi_automation_id}"
+
+# 10. Cleanup: delete both automations and the template
+Resend::Automations.remove(automation_id)
+puts "removed automation: #{automation_id}"
+
+Resend::Automations.remove(multi_automation_id)
+puts "removed multi-step automation: #{multi_automation_id}"
+
+Resend::Templates.remove(template_id)
+puts "removed template: #{template_id}"

examples/events.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require_relative "../lib/resend"
+
+raise if ENV["RESEND_API_KEY"].nil?
+
+Resend.api_key = ENV["RESEND_API_KEY"]
+
+# 1. Create a global contact (needed for event sends)
+contact = Resend::Contacts.create({
+  email: "test.events@example.com",
+  first_name: "Test",
+  last_name: "User"
+})
+contact_id = contact[:id]
+puts "created contact: #{contact_id}"
+
+# 2. Create event without schema
+event_no_schema = Resend::Events.create({ name: "user.signed_up" })
+puts "created event without schema: #{event_no_schema[:id]}"
+
+# 3. Create event with schema
+schema = {
+  "plan" => "string",
+  "trial_days" => "number",
+  "is_enterprise" => "boolean",
+  "upgraded_at" => "date"
+}
+event_with_schema = Resend::Events.create({ name: "user.upgraded", schema: schema })
+event_id = event_with_schema[:id]
+puts "created event with schema: #{event_id}"
+
+# 4. Get event by ID
+fetched_by_id = Resend::Events.get(event_id)
+puts "fetched event by ID: #{fetched_by_id[:id]}, name: #{fetched_by_id[:name]}"
+
+# 5. Get event by name
+fetched_by_name = Resend::Events.get("user.upgraded")
+puts "fetched event by name: #{fetched_by_name[:id]}, name: #{fetched_by_name[:name]}"
+
+# 6. Update event schema
+new_schema = {
+  "plan" => "string",
+  "trial_days" => "number",
+  "is_enterprise" => "boolean",
+  "upgraded_at" => "date",
+  "referral_code" => "string"
+}
+updated_event = Resend::Events.update({ identifier: event_id, schema: new_schema })
+puts "updated event: #{updated_event[:id]}"
+
+# 7. Send event with contact_id
+sent_with_contact_id = Resend::Events.send({
+  event: "user.upgraded",
+  contact_id: contact_id,
+  payload: { plan: "pro", trial_days: 14, is_enterprise: false }
+})
+puts "sent event with contact_id: #{sent_with_contact_id[:event]}"
+
+# 8. Send event with email
+sent_with_email = Resend::Events.send({
+  event: "user.signed_up",
+  email: "test.events@example.com"
+})
+puts "sent event with email: #{sent_with_email[:event]}"
+
+# 9. List events
+events = Resend::Events.list
+puts "total events: #{events[:data].length}, has_more: #{events[:has_more]}"
+
+# 10. List events with pagination params
+paginated = Resend::Events.list({ limit: 5 })
+puts "paginated events (limit 5): #{paginated[:data].length}"
+
+if paginated[:has_more]
+  last_id = paginated[:data].last[:id]
+  more_events = Resend::Events.list({ limit: 5, after: last_id })
+  puts "next page: #{more_events[:data].length}"
+end
+
+# 11. Delete event by ID
+deleted_by_id = Resend::Events.remove(event_id)
+puts "deleted event by ID: #{deleted_by_id[:id]}, deleted: #{deleted_by_id[:deleted]}"
+
+# 12. Delete event by name
+deleted_by_name = Resend::Events.remove("user.signed_up")
+puts "deleted event by name: #{deleted_by_name[:deleted]}"
+
+# 13. Cleanup: delete contact
+Resend::Contacts.remove({ id: contact_id })
+puts "removed contact: #{contact_id}"

lib/resend.rb

@@ -31,6 +31,9 @@
 require "resend/logs"
 require "resend/topics"
 require "resend/webhooks"
+require "resend/automations"
+require "resend/automations/runs"
+require "resend/events"
 
 # Rails
 require "resend/railtie" if defined?(Rails) && defined?(ActionMailer)

lib/resend/automations.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Resend
+  # automations api wrapper
+  module Automations
+    class << self
+      # https://resend.com/docs/api-reference/automations/create-automation
+      def create(params = {})
+        Resend::Request.new("automations", params, "post").perform
+      end
+
+      # https://resend.com/docs/api-reference/automations/get-automation
+      def get(automation_id = "")
+        Resend::Request.new("automations/#{automation_id}", {}, "get").perform
+      end
+
+      # https://resend.com/docs/api-reference/automations/update-automation
+      def update(params = {})
+        path = "automations/#{params[:automation_id]}"
+        payload = params.reject { |k, _| k == :automation_id }
+        Resend::Request.new(path, payload, "patch").perform
+      end
+
+      # https://resend.com/docs/api-reference/automations/delete-automation
+      def remove(automation_id = "")
+        Resend::Request.new("automations/#{automation_id}", {}, "delete").perform
+      end
+
+      # https://resend.com/docs/api-reference/automations/stop-automation
+      def stop(automation_id = "")
+        Resend::Request.new("automations/#{automation_id}/stop", {}, "post").perform
+      end
+
+      # https://resend.com/docs/api-reference/automations/list-automations
+      def list(params = {})
+        path = Resend::PaginationHelper.build_paginated_path("automations", params)
+        Resend::Request.new(path, {}, "get").perform
+      end
+    end
+  end
+end

lib/resend/automations/runs.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Resend
+  module Automations
+    # Automation Runs api wrapper
+    module Runs
+      class << self
+        # https://resend.com/docs/api-reference/automations/list-automation-runs
+        def list(automation_id, params = {})
+          base_path = "automations/#{automation_id}/runs"
+          path = Resend::PaginationHelper.build_paginated_path(base_path, params)
+          Resend::Request.new(path, {}, "get").perform
+        end
+
+        # https://resend.com/docs/api-reference/automations/get-automation-run
+        def get(automation_id, run_id)
+          Resend::Request.new("automations/#{automation_id}/runs/#{run_id}", {}, "get").perform
+        end
+      end
+    end
+  end
+end