createTossPayments — @gj-kit/toss-payments

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

검증된 import 예제

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

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

/**
 * 파사드 팩토리 — 오버로드 2종(API 키 / 위젯 키). 위젯 키 + `billingKeys`는 어느
 * 오버로드도 충족하지 못해 컴파일 에러다(키 쌍 규칙 선차단).
 *
 * ⚠ config를 스프레드로 동적 구성하면 `const` 추론이 풀려 조건부 프로퍼티 판정이
 * 무너질 수 있다 — 동적 구성이 필요하면 기존 개별 팩토리 4종을 직접 사용하라.
 * forRootAsync 등 간접 전달에는 {@link defineTossPaymentsConfig}로 추론을 고정하라.
 */
declare function createTossPayments<E extends Env, const C extends TossPaymentsApiConfig<E>>(config: C & {
    readonly secretKey: ApiSecretKey<E>;
}): TossPaymentsKit<E, 'api', C>;

declare function createTossPayments<E extends Env, const C extends TossPaymentsWidgetConfig<E>>(config: C & {
    readonly secretKey: WidgetSecretKey<E>;
}): TossPaymentsKit<E, 'widget', C>;

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

Release context

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

구현 주석

파사드 팩토리 — 오버로드 2종(API 키 / 위젯 키). 위젯 키 + billingKeys는 어느 오버로드도 충족하지 못해 컴파일 에러다(키 쌍 규칙 선차단).

⚠ config를 스프레드로 동적 구성하면 const 추론이 풀려 조건부 프로퍼티 판정이 무너질 수 있다 — 동적 구성이 필요하면 기존 개별 팩토리 4종을 직접 사용하라. forRootAsync 등 간접 전달에는 {@link defineTossPaymentsConfig}로 추론을 고정하라.