@fougere/observability 0.3.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fougere contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/context/als.d.ts

@@ -0,0 +1,3 @@
+import type { TraceContext } from './port.js';
+export declare const traceContext: TraceContext;
+//# sourceMappingURL=als.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"als.d.ts","sourceRoot":"","sources":["../../src/context/als.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAI9C,eAAO,MAAM,YAAY,EAAE,YAI1B,CAAC"}

package/dist/context/als.js

@@ -0,0 +1,12 @@
+/**
+ * The default: a real `AsyncLocalStorage`, so a call with no wire above it still finds
+ * its parent in the stack it is running inside.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+const store = new AsyncLocalStorage();
+export const traceContext = {
+    ambient: true,
+    current: () => store.getStore(),
+    within: (span, fn) => store.run(span, fn),
+};
+//# sourceMappingURL=als.js.map

package/dist/context/als.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"als.js","sourceRoot":"","sources":["../../src/context/als.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIrD,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAe,CAAC;AAEnD,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,GAA0B,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAmB;IACvE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;CAC1C,CAAC"}

package/dist/context/none.d.ts

@@ -0,0 +1,3 @@
+import type { TraceContext } from './port.js';
+export declare const traceContext: TraceContext;
+//# sourceMappingURL=none.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"none.d.ts","sourceRoot":"","sources":["../../src/context/none.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,eAAO,MAAM,YAAY,EAAE,YAI1B,CAAC"}

package/dist/context/none.js

@@ -0,0 +1,6 @@
+export const traceContext = {
+    ambient: false,
+    current: () => undefined,
+    within: (_span, fn) => fn(),
+};
+//# sourceMappingURL=none.js.map

package/dist/context/none.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"none.js","sourceRoot":"","sources":["../../src/context/none.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,GAAyC,EAAE,CAAC,SAAS;IAC9D,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;CAC5B,CAAC"}

package/dist/context/port.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Where the step running right now is kept — the one thing a Worker cannot do.
+ *
+ * A trace has TWO ways to name its parent, and only one of them is ambient: an arriving
+ * call carries `traceparent` on the invocation, which every transport moves and which
+ * needs nothing from the runtime. This is the other way — the parent of a call that
+ * crossed no wire, which is in the stack and nowhere else.
+ *
+ * `node:async_hooks` does not exist on workerd unless the deployment asks for it, so
+ * `#trace-context` resolves to two realizations: the real store by default, and one that
+ * answers "no parent here" under the `workerd` condition. What that costs is stated at
+ * boot rather than discovered in a trace viewer — see `traceContext.ambient`.
+ */
+import type { SpanContext } from '../traceparent.js';
+export interface TraceContext {
+    /**
+     * Whether a parent can be found without a wire. False means every in-process call
+     * starts its own trace, and the boot says so.
+     */
+    readonly ambient: boolean;
+    /** The step running here and now, when one can be known. */
+    current<T extends SpanContext>(): T | undefined;
+    /** Run `fn` with `span` as the step in scope. */
+    within<T extends SpanContext, R>(span: T, fn: () => Promise<R>): Promise<R>;
+}
+//# sourceMappingURL=port.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/context/port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,OAAO,CAAC,CAAC,SAAS,WAAW,KAAK,CAAC,GAAG,SAAS,CAAC;IAChD,iDAAiD;IACjD,MAAM,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7E"}

package/dist/context/port.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=port.js.map

package/dist/context/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../src/context/port.ts"],"names":[],"mappings":""}

package/dist/extension.d.ts

@@ -0,0 +1,36 @@
+/**
+ * This package's own ascent and descent, in one value.
+ *
+ * Four gestures in a fixed order — the middleware, the accumulator, the sinks, the wire op
+ * — is a boot sequence, and a host had to know it: `demos/observability` wrote it out and
+ * hand-rolled its own `stop()` beside it, which is a `down` under another name. Declared as
+ * an extension, the order is stated once here and the release is not the host's to remember.
+ *
+ * It is not a frond and cannot become one: a frond may move behind `remotes:`, and this
+ * reads the process it runs in — moved, it would report the observer instead of the observed.
+ */
+import { type Extension } from '@fougere/core';
+export interface ObservabilityOptions {
+    /** What a dashboard groups this process by, and the name a log line carries. */
+    service?: string;
+    /**
+     * An OTLP collector's base URL — SigNoz, Jaeger, Tempo all read the same one.
+     *
+     * Absent, nothing leaves the process and `rpc.topology` still answers: a panel asking
+     * the app what shape it is in needs no collector.
+     */
+    otlp?: string;
+    flushMs?: number;
+    /** A collector that cannot be reached is the app's business, not its failure. */
+    onError?: (error: unknown) => void;
+}
+/**
+ * Observe this process — one member of the ascent.
+ *
+ * `up` wires in the order that matters and `down` withdraws in reverse, which is the whole
+ * reason the two halves are one value: `onSpan` and `onLog` already RETURN their withdrawal
+ * and nothing was calling it, so a discarded app kept feeding the sinks of the app that
+ * replaced it. That is invisible until the ring turns, and then it doubles every metric.
+ */
+export declare function observability(options?: ObservabilityOptions): Extension;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAA6C,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAQ1F,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,SAAS,CAsE3E"}

package/dist/extension.js

@@ -0,0 +1,91 @@
+/**
+ * This package's own ascent and descent, in one value.
+ *
+ * Four gestures in a fixed order — the middleware, the accumulator, the sinks, the wire op
+ * — is a boot sequence, and a host had to know it: `demos/observability` wrote it out and
+ * hand-rolled its own `stop()` beside it, which is a `down` under another name. Declared as
+ * an extension, the order is stated once here and the release is not the host's to remember.
+ *
+ * It is not a frond and cannot become one: a frond may move behind `remotes:`, and this
+ * reads the process it runs in — moved, it would report the observer instead of the observed.
+ */
+import { loggerMiddleware, Logger, onLog } from '@fougere/core';
+import { traceContext } from '#trace-context';
+import { registerFlush } from './index.js';
+import { trace, onSpan } from './index.js';
+import { metrics, serveTopology } from './metrics.js';
+import { otlp } from './otlp.js';
+import { logs } from './logs.js';
+/**
+ * Observe this process — one member of the ascent.
+ *
+ * `up` wires in the order that matters and `down` withdraws in reverse, which is the whole
+ * reason the two halves are one value: `onSpan` and `onLog` already RETURN their withdrawal
+ * and nothing was calling it, so a discarded app kept feeding the sinks of the app that
+ * replaced it. That is invisible until the ring turns, and then it doubles every metric.
+ */
+export function observability(options = {}) {
+    const service = options.service ?? 'fougere';
+    /**
+     * Per APP, not per extension. A host declares its extensions once (`configureFougere`),
+     * so the same instance goes up on the new app before the old one is released: one shared
+     * list meant the old app's `down` withdrew — and erased — the new app's sinks too, after
+     * which every counter stayed frozen and nothing said so.
+     */
+    const undoing = new WeakMap();
+    return {
+        name: 'observability',
+        up(app) {
+            const undo = [];
+            undoing.set(app, undo);
+            // Order matters: `trace()` opens the span that every log line written inside the
+            // call will carry. Installed the other way round, the lines leave uncorrelated.
+            app.use(trace());
+            app.use(loggerMiddleware(new Logger(service)));
+            // Said once, here, because the alternative is finding it in a trace viewer three
+            // weeks later: without an ambient context a call that crossed NO wire cannot name
+            // its parent, so it starts its own trace. What still works is stated too — a
+            // warning that only names the loss reads as "tracing is broken", and it is not.
+            if (!traceContext.ambient) {
+                new Logger(service).warn('no async context: a call that crosses no wire starts its own trace '
+                    + '(an emission subscriber, a handler reaching another frond in this process). '
+                    + 'An arriving call and a call to a frond behind `remotes:` are unaffected — both carry '
+                    + 'traceparent on the invocation. Add "nodejs_als" to compatibility_flags to restore the rest.');
+            }
+            const measured = metrics(app);
+            undo.push(onSpan(measured.sink));
+            serveTopology(app, measured);
+            if (!options.otlp)
+                return;
+            const base = options.otlp.replace(/\/$/, '');
+            const telemetry = otlp({
+                service,
+                url: `${base}/v1/traces`,
+                metricsUrl: `${base}/v1/metrics`,
+                metrics: measured,
+                ...(options.flushMs === undefined ? {} : { flushMs: options.flushMs }),
+                ...(options.onError ? { onError: options.onError } : {}),
+            });
+            const written = logs({
+                service,
+                url: `${base}/v1/logs`,
+                ...(options.flushMs === undefined ? {} : { flushMs: options.flushMs }),
+                ...(options.onError ? { onError: options.onError } : {}),
+            });
+            // The timer is not the only way out: an isolate is frozen when it answers, so a
+            // host with no time between requests calls `flushTelemetry()` inside `ctx.waitUntil`.
+            undo.push(onSpan(telemetry.sink), onLog(written.sink), registerFlush(() => telemetry.flush()), registerFlush(() => written.flush()), () => telemetry.stop(), () => written.stop());
+        },
+        async down(app) {
+            // Reverse, and the exporters' `stop()` is in here: it flushes what is buffered, so a
+            // released app publishes what it measured instead of dropping its last window.
+            const undo = undoing.get(app);
+            if (!undo)
+                return;
+            undoing.delete(app);
+            for (const step of undo.reverse())
+                await step();
+        },
+    };
+}
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAA4B,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiBjC;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,OAAO,GAAyB,EAAE;IAC9D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC;IAC7C;;;;;OAKG;IACH,MAAM,OAAO,GAAG,IAAI,OAAO,EAA0C,CAAC;IAEtE,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,EAAE,CAAC,GAAQ;YACT,MAAM,IAAI,GAAsC,EAAE,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACvB,iFAAiF;YACjF,gFAAgF;YAChF,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YACjB,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAE/C,iFAAiF;YACjF,kFAAkF;YAClF,6EAA6E;YAC7E,gFAAgF;YAChF,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC1B,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CACtB,qEAAqE;sBACnE,8EAA8E;sBAC9E,uFAAuF;sBACvF,6FAA6F,CAChG,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACjC,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAE7B,IAAI,CAAC,OAAO,CAAC,IAAI;gBAAE,OAAO;YAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,CAAC;gBACrB,OAAO;gBACP,GAAG,EAAE,GAAG,IAAI,YAAY;gBACxB,UAAU,EAAE,GAAG,IAAI,aAAa;gBAChC,OAAO,EAAE,QAAQ;gBACjB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;gBACtE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzD,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC;gBACnB,OAAO;gBACP,GAAG,EAAE,GAAG,IAAI,UAAU;gBACtB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;gBACtE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzD,CAAC,CAAC;YACH,gFAAgF;YAChF,sFAAsF;YACtF,IAAI,CAAC,IAAI,CACP,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAC3C,aAAa,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,EAC5E,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAC7C,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAQ;YACjB,qFAAqF;YACrF,+EAA+E;YAC/E,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC,IAAI;gBAAE,OAAO;YAClB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE;gBAAE,MAAM,IAAI,EAAE,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+import type { AppMiddleware } from '@fougere/core';
+import { type SpanContext } from './traceparent.js';
+export { traceparentOf, parseTraceparent } from './traceparent.js';
+export type { SpanContext } from './traceparent.js';
+/** A step that has finished, and what it did. */
+export interface FinishedSpan extends SpanContext {
+    parentId: string | undefined;
+    /**
+     * The frond of the step this one is nested in, when it is a DIFFERENT one — an edge of
+     * the call graph, `shop → catalog`.
+     *
+     * Only the caller can say it: a traceparent carries no frond, so a receiver knows it
+     * has a parent and not whose. That is not a gap — the caller already published the edge.
+     */
+    callerFrond: string | undefined;
+    /** Which frond owned the op — the deployment unit, so the first thing a reader groups by. */
+    frond: string | undefined;
+    entity: string;
+    operation: string;
+    /**
+     * When it started, in epoch milliseconds — an INSTANT, not an offset.
+     *
+     * `performance.now()` measures the duration below and nothing else: it counts from
+     * this process's own start, so two processes' numbers cannot be put on one timeline,
+     * which is the only thing a trace is for.
+     */
+    startedAt: number;
+    ms: number;
+    /** The FougereError code when it refused, absent when it answered. */
+    error: string | undefined;
+}
+export type SpanSink = (span: FinishedSpan) => void;
+/**
+ * The step running here and now.
+ *
+ * It exists for the call the wire cannot describe: a handler reaching a second frond
+ * builds a fresh invocation, so the parent is not on that call — it is in the context
+ * the first one is still running inside.
+ *
+ * Behind `#trace-context` because that context is a runtime capability, not ours: a
+ * Worker has none unless the deployment asks. `traceContext.ambient` says which one is
+ * running, and `trace()` reports it once at install rather than letting a reader
+ * discover it in a trace viewer.
+ */
+/** The step running right now, if any. */
+export declare function currentSpan(): SpanContext | undefined;
+export declare function activeCalls(): number;
+/**
+ * Send what is buffered, now. Safe to call where there is nothing to send.
+ *
+ * Module-level like `sinks`, and for the same reason: an exporter belongs to the PROCESS,
+ * and the handler that wants to flush it holds no reference to the extension that built it.
+ */
+export declare function flushTelemetry(): Promise<void>;
+/** Declare an exporter's flush, and answer the way to withdraw it — like `onSpan`. */
+export declare function registerFlush(send: () => Promise<void>): () => void;
+export declare function onSpan(next: SpanSink): () => void;
+/**
+ * The middleware. `app.use(trace())` traces every operation; `app.use('post', trace())`
+ * traces one entity's.
+ *
+ * Nothing is opened while no sink is set: observing is a decision, and the cost of one
+ * nobody asked for is zero rather than small.
+ */
+export declare function trace(): AppMiddleware;
+export { otlp } from './otlp.js';
+export type { OtlpOptions, OtlpExporter } from './otlp.js';
+export { metrics, metricsPayload, serveTopology } from './metrics.js';
+export type { Metrics, MetricsSnapshot, TopologyReport, FrondPlacement, Edge } from './metrics.js';
+export { logs } from './logs.js';
+export type { LogsOptions, LogExporter, CapturedLog } from './logs.js';
+export { observability } from './extension.js';
+export type { ObservabilityOptions } from './extension.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAA8C,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEhG,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAWpD,iDAAiD;AACjD,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,6FAA6F;IAC7F,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,sEAAsE;IACtE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;AAEpD;;;;;;;;;;;GAWG;AAEH,0CAA0C;AAC1C,wBAAgB,WAAW,IAAI,WAAW,GAAG,SAAS,CAErD;AAiBD,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAYD;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAMpD;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAMnE;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,IAAI,CAMjD;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,IAAI,aAAa,CA4DrC;AAOD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,172 @@
+/**
+ * @fougere/observability — one span per operation, and the trace that survives a wire.
+ *
+ * Named for the subject and not for today's reading of it: a span carries an op's
+ * duration and its verdict, which is the matter of a metric as much as of a trace, and
+ * an exporter for either hangs off the same `onSpan`.
+ *
+ * Optional in the strong sense: core holds no tracing code at all, only a `trace` field
+ * on the invocation that it carries and never reads. Everything else is here, behind
+ * `app.use(trace())`, and an app that does not install it pays nothing.
+ *
+ * It is an ordinary app middleware because an operation ALREADY has a lifecycle and it
+ * is that one — a second hook system would be a second answer to a settled question.
+ * The same middleware runs on both halves of a split: at the door a call arrives at, and
+ * at the stand-in it leaves from. That is why the numbers line up across processes, and
+ * why the difference between the two spans is what the wire cost.
+ */
+import { traceContext } from '#trace-context';
+import { parseTraceparent, traceparentOf, randomHex } from './traceparent.js';
+export { traceparentOf, parseTraceparent } from './traceparent.js';
+/**
+ * The step running here and now.
+ *
+ * It exists for the call the wire cannot describe: a handler reaching a second frond
+ * builds a fresh invocation, so the parent is not on that call — it is in the context
+ * the first one is still running inside.
+ *
+ * Behind `#trace-context` because that context is a runtime capability, not ours: a
+ * Worker has none unless the deployment asks. `traceContext.ambient` says which one is
+ * running, and `trace()` reports it once at install rather than letting a reader
+ * discover it in a trace viewer.
+ */
+/** The step running right now, if any. */
+export function currentSpan() {
+    return traceContext.current();
+}
+/**
+ * Who takes the spans this process finishes, consulted at every end like the log level.
+ *
+ * A list rather than one: a span is the source of a trace AND of a metric, so the two
+ * exporters read the same value rather than the middleware producing it twice.
+ * Returns the way to withdraw.
+ */
+const sinks = [];
+/**
+ * Calls running right now — the saturation signal, and the only one a FINISHED span
+ * cannot carry. Counted at the same two moments the span is opened and closed.
+ */
+let active = 0;
+export function activeCalls() {
+    return active;
+}
+/**
+ * Every exporter this process installed, so something can make them send NOW.
+ *
+ * An exporter buffers and flushes on a timer, which assumes a process that lives between
+ * two requests. An isolate does not: it is frozen the moment it answers, so the timer
+ * never fires and what it held is lost. `ctx.waitUntil(flushTelemetry())` is the whole
+ * remedy — the platform's way of saying "this work outlives the response".
+ */
+const flushes = [];
+/**
+ * Send what is buffered, now. Safe to call where there is nothing to send.
+ *
+ * Module-level like `sinks`, and for the same reason: an exporter belongs to the PROCESS,
+ * and the handler that wants to flush it holds no reference to the extension that built it.
+ */
+export async function flushTelemetry() {
+    // Every one, and the refusals together — a flush that abandons the rest loses the
+    // windows after it, which is the answer `app.deliver` gives for the same shape.
+    const failed = await Promise.allSettled(flushes.map((send) => send()));
+    const refused = failed.filter((r) => r.status === 'rejected');
+    if (refused.length > 0)
+        throw new AggregateError(refused.map((r) => r.reason), 'telemetry flush');
+}
+/** Declare an exporter's flush, and answer the way to withdraw it — like `onSpan`. */
+export function registerFlush(send) {
+    flushes.push(send);
+    return () => {
+        const at = flushes.indexOf(send);
+        if (at >= 0)
+            flushes.splice(at, 1);
+    };
+}
+export function onSpan(next) {
+    sinks.push(next);
+    return () => {
+        const at = sinks.indexOf(next);
+        if (at >= 0)
+            sinks.splice(at, 1);
+    };
+}
+/**
+ * The middleware. `app.use(trace())` traces every operation; `app.use('post', trace())`
+ * traces one entity's.
+ *
+ * Nothing is opened while no sink is set: observing is a decision, and the cost of one
+ * nobody asked for is zero rather than small.
+ */
+export function trace() {
+    return (ctx, next) => {
+        if (sinks.length === 0)
+            return next();
+        // The wire first, the ambient context second: an arriving call names its parent on
+        // the invocation, an outgoing one inherits from the call it is made inside.
+        const inherited = parseTraceparent(ctx.invocation?.trace);
+        const ambient = traceContext.current();
+        const parent = inherited ?? ambient;
+        const span = {
+            traceId: parent?.traceId ?? randomHex(16),
+            spanId: randomHex(8),
+            sampled: parent?.sampled ?? true,
+            frond: ctx.frond,
+        };
+        // An edge exists only when the parent is IN this process and belongs to another frond.
+        // `inherited` won means the parent is across a wire, and it did not name its frond.
+        const callerFrond = !inherited && ambient?.frond && ambient.frond !== ctx.frond ? ambient.frond : undefined;
+        // What this call hands to whatever it reaches next. Whether that is a transport or
+        // nothing at all is not this middleware's business — it writes the field, the
+        // invocation travels, and every transport carries it because every transport
+        // carries the invocation.
+        if (ctx.invocation)
+            ctx.invocation = { ...ctx.invocation, trace: traceparentOf(span) };
+        // Both, and they are not the same measurement: the wall clock says WHEN so two
+        // processes land on one timeline, the monotonic one says HOW LONG without being
+        // moved by an NTP correction mid-call.
+        const startedAt = Date.now();
+        const start = performance.now();
+        active += 1;
+        const finish = (error) => {
+            active -= 1;
+            const done = {
+                ...span,
+                parentId: parent?.spanId,
+                callerFrond,
+                frond: ctx.frond,
+                entity: ctx.entity,
+                operation: ctx.operation,
+                startedAt,
+                ms: performance.now() - start,
+                error,
+            };
+            // A sink that throws is a broken exporter, never a broken call.
+            for (const take of sinks) {
+                try {
+                    take(done);
+                }
+                catch { /* observing never refuses */ }
+            }
+        };
+        return traceContext.within(span, async () => {
+            try {
+                const result = await next();
+                finish(undefined);
+                return result;
+            }
+            catch (err) {
+                finish(codeOf(err));
+                throw err;
+            }
+        });
+    };
+}
+function codeOf(err) {
+    const code = err?.code;
+    return typeof code === 'string' ? code : (err?.name ?? 'error');
+}
+export { otlp } from './otlp.js';
+export { metrics, metricsPayload, serveTopology } from './metrics.js';
+export { logs } from './logs.js';
+export { observability } from './extension.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logs.d.ts

@@ -0,0 +1,32 @@
+import type { LogRecord } from '@fougere/core';
+/** A record, plus what it could only be told at the moment it was written. */
+export interface CapturedLog extends LogRecord {
+    traceId: string | undefined;
+    spanId: string | undefined;
+}
+export interface LogExporter {
+    /** Hand to `onLog`. */
+    sink: (record: LogRecord) => void;
+    /** Send what is buffered now. */
+    flush(): Promise<void>;
+    /** Stop the timer and send what is left. */
+    stop(): Promise<void>;
+}
+export interface LogsOptions {
+    /** Which service these lines belong to. */
+    service: string;
+    /** Collector endpoint. Default: the OTLP/HTTP convention on localhost. */
+    url?: string;
+    /** How often a batch leaves. Default: every second. */
+    flushMs?: number;
+    /** Told when a batch could not be sent. Default: silence. */
+    onError?: (err: unknown) => void;
+    /**
+     * Drop anything below this level before it leaves the process. Absent means "whatever
+     * the logger let through" — `setLogLevel` has already filtered, and a second threshold
+     * here would be a second place where the level lives.
+     */
+    minimum?: 'debug' | 'info' | 'warn' | 'error';
+}
+export declare function logs(options: LogsOptions): LogExporter;
+//# sourceMappingURL=logs.d.ts.map

package/dist/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAU/C,8EAA8E;AAC9E,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAClC,iCAAiC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,4CAA4C;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC/C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAqCtD"}

package/dist/logs.js

@@ -0,0 +1,112 @@
+/**
+ * Log export — the third signal, and the only one whose value is entirely in its links.
+ *
+ * A log shipped without a trace id is a log stored somewhere else. What makes it the third
+ * pillar is landing on a trace and reading the lines that call produced, so every record
+ * leaves with the span it was written inside — which this package knows and the logger
+ * deliberately does not.
+ *
+ * The logger emits a structured record and nothing more (`onLog` in core). Attaching the
+ * trace, naming the severity and speaking OTLP all happen here.
+ */
+import { currentSpan } from './index.js';
+/** OTLP severity numbers — the scale is 1–24, these are the canonical rungs. */
+const SEVERITY = {
+    debug: { number: 5, text: 'DEBUG' },
+    info: { number: 9, text: 'INFO' },
+    warn: { number: 13, text: 'WARN' },
+    error: { number: 17, text: 'ERROR' },
+};
+export function logs(options) {
+    const url = options.url ?? 'http://localhost:4318/v1/logs';
+    const floor = options.minimum ? SEVERITY[options.minimum].number : 0;
+    let buffer = [];
+    async function flush() {
+        if (buffer.length === 0)
+            return;
+        const batch = buffer;
+        buffer = [];
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(payload(options.service, batch)),
+            });
+            if (!response.ok)
+                options.onError?.(new Error(`${url} answered HTTP ${response.status}`));
+        }
+        catch (err) {
+            options.onError?.(err);
+        }
+    }
+    const every = options.flushMs ?? 1_000;
+    // Same rule as the span exporter: a timer at module scope makes a Worker undeployable.
+    const timer = every > 0 ? setInterval(() => void flush(), every) : undefined;
+    timer?.unref?.();
+    return {
+        // The span is read HERE, while the line is being written — not at flush time, when
+        // the call it belongs to is long over and the context is somebody else's.
+        sink: (record) => {
+            if (SEVERITY[record.level].number < floor)
+                return;
+            const span = currentSpan();
+            buffer.push({ ...record, traceId: span?.traceId, spanId: span?.spanId });
+        },
+        flush,
+        stop: async () => { if (timer)
+            clearInterval(timer); await flush(); },
+    };
+}
+/** One batch, as OTLP/JSON spells logs. */
+function payload(service, records) {
+    const attr = (key, value) => ({ key, value: { stringValue: value } });
+    return {
+        resourceLogs: [
+            {
+                resource: { attributes: [attr('service.name', service)] },
+                scopeLogs: [
+                    {
+                        scope: { name: '@fougere/observability' },
+                        logRecords: records.map((record) => {
+                            const severity = SEVERITY[record.level];
+                            return {
+                                timeUnixNano: `${record.at * 1e6}`,
+                                observedTimeUnixNano: `${record.at * 1e6}`,
+                                severityNumber: severity.number,
+                                severityText: severity.text,
+                                body: { stringValue: bodyOf(record) },
+                                attributes: [attr('logger.name', record.name)],
+                                // Absent when the line was written outside any call — a boot line, a
+                                // shutdown line. Absent is the honest answer, not a zeroed id.
+                                ...(record.traceId ? { traceId: record.traceId } : {}),
+                                ...(record.spanId ? { spanId: record.spanId } : {}),
+                            };
+                        }),
+                    },
+                ],
+            },
+        ],
+    };
+}
+/**
+ * The message with its arguments folded in. A log call takes extras the way `console`
+ * does, and a collector stores one body — so they are joined rather than dropped.
+ */
+function bodyOf(record) {
+    if (record.args.length === 0)
+        return record.message;
+    return [record.message, ...record.args.map(readable)].join(' ');
+}
+function readable(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value instanceof Error)
+        return `${value.name}: ${value.message}`;
+    try {
+        return JSON.stringify(value) ?? String(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,gFAAgF;AAChF,MAAM,QAAQ,GAAqD;IACjE,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE;IACnC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;IACjC,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IAClC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;CACrC,CAAC;AAkCF,MAAM,UAAU,IAAI,CAAC,OAAoB;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,+BAA+B,CAAC;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,MAAM,GAAkB,EAAE,CAAC;IAE/B,KAAK,UAAU,KAAK;QAClB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC;QACrB,MAAM,GAAG,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;aACtD,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,kBAAkB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC5F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;IACvC,uFAAuF;IACvF,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;IAEjB,OAAO;QACL,mFAAmF;QACnF,0EAA0E;QAC1E,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,KAAK;gBAAE,OAAO;YAClD,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,KAAK;QACL,IAAI,EAAE,KAAK,IAAI,EAAE,GAAG,IAAI,KAAK;YAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC;KACtE,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,SAAS,OAAO,CAAC,OAAe,EAAE,OAAsB;IACtD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAEtF,OAAO;QACL,YAAY,EAAE;YACZ;gBACE,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,EAAE;gBACzD,SAAS,EAAE;oBACT;wBACE,KAAK,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE;wBACzC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;4BACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;4BACxC,OAAO;gCACL,YAAY,EAAE,GAAG,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE;gCAClC,oBAAoB,EAAE,GAAG,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE;gCAC1C,cAAc,EAAE,QAAQ,CAAC,MAAM;gCAC/B,YAAY,EAAE,QAAQ,CAAC,IAAI;gCAC3B,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE;gCACrC,UAAU,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gCAC9C,qEAAqE;gCACrE,+DAA+D;gCAC/D,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gCACtD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;6BACpD,CAAC;wBACJ,CAAC,CAAC;qBACH;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,MAAM,CAAC,MAAmB;IACjC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IACpD,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACrE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/metrics.d.ts

@@ -0,0 +1,86 @@
+/**
+ * The four signals every service is judged on, derived from the span that already exists.
+ *
+ * Rate, errors and duration are ONE metric — a histogram of durations, dimensioned by
+ * the op and by whether it refused. Its `count` is the rate, its dimension is the error
+ * rate, its buckets are the latency: that is how OpenTelemetry spells
+ * `http.server.request.duration`, and splitting it into three counters would publish the
+ * same numbers three times and let them disagree.
+ *
+ * The fourth — saturation — cannot come from a finished span, because it is about the
+ * ones that have NOT finished. The middleware counts it, `activeCalls()` reads it.
+ *
+ * Cardinality is bounded by construction: entity × operation × {ok, error}, all of them
+ * declared in the code. Nothing carrying an id, a user or a trace ever becomes a
+ * dimension — that is the one mistake a metrics layer cannot recover from.
+ */
+import type { App, Edge, FrondPlacement } from '@fougere/core';
+export type { Edge, FrondPlacement, TopologyReport } from '@fougere/core';
+import { type SpanSink } from './index.js';
+interface Bucketed {
+    frond: string | undefined;
+    entity: string;
+    operation: string;
+    error: string | undefined;
+    count: number;
+    sum: number;
+    /** One more than the bounds: the last holds everything above the highest bound. */
+    buckets: number[];
+}
+export interface Metrics {
+    /** Hand to `onSpan` — it reads the same span the tracer reads. */
+    sink: SpanSink;
+    /** What to publish now. */
+    snapshot(): MetricsSnapshot;
+}
+export interface MetricsSnapshot {
+    /** When this process started counting — cumulative metrics are read against it. */
+    since: number;
+    series: Bucketed[];
+    active: number;
+    bounds: number[];
+    /** The shape of the system as this process discovered it — declared nowhere. */
+    topology: FrondPlacement[];
+    /** Who calls whom, as observed here. Bounded by fronds², so it is a safe dimension. */
+    edges: Edge[];
+}
+/**
+ * `app` is optional and only feeds the topology: what fronds this process found, and
+ * which of them run elsewhere. Read from the scan, so it is DISCOVERED — a frond that
+ * appears is on the dashboard without anyone declaring it there.
+ */
+export declare function metrics(app?: App): Metrics;
+/**
+ * Serve the topology on `rpc.topology` — read from inside the process it describes.
+ *
+ * This is why observability is not a frond: a frond may move behind `remotes:`, and moved,
+ * this one would report the observer's process instead of the observed one. The op exists
+ * exactly when this package is wired, so an app that installed none refuses it by name.
+ */
+export declare function serveTopology(app: App, measured: Metrics): void;
+/** One snapshot, as OTLP/JSON spells metrics. Cumulative, which is what Prometheus reads. */
+export declare function metricsPayload(service: string, snapshot: MetricsSnapshot): {
+    resourceMetrics: {
+        resource: {
+            attributes: {
+                key: string;
+                value: {
+                    stringValue: string;
+                };
+            }[];
+        };
+        scopeMetrics: {
+            scope: {
+                name: string;
+            };
+            /**
+             * Only what has points. A metric with an empty `dataPoints` makes a
+             * collector reject the WHOLE batch — measured: Prometheus answers 500 and
+             * every other metric in the payload is lost with it. A process that calls
+             * nobody has no edges, which is ordinary, not a reason to publish nothing.
+             */
+            metrics: Record<string, any>[];
+        }[];
+    }[];
+};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc,EAAkB,MAAM,eAAe,CAAC;AAE/E,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAkC,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ3E,UAAU,QAAQ;IAChB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,kEAAkE;IAClE,IAAI,EAAE,QAAQ,CAAC;IACf,2BAA2B;IAC3B,QAAQ,IAAI,eAAe,CAAC;CAC7B;AAGD,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gFAAgF;IAChF,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,uFAAuF;IACvF,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CA8C1C;AAmCD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAK/D;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe;;;YAQrD,UAAU;;;oBALkC,WAAW;;;;;;gBAQtD,IAAI;;YACb;;;;;eAKG;;;;EAkGd"}

package/dist/metrics.js.map

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

package/dist/otlp.d.ts

@@ -0,0 +1,42 @@
+/**
+ * OTLP export — the spans this process finished, in the one shape every collector reads.
+ *
+ * OTLP has a JSON encoding over plain HTTP, so this needs no protobuf and no dependency:
+ * a POST to `/v1/traces`, and Jaeger, Tempo, Datadog or Honeycomb ingest it as-is.
+ *
+ * It is a sink and nothing more — `onSpan(otlp({...}).sink)` is the whole wiring. What
+ * a span IS was decided by the middleware; this file only renames its fields.
+ */
+import type { SpanSink } from './index.js';
+import { type Metrics } from './metrics.js';
+export interface OtlpOptions {
+    /** Which service these spans belong to — what a dashboard groups by. */
+    service: string;
+    /** Collector endpoint. Default: the OTLP/HTTP convention on localhost. */
+    url?: string;
+    /** How often a full batch leaves. Default: every second. */
+    flushMs?: number;
+    /** Told when a batch could not be sent. Default: silence — a trace must never break a call. */
+    onError?: (err: unknown) => void;
+    /**
+     * Publish these metrics on the same beat.
+     *
+     * Their endpoint defaults to the traces one with its last segment swapped — the OTLP
+     * convention when a single collector takes both. Name `metricsUrl` when they are two:
+     * traces and metrics are stored by different engines, and a deployment is free to run
+     * one of each rather than a collector in front.
+     */
+    metrics?: Metrics;
+    /** Where metrics go when it is not the same collector as traces. */
+    metricsUrl?: string;
+}
+export interface OtlpExporter {
+    /** Hand to `onSpan`. */
+    sink: SpanSink;
+    /** Send what is buffered now — a process about to exit has to call this. */
+    flush(): Promise<void>;
+    /** Stop the timer and send what is left. */
+    stop(): Promise<void>;
+}
+export declare function otlp(options: OtlpOptions): OtlpExporter;
+//# sourceMappingURL=otlp.d.ts.map

package/dist/otlp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp.d.ts","sourceRoot":"","sources":["../src/otlp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAgB,QAAQ,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,4EAA4E;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,4CAA4C;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAMD,wBAAgB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CA+CvD"}

package/dist/otlp.js

@@ -0,0 +1,81 @@
+import { metricsPayload } from './metrics.js';
+/** OTLP status codes: 0 unset, 1 ok, 2 error. */
+const OK = 1;
+const ERROR = 2;
+export function otlp(options) {
+    const url = options.url ?? 'http://localhost:4318/v1/traces';
+    const metricsUrl = options.metricsUrl ?? url.replace(/\/v1\/traces$/, '/v1/metrics');
+    let buffer = [];
+    async function post(to, body) {
+        try {
+            const response = await fetch(to, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok)
+                options.onError?.(new Error(`${to} answered HTTP ${response.status}`));
+        }
+        catch (err) {
+            options.onError?.(err);
+        }
+    }
+    async function flush() {
+        const batch = buffer;
+        buffer = [];
+        // Metrics go on every beat even when no span finished: a gauge that stops being
+        // published reads as "gone", not as "idle".
+        await Promise.all([
+            batch.length > 0 ? post(url, payload(options.service, batch)) : Promise.resolve(),
+            options.metrics ? post(metricsUrl, metricsPayload(options.service, options.metrics.snapshot())) : Promise.resolve(),
+        ]);
+    }
+    // `flushMs: 0` means "nobody is on a timer here, I will say when" — and on a Worker it
+    // is not a preference, it is the only legal form: Cloudflare REFUSES a deployment whose
+    // module scope sets a timeout ("Disallowed operation called within global scope"), and
+    // an app built at module scope builds its exporter there. Measured 2026-08-23, the
+    // deploy failed with error 10021. The isolate is frozen at the response anyway, so the
+    // timer could never have fired; `ctx.waitUntil(flushTelemetry())` is what sends.
+    //
+    // `unref` so a buffered span never keeps a process alive: exporting is something the
+    // process does on its way, never a reason for it to stay.
+    const every = options.flushMs ?? 1_000;
+    const timer = every > 0 ? setInterval(() => void flush(), every) : undefined;
+    timer?.unref?.();
+    return {
+        sink: (span) => { buffer.push(span); },
+        flush,
+        stop: async () => { if (timer)
+            clearInterval(timer); await flush(); },
+    };
+}
+/** One batch, as OTLP/JSON spells it — trace and span ids stay hex, times are nanos. */
+function payload(service, spans) {
+    return {
+        resourceSpans: [
+            {
+                resource: { attributes: [{ key: 'service.name', value: { stringValue: service } }] },
+                scopeSpans: [
+                    {
+                        scope: { name: '@fougere/observability' },
+                        spans: spans.map((span) => ({
+                            traceId: span.traceId,
+                            spanId: span.spanId,
+                            ...(span.parentId ? { parentSpanId: span.parentId } : {}),
+                            name: `${span.entity}.${span.operation}`,
+                            kind: 1,
+                            startTimeUnixNano: nanos(span.startedAt),
+                            endTimeUnixNano: nanos(span.startedAt + span.ms),
+                            status: span.error ? { code: ERROR, message: span.error } : { code: OK },
+                        })),
+                    },
+                ],
+            },
+        ],
+    };
+}
+/** Epoch milliseconds → the int64 nanoseconds OTLP wants, as a string. */
+function nanos(ms) {
+    return `${Math.round(ms * 1e6)}`;
+}
+//# sourceMappingURL=otlp.js.map

package/dist/otlp.js.map

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

package/dist/traceparent.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `traceparent` — the one form a trace takes between two processes (W3C Trace Context).
+ *
+ * A standard rather than ours, so any collector reads it. It rides `InvocationContext.trace`
+ * and never a header: a header is HTTP's alone, and the same call over a socket would have
+ * arrived untraced.
+ *
+ * Pure — no runtime, no node builtin. What holds the CURRENT trace is `index.ts`, and the
+ * line between the two is the line between a format and the thing that carries it.
+ */
+/** A step in a trace, as both halves of a split agree on it. */
+export interface SpanContext {
+    /** The whole call, across every process. 32 hex. */
+    traceId: string;
+    /** This step. 16 hex. */
+    spanId: string;
+    /** Whether the collector was asked to keep it. */
+    sampled: boolean;
+}
+/** The header a caller writes so the other side joins this trace. */
+export declare function traceparentOf(span: SpanContext): string;
+/** The header as a context, or nothing — a malformed one is ignored, never fatal. */
+export declare function parseTraceparent(header: string | undefined): SpanContext | undefined;
+/** A trace id (16) or a span id (8), as the spec sizes them. */
+export declare function randomHex(bytes: number): string;
+//# sourceMappingURL=traceparent.d.ts.map

package/dist/traceparent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceparent.d.ts","sourceRoot":"","sources":["../src/traceparent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAEvD;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAOpF;AAID,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/C"}

package/dist/traceparent.js

@@ -0,0 +1,38 @@
+/**
+ * `traceparent` — the one form a trace takes between two processes (W3C Trace Context).
+ *
+ * A standard rather than ours, so any collector reads it. It rides `InvocationContext.trace`
+ * and never a header: a header is HTTP's alone, and the same call over a socket would have
+ * arrived untraced.
+ *
+ * Pure — no runtime, no node builtin. What holds the CURRENT trace is `index.ts`, and the
+ * line between the two is the line between a format and the thing that carries it.
+ */
+const TRACEPARENT = /^00-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
+const NO_TRACE = '0'.repeat(32);
+const NO_SPAN = '0'.repeat(16);
+/** The header a caller writes so the other side joins this trace. */
+export function traceparentOf(span) {
+    return `00-${span.traceId}-${span.spanId}-${span.sampled ? '01' : '00'}`;
+}
+/** The header as a context, or nothing — a malformed one is ignored, never fatal. */
+export function parseTraceparent(header) {
+    const found = typeof header === 'string' ? TRACEPARENT.exec(header.trim()) : null;
+    if (!found)
+        return undefined;
+    const [, traceId, spanId, flags] = found;
+    if (traceId === NO_TRACE || spanId === NO_SPAN)
+        return undefined;
+    return { traceId, spanId, sampled: (parseInt(flags, 16) & 1) === 1 };
+}
+const HEX = '0123456789abcdef';
+/** A trace id (16) or a span id (8), as the spec sizes them. */
+export function randomHex(bytes) {
+    const buffer = new Uint8Array(bytes);
+    crypto.getRandomValues(buffer);
+    let out = '';
+    for (const byte of buffer)
+        out += HEX[byte >> 4] + HEX[byte & 15];
+    return out;
+}
+//# sourceMappingURL=traceparent.js.map

package/dist/traceparent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceparent.js","sourceRoot":"","sources":["../src/traceparent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,MAAM,WAAW,GAAG,kDAAkD,CAAC;AACvE,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAChC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE/B,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,OAAO,MAAM,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3E,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,gBAAgB,CAAC,MAA0B;IACzD,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;IACzC,IAAI,OAAO,KAAK,QAAQ,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACjE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,GAAG,GAAG,kBAAkB,CAAC;AAE/B,gEAAgE;AAChE,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,IAAI,IAAI,MAAM;QAAE,GAAG,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAClE,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@fougere/observability",
+  "version": "0.3.0-alpha.0",
+  "description": "Optional observability for Fougere: one span per operation, W3C Trace Context across any transport.",
+  "keywords": [
+    "fougere",
+    "typescript",
+    "tracing",
+    "observability",
+    "opentelemetry",
+    "trace-context"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chok/fougere.git",
+    "directory": "packages/observability"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@fougere/core": "^0.3.0-alpha.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.0",
+    "@fougere/container": "0.3.0-alpha.0",
+    "@fougere/schema": "0.3.0-alpha.0",
+    "@fougere/transport-http": "0.3.0-alpha.0",
+    "@fougere/core": "0.3.0-alpha.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "imports": {
+    "#trace-context": {
+      "types": "./src/context/als.ts",
+      "workerd": "./dist/context/none.js",
+      "default": "./dist/context/als.js"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json"
+  }
+}