@grest-ts/metrics 0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Grest Games OÜ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# @grest-ts/metrics
+
+Type-safe metrics collection library for Grest Framework.
+
+## Features
+
+Type-safe metrics collection library with support for counters, gauges, and histograms.
+
+Provides a structured way to define, collect, and export application metrics with:
+
+- Prometheus-style metrics (Counter, Gauge, Histogram)
+- Type-safe labels
+- Centralized metric definitions
+- Multiple export formats
+
+Type-safe metrics collection library with support for counters, gauges, and histograms.
+
+## Quick usage example
+
+```typescript
+// Define metric keys.
+// This additionally acts as documentation of metrics provided by the application.
+export const AppMetrics = GGMetrics.define('/app/', () => ({
+    actions: new GGCounterKey('actions_total', {
+        help: 'Total number of actions',
+        labelNames: ['type']
+    }),
+    // ... add more metrics here. All well documented and type safe.
+}));
+
+// Usage in the runtime.
+AppMetrics.actions.inc(1, {type: "read"}); // labels are typesafe (values are always strings)
+
+```
+
+## Documentation
+
+- [Usage](./README-usage.md) - How to define and collect metrics
+- [Testing](./README-testkit.md) - How to test metric changes with testkit
+- [Extending](./README-extending.md) - How to add custom exporters

package/dist/src/GGMetric.d.ts

@@ -0,0 +1,60 @@
+import { GGMetricKey } from "./GGMetricKey";
+/**
+ * Configuration for grouping metrics in nested exporters.
+ * - labels: Which labels to use for grouping (must be subset of labelNames)
+ * - template: Optional template string for the group key. Use {labelName} for placeholders.
+ *             Missing values become empty strings. Defaults to values.join(',')
+ *             Example: "{api}.{method}" produces "MyApi.myMethod"
+ */
+export interface GroupByConfig<TLabels extends GGMetricLabels = {}> {
+    labels: readonly (keyof TLabels & string)[];
+    template?: string;
+}
+export interface GGMetricOptionsBase {
+    help: string;
+    maxLabelCombinations?: number;
+}
+export interface GGMetricOptionsWithLabels<TLabels extends GGMetricLabels> {
+    help: string;
+    maxLabelCombinations?: number;
+    labelNames: readonly (keyof TLabels & string)[];
+    groupBy?: GroupByConfig<TLabels>;
+}
+/**
+ * Options for metrics. When TLabels has keys, labelNames is required and must match those keys.
+ * Uses {} as "no labels" because keyof {} = never, while keyof Record<string, never> = string.
+ */
+export type GGMetricOptions<TLabels extends GGMetricLabels = {}> = keyof TLabels extends never ? GGMetricOptionsBase : GGMetricOptionsWithLabels<TLabels>;
+export declare abstract class GGMetric<TLabels extends GGMetricLabels = {}, TValue = unknown, TKey extends GGMetricKey<TLabels> = GGMetricKey<TLabels>> {
+    readonly key: TKey;
+    private readonly values;
+    private readonly compiledGetKey;
+    constructor(key: TKey);
+    private compileGetKey;
+    get name(): string;
+    reset(): void;
+    protected abstract getDefaultValue(): TValue;
+    /**
+     * Can't throw.
+     * Uses AOT-compiled function for fast key generation.
+     */
+    protected getKey(labels: TLabels): tMetricKey;
+    /**
+     * Can't throw.
+     */
+    protected getByKey(key: tMetricKey): TValue | undefined;
+    protected setByKey(key: tMetricKey, value: TValue): void;
+    getValue(...args: LabelsArgs<TLabels>): TValue;
+    getValues(): Map<string, TValue>;
+}
+export type tMetricKey = string & {
+    tMetricKey: never;
+};
+export type GGMetricLabels = Record<string, string | number | boolean>;
+/**
+ * Helper type for labels parameter. Makes labels required when TLabels has keys.
+ * - When TLabels = {}, no argument needed
+ * - When TLabels has keys, labels argument is required
+ */
+export type LabelsArgs<TLabels extends GGMetricLabels> = keyof TLabels extends never ? [] : [labels: TLabels];
+//# sourceMappingURL=GGMetric.d.ts.map

package/dist/src/GGMetric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetric.d.ts","sourceRoot":"","sources":["../../src/GGMetric.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,cAAc,GAAG,EAAE;IAC9D,MAAM,EAAE,SAAS,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB,CAAC,OAAO,SAAS,cAAc;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,SAAS,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;IAChD,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,cAAc,GAAG,EAAE,IAC3D,MAAM,OAAO,SAAS,KAAK,GACrB,mBAAmB,GACnB,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAE7C,8BAAsB,QAAQ,CAC1B,OAAO,SAAS,cAAc,GAAG,EAAE,EACnC,MAAM,GAAG,OAAO,EAChB,IAAI,SAAS,WAAW,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC;IAGxD,SAAgB,GAAG,EAAE,IAAI,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkC;gBAE9C,GAAG,EAAE,IAAI;IAK5B,OAAO,CAAC,aAAa;IAerB,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,KAAK,IAAI,IAAI;IAIpB,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,MAAM;IAE5C;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU;IAI7C;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS;IAcvD,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjD,QAAQ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,MAAM;IAI9C,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;CAG1C;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAAE,UAAU,EAAE,KAAK,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,OAAO,SAAS,cAAc,IACjD,MAAM,OAAO,SAAS,KAAK,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/src/GGMetric.js

@@ -0,0 +1,64 @@
+export class GGMetric {
+    key;
+    values = new Map();
+    compiledGetKey;
+    constructor(key) {
+        this.key = key;
+        this.compiledGetKey = this.compileGetKey();
+    }
+    compileGetKey() {
+        const labelNames = this.key.labelNames;
+        if (labelNames.length === 0) {
+            return () => '';
+        }
+        // Build the function body: "name1=" + (l?.name1 ?? "") + ",name2=" + (l?.name2 ?? "")
+        let body = 'return ';
+        for (let i = 0; i < labelNames.length; i++) {
+            const name = labelNames[i];
+            if (i > 0)
+                body += '+","+';
+            body += `"${name}="+(l?.${name}??"")`;
+        }
+        return new Function('l', body);
+    }
+    get name() {
+        return this.key.name;
+    }
+    reset() {
+        this.values.clear();
+    }
+    /**
+     * Can't throw.
+     * Uses AOT-compiled function for fast key generation.
+     */
+    getKey(labels) {
+        return this.compiledGetKey(labels);
+    }
+    /**
+     * Can't throw.
+     */
+    getByKey(key) {
+        const value = this.values.get(key);
+        if (value === undefined) {
+            if (this.values.size >= this.key.maxLabelCombinations) {
+                return undefined;
+            }
+            const defaultValue = this.getDefaultValue();
+            this.setByKey(key, defaultValue);
+            return defaultValue;
+        }
+        else {
+            return value;
+        }
+    }
+    setByKey(key, value) {
+        this.values.set(key, value);
+    }
+    getValue(...args) {
+        return this.getByKey(this.getKey(args[0]));
+    }
+    getValues() {
+        return this.values;
+    }
+}
+//# sourceMappingURL=GGMetric.js.map

package/dist/src/GGMetric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetric.js","sourceRoot":"","sources":["../../src/GGMetric.ts"],"names":[],"mappings":"AAmCA,MAAM,OAAgB,QAAQ;IAMV,GAAG,CAAO;IACT,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACnC,cAAc,CAAkC;IAEjE,YAAmB,GAAS;QACxB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IAC/C,CAAC;IAEO,aAAa;QACjB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;QACvC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,GAAG,EAAE,CAAC,EAAgB,CAAC;QAClC,CAAC;QACD,sFAAsF;QACtF,IAAI,IAAI,GAAG,SAAS,CAAC;QACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC;gBAAE,IAAI,IAAI,OAAO,CAAC;YAC3B,IAAI,IAAI,IAAI,IAAI,UAAU,IAAI,OAAO,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAoC,CAAC;IACtE,CAAC;IAED,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACzB,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAID;;;OAGG;IACO,MAAM,CAAC,MAAe;QAC5B,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACO,QAAQ,CAAC,GAAe;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;gBACpD,OAAO,SAAS,CAAC;YACrB,CAAC;YACD,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YACjC,OAAO,YAAY,CAAC;QACxB,CAAC;aAAM,CAAC;YACJ,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAES,QAAQ,CAAC,GAAe,EAAE,KAAa;QAC7C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAEM,QAAQ,CAAC,GAAG,IAAyB;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEM,SAAS;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CACJ"}

package/dist/src/GGMetricKey.d.ts

@@ -0,0 +1,13 @@
+import { GGMetric, GGMetricLabels, GGMetricOptions, GroupByConfig } from "./GGMetric.js";
+export declare abstract class GGMetricKey<TLabels extends GGMetricLabels = {}, TMetric extends GGMetric<TLabels, any, any> = GGMetric<TLabels, any, any>> {
+    readonly root: string;
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: readonly string[];
+    readonly maxLabelCombinations?: number;
+    readonly groupBy?: GroupByConfig<TLabels>;
+    protected constructor(name: string, options: GGMetricOptions<TLabels>);
+    protected getMetric(): TMetric;
+    abstract create(): TMetric;
+}
+//# sourceMappingURL=GGMetricKey.d.ts.map

package/dist/src/GGMetricKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetricKey.d.ts","sourceRoot":"","sources":["../../src/GGMetricKey.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAC,MAAM,eAAe,CAAC;AAEvF,8BAAsB,WAAW,CAC7B,OAAO,SAAS,cAAc,GAAG,EAAE,EACnC,OAAO,SAAS,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC;IAGzE,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,SAAgB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9C,SAAgB,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAEjD,SAAS,aAAa,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC;IAgBrE,SAAS,CAAC,SAAS,IAAI,OAAO;aAId,MAAM,IAAI,OAAO;CACpC"}

package/dist/src/GGMetricKey.js

@@ -0,0 +1,29 @@
+import { GGMetrics } from "./GGMetrics.js";
+import { GG_METRICS } from "./GGMetricsLoader.js";
+export class GGMetricKey {
+    root;
+    name;
+    help;
+    labelNames;
+    maxLabelCombinations;
+    groupBy;
+    constructor(name, options) {
+        this.root = GGMetrics.getDefinitionContext();
+        if (!this.root) {
+            throw new Error("Metric key must be created inside GGMetrics.define()");
+        }
+        this.name = this.root + name;
+        this.help = options.help;
+        this.labelNames = ('labelNames' in options ? options.labelNames : []);
+        this.maxLabelCombinations = options.maxLabelCombinations;
+        this.groupBy = ('groupBy' in options ? options.groupBy : undefined);
+        Object.freeze(this.labelNames);
+        if (this.groupBy) {
+            Object.freeze(this.groupBy.labels);
+        }
+    }
+    getMetric() {
+        return GG_METRICS.get().get(this);
+    }
+}
+//# sourceMappingURL=GGMetricKey.js.map

package/dist/src/GGMetricKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetricKey.js","sourceRoot":"","sources":["../../src/GGMetricKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAGhD,MAAM,OAAgB,WAAW;IAKb,IAAI,CAAS;IACb,IAAI,CAAS;IACb,IAAI,CAAS;IACb,UAAU,CAAoB;IAC9B,oBAAoB,CAAU;IAC9B,OAAO,CAA0B;IAEjD,YAAsB,IAAY,EAAE,OAAiC;QACjE,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,oBAAoB,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAwC,CAAC;QAC7G,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;QACzD,IAAI,CAAC,OAAO,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAuC,CAAC;QAC1G,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;IAES,SAAS;QACf,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAY,CAAC;IACjD,CAAC;CAGJ"}

package/dist/src/GGMetrics.d.ts

@@ -0,0 +1,10 @@
+export type GGMetricsDefinition<T> = T & {
+    __isGGMetricsDefinition: never;
+};
+export declare class GGMetrics {
+    static define<T>(name: string, define: () => T): GGMetricsDefinition<T>;
+    static getDefinitionContext(): string;
+    static toJSON(metrics: GGMetricsDefinition<any>): Record<string, unknown>;
+    private static collectKeys;
+}
+//# sourceMappingURL=GGMetrics.d.ts.map

package/dist/src/GGMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetrics.d.ts","sourceRoot":"","sources":["../../src/GGMetrics.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,uBAAuB,EAAE,KAAK,CAAA;CAAE,CAAC;AAE5E,qBAAa,SAAS;WAEJ,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC;WAIhE,oBAAoB,IAAI,MAAM;WAI9B,MAAM,CAAC,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMhF,OAAO,CAAC,MAAM,CAAC,WAAW;CAY7B"}

package/dist/src/GGMetrics.js

@@ -0,0 +1,29 @@
+import { GGMetricKey } from "./GGMetricKey.js";
+import { METRICS_DEFINE_CONTEXT } from "./GGMetricsDefineStorage.js";
+export class GGMetrics {
+    static define(name, define) {
+        return METRICS_DEFINE_CONTEXT.run(name, define);
+    }
+    static getDefinitionContext() {
+        return METRICS_DEFINE_CONTEXT.getStore();
+    }
+    static toJSON(metrics) {
+        const result = {};
+        this.collectKeys(metrics, result);
+        return result;
+    }
+    static collectKeys(obj, result) {
+        if (obj instanceof GGMetricKey) {
+            result[obj.name] = {
+                type: obj.constructor.name,
+                help: obj.help
+            };
+        }
+        else if (obj && typeof obj === 'object') {
+            for (const value of Object.values(obj)) {
+                this.collectKeys(value, result);
+            }
+        }
+    }
+}
+//# sourceMappingURL=GGMetrics.js.map

package/dist/src/GGMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetrics.js","sourceRoot":"","sources":["../../src/GGMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAC;AAIhE,MAAM,OAAO,SAAS;IAEX,MAAM,CAAC,MAAM,CAAI,IAAY,EAAE,MAAe;QACjD,OAAO,sBAAsB,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAA2B,CAAA;IAC7E,CAAC;IAEM,MAAM,CAAC,oBAAoB;QAC9B,OAAO,sBAAsB,CAAC,QAAQ,EAAG,CAAA;IAC7C,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,OAAiC;QAClD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC;IAClB,CAAC;IAEO,MAAM,CAAC,WAAW,CAAC,GAAY,EAAE,MAA+B;QACpE,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG;gBACf,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI;gBAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;aACjB,CAAC;QACN,CAAC;aAAM,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACxC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACpC,CAAC;QACL,CAAC;IACL,CAAC;CACJ"}

package/dist/src/GGMetricsDefineStorage.d.ts

@@ -0,0 +1,4 @@
+import { type IAsyncStorage } from "@grest-ts/common";
+export declare let METRICS_DEFINE_CONTEXT: IAsyncStorage<string>;
+export declare function _initMetricsStorage(storage: IAsyncStorage<string>): void;
+//# sourceMappingURL=GGMetricsDefineStorage.d.ts.map

package/dist/src/GGMetricsDefineStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetricsDefineStorage.d.ts","sourceRoot":"","sources":["../../src/GGMetricsDefineStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAGzE,eAAO,IAAI,sBAAsB,EAAE,aAAa,CAAC,MAAM,CAA6B,CAAC;AAErF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAExE"}

package/dist/src/GGMetricsDefineStorage.js

@@ -0,0 +1,7 @@
+import { BrowserAsyncStorage } from "@grest-ts/common";
+// Browser-safe by default. Node.js entry replaces with real AsyncLocalStorage.
+export let METRICS_DEFINE_CONTEXT = new BrowserAsyncStorage();
+export function _initMetricsStorage(storage) {
+    METRICS_DEFINE_CONTEXT = storage;
+}
+//# sourceMappingURL=GGMetricsDefineStorage.js.map

package/dist/src/GGMetricsDefineStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetricsDefineStorage.js","sourceRoot":"","sources":["../../src/GGMetricsDefineStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAqB,MAAM,kBAAkB,CAAC;AAEzE,+EAA+E;AAC/E,MAAM,CAAC,IAAI,sBAAsB,GAA0B,IAAI,mBAAmB,EAAE,CAAC;AAErF,MAAM,UAAU,mBAAmB,CAAC,OAA8B;IAC9D,sBAAsB,GAAG,OAAO,CAAC;AACrC,CAAC"}

package/dist/src/GGMetricsLoader.d.ts

@@ -0,0 +1,8 @@
+import { GGMetricsStore } from "./GGMetricsStore";
+import { GGLocatorKey } from "@grest-ts/locator";
+export declare const GG_METRICS: GGLocatorKey<GGMetricsStore>;
+export declare class GGMetricsLoader {
+    private readonly store;
+    constructor(store?: GGMetricsStore);
+}
+//# sourceMappingURL=GGMetricsLoader.d.ts.map

package/dist/src/GGMetricsLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetricsLoader.d.ts","sourceRoot":"","sources":["../../src/GGMetricsLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAY,YAAY,EAAuB,MAAM,mBAAmB,CAAC;AAEhF,eAAO,MAAM,UAAU,8BAAgD,CAAC;AAExE,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;gBAE3B,KAAK,CAAC,EAAE,cAAc;CAWrC"}

package/dist/src/GGMetricsLoader.js

@@ -0,0 +1,17 @@
+import { GGMetricsStore } from "./GGMetricsStore.js";
+import { GGLocator, GGLocatorKey, GGLocatorServiceType } from "@grest-ts/locator";
+export const GG_METRICS = new GGLocatorKey("GGMetrics");
+export class GGMetricsLoader {
+    store;
+    constructor(store) {
+        this.store = store ?? new GGMetricsStore();
+        GGLocator.getScope().setWithLifecycle(GG_METRICS, this.store, {
+            type: GGLocatorServiceType.CONFIG + 1,
+            start: async () => {
+            },
+            teardown: async () => {
+            }
+        });
+    }
+}
+//# sourceMappingURL=GGMetricsLoader.js.map

package/dist/src/GGMetricsLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetricsLoader.js","sourceRoot":"","sources":["../../src/GGMetricsLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAC,SAAS,EAAE,YAAY,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AAEhF,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,YAAY,CAAiB,WAAW,CAAC,CAAC;AAExE,MAAM,OAAO,eAAe;IAEP,KAAK,CAAiB;IAEvC,YAAY,KAAsB;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,cAAc,EAAE,CAAC;QAE3C,SAAS,CAAC,QAAQ,EAAE,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE;YAC1D,IAAI,EAAE,oBAAoB,CAAC,MAAM,GAAG,CAAC;YACrC,KAAK,EAAE,KAAK,IAAI,EAAE;YAClB,CAAC;YACD,QAAQ,EAAE,KAAK,IAAI,EAAE;YACrB,CAAC;SACJ,CAAC,CAAA;IACN,CAAC;CACJ"}

package/dist/src/GGMetricsStore.d.ts

@@ -0,0 +1,9 @@
+import { GGMetric, GGMetricLabels } from "./GGMetric.js";
+import { GGMetricKey } from "./GGMetricKey.js";
+export declare class GGMetricsStore {
+    private readonly metrics;
+    get<TLabel extends GGMetricLabels>(key: GGMetricKey<TLabel>): GGMetric<TLabel>;
+    getAllMetrics(): IterableIterator<GGMetric<any>>;
+    reset(): void;
+}
+//# sourceMappingURL=GGMetricsStore.d.ts.map

package/dist/src/GGMetricsStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetricsStore.d.ts","sourceRoot":"","sources":["../../src/GGMetricsStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,cAAc,EAAC,MAAM,eAAe,CAAC;AACvD,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAErD,GAAG,CAAC,MAAM,SAAS,cAAc,EAAE,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;IAS9E,aAAa,IAAI,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAIhD,KAAK,IAAI,IAAI;CAKvB"}

package/dist/src/GGMetricsStore.js

@@ -0,0 +1,20 @@
+export class GGMetricsStore {
+    metrics = new Map();
+    get(key) {
+        let metric = this.metrics.get(key.name);
+        if (!metric) {
+            metric = key.create();
+            this.metrics.set(key.name, metric);
+        }
+        return metric;
+    }
+    getAllMetrics() {
+        return this.metrics.values();
+    }
+    reset() {
+        for (const metric of this.metrics.values()) {
+            metric.reset();
+        }
+    }
+}
+//# sourceMappingURL=GGMetricsStore.js.map

package/dist/src/GGMetricsStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetricsStore.js","sourceRoot":"","sources":["../../src/GGMetricsStore.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,cAAc;IAEN,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAErD,GAAG,CAAgC,GAAwB;QAC9D,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAEM,aAAa;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IACjC,CAAC;IAEM,KAAK;QACR,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;IACL,CAAC;CACJ"}

package/dist/src/exporters/GGJsonMetricsExporter.d.ts

@@ -0,0 +1,41 @@
+import { GGMetric } from "../GGMetric.js";
+import { GGMetricsExporter, ExporterConfig } from "./GGMetricsExporter.js";
+export type JsonMetricConverter = (metric: GGMetric<any>, exporter: GGJsonMetricsExporter) => JsonMetric;
+export declare class GGJsonMetricsExporter extends GGMetricsExporter<JsonMetricsOutput> {
+    private static converters;
+    /**
+     * Register a converter for a custom metric type.
+     */
+    static registerConverter(metricClass: Function, converter: JsonMetricConverter): void;
+    constructor(config?: ExporterConfig);
+    getMetrics(): JsonMetricsOutput;
+    private convertMetric;
+    /**
+     * Parse a label key string into a labels object.
+     * Exposed for use by converters.
+     */
+    parseLabels(labelKey: string): Record<string, string>;
+}
+export interface JsonMetricValue {
+    labels: Record<string, string>;
+    value: number | JsonHistogramValue;
+}
+export interface JsonHistogramValue {
+    count: number;
+    sum: number;
+    avg: number;
+    min: number;
+    max: number;
+    buckets: Record<string, number>;
+}
+export interface JsonMetric {
+    name: string;
+    type: string;
+    help: string;
+    values: JsonMetricValue[];
+}
+export interface JsonMetricsOutput {
+    timestamp: number;
+    metrics: Record<string, JsonMetric>;
+}
+//# sourceMappingURL=GGJsonMetricsExporter.d.ts.map

package/dist/src/exporters/GGJsonMetricsExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGJsonMetricsExporter.d.ts","sourceRoot":"","sources":["../../../src/exporters/GGJsonMetricsExporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAKxC,OAAO,EAAC,iBAAiB,EAAE,cAAc,EAAC,MAAM,wBAAwB,CAAC;AAEzE,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,qBAAqB,KAAK,UAAU,CAAC;AAEzG,qBAAa,qBAAsB,SAAQ,iBAAiB,CAAC,iBAAiB,CAAC;IAG3E,OAAO,CAAC,MAAM,CAAC,UAAU,CAA4C;IASrE;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,mBAAmB,GAAG,IAAI;gBAIzE,MAAM,GAAE,cAAmB;IAIvC,UAAU,IAAI,iBAAiB;IAa/B,OAAO,CAAC,aAAa;IAQrB;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAYxD;AAkFD,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACvC"}

package/dist/src/exporters/GGJsonMetricsExporter.js

@@ -0,0 +1,129 @@
+import { GGCounter } from "../metric/GGCounter.js";
+import { GGGauge } from "../metric/GGGauge.js";
+import { GGLazyGauge } from "../metric/GGLazyGauge.js";
+import { GGHistogram } from "../metric/GGHistogram.js";
+import { GGMetricsExporter } from "./GGMetricsExporter.js";
+export class GGJsonMetricsExporter extends GGMetricsExporter {
+    // Static map for extensibility - register converters for new metric types
+    static converters = new Map();
+    static {
+        GGJsonMetricsExporter.registerConverter(GGCounter, convertCounter);
+        GGJsonMetricsExporter.registerConverter(GGGauge, convertGauge);
+        GGJsonMetricsExporter.registerConverter(GGLazyGauge, convertLazyGauge);
+        GGJsonMetricsExporter.registerConverter(GGHistogram, convertHistogram);
+    }
+    /**
+     * Register a converter for a custom metric type.
+     */
+    static registerConverter(metricClass, converter) {
+        GGJsonMetricsExporter.converters.set(metricClass, converter);
+    }
+    constructor(config = {}) {
+        super(config);
+    }
+    getMetrics() {
+        const output = {
+            timestamp: Date.now(),
+            metrics: {}
+        };
+        for (const metric of this.getFilteredMetrics()) {
+            output.metrics[metric.name] = this.convertMetric(metric);
+        }
+        return output;
+    }
+    convertMetric(metric) {
+        const converter = GGJsonMetricsExporter.converters.get(metric.constructor);
+        if (!converter) {
+            throw new Error(`No converter registered for metric type: ${metric.constructor.name}`);
+        }
+        return converter(metric, this);
+    }
+    /**
+     * Parse a label key string into a labels object.
+     * Exposed for use by converters.
+     */
+    parseLabels(labelKey) {
+        if (!labelKey)
+            return {};
+        const labels = {};
+        const parts = labelKey.split(',');
+        for (const part of parts) {
+            const [key, val] = part.split('=');
+            if (key && val !== undefined) {
+                labels[key] = val;
+            }
+        }
+        return labels;
+    }
+}
+// Built-in converters
+function convertCounter(metric, exporter) {
+    const values = [];
+    for (const [labelKey, value] of metric.getValues()) {
+        values.push({
+            labels: exporter.parseLabels(labelKey),
+            value
+        });
+    }
+    return {
+        name: metric.name,
+        type: 'counter',
+        help: metric.key.help,
+        values
+    };
+}
+function convertGauge(metric, exporter) {
+    const values = [];
+    for (const [labelKey, value] of metric.getValues()) {
+        values.push({
+            labels: exporter.parseLabels(labelKey),
+            value
+        });
+    }
+    return {
+        name: metric.name,
+        type: 'gauge',
+        help: metric.key.help,
+        values
+    };
+}
+function convertLazyGauge(metric, exporter) {
+    // Lazy gauge computes value on read - no labels
+    return {
+        name: metric.name,
+        type: 'gauge',
+        help: metric.key.help,
+        values: [{
+                labels: {},
+                value: metric.getValue()
+            }]
+    };
+}
+function convertHistogram(metric, exporter) {
+    const values = [];
+    const buckets = metric.getBuckets();
+    for (const [labelKey, data] of metric.getValues()) {
+        const bucketObj = {};
+        for (let i = 0; i < buckets.length; i++) {
+            bucketObj[String(buckets[i])] = data.values[i] ?? 0;
+        }
+        values.push({
+            labels: exporter.parseLabels(labelKey),
+            value: {
+                count: data.count,
+                sum: data.sum,
+                avg: data.count > 0 ? data.sum / data.count : 0,
+                min: data.min === Infinity ? 0 : data.min,
+                max: data.max === -Infinity ? 0 : data.max,
+                buckets: bucketObj
+            }
+        });
+    }
+    return {
+        name: metric.name,
+        type: 'histogram',
+        help: metric.key.help,
+        values
+    };
+}
+//# sourceMappingURL=GGJsonMetricsExporter.js.map

package/dist/src/exporters/GGJsonMetricsExporter.js.map

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

package/dist/src/exporters/GGMetricsExporter.d.ts

@@ -0,0 +1,41 @@
+import { GGMetricsStore } from "../GGMetricsStore.js";
+import { GGMetric } from "../GGMetric.js";
+export interface ExporterConfig {
+    store?: GGMetricsStore;
+    include?: unknown[];
+    exclude?: unknown[];
+}
+/**
+ * Abstract base class for metrics exporters.
+ * Handles config parsing, metric filtering, and key discovery.
+ */
+export declare abstract class GGMetricsExporter<TOutput> {
+    protected readonly store: GGMetricsStore;
+    private readonly includeKeys?;
+    private readonly excludeKeys?;
+    constructor(config?: ExporterConfig);
+    /**
+     * Discover all GGMetricKey instances from an array of objects.
+     * Objects can be individual keys, or nested structures containing keys.
+     */
+    private discoverKeys;
+    private discoverKeysRecursive;
+    /**
+     * Check if a metric should be included in the export.
+     * Exclude takes precedence over include.
+     */
+    protected shouldIncludeMetric(metric: GGMetric<any>): boolean;
+    /**
+     * Get all metrics that pass the include/exclude filters.
+     */
+    protected getFilteredMetrics(): Iterable<GGMetric<any>>;
+    /**
+     * Export metrics to the output format.
+     */
+    abstract getMetrics(): TOutput;
+    /**
+     * Export metrics as a JSON string.
+     */
+    getMetricsString(): string;
+}
+//# sourceMappingURL=GGMetricsExporter.d.ts.map

package/dist/src/exporters/GGMetricsExporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGMetricsExporter.d.ts","sourceRoot":"","sources":["../../../src/exporters/GGMetricsExporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAGxC,MAAM,WAAW,cAAc;IAC3B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,8BAAsB,iBAAiB,CAAC,OAAO;IAC3C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAwB;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAwB;gBAEzC,MAAM,GAAE,cAAmB;IAMvC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,qBAAqB;IAU7B;;;OAGG;IACH,SAAS,CAAC,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO;IAa7D;;OAEG;IACH,SAAS,CAAE,kBAAkB,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAQxD;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO;IAE9B;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAG7B"}