@adonis-agora/telescope 0.1.0

package/dist/src/watchers/logs_watcher.js

@@ -0,0 +1,145 @@
+import { currentTraceId } from '../context_accessor.js';
+import { EntryType } from '../entry.js';
+import { safeRecord } from './record.js';
+/** The standard pino/AdonisJS log levels this watcher tees, lowest → highest. */
+export const LOG_LEVELS = ['trace', 'debug', 'info', 'warn', 'error', 'fatal'];
+/** Marks a wrapped method so a logger instance is teed exactly once even if two
+ *  watchers (or two package copies) wrap it. */
+const TEED = Symbol.for('@agora/telescope:logMethodTeed');
+/**
+ * Reentrancy guard: while recording a log we may ourselves log on failure, which
+ * would re-enter the tee. The flag makes a nested log call through to the
+ * original WITHOUT recording, breaking the record→log→record loop.
+ */
+let recording = false;
+/**
+ * Records AdonisJS `Logger` output as `EntryType.Log` entries, correlated to the
+ * active request via the trace id.
+ *
+ * ## How it taps the logger (non-invasive, reversible)
+ * Rather than monkey-patching a global or a prototype, `start(logger)` tees the
+ * level methods on the ONE logger instance resolved from the container. Each teed
+ * method calls the original first (host output is untouched) and then records.
+ * `stop()` restores the originals, so the tap fully unwinds on shutdown.
+ *
+ * Pino has no supported post-construction transport/hook for a live instance, so
+ * instance-scoped method-teeing is the least-invasive option that captures logs
+ * written through the app logger without owning its construction. The tee is
+ * idempotent per instance (a `Symbol.for` marker) and a reentrancy guard prevents
+ * an infinite record→log loop.
+ *
+ * Recording is fire-and-forget and fully guarded — a telescope failure can never
+ * break the host's logging.
+ */
+export class LogsWatcher {
+    type = EntryType.Log;
+    minLevelIndex;
+    extraTags;
+    logger = null;
+    constructor(options = {}) {
+        this.minLevelIndex = LOG_LEVELS.indexOf(options.minLevel ?? 'trace');
+        this.extraTags = options.tags ?? [];
+    }
+    /** Tee the level methods on `logger`. Idempotent per instance. */
+    start(logger) {
+        if (this.logger)
+            return;
+        this.logger = logger;
+        const watcher = this;
+        for (let index = 0; index < LOG_LEVELS.length; index++) {
+            const level = LOG_LEVELS[index];
+            const original = logger[level];
+            if (typeof original !== 'function' || original[TEED])
+                continue;
+            const teed = function teedLevel(...args) {
+                // Nested log (e.g. our own failure logging) — call the original but
+                // don't record, breaking the record→log→record loop.
+                if (recording) {
+                    original.apply(this, args);
+                    return;
+                }
+                original.apply(this, args);
+                if (index < watcher.minLevelIndex)
+                    return;
+                recording = true;
+                try {
+                    watcher.record(level, args);
+                }
+                finally {
+                    recording = false;
+                }
+            };
+            teed[TEED] = true;
+            teed.__telescopeOriginal__ = original;
+            logger[level] = teed;
+        }
+    }
+    /** Restore the original level methods on the tapped instance. */
+    stop() {
+        const logger = this.logger;
+        if (!logger)
+            return;
+        this.logger = null;
+        for (const level of LOG_LEVELS) {
+            const current = logger[level];
+            if (current?.[TEED] && current.__telescopeOriginal__) {
+                logger[level] = current.__telescopeOriginal__;
+            }
+        }
+    }
+    /** Build + record a log entry from the level method's arguments. */
+    record(level, args) {
+        safeRecord(buildLogEntry(level, args, this.extraTags), 'LogsWatcher');
+    }
+}
+/** A plain object literal (`{}` / `Object.create(null)`) — the only `mergingObject`
+ *  shape we copy as structured context. Class instances, arrays, etc. are skipped. */
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/**
+ * Parse a pino-style level call into `{ message, context }`, mirroring pino's own
+ * argument convention: either `(message, ...)` or `(mergingObject, message?, ...)`.
+ * The context object is shallow-copied and bounded to a handful of keys here; the
+ * central redaction layer scrubs any sensitive values before storage.
+ */
+export function extractLog(args) {
+    const [first, second] = args;
+    if (isPlainObject(first)) {
+        const context = boundContext(first);
+        const message = typeof second === 'string' ? second : null;
+        return { message, context };
+    }
+    return { message: typeof first === 'string' ? first : null, context: null };
+}
+/** Shallow-copy at most the first 50 own keys of a merging object — a bound so a
+ *  single log entry can't retain an unbounded structured payload. */
+function boundContext(object) {
+    const out = {};
+    let count = 0;
+    for (const key of Object.keys(object)) {
+        if (count >= 50)
+            break;
+        out[key] = object[key];
+        count++;
+    }
+    return out;
+}
+/** Map a level + raw method args to a telescope {@link RecordInput}. Exported so
+ *  the entry shape can be unit-tested without teeing a logger. */
+export function buildLogEntry(level, args, extraTags = []) {
+    const { message, context } = extractLog(args);
+    const traceId = currentTraceId();
+    const content = { level, message, context, traceId };
+    return {
+        type: EntryType.Log,
+        familyHash: `log:${level}`,
+        content,
+        traceId,
+        tags: ['log', `log:${level}`, ...extraTags],
+    };
+}
+//# sourceMappingURL=logs_watcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs_watcher.js","sourceRoot":"","sources":["../../../src/watchers/logs_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;AAEzC,iFAAiF;AACjF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAsCxF;gDACgD;AAChD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAO1D;;;;GAIG;AACH,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC;IACb,aAAa,CAAS;IACtB,SAAS,CAAoB;IACtC,MAAM,GAAsB,IAAI,CAAC;IAEzC,YAAY,UAA8B,EAAE;QAC1C,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IACtC,CAAC;IAED,kEAAkE;IAClE,KAAK,CAAC,MAAkB;QACtB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC;QAErB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YACvD,MAAM,KAAK,GAAa,UAAU,CAAC,KAAK,CAAa,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAA2B,CAAC;YACzD,IAAI,OAAO,QAAQ,KAAK,UAAU,IAAI,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAS;YAE/D,MAAM,IAAI,GAAG,SAAS,SAAS,CAAgB,GAAG,IAAe;gBAC/D,oEAAoE;gBACpE,qDAAqD;gBACrD,IAAI,SAAS,EAAE,CAAC;oBACd,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBAC3B,OAAO;gBACT,CAAC;gBACD,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC3B,IAAI,KAAK,GAAG,OAAO,CAAC,aAAa;oBAAE,OAAO;gBAC1C,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,CAAC;oBACH,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC9B,CAAC;wBAAS,CAAC;oBACT,SAAS,GAAG,KAAK,CAAC;gBACpB,CAAC;YACH,CAAe,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC,qBAAqB,GAAG,QAAQ,CAAC;YACtC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,IAAI;QACF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAA2B,CAAC;YACxD,IAAI,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;gBACrD,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED,oEAAoE;IAC5D,MAAM,CAAC,KAAe,EAAE,IAAe;QAC7C,UAAU,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC;IACxE,CAAC;CACF;AAED;sFACsF;AACtF,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAe;IAIxC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC7B,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC9E,CAAC;AAED;qEACqE;AACrE,SAAS,YAAY,CAAC,MAA+B;IACnD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,KAAK,IAAI,EAAE;YAAE,MAAM;QACvB,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,KAAK,EAAE,CAAC;IACV,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;kEACkE;AAClE,MAAM,UAAU,aAAa,CAC3B,KAAe,EACf,IAAe,EACf,YAA+B,EAAE;IAEjC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,OAAO,GAAoB,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACtE,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,GAAG;QACnB,UAAU,EAAE,OAAO,KAAK,EAAE;QAC1B,OAAO;QACP,OAAO;QACP,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,EAAE,EAAE,GAAG,SAAS,CAAC;KAC5C,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,64 @@
+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";
+/**
+ * The shape of the data `@adonisjs/lucid` emits on `db:query`. Mirrored
+ * structurally from `@adonisjs/lucid`'s `DbQueryEventNode` (verified against the
+ * installed `@adonisjs/lucid` types — `src/types/database.d.ts`) so the watcher
+ * has no build-time dependency on Lucid. `duration` is a `process.hrtime()` tuple
+ * `[seconds, nanoseconds]`.
+ */
+export interface DbQueryEventLike {
+    connection: string;
+    sql: string;
+    method: string;
+    bindings?: unknown[];
+    duration?: [number, number];
+    model?: string;
+    ddl?: boolean;
+    inTransaction?: boolean;
+}
+/** The recorded body of a `query` entry. */
+export interface QueryEntryContent {
+    /** The executed SQL. */
+    sql: string;
+    /** The bound parameter values, in order. */
+    bindings: unknown[];
+    /** Query duration in milliseconds, or `null` when Lucid did not report one. */
+    durationMs: number | null;
+    /** The Lucid connection name (e.g. `'primary'`). */
+    connection: string;
+    /** The query method (`'select'`, `'insert'`, …), or `null` when absent. */
+    method: string | null;
+    /** Whether the query ran inside a transaction, when Lucid reported it. */
+    inTransaction: boolean | null;
+    /** The active trace id at query time, or `null`. */
+    traceId: string | null;
+}
+/**
+ * Records every SQL query Lucid executes as a `query` telescope entry — the
+ * headline watcher of this package. It subscribes to Lucid's `db:query` event
+ * (the same event `db.prettyPrint` consumes) and captures the SQL, bindings,
+ * duration, and connection, correlated to the active request via the trace id.
+ *
+ * Recording is fire-and-forget and fully guarded: a telescope failure can never
+ * break or block a query. Grouping is by SQL template (see
+ * {@link queryFamilyHash}) so a dashboard can roll up "the same query".
+ *
+ * @remarks
+ * Lucid only emits `db:query` when the connection's `debug` flag is on (or a
+ * `db:query` listener exists at query-report start). Subscribing here is enough to
+ * make Lucid report; enabling `debug` in your DB config guarantees it.
+ */
+export declare class LucidQueryWatcher implements Watcher {
+    readonly type: "query";
+    private unsubscribe;
+    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>;
+//# sourceMappingURL=lucid_query_watcher.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/watchers/lucid_query_watcher.js

@@ -0,0 +1,84 @@
+import { currentTraceId } from '../context_accessor.js';
+import { EntryType } from '../entry.js';
+import { queryFamilyHash } from './query_family_hash.js';
+import { safeRecord } from './record.js';
+/** The Lucid event name this watcher subscribes to. */
+export const DB_QUERY_EVENT = 'db:query';
+/** Convert a `process.hrtime()` `[seconds, nanoseconds]` tuple to milliseconds. */
+function hrtimeToMs(duration) {
+    if (!Array.isArray(duration) || duration.length !== 2)
+        return null;
+    const [seconds, nanoseconds] = duration;
+    if (typeof seconds !== 'number' || typeof nanoseconds !== 'number')
+        return null;
+    return seconds * 1000 + nanoseconds / 1e6;
+}
+/** Narrow an unknown emitter payload to a {@link DbQueryEventLike}. */
+function isDbQueryEvent(data) {
+    if (typeof data !== 'object' || data === null)
+        return false;
+    const candidate = data;
+    return typeof candidate.sql === 'string' && typeof candidate.connection === 'string';
+}
+/**
+ * Records every SQL query Lucid executes as a `query` telescope entry — the
+ * headline watcher of this package. It subscribes to Lucid's `db:query` event
+ * (the same event `db.prettyPrint` consumes) and captures the SQL, bindings,
+ * duration, and connection, correlated to the active request via the trace id.
+ *
+ * Recording is fire-and-forget and fully guarded: a telescope failure can never
+ * break or block a query. Grouping is by SQL template (see
+ * {@link queryFamilyHash}) so a dashboard can roll up "the same query".
+ *
+ * @remarks
+ * Lucid only emits `db:query` when the connection's `debug` flag is on (or a
+ * `db:query` listener exists at query-report start). Subscribing here is enough to
+ * make Lucid report; enabling `debug` in your DB config guarantees it.
+ */
+export class LucidQueryWatcher {
+    type = EntryType.Query;
+    unsubscribe = null;
+    start(emitter) {
+        if (this.unsubscribe)
+            return;
+        this.unsubscribe = emitter.on(DB_QUERY_EVENT, (data) => this.handle(data));
+    }
+    stop() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+    }
+    /** Validate + record a single `db:query` payload, never throwing. */
+    handle(data) {
+        if (!isDbQueryEvent(data))
+            return;
+        safeRecord(buildQueryEntry(data), 'LucidQueryWatcher');
+    }
+}
+/** Map a Lucid `db:query` payload to a telescope {@link RecordInput}. */
+export function buildQueryEntry(event) {
+    const durationMs = hrtimeToMs(event.duration);
+    const method = typeof event.method === 'string' ? event.method : null;
+    const traceId = currentTraceId();
+    const content = {
+        sql: event.sql,
+        bindings: Array.isArray(event.bindings) ? event.bindings : [],
+        durationMs,
+        connection: event.connection,
+        method,
+        inTransaction: typeof event.inTransaction === 'boolean' ? event.inTransaction : null,
+        traceId,
+    };
+    return {
+        type: EntryType.Query,
+        familyHash: queryFamilyHash(event.sql),
+        content,
+        durationMs,
+        traceId,
+        tags: [
+            `connection:${event.connection}`,
+            ...(method ? [`method:${method}`] : []),
+            ...(event.model ? [`model:${event.model}`] : []),
+        ],
+    };
+}
+//# sourceMappingURL=lucid_query_watcher.js.map

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

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

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

@@ -0,0 +1,51 @@
+import { type RecordInput } from '../entry.js';
+import type { EmitterLike, Watcher } from './emitter.js';
+/** The `@adonisjs/mail` event name this watcher subscribes to. */
+export declare const MAIL_SENT_EVENT = "mail:sent";
+/**
+ * The structural slice of the `mail:sent` payload this watcher reads. The exact
+ * runtime shape is owned by `@adonisjs/mail` (not installed in this repo, so it
+ * could not be verified against its types — see this package's README). The
+ * watcher therefore reads every field defensively and degrades to `null`/`[]` for
+ * anything missing, rather than assuming a precise shape.
+ *
+ * `@adonisjs/mail` carries the composed message under `message` — typically a
+ * `Message` instance exposing `toJSON()`/`toObject()` whose `.message` holds the
+ * envelope (`to`/`from`/`subject`/…). Both the instance form and a plain-object
+ * form are handled.
+ */
+export interface MailSentEventLike {
+    mailerName?: string;
+    message?: unknown;
+}
+/** The recorded body of a `mail` entry. */
+export interface MailEntryContent {
+    /** The mailer that sent the message (e.g. `'smtp'`), or `null`. */
+    mailer: string | null;
+    /** The sender address, or `null`. */
+    from: string | null;
+    /** The recipient addresses (`to`), flattened to strings. */
+    to: string[];
+    /** The subject line, or `null`. */
+    subject: string | null;
+    /** The active trace id at send time, or `null`. */
+    traceId: string | null;
+}
+/**
+ * Records every email AdonisJS sends as a `mail` telescope entry. Subscribes to
+ * `@adonisjs/mail`'s `mail:sent` event and captures the mailer, sender, recipients
+ * and subject, correlated to the active request via the trace id.
+ *
+ * Recording is fire-and-forget and fully guarded — a telescope failure can never
+ * break a send.
+ */
+export declare class MailWatcher implements Watcher {
+    readonly type: "mail";
+    private unsubscribe;
+    start(emitter: EmitterLike): void;
+    stop(): void;
+    private handle;
+}
+/** Map a `mail:sent` payload to a telescope {@link RecordInput}. */
+export declare function buildMailEntry(event: MailSentEventLike): RecordInput<MailEntryContent>;
+//# sourceMappingURL=mail_watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mail_watcher.d.ts","sourceRoot":"","sources":["../../../src/watchers/mail_watcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGzD,kEAAkE;AAClE,eAAO,MAAM,eAAe,cAAc,CAAC;AAQ3C;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,2CAA2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,qCAAqC;IACrC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,4DAA4D;IAC5D,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mDAAmD;IACnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AA2CD;;;;;;;GAOG;AACH,qBAAa,WAAY,YAAW,OAAO;IACzC,QAAQ,CAAC,IAAI,SAAkB;IAC/B,OAAO,CAAC,WAAW,CAA6B;IAEhD,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKjC,IAAI,IAAI,IAAI;IAKZ,OAAO,CAAC,MAAM;CAIf;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAkBtF"}

package/dist/src/watchers/mail_watcher.js

@@ -0,0 +1,93 @@
+import { currentTraceId } from '../context_accessor.js';
+import { EntryType } from '../entry.js';
+import { safeRecord } from './record.js';
+/** The `@adonisjs/mail` event name this watcher subscribes to. */
+export const MAIL_SENT_EVENT = 'mail:sent';
+/** Normalize a mail address (string | `{address}`) to a plain address string. */
+function addressToString(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value && typeof value === 'object' && typeof value.address === 'string')
+        return value.address;
+    return null;
+}
+/** Normalize a `to` field (one address, or many) to a flat string[]. */
+function normalizeRecipients(to) {
+    const list = Array.isArray(to) ? to : to === undefined || to === null ? [] : [to];
+    const out = [];
+    for (const item of list) {
+        const address = addressToString(item);
+        if (address)
+            out.push(address);
+    }
+    return out;
+}
+/** Pull the message envelope object out of the (instance-or-plain) `message`. */
+function readEnvelope(message) {
+    if (message === null || typeof message !== 'object')
+        return null;
+    const candidate = message;
+    // `Message` instances expose `toJSON()` returning `{ message, views }`.
+    if (typeof candidate.toJSON === 'function') {
+        try {
+            const json = candidate.toJSON();
+            if (json && typeof json === 'object') {
+                const inner = json.message;
+                if (inner && typeof inner === 'object')
+                    return inner;
+            }
+        }
+        catch {
+            // fall through to the structural reads below
+        }
+    }
+    // Plain-object form: either the envelope itself, or `{ message: envelope }`.
+    if (candidate.message && typeof candidate.message === 'object') {
+        return candidate.message;
+    }
+    return candidate;
+}
+/**
+ * Records every email AdonisJS sends as a `mail` telescope entry. Subscribes to
+ * `@adonisjs/mail`'s `mail:sent` event and captures the mailer, sender, recipients
+ * and subject, correlated to the active request via the trace id.
+ *
+ * Recording is fire-and-forget and fully guarded — a telescope failure can never
+ * break a send.
+ */
+export class MailWatcher {
+    type = EntryType.Mail;
+    unsubscribe = null;
+    start(emitter) {
+        if (this.unsubscribe)
+            return;
+        this.unsubscribe = emitter.on(MAIL_SENT_EVENT, (data) => this.handle(data));
+    }
+    stop() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+    }
+    handle(data) {
+        if (typeof data !== 'object' || data === null)
+            return;
+        safeRecord(buildMailEntry(data), 'MailWatcher');
+    }
+}
+/** Map a `mail:sent` payload to a telescope {@link RecordInput}. */
+export function buildMailEntry(event) {
+    const mailer = typeof event.mailerName === 'string' ? event.mailerName : null;
+    const envelope = readEnvelope(event.message);
+    const from = envelope ? (addressToString(envelope.from) ?? null) : null;
+    const to = envelope ? normalizeRecipients(envelope.to) : [];
+    const subject = envelope && typeof envelope.subject === 'string' ? envelope.subject : null;
+    const traceId = currentTraceId();
+    const content = { mailer, from, to, subject, traceId };
+    return {
+        type: EntryType.Mail,
+        familyHash: mailer,
+        content,
+        traceId,
+        tags: [...(mailer ? [`mailer:${mailer}`] : [])],
+    };
+}
+//# sourceMappingURL=mail_watcher.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * Build a stable family for an OUTGOING HTTP call from a method + (possibly
+ * absolute) url. Keeps the host and normalizes the path's id-like segments
+ * (UUID / all-digits / long hex) to `:id`, so calls to the same external
+ * endpoint group together regardless of ids.
+ *
+ * Ported from `nestjs-telescope`'s `query/normalize-route.ts`.
+ *
+ * @example
+ *   normalizeHttpTarget('GET', 'https://api.stripe.com/v1/charges/ch_123?foo=1')
+ *   // => 'GET api.stripe.com/v1/charges/:id'
+ *
+ * Falls back to normalizing the raw url (query string stripped) when it can't be
+ * parsed as absolute (e.g. a relative target), so a family is always produced.
+ */
+export declare function normalizeHttpTarget(method: string, url: string): string;
+//# sourceMappingURL=normalize_http_target.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize_http_target.d.ts","sourceRoot":"","sources":["../../../src/watchers/normalize_http_target.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBvE"}

package/dist/src/watchers/normalize_http_target.js

@@ -0,0 +1,41 @@
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const ALL_DIGITS_PATTERN = /^\d+$/;
+const LONG_HEX_PATTERN = /^[0-9a-f]{16,}$/i;
+/** A path segment is an id when it is a UUID, all digits, or a long hex string. */
+function isIdSegment(segment) {
+    return (UUID_PATTERN.test(segment) || ALL_DIGITS_PATTERN.test(segment) || LONG_HEX_PATTERN.test(segment));
+}
+/**
+ * Build a stable family for an OUTGOING HTTP call from a method + (possibly
+ * absolute) url. Keeps the host and normalizes the path's id-like segments
+ * (UUID / all-digits / long hex) to `:id`, so calls to the same external
+ * endpoint group together regardless of ids.
+ *
+ * Ported from `nestjs-telescope`'s `query/normalize-route.ts`.
+ *
+ * @example
+ *   normalizeHttpTarget('GET', 'https://api.stripe.com/v1/charges/ch_123?foo=1')
+ *   // => 'GET api.stripe.com/v1/charges/:id'
+ *
+ * Falls back to normalizing the raw url (query string stripped) when it can't be
+ * parsed as absolute (e.g. a relative target), so a family is always produced.
+ */
+export function normalizeHttpTarget(method, url) {
+    let host = '';
+    let path = url;
+    try {
+        const parsed = new URL(url);
+        host = parsed.host;
+        path = parsed.pathname;
+    }
+    catch {
+        const queryStart = url.indexOf('?');
+        path = queryStart === -1 ? url : url.slice(0, queryStart);
+    }
+    const normalizedPath = path
+        .split('/')
+        .map((segment) => (isIdSegment(segment) ? ':id' : segment))
+        .join('/');
+    return `${method} ${host}${normalizedPath}`;
+}
+//# sourceMappingURL=normalize_http_target.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize_http_target.js","sourceRoot":"","sources":["../../../src/watchers/normalize_http_target.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,iEAAiE,CAAC;AACvF,MAAM,kBAAkB,GAAG,OAAO,CAAC;AACnC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAE5C,mFAAmF;AACnF,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,CACL,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CACjG,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,GAAW;IAC7D,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,IAAI,GAAG,GAAG,CAAC;IACf,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACnB,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,cAAc,GAAG,IAAI;SACxB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;SAC1D,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,GAAG,MAAM,IAAI,IAAI,GAAG,cAAc,EAAE,CAAC;AAC9C,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Grouping key for "the same SQL query" — same template, any bound values. Ported
+ * from `nestjs-telescope`'s query family-hash so a dashboard can roll up every
+ * execution of `select * from users where id = ?` regardless of the id.
+ */
+/** Grouping key for "the same query" — same template, any bound values. */
+export declare function queryFamilyHash(sql: string): string;
+//# sourceMappingURL=query_family_hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query_family_hash.d.ts","sourceRoot":"","sources":["../../../src/watchers/query_family_hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/src/watchers/query_family_hash.js

@@ -0,0 +1,31 @@
+/**
+ * Grouping key for "the same SQL query" — same template, any bound values. Ported
+ * from `nestjs-telescope`'s query family-hash so a dashboard can roll up every
+ * execution of `select * from users where id = ?` regardless of the id.
+ */
+/**
+ * Normalize an SQL string into a template: lowercase, collapse whitespace, and
+ * replace string/number literals with `?` so only the query shape remains.
+ */
+function normalizeSql(sql) {
+    return sql
+        .toLowerCase()
+        .replace(/'(?:[^']|'')*'/g, '?') // string literals
+        .replace(/\b\d+(?:\.\d+)?\b/g, '?') // numeric literals
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/** Stable 32-bit FNV-1a hash, hex-encoded. Deterministic across processes. */
+function fnv1a(input) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < input.length; i++) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+/** Grouping key for "the same query" — same template, any bound values. */
+export function queryFamilyHash(sql) {
+    return fnv1a(normalizeSql(sql));
+}
+//# sourceMappingURL=query_family_hash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query_family_hash.js","sourceRoot":"","sources":["../../../src/watchers/query_family_hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG;SACP,WAAW,EAAE;SACb,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,kBAAkB;SAClD,OAAO,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC,mBAAmB;SACtD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,8EAA8E;AAC9E,SAAS,KAAK,CAAC,KAAa;IAC1B,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACpD,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { RecordInput } from '../entry.js';
+import type { TelescopeStore } from '../store.js';
+/**
+ * Resolve the active telescope store WITHOUT dependency injection. `@adonis-agora/telescope`'s
+ * provider publishes the live store on a cross-copy-stable global slot at boot
+ * (see its `registry.ts`); the request middleware records through that same handle.
+ * Reusing it here lets these watchers record from inside synchronous emitter
+ * subscribers — where there is no container to `inject()` from — and degrade to a
+ * no-op when telescope is disabled or not booted.
+ */
+export declare function resolveStore(): TelescopeStore | null;
+/**
+ * Record one entry through the runtime store, swallowing every failure. Watchers
+ * run inside emitter subscribers on the host's hot paths, so this is strictly
+ * fire-and-forget: a missing store, a throwing `record`, or a rejected promise can
+ * never break (or block) the emit it is observing.
+ *
+ * The active `@adonis-agora/context` trace id is backfilled when the caller did not set
+ * `traceId` explicitly, mirroring how the core watchers correlate entries.
+ */
+export declare function safeRecord(input: RecordInput, source: string): void;
+//# sourceMappingURL=record.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../src/watchers/record.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,cAAc,GAAG,IAAI,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAmBnE"}