orThrow — @gj-kit/toss-payments

@gj-kit/toss-payments/server에서 공개하는 function입니다. package version 0.6.1의 release declaration을 그대로 표시합니다.

검증된 import 예제

import { orThrow } from '@gj-kit/toss-payments/server';

시그니처, 매개변수, 반환 타입

/**
 * 유일한 throw 탈출구 — **부팅 시 설정 파싱(키 로드) 전용**.
 *
 * 요청 처리 경로에서는 사용하지 말 것: 이 라이브러리의 모든 공개 작업은 Result를
 * 반환하며, 요청 경로의 실패는 판별자 내로잉(`if (!r.ok)`)으로 다뤄야 한다.
 * 메서드가 아닌 자유 함수인 이유: Result 값은 어디서든 plain 객체로 직렬화 안전해야 한다.
 *
 * @param context - 던지는 Error 메시지 앞에 붙는 식별 문맥 (예: 'TOSS_SECRET_KEY')
 * @throws Error - 실패 변형일 때. `cause`에 원본 에러 값을 보존한다.
 */
declare function orThrow<T, E>(r: Result<T, E>, context?: string): T;

이 선언은 매개변수, optionality, 제네릭, 반환값, 공개 union/type 계약의 정본입니다. 호출 전 필요한 환경·권한·오류 경계는 패키지 Golden path와 이 subpath의 import 조건을 함께 확인하세요.

Release context

• 패키지: @gj-kit/toss-payments
• 버전: 0.6.1
• 공개 entry: ./server
• 소스: GitHub

구현 주석

유일한 throw 탈출구 — 부팅 시 설정 파싱(키 로드) 전용.

요청 처리 경로에서는 사용하지 말 것: 이 라이브러리의 모든 공개 작업은 Result를 반환하며, 요청 경로의 실패는 판별자 내로잉(if (!r.ok))으로 다뤄야 한다. 메서드가 아닌 자유 함수인 이유: Result 값은 어디서든 plain 객체로 직렬화 안전해야 한다.