unione-ruby 0.0.2 → 1.0.0

data/lib/unione/client/template.rb

@@ -1,81 +1,34 @@
 module UniOne
   class Client
-
     module Template
+      extend UniOne::Validation::ClassMethods
+      include UniOne::Validation::InstanceMethods
 
-      def set_template(template)
-        post 'template/set.json', template
-        validate_response({
-          'type' => 'object', 'required' => ['status', 'template'], 'properties' => {
-           'status' => {'type' => 'string'},
-           'template' => template_schema}
-        })
-      end
-
-      def get_template(id)
-        params = { id: id }
-        post 'template/get.json', params
-        validate_response({
-          'type' => 'object', 'required' => ['status', 'template'], 'properties' => {
-           'status' => {'type' => 'string'},
-           'template' => template_schema}
-        })
-      end
-
-      def list_templates(limit, offset)
-        params = { limit: limit, offset: offset }
-        post 'template/list.json', params
-        list_template_schema = remove_fields_from_schema(template_schema, ['from_name', 'headers'])
-        validate_response({
-          'type' => 'object', 'required' => ['status', 'templates'], 'properties' => {
-            'status' => {'type' => 'string'},
-            'templates' => {'items' => list_template_schema}}
-        })
-      end
-
-      def delete_template(id)
-        params = { id: id }
-        post 'template/delete.json', params
-        validate_response({
-          'type' => 'object', 'required' => ['status'], 'properties' => {
-            'status' => {'type' => 'string'}}
-        })
+      def set_template(params = {})
+        post('template/set.json', params)
       end
 
-      private
-
-      def template_schema
-        {'type' => 'object', 'required' => ['id', 'name', 'editor_type', 'subject', 'from_name', 'body', 'headers', 'attachments',
-                                            'inline_attachments', 'created', 'user_id'], 'properties' => {
-           'id' => {'type' => 'string'},
-           'name' => {'type' => 'string'},
-           'editor_type' => {'type' => 'string'},
-           'subject' => {'type' => 'string'},
-           'from_name' => {'type' => 'string'},
-           'body' => template_body_schema,
-           'headers' => {'type' => 'object'},
-           'attachments' => {'items' => {'type' => 'object'}},
-           'inline_attachments' => {'items' => {'type' => 'object'}},
-           'options' => template_options_schema,
-           'created' => {'type' => 'string'},
-           'user_id' => {'type' => 'integer'},
-         }}
+      def get_template(params = {})
+        post('template/get.json', params)
       end
 
-      def template_body_schema
-        {'type' => 'object', 'required' => ['html', 'plaintext', 'amp'], 'properties' => {
-           'html' => {'type' => 'string, null'},
-           'plaintext' => {'type' => 'string, null'},
-           'amp' => {'type' => 'string, null'}
-         }}
+      def list_templates(params = {})
+        post('template/list.json', params)
       end
 
-      def template_options_schema
-        {'type' => 'object', 'required' => ['unsubscribe_url'], 'properties' => {
-           'unsubscribe_url' => {'type' => 'string'}
-         }}
+      def delete_template(params = {})
+        post('template/delete.json', params)
       end
 
+      add_response_validations(
+        :template,
+        %w(
+          set_template
+          get_template
+          list_templates
+          delete_template
+        )
+      )
     end
   end
 end

data/lib/unione/client/unsubscribed.rb

@@ -1,44 +1,31 @@
 module UniOne
   class Client
-
     module Unsubscribed
+      extend UniOne::Validation::ClassMethods
+      include UniOne::Validation::InstanceMethods
 
-      def unsubscribe(address)
-        params = { address: address }
-        post 'unsubscribed/set.json', params
-        validate_response({
-          'type' => 'object', 'required' => ['status', 'address', 'message'], 'properties' => {
-            'status' => {'type' => 'string'},
-            'address' => {'type' => 'string'},
-            'message' => {'type' => 'string'}}
-        })
+      def unsubscribe(params = {})
+        post('unsubscribed/set.json', params)
       end
 
-      def check_unsubscribed(address)
-        params = { address: address }
-        post 'unsubscribed/check.json', params
-        validate_response({
-          'type' => 'object', 'required' => ['status', 'address', 'is_unsubscribed'], 'properties' => {
-            'status' => {'type' => 'string'},
-            'address' => {'type' => 'string'},
-            'is_unsubscribed' => {'type' => 'boolean'}}
-        })
+      def check_unsubscribed(params = {})
+        post('unsubscribed/check.json', params)
       end
 
-      def list_unsubscribed(date_from)
-        params = { date_from: date_from }
-        post 'unsubscribed/list.json', params
-        validate_response({
-          'type' => 'object', 'required' => ['status', 'unsubscribed'], 'properties' => {
-            'status' => {'type' => 'string'},
-            'unsubscribed' => {
-              'items' => {'type' => 'object'}, 'required' => ['address', 'unsubscribed_on'], 'properties' => {
-                'address' => {'type' => 'string'},
-                'unsubscribed_on' => {'type' => 'string'}
-              }}}
-        })
+      def list_unsubscribed(params = {})
+        params[:date_from] = handle_date_param(params[:date_from]) if params[:date_from]
+
+        post('unsubscribed/list.json', params)
       end
 
+      add_response_validations(
+        :unsubscribed,
+        %w(
+          unsubscribe
+          check_unsubscribed
+          list_unsubscribed
+        )
+      )
     end
   end
 end

data/lib/unione/client/webhook.rb

@@ -1,80 +1,34 @@
 module UniOne
   class Client
-
     module Webhook
+      extend UniOne::Validation::ClassMethods
+      include UniOne::Validation::InstanceMethods
 
-      def set_webhook(webhook)
-        post 'webhook/set.json', webhook
-        validate_response({'type' => 'object', 'required' => ['status', 'object'], 'properties' => {
-           'status' => {'type' => 'string'},
-           'object' => webhook_schema
-         }})
+      def set_webhook(params = {})
+        post('webhook/set.json', params)
       end
 
-      def get_webhook(url)
-        params = { url: url }
-        post 'webhook/get.json', params
-        get_webhook_schema = remove_fields_from_schema(webhook_schema, ['delivery_info', 'single_event'])
-        validate_response({'type' => 'object', 'required' => ['status', 'object'], 'properties' => {
-           'status' => {'type' => 'string'},
-           'object' => get_webhook_schema
-         }})
+      def get_webhook(params = {})
+        post('webhook/get.json', params)
       end
 
-      def list_webhooks(limit, offset)
-        params = { limit: limit, offset: offset }
-        post 'webhook/list.json', params
-        validate_response({
-          'type' => 'object', 'required' => ['status', 'objects'], 'properties' => {
-            'status' => {'type' => 'string'},
-            'objects' =>
-            {'items' =>
-             {'type' => 'object', 'required' => ['id', 'url', 'status', 'updated_at', 'events', 'event_format', 'delivery_info', 'single_event', 'max_parallel'], 'properties' => [
-              'id' => {'type' => 'integer'},
-              'url' => {'type' => 'string'},
-              'status' => {'type' => 'string'},
-              'updated_at' => {'type' => 'string'},
-              'events' =>
-              {'type' => 'object', 'required' => ['email_status', 'spam_block'], 'properties' => [
-               'email_status' => {'items' => {'type' => 'string'}},
-               'spam_block' => {'items' => {'type' => 'string'}}]},
-              'event_format' => {'type' => 'string'},
-              'delivery_info' => {'type' => 'integer'},
-              'single_event' => {'type' => 'integer'},
-              'max_parallel' => {'type' => 'integer'}
-              ]}}}
-        })
+      def list_webhooks(params = {})
+        post('webhook/list.json', params)
       end
 
-      def delete_webhook(url)
-        params = { url: url }
-        post 'webhook/delete.json', params
-        validate_response({'type' => 'object', 'required' => ['status'], 'properties' => {
-           'status' => {'type' => 'string'}
-         }})
+      def delete_webhook(params = {})
+        post('webhook/delete.json', params)
       end
 
-      private
-
-      def webhook_schema
-        {'type' => 'object', 'required' => ['url', 'status', 'events', 'event_format', 'delivery_info', 'single_event', 'max_parallel'], 'properties' => {
-           'id' => {'type' => 'integer'},
-           'url' => {'type' => 'string'},
-           'status' => {'type' => 'string'},
-           'event_format' => {'type' => 'string'},
-           'delivery_info' => {'type' => 'integer'},
-           'single_event' => {'type' => 'integer'},
-           'max_parallel' => {'type' => 'integer'},
-           'events' => webhook_events_schema,
-         }}
-      end
-
-      def webhook_events_schema
-        {'type' => 'object', 'required' => ['email_status', 'spam_block'], 'properties' => {
-           'email_status' => {'items' => {'type' => 'string'}},
-           'spam_block' => {'items' => {'type' => 'string'}}
-         }}
-      end
+      add_response_validations(
+        :webhook,
+        %w(
+          set_webhook
+          get_webhook
+          list_webhooks
+          delete_webhook
+        )
+      )
     end
   end
 end

data/lib/unione/client.rb

@@ -1,47 +1,69 @@
 require_relative 'connection'
 require_relative 'validation'
+require_relative 'helpers'
 require_relative 'client/domain'
 require_relative 'client/email'
+require_relative 'client/event_dump'
 require_relative 'client/project'
+require_relative 'client/suppression'
 require_relative 'client/system'
+require_relative 'client/tag'
 require_relative 'client/template'
 require_relative 'client/unsubscribed'
 require_relative 'client/webhook'
 
 module UniOne
-
   class Client
-
     include UniOne::Connection
-    include UniOne::Validation
+    extend  UniOne::Validation::ClassMethods
+    include UniOne::Validation::InstanceMethods
+    include UniOne::Client::Helpers
     include UniOne::Client::Domain
     include UniOne::Client::Email
+    include UniOne::Client::EventDump
     include UniOne::Client::Project
+    include UniOne::Client::Suppression
     include UniOne::Client::System
+    include UniOne::Client::Tag
     include UniOne::Client::Template
     include UniOne::Client::Unsubscribed
     include UniOne::Client::Webhook
 
+    class BaseException < StandardError; end
+    class InvalidCallbackAuth < BaseException; end
+
     API_ENDPOINT =
-      'https://%{data_center}.unione.io/%{lang}/transactional/api/v1/'
+      'https://%{hostname}/%{lang}/transactional/api/v1/'
 
     # * *Args* :
-    #   - +data_center+ -> data center: ['eu1', 'us1']
-    #   - +lang+ -> Two-letter ISO 639-1 language abbreviation, e.g. 'en'
-    #   - +api_key+ -> your UniOne API key
-    #   - +api_key_in_params+ -> boolean, pass API key inside form, otherwise pass in headers (default in headers)
+    #   - +hostname+          -> string, API hostname, for example 'eu1.unione.io'
+    #   - +lang+              -> string, two-letter ISO 639-1 language abbreviation, e.g. 'en'
+    #   - +api_key+           -> string, your UniOne API key
+    #   - +timeout+           -> integer, timeout in seconds, 5 by default
+    #   - +api_key_in_params+ -> boolean, pass API key in parameters, otherwise pass in headers (default)
+    #   - +enable_logging+    -> boolean, enable logging
     def initialize(params = {})
-      @data_center       = params[:data_center]
+      @hostname          = params[:hostname]
       @lang              = params[:lang]
       @api_key           = params[:api_key]
-      @api_key_in_params = !!params[:api_key_in_params]
+      @timeout           = params[:timeout] || 5
+      @api_key_in_params = params[:api_key_in_params]
+      @enable_logging    = params[:enable_logging] || ENV['ENABLE_LOGGING']
     end
 
     private
 
     def api_endpoint
       @api_endpoint ||=
-        API_ENDPOINT % { data_center: @data_center, lang: @lang }
+        API_ENDPOINT % { hostname: @hostname, lang: @lang }
+    end
+
+    def handle_time_param(param)
+      param.respond_to?(:strftime) ? param.strftime('%Y-%m-%d %H:%M:%S') : param
+    end
+
+    def handle_date_param(param)
+      param.respond_to?(:strftime) ? param.strftime('%Y-%m-%d') : param
     end
   end
 end

data/lib/unione/connection.rb

@@ -6,14 +6,14 @@ require 'hashie'
 module UniOne
   module Connection
 
-    def get(url, params)
+    def get(url, params = {})
       prepare_params!(params)
 
       # Assume HTTP library receives params as Hash
       request(:get, url, params)
     end
 
-    def post(url, params)
+    def post(url, params = {})
       prepare_params!(params)
 
       # Assume HTTP library receives payload body as String
@@ -34,12 +34,16 @@ module UniOne
       @conn ||= Faraday.new(
         url: api_endpoint,
         headers: headers,
-        request: { timeout: 30 }
+        request: { timeout: @timeout }
       ) do |conn|
         conn.response :mashify, content_type: /\bjson$/
         conn.response :json, content_type: /\bjson$/
         conn.response :raise_error
         conn.adapter :net_http_persistent
+
+        if @enable_logging
+          conn.response(:logger, nil, { headers: true, bodies: true, errors: true })
+        end
       end
     end
 

data/lib/unione/helpers.rb

@@ -0,0 +1,22 @@
+require 'digest'
+
+module UniOne
+  class Client
+    module Helpers
+      # Helper function for webhooks callback. It is checking auth field
+      # and if it is invalid, raises Unione::Client::InvalidCallbackAuth exception
+      def verify_callback_auth!(params)
+        params = params.transform_keys(&:to_sym)
+        auth = params[:auth]
+        unless auth == Digest::MD5.hexdigest(params.merge(auth: @api_key).to_json)
+          raise InvalidCallbackAuth
+        end
+      end
+
+      def callback_helper(params)
+        verify_callback_auth!(params)
+        yield params.dig('events_by_user', 0, 'events')
+      end
+    end
+  end
+end

data/lib/unione/response/raise_error.rb

@@ -1,14 +1,13 @@
+# UniOne response middleware
+
 require 'faraday'
 require 'unione/error'
 
 module UniOne
-  # UniOne response middleware
   module Response
-
-    # This class raises an UniOne-flavored exception based
-    # HTTP status codes returned by the API
+    # This class raises an UniOne-flavored exception based on HTTP
+    # status codes returned by the API
     class RaiseError < Faraday::Response::Middleware
-
       private
 
       def on_complete(response)

data/lib/unione/validation.rb

@@ -1,19 +1,44 @@
 require 'json-schema'
+require 'yaml'
 
 module UniOne
   module Validation
+    module ClassMethods
+      def add_response_validations(klass, methods)
+        methods.each do |method|
+          orig = "#{method}_without_hook"
+          alias_method orig, method
 
-    private
-
-    def validate_response(schema)
-      JSON::Validator.validate!(schema, @last_response.body)
-      @last_response
+          define_method method do |*args|
+            send(orig, *args)
+            schema = get_response_schema(klass, method)
+            validate_response(schema)
+          end
+        end
+      end
     end
 
-    def remove_fields_from_schema(schema, fields)
-      schema.dup.tap do |s|
-        s['required'] = s['required'].reject { |f| fields.include?(f) }
-        s['properties'] = s['properties'].reject { |f| fields.include?(f) }
+    module InstanceMethods
+      private
+
+      def validate_response(schema)
+        JSON::Validator.validate!(schema, @last_response.body)
+        @last_response
+      end
+
+      def get_response_schema(klass, method)
+        @response_schemas ||= {}
+        @response_schemas[klass] ||= begin
+          directory = File.join(File.dirname(__FILE__), '..', '..', 'config', 'response_schema')
+          filename = "#{klass}.yml"
+          YAML.load_file(File.join(directory, filename))
+        end
+
+        @response_schemas[klass][method]
+      end
+
+      def undescore_class_name(class_name)
+        class_name.gsub(/([^\^])([A-Z])/,'\1_\2').downcase
       end
     end
   end

data/lib/unione/version.rb

@@ -1,3 +1,3 @@
 module UniOne
-  VERSION = '0.0.2'
+  VERSION = '1.0.0'
 end

data/lib/unione-ruby.rb

@@ -1,5 +1,2 @@
 require_relative 'unione/client'
 require_relative 'unione/version'
-require_relative 'unione/helpers/mail/mail'
-require_relative 'unione/helpers/template/template'
-require_relative 'unione/helpers/webhook/webhook'

data/test/CONFIGFILE.yml

@@ -0,0 +1,71 @@
+- method: send_email
+  params:
+    message:
+      recipients:
+      - email: test@qadns.net
+        substitutions:
+          CustomerId: 12452
+          to_name: John Smith
+        metadata:
+          campaign_id: c77f4f4e-3561-49f7-9f07-c35be01b4f43
+          customer_hash: b253ac7
+      tags:
+      - string1
+      skip_unsubscribe: 0
+      global_language: en
+      template_engine: simple
+      global_substitutions:
+        property1: string
+        property2: string
+      global_metadata:
+        property1: string
+        property2: string
+      body:
+        html: "<b>Hello, {{to_name}}</b>"
+        plaintext: Hello, {{to_name}}
+        amp: <!doctype html><html amp4email><head> <meta charset="utf-8"><script async
+          src="https://cdn.ampproject.org/v0.js"></script> <style amp4email-boilerplate>body{visibility:hidden}</style></head><body>
+          Hello, AMP4EMAIL world.</body></html>
+      subject: string
+      from_email: test@qadns.net
+      from_name: John Smith
+      reply_to: test@qadns.net
+      track_links: 0
+      track_read: 0
+      bypass_global: 0
+      bypass_unavailable: 0
+      bypass_unsubscribed: 0
+      bypass_complained: 0
+      headers:
+        X-MyHeader: some data
+        List-Unsubscribe: "<mailto: unsubscribe@example.com?subject=unsubscribe>, <http://www.example.com/unsubscribe/{{CustomerId}}>"
+      attachments:
+      - type: text/plain
+        name: readme.txt
+        content: SGVsbG8sIHdvcmxkIQ==
+      inline_attachments:
+      - type: image/gif
+        name: IMAGECID1
+        content: R0lGODdhAwADAIABAP+rAP///ywAAAAAAwADAAACBIQRBwUAOw==
+      options:
+        unsubscribe_url: https://example.org/unsubscribe/{{CustomerId}}
+- method: set_webhook
+  params:
+    url: http://example.com
+    status: active
+    event_format: json_post
+    delivery_info: 1
+    single_event: 0
+    max_parallel: 10
+    events:
+      email_status:
+      - sent
+      - delivered
+      - opened
+      - hard_bounced
+      - soft_bounced
+      - spam
+      - clicked
+      - unsubscribed
+      spam_block:
+      - '*'

data/unione-ruby.gemspec

@@ -7,7 +7,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'json', '~> 2.0'
   spec.add_dependency 'faraday', '~> 1.0'
   spec.add_dependency 'faraday_middleware', '~> 1.0'
-  spec.add_dependency 'net-http-persistent', '~> 3.0'
+  spec.add_dependency 'net-http-persistent', '~> 4.0'
   spec.add_dependency 'hashie', '~> 4.0'
   spec.add_dependency 'json-schema', '~> 2.0'
   spec.authors = ['UniOne developer']
@@ -18,7 +18,7 @@ Gem::Specification.new do |spec|
   spec.licenses = ['MIT']
   spec.name = 'unione-ruby'
   spec.require_paths = ['lib']
-  spec.required_ruby_version = '>= 2.4'
+  spec.required_ruby_version = '>= 2.5'
   spec.summary = 'Official UniOne Gem'
   spec.version = UniOne::VERSION
 end