@respan/respan-sdk 1.1.8 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -13,6 +13,10 @@ export declare enum RespanSpanAttributes {
13
13
  RESPAN_ENVIRONMENT = "respan.environment",
14
14
  RESPAN_LINK_TIMESTAMP = "respan.link.timestamp",
15
15
  RESPAN_PROCESSORS = "respan.processors",
16
+ RESPAN_INTERNAL_SPAN_NAME_KIND = "respan.internal.span_name.kind",
17
+ RESPAN_INTERNAL_SPAN_NAME_DETAIL = "respan.internal.span_name.detail",
18
+ RESPAN_INTERNAL_DROP_SPAN = "respan.internal.drop_span",
19
+ RESPAN_INTERNAL_EXPORT_PARENT = "respan.internal.export_parent_span_id",
16
20
  RESPAN_LOG_METHOD = "respan.entity.log_method",
17
21
  RESPAN_LOG_TYPE = "respan.entity.log_type",
18
22
  RESPAN_LOG_ID = "respan.entity.log_id",
@@ -41,4 +45,5 @@ export declare enum RespanSpanAttributes {
41
45
  export declare const RESPAN_SPAN_ATTRIBUTES_MAP: {
42
46
  [key: string]: string;
43
47
  };
48
+ export type RespanSpanNameStyle = "legacy" | "semantic";
44
49
  export type SpanAttributeValue = string | number | boolean | Array<string | number | boolean>;
@@ -24,6 +24,13 @@ export var RespanSpanAttributes;
24
24
  RespanSpanAttributes["RESPAN_LINK_TIMESTAMP"] = "respan.link.timestamp";
25
25
  // Processor routing (used by decorators to target specific processors)
26
26
  RespanSpanAttributes["RESPAN_PROCESSORS"] = "respan.processors";
27
+ // Internal runtime hints. These are stripped before export.
28
+ RespanSpanAttributes["RESPAN_INTERNAL_SPAN_NAME_KIND"] = "respan.internal.span_name.kind";
29
+ RespanSpanAttributes["RESPAN_INTERNAL_SPAN_NAME_DETAIL"] = "respan.internal.span_name.detail";
30
+ RespanSpanAttributes["RESPAN_INTERNAL_DROP_SPAN"] = "respan.internal.drop_span";
31
+ // Set by instrumentations on children of a drop-marked span so the exporter
32
+ // can reparent them per-span, without cross-span (batch-dependent) state.
33
+ RespanSpanAttributes["RESPAN_INTERNAL_EXPORT_PARENT"] = "respan.internal.export_parent_span_id";
27
34
  // Logging
28
35
  RespanSpanAttributes["RESPAN_LOG_METHOD"] = "respan.entity.log_method";
29
36
  RespanSpanAttributes["RESPAN_LOG_TYPE"] = "respan.entity.log_type";
@@ -1 +1 @@
1
- {"version":3,"file":"spanTypes.js","sourceRoot":"","sources":["../../src/types/spanTypes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,oBAsEX;AAtED,WAAY,oBAAoB;IAC5B,kBAAkB;IAClB,sFAA8D,CAAA;IAE9D,kBAAkB;IAClB,gGAAwE,CAAA;IACxE,qFAA6D,CAAA;IAC7D,mFAA2D,CAAA;IAE3D,oBAAoB;IACpB,sGAA8E,CAAA;IAE9E,UAAU;IACV,8EAAsD,CAAA;IAEtD,WAAW;IACX,gFAAwD,CAAA;IAExD,QAAQ;IACR,qFAA6D,CAAA;IAE7D,WAAW;IACX,2DAAmC,CAAA;IACnC,+DAAuC,CAAA;IAEvC,uBAAuB;IACvB,uDAA+B,CAAA;IAC/B,iEAAyC,CAAA;IAEzC,aAAa;IACb,uEAA+C,CAAA;IAE/C,uEAAuE;IACvE,+DAAuC,CAAA;IAEvC,UAAU;IACV,sEAA8C,CAAA;IAC9C,kEAA0C,CAAA;IAC1C,8DAAsC,CAAA;IACtC,4EAAoD,CAAA;IACpD,wEAAgD,CAAA;IAChD,sEAA8C,CAAA;IAE9C,8CAA8C;IAC9C,iFAAyD,CAAA;IACzD,iFAAyD,CAAA;IACzD,6EAAqD,CAAA;IACrD,yFAAiE,CAAA;IACjE,+EAAuD,CAAA;IACvD,+DAAuC,CAAA;IACvC,yEAAiD,CAAA;IACjD,qEAA6C,CAAA;IAE7C,4EAA4E;IAC5E,2EAAmD,CAAA;IACnD,uEAA+C,CAAA;IAC/C,uFAA+D,CAAA;IAC/D,+FAAuE,CAAA;IAEvE,mCAAmC;IACnC,4DAA4D;IAC5D,8EAA8E;IAC9E,wDAAwD;IACxD,wEAAwE;IACxE,uDAA+B,CAAA;IAC/B,qEAA6C,CAAA;IAC7C,iFAAyD,CAAA;IACzD,yFAAiE,CAAA;IACjE,6DAAqC,CAAA;IACrC,iDAAyB,CAAA;AAC7B,CAAC,EAtEW,oBAAoB,KAApB,oBAAoB,QAsE/B;AAED,MAAM,CAAC,MAAM,0BAA0B,GAA8B;IACjE,mBAAmB,EAAE,oBAAoB,CAAC,yBAAyB;IACnE,cAAc,EAAE,oBAAoB,CAAC,4BAA4B;IACjE,aAAa,EAAE,oBAAoB,CAAC,2BAA2B;IAC/D,qBAAqB,EAAE,oBAAoB,CAAC,2BAA2B;IACvE,iBAAiB,EAAE,oBAAoB,CAAC,iBAAiB;IACzD,kBAAkB,EAAE,oBAAoB,CAAC,iBAAiB;IAC1D,iBAAiB,EAAE,oBAAoB,CAAC,qBAAqB;IAC7D,sBAAsB,EAAE,oBAAoB,CAAC,qBAAqB;IAClE,gBAAgB,EAAE,oBAAoB,CAAC,qBAAqB;IAC5D,QAAQ,EAAE,oBAAoB,CAAC,eAAe;IAC9C,UAAU,EAAE,oBAAoB,CAAC,iBAAiB;IAClD,MAAM,EAAE,oBAAoB,CAAC,aAAa;IAC1C,WAAW,EAAE,oBAAoB,CAAC,kBAAkB;CACvD,CAAC"}
1
+ {"version":3,"file":"spanTypes.js","sourceRoot":"","sources":["../../src/types/spanTypes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,oBA8EX;AA9ED,WAAY,oBAAoB;IAC5B,kBAAkB;IAClB,sFAA8D,CAAA;IAE9D,kBAAkB;IAClB,gGAAwE,CAAA;IACxE,qFAA6D,CAAA;IAC7D,mFAA2D,CAAA;IAE3D,oBAAoB;IACpB,sGAA8E,CAAA;IAE9E,UAAU;IACV,8EAAsD,CAAA;IAEtD,WAAW;IACX,gFAAwD,CAAA;IAExD,QAAQ;IACR,qFAA6D,CAAA;IAE7D,WAAW;IACX,2DAAmC,CAAA;IACnC,+DAAuC,CAAA;IAEvC,uBAAuB;IACvB,uDAA+B,CAAA;IAC/B,iEAAyC,CAAA;IAEzC,aAAa;IACb,uEAA+C,CAAA;IAE/C,uEAAuE;IACvE,+DAAuC,CAAA;IAEvC,4DAA4D;IAC5D,yFAAiE,CAAA;IACjE,6FAAqE,CAAA;IACrE,+EAAuD,CAAA;IACvD,4EAA4E;IAC5E,0EAA0E;IAC1E,+FAAuE,CAAA;IAEvE,UAAU;IACV,sEAA8C,CAAA;IAC9C,kEAA0C,CAAA;IAC1C,8DAAsC,CAAA;IACtC,4EAAoD,CAAA;IACpD,wEAAgD,CAAA;IAChD,sEAA8C,CAAA;IAE9C,8CAA8C;IAC9C,iFAAyD,CAAA;IACzD,iFAAyD,CAAA;IACzD,6EAAqD,CAAA;IACrD,yFAAiE,CAAA;IACjE,+EAAuD,CAAA;IACvD,+DAAuC,CAAA;IACvC,yEAAiD,CAAA;IACjD,qEAA6C,CAAA;IAE7C,4EAA4E;IAC5E,2EAAmD,CAAA;IACnD,uEAA+C,CAAA;IAC/C,uFAA+D,CAAA;IAC/D,+FAAuE,CAAA;IAEvE,mCAAmC;IACnC,4DAA4D;IAC5D,8EAA8E;IAC9E,wDAAwD;IACxD,wEAAwE;IACxE,uDAA+B,CAAA;IAC/B,qEAA6C,CAAA;IAC7C,iFAAyD,CAAA;IACzD,yFAAiE,CAAA;IACjE,6DAAqC,CAAA;IACrC,iDAAyB,CAAA;AAC7B,CAAC,EA9EW,oBAAoB,KAApB,oBAAoB,QA8E/B;AAED,MAAM,CAAC,MAAM,0BAA0B,GAA8B;IACjE,mBAAmB,EAAE,oBAAoB,CAAC,yBAAyB;IACnE,cAAc,EAAE,oBAAoB,CAAC,4BAA4B;IACjE,aAAa,EAAE,oBAAoB,CAAC,2BAA2B;IAC/D,qBAAqB,EAAE,oBAAoB,CAAC,2BAA2B;IACvE,iBAAiB,EAAE,oBAAoB,CAAC,iBAAiB;IACzD,kBAAkB,EAAE,oBAAoB,CAAC,iBAAiB;IAC1D,iBAAiB,EAAE,oBAAoB,CAAC,qBAAqB;IAC7D,sBAAsB,EAAE,oBAAoB,CAAC,qBAAqB;IAClE,gBAAgB,EAAE,oBAAoB,CAAC,qBAAqB;IAC5D,QAAQ,EAAE,oBAAoB,CAAC,eAAe;IAC9C,UAAU,EAAE,oBAAoB,CAAC,iBAAiB;IAClD,MAAM,EAAE,oBAAoB,CAAC,aAAa;IAC1C,WAAW,EAAE,oBAAoB,CAAC,kBAAkB;CACvD,CAAC"}
@@ -1,3 +1,4 @@
1
+ import type { RespanSpanNameStyle } from "./spanTypes.js";
1
2
  export interface TracingDecoratorConfig {
2
3
  name: string;
3
4
  version?: number;
@@ -49,6 +50,13 @@ export interface TracingOptions {
49
50
  * Defaults to true.
50
51
  */
51
52
  tracingEnabled?: boolean;
53
+ /**
54
+ * Controls exported span.name formatting.
55
+ * - semantic: use operation-prefixed names like agent.triage or llm.gpt-4o
56
+ * - legacy: preserve instrumentation span names
57
+ * Defaults to semantic. Can also be set with RESPAN_SPAN_NAME_STYLE=legacy.
58
+ */
59
+ spanNameStyle?: RespanSpanNameStyle;
52
60
  /**
53
61
  * Explicitly specify modules to instrument. Optional.
54
62
  * This allows for manual instrumentation of specific modules.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@respan/respan-sdk",
3
3
  "type": "module",
4
- "version": "1.1.8",
4
+ "version": "1.2.0",
5
5
  "description": "Respan typing SDK",
6
6
  "main": "dist/index.js",
7
7
  "types": "dist/index.d.ts",