export declare function extractHttpStatus(e: unknown): number | undefined;
export declare function rawMessage(e: unknown): string;
/**
 * Google API 에러에서 구조화된 실제 사유를 추출한다. GaxiosError는
 * `response.data.error.{message,errors[].reason}` 에 진짜 원인을 담는데,
 * 친절화 레이어가 이를 버리고 일반 메시지("권한 없음")로 덮으면, 권한이 멀쩡한데도
 * 권한 문제로 오진하게 된다 (예: 같은 SA로 이미지 업로드는 되는데 listings.update만 403).
 * 추출 실패 시 undefined.
 */
export declare function googleErrorDetail(e: unknown): string | undefined;
/** invalid_grant / 만료 refresh_token / 부족 scope → 재로그인 안내 메시지. 아니면 null. */
export declare function authReauthMessage(text: string): string | null;
export declare function withCause(err: Error, cause: unknown): Error;
/**
 * Firebase / GCP 에러를 친절 메시지로 변환. 신규 사용자가 가장 자주 만나는
 * 'API 미활성화 / 프로젝트 없음 / billing / 권한' 케이스에 다음 행동을 붙인다.
 */
export declare function friendlyGoogleError(e: unknown): Error;