@brizz/sdk 0.1.15 → 0.1.17

package/dist/index.d.cts

@@ -95,6 +95,7 @@ interface IBrizzInitializeOptions {
     customSpanExporter?: SpanExporter;
     customLogExporter?: LogRecordExporter;
     customMetricReader?: MetricReader;
+    disableSpanExporter?: boolean;
 }
 declare class _Brizz {
     private static instance;
@@ -132,10 +133,21 @@ declare class Session {
     constructor(sessionId: string, span: Span);
     setInput(text: string | null): void;
     setOutput(text: string | null): void;
+    setTitle(title: string): void;
     updateProperties(properties: Record<string, AttributeValue>): void;
 }
+declare class SessionTitle {
+    private readonly span;
+    constructor(span: Span);
+    setTitle(title: string): void;
+}
 declare function getActiveSession(): Session | undefined;
-declare function startSession<T>(sessionId: string, callback: (session: Session) => T, extraProperties?: Record<string, AttributeValue>): T;
+declare function startSession<T>(sessionId: string, callback: (session: Session) => T, extraProperties?: Record<string, AttributeValue>, options?: {
+    mode?: 'default' | 'title';
+}): T;
+declare function startSessionTitle<T>(callback: (title: SessionTitle) => T, options?: {
+    sessionId?: string;
+}): T;
 
 declare function getMetricsExporter(): OTLPMetricExporter;
 declare function getMetricsReader(): MetricReader;
@@ -153,4 +165,4 @@ declare namespace init {
   export {  };
 }
 
-export { Brizz, DEFAULT_PII_PATTERNS, type IAttributesMaskingRule, type IBrizzInitializeOptions, type IEventMaskingConfig, type IEventMaskingRule, type IInstrumentModules, type ILogMaskingConfig, type ILogger, type IMaskingConfig, type ISpanMaskingConfig, LogLevel, type MaskingMode, type RuntimeInfo, Session, callWithProperties, callWithSessionId, detectRuntime, emitEvent, getActiveSession, getLogLevel, getMetricsExporter, getMetricsReader, getSpanExporter, getSpanProcessor, init, logger, maskAttributes, maskValue, setLogLevel, startSession, withProperties, withSessionId };
+export { Brizz, DEFAULT_PII_PATTERNS, type IAttributesMaskingRule, type IBrizzInitializeOptions, type IEventMaskingConfig, type IEventMaskingRule, type IInstrumentModules, type ILogMaskingConfig, type ILogger, type IMaskingConfig, type ISpanMaskingConfig, LogLevel, type MaskingMode, type RuntimeInfo, Session, SessionTitle, callWithProperties, callWithSessionId, detectRuntime, emitEvent, getActiveSession, getLogLevel, getMetricsExporter, getMetricsReader, getSpanExporter, getSpanProcessor, init, logger, maskAttributes, maskValue, setLogLevel, startSession, startSessionTitle, withProperties, withSessionId };

package/dist/index.d.ts

@@ -95,6 +95,7 @@ interface IBrizzInitializeOptions {
     customSpanExporter?: SpanExporter;
     customLogExporter?: LogRecordExporter;
     customMetricReader?: MetricReader;
+    disableSpanExporter?: boolean;
 }
 declare class _Brizz {
     private static instance;
@@ -132,10 +133,21 @@ declare class Session {
     constructor(sessionId: string, span: Span);
     setInput(text: string | null): void;
     setOutput(text: string | null): void;
+    setTitle(title: string): void;
     updateProperties(properties: Record<string, AttributeValue>): void;
 }
+declare class SessionTitle {
+    private readonly span;
+    constructor(span: Span);
+    setTitle(title: string): void;
+}
 declare function getActiveSession(): Session | undefined;
-declare function startSession<T>(sessionId: string, callback: (session: Session) => T, extraProperties?: Record<string, AttributeValue>): T;
+declare function startSession<T>(sessionId: string, callback: (session: Session) => T, extraProperties?: Record<string, AttributeValue>, options?: {
+    mode?: 'default' | 'title';
+}): T;
+declare function startSessionTitle<T>(callback: (title: SessionTitle) => T, options?: {
+    sessionId?: string;
+}): T;
 
 declare function getMetricsExporter(): OTLPMetricExporter;
 declare function getMetricsReader(): MetricReader;
@@ -153,4 +165,4 @@ declare namespace init {
   export {  };
 }
 
-export { Brizz, DEFAULT_PII_PATTERNS, type IAttributesMaskingRule, type IBrizzInitializeOptions, type IEventMaskingConfig, type IEventMaskingRule, type IInstrumentModules, type ILogMaskingConfig, type ILogger, type IMaskingConfig, type ISpanMaskingConfig, LogLevel, type MaskingMode, type RuntimeInfo, Session, callWithProperties, callWithSessionId, detectRuntime, emitEvent, getActiveSession, getLogLevel, getMetricsExporter, getMetricsReader, getSpanExporter, getSpanProcessor, init, logger, maskAttributes, maskValue, setLogLevel, startSession, withProperties, withSessionId };
+export { Brizz, DEFAULT_PII_PATTERNS, type IAttributesMaskingRule, type IBrizzInitializeOptions, type IEventMaskingConfig, type IEventMaskingRule, type IInstrumentModules, type ILogMaskingConfig, type ILogger, type IMaskingConfig, type ISpanMaskingConfig, LogLevel, type MaskingMode, type RuntimeInfo, Session, SessionTitle, callWithProperties, callWithSessionId, detectRuntime, emitEvent, getActiveSession, getLogLevel, getMetricsExporter, getMetricsReader, getSpanExporter, getSpanProcessor, init, logger, maskAttributes, maskValue, setLogLevel, startSession, startSessionTitle, withProperties, withSessionId };

package/dist/index.js

@@ -278,6 +278,7 @@ function resolveConfig(options) {
     headers: { ...options.headers },
     apiKey: process.env["BRIZZ_API_KEY"] || options.apiKey,
     disableBatch: process.env["BRIZZ_DISABLE_BATCH"] === "true" || !!options.disableBatch,
+    disableSpanExporter: process.env["BRIZZ_DISABLE_SPAN_EXPORTER"] === "true" || !!options.disableSpanExporter,
     environment: process.env["BRIZZ_ENVIRONMENT"] || options.environment,
     logLevel: resolvedLogLevel,
     masking: resolvedMasking
@@ -445,7 +446,7 @@ import {
 
 // src/internal/version.ts
 function getSDKVersion() {
-  return "0.1.15";
+  return "0.1.17";
 }
 
 // src/internal/log/processors/log-processor.ts
@@ -1086,6 +1087,9 @@ var SESSION_OBJECT_CONTEXT_KEY = createContextKey("brizz.session.object");
 var SESSION_INPUT = "brizz.session.input";
 var SESSION_OUTPUT = "brizz.session.output";
 var SESSION_SPAN_NAME = "brizz.start_session";
+var SESSION_TITLE_SPAN_NAME = "brizz.session_title";
+var SESSION_TITLE_GENERATION = "session.title_generation";
+var SESSION_TITLE = "brizz.session.title";
 
 // src/internal/log/processors/log-processor.ts
 var DEFAULT_LOG_MASKING_RULES = [
@@ -1592,6 +1596,15 @@ var TracingModule = class _TracingModule {
    */
   setup(config) {
     logger.info("Setting up tracing module");
+    if (config.disableSpanExporter) {
+      logger.info(
+        "Span exporter disabled via disableSpanExporter; skipping exporter and processor setup"
+      );
+      this.spanExporter = null;
+      this.spanProcessor = null;
+      _TracingModule.instance = this;
+      return;
+    }
     this.initSpanExporter(config);
     this.initSpanProcessor(config);
     _TracingModule.instance = this;
@@ -1735,6 +1748,14 @@ var Session = class {
     this.outputs.push(text);
     this.span.setAttribute(SESSION_OUTPUT, JSON.stringify(this.outputs));
   }
+  /**
+   * Set the session title on the span.
+   *
+   * @param title - The generated title string
+   */
+  setTitle(title) {
+    this.span.setAttribute(SESSION_TITLE, title);
+  }
   /**
    * Update custom properties on the session span.
    * Properties are prefixed with 'brizz.'.
@@ -1747,12 +1768,28 @@ var Session = class {
     }
   }
 };
+var SessionTitle = class {
+  span;
+  constructor(span) {
+    this.span = span;
+  }
+  /**
+   * Set the generated title on the wrapper span.
+   *
+   * @param title - The generated title string
+   */
+  setTitle(title) {
+    this.span.setAttribute(SESSION_TITLE, title);
+  }
+};
 function getActiveSession() {
   return context3.active().getValue(SESSION_OBJECT_CONTEXT_KEY);
 }
-function startSession(sessionId, callback, extraProperties) {
+function startSession(sessionId, callback, extraProperties, options) {
+  const isTitle = options?.mode === "title";
+  const spanName = isTitle ? SESSION_TITLE_SPAN_NAME : SESSION_SPAN_NAME;
   const tracer = trace.getTracer("@brizz/sdk");
-  return tracer.startActiveSpan(SESSION_SPAN_NAME, (span) => {
+  return tracer.startActiveSpan(spanName, (span) => {
     span.setAttribute(`${BRIZZ}.${SESSION_ID}`, sessionId);
     if (extraProperties) {
       for (const [key, value] of Object.entries(extraProperties)) {
@@ -1761,6 +1798,9 @@ function startSession(sessionId, callback, extraProperties) {
     }
     const session = new Session(sessionId, span);
     const contextProperties = { [SESSION_ID]: sessionId };
+    if (isTitle) {
+      contextProperties[SESSION_TITLE_GENERATION] = "true";
+    }
     if (extraProperties) {
       for (const [key, value] of Object.entries(extraProperties)) {
         contextProperties[key] = String(value);
@@ -1794,6 +1834,43 @@ function startSession(sessionId, callback, extraProperties) {
     });
   });
 }
+function startSessionTitle(callback, options) {
+  const resolvedSessionId = options?.sessionId ?? getActiveSession()?.sessionId;
+  const tracer = trace.getTracer("@brizz/sdk");
+  return tracer.startActiveSpan(SESSION_TITLE_SPAN_NAME, (span) => {
+    if (resolvedSessionId) {
+      span.setAttribute(`${BRIZZ}.${SESSION_ID}`, resolvedSessionId);
+    }
+    const sessionTitle = new SessionTitle(span);
+    const properties = { [SESSION_TITLE_GENERATION]: "true" };
+    if (resolvedSessionId) {
+      properties[SESSION_ID] = resolvedSessionId;
+    }
+    return callWithProperties(properties, () => {
+      try {
+        const result = callback(sessionTitle);
+        if (result && typeof result.then === "function") {
+          return result.then((value) => {
+            span.end();
+            return value;
+          }).catch((error) => {
+            span.recordException(error);
+            span.setStatus({ code: SpanStatusCode.ERROR });
+            span.end();
+            throw error;
+          });
+        }
+        span.end();
+        return result;
+      } catch (error) {
+        span.recordException(error);
+        span.setStatus({ code: SpanStatusCode.ERROR });
+        span.end();
+        throw error;
+      }
+    });
+  });
+}
 
 // src/internal/sdk.ts
 var _Brizz = class __Brizz {
@@ -1874,7 +1951,7 @@ var _Brizz = class __Brizz {
       resourceAttributes["deployment.environment"] = resolvedConfig.environment;
     }
     this._sdk = new NodeSDK({
-      spanProcessors: [getSpanProcessor()],
+      spanProcessors: resolvedConfig.disableSpanExporter ? [] : [getSpanProcessor()],
       metricReader: getMetricsReader(),
       resource: resourceFromAttributes3(resourceAttributes),
       instrumentations: manualInstrumentations
@@ -2044,6 +2121,7 @@ export {
   DEFAULT_PII_PATTERNS,
   LogLevel,
   Session,
+  SessionTitle,
   SeverityNumber2 as SeverityNumber,
   callWithProperties,
   callWithSessionId,
@@ -2061,6 +2139,7 @@ export {
   maskValue,
   setLogLevel,
   startSession,
+  startSessionTitle,
   withProperties,
   withSessionId
 };