mailblastr 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bace5e9375b668304c40339acea2334895be7f7af3221f628ad4f7fa21762752
-  data.tar.gz: a68a14501aab6cf50309f0bb0d938dad58a5b4a96b31cb09cb9b5285f63979eb
+  metadata.gz: b33c9cbe102716978dacde6713e4cc66e25164cb91b26a0272c1f44dbcd5fab9
+  data.tar.gz: cb3b4fa5e7ba5bc85266c6cb0108e6a4a555daaf749963284d6045709ff05536
 SHA512:
-  metadata.gz: ac99877d9dc0970341b2c1b16e075dfb1f32832d6f10d6fbc220243ccd02a73597cbda5534f5918b5f28f577a2090b5becfa51f23d2e22e90f901446d76a3d1f
-  data.tar.gz: 7e0e7c62751f5042054e502964595e6ffbc6f732469dca2076bdb748031449efb0023bc5fbd1ae5d1901a4f2ce0aed999957dc82ea0b4b8d693c6416543d5225
+  metadata.gz: 480c2cff7e78425b91e649421aa0ca5f1e883188f29a4fe63b68618f68ed11cee752b7e251a30ed7f720377596af3f40cf68e1b5bf23042ed27999fc3a86e977
+  data.tar.gz: 337481b2dbd5dd2b4b788706d302ae028aa823e992804bd7681c42a696c087b479c79370e14a803493e0564a121f68c87560a60ed70e7238124599b839778b45

data/lib/mailblastr/api_keys.rb

@@ -4,7 +4,10 @@ module Mailblastr
   module ApiKeys
     class << self
       # Create an API key — the full token is returned only once, here.
-      # POST /api-keys — params: { name:, permission: "full_access"|"sending_access", domain_id: }
+      # POST /api-keys — params: { name:, permission: "full_access"|"sending_access", domain_id:, domain_ids: }
+      # domain_ids: scopes the key to one or more domains (works with both
+      # permissions); domain_id: is the legacy single-domain form. Providing
+      # both is a 422.
       def create(params)
         Client.request(:post, "/api-keys", body: params)
       end

data/lib/mailblastr/automations.rb

@@ -8,6 +8,10 @@ module Mailblastr
       # POST /automations
       #   Mailblastr::Automations.create({ name: "Welcome series", domain: "yourdomain.com",
       #                                    trigger: "contact.created" })
+      # The built-in "mailblastr:schedule" trigger fires once at
+      # `trigger_config` ({ at: ISO 8601 instant, timezone: IANA name }),
+      # enrolling every contact of the domain's pool — `trigger_config` is
+      # required with that trigger and not accepted on any other.
       def create(params)
         Client.require_domain!(params, "Automations.create")
         Client.request(:post, "/automations", body: params)
@@ -24,6 +28,8 @@ module Mailblastr
       end
 
       # PATCH /automations/:id — params: { name:, status: "enabled"|"disabled", ... }
+      # `trigger_config` ({ at:, timezone: }) updates the "mailblastr:schedule"
+      # trigger's schedule (only valid on automations with that trigger).
       def update(automation_id, params)
         Client.request(:patch, "/automations/#{Client.path_escape(automation_id)}", body: params)
       end

data/lib/mailblastr/campaigns.rb

@@ -8,6 +8,9 @@ module Mailblastr
       # POST /campaigns
       #   Mailblastr::Campaigns.create({ domain: "yourdomain.com", from: "you@yourdomain.com",
       #                                  subject: "Hello", html: "<p>Hi</p>", segment_id: "seg_1" })
+      # Optional scheduling params: `schedule_timezone` (IANA zone the schedule +
+      # daily batching are evaluated in, e.g. "America/New_York") and
+      # `daily_batch_size` (max recipients per batch-day, 1-100000).
       def create(params)
         Client.require_domain!(params, "Campaigns.create")
         Client.request(:post, "/campaigns", body: params)
@@ -23,12 +26,18 @@ module Mailblastr
         Client.request(:get, "/campaigns", query: Client.pagination(params))
       end
 
-      # PATCH /campaigns/:id
+      # PATCH /campaigns/:id (draft campaigns only). Accepts the create-side
+      # fields plus `followups` (replace pending follow-ups, [] clears),
+      # `list_to` (true/false), `unsubscribe_policy` ("account" | "domain" |
+      # "ignore"), `schedule_timezone` (IANA zone; nil clears), and
+      # `daily_batch_size` (1-100000; nil clears).
       def update(campaign_id, params)
         Client.request(:patch, "/campaigns/#{Client.path_escape(campaign_id)}", body: params)
       end
 
-      # Send now, or schedule with { scheduled_at: "..." }. POST /campaigns/:id/send
+      # Send now, or schedule with { scheduled_at: "..." }. An optional
+      # `schedule_timezone` (IANA name) is persisted onto the campaign so daily
+      # batching evaluates batch-days in that zone. POST /campaigns/:id/send
       def send(campaign_id, params = {})
         Client.request(:post, "/campaigns/#{Client.path_escape(campaign_id)}/send", body: params)
       end

data/lib/mailblastr/emails.rb

@@ -12,13 +12,22 @@ module Mailblastr
       end
 
       # Send up to 100 emails in one request. POST /emails/batch (alias of Batch.send).
+      # Batch items reject `attachments` and `scheduled_at` — send those
+      # individually via Emails.send.
       def batch(payloads, options = {})
         Client.request(:post, "/emails/batch", body: payloads, options: options)
       end
 
-      # List sent emails (trimmed list items). GET /emails
+      # List sent emails (trimmed list items) — cursor pagination plus optional
+      # server-side `campaign_id`, `automation_id`, `source` ("individual"),
+      # and `domain_id` filters. GET /emails
       def list(params = {})
-        Client.request(:get, "/emails", query: Client.pagination(params))
+        query = Client.pagination(params)
+        %i[campaign_id automation_id source domain_id].each do |k|
+          v = Client.opt(params, k)
+          query[k] = v unless v.nil?
+        end
+        Client.request(:get, "/emails", query: query)
       end
 
       # Retrieve a sent email and its events. GET /emails/:id
@@ -51,9 +60,14 @@ module Mailblastr
     # Inbound (received) email.
     module Receiving
       class << self
-        # List received emails. GET /emails/receiving
+        # List received emails — cursor pagination plus an optional
+        # `received_for` filter (only messages received for that address).
+        # GET /emails/receiving
         def list(params = {})
-          Client.request(:get, "/emails/receiving", query: Client.pagination(params))
+          query = Client.pagination(params)
+          received_for = Client.opt(params, :received_for)
+          query[:received_for] = received_for unless received_for.nil?
+          Client.request(:get, "/emails/receiving", query: query)
         end
 
         # Retrieve a received email. GET /emails/receiving/:id
@@ -103,6 +117,8 @@ module Mailblastr
   end
 
   # Batch send — Mailblastr::Batch.send([...]). POST /emails/batch
+  # Batch items reject `attachments` and `scheduled_at` — send those
+  # individually via Mailblastr::Emails.send.
   module Batch
     class << self
       def send(payloads, options = {})

data/lib/mailblastr/version.rb

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

metadata

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