Account Settings Mapper (AccountSettingsMapper) Class

Namespace: Cxt.Account.Settings.API.Mapper

Implements: IAccountSettingsMapper

The AccountSettingsMapper class is the concrete implementation of IAccountSettingsMapper. It transforms data from the data access layer format (e.g., List<AccountSettingsPreferencesDto>) into the AccountSettingsResponse model for API output.

Purpose

• Converts a flat list of account preferences (DTOs) into a hierarchical AccountSettingsResponse.
• Groups accounts by ProfileId.
• Maps AccountSettingsPreferencesDto properties to AccountModel properties.
• Assembles the final AccountSettingsResponse, including GCN, business unit, and profiles with their associated accounts.

Dependencies

• Operates directly on input List<AccountSettingsPreferencesDto>.
• Uses models from Investec.AccountSettings.Models NuGet package (e.g., AccountSettingsResponse, AccountSettingsPreferencesDto, AccountModel, AccountSettingsProfileAccountResponse). No explicit constructor dependencies.

Method Implementation

Map To Account Settings Response

public AccountSettingsResponse MapToAccountSettingsResponse(List<AccountSettingsPreferencesDto> clientAccounts)

• Parameters:

  Parameter	Type	Description
  clientAccounts	List<AccountSettingsPreferencesDto>	A list of all account preferences for a client.

• Returns: AccountSettingsResponse - The populated response object.

• Behavior:

  1. Initializes an AccountSettingsResponse and lists for profiles (AccountSettingsProfileAccountResponse) and accounts (AccountModel).
  2. Identifies distinct ProfileId values from clientAccounts.
  3. For each ProfileId:
     • Filters clientAccounts for the current ProfileId.
     • For each DTO in the filtered list, creates and populates an AccountModel:
       • AccountNumber from dto.AccountNumber
       • AccountName from dto.AccountName
       • AccountType from dto.AccountType
       • ProductSegment from dto.ProductSegment
       • BusinessUnit from dto.BusinessUnit
       • AccountHidden (boolean) from dto.AccountHidden == 1 (integer).
     • Adds the AccountModel to a temporary list for the current profile.
     • Creates an AccountSettingsProfileAccountResponse, sets its ProfileId, and assigns the temporary account list to AccountList.
     • Adds this profile response to the main list of profiles.
  4. Constructs the final AccountSettingsResponse:
     • Gcn from clientAccounts.First().GCN.
     • BusinessUnitName from clientAccounts.First().BusinessUnit.
     • ProfileAccounts assigned the main list of profiles.

• Critical Assumption: Assumes clientAccounts is not empty when accessing clientAccounts.First(). An empty list will cause a runtime exception. It also assumes all DTOs share the same GCN and Business Unit.

Key Logic

• Data Transformation: Converts flat DTO lists to nested API response structures.
• Grouping: Organizes accounts under their respective ProfileIds.
• Type Conversion: Handles AccountHidden conversion (integer to boolean).

This mapper is vital for structuring API output according to the AccountSettingsResponse contract.