@naturalcycles/nodejs-lib/src/validation/joi/joi.validation.util.ts

Standard library for Node.js

/*
 * Does 2 things:
 * 1. Validates the value according to Schema passed.
 * 2. Converts the value (also according to Schema).
 *
 * "Converts" mean e.g trims all strings from leading/trailing spaces.
 */

import { ValidationError, ValidationOptions } from '@hapi/joi'
import { isObject } from '@naturalcycles/js-lib'
import { Joi } from './joi.extensions'
import { AnySchemaTyped } from './joi.model'
import { JoiValidationError } from './joi.validation.error'

export interface JoiValidationResult<T = any> {
  value: T
  error?: JoiValidationError
}

// Strip colors in production (for e.g Sentry reporting)
const stripColors = process.env.NODE_ENV === 'production'

const defaultOptions: ValidationOptions = {
  abortEarly: false,
  convert: true,
  allowUnknown: true,
  stripUnknown: {
    objects: true,
    // true: it will SILENTLY strip invalid values from arrays. Very dangerous! Can lead to data loss!
    // false: it will THROW validation error if any of array items is invalid
    // Q: is it invalid if it has unknown properties?
    // A: no, unknown properties are just stripped (in both 'false' and 'true' states), array is still valid
    // Q: will it strip or keep unknown properties in array items?..
    // A: strip
    arrays: false, // let's be very careful with that! https://github.com/hapijs/joi/issues/658
  },
  presence: 'required',
}

/**
 * Validates with Joi.
 * Throws AppValidationError if invalid.
 * Returns *converted* value.
 *
 * If `schema` is undefined - returns value as is.
 */
export function validate<IN, OUT = IN>(
  value: IN,
  schema?: AnySchemaTyped<IN, OUT>,
  objectName?: string,
  options: ValidationOptions = {},
): OUT {
  const { value: returnValue, error } = getValidationResult<IN, OUT>(
    value,
    schema,
    objectName,
    options,
  )

  if (error) {
    throw error
  }

  return returnValue
}

/**
 * Validates with Joi.
 * Returns ValidationResult with converted value and error (if any).
 * Does not throw.
 *
 * If `schema` is undefined - returns value as is.
 */
export function getValidationResult<IN, OUT = IN>(
  value: IN,
  schema?: AnySchemaTyped<IN, OUT>,
  objectName?: string,
  options: ValidationOptions = {},
): JoiValidationResult<OUT> {
  if (!schema) return { value } as any

  const { value: returnValue, error } = Joi.validate(value, schema, {
    ...defaultOptions,
    ...options,
  })

  const vr: JoiValidationResult<OUT> = {
    value: (returnValue as any) as OUT,
  }

  if (error) {
    vr.error = createError(value, error, objectName)
  }

  return vr
}

/**
 * Convenience function that returns true if !error.
 */
export function isValid<IN, OUT = IN>(value: IN, schema?: AnySchemaTyped<IN, OUT>): boolean {
  if (!schema) return { value } as any

  const { error } = Joi.validate(value, schema, defaultOptions)
  return !error
}

export function undefinedIfInvalid<IN, OUT = IN>(
  value: IN,
  schema?: AnySchemaTyped<IN, OUT>,
): OUT | undefined {
  if (!schema) return { value } as any

  const { value: returnValue, error } = Joi.validate(value, schema, defaultOptions)

  return error ? undefined : (returnValue as any)
}

/**
 * Will do joi-convertation, regardless of error/validity of value.
 * @returns converted value
 */
export function convert<IN, OUT = IN>(value: IN, schema?: AnySchemaTyped<IN, OUT>): OUT {
  if (!schema) return value as any
  const { value: returnValue } = Joi.validate(value, schema, defaultOptions)
  return returnValue as any
}

function createError(value: any, err: ValidationError, objectName?: string): JoiValidationError {
  if (!err) return undefined as any
  const tokens: string[] = []

  const objectId = isObject(value) ? (value['id'] as string) : undefined

  if (objectId || objectName) {
    objectName = objectName || (value && value.constructor && value.constructor.name)

    tokens.push([objectName, objectId].filter(i => i).join('.'))
  }

  const annotation: string = (err.annotate as any)(stripColors) // typings are not up-to-date, hence "as any"

  if (annotation.length > 1000) {
    // Annotation message is too big and will be replaced by stringified `error.details` instead
    tokens.push(
      annotation.substr(0, 1000),
      `... ${Math.ceil(annotation.length / 1024)} KB message truncated`,
    )

    // Up to 5 `details`
    tokens.push(...err.details.slice(0, 5).map(i => `${i.message} @ .${i.path.join('.')}`))

    if (err.details.length > 5) tokens.push(`... ${err.details.length} errors`)
  } else {
    tokens.push(annotation)
  }

  const msg = tokens.join('\n')

  return new JoiValidationError(msg, {
    joiValidationErrorItems: err.details,
    ...(objectName && { joiValidationObjectName: objectName }),
    ...(objectId && { joiValidationObjectId: objectId }),
  })
}