@brizz/sdk 0.1.53 → 0.1.55

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.
Files changed (49) hide show
  1. package/README.md +39 -1
  2. package/dist/{chunk-TEY6FAVZ.js → chunk-B5IY6O4N.js} +7 -0
  3. package/dist/{chunk-STTOBCTP.cjs → chunk-CF4CXFQP.cjs} +1 -1
  4. package/dist/chunk-DC2MFO65.cjs +121 -0
  5. package/dist/{chunk-KFETJN5M.cjs → chunk-RD4XCYKT.cjs} +7 -0
  6. package/dist/chunk-TDPQDITP.js +121 -0
  7. package/dist/{chunk-XV3ZJO5K.js → chunk-WJZSFRB4.js} +1 -1
  8. package/dist/{google-genai-T7I4FFIP.js → google-genai-3ERJNC7Q.js} +2 -1
  9. package/dist/google-genai-GVCKSJMR.cjs +11 -0
  10. package/dist/google-genai.cjs +3 -2
  11. package/dist/google-genai.js +2 -1
  12. package/dist/index.cjs +236 -63
  13. package/dist/index.js +217 -44
  14. package/dist/{mcp-KH5LOG5H.cjs → mcp-CYQ3TGCK.cjs} +39 -16
  15. package/dist/{mcp-DBLN5ZBE.js → mcp-LLYYMR5M.js} +29 -6
  16. package/dist/types/cjs/index.d.ts +3 -3
  17. package/dist/types/cjs/internal/config.d.ts +2 -1
  18. package/dist/types/cjs/internal/instrumentation/langchain.d.ts +1 -1
  19. package/dist/types/cjs/internal/instrumentation/openai.d.ts +5 -0
  20. package/dist/types/cjs/internal/instrumentation/vercel-ai/interrupt.d.ts +1 -1
  21. package/dist/types/cjs/internal/log/logging.d.ts +6 -5
  22. package/dist/types/cjs/internal/log/processors/log-processor.d.ts +4 -4
  23. package/dist/types/cjs/internal/metric/metrics.d.ts +1 -0
  24. package/dist/types/cjs/internal/sdk.d.ts +4 -1
  25. package/dist/types/cjs/internal/trace/exporters/eve-trace-exporter.d.ts +1 -1
  26. package/dist/types/cjs/internal/trace/exporters/span-exporter.d.ts +1 -1
  27. package/dist/types/cjs/internal/trace/index.d.ts +1 -0
  28. package/dist/types/cjs/internal/trace/processors/eve-session-processor.d.ts +1 -1
  29. package/dist/types/cjs/internal/trace/processors/span-processor.d.ts +1 -1
  30. package/dist/types/cjs/internal/trace/provider.d.ts +16 -0
  31. package/dist/types/cjs/internal/trace/tracing.d.ts +3 -2
  32. package/dist/types/esm/index.d.ts +3 -3
  33. package/dist/types/esm/internal/config.d.ts +2 -1
  34. package/dist/types/esm/internal/instrumentation/langchain.d.ts +1 -1
  35. package/dist/types/esm/internal/instrumentation/openai.d.ts +5 -0
  36. package/dist/types/esm/internal/instrumentation/vercel-ai/interrupt.d.ts +1 -1
  37. package/dist/types/esm/internal/log/logging.d.ts +6 -5
  38. package/dist/types/esm/internal/log/processors/log-processor.d.ts +4 -4
  39. package/dist/types/esm/internal/metric/metrics.d.ts +1 -0
  40. package/dist/types/esm/internal/sdk.d.ts +4 -1
  41. package/dist/types/esm/internal/trace/exporters/eve-trace-exporter.d.ts +1 -1
  42. package/dist/types/esm/internal/trace/exporters/span-exporter.d.ts +1 -1
  43. package/dist/types/esm/internal/trace/index.d.ts +1 -0
  44. package/dist/types/esm/internal/trace/processors/eve-session-processor.d.ts +1 -1
  45. package/dist/types/esm/internal/trace/processors/span-processor.d.ts +1 -1
  46. package/dist/types/esm/internal/trace/provider.d.ts +16 -0
  47. package/dist/types/esm/internal/trace/tracing.d.ts +3 -2
  48. package/package.json +29 -30
  49. package/dist/google-genai-LMEZ62FB.cjs +0 -10
package/README.md CHANGED
@@ -23,6 +23,8 @@ Traces popular AI libraries including OpenAI, Anthropic, Vercel AI SDK, and more
23
23
  - [Environment Variables](#environment-variables)
24
24
  - [Disable Span Export](#disable-span-export)
25
25
  - [Dropping Spans](#dropping-spans)
26
+ - [Running Alongside Your Own OpenTelemetry Setup](#running-alongside-your-own-opentelemetry-setup)
27
+ - [Serverless (Cloud Run, Lambda)](#serverless-cloud-run-lambda)
26
28
  - [Advanced Configuration](#advanced-configuration)
27
29
  - [Testing & Development](#testing--development)
28
30
  - [Package.json Examples](#packagejson-examples)
@@ -757,6 +759,7 @@ BRIZZ_APP_VERSION=1.0.0 # Application version
757
759
  BRIZZ_ENVIRONMENT=production # Environment (dev, staging, prod)
758
760
  BRIZZ_LOG_LEVEL=info # SDK log level
759
761
  BRIZZ_DISABLE_SPAN_EXPORTER=true # Skip span export (see "Disable Span Export")
762
+ BRIZZ_SET_GLOBAL_TRACER_PROVIDER=false # Keep Brizz spans on their own provider (see below)
760
763
 
761
764
  # OpenTelemetry Standard Variables
762
765
  OTEL_SERVICE_NAME=my-service # Service name
@@ -806,6 +809,41 @@ await llm.invoke([new HumanMessage('Hello')], {
806
809
 
807
810
  Both sync and async filters are supported. Exceptions are caught and the span passes through.
808
811
 
812
+ ## Running Alongside Your Own OpenTelemetry Setup
813
+
814
+ If your app registers its own OpenTelemetry `TracerProvider` (for example, for an APM), pass
815
+ `setGlobalTracerProvider: false`:
816
+
817
+ ```typescript
818
+ Brizz.initialize({ apiKey: 'your-api-key', setGlobalTracerProvider: false });
819
+ ```
820
+
821
+ Brizz keeps its spans on its own provider and sends them to Brizz only. Your provider, propagator
822
+ and sampling stay as they are, and Brizz records every conversation even when your setup does not
823
+ sample the request.
824
+
825
+ Give an instrumentation you construct yourself Brizz's tracer provider:
826
+
827
+ ```typescript
828
+ import { getTracerProvider } from '@brizz/sdk';
829
+
830
+ new LangChainInstrumentation({ tracerProvider: getTracerProvider() });
831
+ ```
832
+
833
+ Or via env var: `BRIZZ_SET_GLOBAL_TRACER_PROVIDER=false`.
834
+
835
+ ## Serverless (Cloud Run, Lambda)
836
+
837
+ Where CPU is throttled once the response is sent, queued telemetry may never leave the instance.
838
+ Await `Brizz.flush()` before responding:
839
+
840
+ ```typescript
841
+ await Brizz.flush();
842
+ res.json(result);
843
+ ```
844
+
845
+ On Cloud Run, enabling "CPU always allocated" works too.
846
+
809
847
  ## Advanced Configuration
810
848
 
811
849
  ```typescript
@@ -840,7 +878,7 @@ Brizz.initialize({
840
878
  For testing and development, you can use in-memory exporters:
841
879
 
842
880
  ```typescript
843
- import { InMemorySpanExporter } from '@opentelemetry/sdk-trace-base';
881
+ import { InMemorySpanExporter } from '@opentelemetry/sdk-trace';
844
882
 
845
883
  const spanExporter = new InMemorySpanExporter();
846
884
 
@@ -1,3 +1,6 @@
1
+ import {
2
+ brizzTracerProvider
3
+ } from "./chunk-TDPQDITP.js";
1
4
  import {
2
5
  logger
3
6
  } from "./chunk-Y4HNUX3Q.js";
@@ -8,6 +11,10 @@ import { GenAIInstrumentation } from "@traceloop/instrumentation-google-generati
8
11
  var MODULE_NAME = "@google/genai";
9
12
  var SUPPORTED_VERSIONS = [">=1.0.0 <3.0.0"];
10
13
  var GoogleGenAIInstrumentation = class extends GenAIInstrumentation {
14
+ constructor(config) {
15
+ super(config);
16
+ this.setTracerProvider(brizzTracerProvider);
17
+ }
11
18
  /**
12
19
  * Replace — not extend — upstream's module definition. Upstream returns a
13
20
  * single definition for `@google/genai`; registering ours alongside it would
@@ -9,7 +9,7 @@ var _chunkRV7JIIDGcjs = require('./chunk-RV7JIIDG.cjs');
9
9
 
10
10
  // src/internal/version.ts
11
11
  function getSDKVersion() {
12
- return "0.1.53";
12
+ return "0.1.55";
13
13
  }
14
14
 
15
15
  // src/internal/instrumentation/mcp/session.ts
@@ -0,0 +1,121 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2;// src/internal/trace/provider.ts
2
+
3
+
4
+
5
+
6
+
7
+
8
+
9
+ var _api = require('@opentelemetry/api');
10
+ var _contextasynchooks = require('@opentelemetry/context-async-hooks');
11
+
12
+
13
+
14
+
15
+ var _core = require('@opentelemetry/core');
16
+ var STATE_KEY = /* @__PURE__ */ Symbol.for("brizz.sdk.tracerProvider");
17
+ function state() {
18
+ const holder = globalThis;
19
+ holder[STATE_KEY] ??= { privateProvider: null };
20
+ return holder[STATE_KEY];
21
+ }
22
+ var LazyTracer = (_class = class {
23
+ constructor(name, version, options) {;_class.prototype.__init.call(this);
24
+ this.name = name;
25
+ this.version = version;
26
+ this.options = options;
27
+ }
28
+
29
+
30
+
31
+ resolve() {
32
+ const provider = _nullishCoalesce(state().privateProvider, () => ( _api.trace.getTracerProvider()));
33
+ return provider.getTracer(this.name, this.version, this.options);
34
+ }
35
+ startSpan(name, options, ctx) {
36
+ return this.resolve().startSpan(name, options, ctx);
37
+ }
38
+ __init() {this.startActiveSpan = ((...args) => {
39
+ const tracer = this.resolve();
40
+ return Reflect.apply(tracer.startActiveSpan, tracer, args);
41
+ })}
42
+ }, _class);
43
+ var BrizzTracerProvider = (_class2 = class {constructor() { _class2.prototype.__init2.call(this); }
44
+ __init2() {this.tracers = /* @__PURE__ */ new Map()}
45
+ getTracer(name, version, options) {
46
+ const key = `${name}@${_nullishCoalesce(version, () => ( ""))}:${_nullishCoalesce(_optionalChain([options, 'optionalAccess', _ => _.schemaUrl]), () => ( ""))}`;
47
+ let tracer = this.tracers.get(key);
48
+ if (!tracer) {
49
+ tracer = new LazyTracer(name, version, options);
50
+ this.tracers.set(key, tracer);
51
+ }
52
+ return tracer;
53
+ }
54
+ }, _class2);
55
+ var brizzTracerProvider = new BrizzTracerProvider();
56
+ function getTracerProvider() {
57
+ return brizzTracerProvider;
58
+ }
59
+ function bindToBrizz(instrumentation) {
60
+ instrumentation.setTracerProvider(brizzTracerProvider);
61
+ return instrumentation;
62
+ }
63
+ function setPrivateTracerProvider(provider) {
64
+ state().privateProvider = provider;
65
+ }
66
+ function isPrivateTracerProvider() {
67
+ return state().privateProvider !== null;
68
+ }
69
+ var PROBE_KEY = _api.createContextKey.call(void 0, "brizz.sdk.contextManagerProbe");
70
+ function contextManagerWorks() {
71
+ return _api.context.with(
72
+ _api.context.active().setValue(PROBE_KEY, true),
73
+ () => _api.context.active().getValue(PROBE_KEY) === true
74
+ );
75
+ }
76
+ function ensureContextManager() {
77
+ if (contextManagerWorks()) {
78
+ return "existing";
79
+ }
80
+ const manager = new (0, _contextasynchooks.AsyncLocalStorageContextManager)().enable();
81
+ if (_api.context.setGlobalContextManager(manager) && contextManagerWorks()) {
82
+ return "installed";
83
+ }
84
+ manager.disable();
85
+ return "failed";
86
+ }
87
+ function registerTracerProvider(provider) {
88
+ _api.trace.setGlobalTracerProvider(provider);
89
+ ensureContextManager();
90
+ _api.propagation.setGlobalPropagator(
91
+ new (0, _core.CompositePropagator)({
92
+ propagators: [new (0, _core.W3CTraceContextPropagator)(), new (0, _core.W3CBaggagePropagator)()]
93
+ })
94
+ );
95
+ }
96
+ var w3cPropagator = new (0, _core.W3CTraceContextPropagator)();
97
+ function injectTraceContext(ctx, carrier) {
98
+ if (isPrivateTracerProvider()) {
99
+ w3cPropagator.inject(ctx, carrier, _api.defaultTextMapSetter);
100
+ } else {
101
+ _api.propagation.inject(ctx, carrier);
102
+ }
103
+ }
104
+ function extractTraceContext(ctx, carrier) {
105
+ if (isPrivateTracerProvider()) {
106
+ return w3cPropagator.extract(ctx, carrier, _api.defaultTextMapGetter);
107
+ }
108
+ return _api.propagation.extract(ctx, carrier);
109
+ }
110
+
111
+
112
+
113
+
114
+
115
+
116
+
117
+
118
+
119
+
120
+
121
+ exports.brizzTracerProvider = brizzTracerProvider; exports.getTracerProvider = getTracerProvider; exports.bindToBrizz = bindToBrizz; exports.setPrivateTracerProvider = setPrivateTracerProvider; exports.isPrivateTracerProvider = isPrivateTracerProvider; exports.ensureContextManager = ensureContextManager; exports.registerTracerProvider = registerTracerProvider; exports.injectTraceContext = injectTraceContext; exports.extractTraceContext = extractTraceContext;
@@ -1,5 +1,8 @@
1
1
  "use strict";Object.defineProperty(exports, "__esModule", {value: true});
2
2
 
3
+ var _chunkDC2MFO65cjs = require('./chunk-DC2MFO65.cjs');
4
+
5
+
3
6
  var _chunkWC573FCIcjs = require('./chunk-WC573FCI.cjs');
4
7
 
5
8
  // src/internal/instrumentation/google-genai.ts
@@ -8,6 +11,10 @@ var _instrumentationgooglegenerativeai = require('@traceloop/instrumentation-goo
8
11
  var MODULE_NAME = "@google/genai";
9
12
  var SUPPORTED_VERSIONS = [">=1.0.0 <3.0.0"];
10
13
  var GoogleGenAIInstrumentation = class extends _instrumentationgooglegenerativeai.GenAIInstrumentation {
14
+ constructor(config) {
15
+ super(config);
16
+ this.setTracerProvider(_chunkDC2MFO65cjs.brizzTracerProvider);
17
+ }
11
18
  /**
12
19
  * Replace — not extend — upstream's module definition. Upstream returns a
13
20
  * single definition for `@google/genai`; registering ours alongside it would
@@ -0,0 +1,121 @@
1
+ // src/internal/trace/provider.ts
2
+ import {
3
+ context,
4
+ createContextKey,
5
+ defaultTextMapGetter,
6
+ defaultTextMapSetter,
7
+ propagation,
8
+ trace
9
+ } from "@opentelemetry/api";
10
+ import { AsyncLocalStorageContextManager } from "@opentelemetry/context-async-hooks";
11
+ import {
12
+ CompositePropagator,
13
+ W3CBaggagePropagator,
14
+ W3CTraceContextPropagator
15
+ } from "@opentelemetry/core";
16
+ var STATE_KEY = /* @__PURE__ */ Symbol.for("brizz.sdk.tracerProvider");
17
+ function state() {
18
+ const holder = globalThis;
19
+ holder[STATE_KEY] ??= { privateProvider: null };
20
+ return holder[STATE_KEY];
21
+ }
22
+ var LazyTracer = class {
23
+ constructor(name, version, options) {
24
+ this.name = name;
25
+ this.version = version;
26
+ this.options = options;
27
+ }
28
+ name;
29
+ version;
30
+ options;
31
+ resolve() {
32
+ const provider = state().privateProvider ?? trace.getTracerProvider();
33
+ return provider.getTracer(this.name, this.version, this.options);
34
+ }
35
+ startSpan(name, options, ctx) {
36
+ return this.resolve().startSpan(name, options, ctx);
37
+ }
38
+ startActiveSpan = ((...args) => {
39
+ const tracer = this.resolve();
40
+ return Reflect.apply(tracer.startActiveSpan, tracer, args);
41
+ });
42
+ };
43
+ var BrizzTracerProvider = class {
44
+ tracers = /* @__PURE__ */ new Map();
45
+ getTracer(name, version, options) {
46
+ const key = `${name}@${version ?? ""}:${options?.schemaUrl ?? ""}`;
47
+ let tracer = this.tracers.get(key);
48
+ if (!tracer) {
49
+ tracer = new LazyTracer(name, version, options);
50
+ this.tracers.set(key, tracer);
51
+ }
52
+ return tracer;
53
+ }
54
+ };
55
+ var brizzTracerProvider = new BrizzTracerProvider();
56
+ function getTracerProvider() {
57
+ return brizzTracerProvider;
58
+ }
59
+ function bindToBrizz(instrumentation) {
60
+ instrumentation.setTracerProvider(brizzTracerProvider);
61
+ return instrumentation;
62
+ }
63
+ function setPrivateTracerProvider(provider) {
64
+ state().privateProvider = provider;
65
+ }
66
+ function isPrivateTracerProvider() {
67
+ return state().privateProvider !== null;
68
+ }
69
+ var PROBE_KEY = createContextKey("brizz.sdk.contextManagerProbe");
70
+ function contextManagerWorks() {
71
+ return context.with(
72
+ context.active().setValue(PROBE_KEY, true),
73
+ () => context.active().getValue(PROBE_KEY) === true
74
+ );
75
+ }
76
+ function ensureContextManager() {
77
+ if (contextManagerWorks()) {
78
+ return "existing";
79
+ }
80
+ const manager = new AsyncLocalStorageContextManager().enable();
81
+ if (context.setGlobalContextManager(manager) && contextManagerWorks()) {
82
+ return "installed";
83
+ }
84
+ manager.disable();
85
+ return "failed";
86
+ }
87
+ function registerTracerProvider(provider) {
88
+ trace.setGlobalTracerProvider(provider);
89
+ ensureContextManager();
90
+ propagation.setGlobalPropagator(
91
+ new CompositePropagator({
92
+ propagators: [new W3CTraceContextPropagator(), new W3CBaggagePropagator()]
93
+ })
94
+ );
95
+ }
96
+ var w3cPropagator = new W3CTraceContextPropagator();
97
+ function injectTraceContext(ctx, carrier) {
98
+ if (isPrivateTracerProvider()) {
99
+ w3cPropagator.inject(ctx, carrier, defaultTextMapSetter);
100
+ } else {
101
+ propagation.inject(ctx, carrier);
102
+ }
103
+ }
104
+ function extractTraceContext(ctx, carrier) {
105
+ if (isPrivateTracerProvider()) {
106
+ return w3cPropagator.extract(ctx, carrier, defaultTextMapGetter);
107
+ }
108
+ return propagation.extract(ctx, carrier);
109
+ }
110
+
111
+ export {
112
+ brizzTracerProvider,
113
+ getTracerProvider,
114
+ bindToBrizz,
115
+ setPrivateTracerProvider,
116
+ isPrivateTracerProvider,
117
+ ensureContextManager,
118
+ registerTracerProvider,
119
+ injectTraceContext,
120
+ extractTraceContext
121
+ };
@@ -9,7 +9,7 @@ import {
9
9
 
10
10
  // src/internal/version.ts
11
11
  function getSDKVersion() {
12
- return "0.1.53";
12
+ return "0.1.55";
13
13
  }
14
14
 
15
15
  // src/internal/instrumentation/mcp/session.ts
@@ -1,7 +1,8 @@
1
1
  import {
2
2
  GoogleGenAIInstrumentation,
3
3
  instrumentGoogleGenAI
4
- } from "./chunk-TEY6FAVZ.js";
4
+ } from "./chunk-B5IY6O4N.js";
5
+ import "./chunk-TDPQDITP.js";
5
6
  import "./chunk-Y4HNUX3Q.js";
6
7
  import "./chunk-3RG5ZIWI.js";
7
8
  export {
@@ -0,0 +1,11 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true});
2
+
3
+
4
+ var _chunkRD4XCYKTcjs = require('./chunk-RD4XCYKT.cjs');
5
+ require('./chunk-DC2MFO65.cjs');
6
+ require('./chunk-WC573FCI.cjs');
7
+ require('./chunk-OBGZSXTJ.cjs');
8
+
9
+
10
+
11
+ exports.GoogleGenAIInstrumentation = _chunkRD4XCYKTcjs.GoogleGenAIInstrumentation; exports.instrumentGoogleGenAI = _chunkRD4XCYKTcjs.instrumentGoogleGenAI;
@@ -1,8 +1,9 @@
1
1
  "use strict";Object.defineProperty(exports, "__esModule", {value: true});
2
2
 
3
- var _chunkKFETJN5Mcjs = require('./chunk-KFETJN5M.cjs');
3
+ var _chunkRD4XCYKTcjs = require('./chunk-RD4XCYKT.cjs');
4
+ require('./chunk-DC2MFO65.cjs');
4
5
  require('./chunk-WC573FCI.cjs');
5
6
  require('./chunk-OBGZSXTJ.cjs');
6
7
 
7
8
 
8
- exports.instrumentGoogleGenAI = _chunkKFETJN5Mcjs.instrumentGoogleGenAI;
9
+ exports.instrumentGoogleGenAI = _chunkRD4XCYKTcjs.instrumentGoogleGenAI;
@@ -1,6 +1,7 @@
1
1
  import {
2
2
  instrumentGoogleGenAI
3
- } from "./chunk-TEY6FAVZ.js";
3
+ } from "./chunk-B5IY6O4N.js";
4
+ import "./chunk-TDPQDITP.js";
4
5
  import "./chunk-Y4HNUX3Q.js";
5
6
  import "./chunk-3RG5ZIWI.js";
6
7
  export {