duva-mail 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b62be0aef438ad137fa4db07aae85263042d924b2db6c50d70347301f62f2737
-  data.tar.gz: 231d12564797d902d3398972da4809b2e3c8b1488f9a6e7750efa2ad15bca89a
+  metadata.gz: ff3f9d91f8190516bc3d949c57d83954a1f456fea118e62b00e1d5bfc1f09881
+  data.tar.gz: a65c9b4499fc7f38c629deaaf7064ffea41f792c29f749b56692b9a6aedac833
 SHA512:
-  metadata.gz: 4133719861683e4084116674223885e0e1a3cf1eede3352725f6e492e5ec9c29665806a82fa552a0096cb775e6d4018961551b132061125f947db14f7adb381f
-  data.tar.gz: dac5abbdcf145b0f4d25258d69c478bf083adfee8e19f2f9bf8549bd6630420599cfb29cc1b5ab8b40136461c9b4ddb30e83f212f4b8a29640bd1b2a5298c97b
+  metadata.gz: '05646580b2e1f7560874564d3a9fb931d16d096f0c757722df907accd73817dbbe574f4803e272df28de536326f8e1f15c808e3d6f052446e8753aa9c9ad9852'
+  data.tar.gz: 2ef42a705a35588f967d68d899650fef804e69c3c32712d4ccdd45ff7bd71390a418a77f2d85b44f168351b27bae537f0ae3e5b81ad6f1430ec000d295f71bd5

data/README.md

@@ -30,6 +30,23 @@ puts message.id, message.status # "queued": always asynchronous
 Named `deliver`, not `send`: `Object#send` is a core Ruby method and shadowing it would be
 confusing in a `rescue`/`method_missing`-heavy codebase.
 
+### To, Cc and Bcc
+
+`to:`, `cc:` and `bcc:` take addresses or `Name <address>`. Every copy shows all the `to` and all the
+`cc`; a `bcc` address appears only on its own copy. The three lists together count against your
+plan's recipient maximum.
+
+```ruby
+duva.messages.deliver(
+  from: "Example <notifications@example.com>",
+  to: ["Jean Tremblay <jean@example.org>"],
+  cc: ["accounting@example.org"],
+  bcc: ["archive@example.com"],
+  subject: "Your order",
+  text: "Thank you for your order."
+)
+```
+
 ## Reading events and pagination
 
 ```ruby

data/lib/duva/client.rb

@@ -99,6 +99,10 @@ module Duva
     # then never create a duplicate message, but two separate calls each get their own random
     # key, so they are NOT deduplicated against each other; pass your own stable key for that
     # (e.g. an order id).
+    #
+    # `to:`, `cc:` and `bcc:` take addresses or `Name <address>`; together they count against the plan's
+    # recipient maximum. Every copy shows all the `to` and all the `cc`; a `bcc` address appears only
+    # on its own copy.
     def deliver(from:, to:, subject:, idempotency_key: nil, **fields)
       body = message_body(from: from, to: to, subject: subject, **fields)
       key = idempotency_key || SecureRandom.uuid
@@ -119,20 +123,16 @@ module Duva
 
     private
 
-    def message_body(from:, to:, subject:, html: nil, text: nil, tags: nil, tracking: nil, reply_to: nil,
-                     headers: nil, metadata: nil, attachments: nil)
+    def message_body(from:, to:, subject:, cc: nil, bcc: nil, html: nil, text: nil, tags: nil, tracking: nil,
+                     reply_to: nil, headers: nil, metadata: nil, attachments: nil)
       Attachments.assert_limits(attachments) if attachments && !attachments.empty?
       body = { "from" => from, "to" => to, "subject" => subject }
-      body["html"] = html unless html.nil?
-      body["text"] = text unless text.nil?
-      body["tags"] = tags unless tags.nil?
+      { "cc" => cc, "bcc" => bcc, "html" => html, "text" => text, "tags" => tags, "reply_to" => reply_to,
+        "headers" => headers, "metadata" => metadata }.each { |key, value| body[key] = value unless value.nil? }
       unless tracking.nil?
         body["tracking"] =
           { "opens" => tracking.fetch(:opens, false), "clicks" => tracking.fetch(:clicks, false) }
       end
-      body["reply_to"] = reply_to unless reply_to.nil?
-      body["headers"] = headers unless headers.nil?
-      body["metadata"] = metadata unless metadata.nil?
       body["attachments"] = attachments.map(&:to_h) unless attachments.nil?
       body
     end

data/lib/duva/models.rb

@@ -24,9 +24,10 @@ module Duva
     end
   end
 
-  Recipient = Data.define(:email, :status, :updated_at) do
+  Recipient = Data.define(:email, :type, :name, :status, :updated_at) do
     def self.from_json_hash(h)
-      new(email: h["email"], status: h["status"], updated_at: Models.time(h["updated_at"]))
+      new(email: h["email"], type: h["type"], name: h["name"], status: h["status"],
+          updated_at: Models.time(h["updated_at"]))
     end
   end
 

data/lib/duva.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Duva
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end
 
 require_relative "duva/errors"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: duva-mail
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - 9573-4562 Québec inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-27 00:00:00.000000000 Z
+date: 2026-10-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64