mailblastr 2.0.0 → 3.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da4eac6f929de305deb6c395655cb2658cc1ac3ee7410355846092ff6b61f66a
-  data.tar.gz: 05bfee5848400946fef957671b8bf891916bda6b7847988c531f2d5995ecb58a
+  metadata.gz: d9de7ff5dac71bd3ba5db1b38369328167f9b2a52b59974201f868299f23d35c
+  data.tar.gz: bc48385e4675d1c6ef5163e5fb7a2583b145562bf43e8a4d5d3d33f9797eecea
 SHA512:
-  metadata.gz: 1d3cd0f0741e9e55d2b6f24f34f33add0b192d305f5834fb4d481dbd70a0aacbdd8d05d516ba8797aa3201360d491a2a22bd6929a7ffdbd7b9ae57ae45ed4bbb
-  data.tar.gz: 907b8ec4abe3920ba6e94c04587cfcb72f4692420f461504f391dd6c44bc75cda2e562df73fe05911c1b40fa1e79ea8b581c948c0f64dc1f4fabd86bec489c8b
+  metadata.gz: 40472dc57967817c0071973ecb6d7f353f5a927f9261c76f035f13552d47680481caad49fcf01da8a6698996278811f23c6a8b999a6aa8312461e92d88676a0e
+  data.tar.gz: 63131860cae2becb8dddc98c36aed13e970433541b81e4c0b93732ca968ab9a7a2db9c6ee7d5630d114a2e46ea3d09c21d7a49193f7e337b98dce95bf42c7057

data/README.md

@@ -129,11 +129,11 @@ Mailblastr::Emails.send({
 
 ```ruby
 Mailblastr::Emails::Receiving.list
-Mailblastr::Emails::Receiving.addresses # per-address inbound stats
+Mailblastr::Emails::Receiving.list_addresses # per-address inbound stats
 Mailblastr::Emails::Receiving.get(id)
 Mailblastr::Emails::Receiving.list_attachments(id)
 Mailblastr::Emails::Receiving.get_attachment(id, attachment_id) # => raw bytes (String)
-Mailblastr::Emails::Receiving.raw(id)                           # => original RFC822 message
+Mailblastr::Emails::Receiving.get_raw(id)                           # => original RFC822 message
 Mailblastr::Emails::Receiving.forward(id, { from: "you@yourdomain.com", to: "team@you.com" })
 Mailblastr::Emails::Receiving.reply(id, { from: "you@yourdomain.com", html: "<p>Thanks!</p>" })
 Mailblastr::Emails::Receiving.delete(id)
@@ -182,7 +182,7 @@ Mailblastr::Contacts.batch({ audience_id: aud_id, contacts: [{ email: "a@b.com"
 Mailblastr::Contacts.import({ audience_id: aud_id, csv: "email,company\na@b.com,Acme" })
 
 # CSV too big to inline (5 MB / 10,000 rows)? Upload it directly, then import by key.
-slot = Mailblastr::Contacts.import_upload({ audience_id: aud_id, filename: "list.csv", size: bytes })
+slot = Mailblastr::Contacts.create_import_upload({ audience_id: aud_id, filename: "list.csv", size: bytes })
 # PUT the file to slot["upload_url"], then:
 Mailblastr::Contacts.import({ audience_id: aud_id, storage_key: slot["storage_key"] })
 
@@ -330,10 +330,10 @@ warn "test delivery failed: #{result['error']}" unless result["ok"]
 
 ### Verifying deliveries
 
-`verify_signature` checks the Svix-style HMAC-SHA256 signature locally (no HTTP request). Pass the **exact raw request body** — re-serializing parsed JSON breaks the signature.
+`verify` checks the Svix-style HMAC-SHA256 signature locally (no HTTP request). Pass the **exact raw request body** — re-serializing parsed JSON breaks the signature.
 
 ```ruby
-result = Mailblastr::Webhooks.verify_signature(
+result = Mailblastr::Webhooks.verify(
   request.raw_post,          # raw body string
   {
     "svix-id" => request.headers["svix-id"],

data/lib/mailblastr/contacts.rb

@@ -104,7 +104,7 @@ module Mailblastr
       #
       # Inline CSV text (capped at 5 MB and 10,000 rows):
       #   Contacts.import({ audience_id: "aud_1", csv: "email\na@b.com" })
-      # Or a file already uploaded via import_upload (no row cap — the
+      # Or a file already uploaded via create_import_upload (no row cap — the
       # overflow past your contact limit comes back as `limit_skipped`):
       #   Contacts.import({ audience_id: "aud_1", storage_key: key })
       def import(params)
@@ -125,7 +125,7 @@ module Mailblastr
       # `storage_key` to Contacts.import.
       # POST /audiences/:id/contacts/import/upload — params: { filename:, size: }
       # The `upload_url` is a bearer credential — do not log it.
-      def import_upload(params)
+      def create_import_upload(params)
         audience_id = Client.opt(params, :audience_id)
         Client.request(
           :post,

data/lib/mailblastr/emails.rb

@@ -6,6 +6,13 @@ module Mailblastr
     class << self
       # Send a single email. POST /emails
       #   Mailblastr::Emails.send({ from: "...", to: ["..."], subject: "...", html: "..." })
+      #
+      # Write ordinary links. Anchors, markdown links and bare URLs/domains in
+      # BOTH the :html and :text bodies are converted to tracked redirects at
+      # send time (when the sending domain has click tracking on), so a click is
+      # recorded whichever alternative the recipient's mail client renders.
+      # Opt-out links are never wrapped, and the content you send is stored and
+      # returned UNCHANGED — only the delivered copy carries the tracking URL.
       # Pass { idempotency_key: "order-123" } as the second argument to retry safely.
       def send(params, options = {})
         Client.request(:post, "/emails", body: params, options: options)
@@ -79,7 +86,7 @@ module Mailblastr
 
         # Per-address inbound stats (totals, replies, last received).
         # Not paginated. GET /emails/receiving/addresses
-        def addresses
+        def list_addresses
           Client.request(:get, "/emails/receiving/addresses")
         end
 
@@ -111,7 +118,7 @@ module Mailblastr
 
         # Download the original RFC822/MIME message as raw bytes (binary String).
         # GET /emails/receiving/:id/raw
-        def raw(email_id)
+        def get_raw(email_id)
           Client.request(:get, "/emails/receiving/#{Client.path_escape(email_id)}/raw", raw: true)
         end
 

data/lib/mailblastr/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mailblastr
-  VERSION = "2.0.0"
+  VERSION = "3.0.1"
 end

data/lib/mailblastr/webhooks.rb

@@ -70,9 +70,9 @@ module Mailblastr
       #
       # Returns { valid: true } or { valid: false, reason: "..." }.
       #
-      #   result = Mailblastr::Webhooks.verify_signature(request.raw_post, request.headers.to_h, secret)
+      #   result = Mailblastr::Webhooks.verify(request.raw_post, request.headers.to_h, secret)
       #   head :unauthorized unless result[:valid]
-      def verify_signature(payload, headers, secret, tolerance: 300)
+      def verify(payload, headers, secret, tolerance: 300)
         id = read_header(headers, "svix-id")
         timestamp = read_header(headers, "svix-timestamp")
         sig_header = read_header(headers, "svix-signature")

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mailblastr
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.0.1
 platform: ruby
 authors:
 - MailBlastr
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-08 00:00:00.000000000 Z
+date: 2026-08-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest