TossPaymentsModuleAsyncOptions — @gj-kit/toss-payments-nestjs

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

검증된 import 예제

import { TossPaymentsModuleAsyncOptions } from '@gj-kit/toss-payments-nestjs';

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

/** forRootAsync 옵션 (설계 §4.2) — 스토어(PrismaService 등)를 DI 의존성으로 조립하는 경로. */
interface TossPaymentsModuleAsyncOptions<C extends AnyTossPaymentsConfig> {
    readonly imports?: DynamicModule['imports'];
    /** useFactory 파라미터로 주입할 프로바이더 토큰. 예: [PrismaService, ConfigService] */
    readonly inject?: readonly InjectionToken[];
    /**
     * config 팩토리. **반환값은 반드시 `defineTossPaymentsConfig(...)`로 감싸라**(설계 §4.3 강권) —
     * 팩토리 반환 경로에서는 const 추론이 풀려 조건부 프로퍼티(배선) 판정이 무너질 수 있다.
     */
    readonly useFactory: (...deps: readonly any[]) => C | Promise<C>;
    /** 기본 true — 결제 kit은 전역 싱글턴이 자연스러운 단위다(모듈마다 재조립 금지). */
    readonly global?: boolean;
}

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

Release context

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

구현 주석

forRootAsync 옵션 (설계 §4.2) — 스토어(PrismaService 등)를 DI 의존성으로 조립하는 경로.