@plumix/core 0.4.0 → 0.6.0

package/dist/context/collector.js

@@ -0,0 +1,130 @@
+import { traceStore } from "./stores.js";
+import { NOOP_HANDLE } from "./telemetry.js";
+function isThenable(value) {
+    return (value != null && typeof value.then === "function");
+}
+// `String(x)` itself throws for e.g. `Object.create(null)`; the serializer
+// must never replace the original failure with its own.
+function describeThrown(error) {
+    try {
+        return { name: "Error", message: String(error) };
+    }
+    catch {
+        return { name: "Error", message: "<unserializable thrown value>" };
+    }
+}
+// Hard per-request caps so a pathological path (a runaway loop, an extreme
+// N+1) can't accumulate unbounded memory. Overflow is never silent: it counts
+// into getDropped(). Fixed on purpose — no config knob.
+const MAX_SPANS = 2000;
+const MAX_RECORDS_PER_NAMESPACE = 1000;
+/**
+ * The real telemetry collector. Accumulates per-namespace entries and a span
+ * tree for the request. Always present in production bundles; created only
+ * when at least one registered consumer votes to sample the request, so a
+ * site with no consumers stays on the no-op and pays nothing.
+ */
+export function createTelemetryCollector() {
+    const entries = new Map();
+    const roots = [];
+    let spanCount = 0;
+    let droppedSpans = 0;
+    const droppedRecords = {};
+    return {
+        record(namespace, entry) {
+            const bucket = entries.get(namespace);
+            if (bucket && bucket.length >= MAX_RECORDS_PER_NAMESPACE) {
+                droppedRecords[namespace] = (droppedRecords[namespace] ?? 0) + 1;
+                return;
+            }
+            const record = {
+                at: Date.now(),
+                data: typeof entry === "function" ? entry() : entry,
+            };
+            if (bucket)
+                bucket.push(record);
+            else
+                entries.set(namespace, [record]);
+        },
+        span(name, fn) {
+            // Over the cap: the work still runs and returns unchanged, but no span
+            // is allocated and lazy attributes are never evaluated.
+            if (spanCount >= MAX_SPANS) {
+                droppedSpans += 1;
+                return fn(NOOP_HANDLE);
+            }
+            spanCount += 1;
+            const startedAt = Date.now();
+            const span = {
+                name,
+                startedAt,
+                durationMs: 0,
+                status: "ok",
+                attributes: {},
+                children: [],
+            };
+            const handle = {
+                set(key, value) {
+                    span.attributes[key] = typeof value === "function" ? value() : value;
+                },
+            };
+            // Attach to the enclosing span (via AsyncLocalStorage) so nesting
+            // reflects call structure; top-level spans become roots.
+            const parent = traceStore.getStore();
+            if (parent)
+                parent.children.push(span);
+            else
+                roots.push(span);
+            const stamp = () => {
+                span.durationMs = Date.now() - startedAt;
+            };
+            // Serialized (never the live Error) so a finished span tree stays
+            // JSON-safe for any consumer; the failure itself propagates unchanged.
+            const fail = (error) => {
+                stamp();
+                span.status = "error";
+                span.error =
+                    error instanceof Error
+                        ? { name: error.name, message: error.message, stack: error.stack }
+                        : describeThrown(error);
+            };
+            let result;
+            try {
+                result = traceStore.run(span, () => fn(handle));
+            }
+            catch (error) {
+                fail(error);
+                throw error;
+            }
+            // Await async work before stamping so I/O time is measured, not just the
+            // synchronous prelude. Nesting already survives awaits via ALS.
+            if (isThenable(result)) {
+                return result.then((value) => {
+                    stamp();
+                    return value;
+                }, (error) => {
+                    fail(error);
+                    throw error;
+                });
+            }
+            stamp();
+            return result;
+        },
+        get(namespace) {
+            return entries.get(namespace) ?? [];
+        },
+        getRecords() {
+            // Copies, not the live buckets — this is the snapshot read, and a
+            // captured snapshot must not grow under post-response recording.
+            return Object.fromEntries([...entries].map(([namespace, bucket]) => [namespace, [...bucket]]));
+        },
+        getSpans() {
+            return roots;
+        },
+        getDropped() {
+            // Snapshot, not the live counter map — a captured value must not mutate.
+            return { spans: droppedSpans, records: { ...droppedRecords } };
+        },
+    };
+}
+//# sourceMappingURL=collector.js.map

package/dist/context/collector.js.map

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

package/dist/context/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./app.js";
 export * from "./stores.js";
+export * from "./telemetry.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/context/index.js

@@ -1,3 +1,4 @@
 export * from "./app.js";
 export * from "./stores.js";
+export * from "./telemetry.js";
 //# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/context/memo.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Request-scoped read-through memo — see `AppContextBase.memo`. Callers
+ * namespace keys (`core:settings-group:site`, `menu:data:primary`) since
+ * all consumers share one map per context.
+ *
+ * There is no invalidation: a write in the same execution is invisible to
+ * keys already loaded (cron runs share one memo across every task in the
+ * invocation). Loaders must also be principal-invariant — `withUser`
+ * derivations share the same memo, so anything user-dependent must embed
+ * the principal in the key.
+ */
+export type RequestMemo = <T>(key: string, load: () => Promise<T>) => Promise<T>;
+export declare function createRequestMemo(): RequestMemo;
+/**
+ * Per-id memo over a batched load: each id resolves through `memo`, and
+ * all misses share one lazy `loadAll` (single-flight, so the batch runs
+ * at most once per call). `loadAll` may fetch every requested id — hits
+ * keep their first-seen value regardless. Ids absent from the loaded map
+ * memoize as `null`.
+ */
+export declare function memoBatch<K, T>(memo: RequestMemo, ids: readonly K[], keyFor: (id: K) => string, loadAll: () => Promise<ReadonlyMap<K, T>>): Promise<(T | null)[]>;
+//# sourceMappingURL=memo.d.ts.map

package/dist/context/memo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.d.ts","sourceRoot":"","sources":["../../src/context/memo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB,wBAAgB,iBAAiB,IAAI,WAAW,CAY/C;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAC5B,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,SAAS,CAAC,EAAE,EACjB,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,EACzB,OAAO,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAQvB"}

package/dist/context/memo.js

@@ -0,0 +1,27 @@
+export function createRequestMemo() {
+    const cache = new Map();
+    return (key, load) => {
+        const hit = cache.get(key);
+        if (hit !== undefined)
+            return hit;
+        const entry = load();
+        cache.set(key, entry);
+        // Rejections are not memoized — a transient DB error on one read
+        // shouldn't poison every later read of the same key in the request.
+        entry.catch(() => cache.delete(key));
+        return entry;
+    };
+}
+/**
+ * Per-id memo over a batched load: each id resolves through `memo`, and
+ * all misses share one lazy `loadAll` (single-flight, so the batch runs
+ * at most once per call). `loadAll` may fetch every requested id — hits
+ * keep their first-seen value regardless. Ids absent from the loaded map
+ * memoize as `null`.
+ */
+export function memoBatch(memo, ids, keyFor, loadAll) {
+    let batch;
+    const load = () => (batch ??= loadAll());
+    return Promise.all(ids.map((id) => memo(keyFor(id), async () => (await load()).get(id) ?? null)));
+}
+//# sourceMappingURL=memo.js.map

package/dist/context/memo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.js","sourceRoot":"","sources":["../../src/context/memo.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAClD,OAAO,CAAI,GAAW,EAAE,IAAsB,EAAc,EAAE;QAC5D,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,GAAiB,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;QACrB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtB,iEAAiE;QACjE,oEAAoE;QACpE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CACvB,IAAiB,EACjB,GAAiB,EACjB,MAAyB,EACzB,OAAyC;IAEzC,IAAI,KAA6C,CAAC;IAClD,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;IACzC,OAAO,OAAO,CAAC,GAAG,CAChB,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CACb,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAC7D,CACF,CAAC;AACJ,CAAC"}

package/dist/context/stores.d.ts

@@ -1,20 +1,13 @@
 import { AsyncLocalStorage } from "node:async_hooks";
 import type { AppContext } from "./app.js";
+import type { TelemetrySpan } from "./telemetry.js";
 export declare const requestStore: AsyncLocalStorage<AppContext>;
 export interface HookFrame {
     readonly hook: string;
     readonly plugin: string | null;
 }
 export declare const hookStore: AsyncLocalStorage<HookFrame>;
-export interface TraceSpan {
-    readonly name: string;
-    readonly startedAt: number;
-    /** Wall-clock duration; set when the span's work completes. */
-    durationMs: number;
-    readonly children: TraceSpan[];
-    readonly annotations: Record<string, unknown>;
-}
-export declare const traceStore: AsyncLocalStorage<TraceSpan>;
+export declare const traceStore: AsyncLocalStorage<TelemetrySpan>;
 export declare const txStore: AsyncLocalStorage<unknown>;
 export declare function getContext(): AppContext;
 export declare function tryGetContext(): AppContext | null;

package/dist/context/stores.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stores.d.ts","sourceRoot":"","sources":["../../src/context/stores.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG3C,eAAO,MAAM,YAAY,+BAAsC,CAAC;AAEhE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,eAAO,MAAM,SAAS,8BAAqC,CAAC;AAE5D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,UAAU,8BAAqC,CAAC;AAE7D,eAAO,MAAM,OAAO,4BAAmC,CAAC;AAExD,wBAAgB,UAAU,IAAI,UAAU,CAIvC;AAED,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAEjD"}
+{"version":3,"file":"stores.d.ts","sourceRoot":"","sources":["../../src/context/stores.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,eAAO,MAAM,YAAY,+BAAsC,CAAC;AAEhE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,eAAO,MAAM,SAAS,8BAAqC,CAAC;AAE5D,eAAO,MAAM,UAAU,kCAAyC,CAAC;AAEjE,eAAO,MAAM,OAAO,4BAAmC,CAAC;AAExD,wBAAgB,UAAU,IAAI,UAAU,CAIvC;AAED,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAEjD"}

package/dist/context/stores.js.map

@@ -1 +1 @@
-{"version":3,"file":"stores.js","sourceRoot":"","sources":["../../src/context/stores.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0EAA0E;AAC1E,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAAc,CAAC;AAOhE,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAa,CAAC;AAW5D,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAAa,CAAC;AAE7D,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAW,CAAC;AAExD,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACpC,IAAI,CAAC,GAAG;QAAE,MAAM,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAChD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,YAAY,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC;AACzC,CAAC"}
+{"version":3,"file":"stores.js","sourceRoot":"","sources":["../../src/context/stores.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,0EAA0E;AAC1E,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIrD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAAc,CAAC;AAOhE,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAa,CAAC;AAE5D,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAAiB,CAAC;AAEjE,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAW,CAAC;AAExD,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACpC,IAAI,CAAC,GAAG;QAAE,MAAM,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAChD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,YAAY,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC;AACzC,CAAC"}

package/dist/context/telemetry.d.ts

@@ -0,0 +1,148 @@
+import type { AppContext } from "./app.js";
+/** Attribute and record values must be JSON-serializable — enforced by type only. */
+export type JsonValue = string | number | boolean | null | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+/**
+ * A span's captured failure — the serialized form, never the live Error.
+ * @public consumer-facing (imported by exporters, not core)
+ */
+export interface TelemetrySpanError {
+    readonly name: string;
+    readonly message: string;
+    readonly stack?: string;
+}
+/**
+ * One node in the request's span tree. Minimal and OTel-mappable: an exporter
+ * can project name/timing/attributes onto an OTel span ~1:1, minting ids at
+ * export time.
+ */
+export interface TelemetrySpan {
+    readonly name: string;
+    readonly startedAt: number;
+    /** Wall-clock duration; set when the span's work completes. */
+    durationMs: number;
+    /** "error" when the span's function threw or rejected; the error is captured
+     * before the failure propagates unchanged. */
+    status: "ok" | "error";
+    error?: TelemetrySpanError;
+    readonly attributes: Record<string, JsonValue>;
+    readonly children: TelemetrySpan[];
+}
+/**
+ * Handed to a span's function for attaching attributes. A lazy (thunk) value is
+ * evaluated once by the active collector and never by the no-op — expensive
+ * payloads cost nothing when nobody collects.
+ */
+export interface TelemetrySpanHandle {
+    set(key: string, value: JsonValue | (() => JsonValue)): void;
+}
+/** A recorded durationless fact, stamped so consumers can order it against spans. */
+export interface TelemetryRecord {
+    readonly at: number;
+    readonly data: unknown;
+}
+/**
+ * What the hard per-request caps discarded — visible so a consumer never
+ * mistakes a truncated trace for a complete one.
+ * @public consumer-facing (imported by exporters, not core)
+ */
+export interface TelemetryDropped {
+    readonly spans: number;
+    readonly records: Readonly<Record<string, number>>;
+}
+/**
+ * Request-scoped telemetry collector — the single source of truth for what
+ * happened during a request. Core and plugins record spans (anything with a
+ * duration) and records (durationless facts) under a namespace; consumers such
+ * as the dev debug bar read them back. Two implementations:
+ * {@link NOOP_TELEMETRY} (used whenever no consumer sampled the request) and
+ * the real accumulating collector, activated by consumer vote.
+ */
+export interface TelemetryCollector {
+    /**
+     * Append an entry under `namespace` (for the debug bar: the panel's id).
+     * A function entry is a lazy payload: the active collector evaluates it once
+     * at record time; the no-op never does.
+     */
+    record(namespace: string, entry: unknown): void;
+    /** Time `fn`, record a span, and return `fn`'s result unchanged. */
+    span<T>(name: string, fn: (s: TelemetrySpanHandle) => T): T;
+    /** Timestamped entries recorded under `namespace`, in record order. */
+    get(namespace: string): readonly TelemetryRecord[];
+    /** Every namespace's entries, keyed by namespace — the snapshot read. */
+    getRecords(): Readonly<Record<string, readonly TelemetryRecord[]>>;
+    /** The collected span tree (the Timeline panel consumes this). */
+    getSpans(): readonly TelemetrySpan[];
+    /** Counts of entries discarded by the per-request caps. */
+    getDropped(): TelemetryDropped;
+}
+/**
+ * The finished request's identity and outcome, as a consumer sees it.
+ * `requestId` is `ctx.requestId`, minted at context creation — mid-request
+ * reads (logs, error hooks) correlate with the snapshot on the same value.
+ * `startedAt`/`durationMs` span the dispatch of the request — context
+ * creation and the sampling vote happen just before the clock starts.
+ * @public consumer-facing (imported by exporters, not core)
+ */
+export interface TelemetryRequestEnvelope {
+    readonly requestId: string;
+    readonly method: string;
+    readonly url: string;
+    readonly status: number;
+    readonly startedAt: number;
+    readonly durationMs: number;
+}
+/**
+ * The finished, JSON-serializable view of a collected request: envelope, root
+ * spans, timestamped records by namespace, and what the caps discarded.
+ * Serializability is enforced by type only — no runtime validation. The
+ * envelope `url` is the full request URL, query string included — an
+ * exporter shipping snapshots off-box owns scrubbing query-borne secrets.
+ * @public consumer-facing (imported by exporters, not core)
+ */
+export interface TelemetrySnapshot {
+    readonly request: TelemetryRequestEnvelope;
+    readonly spans: readonly TelemetrySpan[];
+    readonly records: Readonly<Record<string, readonly TelemetryRecord[]>>;
+    readonly dropped: TelemetryDropped;
+}
+/**
+ * A telemetry export destination, registered once in app config
+ * (`telemetry.consumers`). A request collects iff at least one registered
+ * consumer votes yes; with no consumers the collector stays the no-op and
+ * production pays nothing.
+ */
+export interface TelemetryConsumer {
+    readonly id: string;
+    /**
+     * Head-sampling vote, called once at context creation (before any
+     * collection — `ctx.telemetry` is not yet active). Omitted = always yes.
+     * Runs pre-auth: on public requests `ctx.user` is null even when a
+     * session cookie is present. A throwing vote fails the request — decide
+     * from cheap request-shaped facts and don't throw.
+     */
+    readonly sample?: (ctx: AppContext) => boolean;
+    /**
+     * Receives the finished snapshot after the response (via `waitUntil` on
+     * Workers), so export latency never adds to response time. Errors live in
+     * the span tree — there is no separate error callback; an error-hook
+     * consumer may read the live `ctx.telemetry` mid-request instead.
+     */
+    readonly onRequestEnd?: (snapshot: TelemetrySnapshot, ctx: AppContext) => void | Promise<void>;
+}
+/** The `telemetry` app-config slot. */
+export interface TelemetryConfig {
+    readonly consumers?: readonly TelemetryConsumer[];
+}
+/** Shared no-op span handle: attributes (lazy or not) are never evaluated. */
+export declare const NOOP_HANDLE: TelemetrySpanHandle;
+/**
+ * The permanent no-op collector. Lives in core proper so plugin `ctx.telemetry`
+ * call sites stay safe everywhere: `record` drops the entry, `span` calls
+ * through and returns the result, reads are empty. The real collector is
+ * swapped in only when at least one registered consumer votes to sample the
+ * request — a site with no consumers pays nothing, in dev or prod.
+ */
+export declare const NOOP_TELEMETRY: TelemetryCollector;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/context/telemetry.d.ts.map

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

package/dist/context/telemetry.js

@@ -0,0 +1,20 @@
+/** Shared no-op span handle: attributes (lazy or not) are never evaluated. */
+export const NOOP_HANDLE = {
+    set: () => undefined,
+};
+/**
+ * The permanent no-op collector. Lives in core proper so plugin `ctx.telemetry`
+ * call sites stay safe everywhere: `record` drops the entry, `span` calls
+ * through and returns the result, reads are empty. The real collector is
+ * swapped in only when at least one registered consumer votes to sample the
+ * request — a site with no consumers pays nothing, in dev or prod.
+ */
+export const NOOP_TELEMETRY = {
+    record: () => undefined,
+    span: (_name, fn) => fn(NOOP_HANDLE),
+    get: () => [],
+    getRecords: () => ({}),
+    getSpans: () => [],
+    getDropped: () => ({ spans: 0, records: {} }),
+};
+//# sourceMappingURL=telemetry.js.map

package/dist/context/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/context/telemetry.ts"],"names":[],"mappings":"AA4JA,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAwB;IAC9C,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAuB;IAChD,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS;IACvB,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC;IACpC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE;IACb,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IACtB,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE;IAClB,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;CAC9C,CAAC"}

package/dist/context/traced-fetch.d.ts

@@ -0,0 +1,14 @@
+import type { TelemetryCollector } from "./telemetry.js";
+/**
+ * Traced outbound HTTP — the `ctx.fetch` implementation. Same call surface as
+ * global `fetch`; every call runs inside a telemetry span carrying method, URL,
+ * and response status (OTel-mappable attribute keys), with the span's own
+ * duration and error capture covering timing and failure. The collector is read
+ * per call so activation at context creation is always observed.
+ *
+ * W3C trace-context propagation (`traceparent` injection) is deliberately not
+ * here — trace ids don't exist during the request. The future OTel exporter
+ * will need a request-mutation seam at this choke point.
+ */
+export declare function createTracedFetch(getTelemetry: () => TelemetryCollector): typeof globalThis.fetch;
+//# sourceMappingURL=traced-fetch.d.ts.map

package/dist/context/traced-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-fetch.d.ts","sourceRoot":"","sources":["../../src/context/traced-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AASzD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,kBAAkB,GACrC,OAAO,UAAU,CAAC,KAAK,CAgBzB"}

package/dist/context/traced-fetch.js

@@ -0,0 +1,33 @@
+// The span label carries the host (not the full URL) so a timeline groups
+// calls per upstream; the full URL lives in the `url.full` attribute.
+function spanName(method, url) {
+    const host = URL.parse(url)?.host;
+    return host ? `fetch: ${method} ${host}` : `fetch: ${method}`;
+}
+/**
+ * Traced outbound HTTP — the `ctx.fetch` implementation. Same call surface as
+ * global `fetch`; every call runs inside a telemetry span carrying method, URL,
+ * and response status (OTel-mappable attribute keys), with the span's own
+ * duration and error capture covering timing and failure. The collector is read
+ * per call so activation at context creation is always observed.
+ *
+ * W3C trace-context propagation (`traceparent` injection) is deliberately not
+ * here — trace ids don't exist during the request. The future OTel exporter
+ * will need a request-mutation seam at this choke point.
+ */
+export function createTracedFetch(getTelemetry) {
+    return (input, init) => {
+        // `init.method` wins over a Request input's method — the same precedence
+        // `new Request(input, init)` applies inside fetch itself.
+        const method = (init?.method ?? (input instanceof Request ? input.method : "GET")).toUpperCase();
+        const url = input instanceof Request ? input.url : String(input);
+        return getTelemetry().span(spanName(method, url), async (s) => {
+            s.set("http.request.method", method);
+            s.set("url.full", url);
+            const response = await globalThis.fetch(input, init);
+            s.set("http.response.status_code", response.status);
+            return response;
+        });
+    };
+}
+//# sourceMappingURL=traced-fetch.js.map

package/dist/context/traced-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-fetch.js","sourceRoot":"","sources":["../../src/context/traced-fetch.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,sEAAsE;AACtE,SAAS,QAAQ,CAAC,MAAc,EAAE,GAAW;IAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IAClC,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,MAAM,EAAE,CAAC;AAChE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAAsC;IAEtC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,yEAAyE;QACzE,0DAA0D;QAC1D,MAAM,MAAM,GAAG,CACb,IAAI,EAAE,MAAM,IAAI,CAAC,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAClE,CAAC,WAAW,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjE,OAAO,YAAY,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC5D,CAAC,CAAC,GAAG,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YACvB,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACrD,CAAC,CAAC,GAAG,CAAC,2BAA2B,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpD,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/context/traced-slots.d.ts

@@ -0,0 +1,17 @@
+import type { Mailer } from "../auth/mailer/types.js";
+import type { AssetsBinding, ConnectedCache, ConnectedObjectStorage } from "../runtime/slots.js";
+import type { TelemetryCollector } from "./telemetry.js";
+/**
+ * Platform I/O slot tracing — the counterpart of `createTracedFetch` for the
+ * remaining context slots (#1494). Each wrapper is applied once at context
+ * assembly; the collector is read per call so the post-vote swap in
+ * `createAppContext` is always observed, and with no consumer sampled every
+ * span() is the no-op pass-through.
+ */
+type GetTelemetry = () => TelemetryCollector;
+export declare function traceCache(cache: ConnectedCache, getTelemetry: GetTelemetry): ConnectedCache;
+export declare function traceAssets(assets: AssetsBinding, getTelemetry: GetTelemetry): AssetsBinding;
+export declare function traceStorage(storage: ConnectedObjectStorage, getTelemetry: GetTelemetry): ConnectedObjectStorage;
+export declare function traceMailer(mailer: Mailer, getTelemetry: GetTelemetry): Mailer;
+export {};
+//# sourceMappingURL=traced-slots.d.ts.map

package/dist/context/traced-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-slots.d.ts","sourceRoot":"","sources":["../../src/context/traced-slots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;;;GAMG;AACH,KAAK,YAAY,GAAG,MAAM,kBAAkB,CAAC;AAE7C,wBAAgB,UAAU,CACxB,KAAK,EAAE,cAAc,EACrB,YAAY,EAAE,YAAY,GACzB,cAAc,CAiBhB;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,YAAY,GACzB,aAAa,CAUf;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,sBAAsB,EAC/B,YAAY,EAAE,YAAY,GACzB,sBAAsB,CA2BxB;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,GACzB,MAAM,CASR"}

package/dist/context/traced-slots.js

@@ -0,0 +1,57 @@
+export function traceCache(cache, getTelemetry) {
+    return {
+        match: (request) => getTelemetry().span("cache: match", async (s) => {
+            const hit = await cache.match(request);
+            s.set("cache.hit", hit !== undefined);
+            return hit;
+        }),
+        put: (request, response, tags) => getTelemetry().span("cache: put", (s) => {
+            s.set("cache.tags", () => [...tags]);
+            return cache.put(request, response, tags);
+        }),
+        // Untraced on purpose: purges fire post-response (after the snapshot is
+        // delivered), so a span here would dangle as an unfinished root.
+        purgeTags: (tags) => cache.purgeTags(tags),
+    };
+}
+export function traceAssets(assets, getTelemetry) {
+    return {
+        fetch: (request) => getTelemetry().span("assets: fetch", async (s) => {
+            s.set("url.full", request.url);
+            const response = await assets.fetch(request);
+            s.set("http.response.status_code", response.status);
+            return response;
+        }),
+    };
+}
+export function traceStorage(storage, getTelemetry) {
+    const spanned = (op, key, run) => getTelemetry().span(`storage: ${op}`, (s) => {
+        s.set("storage.key", key);
+        return run();
+    });
+    const presignPut = storage.presignPut?.bind(storage);
+    return {
+        put: (key, body, opts) => spanned("put", key, () => storage.put(key, body, opts)),
+        get: (key, opts) => spanned("get", key, () => storage.get(key, opts)),
+        head: (key) => spanned("head", key, () => storage.head(key)),
+        delete: (key) => spanned("delete", key, () => storage.delete(key)),
+        list: (prefix, opts) => getTelemetry().span("storage: list", (s) => {
+            s.set("storage.prefix", prefix ?? "");
+            return storage.list(prefix, opts);
+        }),
+        // URL minting (plain URL math / local signing), not object I/O — spanning
+        // it would put 0ms noise rows next to real bucket round-trips.
+        url: (key, opts) => storage.url(key, opts),
+        ...(presignPut ? { presignPut } : {}),
+    };
+}
+export function traceMailer(mailer, getTelemetry) {
+    return {
+        send: (message) => getTelemetry().span("mailer: send", (s) => {
+            s.set("mail.to", message.to);
+            s.set("mail.subject", message.subject);
+            return mailer.send(message);
+        }),
+    };
+}
+//# sourceMappingURL=traced-slots.js.map

package/dist/context/traced-slots.js.map

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

package/dist/db/libsql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"libsql.d.ts","sourceRoot":"","sources":["../../src/db/libsql.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;AAEvD,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,qBAAqB,CA4BvE"}
+{"version":3,"file":"libsql.d.ts","sourceRoot":"","sources":["../../src/db/libsql.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI3D,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;AAEvD,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,qBAAqB,CAyBvE"}

package/dist/db/libsql.js

@@ -1,8 +1,7 @@
 import { createClient } from "@libsql/client";
 import { drizzle } from "drizzle-orm/libsql";
-import { createDebugSqlLogger } from "../debug-bar/db-query.js";
-import { traceSqlClient } from "../debug-bar/trace-libsql.js";
 import { resolveEnvInput } from "../runtime/env-input.js";
+import { traceSqlClient } from "./trace-libsql.js";
 /**
  * Database adapter for any libSQL-compatible SQLite endpoint. Lives behind
  * the `@plumix/core/db/libsql` subpath so the driver only loads when this
@@ -23,20 +22,15 @@ export function libsql(config) {
         connect: (env, _request, schema) => {
             if (!client) {
                 const resolved = resolveEnvInput(config, env);
-                const raw = createClient({
+                // Unconditional: spans are no-ops unless a telemetry consumer
+                // sampled the request, so production without consumers pays nothing.
+                client = traceSqlClient(createClient({
                     url: resolved.url,
                     authToken: resolved.authToken,
-                });
-                // Dev-only: time each query as a span for the Timeline panel.
-                client = process.env.PLUMIX_DEV ? traceSqlClient(raw) : raw;
+                }));
             }
             return {
-                db: drizzle(client, {
-                    schema,
-                    casing: "snake_case",
-                    // Dev-only: feed the debug bar's Database panel. Tree-shaken in prod.
-                    logger: process.env.PLUMIX_DEV ? createDebugSqlLogger() : undefined,
-                }),
+                db: drizzle(client, { schema, casing: "snake_case" }),
             };
         },
     };

package/dist/db/libsql.js.map

@@ -1 +1 @@
-{"version":3,"file":"libsql.js","sourceRoot":"","sources":["../../src/db/libsql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAK7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAsB1D;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,MAAyB;IAC9C,2EAA2E;IAC3E,qEAAqE;IACrE,0EAA0E;IAC1E,IAAI,MAAmD,CAAC;IACxD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM;QACN,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YACjC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,GAAgB,CAAC,CAAC;gBAC3D,MAAM,GAAG,GAAG,YAAY,CAAC;oBACvB,GAAG,EAAE,QAAQ,CAAC,GAAG;oBACjB,SAAS,EAAE,QAAQ,CAAC,SAAS;iBAC9B,CAAC,CAAC;gBACH,8DAA8D;gBAC9D,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC9D,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,OAAO,CAAC,MAAM,EAAE;oBAClB,MAAM;oBACN,MAAM,EAAE,YAAY;oBACpB,sEAAsE;oBACtE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,SAAS;iBACpE,CAAC;aACH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"libsql.js","sourceRoot":"","sources":["../../src/db/libsql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAK7C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAsBnD;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,MAAyB;IAC9C,2EAA2E;IAC3E,qEAAqE;IACrE,0EAA0E;IAC1E,IAAI,MAAmD,CAAC;IACxD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM;QACN,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE;YACjC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,GAAgB,CAAC,CAAC;gBAC3D,8DAA8D;gBAC9D,qEAAqE;gBACrE,MAAM,GAAG,cAAc,CACrB,YAAY,CAAC;oBACX,GAAG,EAAE,QAAQ,CAAC,GAAG;oBACjB,SAAS,EAAE,QAAQ,CAAC,SAAS;iBAC9B,CAAC,CACH,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;aACtD,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}