@nextdog/node 1.0.0 → 1.1.1

package/dist/instrumentation.js

@@ -0,0 +1,39 @@
+/**
+ * Single entry point an adapter calls (after `provider.register()`) to turn on
+ * all of nextdog's auto-instrumentations:
+ *   - outbound fetch/HTTP  (#4) — zero new deps, always on
+ *   - database queries     (#5) — zero new deps, only patches a driver that is
+ *                                 actually installed (pg / mysql2)
+ *
+ * Everything here uses only `@opentelemetry/api` plus optional, lazily-loaded
+ * drivers, so nothing new ships in a consumer's production bundle.
+ */
+import { registerDbInstrumentation } from './instrument-db.js';
+import { instrumentOutboundHttp } from './instrument-fetch.js';
+/**
+ * Register outbound-HTTP and DB instrumentation. Safe to call once at startup.
+ * Returns a handle whose `restore()` undoes every patch. DB drivers load
+ * asynchronously; if a driver isn't installed it is silently skipped.
+ */
+export function registerInstrumentations() {
+    const restores = [];
+    // Outbound fetch/HTTP — synchronous, always available.
+    restores.push(instrumentOutboundHttp());
+    // DB drivers — async/optional. Resolve in the background; collect its restore.
+    let dbRestore;
+    registerDbInstrumentation()
+        .then((restore) => {
+        dbRestore = restore;
+    })
+        .catch(() => {
+        /* best-effort: a driver that fails to load is simply not instrumented */
+    });
+    return {
+        restore: () => {
+            for (const r of restores)
+                r();
+            dbRestore?.();
+        },
+    };
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../src/instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAO/D;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,QAAQ,GAAsB,EAAE,CAAC;IAEvC,uDAAuD;IACvD,QAAQ,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAExC,+EAA+E;IAC/E,IAAI,SAAmC,CAAC;IACxC,yBAAyB,EAAE;SACxB,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAChB,SAAS,GAAG,OAAO,CAAC;IACtB,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE;QACV,yEAAyE;IAC3E,CAAC,CAAC,CAAC;IAEL,OAAO;QACL,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,MAAM,CAAC,IAAI,QAAQ;gBAAE,CAAC,EAAE,CAAC;YAC9B,SAAS,EAAE,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/request-capture.d.ts

@@ -4,6 +4,12 @@ export interface RequestMetadata {
     headers: Record<string, string>;
     cookies: string;
     body?: string;
+    /** Response status code of the ORIGINAL request (what actually happened) */
+    responseStatus?: number;
+    /** Response headers of the original request */
+    responseHeaders?: Record<string, string>;
+    /** Captured response body (text/JSON only; binary is summarized; capped) */
+    responseBody?: string;
     capturedAt: number;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"request-capture.d.ts","sourceRoot":"","sources":["../src/request-capture.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAkED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAM3F;AAcD,wBAAgB,mBAAmB,SAyClC"}
+{"version":3,"file":"request-capture.d.ts","sourceRoot":"","sources":["../src/request-capture.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AA2OD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAM3F;AAcD,wBAAgB,mBAAmB,SA8ClC"}

package/dist/request-capture.js

@@ -7,12 +7,46 @@
  * in the exporter (since the OTel active span is not available at request time).
  */
 import * as http from 'node:http';
-import { requestContextStorage, createRequestContext } from './request-context.js';
-// Store captured request metadata keyed by "METHOD url" for recent lookups
-// Multiple requests to the same URL are stored as a stack (most recent first)
+import { createRequestContext, requestContextStorage } from './request-context.js';
+// Store captured request metadata keyed by "METHOD url" for recent lookups.
+// Multiple requests to the same URL are queued oldest-first (FIFO): captures are
+// push()ed on, and getRequestMetadata shift()s the oldest matching entry off.
 const requestStore = new Map();
-// Max body size to capture (16KB — enough for API payloads, avoids memory issues)
+// Max request body size to capture (16KB — enough for API payloads, avoids memory issues)
 const MAX_BODY_SIZE = 16 * 1024;
+// Max response body size to capture (50KB — matches the replay endpoint's cap;
+// responses are typically larger than requests). Capped so a streaming or large
+// response never buffers unbounded memory in the user's dev server.
+const MAX_RESPONSE_BODY_SIZE = 50 * 1024;
+// Content-type prefixes/fragments we consider safe to capture as text.
+// Anything else (images, fonts, octet-stream, video, etc.) is summarized, not buffered.
+const TEXT_CONTENT_TYPES = [
+    'application/json',
+    'application/ld+json',
+    'application/xml',
+    'application/xhtml+xml',
+    'application/javascript',
+    'application/graphql',
+    'text/',
+    '+json',
+    '+xml',
+];
+function isTextContentType(contentType) {
+    const ct = contentType.toLowerCase();
+    return TEXT_CONTENT_TYPES.some((t) => ct.includes(t));
+}
+// Content-Encoding values that mean the body is compressed (not raw text/UTF-8).
+// We do NOT decompress — capturing the raw bytes as text would store mojibake —
+// so a compressed body is summarized like the binary case.
+const COMPRESSED_ENCODINGS = ['gzip', 'br', 'deflate', 'compress', 'zstd'];
+function compressionOf(contentEncoding) {
+    const ce = contentEncoding.toLowerCase().trim();
+    if (!ce || ce === 'identity')
+        return null;
+    // content-encoding can be a comma-separated list (e.g. "gzip, br").
+    const found = COMPRESSED_ENCODINGS.find((enc) => ce.split(',').some((part) => part.trim() === enc));
+    return found ?? ce; // unknown non-identity encoding: still treat as compressed
+}
 // Cleanup entries older than 60s to prevent memory leaks
 const CLEANUP_INTERVAL = 30_000;
 const MAX_AGE = 60_000;
@@ -41,31 +75,154 @@ function captureBody(req, metadata) {
     // Intercept listener registration to piggyback on whoever reads the body
     req.on = function (event, listener) {
         if (event === 'data') {
-            const self = this;
             const wrappedListener = (chunk) => {
                 if (size < MAX_BODY_SIZE) {
                     chunks.push(chunk);
                     size += chunk.length;
                 }
-                return listener.call(self, chunk);
+                return listener.call(this, chunk);
             };
             return originalOn.call(this, event, wrappedListener);
         }
         if (event === 'end') {
-            const self = this;
             const wrappedListener = (...args) => {
                 if (chunks.length > 0) {
                     const body = Buffer.concat(chunks).toString('utf-8');
                     metadata.body = body.length > MAX_BODY_SIZE ? body.slice(0, MAX_BODY_SIZE) : body;
                     chunks.length = 0;
                 }
-                return listener.call(self, ...args);
+                return listener.call(this, ...args);
             };
             return originalOn.call(this, event, wrappedListener);
         }
         return originalOn.call(this, event, listener);
     };
 }
+/**
+ * Passively tee the response so we record what the ORIGINAL request actually
+ * returned (status, headers, body) WITHOUT re-issuing it via Replay.
+ *
+ * This wraps res.write/res.end on the single ServerResponse instance: each chunk
+ * is observed (copied into a capped buffer) and then forwarded UNCHANGED to the
+ * original method. We never consume the stream the client needs, never alter the
+ * bytes/headers/timing the client sees, and stop buffering once the cap is hit so
+ * a large or streaming response can't exhaust memory.
+ */
+function captureResponse(res, metadata) {
+    const chunks = [];
+    let size = 0;
+    let overflowed = false;
+    let captured = false;
+    // Headers passed inline to writeHead(status, headers) bypass setHeader() and
+    // therefore never appear in res.getHeaders(). Capture them here so we record
+    // exactly what the client received.
+    const writeHeadHeaders = {};
+    const observe = (chunk) => {
+        if (overflowed || chunk == null)
+            return;
+        const buf = Buffer.isBuffer(chunk)
+            ? chunk
+            : typeof chunk === 'string'
+                ? Buffer.from(chunk)
+                : null;
+        if (!buf)
+            return;
+        if (size + buf.length > MAX_RESPONSE_BODY_SIZE) {
+            // Take what fits, then stop buffering.
+            const remaining = MAX_RESPONSE_BODY_SIZE - size;
+            if (remaining > 0) {
+                chunks.push(buf.subarray(0, remaining));
+                size += remaining;
+            }
+            overflowed = true;
+            return;
+        }
+        chunks.push(buf);
+        size += buf.length;
+    };
+    const finalize = () => {
+        if (captured)
+            return;
+        captured = true;
+        metadata.responseStatus = res.statusCode;
+        const headers = {};
+        const raw = res.getHeaders();
+        for (const [key, value] of Object.entries(raw)) {
+            if (value == null)
+                continue;
+            headers[key.toLowerCase()] = Array.isArray(value) ? value.join(', ') : String(value);
+        }
+        // Merge in any headers passed inline to writeHead (setHeader-bypassing).
+        Object.assign(headers, writeHeadHeaders);
+        metadata.responseHeaders = headers;
+        const contentType = headers['content-type'] ?? '';
+        const compression = compressionOf(headers['content-encoding'] ?? '');
+        if (size === 0) {
+            // No body — leave responseBody undefined.
+        }
+        else if (compression) {
+            // Compressed body: the buffered bytes are not UTF-8 text. Decoding them
+            // would yield mojibake, so summarize instead of capturing garbage.
+            metadata.responseBody = `[compressed ${compression} response, ${size} bytes — not captured]`;
+        }
+        else if (contentType && !isTextContentType(contentType)) {
+            metadata.responseBody = `[binary ${contentType} response, ${size} bytes — not captured]`;
+        }
+        else {
+            const body = Buffer.concat(chunks).toString('utf-8');
+            metadata.responseBody = overflowed ? `${body}\n... (truncated)` : body;
+        }
+    };
+    const originalWriteHead = res.writeHead.bind(res);
+    const originalWrite = res.write.bind(res);
+    const originalEnd = res.end.bind(res);
+    // res.writeHead(statusCode[, statusMessage][, headers])
+    res.writeHead = function (...args) {
+        const last = args[args.length - 1];
+        if (last && typeof last === 'object') {
+            if (Array.isArray(last)) {
+                // Flat [k1, v1, k2, v2, ...] or array of [k, v] pairs.
+                if (Array.isArray(last[0])) {
+                    for (const pair of last) {
+                        if (pair && pair.length === 2)
+                            writeHeadHeaders[String(pair[0]).toLowerCase()] = String(pair[1]);
+                    }
+                }
+                else {
+                    for (let i = 0; i + 1 < last.length; i += 2) {
+                        writeHeadHeaders[String(last[i]).toLowerCase()] = String(last[i + 1]);
+                    }
+                }
+            }
+            else {
+                for (const [k, v] of Object.entries(last)) {
+                    if (v != null)
+                        writeHeadHeaders[k.toLowerCase()] = Array.isArray(v) ? v.join(', ') : String(v);
+                }
+            }
+        }
+        return originalWriteHead(...args);
+    };
+    // res.write(chunk[, encoding][, cb])
+    res.write = function (chunk, ...rest) {
+        observe(chunk);
+        return originalWrite(chunk, ...rest);
+    };
+    // res.end([chunk][, encoding][, cb])
+    res.end = function (...args) {
+        // The first arg is the final chunk only if it's not a callback/encoding.
+        const maybeChunk = args[0];
+        if (maybeChunk != null && (Buffer.isBuffer(maybeChunk) || typeof maybeChunk === 'string')) {
+            observe(maybeChunk);
+        }
+        const result = originalEnd(...args);
+        finalize();
+        return result;
+    };
+    // Belt-and-suspenders: also capture if the response finishes/closes without
+    // a final end() chunk path we observed (e.g. pipe()d streams).
+    res.on('finish', finalize);
+}
 /**
  * Look up request metadata by method + URL path.
  * Finds the most recent capture matching these fields.
@@ -97,16 +254,22 @@ export function startRequestCapture() {
     http.Server.prototype.emit = function (event, ...args) {
         if (event === 'request') {
             const req = args[0];
+            const res = args[1];
             const headers = captureHeaders(req);
             const metadata = {
                 method: req.method ?? 'GET',
                 url: req.url ?? '/',
                 headers,
-                cookies: headers['cookie'] ?? '',
+                cookies: headers.cookie ?? '',
                 capturedAt: Date.now(),
             };
             // Capture body asynchronously (mutates metadata.body when ready)
             captureBody(req, metadata);
+            // Tee the response so we record what the original request actually
+            // returned (status/headers/body), no Replay/re-issue required.
+            if (res) {
+                captureResponse(res, metadata);
+            }
             // Store keyed by method + url
             const key = `${metadata.method} ${metadata.url}`;
             const stack = requestStore.get(key);

package/dist/request-capture.js.map

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

package/dist/sidecar.d.ts

@@ -1,2 +1,74 @@
-export declare function ensureSidecar(url: string): Promise<void>;
+/**
+ * Classification of whatever is (or isn't) listening at `${url}/health`:
+ *
+ * - `nextdog`:  a 2xx whose JSON body carries the NextDog `service` signature —
+ *               a genuine sidecar, safe to adopt.
+ * - `foreign`:  a 2xx that does NOT carry the signature (non-JSON, or JSON
+ *               without the marker) — some unrelated process holds the port.
+ * - `absent`:   nothing usable answered (connection refused, timeout, non-2xx).
+ */
+type ProbeResult = 'nextdog' | 'foreign' | 'absent';
+/**
+ * Single source of truth for reading and classifying `${url}/health`. Both
+ * {@link isHealthy} and {@link isForeignOccupant} are thin views over this so
+ * the fetch/timeout/JSON/marker logic lives in exactly one place.
+ *
+ * @internal exported for testing.
+ */
+export declare function probeHealth(url: string): Promise<ProbeResult>;
+/**
+ * Whether `${url}/health` is answered by a genuine NextDog sidecar. A 2xx alone
+ * is NOT enough: the body must be JSON carrying the `service: "nextdog"`
+ * signature, so we never silently ship telemetry to a foreign process (#17).
+ *
+ * @internal exported for testing.
+ */
+export declare function isHealthy(url: string): Promise<boolean>;
+/**
+ * A `file://` URL points at a real on-disk location only if none of its path
+ * segments is a bundler-virtual placeholder. Turbopack rewrites a bundled
+ * module's `import.meta.url` to a virtual URL carrying a literal `[project]`
+ * segment (and similar `[...]` markers), so `createRequire()` on that URL
+ * resolves dependencies to non-existent `[project]/node_modules/...` paths.
+ * See issue #15.
+ *
+ * @internal exported for testing.
+ */
+export declare function isRealFileUrl(url: string): boolean;
+/**
+ * Resolve the absolute path to the `@nextdog/core` CLI (`dist/cli.js`) in a way
+ * that works regardless of the bundler the host dev server uses.
+ *
+ * Resolution order, returning the first candidate that exists on disk:
+ *  1. `createRequire(anchorUrl)` — the module's own `import.meta.url`, but only
+ *     when it is a real on-disk URL (skipped under Turbopack's virtual URL).
+ *  2. `createRequire(<projectRoot>/package.json)` — resolves through the real
+ *     `node_modules` graph of the user's project, independent of any bundler.
+ *  3. A direct walk up the `node_modules` chain from the project root.
+ *
+ * Each candidate is validated against the filesystem before being returned, so
+ * a bundler that hands us a plausible-but-wrong path never makes it through.
+ *
+ * @internal exported for testing.
+ */
+export declare function resolveCoreCliPath(opts?: {
+    anchorUrl?: string;
+    projectRoot?: string;
+}): string;
+/**
+ * Outcome of {@link ensureSidecar}.
+ *
+ * - `ready`: a verified NextDog sidecar is reachable; telemetry is safe to send.
+ * - `foreignOccupant`: the configured port is held by a non-NextDog process, so
+ *   we refused to adopt it. Callers should NOT register telemetry — it would be
+ *   shipped to an unknown local process.
+ */
+export interface SidecarStatus {
+    ready: boolean;
+    foreignOccupant: boolean;
+}
+/** Exposed for tests so each case starts from a clean warning state. */
+export declare function _resetForeignOccupantWarnings(): void;
+export declare function ensureSidecar(url: string): Promise<SidecarStatus>;
+export {};
 //# sourceMappingURL=sidecar.d.ts.map

package/dist/sidecar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../src/sidecar.ts"],"names":[],"mappings":"AA0FA,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB9D"}
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../src/sidecar.ts"],"names":[],"mappings":"AAeA;;;;;;;;GAQG;AACH,KAAK,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAyBnE;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7D;AA8BD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAUlD;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,MAAM,CAuDR;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;CAC1B;AAkDD,wEAAwE;AACxE,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAwCvE"}