@grest-ts/metrics 0.0.5

package/dist/src/keys/GGLazyGaugeKey.d.ts

@@ -0,0 +1,21 @@
+import { GGMetricKey } from "../GGMetricKey.js";
+import { GGLazyGauge } from "../metric/GGLazyGauge.js";
+import { GGMetricOptionsBase } from "../GGMetric.js";
+export interface LazyGaugeOptions extends GGMetricOptionsBase {
+    getValue: () => number;
+}
+/**
+ * Key for a lazy gauge metric.
+ * The getValue function is called whenever the metric value is read.
+ */
+export declare class GGLazyGaugeKey extends GGMetricKey<{}, GGLazyGauge> {
+    readonly options: LazyGaugeOptions;
+    constructor(name: string, options: LazyGaugeOptions);
+    create(): GGLazyGauge;
+    /**
+     * Get the current value by calling the getValue function.
+     */
+    getValue(): number;
+    reset(): void;
+}
+//# sourceMappingURL=GGLazyGaugeKey.d.ts.map

package/dist/src/keys/GGLazyGaugeKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLazyGaugeKey.d.ts","sourceRoot":"","sources":["../../../src/keys/GGLazyGaugeKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAC,mBAAmB,EAAC,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IACzD,QAAQ,EAAE,MAAM,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC;IAE5D,SAAwB,OAAO,EAAE,gBAAgB,CAAC;gBAEtC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB;IAK5C,MAAM,IAAI,WAAW;IAI5B;;OAEG;IACI,QAAQ,IAAI,MAAM;IAIlB,KAAK,IAAI,IAAI;CAGvB"}

package/dist/src/keys/GGLazyGaugeKey.js

@@ -0,0 +1,25 @@
+import { GGMetricKey } from "../GGMetricKey.js";
+import { GGLazyGauge } from "../metric/GGLazyGauge.js";
+/**
+ * Key for a lazy gauge metric.
+ * The getValue function is called whenever the metric value is read.
+ */
+export class GGLazyGaugeKey extends GGMetricKey {
+    constructor(name, options) {
+        super(name, options);
+        Object.freeze(this);
+    }
+    create() {
+        return new GGLazyGauge(this);
+    }
+    /**
+     * Get the current value by calling the getValue function.
+     */
+    getValue() {
+        return this.getMetric().getValue();
+    }
+    reset() {
+        // No-op for lazy gauge - nothing to reset
+    }
+}
+//# sourceMappingURL=GGLazyGaugeKey.js.map

package/dist/src/keys/GGLazyGaugeKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLazyGaugeKey.js","sourceRoot":"","sources":["../../../src/keys/GGLazyGaugeKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAOrD;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,WAA4B;IAI5D,YAAY,IAAY,EAAE,OAAyB;QAC/C,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAEM,MAAM;QACT,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,QAAQ;QACX,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC;IACvC,CAAC;IAEM,KAAK;QACR,0CAA0C;IAC9C,CAAC;CACJ"}

package/dist/src/metric/GGCounter.d.ts

@@ -0,0 +1,7 @@
+import { GGMetric, GGMetricLabels, LabelsArgs } from "../GGMetric.js";
+import type { GGCounterKey } from "../keys/GGCounterKey";
+export declare class GGCounter<TLabels extends GGMetricLabels = {}> extends GGMetric<TLabels, number, GGCounterKey<TLabels>> {
+    protected getDefaultValue(): number;
+    inc(value?: number, ...args: LabelsArgs<TLabels>): void;
+}
+//# sourceMappingURL=GGCounter.d.ts.map

package/dist/src/metric/GGCounter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGCounter.d.ts","sourceRoot":"","sources":["../../../src/metric/GGCounter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAC,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAEvD,qBAAa,SAAS,CAClB,OAAO,SAAS,cAAc,GAAG,EAAE,CACrC,SAAQ,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAEtD,SAAS,CAAC,eAAe,IAAI,MAAM;IAI5B,GAAG,CAAC,KAAK,GAAE,MAAU,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI;CAOpE"}

package/dist/src/metric/GGCounter.js

@@ -0,0 +1,14 @@
+import { GGMetric } from "../GGMetric.js";
+export class GGCounter extends GGMetric {
+    getDefaultValue() {
+        return 0;
+    }
+    inc(value = 1, ...args) {
+        const key = this.getKey(args[0]);
+        const current = this.getByKey(key);
+        if (current !== undefined) {
+            this.setByKey(key, current + value);
+        }
+    }
+}
+//# sourceMappingURL=GGCounter.js.map

package/dist/src/metric/GGCounter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGCounter.js","sourceRoot":"","sources":["../../../src/metric/GGCounter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAA6B,MAAM,gBAAgB,CAAC;AAGpE,MAAM,OAAO,SAEX,SAAQ,QAAgD;IAE5C,eAAe;QACrB,OAAO,CAAC,CAAC;IACb,CAAC;IAEM,GAAG,CAAC,QAAgB,CAAC,EAAE,GAAG,IAAyB;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAY,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC;QACxC,CAAC;IACL,CAAC;CACJ"}

package/dist/src/metric/GGGauge.d.ts

@@ -0,0 +1,9 @@
+import { GGMetric, GGMetricLabels, LabelsArgs } from "../GGMetric.js";
+import type { GGGaugeKey } from "../keys/GGGaugeKey";
+export declare class GGGauge<TLabels extends GGMetricLabels = {}> extends GGMetric<TLabels, number, GGGaugeKey<TLabels>> {
+    protected getDefaultValue(): number;
+    set(value: number, ...args: LabelsArgs<TLabels>): void;
+    inc(value?: number, ...args: LabelsArgs<TLabels>): void;
+    dec(value?: number, ...args: LabelsArgs<TLabels>): void;
+}
+//# sourceMappingURL=GGGauge.d.ts.map

package/dist/src/metric/GGGauge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGGauge.d.ts","sourceRoot":"","sources":["../../../src/metric/GGGauge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAC,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,oBAAoB,CAAC;AAEnD,qBAAa,OAAO,CAChB,OAAO,SAAS,cAAc,GAAG,EAAE,CACrC,SAAQ,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAEpD,SAAS,CAAC,eAAe,IAAI,MAAM;IAI5B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI;IAStD,GAAG,CAAC,KAAK,GAAE,MAAU,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI;IAS1D,GAAG,CAAC,KAAK,GAAE,MAAU,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI;CAQpE"}

package/dist/src/metric/GGGauge.js

@@ -0,0 +1,31 @@
+import { GGMetric } from "../GGMetric.js";
+export class GGGauge extends GGMetric {
+    getDefaultValue() {
+        return 0;
+    }
+    set(value, ...args) {
+        const key = this.getKey(args[0]);
+        const current = this.getByKey(key);
+        if (current === undefined) {
+            return;
+        }
+        this.setByKey(key, value);
+    }
+    inc(value = 1, ...args) {
+        const key = this.getKey(args[0]);
+        const current = this.getByKey(key);
+        if (current === undefined) {
+            return;
+        }
+        this.setByKey(key, current + value);
+    }
+    dec(value = 1, ...args) {
+        const key = this.getKey(args[0]);
+        const current = this.getByKey(key);
+        if (current === undefined) {
+            return;
+        }
+        this.setByKey(key, current - value);
+    }
+}
+//# sourceMappingURL=GGGauge.js.map

package/dist/src/metric/GGGauge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGGauge.js","sourceRoot":"","sources":["../../../src/metric/GGGauge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAA6B,MAAM,gBAAgB,CAAC;AAGpE,MAAM,OAAO,OAEX,SAAQ,QAA8C;IAE1C,eAAe;QACrB,OAAO,CAAC,CAAC;IACb,CAAC;IAEM,GAAG,CAAC,KAAa,EAAE,GAAG,IAAyB;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAY,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEM,GAAG,CAAC,QAAgB,CAAC,EAAE,GAAG,IAAyB;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAY,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC;IACxC,CAAC;IAEM,GAAG,CAAC,QAAgB,CAAC,EAAE,GAAG,IAAyB;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAY,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC;IACxC,CAAC;CACJ"}

package/dist/src/metric/GGHistogram.d.ts

@@ -0,0 +1,27 @@
+import { GGMetric, GGMetricLabels, GGMetricOptions, LabelsArgs } from "../GGMetric.js";
+import type { GGHistogramKey } from "../keys/GGHistogramKey";
+export type HistogramOptions<TLabels extends GGMetricLabels = {}> = GGMetricOptions<TLabels> & {
+    buckets: number[];
+};
+export declare class GGHistogram<TLabels extends GGMetricLabels = {}> extends GGMetric<TLabels, HistogramData, GGHistogramKey<TLabels>> {
+    getBuckets(): number[];
+    protected getDefaultValue(): HistogramData;
+    observe(value: number, ...args: LabelsArgs<TLabels>): void;
+    startTimer(...args: LabelsArgs<TLabels>): () => void;
+}
+export interface HistogramData {
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+    values: number[];
+}
+export interface SerializedHistogramData {
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+    buckets: number[];
+    values: number[];
+}
+//# sourceMappingURL=GGHistogram.d.ts.map

package/dist/src/metric/GGHistogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGHistogram.d.ts","sourceRoot":"","sources":["../../../src/metric/GGHistogram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAC,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,wBAAwB,CAAC;AAE3D,MAAM,MAAM,gBAAgB,CAAC,OAAO,SAAS,cAAc,GAAG,EAAE,IAC5D,eAAe,CAAC,OAAO,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAErD,qBAAa,WAAW,CACpB,OAAO,SAAS,cAAc,GAAG,EAAE,CACrC,SAAQ,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAExD,UAAU,IAAI,MAAM,EAAE;IAI7B,SAAS,CAAC,eAAe,IAAI,aAAa;IAUnC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI;IAqB1D,UAAU,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,MAAM,IAAI;CAK9D;AAED,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/src/metric/GGHistogram.js

@@ -0,0 +1,41 @@
+import { GGMetric } from "../GGMetric.js";
+export class GGHistogram extends GGMetric {
+    getBuckets() {
+        return this.key.buckets;
+    }
+    getDefaultValue() {
+        return {
+            count: 0,
+            sum: 0,
+            min: Infinity,
+            max: -Infinity,
+            values: this.key.buckets.map(() => 0)
+        };
+    }
+    observe(value, ...args) {
+        const key = this.getKey(args[0]);
+        const data = this.getByKey(key);
+        if (data === undefined) {
+            return;
+        }
+        data.count++;
+        data.sum += value;
+        if (value < data.min) {
+            data.min = value;
+        }
+        if (value > data.max) {
+            data.max = value;
+        }
+        for (let i = 0; i < this.key.buckets.length; i++) {
+            if (value <= this.key.buckets[i]) {
+                data.values[i]++;
+            }
+        }
+    }
+    startTimer(...args) {
+        const start = Date.now();
+        const labels = args[0];
+        return () => this.observe(Date.now() - start, ...[labels]);
+    }
+}
+//# sourceMappingURL=GGHistogram.js.map

package/dist/src/metric/GGHistogram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGHistogram.js","sourceRoot":"","sources":["../../../src/metric/GGHistogram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAA8C,MAAM,gBAAgB,CAAC;AAMrF,MAAM,OAAO,WAEX,SAAQ,QAAyD;IAExD,UAAU;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;IAC5B,CAAC;IAES,eAAe;QACrB,OAAO;YACH,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,QAAQ;YACb,GAAG,EAAE,CAAC,QAAQ;YACd,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;SACxC,CAAC;IACN,CAAC;IAEM,OAAO,CAAC,KAAa,EAAE,GAAG,IAAyB;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAY,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,OAAO;QACX,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC;QAClB,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,CAAC;QACL,CAAC;IACL,CAAC;IAEM,UAAU,CAAC,GAAG,IAAyB;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAY,CAAC;QAClC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,GAAI,CAAC,MAAM,CAAyB,CAAC,CAAC;IACxF,CAAC;CACJ"}

package/dist/src/metric/GGLazyGauge.d.ts

@@ -0,0 +1,20 @@
+import { GGMetric } from "../GGMetric.js";
+import type { GGLazyGaugeKey } from "../keys/GGLazyGaugeKey";
+/**
+ * A gauge that computes its value lazily by calling a function.
+ * Perfect for "current state" metrics like memory usage, active handles, etc.
+ * Does not support labels - use regular GGGauge if you need labels.
+ */
+export declare class GGLazyGauge extends GGMetric<{}, number, GGLazyGaugeKey> {
+    protected getDefaultValue(): number;
+    /**
+     * Get the current value by calling the getValue function.
+     */
+    getValue(): number;
+    /**
+     * Returns a map with single entry (empty key -> current value).
+     * Compatible with exporter iteration pattern.
+     */
+    getValues(): Map<string, number>;
+}
+//# sourceMappingURL=GGLazyGauge.d.ts.map

package/dist/src/metric/GGLazyGauge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLazyGauge.d.ts","sourceRoot":"","sources":["../../../src/metric/GGLazyGauge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,wBAAwB,CAAC;AAE3D;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC;IAEjE,SAAS,CAAC,eAAe,IAAI,MAAM;IAInC;;OAEG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;OAGG;IACI,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;CAK1C"}

package/dist/src/metric/GGLazyGauge.js

@@ -0,0 +1,27 @@
+import { GGMetric } from "../GGMetric.js";
+/**
+ * A gauge that computes its value lazily by calling a function.
+ * Perfect for "current state" metrics like memory usage, active handles, etc.
+ * Does not support labels - use regular GGGauge if you need labels.
+ */
+export class GGLazyGauge extends GGMetric {
+    getDefaultValue() {
+        return 0;
+    }
+    /**
+     * Get the current value by calling the getValue function.
+     */
+    getValue() {
+        return this.key.options.getValue();
+    }
+    /**
+     * Returns a map with single entry (empty key -> current value).
+     * Compatible with exporter iteration pattern.
+     */
+    getValues() {
+        const map = new Map();
+        map.set('', this.getValue());
+        return map;
+    }
+}
+//# sourceMappingURL=GGLazyGauge.js.map

package/dist/src/metric/GGLazyGauge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGLazyGauge.js","sourceRoot":"","sources":["../../../src/metric/GGLazyGauge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAGxC;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,QAAoC;IAEvD,eAAe;QACrB,OAAO,CAAC,CAAC;IACb,CAAC;IAED;;OAEG;IACI,QAAQ;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,SAAS;QACZ,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;QACtC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7B,OAAO,GAAG,CAAC;IACf,CAAC;CACJ"}

package/dist/src/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "//": "THIS FILE IS GENERATED - DO NOT EDIT",
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": ".",
+    "lib": [
+      "ES2022"
+    ],
+    "types": [
+      "node"
+    ]
+  },
+  "include": [
+    "**/*"
+  ]
+}

package/dist/testkit/GGMetricsCommands.d.ts

@@ -0,0 +1,18 @@
+import { SerializedHistogramData } from "../src/metric/GGHistogram.js";
+export interface MetricSnapshotRequest {
+    metricName: string;
+}
+export interface MetricSnapshotResponse {
+    name: string;
+    type: string;
+    help: string;
+    buckets?: number[];
+    values: Array<[string, number | SerializedHistogramData]>;
+}
+export declare const GGMetricsIPC: {
+    worker: {
+        getSnapshot: import("@grest-ts/ipc").IPCClientRequest<MetricSnapshotRequest, MetricSnapshotResponse>;
+        reset: import("@grest-ts/ipc").IPCClientRequest<void, void>;
+    };
+};
+//# sourceMappingURL=GGMetricsCommands.d.ts.map

package/dist/testkit/GGMetricsCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetricsCommands.d.ts","sourceRoot":"","sources":["../../testkit/GGMetricsCommands.ts"],"names":[],"mappings":"AAKA,OAAO,EAA6B,uBAAuB,EAAC,MAAM,8BAA8B,CAAC;AAEjG,MAAM,WAAW,qBAAqB;IAClC,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CAAC,CAAC,CAAC;CAC7D;AAaD,eAAO,MAAM,YAAY;;;;;CAKxB,CAAA"}

package/dist/testkit/GGMetricsCommands.js

@@ -0,0 +1,77 @@
+import { GG_TEST_RUNTIME_WORKER, GGTestRuntimeWorker } from "@grest-ts/testkit";
+import { IPCClient } from "@grest-ts/ipc";
+import { GG_METRICS } from "../src/GGMetricsLoader.js";
+import { GGCounter } from "../src/metric/GGCounter.js";
+import { GGGauge } from "../src/metric/GGGauge.js";
+import { GGHistogram } from "../src/metric/GGHistogram.js";
+function serializeHistogramData(data, buckets) {
+    return {
+        count: data.count,
+        sum: data.sum,
+        min: data.min,
+        max: data.max,
+        buckets: buckets,
+        values: [...data.values]
+    };
+}
+export const GGMetricsIPC = {
+    worker: {
+        getSnapshot: IPCClient.defineRequest("metrics.getSnapshot"),
+        reset: IPCClient.defineRequest("metrics.reset"),
+    }
+};
+GGTestRuntimeWorker.onBeforeRuntimeStart(() => {
+    const worker = GG_TEST_RUNTIME_WORKER.get();
+    worker.onIpcRequest(GGMetricsIPC.worker.getSnapshot, (payload) => {
+        const store = GG_METRICS.tryGet();
+        if (!store)
+            return null;
+        for (const metric of store.getAllMetrics()) {
+            if (metric.name === payload.metricName) {
+                if (metric instanceof GGCounter) {
+                    const values = [];
+                    for (const [key, value] of metric.getValues()) {
+                        values.push([key, value]);
+                    }
+                    return {
+                        name: metric.name,
+                        type: 'counter',
+                        help: metric.key.help,
+                        values
+                    };
+                }
+                else if (metric instanceof GGGauge) {
+                    const values = [];
+                    for (const [key, value] of metric.getValues()) {
+                        values.push([key, value]);
+                    }
+                    return {
+                        name: metric.name,
+                        type: 'gauge',
+                        help: metric.key.help,
+                        values
+                    };
+                }
+                else if (metric instanceof GGHistogram) {
+                    const buckets = metric.getBuckets();
+                    const values = [];
+                    for (const [key, data] of metric.getValues()) {
+                        values.push([key, serializeHistogramData(data, buckets)]);
+                    }
+                    return {
+                        name: metric.name,
+                        type: 'histogram',
+                        help: metric.key.help,
+                        buckets,
+                        values
+                    };
+                }
+            }
+        }
+        return null;
+    });
+    worker.onIpcRequest(GGMetricsIPC.worker.reset, () => {
+        GG_METRICS.tryGet()?.reset();
+    });
+});
+//# sourceMappingURL=GGMetricsCommands.js.map

package/dist/testkit/GGMetricsCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetricsCommands.js","sourceRoot":"","sources":["../../testkit/GGMetricsCommands.ts"],"names":[],"mappings":"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"}

package/dist/testkit/GGMetricsInterceptor.d.ts

@@ -0,0 +1,34 @@
+import { IGGTestInterceptor } from "@grest-ts/testkit";
+import type { GGTestRuntime } from "@grest-ts/testkit";
+import { GGMetricLabels } from "../src/GGMetric.js";
+export interface MetricExpectation<TLabels> {
+    labels: TLabels;
+    delta: number;
+    type: 'inc' | 'incAtLeast' | 'dec' | 'observation' | 'noChange';
+}
+export declare class GGMetricsInterceptor<TLabels extends GGMetricLabels> implements IGGTestInterceptor {
+    private readonly metricName;
+    private readonly labelNames;
+    private readonly runtimes;
+    private readonly expectations;
+    private readonly noChangeExpected;
+    private readonly definedInSourceFile;
+    private beforeSnapshot;
+    private validationError;
+    private wasRegistered;
+    constructor(metricName: string, labelNames: readonly string[], runtimes: GGTestRuntime[], expectations: MetricExpectation<TLabels>[], noChangeExpected: boolean, definedInSourceFile: string);
+    register(): Promise<void>;
+    unregister(): void;
+    validate(): Promise<void>;
+    private getSnapshotsFromRuntimes;
+    private mergeSnapshots;
+    private mergeValues;
+    private validateNoChange;
+    private validateExpectation;
+    private getCount;
+    private valuesEqual;
+    private labelsToKey;
+    getMockValidationError(): Error | undefined;
+    isCalled(): boolean;
+}
+//# sourceMappingURL=GGMetricsInterceptor.d.ts.map

package/dist/testkit/GGMetricsInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetricsInterceptor.d.ts","sourceRoot":"","sources":["../../testkit/GGMetricsInterceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAC,cAAc,EAAC,MAAM,oBAAoB,CAAC;AAGlD,MAAM,WAAW,iBAAiB,CAAC,OAAO;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,YAAY,GAAG,KAAK,GAAG,aAAa,GAAG,UAAU,CAAC;CACnE;AA8BD,qBAAa,oBAAoB,CAAC,OAAO,SAAS,cAAc,CAAE,YAAW,kBAAkB;IAMvF,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAVxC,OAAO,CAAC,cAAc,CAAkD;IACxE,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,aAAa,CAAS;gBAGT,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,QAAQ,EAAE,aAAa,EAAE,EACzB,YAAY,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,EAC1C,gBAAgB,EAAE,OAAO,EACzB,mBAAmB,EAAE,MAAM;IAG1C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B,UAAU,IAAI,IAAI;IAEZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAkBjB,wBAAwB;IAkBtC,OAAO,CAAC,cAAc;IA0BtB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,mBAAmB;IAgE3B,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,WAAW;IAQnB,sBAAsB,IAAI,KAAK,GAAG,SAAS;IAI3C,QAAQ,IAAI,OAAO;CAGtB"}

package/dist/testkit/GGMetricsInterceptor.js

@@ -0,0 +1,202 @@
+import { GGMetricsIPC } from "./GGMetricsCommands.js";
+function deserializeHistogramData(data) {
+    return {
+        count: data.count,
+        sum: data.sum,
+        min: data.min,
+        max: data.max,
+        values: [...data.values]
+    };
+}
+function isSerializedHistogram(value) {
+    return typeof value === 'object' && value !== null && 'buckets' in value && 'count' in value;
+}
+function snapshotToMap(snapshot) {
+    const map = new Map();
+    if (!snapshot)
+        return map;
+    for (const [key, value] of snapshot.values) {
+        if (isSerializedHistogram(value)) {
+            map.set(key, deserializeHistogramData(value));
+        }
+        else {
+            map.set(key, value);
+        }
+    }
+    return map;
+}
+export class GGMetricsInterceptor {
+    metricName;
+    labelNames;
+    runtimes;
+    expectations;
+    noChangeExpected;
+    definedInSourceFile;
+    beforeSnapshot = new Map();
+    validationError;
+    wasRegistered = false;
+    constructor(metricName, labelNames, runtimes, expectations, noChangeExpected, definedInSourceFile) {
+        this.metricName = metricName;
+        this.labelNames = labelNames;
+        this.runtimes = runtimes;
+        this.expectations = expectations;
+        this.noChangeExpected = noChangeExpected;
+        this.definedInSourceFile = definedInSourceFile;
+    }
+    async register() {
+        this.wasRegistered = true;
+        const snapshots = await this.getSnapshotsFromRuntimes();
+        this.beforeSnapshot = this.mergeSnapshots(snapshots);
+    }
+    unregister() { }
+    async validate() {
+        const afterSnapshots = await this.getSnapshotsFromRuntimes();
+        const after = this.mergeSnapshots(afterSnapshots);
+        try {
+            if (this.noChangeExpected) {
+                this.validateNoChange(this.beforeSnapshot, after);
+            }
+            for (const expectation of this.expectations) {
+                this.validateExpectation(expectation, this.beforeSnapshot, after);
+            }
+        }
+        catch (e) {
+            this.validationError = e instanceof Error ? e : new Error(String(e));
+            throw this.validationError;
+        }
+    }
+    async getSnapshotsFromRuntimes() {
+        const results = [];
+        await Promise.all(this.runtimes.map(async (runtime) => {
+            const snapshot = await runtime.sendCommand(GGMetricsIPC.worker.getSnapshot, { metricName: this.metricName });
+            if (snapshot) {
+                results.push(snapshot);
+            }
+        }));
+        return results;
+    }
+    mergeSnapshots(snapshots) {
+        const merged = new Map();
+        for (const snapshot of snapshots) {
+            const map = snapshotToMap(snapshot);
+            for (const [key, value] of map) {
+                const existing = merged.get(key);
+                if (existing === undefined) {
+                    merged.set(key, value);
+                }
+                else if (typeof existing === 'number' && typeof value === 'number') {
+                    merged.set(key, existing + value);
+                }
+                else if (typeof existing === 'object' && typeof value === 'object') {
+                    merged.set(key, {
+                        count: existing.count + value.count,
+                        sum: existing.sum + value.sum,
+                        min: Math.min(existing.min, value.min),
+                        max: Math.max(existing.max, value.max),
+                        values: this.mergeValues(existing.values, value.values)
+                    });
+                }
+            }
+        }
+        return merged;
+    }
+    mergeValues(a, b) {
+        const result = [];
+        const len = Math.max(a.length, b.length);
+        for (let i = 0; i < len; i++) {
+            result.push((a[i] ?? 0) + (b[i] ?? 0));
+        }
+        return result;
+    }
+    validateNoChange(before, after) {
+        for (const [key, beforeVal] of before) {
+            const afterVal = after.get(key);
+            if (!this.valuesEqual(beforeVal, afterVal)) {
+                throw new Error(`[Metrics Test Failed] Expected no change in metric "${this.metricName}" ` +
+                    `but {${key}} changed\n\t${this.definedInSourceFile}`);
+            }
+        }
+        for (const key of after.keys()) {
+            if (!before.has(key)) {
+                throw new Error(`[Metrics Test Failed] Expected no change in metric "${this.metricName}" ` +
+                    `but new label combination {${key}} appeared\n\t${this.definedInSourceFile}`);
+            }
+        }
+    }
+    validateExpectation(exp, before, after) {
+        const key = this.labelsToKey(exp.labels);
+        const beforeVal = before.get(key);
+        const afterVal = after.get(key);
+        switch (exp.type) {
+            case 'inc':
+            case 'dec': {
+                const beforeNum = typeof beforeVal === 'number' ? beforeVal : 0;
+                const afterNum = typeof afterVal === 'number' ? afterVal : 0;
+                const actualDelta = afterNum - beforeNum;
+                if (actualDelta !== exp.delta) {
+                    throw new Error(`[Metrics Test Failed] Expected metric "${this.metricName}" {${key || '(no labels)'}} ` +
+                        `to change by ${exp.delta}, but actual delta was ${actualDelta}\n\t${this.definedInSourceFile}`);
+                }
+                break;
+            }
+            case 'incAtLeast': {
+                const beforeNum = typeof beforeVal === 'number' ? beforeVal : 0;
+                const afterNum = typeof afterVal === 'number' ? afterVal : 0;
+                const actualDelta = afterNum - beforeNum;
+                if (actualDelta < exp.delta) {
+                    throw new Error(`[Metrics Test Failed] Expected metric "${this.metricName}" {${key || '(no labels)'}} ` +
+                        `to change by at least ${exp.delta}, but actual delta was ${actualDelta}\n\t${this.definedInSourceFile}`);
+                }
+                break;
+            }
+            case 'observation': {
+                const beforeCount = this.getCount(beforeVal);
+                const afterCount = this.getCount(afterVal);
+                if (afterCount <= beforeCount) {
+                    throw new Error(`[Metrics Test Failed] Expected observation in metric "${this.metricName}" {${key || '(no labels)'}} ` +
+                        `but count did not increase\n\t${this.definedInSourceFile}`);
+                }
+                break;
+            }
+            case 'noChange': {
+                if (!this.valuesEqual(beforeVal, afterVal)) {
+                    throw new Error(`[Metrics Test Failed] Expected no change for metric "${this.metricName}" {${key || '(no labels)'}} ` +
+                        `but value changed\n\t${this.definedInSourceFile}`);
+                }
+                break;
+            }
+        }
+    }
+    getCount(val) {
+        if (val === undefined)
+            return 0;
+        if (typeof val === 'number')
+            return val;
+        return val.count;
+    }
+    valuesEqual(a, b) {
+        if (a === b)
+            return true;
+        if (typeof a === 'number' && typeof b === 'number')
+            return a === b;
+        if (typeof a === 'object' && typeof b === 'object' && a !== null && b !== null) {
+            return a.count === b.count && a.sum === b.sum;
+        }
+        return false;
+    }
+    labelsToKey(labels) {
+        if (!labels || Object.keys(labels).length === 0)
+            return '';
+        // Use the same order as the metric's labelNames
+        return this.labelNames
+            .map(name => `${name}=${labels[name] ?? ''}`)
+            .join(',');
+    }
+    getMockValidationError() {
+        return this.validationError;
+    }
+    isCalled() {
+        return this.wasRegistered;
+    }
+}
+//# sourceMappingURL=GGMetricsInterceptor.js.map