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

package/dist/packem_shared/{write-stream-BuFtjATz.js → write-stream-MDqyXmc_.js}

@@ -1,5 +1,5 @@
 const writeStream = (data, stream) => {
-  const write = stream.__write ?? stream.write.bind(stream);
+  const write = stream["__write"] ?? stream.write.bind(stream);
   return write.call(stream, data);
 };
 

package/dist/pail.server.d.ts

@@ -1,9 +1,5 @@
-import InteractiveManager from "./interactive/interactive-manager.d.ts";
+import { InteractiveManager } from "@visulima/interactive-manager";
 import { PailBrowserImpl } from "./pail.d.ts";
-import type { MultiBarOptions, SingleBarOptions } from "./progress-bar.d.ts";
-import { MultiProgressBar, ProgressBar } from "./progress-bar.d.ts";
-import type { SpinnerOptions } from "./spinner.d.ts";
-import { MultiSpinner, Spinner } from "./spinner.d.ts";
 import type { ConstructorOptions, DefaultLogTypes, LoggerFunction, Reporter, ServerConstructorOptions } from "./types.d.ts";
 declare class PailServerImpl<T extends string = string, L extends string = string> extends PailBrowserImpl<T, L> {
     #private;
@@ -138,77 +134,6 @@ declare class PailServerImpl<T extends string = string, L extends string = strin
      * ```
      */
     restoreAll(): void;
-    /**
-     * Creates a single progress bar.
-     * @param options Configuration options for the progress bar
-     * @returns A new ProgressBar instance
-     * @example
-     * ```typescript
-     * const logger = createPail({ interactive: true });
-     * const bar = logger.createProgressBar({
-     *   total: 100,
-     *   format: 'Downloading [{bar}] {percentage}% | ETA: {eta}s | {value}/{total}'
-     * });
-     *
-     * bar.start();
-     * // ... do work and update progress
-     * bar.update(50);
-     * bar.stop();
-     * ```
-     */
-    createProgressBar(options: SingleBarOptions): ProgressBar;
-    /**
-     * Creates a multi-bar progress manager for displaying multiple progress bars.
-     * @param options Configuration options for the multi-bar manager
-     * @returns A new MultiProgressBar instance
-     * @example
-     * ```typescript
-     * const logger = createPail({ interactive: true });
-     * const multiBar = logger.createMultiProgressBar();
-     *
-     * const bar1 = multiBar.create(100);
-     * const bar2 = multiBar.create(200);
-     *
-     * bar1.start();
-     * bar2.start();
-     * // ... update bars as needed
-     * multiBar.stop();
-     * ```
-     */
-    createMultiProgressBar(options?: MultiBarOptions): MultiProgressBar;
-    /**
-     * Creates a single spinner.
-     * @param options Configuration options for the spinner
-     * @returns A new Spinner instance
-     * @example
-     * ```typescript
-     * const logger = createPail({ interactive: true });
-     * const spinner = logger.createSpinner({ name: 'dots' });
-     * spinner.start('Loading...');
-     * // ... do work
-     * spinner.succeed('Done');
-     * ```
-     */
-    createSpinner(options?: SpinnerOptions): Spinner;
-    /**
-     * Creates a multi-spinner manager for displaying multiple spinners.
-     * @param options Configuration options for the multi-spinner manager
-     * @returns A new MultiSpinner instance
-     * @example
-     * ```typescript
-     * const logger = createPail({ interactive: true });
-     * const multiSpinner = logger.createMultiSpinner();
-     *
-     * const spinner1 = multiSpinner.create('Loading 1');
-     * const spinner2 = multiSpinner.create('Loading 2');
-     *
-     * spinner1.start();
-     * spinner2.start();
-     * // ... update spinners as needed
-     * multiSpinner.stop();
-     * ```
-     */
-    createMultiSpinner(options?: SpinnerOptions): MultiSpinner;
     /**
      * Clears the terminal screen.
      *

package/dist/processor/caller/caller-processor.js

@@ -18,7 +18,7 @@ const getCallerFilename = () => {
       });
       return accumulator;
     }, []);
-    const firstExternalFilePath = callers[0];
+    const firstExternalFilePath = callers.at(0);
     if (firstExternalFilePath) {
       return {
         columnNumber: firstExternalFilePath.columnNumber ?? void 0,

package/dist/processor/environment-processor.js

@@ -14,11 +14,18 @@ const detectEnvironment = () => {
     // PID
     pid: process.pid,
     // Region (including GCP Cloud Functions FUNCTION_REGION and GOOGLE_CLOUD_REGION)
-    region: env.AWS_REGION || env.VERCEL_REGION || env.FLY_REGION || env.RENDER_REGION || env.CF_REGION || env.GOOGLE_CLOUD_REGION || env.FUNCTION_REGION || void 0,
+    region: env.AWS_REGION || env.VERCEL_REGION || env.FLY_REGION || env.RENDER_REGION || env.CF_REGION || env.GOOGLE_CLOUD_REGION || // GCP general
+    env.FUNCTION_REGION || // GCP Cloud Functions
+    void 0,
     // Service name - check common platform variables (including GCP Cloud Run / App Engine)
-    service: env.SERVICE_NAME || env.APP_NAME || env.K_SERVICE || env.GAE_SERVICE || env.FUNCTION_TARGET || env.VERCEL_PROJECT_PRODUCTION_URL || env.FLY_APP_NAME || env.RAILWAY_SERVICE_NAME || env.RENDER_SERVICE_NAME || env.HEROKU_APP_NAME || void 0,
+    service: env.SERVICE_NAME || env.APP_NAME || env.K_SERVICE || // GCP Cloud Run
+    env.GAE_SERVICE || // GCP App Engine
+    env.FUNCTION_TARGET || // GCP Cloud Functions
+    env.VERCEL_PROJECT_PRODUCTION_URL || env.FLY_APP_NAME || env.RAILWAY_SERVICE_NAME || env.RENDER_SERVICE_NAME || env.HEROKU_APP_NAME || void 0,
     // Version (including GCP Cloud Run K_REVISION and App Engine GAE_VERSION)
-    version: env.APP_VERSION || env.npm_package_version || env.K_REVISION || env.GAE_VERSION || env.RAILWAY_GIT_COMMIT_SHA?.slice(0, 7) || env.RENDER_GIT_COMMIT?.slice(0, 7) || void 0
+    version: env.APP_VERSION || env.npm_package_version || env.K_REVISION || // GCP Cloud Run revision
+    env.GAE_VERSION || // GCP App Engine version
+    env.RAILWAY_GIT_COMMIT_SHA?.slice(0, 7) || env.RENDER_GIT_COMMIT?.slice(0, 7) || void 0
     /* eslint-enable @typescript-eslint/no-unnecessary-condition, @typescript-eslint/prefer-nullish-coalescing */
   };
   return Object.fromEntries(Object.entries(info).filter(([, v]) => v !== void 0));

package/dist/reporter/file/json-file-reporter.js

@@ -1,4 +1,4 @@
-import { AbstractJsonReporter } from '../../packem_shared/AbstractJsonReporter-CjtVgHbU.js';
+import { AbstractJsonReporter } from '../../packem_shared/AbstractJsonReporter-nOj0Ft1F.js';
 
 class SafeStreamHandler {
   #ready = true;

package/dist/reporter/http/abstract-http-reporter.js

@@ -20,7 +20,7 @@ const __cjs_getBuiltinModule = (module) => {
 const {
   Buffer
 } = __cjs_getBuiltinModule("node:buffer");
-import { AbstractJsonReporter } from '../../packem_shared/AbstractJsonReporter-CjtVgHbU.js';
+import { AbstractJsonReporter } from '../../packem_shared/AbstractJsonReporter-nOj0Ft1F.js';
 const {
   gzipSync
 } = __cjs_getBuiltinModule("node:zlib");

package/dist/reporter/http/http-reporter.edge-light.js

@@ -284,11 +284,7 @@ class AbstractJsonReporter {
     if (file) {
       rest.file = `${file.name ?? ""}:${String(file.line)}${file.column ? `:${String(file.column)}` : ""}`;
     }
-    if (message === EMPTY_SYMBOL) {
-      rest.message = void 0;
-    } else {
-      rest.message = message;
-    }
+    rest.message = message === EMPTY_SYMBOL ? void 0 : message;
     if (error) {
       rest.error = serialize(error, this.errorOptions);
     }

package/dist/reporter/json/index.browser.js

@@ -1,2 +1,2 @@
-export { AbstractJsonReporter } from '../../packem_shared/AbstractJsonReporter-DlugSJpY.js';
-export { default as JsonReporter } from '../../packem_shared/JsonReporter-Dbw82ewj.js';
+export { AbstractJsonReporter } from '../../packem_shared/AbstractJsonReporter-BO8Calb4.js';
+export { default as JsonReporter } from '../../packem_shared/JsonReporter-CCmj7oYL.js';

package/dist/reporter/json/index.js

@@ -1,2 +1,2 @@
-export { AbstractJsonReporter } from '../../packem_shared/AbstractJsonReporter-CjtVgHbU.js';
-export { default as JsonReporter } from '../../packem_shared/JsonReporter-BgPvIyC2.js';
+export { AbstractJsonReporter } from '../../packem_shared/AbstractJsonReporter-nOj0Ft1F.js';
+export { default as JsonReporter } from '../../packem_shared/JsonReporter-Ck2PIAEw.js';

package/dist/reporter/pretty/index.browser.js

@@ -1 +1 @@
-export { default as PrettyReporter } from '../../packem_shared/PrettyReporter-C2dCzIaf.js';
+export { default as PrettyReporter } from '../../packem_shared/PrettyReporter-BtTr13Ha.js';

package/dist/reporter/pretty/index.js

@@ -1 +1 @@
-export { PrettyReporter } from '../../packem_shared/PrettyReporter-gMqa7j_m.js';
+export { PrettyReporter } from '../../packem_shared/PrettyReporter-BCvyNzXO.js';

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

@@ -1,7 +1,7 @@
 import type { RenderErrorOptions } from "@visulima/error/error";
 import type { Options as InspectorOptions } from "@visulima/inspector";
+import type { InteractiveManager } from "@visulima/interactive-manager";
 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";

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

@@ -1,5 +1,5 @@
 import type { Options as InspectorOptions } from "@visulima/inspector";
-import type InteractiveManager from "../../interactive/interactive-manager.d.ts";
+import type { InteractiveManager } from "@visulima/interactive-manager";
 import type { ReadonlyMeta, StreamAwareReporter } from "../../types.d.ts";
 declare class RawReporter<L extends string = string> implements StreamAwareReporter<L> {
     #private;

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

@@ -1,6 +1,6 @@
 import type { RenderErrorOptions } from "@visulima/error";
 import type { Options as InspectorOptions } from "@visulima/inspector";
-import type InteractiveManager from "../../interactive/interactive-manager.d.ts";
+import type { InteractiveManager } from "@visulima/interactive-manager";
 import type { InteractiveStreamReporter, ReadonlyMeta } from "../../types.d.ts";
 import type { PrettyStyleOptions } from "../pretty/abstract-pretty-reporter.d.ts";
 import { AbstractPrettyReporter } from "../pretty/abstract-pretty-reporter.d.ts";

package/dist/reporter/simple/simple-reporter.server.js

@@ -9,7 +9,7 @@ const {
   stderr
 } = __cjs_getProcess;
 import colorize, { red, greenBright, cyan, green, grey, bold, bgGrey, underline, white } from '@visulima/colorize';
-import { A as AbstractPrettyReporter, d as defaultInspectorConfig, b as writeStream, t as terminalSize, c as getLongestBadge, g as getLongestLabel, e as getStringWidth, f as formatLabel, a as EMPTY_SYMBOL, i as inspect, w as wordWrap, r as renderError, W as WrapMode } from '../../packem_shared/abstract-pretty-reporter-szQO-IgK.js';
+import { A as AbstractPrettyReporter, d as defaultInspectorConfig, w as writeStream, t as terminalSize, b as getLongestBadge, g as getLongestLabel, c as getStringWidth, f as formatLabel, a as EMPTY_SYMBOL, i as inspect, e as wordWrap, r as renderError, W as WrapMode } from '../../packem_shared/abstract-pretty-reporter-CXAKYCb8.js';
 
 const PAIL_DIST_REGEX = /[\\/]pail[\\/]dist/;
 const pailFileFilter = (line) => !PAIL_DIST_REGEX.test(line);

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 import type { AnsiColors } from "@visulima/colorize";
+import type { InteractiveManager } from "@visulima/interactive-manager";
 import type { stringify } from "safe-stable-stringify";
 import type { LiteralUnion, Primitive } from "type-fest";
-import type InteractiveManager from "./interactive/interactive-manager.d.ts";
 /**
  * Global namespace for extending Pail's metadata interface.
  *

package/dist/utils/write-console-log-based-on-level.d.ts

@@ -1,4 +1,4 @@
 import type { LiteralUnion } from "type-fest";
 import type { ExtendedRfc5424LogLevels } from "../types.d.ts";
-declare const writeConsoleLogBasedOnLevel: <L extends string = string>(level: LiteralUnion<ExtendedRfc5424LogLevels, L>) => (...data: any[]) => void;
+declare const writeConsoleLogBasedOnLevel: <L extends string = string>(level: LiteralUnion<ExtendedRfc5424LogLevels, L>) => ((...data: any[]) => void);
 export default writeConsoleLogBasedOnLevel;

package/dist/wide-event.d.ts

@@ -140,7 +140,7 @@ export declare class WideEvent<TData extends Record<string, unknown> = Record<st
     private readonly startTime;
     private status;
     private readonly timestamp;
-    private readonly type;
+    private readonly _type;
     constructor(options: WideEventOptions<T>);
     /**
      * Record a debug-level lifecycle log entry.

package/dist/wide-event.js

@@ -66,7 +66,8 @@ class WideEvent {
   startTime;
   status;
   timestamp;
-  type;
+  // @ts-expect-error TS6133 -- preserved for future use (richer event categorization)
+  _type;
   constructor(options) {
     this.name = options.name;
     this.pail = options.pail;
@@ -75,7 +76,7 @@ class WideEvent {
     this.timestamp = (/* @__PURE__ */ new Date()).toISOString();
     this.emitted = false;
     this.autoEmit = options.autoEmit ?? true;
-    this.type = options.type ?? "info";
+    this._type = options.type ?? "info";
     this.level = "info";
     this.requestLogs = [];
     this.service = options.service;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/pail",
-  "version": "4.0.0-alpha.10",
+  "version": "4.0.0-alpha.11",
   "description": "Highly configurable Logger for Node.js, Edge and Browser.",
   "keywords": [
     "ansi",
@@ -190,18 +190,6 @@
         "default": "./dist/reporter/http/http-reporter.js"
       }
     },
-    "./progress-bar": {
-      "types": "./dist/progress-bar.d.ts",
-      "default": "./dist/progress-bar.js"
-    },
-    "./spinner": {
-      "types": "./dist/spinner.d.ts",
-      "default": "./dist/spinner.js"
-    },
-    "./interactive": {
-      "types": "./dist/interactive/index.d.ts",
-      "default": "./dist/interactive/index.js"
-    },
     "./object-tree": {
       "types": "./dist/object-tree.d.ts",
       "default": "./dist/object-tree.js"
@@ -243,13 +231,14 @@
     "LICENSE.md"
   ],
   "dependencies": {
-    "@visulima/colorize": "2.0.0-alpha.8",
-    "type-fest": "5.5.0"
+    "@visulima/colorize": "2.0.0-alpha.10",
+    "@visulima/interactive-manager": "1.0.0-alpha.2",
+    "type-fest": "5.6.0"
   },
   "peerDependencies": {
     "@opentelemetry/api": "1.9.1",
     "@sveltejs/kit": ">=2.0",
-    "@visulima/redact": "3.0.0-alpha.8",
+    "@visulima/redact": "3.0.0-alpha.10",
     "elysia": ">=1.0",
     "express": ">=4.0",
     "fastify": ">=4.0",
@@ -287,7 +276,7 @@
     }
   },
   "engines": {
-    "node": ">=22.13 <=25.x"
+    "node": "^22.14.0 || >=24.10.0"
   },
   "os": [
     "darwin",

package/dist/interactive/index.d.ts

@@ -1,2 +0,0 @@
-export { default as InteractiveManager } from "./interactive-manager.d.ts";
-export { default as InteractiveStreamHook } from "./interactive-stream-hook.d.ts";

package/dist/interactive/index.js

@@ -1,2 +0,0 @@
-export { default as InteractiveManager } from '../packem_shared/InteractiveManager-CowYA3Hx.js';
-export { default as InteractiveStreamHook } from '../packem_shared/InteractiveStreamHook-BypRlYTX.js';

package/dist/interactive/interactive-manager.d.ts

@@ -1,108 +0,0 @@
-import type InteractiveStreamHook from "./interactive-stream-hook.d.ts";
-/** Supported stream types for interactive output */
-type StreamType = "stderr" | "stdout";
-/**
- * Interactive Manager.
- *
- * Manages interactive terminal output by coordinating stdout and stderr streams.
- * Enables features like progress bars, spinners, and dynamic updates by temporarily
- * capturing and controlling terminal output. Supports suspending and resuming
- * interactive mode for external output.
- * @example
- * ```typescript
- * const manager = new InteractiveManager(stdoutHook, stderrHook);
- *
- * // Start interactive mode
- * manager.hook();
- *
- * // Update output dynamically
- * manager.update("stdout", ["Processing...", "50% complete"]);
- *
- * // Temporarily suspend for external output
- * manager.suspend("stdout");
- * console.log("External message");
- * manager.resume("stdout");
- *
- * // End interactive mode and show final output
- * manager.unhook();
- * ```
- */
-declare class InteractiveManager {
-    #private;
-    /**
-     * Creates a new InteractiveManager with the given stream hooks.
-     * @param stdout Hook for stdout stream
-     * @param stderr Hook for stderr stream
-     */
-    constructor(stdout: InteractiveStreamHook, stderr: InteractiveStreamHook);
-    /**
-     * 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(): number;
-    /**
-     * 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(): number;
-    /**
-     * Hook activity status.
-     *
-     * Indicates whether the interactive hooks are currently active.
-     * When true, streams are being intercepted for interactive output.
-     */
-    get isHooked(): boolean;
-    /**
-     * Suspend status for active hooks.
-     *
-     * Indicates whether interactive mode is temporarily suspended.
-     * When suspended, external output can be written without interference.
-     */
-    get isSuspended(): boolean;
-    /**
-     * 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: StreamType, count?: number): void;
-    /**
-     * Hook stdout and stderr streams.
-     * @returns Success status
-     */
-    hook(): boolean;
-    /**
-     * Resume suspend hooks.
-     * @param stream Stream to resume
-     * @param eraseRowCount erase output rows count
-     */
-    resume(stream: StreamType, eraseRowCount?: number): void;
-    /**
-     * Suspend active hooks for external output.
-     * @param stream Stream to suspend
-     * @param erase erase output
-     */
-    suspend(stream: StreamType, erase?: boolean): void;
-    /**
-     * 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?: boolean): boolean;
-    /**
-     * 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: StreamType, rows: string[], from?: number): void;
-}
-export default InteractiveManager;

package/dist/interactive/interactive-stream-hook.d.ts

@@ -1,68 +0,0 @@
-/**
- * Interactive Stream Hook.
- *
- * A utility class that hooks into Node.js WriteStreams to capture output
- * for interactive terminal applications. It allows temporarily intercepting
- * stream writes to enable features like progress bars and dynamic updates.
- * @example
- * ```typescript
- * const hook = new InteractiveStreamHook(process.stdout);
- * hook.active(); // Start capturing output
- *
- * // Output will be stored in history instead of being written to stdout
- * console.log("This won't appear immediately");
- *
- * hook.inactive(); // Stop capturing and replay stored output
- * ```
- */
-declare class InteractiveStreamHook {
-    #private;
-    /** Constant indicating the stream write operation was successful */
-    static readonly DRAIN = true;
-    /**
-     * Creates a new InteractiveStreamHook for the given stream.
-     * @param stream The Node.js WriteStream to hook into (usually stdout or stderr)
-     */
-    constructor(stream: NodeJS.WriteStream);
-    /**
-     * Activates the stream hook.
-     *
-     * When active, all writes to the stream are captured in history instead of
-     * being written immediately. This allows for interactive features like
-     * progress bars that can update dynamically.
-     */
-    active(): void;
-    /**
-     * Erases the specified number of lines from the terminal.
-     *
-     * Uses ANSI escape sequences to remove lines from the current cursor position
-     * upwards, which is useful for clearing previous output in interactive applications.
-     * @param count Number of lines to erase (including the current line)
-     */
-    erase(count: number): void;
-    /**
-     * Deactivates the stream hook and replays captured output.
-     *
-     * Restores normal stream operation and outputs all captured history.
-     * Optionally adds a newline separator before replaying the history.
-     * @param separateHistory Whether to add a newline before replaying history
-     */
-    inactive(separateHistory?: boolean): void;
-    /**
-     * Renews the stream hook state.
-     *
-     * Restores the original stream write method and shows the cursor.
-     * This is typically called when temporarily suspending interactive mode.
-     */
-    renew(): void;
-    /**
-     * Writes a message directly to the underlying stream.
-     *
-     * Bypasses the hook mechanism and writes directly using the original
-     * stream write method. Useful for writing control sequences or
-     * messages that should not be captured in history.
-     * @param message The message to write to the stream
-     */
-    write(message: string): void;
-}
-export default InteractiveStreamHook;