Screen Oracle Recruiting Cloud applications with HireLayer

const HIRELAYER = 'https://hirelayer.co'
const ORACLE = `https://${process.env.ORACLE_HOST}/hcmRestApi/resources/11.13.18.05`
const CANDIDATES = `${ORACLE}/recruitingCandidates`
const apiKey = { 'X-API-Key': process.env.HIRELAYER_API_KEY! }
// Basic auth over SSL here; an OAuth 2.0 bearer token works the same way
const login = `${process.env.ORACLE_USER}:${process.env.ORACLE_PASSWORD}`
const auth = { Authorization: `Basic ${Buffer.from(login).toString('base64')}` }
const get = (url: string) => fetch(url, { headers: auth }).then((r) => r.json())
type Link = { rel: string; name: string; href: string }

export async function screenNewApplications(since: string) {
  // 1. Applications created since the last run (page with offset while hasMore)
  const q = encodeURIComponent(`CreationDate>'${since}'`)
  const { items } = await get(
    `${ORACLE}/recruitingJobApplications?q=${q}&expand=attachments&limit=50`
  )

  for (const app of items) {
    const resume = app.attachments.find(
      (a: { CategoryName: string }) => a.CategoryName === process.env.ORACLE_RESUME_CATEGORY
    )
    if (!resume) continue
    const link = resume.links.find(
      (l: Link) => l.rel === 'enclosure' && l.name === 'FileContents'
    )
    const file = await fetch(link.href, { headers: auth }).then((r) => r.blob())

    // 2. Parse, then score with the criteria saved for the requisition
    const form = new FormData()
    form.append('file', file, resume.FileName)
    const parsed = await fetch(`${HIRELAYER}/api/v3/parser`, {
      method: 'POST', headers: apiKey, body: form, signal: AbortSignal.timeout(150_000),
    }).then((r) => r.json())
    const criteria = await loadCriteria(app.RequisitionNumber)
    const match = await fetch(`${HIRELAYER}/api/v1/matching/job-candidate`, {
      method: 'POST',
      headers: { ...apiKey, '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())

    // 3. Attach the result to the candidate profile
    const finder = `findByPersonId;personId=${app.CandidatePersonId}`
    const { items: [candidate] } = await get(`${CANDIDATES}?finder=${finder}`)
    await fetch(`${CANDIDATES}/${candidate.CandidateNumber}/child/attachments`, {
      method: 'POST',
      headers: { ...auth, 'Content-Type': 'application/json' },
      body: JSON.stringify({
        DatatypeCode: 'FILE',
        CategoryName: 'MISC',
        FileName: `hirelayer-${app.JobApplicationId}.txt`,
        Title: `HireLayer score ${match.score}`,
        FileContents: Buffer.from(`${match.score}\n${match.summary}`).toString('base64'),
      }),
    })
  }
}