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

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

Verified import example

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

Signature, parameters, and return type

/**
 * 앱이 소유하는 비동기 민감값 보호기.
 *
 * AES-GCM, envelope encryption, KMS 등을 선택할 수 있도록 crypto 의존성을 이 패키지에
 * 들이지 않는다. `encrypt`는 평문과 다른, DB에 안전하게 저장 가능한 문자열을 반환해야
 * 하고 `decrypt`는 같은 context에서만 원문을 복원해야 한다. 구현은 암호화 실패 메시지에
 * 평문을 포함하지 않아야 한다.
 *
 * 이 패키지의 스토어가 넘기는 평문은 항상 well-formed UTF-16이다(JSON.stringify 출력 또는
 * ASCII secret). 구현은 비페어 서로게이트를 조용히 바꿔 봉하지 말고 거부해야 한다 — 레퍼런스
 * AES-256-GCM 보호기는 `TypeError`로 거부한다.
 */
interface SensitiveValueProtector {
    encrypt(plaintext: string, context: SensitiveValueContext): Promise<string>;
    decrypt(ciphertext: string, context: SensitiveValueContext): Promise<string>;
}

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: ./nestjs
• Source: GitHub