@ngxsp/telemetry-core 0.0.1-next.0

package/index.cjs

@@ -0,0 +1,95 @@
+'use strict';
+
+// src/index.ts
+function randomId() {
+  return Math.random().toString(36).slice(2) + "-" + Date.now().toString(36);
+}
+function clamp(n, min, max) {
+  return Math.max(min, Math.min(max, n));
+}
+var TelemetryCollector = class {
+  meta;
+  samples = [];
+  constructor(meta) {
+    this.meta = {
+      sessionId: meta?.sessionId ?? randomId(),
+      startedAt: meta?.startedAt ?? Date.now(),
+      profile: meta?.profile,
+      app: meta?.app,
+      version: meta?.version,
+      contentId: meta?.contentId
+    };
+  }
+  setMeta(meta) {
+    this.meta = { ...this.meta, ...meta };
+  }
+  reset(meta) {
+    this.samples = [];
+    this.meta = {
+      sessionId: meta?.sessionId ?? randomId(),
+      startedAt: meta?.startedAt ?? Date.now(),
+      profile: meta?.profile ?? this.meta.profile,
+      app: meta?.app ?? this.meta.app,
+      version: meta?.version ?? this.meta.version,
+      contentId: meta?.contentId ?? this.meta.contentId
+    };
+  }
+  add(sample) {
+    this.samples.push(sample);
+  }
+  export() {
+    return { startedAt: this.meta.startedAt, samples: [...this.samples] };
+  }
+  exportV2() {
+    const samples = [...this.samples];
+    const summary = this.computeSummary(samples);
+    return { meta: { ...this.meta }, samples, summary };
+  }
+  toJSON(pretty = true) {
+    const snap = this.exportV2();
+    return JSON.stringify(snap, null, pretty ? 2 : 0);
+  }
+  toNDJSON() {
+    const snap = this.exportV2();
+    const lines = [];
+    lines.push(JSON.stringify({ type: "meta", ...snap.meta }));
+    for (const s of snap.samples) lines.push(JSON.stringify({ type: "sample", ...s }));
+    lines.push(JSON.stringify({ type: "summary", ...snap.summary }));
+    return lines.join("\n") + "\n";
+  }
+  computeSummary(samples) {
+    let startupMs;
+    let firstFrameMs;
+    let rebufferCount = 0;
+    let rebufferMs = 0;
+    let fatalCount = 0;
+    let nonFatalCount = 0;
+    for (const s of samples) {
+      if (s.event === "qoe:startup" && typeof s.data?.["startupMs"] === "number") startupMs = s.data["startupMs"];
+      if (s.event === "qoe:first_frame" && typeof s.data?.["firstFrameMs"] === "number") firstFrameMs = s.data["firstFrameMs"];
+      if (s.event === "qoe:rebuffer_end") {
+        rebufferCount += 1;
+        if (typeof s.data?.["deltaMs"] === "number") rebufferMs += s.data["deltaMs"];
+      }
+      if (s.event === "player:fatal_error") fatalCount += 1;
+      if (s.event === "player:non_fatal_error") nonFatalCount += 1;
+    }
+    const startupPenalty = startupMs != null ? clamp(startupMs / 200, 0, 35) : 0;
+    const rebufferPenalty = clamp(rebufferMs / 1e3 * 6, 0, 50);
+    const errorPenalty = clamp(fatalCount * 30 + nonFatalCount * 5, 0, 60);
+    const score = clamp(Math.round(100 - startupPenalty - rebufferPenalty - errorPenalty), 0, 100);
+    return {
+      startupMs,
+      firstFrameMs,
+      rebufferCount,
+      rebufferMs,
+      fatalCount,
+      nonFatalCount,
+      score
+    };
+  }
+};
+
+exports.TelemetryCollector = TelemetryCollector;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAoDA,SAAS,QAAA,GAAmB;AAC1B,EAAA,OAAO,IAAA,CAAK,MAAA,EAAO,CAAE,QAAA,CAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAC,CAAA,GAAI,GAAA,GAAM,IAAA,CAAK,GAAA,EAAI,CAAE,SAAS,EAAE,CAAA;AAC3E;AAEA,SAAS,KAAA,CAAM,CAAA,EAAW,GAAA,EAAa,GAAA,EAAqB;AAC1D,EAAA,OAAO,KAAK,GAAA,CAAI,GAAA,EAAK,KAAK,GAAA,CAAI,GAAA,EAAK,CAAC,CAAC,CAAA;AACvC;AAQO,IAAM,qBAAN,MAAyB;AAAA,EACtB,IAAA;AAAA,EACA,UAA6B,EAAC;AAAA,EAEtC,YACE,IAAA,EAIA;AACA,IAAA,IAAA,CAAK,IAAA,GAAO;AAAA,MACV,SAAA,EAAW,IAAA,EAAM,SAAA,IAAa,QAAA,EAAS;AAAA,MACvC,SAAA,EAAW,IAAA,EAAM,SAAA,IAAa,IAAA,CAAK,GAAA,EAAI;AAAA,MACvC,SAAS,IAAA,EAAM,OAAA;AAAA,MACf,KAAK,IAAA,EAAM,GAAA;AAAA,MACX,SAAS,IAAA,EAAM,OAAA;AAAA,MACf,WAAW,IAAA,EAAM;AAAA,KACnB;AAAA,EACF;AAAA,EAEA,QAAQ,IAAA,EAA2C;AACjD,IAAA,IAAA,CAAK,OAAO,EAAE,GAAG,IAAA,CAAK,IAAA,EAAM,GAAG,IAAA,EAAK;AAAA,EACtC;AAAA,EAEA,MAAM,IAAA,EAA4C;AAChD,IAAA,IAAA,CAAK,UAAU,EAAC;AAChB,IAAA,IAAA,CAAK,IAAA,GAAO;AAAA,MACV,SAAA,EAAW,IAAA,EAAM,SAAA,IAAa,QAAA,EAAS;AAAA,MACvC,SAAA,EAAW,IAAA,EAAM,SAAA,IAAa,IAAA,CAAK,GAAA,EAAI;AAAA,MACvC,OAAA,EAAS,IAAA,EAAM,OAAA,IAAW,IAAA,CAAK,IAAA,CAAK,OAAA;AAAA,MACpC,GAAA,EAAK,IAAA,EAAM,GAAA,IAAO,IAAA,CAAK,IAAA,CAAK,GAAA;AAAA,MAC5B,OAAA,EAAS,IAAA,EAAM,OAAA,IAAW,IAAA,CAAK,IAAA,CAAK,OAAA;AAAA,MACpC,SAAA,EAAW,IAAA,EAAM,SAAA,IAAa,IAAA,CAAK,IAAA,CAAK;AAAA,KAC1C;AAAA,EACF;AAAA,EAEA,IAAI,MAAA,EAA+B;AACjC,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,MAAM,CAAA;AAAA,EAC1B;AAAA,EAEA,MAAA,GAA2B;AACzB,IAAA,OAAO,EAAE,SAAA,EAAW,IAAA,CAAK,IAAA,CAAK,SAAA,EAAW,SAAS,CAAC,GAAG,IAAA,CAAK,OAAO,CAAA,EAAE;AAAA,EACtE;AAAA,EAEA,QAAA,GAA+B;AAC7B,IAAA,MAAM,OAAA,GAAU,CAAC,GAAG,IAAA,CAAK,OAAO,CAAA;AAChC,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,cAAA,CAAe,OAAO,CAAA;AAC3C,IAAA,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,IAAA,EAAK,EAAG,SAAS,OAAA,EAAQ;AAAA,EACpD;AAAA,EAEA,MAAA,CAAO,SAAS,IAAA,EAAc;AAC5B,IAAA,MAAM,IAAA,GAAO,KAAK,QAAA,EAAS;AAC3B,IAAA,OAAO,KAAK,SAAA,CAAU,IAAA,EAAM,IAAA,EAAM,MAAA,GAAS,IAAI,CAAC,CAAA;AAAA,EAClD;AAAA,EAEA,QAAA,GAAmB;AACjB,IAAA,MAAM,IAAA,GAAO,KAAK,QAAA,EAAS;AAC3B,IAAA,MAAM,QAAkB,EAAC;AACzB,IAAA,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,SAAA,CAAU,EAAE,IAAA,EAAM,QAAQ,GAAG,IAAA,CAAK,IAAA,EAAM,CAAC,CAAA;AACzD,IAAA,KAAA,MAAW,CAAA,IAAK,IAAA,CAAK,OAAA,EAAS,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,SAAA,CAAU,EAAE,IAAA,EAAM,QAAA,EAAU,GAAG,CAAA,EAAG,CAAC,CAAA;AACjF,IAAA,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,SAAA,CAAU,EAAE,IAAA,EAAM,WAAW,GAAG,IAAA,CAAK,OAAA,EAAS,CAAC,CAAA;AAC/D,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAI,CAAA,GAAI,IAAA;AAAA,EAC5B;AAAA,EAEQ,eAAe,OAAA,EAA8C;AACnE,IAAA,IAAI,SAAA;AACJ,IAAA,IAAI,YAAA;AACJ,IAAA,IAAI,aAAA,GAAgB,CAAA;AACpB,IAAA,IAAI,UAAA,GAAa,CAAA;AACjB,IAAA,IAAI,UAAA,GAAa,CAAA;AACjB,IAAA,IAAI,aAAA,GAAgB,CAAA;AAEpB,IAAA,KAAA,MAAW,KAAK,OAAA,EAAS;AACvB,MAAA,IAAI,CAAA,CAAE,KAAA,KAAU,aAAA,IAAiB,OAAO,CAAA,CAAE,IAAA,GAAO,WAAW,CAAA,KAAM,QAAA,EAAU,SAAA,GAAY,CAAA,CAAE,IAAA,CAAK,WAAW,CAAA;AAC1G,MAAA,IAAI,CAAA,CAAE,KAAA,KAAU,iBAAA,IAAqB,OAAO,CAAA,CAAE,IAAA,GAAO,cAAc,CAAA,KAAM,QAAA,EAAU,YAAA,GAAe,CAAA,CAAE,IAAA,CAAK,cAAc,CAAA;AACvH,MAAA,IAAI,CAAA,CAAE,UAAU,kBAAA,EAAoB;AAClC,QAAA,aAAA,IAAiB,CAAA;AACjB,QAAA,IAAI,OAAO,EAAE,IAAA,GAAO,SAAS,MAAM,QAAA,EAAU,UAAA,IAAc,CAAA,CAAE,IAAA,CAAK,SAAS,CAAA;AAAA,MAC7E;AACA,MAAA,IAAI,CAAA,CAAE,KAAA,KAAU,oBAAA,EAAsB,UAAA,IAAc,CAAA;AACpD,MAAA,IAAI,CAAA,CAAE,KAAA,KAAU,wBAAA,EAA0B,aAAA,IAAiB,CAAA;AAAA,IAC7D;AAGA,IAAA,MAAM,cAAA,GAAiB,aAAa,IAAA,GAAO,KAAA,CAAM,YAAY,GAAA,EAAK,CAAA,EAAG,EAAE,CAAA,GAAI,CAAA;AAC3E,IAAA,MAAM,kBAAkB,KAAA,CAAO,UAAA,GAAa,GAAA,GAAQ,CAAA,EAAG,GAAG,EAAE,CAAA;AAC5D,IAAA,MAAM,eAAe,KAAA,CAAO,UAAA,GAAa,KAAO,aAAA,GAAgB,CAAA,EAAI,GAAG,EAAE,CAAA;AACzE,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,IAAA,CAAK,KAAA,CAAM,GAAA,GAAM,iBAAiB,eAAA,GAAkB,YAAY,CAAA,EAAG,CAAA,EAAG,GAAG,CAAA;AAE7F,IAAA,OAAO;AAAA,MACL,SAAA;AAAA,MACA,YAAA;AAAA,MACA,aAAA;AAAA,MACA,UAAA;AAAA,MACA,UAAA;AAAA,MACA,aAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AACF","file":"index.cjs","sourcesContent":["export type TelemetryLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * Canonical telemetry sample used across the workspace.\n *\n * This intentionally mirrors what @ngxsp/core emits through the telemetry port.\n */\nexport interface QoEMetricSample {\n  ts: number;\n  level: TelemetryLevel;\n  event: string;\n  contentId?: string;\n  engineId?: string;\n  data?: Record<string, unknown>;\n}\n\nexport interface TelemetrySessionMeta {\n  sessionId: string;\n  startedAt: number;\n  profile?: string;\n  app?: string;\n  version?: string;\n  contentId?: string;\n}\n\nexport interface TelemetrySummary {\n  startupMs?: number;\n  firstFrameMs?: number;\n  rebufferCount: number;\n  rebufferMs: number;\n  fatalCount: number;\n  nonFatalCount: number;\n  /** A pragmatic 0..100 score. Higher is better. */\n  score: number;\n}\n\nexport interface TelemetrySessionV2 {\n  meta: TelemetrySessionMeta;\n  samples: QoEMetricSample[];\n  summary: TelemetrySummary;\n}\n\n/**\n * Back-compat shape.\n *\n * NOTE: this is kept to avoid breaking existing `ports.telemetry.export()` contracts.\n */\nexport interface TelemetrySession {\n  startedAt: number;\n  samples: QoEMetricSample[];\n}\n\nfunction randomId(): string {\n  return Math.random().toString(36).slice(2) + '-' + Date.now().toString(36);\n}\n\nfunction clamp(n: number, min: number, max: number): number {\n  return Math.max(min, Math.min(max, n));\n}\n\n/**\n * In-memory collector + lightweight scoring.\n *\n * - `export()` returns the legacy shape.\n * - `exportV2()` returns meta + computed summary.\n */\nexport class TelemetryCollector {\n  private meta: TelemetrySessionMeta;\n  private samples: QoEMetricSample[] = [];\n\n  constructor(\n    meta?: Partial<Omit<TelemetrySessionMeta, 'sessionId' | 'startedAt'>> & {\n      sessionId?: string;\n      startedAt?: number;\n    }\n  ) {\n    this.meta = {\n      sessionId: meta?.sessionId ?? randomId(),\n      startedAt: meta?.startedAt ?? Date.now(),\n      profile: meta?.profile,\n      app: meta?.app,\n      version: meta?.version,\n      contentId: meta?.contentId\n    };\n  }\n\n  setMeta(meta: Partial<TelemetrySessionMeta>): void {\n    this.meta = { ...this.meta, ...meta };\n  }\n\n  reset(meta?: Partial<TelemetrySessionMeta>): void {\n    this.samples = [];\n    this.meta = {\n      sessionId: meta?.sessionId ?? randomId(),\n      startedAt: meta?.startedAt ?? Date.now(),\n      profile: meta?.profile ?? this.meta.profile,\n      app: meta?.app ?? this.meta.app,\n      version: meta?.version ?? this.meta.version,\n      contentId: meta?.contentId ?? this.meta.contentId\n    };\n  }\n\n  add(sample: QoEMetricSample): void {\n    this.samples.push(sample);\n  }\n\n  export(): TelemetrySession {\n    return { startedAt: this.meta.startedAt, samples: [...this.samples] };\n  }\n\n  exportV2(): TelemetrySessionV2 {\n    const samples = [...this.samples];\n    const summary = this.computeSummary(samples);\n    return { meta: { ...this.meta }, samples, summary };\n  }\n\n  toJSON(pretty = true): string {\n    const snap = this.exportV2();\n    return JSON.stringify(snap, null, pretty ? 2 : 0);\n  }\n\n  toNDJSON(): string {\n    const snap = this.exportV2();\n    const lines: string[] = [];\n    lines.push(JSON.stringify({ type: 'meta', ...snap.meta }));\n    for (const s of snap.samples) lines.push(JSON.stringify({ type: 'sample', ...s }));\n    lines.push(JSON.stringify({ type: 'summary', ...snap.summary }));\n    return lines.join('\\n') + '\\n';\n  }\n\n  private computeSummary(samples: QoEMetricSample[]): TelemetrySummary {\n    let startupMs: number | undefined;\n    let firstFrameMs: number | undefined;\n    let rebufferCount = 0;\n    let rebufferMs = 0;\n    let fatalCount = 0;\n    let nonFatalCount = 0;\n\n    for (const s of samples) {\n      if (s.event === 'qoe:startup' && typeof s.data?.['startupMs'] === 'number') startupMs = s.data['startupMs'] as number;\n      if (s.event === 'qoe:first_frame' && typeof s.data?.['firstFrameMs'] === 'number') firstFrameMs = s.data['firstFrameMs'] as number;\n      if (s.event === 'qoe:rebuffer_end') {\n        rebufferCount += 1;\n        if (typeof s.data?.['deltaMs'] === 'number') rebufferMs += s.data['deltaMs'] as number;\n      }\n      if (s.event === 'player:fatal_error') fatalCount += 1;\n      if (s.event === 'player:non_fatal_error') nonFatalCount += 1;\n    }\n\n    // Simple heuristic: penalize startup and rebuffer, cap to [0..100].\n    const startupPenalty = startupMs != null ? clamp(startupMs / 200, 0, 35) : 0; // 7s => 35\n    const rebufferPenalty = clamp((rebufferMs / 1000) * 6, 0, 50); // 8s => 48\n    const errorPenalty = clamp((fatalCount * 30) + (nonFatalCount * 5), 0, 60);\n    const score = clamp(Math.round(100 - startupPenalty - rebufferPenalty - errorPenalty), 0, 100);\n\n    return {\n      startupMs,\n      firstFrameMs,\n      rebufferCount,\n      rebufferMs,\n      fatalCount,\n      nonFatalCount,\n      score\n    };\n  }\n}\n"]}

package/index.d.cts

@@ -0,0 +1,70 @@
+type TelemetryLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Canonical telemetry sample used across the workspace.
+ *
+ * This intentionally mirrors what @ngxsp/core emits through the telemetry port.
+ */
+interface QoEMetricSample {
+    ts: number;
+    level: TelemetryLevel;
+    event: string;
+    contentId?: string;
+    engineId?: string;
+    data?: Record<string, unknown>;
+}
+interface TelemetrySessionMeta {
+    sessionId: string;
+    startedAt: number;
+    profile?: string;
+    app?: string;
+    version?: string;
+    contentId?: string;
+}
+interface TelemetrySummary {
+    startupMs?: number;
+    firstFrameMs?: number;
+    rebufferCount: number;
+    rebufferMs: number;
+    fatalCount: number;
+    nonFatalCount: number;
+    /** A pragmatic 0..100 score. Higher is better. */
+    score: number;
+}
+interface TelemetrySessionV2 {
+    meta: TelemetrySessionMeta;
+    samples: QoEMetricSample[];
+    summary: TelemetrySummary;
+}
+/**
+ * Back-compat shape.
+ *
+ * NOTE: this is kept to avoid breaking existing `ports.telemetry.export()` contracts.
+ */
+interface TelemetrySession {
+    startedAt: number;
+    samples: QoEMetricSample[];
+}
+/**
+ * In-memory collector + lightweight scoring.
+ *
+ * - `export()` returns the legacy shape.
+ * - `exportV2()` returns meta + computed summary.
+ */
+declare class TelemetryCollector {
+    private meta;
+    private samples;
+    constructor(meta?: Partial<Omit<TelemetrySessionMeta, 'sessionId' | 'startedAt'>> & {
+        sessionId?: string;
+        startedAt?: number;
+    });
+    setMeta(meta: Partial<TelemetrySessionMeta>): void;
+    reset(meta?: Partial<TelemetrySessionMeta>): void;
+    add(sample: QoEMetricSample): void;
+    export(): TelemetrySession;
+    exportV2(): TelemetrySessionV2;
+    toJSON(pretty?: boolean): string;
+    toNDJSON(): string;
+    private computeSummary;
+}
+
+export { type QoEMetricSample, TelemetryCollector, type TelemetryLevel, type TelemetrySession, type TelemetrySessionMeta, type TelemetrySessionV2, type TelemetrySummary };

package/index.d.ts

@@ -0,0 +1,70 @@
+type TelemetryLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Canonical telemetry sample used across the workspace.
+ *
+ * This intentionally mirrors what @ngxsp/core emits through the telemetry port.
+ */
+interface QoEMetricSample {
+    ts: number;
+    level: TelemetryLevel;
+    event: string;
+    contentId?: string;
+    engineId?: string;
+    data?: Record<string, unknown>;
+}
+interface TelemetrySessionMeta {
+    sessionId: string;
+    startedAt: number;
+    profile?: string;
+    app?: string;
+    version?: string;
+    contentId?: string;
+}
+interface TelemetrySummary {
+    startupMs?: number;
+    firstFrameMs?: number;
+    rebufferCount: number;
+    rebufferMs: number;
+    fatalCount: number;
+    nonFatalCount: number;
+    /** A pragmatic 0..100 score. Higher is better. */
+    score: number;
+}
+interface TelemetrySessionV2 {
+    meta: TelemetrySessionMeta;
+    samples: QoEMetricSample[];
+    summary: TelemetrySummary;
+}
+/**
+ * Back-compat shape.
+ *
+ * NOTE: this is kept to avoid breaking existing `ports.telemetry.export()` contracts.
+ */
+interface TelemetrySession {
+    startedAt: number;
+    samples: QoEMetricSample[];
+}
+/**
+ * In-memory collector + lightweight scoring.
+ *
+ * - `export()` returns the legacy shape.
+ * - `exportV2()` returns meta + computed summary.
+ */
+declare class TelemetryCollector {
+    private meta;
+    private samples;
+    constructor(meta?: Partial<Omit<TelemetrySessionMeta, 'sessionId' | 'startedAt'>> & {
+        sessionId?: string;
+        startedAt?: number;
+    });
+    setMeta(meta: Partial<TelemetrySessionMeta>): void;
+    reset(meta?: Partial<TelemetrySessionMeta>): void;
+    add(sample: QoEMetricSample): void;
+    export(): TelemetrySession;
+    exportV2(): TelemetrySessionV2;
+    toJSON(pretty?: boolean): string;
+    toNDJSON(): string;
+    private computeSummary;
+}
+
+export { type QoEMetricSample, TelemetryCollector, type TelemetryLevel, type TelemetrySession, type TelemetrySessionMeta, type TelemetrySessionV2, type TelemetrySummary };

package/index.js

@@ -0,0 +1,93 @@
+// src/index.ts
+function randomId() {
+  return Math.random().toString(36).slice(2) + "-" + Date.now().toString(36);
+}
+function clamp(n, min, max) {
+  return Math.max(min, Math.min(max, n));
+}
+var TelemetryCollector = class {
+  meta;
+  samples = [];
+  constructor(meta) {
+    this.meta = {
+      sessionId: meta?.sessionId ?? randomId(),
+      startedAt: meta?.startedAt ?? Date.now(),
+      profile: meta?.profile,
+      app: meta?.app,
+      version: meta?.version,
+      contentId: meta?.contentId
+    };
+  }
+  setMeta(meta) {
+    this.meta = { ...this.meta, ...meta };
+  }
+  reset(meta) {
+    this.samples = [];
+    this.meta = {
+      sessionId: meta?.sessionId ?? randomId(),
+      startedAt: meta?.startedAt ?? Date.now(),
+      profile: meta?.profile ?? this.meta.profile,
+      app: meta?.app ?? this.meta.app,
+      version: meta?.version ?? this.meta.version,
+      contentId: meta?.contentId ?? this.meta.contentId
+    };
+  }
+  add(sample) {
+    this.samples.push(sample);
+  }
+  export() {
+    return { startedAt: this.meta.startedAt, samples: [...this.samples] };
+  }
+  exportV2() {
+    const samples = [...this.samples];
+    const summary = this.computeSummary(samples);
+    return { meta: { ...this.meta }, samples, summary };
+  }
+  toJSON(pretty = true) {
+    const snap = this.exportV2();
+    return JSON.stringify(snap, null, pretty ? 2 : 0);
+  }
+  toNDJSON() {
+    const snap = this.exportV2();
+    const lines = [];
+    lines.push(JSON.stringify({ type: "meta", ...snap.meta }));
+    for (const s of snap.samples) lines.push(JSON.stringify({ type: "sample", ...s }));
+    lines.push(JSON.stringify({ type: "summary", ...snap.summary }));
+    return lines.join("\n") + "\n";
+  }
+  computeSummary(samples) {
+    let startupMs;
+    let firstFrameMs;
+    let rebufferCount = 0;
+    let rebufferMs = 0;
+    let fatalCount = 0;
+    let nonFatalCount = 0;
+    for (const s of samples) {
+      if (s.event === "qoe:startup" && typeof s.data?.["startupMs"] === "number") startupMs = s.data["startupMs"];
+      if (s.event === "qoe:first_frame" && typeof s.data?.["firstFrameMs"] === "number") firstFrameMs = s.data["firstFrameMs"];
+      if (s.event === "qoe:rebuffer_end") {
+        rebufferCount += 1;
+        if (typeof s.data?.["deltaMs"] === "number") rebufferMs += s.data["deltaMs"];
+      }
+      if (s.event === "player:fatal_error") fatalCount += 1;
+      if (s.event === "player:non_fatal_error") nonFatalCount += 1;
+    }
+    const startupPenalty = startupMs != null ? clamp(startupMs / 200, 0, 35) : 0;
+    const rebufferPenalty = clamp(rebufferMs / 1e3 * 6, 0, 50);
+    const errorPenalty = clamp(fatalCount * 30 + nonFatalCount * 5, 0, 60);
+    const score = clamp(Math.round(100 - startupPenalty - rebufferPenalty - errorPenalty), 0, 100);
+    return {
+      startupMs,
+      firstFrameMs,
+      rebufferCount,
+      rebufferMs,
+      fatalCount,
+      nonFatalCount,
+      score
+    };
+  }
+};
+
+export { TelemetryCollector };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export type TelemetryLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/**\n * Canonical telemetry sample used across the workspace.\n *\n * This intentionally mirrors what @ngxsp/core emits through the telemetry port.\n */\nexport interface QoEMetricSample {\n  ts: number;\n  level: TelemetryLevel;\n  event: string;\n  contentId?: string;\n  engineId?: string;\n  data?: Record<string, unknown>;\n}\n\nexport interface TelemetrySessionMeta {\n  sessionId: string;\n  startedAt: number;\n  profile?: string;\n  app?: string;\n  version?: string;\n  contentId?: string;\n}\n\nexport interface TelemetrySummary {\n  startupMs?: number;\n  firstFrameMs?: number;\n  rebufferCount: number;\n  rebufferMs: number;\n  fatalCount: number;\n  nonFatalCount: number;\n  /** A pragmatic 0..100 score. Higher is better. */\n  score: number;\n}\n\nexport interface TelemetrySessionV2 {\n  meta: TelemetrySessionMeta;\n  samples: QoEMetricSample[];\n  summary: TelemetrySummary;\n}\n\n/**\n * Back-compat shape.\n *\n * NOTE: this is kept to avoid breaking existing `ports.telemetry.export()` contracts.\n */\nexport interface TelemetrySession {\n  startedAt: number;\n  samples: QoEMetricSample[];\n}\n\nfunction randomId(): string {\n  return Math.random().toString(36).slice(2) + '-' + Date.now().toString(36);\n}\n\nfunction clamp(n: number, min: number, max: number): number {\n  return Math.max(min, Math.min(max, n));\n}\n\n/**\n * In-memory collector + lightweight scoring.\n *\n * - `export()` returns the legacy shape.\n * - `exportV2()` returns meta + computed summary.\n */\nexport class TelemetryCollector {\n  private meta: TelemetrySessionMeta;\n  private samples: QoEMetricSample[] = [];\n\n  constructor(\n    meta?: Partial<Omit<TelemetrySessionMeta, 'sessionId' | 'startedAt'>> & {\n      sessionId?: string;\n      startedAt?: number;\n    }\n  ) {\n    this.meta = {\n      sessionId: meta?.sessionId ?? randomId(),\n      startedAt: meta?.startedAt ?? Date.now(),\n      profile: meta?.profile,\n      app: meta?.app,\n      version: meta?.version,\n      contentId: meta?.contentId\n    };\n  }\n\n  setMeta(meta: Partial<TelemetrySessionMeta>): void {\n    this.meta = { ...this.meta, ...meta };\n  }\n\n  reset(meta?: Partial<TelemetrySessionMeta>): void {\n    this.samples = [];\n    this.meta = {\n      sessionId: meta?.sessionId ?? randomId(),\n      startedAt: meta?.startedAt ?? Date.now(),\n      profile: meta?.profile ?? this.meta.profile,\n      app: meta?.app ?? this.meta.app,\n      version: meta?.version ?? this.meta.version,\n      contentId: meta?.contentId ?? this.meta.contentId\n    };\n  }\n\n  add(sample: QoEMetricSample): void {\n    this.samples.push(sample);\n  }\n\n  export(): TelemetrySession {\n    return { startedAt: this.meta.startedAt, samples: [...this.samples] };\n  }\n\n  exportV2(): TelemetrySessionV2 {\n    const samples = [...this.samples];\n    const summary = this.computeSummary(samples);\n    return { meta: { ...this.meta }, samples, summary };\n  }\n\n  toJSON(pretty = true): string {\n    const snap = this.exportV2();\n    return JSON.stringify(snap, null, pretty ? 2 : 0);\n  }\n\n  toNDJSON(): string {\n    const snap = this.exportV2();\n    const lines: string[] = [];\n    lines.push(JSON.stringify({ type: 'meta', ...snap.meta }));\n    for (const s of snap.samples) lines.push(JSON.stringify({ type: 'sample', ...s }));\n    lines.push(JSON.stringify({ type: 'summary', ...snap.summary }));\n    return lines.join('\\n') + '\\n';\n  }\n\n  private computeSummary(samples: QoEMetricSample[]): TelemetrySummary {\n    let startupMs: number | undefined;\n    let firstFrameMs: number | undefined;\n    let rebufferCount = 0;\n    let rebufferMs = 0;\n    let fatalCount = 0;\n    let nonFatalCount = 0;\n\n    for (const s of samples) {\n      if (s.event === 'qoe:startup' && typeof s.data?.['startupMs'] === 'number') startupMs = s.data['startupMs'] as number;\n      if (s.event === 'qoe:first_frame' && typeof s.data?.['firstFrameMs'] === 'number') firstFrameMs = s.data['firstFrameMs'] as number;\n      if (s.event === 'qoe:rebuffer_end') {\n        rebufferCount += 1;\n        if (typeof s.data?.['deltaMs'] === 'number') rebufferMs += s.data['deltaMs'] as number;\n      }\n      if (s.event === 'player:fatal_error') fatalCount += 1;\n      if (s.event === 'player:non_fatal_error') nonFatalCount += 1;\n    }\n\n    // Simple heuristic: penalize startup and rebuffer, cap to [0..100].\n    const startupPenalty = startupMs != null ? clamp(startupMs / 200, 0, 35) : 0; // 7s => 35\n    const rebufferPenalty = clamp((rebufferMs / 1000) * 6, 0, 50); // 8s => 48\n    const errorPenalty = clamp((fatalCount * 30) + (nonFatalCount * 5), 0, 60);\n    const score = clamp(Math.round(100 - startupPenalty - rebufferPenalty - errorPenalty), 0, 100);\n\n    return {\n      startupMs,\n      firstFrameMs,\n      rebufferCount,\n      rebufferMs,\n      fatalCount,\n      nonFatalCount,\n      score\n    };\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@ngxsp/telemetry-core",
+  "version": "0.0.1-next.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  }
+}