anypost 1.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 626219a093ae533c0f15851744e4a6eb92a42e29f793c70ac6b219c64f74f5c2
-  data.tar.gz: 840398e4b95ff4e1bbdb6c1d5b719865304c9f0625f7e6c8f5de5b19cafbf45c
+  metadata.gz: 143a52ee24a58206c7af144a0ca378aa1741e8a77faa2524ba4552aa565824af
+  data.tar.gz: 3756ec2603f282ff45c0004cccf53496829f3cba612c36ad05de01a0ff706123
 SHA512:
-  metadata.gz: caab7720e980e41910338662984bc706b2d731b01d3ebf4938f3db65c534b2b6f3ddd67efb014439030d71e4092763a05557477f3a6dffd0a0b615652e2219d7
-  data.tar.gz: db2311ea2c576f98d120fb5e5f07c6914b3e4ee0c92a3fe64b94a7e294418a19b95529576070531f7ffb03a7f2393982a1581014ea0bcce34f6120c97da3b84f
+  metadata.gz: 595ab92c756ca037038ce60ca5b89eba8cbea436776c459b20853a2ea6f5a75940c559aeb80b7704ba0ba437ed78473bb86af5e42c67549b1735351ccef759ff
+  data.tar.gz: 18a5f08424ac853a62e4dfd0c77039a75521d0b968b992bc27e3dd81397f212bf3c7ddcea9ab9357bf690971ca1d330b2b9358ac29c27174cce438a1e25424ad

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(
@@ -174,8 +174,15 @@ A suppression blocks sends to an address, scoped to a `topic`. The wildcard `*`
 client.suppressions.create(email: "alice@example.com", topic: "marketing", note: "Customer requested removal")
 
 client.suppressions.delete("alice@example.com", "marketing")
+
+client.suppressions.create_batch([
+  {email: "bob@example.com"},
+  {email: "carol@example.com", topic: "marketing", reason: "unsubscribed"}
+])
 ```
 
+`create_batch` takes up to 1,000 items per call and returns `imported`, `already_suppressed`, and `invalid`. Existing entries are left unchanged, so retrying a batch is safe, and invalid addresses are reported in `invalid` instead of failing the call. A batch that would pass your team's suppression limit raises a validation error and adds nothing. Suppressions do not expire.
+
 `get`, `list` (with `email_contains`, `topic`, `reason`, and `origin` filters), `list_for_email`, and `delete_for_email` round out the resource. See [Suppressions](https://anypost.com/docs/reference/suppressions) for scoping and the automatic-suppression rules for bounces and complaints.
 
 ## Webhooks

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/resources/suppressions.rb

@@ -4,7 +4,7 @@ module Anypost
   module Resources
     # Operations on the `/suppressions` endpoints. Entries key on `(email, topic)`.
     class Suppressions < Base
-      # List the team's suppressions, newest-first. Expired rows are filtered out.
+      # List the team's suppressions, newest-first.
       # Filter with `email_contains`, `topic`, `reason`, and `origin`.
       def list(params = {})
         paginate("/suppressions", {
@@ -23,6 +23,20 @@ module Anypost
         request_object(:post, "/suppressions", body: params)
       end
 
+      # Add up to 1,000 suppressions in one call. Pass the list of items, each a
+      # hash with `email` and optionally `topic` (default `*`), `reason` (a free-form
+      # string; common aliases like `bounce` or `opt-out` are mapped, anything else
+      # records `manual`), and `note`. Entries that already exist are counted in
+      # `already_suppressed` and left unchanged, so a batch is safe to retry.
+      # Invalid addresses come back in `invalid` (with their `index` and `email`)
+      # instead of failing the batch. Raises validation_error, adding nothing, if
+      # the batch would pass the team's suppression limit.
+      #
+      # @return [Response] with `imported`, `already_suppressed`, and `invalid`
+      def create_batch(suppressions)
+        request_object(:post, "/suppressions/batch", body: {suppressions: suppressions})
+      end
+
       # Retrieve the suppression for an `(email, topic)` pair. Use `*` as the
       # topic for the global row. Raises not_found if the pair isn't suppressed.
       def get(email, topic)

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.3.0"
 end

metadata

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