@cityssm/worktech-api/queries/workOrders/addWorkOrderResource.ts

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

// eslint-disable-next-line @eslint-community/eslint-comments/disable-enable-pair
/* eslint-disable @cspell/spellchecker */

import { connect, type mssql } from '@cityssm/mssql-multi-pool'
import { dateToString, dateToTimeString } from '@cityssm/utils-datetime'

import { lockTable } from '../../helpers/lockTable.js'
import { getItemByItemId } from '../items/getItems.js'
import { getLastSystemId, incrementLastSystemId } from '../systemId.js'
import type { BigIntString } from '../types.js'

import { getWorkOrderByWorkOrderNumber } from './getWorkOrders.js'
import type { WorkOrderResource } from './types.js'

export interface AddWorkOrderResource extends Partial<WorkOrderResource> {
  workOrderNumber: string
  itemId: string
}

/**
 * Adds a resource to a work order.
 * @param mssqlConfig - SQL Server configuration.
 * @param workOrderResource - The work order resource fields.
 * @returns - The system id for the new resource record.
 */
export async function addWorkOrderResource(
  mssqlConfig: mssql.config,
  workOrderResource: AddWorkOrderResource
): Promise<BigIntString> {
  /*
   * Get Work Order Id
   */

  let serviceRequestSystemId = workOrderResource.serviceRequestSystemId

  const workOrder = await getWorkOrderByWorkOrderNumber(
    mssqlConfig,
    workOrderResource.workOrderNumber
  )

  if (workOrder === undefined) {
    throw new Error(
      `Work Order not found: ${workOrderResource.workOrderNumber}`
    )
  }

  if (serviceRequestSystemId === undefined) {
    serviceRequestSystemId = workOrder.serviceRequestSystemId
  }

  /*
   * Get Item Id
   */

  let itemSystemId = workOrderResource.itemSystemId

  const item = await getItemByItemId(mssqlConfig, workOrderResource.itemId)

  if (item === undefined) {
    throw new Error(`Item not found: ${workOrderResource.itemId}`)
  }

  if (itemSystemId === undefined) {
    itemSystemId = item.itemSystemId
  }

  /*
   * Calculate dates
   */

  const startDate = workOrderResource.startDateTime ?? new Date()
  const startDateTimeString = `${dateToString(startDate)} ${dateToTimeString(
    startDate
  )}`

  const endDateTimeString =
    workOrderResource.endDateTime === undefined
      ? null
      : `${dateToString(workOrderResource.endDateTime)} ${dateToTimeString(
          workOrderResource.endDateTime
        )}`

  /*
   * Calculate base amount
   */

  const quantity = workOrderResource.quantity ?? 0
  const unitPrice = workOrderResource.unitPrice ?? item.unitCost
  const baseAmount = workOrderResource.baseAmount ?? quantity * unitPrice

  /*
   * Do the transaction
   */

  const pool = await connect(mssqlConfig)

  const transaction = pool.transaction()

  try {
    await transaction.begin()

    await lockTable(transaction, 'AMSRI')

    const lastSystemId = await getLastSystemId(transaction)

    if (lastSystemId === undefined) {
      throw new Error('Last used system id is unavailable.')
    }

    const serviceRequestItemSystemId = (
      Number.parseInt(lastSystemId, 10) + 1
    ).toString() as BigIntString

    await transaction
      .request()
      .input('serviceRequestItemSystemId', serviceRequestItemSystemId)
      .input('serviceRequestSystemId', serviceRequestSystemId)
      .input('startDateTime', startDateTimeString)
      .input('itemSystemId', itemSystemId)
      .input('itemId', workOrderResource.itemId)
      .input('quantity', quantity)
      .input('unitPrice', unitPrice)
      .input('baseAmount', baseAmount)
      .input('lockUnitPrice', workOrderResource.lockUnitPrice ?? 0)
      .input('lockMargin', workOrderResource.lockMargin ?? 0)
      .input('workOrderNumber', workOrderResource.workOrderNumber)
      .input(
        'workDescription',
        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
        workOrderResource.workDescription ?? item.itemDescription ?? ''
      )
      .input('endDateTime', endDateTimeString)
      .input('step', workOrderResource.step ?? '').query(`INSERT INTO AMSRI (
        SRISYSID, SRQISYSID,
        PPSYSID, PROJ_ID, P_ID, PMD_TASK, WORKSOURCE,
        SCHEDDATETIME,
        ITMSYSID,
        ITEM_ID,
        QTY,
        UNITPRICE,
        AMT,
        LOCKEST, LOCMARGIN,
        WONOS,
        SYSID,
        WORKDESC,
        ENDDATETIME,
        STEP,
        ACTV_ID, RPTCODE, DONE,
        OVERHEAD_PER, OVERHEAD_AMT,
        TAXCODE, MOD_USER,
        WOPRIMARY,
        DIM1, DIM2, DIM3,
        TSISYSID,
        LOCKSCHEDDATE, KIT_ID, LOCKKIT,
        REASONFORCHANGE,
        EXTAX1, EXTAX2, EXPAYABLE,
        MULT, QTY2,
        ACTAMT,
        EXT_ID, ASSIGNTO,
        ACTQTY, PROCESSEDQTY,
        SRAISYSID, OBJCODE, LOCATION)
      VALUES (
        @serviceRequestItemSystemId,
        @serviceRequestSystemId,
        0, '', 0, '', '',
        @startDateTime,
        @itemSystemId,
        @itemId,
        @quantity,
        @unitPrice,
        @baseAmount,
        @lockUnitPrice, @lockMargin,
        @workOrderNumber,
        0,
        @workDescription,
        @endDateTime,
        @step,
        '', '', 0,
        0.00, 0.00,
        '', '',
        0,
        0.00, 0.00, 0.00,
        0,
        0, '', 0,
        '',
        0.00, 0.00, 0.00,
        0.00, 1.00,
        0.00,
        '', '',
        0.00, 0.00,
        0, '', '')`)

    await incrementLastSystemId(transaction)

    await transaction.commit()

    return serviceRequestItemSystemId
  } catch (error) {
    await transaction.rollback()
    throw error as Error
  }
}