docs: Update docs for AssetServiceCache

Author: Quenty

src/assetserviceutils/src/Shared/AssetServiceCache.lua

@@ -1,4 +1,7 @@
+--!strict
 --[=[
+	AssetServiceCache is a cache for the AssetServiceUtils functions.
+
 	@class AssetServiceCache
 ]=]
 
@@ -7,18 +10,28 @@ local require = require(script.Parent.loader).load(script)
 local MemorizeUtils = require("MemorizeUtils")
 local AssetServiceUtils = require("AssetServiceUtils")
 local _ServiceBag = require("ServiceBag")
+local _Promise = require("Promise")
 
 local AssetServiceCache = {}
 AssetServiceCache.ServiceName = "AssetServiceCache"
 
+--[=[
+	Initializes the AssetServiceCache.
+	@param serviceBag ServiceBag
+]=]
 function AssetServiceCache:Init(serviceBag: _ServiceBag.ServiceBag)
 	assert(not self._serviceBag, "Already initialized")
 	self._serviceBag = assert(serviceBag, "No serviceBag")
 
 	self:_ensureInit()
 end
 
-function AssetServiceCache:PromiseBundleDetails(bundleId: number)
+--[=[
+	Returns a promise that resolves to the bundle details for the given bundleId.
+	@param bundleId number
+	@return Promise<BundleDetails>
+]=]
+function AssetServiceCache:PromiseBundleDetails(bundleId: number): _Promise.Promise<AssetServiceUtils.BundleDetails>
 	assert(type(bundleId) == "number", "Bad bundleId")
 
 	self:_ensureInit()

src/assetserviceutils/src/Shared/AssetServiceUtils.lua

@@ -1,3 +1,4 @@
+--!strict
 --[=[
 	Utility methods involving the AssetService
 	@class AssetServiceUtils
@@ -15,9 +16,9 @@ local AssetServiceUtils = {}
 	Retrieves the assetIds for a package
 
 	@param packageAssetId number
-	@return Promise<table>
+	@return Promise<{ number }>
 ]=]
-function AssetServiceUtils.promiseAssetIdsForPackage(packageAssetId: number)
+function AssetServiceUtils.promiseAssetIdsForPackage(packageAssetId: number): Promise.Promise<{ number }>
 	assert(type(packageAssetId) == "number", "Bad packageAssetId")
 
 	return Promise.spawn(function(resolve, reject)
@@ -43,7 +44,7 @@ end
 
 	@return Promise<Pages>
 ]=]
-function AssetServiceUtils.promiseGamePlaces()
+function AssetServiceUtils.promiseGamePlaces(): Promise.Promise<Pages>
 	return Promise.spawn(function(resolve, reject)
 		local pages
 		local ok, err = pcall(function()
@@ -102,7 +103,7 @@ export type BundleDetails = {
 	@param bundleId number
 	@return Promise<BundleDetails>
 ]=]
-function AssetServiceUtils.promiseBundleDetails(bundleId: number)
+function AssetServiceUtils.promiseBundleDetails(bundleId: number): Promise.Promise<BundleDetails>
 	assert(type(bundleId) == "number", "Bad bundleId")
 
 	return Promise.spawn(function(resolve, reject)