feat: add error message when project not aligned to spaceId

Author: lilbitner

apps/vercel/frontend/src/clients/Vercel.ts

@@ -6,8 +6,12 @@ import {
   ServerlessFunction,
   AccessToken,
   Deployment,
+  ProjectEnv,
+  Project,
 } from '@customTypes/configPage';
 
+const CONTENTFUL_SPACE_ID = 'CONTENTFUL_SPACE_ID';
+
 interface GetToken {
   ok: boolean;
   data: AccessToken;
@@ -18,6 +22,12 @@ interface VercelAPIClient {
   getToken: () => Promise<Response>;
   listProjects: (teamId?: string) => Promise<ListProjectsResponse>;
   listApiPaths: (projectId: string, teamId?: string) => Promise<ApiPath[]>;
+  validateProjectContentfulSpaceId: (
+    currentSpaceId: string,
+    projectId: string,
+    teamId: string,
+    envs: ProjectEnv[]
+  ) => Promise<boolean>;
 }
 
 export default class VercelClient implements VercelAPIClient {
@@ -146,6 +156,54 @@ export default class VercelClient implements VercelAPIClient {
     return data.deployments[0];
   }
 
+  async validateProjectContentfulSpaceId(
+    currentSpaceId: string,
+    projectId: string,
+    teamId: string
+  ) {
+    try {
+      const data = await this.listProject(projectId, teamId);
+      const envs = data.env;
+      const contentfulSpaceIdEnv = envs.find((env) => env.key === CONTENTFUL_SPACE_ID);
+      if (contentfulSpaceIdEnv) {
+        const res = await fetch(
+          `${this.baseEndpoint}/v1/projects/${projectId}/env/${contentfulSpaceIdEnv.id}`,
+          {
+            headers: this.buildHeaders(),
+            method: 'GET',
+          }
+        );
+
+        const data = await res.json();
+        return data.value === currentSpaceId;
+      }
+    } catch (e) {
+      // let user continue if there is an validating env value
+      console.error(e);
+    }
+
+    return false;
+  }
+
+  private async listProject(projectId: string, teamId: string): Promise<Project> {
+    let projectData: Response;
+    try {
+      projectData = await fetch(
+        `${this.baseEndpoint}/v9/projects/${projectId}?${this.buildTeamIdQueryParam(teamId)}`,
+        {
+          headers: this.buildHeaders(),
+          method: 'GET',
+        }
+      );
+    } catch (e) {
+      console.error(e);
+      throw new Error('Cannot fetch project data.');
+    }
+
+    const data = await projectData.json();
+    return data;
+  }
+
   private filterServerlessFunctions(data: ServerlessFunction[]) {
     return data.filter(
       (file: ServerlessFunction) => file.type === 'Page' && file.path.includes('api')

apps/vercel/frontend/src/components/common/SelectSection/SelectSection.spec.tsx

@@ -72,7 +72,11 @@ describe('SelectSection', () => {
 
   it('renders error message when selected option no longer exists', () => {
     const ID = singleSelectionSections.PROJECT_SELECTION_SECTION;
-    const projectSelectionError = { projectNotFound: true, cannotFetchProjects: false };
+    const projectSelectionError = {
+      projectNotFound: true,
+      cannotFetchProjects: false,
+      invalidSpaceId: false,
+    };
     const mockHandleInvalidSelectionError = vi.fn(() => {});
     const { unmount } = render(
       <SelectSection

apps/vercel/frontend/src/components/common/SelectSection/SelectSection.tsx

@@ -34,7 +34,7 @@ export const SelectSection = ({
 }: Props) => {
   const { placeholder, label, emptyMessage, helpText: helpTextCopy } = copies.configPage[section];
   const { isLoading } = useContext(ConfigPageContext);
-  const { isError, message } = useError({ error });
+  const { message } = useError({ error });
 
   useEffect(() => {
     if (!isLoading) {
@@ -51,7 +51,7 @@ export const SelectSection = ({
   return (
     <FormControl marginBottom="spacingS" id={id} isRequired={true}>
       <Select
-        value={isError ? '' : selectedOption}
+        value={selectedOption}
         onChange={handleChange}
         placeholder={placeholder}
         emptyMessage={emptyMessage}

apps/vercel/frontend/src/components/config-screen/ApiPathSelectionSection/ApiPathSelectionSection.tsx

@@ -22,6 +22,8 @@ export const ApiPathSelectionSection = ({ paths }: Props) => {
     useContext(ConfigPageContext);
   const { invalidDeploymentData, cannotFetchApiPaths } = errors.apiPathSelection;
 
+  const selectedOption = errors.apiPathSelection ? '' : parameters.selectedApiPath;
+
   const handleChange = (event: ChangeEvent<HTMLSelectElement>) => {
     dispatchParameters({
       type: parametersActions.APPLY_API_PATH,
@@ -47,7 +49,7 @@ export const ApiPathSelectionSection = ({ paths }: Props) => {
 
     return (
       <SelectSection
-        selectedOption={parameters.selectedApiPath}
+        selectedOption={selectedOption}
         options={paths}
         handleInvalidSelectionError={handleInvalidSelectionError}
         handleChange={handleChange}

apps/vercel/frontend/src/components/config-screen/ProjectSelectionSection/ProjectSelectionSection.tsx

@@ -10,17 +10,31 @@ import {
   singleSelectionSections,
 } from '@constants/enums';
 import { ConfigPageContext } from '@contexts/ConfigPageProvider';
+import { useFetchData } from '@hooks/useFetchData/useFetchData';
 
 interface Props {
   projects: Project[];
 }
 
 export const ProjectSelectionSection = ({ projects }: Props) => {
   const sectionId = singleSelectionSections.PROJECT_SELECTION_SECTION;
-  const { parameters, errors, dispatchErrors, dispatchParameters, handleAppConfigurationChange } =
-    useContext(ConfigPageContext);
+  const {
+    parameters,
+    errors,
+    dispatchErrors,
+    dispatchParameters,
+    handleAppConfigurationChange,
+    sdk,
+    vercelClient,
+  } = useContext(ConfigPageContext);
+  const { validateProjectEnv } = useFetchData({
+    dispatchErrors,
+    dispatchParameters,
+    vercelClient,
+    teamId: parameters.teamId,
+  });
 
-  const handleChange = (event: ChangeEvent<HTMLSelectElement>) => {
+  const handleChange = async (event: ChangeEvent<HTMLSelectElement>) => {
     // indicate app config change when project has been re-selected
     handleAppConfigurationChange();
 
@@ -35,9 +49,8 @@ export const ProjectSelectionSection = ({ projects }: Props) => {
       payload: event.target.value,
     });
 
-    dispatchErrors({
-      type: errorsActions.RESET_PROJECT_SELECTION_ERRORS,
-    });
+    const currentSpaceId = sdk.ids.space;
+    await validateProjectEnv(currentSpaceId, event.target.value);
   };
 
   const handleInvalidSelectionError = () => {
@@ -47,10 +60,12 @@ export const ProjectSelectionSection = ({ projects }: Props) => {
     });
   };
 
+  const selectedOption = errors.projectSelection.projectNotFound ? '' : parameters.selectedProject;
+
   return (
     <SectionWrapper testId={sectionId}>
       <SelectSection
-        selectedOption={parameters.selectedProject}
+        selectedOption={selectedOption}
         options={projects}
         handleInvalidSelectionError={handleInvalidSelectionError}
         section={sectionId}

apps/vercel/frontend/src/constants/defaultParams.ts

@@ -17,6 +17,7 @@ export const initialErrors: Errors = {
   projectSelection: {
     projectNotFound: false,
     cannotFetchProjects: false,
+    invalidSpaceId: false,
   },
   apiPathSelection: {
     apiPathNotFound: false,

apps/vercel/frontend/src/constants/enums.ts

@@ -36,4 +36,5 @@ export enum errorTypes {
   EMPTY_PREVIEW_PATH_INPUT = 'emptyPreviewPathInput',
   API_PATHS_EMPTY = 'apiPathsEmpty',
   INVALID_DEPLOYMENT_DATA = 'invalidDeploymentData',
+  INVALID_SPACE_ID = 'invalidSpaceId',
 }

apps/vercel/frontend/src/constants/errorMessages.ts

@@ -12,4 +12,6 @@ export const errorMessages = {
   invalidPreviewPathFormat: 'Path must start with a "/", and include a {token}.',
   emptyPreviewPathInput: 'Field is empty.',
   invalidDeploymentData: 'We had trouble fetching routes for this Vercel project.',
+  invalidSpaceId:
+    'It looks like you’ve configured an environment variable, CONTENTFUL_SPACE_ID, in the selected Vercel project that doesn’t match the id of the space where this app is installed.',
 };

apps/vercel/frontend/src/contexts/ConfigPageProvider.tsx

@@ -1,8 +1,9 @@
 import { createContext, Dispatch } from 'react';
-import { ContentType } from '@contentful/app-sdk';
+import { ConfigAppSDK, ContentType } from '@contentful/app-sdk';
 import { ParameterAction } from '@reducers/parameterReducer';
 import { AppInstallationParameters, Errors } from '@customTypes/configPage';
 import { ErrorAction } from '@reducers/errorsReducer';
+import VercelClient from '@clients/Vercel';
 
 interface ConfigPageContextValue {
   isAppConfigurationSaved: boolean;
@@ -13,6 +14,8 @@ interface ConfigPageContextValue {
   dispatchErrors: Dispatch<ErrorAction>;
   handleAppConfigurationChange: () => void;
   isLoading: boolean;
+  sdk: ConfigAppSDK;
+  vercelClient: VercelClient | null;
 }
 
 export interface ChannelContextProviderProps extends ConfigPageContextValue {
@@ -32,6 +35,8 @@ export const ConfigPageProvider = (props: ChannelContextProviderProps) => {
     errors,
     handleAppConfigurationChange,
     isLoading,
+    sdk,
+    vercelClient,
   } = props;
 
   return (
@@ -45,6 +50,8 @@ export const ConfigPageProvider = (props: ChannelContextProviderProps) => {
         errors,
         handleAppConfigurationChange,
         isLoading,
+        sdk,
+        vercelClient,
       }}>
       {children}
     </ConfigPageContext.Provider>

apps/vercel/frontend/src/customTypes/configPage.ts

@@ -17,6 +17,11 @@ export interface AppInstallationParameters {
   teamId?: string;
 }
 
+export type ProjectEnv = {
+  key: string;
+  id: string;
+  value: string;
+};
 export interface Project {
   id: string;
   name: string;
@@ -25,6 +30,7 @@ export interface Project {
       id: string;
     };
   };
+  env: ProjectEnv[];
 }
 
 export interface Deployment {
@@ -86,6 +92,7 @@ export type Errors = {
   projectSelection: {
     projectNotFound: boolean;
     cannotFetchProjects: boolean;
+    invalidSpaceId: boolean;
   };
   apiPathSelection: {
     apiPathNotFound: boolean;