langwatch 0.3.2 → 0.4.1

package/dist/chunk-DISMHYXC.js

@@ -0,0 +1,184 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkOXBO24RBjs = require('./chunk-OXBO24RB.js');
+
+// src/logger/index.ts
+var logLevelOrder = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
+};
+var NoOpLogger = class {
+  debug() {
+  }
+  info() {
+  }
+  warn() {
+  }
+  error() {
+  }
+};
+var ConsoleLogger = class {
+  constructor(options = { level: "warn" }) {
+    this.level = options.level;
+    this.prefix = options.prefix;
+  }
+  shouldLog(level) {
+    return logLevelOrder[level] >= logLevelOrder[this.level];
+  }
+  format(message) {
+    return this.prefix ? `[${this.prefix}] ${message}` : message;
+  }
+  debug(message, ...args) {
+    if (this.shouldLog("debug")) console.debug(this.format(message), ...args);
+  }
+  info(message, ...args) {
+    if (this.shouldLog("info")) console.info(this.format(message), ...args);
+  }
+  warn(message, ...args) {
+    if (this.shouldLog("warn")) console.warn(this.format(message), ...args);
+  }
+  error(message, ...args) {
+    if (this.shouldLog("error")) console.error(this.format(message), ...args);
+  }
+};
+
+// src/observability-sdk/semconv/attributes.ts
+var attributes_exports = {};
+_chunkOXBO24RBjs.__export.call(void 0, attributes_exports, {
+  ATTR_LANGWATCH_CUSTOMER_ID: () => ATTR_LANGWATCH_CUSTOMER_ID,
+  ATTR_LANGWATCH_EVALUATION_CUSTOM: () => ATTR_LANGWATCH_EVALUATION_CUSTOM,
+  ATTR_LANGWATCH_INPUT: () => ATTR_LANGWATCH_INPUT,
+  ATTR_LANGWATCH_LANGCHAIN_EVENT_NAME: () => ATTR_LANGWATCH_LANGCHAIN_EVENT_NAME,
+  ATTR_LANGWATCH_LANGCHAIN_RUN_EXTRA_PARAMS: () => ATTR_LANGWATCH_LANGCHAIN_RUN_EXTRA_PARAMS,
+  ATTR_LANGWATCH_LANGCHAIN_RUN_ID: () => ATTR_LANGWATCH_LANGCHAIN_RUN_ID,
+  ATTR_LANGWATCH_LANGCHAIN_RUN_METADATA: () => ATTR_LANGWATCH_LANGCHAIN_RUN_METADATA,
+  ATTR_LANGWATCH_LANGCHAIN_RUN_PARENT_ID: () => ATTR_LANGWATCH_LANGCHAIN_RUN_PARENT_ID,
+  ATTR_LANGWATCH_LANGCHAIN_RUN_TAGS: () => ATTR_LANGWATCH_LANGCHAIN_RUN_TAGS,
+  ATTR_LANGWATCH_LANGCHAIN_RUN_TYPE: () => ATTR_LANGWATCH_LANGCHAIN_RUN_TYPE,
+  ATTR_LANGWATCH_LANGCHAIN_TAGS: () => ATTR_LANGWATCH_LANGCHAIN_TAGS,
+  ATTR_LANGWATCH_METRICS: () => ATTR_LANGWATCH_METRICS,
+  ATTR_LANGWATCH_OUTPUT: () => ATTR_LANGWATCH_OUTPUT,
+  ATTR_LANGWATCH_PARAMS: () => ATTR_LANGWATCH_PARAMS,
+  ATTR_LANGWATCH_PROMPT_HANDLE: () => ATTR_LANGWATCH_PROMPT_HANDLE,
+  ATTR_LANGWATCH_PROMPT_ID: () => ATTR_LANGWATCH_PROMPT_ID,
+  ATTR_LANGWATCH_PROMPT_SELECTED_ID: () => ATTR_LANGWATCH_PROMPT_SELECTED_ID,
+  ATTR_LANGWATCH_PROMPT_VARIABLES: () => ATTR_LANGWATCH_PROMPT_VARIABLES,
+  ATTR_LANGWATCH_PROMPT_VERSION_ID: () => ATTR_LANGWATCH_PROMPT_VERSION_ID,
+  ATTR_LANGWATCH_PROMPT_VERSION_NUMBER: () => ATTR_LANGWATCH_PROMPT_VERSION_NUMBER,
+  ATTR_LANGWATCH_RAG_CONTEXTS: () => ATTR_LANGWATCH_RAG_CONTEXTS,
+  ATTR_LANGWATCH_SDK_LANGUAGE: () => ATTR_LANGWATCH_SDK_LANGUAGE,
+  ATTR_LANGWATCH_SDK_NAME: () => ATTR_LANGWATCH_SDK_NAME,
+  ATTR_LANGWATCH_SDK_VERSION: () => ATTR_LANGWATCH_SDK_VERSION,
+  ATTR_LANGWATCH_SPAN_TYPE: () => ATTR_LANGWATCH_SPAN_TYPE,
+  ATTR_LANGWATCH_STREAMING: () => ATTR_LANGWATCH_STREAMING,
+  ATTR_LANGWATCH_TAGS: () => ATTR_LANGWATCH_TAGS,
+  ATTR_LANGWATCH_THREAD_ID: () => ATTR_LANGWATCH_THREAD_ID,
+  ATTR_LANGWATCH_TIMESTAMPS: () => ATTR_LANGWATCH_TIMESTAMPS,
+  ATTR_LANGWATCH_USER_ID: () => ATTR_LANGWATCH_USER_ID
+});
+var ATTR_LANGWATCH_INPUT = "langwatch.input";
+var ATTR_LANGWATCH_OUTPUT = "langwatch.output";
+var ATTR_LANGWATCH_SPAN_TYPE = "langwatch.span.type";
+var ATTR_LANGWATCH_RAG_CONTEXTS = "langwatch.contexts";
+var ATTR_LANGWATCH_METRICS = "langwatch.metrics";
+var ATTR_LANGWATCH_SDK_VERSION = "langwatch.sdk.version";
+var ATTR_LANGWATCH_SDK_NAME = "langwatch.sdk.name";
+var ATTR_LANGWATCH_SDK_LANGUAGE = "langwatch.sdk.language";
+var ATTR_LANGWATCH_TIMESTAMPS = "langwatch.timestamps";
+var ATTR_LANGWATCH_EVALUATION_CUSTOM = "langwatch.evaluation.custom";
+var ATTR_LANGWATCH_PARAMS = "langwatch.params";
+var ATTR_LANGWATCH_CUSTOMER_ID = "langwatch.customer.id";
+var ATTR_LANGWATCH_THREAD_ID = "langwatch.thread.id";
+var ATTR_LANGWATCH_USER_ID = "langwatch.user.id";
+var ATTR_LANGWATCH_TAGS = "langwatch.tags";
+var ATTR_LANGWATCH_STREAMING = "langwatch.gen_ai.streaming";
+var ATTR_LANGWATCH_PROMPT_ID = "langwatch.prompt.id";
+var ATTR_LANGWATCH_PROMPT_HANDLE = "langwatch.prompt.handle";
+var ATTR_LANGWATCH_PROMPT_VERSION_ID = "langwatch.prompt.version.id";
+var ATTR_LANGWATCH_PROMPT_VARIABLES = "langwatch.prompt.variables";
+var ATTR_LANGWATCH_PROMPT_SELECTED_ID = "langwatch.prompt.selected.id";
+var ATTR_LANGWATCH_PROMPT_VERSION_NUMBER = "langwatch.prompt.version.number";
+var ATTR_LANGWATCH_LANGCHAIN_TAGS = "langwatch.langchain.tags";
+var ATTR_LANGWATCH_LANGCHAIN_EVENT_NAME = "langwatch.langchain.event_name";
+var ATTR_LANGWATCH_LANGCHAIN_RUN_ID = "langwatch.langchain.run.id";
+var ATTR_LANGWATCH_LANGCHAIN_RUN_TAGS = "langwatch.langchain.run.tags";
+var ATTR_LANGWATCH_LANGCHAIN_RUN_TYPE = "langwatch.langchain.run.type";
+var ATTR_LANGWATCH_LANGCHAIN_RUN_METADATA = "langwatch.langchain.run.metadata";
+var ATTR_LANGWATCH_LANGCHAIN_RUN_EXTRA_PARAMS = "langwatch.langchain.run.extra_params";
+var ATTR_LANGWATCH_LANGCHAIN_RUN_PARENT_ID = "langwatch.langchain.run.parent.id";
+
+// src/observability-sdk/features/data-capture/utils.ts
+function validateDataCaptureMode(mode) {
+  return ["none", "input", "output", "all"].includes(mode);
+}
+
+// src/observability-sdk/config.ts
+var observabilitySdkConfig = null;
+function initializeObservabilitySdkConfig(config) {
+  observabilitySdkConfig = config;
+}
+function getObservabilitySdkConfig(options) {
+  if (!observabilitySdkConfig) {
+    const message = "[LangWatch Observability SDK] Please call setupObservability() before using the Observability SDK";
+    if ((options == null ? void 0 : options.throwOnUninitialized) || process.env.NODE_ENV === "development") {
+      throw new Error(message);
+    }
+    return {
+      logger: new NoOpLogger()
+    };
+  }
+  return observabilitySdkConfig;
+}
+function getObservabilitySdkLogger() {
+  return getObservabilitySdkConfig().logger;
+}
+function getDataCaptureMode() {
+  const config = getObservabilitySdkConfig();
+  if (!config.dataCapture) {
+    return "all";
+  }
+  if (typeof config.dataCapture === "string") {
+    const validModes = ["none", "input", "output", "all"];
+    if (validModes.includes(config.dataCapture)) {
+      return config.dataCapture;
+    }
+    getObservabilitySdkLogger().warn(
+      `Invalid data capture mode: ${config.dataCapture}. Using default: "all"`
+    );
+    return "all";
+  }
+  if (typeof config.dataCapture === "object" && config.dataCapture.mode && validateDataCaptureMode(config.dataCapture.mode)) {
+    return config.dataCapture.mode;
+  }
+  return "all";
+}
+function shouldCaptureInput() {
+  const mode = getDataCaptureMode();
+  return mode === "input" || mode === "all";
+}
+function shouldCaptureOutput() {
+  const mode = getDataCaptureMode();
+  return mode === "output" || mode === "all";
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.NoOpLogger = NoOpLogger; exports.ConsoleLogger = ConsoleLogger; exports.ATTR_LANGWATCH_INPUT = ATTR_LANGWATCH_INPUT; exports.ATTR_LANGWATCH_OUTPUT = ATTR_LANGWATCH_OUTPUT; exports.ATTR_LANGWATCH_SPAN_TYPE = ATTR_LANGWATCH_SPAN_TYPE; exports.ATTR_LANGWATCH_RAG_CONTEXTS = ATTR_LANGWATCH_RAG_CONTEXTS; exports.ATTR_LANGWATCH_METRICS = ATTR_LANGWATCH_METRICS; exports.ATTR_LANGWATCH_PROMPT_ID = ATTR_LANGWATCH_PROMPT_ID; exports.ATTR_LANGWATCH_PROMPT_VERSION_ID = ATTR_LANGWATCH_PROMPT_VERSION_ID; exports.ATTR_LANGWATCH_PROMPT_SELECTED_ID = ATTR_LANGWATCH_PROMPT_SELECTED_ID; exports.ATTR_LANGWATCH_PROMPT_VERSION_NUMBER = ATTR_LANGWATCH_PROMPT_VERSION_NUMBER; exports.attributes_exports = attributes_exports; exports.initializeObservabilitySdkConfig = initializeObservabilitySdkConfig; exports.getDataCaptureMode = getDataCaptureMode; exports.shouldCaptureInput = shouldCaptureInput; exports.shouldCaptureOutput = shouldCaptureOutput;
+//# sourceMappingURL=chunk-DISMHYXC.js.map

package/dist/chunk-DISMHYXC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-DISMHYXC.js","../src/logger/index.ts","../src/observability-sdk/semconv/attributes.ts","../src/observability-sdk/features/data-capture/utils.ts","../src/observability-sdk/config.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACA;ACcA,IAAM,cAAA,EAA0C;AAAA,EAC9C,KAAA,EAAO,CAAA;AAAA,EACP,IAAA,EAAM,CAAA;AAAA,EACN,IAAA,EAAM,CAAA;AAAA,EACN,KAAA,EAAO;AACT,CAAA;AASO,IAAM,WAAA,EAAN,MAAmC;AAAA,EACxC,KAAA,CAAA,EAAc;AAAA,EAAa;AAAA,EAC3B,IAAA,CAAA,EAAa;AAAA,EAAa;AAAA,EAC1B,IAAA,CAAA,EAAa;AAAA,EAAa;AAAA,EAC1B,KAAA,CAAA,EAAc;AAAA,EAAa;AAC7B,CAAA;AAWO,IAAM,cAAA,EAAN,MAAsC;AAAA,EAI3C,WAAA,CAAY,QAAA,EAAgC,EAAE,KAAA,EAAO,OAAO,CAAA,EAAG;AAC7D,IAAA,IAAA,CAAK,MAAA,EAAQ,OAAA,CAAQ,KAAA;AACrB,IAAA,IAAA,CAAK,OAAA,EAAS,OAAA,CAAQ,MAAA;AAAA,EACxB;AAAA,EAEQ,SAAA,CAAU,KAAA,EAA0B;AAC1C,IAAA,OAAO,aAAA,CAAc,KAAK,EAAA,GAAK,aAAA,CAAc,IAAA,CAAK,KAAK,CAAA;AAAA,EACzD;AAAA,EAEQ,MAAA,CAAO,OAAA,EAAyB;AACtC,IAAA,OAAO,IAAA,CAAK,OAAA,EAAS,CAAA,CAAA,EAAI,IAAA,CAAK,MAAM,CAAA,EAAA,EAAK,OAAO,CAAA,EAAA;AAClD,EAAA;AAEiD,EAAA;AACC,IAAA;AAClD,EAAA;AACgD,EAAA;AACA,IAAA;AAChD,EAAA;AACgD,EAAA;AACA,IAAA;AAChD,EAAA;AACiD,EAAA;AACC,IAAA;AAClD,EAAA;AACF;ADhCqD;AACA;AE9CrD;AAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA,EAAA;AAAA;AAYoC;AAMC;AAMG;AAMG;AAML;AAMI;AAMH;AAMI;AAMF;AAMO;AAMX;AAMK;AAMF;AAMF;AAMH;AAMK;AAMA;AAMI;AAMI;AAMD;AAME;AAO/C;AAM2C;AAMM;AAMJ;AAME;AAMA;AAMI;AAMI;AAOvD;AF9EmD;AACA;AG1GmB;AACnB,EAAA;AACrD;AH4GqD;AACA;AIvDI;AAkBqB;AACnD,EAAA;AAC3B;AAiCwB;AACO,EAAA;AAEzB,IAAA;AAGS,IAAA;AAGc,MAAA;AACzB,IAAA;AAGO,IAAA;AACkB,MAAA;AACzB,IAAA;AACF,EAAA;AACO,EAAA;AACT;AAaoD;AACf,EAAA;AACrC;AAesD;AACX,EAAA;AAEhB,EAAA;AAChB,IAAA;AACT,EAAA;AAG4C,EAAA;AACwB,IAAA;AACrB,IAAA;AAC7B,MAAA;AAChB,IAAA;AAG4B,IAAA;AACW,MAAA;AACvC,IAAA;AAEO,IAAA;AACT,EAAA;AAE8C,EAAA;AAClB,IAAA;AAC5B,EAAA;AAEO,EAAA;AACT;AAc8C;AACZ,EAAA;AACI,EAAA;AACtC;AAc+C;AACb,EAAA;AACK,EAAA;AACvC;AJ3DqD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-DISMHYXC.js","sourcesContent":[null,"// Logger utility for SDKs\n//\n// Usage:\n//   - If you pass your own Logger implementation, the SDK will use it as-is (no log level filtering or prefixing applied).\n//   - If you use ConsoleLogger, you can specify log level and prefix options.\n//   - NoOpLogger disables all logging.\n//\n// Example:\n//   const logger = new ConsoleLogger({ level: \"warn\", prefix: \"SDK\" });\n//   logger.info(\"This will not show\");\n//   logger.warn(\"This will show with prefix\");\n//\n//   // If you pass your own logger, SDK will not filter logs:\n//   const customLogger: Logger = { ... };\n//   // SDK uses customLogger as-is\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nconst logLevelOrder: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n} as const;\n\nexport interface Logger {\n  debug(message: string, ...args: unknown[]): void;\n  info(message: string, ...args: unknown[]): void;\n  warn(message: string, ...args: unknown[]): void;\n  error(message: string, ...args: unknown[]): void;\n}\n\nexport class NoOpLogger implements Logger {\n  debug(): void { /* noop */ }\n  info(): void { /* noop */ }\n  warn(): void { /* noop */ }\n  error(): void { /* noop */ }\n}\n\ninterface ConsoleLoggerOptions {\n  level: LogLevel;\n  prefix?: string;\n}\n\n/**\n * ConsoleLogger applies log level filtering and optional prefixing.\n * If you pass your own Logger, the SDK will not apply log level filtering or prefixing.\n */\nexport class ConsoleLogger implements Logger {\n  private level: LogLevel;\n  private prefix?: string;\n\n  constructor(options: ConsoleLoggerOptions = { level: \"warn\" }) {\n    this.level = options.level;\n    this.prefix = options.prefix;\n  }\n\n  private shouldLog(level: LogLevel): boolean {\n    return logLevelOrder[level] >= logLevelOrder[this.level];\n  }\n\n  private format(message: string): string {\n    return this.prefix ? `[${this.prefix}] ${message}` : message;\n  }\n\n  debug(message: string, ...args: unknown[]): void {\n    if (this.shouldLog(\"debug\")) console.debug(this.format(message), ...args);\n  }\n  info(message: string, ...args: unknown[]): void {\n    if (this.shouldLog(\"info\")) console.info(this.format(message), ...args);\n  }\n  warn(message: string, ...args: unknown[]): void {\n    if (this.shouldLog(\"warn\")) console.warn(this.format(message), ...args);\n  }\n  error(message: string, ...args: unknown[]): void {\n    if (this.shouldLog(\"error\")) console.error(this.format(message), ...args);\n  }\n}\n","/*\n  This file contains the semantic conventions for attributes either owned by LangWatch, or\n  which are no yet part of the OpenTelemetry semantic conventions for Gen AI.\n\n  Any that are not yet part of the OpenTelemetry semantic conventions for Gen AI are\n  marked with an UNSTABLE_ prefix.\n*/\n\n/**\n * LangWatch input data attribute key\n * Used to store the input data for a span or event\n */\nexport const ATTR_LANGWATCH_INPUT = \"langwatch.input\";\n\n/**\n * LangWatch output data attribute key\n * Used to store the output data for a span or event\n */\nexport const ATTR_LANGWATCH_OUTPUT = \"langwatch.output\";\n\n/**\n * LangWatch span type attribute key\n * Used to identify the type of span being traced\n */\nexport const ATTR_LANGWATCH_SPAN_TYPE = \"langwatch.span.type\";\n\n/**\n * LangWatch RAG contexts attribute key\n * Used to store retrieval-augmented generation contexts\n */\nexport const ATTR_LANGWATCH_RAG_CONTEXTS = \"langwatch.contexts\";\n\n/**\n * LangWatch metrics attribute key\n * Used to store custom metrics data\n */\nexport const ATTR_LANGWATCH_METRICS = \"langwatch.metrics\";\n\n/**\n * LangWatch SDK version attribute key\n * Used to track the version of the LangWatch SDK being used\n */\nexport const ATTR_LANGWATCH_SDK_VERSION = \"langwatch.sdk.version\";\n\n/**\n * LangWatch SDK name attribute key\n * Used to identify the LangWatch SDK implementation\n */\nexport const ATTR_LANGWATCH_SDK_NAME = \"langwatch.sdk.name\";\n\n/**\n * LangWatch SDK language attribute key\n * Used to identify the programming language of the SDK\n */\nexport const ATTR_LANGWATCH_SDK_LANGUAGE = \"langwatch.sdk.language\";\n\n/**\n * LangWatch timestamps attribute key\n * Used to store timing information for events\n */\nexport const ATTR_LANGWATCH_TIMESTAMPS = \"langwatch.timestamps\";\n\n/**\n * LangWatch custom evaluation attribute key\n * Used to store custom evaluation data\n */\nexport const ATTR_LANGWATCH_EVALUATION_CUSTOM = \"langwatch.evaluation.custom\";\n\n/**\n * LangWatch parameters attribute key\n * Used to store parameter data for operations\n */\nexport const ATTR_LANGWATCH_PARAMS = \"langwatch.params\";\n\n/**\n * LangWatch customer ID attribute key\n * Used to identify the customer associated with the trace\n */\nexport const ATTR_LANGWATCH_CUSTOMER_ID = \"langwatch.customer.id\";\n\n/**\n * LangWatch thread ID attribute key\n * Used to group related operations within a conversation thread\n */\nexport const ATTR_LANGWATCH_THREAD_ID = \"langwatch.thread.id\";\n\n/**\n * LangWatch user ID attribute key\n * Used to store the user ID for a span or event\n */\nexport const ATTR_LANGWATCH_USER_ID = \"langwatch.user.id\";\n\n/**\n * LangWatch tags attribute key\n * Used to store tags for a span or event\n */\nexport const ATTR_LANGWATCH_TAGS = \"langwatch.tags\";\n\n/**\n * LangWatch streaming attribute key\n * Used to indicate if the operation involves streaming\n */\nexport const ATTR_LANGWATCH_STREAMING = \"langwatch.gen_ai.streaming\";\n\n/**\n * LangWatch prompt ID attribute key\n * Used to identify the specific prompt being used\n */\nexport const ATTR_LANGWATCH_PROMPT_ID = \"langwatch.prompt.id\";\n\n/**\n * LangWatch prompt ID attribute key\n * Used to identify the specific prompt being used\n */\nexport const ATTR_LANGWATCH_PROMPT_HANDLE = \"langwatch.prompt.handle\";\n\n/**\n * LangWatch prompt version ID attribute key\n * Used to identify the specific version of a prompt\n */\nexport const ATTR_LANGWATCH_PROMPT_VERSION_ID = \"langwatch.prompt.version.id\";\n\n/**\n * LangWatch prompt variables attribute key\n * Used to store variables used in prompt templates\n */\nexport const ATTR_LANGWATCH_PROMPT_VARIABLES = \"langwatch.prompt.variables\";\n\n/**\n * LangWatch prompt selected ID attribute key\n * Used to identify which prompt was selected from a set\n */\nexport const ATTR_LANGWATCH_PROMPT_SELECTED_ID = \"langwatch.prompt.selected.id\";\n\n/**\n * LangWatch prompt version number attribute key\n * Used to track the version number of a prompt\n */\nexport const ATTR_LANGWATCH_PROMPT_VERSION_NUMBER =\n  \"langwatch.prompt.version.number\";\n\n/**\n * LangWatch LangChain tags attribute key\n * Used to store tags associated with LangChain operations\n */\nexport const ATTR_LANGWATCH_LANGCHAIN_TAGS = \"langwatch.langchain.tags\";\n\n/**\n * LangWatch LangChain event name attribute key\n * Used to identify the specific LangChain event type\n */\nexport const ATTR_LANGWATCH_LANGCHAIN_EVENT_NAME = \"langwatch.langchain.event_name\";\n\n/**\n * LangWatch LangChain run ID attribute key\n * Used to identify a specific LangChain run\n */\nexport const ATTR_LANGWATCH_LANGCHAIN_RUN_ID = \"langwatch.langchain.run.id\";\n\n/**\n * LangWatch LangChain run tags attribute key\n * Used to store tags associated with a LangChain run\n */\nexport const ATTR_LANGWATCH_LANGCHAIN_RUN_TAGS = \"langwatch.langchain.run.tags\";\n\n/**\n * LangWatch LangChain run type attribute key\n * Used to identify the type of LangChain run\n */\nexport const ATTR_LANGWATCH_LANGCHAIN_RUN_TYPE = \"langwatch.langchain.run.type\";\n\n/**\n * LangWatch LangChain run metadata attribute key\n * Used to store metadata associated with a LangChain run\n */\nexport const ATTR_LANGWATCH_LANGCHAIN_RUN_METADATA = \"langwatch.langchain.run.metadata\";\n\n/**\n * LangWatch LangChain run extra parameters attribute key\n * Used to store additional parameters for a LangChain run\n */\nexport const ATTR_LANGWATCH_LANGCHAIN_RUN_EXTRA_PARAMS = \"langwatch.langchain.run.extra_params\";\n\n/**\n * LangWatch LangChain run parent ID attribute key\n * Used to identify the parent run in a hierarchical structure\n */\nexport const ATTR_LANGWATCH_LANGCHAIN_RUN_PARENT_ID =\n  \"langwatch.langchain.run.parent.id\";\n","import { type DataCaptureMode } from \"./types\";\n\n/**\n * Validates a data capture mode.\n */\nexport function validateDataCaptureMode(mode: DataCaptureMode): boolean {\n  return [\"none\", \"input\", \"output\", \"all\"].includes(mode);\n}\n","import { type Logger, NoOpLogger } from \"../logger/index.js\";\nimport {\n  type DataCaptureMode,\n  type DataCaptureContext,\n  type DataCaptureOptions,\n} from \"./features/data-capture/types.js\";\nimport { validateDataCaptureMode } from \"./features/data-capture/utils.js\";\n\n/**\n * @module observability/config\n * @description\n * Provides configuration management for the LangWatch Observability SDK, including logger and data capture settings.\n *\n * @remarks\n * This module allows you to initialize, retrieve, and reset the global observability configuration. It also provides utilities for determining data capture behavior based on context and configuration.\n *\n * @see {@link ObservabilityConfig}\n * @see {@link initializeObservabilitySdkConfig}\n * @see {@link getObservabilitySdkConfig}\n * @see {@link resetObservabilitySdkConfig}\n * @see {@link getDataCaptureMode}\n * @see {@link shouldCaptureInput}\n * @see {@link shouldCaptureOutput}\n */\n/**\n * Configuration options for the LangWatch Observability SDK.\n *\n * @property logger - The logger instance to use for SDK logging.\n * @property dataCapture - Configuration for automatic data capture. Can be a string, function, or object.\n *\n * @example\n * ```ts\n * import { ObservabilityConfig, initializeObservabilitySdkConfig } from \"@langwatch/observability\";\n *\n * const config: ObservabilityConfig = {\n *   logger: new ConsoleLogger(),\n *   dataCapture: \"all\",\n * };\n *\n * initializeObservabilitySdkConfig(config);\n * ```\n */\nexport interface ObservabilityConfig {\n  /**\n   * The logger to use for the observability SDK.\n   *\n   * @default NoOpLogger\n   */\n  logger: Logger;\n\n  /**\n   * Configuration for automatic data capture.\n   *\n   * @default \"all\"\n   */\n  dataCapture?: DataCaptureOptions;\n}\n\n/**\n * The observability SDK config.\n */\nlet observabilitySdkConfig: ObservabilityConfig | null = null;\n\n/**\n * Initializes the global observability SDK configuration.\n *\n * @param config - The configuration object to use.\n *\n * @remarks\n * This function should be called once at application startup, before using any observability features.\n *\n * @warning\n * Calling this function will intentionally overwrite any existing configuration. This is by design to allow re-initialization in dynamic or testing environments. If you call this function multiple times, the most recent configuration will take effect.\n *\n * @example\n * ```ts\n * initializeObservabilitySdkConfig({ logger: new ConsoleLogger() });\n * ```\n */\nexport function initializeObservabilitySdkConfig(config: ObservabilityConfig) {\n  observabilitySdkConfig = config;\n}\n\n/**\n * Resets the global observability SDK configuration to its initial state (`null`).\n *\n * @remarks\n * Useful for testing or re-initializing the SDK in dynamic environments.\n *\n * @example\n * ```ts\n * resetObservabilitySdkConfig();\n * ```\n */\nexport function resetObservabilitySdkConfig() {\n  observabilitySdkConfig = null;\n}\n\n/**\n * Retrieves the current observability SDK configuration.\n *\n * @param options - Optional settings.\n * @param options.throwOnUninitialized - If true, throws an error if the config is not initialized. Defaults to `false` unless `NODE_ENV` is `development`.\n * @returns The current {@link ObservabilityConfig}.\n *\n * @throws {Error} If the config is uninitialized and `throwOnUninitialized` is true or in development mode.\n *\n * @example\n * ```ts\n * const config = getObservabilitySdkConfig();\n * ```\n */\nexport function getObservabilitySdkConfig(options?: {\n  throwOnUninitialized?: boolean;\n}): ObservabilityConfig {\n  if (!observabilitySdkConfig) {\n    const message =\n      \"[LangWatch Observability SDK] Please call setupObservability() before using the Observability SDK\";\n\n    if (\n      options?.throwOnUninitialized ||\n      process.env.NODE_ENV === \"development\"\n    ) {\n      throw new Error(message);\n    }\n\n    // Use a default logger that can be configured\n    return {\n      logger: new NoOpLogger(),\n    };\n  }\n  return observabilitySdkConfig;\n}\n\n/**\n * Gets the logger instance from the current observability SDK configuration.\n *\n * @returns The configured {@link Logger} instance.\n *\n * @example\n * ```ts\n * const logger = getObservabilitySdkLogger();\n * logger.info(\"Observability initialized\");\n * ```\n */\nexport function getObservabilitySdkLogger(): Logger {\n  return getObservabilitySdkConfig().logger;\n}\n\n/**\n * Determines the effective data capture mode.\n *\n * @returns The resolved {@link DataCaptureMode} (\"all\", \"input\", or \"output\").\n *\n * @remarks\n * The mode is determined by the configuration, which can be a string, function, or object. Defaults to \"all\" if not specified.\n *\n * @example\n * ```ts\n * const mode = getDataCaptureMode();\n * ```\n */\nexport function getDataCaptureMode(): DataCaptureMode {\n  const config = getObservabilitySdkConfig();\n\n  if (!config.dataCapture) {\n    return \"all\"; // Default: capture both input and output\n  }\n\n  // Handle different config formats\n  if (typeof config.dataCapture === \"string\") {\n    const validModes: DataCaptureMode[] = [\"none\", \"input\", \"output\", \"all\"];\n    if (validModes.includes(config.dataCapture)) {\n      return config.dataCapture;\n    }\n\n\n    getObservabilitySdkLogger().warn(\n      `Invalid data capture mode: ${config.dataCapture}. Using default: \"all\"`,\n    );\n\n    return \"all\";\n  }\n\n  if (typeof config.dataCapture === \"object\" && config.dataCapture.mode &&validateDataCaptureMode(config.dataCapture.mode)) {\n    return config.dataCapture.mode;\n  }\n\n  return \"all\"; // Default fallback\n}\n\n/**\n * Determines if input data should be captured.\n *\n * @returns `true` if input should be captured, otherwise `false`.\n *\n * @example\n * ```ts\n * if (shouldCaptureInput()) {\n *   // Capture input\n * }\n * ```\n */\nexport function shouldCaptureInput(): boolean {\n  const mode = getDataCaptureMode();\n  return mode === \"input\" || mode === \"all\";\n}\n\n/**\n * Determines if output data should be captured.\n *\n * @returns `true` if output should be captured, otherwise `false`.\n *\n * @example\n * ```ts\n * if (shouldCaptureOutput()) {\n *   // Capture output\n * }\n * ```\n */\nexport function shouldCaptureOutput(): boolean {\n  const mode = getDataCaptureMode();\n  return mode === \"output\" || mode === \"all\";\n}\n"]}

package/dist/{chunk-E7UE2MPD.mjs → chunk-ECUXLXFT.mjs}

@@ -1,6 +1,6 @@
 import {
   FileManager
-} from "./chunk-3GKPQB4R.mjs";
+} from "./chunk-HUI45ULC.mjs";
 
 // src/cli/utils/init.ts
 import * as readline from "readline";
@@ -90,4 +90,4 @@ export {
   initializeProject,
   ensureProjectInitialized
 };
-//# sourceMappingURL=chunk-E7UE2MPD.mjs.map
+//# sourceMappingURL=chunk-ECUXLXFT.mjs.map