@sentry/core 10.37.0 → 10.39.0-alpha.0

package/build/cjs/semanticAttributes.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
  *
  */
 const SEMANTIC_ATTRIBUTE_SENTRY_SOURCE = 'sentry.source';
+const SEMANTIC_ATTRIBUTE_SENTRY_SPAN_SOURCE = 'sentry.span.source';
 
 /**
  * Attributes that holds the sample rate that was locally applied to a span.
@@ -66,7 +67,9 @@ const SEMANTIC_ATTRIBUTE_CACHE_ITEM_SIZE = 'cache.item_size';
 
 /** TODO: Remove these once we update to latest semantic conventions */
 const SEMANTIC_ATTRIBUTE_HTTP_REQUEST_METHOD = 'http.request.method';
+const SEMANTIC_ATTRIBUTE_HTTP_REQUEST_TIME_TO_FIRST_BYTE = 'http.request.time_to_first_byte';
 const SEMANTIC_ATTRIBUTE_URL_FULL = 'url.full';
+const SEMANTIC_ATTRIBUTE_URL_QUERY = 'url.query';
 
 /**
  * A span link attribute to mark the link as a special span link.
@@ -95,22 +98,103 @@ const SEMANTIC_LINK_ATTRIBUTE_LINK_TYPE = 'sentry.link.type';
  */
 const GEN_AI_CONVERSATION_ID_ATTRIBUTE = 'gen_ai.conversation.id';
 
+// some attributes for span streaming, put onto every v2 span:
+// @see https://develop.sentry.dev/sdk/telemetry/spans/span-protocol/#common-attribute-keys
+
+/** The release version of the application */
+const SEMANTIC_ATTRIBUTE_SENTRY_RELEASE = 'sentry.release';
+/** The environment name (e.g., "production", "staging", "development") */
+const SEMANTIC_ATTRIBUTE_SENTRY_ENVIRONMENT = 'sentry.environment';
+/** The segment name (e.g., "GET /users") */
+const SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_NAME = 'sentry.segment.name';
+/** The id of the segment that this span belongs to. */
+const SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_ID = 'sentry.segment.id';
+/** The user ID (gated by sendDefaultPii) */
+const SEMANTIC_ATTRIBUTE_USER_ID = 'user.id';
+/** The user email (gated by sendDefaultPii) */
+const SEMANTIC_ATTRIBUTE_USER_EMAIL = 'user.email';
+/** The user IP address (gated by sendDefaultPii) */
+const SEMANTIC_ATTRIBUTE_USER_IP_ADDRESS = 'user.ip_address';
+/** The user username (gated by sendDefaultPii) */
+const SEMANTIC_ATTRIBUTE_USER_USERNAME = 'user.name';
+/** The name of the Sentry SDK (e.g., "sentry.php", "sentry.javascript") */
+const SEMANTIC_ATTRIBUTE_SENTRY_SDK_NAME = 'sentry.sdk.name';
+/** The version of the Sentry SDK */
+const SEMANTIC_ATTRIBUTE_SENTRY_SDK_VERSION = 'sentry.sdk.version';
+
+// Web vital attributes
+
+// LCP
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_VALUE = 'browser.web_vital.lcp.value';
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_ELEMENT = 'browser.web_vital.lcp.element';
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_ID = 'browser.web_vital.lcp.id';
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_URL = 'browser.web_vital.lcp.url';
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_LOAD_TIME = 'browser.web_vital.lcp.load_time';
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_RENDER_TIME = 'browser.web_vital.lcp.render_time';
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_SIZE = 'browser.web_vital.lcp.size';
+
+// CLS
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_CLS_VALUE = 'browser.web_vital.cls.value';
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_CLS_SOURCES = 'browser.web_vital.cls.source';
+
+// INP
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_INP_VALUE = 'browser.web_vital.inp.value';
+
+// TTFB
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_TTFB_VALUE = 'browser.web_vital.ttfb.value';
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_TTFB_REQUEST_TIME = 'browser.web_vital.ttfb.request_time';
+
+// FP/FCP
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_FP_VALUE = 'browser.web_vital.fp.value';
+const SEMANTIC_ATTRIBUTE_WEB_VITAL_FCP_VALUE = 'browser.web_vital.fcp.value';
+
+// Browser connection information
+const SEMANTIC_ATTRIBUTE_BROWSER_CONNECTION_RTT = 'browser.connection.rtt';
+
 exports.GEN_AI_CONVERSATION_ID_ATTRIBUTE = GEN_AI_CONVERSATION_ID_ATTRIBUTE;
+exports.SEMANTIC_ATTRIBUTE_BROWSER_CONNECTION_RTT = SEMANTIC_ATTRIBUTE_BROWSER_CONNECTION_RTT;
 exports.SEMANTIC_ATTRIBUTE_CACHE_HIT = SEMANTIC_ATTRIBUTE_CACHE_HIT;
 exports.SEMANTIC_ATTRIBUTE_CACHE_ITEM_SIZE = SEMANTIC_ATTRIBUTE_CACHE_ITEM_SIZE;
 exports.SEMANTIC_ATTRIBUTE_CACHE_KEY = SEMANTIC_ATTRIBUTE_CACHE_KEY;
 exports.SEMANTIC_ATTRIBUTE_EXCLUSIVE_TIME = SEMANTIC_ATTRIBUTE_EXCLUSIVE_TIME;
 exports.SEMANTIC_ATTRIBUTE_HTTP_REQUEST_METHOD = SEMANTIC_ATTRIBUTE_HTTP_REQUEST_METHOD;
+exports.SEMANTIC_ATTRIBUTE_HTTP_REQUEST_TIME_TO_FIRST_BYTE = SEMANTIC_ATTRIBUTE_HTTP_REQUEST_TIME_TO_FIRST_BYTE;
 exports.SEMANTIC_ATTRIBUTE_PROFILE_ID = SEMANTIC_ATTRIBUTE_PROFILE_ID;
 exports.SEMANTIC_ATTRIBUTE_SENTRY_CUSTOM_SPAN_NAME = SEMANTIC_ATTRIBUTE_SENTRY_CUSTOM_SPAN_NAME;
+exports.SEMANTIC_ATTRIBUTE_SENTRY_ENVIRONMENT = SEMANTIC_ATTRIBUTE_SENTRY_ENVIRONMENT;
 exports.SEMANTIC_ATTRIBUTE_SENTRY_IDLE_SPAN_FINISH_REASON = SEMANTIC_ATTRIBUTE_SENTRY_IDLE_SPAN_FINISH_REASON;
 exports.SEMANTIC_ATTRIBUTE_SENTRY_MEASUREMENT_UNIT = SEMANTIC_ATTRIBUTE_SENTRY_MEASUREMENT_UNIT;
 exports.SEMANTIC_ATTRIBUTE_SENTRY_MEASUREMENT_VALUE = SEMANTIC_ATTRIBUTE_SENTRY_MEASUREMENT_VALUE;
 exports.SEMANTIC_ATTRIBUTE_SENTRY_OP = SEMANTIC_ATTRIBUTE_SENTRY_OP;
 exports.SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN = SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN;
 exports.SEMANTIC_ATTRIBUTE_SENTRY_PREVIOUS_TRACE_SAMPLE_RATE = SEMANTIC_ATTRIBUTE_SENTRY_PREVIOUS_TRACE_SAMPLE_RATE;
+exports.SEMANTIC_ATTRIBUTE_SENTRY_RELEASE = SEMANTIC_ATTRIBUTE_SENTRY_RELEASE;
 exports.SEMANTIC_ATTRIBUTE_SENTRY_SAMPLE_RATE = SEMANTIC_ATTRIBUTE_SENTRY_SAMPLE_RATE;
+exports.SEMANTIC_ATTRIBUTE_SENTRY_SDK_NAME = SEMANTIC_ATTRIBUTE_SENTRY_SDK_NAME;
+exports.SEMANTIC_ATTRIBUTE_SENTRY_SDK_VERSION = SEMANTIC_ATTRIBUTE_SENTRY_SDK_VERSION;
+exports.SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_ID = SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_ID;
+exports.SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_NAME = SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_NAME;
 exports.SEMANTIC_ATTRIBUTE_SENTRY_SOURCE = SEMANTIC_ATTRIBUTE_SENTRY_SOURCE;
+exports.SEMANTIC_ATTRIBUTE_SENTRY_SPAN_SOURCE = SEMANTIC_ATTRIBUTE_SENTRY_SPAN_SOURCE;
 exports.SEMANTIC_ATTRIBUTE_URL_FULL = SEMANTIC_ATTRIBUTE_URL_FULL;
+exports.SEMANTIC_ATTRIBUTE_URL_QUERY = SEMANTIC_ATTRIBUTE_URL_QUERY;
+exports.SEMANTIC_ATTRIBUTE_USER_EMAIL = SEMANTIC_ATTRIBUTE_USER_EMAIL;
+exports.SEMANTIC_ATTRIBUTE_USER_ID = SEMANTIC_ATTRIBUTE_USER_ID;
+exports.SEMANTIC_ATTRIBUTE_USER_IP_ADDRESS = SEMANTIC_ATTRIBUTE_USER_IP_ADDRESS;
+exports.SEMANTIC_ATTRIBUTE_USER_USERNAME = SEMANTIC_ATTRIBUTE_USER_USERNAME;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_CLS_SOURCES = SEMANTIC_ATTRIBUTE_WEB_VITAL_CLS_SOURCES;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_CLS_VALUE = SEMANTIC_ATTRIBUTE_WEB_VITAL_CLS_VALUE;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_FCP_VALUE = SEMANTIC_ATTRIBUTE_WEB_VITAL_FCP_VALUE;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_FP_VALUE = SEMANTIC_ATTRIBUTE_WEB_VITAL_FP_VALUE;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_INP_VALUE = SEMANTIC_ATTRIBUTE_WEB_VITAL_INP_VALUE;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_ELEMENT = SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_ELEMENT;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_ID = SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_ID;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_LOAD_TIME = SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_LOAD_TIME;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_RENDER_TIME = SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_RENDER_TIME;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_SIZE = SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_SIZE;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_URL = SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_URL;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_VALUE = SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_VALUE;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_TTFB_REQUEST_TIME = SEMANTIC_ATTRIBUTE_WEB_VITAL_TTFB_REQUEST_TIME;
+exports.SEMANTIC_ATTRIBUTE_WEB_VITAL_TTFB_VALUE = SEMANTIC_ATTRIBUTE_WEB_VITAL_TTFB_VALUE;
 exports.SEMANTIC_LINK_ATTRIBUTE_LINK_TYPE = SEMANTIC_LINK_ATTRIBUTE_LINK_TYPE;
 //# sourceMappingURL=semanticAttributes.js.map

package/build/cjs/semanticAttributes.js.map

@@ -1 +1 @@
-{"version":3,"file":"semanticAttributes.js","sources":["../../src/semanticAttributes.ts"],"sourcesContent":["/**\n * Use this attribute to represent the source of a span.\n * Should be one of: custom, url, route, view, component, task, unknown\n *\n */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_SOURCE = 'sentry.source';\n\n/**\n * Attributes that holds the sample rate that was locally applied to a span.\n * If this attribute is not defined, it means that the span inherited a sampling decision.\n *\n * NOTE: Is only defined on root spans.\n */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_SAMPLE_RATE = 'sentry.sample_rate';\n\n/**\n * Attribute holding the sample rate of the previous trace.\n * This is used to sample consistently across subsequent traces in the browser SDK.\n *\n * Note: Only defined on root spans, if opted into consistent sampling\n */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_PREVIOUS_TRACE_SAMPLE_RATE = 'sentry.previous_trace_sample_rate';\n\n/**\n * Use this attribute to represent the operation of a span.\n */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_OP = 'sentry.op';\n\n/**\n * Use this attribute to represent the origin of a span.\n */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN = 'sentry.origin';\n\n/** The reason why an idle span finished. */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_IDLE_SPAN_FINISH_REASON = 'sentry.idle_span_finish_reason';\n\n/** The unit of a measurement, which may be stored as a TimedEvent. */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_MEASUREMENT_UNIT = 'sentry.measurement_unit';\n\n/** The value of a measurement, which may be stored as a TimedEvent. */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_MEASUREMENT_VALUE = 'sentry.measurement_value';\n\n/**\n * A custom span name set by users guaranteed to be taken over any automatically\n * inferred name. This attribute is removed before the span is sent.\n *\n * @internal only meant for internal SDK usage\n * @hidden\n */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_CUSTOM_SPAN_NAME = 'sentry.custom_span_name';\n\n/**\n * The id of the profile that this span occurred in.\n */\nexport const SEMANTIC_ATTRIBUTE_PROFILE_ID = 'sentry.profile_id';\n\nexport const SEMANTIC_ATTRIBUTE_EXCLUSIVE_TIME = 'sentry.exclusive_time';\n\nexport const SEMANTIC_ATTRIBUTE_CACHE_HIT = 'cache.hit';\n\nexport const SEMANTIC_ATTRIBUTE_CACHE_KEY = 'cache.key';\n\nexport const SEMANTIC_ATTRIBUTE_CACHE_ITEM_SIZE = 'cache.item_size';\n\n/** TODO: Remove these once we update to latest semantic conventions */\nexport const SEMANTIC_ATTRIBUTE_HTTP_REQUEST_METHOD = 'http.request.method';\nexport const SEMANTIC_ATTRIBUTE_URL_FULL = 'url.full';\n\n/**\n * A span link attribute to mark the link as a special span link.\n *\n * Known values:\n * - `previous_trace`: The span links to the frontend root span of the previous trace.\n * - `next_trace`: The span links to the frontend root span of the next trace. (Not set by the SDK)\n *\n * Other values may be set as appropriate.\n * @see https://develop.sentry.dev/sdk/telemetry/traces/span-links/#link-types\n */\nexport const SEMANTIC_LINK_ATTRIBUTE_LINK_TYPE = 'sentry.link.type';\n\n/**\n * =============================================================================\n * GEN AI ATTRIBUTES\n * Based on OpenTelemetry Semantic Conventions for Generative AI\n * @see https://opentelemetry.io/docs/specs/semconv/gen-ai/\n * =============================================================================\n */\n\n/**\n * The conversation ID for linking messages across API calls.\n * For OpenAI Assistants API: thread_id\n * For LangGraph: configurable.thread_id\n */\nexport const GEN_AI_CONVERSATION_ID_ATTRIBUTE = 'gen_ai.conversation.id';\n"],"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACO,MAAM,gCAAA,GAAmC;;AAEhD;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,qCAAA,GAAwC;;AAErD;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,oDAAA,GAAuD;;AAEpE;AACA;AACA;AACO,MAAM,4BAAA,GAA+B;;AAE5C;AACA;AACA;AACO,MAAM,gCAAA,GAAmC;;AAEhD;AACO,MAAM,iDAAA,GAAoD;;AAEjE;AACO,MAAM,0CAAA,GAA6C;;AAE1D;AACO,MAAM,2CAAA,GAA8C;;AAE3D;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,0CAAA,GAA6C;;AAE1D;AACA;AACA;AACO,MAAM,6BAAA,GAAgC;;AAEtC,MAAM,iCAAA,GAAoC;;AAE1C,MAAM,4BAAA,GAA+B;;AAErC,MAAM,4BAAA,GAA+B;;AAErC,MAAM,kCAAA,GAAqC;;AAElD;AACO,MAAM,sCAAA,GAAyC;AAC/C,MAAM,2BAAA,GAA8B;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,iCAAA,GAAoC;;AAEjD;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAM,gCAAA,GAAmC;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"semanticAttributes.js","sources":["../../src/semanticAttributes.ts"],"sourcesContent":["/**\n * Use this attribute to represent the source of a span.\n * Should be one of: custom, url, route, view, component, task, unknown\n *\n */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_SOURCE = 'sentry.source';\nexport const SEMANTIC_ATTRIBUTE_SENTRY_SPAN_SOURCE = 'sentry.span.source';\n\n/**\n * Attributes that holds the sample rate that was locally applied to a span.\n * If this attribute is not defined, it means that the span inherited a sampling decision.\n *\n * NOTE: Is only defined on root spans.\n */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_SAMPLE_RATE = 'sentry.sample_rate';\n\n/**\n * Attribute holding the sample rate of the previous trace.\n * This is used to sample consistently across subsequent traces in the browser SDK.\n *\n * Note: Only defined on root spans, if opted into consistent sampling\n */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_PREVIOUS_TRACE_SAMPLE_RATE = 'sentry.previous_trace_sample_rate';\n\n/**\n * Use this attribute to represent the operation of a span.\n */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_OP = 'sentry.op';\n\n/**\n * Use this attribute to represent the origin of a span.\n */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_ORIGIN = 'sentry.origin';\n\n/** The reason why an idle span finished. */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_IDLE_SPAN_FINISH_REASON = 'sentry.idle_span_finish_reason';\n\n/** The unit of a measurement, which may be stored as a TimedEvent. */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_MEASUREMENT_UNIT = 'sentry.measurement_unit';\n\n/** The value of a measurement, which may be stored as a TimedEvent. */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_MEASUREMENT_VALUE = 'sentry.measurement_value';\n\n/**\n * A custom span name set by users guaranteed to be taken over any automatically\n * inferred name. This attribute is removed before the span is sent.\n *\n * @internal only meant for internal SDK usage\n * @hidden\n */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_CUSTOM_SPAN_NAME = 'sentry.custom_span_name';\n\n/**\n * The id of the profile that this span occurred in.\n */\nexport const SEMANTIC_ATTRIBUTE_PROFILE_ID = 'sentry.profile_id';\n\nexport const SEMANTIC_ATTRIBUTE_EXCLUSIVE_TIME = 'sentry.exclusive_time';\n\nexport const SEMANTIC_ATTRIBUTE_CACHE_HIT = 'cache.hit';\n\nexport const SEMANTIC_ATTRIBUTE_CACHE_KEY = 'cache.key';\n\nexport const SEMANTIC_ATTRIBUTE_CACHE_ITEM_SIZE = 'cache.item_size';\n\n/** TODO: Remove these once we update to latest semantic conventions */\nexport const SEMANTIC_ATTRIBUTE_HTTP_REQUEST_METHOD = 'http.request.method';\nexport const SEMANTIC_ATTRIBUTE_HTTP_REQUEST_TIME_TO_FIRST_BYTE = 'http.request.time_to_first_byte';\nexport const SEMANTIC_ATTRIBUTE_URL_FULL = 'url.full';\nexport const SEMANTIC_ATTRIBUTE_URL_QUERY = 'url.query';\n\n/**\n * A span link attribute to mark the link as a special span link.\n *\n * Known values:\n * - `previous_trace`: The span links to the frontend root span of the previous trace.\n * - `next_trace`: The span links to the frontend root span of the next trace. (Not set by the SDK)\n *\n * Other values may be set as appropriate.\n * @see https://develop.sentry.dev/sdk/telemetry/traces/span-links/#link-types\n */\nexport const SEMANTIC_LINK_ATTRIBUTE_LINK_TYPE = 'sentry.link.type';\n\n/**\n * =============================================================================\n * GEN AI ATTRIBUTES\n * Based on OpenTelemetry Semantic Conventions for Generative AI\n * @see https://opentelemetry.io/docs/specs/semconv/gen-ai/\n * =============================================================================\n */\n\n/**\n * The conversation ID for linking messages across API calls.\n * For OpenAI Assistants API: thread_id\n * For LangGraph: configurable.thread_id\n */\nexport const GEN_AI_CONVERSATION_ID_ATTRIBUTE = 'gen_ai.conversation.id';\n\n// some attributes for span streaming, put onto every v2 span:\n// @see https://develop.sentry.dev/sdk/telemetry/spans/span-protocol/#common-attribute-keys\n\n/** The release version of the application */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_RELEASE = 'sentry.release';\n/** The environment name (e.g., \"production\", \"staging\", \"development\") */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_ENVIRONMENT = 'sentry.environment';\n/** The segment name (e.g., \"GET /users\") */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_NAME = 'sentry.segment.name';\n/** The id of the segment that this span belongs to. */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_ID = 'sentry.segment.id';\n/** The user ID (gated by sendDefaultPii) */\nexport const SEMANTIC_ATTRIBUTE_USER_ID = 'user.id';\n/** The user email (gated by sendDefaultPii) */\nexport const SEMANTIC_ATTRIBUTE_USER_EMAIL = 'user.email';\n/** The user IP address (gated by sendDefaultPii) */\nexport const SEMANTIC_ATTRIBUTE_USER_IP_ADDRESS = 'user.ip_address';\n/** The user username (gated by sendDefaultPii) */\nexport const SEMANTIC_ATTRIBUTE_USER_USERNAME = 'user.name';\n/** The name of the Sentry SDK (e.g., \"sentry.php\", \"sentry.javascript\") */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_SDK_NAME = 'sentry.sdk.name';\n/** The version of the Sentry SDK */\nexport const SEMANTIC_ATTRIBUTE_SENTRY_SDK_VERSION = 'sentry.sdk.version';\n\n// Web vital attributes\n\n// LCP\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_VALUE = 'browser.web_vital.lcp.value';\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_ELEMENT = 'browser.web_vital.lcp.element';\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_ID = 'browser.web_vital.lcp.id';\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_URL = 'browser.web_vital.lcp.url';\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_LOAD_TIME = 'browser.web_vital.lcp.load_time';\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_RENDER_TIME = 'browser.web_vital.lcp.render_time';\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_LCP_SIZE = 'browser.web_vital.lcp.size';\n\n// CLS\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_CLS_VALUE = 'browser.web_vital.cls.value';\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_CLS_SOURCES = 'browser.web_vital.cls.source';\n\n// INP\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_INP_VALUE = 'browser.web_vital.inp.value';\n\n// TTFB\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_TTFB_VALUE = 'browser.web_vital.ttfb.value';\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_TTFB_REQUEST_TIME = 'browser.web_vital.ttfb.request_time';\n\n// FP/FCP\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_FP_VALUE = 'browser.web_vital.fp.value';\nexport const SEMANTIC_ATTRIBUTE_WEB_VITAL_FCP_VALUE = 'browser.web_vital.fcp.value';\n\n// Browser connection information\nexport const SEMANTIC_ATTRIBUTE_BROWSER_CONNECTION_RTT = 'browser.connection.rtt';\n"],"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACO,MAAM,gCAAA,GAAmC;AACzC,MAAM,qCAAA,GAAwC;;AAErD;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,qCAAA,GAAwC;;AAErD;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,oDAAA,GAAuD;;AAEpE;AACA;AACA;AACO,MAAM,4BAAA,GAA+B;;AAE5C;AACA;AACA;AACO,MAAM,gCAAA,GAAmC;;AAEhD;AACO,MAAM,iDAAA,GAAoD;;AAEjE;AACO,MAAM,0CAAA,GAA6C;;AAE1D;AACO,MAAM,2CAAA,GAA8C;;AAE3D;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,0CAAA,GAA6C;;AAE1D;AACA;AACA;AACO,MAAM,6BAAA,GAAgC;;AAEtC,MAAM,iCAAA,GAAoC;;AAE1C,MAAM,4BAAA,GAA+B;;AAErC,MAAM,4BAAA,GAA+B;;AAErC,MAAM,kCAAA,GAAqC;;AAElD;AACO,MAAM,sCAAA,GAAyC;AAC/C,MAAM,kDAAA,GAAqD;AAC3D,MAAM,2BAAA,GAA8B;AACpC,MAAM,4BAAA,GAA+B;;AAE5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAM,iCAAA,GAAoC;;AAEjD;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACO,MAAM,gCAAA,GAAmC;;AAEhD;AACA;;AAEA;AACO,MAAM,iCAAA,GAAoC;AACjD;AACO,MAAM,qCAAA,GAAwC;AACrD;AACO,MAAM,sCAAA,GAAyC;AACtD;AACO,MAAM,oCAAA,GAAuC;AACpD;AACO,MAAM,0BAAA,GAA6B;AAC1C;AACO,MAAM,6BAAA,GAAgC;AAC7C;AACO,MAAM,kCAAA,GAAqC;AAClD;AACO,MAAM,gCAAA,GAAmC;AAChD;AACO,MAAM,kCAAA,GAAqC;AAClD;AACO,MAAM,qCAAA,GAAwC;;AAErD;;AAEA;AACO,MAAM,sCAAA,GAAyC;AAC/C,MAAM,wCAAA,GAA2C;AACjD,MAAM,mCAAA,GAAsC;AAC5C,MAAM,oCAAA,GAAuC;AAC7C,MAAM,0CAAA,GAA6C;AACnD,MAAM,4CAAA,GAA+C;AACrD,MAAM,qCAAA,GAAwC;;AAErD;AACO,MAAM,sCAAA,GAAyC;AAC/C,MAAM,wCAAA,GAA2C;;AAExD;AACO,MAAM,sCAAA,GAAyC;;AAEtD;AACO,MAAM,uCAAA,GAA0C;AAChD,MAAM,8CAAA,GAAiD;;AAE9D;AACO,MAAM,qCAAA,GAAwC;AAC9C,MAAM,sCAAA,GAAyC;;AAEtD;AACO,MAAM,yCAAA,GAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/build/cjs/spans/captureSpan.js

@@ -0,0 +1,104 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const currentScopes = require('../currentScopes.js');
+const debugBuild = require('../debug-build.js');
+const semanticAttributes = require('../semanticAttributes.js');
+const utils = require('../tracing/utils.js');
+const beforeSendSpan = require('../utils/beforeSendSpan.js');
+const debugLogger = require('../utils/debug-logger.js');
+const scopeData = require('../utils/scopeData.js');
+const spanUtils = require('../utils/spanUtils.js');
+const spanFirstUtils = require('./spanFirstUtils.js');
+
+/**
+ * Captures a span and returns a JSON representation to be enqueued for sending.
+ *
+ * IMPORTANT: This function converts the span to JSON immediately to avoid writing
+ * to an already-ended OTel span instance (which is blocked by the OTel Span class).
+ */
+function captureSpan(span, client = currentScopes.getClient()) {
+  if (!client) {
+    debugBuild.DEBUG_BUILD && debugLogger.debug.warn('No client available to capture span.');
+    return;
+  }
+
+  // Convert to JSON FIRST - we cannot write to an already-ended span
+  const spanJSON = spanUtils.spanToV2JSON(span);
+
+  const segmentSpan = spanUtils.INTERNAL_getSegmentSpan(span);
+  const serializedSegmentSpan = spanUtils.spanToV2JSON(segmentSpan);
+
+  const { isolationScope: spanIsolationScope, scope: spanScope } = utils.getCapturedScopesOnSpan(span);
+
+  const finalScopeData = scopeData.getCombinedScopeData(spanIsolationScope, spanScope);
+
+  applyCommonSpanAttributes(spanJSON, serializedSegmentSpan, client, finalScopeData);
+
+  if (span === segmentSpan) {
+    applyScopeToSegmentSpan(spanJSON, finalScopeData);
+    client.emit('processSegmentSpan', spanJSON, { scopeData: finalScopeData });
+  }
+
+  // Allow integrations to add additional data to the span JSON
+  client.emit('processSpan', spanJSON, { readOnlySpan: span });
+
+  const beforeSendSpan$1 = client.getOptions().beforeSendSpan;
+  const processedSpan = beforeSendSpan.isV2BeforeSendSpanCallback(beforeSendSpan$1)
+    ? spanFirstUtils.applyBeforeSendSpanCallback(spanJSON, beforeSendSpan$1)
+    : spanJSON;
+
+  // Backfill sentry.span.source from sentry.source for the PoC
+  // TODO(v11): Stop sending `sentry.source` attribute and only send `sentry.span.source`
+  // probably easiest done by just renaming SEMANTIC_ATTRIBUTE_SENTRY_SOURCE
+  if (processedSpan.attributes?.[semanticAttributes.SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]) {
+    spanFirstUtils.safeSetSpanJSONAttributes(processedSpan, {
+      [semanticAttributes.SEMANTIC_ATTRIBUTE_SENTRY_SPAN_SOURCE]: processedSpan.attributes?.[semanticAttributes.SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]?.value,
+    });
+  }
+
+  const spanWithRef = {
+    ...processedSpan,
+    _segmentSpan: segmentSpan,
+  };
+
+  client.emit('enqueueSpan', spanWithRef);
+}
+
+function applyScopeToSegmentSpan(segmentSpanJSON, scopeData) {
+  // TODO: Apply all scope and request data from auto instrumentation (contexts, request) to segment span
+  const { contexts } = scopeData;
+
+  spanFirstUtils.safeSetSpanJSONAttributes(segmentSpanJSON, spanFirstUtils.contextsToAttributes(contexts));
+}
+
+function applyCommonSpanAttributes(
+  spanJSON,
+  serializedSegmentSpan,
+  client,
+  scopeData,
+) {
+  const sdk = client.getSdkMetadata();
+  const { release, environment, sendDefaultPii } = client.getOptions();
+
+  // avoid overwriting any previously set attributes (from users or potentially our SDK instrumentation)
+  spanFirstUtils.safeSetSpanJSONAttributes(spanJSON, {
+    [semanticAttributes.SEMANTIC_ATTRIBUTE_SENTRY_RELEASE]: release,
+    [semanticAttributes.SEMANTIC_ATTRIBUTE_SENTRY_ENVIRONMENT]: environment,
+    [semanticAttributes.SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_NAME]: serializedSegmentSpan.name,
+    [semanticAttributes.SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_ID]: serializedSegmentSpan.span_id,
+    [semanticAttributes.SEMANTIC_ATTRIBUTE_SENTRY_SDK_NAME]: sdk?.sdk?.name,
+    [semanticAttributes.SEMANTIC_ATTRIBUTE_SENTRY_SDK_VERSION]: sdk?.sdk?.version,
+    ...(sendDefaultPii
+      ? {
+          [semanticAttributes.SEMANTIC_ATTRIBUTE_USER_ID]: scopeData.user?.id,
+          [semanticAttributes.SEMANTIC_ATTRIBUTE_USER_EMAIL]: scopeData.user?.email,
+          [semanticAttributes.SEMANTIC_ATTRIBUTE_USER_IP_ADDRESS]: scopeData.user?.ip_address,
+          [semanticAttributes.SEMANTIC_ATTRIBUTE_USER_USERNAME]: scopeData.user?.username,
+        }
+      : {}),
+    ...scopeData.attributes,
+  });
+}
+
+exports.captureSpan = captureSpan;
+//# sourceMappingURL=captureSpan.js.map

package/build/cjs/spans/captureSpan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureSpan.js","sources":["../../../src/spans/captureSpan.ts"],"sourcesContent":["import type { Client } from '../client';\nimport { getClient } from '../currentScopes';\nimport { DEBUG_BUILD } from '../debug-build';\nimport type { ScopeData } from '../scope';\nimport {\n  SEMANTIC_ATTRIBUTE_SENTRY_ENVIRONMENT,\n  SEMANTIC_ATTRIBUTE_SENTRY_RELEASE,\n  SEMANTIC_ATTRIBUTE_SENTRY_SDK_NAME,\n  SEMANTIC_ATTRIBUTE_SENTRY_SDK_VERSION,\n  SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_ID,\n  SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_NAME,\n  SEMANTIC_ATTRIBUTE_SENTRY_SOURCE,\n  SEMANTIC_ATTRIBUTE_SENTRY_SPAN_SOURCE,\n  SEMANTIC_ATTRIBUTE_USER_EMAIL,\n  SEMANTIC_ATTRIBUTE_USER_ID,\n  SEMANTIC_ATTRIBUTE_USER_IP_ADDRESS,\n  SEMANTIC_ATTRIBUTE_USER_USERNAME,\n} from '../semanticAttributes';\nimport { getCapturedScopesOnSpan } from '../tracing/utils';\nimport type { Span, SpanV2JSON } from '../types-hoist/span';\nimport { isV2BeforeSendSpanCallback } from '../utils/beforeSendSpan';\nimport { debug } from '../utils/debug-logger';\nimport { getCombinedScopeData } from '../utils/scopeData';\nimport { INTERNAL_getSegmentSpan, spanToV2JSON } from '../utils/spanUtils';\nimport { applyBeforeSendSpanCallback, contextsToAttributes, safeSetSpanJSONAttributes } from './spanFirstUtils';\n/**\n * Captures a span and returns a JSON representation to be enqueued for sending.\n *\n * IMPORTANT: This function converts the span to JSON immediately to avoid writing\n * to an already-ended OTel span instance (which is blocked by the OTel Span class).\n */\nexport function captureSpan(span: Span, client = getClient()): void {\n  if (!client) {\n    DEBUG_BUILD && debug.warn('No client available to capture span.');\n    return;\n  }\n\n  // Convert to JSON FIRST - we cannot write to an already-ended span\n  const spanJSON = spanToV2JSON(span);\n\n  const segmentSpan = INTERNAL_getSegmentSpan(span);\n  const serializedSegmentSpan = spanToV2JSON(segmentSpan);\n\n  const { isolationScope: spanIsolationScope, scope: spanScope } = getCapturedScopesOnSpan(span);\n\n  const finalScopeData = getCombinedScopeData(spanIsolationScope, spanScope);\n\n  applyCommonSpanAttributes(spanJSON, serializedSegmentSpan, client, finalScopeData);\n\n  if (span === segmentSpan) {\n    applyScopeToSegmentSpan(spanJSON, finalScopeData);\n    client.emit('processSegmentSpan', spanJSON, { scopeData: finalScopeData });\n  }\n\n  // Allow integrations to add additional data to the span JSON\n  client.emit('processSpan', spanJSON, { readOnlySpan: span });\n\n  const beforeSendSpan = client.getOptions().beforeSendSpan;\n  const processedSpan = isV2BeforeSendSpanCallback(beforeSendSpan)\n    ? applyBeforeSendSpanCallback(spanJSON, beforeSendSpan)\n    : spanJSON;\n\n  // Backfill sentry.span.source from sentry.source for the PoC\n  // TODO(v11): Stop sending `sentry.source` attribute and only send `sentry.span.source`\n  // probably easiest done by just renaming SEMANTIC_ATTRIBUTE_SENTRY_SOURCE\n  if (processedSpan.attributes?.[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]) {\n    safeSetSpanJSONAttributes(processedSpan, {\n      [SEMANTIC_ATTRIBUTE_SENTRY_SPAN_SOURCE]: processedSpan.attributes?.[SEMANTIC_ATTRIBUTE_SENTRY_SOURCE]?.value,\n    });\n  }\n\n  const spanWithRef = {\n    ...processedSpan,\n    _segmentSpan: segmentSpan,\n  };\n\n  client.emit('enqueueSpan', spanWithRef);\n}\n\nfunction applyScopeToSegmentSpan(segmentSpanJSON: SpanV2JSON, scopeData: ScopeData): void {\n  // TODO: Apply all scope and request data from auto instrumentation (contexts, request) to segment span\n  const { contexts } = scopeData;\n\n  safeSetSpanJSONAttributes(segmentSpanJSON, contextsToAttributes(contexts));\n}\n\nfunction applyCommonSpanAttributes(\n  spanJSON: SpanV2JSON,\n  serializedSegmentSpan: SpanV2JSON,\n  client: Client,\n  scopeData: ScopeData,\n): void {\n  const sdk = client.getSdkMetadata();\n  const { release, environment, sendDefaultPii } = client.getOptions();\n\n  // avoid overwriting any previously set attributes (from users or potentially our SDK instrumentation)\n  safeSetSpanJSONAttributes(spanJSON, {\n    [SEMANTIC_ATTRIBUTE_SENTRY_RELEASE]: release,\n    [SEMANTIC_ATTRIBUTE_SENTRY_ENVIRONMENT]: environment,\n    [SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_NAME]: serializedSegmentSpan.name,\n    [SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_ID]: serializedSegmentSpan.span_id,\n    [SEMANTIC_ATTRIBUTE_SENTRY_SDK_NAME]: sdk?.sdk?.name,\n    [SEMANTIC_ATTRIBUTE_SENTRY_SDK_VERSION]: sdk?.sdk?.version,\n    ...(sendDefaultPii\n      ? {\n          [SEMANTIC_ATTRIBUTE_USER_ID]: scopeData.user?.id,\n          [SEMANTIC_ATTRIBUTE_USER_EMAIL]: scopeData.user?.email,\n          [SEMANTIC_ATTRIBUTE_USER_IP_ADDRESS]: scopeData.user?.ip_address,\n          [SEMANTIC_ATTRIBUTE_USER_USERNAME]: scopeData.user?.username,\n        }\n      : {}),\n    ...scopeData.attributes,\n  });\n}\n"],"names":["getClient","DEBUG_BUILD","debug","spanToV2JSON","INTERNAL_getSegmentSpan","getCapturedScopesOnSpan","getCombinedScopeData","beforeSendSpan","isV2BeforeSendSpanCallback","applyBeforeSendSpanCallback","SEMANTIC_ATTRIBUTE_SENTRY_SOURCE","safeSetSpanJSONAttributes","SEMANTIC_ATTRIBUTE_SENTRY_SPAN_SOURCE","contextsToAttributes","SEMANTIC_ATTRIBUTE_SENTRY_RELEASE","SEMANTIC_ATTRIBUTE_SENTRY_ENVIRONMENT","SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_NAME","SEMANTIC_ATTRIBUTE_SENTRY_SEGMENT_ID","SEMANTIC_ATTRIBUTE_SENTRY_SDK_NAME","SEMANTIC_ATTRIBUTE_SENTRY_SDK_VERSION","SEMANTIC_ATTRIBUTE_USER_ID","SEMANTIC_ATTRIBUTE_USER_EMAIL","SEMANTIC_ATTRIBUTE_USER_IP_ADDRESS","SEMANTIC_ATTRIBUTE_USER_USERNAME"],"mappings":"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"}

package/build/cjs/spans/spanBuffer.js

@@ -0,0 +1,121 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const debugBuild = require('../debug-build.js');
+const envelope = require('../envelope.js');
+const dynamicSamplingContext = require('../tracing/dynamicSamplingContext.js');
+const debugLogger = require('../utils/debug-logger.js');
+
+/**
+ * A buffer for span JSON objects that flushes them to Sentry in Span v2 envelopes.
+ * Handles interval-based flushing, size thresholds, and graceful shutdown.
+ */
+class SpanBuffer {
+
+   constructor(client, options) {
+    this._spanTreeMap = new Map();
+    this._client = client;
+
+    const { maxSpanLimit, flushInterval } = options ?? {};
+
+    this._maxSpanLimit = maxSpanLimit && maxSpanLimit > 0 && maxSpanLimit <= 1000 ? maxSpanLimit : 1000;
+    this._flushInterval = flushInterval && flushInterval > 0 ? flushInterval : 5000;
+
+    this._flushIntervalId = setInterval(() => {
+      this.flush();
+    }, this._flushInterval);
+
+    this._client.on('flush', () => {
+      this.flush();
+    });
+  }
+
+  /**
+   * Add a span to the buffer.
+   */
+   addSpan(spanJSON) {
+    const traceId = spanJSON.trace_id;
+    let traceBucket = this._spanTreeMap.get(traceId);
+    if (traceBucket) {
+      traceBucket.add(spanJSON);
+    } else {
+      traceBucket = new Set([spanJSON]);
+      this._spanTreeMap.set(traceId, traceBucket);
+    }
+
+    if (traceBucket.size >= this._maxSpanLimit) {
+      this.flushTrace(traceId);
+      this._debounceFlushInterval();
+    }
+  }
+
+  /**
+   * Flush all buffered traces.
+   */
+   flush() {
+    if (!this._spanTreeMap.size) {
+      return;
+    }
+
+    debugBuild.DEBUG_BUILD && debugLogger.debug.log(`Flushing span tree map with ${this._spanTreeMap.size} traces`);
+
+    this._spanTreeMap.forEach((_, traceId) => {
+      this.flushTrace(traceId);
+    });
+    this._debounceFlushInterval();
+  }
+
+  /**
+   * Flush spans of a specific trace.
+   * In contrast to {@link SpanBuffer.flush}, this method does not flush all traces, but only the one with the given traceId.
+   */
+   flushTrace(traceId) {
+    const traceBucket = this._spanTreeMap.get(traceId);
+    if (!traceBucket) {
+      return;
+    }
+
+    if (!traceBucket.size) {
+      this._spanTreeMap.delete(traceId);
+      return;
+    }
+
+    const firstSpanJSON = traceBucket.values().next().value;
+
+    const segmentSpan = firstSpanJSON?._segmentSpan;
+    if (!segmentSpan) {
+      debugBuild.DEBUG_BUILD && debugLogger.debug.warn('No segment span reference found on span JSON, cannot compute DSC');
+      this._spanTreeMap.delete(traceId);
+      return;
+    }
+
+    const dsc = dynamicSamplingContext.getDynamicSamplingContextFromSpan(segmentSpan);
+
+    const cleanedSpans = Array.from(traceBucket).map(spanJSON => {
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      const { _segmentSpan, ...cleanSpanJSON } = spanJSON;
+      return cleanSpanJSON;
+    });
+
+    const envelope$1 = envelope.createSpanV2Envelope(cleanedSpans, dsc, this._client);
+
+    debugBuild.DEBUG_BUILD && debugLogger.debug.log(`Sending span envelope for trace ${traceId} with ${cleanedSpans.length} spans`);
+
+    this._client.sendEnvelope(envelope$1).then(null, reason => {
+      debugBuild.DEBUG_BUILD && debugLogger.debug.error('Error while sending span stream envelope:', reason);
+    });
+
+    this._spanTreeMap.delete(traceId);
+  }
+
+   _debounceFlushInterval() {
+    if (this._flushIntervalId) {
+      clearInterval(this._flushIntervalId);
+    }
+    this._flushIntervalId = setInterval(() => {
+      this.flush();
+    }, this._flushInterval);
+  }
+}
+
+exports.SpanBuffer = SpanBuffer;
+//# sourceMappingURL=spanBuffer.js.map

package/build/cjs/spans/spanBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanBuffer.js","sources":["../../../src/spans/spanBuffer.ts"],"sourcesContent":["import type { Client } from '../client';\nimport { DEBUG_BUILD } from '../debug-build';\nimport { createSpanV2Envelope } from '../envelope';\nimport { getDynamicSamplingContextFromSpan } from '../tracing/dynamicSamplingContext';\nimport type { SpanV2JSON, SpanV2JSONWithSegmentRef } from '../types-hoist/span';\nimport { debug } from '../utils/debug-logger';\n\nexport interface SpanBufferOptions {\n  /** Max spans per trace before auto-flush (default: 1000) */\n  maxSpanLimit?: number;\n  /** Flush interval in ms (default: 5000) */\n  flushInterval?: number;\n}\n\n/**\n * A buffer for span JSON objects that flushes them to Sentry in Span v2 envelopes.\n * Handles interval-based flushing, size thresholds, and graceful shutdown.\n */\nexport class SpanBuffer {\n  private _spanTreeMap: Map<string, Set<SpanV2JSONWithSegmentRef>>;\n  private _flushIntervalId: ReturnType<typeof setInterval> | null;\n  private _client: Client;\n  private _maxSpanLimit: number;\n  private _flushInterval: number;\n\n  public constructor(client: Client, options?: SpanBufferOptions) {\n    this._spanTreeMap = new Map();\n    this._client = client;\n\n    const { maxSpanLimit, flushInterval } = options ?? {};\n\n    this._maxSpanLimit = maxSpanLimit && maxSpanLimit > 0 && maxSpanLimit <= 1000 ? maxSpanLimit : 1000;\n    this._flushInterval = flushInterval && flushInterval > 0 ? flushInterval : 5_000;\n\n    this._flushIntervalId = setInterval(() => {\n      this.flush();\n    }, this._flushInterval);\n\n    this._client.on('flush', () => {\n      this.flush();\n    });\n  }\n\n  /**\n   * Add a span to the buffer.\n   */\n  public addSpan(spanJSON: SpanV2JSONWithSegmentRef): void {\n    const traceId = spanJSON.trace_id;\n    let traceBucket = this._spanTreeMap.get(traceId);\n    if (traceBucket) {\n      traceBucket.add(spanJSON);\n    } else {\n      traceBucket = new Set([spanJSON]);\n      this._spanTreeMap.set(traceId, traceBucket);\n    }\n\n    if (traceBucket.size >= this._maxSpanLimit) {\n      this.flushTrace(traceId);\n      this._debounceFlushInterval();\n    }\n  }\n\n  /**\n   * Flush all buffered traces.\n   */\n  public flush(): void {\n    if (!this._spanTreeMap.size) {\n      return;\n    }\n\n    DEBUG_BUILD && debug.log(`Flushing span tree map with ${this._spanTreeMap.size} traces`);\n\n    this._spanTreeMap.forEach((_, traceId) => {\n      this.flushTrace(traceId);\n    });\n    this._debounceFlushInterval();\n  }\n\n  /**\n   * Flush spans of a specific trace.\n   * In contrast to {@link SpanBuffer.flush}, this method does not flush all traces, but only the one with the given traceId.\n   */\n  public flushTrace(traceId: string): void {\n    const traceBucket = this._spanTreeMap.get(traceId);\n    if (!traceBucket) {\n      return;\n    }\n\n    if (!traceBucket.size) {\n      this._spanTreeMap.delete(traceId);\n      return;\n    }\n\n    const firstSpanJSON = traceBucket.values().next().value;\n\n    const segmentSpan = firstSpanJSON?._segmentSpan;\n    if (!segmentSpan) {\n      DEBUG_BUILD && debug.warn('No segment span reference found on span JSON, cannot compute DSC');\n      this._spanTreeMap.delete(traceId);\n      return;\n    }\n\n    const dsc = getDynamicSamplingContextFromSpan(segmentSpan);\n\n    const cleanedSpans: SpanV2JSON[] = Array.from(traceBucket).map(spanJSON => {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { _segmentSpan, ...cleanSpanJSON } = spanJSON;\n      return cleanSpanJSON;\n    });\n\n    const envelope = createSpanV2Envelope(cleanedSpans, dsc, this._client);\n\n    DEBUG_BUILD && debug.log(`Sending span envelope for trace ${traceId} with ${cleanedSpans.length} spans`);\n\n    this._client.sendEnvelope(envelope).then(null, reason => {\n      DEBUG_BUILD && debug.error('Error while sending span stream envelope:', reason);\n    });\n\n    this._spanTreeMap.delete(traceId);\n  }\n\n  private _debounceFlushInterval(): void {\n    if (this._flushIntervalId) {\n      clearInterval(this._flushIntervalId);\n    }\n    this._flushIntervalId = setInterval(() => {\n      this.flush();\n    }, this._flushInterval);\n  }\n}\n"],"names":["DEBUG_BUILD","debug","getDynamicSamplingContextFromSpan","envelope","createSpanV2Envelope"],"mappings":"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"}

package/build/cjs/spans/spanFirstUtils.js

@@ -0,0 +1,186 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const attributes = require('../attributes.js');
+const is = require('../utils/is.js');
+const spanUtils = require('../utils/spanUtils.js');
+
+/**
+ * Only set a span JSON attribute if it is not already set.
+ * This is used to safely set attributes on JSON objects without mutating already-ended span instances.
+ */
+function safeSetSpanJSONAttributes(
+  spanJSON,
+  newAttributes,
+) {
+  if (!spanJSON.attributes) {
+    spanJSON.attributes = {};
+  }
+
+  const originalAttributes = spanJSON.attributes;
+
+  Object.keys(newAttributes).forEach(key => {
+    if (!originalAttributes?.[key]) {
+      setAttributeOnSpanJSONWithMaybeUnit(
+        // type-casting here because we ensured above that the attributes object exists
+        spanJSON ,
+        key,
+        newAttributes[key],
+      );
+    }
+  });
+}
+
+/**
+ * Apply a user-provided beforeSendSpan callback to a span JSON.
+ */
+function applyBeforeSendSpanCallback(
+  span,
+  beforeSendSpan,
+) {
+  const modifedSpan = beforeSendSpan(span);
+  if (!modifedSpan) {
+    spanUtils.showSpanDropWarning();
+    return span;
+  }
+  return modifedSpan;
+}
+
+function setAttributeOnSpanJSONWithMaybeUnit(
+  spanJSON,
+  attributeKey,
+  attributeValue,
+) {
+  const { value, unit } = attributes.isAttributeObject(attributeValue)
+    ? attributeValue
+    : { value: attributeValue, unit: undefined };
+  const typedAttributeValue = attributes.attributeValueToTypedAttributeValue(value);
+
+  if (typedAttributeValue && isSupportedSerializableType(value)) {
+    spanJSON.attributes[attributeKey] = typedAttributeValue;
+    if (unit) {
+      spanJSON.attributes[attributeKey].unit = unit;
+    }
+  }
+}
+
+function isSupportedSerializableType(value) {
+  return ['string', 'number', 'boolean'].includes(typeof value) || Array.isArray(value);
+}
+
+// map of attributes->context keys for those attributes that don't correspond 1:1 to the context key
+const explicitAttributeToContextMapping = {
+  'os.build_id': 'os.build',
+  'app.name': 'app.app_name',
+  'app.identifier': 'app.app_identifier',
+  'app.version': 'app.app_version',
+  'app.memory': 'app.app_memory',
+  'app.start_time': 'app.app_start_time',
+};
+
+const knownContexts = [
+  // set by `nodeContextIntegration`
+  'app',
+  'os',
+  'device',
+  'culture',
+  'cloud_resource',
+  'runtime',
+
+  // TODO: These need more thorough checking if they're all setting expected attributes
+
+  // set by the `instrumentPostgresJs`
+  'postgresjsConnection',
+  // set by `ensureIsWrapped`
+  'missing_instrumentation',
+  // set by `nodeProfilingIntegration`
+  'profile',
+  // set by angular `init`
+  'angular',
+  // set by AWS Lambda SDK
+  'aws.lambda',
+  'aws.cloudwatch.logs',
+  // set by `instrumentBunServe`
+  'response',
+  // set by `trpcMiddleware`
+  'trpc',
+  // set by `instrumentSupabaseClient`
+  'supabase',
+  // set by `gcp.function.context`
+  'gcp.function.context',
+  // set by nextjs SDK
+  'nextjs',
+  // set by react SDK `captureReactException`, `init`
+  'react',
+  // set by react SDK `createReduxEnhancer`
+  'state',
+  // set by `replayIntegration`
+  'Replays',
+  // Other information:
+  // - no need to handler feature flags `flags` context because it's already added to the active span
+];
+
+/**
+ * Converts a context object to a set of attributes.
+ * Only includes attributes that are primitives (for now).
+ * @param contexts - The context object to convert.
+ * @returns The attributes object.
+ */
+function contextsToAttributes(contexts) {
+  function contextToAttribute(context) {
+    return Object.keys(context).reduce(
+      (acc, key) => {
+        if (!is.isPrimitive(context[key])) {
+          return acc;
+        }
+        acc[key] = context[key];
+        return acc;
+      },
+      {} ,
+    );
+  }
+
+  const contextsWithPrimitiveValues = Object.keys(contexts).reduce((acc, key) => {
+    if (!knownContexts.includes(key)) {
+      return acc;
+    }
+    const context = contexts[key];
+    if (context) {
+      acc[key] = contextToAttribute(context);
+    }
+    return acc;
+  }, {} );
+
+  const explicitlyMappedAttributes = Object.entries(explicitAttributeToContextMapping).reduce(
+    (acc, [attributeKey, contextKey]) => {
+      const [contextName, contextValueKey] = contextKey.split('.');
+      if (contextName && contextValueKey && contextsWithPrimitiveValues[contextName]?.[contextValueKey]) {
+        acc[attributeKey] = contextsWithPrimitiveValues[contextName]?.[contextValueKey];
+        // now we delete this key from `contextsWithPrimitiveValues` so we don't include it in the next step
+        delete contextsWithPrimitiveValues[contextName]?.[contextValueKey];
+      }
+      return acc;
+    },
+    {} ,
+  );
+
+  return {
+    ...explicitlyMappedAttributes,
+    ...Object.entries(contextsWithPrimitiveValues).reduce(
+      (acc, [contextName, contextObj]) => {
+        contextObj &&
+          Object.entries(contextObj).forEach(([key, value]) => {
+            if (value) {
+              acc[`${contextName}.${key}`] = value;
+            }
+          });
+        return acc;
+      },
+      {} ,
+    ),
+  };
+}
+
+exports.applyBeforeSendSpanCallback = applyBeforeSendSpanCallback;
+exports.contextsToAttributes = contextsToAttributes;
+exports.safeSetSpanJSONAttributes = safeSetSpanJSONAttributes;
+//# sourceMappingURL=spanFirstUtils.js.map

package/build/cjs/spans/spanFirstUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanFirstUtils.js","sources":["../../../src/spans/spanFirstUtils.ts"],"sourcesContent":["import type { RawAttributes } from '../attributes';\nimport { attributeValueToTypedAttributeValue, isAttributeObject } from '../attributes';\nimport type { Context, Contexts } from '../types-hoist/context';\nimport type { SpanV2JSON } from '../types-hoist/span';\nimport { isPrimitive } from '../utils/is';\nimport { showSpanDropWarning } from '../utils/spanUtils';\n\n/**\n * Only set a span JSON attribute if it is not already set.\n * This is used to safely set attributes on JSON objects without mutating already-ended span instances.\n */\nexport function safeSetSpanJSONAttributes(\n  spanJSON: SpanV2JSON,\n  newAttributes: RawAttributes<Record<string, unknown>>,\n): void {\n  if (!spanJSON.attributes) {\n    spanJSON.attributes = {};\n  }\n\n  const originalAttributes = spanJSON.attributes;\n\n  Object.keys(newAttributes).forEach(key => {\n    if (!originalAttributes?.[key]) {\n      setAttributeOnSpanJSONWithMaybeUnit(\n        // type-casting here because we ensured above that the attributes object exists\n        spanJSON as SpanV2JSON & Required<Pick<SpanV2JSON, 'attributes'>>,\n        key,\n        newAttributes[key],\n      );\n    }\n  });\n}\n\n/**\n * Apply a user-provided beforeSendSpan callback to a span JSON.\n */\nexport function applyBeforeSendSpanCallback(\n  span: SpanV2JSON,\n  beforeSendSpan: (span: SpanV2JSON) => SpanV2JSON,\n): SpanV2JSON {\n  const modifedSpan = beforeSendSpan(span);\n  if (!modifedSpan) {\n    showSpanDropWarning();\n    return span;\n  }\n  return modifedSpan;\n}\n\nfunction setAttributeOnSpanJSONWithMaybeUnit(\n  spanJSON: SpanV2JSON & Required<Pick<SpanV2JSON, 'attributes'>>,\n  attributeKey: string,\n  attributeValue: unknown,\n): void {\n  const { value, unit } = isAttributeObject(attributeValue)\n    ? attributeValue\n    : { value: attributeValue, unit: undefined };\n  const typedAttributeValue = attributeValueToTypedAttributeValue(value);\n\n  if (typedAttributeValue && isSupportedSerializableType(value)) {\n    spanJSON.attributes[attributeKey] = typedAttributeValue;\n    if (unit) {\n      spanJSON.attributes[attributeKey].unit = unit;\n    }\n  }\n}\n\nfunction isSupportedSerializableType(value: unknown): boolean {\n  return ['string', 'number', 'boolean'].includes(typeof value) || Array.isArray(value);\n}\n\n// map of attributes->context keys for those attributes that don't correspond 1:1 to the context key\nconst explicitAttributeToContextMapping = {\n  'os.build_id': 'os.build',\n  'app.name': 'app.app_name',\n  'app.identifier': 'app.app_identifier',\n  'app.version': 'app.app_version',\n  'app.memory': 'app.app_memory',\n  'app.start_time': 'app.app_start_time',\n};\n\nconst knownContexts = [\n  // set by `nodeContextIntegration`\n  'app',\n  'os',\n  'device',\n  'culture',\n  'cloud_resource',\n  'runtime',\n\n  // TODO: These need more thorough checking if they're all setting expected attributes\n\n  // set by the `instrumentPostgresJs`\n  'postgresjsConnection',\n  // set by `ensureIsWrapped`\n  'missing_instrumentation',\n  // set by `nodeProfilingIntegration`\n  'profile',\n  // set by angular `init`\n  'angular',\n  // set by AWS Lambda SDK\n  'aws.lambda',\n  'aws.cloudwatch.logs',\n  // set by `instrumentBunServe`\n  'response',\n  // set by `trpcMiddleware`\n  'trpc',\n  // set by `instrumentSupabaseClient`\n  'supabase',\n  // set by `gcp.function.context`\n  'gcp.function.context',\n  // set by nextjs SDK\n  'nextjs',\n  // set by react SDK `captureReactException`, `init`\n  'react',\n  // set by react SDK `createReduxEnhancer`\n  'state',\n  // set by `replayIntegration`\n  'Replays',\n  // Other information:\n  // - no need to handler feature flags `flags` context because it's already added to the active span\n];\n\n/**\n * Converts a context object to a set of attributes.\n * Only includes attributes that are primitives (for now).\n * @param contexts - The context object to convert.\n * @returns The attributes object.\n */\nexport function contextsToAttributes(contexts: Contexts): RawAttributes<Record<string, unknown>> {\n  function contextToAttribute(context: Context): Context {\n    return Object.keys(context).reduce(\n      (acc, key) => {\n        if (!isPrimitive(context[key])) {\n          return acc;\n        }\n        acc[key] = context[key];\n        return acc;\n      },\n      {} as Record<string, unknown>,\n    );\n  }\n\n  const contextsWithPrimitiveValues = Object.keys(contexts).reduce((acc, key) => {\n    if (!knownContexts.includes(key)) {\n      return acc;\n    }\n    const context = contexts[key];\n    if (context) {\n      acc[key] = contextToAttribute(context);\n    }\n    return acc;\n  }, {} as Contexts);\n\n  const explicitlyMappedAttributes = Object.entries(explicitAttributeToContextMapping).reduce(\n    (acc, [attributeKey, contextKey]) => {\n      const [contextName, contextValueKey] = contextKey.split('.');\n      if (contextName && contextValueKey && contextsWithPrimitiveValues[contextName]?.[contextValueKey]) {\n        acc[attributeKey] = contextsWithPrimitiveValues[contextName]?.[contextValueKey];\n        // now we delete this key from `contextsWithPrimitiveValues` so we don't include it in the next step\n        delete contextsWithPrimitiveValues[contextName]?.[contextValueKey];\n      }\n      return acc;\n    },\n    {} as Record<string, unknown>,\n  );\n\n  return {\n    ...explicitlyMappedAttributes,\n    ...Object.entries(contextsWithPrimitiveValues).reduce(\n      (acc, [contextName, contextObj]) => {\n        contextObj &&\n          Object.entries(contextObj).forEach(([key, value]) => {\n            if (value) {\n              acc[`${contextName}.${key}`] = value;\n            }\n          });\n        return acc;\n      },\n      {} as Record<string, unknown>,\n    ),\n  };\n}\n"],"names":["showSpanDropWarning","isAttributeObject","attributeValueToTypedAttributeValue","isPrimitive"],"mappings":"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"}

package/build/cjs/tracing/ai/gen-ai-attributes.js

@@ -231,6 +231,11 @@ const GEN_AI_EMBED_DO_EMBED_OPERATION_ATTRIBUTE = 'gen_ai.embed';
  */
 const GEN_AI_EMBED_MANY_DO_EMBED_OPERATION_ATTRIBUTE = 'gen_ai.embed_many';
 
+/**
+ * The span operation name for reranking
+ */
+const GEN_AI_RERANK_DO_RERANK_OPERATION_ATTRIBUTE = 'gen_ai.rerank';
+
 /**
  * The span operation name for executing a tool
  */
@@ -338,6 +343,7 @@ exports.GEN_AI_REQUEST_STREAM_ATTRIBUTE = GEN_AI_REQUEST_STREAM_ATTRIBUTE;
 exports.GEN_AI_REQUEST_TEMPERATURE_ATTRIBUTE = GEN_AI_REQUEST_TEMPERATURE_ATTRIBUTE;
 exports.GEN_AI_REQUEST_TOP_K_ATTRIBUTE = GEN_AI_REQUEST_TOP_K_ATTRIBUTE;
 exports.GEN_AI_REQUEST_TOP_P_ATTRIBUTE = GEN_AI_REQUEST_TOP_P_ATTRIBUTE;
+exports.GEN_AI_RERANK_DO_RERANK_OPERATION_ATTRIBUTE = GEN_AI_RERANK_DO_RERANK_OPERATION_ATTRIBUTE;
 exports.GEN_AI_RESPONSE_FINISH_REASONS_ATTRIBUTE = GEN_AI_RESPONSE_FINISH_REASONS_ATTRIBUTE;
 exports.GEN_AI_RESPONSE_ID_ATTRIBUTE = GEN_AI_RESPONSE_ID_ATTRIBUTE;
 exports.GEN_AI_RESPONSE_MODEL_ATTRIBUTE = GEN_AI_RESPONSE_MODEL_ATTRIBUTE;