lesli 5.0.0

data/app/models/lesli/user/agent.rb

@@ -0,0 +1,37 @@
+=begin
+
+Lesli
+
+Copyright (c) 2023, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Ruby on Rails SaaS Development Framework.
+
+Made with ♥ by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://www.lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// · 
+=end
+
+module Lesli
+    class User::Agent < ApplicationRecord
+        belongs_to :user
+    end
+end

data/app/models/lesli/user/log.rb

@@ -0,0 +1,38 @@
+=begin
+
+Lesli
+
+Copyright (c) 2023, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Ruby on Rails SaaS Development Framework.
+
+Made with ♥ by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://www.lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// · 
+=end
+
+module Lesli
+    class User::Log < ApplicationRecord
+        belongs_to :user
+        belongs_to :user_session, optional: true
+    end
+end

data/app/models/lesli/user/request.rb

@@ -0,0 +1,37 @@
+=begin
+
+Lesli
+
+Copyright (c) 2023, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Ruby on Rails SaaS Development Framework.
+
+Made with ♥ by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://www.lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// · 
+=end
+
+module Lesli
+    class User::Request < ApplicationRecord
+        belongs_to :user
+    end
+end

data/app/models/lesli/user/session.rb

@@ -0,0 +1,105 @@
+=begin
+
+Lesli
+
+Copyright (c) 2023, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Ruby on Rails Development Platform.
+
+Made with ♥ by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://www.lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// ·
+=end
+
+require "bcrypt"
+
+module Lesli
+    class User::Session < ApplicationLesliRecord
+        belongs_to :user
+
+        after_create :set_session_token
+
+        enum session_sources: {
+            dispatcher_standar_session: "dispatcher_standar_session",
+            devise_standar_session: "devise_standar_session",
+            cloud_shared_public: "cloud_shared_public",
+        }
+
+        def set_session_token
+
+            return if self.session_source == "devise_standar_session"
+
+            return unless self.session_token.blank?
+
+            rebuild_token = true
+
+            while rebuild_token do
+
+                session_token = SecureRandom.alphanumeric(20)
+
+                # assign token to user if token is unique
+                unless User::Session.find_by(:session_token => session_token)
+                    self.session_token = session_token
+                    self.save!
+                    rebuild_token = false
+                end
+
+            end
+
+        end
+
+        def self.index(current_user, query, params, current_session_id)
+            user_id = params[:user_id]
+
+            User::Session.all
+            .joins(:user)
+            .where(user_id: user_id)
+            .where("users.account_id = ?", current_user.account.id)
+            .where("expiration_at > ? or expiration_at is ?", Time.now.utc, nil)
+            .select(
+                :id,
+                :user_agent,
+                :session_source,
+                Date2.new.date_time.db_timestamps("user_sessions"),
+                Date2.new.date_time.db_column("expiration_at"),
+                Date2.new.date_time.db_column("last_used_at"),
+                "case when #{current_session_id} = user_sessions.id then true else false end as current_session"
+            )
+            .page(query[:pagination][:page])
+            .per(query[:pagination][:perPage])
+            .order(updated_at: :desc)
+
+        end
+
+        def active?
+            if self.deleted_at.present?
+                return false
+            end
+
+            if self.expiration_at != nil and self.expiration_at < Time.now.utc
+                return false
+            end
+
+            return true
+        end
+    end
+end

data/app/models/lesli/user.rb

@@ -0,0 +1,162 @@
+=begin
+
+Lesli
+
+Copyright (c) 2023, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Ruby on Rails SaaS Development Framework.
+
+Made with ♥ by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://www.lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// · 
+=end
+
+module Lesli
+    class User < ApplicationLesliRecord
+
+        include UserGuard
+        include UserExtensions
+        #include UserActivities
+        #include UserPolyfill
+
+        # users belongs to an account only... and must have a role
+        belongs_to :account, optional: true
+
+        # user details are saved on separate table
+        has_one :detail, inverse_of: :user, autosave: true, dependent: :destroy
+        accepts_nested_attributes_for :detail, update_only: true
+
+        # users data extensions
+        has_many :logs
+        has_many :codes
+        has_many :agents
+        has_many :tokens
+        has_many :settings
+        has_many :sessions
+        has_many :requests
+        has_many :shortcuts
+        has_many :activities,   class_name: "User::Activity"
+
+        # users can have many roles and too many privileges through the roles
+        has_many :user_roles,       class_name: "User::Role" 
+        has_many :roles,            through: :user_roles, source: :role
+        has_many :privileges,       through: :roles
+
+        # devise implementation
+        devise :database_authenticatable,
+            :registerable,
+            :rememberable,
+            :recoverable,
+            :validatable,
+            :confirmable,
+            :trackable
+            #:omniauthable, omniauth_providers: [:google_oauth2, :facebook]
+
+        # users belongs to an account only... and must have a role
+        belongs_to :account, optional: true
+
+        # user details are saved on separate table
+        has_one :detail, inverse_of: :user, autosave: true, dependent: :destroy
+        accepts_nested_attributes_for :detail, update_only: true
+
+
+        # users belongs to an account only... and must have a role
+        belongs_to :account, optional: true
+
+        validates :email, :presence => true
+
+
+        # callbacks
+        before_create :before_create_user
+        after_create :after_create_user
+        #after_create :after_confirmation_user, if: :confirmed?
+        #after_create :after_account_assignation
+        #after_update :update_associated_services
+
+
+        # allow save duplicated users to execute callbacks
+        def save(*args)
+            super()
+            rescue ActiveRecord::RecordNotUnique => error
+        end
+
+
+        # @return [void]
+        # @description Before creating a user we make sure there is no capitalized email
+        def before_create_user
+            self.email = (self.email||"").downcase
+        end
+
+
+        # @return [void]
+        # @description After creating a user, creates the necessary resources for them to access the different engines.
+        #     At the current time, it only creates a default calendar. This is an *after_create* method, and is not
+        #     designed to be invoked directly
+        def after_create_user
+
+            # create user details
+            #User::Detail.find_or_create_by({ user: self })
+
+            # create an alias based on user name
+            # defined in user extensions
+            self.set_alias
+
+        end
+
+
+        # Initialize user settings and dependencies needed
+        def after_confirmation_user
+            return unless self.confirmed?
+
+            self.settings.create_with(:value => false).find_or_create_by(:name => "mfa_enabled")
+            self.settings.create_with(:value => :email).find_or_create_by(:name => "mfa_method")
+        end
+
+        def after_account_assignation
+            return unless self.account
+
+            #Courier::One::Firebase::User.sync_user(self)
+            #Courier::Driver::Calendar.create_user_calendar(self, name: "Personal Calendar", default: true)
+        end
+
+
+        def update_associated_services
+            if saved_change_to_first_name? || saved_change_to_last_name? || saved_change_to_telephone?
+
+                # defined in user extensions
+                self.set_alias
+
+                return 
+                if defined? CloudOne
+
+                    data = {
+                        full_name: self.user.full_name,
+                        telephone: self.telephone,
+                    }
+
+                    CloudOne::Firebase::User.update_data(self.user, data)
+
+                end
+            end
+        end
+    end
+end

data/app/services/lesli/application_lesli_service.rb

@@ -0,0 +1,168 @@
+=begin
+
+Lesli
+
+Copyright (c) 2023, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Ruby on Rails SaaS development platform.
+
+Made with ♥ by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://www.lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// · 
+
+=end
+
+# · 
+module Lesli 
+    class ApplicationLesliService
+
+
+        # Set container attributes to manage the life-cycle of the service
+        @query;
+        @resource;
+        @failures;
+        @current_user;
+
+
+        # Service constructor
+        # current_user is always required to initialize a service object
+        # current user is used to get the data only from the account context
+        def initialize current_user, query={}
+
+            # make the current user globaly available in the service object
+            @current_user = current_user
+
+            # stores the resources from the database as result of the active record queries
+            @resource = nil
+
+            # stores any error found during the life-cycle of the service object
+            @failures = []
+
+            # standard conditions to query the database
+            @query = query
+        end
+
+
+        # Find an specific resource through the main id
+        def find resource = nil
+            # Look for the resource in the database
+            # self.resource = current_user.account.users.find_by_id(id) # example
+
+            # Should always return self
+            self.resource = resource if resource
+            self
+        end
+
+
+        # Standard method to list data from the database
+        def list params=nil
+        end
+
+
+        # Standard method to index data from the database
+        def index params=nil
+        end
+
+
+        # Standard method to show data from the database
+        def show
+        end
+
+
+        # Standard method to create new resource into the database
+        def create resource
+            # Example:
+            # user = current_user.account.users.new(params)
+
+            # if user.save
+            #     self.resource = user
+            # else
+            #     self.error(user.errors.full_messages.to_sentence)
+            # end
+
+            self.resource = resource if resource
+            self
+        end
+
+
+        # Standard method to update resources into the database
+        def update params
+        end
+
+
+        # Standard method to delete data from the database
+        def delete
+        end
+
+
+        # Method to check if the service object has data available
+        # this method ment to be used together and after the find method
+        def found?
+            !self.resource.blank?
+        end
+
+
+        # Check if the service object has errors
+        def successful?
+            self.failures.empty?
+        end
+
+
+        # Get the list of erros
+        def errors
+            self.failures
+        end
+
+
+        # Get the list of erros as single string
+        def errors_as_sentence
+            self.failures.to_sentence
+        end
+
+
+        # Register a new error for the current service object
+        def error error
+            self.failures.push(error)
+        end
+
+
+        # Return the resource as a result
+        def result
+            self.resource
+        end
+
+        private
+
+        attr_reader :current_user
+
+        attr_reader :resource
+        attr_writer :resource
+
+        attr_reader :successful
+        attr_writer :successful
+
+        attr_reader :failures
+        attr_writer :failures
+
+        attr_reader :query
+    end
+end

data/app/services/lesli/user/session_service.rb

@@ -0,0 +1,62 @@
+=begin
+
+Lesli
+
+Copyright (c) 2023, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Ruby on Rails Development Platform.
+
+Made with ♥ by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://www.lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// · 
+
+=end
+
+module Lesli
+    class User::SessionService < ApplicationLesliService
+
+        # create a new session
+        def create(user_agent, remote_ip, session_source="devise_standard_session")
+
+            # register a new unique session
+            current_session = current_user.sessions.create({
+                :user_agent => user_agent,
+                :user_remote => remote_ip,
+                :session_source => session_source,
+                :last_used_at => Date2.new.get
+            })
+
+            # register a successful sign-in log for the current user
+            current_user.logs.update(
+                session_id: current_session[:id], 
+                title: "session_creation_successful", 
+                description: current_session[:session_source] 
+            )
+
+            # register or sync the current_user with the user representation on Firebase
+            #Courier::One::Firebase::User.sync_user(@resource) if defined? CloudOne
+
+            return current_session
+
+        end
+    end
+end

data/app/validators/lesli/application_lesli_validator.rb

@@ -0,0 +1,67 @@
+=begin
+
+Lesli
+
+Copyright (c) 2023, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Ruby on Rails SaaS Development Framework.
+
+Made with ♥ by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://www.lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// · 
+=end
+
+module Lesli
+    class ApplicationLesliValidator
+
+        # Set container attributes to manage the life-cycle of the service
+        @resource;
+        @failures;
+
+        def initialize(resource)
+
+            # stores the resources from the database as result of the active record queries
+            @resource = resource
+
+            # stores any error found during the life-cycle of the service object
+            @failures = []
+
+        end
+
+        def valid?
+            yield(failures.empty?, failures) if block_given?
+            failures.empty?
+        end
+
+        private
+
+        attr_reader :resource
+        attr_writer :resource
+
+        attr_reader :failures
+        attr_writer :failures
+
+        attr_reader :result
+        attr_writer :result
+
+    end
+end