langwatch 0.5.1 → 0.6.0

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-import { L as Logger, C as ConsoleLogger, N as NoOpLogger } from './index-DTEZr0Jn.js';
-export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, S as SpanProcessingExcludeRule, g as getLangWatchLogger, d as getLangWatchTracer } from './implementation-BIlL6-SW.js';
+import { L as Logger, C as ConsoleLogger, N as NoOpLogger } from './index-D7rKIGrO.js';
+export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, S as SpanProcessingExcludeRule, g as getLangWatchLogger, d as getLangWatchTracer } from './implementation-DsHp9FYU.js';
 export { l as attributes } from './types-DRiQaKFG.js';
-import { p as paths, P as PromptResponse, g as Prompt } from './types-DyUmlaDx.js';
+import { p as paths, P as PromptResponse, g as CreatePromptBody, U as UpdatePromptBody, h as PromptData, i as Prompt } from './types-B9772cUR.js';
 import openApiCreateClient from 'openapi-fetch';
+import { z } from 'zod';
 import '@opentelemetry/sdk-trace-base';
 import '@opentelemetry/exporter-trace-otlp-http';
 import '@opentelemetry/api-logs';
@@ -10,16 +11,20 @@ import '@opentelemetry/api';
 import '@opentelemetry/semantic-conventions';
 import '@opentelemetry/semantic-conventions/incubating';
 
-type LangwatchApiClient = ReturnType<typeof openApiCreateClient<paths>>;
+/**
+ * Creates a new LangWatch API client.
+ * @param apiKey - The API key to use for authentication. Defaults to LANGWATCH_API_KEY environment variable.
+ * @param endpoint - The endpoint to use for the API client. Defaults to LANGWATCH_ENDPOINT environment variable or internal DEFAULT_ENDPOINT.
+ * @returns A new LangWatch API client.
+ */
+declare const createLangWatchApiClient: (apiKey?: string, endpoint?: string) => openApiCreateClient.Client<paths, `${string}/${string}`>;
+type LangwatchApiClient = ReturnType<typeof createLangWatchApiClient>;
 
 interface InternalConfig {
     langwatchApiClient: LangwatchApiClient;
     logger: Logger;
 }
 
-type CreatePromptBody = NonNullable<paths["/api/prompts"]["post"]["requestBody"]>["content"]["application/json"];
-type UpdatePromptBody = NonNullable<paths["/api/prompts/{id}"]["put"]["requestBody"]>["content"]["application/json"];
-
 type SyncAction = "created" | "updated" | "conflict" | "up_to_date";
 type ConfigData = NonNullable<paths["/api/prompts/{id}/sync"]["post"]["requestBody"]>["content"]["application/json"]["configData"];
 interface SyncResult {
@@ -32,15 +37,255 @@ interface SyncResult {
         remoteConfigData: ConfigData;
     };
 }
+/**
+ * Service for managing prompt resources via the Langwatch API.
+ * Constructor creates a proxy that wraps the service and traces all methods.
+ *
+ * Responsibilities:
+ * - CRUD operations for prompts
+ * - Creating prompt versions
+ * - Error handling with contextual information
+ *
+ * All methods return raw PromptResponse data from the API.
+ */
+declare class PromptsApiService {
+    private readonly apiClient;
+    constructor(config?: Pick<InternalConfig, "langwatchApiClient">);
+    /**
+     * Handles API errors by throwing a PromptsError with operation context.
+     * @param operation Description of the operation being performed.
+     * @param error The error object returned from the API client.
+     * @throws {PromptsError}
+     */
+    private handleApiError;
+    /**
+     * Fetches all prompts from the API.
+     * @returns Array of raw PromptResponse data.
+     * @throws {PromptsError} If the API call fails.
+     */
+    getAll(): Promise<PromptResponse[]>;
+    /**
+     * Fetches a single prompt by its ID.
+     * @param id The prompt's unique identifier.
+     * @returns Raw PromptResponse data.
+     * @throws {PromptsError} If the API call fails.
+     */
+    get: (id: string, options?: {
+        version?: string;
+    }) => Promise<PromptResponse>;
+    /**
+     * Validates if a prompt exists.
+     * @param id The prompt's unique identifier.
+     * @returns True if prompt exists, false otherwise.
+     * @throws {PromptsError} If the API call fails (not 404).
+     */
+    exists(id: string): Promise<boolean>;
+    /**
+     * Creates a new prompt.
+     * @param params The prompt creation payload, matching the OpenAPI schema.
+     * @returns Raw PromptResponse data of the created prompt.
+     * @throws {PromptsError} If the API call fails.
+     */
+    create(params: CreatePromptBody): Promise<PromptResponse>;
+    /**
+     * Updates an existing prompt.
+     * @param id The prompt's unique identifier.
+     * @param params The update payload, matching the OpenAPI schema.
+     * @returns Raw PromptResponse data of the updated prompt.
+     * @throws {PromptsError} If the API call fails.
+     */
+    update(id: string, params: UpdatePromptBody): Promise<PromptResponse>;
+    /**
+     * Deletes a prompt by its ID.
+     * @param id The prompt's unique identifier.
+     * @throws {PromptsError} If the API call fails.
+     */
+    delete(id: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Fetches all versions for a given prompt.
+     * @param id The prompt's unique identifier.
+     * @returns Array of raw PromptResponse data for each version.
+     * @throws {PromptsError} If the API call fails.
+     */
+    getVersions(id: string): Promise<PromptResponse[]>;
+    /**
+     * Upserts a prompt with local configuration - creates if doesn't exist, updates version if exists.
+     * @param handle The prompt's handle/identifier.
+     * @param config Local prompt configuration.
+     * @returns Object with created flag and raw PromptResponse data.
+     * @throws {PromptsError} If the API call fails.
+     */
+    upsert(handle: string, config: {
+        model: string;
+        modelParameters?: {
+            temperature?: number;
+            max_tokens?: number;
+        };
+        messages: Array<{
+            role: "system" | "user" | "assistant";
+            content: string;
+        }>;
+    }): Promise<{
+        created: boolean;
+        prompt: PromptResponse;
+    }>;
+    /**
+     * Sync a prompt with local content, handling conflicts and version management
+     */
+    sync(params: {
+        name: string;
+        configData: ConfigData;
+        localVersion?: number;
+        commitMessage?: string;
+    }): Promise<SyncResult>;
+}
+
+type PromptDependency = string | {
+    version?: string;
+    file?: string;
+};
+type PromptsConfig = {
+    prompts: Record<string, PromptDependency>;
+};
+declare const localPromptConfigSchema: z.ZodObject<{
+    model: z.ZodString;
+    modelParameters: z.ZodOptional<z.ZodObject<{
+        temperature: z.ZodOptional<z.ZodNumber>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            system: "system";
+            user: "user";
+            assistant: "assistant";
+        }>;
+        content: z.ZodString;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+type LocalPromptConfig = z.infer<typeof localPromptConfigSchema>;
+type MaterializedPrompt = {
+    id: string;
+    name: string;
+    version: number;
+    versionId: string;
+    model: string;
+    messages: Array<{
+        role: "system" | "user" | "assistant";
+        content: string;
+    }>;
+    prompt: string;
+    temperature?: number;
+    maxTokens?: number;
+    inputs?: any;
+    outputs?: any;
+    updatedAt: string;
+};
+type PromptsLockEntry = {
+    version: number;
+    versionId: string;
+    materialized: string;
+};
+type PromptsLock = {
+    lockfileVersion: number;
+    prompts: Record<string, PromptsLockEntry>;
+};
+
+declare class FileManager {
+    private static readonly PROMPTS_CONFIG_FILE;
+    private static readonly PROMPTS_LOCK_FILE;
+    private static readonly PROMPTS_DIR;
+    private static readonly MATERIALIZED_DIR;
+    static getPromptsConfigPath(): string;
+    static getPromptsLockPath(): string;
+    static getPromptsDir(): string;
+    static getMaterializedDir(): string;
+    static ensureDirectories(): void;
+    static loadPromptsConfig(): PromptsConfig;
+    static savePromptsConfig(config: PromptsConfig): void;
+    static initializePromptsConfig(): {
+        created: boolean;
+        path: string;
+    };
+    static loadPromptsLock: () => PromptsLock;
+    static savePromptsLock(lock: PromptsLock): void;
+    static initializePromptsLock(): {
+        created: boolean;
+        path: string;
+    };
+    static loadLocalPrompt: (filePath: string) => LocalPromptConfig;
+    static saveMaterializedPrompt(name: string, prompt: MaterializedPrompt): string;
+    static getLocalPromptFiles: () => string[];
+    static promptNameFromPath(filePath: string): string;
+    static cleanupOrphanedMaterializedFiles(currentDependencies: Set<string>): string[];
+    static updateLockEntry(lock: PromptsLock, name: string, prompt: MaterializedPrompt, materializedPath: string): void;
+    static removeFromLock(lock: PromptsLock, names: string[]): void;
+    static addToGitignore(entry: string): {
+        added: boolean;
+        existed: boolean;
+    };
+}
+
+interface LocalPromptsServiceConfig {
+    fileManager?: typeof FileManager;
+    logger?: Logger;
+}
+/**
+ * Service for retrieving prompts from local filesystem sources.
+ *
+ * Searches for prompts in the following priority order:
+ * 1. Explicit file mapping in prompts.json config
+ * 2. Materialized path from prompts-lock.json
+ * 3. Direct file scanning in prompts directory
+ */
+declare class LocalPromptsService {
+    private readonly fileManager;
+    private readonly logger;
+    constructor(config?: LocalPromptsServiceConfig);
+    /**
+     * Retrieves a prompt using the configured search strategy.
+     * Tries each source in priority order until found or all sources exhausted.
+     */
+    get(handleOrId: string): Promise<PromptData | null>;
+    /**
+     * Searches for prompt using explicit file mapping in prompts.json.
+     * Looks for dependencies with a 'file' property pointing to a specific path.
+     */
+    private getFromConfig;
+    /**
+     * Searches for prompt using materialized path from lock file.
+     * Lock file contains resolved paths for prompts that have been synced/materialized.
+     */
+    private getFromLockFile;
+    /**
+     * Searches for prompt by scanning all .prompt.yaml files in prompts directory.
+     * Extracts prompt name from file path and matches against the requested handle.
+     * This is the fallback method when explicit mappings don't exist.
+     */
+    private getFromLocalFiles;
+    /**
+     * Get dependency from config
+     */
+    private getDependencyFromConfig;
+    /**
+     * Converts LocalPromptConfig to PromptData format
+     */
+    private convertToPromptData;
+}
 
+interface PromptsFacadeDependencies {
+    promptsApiService: PromptsApiService;
+    localPromptsService: LocalPromptsService;
+}
 /**
  * Facade for prompt operations in the LangWatch SDK.
  * Provides a simplified interface for common prompt management tasks.
  */
 declare class PromptsFacade {
-    private readonly service;
-    private readonly config;
-    constructor(config: InternalConfig);
+    private readonly promptsApiService;
+    private readonly localPromptsService;
+    constructor(config: InternalConfig & PromptsFacadeDependencies);
     /**
      * Creates a new prompt.
      * @param data The prompt creation payload.
@@ -115,10 +360,10 @@ interface LangWatchConstructorOptions {
 declare class LangWatch {
     #private;
     private readonly config;
-    private readonly tracer;
     readonly prompts: PromptsFacade;
     readonly traces: TracesFacade;
     constructor(options?: LangWatchConstructorOptions);
+    get apiClient(): LangwatchApiClient;
 }
 
 declare const logger: {

package/dist/index.js

@@ -1,30 +1,153 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkDSIQSULKjs = require('./chunk-DSIQSULK.js');
-require('./chunk-SVXNUWZI.js');
 
 
-var _chunkYH5TIVK2js = require('./chunk-YH5TIVK2.js');
 
 
-var _chunkECOC36EAjs = require('./chunk-ECOC36EA.js');
+var _chunkHVW45GSTjs = require('./chunk-HVW45GST.js');
 
 
+var _chunkSNDTNU3Tjs = require('./chunk-SNDTNU3T.js');
 
-var _chunkP4SQTYGNjs = require('./chunk-P4SQTYGN.js');
-require('./chunk-QCYYSMCU.js');
 
+var _chunkJ7B7BNDNjs = require('./chunk-J7B7BNDN.js');
 
 
 
-var _chunkDISMHYXCjs = require('./chunk-DISMHYXC.js');
-require('./chunk-R6FBJN7K.js');
-require('./chunk-OXBO24RB.js');
+var _chunk2GYC6KEAjs = require('./chunk-2GYC6KEA.js');
+
+
+
+
+var _chunkZ3NTWVVAjs = require('./chunk-Z3NTWVVA.js');
+
+
+
+
+var _chunkCKIZDPIJjs = require('./chunk-CKIZDPIJ.js');
+require('./chunk-36XAYVMC.js');
+require('./chunk-AZHZ4NB4.js');
+
+
+
+
+
+
+var _chunkOHM7JUMRjs = require('./chunk-OHM7JUMR.js');
+
+// src/client-sdk/services/traces/types.ts
+var TracesError = class extends Error {
+  constructor(message, operation, originalError) {
+    super(message);
+    this.operation = operation;
+    this.originalError = originalError;
+    this.name = "TracesError";
+  }
+};
+
+// src/client-sdk/services/traces/tracing/tracer.ts
+var tracer = _chunkJ7B7BNDNjs.getLangWatchTracer.call(void 0, `${_chunkZ3NTWVVAjs.LANGWATCH_SDK_NAME_CLIENT}.traces`, _chunkZ3NTWVVAjs.LANGWATCH_SDK_VERSION);
+
+// src/client-sdk/services/traces/service.ts
+var TracesService = class {
+  constructor(config) {
+    this.config = config;
+    return _chunkHVW45GSTjs.createTracingProxy.call(void 0, 
+      this,
+      tracer
+    );
+  }
+  /**
+   * Handles API errors by throwing a TracesError with operation context.
+   * @param operation Description of the operation being performed.
+   * @param error The error object returned from the API client.
+   * @throws {TracesError}
+   */
+  handleApiError(operation, error) {
+    var _a, _b;
+    const errorMessage = typeof error === "string" ? error : (_b = (_a = error == null ? void 0 : error.error) != null ? _a : error == null ? void 0 : error.message) != null ? _b : "Unknown error occurred";
+    throw new TracesError(
+      `Failed to ${operation}: ${errorMessage}`,
+      operation,
+      error
+    );
+  }
+  /**
+   * Retrieves a trace by its ID.
+   * @param traceId The trace's unique identifier.
+   * @param params Optional parameters for the request.
+   * @returns The trace response object.
+   * @throws {TracesError} If the API call fails.
+   */
+  async get(traceId, params) {
+    const { data, error } = await this.config.langwatchApiClient.GET("/api/trace/{id}", {
+      params: {
+        path: {
+          id: traceId
+        }
+      },
+      query: params
+    });
+    if (error) {
+      this.handleApiError("get trace", error);
+    }
+    return data;
+  }
+};
+
+// src/client-sdk/services/traces/facade.ts
+var _service;
+var TracesFacade = class {
+  constructor(config) {
+    _chunkOHM7JUMRjs.__privateAdd.call(void 0, this, _service);
+    _chunkOHM7JUMRjs.__privateSet.call(void 0, this, _service, new TracesService(config));
+  }
+  async get(traceId, params) {
+    return _chunkOHM7JUMRjs.__privateGet.call(void 0, this, _service).get(traceId, params);
+  }
+};
+_service = new WeakMap();
+
+// src/client-sdk/index.ts
+var _LangWatch_instances, createInternalConfig_fn;
+var LangWatch = class {
+  constructor(options = {}) {
+    _chunkOHM7JUMRjs.__privateAdd.call(void 0, this, _LangWatch_instances);
+    var _a, _b, _c, _d;
+    const apiKey = (_b = (_a = options.apiKey) != null ? _a : process.env.LANGWATCH_API_KEY) != null ? _b : "";
+    const endpoint = (_d = (_c = options.endpoint) != null ? _c : process.env.LANGWATCH_ENDPOINT) != null ? _d : _chunkZ3NTWVVAjs.DEFAULT_ENDPOINT;
+    this.config = _chunkOHM7JUMRjs.__privateMethod.call(void 0, this, _LangWatch_instances, createInternalConfig_fn).call(this, {
+      apiKey,
+      endpoint,
+      options: options.options
+    });
+    this.prompts = new (0, _chunkHVW45GSTjs.PromptsFacade)(_chunkOHM7JUMRjs.__spreadValues.call(void 0, {
+      promptsApiService: new (0, _chunkHVW45GSTjs.PromptsApiService)(this.config),
+      localPromptsService: new (0, _chunkHVW45GSTjs.LocalPromptsService)()
+    }, this.config));
+    this.traces = new TracesFacade(this.config);
+  }
+  get apiClient() {
+    return this.config.langwatchApiClient;
+  }
+};
+_LangWatch_instances = new WeakSet();
+createInternalConfig_fn = function({
+  apiKey,
+  endpoint,
+  options
+}) {
+  var _a;
+  return {
+    logger: (_a = options == null ? void 0 : options.logger) != null ? _a : new (0, _chunkCKIZDPIJjs.NoOpLogger)(),
+    langwatchApiClient: _chunkHVW45GSTjs.createLangWatchApiClient.call(void 0, apiKey, endpoint)
+  };
+};
 
 // src/index.ts
 var logger = {
-  ConsoleLogger: _chunkDISMHYXCjs.ConsoleLogger,
-  NoOpLogger: _chunkDISMHYXCjs.NoOpLogger
+  ConsoleLogger: _chunkCKIZDPIJjs.ConsoleLogger,
+  NoOpLogger: _chunkCKIZDPIJjs.NoOpLogger
 };
 
 
@@ -34,5 +157,5 @@ var logger = {
 
 
 
-exports.FilterableBatchSpanProcessor = _chunkYH5TIVK2js.FilterableBatchSpanProcessor; exports.LangWatch = _chunkDSIQSULKjs.LangWatch; exports.LangWatchExporter = _chunkP4SQTYGNjs.LangWatchTraceExporter; exports.attributes = _chunkDISMHYXCjs.attributes_exports; exports.getLangWatchLogger = _chunkP4SQTYGNjs.getLangWatchLogger; exports.getLangWatchTracer = _chunkECOC36EAjs.getLangWatchTracer; exports.logger = logger;
+exports.FilterableBatchSpanProcessor = _chunkSNDTNU3Tjs.FilterableBatchSpanProcessor; exports.LangWatch = LangWatch; exports.LangWatchExporter = _chunk2GYC6KEAjs.LangWatchTraceExporter; exports.attributes = _chunkCKIZDPIJjs.attributes_exports; exports.getLangWatchLogger = _chunk2GYC6KEAjs.getLangWatchLogger; exports.getLangWatchTracer = _chunkJ7B7BNDNjs.getLangWatchTracer; exports.logger = logger;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/index.js","../src/index.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B;AACE;AACA;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B;AACE;AACA;AACA;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B;AACA;ACRO,IAAM,OAAA,EAAS;AAAA,EACpB,6CAAA;AAAA,EACA;AACF,CAAA;ADUA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACF,iaAAC","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/index.js","sourcesContent":[null,"import { ConsoleLogger, NoOpLogger } from \"./logger\";\n\nexport {\n  getLangWatchTracer,\n  getLangWatchLogger,\n  attributes,\n} from \"./observability-sdk\";\n\nexport {\n  FilterableBatchSpanProcessor,\n  type SpanProcessingExcludeRule,\n} from \"./observability-sdk/processors\";\nexport { LangWatchExporter } from \"./observability-sdk/exporters\";\nexport { LangWatch } from \"./client-sdk\";\n\nexport const logger = {\n  ConsoleLogger,\n  NoOpLogger,\n};\n"]}
+{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/index.js","../src/client-sdk/services/traces/types.ts","../src/client-sdk/services/traces/tracing/tracer.ts","../src/client-sdk/services/traces/service.ts","../src/client-sdk/services/traces/facade.ts","../src/client-sdk/index.ts","../src/index.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B;AACE;AACF,sDAA4B;AAC5B;AACE;AACA;AACF,sDAA4B;AAC5B;AACE;AACA;AACA;AACF,sDAA4B;AAC5B;AACE;AACA;AACA;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B,+BAA4B;AAC5B;AACE;AACA;AACA;AACA;AACA;AACF,sDAA4B;AAC5B;AACA;ACvBO,IAAM,YAAA,EAAN,MAAA,QAA0B,MAAM;AAAA,EACrC,WAAA,CACE,OAAA,EACgB,SAAA,EACA,aAAA,EAChB;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAHG,IAAA,IAAA,CAAA,UAAA,EAAA,SAAA;AACA,IAAA,IAAA,CAAA,cAAA,EAAA,aAAA;AAGhB,IAAA,IAAA,CAAK,KAAA,EAAO,aAAA;AAAA,EACd;AACF,CAAA;ADuBA;AACA;AE5CO,IAAM,OAAA,EAAS,iDAAA,CAAmB,EAAA;AF8CR;AACA;AGnCN;AAGW,EAAA;AACpB,IAAA;AAKP,IAAA;AACL,MAAA;AACA,MAAA;AACF,IAAA;AACF,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQ0C,EAAA;AApC5C,IAAA;AAsCa,IAAA;AAGC,IAAA;AACmB,MAAA;AAC3B,MAAA;AACA,MAAA;AACF,IAAA;AACF,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAY6B,EAAA;AACH,IAAA;AACd,MAAA;AACA,QAAA;AACA,UAAA;AACN,QAAA;AACF,MAAA;AACO,MAAA;AACR,IAAA;AAEU,IAAA;AACW,MAAA;AACtB,IAAA;AAEO,IAAA;AACT,EAAA;AACF;AHsBiC;AACA;AIjGjC;AAI0B;AAGY,EAAA;AAF3B,IAAA;AAGS,IAAA;AAClB,EAAA;AAE+E,EAAA;AACjE,IAAA;AACd,EAAA;AACF;AATW;AJwGsB;AACA;AK9GjC;AAgBuB;AAMkC,EAAA;AANlD,IAAA;AAhBP,IAAA;AAuBmB,IAAA;AACE,IAAA;AAEH,IAAA;AACZ,MAAA;AACA,MAAA;AACiB,MAAA;AACnB,IAAA;AAEmB,IAAA;AACM,MAAA;AACE,MAAA;AAE1B,IAAA;AACiB,IAAA;AACpB,EAAA;AAEoC,EAAA;AACf,IAAA;AACrB,EAAA;AAgBF;AA1CO;AA4BgB;AACnB,EAAA;AACA,EAAA;AACA,EAAA;AAKiB;AApDrB,EAAA;AAqDW,EAAA;AACG,IAAA;AACY,IAAA;AACtB,EAAA;AACF;ALwF+B;AACA;AMnIX;AACpB,EAAA;AACA,EAAA;AACF;ANqIiC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/index.js","sourcesContent":[null,"import type { paths } from \"@/internal/generated/openapi/api-client\";\n\nexport interface GetTraceParams {\n  includeSpans?: boolean;\n}\n\nexport type GetTraceResponse = NonNullable<\n  paths[\"/api/trace/{id}\"][\"get\"][\"responses\"][\"200\"][\"content\"][\"application/json\"]\n>;\n\n/**\n * Custom error class for Traces API operations.\n * Provides context about the failed operation and the original error.\n */\nexport class TracesError extends Error {\n  constructor(\n    message: string,\n    public readonly operation: string,\n    public readonly originalError?: any,\n  ) {\n    super(message);\n    this.name = \"TracesError\";\n  }\n}\n","import { LANGWATCH_SDK_NAME_CLIENT, LANGWATCH_SDK_VERSION } from \"@/internal/constants\";\nimport { getLangWatchTracer } from \"@/observability-sdk/tracer\";\n\nexport const tracer = getLangWatchTracer(`${LANGWATCH_SDK_NAME_CLIENT}.traces`, LANGWATCH_SDK_VERSION);\n","import { createTracingProxy } from \"@/client-sdk/tracing/create-tracing-proxy\";\nimport { type InternalConfig } from \"@/client-sdk/types\";\nimport { type GetTraceParams, TracesError, type GetTraceResponse } from \"./types\";\nimport { tracer } from \"./tracing\";\n\n/**\n * Service for managing trace resources via the Langwatch API.\n * Constructor creates a proxy that wraps the service and traces all methods.\n *\n * Responsibilities:\n * - Retrieving trace data\n * - Error handling with contextual information\n *\n * All methods return trace response objects directly.\n */\nexport class TracesService {\n  private config: InternalConfig;\n\n  constructor(config: InternalConfig) {\n    this.config = config;\n\n    /**\n     * Wraps the service in a tracing proxy via the decorator.\n     */\n    return createTracingProxy(\n      this as TracesService,\n      tracer,\n    );\n  }\n\n  /**\n   * Handles API errors by throwing a TracesError with operation context.\n   * @param operation Description of the operation being performed.\n   * @param error The error object returned from the API client.\n   * @throws {TracesError}\n   */\n  private handleApiError(operation: string, error: any): never {\n    const errorMessage =\n      typeof error === \"string\"\n        ? error\n        : error?.error ?? error?.message ?? \"Unknown error occurred\";\n    throw new TracesError(\n      `Failed to ${operation}: ${errorMessage}`,\n      operation,\n      error,\n    );\n  }\n\n  /**\n   * Retrieves a trace by its ID.\n   * @param traceId The trace's unique identifier.\n   * @param params Optional parameters for the request.\n   * @returns The trace response object.\n   * @throws {TracesError} If the API call fails.\n   */\n  async get(\n    traceId: string,\n    params?: GetTraceParams,\n  ): Promise<GetTraceResponse> {\n    const { data, error } = await this.config.langwatchApiClient.GET(\"/api/trace/{id}\", {\n      params: {\n        path: {\n          id: traceId,\n        },\n      },\n      query: params,\n    });\n\n    if (error) {\n      this.handleApiError(\"get trace\", error);\n    }\n\n    return data;\n  }\n}\n","import { type InternalConfig } from \"../../types\";\nimport { TracesService } from \"./service\";\nimport { type GetTraceParams, type GetTraceResponse } from \"./types\";\n\nexport class TracesFacade {\n  readonly #service: TracesService;\n\n  constructor(config: InternalConfig) {\n    this.#service = new TracesService(config);\n  }\n\n  async get(traceId: string, params?: GetTraceParams): Promise<GetTraceResponse> {\n    return this.#service.get(traceId, params);\n  }\n}\n","import { PromptsFacade, PromptsApiService } from \"./services/prompts\";\nimport { LocalPromptsService } from \"./services/prompts/local-prompts.service\";\nimport { type InternalConfig } from \"./types\";\nimport { createLangWatchApiClient, type LangwatchApiClient } from \"../internal/api/client\";\nimport { type Logger, NoOpLogger } from \"../logger\";\nimport { TracesFacade } from \"./services/traces/facade\";\nimport { DEFAULT_ENDPOINT } from \"@/internal/constants\";\n\nexport interface LangWatchConstructorOptions {\n  apiKey?: string;\n  endpoint?: string;\n  options?: {\n    logger?: Logger;\n  };\n}\n\nexport class LangWatch {\n  private readonly config: InternalConfig;\n\n  readonly prompts: PromptsFacade;\n  readonly traces: TracesFacade;\n\n  constructor(options: LangWatchConstructorOptions = {}) {\n    const apiKey = options.apiKey ?? process.env.LANGWATCH_API_KEY ?? \"\";\n    const endpoint = options.endpoint ?? process.env.LANGWATCH_ENDPOINT ?? DEFAULT_ENDPOINT;\n\n    this.config = this.#createInternalConfig({\n      apiKey,\n      endpoint,\n      options: options.options,\n    });\n\n    this.prompts = new PromptsFacade({\n      promptsApiService: new PromptsApiService(this.config),\n      localPromptsService: new LocalPromptsService(),\n      ...this.config,\n    });\n    this.traces = new TracesFacade(this.config);\n  }\n\n  get apiClient(): LangwatchApiClient {\n    return this.config.langwatchApiClient;\n  }\n\n  #createInternalConfig({\n    apiKey,\n    endpoint,\n    options,\n  }: {\n    apiKey: string;\n    endpoint: string;\n    options?: LangWatchConstructorOptions[\"options\"];\n  }): InternalConfig {\n    return {\n      logger: options?.logger ?? new NoOpLogger(),\n      langwatchApiClient: createLangWatchApiClient(apiKey, endpoint),\n    };\n  }\n}\n","import { ConsoleLogger, NoOpLogger } from \"./logger\";\n\nexport {\n  getLangWatchTracer,\n  getLangWatchLogger,\n  attributes,\n} from \"./observability-sdk\";\n\nexport {\n  FilterableBatchSpanProcessor,\n  type SpanProcessingExcludeRule,\n} from \"./observability-sdk/processors\";\nexport { LangWatchExporter } from \"./observability-sdk/exporters\";\nexport { LangWatch } from \"./client-sdk\";\n\nexport const logger = {\n  ConsoleLogger,\n  NoOpLogger,\n};\n"]}

package/dist/index.mjs

@@ -1,25 +1,148 @@
 import {
-  LangWatch
-} from "./chunk-YEGQXDTE.mjs";
-import "./chunk-H5PON53W.mjs";
+  LocalPromptsService,
+  PromptsApiService,
+  PromptsFacade,
+  createLangWatchApiClient,
+  createTracingProxy
+} from "./chunk-GAFUPYJ3.mjs";
 import {
   FilterableBatchSpanProcessor
-} from "./chunk-N2V6J3U2.mjs";
+} from "./chunk-FEL5FLHA.mjs";
 import {
   getLangWatchTracer
-} from "./chunk-QZGTM76F.mjs";
+} from "./chunk-JPWKINZP.mjs";
 import {
   LangWatchTraceExporter,
   getLangWatchLogger
-} from "./chunk-ZIULPOMQ.mjs";
-import "./chunk-YKFTFYKK.mjs";
+} from "./chunk-3P4ROGZJ.mjs";
+import {
+  DEFAULT_ENDPOINT,
+  LANGWATCH_SDK_NAME_CLIENT,
+  LANGWATCH_SDK_VERSION
+} from "./chunk-WOBPYIKO.mjs";
 import {
   ConsoleLogger,
   NoOpLogger,
   attributes_exports
-} from "./chunk-YNQ44U6D.mjs";
-import "./chunk-V5M3HUBV.mjs";
-import "./chunk-CU3443HD.mjs";
+} from "./chunk-I2SOBPAF.mjs";
+import "./chunk-PYVDTUA6.mjs";
+import "./chunk-BTBSMJTY.mjs";
+import {
+  __privateAdd,
+  __privateGet,
+  __privateMethod,
+  __privateSet,
+  __spreadValues
+} from "./chunk-URTD2WOC.mjs";
+
+// src/client-sdk/services/traces/types.ts
+var TracesError = class extends Error {
+  constructor(message, operation, originalError) {
+    super(message);
+    this.operation = operation;
+    this.originalError = originalError;
+    this.name = "TracesError";
+  }
+};
+
+// src/client-sdk/services/traces/tracing/tracer.ts
+var tracer = getLangWatchTracer(`${LANGWATCH_SDK_NAME_CLIENT}.traces`, LANGWATCH_SDK_VERSION);
+
+// src/client-sdk/services/traces/service.ts
+var TracesService = class {
+  constructor(config) {
+    this.config = config;
+    return createTracingProxy(
+      this,
+      tracer
+    );
+  }
+  /**
+   * Handles API errors by throwing a TracesError with operation context.
+   * @param operation Description of the operation being performed.
+   * @param error The error object returned from the API client.
+   * @throws {TracesError}
+   */
+  handleApiError(operation, error) {
+    var _a, _b;
+    const errorMessage = typeof error === "string" ? error : (_b = (_a = error == null ? void 0 : error.error) != null ? _a : error == null ? void 0 : error.message) != null ? _b : "Unknown error occurred";
+    throw new TracesError(
+      `Failed to ${operation}: ${errorMessage}`,
+      operation,
+      error
+    );
+  }
+  /**
+   * Retrieves a trace by its ID.
+   * @param traceId The trace's unique identifier.
+   * @param params Optional parameters for the request.
+   * @returns The trace response object.
+   * @throws {TracesError} If the API call fails.
+   */
+  async get(traceId, params) {
+    const { data, error } = await this.config.langwatchApiClient.GET("/api/trace/{id}", {
+      params: {
+        path: {
+          id: traceId
+        }
+      },
+      query: params
+    });
+    if (error) {
+      this.handleApiError("get trace", error);
+    }
+    return data;
+  }
+};
+
+// src/client-sdk/services/traces/facade.ts
+var _service;
+var TracesFacade = class {
+  constructor(config) {
+    __privateAdd(this, _service);
+    __privateSet(this, _service, new TracesService(config));
+  }
+  async get(traceId, params) {
+    return __privateGet(this, _service).get(traceId, params);
+  }
+};
+_service = new WeakMap();
+
+// src/client-sdk/index.ts
+var _LangWatch_instances, createInternalConfig_fn;
+var LangWatch = class {
+  constructor(options = {}) {
+    __privateAdd(this, _LangWatch_instances);
+    var _a, _b, _c, _d;
+    const apiKey = (_b = (_a = options.apiKey) != null ? _a : process.env.LANGWATCH_API_KEY) != null ? _b : "";
+    const endpoint = (_d = (_c = options.endpoint) != null ? _c : process.env.LANGWATCH_ENDPOINT) != null ? _d : DEFAULT_ENDPOINT;
+    this.config = __privateMethod(this, _LangWatch_instances, createInternalConfig_fn).call(this, {
+      apiKey,
+      endpoint,
+      options: options.options
+    });
+    this.prompts = new PromptsFacade(__spreadValues({
+      promptsApiService: new PromptsApiService(this.config),
+      localPromptsService: new LocalPromptsService()
+    }, this.config));
+    this.traces = new TracesFacade(this.config);
+  }
+  get apiClient() {
+    return this.config.langwatchApiClient;
+  }
+};
+_LangWatch_instances = new WeakSet();
+createInternalConfig_fn = function({
+  apiKey,
+  endpoint,
+  options
+}) {
+  var _a;
+  return {
+    logger: (_a = options == null ? void 0 : options.logger) != null ? _a : new NoOpLogger(),
+    langwatchApiClient: createLangWatchApiClient(apiKey, endpoint)
+  };
+};
 
 // src/index.ts
 var logger = {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { ConsoleLogger, NoOpLogger } from \"./logger\";\n\nexport {\n  getLangWatchTracer,\n  getLangWatchLogger,\n  attributes,\n} from \"./observability-sdk\";\n\nexport {\n  FilterableBatchSpanProcessor,\n  type SpanProcessingExcludeRule,\n} from \"./observability-sdk/processors\";\nexport { LangWatchExporter } from \"./observability-sdk/exporters\";\nexport { LangWatch } from \"./client-sdk\";\n\nexport const logger = {\n  ConsoleLogger,\n  NoOpLogger,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAeO,IAAM,SAAS;AAAA,EACpB;AAAA,EACA;AACF;","names":[]}
+{"version":3,"sources":["../src/client-sdk/services/traces/types.ts","../src/client-sdk/services/traces/tracing/tracer.ts","../src/client-sdk/services/traces/service.ts","../src/client-sdk/services/traces/facade.ts","../src/client-sdk/index.ts","../src/index.ts"],"sourcesContent":["import type { paths } from \"@/internal/generated/openapi/api-client\";\n\nexport interface GetTraceParams {\n  includeSpans?: boolean;\n}\n\nexport type GetTraceResponse = NonNullable<\n  paths[\"/api/trace/{id}\"][\"get\"][\"responses\"][\"200\"][\"content\"][\"application/json\"]\n>;\n\n/**\n * Custom error class for Traces API operations.\n * Provides context about the failed operation and the original error.\n */\nexport class TracesError extends Error {\n  constructor(\n    message: string,\n    public readonly operation: string,\n    public readonly originalError?: any,\n  ) {\n    super(message);\n    this.name = \"TracesError\";\n  }\n}\n","import { LANGWATCH_SDK_NAME_CLIENT, LANGWATCH_SDK_VERSION } from \"@/internal/constants\";\nimport { getLangWatchTracer } from \"@/observability-sdk/tracer\";\n\nexport const tracer = getLangWatchTracer(`${LANGWATCH_SDK_NAME_CLIENT}.traces`, LANGWATCH_SDK_VERSION);\n","import { createTracingProxy } from \"@/client-sdk/tracing/create-tracing-proxy\";\nimport { type InternalConfig } from \"@/client-sdk/types\";\nimport { type GetTraceParams, TracesError, type GetTraceResponse } from \"./types\";\nimport { tracer } from \"./tracing\";\n\n/**\n * Service for managing trace resources via the Langwatch API.\n * Constructor creates a proxy that wraps the service and traces all methods.\n *\n * Responsibilities:\n * - Retrieving trace data\n * - Error handling with contextual information\n *\n * All methods return trace response objects directly.\n */\nexport class TracesService {\n  private config: InternalConfig;\n\n  constructor(config: InternalConfig) {\n    this.config = config;\n\n    /**\n     * Wraps the service in a tracing proxy via the decorator.\n     */\n    return createTracingProxy(\n      this as TracesService,\n      tracer,\n    );\n  }\n\n  /**\n   * Handles API errors by throwing a TracesError with operation context.\n   * @param operation Description of the operation being performed.\n   * @param error The error object returned from the API client.\n   * @throws {TracesError}\n   */\n  private handleApiError(operation: string, error: any): never {\n    const errorMessage =\n      typeof error === \"string\"\n        ? error\n        : error?.error ?? error?.message ?? \"Unknown error occurred\";\n    throw new TracesError(\n      `Failed to ${operation}: ${errorMessage}`,\n      operation,\n      error,\n    );\n  }\n\n  /**\n   * Retrieves a trace by its ID.\n   * @param traceId The trace's unique identifier.\n   * @param params Optional parameters for the request.\n   * @returns The trace response object.\n   * @throws {TracesError} If the API call fails.\n   */\n  async get(\n    traceId: string,\n    params?: GetTraceParams,\n  ): Promise<GetTraceResponse> {\n    const { data, error } = await this.config.langwatchApiClient.GET(\"/api/trace/{id}\", {\n      params: {\n        path: {\n          id: traceId,\n        },\n      },\n      query: params,\n    });\n\n    if (error) {\n      this.handleApiError(\"get trace\", error);\n    }\n\n    return data;\n  }\n}\n","import { type InternalConfig } from \"../../types\";\nimport { TracesService } from \"./service\";\nimport { type GetTraceParams, type GetTraceResponse } from \"./types\";\n\nexport class TracesFacade {\n  readonly #service: TracesService;\n\n  constructor(config: InternalConfig) {\n    this.#service = new TracesService(config);\n  }\n\n  async get(traceId: string, params?: GetTraceParams): Promise<GetTraceResponse> {\n    return this.#service.get(traceId, params);\n  }\n}\n","import { PromptsFacade, PromptsApiService } from \"./services/prompts\";\nimport { LocalPromptsService } from \"./services/prompts/local-prompts.service\";\nimport { type InternalConfig } from \"./types\";\nimport { createLangWatchApiClient, type LangwatchApiClient } from \"../internal/api/client\";\nimport { type Logger, NoOpLogger } from \"../logger\";\nimport { TracesFacade } from \"./services/traces/facade\";\nimport { DEFAULT_ENDPOINT } from \"@/internal/constants\";\n\nexport interface LangWatchConstructorOptions {\n  apiKey?: string;\n  endpoint?: string;\n  options?: {\n    logger?: Logger;\n  };\n}\n\nexport class LangWatch {\n  private readonly config: InternalConfig;\n\n  readonly prompts: PromptsFacade;\n  readonly traces: TracesFacade;\n\n  constructor(options: LangWatchConstructorOptions = {}) {\n    const apiKey = options.apiKey ?? process.env.LANGWATCH_API_KEY ?? \"\";\n    const endpoint = options.endpoint ?? process.env.LANGWATCH_ENDPOINT ?? DEFAULT_ENDPOINT;\n\n    this.config = this.#createInternalConfig({\n      apiKey,\n      endpoint,\n      options: options.options,\n    });\n\n    this.prompts = new PromptsFacade({\n      promptsApiService: new PromptsApiService(this.config),\n      localPromptsService: new LocalPromptsService(),\n      ...this.config,\n    });\n    this.traces = new TracesFacade(this.config);\n  }\n\n  get apiClient(): LangwatchApiClient {\n    return this.config.langwatchApiClient;\n  }\n\n  #createInternalConfig({\n    apiKey,\n    endpoint,\n    options,\n  }: {\n    apiKey: string;\n    endpoint: string;\n    options?: LangWatchConstructorOptions[\"options\"];\n  }): InternalConfig {\n    return {\n      logger: options?.logger ?? new NoOpLogger(),\n      langwatchApiClient: createLangWatchApiClient(apiKey, endpoint),\n    };\n  }\n}\n","import { ConsoleLogger, NoOpLogger } from \"./logger\";\n\nexport {\n  getLangWatchTracer,\n  getLangWatchLogger,\n  attributes,\n} from \"./observability-sdk\";\n\nexport {\n  FilterableBatchSpanProcessor,\n  type SpanProcessingExcludeRule,\n} from \"./observability-sdk/processors\";\nexport { LangWatchExporter } from \"./observability-sdk/exporters\";\nexport { LangWatch } from \"./client-sdk\";\n\nexport const logger = {\n  ConsoleLogger,\n  NoOpLogger,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcO,IAAM,cAAN,cAA0B,MAAM;AAAA,EACrC,YACE,SACgB,WACA,eAChB;AACA,UAAM,OAAO;AAHG;AACA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;;;ACpBO,IAAM,SAAS,mBAAmB,GAAG,yBAAyB,WAAW,qBAAqB;;;ACY9F,IAAM,gBAAN,MAAoB;AAAA,EAGzB,YAAY,QAAwB;AAClC,SAAK,SAAS;AAKd,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,eAAe,WAAmB,OAAmB;AApC/D;AAqCI,UAAM,eACJ,OAAO,UAAU,WACb,SACA,0CAAO,UAAP,YAAgB,+BAAO,YAAvB,YAAkC;AACxC,UAAM,IAAI;AAAA,MACR,aAAa,SAAS,KAAK,YAAY;AAAA,MACvC;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,IACJ,SACA,QAC2B;AAC3B,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,KAAK,OAAO,mBAAmB,IAAI,mBAAmB;AAAA,MAClF,QAAQ;AAAA,QACN,MAAM;AAAA,UACJ,IAAI;AAAA,QACN;AAAA,MACF;AAAA,MACA,OAAO;AAAA,IACT,CAAC;AAED,QAAI,OAAO;AACT,WAAK,eAAe,aAAa,KAAK;AAAA,IACxC;AAEA,WAAO;AAAA,EACT;AACF;;;AC1EA;AAIO,IAAM,eAAN,MAAmB;AAAA,EAGxB,YAAY,QAAwB;AAFpC,uBAAS;AAGP,uBAAK,UAAW,IAAI,cAAc,MAAM;AAAA,EAC1C;AAAA,EAEA,MAAM,IAAI,SAAiB,QAAoD;AAC7E,WAAO,mBAAK,UAAS,IAAI,SAAS,MAAM;AAAA,EAC1C;AACF;AATW;;;ACLX;AAgBO,IAAM,YAAN,MAAgB;AAAA,EAMrB,YAAY,UAAuC,CAAC,GAAG;AANlD;AAhBP;AAuBI,UAAM,UAAS,mBAAQ,WAAR,YAAkB,QAAQ,IAAI,sBAA9B,YAAmD;AAClE,UAAM,YAAW,mBAAQ,aAAR,YAAoB,QAAQ,IAAI,uBAAhC,YAAsD;AAEvE,SAAK,SAAS,sBAAK,+CAAL,WAA2B;AAAA,MACvC;AAAA,MACA;AAAA,MACA,SAAS,QAAQ;AAAA,IACnB;AAEA,SAAK,UAAU,IAAI,cAAc;AAAA,MAC/B,mBAAmB,IAAI,kBAAkB,KAAK,MAAM;AAAA,MACpD,qBAAqB,IAAI,oBAAoB;AAAA,OAC1C,KAAK,OACT;AACD,SAAK,SAAS,IAAI,aAAa,KAAK,MAAM;AAAA,EAC5C;AAAA,EAEA,IAAI,YAAgC;AAClC,WAAO,KAAK,OAAO;AAAA,EACrB;AAgBF;AA1CO;AA4BL,0BAAqB,SAAC;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AACF,GAImB;AApDrB;AAqDI,SAAO;AAAA,IACL,SAAQ,wCAAS,WAAT,YAAmB,IAAI,WAAW;AAAA,IAC1C,oBAAoB,yBAAyB,QAAQ,QAAQ;AAAA,EAC/D;AACF;;;AC1CK,IAAM,SAAS;AAAA,EACpB;AAAA,EACA;AACF;","names":[]}