live-traces 0.1.0

package/dist/src/Sink.d.ts

@@ -0,0 +1,36 @@
+/**
+ * TraceSink — Buffered event sink with pluggable transport.
+ *
+ * The sink has two parts:
+ * - TraceSinkHandle: synchronous emit() for use inside Tracer.span() (which is sync)
+ * - TraceSink: Effect service that manages the handle + flush daemon
+ *
+ * TraceTransport: pluggable backend (Durable Streams, SSE, WebSocket, console, etc.)
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import type { TraceEvent } from "./types.js";
+export interface TraceTransport {
+    /** Send a batch of events. Called periodically by the flush daemon. */
+    readonly send: (events: ReadonlyArray<TraceEvent>) => Effect.Effect<void>;
+}
+declare const TraceTransportTag_base: Context.TagClass<TraceTransportTag, "@live-traces/TraceTransport", TraceTransport>;
+export declare class TraceTransportTag extends TraceTransportTag_base {
+}
+export interface TraceSinkHandle {
+    /** Synchronous, non-blocking. Buffers internally. */
+    readonly emit: (event: TraceEvent) => void;
+}
+declare const TraceSink_base: Context.TagClass<TraceSink, "@live-traces/TraceSink", TraceSinkHandle>;
+export declare class TraceSink extends TraceSink_base {
+}
+export interface TraceSinkConfig {
+    /** Flush interval in milliseconds. Default: 200 */
+    readonly flushIntervalMs?: number;
+}
+export declare const TraceSinkLive: (config?: TraceSinkConfig) => Layer.Layer<TraceSink, never, TraceTransportTag>;
+export declare const ConsoleTransport: TraceTransport;
+export declare const ConsoleTransportLayer: Layer.Layer<TraceTransportTag>;
+export {};
+//# sourceMappingURL=Sink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Sink.d.ts","sourceRoot":"","sources":["../../src/Sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,MAAM,WAAW,cAAc;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAC7E;;AAED,qBAAa,iBAAkB,SAAQ,sBAA+E;CAAG;AAMzH,MAAM,WAAW,eAAe;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CAC9C;;AAMD,qBAAa,SAAU,SAAQ,cAAmE;CAAG;AAMrG,MAAM,WAAW,eAAe;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,eAAe,KAAG,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,iBAAiB,CAwCnG,CAAC;AAMN,eAAO,MAAM,gBAAgB,EAAE,cAQ9B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAsD,CAAC"}

package/dist/src/Sink.js

@@ -0,0 +1,55 @@
+/**
+ * TraceSink — Buffered event sink with pluggable transport.
+ *
+ * The sink has two parts:
+ * - TraceSinkHandle: synchronous emit() for use inside Tracer.span() (which is sync)
+ * - TraceSink: Effect service that manages the handle + flush daemon
+ *
+ * TraceTransport: pluggable backend (Durable Streams, SSE, WebSocket, console, etc.)
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schedule from "effect/Schedule";
+export class TraceTransportTag extends Context.Tag("@live-traces/TraceTransport")() {
+}
+// ============================================================================
+// TraceSink — Effect service managing buffer + flush lifecycle
+// ============================================================================
+export class TraceSink extends Context.Tag("@live-traces/TraceSink")() {
+}
+export const TraceSinkLive = (config) => Layer.scoped(TraceSink, Effect.gen(function* () {
+    const transport = yield* TraceTransportTag;
+    const intervalMs = config?.flushIntervalMs ?? 200;
+    let buffer = [];
+    const flush = Effect.suspend(() => {
+        if (buffer.length === 0)
+            return Effect.void;
+        const batch = buffer;
+        buffer = [];
+        return transport.send(batch);
+    });
+    // Daemon fiber: flush every intervalMs
+    yield* flush.pipe(Effect.schedule(Schedule.spaced(intervalMs)), Effect.catchAllCause((cause) => Effect.logDebug("live-traces flush daemon error").pipe(Effect.annotateLogs("cause", String(cause)))), Effect.forkScoped);
+    // Final flush on scope close
+    yield* Effect.addFinalizer(() => flush.pipe(Effect.catchAllCause((cause) => Effect.logDebug("live-traces finalizer flush error").pipe(Effect.annotateLogs("cause", String(cause))))));
+    const handle = {
+        emit: (event) => {
+            buffer.push(event);
+        },
+    };
+    return handle;
+}));
+// ============================================================================
+// Console transport — for development/debugging
+// ============================================================================
+export const ConsoleTransport = {
+    send: (events) => Effect.sync(() => {
+        for (const event of events) {
+            // eslint-disable-next-line no-console
+            console.log(`[live-trace] ${event._tag}`, JSON.stringify(event));
+        }
+    }),
+};
+export const ConsoleTransportLayer = Layer.succeed(TraceTransportTag, ConsoleTransport);
+//# sourceMappingURL=Sink.js.map

package/dist/src/Sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sink.js","sourceRoot":"","sources":["../../src/Sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAa5C,MAAM,OAAO,iBAAkB,SAAQ,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,EAAqC;CAAG;AAWzH,+EAA+E;AAC/E,+DAA+D;AAC/D,+EAA+E;AAE/E,MAAM,OAAO,SAAU,SAAQ,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAA8B;CAAG;AAWrG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAwB,EAAoD,EAAE,CACxG,KAAK,CAAC,MAAM,CACR,SAAS,EACT,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAChB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,iBAAiB,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,EAAE,eAAe,IAAI,GAAG,CAAC;IAElD,IAAI,MAAM,GAAiB,EAAE,CAAC;IAE9B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;QAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC;QACrB,MAAM,GAAG,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,uCAAuC;IACvC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CACb,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,EAC5C,MAAM,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACpI,MAAM,CAAC,UAAU,CACpB,CAAC;IAEF,6BAA6B;IAC7B,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAC5B,KAAK,CAAC,IAAI,CACN,MAAM,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3B,MAAM,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CACzG,CACJ,CACJ,CAAC;IAEF,MAAM,MAAM,GAAoB;QAC5B,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;YACZ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;KACJ,CAAC;IAEF,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC,CACL,CAAC;AAEN,+EAA+E;AAC/E,gDAAgD;AAChD,+EAA+E;AAE/E,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC5C,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CACb,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACb,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,CAAC;IACL,CAAC,CAAC;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAmC,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/src/Tracer.d.ts

@@ -0,0 +1,24 @@
+import * as Layer from "effect/Layer";
+import { TraceSink } from "./Sink.js";
+/**
+ * Creates a LiveTraceLayer that wraps the current tracer.
+ *
+ * **Important**: This layer reads the current tracer from the FiberRef
+ * at build time via `Effect.tracerWith`. For it to wrap the OTel tracer,
+ * TelemetryLive (or any layer that calls `Layer.setTracer`) must be
+ * built BEFORE this layer. In a `Layer.provideMerge` pipe chain, that
+ * means TelemetryLive should appear AFTER (outer) this layer:
+ *
+ * @example
+ * ```ts
+ * const EnvLayer = ServerLive.pipe(
+ *   Layer.provideMerge(ServicesLayer),
+ *   // LiveTraceLayer BEFORE TelemetryLive in pipe = builds AFTER
+ *   Layer.provideMerge(makeLiveTraceLayer()),
+ *   // TelemetryLive AFTER in pipe = builds FIRST (sets OTel tracer)
+ *   Layer.provideMerge(TelemetryLive),
+ * )
+ * ```
+ */
+export declare const LiveTraceLayer: Layer.Layer<never, never, TraceSink>;
+//# sourceMappingURL=Tracer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tracer.d.ts","sourceRoot":"","sources":["../../src/Tracer.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,EAAE,SAAS,EAAwB,MAAM,WAAW,CAAC;AAI5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CA2D/D,CAAC"}

package/dist/src/Tracer.js

@@ -0,0 +1,154 @@
+/**
+ * LiveTraceLayer — Effect Tracer decorator.
+ *
+ * Wraps whatever base tracer is in DefaultServices (native or OTel).
+ * Intercepts span creation within `LiveTrace.withTrace()` scopes
+ * and emits TraceEvents to a TraceSink.
+ *
+ * - Works standalone (no @effect/opentelemetry needed)
+ * - Works alongside OTel (wraps the OTel tracer, both systems run)
+ * - Zero FiberRef access in Tracer.span() — uses parent chain + attributes
+ *
+ * ## Layer composition: why ordering matters
+ *
+ * `Layer.setTracer` modifies the `currentServices` FiberRef — each call
+ * overwrites the previous tracer. When composing via `Layer.provideMerge`,
+ * the argument (`self`) is built FIRST. In a pipe chain:
+ *
+ * ```
+ * X.pipe(Layer.provideMerge(A), Layer.provideMerge(B))
+ * ```
+ *
+ * Build order: B (outermost self) → A (inner self) → X
+ *
+ * For LiveTraceLayer to wrap OTel's tracer, TelemetryLive must build
+ * BEFORE LiveTraceLayer so that `Effect.tracerWith` captures the OTel
+ * tracer. This means TelemetryLive must be OUTER (later in the pipe)
+ * and LiveTraceLayer must be INNER (earlier in the pipe):
+ *
+ * ```ts
+ * X.pipe(
+ *   Layer.provideMerge(makeLiveTraceLayer()), // inner: builds 2nd, wraps OTel
+ *   Layer.provideMerge(TelemetryLive),        // outer: builds 1st, sets OTel
+ * )
+ * ```
+ */
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Tracer from "effect/Tracer";
+import { TraceSink } from "./Sink.js";
+import { LIVE_TRACE, LIVE_TRACE_ID, LIVE_TRACE_SCOPE_ID, LIVE_TRACE_SCOPE_TYPE } from "./types.js";
+import { isWrappedSpan, shouldExclude, WrappedSpan } from "./WrappedSpan.js";
+/**
+ * Creates a LiveTraceLayer that wraps the current tracer.
+ *
+ * **Important**: This layer reads the current tracer from the FiberRef
+ * at build time via `Effect.tracerWith`. For it to wrap the OTel tracer,
+ * TelemetryLive (or any layer that calls `Layer.setTracer`) must be
+ * built BEFORE this layer. In a `Layer.provideMerge` pipe chain, that
+ * means TelemetryLive should appear AFTER (outer) this layer:
+ *
+ * @example
+ * ```ts
+ * const EnvLayer = ServerLive.pipe(
+ *   Layer.provideMerge(ServicesLayer),
+ *   // LiveTraceLayer BEFORE TelemetryLive in pipe = builds AFTER
+ *   Layer.provideMerge(makeLiveTraceLayer()),
+ *   // TelemetryLive AFTER in pipe = builds FIRST (sets OTel tracer)
+ *   Layer.provideMerge(TelemetryLive),
+ * )
+ * ```
+ */
+export const LiveTraceLayer = Layer.unwrapEffect(Effect.gen(function* () {
+    // Capture the current tracer from DefaultServices FiberRef.
+    // When composed correctly (TelemetryLive outer, us inner),
+    // this captures the OTel tracer. When standalone, this
+    // captures the native tracer.
+    const baseTracer = yield* Effect.tracerWith(Effect.succeed);
+    const sink = yield* TraceSink;
+    const wrappedTracer = Tracer.make({
+        span(name, parent, context, links, startTime, kind, options) {
+            // Create the inner span via the base tracer (OTel or native)
+            const innerSpan = baseTracer.span(name, parent, context, links, startTime, kind, options);
+            // Should we exclude this span from live tracing?
+            if (shouldExclude(options?.attributes)) {
+                return innerSpan;
+            }
+            // Check: is this the root of a live-traced scope?
+            if (options?.attributes?.[LIVE_TRACE] === true) {
+                return createRootWrappedSpan(innerSpan, sink, options.attributes);
+            }
+            // Check: is the parent a WrappedSpan? (inside a traced scope)
+            if (Option.isSome(parent) && isWrappedSpan(parent.value)) {
+                const parentWrapped = parent.value;
+                const wrapped = new WrappedSpan(innerSpan, sink, parentWrapped.liveTraceId, parentWrapped.liveScope);
+                // IMPORTANT: options.attributes (e.g. "ui.step") are applied by Effect
+                // AFTER tracer.span() returns. innerSpan.attributes is empty at this point.
+                // We must include options.attributes directly.
+                sink.emit({
+                    _tag: "SpanStart",
+                    traceId: parentWrapped.liveTraceId,
+                    spanId: innerSpan.spanId,
+                    parentSpanId: parentWrapped.spanId,
+                    name,
+                    attributes: { ...Object.fromEntries(innerSpan.attributes), ...options?.attributes },
+                    timestamp: Date.now(),
+                });
+                return wrapped;
+            }
+            // Not in a traced scope — pass through unchanged
+            return innerSpan;
+        },
+        context(f, fiber) {
+            // Delegate context propagation to the base tracer.
+            // This preserves OTel's OtelApi.context.with() behavior for
+            // W3C traceparent header propagation.
+            return baseTracer.context(f, fiber);
+        },
+    });
+    return Layer.setTracer(wrappedTracer);
+}));
+function createRootWrappedSpan(innerSpan, sink, attributes) {
+    const traceId = attributes[LIVE_TRACE_ID];
+    const scope = {
+        type: attributes[LIVE_TRACE_SCOPE_TYPE] ?? "user",
+        id: attributes[LIVE_TRACE_SCOPE_ID] ?? "unknown",
+    };
+    // Emit TraceStart
+    sink.emit({
+        _tag: "TraceStart",
+        traceId,
+        label: attributes["live-trace.label"] ?? innerSpan.name,
+        scope,
+        timestamp: Date.now(),
+    });
+    // Emit SpanStart for the root span itself
+    // Include attributes from the options — Effect applies them AFTER tracer.span() returns
+    sink.emit({
+        _tag: "SpanStart",
+        traceId,
+        spanId: innerSpan.spanId,
+        name: innerSpan.name,
+        attributes: { ...Object.fromEntries(innerSpan.attributes), ...attributes },
+        timestamp: Date.now(),
+    });
+    const wrapped = new WrappedSpan(innerSpan, sink, traceId, scope);
+    // Override end to also emit TraceEnd after SpanEnd
+    const originalEnd = wrapped.end.bind(wrapped);
+    wrapped.end = (endTime, exit) => {
+        originalEnd(endTime, exit);
+        const startTime = innerSpan.status._tag === "Ended" ? innerSpan.status.startTime : BigInt(0);
+        const durationMs = Number(endTime - startTime) / 1_000_000;
+        sink.emit({
+            _tag: "TraceEnd",
+            traceId,
+            status: exit._tag === "Success" ? "completed" : "failed",
+            durationMs,
+            error: exit._tag === "Failure" ? String(exit.cause) : undefined,
+            timestamp: Date.now(),
+        });
+    };
+    return wrapped;
+}
+//# sourceMappingURL=Tracer.js.map

package/dist/src/Tracer.js.map

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

package/dist/src/WrappedSpan.d.ts

@@ -0,0 +1,44 @@
+/**
+ * WrappedSpan — Span decorator that intercepts lifecycle events.
+ *
+ * Implements the full Tracer.Span interface by delegating to an inner span
+ * (OTel or native) while emitting TraceEvents to a TraceSink.
+ *
+ * Detection: Use `isWrappedSpan(span)` to check if a span is wrapped.
+ * The Symbol brand avoids instanceof checks across package boundaries.
+ */
+import type { Context } from "effect/Context";
+import type { Exit } from "effect/Exit";
+import type { Option } from "effect/Option";
+import type { AnySpan, Span, SpanKind, SpanLink, SpanStatus } from "effect/Tracer";
+import type { TraceSinkHandle } from "./Sink.js";
+import type { TraceScope } from "./types.js";
+export declare const LiveTraceSymbol: unique symbol;
+export declare class WrappedSpan implements Span {
+    readonly inner: Span;
+    readonly sink: TraceSinkHandle;
+    readonly _tag: "Span";
+    readonly [LiveTraceSymbol] = true;
+    /** The logical trace ID for routing (e.g., "doc:abc123") */
+    readonly liveTraceId: string;
+    /** Scope for stream routing */
+    readonly liveScope: TraceScope;
+    constructor(inner: Span, sink: TraceSinkHandle, liveTraceId: string, liveScope: TraceScope);
+    get name(): string;
+    get spanId(): string;
+    get traceId(): string;
+    get parent(): Option<AnySpan>;
+    get context(): Context<never>;
+    get status(): SpanStatus;
+    get attributes(): ReadonlyMap<string, unknown>;
+    get links(): ReadonlyArray<SpanLink>;
+    get sampled(): boolean;
+    get kind(): SpanKind;
+    attribute(key: string, value: unknown): void;
+    event(name: string, startTime: bigint, attributes?: Record<string, unknown>): void;
+    end(endTime: bigint, exit: Exit<unknown, unknown>): void;
+    addLinks(links: ReadonlyArray<SpanLink>): void;
+}
+export declare const isWrappedSpan: (span: AnySpan) => span is WrappedSpan;
+export declare const shouldExclude: (attributes?: Record<string, unknown>) => boolean;
+//# sourceMappingURL=WrappedSpan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WrappedSpan.d.ts","sourceRoot":"","sources":["../../src/WrappedSpan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,eAAO,MAAM,eAAe,EAAE,OAAO,MAA+C,CAAC;AAErF,qBAAa,WAAY,YAAW,IAAI;IAWhC,QAAQ,CAAC,KAAK,EAAE,IAAI;IACpB,QAAQ,CAAC,IAAI,EAAE,eAAe;IAXlC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,CAAC,eAAe,CAAC,QAAQ;IAElC,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;gBAGlB,KAAK,EAAE,IAAI,EACX,IAAI,EAAE,eAAe,EAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,UAAU;IAQzB,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,OAAO,IAAI,MAAM,CAEpB;IACD,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,CAE5B;IACD,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,CAE5B;IACD,IAAI,MAAM,IAAI,UAAU,CAEvB;IACD,IAAI,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAE7C;IACD,IAAI,KAAK,IAAI,aAAa,CAAC,QAAQ,CAAC,CAEnC;IACD,IAAI,OAAO,IAAI,OAAO,CAErB;IACD,IAAI,IAAI,IAAI,QAAQ,CAEnB;IAID,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI5C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAgBlF,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI;IAiBxD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI;CAGjD;AAED,eAAO,MAAM,aAAa,GAAI,MAAM,OAAO,KAAG,IAAI,IAAI,WAAsC,CAAC;AAE7F,eAAO,MAAM,aAAa,GAAI,aAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAgD,CAAC"}

package/dist/src/WrappedSpan.js

@@ -0,0 +1,104 @@
+import { TRACE_INTERNAL } from "./types.js";
+export const LiveTraceSymbol = Symbol.for("@live-traces/WrappedSpan");
+export class WrappedSpan {
+    inner;
+    sink;
+    _tag = "Span";
+    [LiveTraceSymbol] = true;
+    /** The logical trace ID for routing (e.g., "doc:abc123") */
+    liveTraceId;
+    /** Scope for stream routing */
+    liveScope;
+    constructor(inner, sink, liveTraceId, liveScope) {
+        this.inner = inner;
+        this.sink = sink;
+        this.liveTraceId = liveTraceId;
+        this.liveScope = liveScope;
+    }
+    // -- Delegated reads --
+    get name() {
+        return this.inner.name;
+    }
+    get spanId() {
+        return this.inner.spanId;
+    }
+    get traceId() {
+        return this.inner.traceId;
+    }
+    get parent() {
+        return this.inner.parent;
+    }
+    get context() {
+        return this.inner.context;
+    }
+    get status() {
+        return this.inner.status;
+    }
+    get attributes() {
+        return this.inner.attributes;
+    }
+    get links() {
+        return this.inner.links;
+    }
+    get sampled() {
+        return this.inner.sampled;
+    }
+    get kind() {
+        return this.inner.kind;
+    }
+    // -- Intercepted mutations --
+    attribute(key, value) {
+        this.inner.attribute(key, value);
+    }
+    event(name, startTime, attributes) {
+        this.inner.event(name, startTime, attributes);
+        // Emit as SpanEvent to sink
+        const level = attributes?.["effect.logLevel"];
+        this.sink.emit({
+            _tag: "SpanEvent",
+            traceId: this.liveTraceId,
+            spanId: this.spanId,
+            name,
+            level: normalizeLevel(level),
+            attributes,
+            timestamp: Date.now(),
+        });
+    }
+    end(endTime, exit) {
+        this.inner.end(endTime, exit);
+        const startTime = this.inner.status._tag === "Ended" ? this.inner.status.startTime : BigInt(0);
+        const durationMs = Number(endTime - startTime) / 1_000_000;
+        const status = exit._tag === "Success" ? "ok" : "error";
+        this.sink.emit({
+            _tag: "SpanEnd",
+            traceId: this.liveTraceId,
+            spanId: this.spanId,
+            status,
+            durationMs,
+            timestamp: Date.now(),
+        });
+    }
+    addLinks(links) {
+        this.inner.addLinks(links);
+    }
+}
+export const isWrappedSpan = (span) => LiveTraceSymbol in span;
+export const shouldExclude = (attributes) => attributes?.[TRACE_INTERNAL] === true;
+function normalizeLevel(level) {
+    if (!level)
+        return undefined;
+    switch (level) {
+        case "DEBUG":
+            return "Debug";
+        case "INFO":
+            return "Info";
+        case "WARNING":
+        case "WARN":
+            return "Warning";
+        case "ERROR":
+            return "Error";
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=WrappedSpan.js.map

package/dist/src/WrappedSpan.js.map

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

package/dist/src/transports/sse.d.ts

@@ -0,0 +1,26 @@
+import * as Layer from "effect/Layer";
+import type { TraceEvent, TraceScope } from "../types.js";
+import { TraceTransportTag } from "../Sink.js";
+type Subscriber = (events: ReadonlyArray<TraceEvent>) => void;
+/**
+ * In-process pub/sub broker. Routes trace events to subscribers keyed by
+ * `scope.type/scope.id`. A subscriber for `team/abc` receives only events
+ * for that team's traces.
+ */
+export declare class SseBroker {
+    private readonly subscribers;
+    private readonly scopeByTraceId;
+    private key;
+    /** Subscribe to events for a specific scope. Returns an unsubscribe fn. */
+    subscribe(scope: TraceScope, listener: Subscriber): () => void;
+    /** Publish a batch - fan out per scope. Called by the transport. */
+    publish(events: ReadonlyArray<TraceEvent>): void;
+    /** Active subscriber count for a scope (useful for tests / metrics). */
+    subscriberCount(scope: TraceScope): number;
+}
+/** Singleton broker. Same instance is used by transport + HTTP handlers. */
+export declare function getSseBroker(): SseBroker;
+/** Effect Layer wiring the SSE transport into the trace sink. */
+export declare const SSETransportLayer: Layer.Layer<TraceTransportTag>;
+export {};
+//# sourceMappingURL=sse.d.ts.map

package/dist/src/transports/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/transports/sse.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAuB,MAAM,YAAY,CAAC;AAEpE,KAAK,UAAU,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;AAE9D;;;;GAIG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;IAEhE,OAAO,CAAC,GAAG;IAIX,2EAA2E;IAC3E,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,IAAI;IAgB9D,oEAAoE;IACpE,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,IAAI;IAgChD,wEAAwE;IACxE,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;CAG7C;AAID,4EAA4E;AAC5E,wBAAgB,YAAY,IAAI,SAAS,CAGxC;AASD,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAkD,CAAC"}

package/dist/src/transports/sse.js

@@ -0,0 +1,118 @@
+/**
+ * SSE TraceTransport - Server-Sent Events transport.
+ *
+ * Pushes batched trace events into an in-process broker. The broker fans
+ * batches out to any number of subscribers (HTTP connections holding an
+ * `EventSource`). Stream routing is per-`TraceScope` - a subscriber gets
+ * only events for the scope it subscribed to.
+ *
+ * ```ts
+ * import { Layer } from "effect";
+ * import {
+ *   LiveTraceLayer, TraceSinkLive,
+ *   SSETransportLayer, getSseBroker,
+ * } from "live-traces";
+ *
+ * // Server layer
+ * const TraceLive = LiveTraceLayer.pipe(
+ *   Layer.provide(TraceSinkLive({ flushIntervalMs: 100 })),
+ *   Layer.provide(SSETransportLayer),
+ * );
+ *
+ * // HTTP handler
+ * app.get("/traces/:scopeType/:scopeId", (req, res) => {
+ *   res.setHeader("Content-Type", "text/event-stream");
+ *   const unsubscribe = getSseBroker().subscribe(
+ *     { type: req.params.scopeType, id: req.params.scopeId },
+ *     (events) => res.write(`data: ${JSON.stringify(events)}\n\n`),
+ *   );
+ *   req.on("close", unsubscribe);
+ * });
+ * ```
+ */
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { TraceTransportTag } from "../Sink.js";
+/**
+ * In-process pub/sub broker. Routes trace events to subscribers keyed by
+ * `scope.type/scope.id`. A subscriber for `team/abc` receives only events
+ * for that team's traces.
+ */
+export class SseBroker {
+    subscribers = new Map();
+    scopeByTraceId = new Map();
+    key(scope) {
+        return `${scope.type}/${scope.id}`;
+    }
+    /** Subscribe to events for a specific scope. Returns an unsubscribe fn. */
+    subscribe(scope, listener) {
+        const k = this.key(scope);
+        let set = this.subscribers.get(k);
+        if (!set) {
+            set = new Set();
+            this.subscribers.set(k, set);
+        }
+        set.add(listener);
+        return () => {
+            const s = this.subscribers.get(k);
+            if (!s)
+                return;
+            s.delete(listener);
+            if (s.size === 0)
+                this.subscribers.delete(k);
+        };
+    }
+    /** Publish a batch - fan out per scope. Called by the transport. */
+    publish(events) {
+        for (const e of events) {
+            if (e._tag === "TraceStart")
+                this.scopeByTraceId.set(e.traceId, e.scope);
+        }
+        const grouped = new Map();
+        for (const e of events) {
+            const scope = this.scopeByTraceId.get(e.traceId);
+            if (!scope)
+                continue;
+            const k = this.key(scope);
+            const arr = grouped.get(k) ?? [];
+            arr.push(e);
+            grouped.set(k, arr);
+        }
+        for (const [k, batch] of grouped) {
+            const set = this.subscribers.get(k);
+            if (!set)
+                continue;
+            for (const listener of set) {
+                try {
+                    listener(batch);
+                }
+                catch {
+                    // Subscriber threw - keep the broker healthy.
+                }
+            }
+        }
+        for (const e of events) {
+            if (e._tag === "TraceEnd")
+                this.scopeByTraceId.delete(e.traceId);
+        }
+    }
+    /** Active subscriber count for a scope (useful for tests / metrics). */
+    subscriberCount(scope) {
+        return this.subscribers.get(this.key(scope))?.size ?? 0;
+    }
+}
+let _broker = null;
+/** Singleton broker. Same instance is used by transport + HTTP handlers. */
+export function getSseBroker() {
+    if (!_broker)
+        _broker = new SseBroker();
+    return _broker;
+}
+const sseTransport = {
+    send: (events) => Effect.sync(() => {
+        getSseBroker().publish(events);
+    }),
+};
+/** Effect Layer wiring the SSE transport into the trace sink. */
+export const SSETransportLayer = Layer.succeed(TraceTransportTag, sseTransport);
+//# sourceMappingURL=sse.js.map

package/dist/src/transports/sse.js.map

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