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

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

검증된 import 예제

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

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

/**
 * FNV-1a 64bit — advisory lock 키 파생 (문서화된 고정 알고리즘, 설계 §4).
 *
 * `pg_advisory_xact_lock(bigint)`은 **signed** int8을 받으므로 unsigned 64bit 해시를
 * `BigInt.asIntN(64, ...)`으로 2의 보수 재해석해 int8 범위에 맞춘다 — 값의 비트는
 * 동일하고 표기만 음수가 될 수 있다. 파라미터는 문자열로 보낸다(드라이버들의 BigInt
 * 직렬화 지원이 제각각이고, PostgreSQL이 함수 시그니처로 타입을 추론한다).
 */
declare function advisoryLockKey(schema: string): bigint;

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

Release context

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

구현 주석

FNV-1a 64bit — advisory lock 키 파생 (문서화된 고정 알고리즘, 설계 §4).

pg_advisory_xact_lock(bigint)은 signed int8을 받으므로 unsigned 64bit 해시를 BigInt.asIntN(64, ...)으로 2의 보수 재해석해 int8 범위에 맞춘다 — 값의 비트는 동일하고 표기만 음수가 될 수 있다. 파라미터는 문자열로 보낸다(드라이버들의 BigInt 직렬화 지원이 제각각이고, PostgreSQL이 함수 시그니처로 타입을 추론한다).