@langfuse/core을(를) 5.x에서 6.x로 업그레이드하기

@langfuse/core 5.14.0과 6.0.0의 공개 API를 TypeScript 타입에서 자동으로 비교한 결과입니다. 시그니처 변경은 호환성이 깨질 가능성이 있다는 뜻이며 확정은 아닙니다.

요약

삭제된 import 경로	0
삭제된 export	75
변경된 시그니처	1
삭제된 클래스·인터페이스 멤버	10
변경된 클래스·인터페이스 멤버	1
새로 지원 중단됨	4
요구 사항 변경 (engines, peer 의존성)	1
새 export	8

삭제된 export

import	export	kind	이전
`@langfuse/core`	`Sort`	interface	`interface`
`@langfuse/core`	`Trace`	interface	`interface`
`@langfuse/core`	`Traces`	interface	`interface`
`@langfuse/core`	`legacy`	namespace	`namespace`
`@langfuse/core`	`ScoreV1`	type	`Numeric \| Categorical \| Boolean \| Text`
`@langfuse/core`	`Session`	interface	`interface`
`@langfuse/core`	`scoresV3`	namespace	`namespace`
`@langfuse/core`	`sessions`	namespace	`namespace`
`@langfuse/core`	`BaseEvent`	interface	`interface`
`@langfuse/core`	`TraceBody`	interface	`interface`
`@langfuse/core`	`ingestion`	namespace	`namespace`
`@langfuse/core`	`DatasetRun`	interface	`interface`
`@langfuse/core`	`ScoreEvent`	interface	`interface`
`@langfuse/core`	`SdkLogBody`	interface	`interface`
`@langfuse/core`	`TraceEvent`	interface	`interface`
`@langfuse/core`	`BaseScoreV1`	interface	`interface`
`@langfuse/core`	`Observation`	interface	`interface`
`@langfuse/core`	`SdkLogEvent`	interface	`interface`
`@langfuse/core`	`TextScoreV1`	interface	`interface`
`@langfuse/core`	`UsageDetails`	type	`Record<string, number> \| OpenAiCompletionUsageSchema \| OpenAiResponseUsageSchema`
`@langfuse/core`	`BooleanScoreV1`	interface	`interface`
`@langfuse/core`	`CreateSpanBody`	interface	`interface`
`@langfuse/core`	`DatasetRunItem`	interface	`interface`
`@langfuse/core`	`IngestionError`	interface	`interface`
`@langfuse/core`	`IngestionEvent`	type	`TraceCreate \| ScoreCreate \| SpanCreate \| SpanUpdate \| GenerationCreate \| GenerationUpdate \| EventCreate \| SdkLog \| ObservationCreate \| ObservationUpdate`
`@langfuse/core`	`IngestionUsage`	type	`Usage \| OpenAiUsage`
`@langfuse/core`	`NumericScoreV1`	interface	`interface`
`@langfuse/core`	`UpdateSpanBody`	interface	`interface`
`@langfuse/core`	`CreateEventBody`	interface	`interface`
`@langfuse/core`	`CreateSpanEvent`	interface	`interface`
`@langfuse/core`	`GetTraceRequest`	interface	`interface`
`@langfuse/core`	`ObservationBody`	interface	`interface`
`@langfuse/core`	`ObservationType`	type	`"SPAN" \| "GENERATION" \| "EVENT" \| "AGENT" \| "TOOL" \| "CHAIN" \| "RETRIEVER" \| "EVALUATOR" \| "EMBEDDING" \| "GUARDRAIL"`
`@langfuse/core`	`UpdateEventBody`	interface	`interface`
`@langfuse/core`	`UpdateSpanEvent`	interface	`interface`
`@langfuse/core`	`datasetRunItems`	namespace	`namespace`
`@langfuse/core`	`CreateEventEvent`	interface	`interface`
`@langfuse/core`	`GetScoresRequest`	interface	`interface`
`@langfuse/core`	`GetTracesRequest`	interface	`interface`
`@langfuse/core`	`IngestionRequest`	interface	`interface`
`@langfuse/core`	`IngestionSuccess`	interface	`interface`
`@langfuse/core`	`ObservationsView`	interface	`interface`
`@langfuse/core`	`TraceWithDetails`	interface	`interface`
`@langfuse/core`	`GetScoresResponse`	interface	`interface`
`@langfuse/core`	`IngestionResponse`	interface	`interface`
`@langfuse/core`	`PaginatedSessions`	interface	`interface`
`@langfuse/core`	`SessionWithTraces`	interface	`interface`
`@langfuse/core`	`CategoricalScoreV1`	interface	`interface`
`@langfuse/core`	`GetSessionsRequest`	interface	`interface`
`@langfuse/core`	`CreateScoreResponse`	interface	`interface`
`@langfuse/core`	`DatasetRunWithItems`	interface	`interface`
`@langfuse/core`	`CreateGenerationBody`	interface	`interface`
`@langfuse/core`	`PaginatedDatasetRuns`	interface	`interface`
`@langfuse/core`	`TraceWithFullDetails`	interface	`interface`
`@langfuse/core`	`UpdateGenerationBody`	interface	`interface`
`@langfuse/core`	`CreateGenerationEvent`	interface	`interface`
`@langfuse/core`	`GetDatasetRunsRequest`	interface	`interface`
`@langfuse/core`	`GetScoresResponseData`	type	`Numeric \| Categorical \| Boolean \| Correction \| Text`
`@langfuse/core`	`UpdateGenerationEvent`	interface	`interface`
`@langfuse/core`	`CreateObservationEvent`	interface	`interface`
`@langfuse/core`	`ObservationsViewSingle`	interface	`interface`
`@langfuse/core`	`UpdateObservationEvent`	interface	`interface`
`@langfuse/core`	`OptionalObservationBody`	interface	`interface`
`@langfuse/core`	`DeleteDatasetRunResponse`	interface	`interface`
`@langfuse/core`	`PaginatedDatasetRunItems`	interface	`interface`
`@langfuse/core`	`GetScoresResponseDataText`	interface	`interface`
`@langfuse/core`	`OpenAiResponseUsageSchema`	interface	`interface`
`@langfuse/core`	`GetScoresResponseTraceData`	interface	`interface`
`@langfuse/core`	`ListDatasetRunItemsRequest`	interface	`interface`
`@langfuse/core`	`CreateDatasetRunItemRequest`	interface	`interface`
`@langfuse/core`	`OpenAiCompletionUsageSchema`	interface	`interface`
`@langfuse/core`	`GetScoresResponseDataBoolean`	interface	`interface`
`@langfuse/core`	`GetScoresResponseDataNumeric`	interface	`interface`
`@langfuse/core`	`GetScoresResponseDataCorrection`	interface	`interface`
`@langfuse/core`	`GetScoresResponseDataCategorical`	interface	`interface`

변경된 시그니처

export	이전	이후
`@langfuse/core · BlobStorageIntegrationType`	`"S3" \| "S3_COMPATIBLE" \| "AZURE_BLOB_STORAGE"`	`"S3" \| "S3_COMPATIBLE" \| "AZURE_BLOB_STORAGE" \| "GOOGLE_CLOUD_STORAGE"`

삭제된 클래스·인터페이스 멤버

member	import	이전
`LangfuseAPIClient.legacy`	`@langfuse/core`	`Legacy`
`LangfuseAPIClient._legacy`	`@langfuse/core`	`Legacy \| undefined`
`LangfuseAPIClient.scoresV3`	`@langfuse/core`	`ScoresV3`
`LangfuseAPIClient.sessions`	`@langfuse/core`	`Sessions`
`LangfuseAPIClient._scoresV3`	`@langfuse/core`	`ScoresV3 \| undefined`
`LangfuseAPIClient._sessions`	`@langfuse/core`	`Sessions \| undefined`
`LangfuseAPIClient.ingestion`	`@langfuse/core`	`Ingestion`
`LangfuseAPIClient._ingestion`	`@langfuse/core`	`Ingestion \| undefined`
`LangfuseAPIClient.datasetRunItems`	`@langfuse/core`	`DatasetRunItems`
`LangfuseAPIClient._datasetRunItems`	`@langfuse/core`	`DatasetRunItems \| undefined`

변경된 클래스·인터페이스 멤버

member	이전	이후
`PropagateAttributesParams.metadata`	`Record<string, string> \| undefined`	`Record<string, unknown> \| undefined`

새로 지원 중단됨

export	@deprecated
`@langfuse/core · ApiKeySummary.note`	Use name instead.
`@langfuse/core · ApiKeyResponse.note`	Use name instead.
`@langfuse/core · OrganizationApiKey.note`	Use name instead.
`@langfuse/core · CreateApiKeyRequest.note`	Use name instead.

요구 사항 변경 (engines, peer 의존성)

	이전	이후
`engines.node`	`—`	`>=22`

새 export (8)

import	export	kind
`@langfuse/core`	`CreateScoresRequest`	type
`@langfuse/core`	`CreateScoresResponse`	type
`@langfuse/core`	`CreateScoreBatchError`	interface
`@langfuse/core`	`serializeMetadataValue`	function
`@langfuse/core`	`CreateScoreBatchResults`	interface
`@langfuse/core`	`CreateScoreBatchResponse`	interface
`@langfuse/core`	`createStableExperimentId`	function
`@langfuse/core`	`dropMetadataOverSpanAttributeLimit`	function

이 데이터를 AI 에이전트에 제공하세요

Vigia는 무료 MCP 서버입니다. 코딩 에이전트가 코드를 작성하기 전에 버전, 호환성을 깨는 변경, 취약점을 확인합니다. 가입도 API 키도 필요 없습니다.

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

Cursor에 추가 VS Code에 추가 ★ GitHub에서 스타 누르기

그 밖의 MCP 클라이언트

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

에이전트 스킬(SKILL.md): 에이전트에게 Vigia를 언제 쓸지 알려 줍니다 · 풀 리퀘스트용 GitHub Action

자주 묻는 질문

@langfuse/core을(를) 5에서 6(으)로 업그레이드할 때 호환성이 깨지는 변경은 무엇인가요?

@langfuse/core 5.14.0과 6.0.0 사이에서 Vigia는 삭제된 export 75개, 변경된 시그니처 1개, 삭제되거나 변경된 클래스·인터페이스 멤버 11개를 찾았습니다.

@langfuse/core 6에서 지원 중단된 것은 무엇인가요?

@langfuse/core 6.0.0에서 export 또는 멤버 4개가 새로 지원 중단으로 표시되었습니다.

에이전트용

GET https://vigia.coredls.cloud/v1/packages/npm/@langfuse/core/upgrade?from=5.14.0&to=6.0.0