@visulima/pail 3.1.0 → 3.2.0

package/dist/packem_shared/AbstractJsonReporter-intFdT_A.js

@@ -0,0 +1,204 @@
+import { E as EMPTY_SYMBOL } from './constants-DfDr4MHC.js';
+
+function isPlainObject(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in value) && !(Symbol.iterator in value);
+}
+
+const ErrorProto = Object.create(
+  {},
+  {
+    cause: {
+      enumerable: true,
+      value: void 0,
+      writable: true
+    },
+    code: {
+      enumerable: true,
+      value: void 0,
+      writable: true
+    },
+    errors: {
+      enumerable: true,
+      value: void 0,
+      writable: true
+    },
+    message: {
+      enumerable: true,
+      value: void 0,
+      writable: true
+    },
+    name: {
+      enumerable: true,
+      value: void 0,
+      writable: true
+    },
+    stack: {
+      enumerable: true,
+      value: void 0,
+      writable: true
+    }
+  }
+);
+const toJsonWasCalled = /* @__PURE__ */ new WeakSet();
+const toJSON = (from) => {
+  toJsonWasCalled.add(from);
+  const json = from.toJSON();
+  toJsonWasCalled.delete(from);
+  return json;
+};
+const serializeValue = (value, seen, depth, options) => {
+  if (value && value instanceof Uint8Array && value.constructor.name === "Buffer") {
+    return "[object Buffer]";
+  }
+  if (value !== null && typeof value === "object" && typeof value.pipe === "function") {
+    return "[object Stream]";
+  }
+  if (value instanceof Error) {
+    if (seen.includes(value)) {
+      return "[Circular]";
+    }
+    depth += 1;
+    return _serialize(value, options, seen, depth);
+  }
+  if (options.useToJSON && typeof value.toJSON === "function") {
+    return value.toJSON();
+  }
+  if (typeof value === "object" && value instanceof Date) {
+    return value.toISOString();
+  }
+  if (typeof value === "function") {
+    return `[Function: ${value.name || "anonymous"}]`;
+  }
+  if (isPlainObject(value)) {
+    depth += 1;
+    if (options.maxDepth && depth >= options.maxDepth) {
+      return {};
+    }
+    const plainObject = {};
+    for (const key in value) {
+      plainObject[key] = serializeValue(value[key], seen, depth, options);
+    }
+    return plainObject;
+  }
+  try {
+    return value;
+  } catch {
+    return "[Not Available]";
+  }
+};
+const _serialize = (error, options, seen, depth) => {
+  seen.push(error);
+  if (options.maxDepth === 0) {
+    return {};
+  }
+  if (options.useToJSON && typeof error.toJSON === "function" && !toJsonWasCalled.has(error)) {
+    return toJSON(error);
+  }
+  const protoError = Object.create(ErrorProto);
+  protoError.name = Object.prototype.toString.call(error.constructor) === "[object Function]" ? error.constructor.name : error.name;
+  protoError.message = error.message;
+  protoError.stack = error.stack;
+  if (Array.isArray(error.errors)) {
+    const aggregateErrors = [];
+    for (const aggregateError of error.errors) {
+      if (!(aggregateError instanceof Error)) {
+        throw new TypeError("All errors in the 'errors' property must be instances of Error");
+      }
+      if (seen.includes(aggregateError)) {
+        protoError.errors = [];
+        return protoError;
+      }
+      aggregateErrors.push(_serialize(aggregateError, options, seen, depth));
+    }
+    protoError.errors = aggregateErrors;
+  }
+  if (error.cause instanceof Error && !seen.includes(error.cause)) {
+    protoError.cause = _serialize(error.cause, options, seen, depth);
+  }
+  for (const key in error) {
+    if (protoError[key] === void 0) {
+      const value = error[key];
+      protoError[key] = serializeValue(value, seen, depth, options);
+    }
+  }
+  if (Array.isArray(options.exclude) && options.exclude.length > 0) {
+    for (const key of options.exclude) {
+      try {
+        delete protoError[key];
+      } catch {
+      }
+    }
+  }
+  return protoError;
+};
+const serialize = (error, options = {}) => _serialize(
+  error,
+  {
+    exclude: options.exclude ?? [],
+    maxDepth: options.maxDepth ?? Number.POSITIVE_INFINITY,
+    useToJSON: options.useToJSON ?? false
+  },
+  [],
+  0
+);
+
+class AbstractJsonReporter {
+  /** Custom stringify function for object serialization */
+  stringify;
+  /** Error serialization options */
+  errorOptions;
+  /**
+   * Creates a new AbstractJsonReporter instance.
+   * @param options Configuration options for JSON formatting and error handling
+   */
+  constructor(options = {}) {
+    this.errorOptions = options.error ?? {};
+  }
+  /**
+   * Sets a custom stringify function for object serialization.
+   * @param function_ The stringify function to use for serialization
+   */
+  // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types, @typescript-eslint/no-explicit-any
+  setStringify(function_) {
+    this.stringify = function_;
+  }
+  // eslint-disable-next-line sonarjs/cognitive-complexity
+  log(meta) {
+    const { context, error, file, message, type, ...rest } = meta;
+    if (rest.label) {
+      rest.label = rest.label.trim();
+    }
+    if (file) {
+      rest.file = `${file.name}:${file.line}${file.column ? `:${file.column}` : ""}`;
+    }
+    if (message === EMPTY_SYMBOL) {
+      rest.message = void 0;
+    } else {
+      rest.message = message;
+    }
+    if (error) {
+      rest.error = serialize(error, this.errorOptions);
+    }
+    if (context) {
+      const newContext = [];
+      for (const item of context) {
+        if (item === EMPTY_SYMBOL) {
+          continue;
+        }
+        if (item instanceof Error) {
+          newContext.push(serialize(item, this.errorOptions));
+        } else {
+          newContext.push(item);
+        }
+      }
+      rest.context = newContext;
+    }
+    this._log(this.stringify(rest), type.level);
+  }
+}
+
+export { AbstractJsonReporter };

package/dist/packem_shared/InteractiveManager-CZ85hGNW.js

@@ -0,0 +1,172 @@
+import { t as terminalSize, w as wordWrap, W as WrapMode } from './index-DqKWykfa.js';
+
+class InteractiveManager {
+  #stream;
+  #isActive = false;
+  #isSuspended = false;
+  #lastLength = 0;
+  #outside = 0;
+  /**
+   * Creates a new InteractiveManager with the given stream hooks.
+   * @param stdout Hook for stdout stream
+   * @param stderr Hook for stderr stream
+   */
+  constructor(stdout, stderr) {
+    this.#stream = {
+      stderr,
+      stdout
+    };
+  }
+  /**
+   * Last printed rows count.
+   *
+   * Tracks the number of rows that were last written to the terminal.
+   * Used internally for managing cursor positioning and output updates.
+   */
+  get lastLength() {
+    return this.#lastLength;
+  }
+  /**
+   * Rows count outside editable area.
+   *
+   * Tracks the number of rows that extend beyond the current terminal height.
+   * Used for managing scrolling and ensuring all output remains visible.
+   */
+  get outside() {
+    return this.#outside;
+  }
+  /**
+   * Hook activity status.
+   *
+   * Indicates whether the interactive hooks are currently active.
+   * When true, streams are being intercepted for interactive output.
+   */
+  get isHooked() {
+    return this.#isActive;
+  }
+  /**
+   * Suspend status for active hooks.
+   *
+   * Indicates whether interactive mode is temporarily suspended.
+   * When suspended, external output can be written without interference.
+   */
+  get isSuspended() {
+    return this.#isSuspended;
+  }
+  /**
+   * Removes lines from the terminal output.
+   *
+   * Erases the specified number of lines from the bottom of the output,
+   * moving the cursor up and clearing the lines. Useful for removing
+   * previous interactive output before displaying new content.
+   * @param stream The stream to erase lines from ("stdout" or "stderr")
+   * @param count Number of lines to remove (defaults to lastLength)
+   * @throws {TypeError} If the specified stream is not available
+   */
+  erase(stream, count = this.#lastLength) {
+    if (this.#stream[stream] === void 0) {
+      throw new TypeError(`Stream "${stream}" is not available`);
+    }
+    this.#stream[stream].erase(count);
+  }
+  /**
+   * Hook stdout and stderr streams.
+   * @returns Success status
+   */
+  hook() {
+    if (!this.#isActive) {
+      Object.values(this.#stream).forEach((hook) => hook.active());
+      this.#clear(true);
+    }
+    return this.#isActive;
+  }
+  /**
+   * Resume suspend hooks.
+   * @param stream Stream to resume
+   * @param eraseRowCount erase output rows count
+   */
+  resume(stream, eraseRowCount) {
+    if (this.#isSuspended) {
+      this.#isSuspended = false;
+      if (eraseRowCount) {
+        this.erase(stream, eraseRowCount);
+      }
+      this.#lastLength = 0;
+      Object.values(this.#stream).forEach((hook) => hook.active());
+    }
+  }
+  /**
+   * Suspend active hooks for external output.
+   * @param stream Stream to suspend
+   * @param erase erase output
+   */
+  suspend(stream, erase = true) {
+    if (!this.#isSuspended) {
+      this.#isSuspended = true;
+      if (erase) {
+        this.erase(stream);
+      }
+      Object.values(this.#stream).forEach((hook) => hook.renew());
+    }
+  }
+  /**
+   * Unhooks both stdout and stderr streams and print their story of logs.
+   * @param separateHistory If `true`, will add an empty line to the history output for individual recorded lines and console logs
+   * @returns Success status
+   */
+  unhook(separateHistory = true) {
+    if (this.#isActive) {
+      Object.values(this.#stream).forEach((hook) => hook.inactive(separateHistory));
+      this.#clear();
+    }
+    return !this.#isActive;
+  }
+  /**
+   * Update output.
+   * @param stream Stream to write to
+   * @param rows Text lines to write to standard output
+   * @param from Index of the line starting from which the contents of the terminal are being overwritten
+   */
+  update(stream, rows, from = 0) {
+    if (rows.length > 0) {
+      if (this.#stream[stream] === void 0) {
+        throw new TypeError(`Stream "${stream}" is not available`);
+      }
+      const hook = this.#stream[stream];
+      const { columns: width, rows: height } = terminalSize();
+      const position = from > height ? height - 1 : Math.max(0, Math.min(height - 1, from));
+      const actualLength = this.lastLength - position;
+      const outside = Math.max(actualLength - height, this.outside);
+      let output = rows.reduce(
+        (accumulator, row) => [
+          ...accumulator,
+          wordWrap(row, {
+            trim: false,
+            width,
+            wrapMode: WrapMode.STRICT_WIDTH
+          })
+        ],
+        []
+      );
+      if (height <= actualLength) {
+        hook.erase(height);
+        if (position < outside) {
+          output = output.slice(outside - position + 1);
+        }
+      } else if (actualLength) {
+        hook.erase(actualLength);
+      }
+      hook.write(`${output.join("\n")}
+`);
+      this.#lastLength = outside ? outside + output.length + 1 : output.length;
+      this.#outside = Math.max(this.lastLength - height, this.outside);
+    }
+  }
+  #clear(status = false) {
+    this.#isActive = status;
+    this.#lastLength = 0;
+    this.#outside = 0;
+  }
+}
+
+export { InteractiveManager as default };

package/dist/packem_shared/InteractiveStreamHook-DiSubbJ1.js

@@ -0,0 +1,21 @@
+import { createRequire as __cjs_createRequire } from "node:module";
+
+const __cjs_require = __cjs_createRequire(import.meta.url);
+
+const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
+
+const __cjs_getBuiltinModule = (module) => {
+    // Check if we're in Node.js and version supports getBuiltinModule
+    if (typeof __cjs_getProcess !== "undefined" && __cjs_getProcess.versions && __cjs_getProcess.versions.node) {
+        const [major, minor] = __cjs_getProcess.versions.node.split(".").map(Number);
+        // Node.js 20.16.0+ and 22.3.0+
+        if (major > 22 || (major === 22 && minor >= 3) || (major === 20 && minor >= 16)) {
+            return __cjs_getProcess.getBuiltinModule(module);
+        }
+    }
+    // Fallback to createRequire
+    return __cjs_require(module);
+};
+
+
+export { I as default } from './interactive-stream-hook-DG4BtN12.js';

package/dist/packem_shared/JsonReporter-BqWsVkHP.js

@@ -0,0 +1,60 @@
+import { createRequire as __cjs_createRequire } from "node:module";
+
+const __cjs_require = __cjs_createRequire(import.meta.url);
+
+const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
+
+const {
+  stdout,
+  stderr
+} = __cjs_getProcess;
+import { w as writeStream } from './write-stream-BG8fhcs3.js';
+import { AbstractJsonReporter } from './AbstractJsonReporter-intFdT_A.js';
+
+class JsonReporter extends AbstractJsonReporter {
+  /** Standard output stream */
+  #stdout;
+  /** Standard error stream */
+  #stderr;
+  /**
+   * Creates a new Server JSON Reporter instance.
+   * @param options Configuration options for JSON formatting
+   */
+  constructor(options = {}) {
+    super(options);
+    this.#stdout = stdout;
+    this.#stderr = stderr;
+  }
+  /**
+   * Sets the stdout stream for the reporter.
+   * @param stdout_ The writable stream to use for stdout output
+   */
+  // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+  setStdout(stdout_) {
+    this.#stdout = stdout_;
+  }
+  /**
+   * Sets the stderr stream for the reporter.
+   * @param stderr_ The writable stream to use for stderr output
+   */
+  // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+  setStderr(stderr_) {
+    this.#stderr = stderr_;
+  }
+  /**
+   * Outputs the JSON message to the appropriate stream.
+   *
+   * Routes error and warning level messages to stderr, others to stdout.
+   * @param message The JSON-formatted log message
+   * @param logLevel The log level determining which stream to use
+   * @protected
+   */
+  // eslint-disable-next-line no-underscore-dangle
+  _log(message, logLevel) {
+    const stream = ["error", "warn"].includes(logLevel) ? this.#stderr : this.#stdout;
+    writeStream(`${message}
+`, stream);
+  }
+}
+
+export { JsonReporter as default };

package/dist/packem_shared/JsonReporter-DcM2LBX9.js

@@ -0,0 +1,28 @@
+import { AbstractJsonReporter } from './AbstractJsonReporter-intFdT_A.js';
+import { w as writeConsoleLogBasedOnLevel } from './write-console-log-based-on-level-DBmRYXpj.js';
+
+class JsonReporter extends AbstractJsonReporter {
+  /**
+   * Creates a new Browser JSON Reporter instance.
+   * @param options Configuration options for JSON formatting
+   */
+  constructor(options = {}) {
+    super(options);
+  }
+  /**
+   * Outputs the JSON message to the browser console.
+   *
+   * Uses the appropriate console method based on the log level
+   * (console.log, console.error, console.warn, etc.).
+   * @param message The JSON-formatted log message
+   * @param logLevel The log level determining which console method to use
+   * @protected
+   */
+  // eslint-disable-next-line class-methods-use-this, no-underscore-dangle
+  _log(message, logLevel) {
+    const consoleLogFunction = writeConsoleLogBasedOnLevel(logLevel);
+    consoleLogFunction(message);
+  }
+}
+
+export { JsonReporter as default };

package/dist/packem_shared/PrettyReporter-BFWaYP_J.js

@@ -0,0 +1,222 @@
+import { createRequire as __cjs_createRequire } from "node:module";
+
+const __cjs_require = __cjs_createRequire(import.meta.url);
+
+const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
+
+const {
+  stdout,
+  stderr
+} = __cjs_getProcess;
+import colorize, { red, greenBright, cyan, green, grey, white, bgGrey, underline } from '@visulima/colorize';
+import { d as defaultInspectorConfig, f as formatLabel, i as inspect, r as renderError } from './format-label-Btft2KGP.js';
+import { t as terminalSize, g as getStringWidth, w as wordWrap, W as WrapMode } from './index-DqKWykfa.js';
+import { E as EMPTY_SYMBOL } from './constants-DfDr4MHC.js';
+import { A as AbstractPrettyReporter, g as getLongestBadge } from './abstract-pretty-reporter-DMPDCslJ.js';
+import { g as getLongestLabel } from './get-longest-label-C9PWeyKq.js';
+import { w as writeStream } from './write-stream-BG8fhcs3.js';
+
+const pailFileFilter = (line) => !/[\\/]pail[\\/]dist/.test(line);
+class PrettyReporter extends AbstractPrettyReporter {
+  #stdout;
+  #stderr;
+  #interactiveManager;
+  #interactive = false;
+  #inspectOptions;
+  #errorOptions;
+  /**
+   * Creates a new Server Pretty Reporter instance.
+   * @param options Configuration options for styling, error rendering, and object inspection
+   */
+  constructor(options = {}) {
+    const { error: errorOptions, inspect: inspectOptions, ...rest } = options;
+    super({
+      uppercase: {
+        label: true,
+        ...rest.uppercase
+      },
+      ...rest
+    });
+    this.#inspectOptions = { ...defaultInspectorConfig, ...inspectOptions };
+    this.#errorOptions = {
+      ...errorOptions,
+      color: {
+        fileLine: green,
+        hint: cyan,
+        marker: red,
+        message: red,
+        method: greenBright,
+        title: red
+      }
+    };
+    this.#stdout = stdout;
+    this.#stderr = stderr;
+  }
+  /**
+   * Sets the stdout stream for the reporter.
+   * @param stdout_ The writable stream to use for standard output
+   */
+  setStdout(stdout_) {
+    this.#stdout = stdout_;
+  }
+  /**
+   * Sets the stderr stream for the reporter.
+   * @param stderr_ The writable stream to use for error output
+   */
+  setStderr(stderr_) {
+    this.#stderr = stderr_;
+  }
+  /**
+   * Sets the interactive manager for handling interactive output.
+   * @param manager The interactive manager instance, or undefined to disable
+   */
+  setInteractiveManager(manager) {
+    this.#interactiveManager = manager;
+  }
+  /**
+   * Enables or disables interactive mode.
+   * @param interactive Whether to enable interactive terminal features
+   */
+  setIsInteractive(interactive) {
+    this.#interactive = interactive;
+  }
+  log(meta) {
+    this._log(this._formatMessage(meta), meta.type.level);
+  }
+  // eslint-disable-next-line sonarjs/cognitive-complexity, no-underscore-dangle
+  _formatMessage(data) {
+    const { columns } = terminalSize();
+    let size = columns;
+    if (typeof this.styles.messageLength === "number") {
+      size = this.styles.messageLength;
+    }
+    const { badge, context, date, error, file, groups, label, message, prefix, repeated, scope, suffix, traceError, type } = data;
+    const { color } = this.loggerTypes[type.name];
+    const colorized = color ? colorize[color] : white;
+    const groupSpaces = groups.map(() => "    ").join("");
+    const items = [];
+    if (groups.length > 0) {
+      items.push(`${groupSpaces + grey(`[${groups.at(-1)}]`)} `);
+    }
+    if (date) {
+      items.push(`${grey(this.styles.dateFormatter(typeof date === "string" ? new Date(date) : date))} `);
+    }
+    if (badge) {
+      items.push(colorized(badge));
+    } else {
+      const longestBadge = getLongestBadge(this.loggerTypes);
+      if (longestBadge.length > 0) {
+        items.push(`${grey(".".repeat(longestBadge.length))} `);
+      }
+    }
+    const longestLabel = getLongestLabel(this.loggerTypes);
+    if (label) {
+      const longestLabelWidth = getStringWidth(longestLabel);
+      const labelWidth = getStringWidth(label);
+      items.push(`${colorized(formatLabel(label, this.styles))} `, grey(".".repeat(Math.max(0, longestLabelWidth - labelWidth))));
+    } else {
+      items.push(grey(".".repeat(longestLabel.length + 2)));
+    }
+    if (repeated) {
+      items.push(`${bgGrey.white(`[${repeated}x]`)} `);
+    }
+    if (Array.isArray(scope) && scope.length > 0) {
+      items.push(` ${grey(`[${scope.join(" > ")}]`)} `);
+    }
+    if (prefix) {
+      items.push(
+        `${grey(`${Array.isArray(scope) && scope.length > 0 ? ". " : " "}[${this.styles.underline.prefix ? underline(prefix) : prefix}]`)} `
+      );
+    }
+    const titleSize = getStringWidth(items.join(" "));
+    if (file) {
+      const fileMessage = file.name + (file.line ? `:${file.line}` : "");
+      const fileMessageSize = getStringWidth(fileMessage);
+      if (fileMessageSize + titleSize + 2 > size) {
+        items.push(grey(` ${fileMessage}`));
+      } else {
+        const dots = Math.max(0, size - titleSize - fileMessageSize - 2);
+        items.push(grey(`${".".repeat(dots)} ${fileMessage}`));
+      }
+    } else {
+      items.push(grey(".".repeat(Math.max(0, size - titleSize - 1))));
+    }
+    if (items.length > 0) {
+      items.push("\n\n");
+    }
+    if (message !== EMPTY_SYMBOL) {
+      const formattedMessage = typeof message === "string" ? message : inspect(message, this.#inspectOptions);
+      items.push(
+        groupSpaces + wordWrap(formattedMessage, {
+          trim: false,
+          width: size - 3,
+          wrapMode: WrapMode.STRICT_WIDTH
+        })
+      );
+    }
+    if (context) {
+      let hasError = false;
+      items.push(
+        ...context.map((value) => {
+          if (value instanceof Error) {
+            hasError = true;
+            return `
+
+${renderError(value, {
+              ...this.#errorOptions,
+              filterStacktrace: pailFileFilter,
+              prefix: groupSpaces
+            })}`;
+          }
+          if (typeof value === "object") {
+            return ` ${inspect(value, this.#inspectOptions)}`;
+          }
+          const newValue = (hasError ? "\n\n" : " ") + value;
+          hasError = false;
+          return newValue;
+        })
+      );
+    }
+    if (error) {
+      items.push(
+        renderError(error, {
+          ...this.#errorOptions,
+          filterStacktrace: pailFileFilter,
+          prefix: groupSpaces
+        })
+      );
+    }
+    if (traceError) {
+      items.push(
+        `
+
+${renderError(traceError, {
+          ...this.#errorOptions,
+          filterStacktrace: pailFileFilter,
+          hideErrorCauseCodeView: true,
+          hideErrorCodeView: true,
+          hideErrorErrorsCodeView: true,
+          hideMessage: true,
+          prefix: groupSpaces
+        })}`
+      );
+    }
+    if (suffix) {
+      items.push("\n", groupSpaces + grey(this.styles.underline.suffix ? underline(suffix) : suffix));
+    }
+    return items.join("");
+  }
+  // eslint-disable-next-line no-underscore-dangle
+  _log(message, logLevel) {
+    const streamType = ["error", "trace", "warn"].includes(logLevel) ? "stderr" : "stdout";
+    const stream = streamType === "stderr" ? this.#stderr : this.#stdout;
+    if (this.#interactive && this.#interactiveManager !== void 0 && stream.isTTY) {
+      this.#interactiveManager.update(streamType, message.split("\n"), 0);
+    } else {
+      writeStream(`${message}
+`, stream);
+    }
+  }
+}
+
+export { PrettyReporter };