@tracepanel/js 0.9.2 → 0.11.0

package/dist/config.js

@@ -9,11 +9,38 @@ const THRESHOLDS = {
     queue_wait_ms: ["TRACEPANEL_QUEUE_WAIT_MS", 1000],
     large_result_rows: ["TRACEPANEL_LARGE_RESULT_ROWS", 1000],
 };
+/** The limits that may be set per database too, and the field of their map. */
+const BY_DB = {
+    slow_sql_ms: "slow_sql_ms_by_db",
+    long_transaction_ms: "long_transaction_ms_by_db",
+};
+/**
+ * The limits from the environment, the agent's defaults for the rest. TRACEPANEL_SLOW_SQL_MS and
+ * TRACEPANEL_LONG_TRANSACTION_MS take one per database too, by its `db.system`: `100,snowflake=3000` holds every
+ * database to 100 ms but Snowflake, to 3 s. A part that isn't a number is left out.
+ */
 function thresholds(env) {
     const found = {};
     for (const [name, [variable, fallback]] of Object.entries(THRESHOLDS)) {
-        const value = Number(env[variable]);
-        found[name] = Number.isFinite(value) && env[variable] !== undefined && env[variable] !== "" ? value : fallback;
+        found[name] = fallback;
+        for (const part of (env[variable] ?? "").split(",")) {
+            const [left, right] = part.split("=", 2).map((piece) => piece.trim());
+            const value = right === undefined ? left : right;
+            if (value === undefined || value === "")
+                continue;
+            const number = Number(value);
+            if (!Number.isFinite(number) || number < 0)
+                continue;
+            if (right === undefined) {
+                found[name] = number;
+                continue;
+            }
+            const field = BY_DB[name];
+            const system = left?.toLowerCase();
+            if (field === undefined || !system)
+                continue;
+            found[field] = { ...found[field], [system]: number };
+        }
     }
     return found;
 }
@@ -54,6 +81,7 @@ export function loadConfig(env = process.env) {
         captureRequest: on(env.TRACEPANEL_CAPTURE_REQUEST),
         captureLocals: on(env.TRACEPANEL_CAPTURE_LOCALS),
         widget: on(env.TRACEPANEL_WIDGET),
+        dumps: on(env.TRACEPANEL_DUMPS),
         profile: onlyIf(env.TRACEPANEL_PROFILE),
         profileMemory: onlyIf(env.TRACEPANEL_PROFILE_MEMORY),
         profileEnabled: on(env.TRACEPANEL_PROFILE_ENABLED),

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2DpD,MAAM,UAAU,GAA+C;IAC7D,UAAU,EAAE,CAAC,iCAAiC,EAAE,CAAC,CAAC;IAClD,iBAAiB,EAAE,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACtD,WAAW,EAAE,CAAC,wBAAwB,EAAE,GAAG,CAAC;IAC5C,YAAY,EAAE,CAAC,yBAAyB,EAAE,GAAG,CAAC;IAC9C,mBAAmB,EAAE,CAAC,gCAAgC,EAAE,GAAG,CAAC;IAC5D,aAAa,EAAE,CAAC,0BAA0B,EAAE,IAAI,CAAC;IACjD,iBAAiB,EAAE,CAAC,8BAA8B,EAAE,IAAI,CAAC;CAC1D,CAAC;AAEF,SAAS,UAAU,CAAC,GAAsB;IACxC,MAAM,KAAK,GAAG,EAAgB,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAA2C,EAAE,CAAC;QAChH,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IACjH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAEjD,oDAAoD;AACpD,SAAS,EAAE,CAAC,KAAyB;IACnC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,2DAA2D;AAC3D,SAAS,MAAM,CAAC,KAAyB;IACvC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,oGAAoG;AACpG,SAAS,OAAO,CAAC,GAAsB;IACrC,MAAM,QAAQ,GAAG,GAAG,CAAC,kBAAkB,EAAE,WAAW,EAAE,CAAC;IACvD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzE,OAAO,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;AACvC,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACxF,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3D,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC;QACrB,IAAI;QACJ,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,cAAc,IAAI,aAAa,CAAC;QAC5D,OAAO,EAAE,GAAG,CAAC,kBAAkB,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC;QACtE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,IAAI;QACpD,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC;QAC3B,cAAc,EAAE,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAClD,aAAa,EAAE,EAAE,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAChD,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACvC,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC;QACpD,cAAc,EAAE,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAClD,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;KAC5F,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/console.d.ts

@@ -1,3 +1,4 @@
+import type { Config } from "./config.js";
 import type { TracepanelProcessor } from "./processor.js";
 /**
  * Runs a logger's own write (pino's, winston's): it recorded the log already, so what it prints through console is
@@ -7,5 +8,6 @@ export declare function quietly<T>(write: () => T): T;
 /**
  * Each of console's methods becomes a property whose value records the call, then runs the method as it is now:
  * something that replaces it later (Nuxt's dev server puts its own logger there) replaces what runs, not the record.
+ * A later capture (Nuxt's plugin) only changes where the calls go.
  */
-export declare function captureConsole(processor: TracepanelProcessor): void;
+export declare function captureConsole(processor: TracepanelProcessor, config?: Pick<Config, "root" | "dumps">): void;

package/dist/console.js

@@ -1,5 +1,8 @@
-// console.* calls made during a request go to its trace, then on to the terminal as before.
+// console.* calls made during a request go to its trace, then on to the terminal as before. A developer's own debug
+// output (console.dir(), a console.log() of an object) goes there as a dump (dumps.ts).
 import { format } from "node:util";
+import { DUMPING, dump, isDump } from "./dumps.js";
+import { captured } from "./stack.js";
 const LEVELS = {
     debug: "debug",
     log: "info",
@@ -8,6 +11,8 @@ const LEVELS = {
     error: "error",
 };
 const CAPTURED = Symbol.for("tracepanel.console");
+// How deep the stack at a dump is read: console's wrappers (a dev overlay's) above the app's frame.
+const DUMP_DEPTH = 20;
 let quiet = 0;
 /**
  * Runs a logger's own write (pino's, winston's): it recorded the log already, so what it prints through console is
@@ -25,27 +30,44 @@ export function quietly(write) {
 /**
  * Each of console's methods becomes a property whose value records the call, then runs the method as it is now:
  * something that replaces it later (Nuxt's dev server puts its own logger there) replaces what runs, not the record.
+ * A later capture (Nuxt's plugin) only changes where the calls go.
  */
-export function captureConsole(processor) {
+export function captureConsole(processor, config) {
     const target = console;
-    if (target[CAPTURED])
+    const captured = target[CAPTURED];
+    if (captured) {
+        captured.processor = processor;
+        captured.config = config ?? captured.config;
         return;
-    target[CAPTURED] = true;
-    for (const [method, level] of Object.entries(LEVELS)) {
+    }
+    const capture = { processor, config };
+    target[CAPTURED] = capture;
+    for (const method of new Set([...Object.keys(LEVELS), ...DUMPING])) {
+        const level = LEVELS[method];
         let current = target[method];
         const recorded = (...args) => {
             if (quiet > 0)
                 return current.apply(console, args);
-            const error = args.find((arg) => arg instanceof Error);
-            processor.addLog({
-                time: Date.now() * 1000,
-                level,
-                logger: "console",
-                message: format(...args),
-                exception: error?.stack ?? null,
-                attrs: {},
-            });
-            current.apply(console, args);
+            const { processor, config } = capture;
+            if (config?.dumps && isDump(method, args) && processor.current()) {
+                const found = dumpOf(method, args, config.root);
+                if (found) {
+                    processor.addLog(found);
+                    return current.apply(console, args);
+                }
+            }
+            if (level) {
+                const error = args.find((arg) => arg instanceof Error);
+                processor.addLog({
+                    time: Date.now() * 1000,
+                    level,
+                    logger: "console",
+                    message: format(...args),
+                    exception: error?.stack ?? null,
+                    attrs: {},
+                });
+            }
+            return current.apply(console, args);
         };
         Object.defineProperty(console, method, {
             configurable: true,
@@ -57,4 +79,14 @@ export function captureConsole(processor) {
         });
     }
 }
+/** The dump of a console call, or null: not the app's own call, or anything gone wrong (the call goes on). */
+function dumpOf(method, args, root) {
+    try {
+        const { stack, sites } = captured(DUMP_DEPTH);
+        return dump(method, args, stack, root, sites);
+    }
+    catch {
+        return null;
+    }
+}
 //# sourceMappingURL=console.js.map

package/dist/console.js.map

@@ -1 +1 @@
-{"version":3,"file":"console.js","sourceRoot":"","sources":["../src/console.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAE5F,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAInC,MAAM,MAAM,GAAiC;IAC3C,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAElD,IAAI,KAAK,GAAG,CAAC,CAAC;AAEd;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAI,KAAc;IACvC,KAAK,EAAE,CAAC;IACR,IAAI,CAAC;QACH,OAAO,KAAK,EAAE,CAAC;IACjB,CAAC;YAAS,CAAC;QACT,KAAK,EAAE,CAAC;IACV,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAA8B;IAC3D,MAAM,MAAM,GAAG,OAAwE,CAAC;IACxF,IAAI,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO;IAC7B,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACxB,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,IAAI,OAAO,GAAG,MAAM,CAAC,MAAM,CAAiC,CAAC;QAC7D,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;YACtC,IAAI,KAAK,GAAG,CAAC;gBAAE,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACnD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAgB,EAAE,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC;YACrE,SAAS,CAAC,MAAM,CAAC;gBACf,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI;gBACvB,KAAK;gBACL,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;gBACxB,SAAS,EAAE,KAAK,EAAE,KAAK,IAAI,IAAI;gBAC/B,KAAK,EAAE,EAAE;aACV,CAAC,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC;QACF,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE;YACrC,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,IAAI;YAChB,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ;YACnB,GAAG,EAAE,CAAC,WAAyC,EAAE,EAAE;gBACjD,OAAO,GAAG,WAAW,CAAC;YACxB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../src/console.ts"],"names":[],"mappings":"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"}

package/dist/dumps.d.ts

@@ -0,0 +1,52 @@
+import type { Log } from "./model.js";
+import { type StackFrame } from "./stack.js";
+/** How long an argument's text is at most, "… (truncated)" included. */
+export declare const MAX_REPR = 16384;
+/** The console methods whose calls can be dumps. dir() and table() always are. */
+export declare const DUMPING: Set<string>;
+export interface DumpArg {
+    /** The argument's source text, or null: a literal, or a call whose source couldn't be read. */
+    expr: string | null;
+    repr: string;
+    type: string;
+    len: number | null;
+}
+/** Whether a call to a console method is a dump: dir(), table(), or a log of a value that isn't a primitive. */
+export declare function isDump(method: string, args: readonly unknown[]): boolean;
+/**
+ * The dump of a console call, or null when the call isn't the app's own. `stack`: the stack at the call, the frames
+ * of console's wrappers (this package's, a dev overlay's) above the app's.
+ */
+export declare function dump(method: string, args: readonly unknown[], stack: string | undefined, root: string, sites?: readonly (StackFrame | undefined)[]): Omit<Log, "span_id"> | null;
+/** What a dump shows of a value: a copy with its secrets masked, or the value; `byText`: its text is to be masked. */
+export interface Shown {
+    value: unknown;
+    byText: boolean;
+}
+/**
+ * A value as inspect() is to show it, a secret's value masked: a copy where an object's key, a class's field or a
+ * Map's key names a secret (`password`, `apiToken`), with the same prototypes (inspect() names the class) and
+ * cycles; the value itself when nothing in it does. The app's value is never changed, and no getter is called. A
+ * proxy isn't looked into (its traps could run anything): inspect() shows its target without them, and that text is
+ * masked (maskText()).
+ */
+export declare function masked(value: unknown): Shown;
+/** A value as Node's console prints it, cut at MAX_REPR. */
+export declare function reprOf(value: unknown): string;
+/**
+ * A text inspect() made with every value under a key that names a secret masked: a quoted string (over several
+ * lines too), an object or array to its closing bracket, `[Getter]`, a number; and `name=value` pairs. What is masked
+ * reads `'********'`.
+ */
+export declare function maskText(text: string): string;
+/**
+ * The source text of each argument of the call at a frame, read from its source (through its bundle's source map,
+ * see stack.ts); null when the source can't be read or the call's arguments can't be told apart (a spread, a call
+ * split oddly).
+ */
+export declare function expressions(site: StackFrame, count: number): (string | null)[] | null;
+/**
+ * The arguments of the call whose parenthesis is at `open`, as source text without comments: strings, templates and
+ * brackets kept whole.
+ */
+export declare function argumentsAt(text: string, open: number): string[] | null;