wrap exceptions thrown in profile.map calls

src/createMapper.ts

@@ -1,4 +1,5 @@
 import { Mapper, Profile, ProfileKey, RegisteredProfile, RegisteredProfiles, ProfileNotFoundError } from '@/types'
+import { ProfileMappingError } from '@/types/profileMappingError'
 import { asArray } from '@/utilities'
 
 export function createMapper(): Mapper<RegisteredProfiles> {
@@ -41,7 +42,11 @@ export function createMapper(): Mapper<RegisteredProfiles> {
   const map: Mapper<RegisteredProfiles>['map'] = (sourceKey, source, destinationKey) => {
     const profile = getProfile(sourceKey, destinationKey)
 
-    return profile.map(source)
+    try {
+      return profile.map(source)
+    } catch (exception) {
+      throw new ProfileMappingError(profile, { cause: exception })
+    }
   }
 
   const mapMany: Mapper<RegisteredProfiles>['mapMany'] = (sourceKey, sourceArray, destinationKey) => {

src/createmapper.spec.ts

@@ -1,6 +1,7 @@
 import { expect, test } from 'vitest'
 import mapper from '@/index'
 import { Profile } from '@/types'
+import { ProfileMappingError } from '@/types/profileMappingError'
 
 const stringToBoolean = {
   sourceKey: 'string',
@@ -32,4 +33,20 @@ test('register works with single profile', () => {
   mapper.register(singleProfile)
 
   expect(mapper.has('foo', 'bar')).toBe(true)
+})
+
+test('when map function throws exception, wraps in ProfileMappingError', () => {
+  const singleProfile = {
+    sourceKey: 'foo',
+    destinationKey: 'bar',
+    map: () => {
+      throw 'not implemented'
+    },
+  } as const satisfies Profile
+
+  mapper.register(singleProfile)
+
+  const action: () => void = () => mapper.map('foo', null, 'bar')
+
+  expect(action).toThrow(ProfileMappingError)
 })

src/types/profileMappingError.ts

@@ -0,0 +1,7 @@
+import { Profile } from '@/types/profile'
+
+export class ProfileMappingError extends Error {
+  public constructor(profile: Profile, options?: ErrorOptions) {
+    super(`Failed to Execute map for source "${profile.sourceKey}" and destination "${profile.destinationKey}"`, options)
+  }
+}