@moqtap/trace 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -4,14 +4,14 @@ var MAGIC = new Uint8Array([77, 79, 81, 84, 82, 65, 67, 69]);
 var FORMAT_VERSION = 1;
 var PREAMBLE_SIZE = 16;
 var EVENT_TYPE_TO_INT = {
-  "control": 0,
+  control: 0,
   "stream-opened": 1,
   "stream-closed": 2,
   "object-header": 3,
   "object-payload": 4,
   "state-change": 5,
-  "error": 6,
-  "annotation": 7
+  error: 6,
+  annotation: 7
 };
 var INT_TO_EVENT_TYPE = {
   0: "control",
@@ -279,13 +279,30 @@ function createMoqtraceWriter(header) {
   };
 }
 
+// src/json.ts
+function traceToJSON(trace) {
+  return JSON.stringify(
+    trace,
+    (_key, value) => {
+      if (typeof value === "bigint") {
+        return `0x${value.toString(16)}`;
+      }
+      if (value instanceof Uint8Array) {
+        return Array.from(value).map((b) => b.toString(16).padStart(2, "0")).join("");
+      }
+      return value;
+    },
+    2
+  );
+}
+
 // src/recorder.ts
 var DETAIL_RANK = {
-  "control": 0,
-  "headers": 1,
+  control: 0,
+  headers: 1,
   "headers+sizes": 2,
   "headers+data": 3,
-  "full": 4
+  full: 4
 };
 function createRecorder(options) {
   const detail = options.detail;
@@ -385,7 +402,7 @@ function createRecorder(options) {
     wrapSession,
     record: addEvent,
     recordStreamOpened(streamId, direction, streamType) {
-      if (detailRank < DETAIL_RANK["headers"]) return;
+      if (detailRank < DETAIL_RANK.headers) return;
       addEvent({
         type: "stream-opened",
         seq: nextSeq(),
@@ -396,7 +413,7 @@ function createRecorder(options) {
       });
     },
     recordStreamClosed(streamId, errorCode = 0) {
-      if (detailRank < DETAIL_RANK["headers"]) return;
+      if (detailRank < DETAIL_RANK.headers) return;
       addEvent({
         type: "stream-closed",
         seq: nextSeq(),
@@ -406,7 +423,7 @@ function createRecorder(options) {
       });
     },
     recordObjectHeader(streamId, groupId, objectId, publisherPriority, objectStatus) {
-      if (detailRank < DETAIL_RANK["headers"]) return;
+      if (detailRank < DETAIL_RANK.headers) return;
       addEvent({
         type: "object-header",
         seq: nextSeq(),
@@ -471,19 +488,6 @@ function createRecorder(options) {
   };
 }
 
-// src/json.ts
-function traceToJSON(trace) {
-  return JSON.stringify(trace, (_key, value) => {
-    if (typeof value === "bigint") {
-      return `0x${value.toString(16)}`;
-    }
-    if (value instanceof Uint8Array) {
-      return Array.from(value).map((b) => b.toString(16).padStart(2, "0")).join("");
-    }
-    return value;
-  }, 2);
-}
-
 
 
 

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { SessionState } from '@moqtap/codec/session';
 
-type DetailLevel = 'control' | 'headers' | 'headers+sizes' | 'headers+data' | 'full';
-type Perspective = 'client' | 'server' | 'observer';
+type DetailLevel = "control" | "headers" | "headers+sizes" | "headers+data" | "full";
+type Perspective = "client" | "server" | "observer";
 interface TraceHeader {
     readonly protocol: string;
     readonly perspective: Perspective;
@@ -19,25 +19,25 @@ interface BaseEvent {
     readonly timestamp: number;
 }
 interface ControlMessageEvent extends BaseEvent {
-    readonly type: 'control';
+    readonly type: "control";
     readonly direction: 0 | 1;
     readonly messageType: number;
     readonly message: Record<string, unknown>;
     readonly raw?: Uint8Array;
 }
 interface StreamOpenedEvent extends BaseEvent {
-    readonly type: 'stream-opened';
+    readonly type: "stream-opened";
     readonly streamId: bigint;
     readonly direction: 0 | 1;
     readonly streamType: 0 | 1 | 2;
 }
 interface StreamClosedEvent extends BaseEvent {
-    readonly type: 'stream-closed';
+    readonly type: "stream-closed";
     readonly streamId: bigint;
     readonly errorCode: number;
 }
 interface ObjectHeaderEvent extends BaseEvent {
-    readonly type: 'object-header';
+    readonly type: "object-header";
     readonly streamId: bigint;
     readonly groupId: bigint;
     readonly objectId: bigint;
@@ -45,7 +45,7 @@ interface ObjectHeaderEvent extends BaseEvent {
     readonly objectStatus: number;
 }
 interface ObjectPayloadEvent extends BaseEvent {
-    readonly type: 'object-payload';
+    readonly type: "object-payload";
     readonly streamId: bigint;
     readonly groupId: bigint;
     readonly objectId: bigint;
@@ -53,17 +53,17 @@ interface ObjectPayloadEvent extends BaseEvent {
     readonly payload?: Uint8Array;
 }
 interface StateChangeEvent extends BaseEvent {
-    readonly type: 'state-change';
+    readonly type: "state-change";
     readonly from: string;
     readonly to: string;
 }
 interface TraceErrorEvent extends BaseEvent {
-    readonly type: 'error';
+    readonly type: "error";
     readonly errorCode: number;
     readonly reason: string;
 }
 interface AnnotationEvent extends BaseEvent {
-    readonly type: 'annotation';
+    readonly type: "annotation";
     readonly label: string;
     readonly data: unknown;
 }
@@ -109,6 +109,16 @@ interface MoqtraceWriter {
 }
 declare function createMoqtraceWriter(header: TraceHeader): MoqtraceWriter;
 
+/**
+ * Serialize a trace to human-readable JSON.
+ *
+ * Handles bigint → hex string and Uint8Array → hex string.
+ * This is a one-way export for human inspection and debugging.
+ * For lossless round-tripping, use the binary .moqtrace format
+ * (`writeMoqtrace` / `readMoqtrace`).
+ */
+declare function traceToJSON(trace: Trace): string;
+
 interface TraceRecorder {
     /** Wrap a SessionState to auto-record control messages and state changes. */
     wrapSession(session: SessionState): SessionState;
@@ -133,14 +143,4 @@ interface TraceRecorder {
 }
 declare function createRecorder(options: RecorderOptions): TraceRecorder;
 
-/**
- * Serialize a trace to human-readable JSON.
- *
- * Handles bigint → hex string and Uint8Array → hex string.
- * This is a one-way export for human inspection and debugging.
- * For lossless round-tripping, use the binary .moqtrace format
- * (`writeMoqtrace` / `readMoqtrace`).
- */
-declare function traceToJSON(trace: Trace): string;
-
 export { type AnnotationEvent, type ControlMessageEvent, type DetailLevel, type MoqtraceWriter, type ObjectHeaderEvent, type ObjectPayloadEvent, type Perspective, type RecorderOptions, type StateChangeEvent, type StreamClosedEvent, type StreamOpenedEvent, type Trace, type TraceErrorEvent, type TraceEvent, type TraceHeader, type TraceRecorder, createMoqtraceWriter, createRecorder, readMoqtrace, readMoqtraceHeader, traceToJSON, writeMoqtrace };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { SessionState } from '@moqtap/codec/session';
 
-type DetailLevel = 'control' | 'headers' | 'headers+sizes' | 'headers+data' | 'full';
-type Perspective = 'client' | 'server' | 'observer';
+type DetailLevel = "control" | "headers" | "headers+sizes" | "headers+data" | "full";
+type Perspective = "client" | "server" | "observer";
 interface TraceHeader {
     readonly protocol: string;
     readonly perspective: Perspective;
@@ -19,25 +19,25 @@ interface BaseEvent {
     readonly timestamp: number;
 }
 interface ControlMessageEvent extends BaseEvent {
-    readonly type: 'control';
+    readonly type: "control";
     readonly direction: 0 | 1;
     readonly messageType: number;
     readonly message: Record<string, unknown>;
     readonly raw?: Uint8Array;
 }
 interface StreamOpenedEvent extends BaseEvent {
-    readonly type: 'stream-opened';
+    readonly type: "stream-opened";
     readonly streamId: bigint;
     readonly direction: 0 | 1;
     readonly streamType: 0 | 1 | 2;
 }
 interface StreamClosedEvent extends BaseEvent {
-    readonly type: 'stream-closed';
+    readonly type: "stream-closed";
     readonly streamId: bigint;
     readonly errorCode: number;
 }
 interface ObjectHeaderEvent extends BaseEvent {
-    readonly type: 'object-header';
+    readonly type: "object-header";
     readonly streamId: bigint;
     readonly groupId: bigint;
     readonly objectId: bigint;
@@ -45,7 +45,7 @@ interface ObjectHeaderEvent extends BaseEvent {
     readonly objectStatus: number;
 }
 interface ObjectPayloadEvent extends BaseEvent {
-    readonly type: 'object-payload';
+    readonly type: "object-payload";
     readonly streamId: bigint;
     readonly groupId: bigint;
     readonly objectId: bigint;
@@ -53,17 +53,17 @@ interface ObjectPayloadEvent extends BaseEvent {
     readonly payload?: Uint8Array;
 }
 interface StateChangeEvent extends BaseEvent {
-    readonly type: 'state-change';
+    readonly type: "state-change";
     readonly from: string;
     readonly to: string;
 }
 interface TraceErrorEvent extends BaseEvent {
-    readonly type: 'error';
+    readonly type: "error";
     readonly errorCode: number;
     readonly reason: string;
 }
 interface AnnotationEvent extends BaseEvent {
-    readonly type: 'annotation';
+    readonly type: "annotation";
     readonly label: string;
     readonly data: unknown;
 }
@@ -109,6 +109,16 @@ interface MoqtraceWriter {
 }
 declare function createMoqtraceWriter(header: TraceHeader): MoqtraceWriter;
 
+/**
+ * Serialize a trace to human-readable JSON.
+ *
+ * Handles bigint → hex string and Uint8Array → hex string.
+ * This is a one-way export for human inspection and debugging.
+ * For lossless round-tripping, use the binary .moqtrace format
+ * (`writeMoqtrace` / `readMoqtrace`).
+ */
+declare function traceToJSON(trace: Trace): string;
+
 interface TraceRecorder {
     /** Wrap a SessionState to auto-record control messages and state changes. */
     wrapSession(session: SessionState): SessionState;
@@ -133,14 +143,4 @@ interface TraceRecorder {
 }
 declare function createRecorder(options: RecorderOptions): TraceRecorder;
 
-/**
- * Serialize a trace to human-readable JSON.
- *
- * Handles bigint → hex string and Uint8Array → hex string.
- * This is a one-way export for human inspection and debugging.
- * For lossless round-tripping, use the binary .moqtrace format
- * (`writeMoqtrace` / `readMoqtrace`).
- */
-declare function traceToJSON(trace: Trace): string;
-
 export { type AnnotationEvent, type ControlMessageEvent, type DetailLevel, type MoqtraceWriter, type ObjectHeaderEvent, type ObjectPayloadEvent, type Perspective, type RecorderOptions, type StateChangeEvent, type StreamClosedEvent, type StreamOpenedEvent, type Trace, type TraceErrorEvent, type TraceEvent, type TraceHeader, type TraceRecorder, createMoqtraceWriter, createRecorder, readMoqtrace, readMoqtraceHeader, traceToJSON, writeMoqtrace };

package/dist/index.js

@@ -1,17 +1,17 @@
 // src/binary.ts
-import { encode, decode, decodeMultiple } from "cbor-x";
+import { decode, decodeMultiple, encode } from "cbor-x";
 var MAGIC = new Uint8Array([77, 79, 81, 84, 82, 65, 67, 69]);
 var FORMAT_VERSION = 1;
 var PREAMBLE_SIZE = 16;
 var EVENT_TYPE_TO_INT = {
-  "control": 0,
+  control: 0,
   "stream-opened": 1,
   "stream-closed": 2,
   "object-header": 3,
   "object-payload": 4,
   "state-change": 5,
-  "error": 6,
-  "annotation": 7
+  error: 6,
+  annotation: 7
 };
 var INT_TO_EVENT_TYPE = {
   0: "control",
@@ -279,13 +279,30 @@ function createMoqtraceWriter(header) {
   };
 }
 
+// src/json.ts
+function traceToJSON(trace) {
+  return JSON.stringify(
+    trace,
+    (_key, value) => {
+      if (typeof value === "bigint") {
+        return `0x${value.toString(16)}`;
+      }
+      if (value instanceof Uint8Array) {
+        return Array.from(value).map((b) => b.toString(16).padStart(2, "0")).join("");
+      }
+      return value;
+    },
+    2
+  );
+}
+
 // src/recorder.ts
 var DETAIL_RANK = {
-  "control": 0,
-  "headers": 1,
+  control: 0,
+  headers: 1,
   "headers+sizes": 2,
   "headers+data": 3,
-  "full": 4
+  full: 4
 };
 function createRecorder(options) {
   const detail = options.detail;
@@ -385,7 +402,7 @@ function createRecorder(options) {
     wrapSession,
     record: addEvent,
     recordStreamOpened(streamId, direction, streamType) {
-      if (detailRank < DETAIL_RANK["headers"]) return;
+      if (detailRank < DETAIL_RANK.headers) return;
       addEvent({
         type: "stream-opened",
         seq: nextSeq(),
@@ -396,7 +413,7 @@ function createRecorder(options) {
       });
     },
     recordStreamClosed(streamId, errorCode = 0) {
-      if (detailRank < DETAIL_RANK["headers"]) return;
+      if (detailRank < DETAIL_RANK.headers) return;
       addEvent({
         type: "stream-closed",
         seq: nextSeq(),
@@ -406,7 +423,7 @@ function createRecorder(options) {
       });
     },
     recordObjectHeader(streamId, groupId, objectId, publisherPriority, objectStatus) {
-      if (detailRank < DETAIL_RANK["headers"]) return;
+      if (detailRank < DETAIL_RANK.headers) return;
       addEvent({
         type: "object-header",
         seq: nextSeq(),
@@ -470,19 +487,6 @@ function createRecorder(options) {
     }
   };
 }
-
-// src/json.ts
-function traceToJSON(trace) {
-  return JSON.stringify(trace, (_key, value) => {
-    if (typeof value === "bigint") {
-      return `0x${value.toString(16)}`;
-    }
-    if (value instanceof Uint8Array) {
-      return Array.from(value).map((b) => b.toString(16).padStart(2, "0")).join("");
-    }
-    return value;
-  }, 2);
-}
 export {
   createMoqtraceWriter,
   createRecorder,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moqtap/trace",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MoQT session trace format — record, serialize, and analyze .moqtrace files",
   "type": "module",
   "license": "MIT",
@@ -32,7 +32,7 @@
     ".": {
       "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
+      "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     }
   },

package/src/binary.ts

@@ -1,37 +1,31 @@
-import { encode, decode, decodeMultiple } from 'cbor-x';
-import type {
-  Trace,
-  TraceHeader,
-  TraceEvent,
-  DetailLevel,
-  Perspective,
-} from './types.js';
+import { decode, decodeMultiple, encode } from "cbor-x";
+import type { DetailLevel, Perspective, Trace, TraceEvent, TraceHeader } from "./types.js";
 
 const MAGIC = new Uint8Array([0x4d, 0x4f, 0x51, 0x54, 0x52, 0x41, 0x43, 0x45]); // "MOQTRACE"
 const FORMAT_VERSION = 1;
 const PREAMBLE_SIZE = 16; // 8 magic + 4 version + 4 header length
 
 // Event type string ↔ integer mapping
-const EVENT_TYPE_TO_INT: Record<TraceEvent['type'], number> = {
-  'control': 0,
-  'stream-opened': 1,
-  'stream-closed': 2,
-  'object-header': 3,
-  'object-payload': 4,
-  'state-change': 5,
-  'error': 6,
-  'annotation': 7,
+const EVENT_TYPE_TO_INT: Record<TraceEvent["type"], number> = {
+  control: 0,
+  "stream-opened": 1,
+  "stream-closed": 2,
+  "object-header": 3,
+  "object-payload": 4,
+  "state-change": 5,
+  error: 6,
+  annotation: 7,
 };
 
-const INT_TO_EVENT_TYPE: Record<number, TraceEvent['type']> = {
-  0: 'control',
-  1: 'stream-opened',
-  2: 'stream-closed',
-  3: 'object-header',
-  4: 'object-payload',
-  5: 'state-change',
-  6: 'error',
-  7: 'annotation',
+const INT_TO_EVENT_TYPE: Record<number, TraceEvent["type"]> = {
+  0: "control",
+  1: "stream-opened",
+  2: "stream-closed",
+  3: "object-header",
+  4: "object-payload",
+  5: "state-change",
+  6: "error",
+  7: "annotation",
 };
 
 // --- Header serialization ---
@@ -77,25 +71,25 @@ function eventToCbor(event: TraceEvent): Record<string, unknown> {
   };
 
   switch (event.type) {
-    case 'control': {
+    case "control": {
       base.d = event.direction;
       base.mt = event.messageType;
       base.msg = event.message;
       if (event.raw != null) base.raw = event.raw;
       break;
     }
-    case 'stream-opened': {
+    case "stream-opened": {
       base.sid = event.streamId;
       base.d = event.direction;
       base.st = event.streamType;
       break;
     }
-    case 'stream-closed': {
+    case "stream-closed": {
       base.sid = event.streamId;
       base.ec = event.errorCode;
       break;
     }
-    case 'object-header': {
+    case "object-header": {
       base.sid = event.streamId;
       base.g = event.groupId;
       base.o = event.objectId;
@@ -103,7 +97,7 @@ function eventToCbor(event: TraceEvent): Record<string, unknown> {
       base.os = event.objectStatus;
       break;
     }
-    case 'object-payload': {
+    case "object-payload": {
       base.sid = event.streamId;
       base.g = event.groupId;
       base.o = event.objectId;
@@ -111,17 +105,17 @@ function eventToCbor(event: TraceEvent): Record<string, unknown> {
       if (event.payload != null) base.pl = event.payload;
       break;
     }
-    case 'state-change': {
+    case "state-change": {
       base.from = event.from;
       base.to = event.to;
       break;
     }
-    case 'error': {
+    case "error": {
       base.ec = event.errorCode;
       base.reason = event.reason;
       break;
     }
-    case 'annotation': {
+    case "annotation": {
       base.label = event.label;
       if (event.data !== undefined) base.data = event.data;
       break;
@@ -136,7 +130,7 @@ function cborToEvent(obj: Record<string, unknown>): TraceEvent {
   if (eventType == null) {
     // Unknown event type — skip per spec (return annotation as fallback)
     return {
-      type: 'annotation',
+      type: "annotation",
       seq: Number(obj.n ?? 0),
       timestamp: Number(obj.t ?? 0),
       label: `unknown-event-${obj.e}`,
@@ -148,9 +142,9 @@ function cborToEvent(obj: Record<string, unknown>): TraceEvent {
   const timestamp = Number(obj.t ?? 0);
 
   switch (eventType) {
-    case 'control':
+    case "control":
       return {
-        type: 'control' as const,
+        type: "control" as const,
         seq,
         timestamp,
         direction: obj.d as 0 | 1,
@@ -159,9 +153,9 @@ function cborToEvent(obj: Record<string, unknown>): TraceEvent {
         ...(obj.raw != null ? { raw: obj.raw as Uint8Array } : {}),
       };
 
-    case 'stream-opened':
+    case "stream-opened":
       return {
-        type: 'stream-opened' as const,
+        type: "stream-opened" as const,
         seq,
         timestamp,
         streamId: BigInt(obj.sid as bigint | number),
@@ -169,18 +163,18 @@ function cborToEvent(obj: Record<string, unknown>): TraceEvent {
         streamType: obj.st as 0 | 1 | 2,
       };
 
-    case 'stream-closed':
+    case "stream-closed":
       return {
-        type: 'stream-closed' as const,
+        type: "stream-closed" as const,
         seq,
         timestamp,
         streamId: BigInt(obj.sid as bigint | number),
         errorCode: Number(obj.ec ?? 0),
       };
 
-    case 'object-header':
+    case "object-header":
       return {
-        type: 'object-header' as const,
+        type: "object-header" as const,
         seq,
         timestamp,
         streamId: BigInt(obj.sid as bigint | number),
@@ -190,9 +184,9 @@ function cborToEvent(obj: Record<string, unknown>): TraceEvent {
         objectStatus: Number(obj.os ?? 0),
       };
 
-    case 'object-payload':
+    case "object-payload":
       return {
-        type: 'object-payload' as const,
+        type: "object-payload" as const,
         seq,
         timestamp,
         streamId: BigInt(obj.sid as bigint | number),
@@ -202,30 +196,30 @@ function cborToEvent(obj: Record<string, unknown>): TraceEvent {
         ...(obj.pl != null ? { payload: obj.pl as Uint8Array } : {}),
       };
 
-    case 'state-change':
+    case "state-change":
       return {
-        type: 'state-change' as const,
+        type: "state-change" as const,
         seq,
         timestamp,
         from: obj.from as string,
         to: obj.to as string,
       };
 
-    case 'error':
+    case "error":
       return {
-        type: 'error' as const,
+        type: "error" as const,
         seq,
         timestamp,
         errorCode: Number(obj.ec ?? 0),
-        reason: (obj.reason ?? '') as string,
+        reason: (obj.reason ?? "") as string,
       };
 
-    case 'annotation':
+    case "annotation":
       return {
-        type: 'annotation' as const,
+        type: "annotation" as const,
         seq,
         timestamp,
-        label: (obj.label ?? '') as string,
+        label: (obj.label ?? "") as string,
         data: obj.data,
       };
   }
@@ -245,12 +239,12 @@ function writePreamble(headerCbor: Uint8Array): Uint8Array {
 
 function validatePreamble(bytes: Uint8Array): { version: number; headerLength: number } {
   if (bytes.length < PREAMBLE_SIZE) {
-    throw new Error('File too short: expected at least 16 bytes');
+    throw new Error("File too short: expected at least 16 bytes");
   }
 
   for (let i = 0; i < 8; i++) {
     if (bytes[i] !== MAGIC[i]) {
-      throw new Error('Invalid magic bytes: not a .moqtrace file');
+      throw new Error("Invalid magic bytes: not a .moqtrace file");
     }
   }
 
@@ -262,7 +256,7 @@ function validatePreamble(bytes: Uint8Array): { version: number; headerLength: n
 
   const headerLength = view.getUint32(12, true);
   if (PREAMBLE_SIZE + headerLength > bytes.length) {
-    throw new Error('File truncated: header extends beyond file');
+    throw new Error("File truncated: header extends beyond file");
   }
 
   return { version, headerLength };

package/src/index.ts

@@ -1,33 +1,32 @@
 // Binary .moqtrace format
+
+export type { MoqtraceWriter } from "./binary.js";
 export {
-  writeMoqtrace,
+  createMoqtraceWriter,
   readMoqtrace,
   readMoqtraceHeader,
-  createMoqtraceWriter,
-} from './binary.js';
-export type { MoqtraceWriter } from './binary.js';
-
-// Recorder
-export { createRecorder } from './recorder.js';
-export type { TraceRecorder } from './recorder.js';
-
+  writeMoqtrace,
+} from "./binary.js";
 // JSON (convenience)
-export { traceToJSON } from './json.js';
+export { traceToJSON } from "./json.js";
+export type { TraceRecorder } from "./recorder.js";
+// Recorder
+export { createRecorder } from "./recorder.js";
 
 // Types
 export type {
-  Trace,
-  TraceHeader,
-  TraceEvent,
+  AnnotationEvent,
   ControlMessageEvent,
-  StreamOpenedEvent,
-  StreamClosedEvent,
+  DetailLevel,
   ObjectHeaderEvent,
   ObjectPayloadEvent,
-  StateChangeEvent,
-  TraceErrorEvent,
-  AnnotationEvent,
-  DetailLevel,
   Perspective,
   RecorderOptions,
-} from './types.js';
+  StateChangeEvent,
+  StreamClosedEvent,
+  StreamOpenedEvent,
+  Trace,
+  TraceErrorEvent,
+  TraceEvent,
+  TraceHeader,
+} from "./types.js";

package/src/json.ts

@@ -1,4 +1,4 @@
-import type { Trace } from './types.js';
+import type { Trace } from "./types.js";
 
 /**
  * Serialize a trace to human-readable JSON.
@@ -9,13 +9,19 @@ import type { Trace } from './types.js';
  * (`writeMoqtrace` / `readMoqtrace`).
  */
 export function traceToJSON(trace: Trace): string {
-  return JSON.stringify(trace, (_key, value) => {
-    if (typeof value === 'bigint') {
-      return `0x${value.toString(16)}`;
-    }
-    if (value instanceof Uint8Array) {
-      return Array.from(value).map(b => b.toString(16).padStart(2, '0')).join('');
-    }
-    return value;
-  }, 2);
+  return JSON.stringify(
+    trace,
+    (_key, value) => {
+      if (typeof value === "bigint") {
+        return `0x${value.toString(16)}`;
+      }
+      if (value instanceof Uint8Array) {
+        return Array.from(value)
+          .map((b) => b.toString(16).padStart(2, "0"))
+          .join("");
+      }
+      return value;
+    },
+    2,
+  );
 }

package/src/recorder.ts

@@ -1,12 +1,6 @@
-import type { MoqtMessage } from '@moqtap/codec';
-import type { SessionState } from '@moqtap/codec/session';
-import type {
-  Trace,
-  TraceHeader,
-  TraceEvent,
-  RecorderOptions,
-  DetailLevel,
-} from './types.js';
+import type { MoqtMessage } from "@moqtap/codec";
+import type { SessionState } from "@moqtap/codec/session";
+import type { DetailLevel, RecorderOptions, Trace, TraceEvent, TraceHeader } from "./types.js";
 
 export interface TraceRecorder {
   /** Wrap a SessionState to auto-record control messages and state changes. */
@@ -23,14 +17,20 @@ export interface TraceRecorder {
 
   /** Record an object header event. Ignored below 'headers' detail level. */
   recordObjectHeader(
-    streamId: bigint, groupId: bigint, objectId: bigint,
-    publisherPriority: number, objectStatus: number,
+    streamId: bigint,
+    groupId: bigint,
+    objectId: bigint,
+    publisherPriority: number,
+    objectStatus: number,
   ): void;
 
   /** Record an object payload event. Ignored below 'headers+sizes' detail level. */
   recordObjectPayload(
-    streamId: bigint, groupId: bigint, objectId: bigint,
-    size: number, payload?: Uint8Array,
+    streamId: bigint,
+    groupId: bigint,
+    objectId: bigint,
+    size: number,
+    payload?: Uint8Array,
   ): void;
 
   /** Record a protocol error. */
@@ -47,11 +47,11 @@ export interface TraceRecorder {
 }
 
 const DETAIL_RANK: Record<DetailLevel, number> = {
-  'control': 0,
-  'headers': 1,
-  'headers+sizes': 2,
-  'headers+data': 3,
-  'full': 4,
+  control: 0,
+  headers: 1,
+  "headers+sizes": 2,
+  "headers+data": 3,
+  full: 4,
 };
 
 export function createRecorder(options: RecorderOptions): TraceRecorder {
@@ -80,19 +80,31 @@ export function createRecorder(options: RecorderOptions): TraceRecorder {
 
   function wrapSession(session: SessionState): SessionState {
     return {
-      get phase() { return session.phase; },
-      get role() { return session.role; },
-      get subscriptions() { return session.subscriptions; },
-      get announces() { return session.announces; },
-      get legalOutgoing() { return session.legalOutgoing; },
-      get legalIncoming() { return session.legalIncoming; },
+      get phase() {
+        return session.phase;
+      },
+      get role() {
+        return session.role;
+      },
+      get subscriptions() {
+        return session.subscriptions;
+      },
+      get announces() {
+        return session.announces;
+      },
+      get legalOutgoing() {
+        return session.legalOutgoing;
+      },
+      get legalIncoming() {
+        return session.legalIncoming;
+      },
 
       receive(message: MoqtMessage) {
         const prevPhase = session.phase;
         const result = session.receive(message);
 
         addEvent({
-          type: 'control',
+          type: "control",
           seq: nextSeq(),
           timestamp: clock(),
           direction: 1, // rx
@@ -102,7 +114,7 @@ export function createRecorder(options: RecorderOptions): TraceRecorder {
 
         if (result.ok && result.phase !== prevPhase) {
           addEvent({
-            type: 'state-change',
+            type: "state-change",
             seq: nextSeq(),
             timestamp: clock(),
             from: prevPhase,
@@ -122,7 +134,7 @@ export function createRecorder(options: RecorderOptions): TraceRecorder {
         const result = session.send(message);
 
         addEvent({
-          type: 'control',
+          type: "control",
           seq: nextSeq(),
           timestamp: clock(),
           direction: 0, // tx
@@ -132,7 +144,7 @@ export function createRecorder(options: RecorderOptions): TraceRecorder {
 
         if (result.ok && result.phase !== prevPhase) {
           addEvent({
-            type: 'state-change',
+            type: "state-change",
             seq: nextSeq(),
             timestamp: clock(),
             from: prevPhase,
@@ -155,9 +167,9 @@ export function createRecorder(options: RecorderOptions): TraceRecorder {
     record: addEvent,
 
     recordStreamOpened(streamId, direction, streamType) {
-      if (detailRank < DETAIL_RANK['headers']) return;
+      if (detailRank < DETAIL_RANK.headers) return;
       addEvent({
-        type: 'stream-opened',
+        type: "stream-opened",
         seq: nextSeq(),
         timestamp: clock(),
         streamId,
@@ -167,9 +179,9 @@ export function createRecorder(options: RecorderOptions): TraceRecorder {
     },
 
     recordStreamClosed(streamId, errorCode = 0) {
-      if (detailRank < DETAIL_RANK['headers']) return;
+      if (detailRank < DETAIL_RANK.headers) return;
       addEvent({
-        type: 'stream-closed',
+        type: "stream-closed",
         seq: nextSeq(),
         timestamp: clock(),
         streamId,
@@ -178,9 +190,9 @@ export function createRecorder(options: RecorderOptions): TraceRecorder {
     },
 
     recordObjectHeader(streamId, groupId, objectId, publisherPriority, objectStatus) {
-      if (detailRank < DETAIL_RANK['headers']) return;
+      if (detailRank < DETAIL_RANK.headers) return;
       addEvent({
-        type: 'object-header',
+        type: "object-header",
         seq: nextSeq(),
         timestamp: clock(),
         streamId,
@@ -192,23 +204,23 @@ export function createRecorder(options: RecorderOptions): TraceRecorder {
     },
 
     recordObjectPayload(streamId, groupId, objectId, size, payload) {
-      if (detailRank < DETAIL_RANK['headers+sizes']) return;
+      if (detailRank < DETAIL_RANK["headers+sizes"]) return;
       const event: TraceEvent = {
-        type: 'object-payload',
+        type: "object-payload",
         seq: nextSeq(),
         timestamp: clock(),
         streamId,
         groupId,
         objectId,
         size,
-        ...(detailRank >= DETAIL_RANK['headers+data'] && payload != null ? { payload } : {}),
+        ...(detailRank >= DETAIL_RANK["headers+data"] && payload != null ? { payload } : {}),
       };
       addEvent(event);
     },
 
     recordError(errorCode, reason) {
       addEvent({
-        type: 'error',
+        type: "error",
         seq: nextSeq(),
         timestamp: clock(),
         errorCode,
@@ -218,7 +230,7 @@ export function createRecorder(options: RecorderOptions): TraceRecorder {
 
     annotate(label, data) {
       addEvent({
-        type: 'annotation',
+        type: "annotation",
         seq: nextSeq(),
         timestamp: clock(),
         label,
@@ -242,6 +254,8 @@ export function createRecorder(options: RecorderOptions): TraceRecorder {
       return { header, events: [...events] };
     },
 
-    get recording() { return _recording; },
+    get recording() {
+      return _recording;
+    },
   };
 }

package/src/types.ts

@@ -1,5 +1,5 @@
-export type DetailLevel = 'control' | 'headers' | 'headers+sizes' | 'headers+data' | 'full';
-export type Perspective = 'client' | 'server' | 'observer';
+export type DetailLevel = "control" | "headers" | "headers+sizes" | "headers+data" | "full";
+export type Perspective = "client" | "server" | "observer";
 
 export interface TraceHeader {
   readonly protocol: string;
@@ -20,7 +20,7 @@ interface BaseEvent {
 }
 
 export interface ControlMessageEvent extends BaseEvent {
-  readonly type: 'control';
+  readonly type: "control";
   readonly direction: 0 | 1;
   readonly messageType: number;
   readonly message: Record<string, unknown>;
@@ -28,20 +28,20 @@ export interface ControlMessageEvent extends BaseEvent {
 }
 
 export interface StreamOpenedEvent extends BaseEvent {
-  readonly type: 'stream-opened';
+  readonly type: "stream-opened";
   readonly streamId: bigint;
   readonly direction: 0 | 1;
   readonly streamType: 0 | 1 | 2;
 }
 
 export interface StreamClosedEvent extends BaseEvent {
-  readonly type: 'stream-closed';
+  readonly type: "stream-closed";
   readonly streamId: bigint;
   readonly errorCode: number;
 }
 
 export interface ObjectHeaderEvent extends BaseEvent {
-  readonly type: 'object-header';
+  readonly type: "object-header";
   readonly streamId: bigint;
   readonly groupId: bigint;
   readonly objectId: bigint;
@@ -50,7 +50,7 @@ export interface ObjectHeaderEvent extends BaseEvent {
 }
 
 export interface ObjectPayloadEvent extends BaseEvent {
-  readonly type: 'object-payload';
+  readonly type: "object-payload";
   readonly streamId: bigint;
   readonly groupId: bigint;
   readonly objectId: bigint;
@@ -59,19 +59,19 @@ export interface ObjectPayloadEvent extends BaseEvent {
 }
 
 export interface StateChangeEvent extends BaseEvent {
-  readonly type: 'state-change';
+  readonly type: "state-change";
   readonly from: string;
   readonly to: string;
 }
 
 export interface TraceErrorEvent extends BaseEvent {
-  readonly type: 'error';
+  readonly type: "error";
   readonly errorCode: number;
   readonly reason: string;
 }
 
 export interface AnnotationEvent extends BaseEvent {
-  readonly type: 'annotation';
+  readonly type: "annotation";
   readonly label: string;
   readonly data: unknown;
 }