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

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

검증된 import 예제

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

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

/**
 * Authenticates every job trigger. Applied by the controller factory, so a
 * handler cannot forget it — the structural fix for per-handler assert calls.
 *
 * A rejected credential is a 401 with one fixed body, mapped by
 * {@link toHttpException} like every other library outcome — this class decides
 * no status codes of its own. A verifier that throws is an outage, not a
 * rejection: it becomes a 503 so the scheduler retries, and its body carries
 * `reason: 'verifier_unavailable'` so an alert rule can tell "the caller's token
 * was refused" from "our verifier is down".
 */
declare class OperationsJobsGuard implements CanActivate {
    private readonly authenticate;
    constructor(authenticate: JobTriggerAuthenticator);
    canActivate(context: ExecutionContext): Promise<boolean>;
}

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

Release context

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

구현 주석

Authenticates every job trigger. Applied by the controller factory, so a handler cannot forget it — the structural fix for per-handler assert calls.

A rejected credential is a 401 with one fixed body, mapped by {@link toHttpException} like every other library outcome — this class decides no status codes of its own. A verifier that throws is an outage, not a rejection: it becomes a 503 so the scheduler retries, and its body carries reason: 'verifier_unavailable' so an alert rule can tell “the caller’s token was refused” from “our verifier is down”.