web47core 3.2.5 → 3.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97511542e4fd2facae8f07554574360af309703a4c4e60236087f0ce8c9d1647
-  data.tar.gz: 1fe0abc1e0e93fb4a33672f53ee244777616c4f8e4c146204d4c5d273cab8490
+  metadata.gz: '09bd1177ff541dc974ea27c1208e06c43be1056962384b6250e52bfc2938fd6b'
+  data.tar.gz: 119fcf27352d87d96ef84328e24cc7adbf6cbe1e18363a2535826e5bb5c3a90d
 SHA512:
-  metadata.gz: fee9f5c0965942cb3e292b71ca556156bbacfe5e87a0c59aeb4b289a2301523ae112401fbe15619928c3551f89ad8a8f21ada2fb5584d8c51a94b14e4b0221bf
-  data.tar.gz: 76ce06f3fb886cee25351187b02fb6fbf83c45f40ce902257b0786b79c82879f48b74311a7ab6f7bf569dbb51b53cf1fd3aa780471e73c9be5bba2fac675fc15
+  metadata.gz: 38926fb70d61e60d8633fcd89e58d2a5e66dca47ac9245eeb31c3de8264917e547d13740819df61850805a06631b69b22929643310feb0a9458fbd893881d9cf
+  data.tar.gz: 061e7c166c012d860b4c66521c2d178943197a1384c0f195ea331d13087b0a0801def262f28b85083c149388368d273cf04adf303632dcc8913b98c798ff036c

data/lib/app/models/command_job.rb

@@ -37,16 +37,22 @@ class CommandJob
   #
   validates :state, inclusion: { in: ALL_STATES }
 
-  #
-  # Who started this job
-  #
+  # @abstract duration for the job
+  # @return Integer - How long this job took in milliseconds
+  def duration
+    finished_at - started_at
+  rescue StandardError
+    0
+  end
+
+  # @abstract Who started this job
+  # @return String - Who started this job if present, otherwise `System`
   def display_started_by
     started_by.present? ? started_by.name : 'System'
   end
 
-  #
-  # Default time to keep a job before auto archiving it
-  #
+  # @abstract Default time to keep a job before auto archiving it
+  # @return Integer - TTL for this job
   def ttl
     30
   end

data/lib/app/models/concerns/archive_able.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+#
+# A module that allows for trash/recycling of an object
+# it will be deleted in the app, but remain in the database until permanently deleted
+#
+module ArchiveAble
+  extend ActiveSupport::Concern
+
+  def self.included(base)
+    base.class_eval do
+      # Fields
+      field :archived, type: Mongoid::Boolean, default: false
+      field :archived_at, type: Time
+      field :archived_by_name, type: String
+      field :archived_by_email, type: String
+      field :restored_at, type: Time
+      field :restored_by_name, type: String
+      field :restored_by_email, type: String
+      # Relationships
+      belongs_to :archived_by, polymorphic: true, optional: true, inverse_of: nil
+      belongs_to :restored_by, polymorphic: true, optional: true, inverse_of: nil
+    end
+  end
+
+  # @abstract Display who archived this object
+  # @return String
+  def display_archived_by
+    if archived_by.present?
+      archived_by.display_name
+    elsif archived_by_email.present?
+      "#{archived_by_name} (#{archived_by_email})"
+    else
+      archived_by_name
+    end
+  end
+
+  # @abstract Display who restored this object
+  # @return String
+  def display_restored_by
+    if restored_by.present?
+      restored_by.display_name
+    elsif restored_by_email.present?
+      "#{restored_by_name} (#{restored_by_email})"
+    else
+      restored_by_name
+    end
+  end
+
+  def unarchived?
+    !archived?
+  end
+
+  # @abstract Archive the object
+  # @param [Member|User] actor - the thing performing the action
+  def archive(actor)
+    params = if actor.is_a? Cron::Job
+               { archived: true,
+                 archived_at: Time.now.utc,
+                 archived_by_name: "System - #{actor.class.name}" }
+             else
+               { archived: true,
+                 archived_by: actor,
+                 archived_at: Time.now.utc,
+                 archived_by_name: actor.name,
+                 archived_by_email: actor.email }
+             end
+    params[:name] = "#{name}-(archived at #{Time.now.utc})" if respond_to?(:name=)
+    update params
+  end
+
+  # @abstract recycle the object
+  # @param [Member|User] actor - the actor performing the action
+  def restore(actor)
+    params = { archived: false,
+               restored_by: actor,
+               restored_at: Time.now.utc,
+               restored_by_name: actor.name,
+               restored_by_email: actor.email }
+    params[:name] = name.split('-(archived at').first if respond_to?(:name=)
+    update params
+  end
+
+  def days_to_deletion
+    archived? ? ((archived_at + retention_days.days - Time.now.utc) / 86_400).to_i :  0
+  rescue StandardError
+    archived? ? retention_days : 0
+  end
+
+  def retention_days
+    30
+  end
+end

data/lib/web47core/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Web47core
-  VERSION = '3.2.5'
+  VERSION = '3.2.6'
 end

data/lib/web47core.rb

@@ -1,6 +1,7 @@
 require 'web47core/config'
 require 'app/models/concerns/app47_logger'
 require 'app/models/concerns/api_tokenable'
+require 'app/models/concerns/archive_able'
 require 'app/models/concerns/aws_configuration'
 require 'app/models/concerns/core_system_configuration'
 require 'app/models/concerns/core_account'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: web47core
 version: !ruby/object:Gem::Version
-  version: 3.2.5
+  version: 3.2.6
 platform: ruby
 authors:
 - Chris Schroeder
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-21 00:00:00.000000000 Z
+date: 2024-12-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -645,6 +645,7 @@ files:
 - lib/app/models/command_job_log.rb
 - lib/app/models/concerns/api_tokenable.rb
 - lib/app/models/concerns/app47_logger.rb
+- lib/app/models/concerns/archive_able.rb
 - lib/app/models/concerns/aws_configuration.rb
 - lib/app/models/concerns/cdn_url.rb
 - lib/app/models/concerns/cipher_able.rb
@@ -712,7 +713,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.5.13
 signing_key:
 specification_version: 4
 summary: App47 Web Core Library.