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

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

lib/resend/events.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Resend
+  # events api wrapper
+  module Events
+    class << self
+      # https://resend.com/docs/api-reference/events/create-event
+      def create(params = {})
+        Resend::Request.new("events", params, "post").perform
+      end
+
+      # https://resend.com/docs/api-reference/events/get-event
+      # identifier can be a UUID or an event name (e.g. "user.signed_up")
+      def get(identifier = "")
+        path = "events/#{CGI.escape(identifier.to_s)}"
+        Resend::Request.new(path, {}, "get").perform
+      end
+
+      # https://resend.com/docs/api-reference/events/update-event
+      def update(params = {})
+        identifier = params[:identifier]
+        path = "events/#{CGI.escape(identifier.to_s)}"
+        payload = params.reject { |k, _| k == :identifier }
+        Resend::Request.new(path, payload, "patch").perform
+      end
+
+      # https://resend.com/docs/api-reference/events/delete-event
+      # identifier can be a UUID or an event name (e.g. "user.signed_up")
+      def remove(identifier = "")
+        path = "events/#{CGI.escape(identifier.to_s)}"
+        Resend::Request.new(path, {}, "delete").perform
+      end
+
+      # https://resend.com/docs/api-reference/events/send-event
+      def send(params = {})
+        Resend::Request.new("events/send", params, "post").perform
+      end
+
+      # https://resend.com/docs/api-reference/events/list-events
+      def list(params = {})
+        path = Resend::PaginationHelper.build_paginated_path("events", params)
+        Resend::Request.new(path, {}, "get").perform
+      end
+    end
+  end
+end