@tracepanel/js 0.0.0-stage → 0.2.0

package/dist/browser.d.ts

@@ -0,0 +1,25 @@
+export interface BrowserOptions {
+    /** Where the console is, on the page's origin: "/__tracepanel__/". */
+    api?: string;
+    /** The app's name in the console. "browser" by default. */
+    service?: string;
+    /** Other origins whose calls carry a traceparent (their CORS must allow the header). */
+    propagateTo?: string[];
+    /**
+     * Scripts whose console isn't the page's, by path prefix: a dev server's own client ("/@vite/"). @tracepanel/js/vite
+     * sets Vite's; a library's warnings still count (React's, from /node_modules/).
+     */
+    ignoreSources?: string[];
+}
+/** A view or an action as the widget lists it: announced when it starts (open) and again when it ends. */
+export interface PageAnnouncement {
+    id: string;
+    name: string;
+    /** Microseconds since the epoch. */
+    start: number;
+    /** Microseconds; 0 while open. */
+    duration: number;
+    status: "ok" | "error";
+    open: boolean;
+}
+export declare function record(options?: BrowserOptions): void;

package/dist/browser.js

@@ -0,0 +1,438 @@
+// Tracepanel in the browser: traces of kind page, each a view or an action on it. A view is the page's load or an SPA's
+// route change, named by its path ("/books"); an action is what the user did that called the API or threw, named
+// after it on its page ("/books › click "Save""), and "background" when nobody did anything (a timer, polling). Each
+// has its fetch() and XMLHttpRequest calls, the errors the page throws and its console, and lasts until its last call
+// answered (a view: until the page's load too). Calls to the page's own origin carry a W3C traceparent, so the agent links each to the backend's trace
+// of it. The traces go to the console's address (`api`), which the dev server serves on the page's origin.
+//
+//   import { record } from "@tracepanel/js/browser";
+//   record({ api: "/__tracepanel__/", service: "shop-web" });
+//
+// @tracepanel/js/vite's plugin loads it by itself. Nothing here runs outside a browser, and nothing imports Node.
+//
+// The page's widget shows them too: each view and action is announced on window ("tracepanel:page") when it starts
+// and when it ends, and each response carries the id of the one that made it (Symbol.for("tracepanel.page") on the
+// Response or the XMLHttpRequest), so the panel lists a page's requests under what the user did.
+function announce(trace, open) {
+    const detail = {
+        id: trace.id,
+        name: trace.name,
+        start: trace.start,
+        duration: trace.duration,
+        status: trace.status,
+        open,
+    };
+    const scope = globalThis;
+    const seen = scope[ANNOUNCED] ?? new Map();
+    scope[ANNOUNCED] = seen;
+    seen.delete(detail.id);
+    seen.set(detail.id, detail);
+    if (seen.size > ANNOUNCED_MAX)
+        seen.delete(seen.keys().next().value);
+    window.dispatchEvent(new CustomEvent("tracepanel:page", { detail }));
+}
+// A view is done once nothing happened for this long, or after the longest.
+const QUIET_MS = 1000;
+const LONGEST_MS = 15_000;
+const MAX_SPANS = 500;
+// On a Response or an XMLHttpRequest: the view or action that made the call.
+const PAGE = Symbol.for("tracepanel.page");
+// On globalThis: the latest views and actions announced, for a widget that starts listening after them.
+const ANNOUNCED = Symbol.for("tracepanel.pages");
+const ANNOUNCED_MAX = 50;
+// Calls this soon after a click or a submit are its action's; later ones are background.
+const INTERACTION_MS = 1000;
+const LABEL_LENGTH = 40;
+// What a click names its action after: the control it hit, not the text node or the icon inside it.
+const CONTROL = "[data-tracepanel-name],button,a,[role=button],[role=link],[role=menuitem],[role=tab],input[type=submit]," +
+    "input[type=button],input[type=checkbox],input[type=radio],select,summary,label";
+const CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+const SECRET = /(token|key|secret|password|passwd|pwd|auth|signature|sig|session|credential)/i;
+function hex(bytes) {
+    return Array.from(crypto.getRandomValues(new Uint8Array(bytes)), (b) => b.toString(16).padStart(2, "0")).join("");
+}
+/** A ULID, as the other SDKs make the ids: 48 bits of milliseconds, 80 random bits. */
+function newId() {
+    let value = (BigInt(Date.now()) << 80n) | BigInt(`0x${hex(10)}`);
+    let out = "";
+    for (let i = 0; i < 26; i++) {
+        out = CROCKFORD[Number(value & 31n)] + out;
+        value >>= 5n;
+    }
+    return out;
+}
+/** Now, in microseconds since the epoch, as the agent stores times. */
+function nowUs() {
+    return Math.round((performance.timeOrigin + performance.now()) * 1000);
+}
+/** A performance.now() reading, in microseconds since the epoch. */
+function toUs(ms) {
+    return Math.round((performance.timeOrigin + ms) * 1000);
+}
+/** When the page's load event ended, in microseconds since the epoch: now while it hasn't. */
+function loadEndUs() {
+    const entry = performance.getEntriesByType("navigation")[0];
+    return entry?.loadEventEnd ? toUs(entry.loadEventEnd) : nowUs();
+}
+function safeUrl(raw) {
+    try {
+        const url = new URL(raw, location.href);
+        url.username = "";
+        url.password = "";
+        for (const name of [...url.searchParams.keys()]) {
+            if (SECRET.test(name))
+                url.searchParams.set(name, "***");
+        }
+        return url;
+    }
+    catch {
+        return undefined;
+    }
+}
+function clip(text) {
+    const flat = text.replace(/\s+/g, " ").trim();
+    return flat.length > LABEL_LENGTH ? `${flat.slice(0, LABEL_LENGTH - 1)}…` : flat;
+}
+/**
+ * A control's name, as the user sees it: data-tracepanel-name, its aria-label, its text, else its id or tag. Never a
+ * text field's value: only the caption of a button input.
+ */
+function controlName(element) {
+    const input = element instanceof HTMLInputElement && ["submit", "button"].includes(element.type) ? element.value : "";
+    const text = element instanceof HTMLElement && !(element instanceof HTMLSelectElement) ? element.innerText : "";
+    const name = element.getAttribute("data-tracepanel-name") ||
+        element.getAttribute("aria-label") ||
+        clip(text ?? "") ||
+        input ||
+        element.getAttribute("title") ||
+        (element.id ? `#${element.id}` : "");
+    return name ? `"${clip(name)}"` : element.tagName.toLowerCase();
+}
+/** A form's name: data-tracepanel-name, its aria-label, name or id, else where it posts. */
+function formName(form) {
+    const name = form.getAttribute("data-tracepanel-name") ||
+        form.getAttribute("aria-label") ||
+        form.getAttribute("name") ||
+        (form.id ? `#${form.id}` : "");
+    if (name)
+        return `"${clip(name)}"`;
+    const action = safeUrl(form.getAttribute("action") ?? "");
+    return action ? action.pathname : "form";
+}
+/** Where a console call came from: the first frame of the stack that isn't this script's own. */
+function caller(stack, own) {
+    return frames(stack)
+        .reverse()
+        .find((frame) => frame.filename !== own);
+}
+/** Where a console call was made, as the other SDKs say it: the file and line, and the function when it has a name. */
+function whereLogged(frame) {
+    const named = frame.function !== "<anonymous>" ? { "code.function": frame.function } : {};
+    return { "code.filepath": frame.filename, "code.lineno": frame.lineno, ...named };
+}
+function frames(stack) {
+    const found = [];
+    for (const line of (stack ?? "").split("\n")) {
+        const match = /^\s*at (?:(.+?) \()?(.+?):(\d+):\d+\)?$/.exec(line) ?? /^(.*?)@(.+?):(\d+):\d+$/.exec(line);
+        if (!match)
+            continue;
+        // A script's URL; code with no file of its own (eval, a console) is named as the browser names it: <anonymous>.
+        const raw = match[2] ?? "";
+        const url = /^[a-z][a-z0-9+.-]*:\/\//i.test(raw) ? safeUrl(raw) : undefined;
+        found.push({
+            filename: url ? url.pathname : raw,
+            module: "",
+            function: match[1] || "<anonymous>",
+            lineno: Number(match[3]),
+            in_app: url?.origin === location.origin && !url.pathname.includes("/node_modules/"),
+            context_start: null,
+            context: [],
+            locals: {},
+        });
+    }
+    return found.reverse();
+}
+export function record(options = {}) {
+    const scope = globalThis;
+    if (typeof window === "undefined" || scope.__tracepanelRecording)
+        return;
+    scope.__tracepanelRecording = true;
+    const api = new URL(options.api ?? "/__tracepanel__/", location.href).toString();
+    const propagate = new Set([location.origin, ...(options.propagateTo ?? [])]);
+    const send = window.fetch.bind(window);
+    const ignored = options.ignoreSources ?? [];
+    // This script's own path, to tell a console call's caller from the wrapper it went through.
+    const own = frames(new Error().stack).at(-1)?.filename;
+    let view;
+    let interaction;
+    /** A view (no action: the page's load, a route change) or an action on the page, from `startUs`. */
+    function start(trigger, action, startUs = nowUs()) {
+        const path = location.pathname;
+        const name = action ? `${path} › ${action}` : path;
+        const root = {
+            id: newId(),
+            parent_id: null,
+            kind: "page",
+            name,
+            start: startUs,
+            duration: 0,
+            status: "ok",
+            attrs: {},
+        };
+        const w3cTraceId = hex(16);
+        const started = {
+            trace: {
+                id: newId(),
+                kind: "page",
+                name,
+                start: startUs,
+                duration: 0,
+                status: "ok",
+                attrs: {
+                    "service.name": options.service ?? "browser",
+                    "service.role": "browser",
+                    "telemetry.sdk.language": "webjs",
+                    "page.path": path,
+                    "page.url": `${location.origin}${path}`,
+                    "page.title": document.title,
+                    "page.trigger": trigger,
+                    ...(action ? { "page.action": action } : {}),
+                    "user_agent.original": navigator.userAgent,
+                    "w3c.trace_id": w3cTraceId,
+                },
+                spans: [root],
+                logs: [],
+                errors: [],
+                links: [],
+                issues: [],
+            },
+            root,
+            w3cTraceId,
+            pending: 0,
+            lastActivityMs: performance.now(),
+            endUs: startUs,
+            timer: undefined,
+        };
+        view = started;
+        settleLater(started);
+        announce(started.trace, true);
+        return started;
+    }
+    /** The view goes out once quiet: no call open and nothing new for a second, or after the longest wait. */
+    function settleLater(current) {
+        if (current.timer)
+            clearTimeout(current.timer);
+        current.timer = setTimeout(() => {
+            const loading = current.trace.attrs["page.trigger"] === "load" && document.readyState !== "complete";
+            const quiet = !loading && performance.now() - current.lastActivityMs >= QUIET_MS;
+            const old = nowUs() - current.trace.start >= LONGEST_MS * 1000;
+            if ((current.pending === 0 && quiet) || old)
+                finish(current);
+            else
+                settleLater(current);
+        }, QUIET_MS);
+    }
+    function finish(current) {
+        if (view === current)
+            view = undefined;
+        if (current.timer)
+            clearTimeout(current.timer);
+        // Until its last call answered, not the quiet second after: a view, until the page's load too.
+        const lastSpan = Math.max(...current.trace.spans.map((span) => span.start + span.duration));
+        let end = Math.max(current.endUs, lastSpan, current.trace.start);
+        if (current.trace.attrs["page.trigger"] === "load")
+            end = Math.max(end, loadEndUs());
+        current.trace.duration = end - current.trace.start;
+        current.root.duration = current.trace.duration;
+        // Failed for the user: the page threw, or a call failed (an answer of 5xx, or none).
+        if (current.trace.errors.length > 0 || current.trace.spans.some((span) => span.status === "error")) {
+            current.trace.status = "error";
+        }
+        announce(current.trace, false);
+        void send(`${api}api/ingest`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify([current.trace]),
+            keepalive: true,
+        }).catch(() => undefined);
+    }
+    /**
+     * The trace a call or an error belongs to. Right after a click or a submit: its action, and the trace before it
+     * goes out unless its calls still run (then they share it). Else the open trace, or background activity.
+     */
+    function active() {
+        const done = interaction;
+        if (done && performance.now() - done.atMs < INTERACTION_MS) {
+            interaction = undefined;
+            if (view && view.pending === 0)
+                finish(view);
+            if (!view)
+                return start(done.trigger, `${done.trigger} ${done.label}`, toUs(done.atMs));
+        }
+        return view ?? start("background", "background");
+    }
+    function touch(current) {
+        current.lastActivityMs = performance.now();
+        current.endUs = Math.max(current.endUs, nowUs());
+        settleLater(current);
+    }
+    // What the user does: the calls right after belong to its action. Capture: before the app's own handlers.
+    document.addEventListener("click", (event) => {
+        const target = event.target instanceof Element ? event.target : null;
+        if (!target)
+            return;
+        const control = target.closest(CONTROL) ?? target;
+        interaction = { trigger: "click", label: controlName(control), atMs: event.timeStamp || performance.now() };
+    }, true);
+    document.addEventListener("submit", (event) => {
+        if (!(event.target instanceof HTMLFormElement))
+            return;
+        interaction = { trigger: "submit", label: formName(event.target), atMs: event.timeStamp || performance.now() };
+    }, true);
+    /** A call out of the page, as the other SDKs record theirs: http.client, its W3C span id for the backend's link. */
+    function call(method, raw) {
+        const url = safeUrl(raw);
+        if (!url || url.toString().startsWith(api))
+            return { finish: () => undefined };
+        const current = active();
+        current.pending += 1;
+        const spanId = hex(8);
+        const span = {
+            id: newId(),
+            parent_id: current.root.id,
+            kind: "http.client",
+            name: `${method.toUpperCase()} ${url.host}${url.pathname}`,
+            start: nowUs(),
+            duration: 0,
+            status: "ok",
+            attrs: {
+                "http.request.method": method.toUpperCase(),
+                "url.full": url.toString(),
+                "url.scheme": url.protocol.replace(":", ""),
+                "server.address": url.hostname,
+                "server.port": Number(url.port) || (url.protocol === "https:" ? 443 : 80),
+                "w3c.span_id": spanId,
+            },
+        };
+        if (current.trace.spans.length < MAX_SPANS)
+            current.trace.spans.push(span);
+        return {
+            traceparent: propagate.has(url.origin) ? `00-${current.w3cTraceId}-${spanId}-01` : undefined,
+            page: current.trace.id,
+            finish(status, failed) {
+                span.duration = nowUs() - span.start;
+                current.endUs = Math.max(current.endUs, span.start + span.duration);
+                span.attrs["http.response.status_code"] = status;
+                if (failed || status >= 500)
+                    span.status = "error";
+                current.pending -= 1;
+                touch(current);
+            },
+        };
+    }
+    window.fetch = async (input, init) => {
+        const request = new Request(input, init);
+        const out = call(request.method, request.url);
+        const headers = new Headers(request.headers);
+        if (out.traceparent && !headers.has("traceparent"))
+            headers.set("traceparent", out.traceparent);
+        try {
+            const response = await send(new Request(request, { headers }));
+            out.finish(response.status, false);
+            if (out.page)
+                Object.defineProperty(response, PAGE, { value: out.page });
+            return response;
+        }
+        catch (error) {
+            out.finish(0, true);
+            throw error;
+        }
+    };
+    const open = XMLHttpRequest.prototype.open;
+    const sendXhr = XMLHttpRequest.prototype.send;
+    const calls = new WeakMap();
+    XMLHttpRequest.prototype.open = function (method, url, ...rest) {
+        calls.set(this, { method, url: String(url) });
+        return open.call(this, method, url, ...rest);
+    };
+    XMLHttpRequest.prototype.send = function (body) {
+        const target = calls.get(this);
+        if (target) {
+            const out = call(target.method, target.url);
+            if (out.traceparent)
+                this.setRequestHeader("traceparent", out.traceparent);
+            if (out.page)
+                Object.defineProperty(this, PAGE, { value: out.page, configurable: true });
+            this.addEventListener("loadend", () => out.finish(this.status, this.status === 0));
+        }
+        return sendXhr.call(this, body);
+    };
+    function error(thrown) {
+        const current = active();
+        const err = thrown instanceof Error ? thrown : new Error(String(thrown));
+        current.trace.errors.push({
+            span_id: null,
+            time: nowUs(),
+            type: err.name || "Error",
+            message: err.message,
+            handled: false,
+            frames: frames(err.stack),
+            chain: [],
+        });
+        touch(current);
+    }
+    window.addEventListener("error", (event) => error(event.error ?? event.message));
+    window.addEventListener("unhandledrejection", (event) => error(event.reason));
+    const levels = { debug: "debug", log: "info", info: "info", warn: "warning", error: "error" };
+    for (const [method, level] of Object.entries(levels)) {
+        const original = console[method];
+        if (!original)
+            continue;
+        console[method] = (...args) => {
+            const current = view;
+            const from = current ? caller(new Error().stack, own) : undefined;
+            const source = from?.filename ?? "";
+            if (current && !ignored.some((prefix) => source.startsWith(prefix))) {
+                current.trace.logs.push({
+                    span_id: null,
+                    time: nowUs(),
+                    level,
+                    logger: "console",
+                    message: args.map((arg) => (typeof arg === "string" ? arg : JSON.stringify(arg))).join(" "),
+                    exception: args.find((arg) => arg instanceof Error)?.stack ?? null,
+                    attrs: from ? whereLogged(from) : {},
+                });
+            }
+            original.apply(console, args);
+        };
+    }
+    // An SPA's route change starts a view of the new page.
+    for (const name of ["pushState", "replaceState"]) {
+        const original = history[name];
+        history[name] = function (...args) {
+            const before = location.pathname;
+            const result = original.apply(this, args);
+            if (location.pathname !== before) {
+                if (view)
+                    finish(view);
+                interaction = undefined;
+                start("navigation");
+            }
+            return result;
+        };
+    }
+    window.addEventListener("popstate", () => {
+        if (view)
+            finish(view);
+        interaction = undefined;
+        start("navigation");
+    });
+    // The tab going away: what is open goes out now.
+    window.addEventListener("pagehide", () => {
+        if (view)
+            finish(view);
+    });
+    // The first view started when the browser began loading the page.
+    start("load", undefined, Math.round(performance.timeOrigin * 1000));
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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

package/dist/bullmq.d.ts

@@ -0,0 +1,7 @@
+import { InstrumentationBase, InstrumentationNodeModuleDefinition } from "@opentelemetry/instrumentation";
+export declare class BullMQInstrumentation extends InstrumentationBase {
+    constructor();
+    protected init(): InstrumentationNodeModuleDefinition;
+    private processJob;
+    private add;
+}

package/dist/bullmq.js

@@ -0,0 +1,86 @@
+// BullMQ: each job a worker runs is a task trace, and each job the app adds is a task.enqueue step of the request
+// that added it, as the Python SDK records Celery's and RQ's.
+import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
+import { InstrumentationBase, InstrumentationNodeModuleDefinition, isWrapped } from "@opentelemetry/instrumentation";
+const SYSTEM = "bullmq";
+function taskAttrs(job) {
+    const enqueued = job.timestamp + (job.delay ?? 0);
+    return {
+        "task.system": SYSTEM,
+        "task.name": job.name,
+        "task.id": job.id ?? "",
+        "task.queue": job.queueName,
+        "task.retries": job.attemptsMade,
+        "task.eager": false,
+        // How long it waited for a worker, in microseconds: the agent's queue-wait issue.
+        "task.queue_wait": Math.max(Date.now() - enqueued, 0) * 1000,
+    };
+}
+export class BullMQInstrumentation extends InstrumentationBase {
+    constructor() {
+        super("tracepanel-bullmq", "1.0.0", {});
+    }
+    init() {
+        return new InstrumentationNodeModuleDefinition("bullmq", [">=5"], (exports) => {
+            const worker = exports.Worker?.prototype;
+            if (typeof worker?.callProcessJob === "function" && !isWrapped(worker.callProcessJob)) {
+                this._wrap(worker, "callProcessJob", (original) => this.processJob(original));
+            }
+            const queue = exports.Queue?.prototype;
+            if (typeof queue?.add === "function" && !isWrapped(queue.add)) {
+                this._wrap(queue, "add", (original) => this.add(original));
+            }
+            return exports;
+        });
+    }
+    processJob(original) {
+        const tracer = this.tracer;
+        return function (job, ...rest) {
+            const attributes = { ...taskAttrs(job), "tracepanel.kind": "task", "tracepanel.name": job.name };
+            return tracer.startActiveSpan(job.name, { kind: SpanKind.CONSUMER, attributes }, async (span) => {
+                try {
+                    const result = await original.call(this, job, ...rest);
+                    span.setAttribute("task.state", "SUCCESS");
+                    return result;
+                }
+                catch (error) {
+                    // BullMQ tries again while attempts are left: this run is a retry, the last one a failure.
+                    const retried = job.attemptsMade + 1 < (job.opts?.attempts ?? 1);
+                    span.setAttribute("task.state", retried ? "RETRY" : "FAILURE");
+                    span.recordException(error);
+                    span.setStatus({ code: SpanStatusCode.ERROR });
+                    throw error;
+                }
+                finally {
+                    span.end();
+                }
+            });
+        };
+    }
+    add(original) {
+        const tracer = this.tracer;
+        return function (name, ...rest) {
+            // Outside a request or a task (a script adding jobs) there is no trace to add the step to.
+            if (!trace.getActiveSpan())
+                return original.call(this, name, ...rest);
+            const attributes = {
+                "tracepanel.span_kind": "task.enqueue",
+                "task.system": SYSTEM,
+                "task.name": name,
+                "task.queue": this.name,
+            };
+            return tracer.startActiveSpan(`enqueue ${name}`, { kind: SpanKind.PRODUCER, attributes }, async (span) => {
+                try {
+                    const job = await original.call(this, name, ...rest);
+                    if (job?.id)
+                        span.setAttribute("task.id", job.id);
+                    return job;
+                }
+                finally {
+                    span.end();
+                }
+            });
+        };
+    }
+}
+//# sourceMappingURL=bullmq.js.map

package/dist/bullmq.js.map

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

package/dist/bun.d.ts

@@ -0,0 +1,15 @@
+type Handler = (request: Request, server?: unknown) => Response | Promise<Response>;
+type ErrorHandler = (error: Error) => Response | Promise<Response>;
+type Routes = Record<string, Handler | Record<string, Handler> | Response>;
+/**
+ * The handler, in a server span for each request: its route, status, errors; the badge's headers and script. An
+ * error it throws is answered here, by `onError` (Bun.serve's `error` option) or a 500, so the answer has its trace.
+ */
+export declare function withTracepanel<H extends Handler>(handler: H, route?: string, onError?: ErrorHandler): H;
+/** Bun.serve, with every route and the fetch fallback traced. */
+export declare function serve<T extends {
+    routes?: Routes;
+    fetch?: Handler;
+    error?: ErrorHandler;
+}>(options: T): unknown;
+export {};