mailblastr 5.0.1 → 5.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec78acb7d963058af8b922481262fcf7b3c1d6692876f304bdd373572b7a25b9
-  data.tar.gz: 29f2b545a15086968ad83e8f6e687868d9d4c575e292839852c540a797897d1d
+  metadata.gz: 4827370704c9533943a763c3797f16b472f80655940a911111abff606769fe71
+  data.tar.gz: 9a924fc0cc8bb4d7d29c78ef6a5b3e1290c82139dee33ea05fe0009b504b2a14
 SHA512:
-  metadata.gz: d3d399fe4c0db84908d49c0aa590dadc869ef661dabf0a9b3efea01ca106ec4a36bb5050d1ac760e5bd875ebaa85117750b9d8df8607f069a303391bc4763402
-  data.tar.gz: 8be077ef5c686252a518edf896002f48af3e6ac07450b1fbd3f18cf3fdf252cb05b05d186e502d342b8a00a8e40d67ec2ee9fca11fc74889527720810d61dbfa
+  metadata.gz: 111d3d1c97ef0a2e4cf398b90327b48ac389de59f1dad3b80f8df34e16811f32385c2502c98a8672176339bdd7c5056a3467a8ed5a59f8dc14646803317c0dfc
+  data.tar.gz: 4ddd8faaba6b557b100c7177f15b9bbcdbf06df0a413088763ad8b174dc6f3fb6f69aac814445a7f8bd9dce1a4f22e2eed2ef324040de2503f63272e48db927b

data/README.md

@@ -104,6 +104,7 @@ That means `domain` (the sending domain, e.g. `"yourdomain.com"` — one of your
 Mailblastr::Emails.send({ from: from, to: to, subject: subject, html: html })
 Mailblastr::Emails.list({ limit: 20, after: cursor })   # cursor pagination
 Mailblastr::Emails.list({ status: "bounced", search: "acme.com" }) # filters
+Mailblastr::Emails.list({ folder: "scheduled" }) # one of outbox | sent | scheduled | failed — any other value is rejected (422)
 Mailblastr::Emails.sources                              # per-campaign/automation send metrics
 Mailblastr::Emails.get(email_id)
 Mailblastr::Emails.list_attachments(email_id)
@@ -182,6 +183,8 @@ Mailblastr::Contacts.list({ audience_id: aud_id, segment_id: seg_id })
 
 # Bulk import
 Mailblastr::Contacts.batch({ audience_id: aud_id, contacts: [{ email: "a@b.com" }], on_conflict: "skip" })
+# Domain-first: import straight into a domain's pool, no audience id needed.
+Mailblastr::Contacts.batch({ domain: "yourdomain.com", 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.

data/lib/mailblastr/contacts.rb

@@ -81,19 +81,34 @@ module Mailblastr
       end
 
       # Bulk-import contacts from an array (upsert by email; max 10,000).
-      # POST /audiences/:id/contacts/batch
+      #
+      # Domain-first, like .create: pass :domain for the flat
+      # POST /contacts/batch, or :audience_id for POST /audiences/:id/contacts/batch.
+      # Prefer this over a .create loop for many contacts — one batch takes the
+      # account's contact-limit lock once, a loop takes it per contact.
+      #   Contacts.batch({ domain: "yourdomain.com", contacts: [{ email: "a@b.com" }] })
       #   Contacts.batch({ audience_id: "aud_1", contacts: [{ email: "a@b.com" }], on_conflict: "skip" })
       def batch(params)
         audience_id = Client.opt(params, :audience_id)
+        # "" is truthy in Ruby but names no audience — treat it as absent and
+        # take the flat route, matching the other MailBlastr SDKs.
+        audience_id = nil if audience_id == ""
         query = {}
         on_conflict = Client.opt(params, :on_conflict)
         query[:on_conflict] = on_conflict if on_conflict
-        Client.request(
+        body = { contacts: Client.opt(params, :contacts) }
+        return Client.request(
           :post,
           "/audiences/#{Client.path_escape(audience_id)}/contacts/batch",
-          body: { contacts: Client.opt(params, :contacts) },
+          body: body,
           query: query
-        )
+        ) if audience_id
+
+        # The nested route derives its pool from the path; only the flat route
+        # takes :domain (in the body, same as POST /contacts).
+        domain = Client.opt(params, :domain)
+        body[:domain] = domain unless domain.nil?
+        Client.request(:post, "/contacts/batch", body: body, query: query)
       end
 
       # Bulk-import contacts from CSV (header row optional; upsert by email).

data/lib/mailblastr/emails.rb

@@ -27,19 +27,28 @@ module Mailblastr
 
       # List sent emails (trimmed list items) — cursor pagination plus optional
       # server-side filters: `campaign_id`, `automation_id`, `source`
-      # ("individual"), `domain_id`, `status` (matched case-insensitively
-      # against the row's `last_event`) and `search` (recipients, subject and
-      # sender). `q` is the server's alias for `search`, honoured only when
-      # `search` is absent. GET /emails
+      # ("individual" for all one-off sends with no campaign/automation origin,
+      # "api" for one-off sends made with an API key — which also covers mail
+      # sent before the send origin was recorded — or "dashboard" for one-off
+      # mail composed in the dashboard: the composer and inbox replies/forwards;
+      # honoured only when neither `campaign_id` nor `automation_id` is
+      # supplied), `domain_id`, `status` (matched case-insensitively
+      # against the row's `last_event`), `folder` (one of "outbox", "sent",
+      # "scheduled" or "failed" — any other value is rejected with a 422) and
+      # `search` (recipients, subject and sender). `q` is the server's alias
+      # for `search`, honoured only when `search` is absent. GET /emails
       def list(params = {})
         query = Client.pagination(params).merge(
-          Client.filters(params, :campaign_id, :automation_id, :source, :domain_id, :status, :search, :q)
+          Client.filters(params, :campaign_id, :automation_id, :source, :domain_id, :status, :search, :q, :folder)
         )
         Client.request(:get, "/emails", query: query)
       end
 
-      # Per-source send metrics, one row per campaign / automation / individual
-      # origin. Not paginated. GET /emails/sources
+      # Per-source send metrics, one row per origin. `kind` is "campaign",
+      # "automation", "api" (one-off API-key sends, including mail sent before
+      # the send origin was recorded) or "individual" (dashboard-composed
+      # one-offs); `id`, `name`, `subject` and `status` are null for both the
+      # "api" and "individual" rows. Not paginated. GET /emails/sources
       def sources
         Client.request(:get, "/emails/sources")
       end

data/lib/mailblastr/version.rb

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

metadata

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