--!strict
--[=[
	Wraps the rbxthumb URL api surface to generate a URL for a thumbnail on the cloud.

	These thumbnails are automatically batched for performance.

	@class RbxThumbUtils
]=]

local require = require(script.Parent.loader).load(script)

local RbxThumbnailTypes = require("RbxThumbnailTypes")

export type RbxThumbnailTypes =
	"Asset"
	| "Avatar"
	| "AvatarHeadShot"
	| "BadgeIcon"
	| "BundleThumbnail"
	| "GameIcon"
	| "GamePass"
	| "GroupIcon"
	| "Outfit"

local RbxThumbUtils = {}

--[=[
	Gets a thumbnail URL for a given content type and id

	https://devforum.roblox.com/t/new-contentid-format-for-easy-thumbnail-loading/357335
	https://create.roblox.com/docs/studio/asset-types#rbxthumb

	Type:               Supported Sizes:
	"Asset"             150x150, 420x420
	"Avatar"            100x100, 352x352, 720x720
	"AvatarHeadShot"    48x48,   60x60,   150x150
	"BadgeIcon"         150x150
	"BundleThumbnail"   150x150, 420x420
	"GameIcon"          50x50,   150x150
	"GamePass"          150x150
	"GroupIcon"         150x150, 420x420
	"Outfit"            150x150, 420x420

	@param thumbnailType RbxThumbnailTypes
	@param targetId number
	@param width number
	@param height number
	@return string
]=]
function RbxThumbUtils.getThumbnailUrl(
	thumbnailType: RbxThumbnailTypes,
	targetId: number,
	width: number,
	height: number
): string
	assert(type(thumbnailType) == "string", "Bad thumbnailType")
	assert(type(targetId) == "number", "Bad targetId")
	assert(type(width) == "number", "Bad width")
	assert(type(height) == "number", "Bad height")

	return string.format("rbxthumb://type=%s&id=%d&w=%d&h=%d", thumbnailType, targetId, width, height)
end

--[=[
	Converts an AvatarItemType to a string thumbnailType for thumbnail generation
	@param avatarItemType AvatarItemType
	@return string
]=]
function RbxThumbUtils.avatarItemTypeToThumbnailType(avatarItemType: Enum.AvatarItemType): RbxThumbnailTypes
	if avatarItemType == Enum.AvatarItemType.Asset then
		return RbxThumbnailTypes.ASSET
	elseif avatarItemType == Enum.AvatarItemType.Bundle then
		return RbxThumbnailTypes.BUNDLE
	else
		error("Unknown avatarItemType")
	end
end

--[=[
	Gets a Asset URL for use in an image label or other rendering application.

	Supported sizes: 150x150, 420x420

	@param targetId number
	@param width number?
	@param height number?
	@return string
]=]
function RbxThumbUtils.getAssetThumbnailUrl(targetId: number, width: number, height: number): string
	assert(type(targetId) == "number", "Bad targetId")

	width = width or 150
	height = height or 150

	return RbxThumbUtils.getThumbnailUrl(RbxThumbnailTypes.ASSET, targetId, width, height)
end

--[=[
	Gets a Avatar URL for use in an image label or other rendering application.

	Supported sizes: 100x100, 352x352, 720x720

	@param targetId number
	@param width number?
	@param height number?
	@return string
]=]
function RbxThumbUtils.getAvatarThumbnailUrl(targetId: number, width: number?, height: number?): string
	assert(type(targetId) == "number", "Bad targetId")

	local thumbnailWidth = width or 150
	local thumbnailHeight = height or 150

	return RbxThumbUtils.getThumbnailUrl(RbxThumbnailTypes.AVATAR, targetId, thumbnailWidth, thumbnailHeight)
end

--[=[
	Gets a AvatarHeadShot URL for use in an image label or other rendering application.

	Supported sizes: 48x48, 60x60, 150x150

	@param targetId number
	@param width number?
	@param height number?
	@return string
]=]
function RbxThumbUtils.getAvatarHeadShotThumbnailUrl(targetId: number, width: number?, height: number?): string
	assert(type(targetId) == "number", "Bad targetId")

	local thumbnailWidth = width or 150
	local thumbnailHeight = height or 150

	return RbxThumbUtils.getThumbnailUrl(RbxThumbnailTypes.AVATAR_HEAD_SHOT, targetId, thumbnailWidth, thumbnailHeight)
end

--[=[
	Gets a BadgeIcon URL for use in an image label or other rendering application.

	Supported sizes: 150x150

	@param targetId number
	@param width number?
	@param height number?
	@return string
]=]
function RbxThumbUtils.getBadgeIconThumbnailUrl(targetId: number, width: number?, height: number?): string
	assert(type(targetId) == "number", "Bad targetId")

	local thumbnailWidth = width or 150
	local thumbnailHeight = height or 150

	return RbxThumbUtils.getThumbnailUrl(RbxThumbnailTypes.BADGE, targetId, thumbnailWidth, thumbnailHeight)
end

--[=[
	Gets a BundleThumbnail URL for use in an image label or other rendering application.

	Supported sizes: 150x150, 420x420

	@param targetId number
	@param width number?
	@param height number?
	@return string
]=]
function RbxThumbUtils.getBundleThumbnailThumbnailUrl(targetId: number, width: number?, height: number?): string
	assert(type(targetId) == "number", "Bad targetId")

	local thumbnailWidth = width or 150
	local thumbnailHeight = height or 150

	return RbxThumbUtils.getThumbnailUrl(RbxThumbnailTypes.BUNDLE, targetId, thumbnailWidth, thumbnailHeight)
end

--[=[
	Gets a GameIcon URL for use in an image label or other rendering application.

	Supported sizes: 50x50, 150x150

	@param targetId number
	@param width number?
	@param height number?
	@return string
]=]
function RbxThumbUtils.getGameIconThumbnailUrl(targetId: number, width: number?, height: number?): string
	assert(type(targetId) == "number", "Bad targetId")

	local thumbnailWidth = width or 150
	local thumbnailHeight = height or 150

	return RbxThumbUtils.getThumbnailUrl(RbxThumbnailTypes.GAME_ICON, targetId, thumbnailWidth, thumbnailHeight)
end

--[=[
	Gets a GamePass URL for use in an image label or other rendering application.

	Supported sizes: 150x150

	@param targetId number
	@param width number?
	@param height number?
	@return string
]=]
function RbxThumbUtils.getGamePassThumbnailUrl(targetId: number, width: number?, height: number?): string
	assert(type(targetId) == "number", "Bad targetId")

	local thumbnailWidth = width or 150
	local thumbnailHeight = height or 150

	return RbxThumbUtils.getThumbnailUrl(RbxThumbnailTypes.GAME_PASS, targetId, thumbnailWidth, thumbnailHeight)
end

--[=[
	Gets a GroupIcon URL for use in an image label or other rendering application.

	Supported sizes: 150x150, 420x420

	@param targetId number
	@param width number?
	@param height number?
	@return string
]=]
function RbxThumbUtils.getGroupIconThumbnailUrl(targetId: number, width: number?, height: number?): string
	assert(type(targetId) == "number", "Bad targetId")

	local thumbnailWidth = width or 150
	local thumbnailHeight = height or 150

	return RbxThumbUtils.getThumbnailUrl(RbxThumbnailTypes.GROUP_ICON, targetId, thumbnailWidth, thumbnailHeight)
end

--[=[
	Gets a Outfit URL for use in an image label or other rendering application.

	Supported sizes: 150x150, 420x420

	@param targetId number
	@param width number?
	@param height number?
	@return string
]=]
function RbxThumbUtils.getOutfitThumbnailUrl(targetId: number, width: number?, height: number?): string
	assert(type(targetId) == "number", "Bad targetId")

	local thumbnailWidth = width or 150
	local thumbnailHeight = height or 150

	return RbxThumbUtils.getThumbnailUrl(RbxThumbnailTypes.OUTFIT, targetId, thumbnailWidth, thumbnailHeight)
end

return RbxThumbUtils