langwatch 1.19.0 → 1.20.0

package/dist/chunk-5VYEG3RS.js

@@ -0,0 +1,117 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/logger/index.ts
+var logLevelOrder = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
+};
+var NoOpLogger = class {
+  constructor() {
+    this.debug = () => {
+    };
+    this.info = () => {
+    };
+    this.warn = () => {
+    };
+    this.error = () => {
+    };
+  }
+};
+var ConsoleLogger = class {
+  constructor(options = { level: "warn" }) {
+    this.debug = (message, ...args) => {
+      if (this.shouldLog("debug")) console.debug(this.format(message), ...args);
+    };
+    this.info = (message, ...args) => {
+      if (this.shouldLog("info")) console.info(this.format(message), ...args);
+    };
+    this.warn = (message, ...args) => {
+      if (this.shouldLog("warn")) console.warn(this.format(message), ...args);
+    };
+    this.error = (message, ...args) => {
+      if (this.shouldLog("error")) console.error(this.format(message), ...args);
+    };
+    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;
+  }
+};
+
+// 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) {
+  var _a;
+  if (!observabilitySdkConfig) {
+    const message = "[LangWatch Observability SDK] Please call setupObservability() before using the Observability SDK";
+    const shouldThrow = (_a = options == null ? void 0 : options.throwOnUninitialized) != null ? _a : process.env.NODE_ENV === "development";
+    if (shouldThrow) {
+      throw new Error(message);
+    }
+    return {
+      logger: new NoOpLogger()
+    };
+  }
+  return observabilitySdkConfig;
+}
+function getObservabilitySdkLogger() {
+  return getObservabilitySdkConfig().logger;
+}
+function getDataCaptureMode() {
+  const config = getObservabilitySdkConfig({ throwOnUninitialized: false });
+  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";
+}
+
+// src/observability-sdk/semconv/otel.ts
+var ATTR_SERVICE_NAME = "service.name";
+var ATTR_GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+var ATTR_GEN_AI_RESPONSE_MODEL = "gen_ai.response.model";
+
+
+
+
+
+
+
+
+
+
+
+exports.NoOpLogger = NoOpLogger; exports.ConsoleLogger = ConsoleLogger; exports.ATTR_SERVICE_NAME = ATTR_SERVICE_NAME; exports.ATTR_GEN_AI_REQUEST_MODEL = ATTR_GEN_AI_REQUEST_MODEL; exports.ATTR_GEN_AI_RESPONSE_MODEL = ATTR_GEN_AI_RESPONSE_MODEL; exports.initializeObservabilitySdkConfig = initializeObservabilitySdkConfig; exports.getDataCaptureMode = getDataCaptureMode; exports.shouldCaptureInput = shouldCaptureInput; exports.shouldCaptureOutput = shouldCaptureOutput;
+//# sourceMappingURL=chunk-5VYEG3RS.js.map

package/dist/chunk-5VYEG3RS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/langwatch/langwatch/sdks/typescript/dist/chunk-5VYEG3RS.js","../src/logger/index.ts","../src/observability-sdk/features/data-capture/utils.ts","../src/observability-sdk/config.ts","../src/observability-sdk/semconv/otel.ts"],"names":[],"mappings":"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","file":"/home/runner/work/langwatch/langwatch/sdks/typescript/dist/chunk-5VYEG3RS.js","sourcesContent":[null,"// Logger utility for SDKs. A custom `Logger` implementation is used as-is, with no level\n// filtering or prefixing; `ConsoleLogger` applies both, and `NoOpLogger` disables logging.\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 = () => {\n    /* noop */\n  };\n  info: () => void = () => {\n    /* noop */\n  };\n  warn: () => void = () => {\n    /* noop */\n  };\n  error: () => void = () => {\n    /* noop */\n  };\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    message: string,\n    ...args: unknown[]\n  ): void => {\n    if (this.shouldLog(\"debug\")) console.debug(this.format(message), ...args);\n  };\n  info: (message: string, ...args: unknown[]) => void = (\n    message: string,\n    ...args: unknown[]\n  ): void => {\n    if (this.shouldLog(\"info\")) console.info(this.format(message), ...args);\n  };\n  warn: (message: string, ...args: unknown[]) => void = (\n    message: string,\n    ...args: unknown[]\n  ): void => {\n    if (this.shouldLog(\"warn\")) console.warn(this.format(message), ...args);\n  };\n  error: (message: string, ...args: unknown[]) => void = (\n    message: string,\n    ...args: unknown[]\n  ): void => {\n    if (this.shouldLog(\"error\")) console.error(this.format(message), ...args);\n  };\n}\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 { type DataCaptureMode, type DataCaptureOptions } from \"./features/data-capture/types.js\";\nimport { validateDataCaptureMode } from \"./features/data-capture/utils.js\";\n\n/**\n * @module observability/config\n * Configuration management for the LangWatch Observability SDK: logger and\n * data capture settings, plus utilities to derive capture behavior from them.\n */\n\n/**\n * Configuration options for the LangWatch Observability SDK.\n * @property logger - The logger instance to use for SDK logging.\n * @property dataCapture - Config for automatic data capture (string, function, or object).\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. Intentionally\n * overwrites any existing config, by design, so tests can re-initialize.\n *\n * @param config - The configuration object to use.\n */\nexport function initializeObservabilitySdkConfig(config: ObservabilityConfig) {\n  observabilitySdkConfig = config;\n}\n\n/**\n * Resets the global observability SDK configuration to its initial state\n * (`null`). Useful for testing or re-initializing dynamically.\n */\nexport function resetObservabilitySdkConfig() {\n  observabilitySdkConfig = null;\n}\n\n/**\n * Retrieves the current observability SDK configuration.\n * @param options.throwOnUninitialized - Throws when uninitialized, defaulting to development mode.\n * @returns The current {@link ObservabilityConfig}.\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    const shouldThrow = options?.throwOnUninitialized ?? process.env.NODE_ENV === \"development\";\n    if (shouldThrow) {\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 * @returns The configured {@link Logger} instance.\n */\nexport function getObservabilitySdkLogger(): Logger {\n  return getObservabilitySdkConfig().logger;\n}\n\n/**\n * Determines the effective data capture mode from config (string, function,\n * or object), defaulting to \"all\" when unspecified.\n * @returns The resolved {@link DataCaptureMode} (\"all\", \"input\", or \"output\").\n */\nexport function getDataCaptureMode(): DataCaptureMode {\n  // A passive read on the tracing path: code that only asks \"may I record\n  // this value?\" must never crash the operation it decorates, so an\n  // uninitialized SDK falls back to the default config even in development.\n  const config = getObservabilitySdkConfig({ throwOnUninitialized: false });\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    getObservabilitySdkLogger().warn(\n      `Invalid data capture mode: ${config.dataCapture}. Using default: \"all\"`,\n    );\n\n    return \"all\";\n  }\n\n  if (\n    typeof config.dataCapture === \"object\" &&\n    config.dataCapture.mode &&\n    validateDataCaptureMode(config.dataCapture.mode)\n  ) {\n    return config.dataCapture.mode;\n  }\n\n  return \"all\"; // Default fallback\n}\n\n/**\n * Determines if input data should be captured.\n * @returns `true` if input should be captured, otherwise `false`.\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 * @returns `true` if output should be captured, otherwise `false`.\n */\nexport function shouldCaptureOutput(): boolean {\n  const mode = getDataCaptureMode();\n  return mode === \"output\" || mode === \"all\";\n}\n","/*\n  The few stable OpenTelemetry attribute names this SDK writes itself, kept\n  local so the 11 MB semantic-conventions package is not a dependency.\n*/\n\nexport const ATTR_SERVICE_NAME = \"service.name\";\nexport const ATTR_GEN_AI_REQUEST_MODEL = \"gen_ai.request.model\";\nexport const ATTR_GEN_AI_RESPONSE_MODEL = \"gen_ai.response.model\";\n"]}