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

package/dist/packem_shared/constants-B1RjD_ps.js

@@ -0,0 +1,99 @@
+const LOG_TYPES = {
+  alert: {
+    color: "red",
+    label: "alert",
+    logLevel: "alert"
+  },
+  await: {
+    color: "blue",
+    label: "awaiting",
+    logLevel: "informational"
+  },
+  complete: {
+    color: "cyan",
+    label: "complete",
+    logLevel: "informational"
+  },
+  critical: {
+    color: "redBright",
+    label: "critical",
+    logLevel: "critical"
+  },
+  debug: {
+    color: "gray",
+    label: "debug",
+    logLevel: "debug"
+  },
+  emergency: {
+    color: "redBright",
+    label: "emergency",
+    logLevel: "emergency"
+  },
+  error: {
+    color: "red",
+    label: "error",
+    logLevel: "error"
+  },
+  info: {
+    color: "blueBright",
+    label: "info",
+    logLevel: "informational"
+  },
+  log: {
+    label: "",
+    logLevel: "informational"
+  },
+  notice: {
+    color: "magentaBright",
+    label: "notice",
+    logLevel: "notice"
+  },
+  pending: {
+    color: "magenta",
+    label: "pending",
+    logLevel: "informational"
+  },
+  start: {
+    color: "greenBright",
+    label: "start",
+    logLevel: "informational"
+  },
+  stop: {
+    color: "red",
+    label: "stop",
+    logLevel: "informational"
+  },
+  success: {
+    color: "green",
+    label: "success",
+    logLevel: "informational"
+  },
+  trace: {
+    color: "cyanBright",
+    label: "trace",
+    logLevel: "trace"
+  },
+  wait: {
+    color: "blue",
+    label: "waiting",
+    logLevel: "informational"
+  },
+  warn: {
+    color: "yellow",
+    label: "warning",
+    logLevel: "warning"
+  },
+  warning: {
+    color: "yellow",
+    label: "warning",
+    logLevel: "warning"
+  },
+  watch: {
+    color: "yellowBright",
+    label: "watching",
+    logLevel: "informational"
+  }
+};
+const EMPTY_SYMBOL = /* @__PURE__ */ Symbol("EMPTY");
+
+export { EMPTY_SYMBOL as E, LOG_TYPES as L };

package/dist/packem_shared/createPailError-B_sgL0nF.js

@@ -0,0 +1,76 @@
+class PailError extends Error {
+  /** HTTP status code (defaults to 500) */
+  status;
+  /** Explanation of what caused the failure */
+  why;
+  /** Suggested resolution steps */
+  fix;
+  /** Link to relevant documentation */
+  link;
+  constructor(options) {
+    const resolvedOptions = typeof options === "string" ? { message: options } : options;
+    super(resolvedOptions.message, resolvedOptions.cause === void 0 ? void 0 : { cause: resolvedOptions.cause });
+    this.name = "PailError";
+    this.status = resolvedOptions.status ?? 500;
+    this.why = resolvedOptions.why;
+    this.fix = resolvedOptions.fix;
+    this.link = resolvedOptions.link;
+  }
+  /**
+   * Converts the error to a JSON-serializable object.
+   *
+   * Includes all self-documenting fields in the output for structured logging.
+   * @returns A plain object representation of the error
+   */
+  toJSON() {
+    const json = {
+      message: this.message,
+      name: this.name,
+      status: this.status
+    };
+    if (this.why) {
+      json.why = this.why;
+    }
+    if (this.fix) {
+      json.fix = this.fix;
+    }
+    if (this.link) {
+      json.link = this.link;
+    }
+    if (this.stack) {
+      json.stack = this.stack;
+    }
+    if (this.cause !== void 0) {
+      json.cause = this.cause instanceof Error ? { message: this.cause.message, name: this.cause.name, stack: this.cause.stack } : this.cause;
+    }
+    return json;
+  }
+  /**
+   * Returns a formatted string representation including self-documenting fields.
+   * @returns Formatted error string with why/fix/link context
+   */
+  toString() {
+    let output = `${this.name} [${String(this.status)}]: ${this.message}`;
+    if (this.why) {
+      output += `
+  Why: ${this.why}`;
+    }
+    if (this.fix) {
+      output += `
+  Fix: ${this.fix}`;
+    }
+    if (this.link) {
+      output += `
+  Link: ${this.link}`;
+    }
+    if (this.cause !== void 0) {
+      const causeMessage = this.cause instanceof Error ? this.cause.message : String(this.cause);
+      output += `
+  Cause: ${causeMessage}`;
+    }
+    return output;
+  }
+}
+const createPailError = (options) => new PailError(options);
+
+export { PailError, createPailError };

package/dist/packem_shared/headers-BxHWM6KI.js

@@ -0,0 +1,127 @@
+import { WideEvent } from '../wide-event.js';
+
+const patternToRegex = (pattern) => {
+  let regex = "^";
+  let index = 0;
+  while (index < pattern.length) {
+    const char = pattern[index];
+    if (char === "*" && pattern[index + 1] === "*") {
+      index += 2;
+      if (pattern[index] === "/") {
+        index += 1;
+      }
+      if (index >= pattern.length && regex.endsWith("/")) {
+        regex = `${regex.slice(0, -1)}(/.*)?`;
+      } else if (index >= pattern.length) {
+        regex += ".*";
+      } else {
+        regex += "(.*/)?";
+      }
+    } else {
+      switch (char) {
+        case "*": {
+          regex += "[^/]*";
+          index += 1;
+          break;
+        }
+        case ".": {
+          regex += String.raw`\.`;
+          index += 1;
+          break;
+        }
+        case "?": {
+          regex += "[^/]";
+          index += 1;
+          break;
+        }
+        default: {
+          regex += char;
+          index += 1;
+        }
+      }
+    }
+  }
+  regex += "$";
+  return new RegExp(regex);
+};
+const matchesPattern = (path, pattern) => patternToRegex(pattern).test(path);
+const shouldLog = (path, include, exclude) => {
+  if (exclude?.some((pattern) => matchesPattern(path, pattern))) {
+    return false;
+  }
+  if (!include?.length) {
+    return true;
+  }
+  return include.some((pattern) => matchesPattern(path, pattern));
+};
+const getServiceForPath = (path, routes) => {
+  if (!routes) {
+    return void 0;
+  }
+  const entries = Object.entries(routes);
+  for (let i = 0; i < entries.length; i += 1) {
+    const [pattern, config] = entries[i];
+    if (matchesPattern(path, pattern)) {
+      return config.service;
+    }
+  }
+  return void 0;
+};
+
+const createMiddlewareLogger = (options, request) => {
+  const { exclude, include, pail, routes, service } = options;
+  const { headers, method, path, requestId } = request;
+  if (!shouldLog(path, include, exclude)) {
+    const noopLogger = new WideEvent({ autoEmit: false, name: `${method} ${path}`, pail });
+    return {
+      finish: () => {
+      },
+      logger: noopLogger,
+      skipped: true
+    };
+  }
+  const routeService = getServiceForPath(path, routes) ?? service;
+  const logger = new WideEvent({
+    name: `${method} ${path}`,
+    pail,
+    service: routeService
+  });
+  logger.set({
+    method,
+    path,
+    requestId,
+    ...headers ? { headers } : {}
+  });
+  const finish = (finishOptions) => {
+    logger.finish(finishOptions);
+  };
+  return {
+    finish,
+    logger,
+    skipped: false
+  };
+};
+
+const SENSITIVE_HEADERS = /* @__PURE__ */ new Set(["authorization", "cookie", "proxy-authorization", "set-cookie", "x-api-key", "x-auth-token"]);
+const extractSafeHeaders = (headers) => {
+  const safe = {};
+  headers.forEach((value, key) => {
+    if (!SENSITIVE_HEADERS.has(key.toLowerCase())) {
+      safe[key.toLowerCase()] = value;
+    }
+  });
+  return safe;
+};
+const extractSafeNodeHeaders = (headers) => {
+  const safe = {};
+  const entries = Object.entries(headers);
+  for (let i = 0; i < entries.length; i += 1) {
+    const [key, value] = entries[i];
+    if (!SENSITIVE_HEADERS.has(key.toLowerCase()) && value !== void 0) {
+      safe[key.toLowerCase()] = Array.isArray(value) ? value.join(", ") : value;
+    }
+  }
+  return safe;
+};
+
+export { extractSafeHeaders as a, createMiddlewareLogger as c, extractSafeNodeHeaders as e };

package/dist/packem_shared/{index-BomQ3E6J.js → index-Bx3-C0j9.js}

@@ -1,3 +1,11 @@
+const getLongestLabel = (types) => {
+  const labels = Object.keys(types).map((x) => types[x].label ?? "");
+  if (labels.length === 0) {
+    return "";
+  }
+  return labels.reduce((x, y) => x.length > y.length ? x : y, "");
+};
+
 const colorKeywords = /* @__PURE__ */ new Map([
   ["aliceblue", "#f0f8ff"],
   ["antiquewhite", "#faebd7"],
@@ -163,7 +171,7 @@ const getDefaultCss = () => {
     textDecorationLine: []
   };
 };
-const SPACE_PATTERN = /\s+/g;
+const SPACE_PATTERN = /\s+/;
 const parseCssColor = (colorString) => {
   if (colorKeywords.has(colorString)) {
     colorString = colorKeywords.get(colorString);
@@ -229,10 +237,10 @@ const parseCss = (cssString) => {
   let currentPart = "";
   for (const c of cssString) {
     if (c === "(") {
-      parenthesesDepth++;
+      parenthesesDepth += 1;
     } else if (parenthesesDepth > 0) {
       if (c === ")") {
-        parenthesesDepth--;
+        parenthesesDepth -= 1;
       }
     } else if (inValue) {
       if (c === ";") {
@@ -365,14 +373,14 @@ const cssToAnsi = (css, previousCss = null) => {
         default: {
           if (Array.isArray(css.backgroundColor)) {
             const { 0: r, 1: g, 2: b } = css.backgroundColor;
-            ansi += `\x1B[48;2;${r};${g};${b}m`;
+            ansi += `\x1B[48;2;${String(r)};${String(g)};${String(b)}m`;
           } else {
             const parsed = parseCssColor(css.backgroundColor);
             if (parsed === null) {
               ansi += "\x1B[49m";
             } else {
               const { 0: r, 1: g, 2: b } = parsed;
-              ansi += `\x1B[48;2;${r};${g};${b}m`;
+              ansi += `\x1B[48;2;${String(r)};${String(g)};${String(b)}m`;
             }
           }
         }
@@ -419,14 +427,14 @@ const cssToAnsi = (css, previousCss = null) => {
         default: {
           if (Array.isArray(css.color)) {
             const { 0: r, 1: g, 2: b } = css.color;
-            ansi += `\x1B[38;2;${r};${g};${b}m`;
+            ansi += `\x1B[38;2;${String(r)};${String(g)};${String(b)}m`;
           } else {
             const parsed = parseCssColor(css.color);
             if (parsed === null) {
               ansi += "\x1B[39m";
             } else {
               const { 0: r, 1: g, 2: b } = parsed;
-              ansi += `\x1B[38;2;${r};${g};${b}m`;
+              ansi += `\x1B[38;2;${String(r)};${String(g)};${String(b)}m`;
             }
           }
         }
@@ -444,7 +452,7 @@ const cssToAnsi = (css, previousCss = null) => {
       ansi += "\x1B[59m";
     } else {
       const { 0: r, 1: g, 2: b } = css.textDecorationColor;
-      ansi += `\x1B[58;2;${r};${g};${b}m`;
+      ansi += `\x1B[58;2;${String(r)};${String(g)};${String(b)}m`;
     }
   }
   if (css.textDecorationLine.includes("line-through") !== previousCss.textDecorationLine.includes("line-through")) {
@@ -487,7 +495,7 @@ const format = (fmt, arguments_ = [], options = {}) => {
     }
     const objects = Array.from({ length: argumentsLength });
     objects[0] = stringify(fmt);
-    for (let index = 1; index < argumentsLength; index++) {
+    for (let index = 1; index < argumentsLength; index += 1) {
       objects[index] = stringify(arguments_[index - offset]);
     }
     return objects.join(" ");
@@ -505,7 +513,7 @@ const format = (fmt, arguments_ = [], options = {}) => {
       lastPosition = lastPosition > -1 ? lastPosition : 0;
       const c = fmt.codePointAt(index + 1);
       if (c === void 0) {
-        ++a;
+        a += 1;
         break;
       }
       switch (c) {
@@ -522,7 +530,7 @@ const format = (fmt, arguments_ = [], options = {}) => {
             }
           }
           lastPosition = index + 2;
-          index++;
+          index += 1;
           break;
         }
         case CHAR_d:
@@ -535,7 +543,7 @@ const format = (fmt, arguments_ = [], options = {}) => {
           }
           result += Number(arguments_[a]).toString();
           lastPosition = index + 2;
-          index++;
+          index += 1;
           break;
         }
         case CHAR_i: {
@@ -547,7 +555,7 @@ const format = (fmt, arguments_ = [], options = {}) => {
           }
           result += Math.floor(Number(arguments_[a])).toString();
           lastPosition = index + 2;
-          index++;
+          index += 1;
           break;
         }
         case CHAR_j:
@@ -573,7 +581,7 @@ const format = (fmt, arguments_ = [], options = {}) => {
           }
           result += stringify(temporaryArgument);
           lastPosition = index + 2;
-          index++;
+          index += 1;
           break;
         }
         case CHAR_PERCENT: {
@@ -582,8 +590,8 @@ const format = (fmt, arguments_ = [], options = {}) => {
           }
           result += "%";
           lastPosition = index + 2;
-          index++;
-          a--;
+          index += 1;
+          a -= 1;
           break;
         }
         case CHAR_s: {
@@ -595,7 +603,7 @@ const format = (fmt, arguments_ = [], options = {}) => {
           }
           result += typeof arguments_[a] === "object" ? stringify(arguments_[a]) : String(arguments_[a]);
           lastPosition = index + 2;
-          index++;
+          index += 1;
           break;
         }
         default: {
@@ -605,13 +613,13 @@ const format = (fmt, arguments_ = [], options = {}) => {
             }
             result += options.formatters[c](arguments_[a]);
             lastPosition = index + 2;
-            index++;
+            index += 1;
           }
         }
       }
-      ++a;
+      a += 1;
     }
-    ++index;
+    index += 1;
   }
   if (lastPosition === -1) {
     return fmt;
@@ -647,4 +655,4 @@ const build = (options = {}) => {
   return (f, arguments_ = [], formatOptions = {}) => format(f, arguments_, { ...formatOptions, formatters });
 };
 
-export { build as b, format as f };
+export { build as b, format as f, getLongestLabel as g };

package/dist/packem_shared/pailMiddleware-Ci88geIF.js

@@ -0,0 +1,24 @@
+const GLOB_STRIP_RE = /\*+/g;
+const pailMiddleware = (NextResponseClass, options) => {
+  const { exclude, include } = options ?? {};
+  return (request) => {
+    const path = request.nextUrl.pathname;
+    if (exclude?.some((p) => path.startsWith(p.replaceAll(GLOB_STRIP_RE, "")))) {
+      return NextResponseClass.next();
+    }
+    if (include?.length && !include.some((p) => path.startsWith(p.replaceAll(GLOB_STRIP_RE, "")))) {
+      return NextResponseClass.next();
+    }
+    const requestId = request.headers.get("x-request-id") ?? crypto.randomUUID();
+    const requestHeaders = new Headers(request.headers);
+    requestHeaders.set("x-request-id", requestId);
+    requestHeaders.set("x-pail-start", String(Date.now()));
+    const response = NextResponseClass.next({
+      request: { headers: requestHeaders }
+    });
+    response.headers.set("x-request-id", requestId);
+    return response;
+  };
+};
+
+export { pailMiddleware };

package/dist/packem_shared/storage-D0vqz8OX.js

@@ -0,0 +1,36 @@
+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);
+};
+
+const {
+  AsyncLocalStorage
+} = __cjs_getBuiltinModule("node:async_hooks");
+
+const createLoggerStorage = (contextHint) => {
+  const storage = new AsyncLocalStorage();
+  const useLogger = () => {
+    const logger = storage.getStore();
+    if (!logger) {
+      throw new Error(`[pail] useLogger() called outside of ${contextHint}`);
+    }
+    return logger;
+  };
+  return { storage, useLogger };
+};
+
+export { createLoggerStorage as c };

package/dist/packem_shared/{InteractiveStreamHook-DiSubbJ1.js → useLogger-D0rU3lcX.js}

@@ -17,5 +17,17 @@ const __cjs_getBuiltinModule = (module) => {
     return __cjs_require(module);
 };
 
+const {
+  AsyncLocalStorage
+} = __cjs_getBuiltinModule("node:async_hooks");
 
-export { I as default } from './interactive-stream-hook-DG4BtN12.js';
+const pailStorage = new AsyncLocalStorage();
+const useLogger = () => {
+  const logger = pailStorage.getStore();
+  if (!logger) {
+    throw new Error("[pail] useLogger() called outside of withPail() context. Wrap your route handler or server action with withPail().");
+  }
+  return logger;
+};
+
+export { pailStorage, useLogger };

package/dist/packem_shared/{write-console-log-based-on-level-DBmRYXpj.js → write-console-log-based-on-level-ree2lDPw.js}

@@ -1,14 +1,15 @@
 const writeConsoleLogBasedOnLevel = (level) => {
+  const c = console;
   if (level === "error") {
-    return console.__error ?? console.error;
+    return c.__error ?? console.error;
   }
   if (level === "warn") {
-    return console.__warn ?? console.warn;
+    return c.__warn ?? console.warn;
   }
   if (level === "trace") {
-    return console.__trace ?? console.trace;
+    return c.__trace ?? console.trace;
   }
-  return console.__log ?? console.log;
+  return c.__log ?? console.log;
 };
 
 export { writeConsoleLogBasedOnLevel as w };

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

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

package/dist/pail.browser.d.ts

@@ -403,7 +403,7 @@ export declare class PailBrowserImpl<T extends string = string, L extends string
     protected extendReporter(reporter: Reporter<L>): Reporter<L>;
     protected registerReporters(reporters: Reporter<L>[]): void;
     protected registerProcessors(processors: Processor<L>[]): void;
-    protected logger(type: LiteralUnion<DefaultLogTypes, T>, raw: boolean, force: boolean, ...messageObject: any[]): void;
+    protected logger(type: LiteralUnion<DefaultLogTypes, T>, raw: boolean, force: boolean, ...messageObject: unknown[]): void;
 }
 export type PailBrowserType<T extends string = string, L extends string = string> = Console & (new <TC extends string = string, LC extends string = string>(options?: ConstructorOptions<TC, LC>) => PailBrowserType<TC, LC>) & PailBrowserImpl<T, L> & Record<DefaultLogTypes, LoggerFunction> & Record<T, LoggerFunction> & {
     force: Record<DefaultLogTypes, LoggerFunction> & Record<T, LoggerFunction>;

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,