feat: change arg format of update mutations

the old format encouraged sending unnecessary data
and did not guard against bugs from sending extra data

Author: garobrik

src/project/projectService.ts

@@ -28,6 +28,8 @@ import * as terrasoApi from 'terraso-client-shared/terrasoApi/api';
 import {
   collapseConnectionEdges,
   collapseFields,
+  UpdateArg,
+  updateArgToInput,
 } from 'terraso-client-shared/terrasoApi/utils';
 
 const collapseProjectFields = collapseFields<ProjectDataFragment, Project>({
@@ -91,7 +93,9 @@ export const addProject = (project: ProjectAddMutationInput) => {
     .then(resp => collapseProjectFields(resp.addProject.project));
 };
 
-export const updateProject = (project: ProjectUpdateMutationInput) => {
+export const updateProject = (
+  update: UpdateArg<ProjectUpdateMutationInput>,
+) => {
   const query = graphql(`
     mutation updateProject($input: ProjectUpdateMutationInput!) {
       updateProject(input: $input) {
@@ -104,20 +108,23 @@ export const updateProject = (project: ProjectUpdateMutationInput) => {
   `);
 
   return terrasoApi
-    .requestGraphQL(query, { input: project })
+    .requestGraphQL(query, updateArgToInput(update))
     .then(resp => collapseProjectFields(resp.updateProject.project!));
 };
 
 export const deleteProject = (project: ProjectDeleteMutationInput) => {
   const query = graphql(`
     mutation deleteProject($input: ProjectDeleteMutationInput!) {
       deleteProject(input: $input) {
+        project {
+          id
+        }
         errors
       }
     }
   `);
 
   return terrasoApi
-    .requestGraphQL(query, { input: { id: project.id } })
-    .then(_ => project.id);
+    .requestGraphQL(query, { input: project })
+    .then(({ deleteProject: { project } }) => project.id);
 };

src/site/siteService.ts

@@ -20,11 +20,16 @@ import { graphql } from 'terraso-client-shared/graphqlSchema';
 import type {
   SiteAddMutationInput,
   SiteDataFragment,
+  SiteDeleteMutationInput,
   SiteUpdateMutationInput,
 } from 'terraso-client-shared/graphqlSchema/graphql';
 import type { Site } from 'terraso-client-shared/site/siteSlice';
 import * as terrasoApi from 'terraso-client-shared/terrasoApi/api';
-import { collapseConnectionEdges } from 'terraso-client-shared/terrasoApi/utils';
+import {
+  collapseConnectionEdges,
+  UpdateArg,
+  updateArgToInput,
+} from 'terraso-client-shared/terrasoApi/utils';
 
 const collapseSiteFields = (site: SiteDataFragment): Site => {
   const { project, owner, ...rest } = site;
@@ -117,7 +122,7 @@ export const addSite = (site: SiteAddMutationInput) => {
     .then(resp => collapseSiteFields(resp.addSite.site));
 };
 
-export const updateSite = (site: SiteUpdateMutationInput) => {
+export const updateSite = (update: UpdateArg<SiteUpdateMutationInput>) => {
   const query = graphql(`
     mutation updateSite($input: SiteUpdateMutationInput!) {
       updateSite(input: $input) {
@@ -130,20 +135,23 @@ export const updateSite = (site: SiteUpdateMutationInput) => {
   `);
 
   return terrasoApi
-    .requestGraphQL(query, { input: site })
+    .requestGraphQL(query, updateArgToInput(update))
     .then(resp => collapseSiteFields(resp.updateSite.site!));
 };
 
-export const deleteSite = (site: Site) => {
+export const deleteSite = (site: SiteDeleteMutationInput) => {
   const query = graphql(`
     mutation deleteSite($input: SiteDeleteMutationInput!) {
       deleteSite(input: $input) {
+        site {
+          id
+        }
         errors
       }
     }
   `);
 
   return terrasoApi
-    .requestGraphQL(query, { input: { id: site.id } })
-    .then(_ => site.id);
+    .requestGraphQL(query, { input: site })
+    .then(({ deleteSite: { site } }) => site.id);
 };

src/terrasoApi/utils.ts

@@ -15,6 +15,27 @@
  * along with this program. If not, see https://www.gnu.org/licenses/.
  */
 
+type Resolve<T> = T extends Function ? T : { [K in keyof T]: T[K] };
+
+export type UpdateArg<T extends { id: string }> = Resolve<{
+  id: string;
+  update: Resolve<Omit<T, 'id'>>;
+}>;
+
+export const updateArgToInput = <T extends { id: string }>({
+  id,
+  update,
+}: UpdateArg<T>) => {
+  if ('id' in update) {
+    throw Error(`
+      update arguments should not contain IDs! 
+      are you accidentally passing the entire model object into the 
+      update arg instead of just the fields you need to update?
+    `);
+  }
+  return { input: { ...update, id } };
+};
+
 export const collapseConnectionEdges = <T>(connection: {
   edges: { node: T }[];
 }): T[] => {