emailit 2.0.1

data/lib/emailit/services/api_key_service.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Services
+    class ApiKeyService < BaseService
+      def create(params)
+        request(:post, "/v2/api-keys", params)
+      end
+
+      def get(id)
+        request(:get, build_path("/v2/api-keys/%s", id))
+      end
+
+      def list(params = {})
+        request_collection(:get, "/v2/api-keys", params.empty? ? nil : params)
+      end
+
+      def update(id, params)
+        request(:post, build_path("/v2/api-keys/%s", id), params)
+      end
+
+      def delete(id)
+        request(:delete, build_path("/v2/api-keys/%s", id))
+      end
+    end
+  end
+end

data/lib/emailit/services/audience_service.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Services
+    class AudienceService < BaseService
+      def create(params)
+        request(:post, "/v2/audiences", params)
+      end
+
+      def get(id)
+        request(:get, build_path("/v2/audiences/%s", id))
+      end
+
+      def update(id, params)
+        request(:post, build_path("/v2/audiences/%s", id), params)
+      end
+
+      def list(params = {})
+        request_collection(:get, "/v2/audiences", params.empty? ? nil : params)
+      end
+
+      def delete(id)
+        request(:delete, build_path("/v2/audiences/%s", id))
+      end
+    end
+  end
+end

data/lib/emailit/services/base_service.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "cgi"
+
+module Emailit
+  module Services
+    class BaseService
+      def initialize(client)
+        @client = client
+      end
+
+      private
+
+      def request(method, path, params = nil)
+        response = @client.request(method, path, params)
+        obj = Util.convert_to_emailit_object(response.json)
+
+        if obj
+          obj.last_response = response
+        else
+          obj = EmailitObject.new
+        end
+
+        obj
+      end
+
+      def request_collection(method, path, params = nil)
+        response = @client.request(method, path, params)
+        obj = Util.convert_to_emailit_object(response.json)
+
+        if obj.is_a?(Collection)
+          obj.last_response = response
+          return obj
+        end
+
+        collection = Collection.new(response.json || {})
+        collection.last_response = response
+        collection
+      end
+
+      def request_raw(method, path, params = nil)
+        @client.request(method, path, params)
+      end
+
+      def build_path(pattern, *args)
+        format(pattern, *args.map { |a| CGI.escape(a.to_s) })
+      end
+    end
+  end
+end

data/lib/emailit/services/contact_service.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Services
+    class ContactService < BaseService
+      def create(params)
+        request(:post, "/v2/contacts", params)
+      end
+
+      def get(id)
+        request(:get, build_path("/v2/contacts/%s", id))
+      end
+
+      def update(id, params)
+        request(:post, build_path("/v2/contacts/%s", id), params)
+      end
+
+      def list(params = {})
+        request_collection(:get, "/v2/contacts", params.empty? ? nil : params)
+      end
+
+      def delete(id)
+        request(:delete, build_path("/v2/contacts/%s", id))
+      end
+    end
+  end
+end

data/lib/emailit/services/domain_service.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Services
+    class DomainService < BaseService
+      def create(params)
+        request(:post, "/v2/domains", params)
+      end
+
+      def get(id)
+        request(:get, build_path("/v2/domains/%s", id))
+      end
+
+      def verify(id)
+        request(:post, build_path("/v2/domains/%s/verify", id))
+      end
+
+      def update(id, params)
+        request(:patch, build_path("/v2/domains/%s", id), params)
+      end
+
+      def list(params = {})
+        request_collection(:get, "/v2/domains", params.empty? ? nil : params)
+      end
+
+      def delete(id)
+        request(:delete, build_path("/v2/domains/%s", id))
+      end
+    end
+  end
+end

data/lib/emailit/services/email_service.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Services
+    class EmailService < BaseService
+      def send(params)
+        request(:post, "/v2/emails", params)
+      end
+
+      def list(params = {})
+        request_collection(:get, "/v2/emails", params.empty? ? nil : params)
+      end
+
+      def get(id)
+        request(:get, build_path("/v2/emails/%s", id))
+      end
+
+      def get_raw(id)
+        request(:get, build_path("/v2/emails/%s/raw", id))
+      end
+
+      def get_attachments(id)
+        request_collection(:get, build_path("/v2/emails/%s/attachments", id))
+      end
+
+      def get_body(id)
+        request(:get, build_path("/v2/emails/%s/body", id))
+      end
+
+      def get_meta(id)
+        request(:get, build_path("/v2/emails/%s/meta", id))
+      end
+
+      def update(id, params)
+        request(:post, build_path("/v2/emails/%s", id), params)
+      end
+
+      def cancel(id)
+        request(:post, build_path("/v2/emails/%s/cancel", id))
+      end
+
+      def retry(id)
+        request(:post, build_path("/v2/emails/%s/retry", id))
+      end
+    end
+  end
+end

data/lib/emailit/services/email_verification_list_service.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Services
+    class EmailVerificationListService < BaseService
+      def create(params)
+        request(:post, "/v2/email-verification-lists", params)
+      end
+
+      def list(params = {})
+        request_collection(:get, "/v2/email-verification-lists", params.empty? ? nil : params)
+      end
+
+      def get(id)
+        request(:get, build_path("/v2/email-verification-lists/%s", id))
+      end
+
+      def results(id, params = {})
+        request_collection(:get, build_path("/v2/email-verification-lists/%s/results", id), params.empty? ? nil : params)
+      end
+
+      def export(id)
+        request_raw(:get, build_path("/v2/email-verification-lists/%s/export", id))
+      end
+    end
+  end
+end

data/lib/emailit/services/email_verification_service.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Services
+    class EmailVerificationService < BaseService
+      def verify(params)
+        request(:post, "/v2/email-verifications", params)
+      end
+    end
+  end
+end

data/lib/emailit/services/event_service.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Services
+    class EventService < BaseService
+      def list(params = {})
+        request_collection(:get, "/v2/events", params.empty? ? nil : params)
+      end
+
+      def get(id)
+        request(:get, build_path("/v2/events/%s", id))
+      end
+    end
+  end
+end

data/lib/emailit/services/subscriber_service.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Services
+    class SubscriberService < BaseService
+      def create(audience_id, params)
+        request(:post, build_path("/v2/audiences/%s/subscribers", audience_id), params)
+      end
+
+      def get(audience_id, subscriber_id)
+        request(:get, build_path("/v2/audiences/%s/subscribers/%s", audience_id, subscriber_id))
+      end
+
+      def update(audience_id, subscriber_id, params)
+        request(:post, build_path("/v2/audiences/%s/subscribers/%s", audience_id, subscriber_id), params)
+      end
+
+      def list(audience_id, params = {})
+        request_collection(:get, build_path("/v2/audiences/%s/subscribers", audience_id), params.empty? ? nil : params)
+      end
+
+      def delete(audience_id, subscriber_id)
+        request(:delete, build_path("/v2/audiences/%s/subscribers/%s", audience_id, subscriber_id))
+      end
+    end
+  end
+end

data/lib/emailit/services/suppression_service.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Services
+    class SuppressionService < BaseService
+      def create(params)
+        request(:post, "/v2/suppressions", params)
+      end
+
+      def get(id)
+        request(:get, build_path("/v2/suppressions/%s", id))
+      end
+
+      def update(id, params)
+        request(:post, build_path("/v2/suppressions/%s", id), params)
+      end
+
+      def list(params = {})
+        request_collection(:get, "/v2/suppressions", params.empty? ? nil : params)
+      end
+
+      def delete(id)
+        request(:delete, build_path("/v2/suppressions/%s", id))
+      end
+    end
+  end
+end

data/lib/emailit/services/template_service.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Services
+    class TemplateService < BaseService
+      def create(params)
+        request(:post, "/v2/templates", params)
+      end
+
+      def get(id)
+        request(:get, build_path("/v2/templates/%s", id))
+      end
+
+      def update(id, params)
+        request(:post, build_path("/v2/templates/%s", id), params)
+      end
+
+      def list(params = {})
+        request_collection(:get, "/v2/templates", params.empty? ? nil : params)
+      end
+
+      def delete(id)
+        request(:delete, build_path("/v2/templates/%s", id))
+      end
+
+      def publish(id)
+        request(:post, build_path("/v2/templates/%s/publish", id))
+      end
+    end
+  end
+end

data/lib/emailit/services/webhook_service.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Services
+    class WebhookService < BaseService
+      def create(params)
+        request(:post, "/v2/webhooks", params)
+      end
+
+      def get(id)
+        request(:get, build_path("/v2/webhooks/%s", id))
+      end
+
+      def update(id, params)
+        request(:post, build_path("/v2/webhooks/%s", id), params)
+      end
+
+      def list(params = {})
+        request_collection(:get, "/v2/webhooks", params.empty? ? nil : params)
+      end
+
+      def delete(id)
+        request(:delete, build_path("/v2/webhooks/%s", id))
+      end
+    end
+  end
+end

data/lib/emailit/util.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Emailit
+  module Util
+    OBJECT_TYPES = {}.freeze
+
+    def self.register_object_type(name, klass)
+      @object_types ||= {}
+      @object_types[name] = klass
+    end
+
+    def self.object_types
+      @object_types || {}
+    end
+
+    def self.convert_to_emailit_object(data)
+      return nil if data.nil?
+
+      if data.is_a?(Hash) && data["data"].is_a?(Array)
+        data["data"] = data["data"].map { |item| convert_to_emailit_object(item) }
+        collection = Collection.new(data)
+        return collection
+      end
+
+      object_type = data["object"] if data.is_a?(Hash)
+      mapping = object_types
+
+      if object_type && mapping[object_type]
+        mapping[object_type].new(data)
+      else
+        EmailitObject.new(data)
+      end
+    end
+  end
+end

data/lib/emailit/version.rb

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

data/lib/emailit/webhook_signature.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require "openssl"
+
+module Emailit
+  class WebhookSignature
+    HEADER_SIGNATURE = "x-emailit-signature"
+    HEADER_TIMESTAMP = "x-emailit-timestamp"
+    DEFAULT_TOLERANCE = 300
+
+    def self.verify(raw_body, signature, timestamp, secret, tolerance: DEFAULT_TOLERANCE)
+      if tolerance
+        age = Time.now.to_i - timestamp.to_i
+        if age > tolerance
+          raise ApiError.new(
+            "Webhook timestamp is too old. The request may be a replay attack.",
+            http_status: 401
+          )
+        end
+      end
+
+      computed = compute_signature(raw_body, timestamp, secret)
+
+      unless secure_compare(computed, signature)
+        raise ApiError.new(
+          "Webhook signature verification failed.",
+          http_status: 401
+        )
+      end
+
+      payload = begin
+        JSON.parse(raw_body)
+      rescue JSON::ParserError
+        raise ApiError.new(
+          "Invalid webhook payload: unable to decode JSON.",
+          http_status: 400
+        )
+      end
+
+      Events::WebhookEvent.construct_from(payload)
+    end
+
+    def self.compute_signature(raw_body, timestamp, secret)
+      signed_payload = "#{timestamp}.#{raw_body}"
+      OpenSSL::HMAC.hexdigest("SHA256", secret, signed_payload)
+    end
+
+    def self.secure_compare(a, b)
+      return false unless a.bytesize == b.bytesize
+
+      l = a.unpack("C*")
+      r = b.unpack("C*")
+      result = 0
+      l.zip(r) { |x, y| result |= x ^ y }
+      result.zero?
+    end
+    private_class_method :secure_compare
+  end
+end

data/lib/emailit.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "json"
+require "cgi"
+
+require_relative "emailit/version"
+require_relative "emailit/errors"
+require_relative "emailit/api_response"
+require_relative "emailit/emailit_object"
+require_relative "emailit/api_resource"
+require_relative "emailit/collection"
+require_relative "emailit/util"
+
+require_relative "emailit/resources/email"
+require_relative "emailit/resources/domain"
+require_relative "emailit/resources/api_key"
+require_relative "emailit/resources/audience"
+require_relative "emailit/resources/subscriber"
+require_relative "emailit/resources/template"
+require_relative "emailit/resources/suppression"
+require_relative "emailit/resources/email_verification"
+require_relative "emailit/resources/email_verification_list"
+require_relative "emailit/resources/webhook"
+require_relative "emailit/resources/contact"
+require_relative "emailit/resources/event"
+
+require_relative "emailit/services/base_service"
+require_relative "emailit/services/email_service"
+require_relative "emailit/services/domain_service"
+require_relative "emailit/services/api_key_service"
+require_relative "emailit/services/audience_service"
+require_relative "emailit/services/subscriber_service"
+require_relative "emailit/services/template_service"
+require_relative "emailit/services/suppression_service"
+require_relative "emailit/services/email_verification_service"
+require_relative "emailit/services/email_verification_list_service"
+require_relative "emailit/services/webhook_service"
+require_relative "emailit/services/contact_service"
+require_relative "emailit/services/event_service"
+
+require_relative "emailit/events/webhook_event"
+
+require_relative "emailit/webhook_signature"
+require_relative "emailit/base_client"
+require_relative "emailit/emailit_client"
+
+module Emailit
+  def self.client(api_key)
+    EmailitClient.new(api_key)
+  end
+
+  Util.register_object_type(Email::OBJECT_NAME, Email)
+  Util.register_object_type(Domain::OBJECT_NAME, Domain)
+  Util.register_object_type(ApiKey::OBJECT_NAME, ApiKey)
+  Util.register_object_type(Audience::OBJECT_NAME, Audience)
+  Util.register_object_type(Subscriber::OBJECT_NAME, Subscriber)
+  Util.register_object_type(Template::OBJECT_NAME, Template)
+  Util.register_object_type(Suppression::OBJECT_NAME, Suppression)
+  Util.register_object_type(EmailVerification::OBJECT_NAME, EmailVerification)
+  Util.register_object_type(EmailVerificationList::OBJECT_NAME, EmailVerificationList)
+  Util.register_object_type(Webhook::OBJECT_NAME, Webhook)
+  Util.register_object_type(Contact::OBJECT_NAME, Contact)
+  Util.register_object_type(Event::OBJECT_NAME, Event)
+end
+
+require_relative "emailit/railtie" if defined?(Rails::Railtie)