@vepler/sdk 6.61.4 → 7.1.0

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

@@ -361,7 +361,7 @@ export type Site = {
    */
   ownership?: Ownership | null | undefined;
   /**
-   * Statistics across the planning applications whose boundary intersects this site. Null when none intersect it.
+   * The planning applications linked to this site, with counts. Null when no application is linked.
    */
   planning?: SitePlanningStats | null | undefined;
   /**
@@ -388,6 +388,10 @@ export type Site = {
    * Identifier for a single registered title, made up of the country, the registry and the title number joined by colons.
    */
   siteId?: string | undefined;
+  /**
+   * When HM Land Registry last changed this title's boundary record, as an ISO 8601 timestamp: the latest update date across the title's polygons. Null when the register gives no date.
+   */
+  sourceUpdatedAt?: string | null | undefined;
   /**
    * Data sources that contributed to this site record.
    */
@@ -409,7 +413,7 @@ export type Site = {
    */
   titleRef?: string | undefined;
   /**
-   * When this site record was last updated, as an ISO 8601 timestamp.
+   * When Vepler last loaded or rebuilt this site record, as an ISO 8601 timestamp. It is not a date from HM Land Registry; `sourceUpdatedAt` and `registeredAt` are.
    */
   updatedAt?: string | null | undefined;
 };
@@ -611,6 +615,7 @@ export const Site$inboundSchema: z.ZodType<Site, z.ZodTypeDef, unknown> = z
     registry: z.string().optional(),
     relationships: z.array(z.string()).optional(),
     siteId: z.string().optional(),
+    sourceUpdatedAt: z.nullable(z.string()).optional(),
     sources: z.array(z.string()).optional(),
     status: SiteStatus$inboundSchema.optional(),
     tags: SiteTags$inboundSchema.optional(),

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

@@ -0,0 +1,92 @@
+/*
+ * 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";
+
+/**
+ * How the application boundary sits against the title boundary: 'application_within_title' when the application lies inside the title, 'title_within_application' when the whole title lies inside the application, and 'partial' when the two overlap in part. Boundaries that only meet along a shared edge do not count as overlapping. Null when 'spatial' is not in routes.
+ */
+export const Relationship = {
+  ApplicationWithinTitle: "application_within_title",
+  TitleWithinApplication: "title_within_application",
+  Partial: "partial",
+} as const;
+/**
+ * How the application boundary sits against the title boundary: 'application_within_title' when the application lies inside the title, 'title_within_application' when the whole title lies inside the application, and 'partial' when the two overlap in part. Boundaries that only meet along a shared edge do not count as overlapping. Null when 'spatial' is not in routes.
+ */
+export type Relationship = OpenEnum<typeof Relationship>;
+
+export const Routes = {
+  SiteId: "siteId",
+  UprnLinks: "uprnLinks",
+  Spatial: "spatial",
+} as const;
+export type Routes = OpenEnum<typeof Routes>;
+
+export type SitePlanningApplicationLink = {
+  /**
+   * Land area inside the application boundary, in square metres to one decimal place. Null when the application has no boundary or its boundary does not lie in Great Britain.
+   */
+  applicationAreaSqm?: number | null | undefined;
+  /**
+   * Identifier of the planning application. Pass it to GET /v1/planning/{applicationIds} to fetch it.
+   */
+  id?: string | undefined;
+  /**
+   * Share of the application boundary's land area that falls on this title, as a percentage from 0 to 100 to one decimal place. Null when 'spatial' is not in routes.
+   */
+  overlapPctOfApplication?: number | null | undefined;
+  /**
+   * Share of the title's land area covered by the application boundary, as a percentage from 0 to 100 to one decimal place. Null when 'spatial' is not in routes.
+   */
+  overlapPctOfTitle?: number | null | undefined;
+  /**
+   * How the application boundary sits against the title boundary: 'application_within_title' when the application lies inside the title, 'title_within_application' when the whole title lies inside the application, and 'partial' when the two overlap in part. Boundaries that only meet along a shared edge do not count as overlapping. Null when 'spatial' is not in routes.
+   */
+  relationship?: Relationship | null | undefined;
+  /**
+   * Every way this application was found on the title: 'siteId' when the application is recorded against this site, 'uprnLinks' when the application's property is one the title covers, and 'spatial' when the application boundary overlaps the title boundary. An application found by more than one route lists each of them.
+   */
+  routes?: Array<Routes> | undefined;
+};
+
+/** @internal */
+export const Relationship$inboundSchema: z.ZodType<
+  Relationship,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(Relationship);
+
+/** @internal */
+export const Routes$inboundSchema: z.ZodType<Routes, z.ZodTypeDef, unknown> =
+  openEnums.inboundSchema(Routes);
+
+/** @internal */
+export const SitePlanningApplicationLink$inboundSchema: z.ZodType<
+  SitePlanningApplicationLink,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  applicationAreaSqm: z.nullable(z.number()).optional(),
+  id: z.string().optional(),
+  overlapPctOfApplication: z.nullable(z.number()).optional(),
+  overlapPctOfTitle: z.nullable(z.number()).optional(),
+  relationship: z.nullable(Relationship$inboundSchema).optional(),
+  routes: z.array(Routes$inboundSchema).optional(),
+});
+
+export function sitePlanningApplicationLinkFromJSON(
+  jsonString: string,
+): SafeParseResult<SitePlanningApplicationLink, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SitePlanningApplicationLink$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SitePlanningApplicationLink' from JSON`,
+  );
+}

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

@@ -8,6 +8,10 @@ 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";
+import {
+  SitePlanningApplicationLink,
+  SitePlanningApplicationLink$inboundSchema,
+} from "./siteplanningapplicationlink.js";
 
 export const SitePlanningStatsSources = {
   SiteId: "siteId",
@@ -19,51 +23,55 @@ export type SitePlanningStatsSources = OpenEnum<
 >;
 
 /**
- * Statistics across the planning applications whose boundary intersects this site. Null when none intersect it.
+ * The planning applications linked to this site, with counts. Null when no application is linked.
  */
 export type SitePlanningStats = {
   /**
-   * Identifiers of the planning applications linked to this site, most recently received first. Pass them to GET /v1/planning/{applicationIds} to fetch the applications. The list is cut at a fixed limit; truncated says when that happened. Absent on a site whose planning data has not been rebuilt since this field was introduced.
+   * The distinct application types across the applications counted in totalApplications and held in applications.
    */
-  applicationIds?: Array<string> | undefined;
+  applicationTypes?: Array<string> | undefined;
   /**
-   * The distinct application types found across the applications in applicationIds.
+   * The planning applications linked to this site, with how each was found and how its boundary sits against the title. Applications counted in totalApplications come first, then those in partOfLargerSchemeTotal, each group most recently received first. An application whose boundary only meets the title along a shared edge is left out unless it was also found another way. The list is cut at a fixed limit; truncated says when that happened. Absent on a site whose planning data has not been rebuilt since this field was introduced.
    */
-  applicationTypes?: Array<string> | undefined;
+  applications?: Array<SitePlanningApplicationLink> | undefined;
   /**
-   * How many of the applications in applicationIds were approved.
+   * How many of the applications counted in totalApplications and held in applications were approved.
    */
   approvals?: number | undefined;
   /**
-   * When the links were last read, as an ISO 8601 timestamp. Absent when applicationIds is absent.
+   * When the links were last read, as an ISO 8601 timestamp. Absent when applications is absent.
    */
   asOf?: string | undefined;
   /**
-   * When the most recent of those applications was received, as an ISO 8601 timestamp.
+   * When the most recent application counted in totalApplications was received, as an ISO 8601 timestamp.
    */
   latestApplicationDate?: string | undefined;
   /**
-   * Status of the most recent application, in the wording the local authority published.
+   * Status of the most recent application counted in totalApplications, in the wording the local authority published.
    */
   latestDecision?: string | undefined;
   /**
-   * How many of the applications in applicationIds are still awaiting a decision.
+   * Number of linked applications that cover the whole of this title as part of a larger scheme and were found only by their boundary ('title_within_application' in applications). They are not part of totalApplications or the other counts. Absent on a site whose planning data has not been rebuilt since this field was introduced.
+   */
+  partOfLargerSchemeTotal?: number | undefined;
+  /**
+   * How many of the applications counted in totalApplications and held in applications are still awaiting a decision.
    */
   pending?: number | undefined;
   /**
-   * How many of the applications in applicationIds were refused.
+   * How many of the applications counted in totalApplications and held in applications were refused.
    */
   refusals?: number | undefined;
   /**
-   * Which links were used to find the applications: 'siteId' for applications recorded against this site, 'uprnLinks' for applications on a property the title covers, and 'spatial' for applications whose boundary intersects the title boundary. 'spatial' is present only when the site has a boundary. Absent when applicationIds is absent.
+   * Which routes were searched for this site: 'siteId' for applications recorded against this site, 'uprnLinks' for applications on a property the title covers, and 'spatial' for applications whose boundary overlaps the title boundary. 'spatial' is present only when the site has a boundary. Absent when applications is absent.
    */
   sources?: Array<SitePlanningStatsSources> | undefined;
   /**
-   * Number of planning applications linked to this site across every source in sources. This is the full count even when applicationIds is truncated.
+   * Number of planning applications linked to this site: those recorded against the site or one of its properties, and those whose boundary lies inside the title or overlaps part of it. This is the full count even when applications is truncated. Applications that cover this title only as part of a larger scheme are counted in partOfLargerSchemeTotal instead.
    */
   totalApplications?: number | undefined;
   /**
-   * True when applicationIds holds fewer applications than totalApplications because the list was cut at its limit. Absent when applicationIds is absent.
+   * True when applications holds fewer entries than totalApplications and partOfLargerSchemeTotal together because the list was cut at its limit. Absent when applications is absent.
    */
   truncated?: boolean | undefined;
 };
@@ -81,12 +89,13 @@ export const SitePlanningStats$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  applicationIds: z.array(z.string()).optional(),
   applicationTypes: z.array(z.string()).optional(),
+  applications: z.array(SitePlanningApplicationLink$inboundSchema).optional(),
   approvals: z.number().optional(),
   asOf: z.string().optional(),
   latestApplicationDate: z.string().optional(),
   latestDecision: z.string().optional(),
+  partOfLargerSchemeTotal: z.number().optional(),
   pending: z.number().optional(),
   refusals: z.number().optional(),
   sources: z.array(SitePlanningStatsSources$inboundSchema).optional(),