feat: add (record|remove)ArtworkView mutations

- add recordArtworkView mutation to replace stitched version from Gravity
- new removeArtworkView mutation

Author: dblandin

_schemaV2.graphql

@@ -14057,10 +14057,16 @@ type Mutation {
     input: MyCollectionUpdateArtworkInput!
   ): MyCollectionUpdateArtworkPayload
   publishViewingRoom(input: PublishViewingRoomInput!): PublishViewingRoomPayload
+
+  # Record an artwork view.
   recordArtworkView(
-    # Parameters for RecordArtworkView
-    input: RecordArtworkViewInput!
-  ): RecordArtworkViewPayload
+    input: RecordArtworkViewMutationInput!
+  ): RecordArtworkViewMutationPayload
+
+  # Remove an artwork view.
+  removeArtworkView(
+    input: RemoveArtworkViewMutationInput!
+  ): RemoveArtworkViewMutationPayload
   removeAssetFromConsignmentSubmission(
     # Parameters for RemoveAssetFromConsignmentSubmission
     input: RemoveAssetFromConsignmentSubmissionInput!
@@ -17717,23 +17723,18 @@ type RecentlySoldArtworkTypeEdge {
   node: RecentlySoldArtworkType
 }
 
-# Autogenerated input type of RecordArtworkView
-input RecordArtworkViewInput {
+input RecordArtworkViewMutationInput {
+  # ID of artwork.
   artwork_id: String!
-
-  # A unique identifier for the client performing the mutation.
   clientMutationId: String
 }
 
-# Autogenerated return type of RecordArtworkView
-type RecordArtworkViewPayload {
-  # Id of viewed artwork
+type RecordArtworkViewMutationPayload {
+  # ID of viewed artwork.
   artworkId: String!
 
-  # Id of viewed artwork
-  artwork_id: String! @deprecated(reason: "Use artworkId")
-
-  # A unique identifier for the client performing the mutation.
+  # ID of viewed artwork.
+  artwork_id: String! @deprecated(reason: "Use artworkId.")
   clientMutationId: String
 }
 
@@ -17761,6 +17762,21 @@ type RelatedArtworkGrid implements ArtworkContextGrid {
   title: String
 }
 
+input RemoveArtworkViewMutationInput {
+  # ID of artwork.
+  artwork_id: String!
+  clientMutationId: String
+}
+
+type RemoveArtworkViewMutationPayload {
+  # ID of viewed artwork.
+  artworkId: String!
+
+  # ID of viewed artwork.
+  artwork_id: String! @deprecated(reason: "Use artworkId.")
+  clientMutationId: String
+}
+
 # Autogenerated input type of RemoveAssetFromConsignmentSubmission
 input RemoveAssetFromConsignmentSubmissionInput {
   assetID: String

src/lib/loaders/loaders_with_authentication/gravity.ts

@@ -72,6 +72,11 @@ export default (accessToken, userID, opts) => {
       {},
       { method: "POST" }
     ),
+    createArtworkViewLoader: gravityLoader(
+      (artworkID) => `artwork/${artworkID}/view`,
+      {},
+      { method: "POST" }
+    ),
     createCommerceOptInEligibleArtworksReportLoader: gravityLoader(
       (id) => `partner/${id}/commerce_opt_in_eligible_artworks_report`,
       {},
@@ -215,6 +220,11 @@ export default (accessToken, userID, opts) => {
       {},
       { method: "DELETE" }
     ),
+    deleteArtworkViewLoader: gravityLoader(
+      (artworkID) => `artwork/${artworkID}/view`,
+      {},
+      { method: "DELETE" }
+    ),
     deleteBankAccountLoader: gravityLoader(
       (id) => `me/bank_account/${id}`,
       {},

src/lib/stitching/gravity/schema.ts

@@ -87,6 +87,7 @@ export const executableGravitySchema = () => {
     excludedMutations.push("updateViewingRoomArtworks")
     excludedMutations.push("updateViewingRoomSubsections")
   }
+  excludedMutations.push("recordArtworkView")
 
   // Types which come from Gravity that are not (yet) needed in MP.
   // In the future, these can be removed from this list as they are needed.
@@ -96,6 +97,8 @@ export const executableGravitySchema = () => {
     "LotEvent",
     "RefundCommissionExemptionInput",
     "RefundCommissionExemptionPayload",
+    "RecordArtworkViewInput",
+    "RecordArtworkViewPayload",
   ]
 
   // Return the new modified schema

src/schema/v2/__tests__/recordArtworkViewMutation.test.ts

@@ -0,0 +1,26 @@
+/* eslint-disable promise/always-return */
+import { runAuthenticatedQuery } from "schema/v2/test/utils"
+
+describe("recording an artwork view", () => {
+  const query = `
+  mutation {
+    recordArtworkView(input: { artwork_id: "artwork-id" }) {
+      artworkId
+    }
+  }
+  `
+
+  const context = {
+    createArtworkViewLoader: () =>
+      Promise.resolve({ artwork_id: "artwork-id" }),
+  }
+
+  it("records an artwork view", async () => {
+    const data = await runAuthenticatedQuery(query, context)
+    expect(data).toEqual({
+      recordArtworkView: {
+        artworkId: "artwork-id",
+      },
+    })
+  })
+})

src/schema/v2/__tests__/removeArtworkViewMutation.test.ts

@@ -0,0 +1,26 @@
+/* eslint-disable promise/always-return */
+import { runAuthenticatedQuery } from "schema/v2/test/utils"
+
+describe("removing an artwork view", () => {
+  const query = `
+  mutation {
+    removeArtworkView(input: { artwork_id: "artwork-id" }) {
+      artworkId
+    }
+  }
+  `
+
+  const context = {
+    deleteArtworkViewLoader: () =>
+      Promise.resolve({ artwork_id: "artwork-id" }),
+  }
+
+  it("removes an artwork view", async () => {
+    const data = await runAuthenticatedQuery(query, context)
+    expect(data).toEqual({
+      removeArtworkView: {
+        artworkId: "artwork-id",
+      },
+    })
+  })
+})

src/schema/v2/recordArtworkView.ts

@@ -0,0 +1,43 @@
+import { GraphQLNonNull, GraphQLString } from "graphql"
+import { mutationWithClientMutationId } from "graphql-relay"
+import { ResolverContext } from "types/graphql"
+import { GraphQLError } from "graphql"
+
+export interface RecordArtworkViewMutationInput {
+  artwork_id: string
+}
+
+export const recordArtworkViewMutation = mutationWithClientMutationId<
+  RecordArtworkViewMutationInput,
+  any,
+  ResolverContext
+>({
+  name: "RecordArtworkViewMutation",
+  description: "Record an artwork view.",
+  inputFields: {
+    artwork_id: {
+      type: new GraphQLNonNull(GraphQLString),
+      description: "ID of artwork.",
+    },
+  },
+  outputFields: {
+    artwork_id: {
+      description: "ID of viewed artwork.",
+      type: new GraphQLNonNull(GraphQLString),
+      deprecationReason: "Use artworkId.",
+    },
+    artworkId: {
+      description: "ID of viewed artwork.",
+      type: new GraphQLNonNull(GraphQLString),
+    },
+  },
+  mutateAndGetPayload: async ({ artwork_id }, { createArtworkViewLoader }) => {
+    try {
+      const response = await createArtworkViewLoader(artwork_id)
+
+      return { artwork_id: response.artwork_id, artworkId: response.artwork_id }
+    } catch (error) {
+      throw new GraphQLError(`RecordArtworkViewMutation error: ${error}`)
+    }
+  },
+})

src/schema/v2/removeArtworkView.ts

@@ -0,0 +1,43 @@
+import { GraphQLNonNull, GraphQLString } from "graphql"
+import { mutationWithClientMutationId } from "graphql-relay"
+import { ResolverContext } from "types/graphql"
+import { GraphQLError } from "graphql"
+
+export interface RemoveArtworkViewMutationInput {
+  artwork_id: string
+}
+
+export const removeArtworkViewMutation = mutationWithClientMutationId<
+  RemoveArtworkViewMutationInput,
+  any,
+  ResolverContext
+>({
+  name: "RemoveArtworkViewMutation",
+  description: "Remove an artwork view.",
+  inputFields: {
+    artwork_id: {
+      type: new GraphQLNonNull(GraphQLString),
+      description: "ID of artwork.",
+    },
+  },
+  outputFields: {
+    artwork_id: {
+      description: "ID of viewed artwork.",
+      type: new GraphQLNonNull(GraphQLString),
+      deprecationReason: "Use artworkId.",
+    },
+    artworkId: {
+      description: "ID of viewed artwork.",
+      type: new GraphQLNonNull(GraphQLString),
+    },
+  },
+  mutateAndGetPayload: async ({ artwork_id }, { deleteArtworkViewLoader }) => {
+    try {
+      const response = await deleteArtworkViewLoader(artwork_id)
+
+      return { artworkId: response.artwork_id }
+    } catch (error) {
+      throw new GraphQLError(`RemoveArtworkViewMutation error: ${error}`)
+    }
+  },
+})

src/schema/v2/schema.ts

@@ -268,6 +268,8 @@ import { unpublishViewingRoomMutation } from "./viewingRooms/mutations/unpublish
 import { updateViewingRoomArtworksMutation } from "./viewingRooms/mutations/updateViewingRoomArtworks"
 import { updateViewingRoomSubsectionsMutation } from "./viewingRooms/mutations/updateViewingRoomSubsections"
 import { ViewingRoomConnection } from "./viewingRooms"
+import { recordArtworkViewMutation } from "./recordArtworkView"
+import { removeArtworkViewMutation } from "./removeArtworkView"
 
 const viewingRoomUnstitchedRootField = config.USE_UNSTITCHED_VIEWING_ROOM_SCHEMA
   ? {
@@ -506,6 +508,8 @@ export default new GraphQLSchema({
       myCollectionCreateArtwork: myCollectionCreateArtworkMutation,
       myCollectionDeleteArtwork: myCollectionDeleteArtworkMutation,
       myCollectionUpdateArtwork: myCollectionUpdateArtworkMutation,
+      recordArtworkView: recordArtworkViewMutation,
+      removeArtworkView: removeArtworkViewMutation,
       requestCredentialsForAssetUpload: CreateAssetRequestLoader,
       requestPriceEstimate: requestPriceEstimateMutation,
       saveArtwork: saveArtworkMutation,