langwatch 0.25.0 → 0.27.0

package/dist/chunk-ILU7DFFC.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/client-sdk/services/datasets/errors.ts","../src/client-sdk/services/datasets/tracing/tracer.ts","../src/client-sdk/services/datasets/dataset.service.ts","../src/client-sdk/services/datasets/datasets.facade.ts"],"sourcesContent":["/**\n * Errors for the Dataset API\n */\n\n/**\n * Base error for all dataset operations.\n */\nexport class DatasetError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"DatasetError\";\n  }\n}\n\n/**\n * Thrown when a dataset is not found (404).\n */\nexport class DatasetNotFoundError extends DatasetError {\n  constructor(slugOrId: string) {\n    super(`Dataset not found: ${slugOrId}`);\n    this.name = \"DatasetNotFoundError\";\n  }\n}\n\n/**\n * Error from the Dataset API with operation context.\n * Aligns with PromptsApiError pattern: includes operation and originalError fields.\n */\nexport class DatasetApiError extends DatasetError {\n  readonly status: number;\n  readonly operation: string;\n  readonly originalError?: unknown;\n\n  constructor(message: string, status: number, operation: string, originalError?: unknown) {\n    super(message);\n    this.name = \"DatasetApiError\";\n    this.status = status;\n    this.operation = operation;\n    this.originalError = originalError;\n  }\n}\n\n/**\n * Thrown for client-side validation failures (e.g. empty name, no update fields, empty entries).\n * Distinguished from DatasetApiError which represents server-side errors.\n */\nexport class DatasetValidationError extends DatasetError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"DatasetValidationError\";\n  }\n}\n\n/**\n * Thrown when a dataset operation exceeds the plan limit (403).\n * The message includes the upgrade/subscription URL from the server.\n */\nexport class DatasetPlanLimitError extends DatasetError {\n  readonly limitType: string;\n  readonly current?: number;\n  readonly max?: number;\n\n  constructor(message: string, originalError?: unknown) {\n    super(message);\n    this.name = \"DatasetPlanLimitError\";\n\n    if (originalError != null && typeof originalError === \"object\") {\n      const err = originalError as Record<string, unknown>;\n      this.limitType = typeof err.limitType === \"string\" ? err.limitType : \"datasets\";\n      this.current = typeof err.current === \"number\" ? err.current : undefined;\n      this.max = typeof err.max === \"number\" ? err.max : undefined;\n    } else {\n      this.limitType = \"datasets\";\n    }\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}.datasets`, LANGWATCH_SDK_VERSION);\n","import { type LangwatchApiClient } from \"@/internal/api/client\";\nimport { type Logger } from \"@/logger\";\nimport {\n  type Dataset,\n  type DatasetEntry,\n  type DatasetMetadata,\n  type GetDatasetApiResponse,\n  type GetDatasetOptions,\n  type ListDatasetsOptions,\n  type ListDatasetsApiResponse,\n  type ListRecordsOptions,\n  type ListRecordsApiResponse,\n  type CreateDatasetOptions,\n  type UpdateDatasetOptions,\n  type CreateFromUploadOptions,\n  type CreateFromUploadResponse,\n  type BatchCreateRecordsResponse,\n  type DeleteRecordsResponse,\n  type UploadResponse,\n  type DatasetRecordResponse,\n} from \"./types\";\nimport { DatasetApiError, DatasetNotFoundError, DatasetPlanLimitError } from \"./errors\";\nimport { createTracingProxy } from \"@/client-sdk/tracing/create-tracing-proxy\";\nimport { tracer } from \"./tracing\";\nimport { formatApiErrorMessage } from \"@/client-sdk/services/_shared/format-api-error\";\n\ntype DatasetServiceConfig = {\n  langwatchApiClient: LangwatchApiClient;\n  logger: Logger;\n  endpoint: string;\n  apiKey: string;\n};\n\n/**\n * Service for managing dataset resources via the LangWatch API.\n *\n * Responsibilities:\n * - CRUD operations for datasets\n * - Record management (create, update, delete)\n * - File upload\n * - Error handling with contextual information\n */\nexport class DatasetService {\n  private readonly config: DatasetServiceConfig;\n\n  constructor(config: DatasetServiceConfig) {\n    this.config = config;\n\n    /**\n     * Wraps the service in a tracing proxy that automatically creates\n     * OpenTelemetry spans for all public methods.\n     */\n    return createTracingProxy(this as DatasetService, tracer);\n  }\n\n  /**\n   * Handles API errors by mapping status codes to appropriate error types.\n   * @param operation - Description of the operation being performed\n   * @param error - The error object from the API response\n   * @param status - The HTTP status code\n   * @param slugOrId - The dataset identifier (only passed for operations targeting an existing resource)\n   */\n  private handleApiError(operation: string, error: unknown, status: number, slugOrId?: string): never {\n    if (status === 404 && slugOrId) {\n      throw new DatasetNotFoundError(slugOrId);\n    }\n\n    if (status === 403) {\n      const errorMessage = this.extractErrorMessage(error, status);\n      throw new DatasetPlanLimitError(errorMessage, error);\n    }\n\n    const errorMessage = this.extractErrorMessage(error, status);\n\n    throw new DatasetApiError(\n      `Failed to ${operation}: ${errorMessage}`,\n      status,\n      operation,\n      error,\n    );\n  }\n\n  /**\n   * Extracts a human-readable error message from an API error response.\n   */\n  private extractErrorMessage(error: unknown, status: number): string {\n    return formatApiErrorMessage({ error: error, options: { status } });\n  }\n\n  /**\n   * Wrapper for API calls to endpoints not yet in the generated OpenAPI types.\n   * Quarantines `as any` casts to a single location.\n   */\n  private untypedRequest<M extends 'GET' | 'POST' | 'PATCH' | 'DELETE'>(\n    method: M,\n    path: string,\n    options?: Record<string, unknown>,\n  ) {\n    return (this.config.langwatchApiClient[method] as any)(path, options);\n  }\n\n  /**\n   * Unwraps an API response, throwing a mapped error if the response contains an error.\n   * Centralizes the repeated `if (error) handleApiError; return data` pattern.\n   */\n  private unwrapResponse<T>(\n    response: { data?: unknown; error?: unknown; response: { status: number } },\n    operation: string,\n    slugOrId?: string,\n  ): T {\n    if (response.error) {\n      this.handleApiError(operation, response.error, response.response.status, slugOrId);\n    }\n    return response.data as T;\n  }\n\n  /**\n   * Fetches a dataset by its slug or ID, returning metadata and entries.\n   *\n   * @param slugOrId - The slug or ID of the dataset\n   * @param _options - Optional configuration\n   * @returns The dataset with metadata and entries\n   */\n  async getDataset<T extends Record<string, unknown> = Record<string, unknown>>(\n    slugOrId: string,\n    _options?: GetDatasetOptions\n  ): Promise<Dataset<T>> {\n    this.config.logger.debug(`Fetching dataset: ${slugOrId}`);\n\n    const response = await this.config.langwatchApiClient.GET(\n      \"/api/dataset/{slugOrId}\",\n      {\n        params: {\n          path: {\n            slugOrId,\n          },\n        },\n      }\n    );\n\n    const data = this.unwrapResponse<GetDatasetApiResponse>(\n      response,\n      `fetch dataset \"${slugOrId}\"`,\n      slugOrId,\n    );\n\n    const entries: DatasetEntry<T>[] = data.data.map((item) => ({\n      id: item.id,\n      datasetId: item.datasetId,\n      projectId: item.projectId,\n      entry: item.entry as T,\n      createdAt: item.createdAt,\n      updatedAt: item.updatedAt,\n    }));\n\n    this.config.logger.debug(\n      `Fetched dataset ${slugOrId} with ${entries.length} entries`\n    );\n\n    return {\n      id: data.id,\n      name: data.name,\n      slug: data.slug,\n      columnTypes: data.columnTypes,\n      createdAt: data.createdAt,\n      updatedAt: data.updatedAt,\n      entries,\n    };\n  }\n\n  /**\n   * Lists all datasets for the project, with optional pagination.\n   */\n  async listDatasets(options?: ListDatasetsOptions): Promise<ListDatasetsApiResponse> {\n    this.config.logger.debug(\"Listing datasets\");\n\n    const response = await this.untypedRequest('GET', '/api/dataset', {\n      params: {\n        query: {\n          page: options?.page,\n          limit: options?.limit,\n        },\n      },\n    });\n\n    return this.unwrapResponse<ListDatasetsApiResponse>(\n      response,\n      \"list datasets\",\n    );\n  }\n\n  /**\n   * Creates a new dataset.\n   */\n  async createDataset(options: CreateDatasetOptions): Promise<DatasetMetadata> {\n    this.config.logger.debug(`Creating dataset: ${options.name}`);\n\n    const response = await this.untypedRequest('POST', '/api/dataset', {\n      body: {\n        name: options.name,\n        columnTypes: options.columnTypes ?? [],\n      },\n    });\n\n    return this.unwrapResponse<DatasetMetadata>(\n      response,\n      `create dataset \"${options.name}\"`,\n    );\n  }\n\n  /**\n   * Updates a dataset by its slug or ID.\n   */\n  async updateDataset(slugOrId: string, options: UpdateDatasetOptions): Promise<DatasetMetadata> {\n    this.config.logger.debug(`Updating dataset: ${slugOrId}`);\n\n    const response = await this.untypedRequest('PATCH', '/api/dataset/{slugOrId}', {\n      params: {\n        path: { slugOrId },\n      },\n      body: options,\n    });\n\n    return this.unwrapResponse<DatasetMetadata>(\n      response,\n      `update dataset \"${slugOrId}\"`,\n      slugOrId,\n    );\n  }\n\n  /**\n   * Deletes (archives) a dataset by its slug or ID.\n   */\n  async deleteDataset(slugOrId: string): Promise<DatasetMetadata> {\n    this.config.logger.debug(`Deleting dataset: ${slugOrId}`);\n\n    const response = await this.untypedRequest('DELETE', '/api/dataset/{slugOrId}', {\n      params: {\n        path: { slugOrId },\n      },\n    });\n\n    return this.unwrapResponse<DatasetMetadata>(\n      response,\n      `delete dataset \"${slugOrId}\"`,\n      slugOrId,\n    );\n  }\n\n  /**\n   * Creates records in a dataset in batch.\n   */\n  async createRecords(\n    slugOrId: string,\n    entries: Record<string, unknown>[],\n  ): Promise<BatchCreateRecordsResponse> {\n    this.config.logger.debug(`Creating ${entries.length} records in dataset: ${slugOrId}`);\n\n    const response = await this.untypedRequest('POST', '/api/dataset/{slugOrId}/records', {\n      params: {\n        path: { slugOrId },\n      },\n      body: { entries },\n    });\n\n    return this.unwrapResponse<BatchCreateRecordsResponse>(\n      response,\n      `create records in dataset \"${slugOrId}\"`,\n      slugOrId,\n    );\n  }\n\n  /**\n   * Updates a single record in a dataset.\n   */\n  async updateRecord(\n    slugOrId: string,\n    recordId: string,\n    entry: Record<string, unknown>,\n  ): Promise<DatasetRecordResponse> {\n    this.config.logger.debug(`Updating record ${recordId} in dataset: ${slugOrId}`);\n\n    const response = await this.untypedRequest('PATCH', '/api/dataset/{slugOrId}/records/{recordId}', {\n      params: {\n        path: { slugOrId, recordId },\n      },\n      body: { entry },\n    });\n\n    return this.unwrapResponse<DatasetRecordResponse>(\n      response,\n      `update record \"${recordId}\" in dataset \"${slugOrId}\"`,\n      slugOrId,\n    );\n  }\n\n  /**\n   * Deletes records from a dataset by IDs.\n   */\n  async deleteRecords(\n    slugOrId: string,\n    recordIds: string[],\n  ): Promise<DeleteRecordsResponse> {\n    this.config.logger.debug(`Deleting ${recordIds.length} records from dataset: ${slugOrId}`);\n\n    const response = await this.untypedRequest('DELETE', '/api/dataset/{slugOrId}/records', {\n      params: {\n        path: { slugOrId },\n      },\n      body: { recordIds },\n    });\n\n    return this.unwrapResponse<DeleteRecordsResponse>(\n      response,\n      `delete records from dataset \"${slugOrId}\"`,\n      slugOrId,\n    );\n  }\n\n  /**\n   * Lists records in a dataset with optional pagination.\n   *\n   * @param slugOrId - The slug or ID of the dataset\n   * @param options - Pagination options (page, limit)\n   * @returns Paginated list of records\n   */\n  async listRecords(\n    slugOrId: string,\n    options?: ListRecordsOptions,\n  ): Promise<ListRecordsApiResponse> {\n    this.config.logger.debug(`Listing records for dataset: ${slugOrId}`);\n\n    const response = await this.untypedRequest('GET', '/api/dataset/{slugOrId}/records', {\n      params: {\n        path: { slugOrId },\n        query: {\n          page: options?.page,\n          limit: options?.limit,\n        },\n      },\n    });\n\n    return this.unwrapResponse<ListRecordsApiResponse>(\n      response,\n      `list records in dataset \"${slugOrId}\"`,\n      slugOrId,\n    );\n  }\n\n  /**\n   * Sends a multipart/form-data request using raw fetch.\n   * openapi-fetch hardcodes content-type: application/json, so file uploads\n   * must bypass it. This helper centralizes URL building, auth headers,\n   * error parsing, and response unwrapping.\n   *\n   * @param path - The API path (appended to the endpoint)\n   * @param formData - The FormData payload\n   * @param operation - Human-readable operation name for error messages\n   * @param slugOrId - Optional dataset identifier (passed to handleApiError for 404 mapping)\n   */\n  private async fetchMultipart<T>(\n    path: string,\n    formData: FormData,\n    operation: string,\n    slugOrId?: string,\n  ): Promise<T> {\n    const { endpoint, apiKey } = this.config;\n    const url = `${endpoint.replace(/\\/$/, \"\")}${path}`;\n\n    const response = await fetch(url, {\n      method: \"POST\",\n      headers: {\n        \"X-Auth-Token\": apiKey,\n        authorization: `Bearer ${apiKey}`,\n      },\n      body: formData,\n    });\n\n    if (!response.ok) {\n      const rawBody = await response.text();\n      let errorBody: unknown = rawBody;\n      if (rawBody) {\n        try {\n          errorBody = JSON.parse(rawBody);\n        } catch {\n          // Keep the plain-text body.\n        }\n      }\n\n      this.handleApiError(operation, errorBody, response.status, slugOrId);\n    }\n\n    return (await response.json()) as T;\n  }\n\n  /**\n   * Creates a new dataset from a file upload.\n   *\n   * @param options - The dataset name and file to upload\n   * @returns The created dataset metadata with record count\n   */\n  async createDatasetFromUpload(\n    options: CreateFromUploadOptions,\n  ): Promise<CreateFromUploadResponse> {\n    this.config.logger.debug(`Creating dataset from upload: ${options.name}`);\n\n    const formData = new FormData();\n    formData.append(\"name\", options.name);\n    formData.append(\"file\", options.file);\n\n    return this.fetchMultipart<CreateFromUploadResponse>(\n      \"/api/dataset/upload\",\n      formData,\n      `create dataset from upload \"${options.name}\"`,\n    );\n  }\n\n  /**\n   * Uploads a file with a strategy for handling existing datasets.\n   *\n   * @param slugOrId - The slug or ID of the dataset\n   * @param file - The file to upload (File or Blob)\n   * @param ifExists - Strategy when dataset exists: \"append\" (default), \"replace\", or \"error\"\n   * @returns The upload result\n   */\n  async uploadWithStrategy(\n    slugOrId: string,\n    file: File | Blob,\n    ifExists: \"append\" | \"replace\" | \"error\" = \"append\",\n  ): Promise<UploadResponse> {\n    switch (ifExists) {\n      case \"append\":\n        return this._uploadAppend(slugOrId, file);\n      case \"replace\":\n        return this._uploadReplace(slugOrId, file);\n      case \"error\":\n        return this._uploadError(slugOrId, file);\n    }\n  }\n\n  /**\n   * Converts a CreateFromUploadResponse to the unified UploadResponse shape.\n   */\n  private toUploadResponse(result: CreateFromUploadResponse): UploadResponse {\n    return {\n      dataset: {\n        id: result.id,\n        name: result.name,\n        slug: result.slug,\n        columnTypes: result.columnTypes,\n        createdAt: result.createdAt,\n        updatedAt: result.updatedAt,\n      },\n      recordsCreated: result.recordsCreated,\n      datasetId: result.id,\n    };\n  }\n\n  /**\n   * Append strategy: try uploading to existing dataset; if not found, create from file.\n   */\n  private async _uploadAppend(slugOrId: string, file: File | Blob): Promise<UploadResponse> {\n    try {\n      return await this.uploadFile(slugOrId, file);\n    } catch (error) {\n      if (error instanceof DatasetNotFoundError) {\n        return this.toUploadResponse(await this.createDatasetFromUpload({ name: slugOrId, file }));\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Replace strategy: if dataset exists, delete all records then upload; if not found, create from file.\n   */\n  private async _uploadReplace(slugOrId: string, file: File | Blob): Promise<UploadResponse> {\n    try {\n      await this.getDataset(slugOrId);\n      await this._deleteAllRecords(slugOrId);\n      return await this.uploadFile(slugOrId, file);\n    } catch (error) {\n      if (error instanceof DatasetNotFoundError) {\n        return this.toUploadResponse(await this.createDatasetFromUpload({ name: slugOrId, file }));\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Error strategy: if dataset exists, throw 409; if not found, create from file.\n   */\n  private async _uploadError(slugOrId: string, file: File | Blob): Promise<UploadResponse> {\n    let datasetExists = false;\n    try {\n      await this.getDataset(slugOrId);\n      datasetExists = true;\n    } catch (error) {\n      if (!(error instanceof DatasetNotFoundError)) {\n        throw error;\n      }\n    }\n\n    if (datasetExists) {\n      throw new DatasetApiError(\n        `Dataset already exists: ${slugOrId}`,\n        409,\n        \"upload\",\n      );\n    }\n\n    return this.toUploadResponse(await this.createDatasetFromUpload({ name: slugOrId, file }));\n  }\n\n  /**\n   * Deletes all records from a dataset by iterating through pages.\n   * Always fetches page 1 since records shift after deletion.\n   * Includes a safety valve to prevent infinite loops.\n   */\n  private async _deleteAllRecords(slugOrId: string): Promise<void> {\n    const BATCH_SIZE = 1000;\n    const MAX_DELETE_ITERATIONS = 100;\n\n    let iteration = 0;\n    while (iteration < MAX_DELETE_ITERATIONS) {\n      const page = await this.listRecords(slugOrId, { page: 1, limit: BATCH_SIZE });\n      if (page.data.length === 0) {\n        return;\n      }\n\n      const ids = page.data.map((record) => record.id);\n      await this.deleteRecords(slugOrId, ids);\n      iteration++;\n    }\n\n    throw new DatasetApiError(\n      `Failed to delete all records from dataset \"${slugOrId}\": exceeded ${MAX_DELETE_ITERATIONS} iterations`,\n      0,\n      `delete all records from dataset \"${slugOrId}\"`,\n    );\n  }\n\n  /**\n   * Uploads a file to an existing dataset.\n   */\n  async uploadFile(\n    slugOrId: string,\n    file: File | Blob,\n  ): Promise<UploadResponse> {\n    this.config.logger.debug(`Uploading file to dataset: ${slugOrId}`);\n\n    const formData = new FormData();\n    formData.append(\"file\", file);\n\n    return this.fetchMultipart<UploadResponse>(\n      `/api/dataset/${encodeURIComponent(slugOrId)}/upload`,\n      formData,\n      `upload file to dataset \"${slugOrId}\"`,\n      slugOrId,\n    );\n  }\n}\n","import { type LangwatchApiClient } from \"@/internal/api/client\";\nimport { type Logger } from \"@/logger\";\nimport { DatasetService } from \"./dataset.service\";\nimport { DatasetValidationError } from \"./errors\";\nimport {\n  type Dataset,\n  type DatasetMetadata,\n  type GetDatasetOptions,\n  type ListDatasetsOptions,\n  type ListDatasetsApiResponse,\n  type ListRecordsOptions,\n  type ListRecordsApiResponse,\n  type CreateDatasetOptions,\n  type UpdateDatasetOptions,\n  type BatchCreateRecordsResponse,\n  type DeleteRecordsResponse,\n  type UploadResponse,\n  type DatasetRecordResponse,\n} from \"./types\";\n\ntype DatasetsFacadeConfig = {\n  langwatchApiClient: LangwatchApiClient;\n  logger: Logger;\n  endpoint: string;\n  apiKey: string;\n};\n\n/**\n * Facade for dataset operations in the LangWatch SDK.\n * Provides a simplified interface for managing datasets, records, and file uploads.\n *\n * @example\n * ```typescript\n * const langwatch = new LangWatch({ apiKey: \"your-api-key\" });\n *\n * // List all datasets\n * const datasets = await langwatch.datasets.list();\n *\n * // Get a dataset by slug or ID\n * const dataset = await langwatch.datasets.get(\"my-dataset\");\n *\n * // Create a new dataset\n * const newDataset = await langwatch.datasets.create({\n *   name: \"my-dataset\",\n *   columnTypes: [{ name: \"input\", type: \"string\" }],\n * });\n *\n * // Update a dataset\n * const updated = await langwatch.datasets.update(\"my-dataset\", { name: \"new-name\" });\n *\n * // Delete a dataset\n * const archived = await langwatch.datasets.delete(\"my-dataset\");\n *\n * // Create records\n * const records = await langwatch.datasets.createRecords(\"my-dataset\", [\n *   { input: \"hello\", output: \"world\" },\n * ]);\n *\n * // Update a record\n * const record = await langwatch.datasets.updateRecord(\"my-dataset\", \"rec-1\", { input: \"updated\" });\n *\n * // Delete records\n * const result = await langwatch.datasets.deleteRecords(\"my-dataset\", [\"rec-1\", \"rec-2\"]);\n *\n * // Upload a file (append to existing or create new)\n * const uploadResult = await langwatch.datasets.upload(\"my-dataset\", file);\n *\n * // Upload with replace strategy (delete all records first)\n * await langwatch.datasets.upload(\"my-dataset\", file, { ifExists: \"replace\" });\n * ```\n */\nexport class DatasetsFacade {\n  readonly #datasetService: DatasetService;\n\n  constructor(config: DatasetsFacadeConfig) {\n    this.#datasetService = new DatasetService(config);\n  }\n\n  /**\n   * Lists all datasets for the project, with optional pagination.\n   *\n   * @param options - Pagination options (page, limit)\n   * @returns Paginated list of datasets with metadata\n   */\n  list = (options?: ListDatasetsOptions): Promise<ListDatasetsApiResponse> => {\n    return this.#datasetService.listDatasets(options);\n  };\n\n  /**\n   * Creates a new dataset.\n   *\n   * @param options - Dataset creation options (name, columnTypes)\n   * @returns The created dataset metadata\n   */\n  create = (options: CreateDatasetOptions): Promise<DatasetMetadata> => {\n    if (!options.name || options.name.trim().length === 0) {\n      throw new DatasetValidationError(\"Dataset name must not be empty\");\n    }\n    return this.#datasetService.createDataset(options);\n  };\n\n  /**\n   * Fetches a dataset by its slug or ID, returning metadata and entries.\n   *\n   * @param slugOrId - The slug or ID of the dataset to fetch\n   * @param options - Optional configuration\n   * @returns The dataset with metadata and entries\n   *\n   * @example\n   * ```typescript\n   * // Get dataset by slug\n   * const dataset = await langwatch.datasets.get(\"product-qa\");\n   *\n   * // Typed dataset\n   * type MyDatasetEntry = { input: string; expected_output: string; };\n   * const dataset = await langwatch.datasets.get<MyDatasetEntry>(\"my-dataset\");\n   *\n   * // Iterate over entries\n   * for (const entry of dataset.entries) {\n   *   console.log(entry.entry.input);\n   * }\n   * ```\n   */\n  get = <T extends Record<string, unknown> = Record<string, unknown>>(\n    slugOrId: string,\n    options?: GetDatasetOptions\n  ): Promise<Dataset<T>> => {\n    return this.#datasetService.getDataset<T>(slugOrId, options);\n  };\n\n  /**\n   * Updates a dataset by its slug or ID.\n   *\n   * @param slugOrId - The slug or ID of the dataset to update\n   * @param options - Fields to update (name, columnTypes)\n   * @returns The updated dataset metadata\n   */\n  update = (slugOrId: string, options: UpdateDatasetOptions): Promise<DatasetMetadata> => {\n    if (options.name == null && options.columnTypes == null) {\n      throw new DatasetValidationError(\n        \"At least one field (name or columnTypes) must be provided for update\",\n      );\n    }\n    return this.#datasetService.updateDataset(slugOrId, options);\n  };\n\n  /**\n   * Deletes (archives) a dataset by its slug or ID.\n   *\n   * @param slugOrId - The slug or ID of the dataset to delete\n   * @returns The archived dataset metadata\n   */\n  delete = (slugOrId: string): Promise<DatasetMetadata> => {\n    return this.#datasetService.deleteDataset(slugOrId);\n  };\n\n  /**\n   * Creates records in a dataset in batch.\n   *\n   * @param slugOrId - The slug or ID of the dataset\n   * @param entries - Array of record entries to create\n   * @returns The created records with IDs\n   */\n  createRecords = (\n    slugOrId: string,\n    entries: Record<string, unknown>[],\n  ): Promise<BatchCreateRecordsResponse> => {\n    if (!entries || entries.length === 0) {\n      throw new DatasetValidationError(\"Entries must not be empty\");\n    }\n    return this.#datasetService.createRecords(slugOrId, entries);\n  };\n\n  /**\n   * Updates a single record in a dataset.\n   *\n   * @param slugOrId - The slug or ID of the dataset\n   * @param recordId - The ID of the record to update\n   * @param entry - The updated entry data\n   * @returns The updated record\n   */\n  updateRecord = (\n    slugOrId: string,\n    recordId: string,\n    entry: Record<string, unknown>,\n  ): Promise<DatasetRecordResponse> => {\n    return this.#datasetService.updateRecord(slugOrId, recordId, entry);\n  };\n\n  /**\n   * Deletes records from a dataset by IDs.\n   *\n   * @param slugOrId - The slug or ID of the dataset\n   * @param recordIds - Array of record IDs to delete\n   * @returns Object with the count of deleted records\n   */\n  deleteRecords = (\n    slugOrId: string,\n    recordIds: string[],\n  ): Promise<DeleteRecordsResponse> => {\n    return this.#datasetService.deleteRecords(slugOrId, recordIds);\n  };\n\n  /**\n   * Lists records in a dataset with optional pagination.\n   *\n   * @param slugOrId - The slug or ID of the dataset\n   * @param options - Pagination options (page, limit)\n   * @returns Paginated list of records\n   *\n   * @example\n   * ```typescript\n   * // List first page of records\n   * const result = await langwatch.datasets.listRecords(\"my-dataset\");\n   *\n   * // With pagination\n   * const page2 = await langwatch.datasets.listRecords(\"my-dataset\", { page: 2, limit: 25 });\n   * ```\n   */\n  listRecords = (\n    slugOrId: string,\n    options?: ListRecordsOptions,\n  ): Promise<ListRecordsApiResponse> => {\n    return this.#datasetService.listRecords(slugOrId, options);\n  };\n\n  /**\n   * Uploads a file to a dataset with a configurable strategy for handling existing datasets.\n   *\n   * Strategies:\n   * - `\"append\"` (default): Upload to existing dataset; if not found, create a new one.\n   * - `\"replace\"`: Delete all existing records, then upload; if not found, create a new one.\n   * - `\"error\"`: Throw a 409 error if the dataset already exists; if not found, create a new one.\n   *\n   * @param slugOrId - The slug or ID of the dataset\n   * @param file - The file to upload (File or Blob)\n   * @param options - Upload options including the ifExists strategy\n   * @returns The upload result\n   *\n   * @example\n   * ```typescript\n   * const file = new File([\"input,output\\nhello,world\"], \"data.csv\", { type: \"text/csv\" });\n   *\n   * // Append to existing or create new\n   * await langwatch.datasets.upload(\"my-dataset\", file);\n   *\n   * // Replace all records\n   * await langwatch.datasets.upload(\"my-dataset\", file, { ifExists: \"replace\" });\n   *\n   * // Fail if dataset already exists\n   * await langwatch.datasets.upload(\"my-dataset\", file, { ifExists: \"error\" });\n   * ```\n   */\n  upload = (\n    slugOrId: string,\n    file: File | Blob,\n    options?: {\n      ifExists?: \"append\" | \"replace\" | \"error\";\n    },\n  ): Promise<UploadResponse> => {\n    if (!file) {\n      throw new DatasetValidationError(\"File must be provided for upload\");\n    }\n    return this.#datasetService.uploadWithStrategy(\n      slugOrId,\n      file,\n      options?.ifExists ?? \"append\",\n    );\n  };\n}\n"],"mappings":"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","names":["errorMessage"]}

package/dist/chunk-INNMPLUT.js

@@ -1,296 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-
-
-
-
-var _chunk6NVMVVY3js = require('./chunk-6NVMVVY3.js');
-
-
-var _chunkOAAMDWSKjs = require('./chunk-OAAMDWSK.js');
-
-
-
-var _chunkOHM7JUMRjs = require('./chunk-OHM7JUMR.js');
-
-// src/observability-sdk/exporters/langwatch-trace-exporter.ts
-var _exportertraceotlphttp = require('@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 _exportertraceotlphttp.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;
-    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 : _chunk6NVMVVY3js.DEFAULT_ENDPOINT;
-    const url = new URL(_chunk6NVMVVY3js.TRACES_PATH, endpoint);
-    const otelEndpoint = url.toString();
-    super({
-      headers: _chunkOHM7JUMRjs.__spreadValues.call(void 0, {
-        "x-langwatch-sdk-name": _chunk6NVMVVY3js.LANGWATCH_SDK_NAME_OBSERVABILITY,
-        "x-langwatch-sdk-language": _chunk6NVMVVY3js.LANGWATCH_SDK_LANGUAGE,
-        "x-langwatch-sdk-version": _chunk6NVMVVY3js.LANGWATCH_SDK_VERSION,
-        "x-langwatch-sdk-runtime": _chunk6NVMVVY3js.LANGWATCH_SDK_RUNTIME.call(void 0, )
-      }, apiKey ? { authorization: `Bearer ${apiKey}` } : {}),
-      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
-var _exporterlogsotlphttp = require('@opentelemetry/exporter-logs-otlp-http');
-var LangWatchLogsExporter = class extends _exporterlogsotlphttp.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 : _chunk6NVMVVY3js.DEFAULT_ENDPOINT;
-    const url = new URL(_chunk6NVMVVY3js.LOGS_PATH, endpoint);
-    const otelEndpoint = url.toString();
-    super({
-      headers: _chunkOHM7JUMRjs.__spreadValues.call(void 0, {
-        "x-langwatch-sdk-name": _chunk6NVMVVY3js.LANGWATCH_SDK_NAME_OBSERVABILITY,
-        "x-langwatch-sdk-language": _chunk6NVMVVY3js.LANGWATCH_SDK_LANGUAGE,
-        "x-langwatch-sdk-version": _chunk6NVMVVY3js.LANGWATCH_SDK_VERSION,
-        "x-langwatch-sdk-runtime": _chunk6NVMVVY3js.LANGWATCH_SDK_RUNTIME.call(void 0, )
-      }, 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
-
-
-var _apilogs = require('@opentelemetry/api-logs');
-
-// src/observability-sdk/logger/implementation.ts
-var _api = require('@opentelemetry/api');
-var LangWatchLoggerInternal = class {
-  constructor(logger) {
-    this.logger = logger;
-  }
-  emit(logRecord, options) {
-    if (!_chunkOAAMDWSKjs.shouldCaptureOutput.call(void 0, )) {
-      logRecord.body = void 0;
-    }
-    if (!logRecord.context && !(options == null ? void 0 : options.excludeContext)) {
-      logRecord.context = _api.context.active();
-    }
-    this.logger.emit(logRecord);
-  }
-  emitGenAISystemMessageEvent(body, system, attributes) {
-    var _a;
-    this.emitGenAIEvent(
-      LOG_EVNT_GEN_AI_SYSTEM_MESSAGE,
-      _chunkOHM7JUMRjs.__spreadProps.call(void 0, _chunkOHM7JUMRjs.__spreadValues.call(void 0, {}, body), { role: (_a = body.role) != null ? _a : "system" }),
-      _chunkOHM7JUMRjs.__spreadProps.call(void 0, _chunkOHM7JUMRjs.__spreadValues.call(void 0, {}, attributes), {
-        "gen_ai.system": system
-      })
-    );
-  }
-  emitGenAIUserMessageEvent(body, system, attributes) {
-    var _a;
-    this.emitGenAIEvent(
-      LOG_EVNT_GEN_AI_USER_MESSAGE,
-      _chunkOHM7JUMRjs.__spreadProps.call(void 0, _chunkOHM7JUMRjs.__spreadValues.call(void 0, {}, body), { role: (_a = body.role) != null ? _a : "user" }),
-      _chunkOHM7JUMRjs.__spreadProps.call(void 0, _chunkOHM7JUMRjs.__spreadValues.call(void 0, {}, attributes), {
-        "gen_ai.system": system
-      })
-    );
-  }
-  emitGenAIAssistantMessageEvent(body, system, attributes) {
-    var _a;
-    this.emitGenAIEvent(
-      LOG_EVNT_GEN_AI_ASSISTANT_MESSAGE,
-      _chunkOHM7JUMRjs.__spreadProps.call(void 0, _chunkOHM7JUMRjs.__spreadValues.call(void 0, {}, body), { role: (_a = body.role) != null ? _a : "assistant" }),
-      _chunkOHM7JUMRjs.__spreadProps.call(void 0, _chunkOHM7JUMRjs.__spreadValues.call(void 0, {}, 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,
-      _chunkOHM7JUMRjs.__spreadValues.call(void 0, {}, body),
-      _chunkOHM7JUMRjs.__spreadProps.call(void 0, _chunkOHM7JUMRjs.__spreadValues.call(void 0, {}, 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,
-      _chunkOHM7JUMRjs.__spreadProps.call(void 0, _chunkOHM7JUMRjs.__spreadValues.call(void 0, {}, body), {
-        message: _chunkOHM7JUMRjs.__spreadProps.call(void 0, _chunkOHM7JUMRjs.__spreadValues.call(void 0, {}, body.message), { role: (_b = (_a = body.message) == null ? void 0 : _a.role) != null ? _b : "assistant" })
-      }),
-      _chunkOHM7JUMRjs.__spreadProps.call(void 0, _chunkOHM7JUMRjs.__spreadValues.call(void 0, {}, attributes), {
-        "gen_ai.system": system
-      })
-    );
-  }
-  emitGenAIEvent(eventName, body, attributes) {
-    this.emit({
-      eventName,
-      context: _api.context.active(),
-      attributes: _chunkOHM7JUMRjs.__spreadValues.call(void 0, {}, attributes),
-      body: _chunkOAAMDWSKjs.shouldCaptureOutput.call(void 0, ) ? body : void 0,
-      observedTimestamp: (/* @__PURE__ */ new Date()).getTime()
-    });
-  }
-};
-
-// src/observability-sdk/logger/index.ts
-var currentLoggerProvider = new (0, _apilogs.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);
-}
-
-
-
-
-
-
-
-exports.LangWatchTraceExporter = LangWatchTraceExporter; exports.LangWatchLogsExporter = LangWatchLogsExporter; exports.setLangWatchLoggerProvider = setLangWatchLoggerProvider; exports.getLangWatchLogger = getLangWatchLogger; exports.getLangWatchLoggerFromProvider = getLangWatchLoggerFromProvider;
-//# sourceMappingURL=chunk-INNMPLUT.js.map

package/dist/chunk-INNMPLUT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-INNMPLUT.js","../src/observability-sdk/exporters/langwatch-trace-exporter.ts","../src/observability-sdk/exporters/trace-filters.ts","../src/observability-sdk/exporters/langwatch-logs-exporter.ts","../src/observability-sdk/semconv/events.ts","../src/observability-sdk/logger/index.ts","../src/observability-sdk/logger/implementation.ts"],"names":["_a"],"mappings":"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","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-INNMPLUT.js","sourcesContent":[null,"import { OTLPTraceExporter } from \"@opentelemetry/exporter-trace-otlp-http\";\nimport { type ReadableSpan } from \"@opentelemetry/sdk-trace-base\";\nimport { type ExportResult } from '@opentelemetry/core';\nimport {\n  DEFAULT_ENDPOINT,\n  LANGWATCH_SDK_LANGUAGE,\n  LANGWATCH_SDK_NAME_OBSERVABILITY,\n  LANGWATCH_SDK_RUNTIME,\n  LANGWATCH_SDK_VERSION,\n  TRACES_PATH,\n} from \"../../internal/constants\";\nimport {\n  type TraceFilter,\n  type Criteria,\n  type Match,\n  applyFilters,\n} from \"./trace-filters\";\n\n/**\n * Configuration options for the LangWatchTraceExporter.\n *\n * @property endpoint - Custom LangWatch endpoint URL. Falls back to LANGWATCH_ENDPOINT env var or default.\n * @property apiKey - API key for authentication. Falls back to LANGWATCH_API_KEY env var.\n * @property filters - Array of filters applied sequentially to spans before export.\n *                     Default: `[{ preset: \"excludeHttpRequests\" }]` to reduce framework noise.\n *                     Pass `null` or `[]` to disable all filtering.\n */\nexport interface LangWatchTraceExporterOptions {\n  endpoint?: string;\n  apiKey?: string;\n  filters?: TraceFilter[] | null;\n}\n\nexport type { TraceFilter, Criteria, Match };\n\n/**\n * LangWatchTraceExporter extends the OpenTelemetry OTLP HTTP trace exporter\n * to send trace data to LangWatch with proper authentication and metadata headers.\n *\n * ## Features\n * - Automatic authorization header configuration via API key\n * - SDK version and runtime identification headers\n * - Proper endpoint URL construction for LangWatch ingestion\n * - Intent-based span filtering with presets and custom criteria\n *\n * ## Filtering Behavior\n * - **Default**: HTTP request spans are excluded to reduce framework noise\n * - **Pipeline**: Filters are applied sequentially with AND semantics\n * - **Matching**: All string comparisons are case-sensitive by default\n * - **Array Syntax**: All criteria require arrays of Match objects for explicit filtering\n *\n * ## Filter Types\n * - **Presets**: Pre-configured common filters (`vercelAIOnly`, `excludeHttpRequests`)\n * - **Include**: Keep only spans matching criteria (OR within field, AND across fields)\n * - **Exclude**: Remove spans matching criteria (OR within field, AND across fields)\n *\n * @example Basic usage with default filtering\n * ```typescript\n * import { LangWatchTraceExporter } from '@langwatch/observability';\n *\n * // Default: excludes HTTP request spans\n * const exporter = new LangWatchTraceExporter();\n * ```\n *\n * @example Using presets\n * ```typescript\n * // Keep only Vercel AI SDK spans\n * const exporterAI = new LangWatchTraceExporter({\n *   filters: [{ preset: 'vercelAIOnly' }],\n * });\n *\n * // Explicitly exclude HTTP requests (same as default)\n * const exporterNoHttp = new LangWatchTraceExporter({\n *   filters: [{ preset: 'excludeHttpRequests' }],\n * });\n *\n * // No filtering at all (send all spans)\n * const exporterAll = new LangWatchTraceExporter({\n *   filters: null, // or filters: []\n * });\n * ```\n *\n * @example Custom filtering with criteria\n * ```typescript\n * // Include only spans with specific scope\n * const exporter1 = new LangWatchTraceExporter({\n *   filters: [\n *     { include: { instrumentationScopeName: [{ equals: 'ai' }] } }\n *   ],\n * });\n *\n * // Exclude spans by name pattern\n * const exporter2 = new LangWatchTraceExporter({\n *   filters: [\n *     { exclude: { name: [{ startsWith: 'internal.' }] } }\n *   ],\n * });\n *\n * // Case-insensitive matching\n * const exporter3 = new LangWatchTraceExporter({\n *   filters: [\n *     { include: { name: [{ equals: 'chat.completion', ignoreCase: true }] } }\n *   ],\n * });\n * ```\n *\n * @example Filter pipelines (AND semantics)\n * ```typescript\n * // Keep AI spans, then remove HTTP requests\n * const exporter = new LangWatchTraceExporter({\n *   filters: [\n *     { include: { instrumentationScopeName: [{ equals: 'ai' }] } },\n *     { preset: 'excludeHttpRequests' },\n *   ],\n * });\n * ```\n *\n * @example OR semantics within a field\n * ```typescript\n * // Include spans with name starting with 'chat.' OR 'llm.'\n * const exporter = new LangWatchTraceExporter({\n *   filters: [\n *     {\n *       include: {\n *         name: [\n *           { startsWith: 'chat.' },\n *           { startsWith: 'llm.' }\n *         ]\n *       }\n *     }\n *   ],\n * });\n * ```\n *\n * @example Using regex patterns\n * ```typescript\n * const exporter = new LangWatchTraceExporter({\n *   filters: [\n *     {\n *       include: {\n *         name: [{ matches: /^(chat|llm)\\./i }]\n *       }\n *     }\n *   ],\n * });\n * ```\n */\nexport class LangWatchTraceExporter extends OTLPTraceExporter {\n  private readonly filters: TraceFilter[];\n  /**\n   * Creates a new LangWatchTraceExporter instance.\n   *\n   * @param opts - Configuration options for the exporter\n   * @param opts.apiKey - API key for LangWatch authentication.\n   *                     Falls back to `LANGWATCH_API_KEY` environment variable, then empty string.\n   * @param opts.endpoint - Custom endpoint URL for LangWatch ingestion.\n   *                       Falls back to `LANGWATCH_ENDPOINT` environment variable, then default endpoint.\n   * @param opts.filters - Array of filters applied sequentially to spans before export (AND semantics).\n   *                      When omitted, defaults to `[{ preset: \"excludeHttpRequests\" }]`.\n   *                      Pass `null` or `[]` to disable all filtering and send all spans.\n   *\n   * @example\n   * ```typescript\n   * // With API key and default filtering\n   * const exporter = new LangWatchTraceExporter({\n   *   apiKey: 'your-api-key'\n   * });\n   *\n   * // With custom endpoint and no filtering\n   * const exporter = new LangWatchTraceExporter({\n   *   endpoint: 'https://custom.langwatch.ai',\n   *   filters: null\n   * });\n   * ```\n   */\n  constructor(opts?: LangWatchTraceExporterOptions) {\n    const apiKey = opts?.apiKey ?? process.env.LANGWATCH_API_KEY ?? \"\";\n    const endpoint =\n      opts?.endpoint ??\n      process.env.LANGWATCH_ENDPOINT ??\n      DEFAULT_ENDPOINT;\n\n    const url = new URL(TRACES_PATH, endpoint);\n    const otelEndpoint = url.toString();\n\n    super({\n      headers: {\n        \"x-langwatch-sdk-name\": LANGWATCH_SDK_NAME_OBSERVABILITY,\n        \"x-langwatch-sdk-language\": LANGWATCH_SDK_LANGUAGE,\n        \"x-langwatch-sdk-version\": LANGWATCH_SDK_VERSION,\n        \"x-langwatch-sdk-runtime\": LANGWATCH_SDK_RUNTIME(),\n        ...(apiKey ? { authorization: `Bearer ${apiKey}` } : {}),\n      },\n      url: otelEndpoint.toString(),\n    });\n\n    // Handle filters: null or [] = no filtering, undefined = default, array = use provided\n    if (opts?.filters === null || (Array.isArray(opts?.filters) && opts.filters.length === 0)) {\n      this.filters = [];\n    } else if (Array.isArray(opts?.filters)) {\n      this.filters = opts.filters;\n    } else {\n      this.filters = [{ preset: \"excludeHttpRequests\" }];\n    }\n  }\n\n  export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void {\n    const filtered = applyFilters(this.filters, spans);\n    super.export(filtered, resultCallback);\n  }\n}\n","import { type ReadableSpan } from \"@opentelemetry/sdk-trace-base\";\n\nexport interface Criteria {\n  instrumentationScopeName?: Match[];\n  name?: Match[];\n}\n\nexport interface Match {\n  equals?: string;\n  startsWith?: string;\n  matches?: RegExp;\n  ignoreCase?: boolean;\n}\n\nexport type TraceFilter =\n  | { preset: \"vercelAIOnly\" | \"excludeHttpRequests\" }\n  | { include: Criteria }\n  | { exclude: Criteria };\n\n/**\n * Applies a sequence of filters to an array of spans using AND semantics.\n * Each filter in the sequence is applied to the result of the previous filter,\n * progressively narrowing down the set of spans.\n *\n * @param filters - Array of filter rules to apply sequentially\n * @param spans - Array of spans to filter\n * @returns Filtered array of spans that match all filter criteria\n *\n * @example\n * ```typescript\n * const filters: TraceFilter[] = [\n *   { include: { instrumentationScopeName: [{ equals: 'ai' }] } },\n *   { preset: 'excludeHttpRequests' }\n * ];\n * const filtered = applyFilters(filters, spans);\n * // Returns only AI spans that are not HTTP requests\n * ```\n */\nexport function applyFilters(\n  filters: TraceFilter[] | undefined,\n  spans: ReadableSpan[]\n): ReadableSpan[] {\n  if (!filters || filters.length === 0) return spans;\n  return filters.reduce((current, rule) => applyFilterRule(rule, current), spans);\n}\n\n/**\n * Applies a single filter rule to an array of spans.\n * Handles three types of filters: presets, include rules, and exclude rules.\n *\n * @param rule - Single filter rule (preset, include, or exclude)\n * @param spans - Array of spans to filter\n * @returns Filtered array of spans based on the rule\n *\n * @example\n * ```typescript\n * // Using preset\n * const filtered1 = applyFilterRule({ preset: 'vercelAIOnly' }, spans);\n *\n * // Using include\n * const filtered2 = applyFilterRule(\n *   { include: { name: [{ startsWith: 'llm.' }] } },\n *   spans\n * );\n *\n * // Using exclude\n * const filtered3 = applyFilterRule(\n *   { exclude: { instrumentationScopeName: [{ equals: 'http' }] } },\n *   spans\n * );\n * ```\n */\nexport function applyFilterRule(rule: TraceFilter, spans: ReadableSpan[]): ReadableSpan[] {\n  if (\"preset\" in rule && rule.preset) {\n    return applyPreset(\n      (rule as { preset: TraceFilter extends { preset: infer P } ? P : never }).preset as any,\n      spans\n    );\n  }\n\n  if (\"include\" in rule && rule.include) {\n    const criteria = (rule as { include: Criteria }).include;\n    return spans.filter((s) => matchesCriteria(s, criteria));\n  }\n\n  if (\"exclude\" in rule && rule.exclude) {\n    const criteria = (rule as { exclude: Criteria }).exclude;\n    return spans.filter((s) => !matchesCriteria(s, criteria));\n  }\n\n  return spans;\n}\n\n/**\n * Applies a preset filter to an array of spans.\n * Presets are predefined common filtering patterns.\n *\n * Available presets:\n * - `vercelAIOnly`: Keeps only spans from the Vercel AI SDK (instrumentationScope.name === 'ai')\n * - `excludeHttpRequests`: Removes spans that appear to be HTTP requests (span name starts with HTTP verb)\n *\n * @param preset - Name of the preset filter to apply\n * @param spans - Array of spans to filter\n * @returns Filtered array of spans based on the preset\n *\n * @example\n * ```typescript\n * // Keep only Vercel AI spans\n * const aiSpans = applyPreset('vercelAIOnly', spans);\n *\n * // Remove HTTP request spans\n * const noHttpSpans = applyPreset('excludeHttpRequests', spans);\n * ```\n */\nexport function applyPreset(\n  preset: \"vercelAIOnly\" | \"excludeHttpRequests\",\n  spans: ReadableSpan[]\n): ReadableSpan[] {\n  if (preset === \"vercelAIOnly\") return spans.filter((s) => isVercelAiSpan(s));\n  if (preset === \"excludeHttpRequests\") return spans.filter((s) => !isHttpRequestSpan(s));\n\n  return spans;\n}\n\n/**\n * Checks if a span matches the given criteria.\n * All specified criteria fields must match (AND semantics within a criteria object).\n * Within each field, matchers are evaluated with OR semantics (any matcher can match).\n *\n * @param span - Span to evaluate\n * @param criteria - Criteria to match against (instrumentationScopeName and/or name)\n * @returns True if the span matches all specified criteria, false otherwise\n *\n * @example\n * ```typescript\n * const criteria: Criteria = {\n *   instrumentationScopeName: [{ equals: 'ai' }],\n *   name: [{ startsWith: 'llm.' }, { startsWith: 'chat.' }]\n * };\n * const matches = matchesCriteria(span, criteria);\n * // Returns true if scope is 'ai' AND name starts with 'llm.' OR 'chat.'\n * ```\n */\nexport function matchesCriteria(span: ReadableSpan, criteria: Criteria): boolean {\n  if (criteria.instrumentationScopeName !== void 0) {\n    const scopeName = span.instrumentationScope?.name ?? \"\";\n    const ok = criteria.instrumentationScopeName.some((m) => valueMatches(scopeName, m));\n    if (!ok) return false;\n  }\n\n  if (criteria.name !== void 0) {\n    const ok = criteria.name.some((m) => valueMatches(span.name ?? \"\", m));\n    if (!ok) return false;\n  }\n\n  return true;\n}\n\n/**\n * Evaluates if a string value matches a given match rule.\n * Supports three types of matching: exact equality, prefix matching, and regex matching.\n * All matching is case-sensitive by default unless `ignoreCase` is explicitly set to true.\n *\n * @param value - String value to evaluate\n * @param rule - Match rule specifying the matching criteria\n * @returns True if the value matches the rule, false otherwise\n *\n * @example\n * ```typescript\n * // Exact match (case-sensitive by default)\n * valueMatches('GET /api/users', { equals: 'GET /api/users' }); // true\n * valueMatches('get /api/users', { equals: 'GET /api/users' }); // false\n *\n * // Case-insensitive exact match\n * valueMatches('get /api/users', { equals: 'GET /api/users', ignoreCase: true }); // true\n *\n * // Prefix match\n * valueMatches('GET /api/users', { startsWith: 'GET' }); // true\n * valueMatches('POST /api/users', { startsWith: 'GET' }); // false\n *\n * // Regex match\n * valueMatches('GET /api/users', { matches: /^(GET|POST)\\b/ }); // true\n *\n * // Case-insensitive regex\n * valueMatches('get /api/users', { matches: /^GET\\b/, ignoreCase: true }); // true\n * ```\n */\nexport function valueMatches(value: string, rule: Match): boolean {\n  const raw = value ?? \"\";\n  const ignoreCase = rule.ignoreCase ?? false;\n\n  if (rule.equals !== void 0) {\n    return ignoreCase\n      ? raw.localeCompare(rule.equals, void 0, { sensitivity: \"base\" }) === 0\n      : raw === rule.equals;\n  }\n\n  if (rule.startsWith !== void 0) {\n    return ignoreCase\n      ? raw.toLowerCase().startsWith(rule.startsWith.toLowerCase())\n      : raw.startsWith(rule.startsWith);\n  }\n\n  if (rule.matches instanceof RegExp) {\n    const re =\n      ignoreCase && !rule.matches.flags.includes(\"i\")\n        ? new RegExp(rule.matches.source, (rule.matches.flags || \"\") + \"i\")\n        : rule.matches;\n    return re.test(raw);\n  }\n\n  return false;\n}\n\n/**\n * Checks if a span is from the Vercel AI SDK.\n * A span is considered a Vercel AI span if its instrumentation scope name is 'ai' (case-insensitive).\n *\n * @param span - Span to check\n * @returns True if the span is from the Vercel AI SDK, false otherwise\n *\n * @example\n * ```typescript\n * if (isVercelAiSpan(span)) {\n *   console.log('This is a Vercel AI operation');\n * }\n * ```\n */\nexport function isVercelAiSpan(span: ReadableSpan): boolean {\n  const scope = span.instrumentationScope?.name?.toLowerCase?.() ?? \"\";\n  return scope === \"ai\";\n}\n\n/**\n * Checks if a span appears to be an HTTP request based on its name.\n * A span is considered an HTTP request if its name starts with a common HTTP verb\n * (GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD) followed by a word boundary.\n *\n * @param span - Span to check\n * @returns True if the span appears to be an HTTP request, false otherwise\n *\n * @example\n * ```typescript\n * // These would return true:\n * // span.name = \"GET /api/users\"\n * // span.name = \"POST /api/data\"\n * // span.name = \"DELETE /resource/123\"\n *\n * if (isHttpRequestSpan(span)) {\n *   console.log('This is an HTTP request span');\n * }\n * ```\n */\nexport function isHttpRequestSpan(span: ReadableSpan): boolean {\n  const name = span.name ?? \"\";\n  const verbMatch = /^(GET|POST|PUT|DELETE|PATCH|OPTIONS|HEAD)\\b/i.test(name);\n  return verbMatch;\n}\n","import { OTLPLogExporter } from \"@opentelemetry/exporter-logs-otlp-http\";\nimport {\n  DEFAULT_ENDPOINT,\n  LANGWATCH_SDK_LANGUAGE,\n  LANGWATCH_SDK_NAME_OBSERVABILITY,\n  LANGWATCH_SDK_RUNTIME,\n  LANGWATCH_SDK_VERSION,\n  LOGS_PATH,\n} from \"../../internal/constants\";\n\nexport interface LangWatchLogsExporterOptions {\n  endpoint?: string;\n  apiKey?: string;\n}\n\n/**\n * LangWatchLogsExporter extends the OpenTelemetry OTLP HTTP logs exporter\n * to send logs to LangWatch with proper authentication and metadata headers.\n *\n * This exporter automatically configures:\n * - Authorization headers using the provided API key or environment variables/fallback\n * - SDK version and language identification headers\n * - Proper endpoint configuration for LangWatch ingestion using provided URL or environment variables/fallback\n *\n * @example\n * ```typescript\n * import { LangWatchLogsExporter } from '@langwatch/observability';\n *\n * // Using environment variables/fallback configuration\n * const exporter = new LangWatchLogsExporter();\n *\n * // Using custom options\n * const exporter = new LangWatchLogsExporter({\n *   apiKey: 'your-api-key',\n *   endpoint: 'https://custom.langwatch.com'\n * });\n * ```\n */\nexport class LangWatchLogsExporter extends OTLPLogExporter {\n  /**\n   * Creates a new LangWatchLogsExporter instance.\n   *\n   * @param opts - Optional configuration options for the exporter.\n   * @param opts.apiKey - Optional API key for LangWatch authentication. If not provided,\n   *                     will use environment variables or fallback configuration.\n   * @param opts.endpoint - Optional custom endpoint URL for LangWatch ingestion.\n   *                       If not provided, will use environment variables or fallback configuration.\n   */\n  constructor(opts?: LangWatchLogsExporterOptions) {\n    const apiKey = opts?.apiKey ?? process.env.LANGWATCH_API_KEY ?? \"\";\n    const endpoint =\n      opts?.endpoint ??\n      process.env.LANGWATCH_ENDPOINT ??\n      DEFAULT_ENDPOINT;\n\n    const url = new URL(LOGS_PATH, endpoint);\n    const otelEndpoint = url.toString();\n\n    super({\n      headers: {\n        \"x-langwatch-sdk-name\": LANGWATCH_SDK_NAME_OBSERVABILITY,\n        \"x-langwatch-sdk-language\": LANGWATCH_SDK_LANGUAGE,\n        \"x-langwatch-sdk-version\": LANGWATCH_SDK_VERSION,\n        \"x-langwatch-sdk-runtime\": LANGWATCH_SDK_RUNTIME(),\n        ...(apiKey ? { authorization: `Bearer ${apiKey}` } : {}),\n      },\n      url: otelEndpoint.toString(),\n    });\n  }\n}\n","/*\n  This file contains the values for the OpenTelemetry semantic conventions for GenAI log\n  record event names.\n\n  👉 https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-events/\n*/\n\n/**\n * GenAI system message event name\n * Used for log records representing system messages in AI conversations\n */\nexport const LOG_EVNT_GEN_AI_SYSTEM_MESSAGE = \"gen.ai.system_message\";\n\n/**\n * GenAI user message event name\n * Used for log records representing user messages in AI conversations\n */\nexport const LOG_EVNT_GEN_AI_USER_MESSAGE = \"gen.ai.user_message\";\n\n/**\n * GenAI assistant message event name\n * Used for log records representing assistant responses in AI conversations\n */\nexport const LOG_EVNT_GEN_AI_ASSISTANT_MESSAGE = \"gen.ai.assistant_message\";\n\n/**\n * GenAI tool message event name\n * Used for log records representing tool calls or responses in AI conversations\n */\nexport const LOG_EVNT_GEN_AI_TOOL_MESSAGE = \"gen.ai.tool_message\";\n\n/**\n * GenAI choice event name\n * Used for log records representing choices made by AI models\n */\nexport const LOG_EVNT_GEN_AI_CHOICE = \"gen.ai.choice\";\n\n/**\n * LangWatch LangChain callback event name\n * Used for log records representing LangChain callback events\n */\nexport const EVNT_LANGWATCH_LANGCHAIN_CALLBACK = \"langwatch.langchain.callback\";\n","import {\n  type Logger,\n  type LoggerProvider,\n  NoopLoggerProvider,\n} from \"@opentelemetry/api-logs\";\nimport {\n  type LangWatchLogger,\n} from \"./types\";\nimport { LangWatchLoggerInternal } from \"./implementation\";\n\n/**\n * The LangWatch-specific global logger provider. It may not be the same as the current\n * OpenTelemetry global logger provider, but it's the last one the `setupObservability`\n * knows about.\n * @internal\n */\nlet currentLoggerProvider: LoggerProvider = new NoopLoggerProvider();\n\n/**\n * @module observability/logger\n * @description\n * Provides LangWatch logger integration with OpenTelemetry, including logger provider\n * management and logger creation utilities.\n *\n * @remarks\n * This module allows you to set a global logger provider, retrieve LangWatch loggers,\n * and wrap OpenTelemetry loggers with LangWatch-specific functionality.\n *\n * @see {@link setLangWatchLoggerProvider}\n * @see {@link getLangWatchLogger}\n * @see {@link getLangWatchLoggerFromProvider}\n * @see {@link createLangWatchLogger}\n */\nexport function setLangWatchLoggerProvider(\n  loggerProvider: LoggerProvider,\n): void {\n  currentLoggerProvider = loggerProvider;\n}\n\n/**\n * Retrieves a LangWatch logger with the specified name and optional version.\n *\n * @param name - The name of the logger (typically your service or module name).\n * @param version - (Optional) The version of the logger.\n * @returns A {@link LangWatchLogger} instance.\n *\n * @remarks\n * Uses the logger provider set during observability setup. If no provider is set, returns\n * a NoOp logger.\n *\n * @example\n * ```ts\n * const logger = getLangWatchLogger(\"my-service\");\n * logger.info(\"Service started\");\n * ```\n *\n * @see {@link setLangWatchLoggerProvider}\n */\nexport function getLangWatchLogger(\n  name: string,\n  version?: string,\n): LangWatchLogger {\n  return getLangWatchLoggerFromProvider(currentLoggerProvider, name, version);\n}\n\n/**\n * Retrieves a LangWatch logger from a specific OpenTelemetry logger provider.\n *\n * @param loggerProvider - The OpenTelemetry logger provider to use.\n * @param name - The name of the logger.\n * @param version - (Optional) The version of the logger.\n * @returns A {@link LangWatchLogger} instance.\n *\n * @remarks\n * Use this function if you want to use a custom logger provider instead of the global one.\n *\n * @example\n * ```ts\n * const customProvider = new LoggerProvider();\n * const logger = getLangWatchLoggerFromProvider(customProvider, \"custom-service\");\n * ```\n */\nexport function getLangWatchLoggerFromProvider(\n  loggerProvider: LoggerProvider,\n  name: string,\n  version?: string,\n): LangWatchLogger {\n  return createLangWatchLogger(loggerProvider.getLogger(name, version));\n}\n\n/**\n * Wraps an OpenTelemetry logger as a LangWatch logger.\n *\n * @param logger - The OpenTelemetry logger to wrap.\n * @returns A {@link LangWatchLogger} instance.\n *\n * @example\n * ```ts\n * import { Logger } from \"@opentelemetry/api-logs\";\n * const otelLogger = new Logger();\n * const lwLogger = createLangWatchLogger(otelLogger);\n * lwLogger.info(\"Wrapped logger\");\n * ```\n */\nexport function createLangWatchLogger(logger: Logger): LangWatchLogger {\n  return new LangWatchLoggerInternal(logger);\n}\n\n// Export types and implementation\nexport * from \"./types\";\nexport * from \"./implementation\";\n","import {\n  type AnyValue,\n  type Logger,\n} from \"@opentelemetry/api-logs\";\nimport {\n  type EmitOptions,\n  type LangWatchLogger,\n  type LangWatchLogRecord,\n  type LangWatchSpanGenAIAssistantMessageEventBody,\n  type LangWatchSpanGenAIChoiceEventBody,\n  type LangWatchSpanGenAISystemMessageEventBody,\n  type LangWatchSpanGenAIToolMessageEventBody,\n  type LangWatchSpanGenAIUserMessageEventBody,\n} from \"./types\";\nimport { shouldCaptureOutput } from \"../config\";\nimport * as intSemconv from \"../semconv\";\nimport { type SemConvLogRecordAttributes } from \"../semconv\";\nimport { context } from \"@opentelemetry/api\";\n\n/**\n * Internal implementation of {@link LangWatchLogger}.\n *\n * @remarks\n * This class wraps an OpenTelemetry logger and adds LangWatch-specific functionality for\n * structured logging and event emission.\n * Not intended for direct use; use {@link getLangWatchLogger} or\n * {@link createLangWatchLogger} instead.\n */\nexport class LangWatchLoggerInternal implements LangWatchLogger {\n  constructor(private logger: Logger) {}\n\n  emit(logRecord: LangWatchLogRecord, options?: EmitOptions): void {\n    // Handle output capture configuration\n    if (!shouldCaptureOutput()) {\n      logRecord.body = void 0;\n    }\n\n    // Set context if not provided and not explicitly excluded\n    if (!logRecord.context && !options?.excludeContext) {\n      logRecord.context = context.active();\n    }\n\n    // Emit the log record through the underlying OpenTelemetry logger\n    this.logger.emit(logRecord);\n  }\n\n  emitGenAISystemMessageEvent(\n    body: LangWatchSpanGenAISystemMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: SemConvLogRecordAttributes,\n  ): void {\n    this.emitGenAIEvent(\n      intSemconv.LOG_EVNT_GEN_AI_SYSTEM_MESSAGE,\n      { ...body, role: body.role ?? \"system\" } satisfies LangWatchSpanGenAISystemMessageEventBody,\n      {\n        ...attributes,\n        \"gen_ai.system\": system,\n      },\n    );\n  }\n\n  emitGenAIUserMessageEvent(\n    body: LangWatchSpanGenAIUserMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: SemConvLogRecordAttributes,\n  ) {\n    this.emitGenAIEvent(\n      intSemconv.LOG_EVNT_GEN_AI_USER_MESSAGE,\n      { ...body, role: body.role ?? \"user\" } satisfies LangWatchSpanGenAIUserMessageEventBody,\n      {\n        ...attributes,\n        \"gen_ai.system\": system,\n      },\n    );\n  }\n\n  emitGenAIAssistantMessageEvent(\n    body: LangWatchSpanGenAIAssistantMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: SemConvLogRecordAttributes,\n  ) {\n    this.emitGenAIEvent(\n      intSemconv.LOG_EVNT_GEN_AI_ASSISTANT_MESSAGE,\n      { ...body, role: body.role ?? \"assistant\" } satisfies LangWatchSpanGenAIAssistantMessageEventBody,\n      {\n        ...attributes,\n        \"gen_ai.system\": system,\n      },\n    );\n  }\n\n  emitGenAIToolMessageEvent(\n    body: LangWatchSpanGenAIToolMessageEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: SemConvLogRecordAttributes,\n  ) {\n    if (body.role === void 0) {\n      body.role = \"tool\";\n    }\n\n    this.emitGenAIEvent(\n      intSemconv.LOG_EVNT_GEN_AI_TOOL_MESSAGE,\n      { ...body },\n      {\n        ...attributes,\n        \"gen_ai.system\": system,\n      },\n    );\n  }\n\n  emitGenAIChoiceEvent(\n    body: LangWatchSpanGenAIChoiceEventBody,\n    system?: intSemconv.VAL_GEN_AI_SYSTEMS | (string & {}),\n    attributes?: SemConvLogRecordAttributes,\n  ) {\n    if (body.message && body.message.role === void 0) {\n      body.message.role = \"assistant\";\n    }\n\n    this.emitGenAIEvent(\n      intSemconv.LOG_EVNT_GEN_AI_CHOICE,\n      {\n        ...body,\n        message: { ...body.message, role: body.message?.role ?? \"assistant\" },\n      } satisfies LangWatchSpanGenAIChoiceEventBody,\n      {\n        ...attributes,\n        \"gen_ai.system\": system,\n      },\n    );\n  }\n\n  private emitGenAIEvent(\n    eventName: string,\n    body: AnyValue,\n    attributes?: SemConvLogRecordAttributes,\n  ): void {\n    this.emit({\n      eventName,\n      context: context.active(),\n      attributes: { ...attributes },\n      body: shouldCaptureOutput() ? body : void 0,\n      observedTimestamp: new Date().getTime(),\n    });\n  }\n}\n"]}

package/dist/chunk-ITE5FJGZ.js

@@ -1,53 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-var _chunkX7ZWFNXLjs = require('./chunk-X7ZWFNXL.js');
-
-
-
-var _chunkC5Y772G7js = require('./chunk-C5Y772G7.js');
-
-// src/client-sdk/services/workflows/workflows-api.service.ts
-var WorkflowsApiError = class extends Error {
-  constructor(message, operation, originalError) {
-    super(message);
-    this.operation = operation;
-    this.originalError = originalError;
-    this.name = "WorkflowsApiError";
-  }
-};
-var WorkflowsApiService = class {
-  constructor(config) {
-    var _a;
-    this.apiClient = (_a = config == null ? void 0 : config.langwatchApiClient) != null ? _a : _chunkX7ZWFNXLjs.createLangWatchApiClient.call(void 0, );
-  }
-  handleApiError(operation, error) {
-    const message = _chunkC5Y772G7js.formatApiErrorForOperation.call(void 0, { operation, error, options: {
-      status: _chunkC5Y772G7js.extractStatusFromResponse.call(void 0, error)
-    } });
-    throw new WorkflowsApiError(message, operation, error);
-  }
-  async getAll() {
-    const { data, error } = await this.apiClient.GET("/api/workflows");
-    if (error) this.handleApiError("list workflows", error);
-    return data;
-  }
-  async get(id) {
-    const { data, error } = await this.apiClient.GET("/api/workflows/{id}", {
-      params: { path: { id } }
-    });
-    if (error) this.handleApiError(`get workflow "${id}"`, error);
-    return data;
-  }
-  async delete(id) {
-    const { data, error } = await this.apiClient.DELETE("/api/workflows/{id}", {
-      params: { path: { id } }
-    });
-    if (error) this.handleApiError(`delete workflow "${id}"`, error);
-    return data;
-  }
-};
-
-
-
-exports.WorkflowsApiService = WorkflowsApiService;
-//# sourceMappingURL=chunk-ITE5FJGZ.js.map

package/dist/chunk-ITE5FJGZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-ITE5FJGZ.js","../src/client-sdk/services/workflows/workflows-api.service.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACE;AACA;AACF,sDAA4B;AAC5B;AACA;ACUO,IAAM,kBAAA,EAAN,MAAA,QAAgC,MAAM;AAAA,EAC3C,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,mBAAA;AAAA,EACd;AACF,CAAA;AAEO,IAAM,oBAAA,EAAN,MAA0B;AAAA,EAG/B,WAAA,CAAY,MAAA,EAAqD;AAhCnE,IAAA,IAAA,EAAA;AAiCI,IAAA,IAAA,CAAK,UAAA,EAAA,CAAY,GAAA,EAAA,OAAA,GAAA,KAAA,EAAA,KAAA,EAAA,EAAA,MAAA,CAAQ,kBAAA,EAAA,GAAR,KAAA,EAAA,GAAA,EAA8B,uDAAA,CAAyB;AAAA,EAC1E;AAAA,EAEQ,cAAA,CAAe,SAAA,EAAmB,KAAA,EAAuB;AAC/D,IAAA,MAAM,QAAA,EAAU,yDAAA,EAA6B,SAAA,EAAsB,KAAA,EAAc,OAAA,EAAS;AAAA,MACxF,MAAA,EAAQ,wDAAA,KAA+B;AAAA,IACzC,EAAE,CAAC,CAAA;AACH,IAAA,MAAM,IAAI,iBAAA,CAAkB,OAAA,EAAS,SAAA,EAAW,KAAK,CAAA;AAAA,EACvD;AAAA,EAEA,MAAM,MAAA,CAAA,EAAsC;AAC1C,IAAA,MAAM,EAAE,IAAA,EAAM,MAAM,EAAA,EAAI,MAAM,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,gBAAgB,CAAA;AACjE,IAAA,GAAA,CAAI,KAAA,EAAO,IAAA,CAAK,cAAA,CAAe,gBAAA,EAAkB,KAAK,CAAA;AACtD,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,MAAM,GAAA,CAAI,EAAA,EAAuC;AAC/C,IAAA,MAAM,EAAE,IAAA,EAAM,MAAM,EAAA,EAAI,MAAM,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,qBAAA,EAAuB;AAAA,MACtE,MAAA,EAAQ,EAAE,IAAA,EAAM,EAAE,GAAG,EAAE;AAAA,IACzB,CAAC,CAAA;AACD,IAAA,GAAA,CAAI,KAAA,EAAO,IAAA,CAAK,cAAA,CAAe,CAAA,cAAA,EAAiB,EAAE,CAAA,CAAA,CAAA,EAAK,KAAK,CAAA;AAC5D,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,MAAM,MAAA,CAAO,EAAA,EAA6C;AACxD,IAAA,MAAM,EAAE,IAAA,EAAM,MAAM,EAAA,EAAI,MAAM,IAAA,CAAK,SAAA,CAAU,MAAA,CAAO,qBAAA,EAAuB;AAAA,MACzE,MAAA,EAAQ,EAAE,IAAA,EAAM,EAAE,GAAG,EAAE;AAAA,IACzB,CAAC,CAAA;AACD,IAAA,GAAA,CAAI,KAAA,EAAO,IAAA,CAAK,cAAA,CAAe,CAAA,iBAAA,EAAoB,EAAE,CAAA,CAAA,CAAA,EAAK,KAAK,CAAA;AAC/D,IAAA,OAAO,IAAA;AAAA,EACT;AACF,CAAA;ADhBA;AACA;AACE;AACF,kDAAC","file":"/home/runner/work/langwatch/langwatch/typescript-sdk/dist/chunk-ITE5FJGZ.js","sourcesContent":[null,"import type { paths } from \"@/internal/generated/openapi/api-client\";\nimport {\n  createLangWatchApiClient,\n  type LangwatchApiClient,\n} from \"@/internal/api/client\";\nimport { type InternalConfig } from \"@/client-sdk/types\";\nimport {\n  extractStatusFromResponse,\n  formatApiErrorForOperation,\n} from \"@/client-sdk/services/_shared/format-api-error\";\n\nexport type WorkflowResponse = NonNullable<\n  paths[\"/api/workflows\"][\"get\"][\"responses\"][\"200\"][\"content\"][\"application/json\"]\n>[number];\n\nexport type WorkflowDeleteResponse =\n  paths[\"/api/workflows/{id}\"][\"delete\"][\"responses\"][\"200\"][\"content\"][\"application/json\"];\n\nexport class WorkflowsApiError extends Error {\n  constructor(\n    message: string,\n    public readonly operation: string,\n    public readonly originalError?: unknown,\n  ) {\n    super(message);\n    this.name = \"WorkflowsApiError\";\n  }\n}\n\nexport class WorkflowsApiService {\n  private readonly apiClient: LangwatchApiClient;\n\n  constructor(config?: Pick<InternalConfig, \"langwatchApiClient\">) {\n    this.apiClient = config?.langwatchApiClient ?? createLangWatchApiClient();\n  }\n\n  private handleApiError(operation: string, error: unknown): never {\n    const message = formatApiErrorForOperation({ operation: operation, error: error, options: {\n      status: extractStatusFromResponse(error),\n    } });\n    throw new WorkflowsApiError(message, operation, error);\n  }\n\n  async getAll(): Promise<WorkflowResponse[]> {\n    const { data, error } = await this.apiClient.GET(\"/api/workflows\");\n    if (error) this.handleApiError(\"list workflows\", error);\n    return data;\n  }\n\n  async get(id: string): Promise<WorkflowResponse> {\n    const { data, error } = await this.apiClient.GET(\"/api/workflows/{id}\", {\n      params: { path: { id } },\n    });\n    if (error) this.handleApiError(`get workflow \"${id}\"`, error);\n    return data;\n  }\n\n  async delete(id: string): Promise<WorkflowDeleteResponse> {\n    const { data, error } = await this.apiClient.DELETE(\"/api/workflows/{id}\", {\n      params: { path: { id } },\n    });\n    if (error) this.handleApiError(`delete workflow \"${id}\"`, error);\n    return data;\n  }\n}\n"]}