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

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

@@ -1,185 +1,11 @@
-import { createRequire as __cjs_createRequire } from "node:module";
+var F=Object.defineProperty;var x=(o,e)=>F(o,"name",{value:e,configurable:!0});import{createRequire as V}from"node:module";import A from"@visulima/colorize";import{A as W,u as G,i as H,O as K,b as Q,s as Z,o as d,c as J,a as N,p as C,d as U,B as X,R as S}from"../../packem_shared/abstract-pretty-reporter-BiHgKxG_.js";const le=V(import.meta.url),Y=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,{stdout:z,stderr:D}=Y;var ee=Object.defineProperty,B=x((o,e)=>ee(o,"name",{value:e,configurable:!0}),"b");const{bgGrey:te,bold:I,cyan:se,green:re,greenBright:ie,grey:a,red:T,underline:k,white:ae}=A,oe=/[\\/]pail[\\/]dist/,_=B(o=>!oe.test(o),"pailFileFilter");class ue extends W{static{x(this,"SimpleReporter")}static{B(this,"SimpleReporter")}#t;#s;#r;#a=!1;#i;#e;constructor(e={}){const{error:n,inspect:p,...i}=e;super({uppercase:{label:!0,...i.uppercase},...i}),this.#i={...G,indent:void 0,...p},this.#e={...n,color:{fileLine:re,hint:se,marker:T,message:T,method:ie,title:T}},this.#t=z,this.#s=D}setStdout(e){this.#t=e}setStderr(e){this.#s=e}setInteractiveManager(e){this.#r=e}setIsInteractive(e){this.#a=e}log(e){const n=this.formatMessage(e),p=e.type.level,i=["error","trace","warn"].includes(p)?"stderr":"stdout",h=i==="stderr"?this.#s:this.#t;this.#a&&this.#r!==void 0&&h.isTTY?this.#r.update(i,n.split(`
+`),0):H(`${n}
+`,h)}formatMessage(e){const{columns:n}=K();let p=n;typeof this.styles.messageLength=="number"&&(p=this.styles.messageLength);const{badge:i,context:h,date:c,error:j,file:u,groups:g,label:m,message:f,prefix:$,repeated:M,scope:y,suffix:b,traceError:v,type:L}=e,{color:w}=this.loggerTypes[L.name],E=w?A[w]:ae,l=g.map(()=>"    ").join(""),t=[];if(g.length>0&&t.push(`${l+a(`[${g.at(-1)??""}]`)} `),c&&t.push(`${a(this.styles.dateFormatter(typeof c=="string"?new Date(c):c))} `),i)t.push(I(E(i)));else{const s=Q(this.loggerTypes);s.length>0&&t.push(a(" ".repeat(s.length)))}const O=Z(this.loggerTypes),R=d(O);if(m){const s=d(m),r=Math.max(0,R-s);t.push(`${I(E(J(m,this.styles)))} `," ".repeat(r))}else t.push(" ".repeat(R+1));M&&t.push(`${te.white(`[${String(M)}x]`)} `),Array.isArray(y)&&y.length>0&&t.push(`${a(`[${y.join(" > ")}]`)} `),$&&t.push(`${a(`[${this.styles.underline.prefix?k($):$}]`)} `);const P=d(t.join(""));if(f!==N){const s=typeof f=="string"?f:C(f,this.#i);t.push(l+U(s,{trim:!1,width:p-3,wrapMode:X.STRICT_WIDTH}))}if(h){let s=!1;t.push(...h.map(r=>{if(r instanceof Error)return s=!0,`
 
-const __cjs_require = __cjs_createRequire(import.meta.url);
+${S(r,{...this.#e,filterStacktrace:_,prefix:l})}`;if(typeof r=="object")return` ${C(r,this.#i)}`;const q=(s?`
 
-const __cjs_getProcess = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" ? globalThis.process : process;
+`:" ")+String(r);return s=!1,q}))}if(j&&t.push(S(j,{...this.#e,filterStacktrace:_,prefix:l})),v&&t.push(`
 
-const {
-  stdout,
-  stderr
-} = __cjs_getProcess;
-import colorize, { red, greenBright, cyan, green, grey, bold, bgGrey, underline, white } from '@visulima/colorize';
-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);
-class SimpleReporter extends AbstractPrettyReporter {
-  #stdout;
-  #stderr;
-  #interactiveManager;
-  #interactive = false;
-  #inspectOptions;
-  #errorOptions;
-  constructor(options = {}) {
-    const { error: errorOptions, inspect: inspectOptions, ...rest } = options;
-    super({
-      uppercase: {
-        label: true,
-        ...rest.uppercase
-      },
-      ...rest
-    });
-    this.#inspectOptions = { ...defaultInspectorConfig, indent: void 0, ...inspectOptions };
-    this.#errorOptions = {
-      ...errorOptions,
-      color: {
-        fileLine: green,
-        hint: cyan,
-        marker: red,
-        message: red,
-        method: greenBright,
-        title: red
-      }
-    };
-    this.#stdout = stdout;
-    this.#stderr = stderr;
-  }
-  setStdout(stdout_) {
-    this.#stdout = stdout_;
-  }
-  setStderr(stderr_) {
-    this.#stderr = stderr_;
-  }
-  setInteractiveManager(manager) {
-    this.#interactiveManager = manager;
-  }
-  setIsInteractive(interactive) {
-    this.#interactive = interactive;
-  }
-  log(meta) {
-    const message = this.formatMessage(meta);
-    const logLevel = meta.type.level;
-    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);
-    }
-  }
-  // eslint-disable-next-line sonarjs/cognitive-complexity
-  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(bold(colorized(badge)));
-    } else {
-      const longestBadge = getLongestBadge(this.loggerTypes);
-      if (longestBadge.length > 0) {
-        items.push(grey(" ".repeat(longestBadge.length)));
-      }
-    }
-    const longestLabel = getLongestLabel(this.loggerTypes);
-    const longestWidth = getStringWidth(longestLabel);
-    if (label) {
-      const labelWidth = getStringWidth(label);
-      const pad = Math.max(0, longestWidth - labelWidth);
-      items.push(`${bold(colorized(formatLabel(label, this.styles)))} `, " ".repeat(pad));
-    } else {
-      items.push(" ".repeat(longestWidth + 1));
-    }
-    if (repeated) {
-      items.push(`${bgGrey.white(`[${String(repeated)}x]`)} `);
-    }
-    if (Array.isArray(scope) && scope.length > 0) {
-      items.push(`${grey(`[${scope.join(" > ")}]`)} `);
-    }
-    if (prefix) {
-      items.push(`${grey(`[${this.styles.underline.prefix ? underline(prefix) : prefix}]`)} `);
-    }
-    const titleSize = getStringWidth(items.join(""));
-    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" : " ") + String(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(` ${groupSpaces}${grey(this.styles.underline.suffix ? underline(suffix) : suffix)}`);
-    }
-    if (file) {
-      const fileMessage = (file.name ?? "") + (file.line ? `:${String(file.line)}` : "");
-      const callerPad = Math.max(0, titleSize - getStringWidth("Caller: "));
-      items.push("\n", grey("Caller: "), " ".repeat(callerPad), fileMessage, "\n");
-    }
-    return items.join("");
-  }
-}
-
-export { SimpleReporter };
+${S(v,{...this.#e,filterStacktrace:_,hideErrorCauseCodeView:!0,hideErrorCodeView:!0,hideErrorErrorsCodeView:!0,hideMessage:!0,prefix:l})}`),b&&t.push(` ${l}${a(this.styles.underline.suffix?k(b):b)}`),u){const s=(u.name??"")+(u.line?`:${String(u.line)}`:""),r=Math.max(0,P-d("Caller: "));t.push(`
+`,a("Caller: ")," ".repeat(r),s,`
+`)}return t.join("")}}export{ue as SimpleReporter};

package/dist/wide-event.d.ts

@@ -1,300 +1,5 @@
-import type { PailBrowserImpl } from "./pail.d.ts";
-import type { DefaultLogTypes, LoggerFunction } from "./types.d.ts";
-/**
- * A pail instance with dynamically generated log methods.
- * This is the minimal interface WideEvent needs from a pail logger.
- */
-type PailLike<T extends string = string> = PailBrowserImpl<T> & Record<DefaultLogTypes | T, LoggerFunction>;
-/**
- * Makes all properties in T optional recursively.
- */
-type DeepPartial<T> = {
-    [K in keyof T]?: T[K] extends Record<string, unknown> ? DeepPartial<T[K]> : T[K];
-};
-/**
- * Severity levels for wide events.
- */
-export type WideEventLevel = "debug" | "error" | "info" | "warn";
-/**
- * An entry in the request lifecycle log.
- */
-export interface RequestLogEntry {
-    /**
-     * Additional structured context for this log entry.
-     */
-    context?: Record<string, unknown>;
-    /**
-     * Severity level of this entry.
-     */
-    level: WideEventLevel;
-    /**
-     * Human-readable message describing what happened.
-     */
-    message: string;
-    /**
-     * ISO 8601 timestamp of when this entry was recorded.
-     */
-    timestamp: string;
-}
-/**
- * Serialized error information included in the emitted wide event.
- */
-export interface SerializedError {
-    cause?: SerializedError;
-    data?: unknown;
-    message: string;
-    name: string;
-    stack?: string;
-    status?: number;
-}
-/**
- * Options for finishing a wide event with HTTP context.
- */
-export interface WideEventFinishOptions {
-    /**
-     * An error that occurred during the operation.
-     * Will be serialized and included in the emitted event.
-     */
-    error?: Error;
-    /**
-     * HTTP response status code.
-     */
-    status?: number;
-}
-/**
- * Options for creating a WideEvent instance.
- * @template T - Custom logger type names
- */
-export interface WideEventOptions<T extends string = string> {
-    /**
-     * Auto-emit the event when disposed via `Symbol.dispose`.
-     * Works with TC39 Explicit Resource Management (`using`).
-     * @default true
-     */
-    autoEmit?: boolean;
-    /**
-     * Event name identifying this wide event, e.g. "api.checkout", "worker.send-email".
-     */
-    name: string;
-    /**
-     * The pail logger instance to use for emission.
-     */
-    pail: PailLike<T>;
-    /**
-     * Service name for this event. Overrides any service name from pail's scope.
-     */
-    service?: string;
-    /**
-     * Base log type to use when emitting. Defaults to "info".
-     * The actual type may be escalated based on logged warnings/errors.
-     */
-    type?: DefaultLogTypes | T;
-}
-/**
- * A wide event logger that accumulates context incrementally and emits
- * a single comprehensive log event through pail.
- *
- * Instead of scattering multiple log calls throughout an operation,
- * use `set()` to build up context as information becomes available,
- * then emit once at the end. Lifecycle methods (`info()`, `warn()`, `error()`,
- * `debug()`) record timestamped entries in a `requestLogs` array and
- * automatically escalate the event's severity level.
- *
- * Implements `Disposable` for use with TC39 Explicit Resource Management.
- * @template TData - Shape of the accumulated event data
- * @template T - Custom logger type names from the pail instance
- * @example
- * ```typescript
- * // Manual finish
- * const ev = createWideEvent({ pail: logger, name: "api.checkout" });
- * ev.set({ user: { id: 1 } });
- * ev.info("Validated cart");
- * ev.set({ cart: { items: 3, total: 9999 } });
- * ev.finish({ status: 200 });
- *
- * // Auto-emit with Explicit Resource Management
- * using ev = createWideEvent({ pail: logger, name: "api.checkout" });
- * ev.set({ user: { id: 1 } });
- * // emits automatically when scope exits
- *
- * // Typed data shape
- * interface CheckoutData {
- *   user: { id: number; plan: string };
- *   cart: { items: number; total: number };
- * }
- * const ev = createWideEvent<CheckoutData>({ pail: logger, name: "api.checkout" });
- * ev.set({ user: { id: 1, plan: "pro" } }); // fully typed
- * ```
- */
-export declare class WideEvent<TData extends Record<string, unknown> = Record<string, unknown>, T extends string = string> implements Disposable {
-    [Symbol.dispose]: () => void;
-    readonly name: string;
-    private readonly autoEmit;
-    private data;
-    private emitted;
-    private attachedError?;
-    private level;
-    private readonly pail;
-    private readonly requestLogs;
-    private readonly service;
-    private readonly startTime;
-    private status;
-    private readonly timestamp;
-    private readonly _type;
-    constructor(options: WideEventOptions<T>);
-    /**
-     * Record a debug-level lifecycle log entry.
-     * Does not escalate the event level.
-     * @param message Description of what happened
-     * @param context Optional structured context
-     * @returns `this` for chaining
-     */
-    debug(message: string, context?: Record<string, unknown>): this;
-    /**
-     * Emit the wide event through the pail logger. Can only be called once;
-     * subsequent calls are no-ops.
-     *
-     * Automatically calculates duration, determines the log type based on
-     * the highest severity level reached, and serializes any attached error.
-     *
-     * Prefer `finish()` for HTTP request contexts where you have a status code.
-     * @param typeOverride Override the log type for this emission
-     */
-    emit(typeOverride?: DefaultLogTypes | T): void;
-    /**
-     * Record an error-level lifecycle log entry and attach the error.
-     * Escalates the event level to "error".
-     * @param message Description of what went wrong
-     * @param error The error that occurred
-     * @param context Optional structured context
-     * @returns `this` for chaining
-     */
-    error(message: string, error?: Error, context?: Record<string, unknown>): this;
-    /**
-     * Finish and emit the wide event with HTTP context.
-     * Sets the response status and optional error before emitting.
-     * @example
-     * ```typescript
-     * ev.finish({ status: 200 });
-     * ev.finish({ status: 500, error: new Error("DB timeout") });
-     * ```
-     * @param options Status code and/or error
-     */
-    finish(options?: WideEventFinishOptions): void;
-    /**
-     * Get a read-only snapshot of the accumulated data.
-     */
-    getData(): Readonly<TData>;
-    /**
-     * Get the current severity level of the event.
-     * The level auto-escalates as `warn()` or `error()` entries are added.
-     */
-    getLevel(): WideEventLevel;
-    /**
-     * Get a read-only copy of the request lifecycle log entries.
-     */
-    getRequestLogs(): ReadonlyArray<RequestLogEntry>;
-    /**
-     * Record an info-level lifecycle log entry.
-     * Does not escalate the event level.
-     * @param message Description of what happened
-     * @param context Optional structured context
-     * @returns `this` for chaining
-     */
-    info(message: string, context?: Record<string, unknown>): this;
-    /**
-     * Accumulate context into the wide event via deep merge.
-     * Call as many times as needed throughout the operation.
-     * @example
-     * ```typescript
-     * ev.set({ user: { id: 1 } });
-     * ev.set({ user: { plan: "pro" } });
-     * // data = { user: { id: 1, plan: "pro" } }
-     * ```
-     * @param data Partial data to merge into the event
-     * @returns `this` for chaining
-     */
-    set(data: DeepPartial<TData>): this;
-    /**
-     * Attach an error to the event. Automatically escalates the event
-     * level to "error".
-     * @param error The error to attach
-     * @returns `this` for chaining
-     */
-    setError(error: Error): this;
-    /**
-     * Set the HTTP response status code.
-     * @param status HTTP status code
-     * @returns `this` for chaining
-     */
-    setStatus(status: number): this;
-    /**
-     * Record a warn-level lifecycle log entry.
-     * Escalates the event level to "warn" (unless already "error").
-     * @param message Description of the warning
-     * @param context Optional structured context
-     * @returns `this` for chaining
-     */
-    warn(message: string, context?: Record<string, unknown>): this;
-    /**
-     * Disposable implementation. Auto-emits the event if `autoEmit` is true
-     * and the event hasn't been manually emitted yet.
-     *
-     * Enables usage with TC39 Explicit Resource Management:
-     * ```typescript
-     * using ev = createWideEvent({ pail: logger, name: "api.checkout" });
-     * ev.set({ user: { id: 1 } });
-     * // auto-emits here when scope exits
-     * ```
-     */
-    [Symbol.dispose](): void;
-    /**
-     * Add an entry to the request lifecycle log and escalate level if needed.
-     */
-    private addLogEntry;
-    /**
-     * Escalate the event level if the new level has higher severity.
-     */
-    private escalateLevel;
-}
-/**
- * Create a wide event logger that accumulates context and emits a single
- * comprehensive log event through pail.
- * @template TData - Shape of the accumulated event data
- * @template T - Custom logger type names from the pail instance
- * @param options Configuration options
- * @returns A new WideEvent instance
- * @example
- * ```typescript
- * import { createPail } from "@visulima/pail";
- * import { createWideEvent } from "@visulima/pail/wide-event";
- *
- * const logger = createPail();
- *
- * // In a request handler:
- * const ev = createWideEvent({ pail: logger, name: "api.checkout" });
- *
- * ev.set({ user: { id: 1, plan: "pro" } });
- * ev.info("Validated cart", { itemCount: 3 });
- * ev.set({ cart: { id: 42, items: 3, total: 9999 } });
- * ev.info("Payment processed");
- * ev.finish({ status: 200 });
- *
- * // Emits a single structured log:
- * // {
- * //   event: "api.checkout",
- * //   timestamp: "2025-01-24T10:23:45.612Z",
- * //   duration: "127ms",
- * //   duration_ms: 127,
- * //   status: 200,
- * //   user: { id: 1, plan: "pro" },
- * //   cart: { id: 42, items: 3, total: 9999 },
- * //   requestLogs: [
- * //     { level: "info", message: "Validated cart", timestamp: "...", context: { itemCount: 3 } },
- * //     { level: "info", message: "Payment processed", timestamp: "..." }
- * //   ]
- * // }
- * ```
- */
-export declare const createWideEvent: <TData extends Record<string, unknown> = Record<string, unknown>, T extends string = string>(options: WideEventOptions<T>) => WideEvent<TData, T>;
-export {};
+export { R as RequestLogEntry, S as SerializedError, W as WideEvent, a as WideEventFinishOptions, b as WideEventLevel, c as WideEventOptions, d as createWideEvent } from "./packem_shared/wide-event.d-Ke44zirU.js";
+import "./packem_shared/types.d-ByY2ZuYG.js";
+import 'safe-stable-stringify';
+import '@visulima/colorize';
+import '@visulima/interactive-manager';