/** Shared Browser/Host diagnostics. Never log raw refs, URLs, error messages or credentials. */
export interface ArkmeAvatarDiagnosticContext {
    environment?: 'prod' | 'test';
    viewerUserId?: number;
    targetUserId?: number;
    targetUserIds?: readonly number[];
    referenceKind?: 'profile' | 'media' | 'other';
    referenceViewerUserId?: number;
    referenceTargetUserId?: number;
    trigger?: 'load' | 'revalidate';
    hasCachedImage?: boolean;
    durationMillis?: number;
}
type AvatarDiagnosticEvent = 'image_load_failed' | 'image_read_failed' | 'profile_fetch_failed' | 'profile_avatar_rejected' | 'profile_missing' | 'private_avatar_seal_failed';
/** Decoded IDs are diagnostic hints only, never authentication or authorization inputs. */
export declare function avatarReferenceDiagnostic(imageRef: string): ArkmeAvatarDiagnosticContext;
export declare function avatarScopeDiagnostic(scopeKey: string | undefined): ArkmeAvatarDiagnosticContext;
export declare function logArkmeAvatarDiagnostic(event: AvatarDiagnosticEvent, context: ArkmeAvatarDiagnosticContext, error?: unknown): void;
export {};
//# sourceMappingURL=avatar-diagnostics.d.ts.map