@noego/telemetry 0.0.5 → 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 === "*"
       }
     };