idempotencyKey — @gj-kit/toss-payments

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

검증된 import 예제

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

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

/**
 * 멱등키 스마트 생성자 — 1–300자 + 헤더 안전 문자셋(`^[\x21-\x7E]+$`).
 * 한글·공백·CR/LF 등은 `reason: 'bad-charset'`. Ok이면 그 값은 어떤 fetch 구현에서도
 * `Idempotency-Key` 헤더로 바이트 동일하게 전송된다.
 */
declare function idempotencyKey(raw: string): Result<IdempotencyKey, InvalidInput<'idempotencyKey'>>;

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

Release context

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

구현 주석

멱등키 스마트 생성자 — 1–300자 + 헤더 안전 문자셋(^[\x21-\x7E]+$). 한글·공백·CR/LF 등은 reason: 'bad-charset'. Ok이면 그 값은 어떤 fetch 구현에서도 Idempotency-Key 헤더로 바이트 동일하게 전송된다.