zapsmtp 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc24a438c60fcdd18984d678e23d9d4eccfe3ec7c4dcbee355b8264f85cb65ba
-  data.tar.gz: 16fe44504800b62b23e32fdc6eef068559619f12e2571ff9816941f0fed3611d
+  metadata.gz: ffeb0ccc9ba40e716b7af928e48c78e746458789aa1b74999f38f196baa98eb5
+  data.tar.gz: 79d61ce77cefcdc2d7d693dca7aab0e2d812f41a36bc056fc0fa785c765a01bc
 SHA512:
-  metadata.gz: e294de4a722034a475351173f733e066cfd17150839755191b301ce050efccde77e1243962be5e8efb7f77c0112d6248ba1c559aa5f855a50d84fbd74d8e654a
-  data.tar.gz: e38da622b2ac4a6110cfc89c4698c2b0bc7dd3f3fc6cd38ae7158753a57806c0106b0ad259bbf25a70c43084b45bceee54851213131227c3117c9670ed0acf5f
+  metadata.gz: 0c0aeee2b8a09d4b7b9bb357e37c6e53e9ba27c2bdcc15a86b54e39d50a5e84fde3e7acfe8f2f607e3676d7fb2fb82417e86395a04a4de4e6d16198f377e9ef8
+  data.tar.gz: f948e7505c1cb2a8fcd57ef63e0a3346abc0cc512e65aa10c612035e604dafa0134a141b3c77bd9a176b17f77d86f12880120362c7baa25e31a9200a59d4a045

data/lib/zapsmtp/generated/models.rb

@@ -1569,6 +1569,9 @@ module ZapSMTP
     # SendBatchResponseData, as the API answers it. Fields not listed here are kept too: read them with #[] or
     # #to_h.
     class SendBatchResponseData < Model
+      # @!attribute [r] failed_recipients
+      #   @return [Array<String>, nil]
+      attribute :failed_recipients
       # @!attribute [r] id
       #   @return [String]
       attribute :id
@@ -2061,7 +2064,7 @@ module ZapSMTP
       #   @return [Array<ZapSMTP::Models::TemplateVariableSchema>, nil]
       attribute :variable_schema, [:array, "TemplateVariableSchema"]
       # @!attribute [r] variables
-      #   @return [Hash{String => String}, nil]
+      #   @return [Hash{String => Object}, nil]
       attribute :variables
     end
 
@@ -2262,7 +2265,7 @@ module ZapSMTP
       #   @return [Integer]
       attribute :inbound_count
       # @!attribute [r] last_inbound_at
-      #   @return [String]
+      #   @return [String, nil]
       attribute :last_inbound_at
       # @!attribute [r] last_message
       #   @return [ZapSMTP::Models::ThreadLastMessage]

data/lib/zapsmtp/generated/resources.rb

@@ -20,7 +20,8 @@ module ZapSMTP
       #
       # @param id [String] Received email id
       # @param params [Hash] the parameters below, also accepted as keyword arguments
-      # @option params [Integer] :limit 1-100; when omitted or out of range all attachments are returned.
+      # @option params [Integer] :limit 1-100; when omitted all attachments are returned. Limits: 422
+      #   invalid_parameter otherwise.
       # @option params [String] :after Attachment id; returns attachments after it (ignored if unknown).
       # @option params [String] :before Attachment id; returns attachments before it (used only when after is
       #   absent).
@@ -73,7 +74,7 @@ module ZapSMTP
       # you sent through ZapSMTP.
       #
       # @param params [Hash] the parameters below, also accepted as keyword arguments
-      # @option params [Integer] :limit 1-100; out-of-range falls back to 20. Default: 20.
+      # @option params [Integer] :limit 1-100. Limits: 422 invalid_parameter otherwise. Default: 20.
       # @option params [String] :before Cursor: an email id or RFC 3339 time; returns messages received before
       #   it. An email id gives an exact page boundary. Limits: 422 invalid_parameter "before must be an email
       #   id or RFC 3339 time"
@@ -106,7 +107,10 @@ module ZapSMTP
       # status notification), out_of_office, auto_reply, auto_generated (notifications, null sender) or bulk
       # (mailing lists). Detected from Auto-Submitted, X-Autoreply, Precedence, List-Id, multipart/report and
       # well-known subjects; reason names the evidence. tls: the TLS version the sending server used (e.g.
-      # TLSv1_3); empty when the message was not encrypted.
+      # TLSv1_3); empty when the message was not encrypted. A message refused at SMTP (status: rejected: spam
+      # or a reject route) is listed but its content was never kept: it returns the listing fields, with html,
+      # text and raw null and headers empty. Its attachments, redelivery, spam reports and replies are 404;
+      # DELETE erases it.
       #
       # @param id [String] Received email id
       # @param params [Hash] the parameters below, also accepted as keyword arguments
@@ -429,7 +433,7 @@ module ZapSMTP
       # value.
       #
       # @param params [Hash] the parameters below, also accepted as keyword arguments
-      # @option params [Integer] :limit 1-100; out-of-range values fall back to 20. Default: 20.
+      # @option params [Integer] :limit 1-100. Limits: 422 invalid_parameter otherwise. Default: 20.
       # @option params [String] :before Cursor: an email id (UUIDv7) or RFC 3339 time; returns emails accepted
       #   before it. An email id gives an exact page boundary. Limits: 422 invalid_parameter "before must be an
       #   email id or RFC 3339 time"
@@ -437,14 +441,14 @@ module ZapSMTP
       #   first). Limits: 422 invalid_parameter "after must be an email id or RFC 3339 time"
       # @option params [String] :status Filter by latest status. status=scheduled lists pending scheduled
       #   sends instead (different item shape, ordered by scheduled time ascending, has_more always false, other
-      #   filters/cursors ignored). One of: queued, delivered, delivery_delayed, bounced, complained, failed,
-      #   opened, clicked, replied, suppressed, scheduled.
+      #   filters/cursors ignored, though they must be valid). One of: queued, delivered, delivery_delayed,
+      #   bounced, complained, failed, opened, clicked, replied, suppressed, scheduled.
       # @option params [String] :q Case-insensitive substring of a recipient or subject, or an exact email id.
-      # @option params [Integer] :days Look-back window in days, 1-90 (other values ignored). Always capped by
-      #   the plan's log retention. Default: 30.
+      # @option params [Integer] :days Look-back window in days, 1-90. Always capped by the plan's log
+      #   retention. Limits: 422 invalid_parameter otherwise. Default: 30.
       # @option params [String] :stream One of: transactional, broadcast.
-      # @option params [String] :mode Filter live or test-mode (sandbox) traffic; other values ignored. One
-      #   of: live, test.
+      # @option params [String] :mode Filter live or test-mode (sandbox) traffic. Limits: 422
+      #   invalid_parameter for other values. One of: live, test.
       # @option params [Hash{String => String}] :metadata Exact match on a metadata value, e.g.
       #   metadata[order_id]=A-1042. Repeatable for several keys.
       # @param request_options [Hash] :idempotency_key, :headers, :timeout and :max_retries for this call
@@ -617,14 +621,15 @@ module ZapSMTP
       # first email) is counted once the customer answers it.
       #
       # @param params [Hash] the parameters below, also accepted as keyword arguments
-      # @option params [Integer] :limit 1-100; out-of-range falls back to 20. Default: 20.
+      # @option params [Integer] :limit 1-100. Limits: 422 invalid_parameter otherwise. Default: 20.
       # @option params [String] :before Cursor: the last_message_at of the last conversation you have (RFC
       #   3339). Limits: 422 invalid_parameter otherwise.
       # @option params [String] :before_id With before: the id of the last conversation you have, so
       #   conversations active at the same instant are neither skipped nor repeated.
       # @option params [Boolean] :awaiting_reply true: only conversations whose last human email came in.
+      #   Limits: 422 invalid_parameter unless true or false.
       # @option params [Boolean] :unread true: only conversations with an email received after their read
-      #   mark.
+      #   mark. Limits: 422 invalid_parameter unless true or false.
       # @option params [String] :participant Only conversations this address took part in (case-insensitive).
       # @param request_options [Hash] :idempotency_key, :headers, :timeout and :max_retries for this call
       # @return [ZapSMTP::Page<ZapSMTP::Models::Thread>]
@@ -1102,7 +1107,7 @@ module ZapSMTP
       # events (not unique emails), ordered by status name; test-mode traffic excluded.
       #
       # @param params [Hash] the parameters below, also accepted as keyword arguments
-      # @option params [Integer] :hours 1-720; out-of-range falls back to 24. Default: 24.
+      # @option params [Integer] :hours 1-720. Limits: 422 invalid_parameter otherwise. Default: 24.
       # @param request_options [Hash] :idempotency_key, :headers, :timeout and :max_retries for this call
       # @return [ZapSMTP::Models::Stats]
       def get(params = {}, request_options: {}, **kwargs)
@@ -1121,8 +1126,8 @@ module ZapSMTP
       # empty buckets are not emitted. Test-mode traffic excluded.
       #
       # @param params [Hash] the parameters below, also accepted as keyword arguments
-      # @option params [Integer] :hours 1-720; out-of-range falls back to 24. Bucket size: <=1h → 60 s, <=6h →
-      #   300 s, <=24h → 1800 s, <=168h → 10800 s, otherwise 43200 s. Default: 24.
+      # @option params [Integer] :hours 1-720 (422 invalid_parameter otherwise). Bucket size: <=1h → 60 s,
+      #   <=6h → 300 s, <=24h → 1800 s, <=168h → 10800 s, otherwise 43200 s. Default: 24.
       # @param request_options [Hash] :idempotency_key, :headers, :timeout and :max_retries for this call
       # @return [ZapSMTP::Models::StatsTimeseries]
       def timeseries(params = {}, request_options: {}, **kwargs)
@@ -1142,7 +1147,7 @@ module ZapSMTP
       # least once.
       #
       # @param params [Hash] the parameters below, also accepted as keyword arguments
-      # @option params [Integer] :hours 1-720; out-of-range falls back to 24. Default: 24.
+      # @option params [Integer] :hours 1-720. Limits: 422 invalid_parameter otherwise. Default: 24.
       # @param request_options [Hash] :idempotency_key, :headers, :timeout and :max_retries for this call
       # @return [ZapSMTP::Models::StatsBreakdown]
       def breakdown(params = {}, request_options: {}, **kwargs)
@@ -1334,7 +1339,7 @@ module ZapSMTP
       #
       # @param id [String] Domain id.
       # @param params [Hash] the parameters below, also accepted as keyword arguments
-      # @option params [Integer] :days 1-180; out-of-range falls back to 30. Default: 30.
+      # @option params [Integer] :days 1-180. Limits: 422 invalid_parameter otherwise. Default: 30.
       # @param request_options [Hash] :idempotency_key, :headers, :timeout and :max_retries for this call
       # @return [ZapSMTP::Models::DmarcSummary]
       def get_dmarc(id, params = {}, request_options: {}, **kwargs)
@@ -2174,7 +2179,7 @@ module ZapSMTP
       # it.
       #
       # @param params [Hash] the parameters below, also accepted as keyword arguments
-      # @option params [Integer] :limit 1-1000; out-of-range falls back to 100. Default: 100.
+      # @option params [Integer] :limit 1-1000. Limits: 422 invalid_parameter otherwise. Default: 100.
       # @option params [String] :after Opaque cursor from next_cursor. Limits: 422 invalid_parameter "invalid
       #   after cursor"
       # @option params [String] :before Legacy: RFC 3339 timestamp; returns entries created before it. Ignored
@@ -2335,7 +2340,7 @@ module ZapSMTP
       # is the id of its log entry.
       #
       # @param params [Hash] the parameters below, also accepted as keyword arguments
-      # @option params [Integer] :limit 1–100. Default: 20.
+      # @option params [Integer] :limit 1–100. Limits: 422 invalid_parameter otherwise. Default: 20.
       # @option params [String] :before A log id: return older entries.
       # @option params [String] :after A log id: return newer entries.
       # @option params [String] :status An exact status (422) or a class: 2xx, 4xx, 5xx.

data/lib/zapsmtp/version.rb

@@ -2,5 +2,5 @@
 
 module ZapSMTP
   # Kept in step with the gemspec by the release script.
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zapsmtp
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - ZapSMTP
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-30 00:00:00.000000000 Z
+date: 2026-10-31 00:00:00.000000000 Z
 dependencies: []
 description: 'Send, receive and track email with ZapSMTP: every API operation, safe
   retries with idempotency keys, paging over every list, webhook signature verification