@smoothbricks/lmao 0.2.2 → 0.3.0

package/dist/lib/testing/span-query.js

@@ -6,23 +6,24 @@
  *
  * @module span-query
  */
+import { resolveMessage } from '../resolveMessage.js';
+import { iterateSpanTree } from '../traceTopology.js';
 import { extractFacts } from './extractFacts.js';
 /** Find first descendant span by name (depth-first) */
 export function findSpan(root, name) {
-    for (const child of root._children) {
-        const typed = child;
-        if (typed.message_values[0] === name)
-            return typed;
-        const found = findSpan(typed, name);
-        if (found)
-            return found;
+    for (const descendant of iterateDescendantSpans(root)) {
+        if (resolveMessage(descendant, 0) === name)
+            return descendant;
     }
     return undefined;
 }
 /** Find all descendant spans matching name (depth-first) */
 export function findAllSpans(root, name) {
     const results = [];
-    collectSpans(root, name, results);
+    for (const descendant of iterateDescendantSpans(root)) {
+        if (resolveMessage(descendant, 0) === name)
+            results.push(descendant);
+    }
     return results;
 }
 /** Extract facts for a specific named span within a root buffer tree */
@@ -35,21 +36,17 @@ export function extractFactsFor(root, spanName, options) {
 /** Collect all descendant span names (flat list, depth-first) */
 export function spanNames(root) {
     const result = [];
-    collectNames(root._children, result);
-    return result;
-}
-function collectSpans(root, name, results) {
-    for (const child of root._children) {
-        const typed = child;
-        if (typed.message_values[0] === name)
-            results.push(typed);
-        collectSpans(typed, name, results);
+    for (const descendant of iterateDescendantSpans(root)) {
+        result.push(resolveMessage(descendant, 0) ?? '');
     }
+    return result;
 }
-function collectNames(children, result) {
-    for (const child of children) {
-        const typed = child;
-        result.push(typed.message_values[0]);
-        collectNames(typed._children, result);
+function* iterateDescendantSpans(root) {
+    let previousNodeIndex = root._nodeIndex;
+    for (const buffer of iterateSpanTree(root)) {
+        if (buffer._nodeIndex === previousNodeIndex)
+            continue;
+        previousNodeIndex = buffer._nodeIndex;
+        yield buffer;
     }
 }

package/dist/lib/testing/stdio-replay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdio-replay.d.ts","sourceRoot":"","sources":["../../../src/lib/testing/stdio-replay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuBjD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,GAAG,IAAI,CAsB7F"}
+{"version":3,"file":"stdio-replay.d.ts","sourceRoot":"","sources":["../../../src/lib/testing/stdio-replay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAyCjD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,GAAG,IAAI,CAoB7F"}

package/dist/lib/testing/stdio-replay.js

@@ -1,6 +1,7 @@
 import { JsBufferStrategy } from '../JsBufferStrategy.js';
 import { createTraceRoot } from '../traceRoot.universal.js';
 import { StdioTracer } from '../tracers/StdioTracer.js';
+import { iterateSpanChildren } from '../traceTopology.js';
 function isStdioWritable(value) {
     return typeof value === 'object' && value !== null && typeof Reflect.get(value, 'write') === 'function';
 }
@@ -12,12 +13,24 @@ function makeConsoleWriteStream(write) {
         },
     };
 }
-function replayChildSpan(tracer, buffer) {
-    tracer.onSpanStart(buffer);
-    for (const child of buffer._children) {
-        replayChildSpan(tracer, child);
+function replayChildSpans(tracer, rootBuffer) {
+    const stack = [
+        { buffer: rootBuffer, children: iterateSpanChildren(rootBuffer), replayLifecycle: false },
+    ];
+    while (stack.length > 0) {
+        const frame = stack[stack.length - 1];
+        if (!frame)
+            break;
+        const next = frame.children.next();
+        if (!next.done) {
+            tracer.onSpanStart(next.value);
+            stack.push({ buffer: next.value, children: iterateSpanChildren(next.value), replayLifecycle: true });
+            continue;
+        }
+        stack.pop();
+        if (frame.replayLifecycle)
+            tracer.onSpanEnd(frame.buffer);
     }
-    tracer.onSpanEnd(buffer);
 }
 export function replayTraceToStdio(binding, rootBuffer) {
     const processRef = globalThis.process;
@@ -35,8 +48,6 @@ export function replayTraceToStdio(binding, rootBuffer) {
         colorEnabled: processRef?.stdout !== undefined,
     });
     tracer.onTraceStart(rootBuffer);
-    for (const child of rootBuffer._children) {
-        replayChildSpan(tracer, child);
-    }
+    replayChildSpans(tracer, rootBuffer);
     tracer.onTraceEnd(rootBuffer);
 }

package/dist/lib/threadId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"threadId.d.ts","sourceRoot":"","sources":["../../src/lib/threadId.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,8BAA8B;AAC9B,eAAO,MAAM,eAAe,IAAI,CAAC;AAwCjC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAmBpC;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOpF;AAGD;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}
+{"version":3,"file":"threadId.d.ts","sourceRoot":"","sources":["../../src/lib/threadId.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,8BAA8B;AAC9B,eAAO,MAAM,eAAe,IAAI,CAAC;AA2CjC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAmBpC;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOpF;AAGD;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}

package/dist/lib/threadId.js

@@ -35,17 +35,20 @@ let threadIdBigInt = null;
 function ensureInitialized() {
     if (threadIdBytes !== null)
         return;
-    threadIdBytes = new Uint8Array(THREAD_ID_BYTES);
+    // Keep initialization transactional so a failed entropy provider can be retried.
+    const bytes = new Uint8Array(THREAD_ID_BYTES);
     // Use Web Crypto API - available in browsers, Node 19+, Deno, Bun, Workers
     if (typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function') {
-        crypto.getRandomValues(threadIdBytes);
+        crypto.getRandomValues(bytes);
+        threadIdBytes = bytes;
         return;
     }
     // For Node.js < 19, try to use node:crypto
     try {
         const nodeCrypto = require('node:crypto');
         if (nodeCrypto && typeof nodeCrypto.randomFillSync === 'function') {
-            nodeCrypto.randomFillSync(threadIdBytes);
+            nodeCrypto.randomFillSync(bytes);
+            threadIdBytes = bytes;
             return;
         }
     }

package/dist/lib/traceContext.d.ts.map

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

package/dist/lib/traceContext.js

@@ -38,8 +38,5 @@ export const TraceContextProto = {
  * Type guard to check if a value is a TraceContext
  */
 export function isTraceContext(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        TRACE_CONTEXT_MARKER in value &&
-        value[TRACE_CONTEXT_MARKER] === true);
+    return typeof value === 'object' && value !== null && Reflect.get(value, TRACE_CONTEXT_MARKER) === true;
 }

package/dist/lib/traceRoot.d.ts

@@ -13,28 +13,36 @@
  * @module traceRoot
  */
 import type { Nanoseconds } from '@smoothbricks/arrow-builder';
+import type { BufferStrategy } from './bufferStrategy.js';
+import type { LogSchema } from './schema/LogSchema.js';
+import type { TraceTopology } from './traceTopology.js';
 import type { AnySpanBuffer } from './types.js';
 export type { SpanIdentity, TraceId } from './traceId.js';
 export { createTraceId, extractSpanIdentity, generateTraceId, isValidTraceId, MAX_TRACE_ID_LENGTH } from './traceId.js';
+/**
+ * Consume the one-shot marker set when a WASM allocation export already
+ * initialized the system lifecycle rows. Message storage is still populated
+ * by the selected physical appender after this returns.
+ */
+export declare function consumeSpanStartedAtAllocation(buffer: AnySpanBuffer): boolean;
 /**
  * Tracer lifecycle hooks interface.
  * Extracted to avoid circular dependency - Tracer implements this.
  */
-export interface TracerLifecycleHooks {
+export interface TracerLifecycleHooks<T extends LogSchema = LogSchema> {
     onTraceStart(buffer: unknown): void;
     onTraceEnd(buffer: unknown): void;
     onSpanStart(buffer: unknown): void;
     onSpanEnd(buffer: unknown): void;
     onStatsWillResetFor(buffer: unknown): void;
+    /** Internal evaluator source used when a specialized parent omits the public ff slot. */
+    getFlagEvaluatorForContext(): unknown;
     /**
      * Buffer strategy for creating child and overflow buffers.
      * SpanContext uses this to create child spans with the correct strategy (JS or WASM).
      * Note: Caller must call writeSpanStart() after createChildSpanBuffer() to set span name.
      */
-    readonly bufferStrategy: {
-        createChildSpanBuffer(parentBuffer: AnySpanBuffer, callsiteMetadata: unknown, opMetadata: unknown, capacity?: number, schema?: unknown): AnySpanBuffer;
-        createOverflowBuffer(buffer: AnySpanBuffer): AnySpanBuffer;
-    };
+    readonly bufferStrategy: BufferStrategy<T>;
 }
 /**
  * TraceRoot._system memory layout (little-endian):
@@ -66,17 +74,26 @@ export declare const TRACE_ROOT_TRACE_ID_OFFSET = 17;
  *
  * The factory creates anchor timestamps internally using platform-specific APIs.
  */
-export type TraceRootFactory = (trace_id: string, tracer: TracerLifecycleHooks) => ITraceRoot;
-export interface ITraceRoot {
+export type TraceRootFactory<T extends LogSchema = LogSchema> = (trace_id: string, tracer: TracerLifecycleHooks<T>) => ITraceRoot<T>;
+/** Platform-fixed primitives copied into the physical plan/generated writer hot path. */
+export type TimestampNowPrimitive = (traceRoot: ITraceRoot) => Nanoseconds;
+export type TimestampAppendPrimitive = (traceRoot: ITraceRoot, buffer: AnySpanBuffer, entryType: number) => number;
+export type SpanStartPrimitive = (traceRoot: ITraceRoot, buffer: AnySpanBuffer, spanName: string) => void;
+export type SpanEndPrimitive = (traceRoot: ITraceRoot, buffer: AnySpanBuffer, entryType: number) => void;
+export interface ITraceRoot<T extends LogSchema = LogSchema> {
     /**
      * Raw backing buffer containing anchor timestamps and trace_id.
      * The WASM path can read this directly without BigInt extraction.
      */
     readonly _system: ArrayBuffer;
+    /** Canonical immutable UTF-8 trace ID bytes, shared by span identity construction. */
+    readonly _traceIdBytes: Uint8Array;
     /**
      * Tracer reference for lifecycle hooks and event callbacks.
      */
-    readonly tracer: TracerLifecycleHooks;
+    readonly tracer: TracerLifecycleHooks<T>;
+    /** Trace-owned arena for logical span topology. */
+    readonly _topology: TraceTopology;
     /**
      * Trace ID for this trace.
      */
@@ -92,6 +109,11 @@ export interface ITraceRoot {
      * Node.js: stored as number in the shared layout (WASM-readable), but represents hrtime
      */
     readonly anchorPerfNow: number;
+    /** Monomorphic platform implementations cached by plans and generated writers. */
+    readonly _timestampNow: TimestampNowPrimitive;
+    readonly _appendLogEntry: TimestampAppendPrimitive;
+    readonly _writeSpanStart: SpanStartPrimitive;
+    readonly _writeSpanEnd: SpanEndPrimitive;
     /**
      * Get current timestamp in nanoseconds since Unix epoch.
      * Platform-specific implementation.

package/dist/lib/traceRoot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traceRoot.d.ts","sourceRoot":"","sources":["../../src/lib/traceRoot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExH;;;GAGG;AAEH,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAE3C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE;QACvB,qBAAqB,CACnB,YAAY,EAAE,aAAa,EAC3B,gBAAgB,EAAE,OAAO,EACzB,UAAU,EAAE,OAAO,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,OAAO,GACf,aAAa,CAAC;QACjB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAAC;KAC5D,CAAC;CACH;AAGD;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,8BAA8B,KAAK,CAAC;AACjD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C;;;;;;GAMG;AACH;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,KAAK,UAAU,CAAC;AAE9F,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,iBAAiB,IAAI,WAAW,CAAC;IAEjC;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9D;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7D;;;;;;;OAOG;IACH,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACjE"}
+{"version":3,"file":"traceRoot.d.ts","sourceRoot":"","sources":["../../src/lib/traceRoot.ts"],"names":[],"mappings":"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"}

package/dist/lib/traceRoot.es.d.ts

@@ -9,30 +9,36 @@
  * @module traceRoot.es
  */
 import { Nanoseconds } from '@smoothbricks/arrow-builder';
+import type { LogSchema } from './schema/LogSchema.js';
 import { type TraceId } from './traceId.js';
-import { type ITraceRoot, type TracerLifecycleHooks } from './traceRoot.js';
+import { type ITraceRoot, type SpanEndPrimitive, type SpanStartPrimitive, type TimestampAppendPrimitive, type TimestampNowPrimitive, type TracerLifecycleHooks } from './traceRoot.js';
+import { TraceTopology } from './traceTopology.js';
 import type { AnySpanBuffer } from './types.js';
-/**
- * TraceRoot - Browser implementation with performance.now() timing.
- *
- * Stores anchor data in _system ArrayBuffer for consistency with Node.js layout,
- * but all timestamp calculations are done in pure JS.
- */
-export declare class TraceRoot implements ITraceRoot {
+export declare class TraceRoot<T extends LogSchema = LogSchema> implements ITraceRoot<T> {
     /**
      * Raw backing buffer containing anchor timestamps and trace_id.
      */
     readonly _system: ArrayBuffer;
+    readonly _traceIdBytes: Uint8Array;
+    readonly trace_id: TraceId;
     /**
      * Tracer reference for lifecycle hooks and event callbacks.
      */
-    readonly tracer: TracerLifecycleHooks;
+    readonly tracer: TracerLifecycleHooks<T>;
+    readonly _topology: TraceTopology;
+    readonly _timestampNow: TimestampNowPrimitive;
+    readonly _appendLogEntry: TimestampAppendPrimitive;
+    readonly _writeSpanStart: SpanStartPrimitive;
+    readonly _writeSpanEnd: SpanEndPrimitive;
+    readonly _anchorEpochNanos: bigint;
+    readonly _anchorPerformanceNow: number;
+    _lastTimestampNanos: bigint;
     /**
      * Cached TypedArray views for fast JS access.
      */
     private readonly _epochView;
     private readonly _perfView;
-    constructor(trace_id: TraceId, anchorEpochNanos: bigint, anchorPerfNow: number, tracer: TracerLifecycleHooks);
+    constructor(trace_id: TraceId, anchorEpochNanos: bigint, anchorPerfNow: number, tracer: TracerLifecycleHooks<T>);
     /**
      * Epoch time in nanoseconds when trace was created.
      */
@@ -41,10 +47,6 @@ export declare class TraceRoot implements ITraceRoot {
      * High-resolution timer anchor when trace was created (performance.now() value).
      */
     get anchorPerfNow(): number;
-    /**
-     * Trace ID for this trace.
-     */
-    get trace_id(): TraceId;
     /**
      * Get current timestamp in nanoseconds since Unix epoch.
      * Uses performance.now() - microsecond precision (last 3 digits = 000).
@@ -71,5 +73,5 @@ export declare class TraceRoot implements ITraceRoot {
  * Factory function for creating browser TraceRoot instances.
  * Pass this to Tracer constructor for browser/ES environments.
  */
-export declare function createTraceRoot(trace_id: string, tracer: TracerLifecycleHooks): TraceRoot;
+export declare function createTraceRoot<T extends LogSchema>(trace_id: string, tracer: TracerLifecycleHooks<T>): TraceRoot<T>;
 //# sourceMappingURL=traceRoot.es.d.ts.map

package/dist/lib/traceRoot.es.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traceRoot.es.d.ts","sourceRoot":"","sources":["../../src/lib/traceRoot.es.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EACL,KAAK,UAAU,EAKf,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQhD;;;;;GAKG;AACH,qBAAa,SAAU,YAAW,UAAU;IAC1C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAEtC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC,YAAY,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAmB3G;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAGtB;IAGD;;;OAGG;IACH,iBAAiB,IAAI,WAAW,CAK/B;IAGD;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAY5D;IAED;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAG3D;IAED;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM9D;CACF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAIzF"}
+{"version":3,"file":"traceRoot.es.d.ts","sourceRoot":"","sources":["../../src/lib/traceRoot.es.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAK1B,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwDhD,qBAAa,SAAS,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,CAAE,YAAW,UAAU,CAAC,CAAC,CAAC;IAC9E;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,aAAa,wBAAgB;IACtC,QAAQ,CAAC,eAAe,2BAAkB;IAC1C,QAAQ,CAAC,eAAe,qBAA2B;IACnD,QAAQ,CAAC,aAAa,mBAAyB;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,mBAAmB,SAAM;IAEzB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC,YAAY,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAsB9G;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAGD;;;OAGG;IACH,iBAAiB,IAAI,WAAW,CAE/B;IAGD;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE5D;IAED;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAE3D;IAED;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9D;CACF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAIpH"}

package/dist/lib/traceRoot.es.js

@@ -13,25 +13,79 @@ import { Nanoseconds } from '@smoothbricks/arrow-builder';
 import { ENTRY_TYPE_SPAN_EXCEPTION, ENTRY_TYPE_SPAN_START } from './schema/systemSchema.js';
 import { createTraceId } from './traceId.js';
 import { TRACE_ROOT_ANCHOR_EPOCH_OFFSET, TRACE_ROOT_ANCHOR_PERF_OFFSET, TRACE_ROOT_TRACE_ID_LEN_OFFSET, TRACE_ROOT_TRACE_ID_OFFSET, } from './traceRoot.js';
+import { TraceTopology } from './traceTopology.js';
 /** Shared TextEncoder for trace_id encoding (stateless, reusable) */
 const textEncoder = new TextEncoder();
-/** Shared TextDecoder for trace_id decoding (stateless, reusable) */
-const textDecoder = new TextDecoder();
 /**
  * TraceRoot - Browser implementation with performance.now() timing.
  *
  * Stores anchor data in _system ArrayBuffer for consistency with Node.js layout,
  * but all timestamp calculations are done in pure JS.
  */
+function nextTimestamp(root) {
+    const elapsedNanos = BigInt(Math.floor((performance.now() - root._anchorPerformanceNow) * 1000)) * 1000n;
+    let timestamp = root._anchorEpochNanos + elapsedNanos;
+    if (timestamp <= root._lastTimestampNanos)
+        timestamp = root._lastTimestampNanos + 1000n;
+    root._lastTimestampNanos = timestamp;
+    return Nanoseconds.unsafe(timestamp);
+}
+const timestampNow = (traceRoot) => {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- ES primitive table is only installed on TraceRoot.es instances.
+    return nextTimestamp(traceRoot);
+};
+const appendLogEntry = (traceRoot, buffer, entryType) => {
+    const entryTypes = buffer.entry_type;
+    if (entryTypes === undefined)
+        throw new TypeError('Split timestamp appender requires entry_type storage');
+    const idx = buffer._writeIndex;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- ES primitive table is only installed on TraceRoot.es instances.
+    buffer.timestamp[idx] = nextTimestamp(traceRoot);
+    entryTypes[idx] = entryType;
+    buffer._writeIndex = idx + 1;
+    return idx;
+};
+const writeSpanStartPrimitive = (traceRoot, buffer, spanName) => {
+    const entryTypes = buffer.entry_type;
+    if (entryTypes === undefined)
+        throw new TypeError('Split span-start appender requires entry_type storage');
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- ES primitive table is only installed on TraceRoot.es instances.
+    buffer.timestamp[0] = nextTimestamp(traceRoot);
+    entryTypes[0] = ENTRY_TYPE_SPAN_START;
+    if (buffer.message_values)
+        buffer.message(0, spanName);
+    entryTypes[1] = ENTRY_TYPE_SPAN_EXCEPTION;
+    buffer.timestamp[1] = 0n;
+    buffer._writeIndex = 2;
+};
+const writeSpanEndPrimitive = (traceRoot, buffer, entryType) => {
+    const entryTypes = buffer.entry_type;
+    if (entryTypes === undefined)
+        throw new TypeError('Split span-end appender requires entry_type storage');
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- ES primitive table is only installed on TraceRoot.es instances.
+    buffer.timestamp[1] = nextTimestamp(traceRoot);
+    entryTypes[1] = entryType;
+    buffer._sealStatsChain();
+};
 export class TraceRoot {
     /**
      * Raw backing buffer containing anchor timestamps and trace_id.
      */
     _system;
+    _traceIdBytes;
+    trace_id;
     /**
      * Tracer reference for lifecycle hooks and event callbacks.
      */
     tracer;
+    _topology;
+    _timestampNow = timestampNow;
+    _appendLogEntry = appendLogEntry;
+    _writeSpanStart = writeSpanStartPrimitive;
+    _writeSpanEnd = writeSpanEndPrimitive;
+    _anchorEpochNanos;
+    _anchorPerformanceNow;
+    _lastTimestampNanos = 0n;
     /**
      * Cached TypedArray views for fast JS access.
      */
@@ -41,18 +95,21 @@ export class TraceRoot {
         // Allocate buffer: 17 bytes header + trace_id length
         // trace_id is validated to be ASCII (1 byte per char) so length === byte length
         this._system = new ArrayBuffer(TRACE_ROOT_TRACE_ID_OFFSET + trace_id.length);
+        this._traceIdBytes = new Uint8Array(this._system, TRACE_ROOT_TRACE_ID_OFFSET, trace_id.length);
+        this.trace_id = trace_id;
         this.tracer = tracer;
+        this._topology = new TraceTopology();
+        this._anchorEpochNanos = anchorEpochNanos;
+        this._anchorPerformanceNow = anchorPerfNow;
         // Create cached views (one-time allocation)
         this._epochView = new BigInt64Array(this._system, TRACE_ROOT_ANCHOR_EPOCH_OFFSET, 1);
         this._perfView = new Float64Array(this._system, TRACE_ROOT_ANCHOR_PERF_OFFSET, 1);
         // Write anchor data directly
         this._epochView[0] = anchorEpochNanos;
         this._perfView[0] = anchorPerfNow;
-        // Encode trace_id directly into buffer (no intermediate allocation)
-        const u8View = new Uint8Array(this._system, TRACE_ROOT_TRACE_ID_LEN_OFFSET);
-        const traceIdDest = new Uint8Array(this._system, TRACE_ROOT_TRACE_ID_OFFSET, trace_id.length);
-        const { written } = textEncoder.encodeInto(trace_id, traceIdDest);
-        u8View[0] = written;
+        // Encode once into the canonical trace-owned view used by root span identities.
+        const { written } = textEncoder.encodeInto(trace_id, this._traceIdBytes);
+        new Uint8Array(this._system, TRACE_ROOT_TRACE_ID_LEN_OFFSET, 1)[0] = written;
     }
     /**
      * Epoch time in nanoseconds when trace was created.
@@ -66,23 +123,13 @@ export class TraceRoot {
     get anchorPerfNow() {
         return this._perfView[0];
     }
-    /**
-     * Trace ID for this trace.
-     */
-    get trace_id() {
-        const len = new Uint8Array(this._system, TRACE_ROOT_TRACE_ID_LEN_OFFSET, 1)[0];
-        return createTraceId(textDecoder.decode(new Uint8Array(this._system, TRACE_ROOT_TRACE_ID_OFFSET, len)));
-    }
     //#region smoo/lmao!n/trace-root-timestamps #es
     /**
      * Get current timestamp in nanoseconds since Unix epoch.
      * Uses performance.now() - microsecond precision (last 3 digits = 000).
      */
     getTimestampNanos() {
-        const elapsedMs = performance.now() - this._perfView[0];
-        // Convert to nanoseconds (last 3 digits = 000 due to microsecond precision)
-        const elapsedNanos = BigInt(Math.floor(elapsedMs * 1000)) * 1000n;
-        return Nanoseconds.unsafe(this._epochView[0] + elapsedNanos);
+        return this._timestampNow(this);
     }
     //#endregion smoo/lmao!n/trace-root-timestamps
     /**
@@ -91,34 +138,21 @@ export class TraceRoot {
      * Pure JS implementation - writes timestamp, entry_type, message, and sets _writeIndex.
      */
     writeSpanStart(buffer, spanName) {
-        // Row 0: span-start
-        buffer.timestamp[0] = this.getTimestampNanos();
-        buffer.entry_type[0] = ENTRY_TYPE_SPAN_START;
-        buffer.message(0, spanName);
-        // Row 1: pre-initialize as span-exception (will be overwritten on ok/err)
-        buffer.entry_type[1] = ENTRY_TYPE_SPAN_EXCEPTION;
-        buffer.timestamp[1] = 0n;
-        // Events start at row 2
-        buffer._writeIndex = 2;
+        this._writeSpanStart(this, buffer, spanName);
     }
     /**
      * Write span-end entry to buffer at row 1.
      * Writes both timestamp and entry_type.
      */
     writeSpanEnd(buffer, entryType) {
-        buffer.timestamp[1] = this.getTimestampNanos();
-        buffer.entry_type[1] = entryType;
+        this._writeSpanEnd(this, buffer, entryType);
     }
     /**
      * Write log entry: bump writeIndex, write timestamp + entry_type, return idx.
      * SpanLogger uses returned idx for string column writes.
      */
     writeLogEntry(buffer, entryType) {
-        const idx = buffer._writeIndex;
-        buffer.timestamp[idx] = this.getTimestampNanos();
-        buffer.entry_type[idx] = entryType;
-        buffer._writeIndex = idx + 1;
-        return idx;
+        return this._appendLogEntry(this, buffer, entryType);
     }
 }
 /**

package/dist/lib/traceRoot.js

@@ -14,6 +14,17 @@
  */
 // Re-export TraceId types from traceId.ts
 export { createTraceId, extractSpanIdentity, generateTraceId, isValidTraceId, MAX_TRACE_ID_LENGTH } from './traceId.js';
+/**
+ * Consume the one-shot marker set when a WASM allocation export already
+ * initialized the system lifecycle rows. Message storage is still populated
+ * by the selected physical appender after this returns.
+ */
+export function consumeSpanStartedAtAllocation(buffer) {
+    if (buffer._spanStartedAtAllocation !== true)
+        return false;
+    buffer._spanStartedAtAllocation = false;
+    return true;
+}
 //#endregion smoo/lmao!n/buffer-tuning-observability
 /**
  * TraceRoot._system memory layout (little-endian):

package/dist/lib/traceRoot.node.d.ts

@@ -7,34 +7,36 @@
  * @module traceRoot.node
  */
 import { Nanoseconds } from '@smoothbricks/arrow-builder';
+import type { LogSchema } from './schema/LogSchema.js';
 import { type TraceId } from './traceId.js';
-import { type ITraceRoot, type TracerLifecycleHooks } from './traceRoot.js';
+import { type ITraceRoot, type SpanEndPrimitive, type SpanStartPrimitive, type TimestampAppendPrimitive, type TimestampNowPrimitive, type TracerLifecycleHooks } from './traceRoot.js';
+import { TraceTopology } from './traceTopology.js';
 import type { AnySpanBuffer } from './types.js';
-/**
- * TraceRoot - Node.js implementation.
- *
- * Stores anchor data in _system ArrayBuffer and writes timestamps directly from JS.
- */
-export declare class TraceRoot implements ITraceRoot {
+export declare class TraceRoot<T extends LogSchema = LogSchema> implements ITraceRoot<T> {
     /**
      * Raw backing buffer containing anchor timestamps and trace_id.
      */
     readonly _system: ArrayBuffer;
+    readonly _traceIdBytes: Uint8Array;
+    readonly trace_id: TraceId;
     /**
      * Tracer reference for lifecycle hooks and event callbacks.
      */
-    readonly tracer: TracerLifecycleHooks;
+    readonly tracer: TracerLifecycleHooks<T>;
+    readonly _topology: TraceTopology;
+    readonly _timestampNow: TimestampNowPrimitive;
+    readonly _appendLogEntry: TimestampAppendPrimitive;
+    readonly _writeSpanStart: SpanStartPrimitive;
+    readonly _writeSpanEnd: SpanEndPrimitive;
     /**
      * Cached TypedArray views for fast JS access.
      */
     private readonly _epochView;
     private readonly _perfView;
-    /**
-     * Cached anchor hrtime as the exact BigInt, so the JS timestamp delta stays
-     * correct after the f64 `anchorPerfNow` loses integer precision (~104 days uptime).
-     */
-    private readonly _anchorHrtimeBigInt;
-    constructor(trace_id: TraceId, anchorEpochNanos: bigint, anchorPerfNow: number, anchorHrtimeBigInt: bigint, tracer: TracerLifecycleHooks);
+    /** Epoch offset makes each exact timestamp one clock read plus one BigInt addition. */
+    readonly _epochHrtimeOffset: bigint;
+    _lastTimestampNanos: bigint;
+    constructor(trace_id: TraceId, anchorEpochNanos: bigint, anchorPerfNow: number, anchorHrtimeBigInt: bigint, tracer: TracerLifecycleHooks<T>);
     /**
      * Epoch time in nanoseconds when trace was created.
      */
@@ -43,10 +45,6 @@ export declare class TraceRoot implements ITraceRoot {
      * High-resolution timer anchor when trace was created.
      */
     get anchorPerfNow(): number;
-    /**
-     * Trace ID for this trace.
-     */
-    get trace_id(): TraceId;
     /**
      * Get current timestamp in nanoseconds since Unix epoch.
      * Uses process.hrtime.bigint() for true nanosecond precision.
@@ -73,5 +71,5 @@ export declare class TraceRoot implements ITraceRoot {
  * Factory function for creating Node.js TraceRoot instances.
  * Pass this to Tracer constructor for Node.js environments.
  */
-export declare function createTraceRoot(trace_id: string, tracer: TracerLifecycleHooks): TraceRoot;
+export declare function createTraceRoot<T extends LogSchema>(trace_id: string, tracer: TracerLifecycleHooks<T>): TraceRoot<T>;
 //# sourceMappingURL=traceRoot.node.d.ts.map

package/dist/lib/traceRoot.node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traceRoot.node.d.ts","sourceRoot":"","sources":["../../src/lib/traceRoot.node.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EACL,KAAK,UAAU,EAKf,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAShD;;;;GAIG;AACH,qBAAa,SAAU,YAAW,UAAU;IAC1C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAEtC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAE7C,YACE,QAAQ,EAAE,OAAO,EACjB,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,EACrB,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,oBAAoB,EAuB7B;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAGtB;IAED;;;OAGG;IACH,iBAAiB,IAAI,WAAW,CAI/B;IAED;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU5D;IAED;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAG3D;IAED;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAM9D;CACF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAMzF"}
+{"version":3,"file":"traceRoot.node.d.ts","sourceRoot":"","sources":["../../src/lib/traceRoot.node.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAK1B,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuDhD,qBAAa,SAAS,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,CAAE,YAAW,UAAU,CAAC,CAAC,CAAC;IAC9E;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,aAAa,wBAAgB;IACtC,QAAQ,CAAC,eAAe,2BAAkB;IAC1C,QAAQ,CAAC,eAAe,qBAA2B;IACnD,QAAQ,CAAC,aAAa,mBAAyB;IAE/C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC,uFAAuF;IACvF,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,mBAAmB,SAAM;IAEzB,YACE,QAAQ,EAAE,OAAO,EACjB,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,EACrB,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAuBhC;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;OAGG;IACH,iBAAiB,IAAI,WAAW,CAE/B;IAED;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE5D;IAED;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAE3D;IAED;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9D;CACF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAMpH"}