@tracepanel/js 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DevRealm OÜ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,272 @@
-# Temporary Holding Version
+# Tracepanel for Node.js and Bun
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![CI](https://github.com/tracepanel/tracepanel-js/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/tracepanel/tracepanel-js/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@tracepanel/js)](https://www.npmjs.com/package/@tracepanel/js)
+[![Node.js](https://img.shields.io/node/v/@tracepanel/js)](https://www.npmjs.com/package/@tracepanel/js)
+
+**See what your app does on every request.** Tracepanel records each request
+of your Express, NestJS, Next.js, Nuxt or Bun app with its SQL queries, logs
+and errors. It finds N+1 queries, duplicate queries and slow SQL, and names
+the line of code to fix. You read it in a panel on your pages and in a
+console.
+
+It runs while you develop, and everything stays on your machine.
+
+## Setup
+
+```bash
+npm install @tracepanel/js
+```
+
+Tracepanel is on unless `NODE_ENV` is `production`. `TRACEPANEL_ENABLED=0`
+turns it off and `TRACEPANEL_ENABLED=1` turns it on. It starts its agent on
+the first request. The agent keeps the traces in `.tracepanel/` in your
+project and serves the console. Open a page and click the badge in the
+corner.
+
+### Express
+
+Start the app with Tracepanel loaded before it, so OpenTelemetry can
+instrument its HTTP server, Express and its database driver, and add the
+middleware. It puts the badge on HTML pages and gives every response its
+trace id:
+
+```bash
+node --import @tracepanel/js/register server.js
+```
+
+```js
+import express from "express";
+import { tracepanel } from "@tracepanel/js/express";
+
+const app = express();
+app.use(tracepanel());
+```
+
+The flag is how Tracepanel gets in before the app. An ES module's imports
+all load before any of its code runs, so `import "@tracepanel/js/register"` at
+the top of `server.js` comes too late for Express and the database driver.
+Without the flag, either let the CLI add it:
+
+```json
+{ "scripts": { "dev": "tracepanel run node server.js" } }
+```
+
+or start from a file that loads Tracepanel, then the app:
+
+```js
+// main.js, run with `node main.js`
+import "@tracepanel/js/register";
+await import("./server.js");
+```
+
+The agent starts by itself either way, on the app's first request.
+
+### NestJS
+
+Nest runs on Express: load Tracepanel the same way and add the same
+middleware in `main.ts`. Each request's handler is its controller method,
+such as `BooksController.list`, and the Nest `Logger`'s records go to the
+request's trace. An `HttpException` that answers below 500 is the response,
+not an error.
+
+```bash
+node --import @tracepanel/js/register dist/main.js
+```
+
+```ts
+import { NestFactory } from "@nestjs/core";
+import { tracepanel } from "@tracepanel/js/express";
+import { AppModule } from "./app.module.js";
+
+const app = await NestFactory.create(AppModule);
+app.use(tracepanel());
+await app.listen(3000);
+```
+
+### Next.js
+
+Next.js starts its own server: Tracepanel goes in from the instrumentation
+hook, and Next.js makes each request's root span itself. Keep the package out
+of the bundles, and put the badge in the root layout:
+
+```ts
+// instrumentation.ts
+export async function register() {
+  if (process.env.NEXT_RUNTIME === "nodejs") (await import("@tracepanel/js/next")).register();
+}
+```
+
+```ts
+// next.config.ts
+const config = { serverExternalPackages: ["@tracepanel/js"] };
+export default config;
+```
+
+```tsx
+// app/layout.tsx
+import { Tracepanel } from "@tracepanel/js/next/widget";
+
+export default function RootLayout({ children }) {
+  return (
+    <html lang="en">
+      <head>
+        <Tracepanel />
+      </head>
+      <body>{children}</body>
+    </html>
+  );
+}
+```
+
+A request's handler is its page or route handler, named by its route
+(`/api/books/[id]`).
+
+### Nuxt
+
+Add the module and start `nuxt dev` with Tracepanel loaded, so it hooks the
+database driver as Nitro loads it:
+
+```ts
+// nuxt.config.ts
+export default defineNuxtConfig({ modules: ["@tracepanel/js/nuxt"] });
+```
+
+```bash
+NODE_OPTIONS=--import=@tracepanel/js/register nuxt dev
+```
+
+The module names each request by its route (`/api/books/:id`), puts the
+badge on server-rendered pages, and records the errors h3 answers with a 500.
+
+### Bun
+
+`serve()` is `Bun.serve` with each route traced under its pattern, and
+`withTracepanel()` wraps any fetch handler, such as Hono's `app.fetch`:
+
+```bash
+bun --preload @tracepanel/js/register server.ts
+```
+
+```ts
+import { serve } from "@tracepanel/js/bun";
+
+serve({
+  routes: {
+    "/api/books/:id": async (req) => Response.json(await findBook(req.params.id)),
+  },
+});
+```
+
+### An SPA on Vite
+
+A single-page app on Vite's dev server gets the badge from the plugin, whatever
+serves its API: an app Tracepanel traces, in Node or in Python. It puts the
+widget into `index.html` and serves the backend's console on Vite's origin,
+from the backend project's `.tracepanel/`:
+
+```ts
+// vite.config.ts
+import { tracepanel } from "@tracepanel/js/vite";
+
+export default { plugins: [tracepanel({ dir: "../backend" })] };
+```
+
+When the page loads before the API's first request, the plugin starts the
+backend's agent itself, as the SDK would. The console answers this machine
+only, even with Vite on the network (`vite --host`): its traces and what it
+lets a local caller do, such as switching the user, are the developer's.
+
+An API on another origin exposes the trace's headers to the page on its CORS
+responses, so the badge lists each call the app makes. A backend that serves
+its own console (Django, FastAPI) is named with `console`:
+
+```ts
+tracepanel({ console: "http://localhost:8000/__tracepanel__/" });
+```
+
+The plugin also records the pages in the browser. Each view (the page's load,
+or a route change) is a trace, and so is each action on it: a click or a
+submit that called the API, named after the control (`click "Save"`), or
+background calls nobody started. Each has its calls, its errors and its
+console, with the line that logged each record, and lasts until its last
+call answered. The console lists them in Pages, the page's view first and
+its actions under it, and the badge's panel lists each action over the
+requests it made.
+
+A call to the page's own origin carries a W3C `traceparent`, so the console
+links it to the API's trace. `propagateTo` names other origins, whose CORS
+must allow the header:
+
+```ts
+tracepanel({ dir: "../backend", browser: { service: "shop-web", propagateTo: ["http://127.0.0.1:8000"] } });
+```
+
+`browser: false` leaves the recording out. Vite's own client logs (its
+connection, hot reload) stay out of the pages' traces.
+
+Without Vite, call `record()` from `@tracepanel/js/browser` in the page, with the
+console on the page's origin (`api`, `/__tracepanel__/` by default).
+`ignoreSources` takes the path prefixes of scripts whose console isn't the
+page's, such as a dev server's client.
+
+## What it records
+
+- HTTP requests, with the route and the handler that served them.
+- SQL from `pg` and `mysql2` (and so Drizzle, Knex, Sequelize, TypeORM and
+  Prisma's driver adapters), with the line of your code that ran each
+  statement. Prisma's operations show as steps.
+- Redis commands (`ioredis`, `redis`) and MongoDB commands, with their own
+  N+1 and duplicates.
+- Outgoing HTTP calls: `fetch()`, and `node:http` clients such as axios.
+- BullMQ: each job a worker runs is a task, each job the app adds a step.
+- `console` calls made during a request, and Nest's `Logger`.
+- Errors thrown in a handler, with your frames and their source.
+- The caller's trace, when a request carries a W3C `traceparent`: the agent
+  links the two.
+
+## Your own steps and traces
+
+```js
+import { span, trace } from "@tracepanel/js";
+
+await trace("nightly cleanup", async () => {
+  await span("load stale rows", () => loadStaleRows());
+});
+```
+
+`trace()` makes a script or a scheduled job a trace of its own, and inside a
+request it is a step. `span()` is a step of the current trace. Outside
+development they run the function and nothing else. Run a script with
+`npx tracepanel run node script.js`.
+
+## Settings
+
+Environment variables, as in the Python SDK:
+
+| Variable | Default | What it sets |
+| --- | --- | --- |
+| `TRACEPANEL_ENABLED` | on unless `NODE_ENV=production` | `0` turns Tracepanel off, `1` on |
+| `TRACEPANEL_SERVICE` | `package.json`'s name | the app's name in the console |
+| `TRACEPANEL_DIR` | `.tracepanel` | the project's store, where the agent keeps the traces |
+| `TRACEPANEL_AGENT_BIN` | the one npm installed | the agent to start, such as a build of your own |
+| `TRACEPANEL_AGENT` | `auto` | an agent elsewhere (`tcp:host:port`), never started |
+| `TRACEPANEL_N_PLUS_ONE_THRESHOLD` | `3` | repeats that make an N+1 |
+| `TRACEPANEL_N_PLUS_ONE_MIN_MS` | `5` | for Redis and other fast stores, the time repeats must take together |
+| `TRACEPANEL_SLOW_SQL_MS` | `100` | a slow query, SQL or MongoDB |
+| `TRACEPANEL_SLOW_HTTP_MS` | `500` | a slow outgoing HTTP call |
+| `TRACEPANEL_LONG_TRANSACTION_MS` | `500` | a long transaction |
+| `TRACEPANEL_QUEUE_WAIT_MS` | `1000` | a task that waited long for a worker |
+| `TRACEPANEL_LARGE_RESULT_ROWS` | `1000` | a query without a LIMIT that read too many rows |
+
+## Command line
+
+| Command | What it does |
+| --- | --- |
+| `tracepanel run <command>` | runs a Node command with Tracepanel on, such as `tracepanel run node server.js` |
+| `tracepanel dev` | runs the agent in the foreground, with the console on http://127.0.0.1:8765/ |
+| `tracepanel mcp` | gives an AI coding agent your traces over MCP |
+
+## License
+
+Licensed under the [MIT License](LICENSE).

package/dist/agent.d.ts

@@ -0,0 +1,42 @@
+import type { Config } from "./config.js";
+import type { Trace } from "./model.js";
+/** Starts the project's agent when none answers, in its own session, serving the console on a free port. */
+export declare class Starter {
+    private readonly storeDir;
+    private failedAt;
+    constructor(storeDir: string);
+    /**
+     * Whether an agent runs for the project: one already does, or this process starts it (RESTART_MS after a failure).
+     * `gone`: the agent at the project's address didn't answer. One that didn't exit cleanly (killed, a reboot) leaves
+     * its addresses: they go before a new one starts.
+     */
+    ensure(gone?: boolean): boolean;
+    private start;
+}
+/** Where the widget loads from and opens the panel: the console the project's agent serves, read every few seconds. */
+export declare class ConsoleUrl {
+    private readonly storeDir;
+    private url;
+    private checked;
+    constructor(storeDir: string);
+    get(): string;
+}
+/** Batches traces to the agent in the background; a full queue drops a trace rather than slow a request down. */
+export declare class Sender {
+    private readonly config;
+    private readonly starter;
+    private queue;
+    private timer;
+    private socket;
+    private connecting;
+    private retryAt;
+    private warned;
+    constructor(config: Config, starter: Starter);
+    submit(trace: Trace): void;
+    private flushSoon;
+    private flush;
+    private connection;
+    private open;
+    /** A connection the agent accepted after the hello line, or undefined. */
+    private handshake;
+}

package/dist/agent.js

@@ -0,0 +1,298 @@
+// Traces go to the project's agent, which finds their issues, keeps them and serves the console. Its addresses are in
+// <store>/agent.addr and console.addr. The wire: a hello line, then frames of a 4-byte big-endian length and a JSON
+// array of traces. The agent starts on demand, as the other SDKs start it, and outlives the app's restarts.
+import { spawn } from "node:child_process";
+import { closeSync, mkdirSync, openSync, readFileSync, rmSync } from "node:fs";
+import { createRequire } from "node:module";
+import { connect } from "node:net";
+import { join } from "node:path";
+import { explain } from "./explain.js";
+const PROTOCOL = 1;
+const QUEUE_SIZE = 1000;
+const BATCH_SIZE = 50;
+const BATCH_WAIT_MS = 50;
+const RETRY_AFTER_MS = 5000;
+const START_WAIT_MS = 1500;
+const CONSOLE_CHECK_MS = 2000;
+const IDLE_EXIT_S = "1800";
+// An agent that exited (idle, killed, replaced by a new build) is started anew at once; one that couldn't start is
+// tried again after this long, not on every trace.
+const RESTART_MS = 30_000;
+function readAddress(path) {
+    try {
+        return readFileSync(path, "utf8").trim();
+    }
+    catch {
+        return "";
+    }
+}
+/** TRACEPANEL_AGENT (an agent outside the app's container, tcp:host:port), or the address the project's agent wrote. */
+function agentAddress(storeDir) {
+    const named = process.env.TRACEPANEL_AGENT;
+    if (named && named !== "auto")
+        return named;
+    return readAddress(join(storeDir, "agent.addr"));
+}
+function autoStart() {
+    const named = process.env.TRACEPANEL_AGENT;
+    return !named || named === "auto";
+}
+/** The agent's binary: TRACEPANEL_AGENT_BIN, or the one npm installed with @tracepanel/agent. */
+function agentBinary() {
+    try {
+        const agent = createRequire(import.meta.url)("@tracepanel/agent");
+        return agent.binaryPath();
+    }
+    catch (error) {
+        warn(error instanceof Error ? error.message : String(error));
+        return undefined;
+    }
+}
+function warn(message) {
+    process.stderr.write(`tracepanel: ${message}\n`);
+}
+/** Starts the project's agent when none answers, in its own session, serving the console on a free port. */
+export class Starter {
+    storeDir;
+    failedAt = Number.NEGATIVE_INFINITY;
+    constructor(storeDir) {
+        this.storeDir = storeDir;
+    }
+    /**
+     * Whether an agent runs for the project: one already does, or this process starts it (RESTART_MS after a failure).
+     * `gone`: the agent at the project's address didn't answer. One that didn't exit cleanly (killed, a reboot) leaves
+     * its addresses: they go before a new one starts.
+     */
+    ensure(gone = false) {
+        if (!gone && agentAddress(this.storeDir))
+            return true;
+        if (!autoStart() || Date.now() - this.failedAt < RESTART_MS)
+            return false;
+        if (gone)
+            for (const name of ["agent.addr", "console.addr"])
+                rmSync(join(this.storeDir, name), { force: true });
+        this.start();
+        const started = agentAddress(this.storeDir) !== "";
+        if (!started)
+            this.failedAt = Date.now();
+        return started;
+    }
+    start() {
+        const binary = agentBinary();
+        if (!binary)
+            return;
+        mkdirSync(this.storeDir, { recursive: true });
+        const log = openSync(join(this.storeDir, "agent.log"), "a");
+        try {
+            const child = spawn(binary, ["--dir", this.storeDir, "--serve", "127.0.0.1:0", "--idle-exit", IDLE_EXIT_S], {
+                detached: true,
+                stdio: ["ignore", log, log],
+            });
+            child.on("error", (error) => warn(`the agent didn't start: ${error.message}`));
+            child.unref();
+        }
+        finally {
+            closeSync(log);
+        }
+        const deadline = Date.now() + START_WAIT_MS;
+        while (Date.now() < deadline && !agentAddress(this.storeDir)) {
+            // The first trace waits a moment for the agent's address: it's the one place a request waits on it.
+            Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 20);
+        }
+        if (!agentAddress(this.storeDir))
+            warn(`the agent didn't start (see ${join(this.storeDir, "agent.log")})`);
+    }
+}
+/** Where the widget loads from and opens the panel: the console the project's agent serves, read every few seconds. */
+export class ConsoleUrl {
+    storeDir;
+    url = "";
+    checked = 0;
+    constructor(storeDir) {
+        this.storeDir = storeDir;
+    }
+    get() {
+        const configured = process.env.TRACEPANEL_CONSOLE_URL;
+        if (configured)
+            return configured.endsWith("/") ? configured : `${configured}/`;
+        if (!this.url || Date.now() - this.checked > CONSOLE_CHECK_MS) {
+            this.checked = Date.now();
+            this.url = readAddress(join(this.storeDir, "console.addr"));
+        }
+        return this.url;
+    }
+}
+/** Batches traces to the agent in the background; a full queue drops a trace rather than slow a request down. */
+export class Sender {
+    config;
+    starter;
+    queue = [];
+    timer;
+    socket;
+    connecting;
+    retryAt = 0;
+    warned = false;
+    constructor(config, starter) {
+        this.config = config;
+        this.starter = starter;
+    }
+    submit(trace) {
+        if (this.queue.length >= QUEUE_SIZE)
+            return;
+        this.queue.push(trace);
+        if (this.queue.length >= BATCH_SIZE)
+            this.flushSoon(0);
+        else
+            this.flushSoon(BATCH_WAIT_MS);
+    }
+    flushSoon(delay) {
+        if (this.timer && delay > 0)
+            return;
+        clearTimeout(this.timer);
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            void this.flush();
+        }, delay);
+        this.timer.unref();
+    }
+    async flush() {
+        const batch = this.queue.splice(0, BATCH_SIZE);
+        if (batch.length === 0)
+            return;
+        const socket = await this.connection();
+        if (!socket)
+            return;
+        const data = Buffer.from(JSON.stringify(batch));
+        const length = Buffer.alloc(4);
+        length.writeUInt32BE(data.length);
+        socket.write(Buffer.concat([length, data]));
+        if (this.queue.length > 0)
+            this.flushSoon(0);
+    }
+    async connection() {
+        if (this.socket && !this.socket.destroyed)
+            return this.socket;
+        if (Date.now() < this.retryAt)
+            return undefined;
+        this.connecting ??= this.open().finally(() => {
+            this.connecting = undefined;
+        });
+        const socket = await this.connecting;
+        if (!socket) {
+            this.retryAt = Date.now() + RETRY_AFTER_MS;
+            if (!this.warned && !autoStart()) {
+                this.warned = true;
+                warn(`no agent at ${agentAddress(this.config.storeDir)}: traces are dropped until it answers`);
+            }
+        }
+        return socket;
+    }
+    async open() {
+        let socket = await this.handshake(agentAddress(this.config.storeDir));
+        if (!socket && this.starter.ensure(true))
+            socket = await this.handshake(agentAddress(this.config.storeDir));
+        if (socket) {
+            this.socket = socket;
+            socket.unref();
+            socket.on("error", () => socket?.destroy());
+            socket.on("close", () => {
+                if (this.socket === socket)
+                    this.socket = undefined;
+            });
+        }
+        return socket;
+    }
+    /** A connection the agent accepted after the hello line, or undefined. */
+    handshake(address) {
+        const target = address.startsWith("unix:")
+            ? { path: address.slice("unix:".length) }
+            : address.startsWith("tcp:")
+                ? hostPort(address.slice("tcp:".length))
+                : undefined;
+        if (!target)
+            return Promise.resolve(undefined);
+        return new Promise((done) => {
+            const socket = connect(target);
+            const fail = () => {
+                socket.destroy();
+                done(undefined);
+            };
+            socket.setTimeout(500, fail);
+            socket.once("error", fail);
+            socket.once("connect", () => {
+                // The agent finds the issues with this project's limits.
+                // It can EXPLAIN a query on the app's database for the console.
+                const hello = {
+                    protocol: PROTOCOL,
+                    max_traces: this.config.maxTraces,
+                    thresholds: this.config.thresholds,
+                    service: this.config.service,
+                    capabilities: ["explain"],
+                };
+                socket.write(`${JSON.stringify(hello)}\n`);
+            });
+            let received = Buffer.alloc(0);
+            socket.on("data", function onData(chunk) {
+                received = Buffer.concat([received, chunk]);
+                const newline = received.indexOf(10);
+                if (newline < 0)
+                    return;
+                socket.off("data", onData);
+                socket.setTimeout(0);
+                socket.removeListener("error", fail);
+                const reply = JSON.parse(received.subarray(0, newline).toString("utf8"));
+                if (reply.ok) {
+                    // The agent's requests come down the same connection, a frame each (EXPLAIN on the app's database): what
+                    // came with the answer is the start of the first.
+                    readFrames(socket, received.subarray(newline + 1), (request) => void answer(socket, request));
+                    done(socket);
+                }
+                else {
+                    warn(`the agent refused: ${reply.error}`);
+                    fail();
+                }
+            });
+        });
+    }
+}
+function hostPort(value) {
+    const at = value.lastIndexOf(":");
+    return { host: value.slice(0, at).replace(/^\[|\]$/g, ""), port: Number(value.slice(at + 1)) };
+}
+function readFrames(socket, start, onFrame) {
+    let pending = Buffer.alloc(0);
+    const read = (chunk) => {
+        pending = Buffer.concat([pending, chunk]);
+        while (pending.length >= 4 && pending.length >= 4 + pending.readUInt32BE(0)) {
+            const length = pending.readUInt32BE(0);
+            const body = pending.subarray(4, 4 + length).toString("utf8");
+            pending = pending.subarray(4 + length);
+            try {
+                onFrame(JSON.parse(body));
+            }
+            catch {
+                // A frame this SDK can't read: the agent times its request out.
+            }
+        }
+    };
+    socket.on("data", read);
+    read(start);
+}
+/** The agent's request run, and its answer sent back up: the rows, or what went wrong. */
+async function answer(socket, request) {
+    if (!request.explain)
+        return;
+    let reply;
+    try {
+        reply = { answer: request.id, ...(await explain(request.explain)) };
+    }
+    catch (error) {
+        reply = { answer: request.id, error: error instanceof Error ? error.message : String(error) };
+    }
+    const data = Buffer.from(JSON.stringify(reply));
+    const length = Buffer.alloc(4);
+    length.writeUInt32BE(data.length);
+    if (!socket.destroyed)
+        socket.write(Buffer.concat([length, data]));
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}

package/dist/api.d.ts

@@ -0,0 +1,11 @@
+import { type Attributes } from "@opentelemetry/api";
+export interface TraceOptions {
+    /** `command` (a script, a cron job; the default) or `task` (a job a worker took). */
+    kind?: "command" | "task";
+    /** Attributes of the trace: task.queue, task.id and the like. */
+    attrs?: Attributes;
+}
+/** Runs the function as a trace of its own: a script, a scheduled job, a worker's job. Inside a trace, a step. */
+export declare function trace<T>(name: string, fn: () => T | Promise<T>, options?: TraceOptions): Promise<Awaited<T>>;
+/** Runs the function as a step of the current trace, with its SQL, calls and logs inside it. */
+export declare function span<T>(name: string, fn: () => T | Promise<T>, attrs?: Attributes): Promise<Awaited<T>>;