createPgCancelRetryStore — @gj-kit/toss-payments-postgresql

A public function from @gj-kit/toss-payments-postgresql. The signature below is taken directly from the 0.5.1 release declaration.

Verified import example

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

Signature, parameters, and return type

/**
 * CancelRetryStore PostgreSQL 구현 (설계 §3.4).
 *
 * 코어 계약의 핵심 불변식:
 * - `CancelRetryRecord.bodyJson`은 **멱등 재생의 바이트 계약**이다 — 재시도 시 동일
 *   멱등키 + 동일 바이트를 다시 보내야 한다. 그래서 record_json 컬럼은 jsonb가 아니라
 *   **text**다: JSON.stringify한 record 전체를 보호한 뒤 text로 저장하고 JSON.parse
 *   왕복해 문자열 필드를 무손실 복원한다. jsonb 정규화(NUL 거부, 이스케이프/키 정렬
 *   변형)는 원문을 바꿀 위험이 있어 사용하지 않는다.
 * - 멱등키 15일 TTL — 삭제는 cleanup()(팩토리) 소관이며 이 스토어는 지우지 않는다.
 * - ⚠ record에는 환불 계좌 정보가 평문으로 들어올 수 있다. 레코드 전체를 보호기에
 *   넘긴 뒤 저장하며, 어떤 에러 메시지에도 record 내용을 싣지 않는다.
 */
declare function createPgCancelRetryStore(sql: SqlExecutor, options: PgSensitiveStoreOptions): CancelRetryStore;

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-postgresql
• Version: 0.5.1
• Public entry: .
• Source: GitHub