resend 1.9.0 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d4fd70fd0f2eab7c555c5448fadede3d5393d8629e8e9edab9a606ee114157d
-  data.tar.gz: 4f9507e590d7ea64b0d55df9ca840c9b6d8d0895ef0621d07153c3d6c2027a4a
+  metadata.gz: 64e11672300db0ff3bdc430fada0fbd8ca115a07d2bfbbd761ea95dacf1e5c80
+  data.tar.gz: 02d393546fb4316ae1f9a6da5682e7d7b71aaad6b36a1bf29a84e4ef1996336e
 SHA512:
-  metadata.gz: 27ab0c3ba82126ddd1a4bf6c092b25a796c9975eedb20718947e2d2d1c70631f358d969a83701079dca6ae16ee38dd33316b58336ff3b1a4f98bed7d0e0e5648
-  data.tar.gz: 456c3b77bc440bf672b3d50d9ed922246f9375ee51e4ce9442c5ca68178bf4a922ab2f945bb954b1487259a93c7f39014ad21891584e4a8f33899dc7695f05dc
+  metadata.gz: 714868b613882c10b8990bef7a06dcd132e5d29dbda076f84d13f5c69ffe60fed0518d694e67e5a7ce46bc9a4fe84352a418dfc8711020d04a307764bd3130de
+  data.tar.gz: 9465a51da2439c78eedaad4bf9ad5e411e6a1068fb5c28d8829c9f8a4fadeab23c7c4da5f3fc40af48b58c457eefe403cb57533ad79c0dbe2f3b0bf4f2837a60

data/lib/resend/api_keys.rb

@@ -21,6 +21,12 @@ module Resend
         path = "api-keys/#{api_key_id}"
         Resend::Request.new(path, {}, "delete").perform
       end
+
+      # https://resend.com/docs/api-reference/api-keys/update-api-key
+      def update(params)
+        path = "api-keys/#{params[:id]}"
+        Resend::Request.new(path, { name: params[:name] }, "patch").perform
+      end
     end
   end
 end

data/lib/resend/broadcasts.rb

@@ -41,6 +41,12 @@ module Resend
         Resend::Request.new(path, {}, "get").perform
       end
 
+      # https://resend.com/docs/api-reference/broadcasts/list-broadcast-clicked-links
+      def clicked_links(broadcast_id = "", params = {})
+        path = Resend::PaginationHelper.build_paginated_path("broadcasts/#{broadcast_id}/clicked-links", params)
+        Resend::Request.new(path, {}, "get").perform
+      end
+
       def cancel(broadcast_id = "")
         path = "broadcasts/#{broadcast_id}/cancel"
         Resend::Request.new(path, {}, "post").perform
@@ -57,6 +63,25 @@ module Resend
         path = "broadcasts/#{broadcast_id}"
         Resend::Request.new(path, {}, "get").perform
       end
+
+      # https://resend.com/docs/api-reference/broadcasts/list-broadcast-recipients
+      # @param broadcast_id [String] the broadcast id
+      # @param params [Hash] the parameters
+      # @option params [String] :type the recipient event type to filter by (required):
+      #   sent, delivered, opened, clicked, bounced, complained, unsubscribed, suppressed
+      # @option params [String] :email filter recipients by email address (optional)
+      # @option params [String] :bounce_type filter bounced recipients by bounce type (optional,
+      #   only valid when type is bounced): permanent, transient, undetermined
+      # @option params [Integer] :limit the maximum number of results to return (optional)
+      # @option params [String] :after the cursor for pagination (optional)
+      # @option params [String] :before the cursor for pagination (optional)
+      def recipients(broadcast_id = "", params = {})
+        raise ArgumentError, "type is required" if params[:type].nil?
+
+        base_path = "broadcasts/#{broadcast_id}/recipients"
+        path = Resend::PaginationHelper.build_paginated_path(base_path, params)
+        Resend::Request.new(path, {}, "get").perform
+      end
     end
   end
 end

data/lib/resend/emails.rb

@@ -32,6 +32,17 @@ module Resend
         Resend::Request.new(path, {}, "post").perform
       end
 
+      # Create a shareable link for a sent or received email.
+      #
+      # @param email_id [String] The email id (sent or received).
+      # @param params [Hash] Optional parameters
+      # @option params [String] :expires_in Human-readable duration (e.g. "10m", "2 hours",
+      #   "1 day"). Defaults to "48h" and is capped at 48 hours.
+      def share(email_id, params = {})
+        path = "emails/#{email_id}/share"
+        Resend::Request.new(path, params, "post").perform
+      end
+
       # List emails with optional pagination.
       # see more: https://resend.com/docs/api-reference/emails/list-emails
       #
@@ -50,6 +61,64 @@ module Resend
 
         Resend::Request.new(path, query_params, "get").perform
       end
+
+      # Retrieve email metrics.
+      # see more: https://resend.com/docs/api-reference/emails/metrics
+      #
+      # @param options [Hash] Optional parameters for filtering and shaping the metrics response
+      # @option options [String] :start_date ISO 8601 date/datetime. Defaults to 6 days before :end_date
+      # @option options [String] :end_date ISO 8601 date/datetime. Defaults to now
+      # @option options [String] :timezone IANA timezone, e.g. "America/New_York". Defaults to "UTC"
+      # @option options [String] :granularity Bucket size used when :period is in :dimensions.
+      #   One of "hourly", "daily", "weekly", "monthly". Defaults to "daily"
+      # @option options [Array<String>] :metrics Metrics to include. Defaults to all metrics.
+      # @option options [Array<String>] :dimensions Dimensions to break down by: "period", "domain",
+      #   "email", "broadcast". Defaults to none, which returns totals only.
+      # @option options [Array<String>] :domain_id Restrict to these sending domain IDs (max 100)
+      # @option options [Array<String>] :email_id Restrict to these email IDs (max 100)
+      # @option options [Array<String>] :broadcast_id Restrict to these broadcast IDs (max 100)
+      def metrics(options = {})
+        path = "emails/metrics"
+        validate_metrics_options(options)
+        Resend::Request.new(path, build_metrics_query(options), "get").perform
+      end
+
+      private
+
+      # The `email` and `broadcast` dimensions/filters are mutually exclusive.
+      def validate_metrics_options(options)
+        dimensions = Array(options[:dimensions])
+        has_broadcast = dimensions.include?("broadcast") || !Array(options[:broadcast_id]).empty?
+        has_email = dimensions.include?("email") || !Array(options[:email_id]).empty?
+
+        return unless has_broadcast && has_email
+
+        raise ArgumentError,
+              "`broadcast`/`broadcast_id` cannot be combined with `email`/`email_id`"
+      end
+
+      # Builds the metrics query hash, filtering out nil values and joining
+      # list-style params (metrics, dimensions, domain_id, email_id, broadcast_id)
+      # into comma-separated strings as expected by the API.
+      def build_metrics_query(options)
+        query_params = {}
+
+        %i[start_date end_date timezone granularity].each do |key|
+          value = options[key]
+          query_params[key] = value unless blank?(value)
+        end
+
+        %i[metrics dimensions domain_id email_id broadcast_id].each do |key|
+          values = Array(options[key]).reject { |value| blank?(value) }
+          query_params[key] = values.join(",") unless values.empty?
+        end
+
+        query_params
+      end
+
+      def blank?(value)
+        value.nil? || value.to_s.empty?
+      end
     end
   end
 end

data/lib/resend/version.rb

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

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: resend
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.11.0
 platform: ruby
 authors:
 - Derich Pacheco
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-08-18 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -38,7 +37,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.22.0
-description: 
 email: carlosderich@gmail.com
 executables: []
 extensions: []
@@ -85,7 +83,6 @@ homepage: https://github.com/resend/resend-ruby
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -100,8 +97,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 4.0.16
 specification_version: 4
 summary: The Ruby and Rails SDK for resend.com
 test_files: []