// Copyright Epic Games, Inc. All Rights Reserved.

#pragma once

#include "Containers/StringFwd.h"
#include "Containers/UnrealString.h"

class FPackagePath;

struct FIoHash;

namespace UE::Virtualization::Utils
{

/** 
 * Converts a FIoHash into a file path.
 *
 * This utility will take an FIoHash and return a file path that is
 * 3 directories deep. The first six characters of the id will be used to
 * create the directory names, with each directory using two characters.
 * The remaining thirty four characters will be used as the file name.
 * Lastly the extension '.payload' will be applied to complete the path/
 * Example: FIoHash 0139d6d5d477e32dfd2abd3c5bc8ea8507e8eef8 becomes
 *			01/39/d6/d5d477e32dfd2abd3c5bc8ea8507e8eef8.payload'
 * 
 * @param	Id The payload identifier used to create the file path.
 * @param	OutPath Will be reset and then assigned the resulting file path.
 *			The string builder must have a capacity of at least 52 characters 
			to avoid reallocation.
 */
void PayloadIdToPath(const FIoHash& Id, FStringBuilderBase& OutPath);

/** 
 * Converts a FIoHash into a file path.
 * 
 * See above for further details
 * 
 * @param	Id The payload identifier used to create the file path.
 * @return	The resulting file path.
 */
FString PayloadIdToPath(const FIoHash& Id);

/**
 * Fill in the given string builder with the human readable message of the current system
 * code, followed by the code value itself.
 * In the system value is currently 0, then we assume that it was cleared before this was
 * able to be called and write that the error is unknown instead of assuming that the
 * operation was a success.
 */
void GetFormattedSystemError(FStringBuilderBase& SystemErrorMessage);


enum class ETrailerFailedReason : uint8
{
	/** Could not open the package for reading */
	NotFound,
	/** The header of the package (summary) could not be read or was otherwise corrupted */
	InvalidSummary,
	/** The package predates package version 1002 in which the package trailer was introduced */
	OutOfDate,
	/** The reason for the missing package trailer could not be determined */
	Unknown
};

/** 
 * Utility that returns the reason why a given package does not have a package trailer.
 * Note that it does not actually try to load the trailer or validate that the trailer
 * is in fact missing and assumes that the caller previously attempted to a call to
 * load a trailer from the package but it failed.
 */
ETrailerFailedReason FindTrailerFailedReason(const FPackagePath& PackagePath);

/** 
 * Parse the given path and expand any environment variables found with the format
 * $(EnvVarName). If the variable cannot be found the function will return false 
 * and OutExpandedPath will be reset.
 */
bool ExpandEnvironmentVariables(FStringView InputPath, FStringBuilderBase& OutExpandedPath);

/** 
 * Returns true if the process is interactive and we should display error dialogs to
 * the user.
 * */
bool IsProcessInteractive();

bool TryFindProject(const FString& PackagePath, const FString& Extension, FString& ProjectFilePath, FString& PluginFilePath);

} // namespace UE::Virtualization::Utils