@financial-times/cp-content-pipeline-schema 1.0.0 → 1.1.0

package/lib/model/schemas/capi/placeholder.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.placeholderSchema = void 0;
+const base_schema_1 = require("./base-schema");
+const placeholderContentSchema = base_schema_1.baseContentSchema.pick({
+    title: true,
+    standfirst: true,
+    byline: true,
+    bodyXML: true,
+    alternativeTitles: true,
+    alternativeStandfirsts: true,
+});
+const placeholderMetadataSchema = base_schema_1.baseMetadataSchema.pick({
+    id: true,
+    annotations: true,
+    webUrl: true,
+    type: true,
+    types: true,
+    standout: true,
+    publishedDate: true,
+    firstPublishedDate: true,
+    accessLevel: true,
+    canBeSyndicated: true,
+    topper: true,
+    comments: true,
+    containedIn: true,
+});
+const placeholderMediaSchema = base_schema_1.baseMediaSchema.pick({
+    mainImage: true,
+    leadImages: true,
+    embeds: true,
+});
+exports.placeholderSchema = placeholderContentSchema
+    .merge(placeholderMetadataSchema)
+    .merge(placeholderMediaSchema);
+//# sourceMappingURL=placeholder.js.map

package/lib/model/schemas/capi/placeholder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.js","sourceRoot":"","sources":["../../../../src/model/schemas/capi/placeholder.ts"],"names":[],"mappings":";;;AAAA,+CAIsB;AAEtB,MAAM,wBAAwB,GAAG,+BAAiB,CAAC,IAAI,CAAC;IACtD,KAAK,EAAE,IAAI;IACX,UAAU,EAAE,IAAI;IAChB,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,iBAAiB,EAAE,IAAI;IACvB,sBAAsB,EAAE,IAAI;CAC7B,CAAC,CAAA;AAEF,MAAM,yBAAyB,GAAG,gCAAkB,CAAC,IAAI,CAAC;IACxD,EAAE,EAAE,IAAI;IACR,WAAW,EAAE,IAAI;IACjB,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,IAAI;IACd,aAAa,EAAE,IAAI;IACnB,kBAAkB,EAAE,IAAI;IACxB,WAAW,EAAE,IAAI;IACjB,eAAe,EAAE,IAAI;IACrB,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,IAAI;CAClB,CAAC,CAAA;AAEF,MAAM,sBAAsB,GAAG,6BAAe,CAAC,IAAI,CAAC;IAClD,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,IAAI;IAChB,MAAM,EAAE,IAAI;CACb,CAAC,CAAA;AAEW,QAAA,iBAAiB,GAAG,wBAAwB;KACtD,KAAK,CAAC,yBAAyB,CAAC;KAChC,KAAK,CAAC,sBAAsB,CAAC,CAAA"}

package/lib/resolvers/content.d.ts

@@ -2,7 +2,7 @@ import { Topper } from '../model/Topper';
 import { RichText } from '../model/RichText';
 declare const resolvers: {
     Content: {
-        __resolveType: (parent: import("../model/CapiResponse").CapiResponse) => "Article" | "Video" | "Audio" | "LiveBlogPackage" | "LiveBlogPost" | "ContentPackage";
+        __resolveType: (parent: import("../model/CapiResponse").CapiResponse) => "Article" | "Placeholder" | "Video" | "Audio" | "LiveBlogPackage" | "LiveBlogPost" | "ContentPackage";
         body(parent: import("../model/CapiResponse").CapiResponse): RichText;
         topper: (parent: import("../model/CapiResponse").CapiResponse, _: {}, context: import("..").QueryContext) => Topper;
         byline(parent: import("../model/CapiResponse").CapiResponse, args: Partial<import("../generated").ContentBylineArgs>, context: import("..").QueryContext): Promise<{
@@ -13,7 +13,7 @@ declare const resolvers: {
             references: never[];
         }> | null;
         url: (parent: import("../model/CapiResponse").CapiResponse, args: Partial<import("../generated").ContentUrlArgs>) => Promise<string>;
-        type: (parent: import("../model/CapiResponse").CapiResponse) => "Article" | "Video" | "Audio" | "LiveBlogPackage" | "LiveBlogPost" | "ContentPackage" | "Content" | "MediaResource";
+        type: (parent: import("../model/CapiResponse").CapiResponse) => "Article" | "Placeholder" | "Video" | "Audio" | "LiveBlogPackage" | "LiveBlogPost" | "ContentPackage" | "Content" | "MediaResource";
         mainImage: (parent: import("../model/CapiResponse").CapiResponse) => import("../model/Image").CAPIImage | null;
         altTitle: (parent: import("../model/CapiResponse").CapiResponse) => {
             promotionalTitle: string;
@@ -34,12 +34,16 @@ declare const resolvers: {
     Article: {
         containedIn: (parent: import("../model/CapiResponse").CapiResponse) => Promise<import("../model/CapiResponse").CapiResponse | null>;
     };
+    Placeholder: {
+        containedIn: (parent: import("../model/CapiResponse").CapiResponse) => Promise<import("../model/CapiResponse").CapiResponse | null>;
+    };
     LiveBlogPackage: {
         liveBlogPosts: (parent: import("../model/CapiResponse").CapiResponse) => Promise<[] | import("../model/CapiResponse").CapiResponse[]>;
         realtime: (parent: import("../model/CapiResponse").CapiResponse) => boolean | null;
     };
     ContentPackage: {
-        contains: (parent: import("../model/CapiResponse").CapiResponse) => Promise<import("../model/CapiResponse").CapiResponse[] | null>;
+        contains: (parent: import("../model/CapiResponse").CapiResponse, args: Partial<import("../generated").ContentPackageContainsArgs>) => Promise<import("../model/CapiResponse").CapiResponse[] | null>;
+        containsLength: (parent: import("../model/CapiResponse").CapiResponse) => number | null;
     };
     Audio: {
         media: (parent: import("../model/CapiResponse").CapiResponse) => import("../generated").Media[] | null;

package/lib/resolvers/content.js

@@ -8,7 +8,7 @@ const resolvers = {
         __resolveType: (parent) => {
             const type = parent.type();
             if (type === 'Content') {
-                return 'Article';
+                return parent.isPlaceholder() ? 'Placeholder' : 'Article';
             }
             if (type === 'MediaResource') {
                 return 'Video';
@@ -44,12 +44,16 @@ const resolvers = {
     Article: {
         containedIn: (parent) => parent.containedIn(),
     },
+    Placeholder: {
+        containedIn: (parent) => parent.containedIn(),
+    },
     LiveBlogPackage: {
         liveBlogPosts: (parent) => parent.liveBlogPosts(),
         realtime: (parent) => parent.realtime(),
     },
     ContentPackage: {
-        contains: (parent) => parent.contains(),
+        contains: (parent, args) => parent.contains(args),
+        containsLength: (parent) => parent.containsLength(),
     },
     Audio: {
         media: (parent) => 

package/lib/resolvers/content.js.map

@@ -1 +1 @@
-{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/resolvers/content.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/resolvers/content.ts"],"names":[],"mappings":"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"}

package/lib/resolvers/index.d.ts

@@ -65,7 +65,7 @@ declare const resolvers: {
     CanBeSyndicated: import("./literal-union").LiteralUnionScalar<["yes", "no", "verify", "withContributorPayment", "unknown"]>;
     ImageType: import("./literal-union").LiteralUnionScalar<["image", "graphic"]>;
     RichTextSource: import("./literal-union").LiteralUnionScalar<["standfirst", "summary", "bodyXML"]>;
-    ContentType: import("./literal-union").LiteralUnionScalar<["Article", "Video", "Audio", "LiveBlogPackage", "LiveBlogPost", "ContentPackage", "Content", "MediaResource"]>;
+    ContentType: import("./literal-union").LiteralUnionScalar<["Article", "Placeholder", "Video", "Audio", "LiveBlogPackage", "LiveBlogPost", "ContentPackage", "Content", "MediaResource"]>;
     RichText: {
         raw(parent: import("../model/RichText").RichText): string | null;
         structured(parent: import("../model/RichText").RichText, args: {}, context: import("..").QueryContext): Promise<{
@@ -106,7 +106,7 @@ declare const resolvers: {
         invalidateRedisCache: (_: {}, args: import("../generated").RequireFields<import("../generated").MutationInvalidateRedisCacheArgs, "uuid">, context: import("..").QueryContext) => Promise<string>;
     };
     Content: {
-        __resolveType: (parent: import("../model/CapiResponse").CapiResponse) => "Article" | "Video" | "Audio" | "LiveBlogPackage" | "LiveBlogPost" | "ContentPackage";
+        __resolveType: (parent: import("../model/CapiResponse").CapiResponse) => "Article" | "Placeholder" | "Video" | "Audio" | "LiveBlogPackage" | "LiveBlogPost" | "ContentPackage";
         body(parent: import("../model/CapiResponse").CapiResponse): import("../model/RichText").RichText;
         topper: (parent: import("../model/CapiResponse").CapiResponse, _: {}, context: import("..").QueryContext) => import("../model/Topper").Topper;
         byline(parent: import("../model/CapiResponse").CapiResponse, args: Partial<import("../generated").ContentBylineArgs>, context: import("..").QueryContext): Promise<{
@@ -117,7 +117,7 @@ declare const resolvers: {
             references: never[];
         }> | null;
         url: (parent: import("../model/CapiResponse").CapiResponse, args: Partial<import("../generated").ContentUrlArgs>) => Promise<string>;
-        type: (parent: import("../model/CapiResponse").CapiResponse) => "Article" | "Video" | "Audio" | "LiveBlogPackage" | "LiveBlogPost" | "ContentPackage" | "Content" | "MediaResource";
+        type: (parent: import("../model/CapiResponse").CapiResponse) => "Article" | "Placeholder" | "Video" | "Audio" | "LiveBlogPackage" | "LiveBlogPost" | "ContentPackage" | "Content" | "MediaResource";
         mainImage: (parent: import("../model/CapiResponse").CapiResponse) => import("../model/Image").CAPIImage | null;
         altTitle: (parent: import("../model/CapiResponse").CapiResponse) => {
             promotionalTitle: string;
@@ -138,12 +138,16 @@ declare const resolvers: {
     Article: {
         containedIn: (parent: import("../model/CapiResponse").CapiResponse) => Promise<import("../model/CapiResponse").CapiResponse | null>;
     };
+    Placeholder: {
+        containedIn: (parent: import("../model/CapiResponse").CapiResponse) => Promise<import("../model/CapiResponse").CapiResponse | null>;
+    };
     LiveBlogPackage: {
         liveBlogPosts: (parent: import("../model/CapiResponse").CapiResponse) => Promise<[] | import("../model/CapiResponse").CapiResponse[]>;
         realtime: (parent: import("../model/CapiResponse").CapiResponse) => boolean | null;
     };
     ContentPackage: {
-        contains: (parent: import("../model/CapiResponse").CapiResponse) => Promise<import("../model/CapiResponse").CapiResponse[] | null>;
+        contains: (parent: import("../model/CapiResponse").CapiResponse, args: Partial<import("../generated").ContentPackageContainsArgs>) => Promise<import("../model/CapiResponse").CapiResponse[] | null>;
+        containsLength: (parent: import("../model/CapiResponse").CapiResponse) => number | null;
     };
     Audio: {
         media: (parent: import("../model/CapiResponse").CapiResponse) => import("../generated").Media[] | null;

package/lib/resolvers/scalars.d.ts

@@ -7,7 +7,7 @@ export declare const AccessLevel: LiteralUnionScalar<["premium", "subscribed", "
 export declare const CanBeSyndicated: LiteralUnionScalar<["yes", "no", "verify", "withContributorPayment", "unknown"]>;
 export declare const ImageType: LiteralUnionScalar<["image", "graphic"]>;
 export declare const RichTextSource: LiteralUnionScalar<["standfirst", "summary", "bodyXML"]>;
-export declare const ContentType: LiteralUnionScalar<["Article", "Video", "Audio", "LiveBlogPackage", "LiveBlogPost", "ContentPackage", "Content", "MediaResource"]>;
+export declare const ContentType: LiteralUnionScalar<["Article", "Placeholder", "Video", "Audio", "LiveBlogPackage", "LiveBlogPost", "ContentPackage", "Content", "MediaResource"]>;
 declare const resolvers: {
     ImageFormat: LiteralUnionScalar<["standard", "standard-inline", "desktop", "mobile", "wide", "square", "square-ftedit", "portrait", "landscape"]>;
     PackageDesign: LiteralUnionScalar<["special-report", "extra", "basic"]>;
@@ -17,6 +17,6 @@ declare const resolvers: {
     CanBeSyndicated: LiteralUnionScalar<["yes", "no", "verify", "withContributorPayment", "unknown"]>;
     ImageType: LiteralUnionScalar<["image", "graphic"]>;
     RichTextSource: LiteralUnionScalar<["standfirst", "summary", "bodyXML"]>;
-    ContentType: LiteralUnionScalar<["Article", "Video", "Audio", "LiveBlogPackage", "LiveBlogPost", "ContentPackage", "Content", "MediaResource"]>;
+    ContentType: LiteralUnionScalar<["Article", "Placeholder", "Video", "Audio", "LiveBlogPackage", "LiveBlogPost", "ContentPackage", "Content", "MediaResource"]>;
 };
 export default resolvers;

package/lib/resolvers/scalars.js

@@ -63,6 +63,7 @@ exports.ContentType = new literal_union_1.LiteralUnionScalar({
     name: 'ContentType',
     values: [
         'Article',
+        'Placeholder',
         'Video',
         'Audio',
         'LiveBlogPackage',

package/lib/resolvers/scalars.js.map

@@ -1 +1 @@
-{"version":3,"file":"scalars.js","sourceRoot":"","sources":["../../src/resolvers/scalars.ts"],"names":[],"mappings":";;;AAAA,mDAAoD;AAEvC,QAAA,WAAW,GAAG,IAAI,kCAAkB,CAY/C;IACA,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE;QACN,UAAU;QACV,iBAAiB;QACjB,SAAS;QACT,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,eAAe;QACf,UAAU;QACV,WAAW;KACZ;CACF,CAAC,CAAA;AAEW,QAAA,aAAa,GAAG,IAAI,kCAAkB,CAEjD,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,gBAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;AAE7D,QAAA,sBAAsB,GAAG,IAAI,kCAAkB,CAa1D;IACA,IAAI,EAAE,wBAAwB;IAC9B,MAAM,EAAE;QACN,OAAO;QACP,OAAO;QACP,OAAO;QACP,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,SAAS;QACT,KAAK;QACL,SAAS;KACV;CACF,CAAC,CAAA;AAEW,QAAA,mBAAmB,GAAG,IAAI,kCAAkB,CASvD;IACA,IAAI,EAAE,qBAAqB;IAC3B,MAAM,EAAE;QACN,UAAU;QACV,SAAS;QACT,SAAS;QACT,YAAY;QACZ,YAAY;QACZ,oBAAoB;KACrB;CACF,CAAC,CAAA;AAEW,QAAA,WAAW,GAAG,IAAI,kCAAkB,CAE/C;IACA,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC;CACxD,CAAC,CAAA;AAEW,QAAA,eAAe,GAAG,IAAI,kCAAkB,CAEnD;IACA,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,wBAAwB,EAAE,SAAS,CAAC;CACrE,CAAC,CAAA;AAEW,QAAA,SAAS,GAAG,IAAI,kCAAkB,CAAuB;IACpE,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;CAC7B,CAAC,CAAA;AAEW,QAAA,cAAc,GAAG,IAAI,kCAAkB,CAElD;IACA,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,CAAC;CAC7C,CAAC,CAAA;AAEW,QAAA,WAAW,GAAG,IAAI,kCAAkB,CAW/C;IACA,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE;QACN,SAAS;QACT,OAAO;QACP,OAAO;QACP,iBAAiB;QACjB,cAAc;QACd,gBAAgB;QAChB,SAAS;QACT,eAAe;KAChB;CACF,CAAC,CAAA;AAEF,MAAM,SAAS,GAAG;IAChB,WAAW,EAAX,mBAAW;IACX,aAAa,EAAb,qBAAa;IACb,sBAAsB,EAAtB,8BAAsB;IACtB,mBAAmB,EAAnB,2BAAmB;IACnB,WAAW,EAAX,mBAAW;IACX,eAAe,EAAf,uBAAe;IACf,SAAS,EAAT,iBAAS;IACT,cAAc,EAAd,sBAAc;IACd,WAAW,EAAX,mBAAW;CACZ,CAAA;AAED,kBAAe,SAAS,CAAA"}
+{"version":3,"file":"scalars.js","sourceRoot":"","sources":["../../src/resolvers/scalars.ts"],"names":[],"mappings":";;;AAAA,mDAAoD;AAEvC,QAAA,WAAW,GAAG,IAAI,kCAAkB,CAY/C;IACA,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE;QACN,UAAU;QACV,iBAAiB;QACjB,SAAS;QACT,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,eAAe;QACf,UAAU;QACV,WAAW;KACZ;CACF,CAAC,CAAA;AAEW,QAAA,aAAa,GAAG,IAAI,kCAAkB,CAEjD,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC,gBAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;AAE7D,QAAA,sBAAsB,GAAG,IAAI,kCAAkB,CAa1D;IACA,IAAI,EAAE,wBAAwB;IAC9B,MAAM,EAAE;QACN,OAAO;QACP,OAAO;QACP,OAAO;QACP,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,SAAS;QACT,KAAK;QACL,SAAS;KACV;CACF,CAAC,CAAA;AAEW,QAAA,mBAAmB,GAAG,IAAI,kCAAkB,CASvD;IACA,IAAI,EAAE,qBAAqB;IAC3B,MAAM,EAAE;QACN,UAAU;QACV,SAAS;QACT,SAAS;QACT,YAAY;QACZ,YAAY;QACZ,oBAAoB;KACrB;CACF,CAAC,CAAA;AAEW,QAAA,WAAW,GAAG,IAAI,kCAAkB,CAE/C;IACA,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC;CACxD,CAAC,CAAA;AAEW,QAAA,eAAe,GAAG,IAAI,kCAAkB,CAEnD;IACA,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,wBAAwB,EAAE,SAAS,CAAC;CACrE,CAAC,CAAA;AAEW,QAAA,SAAS,GAAG,IAAI,kCAAkB,CAAuB;IACpE,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;CAC7B,CAAC,CAAA;AAEW,QAAA,cAAc,GAAG,IAAI,kCAAkB,CAElD;IACA,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,CAAC;CAC7C,CAAC,CAAA;AAEW,QAAA,WAAW,GAAG,IAAI,kCAAkB,CAY/C;IACA,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE;QACN,SAAS;QACT,aAAa;QACb,OAAO;QACP,OAAO;QACP,iBAAiB;QACjB,cAAc;QACd,gBAAgB;QAChB,SAAS;QACT,eAAe;KAChB;CACF,CAAC,CAAA;AAEF,MAAM,SAAS,GAAG;IAChB,WAAW,EAAX,mBAAW;IACX,aAAa,EAAb,qBAAa;IACb,sBAAsB,EAAtB,8BAAsB;IACtB,mBAAmB,EAAnB,2BAAmB;IACnB,WAAW,EAAX,mBAAW;IACX,eAAe,EAAf,uBAAe;IACf,SAAS,EAAT,iBAAS;IACT,cAAc,EAAd,sBAAc;IACd,WAAW,EAAX,mBAAW;CACZ,CAAA;AAED,kBAAe,SAAS,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@financial-times/cp-content-pipeline-schema",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "",
   "main": "lib/index.js",
   "scripts": {

package/src/generated/index.ts

@@ -27,7 +27,7 @@ export type Scalars = {
   Float: { input: number; output: number; }
   AccessLevel: { input: 'premium' | 'subscribed' | 'registered' | 'free'; output: 'premium' | 'subscribed' | 'registered' | 'free'; }
   CanBeSyndicated: { input: 'yes' | 'no' | 'verify' | 'withContributorPayment' | 'unknown'; output: 'yes' | 'no' | 'verify' | 'withContributorPayment' | 'unknown'; }
-  ContentType: { input: 'Article' | 'Video' | 'Audio' | 'LiveBlogPackage' | 'LiveBlogPost' | 'ContentPackage' | 'Content' | 'MediaResource'; output: 'Article' | 'Video' | 'Audio' | 'LiveBlogPackage' | 'LiveBlogPost' | 'ContentPackage' | 'Content' | 'MediaResource'; }
+  ContentType: { input: 'Article' | 'Placeholder' | 'Video' | 'Audio' | 'LiveBlogPackage' | 'LiveBlogPost' | 'ContentPackage' | 'Content' | 'MediaResource'; output: 'Article' | 'Placeholder' | 'Video' | 'Audio' | 'LiveBlogPackage' | 'LiveBlogPost' | 'ContentPackage' | 'Content' | 'MediaResource'; }
   FollowButtonVariant: { input: 'standard' | 'inverse' | 'opinion' | 'alphaville' | 'monochrome' | 'inverse-monochrome'; output: 'standard' | 'inverse' | 'opinion' | 'alphaville' | 'monochrome' | 'inverse-monochrome'; }
   ImageFormat: { input: 'standard' | 'standard-inline' | 'desktop' | 'mobile' | 'wide' | 'square' | 'square-ftedit' | 'portrait' | 'landscape'; output: 'standard' | 'standard-inline' | 'desktop' | 'mobile' | 'wide' | 'square' | 'square-ftedit' | 'portrait' | 'landscape'; }
   ImageType: { input: 'image' | 'graphic'; output: 'image' | 'graphic'; }
@@ -202,6 +202,7 @@ export type ContentPackage = Content & {
   readonly canBeSyndicated?: Maybe<Scalars['CanBeSyndicated']['output']>;
   readonly commentsEnabled?: Maybe<Scalars['Boolean']['output']>;
   readonly contains?: Maybe<ReadonlyArray<Maybe<Teaser>>>;
+  readonly containsLength?: Maybe<Scalars['Int']['output']>;
   readonly design?: Maybe<Design>;
   readonly firstPublishedDate: Scalars['String']['output'];
   readonly id: Scalars['String']['output'];
@@ -222,6 +223,12 @@ export type ContentPackageBylineArgs = {
 };
 
 
+export type ContentPackageContainsArgs = {
+  fromId?: InputMaybe<Scalars['String']['input']>;
+  surroundingArticles?: InputMaybe<Scalars['Int']['input']>;
+};
+
+
 export type ContentPackageUrlArgs = {
   relative?: InputMaybe<Scalars['Boolean']['input']>;
   vanity?: InputMaybe<Scalars['Boolean']['input']>;
@@ -658,6 +665,41 @@ export type PictureStandard = Picture & {
   readonly layoutWidth?: Maybe<Scalars['String']['output']>;
 };
 
+export type Placeholder = Content & {
+  readonly accessLevel?: Maybe<Scalars['AccessLevel']['output']>;
+  readonly altStandfirst?: Maybe<AltStandfirst>;
+  readonly altTitle?: Maybe<AltTitle>;
+  readonly annotations?: Maybe<ReadonlyArray<Maybe<Concept>>>;
+  readonly body?: Maybe<RichText>;
+  readonly bodyXML?: Maybe<Scalars['String']['output']>;
+  readonly byline?: Maybe<StructuredContent>;
+  readonly canBeSyndicated?: Maybe<Scalars['CanBeSyndicated']['output']>;
+  readonly commentsEnabled?: Maybe<Scalars['Boolean']['output']>;
+  readonly containedIn?: Maybe<Content>;
+  readonly design?: Maybe<Design>;
+  readonly firstPublishedDate: Scalars['String']['output'];
+  readonly id: Scalars['String']['output'];
+  readonly mainImage?: Maybe<Image>;
+  readonly publishedDate: Scalars['String']['output'];
+  readonly standfirst?: Maybe<Scalars['String']['output']>;
+  readonly teaser?: Maybe<Teaser>;
+  readonly title: Scalars['String']['output'];
+  readonly topper?: Maybe<Topper>;
+  readonly type: Scalars['ContentType']['output'];
+  readonly url: Scalars['String']['output'];
+};
+
+
+export type PlaceholderBylineArgs = {
+  vanity?: InputMaybe<Scalars['Boolean']['input']>;
+};
+
+
+export type PlaceholderUrlArgs = {
+  relative?: InputMaybe<Scalars['Boolean']['input']>;
+  vanity?: InputMaybe<Scalars['Boolean']['input']>;
+};
+
 export type PodcastTopper = Topper & TopperWithBrand & TopperWithHeadshot & TopperWithTheme & {
   readonly backgroundBox?: Maybe<Scalars['Boolean']['output']>;
   readonly backgroundColour?: Maybe<Scalars['TopperBackgroundColour']['output']>;
@@ -926,7 +968,7 @@ export type DirectiveResolverFn<TResult = {}, TParent = {}, TContext = {}, TArgs
 
 /** Mapping of interface types */
 export type ResolversInterfaceTypes<RefType extends Record<string, unknown>> = ResolversObject<{
-  Content: ( CapiResponse ) | ( CapiResponse ) | ( CapiResponse ) | ( CapiResponse ) | ( CapiResponse ) | ( CapiResponse );
+  Content: ( CapiResponse ) | ( CapiResponse ) | ( CapiResponse ) | ( CapiResponse ) | ( CapiResponse ) | ( CapiResponse ) | ( CapiResponse );
   Image: ( ImageDesktop ) | ( ImageLandscape ) | ( ImageMobile ) | ( ImagePortrait ) | ( ImageSquare ) | ( ImageSquareFtEdit ) | ( ImageStandard ) | ( ImageStandardInline ) | ( ImageWide );
   Picture: ( Omit<PictureFullBleed, 'fallbackImage' | 'images'> & { fallbackImage: RefType['Image'], images: ReadonlyArray<RefType['Image']> } ) | ( Omit<PictureInline, 'fallbackImage' | 'images'> & { fallbackImage: RefType['Image'], images: ReadonlyArray<RefType['Image']> } ) | ( Omit<PictureStandard, 'fallbackImage' | 'images'> & { fallbackImage: RefType['Image'], images: ReadonlyArray<RefType['Image']> } );
   Reference: ( ReferenceWithCAPIData<ContentTree.Flourish> ) | ( ReferenceWithCAPIData<ContentTree.ImageSet> ) | ( ReferenceWithCAPIData<ContentTree.LayoutImage> ) | ( ReferenceWithCAPIData<ContentTree.ImageSet> ) | ( ReferenceWithCAPIData<RawImageNode> ) | ( ReferenceWithCAPIData<ContentTree.Recommended> ) | ( ReferenceWithCAPIData<ContentTree.ScrollyImage> ) | ( ReferenceWithCAPIData<ContentTree.Tweet> ) | ( ReferenceWithCAPIData<VideoNode> );
@@ -990,6 +1032,7 @@ export type ResolversTypes = ResolversObject<{
   PictureFullBleed: ResolverTypeWrapper<Omit<PictureFullBleed, 'fallbackImage' | 'images'> & { fallbackImage: ResolversTypes['Image'], images: ReadonlyArray<ResolversTypes['Image']> }>;
   PictureInline: ResolverTypeWrapper<Omit<PictureInline, 'fallbackImage' | 'images'> & { fallbackImage: ResolversTypes['Image'], images: ReadonlyArray<ResolversTypes['Image']> }>;
   PictureStandard: ResolverTypeWrapper<Omit<PictureStandard, 'fallbackImage' | 'images'> & { fallbackImage: ResolversTypes['Image'], images: ReadonlyArray<ResolversTypes['Image']> }>;
+  Placeholder: ResolverTypeWrapper<CapiResponse>;
   PodcastTopper: ResolverTypeWrapper<TopperModel>;
   Query: ResolverTypeWrapper<{}>;
   RawImage: ResolverTypeWrapper<ReferenceWithCAPIData<RawImageNode>>;
@@ -1067,6 +1110,7 @@ export type ResolversParentTypes = ResolversObject<{
   PictureFullBleed: Omit<PictureFullBleed, 'fallbackImage' | 'images'> & { fallbackImage: ResolversParentTypes['Image'], images: ReadonlyArray<ResolversParentTypes['Image']> };
   PictureInline: Omit<PictureInline, 'fallbackImage' | 'images'> & { fallbackImage: ResolversParentTypes['Image'], images: ReadonlyArray<ResolversParentTypes['Image']> };
   PictureStandard: Omit<PictureStandard, 'fallbackImage' | 'images'> & { fallbackImage: ResolversParentTypes['Image'], images: ReadonlyArray<ResolversParentTypes['Image']> };
+  Placeholder: CapiResponse;
   PodcastTopper: TopperModel;
   Query: {};
   RawImage: ReferenceWithCAPIData<RawImageNode>;
@@ -1200,7 +1244,7 @@ export type ConceptResolvers<ContextType = QueryContext, ParentType extends Reso
 }>;
 
 export type ContentResolvers<ContextType = QueryContext, ParentType extends ResolversParentTypes['Content'] = ResolversParentTypes['Content']> = ResolversObject<{
-  __resolveType?: TypeResolveFn<'Article' | 'Audio' | 'ContentPackage' | 'LiveBlogPackage' | 'LiveBlogPost' | 'Video', ParentType, ContextType>;
+  __resolveType?: TypeResolveFn<'Article' | 'Audio' | 'ContentPackage' | 'LiveBlogPackage' | 'LiveBlogPost' | 'Placeholder' | 'Video', ParentType, ContextType>;
   accessLevel?: Resolver<Maybe<ResolversTypes['AccessLevel']>, ParentType, ContextType>;
   altStandfirst?: Resolver<Maybe<ResolversTypes['AltStandfirst']>, ParentType, ContextType>;
   altTitle?: Resolver<Maybe<ResolversTypes['AltTitle']>, ParentType, ContextType>;
@@ -1233,7 +1277,8 @@ export type ContentPackageResolvers<ContextType = QueryContext, ParentType exten
   byline?: Resolver<Maybe<ResolversTypes['StructuredContent']>, ParentType, ContextType, Partial<ContentPackageBylineArgs>>;
   canBeSyndicated?: Resolver<Maybe<ResolversTypes['CanBeSyndicated']>, ParentType, ContextType>;
   commentsEnabled?: Resolver<Maybe<ResolversTypes['Boolean']>, ParentType, ContextType>;
-  contains?: Resolver<Maybe<ReadonlyArray<Maybe<ResolversTypes['Teaser']>>>, ParentType, ContextType>;
+  contains?: Resolver<Maybe<ReadonlyArray<Maybe<ResolversTypes['Teaser']>>>, ParentType, ContextType, Partial<ContentPackageContainsArgs>>;
+  containsLength?: Resolver<Maybe<ResolversTypes['Int']>, ParentType, ContextType>;
   design?: Resolver<Maybe<ResolversTypes['Design']>, ParentType, ContextType>;
   firstPublishedDate?: Resolver<ResolversTypes['String'], ParentType, ContextType>;
   id?: Resolver<ResolversTypes['String'], ParentType, ContextType>;
@@ -1640,6 +1685,31 @@ export type PictureStandardResolvers<ContextType = QueryContext, ParentType exte
   __isTypeOf?: IsTypeOfResolverFn<ParentType, ContextType>;
 }>;
 
+export type PlaceholderResolvers<ContextType = QueryContext, ParentType extends ResolversParentTypes['Placeholder'] = ResolversParentTypes['Placeholder']> = ResolversObject<{
+  accessLevel?: Resolver<Maybe<ResolversTypes['AccessLevel']>, ParentType, ContextType>;
+  altStandfirst?: Resolver<Maybe<ResolversTypes['AltStandfirst']>, ParentType, ContextType>;
+  altTitle?: Resolver<Maybe<ResolversTypes['AltTitle']>, ParentType, ContextType>;
+  annotations?: Resolver<Maybe<ReadonlyArray<Maybe<ResolversTypes['Concept']>>>, ParentType, ContextType>;
+  body?: Resolver<Maybe<ResolversTypes['RichText']>, ParentType, ContextType>;
+  bodyXML?: Resolver<Maybe<ResolversTypes['String']>, ParentType, ContextType>;
+  byline?: Resolver<Maybe<ResolversTypes['StructuredContent']>, ParentType, ContextType, Partial<PlaceholderBylineArgs>>;
+  canBeSyndicated?: Resolver<Maybe<ResolversTypes['CanBeSyndicated']>, ParentType, ContextType>;
+  commentsEnabled?: Resolver<Maybe<ResolversTypes['Boolean']>, ParentType, ContextType>;
+  containedIn?: Resolver<Maybe<ResolversTypes['Content']>, ParentType, ContextType>;
+  design?: Resolver<Maybe<ResolversTypes['Design']>, ParentType, ContextType>;
+  firstPublishedDate?: Resolver<ResolversTypes['String'], ParentType, ContextType>;
+  id?: Resolver<ResolversTypes['String'], ParentType, ContextType>;
+  mainImage?: Resolver<Maybe<ResolversTypes['Image']>, ParentType, ContextType>;
+  publishedDate?: Resolver<ResolversTypes['String'], ParentType, ContextType>;
+  standfirst?: Resolver<Maybe<ResolversTypes['String']>, ParentType, ContextType>;
+  teaser?: Resolver<Maybe<ResolversTypes['Teaser']>, ParentType, ContextType>;
+  title?: Resolver<ResolversTypes['String'], ParentType, ContextType>;
+  topper?: Resolver<Maybe<ResolversTypes['Topper']>, ParentType, ContextType>;
+  type?: Resolver<ResolversTypes['ContentType'], ParentType, ContextType>;
+  url?: Resolver<ResolversTypes['String'], ParentType, ContextType, Partial<PlaceholderUrlArgs>>;
+  __isTypeOf?: IsTypeOfResolverFn<ParentType, ContextType>;
+}>;
+
 export type PodcastTopperResolvers<ContextType = QueryContext, ParentType extends ResolversParentTypes['PodcastTopper'] = ResolversParentTypes['PodcastTopper']> = ResolversObject<{
   backgroundBox?: Resolver<Maybe<ResolversTypes['Boolean']>, ParentType, ContextType>;
   backgroundColour?: Resolver<Maybe<ResolversTypes['TopperBackgroundColour']>, ParentType, ContextType>;
@@ -1874,6 +1944,7 @@ export type Resolvers<ContextType = QueryContext> = ResolversObject<{
   PictureFullBleed?: PictureFullBleedResolvers<ContextType>;
   PictureInline?: PictureInlineResolvers<ContextType>;
   PictureStandard?: PictureStandardResolvers<ContextType>;
+  Placeholder?: PlaceholderResolvers<ContextType>;
   PodcastTopper?: PodcastTopperResolvers<ContextType>;
   Query?: QueryResolvers<ContextType>;
   RawImage?: RawImageResolvers<ContextType>;

package/src/model/CapiResponse.ts

@@ -29,7 +29,7 @@ import {
   validLiteralUnionValue,
 } from '../resolvers/literal-union'
 
-import { Media } from '../generated'
+import { ContentPackageContainsArgs, Media } from '../generated'
 
 type Design = {
   theme: LiteralUnionScalarValues<typeof PackageDesign>
@@ -257,7 +257,7 @@ export class CapiResponse {
     return this.capiData.publishedDate
   }
   firstPublishedDate() {
-    return this.capiData.firstPublishedDate
+    return this.capiData.firstPublishedDate || this.capiData.publishedDate
   }
   alternativeTitle() {
     return this.capiData.alternativeTitles ?? null
@@ -461,16 +461,42 @@ export class CapiResponse {
     return this.getBrandConcept()?.uuid() === conceptIds.brand.alphaville
   }
 
+  isPlaceholder() {
+    const isArticle = this.capiData.types.includes(
+      'http://www.ft.com/ontology/content/Article'
+    )
+    const isContent = this.capiData.types.includes(
+      'http://www.ft.com/ontology/content/Content'
+    )
+
+    return !isArticle && isContent
+  }
+
   isPodcast() {
     return this.capiData.types.includes(
       'http://www.ft.com/ontology/content/Audio'
     )
   }
 
-  async contains(): Promise<CapiResponse[] | null> {
+  async contains({
+    surroundingArticles,
+    fromId,
+  }: Partial<ContentPackageContainsArgs> = {}): Promise<CapiResponse[] | null> {
     if ('contains' in this.capiData) {
+      const fromIndex = this.capiData.contains.findIndex(
+        (contains) => contains.id === `http://api.ft.com/things/${fromId}`
+      )
+
+      const contains =
+        fromId && surroundingArticles
+          ? this.capiData.contains.slice(
+              Math.max(0, fromIndex - surroundingArticles),
+              fromIndex + surroundingArticles
+            )
+          : this.capiData.contains
+
       return Promise.all(
-        this.capiData.contains.map(({ id }) =>
+        contains.map(({ id }) =>
           this.context.dataSources.capi.getContent(uuidFromUrl(id), this)
         )
       )
@@ -479,6 +505,14 @@ export class CapiResponse {
     return null
   }
 
+  containsLength() {
+    if ('contains' in this.capiData) {
+      return this.capiData.contains.length
+    }
+
+    return null
+  }
+
   async tableOfContents() {
     return 'tableOfContents' in this.capiData
       ? this.capiData.tableOfContents

package/src/model/schemas/capi/index.ts

@@ -1,4 +1,5 @@
 import { articleSchema } from './article'
+import { placeholderSchema } from './placeholder'
 import { liveBlogPackageSchema } from './live-blog-package'
 import { contentPackageSchema } from './content-package'
 import { audioSchema } from './audio'
@@ -10,6 +11,8 @@ export const schemas = (
   contentType: LiteralUnionScalarValues<typeof ContentType>
 ) => {
   switch (contentType) {
+    case 'Placeholder':
+      return placeholderSchema
     case 'Article':
       return articleSchema
     case 'LiveBlogPackage':

package/src/model/schemas/capi/placeholder.ts

@@ -0,0 +1,40 @@
+import {
+  baseContentSchema,
+  baseMetadataSchema,
+  baseMediaSchema,
+} from './base-schema'
+
+const placeholderContentSchema = baseContentSchema.pick({
+  title: true,
+  standfirst: true,
+  byline: true,
+  bodyXML: true,
+  alternativeTitles: true,
+  alternativeStandfirsts: true,
+})
+
+const placeholderMetadataSchema = baseMetadataSchema.pick({
+  id: true,
+  annotations: true,
+  webUrl: true,
+  type: true,
+  types: true,
+  standout: true,
+  publishedDate: true,
+  firstPublishedDate: true,
+  accessLevel: true,
+  canBeSyndicated: true,
+  topper: true,
+  comments: true,
+  containedIn: true,
+})
+
+const placeholderMediaSchema = baseMediaSchema.pick({
+  mainImage: true,
+  leadImages: true,
+  embeds: true,
+})
+
+export const placeholderSchema = placeholderContentSchema
+  .merge(placeholderMetadataSchema)
+  .merge(placeholderMediaSchema)

package/src/resolvers/content.ts

@@ -2,6 +2,7 @@ import { Topper } from '../model/Topper'
 import { Byline } from '../model/Byline'
 import {
   ArticleResolvers,
+  PlaceholderResolvers,
   AudioResolvers,
   ContentPackageResolvers,
   ContentResolvers,
@@ -13,8 +14,9 @@ const resolvers = {
   Content: {
     __resolveType: (parent) => {
       const type = parent.type()
+
       if (type === 'Content') {
-        return 'Article'
+        return parent.isPlaceholder() ? 'Placeholder' : 'Article'
       }
 
       if (type === 'MediaResource') {
@@ -61,13 +63,18 @@ const resolvers = {
     containedIn: (parent) => parent.containedIn(),
   },
 
+  Placeholder: {
+    containedIn: (parent) => parent.containedIn(),
+  },
+
   LiveBlogPackage: {
     liveBlogPosts: (parent) => parent.liveBlogPosts(),
     realtime: (parent) => parent.realtime(),
   },
 
   ContentPackage: {
-    contains: (parent) => parent.contains(),
+    contains: (parent, args) => parent.contains(args),
+    containsLength: (parent) => parent.containsLength(),
   },
 
   Audio: {
@@ -78,6 +85,7 @@ const resolvers = {
   },
 } satisfies {
   Article: ArticleResolvers
+  Placeholder: PlaceholderResolvers
   Content: ContentResolvers
   LiveBlogPackage: LiveBlogPackageResolvers
   ContentPackage: ContentPackageResolvers

package/src/resolvers/scalars.ts

@@ -110,6 +110,7 @@ export const RichTextSource = new LiteralUnionScalar<
 export const ContentType = new LiteralUnionScalar<
   [
     'Article',
+    'Placeholder',
     'Video',
     'Audio',
     'LiveBlogPackage',
@@ -122,6 +123,7 @@ export const ContentType = new LiteralUnionScalar<
   name: 'ContentType',
   values: [
     'Article',
+    'Placeholder',
     'Video',
     'Audio',
     'LiveBlogPackage',

package/src/types/internal-content.d.ts

@@ -13,6 +13,7 @@ import {
 } from '../model/schemas/capi/base-schema'
 
 import { articleSchema } from '../model/schemas/capi/article'
+import { placeholderSchema } from '../model/schemas/capi/placeholder'
 
 import { liveBlogPackageSchema } from '../model/schemas/capi/live-blog-package'
 import { audioSchema } from '../model/schemas/capi/audio'
@@ -21,6 +22,7 @@ import { videoSchema } from '../model/schemas/capi/video'
 import { contentPackageSchema } from '../model/schemas/capi/content-package'
 
 type Article = z.infer<typeof articleSchema>
+type Placeholder = z.infer<typeof placeholderSchema>
 type LiveBlogPackage = z.infer<typeof liveBlogPackageSchema>
 type ContentPackage = z.infer<typeof contentPackageSchema>
 type Audio = z.infer<typeof audioSchema>
@@ -38,4 +40,9 @@ type LeadImage = z.infer<typeof LeadImage>
 type ImageSet = z.infer<typeof ImageSet>
 type MainImage = z.infer<typeof MainImage>
 
-type ContentTypeSchemas = Article | LiveBlogPackage | ContentPackage | Audio
+type ContentTypeSchemas =
+  | Article
+  | Placeholder
+  | LiveBlogPackage
+  | ContentPackage
+  | Audio