@financial-times/cp-content-pipeline-schema 2.15.0 → 3.0.0

package/typedefs/clip.graphql

@@ -11,7 +11,7 @@ type ClipSource {
   "The media type eg. video/mp4."
   mediaType: String!
 
- "The height of the clip in pixels."
+  "The height of the clip in pixels."
   pixelHeight: Int
 
   "The width of the clip in pixels."
@@ -48,7 +48,7 @@ type Caption {
 
 type Accessibility {
   "An array of captions for the clip."
-  captions: [Caption]
+  captions: [Caption!]
 
   "An abstract syntax tree of the transcript for the clip."
   transcript: RichText

package/typedefs/concept.graphql

@@ -1,6 +1,65 @@
 "A concept is supplemtary information item, like a location, person, organisation or topic. It is used to provide context to an article."
+interface ConceptInterface {
+  "The unique identifier of the concept -  a uuid or a url."
+  id: ID!
+
+  "The url of the media, eg. 'https://next-media-api.ft.com/renditions/16868569859480/0x0.mp3'."
+  url(vanity: Boolean, relative: Boolean): String!
+
+  "The api url of the concept, eg. 'http://api.ft.com/things/a579350c-61ce-4c00-97ca-ddaa2e0cacf6'."
+  apiUrl: String
+
+  "The type of the concept, eg. 'http://www.ft.com/ontology/Topic'."
+  directType: String
+
+  "Whether the concept is part of a package brand eg. 'ftSeries' or 'ftGuides'."
+  isPackageBrand: Boolean
+
+  "The relationship between the concept and the article, eg. 'http://www.ft.com/ontology/hasAuthor'."
+  predicate: String
+
+  "The preferred label of the concept, eg. 'Work & Careers'."
+  prefLabel: String!
+
+  "The type of the concept, eg. 'TOPIC'."
+  type: String
+
+  "An array of types, eg. ['http://www.ft.com/ontology/core/Thing', 'http://www.ft.com/ontology/Topic']."
+  types: [String!]
+}
 
-type Concept {
+"A concept is supplemtary information item, like a location, person, organisation or topic. It is used to provide context to an article."
+type Concept implements ConceptInterface {
+  "The unique identifier of the concept -  a uuid or a url."
+  id: ID!
+
+  "The url of the media, eg. 'https://next-media-api.ft.com/renditions/16868569859480/0x0.mp3'."
+  url(vanity: Boolean, relative: Boolean): String!
+
+  "The api url of the concept, eg. 'http://api.ft.com/things/a579350c-61ce-4c00-97ca-ddaa2e0cacf6'."
+  apiUrl: String!
+
+  "The type of the concept, eg. 'http://www.ft.com/ontology/Topic'."
+  directType: String!
+
+  "Whether the concept is part of a package brand eg. 'ftSeries' or 'ftGuides'."
+  isPackageBrand: Boolean!
+
+  "The relationship between the concept and the article, eg. 'http://www.ft.com/ontology/hasAuthor'."
+  predicate: String!
+
+  "The preferred label of the concept, eg. 'Work & Careers'."
+  prefLabel: String!
+
+  "The type of the concept, eg. 'TOPIC'."
+  type: String
+
+  "An array of types, eg. ['http://www.ft.com/ontology/core/Thing', 'http://www.ft.com/ontology/Topic']."
+  types: [String!]!
+}
+
+"An author is a concept that represents a person that was involved in the writing of an item of content."
+type Author implements ConceptInterface {
   "The unique identifier of the concept -  a uuid or a url."
   id: ID!
 
@@ -24,7 +83,10 @@ type Concept {
 
   "The type of the concept, eg. 'TOPIC'."
   type: String
-  
+
   "An array of types, eg. ['http://www.ft.com/ontology/core/Thing', 'http://www.ft.com/ontology/Topic']."
   types: [String!]
+
+  "The People API data for the person referenced by this Author concept."
+  person: Person!
 }

package/typedefs/content.graphql

@@ -68,17 +68,20 @@ interface Content {
   "The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain."
   url(vanity: Boolean, relative: Boolean): String!
 
-  "The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
+  "The ISO string date the article was marked as published, eg. '2024-04-03T10:35:52.443Z'."
   publishedDate: String!
 
-  "The number of milliseconds since the unix epoch the article was published, eg '1712140552443'."
+  "The number of milliseconds since the unix epoch the article was marked as published, eg '1712140552443'."
   publishedTimestamp: Float!
 
+  "The number of milliseconds since the unix epoch the article was last changed, eg '1712140552443'."
+  modifiedTimestamp: Float!
+
   "The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
   firstPublishedDate: String!
 
   "A string ID used to trace content publishes through the pipeline, e.g. 'republish_tid_JNhUrBjdXo'."
-  publishReference: String!
+  publishReference: String
 
   "An image object containing the url and the caption, to be displayed usually before the article content."
   mainImage: Image
@@ -96,7 +99,7 @@ interface Content {
   teaser: Teaser
 
   "An array of concepts related to the article, eg. organisations or topics."
-  annotations: [Concept]
+  annotations(byPredicate: String): [ConceptInterface!]!
 
   "The editorial division the article belongs to, eg. 'FT-SpecialReports'."
   editorialDesk: String
@@ -145,17 +148,20 @@ type Article implements Content {
   "The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain."
   url(vanity: Boolean, relative: Boolean): String!
 
-  "The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
+  "The ISO string date the article was marked as published, eg. '2024-04-03T10:35:52.443Z'."
   publishedDate: String!
 
-  "The number of milliseconds since the unix epoch the article was published, eg '1712140552443'."
+  "The number of milliseconds since the unix epoch the article was marked as published, eg '1712140552443'."
   publishedTimestamp: Float!
 
+  "The number of milliseconds since the unix epoch the article was last changed, eg '1712140552443'."
+  modifiedTimestamp: Float!
+
   "The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
   firstPublishedDate: String!
 
   "A string ID used to trace content publishes through the pipeline, e.g. 'republish_tid_JNhUrBjdXo'."
-  publishReference: String!
+  publishReference: String
 
   "An image object containing the url and the caption, to be displayed usually before the article content."
   mainImage: Image
@@ -173,7 +179,7 @@ type Article implements Content {
   teaser: Teaser
 
   "An array of concepts related to the article, eg. organisations or topics."
-  annotations: [Concept]
+  annotations(byPredicate: String): [ConceptInterface!]!
 
   "The editorial division the article belongs to, eg. 'FT-SpecialReports'."
   editorialDesk: String
@@ -225,17 +231,20 @@ type Placeholder implements Content {
   "The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain."
   url(vanity: Boolean, relative: Boolean): String!
 
-  "The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
+  "The ISO string date the article was marked as published, eg. '2024-04-03T10:35:52.443Z'."
   publishedDate: String!
 
-  "The number of milliseconds since the unix epoch the article was published, eg '1712140552443'."
+  "The number of milliseconds since the unix epoch the article was marked as published, eg '1712140552443'."
   publishedTimestamp: Float!
 
+  "The number of milliseconds since the unix epoch the article was last changed, eg '1712140552443'."
+  modifiedTimestamp: Float!
+
   "The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
   firstPublishedDate: String!
 
   "A string ID used to trace content publishes through the pipeline, e.g. 'republish_tid_JNhUrBjdXo'."
-  publishReference: String!
+  publishReference: String
 
   "An image object containing the url and the caption, to be displayed usually before the article content."
   mainImage: Image
@@ -253,7 +262,7 @@ type Placeholder implements Content {
   teaser: Teaser
 
   "An array of concepts related to the article, eg. organisations or topics."
-  annotations: [Concept]
+  annotations(byPredicate: String): [ConceptInterface!]!
 
   "The editorial division the article belongs to, eg. 'FT-SpecialReports'."
   editorialDesk: String
@@ -305,17 +314,20 @@ type LiveBlogPackage implements Content {
   "The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain."
   url(vanity: Boolean, relative: Boolean): String!
 
-  "The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
+  "The ISO string date the article was marked as published, eg. '2024-04-03T10:35:52.443Z'."
   publishedDate: String!
 
-  "The number of milliseconds since the unix epoch the article was published, eg '1712140552443'."
+  "The number of milliseconds since the unix epoch the article was marked as published, eg '1712140552443'."
   publishedTimestamp: Float!
 
+  "The number of milliseconds since the unix epoch the article was last changed, eg '1712140552443'."
+  modifiedTimestamp: Float!
+
   "The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
   firstPublishedDate: String!
 
   "A string ID used to trace content publishes through the pipeline, e.g. 'republish_tid_JNhUrBjdXo'."
-  publishReference: String!
+  publishReference: String
 
   "An image object containing the url and the caption, to be displayed usually before the article content."
   mainImage: Image
@@ -333,7 +345,7 @@ type LiveBlogPackage implements Content {
   teaser: Teaser
 
   "An array of concepts related to the article, eg. organisations or topics."
-  annotations: [Concept]
+  annotations(byPredicate: String): [ConceptInterface!]!
 
   "The editorial division the article belongs to, eg. 'FT-SpecialReports'."
   editorialDesk: String
@@ -357,12 +369,7 @@ type LiveBlogPackage implements Content {
   design: Design
 
   "The child articles of this live blog package."
-  liveBlogPosts(
-    includePinned: Boolean
-      @deprecated(
-        reason: "avoiding breaking change, will remove argument on next major release"
-      )
-  ): [Content]
+  liveBlogPosts: [Content]
 
   "The pinned article of this live blog package."
   pinnedPost: Content
@@ -396,17 +403,20 @@ type LiveBlogPost implements Content {
   "The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain."
   url(vanity: Boolean, relative: Boolean): String!
 
-  "The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
+  "The ISO string date the article was marked as published, eg. '2024-04-03T10:35:52.443Z'."
   publishedDate: String!
 
-  "The number of milliseconds since the unix epoch the article was published, eg '1712140552443'."
+  "The number of milliseconds since the unix epoch the article was marked as published, eg '1712140552443'."
   publishedTimestamp: Float!
 
+  "The number of milliseconds since the unix epoch the article was last changed, eg '1712140552443'."
+  modifiedTimestamp: Float!
+
   "The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
   firstPublishedDate: String!
 
   "A string ID used to trace content publishes through the pipeline, e.g. 'republish_tid_JNhUrBjdXo'."
-  publishReference: String!
+  publishReference: String
 
   "An image object containing the url and the caption, to be displayed usually before the article content."
   mainImage: Image
@@ -424,7 +434,7 @@ type LiveBlogPost implements Content {
   teaser: Teaser
 
   "An array of concepts related to the article, eg. organisations or topics."
-  annotations: [Concept]
+  annotations(byPredicate: String): [ConceptInterface!]!
 
   "The editorial division the article belongs to, eg. 'FT-SpecialReports'."
   editorialDesk: String
@@ -455,7 +465,12 @@ type LiveBlogPost implements Content {
 
   "Whether the live-blog-post should be pinned."
   isPinned: Boolean
-  authors: [Person]
+
+  "The People API data for the authors of the live blog post"
+  authors: [Person!]!
+    @deprecated(
+      reason: "use Content.annotations(byPredicate: \"http://www.ft.com/ontology/annotation/hasAuthor\")"
+    )
 }
 
 type Audio implements Content {
@@ -483,17 +498,20 @@ type Audio implements Content {
   "The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain."
   url(vanity: Boolean, relative: Boolean): String!
 
-  "The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
+  "The ISO string date the article was marked as published, eg. '2024-04-03T10:35:52.443Z'."
   publishedDate: String!
 
-  "The number of milliseconds since the unix epoch the article was published, eg '1712140552443'."
+  "The number of milliseconds since the unix epoch the article was marked as published, eg '1712140552443'."
   publishedTimestamp: Float!
 
+  "The number of milliseconds since the unix epoch the article was last changed, eg '1712140552443'."
+  modifiedTimestamp: Float!
+
   "The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
   firstPublishedDate: String!
 
   "A string ID used to trace content publishes through the pipeline, e.g. 'republish_tid_JNhUrBjdXo'."
-  publishReference: String!
+  publishReference: String
 
   "An image object containing the url and the caption, to be displayed usually before the article content."
   mainImage: Image
@@ -511,7 +529,7 @@ type Audio implements Content {
   teaser: Teaser
 
   "An array of concepts related to the article, eg. organisations or topics."
-  annotations: [Concept]
+  annotations(byPredicate: String): [ConceptInterface!]!
 
   "The editorial division the article belongs to, eg. 'FT-SpecialReports'."
   editorialDesk: String
@@ -563,17 +581,20 @@ type Video implements Content {
   "The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain."
   url(vanity: Boolean, relative: Boolean): String!
 
-  "The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
+  "The ISO string date the article was marked as published, eg. '2024-04-03T10:35:52.443Z'."
   publishedDate: String!
 
-  "The number of milliseconds since the unix epoch the article was published, eg '1712140552443'."
+  "The number of milliseconds since the unix epoch the article was marked as published, eg '1712140552443'."
   publishedTimestamp: Float!
 
+  "The number of milliseconds since the unix epoch the article was last changed, eg '1712140552443'."
+  modifiedTimestamp: Float!
+
   "The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
   firstPublishedDate: String!
 
   "A string ID used to trace content publishes through the pipeline, e.g. 'republish_tid_JNhUrBjdXo'."
-  publishReference: String!
+  publishReference: String
 
   "An image object containing the url and the caption, to be displayed usually before the article content."
   mainImage: Image
@@ -591,7 +612,7 @@ type Video implements Content {
   teaser: Teaser
 
   "An array of concepts related to the article, eg. organisations or topics."
-  annotations: [Concept]
+  annotations(byPredicate: String): [ConceptInterface!]!
 
   "The editorial division the article belongs to, eg. 'FT-SpecialReports'."
   editorialDesk: String
@@ -640,17 +661,20 @@ type ContentPackage implements Content {
   "The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain."
   url(vanity: Boolean, relative: Boolean): String!
 
-  "The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
+  "The ISO string date the article was marked as published, eg. '2024-04-03T10:35:52.443Z'."
   publishedDate: String!
 
-  "The number of milliseconds since the unix epoch the article was published, eg '1712140552443'."
+  "The number of milliseconds since the unix epoch the article was marked as published, eg '1712140552443'."
   publishedTimestamp: Float!
 
+  "The number of milliseconds since the unix epoch the article was last changed, eg '1712140552443'."
+  modifiedTimestamp: Float!
+
   "The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'."
   firstPublishedDate: String!
 
   "A string ID used to trace content publishes through the pipeline, e.g. 'republish_tid_JNhUrBjdXo'."
-  publishReference: String!
+  publishReference: String
 
   "An image object containing the url and the caption, to be displayed usually before the article content."
   mainImage: Image
@@ -668,7 +692,7 @@ type ContentPackage implements Content {
   teaser: Teaser
 
   "An array of concepts related to the article, eg. organisations or topics."
-  annotations: [Concept]
+  annotations(byPredicate: String): [ConceptInterface!]!
 
   "The editorial division the article belongs to, eg. 'FT-SpecialReports'."
   editorialDesk: String

package/typedefs/image.graphql

@@ -3,10 +3,10 @@ type ImageSource {
   url: String!
 
   "The width of the image source in pixels."
-  width: Int
+  width: Int!
 
   "The device pixel ratio. DPR is calculated as DPR = Physical Pixels (pixels seen on screen) / Logical Pixels (pixel that can fit in a given space)."
-  dpr: Int
+  dpr: Int!
 }
 
 interface Image {
@@ -23,7 +23,7 @@ interface Image {
   sourceSet(width: Int, maxDpr: Int): [ImageSource!]!
 
   "The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'."
-  url: String
+  url: String!
 
   "Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers."
   altText: String
@@ -55,7 +55,7 @@ type ImageStandardInline implements Image {
   sourceSet(width: Int, maxDpr: Int): [ImageSource!]!
 
   "The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'."
-  url: String
+  url: String!
 
   "Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers."
   altText: String
@@ -87,7 +87,7 @@ type ImageDesktop implements Image {
   sourceSet(width: Int, maxDpr: Int): [ImageSource!]!
 
   "The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'."
-  url: String
+  url: String!
 
   "Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers."
   altText: String
@@ -119,7 +119,7 @@ type ImageMobile implements Image {
   sourceSet(width: Int, maxDpr: Int): [ImageSource!]!
 
   "The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'."
-  url: String
+  url: String!
 
   "Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers."
   altText: String
@@ -151,7 +151,7 @@ type ImageStandard implements Image {
   sourceSet(width: Int, maxDpr: Int): [ImageSource!]!
 
   "The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'."
-  url: String
+  url: String!
 
   "Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers."
   altText: String
@@ -183,7 +183,7 @@ type ImageSquare implements Image {
   sourceSet(width: Int, maxDpr: Int): [ImageSource!]!
 
   "The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'."
-  url: String
+  url: String!
 
   "Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers."
   altText: String
@@ -215,7 +215,7 @@ type ImageWide implements Image {
   sourceSet(width: Int, maxDpr: Int): [ImageSource!]!
 
   "The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'."
-  url: String
+  url: String!
 
   "Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers."
   altText: String
@@ -247,7 +247,7 @@ type ImageSquareFTEdit implements Image {
   sourceSet(width: Int, maxDpr: Int): [ImageSource!]!
 
   "The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'."
-  url: String
+  url: String!
 
   "Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers."
   altText: String
@@ -279,7 +279,7 @@ type ImagePortrait implements Image {
   sourceSet(width: Int, maxDpr: Int): [ImageSource!]!
 
   "The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'."
-  url: String
+  url: String!
 
   "Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers."
   altText: String
@@ -311,7 +311,7 @@ type ImageLandscape implements Image {
   sourceSet(width: Int, maxDpr: Int): [ImageSource!]!
 
   "The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'."
-  url: String
+  url: String!
 
   "Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers."
   altText: String

package/typedefs/leadFlourish.graphql

@@ -0,0 +1,32 @@
+type FlourishSource {
+  "The id of the source."
+  id: String!
+
+  "The Origami image service url"
+  url: String!
+
+  "The type of the source, e.g. visualisation for leadFlourish "
+  type: String!
+
+  "The format of the source, eg. 'standard'."
+  format: ImageFormat!
+
+  "The width of the source."
+  width: Int!
+
+  "The height of the source."
+  height: Int!
+}
+
+type LeadFlourish {
+  "The type of the chart, eg. 'visualisation'."
+  type: String
+
+  "The id of the Flourish chart."
+  id: String
+
+  "The description of the Flourish chart."
+  description: String
+
+  fallbackImage: FlourishSource!
+}

package/typedefs/person.graphql

@@ -1,5 +1,5 @@
 type Person {
   prefLabel: String
   headshot(width: Int, dpr: Int): String
-  streamPage: String
-}
+  streamPage: String @deprecated(reason: "use Concept.url instead")
+}

package/typedefs/picture.graphql

@@ -1,5 +1,5 @@
-"A wrapper for images." 
-interface Picture { 
+"A wrapper for images."
+interface Picture {
   "A set of images with different sizes and formats."
   images: [Image!]!
 
@@ -13,7 +13,7 @@ interface Picture {
   credit: String
 
   "The layout width of the image, eg, 'standard'."
-  layoutWidth: String
+  layoutWidth: String!
 
   "The type of the image, eg. 'image' or 'graphic'."
   imageType: ImageType!
@@ -36,7 +36,7 @@ type PictureStandard implements Picture {
   credit: String
 
   "The layout width of the image, eg, 'standard'."
-  layoutWidth: String
+  layoutWidth: String!
 
   "The type of the image, eg. 'image' or 'graphic'."
   imageType: ImageType!
@@ -59,7 +59,7 @@ type PictureInline implements Picture {
   credit: String
 
   "The layout width of the image, eg, 'standard'."
-  layoutWidth: String
+  layoutWidth: String!
 
   "The type of the image, eg. 'image' or 'graphic'."
   imageType: ImageType!
@@ -82,7 +82,7 @@ type PictureFullBleed implements Picture {
   credit: String
 
   "The layout width of the image, eg, 'standard'."
-  layoutWidth: String
+  layoutWidth: String!
 
   "The type of the image, eg. 'image' or 'graphic'."
   imageType: ImageType!

package/typedefs/references/author.graphql

@@ -0,0 +1,7 @@
+type AuthorReference implements Reference {
+  "The type of the reference, 'author'"
+  type: String!
+
+  "The concept for this author"
+  concept: ConceptInterface
+}

package/typedefs/references/clipSet.graphql

@@ -7,18 +7,30 @@ type ClipSet implements Reference {
 
   "Whether the clip should play automatically when loaded."
   autoplay: Boolean
+    @deprecated(
+      reason: "field is redundant as already returned in content-tree"
+    )
 
   "An object containing the accessibility details of the clip."
   accessibility: Accessibility
 
   "Whether the clip should loop."
   loop: Boolean
+    @deprecated(
+      reason: "field is redundant as already returned in content-tree"
+    )
 
   "Whether the clip should be muted."
   muted: Boolean
+    @deprecated(
+      reason: "field is redundant as already returned in content-tree"
+    )
 
   "The layout of the clip set, eg. 'in-line'."
   dataLayout: String
+    @deprecated(
+      reason: "field is redundant as already returned in content-tree"
+    )
 
   "Whether the clip set should **not** include audio."
   noAudio: Boolean
@@ -36,7 +48,7 @@ type ClipSet implements Reference {
   displayTitle: String
 
   "An array of content warnings for the clip set."
-  contentWarning: [String]
+  contentWarning: [String!]
 
   "The source of the clip set, eg. 'YouTube'."
   source: String
@@ -48,5 +60,5 @@ type ClipSet implements Reference {
   publishedDate: String
 
   "An array of clips in the clip set."
-  clips: [Clip]
+  clips: [Clip!]
 }

package/typedefs/references/tweet.graphql

@@ -3,5 +3,5 @@ type Tweet implements Reference {
   type: String!
 
   "The raw HTML of the tweet."
-  html: String
+  html: String!
 }