fix: add get method to type definitions of metric classes

index.d.ts

@@ -29,12 +29,12 @@ export class Registry {
 	/**
 	 * Get all metrics as objects
 	 */
-	getMetricsAsJSON(): Promise<metric[]>;
+	getMetricsAsJSON(): Promise<MetricObjectWithValues<MetricValue<string>>[]>;
 
 	/**
 	 * Get all metrics as objects
 	 */
-	getMetricsAsArray(): metric[];
+	getMetricsAsArray(): MetricObject[];
 
 	/**
 	 * Remove a single metric
@@ -136,14 +136,28 @@ export enum MetricType {
 
 type CollectFunction<T> = (this: T) => void | Promise<void>;
 
-interface metric {
+interface MetricObject {
 	name: string;
 	help: string;
 	type: MetricType;
 	aggregator: Aggregator;
 	collect: CollectFunction<any>;
 }
 
+interface MetricObjectWithValues<T extends MetricValue<string>>
+	extends MetricObject {
+	values: T[];
+}
+
+type MetricValue<T extends string> = {
+	value: number;
+	labels: LabelValues<T>;
+};
+
+type MetricValueWithName<T extends string> = MetricValue<T> & {
+	metricName?: string;
+};
+
 type LabelValues<T extends string> = Partial<Record<T, string | number>>;
 
 interface MetricConfiguration<T extends string> {
@@ -182,6 +196,11 @@ export class Counter<T extends string = string> {
 	 */
 	inc(value?: number): void;
 
+	/**
+	 * Get counter metric object
+	 */
+	get(): Promise<MetricObjectWithValues<MetricValue<T>>>;
+
 	/**
 	 * Return the child for given labels
 	 * @param values Label values
@@ -277,6 +296,11 @@ export class Gauge<T extends string = string> {
 	 */
 	set(value: number): void;
 
+	/**
+	 * Get gauge metric object
+	 */
+	get(): Promise<MetricObjectWithValues<MetricValue<T>>>;
+
 	/**
 	 * Set gauge value to current epoch time in ms
 	 * @param labels Object with label keys and values
@@ -386,6 +410,11 @@ export class Histogram<T extends string = string> {
 	 */
 	observe(labels: LabelValues<T>, value: number): void;
 
+	/**
+	 * Get histogram metric object
+	 */
+	get(): Promise<MetricObjectWithValues<MetricValueWithName<T>>>;
+
 	/**
 	 * Start a timer. Calling the returned function will observe the duration in
 	 * seconds in the histogram.
@@ -488,6 +517,11 @@ export class Summary<T extends string = string> {
 	 */
 	observe(labels: LabelValues<T>, value: number): void;
 
+	/**
+	 * Get summary metric object
+	 */
+	get(): Promise<MetricObjectWithValues<MetricValueWithName<T>>>;
+
 	/**
 	 * Start a timer. Calling the returned function will observe the duration in
 	 * seconds in the summary.