Find By ID

# spec.yml
name: Collection Name
methods:
  findById:
    parametersSchema:
      type: object
      properties:
        includeRelated:
          type: boolean
          default: false
          description: Include related records

path: /contacts/{id}
method: GET
requestMapping:
  pathParameters:
    id: { $var: $.id }
  query:
    expand: |
      {
        $cond: [
          { $var: $.parameters.includeRelated },
          "relationships",
          null
        ]
      }
responseMapping:
  record: { $var: response.data }

implementationType: operation-mapping
mapping:
  operationKey: getContact
  inputMapping:
    contactId: { $var: $.id }
    options:
      includeRelated: { $var: $.parameters.includeRelated }
  outputMapping:
    record: { $var: result.contact }

export default async function findById({ apiClient, id, parameters }) {
  try {
    const queryParams = {}

    if (parameters?.includeRelated) {
      queryParams.expand = 'relationships'
    }

    const responseData = await apiClient.get(`/contacts/${id}`, {
      params: queryParams,
    })

    return {
      record: responseData.record,
    }
  } catch (error) {
    if (error.response?.status === 404) {
      return {
        record: null,
      }
    }
    throw error
  }
}