mints 0.0.14 → 0.0.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3deabf302a32fac1452e45f7ab9753ec0a1ee7973535b0371b9c67a25cb60cc7
-  data.tar.gz: 9589dacb58814ad17c5a2826f866b929f862d7ce7ce3fc745dcd3e191c2f19c9
+  metadata.gz: 0cff6a549992ee75536a6696575ef58435328068adcbdd3658fc6633ec0e4fd5
+  data.tar.gz: c2fc848075d8156ba44aadc01c45b0d01c6eeaf5a7a21201d38b51e99ad86d54
 SHA512:
-  metadata.gz: d1bc7c183bc20b9dbe25f4f5d7770ee0492d0f2e773cdfb6934af7afe0056bf8f38f7277440a821e71f22a4abda51c11f7b8c2dd5f6279e22b9c68c7fe703d82
-  data.tar.gz: 2f7ebc2b2f8977f5009bafc4e42348cc4a7494729fb1aa15ccf69a8e7937c9872120a2bc81711fcd22153fa5cb05e71c462dc0c67645f350c5e5021f1e7a71f9
+  metadata.gz: e865b46eb2536dd6f14ad39d0ebe691ec2db0cf98bd3c1861223dd3e9462deb555eee92d3ece5da498cbd4655dc6443774e6ca1ea94c0225f5a8db1977a7b237
+  data.tar.gz: f5203d5ba1b426812abd7f281146c84b58c2761e1be388b0ed004bd74ccd98000964615787d127a275848978fc029f444db2f8647f6a924df918814cf3f3c856

data/lib/client.rb

@@ -24,6 +24,9 @@ module Mints
         base_url = @base_url if !base_url
         uri = ""
         if (options && options.class == Hash)
+          if (options[:jfilters] && options[:jfilters].class == Hash)
+            options[:jfilters] = Base64.encode64(JSON.generate(options[:jfilters]))
+          end
           uri = Addressable::URI.new
           uri.query_values = options
         end
@@ -69,6 +72,9 @@ module Mints
         elsif action === 'put' or action === 'patch' or action ==='update'
           action = 'put'
           response = self.send("#{@scope}_#{action}", "#{full_url}", data)
+        elsif action === 'delete' or action === 'destroy'
+          action = 'delete'
+          response = self.send("#{@scope}_#{action}", "#{full_url}", data)
         end
         if result_from_cache
           return parsed_response = JSON.parse(response)
@@ -90,7 +96,7 @@ module Mints
         name_len = name_spplited.size
         # the action always be the first element
         action = name_spplited.first
-        raise 'NoActionError' unless ['get', 'create', 'post', 'update', 'put'].include?(action)
+        raise 'NoActionError' unless ['get', 'create', 'post', 'update', 'put', 'delete', 'destroy'].include?(action)
         # the object always be the last element
         object = separator == "__" ? name_spplited.last.gsub("_","-") : name_spplited.last
         # get intermediate url elements
@@ -185,6 +191,7 @@ module Mints
           puts url
           puts "Headers:"
           puts headers
+          puts "Method: get"
         end
         return headers ? HTTParty.get(url, :headers => headers) : HTTParty.get(url)
       end    
@@ -198,6 +205,7 @@ module Mints
           puts headers
           puts "Data:"
           puts data
+          puts "Method: post"
         end
         return headers ? HTTParty.post(url, :headers=> headers, :body => data) : HTTParty.post(url, :body => data)  
       end
@@ -211,10 +219,25 @@ module Mints
           puts headers
           puts "Data:"
           puts data
+          puts "Method: put"
         end
         return headers ? HTTParty.put(url, :headers=> headers, :body => data) : HTTParty.put(url, :body => data)
       end
 
+      # Simple HTTP DELETE
+      def http_delete(url, headers = nil, data = nil)
+        if @debug
+          puts "Url:"
+          puts url
+          puts "Headers:"
+          puts headers
+          puts "Data:"
+          puts data
+          puts "Method: delete"
+        end
+        return headers ? HTTParty.delete(url, :headers=> headers, :body => data) : HTTParty.delete(url, :body => data)  
+      end
+
       # Start contact context
       def contact_get(url)
         headers = {
@@ -243,7 +266,7 @@ module Mints
           "ContactToken" => @contact_token_id
         }
         headers["Authorization"] = "Bearer #{@session_token}" if @session_token
-        return self.http_post(url, headers, data)
+        return self.http_put(url, headers, data)
       end
 
       # Start User context
@@ -274,6 +297,15 @@ module Mints
         headers["Authorization"] = "Bearer #{@session_token}" if @session_token
         return self.http_put(url, headers, data)
       end
+
+      def user_delete(url, data)
+        headers = {
+          "ApiKey" => @api_key,
+          "Accept" => "application/json"
+        }
+        headers["Authorization"] = "Bearer #{@session_token}" if @session_token
+        return self.http_delete(url, headers, data)
+      end
       # End User Context
       
       def public_get(url, headers = nil)

data/lib/contact.rb

@@ -15,6 +15,13 @@ module Mints
     # === Login.
     # Starts a contact session
     #
+    # ==== Parameters:
+    # * +email+ - [_String_] The email that will be logged.
+    # * +password+ - [_String_] The password of the email.
+    #
+    # ==== Example
+    #     @mints_contact.login("brown.abigail@dubuque.com", "helloword")
+    #
     def login(email, password)
       data = {
         email: email,
@@ -27,9 +34,62 @@ module Mints
       return response
     end
 
+    ##
+    # === Magic Link Login.
+    # Starts a contact session with a token received in the contact email. The token will be received by send_magic_link method.
+    #
+    # ==== Parameters:
+    # * +token+ - [_String_] The email that will be logged.
+    #
+    # ==== Example
+    #     @mints_contact.magic_link_login(
+    #       "d8618c6d-a165-41cb-b3ec-d053cbf30059:zm54HtRdfHED8dpILZpjyqjPIceiaXNLfOklqM92fveBS0nDtyPYBlI4CPlPe3zq"
+    #     )
+    #
+    def magic_link_login(token)
+      response = @client.raw("get", "/contacts/magic-link-login/#{token}", nil, '/api/v1')
+      if response.key? "session_token"
+        @client.session_token = response["session_token"]
+      end
+      return response
+    end
+
+    ##
+    # === Send Magic Link
+    # Send magic link to contact by email. That magic link will be used in magic_link_login method.
+    #
+    # ==== Parameters:
+    # * +email+ - [_String_] Contact's email.
+    # * +template_slug+ - [_String_] Email template's slug to be used in the email.
+    # * +redirectUrl+ - [_String_] Url to be redirected in the implemented page.
+    # * +lifeTime+ - [_Integer_] Maximum time of use in minutes.
+    # * +maxVisits+ - [_Integer_] The maximum number of uses of a token. 
+    #
+    # ==== First Example
+    #     @mints_contact.send_magic_link("brown.abigail@dubuque.com", "")
+    #
+    # ==== Second Example
+    #     @mints_contact.send_magic_link("brown.abigail@dubuque.com", "", "", 1440, 3)
+    #
+    def send_magic_link(email, template_slug, redirectUrl = '', lifeTime = 1440, maxVisits = nil)
+      data = {
+        email: email,
+        lifeTime: lifeTime,
+        maxVisits: maxVisits,
+        redirectUrl: redirectUrl,
+        templateId: template_slug
+      }
+      response = @client.raw("post", "/contacts/magic-link", nil, { data: data }, '/api/v1')
+      return response
+    end
+
     ##
     # === Logout.
-    # Ends a contact session
+    # Ends a contact session previously logged.
+    #
+    # ==== Example
+    #     @mints_contact.login('brown.abigail@dubuque.com', 'helloword')
+    #     @mints_contact.logout
     #
     def logout
       response = @client.raw("post", "/contacts/logout") if session_token?
@@ -41,7 +101,15 @@ module Mints
 
     ##
     # === Change Password.
-    # Change password
+    # Change password without email. To change the password a contact must be logged.
+    #
+    # ==== Parameters:
+    # * +data+ - [] A new password allocated in a data key.
+    #
+    # ==== Example
+    #     @mints_contact.login('brown.abigail@dubuque.com', 'helloword')
+    #     data = { "data": { "password": "123456" } }
+    #     @mints_contact.change_password(data)
     #
     def change_password(data)
       return @client.raw("post", "/contacts/change-password", nil, data)
@@ -49,7 +117,14 @@ module Mints
 
     ##
     # === Recover Password.
-    # Recover password
+    # Send a email that contains a token to a contact. That token will be used in reset_password to establish a new password. 
+    #
+    # ==== Parameters:
+    # * +data+ - [] It's a data key where will be hosted the destination email. 
+    #
+    # ==== Example
+    #     data = { "data": { "email": "brown.abigail@dubuque.com" } }
+    #     @mints_contact.recover_password(data)
     #
     def recover_password(data)
       return @client.raw("post", "/contacts/recover-password", nil, data)
@@ -57,7 +132,19 @@ module Mints
 
     ##
     # === Reset Password.
-    # Reset password
+    # Reset password using a token. The token is obtained by recover_password method.
+    #
+    # ==== Parameters:
+    # * +data+ - [] It's a set of data which contains all the information to reset a contact password.
+    #
+    # ==== Example
+    #     data = { "data": { 
+    #       "email": "brown.abigail@dubuque.com", 
+    #       "password": "helloword", 
+    #       "password_confirmation": "helloword", 
+    #       "token": "644aa3aa0831d782cc42e42b11aedea9a2234389af4f429a8d96651295ecfa09" 
+    #     } }
+    #     @mints_contact.reset_password(data)
     #
     def reset_password(data)
       return @client.raw("post", "/contacts/reset-password", nil, data)
@@ -73,7 +160,10 @@ module Mints
 
     ##
     # === Me.
-    # Get contact logged info
+    # Get contact logged info.
+    #
+    # ==== Example
+    #     @mints_contact.me
     #
     def me
       return @client.raw("get", "/contacts/me")
@@ -81,7 +171,10 @@ module Mints
 
     ##
     # === Status.
-    # Get contact logged status
+    # Get contact logged status.
+    #
+    # ==== Example
+    #     @mints_contact.status
     #
     def status
       return @client.raw("get", "/contacts/status")
@@ -89,12 +182,43 @@ module Mints
 
     ##
     # === Update.
-    # Update logged contact attributes
+    # Update logged contact attributes.
+    #
+    # ==== Parameters:
+    # * +data+ - [] It's the data to update with a session active.
+    #
+    # ==== Example
+    #     @mints_contact.login("brown.abigail@dubuque.com", "helloword")
+    #     data = { "data": { 
+    #       "given_name": "Alonso", 
+    #       "last_name": "Garcia"
+    #     } }
+    #     @mints_contact.update(data)
     #
     def update(data)
       return @client.raw("put", "/contacts/update", nil, data)
     end
 
+    ##
+    # === Register.
+    # Register a contact.
+    #
+    # ==== Parameters:
+    # * +data+ - [] It's the register data.
+    #
+    # ==== Example
+    #     data = { "data": {
+    #       "email": "carlos@mints.cloud",
+    #       "given_name": "Carlos",
+    #       "last_name": "Fernandez",
+    #       "password": "123456"
+    #     } }
+    #     @mints_contact.register(data);
+    #
+    def register(data)
+      return @client.raw("post", "/contacts/register", nil, data)
+    end
+
     private
 
     def session_token?

data/lib/generators/mints_assets_controller.rb

@@ -0,0 +1,3 @@
+require 'reverse_proxy/client'
+class MintsAssetsController <  Mints::PublicAPIController
+end

data/lib/generators/mints_files_generator.rb

@@ -6,8 +6,10 @@ class MintsFilesGenerator < Rails::Generators::Base
       copy_file 'mints_user_controller.rb', './app/controllers/api/mints_user_controller.rb'
       copy_file 'mints_contact_controller.rb', './app/controllers/api/v1/mints_contact_controller.rb'
       copy_file 'mints_public_controller.rb', './app/controllers/api/v1/mints_public_controller.rb'
+      copy_file 'mints_assets_controller.rb', './app/controllers/mints_assets_controller.rb'
       route <<-eos
         # Mints auto-generated routes (proxy to send request to mints.cloud)
+        match '/public-assets/*path' => 'mints_assets#index', via: [:get, :post, :put, :patch, :delete]
         namespace :api, defaults: { format: :json } do
           match '/user/v1/*path' => 'mints_user#index', via: [:get, :post, :put, :patch, :delete]
           match '/contact/v1/*path' => 'mints_contact#index', via: [:get, :post, :put, :patch, :delete]  

data/lib/mints/controllers/admin_base_controller.rb

@@ -2,16 +2,16 @@ module Mints
   class AdminBaseController < ActionController::Base
     before_action :set_mints_user_client
 
-    # def mints_user_signed_in?
-    #     # Check status in mints
-    #     response = @mints_user.status
-    #     status = response['success'] ? response['success'] : false
-    #     unless status
-    #       # if mints response is negative delete the session cookie
-    #       cookies.delete(:mints_user_session_token)
-    #     end
-    #     return status
-    # end
+    def mints_user_signed_in?
+        # Check status in mints
+        response = @mints_user.me
+        status = response['data'] ? true : false
+        unless status
+          # if mints response is negative delete the session cookie
+          #cookies.delete(:mints_user_session_token)
+        end
+        return status
+    end
 
     ##
     # === Mints user Login.
@@ -22,7 +22,22 @@ module Mints
         # Get session token from response
         session_token = response['api_token']
         # Set a permanent cookie with the session token
-        cookies.permanent[:mints_user_session_token] = session_token
+        cookies[:mints_user_session_token] = { value: session_token, secure: true, httponly: true, expires: 1.day }
+    end
+
+    ##
+    # === Mints user Login.
+    # Starts a user session in mints.cloud and set a session cookie
+    def mints_user_magic_link_login(hash)
+      # Login in mints
+      response = @mints_user.magic_link_login(hash)
+      if response['data'] && response['data']['redirect_url']
+        # Set a cookie with the session token
+        cookies[:mints_user_session_token] = { value: response['data']['api_token'], expires: 1.day, secure: true, httponly: true }
+        redirect_to response['data']['redirect_url']
+      else
+        redirect_to '/'
+      end
     end
 
     ##
@@ -51,7 +66,8 @@ module Mints
         raise 'MintsBadCredentialsError'
       end
       # Initialize mints user client
-      @mints_user = Mints::User.new(@host, @api_key, nil, @debug)
+      session_token = cookies[:mints_user_session_token] ? cookies[:mints_user_session_token] : nil
+      @mints_user = Mints::User.new(@host, @api_key, session_token, @debug)
     end
   end
 end

data/lib/mints/controllers/base_api_controller.rb

@@ -1,6 +1,6 @@
 module Mints
   class BaseApiController < ActionController::Base
-    before_action :set_mints_pub_client
+    before_action :set_mints_clients
 
     ##
     # === Mints Contact Login.
@@ -10,11 +10,31 @@ module Mints
         response = @mints_contact.login(email, password)
         # Get session token from response
         session_token = response['session_token']
-        id_token = response['contact']['id_token']
+        id_token = response['contact']['contact_token']
         # Set a permanent cookie with the session token
-        cookies.permanent[:mints_contact_session_token] = session_token
-        cookies.permanent[:mints_contact_id] = id_token
+        cookies.permanent[:mints_contact_session_token] = { value: session_token, secure: true, httponly: true }
+        cookies.permanent[:mints_contact_id] = { value: id_token, secure: true, httponly: true }
         @contact_token = id_token
+      end
+      
+    ##
+    # === Mints cotnact Login.
+    # Starts a cotnact session in mints.cloud and set a session cookie
+    def mints_contact_magic_link_login(hash)
+      # Login in mints
+      response = @mints_contact.magic_link_login(hash)
+      if response['data']
+        # Get session token from response
+        session_token = response['data']['session_token']
+        id_token = response['data']['contact']['contact_token']
+        # Set a permanent cookie with the session token
+        cookies.permanent[:mints_contact_session_token] = { value: session_token, secure: true, httponly: true }
+        cookies.permanent[:mints_contact_id] = { value: id_token, secure: true, httponly: true }
+        @contact_token = id_token
+        redirect_to response['data']['redirect_url'] ? response['data']['redirect_url'] : '/'
+      else
+        redirect_to '/'
+      end
     end
 
     ##
@@ -28,26 +48,96 @@ module Mints
         cookies.delete(:mints_contact_id)
         @contact_token = nil
     end
+
+    ##
+    # === Mints user Login.
+    # Starts a user session in mints.cloud and set a session cookie
+    def mints_user_login(email, password)
+      # Login in mints
+      response = @mints_user.login(email, password)
+      # Get session token from response
+      session_token = response['api_token']
+      # Set a permanent cookie with the session token
+      cookies[:mints_user_session_token] = { value: session_token, secure: true, httponly: true, expires: 1.day }
+    end
+
+    ##
+    # === Mints user Login.
+    # Starts a user session in mints.cloud and set a session cookie
+    def mints_user_magic_link_login(hash)
+      # Login in mints
+      response = @mints_user.magic_link_login(hash)
+      if response['data']
+        # Set a cookie with the session token
+        cookies[:mints_user_session_token] = { value: response['data']['api_token'], secure: true, httponly: true,  expires: 1.day }
+        redirect_to response['data']['redirect_url'] ? response['data']['redirect_url'] : '/'
+      else
+        redirect_to '/'
+      end
+    end
+
+    ##
+    # === Mints user Logout.
+    # Destroy session from mints.cloud and delete local session cookie
+    def mints_user_logout
+      # Logout from mints
+      # @mints_user.logout
+      # Delete local cookie
+      cookies.delete(:mints_user_session_token)
+    end
     
     private
 
     ##
-    # === Set mints pub.
-    # Initialize the public client and set the contact token
-    def set_mints_pub_client
+    # === Set mints clients (pub, user and contact)
+    # Initialize all clients from mitns
+    def set_mints_clients
       if File.exists?("#{Rails.root}/mints_config.yml.erb")
         template = ERB.new File.new("#{Rails.root}/mints_config.yml.erb").read
         config = YAML.load template.result(binding)
         @host = config["mints"]["host"]
         @api_key = config["mints"]["api_key"]
         @debug = config["sdk"]["debug"] ? config["sdk"]["debug"] : false
+
+        #public client
+        set_mints_pub_client
+        #contact client
+        set_mints_contact_client
+        #user client
+        set_mints_user_client
       else
         raise 'MintsBadCredentialsError'
       end
+    end
+
+    ##
+    # === Set mints pub.
+    # Initialize the public client and set the contact token
+    def set_mints_pub_client
+      
       # Initialize mints pub client, credentials taken from mints_config.yml.erb file
       @mints_pub = Mints::Pub.new(@host, @api_key, nil, @debug)
       # Set contact token from cookie
       @mints_pub.client.session_token = @contact_token
     end
+
+    ##
+    # === Set mints contact client.
+    # Initialize the public client and set the contact token
+    def set_mints_contact_client
+      # Initialize mints clontact client
+      session_token = cookies[:mints_contact_session_token] ? cookies[:mints_contact_session_token] : nil
+      contact_token_id = cookies[:mints_contact_id] ? cookies[:mints_contact_id] : nil
+      @mints_contact = Mints::Contact.new(@host, @api_key, session_token, contact_token_id, @debug)
+    end
+    
+    ##
+    # === Set Mints user client.
+    # Initialize the public client and set the user token
+    def set_mints_user_client
+      # Initialize mints user client
+      session_token = cookies[:mints_user_session_token] ? cookies[:mints_user_session_token] : nil
+      @mints_user = Mints::User.new(@host, @api_key, session_token, @debug)
+    end
   end
 end