@noego/telemetry 0.0.3 → 0.1.0

package/dist/node/index.d.cts

@@ -1,16 +1,18 @@
-import { T as TelemetryAdmissionPolicy, M as MetadataSnapshotLimits, a as TelemetryClient } from '../telemetry_client-CYaPYfOl.cjs';
-import { T as TelemetrySinkPlugin, c as MaintenanceLifecycleEvent, e as TelemetryCollectorRuntime, f as TelemetryCollectorStatus } from '../maintenance_coordinator.types-C4ULi4A4.cjs';
-import { S as SqliteTargetConfiguration, M as MetricDefinition } from '../query.types-DuYWbFFe.cjs';
-import { T as TelemetryStorageTransport, e as TelemetryStorageTarget, a as TelemetryStorageCapabilities } from '../storage.types-Bji_pWqr.cjs';
-import { a as TelemetryBatchValidationLimits, c as TelemetryBatchReceiver } from '../transport.types-BAl_TRtU.cjs';
+import { T as TelemetryAdmissionPolicy, M as MetadataSnapshotLimits, a as TelemetryClient } from '../telemetry_client-Bg5tbj5E.cjs';
+import { T as TelemetrySinkPlugin, c as MaintenanceLifecycleEvent, e as TelemetryCollectorRuntime, f as TelemetryCollectorStatus } from '../maintenance_coordinator.types-Crhx9i9k.cjs';
+import { S as SqliteTargetConfiguration } from '../query.types-CRqAsGTX.cjs';
+import { M as MetricDefinition } from '../metric.types-Dg4eZq6u.cjs';
+import { T as TelemetryStorageTransport, e as TelemetryStorageTarget, a as TelemetryStorageCapabilities } from '../storage.types-DHbAm3j_.cjs';
+import { a as TelemetryBatchValidationLimits, c as TelemetryBatchReceiver } from '../transport.types-C2dP-eed.cjs';
 import { NodeTelemetryProducerOptions } from './producer/index.cjs';
 export { NodeTelemetryProducerHost } from './producer/index.cjs';
 export { SQLiteTelemetryTransport } from '../sqlite/index.cjs';
-export { a as NodeTelemetryConfigurationParseOptions, N as NodeTelemetryConfigurationParser, T as TelemetryConfigurationError, b as TelemetryDurationParser } from '../telemetry_configuration_parser-CgSN7R6A.cjs';
-export { D as DEFAULT_METADATA_SNAPSHOT_LIMITS, a as DEFAULT_TELEMETRY_ADMISSION_POLICY } from '../client_defaults-C9LnSX4j.cjs';
-import '../envelope.types-rOLpWXRC.cjs';
+export { a as NodeTelemetryConfigurationParseOptions, N as NodeTelemetryConfigurationParser, T as TelemetryConfigurationError, b as TelemetryDurationParser } from '../telemetry_configuration_parser-ybeweUPE.cjs';
+export { D as DEFAULT_METADATA_SNAPSHOT_LIMITS, a as DEFAULT_TELEMETRY_ADMISSION_POLICY } from '../client_defaults-lDbWYWWK.cjs';
+import '../json.types-BqS77fcN.cjs';
+import '../envelope.types-DyrlRG49.cjs';
 import '../result.types-171Huujb.cjs';
-import '../metric_definition_contract-DfhhmTZ1.cjs';
+import '../metric_definition_contract-DoAk7NOw.cjs';
 
 type NodeLocalTelemetryProducerOptions = Omit<NodeTelemetryProducerOptions, 'transport'>;
 type NodeTelemetryCollectorOptions = Readonly<{
@@ -36,6 +38,47 @@ type NodeCombinedTelemetryOptions = Readonly<{
     batchValidation?: Partial<TelemetryBatchValidationLimits>;
     observeMaintenance?: (event: MaintenanceLifecycleEvent) => void;
 }>;
+type AnimationRun = Readonly<{
+    runUuid: string;
+    runCode: number;
+    elementCode: number;
+    animationCode: number;
+    startedUs: number;
+    endedUs: number;
+    frameCount: number;
+    outcome: string;
+    maxDrift: number;
+    maxResidual: number;
+}>;
+type AnimationDictionaryEntry = Readonly<{
+    kind: string;
+    code: number;
+    identity: string;
+    digest: string | null;
+}>;
+type AnimationArtifactManifest = Readonly<{
+    artifactId: string;
+    records: number;
+    startedUs: number;
+    endedUs: number;
+    reason: string;
+    sha256: string;
+    sequence: number;
+    drops: number;
+    overruns: number;
+    byteCount: number;
+    persistedAt: number;
+    conversationId: string | null;
+    runs: readonly AnimationRun[];
+    dictionary: readonly AnimationDictionaryEntry[];
+}>;
+type AnimationArtifactMetadata = Omit<AnimationArtifactManifest, 'runs' | 'dictionary'>;
+type AnimationArtifactError = Readonly<{
+    ok: false;
+    error: Readonly<{
+        code: string;
+    }>;
+}>;
 
 declare class NodeTelemetryHost {
     readonly client: TelemetryClient | null;
@@ -68,7 +111,16 @@ declare class NativeTelemetryHost {
     stop(deadlineMs: number): Promise<void>;
     status(): Promise<unknown>;
     collectorStatus(): TelemetryCollectorStatus;
+    storeAnimationArtifact(manifest: AnimationArtifactManifest, payload: Buffer): Promise<{
+        ok: true;
+        artifactId: string;
+    } | AnimationArtifactError>;
+    getAnimationArtifact(artifactId: string): Promise<Buffer | AnimationArtifactError>;
+    listAnimationArtifacts(): Promise<{
+        ok: true;
+        artifacts: readonly AnimationArtifactMetadata[];
+    } | AnimationArtifactError>;
     maintenance(): Promise<unknown>;
 }
 
-export { NativeTelemetryHost, type NodeCombinedTelemetryOptions, type NodeLocalTelemetryProducerOptions, type NodeTelemetryCollectorOptions, NodeTelemetryHost, NodeTelemetryProducerOptions };
+export { type AnimationArtifactError, type AnimationArtifactManifest, type AnimationArtifactMetadata, type AnimationDictionaryEntry, type AnimationRun, NativeTelemetryHost, type NodeCombinedTelemetryOptions, type NodeLocalTelemetryProducerOptions, type NodeTelemetryCollectorOptions, NodeTelemetryHost, NodeTelemetryProducerOptions };

package/dist/node/index.d.ts

@@ -1,16 +1,18 @@
-import { T as TelemetryAdmissionPolicy, M as MetadataSnapshotLimits, a as TelemetryClient } from '../telemetry_client-BXw8WH_F.js';
-import { T as TelemetrySinkPlugin, c as MaintenanceLifecycleEvent, e as TelemetryCollectorRuntime, f as TelemetryCollectorStatus } from '../maintenance_coordinator.types-ikUrRXmO.js';
-import { S as SqliteTargetConfiguration, M as MetricDefinition } from '../query.types-DU5v7vM0.js';
-import { T as TelemetryStorageTransport, e as TelemetryStorageTarget, a as TelemetryStorageCapabilities } from '../storage.types-k7oElEB3.js';
-import { a as TelemetryBatchValidationLimits, c as TelemetryBatchReceiver } from '../transport.types-DDnZoKWi.js';
+import { T as TelemetryAdmissionPolicy, M as MetadataSnapshotLimits, a as TelemetryClient } from '../telemetry_client-DWKgufmc.js';
+import { T as TelemetrySinkPlugin, c as MaintenanceLifecycleEvent, e as TelemetryCollectorRuntime, f as TelemetryCollectorStatus } from '../maintenance_coordinator.types-DprmgpVn.js';
+import { S as SqliteTargetConfiguration } from '../query.types-DnOMYXpC.js';
+import { M as MetricDefinition } from '../metric.types-D8aOAnUm.js';
+import { T as TelemetryStorageTransport, e as TelemetryStorageTarget, a as TelemetryStorageCapabilities } from '../storage.types-BKWoIOHp.js';
+import { a as TelemetryBatchValidationLimits, c as TelemetryBatchReceiver } from '../transport.types-SA8KpLiK.js';
 import { NodeTelemetryProducerOptions } from './producer/index.js';
 export { NodeTelemetryProducerHost } from './producer/index.js';
 export { SQLiteTelemetryTransport } from '../sqlite/index.js';
-export { a as NodeTelemetryConfigurationParseOptions, N as NodeTelemetryConfigurationParser, T as TelemetryConfigurationError, b as TelemetryDurationParser } from '../telemetry_configuration_parser-BZ8Nvnle.js';
-export { D as DEFAULT_METADATA_SNAPSHOT_LIMITS, a as DEFAULT_TELEMETRY_ADMISSION_POLICY } from '../client_defaults-B5tC-TgG.js';
-import '../envelope.types-rOLpWXRC.js';
+export { a as NodeTelemetryConfigurationParseOptions, N as NodeTelemetryConfigurationParser, T as TelemetryConfigurationError, b as TelemetryDurationParser } from '../telemetry_configuration_parser-6BR3_dD_.js';
+export { D as DEFAULT_METADATA_SNAPSHOT_LIMITS, a as DEFAULT_TELEMETRY_ADMISSION_POLICY } from '../client_defaults-CZ8PysZX.js';
+import '../json.types-BqS77fcN.js';
+import '../envelope.types-DIvZD3xH.js';
 import '../result.types-171Huujb.js';
-import '../metric_definition_contract-BYtnODhu.js';
+import '../metric_definition_contract-C6MERhJs.js';
 
 type NodeLocalTelemetryProducerOptions = Omit<NodeTelemetryProducerOptions, 'transport'>;
 type NodeTelemetryCollectorOptions = Readonly<{
@@ -36,6 +38,47 @@ type NodeCombinedTelemetryOptions = Readonly<{
     batchValidation?: Partial<TelemetryBatchValidationLimits>;
     observeMaintenance?: (event: MaintenanceLifecycleEvent) => void;
 }>;
+type AnimationRun = Readonly<{
+    runUuid: string;
+    runCode: number;
+    elementCode: number;
+    animationCode: number;
+    startedUs: number;
+    endedUs: number;
+    frameCount: number;
+    outcome: string;
+    maxDrift: number;
+    maxResidual: number;
+}>;
+type AnimationDictionaryEntry = Readonly<{
+    kind: string;
+    code: number;
+    identity: string;
+    digest: string | null;
+}>;
+type AnimationArtifactManifest = Readonly<{
+    artifactId: string;
+    records: number;
+    startedUs: number;
+    endedUs: number;
+    reason: string;
+    sha256: string;
+    sequence: number;
+    drops: number;
+    overruns: number;
+    byteCount: number;
+    persistedAt: number;
+    conversationId: string | null;
+    runs: readonly AnimationRun[];
+    dictionary: readonly AnimationDictionaryEntry[];
+}>;
+type AnimationArtifactMetadata = Omit<AnimationArtifactManifest, 'runs' | 'dictionary'>;
+type AnimationArtifactError = Readonly<{
+    ok: false;
+    error: Readonly<{
+        code: string;
+    }>;
+}>;
 
 declare class NodeTelemetryHost {
     readonly client: TelemetryClient | null;
@@ -68,7 +111,16 @@ declare class NativeTelemetryHost {
     stop(deadlineMs: number): Promise<void>;
     status(): Promise<unknown>;
     collectorStatus(): TelemetryCollectorStatus;
+    storeAnimationArtifact(manifest: AnimationArtifactManifest, payload: Buffer): Promise<{
+        ok: true;
+        artifactId: string;
+    } | AnimationArtifactError>;
+    getAnimationArtifact(artifactId: string): Promise<Buffer | AnimationArtifactError>;
+    listAnimationArtifacts(): Promise<{
+        ok: true;
+        artifacts: readonly AnimationArtifactMetadata[];
+    } | AnimationArtifactError>;
     maintenance(): Promise<unknown>;
 }
 
-export { NativeTelemetryHost, type NodeCombinedTelemetryOptions, type NodeLocalTelemetryProducerOptions, type NodeTelemetryCollectorOptions, NodeTelemetryHost, NodeTelemetryProducerOptions };
+export { type AnimationArtifactError, type AnimationArtifactManifest, type AnimationArtifactMetadata, type AnimationDictionaryEntry, type AnimationRun, NativeTelemetryHost, type NodeCombinedTelemetryOptions, type NodeLocalTelemetryProducerOptions, type NodeTelemetryCollectorOptions, NodeTelemetryHost, NodeTelemetryProducerOptions };

package/dist/node/index.js

@@ -452,11 +452,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 === "*"
       }
     };
@@ -5692,6 +5696,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;
@@ -5754,6 +5766,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" };
@@ -6134,6 +6150,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;
   }
@@ -6446,6 +6471,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());
   }
@@ -6550,7 +6585,7 @@ var NativeTelemetryTransport = class {
   }
 };
 function loadNativeModule() {
-  const require2 = createRequire(resolve3(process.cwd(), "package.json"));
+  const require2 = createRequire(typeof __filename === "string" ? __filename : import.meta.url);
   const packageRoot = dirname2(require2.resolve("@noego/telemetry/package.json"));
   const modulePath = resolve3(packageRoot, "native", "noego_telemetry_native.node");
   const loaded = require2(modulePath);