@visulima/pail 4.0.0-alpha.10 → 4.0.0-alpha.12

package/dist/progress-bar.d.ts

@@ -1,145 +0,0 @@
-import type InteractiveManager from "./interactive/interactive-manager.d.ts";
-export type ProgressBarStyle = "shades_classic" | "shades_grey" | "rect" | "filled" | "solid" | "ascii" | "braille" | "custom";
-export interface ProgressBarOptions {
-    barCompleteChar?: string | string[];
-    barGlue?: string;
-    barIncompleteChar?: string | string[];
-    current?: number;
-    format?: string;
-    fps?: number;
-    peak?: number;
-    peakChar?: string;
-    roundedCaps?: boolean;
-    style?: ProgressBarStyle;
-    total: number;
-    width?: number;
-}
-export interface SingleBarOptions extends ProgressBarOptions {
-    format?: string;
-}
-export interface MultiBarOptions {
-    barCompleteChar?: string | string[];
-    barGlue?: string;
-    barIncompleteChar?: string | string[];
-    composite?: boolean;
-    format?: string;
-    fps?: number;
-    style?: ProgressBarStyle;
-}
-export interface ProgressBarPayload {
-    [key: string]: string | number | boolean;
-}
-/**
- * Gets the appropriate bar character based on style and completion state.
- * @param char Custom character override
- * @param style Progress bar style to use
- * @param complete Whether to get completed or incomplete character
- * @returns The appropriate character for the given style
- */
-export declare const getBarChar: (char: string | undefined, style: ProgressBarStyle, complete?: boolean) => string;
-export declare const applyStyleToOptions: <T extends ProgressBarOptions | MultiBarOptions>(options: T) => T;
-export declare class ProgressBar {
-    protected options: ProgressBarOptions;
-    protected current: number;
-    private startTime;
-    private interactiveManager?;
-    private isActive;
-    private payload?;
-    /**
-     * Creates a new progress bar instance.
-     * @param options Configuration options for the progress bar
-     * @param interactiveManager Optional interactive manager for rendering
-     * @param payload Optional initial payload data for format placeholders
-     */
-    constructor(options: ProgressBarOptions, interactiveManager?: InteractiveManager, payload?: ProgressBarPayload);
-    /**
-     * Updates the progress bar to a new value.
-     * @param current The current progress value
-     * @param payload Optional payload data to merge with existing data
-     */
-    update(current: number, payload?: ProgressBarPayload): void;
-    /**
-     * Sets the peak marker position.
-     * @param peak The peak value (in the same scale as total)
-     */
-    setPeak(peak: number): void;
-    /**
-     * Increments the progress bar by a specified step.
-     * @param step Amount to increment (default: 1)
-     * @param payload Optional payload data to merge with existing data
-     */
-    increment(step?: number, payload?: ProgressBarPayload): void;
-    /**
-     * Renders the progress bar as a formatted string.
-     * @returns Formatted progress bar string with all placeholders replaced
-     */
-    render(): string;
-    /**
-     * Starts the progress bar.
-     * @param total Optional total value to set
-     * @param startValue Optional starting value
-     * @param payload Optional initial payload data
-     */
-    start(total?: number, startValue?: number, payload?: ProgressBarPayload): void;
-    /**
-     * Stops the progress bar and cleanup.
-     */
-    stop(): void;
-    private calculatePeakPosition;
-    private calculateETA;
-}
-export declare class MultiBarInstance extends ProgressBar {
-    private multiBar;
-    constructor(multiBar: MultiProgressBar, options: ProgressBarOptions, payload?: ProgressBarPayload);
-    update(current: number, payload?: ProgressBarPayload): void;
-    getBarState(): {
-        char: string;
-        current: number;
-        total: number;
-    };
-}
-export declare class MultiProgressBar {
-    private bars;
-    private options;
-    private interactiveManager?;
-    private isActive;
-    private nextBarId;
-    private composite;
-    private barColors;
-    /**
-     * Creates a new multi progress bar manager.
-     * @param options Configuration options for the progress bars
-     * @param interactiveManager Optional interactive manager for rendering
-     */
-    constructor(options?: MultiBarOptions, interactiveManager?: InteractiveManager);
-    /**
-     * Creates a new progress bar within this multi-bar manager.
-     * @param total Total value for the progress bar
-     * @param current Starting current value (default: 0)
-     * @param payload Optional initial payload data for format placeholders
-     * @returns The created progress bar instance
-     */
-    create(total: number, current?: number, payload?: ProgressBarPayload): ProgressBar;
-    /**
-     * Removes a progress bar from the manager.
-     * @param bar The progress bar instance to remove
-     * @returns True if the bar was removed, false if not found
-     */
-    remove(bar: ProgressBar): boolean;
-    /**
-     * Renders all progress bars.
-     */
-    renderAll(): void;
-    /**
-     * Sets or removes a color function for a specific bar.
-     * @param bar The progress bar instance to color (must be from this MultiProgressBar)
-     * @param color Color function or undefined to remove color
-     */
-    setBarColor(bar: MultiBarInstance, color: ((text: string) => string) | undefined): void;
-    /**
-     * Stops all progress bars and cleanup.
-     */
-    stop(): void;
-    private renderComposite;
-    private getCompositeChar;
-}

package/dist/progress-bar.js

@@ -1,459 +0,0 @@
-const CHAR_GRADIENTS = {
-  braille: ["⣿", "⡷", "⢾", "⠤"],
-  default: ["█", "▓", "▒", "░"],
-  rect: ["▬", "▮", "▯", "▭"]
-};
-const BRAILLE_FULL = "⣿";
-const BRAILLE_CAP_LEFT = "⢾";
-const BRAILLE_CAP_RIGHT = "⡷";
-const BRAILLE_EMPTY = "⠤";
-const BAR_REGEX = /\[([^[\]]*)\]/u;
-const getBarChar = (char, style, complete = true) => {
-  if (char) {
-    return char;
-  }
-  switch (style) {
-    case "ascii": {
-      return complete ? "#" : "-";
-    }
-    case "braille": {
-      return complete ? BRAILLE_FULL : BRAILLE_EMPTY;
-    }
-    case "filled": {
-      return complete ? "█" : " ";
-    }
-    case "rect": {
-      return complete ? "▬" : "▭";
-    }
-    case "shades_classic": {
-      return complete ? "█" : "░";
-    }
-    case "shades_grey": {
-      return complete ? "▓" : "░";
-    }
-    case "solid": {
-      return complete ? "█" : " ";
-    }
-    default: {
-      return complete ? "█" : "░";
-    }
-  }
-};
-const applyStyleToOptions = (options) => {
-  if (!options.style) {
-    return options;
-  }
-  const { style } = options;
-  const result = { ...options };
-  result.barCompleteChar ??= getBarChar(void 0, style, true);
-  result.barIncompleteChar ??= getBarChar(void 0, style, false);
-  result.barGlue ??= "";
-  return result;
-};
-class ProgressBar {
-  options;
-  current;
-  startTime;
-  interactiveManager;
-  isActive = false;
-  payload;
-  /**
-   * Creates a new progress bar instance.
-   * @param options Configuration options for the progress bar
-   * @param interactiveManager Optional interactive manager for rendering
-   * @param payload Optional initial payload data for format placeholders
-   */
-  constructor(options, interactiveManager, payload) {
-    const isCompleteArray = Array.isArray(options.barCompleteChar);
-    const isIncompleteArray = Array.isArray(options.barIncompleteChar);
-    const isGradientMode = isCompleteArray || isIncompleteArray;
-    const effectiveStyle = options.style ?? "shades_classic";
-    const completeChar = isCompleteArray ? options.barCompleteChar : getBarChar(options.barCompleteChar, effectiveStyle);
-    const incompleteChar = isIncompleteArray ? options.barIncompleteChar : getBarChar(options.barIncompleteChar, effectiveStyle, false);
-    this.options = {
-      barCompleteChar: completeChar,
-      barIncompleteChar: incompleteChar,
-      current: 0,
-      fps: 10,
-      width: 40,
-      ...options
-    };
-    if (isGradientMode) {
-      if (!Array.isArray(this.options.barCompleteChar)) {
-        this.options.barCompleteChar = [this.options.barCompleteChar];
-      }
-      if (!Array.isArray(this.options.barIncompleteChar)) {
-        this.options.barIncompleteChar = [this.options.barIncompleteChar];
-      }
-    }
-    this.current = this.options.current ?? 0;
-    this.startTime = Date.now();
-    this.interactiveManager = interactiveManager;
-    this.payload = payload;
-  }
-  /**
-   * Updates the progress bar to a new value.
-   * @param current The current progress value
-   * @param payload Optional payload data to merge with existing data
-   */
-  update(current, payload) {
-    this.current = Math.min(current, this.options.total);
-    if (payload) {
-      this.payload = { ...this.payload, ...payload };
-    }
-    if (this.interactiveManager && this.isActive) {
-      const progressBar = this.render();
-      this.interactiveManager.update("stdout", [progressBar]);
-    }
-  }
-  /**
-   * Sets the peak marker position.
-   * @param peak The peak value (in the same scale as total)
-   */
-  setPeak(peak) {
-    this.options.peak = peak;
-  }
-  /**
-   * Increments the progress bar by a specified step.
-   * @param step Amount to increment (default: 1)
-   * @param payload Optional payload data to merge with existing data
-   */
-  increment(step = 1, payload) {
-    this.update(this.current + step, payload);
-  }
-  /**
-   * Renders the progress bar as a formatted string.
-   * @returns Formatted progress bar string with all placeholders replaced
-   */
-  // eslint-disable-next-line sonarjs/cognitive-complexity
-  render() {
-    const total = this.options.total > 0 ? this.options.total : 1;
-    const width = Math.max(0, this.options.width ?? 40);
-    const percentage = Math.max(0, Math.min(100, Math.round(this.current / total * 100)));
-    const filled = Math.max(0, Math.min(width, Math.round(this.current / total * width)));
-    const empty = width - filled;
-    let bar;
-    const useCaps = this.options.roundedCaps === true || this.options.roundedCaps === void 0 && this.options.style === "braille";
-    if (Array.isArray(this.options.barCompleteChar) || Array.isArray(this.options.barIncompleteChar)) {
-      const completeChars = Array.isArray(this.options.barCompleteChar) ? this.options.barCompleteChar : void 0;
-      const incompleteChars = Array.isArray(this.options.barIncompleteChar) ? this.options.barIncompleteChar : void 0;
-      const completeChar = completeChars?.[completeChars.length - 1] ?? (typeof this.options.barCompleteChar === "string" ? this.options.barCompleteChar : "█");
-      const incompleteChar = incompleteChars?.[0] ?? (typeof this.options.barIncompleteChar === "string" ? this.options.barIncompleteChar : "░");
-      const completeLength = completeChars?.length ?? 1;
-      const progressRatio = this.current / total;
-      const totalSteps = width * completeLength;
-      const currentStep = Math.round(progressRatio * totalSteps);
-      const fractional = currentStep % completeLength;
-      let barContent = "";
-      for (let i = 0; i < width; i += 1) {
-        if (i < filled) {
-          const isGradientBoundary = i === filled - 1 && fractional > 0 && completeChars;
-          barContent += isGradientBoundary ? completeChars[Math.max(0, fractional - 1)] ?? completeChar : completeChar;
-        } else {
-          barContent += incompleteChar;
-        }
-      }
-      bar = barContent;
-    } else {
-      const completeChar = typeof this.options.barCompleteChar === "string" ? this.options.barCompleteChar : "█";
-      const incompleteChar = typeof this.options.barIncompleteChar === "string" ? this.options.barIncompleteChar : "░";
-      const peakPos = this.calculatePeakPosition(width, total, filled);
-      const peakChar = this.options.peakChar ?? completeChar;
-      if (peakPos === void 0) {
-        bar = completeChar.repeat(filled) + incompleteChar.repeat(empty);
-      } else {
-        let barContent = "";
-        for (let i = 0; i < width; i += 1) {
-          if (i === peakPos) {
-            barContent += peakChar;
-          } else if (i < filled) {
-            barContent += completeChar;
-          } else {
-            barContent += incompleteChar;
-          }
-        }
-        bar = barContent;
-      }
-    }
-    if (useCaps && width >= 2) {
-      const chars = [...bar];
-      chars[0] = BRAILLE_CAP_LEFT;
-      chars[chars.length - 1] = BRAILLE_CAP_RIGHT;
-      bar = chars.join("");
-    }
-    let format = this.options.format ?? "progress [{bar}] {percentage}% | ETA: {eta}s | {value}/{total}";
-    if (this.payload) {
-      const entries = Object.entries(this.payload);
-      for (let i = 0; i < entries.length; i += 1) {
-        const [k, v] = entries[i];
-        format = format.replaceAll(`{${k}}`, String(v));
-      }
-    }
-    const eta = this.calculateETA();
-    return format.replaceAll("{bar}", bar).replaceAll("{percentage}", String(percentage)).replaceAll("{value}", String(this.current)).replaceAll("{total}", String(this.options.total)).replaceAll("{eta}", String(eta));
-  }
-  /**
-   * Starts the progress bar.
-   * @param total Optional total value to set
-   * @param startValue Optional starting value
-   * @param payload Optional initial payload data
-   */
-  start(total, startValue, payload) {
-    if (total !== void 0) {
-      this.options.total = total;
-    }
-    if (startValue !== void 0) {
-      this.current = startValue;
-    }
-    this.startTime = Date.now();
-    this.isActive = true;
-    if (this.interactiveManager) {
-      this.interactiveManager.hook();
-      this.update(this.current, payload);
-    }
-  }
-  /**
-   * Stops the progress bar and cleanup.
-   */
-  stop() {
-    this.isActive = false;
-    if (this.interactiveManager) {
-      this.interactiveManager.unhook(false);
-    }
-  }
-  calculatePeakPosition(width, total, filled) {
-    const { peak } = this.options;
-    if (peak === void 0 || peak <= 0) {
-      return void 0;
-    }
-    let peakPos = Math.max(0, Math.min(width - 1, Math.floor(peak / total * width)));
-    if (peakPos < filled - 1) {
-      peakPos = filled - 1;
-    }
-    return peakPos;
-  }
-  calculateETA() {
-    if (this.current === 0) {
-      return 0;
-    }
-    const elapsed = (Date.now() - this.startTime) / 1e3;
-    if (elapsed < 0.1) {
-      return 0;
-    }
-    const rate = this.current / elapsed;
-    const remaining = this.options.total - this.current;
-    return Math.round(remaining / rate);
-  }
-}
-class MultiBarInstance extends ProgressBar {
-  multiBar;
-  constructor(multiBar, options, payload) {
-    super(options, void 0, payload);
-    this.multiBar = multiBar;
-  }
-  update(current, payload) {
-    super.update(current, payload);
-    this.multiBar.renderAll();
-  }
-  getBarState() {
-    const completeChar = Array.isArray(this.options.barCompleteChar) ? this.options.barCompleteChar.at(-1) : getBarChar(this.options.barCompleteChar, this.options.style ?? "shades_classic", true);
-    return {
-      char: completeChar ?? "█",
-      current: this.current,
-      total: this.options.total
-    };
-  }
-}
-class MultiProgressBar {
-  bars = /* @__PURE__ */ new Map();
-  options;
-  interactiveManager;
-  isActive = false;
-  nextBarId = 0;
-  composite = false;
-  barColors = /* @__PURE__ */ new Map();
-  /**
-   * Creates a new multi progress bar manager.
-   * @param options Configuration options for the progress bars
-   * @param interactiveManager Optional interactive manager for rendering
-   */
-  constructor(options = {}, interactiveManager) {
-    this.options = {
-      barCompleteChar: getBarChar(void 0, "shades_classic"),
-      barIncompleteChar: getBarChar(void 0, "shades_classic", false),
-      composite: false,
-      format: "progress [{bar}] {percentage}% | ETA: {eta}s | {value}/{total}",
-      fps: 10,
-      ...options
-    };
-    this.composite = this.options.composite ?? false;
-    this.interactiveManager = interactiveManager;
-  }
-  /**
-   * Creates a new progress bar within this multi-bar manager.
-   * @param total Total value for the progress bar
-   * @param current Starting current value (default: 0)
-   * @param payload Optional initial payload data for format placeholders
-   * @returns The created progress bar instance
-   */
-  create(total, current = 0, payload) {
-    const barId = `bar_${String(this.nextBarId++)}`;
-    const bar = new MultiBarInstance(
-      this,
-      {
-        barCompleteChar: this.options.barCompleteChar,
-        barIncompleteChar: this.options.barIncompleteChar,
-        current,
-        format: this.options.format,
-        fps: this.options.fps,
-        total,
-        width: 40
-      },
-      payload
-    );
-    this.bars.set(barId, bar);
-    if (!this.isActive && this.interactiveManager) {
-      this.interactiveManager.hook();
-      this.isActive = true;
-      this.renderAll();
-    }
-    return bar;
-  }
-  /**
-   * Removes a progress bar from the manager.
-   * @param bar The progress bar instance to remove
-   * @returns True if the bar was removed, false if not found
-   */
-  remove(bar) {
-    for (const [id, existingBar] of this.bars.entries()) {
-      if (existingBar === bar) {
-        this.bars.delete(id);
-        if (this.bars.size === 0) {
-          if (this.interactiveManager) {
-            this.interactiveManager.unhook(false);
-          }
-          this.isActive = false;
-        } else {
-          this.renderAll();
-        }
-        return true;
-      }
-    }
-    return false;
-  }
-  /**
-   * Renders all progress bars.
-   */
-  renderAll() {
-    if (!this.interactiveManager || !this.isActive) {
-      return;
-    }
-    const lines = [];
-    if (this.composite) {
-      const barsArray = [...this.bars.values()];
-      if (barsArray.length > 0) {
-        const compositeOutput = this.renderComposite(barsArray);
-        lines.push(compositeOutput);
-      }
-    } else {
-      for (const bar of this.bars.values()) {
-        lines.push(bar.render());
-      }
-    }
-    this.interactiveManager.update("stdout", lines);
-  }
-  /**
-   * Sets or removes a color function for a specific bar.
-   * @param bar The progress bar instance to color (must be from this MultiProgressBar)
-   * @param color Color function or undefined to remove color
-   */
-  setBarColor(bar, color) {
-    for (const instance of this.bars.values()) {
-      if (instance === bar) {
-        if (color) {
-          this.barColors.set(instance, color);
-        } else {
-          this.barColors.delete(instance);
-        }
-        break;
-      }
-    }
-  }
-  /**
-   * Stops all progress bars and cleanup.
-   */
-  // eslint-disable-next-line sonarjs/no-identical-functions
-  stop() {
-    this.isActive = false;
-    if (this.interactiveManager) {
-      this.interactiveManager.unhook(false);
-    }
-  }
-  renderComposite(bars) {
-    if (bars.length === 0) {
-      return "";
-    }
-    const firstBar = bars[0];
-    if (!firstBar) {
-      return "";
-    }
-    const output = firstBar.render();
-    const barMatch = BAR_REGEX.exec(output);
-    if (!barMatch?.[1]) {
-      return output;
-    }
-    const width = barMatch[1].length;
-    const grid = Array.from({ length: width }, () => []);
-    bars.forEach((bar, index) => {
-      const state = bar.getBarState();
-      const filled = Math.round(state.current / state.total * width);
-      for (let i = 0; i < width; i += 1) {
-        if (i < filled) {
-          grid[i]?.push(index);
-        }
-      }
-    });
-    const composite = Array.from({ length: width }, (_, i) => this.getCompositeChar(bars, grid[i])).join("");
-    return output.replace(BAR_REGEX, `[${composite}]`);
-  }
-  getCompositeChar(bars, stack) {
-    if (!stack || stack.length === 0) {
-      const defaultBar = bars[0];
-      return defaultBar?.getBarState().char ?? "█";
-    }
-    let gradientKey;
-    if (this.options.style === "rect") {
-      gradientKey = "rect";
-    } else if (this.options.style === "braille") {
-      gradientKey = "braille";
-    } else {
-      gradientKey = "default";
-    }
-    const charGradient = CHAR_GRADIENTS[gradientKey];
-    const char = charGradient?.[Math.min(stack.length - 1, charGradient.length - 1)] ?? "█";
-    let selectedBar;
-    let smallestPercent = 100;
-    for (let j = 0; j < stack.length; j += 1) {
-      const stackBarIndex = stack[j];
-      const bar = bars[stackBarIndex];
-      if (!bar) {
-        continue;
-      }
-      const barState = bar.getBarState();
-      const barPercent = barState.current / barState.total * 100;
-      if (barPercent < smallestPercent || barPercent === smallestPercent && (selectedBar === void 0 || stackBarIndex > selectedBar)) {
-        smallestPercent = barPercent;
-        selectedBar = stackBarIndex;
-      }
-    }
-    const barIndex = selectedBar ?? stack[0];
-    const targetBar = bars[barIndex ?? 0];
-    if (!targetBar) {
-      return char;
-    }
-    const barColor = this.barColors.get(targetBar);
-    return barColor ? barColor(char) : char;
-  }
-}
-
-export { MultiBarInstance, MultiProgressBar, ProgressBar, applyStyleToOptions, getBarChar };

package/dist/reporter/file/utils/rotating-file-stream.d.ts

@@ -1,48 +0,0 @@
-import type { Options as RfsOptions } from "rotating-file-stream";
-/**
- * Rotating File Stream.
- *
- * A wrapper for the `rotating-file-stream` module that provides optional immediate
- * writing to disk by creating and closing a new stream on each write operation.
- * This is useful for ensuring log messages are written immediately rather than buffered.
- * @example
- * ```typescript
- * // Buffered writing (default)
- * const bufferedStream = new RotatingFileStream("/var/log/app.log", false, {
- *   interval: "1d",
- *   size: "10M"
- * });
- *
- * // Immediate writing
- * const immediateStream = new RotatingFileStream("/var/log/app.log", true, {
- *   interval: "1d"
- * });
- * ```
- */
-declare class RotatingFileStream {
-    #private;
-    /**
-     * Creates a new RotatingFileStream instance.
-     * @param filePath Path to the log file
-     * @param writeImmediately Whether to write immediately or buffer writes
-     * @param options Options for the rotating file stream
-     * @throws {Error} If the 'rotating-file-stream' package is not installed
-     */
-    constructor(filePath: string, writeImmediately?: boolean, options?: RfsOptions);
-    /**
-     * Writes a message to the rotating file stream.
-     *
-     * If writeImmediately was set to true in the constructor, a new stream
-     * is created for each write operation. Otherwise, uses the buffered stream.
-     * @param message The message to write to the file
-     */
-    write(message: string): void;
-    /**
-     * Ends the rotating file stream.
-     *
-     * Closes the underlying stream. When `writeImmediately` is not `true`,
-     * calling `write` after calling this method will throw an error.
-     */
-    end(): void;
-}
-export default RotatingFileStream;

package/dist/reporter/http/utils/compression.d.ts

@@ -1,7 +0,0 @@
-/**
- * Compresses data using gzip compression.
- * @param data The data to compress as a string
- * @returns A Promise that resolves to the compressed data as Uint8Array
- */
-declare const compressData: (data: string) => Promise<Uint8Array>;
-export default compressData;

package/dist/reporter/http/utils/log-size-error.d.ts

@@ -1,30 +0,0 @@
-/**
- * Error thrown when a log entry exceeds the maximum allowed size.
- */
-declare class LogSizeError extends Error {
-    /**
-     * The log entry data that caused the error
-     */
-    readonly logData: Record<string, unknown>;
-    /**
-     * The actual size of the log entry in bytes
-     */
-    readonly actualSize: number;
-    /**
-     * The maximum allowed size in bytes
-     */
-    readonly maxSize: number;
-    /**
-     * Creates a new LogSizeError instance.
-     * @param message Descriptive error message explaining the size violation
-     * @param logData The log entry data that caused the error
-     * @param actualSize Size of the log entry in bytes
-     * @param maxSize Maximum allowed size in bytes
-     * @example
-     * ```typescript
-     * throw new LogSizeError("Log too large", logData, 2000000, 1000000);
-     * ```
-     */
-    constructor(message: string, logData: Record<string, unknown>, actualSize: number, maxSize: number);
-}
-export default LogSizeError;