Update UserInfoApiClient to allow user lookup by email.

This change adds a search_by_email method to allow lookup of users by
email address to acquire the ID of proposed school owners.

Author: fspeirs

lib/user_info_api_client.rb

@@ -18,14 +18,34 @@ def fetch_by_ids(user_ids)
       transform_result(response.body.fetch('users', []))
     end
 
+    def search_by_email(email)
+      return [] if email.blank?
+      return stubbed_users_by_email(email) if bypass_oauth?
+
+      response = conn.get do |r|
+        r.url "/users/#{email}"
+      end
+      return [] if response.body.blank?
+
+      # Single user response has 'user' key, not 'users'
+      user = response.body.fetch('user', nil)
+      user.present? ? [transform_user(user)] : []
+    rescue Faraday::ResourceNotFound
+      []
+    end
+
     private
 
     def bypass_oauth?
       ENV.fetch('BYPASS_OAUTH', nil) == 'true'
     end
 
+    def transform_user(user)
+      user.transform_keys { |k| k.to_s.underscore.to_sym }
+    end
+
     def transform_result(result)
-      { result: }.transform_keys { |k| k.to_s.underscore.to_sym }.fetch(:result)
+      result.map { |user| transform_user(user) }
     end
 
     def conn
@@ -62,5 +82,26 @@ def stubbed_users(user_ids)
         }
       end
     end
+
+    def stubbed_users_by_email(email)
+      [{
+        id: SecureRandom.uuid,
+        email: email,
+        username: nil,
+        parentalEmail: nil,
+        name: 'School Owner',
+        nickname: 'Owner',
+        country: 'United Kingdom',
+        country_code: 'GB',
+        postcode: nil,
+        dateOfBirth: nil,
+        verifiedAt: '2024-01-01T12:00:00.000Z',
+        createdAt: '2024-01-01T12:00:00.000Z',
+        updatedAt: '2024-01-01T12:00:00.000Z',
+        discardedAt: nil,
+        lastLoggedInAt: '2024-01-01T12:00:00.000Z',
+        roles: ''
+      }]
+    end
   end
 end