eco-helpers 2.0.50 → 2.0.51

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c8f3ba10e4524d33de8f1339a48fa9c48c86a7e1b0650e29710d05083b6ed82
-  data.tar.gz: f68a0adda4ccebff9552e652bc47bc25cbc72129fe025e5c31b9c542b83ed9f3
+  metadata.gz: fb5e3755230835f1a3ad402b7dd2fc9b25902ea2ca3a621c8eae0229de716791
+  data.tar.gz: c0af346142ec3ff97c32503597ae36d9844273e1c20fb6908a3cfcf5595dff54
 SHA512:
-  metadata.gz: 215c64f98db5f29daad59fad9b4f559e0c7e2a136671d87ab9e37a6e2403cafb123948fbb8cd852ddb3155f35e4b52545d9d948df638402f7c3a63797a397690
-  data.tar.gz: 8a6119977b69ef6aa699ed718142d377866c1c5f379027b9b5713655525f578f837cf543df70be3dbeee1868cd6328f12ee782b1ba743f1aa87ce4cc592bc2cb
+  metadata.gz: 4a2f508415dac83ffe596e330d56a55eb427788d57d239b62b1523bb6abb8f465d6400c1f0c61135d7eb6e036a595d7aacb158cc464e9840a5af8ac56d3582af
+  data.tar.gz: b791358e41d4aa2db17b5fcd68e0e2aa97af7b4c31d21d9308132e470f07a67c638b53085846006363e2d9d962dba9b5250a9afe358844b113ac4a7c73a4df53

data/CHANGELOG.md

@@ -1,7 +1,16 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
-## [2.0.50] - 2022-02-xx
+## [2.0.51] - 2022-02-27
+
+### Added
+  - `Eco::API::MicroCases#person_update!` launches an update against the Server for one person
+  - `Eco::API::MicroCases#take_email_from_account` with given an account associated to an `email` that we cannot take, it associates that account to a different email
+
+### Changed
+### Fixed
+
+## [2.0.50] - 2022-02-23
 
 ### Added
   - Ability to configure delay between jobs and job groups
@@ -15,8 +24,6 @@ All notable changes to this project will be documented in this file.
 ### Changed
   - `workflow`, when no operation specified it logs as `info`, rather than `warn`
 
-### Fixed
-
 ## [2.0.49] - 2022-02-14
 
 ### Added

data/lib/eco/api/microcases/person_update.rb

@@ -0,0 +1,39 @@
+module Eco
+  module API
+    class MicroCases
+      # It updates an idividual person.
+      # @note if it succeeds the update, it calls `person.consolidate!`
+      # @param person [Ecoportal::API::V1::Person] the person we want to update, carrying the changes to be done.
+      # @param context [String] main part of the message.
+      # @param reason [String] why are we updating now.
+      # @return [Boolean] `true` if it succeded to update, and `false` otherwise
+      def person_update!(person, context: "Session", reason: "")
+        logger.debug("#{context}, going to \"#{reason}\".\nPerson: #{person_ref(person)}")
+        if response = api.people.update(person)
+          if response.success?
+            person.consolidate!
+            true
+          else
+            msg  = "#{context} Error #{response.status}: #{response.body}\n"
+            msg += " -- Failed to \"#{reason}\".\n"
+            msg += "  • Person: #{person_ref(person)}"
+            logger.error(msg)
+            false
+          end
+        else
+          msg  = "#{context} Error (connection error)\n"
+          msg += " -- Failed to \"#{reason}\".\n"
+          msg += "  • Person: #{person_ref(person)}"
+          logger.error(msg)
+          false
+        end
+      end
+
+      private
+
+      def person_ref(person)
+        Eco::API::Session::Batch::Feedback.person_ref(person)
+      end
+    end
+  end
+end

data/lib/eco/api/microcases/take_email_from_account.rb

@@ -0,0 +1,89 @@
+module Eco
+  module API
+    class MicroCases
+      # Frees up `target_email` from an account not present in this org.
+      #   Allows to force `target_email` on the current user's account.
+      #   - If the person does not have account, this case will not do anything.
+      #   - If `original_doc["account"]` is `nil` (no account on server side), this case will not do anything.
+      #   - If the `target_email` and the `current_email` are the same or empty, this case will not do anything.
+      # @note
+      #   - **It does not do the final update to the server to the `target_email`**. You will need to do this part yourself.
+      #   - You would call this function only when you got an error of `email already taken`.
+      #   - If the `target_email` is associated to a user in the same org, this will fail.
+      # @param person [Ecoportal::API::V1::Person] the person we want to update, carrying the changes to be done.
+      # @param dest_email [String, Proc] the email that we will move the other account to, when we free up `target_email`.
+      # @param target_email [String] the email that we want to free up from another account and bring to ours.
+      #   If it's empty, the `person.email` will be used instead.
+      # @param options [Hash] the options.
+      # @param current_email [String] the email that the person's account is currently linked.
+      #   As the current email should be associated with this person's account on server side, we use `original_doc["email"]`.
+      # @param context [String] main core part of logs. Provides context to the logs.
+      def take_email_from_account(person, dest_email:, target_email: nil, options: {}, context: "Session")
+        return false if options.dig(:exclude, :account)
+        return false unless account     = person.account
+        return false unless had_account = person.original_doc["account"]
+
+        target_email  ||= person.email
+        account_email   = person.original_doc["email"]
+
+        return false unless target_email != account_email
+        return false if account_email.to_s.strip.empty?
+        return false if target_email.to_s.strip.empty?
+
+        if dest_email.is_a?(String)
+          return false unless target_email != dest_email
+          return false unless dest_email   != account_email
+          return false if dest_email.to_s.strip.empty?
+        end
+
+        account_json  = JSON.parse(account.to_json)
+        person.email = account_email
+
+        if success = _take_email_remove_account!(person, context: context)
+          if success = _take_email_acquire_account!(person, target_email, account: {}, context: context)
+            if success = _take_email_email_free_up!(person, dest_email: dest_email, context: context)
+              if success = _take_email_remove_account!(person, context: context)
+                if success = _take_email_acquire_account!(person, account_email, account: account_json, context: context)
+                  person.email = target_email
+                end
+              end
+            else # free up target email
+              # restore
+              if _take_email_remove_account!(person, context: context)
+                _take_email_acquire_account!(person, account_email, account: account_json, context: context)
+              end
+              success = false
+            end
+          else # aquire other account
+            # restore
+            _take_email_acquire_account!(person, account_email, account: account_json, context: context)
+            success = false
+          end
+        end
+        success
+      end
+
+      private
+
+      def _take_email_acquire_account!(person, target_email, account: {}, context: "Session")
+        person.account = account
+        person.account.send_invites = false
+        person.email   = target_email
+        micro.person_update!(person, reason: "bring account with email '#{target_email}'", context: context)
+      end
+
+      def _take_email_email_free_up!(person, dest_email:, target_email: nil, context: "Session")
+        target_email ||= person.email
+        person.email   = dest_email.is_a?(Proc)? dest_email.call(target_email) : dest_email
+        reason = "free up email '#{target_email}', by moving account to '#{person.email}'"
+        micro.person_update!(person, reason: reason, context: context)
+      end
+
+      def _take_email_remove_account!(person, context: "Session")
+        person.account = nil
+        micro.person_update!(person, reason: "remove account", context: context)
+      end
+
+    end
+  end
+end

data/lib/eco/api/microcases.rb

@@ -19,6 +19,7 @@ require_relative 'microcases/people_cache'
 require_relative 'microcases/people_load'
 require_relative 'microcases/people_refresh'
 require_relative 'microcases/people_search'
+require_relative 'microcases/person_update'
 require_relative 'microcases/preserve_filter_tags'
 require_relative 'microcases/preserve_default_tag'
 require_relative 'microcases/preserve_policy_groups'
@@ -26,9 +27,10 @@ require_relative 'microcases/set_account'
 require_relative 'microcases/set_core_with_supervisor'
 require_relative 'microcases/set_core'
 require_relative 'microcases/refresh_default_tag'
+require_relative 'microcases/s3upload_targets'
 require_relative 'microcases/set_supervisor'
 require_relative 'microcases/strict_search'
-require_relative 'microcases/s3upload_targets'
+require_relative 'microcases/take_email_from_account'
 require_relative 'microcases/with_each'
 require_relative 'microcases/with_each_leaver'
 require_relative 'microcases/with_each_present'

data/lib/eco/version.rb

@@ -1,3 +1,3 @@
 module Eco
-  VERSION = "2.0.50"
+  VERSION = "2.0.51"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: eco-helpers
 version: !ruby/object:Gem::Version
-  version: 2.0.50
+  version: 2.0.51
 platform: ruby
 authors:
 - Oscar Segura
@@ -462,6 +462,7 @@ files:
 - lib/eco/api/microcases/people_load.rb
 - lib/eco/api/microcases/people_refresh.rb
 - lib/eco/api/microcases/people_search.rb
+- lib/eco/api/microcases/person_update.rb
 - lib/eco/api/microcases/preserve_default_tag.rb
 - lib/eco/api/microcases/preserve_filter_tags.rb
 - lib/eco/api/microcases/preserve_policy_groups.rb
@@ -472,6 +473,7 @@ files:
 - lib/eco/api/microcases/set_core_with_supervisor.rb
 - lib/eco/api/microcases/set_supervisor.rb
 - lib/eco/api/microcases/strict_search.rb
+- lib/eco/api/microcases/take_email_from_account.rb
 - lib/eco/api/microcases/with_each.rb
 - lib/eco/api/microcases/with_each_leaver.rb
 - lib/eco/api/microcases/with_each_present.rb