unisender-ruby 0.1.0 → 0.2.0

data/lib/unisender/mail_inputs.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Unisender
+  # Named mail headers merge without silently replacing caller-supplied values.
+  module MailInputs
+    def self.normalize(params)
+      extra = headers(params)
+      result = params.except(:reply_to, :priority)
+      result[:headers] = merge(params[:headers], extra) unless extra.empty?
+      result
+    end
+
+    def self.headers(params)
+      { "Reply-To" => header(params[:reply_to]), "Priority" => header(params[:priority]) }.compact
+    end
+
+    def self.header(value)
+      return nil if value.nil?
+      unless value.is_a?(String) && !value.match?(/[\r\n]/)
+        raise ValidationError.new(field: "headers", code: :invalid_header)
+      end
+
+      value
+    end
+
+    def self.merge(original, extra)
+      return extra if original.nil?
+
+      names = extra.keys.map(&:downcase)
+      unless original.is_a?(Hash) && original.keys.none? { |key| names.include?(key.to_s.downcase) }
+        raise ValidationError.new(field: "headers", code: :conflicting_input)
+      end
+
+      original.merge(extra)
+    end
+  end
+end

data/lib/unisender/named_inputs.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Unisender
+  # Closed choices are validated only for named operations.
+  module NamedInputs
+    # @type var empty: Hash[Symbol, Array[String]]
+    empty = {}
+    EMPTY_ENUMS = empty.freeze
+    FLAGS = {
+      "setHook" => %i[single_event],
+      "getContact" => %i[include_lists include_fields include_details],
+      "createCampaign" => %i[track_read track_links track_ga],
+      "createEmailMessage" => %i[generate_text], "sendEmail" => %i[track_read track_links error_checking],
+      "importContacts" => %i[overwrite_tags overwrite_lists], "getVisitedLinks" => %i[group],
+      "getSubscriberNotes" => %i[is_pinned]
+    }.transform_values(&:freeze).freeze
+    ENUMS = {
+      "sendEmail" => { images_as: %w[attachments only_links user_default].freeze }.freeze,
+      "setHook" => { event_format: %w[json_post json_post_gzip http_get], status: %w[active disabled] },
+      "getTemplates" => { type: %w[user system].freeze }.freeze,
+      "listTemplates" => { type: %w[user system].freeze }.freeze,
+      "exclude" => { contact_type: %w[email phone].freeze }.freeze,
+      "unsubscribe" => { contact_type: %w[email phone].freeze }.freeze,
+      "getSubscriberNotes" => { order_type: %w[ASC DESC].freeze,
+                                order_by: %w[created_at updated_at pinned_at].freeze }.freeze
+    }.freeze
+
+    def self.normalize(method, params)
+      FLAGS.fetch(method, []).each { |key| flag!(key, params[key], method) }
+      ENUMS.fetch(method, EMPTY_ENUMS).each do |key, choices|
+        value = params[key]
+        params[key] = choice(value, key, choices, method) unless value.nil?
+      end
+      params
+    end
+
+    def self.flag!(key, value, operation)
+      return if value.nil? || value == true || value == false
+      return if value.is_a?(Integer) && (0..1).cover?(value)
+
+      raise ValidationError.new(field: key.to_s, code: :invalid_flag, operation:)
+    end
+
+    def self.choice(value, key, choices, operation)
+      text = value.to_s
+      text = text.upcase if key == :order_type
+      return text if (value.is_a?(String) || value.is_a?(Symbol)) && choices.include?(text)
+
+      raise ValidationError.new(field: key.to_s, code: :invalid_choice, operation:)
+    end
+  end
+end

data/lib/unisender/observation.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Unisender
+  # Metadata deliberately excludes request bodies, headers, and response payloads.
+  RequestEvent = Data.define(:operation, :attempt, :duration, :http_status, :outcome, :error_category, :request_id)
+
+  # Callback failures cannot change the outcome of an API request.
+  module Observation
+    def self.emit(callback, event)
+      return unless callback
+
+      callback.call(event)
+    rescue StandardError
+      nil
+    end
+
+    def self.event(operation, attempt, started, response, error)
+      RequestEvent.new(operation: Error.safe_operation(operation) || "request", attempt:,
+                       duration: Process.clock_gettime(Process::CLOCK_MONOTONIC) - started,
+                       http_status: response&.status, outcome: error ? :failure : :success,
+                       error_category: category(error), request_id: response&.headers&.[]("x-request-id"))
+    end
+
+    def self.category(error)
+      return nil unless error
+
+      error.is_a?(Error) ? error.category : :unexpected
+    end
+  end
+end

data/lib/unisender/operation_contracts.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module Unisender
+  # Named input shapes are checked against the public RBS in the test suite.
+  module OperationContracts
+    # rubocop:disable Layout/LineLength -- Static input contracts mirror explicit public signatures.
+    # @type var definitions: Hash[String, [String, Array[String], Hash[String, Array[String]]]]
+    definitions = {
+      "createList" => ["create_list", ["title"], { "title" => ["string"], "before_subscribe_url" => ["string"], "after_subscribe_url" => ["string"], "sub_user_rights" => ["hash"] }],
+      "deleteList" => ["delete_list", ["list_id"], { "list_id" => %w[string integer] }],
+      "exclude" => ["exclude", [], { "contact_type" => %w[string symbol], "contact" => ["string"], "email" => ["string"], "phone" => ["string"], "list_ids" => ["string", "array:string", "array:integer"] }],
+      "async/exportContacts" => ["export_contacts", [], { "notify_url" => ["string"], "list_id" => %w[string integer], "field_names" => ["array:string"], "email" => ["string"], "phone" => ["string"], "tag" => ["string"], "email_status" => ["string"], "phone_status" => ["string"], "contact_status" => ["string"] }],
+      "getContactCount" => ["get_contact_count", ["list_id"], { "list_id" => %w[string integer], "params" => ["hash"], "tag_id" => %w[string integer], "contact_type" => %w[string symbol], "search" => ["string"] }],
+      "getLists" => ["get_lists", [], {}],
+      "getTotalContactsCount" => ["get_total_contacts_count", ["login"], { "login" => ["string"] }],
+      "importContacts" => ["import_contacts", [], { "field_names" => ["array:string"], "data" => ["array:array:parameter"], "records" => ["enumerable"], "overwrite_tags" => %w[boolean integer], "overwrite_lists" => %w[boolean integer], "telegram_bot_channel_id" => ["string"] }],
+      "subscribe" => ["subscribe", ["list_ids"], { "list_ids" => ["string", "array:string", "array:integer"], "fields" => ["hash"], "email" => ["string"], "tags" => ["string", "array:string", "array:integer"], "double_optin" => %w[integer symbol], "overwrite" => %w[integer symbol] }],
+      "updateList" => ["update_list", %w[list_id title], { "list_id" => %w[string integer], "title" => ["string"], "before_subscribe_url" => ["string"], "after_subscribe_url" => ["string"], "sub_user_rights" => ["hash"] }],
+      "isContactInLists" => ["is_contact_in_lists", %w[email list_ids condition], { "email" => ["string"], "list_ids" => ["string", "array:string", "array:integer"], "condition" => ["string"] }],
+      "getContact" => ["get_contact", ["email"], { "email" => ["string"], "include_lists" => %w[boolean integer], "include_fields" => %w[boolean integer], "include_details" => %w[boolean integer] }],
+      "unsubscribe" => ["unsubscribe", [], { "contact_type" => %w[string symbol], "contact" => ["string"], "email" => ["string"], "phone" => ["string"], "list_ids" => ["string", "array:string", "array:integer"] }],
+      "cancelCampaign" => ["cancel_campaign", ["campaign_id"], { "campaign_id" => %w[string integer] }],
+      "checkEmail" => ["check_email", ["email_id"], { "email_id" => ["string", "array:string", "array:integer"] }],
+      "checkSms" => ["check_sms", ["sms_id"], { "sms_id" => %w[string integer] }],
+      "createCampaign" => ["create_campaign", ["message_id"], { "message_id" => %w[string integer], "start_time" => %w[string time], "timezone" => ["string"], "track_read" => %w[boolean integer], "track_links" => %w[boolean integer], "contacts" => ["string", "array:string", "array:integer"], "contacts_url" => ["string"], "track_ga" => %w[boolean integer], "payment_limit" => %w[integer float], "payment_currency" => ["string"], "ga_medium" => ["string"], "ga_source" => ["string"], "ga_campaign" => ["string"], "ga_content" => ["string"], "ga_term" => ["string"] }],
+      "createEmailMessage" => ["create_email_message", %w[list_id sender_name sender_email], { "sender_name" => ["string"], "sender_email" => ["string"], "list_id" => %w[string integer], "subject" => ["string"], "body" => ["string"], "text_body" => ["string"], "generate_text" => %w[boolean integer], "tag" => ["string"], "attachments" => ["hash", "attachment", "array:attachment"], "lang" => ["string"], "template_id" => %w[string integer], "system_template_id" => %w[string integer], "wrap_type" => ["string"], "categories" => ["string", "array:string", "array:integer"] }],
+      "createSmsMessage" => ["create_sms_message", %w[sender body list_id], { "sender" => ["string"], "body" => ["string"], "list_id" => %w[string integer], "tag" => ["string"] }],
+      "deleteMessage" => ["delete_message", ["message_id"], { "message_id" => %w[string integer] }],
+      "getActualMessageVersion" => ["get_actual_message_version", ["message_id"], { "message_id" => %w[string integer] }],
+      "getWebVersion" => ["get_web_version", ["campaign_id"], { "campaign_id" => %w[string integer] }],
+      "sendEmail" => ["send_email", %w[email subject body list_id sender_name sender_email], { "email" => ["string"], "sender_name" => ["string"], "sender_email" => ["string"], "subject" => ["string"], "body" => ["string"], "list_id" => %w[string integer], "attachments" => ["hash", "attachment", "array:attachment"], "lang" => ["string"], "track_read" => %w[boolean integer], "track_links" => %w[boolean integer], "cc" => ["string"], "headers" => %w[string hash], "images_as" => %w[string symbol], "ref_key" => ["string"], "error_checking" => %w[boolean integer], "metadata" => ["hash"], "reply_to" => ["string"], "priority" => ["string"] }],
+      "sendSms" => ["send_sms", %w[phone sender text], { "phone" => ["string", "array:string"], "sender" => ["string"], "text" => ["string"] }],
+      "sendTestEmail" => ["send_test_email", %w[email id], { "email" => ["string", "array:string", "array:integer"], "id" => %w[string integer] }],
+      "updateEmailMessage" => ["update_email_message", ["id"], { "id" => %w[string integer], "sender_name" => ["string"], "sender_email" => ["string"], "subject" => ["string"], "body" => ["string"], "list_id" => %w[string integer], "text_body" => ["string"], "lang" => ["string"], "categories" => ["string", "array:string", "array:integer"] }],
+      "updateOptInEmail" => ["update_opt_in_email", %w[sender_name sender_email subject body list_id], { "sender_name" => ["string"], "sender_email" => ["string"], "subject" => ["string"], "body" => ["string"], "list_id" => %w[string integer] }],
+      "getSenderDomainList" => ["get_sender_domain_list", ["username"], { "username" => ["string"], "domain" => ["string"], "limit" => ["integer"], "offset" => ["integer"] }],
+      "getCampaignCommonStats" => ["get_campaign_common_stats", ["campaign_id"], { "campaign_id" => %w[string integer] }],
+      "async/getCampaignDeliveryStats" => ["get_campaign_delivery_stats", ["campaign_id"], { "campaign_id" => %w[string integer], "notify_url" => ["string"], "changed_since" => %w[string time], "field_ids" => ["array:string", "array:integer"] }],
+      "getCampaignStatus" => ["get_campaign_status", ["campaign_id"], { "campaign_id" => %w[string integer] }],
+      "getMessages" => ["get_messages", %w[date_from date_to], { "date_from" => %w[string time], "date_to" => %w[string time], "limit" => ["integer"], "offset" => ["integer"] }],
+      "getVisitedLinks" => ["get_visited_links", ["campaign_id"], { "campaign_id" => %w[string integer], "group" => %w[boolean integer] }],
+      "listMessages" => ["list_messages", %w[date_from date_to], { "date_from" => %w[string time], "date_to" => %w[string time], "limit" => ["integer"], "offset" => ["integer"] }],
+      "getCampaigns" => ["get_campaigns", ["from"], { "from" => %w[string time], "to" => %w[string time], "limit" => ["integer"], "offset" => ["integer"] }],
+      "getMessage" => ["get_message", ["id"], { "id" => %w[string integer] }],
+      "async/getTaskResult" => ["get_task_result", ["task_uuid"], { "task_uuid" => ["string"] }],
+      "createEmailTemplate" => ["create_email_template", %w[title subject body], { "title" => ["string"], "subject" => ["string"], "body" => ["string"], "description" => ["string"], "text_body" => ["string"], "lang" => ["string"] }],
+      "deleteTemplate" => ["delete_template", ["template_id"], { "template_id" => %w[string integer] }],
+      "getTemplate" => ["get_template", [], { "template_id" => %w[string integer], "system_template_id" => %w[string integer] }],
+      "getTemplates" => ["get_templates", [], { "type" => %w[string symbol], "date_from" => %w[string time], "date_to" => %w[string time], "limit" => ["integer"], "offset" => ["integer"] }],
+      "listTemplates" => ["list_templates", [], { "type" => %w[string symbol], "date_from" => %w[string time], "date_to" => %w[string time], "limit" => ["integer"], "offset" => ["integer"] }],
+      "updateEmailTemplate" => ["update_email_template", ["template_id"], { "template_id" => %w[string integer], "title" => ["string"], "description" => ["string"], "subject" => ["string"], "body" => ["string"], "text_body" => ["string"], "lang" => ["string"] }],
+      "createField" => ["create_field", %w[name type], { "name" => ["string"], "type" => ["string"], "public_name" => ["string"] }],
+      "deleteField" => ["delete_field", ["id"], { "id" => %w[string integer] }],
+      "deleteTag" => ["delete_tag", ["id"], { "id" => %w[string integer] }],
+      "getFields" => ["get_fields", [], {}],
+      "getTags" => ["get_tags", [], {}],
+      "updateField" => ["update_field", %w[id name], { "id" => %w[string integer], "name" => ["string"], "public_name" => ["string"] }],
+      "getContactFieldValues" => ["get_contact_field_values", %w[email field_ids], { "email" => ["string"], "field_ids" => ["string", "array:string", "array:integer"] }],
+      "createSubscriberNote" => ["create_subscriber_note", %w[subscriber_id content], { "subscriber_id" => %w[string integer], "content" => ["string"] }],
+      "updateSubscriberNote" => ["update_subscriber_note", %w[id content], { "id" => %w[string integer], "content" => ["string"] }],
+      "deleteSubscriberNote" => ["delete_subscriber_note", ["id"], { "id" => %w[string integer] }],
+      "getSubscriberNote" => ["get_subscriber_note", ["id"], { "id" => %w[string integer] }],
+      "getSubscriberNotes" => ["get_subscriber_notes", ["subscriber_id"], { "subscriber_id" => %w[string integer], "limit" => ["integer"], "offset" => ["integer"], "order_type" => %w[string symbol], "order_by" => %w[string symbol], "is_pinned" => %w[boolean integer] }],
+      "setHook" => ["set_hook", %w[hook_url events], { "hook_url" => ["string"], "events" => ["hash"], "event_format" => %w[symbol string], "max_parallel" => ["integer"], "single_event" => %w[boolean integer], "status" => %w[symbol string] }],
+      "listHooks" => ["list_hooks", [], {}],
+      "removeHook" => ["remove_hook", ["hook_url"], { "hook_url" => ["string"] }]
+    }
+    DEFINITIONS = definitions.transform_values(&:freeze).freeze
+    # rubocop:enable Layout/LineLength
+
+    def self.wire_name(name)
+      entry = DEFINITIONS.find { |_wire, definition| definition.first == name.to_s }
+      raise ArgumentError, "Unsupported named operation" unless entry
+
+      entry.first
+    end
+
+    def self.validate!(wire, params)
+      _name, required, types = DEFINITIONS.fetch(wire)
+      validate_keys!(wire, params)
+      params.each do |key, value|
+        InputTypes.validate!(value, types.fetch(key.to_s), key.to_s) unless value.nil?
+      end
+      Validation.required!(params, required)
+      extra = { "getContactCount" => %w[params], "subscribe" => %w[fields], "importContacts" => %w[field_names data],
+                "exclude" => %w[contact_type contact], "unsubscribe" => %w[contact_type contact] }
+      Validation.required!(params, extra.fetch(wire, []))
+    end
+
+    def self.validate_keys!(wire, params)
+      types = DEFINITIONS.fetch(wire).last
+      return if params.keys.all? { |key| key.is_a?(Symbol) && types.key?(key.to_s) }
+
+      raise ValidationError.new(field: "parameters", code: :unknown_keyword)
+    end
+
+    def self.comma_fields(wire)
+      {
+        "subscribe" => %w[list_ids tags], "exclude" => %w[list_ids], "unsubscribe" => %w[list_ids],
+        "checkEmail" => %w[email_id], "createCampaign" => %w[contacts],
+        "createEmailMessage" => %w[categories], "updateEmailMessage" => %w[categories],
+        "sendTestEmail" => %w[email], "getContactFieldValues" => %w[field_ids]
+      }.fetch(wire, [])
+    end
+  end
+end

data/lib/unisender/operations/contacts_1.rb

@@ -16,8 +16,8 @@ module Unisender
     end
 
     # https://www.unisender.com/ru/support/api/contacts/exclude/
-    def exclude(contact_type:, contact:, list_ids: nil)
-      params = { contact_type:, contact:, list_ids: }
+    def exclude(contact_type: nil, contact: nil, email: nil, phone: nil, list_ids: nil)
+      params = ContactInputs.contact_selector({ contact_type:, contact:, email:, phone:, list_ids: }, "exclude")
       invoke("exclude", params, required: %w[contact_type contact], comma: %w[list_ids])
     end
 
@@ -31,7 +31,8 @@ module Unisender
     end
 
     # https://www.unisender.com/ru/support/api/contacts/getcontactcount/
-    def get_contact_count(list_id:, params:)
+    def get_contact_count(list_id:, params: nil, tag_id: nil, contact_type: nil, search: nil)
+      params = ContactInputs.count_filters(params, tag_id, contact_type, search)
       params = { list_id:, params: }
       invoke("getContactCount", params, required: %w[list_id params])
     end

data/lib/unisender/operations/contacts_2.rb

@@ -4,14 +4,26 @@ module Unisender
   # Contacts operations from the official UniSender API.
   class Client
     # https://www.unisender.com/ru/support/api/contacts/importcontacts/
-    def import_contacts(field_names:, data:, overwrite_tags: nil, overwrite_lists: nil,
+    # rubocop:disable-next Metrics/ParameterLists -- Accepts either records or the documented matrix form.
+    def import_contacts(field_names: nil, data: nil, records: nil, overwrite_tags: nil, overwrite_lists: nil,
                         telegram_bot_channel_id: nil)
+      if records
+        if field_names || data
+          raise ValidationError.new(field: "records", code: :conflicting_input, operation: "importContacts")
+        end
+
+        rows = RecordRows.bounded(records)
+        data = rows.to_a
+        field_names = rows.field_names
+      end
       params = { field_names:, data:, overwrite_tags:, overwrite_lists:, telegram_bot_channel_id: }
       invoke("importContacts", params, required: %w[field_names data])
     end
 
     # https://www.unisender.com/ru/support/api/contacts/subscribe/
-    def subscribe(list_ids:, fields:, tags: nil, double_optin: nil, overwrite: nil)
+    # rubocop:disable-next Metrics/ParameterLists -- Adds email to the documented subscription options.
+    def subscribe(list_ids:, fields: nil, email: nil, tags: nil, double_optin: nil, overwrite: nil)
+      fields = Inputs.contact_fields(fields, email)
       params = { list_ids:, fields:, tags:, double_optin:, overwrite: }
       invoke("subscribe", params, required: %w[list_ids fields], comma: %w[list_ids tags])
     end
@@ -29,6 +41,13 @@ module Unisender
       invoke("isContactInLists", params, required: %w[email list_ids condition], comma: %w[list_ids])
     end
 
+    def contact_in_lists?(email:, list_ids:, condition:)
+      wire = { any: "or", all: "and" }.fetch(condition) do
+        raise ValidationError.new(field: "condition", code: :invalid_choice, operation: "isContactInLists")
+      end
+      is_contact_in_lists(email:, list_ids:, condition: wire).result
+    end
+
     # https://www.unisender.com/ru/support/api/contacts/getcontact/
     def get_contact(email:, include_lists: nil, include_fields: nil, include_details: nil)
       params = { email:, include_lists:, include_fields:, include_details: }
@@ -36,8 +55,8 @@ module Unisender
     end
 
     # https://www.unisender.com/ru/support/api/contacts/unsubscribe/
-    def unsubscribe(contact_type:, contact:, list_ids: nil)
-      params = { contact_type:, contact:, list_ids: }
+    def unsubscribe(contact_type: nil, contact: nil, email: nil, phone: nil, list_ids: nil)
+      params = ContactInputs.contact_selector({ contact_type:, contact:, email:, phone:, list_ids: }, "unsubscribe")
       invoke("unsubscribe", params, required: %w[contact_type contact], comma: %w[list_ids])
     end
   end

data/lib/unisender/operations/messages_1.rb

@@ -29,18 +29,21 @@ module Unisender
       params = { message_id:, start_time:, timezone:, track_read:, track_links:, contacts:, contacts_url:,
                  track_ga:, payment_limit:, payment_currency:, ga_medium:, ga_source:, ga_campaign:,
                  ga_content:, ga_term: }
-      invoke("createCampaign", params, required: %w[message_id], comma: %w[contacts])
+      invoke("createCampaign", params, required: CAMPAIGN_REQUIRED, comma: %w[contacts])
     end
 
     # https://www.unisender.com/ru/support/api/messages/createemailmessage/
+    # rubocop:disable Layout/LineLength -- The static annotation mirrors the complete keyword signature.
+    # @type method create_email_message: (?sender_name: (String | Symbol)?, ?sender_email: (String | Symbol)?, list_id: id, ?subject: String | nil, ?body: String | nil, ?text_body: String | nil, ?generate_text: flag | nil, ?tag: String | nil, ?attachments: Hash[String, String] | Attachment | Array[Attachment] | nil, ?lang: String | Symbol | nil, ?template_id: id | nil, ?system_template_id: id | nil, ?wrap_type: String | nil, ?categories: String | Array[id] | nil) -> MessageCreatedResponse
+    # rubocop:enable Layout/LineLength
     # rubocop:disable-next Metrics/ParameterLists -- Mirrors the documented operation.
-    def create_email_message(sender_name:, sender_email:, list_id:, subject: nil, body: nil, text_body: nil,
-                             generate_text: nil, tag: nil, attachments: nil, lang: nil, template_id: nil,
+    def create_email_message(list_id:, sender_name: UNSET, sender_email: UNSET, subject: nil, body: nil, text_body: nil,
+                             generate_text: nil, tag: nil, attachments: nil, lang: UNSET, template_id: nil,
                              system_template_id: nil,
                              wrap_type: nil, categories: nil)
       params = { sender_name:, sender_email:, list_id:, subject:, body:, text_body:, generate_text:, tag:,
                  attachments:, lang:, template_id:, system_template_id:, wrap_type:, categories: }
-      invoke("createEmailMessage", params, required: %w[sender_name sender_email list_id], comma: %w[categories])
+      invoke("createEmailMessage", params, required: EMAIL_REQUIRED, comma: %w[categories])
     end
 
     # https://www.unisender.com/ru/support/api/messages/createsmsmessage/

data/lib/unisender/operations/messages_2.rb

@@ -16,12 +16,17 @@ module Unisender
     end
 
     # https://www.unisender.com/ru/support/api/messages/sendemail/
+    # rubocop:disable Layout/LineLength -- The static annotation mirrors the complete keyword signature.
+    # @type method send_email: (email: String, ?sender_name: (String | Symbol)?, ?sender_email: (String | Symbol)?, subject: String, body: String, list_id: id, ?attachments: Hash[String, String] | Attachment | Array[Attachment] | nil, ?lang: String | Symbol | nil, ?track_read: flag | nil, ?track_links: flag | nil, ?cc: String | nil, ?headers: String | params | nil, ?images_as: String | Symbol | nil, ?ref_key: String | nil, ?error_checking: flag | nil, ?metadata: params | nil, ?reply_to: String | nil, ?priority: String | nil) -> SendResponse
+    # rubocop:enable Layout/LineLength
     # rubocop:disable-next Metrics/ParameterLists -- Mirrors the documented operation.
-    def send_email(email:, sender_name:, sender_email:, subject:, body:, list_id:, attachments: nil, lang: nil,
+    def send_email(email:, subject:, body:, list_id:, sender_name: UNSET, sender_email: UNSET,
+                   attachments: nil, lang: UNSET,
                    track_read: nil, track_links: nil, cc: nil, headers: nil, images_as: nil, ref_key: nil,
-                   error_checking: nil, metadata: nil)
+                   error_checking: true, metadata: nil, reply_to: nil, priority: nil)
       params = { email:, sender_name:, sender_email:, subject:, body:, list_id:, attachments:, lang:,
-                 track_read:, track_links:, cc:, headers:, images_as:, ref_key:, error_checking:, metadata: }
+                 track_read:, track_links:, cc:, headers:, images_as:, ref_key:, error_checking:, metadata:,
+                 reply_to:, priority: }
       invoke("sendEmail", params, required: %w[email sender_name sender_email subject body list_id])
     end
 

data/lib/unisender/operations/messages_3.rb

@@ -6,7 +6,7 @@ module Unisender
     # https://www.unisender.com/ru/support/api/messages/getsenderdomainlist/
     def get_sender_domain_list(username:, domain: nil, limit: nil, offset: nil)
       params = { username:, domain:, limit:, offset: }
-      PaginatedOperations.call(self, :get_sender_domain_list, params)
+      PaginatedOperations.call(self, :get_sender_domain_list, params) # : PageResponse[SenderDomainGroup]
     end
   end
 end

data/lib/unisender/operations/notes_1.rb

@@ -32,7 +32,7 @@ module Unisender
     def get_subscriber_notes(subscriber_id:, limit: nil, offset: nil, order_type: nil, order_by: nil,
                              is_pinned: nil)
       params = { subscriber_id:, limit:, offset:, order_type:, order_by:, is_pinned: }
-      PaginatedOperations.call(self, :get_subscriber_notes, params)
+      PaginatedOperations.call(self, :get_subscriber_notes, params) # : PageResponse[Note]
     end
   end
 end

data/lib/unisender/operations/statistics_1.rb

@@ -24,7 +24,7 @@ module Unisender
     # https://www.unisender.com/ru/support/api/statistics/getmessages/
     def get_messages(date_from:, date_to:, limit: nil, offset: nil)
       params = { date_from:, date_to:, limit:, offset: }
-      PaginatedOperations.call(self, :get_messages, params)
+      PaginatedOperations.call(self, :get_messages, params) # : PageResponse[Message]
     end
 
     # https://www.unisender.com/ru/support/api/statistics/getvisitedlinks/
@@ -36,13 +36,13 @@ module Unisender
     # https://www.unisender.com/ru/support/api/statistics/listmessages/
     def list_messages(date_from:, date_to:, limit: nil, offset: nil)
       params = { date_from:, date_to:, limit:, offset: }
-      PaginatedOperations.call(self, :list_messages, params)
+      PaginatedOperations.call(self, :list_messages, params) # : PageResponse[Message]
     end
 
     # https://www.unisender.com/ru/support/api/statistics/getcampaigns/
     def get_campaigns(from:, to: nil, limit: nil, offset: nil)
       params = { from:, to:, limit:, offset: }
-      PaginatedOperations.call(self, :get_campaigns, params)
+      PaginatedOperations.call(self, :get_campaigns, params) # : PageResponse[Campaign]
     end
   end
 end

data/lib/unisender/operations/templates_1.rb

@@ -25,13 +25,13 @@ module Unisender
     # https://www.unisender.com/ru/support/api/templates/gettemplates/
     def get_templates(type: nil, date_from: nil, date_to: nil, limit: nil, offset: nil)
       params = { type:, date_from:, date_to:, limit:, offset: }
-      PaginatedOperations.call(self, :get_templates, params)
+      PaginatedOperations.call(self, :get_templates, params) # : PageResponse[Template]
     end
 
     # https://www.unisender.com/ru/support/api/templates/listtemplates/
     def list_templates(type: nil, date_from: nil, date_to: nil, limit: nil, offset: nil)
       params = { type:, date_from:, date_to:, limit:, offset: }
-      PaginatedOperations.call(self, :list_templates, params)
+      PaginatedOperations.call(self, :list_templates, params) # : PageResponse[Template]
     end
 
     # https://www.unisender.com/ru/support/api/templates/updateemailtemplate/