@noego/telemetry 0.0.3 → 0.1.0

package/dist/json.types-BqS77fcN.d.cts

@@ -0,0 +1,7 @@
+type TelemetryJsonPrimitive = string | number | boolean | null;
+type TelemetryJsonValue = TelemetryJsonPrimitive | TelemetryJsonObject | readonly TelemetryJsonValue[];
+type TelemetryJsonObject = Readonly<{
+    [key: string]: TelemetryJsonValue;
+}>;
+
+export type { TelemetryJsonObject as T, TelemetryJsonValue as a, TelemetryJsonPrimitive as b };

package/dist/json.types-BqS77fcN.d.ts

@@ -0,0 +1,7 @@
+type TelemetryJsonPrimitive = string | number | boolean | null;
+type TelemetryJsonValue = TelemetryJsonPrimitive | TelemetryJsonObject | readonly TelemetryJsonValue[];
+type TelemetryJsonObject = Readonly<{
+    [key: string]: TelemetryJsonValue;
+}>;
+
+export type { TelemetryJsonObject as T, TelemetryJsonValue as a, TelemetryJsonPrimitive as b };

package/dist/{maintenance_coordinator.types-C4ULi4A4.d.cts → maintenance_coordinator.types-Crhx9i9k.d.cts}

@@ -1,6 +1,6 @@
-import { T as TelemetryStorageTransport, e as TelemetryStorageTarget, a as TelemetryStorageCapabilities, b as StorageTargetStatus, M as MaintenanceStageResult } from './storage.types-Bji_pWqr.cjs';
-import { M as MetricDefinition, f as MetricExtraction } from './query.types-DuYWbFFe.cjs';
-import { d as TelemetryBatch, a as TelemetryBatchValidationLimits, f as TelemetryDropCounter, c as TelemetryBatchReceiver, e as TelemetryAcknowledgement } from './transport.types-BAl_TRtU.cjs';
+import { T as TelemetryStorageTransport, e as TelemetryStorageTarget, a as TelemetryStorageCapabilities, b as StorageTargetStatus, M as MaintenanceStageResult } from './storage.types-DHbAm3j_.cjs';
+import { M as MetricDefinition, b as MetricExtraction } from './metric.types-Dg4eZq6u.cjs';
+import { d as TelemetryBatch, a as TelemetryBatchValidationLimits, f as TelemetryDropCounter, c as TelemetryBatchReceiver, e as TelemetryAcknowledgement } from './transport.types-C2dP-eed.cjs';
 
 interface TelemetrySinkPlugin {
     readonly name: string;

package/dist/{maintenance_coordinator.types-ikUrRXmO.d.ts → maintenance_coordinator.types-DprmgpVn.d.ts}

@@ -1,6 +1,6 @@
-import { T as TelemetryStorageTransport, e as TelemetryStorageTarget, a as TelemetryStorageCapabilities, b as StorageTargetStatus, M as MaintenanceStageResult } from './storage.types-k7oElEB3.js';
-import { M as MetricDefinition, f as MetricExtraction } from './query.types-DU5v7vM0.js';
-import { d as TelemetryBatch, a as TelemetryBatchValidationLimits, f as TelemetryDropCounter, c as TelemetryBatchReceiver, e as TelemetryAcknowledgement } from './transport.types-DDnZoKWi.js';
+import { T as TelemetryStorageTransport, e as TelemetryStorageTarget, a as TelemetryStorageCapabilities, b as StorageTargetStatus, M as MaintenanceStageResult } from './storage.types-BKWoIOHp.js';
+import { M as MetricDefinition, b as MetricExtraction } from './metric.types-D8aOAnUm.js';
+import { d as TelemetryBatch, a as TelemetryBatchValidationLimits, f as TelemetryDropCounter, c as TelemetryBatchReceiver, e as TelemetryAcknowledgement } from './transport.types-SA8KpLiK.js';
 
 interface TelemetrySinkPlugin {
     readonly name: string;

package/dist/metric.types-D8aOAnUm.d.ts

@@ -0,0 +1,67 @@
+import { T as TelemetryJsonObject } from './json.types-BqS77fcN.js';
+
+declare const METRIC_AGGREGATES: readonly ["sum", "min", "max", "last"];
+type MetricAggregate = (typeof METRIC_AGGREGATES)[number];
+declare const METRIC_OVERFLOW_POLICIES: readonly ["other", "drop", "reject"];
+type MetricOverflowPolicy = (typeof METRIC_OVERFLOW_POLICIES)[number];
+type MetricCountMeasurement = Readonly<{
+    kind: 'count';
+}>;
+type MetricFieldMeasurement = Readonly<{
+    kind: 'field';
+    field: string;
+    aggregates: readonly MetricAggregate[];
+}>;
+type MetricMeasurement = MetricCountMeasurement | MetricFieldMeasurement;
+type MetricCardinalityRule = Readonly<{
+    maxValuesPerBucket: number;
+    overflow: MetricOverflowPolicy;
+}>;
+type MetricDefinition = Readonly<{
+    name: string;
+    version: number;
+    selector: string;
+    groupBy: readonly string[];
+    measurements: readonly MetricMeasurement[];
+    cardinality: Readonly<Record<string, MetricCardinalityRule>>;
+    targetIds: readonly string[];
+    resolutionsMs: readonly number[];
+    missingField: 'skip' | 'record-failure';
+}>;
+type ExtractedMetricSample = Readonly<{
+    metricName: string;
+    definitionVersion: number;
+    occurredAtMs: number;
+    producerId: string;
+    sequence: number;
+    dimensions: TelemetryJsonObject;
+    dimensionKey: string;
+    values: Readonly<Record<string, number>>;
+    targetIds: readonly string[];
+}>;
+type MetricExtractionFailure = Readonly<{
+    metricName: string;
+    definitionVersion: number;
+    producerId: string;
+    sequence: number;
+    reason: string;
+}>;
+type MetricExtraction = Readonly<{
+    samples: readonly ExtractedMetricSample[];
+    failures: readonly MetricExtractionFailure[];
+}>;
+type MetricRollupValues = Readonly<{
+    count: number;
+    fields: Readonly<Record<string, Readonly<{
+        count: number;
+        sum: number;
+        min: number;
+        max: number;
+        last: number;
+        lastOccurredAtMs: number;
+        lastProducerId: string;
+        lastSequence: number;
+    }>>>;
+}>;
+
+export type { ExtractedMetricSample as E, MetricDefinition as M, MetricExtractionFailure as a, MetricExtraction as b, MetricAggregate as c, MetricCardinalityRule as d, MetricMeasurement as e, MetricOverflowPolicy as f, MetricRollupValues as g };

package/dist/metric.types-Dg4eZq6u.d.cts

@@ -0,0 +1,67 @@
+import { T as TelemetryJsonObject } from './json.types-BqS77fcN.cjs';
+
+declare const METRIC_AGGREGATES: readonly ["sum", "min", "max", "last"];
+type MetricAggregate = (typeof METRIC_AGGREGATES)[number];
+declare const METRIC_OVERFLOW_POLICIES: readonly ["other", "drop", "reject"];
+type MetricOverflowPolicy = (typeof METRIC_OVERFLOW_POLICIES)[number];
+type MetricCountMeasurement = Readonly<{
+    kind: 'count';
+}>;
+type MetricFieldMeasurement = Readonly<{
+    kind: 'field';
+    field: string;
+    aggregates: readonly MetricAggregate[];
+}>;
+type MetricMeasurement = MetricCountMeasurement | MetricFieldMeasurement;
+type MetricCardinalityRule = Readonly<{
+    maxValuesPerBucket: number;
+    overflow: MetricOverflowPolicy;
+}>;
+type MetricDefinition = Readonly<{
+    name: string;
+    version: number;
+    selector: string;
+    groupBy: readonly string[];
+    measurements: readonly MetricMeasurement[];
+    cardinality: Readonly<Record<string, MetricCardinalityRule>>;
+    targetIds: readonly string[];
+    resolutionsMs: readonly number[];
+    missingField: 'skip' | 'record-failure';
+}>;
+type ExtractedMetricSample = Readonly<{
+    metricName: string;
+    definitionVersion: number;
+    occurredAtMs: number;
+    producerId: string;
+    sequence: number;
+    dimensions: TelemetryJsonObject;
+    dimensionKey: string;
+    values: Readonly<Record<string, number>>;
+    targetIds: readonly string[];
+}>;
+type MetricExtractionFailure = Readonly<{
+    metricName: string;
+    definitionVersion: number;
+    producerId: string;
+    sequence: number;
+    reason: string;
+}>;
+type MetricExtraction = Readonly<{
+    samples: readonly ExtractedMetricSample[];
+    failures: readonly MetricExtractionFailure[];
+}>;
+type MetricRollupValues = Readonly<{
+    count: number;
+    fields: Readonly<Record<string, Readonly<{
+        count: number;
+        sum: number;
+        min: number;
+        max: number;
+        last: number;
+        lastOccurredAtMs: number;
+        lastProducerId: string;
+        lastSequence: number;
+    }>>>;
+}>;
+
+export type { ExtractedMetricSample as E, MetricDefinition as M, MetricExtractionFailure as a, MetricExtraction as b, MetricAggregate as c, MetricCardinalityRule as d, MetricMeasurement as e, MetricOverflowPolicy as f, MetricRollupValues as g };

package/dist/{metric_definition_contract-BYtnODhu.d.ts → metric_definition_contract-C6MERhJs.d.ts}

@@ -1,4 +1,4 @@
-import { M as MetricDefinition } from './query.types-DU5v7vM0.js';
+import { M as MetricDefinition } from './metric.types-D8aOAnUm.js';
 import { T as TelemetryResult } from './result.types-171Huujb.js';
 
 declare class MetricDefinitionContract {

package/dist/{metric_definition_contract-DfhhmTZ1.d.cts → metric_definition_contract-DoAk7NOw.d.cts}

@@ -1,4 +1,4 @@
-import { M as MetricDefinition } from './query.types-DuYWbFFe.cjs';
+import { M as MetricDefinition } from './metric.types-Dg4eZq6u.cjs';
 import { T as TelemetryResult } from './result.types-171Huujb.cjs';
 
 declare class MetricDefinitionContract {

package/dist/node/index.cjs

@@ -495,11 +495,15 @@ var MetricDefinitionContract = class {
     if (!eventSelector || !bracket) {
       return { ok: false, error: `Invalid metric selector ${selector}` };
     }
+    const groupBy = bracket === "*" ? [] : bracket.split(",").map((field) => field.trim());
+    if (groupBy.some((field) => field.length === 0)) {
+      return { ok: false, error: `Invalid metric selector ${selector}` };
+    }
     return {
       ok: true,
       value: {
         selector: eventSelector,
-        groupBy: bracket === "*" ? [] : [bracket],
+        groupBy,
         wildcardUngrouped: bracket === "*"
       }
     };
@@ -5726,6 +5730,14 @@ var BoundedMetadataSnapshotter = class {
 };
 
 // src/core/telemetry_client.ts
+var TELEMETRY_LEVEL_RANKS = Object.freeze({
+  trace: 0,
+  debug: 1,
+  info: 2,
+  warn: 3,
+  error: 4,
+  fatal: 5
+});
 var TelemetryClient = class {
   constructor(options) {
     this.options = options;
@@ -5788,6 +5800,10 @@ var TelemetryClient = class {
       return { kind: "dropped", producerId: this.options.producerId, sequence, reason: "invalid-label" };
     }
     const priority = this.priorityFor(input.level);
+    if (!this.meetsMinimumLevel(input.level)) {
+      this.incrementDrop("sampled", priority);
+      return { kind: "dropped", producerId: this.options.producerId, sequence, reason: "below-minimum-level" };
+    }
     if (!this.isSampled(priority)) {
       this.incrementDrop("sampled", priority);
       return { kind: "dropped", producerId: this.options.producerId, sequence, reason: "sampled" };
@@ -6168,6 +6184,15 @@ var TelemetryClient = class {
     const sampleRate = this.options.admission.sampleRates[priority];
     return sampleRate >= 1 || this.options.random() < sampleRate;
   }
+  meetsMinimumLevel(level) {
+    const minimum = this.options.admission.minimumLevel;
+    if (minimum === void 0) {
+      return true;
+    }
+    const normalized = level.trim().toLowerCase();
+    const rank = TELEMETRY_LEVEL_RANKS[normalized] ?? TELEMETRY_LEVEL_RANKS.info;
+    return rank >= TELEMETRY_LEVEL_RANKS[minimum];
+  }
   isValidLabel(label) {
     return /^[A-Za-z0-9][A-Za-z0-9_.:-]*$/.test(label) && label.length <= 256;
   }
@@ -6438,6 +6463,7 @@ var NodeTelemetryHost = class _NodeTelemetryHost {
 // src/platform/node/native_telemetry_host.ts
 var import_node_module = require("module");
 var import_node_path3 = require("path");
+var import_meta2 = {};
 var NativeTelemetryHost = class _NativeTelemetryHost {
   client;
   collector;
@@ -6480,6 +6506,16 @@ var NativeTelemetryHost = class _NativeTelemetryHost {
   collectorStatus() {
     return this.transport.status();
   }
+  async storeAnimationArtifact(manifest, payload) {
+    return JSON.parse(await this.native.storeAnimationArtifact(JSON.stringify(manifest), payload));
+  }
+  async getAnimationArtifact(artifactId) {
+    const result = await this.native.getAnimationArtifact(artifactId);
+    return Buffer.isBuffer(result) ? result : JSON.parse(result);
+  }
+  async listAnimationArtifacts() {
+    return JSON.parse(await this.native.listAnimationArtifacts());
+  }
   async maintenance() {
     return JSON.parse(await this.native.maintenance());
   }
@@ -6584,7 +6620,7 @@ var NativeTelemetryTransport = class {
   }
 };
 function loadNativeModule() {
-  const require2 = (0, import_node_module.createRequire)((0, import_node_path3.resolve)(process.cwd(), "package.json"));
+  const require2 = (0, import_node_module.createRequire)(typeof __filename === "string" ? __filename : import_meta2.url);
   const packageRoot = (0, import_node_path3.dirname)(require2.resolve("@noego/telemetry/package.json"));
   const modulePath = (0, import_node_path3.resolve)(packageRoot, "native", "noego_telemetry_native.node");
   const loaded = require2(modulePath);