@aztec-labs/telemetry-client 6.0.0-nightly.20260829

package/dest/json_rpc_server_metrics.js

@@ -0,0 +1,154 @@
+import { Timer } from '@aztec-labs/foundation/timer';
+import * as Attributes from './attributes.js';
+import * as Metrics from './metrics.js';
+import { getTelemetryClient } from './start.js';
+import { ATTR_JSONRPC_METHOD, ATTR_JSONRPC_SERVICE } from './vendor/attributes.js';
+const BATCH_SIZE_BUCKETS = [
+    1,
+    2,
+    5,
+    10,
+    20,
+    50,
+    100,
+    200,
+    500,
+    1000
+];
+/** Records bounded-cardinality metrics for registered JSON-RPC calls, rejected requests, and batches. */ export class JsonRpcServerMetrics {
+    requestCount;
+    requestDuration;
+    requestValidationDuration;
+    rejectedRequestCount;
+    batchCount;
+    batchDuration;
+    batchSize;
+    constructor(telemetry){
+        const meter = telemetry.getMeter('JsonRpcServer');
+        this.requestCount = meter.createUpDownCounter(Metrics.JSON_RPC_SERVER_REQUEST_COUNT);
+        this.requestDuration = meter.createHistogram(Metrics.JSON_RPC_SERVER_REQUEST_DURATION);
+        this.requestValidationDuration = meter.createHistogram(Metrics.JSON_RPC_SERVER_REQUEST_VALIDATION_DURATION);
+        this.rejectedRequestCount = meter.createUpDownCounter(Metrics.JSON_RPC_SERVER_REJECTED_REQUEST_COUNT);
+        this.batchCount = meter.createUpDownCounter(Metrics.JSON_RPC_SERVER_BATCH_COUNT);
+        this.batchDuration = meter.createHistogram(Metrics.JSON_RPC_SERVER_BATCH_DURATION);
+        this.batchSize = meter.createHistogram(Metrics.JSON_RPC_SERVER_BATCH_SIZE, {
+            advice: {
+                explicitBucketBoundaries: BATCH_SIZE_BUCKETS
+            }
+        });
+    }
+    /** Records the outcome and handler duration of a registered RPC method. */ recordRequest(fullMethod, durationMs, ok) {
+        const [service, method] = splitJsonRpcMethod(fullMethod);
+        const attributes = {
+            ...service === undefined ? {} : {
+                [ATTR_JSONRPC_SERVICE]: service
+            },
+            [ATTR_JSONRPC_METHOD]: method,
+            [Attributes.OK]: ok
+        };
+        this.requestCount.add(1, attributes);
+        this.requestDuration.record(durationMs, attributes);
+    }
+    /** Records a pre-dispatch rejection using a fixed reason. */ recordRejectedRequest(reason) {
+        this.rejectedRequestCount.add(1, {
+            [Attributes.JSON_RPC_REJECTION_REASON]: reason
+        });
+    }
+    /** Records the duration and outcome of validating a registered RPC method's parameters. */ recordRequestValidation(fullMethod, durationMs, ok) {
+        const [service, method] = splitJsonRpcMethod(fullMethod);
+        this.requestValidationDuration.record(durationMs, {
+            ...service === undefined ? {} : {
+                [ATTR_JSONRPC_SERVICE]: service
+            },
+            [ATTR_JSONRPC_METHOD]: method,
+            [Attributes.OK]: ok
+        });
+    }
+    /** Records the outcome, processing duration, and number of calls in a batch envelope. */ recordBatch(size, durationMs, ok) {
+        const attributes = {
+            [Attributes.OK]: ok
+        };
+        this.batchCount.add(1, attributes);
+        this.batchDuration.record(durationMs, attributes);
+        this.batchSize.record(size, attributes);
+    }
+}
+let metricsOwner;
+let metrics;
+export function getJsonRpcServerMetrics() {
+    const telemetry = getTelemetryClient();
+    if (metricsOwner !== telemetry) {
+        metricsOwner = telemetry;
+        metrics = new JsonRpcServerMetrics(telemetry);
+    }
+    return metrics;
+}
+export function getOtelJsonRpcServerMetricsMiddleware(metricsProvider = getJsonRpcServerMetrics) {
+    return async function otelJsonRpcServerMetrics(ctx, next) {
+        const timer = new Timer();
+        await next();
+        const requestBody = ctx.request.body;
+        if (Array.isArray(requestBody)) {
+            metricsProvider().recordBatch(requestBody.length, timer.ms(), Array.isArray(ctx.body));
+        }
+        for (const reason of getRejectionReasons(ctx.status, ctx.body)){
+            metricsProvider().recordRejectedRequest(reason);
+        }
+    };
+}
+export function splitJsonRpcMethod(fullMethod) {
+    const separator = fullMethod.indexOf('_');
+    return separator === -1 ? [
+        undefined,
+        fullMethod
+    ] : [
+        fullMethod.slice(0, separator),
+        fullMethod.slice(separator + 1)
+    ];
+}
+function getRejectionReasons(status, response) {
+    if (status === 401) {
+        return [
+            'unauthorized'
+        ];
+    }
+    const responses = Array.isArray(response) ? response : [
+        response
+    ];
+    return responses.flatMap((item)=>{
+        const code = getErrorCode(item);
+        if (code === -32700) {
+            return [
+                'parse_error'
+            ];
+        }
+        if (code === -32601) {
+            return [
+                'method_not_found'
+            ];
+        }
+        if (code === -32600) {
+            return [
+                'invalid_request'
+            ];
+        }
+        if (code === -32603) {
+            return [
+                'internal_error'
+            ];
+        }
+        if (code === -32000) {
+            return [
+                'bad_request'
+            ];
+        }
+        return [];
+    });
+}
+function getErrorCode(response) {
+    if (!response || typeof response !== 'object' || !('error' in response)) {
+        return undefined;
+    }
+    const error = response.error;
+    return error && typeof error === 'object' && 'code' in error && typeof error.code === 'number' ? error.code : undefined;
+}

package/dest/l1_metrics.d.ts

@@ -0,0 +1,17 @@
+import type { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { type Chain, type FallbackTransport, type HttpTransport, type PublicClient } from 'viem';
+import type { Meter } from './telemetry.js';
+export declare class L1Metrics {
+    private meter;
+    private client;
+    private l1BlockHeight;
+    private l1BalanceEth;
+    private gasPriceWei;
+    private blobBaseFeeWei;
+    private addresses;
+    constructor(meter: Meter, client: PublicClient<FallbackTransport<HttpTransport[]>, Chain>, addresses: EthAddress[]);
+    start(): void;
+    stop(): void;
+    private observe;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDFfbWV0cmljcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2wxX21ldHJpY3MudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sb0NBQW9DLENBQUM7QUFDckUsT0FBTyxFQUFFLEtBQUssS0FBSyxFQUFFLEtBQUssaUJBQWlCLEVBQVksS0FBSyxhQUFhLEVBQUUsS0FBSyxZQUFZLEVBQWUsTUFBTSxNQUFNLENBQUM7QUFJeEgsT0FBTyxLQUFLLEVBQXlCLEtBQUssRUFBbUIsTUFBTSxnQkFBZ0IsQ0FBQztBQUVwRixxQkFBYSxTQUFTO0lBUWxCLE9BQU8sQ0FBQyxLQUFLO0lBQ2IsT0FBTyxDQUFDLE1BQU07SUFSaEIsT0FBTyxDQUFDLGFBQWEsQ0FBa0I7SUFDdkMsT0FBTyxDQUFDLFlBQVksQ0FBa0I7SUFDdEMsT0FBTyxDQUFDLFdBQVcsQ0FBa0I7SUFDckMsT0FBTyxDQUFDLGNBQWMsQ0FBa0I7SUFDeEMsT0FBTyxDQUFDLFNBQVMsQ0FBUTtJQUV6QixZQUNVLEtBQUssRUFBRSxLQUFLLEVBQ1osTUFBTSxFQUFFLFlBQVksQ0FBQyxpQkFBaUIsQ0FBQyxhQUFhLEVBQUUsQ0FBQyxFQUFFLEtBQUssQ0FBQyxFQUN2RSxTQUFTLEVBQUUsVUFBVSxFQUFFLEVBUXhCO0lBRUQsS0FBSyxTQUVKO0lBRUQsSUFBSSxTQUVIO0lBRUQsT0FBTyxDQUFDLE9BQU8sQ0EyQmI7Q0FDSCJ9

package/dest/l1_metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l1_metrics.d.ts","sourceRoot":"","sources":["../src/l1_metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,iBAAiB,EAAY,KAAK,aAAa,EAAE,KAAK,YAAY,EAAe,MAAM,MAAM,CAAC;AAIxH,OAAO,KAAK,EAAyB,KAAK,EAAmB,MAAM,gBAAgB,CAAC;AAEpF,qBAAa,SAAS;IAQlB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IARhB,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,SAAS,CAAQ;IAEzB,YACU,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,YAAY,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC,EAAE,KAAK,CAAC,EACvE,SAAS,EAAE,UAAU,EAAE,EAQxB;IAED,KAAK,SAEJ;IAED,IAAI,SAEH;IAED,OAAO,CAAC,OAAO,CA2Bb;CACH"}

package/dest/l1_metrics.js

@@ -0,0 +1,54 @@
+import { formatEther } from 'viem';
+import { L1_SENDER } from './attributes.js';
+import { L1_BALANCE_ETH, L1_BLOB_BASE_FEE_WEI, L1_BLOCK_HEIGHT, L1_GAS_PRICE_WEI } from './metrics.js';
+export class L1Metrics {
+    meter;
+    client;
+    l1BlockHeight;
+    l1BalanceEth;
+    gasPriceWei;
+    blobBaseFeeWei;
+    addresses;
+    constructor(meter, client, addresses){
+        this.meter = meter;
+        this.client = client;
+        this.observe = async (observer)=>{
+            const blockNumber = await this.client.getBlockNumber();
+            const ethBalances = await Promise.all(this.addresses.map((address)=>this.client.getBalance({
+                    address,
+                    blockNumber
+                })));
+            const gasPrice = await this.client.getGasPrice();
+            const blobFee = await this.client.getBlobBaseFee();
+            observer.observe(this.l1BlockHeight, Number(blockNumber));
+            observer.observe(this.gasPriceWei, Number(gasPrice));
+            observer.observe(this.blobBaseFeeWei, Number(blobFee));
+            for(let i = 0; i < ethBalances.length; i++){
+                const wei = ethBalances[i];
+                const address = this.addresses[i];
+                const eth = parseFloat(formatEther(wei, 'wei'));
+                observer.observe(this.l1BalanceEth, eth, {
+                    [L1_SENDER]: address
+                });
+            }
+        };
+        this.l1BlockHeight = meter.createObservableGauge(L1_BLOCK_HEIGHT);
+        this.l1BalanceEth = meter.createObservableGauge(L1_BALANCE_ETH);
+        this.gasPriceWei = meter.createObservableGauge(L1_GAS_PRICE_WEI);
+        this.blobBaseFeeWei = meter.createObservableGauge(L1_BLOB_BASE_FEE_WEI);
+        this.addresses = addresses.map((addr)=>addr.toString());
+    }
+    start() {
+        this.meter.addBatchObservableCallback(this.observe, [
+            this.l1BalanceEth,
+            this.l1BlockHeight
+        ]);
+    }
+    stop() {
+        this.meter.removeBatchObservableCallback(this.observe, [
+            this.l1BalanceEth,
+            this.l1BlockHeight
+        ]);
+    }
+    observe;
+}

package/dest/lmdb_metrics.d.ts

@@ -0,0 +1,18 @@
+import type { Meter } from './telemetry.js';
+export type LmdbStatsCallback = () => Promise<{
+    mappingSize: number;
+    physicalFileSize: number;
+    numItems: number;
+    actualSize: number;
+}>;
+export declare class LmdbMetrics {
+    private attributes?;
+    private getStats?;
+    private dbMapSize;
+    private dbPhysicalFileSize;
+    private dbUsedSize;
+    private dbNumItems;
+    constructor(meter: Meter, attributes?: Partial<Record<"aztec.address.sender" | "aztec.address.target" | "aztec.archiver.prune_type" | "aztec.attester.address" | "aztec.block.archive" | "aztec.block.candidate_txs_count" | "aztec.block.hash" | "aztec.block.number" | "aztec.block.parent" | "aztec.block.proposer" | "aztec.block.size" | "aztec.block.txs_count" | "aztec.block_full" | "aztec.checkpoint.number" | "aztec.circuit.app_circuit_name" | "aztec.circuit.protocol_circuit_name" | "aztec.coinbase" | "aztec.db_type" | "aztec.epoch.number" | "aztec.epoch.size" | "aztec.epoch_session.kind" | "aztec.error_type" | "aztec.fisherman.strategy_id" | "aztec.gas_dimension" | "aztec.gossip.topic_name" | "aztec.ha_signer.duty_type" | "aztec.ha_signer.node_id" | "aztec.initial_sync" | "aztec.is_committee_member" | "aztec.json_rpc.rejection_reason" | "aztec.l1.block_proposal_tx_target" | "aztec.l1.block_proposal_used_trace" | "aztec.l1.sender" | "aztec.l1.tx_type" | "aztec.l1_tx.scope" | "aztec.mana.used" | "aztec.mempool.eviction_reason" | "aztec.mempool.operation" | "aztec.merkle_tree.name" | "aztec.network_name" | "aztec.node_role" | "aztec.ok" | "aztec.p2p.goodbye.reason" | "aztec.p2p.id" | "aztec.p2p.peer_id" | "aztec.p2p.peer_score_state" | "aztec.p2p.req_resp.protocol" | "aztec.p2p.tx_validation_stage" | "aztec.pool.name" | "aztec.proof.timed_out" | "aztec.proving.job_id" | "aztec.proving.job_type" | "aztec.registry_address" | "aztec.revertibility" | "aztec.rollup.prover_id" | "aztec.rollup_address" | "aztec.rollup_version" | "aztec.sequencer.state" | "aztec.simulator.phase" | "aztec.slot.number" | "aztec.slot_boundary_side" | "aztec.status" | "aztec.total_instructions" | "aztec.tx.hash" | "aztec.tx.phase_name" | "aztec.tx_collection.method" | "aztec.validator_status" | "aztec.world_state.db_type" | "aztec.world_state_request" | "http.header.request.host" | "http.response.status_code" | "nodejs.eventloop.state", import("@opentelemetry/api").AttributeValue>> | undefined, getStats?: LmdbStatsCallback | undefined);
+    private recordDBMetrics;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG1kYl9tZXRyaWNzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvbG1kYl9tZXRyaWNzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sS0FBSyxFQUF5QyxLQUFLLEVBQW1CLE1BQU0sZ0JBQWdCLENBQUM7QUFFcEcsTUFBTSxNQUFNLGlCQUFpQixHQUFHLE1BQU0sT0FBTyxDQUFDO0lBQzVDLFdBQVcsRUFBRSxNQUFNLENBQUM7SUFDcEIsZ0JBQWdCLEVBQUUsTUFBTSxDQUFDO0lBQ3pCLFFBQVEsRUFBRSxNQUFNLENBQUM7SUFDakIsVUFBVSxFQUFFLE1BQU0sQ0FBQztDQUNwQixDQUFDLENBQUM7QUFFSCxxQkFBYSxXQUFXO0lBUXBCLE9BQU8sQ0FBQyxVQUFVLENBQUM7SUFDbkIsT0FBTyxDQUFDLFFBQVEsQ0FBQztJQVJuQixPQUFPLENBQUMsU0FBUyxDQUFrQjtJQUNuQyxPQUFPLENBQUMsa0JBQWtCLENBQWtCO0lBQzVDLE9BQU8sQ0FBQyxVQUFVLENBQWtCO0lBQ3BDLE9BQU8sQ0FBQyxVQUFVLENBQWtCO0lBRXBDLFlBQ0UsS0FBSyxFQUFFLEtBQUssRUFDSixVQUFVLENBQUMsbzZEQUFnQixFQUMzQixRQUFRLENBQUMsK0JBQW1CLEVBYXJDO0lBRUQsT0FBTyxDQUFDLGVBQWUsQ0FTckI7Q0FDSCJ9

package/dest/lmdb_metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lmdb_metrics.d.ts","sourceRoot":"","sources":["../src/lmdb_metrics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyC,KAAK,EAAmB,MAAM,gBAAgB,CAAC;AAEpG,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH,qBAAa,WAAW;IAQpB,OAAO,CAAC,UAAU,CAAC;IACnB,OAAO,CAAC,QAAQ,CAAC;IARnB,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,kBAAkB,CAAkB;IAC5C,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,UAAU,CAAkB;IAEpC,YACE,KAAK,EAAE,KAAK,EACJ,UAAU,CAAC,o6DAAgB,EAC3B,QAAQ,CAAC,+BAAmB,EAarC;IAED,OAAO,CAAC,eAAe,CASrB;CACH"}

package/dest/lmdb_metrics.js

@@ -0,0 +1,34 @@
+import * as Metrics from './metrics.js';
+export class LmdbMetrics {
+    attributes;
+    getStats;
+    dbMapSize;
+    dbPhysicalFileSize;
+    dbUsedSize;
+    dbNumItems;
+    constructor(meter, attributes, getStats){
+        this.attributes = attributes;
+        this.getStats = getStats;
+        this.recordDBMetrics = async (observable)=>{
+            if (!this.getStats) {
+                return;
+            }
+            const metrics = await this.getStats();
+            observable.observe(this.dbMapSize, metrics.mappingSize, this.attributes);
+            observable.observe(this.dbPhysicalFileSize, metrics.physicalFileSize, this.attributes);
+            observable.observe(this.dbNumItems, metrics.numItems, this.attributes);
+            observable.observe(this.dbUsedSize, metrics.actualSize, this.attributes);
+        };
+        this.dbMapSize = meter.createObservableGauge(Metrics.DB_MAP_SIZE);
+        this.dbPhysicalFileSize = meter.createObservableGauge(Metrics.DB_PHYSICAL_FILE_SIZE);
+        this.dbUsedSize = meter.createObservableGauge(Metrics.DB_USED_SIZE);
+        this.dbNumItems = meter.createObservableGauge(Metrics.DB_NUM_ITEMS);
+        meter.addBatchObservableCallback(this.recordDBMetrics, [
+            this.dbMapSize,
+            this.dbPhysicalFileSize,
+            this.dbUsedSize,
+            this.dbNumItems
+        ]);
+    }
+    recordDBMetrics;
+}

package/dest/metric-utils.d.ts

@@ -0,0 +1,24 @@
+import type { AttributeValue, MetricOptions } from '@opentelemetry/api';
+import type { MetricDefinition } from './metrics.js';
+import type { AllowedAttributeNames, Meter, MetricAttributesType, UpDownCounter } from './telemetry.js';
+/** Extracts OpenTelemetry MetricOptions from a MetricDefinition */
+export declare function toMetricOptions(def: MetricDefinition): MetricOptions;
+/** A mapping of attribute keys to their possible values */
+export type AttributeValuesMap = Partial<Record<AllowedAttributeNames, AttributeValue[]>>;
+/**
+ * Expands an attribute values map into all combinations of attribute objects.
+ * Example: { status: ['ok', 'fail'], type: ['a', 'b'] } =>
+ *   [{ status: 'ok', type: 'a' }, { status: 'ok', type: 'b' }, { status: 'fail', type: 'a' }, { status: 'fail', type: 'b' }]
+ */
+export declare function expandAttributeCombinations(attrMap: AttributeValuesMap): MetricAttributesType[];
+/**
+ * Creates an UpDownCounter and initializes it to 0.
+ * @param meter - The meter to create the counter on
+ * @param metric - The metric definition
+ * @param attributes - Optional attributes for initialization. Can be:
+ *   - AttributeValuesMap: mapping of attribute keys to arrays of possible values (generates cartesian product)
+ *   - MetricAttributesType[]: explicit array of attribute objects
+ *   - undefined: initializes without attributes
+ */
+export declare function createUpDownCounterWithDefault(meter: Meter, metric: MetricDefinition, attributes?: AttributeValuesMap | MetricAttributesType[] | undefined): UpDownCounter;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWV0cmljLXV0aWxzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvbWV0cmljLXV0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLGNBQWMsRUFBRSxhQUFhLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUV4RSxPQUFPLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUNyRCxPQUFPLEtBQUssRUFBRSxxQkFBcUIsRUFBRSxLQUFLLEVBQUUsb0JBQW9CLEVBQUUsYUFBYSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFeEcsbUVBQW1FO0FBQ25FLHdCQUFnQixlQUFlLENBQUMsR0FBRyxFQUFFLGdCQUFnQixHQUFHLGFBQWEsQ0FNcEU7QUFFRCwyREFBMkQ7QUFDM0QsTUFBTSxNQUFNLGtCQUFrQixHQUFHLE9BQU8sQ0FBQyxNQUFNLENBQUMscUJBQXFCLEVBQUUsY0FBYyxFQUFFLENBQUMsQ0FBQyxDQUFDO0FBRTFGOzs7O0dBSUc7QUFDSCx3QkFBZ0IsMkJBQTJCLENBQUMsT0FBTyxFQUFFLGtCQUFrQixHQUFHLG9CQUFvQixFQUFFLENBc0IvRjtBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsd0JBQWdCLDhCQUE4QixDQUM1QyxLQUFLLEVBQUUsS0FBSyxFQUNaLE1BQU0sRUFBRSxnQkFBZ0IsRUFDeEIsVUFBVSxHQUFFLGtCQUFrQixHQUFHLG9CQUFvQixFQUFFLEdBQUcsU0FBcUIsR0FDOUUsYUFBYSxDQWVmIn0=

package/dest/metric-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-utils.d.ts","sourceRoot":"","sources":["../src/metric-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAExG,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAMpE;AAED,2DAA2D;AAC3D,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;AAE1F;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,kBAAkB,GAAG,oBAAoB,EAAE,CAsB/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,gBAAgB,EACxB,UAAU,GAAE,kBAAkB,GAAG,oBAAoB,EAAE,GAAG,SAAqB,GAC9E,aAAa,CAef"}

package/dest/metric-utils.js

@@ -0,0 +1,59 @@
+/** Extracts OpenTelemetry MetricOptions from a MetricDefinition */ export function toMetricOptions(def) {
+    return {
+        description: def.description,
+        unit: def.unit,
+        valueType: def.valueType
+    };
+}
+/**
+ * Expands an attribute values map into all combinations of attribute objects.
+ * Example: { status: ['ok', 'fail'], type: ['a', 'b'] } =>
+ *   [{ status: 'ok', type: 'a' }, { status: 'ok', type: 'b' }, { status: 'fail', type: 'a' }, { status: 'fail', type: 'b' }]
+ */ export function expandAttributeCombinations(attrMap) {
+    const keys = Object.keys(attrMap);
+    if (keys.length === 0) {
+        return [
+            {}
+        ];
+    }
+    const result = [];
+    function generate(index, current) {
+        if (index === keys.length) {
+            result.push({
+                ...current
+            });
+            return;
+        }
+        const key = keys[index];
+        for (const value of attrMap[key]){
+            current[key] = value;
+            generate(index + 1, current);
+        }
+    }
+    generate(0, {});
+    return result;
+}
+/**
+ * Creates an UpDownCounter and initializes it to 0.
+ * @param meter - The meter to create the counter on
+ * @param metric - The metric definition
+ * @param attributes - Optional attributes for initialization. Can be:
+ *   - AttributeValuesMap: mapping of attribute keys to arrays of possible values (generates cartesian product)
+ *   - MetricAttributesType[]: explicit array of attribute objects
+ *   - undefined: initializes without attributes
+ */ export function createUpDownCounterWithDefault(meter, metric, attributes = undefined) {
+    const counter = meter.createUpDownCounter(metric);
+    if (attributes === undefined) {
+        counter.add(0);
+    } else if (Array.isArray(attributes)) {
+        for (const attrs of attributes){
+            counter.add(0, attrs);
+        }
+    } else {
+        const combinations = expandAttributeCombinations(attributes);
+        for (const attrs of combinations){
+            counter.add(0, attrs);
+        }
+    }
+    return counter;
+}