@adonis-agora/telescope 0.1.0

package/dist/src/extension/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/extension/registry.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,MAAM,OAAO,iBAAiB;IACnB,WAAW,GAAyB,EAAE,CAAC;IACvC,WAAW,GAAoB,EAAE,CAAC;IAClC,UAAU,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC7C,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD,YAAY,UAAyC,EAAE,GAAqB;QAC1E,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE7C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACpC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,MAAM,IAAI,KAAK,CACb,yBAAyB,EAAE,CAAC,EAAE,6BAA6B,IAAI,UAAU,GAAG,CAAC,IAAI,mCAAmC,CACrH,CAAC;gBACJ,CAAC;gBACD,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;gBACjC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;YAED,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAClC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,MAAM,IAAI,KAAK,CACb,wBAAwB,CAAC,CAAC,EAAE,6BAA6B,IAAI,UAAU,GAAG,CAAC,IAAI,kCAAkC,CAClH,CAAC;gBACJ,CAAC;gBACD,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC/B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;YAED,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,MAAM,IAAI,KAAK,CACb,4BAA4B,CAAC,CAAC,IAAI,6BAA6B,IAAI,UAAU,GAAG,CAAC,IAAI,mCAAmC,CACzH,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IACD,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IACD,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/src/extension/types.d.ts

@@ -0,0 +1,158 @@
+import type { ResolvedTelescopeConfig } from '../define_config.js';
+import type { TelescopeStore } from '../store.js';
+/**
+ * The published, versioned extension contract for `@adonis-agora/telescope`.
+ *
+ * An extension is a plain object (usually returned by a factory so it can take options), registered
+ * via `config/telescope.ts`'s `extensions: [...]`. The provider runs its hooks once at boot. Hooks
+ * are **multi** (every extension runs; results accumulate). A sibling lib (e.g. `@adonis-agora/durable`)
+ * contributes navigable entry types, declarative dashboard pages, and the server-side data providers
+ * those pages bind to — without `@adonis-agora/telescope` knowing anything about it.
+ *
+ * @remarks Semver 0.x — the shape may change until 1.0.
+ */
+export interface TelescopeExtension {
+    /** Unique id — used in collision errors and for deterministic ordering. */
+    name: string;
+    /** Contribute navigable entry types — makes the UI's entry-type nav dynamic. */
+    entryTypes?(ctx: ExtensionContext): ExtensionEntryType[];
+    /** Contribute declarative dashboard pages (the panel IR). */
+    dashboards?(ctx: ExtensionContext): DashboardSpec[];
+    /** Named server-side queries that panels bind to via `{ provider, query }`. */
+    dataProviders?(ctx: ExtensionContext): DataProvider[];
+}
+/** The slice of the AdonisJS container an extension needs to resolve host services. */
+export interface ContainerLike {
+    make<T>(token: unknown): Promise<T>;
+}
+/**
+ * Read-only context handed to every extension hook at boot. Replaces NestJS's `ModuleRef`: the
+ * telescope `store` is passed directly (for reading recorded entries), and `container` resolves host
+ * services — e.g. a durable provider does `await ctx.container.make(WorkflowEngine)`.
+ */
+export interface ExtensionContext {
+    /** The telescope store — read recorded entries for aggregation. */
+    readonly store: TelescopeStore;
+    /** Resolve host services (e.g. a durable `WorkflowEngine`) from the app container. */
+    readonly container: ContainerLike;
+    /** The resolved telescope config. */
+    readonly config: ResolvedTelescopeConfig;
+}
+/** A navigable entry type contributed by an extension (subset of the UI's entry-type nav). */
+export interface ExtensionEntryType {
+    /** Backend `type`/`tag` filter value, e.g. 'durable'. */
+    id: string;
+    /** Nav label, e.g. 'Workflows'. */
+    label: string;
+    /** Tailwind `bg-*` dot color for the nav, e.g. 'bg-amber-400'. */
+    dot: string;
+}
+/** Threshold coloring for a numeric panel. `direction` says which way is worse. */
+export interface PanelThresholds {
+    warn: number;
+    bad: number;
+    direction: 'up-bad' | 'down-bad';
+}
+/** A group of panels rendered together with its own column count. */
+export interface DashboardSection {
+    title?: string;
+    cols?: 2 | 3 | 4;
+    panels: Panel[];
+}
+/** A declarative dashboard page. */
+export interface DashboardSpec {
+    /** Stable route id, e.g. 'durable.workflows'. Globally unique across extensions. */
+    id: string;
+    /** Nav label, e.g. 'Workflows'. */
+    label: string;
+    /** Optional nav grouping header. */
+    navGroup?: string;
+    /** Flat layout. Prefer `sections` for hierarchy. */
+    panels: Panel[];
+    /** Sectioned layout. When present, the UI renders these instead of `panels`. */
+    sections?: DashboardSection[];
+}
+/** A bind from a panel to a named server-side provider + an opaque query object. */
+export interface DataBinding {
+    /** Provider name, e.g. 'durable.timeseries'. Resolved on the server. */
+    provider: string;
+    /** Opaque query passed through to the provider's `resolve`. */
+    query?: Record<string, unknown>;
+}
+/** A deep-link out of a table cell (to the durable dashboard, a telescope trace, etc.). */
+export interface LinkSpec {
+    /** A URL template with `{key}` placeholders filled from the row, e.g. '/durable/runs/{runId}'. */
+    href: string;
+    /** When true, open in a new tab. */
+    external?: boolean;
+}
+export interface Column {
+    key: string;
+    label: string;
+    link?: LinkSpec;
+}
+export type Panel = {
+    kind: 'stat';
+    title: string;
+    data: DataBinding;
+    format?: 'number' | 'percent' | 'duration' | 'rate';
+    accent?: string;
+    /** When true, the provider also returns `spark: number[]` and the card draws a sparkline. */
+    spark?: boolean;
+    thresholds?: PanelThresholds;
+} | {
+    kind: 'timeseries';
+    title: string;
+    data: DataBinding;
+    series: string[];
+    style?: 'area' | 'stacked';
+} | {
+    kind: 'topN';
+    title: string;
+    data: DataBinding;
+    limit?: number;
+} | {
+    kind: 'table';
+    title: string;
+    data: DataBinding;
+    columns: Column[];
+} | {
+    kind: 'distribution';
+    title: string;
+    data: DataBinding;
+    markers?: Array<'p50' | 'p95' | 'p99'>;
+    format?: 'duration' | 'number';
+} | {
+    kind: 'gauge';
+    title: string;
+    data: DataBinding;
+    min?: number;
+    max?: number;
+    format?: 'number' | 'percent' | 'duration' | 'rate';
+    thresholds?: PanelThresholds;
+} | {
+    kind: 'breakdown';
+    title: string;
+    data: DataBinding;
+    style?: 'donut' | 'bar';
+};
+/** A named server-side query a panel binds to. */
+export interface DataProvider {
+    /** Stable name referenced by a panel's `DataBinding.provider`, e.g. 'durable.timeseries'. */
+    name: string;
+    /**
+     * Resolve a panel's data. `query` is the panel's `DataBinding.query` merged with the request query
+     * string. Return value shape is per panel kind:
+     *  - stat         → `{ value: number; delta?: number; deltaLabel?: string; spark?: number[] }`
+     *  - timeseries   → `{ rows: Array<{ label: string } & Record<string, number>> }`
+     *  - topN         → `{ items: Array<{ label: string; value: number; id?: string }> }`
+     *  - table        → `{ rows: Array<Record<string, unknown>> }`
+     *  - distribution → `{ buckets: Array<{ label: string; count: number }>; p50?: number; p95?: number; p99?: number }`
+     *  - gauge        → `{ value: number; min?: number; max?: number }`
+     *  - breakdown    → `{ segments: Array<{ label: string; value: number; color?: string }> }`
+     */
+    resolve(query: Record<string, unknown> | undefined, ctx: ExtensionContext): Promise<unknown>;
+}
+/** Identity helper for authoring extensions with full type inference. */
+export declare function defineTelescopeExtension(ext: TelescopeExtension): TelescopeExtension;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/extension/types.d.ts.map

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

package/dist/src/extension/types.js

@@ -0,0 +1,5 @@
+/** Identity helper for authoring extensions with full type inference. */
+export function defineTelescopeExtension(ext) {
+    return ext;
+}
+//# sourceMappingURL=types.js.map

package/dist/src/extension/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extension/types.ts"],"names":[],"mappings":"AAgKA,yEAAyE;AACzE,MAAM,UAAU,wBAAwB,CAAC,GAAuB;IAC9D,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,36 @@
+/** Keep in sync with this package's `version` in package.json. */
+export declare const VERSION = "0.1.0";
+export { EntryType, isBatchOrigin } from './entry.js';
+export type { BatchOrigin, BuiltinEntryType, Entry, RecordInput } from './entry.js';
+export type { EntryQuery, TelescopeStore } from './store.js';
+export { InMemoryTelescopeStore } from './stores/memory.js';
+export type { InMemoryStoreOptions } from './stores/memory.js';
+export { createTableStatements, createTelescopeTable, DEFAULT_TABLE_NAME, LucidTelescopeStore, } from './stores/lucid.js';
+export type { CreateTableOptions, LucidDatabaseLike, LucidInsertBuilderLike, LucidQueryBuilderLike, LucidStoreOptions, TelescopeColumns, } from './stores/lucid.js';
+export { storage } from './stores/factory.js';
+export type { LucidStoreConfig, MemoryStoreConfig, StoreContext, StoreProvider, } from './stores/factory.js';
+export { TelescopeService } from './service.js';
+export type { CountBucket } from './service.js';
+export { buildDiagnosticEntry, DIAGNOSTIC_ENTRY_TYPE, DiagnosticsWatcher, } from './diagnostics_watcher.js';
+export type { DiagnosticEntryContent } from './diagnostics_watcher.js';
+export { recordRequest } from './request_watcher.js';
+export type { HttpContextLike, RecordRequestOptions, RequestEntryContent, } from './request_watcher.js';
+export { buildExceptionInput, recordException, recordExceptionInStore, } from './exception_watcher.js';
+export type { ExceptionEntryContent, RecordExceptionContext, } from './exception_watcher.js';
+export { exceptionFamilyHash } from './exception_family_hash.js';
+export type { ExceptionFamilyParts } from './exception_family_hash.js';
+export { defineTelescopeExtension } from './extension/types.js';
+export type { Column, ContainerLike, DashboardSection, DashboardSpec, DataBinding, DataProvider, ExtensionContext, ExtensionEntryType, LinkSpec, Panel, PanelThresholds, TelescopeExtension, } from './extension/types.js';
+export { ExtensionRegistry } from './extension/registry.js';
+export { defineConfig, resolveConfig } from './define_config.js';
+export type { RedactConfig, ResolvedTelescopeConfig, TelescopeConfig, WatcherName, } from './define_config.js';
+export { compileRedactSpec, DEFAULT_MASK, DEFAULT_REDACT_KEYS, redact, redactBounded, redactBoundedWith, } from './redaction/redact.js';
+export type { CompiledRedactSpec, RedactBoundedResult, RedactOptions, } from './redaction/redact.js';
+export { RedactingTelescopeStore } from './redaction/redacting_store.js';
+export { getTelescopeRuntime, resetTelescopeRuntime, setTelescopeExtensionRegistry, setTelescopeRuntime, } from './registry.js';
+export type { TelescopeRuntime } from './registry.js';
+export { currentTraceId, getContextAccessor } from './context_accessor.js';
+export type { ContextAccessor } from './context_accessor.js';
+export { getDiagnosticsRegistry, isDiagnosticEvent, } from './diagnostics_registry.js';
+export type { DiagnosticEvent, DiagnosticsRegistry } from './diagnostics_registry.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/index.js

@@ -0,0 +1,28 @@
+/** Keep in sync with this package's `version` in package.json. */
+export const VERSION = '0.1.0';
+// — entry model —
+export { EntryType, isBatchOrigin } from './entry.js';
+export { InMemoryTelescopeStore } from './stores/memory.js';
+export { createTableStatements, createTelescopeTable, DEFAULT_TABLE_NAME, LucidTelescopeStore, } from './stores/lucid.js';
+export { storage } from './stores/factory.js';
+// — query API —
+export { TelescopeService } from './service.js';
+// — watchers —
+export { buildDiagnosticEntry, DIAGNOSTIC_ENTRY_TYPE, DiagnosticsWatcher, } from './diagnostics_watcher.js';
+export { recordRequest } from './request_watcher.js';
+export { buildExceptionInput, recordException, recordExceptionInStore, } from './exception_watcher.js';
+export { exceptionFamilyHash } from './exception_family_hash.js';
+// — extension SDK —
+export { defineTelescopeExtension } from './extension/types.js';
+export { ExtensionRegistry } from './extension/registry.js';
+// — config —
+export { defineConfig, resolveConfig } from './define_config.js';
+// — redaction —
+export { compileRedactSpec, DEFAULT_MASK, DEFAULT_REDACT_KEYS, redact, redactBounded, redactBoundedWith, } from './redaction/redact.js';
+export { RedactingTelescopeStore } from './redaction/redacting_store.js';
+// — runtime (advanced) —
+export { getTelescopeRuntime, resetTelescopeRuntime, setTelescopeExtensionRegistry, setTelescopeRuntime, } from './registry.js';
+// — structural ecosystem readers —
+export { currentTraceId, getContextAccessor } from './context_accessor.js';
+export { getDiagnosticsRegistry, isDiagnosticEvent, } from './diagnostics_registry.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAS3B,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAQ9C,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,eAAe;AACf,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAMrD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,oBAAoB;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAehE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQjE,gBAAgB;AAChB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,MAAM,EACN,aAAa,EACb,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,yBAAyB;AACzB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAGvB,mCAAmC;AACnC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3E,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC"}

package/dist/src/redaction/redact.d.ts

@@ -0,0 +1,93 @@
+/**
+ * The default set of sensitive key names masked by {@link redact}. Matched
+ * case-insensitively at any depth. Mirrors the NestJS original 1:1.
+ */
+export declare const DEFAULT_REDACT_KEYS: readonly string[];
+/** The default replacement for a masked sensitive leaf. */
+export declare const DEFAULT_MASK = "[REDACTED]";
+export interface RedactOptions {
+    /** Extra keys to mask (merged with {@link DEFAULT_REDACT_KEYS}, case-insensitive). */
+    keys?: string[];
+    /**
+     * Exact dot-paths to mask regardless of key name, e.g. `'body.ssn'`.
+     * Unlike `keys` (which match that key at any depth), a path must match the
+     * full traversal location from the root of the value passed to {@link redact}.
+     */
+    paths?: string[];
+    /** Replacement string. Defaults to {@link DEFAULT_MASK}. */
+    mask?: string;
+    /**
+     * Maximum object/array nesting depth to clone. Beyond it, the subtree is
+     * replaced with `'[Truncated: depth]'`. ON BY DEFAULT (8).
+     */
+    maxDepth?: number;
+    /**
+     * Maximum cloned string length. Longer strings are clipped to the first N
+     * chars plus a `'…[truncated]'` suffix. ON BY DEFAULT (8_192).
+     */
+    maxStringLength?: number;
+    /**
+     * Maximum number of array items to clone. Longer arrays keep the first N items
+     * and append a final `'[Truncated: N of M items]'` marker element. ON BY
+     * DEFAULT (200).
+     */
+    maxArrayLength?: number;
+    /**
+     * Per-call walked-node budget: every object, array, and leaf visited counts
+     * against it. Once exhausted, remaining subtrees become `'[Truncated: size]'`.
+     * ON BY DEFAULT (5_000).
+     */
+    maxNodes?: number;
+    /**
+     * Approximate serialized-byte budget per cloned content: every string charges
+     * its length, every visited node a small fixed overhead. Once exhausted,
+     * remaining subtrees become `'[Truncated: size]'`. ON BY DEFAULT (16_384).
+     */
+    maxContentBytes?: number;
+}
+/** Result of a bounded redaction: the detached clone plus whether anything was clipped. */
+export interface RedactBoundedResult {
+    /** The detached, masked, bounded clone. */
+    value: unknown;
+    /** True when any bound (depth/string/array/node/byte) clipped some content. */
+    truncated: boolean;
+}
+/**
+ * The masking decision derived from {@link RedactOptions}, compiled ONCE so the
+ * per-entry hot path never rebuilds these Sets. `keySet` holds the lowercased
+ * union of {@link DEFAULT_REDACT_KEYS} and `options.keys`; `paths` holds the exact
+ * dot-paths. Build it via {@link compileRedactSpec} at boot and feed it to
+ * {@link redactBoundedWith}.
+ */
+export interface CompiledRedactSpec {
+    /** Lowercased union of default + configured keys, matched at any depth. */
+    keySet: ReadonlySet<string>;
+    /** Exact dot-paths to mask regardless of key name. */
+    paths: ReadonlySet<string>;
+}
+/**
+ * Precompiles the immutable key/path Sets from {@link RedactOptions}. Call once
+ * (config is immutable after boot) and reuse the result across every entry.
+ */
+export declare function compileRedactSpec(options: RedactOptions): CompiledRedactSpec;
+/**
+ * Bounded, never-throwing, SYNCHRONOUS deep clone of `value` with sensitive
+ * leaves masked. Same key/path masking semantics as {@link redact}, plus the
+ * hard memory bounds in {@link RedactOptions} (all defaulted on). Returns the
+ * clone AND whether truncation happened.
+ */
+export declare function redactBounded(value: unknown, options?: RedactOptions): RedactBoundedResult;
+/**
+ * Bounded redaction using an ALREADY-COMPILED {@link CompiledRedactSpec}, so the
+ * per-entry hot path never rebuilds the key/path Sets. Identical behaviour to
+ * {@link redactBounded}; only the `keys`/`paths` of `options` are ignored in
+ * favour of the prebuilt `spec` (the remaining bound options are still read).
+ */
+export declare function redactBoundedWith(value: unknown, options: RedactOptions, spec: CompiledRedactSpec): RedactBoundedResult;
+/**
+ * Returns a deep clone of `value` with sensitive leaves replaced by the mask.
+ * Never mutates the input. Memory-bounded by default (see {@link RedactOptions});
+ * delegates to {@link redactBounded} and discards the truncation flag.
+ */
+export declare function redact(value: unknown, options?: RedactOptions): unknown;
+//# sourceMappingURL=redact.d.ts.map

package/dist/src/redaction/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../../src/redaction/redact.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAgBhD,CAAC;AAyBF,2DAA2D;AAC3D,eAAO,MAAM,YAAY,eAAe,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,2FAA2F;AAC3F,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,sDAAsD;IACtD,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,kBAAkB,CAO5E;AAKD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,mBAAmB,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,kBAAkB,GACvB,mBAAmB,CAqGrB;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAE3E"}

package/dist/src/redaction/redact.js

@@ -0,0 +1,184 @@
+// packages/core/src/redaction/redact.ts
+//
+// Framework-agnostic, sensitive-data REDACTION. Ported from `nestjs-telescope`'s
+// `redaction/redact.ts`: a bounded, never-throwing, cycle-safe deep clone that
+// masks sensitive keys (case-insensitive) before content is persisted. Telescope
+// wires it once at the store boundary so NO watcher can leak a secret into storage.
+/**
+ * The default set of sensitive key names masked by {@link redact}. Matched
+ * case-insensitively at any depth. Mirrors the NestJS original 1:1.
+ */
+export const DEFAULT_REDACT_KEYS = [
+    'authorization',
+    'cookie',
+    'set-cookie',
+    'password',
+    'passwd',
+    'secret',
+    'token',
+    'access_token',
+    'refresh_token',
+    'api-key',
+    'api_key',
+    'apikey',
+    'x-api-key',
+    'client_secret',
+    'private_key',
+];
+/**
+ * Hard, on-by-default bounds that cap how much {@link redact} clones from a single
+ * input. A captured payload (a request body, an ORM entity reachable from query
+ * bindings, a mail context) can be an arbitrarily large or deep graph; cloning it
+ * whole would let a single entry retain an unbounded snapshot. These defaults are
+ * generous enough that a NORMAL entry is cloned byte-identically and only bite on
+ * pathological mega-graphs.
+ */
+const DEFAULT_MAX_DEPTH = 8;
+const DEFAULT_MAX_STRING_LENGTH = 8_192;
+const DEFAULT_MAX_ARRAY_LENGTH = 200;
+const DEFAULT_MAX_NODES = 5_000;
+const DEFAULT_MAX_CONTENT_BYTES = 16_384;
+/** Approximate per-node overhead charged against `maxContentBytes` (keys,
+ *  punctuation, numbers — a coarse stand-in for serialized size). */
+const NODE_BYTE_OVERHEAD = 8;
+/** Marker substituted for a subtree pruned because it exceeded `maxDepth`. */
+const DEPTH_MARKER = '[Truncated: depth]';
+/** Suffix appended to a string clipped to `maxStringLength`. */
+const STRING_TRUNCATION_SUFFIX = '…[truncated]';
+/** Marker substituted for a subtree pruned because the node/byte budget ran out. */
+const SIZE_MARKER = '[Truncated: size]';
+/** The default replacement for a masked sensitive leaf. */
+export const DEFAULT_MASK = '[REDACTED]';
+/**
+ * Precompiles the immutable key/path Sets from {@link RedactOptions}. Call once
+ * (config is immutable after boot) and reuse the result across every entry.
+ */
+export function compileRedactSpec(options) {
+    return {
+        keySet: new Set([...DEFAULT_REDACT_KEYS, ...(options.keys ?? [])].map((key) => key.toLowerCase())),
+        paths: new Set(options.paths ?? []),
+    };
+}
+const isPlainObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * Bounded, never-throwing, SYNCHRONOUS deep clone of `value` with sensitive
+ * leaves masked. Same key/path masking semantics as {@link redact}, plus the
+ * hard memory bounds in {@link RedactOptions} (all defaulted on). Returns the
+ * clone AND whether truncation happened.
+ */
+export function redactBounded(value, options = {}) {
+    return redactBoundedWith(value, options, compileRedactSpec(options));
+}
+/**
+ * Bounded redaction using an ALREADY-COMPILED {@link CompiledRedactSpec}, so the
+ * per-entry hot path never rebuilds the key/path Sets. Identical behaviour to
+ * {@link redactBounded}; only the `keys`/`paths` of `options` are ignored in
+ * favour of the prebuilt `spec` (the remaining bound options are still read).
+ */
+export function redactBoundedWith(value, options, spec) {
+    const mask = options.mask ?? DEFAULT_MASK;
+    const keySet = spec.keySet;
+    const paths = spec.paths;
+    const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH;
+    const maxStringLength = options.maxStringLength ?? DEFAULT_MAX_STRING_LENGTH;
+    const maxArrayLength = options.maxArrayLength ?? DEFAULT_MAX_ARRAY_LENGTH;
+    const maxNodes = options.maxNodes ?? DEFAULT_MAX_NODES;
+    const maxContentBytes = options.maxContentBytes ?? DEFAULT_MAX_CONTENT_BYTES;
+    const seen = new WeakSet();
+    // Mutable walk state: node + byte budgets and a truncation flag. Kept in the
+    // closure (not threaded through args) so the per-call accounting stays cheap.
+    let nodesRemaining = maxNodes;
+    let bytesRemaining = maxContentBytes;
+    let truncated = false;
+    const walk = (node, path, depth) => {
+        // Every visited node (object, array, or leaf) costs one node unit and a small
+        // byte overhead; strings additionally charge their length. Once either budget
+        // is gone, prune the rest of the graph regardless of its shape.
+        if (nodesRemaining <= 0 || bytesRemaining <= 0) {
+            truncated = true;
+            return SIZE_MARKER;
+        }
+        nodesRemaining -= 1;
+        bytesRemaining -= NODE_BYTE_OVERHEAD;
+        if (typeof node === 'string') {
+            const kept = node.length > maxStringLength ? maxStringLength : node.length;
+            bytesRemaining -= kept;
+            if (node.length > maxStringLength) {
+                truncated = true;
+                return `${node.slice(0, maxStringLength)}${STRING_TRUNCATION_SUFFIX}`;
+            }
+            return node;
+        }
+        // `seen` tracks only the current ancestor path (added on the way down, removed
+        // on the way up), so genuine cycles are caught while a non-cyclic shared
+        // reference appearing in two sibling positions is NOT a false hit.
+        if (Array.isArray(node)) {
+            if (seen.has(node))
+                return '[Circular]';
+            if (depth >= maxDepth) {
+                truncated = true;
+                return DEPTH_MARKER;
+            }
+            seen.add(node);
+            const limit = Math.min(node.length, maxArrayLength);
+            const mapped = [];
+            for (let index = 0; index < limit; index++) {
+                // Stop iterating the moment a budget runs out: ONE trailing marker, not
+                // one marker per remaining item (markers themselves cost bytes).
+                if (nodesRemaining <= 0 || bytesRemaining <= 0) {
+                    truncated = true;
+                    mapped.push(SIZE_MARKER);
+                    break;
+                }
+                mapped.push(walk(node[index], path ? `${path}.${index}` : String(index), depth + 1));
+            }
+            if (node.length > maxArrayLength) {
+                truncated = true;
+                mapped.push(`[Truncated: ${maxArrayLength} of ${node.length} items]`);
+            }
+            seen.delete(node);
+            return mapped;
+        }
+        if (isPlainObject(node)) {
+            if (seen.has(node))
+                return '[Circular]';
+            if (depth >= maxDepth) {
+                truncated = true;
+                return DEPTH_MARKER;
+            }
+            seen.add(node);
+            const result = {};
+            for (const [key, child] of Object.entries(node)) {
+                // Stop iterating the moment a budget runs out: ONE trailing marker, not
+                // one marker per remaining field (keys + markers themselves cost bytes).
+                if (nodesRemaining <= 0 || bytesRemaining <= 0) {
+                    truncated = true;
+                    result['…'] = SIZE_MARKER;
+                    break;
+                }
+                // Object keys are real serialized bytes — charge them too.
+                bytesRemaining -= key.length;
+                const childPath = path ? `${path}.${key}` : key;
+                if (keySet.has(key.toLowerCase()) || paths.has(childPath)) {
+                    result[key] = mask;
+                }
+                else {
+                    result[key] = walk(child, childPath, depth + 1);
+                }
+            }
+            seen.delete(node);
+            return result;
+        }
+        return node;
+    };
+    return { value: walk(value, '', 0), truncated };
+}
+/**
+ * Returns a deep clone of `value` with sensitive leaves replaced by the mask.
+ * Never mutates the input. Memory-bounded by default (see {@link RedactOptions});
+ * delegates to {@link redactBounded} and discards the truncation flag.
+ */
+export function redact(value, options = {}) {
+    return redactBounded(value, options).value;
+}
+//# sourceMappingURL=redact.js.map

package/dist/src/redaction/redact.js.map

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

package/dist/src/redaction/redacting_store.d.ts

@@ -0,0 +1,28 @@
+import type { Entry, RecordInput } from '../entry.js';
+import type { EntryQuery, TelescopeStore } from '../store.js';
+import { type RedactOptions } from './redact.js';
+/**
+ * The CENTRAL redaction choke point. A {@link TelescopeStore} decorator whose
+ * `record()` masks the entry's `content` (and `tags`) through {@link redactBoundedWith}
+ * BEFORE delegating to the inner store — every other operation passes through
+ * untouched.
+ *
+ * Wiring redaction here, at the one boundary every watcher records through
+ * (`request`, `exception`, `diagnostic`, `lucid query` bindings, `mail`, `cache`,
+ * and any custom watcher), guarantees no watcher can bypass it: there is exactly
+ * one write path and it always scrubs. The key/path Sets are compiled ONCE at
+ * construction so the per-entry hot path never rebuilds them.
+ */
+export declare class RedactingTelescopeStore implements TelescopeStore {
+    private readonly inner;
+    private readonly options;
+    private readonly spec;
+    constructor(inner: TelescopeStore, options?: RedactOptions);
+    record<TContent>(input: RecordInput<TContent>): Promise<Entry<TContent>>;
+    get(id: string): Promise<Entry | null>;
+    list(query?: EntryQuery): Promise<Entry[]>;
+    count(): Promise<number>;
+    prune(olderThan: Date, keepLast?: number): Promise<number>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=redacting_store.d.ts.map

package/dist/src/redaction/redacting_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redacting_store.d.ts","sourceRoot":"","sources":["../../../src/redaction/redacting_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAEL,KAAK,aAAa,EAGnB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAwB,YAAW,cAAc;IAI1D,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;gBAGvB,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,aAAkB;IAKxC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAW9E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAItC,IAAI,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAI1C,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAIxB,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvB"}

package/dist/src/redaction/redacting_store.js

@@ -0,0 +1,49 @@
+import { compileRedactSpec, redactBoundedWith, } from './redact.js';
+/**
+ * The CENTRAL redaction choke point. A {@link TelescopeStore} decorator whose
+ * `record()` masks the entry's `content` (and `tags`) through {@link redactBoundedWith}
+ * BEFORE delegating to the inner store — every other operation passes through
+ * untouched.
+ *
+ * Wiring redaction here, at the one boundary every watcher records through
+ * (`request`, `exception`, `diagnostic`, `lucid query` bindings, `mail`, `cache`,
+ * and any custom watcher), guarantees no watcher can bypass it: there is exactly
+ * one write path and it always scrubs. The key/path Sets are compiled ONCE at
+ * construction so the per-entry hot path never rebuilds them.
+ */
+export class RedactingTelescopeStore {
+    inner;
+    options;
+    spec;
+    constructor(inner, options = {}) {
+        this.inner = inner;
+        this.options = options;
+        this.spec = compileRedactSpec(options);
+    }
+    async record(input) {
+        const redacted = {
+            ...input,
+            content: redactBoundedWith(input.content, this.options, this.spec).value,
+        };
+        if (input.tags !== undefined) {
+            redacted.tags = redactBoundedWith(input.tags, this.options, this.spec).value;
+        }
+        return this.inner.record(redacted);
+    }
+    get(id) {
+        return this.inner.get(id);
+    }
+    list(query) {
+        return this.inner.list(query);
+    }
+    count() {
+        return this.inner.count();
+    }
+    prune(olderThan, keepLast) {
+        return this.inner.prune(olderThan, keepLast);
+    }
+    clear() {
+        return this.inner.clear();
+    }
+}
+//# sourceMappingURL=redacting_store.js.map

package/dist/src/redaction/redacting_store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redacting_store.js","sourceRoot":"","sources":["../../../src/redaction/redacting_store.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,uBAAuB;IAIf;IACA;IAJF,IAAI,CAAqB;IAE1C,YACmB,KAAqB,EACrB,UAAyB,EAAE;QAD3B,UAAK,GAAL,KAAK,CAAgB;QACrB,YAAO,GAAP,OAAO,CAAoB;QAE5C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAW,KAA4B;QACjD,MAAM,QAAQ,GAA0B;YACtC,GAAG,KAAK;YACR,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,KAAiB;SACrF,CAAC;QACF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,KAAiB,CAAC;QAC3F,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,KAAkB;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,SAAe,EAAE,QAAiB;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}