[NEW] Surface featured apps endpoint

apps/meteor/app/apps/server/communication/rest.js

@@ -347,6 +347,38 @@ export class AppsRestApi {
 			},
 		);
 
+		this.api.addRoute(
+			'featured',
+			{ authRequired: true },
+			{
+				get() {
+					const baseUrl = orchestrator.getMarketplaceUrl();
+
+					const headers = getDefaultHeaders();
+					const token = getWorkspaceAccessToken();
+					if (token) {
+						headers.Authorization = `Bearer ${token}`;
+					}
+
+					let result;
+					try {
+						result = HTTP.get(`${baseUrl}/v1/apps/featured`, {
+							headers,
+						});
+					} catch (e) {
+						return handleError('Unable to access Marketplace. Does the server has access to the internet?', e);
+					}
+
+					if (!result || result.statusCode !== 200) {
+						orchestrator.getRocketChatLogger().error('Error getting the Featured Apps from the Marketplace:', result.data);
+						return API.v1.failure();
+					}
+
+					return API.v1.success(result.data);
+				},
+			},
+		);
+
 		this.api.addRoute(
 			':id',
 			{ authRequired: true, permissionsRequired: ['manage-apps'] },

packages/core-typings/src/FeaturedApps.ts

@@ -0,0 +1,11 @@
+import type { App } from './Apps';
+
+export type FeaturedAppsSections = {
+	sections: FeaturedAppsSection[];
+};
+
+export type FeaturedAppsSection = {
+	i18nLabel: string;
+	slug: string;
+	apps: App[];
+};

packages/core-typings/src/index.ts

@@ -1,4 +1,5 @@
 export * from './Apps';
+export * from './FeaturedApps';
 export * from './IRoom';
 export * from './UIKit';
 export * from './IMessage';

packages/rest-typings/src/apps/index.ts

@@ -4,7 +4,7 @@ import type { IExternalComponent } from '@rocket.chat/apps-engine/definition/ext
 import type { IPermission } from '@rocket.chat/apps-engine/definition/permissions/IPermission';
 import type { ISetting } from '@rocket.chat/apps-engine/definition/settings';
 import type { IUIActionButton } from '@rocket.chat/apps-engine/definition/ui';
-import type { AppScreenshot, App } from '@rocket.chat/core-typings';
+import type { AppScreenshot, App, FeaturedAppsSections } from '@rocket.chat/core-typings';
 
 export type AppsEndpoints = {
 	'/apps/externalComponents': {
@@ -96,6 +96,12 @@ export type AppsEndpoints = {
 		};
 	};
 
+	'/apps/featured': {
+		GET: () => {
+			sections: FeaturedAppsSections;
+		};
+	};
+
 	'/apps': {
 		GET:
 			| ((params: { buildExternalUrl: 'true'; purchaseType?: 'buy' | 'subscription'; appId?: string; details?: 'true' | 'false' }) => {