@smoothbricks/lmao 0.1.4 → 0.2.1

package/src/lib/traceRoot.node.ts

@@ -52,8 +52,8 @@ export class TraceRoot implements ITraceRoot {
   private readonly _perfView: Float64Array;
 
   /**
-   * Cached anchor hrtime as BigInt for JS timestamp fallback.
-   * Only used if NAPI addon is not available.
+   * 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: bigint;
 
@@ -165,7 +165,7 @@ export class TraceRoot implements ITraceRoot {
 export function createTraceRoot(trace_id: string, tracer: TracerLifecycleHooks): TraceRoot {
   const anchorEpochNanos = BigInt(Date.now()) * 1_000_000n;
   const anchorHrtimeBigInt = process.hrtime.bigint();
-  // Store as number for NAPI to read as f64
+  // Also store as f64 in the shared _system layout (WASM reads it without BigInt extraction)
   const anchorPerfNow = Number(anchorHrtimeBigInt);
   return new TraceRoot(createTraceId(trace_id), anchorEpochNanos, anchorPerfNow, anchorHrtimeBigInt, tracer);
 }

package/src/lib/traceRoot.ts

@@ -8,7 +8,7 @@
  *
  * Platform-specific implementations:
  * - TraceRoot.es.ts: Browser - uses performance.now() for timing
- * - TraceRoot.node.ts: Node.js - delegates to NAPI addon for optimized writes
+ * - TraceRoot.node.ts: Node.js - process.hrtime.bigint(), pure-JS writes to SpanBuffer state
  *
  * @module traceRoot
  */
@@ -61,7 +61,7 @@ export interface TracerLifecycleHooks {
  *
  * Total: 17 + trace_id.length bytes
  *
- * This layout enables NAPI/WASM to read anchors directly without BigInt extraction.
+ * This layout enables the WASM path to read anchors directly without BigInt extraction.
  */
 //#region smoo/lmao!n/trace-root-timestamps #contract
 export const TRACE_ROOT_ANCHOR_EPOCH_OFFSET = 0;
@@ -74,7 +74,7 @@ export const TRACE_ROOT_TRACE_ID_OFFSET = 17;
  *
  * Each implementation handles timestamp calculation and span writes differently:
  * - Browser: Pure JS with performance.now()
- * - Node.js: NAPI addon with mach_absolute_time() / clock_gettime()
+ * - Node.js: process.hrtime.bigint() (pure JS; a NAPI addon was benchmarked slower than WASM and removed)
  */
 /**
  * Factory function type for creating platform-specific TraceRoot instances.
@@ -87,7 +87,7 @@ export type TraceRootFactory = (trace_id: string, tracer: TracerLifecycleHooks)
 export interface ITraceRoot {
   /**
    * Raw backing buffer containing anchor timestamps and trace_id.
-   * NAPI/WASM can read this directly without BigInt extraction.
+   * The WASM path can read this directly without BigInt extraction.
    */
   readonly _system: ArrayBuffer;
 
@@ -110,7 +110,7 @@ export interface ITraceRoot {
   /**
    * High-resolution timer anchor when trace was created.
    * Browser: performance.now() value (number)
-   * Node.js: stored as number for NAPI compatibility, but represents hrtime
+   * Node.js: stored as number in the shared layout (WASM-readable), but represents hrtime
    */
   readonly anchorPerfNow: number;
 

package/src/lib/tracers/ArrayQueueTracer.ts

@@ -1,4 +1,4 @@
-//#region corpos/billing!n/audit-pricing-metering.lmao-array-queue-tracer
+//#region smoo/lmao!n/array-queue-tracer
 import type { OpContextBinding } from '../opContext/types.js';
 import { Tracer } from '../tracer.js';
 import type { SpanBuffer } from '../types.js';
@@ -75,4 +75,4 @@ export class ArrayQueueTracer<B extends OpContextBinding = OpContextBinding> ext
     return buffers;
   }
 }
-//#endregion corpos/billing!n/audit-pricing-metering.lmao-array-queue-tracer
+//#endregion smoo/lmao!n/array-queue-tracer