Add support for revision specific package creation

- using the asset format: "<assetId>@<revisionId>" to specify the asset ID and the revision ID
   - will fail if revision is invalid/doesnt exist

- debug prints will now include a excerpt of response body

Author: okzyrox

readme.md

@@ -114,7 +114,7 @@ So that when you work with rojo, you can do something like this when handling pa
 ## Todo
 
 - [x] Generate package map for a given package (asset)
-    - [ ] generate from specific revision
+    - [x] generate from specific revision
         - [x] embed revision ID into package
 - [x] Generate a matching map for a given directory
 - [x] Compare mappings for changes

src/API.luau

@@ -31,10 +31,6 @@ local URLS: {[string]: URL} = {
 		url = "https://apis.roblox.com/assets/v1/assets/{ASSET_ID}",
 		method = "GET"
 	},
-	GET_META_BY_VERSION = {
-		url = "https://apis.roblox.com/assets/v1/assets/{ASSET_ID}/versions/{VERSION_NUMBER}",
-		method = "GET"
-	},
 	GET_CONTENT = {
 		url = "https://apis.roblox.com/asset-delivery-api/v1/assetId/{ASSET_ID}",
 		method = "GET"
@@ -150,6 +146,9 @@ function API.makeRequest(
 		Util.dprint("Request to URL failed:", url)
 		Util.dprint("Status Code:", response.statusCode)
 		Util.dprint("Response Body:", response.body)
+	else
+		Util.dprint("Request to URL succeeded:", url)
+		Util.dprint("Response Body:", response.body:sub(1, 100) .. ( #response.body > 100 and "..." or "" ))
 	end
 
 	return response.statusCode, response.body

src/Repackage.luau

@@ -54,10 +54,46 @@ local function promptContinue(
 	return lowered == "y" or lowered == "yes"
 end
 
+local function getAssetFromString(
+	assetStr: string
+): RobloxAPI.RequestedAsset
+	if assetStr:find("@") then
+		local parts = assetStr:split("@")
+		local assetIdStr = parts[1]
+		local revisionIdStr = parts[2]
+
+		local assetId = tonumber(assetIdStr)
+		local revisionId = tonumber(revisionIdStr)
+
+		if assetId == nil then
+			error("Invalid asset ID: " .. assetIdStr)
+		end
+
+		if revisionId == nil then
+			Util.error("Invalid revision ID: `" .. revisionIdStr .. "`")
+			print("The proper format for asset revisions is: " .. formatted("<assetId>", "yellow") .. formatted("@", "magenta") .. formatted("<revisionId>", "yellow"))
+            print("For example: " .. formatted("12345678900@3", "light_green"))
+			error("")
+		end
+
+		return RobloxAPI.asset(
+			assetId,
+			revisionId
+		)
+	else
+		local assetId = tonumber(assetStr)
+		if assetId == nil then
+			error("Invalid asset ID: " .. assetStr)
+		end
+
+		return RobloxAPI.asset(assetId)
+	end
+end
+
 local function createPackage(
-	assetId: string
+	assetString: string
 )	
-	local asset = RobloxAPI.asset(assetId)
+	local asset = getAssetFromString(assetString)
 	local packageName, tree = RobloxAPI.getPackageTree(asset)
 	if not tree or not packageName then
 		Util.error("Failed to retrieve package tree.")
@@ -84,7 +120,7 @@ local function createPackage(
 	Tree.writeInstanceTreeToFS(tree, outDir, true)
 	fs.writeFile(packageMetaFile, serde.encode("json", tree, true))
 
-	Util.info("Package created at:", packageOutDir)
+	Util.info("Package created at:", packageOutDir, asset.assetRevisionId and formatted(" (Revision: " .. asset.assetRevisionId .. ")", "grey") or "")
 end
 
 local function updateLocalPackage(
@@ -473,8 +509,8 @@ local Commands: {[string]: Command} = {
 	create = {
 		args = {
 			{
-				name = "Package Asset ID",
-				type = "number"
+				name = "Package Asset ID / Package Asset String",
+				type = "string"
 			}
 		},
 		desc = "Create a package onto the filesystem from a package asset",

src/RobloxAPI.luau

@@ -161,10 +161,6 @@ function RobloxAPI.getAssetMeta(
 ): AssetMetadata?
 	local replacements = {ASSET_ID = asset.assetId}
 	local urlData: API.URL = API.URLS.GET_META
-	if asset.assetRevisionId then
-		urlData = API.URLS.GET_META_BY_VERSION
-		replacements["VERSION_NUMBER"] = tostring(asset.assetRevisionId)
-	end
 
 	local statusCode, response = API.makeRequest(
 		urlData,
@@ -177,9 +173,6 @@ function RobloxAPI.getAssetMeta(
 		return jsonResponse
 	else
 		local base = "Failed to get asset meta for assetId: " .. asset.assetId
-		if asset.assetRevisionId then
-			base ..= " with version:" .. asset.assetRevisionId
-		end
 		Util.dprint(base, "Status Code:", statusCode, "Response:", response)
 		return nil
 	end
@@ -286,6 +279,10 @@ function RobloxAPI.getPackageTree(
 	local packageRevisionId: string = meta["revisionId"]
 	local content: ContentResponse? = RobloxAPI.getPackageContent(asset)
 	if content then
+		if asset.assetRevisionId then
+			packageRevisionId = tostring(asset.assetRevisionId)
+		end
+
 		local dataLocation = content["location"]
 		local _statusCode, response = API.makeRequest(
 			{