@adonis-agora/telescope 0.1.0

package/dist/src/alerts/new_exception_tracker.js

@@ -0,0 +1,74 @@
+/**
+ * Default cap on tracked error families. The map is the ONLY state the
+ * `new-exception` rule keeps, and it must stay bounded so a host that throws a
+ * long tail of unique error families (e.g. message-embedded ids that defeat the
+ * family hash) can never grow it without limit. At the cap we evict the OLDEST
+ * inserted family — the one least likely to still be "recently seen" — which is
+ * the correct bias for a recency-window dedup.
+ */
+const DEFAULT_MAX_FAMILIES = 10_000;
+/**
+ * Bounded, in-memory "have we seen this error family recently?" tracker backing
+ * the `new-exception` rule. Per-process by design: it lives in process memory, so
+ * in a multi-replica deployment the SAME family may be reported as new once per
+ * pod (documented caveat — acceptable for v1).
+ *
+ * Eviction uses a `Map`'s insertion-order iteration: the first key is the oldest
+ * INSERTED entry. The window check already discards stale last-seen times, so
+ * insertion-order eviction is a sound, O(1) cap with no per-touch bookkeeping.
+ *
+ * Ported verbatim from the aviary telescope core.
+ */
+export class NewExceptionTracker {
+    seen = new Map();
+    maxFamilies;
+    constructor(maxFamilies = DEFAULT_MAX_FAMILIES) {
+        this.maxFamilies = maxFamilies;
+    }
+    /**
+     * Record an observation of `familyHash` at `nowMs` and report whether this is a
+     * NEW family for the `windowMs` window — i.e. it was either never seen or last
+     * seen longer ago than the window (the "re-occurring after being resolved"
+     * signal). Always updates the stored last-seen time so repeat occurrences
+     * refresh the window. Returns `true` only on a genuine first/expired occurrence
+     * (the signal that should fire the alert).
+     */
+    observe(familyHash, nowMs, windowMs) {
+        const lastSeen = this.seen.get(familyHash);
+        const isNew = lastSeen === undefined || nowMs - lastSeen >= windowMs;
+        // Delete-then-set so a refreshed family moves to the END of insertion order,
+        // keeping genuinely-oldest families at the front for eviction.
+        this.seen.delete(familyHash);
+        this.seen.set(familyHash, nowMs);
+        this.evictIfNeeded();
+        return isNew;
+    }
+    /**
+     * Forget `familyHash` entirely, so its NEXT occurrence is reported as new again.
+     * This is the explicit "resolve" hook: after an operator marks a family resolved
+     * (or a self-heal job clears it), the very next occurrence pages again without
+     * waiting for the window to elapse.
+     */
+    resolve(familyHash) {
+        this.seen.delete(familyHash);
+    }
+    /** Forget every tracked family. */
+    clear() {
+        this.seen.clear();
+    }
+    /** Number of tracked families (test/observability seam). */
+    get size() {
+        return this.seen.size;
+    }
+    /** Evict the oldest entries until the map is within its cap. */
+    evictIfNeeded() {
+        while (this.seen.size > this.maxFamilies) {
+            const oldest = this.seen.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.seen.delete(oldest);
+        }
+    }
+}
+export { DEFAULT_MAX_FAMILIES };
+//# sourceMappingURL=new_exception_tracker.js.map

package/dist/src/alerts/new_exception_tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new_exception_tracker.js","sourceRoot":"","sources":["../../../src/alerts/new_exception_tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAEpC;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,mBAAmB;IACb,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjC,WAAW,CAAS;IAErC,YAAY,cAAsB,oBAAoB;QACpD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,UAAkB,EAAE,KAAa,EAAE,QAAgB;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,QAAQ,KAAK,SAAS,IAAI,KAAK,GAAG,QAAQ,IAAI,QAAQ,CAAC;QACrE,6EAA6E;QAC7E,+DAA+D;QAC/D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,UAAkB;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAED,mCAAmC;IACnC,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,4DAA4D;IAC5D,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,gEAAgE;IACxD,aAAa;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC7C,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM;YAChC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/src/alerts/parse_duration.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Convert a duration (a raw ms number, or a `<int><ms|s|m|h|d>` string such as
+ * `'15m'`) to milliseconds. Throws on an unparseable string so a typo in config
+ * surfaces at boot rather than silently never firing.
+ *
+ * Ported verbatim from the aviary telescope core's `durationToMs` — this package
+ * keeps its own copy so it never depends on a core internal that isn't exported.
+ */
+export declare function durationToMs(duration: number | string): number;
+//# sourceMappingURL=parse_duration.d.ts.map

package/dist/src/alerts/parse_duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse_duration.d.ts","sourceRoot":"","sources":["../../../src/alerts/parse_duration.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAU9D"}

package/dist/src/alerts/parse_duration.js

@@ -0,0 +1,27 @@
+const DURATION_UNITS = {
+    ms: 1,
+    s: 1_000,
+    m: 60_000,
+    h: 3_600_000,
+    d: 86_400_000,
+};
+/**
+ * Convert a duration (a raw ms number, or a `<int><ms|s|m|h|d>` string such as
+ * `'15m'`) to milliseconds. Throws on an unparseable string so a typo in config
+ * surfaces at boot rather than silently never firing.
+ *
+ * Ported verbatim from the aviary telescope core's `durationToMs` — this package
+ * keeps its own copy so it never depends on a core internal that isn't exported.
+ */
+export function durationToMs(duration) {
+    if (typeof duration === 'number') {
+        return duration;
+    }
+    const match = /^(\d+)(ms|s|m|h|d)$/.exec(duration.trim());
+    if (match === null) {
+        throw new Error(`Invalid duration: ${duration}`);
+    }
+    const unit = match[2];
+    return Number(match[1]) * DURATION_UNITS[unit];
+}
+//# sourceMappingURL=parse_duration.js.map

package/dist/src/alerts/parse_duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse_duration.js","sourceRoot":"","sources":["../../../src/alerts/parse_duration.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG;IACrB,EAAE,EAAE,CAAC;IACL,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,UAAU;CACL,CAAC;AAIX;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,QAAyB;IACpD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAiB,CAAC;IACtC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/src/alerts/slack_format.d.ts

@@ -0,0 +1,60 @@
+import type { AlertPayload } from './alert_rule.js';
+/**
+ * Optional Slack presentation overrides. Most hosts set none of these — the
+ * incoming webhook's own default name/icon is used. Provided for hosts that route
+ * several Telescope instances into one channel and want them visually distinct.
+ */
+export interface SlackChannelOptions {
+    /** Override the bot username shown on the message. */
+    username?: string;
+    /** Override the message icon (a Slack emoji shortcode, e.g. `:rotating_light:`). */
+    iconEmoji?: string;
+}
+interface SlackTextObject {
+    type: 'plain_text' | 'mrkdwn';
+    text: string;
+    emoji?: boolean;
+}
+interface SlackHeaderBlock {
+    type: 'header';
+    text: SlackTextObject;
+}
+interface SlackSectionBlock {
+    type: 'section';
+    text?: SlackTextObject;
+    fields?: SlackTextObject[];
+}
+interface SlackButtonElement {
+    type: 'button';
+    text: SlackTextObject;
+    url: string;
+}
+interface SlackActionsBlock {
+    type: 'actions';
+    elements: SlackButtonElement[];
+}
+type SlackBlock = SlackHeaderBlock | SlackSectionBlock | SlackActionsBlock;
+/** The full webhook body Slack expects: a fallback `text` plus the rich `blocks`. */
+export interface SlackMessage {
+    /** Fallback/notification text shown where blocks can't render. */
+    text: string;
+    blocks: SlackBlock[];
+    username?: string;
+    icon_emoji?: string;
+}
+/**
+ * Render an {@link AlertPayload} into a Slack Block Kit message. Structure:
+ *  - a `header` with the severity emoji + rule label;
+ *  - a `section` whose fields carry the instance/rule context (and — for
+ *    `new-exception` — route/method/status/user and the occurrence count);
+ *  - a `section` with a fenced code block of the truncated stack (only when an
+ *    exception stack is present);
+ *  - an `actions` block with a single "Open in Telescope" button (only when a
+ *    `dashboardUrl` + entry id are available to build the deep link).
+ *
+ * Everything degrades gracefully: a rate rule (no `exception` context) simply
+ * renders the header + context fields and skips the stack/button.
+ */
+export declare function formatSlackMessage(payload: AlertPayload, options?: SlackChannelOptions): SlackMessage;
+export {};
+//# sourceMappingURL=slack_format.d.ts.map

package/dist/src/alerts/slack_format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack_format.d.ts","sourceRoot":"","sources":["../../../src/alerts/slack_format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD,UAAU,eAAe;IACvB,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AACD,UAAU,gBAAgB;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,eAAe,CAAC;CACvB;AACD,UAAU,iBAAiB;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AACD,UAAU,kBAAkB;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,eAAe,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AACD,UAAU,iBAAiB;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AACD,KAAK,UAAU,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAE3E,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAkDD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY,CAyDd"}

package/dist/src/alerts/slack_format.js

@@ -0,0 +1,122 @@
+/**
+ * Slack hard limits we format within. A `text` field in a section is capped at
+ * 3000 chars; we keep the stack snippet WELL under that and additionally cap by
+ * frame count so the message stays scannable rather than a wall of frames.
+ */
+const STACK_CHAR_LIMIT = 2_800;
+const STACK_FRAME_LIMIT = 10;
+/**
+ * Severity → leading emoji, derived from the rule kind: a brand-new error family
+ * or an exception spike is the loudest signal an operator can get.
+ */
+function severityEmoji(rule) {
+    if (rule.type === 'new-exception' || rule.type === 'exception-rate')
+        return ':rotating_light:';
+    return ':warning:';
+}
+/** Short, human rule label for the header. */
+function ruleLabel(rule) {
+    switch (rule.type) {
+        case 'new-exception':
+            return 'New exception family';
+        case 'exception-rate':
+            return 'Exception rate';
+    }
+}
+/** A Slack `mrkdwn` field pairing a bold label with a value. */
+function field(label, value) {
+    return { type: 'mrkdwn', text: `*${label}:*\n${value}` };
+}
+/**
+ * Clip a raw stack to Slack's budget: keep at most {@link STACK_FRAME_LIMIT}
+ * lines, then hard-cap the joined string at {@link STACK_CHAR_LIMIT} chars.
+ * Returns `null` for an absent stack so the caller can omit the block entirely.
+ */
+function clipStack(stack) {
+    if (stack === null || stack.trim() === '')
+        return null;
+    const frames = stack.split('\n').slice(0, STACK_FRAME_LIMIT).join('\n');
+    if (frames.length <= STACK_CHAR_LIMIT)
+        return frames;
+    return `${frames.slice(0, STACK_CHAR_LIMIT)}…`;
+}
+/**
+ * Build the deep link to the offending exception entry in the host's external
+ * dashboard. Returns `null` when no `dashboardUrl` is configured or there is no
+ * entry id to link to (rate rules carry no single id).
+ */
+function dashboardLink(payload) {
+    const { dashboardUrl, exception } = payload;
+    if (dashboardUrl === undefined || exception === undefined)
+        return null;
+    const base = dashboardUrl.replace(/\/+$/, '');
+    return `${base}#/entries/view/${exception.entryId}`;
+}
+/**
+ * Render an {@link AlertPayload} into a Slack Block Kit message. Structure:
+ *  - a `header` with the severity emoji + rule label;
+ *  - a `section` whose fields carry the instance/rule context (and — for
+ *    `new-exception` — route/method/status/user and the occurrence count);
+ *  - a `section` with a fenced code block of the truncated stack (only when an
+ *    exception stack is present);
+ *  - an `actions` block with a single "Open in Telescope" button (only when a
+ *    `dashboardUrl` + entry id are available to build the deep link).
+ *
+ * Everything degrades gracefully: a rate rule (no `exception` context) simply
+ * renders the header + context fields and skips the stack/button.
+ */
+export function formatSlackMessage(payload, options) {
+    const emoji = severityEmoji(payload.rule);
+    const label = ruleLabel(payload.rule);
+    const headerText = `${emoji} ${label}`;
+    const contextFields = [
+        field('Instance', payload.instanceId),
+        field('Observed', `${payload.value} (threshold ${payload.threshold})`),
+    ];
+    const exception = payload.exception;
+    if (exception !== undefined) {
+        contextFields.push(field('Error', `${exception.class}: ${exception.message}`));
+        if (exception.route !== null) {
+            const method = exception.method ?? '';
+            const status = exception.statusCode === null ? '' : ` → ${exception.statusCode}`;
+            contextFields.push(field('Route', `${method} ${exception.route}${status}`.trim()));
+        }
+        if (exception.user !== null) {
+            contextFields.push(field('User', exception.user));
+        }
+        contextFields.push(field('Occurrences', `${exception.occurrences} in window`));
+    }
+    else {
+        const window = 'window' in payload.rule ? payload.rule.window : null;
+        if (window !== null)
+            contextFields.push(field('Window', window));
+    }
+    const blocks = [
+        { type: 'header', text: { type: 'plain_text', text: headerText, emoji: true } },
+        { type: 'section', fields: contextFields },
+    ];
+    const stack = exception ? clipStack(exception.stack) : null;
+    if (stack !== null) {
+        blocks.push({ type: 'section', text: { type: 'mrkdwn', text: `\`\`\`${stack}\`\`\`` } });
+    }
+    const link = dashboardLink(payload);
+    if (link !== null) {
+        blocks.push({
+            type: 'actions',
+            elements: [
+                {
+                    type: 'button',
+                    text: { type: 'plain_text', text: 'Open in Telescope', emoji: true },
+                    url: link,
+                },
+            ],
+        });
+    }
+    return {
+        text: headerText,
+        blocks,
+        ...(options?.username !== undefined ? { username: options.username } : {}),
+        ...(options?.iconEmoji !== undefined ? { icon_emoji: options.iconEmoji } : {}),
+    };
+}
+//# sourceMappingURL=slack_format.js.map

package/dist/src/alerts/slack_format.js.map

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

package/dist/src/context_accessor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Structural reader for `@adonis-agora/context` — WITHOUT importing it.
+ *
+ * `@adonis-agora/context` publishes a read-only accessor on the cross-copy-stable global
+ * slot `Symbol.for('@agora/context:accessor')` at import time. Telescope is a
+ * separate repo and cannot depend on `@adonis-agora/context`, so it reads that slot
+ * structurally and degrades to `undefined` when the package is absent. This keeps
+ * request correlation (the active trace id) working when both packages are
+ * installed, with zero coupling when only one is.
+ */
+/** A user reference carried in the context (shape mirrored, not imported). */
+export interface UserRef {
+    id: string | number;
+    [key: string]: unknown;
+}
+/**
+ * The narrow read-only view `@adonis-agora/context` publishes. Mirrors its
+ * `ContextAccessor` structurally — consumers read, they never drive the lifecycle.
+ */
+export interface ContextAccessor {
+    traceId(): string | undefined;
+    tenantId(): string | undefined;
+    userRef(): UserRef | undefined;
+    get(): Record<string, unknown> | undefined;
+}
+/** The accessor `@adonis-agora/context` published, or `undefined` when it is not loaded. */
+export declare function getContextAccessor(): ContextAccessor | undefined;
+/** The active trace id from `@adonis-agora/context`, or `null` when unavailable. */
+export declare function currentTraceId(): string | null;
+//# sourceMappingURL=context_accessor.d.ts.map

package/dist/src/context_accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context_accessor.d.ts","sourceRoot":"","sources":["../../src/context_accessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,IAAI,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,IAAI,OAAO,GAAG,SAAS,CAAC;IAC/B,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC5C;AAID,4FAA4F;AAC5F,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,SAAS,CAEhE;AAED,oFAAoF;AACpF,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAE9C"}

package/dist/src/context_accessor.js

@@ -0,0 +1,20 @@
+/**
+ * Structural reader for `@adonis-agora/context` — WITHOUT importing it.
+ *
+ * `@adonis-agora/context` publishes a read-only accessor on the cross-copy-stable global
+ * slot `Symbol.for('@agora/context:accessor')` at import time. Telescope is a
+ * separate repo and cannot depend on `@adonis-agora/context`, so it reads that slot
+ * structurally and degrades to `undefined` when the package is absent. This keeps
+ * request correlation (the active trace id) working when both packages are
+ * installed, with zero coupling when only one is.
+ */
+const CONTEXT_ACCESSOR = Symbol.for('@agora/context:accessor');
+/** The accessor `@adonis-agora/context` published, or `undefined` when it is not loaded. */
+export function getContextAccessor() {
+    return globalThis[CONTEXT_ACCESSOR];
+}
+/** The active trace id from `@adonis-agora/context`, or `null` when unavailable. */
+export function currentTraceId() {
+    return getContextAccessor()?.traceId() ?? null;
+}
+//# sourceMappingURL=context_accessor.js.map

package/dist/src/context_accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context_accessor.js","sourceRoot":"","sources":["../../src/context_accessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAE/D,4FAA4F;AAC5F,MAAM,UAAU,kBAAkB;IAChC,OAAQ,UAAsC,CAAC,gBAAgB,CAAgC,CAAC;AAClG,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,cAAc;IAC5B,OAAO,kBAAkB,EAAE,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC;AACjD,CAAC"}

package/dist/src/define_config.d.ts

@@ -0,0 +1,109 @@
+import type { TelescopeExtension } from './extension/types.js';
+import type { TelescopeStore } from './store.js';
+import { type StoreProvider, storage } from './stores/factory.js';
+/**
+ * Sensitive-data redaction applied to EVERY entry's content before it is
+ * persisted. Defaults are on; supply `keys` to extend the masked set or
+ * `enabled: false` to opt out entirely.
+ */
+export interface RedactConfig {
+    /**
+     * Master switch for redaction. When `false`, content is persisted verbatim.
+     * Default `true`.
+     */
+    enabled?: boolean;
+    /**
+     * Extra sensitive key names to mask, merged with the built-in defaults
+     * (`authorization`, `cookie`, `password`, `token`, `api_key`, `secret`, …).
+     * Matched case-insensitively at any depth.
+     */
+    keys?: string[];
+}
+/** The set of watchers this headless slice ships. */
+export type WatcherName = 'request' | 'diagnostics';
+/**
+ * The shape of `config/telescope.ts`. Everything is optional with sane defaults:
+ * the in-memory store, both shipped watchers enabled, a 1000-entry cap.
+ */
+export interface TelescopeConfig {
+    /**
+     * Master switch. When `false`, the provider records nothing and both watchers
+     * stay dormant (zero overhead). Default `true`.
+     */
+    enabled?: boolean;
+    /**
+     * Which store backs telescope. Three forms are accepted:
+     *
+     * - a **key of {@link stores}** (the idiomatic form) — e.g. `'memory'` or `'lucid'`,
+     *   selecting one of the drivers built with the {@link storage} factory;
+     * - the literal `'memory'` — the built-in ring buffer, even with no `stores` map;
+     * - a {@link TelescopeStore} instance — for a custom backend wired by hand.
+     *
+     * Default `'memory'`.
+     */
+    store?: string | TelescopeStore;
+    /**
+     * Named store drivers, built with the {@link storage} factory. The active one is
+     * selected by {@link store}. Each factory returns a lazy thunk; its peer dependency
+     * (`@adonisjs/lucid` for `lucid`) is only imported when that driver is the active one.
+     */
+    stores?: Record<string, StoreProvider>;
+    /**
+     * Hard cap on retained entries for the in-memory store when selected by the bare
+     * `store: 'memory'` shorthand (no `stores` map). Oldest entries are evicted past
+     * this. Default 1000. Prefer `storage.memory({ limit })` in the `stores` map.
+     */
+    maxEntries?: number;
+    /**
+     * Which watchers are active. Omit a name to disable it. Defaults to both
+     * (`request` + `diagnostics`).
+     */
+    watchers?: WatcherName[];
+    /**
+     * Extensions contributed by sibling libs (e.g. `@adonis-agora/durable-telescope`) — each adds navigable
+     * entry types, dashboard pages, and the data providers those pages bind to. Default none.
+     */
+    extensions?: TelescopeExtension[];
+    /**
+     * Sensitive-data redaction applied to every entry's content before persistence.
+     * Enabled by default with a built-in set of sensitive keys. Set
+     * `redact: { enabled: false }` to opt out, or `redact: { keys: [...] }` to mask
+     * additional keys.
+     */
+    redact?: RedactConfig;
+}
+/** The fully-resolved config the provider acts on (no optionals). */
+export interface ResolvedTelescopeConfig {
+    enabled: boolean;
+    store: string | TelescopeStore;
+    stores: Record<string, StoreProvider>;
+    maxEntries: number;
+    watchers: Set<WatcherName>;
+    extensions: TelescopeExtension[];
+    redact: {
+        enabled: boolean;
+        keys: string[];
+    };
+}
+/**
+ * Identity helper giving `config/telescope.ts` full type-checking. Mirrors the
+ * AdonisJS `defineConfig` convention.
+ *
+ * ```ts
+ * import { defineConfig, storage } from '@adonis-agora/telescope'
+ *
+ * export default defineConfig({
+ *   store: 'memory',
+ *   stores: {
+ *     memory: storage.memory({ limit: 1000 }),
+ *     lucid: storage.lucid({ connection: 'pg' }),
+ *   },
+ * })
+ * ```
+ */
+export declare function defineConfig(config: TelescopeConfig): TelescopeConfig;
+/** Apply defaults to a (possibly partial) config. */
+export declare function resolveConfig(config?: TelescopeConfig): ResolvedTelescopeConfig;
+export { storage };
+export type { LucidStoreConfig, MemoryStoreConfig, StoreContext, StoreProvider, } from './stores/factory.js';
+//# sourceMappingURL=define_config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define_config.d.ts","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,KAAK,aAAa,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAEhC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAEvC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAEzB;;;OAGG;IACH,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAElC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,qEAAqE;AACrE,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3B,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAErE;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,MAAM,GAAE,eAAoB,GAAG,uBAAuB,CAcnF;AAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACnB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,GACd,MAAM,qBAAqB,CAAC"}

package/dist/src/define_config.js

@@ -0,0 +1,38 @@
+import { storage } from './stores/factory.js';
+/**
+ * Identity helper giving `config/telescope.ts` full type-checking. Mirrors the
+ * AdonisJS `defineConfig` convention.
+ *
+ * ```ts
+ * import { defineConfig, storage } from '@adonis-agora/telescope'
+ *
+ * export default defineConfig({
+ *   store: 'memory',
+ *   stores: {
+ *     memory: storage.memory({ limit: 1000 }),
+ *     lucid: storage.lucid({ connection: 'pg' }),
+ *   },
+ * })
+ * ```
+ */
+export function defineConfig(config) {
+    return config;
+}
+/** Apply defaults to a (possibly partial) config. */
+export function resolveConfig(config = {}) {
+    const watchers = config.watchers ?? ['request', 'diagnostics'];
+    return {
+        enabled: config.enabled ?? true,
+        store: config.store ?? 'memory',
+        stores: config.stores ?? {},
+        maxEntries: config.maxEntries ?? 1000,
+        watchers: new Set(watchers),
+        extensions: config.extensions ?? [],
+        redact: {
+            enabled: config.redact?.enabled ?? true,
+            keys: config.redact?.keys ?? [],
+        },
+    };
+}
+export { storage };
+//# sourceMappingURL=define_config.js.map

package/dist/src/define_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define_config.js","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,OAAO,EAAE,MAAM,qBAAqB,CAAC;AA6FlE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY,CAAC,MAAuB;IAClD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,aAAa,CAAC,SAA0B,EAAE;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAC/D,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,QAAQ;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;QACrC,QAAQ,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE;QACnC,MAAM,EAAE;YACN,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,IAAI,IAAI;YACvC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE;SAChC;KACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/src/diagnostics_registry.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Structural reader for the `@adonis-agora/diagnostics` channel registry — WITHOUT
+ * importing it.
+ *
+ * `@adonis-agora/diagnostics` publishes its registry on the cross-copy-stable global slot
+ * `Symbol.for('@agora/diagnostics:registry')`: `{ channels: Set<string>,
+ * listeners: Set<(name: string) => void> }`. Telescope is a separate repo and
+ * cannot depend on `@adonis-agora/diagnostics`, so the {@link DiagnosticsWatcher} reads
+ * this slot structurally to learn the current `agora:<lib>:<event>` channel names
+ * and to be notified of future ones, then subscribes to each via the Node builtin
+ * `node:diagnostics_channel` (which needs no import of the Agora package).
+ */
+/** The registry shape `@adonis-agora/diagnostics` publishes on the global slot. */
+export interface DiagnosticsRegistry {
+    /** Every channel name registered so far. */
+    channels: Set<string>;
+    /** Listeners notified once per newly-registered channel name. */
+    listeners: Set<(name: string) => void>;
+}
+/**
+ * The registry `@adonis-agora/diagnostics` published, or `undefined` when the package is
+ * not loaded. Returned WITHOUT creating a slot — telescope only ever reads.
+ */
+export declare function getDiagnosticsRegistry(): DiagnosticsRegistry | undefined;
+/**
+ * The envelope `@adonis-agora/diagnostics` publishes on each channel. Defined LOCALLY
+ * (mirrors `DiagnosticEvent`) so telescope validates it structurally without an
+ * import. `v` may be absent on legacy envelopes; `traceId` may be absent.
+ */
+export interface DiagnosticEvent<TPayload = unknown> {
+    /** Envelope schema version, or absent on a legacy (pre-versioning) envelope. */
+    v?: number;
+    /** Epoch millis the producer stamped the event with. */
+    ts: number;
+    /** The emitting library, e.g. `'billing'`. */
+    lib: string;
+    /** The event within that library, e.g. `'invoice-paid'`. */
+    event: string;
+    /** The trace id the producer resolved, or absent when none. */
+    traceId?: string;
+    /** The library-defined payload. */
+    payload: TPayload;
+}
+/** Strict structural validation of a diagnostics envelope. */
+export declare function isDiagnosticEvent(msg: unknown): msg is DiagnosticEvent;
+//# sourceMappingURL=diagnostics_registry.d.ts.map

package/dist/src/diagnostics_registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics_registry.d.ts","sourceRoot":"","sources":["../../src/diagnostics_registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,iEAAiE;IACjE,SAAS,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC;CACxC;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,SAAS,CAExE;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO;IACjD,gFAAgF;IAChF,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,eAAe,CAYtE"}

package/dist/src/diagnostics_registry.js

@@ -0,0 +1,34 @@
+/**
+ * Structural reader for the `@adonis-agora/diagnostics` channel registry — WITHOUT
+ * importing it.
+ *
+ * `@adonis-agora/diagnostics` publishes its registry on the cross-copy-stable global slot
+ * `Symbol.for('@agora/diagnostics:registry')`: `{ channels: Set<string>,
+ * listeners: Set<(name: string) => void> }`. Telescope is a separate repo and
+ * cannot depend on `@adonis-agora/diagnostics`, so the {@link DiagnosticsWatcher} reads
+ * this slot structurally to learn the current `agora:<lib>:<event>` channel names
+ * and to be notified of future ones, then subscribes to each via the Node builtin
+ * `node:diagnostics_channel` (which needs no import of the Agora package).
+ */
+const REGISTRY_KEY = Symbol.for('@agora/diagnostics:registry');
+/**
+ * The registry `@adonis-agora/diagnostics` published, or `undefined` when the package is
+ * not loaded. Returned WITHOUT creating a slot — telescope only ever reads.
+ */
+export function getDiagnosticsRegistry() {
+    return globalThis[REGISTRY_KEY];
+}
+/** Strict structural validation of a diagnostics envelope. */
+export function isDiagnosticEvent(msg) {
+    if (typeof msg !== 'object' || msg === null)
+        return false;
+    const m = msg;
+    return (typeof m.ts === 'number' &&
+        typeof m.lib === 'string' &&
+        typeof m.event === 'string' &&
+        'payload' in m &&
+        (m.traceId === undefined || typeof m.traceId === 'string') &&
+        // Tolerate legacy envelopes without `v`; reject a malformed (non-number) one.
+        (m.v === undefined || typeof m.v === 'number'));
+}
+//# sourceMappingURL=diagnostics_registry.js.map

package/dist/src/diagnostics_registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics_registry.js","sourceRoot":"","sources":["../../src/diagnostics_registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAQ,UAAsC,CAAC,YAAY,CAAoC,CAAC;AAClG,CAAC;AAsBD,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,OAAO,CACL,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;QACzB,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAC3B,SAAS,IAAI,CAAC;QACd,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC;QAC1D,8EAA8E;QAC9E,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAC/C,CAAC;AACJ,CAAC"}