@cityssm/worktech-api/queries/employees/getEmployeeTimeCodes.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 { TimeCode } from './types.js'

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

/**
 * Retrieves time codes for a specific employee.
 * @param mssqlConfig - SQL Server configuration.
 * @param employeeNumber - The employee number.
 * @param timesheetMaxAgeDays - The maximum age of timesheets to consider.
 * @param bypassCache - Whether to bypass the cache.
 * @returns The time codes for the specified employee.
 */
export async function getEmployeeTimeCodes(
  mssqlConfig: mssql.config,
  employeeNumber: string,
  timesheetMaxAgeDays: number,
  bypassCache = false
): Promise<TimeCode[]> {
  const cacheKey = `${employeeNumber}-${timesheetMaxAgeDays}`

  let timeCodes = bypassCache ? undefined : cache.get(cacheKey)

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

  const pool = await connect(mssqlConfig)

  const result = (await pool
    .request()
    .input('employeeNumber', employeeNumber)
    .input('timesheetMaxAgeDays', timesheetMaxAgeDays)
    .query(/* sql */ `
      SELECT
        TC_ID AS timeCode,
        DESCRIPTION AS timeCodeDescription,
        EXTCODE AS externalCode
      FROM
        WMTCD
      WITH
        (NOLOCK)
      WHERE
        Inactive = 0
        AND AdminOnly = 0
        AND TC_ID IN (
          SELECT
            TC_ID
          FROM
            WMTSI
          WITH
            (nolock)
          WHERE
            transType = 'Time Sheets'
            AND
          TYPE = 'Employee'
          AND Item_ID = @employeeNumber
          AND DateTime >= dateadd(day, -1 * @timesheetMaxAgeDays, getdate())
        )
      ORDER BY
        TC_ID
    `)) as mssql.IResult<TimeCode>

  timeCodes = result.recordset

  cache.set(cacheKey, timeCodes)

  return timeCodes
}