@letterbook/ai-chat 0.1.0 → 0.1.1

package/README.md

@@ -33,6 +33,7 @@ console.log(result.queued, result.evaluationAfterSeconds);
 
 Set `LETTERBOOK_API_KEY`, or instantiate `new letterbook.Letterbook({ apiKey })` for explicit configuration.
 Set `debounceSeconds` to control how long Letterbook waits after the last message before evaluating the conversation.
+If OpenTelemetry is configured in your app, the SDK automatically propagates the active trace context with each capture request.
 
 If `customerEmail` is omitted, the SDK looks for `properties.customer_email`, `properties.email`, or an email-shaped `userId`.
 Email is only required if Letterbook promotes the capture to a ticket.

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export interface LetterbookOptions {
     timeoutMs?: number;
     raiseOnError?: boolean;
     fetch?: typeof fetch;
+    otelEnabled?: boolean;
 }
 export interface CaptureInput {
     userId: string;
@@ -51,6 +52,7 @@ export declare class Letterbook {
     private readonly timeoutMs;
     private readonly raiseOnError;
     private readonly fetchFn;
+    private readonly otelEnabled;
     constructor(options?: LetterbookOptions);
     capture(input: CaptureInput): Promise<CaptureResult>;
     private postJson;

package/dist/index.js

@@ -1,3 +1,4 @@
+import { context, propagation } from "@opentelemetry/api";
 const DEFAULT_BASE_URL = "https://api.letterbook.ai/api";
 export class LetterbookError extends Error {
     constructor(message) {
@@ -11,12 +12,14 @@ export class Letterbook {
     timeoutMs;
     raiseOnError;
     fetchFn;
+    otelEnabled;
     constructor(options = {}) {
         this.apiKey = options.apiKey ?? readEnv("LETTERBOOK_API_KEY");
         this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
         this.timeoutMs = options.timeoutMs ?? 10_000;
         this.raiseOnError = options.raiseOnError ?? false;
         this.fetchFn = options.fetch ?? globalThis.fetch;
+        this.otelEnabled = options.otelEnabled ?? true;
         if (!this.fetchFn) {
             throw new LetterbookError("A fetch implementation is required.");
         }
@@ -81,13 +84,17 @@ export class Letterbook {
         const controller = new AbortController();
         const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
         try {
+            const headers = {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+                "User-Agent": "@letterbook/ai-chat/0.1.0",
+            };
+            if (this.otelEnabled) {
+                propagation.inject(context.active(), headers);
+            }
             const response = await this.fetchFn(`${this.baseUrl}${path}`, {
                 method: "POST",
-                headers: {
-                    Authorization: `Bearer ${this.apiKey}`,
-                    "Content-Type": "application/json",
-                    "User-Agent": "@letterbook/ai-chat/0.1.0",
-                },
+                headers,
                 body: JSON.stringify(payload),
                 signal: controller.signal,
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letterbook/ai-chat",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "TypeScript SDK for capturing AI chat issues in Letterbook.",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,5 +32,8 @@
   },
   "devDependencies": {
     "typescript": "~5.8.3"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0"
   }
 }