/** 
 * @file llavatarname.cpp
 * @brief Represents name-related data for an avatar, such as the
 * username/SLID ("bobsmith123" or "james.linden") and the display
 * name ("James Cook")
 *
 * $LicenseInfo:firstyear=2010&license=viewerlgpl$
 * Second Life Viewer Source Code
 * Copyright (C) 2010, Linden Research, Inc.
 * 
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation;
 * version 2.1 of the License only.
 * 
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 * 
 * Linden Research, Inc., 945 Battery Street, San Francisco, CA  94111  USA
 * $/LicenseInfo$
 */
#include "linden_common.h"

#include "llavatarname.h"

#include "lldate.h"
#include "llframetimer.h"
#include "llsd.h"

// Store these in pre-built std::strings to avoid memory allocations in
// LLSD map lookups
static const std::string USERNAME("username");
static const std::string DISPLAY_NAME("display_name");
static const std::string LEGACY_FIRST_NAME("legacy_first_name");
static const std::string LEGACY_LAST_NAME("legacy_last_name");
static const std::string IS_DISPLAY_NAME_DEFAULT("is_display_name_default");
static const std::string DISPLAY_NAME_EXPIRES("display_name_expires");
static const std::string DISPLAY_NAME_NEXT_UPDATE("display_name_next_update");

bool LLAvatarName::sUseDisplayNames = true;
bool LLAvatarName::sUseUsernames = true;
bool LLAvatarName::sUseLegacyNameFormat = false;	// <FS:CR> Legacy name option
bool LLAvatarName::sTrimResidentSurname = true;		// FIRE-6659 - Trim "Resident" from legacy name

// Minimum time-to-live (in seconds) for a name entry.
// Avatar name should always guarantee to expire reasonably soon by default
// so if the failure to get a valid expiration time was due to something temporary 
// we will eventually request and get the right data.
const F64 MIN_ENTRY_LIFETIME = 60.0;

LLAvatarName::LLAvatarName()
:	mUsername(),
	mDisplayName(),
	mLegacyFirstName(),
	mLegacyLastName(),
	mIsDisplayNameDefault(false),
	mIsTemporaryName(false),
	mExpires(F64_MAX),
	mNextUpdate(0.0)
{ }

bool LLAvatarName::operator<(const LLAvatarName& rhs) const
{
	if (mUsername == rhs.mUsername)
		return mDisplayName < rhs.mDisplayName;
	else
		return mUsername < rhs.mUsername;
}

//static 
void LLAvatarName::setUseDisplayNames(bool use)
{
	sUseDisplayNames = use;
}
//static 
bool LLAvatarName::useDisplayNames() 
{ 
	return sUseDisplayNames; 
}

void LLAvatarName::setUseUsernames(bool use)
{
	sUseUsernames = use;
}

bool LLAvatarName::useUsernames()
{
	return sUseUsernames;
}

LLSD LLAvatarName::asLLSD() const
{
	LLSD sd;
	sd[USERNAME] = mUsername;
	sd[DISPLAY_NAME] = mDisplayName;
	sd[LEGACY_FIRST_NAME] = mLegacyFirstName;
	sd[LEGACY_LAST_NAME] = mLegacyLastName;
	sd[IS_DISPLAY_NAME_DEFAULT] = mIsDisplayNameDefault;
	sd[DISPLAY_NAME_EXPIRES] = LLDate(mExpires);
	sd[DISPLAY_NAME_NEXT_UPDATE] = LLDate(mNextUpdate);
	return sd;
}

void LLAvatarName::fromLLSD(const LLSD& sd)
{
	mUsername = sd[USERNAME].asString();
	mDisplayName = sd[DISPLAY_NAME].asString();
	mLegacyFirstName = sd[LEGACY_FIRST_NAME].asString();
	mLegacyLastName = sd[LEGACY_LAST_NAME].asString();
	mIsDisplayNameDefault = sd[IS_DISPLAY_NAME_DEFAULT].asBoolean();
	LLDate expires = sd[DISPLAY_NAME_EXPIRES];
	mExpires = expires.secondsSinceEpoch();
	LLDate next_update = sd[DISPLAY_NAME_NEXT_UPDATE];
	mNextUpdate = next_update.secondsSinceEpoch();
	
	// Some avatars don't have explicit display names set. Force a legible display name here.
	if (mDisplayName.empty())
	{
		mDisplayName = mUsername;
		// <FS:Ansariel> OpenSim GetDisplayNames cap support
		mIsDisplayNameDefault = true;
	}
}

// Transform a string (typically provided by the legacy service) into a decent
// avatar name instance.
void LLAvatarName::fromString(const std::string& full_name)
{
	mDisplayName = full_name;
	std::string::size_type index = full_name.find(' ');
	if (index != std::string::npos)
	{
		// The name is in 2 parts (first last)
		mLegacyFirstName = full_name.substr(0, index);
		mLegacyLastName = full_name.substr(index+1);
		// <FS:CR> FIRE-6659 - Trim "Resident" from legacy name
		//if (mLegacyLastName != "Resident")
		if ((mLegacyLastName != "Resident") || !sTrimResidentSurname)
		// </FS:CR>
		{
			mUsername = mLegacyFirstName + "." + mLegacyLastName;
			mDisplayName = full_name;
			LLStringUtil::toLower(mUsername);
		}
		else
		{
			// Very old names do have a dummy "Resident" last name 
			// that we choose to hide from users.
			mUsername = mLegacyFirstName;
			mDisplayName = mLegacyFirstName;
		}
	}
	else
	{
		mLegacyFirstName = full_name;
		mLegacyLastName = "";
		mUsername = full_name;
		mDisplayName = full_name;
	}
	mIsDisplayNameDefault = true;
	mIsTemporaryName = true;
	setExpires(MIN_ENTRY_LIFETIME);
}

void LLAvatarName::setExpires(F64 expires)
{
	mExpires = LLFrameTimer::getTotalSeconds() + expires;
}

std::string LLAvatarName::getCompleteName(bool use_parentheses, bool force_use_complete_name) const
{
	std::string name;
	if (sUseDisplayNames || force_use_complete_name)
	{
		if (mUsername.empty() || mIsDisplayNameDefault)
		{
			// If this particular display name is defaulted (i.e. based on user name),
			// then display only the easier to read instance of the person's name.
			// <FS:CR> FIRE-6659 - Trim "Resident" from legacy name
			//name = mDisplayName;
			if (sTrimResidentSurname || mLegacyFirstName.empty())
			{
				name = mDisplayName;
			}
			else if (mLegacyLastName.empty())
			{
				name = mLegacyFirstName + " Resident";
			}
			else
			{
				name = mLegacyFirstName + " " + mLegacyLastName;
			}
			// </FS:CR>
		}
		// <FS:CR> Option to show legacy name format instead of username
		else if (sUseLegacyNameFormat)
		{
			// FIRE-6659
			if (sTrimResidentSurname && (mLegacyLastName == "Resident" || mLegacyLastName.empty()))
			{
				name = mDisplayName + " (" + mLegacyFirstName + ")";
			}
			else if (mLegacyLastName.empty() && !sTrimResidentSurname)
			{
				name = mDisplayName + " (" + mLegacyLastName + " Resident)";
			}
			else
			{
				name = mDisplayName + " (" + mLegacyFirstName + " " + mLegacyLastName + ")";
			}
		}
		// </FS:CR>
		else
		{
			name = mDisplayName;
			if(sUseUsernames || force_use_complete_name)
			{
				if(use_parentheses)
				{
				    name += " (" + mUsername + ")";
				}
				else
				{
				    name += "  [ " + mUsername + " ]";
				}
			}
		}
	}
	else
	{
		// <FS:CR> FIRE-6659 - Trim "Resident" from legacy name
		//return getUserName();
		return  getUserNameForDisplay();
		// </FS:CR>
	}
	return name;
}

std::string LLAvatarName::getLegacyName() const
{
	if (mLegacyFirstName.empty() && mLegacyLastName.empty()) // display names disabled?
	{
		return mDisplayName;
	}

	std::string name;
	name.reserve( mLegacyFirstName.size() + 1 + mLegacyLastName.size() );
	name = mLegacyFirstName;
	name += " ";
	name += mLegacyLastName;
	return name;
}

std::string LLAvatarName::getDisplayName(bool force_use_display_name) const
{
	if (sUseDisplayNames || force_use_display_name)
	{
		return mDisplayName;
	}
	else
	{
		// <FS:CR> FIRE-6659 - Trim "Resident" from legacy name
		//return getUserName();
		return  getUserNameForDisplay();
		// </FS:CR>
	}
}

std::string LLAvatarName::getUserName(bool lowercase) const
{
	std::string name;
	if (mLegacyLastName.empty() || (mLegacyLastName == "Resident"))
	{
		if (mLegacyFirstName.empty())
		{
			// If we cannot create a user name from the legacy strings, use the display name
			name = mDisplayName;
		}
		else
		{
			// The last name might be empty if it defaulted to "Resident"
			name = mLegacyFirstName;
		}
	}
	else
	{
		if(lowercase)
		{
		    name = mLegacyFirstName + "." + mLegacyLastName;
		    LLStringUtil::toLower(name);
		}
		else
		{
		    name = mLegacyFirstName + " " + mLegacyLastName;
	    }
	}
	return name;
}

// <FS:CR> Returns the same as getUserName() but honors sTrimResidentSurname
std::string LLAvatarName::getUserNameForDisplay() const
{
	std::string name;
	if (mLegacyFirstName.empty() && mLegacyLastName.empty())
	{
		// If we cannot create a user name from the legacy strings, use the display name
		name = mDisplayName;
	}
	else if ((mLegacyLastName.empty() || (mLegacyLastName == "Resident")) && sTrimResidentSurname)
	{
		// The last name might be empty if it defaulted to "Resident"
		name = mLegacyFirstName;
	}
	else if (mLegacyLastName.empty() && !sTrimResidentSurname)
	{
		name = mLegacyFirstName + " Resident";
	}
	else
	{
		name = mLegacyFirstName + " " + mLegacyLastName;
	}
	return name;
}
// </FS:CR>

void LLAvatarName::dump() const
{
	LL_DEBUGS("AvNameCache") << "LLAvatarName: "
	                         << "user '" << mUsername << "' "
							 << "display '" << mDisplayName << "' "
	                         << "expires in " << mExpires - LLFrameTimer::getTotalSeconds() << " seconds"
							 << LL_ENDL;
}

