resend 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 23a4b97089acf88e3b1a768ebb7b9db1c5733ea1b225ca94cdeaae55abe4d0bc
-  data.tar.gz: 24e7052354d80707fe5d1d4aafeac46b85926deec93089f853c11c22965501a8
+  metadata.gz: cc6ad8469a98068e64cbfb9d6c021058d7e640f32eb5617e839a796c46491d39
+  data.tar.gz: 499a33038351ff07315bd8b10f9a7e0c9387c6d5b04fe12cf7a6c7ce5d2a80e8
 SHA512:
-  metadata.gz: df538ce18a8a477d1527a270088691c98c5c2f1f6a793502f6abafd605f04e47a9c23b7366a7ef6c694c90ec4804ac2a909d8288d80c61062af7dc179c7d8d33
-  data.tar.gz: 73cbbda1da1cf01ebdb93c5f542481a6e33bebd2ae9d7a2ddbe696fac3d6ff550f2f270e3ce805fb72546a0af72557826dcf9c74509205c14935dfa49f8cb817
+  metadata.gz: 9e3709cd8c049cc638118353571fc575f124132d998d8b69580484f0e2cd9b60ec1ce3c7c981c195b69185e8c70970d7fe30477a8c35a787f62563d2eb7952a6
+  data.tar.gz: 4e1fe85c2ba097d460b3cdf56a7ce42da70e91398965bdd2b688581c34db0715c884e66bf330e32b48381afd66d505b03a0ac19758b7eeec1e26c0ff194306ef

data/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.7.0] - 2026-07-31
+
+### Added
+
+- **Suppressions** - New `Resend::Suppressions` module to add (`add`), list (`list`), retrieve (`get`), and remove (`remove`) suppressed email addresses. `get` and `remove` accept either a suppression ID or the suppressed email address. `list` supports `origin` filtering (`bounce`, `complaint`, `manual`) plus the standard `limit`/`after`/`before` pagination params. New `Resend::Suppressions::Batch` module handles up to 100 addresses at a time via `add` and `remove`. ([#208](https://github.com/resend/resend-ruby/pull/208))
+
+### Changed
+
+- ⚠️ **404 responses now raise `Resend::Error::NotFoundError`** instead of `Resend::Error::InvalidRequestError`, matching the documented intent of the (previously unreachable) `NotFoundError` class. Code rescuing `Resend::Error` or `Resend::Error::ServerError` is unaffected; code rescuing `InvalidRequestError` specifically to catch 404s should rescue `NotFoundError` instead. ([#210](https://github.com/resend/resend-ruby/pull/210))
+
 ## [1.6.0] - 2026-07-09
 
 ### Added
@@ -135,4 +145,6 @@ Resend::Segments.remove("segment_123")
 
 - Remove deprecated `send_email` method from `Resend::Emails` module (use `Resend::Emails.send` instead)
 
+[1.7.0]: https://github.com/resend/resend-ruby/compare/v1.6.0...v1.7.0
+[1.6.0]: https://github.com/resend/resend-ruby/compare/v1.5.0...v1.6.0
 [1.0.0]: https://github.com/resend/resend-ruby/compare/v0.26.0...v1.0.0

data/lib/resend/errors.rb

@@ -34,7 +34,7 @@ module Resend
 
     ERRORS = {
       401 => Resend::Error::InvalidRequestError,
-      404 => Resend::Error::InvalidRequestError,
+      404 => Resend::Error::NotFoundError,
       422 => Resend::Error::InvalidRequestError,
       429 => Resend::Error::RateLimitExceededError,
       400 => Resend::Error::InvalidRequestError,

data/lib/resend/suppressions/batch.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Resend
+  module Suppressions
+    # Suppressions Batch API wrapper
+    module Batch
+      class << self
+        #
+        # Add up to 100 email addresses to the suppression list at once. Addresses that
+        # are already suppressed come back with their existing suppression instead of failing.
+        #
+        # @param params [Hash] the parameters
+        # @option params [Array<String>] :emails the email addresses to suppress (required, 1 to 100).
+        #   The API lowercases and trims them.
+        #
+        # https://resend.com/docs/api-reference/suppressions/add-suppressions
+        def add(params)
+          Resend::Request.new("suppressions/batch/add", params, "post").perform
+        end
+
+        #
+        # Remove up to 100 suppressions at once, either by email address or by
+        # suppression ID. Provide exactly one of `emails` or `ids`.
+        #
+        # @param params [Hash] the parameters
+        # @option params [Array<String>] :emails the email addresses to remove (1 to 100)
+        # @option params [Array<String>] :ids the suppression IDs to remove (1 to 100), as UUIDs
+        #
+        # https://resend.com/docs/api-reference/suppressions/remove-suppressions
+        def remove(params)
+          normalized = params.transform_keys(&:to_sym)
+          emails = normalized[:emails]
+          ids = normalized[:ids]
+          raise ArgumentError, "Missing required `emails` or `ids` field" if emails.nil? && ids.nil?
+          raise ArgumentError, "Provide either `emails` or `ids`, but not both" if !emails.nil? && !ids.nil?
+
+          # The API rejects a null `emails`/`ids`, so the unused key is omitted rather than sent as nil.
+          body = emails.nil? ? { ids: ids } : { emails: emails }
+          Resend::Request.new("suppressions/batch/remove", body, "post").perform
+        end
+      end
+    end
+  end
+end

data/lib/resend/suppressions.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Resend
+  # Suppressions API wrapper
+  module Suppressions
+    class << self
+      #
+      # Add an email address to the suppression list. Suppressed addresses are
+      # skipped by future sends. Adding an address that is already suppressed
+      # succeeds and returns the existing suppression.
+      #
+      # @param params [Hash] the parameters
+      # @option params [String] :email the email address to suppress (required).
+      #   The API lowercases and trims it.
+      #
+      # https://resend.com/docs/api-reference/suppressions/add-suppression
+      def add(params)
+        Resend::Request.new("suppressions", params, "post").perform
+      end
+
+      #
+      # Retrieve a list of suppressions. Each entry has `id`, `email`, `origin`,
+      # `source_id` and `created_at`; unlike `get`, list entries carry no `object` key.
+      #
+      # @param params [Hash] optional filtering and pagination parameters
+      # @option params [String] :origin filter by origin: 'bounce', 'complaint' or 'manual'
+      # @option params [Integer] :limit number of results to return (1-100)
+      # @option params [String] :after cursor for forward pagination
+      # @option params [String] :before cursor for backward pagination
+      #
+      # https://resend.com/docs/api-reference/suppressions/list-suppressions
+      def list(params = {})
+        path = Resend::PaginationHelper.build_paginated_path("suppressions", params)
+        Resend::Request.new(path, {}, "get").perform
+      end
+
+      #
+      # Retrieve a single suppression. The API returns 404 'Suppression not found'
+      # when the address or ID is not suppressed.
+      #
+      # @param id_or_email [String] the suppression ID or the suppressed email address (required)
+      #
+      # https://resend.com/docs/api-reference/suppressions/get-suppression
+      def get(id_or_email)
+        raise ArgumentError, "Missing required `id_or_email` field" if id_or_email.nil? || id_or_email.empty?
+
+        Resend::Request.new("suppressions/#{ERB::Util.url_encode(id_or_email)}", {}, "get").perform
+      end
+
+      #
+      # Remove a single suppression, which allows sending to that address again.
+      # The API returns 404 'Suppression not found' when the address or ID is not suppressed.
+      #
+      # @param id_or_email [String] the suppression ID or the suppressed email address (required)
+      #
+      # https://resend.com/docs/api-reference/suppressions/remove-suppression
+      def remove(id_or_email)
+        raise ArgumentError, "Missing required `id_or_email` field" if id_or_email.nil? || id_or_email.empty?
+
+        Resend::Request.new("suppressions/#{ERB::Util.url_encode(id_or_email)}", {}, "delete").perform
+      end
+    end
+  end
+end

data/lib/resend/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Resend
-  VERSION = "1.6.0"
+  VERSION = "1.7.0"
 end

data/lib/resend.rb

@@ -7,6 +7,7 @@ require "resend/version"
 require "httparty"
 require "json"
 require "cgi"
+require "erb"
 require "resend/errors"
 require "resend/response"
 require "resend/client"
@@ -38,6 +39,8 @@ require "resend/oauth_grants"
 require "resend/automations"
 require "resend/automations/runs"
 require "resend/events"
+require "resend/suppressions"
+require "resend/suppressions/batch"
 
 # Rails
 require "resend/railtie" if defined?(Rails) && defined?(ActionMailer)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: resend
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Derich Pacheco
@@ -73,6 +73,8 @@ files:
 - lib/resend/request.rb
 - lib/resend/response.rb
 - lib/resend/segments.rb
+- lib/resend/suppressions.rb
+- lib/resend/suppressions/batch.rb
 - lib/resend/templates.rb
 - lib/resend/topics.rb
 - lib/resend/version.rb