mailersend-ruby 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fb6199cff0a78e0716fd71e505603272ec11f5be3e1807932068fd0347ffe8c6
+  data.tar.gz: 60f799a1d817d792e2c0f90d94ed5e4c5b0cf1d27df00d91b5923d31574adfad
+SHA512:
+  metadata.gz: 2b3154b1ef480050c9509602e0f0192b0b55fe97af546d80f774d504fd4b28271df747f30e99121fcc4c94e2e16951d09692ef7f8559754c079d948a6bef21cf
+  data.tar.gz: fed0dbf67eaf84f36c77918a245dadfa52e6a2aedee915e5ba0a9803f4b7d81b625ae90798ef079aac3cc6c77227aa6cb66441693a46c6b10bb8127720556237

data/.env.example

@@ -0,0 +1 @@
+API_TOKEN="Bearer superlongkey"

data/.github/workflows/main.yml

@@ -0,0 +1,16 @@
+name: Ruby
+
+on: [push,pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.0.1
+        bundler-cache: true
+    - name: Run the default task
+      run: bundle exec rake

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.env
+.idea
+Gemfile.lock
+.DS_Store

data/.rubocop.yml

@@ -0,0 +1,26 @@
+AllCops:
+  TargetRubyVersion: 2.5
+  SuggestExtensions: false
+  NewCops: enable
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Layout/LineLength:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Enabled: false
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Naming/FileName:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Released]
+
+## [0.1.0] - 2021-06-14
+
+- Initial release

data/Gemfile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Nikola Milojević
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,427 @@
+<a href="https://www.mailersend.com"><img src="https://www.mailersend.com/images/logo.svg" width="200px"/></a>
+
+MailerSend Ruby SDK
+
+[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE.txt)
+
+- [Installation](#installation)
+  - [Setup](#setup)
+- [Usage](#usage)
+  - [Email](#email)
+    - [Send an email](#send-an-email)
+    - [Send and email with CC and BCC](#send-and-email-with-cc-and-bcc)
+    - [Send a templated email](#send-a-templated-email)
+    - [Advanced personalization](#advanced-personalization)
+    - [Simple personalization](#simple-personalization)
+    - [Send email with attachment](#send-email-with-attachment)
+  - [Activity](#activity)
+    - [Get a list of activities](#get-a-list-of-activities)
+  - [Analytics](#analytics)
+    - [Activity data by date](#activity-data-by-date)
+    - [Opens by country](#opens-by-country)
+    - [Opens by user-agent name](#opens-by-user-agent-name)
+    - [Opens by reading environment](#opens-by-reading-environment)
+  - [Domains](#domains)
+    - [Get a list of domains](#get-a-list-of-domains)
+    - [Get a single domain](#get-a-single-domain)
+    - [Delete a domain](#delete-a-domain)
+    - [Update domain settings](#update-domain-settings)
+  - [Messages](#messages)
+    - [Get a list of messages](#get-a-list-of-messages)
+    - [Get info for a single message](#get-info-for-a-single-message)
+  - [Recipients](#recipients)
+    - [Get recipients](#get-recipients)
+    - [Get a single recipient](#get-a-single-recipient)
+    - [Delete a recipient](#delete-a-recipient)
+  - [Tokens](#tokens)
+    - [Create a token](#create-a-token)
+    - [Update a token](#update-a-token)
+    - [Delete a token](#delete-a-token)
+  - [Webhooks](#webhooks)
+    - [List webhooks](#list-webhooks)
+    - [Get a webhook](#get-a-webhook)
+    - [Create a webhook](#create-a-webhook)
+    - [Update a webhook](#update-a-webhook)
+- [Support and Feedback](#support-and-feedback)
+- [License](#license)
+
+# Installation
+
+## Setup
+
+```bash
+gem install mailersend-ruby
+```
+
+You will have to initalize it in your Ruby file with `require "mailersend-ruby"`.
+
+# Usage
+
+This SDK requires that you either have `.env` file with `API_TOKEN` env variable or that your variable is enabled system wide (useful for Docker/Kubernetes). The example of how `API_TOKEN` should look like is in `.env.example`.
+
+## Email
+
+### Send an email
+
+```ruby
+require "mailersend-ruby"
+
+# Intialize the email class
+ms_email = Mailersend::Email.new
+
+# Add parameters
+ms_email.add_recipients("email" => "ron@parksandrec.com", "name" => "Ron")
+ms_email.add_recipients("email" => "leslie@parksandrec.com", "name" => "Leslie")
+ms_email.add_from("email" => "april@parksandrec.com", "name" => "April")
+ms_email.add_subject("Time")
+ms_email.add_text("Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.")
+ms_email.add_html("<b>Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.</b>")
+
+# Send the email
+ms_email.send
+```
+
+### Send and email with CC and BCC
+
+```ruby
+require "mailersend-ruby"
+
+# Intialize the email class
+ms_email = Mailersend::Email.new
+
+# Add parameters
+ms_email.add_recipients("email" => "ron@parksandrec.com", "name" => "Ron")
+ms_email.add_recipients("email" => "leslie@parksandrec.com", "name" => "Leslie")
+ms_email.add_cc("email" => "chris@parksandrec.com", "name" => "Chris")
+ms_email.add_bcc("email" => "andy@parksandrec.com", "name" => "Andy")
+ms_email.add_from("email" => "april@parksandrec.com", "name" => "April")
+ms_email.add_subject("Time")
+ms_email.add_text("Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.")
+ms_email.add_html("<b>Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.</b>")
+
+# Send the email
+ms_email.send
+```
+
+### Send a templated email
+
+```ruby
+require "mailersend-ruby"
+
+# Intialize the email class
+ms_email = Mailersend::Email.new
+
+# Add parameters
+ms_email.add_recipients("email" => "ron@parksandrec.com", "name" => "Ron")
+ms_email.add_recipients("email" => "leslie@parksandrec.com", "name" => "Leslie")
+ms_email.add_from("email" => "april@parksandrec.com", "name" => "April")
+ms_email.add_subject("Time")
+ms_email.add_template_id(12415125)
+
+# Send the email
+ms_email.send
+```
+
+### Advanced personalization
+
+```ruby
+require "mailersend-ruby"
+
+# Intialize the email class
+ms_email = Mailersend::Email.new
+
+# Add parameters
+ms_email.add_recipients("email" => "ron@parksandrec.com", "name" => "Ron")
+ms_email.add_recipients("email" => "leslie@parksandrec.com", "name" => "Leslie")
+ms_email.add_from("email" => "april@parksandrec.com", "name" => "April")
+ms_email.add_subject("Time")
+ms_email.add_text("Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.")
+ms_email.add_html("<b>Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.</b>")
+
+personalization = {
+  "email": "test@test.com",
+  "data": {
+    "var": "value",
+    "boolean": true,
+    "object": {
+      "key": "object-value"
+    },
+    "number": 2,
+    "array": [
+      1,
+      2,
+      3
+    ]
+  }
+}
+
+ms_email.add_personalization(personalization)
+
+ms_email.send
+```
+
+### Simple personalization
+
+```ruby
+require "mailersend-ruby"
+
+# Intialize the email class
+ms_email = Mailersend::Email.new
+
+# Add parameters
+ms_email.add_recipients("email" => "ron@parksandrec.com", "name" => "Ron")
+ms_email.add_recipients("email" => "leslie@parksandrec.com", "name" => "Leslie")
+ms_email.add_from("email" => "april@parksandrec.com", "name" => "April")
+ms_email.add_subject("Time")
+ms_email.add_text("Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.")
+ms_email.add_html("<b>Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.</b>")
+
+variables = {
+  "email": "test@test.com",
+  "substitutions": [
+    {
+      "var": "test",
+      "value": "test"
+    }
+  ]
+}
+
+ms_email.add_variables(variables)
+
+ms_email.send
+```
+
+### Send email with attachment
+
+```ruby
+require "mailersend-ruby"
+
+# Intialize the email class
+ms_email = Mailersend::Email.new
+
+# Add parameters
+ms_email.add_recipients("email" => "ron@parksandrec.com", "name" => "Ron")
+ms_email.add_recipients("email" => "leslie@parksandrec.com", "name" => "Leslie")
+ms_email.add_cc("email" => "chris@parksandrec.com", "name" => "Chris")
+ms_email.add_bcc("email" => "andy@parksandrec.com", "name" => "Andy")
+ms_email.add_from("email" => "april@parksandrec.com", "name" => "April")
+ms_email.add_subject("Time")
+ms_email.add_text("Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.")
+ms_email.add_html("<b>Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.</b>")
+
+# You can add one or multiple attachments
+ms.add_attachment(content: "/Users/Jerry/Desktop/doc.pdf", filename: "doc.pdf")
+ms.add_attachment(content: "/Users/Jerry/Desktop/pic.png", filename: "pic.png")
+
+ms_email.send
+```
+
+## Activity
+
+### Get a list of activities
+
+```ruby
+require "mailersend-ruby"
+
+ms_activity = Mailersend::Activity.new
+ms_activity.get(domain_id: "xxx2241ll", page: 3, limit: 5, date_from: 1620643567, date_to: 1623321967)
+```
+
+## Analytics
+
+### Activity data by date
+
+```ruby
+require "mailersend-ruby"
+
+ms_analytics = Mailersend::Analytics.new
+ms_analytics.date(date_from: 1620643567, date_to: 1623321967, events: %w[sent queued]))
+```
+
+### Opens by country
+
+```ruby
+require "mailersend-ruby"
+
+ms_analytics = Mailersend::Analytics.new
+ms_analytics.country(date_from: 1620643567, date_to: 1623321967)
+```
+
+### Opens by user-agent name
+
+```ruby
+require "mailersend-ruby"
+
+ms_analytics = Mailersend::Analytics.new
+ms_analytics.ua_name(date_from: 1620643567, date_to: 1623321967)
+```
+
+### Opens by reading environment
+
+```ruby
+require "mailersend-ruby"
+
+ms_analytics = Mailersend::Analytics.new
+ms_analytics.ua_type(date_from: 1620643567, date_to: 1623321967)
+```
+
+## Domains
+
+### Get a list of domains
+
+```ruby
+require "mailersend-ruby"
+
+ms_domains = Mailersend::Domains.new
+ms_domains.list
+```
+
+### Get a single domain
+
+```ruby
+require "mailersend-ruby"
+
+ms_domains = Mailersend::Domains.new
+ms_domains.list(domain_id: "idofdomain12412")
+```
+
+### Delete a domain
+
+```ruby
+require "mailersend-ruby"
+
+ms_domains = Mailersend::Domains.new
+ms_domains.delete(domain_id: "idofdomain12412")
+```
+
+### Update domain settings
+
+```ruby
+require "mailersend-ruby"
+
+ms_domains = Mailersend::Domains.new
+ms_domains.settings(domain_id: "idofdomain12412", track_clicks: true, track_unsubscribe: false)
+```
+
+## Messages
+
+### Get a list of messages
+
+```ruby
+require "mailersend-ruby"
+
+ms_messages = Mailersend::Messages.new
+ms_messages.list(page: 1, limit: 10)
+```
+
+### Get info for a single message
+
+```ruby
+require "mailersend-ruby"
+
+ms_messages = Mailersend::Messages.new
+ms_messages.single(message_id: "mess11454")
+```
+
+## Recipients
+
+### Get recipients
+
+```ruby
+require "mailersend-ruby"
+
+ms_recipients = Mailersend::Recipients.new
+ms_recipients.list(page: 1, limit: 10)
+```
+
+### Get a single recipient
+
+```ruby
+require "mailersend-ruby"
+
+ms_recipients = Mailersend::Recipients.new
+ms_recipients.single(recipient_id: "id124")
+```
+
+### Delete a recipient
+
+```ruby
+require "mailersend-ruby"
+
+ms_recipients = Mailersend::Recipients.new
+ms_recipients.delete(recipient_id: "id124")
+```
+
+## Tokens
+
+### Create a token
+```ruby
+require "mailersend-ruby"
+
+ms_tokens = Mailersend::Tokens.new
+ms_tokens.create(name: "Very nice token", scopes: %w[ email_full domains_read ])
+```
+
+### Update a token
+```ruby
+require "mailersend-ruby"
+
+ms_tokens = Mailersend::Tokens.new
+ms_tokens.update(token_id: "d2220fx04", name: "Very nice token", scopes: %w[ email_full domains_read activity_read ])
+```
+
+### Delete a token
+```ruby
+require "mailersend-ruby"
+
+ms_tokens = Mailersend::Tokens.new
+ms_tokens.delete(token_id: "d2220fx04")
+```
+
+## Webhooks
+
+### List webhooks
+```ruby
+require "mailersend-ruby"
+
+ms_webhooks = Mailersend::Webhooks.new
+ms_webhooks.list(domain_id: "xxx2241ll")
+```
+
+### Get a webhook
+```ruby
+require "mailersend-ruby"
+
+ms_webhooks = Mailersend::Webhooks.new
+ms_webhooks.list(webhook_id: "zzz2241ll")
+```
+
+### Create a webhook
+```ruby
+require "mailersend-ruby"
+
+ms_webhooks = Mailersend::Webhooks.new
+ms_webhooks.create(domain_id: "xxx2241ll", url: "https://domain.com/hook", name: "Webhook", events: ["activity.sent", "activity.delivered"], enabled: true)
+```
+
+### Update a webhook
+```ruby
+require "mailersend-ruby"
+
+ms_webhooks = Mailersend::Webhooks.new
+ms_webhooks.update(webhook_id: "zzz2241ll", enabled: false)
+```
+
+# Support and Feedback
+
+In case you find any bugs, submit an issue directly here in GitHub.
+
+You are welcome to create SDK for any other programming language.
+
+If you have any troubles using our API or SDK free to contact our support by email [info@mailersend.com](mailto:info@mailersend.com)
+
+The official documentation is at [https://developers.mailersend.com](https://developers.mailersend.com)
+
+# License
+
+[The MIT License (MIT)](LICENSE)

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: :rubocop

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require_relative "../lib/mailersend/version"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/mailersend-ruby.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "mailersend"

data/lib/mailersend.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "mailersend/client"
+require "mailersend/activity/activity"
+require "mailersend/analytics/analytics"
+require "mailersend/domains/domains"
+require "mailersend/email/email"
+require "mailersend/messages/messages"
+require "mailersend/recipients/recipients"
+require "mailersend/tokens/tokens"
+require "mailersend/webhooks/webhooks"

data/lib/mailersend/activity/activity.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Mailersend
+  # Activity endpoint from MailerSend API
+  class Activity
+    attr_accessor :client,
+                  :domain_id,
+                  :page,
+                  :limit,
+                  :date_from,
+                  :date_to
+
+    def initialize(client = Mailersend::Client.new)
+      @client = client
+      @domain_id = domain_id
+      @page = page
+      @limit = limit
+      @date_from = date_from
+      @date_to = date_to
+    end
+
+    def get(domain_id:, page: nil, limit: nil, date_from: nil, date_to: nil)
+      hash = {
+        page: page,
+        limit: limit,
+        date_from: date_from,
+        date_to: date_to
+      }
+
+      response = client.http.get(URI::HTTPS.build(host: API_BASE_HOST, path: "/v1/analytics/#{domain_id}",
+                                                  query: URI.encode_www_form(hash.compact)))
+      puts response
+    end
+  end
+end

data/lib/mailersend/analytics/analytics.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Mailersend
+  # This is a class for getting the analytics from MailerSend API.
+  class Analytics
+    attr_accessor :client,
+                  :date_from,
+                  :date_to,
+                  :events,
+                  :domain_id,
+                  :recipient_id,
+                  :group_by,
+                  :tags
+
+    def initialize(client = Mailersend::Client.new)
+      @client = client
+      @date_from = ""
+      @date_to = ""
+      @events = []
+      @domain_id = ""
+      @recipient_id = ""
+      @group_by = ""
+      @tags = []
+    end
+
+    def date(date_from:, date_to:, events:, domain_id: nil, recipient_id: nil, group_by: nil, tags: nil)
+      hash = {
+        "date_from" => date_from,
+        "date_to" => date_to,
+        "event[]" => events,
+        "domain_id" => domain_id,
+        "recipient_id" => recipient_id,
+        "group_by" => group_by,
+        "tags[]" => tags
+      }
+
+      response = client.http.get(URI::HTTPS.build(host: API_BASE_HOST, path: "/v1/analytics/date",
+                                                  query: URI.encode_www_form(hash.compact)))
+      puts response
+    end
+
+    def country(date_from:, date_to:, domain_id: nil, recipient_id: nil, tags: nil)
+      hash = {
+        domain_id: domain_id,
+        recipient_id: recipient_id,
+        date_from: date_from,
+        date_to: date_to,
+        "tags[]": tags
+      }
+
+      response = client.http.get(URI::HTTPS.build(host: API_BASE_HOST, path: "/v1/analytics/country",
+                                                  query: URI.encode_www_form(hash.compact)))
+      puts response
+    end
+
+    def ua_name(date_from:, date_to:, domain_id: nil, recipient_id: nil, tags: nil)
+      hash = {
+        domain_id: domain_id,
+        recipient_id: recipient_id,
+        date_from: date_from,
+        date_to: date_to,
+        "tags[]": tags
+      }
+
+      response = client.http.get(URI::HTTPS.build(host: API_BASE_HOST, path: "/v1/analytics/ua-name",
+                                                  query: URI.encode_www_form(hash.compact)))
+      puts response
+    end
+
+    def ua_type(date_from:, date_to:, domain_id: nil, recipient_id: nil, tags: nil)
+      hash = {
+        domain_id: domain_id,
+        recipient_id: recipient_id,
+        date_from: date_from,
+        date_to: date_to,
+        "tags[]": tags
+      }
+
+      response = client.http.get(URI::HTTPS.build(host: API_BASE_HOST, path: "/v1/analytics/ua-type",
+                                                  query: URI.encode_www_form(hash.compact)))
+      puts response
+    end
+  end
+end

data/lib/mailersend/client.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "http"
+require "dotenv/load"
+
+API_URL = "https://api.mailersend.com/v1"
+API_BASE_HOST = "api.mailersend.com"
+
+Dotenv.require_keys("API_TOKEN")
+
+# mailersend-ruby is a gem that integrates all endpoints from MailerSend API
+module Mailersend
+  attr_reader :api_token
+
+  # Inits the client.
+  class Client
+    def initialize(api_token = ENV["API_TOKEN"])
+      @api_token = api_token
+    end
+
+    def http
+      HTTP
+        .timeout(connect: 15, read: 30)
+        .auth(@api_token)
+        .headers("User-Agent" => "MailerSend-client-ruby/1.0.0",
+                 "Accept" => "application/json")
+    end
+  end
+end

data/lib/mailersend/domains/domains.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Mailersend
+  # Domains endpoint from MailerSend API
+  class Domains
+    attr_accessor :client,
+                  :domain_id,
+                  :page,
+                  :limit,
+                  :verified
+
+    def initialize(client = Mailersend.client.new)
+      @client = client
+      @domain_id = domain_id
+      @page = page
+      @limit = limit
+      @verified = verified
+    end
+
+    def list
+      hash = {
+        "page" => page,
+        "limit" => limit,
+        "verified" => verified
+      }
+      response = client.http.get(URI::HTTPS.build(host: API_BASE_HOST, path: "/v1/domains/#{domain_id}",
+                                                  query: URI.encode_www_form(hash.compact)))
+      puts response
+    end
+
+    def delete(domain_id:)
+      response = client.http.delete(URI::HTTPS.build(host: API_BASE_HOST, path: "/v1/domains/#{domain_id}"))
+      puts response
+    end
+
+    def recipients(domain_id:)
+      hash = {
+        "page" => page,
+        "limit" => limit
+      }
+      response = client.http.get(URI::HTTPS.build(host: API_BASE_HOST, path: "/v1/domains/#{domain_id}/recipients",
+                                                  query: URI.encode_www_form(hash.compact)))
+      puts response
+    end
+
+    def settings(domain_id:, send_paused: nil, track_clicks: nil, track_opens: nil, track_unsubscribe: nil, track_unsubscribe_html: nil, track_unsubscribe_plain: nil, track_content: nil, custom_tracking_enabled: nil, custom_tracking_subdomain: nil)
+      hash = {
+        "send_paused" => send_paused,
+        "track_clicks" => track_clicks,
+        "track_opens" => track_opens,
+        "track_unsubscribe" => track_unsubscribe,
+        "track_unsubscribe_html" => track_unsubscribe_html,
+        "track_unsubscribe_plain" => track_unsubscribe_plain,
+        "track_content" => track_content,
+        "custom_tracking_enabled" => custom_tracking_enabled,
+        "custom_tracking_subdomain" => custom_tracking_subdomain
+      }
+      response = client.http.put("#{API_URL}/domains/#{domain_id}/settings", json: hash.compact)
+      puts response
+    end
+  end
+end

data/lib/mailersend/email/email.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require "base64"
+
+module Mailersend
+  # Send an email through MailerSend API
+  class Email
+    attr_accessor :client,
+                  :from,
+                  :recipients,
+                  :subject,
+                  :text,
+                  :html,
+                  :ccs,
+                  :bcc,
+                  :reply_to,
+                  :attachments,
+                  :template_id,
+                  :tags,
+                  :variables,
+                  :personalization
+
+    def initialize(client = Mailersend::Client.new)
+      @client = client
+      @from = {}
+      @recipients = []
+      @ccs = []
+      @bcc = []
+      @reply_to = {}
+      @subject = nil
+      @text = {}
+      @html = {}
+      @variables = []
+      @personalization = []
+      @attachments = []
+      @tags = []
+    end
+
+    def add_recipients(recipients)
+      @recipients << recipients
+    end
+
+    def add_from(from)
+      @from = from
+    end
+
+    def add_cc(ccs)
+      @ccs << ccs
+    end
+
+    def add_bcc(bcc)
+      @bcc << bcc
+    end
+
+    def add_reply_to(_reply_to)
+      @reply_to = reply to
+    end
+
+    def add_subject(subject)
+      @subject = subject
+    end
+
+    def add_text(text)
+      @text = text
+    end
+
+    def add_html(html)
+      @html = html
+    end
+
+    def add_variables(variables)
+      @variables << variables
+    end
+
+    def add_personalization(personalization)
+      @personalization << personalization
+    end
+
+    def add_template_id(template_id)
+      @template_id = template_id
+    end
+
+    def add_tags(tags)
+      @tags << tags
+    end
+
+    def add_attachment(content:, filename:)
+      data = File.open(content.to_s).read
+      encoded = Base64.strict_encode64(data)
+      attachments << {
+        "content" => encoded,
+        "filename" => filename
+      }
+    end
+
+    def send
+      message = {
+        "from" => from,
+        "to" => recipients,
+        "cc" => ccs,
+        "bcc" => bcc,
+        "reply_to" => reply_to,
+        "subject" => subject,
+        "text" => text,
+        "html" => html,
+        "variables" => variables,
+        "personalization" => personalization,
+        "template_id" => template_id,
+        "attachments" => attachments
+      }
+
+      response = client.http.post("#{API_URL}/email", json: message.compact)
+      puts response
+      puts response.status.code
+    end
+  end
+end

data/lib/mailersend/messages/messages.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Mailersend
+  # Messages endpoint from MailerSend API.
+  class Messages
+    attr_accessor :client,
+                  :page,
+                  :limit,
+                  :message_id
+
+    def initialize(client = Mailersend::Client.new)
+      @client = client
+      @page = page
+      @limit = limit
+      @message_id = message_id
+    end
+
+    def list(page: nil, limit: nil)
+      hash = {
+        "page" => page,
+        "limit" => limit
+      }
+
+      response = client.http.get(URI::HTTPS.build(host: API_BASE_HOST, path: "/v1/messages",
+                                                  query: URI.encode_www_form(hash)))
+      puts response
+    end
+
+    def single(message_id:)
+      response = client.http.get("#{API_URL}/messages/#{message_id}")
+      puts response
+    end
+  end
+end

data/lib/mailersend/recipients/recipients.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Mailersend
+  # Recipients endpoint from MailerSend API.
+  class Recipients
+    attr_accessor :client,
+                  :page,
+                  :limit,
+                  :recipient_id
+
+    def initialize(client = Mailersend::Client.new)
+      @client = client
+      @page = page
+      @limit = limit
+      @recipient_id = recipient_id
+    end
+
+    def list(page: nil, limit: nil)
+      hash = {
+        "page" => page,
+        "limit" => limit
+      }
+
+      response = client.http.get(URI::HTTPS.build(host: API_BASE_HOST, path: "/v1/recipients",
+                                                  query: URI.encode_www_form(hash)))
+      puts response
+    end
+
+    def single(recipient_id:)
+      response = client.http.get("#{API_URL}/recipients/#{recipient_id}")
+      puts response
+    end
+
+    def delete(recipient_id:)
+      response = client.http.delete("#{API_URL}/recipients/#{recipient_id}")
+      puts response
+    end
+  end
+end

data/lib/mailersend/tokens/tokens.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Mailersend
+  # Tokens endpoint from MailerSend API.
+  class Tokens
+    attr_accessor :client,
+                  :name,
+                  :scopes,
+                  :token_id,
+                  :status
+
+    def initialize(client = Mailersend::Client.new)
+      @client = client
+      @name = {}
+      @scopes = []
+      @token_id = {}
+      @status = {}
+    end
+
+    def create(name:, scopes:)
+      json = {
+        "name" => name,
+        "scopes" => scopes
+      }
+      response = client.http.post("#{API_URL}/token", json: json)
+      puts response
+    end
+
+    def update(token_id:, status:)
+      status = {
+        status: status
+      }
+      response = client.http.put("#{API_URL}/token/#{token_id}/settings", json: status)
+      puts response
+    end
+
+    def delete(name:)
+      response = client.http.delete("#{API_URL}/token/#{name}")
+      puts response
+    end
+  end
+end

data/lib/mailersend/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Mailersend
+  VERSION = "0.1.0"
+end

data/lib/mailersend/webhooks/webhooks.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Mailersend
+  # This is a class for getting the analytics from MailerSend API.
+  class Webhooks
+    attr_accessor :client,
+                  :domain_id,
+                  :url,
+                  :name,
+                  :events,
+                  :enabled
+
+    def initialize(client = Mailersend::Client.new)
+      @client = client
+      @domain_id = domain_id
+      @url = url
+      @name = name
+      @events = []
+      @enabled = enabled
+      @events = events
+    end
+
+    def list(domain_id:)
+      hash = {
+        "domain_id" => domain_id
+      }
+      response = client.http.get(URI::HTTPS.build(host: API_BASE_HOST, path: "/v1/webhooks",
+                                                  query: URI.encode_www_form(hash)))
+      puts response
+    end
+
+    def single(webhook_id:)
+      response = client.http.get("#{API_URL}/webhooks/#{webhook_id}")
+      puts response
+    end
+
+    def create(url:, name:, events:, domain_id:, enabled: nil)
+      hash = {
+        "url" => url,
+        "name" => name,
+        "events" => events,
+        "domain_id" => domain_id,
+        "enabled" => enabled.to_s == "true"
+      }
+
+      response = client.http.post("#{API_URL}/webhooks", json: hash.compact)
+      puts response
+    end
+
+    def update(webhook_id:, url: nil, name: nil, events: nil, enabled: nil)
+      hash = {
+        "url" => url,
+        "name" => name,
+        "events" => events,
+        "enabled" => enabled.to_s == "true"
+      }
+      response = client.http.put("#{API_URL}/webhooks/#{webhook_id}", json: hash.compact)
+      puts response
+    end
+
+    def delete(webhook_id:)
+      response = client.http.delete("#{API_URL}/webhooks/#{webhook_id}")
+      puts response
+    end
+  end
+end

data/mailersend-ruby.gemspec

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+lib = File.expand_path("lib", __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "mailersend/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "mailersend-ruby"
+  spec.version       = Mailersend::VERSION
+  spec.authors       = ["Nikola Milojević"]
+  spec.email         = ["info@mailersend.com"]
+
+  spec.summary       = "MailerSend's official Ruby SDK"
+  spec.description   = "MailerSend's official Ruby SDK. Interacts will all endpoints at MailerSend API."
+  spec.homepage      = "https://www.mailersend.com"
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 2.5.0"
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/mailersend/mailersend-ruby"
+  spec.metadata["changelog_uri"] = "https://github.com/mailersend/mailersend-ruby/CHANGELOG.md"
+
+  spec.files = `git ls-files -z`.split("\x0")
+  spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 2.2.15"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rubocop", "~> 1.7"
+  spec.add_dependency "dotenv-rails", "~> 2.7"
+  spec.add_dependency "http", "~> 5.0"
+  spec.add_dependency "json", "~> 2.5"
+  spec.add_dependency "uri", "~> 0.10.1"
+end

metadata

@@ -0,0 +1,172 @@
+--- !ruby/object:Gem::Specification
+name: mailersend-ruby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nikola Milojević
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-06-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.15
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.15
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: dotenv-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: uri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.1
+description: MailerSend's official Ruby SDK. Interacts will all endpoints at MailerSend
+  API.
+email:
+- info@mailersend.com
+executables:
+- console
+- setup
+extensions: []
+extra_rdoc_files: []
+files:
+- ".env.example"
+- ".github/workflows/main.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/mailersend-ruby.rb
+- lib/mailersend.rb
+- lib/mailersend/activity/activity.rb
+- lib/mailersend/analytics/analytics.rb
+- lib/mailersend/client.rb
+- lib/mailersend/domains/domains.rb
+- lib/mailersend/email/email.rb
+- lib/mailersend/messages/messages.rb
+- lib/mailersend/recipients/recipients.rb
+- lib/mailersend/tokens/tokens.rb
+- lib/mailersend/version.rb
+- lib/mailersend/webhooks/webhooks.rb
+- mailersend-ruby.gemspec
+homepage: https://www.mailersend.com
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://www.mailersend.com
+  source_code_uri: https://github.com/mailersend/mailersend-ruby
+  changelog_uri: https://github.com/mailersend/mailersend-ruby/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.15
+signing_key:
+specification_version: 4
+summary: MailerSend's official Ruby SDK
+test_files: []