@smoothbricks/lmao 0.1.4 → 0.2.1

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

@@ -1,6 +1,6 @@
-import * as __typia_transform__accessExpressionAsString from "typia/lib/internal/_accessExpressionAsString";
-import * as __typia_transform__validateReport from "typia/lib/internal/_validateReport";
-import * as __typia_transform__createStandardSchema from "typia/lib/internal/_createStandardSchema";
+import * as _accessExpressionAsString_1 from "typia/lib/internal/_accessExpressionAsString";
+import * as _validateReport_1 from "typia/lib/internal/_validateReport";
+import * as _createStandardSchema_1 from "typia/lib/internal/_createStandardSchema";
 /**
  * TraceQuery - Post-run query API for the SQLite trace database.
  *
@@ -30,259 +30,287 @@ let validateLatestTraceRunRow;
 let validateRootSpanRow;
 let validateTraceQueryResultRow;
 function getValidateTraceRunRow() {
-    validateTraceRunRow ??= (() => { const _io0 = (input, _exceptionable = true) => "string" === typeof input.traceId && "string" === typeof input.spanName && "number" === typeof input.startedAt && (3 === Object.keys(input).length || Object.keys(input).every(key => {
-        if (["traceId", "spanName", "startedAt"].some(prop => key === prop))
-            return true;
-        const value = input[key];
-        if (undefined === value)
-            return true;
-        return false;
-    })); const _vo0 = (input, _path, _exceptionable = true) => ["string" === typeof input.traceId || _report(_exceptionable, {
-            path: _path + ".traceId",
-            expected: "string",
-            value: input.traceId
-        }), "string" === typeof input.spanName || _report(_exceptionable, {
-            path: _path + ".spanName",
-            expected: "string",
-            value: input.spanName
-        }), "number" === typeof input.startedAt || _report(_exceptionable, {
-            path: _path + ".startedAt",
-            expected: "number",
-            value: input.startedAt
-        }), 3 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).map(key => {
+    validateTraceRunRow ??= (() => {
+        const _io0 = (input, _exceptionable = true) => "string" === typeof input.traceId && "string" === typeof input.spanName && "number" === typeof input.startedAt && (3 === Object.keys(input).length || Object.keys(input).every(key => {
             if (["traceId", "spanName", "startedAt"].some(prop => key === prop))
                 return true;
             const value = input[key];
             if (undefined === value)
                 return true;
-            return _report(_exceptionable, {
-                path: _path + __typia_transform__accessExpressionAsString._accessExpressionAsString(key),
-                expected: "undefined",
-                value: value,
-                description: [
-                    `The property \`${key}\` is not defined in the object type.`,
-                    "",
-                    "Please remove the property next time."
-                ].join("\n")
-            });
-        }).every(flag => flag))].every(flag => flag); const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true); let errors; let _report; return __typia_transform__createStandardSchema._createStandardSchema(input => {
-        if (false === __is(input)) {
-            errors = [];
-            _report = __typia_transform__validateReport._validateReport(errors);
-            ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
-                path: _path + "",
-                expected: "TraceRunRow",
-                value: input
-            })) && _vo0(input, _path + "", true) || _report(true, {
-                path: _path + "",
-                expected: "TraceRunRow",
-                value: input
-            }))(input, "$input", true);
-            const success = 0 === errors.length;
-            return success ? {
-                success,
-                data: input
-            } : {
-                success,
-                errors,
+            return false;
+        }));
+        const _vo0 = (input, _path, _exceptionable = true) => ["string" === typeof input.traceId || _report(_exceptionable, {
+                path: _path + ".traceId",
+                expected: "string",
+                value: input.traceId
+            }), "string" === typeof input.spanName || _report(_exceptionable, {
+                path: _path + ".spanName",
+                expected: "string",
+                value: input.spanName
+            }), "number" === typeof input.startedAt || _report(_exceptionable, {
+                path: _path + ".startedAt",
+                expected: "number",
+                value: input.startedAt
+            }), 3 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).map(key => {
+                if (["traceId", "spanName", "startedAt"].some(prop => key === prop))
+                    return true;
+                const value = input[key];
+                if (undefined === value)
+                    return true;
+                return _report(_exceptionable, {
+                    path: _path + _accessExpressionAsString_1._accessExpressionAsString(key),
+                    expected: "undefined",
+                    value: value,
+                    description: [
+                        `The property \`${key}\` is not defined in the object type.`,
+                        "",
+                        "Please remove the property next time."
+                    ].join("\n")
+                });
+            }).every(flag => flag))].every(flag => flag);
+        const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true);
+        let errors;
+        let _report;
+        return _createStandardSchema_1._createStandardSchema(input => {
+            if (false === __is(input)) {
+                errors = [];
+                _report = _validateReport_1._validateReport(errors);
+                ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
+                    path: _path + "",
+                    expected: "TraceRunRow",
+                    value: input
+                })) && _vo0(input, _path + "", true) || _report(true, {
+                    path: _path + "",
+                    expected: "TraceRunRow",
+                    value: input
+                }))(input, "$input", true);
+                const success = 0 === errors.length;
+                return success ? {
+                    success,
+                    data: input
+                } : {
+                    success,
+                    errors,
+                    data: input
+                };
+            }
+            return {
+                success: true,
                 data: input
             };
-        }
-        return {
-            success: true,
-            data: input
-        };
-    }); })();
+        });
+    })();
     return validateTraceRunRow;
 }
 function getValidateLatestTraceRunRow() {
-    validateLatestTraceRunRow ??= (() => { const _io0 = (input, _exceptionable = true) => "string" === typeof input.traceId && (1 === Object.keys(input).length || Object.keys(input).every(key => {
-        if (["traceId"].some(prop => key === prop))
-            return true;
-        const value = input[key];
-        if (undefined === value)
-            return true;
-        return false;
-    })); const _vo0 = (input, _path, _exceptionable = true) => ["string" === typeof input.traceId || _report(_exceptionable, {
-            path: _path + ".traceId",
-            expected: "string",
-            value: input.traceId
-        }), 1 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).map(key => {
+    validateLatestTraceRunRow ??= (() => {
+        const _io0 = (input, _exceptionable = true) => "string" === typeof input.traceId && (1 === Object.keys(input).length || Object.keys(input).every(key => {
             if (["traceId"].some(prop => key === prop))
                 return true;
             const value = input[key];
             if (undefined === value)
                 return true;
-            return _report(_exceptionable, {
-                path: _path + __typia_transform__accessExpressionAsString._accessExpressionAsString(key),
-                expected: "undefined",
-                value: value,
-                description: [
-                    `The property \`${key}\` is not defined in the object type.`,
-                    "",
-                    "Please remove the property next time."
-                ].join("\n")
-            });
-        }).every(flag => flag))].every(flag => flag); const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true); let errors; let _report; return __typia_transform__createStandardSchema._createStandardSchema(input => {
-        if (false === __is(input)) {
-            errors = [];
-            _report = __typia_transform__validateReport._validateReport(errors);
-            ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
-                path: _path + "",
-                expected: "LatestTraceRunRow",
-                value: input
-            })) && _vo0(input, _path + "", true) || _report(true, {
-                path: _path + "",
-                expected: "LatestTraceRunRow",
-                value: input
-            }))(input, "$input", true);
-            const success = 0 === errors.length;
-            return success ? {
-                success,
-                data: input
-            } : {
-                success,
-                errors,
+            return false;
+        }));
+        const _vo0 = (input, _path, _exceptionable = true) => ["string" === typeof input.traceId || _report(_exceptionable, {
+                path: _path + ".traceId",
+                expected: "string",
+                value: input.traceId
+            }), 1 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).map(key => {
+                if (["traceId"].some(prop => key === prop))
+                    return true;
+                const value = input[key];
+                if (undefined === value)
+                    return true;
+                return _report(_exceptionable, {
+                    path: _path + _accessExpressionAsString_1._accessExpressionAsString(key),
+                    expected: "undefined",
+                    value: value,
+                    description: [
+                        `The property \`${key}\` is not defined in the object type.`,
+                        "",
+                        "Please remove the property next time."
+                    ].join("\n")
+                });
+            }).every(flag => flag))].every(flag => flag);
+        const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true);
+        let errors;
+        let _report;
+        return _createStandardSchema_1._createStandardSchema(input => {
+            if (false === __is(input)) {
+                errors = [];
+                _report = _validateReport_1._validateReport(errors);
+                ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
+                    path: _path + "",
+                    expected: "LatestTraceRunRow",
+                    value: input
+                })) && _vo0(input, _path + "", true) || _report(true, {
+                    path: _path + "",
+                    expected: "LatestTraceRunRow",
+                    value: input
+                }))(input, "$input", true);
+                const success = 0 === errors.length;
+                return success ? {
+                    success,
+                    data: input
+                } : {
+                    success,
+                    errors,
+                    data: input
+                };
+            }
+            return {
+                success: true,
                 data: input
             };
-        }
-        return {
-            success: true,
-            data: input
-        };
-    }); })();
+        });
+    })();
     return validateLatestTraceRunRow;
 }
 function getValidateRootSpanRow() {
-    validateRootSpanRow ??= (() => { const _io0 = (input, _exceptionable = true) => "number" === typeof input.span_id && (1 === Object.keys(input).length || Object.keys(input).every(key => {
-        if (["span_id"].some(prop => key === prop))
-            return true;
-        const value = input[key];
-        if (undefined === value)
-            return true;
-        return false;
-    })); const _vo0 = (input, _path, _exceptionable = true) => ["number" === typeof input.span_id || _report(_exceptionable, {
-            path: _path + ".span_id",
-            expected: "number",
-            value: input.span_id
-        }), 1 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).map(key => {
+    validateRootSpanRow ??= (() => {
+        const _io0 = (input, _exceptionable = true) => "number" === typeof input.span_id && (1 === Object.keys(input).length || Object.keys(input).every(key => {
             if (["span_id"].some(prop => key === prop))
                 return true;
             const value = input[key];
             if (undefined === value)
                 return true;
-            return _report(_exceptionable, {
-                path: _path + __typia_transform__accessExpressionAsString._accessExpressionAsString(key),
-                expected: "undefined",
-                value: value,
-                description: [
-                    `The property \`${key}\` is not defined in the object type.`,
-                    "",
-                    "Please remove the property next time."
-                ].join("\n")
-            });
-        }).every(flag => flag))].every(flag => flag); const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true); let errors; let _report; return __typia_transform__createStandardSchema._createStandardSchema(input => {
-        if (false === __is(input)) {
-            errors = [];
-            _report = __typia_transform__validateReport._validateReport(errors);
-            ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
-                path: _path + "",
-                expected: "RootSpanRow",
-                value: input
-            })) && _vo0(input, _path + "", true) || _report(true, {
-                path: _path + "",
-                expected: "RootSpanRow",
-                value: input
-            }))(input, "$input", true);
-            const success = 0 === errors.length;
-            return success ? {
-                success,
-                data: input
-            } : {
-                success,
-                errors,
+            return false;
+        }));
+        const _vo0 = (input, _path, _exceptionable = true) => ["number" === typeof input.span_id || _report(_exceptionable, {
+                path: _path + ".span_id",
+                expected: "number",
+                value: input.span_id
+            }), 1 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).map(key => {
+                if (["span_id"].some(prop => key === prop))
+                    return true;
+                const value = input[key];
+                if (undefined === value)
+                    return true;
+                return _report(_exceptionable, {
+                    path: _path + _accessExpressionAsString_1._accessExpressionAsString(key),
+                    expected: "undefined",
+                    value: value,
+                    description: [
+                        `The property \`${key}\` is not defined in the object type.`,
+                        "",
+                        "Please remove the property next time."
+                    ].join("\n")
+                });
+            }).every(flag => flag))].every(flag => flag);
+        const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true);
+        let errors;
+        let _report;
+        return _createStandardSchema_1._createStandardSchema(input => {
+            if (false === __is(input)) {
+                errors = [];
+                _report = _validateReport_1._validateReport(errors);
+                ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
+                    path: _path + "",
+                    expected: "RootSpanRow",
+                    value: input
+                })) && _vo0(input, _path + "", true) || _report(true, {
+                    path: _path + "",
+                    expected: "RootSpanRow",
+                    value: input
+                }))(input, "$input", true);
+                const success = 0 === errors.length;
+                return success ? {
+                    success,
+                    data: input
+                } : {
+                    success,
+                    errors,
+                    data: input
+                };
+            }
+            return {
+                success: true,
                 data: input
             };
-        }
-        return {
-            success: true,
-            data: input
-        };
-    }); })();
+        });
+    })();
     return validateRootSpanRow;
 }
 function getValidateTraceQueryResultRow() {
-    validateTraceQueryResultRow ??= (() => { const _io0 = (input, _exceptionable = true) => "string" === typeof input.spanName && ("ok" === input.status || "err" === input.status || "exception" === input.status || "running" === input.status) && (null === input.durationNs || "number" === typeof input.durationNs) && (null === input.describe || "string" === typeof input.describe) && "number" === typeof input.parentSpanId && (5 === Object.keys(input).length || Object.keys(input).every(key => {
-        if (["spanName", "status", "durationNs", "describe", "parentSpanId"].some(prop => key === prop))
-            return true;
-        const value = input[key];
-        if (undefined === value)
-            return true;
-        return false;
-    })); const _vo0 = (input, _path, _exceptionable = true) => ["string" === typeof input.spanName || _report(_exceptionable, {
-            path: _path + ".spanName",
-            expected: "string",
-            value: input.spanName
-        }), "ok" === input.status || "err" === input.status || "exception" === input.status || "running" === input.status || _report(_exceptionable, {
-            path: _path + ".status",
-            expected: "(\"err\" | \"exception\" | \"ok\" | \"running\")",
-            value: input.status
-        }), null === input.durationNs || "number" === typeof input.durationNs || _report(_exceptionable, {
-            path: _path + ".durationNs",
-            expected: "(null | number)",
-            value: input.durationNs
-        }), null === input.describe || "string" === typeof input.describe || _report(_exceptionable, {
-            path: _path + ".describe",
-            expected: "(null | string)",
-            value: input.describe
-        }), "number" === typeof input.parentSpanId || _report(_exceptionable, {
-            path: _path + ".parentSpanId",
-            expected: "number",
-            value: input.parentSpanId
-        }), 5 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).map(key => {
+    validateTraceQueryResultRow ??= (() => {
+        const _io0 = (input, _exceptionable = true) => "string" === typeof input.spanName && ("err" === input.status || "exception" === input.status || "ok" === input.status || "running" === input.status) && (null === input.durationNs || "number" === typeof input.durationNs) && (null === input.describe || "string" === typeof input.describe) && "number" === typeof input.parentSpanId && (5 === Object.keys(input).length || Object.keys(input).every(key => {
             if (["spanName", "status", "durationNs", "describe", "parentSpanId"].some(prop => key === prop))
                 return true;
             const value = input[key];
             if (undefined === value)
                 return true;
-            return _report(_exceptionable, {
-                path: _path + __typia_transform__accessExpressionAsString._accessExpressionAsString(key),
-                expected: "undefined",
-                value: value,
-                description: [
-                    `The property \`${key}\` is not defined in the object type.`,
-                    "",
-                    "Please remove the property next time."
-                ].join("\n")
-            });
-        }).every(flag => flag))].every(flag => flag); const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true); let errors; let _report; return __typia_transform__createStandardSchema._createStandardSchema(input => {
-        if (false === __is(input)) {
-            errors = [];
-            _report = __typia_transform__validateReport._validateReport(errors);
-            ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
-                path: _path + "",
-                expected: "TraceQueryResultRow",
-                value: input
-            })) && _vo0(input, _path + "", true) || _report(true, {
-                path: _path + "",
-                expected: "TraceQueryResultRow",
-                value: input
-            }))(input, "$input", true);
-            const success = 0 === errors.length;
-            return success ? {
-                success,
-                data: input
-            } : {
-                success,
-                errors,
+            return false;
+        }));
+        const _vo0 = (input, _path, _exceptionable = true) => ["string" === typeof input.spanName || _report(_exceptionable, {
+                path: _path + ".spanName",
+                expected: "string",
+                value: input.spanName
+            }), "err" === input.status || "exception" === input.status || "ok" === input.status || "running" === input.status || _report(_exceptionable, {
+                path: _path + ".status",
+                expected: "(\"err\" | \"exception\" | \"ok\" | \"running\")",
+                value: input.status
+            }), null === input.durationNs || "number" === typeof input.durationNs || _report(_exceptionable, {
+                path: _path + ".durationNs",
+                expected: "(null | number)",
+                value: input.durationNs
+            }), null === input.describe || "string" === typeof input.describe || _report(_exceptionable, {
+                path: _path + ".describe",
+                expected: "(null | string)",
+                value: input.describe
+            }), "number" === typeof input.parentSpanId || _report(_exceptionable, {
+                path: _path + ".parentSpanId",
+                expected: "number",
+                value: input.parentSpanId
+            }), 5 === Object.keys(input).length || (false === _exceptionable || Object.keys(input).map(key => {
+                if (["spanName", "status", "durationNs", "describe", "parentSpanId"].some(prop => key === prop))
+                    return true;
+                const value = input[key];
+                if (undefined === value)
+                    return true;
+                return _report(_exceptionable, {
+                    path: _path + _accessExpressionAsString_1._accessExpressionAsString(key),
+                    expected: "undefined",
+                    value: value,
+                    description: [
+                        `The property \`${key}\` is not defined in the object type.`,
+                        "",
+                        "Please remove the property next time."
+                    ].join("\n")
+                });
+            }).every(flag => flag))].every(flag => flag);
+        const __is = (input, _exceptionable = true) => "object" === typeof input && null !== input && _io0(input, true);
+        let errors;
+        let _report;
+        return _createStandardSchema_1._createStandardSchema(input => {
+            if (false === __is(input)) {
+                errors = [];
+                _report = _validateReport_1._validateReport(errors);
+                ((input, _path, _exceptionable = true) => ("object" === typeof input && null !== input || _report(true, {
+                    path: _path + "",
+                    expected: "TraceQueryResultRow",
+                    value: input
+                })) && _vo0(input, _path + "", true) || _report(true, {
+                    path: _path + "",
+                    expected: "TraceQueryResultRow",
+                    value: input
+                }))(input, "$input", true);
+                const success = 0 === errors.length;
+                return success ? {
+                    success,
+                    data: input
+                } : {
+                    success,
+                    errors,
+                    data: input
+                };
+            }
+            return {
+                success: true,
                 data: input
             };
-        }
-        return {
-            success: true,
-            data: input
-        };
-    }); })();
+        });
+    })();
     return validateTraceQueryResultRow;
 }
 function describeSqliteBoundaryError(boundary, errors, rowIndex) {

package/dist/lib/traceContext.js

@@ -1,3 +1,11 @@
+/**
+ * TraceContext Types and Prototype System
+ *
+ * Per specs/lmao/01c_context_flow_and_op_wrappers.md and specs/lmao/01l_op_context_pattern.md:
+ * - TraceContext is created via module.traceContext() at request entry
+ * - Uses prototype-based inheritance for V8 hidden class optimization
+ * - Contains system properties (traceId, timestamps, threadId) + user Extra
+ */
 // =============================================================================
 // Prototype System for V8 Hidden Class Optimization
 // =============================================================================

package/dist/lib/traceId.js

@@ -86,3 +86,4 @@ export function extractSpanIdentity(buffer) {
         thread_id: buffer.thread_id,
     };
 }
+//#endregion smoo/lmao!n/span-identity.external-correlation

package/dist/lib/traceRoot.d.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
  */
@@ -47,7 +47,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.
  */
 export declare const TRACE_ROOT_ANCHOR_EPOCH_OFFSET = 0;
 export declare const TRACE_ROOT_ANCHOR_PERF_OFFSET = 8;
@@ -58,7 +58,7 @@ export declare 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.
@@ -70,7 +70,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;
     /**
@@ -89,7 +89,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/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;gBAE7B,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB;IAqB5G;;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;IAQhC;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAc7D;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAK5D;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;CAOhE;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;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"}

package/dist/lib/traceRoot.es.js

@@ -1,4 +1,4 @@
-//#region corpos/billing!n/audit-pricing-metering.lmao-es-trace-root
+//#region smoo/lmao!n/es-trace-root
 /**
  * TraceRoot - Browser/ES implementation.
  *
@@ -130,3 +130,4 @@ export function createTraceRoot(trace_id, tracer) {
     const anchorPerfNow = performance.now();
     return new TraceRoot(createTraceId(trace_id), anchorEpochNanos, anchorPerfNow, tracer);
 }
+//#endregion smoo/lmao!n/es-trace-root

package/dist/lib/traceRoot.js

@@ -1,3 +1,17 @@
+/**
+ * TraceRoot - Platform-agnostic interface for trace anchoring and timestamp writes.
+ *
+ * TraceRoot manages:
+ * - Trace ID storage
+ * - Timestamp anchoring (epoch + high-res timer reference)
+ * - Writing span-start/span-end to SpanBuffer's _system columns
+ *
+ * Platform-specific implementations:
+ * - TraceRoot.es.ts: Browser - uses performance.now() for timing
+ * - TraceRoot.node.ts: Node.js - process.hrtime.bigint(), pure-JS writes to SpanBuffer state
+ *
+ * @module traceRoot
+ */
 // Re-export TraceId types from traceId.ts
 export { createTraceId, extractSpanIdentity, generateTraceId, isValidTraceId, MAX_TRACE_ID_LENGTH } from './traceId.js';
 //#endregion smoo/lmao!n/buffer-tuning-observability
@@ -12,10 +26,11 @@ export { createTraceId, extractSpanIdentity, generateTraceId, isValidTraceId, MA
  *
  * 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;
 export const TRACE_ROOT_ANCHOR_PERF_OFFSET = 8;
 export const TRACE_ROOT_TRACE_ID_LEN_OFFSET = 16;
 export const TRACE_ROOT_TRACE_ID_OFFSET = 17;
+//#endregion smoo/lmao!n/trace-root-timestamps