@cityssm/worktech-api/queries/employees/getEmployeePayCodes.ts

Integrations with the WorkTech (Pearl) work order management system.

import NodeCache from '@cacheable/node-cache'
import { type mssql, connect } from '@cityssm/mssql-multi-pool'

import { cacheTimeToLiveSeconds } from '../../apiConfig.js'

import type { EmployeePayCode } from './types.js'

const cache = new NodeCache<EmployeePayCode[]>({
  stdTTL: cacheTimeToLiveSeconds
})

/**
 * Retrieves employee pay codes.
 * @param mssqlConfig - SQL Server configuration.
 * @param employeeNumber - The employee number.
 * @param effectiveDate - The effective date.
 * @returns The employee pay codes.
 */
export async function getEmployeePayCodes(
  mssqlConfig: mssql.config,
  employeeNumber: string,
  effectiveDate?: Date
): Promise<EmployeePayCode[]> {
  const cacheKey = `employeePayCodes-${employeeNumber}-${effectiveDate?.toISOString() ?? 'all'}`

  let employeePayCodes = cache.get(cacheKey)

  if (employeePayCodes !== undefined) {
    return employeePayCodes
  }

  const pool = await connect(mssqlConfig)

  let query = /* sql */ `
    SELECT Item_ID as employeeNumber,
      rtrim(epc.EPCode) as payCode,
      isnull(pc.level, epc.level) as level,
      rtrim(epc.POS_ID) as positionId,
      p.[Desc] as position,
      isnull(pc.effectiveDateTime, epc.effectiveDate) as effectiveDate,
      cast ([Primary] as bit) as isPrimary
    FROM WMEPCI epc WITH (NOLOCK)
    left join WMEPD pc WITH (NOLOCK)
      on epc.EPCode = pc.EPCode
      and (pc.EffectiveDateTime is null or pc.EffectiveDateTime >= epc.EffectiveDate)
      and pc.NotUsedForOverride = 0
    left join WMPOD p WITH (NOLOCK)
      on epc.POS_ID = p.POS_ID
      and p.Status <> 1
      and (p.EndDateTime is null or p.EndDateTime >= epc.EffectiveDate)
    WHERE epc.Item_ID = @employeeNumber
  `

  if (effectiveDate !== undefined) {
    query += ' AND epc.effectiveDate <= @effectiveDate'
  }

  query += ' ORDER BY isPrimary DESC, effectiveDate DESC'

  const result = (await pool
    .request()
    .input('employeeNumber', employeeNumber)
    .input('effectiveDate', effectiveDate)
    .query(query)) as mssql.IResult<EmployeePayCode>

  employeePayCodes = result.recordset

  cache.set(cacheKey, employeePayCodes)

  return employeePayCodes
}