@adonis-agora/telescope 0.2.0 → 0.3.1

package/dist/src/ui/http.js

@@ -29,6 +29,49 @@ export class RecordingResponse {
         return body;
     }
 }
+/**
+ * Format one Server-Sent-Events frame. `data` is JSON-encoded onto a single
+ * `data:` line; an optional `event` name is prefixed. Always terminated by the
+ * blank line that delimits SSE frames.
+ *
+ * ```text
+ * event: entry\n
+ * data: {"type":"request",...}\n
+ * \n
+ * ```
+ */
+export function formatSseFrame(data, event) {
+    const payload = JSON.stringify(data);
+    const prefix = event !== undefined ? `event: ${event}\n` : '';
+    return `${prefix}data: ${payload}\n\n`;
+}
+/** A comment-only SSE keep-alive line (ignored by clients, keeps the socket warm). */
+export function formatSseHeartbeat() {
+    return ': heartbeat\n\n';
+}
+/**
+ * A tiny in-memory {@link SseSink} for tests: captures every written frame and
+ * lets a test trigger the client-disconnect path via {@link RecordingSink.close}.
+ */
+export class RecordingSink {
+    chunks = [];
+    closed = false;
+    closeHandlers = [];
+    write(chunk) {
+        this.chunks.push(chunk);
+    }
+    onClose(handler) {
+        this.closeHandlers.push(handler);
+    }
+    /** Simulate a client disconnect, firing every registered close handler once. */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const handler of this.closeHandlers.splice(0))
+            handler();
+    }
+}
 /** Build a plain {@link UiRequest} from a method, query record, and headers. */
 export function makeRequest(method, qs = {}, headers = {}) {
     const lower = {};

package/dist/src/ui/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/ui/http.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAC5B,UAAU,GAAG,GAAG,CAAC;IACR,OAAO,GAA2B,EAAE,CAAC;IAC9C,IAAI,GAAY,SAAS,CAAC;IAC1B,IAAI,GAAG,KAAK,CAAC;IAEb,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,KAAa;QAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,IAAa;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,KAA8B,EAAE,EAChC,UAAkC,EAAE;IAEpC,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;IACrF,OAAO;QACL,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM;QACpB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE;QACZ,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/ui/http.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4BH;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAC5B,UAAU,GAAG,GAAG,CAAC;IACR,OAAO,GAA2B,EAAE,CAAC;IAC9C,IAAI,GAAY,SAAS,CAAC;IAC1B,IAAI,GAAG,KAAK,CAAC;IAEb,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,KAAa;QAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,IAAa;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAmBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa,EAAE,KAAc;IAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,OAAO,GAAG,MAAM,SAAS,OAAO,MAAM,CAAC;AACzC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,kBAAkB;IAChC,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,aAAa;IACf,MAAM,GAAa,EAAE,CAAC;IAC/B,MAAM,GAAG,KAAK,CAAC;IACE,aAAa,GAAsB,EAAE,CAAC;IAEvD,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,OAAmB;QACzB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,gFAAgF;IAChF,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;IAChE,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,KAA8B,EAAE,EAChC,UAAkC,EAAE;IAEpC,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;IACrF,OAAO;QACL,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM;QACpB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE;QACZ,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC"}

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

@@ -1,12 +1,14 @@
 /** Keep in sync with this package's `version` in package.json. */
 export declare const VERSION = "0.1.0";
 export { defineConfig, resolveConfig, normalizePath, defaultAuthorize } from './define_config.js';
-export type { AuthorizeHook, ResolvedTelescopeUiConfig, TelescopeUiConfig, UiCredentials, } from './define_config.js';
-export { RecordingResponse, makeRequest } from './http.js';
-export type { UiHttpContext, UiRequest, UiResponse } from './http.js';
+export type { AuthorizeHook, ReplayConfig, ResolvedTelescopeUiConfig, TelescopeUiConfig, UiCredentials, } from './define_config.js';
+export { RecordingResponse, RecordingSink, formatSseFrame, formatSseHeartbeat, makeRequest, } from './http.js';
+export type { SseSink, UiHttpContext, UiRequest, UiResponse } from './http.js';
 export { enforceGuard, runGuard } from './guard.js';
 export type { GuardResult } from './guard.js';
 export { TelescopeApi, buildQuery, toSummary } from './api.js';
 export type { EntrySummary } from './api.js';
+export { replayRequest, REPLAY_BODY_CAP, REPLAY_STRIPPED_HEADERS, REPLAY_TIMEOUT_MS, } from './request_replay.js';
+export type { ReplayOptions, ReplayResult, ReplayTransport } from './request_replay.js';
 export { renderDashboard } from './dashboard.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAClG,YAAY,EACV,aAAa,EACb,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAClG,YAAY,EACV,aAAa,EACb,YAAY,EACZ,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG/E,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EACL,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGxF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/ui/index.js

@@ -3,11 +3,13 @@ export const VERSION = '0.1.0';
 // — config —
 export { defineConfig, resolveConfig, normalizePath, defaultAuthorize } from './define_config.js';
 // — HTTP shapes (framework-light) —
-export { RecordingResponse, makeRequest } from './http.js';
+export { RecordingResponse, RecordingSink, formatSseFrame, formatSseHeartbeat, makeRequest, } from './http.js';
 // — auth guard —
 export { enforceGuard, runGuard } from './guard.js';
 // — JSON API —
 export { TelescopeApi, buildQuery, toSummary } from './api.js';
+// — request replay —
+export { replayRequest, REPLAY_BODY_CAP, REPLAY_STRIPPED_HEADERS, REPLAY_TIMEOUT_MS, } from './request_replay.js';
 // — dashboard —
 export { renderDashboard } from './dashboard.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAQlG,oCAAoC;AACpC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG3D,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGpD,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG/D,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ui/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AASlG,oCAAoC;AACpC,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,WAAW,GACZ,MAAM,WAAW,CAAC;AAGnB,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGpD,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG/D,qBAAqB;AACrB,OAAO,EACL,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/ui/request_replay.d.ts

@@ -0,0 +1,63 @@
+import type { RequestEntryContent } from '../request_watcher.js';
+/** A minimal `fetch`-shaped transport, injectable so tests don't hit the network. */
+export type ReplayTransport = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+    signal: AbortSignal;
+    redirect: 'manual';
+}) => Promise<{
+    status: number;
+    text(): Promise<string>;
+}>;
+/** Options for {@link replayRequest} (all injectable for tests). */
+export interface ReplayOptions {
+    /** Transport used to re-issue the call. Defaults to the global `fetch`,
+     *  marked internal so the http-client watcher skips it. */
+    transport?: ReplayTransport;
+    /** Explicit local-server port override (from telescope_ui `replay.port`). When
+     *  set it wins over everything else — use it for reverse-proxy / non-standard
+     *  setups where the live socket port isn't the app's real port. */
+    port?: number;
+    /** The port the live dashboard request arrived on (the server actually serving
+     *  the UI). Used when no explicit {@link port} override is configured so a replay
+     *  targets the same server it was triggered from. Falls back to `PORT` env, then
+     *  3333 (the AdonisJS default). */
+    requestPort?: number;
+    /** Per-call timeout in ms. Default {@link REPLAY_TIMEOUT_MS}. */
+    timeoutMs?: number;
+    /** Time source; injectable for tests. Default `Date.now`. */
+    clock?: {
+        now(): number;
+    };
+}
+/** Outcome of a request replay. */
+export interface ReplayResult {
+    /** HTTP status of the replayed response, or `0` when the call never completed. */
+    status: number;
+    /** Wall-clock duration of the replay in ms. */
+    durationMs: number;
+    /** The response body, capped at {@link REPLAY_BODY_CAP} bytes. */
+    body: string;
+    /** Present when the replay failed to complete (timeout / network error). */
+    error?: string;
+}
+/** Default per-call timeout for a replay (30s). */
+export declare const REPLAY_TIMEOUT_MS = 30000;
+/** Max bytes of the replayed response body returned (4 KB). */
+export declare const REPLAY_BODY_CAP = 4096;
+/** Headers stripped from the replayed request (auth/session/routing leakage). */
+export declare const REPLAY_STRIPPED_HEADERS: Set<string>;
+/**
+ * Re-issue a captured `request` entry against the LOCAL server (127.0.0.1:<port>)
+ * so a developer can reproduce it from the dashboard.
+ *
+ * The Adonis `request` watcher only captures `method` + `url` (path), so the
+ * replay reconstructs exactly that: a GET-style call to the same local path. The
+ * call carries `x-telescope-replay: 1`, strips cookie/authorization/host headers
+ * (see the SAFETY POSTURE at the top of this file), is bounded by a timeout, and
+ * caps the returned body at 4 KB. Never throws — a failed call returns
+ * `status: 0` with an `error`.
+ */
+export declare function replayRequest(content: RequestEntryContent, options?: ReplayOptions): Promise<ReplayResult>;
+//# sourceMappingURL=request_replay.d.ts.map

package/dist/src/ui/request_replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request_replay.d.ts","sourceRoot":"","sources":["../../../src/ui/request_replay.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,qFAAqF;AACrF,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;CACpB,KACE,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAE1D,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B;+DAC2D;IAC3D,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;uEAEmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;uCAGmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,KAAK,CAAC,EAAE;QAAE,GAAG,IAAI,MAAM,CAAA;KAAE,CAAC;CAC3B;AAED,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,QAAS,CAAC;AACxC,+DAA+D;AAC/D,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,aAKlC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAqCvB"}

package/dist/src/ui/request_replay.js

@@ -0,0 +1,132 @@
+// packages/core/src/ui/request_replay.ts
+//
+// Request REPLAY subsystem: re-issue a captured `request` entry against the LOCAL
+// server so a developer can reproduce it from the dashboard. Ported from the
+// NestJS `nestjs-telescope` `nest/request-replay.ts` (the source of truth) and
+// adapted to the Adonis telescope data model and outbound-fetch conventions.
+//
+// SAFETY POSTURE (read before changing anything here):
+//   - DISABLED BY DEFAULT. Replaying re-issues a real request that may MUTATE
+//     application state (a captured `POST`/`DELETE` will run again), so the host
+//     must opt in via `config/telescope_ui.ts` → `replay: { enabled: true }`.
+//     This mirrors the NestJS original, which gates replay behind a default-deny
+//     `authorizeAction` mutation gate. A disabled replay never issues a call.
+//   - SAME-ORIGIN ONLY. The replay always targets `127.0.0.1:<port>` (the local
+//     server) — never an arbitrary URL — so it can't be turned into an SSRF
+//     primitive against internal services. Only the captured PATH is reused.
+//   - CREDENTIAL STRIPPING. `cookie` / `authorization` / `host` / `content-length`
+//     are stripped (see {@link REPLAY_STRIPPED_HEADERS}): a replay must not
+//     silently reuse the original caller's credentials or session.
+//   - SELF-IDENTIFYING. The replay carries `x-telescope-replay: 1` so the host
+//     can recognize/skip it, and the outbound fetch is marked internal so the
+//     http-client watcher never records (or recurses on) it.
+//   - BOUNDED. A 30s timeout and a 4 KB response-body cap; never throws — a
+//     failed call resolves to `status: 0` with an `error`.
+//
+// REDACTION / CAPTURED-DATA LIMITATION:
+//   The Adonis `request` watcher records only `method` + `url` (path, no query
+//   string), `status` and timing — it deliberately does NOT capture request
+//   headers or the request body (the NestJS original captured `headers`/`payload`
+//   and so could replay them; this port has no such fields to replay). A stored
+//   entry's `content` is also run through telescope's redaction before
+//   persistence, so even where a value exists it may be `[REDACTED]`. We therefore
+//   reconstruct only what is safe and present (method + path) and NEVER forward a
+//   redacted value upstream — there is nothing to leak.
+/** Default per-call timeout for a replay (30s). */
+export const REPLAY_TIMEOUT_MS = 30_000;
+/** Max bytes of the replayed response body returned (4 KB). */
+export const REPLAY_BODY_CAP = 4096;
+/** Headers stripped from the replayed request (auth/session/routing leakage). */
+export const REPLAY_STRIPPED_HEADERS = new Set([
+    'cookie',
+    'authorization',
+    'host',
+    'content-length',
+]);
+/**
+ * Re-issue a captured `request` entry against the LOCAL server (127.0.0.1:<port>)
+ * so a developer can reproduce it from the dashboard.
+ *
+ * The Adonis `request` watcher only captures `method` + `url` (path), so the
+ * replay reconstructs exactly that: a GET-style call to the same local path. The
+ * call carries `x-telescope-replay: 1`, strips cookie/authorization/host headers
+ * (see the SAFETY POSTURE at the top of this file), is bounded by a timeout, and
+ * caps the returned body at 4 KB. Never throws — a failed call returns
+ * `status: 0` with an `error`.
+ */
+export async function replayRequest(content, options = {}) {
+    const transport = options.transport ?? defaultTransport;
+    const clock = options.clock ?? { now: () => Date.now() };
+    const timeoutMs = options.timeoutMs ?? REPLAY_TIMEOUT_MS;
+    const port = resolvePort(options.port, options.requestPort);
+    const path = content.url.startsWith('/') ? content.url : `/${content.url}`;
+    const url = `http://127.0.0.1:${port}${path}`;
+    const headers = buildReplayHeaders();
+    const method = (content.method || 'GET').toUpperCase();
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const startedAt = clock.now();
+    try {
+        const response = await transport(url, {
+            method,
+            headers,
+            signal: controller.signal,
+            redirect: 'manual',
+        });
+        const text = await response.text();
+        return {
+            status: response.status,
+            durationMs: clock.now() - startedAt,
+            body: text.slice(0, REPLAY_BODY_CAP),
+        };
+    }
+    catch (error) {
+        return {
+            status: 0,
+            durationMs: clock.now() - startedAt,
+            body: '',
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Build the replay request headers. Because the Adonis watcher captures no
+ * request headers, there is nothing to copy (and so nothing to leak) — we only
+ * force the self-identifying `x-telescope-replay: 1` marker. The
+ * {@link REPLAY_STRIPPED_HEADERS} set is documented/exported so the safety
+ * contract is explicit and unit-testable even though no source headers exist.
+ */
+function buildReplayHeaders() {
+    return { 'x-telescope-replay': '1' };
+}
+/**
+ * Resolve the local server port to target, in precedence order:
+ *   1. `explicit` — the configured `replay.port` override (wins when set).
+ *   2. `requestPort` — the live dashboard request's local port, so a replay hits
+ *      the same server it was triggered from.
+ *   3. the `PORT` env var.
+ *   4. `3333`, the AdonisJS conventional default (NOT 3000).
+ */
+function resolvePort(explicit, requestPort) {
+    if (isUsablePort(explicit))
+        return explicit;
+    if (isUsablePort(requestPort))
+        return requestPort;
+    const envPort = Number(process.env.PORT);
+    return Number.isFinite(envPort) && envPort > 0 ? envPort : 3333;
+}
+/** A finite, positive port number. */
+function isUsablePort(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0;
+}
+/** The default transport: the global `fetch`, marked internal so the http-client
+ *  watcher never records (or recurses on) the replay call. */
+const defaultTransport = (url, init) => fetch(url, { ...init, [INTERNAL]: true });
+/** Mirror of `markInternalFetch`'s marker (`@agora/telescope:internalFetch`) so a
+ *  replay's outbound fetch is skipped by the http-client watcher without creating
+ *  a hard import cycle through the watcher module. */
+const INTERNAL = Symbol.for('@agora/telescope:internalFetch');
+//# sourceMappingURL=request_replay.js.map

package/dist/src/ui/request_replay.js.map

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

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

@@ -1,5 +1,18 @@
+/**
+ * NOTE — no `'schedule'` watcher is shipped, intentionally. The NestJS original
+ * (`@dudousxd/nestjs-telescope`'s schedule package) wraps `@nestjs/schedule`'s
+ * `@Cron`/`@Interval`/`@Timeout` decorators via its `SchedulerRegistry`. AdonisJS
+ * has NO first-party scheduler, and the popular community schedulers
+ * (`adonisjs-scheduler` et al.) emit nothing on the app emitter and expose no
+ * lifecycle hooks — so a generic schedule watcher could only be built by inventing
+ * /wrapping a private API. It is therefore deliberately omitted. In the Agora
+ * ecosystem, `@adonis-agora/durable` already bridges its scheduled/cron + workflow
+ * run events onto the diagnostics bus, which the generic {@link DiagnosticsWatcher}
+ * records — so scheduled-run observability is covered there, not by a bespoke
+ * schedule watcher.
+ */
 /** The per-technology watchers this package ships. */
-export type WatcherName = 'query' | 'mail' | 'cache' | 'http-client' | 'logs';
+export type WatcherName = 'query' | 'mail' | 'cache' | 'http-client' | 'logs' | 'queue' | 'events' | 'redis';
 /**
  * The shape of `config/telescope_watchers.ts`. Everything is optional: by default
  * only the Lucid `query` watcher is enabled (it is the one whose events are
@@ -18,6 +31,9 @@ export interface TelescopeWatchersConfig {
      *  - `'cache'` — records `@adonisjs/cache` hit/miss/write/delete events.
      *  - `'http-client'` — records every outbound `fetch` call.
      *  - `'logs'`  — records AdonisJS logger output as `log` entries.
+     *  - `'queue'` — records `@adonisjs/queue` job executions (optional peer).
+     *  - `'events'` — records every event emitted through the core Emitter.
+     *  - `'redis'` — records `@adonisjs/redis` commands (optional peer).
      */
     watchers?: WatcherName[];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"define_config.d.ts","sourceRoot":"","sources":["../../../src/watchers/define_config.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;AAE9E;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,8EAA8E;AAC9E,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;CAC5B;AAED,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAAc,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,uBAAuB,GAAG,uBAAuB,CAErF;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAC3B,MAAM,GAAE,uBAA4B,GACnC,+BAA+B,CAKjC"}
+{"version":3,"file":"define_config.d.ts","sourceRoot":"","sources":["../../../src/watchers/define_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,sDAAsD;AACtD,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,MAAM,GACN,OAAO,GACP,aAAa,GACb,MAAM,GACN,OAAO,GACP,QAAQ,GACR,OAAO,CAAC;AAEZ;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,8EAA8E;AAC9E,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;CAC5B;AAED,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAAc,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,uBAAuB,GAAG,uBAAuB,CAErF;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAC3B,MAAM,GAAE,uBAA4B,GACnC,+BAA+B,CAKjC"}

package/dist/src/watchers/define_config.js

@@ -1,3 +1,16 @@
+/**
+ * NOTE — no `'schedule'` watcher is shipped, intentionally. The NestJS original
+ * (`@dudousxd/nestjs-telescope`'s schedule package) wraps `@nestjs/schedule`'s
+ * `@Cron`/`@Interval`/`@Timeout` decorators via its `SchedulerRegistry`. AdonisJS
+ * has NO first-party scheduler, and the popular community schedulers
+ * (`adonisjs-scheduler` et al.) emit nothing on the app emitter and expose no
+ * lifecycle hooks — so a generic schedule watcher could only be built by inventing
+ * /wrapping a private API. It is therefore deliberately omitted. In the Agora
+ * ecosystem, `@adonis-agora/durable` already bridges its scheduled/cron + workflow
+ * run events onto the diagnostics bus, which the generic {@link DiagnosticsWatcher}
+ * records — so scheduled-run observability is covered there, not by a bespoke
+ * schedule watcher.
+ */
 /** The default set of enabled watchers — the verified Lucid query watcher only. */
 export const DEFAULT_WATCHERS = ['query'];
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"define_config.js","sourceRoot":"","sources":["../../../src/watchers/define_config.ts"],"names":[],"mappings":"AAgCA,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAkB,CAAC,OAAO,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA+B;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,aAAa,CAC3B,SAAkC,EAAE;IAEpC,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;QAC/B,QAAQ,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,gBAAgB,CAAC;KACvD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"define_config.js","sourceRoot":"","sources":["../../../src/watchers/define_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA6CH,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAkB,CAAC,OAAO,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA+B;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,aAAa,CAC3B,SAAkC,EAAE;IAEpC,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;QAC/B,QAAQ,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,gBAAgB,CAAC;KACvD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,63 @@
+import { type RecordInput } from '../entry.js';
+/**
+ * The narrow structural slice of the `@adonisjs/core` Emitter this watcher needs:
+ * `onAny(listener)` to observe EVERY emitted event, returning an unsubscribe
+ * function (the exact contract `@adonisjs/events` ships — its emitter, built on
+ * `emittery`, returns `() => void` from `onAny`). Mirrored structurally rather than
+ * imported so the watcher stays unit-testable with a plain double and carries no
+ * build-time coupling to a specific emitter version.
+ *
+ * The listener receives `(event, data)`: the event NAME (a string, or a class
+ * constructor for class-based events) and the single emitted payload.
+ */
+export interface EmitterAnyLike {
+    onAny(listener: (event: unknown, data: unknown) => unknown): () => void;
+}
+/** Narrow an arbitrary resolved provider to one with a usable `onAny`. */
+export declare function hasOnAny(value: unknown): value is EmitterAnyLike;
+/** The recorded body of an `event` entry. */
+export interface EventEntryContent {
+    /** The emitted event name (string events) or class name (class-based events). */
+    name: string;
+    /** The single emitted payload, recorded as-is (redaction applies downstream). */
+    payload: unknown;
+    /** The active trace id at emit time, or `null`. */
+    traceId: string | null;
+}
+/**
+ * Captures EVERY event emitted through the core `@adonisjs/core` Emitter and
+ * records one `event` telescope entry per emit — the name and payload — correlated
+ * to the active request via the trace id. It attaches a single wildcard listener
+ * via `emitter.onAny(...)`.
+ *
+ * An ignore-list (constructor option, matched against the resolved event name)
+ * filters out noisy or already-watched events — e.g. `'db:query'` (the Lucid query
+ * watcher already records those) or `'mail:sent'`. Mirrors the filtering of the
+ * NestJS `EventsWatcher` original.
+ *
+ * Recording is fire-and-forget and fully guarded: a telescope failure can never
+ * break or block an emit.
+ */
+export declare class EventsWatcher {
+    readonly type: "event";
+    private readonly ignore;
+    private unsubscribe;
+    constructor(ignore?: string[]);
+    /**
+     * Begin recording. A no-op when the emitter has no `onAny` (degrades gracefully
+     * rather than throwing). Idempotent: a second call is ignored.
+     */
+    start(emitter: unknown): void;
+    /** Detach the wildcard listener. Safe to call when never started. */
+    stop(): void;
+    private handle;
+}
+/**
+ * The events the watcher ignores by default. These are emitted by Adonis surfaces
+ * that already have a dedicated telescope watcher, so capturing them here would
+ * double-record. A host can override the set via the constructor.
+ */
+export declare const DEFAULT_IGNORED_EVENTS: string[];
+/** Map an emitted event name + payload to a telescope {@link RecordInput}. */
+export declare function buildEventEntry(name: string, payload: unknown): RecordInput<EventEntryContent>;
+//# sourceMappingURL=events_watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events_watcher.d.ts","sourceRoot":"","sources":["../../../src/watchers/events_watcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,MAAM,IAAI,CAAC;CACzE;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAMhE;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAWD;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,UAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,WAAW,CAA6B;gBAEpC,MAAM,GAAE,MAAM,EAA2B;IAIrD;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAM7B,qEAAqE;IACrE,IAAI,IAAI,IAAI;IAKZ,OAAO,CAAC,MAAM;CAKf;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,EAA8B,CAAC;AAE1E,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAU9F"}

package/dist/src/watchers/events_watcher.js

@@ -0,0 +1,81 @@
+import { currentTraceId } from '../context_accessor.js';
+import { EntryType } from '../entry.js';
+import { safeRecord } from './record.js';
+/** Narrow an arbitrary resolved provider to one with a usable `onAny`. */
+export function hasOnAny(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.onAny === 'function');
+}
+/** Coerce an Adonis event identifier (string, or a class constructor) to a name. */
+function eventName(event) {
+    if (typeof event === 'string')
+        return event;
+    if (typeof event === 'function' && typeof event.name === 'string' && event.name) {
+        return event.name;
+    }
+    return String(event);
+}
+/**
+ * Captures EVERY event emitted through the core `@adonisjs/core` Emitter and
+ * records one `event` telescope entry per emit — the name and payload — correlated
+ * to the active request via the trace id. It attaches a single wildcard listener
+ * via `emitter.onAny(...)`.
+ *
+ * An ignore-list (constructor option, matched against the resolved event name)
+ * filters out noisy or already-watched events — e.g. `'db:query'` (the Lucid query
+ * watcher already records those) or `'mail:sent'`. Mirrors the filtering of the
+ * NestJS `EventsWatcher` original.
+ *
+ * Recording is fire-and-forget and fully guarded: a telescope failure can never
+ * break or block an emit.
+ */
+export class EventsWatcher {
+    type = EntryType.Event;
+    ignore;
+    unsubscribe = null;
+    constructor(ignore = DEFAULT_IGNORED_EVENTS) {
+        this.ignore = new Set(ignore);
+    }
+    /**
+     * Begin recording. A no-op when the emitter has no `onAny` (degrades gracefully
+     * rather than throwing). Idempotent: a second call is ignored.
+     */
+    start(emitter) {
+        if (this.unsubscribe)
+            return;
+        if (!hasOnAny(emitter))
+            return;
+        this.unsubscribe = emitter.onAny((event, data) => this.handle(event, data));
+    }
+    /** Detach the wildcard listener. Safe to call when never started. */
+    stop() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+    }
+    handle(event, data) {
+        const name = eventName(event);
+        if (this.ignore.has(name))
+            return;
+        safeRecord(buildEventEntry(name, data), 'EventsWatcher');
+    }
+}
+/**
+ * The events the watcher ignores by default. These are emitted by Adonis surfaces
+ * that already have a dedicated telescope watcher, so capturing them here would
+ * double-record. A host can override the set via the constructor.
+ */
+export const DEFAULT_IGNORED_EVENTS = ['db:query', 'mail:sent'];
+/** Map an emitted event name + payload to a telescope {@link RecordInput}. */
+export function buildEventEntry(name, payload) {
+    const traceId = currentTraceId();
+    const content = { name, payload, traceId };
+    return {
+        type: EntryType.Event,
+        familyHash: `event:${name}`,
+        content,
+        traceId,
+        tags: ['event', `event:${name}`],
+    };
+}
+//# sourceMappingURL=events_watcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events_watcher.js","sourceRoot":"","sources":["../../../src/watchers/events_watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiBzC,0EAA0E;AAC1E,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAA6B,CAAC,KAAK,KAAK,UAAU,CAC3D,CAAC;AACJ,CAAC;AAYD,oFAAoF;AACpF,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAChF,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC;IACf,MAAM,CAAc;IAC7B,WAAW,GAAwB,IAAI,CAAC;IAEhD,YAAY,SAAmB,sBAAsB;QACnD,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAgB;QACpB,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO;QAC/B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,qEAAqE;IACrE,IAAI;QACF,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAEO,MAAM,CAAC,KAAc,EAAE,IAAa;QAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAClC,UAAU,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,eAAe,CAAC,CAAC;IAC3D,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAa,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAE1E,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAgB;IAC5D,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,OAAO,GAAsB,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC9D,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,UAAU,EAAE,SAAS,IAAI,EAAE;QAC3B,OAAO;QACP,OAAO;QACP,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;KACjC,CAAC;AACJ,CAAC"}

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

@@ -14,6 +14,12 @@ export type { HttpClientEntryContent, HttpClientWatcherOptions, } from './http_c
 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';
+export { buildJobEntry, QUEUE_EXECUTE_CHANNEL, QueueWatcher } from './queue_watcher.js';
+export type { AcquiredJobLike, JobEntryContent, JobExecuteMessageLike, JobStatus, QueueWatcherOptions, } from './queue_watcher.js';
+export { buildEventEntry, DEFAULT_IGNORED_EVENTS, EventsWatcher, hasOnAny, } from './events_watcher.js';
+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 { DEFAULT_WATCHERS, defineConfig, resolveConfig, } from './define_config.js';
 export type { ResolvedTelescopeWatchersConfig, 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,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,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"}

package/dist/src/watchers/index.js

@@ -14,6 +14,12 @@ export { buildHttpClientEntry, HttpClientWatcher, markInternalFetch, } from './h
 export { normalizeHttpTarget } from './normalize_http_target.js';
 // — logs watcher —
 export { buildLogEntry, extractLog, LOG_LEVELS, LogsWatcher } from './logs_watcher.js';
+// — queue/jobs watcher (optional peer: @adonisjs/queue) —
+export { buildJobEntry, QUEUE_EXECUTE_CHANNEL, QueueWatcher } from './queue_watcher.js';
+// — events watcher (core @adonisjs/core Emitter) —
+export { buildEventEntry, DEFAULT_IGNORED_EVENTS, EventsWatcher, hasOnAny, } from './events_watcher.js';
+// — redis watcher (optional peer: @adonisjs/redis) —
+export { buildRedisEntry, RedisWatcher } from './redis_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,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;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"}