agentsqripts/lib/utils/testUtils.js

Comprehensive static code analysis toolkit for identifying technical debt, security vulnerabilities, performance issues, and code quality problems

/**
 * @file Simple testing utilities for AgentSqripts test suite
 * @description Single responsibility: Provide basic assertion and testing utilities
 */

/**
 * Simple assertion function for tests
 * @param {boolean} condition - Condition to test
 * @param {string} message - Error message if assertion fails
 * @throws {Error} If condition is false
 */
function assert(condition, message = 'Assertion failed') {
  if (!condition) {
    throw new Error(message);
  }
}

/**
 * Assert that two values are equal
 * @param {*} actual - Actual value
 * @param {*} expected - Expected value
 * @param {string} message - Optional error message
 */
function assertEqual(actual, expected, message) {
  const msg = message || `Expected ${expected}, but got ${actual}`;
  assert(actual === expected, msg);
}

/**
 * Assert that a value is truthy
 * @param {*} value - Value to test
 * @param {string} message - Optional error message
 */
function assertTruthy(value, message) {
  const msg = message || `Expected truthy value, but got ${value}`;
  assert(!!value, msg);
}

/**
 * Assert that a value is falsy
 * @param {*} value - Value to test
 * @param {string} message - Optional error message
 */
function assertFalsy(value, message) {
  const msg = message || `Expected falsy value, but got ${value}`;
  assert(!value, msg);
}

module.exports = {
  assert,
  assertEqual,
  assertTruthy,
  assertFalsy
};