@vepler/sdk 2.154.1 → 2.158.0

package/src/sdk/models/operations/queryschoolsbysource.ts

@@ -12,7 +12,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 import * as shared from "../shared/index.js";
 
 /**
- * Fields/blocks to return per school. Default (omitted): the full flat record, no blocks. Aggregate blocks (`inspections`, `identifiers`, `trust`) are additive — requesting only block names keeps the full flat record and adds the blocks. List scalar field names to trim.
+ * Fields/blocks to return per school. Default (omitted): the full flat record, no blocks. Aggregate blocks (`inspections`, `identifiers`, `trust`, `images`, `branding`, `accreditations`, `videos`, `about`) are additive — requesting only block names keeps the full flat record and adds the blocks. List scalar field names to trim.
  */
 export type Attributes = string | Array<string>;
 
@@ -36,7 +36,7 @@ export type Provider = ClosedEnum<typeof Provider>;
  */
 export type QuerySchoolsBySourceRequestBody = {
   /**
-   * Fields/blocks to return per school. Default (omitted): the full flat record, no blocks. Aggregate blocks (`inspections`, `identifiers`, `trust`) are additive — requesting only block names keeps the full flat record and adds the blocks. List scalar field names to trim.
+   * Fields/blocks to return per school. Default (omitted): the full flat record, no blocks. Aggregate blocks (`inspections`, `identifiers`, `trust`, `images`, `branding`, `accreditations`, `videos`, `about`) are additive — requesting only block names keeps the full flat record and adds the blocks. List scalar field names to trim.
    */
   attributes?: string | Array<string> | undefined;
   /**
@@ -49,6 +49,78 @@ export type QuerySchoolsBySourceRequestBody = {
   provider: Provider;
 };
 
+/**
+ * Institutional narrative (ethos, welcome, term dates …). Opt-in via `attributes=about`.
+ */
+export type QuerySchoolsBySourceAbout = {
+  /**
+   * General 'about the school' narrative.
+   */
+  aboutDescription?: string | null | undefined;
+  /**
+   * Whether after-school / wraparound care is offered.
+   */
+  afterSchoolCare?: boolean | null | undefined;
+  /**
+   * Whether a breakfast club is offered.
+   */
+  breakfastClub?: boolean | null | undefined;
+  /**
+   * Extra-curricular clubs description.
+   */
+  clubsDescription?: string | null | undefined;
+  /**
+   * Curriculum narrative.
+   */
+  curriculumDescription?: string | null | undefined;
+  /**
+   * The school's stated ethos / values.
+   */
+  ethos?: string | null | undefined;
+  /**
+   * Facilities description.
+   */
+  facilitiesDescription?: string | null | undefined;
+  /**
+   * Headteacher's welcome message.
+   */
+  headteacherWelcome?: string | null | undefined;
+  /**
+   * School history narrative.
+   */
+  historyDescription?: string | null | undefined;
+  /**
+   * Link to the school prospectus.
+   */
+  prospectusUrl?: string | null | undefined;
+  /**
+   * Results / outcomes summary as published.
+   */
+  resultsSummary?: string | null | undefined;
+  /**
+   * SEND / inclusion statement.
+   */
+  sendStatement?: string | null | undefined;
+  /**
+   * Published term dates.
+   */
+  termDates?: Array<shared.SchoolTermDate> | undefined;
+  /**
+   * Named uniform supplier, where stated.
+   */
+  uniformSupplier?: string | null | undefined;
+};
+
+/**
+ * Award / kitemark / partner badges. Opt-in via `attributes=accreditations`.
+ */
+export type QuerySchoolsBySourceAccreditations = {
+  /**
+   * Cleared accreditation / award badges.
+   */
+  accreditations?: Array<shared.SchoolAccreditation> | undefined;
+};
+
 /**
  * Postal address of the school
  */
@@ -75,6 +147,25 @@ export type QuerySchoolsBySourceAddress = {
   town?: string | undefined;
 };
 
+/**
+ * School branding — logo/crest, colours, social handles. Opt-in via `attributes=branding`.
+ */
+export type QuerySchoolsBySourceBranding = {
+  /**
+   * Public URL to the entity's logo / crest.
+   */
+  logoUrl?: string | undefined;
+  /**
+   * Primary brand colour (hex).
+   */
+  primaryColour?: string | undefined;
+  /**
+   * Secondary brand colour (hex).
+   */
+  secondaryColour?: string | undefined;
+  socialMedia?: shared.SocialMediaLinks | undefined;
+};
+
 /**
  * Latest published inspection rating. Native rating from the inspector body that issued it (England: Ofsted; Wales: Estyn; Scotland: Education Scotland; NI: ETI; IE: DES Inspectorate). Rating scales differ by inspector body — do not assume cross-body equivalence.
  */
@@ -128,6 +219,16 @@ export type QuerySchoolsBySourceIdentifiers = {
   ukprn?: string | null | undefined;
 };
 
+/**
+ * Facility / building photography, tagged. Opt-in via `attributes=images`.
+ */
+export type QuerySchoolsBySourceImages = {
+  /**
+   * Cleared facility / building photography, newest first.
+   */
+  images?: Array<shared.SchoolImage> | undefined;
+};
+
 /**
  * Inspection history. Present only when requested via `attributes=inspections`.
  */
@@ -232,16 +333,38 @@ export type QuerySchoolsBySourceType = OpenEnum<
   typeof QuerySchoolsBySourceType
 >;
 
+/**
+ * Video embeds (metadata only, by reference). Opt-in via `attributes=videos`.
+ */
+export type QuerySchoolsBySourceVideos = {
+  /**
+   * Cleared video embeds.
+   */
+  videos?: Array<shared.SchoolVideo> | undefined;
+};
+
 /**
  * A single school record. Combines identity (country, region, provider+key) with descriptive details, location, the latest inspection rating, and source-register metadata. Use the `provider`+`key` pair as a cross-jurisdiction alternate key, and `id` as the durable internal identifier.
  */
 export type QuerySchoolsBySourceData = {
+  /**
+   * Institutional narrative (ethos, welcome, term dates …). Opt-in via `attributes=about`.
+   */
+  about?: QuerySchoolsBySourceAbout | null | undefined;
+  /**
+   * Award / kitemark / partner badges. Opt-in via `attributes=accreditations`.
+   */
+  accreditations?: QuerySchoolsBySourceAccreditations | null | undefined;
   /**
    * Postal address of the school
    */
   address?: QuerySchoolsBySourceAddress | undefined;
   admissionsPolicy?: string | undefined;
   ageRange?: string | undefined;
+  /**
+   * School branding — logo/crest, colours, social handles. Opt-in via `attributes=branding`.
+   */
+  branding?: QuerySchoolsBySourceBranding | null | undefined;
   capacity?: number | undefined;
   /**
    * Catchment match block. Present only when the request included `catchmentReference`. `matchBasis` is empty when the school is only in range (Tier 5 distance fallback); `verdict` is always populated.
@@ -274,6 +397,10 @@ export type QuerySchoolsBySourceData = {
    * Cross-register identifiers. Present only when requested via `attributes=identifiers`.
    */
   identifiers?: QuerySchoolsBySourceIdentifiers | null | undefined;
+  /**
+   * Facility / building photography, tagged. Opt-in via `attributes=images`.
+   */
+  images?: QuerySchoolsBySourceImages | null | undefined;
   /**
    * Inspection history. Present only when requested via `attributes=inspections`.
    */
@@ -348,6 +475,10 @@ export type QuerySchoolsBySourceData = {
    * ISO 8601 datetime of the most recent update to this record
    */
   updatedAt: string;
+  /**
+   * Video embeds (metadata only, by reference). Opt-in via `attributes=videos`.
+   */
+  videos?: QuerySchoolsBySourceVideos | null | undefined;
   website?: string | undefined;
 };
 
@@ -436,6 +567,58 @@ export function querySchoolsBySourceRequestBodyToJSON(
   );
 }
 
+/** @internal */
+export const QuerySchoolsBySourceAbout$inboundSchema: z.ZodType<
+  QuerySchoolsBySourceAbout,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  aboutDescription: z.nullable(z.string()).optional(),
+  afterSchoolCare: z.nullable(z.boolean()).optional(),
+  breakfastClub: z.nullable(z.boolean()).optional(),
+  clubsDescription: z.nullable(z.string()).optional(),
+  curriculumDescription: z.nullable(z.string()).optional(),
+  ethos: z.nullable(z.string()).optional(),
+  facilitiesDescription: z.nullable(z.string()).optional(),
+  headteacherWelcome: z.nullable(z.string()).optional(),
+  historyDescription: z.nullable(z.string()).optional(),
+  prospectusUrl: z.nullable(z.string()).optional(),
+  resultsSummary: z.nullable(z.string()).optional(),
+  sendStatement: z.nullable(z.string()).optional(),
+  termDates: z.array(shared.SchoolTermDate$inboundSchema).optional(),
+  uniformSupplier: z.nullable(z.string()).optional(),
+});
+
+export function querySchoolsBySourceAboutFromJSON(
+  jsonString: string,
+): SafeParseResult<QuerySchoolsBySourceAbout, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => QuerySchoolsBySourceAbout$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QuerySchoolsBySourceAbout' from JSON`,
+  );
+}
+
+/** @internal */
+export const QuerySchoolsBySourceAccreditations$inboundSchema: z.ZodType<
+  QuerySchoolsBySourceAccreditations,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  accreditations: z.array(shared.SchoolAccreditation$inboundSchema).optional(),
+});
+
+export function querySchoolsBySourceAccreditationsFromJSON(
+  jsonString: string,
+): SafeParseResult<QuerySchoolsBySourceAccreditations, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      QuerySchoolsBySourceAccreditations$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QuerySchoolsBySourceAccreditations' from JSON`,
+  );
+}
+
 /** @internal */
 export const QuerySchoolsBySourceAddress$inboundSchema: z.ZodType<
   QuerySchoolsBySourceAddress,
@@ -459,6 +642,28 @@ export function querySchoolsBySourceAddressFromJSON(
   );
 }
 
+/** @internal */
+export const QuerySchoolsBySourceBranding$inboundSchema: z.ZodType<
+  QuerySchoolsBySourceBranding,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  logoUrl: z.string().optional(),
+  primaryColour: z.string().optional(),
+  secondaryColour: z.string().optional(),
+  socialMedia: shared.SocialMediaLinks$inboundSchema.optional(),
+});
+
+export function querySchoolsBySourceBrandingFromJSON(
+  jsonString: string,
+): SafeParseResult<QuerySchoolsBySourceBranding, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => QuerySchoolsBySourceBranding$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QuerySchoolsBySourceBranding' from JSON`,
+  );
+}
+
 /** @internal */
 export const QuerySchoolsBySourceCurrentRating$inboundSchema: z.ZodType<
   QuerySchoolsBySourceCurrentRating,
@@ -488,6 +693,25 @@ export function querySchoolsBySourceIdentifiersFromJSON(
   );
 }
 
+/** @internal */
+export const QuerySchoolsBySourceImages$inboundSchema: z.ZodType<
+  QuerySchoolsBySourceImages,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  images: z.array(shared.SchoolImage$inboundSchema).optional(),
+});
+
+export function querySchoolsBySourceImagesFromJSON(
+  jsonString: string,
+): SafeParseResult<QuerySchoolsBySourceImages, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => QuerySchoolsBySourceImages$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QuerySchoolsBySourceImages' from JSON`,
+  );
+}
+
 /** @internal */
 export const QuerySchoolsBySourceInspections$inboundSchema: z.ZodType<
   QuerySchoolsBySourceInspections,
@@ -574,15 +798,41 @@ export const QuerySchoolsBySourceType$inboundSchema: z.ZodType<
   unknown
 > = openEnums.inboundSchema(QuerySchoolsBySourceType);
 
+/** @internal */
+export const QuerySchoolsBySourceVideos$inboundSchema: z.ZodType<
+  QuerySchoolsBySourceVideos,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  videos: z.array(shared.SchoolVideo$inboundSchema).optional(),
+});
+
+export function querySchoolsBySourceVideosFromJSON(
+  jsonString: string,
+): SafeParseResult<QuerySchoolsBySourceVideos, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => QuerySchoolsBySourceVideos$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QuerySchoolsBySourceVideos' from JSON`,
+  );
+}
+
 /** @internal */
 export const QuerySchoolsBySourceData$inboundSchema: z.ZodType<
   QuerySchoolsBySourceData,
   z.ZodTypeDef,
   unknown
 > = z.object({
+  about: z.nullable(z.lazy(() => QuerySchoolsBySourceAbout$inboundSchema))
+    .optional(),
+  accreditations: z.nullable(
+    z.lazy(() => QuerySchoolsBySourceAccreditations$inboundSchema),
+  ).optional(),
   address: z.lazy(() => QuerySchoolsBySourceAddress$inboundSchema).optional(),
   admissionsPolicy: z.string().optional(),
   ageRange: z.string().optional(),
+  branding: z.nullable(z.lazy(() => QuerySchoolsBySourceBranding$inboundSchema))
+    .optional(),
   capacity: z.number().int().optional(),
   catchment: shared.SchoolCatchmentBlock$inboundSchema.optional(),
   country: z.string().default("GB"),
@@ -597,6 +847,8 @@ export const QuerySchoolsBySourceData$inboundSchema: z.ZodType<
   identifiers: z.nullable(
     z.lazy(() => QuerySchoolsBySourceIdentifiers$inboundSchema),
   ).optional(),
+  images: z.nullable(z.lazy(() => QuerySchoolsBySourceImages$inboundSchema))
+    .optional(),
   inspections: z.nullable(
     z.lazy(() => QuerySchoolsBySourceInspections$inboundSchema),
   ).optional(),
@@ -627,6 +879,8 @@ export const QuerySchoolsBySourceData$inboundSchema: z.ZodType<
   trustName: z.string().optional(),
   type: QuerySchoolsBySourceType$inboundSchema,
   updatedAt: z.string(),
+  videos: z.nullable(z.lazy(() => QuerySchoolsBySourceVideos$inboundSchema))
+    .optional(),
   website: z.string().optional(),
 });
 

package/src/sdk/models/shared/councilbranding.ts

@@ -6,54 +6,27 @@ import * as z from "zod/v3";
 import { safeParse } from "../../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
-
-export type SocialMedia = {
-  facebook?: string | undefined;
-  instagram?: string | undefined;
-  linkedin?: string | undefined;
-  twitter?: string | undefined;
-  youtube?: string | undefined;
-};
+import {
+  SocialMediaLinks,
+  SocialMediaLinks$inboundSchema,
+} from "./socialmedialinks.js";
 
 export type CouncilBranding = {
   /**
-   * URL to council logo
+   * Public URL to the entity's logo / crest.
    */
   logoUrl?: string | undefined;
   /**
-   * Primary brand colour (hex)
+   * Primary brand colour (hex).
    */
   primaryColour?: string | undefined;
   /**
-   * Secondary brand colour (hex)
+   * Secondary brand colour (hex).
    */
   secondaryColour?: string | undefined;
-  socialMedia?: SocialMedia | undefined;
+  socialMedia?: SocialMediaLinks | undefined;
 };
 
-/** @internal */
-export const SocialMedia$inboundSchema: z.ZodType<
-  SocialMedia,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  facebook: z.string().optional(),
-  instagram: z.string().optional(),
-  linkedin: z.string().optional(),
-  twitter: z.string().optional(),
-  youtube: z.string().optional(),
-});
-
-export function socialMediaFromJSON(
-  jsonString: string,
-): SafeParseResult<SocialMedia, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => SocialMedia$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'SocialMedia' from JSON`,
-  );
-}
-
 /** @internal */
 export const CouncilBranding$inboundSchema: z.ZodType<
   CouncilBranding,
@@ -63,7 +36,7 @@ export const CouncilBranding$inboundSchema: z.ZodType<
   logoUrl: z.string().optional(),
   primaryColour: z.string().optional(),
   secondaryColour: z.string().optional(),
-  socialMedia: z.lazy(() => SocialMedia$inboundSchema).optional(),
+  socialMedia: SocialMediaLinks$inboundSchema.optional(),
 });
 
 export function councilBrandingFromJSON(

package/src/sdk/models/shared/index.ts

@@ -311,15 +311,19 @@ export * from "./reversegeocoderesponse.js";
 export * from "./roomdetails.js";
 export * from "./salerecord.js";
 export * from "./scale.js";
+export * from "./schoolaccreditation.js";
 export * from "./schoolcatchmentblock.js";
 export * from "./schoolframeworkcode.js";
+export * from "./schoolimage.js";
 export * from "./schoolinspectionevaluationarea.js";
 export * from "./schoolinspectionevent.js";
 export * from "./schoolinspectiongrade.js";
 export * from "./schoolinspectionpredecessor.js";
 export * from "./schoolinspectorbody.js";
 export * from "./schoolmatchbasis.js";
+export * from "./schooltermdate.js";
 export * from "./schooltrustmembership.js";
+export * from "./schoolvideo.js";
 export * from "./searchhighlight.js";
 export * from "./searchresponse.js";
 export * from "./searchresult.js";
@@ -352,6 +356,7 @@ export * from "./sitequerygroup.js";
 export * from "./sitequeryoperator.js";
 export * from "./sitequeryrequest.js";
 export * from "./sitetags.js";
+export * from "./socialmedialinks.js";
 export * from "./statsaggregationresult.js";
 export * from "./streetdescriptor.js";
 export * from "./streetdetails.js";

package/src/sdk/models/shared/schoolaccreditation.ts

@@ -0,0 +1,44 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type SchoolAccreditation = {
+  /**
+   * What the badge attests, where recognised.
+   */
+  description: string | null;
+  /**
+   * Badge classification, e.g. 'ofsted_badge' | 'award' | 'kitemark' | 'partner_badge'.
+   */
+  kind: string | null;
+  /**
+   * Public CDN URL for the badge image.
+   */
+  url: string;
+};
+
+/** @internal */
+export const SchoolAccreditation$inboundSchema: z.ZodType<
+  SchoolAccreditation,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  description: z.nullable(z.string()),
+  kind: z.nullable(z.string()),
+  url: z.string(),
+});
+
+export function schoolAccreditationFromJSON(
+  jsonString: string,
+): SafeParseResult<SchoolAccreditation, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SchoolAccreditation$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SchoolAccreditation' from JSON`,
+  );
+}

package/src/sdk/models/shared/schoolimage.ts

@@ -0,0 +1,54 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type SchoolImage = {
+  /**
+   * Short caption describing the image.
+   */
+  description: string | null;
+  /**
+   * Pixel height.
+   */
+  height?: number | null | undefined;
+  /**
+   * What the image depicts, e.g. 'classroom' | 'sports_hall' | 'library' | 'grounds'.
+   */
+  tag: string | null;
+  /**
+   * Public CDN URL for the image.
+   */
+  url: string;
+  /**
+   * Pixel width.
+   */
+  width?: number | null | undefined;
+};
+
+/** @internal */
+export const SchoolImage$inboundSchema: z.ZodType<
+  SchoolImage,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  description: z.nullable(z.string()),
+  height: z.nullable(z.number().int()).optional(),
+  tag: z.nullable(z.string()),
+  url: z.string(),
+  width: z.nullable(z.number().int()).optional(),
+});
+
+export function schoolImageFromJSON(
+  jsonString: string,
+): SafeParseResult<SchoolImage, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SchoolImage$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SchoolImage' from JSON`,
+  );
+}

package/src/sdk/models/shared/schooltermdate.ts

@@ -0,0 +1,44 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type SchoolTermDate = {
+  /**
+   * End date as published (source text).
+   */
+  end: string | null;
+  /**
+   * Term / holiday label, e.g. 'Autumn term'.
+   */
+  label: string;
+  /**
+   * Start date as published (source text).
+   */
+  start: string | null;
+};
+
+/** @internal */
+export const SchoolTermDate$inboundSchema: z.ZodType<
+  SchoolTermDate,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  end: z.nullable(z.string()),
+  label: z.string(),
+  start: z.nullable(z.string()),
+});
+
+export function schoolTermDateFromJSON(
+  jsonString: string,
+): SafeParseResult<SchoolTermDate, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SchoolTermDate$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SchoolTermDate' from JSON`,
+  );
+}

package/src/sdk/models/shared/schoolvideo.ts

@@ -0,0 +1,86 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../../lib/schemas.js";
+import * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Hosting provider.
+ */
+export const SchoolVideoProvider = {
+  Youtube: "youtube",
+  Vimeo: "vimeo",
+  SelfHosted: "self_hosted",
+} as const;
+/**
+ * Hosting provider.
+ */
+export type SchoolVideoProvider = OpenEnum<typeof SchoolVideoProvider>;
+
+export type SchoolVideo = {
+  /**
+   * Runtime in seconds, where known.
+   */
+  durationSeconds?: number | null | undefined;
+  /**
+   * URL suitable for an <iframe> embed, where available.
+   */
+  embedUrl: string | null;
+  /**
+   * Provider-scoped video id (or path for self-hosted).
+   */
+  externalId: string;
+  /**
+   * Hosting provider.
+   */
+  provider: SchoolVideoProvider;
+  /**
+   * Third-party thumbnail URL — referenced, not re-hosted.
+   */
+  thumbnailUrl: string | null;
+  /**
+   * Video title as published.
+   */
+  title: string | null;
+  /**
+   * Canonical watch URL on the provider.
+   */
+  url: string;
+};
+
+/** @internal */
+export const SchoolVideoProvider$inboundSchema: z.ZodType<
+  SchoolVideoProvider,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(SchoolVideoProvider);
+
+/** @internal */
+export const SchoolVideo$inboundSchema: z.ZodType<
+  SchoolVideo,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  durationSeconds: z.nullable(z.number().int()).optional(),
+  embedUrl: z.nullable(z.string()),
+  externalId: z.string(),
+  provider: SchoolVideoProvider$inboundSchema,
+  thumbnailUrl: z.nullable(z.string()),
+  title: z.nullable(z.string()),
+  url: z.string(),
+});
+
+export function schoolVideoFromJSON(
+  jsonString: string,
+): SafeParseResult<SchoolVideo, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SchoolVideo$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SchoolVideo' from JSON`,
+  );
+}