@cityssm/consigno-cloud-api/utilities.ts

An unofficial wrapper around the ConsignO Cloud API.

import fs from 'node:fs/promises'

/**
 * Reads a file and converts its content to a base64 encoded string.
 * @param filePath - The path to the file to be read.
 * @returns A promise that resolves to the base64 encoded string of the file content.
 * @throws Will throw an error if the file cannot be read.
 */
export async function fileToBase64(filePath: string): Promise<string> {
  // eslint-disable-next-line security/detect-non-literal-fs-filename
  return await fs.readFile(filePath, 'base64')
}

/**
 * Converts a Uint8Array to a base64 string.
 * @param data - The Uint8Array data to convert to a base64 string.
 * @returns The base64 encoded string.
 */
export function uintArrayToBase64(data: Uint8Array): string {
  let binary = ''

  for (const datum of data) {
    binary += String.fromCodePoint(datum)
  }

  return Buffer.from(binary, 'binary').toString('base64')
}

/**
 * Validates a workflow ID.
 * The ID should be a 24-character hexadecimal string.
 * @param workflowId - The ID of the workflow to validate.
 * @returns True if the workflow ID is valid, false otherwise.
 */
export function validateWorkflowId(workflowId: string): boolean {
  return /^[a-f0-9]{24}$/.test(workflowId)
}

export default {
  fileToBase64,
  uintArrayToBase64,
  validateWorkflowId
}