zapsmtp 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 00d69f88673856daa4a932cbf520b99c6aa472b56bd19a62d22d4cca9314be47
-  data.tar.gz: d6766c40f90da24ab729d865cf0fac51223a12f445e40660a342f01d87b3c046
+  metadata.gz: cae7070cb04a2c9823d7ec950118c9182de9a0fcbe298343b5c94d5011e1a961
+  data.tar.gz: 809376c5f15a4cc3531ee4898db21279099a137b22264dcfaabdbe710efab8f4
 SHA512:
-  metadata.gz: c4ba870db4354f3a8fbc7a4e34ffb81f682ebdd38bf1e2f848458474ca06baeba65e04ed3ef135e0972eb1caa017de1306c1c4d4934efaf1d55dfb5a72a3d0b6
-  data.tar.gz: 247b91a6e1a31fa2398d6081d1f11ceb9bb032b07314fbea682069f6e3fde37a31164d3dc586b2b2377b4fd589d989a6d0b4709aa6faeefbd37c387ded685113
+  metadata.gz: 17376004cc08cf377f5fb9cf6693f0d51aee0585cac70f70835dfcbdfae5150d40caadb063dfc7c2d6ce113b957cd02052387231c182d7894606c27121bf46c4
+  data.tar.gz: ad2d12a96b56d45e5aed1934a765b01530470e363b7c2eae352ab5d7484d33017f6024b300ee8b34a14c3b1dfd5f0df1a72a48b5fc112d6063b5365b65874848

data/lib/zapsmtp/generated/client.rb

@@ -68,6 +68,12 @@ module ZapSMTP
     # @return [Resources::Variables]
     attr_reader :variables
 
+    # @return [Resources::EmailValidations]
+    attr_reader :email_validations
+
+    # @return [Resources::PlacementTests]
+    attr_reader :placement_tests
+
     private
 
     def build_resources
@@ -91,6 +97,8 @@ module ZapSMTP
       @template_timers = Resources::TemplateTimers.new(self)
       @actions = Resources::Actions.new(self)
       @variables = Resources::Variables.new(self)
+      @email_validations = Resources::EmailValidations.new(self)
+      @placement_tests = Resources::PlacementTests.new(self)
     end
   end
 end

data/lib/zapsmtp/generated/models.rb

@@ -1003,6 +1003,84 @@ module ZapSMTP
       attribute :url
     end
 
+    # EmailValidation, as the API answers it. Fields not listed here are kept too: read them with #[] or
+    # #to_h.
+    class EmailValidation < Model
+      # @!attribute [r] checks
+      #   @return [ZapSMTP::Models::EmailValidationChecks]
+      attribute :checks, "EmailValidationChecks"
+      # @!attribute [r] did_you_mean
+      #   @return [String, nil]
+      attribute :did_you_mean
+      # @!attribute [r] email
+      #   @return [String]
+      attribute :email
+      # @!attribute [r] normalized
+      #   @return [String]
+      attribute :normalized
+      # @!attribute [r] object
+      #   @return [String]
+      attribute :object
+      # @!attribute [r] reason
+      #   @return [String]
+      attribute :reason
+      # @!attribute [r] reasons
+      #   @return [Array<String>]
+      attribute :reasons
+      # @!attribute [r] result
+      #   @return [String]
+      attribute :result
+      # @!attribute [r] score
+      #   @return [Float]
+      attribute :score
+    end
+
+    # EmailValidationChecks, as the API answers it. Fields not listed here are kept too: read them with #[] or
+    # #to_h.
+    class EmailValidationChecks < Model
+      # @!attribute [r] accept_all
+      #   @return [Boolean, nil]
+      attribute :accept_all
+      # @!attribute [r] disposable
+      #   @return [Boolean]
+      attribute :disposable
+      # @!attribute [r] domain
+      #   @return [String]
+      attribute :domain
+      # @!attribute [r] free
+      #   @return [Boolean]
+      attribute :free
+      # @!attribute [r] mailbox
+      #   @return [String]
+      attribute :mailbox
+      # @!attribute [r] mx
+      #   @return [Array<String>]
+      attribute :mx
+      # @!attribute [r] previously_bounced
+      #   @return [Boolean]
+      attribute :previously_bounced
+      # @!attribute [r] role
+      #   @return [Boolean]
+      attribute :role
+      # @!attribute [r] suppressed
+      #   @return [Boolean]
+      attribute :suppressed
+      # @!attribute [r] syntax
+      #   @return [Boolean]
+      attribute :syntax
+    end
+
+    # EmailValidationList, as the API answers it. Fields not listed here are kept too: read them with #[] or
+    # #to_h.
+    class EmailValidationList < Model
+      # @!attribute [r] data
+      #   @return [Array<ZapSMTP::Models::EmailValidation>]
+      attribute :data, [:array, "EmailValidation"]
+      # @!attribute [r] object
+      #   @return [String]
+      attribute :object
+    end
+
     # ForwardDestination, as the API answers it. Fields not listed here are kept too: read them with #[] or
     # #to_h.
     class ForwardDestination < Model
@@ -1435,6 +1513,123 @@ module ZapSMTP
       attribute :suppressed
     end
 
+    # PlacementAuth, as the API answers it. Fields not listed here are kept too: read them with #[] or #to_h.
+    class PlacementAuth < Model
+      # @!attribute [r] dkim
+      #   @return [String]
+      attribute :dkim
+      # @!attribute [r] dmarc
+      #   @return [String]
+      attribute :dmarc
+      # @!attribute [r] spf
+      #   @return [String]
+      attribute :spf
+    end
+
+    # PlacementResult, as the API answers it. Fields not listed here are kept too: read them with #[] or
+    # #to_h.
+    class PlacementResult < Model
+      # @!attribute [r] address
+      #   @return [String]
+      attribute :address
+      # @!attribute [r] auth
+      #   @return [ZapSMTP::Models::PlacementAuth, nil]
+      attribute :auth, "PlacementAuth"
+      # @!attribute [r] email_id
+      #   @return [String, nil]
+      attribute :email_id
+      # @!attribute [r] folder
+      #   @return [String, nil]
+      attribute :folder
+      # @!attribute [r] placement
+      #   @return [String, nil]
+      attribute :placement
+      # @!attribute [r] provider
+      #   @return [String]
+      attribute :provider
+      # @!attribute [r] received_at
+      #   @return [String, nil]
+      attribute :received_at
+    end
+
+    # PlacementSummary, as the API answers it. Fields not listed here are kept too: read them with #[] or
+    # #to_h.
+    class PlacementSummary < Model
+      # @!attribute [r] forums
+      #   @return [Integer]
+      attribute :forums
+      # @!attribute [r] inbox
+      #   @return [Integer]
+      attribute :inbox
+      # @!attribute [r] inbox_rate
+      #   @return [Float]
+      attribute :inbox_rate
+      # @!attribute [r] missing
+      #   @return [Integer]
+      attribute :missing
+      # @!attribute [r] pending
+      #   @return [Integer]
+      attribute :pending
+      # @!attribute [r] primary
+      #   @return [Integer]
+      attribute :primary
+      # @!attribute [r] promotions
+      #   @return [Integer]
+      attribute :promotions
+      # @!attribute [r] social
+      #   @return [Integer]
+      attribute :social
+      # @!attribute [r] spam
+      #   @return [Integer]
+      attribute :spam
+      # @!attribute [r] total
+      #   @return [Integer]
+      attribute :total
+      # @!attribute [r] updates
+      #   @return [Integer]
+      attribute :updates
+    end
+
+    # PlacementTest, as the API answers it. Fields not listed here are kept too: read them with #[] or #to_h.
+    class PlacementTest < Model
+      # @!attribute [r] created_at
+      #   @return [String]
+      attribute :created_at
+      # @!attribute [r] ends_at
+      #   @return [String]
+      attribute :ends_at
+      # @!attribute [r] finished_at
+      #   @return [String, nil]
+      attribute :finished_at
+      # @!attribute [r] from
+      #   @return [String, nil]
+      attribute :from
+      # @!attribute [r] id
+      #   @return [String]
+      attribute :id
+      # @!attribute [r] mode
+      #   @return [String]
+      attribute :mode
+      # @!attribute [r] object
+      #   @return [String]
+      attribute :object
+      # @!attribute [r] results
+      #   @return [Array<ZapSMTP::Models::PlacementResult>]
+      attribute :results, [:array, "PlacementResult"]
+      # @!attribute [r] status
+      #   @return [String]
+      attribute :status
+      # @!attribute [r] subject
+      #   @return [String, nil]
+      attribute :subject
+      # @!attribute [r] summary
+      #   @return [ZapSMTP::Models::PlacementSummary]
+      attribute :summary, "PlacementSummary"
+      # @!attribute [r] token
+      #   @return [String]
+      attribute :token
+    end
+
     # ReceivedEmail, as the API answers it. Fields not listed here are kept too: read them with #[] or #to_h.
     class ReceivedEmail < Model
       # @!attribute [r] action

data/lib/zapsmtp/generated/resources.rb

@@ -2879,5 +2879,146 @@ module ZapSMTP
         )
       end
     end
+
+    # zap.email_validations
+    class EmailValidations
+      # @api private
+      def initialize(client)
+        @client = client
+      end
+
+      # Validate an address.
+      #
+      # Check one address before you send to it: syntax, the domain and its mail servers, throw-away and role
+      # addresses, typos, your suppression list and earlier hard bounces. Any API key; test keys too (nothing
+      # is sent or changed). result: deliverable (every check passed), risky (it may arrive, but sending to it
+      # can hurt your reputation), undeliverable (it will bounce) or unknown (the domain's DNS did not answer:
+      # try again later). reason is the most serious of reasons: invalid_syntax, reserved_domain,
+      # domain_not_found, no_mail_server, mailbox_not_found, previously_bounced (hard bounced on ZapSMTP in
+      # the last 180 days), dns_error, suppressed (on your suppression list), disposable, accept_all,
+      # role_address; ok when there is none. checks.mailbox is exists, not_found, unknown or not_checked.
+      # Nothing is ever sent to the address. did_you_mean suggests a likely intended address when the domain
+      # looks like a typo. Each address counts against your plan's monthly validations (Free 100, Pro 5,000,
+      # Scale 25,000); over it: 429 monthly_quota_exceeded. Results are not stored.
+      #
+      # @param params [Hash] the parameters below, also accepted as keyword arguments
+      # @option params [String] :email The address to check. Required.
+      # @param request_options [Hash] :idempotency_key, :headers, :timeout and :max_retries for this call
+      # @return [ZapSMTP::Models::EmailValidation]
+      def create(params = {}, request_options: {}, **kwargs)
+        @client.request(
+          method: :post,
+          path: "/email-validations",
+          body: Util.params(params, kwargs),
+          model: Models::EmailValidation,
+          request_options: request_options
+        )
+      end
+
+      # Validate up to 100 addresses.
+      #
+      # Check up to 100 addresses in one call; results come back in the order given. Any API key; test keys
+      # too (nothing is sent or changed). Each address counts against the plan's monthly validations; a batch
+      # that would pass the allowance is refused whole.
+      #
+      # @param params [Hash] the parameters below, also accepted as keyword arguments
+      # @option params [Array<String>] :emails 1–100 addresses, each at most 320 characters. Required.
+      # @param request_options [Hash] :idempotency_key, :headers, :timeout and :max_retries for this call
+      # @return [ZapSMTP::Models::EmailValidationList]
+      def create_batch(params = {}, request_options: {}, **kwargs)
+        @client.request(
+          method: :post,
+          path: "/email-validations/batch",
+          body: Util.params(params, kwargs),
+          model: Models::EmailValidationList,
+          request_options: request_options
+        )
+      end
+    end
+
+    # zap.placement_tests
+    class PlacementTests
+      # @api private
+      def initialize(client)
+        @client = client
+      end
+
+      # Start a placement test.
+      #
+      # Start an inbox placement test: see whether a message lands in the inbox, a Gmail tab or spam at the
+      # big mailbox providers. Requires a full-access live key; test keys get 403 test_key_restricted. With a
+      # message (from and content, or a template) one copy goes to each seed mailbox through your account,
+      # like any send (each counts as a sent email; test keys cannot). Without one the test is manual: send
+      # your message to every address in results from anywhere, with token in the subject or text, within 2
+      # hours. ZapSMTP then reads each seed mailbox (Gmail, Outlook, Yahoo and others) and records where the
+      # copy landed: inbox, a Gmail tab (promotions, social, updates, forums), spam, or missing once the test
+      # ends (15 minutes after a send). auth is the provider's own SPF, DKIM and DMARC verdict. status is
+      # running until every seed has an answer or the test ends, then done. summary.inbox_rate = inbox (any
+      # tab) / seeds with an answer. Your plan includes a number of tests a month (Free 1, Pro 10, Scale 50);
+      # over it: 429 monthly_quota_exceeded.
+      #
+      # @param params [Hash] the parameters below, also accepted as keyword arguments
+      # @option params [String] :from Sender on one of your verified domains. Leave out (with template) for a
+      #   manual test.
+      # @option params [String] :subject As in Send an email.
+      # @option params [String] :html As in Send an email.
+      # @option params [String] :text As in Send an email.
+      # @option params [Hash] :template A stored template and its variables, as in Send an email.
+      # @option params [Hash{String => String}] :headers Extra headers, as in Send an email.
+      # @option params [Array<Hash>] :tags As in Send an email.
+      # @option params [String] :stream As in Send an email.
+      # @param request_options [Hash] :idempotency_key, :headers, :timeout and :max_retries for this call
+      # @return [ZapSMTP::Models::PlacementTest]
+      def create(params = {}, request_options: {}, **kwargs)
+        @client.request(
+          method: :post,
+          path: "/placement-tests",
+          body: Util.params(params, kwargs),
+          model: Models::PlacementTest,
+          request_options: request_options
+        )
+      end
+
+      # Retrieve a placement test.
+      #
+      # Retrieve a placement test with where each copy landed. Requires a full-access key. ZapSMTP then reads
+      # each seed mailbox (Gmail, Outlook, Yahoo and others) and records where the copy landed: inbox, a Gmail
+      # tab (promotions, social, updates, forums), spam, or missing once the test ends (15 minutes after a
+      # send). auth is the provider's own SPF, DKIM and DMARC verdict. status is running until every seed has
+      # an answer or the test ends, then done. summary.inbox_rate = inbox (any tab) / seeds with an answer.
+      #
+      # @param id [String] The test id.
+      # @param request_options [Hash] :idempotency_key, :headers, :timeout and :max_retries for this call
+      # @return [ZapSMTP::Models::PlacementTest]
+      def get(id, request_options: {})
+        @client.request(
+          method: :get,
+          path: "/placement-tests/#{Util.seg("id", id)}",
+          model: Models::PlacementTest,
+          request_options: request_options
+        )
+      end
+
+      # List placement tests.
+      #
+      # List placement tests, newest first, with cursor pagination. Requires a full-access key. Pass
+      # next_cursor as after for the next page.
+      #
+      # @param params [Hash] the parameters below, also accepted as keyword arguments
+      # @option params [Integer] :limit 1-100. Limits: 422 invalid_parameter otherwise. Default: 20.
+      # @option params [String] :after A test id from next_cursor. Limits: 422 invalid_parameter otherwise.
+      # @param request_options [Hash] :idempotency_key, :headers, :timeout and :max_retries for this call
+      # @return [ZapSMTP::Page<ZapSMTP::Models::PlacementTest>]
+      def list(params = {}, request_options: {}, **kwargs)
+        @client.request_page(
+          method: :get,
+          path: "/placement-tests",
+          query: Util.params(params, kwargs),
+          model: Models::PlacementTest,
+          paging: :cursor,
+          request_options: request_options
+        )
+      end
+    end
   end
 end

data/lib/zapsmtp/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zapsmtp
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors:
 - ZapSMTP
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-11-02 00:00:00.000000000 Z
+date: 2026-11-03 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