langwatch 0.27.0 → 0.28.0

package/dist/chunk-ZXFN2K4P.mjs

@@ -0,0 +1,300 @@
+import {
+  buildAuthHeaders
+} from "./chunk-SIXSSID3.mjs";
+import {
+  DEFAULT_ENDPOINT,
+  LANGWATCH_SDK_LANGUAGE,
+  LANGWATCH_SDK_NAME_OBSERVABILITY,
+  LANGWATCH_SDK_RUNTIME,
+  LANGWATCH_SDK_VERSION,
+  LOGS_PATH,
+  TRACES_PATH
+} from "./chunk-UUCNCFVT.mjs";
+import {
+  shouldCaptureOutput
+} from "./chunk-JOLGDU7Q.mjs";
+import {
+  __spreadProps,
+  __spreadValues
+} from "./chunk-BAX4W3AY.mjs";
+
+// src/observability-sdk/exporters/langwatch-trace-exporter.ts
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+
+// src/observability-sdk/exporters/trace-filters.ts
+function applyFilters(filters, spans) {
+  if (!filters || filters.length === 0) return spans;
+  return filters.reduce((current, rule) => applyFilterRule(rule, current), spans);
+}
+function applyFilterRule(rule, spans) {
+  if ("preset" in rule && rule.preset) {
+    return applyPreset(
+      rule.preset,
+      spans
+    );
+  }
+  if ("include" in rule && rule.include) {
+    const criteria = rule.include;
+    return spans.filter((s) => matchesCriteria(s, criteria));
+  }
+  if ("exclude" in rule && rule.exclude) {
+    const criteria = rule.exclude;
+    return spans.filter((s) => !matchesCriteria(s, criteria));
+  }
+  return spans;
+}
+function applyPreset(preset, spans) {
+  if (preset === "vercelAIOnly") return spans.filter((s) => isVercelAiSpan(s));
+  if (preset === "excludeHttpRequests") return spans.filter((s) => !isHttpRequestSpan(s));
+  return spans;
+}
+function matchesCriteria(span, criteria) {
+  var _a, _b;
+  if (criteria.instrumentationScopeName !== void 0) {
+    const scopeName = (_b = (_a = span.instrumentationScope) == null ? void 0 : _a.name) != null ? _b : "";
+    const ok = criteria.instrumentationScopeName.some((m) => valueMatches(scopeName, m));
+    if (!ok) return false;
+  }
+  if (criteria.name !== void 0) {
+    const ok = criteria.name.some((m) => {
+      var _a2;
+      return valueMatches((_a2 = span.name) != null ? _a2 : "", m);
+    });
+    if (!ok) return false;
+  }
+  return true;
+}
+function valueMatches(value, rule) {
+  var _a;
+  const raw = value != null ? value : "";
+  const ignoreCase = (_a = rule.ignoreCase) != null ? _a : false;
+  if (rule.equals !== void 0) {
+    return ignoreCase ? raw.localeCompare(rule.equals, void 0, { sensitivity: "base" }) === 0 : raw === rule.equals;
+  }
+  if (rule.startsWith !== void 0) {
+    return ignoreCase ? raw.toLowerCase().startsWith(rule.startsWith.toLowerCase()) : raw.startsWith(rule.startsWith);
+  }
+  if (rule.matches instanceof RegExp) {
+    const re = ignoreCase && !rule.matches.flags.includes("i") ? new RegExp(rule.matches.source, (rule.matches.flags || "") + "i") : rule.matches;
+    return re.test(raw);
+  }
+  return false;
+}
+function isVercelAiSpan(span) {
+  var _a, _b, _c, _d;
+  const scope = (_d = (_c = (_b = (_a = span.instrumentationScope) == null ? void 0 : _a.name) == null ? void 0 : _b.toLowerCase) == null ? void 0 : _c.call(_b)) != null ? _d : "";
+  return scope === "ai";
+}
+function isHttpRequestSpan(span) {
+  var _a;
+  const name = (_a = span.name) != null ? _a : "";
+  const verbMatch = /^(GET|POST|PUT|DELETE|PATCH|OPTIONS|HEAD)\b/i.test(name);
+  return verbMatch;
+}
+
+// src/observability-sdk/exporters/langwatch-trace-exporter.ts
+var LangWatchTraceExporter = class extends OTLPTraceExporter {
+  /**
+   * Creates a new LangWatchTraceExporter instance.
+   *
+   * @param opts - Configuration options for the exporter
+   * @param opts.apiKey - API key for LangWatch authentication.
+   *                     Falls back to `LANGWATCH_API_KEY` environment variable, then empty string.
+   * @param opts.endpoint - Custom endpoint URL for LangWatch ingestion.
+   *                       Falls back to `LANGWATCH_ENDPOINT` environment variable, then default endpoint.
+   * @param opts.filters - Array of filters applied sequentially to spans before export (AND semantics).
+   *                      When omitted, defaults to `[{ preset: "excludeHttpRequests" }]`.
+   *                      Pass `null` or `[]` to disable all filtering and send all spans.
+   *
+   * @example
+   * ```typescript
+   * // With API key and default filtering
+   * const exporter = new LangWatchTraceExporter({
+   *   apiKey: 'your-api-key'
+   * });
+   *
+   * // With custom endpoint and no filtering
+   * const exporter = new LangWatchTraceExporter({
+   *   endpoint: 'https://custom.langwatch.ai',
+   *   filters: null
+   * });
+   * ```
+   */
+  constructor(opts) {
+    var _a, _b, _c, _d, _e;
+    const apiKey = (_b = (_a = opts == null ? void 0 : opts.apiKey) != null ? _a : process.env.LANGWATCH_API_KEY) != null ? _b : "";
+    const projectId = (_c = opts == null ? void 0 : opts.projectId) != null ? _c : process.env.LANGWATCH_PROJECT_ID;
+    const endpoint = (_e = (_d = opts == null ? void 0 : opts.endpoint) != null ? _d : process.env.LANGWATCH_ENDPOINT) != null ? _e : DEFAULT_ENDPOINT;
+    const url = new URL(TRACES_PATH, endpoint);
+    const otelEndpoint = url.toString();
+    super({
+      headers: __spreadValues({
+        "x-langwatch-sdk-name": LANGWATCH_SDK_NAME_OBSERVABILITY,
+        "x-langwatch-sdk-language": LANGWATCH_SDK_LANGUAGE,
+        "x-langwatch-sdk-version": LANGWATCH_SDK_VERSION,
+        "x-langwatch-sdk-runtime": LANGWATCH_SDK_RUNTIME()
+      }, buildAuthHeaders({ apiKey, projectId })),
+      url: otelEndpoint.toString()
+    });
+    if ((opts == null ? void 0 : opts.filters) === null || Array.isArray(opts == null ? void 0 : opts.filters) && opts.filters.length === 0) {
+      this.filters = [];
+    } else if (Array.isArray(opts == null ? void 0 : opts.filters)) {
+      this.filters = opts.filters;
+    } else {
+      this.filters = [{ preset: "excludeHttpRequests" }];
+    }
+  }
+  export(spans, resultCallback) {
+    const filtered = applyFilters(this.filters, spans);
+    super.export(filtered, resultCallback);
+  }
+};
+
+// src/observability-sdk/exporters/langwatch-logs-exporter.ts
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
+var LangWatchLogsExporter = class extends OTLPLogExporter {
+  /**
+   * Creates a new LangWatchLogsExporter instance.
+   *
+   * @param opts - Optional configuration options for the exporter.
+   * @param opts.apiKey - Optional API key for LangWatch authentication. If not provided,
+   *                     will use environment variables or fallback configuration.
+   * @param opts.endpoint - Optional custom endpoint URL for LangWatch ingestion.
+   *                       If not provided, will use environment variables or fallback configuration.
+   */
+  constructor(opts) {
+    var _a, _b, _c, _d;
+    const apiKey = (_b = (_a = opts == null ? void 0 : opts.apiKey) != null ? _a : process.env.LANGWATCH_API_KEY) != null ? _b : "";
+    const endpoint = (_d = (_c = opts == null ? void 0 : opts.endpoint) != null ? _c : process.env.LANGWATCH_ENDPOINT) != null ? _d : DEFAULT_ENDPOINT;
+    const url = new URL(LOGS_PATH, endpoint);
+    const otelEndpoint = url.toString();
+    super({
+      headers: __spreadValues({
+        "x-langwatch-sdk-name": LANGWATCH_SDK_NAME_OBSERVABILITY,
+        "x-langwatch-sdk-language": LANGWATCH_SDK_LANGUAGE,
+        "x-langwatch-sdk-version": LANGWATCH_SDK_VERSION,
+        "x-langwatch-sdk-runtime": LANGWATCH_SDK_RUNTIME()
+      }, apiKey ? { authorization: `Bearer ${apiKey}` } : {}),
+      url: otelEndpoint.toString()
+    });
+  }
+};
+
+// src/observability-sdk/semconv/events.ts
+var LOG_EVNT_GEN_AI_SYSTEM_MESSAGE = "gen.ai.system_message";
+var LOG_EVNT_GEN_AI_USER_MESSAGE = "gen.ai.user_message";
+var LOG_EVNT_GEN_AI_ASSISTANT_MESSAGE = "gen.ai.assistant_message";
+var LOG_EVNT_GEN_AI_TOOL_MESSAGE = "gen.ai.tool_message";
+var LOG_EVNT_GEN_AI_CHOICE = "gen.ai.choice";
+
+// src/observability-sdk/logger/index.ts
+import {
+  NoopLoggerProvider
+} from "@opentelemetry/api-logs";
+
+// src/observability-sdk/logger/implementation.ts
+import { context } from "@opentelemetry/api";
+var LangWatchLoggerInternal = class {
+  constructor(logger) {
+    this.logger = logger;
+  }
+  emit(logRecord, options) {
+    if (!shouldCaptureOutput()) {
+      logRecord.body = void 0;
+    }
+    if (!logRecord.context && !(options == null ? void 0 : options.excludeContext)) {
+      logRecord.context = context.active();
+    }
+    this.logger.emit(logRecord);
+  }
+  emitGenAISystemMessageEvent(body, system, attributes) {
+    var _a;
+    this.emitGenAIEvent(
+      LOG_EVNT_GEN_AI_SYSTEM_MESSAGE,
+      __spreadProps(__spreadValues({}, body), { role: (_a = body.role) != null ? _a : "system" }),
+      __spreadProps(__spreadValues({}, attributes), {
+        "gen_ai.system": system
+      })
+    );
+  }
+  emitGenAIUserMessageEvent(body, system, attributes) {
+    var _a;
+    this.emitGenAIEvent(
+      LOG_EVNT_GEN_AI_USER_MESSAGE,
+      __spreadProps(__spreadValues({}, body), { role: (_a = body.role) != null ? _a : "user" }),
+      __spreadProps(__spreadValues({}, attributes), {
+        "gen_ai.system": system
+      })
+    );
+  }
+  emitGenAIAssistantMessageEvent(body, system, attributes) {
+    var _a;
+    this.emitGenAIEvent(
+      LOG_EVNT_GEN_AI_ASSISTANT_MESSAGE,
+      __spreadProps(__spreadValues({}, body), { role: (_a = body.role) != null ? _a : "assistant" }),
+      __spreadProps(__spreadValues({}, attributes), {
+        "gen_ai.system": system
+      })
+    );
+  }
+  emitGenAIToolMessageEvent(body, system, attributes) {
+    if (body.role === void 0) {
+      body.role = "tool";
+    }
+    this.emitGenAIEvent(
+      LOG_EVNT_GEN_AI_TOOL_MESSAGE,
+      __spreadValues({}, body),
+      __spreadProps(__spreadValues({}, attributes), {
+        "gen_ai.system": system
+      })
+    );
+  }
+  emitGenAIChoiceEvent(body, system, attributes) {
+    var _a, _b;
+    if (body.message && body.message.role === void 0) {
+      body.message.role = "assistant";
+    }
+    this.emitGenAIEvent(
+      LOG_EVNT_GEN_AI_CHOICE,
+      __spreadProps(__spreadValues({}, body), {
+        message: __spreadProps(__spreadValues({}, body.message), { role: (_b = (_a = body.message) == null ? void 0 : _a.role) != null ? _b : "assistant" })
+      }),
+      __spreadProps(__spreadValues({}, attributes), {
+        "gen_ai.system": system
+      })
+    );
+  }
+  emitGenAIEvent(eventName, body, attributes) {
+    this.emit({
+      eventName,
+      context: context.active(),
+      attributes: __spreadValues({}, attributes),
+      body: shouldCaptureOutput() ? body : void 0,
+      observedTimestamp: (/* @__PURE__ */ new Date()).getTime()
+    });
+  }
+};
+
+// src/observability-sdk/logger/index.ts
+var currentLoggerProvider = new NoopLoggerProvider();
+function setLangWatchLoggerProvider(loggerProvider) {
+  currentLoggerProvider = loggerProvider;
+}
+function getLangWatchLogger(name, version) {
+  return getLangWatchLoggerFromProvider(currentLoggerProvider, name, version);
+}
+function getLangWatchLoggerFromProvider(loggerProvider, name, version) {
+  return createLangWatchLogger(loggerProvider.getLogger(name, version));
+}
+function createLangWatchLogger(logger) {
+  return new LangWatchLoggerInternal(logger);
+}
+
+export {
+  LangWatchTraceExporter,
+  LangWatchLogsExporter,
+  setLangWatchLoggerProvider,
+  getLangWatchLogger,
+  getLangWatchLoggerFromProvider
+};
+//# sourceMappingURL=chunk-ZXFN2K4P.mjs.map