JobTriggerTokenVerifier — @gj-kit/nest-operations-jobs

@gj-kit/nest-operations-jobs/core에서 공개하는 interface입니다. package version 0.1.1의 release declaration을 그대로 표시합니다.

검증된 import 예제

import { JobTriggerTokenVerifier } from '@gj-kit/nest-operations-jobs/core';

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

/**
 * Host-provided token verification. The library ships no cloud SDK: an adapter
 * over `google-auth-library`'s `verifyIdToken`, a JWKS client or an internal
 * mTLS-derived identity all satisfy this port.
 *
 * Return `null` for "not authenticated". Throwing is reserved for verifier
 * outages, which the guard reports as 503 rather than 401.
 */
interface JobTriggerTokenVerifier {
    verify(token: string): Promise<JobTriggerIdentity | null>;
}

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

Release context

• 패키지: @gj-kit/nest-operations-jobs
• 버전: 0.1.1
• 공개 entry: ./core
• 소스: GitHub

구현 주석

Host-provided token verification. The library ships no cloud SDK: an adapter over google-auth-library’s verifyIdToken, a JWKS client or an internal mTLS-derived identity all satisfy this port.

Return null for “not authenticated”. Throwing is reserved for verifier outages, which the guard reports as 503 rather than 401.