Screen Teamtailor applications with HireLayer

const TT = 'https://api.teamtailor.com/v1'
const HIRELAYER = 'https://hirelayer.co'
const headers = { 'X-API-Key': process.env.HIRELAYER_API_KEY! }
const tt = {
  Authorization: `Token token=${process.env.TEAMTAILOR_API_KEY}`,
  'X-Api-Version': '20240904',
  'Content-Type': 'application/vnd.api+json',
}
const get = (url: string) => fetch(url, { headers: tt }).then((r) => r.json())

type Application = { id: string; relationships: Record<'candidate' | 'job', { data: { id: string } }> }

// Run every few minutes; since = ISO time of the previous run
export async function poll(since: string) {
  let url = `${TT}/job-applications?filter[created-at][from]=${encodeURIComponent(since)}&include=candidate,job`
  while (url) {
    const page = await get(url)
    for (const application of page.data) await screen(application)
    url = page.links?.next
  }
}

async function screen(application: Application) {
  const candidateId = application.relationships.candidate.data.id
  // The resume link is signed for 30 seconds: fetch the candidate, download at once
  const candidate = await get(`${TT}/candidates/${candidateId}`)
  const resumeUrl = candidate.data.attributes.resume // PDF version
  if (!resumeUrl) return
  const form = new FormData()
  form.append('file', await fetch(resumeUrl).then((r) => r.blob()), 'resume.pdf')
  form.append('application_id', application.id)
  const parsed = await fetch(`${HIRELAYER}/api/v3/parser`, {
    method: 'POST', headers, body: form, signal: AbortSignal.timeout(150_000),
  }).then((r) => r.json())

  // Score with the criteria stored for this job
  const criteria = await loadCriteria(application.relationships.job.data.id)
  const match = await fetch(`${HIRELAYER}/api/v1/matching/job-candidate`, {
    method: 'POST',
    headers: { ...headers, 'Content-Type': 'application/json' },
    body: JSON.stringify({
      job_text: criteria.jobText,
      candidate_text: parsed.info_resume.text,
      matching_criteria: criteria.items,
    }),
  }).then((r) => r.json())

  // A note, shown as a comment on the candidate
  await fetch(`${TT}/notes`, {
    method: 'POST', headers: tt,
    body: JSON.stringify({ data: {
      type: 'notes',
      attributes: { note: `HireLayer score: ${Math.round(match.score * 100)}/100\n${match.summary}` },
      relationships: {
        candidate: { data: { type: 'candidates', id: candidateId } },
        user: { data: { type: 'users', id: process.env.TEAMTAILOR_USER_ID } },
      },
    } }),
  })
}