"use strict";

/*
 * Error handling utility functions for the RSpade framework.
 * These functions handle error creation and debugging utilities.
 */

// ============================================================================
// ERROR HANDLING
// ============================================================================

/**
 * Creates an error object from a string
 * @param {string|Object} str - Error message or existing error object
 * @param {number} [error_code] - Optional error status code
 * @returns {Object} Error object with error and status properties
 */
function error(str, error_code) {
  if (typeof str.error != undef) {
    return str;
  } else {
    if (typeof error_code == undef) {
      return {
        error: str,
        status: null
      };
    } else {
      return {
        error: str,
        status: error_code
      };
    }
  }
}

/**
 * Sanity check failure handler for JavaScript
 *
 * This function should be called when a sanity check fails - i.e., when the code
 * encounters a condition that "shouldn't happen" if everything is working correctly.
 *
 * Unlike PHP, we can't stop JavaScript execution, but we can:
 * 1. Throw an error that will be caught by error handlers
 * 2. Log a clear error to the console
 * 3. Provide stack trace for debugging
 *
 * Use this instead of silently returning or continuing when encountering unexpected conditions.
 *
 * @param {string} message Optional specific message about what shouldn't have happened
 * @throws {Error} Always throws with location and context information
 */
function shouldnt_happen() {
  let message = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
  const error = new Error();
  const stack = error.stack || '';
  const stackLines = stack.split('\n');

  // Get the caller location (skip the Error line and this function)
  let callerInfo = 'unknown location';
  if (stackLines.length > 2) {
    const callerLine = stackLines[2] || stackLines[1] || '';
    // Extract file and line number from stack trace
    const match = callerLine.match(/at\s+.*?\s+\((.*?):(\d+):(\d+)\)/) || callerLine.match(/at\s+(.*?):(\d+):(\d+)/);
    if (match) {
      callerInfo = `${match[1]}:${match[2]}`;
    }
  }
  let errorMessage = `Fatal: shouldnt_happen() was called at ${callerInfo}\n`;
  errorMessage += 'This indicates a sanity check failed - the code is not behaving as expected.\n';
  if (message) {
    errorMessage += `Details: ${message}\n`;
  }
  errorMessage += 'Please thoroughly review the related code to determine why this error occurred.';

  // Log to console with full visibility
  console.error('='.repeat(80));
  console.error('SANITY CHECK FAILURE');
  console.error('='.repeat(80));
  console.error(errorMessage);
  console.error('Stack trace:', stack);
  console.error('='.repeat(80));

  // Throw error to stop execution flow
  const fatalError = new Error(errorMessage);
  fatalError.name = 'SanityCheckFailure';
  throw fatalError;
}
//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJlcnJvciIsInN0ciIsImVycm9yX2NvZGUiLCJ1bmRlZiIsInN0YXR1cyIsInNob3VsZG50X2hhcHBlbiIsIm1lc3NhZ2UiLCJhcmd1bWVudHMiLCJsZW5ndGgiLCJ1bmRlZmluZWQiLCJFcnJvciIsInN0YWNrIiwic3RhY2tMaW5lcyIsInNwbGl0IiwiY2FsbGVySW5mbyIsImNhbGxlckxpbmUiLCJtYXRjaCIsImVycm9yTWVzc2FnZSIsImNvbnNvbGUiLCJyZXBlYXQiLCJmYXRhbEVycm9yIiwibmFtZSJdLCJzb3VyY2VzIjpbImFwcC9SU3BhZGUvQ29yZS9Kcy9lcnJvci5qcyJdLCJzb3VyY2VzQ29udGVudCI6WyIvKlxuICogRXJyb3IgaGFuZGxpbmcgdXRpbGl0eSBmdW5jdGlvbnMgZm9yIHRoZSBSU3BhZGUgZnJhbWV3b3JrLlxuICogVGhlc2UgZnVuY3Rpb25zIGhhbmRsZSBlcnJvciBjcmVhdGlvbiBhbmQgZGVidWdnaW5nIHV0aWxpdGllcy5cbiAqL1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBFUlJPUiBIQU5ETElOR1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG4vKipcbiAqIENyZWF0ZXMgYW4gZXJyb3Igb2JqZWN0IGZyb20gYSBzdHJpbmdcbiAqIEBwYXJhbSB7c3RyaW5nfE9iamVjdH0gc3RyIC0gRXJyb3IgbWVzc2FnZSBvciBleGlzdGluZyBlcnJvciBvYmplY3RcbiAqIEBwYXJhbSB7bnVtYmVyfSBbZXJyb3JfY29kZV0gLSBPcHRpb25hbCBlcnJvciBzdGF0dXMgY29kZVxuICogQHJldHVybnMge09iamVjdH0gRXJyb3Igb2JqZWN0IHdpdGggZXJyb3IgYW5kIHN0YXR1cyBwcm9wZXJ0aWVzXG4gKi9cbmZ1bmN0aW9uIGVycm9yKHN0ciwgZXJyb3JfY29kZSkge1xuICAgIGlmICh0eXBlb2Ygc3RyLmVycm9yICE9IHVuZGVmKSB7XG4gICAgICAgIHJldHVybiBzdHI7XG4gICAgfSBlbHNlIHtcbiAgICAgICAgaWYgKHR5cGVvZiBlcnJvcl9jb2RlID09IHVuZGVmKSB7XG4gICAgICAgICAgICByZXR1cm4geyBlcnJvcjogc3RyLCBzdGF0dXM6IG51bGwgfTtcbiAgICAgICAgfSBlbHNlIHtcbiAgICAgICAgICAgIHJldHVybiB7IGVycm9yOiBzdHIsIHN0YXR1czogZXJyb3JfY29kZSB9O1xuICAgICAgICB9XG4gICAgfVxufVxuXG4vKipcbiAqIFNhbml0eSBjaGVjayBmYWlsdXJlIGhhbmRsZXIgZm9yIEphdmFTY3JpcHRcbiAqXG4gKiBUaGlzIGZ1bmN0aW9uIHNob3VsZCBiZSBjYWxsZWQgd2hlbiBhIHNhbml0eSBjaGVjayBmYWlscyAtIGkuZS4sIHdoZW4gdGhlIGNvZGVcbiAqIGVuY291bnRlcnMgYSBjb25kaXRpb24gdGhhdCBcInNob3VsZG4ndCBoYXBwZW5cIiBpZiBldmVyeXRoaW5nIGlzIHdvcmtpbmcgY29ycmVjdGx5LlxuICpcbiAqIFVubGlrZSBQSFAsIHdlIGNhbid0IHN0b3AgSmF2YVNjcmlwdCBleGVjdXRpb24sIGJ1dCB3ZSBjYW46XG4gKiAxLiBUaHJvdyBhbiBlcnJvciB0aGF0IHdpbGwgYmUgY2F1Z2h0IGJ5IGVycm9yIGhhbmRsZXJzXG4gKiAyLiBMb2cgYSBjbGVhciBlcnJvciB0byB0aGUgY29uc29sZVxuICogMy4gUHJvdmlkZSBzdGFjayB0cmFjZSBmb3IgZGVidWdnaW5nXG4gKlxuICogVXNlIHRoaXMgaW5zdGVhZCBvZiBzaWxlbnRseSByZXR1cm5pbmcgb3IgY29udGludWluZyB3aGVuIGVuY291bnRlcmluZyB1bmV4cGVjdGVkIGNvbmRpdGlvbnMuXG4gKlxuICogQHBhcmFtIHtzdHJpbmd9IG1lc3NhZ2UgT3B0aW9uYWwgc3BlY2lmaWMgbWVzc2FnZSBhYm91dCB3aGF0IHNob3VsZG4ndCBoYXZlIGhhcHBlbmVkXG4gKiBAdGhyb3dzIHtFcnJvcn0gQWx3YXlzIHRocm93cyB3aXRoIGxvY2F0aW9uIGFuZCBjb250ZXh0IGluZm9ybWF0aW9uXG4gKi9cbmZ1bmN0aW9uIHNob3VsZG50X2hhcHBlbihtZXNzYWdlID0gbnVsbCkge1xuICAgIGNvbnN0IGVycm9yID0gbmV3IEVycm9yKCk7XG4gICAgY29uc3Qgc3RhY2sgPSBlcnJvci5zdGFjayB8fCAnJztcbiAgICBjb25zdCBzdGFja0xpbmVzID0gc3RhY2suc3BsaXQoJ1xcbicpO1xuXG4gICAgLy8gR2V0IHRoZSBjYWxsZXIgbG9jYXRpb24gKHNraXAgdGhlIEVycm9yIGxpbmUgYW5kIHRoaXMgZnVuY3Rpb24pXG4gICAgbGV0IGNhbGxlckluZm8gPSAndW5rbm93biBsb2NhdGlvbic7XG4gICAgaWYgKHN0YWNrTGluZXMubGVuZ3RoID4gMikge1xuICAgICAgICBjb25zdCBjYWxsZXJMaW5lID0gc3RhY2tMaW5lc1syXSB8fCBzdGFja0xpbmVzWzFdIHx8ICcnO1xuICAgICAgICAvLyBFeHRyYWN0IGZpbGUgYW5kIGxpbmUgbnVtYmVyIGZyb20gc3RhY2sgdHJhY2VcbiAgICAgICAgY29uc3QgbWF0Y2ggPSBjYWxsZXJMaW5lLm1hdGNoKC9hdFxccysuKj9cXHMrXFwoKC4qPyk6KFxcZCspOihcXGQrKVxcKS8pIHx8IGNhbGxlckxpbmUubWF0Y2goL2F0XFxzKyguKj8pOihcXGQrKTooXFxkKykvKTtcbiAgICAgICAgaWYgKG1hdGNoKSB7XG4gICAgICAgICAgICBjYWxsZXJJbmZvID0gYCR7bWF0Y2hbMV19OiR7bWF0Y2hbMl19YDtcbiAgICAgICAgfVxuICAgIH1cblxuICAgIGxldCBlcnJvck1lc3NhZ2UgPSBgRmF0YWw6IHNob3VsZG50X2hhcHBlbigpIHdhcyBjYWxsZWQgYXQgJHtjYWxsZXJJbmZvfVxcbmA7XG4gICAgZXJyb3JNZXNzYWdlICs9ICdUaGlzIGluZGljYXRlcyBhIHNhbml0eSBjaGVjayBmYWlsZWQgLSB0aGUgY29kZSBpcyBub3QgYmVoYXZpbmcgYXMgZXhwZWN0ZWQuXFxuJztcblxuICAgIGlmIChtZXNzYWdlKSB7XG4gICAgICAgIGVycm9yTWVzc2FnZSArPSBgRGV0YWlsczogJHttZXNzYWdlfVxcbmA7XG4gICAgfVxuXG4gICAgZXJyb3JNZXNzYWdlICs9ICdQbGVhc2UgdGhvcm91Z2hseSByZXZpZXcgdGhlIHJlbGF0ZWQgY29kZSB0byBkZXRlcm1pbmUgd2h5IHRoaXMgZXJyb3Igb2NjdXJyZWQuJztcblxuICAgIC8vIExvZyB0byBjb25zb2xlIHdpdGggZnVsbCB2aXNpYmlsaXR5XG4gICAgY29uc29sZS5lcnJvcignPScucmVwZWF0KDgwKSk7XG4gICAgY29uc29sZS5lcnJvcignU0FOSVRZIENIRUNLIEZBSUxVUkUnKTtcbiAgICBjb25zb2xlLmVycm9yKCc9Jy5yZXBlYXQoODApKTtcbiAgICBjb25zb2xlLmVycm9yKGVycm9yTWVzc2FnZSk7XG4gICAgY29uc29sZS5lcnJvcignU3RhY2sgdHJhY2U6Jywgc3RhY2spO1xuICAgIGNvbnNvbGUuZXJyb3IoJz0nLnJlcGVhdCg4MCkpO1xuXG4gICAgLy8gVGhyb3cgZXJyb3IgdG8gc3RvcCBleGVjdXRpb24gZmxvd1xuICAgIGNvbnN0IGZhdGFsRXJyb3IgPSBuZXcgRXJyb3IoZXJyb3JNZXNzYWdlKTtcbiAgICBmYXRhbEVycm9yLm5hbWUgPSAnU2FuaXR5Q2hlY2tGYWlsdXJlJztcbiAgICB0aHJvdyBmYXRhbEVycm9yO1xufSJdLCJtYXBwaW5ncyI6Ijs7QUFBQTtBQUNBO0FBQ0E7QUFDQTs7QUFFQTtBQUNBO0FBQ0E7O0FBRUE7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0EsU0FBU0EsS0FBS0EsQ0FBQ0MsR0FBRyxFQUFFQyxVQUFVLEVBQUU7RUFDNUIsSUFBSSxPQUFPRCxHQUFHLENBQUNELEtBQUssSUFBSUcsS0FBSyxFQUFFO0lBQzNCLE9BQU9GLEdBQUc7RUFDZCxDQUFDLE1BQU07SUFDSCxJQUFJLE9BQU9DLFVBQVUsSUFBSUMsS0FBSyxFQUFFO01BQzVCLE9BQU87UUFBRUgsS0FBSyxFQUFFQyxHQUFHO1FBQUVHLE1BQU0sRUFBRTtNQUFLLENBQUM7SUFDdkMsQ0FBQyxNQUFNO01BQ0gsT0FBTztRQUFFSixLQUFLLEVBQUVDLEdBQUc7UUFBRUcsTUFBTSxFQUFFRjtNQUFXLENBQUM7SUFDN0M7RUFDSjtBQUNKOztBQUVBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0EsU0FBU0csZUFBZUEsQ0FBQSxFQUFpQjtFQUFBLElBQWhCQyxPQUFPLEdBQUFDLFNBQUEsQ0FBQUMsTUFBQSxRQUFBRCxTQUFBLFFBQUFFLFNBQUEsR0FBQUYsU0FBQSxNQUFHLElBQUk7RUFDbkMsTUFBTVAsS0FBSyxHQUFHLElBQUlVLEtBQUssQ0FBQyxDQUFDO0VBQ3pCLE1BQU1DLEtBQUssR0FBR1gsS0FBSyxDQUFDVyxLQUFLLElBQUksRUFBRTtFQUMvQixNQUFNQyxVQUFVLEdBQUdELEtBQUssQ0FBQ0UsS0FBSyxDQUFDLElBQUksQ0FBQzs7RUFFcEM7RUFDQSxJQUFJQyxVQUFVLEdBQUcsa0JBQWtCO0VBQ25DLElBQUlGLFVBQVUsQ0FBQ0osTUFBTSxHQUFHLENBQUMsRUFBRTtJQUN2QixNQUFNTyxVQUFVLEdBQUdILFVBQVUsQ0FBQyxDQUFDLENBQUMsSUFBSUEsVUFBVSxDQUFDLENBQUMsQ0FBQyxJQUFJLEVBQUU7SUFDdkQ7SUFDQSxNQUFNSSxLQUFLLEdBQUdELFVBQVUsQ0FBQ0MsS0FBSyxDQUFDLGtDQUFrQyxDQUFDLElBQUlELFVBQVUsQ0FBQ0MsS0FBSyxDQUFDLHdCQUF3QixDQUFDO0lBQ2hILElBQUlBLEtBQUssRUFBRTtNQUNQRixVQUFVLEdBQUcsR0FBR0UsS0FBSyxDQUFDLENBQUMsQ0FBQyxJQUFJQSxLQUFLLENBQUMsQ0FBQyxDQUFDLEVBQUU7SUFDMUM7RUFDSjtFQUVBLElBQUlDLFlBQVksR0FBRywwQ0FBMENILFVBQVUsSUFBSTtFQUMzRUcsWUFBWSxJQUFJLGdGQUFnRjtFQUVoRyxJQUFJWCxPQUFPLEVBQUU7SUFDVFcsWUFBWSxJQUFJLFlBQVlYLE9BQU8sSUFBSTtFQUMzQztFQUVBVyxZQUFZLElBQUksaUZBQWlGOztFQUVqRztFQUNBQyxPQUFPLENBQUNsQixLQUFLLENBQUMsR0FBRyxDQUFDbUIsTUFBTSxDQUFDLEVBQUUsQ0FBQyxDQUFDO0VBQzdCRCxPQUFPLENBQUNsQixLQUFLLENBQUMsc0JBQXNCLENBQUM7RUFDckNrQixPQUFPLENBQUNsQixLQUFLLENBQUMsR0FBRyxDQUFDbUIsTUFBTSxDQUFDLEVBQUUsQ0FBQyxDQUFDO0VBQzdCRCxPQUFPLENBQUNsQixLQUFLLENBQUNpQixZQUFZLENBQUM7RUFDM0JDLE9BQU8sQ0FBQ2xCLEtBQUssQ0FBQyxjQUFjLEVBQUVXLEtBQUssQ0FBQztFQUNwQ08sT0FBTyxDQUFDbEIsS0FBSyxDQUFDLEdBQUcsQ0FBQ21CLE1BQU0sQ0FBQyxFQUFFLENBQUMsQ0FBQzs7RUFFN0I7RUFDQSxNQUFNQyxVQUFVLEdBQUcsSUFBSVYsS0FBSyxDQUFDTyxZQUFZLENBQUM7RUFDMUNHLFVBQVUsQ0FBQ0MsSUFBSSxHQUFHLG9CQUFvQjtFQUN0QyxNQUFNRCxVQUFVO0FBQ3BCIiwiaWdub3JlTGlzdCI6W119