TossClientOptions — @gj-kit/toss-payments

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

검증된 import 예제

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

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

interface TossClientOptions {
    /** 기본 globalThis.fetch (Node 20+ 내장). 테스트에서는 모킹 주입 지점. */
    readonly fetch?: typeof fetch;
    /** 기본 https://api.tosspayments.com */
    readonly baseUrl?: string;
    /**
     * live 키로 공식 API 호스트 외 주소를 사용하는 위험한 탈출구.
     * 일반 운영에서는 절대 켜지 말 것.
     */
    readonly dangerouslyAllowCustomLiveBaseUrl?: true;
    /** 기본 30_000ms — AbortSignal.timeout과 호출자 signal을 결합해 적용한다(재시도 시 시도별 독립 적용). */
    readonly timeoutMs?: number;
    /** §3.2 아웃바운드 req/res 증거 기록 — 기본 꺼짐. 시도 1건 = AuditEntry 1건. */
    readonly audit?: AuditOptions;
    /** §3.4 자동 재시도 — 기본 꺼짐(미설정 시 1회 시도, 현행 동작과 동일). */
    readonly retry?: RetryOptions;
    /** §3.3 이벤트 버스 — 'api.call' 전용(논리 요청당 최종 1회). createTossEvents 산출물만 발행이 흐른다. */
    readonly events?: TossEvents;
    /** 취소 transport 실패 티켓을 프로세스 재시작 후에도 재실행하기 위한 영속 저장소. */
    readonly cancelRetries?: CancelRetryStore;
}

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

Release context

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