@redthreadlabs/tracelog-schema 0.1.0 → 0.3.0

package/dist/sidecar.d.ts

@@ -28,8 +28,8 @@ export interface SidecarMeta {
 }
 /** The sidecar key for a log object key. */
 export declare function sidecarKey(logKey: string): string;
-/** epoch-ms → UTC hour-bucket label 'YYYY-MM-DDTHH'. */
-export declare function hourBucket(ms: number): string;
+/** epoch-ms → UTC hour-interval label 'YYYY-MM-DDTHH'. */
+export declare function hourInterval(ms: number): string;
 /**
  * Derives a log file's sidecar histogram by parsing its NDJSON lines. The file
  * on disk is the source of truth: counts come from the exact bytes uploaded,

package/dist/sidecar.js

@@ -6,7 +6,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetaAccumulator = exports.SIDECAR_SUFFIX = exports.SIDECAR_VERSION = void 0;
 exports.sidecarKey = sidecarKey;
-exports.hourBucket = hourBucket;
+exports.hourInterval = hourInterval;
 const kinds_1 = require("./kinds");
 /**
  * The metadata sidecar: a tiny JSON object written alongside each log object
@@ -28,8 +28,8 @@ function sidecarKey(logKey) {
 function pad2(n) {
     return String(n).padStart(2, '0');
 }
-/** epoch-ms → UTC hour-bucket label 'YYYY-MM-DDTHH'. */
-function hourBucket(ms) {
+/** epoch-ms → UTC hour-interval label 'YYYY-MM-DDTHH'. */
+function hourInterval(ms) {
     const d = new Date(ms);
     return (`${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}` +
         `T${pad2(d.getUTCHours())}`);
@@ -101,8 +101,8 @@ class MetaAccumulator {
             this.malformed++;
             return;
         }
-        const bucket = hourBucket(tsUs / 1000); // serialized timestamps are epoch-µs
-        const byKind = this.intervals[bucket] || (this.intervals[bucket] = Object.create(null));
+        const interval = hourInterval(tsUs / 1000); // serialized timestamps are epoch-µs
+        const byKind = this.intervals[interval] || (this.intervals[interval] = Object.create(null));
         byKind[kind] = (byKind[kind] || 0) + 1;
     }
     /**

package/dist/wire.d.ts

@@ -14,7 +14,7 @@ export interface LogBatch {
     session_ref?: string;
     device_id?: string;
     events: LogEventItem[];
-    timers: TimerItem[];
+    perfs: LogPerfItem[];
 }
 export interface LogEventItem {
     /** Event category, e.g. 'auth', 'billing', 'startup'. Default: 'client-log' */
@@ -42,18 +42,18 @@ export interface LogEventItem {
      */
     tz_offset?: number;
 }
-export interface TimerItem {
+export interface LogPerfItem {
     /** 16-char hex ID, generated client-side */
     id: string;
     /** 32-char hex trace ID, shared by parent + children */
     trace_id: string;
-    /** ID of the root timer in this trace */
+    /** ID of the root perf in this trace */
     root_id: string;
-    /** 16-char hex ID of parent timer (absent for root timers) */
+    /** 16-char hex ID of parent perf (absent for root perfs) */
     parent_id?: string;
     /** Operation name, e.g. 'content-store-startup' */
     name: string;
-    /** Timer category. Default: 'client-perf' */
+    /** Perf category. Default: 'client-perf' */
     type: string;
     /** Start time, epoch milliseconds */
     timestamp: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redthreadlabs/tracelog-schema",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Shared contract for the tracelog suite: record kinds, S3 key layout, metadata sidecar, and the /logs wire format",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",