Add package version support for getPackageListingDetails Dapper method

PackageListing as a concept is version-agnostic, but to ensure we don't
serve pages for rejected package versions, they need to be
community-scoped, as rejection is tied to PackageListing object.

This commit adds the support to Dapper and listingUtils, the actual
usage will be done in a separate commit.

Since by default a PackageListing shows the latest package version, the
version argument remains optional.

Author: anttimaki

apps/cyberstorm-remix/app/p/listingUtils.ts

@@ -5,6 +5,7 @@ export interface ListingIdentifiers {
   communityId: string;
   namespaceId: string;
   packageId: string;
+  packageVersion?: string;
 }
 
 /**
@@ -16,12 +17,13 @@ export async function getPublicListing(
   dapper: DapperTs,
   ids: ListingIdentifiers
 ) {
-  const { communityId, namespaceId, packageId } = ids;
+  const { communityId, namespaceId, packageId, packageVersion } = ids;
   try {
     return await dapper.getPackageListingDetails(
       communityId,
       namespaceId,
-      packageId
+      packageId,
+      packageVersion
     );
   } catch (e) {
     if (isApiError(e) && e.response.status === 404) {
@@ -42,13 +44,14 @@ export async function getPrivateListing(
   dapper: DapperTs,
   ids: ListingIdentifiers
 ) {
-  const { communityId, namespaceId, packageId } = ids;
+  const { communityId, namespaceId, packageId, packageVersion } = ids;
 
   try {
     return await dapper.getPackageListingDetails(
       communityId,
       namespaceId,
-      packageId
+      packageId,
+      packageVersion
     );
   } catch (e) {
     const is404 = isApiError(e) && e.response?.status === 404;
@@ -61,6 +64,7 @@ export async function getPrivateListing(
     communityId,
     namespaceId,
     packageId,
+    packageVersion,
     true
   );
 

packages/dapper-fake/src/fakers/package.ts

@@ -127,12 +127,13 @@ export const getFakePackagePermissions = async (
 export const getFakePackageListingDetails = async (
   community: string,
   namespace: string,
-  name: string
+  name: string,
+  version?: string
 ) => {
   const seed = `${community}-${namespace}-${name}`;
   setSeed(seed);
 
-  const version = getVersionNumber();
+  const ver = version ?? getVersionNumber();
   const dependencies = await getFakeDependencies(community, namespace, name);
 
   return {
@@ -143,10 +144,10 @@ export const getFakePackageListingDetails = async (
     dependant_count: faker.number.int({ min: 0, max: 2000 }),
     dependencies,
     dependency_count: dependencies.length,
-    download_url: `https://thunderstore.io/package/download/${namespace}/${name}/${version}/`,
-    full_version_name: `${namespace}-${name}-${version}}`,
+    download_url: `https://thunderstore.io/package/download/${namespace}/${name}/${ver}/`,
+    full_version_name: `${namespace}-${name}-${ver}`,
     has_changelog: true,
-    install_url: `ror2mm://v1/install/thunderstore.io/${namespace}/${name}/${version}/`,
+    install_url: `ror2mm://v1/install/thunderstore.io/${namespace}/${name}/${ver}/`,
     latest_version_number: getVersionNumber(),
     team: {
       name: faker.word.words(3),

packages/dapper-ts/src/methods/packageListings.ts

@@ -123,6 +123,7 @@ export async function getPackageListingDetails(
   communityId: string,
   namespaceId: string,
   packageName: string,
+  version: string | undefined = undefined,
   useSession = false
 ) {
   const data = await fetchPackageListingDetails({
@@ -131,6 +132,7 @@ export async function getPackageListingDetails(
       community_id: communityId,
       namespace_id: namespaceId,
       package_name: packageName,
+      version_number: version,
     },
     data: {},
     queryParams: {},

packages/dapper/src/types/methods.ts

@@ -44,7 +44,8 @@ export type GetPackageChangelog = (
 export type GetPackageListingDetails = (
   community: string,
   namespace: string,
-  name: string
+  name: string,
+  version?: string
 ) => Promise<PackageListingDetails>;
 
 export type GetPackageListings = (

packages/thunderstore-api/src/get/packageListingDetails.ts

@@ -16,7 +16,11 @@ export async function fetchPackageListingDetails(
   props: ApiEndpointProps<PackageListingDetailsRequestParams, object, object>
 ): Promise<PackageListingDetailsResponseData> {
   const { config, params, useSession } = props;
-  const path = `${BASE_LISTING_PATH}${params.community_id}/${params.namespace_id}/${params.package_name}/`;
+  let path = `${BASE_LISTING_PATH}${params.community_id}/${params.namespace_id}/${params.package_name}/`;
+
+  if (params.version_number) {
+    path = `${path}v/${params.version_number}/`;
+  }
 
   return await apiFetch({
     args: {

packages/thunderstore-api/src/schemas/requestSchemas.ts

@@ -170,6 +170,7 @@ export const packageListingDetailsRequestParamsSchema = z.object({
   community_id: z.string(),
   namespace_id: z.string(),
   package_name: z.string(),
+  version_number: z.string().optional(),
 });
 
 export type PackageListingDetailsRequestParams = z.infer<