unsent 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95a31fbac0136fab785027f7812e7b3122ea28f79dcda16dd8bcf30782d6a788
-  data.tar.gz: 893a89d9dba0d1ae63f1c96fe62d30b99bee7029cda09aa8d4d88172f3875b53
+  metadata.gz: 3654dd5977b62530b4cde2e028eb70aa08a29dbc09c0ff41d59127a831c61db0
+  data.tar.gz: d90d594fdb4db827a8cffc65f8373f53d1ccb4bf6e11e580da858a6689271775
 SHA512:
-  metadata.gz: ee78bacbfaa8d1cafe58412d8fef02d342bc01542e255257c5bc2e73ea1a94d9d2a64bdf89939c786fd0f6d4c30c4ce58a6749118c1181ebb41661fe99bff98c
-  data.tar.gz: 2ea07e0707bc12b3db46e94470521d315df377f35fd6e2b060b10ca9fedb8e38619001abfc5022d78f890f7cb238a4d1f0110e30de26a98783a17c9f5a29dd04
+  metadata.gz: f32d82928ae27864e81968b6d95e508e1c5ffc0eb8601a9456ea73f7be70fee4292e7fc134b0c5a8c2db774ea4babddcf90e67a91773c8ec2a43ba8a71e7d212
+  data.tar.gz: 97a1c68b5e3845cc052c863e6cbdcc1b5203adb187c801106c37c3ea70bfb6e81d970a25eaa5122726732b6150e721805da1c1f2f1d8396decebd291e1fcb454

data/README.md

@@ -109,6 +109,21 @@ data, error = client.emails.batch(emails)
 puts "Sent #{data['emails'].length} emails" if data
 ```
 
+#### Idempotent Retries
+
+To prevent duplicate emails when retrying failed requests, you can provide an idempotency key.
+
+```ruby
+data, error = client.emails.send({
+  to: 'user@example.com',
+  from: 'no-reply@yourdomain.com',
+  subject: 'Welcome',
+  html: '<strong>Hello!</strong>'
+}, {
+  idempotency_key: 'unique-key-123'
+})
+```
+
 ### Managing Emails
 
 #### Get Email

data/lib/unsent/client.rb

@@ -26,7 +26,7 @@ module Unsent
       @domains = Domains.new(self)
     end
 
-    def request(method, path, body = nil)
+    def request(method, path, body = nil, headers = {})
       uri = URI("#{@url}#{path}")
       http = Net::HTTP.new(uri.host, uri.port)
       http.use_ssl = uri.scheme == "https"
@@ -42,6 +42,11 @@ module Unsent
 
       request["Authorization"] = "Bearer #{@key}"
       request["Content-Type"] = "application/json"
+      
+      headers.each do |key, value|
+        request[key] = value
+      end
+
       request.body = body.to_json if body
 
       response = http.request(request)
@@ -67,24 +72,24 @@ module Unsent
       end
     end
 
-    def post(path, body)
-      request("POST", path, body)
+    def post(path, body, headers = {})
+      request("POST", path, body, headers)
     end
 
-    def get(path)
-      request("GET", path)
+    def get(path, headers = {})
+      request("GET", path, nil, headers)
     end
 
-    def put(path, body)
-      request("PUT", path, body)
+    def put(path, body, headers = {})
+      request("PUT", path, body, headers)
     end
 
-    def patch(path, body)
-      request("PATCH", path, body)
+    def patch(path, body, headers = {})
+      request("PATCH", path, body, headers)
     end
 
-    def delete(path, body = nil)
-      request("DELETE", path, body)
+    def delete(path, body = nil, headers = {})
+      request("DELETE", path, body, headers)
     end
   end
 end

data/lib/unsent/emails.rb

@@ -6,11 +6,11 @@ module Unsent
       @client = client
     end
 
-    def send(payload)
-      create(payload)
+    def send(payload, options = {})
+      create(payload, options)
     end
 
-    def create(payload)
+    def create(payload, options = {})
       # Normalize from_ to from
       payload = payload.dup
       payload[:from] = payload.delete(:from_) if payload.key?(:from_) && !payload.key?(:from)
@@ -20,10 +20,13 @@ module Unsent
         payload[:scheduledAt] = payload[:scheduledAt].iso8601
       end
 
-      @client.post("/emails", payload)
+      headers = {}
+      headers["Idempotency-Key"] = options[:idempotency_key] if options[:idempotency_key]
+
+      @client.post("/emails", payload, headers)
     end
 
-    def batch(emails)
+    def batch(emails, options = {})
       items = emails.map do |email|
         email = email.dup
         email[:from] = email.delete(:from_) if email.key?(:from_) && !email.key?(:from)
@@ -31,7 +34,10 @@ module Unsent
         email
       end
 
-      @client.post("/emails/batch", items)
+      headers = {}
+      headers["Idempotency-Key"] = options[:idempotency_key] if options[:idempotency_key]
+
+      @client.post("/emails/batch", items, headers)
     end
 
     def get(email_id)

data/lib/unsent/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Unsent
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: unsent
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - sourav