feat: Studio 응답 봉투를 전송 경계에서 언랩한다
studio-v1.yaml v3.0.0(ADR-006)에 맞춰 계약을 재생성하고, 성공은
{success,data,meta}, 실패는 {success,error,meta} 봉투를 전송 경계에서
언랩하는 envelopeData/envelopeError validator를 도입한다. 앱·도메인
계층은 기존과 같은 payload/ProblemDetails 모양을 계속 받고,
StudioGateway 포트 시그니처는 무변경이다.
- tech-log-studio-contract-contribution.ts: envelopeData/envelopeError
도입, 18개 operation의 outputValidator를 passthrough에서 envelopeData로
교체
- studio-error-mapping.ts: 봉투 오류의 status(항상 0)를
outcome.metadata.status로 덮는다. SafeResponseMetadata.status가
실제 필드명이며(httpStatus 아님) PROBLEM outcome에서 필수 필드다
- contract.ts: 삭제된 ProblemDetails 생성 스키마를 손으로 유지 — 앱
계층·mock 게이트웨이가 그 모양을 계속 소비한다
- asset-upload-transport.ts: multipart 업로드는 일반 계약 런타임을
거치지 않는 별도 seam이지만 같은 wire 봉투를 쓴다 — envelopeData/
envelopeError를 재사용해 이 경로도 언랩한다 (브리프 파일 목록 밖의
발견, report에 기록)
- 테스트: 신규 studio-envelope-unwrap.test.ts(TDD) + 봉투 뼈대를 직접
만드는 기존 테스트(asset-upload-transport, studio-csrf-composition,
contract-generation)를 봉투 형태로 갱신
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5
parent
d84b57bb3f
commit
25a6b63d27
@@ -57,13 +57,20 @@ export function toStudioGatewayError(
|
||||
): StudioGatewayError {
|
||||
switch (outcome.kind) {
|
||||
case "PROBLEM": {
|
||||
const problem = outcome.problem as ProblemDetails;
|
||||
// 봉투 오류는 wire에 HTTP status를 싣지 않는다 (`envelopeError`가 `status`를
|
||||
// 0으로 둔다) — 실제 status는 전송 계층이 `outcome.metadata.status`로
|
||||
// 이미 들고 있으므로 여기서 덮는다. `SafeResponseMetadata.status`는
|
||||
// `PROBLEM` outcome에서 필수 필드다 (`http-execution-v3.ts`).
|
||||
// `problem`이 falsy이거나 status가 0(봉투의 sentinel)이면 metadata로
|
||||
// 덮는다 — 원래 코드처럼 `problem`을 안전하지 않게 역참조하지 않는다.
|
||||
const problem = outcome.problem as ProblemDetails | undefined;
|
||||
const status = problem?.status || outcome.metadata.status;
|
||||
if (problem && typeof problem.code === "string" && CODES.has(problem.code)) {
|
||||
return new StudioGatewayError(problem);
|
||||
return new StudioGatewayError({ ...problem, status });
|
||||
}
|
||||
return synthetic(
|
||||
"STUDIO_UNAVAILABLE",
|
||||
outcome.metadata.status,
|
||||
status,
|
||||
`${operationId} returned an uncontracted problem code.`,
|
||||
false,
|
||||
);
|
||||
|
||||
Reference in New Issue
Block a user