@wizeworks/lens-node 0.0.0-stage → 0.3.0-alpha.2

package/dist/persist.js

@@ -0,0 +1,159 @@
+import { untraced } from "./db.js";
+import { mkdirSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname } from "node:path";
+import { ATTR_BROWSER_SESSION } from "@wizeworks/lens-core";
+import { prepareStatements, SCHEMA, SCHEMA_VERSION } from "./persist-schema.js";
+import { hookProcessExit, parseArray } from "./persist-util.js";
+const require = createRequire(import.meta.url);
+/** Writes the store to a SQLite file and loads it back on startup; any error turns it off with one warning. */
+export class SqlitePersister {
+    path;
+    #store;
+    #options;
+    #now;
+    #db;
+    #stmts;
+    #timer;
+    #failed = false;
+    #unhook;
+    constructor(store, options) {
+        this.#store = store;
+        this.#options = options;
+        this.path = options.path;
+        this.#now = options.now ?? Date.now;
+    }
+    get active() {
+        return this.#db !== undefined && !this.#failed;
+    }
+    /** Open the file, prune it, and load recent traces into the store. Returns false on failure. */
+    open() {
+        return untraced(() => this.#openFile());
+    }
+    #openFile() {
+        try {
+            // Loaded lazily so `storage: "memory"` never touches node:sqlite.
+            const { DatabaseSync } = require("node:sqlite");
+            mkdirSync(dirname(this.path), { recursive: true });
+            const db = new DatabaseSync(this.path);
+            this.#db = db;
+            db.exec("PRAGMA journal_mode = WAL; PRAGMA synchronous = NORMAL; PRAGMA busy_timeout = 2000;");
+            db.exec(SCHEMA);
+            const setMeta = db.prepare("INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value");
+            setMeta.run("schema", SCHEMA_VERSION);
+            setMeta.run("service", this.#options.serviceName);
+            this.#stmts = prepareStatements(db);
+            this.#prune();
+            this.#store.load(this.#loadRecent());
+            return true;
+        }
+        catch (err) {
+            this.#fail(err);
+            return false;
+        }
+    }
+    /** Flush every `intervalMs`, and once more when the process exits. */
+    start() {
+        if (!this.active || this.#timer)
+            return;
+        this.#timer = setInterval(() => this.flush(), this.#options.intervalMs ?? 500);
+        this.#timer.unref();
+        this.#unhook = hookProcessExit(() => this.flush());
+    }
+    /** Write all changed traces in one transaction, then prune. Synchronous on purpose (safe in `exit`). */
+    flush() {
+        untraced(() => this.#flushNow());
+    }
+    #flushNow() {
+        const db = this.#db;
+        const stmts = this.#stmts;
+        if (!db || !stmts || this.#failed)
+            return;
+        const changes = this.#store.drainChanges();
+        if (changes.length === 0)
+            return;
+        const now = this.#now();
+        try {
+            db.exec("BEGIN");
+            for (const c of changes) {
+                stmts.upsertTrace.run(c.traceId, c.startMs, now, JSON.stringify(c.remotes));
+                for (const s of c.spans) {
+                    const session = s.attributes[ATTR_BROWSER_SESSION];
+                    stmts.upsertSpan.run(s.traceId, s.spanId, s.parentSpanId, s.name, s.kind, s.category, s.service, s.startMs, s.durationMs, s.status, typeof session === "string" && session ? session : null, JSON.stringify(s));
+                }
+                for (const { seq, log } of c.logs)
+                    stmts.insertLog.run(c.traceId, seq, log.timeMs, log.level, JSON.stringify(log));
+            }
+            this.#prune();
+            db.exec("COMMIT");
+        }
+        catch (err) {
+            try {
+                db.exec("ROLLBACK");
+            }
+            catch {
+                // already rolled back
+            }
+            this.#fail(err);
+        }
+    }
+    /** Final flush, then close the file. */
+    close() {
+        if (this.#timer)
+            clearInterval(this.#timer);
+        this.#timer = undefined;
+        this.#unhook?.();
+        this.#unhook = undefined;
+        this.flush();
+        try {
+            this.#db?.close();
+        }
+        catch {
+            // closing is best effort
+        }
+        this.#db = undefined;
+    }
+    #prune() {
+        const stmts = this.#stmts;
+        stmts.pruneAge.run(this.#now() - this.#store.maxAgeMs);
+        stmts.pruneCount.run(this.#store.maxTraces);
+        stmts.pruneSpans.run();
+        stmts.pruneLogs.run();
+    }
+    #loadRecent() {
+        const db = this.#db;
+        const rows = db
+            .prepare("SELECT trace_id, start_ms, remotes FROM traces ORDER BY start_ms DESC LIMIT ?")
+            .all(this.#store.maxTraces);
+        const spansOf = db.prepare("SELECT json FROM spans WHERE trace_id = ?");
+        const logsOf = db.prepare("SELECT json FROM logs WHERE trace_id = ? ORDER BY seq");
+        // Oldest first, so the ring buffer evicts in the right order.
+        return rows.reverse().map((r) => ({
+            traceId: r.trace_id,
+            startMs: r.start_ms,
+            remotes: parseArray(r.remotes),
+            spans: spansOf.all(r.trace_id).map((x) => JSON.parse(x.json)),
+            logs: logsOf.all(r.trace_id).map((x) => JSON.parse(x.json)),
+        }));
+    }
+    #fail(err) {
+        if (this.#failed)
+            return;
+        this.#failed = true;
+        if (this.#timer)
+            clearInterval(this.#timer);
+        this.#timer = undefined;
+        this.#unhook?.();
+        this.#unhook = undefined;
+        try {
+            this.#db?.close();
+        }
+        catch {
+            // ignore
+        }
+        this.#db = undefined;
+        const message = err instanceof Error ? err.message : String(err);
+        (this.#options.warn ?? console.warn)(`[wizelens] Could not use the trace file ${this.path} (${message}). Traces are kept in memory only.`);
+    }
+}
+//# sourceMappingURL=persist.js.map

package/dist/persist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.js","sourceRoot":"","sources":["../src/persist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,oBAAoB,EAA6B,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,cAAc,EAAmB,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGhE,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAa/C,+GAA+G;AAC/G,MAAM,OAAO,eAAe;IACjB,IAAI,CAAS;IACb,MAAM,CAAa;IACnB,QAAQ,CAAmB;IAC3B,IAAI,CAAe;IAC5B,GAAG,CAA2B;IAC9B,MAAM,CAAyB;IAC/B,MAAM,CAA6C;IACnD,OAAO,GAAG,KAAK,CAAC;IAChB,OAAO,CAA2B;IAElC,YAAY,KAAiB,EAAE,OAAyB;QACtD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACtC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IACjD,CAAC;IAED,gGAAgG;IAChG,IAAI;QACF,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,SAAS;QACP,IAAI,CAAC;YACH,kEAAkE;YAClE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,aAAa,CAAiC,CAAC;YAChF,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;YACd,EAAE,CAAC,IAAI,CAAC,qFAAqF,CAAC,CAAC;YAC/F,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChB,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,mGAAmG,CAAC,CAAC;YAChI,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAClD,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;QAC/E,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,wGAAwG;IACxG,KAAK;QACH,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,SAAS;QACP,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACjB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC5E,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;oBACxB,MAAM,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;oBACnD,KAAK,CAAC,UAAU,CAAC,GAAG,CAClB,CAAC,CAAC,OAAO,EACT,CAAC,CAAC,MAAM,EACR,CAAC,CAAC,YAAY,EACd,CAAC,CAAC,IAAI,EACN,CAAC,CAAC,IAAI,EACN,CAAC,CAAC,QAAQ,EACV,CAAC,CAAC,OAAO,EACT,CAAC,CAAC,OAAO,EACT,CAAC,CAAC,UAAU,EACZ,CAAC,CAAC,MAAM,EACR,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EACvD,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAClB,CAAC;gBACJ,CAAC;gBACD,KAAK,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI;oBAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;YACrH,CAAC;YACD,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QACD,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;IACvB,CAAC;IAED,MAAM;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,MAAO,CAAC;QAC3B,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvD,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5C,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;IACxB,CAAC;IAED,WAAW;QACT,MAAM,EAAE,GAAG,IAAI,CAAC,GAAI,CAAC;QACrB,MAAM,IAAI,GAAG,EAAE;aACZ,OAAO,CAAC,+EAA+E,CAAC;aACxF,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAA8D,CAAC;QAC3F,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,uDAAuD,CAAC,CAAC;QACnF,8DAA8D;QAC9D,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,OAAO,EAAE,CAAC,CAAC,QAAQ;YACnB,OAAO,EAAE,CAAC,CAAC,QAAQ;YACnB,OAAO,EAAE,UAAU,CAAS,CAAC,CAAC,OAAO,CAAC;YACtC,KAAK,EAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAwB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAS,CAAC;YAC7F,IAAI,EAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAwB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAc,CAAC;SACjG,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAY;QAChB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,IAAI,CAAC,MAAM;YAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;QACrB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAClC,2CAA2C,IAAI,CAAC,IAAI,KAAK,OAAO,oCAAoC,CACrG,CAAC;IACJ,CAAC;CACF"}

package/dist/precise.d.ts

@@ -0,0 +1,8 @@
+import { type Tracer, type TracerProvider } from "@opentelemetry/api";
+/** Epoch ms with sub-ms precision. OTel anchors each span on Date.now(), which is whole ms only. */
+export declare const preciseNow: () => number;
+/** A tracer that gives every span an exact start and end, so sub-ms queries keep their order. */
+export declare function preciseTracer(tracer: Tracer): Tracer;
+/** The same, for instrumentations that ask a provider for their tracer. */
+export declare function preciseProvider(provider: TracerProvider): TracerProvider;
+//# sourceMappingURL=precise.d.ts.map

package/dist/precise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precise.d.ts","sourceRoot":"","sources":["../src/precise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE1I,oGAAoG;AACpG,eAAO,MAAM,UAAU,QAAO,MAAoD,CAAC;AAmBnF,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CAExE"}

package/dist/precise.js

@@ -0,0 +1,28 @@
+import { context } from "@opentelemetry/api";
+/** Epoch ms with sub-ms precision. OTel anchors each span on Date.now(), which is whole ms only. */
+export const preciseNow = () => performance.timeOrigin + performance.now();
+function preciseSpan(span) {
+    const end = span.end.bind(span);
+    span.end = (time) => end(time ?? preciseNow());
+    return span;
+}
+/** startActiveSpan with an exact start and end. Next.js starts all its spans this way. */
+function preciseActive(tracer) {
+    const start = tracer.startActiveSpan.bind(tracer);
+    return ((name, ...rest) => {
+        const fn = rest.pop();
+        const [options = {}, ctx = context.active()] = rest;
+        const timed = { ...options, startTime: options.startTime ?? preciseNow() };
+        return start(name, timed, ctx, (span) => fn(preciseSpan(span)));
+    });
+}
+/** A tracer that gives every span an exact start and end, so sub-ms queries keep their order. */
+export function preciseTracer(tracer) {
+    const startSpan = (name, options = {}, ctx) => preciseSpan(tracer.startSpan(name, { ...options, startTime: options.startTime ?? preciseNow() }, ctx));
+    return { startSpan, startActiveSpan: preciseActive(tracer) };
+}
+/** The same, for instrumentations that ask a provider for their tracer. */
+export function preciseProvider(provider) {
+    return { getTracer: (name, version, options) => preciseTracer(provider.getTracer(name, version, options)) };
+}
+//# sourceMappingURL=precise.js.map

package/dist/precise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"precise.js","sourceRoot":"","sources":["../src/precise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,OAAO,EAAiF,MAAM,oBAAoB,CAAC;AAE1I,oGAAoG;AACpG,MAAM,CAAC,MAAM,UAAU,GAAG,GAAW,EAAE,CAAC,WAAW,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;AAEnF,SAAS,WAAW,CAAC,IAAU;IAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAgB,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,UAAU,EAAE,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0FAA0F;AAC1F,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAgF,CAAC;IACjI,OAAO,CAAC,CAAC,IAAY,EAAE,GAAG,IAAe,EAAE,EAAE;QAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAA6B,CAAC;QACjD,MAAM,CAAC,OAAO,GAAG,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,IAAsD,CAAC;QACtG,MAAM,KAAK,GAAG,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,UAAU,EAAE,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC,CAA8B,CAAC;AAClC,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,OAAO,GAAgB,EAAE,EAAE,GAAa,EAAQ,EAAE,CACjF,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,UAAU,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IACzG,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,QAAwB;IACtD,OAAO,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;AAC9G,CAAC"}

package/dist/processor.d.ts

@@ -0,0 +1,20 @@
+import { type Context } from "@opentelemetry/api";
+import type { ReadableSpan, Span as SdkSpan, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { type Span } from "@wizeworks/lens-core";
+import type { TraceStore } from "./store.js";
+/** Set this attribute to force a contract category. Removed before storing. */
+export declare const CATEGORY_ATTR = "wizelens.category";
+/** Map a finished OTel span to a contract Span. */
+export declare function toContractSpan(span: ReadableSpan, service: string, redactKeys: readonly string[]): Span;
+/** SpanProcessor that writes every finished span into the in-memory store. */
+export declare class StoreSpanProcessor implements SpanProcessor {
+    private readonly store;
+    private readonly service;
+    private readonly redactKeys;
+    constructor(store: TraceStore, service: string, redactKeys: readonly string[]);
+    onStart(_span: SdkSpan, _parentContext: Context): void;
+    onEnd(span: ReadableSpan): void;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=processor.d.ts.map

package/dist/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../src/processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAA4B,MAAM,oBAAoB,CAAC;AAE5E,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,IAAI,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAClG,OAAO,EAEL,KAAK,IAAI,EAMV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,+EAA+E;AAC/E,eAAO,MAAM,aAAa,sBAAsB,CAAC;AA0CjD,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CA0BvG;AAED,8EAA8E;AAC9E,qBAAa,kBAAmB,YAAW,aAAa;IAEpD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAH7B,YACmB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,SAAS,MAAM,EAAE,EAC5C;IAEJ,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,GAAG,IAAI,CAAG;IAEzD,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAI9B;IAED,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;IAED,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAExB;CACF"}

package/dist/processor.js

@@ -0,0 +1,102 @@
+import { SpanKind, SpanStatusCode } from "@opentelemetry/api";
+import { hrTimeToMilliseconds } from "@opentelemetry/core";
+import { isDbCall, redactAttributes, toAttributeValue, } from "@wizeworks/lens-core";
+/** Set this attribute to force a contract category. Removed before storing. */
+export const CATEGORY_ATTR = "wizelens.category";
+const KINDS = {
+    [SpanKind.INTERNAL]: "internal",
+    [SpanKind.SERVER]: "server",
+    [SpanKind.CLIENT]: "client",
+    [SpanKind.PRODUCER]: "producer",
+    [SpanKind.CONSUMER]: "consumer",
+};
+function toAttributes(attrs) {
+    const out = {};
+    for (const [k, v] of Object.entries(attrs))
+        out[k] = toAttributeValue(v);
+    return out;
+}
+function categoryOf(span, attrs) {
+    const forced = attrs[CATEGORY_ATTR];
+    if (typeof forced === "string")
+        return forced;
+    if (attrs["messaging.system"] != null)
+        return "messaging";
+    if (isDbCall(attrs))
+        return "db";
+    if (span.kind === SpanKind.SERVER && attrs["rpc.system"] != null)
+        return "http.server";
+    if (span.kind === SpanKind.CLIENT && attrs["rpc.system"] != null)
+        return "http.client";
+    if (span.kind === SpanKind.SERVER && attrs["http.request.method"] != null)
+        return "http.server";
+    if (span.kind === SpanKind.CLIENT && attrs["http.request.method"] != null)
+        return "http.client";
+    return "internal";
+}
+function clientName(attrs, fallback) {
+    const method = String(attrs["http.request.method"] ?? fallback);
+    const full = attrs["url.full"];
+    if (typeof full === "string") {
+        try {
+            const u = new URL(full);
+            return `${method} ${u.host}${u.pathname}`;
+        }
+        catch {
+            // keep fallback
+        }
+    }
+    return fallback;
+}
+/** Map a finished OTel span to a contract Span. */
+export function toContractSpan(span, service, redactKeys) {
+    const ctx = span.spanContext();
+    const raw = toAttributes(span.attributes);
+    const category = categoryOf(span, raw);
+    delete raw[CATEGORY_ATTR];
+    const attributes = redactAttributes(raw, redactKeys);
+    const status = span.status.code === SpanStatusCode.ERROR ? "error" : span.status.code === SpanStatusCode.OK ? "ok" : "unset";
+    return {
+        traceId: ctx.traceId,
+        spanId: ctx.spanId,
+        parentSpanId: span.parentSpanContext?.spanId ?? null,
+        name: category === "http.client" ? clientName(attributes, span.name) : span.name,
+        kind: KINDS[span.kind] ?? "internal",
+        category,
+        service,
+        startMs: hrTimeToMilliseconds(span.startTime),
+        durationMs: hrTimeToMilliseconds(span.duration),
+        status,
+        statusMessage: span.status.message ?? null,
+        attributes,
+        events: span.events.map((e) => ({
+            name: e.name,
+            timeMs: hrTimeToMilliseconds(e.time),
+            attributes: redactAttributes(toAttributes(e.attributes ?? {}), redactKeys),
+        })),
+    };
+}
+/** SpanProcessor that writes every finished span into the in-memory store. */
+export class StoreSpanProcessor {
+    store;
+    service;
+    redactKeys;
+    constructor(store, service, redactKeys) {
+        this.store = store;
+        this.service = service;
+        this.redactKeys = redactKeys;
+    }
+    onStart(_span, _parentContext) { }
+    onEnd(span) {
+        // A local root has no parent, or a parent in another process.
+        const parent = span.parentSpanContext;
+        this.store.addSpan(toContractSpan(span, this.service, this.redactKeys), !parent || !!parent.isRemote);
+    }
+    forceFlush() {
+        return Promise.resolve();
+    }
+    shutdown() {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=processor.js.map

package/dist/processor.js.map

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

package/dist/request-api.d.ts

@@ -0,0 +1,12 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { LogWriter } from "./logger.js";
+import type { Next } from "./types.js";
+/** Tag the running request. A tag without a value is stored as `true`. */
+export declare function tag(key: string, value?: string): void;
+/** Set `enduser.id` on the running request. */
+export declare function setUser(id: string): void;
+/** Record an exception on the innermost active span. */
+export declare function recordException(err: unknown): void;
+/** Express error middleware: records the error on the request span and as an error log. */
+export declare function createErrorMiddleware(write: LogWriter, service: string): (err: unknown, req: IncomingMessage, _res: ServerResponse, next: Next) => void;
+//# sourceMappingURL=request-api.d.ts.map

package/dist/request-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-api.d.ts","sourceRoot":"","sources":["../src/request-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,0EAA0E;AAC1E,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAGrD;AAED,+CAA+C;AAC/C,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAExC;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAGlD;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,SAChC,OAAO,OAAO,eAAe,QAAQ,cAAc,QAAQ,IAAI,KAAG,IAAI,CAM5G"}

package/dist/request-api.js

@@ -0,0 +1,31 @@
+import { TAG_PREFIX } from "@wizeworks/lens-core";
+import { requestSpan } from "./capture.js";
+import { activeSpan, currentServerSpan, recordOn } from "./spans.js";
+/** Tag the running request. A tag without a value is stored as `true`. */
+export function tag(key, value) {
+    const k = key.trim();
+    if (k)
+        currentServerSpan()?.setAttribute(`${TAG_PREFIX}${k}`, value ?? true);
+}
+/** Set `enduser.id` on the running request. */
+export function setUser(id) {
+    if (id)
+        currentServerSpan()?.setAttribute("enduser.id", id);
+}
+/** Record an exception on the innermost active span. */
+export function recordException(err) {
+    const span = activeSpan();
+    if (span)
+        recordOn(span, err);
+}
+/** Express error middleware: records the error on the request span and as an error log. */
+export function createErrorMiddleware(write, service) {
+    return function errorMiddleware(err, req, _res, next) {
+        const span = requestSpan(req) ?? activeSpan();
+        if (span)
+            recordOn(span, err);
+        write("error", service, err instanceof Error ? err.message : String(err));
+        next(err);
+    };
+}
+//# sourceMappingURL=request-api.js.map

package/dist/request-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-api.js","sourceRoot":"","sources":["../src/request-api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGrE,0EAA0E;AAC1E,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,KAAc;IAC7C,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC;QAAE,iBAAiB,EAAE,EAAE,YAAY,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC;AAC/E,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,IAAI,EAAE;QAAE,iBAAiB,EAAE,EAAE,YAAY,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,IAAI,IAAI;QAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,qBAAqB,CAAC,KAAgB,EAAE,OAAe;IACrE,OAAO,SAAS,eAAe,CAAC,GAAY,EAAE,GAAoB,EAAE,IAAoB,EAAE,IAAU;QAClG,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,UAAU,EAAE,CAAC;QAC9C,IAAI,IAAI;YAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9B,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC"}

package/dist/request-attributes.d.ts

@@ -0,0 +1,9 @@
+import type { IncomingHttpHeaders, IncomingMessage, OutgoingHttpHeaders } from "node:http";
+import type { Attributes as OtelAttributes } from "@opentelemetry/api";
+/** Headers as `{prefix}{lower-case name}` attributes. Redaction happens when the span is stored. */
+export declare function headerAttributes(headers: IncomingHttpHeaders | OutgoingHttpHeaders, prefix: string): OtelAttributes;
+/** First X-Forwarded-For address, else the socket peer. IPv4-mapped IPv6 is shown as IPv4. */
+export declare function clientAddress(req: IncomingMessage): string | undefined;
+/** Attributes known when the request starts. */
+export declare function requestAttributes(req: IncomingMessage, method: string, path: string, rawUrl: string): OtelAttributes;
+//# sourceMappingURL=request-attributes.d.ts.map

package/dist/request-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-attributes.d.ts","sourceRoot":"","sources":["../src/request-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQvE,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAUnH;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAkBpH"}

package/dist/request-attributes.js

@@ -0,0 +1,48 @@
+import { REQUEST_HEADER_PREFIX } from "@wizeworks/lens-core";
+import { firstHeader } from "./http-util.js";
+import { CATEGORY_ATTR } from "./processor.js";
+const MAX_HEADERS = 50;
+const MAX_HEADER_VALUE = 1024;
+/** Headers as `{prefix}{lower-case name}` attributes. Redaction happens when the span is stored. */
+export function headerAttributes(headers, prefix) {
+    const out = {};
+    let count = 0;
+    for (const [name, value] of Object.entries(headers)) {
+        if (value === undefined || count >= MAX_HEADERS)
+            continue;
+        const text = Array.isArray(value) ? value.join(", ") : String(value);
+        out[`${prefix}${name.toLowerCase()}`] = text.slice(0, MAX_HEADER_VALUE);
+        count++;
+    }
+    return out;
+}
+/** First X-Forwarded-For address, else the socket peer. IPv4-mapped IPv6 is shown as IPv4. */
+export function clientAddress(req) {
+    const raw = firstHeader(req.headers["x-forwarded-for"]) ?? req.socket?.remoteAddress;
+    return raw?.replace(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/, "$1");
+}
+/** Attributes known when the request starts. */
+export function requestAttributes(req, method, path, rawUrl) {
+    const host = req.headers.host ?? "";
+    const attributes = {
+        [CATEGORY_ATTR]: "http.server",
+        "http.request.method": method,
+        "url.path": path,
+        "server.address": host.split(":")[0] ?? host,
+        ...headerAttributes(req.headers, REQUEST_HEADER_PREFIX),
+    };
+    const query = rawUrl.includes("?") ? rawUrl.slice(rawUrl.indexOf("?") + 1) : "";
+    if (query)
+        attributes["url.query"] = query;
+    const ua = req.headers["user-agent"];
+    if (ua)
+        attributes["user_agent.original"] = ua;
+    const client = clientAddress(req);
+    if (client)
+        attributes["client.address"] = client;
+    const size = Number(req.headers["content-length"]);
+    if (Number.isFinite(size) && size >= 0 && req.headers["content-length"] !== undefined)
+        attributes["http.request.body.size"] = size;
+    return attributes;
+}
+//# sourceMappingURL=request-attributes.js.map

package/dist/request-attributes.js.map

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

package/dist/request-capture.d.ts

@@ -0,0 +1,32 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import { type Context, type Span as OtelSpan, type Tracer } from "@opentelemetry/api";
+import type { W3CTraceContextPropagator } from "@opentelemetry/core";
+export interface CaptureDeps {
+    tracer: Tracer;
+    basePath: string;
+    publicEndpoint: string | undefined;
+    selfEndpoints: Set<string>;
+    w3c: W3CTraceContextPropagator;
+    captureResponseBody: boolean;
+    handler: (req: IncomingMessage, res: ServerResponse) => Promise<boolean>;
+}
+/** One captured request: its server span and the context that makes it the parent of everything inside. */
+export interface CapturedRequest {
+    span: OtelSpan;
+    ctx: Context;
+    startedAt: number;
+}
+/** The route template ("/orders/:id"), read when the response is done. Undefined when unknown. */
+export type RouteOf = () => string | undefined;
+/** Path of a raw url without the query. */
+export declare const pathOf: (rawUrl: string) => string;
+export declare const isOwnPath: (d: CaptureDeps, path: string) => boolean;
+/** A CORS preflight. The browser sends it before a cross-origin call, with no traceparent, so it is not traced. */
+export declare const isPreflight: (req: IncomingMessage) => boolean;
+/** Serve the dashboard and API. Resolves when the response is written. */
+export declare function serveOwnPath(d: CaptureDeps, req: IncomingMessage, res: ServerResponse): Promise<void>;
+/** Start the server span of one request on the raw Node objects. Works for any framework that runs on node:http. */
+export declare function captureRequest(d: CaptureDeps, req: IncomingMessage, res: ServerResponse, rawUrl: string, routeOf: RouteOf): CapturedRequest;
+/** The server span WizeLens started for this request, if any. */
+export declare function requestSpan(req: IncomingMessage): OtelSpan | undefined;
+//# sourceMappingURL=request-capture.d.ts.map

package/dist/request-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-capture.d.ts","sourceRoot":"","sources":["../src/request-capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAAE,KAAK,OAAO,EAAyB,KAAK,IAAI,IAAI,QAAQ,EAAmC,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC9I,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAmBrE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,GAAG,EAAE,yBAAyB,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED,2GAA2G;AAC3G,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kGAAkG;AAClG,MAAM,MAAM,OAAO,GAAG,MAAM,MAAM,GAAG,SAAS,CAAC;AAS/C,2CAA2C;AAC3C,eAAO,MAAM,MAAM,WAAY,MAAM,KAAG,MAAqC,CAAC;AAE9E,eAAO,MAAM,SAAS,MAAO,WAAW,QAAQ,MAAM,KAAG,OAAmE,CAAC;AAE7H,mHAAmH;AACnH,eAAO,MAAM,WAAW,QAAS,eAAe,KAAG,OAAiG,CAAC;AAErJ,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAQrG;AAkCD,oHAAoH;AACpH,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe,CAwB3I;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,QAAQ,GAAG,SAAS,CAEtE"}

package/dist/request-capture.js

@@ -0,0 +1,94 @@
+import { context, ROOT_CONTEXT, SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
+import { ATTR_REQUEST_ABORTED, ATTR_REQUEST_ID, ATTR_RESPONSE_BODY, ATTR_RESPONSE_BODY_TRUNCATED, HEADER_ENDPOINT, HEADER_TRACE, RESPONSE_HEADER_PREFIX, serverTimingValue, } from "@wizeworks/lens-core";
+import { tapResponse } from "./body-capture.js";
+import { keepExposeHeaders } from "./expose-headers.js";
+import { firstHeader, sendJson } from "./http-util.js";
+import { headerAttributes, requestAttributes } from "./request-attributes.js";
+import { SERVER_SPAN } from "./spans.js";
+const REQ_SPAN = Symbol.for("wizeworks.wizelens.span");
+function endpointFor(req, d) {
+    if (d.publicEndpoint)
+        return d.publicEndpoint;
+    const proto = firstHeader(req.headers["x-forwarded-proto"]) ?? (req.socket.encrypted ? "https" : "http");
+    const host = firstHeader(req.headers["x-forwarded-host"]) ?? req.headers.host ?? "localhost";
+    return `${proto}://${host}${d.basePath}`;
+}
+/** Path of a raw url without the query. */
+export const pathOf = (rawUrl) => rawUrl.split("?")[0] ?? "/";
+export const isOwnPath = (d, path) => path === d.basePath || path.startsWith(d.basePath + "/");
+/** A CORS preflight. The browser sends it before a cross-origin call, with no traceparent, so it is not traced. */
+export const isPreflight = (req) => req.method === "OPTIONS" && req.headers["access-control-request-method"] !== undefined;
+/** Serve the dashboard and API. Resolves when the response is written. */
+export function serveOwnPath(d, req, res) {
+    return d.handler(req, res).then(() => undefined, (err) => {
+        if (!res.headersSent)
+            sendJson(res, 500, { error: String(err) });
+        else
+            res.end();
+    });
+}
+function finishSpan(span, res, tap, method, routeOf) {
+    // A close before the response finished: the client left, and no status was ever sent.
+    if (!res.writableFinished)
+        span.setAttribute(ATTR_REQUEST_ABORTED, true);
+    if (res.headersSent)
+        span.setAttribute("http.response.status_code", res.statusCode);
+    const route = routeOf();
+    if (route) {
+        span.setAttribute("http.route", route);
+        span.updateName(`${method} ${route}`);
+    }
+    span.setAttributes(headerAttributes(res.getHeaders(), RESPONSE_HEADER_PREFIX));
+    span.setAttribute("http.response.body.size", tap.bytes());
+    const body = tap.body();
+    if (body) {
+        span.setAttribute(ATTR_RESPONSE_BODY, body.text);
+        span.setAttribute(ATTR_RESPONSE_BODY_TRUNCATED, body.truncated);
+    }
+    if (res.statusCode >= 500)
+        span.setStatus({ code: SpanStatusCode.ERROR, message: `HTTP ${res.statusCode}` });
+    span.end();
+}
+function startSpan(d, req, rawUrl) {
+    const method = req.method ?? "GET";
+    const parentCtx = d.w3c.extract(ROOT_CONTEXT, req.headers, {
+        get: (carrier, key) => carrier[key],
+        keys: (carrier) => Object.keys(carrier),
+    });
+    const attributes = requestAttributes(req, method, pathOf(rawUrl), rawUrl);
+    const span = d.tracer.startSpan(`${method} ${pathOf(rawUrl)}`, { kind: SpanKind.SERVER, attributes }, parentCtx);
+    span.setAttribute(ATTR_REQUEST_ID, firstHeader(req.headers["x-request-id"]) ?? span.spanContext().spanId);
+    return { span, method, ctx: trace.setSpan(parentCtx, span).setValue(SERVER_SPAN, span) };
+}
+/** Start the server span of one request on the raw Node objects. Works for any framework that runs on node:http. */
+export function captureRequest(d, req, res, rawUrl, routeOf) {
+    const startedAt = performance.now();
+    const { span, method, ctx } = startSpan(d, req, rawUrl);
+    const endpoint = endpointFor(req, d);
+    d.selfEndpoints.add(endpoint);
+    res.setHeader(HEADER_TRACE, span.spanContext().traceId);
+    res.setHeader(HEADER_ENDPOINT, endpoint);
+    // A page cannot read its own document headers, but it can read Server-Timing. The page load joins this trace with it.
+    res.appendHeader("Server-Timing", serverTimingValue(span.spanContext().traceId, endpoint));
+    keepExposeHeaders(res);
+    req[REQ_SPAN] = span;
+    const tap = tapResponse(res, d.captureResponseBody);
+    let ended = false;
+    const finish = () => {
+        if (ended)
+            return;
+        ended = true;
+        finishSpan(span, res, tap, method, routeOf);
+    };
+    res.once("finish", finish);
+    res.once("close", finish);
+    // Body and response events run in the request's context, so work in their listeners joins this trace.
+    context.bind(ctx, req);
+    context.bind(ctx, res);
+    return { span, ctx, startedAt };
+}
+/** The server span WizeLens started for this request, if any. */
+export function requestSpan(req) {
+    return req[REQ_SPAN];
+}
+//# sourceMappingURL=request-capture.js.map

package/dist/request-capture.js.map

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

package/dist/route-timing.d.ts

@@ -0,0 +1,6 @@
+import type { Span as OtelSpan } from "@opentelemetry/api";
+/** Record `wizelens.server.routed_ms` when the router sets `target[property]`: the moment the matched route starts. */
+export declare function watchRoute(target: object, property: string, span: OtelSpan, startedAt: number): void;
+/** Record the routing time now. */
+export declare function markRouted(span: OtelSpan, startedAt: number): void;
+//# sourceMappingURL=route-timing.d.ts.map