add item (missing upload)

graph/schema/item.gql

@@ -0,0 +1,57 @@
+"""
+An item that can be required for an issue.
+"""
+type Item {
+    "The item's unique ID."
+    id: String!
+    "Name of the item."
+    name: String!
+    "A description of the item."
+    description: String!
+    "Item tags."
+    tags: [String!]!
+    "Quantity unit. Usually absent, but otherwise most often 'g' or 'ml'"
+    quantityUnit: String
+    "URL for the image, if available."
+    imageUrl: String
+}
+
+"Filter for the items query."
+input ItemFilter {
+    "Get these item IDs. Mostly used internally."
+    itemIds: [String!]
+    "Limit to items with any of the following tags."
+    tags: [String!]
+}
+
+"Input for the createItem mutation."
+input ItemCreateInput {
+    "Put a name on it."
+    name: String!
+    "Describe it for me."
+    description: String!
+    "Add a tag or a few"
+    tags: [String!]!
+    "Optional: Quanity unit."
+    quantityUnit: String
+    "Optional: Upload an image."
+    image: Upload
+}
+
+"Input for the editItem mutation."
+input ItemEditInput {
+    "Update the name."
+    setName: String
+    "Update the description."
+    setDescription: String
+    "Add new tags. The tags are added after removeTag tags are removed."
+    addTags: [String]
+    "Remove existing tags. If a tag exists both here and in addTags, it will not be removed."
+    removeTags: [String]
+    "Update quantity unit."
+    setQuantityUnit: String
+    "Clear quantity unit."
+    clearQuantityUnit: Boolean
+    "Update the image URL with a new image."
+    updateImage: Upload
+}

graph/schema/mutation.gql

@@ -10,6 +10,10 @@ type Mutation {
     editActivity(input: ActivityEditInput!): Activity!
 
     # ITEM
+    "Create an item."
+    createItem(input: ItemCreateInput): Item!
+    "Edit an item."
+    editItem(input: ItemEditInput): Item!
 
     # ISSUE
     "Create a new issue."

graph/schema/query.gql

@@ -1,14 +1,21 @@
 type Query {
-    "Find issue"
+    "Find issue."
     issue(id: String!): Issue!
-    "List issues"
+    "List issues."
     issues(filter: IssueFilter): [Issue!]!
 
-    "Find project"
+    "Find item."
+    item(id: String!): Item!
+    "List items."
+    items(filter: ItemFilter): [Item!]!
+    "List item tags."
+    itemTags: [String!]!
+
+    "Find project."
     project(id: String!): Project!
-    "List projects"
+    "List projects."
     projects(filter: ProjectFilter): [Project!]!
 
-    "Session checks the user session."
+    "Check the user session."
     session: User
 }

graph/schema/scalars.gql

@@ -7,4 +7,9 @@ scalar Time
 Duration in milliseconds. It will output as an integer, but can be supplied as a float, integer
 or a string accepted by the Go time.Duration parser.
 """
-scalar Duration
+scalar Duration
+
+"""
+A file upload.
+"""
+scalar Upload