@adonis-agora/telescope 0.3.3 → 0.5.0

package/dist/src/watchers/http_client_watcher.d.ts

@@ -1,5 +1,5 @@
 import { type RecordInput } from '../entry.js';
-/** Options for {@link HttpClientWatcher}. */
+/** Options for {@link HttpClientWatcher} / {@link instrumentFetch}. */
 export interface HttpClientWatcherOptions {
     /** Outbound calls at/above this many ms get a `slow` tag. Default 1000. */
     slowMs?: number;
@@ -7,6 +7,19 @@ export interface HttpClientWatcherOptions {
     clock?: {
         now(): number;
     };
+    /**
+     * Hosts whose calls are NOT recorded (exact host match, case-insensitive; the
+     * host may include a port, e.g. `localhost:6379`). Use to drop noisy internal
+     * targets — a remote telescope store, a metrics sink — from the timeline.
+     */
+    ignoreHosts?: string[];
+    /**
+     * When `true`, record the request/response body SIZES (bytes, never the bytes
+     * themselves) into the entry content. Request size is read from `init.body`;
+     * response size from the `content-length` header (the response stream is never
+     * consumed). Default `false`.
+     */
+    captureBodies?: boolean;
 }
 /** The recorded body of an `http-client` entry. */
 export interface HttpClientEntryContent {
@@ -22,53 +35,100 @@ export interface HttpClientEntryContent {
     durationMs: number;
     /** The active trace id at call time, or `null`. */
     traceId: string | null;
+    /** Request body size in bytes when `captureBodies` is on and measurable, else `null`. */
+    requestBytes: number | null;
+    /** Response body size (from `content-length`) when `captureBodies` is on, else `null`. */
+    responseBytes: number | null;
+    /** The transport error message on a network failure, else `null`. */
+    error: string | null;
+}
+/** A single captured outbound call — the input to {@link buildHttpClientEntry}
+ *  and the manual {@link HttpClientWatcher.record} helper. */
+export interface OutgoingCall {
+    method: string;
+    url: string;
+    host: string | null;
+    statusCode: number | null;
+    durationMs: number;
+    requestBytes?: number | null;
+    responseBytes?: number | null;
+    error?: string | null;
 }
 type FetchFn = typeof globalThis.fetch;
 type FetchInit = Parameters<FetchFn>[1];
-/** Mark a `RequestInit` so the {@link HttpClientWatcher} skips recording the
- *  call it belongs to. Use for telescope's own outbound fetches (remote store,
- *  alert webhooks) so the watcher never records — or recurses on — itself. */
+/** Mark a `RequestInit` so an instrumented fetch skips recording the call it
+ *  belongs to. Use for telescope's own outbound fetches (remote store, alert
+ *  webhooks) so the watcher never records — or recurses on — itself. */
 export declare function markInternalFetch(init: FetchInit): FetchInit;
 /**
- * Records every OUTBOUND HTTP call as an `http-client` telescope entry by
- * wrapping the Node global `fetch`. Each call is timed; method, sanitized url,
- * host, status and duration are captured and correlated to the active request
- * via the trace id.
+ * Records OUTBOUND HTTP calls as `http-client` telescope entries — **opt-in, with
+ * no global monkey-patching**. AdonisJS has no single built-in HTTP client, so
+ * this never replaces `globalThis.fetch`; instead you wrap a `fetch`
+ * implementation with {@link HttpClientWatcher.instrumentFetch} (or the
+ * standalone {@link instrumentFetch}) and hand the wrapper to your client, or
+ * record a non-`fetch` call yourself via {@link HttpClientWatcher.record}.
  *
  * The wrapper never alters the host's call: it awaits the real `fetch`, records
- * fire-and-forget (a telescope failure can't break or block the request), and
- * always re-throws a network error. Telescope's own outbound fetches — marked
- * via {@link markInternalFetch} — are skipped, so the watcher never records or
- * recurses on itself.
+ * fire-and-forget through {@link safeRecord} (which honours the overload-shed
+ * `paused` flag and applies redaction/sampling on the store's write path), and
+ * always re-throws a network error. Calls to an `ignoreHosts` target, and
+ * telescope's own outbound fetches (marked via {@link markInternalFetch}), are
+ * skipped.
  *
- * Patching the global is idempotent process-wide (a `Symbol.for` marker). Unlike
- * the emitter watchers, this implements its own lifecycle: `start()` takes no
- * emitter; `stop()` restores the original `fetch`.
+ * Each entry carries `familyHash` (`METHOD host/normalized-path`) and
+ * `durationMs`, so it feeds the Pulse `slowOutgoing` hotspot card directly.
+ *
+ * Idiomatic Adonis: a plain class, no DI decorators. The provider constructs it
+ * from `config/telescope_watchers.ts` and calls {@link start} to publish it as
+ * the default backing a bare `instrumentFetch(fetch)`; {@link stop} unpublishes.
+ * Neither touches any global.
  */
 export declare class HttpClientWatcher {
     readonly type: "http-client";
     private readonly slowMs;
     private readonly clock;
-    /** Whether THIS instance installed the patch (so only it restores on stop). */
-    private installed;
+    private readonly ignoreHosts;
+    private readonly captureBodies;
     constructor(options?: HttpClientWatcherOptions);
-    /** Patch `globalThis.fetch` to record outbound calls. Idempotent: a second
-     *  call (or another instance / package copy) is a no-op. */
+    /** Publish this configured instance as the default that a bare
+     *  {@link instrumentFetch} (called with no explicit options) inherits config
+     *  from. Does NOT patch any global — instrumentation stays opt-in. Named
+     *  `start`/`stop` to match the other watchers' provider lifecycle. */
     start(): void;
-    /** Restore the original `fetch` — but only if THIS instance installed the
-     *  current wrapper (avoids clobbering a wrapper a later instance installed). */
+    /** Unpublish this instance as the default (if it is). Never touches globals. */
     stop(): void;
-    /** Build + record an entry, swallowing every failure via {@link safeRecord}. */
-    private record;
+    /**
+     * Wrap a `fetch` implementation so every call it makes is recorded as an
+     * `http-client` entry — WITHOUT mutating any global. The returned function has
+     * `fetch`'s signature; pass it to your HTTP client, or call it directly.
+     *
+     * @example
+     *   const trackedFetch = new HttpClientWatcher().instrumentFetch(globalThis.fetch)
+     *   await trackedFetch('https://api.stripe.com/v1/charges')
+     */
+    instrumentFetch(fetchImpl?: FetchFn): FetchFn;
+    /**
+     * Record one already-completed outbound call — the small helper for HTTP
+     * clients that are NOT `fetch`-based (axios, got, an undici stream). Compute
+     * the fields at your call site and hand them here; recording is fire-and-forget
+     * and never throws. Honours `ignoreHosts` and the overload-shed flag.
+     */
+    record(call: OutgoingCall): void;
 }
+/**
+ * Wrap a `fetch` implementation so its calls are recorded — the standalone,
+ * zero-boilerplate opt-in hook. With no `options`, it inherits the config the
+ * provider published via {@link HttpClientWatcher.start} (falling back to
+ * defaults when telescope's watcher isn't wired). Pass `options` to instrument
+ * with an isolated, explicitly-configured watcher.
+ *
+ * @example
+ *   import { instrumentFetch } from '@adonis-agora/telescope/watchers'
+ *   const trackedFetch = instrumentFetch(globalThis.fetch)
+ */
+export declare function instrumentFetch(fetchImpl?: FetchFn, options?: HttpClientWatcherOptions): FetchFn;
 /** Map a captured outbound call to a telescope {@link RecordInput}. Exported so
- *  the entry shape can be unit-tested without patching the global. */
-export declare function buildHttpClientEntry(call: {
-    method: string;
-    url: string;
-    host: string | null;
-    statusCode: number | null;
-    durationMs: number;
-}, slowMs?: number): RecordInput<HttpClientEntryContent>;
+ *  the entry shape can be unit-tested without instrumenting a real client. */
+export declare function buildHttpClientEntry(call: OutgoingCall, slowMs?: number): RecordInput<HttpClientEntryContent>;
 export {};
 //# sourceMappingURL=http_client_watcher.d.ts.map

package/dist/src/watchers/http_client_watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http_client_watcher.d.ts","sourceRoot":"","sources":["../../../src/watchers/http_client_watcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1D,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE;QAAE,GAAG,IAAI,MAAM,CAAA;KAAE,CAAC;CAC3B;AAED,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,GAAG,EAAE,MAAM,CAAC;IACZ,uFAAuF;IACvF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,uEAAuE;IACvE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAsBD,KAAK,OAAO,GAAG,OAAO,UAAU,CAAC,KAAK,CAAC;AAEvC,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AA+CxC;;8EAE8E;AAC9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAI5D;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,IAAI,gBAAwB;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,+EAA+E;IAC/E,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,GAAE,wBAA6B;IAKlD;gEAC4D;IAC5D,KAAK,IAAI,IAAI;IAkCb;oFACgF;IAChF,IAAI,IAAI,IAAI;IASZ,gFAAgF;IAChF,OAAO,CAAC,MAAM;CAYf;AAED;sEACsE;AACtE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB,EACD,MAAM,SAAkB,GACvB,WAAW,CAAC,sBAAsB,CAAC,CAwBrC"}
+{"version":3,"file":"http_client_watcher.d.ts","sourceRoot":"","sources":["../../../src/watchers/http_client_watcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1D,uEAAuE;AACvE,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE;QAAE,GAAG,IAAI,MAAM,CAAA;KAAE,CAAC;IAC1B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,GAAG,EAAE,MAAM,CAAC;IACZ,uFAAuF;IACvF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,uEAAuE;IACvE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,yFAAyF;IACzF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,0FAA0F;IAC1F,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qEAAqE;IACrE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;8DAC8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAiCD,KAAK,OAAO,GAAG,OAAO,UAAU,CAAC,KAAK,CAAC;AAEvC,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAqExC;;wEAEwE;AACxE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAI5D;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,IAAI,gBAAwB;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAE5B,OAAO,GAAE,wBAA6B;IAOlD;;;0EAGsE;IACtE,KAAK,IAAI,IAAI;IAIb,gFAAgF;IAChF,IAAI,IAAI,IAAI;IAIZ;;;;;;;;OAQG;IACH,eAAe,CAAC,SAAS,GAAE,OAA0B,GAAG,OAAO;IAoD/D;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;CAIjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,SAAS,GAAE,OAA0B,EACrC,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAKT;AAED;8EAC8E;AAC9E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,YAAY,EAClB,MAAM,SAAkB,GACvB,WAAW,CAAC,sBAAsB,CAAC,CA6BrC"}

package/dist/src/watchers/http_client_watcher.js

@@ -9,14 +9,24 @@ const DEFAULT_SLOW_MS = 1000;
  *  before it ever reaches the (separately redacted) entry content. */
 const SENSITIVE_PARAM = /(token|secret|password|passwd|api[-_]?key|access[-_]?key|auth|credential)/i;
 const REDACTED = '[REDACTED]';
-/** Marks our wrapper so the global `fetch` is patched exactly once even if two
- *  copies of this package load. `Symbol.for` (the global registry) is deliberate:
- *  both copies resolve the same marker and neither double-wraps the other. */
-const PATCHED = Symbol.for('@agora/telescope:httpClientPatched');
 /** Marks an `init` (RequestInit) as telescope's OWN outbound call so the wrapper
  *  skips recording it — the recursion guard for any internal fetch (e.g. a
- *  future remote store / alert webhook performing a `fetch`). */
+ *  remote store / alert webhook performing a `fetch` through an instrumented
+ *  client). */
 const INTERNAL = Symbol.for('@agora/telescope:internalFetch');
+/** Cross-copy-stable slot holding the provider-configured default watcher, so a
+ *  bare `instrumentFetch(fetch)` (no options) inherits the app's configured
+ *  `slowMs` / `ignoreHosts` / `captureBodies`. A `Symbol.for` global slot (not a
+ *  module local) keeps two copies of this package in agreement — the same stance
+ *  the runtime registry uses. */
+const DEFAULT_SLOT = Symbol.for('@agora/telescope:defaultHttpClientWatcher');
+const slotHost = globalThis;
+function setDefaultHttpClientWatcher(watcher) {
+    slotHost[DEFAULT_SLOT] = watcher;
+}
+function getDefaultHttpClientWatcher() {
+    return slotHost[DEFAULT_SLOT] ?? null;
+}
 /**
  * Sanitize a raw URL for storage: strip userinfo (`user:pass@`) and mask
  * sensitive query-param VALUES, returning `{ url, host }`. A relative/invalid
@@ -55,89 +65,182 @@ function describeRequest(input, init) {
     const { url, host } = sanitizeUrl(rawUrl);
     return { method: method.toUpperCase(), url, host };
 }
-/** Mark a `RequestInit` so the {@link HttpClientWatcher} skips recording the
- *  call it belongs to. Use for telescope's own outbound fetches (remote store,
- *  alert webhooks) so the watcher never records — or recurses on — itself. */
+/** Best-effort byte size of a fetch request body, without consuming a stream.
+ *  Returns `null` for shapes whose size can't be read cheaply (ReadableStream,
+ *  FormData, a `Request`'s stream body). Never throws. */
+function requestByteLength(init) {
+    const value = init && 'body' in init ? init.body : undefined;
+    if (value === undefined || value === null)
+        return null;
+    try {
+        if (typeof value === 'string')
+            return Buffer.byteLength(value);
+        if (value instanceof URLSearchParams)
+            return Buffer.byteLength(value.toString());
+        if (value instanceof ArrayBuffer)
+            return value.byteLength;
+        if (ArrayBuffer.isView(value))
+            return value.byteLength;
+        const size = value.size;
+        if (typeof size === 'number')
+            return size; // Blob / File
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/** Response body size from the `content-length` header, or `null`. The header is
+ *  read (not the stream), so the host's `response.json()`/`.text()` is untouched. */
+function responseByteLength(response) {
+    const raw = response.headers?.get?.('content-length');
+    if (raw === null || raw === undefined)
+        return null;
+    const value = Number(raw);
+    return Number.isFinite(value) ? value : null;
+}
+/** Mark a `RequestInit` so an instrumented fetch skips recording the call it
+ *  belongs to. Use for telescope's own outbound fetches (remote store, alert
+ *  webhooks) so the watcher never records — or recurses on — itself. */
 export function markInternalFetch(init) {
     const next = (init ?? {});
     next[INTERNAL] = true;
     return next;
 }
 /**
- * Records every OUTBOUND HTTP call as an `http-client` telescope entry by
- * wrapping the Node global `fetch`. Each call is timed; method, sanitized url,
- * host, status and duration are captured and correlated to the active request
- * via the trace id.
+ * Records OUTBOUND HTTP calls as `http-client` telescope entries — **opt-in, with
+ * no global monkey-patching**. AdonisJS has no single built-in HTTP client, so
+ * this never replaces `globalThis.fetch`; instead you wrap a `fetch`
+ * implementation with {@link HttpClientWatcher.instrumentFetch} (or the
+ * standalone {@link instrumentFetch}) and hand the wrapper to your client, or
+ * record a non-`fetch` call yourself via {@link HttpClientWatcher.record}.
  *
  * The wrapper never alters the host's call: it awaits the real `fetch`, records
- * fire-and-forget (a telescope failure can't break or block the request), and
- * always re-throws a network error. Telescope's own outbound fetches — marked
- * via {@link markInternalFetch} — are skipped, so the watcher never records or
- * recurses on itself.
+ * fire-and-forget through {@link safeRecord} (which honours the overload-shed
+ * `paused` flag and applies redaction/sampling on the store's write path), and
+ * always re-throws a network error. Calls to an `ignoreHosts` target, and
+ * telescope's own outbound fetches (marked via {@link markInternalFetch}), are
+ * skipped.
+ *
+ * Each entry carries `familyHash` (`METHOD host/normalized-path`) and
+ * `durationMs`, so it feeds the Pulse `slowOutgoing` hotspot card directly.
  *
- * Patching the global is idempotent process-wide (a `Symbol.for` marker). Unlike
- * the emitter watchers, this implements its own lifecycle: `start()` takes no
- * emitter; `stop()` restores the original `fetch`.
+ * Idiomatic Adonis: a plain class, no DI decorators. The provider constructs it
+ * from `config/telescope_watchers.ts` and calls {@link start} to publish it as
+ * the default backing a bare `instrumentFetch(fetch)`; {@link stop} unpublishes.
+ * Neither touches any global.
  */
 export class HttpClientWatcher {
     type = EntryType.HttpClient;
     slowMs;
     clock;
-    /** Whether THIS instance installed the patch (so only it restores on stop). */
-    installed = false;
+    ignoreHosts;
+    captureBodies;
     constructor(options = {}) {
         this.slowMs = options.slowMs ?? DEFAULT_SLOW_MS;
         this.clock = options.clock ?? { now: () => Date.now() };
+        this.ignoreHosts = new Set((options.ignoreHosts ?? []).map((host) => host.toLowerCase()));
+        this.captureBodies = options.captureBodies ?? false;
     }
-    /** Patch `globalThis.fetch` to record outbound calls. Idempotent: a second
-     *  call (or another instance / package copy) is a no-op. */
+    /** Publish this configured instance as the default that a bare
+     *  {@link instrumentFetch} (called with no explicit options) inherits config
+     *  from. Does NOT patch any global — instrumentation stays opt-in. Named
+     *  `start`/`stop` to match the other watchers' provider lifecycle. */
     start() {
-        const current = globalThis.fetch;
-        if (typeof current !== 'function' || current[PATCHED])
-            return;
-        const original = current;
+        setDefaultHttpClientWatcher(this);
+    }
+    /** Unpublish this instance as the default (if it is). Never touches globals. */
+    stop() {
+        if (getDefaultHttpClientWatcher() === this)
+            setDefaultHttpClientWatcher(null);
+    }
+    /**
+     * Wrap a `fetch` implementation so every call it makes is recorded as an
+     * `http-client` entry — WITHOUT mutating any global. The returned function has
+     * `fetch`'s signature; pass it to your HTTP client, or call it directly.
+     *
+     * @example
+     *   const trackedFetch = new HttpClientWatcher().instrumentFetch(globalThis.fetch)
+     *   await trackedFetch('https://api.stripe.com/v1/charges')
+     */
+    instrumentFetch(fetchImpl = globalThis.fetch) {
+        if (typeof fetchImpl !== 'function') {
+            throw new TypeError('instrumentFetch: a fetch implementation is required.');
+        }
         const watcher = this;
-        const patched = async function patchedFetch(input, init) {
-            // Skip (and don't record) telescope's own outbound calls — the recursion
-            // guard for any internal fetch.
+        const wrapped = async function instrumentedFetch(input, init) {
+            // Skip telescope's own outbound calls — the recursion guard.
             if (init && init[INTERNAL]) {
-                return original(input, init);
+                return fetchImpl(input, init);
             }
-            const startedAt = watcher.clock.now();
             const { method, url, host } = describeRequest(input, init);
+            // An ignored host is passed straight through, unrecorded and un-timed.
+            if (host !== null && watcher.ignoreHosts.has(host.toLowerCase())) {
+                return fetchImpl(input, init);
+            }
+            const startedAt = watcher.clock.now();
+            const requestBytes = watcher.captureBodies ? requestByteLength(init) : null;
             try {
-                const response = await original(input, init);
-                watcher.record(method, url, host, response.status, watcher.clock.now() - startedAt);
+                const response = await fetchImpl(input, init);
+                watcher.record({
+                    method,
+                    url,
+                    host,
+                    statusCode: response.status,
+                    durationMs: watcher.clock.now() - startedAt,
+                    requestBytes,
+                    responseBytes: watcher.captureBodies ? responseByteLength(response) : null,
+                    error: null,
+                });
                 return response;
             }
             catch (error) {
-                watcher.record(method, url, host, null, watcher.clock.now() - startedAt);
+                watcher.record({
+                    method,
+                    url,
+                    host,
+                    statusCode: null,
+                    durationMs: watcher.clock.now() - startedAt,
+                    requestBytes,
+                    responseBytes: null,
+                    error: error instanceof Error ? error.message : String(error),
+                });
                 throw error; // never swallow the host's network error
             }
         };
-        patched[PATCHED] = true;
-        patched.__telescopeOriginal__ = original;
-        globalThis.fetch = patched;
-        this.installed = true;
+        return wrapped;
     }
-    /** Restore the original `fetch` — but only if THIS instance installed the
-     *  current wrapper (avoids clobbering a wrapper a later instance installed). */
-    stop() {
-        if (!this.installed)
+    /**
+     * Record one already-completed outbound call — the small helper for HTTP
+     * clients that are NOT `fetch`-based (axios, got, an undici stream). Compute
+     * the fields at your call site and hand them here; recording is fire-and-forget
+     * and never throws. Honours `ignoreHosts` and the overload-shed flag.
+     */
+    record(call) {
+        if (call.host !== null && this.ignoreHosts.has(call.host.toLowerCase()))
             return;
-        this.installed = false;
-        const current = globalThis.fetch;
-        if (current?.[PATCHED] && current.__telescopeOriginal__) {
-            globalThis.fetch = current.__telescopeOriginal__;
-        }
-    }
-    /** Build + record an entry, swallowing every failure via {@link safeRecord}. */
-    record(method, url, host, statusCode, durationMs) {
-        safeRecord(buildHttpClientEntry({ method, url, host, statusCode, durationMs }, this.slowMs), 'HttpClientWatcher');
+        safeRecord(buildHttpClientEntry(call, this.slowMs), 'HttpClientWatcher');
     }
 }
+/**
+ * Wrap a `fetch` implementation so its calls are recorded — the standalone,
+ * zero-boilerplate opt-in hook. With no `options`, it inherits the config the
+ * provider published via {@link HttpClientWatcher.start} (falling back to
+ * defaults when telescope's watcher isn't wired). Pass `options` to instrument
+ * with an isolated, explicitly-configured watcher.
+ *
+ * @example
+ *   import { instrumentFetch } from '@adonis-agora/telescope/watchers'
+ *   const trackedFetch = instrumentFetch(globalThis.fetch)
+ */
+export function instrumentFetch(fetchImpl = globalThis.fetch, options) {
+    const watcher = options
+        ? new HttpClientWatcher(options)
+        : (getDefaultHttpClientWatcher() ?? new HttpClientWatcher());
+    return watcher.instrumentFetch(fetchImpl);
+}
 /** Map a captured outbound call to a telescope {@link RecordInput}. Exported so
- *  the entry shape can be unit-tested without patching the global. */
+ *  the entry shape can be unit-tested without instrumenting a real client. */
 export function buildHttpClientEntry(call, slowMs = DEFAULT_SLOW_MS) {
     const traceId = currentTraceId();
     const content = {
@@ -147,6 +250,9 @@ export function buildHttpClientEntry(call, slowMs = DEFAULT_SLOW_MS) {
         statusCode: call.statusCode,
         durationMs: Math.max(0, call.durationMs),
         traceId,
+        requestBytes: call.requestBytes ?? null,
+        responseBytes: call.responseBytes ?? null,
+        error: call.error ?? null,
     };
     const tags = ['http-client'];
     if (content.host)
@@ -158,6 +264,8 @@ export function buildHttpClientEntry(call, slowMs = DEFAULT_SLOW_MS) {
         tags.push('slow');
     return {
         type: EntryType.HttpClient,
+        // Group by method + host + normalized path so the same external endpoint
+        // aggregates regardless of ids — the Pulse slow-outgoing hotspot key.
         familyHash: normalizeHttpTarget(content.method, content.url),
         content,
         durationMs: content.durationMs,

package/dist/src/watchers/http_client_watcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"http_client_watcher.js","sourceRoot":"","sources":["../../../src/watchers/http_client_watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA0BzC,mDAAmD;AACnD,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B;;sEAEsE;AACtE,MAAM,eAAe,GACnB,4EAA4E,CAAC;AAC/E,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B;;8EAE8E;AAC9E,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;AAEjE;;iEAEiE;AACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAY9D;;;;GAIG;AACH,SAAS,WAAW,CAAC,MAAc;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;QACrB,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;QACrB,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAClD,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,SAAS,eAAe,CACtB,KAAiB,EACjB,IAAe;IAEf,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,GAAG,KAAK,CAAC;SACzC,IAAI,KAAK,YAAY,GAAG;QAAE,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC;SAC9C,IAAI,KAAK,YAAY,OAAO,EAAE,CAAC;QAClC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC;QACnB,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IACxB,CAAC;IACD,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAAE,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAElE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACrD,CAAC;AAED;;8EAE8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,IAAe;IAC/C,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAyC,CAAC;IAClE,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACtB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,iBAAiB;IACnB,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC;IACpB,MAAM,CAAS;IACf,KAAK,CAAoB;IAC1C,+EAA+E;IACvE,SAAS,GAAG,KAAK,CAAC;IAE1B,YAAY,UAAoC,EAAE;QAChD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC1D,CAAC;IAED;gEAC4D;IAC5D,KAAK;QACH,MAAM,OAAO,GAAG,UAAU,CAAC,KAAiC,CAAC;QAC7D,IAAI,OAAO,OAAO,KAAK,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO;QAE9D,MAAM,QAAQ,GAAG,OAAO,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC;QACrB,MAAM,OAAO,GAAG,KAAK,UAAU,YAAY,CACzC,KAAiB,EACjB,IAAgB;YAEhB,yEAAyE;YACzE,gCAAgC;YAChC,IAAI,IAAI,IAAK,IAAiC,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzD,OAAO,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC/B,CAAC;YAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACtC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC3D,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC7C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;gBACpF,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;gBACzE,MAAM,KAAK,CAAC,CAAC,yCAAyC;YACxD,CAAC;QACH,CAAiB,CAAC;QAElB,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;QACxB,OAAO,CAAC,qBAAqB,GAAG,QAAQ,CAAC;QACzC,UAAU,CAAC,KAAK,GAAG,OAAO,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED;oFACgF;IAChF,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,MAAM,OAAO,GAAG,UAAU,CAAC,KAAiC,CAAC;QAC7D,IAAI,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;YACxD,UAAU,CAAC,KAAK,GAAG,OAAO,CAAC,qBAAqB,CAAC;QACnD,CAAC;IACH,CAAC;IAED,gFAAgF;IACxE,MAAM,CACZ,MAAc,EACd,GAAW,EACX,IAAmB,EACnB,UAAyB,EACzB,UAAkB;QAElB,UAAU,CACR,oBAAoB,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAChF,mBAAmB,CACpB,CAAC;IACJ,CAAC;CACF;AAED;sEACsE;AACtE,MAAM,UAAU,oBAAoB,CAClC,IAMC,EACD,MAAM,GAAG,eAAe;IAExB,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,OAAO,GAA2B;QACtC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC;QACxC,OAAO;KACR,CAAC;IACF,MAAM,IAAI,GAAa,CAAC,aAAa,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,+FAA+F;IAC/F,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,IAAI,OAAO,CAAC,UAAU,IAAI,GAAG;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClF,IAAI,OAAO,CAAC,UAAU,IAAI,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEpD,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,UAAU;QAC1B,UAAU,EAAE,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC;QAC5D,OAAO;QACP,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,OAAO;QACP,IAAI;KACL,CAAC;AACJ,CAAC"}
+{"version":3,"file":"http_client_watcher.js","sourceRoot":"","sources":["../../../src/watchers/http_client_watcher.ts"],"names":[],"mappings":"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"}

package/dist/src/watchers/index.d.ts

@@ -1,16 +1,16 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.3.3";
+export declare const VERSION = "0.5.0";
 export type { EmitterLike, Watcher } from './emitter.js';
 export { resolveStore, safeRecord } from './record.js';
 export { buildQueryEntry, DB_QUERY_EVENT, LucidQueryWatcher } from './lucid_query_watcher.js';
-export type { DbQueryEventLike, QueryEntryContent } from './lucid_query_watcher.js';
+export type { DbQueryEventLike, LucidQueryWatcherOptions, QueryEntryContent, } from './lucid_query_watcher.js';
 export { queryFamilyHash } from './query_family_hash.js';
 export { buildMailEntry, MAIL_SENT_EVENT, MailWatcher } from './mail_watcher.js';
 export type { MailEntryContent, MailSentEventLike } from './mail_watcher.js';
 export { buildCacheEntry, CACHE_EVENTS, CacheWatcher } from './cache_watcher.js';
 export type { CacheEntryContent, CacheEventLike, CacheOperation } from './cache_watcher.js';
-export { buildHttpClientEntry, HttpClientWatcher, markInternalFetch, } from './http_client_watcher.js';
-export type { HttpClientEntryContent, HttpClientWatcherOptions, } from './http_client_watcher.js';
+export { buildHttpClientEntry, HttpClientWatcher, instrumentFetch, markInternalFetch, } from './http_client_watcher.js';
+export type { HttpClientEntryContent, HttpClientWatcherOptions, OutgoingCall, } from './http_client_watcher.js';
 export { normalizeHttpTarget } from './normalize_http_target.js';
 export { buildLogEntry, extractLog, LOG_LEVELS, LogsWatcher } from './logs_watcher.js';
 export type { LogEntryContent, LoggerLike, LogLevel, LogsWatcherOptions, } from './logs_watcher.js';
@@ -20,6 +20,10 @@ export { buildEventEntry, DEFAULT_IGNORED_EVENTS, EventsWatcher, hasOnAny, } fro
 export type { EmitterAnyLike, EventEntryContent } from './events_watcher.js';
 export { buildRedisEntry, RedisWatcher } from './redis_watcher.js';
 export type { RedisClientLike, RedisCommandLike, RedisConnectionLike, RedisEntryContent, RedisManagerLike, } from './redis_watcher.js';
+export { buildProfileEntry, PROFILE_ENTRY_TYPE, profile, ProfilingWatcher, startProfile, } from './profiling_watcher.js';
+export type { CompletedProfile, ProfileEntryContent, ProfileMark, ProfileSession, ProfileStatus, ProfilingWatcherOptions, } from './profiling_watcher.js';
+export { buildScheduleEntry, recordScheduledRun, SCHEDULED_TASK_ENTRY_TYPE, ScheduleWatcher, scheduleTask, } from './schedule_watcher.js';
+export type { ScheduleEntryContent, ScheduledRun, ScheduledTaskOptions, ScheduleKind, ScheduleRunStatus, ScheduleWatcherOptions, } from './schedule_watcher.js';
 export { DEFAULT_WATCHERS, defineConfig, resolveConfig, } from './define_config.js';
-export type { ResolvedTelescopeWatchersConfig, TelescopeWatchersConfig, WatcherName, } from './define_config.js';
+export type { HttpClientWatcherConfig, ProfilingWatcherConfig, QueryWatcherConfig, ResolvedHttpClientWatcherConfig, ResolvedProfilingWatcherConfig, ResolvedQueryWatcherConfig, ResolvedScheduleWatcherConfig, ResolvedTelescopeWatchersConfig, ScheduleWatcherConfig, TelescopeWatchersConfig, WatcherName, } from './define_config.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/watchers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/watchers/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC9F,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACjF,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACjF,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG5F,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACvF,YAAY,EACV,eAAe,EACf,UAAU,EACV,QAAQ,EACR,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxF,YAAY,EACV,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,+BAA+B,EAC/B,uBAAuB,EACvB,WAAW,GACZ,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/watchers/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC9F,YAAY,EACV,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACjF,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACjF,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG5F,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,sBAAsB,EACtB,wBAAwB,EACxB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACvF,YAAY,EACV,eAAe,EACf,UAAU,EACV,QAAQ,EACR,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxF,YAAY,EACV,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,OAAO,EACP,gBAAgB,EAChB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,aAAa,EACb,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,YAAY,GACb,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,+BAA+B,EAC/B,8BAA8B,EAC9B,0BAA0B,EAC1B,6BAA6B,EAC7B,+BAA+B,EAC/B,qBAAqB,EACrB,uBAAuB,EACvB,WAAW,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/src/watchers/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.3.3';
+export const VERSION = '0.5.0';
 // — runtime recording (advanced) —
 export { resolveStore, safeRecord } from './record.js';
 // — Lucid query watcher (the headline watcher) —
@@ -10,7 +10,7 @@ export { buildMailEntry, MAIL_SENT_EVENT, MailWatcher } from './mail_watcher.js'
 // — cache watcher —
 export { buildCacheEntry, CACHE_EVENTS, CacheWatcher } from './cache_watcher.js';
 // — http-client (outbound) watcher —
-export { buildHttpClientEntry, HttpClientWatcher, markInternalFetch, } from './http_client_watcher.js';
+export { buildHttpClientEntry, HttpClientWatcher, instrumentFetch, markInternalFetch, } from './http_client_watcher.js';
 export { normalizeHttpTarget } from './normalize_http_target.js';
 // — logs watcher —
 export { buildLogEntry, extractLog, LOG_LEVELS, LogsWatcher } from './logs_watcher.js';
@@ -20,6 +20,10 @@ export { buildJobEntry, QUEUE_EXECUTE_CHANNEL, QueueWatcher } from './queue_watc
 export { buildEventEntry, DEFAULT_IGNORED_EVENTS, EventsWatcher, hasOnAny, } from './events_watcher.js';
 // — redis watcher (optional peer: @adonisjs/redis) —
 export { buildRedisEntry, RedisWatcher } from './redis_watcher.js';
+// — profiling watcher (user-driven timing spans; opt-in helpers) —
+export { buildProfileEntry, PROFILE_ENTRY_TYPE, profile, ProfilingWatcher, startProfile, } from './profiling_watcher.js';
+// — schedule watcher (scheduled-task runs; explicit wrapper integration) —
+export { buildScheduleEntry, recordScheduledRun, SCHEDULED_TASK_ENTRY_TYPE, ScheduleWatcher, scheduleTask, } from './schedule_watcher.js';
 // — config —
 export { DEFAULT_WATCHERS, defineConfig, resolveConfig, } from './define_config.js';
 //# sourceMappingURL=index.js.map

package/dist/src/watchers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/watchers/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAK/B,mCAAmC;AACnC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvD,iDAAiD;AACjD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE9F,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGjF,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGjF,qCAAqC;AACrC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,mBAAmB;AACnB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQvF,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASxF,mDAAmD;AACnD,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAG7B,qDAAqD;AACrD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASnE,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/watchers/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAK/B,mCAAmC;AACnC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvD,iDAAiD;AACjD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAM9F,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGjF,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGjF,qCAAqC;AACrC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,mBAAmB;AACnB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQvF,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASxF,mDAAmD;AACnD,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAG7B,qDAAqD;AACrD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASnE,mEAAmE;AACnE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,OAAO,EACP,gBAAgB,EAChB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAUhC,2EAA2E;AAC3E,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,YAAY,GACb,MAAM,uBAAuB,CAAC;AAU/B,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/dist/src/watchers/lucid_query_watcher.d.ts

@@ -2,6 +2,18 @@ import { type RecordInput } from '../entry.js';
 import type { EmitterLike, Watcher } from './emitter.js';
 /** The Lucid event name this watcher subscribes to. */
 export declare const DB_QUERY_EVENT = "db:query";
+/** Construction-time tuning for {@link LucidQueryWatcher} — the resolved slice of
+ *  `config/telescope_watchers.ts`'s `query` block the watcher acts on. */
+export interface LucidQueryWatcherOptions {
+    /** Queries at/above this many ms get a `slow` tag. Default 500. */
+    slowMs?: number;
+    /** Keep the raw bound VALUES instead of redacting them. Default `false`. */
+    captureBindings?: boolean;
+    /** Connection names (case-insensitive) whose queries are not recorded. */
+    ignoreConnections?: string[];
+    /** Normalize SQL into the `familyHash` grouping key. Default `true`. */
+    normalize?: boolean;
+}
 /**
  * The shape of the data `@adonisjs/lucid` emits on `db:query`. Mirrored
  * structurally from `@adonisjs/lucid`'s `DbQueryEventNode` (verified against the
@@ -54,11 +66,17 @@ export interface QueryEntryContent {
 export declare class LucidQueryWatcher implements Watcher {
     readonly type: "query";
     private unsubscribe;
+    private readonly slowMs;
+    private readonly captureBindings;
+    private readonly ignoreConnections;
+    private readonly normalize;
+    constructor(options?: LucidQueryWatcherOptions);
     start(emitter: EmitterLike): void;
     stop(): void;
     /** Validate + record a single `db:query` payload, never throwing. */
     private handle;
 }
-/** Map a Lucid `db:query` payload to a telescope {@link RecordInput}. */
-export declare function buildQueryEntry(event: DbQueryEventLike): RecordInput<QueryEntryContent>;
+/** Map a Lucid `db:query` payload to a telescope {@link RecordInput}. Exported so
+ *  the entry shape can be unit-tested without a running emitter. */
+export declare function buildQueryEntry(event: DbQueryEventLike, options?: LucidQueryWatcherOptions): RecordInput<QueryEntryContent>;
 //# sourceMappingURL=lucid_query_watcher.d.ts.map

package/dist/src/watchers/lucid_query_watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lucid_query_watcher.d.ts","sourceRoot":"","sources":["../../../src/watchers/lucid_query_watcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAIzD,uDAAuD;AACvD,eAAO,MAAM,cAAc,aAAa,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0EAA0E;IAC1E,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,oDAAoD;IACpD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAiBD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,QAAQ,CAAC,IAAI,UAAmB;IAChC,OAAO,CAAC,WAAW,CAA6B;IAEhD,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKjC,IAAI,IAAI,IAAI;IAKZ,qEAAqE;IACrE,OAAO,CAAC,MAAM;CAIf;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAyBvF"}
+{"version":3,"file":"lucid_query_watcher.d.ts","sourceRoot":"","sources":["../../../src/watchers/lucid_query_watcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAIzD,uDAAuD;AACvD,eAAO,MAAM,cAAc,aAAa,CAAC;AAQzC;0EAC0E;AAC1E,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0EAA0E;IAC1E,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,oDAAoD;IACpD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAiBD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,QAAQ,CAAC,IAAI,UAAmB;IAChC,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAc;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;gBAExB,OAAO,GAAE,wBAA6B;IASlD,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKjC,IAAI,IAAI,IAAI;IAKZ,qEAAqE;IACrE,OAAO,CAAC,MAAM;CAcf;AAED;oEACoE;AACpE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,wBAA6B,GACrC,WAAW,CAAC,iBAAiB,CAAC,CAqChC"}