anypost 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 626219a093ae533c0f15851744e4a6eb92a42e29f793c70ac6b219c64f74f5c2
-  data.tar.gz: 840398e4b95ff4e1bbdb6c1d5b719865304c9f0625f7e6c8f5de5b19cafbf45c
+  metadata.gz: d4f2beb7843c3c48b729699c36fc03b0a839fd0a05c74384f3f0700746695c5e
+  data.tar.gz: 0a12d2a076b57cf00fdaa55916e24d53cb159de674df098d8fe53cd26e771a81
 SHA512:
-  metadata.gz: caab7720e980e41910338662984bc706b2d731b01d3ebf4938f3db65c534b2b6f3ddd67efb014439030d71e4092763a05557477f3a6dffd0a0b615652e2219d7
-  data.tar.gz: db2311ea2c576f98d120fb5e5f07c6914b3e4ee0c92a3fe64b94a7e294418a19b95529576070531f7ffb03a7f2393982a1581014ea0bcce34f6120c97da3b84f
+  metadata.gz: 1cfad0e0062488f04315140910e1382d0f3dac314df889cb91aac7bea2d3d596c6a8fe97668444342a44336e75beaf32251fa138f18c4d8ea3fab265a6e8bc4c
+  data.tar.gz: 1d8915191a1be6229cd56ae3193c42c801d845c618b6e39c955b5da897634fb90a9bc88b28593c7172746017c6c3bd4b2a68d74cf8f59cef6b968ec9687c7de8

data/README.md

@@ -62,7 +62,7 @@ client.email.send(
 )
 ```
 
-Attachment `content` is the raw file bytes: pass what `File.binread` returns and the SDK base64-encodes it. Do not pre-encode it. The request body is capped at 5 MB.
+Attachment `content` is the raw file bytes: pass what `File.binread` returns and the SDK base64-encodes it. When the content is already base64 at rest, pass it as `content_base64` instead — that string is sent verbatim, so nothing is decoded just to be re-encoded. Set exactly one of the two. The request body is capped at 5 MB.
 
 ```ruby
 client.email.send(

data/lib/anypost/resources/email.rb

@@ -4,8 +4,12 @@ module Anypost
   module Resources
     # Operations on the `/email` endpoints.
     #
-    # Attachment `content` is the raw file bytes (e.g. from `File.binread`); the
-    # SDK base64-encodes it for transport. Do not pre-encode it.
+    # Give each attachment its content exactly one of two ways: `content` for raw
+    # file bytes (e.g. from `File.binread`), which the SDK base64-encodes for
+    # transport, or `content_base64` for content that is already base64 at rest,
+    # which is sent through verbatim so nothing is decoded just to be re-encoded.
+    # Ruby has no type-level distinction between the two — both are Strings — so
+    # the key you choose is the signal.
     class Email < Base
       # Send a single message.
       #
@@ -35,13 +39,30 @@ module Anypost
         return message unless attachments.is_a?(Array)
 
         message = message.dup
-        message[:attachments] = attachments.map do |attachment|
-          content = attachment[:content]
-          next attachment unless content.is_a?(String)
+        message[:attachments] = attachments.map { |attachment| encode_attachment(attachment) }
+        message
+      end
+
+      # Collapse an attachment's two possible content keys onto the single
+      # base64 `content` field the API takes.
+      def encode_attachment(attachment)
+        return attachment unless attachment.is_a?(Hash)
+
+        raw = attachment[:content]
+        encoded = attachment[:content_base64]
 
-          attachment.merge(content: [content].pack("m0"))
+        if raw && encoded
+          raise ArgumentError,
+            "attachment #{attachment[:filename].inspect} sets both :content and " \
+            ":content_base64; set exactly one"
         end
-        message
+
+        return attachment.except(:content_base64).merge(content: encoded) if encoded
+        return attachment.merge(content: [raw].pack("m0")) if raw.is_a?(String)
+
+        raise ArgumentError,
+          "attachment #{attachment[:filename].inspect} has no content; set :content " \
+          "(raw bytes) or :content_base64"
       end
     end
   end

data/lib/anypost/version.rb

@@ -3,5 +3,5 @@
 module Anypost
   # The single source of truth for the gem version. Bump this, tag the commit
   # `vX.Y.Z`, and push — the release workflow builds and pushes to RubyGems.
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: anypost
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Anypost
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-30 00:00:00.000000000 Z
+date: 2026-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday