mints 0.0.15 → 0.0.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18200f38cd58f4884a1e3391f28523b15dcad0db6f1a40038d3dd77bbc7b5826
-  data.tar.gz: 1a80da693aa4121af008dfc9d2816f5d09963e84d61f5274824593910786664e
+  metadata.gz: eb39e61077ebde851f278b96e82be85962bdacd093158d179cc5107bf3a4c5b2
+  data.tar.gz: f5d84797fc4526b3f8c2164d79062b0035db452c0a3a62d02967e33f1649a78b
 SHA512:
-  metadata.gz: aa64a73af10be175c08a0833e6178b654ea8cda3713e49e1533fdc12fa89d3c4be51974ac41c558463d11aa5d0c50e621d774a9b77bd61e554c4dda0a7cb0019
-  data.tar.gz: 525ef4e71004bc3705f36eb4d1f165044da08dba2af45eff3185e4686206f746dc4d0072ce97cd811ce1489c9de17f7737354d3a437eddbd9d90ffc164e4c6d2
+  metadata.gz: 8c902cadde2d3951e9aecf9e6a81f86f7af47224071a14ff0ea9b72fc4f2607f2c60729d2ce4843dbdf0d9e582135fba51cf84b37ed6d6908227e5438a217e4a
+  data.tar.gz: faed4589390dbe456f973212e9e2deaa759082f2ed02c6aedfea493147b80d3935261a50ce6d9d41b77a2e5b9fd2e9ef456b19e80914118f8e5c49d9a94b3684

data/lib/client.rb

@@ -20,8 +20,8 @@ module Mints
           self.set_scope(scope)
       end
 
-      def raw(action, url, options = nil, data = nil, base_url = nil)
-        base_url = @base_url if !base_url
+      def raw(action, url, options = nil, data = nil, base_url = nil, compatibility_options = {})
+      base_url = @base_url if !base_url
         uri = ""
         if (options && options.class == Hash)
           if (options[:jfilters] && options[:jfilters].class == Hash)
@@ -52,7 +52,7 @@ module Mints
                       response = @redis_server.get(full_url)
                       result_from_cache = true
                     else 
-                      response = self.send("#{@scope}_#{action}", "#{full_url}")
+                      response = self.send("#{@scope}_#{action}", "#{full_url}", compatibility_options)
                       @redis_server.setex(full_url,time,response)
                     end
                     break
@@ -63,15 +63,18 @@ module Mints
           end
 
           if !url_need_cache
-            response = self.send("#{@scope}_#{action}", "#{full_url}")
+            response = self.send("#{@scope}_#{action}", "#{full_url}", compatibility_options)
           end
 
         elsif action === 'create' or action === 'post'
           action = 'post'
-          response = self.send("#{@scope}_#{action}", "#{full_url}", data)          
+          response = self.send("#{@scope}_#{action}", "#{full_url}", data, compatibility_options)          
         elsif action === 'put' or action === 'patch' or action ==='update'
           action = 'put'
-          response = self.send("#{@scope}_#{action}", "#{full_url}", data)
+          response = self.send("#{@scope}_#{action}", "#{full_url}", data, compatibility_options)
+        elsif action === 'delete' or action === 'destroy'
+          action = 'delete'
+          response = self.send("#{@scope}_#{action}", "#{full_url}", data, compatibility_options)
         end
         if result_from_cache
           return parsed_response = JSON.parse(response)
@@ -93,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
@@ -121,7 +124,7 @@ module Mints
             uri.query_values = args[1]
           end
           url = self.get_url(route, object, uri, slug)
-          response = self.send("#{@scope}_#{action}", url)
+          response = self.send("#{@scope}_#{action}", url, compatibility_options)
         elsif action == "post" or action == "create"
           if args[1].class == Hash
             uri.query_values = args[1]
@@ -129,7 +132,7 @@ module Mints
           url = self.get_url(route, object, uri, slug)
           action = 'post'
           data = args[0]
-          response = self.send("#{@scope}_#{action}", url, {data: data})
+          response = self.send("#{@scope}_#{action}", url, {data: data}, compatibility_options)
         elsif action == "put" or action == "update"
            if args.first.class == String or Integer
             slug = args.first
@@ -139,7 +142,7 @@ module Mints
           action = 'put'
           id = args[0]
           data = args[1]
-          response = self.send("#{@scope}_#{action}", "#{url}", {data: data})
+          response = self.send("#{@scope}_#{action}", "#{url}", {data: data}, compatibility_options)
         end
 
         if response.response.code == "404"
@@ -188,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    
@@ -201,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
@@ -214,77 +219,107 @@ 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)
+      def contact_get(url, compatibility_options)
         headers = {
           "ApiKey" => @api_key,
           "Accept" => "application/json",
           "ContactToken" => @contact_token_id
         }
+        headers["Content-Type"] = "application/json" unless compatibility_options['no_content_type']
         headers["Authorization"] = "Bearer #{@session_token}" if @session_token
         return self.http_get(url, headers)
       end
 
-      def contact_post(url, data)
+      def contact_post(url, data, compatibility_options)
         headers = {
           "ApiKey" => @api_key,
           "Accept" => "application/json",
           "ContactToken" => @contact_token_id
         }
+        headers["Content-Type"] = "application/json" unless compatibility_options['no_content_type']
         headers["Authorization"] = "Bearer #{@session_token}" if @session_token
         return self.http_post(url, headers, data)
       end
 
-      def contact_put(url, data)
+      def contact_put(url, data, compatibility_options)
         headers = {
           "ApiKey" => @api_key,
           "Accept" => "application/json",
           "ContactToken" => @contact_token_id
         }
+        headers["Content-Type"] = "application/json" unless compatibility_options['no_content_type']
         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
-      def user_get(url)
+      def user_get(url, compatibility_options)
         headers = {
-          "ApiKey" => @api_key,
-          "Accept" => "application/json"
+          "Accept" => "application/json",
+          "ApiKey" => @api_key
         }
+        headers["Content-Type"] = "application/json" unless compatibility_options['no_content_type']
         headers["Authorization"] = "Bearer #{@session_token}" if @session_token
         return self.http_get(url, headers)
       end
 
-      def user_post(url, data)
+      def user_post(url, data, compatibility_options)
         headers = {
-          "ApiKey" => @api_key,
-          "Accept" => "application/json"
+          "Accept" => "application/json",
+          "ApiKey" => @api_key
         }
+        headers["Content-Type"] = "application/json" unless compatibility_options['no_content_type']
         headers["Authorization"] = "Bearer #{@session_token}" if @session_token
         return self.http_post(url, headers, data)
       end
 
-      def user_put(url, data)
+      def user_put(url, data, compatibility_options)
         headers = {
-          "ApiKey" => @api_key,
           "Accept" => "application/json",
-          "Content-Type" => "application/json"
+          "ApiKey" => @api_key
         }
+        headers["Content-Type"] = "application/json" unless compatibility_options['no_content_type']
         headers["Authorization"] = "Bearer #{@session_token}" if @session_token
         return self.http_put(url, headers, data)
       end
+
+      def user_delete(url, data, compatibility_options)
+        headers = {
+          "Accept" => "application/json",
+          "ApiKey" => @api_key
+        }
+        headers["Content-Type"] = "application/json" unless compatibility_options['no_content_type']
+        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)
+      def public_get(url, headers = nil, compatibility_options)
         h = {
           "Accept" => "application/json",
-          "Content-Type" => "application/json",
           "ApiKey" => @api_key
         }
+        h["Content-Type"] = "application/json" unless compatibility_options['no_content_type']
         h["ContactToken"] = @contact_token_id if @contact_token_id
         if headers
           headers.each do |k,v|
@@ -294,12 +329,12 @@ module Mints
         self.http_get(url, h)
       end
 
-      def public_post(url, headers = nil, data)
+      def public_post(url, headers = nil, data, compatibility_options)
         h = {
           "Accept" => "application/json",
-          "Content-Type" => "application/json",
           "ApiKey" => @api_key
         }
+        h["Content-Type"] = "application/json" unless compatibility_options['no_content_type']
         h["ContactToken"] = @session_token if @session_token
         if headers
           headers.each do |k,v|
@@ -309,12 +344,12 @@ module Mints
         self.http_post(url, h, data)
       end
 
-      def public_put(url, headers = nil, data)
+      def public_put(url, headers = nil, data, compatibility_options)
         h = {
-          "Accept" => "application/json", 
-          "Content-Type" => "application/json", 
+          "Accept" => "application/json",
           "ApiKey" => @api_key
         }
+        h["Content-Type"] = "application/json" unless compatibility_options['no_content_type']
         h["ContactToken"] = @contact_token_id if @contact_token_id
         if headers
           headers.each do |k,v|

data/lib/contact.rb

@@ -1,4 +1,5 @@
 require_relative "./client.rb"
+require_relative "./mints_helper.rb"
 include ActionController::Cookies
 module Mints
   class Contact
@@ -7,30 +8,93 @@ module Mints
     # === Initialize.
     # Class constructor
     #
+    # ==== Parameters
+    # host:: (String) -- It's the visitor IP.
+    # api_key:: (String) -- Mints instance api key.
+    # contact_token_id:: (Integer) --  Cookie 'mints_contact_id' value (mints_contact_token).
+    #
+    # ==== Return
+    # Returns a Contact object
     def initialize(host, api_key, session_token = nil, contact_token_id = nil, debug = false)
       @client = Mints::Client.new(host, api_key, "contact", session_token, contact_token_id, debug)
     end
 
     ##
     # === Login.
-    # Starts a contact session
+    # Starts a contact session.
+    #
+    # ==== Parameters:
+    # email:: (String) -- The email that will be logged.
+    # password:: (String) -- The password of the email.
     #
+    # ==== Example
+    #     @mints_contact.login("email@example.com", "password")
     def login(email, password)
       data = {
         email: email,
         password: password
       }
-      response = @client.raw("post", "/contacts/login", nil, {data: data})
+      response = @client.raw("post", "/contacts/login", nil, {data: data}.to_json)
       if response.key? "session_token"
         @client.session_token = response["session_token"]
       end
       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 token that will be used to log in.
+    #
+    # ==== 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("email@example.com", "template_slug")
+    #
+    # ==== Second Example
+    #     @mints_contact.send_magic_link("email@example.com", "template_slug", "", 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 }.to_json, '/api/v1')
+      return response
+    end
+
     ##
     # === Logout.
-    # Ends a contact session
+    # Ends a contact session previously logged.
     #
+    # ==== Example
+    #     @mints_contact.login("email@example.com", "password")
+    #     @mints_contact.logout
     def logout
       response = @client.raw("post", "/contacts/logout") if session_token?
       if response["success"]
@@ -41,62 +105,127 @@ module Mints
 
     ##
     # === Change Password.
-    # Change password
+    # Change password without email. To change the password a contact must be logged.
     #
+    # ==== Parameters:
+    # data:: (Hash) -- A new password allocated in a data key.
+    #
+    # ==== Example
+    #     @mints_contact.login("email@example.com", "password")
+    #     data = { "password": "123456" }
+    #     @data = @mints_contact.change_password(data)
     def change_password(data)
-      return @client.raw("post", "/contacts/change-password", nil, data)
+      return @client.raw("post", "/contacts/change-password", nil, data_transform(data))
     end
 
     ##
     # === 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:: (Hash) -- It's a data key where will be hosted the destination email.
     #
+    # ==== Example
+    #     data = { "email": "email@example.com" }
+    #     @mints_contact.recover_password(data)
     def recover_password(data)
-      return @client.raw("post", "/contacts/recover-password", nil, data)
+      return @client.raw("post", "/contacts/recover-password", nil, data_transform(data))
     end
 
     ##
     # === Reset Password.
-    # Reset password
+    # Reset password using a token. The token is obtained by recover_password method.
     #
+    # ==== Parameters:
+    # data:: (Hash) -- It's a set of data which contains all the information to reset a contact password.
+    #
+    # ==== Example
+    #     data = { 
+    #       "email": "email@example.com", 
+    #       "password": "password", 
+    #       "password_confirmation": "password", 
+    #       "token": "644aa3aa0831d782cc42e42b11aedea9a2234389af4f429a8d96651295ecfa09" 
+    #     }
+    #     @mints_contact.reset_password(data)
     def reset_password(data)
-      return @client.raw("post", "/contacts/reset-password", nil, data)
+      return @client.raw("post", "/contacts/reset-password", nil, data_transform(data))
     end
 
     ##
     # === OAuth Login.
-    # Login a contact using oauth
-    #
+    # Login a contact using oauth.
     def oauth_login(data)
       return @client.raw("post", "/contacts/oauth-login", nil, data)
     end
 
     ##
     # === Me.
-    # Get contact logged info
+    # Get contact logged info.
     #
-    def me
-      return @client.raw("get", "/contacts/me")
+    # ==== First Example
+    #     @mints_contact.me
+    #
+    # ==== Second Example
+    #     options = { 
+    #       "attributes": true,
+    #       "taxonomies": true
+    #     } 
+    #     @data = @mints_contact.me(options)
+    def me(options = nil)
+      return @client.raw("get", "/contacts/me", options)
     end
 
     ##
     # === Status.
-    # Get contact logged status
+    # Get contact logged status.
     #
+    # ==== Example
+    #     @mints_contact.status
     def status
       return @client.raw("get", "/contacts/status")
     end
 
     ##
     # === Update.
-    # Update logged contact attributes
+    # Update logged contact attributes.
+    #
+    # ==== Parameters:
+    # data:: (Hash) -- It's the data to update with a session active.
     #
+    # ==== Example
+    #     @mints_contact.login("email@example.com", "password")
+    #     data = {
+    #       "given_name": "Given Name", 
+    #       "last_name": "Last Name"
+    #     }
+    #     @mints_contact.update(data)
     def update(data)
-      return @client.raw("put", "/contacts/update", nil, data)
+      return @client.raw("put", "/contacts/update", nil, data_transform(data))
+    end
+
+    ##
+    # === Register.
+    # Register a contact.
+    #
+    # ==== Parameters:
+    # data:: (Hash) -- It's the register data.
+    #
+    # ==== Example
+    #     data = {
+    #       "email": "email@example.com",
+    #       "given_name": "Given Name",
+    #       "last_name": "Last Name",
+    #       "password": "password"
+    #     }
+    #     @mints_contact.register(data);
+    def register(data)
+      return @client.raw("post", "/contacts/register", nil, data_transform(data))
     end
 
     private
 
+    include MintsHelper
+
     def session_token?
       if @client.session_token
         return true

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