virtuatable-core 1.3.1 → 1.6.0.dev0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 203433dce36ee2d214216cd18bdb69fcd4e42328a4527678ece54d96c8608383
-  data.tar.gz: 5864fa51e5c3fb70385f0419485042a23dfd8af8e0de918bcae219026b7e26e8
+  metadata.gz: 4ebed77d032ef7111c0bde0982cdfc947a4a1933c1dc22e2cb09a3edeca12af1
+  data.tar.gz: '081072a04de88c52c94df498047f6cec83147fccf8c163e2c5856a9bde5398ac'
 SHA512:
-  metadata.gz: e8c387a4883b7d4ff02120461895bcadcb4744e3b865326423ac24be062b60d80be5f05d0baac49860f958cc6479012e196e54b540a46d5382313e485570a9b8
-  data.tar.gz: 3b6429e446fb7fc955999b9bdd4b861bfe889b8d17eb22cb7029318ae52dee81b2b368326ae6cd052e7b91951d1e16ba42313b08740530a76e9e404c18abf377
+  metadata.gz: db0b0b6d2343f36483293ce34e0e93e6d0cc9a803959f1f84caafaf338309984aaf6b226f33a363a612e4b3724c9b225dc2dfc97139a729d55dfeb2f6a9ef70f
+  data.tar.gz: 7fc28600dbd1fa9c0a2cab48fc8431e0778e599a07ab98af8d87d3e9f4dc1e34423d1bfe0daa3fffdaa1744be92097dbab7aa9f32a59961d2e913675ad08b73e

data/lib/core/controllers/base.rb

@@ -13,8 +13,9 @@ module Core
       # Includes the custom errors throwers and responses helpers.
       include Core::Helpers::Errors
       include Core::Helpers::Responses
-      # Includes the checking methods for sessions.
-      include Core::Helpers::Sessions
+      # Includes the checking methods for access tokens.
+      include Core::Helpers::Tokens
+      include Core::Helpers::Scopes
       # Include the checkers and getters for OAuth apps
       include Core::Helpers::Applications
       # Include checkers for field requirement and check

data/lib/core/decorators/base.rb

@@ -0,0 +1,15 @@
+module Core
+  module Decorators
+    class Base < Draper::Decorator
+      delegate_all
+
+      def id
+        object.id.to_s
+      end
+
+      def to_json
+        to_h.to_json
+      end
+    end
+  end
+end

data/lib/core/decorators/campaign.rb

@@ -0,0 +1,20 @@
+module Core
+  module Decorators
+    class Campaign < Draper::Decorator
+      delegate_all
+
+      def to_simple_h
+        {
+          id: id.to_s,
+          title: title,
+          description: description,
+          tags: tags,
+          players: {
+            current: invitations.where(status: :accepted).count,
+            max: max_players
+          }
+        }
+      end
+    end
+  end
+end

data/lib/core/decorators/token.rb

@@ -0,0 +1,12 @@
+module Core
+  module Decorators
+    class Token < Core::Decorators::Base
+
+      def to_h
+        {
+          token: value
+        }
+      end
+    end
+  end
+end

data/lib/core/decorators.rb

@@ -0,0 +1,7 @@
+module Core
+  module Decorators
+    autoload :Base, 'core/decorators/base'
+    autoload :Campaign, 'core/decorators/campaign'
+    autoload :Token, 'core/decorators/token'
+  end
+end

data/lib/core/helpers/accounts.rb

@@ -10,8 +10,8 @@ module Core
       def account
         return @account unless @account.nil?
 
-        session_id_required if !respond_to?(:session) || session.nil?
-        @account = session.account
+        @account = token.authorization.account
+        @account
       end
 
       def account_id_not_found

data/lib/core/helpers/declarators.rb

@@ -6,9 +6,6 @@ module Core
     # to declare routes whithin a service, performing needed checks and filters.
     # @author Vincent Courtois <courtois.vincent@outlook.com>
     module Declarators
-      # @!attribute [r] routes
-      #   @return [Array<Core::Models::Permissions::Route>] the currently declared routes.
-      attr_reader :api_routes
 
       # Main method to declare new routes, persisting them in the database and
       # declaring it in the Sinatra application with the needed before checks.
@@ -16,68 +13,15 @@ module Core
       # @param verb [String] the HTTP method for the route.
       # @param path [String] the whole URI with parameters for the route.
       # @param options [Hash] the additional options for the route.
-      def api_route(verb, path, options: {}, &block)
-        options = default_options.merge(options)
-        route = add_route(verb: verb, path: path, options: options)
-
-        # TODO : do everything in the #send itself to avoid
-        # route reload issues when premium is changed. It will
-        # add some treatments but avoid many problems if route.premium
-        send(route.verb, route.path) do
-          application(premium: current_route.premium)
-          session if current_route.authenticated
+      def api_route(verb, path, premium: false, scopes: [], &block)
+        send(verb, path) do
+          scope_objects = fetch_scopes(scopes + ['data::usage'])
+          appli = application(premium: premium)
+          check_app_scopes(appli, scope_objects)
+          check_token_scopes(token, scope_objects)
           instance_eval(&block)
         end
       end
-
-      # Add a route to the database, then to the routes array.
-      # @param verb [String] the HTTP method used to request this route.
-      # @param path [String] the path used to request this route.
-      # @return [Core::Models::Permissions::Route] the created route.
-      def add_route(verb:, path:, options:)
-        route = Core::Models::Permissions::Route.find_or_create_by!(
-          path: path,
-          verb: verb.downcase,
-          premium: options[:premium],
-          authenticated: options[:authenticated]
-        )
-        api_routes.nil? ? @api_routes = [route] : push_route(route)
-        add_permissions(route)
-        route
-      end
-
-      # Pushes the route in the api routes list, by creating it if needed
-      # @param route [Core::Models::Permissions::Route] the route to push in the list of routes.
-      def push_route(route)
-        @api_routes << route if api_routes.none? do |tmp_route|
-          route.id == tmp_route.id
-        end
-      end
-
-      # Add the default access permissions to a route. Any group tagged superuser
-      # can automatically access any newly declared_route.
-      # params route [Core::Models::Permissions::Route] the route to add the permissions to.
-      def add_permissions(route)
-        groups = Core::Models::Permissions::Group.where(is_superuser: true)
-        groups.each do |group|
-          unless route.groups.where(id: group.id).exists?
-            route.groups << group
-            route.save!
-          end
-        end
-      end
-
-      # The default options for a route, being the most used value for each key.
-      # @return [Hash] the default options as a hash.
-      def default_options
-        {
-          # If TRUE the application MUST be premium to access the route.
-          # Mainly used to protect administration routes against illegal accesses.
-          premium: false,
-          # If TRUE the user MUST be authenticated to access the route.
-          authenticated: true
-        }
-      end
     end
   end
 end

data/lib/core/helpers/parameters.rb

@@ -12,8 +12,12 @@ module Core
         super.merge(body_params)
       end
 
+      def sym_params
+        params.map { |k, v| [k.to_sym, v] }.to_h
+      end
+
       # The parameters from the JSON body if it is sent.
-      # @return [Hash] the JSON body parsed as a dictionary.
+      # @return [Hash] the JSON body parsed as a dict ionary.
       def body_params
         request.body.rewind
         JSON.parse(request.body.read.to_s)

data/lib/core/helpers/responses.rb

@@ -13,7 +13,7 @@ module Core
       def api_list(items)
         halt 200, {
           count: items.count,
-          items: items.map { |item| enhanced_h(item) }
+          items: items.map { |item| item.to_h }
         }.to_json
       end
 
@@ -21,13 +21,13 @@ module Core
       # returning the informations about the created item.
       # @param item [Object] any object that responds to #to_h to display to the user.
       def api_created(item)
-        halt 201, enhanced_json(item)
+        halt 201, item.to_json
       end
 
       # Displays an item with the standards of the API.
       # @param item [Object] the item to display as a JSON formatted hash.
       def api_item(item)
-        halt 200, enhanced_json(item)
+        halt 200, item.to_json
       end
 
       # Displays a message with a 200 status code
@@ -35,16 +35,6 @@ module Core
       def api_ok(message)
         api_item message: message
       end
-
-      private
-
-      def enhanced_h(item)
-        (item.respond_to?(:enhance) ? item.enhance : item).to_h
-      end
-
-      def enhanced_json(item)
-        enhanced_h(item).to_json
-      end
     end
   end
 end

data/lib/core/helpers/scopes.rb

@@ -0,0 +1,22 @@
+module Core
+  module Helpers
+    module Scopes
+
+      def fetch_scopes(names)
+        (names.map { |n| Core::Models::OAuth::Scope.find_by(name: n) }).select { |s| !s.nil? }
+      end
+
+      def check_token_scopes(token, scopes)
+        scopes.each do |scope|
+          api_forbidden 'scope.forbidden' if !token.scopes.include? scope
+        end
+      end
+
+      def check_app_scopes(application, scopes)
+        scopes.each do |scope|
+          api_forbidden 'scope.forbidden' if !application.scopes.include? scope
+        end
+      end
+    end
+  end
+end

data/lib/core/helpers/tokens.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Core
+  module Helpers
+    # This helper aims at providing vanity methods concerning OAuth tokens.
+    # @author Vincent Courtois <courtois.vincent@outlook.com>
+    module Tokens
+      # Returns the database object representing the current OAuth token, or
+      # raises an error if the token seems to be invalid for any reason.
+      # @return [Core::Models::Oauth::AccessToken] the token if everything went well.
+      # @raise [Core::Helpers::Errors::BadRequest] if the token is not given.
+      # @raise [Core::Helpers::Errors::NotFound] if the token is not found in the
+      #   database searching for the value passed as parameter.
+      # @raise [Core::Helpers::Errors::Forbidden] if the token belongs to another
+      #   application.
+      def token
+        return @token unless @token.nil?
+
+        check_presence 'token'
+        @token = Core::Models::OAuth::AccessToken.find_by(value: params['token'])
+        api_not_found 'token.unknown' if @token.nil?
+        token_app_id = token.authorization.application.id.to_s
+        api_forbidden 'token.mismatch' if token_app_id != application.id.to_s
+        @token
+      end
+    end
+  end
+end

data/lib/core/helpers.rb

@@ -13,6 +13,7 @@ module Core
     autoload :Parameters, 'core/helpers/parameters'
     autoload :Responses, 'core/helpers/responses'
     autoload :Routes, 'core/helpers/routes'
-    autoload :Sessions, 'core/helpers/sessions'
+    autoload :Scopes, 'core/helpers/scopes'
+    autoload :Tokens, 'core/helpers/tokens'
   end
 end

data/lib/core/models/account.rb

@@ -37,10 +37,6 @@ module Core
       # @!attribute [w] password_confirmation
       #   @return [String] the confirmation of the password, do not get, just set it ; it must be the same as the password.
       has_secure_password validations: false
-
-      # @!attribute [rw] groups
-      #   @return [Array<Core::Models::Permissions::Group>] the groups giving their corresponding rights to the current account.
-      has_and_belongs_to_many :groups, class_name: 'Core::Models::Permissions::Group', inverse_of: :accounts
       
       # @!attribute [rw] applications
       #   @return [Array<Core::Models::OAuth::Application] the applications this user has created and owns.

data/lib/core/models/oauth/access_token.rb

@@ -13,44 +13,29 @@ module Core
         # @!attribute [rw] value
         #   @return [String] the value of the token, returned to the application when built.
         field :value, type: String, default: ->{ SecureRandom.hex }
-        # @!attribute [rw] expiration
-        #   @return [Integer] the time, in seconds, after which the token is declared expired, and thus can't be used anymore.
-        field :expiration, type: Integer, default: 86400
 
         # @!attribute [rw] authorization
         #   @return [Core::Models::OAuth::Authorization] the authorization code that issued this token to the application for this user.
-        belongs_to :authorization, class_name: 'Core::Models::OAuth::Authorization', inverse_of: :tokens
+        belongs_to :authorization, class_name: 'Core::Models::OAuth::Authorization', inverse_of: :tokens, optional: true
+        # @!attribute [rw] generator
+        #   @return [Core::Models::Oauth::AccessToken] the token that generated this one.
+        belongs_to :generator, class_name: 'Core::Models::OAuth::AccessToken', inverse_of: :generated, optional: true
 
-
-        # A refresh token is attached to each and every refresh token so that it can be used to deliver a new access token.
-        # @!attribute [rx] refresh_token
-        #   @return [Core::Models::OAuth::RefreshToken] the refresh token linked to this token
-        has_one :refresh_token, class_name: 'Core::Models::OAuth::RefreshToken', inverse_of: :token
+        # @!attribute [rw] generated
+        #   @return [Core::Models::OAuth::AccessToken] the token that has been generated by the current one.
+        has_one :generated, class_name: 'Core::Models::OAuth::AccessToken', inverse_of: :generator
 
         validates :value, 
           presence: {message: 'required'},
           uniqueness: {message: 'uniq'}
 
-        # Checks if the current date is inferior to the creation date + expiration period
-        # @return [Boolean] TRUE if the token is expired, FALSE otherwise.
-        def expired?
-          # Handles the case where the token is given to a premium app (our apps have infinite tokens).
-          return false if premium?
-          return true if refresh_token.used?
-
-          created_at.to_time.to_i + expiration < Time.now.to_i
-        end
-
         # Returns the scopes this access token can use to access the application
         # @return [Array<Core::Models::OAuth::Scope>] the array of scopes from the linked authorization
         def scopes
-          # Premium applications (our applications) have all the rights on the API.
-          return Core::Models::OAuth::Scope.all.to_a if premium?
-
-          authorization.scopes
+          premium ? Core::Models::OAuth::Scope.all.to_a : authorization.scopes
         end
 
-        def premium?
+        def premium
           authorization.application.premium
         end
       end

data/lib/core/models/oauth/authorization.rb

@@ -17,7 +17,7 @@ module Core
         field :code, type: String, default: ->{ SecureRandom.hex }
         # @!attribute [rw] expiration
         #   @return [Integer] the time, in seconds, after which the authorization is declared expired.
-        field :expiration, type: Integer, default: 86400
+        field :expiration, type: Integer, default: 60
 
         # @!attribute [rw] account
         #   @return [Arkaaan::Account] the account granting the authorization to access its data to the application.
@@ -41,6 +41,10 @@ module Core
         def expired?
           created_at.to_time.to_i + expiration < Time.now.to_i
         end
+
+        def used?
+          tokens.count > 0
+        end
       end
     end
   end

data/lib/core/models.rb

@@ -16,7 +16,6 @@ module Core
     autoload :Files, 'core/models/files'
     autoload :Notification, 'core/models/notification'
     autoload :OAuth, 'core/models/oauth'
-    autoload :Permissions, 'core/models/permissions'
     autoload :Ruleset, 'core/models/ruleset'
   end
 end

data/lib/core/services/accounts.rb

@@ -1,6 +1,10 @@
+# frozen_string_literal: true
+
 module Core
   module Services
-    class Accounts < Core::Services::Base
+    class Accounts
+      include Singleton
+
       def get_by_username(username)
         account = Core::Models::Account.find_by(username: username)
         if account.nil?
@@ -13,4 +17,4 @@ module Core
       end
     end
   end
-end
+end

data/lib/core/services/applications.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Core
+  module Services
+    # Service managing applications, allowing easy access to them with or without
+    # providing client secret for example.
+    # @author Vincent Courtois <courtois.vincent@outlook.com>
+    class Applications < Core::Services::Base
+      include Singleton
+
+      # Gets an application given its credentials (client UUID and client secret).
+      #
+      # @param client_id [String] the unique public identifier of the application.
+      # @param client_secret [String] the password for the application.
+      # @return [Core::Models::OAuth::Application] the application if it has been found.
+      #
+      # @raise [Core::Helpers::Errors::BadRequest] if a parameter is not correctly given.
+      # @raise [Core::Helpers::Errors::Forbidden] if the client secret is wrong for this application.
+      # @raise [Core::Helpers::Errors::Unknown] if the application is not found.
+      def get_by_credentials(client_id: nil, client_secret: nil, **_ignored)
+        require_parameters client_secret: client_secret
+        application = get_by_id(client_id: client_id)
+        raise forbidden_err(field: 'client_secret', error: 'wrong') if application.client_secret != client_secret
+
+        application
+      end
+
+      # Gets an application given its client UUID.
+      #
+      # @param client_id [String] the unique identifier of the application to get
+      # @return [Core::Models::OAuth::Application] the application found if no error is raised.
+      #
+      # @raise [Core::Helpers::Errors::Unknown] if the application is not found.
+      def get_by_id(client_id: nil, **_ignored)
+        require_parameters client_id: client_id
+        application = Core::Models::OAuth::Application.find_by(client_id: client_id)
+        raise unknown_err(field: 'client_id') if application.nil?
+
+        application
+      end
+    end
+  end
+end

data/lib/core/services/authorizations.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Core
+  module Services
+    # Service managing authorization codes. These codes represent the access a user
+    # is giving to an application on all or part of its data.
+    # @author Vincent Courtois <courtois.vincent@outlook.com>
+    class Authorizations < Core::Services::Base
+      include Singleton
+
+      # Gets the authorization code corresponding to the provided value if it is linked to the
+      # application matching the provided credentials. Otherwise it raises errors.
+      #
+      # @param client_id [String] the UUID of the application.
+      # @param client_secret [String] the password of the application.
+      # @param authorization_code [String] the code of the authorization you're trying to get.
+      #
+      # @return [Core::Models::OAuth::Authorization] the authorization code object if found.
+      #
+      # @raise [Core::Helpers::Errors::NotFound] if the application or the authorization is unknown
+      # @raise [Core::Helpers::Errors::BadRequest] if any parameter is nil.
+      # @raise [Core::Helpers::Errors::Forbidden] if the secret does not match the application,
+      #   or the authorization code does not belong to the application.
+      def get_by_credentials(client_id: nil, client_secret: nil, authorization_code: nil, **_ignored)
+        require_parameters authorization_code: authorization_code
+        application = Core.svc.applications.get_by_credentials(
+          client_id: client_id,
+          client_secret: client_secret
+        )
+        authorization = get_by_code(authorization_code: authorization_code)
+        raise mismatch_error if authorization.application.id.to_s != application.id.to_s
+
+        authorization
+      end
+
+      # Gets an authorization code by its corresponding value.
+      # @param authorization_code [String] the code value of the authorization object.
+      # @return [Core::Models::OAuth::Authorization] the authorization object.
+      # @raise [Core::Helpers::Errors::NotFound] if the authorization code is not found.
+      def get_by_code(authorization_code: nil, **_ignored)
+        require_parameters authorization_code: authorization_code
+        authorization = Core::Models::OAuth::Authorization.find_by(code: authorization_code)
+        raise unknown_err(field: 'authorization_code') if authorization.nil?
+
+        authorization
+      end
+
+      private
+
+      def mismatch_error
+        bad_request_err(field: 'client_id', error: 'mismatch')
+      end
+    end
+  end
+end

data/lib/core/services/base.rb

@@ -1,11 +1,28 @@
+# frozen_string_literal: true
+
 module Core
   module Services
     class Base
-      attr_reader :services
+      # Raises an error if any parameter is nil, and nothing if all parameters are found.
+      # @raise [Core::Helpers::Errors::BadRequest] an error if any parameter is nil.
+      def require_parameters(**parameters)
+        parameters.keys.each do |key|
+          value = parameters[key]
+          raise bad_request_err(field: key.to_s, error: 'required') if value.nil?
+        end
+      end
+
+      def bad_request_err(field: nil, error: nil)
+        Core::Helpers::Errors::BadRequest.new(field: field, error: error)
+      end
+
+      def unknown_err(field: nil, error: 'unknown')
+        Core::Helpers::Errors::NotFound.new(field: field, error: error)
+      end
 
-      def initialize(registry)
-        @services = registry
+      def forbidden_err(field: nil, error: 'forbidden')
+        Core::Helpers::Errors::Forbidden.new(field: field, error: error)
       end
     end
   end
-end
+end

data/lib/core/services/campaigns.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Core
+  module Services
+    class Campaigns
+      include Singleton
+
+      # Lists all the campaigns of a user identified by its account.
+      #
+      # @param account [Core::Models::Account] the user requesting its campaigns.
+      # @param page [Integer] the page in the list of campaigns to return to the users.
+      # @param per_page [Integer] the number of campaigns per page.
+      #
+      # @return [Array<Hash>] an array of hash representing campaigns.
+      def list(account, page: 0, per_page: 20, **_ignored)
+        campaigns = campaigns(account).skip(page * per_page).limit(per_page)
+        campaigns.map do |campaign|
+          Core::Decorators::Campaign.new(campaign).to_simple_h
+        end
+      end
+
+      def campaigns(account)
+        invitations = account.invitations.where(enum_status: 'creator')
+        Core::Models::Campaign.where(:id.in => invitations.map(&:campaign_id))
+      end
+    end
+  end
+end

data/lib/core/services/registry.rb

@@ -1,15 +1,39 @@
+# frozen_string_literal: true
+
 module Core
   module Services
     # The registry holds references to all the services accessible in the library. To access
-    # all services and be able to manage resources easily, just instanciate the 
+    # all services and be able to manage resources easily, just instanciate the
     class Registry
+      include Singleton
 
-      attr_reader :accounts, :sessions
+      # @!attribute [r] accounts
+      #   @return [Core::Services::Accounts] the service managing accounts
+      attr_reader :accounts
+      # @!attribute [r] sessions
+      #   @return [Core::Services::Sessions] the service managing sessions
+      attr_reader :sessions
+      # @!attribute [r] campaigns
+      #   @return [Core::Services::Campaigns] the service managing campaigns
+      attr_reader :campaigns
+      # @!attribute [r] applications
+      #   @return [Core::Services::Applications] the service managing applications
+      attr_reader :applications
+      # @!attribute [r] authorizations
+      #   @return [Core::Services::Authorizations] the service managing authorizations
+      attr_reader :authorizations
+      # @!attribute [r] tokens
+      #   @return [Core::Services::Tokens] the service managing OAuth access tokens
+      attr_reader :tokens
 
       def initialize
-        @accounts = Core::Services::Accounts.new(self)
-        @sessions = Core::Services::Sessions.new(self)
+        @accounts = Core::Services::Accounts.instance
+        @sessions = Core::Services::Sessions.instance
+        @campaigns = Core::Services::Campaigns.instance
+        @applications = Core::Services::Applications.instance
+        @authorizations = Core::Services::Authorizations.instance
+        @tokens = Core::Services::Tokens.instance
       end
     end
   end
-end
+end

data/lib/core/services/sessions.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'bcrypt'
 require 'securerandom'
 
@@ -5,7 +7,8 @@ module Core
   module Services
     # Service concerning sessions (log in and log out)
     # @author Vincent Courtois <courtois.vincent@outlook.com>
-    class Sessions < Core::Services::Base
+    class Sessions
+      include Singleton
       # Creates a new session from the given user credentials. IT will
       # * check that the user exists in the database
       # * check that the password matches the user encrypted password
@@ -16,18 +19,16 @@ module Core
       # @param password [string] the password the user has provided
       # @return [Core::Models::Authentication::Session] the login session
       def create(username, password)
-        account = services.accounts.get_by_username(username)
+        account = Core.svc.accounts.get_by_username(username)
         if BCrypt::Password.new(account.password_digest) != password
-          raise Core::Helpers::Errors::Forbidden.new(
-            field: 'password',
-            error: 'wrong'
-          )
+          raise Core::Helpers::Errors::Forbidden.new(field: 'password', error: 'wrong')
         end
-        return Core::Models::Authentication::Session.create(
+
+        Core::Models::Authentication::Session.create(
           account: account,
           token: SecureRandom.uuid
         )
       end
     end
   end
-end
+end

data/lib/core/services/tokens.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Core
+  module Services
+    # Service handling every operations concerning access tokens. This should mainly be
+    # used in the authentication backend as we should be the only ones to manage tokens.
+    # @author Vincent Courtois <courtois.vincent@outlook.com>
+    class Tokens < Core::Services::Base
+      include Singleton
+
+      def create_from_authorization(client_id: nil, client_secret: nil, authorization_code: nil, **_ignored)
+        authorization = Core.svc.authorizations.get_by_credentials(
+          client_id: client_id,
+          client_secret: client_secret,
+          authorization_code: authorization_code
+        )
+        raise forbidden_err(field: 'authorization_code', error: 'used') if authorization.used?
+
+        created = Core::Models::OAuth::AccessToken.create(authorization: authorization)
+        Core::Decorators::Token.new(created)
+      end
+
+      # Refreshes the token for the next request the client wants to issue by re-creating it
+      # from the previous token to add it to the tokens chain.
+      #
+      def create_from_token(client_id: nil, client_secret: nil, token: nil, **_ignored)
+        token = get_by_value(token: token)
+        authorization = Core.svc.authorizations.get_by_credentials(
+          client_id: client_id,
+          client_secret: client_secret,
+          authorization_code: token.authorization.code
+        )
+        raise forbidden_err(field: 'token', error: 'used') unless token.generated.nil?
+
+        created = Core::Models::OAuth::AccessToken.create(
+          generator: token,
+          authorization: authorization
+        )
+        Core::Decorators::Token.new(created)
+      end
+
+      def get_by_value(token: nil, **_ignored)
+        require_parameters token: token
+        token = Core::Models::OAuth::AccessToken.find_by(value: token)
+        raise unknown_err(field: 'token') if token.nil?
+
+        Core::Decorators::Token.new(token)
+      end
+    end
+  end
+end

data/lib/core/services.rb

@@ -5,8 +5,12 @@ module Core
   # @author Vincent Courtois <courtois.vincent@outlook.com>
   module Services
     autoload :Accounts, 'core/services/accounts'
+    autoload :Applications, 'core/services/applications'
+    autoload :Authorizations, 'core/services/authorizations'
     autoload :Base, 'core/services/base'
+    autoload :Campaigns, 'core/services/campaigns'
     autoload :Registry, 'core/services/registry'
     autoload :Sessions, 'core/services/sessions'
+    autoload :Tokens, 'core/services/tokens'
   end
 end

data/lib/core/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Core
-  VERSION = '1.3.1'
+  VERSION = '1.6.0.dev0'
 end

data/lib/core.rb

@@ -1,12 +1,18 @@
 # frozen_string_literal: true
 
-%w[active_model mongoid active_support].each { |g| require g }
+%w[active_model mongoid active_support draper].each { |g| require g }
 
 # Main module of the application, holding all the subsequent classes.
 # @author Vincent Courtois <courtois.vincent@outlook.com>
 module Core
   autoload :Controllers, 'core/controllers'
+  autoload :Decorators, 'core/decorators'
   autoload :Helpers, 'core/helpers'
   autoload :Models, 'core/models'
   autoload :Services, 'core/services'
+
+  # Returns the registry of services for easier access to each of them.
+  def self.svc
+    Core::Services::Registry.instance
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: virtuatable-core
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.6.0.dev0
 platform: ruby
 authors:
 - Vincent Courtois
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-04-29 00:00:00.000000000 Z
+date: 2022-05-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: database_cleaner
@@ -276,6 +276,20 @@ dependencies:
     - - '='
       - !ruby/object:Gem::Version
         version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: draper
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: This gem holds the model layer for my table-top RPG games application.
 email: courtois.vincent@outlook.com
 executables: []
@@ -285,6 +299,10 @@ files:
 - lib/core.rb
 - lib/core/controllers.rb
 - lib/core/controllers/base.rb
+- lib/core/decorators.rb
+- lib/core/decorators/base.rb
+- lib/core/decorators/campaign.rb
+- lib/core/decorators/token.rb
 - lib/core/helpers.rb
 - lib/core/helpers/accounts.rb
 - lib/core/helpers/applications.rb
@@ -298,7 +316,8 @@ files:
 - lib/core/helpers/parameters.rb
 - lib/core/helpers/responses.rb
 - lib/core/helpers/routes.rb
-- lib/core/helpers/sessions.rb
+- lib/core/helpers/scopes.rb
+- lib/core/helpers/tokens.rb
 - lib/core/models.rb
 - lib/core/models/account.rb
 - lib/core/models/authentication.rb
@@ -331,19 +350,17 @@ files:
 - lib/core/models/oauth/access_token.rb
 - lib/core/models/oauth/application.rb
 - lib/core/models/oauth/authorization.rb
-- lib/core/models/oauth/refresh_token.rb
 - lib/core/models/oauth/scope.rb
-- lib/core/models/permissions.rb
-- lib/core/models/permissions/category.rb
-- lib/core/models/permissions/group.rb
-- lib/core/models/permissions/right.rb
-- lib/core/models/permissions/route.rb
 - lib/core/models/ruleset.rb
 - lib/core/services.rb
 - lib/core/services/accounts.rb
+- lib/core/services/applications.rb
+- lib/core/services/authorizations.rb
 - lib/core/services/base.rb
+- lib/core/services/campaigns.rb
 - lib/core/services/registry.rb
 - lib/core/services/sessions.rb
+- lib/core/services/tokens.rb
 - lib/core/version.rb
 homepage: https://rubygems.org/gems/virtuatable-core
 licenses:
@@ -360,9 +377,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.2.3
 signing_key: 

data/lib/core/helpers/sessions.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module Core
-  module Helpers
-    # This helper gives access to methods about user's session on the API.
-    # @author Vincent Courtois <courtois.vincent@outlook.com>
-    module Sessions
-      # Checks the session of the user requesting the API and returns an error
-      # if it either not exists with the given token, or the token is not given.
-      #
-      # @raise [Virtuatable::API::Errors::NotFound] if the session is not found
-      #   or the token not given in the parameters of the request.
-      # @raise [Virtuatable::API::Errors::BadRequest] if the session token is
-      #   not correctly given in the parameters.
-      #
-      # @return [Core::Models::Authentication::Session] the current session of the user.
-      def session
-        return @session unless @session.nil?
-
-        check_presence 'session_id'
-        @session = session_model.find_by(token: params['session_id'])
-        @session.nil? ? api_not_found('session_id.unknown') : @session
-      end 
-
-      def session_model
-        Core::Models::Authentication::Session
-      end
-    end
-  end
-end

data/lib/core/models/oauth/refresh_token.rb

@@ -1,29 +0,0 @@
-module Core
-  module Models
-    module OAuth
-      # A refresh token is used when an access token is expired, to get a new one. It is then recreated for the next expiration.
-      # @author Vincent Courtois <courtois.vincent@outlook.com>
-      class RefreshToken
-        include Mongoid::Document
-        include Mongoid::Timestamps
-
-        store_in collection: 'oauth_refresh_tokens'
-
-        # @!attribute [rw] value
-        #   @return [String] the value of the token, returned to the application when built.
-        field :value, type: String, default: ->{ SecureRandom.hex }
-        # @!attribute [rw] used_at
-        #   @return [DateTime] the date and time at which this refresh token has been useds to create a new access token.
-        field :used_at, type: DateTime, default: nil
-
-        # @!attribute [rw] authorization
-        #   @return [Core::Models::OAuth::Authorization] the authorization code that issued this token to the application for this user.
-        belongs_to :token, class_name: 'Core::Models::OAuth::AccessToken', inverse_of: :refresh_token
-
-        def used?
-          !used_at.nil? && used_at < DateTime.now
-        end
-      end
-    end
-  end
-end

data/lib/core/models/permissions/category.rb

@@ -1,17 +0,0 @@
-module Core
-  module Models
-    module Permissions
-      # A category of rights regroups one or several rights for convenience purposes.
-      # @author Vincent Courtois <courtois.vincent@outlook.com>
-      class Category
-        include Mongoid::Document
-        include Mongoid::Timestamps
-        include Core::Models::Concerns::Sluggable
-
-        store_in collection: 'categories'
-
-        has_many :rights, class_name: 'Core::Models::Permissions::Right', inverse_of: :category
-      end
-    end
-  end
-end

data/lib/core/models/permissions/group.rb

@@ -1,32 +0,0 @@
-module Core
-  module Models
-    module Permissions
-      # A group gathers one or several users to give them the same rights for conviniency purposes.
-      # @author Vincent Courtois <courtois.vincent@outlook.com>
-      class Group
-        include Mongoid::Document
-        include Mongoid::Timestamps
-        include Core::Models::Concerns::Sluggable
-
-        store_in collection: 'groups'
-
-        # @!attribute [rw] is_default
-        #   @return [Boolean] a boolean indicating whether this group is given when a new user registered or not.
-        field :is_default, type: Mongoid::Boolean, default: false
-        # @!attribute [rw] is_superuser
-        #   @return [Boolean] a boolean indicating whether this group should have access to all groups and rights or not.
-        field :is_superuser, type: Mongoid::Boolean, default: false
-
-        # @!attribute [rw] accounts
-        #   @return [Array<Core::Models::Account>] the accounts having the rights granted by this group.
-        has_and_belongs_to_many :accounts, class_name: 'Core::Models::Account', inverse_of: :groups
-        # @!attribute [rw] rights
-        #   @return [Array<Core::Models::Permissions::Right>] the rights granted by belonging to this group.
-        has_and_belongs_to_many :rights, class_name: 'Core::Models::Permissions::Right', inverse_of: :groups
-        # @!attribute [rw] routes
-        #   @return [Array<Core::Models::Monitoring::Route>] the routes this group can access in the API.
-        has_and_belongs_to_many :routes, class_name: 'Core::Models::Permissions::Route', inverse_of: :groups
-      end
-    end
-  end
-end

data/lib/core/models/permissions/right.rb

@@ -1,21 +0,0 @@
-module Core
-  module Models
-    module Permissions
-      # A right is the access to one or several features in the application. It's applied to a group, and transitively to an account.
-      # @author Vincent Courtois <courtois;vincent@outlook.com>
-      class Right
-        include Mongoid::Document
-        include Mongoid::Timestamps
-        include Core::Models::Concerns::Sluggable
-
-        store_in collection: 'rights'
-
-        # @!attribute [rw] groups
-        #   @return [Array<Core::Models::Permissions::Group>] the groups granted with the permission to access features opened by this right.
-        has_and_belongs_to_many :groups, class_name: 'Core::Models::Permissions::Group', inverse_of: :rights
-
-        belongs_to :category, class_name: 'Core::Models::Permissions::Category', inverse_of: :rights
-      end
-    end
-  end
-end

data/lib/core/models/permissions/route.rb

@@ -1,35 +0,0 @@
-module Core
-  module Models
-    module Permissions
-      # A route is an endpoint accessible in the API. Each route has to have an associated endpoint in the deployed instances.
-      # @param Vincent Courtois <courtois.vincent@outlook.com>
-      class Route
-        include Mongoid::Document
-        include Mongoid::Timestamps
-        include Core::Models::Concerns::Premiumable
-        include Core::Models::Concerns::Activable
-
-        store_in collection: 'routes'
-
-        # @!attribute [rw] path
-        #   @return [String] the path (URI) of the route in the API.
-        field :path, type: String, default: '/'
-        # @!attribute [rw] verb
-        #   @return [String] the verb (HTTP method) of this route in the API.
-        field :verb, type: String, default: 'get'
-        # @!attribute [rw] authenticated
-        #   @return [Boolean] if true, the session_id is needed for this route, if false it is not.
-        field :authenticated, type: Mongoid::Boolean, default: true
-        # @!attribute [rw] groups
-        #   @return [Array<Core::Models::Permissions::Group>] the groups having permission to access this route.
-        has_and_belongs_to_many :groups, class_name: 'Core::Models::Permissions::Group', inverse_of: :groups
-
-        validates :path,
-          format: {with: /\A(\/|((\/:?[a-zA-Z0-9_]+)+))\z/, message: 'pattern', if: :path?}
-
-        validates :verb,
-          inclusion: {message: 'unknown', in: ['get', 'post', 'put', 'delete', 'patch', 'option']}
-      end
-    end
-  end
-end

data/lib/core/models/permissions.rb

@@ -1,13 +0,0 @@
-module Core
-  module Models
-    # This module holds the logic for all the classes concerning the permissions abd rights for the user.
-    # A permission is restricting the access to one or several features to the users having it.
-    # @author Vincent Courtois <courtois.vincent@outlook.com>
-    module Permissions
-      autoload :Right   , 'core/models/permissions/right'
-      autoload :Group   , 'core/models/permissions/group'
-      autoload :Category, 'core/models/permissions/category'
-      autoload :Route   , 'core/models/permissions/route'
-    end
-  end
-end