@sentry/core 10.53.1 → 10.54.0

package/build/cjs/metrics/envelope.js

@@ -4,67 +4,34 @@ const dsn = require('../utils/dsn.js');
 const envelope = require('../utils/envelope.js');
 const isBrowser = require('../utils/isBrowser.js');
 
-/**
- * Creates a metric container envelope item for a list of metrics.
- *
- * @param items - The metrics to include in the envelope.
- * @param inferUserData - If true, tells Relay to infer the end-user IP and User-Agent from the incoming request.
- *                        Only emitted as `ingest_settings` in browser environments.
- * @returns The created metric container envelope item.
- */
-function createMetricContainerEnvelopeItem(
-  items,
-  inferUserData,
-) {
-  const inferSetting = inferUserData ? 'auto' : 'never';
+function createMetricContainerEnvelopeItem(items, inferUserData) {
+  const inferSetting = inferUserData ? "auto" : "never";
   return [
     {
-      type: 'trace_metric',
+      type: "trace_metric",
       item_count: items.length,
-      content_type: 'application/vnd.sentry.items.trace-metric+json',
-    } ,
+      content_type: "application/vnd.sentry.items.trace-metric+json"
+    },
     {
       version: 2,
-      ...(isBrowser.isBrowser() && {
-        ingest_settings: { infer_ip: inferSetting, infer_user_agent: inferSetting },
-      }),
-      items,
-    },
+      ...isBrowser.isBrowser() && {
+        ingest_settings: { infer_ip: inferSetting, infer_user_agent: inferSetting }
+      },
+      items
+    }
   ];
 }
-
-/**
- * Creates an envelope for a list of metrics.
- *
- * Metrics from multiple traces can be included in the same envelope.
- *
- * @param metrics - The metrics to include in the envelope.
- * @param metadata - The metadata to include in the envelope.
- * @param tunnel - The tunnel to include in the envelope.
- * @param dsn - The DSN to include in the envelope.
- * @param inferUserData - If true, tells Relay to infer the end-user IP and User-Agent from the incoming request.
- * @returns The created envelope.
- */
-function createMetricEnvelope(
-  metrics,
-  metadata,
-  tunnel,
-  dsn$1,
-  inferUserData,
-) {
+function createMetricEnvelope(metrics, metadata, tunnel, dsn$1, inferUserData) {
   const headers = {};
-
   if (metadata?.sdk) {
     headers.sdk = {
       name: metadata.sdk.name,
-      version: metadata.sdk.version,
+      version: metadata.sdk.version
     };
   }
-
   if (!!tunnel && !!dsn$1) {
     headers.dsn = dsn.dsnToString(dsn$1);
   }
-
   return envelope.createEnvelope(headers, [createMetricContainerEnvelopeItem(metrics, inferUserData)]);
 }
 

package/build/cjs/metrics/envelope.js.map

@@ -1 +1 @@
-{"version":3,"file":"envelope.js","sources":["../../../src/metrics/envelope.ts"],"sourcesContent":["import type { DsnComponents } from '../types-hoist/dsn';\nimport type { MetricContainerItem, MetricEnvelope } from '../types-hoist/envelope';\nimport type { SerializedMetric } from '../types-hoist/metric';\nimport type { SdkMetadata } from '../types-hoist/sdkmetadata';\nimport { dsnToString } from '../utils/dsn';\nimport { createEnvelope } from '../utils/envelope';\nimport { isBrowser } from '../utils/isBrowser';\n\n/**\n * Creates a metric container envelope item for a list of metrics.\n *\n * @param items - The metrics to include in the envelope.\n * @param inferUserData - If true, tells Relay to infer the end-user IP and User-Agent from the incoming request.\n *                        Only emitted as `ingest_settings` in browser environments.\n * @returns The created metric container envelope item.\n */\nexport function createMetricContainerEnvelopeItem(\n  items: Array<SerializedMetric>,\n  inferUserData?: boolean,\n): MetricContainerItem {\n  const inferSetting = inferUserData ? 'auto' : 'never';\n  return [\n    {\n      type: 'trace_metric',\n      item_count: items.length,\n      content_type: 'application/vnd.sentry.items.trace-metric+json',\n    } as MetricContainerItem[0],\n    {\n      version: 2,\n      ...(isBrowser() && {\n        ingest_settings: { infer_ip: inferSetting, infer_user_agent: inferSetting },\n      }),\n      items,\n    },\n  ];\n}\n\n/**\n * Creates an envelope for a list of metrics.\n *\n * Metrics from multiple traces can be included in the same envelope.\n *\n * @param metrics - The metrics to include in the envelope.\n * @param metadata - The metadata to include in the envelope.\n * @param tunnel - The tunnel to include in the envelope.\n * @param dsn - The DSN to include in the envelope.\n * @param inferUserData - If true, tells Relay to infer the end-user IP and User-Agent from the incoming request.\n * @returns The created envelope.\n */\nexport function createMetricEnvelope(\n  metrics: Array<SerializedMetric>,\n  metadata?: SdkMetadata,\n  tunnel?: string,\n  dsn?: DsnComponents,\n  inferUserData?: boolean,\n): MetricEnvelope {\n  const headers: MetricEnvelope[0] = {};\n\n  if (metadata?.sdk) {\n    headers.sdk = {\n      name: metadata.sdk.name,\n      version: metadata.sdk.version,\n    };\n  }\n\n  if (!!tunnel && !!dsn) {\n    headers.dsn = dsnToString(dsn);\n  }\n\n  return createEnvelope<MetricEnvelope>(headers, [createMetricContainerEnvelopeItem(metrics, inferUserData)]);\n}\n"],"names":["isBrowser","dsn","dsnToString","createEnvelope"],"mappings":";;;;;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,iCAAiC;AACjD,EAAE,KAAK;AACP,EAAE,aAAa;AACf,EAAuB;AACvB,EAAE,MAAM,YAAA,GAAe,gBAAgB,MAAA,GAAS,OAAO;AACvD,EAAE,OAAO;AACT,IAAI;AACJ,MAAM,IAAI,EAAE,cAAc;AAC1B,MAAM,UAAU,EAAE,KAAK,CAAC,MAAM;AAC9B,MAAM,YAAY,EAAE,gDAAgD;AACpE,KAAI;AACJ,IAAI;AACJ,MAAM,OAAO,EAAE,CAAC;AAChB,MAAM,IAAIA,mBAAS,MAAM;AACzB,QAAQ,eAAe,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAA,EAAc;AACnF,OAAO,CAAC;AACR,MAAM,KAAK;AACX,KAAK;AACL,GAAG;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,oBAAoB;AACpC,EAAE,OAAO;AACT,EAAE,QAAQ;AACV,EAAE,MAAM;AACR,EAAEC,KAAG;AACL,EAAE,aAAa;AACf,EAAkB;AAClB,EAAE,MAAM,OAAO,GAAsB,EAAE;;AAEvC,EAAE,IAAI,QAAQ,EAAE,GAAG,EAAE;AACrB,IAAI,OAAO,CAAC,GAAA,GAAM;AAClB,MAAM,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI;AAC7B,MAAM,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO;AACnC,KAAK;AACL,EAAE;;AAEF,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,CAACA,KAAG,EAAE;AACzB,IAAI,OAAO,CAAC,GAAA,GAAMC,eAAW,CAACD,KAAG,CAAC;AAClC,EAAE;;AAEF,EAAE,OAAOE,uBAAc,CAAiB,OAAO,EAAE,CAAC,iCAAiC,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;AAC7G;;;;;"}
+{"version":3,"file":"envelope.js","sources":["../../../src/metrics/envelope.ts"],"sourcesContent":["import type { DsnComponents } from '../types/dsn';\nimport type { MetricContainerItem, MetricEnvelope } from '../types/envelope';\nimport type { SerializedMetric } from '../types/metric';\nimport type { SdkMetadata } from '../types/sdkmetadata';\nimport { dsnToString } from '../utils/dsn';\nimport { createEnvelope } from '../utils/envelope';\nimport { isBrowser } from '../utils/isBrowser';\n\n/**\n * Creates a metric container envelope item for a list of metrics.\n *\n * @param items - The metrics to include in the envelope.\n * @param inferUserData - If true, tells Relay to infer the end-user IP and User-Agent from the incoming request.\n *                        Only emitted as `ingest_settings` in browser environments.\n * @returns The created metric container envelope item.\n */\nexport function createMetricContainerEnvelopeItem(\n  items: Array<SerializedMetric>,\n  inferUserData?: boolean,\n): MetricContainerItem {\n  const inferSetting = inferUserData ? 'auto' : 'never';\n  return [\n    {\n      type: 'trace_metric',\n      item_count: items.length,\n      content_type: 'application/vnd.sentry.items.trace-metric+json',\n    } as MetricContainerItem[0],\n    {\n      version: 2,\n      ...(isBrowser() && {\n        ingest_settings: { infer_ip: inferSetting, infer_user_agent: inferSetting },\n      }),\n      items,\n    },\n  ];\n}\n\n/**\n * Creates an envelope for a list of metrics.\n *\n * Metrics from multiple traces can be included in the same envelope.\n *\n * @param metrics - The metrics to include in the envelope.\n * @param metadata - The metadata to include in the envelope.\n * @param tunnel - The tunnel to include in the envelope.\n * @param dsn - The DSN to include in the envelope.\n * @param inferUserData - If true, tells Relay to infer the end-user IP and User-Agent from the incoming request.\n * @returns The created envelope.\n */\nexport function createMetricEnvelope(\n  metrics: Array<SerializedMetric>,\n  metadata?: SdkMetadata,\n  tunnel?: string,\n  dsn?: DsnComponents,\n  inferUserData?: boolean,\n): MetricEnvelope {\n  const headers: MetricEnvelope[0] = {};\n\n  if (metadata?.sdk) {\n    headers.sdk = {\n      name: metadata.sdk.name,\n      version: metadata.sdk.version,\n    };\n  }\n\n  if (!!tunnel && !!dsn) {\n    headers.dsn = dsnToString(dsn);\n  }\n\n  return createEnvelope<MetricEnvelope>(headers, [createMetricContainerEnvelopeItem(metrics, inferUserData)]);\n}\n"],"names":["isBrowser","dsn","dsnToString","createEnvelope"],"mappings":";;;;;;AAgBO,SAAS,iCAAA,CACd,OACA,aAAA,EACqB;AACrB,EAAA,MAAM,YAAA,GAAe,gBAAgB,MAAA,GAAS,OAAA;AAC9C,EAAA,OAAO;AAAA,IACL;AAAA,MACE,IAAA,EAAM,cAAA;AAAA,MACN,YAAY,KAAA,CAAM,MAAA;AAAA,MAClB,YAAA,EAAc;AAAA,KAChB;AAAA,IACA;AAAA,MACE,OAAA,EAAS,CAAA;AAAA,MACT,GAAIA,qBAAU,IAAK;AAAA,QACjB,eAAA,EAAiB,EAAE,QAAA,EAAU,YAAA,EAAc,kBAAkB,YAAA;AAAa,OAC5E;AAAA,MACA;AAAA;AACF,GACF;AACF;AAcO,SAAS,oBAAA,CACd,OAAA,EACA,QAAA,EACA,MAAA,EACAC,OACA,aAAA,EACgB;AAChB,EAAA,MAAM,UAA6B,EAAC;AAEpC,EAAA,IAAI,UAAU,GAAA,EAAK;AACjB,IAAA,OAAA,CAAQ,GAAA,GAAM;AAAA,MACZ,IAAA,EAAM,SAAS,GAAA,CAAI,IAAA;AAAA,MACnB,OAAA,EAAS,SAAS,GAAA,CAAI;AAAA,KACxB;AAAA,EACF;AAEA,EAAA,IAAI,CAAC,CAAC,MAAA,IAAU,CAAC,CAACA,KAAA,EAAK;AACrB,IAAA,OAAA,CAAQ,GAAA,GAAMC,gBAAYD,KAAG,CAAA;AAAA,EAC/B;AAEA,EAAA,OAAOE,wBAA+B,OAAA,EAAS,CAAC,kCAAkC,OAAA,EAAS,aAAa,CAAC,CAAC,CAAA;AAC5G;;;;;"}

package/build/cjs/metrics/internal.js

@@ -12,41 +12,16 @@ const timestampSequence = require('../utils/timestampSequence.js');
 const traceInfo = require('../utils/trace-info.js');
 const envelope = require('./envelope.js');
 
-const MAX_METRIC_BUFFER_SIZE = 1000;
-
-/**
- * Sets a metric attribute if the value exists and the attribute key is not already present.
- *
- * @param metricAttributes - The metric attributes object to modify.
- * @param key - The attribute key to set.
- * @param value - The value to set (only sets if truthy and key not present).
- * @param setEvenIfPresent - Whether to set the attribute if it is present. Defaults to true.
- */
-function setMetricAttribute(
-  metricAttributes,
-  key,
-  value,
-  setEvenIfPresent = true,
-) {
+const MAX_METRIC_BUFFER_SIZE = 1e3;
+function setMetricAttribute(metricAttributes, key, value, setEvenIfPresent = true) {
   if (value && (setEvenIfPresent || !(key in metricAttributes))) {
     metricAttributes[key] = value;
   }
 }
-
-/**
- * Captures a serialized metric event and adds it to the metric buffer for the given client.
- *
- * @param client - A client. Uses the current client if not provided.
- * @param serializedMetric - The serialized metric event to capture.
- *
- * @experimental This method will experience breaking changes. This is not yet part of
- * the stable Sentry SDK API and can be changed or removed without warning.
- */
 function _INTERNAL_captureSerializedMetric(client, serializedMetric) {
   const bufferMap = _getBufferMap();
   const metricBuffer = _INTERNAL_getMetricBuffer(client);
-
-  if (metricBuffer === undefined) {
+  if (metricBuffer === void 0) {
     bufferMap.set(client, [serializedMetric]);
   } else {
     if (metricBuffer.length >= MAX_METRIC_BUFFER_SIZE) {
@@ -57,74 +32,40 @@ function _INTERNAL_captureSerializedMetric(client, serializedMetric) {
     }
   }
 }
-
-/**
- * Options for capturing a metric internally.
- */
-
-/**
- * Enriches metric with all contextual attributes (user, SDK metadata, replay, etc.)
- */
 function _enrichMetricAttributes(beforeMetric, client, user) {
   const { release, environment } = client.getOptions();
-
   const processedMetricAttributes = {
-    ...beforeMetric.attributes,
+    ...beforeMetric.attributes
   };
-
-  // Add user attributes
-  setMetricAttribute(processedMetricAttributes, 'user.id', user.id, false);
-  setMetricAttribute(processedMetricAttributes, 'user.email', user.email, false);
-  setMetricAttribute(processedMetricAttributes, 'user.name', user.username, false);
-
-  // Add Sentry metadata
-  setMetricAttribute(processedMetricAttributes, 'sentry.release', release);
-  setMetricAttribute(processedMetricAttributes, 'sentry.environment', environment);
-
-  // Add SDK metadata
+  setMetricAttribute(processedMetricAttributes, "user.id", user.id, false);
+  setMetricAttribute(processedMetricAttributes, "user.email", user.email, false);
+  setMetricAttribute(processedMetricAttributes, "user.name", user.username, false);
+  setMetricAttribute(processedMetricAttributes, "sentry.release", release);
+  setMetricAttribute(processedMetricAttributes, "sentry.environment", environment);
   const { name, version } = client.getSdkMetadata()?.sdk ?? {};
-  setMetricAttribute(processedMetricAttributes, 'sentry.sdk.name', name);
-  setMetricAttribute(processedMetricAttributes, 'sentry.sdk.version', version);
-
-  // Add replay metadata
-  const replay = client.getIntegrationByName
-
-('Replay');
-
+  setMetricAttribute(processedMetricAttributes, "sentry.sdk.name", name);
+  setMetricAttribute(processedMetricAttributes, "sentry.sdk.version", version);
+  const replay = client.getIntegrationByName("Replay");
   const replayId = replay?.getReplayId(true);
-  setMetricAttribute(processedMetricAttributes, 'sentry.replay_id', replayId);
-
-  if (replayId && replay?.getRecordingMode() === 'buffer') {
-    setMetricAttribute(processedMetricAttributes, 'sentry._internal.replay_is_buffering', true);
+  setMetricAttribute(processedMetricAttributes, "sentry.replay_id", replayId);
+  if (replayId && replay?.getRecordingMode() === "buffer") {
+    setMetricAttribute(processedMetricAttributes, "sentry._internal.replay_is_buffering", true);
   }
-
   return {
     ...beforeMetric,
-    attributes: processedMetricAttributes,
+    attributes: processedMetricAttributes
   };
 }
-
-/**
- * Creates a serialized metric ready to be sent to Sentry.
- */
-function _buildSerializedMetric(
-  metric,
-  client,
-  currentScope,
-  scopeAttributes,
-) {
-  // Get trace context
+function _buildSerializedMetric(metric, client, currentScope, scopeAttributes) {
   const [, traceContext] = traceInfo._getTraceInfoFromScope(client, currentScope);
   const span = spanOnScope._getSpanForScope(currentScope);
   const traceId = span ? span.spanContext().traceId : traceContext?.trace_id;
-  const spanId = span ? span.spanContext().spanId : undefined;
-
+  const spanId = span ? span.spanContext().spanId : void 0;
   const timestamp = time.timestampInSeconds();
   const sequenceAttr = timestampSequence.getSequenceAttribute(timestamp);
-
   return {
     timestamp,
-    trace_id: traceId ?? '',
+    trace_id: traceId ?? "",
     span_id: spanId,
     name: metric.name,
     type: metric.type,
@@ -132,115 +73,61 @@ function _buildSerializedMetric(
     value: metric.value,
     attributes: {
       ...attributes.serializeAttributes(scopeAttributes),
-      ...attributes.serializeAttributes(metric.attributes, 'skip-undefined'),
-      [sequenceAttr.key]: sequenceAttr.value,
-    },
+      ...attributes.serializeAttributes(metric.attributes, "skip-undefined"),
+      [sequenceAttr.key]: sequenceAttr.value
+    }
   };
 }
-
-/**
- * Captures a metric event and sends it to Sentry.
- *
- * @param metric - The metric event to capture.
- * @param options - Options for capturing the metric.
- *
- * @experimental This method will experience breaking changes. This is not yet part of
- * the stable Sentry SDK API and can be changed or removed without warning.
- */
 function _INTERNAL_captureMetric(beforeMetric, options) {
   const currentScope = options?.scope ?? currentScopes.getCurrentScope();
   const captureSerializedMetric = options?.captureSerializedMetric ?? _INTERNAL_captureSerializedMetric;
   const client = currentScope?.getClient() ?? currentScopes.getClient();
   if (!client) {
-    debugBuild.DEBUG_BUILD && debugLogger.debug.warn('No client available to capture metric.');
+    debugBuild.DEBUG_BUILD && debugLogger.debug.warn("No client available to capture metric.");
     return;
   }
-
   const { _experiments, enableMetrics, beforeSendMetric } = client.getOptions();
-
-  // todo(v11): Remove the experimental flag
-  // eslint-disable-next-line deprecation/deprecation
   const metricsEnabled = enableMetrics ?? _experiments?.enableMetrics ?? true;
-
   if (!metricsEnabled) {
-    debugBuild.DEBUG_BUILD && debugLogger.debug.warn('metrics option not enabled, metric will not be captured.');
+    debugBuild.DEBUG_BUILD && debugLogger.debug.warn("metrics option not enabled, metric will not be captured.");
     return;
   }
-
-  // Enrich metric with contextual attributes
   const { user, attributes: scopeAttributes } = scopeData.getCombinedScopeData(currentScopes.getIsolationScope(), currentScope);
   const enrichedMetric = _enrichMetricAttributes(beforeMetric, client, user);
-
-  client.emit('processMetric', enrichedMetric);
-
-  // todo(v11): Remove the experimental `beforeSendMetric`
-  // eslint-disable-next-line deprecation/deprecation
+  client.emit("processMetric", enrichedMetric);
   const beforeSendCallback = beforeSendMetric || _experiments?.beforeSendMetric;
   const processedMetric = beforeSendCallback ? beforeSendCallback(enrichedMetric) : enrichedMetric;
-
   if (!processedMetric) {
-    debugBuild.DEBUG_BUILD && debugLogger.debug.log('`beforeSendMetric` returned `null`, will not send metric.');
+    debugBuild.DEBUG_BUILD && debugLogger.debug.log("`beforeSendMetric` returned `null`, will not send metric.");
     return;
   }
-
   const serializedMetric = _buildSerializedMetric(processedMetric, client, currentScope, scopeAttributes);
-
-  debugBuild.DEBUG_BUILD && debugLogger.debug.log('[Metric]', serializedMetric);
-
+  debugBuild.DEBUG_BUILD && debugLogger.debug.log("[Metric]", serializedMetric);
   captureSerializedMetric(client, serializedMetric);
-
-  client.emit('afterCaptureMetric', processedMetric);
+  client.emit("afterCaptureMetric", processedMetric);
 }
-
-/**
- * Flushes the metrics buffer to Sentry.
- *
- * @param client - A client.
- * @param maybeMetricBuffer - A metric buffer. Uses the metric buffer for the given client if not provided.
- *
- * @experimental This method will experience breaking changes. This is not yet part of
- * the stable Sentry SDK API and can be changed or removed without warning.
- */
 function _INTERNAL_flushMetricsBuffer(client, maybeMetricBuffer) {
   const metricBuffer = maybeMetricBuffer ?? _INTERNAL_getMetricBuffer(client) ?? [];
   if (metricBuffer.length === 0) {
     return;
   }
-
   const clientOptions = client.getOptions();
   const envelope$1 = envelope.createMetricEnvelope(
     metricBuffer,
     clientOptions._metadata,
     clientOptions.tunnel,
     client.getDsn(),
-    clientOptions.sendDefaultPii,
+    clientOptions.sendDefaultPii
   );
-
-  // Clear the metric buffer after envelopes have been constructed.
   _getBufferMap().set(client, []);
-
-  client.emit('flushMetrics');
-
-  // sendEnvelope should not throw
-  // eslint-disable-next-line @typescript-eslint/no-floating-promises
+  client.emit("flushMetrics");
   client.sendEnvelope(envelope$1);
 }
-
-/**
- * Returns the metric buffer for a given client.
- *
- * Exported for testing purposes.
- *
- * @param client - The client to get the metric buffer for.
- * @returns The metric buffer for the given client.
- */
 function _INTERNAL_getMetricBuffer(client) {
   return _getBufferMap().get(client);
 }
-
 function _getBufferMap() {
-  // The reference to the Client <> MetricBuffer map is stored on the carrier to ensure it's always the same
-  return carrier.getGlobalSingleton('clientToMetricBufferMap', () => new WeakMap());
+  return carrier.getGlobalSingleton("clientToMetricBufferMap", () => /* @__PURE__ */ new WeakMap());
 }
 
 exports._INTERNAL_captureMetric = _INTERNAL_captureMetric;

package/build/cjs/metrics/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sources":["../../../src/metrics/internal.ts"],"sourcesContent":["import { type RawAttributes, serializeAttributes } from '../attributes';\nimport { getGlobalSingleton } from '../carrier';\nimport type { Client } from '../client';\nimport { getClient, getCurrentScope, getIsolationScope } from '../currentScopes';\nimport { DEBUG_BUILD } from '../debug-build';\nimport type { Scope } from '../scope';\nimport type { Integration } from '../types-hoist/integration';\nimport type { Metric, SerializedMetric } from '../types-hoist/metric';\nimport type { User } from '../types-hoist/user';\nimport { debug } from '../utils/debug-logger';\nimport { getCombinedScopeData } from '../utils/scopeData';\nimport { _getSpanForScope } from '../utils/spanOnScope';\nimport { timestampInSeconds } from '../utils/time';\nimport { getSequenceAttribute } from '../utils/timestampSequence';\nimport { _getTraceInfoFromScope } from '../utils/trace-info';\nimport { createMetricEnvelope } from './envelope';\n\nconst MAX_METRIC_BUFFER_SIZE = 1000;\n\n/**\n * Sets a metric attribute if the value exists and the attribute key is not already present.\n *\n * @param metricAttributes - The metric attributes object to modify.\n * @param key - The attribute key to set.\n * @param value - The value to set (only sets if truthy and key not present).\n * @param setEvenIfPresent - Whether to set the attribute if it is present. Defaults to true.\n */\nfunction setMetricAttribute(\n  metricAttributes: Record<string, unknown>,\n  key: string,\n  value: unknown,\n  setEvenIfPresent = true,\n): void {\n  if (value && (setEvenIfPresent || !(key in metricAttributes))) {\n    metricAttributes[key] = value;\n  }\n}\n\n/**\n * Captures a serialized metric event and adds it to the metric buffer for the given client.\n *\n * @param client - A client. Uses the current client if not provided.\n * @param serializedMetric - The serialized metric event to capture.\n *\n * @experimental This method will experience breaking changes. This is not yet part of\n * the stable Sentry SDK API and can be changed or removed without warning.\n */\nexport function _INTERNAL_captureSerializedMetric(client: Client, serializedMetric: SerializedMetric): void {\n  const bufferMap = _getBufferMap();\n  const metricBuffer = _INTERNAL_getMetricBuffer(client);\n\n  if (metricBuffer === undefined) {\n    bufferMap.set(client, [serializedMetric]);\n  } else {\n    if (metricBuffer.length >= MAX_METRIC_BUFFER_SIZE) {\n      _INTERNAL_flushMetricsBuffer(client, metricBuffer);\n      bufferMap.set(client, [serializedMetric]);\n    } else {\n      bufferMap.set(client, [...metricBuffer, serializedMetric]);\n    }\n  }\n}\n\n/**\n * Options for capturing a metric internally.\n */\nexport interface InternalCaptureMetricOptions {\n  /**\n   * The scope to capture the metric with.\n   */\n  scope?: Scope;\n\n  /**\n   * A function to capture the serialized metric.\n   */\n  captureSerializedMetric?: (client: Client, metric: SerializedMetric) => void;\n}\n\n/**\n * Enriches metric with all contextual attributes (user, SDK metadata, replay, etc.)\n */\nfunction _enrichMetricAttributes(beforeMetric: Metric, client: Client, user: User): Metric {\n  const { release, environment } = client.getOptions();\n\n  const processedMetricAttributes = {\n    ...beforeMetric.attributes,\n  };\n\n  // Add user attributes\n  setMetricAttribute(processedMetricAttributes, 'user.id', user.id, false);\n  setMetricAttribute(processedMetricAttributes, 'user.email', user.email, false);\n  setMetricAttribute(processedMetricAttributes, 'user.name', user.username, false);\n\n  // Add Sentry metadata\n  setMetricAttribute(processedMetricAttributes, 'sentry.release', release);\n  setMetricAttribute(processedMetricAttributes, 'sentry.environment', environment);\n\n  // Add SDK metadata\n  const { name, version } = client.getSdkMetadata()?.sdk ?? {};\n  setMetricAttribute(processedMetricAttributes, 'sentry.sdk.name', name);\n  setMetricAttribute(processedMetricAttributes, 'sentry.sdk.version', version);\n\n  // Add replay metadata\n  const replay = client.getIntegrationByName<\n    Integration & {\n      getReplayId: (onlyIfSampled?: boolean) => string;\n      getRecordingMode: () => 'session' | 'buffer' | undefined;\n    }\n  >('Replay');\n\n  const replayId = replay?.getReplayId(true);\n  setMetricAttribute(processedMetricAttributes, 'sentry.replay_id', replayId);\n\n  if (replayId && replay?.getRecordingMode() === 'buffer') {\n    setMetricAttribute(processedMetricAttributes, 'sentry._internal.replay_is_buffering', true);\n  }\n\n  return {\n    ...beforeMetric,\n    attributes: processedMetricAttributes,\n  };\n}\n\n/**\n * Creates a serialized metric ready to be sent to Sentry.\n */\nfunction _buildSerializedMetric(\n  metric: Metric,\n  client: Client,\n  currentScope: Scope,\n  scopeAttributes: RawAttributes<Record<string, unknown>> | undefined,\n): SerializedMetric {\n  // Get trace context\n  const [, traceContext] = _getTraceInfoFromScope(client, currentScope);\n  const span = _getSpanForScope(currentScope);\n  const traceId = span ? span.spanContext().traceId : traceContext?.trace_id;\n  const spanId = span ? span.spanContext().spanId : undefined;\n\n  const timestamp = timestampInSeconds();\n  const sequenceAttr = getSequenceAttribute(timestamp);\n\n  return {\n    timestamp,\n    trace_id: traceId ?? '',\n    span_id: spanId,\n    name: metric.name,\n    type: metric.type,\n    unit: metric.unit,\n    value: metric.value,\n    attributes: {\n      ...serializeAttributes(scopeAttributes),\n      ...serializeAttributes(metric.attributes, 'skip-undefined'),\n      [sequenceAttr.key]: sequenceAttr.value,\n    },\n  };\n}\n\n/**\n * Captures a metric event and sends it to Sentry.\n *\n * @param metric - The metric event to capture.\n * @param options - Options for capturing the metric.\n *\n * @experimental This method will experience breaking changes. This is not yet part of\n * the stable Sentry SDK API and can be changed or removed without warning.\n */\nexport function _INTERNAL_captureMetric(beforeMetric: Metric, options?: InternalCaptureMetricOptions): void {\n  const currentScope = options?.scope ?? getCurrentScope();\n  const captureSerializedMetric = options?.captureSerializedMetric ?? _INTERNAL_captureSerializedMetric;\n  const client = currentScope?.getClient() ?? getClient();\n  if (!client) {\n    DEBUG_BUILD && debug.warn('No client available to capture metric.');\n    return;\n  }\n\n  const { _experiments, enableMetrics, beforeSendMetric } = client.getOptions();\n\n  // todo(v11): Remove the experimental flag\n  // eslint-disable-next-line deprecation/deprecation\n  const metricsEnabled = enableMetrics ?? _experiments?.enableMetrics ?? true;\n\n  if (!metricsEnabled) {\n    DEBUG_BUILD && debug.warn('metrics option not enabled, metric will not be captured.');\n    return;\n  }\n\n  // Enrich metric with contextual attributes\n  const { user, attributes: scopeAttributes } = getCombinedScopeData(getIsolationScope(), currentScope);\n  const enrichedMetric = _enrichMetricAttributes(beforeMetric, client, user);\n\n  client.emit('processMetric', enrichedMetric);\n\n  // todo(v11): Remove the experimental `beforeSendMetric`\n  // eslint-disable-next-line deprecation/deprecation\n  const beforeSendCallback = beforeSendMetric || _experiments?.beforeSendMetric;\n  const processedMetric = beforeSendCallback ? beforeSendCallback(enrichedMetric) : enrichedMetric;\n\n  if (!processedMetric) {\n    DEBUG_BUILD && debug.log('`beforeSendMetric` returned `null`, will not send metric.');\n    return;\n  }\n\n  const serializedMetric = _buildSerializedMetric(processedMetric, client, currentScope, scopeAttributes);\n\n  DEBUG_BUILD && debug.log('[Metric]', serializedMetric);\n\n  captureSerializedMetric(client, serializedMetric);\n\n  client.emit('afterCaptureMetric', processedMetric);\n}\n\n/**\n * Flushes the metrics buffer to Sentry.\n *\n * @param client - A client.\n * @param maybeMetricBuffer - A metric buffer. Uses the metric buffer for the given client if not provided.\n *\n * @experimental This method will experience breaking changes. This is not yet part of\n * the stable Sentry SDK API and can be changed or removed without warning.\n */\nexport function _INTERNAL_flushMetricsBuffer(client: Client, maybeMetricBuffer?: Array<SerializedMetric>): void {\n  const metricBuffer = maybeMetricBuffer ?? _INTERNAL_getMetricBuffer(client) ?? [];\n  if (metricBuffer.length === 0) {\n    return;\n  }\n\n  const clientOptions = client.getOptions();\n  const envelope = createMetricEnvelope(\n    metricBuffer,\n    clientOptions._metadata,\n    clientOptions.tunnel,\n    client.getDsn(),\n    clientOptions.sendDefaultPii,\n  );\n\n  // Clear the metric buffer after envelopes have been constructed.\n  _getBufferMap().set(client, []);\n\n  client.emit('flushMetrics');\n\n  // sendEnvelope should not throw\n  // eslint-disable-next-line @typescript-eslint/no-floating-promises\n  client.sendEnvelope(envelope);\n}\n\n/**\n * Returns the metric buffer for a given client.\n *\n * Exported for testing purposes.\n *\n * @param client - The client to get the metric buffer for.\n * @returns The metric buffer for the given client.\n */\nexport function _INTERNAL_getMetricBuffer(client: Client): Array<SerializedMetric> | undefined {\n  return _getBufferMap().get(client);\n}\n\nfunction _getBufferMap(): WeakMap<Client, Array<SerializedMetric>> {\n  // The reference to the Client <> MetricBuffer map is stored on the carrier to ensure it's always the same\n  return getGlobalSingleton('clientToMetricBufferMap', () => new WeakMap<Client, Array<SerializedMetric>>());\n}\n"],"names":["_getTraceInfoFromScope","_getSpanForScope","timestampInSeconds","getSequenceAttribute","serializeAttributes","getCurrentScope","getClient","DEBUG_BUILD","debug","getCombinedScopeData","getIsolationScope","envelope","createMetricEnvelope","getGlobalSingleton"],"mappings":"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"}
+{"version":3,"file":"internal.js","sources":["../../../src/metrics/internal.ts"],"sourcesContent":["import { type RawAttributes, serializeAttributes } from '../attributes';\nimport { getGlobalSingleton } from '../carrier';\nimport type { Client } from '../client';\nimport { getClient, getCurrentScope, getIsolationScope } from '../currentScopes';\nimport { DEBUG_BUILD } from '../debug-build';\nimport type { Scope } from '../scope';\nimport type { Integration } from '../types/integration';\nimport type { Metric, SerializedMetric } from '../types/metric';\nimport type { User } from '../types/user';\nimport { debug } from '../utils/debug-logger';\nimport { getCombinedScopeData } from '../utils/scopeData';\nimport { _getSpanForScope } from '../utils/spanOnScope';\nimport { timestampInSeconds } from '../utils/time';\nimport { getSequenceAttribute } from '../utils/timestampSequence';\nimport { _getTraceInfoFromScope } from '../utils/trace-info';\nimport { createMetricEnvelope } from './envelope';\n\nconst MAX_METRIC_BUFFER_SIZE = 1000;\n\n/**\n * Sets a metric attribute if the value exists and the attribute key is not already present.\n *\n * @param metricAttributes - The metric attributes object to modify.\n * @param key - The attribute key to set.\n * @param value - The value to set (only sets if truthy and key not present).\n * @param setEvenIfPresent - Whether to set the attribute if it is present. Defaults to true.\n */\nfunction setMetricAttribute(\n  metricAttributes: Record<string, unknown>,\n  key: string,\n  value: unknown,\n  setEvenIfPresent = true,\n): void {\n  if (value && (setEvenIfPresent || !(key in metricAttributes))) {\n    metricAttributes[key] = value;\n  }\n}\n\n/**\n * Captures a serialized metric event and adds it to the metric buffer for the given client.\n *\n * @param client - A client. Uses the current client if not provided.\n * @param serializedMetric - The serialized metric event to capture.\n *\n * @experimental This method will experience breaking changes. This is not yet part of\n * the stable Sentry SDK API and can be changed or removed without warning.\n */\nexport function _INTERNAL_captureSerializedMetric(client: Client, serializedMetric: SerializedMetric): void {\n  const bufferMap = _getBufferMap();\n  const metricBuffer = _INTERNAL_getMetricBuffer(client);\n\n  if (metricBuffer === undefined) {\n    bufferMap.set(client, [serializedMetric]);\n  } else {\n    if (metricBuffer.length >= MAX_METRIC_BUFFER_SIZE) {\n      _INTERNAL_flushMetricsBuffer(client, metricBuffer);\n      bufferMap.set(client, [serializedMetric]);\n    } else {\n      bufferMap.set(client, [...metricBuffer, serializedMetric]);\n    }\n  }\n}\n\n/**\n * Options for capturing a metric internally.\n */\nexport interface InternalCaptureMetricOptions {\n  /**\n   * The scope to capture the metric with.\n   */\n  scope?: Scope;\n\n  /**\n   * A function to capture the serialized metric.\n   */\n  captureSerializedMetric?: (client: Client, metric: SerializedMetric) => void;\n}\n\n/**\n * Enriches metric with all contextual attributes (user, SDK metadata, replay, etc.)\n */\nfunction _enrichMetricAttributes(beforeMetric: Metric, client: Client, user: User): Metric {\n  const { release, environment } = client.getOptions();\n\n  const processedMetricAttributes = {\n    ...beforeMetric.attributes,\n  };\n\n  // Add user attributes\n  setMetricAttribute(processedMetricAttributes, 'user.id', user.id, false);\n  setMetricAttribute(processedMetricAttributes, 'user.email', user.email, false);\n  setMetricAttribute(processedMetricAttributes, 'user.name', user.username, false);\n\n  // Add Sentry metadata\n  setMetricAttribute(processedMetricAttributes, 'sentry.release', release);\n  setMetricAttribute(processedMetricAttributes, 'sentry.environment', environment);\n\n  // Add SDK metadata\n  const { name, version } = client.getSdkMetadata()?.sdk ?? {};\n  setMetricAttribute(processedMetricAttributes, 'sentry.sdk.name', name);\n  setMetricAttribute(processedMetricAttributes, 'sentry.sdk.version', version);\n\n  // Add replay metadata\n  const replay = client.getIntegrationByName<\n    Integration & {\n      getReplayId: (onlyIfSampled?: boolean) => string;\n      getRecordingMode: () => 'session' | 'buffer' | undefined;\n    }\n  >('Replay');\n\n  const replayId = replay?.getReplayId(true);\n  setMetricAttribute(processedMetricAttributes, 'sentry.replay_id', replayId);\n\n  if (replayId && replay?.getRecordingMode() === 'buffer') {\n    setMetricAttribute(processedMetricAttributes, 'sentry._internal.replay_is_buffering', true);\n  }\n\n  return {\n    ...beforeMetric,\n    attributes: processedMetricAttributes,\n  };\n}\n\n/**\n * Creates a serialized metric ready to be sent to Sentry.\n */\nfunction _buildSerializedMetric(\n  metric: Metric,\n  client: Client,\n  currentScope: Scope,\n  scopeAttributes: RawAttributes<Record<string, unknown>> | undefined,\n): SerializedMetric {\n  // Get trace context\n  const [, traceContext] = _getTraceInfoFromScope(client, currentScope);\n  const span = _getSpanForScope(currentScope);\n  const traceId = span ? span.spanContext().traceId : traceContext?.trace_id;\n  const spanId = span ? span.spanContext().spanId : undefined;\n\n  const timestamp = timestampInSeconds();\n  const sequenceAttr = getSequenceAttribute(timestamp);\n\n  return {\n    timestamp,\n    trace_id: traceId ?? '',\n    span_id: spanId,\n    name: metric.name,\n    type: metric.type,\n    unit: metric.unit,\n    value: metric.value,\n    attributes: {\n      ...serializeAttributes(scopeAttributes),\n      ...serializeAttributes(metric.attributes, 'skip-undefined'),\n      [sequenceAttr.key]: sequenceAttr.value,\n    },\n  };\n}\n\n/**\n * Captures a metric event and sends it to Sentry.\n *\n * @param metric - The metric event to capture.\n * @param options - Options for capturing the metric.\n *\n * @experimental This method will experience breaking changes. This is not yet part of\n * the stable Sentry SDK API and can be changed or removed without warning.\n */\nexport function _INTERNAL_captureMetric(beforeMetric: Metric, options?: InternalCaptureMetricOptions): void {\n  const currentScope = options?.scope ?? getCurrentScope();\n  const captureSerializedMetric = options?.captureSerializedMetric ?? _INTERNAL_captureSerializedMetric;\n  const client = currentScope?.getClient() ?? getClient();\n  if (!client) {\n    DEBUG_BUILD && debug.warn('No client available to capture metric.');\n    return;\n  }\n\n  const { _experiments, enableMetrics, beforeSendMetric } = client.getOptions();\n\n  // todo(v11): Remove the experimental flag\n  // eslint-disable-next-line deprecation/deprecation\n  const metricsEnabled = enableMetrics ?? _experiments?.enableMetrics ?? true;\n\n  if (!metricsEnabled) {\n    DEBUG_BUILD && debug.warn('metrics option not enabled, metric will not be captured.');\n    return;\n  }\n\n  // Enrich metric with contextual attributes\n  const { user, attributes: scopeAttributes } = getCombinedScopeData(getIsolationScope(), currentScope);\n  const enrichedMetric = _enrichMetricAttributes(beforeMetric, client, user);\n\n  client.emit('processMetric', enrichedMetric);\n\n  // todo(v11): Remove the experimental `beforeSendMetric`\n  // eslint-disable-next-line deprecation/deprecation\n  const beforeSendCallback = beforeSendMetric || _experiments?.beforeSendMetric;\n  const processedMetric = beforeSendCallback ? beforeSendCallback(enrichedMetric) : enrichedMetric;\n\n  if (!processedMetric) {\n    DEBUG_BUILD && debug.log('`beforeSendMetric` returned `null`, will not send metric.');\n    return;\n  }\n\n  const serializedMetric = _buildSerializedMetric(processedMetric, client, currentScope, scopeAttributes);\n\n  DEBUG_BUILD && debug.log('[Metric]', serializedMetric);\n\n  captureSerializedMetric(client, serializedMetric);\n\n  client.emit('afterCaptureMetric', processedMetric);\n}\n\n/**\n * Flushes the metrics buffer to Sentry.\n *\n * @param client - A client.\n * @param maybeMetricBuffer - A metric buffer. Uses the metric buffer for the given client if not provided.\n *\n * @experimental This method will experience breaking changes. This is not yet part of\n * the stable Sentry SDK API and can be changed or removed without warning.\n */\nexport function _INTERNAL_flushMetricsBuffer(client: Client, maybeMetricBuffer?: Array<SerializedMetric>): void {\n  const metricBuffer = maybeMetricBuffer ?? _INTERNAL_getMetricBuffer(client) ?? [];\n  if (metricBuffer.length === 0) {\n    return;\n  }\n\n  const clientOptions = client.getOptions();\n  const envelope = createMetricEnvelope(\n    metricBuffer,\n    clientOptions._metadata,\n    clientOptions.tunnel,\n    client.getDsn(),\n    clientOptions.sendDefaultPii,\n  );\n\n  // Clear the metric buffer after envelopes have been constructed.\n  _getBufferMap().set(client, []);\n\n  client.emit('flushMetrics');\n\n  // sendEnvelope should not throw\n  // eslint-disable-next-line @typescript-eslint/no-floating-promises\n  client.sendEnvelope(envelope);\n}\n\n/**\n * Returns the metric buffer for a given client.\n *\n * Exported for testing purposes.\n *\n * @param client - The client to get the metric buffer for.\n * @returns The metric buffer for the given client.\n */\nexport function _INTERNAL_getMetricBuffer(client: Client): Array<SerializedMetric> | undefined {\n  return _getBufferMap().get(client);\n}\n\nfunction _getBufferMap(): WeakMap<Client, Array<SerializedMetric>> {\n  // The reference to the Client <> MetricBuffer map is stored on the carrier to ensure it's always the same\n  return getGlobalSingleton('clientToMetricBufferMap', () => new WeakMap<Client, Array<SerializedMetric>>());\n}\n"],"names":["_getTraceInfoFromScope","_getSpanForScope","timestampInSeconds","getSequenceAttribute","serializeAttributes","getCurrentScope","getClient","DEBUG_BUILD","debug","getCombinedScopeData","getIsolationScope","envelope","createMetricEnvelope","getGlobalSingleton"],"mappings":"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"}

package/build/cjs/metrics/public-api.js

@@ -2,125 +2,20 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const internal = require('./internal.js');
 
-/**
- * Options for capturing a metric.
- */
-
-/**
- * Capture a metric with the given type, name, and value.
- *
- * @param type - The type of the metric.
- * @param name - The name of the metric.
- * @param value - The value of the metric.
- * @param options - Options for capturing the metric.
- */
 function captureMetric(type, name, value, options) {
   internal._INTERNAL_captureMetric(
     { type, name, value, unit: options?.unit, attributes: options?.attributes },
-    { scope: options?.scope },
+    { scope: options?.scope }
   );
 }
-
-/**
- * @summary Increment a counter metric.
- *
- * @param name - The name of the counter metric.
- * @param value - The value to increment by (defaults to 1).
- * @param options - Options for capturing the metric.
- *
- * @example
- *
- * ```
- * Sentry.metrics.count('api.requests', 1, {
- *   attributes: {
- *     endpoint: '/api/users',
- *     method: 'GET',
- *     status: 200
- *   }
- * });
- * ```
- *
- * @example With custom value
- *
- * ```
- * Sentry.metrics.count('items.processed', 5, {
- *   attributes: {
- *     processor: 'batch-processor',
- *     queue: 'high-priority'
- *   }
- * });
- * ```
- */
 function count(name, value = 1, options) {
-  captureMetric('counter', name, value, options);
+  captureMetric("counter", name, value, options);
 }
-
-/**
- * @summary Set a gauge metric to a specific value.
- *
- * @param name - The name of the gauge metric.
- * @param value - The current value of the gauge.
- * @param options - Options for capturing the metric.
- *
- * @example
- *
- * ```
- * Sentry.metrics.gauge('memory.usage', 1024, {
- *   unit: 'megabyte',
- *   attributes: {
- *     process: 'web-server',
- *     region: 'us-east-1'
- *   }
- * });
- * ```
- *
- * @example Without unit
- *
- * ```
- * Sentry.metrics.gauge('active.connections', 42, {
- *   attributes: {
- *     server: 'api-1',
- *     protocol: 'websocket'
- *   }
- * });
- * ```
- */
 function gauge(name, value, options) {
-  captureMetric('gauge', name, value, options);
+  captureMetric("gauge", name, value, options);
 }
-
-/**
- * @summary Record a value in a distribution metric.
- *
- * @param name - The name of the distribution metric.
- * @param value - The value to record in the distribution.
- * @param options - Options for capturing the metric.
- *
- * @example
- *
- * ```
- * Sentry.metrics.distribution('task.duration', 500, {
- *   unit: 'millisecond',
- *   attributes: {
- *     task: 'data-processing',
- *     priority: 'high'
- *   }
- * });
- * ```
- *
- * @example Without unit
- *
- * ```
- * Sentry.metrics.distribution('batch.size', 100, {
- *   attributes: {
- *     processor: 'batch-1',
- *     type: 'async'
- *   }
- * });
- * ```
- */
 function distribution(name, value, options) {
-  captureMetric('distribution', name, value, options);
+  captureMetric("distribution", name, value, options);
 }
 
 exports.count = count;

package/build/cjs/metrics/public-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-api.js","sources":["../../../src/metrics/public-api.ts"],"sourcesContent":["import type { Scope } from '../scope';\nimport type { Metric, MetricType } from '../types-hoist/metric';\nimport { _INTERNAL_captureMetric } from './internal';\n\n/**\n * Options for capturing a metric.\n */\nexport interface MetricOptions {\n  /**\n   * The unit of the metric value.\n   */\n  unit?: string;\n\n  /**\n   * Arbitrary structured data that stores information about the metric.\n   */\n  attributes?: Metric['attributes'];\n\n  /**\n   * The scope to capture the metric with.\n   */\n  scope?: Scope;\n}\n\n/**\n * Capture a metric with the given type, name, and value.\n *\n * @param type - The type of the metric.\n * @param name - The name of the metric.\n * @param value - The value of the metric.\n * @param options - Options for capturing the metric.\n */\nfunction captureMetric(type: MetricType, name: string, value: number, options?: MetricOptions): void {\n  _INTERNAL_captureMetric(\n    { type, name, value, unit: options?.unit, attributes: options?.attributes },\n    { scope: options?.scope },\n  );\n}\n\n/**\n * @summary Increment a counter metric.\n *\n * @param name - The name of the counter metric.\n * @param value - The value to increment by (defaults to 1).\n * @param options - Options for capturing the metric.\n *\n * @example\n *\n * ```\n * Sentry.metrics.count('api.requests', 1, {\n *   attributes: {\n *     endpoint: '/api/users',\n *     method: 'GET',\n *     status: 200\n *   }\n * });\n * ```\n *\n * @example With custom value\n *\n * ```\n * Sentry.metrics.count('items.processed', 5, {\n *   attributes: {\n *     processor: 'batch-processor',\n *     queue: 'high-priority'\n *   }\n * });\n * ```\n */\nexport function count(name: string, value: number = 1, options?: MetricOptions): void {\n  captureMetric('counter', name, value, options);\n}\n\n/**\n * @summary Set a gauge metric to a specific value.\n *\n * @param name - The name of the gauge metric.\n * @param value - The current value of the gauge.\n * @param options - Options for capturing the metric.\n *\n * @example\n *\n * ```\n * Sentry.metrics.gauge('memory.usage', 1024, {\n *   unit: 'megabyte',\n *   attributes: {\n *     process: 'web-server',\n *     region: 'us-east-1'\n *   }\n * });\n * ```\n *\n * @example Without unit\n *\n * ```\n * Sentry.metrics.gauge('active.connections', 42, {\n *   attributes: {\n *     server: 'api-1',\n *     protocol: 'websocket'\n *   }\n * });\n * ```\n */\nexport function gauge(name: string, value: number, options?: MetricOptions): void {\n  captureMetric('gauge', name, value, options);\n}\n\n/**\n * @summary Record a value in a distribution metric.\n *\n * @param name - The name of the distribution metric.\n * @param value - The value to record in the distribution.\n * @param options - Options for capturing the metric.\n *\n * @example\n *\n * ```\n * Sentry.metrics.distribution('task.duration', 500, {\n *   unit: 'millisecond',\n *   attributes: {\n *     task: 'data-processing',\n *     priority: 'high'\n *   }\n * });\n * ```\n *\n * @example Without unit\n *\n * ```\n * Sentry.metrics.distribution('batch.size', 100, {\n *   attributes: {\n *     processor: 'batch-1',\n *     type: 'async'\n *   }\n * });\n * ```\n */\nexport function distribution(name: string, value: number, options?: MetricOptions): void {\n  captureMetric('distribution', name, value, options);\n}\n"],"names":["_INTERNAL_captureMetric"],"mappings":";;;;AAIA;AACA;AACA;;AAkBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,aAAa,CAAC,IAAI,EAAc,IAAI,EAAU,KAAK,EAAU,OAAO,EAAwB;AACrG,EAAEA,gCAAuB;AACzB,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY;AAC/E,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO;AAC7B,GAAG;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,KAAK,CAAC,IAAI,EAAU,KAAK,GAAW,CAAC,EAAE,OAAO,EAAwB;AACtF,EAAE,aAAa,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC;AAChD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,KAAK,CAAC,IAAI,EAAU,KAAK,EAAU,OAAO,EAAwB;AAClF,EAAE,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC;AAC9C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,YAAY,CAAC,IAAI,EAAU,KAAK,EAAU,OAAO,EAAwB;AACzF,EAAE,aAAa,CAAC,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC;AACrD;;;;;;"}
+{"version":3,"file":"public-api.js","sources":["../../../src/metrics/public-api.ts"],"sourcesContent":["import type { Scope } from '../scope';\nimport type { Metric, MetricType } from '../types/metric';\nimport { _INTERNAL_captureMetric } from './internal';\n\n/**\n * Options for capturing a metric.\n */\nexport interface MetricOptions {\n  /**\n   * The unit of the metric value.\n   */\n  unit?: string;\n\n  /**\n   * Arbitrary structured data that stores information about the metric.\n   */\n  attributes?: Metric['attributes'];\n\n  /**\n   * The scope to capture the metric with.\n   */\n  scope?: Scope;\n}\n\n/**\n * Capture a metric with the given type, name, and value.\n *\n * @param type - The type of the metric.\n * @param name - The name of the metric.\n * @param value - The value of the metric.\n * @param options - Options for capturing the metric.\n */\nfunction captureMetric(type: MetricType, name: string, value: number, options?: MetricOptions): void {\n  _INTERNAL_captureMetric(\n    { type, name, value, unit: options?.unit, attributes: options?.attributes },\n    { scope: options?.scope },\n  );\n}\n\n/**\n * @summary Increment a counter metric.\n *\n * @param name - The name of the counter metric.\n * @param value - The value to increment by (defaults to 1).\n * @param options - Options for capturing the metric.\n *\n * @example\n *\n * ```\n * Sentry.metrics.count('api.requests', 1, {\n *   attributes: {\n *     endpoint: '/api/users',\n *     method: 'GET',\n *     status: 200\n *   }\n * });\n * ```\n *\n * @example With custom value\n *\n * ```\n * Sentry.metrics.count('items.processed', 5, {\n *   attributes: {\n *     processor: 'batch-processor',\n *     queue: 'high-priority'\n *   }\n * });\n * ```\n */\nexport function count(name: string, value: number = 1, options?: MetricOptions): void {\n  captureMetric('counter', name, value, options);\n}\n\n/**\n * @summary Set a gauge metric to a specific value.\n *\n * @param name - The name of the gauge metric.\n * @param value - The current value of the gauge.\n * @param options - Options for capturing the metric.\n *\n * @example\n *\n * ```\n * Sentry.metrics.gauge('memory.usage', 1024, {\n *   unit: 'megabyte',\n *   attributes: {\n *     process: 'web-server',\n *     region: 'us-east-1'\n *   }\n * });\n * ```\n *\n * @example Without unit\n *\n * ```\n * Sentry.metrics.gauge('active.connections', 42, {\n *   attributes: {\n *     server: 'api-1',\n *     protocol: 'websocket'\n *   }\n * });\n * ```\n */\nexport function gauge(name: string, value: number, options?: MetricOptions): void {\n  captureMetric('gauge', name, value, options);\n}\n\n/**\n * @summary Record a value in a distribution metric.\n *\n * @param name - The name of the distribution metric.\n * @param value - The value to record in the distribution.\n * @param options - Options for capturing the metric.\n *\n * @example\n *\n * ```\n * Sentry.metrics.distribution('task.duration', 500, {\n *   unit: 'millisecond',\n *   attributes: {\n *     task: 'data-processing',\n *     priority: 'high'\n *   }\n * });\n * ```\n *\n * @example Without unit\n *\n * ```\n * Sentry.metrics.distribution('batch.size', 100, {\n *   attributes: {\n *     processor: 'batch-1',\n *     type: 'async'\n *   }\n * });\n * ```\n */\nexport function distribution(name: string, value: number, options?: MetricOptions): void {\n  captureMetric('distribution', name, value, options);\n}\n"],"names":["_INTERNAL_captureMetric"],"mappings":";;;;AAgCA,SAAS,aAAA,CAAc,IAAA,EAAkB,IAAA,EAAc,KAAA,EAAe,OAAA,EAA+B;AACnG,EAAAA,gCAAA;AAAA,IACE,EAAE,MAAM,IAAA,EAAM,KAAA,EAAO,MAAM,OAAA,EAAS,IAAA,EAAM,UAAA,EAAY,OAAA,EAAS,UAAA,EAAW;AAAA,IAC1E,EAAE,KAAA,EAAO,OAAA,EAAS,KAAA;AAAM,GAC1B;AACF;AAgCO,SAAS,KAAA,CAAM,IAAA,EAAc,KAAA,GAAgB,CAAA,EAAG,OAAA,EAA+B;AACpF,EAAA,aAAA,CAAc,SAAA,EAAW,IAAA,EAAM,KAAA,EAAO,OAAO,CAAA;AAC/C;AAgCO,SAAS,KAAA,CAAM,IAAA,EAAc,KAAA,EAAe,OAAA,EAA+B;AAChF,EAAA,aAAA,CAAc,OAAA,EAAS,IAAA,EAAM,KAAA,EAAO,OAAO,CAAA;AAC7C;AAgCO,SAAS,YAAA,CAAa,IAAA,EAAc,KAAA,EAAe,OAAA,EAA+B;AACvF,EAAA,aAAA,CAAc,cAAA,EAAgB,IAAA,EAAM,KAAA,EAAO,OAAO,CAAA;AACpD;;;;;;"}