NodeHandlerOptions — @gj-kit/toss-payments

A public interface from @gj-kit/toss-payments/webhook. The signature below is taken directly from the 0.6.1 release declaration.

Verified import example

import { NodeHandlerOptions } from '@gj-kit/toss-payments/webhook';

Signature, parameters, and return type

interface NodeHandlerOptions {
    /**
     * 수신 raw body의 최대 바이트 수. 기본 256 KiB.
     *
     * Content-Length 초과는 body를 읽기 전에 413으로 거부한다. 스트림 경로도 누적 상한을
     * 적용한다. `express.raw()`가 이미 Buffer를 만들었다면 그 할당을 되돌릴 수 없으므로
     * `express.raw({ limit: maxBodyBytes })`를 함께 설정해야 한다.
     */
    readonly maxBodyBytes?: number;
    /** 프록시 트러스트 설정을 반영한 원본 IP 추출기. 생략 시 socket.remoteAddress. */
    readonly sourceIp?: (request: NodeIncomingMessageLike) => string | null | undefined;
}

This declaration is the source of truth for parameters, optionality, generics, return values, and public union/type contracts. Check the package golden path and this subpath’s import conditions for required environment, permission, and error boundaries before calling it.

Release context

• Package: @gj-kit/toss-payments
• Version: 0.6.1
• Public entry: ./webhook
• Source: GitHub