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

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

@@ -1,27 +0,0 @@
-/**
- * Sends an HTTP request with retry logic and rate limiting support.
- * @param url The URL to send the request to
- * @param method The HTTP method to use
- * @param headers Request headers
- * @param body The request body (string or Uint8Array)
- * @param maxRetries Maximum number of retry attempts
- * @param retryDelay Base delay between retries in milliseconds
- * @param respectRateLimit Whether to respect rate limiting (429 responses)
- * @param onDebugRequestResponse Optional callback for debugging requests/responses
- * @param onError Optional callback for error handling
- */
-declare const sendWithRetry: (url: string, method: string, headers: Record<string, string>, body: string | Uint8Array, maxRetries: number, retryDelay: number, respectRateLimit: boolean, onDebugRequestResponse?: (requestResponse: {
-    req: {
-        body: string | Uint8Array;
-        headers: Record<string, string>;
-        method: string;
-        url: string;
-    };
-    res: {
-        body: string;
-        headers: Record<string, string>;
-        status: number;
-        statusText: string;
-    };
-}) => void, onError?: (error: Error) => void) => Promise<void>;
-export default sendWithRetry;

package/dist/reporter/json/abstract-json-reporter.d.ts

@@ -1,61 +0,0 @@
-import type { stringify } from "safe-stable-stringify";
-import type { LiteralUnion } from "type-fest";
-import type { ExtendedRfc5424LogLevels, ReadonlyMeta, StringifyAwareReporter } from "../../types.d.ts";
-/**
- * Options for configuring JSON reporters.
- */
-export type AbstractJsonReporterOptions = {
-    /** Error serialization options */
-    error: Partial<{
-        /** Properties to exclude from error serialization */
-        exclude?: string[];
-        /** Maximum depth for error object serialization */
-        maxDepth?: number;
-        /** Whether to use toJSON methods during serialization */
-        useToJSON?: boolean;
-    }>;
-};
-/**
- * Abstract JSON Reporter.
- *
- * Base class for JSON-based reporters that provides common functionality
- * for serializing log metadata to JSON format. Handles error serialization,
- * context processing, and provides a template method for actual output.
- * @template L - The log level type
- * @example
- * ```typescript
- * class CustomJsonReporter extends AbstractJsonReporter {
- *   protected _log(message: string): void {
- *     console.log(message);
- *   }
- * }
- * ```
- */
-export declare abstract class AbstractJsonReporter<L extends string = string> implements StringifyAwareReporter<L> {
-    /** Custom stringify function for object serialization */
-    protected stringify: typeof stringify | undefined;
-    /** Error serialization options */
-    protected errorOptions: AbstractJsonReporterOptions["error"];
-    /**
-     * Creates a new AbstractJsonReporter instance.
-     * @param options Configuration options for JSON formatting and error handling
-     */
-    constructor(options?: Partial<AbstractJsonReporterOptions>);
-    /**
-     * Sets a custom stringify function for object serialization.
-     * @param function_ The stringify function to use for serialization
-     */
-    setStringify(function_: typeof stringify): void;
-    log(meta: ReadonlyMeta<L>): void;
-    /**
-     * Template method for outputting the JSON log message.
-     *
-     * Subclasses must implement this method to define how the JSON message
-     * is actually written (to console, file, network, etc.).
-     * @param message The JSON-formatted log message
-     * @param logLevel The log level of the message
-     * @protected
-     * @abstract
-     */
-    protected abstract _log(message: string, logLevel: LiteralUnion<ExtendedRfc5424LogLevels, L>): void;
-}

package/dist/reporter/json/json-reporter.browser.d.ts

@@ -1,40 +0,0 @@
-import type { LiteralUnion } from "type-fest";
-import type { ExtendedRfc5424LogLevels } from "../../types.d.ts";
-import type { AbstractJsonReporterOptions } from "./abstract-json-reporter.d.ts";
-import { AbstractJsonReporter } from "./abstract-json-reporter.d.ts";
-/**
- * Browser JSON Reporter.
- *
- * A JSON reporter for browser environments that outputs structured log data
- * to the browser console. Uses appropriate console methods based on log level.
- * @template L - The log level type
- * @example
- * ```typescript
- * import { createPail } from "@visulima/pail";
- *
- * const logger = createPail({
- *   reporters: [new JsonReporter()]
- * });
- *
- * logger.info("Application started", { version: "1.0.0" });
- * // Outputs: {"level":"info","message":"Application started","context":[{"version":"1.0.0"}],...}
- * ```
- */
-declare class JsonReporter<L extends string = string> extends AbstractJsonReporter<L> {
-    /**
-     * Creates a new Browser JSON Reporter instance.
-     * @param options Configuration options for JSON formatting
-     */
-    constructor(options?: Partial<AbstractJsonReporterOptions>);
-    /**
-     * 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
-     */
-    protected _log(message: string, logLevel: LiteralUnion<ExtendedRfc5424LogLevels, L>): void;
-}
-export default JsonReporter;

package/dist/reporter/json/json-reporter.server.d.ts

@@ -1,50 +0,0 @@
-import type { LiteralUnion } from "type-fest";
-import type { ExtendedRfc5424LogLevels, StreamAwareReporter } from "../../types.d.ts";
-import type { AbstractJsonReporterOptions } from "./abstract-json-reporter.d.ts";
-import { AbstractJsonReporter } from "./abstract-json-reporter.d.ts";
-/**
- * Server JSON Reporter.
- *
- * A JSON reporter for Node.js server environments that outputs structured log data
- * to stdout/stderr streams. Routes error-level logs to stderr and others to stdout.
- * @template L - The log level type
- * @example
- * ```typescript
- * import { createPail } from "@visulima/pail";
- *
- * const logger = createPail({
- *   reporters: [new JsonReporter()]
- * });
- *
- * logger.info("Server started", { port: 3000 });
- * logger.error("Database connection failed", error);
- * ```
- */
-declare class JsonReporter<L extends string = string> extends AbstractJsonReporter<L> implements StreamAwareReporter<L> {
-    #private;
-    /**
-     * Creates a new Server JSON Reporter instance.
-     * @param options Configuration options for JSON formatting
-     */
-    constructor(options?: Partial<AbstractJsonReporterOptions>);
-    /**
-     * Sets the stdout stream for the reporter.
-     * @param stdout_ The writable stream to use for stdout output
-     */
-    setStdout(stdout_: NodeJS.WriteStream): void;
-    /**
-     * Sets the stderr stream for the reporter.
-     * @param stderr_ The writable stream to use for stderr output
-     */
-    setStderr(stderr_: NodeJS.WriteStream): void;
-    /**
-     * 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
-     */
-    protected _log(message: string, logLevel: LiteralUnion<ExtendedRfc5424LogLevels, L>): void;
-}
-export default JsonReporter;

package/dist/reporter/pretty/abstract-pretty-reporter.d.ts

@@ -1,83 +0,0 @@
-import type { LiteralUnion } from "type-fest";
-import type { DefaultLogTypes, LoggerTypesAwareReporter, LoggerTypesConfig, ReadonlyMeta } from "../../types.d.ts";
-/**
- * Default date formatter for pretty reporters.
- *
- * Formats a Date object as HH:MM:SS (24-hour format).
- * @param date The date to format
- * @returns Formatted time string
- * @example
- * ```typescript
- * dateFormatter(new Date()); // "14:30:25"
- * ```
- */
-export declare const dateFormatter: (date: Date) => string;
-/**
- * Abstract Pretty Reporter.
- *
- * Base class for pretty-printing reporters that format log messages with colors,
- * styles, and structured layout. Provides common functionality for styling options
- * and logger type configuration.
- * @template T - Custom logger type names
- * @template L - Log level types
- * @example
- * ```typescript
- * class CustomPrettyReporter extends AbstractPrettyReporter {
- *   public log(meta: ReadonlyMeta) {
- *     const formatted = this.formatMessage(meta);
- *     console.log(formatted);
- *   }
- * }
- * ```
- */
-export declare abstract class AbstractPrettyReporter<T extends string = string, L extends string = string> implements LoggerTypesAwareReporter<T, L> {
-    /** Styling options for pretty formatting */
-    protected readonly styles: PrettyStyleOptions;
-    /** Logger type configurations for styling */
-    protected loggerTypes: LoggerTypesConfig<LiteralUnion<DefaultLogTypes, T>, L>;
-    /**
-     * Creates a new AbstractPrettyReporter instance.
-     * @param options Styling options for pretty formatting
-     * @protected
-     */
-    protected constructor(options: Partial<PrettyStyleOptions>);
-    /**
-     * Sets the logger types configuration for styling.
-     * @param types Logger type configurations with colors and labels
-     */
-    setLoggerTypes(types: LoggerTypesConfig<LiteralUnion<DefaultLogTypes, T>, L>): void;
-    /**
-     * Logs a message with pretty formatting.
-     * @param meta The log metadata to format and output
-     * @abstract
-     */
-    abstract log(meta: ReadonlyMeta<L>): void;
-}
-/**
- * Options for configuring pretty reporter styling.
- */
-export type PrettyStyleOptions = {
-    /** Bold styling options */
-    bold: {
-        /** Whether to bold the label text */
-        label: boolean;
-    };
-    /** Function to format dates in log output */
-    dateFormatter: (date: Date) => string;
-    /** Maximum length of message before line break (optional) */
-    messageLength: number | undefined;
-    /** Underline styling options */
-    underline: {
-        /** Whether to underline the label */
-        label: boolean;
-        /** Whether to underline prefixes */
-        prefix: boolean;
-        /** Whether to underline suffixes */
-        suffix: boolean;
-    };
-    /** Uppercase styling options */
-    uppercase: {
-        /** Whether to uppercase the label text */
-        label: boolean;
-    };
-};

package/dist/reporter/pretty/pretty-reporter.browser.d.ts

@@ -1,36 +0,0 @@
-import type { ReadonlyMeta } from "../../types.d.ts";
-import type { PrettyStyleOptions } from "./abstract-pretty-reporter.d.ts";
-import { AbstractPrettyReporter } from "./abstract-pretty-reporter.d.ts";
-/**
- * Browser Pretty Reporter.
- *
- * A pretty-printing reporter for browser environments that formats log messages
- * with colors and structured layout for console output. Uses browser-compatible
- * color formatting and console APIs.
- * @template T - Custom logger type names
- * @template L - Log level types
- * @example
- * ```typescript
- * import { createPail } from "@visulima/pail";
- *
- * const logger = createPail({
- *   reporters: [new PrettyReporter({
- *     bold: { label: true },
- *     uppercase: { label: true }
- *   })]
- * });
- *
- * logger.info("Application started");
- * logger.error("Something went wrong", error);
- * ```
- */
-declare class PrettyReporter<T extends string = string, L extends string = string> extends AbstractPrettyReporter<T, L> {
-    #private;
-    /**
-     * Creates a new Browser Pretty Reporter instance.
-     * @param options Styling options for pretty formatting
-     */
-    constructor(options?: Partial<PrettyStyleOptions>);
-    log(meta: ReadonlyMeta<L>): void;
-}
-export default PrettyReporter;

package/dist/reporter/pretty/pretty-reporter.server.d.ts

@@ -1,70 +0,0 @@
-import type { RenderErrorOptions } from "@visulima/error/error";
-import type { Options as InspectorOptions } from "@visulima/inspector";
-import type { LiteralUnion } from "type-fest";
-import type InteractiveManager from "../../interactive/interactive-manager.d.ts";
-import type { ExtendedRfc5424LogLevels, InteractiveStreamReporter, ReadonlyMeta } from "../../types.d.ts";
-import type { PrettyStyleOptions } from "./abstract-pretty-reporter.d.ts";
-import { AbstractPrettyReporter } from "./abstract-pretty-reporter.d.ts";
-/**
- * Options for configuring the Server Pretty Reporter.
- */
-export type PrettyReporterOptions = PrettyStyleOptions & {
-    /** Error rendering options */
-    error: Partial<Omit<RenderErrorOptions, "color" | "prefix" | "indentation">>;
-    /** Object inspection options */
-    inspect: Partial<InspectorOptions>;
-};
-/**
- * Server Pretty Reporter.
- *
- * A comprehensive pretty-printing reporter for Node.js server environments that
- * formats log messages with colors, structured layout, and advanced features like
- * error rendering, object inspection, and interactive terminal support.
- * @template T - Custom logger type names
- * @template L - Log level types
- * @example
- * ```typescript
- * import { createPail } from "@visulima/pail";
- *
- * const logger = createPail({
- *   reporters: [new PrettyReporter({
- *     bold: { label: true },
- *     error: { color: { title: 'red' } }
- *   })]
- * });
- *
- * logger.info("Server started on port 3000");
- * logger.error("Database error", dbError);
- * ```
- */
-export declare class PrettyReporter<T extends string = string, L extends string = string> extends AbstractPrettyReporter<T, L> implements InteractiveStreamReporter<L> {
-    #private;
-    /**
-     * Creates a new Server Pretty Reporter instance.
-     * @param options Configuration options for styling, error rendering, and object inspection
-     */
-    constructor(options?: Partial<PrettyReporterOptions>);
-    /**
-     * Sets the stdout stream for the reporter.
-     * @param stdout_ The writable stream to use for standard output
-     */
-    setStdout(stdout_: NodeJS.WriteStream): void;
-    /**
-     * Sets the stderr stream for the reporter.
-     * @param stderr_ The writable stream to use for error output
-     */
-    setStderr(stderr_: NodeJS.WriteStream): void;
-    /**
-     * Sets the interactive manager for handling interactive output.
-     * @param manager The interactive manager instance, or undefined to disable
-     */
-    setInteractiveManager(manager?: InteractiveManager): void;
-    /**
-     * Enables or disables interactive mode.
-     * @param interactive Whether to enable interactive terminal features
-     */
-    setIsInteractive(interactive: boolean): void;
-    log(meta: ReadonlyMeta<L>): void;
-    protected _formatMessage(data: ReadonlyMeta<L>): string;
-    protected _log(message: string, logLevel: LiteralUnion<ExtendedRfc5424LogLevels, L>): void;
-}

package/dist/reporter/raw/raw-reporter.browser.d.ts

@@ -1,5 +0,0 @@
-import type { ReadonlyMeta, Reporter } from "../../types.d.ts";
-declare class RawReporter<L extends string = string> implements Reporter<L> {
-    log(meta: ReadonlyMeta<L>): void;
-}
-export default RawReporter;

package/dist/reporter/raw/raw-reporter.server.d.ts

@@ -1,13 +0,0 @@
-import type { Options as InspectorOptions } from "@visulima/inspector";
-import type InteractiveManager from "../../interactive/interactive-manager.d.ts";
-import type { ReadonlyMeta, StreamAwareReporter } from "../../types.d.ts";
-declare class RawReporter<L extends string = string> implements StreamAwareReporter<L> {
-    #private;
-    constructor(inspectOptions?: Partial<InspectorOptions>);
-    setStdout(stdout_: NodeJS.WriteStream): void;
-    setStderr(stderr_: NodeJS.WriteStream): void;
-    setInteractiveManager(manager?: InteractiveManager): void;
-    setIsInteractive(interactive: boolean): void;
-    log(meta: ReadonlyMeta<L>): void;
-}
-export default RawReporter;

package/dist/reporter/utils/default-inspector-config.d.ts

@@ -1,3 +0,0 @@
-import type { Options } from "@visulima/inspector";
-declare const defaultInspectorConfig: Partial<Options>;
-export default defaultInspectorConfig;

package/dist/reporter/utils/format-label.d.ts

@@ -1,3 +0,0 @@
-import type { PrettyStyleOptions } from "../pretty/abstract-pretty-reporter.d.ts";
-declare const formatLabel: (label: string, styles: PrettyStyleOptions) => string;
-export default formatLabel;

package/dist/spinner.d.ts

@@ -1,220 +0,0 @@
-import type { SpinnerName } from "cli-spinners";
-import type InteractiveManager from "./interactive/interactive-manager.d.ts";
-/**
- * Spinner style configuration using colorize.
- */
-export interface SpinnerStyle {
-    /** Background color name (e.g., "bgRed", "bgBlue") */
-    bgColor?: string;
-    /** Background color as hex (e.g., "#FF0000") */
-    bgHex?: `#${string}`;
-    /** Background color as RGB (e.g., [255, 0, 0]) */
-    bgRgb?: [number, number, number];
-    /** Apply bold style */
-    bold?: boolean;
-    /** Foreground color name (e.g., "red", "blue", "green") */
-    color?: string;
-    /** Apply dim/faint style */
-    dim?: boolean;
-    /** Foreground color as hex (e.g., "#FF0000") */
-    hex?: `#${string}`;
-    /** Apply inverse style (swap fg/bg) */
-    inverse?: boolean;
-    /** Apply italic style */
-    italic?: boolean;
-    /** Apply overline style */
-    overline?: boolean;
-    /** Foreground color as RGB (e.g., [255, 0, 0]) */
-    rgb?: [number, number, number];
-    /** Apply strikethrough style */
-    strikethrough?: boolean;
-    /** Apply underline style */
-    underline?: boolean;
-}
-/**
- * Spinner completion icons.
- */
-export interface SpinnerIcons {
-    /** Icon to show on failure (default: "✖") */
-    error?: string;
-    /** Icon to show on info (default: "ℹ") */
-    info?: string;
-    /** Icon to show on success (default: "✓") */
-    success?: string;
-    /** Icon to show on warning (default: "⚠") */
-    warning?: string;
-}
-/**
- * Spinner style options.
- */
-export interface SpinnerOptions {
-    /** Custom icons for completion states */
-    icons?: SpinnerIcons;
-    /** Name of the spinner from cli-spinners */
-    name?: SpinnerName;
-    /** Prefix text to show before the spinner */
-    prefixText?: string;
-    /** Style configuration for the spinner */
-    style?: SpinnerStyle;
-    /** Whether to output spinner (default: true) */
-    verbose?: boolean;
-}
-/**
- * Options for starting a spinner.
- */
-export interface SpinnerStartOptions {
-    /** Prefix text to show before the spinner */
-    prefixText?: string;
-}
-/**
- * Spinner class for creating loading indicators in terminal applications.
- *
- * Provides an easy-to-use interface for displaying spinners with various styles
- * from the cli-spinners library. Works seamlessly with interactive terminal features.
- * @example
- * ```typescript
- * const spinner = new Spinner({ name: "dots" });
- * spinner.start("Loading...");
- * // ... do work ...
- * spinner.succeed("Done!");
- * ```
- */
-export declare class Spinner {
-    #private;
-    /**
-     * Creates a new Spinner instance.
-     * @param options Configuration options for the spinner
-     * @param interactiveManager Optional interactive manager for terminal control
-     */
-    constructor(options?: SpinnerOptions, interactiveManager?: InteractiveManager);
-    /**
-     * Current elapsed time in milliseconds.
-     */
-    get elapsedTime(): number;
-    /**
-     * Get or set the spinner text.
-     */
-    get getText(): string;
-    set text(value: string);
-    /**
-     * Get or set the prefix text.
-     */
-    get getPrefixText(): string;
-    set prefixText(value: string);
-    /**
-     * Whether the spinner is currently active.
-     */
-    get isRunning(): boolean;
-    /**
-     * Set the interactive manager for interactive mode.
-     * @internal
-     */
-    setInteractiveManager(manager?: InteractiveManager): void;
-    /**
-     * Set the multi spinner reference.
-     * @internal
-     */
-    setMultiSpinner(multiSpinner?: MultiSpinner): void;
-    /**
-     * Start the spinner with optional text.
-     * @param text Optional text to display
-     * @param options
-     * @param options.prefixText Optional prefix text to display
-     * @returns The spinner instance for chaining
-     */
-    start(text?: string, options?: SpinnerStartOptions): this;
-    /**
-     * Stop the spinner with a success message.
-     * @param text Optional success text
-     */
-    succeed(text?: string): void;
-    /**
-     * Stop the spinner with a failure message.
-     * @param text Optional failure text
-     */
-    failed(text?: string): void;
-    /**
-     * Stop the spinner with a warning message.
-     * @param text Optional warning text
-     */
-    warn(text?: string): void;
-    /**
-     * Stop the spinner with an info message.
-     * @param text Optional info text
-     */
-    info(text?: string): void;
-    /**
-     * Pause the spinner without stopping it.
-     */
-    pause(): void;
-    /**
-     * Resume the spinner if it was paused.
-     */
-    resume(): void;
-    /**
-     * Get current frame output.
-     * @internal
-     */
-    getFrameOutput(): string;
-}
-/**
- * Multi-Spinner class for managing multiple spinners concurrently.
- *
- * Allows displaying and updating multiple spinners simultaneously with
- * consistent formatting and management.
- * @example
- * ```typescript
- * const multiSpinner = new MultiSpinner({ name: "dots" });
- *
- * const spinner1 = multiSpinner.create("Task 1");
- * const spinner2 = multiSpinner.create("Task 2");
- *
- * spinner1.start();
- * spinner2.start();
- *
- * // ... do work ...
- *
- * spinner1.succeed();
- * spinner2.succeed();
- * multiSpinner.stop();
- * ```
- */
-export declare class MultiSpinner {
-    #private;
-    constructor(options?: SpinnerOptions, interactiveManager?: InteractiveManager);
-    /**
-     * Set the interactive manager for interactive mode.
-     * @internal
-     */
-    setInteractiveManager(manager?: InteractiveManager): void;
-    /**
-     * Create a new spinner instance.
-     * @param text Initial text for the spinner
-     * @param options
-     * @param options.prefixText Optional prefix text to display
-     * @param options.style Optional style for the spinner
-     * @param options.verbose Whether to output spinner (default: true)
-     * @returns A new Spinner instance
-     */
-    create(text?: string, options?: SpinnerOptions): Spinner;
-    /**
-     * Remove a spinner from the multi-spinner manager.
-     * @param spinner The spinner to remove
-     * @returns True if the spinner was removed, false otherwise
-     */
-    remove(spinner: Spinner): boolean;
-    /**
-     * Stop all spinners.
-     */
-    stop(): void;
-    /**
-     * Clear all spinners without stopping them.
-     */
-    clear(): void;
-    /**
-     * Render all spinners.
-     * @internal
-     */
-    renderAll(): void;
-}
-export type SpinnerType<T extends string = string, L extends string = string> = Record<T, L> & Spinner;