loggable_activity 0.5.4 → 0.5.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24bd885b926bbd2d1b0795d5265b0121b03a99ea3057da14c60669de72d5ef98
-  data.tar.gz: b5d04e92f45bb6d7a1af4d1f6e22489cb4f88798771403ee6ad1cf97ae0433fd
+  metadata.gz: e8d0d096b34f0b29dc9d0af6fb1c44e7fb4ba79b85b92e0e6aee4d895e5dcc57
+  data.tar.gz: 35ffb9e0e97409e8da7d659a37a37a66e2305f441505c4852af03d9681b8d90d
 SHA512:
-  metadata.gz: 5a88d29b6655e37f8713ece59f8cbd48f36da48e2d1f1945e7de7f08572db4591109bd88b4804e6523d9a8c428c12799f04e7d220d221be4b48fc38c6761eee3
-  data.tar.gz: a6e037dc4d8732af308fc162134144a164815d5f1915701cad9cb5b543353fceac2b7bd0a56ae19bd028163eb42b78316f0a16d533da6f24bc0447e7f967bf3c
+  metadata.gz: f2cae0fe288f7ac429004f9318e833af33d2b629b57041dfa6d2da11e81b6cf10cd282ee0672b5a8aab4a0529ff9637f682979c9b91749559827863b42281c10
+  data.tar.gz: 7f068e3bf66ac331a646e909c631d79ef9e455643f13b2ac9a3e574d99e9dfefc046d76885a6f38bba275a5763c8c7f64980076a86cbc4e230dd4d65aaa64d2c

data/.rubocop.yml

@@ -1,4 +1,5 @@
 AllCops:
+  NewCops: enable
   Exclude:
     - 'db/migrate/20240702092648_create_loggable_activity_tables.rb'
 Layout/LineLength:
@@ -9,6 +10,8 @@ Layout/LineLength:
 Metrics/AbcSize:
   Exclude:
     - 'lib/loggable_activity/encryption.rb'
+    - 'lib/loggable_activity/services/update_payloads_builder.rb'
+    - 'lib/generators/loggable_activity/install/templates/create_loggable_activities.rb'
 Metrics/BlockLength:
   Exclude:
     - 'test/dummy/config/environments/development.rb'
@@ -18,6 +21,7 @@ Metrics/ClassLength:
   Exclude:
     - 'lib/loggable_activity/services/update_payloads_builder.rb'
 Metrics/MethodLength:
+  Enabled: true
   Exclude:
     - 'lib/loggable_activity/services/update_payloads_builder.rb'
     - 'lib/loggable_activity/services/destroy_payloads_builder.rb'
@@ -27,6 +31,9 @@ Metrics/MethodLength:
     - 'lib/loggable_activity/activity.rb'
     - 'lib/loggable_activity/services/payloads_builder.rb'
     - 'lib/loggable_activity/hooks.rb'
+    - 'test/dummy/db/migrate/20240629154538_create_users.rb'
+    - 'lib/loggable_activity/services/custom_payloads_builder.rb'
+    - 'lib/generators/loggable_activity/install/templates/create_loggable_activities.rb'
 Metrics/ModuleLength:
   Exclude:
     - 'lib/loggable_activity/hooks.rb'
@@ -36,3 +43,6 @@ Style/Documentation:
     - 'app/models/loggable_activity/application_record.rb'
     - 'app/mailers/loggable_activity/application_mailer.rb'
     - 'app/helpers/loggable_activity/application_helper.rb'
+Metrics/CyclomaticComplexity:
+  Exclude:
+    - 'lib/loggable_activity/hooks.rb'

data/CHANGELOG.md

@@ -1,10 +1,16 @@
-## [0.5.3] - 2024-03-21
+## [0.5.6] - 2024-07-18
+- Documentation updated
+- Generator updated
+
+## [0.5.5] - 2024-07-16
+- Custom attrs added
 ### Breaking change
-- Styling changed to bootstrap 
 - Configuration.yml changed 
 
+## [0.5.4] - 2024-03-21
+- Styling with bootstrap css
+
 ## [0.5.2] - 2024-03-21
-### Breaking change
 - Styling with pico css
 - Public attrs added
 

data/GETTING-STARTED.md

@@ -0,0 +1,60 @@
+# Getting started 
+This document should you getting started with `LoggableActivity`
+
+## Prerequisite
+1 A running Rails Application<br/>
+2 An authorization system where a current user or similar is available.
+
+## Installation
+Add the loggable_activity gem to the Gemfile `gem 'loggable_activity', '~> 0.5.4` and then<br/>
+```
+$ bundle install
+```
+Then we have to generate some migrations and execute them<br/>
+```
+$ bin/rails generate loggable_activity:install
+$ bin/rails db:migrate
+```
+
+## Add hoks to models
+```
+class User < ApplicationRecord
+  include LoggableActivity::Hooks
+```
+
+## Configuration
+Update `config/initializers/loggable_activity.rb` documentation is in the file.
+
+## loggable_activity.yaml
+You have to update the configuration file installed inside the `config/loggable_activity.yaml`
+This file defines how data are logged.
+
+## Automatically log show from controllers
+This assumes that there is a current_user. E.g provided by the Devise gem</br>
+Add a this to the application_controller.rb if you want automatically log show
+```
+class ApplicationController < ActionController::Base
+  include LoggableActivity::CurrentUser
+```
+Otherwise you might create `app/controllers/concerns/current_user.rb` and alter it . 
+
+## Manually log show from controllers
+If you want to log the show action you can add this to your controllers show method
+```
+def show
+  @user.log(:show)
+```
+
+## For developers and contributors 
+You can download and play around with a demo app
+- 1 Download the project from [github](https://github.com/LoggableActivity/LoggableActivity) 
+- 1 Download the demo application from [github](https://github.com/LoggableActivity/LoggableActivityDemoApp)
+- 2 Update the Gemfile in the demo project so it points to your localhost.
+```
+Gemfile
+
+gem 'loggable_activity', '~> VERSION', path: '/PATH_TO_PROJECT/LoggableActivityEngine/LoggableActivityEngine'
+# gem 'loggable_activity', '~> VERSION'
+```
+*VERSION is the version number found in the gemfile*<br/>
+*PATH_TO_PROJECT* is where you have stored the project on your local drive

data/README.md

@@ -1,11 +1,8 @@
 # Loggable Activity 🌟
-Secure protect data and log how it is handled
-- Keep an activity log of how data in the db are handled.
-- Protect and secure the privacy of data stored in Activity Logs
-- Prepare for General Data Protection Regulation (GDPR) compliance.
-- Handles activities that involves more than one table in the DB.
-- Encrypt data stored in the activity log
-- Support binary_ids
+Super easy to use activity log with views out of the box
+- Just add the gem and mount the engine and you have a cool looking activity log.
+- Easy and simple to customize and configure
+- All data are encrypted, and 
 
 ### Important!
 This project is under development and not ready for production. There might be breaking changes, so please consult the CHANGELOG.md

data/app/views/loggable_activity/activities/_activities.html.slim

@@ -1,13 +1,13 @@
 
 .row 
   .col-3 
-    b.text-secondary Action
+    b.text-secondary = t('loggable_activity.activity.action') 
   .col-3 
-    b.text-secondary Record
+    b.text-secondary = t('loggable_activity.activity.record') 
   .col-3 
-    b.text-secondary Actor
+    b.text-secondary = t('loggable_activity.activity.actor')
   .col-3 
-    b.text-secondary Created At
+    b.text-secondary = t('loggable_activity.activity.created_at')
 
 - @activities.each do |activity|
   .activity.activity-info[type="button" data-bs-toggle="collapse" data-bs-target="#activity_#{activity.id}" aria-expanded="false" aria-controls="collapseExample"]
@@ -15,9 +15,9 @@
       .col-3
         = activity_action(activity) 
       .col-3
-        = t(activity.record_display_name)
+        = activity.record_display_name
       .col-3 
-        = t(activity.actor_display_name)
+        = activity.actor_display_name
       .col-3 
         = l(activity.created_at, format: :long)
   .collapse id="activity_#{activity.id}"

data/lib/generators/loggable_activity/install/install_generator.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+# This module provides generators for installing and configuring LoggableActivity.
+# It includes generators for creating initializer, migration, and locale files.
+#
+# Example usage:
+#   rails generate loggable_activity:install
+#
+# This will:
+# - Create an initializer file in config/initializers/loggable_activity.rb
+# - Create a migration file in db/migrate/
+# - Create a locale file in config/locales/loggable_activity.en.yml
+#
+# After running the generator, remember to:
+# - Add `mount LoggableActivity::Engine => '/loggable_activity'` to your routes.rb file.
+# - Run `rails db:migrate` to create the necessary database tables.
+# - Include `LoggableActivity::Hook` in the models you want to track.
+# - Update the config/loggable_activity.yaml file with the fields you want to track.
+# - Ensure the locale files are properly set up in config/locales/loggable_activity.en.yml.
+module LoggableActivity
+  module Generators
+    # The InstallGenerator class is responsible for copying the necessary
+    # files to set up LoggableActivity in a Rails application.
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+
+      desc 'Creates a LoggableActivity initializer in your application.'
+      def copy_initializer
+        template 'loggable_activity.rb', 'config/initializers/loggable_activity.rb'
+      end
+
+      desc 'Creates a migration file for LoggableActivity in your application.'
+      def copy_migration
+        template 'create_loggable_activities.rb', "db/migrate/#{migration_number}_create_loggable_activities.rb"
+      end
+
+      desc 'Creates a locale file for LoggableActivity in your application.'
+      def copy_locale
+        template 'loggable_activity.en.yml', 'config/locales/loggable_activity.en.yml'
+      end
+
+      # Generates a timestamp to use in the migration filename.
+      #
+      # @return [String] the current UTC time formatted as a timestamp
+      def migration_number
+        Time.now.utc.strftime('%Y%m%d%H%M%S')
+      end
+
+      puts ''
+      puts "\e[1m\e[32m* ----------------------------- LoggableActivity ----------------------------- *\e[0m"
+      puts "\e[1m\e[32m*                                                                              *\e[0m"
+      puts "\e[1m\e[32m* LoggableActivity has been successfully installed.                            *\e[0m"
+      puts "\e[1m\e[32m* Add the following to your routes.rb file.                                    *\e[0m"
+      puts "\e[1m\e[32m* Mount LoggableActivity::Engine => '/loggable_activity'                       *\e[0m"
+      puts "\e[1m\e[32m*                                                                              *\e[0m"
+      puts "\e[1m\e[32m* $ rails db:migrate to create the tables.                                     *\e[0m"
+      puts "\e[1m\e[32m*                                                                              *\e[0m"
+      puts "\e[1m\e[32m* Add include LoggableActivity::Hook to the models you want to track.          *\e[0m"
+      puts "\e[1m\e[32m*                                                                              *\e[0m"
+      puts "\e[1m\e[32m* Update the config/loggable_activity.yaml file with fields to track.          *\e[0m"
+      puts "\e[1m\e[32m*                                                                              *\e[0m"
+      puts "\e[1m\e[32m* Locale files are found in config/locale/loggable_activity.en.yaml.           *\e[0m"
+      puts "\e[1m\e[32m*                                                                              *\e[0m"
+      puts "\e[1m\e[32m* ---------------------------------------------------------------------------- *\e[0m"
+      puts ''
+    end
+  end
+end

data/lib/generators/loggable_activity/install/templates/create_loggable_activities.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+# This migration creates the necessary tables for LoggableActivity.
+class CreateLoggableActivities < ActiveRecord::Migration[7.1]
+  def change
+    create_table :loggable_activity_encryption_keys do |t|
+      t.references :record, polymorphic: true, null: true, index: true
+      t.string :secret_key
+      t.datetime :delete_at
+
+      t.timestamps
+    end
+
+    create_table :loggable_activity_activities do |t|
+      t.string :action
+      t.references :actor, polymorphic: true, null: true
+      t.string :encrypted_actor_name
+      t.references :record, polymorphic: true, null: true
+
+      t.timestamps
+    end
+
+    create_table :loggable_activity_payloads do |t|
+      t.references :activity, null: false, foreign_key: { to_table: 'loggable_activity_activities' }
+      t.references :encryption_key, null: false, foreign_key: { to_table: 'loggable_activity_encryption_keys' }
+      t.references :record, polymorphic: true, null: true, index: true
+      t.string :encrypted_record_name
+      t.json :encrypted_attrs
+      t.integer :related_to_activity_as, default: 0
+      t.boolean :data_owner, default: false
+      t.string :route
+      t.boolean :current_payload, default: true
+      t.json :public_attrs, default: {}
+
+      t.timestamps
+    end
+
+    create_table :loggable_activity_data_owners do |t|
+      t.references :record, polymorphic: true, null: true, index: true
+      t.references :encryption_key, null: false, foreign_key: { to_table: 'loggable_activity_encryption_keys' }
+
+      t.timestamps
+    end
+  end
+end

data/lib/generators/loggable_activity/install/templates/loggable_activity.en.yml

@@ -0,0 +1,32 @@
+
+# This file was generated when you installed Loggable Activity and is used for internationalization.
+# When a model 'includes LoggableActivity::Hooks' tags for translations are generated.
+# Example:
+# class User < ApplicationRecord
+#   include LoggableActivity::Hooks
+# end
+# This will make the following tags for translations available:
+# - loggable_activity.user.create
+# - loggable_activity.user.show
+# - loggable_activity.user.update
+# - loggable_activity.user.destroy
+# - loggable_activity.user.login
+# - loggable_activity.user.logout
+# 
+en:
+  loggable_activity:
+    activity:
+      actor: Actor
+      action: Action
+      record: Record
+      created_at: Created at
+      deleted: "*** DELETED ***"
+    user:
+      update: A user was updated
+      create: A user was created
+      show: "A user was shown"
+      destroy: A user was deleted
+      sign_up: A user signed up
+      login: A user logged in
+      logout: A user logged out
+      

data/lib/generators/loggable_activity/install/templates/loggable_activity.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# This configuration file is for setting up the LoggableActivity gem in your Rails application.
+
+# Specify the name of the model that represents the actor performing the activities.
+# This should be a string that matches the class name of the model.
+# Example: If your user model is named "User", set it to 'User'.
+LoggableActivity.actor_model_name = 'User'
+
+# Specify the attribute from which to fetch the actor's name.
+# This should be eighter a string representing the attribute name of the actor model
+# or a method that returns the actor's name.
+# Example: If you want to use the user's email as their name, set it to 'email'.
+LoggableActivity.fetch_actor_name_from = 'email'
+
+# Specify the path to the configuration file for LoggableActivity.
+# This file should be a YAML file that contains the necessary configuration for logging activities.
+# The path is set relative to the Rails root directory.
+# Example: The default configuration file path is 'config/loggable_activity.yaml'.
+LoggableActivity.config_file_path = Rails.root.join('config/loggable_activity.yaml')
+
+# Specify whether the sanitazion should be performed by a task or not
+# If set to 'false' the sanitization is performed immediately.
+# If set to 'true' the data is inaccessible, but can be restored.
+# If set to 'true' you have to permanently delete
+# the data by calling 'LoggableActivity::Sanitizer.run' from a task.
+LoggableActivity.task_for_sanitization = false

data/lib/generators/loggable_activity/install/templates/loggable_activity.yml

@@ -0,0 +1,103 @@
+Company:
+  fetch_record_name_from: name
+  route: /companies/:id
+  loggable_attrs:
+    - name
+  public_attrs:
+    - name
+  relations:
+    - has_many: :users
+      route: /users/:id
+      model: User
+      loggable_attrs:
+        - first_name
+        - last_name
+  auto_log:
+    - create
+    - update
+    - destroy
+Hat:
+  fetch_record_name_from: color
+  route: /user/:id
+  loggable_attrs:
+    - color
+  auto_log:
+    - create
+    - destroy
+  relations:
+    - belongs_to: :user
+      route: /demo/users/:id
+      model: User
+      loggable_attrs:
+        - first_name
+User:
+  fetch_record_name_from: full_name
+  route: /demo/users/:id
+  loggable_attrs:
+    - first_name
+    - last_name
+    - age
+    - email
+    - user_type
+  auto_log:
+    - create
+    - update
+    - destroy
+  public_attrs:
+    - age
+    - user_type
+  relations:
+    - has_one: :profile
+      route: /demo/users/:id/profile
+      model: Profile
+      loggable_attrs:
+        - bio
+        - phone_number
+      public_attrs:
+        - date_of_birth
+    - has_many: :hats
+      route: /users/:id
+      model: Hat
+      loggable_attrs:
+        - color
+    - belongs_to: :company
+      route: /companies/:id
+      model: Company
+      loggable_attrs:
+        - name
+Profile:
+  fetch_record_name_from: phone_number
+  route: /demo/profiles/:id
+  loggable_attrs:
+    - bio
+    - profile_picture_url
+    - location
+    - date_of_birth
+    - phone_number
+  public_attrs:
+    - date_of_birth
+  # auto_log:
+  #   - create
+  #   - update
+  #   - destroy
+  # relations:
+  #   - belongs_to: :user
+  #     route: /demo/users/:id
+  #     model: User
+  #     loggable_attrs:
+  #       - first_name
+  #       - last_name
+  #       - age
+  #       - email
+  #       - user_type
+#   - belongs_to: :demo_address
+#     route: show_demo_address
+#     model: Demo::Address
+#     loggable_attrs:
+#       - street
+#       - postal_code
+#   - belongs_to: :demo_club
+#     route: show_demo_club
+#     model: Demo::Club
+#     loggable_attrs:
+#       - name

data/lib/loggable_activity/activity.rb

@@ -31,7 +31,8 @@ module LoggableActivity
       'has_many_update_payload' => 'has_many',
       'belongs_to_payload' => 'belongs_to',
       'belongs_to_destroy_payload' => 'belongs_to',
-      'belongs_to_update_payload' => 'belongs_to'
+      'belongs_to_update_payload' => 'belongs_to',
+      'custom_payload' => 'self'
     }.freeze
 
     # Returns an array of hashes, each representing an activity's attributes and its associated relations. The structure and relations to include are specified in 'config/loggable_activity.yaml'. This format is designed for UI display purposes.
@@ -106,7 +107,7 @@ module LoggableActivity
     #   "David Bowie"
     #
     def record_display_name
-      primary_payload.record_display_name
+      primary_payload&.record_display_name
     end
 
     # Returns the path for the activity.
@@ -135,7 +136,6 @@ module LoggableActivity
       return I18n.t('loggable.activity.deleted') if actor_deleted?
 
       ::LoggableActivity::Encryption.decrypt(encrypted_actor_name, actor_secret_key)
-      
     end
 
     # Returns a list of activities for a given actor.
@@ -172,7 +172,7 @@ module LoggableActivity
     #   payload.record_type  # => 'SOMD_MODEL_NAME'
     #
     def primary_payload
-      related_to_activity_as = %w[primary_payload primary_update_payload primary_destroy_payload]
+      related_to_activity_as = %w[primary_payload primary_update_payload primary_destroy_payload custom_payload]
       payloads.detect { |p| related_to_activity_as.include?(p.related_to_activity_as) }
     end
 

data/lib/loggable_activity/config_schema.json

@@ -1,16 +1,8 @@
 {
   "$schema": "http://json-schema.org/draft-06/schema#",
   "type": "object",
-  "properties": {
-    "fetch_actor_name_from": {
-      "type": "string"
-    },
-    "task_for_sanitization": {
-      "type": "boolean"
-    }
-  },
   "patternProperties": {
-    "^(?!fetch_actor_name_from$|task_for_sanitization)[A-Za-z0-9_:]+$": {
+    "^[A-Za-z0-9_:]+$": {
       "type": "object",
       "properties": {
         "data_owner": {
@@ -82,8 +74,5 @@
       ]
     }
   },
-  "additionalProperties": false,
-  "required": [
-    "fetch_actor_name_from"
-  ]
+  "additionalProperties": false
 }

data/lib/loggable_activity/configuration.rb

@@ -51,16 +51,6 @@ module LoggableActivity
       def for_class(class_name)
         config_data[class_name]
       end
-
-      # Returns the name of the field or method to use for the actor's display name.
-      def fetch_actor_name_from
-        config_data['fetch_actor_name_from']
-      end
-      
-      # Returns whatever models should be sanitized on delete.
-      def task_for_sanitization
-        config_data['task_for_sanitization']
-      end
     end
   end
 end

data/lib/loggable_activity/encryption.rb

@@ -16,13 +16,11 @@ module LoggableActivity
     #   "SOME_ENCRYPTED_STRING"
     #
     def self.encrypt(data, secret_key)
-      return nil if secret_key.nil?
-      return nil if data.nil?
+      return nil if secret_key.nil? || data.nil?
 
       encryption_key = Base64.decode64(secret_key)
       unless encryption_key.bytesize == 32
-        raise EncryptionError,
-              "Encryption failed: Invalid encoded_key length #{encryption_key.bytesize}"
+        raise EncryptionError, "Encryption failed: Invalid encoded_key length #{encryption_key.bytesize}"
       end
 
       cipher = OpenSSL::Cipher.new('AES-256-CBC').encrypt
@@ -39,19 +37,47 @@ module LoggableActivity
     # Decrypts the given data using the given encryption key
     #
     # Example:
-    #   ::LoggableActivity::Encryption.decrypt('SOME_ENCRYPTED_STRING', 'SECRET_KEY')
+    #   ::LoggableActivity::Encryption.decrypt('SOME_ENCRYPTED_DATA', 'SECRET_KEY')
     #
     # Returns:
     #   "my secret data"
     #
     def self.decrypt(data, secret_key)
+      case data
+      when Hash
+        decrypt_hash(data, secret_key)
+      when Array
+        decrypt_array(data, secret_key)
+      else
+        decrypt_data(data, secret_key)
+      end
+    end
+
+    # Decrypts a hash's values using the given encryption key
+    def self.decrypt_hash(data, secret_key)
+      data
+        .transform_values { |value| decrypt(value, secret_key) }
+        .transform_keys(&:to_sym)
+    end
+
+    # Decrypts an array's values using the given encryption key
+    def self.decrypt_array(data, secret_key)
+      data.map { |value| decrypt(value, secret_key) }
+    end
+
+    # Checks if a value is blank
+    def self.blank?(value)
+      value.respond_to?(:empty?) ? value.empty? : !value
+    end
+
+    # Decrypts individual data using the given encryption key
+    def self.decrypt_data(data, secret_key)
       return I18n.t('loggable_activity.activity.deleted') if secret_key.nil?
       return '' if data.blank?
 
       encryption_key = Base64.decode64(secret_key)
       unless encryption_key.bytesize == 32
-        raise EncryptionError,
-              "Decryption failed: Invalid encoded_key length: #{encryption_key.bytesize}"
+        raise EncryptionError, "Decryption failed: Invalid encoded_key length: #{encryption_key.bytesize}"
       end
 
       cipher = OpenSSL::Cipher.new('AES-256-CBC').decrypt
@@ -73,10 +99,5 @@ module LoggableActivity
       Rails.logger.error "ArgumentError Decryption failed: #{e.message}"
       I18n.t('loggable_activity.decryption.failed')
     end
-
-    # Returns true if the given value is blank
-    def self.blank?(value)
-      value.respond_to?(:empty?) ? value.empty? : !value
-    end
   end
 end

data/lib/loggable_activity/encryption_key.rb

@@ -14,7 +14,7 @@ module LoggableActivity
 
     # Prepare the record for deletion
     def mark_as_deleted!
-      LoggableActivity::Configuration.task_for_sanitization ? update(delete_at: DateTime.now + 1.month) : delete
+      LoggableActivity.task_for_sanitization ? update(delete_at: DateTime.now + 1.month) : delete
     end
 
     # check if the encryption key is deleted or it is about to be deleted

data/lib/loggable_activity/error.rb

@@ -4,21 +4,21 @@ module LoggableActivity
   # Error class for loggable activity.
   class Error < StandardError
     def initialize(msg = '')
-      super(msg)
+      super
     end
   end
 
   # Error class for encryption.
   class EncryptionError < StandardError
     def initialize(msg = '')
-      super(msg)
+      super
     end
   end
 
   # This class is used to load the configuration file located at config/loggable_activity.yml
   class ConfigurationError < StandardError
     def initialize(msg = '')
-      super(msg)
+      super
     end
   end
 end

data/lib/loggable_activity/hooks.rb

@@ -42,7 +42,7 @@ module LoggableActivity
     #   @param params [Hash] Additional parameters for the activity.
     def log(action, actor: nil, params: {})
       @action = action
-      @actor = actor || Thread.current[:current_user]
+      @actor = actor || Thread.current[:current_user] || created_by_self
       return nil if @actor.nil?
 
       @record = self
@@ -56,8 +56,14 @@ module LoggableActivity
         log_destroy
       when :update
         log_update
+      when :login
+        log_login
+      when :logout
+        log_logout
+      when :sign_up
+        log_sign_up
       else
-        log_custom_activity(action)
+        log_custom_activity
       end
     end
 
@@ -67,6 +73,15 @@ module LoggableActivity
 
     private
 
+    # If the actor is the same as the record, it is created by the actor.
+    # This assumes it is a sign_up action.
+    def created_by_self
+      return unless LoggableActivity.actor_model_name == self.class.name
+
+      @action = :sign_up
+      self
+    end
+
     # Logs an activity for the current action.
     def log_activity
       create_activity(build_payloads)
@@ -95,6 +110,28 @@ module LoggableActivity
       )
     end
 
+    def log_login
+      create_activity(build_payloads)
+    end
+
+    def log_logout
+      create_activity(build_payloads)
+    end
+
+    def log_sign_up
+      create_activity(build_payloads)
+    end
+
+    # Logs a custom activity.
+    def log_custom_activity
+      create_activity(build_custom_payload)
+    end
+
+    def build_custom_payload
+      ::LoggableActivity::Services::CustomPayloadsBuilder
+        .new(self, @payloads, @params).build
+    end
+
     # Builds update payloads for the current action.
     def build_update_payloads
       ::LoggableActivity::Services::UpdatePayloadsBuilder
@@ -118,9 +155,6 @@ module LoggableActivity
       @payloads.empty?
     end
 
-    # Logs a custom activity.
-    def log_custom_activity(activity); end
-
     # Logs an update activity automatically if configured.
     def log_update_activity
       return unless hooks_enabled?
@@ -171,7 +205,7 @@ module LoggableActivity
 
     # Reads the field to feetch the record name from.
     def fetch_actor_name_from
-      ::LoggableActivity::Configuration.fetch_actor_name_from
+      LoggableActivity.fetch_actor_name_from
     end
 
     # Returns the action key for the current action.

data/lib/loggable_activity/payload.rb

@@ -22,6 +22,7 @@ module LoggableActivity
       has_one_payload
       belongs_to_update_payload
       has_many_create_payload
+      custom_payload
     ].freeze
 
     # Enumeration for different updatepayload types
@@ -47,7 +48,8 @@ module LoggableActivity
       belongs_to_update_payload: 9,
       belongs_to_destroy_payload: 10,
       has_one_destroy_payload: 11,
-      has_many_destroy_payload: 12
+      has_many_destroy_payload: 12,
+      custom_payload: 13
     }
 
     # Returns the decrypted attrs.
@@ -62,14 +64,14 @@ module LoggableActivity
     #
     def attrs
       return deleted_attrs if record.nil?
-  
+
       case related_to_activity_as
       when *DECRYPT_ATTRS_TYPES
-        decrypted_attrs.merge(public_attrs: public_attrs)
+        decrypted_attrs.merge(public_attrs:)
       when *DECRYPT_UPDATE_ATTRS_TYPES
         decrypted_update_attrs + public_attrs['changes']
       else
-        { public_attrs: public_attrs }
+        { public_attrs: }
       end
     end
 

data/lib/loggable_activity/services/base_payloads_builder.rb

@@ -6,9 +6,10 @@ module LoggableActivity
     # Other service modules related to the loggable activity will inherit from this module.
     class BasePayloadsBuilder
       # Initializes the PayloadsBuilder with a record and an initial collection of payloads,
-      def initialize(record, payloads)
+      def initialize(record, payloads, params = {})
         @record = record
         @payloads = payloads
+        @params = params
         @loggable_attrs = record.class.loggable_attrs
         @public_attrs = record.class.public_attrs
         # @relation_config = record.relation_config

data/lib/loggable_activity/services/custom_payloads_builder.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module LoggableActivity
+  module Services
+    # This service class builds custom payloads.
+    class CustomPayloadsBuilder < BasePayloadsBuilder
+      # Builds a custom payloads for a ::LoggableActivity::Activity.
+      def build
+        encryption_key = encryption_key_for_record(@record)
+        @secret_key = encryption_key&.secret_key
+        encrypted_attrs = build_custom_payloads(@params)
+
+        payload = ::LoggableActivity::Payload.new(
+          encryption_key:,
+          record: @record,
+          encrypted_record_name:,
+          encrypted_attrs:,
+          related_to_activity_as: 'custom_payload',
+          route: @record.class.route,
+          current_payload: true,
+          data_owner: @record,
+          public_attrs: {}
+        )
+
+        unless payload.valid?
+          error_message = "Payload validation failed: #{payload.errors.full_messages.join(', ')}"
+          raise LoggableActivity::Error, error_message
+        end
+
+        @payloads << payload
+      end
+
+      private
+
+      def encrypted_record_name
+        return encrypt_attr(@params[:display_name], @secret_key) if @params[:display_name]
+
+        encrypt_record_name_for_record(@record, @secret_key)
+      end
+
+      def build_custom_payloads(params)
+        params.transform_values do |value|
+          case value
+          when Hash
+            build_custom_payloads(value)
+          when Array
+            value.map { |v| v.is_a?(Hash) ? build_custom_payloads(v) : encrypt_attr(v, @secret_key) }
+          else
+            encrypt_attr(value, @secret_key)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/loggable_activity/version.rb

@@ -3,5 +3,5 @@
 # Version of the gem
 module LoggableActivity
   # Version
-  VERSION = '0.5.4'
+  VERSION = '0.5.6'
 end

data/lib/loggable_activity.rb

@@ -12,6 +12,7 @@ require 'loggable_activity/payload'
 require 'loggable_activity/error'
 require 'loggable_activity/sanitizer'
 require 'loggable_activity/services/base_payloads_builder'
+require 'loggable_activity/services/custom_payloads_builder'
 require 'loggable_activity/services/payloads_builder'
 require 'loggable_activity/services/update_payloads_builder'
 require 'loggable_activity/services/destroy_payloads_builder'
@@ -48,6 +49,8 @@ require 'kaminari'
 #
 # This module is designed to be both powerful and easy to integrate, providing a solid foundation for activity logging.
 module LoggableActivity
-  mattr_accessor :actor_class
+  mattr_accessor :actor_model_name
+  mattr_accessor :fetch_actor_name_from
   mattr_accessor :config_file_path
+  mattr_accessor :task_for_sanitization
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: loggable_activity
 version: !ruby/object:Gem::Version
-  version: 0.5.4
+  version: 0.5.6
 platform: ruby
 authors:
 - Max Groenlund
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-07-14 00:00:00.000000000 Z
+date: 2024-07-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -118,114 +118,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 3.6.3
-- !ruby/object:Gem::Dependency
-  name: sqlite3
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.4.2
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.4.2
-- !ruby/object:Gem::Dependency
-  name: awesome_print
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.9'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.9.2
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.9'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.9.2
-- !ruby/object:Gem::Dependency
-  name: factory_bot_rails
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.4'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 6.4.3
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.4'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 6.4.3
-- !ruby/object:Gem::Dependency
-  name: faker
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.4'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.4.1
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.4'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.4.1
-- !ruby/object:Gem::Dependency
-  name: mocha
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.4'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.4'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.60'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.60.2
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.60'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.60.2
 description: |2
       LoggableActivity is a powerful gem for Ruby on Rails that provides seamless user activity logging
       prepared for GDPR compliance and supporting record relations. It allows you to effortlessly
@@ -245,6 +137,7 @@ files:
 - CHANGELOG.md
 - CHEAT_SHEET.md
 - CODE_OF_CONDUCT.md
+- GETTING-STARTED.md
 - MIT-LICENSE
 - README.md
 - Rakefile
@@ -298,6 +191,11 @@ files:
 - git-org/hooks/push-to-checkout.sample
 - git-org/hooks/update.sample
 - git-org/info/exclude
+- lib/generators/loggable_activity/install/install_generator.rb
+- lib/generators/loggable_activity/install/templates/create_loggable_activities.rb
+- lib/generators/loggable_activity/install/templates/loggable_activity.en.yml
+- lib/generators/loggable_activity/install/templates/loggable_activity.rb
+- lib/generators/loggable_activity/install/templates/loggable_activity.yml
 - lib/loggable_activity.rb
 - lib/loggable_activity/.DS_Store
 - lib/loggable_activity/activity.rb
@@ -313,6 +211,7 @@ files:
 - lib/loggable_activity/payload.rb
 - lib/loggable_activity/sanitizer.rb
 - lib/loggable_activity/services/base_payloads_builder.rb
+- lib/loggable_activity/services/custom_payloads_builder.rb
 - lib/loggable_activity/services/destroy_payloads_builder.rb
 - lib/loggable_activity/services/payloads_builder.rb
 - lib/loggable_activity/services/update_payloads_builder.rb