stackone_migration 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 18a239a9855fad756660ec28639ef4f97c6e06a2b716b6f29ecf5066d9dec14e
+  data.tar.gz: 337ad0348278d4ac3da0a92cf193ccb9bd0f5529a5e75d4437367e578d97928f
+SHA512:
+  metadata.gz: 1e366986d794a7d04a20b9fe3c48d05cb27b10400a850aad1b0d2571881da72c9028a54f8d0369902c5b8d9cce42f461e5041533f5485e33337261246fd1203f
+  data.tar.gz: e50856a872ddf66eae142f57bf4ecb6e45a72fc4de9d634c933c2fb3f2b40f68eb04e53e1024824170ecc29b240bff0469b6eb14fc9e30cb8fa4ae3b1d4203c0

data/Gemfile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+group :development, :test do
+  gem 'pry-byebug'
+  gem 'rake', '~> 13.0.1'
+  gem 'rubocop', '~> 1.48.0'
+end
+
+gem 'merge_hris_client', '~> 3.0'
+gem 'stackone_hris_client', '~> 1.1'

data/Gemfile.lock

@@ -0,0 +1,80 @@
+PATH
+  remote: .
+  specs:
+    stackone_migration (1.0.0)
+      merge_hris_client (~> 3.0)
+      stackone_hris_client (~> 1.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    byebug (11.1.3)
+    coderay (1.1.3)
+    diff-lcs (1.5.0)
+    ethon (0.16.0)
+      ffi (>= 1.15.0)
+    ffi (1.15.5)
+    json (2.6.3)
+    merge_hris_client (3.0.0)
+      typhoeus (~> 1.0, >= 1.0.1)
+    method_source (1.0.0)
+    parallel (1.22.1)
+    parser (3.2.1.1)
+      ast (~> 2.4.1)
+    pry (0.14.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-byebug (3.10.1)
+      byebug (~> 11.0)
+      pry (>= 0.13, < 0.15)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.7.0)
+    rexml (3.2.5)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.1)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.4)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
+    rubocop (1.48.1)
+      json (~> 2.3)
+      parallel (~> 1.10)
+      parser (>= 3.2.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.26.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.27.0)
+      parser (>= 3.2.1.0)
+    ruby-progressbar (1.13.0)
+    stackone_hris_client (1.1.0)
+      typhoeus (~> 1.0, >= 1.0.1)
+    typhoeus (1.4.0)
+      ethon (>= 0.9.0)
+    unicode-display_width (2.4.2)
+
+PLATFORMS
+  arm64-darwin-22
+
+DEPENDENCIES
+  merge_hris_client (~> 3.0)
+  pry-byebug
+  rake (~> 13.0.1)
+  rspec (~> 3.6, >= 3.6.0)
+  rubocop (~> 1.48.0)
+  stackone_hris_client (~> 1.1)
+  stackone_migration!
+
+BUNDLED WITH
+   2.4.7

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 StackOne
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,35 @@
+# stackone-migration-ruby
+
+StackOneMigration - the Ruby gem for migration to the StackOne Unified API
+
+## Installation
+
+```shell
+gem install stackone_migration
+```
+
+or add this line to your Gemfile:
+
+```ruby
+gem 'stackone_migration'
+```
+
+## Usage
+
+Load the migration gem:
+
+```ruby
+require 'stackone_migration'
+```
+
+Configure StackOne API key:
+
+```ruby
+StackOneHrisClient.configure do |config|
+  config.api_key_token = 'YOUR API KEY'
+end
+```
+
+## License
+
+Copyright (c) 2023 [StackOne](https://stackone.com). Licensed under the MIT license.

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+
+begin
+  require 'rspec/core/rake_task'
+
+  RSpec::Core::RakeTask.new(:spec)
+  task default: :spec
+rescue LoadError
+  # no rspec available
+end

data/lib/stackone_migration/api/account_token_api.rb

@@ -0,0 +1,19 @@
+require 'cgi'
+
+module MergeHRISClient
+  class AccountTokenApi
+    alias_method :original_account_token_retrieve, :account_token_retrieve
+
+    def account_token_retrieve(public_token, opts = {})
+      return original_account_token_retrieve(public_token, opts) unless StackOneMigration::AccountHelper.stackone_account?(public_token)
+
+      account_data = StackOneHrisClient::AccountsApi.new.accounts_get(public_token)
+        
+      integration_data = MergeHRISClient::AccountIntegration.new(slug: account_data.provider)
+      MergeHRISClient::AccountToken.new(account_token: public_token, integration: integration_data)
+
+    rescue StackOneHrisClient::ApiError
+      raise MergeHRISClient::ApiError
+    end
+  end
+end

data/lib/stackone_migration/api/employees_api.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'cgi'
+
+module MergeHRISClient
+  class EmployeesApi
+    alias_method :original_employees_list, :employees_list
+
+    def employees_list(x_account_id, opts = {})
+      return original_employees_list(x_account_id, opts) unless StackOneMigration::AccountHelper.stackone_account?(x_account_id)
+
+      if opts.key?(:remote_id)
+        stripped_opts = opts.reject { |k, _| k == :remote_id }
+        response = StackOneHrisClient::EmployeesApi.new.employees_get(opts[:remote_id], x_account_id,
+                                                                                      stripped_opts)
+
+        StackOneMigration::EmployeesMapper.map_single_employee_to_list_model(response&.data)
+      else
+        response = StackOneHrisClient::EmployeesApi.new.employees_list(x_account_id, opts)
+
+        StackOneMigration::EmployeesMapper.map_to_paginated_employee_list_model(response)
+      end
+    rescue StackOneHrisClient::ApiError
+      raise MergeHRISClient::ApiError
+    end
+  end
+end

data/lib/stackone_migration/api/link_token_api.rb

@@ -0,0 +1,24 @@
+require 'cgi'
+
+module MergeHRISClient
+  class LinkTokenApi
+    alias_method :original_link_token_create, :link_token_create
+
+    def link_token_create(end_user_details_request, opts = {})
+      return original_link_token_create(end_user_details_request, opts) if opts.key?(:use_merge) && opts[:use_merge]
+      
+      connect_session_create_request = StackOneHrisClient::ConnectSessionCreate.new(
+        :origin_owner_id => end_user_details_request.end_user_origin_id,
+        :origin_owner_name => end_user_details_request.end_user_email_address,
+        :provider => end_user_details_request.integration,
+        :categories => end_user_details_request.categories,
+      )
+
+      created_session = StackOneHrisClient::ConnectSessionsApi.new.connect_sessions_create(connect_session_create_request)
+      MergeHRISClient::LinkToken.new(:link_token => created_session.token, :integration_name => end_user_details_request.integration)
+
+    rescue StackOneHrisClient::ApiError
+      raise MergeHRISClient::ApiError
+    end
+  end
+end

data/lib/stackone_migration/helpers/account_helper.rb

@@ -0,0 +1,11 @@
+module StackOneMigration
+  class AccountHelper
+    def self.stackone_account?(account_id)
+      account_id =~ /\A\d+\Z/
+    end
+
+    def self.merge_account?(account_id)
+      !stackone_account?(account_id)
+    end
+  end
+end

data/lib/stackone_migration/mappers/employees_mapper.rb

@@ -0,0 +1,53 @@
+module StackOneMigration
+  class EmployeesMapper
+    def self.map_to_employee_model(employee)
+      return nil if employee.nil?
+
+      MergeHRISClient::Employee.new(
+        :id => employee.id,
+        :remote_id => employee.id,
+        :first_name => employee.first_name,
+        :last_name => employee.last_name,
+        :display_full_name => employee.display_name,
+        :avatar => employee.avatar_url,
+        :personal_email => employee.personal_email,
+        :work_email => employee.work_email,
+        :mobile_phone_number => employee.personal_phone_number,
+        :gender => employee.gender,
+        :date_of_birth => employee.birth_date,
+        :start_date => employee.start_date,
+        :manager => employee.manager_id,
+      )
+    end
+
+    def self.map_single_employee_to_list_model(employee)
+      mapped_employee = map_to_employee_model(employee)
+
+      mapped_results = mapped_employee.nil? ? [] : [mapped_employee]
+
+      MergeHRISClient::PaginatedEmployeeList.new(
+        :_next => nil,
+        :results => mapped_results,
+        :previous => nil
+      )  
+    end
+
+    def self.map_to_paginated_employee_list_model(paginated_employees)
+      if paginated_employees&.data.nil? 
+        mapped_results = []
+      else 
+        mapped_results = paginated_employees.data.map do |employee|
+          map_to_employee_model(employee)
+        end
+      end
+
+      next_page = paginated_employees.next_page unless paginated_employees.nil?
+
+      MergeHRISClient::PaginatedEmployeeList.new(
+        :_next => next_page,
+        :results => mapped_results,
+        :previous => nil
+      )
+    end
+  end
+end

data/lib/stackone_migration/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module StackOneMigration
+  VERSION = '1.0.0'
+end

data/lib/stackone_migration.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'stackone_hris_client'
+require 'merge_hris_client'
+
+# Common files
+require 'stackone_migration/version'
+
+# APIs
+require 'stackone_migration/api/employees_api'
+require 'stackone_migration/api/account_token_api'
+require 'stackone_migration/api/link_token_api'
+
+# Mappers
+require 'stackone_migration/mappers/employees_mapper'
+
+# Helpers
+require 'stackone_migration/helpers/account_helper'
+
+module StackOneMigration
+  class << self
+    def configure
+      if block_given?
+        yield(Configuration.default)
+      else
+        Configuration.default
+      end
+    end
+  end
+end

data/spec/api/account_token_api_spec.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe MergeHRISClient::AccountTokenApi do
+  subject { MergeHRISClient::AccountTokenApi.new }
+  
+  context '.account_token_retrieve' do
+    context 'when the public token is an account id from StackOne' do
+      it 'returns a merge account token object' do
+        account_data = StackOneHrisClient::Account.new(:id => '12345', :provider => 'stackone_hris_provider')
+        stackone_account_api_double = double('StackOneHrisClient::AccountsApi', :accounts_get => account_data)
+        allow(StackOneHrisClient::AccountsApi).to receive(:new).and_return(stackone_account_api_double)
+
+        result = subject.account_token_retrieve('12345')
+
+        expect(result).to be_a(MergeHRISClient::AccountToken)
+      end
+
+      it 'returns an account token object with the right attributes' do
+        account_data = StackOneHrisClient::Account.new(:id => '12345', :provider => 'stackone_hris_provider')
+        stackone_account_api_double = double('StackOneHrisClient::AccountsApi', :accounts_get => account_data)
+        allow(StackOneHrisClient::AccountsApi).to receive(:new).and_return(stackone_account_api_double)
+
+        result = subject.account_token_retrieve('12345')
+
+        expect(result).to have_attributes(:account_token => '12345', :integration => MergeHRISClient::AccountIntegration.new(:slug => 'stackone_hris_provider'))
+      end
+    end
+  end
+
+  context 'when the public token is from Merge' do
+    it 'calls the method from the Merge api to retrieve the account token' do
+      merge_account_token_api_double = double('MergeHRISClient::AccountTokenApi')
+      allow(MergeHRISClient::AccountTokenApi).to receive(:new).and_return(merge_account_token_api_double)
+      options = { :custom => 'option_value' }
+
+      expect(merge_account_token_api_double).to receive(:account_token_retrieve).with('123abc', options)
+
+      subject.account_token_retrieve('123abc', options)
+    end
+  end
+end

data/spec/api/employees_api_spec.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe MergeHRISClient::EmployeesApi do
+  subject { MergeHRISClient::EmployeesApi.new }
+  
+  context '.employees_list' do
+    context 'when the account id is from StackOne' do
+      it 'calls the method from the StackOne client to list employees' do
+        paginated_employees_double = double('StackOneHrisClient::PaginatedEmployeeList', :data => nil, :next_page => nil)
+        stackone_employees_api_double = double('StackOneHrisClient::EmployeesApi', :employees_list => paginated_employees_double)
+        allow(StackOneHrisClient::EmployeesApi).to receive(:new).and_return(stackone_employees_api_double)
+        options = { :expand => 'employments,home_location' }
+
+        expect(stackone_employees_api_double).to receive(:employees_list).with('123', options)
+
+        subject.employees_list('123', options)
+      end
+
+      context 'and the remote id param is in the options' do
+        it 'calls the method from the StackOne client to get an employee with remote id parameter' do
+          paginated_employees_double = double('StackOneHrisClient::PaginatedEmployeeList', :data => nil)
+          stackone_employees_api_double = double('StackOneHrisClient::EmployeesApi', :employees_get => paginated_employees_double)
+          allow(StackOneHrisClient::EmployeesApi).to receive(:new).and_return(stackone_employees_api_double)
+          options = { :expand => 'employments,home_location', :remote_id => '456' }
+
+          expect(stackone_employees_api_double).to receive(:employees_get).with('456', '123', { :expand => 'employments,home_location' })
+
+          subject.employees_list('123', options)
+        end
+      end
+    end
+  end
+
+  context 'when the account id is from Merge' do
+    it 'calls the method from the Merge client to list employees' do
+      merge_employees_api_double = double('MergeHRISClient::EmployeesApi')
+      allow(MergeHRISClient::EmployeesApi).to receive(:new).and_return(merge_employees_api_double)
+      options = { :custom => 'option_value' }
+
+      expect(merge_employees_api_double).to receive(:employees_list).with('123abc', options)
+
+      subject.employees_list('123abc', options)
+    end
+
+    context 'and the remote id param is in the options' do
+      it 'calls the method from the Merge client to get an employee with remote id parameter' do
+        merge_employees_api_double = double('MergeHRISClient::EmployeesApi')
+        allow(MergeHRISClient::EmployeesApi).to receive(:new).and_return(merge_employees_api_double)
+        options = { :expand => 'employments,home_location', :remote_id => '456' }
+
+        expect(merge_employees_api_double).to receive(:employees_list).with('123abc', { :expand => 'employments,home_location', :remote_id => '456' })
+
+        subject.employees_list('123abc', options)
+      end
+    end
+  end
+end

data/spec/api/link_token_api_spec.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe MergeHRISClient::LinkTokenApi do
+  subject { MergeHRISClient::LinkTokenApi.new }
+  
+  context '.link_token_create' do
+    context 'when the the key to use merge is not present in the options' do
+      it 'returns a merge link token object' do
+        session_data = StackOneHrisClient::ConnectSessionToken.new(:token => 'test_token')
+        connect_sessions_api_double = double('StackOneHrisClient::ConnectSessionsApi', :connect_sessions_create => session_data)
+        allow(StackOneHrisClient::ConnectSessionsApi).to receive(:new).and_return(connect_sessions_api_double)
+
+        end_user_details_request = MergeHRISClient::EndUserDetailsRequest.new(
+          :end_user_email_address => 'tos@potig.er',
+          :end_user_origin_id => 'user_origin_id',
+          :categories => ['hris'],
+          :integration => 'stackone_hris_provider',
+        )
+
+        result = subject.link_token_create(end_user_details_request)
+
+        expect(result).to be_a(MergeHRISClient::LinkToken)
+      end
+
+      it 'returns an object with the right attributes' do
+        session_data = StackOneHrisClient::ConnectSessionToken.new(:token => 'test_token')
+        connect_sessions_api_double = double('StackOneHrisClient::ConnectSessionsApi', :connect_sessions_create => session_data)
+        allow(StackOneHrisClient::ConnectSessionsApi).to receive(:new).and_return(connect_sessions_api_double)
+
+        end_user_details_request = MergeHRISClient::EndUserDetailsRequest.new(
+          :end_user_email_address => 'tos@potig.er',
+          :end_user_origin_id => 'user_origin_id',
+          :categories => ['hris'],
+          :integration => 'stackone_hris_provider',
+        )
+
+        result = subject.link_token_create(end_user_details_request)
+
+        expect(result).to have_attributes(:link_token => 'test_token', :integration_name => 'stackone_hris_provider', :magic_link_url => nil)
+      end
+
+      it 'calls the connect sessions api with the right parameters' do
+        session_data = StackOneHrisClient::ConnectSessionToken.new(:token => 'test_token')
+        connect_sessions_api_double = double('StackOneHrisClient::ConnectSessionsApi', :connect_sessions_create => session_data)
+        allow(StackOneHrisClient::ConnectSessionsApi).to receive(:new).and_return(connect_sessions_api_double)
+
+        end_user_details_request = MergeHRISClient::EndUserDetailsRequest.new(
+          :end_user_email_address => 'tos@potig.er',
+          :end_user_origin_id => 'user_origin_id',
+          :categories => ['hris'],
+          :integration => 'stackone_hris_provider',
+        )
+
+        expected_request = StackOneHrisClient::ConnectSessionCreate.new(
+          :origin_owner_id => 'user_origin_id',
+          :origin_owner_name => 'tos@potig.er',
+          :provider => 'stackone_hris_provider',
+          :categories => ['hris'],
+        )
+
+        expect(connect_sessions_api_double).to receive(:connect_sessions_create).with(expected_request)
+        
+        result = subject.link_token_create(end_user_details_request)
+      end
+    end
+  end
+
+  context 'when the the key to use merge is present in the options' do
+    it 'calls the method from the Merge api to create the link token' do
+      end_user_details_request = MergeHRISClient::EndUserDetailsRequest.new
+      merge_link_token_api_double = double('MergeHRISClient::LinkTokenApi')
+      allow(MergeHRISClient::LinkTokenApi).to receive(:new).and_return(merge_link_token_api_double)
+      options = { :custom => 'option_value', :use_merge => true }
+
+      expect(merge_link_token_api_double).to receive(:link_token_create).with(end_user_details_request, options)
+
+      subject.link_token_create(end_user_details_request, options)
+    end
+  end
+end

data/spec/helpers/account_helper_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe StackOneMigration::AccountHelper do
+  context '.stackone_account?' do
+    context 'when the account identifier is composed only by numbers' do
+      it 'returns true' do
+        result = described_class.stackone_account?('12345')
+
+        expect(result).to be_truthy
+      end
+    end
+
+    context 'when the account identifier is not composed only by numbers' do
+      it 'returns false' do
+        result = described_class.stackone_account?('12345abc')
+
+        expect(result).to be_falsey
+      end
+    end
+  end
+
+  context '.merge_account?' do
+    context 'when the account identifier is not composed only by numbers' do
+      it 'returns true' do
+        result = described_class.merge_account?('12345abc')
+
+        expect(result).to be_truthy
+      end
+    end
+
+    context 'when the account identifier is composed only by numbers' do
+      it 'returns false' do
+        result = described_class.merge_account?('12345')
+
+        expect(result).to be_falsey
+      end
+    end
+  end
+end

data/spec/mappers/employees_mapper_spec.rb

@@ -0,0 +1,199 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe StackOneMigration::EmployeesMapper do
+  let(:sample_employee) { 
+    StackOneHrisClient::Employee.new(
+      :id => '123',
+      :first_name => 'Jean',
+      :last_name => 'Harrington',
+      :display_name => 'Jean Harrington',
+      :name => 'Jean Marie Harrington',
+      :avatar_url => 'https://www.gravatar.com/avatar/0c1c0c1c0c1c0c1c0c1c0c1c0c1c0c1c?d=mm&s=200',
+      :personal_email => 'ija@egje.wf',
+      :work_email => 'kota@efpiphi.kw',
+      :personal_phone_number => '(715) 658-9486',
+      :gender => 'female',
+      :birth_date => '1990-01-01',
+      :start_date => '2018-01-01',
+      :manager_id => '417b5e62-e011-5e69-a906-0aefade9ded1',
+      :work_phone_number => '(456) 787-3508',
+      :title => 'Manager',
+      :department => 'Human Resources',
+    )   
+  }
+  let(:other_sample_employee) { 
+    StackOneHrisClient::Employee.new(
+      :id => '456',
+      :first_name => 'Allie',
+      :last_name => 'Shaw',
+      :display_name => 'Allie Shaw',
+      :name => 'Allie Jennifer Shaw',
+      :avatar_url => 'https://www.gravatar.com/avatar/0c1c0c1c0c1c0c1c0c1c0c1c0c1c0c1c?d=mm&s=200',
+      :personal_email => 'ija@egje.wf',
+      :work_email => 'kota@efpiphi.kw',
+      :personal_phone_number => '(715) 658-9486',
+      :gender => 'female',
+      :birth_date => '1990-01-01',
+      :start_date => '2018-01-01',
+      :manager_id => '417b5e62-e011-5e69-a906-0aefade9ded1',
+      :work_phone_number => '(456) 787-3508',
+      :title => 'Manager',
+      :department => 'Human Resources',
+    )   
+  }
+
+  context '.map_to_employee_model' do
+    it 'maps the employee to the target employee class' do
+      target_model = described_class.map_to_employee_model(sample_employee)
+
+      expect(target_model).to be_a(MergeHRISClient::Employee)
+    end
+
+    it 'maps the employee attributes with the right structure to the target class' do
+      target_model = described_class.map_to_employee_model(sample_employee)
+
+      expect(target_model).to have_attributes(
+        :id => '123',
+        :remote_id => '123',
+        :first_name => 'Jean',
+        :last_name => 'Harrington',
+        :display_full_name => 'Jean Harrington',
+        :avatar => 'https://www.gravatar.com/avatar/0c1c0c1c0c1c0c1c0c1c0c1c0c1c0c1c?d=mm&s=200',
+        :personal_email => 'ija@egje.wf',
+        :work_email => 'kota@efpiphi.kw',
+        :mobile_phone_number => '(715) 658-9486',
+        :gender => 'female',
+        :date_of_birth => '1990-01-01',
+        :start_date => '2018-01-01',
+        :manager => '417b5e62-e011-5e69-a906-0aefade9ded1',
+      )
+    end
+
+    context 'when the employee record to map is nil' do
+      it 'returns nil' do
+        target_model = described_class.map_to_employee_model(nil)
+
+        expect(target_model).to be_nil
+      end
+    end
+  end
+
+  context '.map_single_employee_to_list_model' do
+    it 'maps a single employee to a paginated employee list class' do
+      target_model = described_class.map_single_employee_to_list_model(sample_employee)
+
+      expect(target_model).to be_a(MergeHRISClient::PaginatedEmployeeList)
+    end
+
+    it 'maps a single employee to a paginated employee with the right attributes' do
+      target_model = described_class.map_single_employee_to_list_model(sample_employee)
+
+      expect(target_model).to have_attributes(
+        :_next => nil,
+        :results => [
+          MergeHRISClient::Employee.new(
+            :id => '123',
+            :remote_id => '123',
+            :first_name => 'Jean',
+            :last_name => 'Harrington',
+            :display_full_name => 'Jean Harrington',
+            :avatar => 'https://www.gravatar.com/avatar/0c1c0c1c0c1c0c1c0c1c0c1c0c1c0c1c?d=mm&s=200',
+            :personal_email => 'ija@egje.wf',
+            :work_email => 'kota@efpiphi.kw',
+            :mobile_phone_number => '(715) 658-9486',
+            :gender => 'female',
+            :date_of_birth => '1990-01-01',
+            :start_date => '2018-01-01',
+            :manager => '417b5e62-e011-5e69-a906-0aefade9ded1',
+          )
+        ],
+        :previous => nil)
+    end
+
+    context 'when the single employee record to map is nil' do
+      it 'returns the paginated employee list with empty results' do
+        target_model = described_class.map_single_employee_to_list_model(nil)
+
+        expect(target_model).to have_attributes(
+          :_next => nil,
+          :results => [],
+          :previous => nil)
+      end
+    end
+  end
+
+  context '.map_to_paginated_employee_list_model' do
+    it 'maps the employees to a paginated employee list classl' do
+      other_sample_employee = sample_employee.clone
+
+      stackone_paginated_employees = StackOneHrisClient::EmployeesPaginated.new(
+        :next_page => 'next_page_token',
+        :data => [sample_employee, other_sample_employee],
+      )
+
+      target_model = described_class.map_to_paginated_employee_list_model(stackone_paginated_employees)
+
+      expect(target_model).to be_a(MergeHRISClient::PaginatedEmployeeList)
+    end
+  
+
+    it 'maps the employee list attributes with the right structure to the target class' do
+      stackone_paginated_employees = StackOneHrisClient::EmployeesPaginated.new(
+        :next_page => 'next_page_token',
+        :data => [sample_employee, other_sample_employee],
+      )
+
+      target_model = described_class.map_to_paginated_employee_list_model(stackone_paginated_employees)
+
+      expect(target_model).to have_attributes(
+        :_next => 'next_page_token',
+        :results => [
+          MergeHRISClient::Employee.new(
+            :id => '123',
+            :remote_id => '123',
+            :first_name => 'Jean',
+            :last_name => 'Harrington',
+            :display_full_name => 'Jean Harrington',
+            :avatar => 'https://www.gravatar.com/avatar/0c1c0c1c0c1c0c1c0c1c0c1c0c1c0c1c?d=mm&s=200',
+            :personal_email => 'ija@egje.wf',
+            :work_email => 'kota@efpiphi.kw',
+            :mobile_phone_number => '(715) 658-9486',
+            :gender => 'female',
+            :date_of_birth => '1990-01-01',
+            :start_date => '2018-01-01',
+            :manager => '417b5e62-e011-5e69-a906-0aefade9ded1',
+          ),
+          MergeHRISClient::Employee.new(
+            :id => '456',
+            :remote_id => '456',
+            :first_name => 'Allie',
+            :last_name => 'Shaw',
+            :display_full_name => 'Allie Shaw',
+            :avatar => 'https://www.gravatar.com/avatar/0c1c0c1c0c1c0c1c0c1c0c1c0c1c0c1c?d=mm&s=200',
+            :personal_email => 'ija@egje.wf',
+            :work_email => 'kota@efpiphi.kw',
+            :mobile_phone_number => '(715) 658-9486',
+            :gender => 'female',
+            :date_of_birth => '1990-01-01',
+            :start_date => '2018-01-01',
+            :manager => '417b5e62-e011-5e69-a906-0aefade9ded1',
+          )
+        ],
+        :previous => nil
+      )
+    end
+
+    context 'when the employee list to map is nil' do
+       it 'returns the paginated employee list with empty results' do
+         target_model = described_class.map_to_paginated_employee_list_model(nil)
+
+         expect(target_model).to have_attributes(
+           :_next => nil,
+           :results => [],
+           :previous => nil)
+       end
+     end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+# load the gem
+require 'stackone_migration'
+
+# The following  was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # The settings below are suggested to provide a good initial experience
+  # with RSpec, but feel free to customize to your heart's content.
+  #   # These two settings work together to allow you to limit a spec run
+  #   # to individual examples or groups you care about by tagging them with
+  #   # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  #   # get run.
+  #   config.filter_run :focus
+  #   config.run_all_when_everything_filtered = true
+  #
+  #   # Allows RSpec to persist some state between runs in order to support
+  #   # the `--only-failures` and `--next-failure` CLI options. We recommend
+  #   # you configure your source control system to ignore this file.
+  #   config.example_status_persistence_file_path = "spec/examples.txt"
+  #
+  #   # Limits the available syntax to the non-monkey patched syntax that is
+  #   # recommended. For more details, see:
+  #   #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  #   config.disable_monkey_patching!
+  #
+  #   # This setting enables warnings. It's recommended, but in some cases may
+  #   # be too noisy due to issues in dependencies.
+  #   config.warnings = true
+  #
+  #   # Many RSpec users commonly either run the entire suite or an individual
+  #   # file, and it's useful to allow more verbose output when running an
+  #   # individual spec file.
+  #   if config.files_to_run.one?
+  #     # Use the documentation formatter for detailed output,
+  #     # unless a formatter has already been configured
+  #     # (e.g. via a command-line flag).
+  #     config.default_formatter = 'doc'
+  #   end
+  #
+  #   # Print the 10 slowest examples and example groups at the
+  #   # end of the spec run, to help surface which specs are running
+  #   # particularly slow.
+  #   config.profile_examples = 10
+  #
+  #   # Run specs in random order to surface order dependencies. If you find an
+  #   # order dependency and want to debug it, you can fix the order by providing
+  #   # the seed, which is printed after each run.
+  #   #     --seed 1234
+  #   config.order = :random
+  #
+  #   # Seed global randomization in this process using the `--seed` CLI option.
+  #   # Setting this allows you to use `--seed` to deterministically reproduce
+  #   # test failures related to randomization by passing the same `--seed` value
+  #   # as the one that triggered the failure.
+  #   Kernel.srand config.seed
+end

data/stackone_migration.gemspec

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+require 'stackone_migration/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'stackone_migration'
+  s.version     = StackOneMigration::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['StackOne']
+  s.email       = ['developer-support@stackone.comm']
+  s.homepage    = 'https://stackone.com'
+  s.summary     = 'StackOne migration client gem'
+  s.description = 'StackOne Unified API client for systems migration'
+  s.license     = 'MIT'
+  s.required_ruby_version = '>= 2.7'
+
+  s.add_runtime_dependency 'merge_hris_client', '~> 3.0'
+  s.add_runtime_dependency 'stackone_hris_client', '~> 1.1'
+
+  s.add_development_dependency 'rspec', '~> 3.6', '>= 3.6.0'
+
+  s.files         = `find *`.split("\n").uniq.sort.reject(&:empty?)
+  s.test_files    = `find spec/*`.split("\n")
+  s.executables   = []
+  s.require_paths = ['lib']
+end

metadata

@@ -0,0 +1,116 @@
+--- !ruby/object:Gem::Specification
+name: stackone_migration
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- StackOne
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-03-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: merge_hris_client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: stackone_hris_client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.6.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.6.0
+description: StackOne Unified API client for systems migration
+email:
+- developer-support@stackone.comm
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- lib/stackone_migration.rb
+- lib/stackone_migration/api/account_token_api.rb
+- lib/stackone_migration/api/employees_api.rb
+- lib/stackone_migration/api/link_token_api.rb
+- lib/stackone_migration/helpers/account_helper.rb
+- lib/stackone_migration/mappers/employees_mapper.rb
+- lib/stackone_migration/version.rb
+- spec/api/account_token_api_spec.rb
+- spec/api/employees_api_spec.rb
+- spec/api/link_token_api_spec.rb
+- spec/helpers/account_helper_spec.rb
+- spec/mappers/employees_mapper_spec.rb
+- spec/spec_helper.rb
+- stackone_migration.gemspec
+homepage: https://stackone.com
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.6
+signing_key:
+specification_version: 4
+summary: StackOne migration client gem
+test_files:
+- spec/api/employees_api_spec.rb
+- spec/api/account_token_api_spec.rb
+- spec/api/link_token_api_spec.rb
+- spec/helpers/account_helper_spec.rb
+- spec/mappers/employees_mapper_spec.rb
+- spec/spec_helper.rb