@vepler/sdk 2.46.0 → 2.50.3

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

@@ -6,10 +6,23 @@ 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";
-import { DateOfBirth, DateOfBirth$inboundSchema } from "./dateofbirth.js";
 
 /**
- * The canonical (primary) person record in this cluster. This is the authoritative representation of the individual. Null if no canonical record has been designated.
+ * Month and year of birth. Day is not disclosed for privacy.
+ */
+export type PersonSummaryDateOfBirth = {
+  /**
+   * Birth month (1 = January, 12 = December).
+   */
+  month: number;
+  /**
+   * Birth year (4-digit).
+   */
+  year: number;
+};
+
+/**
+ * Lightweight person summary for list responses and nested inclusions.
  */
 export type PersonSummary = {
   /**
@@ -24,7 +37,10 @@ export type PersonSummary = {
    * Country of usual residence.
    */
   countryOfResidence?: string | null | undefined;
-  dateOfBirth?: DateOfBirth | null | undefined;
+  /**
+   * Month and year of birth. Day is not disclosed for privacy.
+   */
+  dateOfBirth?: PersonSummaryDateOfBirth | null | undefined;
   /**
    * First (given) name.
    */
@@ -55,6 +71,26 @@ export type PersonSummary = {
   totalAppointments: number;
 };
 
+/** @internal */
+export const PersonSummaryDateOfBirth$inboundSchema: z.ZodType<
+  PersonSummaryDateOfBirth,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  month: z.number().int(),
+  year: z.number().int(),
+});
+
+export function personSummaryDateOfBirthFromJSON(
+  jsonString: string,
+): SafeParseResult<PersonSummaryDateOfBirth, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PersonSummaryDateOfBirth$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PersonSummaryDateOfBirth' from JSON`,
+  );
+}
+
 /** @internal */
 export const PersonSummary$inboundSchema: z.ZodType<
   PersonSummary,
@@ -64,7 +100,8 @@ export const PersonSummary$inboundSchema: z.ZodType<
   activeAppointments: z.number().int(),
   clusterId: z.nullable(z.string()).optional(),
   countryOfResidence: z.nullable(z.string()).optional(),
-  dateOfBirth: z.nullable(DateOfBirth$inboundSchema).optional(),
+  dateOfBirth: z.nullable(z.lazy(() => PersonSummaryDateOfBirth$inboundSchema))
+    .optional(),
   forename: z.nullable(z.string()).optional(),
   id: z.string(),
   isCanonical: z.boolean(),

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

@@ -8,10 +8,11 @@ import * as openEnums from "../../types/enums.js";
 import { ClosedEnum, OpenEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { PlanningAgent, PlanningAgent$inboundSchema } from "./planningagent.js";
 import {
-  PlanningAddress,
-  PlanningAddress$inboundSchema,
-} from "./planningaddress.js";
+  PlanningApplicant,
+  PlanningApplicant$inboundSchema,
+} from "./planningapplicant.js";
 import {
   PlanningConstraint,
   PlanningConstraint$inboundSchema,
@@ -20,10 +21,6 @@ import {
   PlanningDocument,
   PlanningDocument$inboundSchema,
 } from "./planningdocument.js";
-import {
-  PlanningPeople,
-  PlanningPeople$inboundSchema,
-} from "./planningpeople.js";
 import {
   PlanningRelatedCase,
   PlanningRelatedCase$inboundSchema,
@@ -33,6 +30,62 @@ import {
   PlanningStatusHistory$inboundSchema,
 } from "./planningstatushistory.js";
 
+/**
+ * Structured address of the application site, as scraped from the planning authority. Field availability varies by council — some provide full structured addresses whilst others provide only a raw string. Null if no address data was available.
+ */
+export type PlanningApplicationAddress = {
+  /**
+   * County.
+   */
+  county?: string | null | undefined;
+  /**
+   * Full formatted address as a single string, when available.
+   */
+  formattedAddress?: string | null | undefined;
+  /**
+   * First line of the site address.
+   */
+  line1?: string | null | undefined;
+  /**
+   * Second line of the site address.
+   */
+  line2?: string | null | undefined;
+  /**
+   * Third line of the site address.
+   */
+  line3?: string | null | undefined;
+  /**
+   * Fourth line of the site address.
+   */
+  line4?: string | null | undefined;
+  /**
+   * UK postcode.
+   */
+  postcode?: string | null | undefined;
+  /**
+   * Town or city.
+   */
+  town?: string | null | undefined;
+  /**
+   * Electoral ward in which the site is located.
+   */
+  ward?: string | null | undefined;
+};
+
+/**
+ * People associated with the application including applicants and planning agents. Contact details (phone, email) are redacted; only names and organisations are included. Null if no applicant or agent data was available.
+ */
+export type People = {
+  /**
+   * Planning agents or consultants acting on behalf of the applicant.
+   */
+  agents?: Array<PlanningAgent> | undefined;
+  /**
+   * People or organisations who submitted the application.
+   */
+  applicants?: Array<PlanningApplicant> | undefined;
+};
+
 /**
  * GeoJSON geometry type, always 'Point' for application site centroids.
  */
@@ -243,7 +296,7 @@ export type PlanningApplication = {
   /**
    * Structured address of the application site, as scraped from the planning authority. Field availability varies by council — some provide full structured addresses whilst others provide only a raw string. Null if no address data was available.
    */
-  address?: PlanningAddress | null | undefined;
+  address?: PlanningApplicationAddress | null | undefined;
   /**
    * The date on which an appeal was lodged with the Planning Inspectorate, formatted as an ISO 8601 datetime string. An appeal may be lodged when an application is refused or when the authority fails to determine the application within the statutory time limit. Null if no appeal has been lodged.
    */
@@ -303,7 +356,7 @@ export type PlanningApplication = {
   /**
    * People associated with the application including applicants and planning agents. Contact details (phone, email) are redacted; only names and organisations are included. Null if no applicant or agent data was available.
    */
-  people?: PlanningPeople | null | undefined;
+  people?: People | null | undefined;
   /**
    * Identifier for the local planning authority (LPA) or council that received the application. This is a normalised slug derived from the council name (e.g. 'lambeth', 'manchester', 'st-albans'). Use this value in the query endpoint's councils filter to retrieve all applications from a specific authority.
    */
@@ -366,6 +419,50 @@ export type PlanningApplication = {
   validatedDate?: string | null | undefined;
 };
 
+/** @internal */
+export const PlanningApplicationAddress$inboundSchema: z.ZodType<
+  PlanningApplicationAddress,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  county: z.nullable(z.string()).optional(),
+  formattedAddress: z.nullable(z.string()).optional(),
+  line1: z.nullable(z.string()).optional(),
+  line2: z.nullable(z.string()).optional(),
+  line3: z.nullable(z.string()).optional(),
+  line4: z.nullable(z.string()).optional(),
+  postcode: z.nullable(z.string()).optional(),
+  town: z.nullable(z.string()).optional(),
+  ward: z.nullable(z.string()).optional(),
+});
+
+export function planningApplicationAddressFromJSON(
+  jsonString: string,
+): SafeParseResult<PlanningApplicationAddress, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PlanningApplicationAddress$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PlanningApplicationAddress' from JSON`,
+  );
+}
+
+/** @internal */
+export const People$inboundSchema: z.ZodType<People, z.ZodTypeDef, unknown> = z
+  .object({
+    agents: z.array(PlanningAgent$inboundSchema).optional(),
+    applicants: z.array(PlanningApplicant$inboundSchema).optional(),
+  });
+
+export function peopleFromJSON(
+  jsonString: string,
+): SafeParseResult<People, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => People$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'People' from JSON`,
+  );
+}
+
 /** @internal */
 export const PlanningApplicationType$inboundSchema: z.ZodNativeEnum<
   typeof PlanningApplicationType
@@ -566,7 +663,8 @@ export const PlanningApplication$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  address: z.nullable(PlanningAddress$inboundSchema).optional(),
+  address: z.nullable(z.lazy(() => PlanningApplicationAddress$inboundSchema))
+    .optional(),
   appealedDate: z.nullable(z.string()).optional(),
   appealedStatus: z.nullable(z.string()).optional(),
   caseOfficer: z.nullable(z.string()).optional(),
@@ -581,7 +679,7 @@ export const PlanningApplication$inboundSchema: z.ZodType<
   expiryDate: z.nullable(z.string()).optional(),
   id: z.string(),
   key: z.string(),
-  people: z.nullable(PlanningPeople$inboundSchema).optional(),
+  people: z.nullable(z.lazy(() => People$inboundSchema)).optional(),
   provider: z.string(),
   receivedDate: z.nullable(z.string()).optional(),
   relatedCases: z.nullable(z.array(PlanningRelatedCase$inboundSchema))

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

@@ -9,7 +9,7 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 /**
- * WGS84 coordinate pair
+ * WGS84 coordinates
  */
 export type PostcodeAddressCoordinates = {
   /**
@@ -31,7 +31,7 @@ export type PostcodeAddress = {
    */
   classificationCode?: string | undefined;
   /**
-   * WGS84 coordinate pair
+   * WGS84 coordinates
    */
   coordinates?: PostcodeAddressCoordinates | undefined;
   /**

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

@@ -19,7 +19,7 @@ export type Codes = {
 };
 
 /**
- * WGS84 coordinate pair
+ * Postcode centroid
  */
 export type PostcodeValidationResponseCoordinates = {
   /**
@@ -49,7 +49,7 @@ export type PostcodeValidationResponse = {
    */
   codes?: Codes | undefined;
   /**
-   * WGS84 coordinate pair
+   * Postcode centroid
    */
   coordinates?: PostcodeValidationResponseCoordinates | undefined;
   /**

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

@@ -9,18 +9,39 @@ import { OpenEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
+/**
+ * Direction of price change
+ */
 export const PriceChangeDirection = {
   Up: "up",
   Down: "down",
   Initial: "initial",
 } as const;
+/**
+ * Direction of price change
+ */
 export type PriceChangeDirection = OpenEnum<typeof PriceChangeDirection>;
 
 export type PriceChange = {
+  /**
+   * Amount of change in pence
+   */
   amount?: number | null | undefined;
+  /**
+   * Date of price change
+   */
   date?: Date | null | undefined;
+  /**
+   * Direction of price change
+   */
   direction?: PriceChangeDirection | undefined;
+  /**
+   * Percentage change
+   */
   percent?: number | null | undefined;
+  /**
+   * New price after change in pence
+   */
   price?: number | null | undefined;
 };
 

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

@@ -8,10 +8,25 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type PricingData = {
+  /**
+   * ISO currency code
+   */
   currency?: string | null | undefined;
+  /**
+   * Current rental price per month in pence
+   */
   currentRent?: number | null | undefined;
+  /**
+   * Current sale price in pence
+   */
   currentSale?: number | null | undefined;
+  /**
+   * Estimated rental value per month in pence
+   */
   estimatedRent?: number | null | undefined;
+  /**
+   * Estimated sale value in pence
+   */
   estimatedSale?: number | null | undefined;
 };
 

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

@@ -8,24 +8,30 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type PropertyAddress = {
+  /**
+   * ISO country code
+   */
   country: string;
   /**
    * Formatted display address
    */
-  displayAddress?: string | undefined;
+  displayAddress: string;
   /**
    * Postcode incode
    */
-  incode?: string | undefined;
+  incode: string;
   /**
    * Postcode outcode
    */
-  outcode?: string | undefined;
-  postcode?: string | undefined;
+  outcode: string;
+  /**
+   * UK postcode
+   */
+  postcode: string;
   /**
    * Postcode without spaces
    */
-  postcodeNoSpace?: string | undefined;
+  postcodeNoSpace: string;
 };
 
 /** @internal */
@@ -35,11 +41,11 @@ export const PropertyAddress$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   country: z.string().default("GB"),
-  displayAddress: z.string().optional(),
-  incode: z.string().optional(),
-  outcode: z.string().optional(),
-  postcode: z.string().optional(),
-  postcodeNoSpace: z.string().optional(),
+  displayAddress: z.string(),
+  incode: z.string(),
+  outcode: z.string(),
+  postcode: z.string(),
+  postcodeNoSpace: z.string(),
 });
 
 export function propertyAddressFromJSON(

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

@@ -38,23 +38,44 @@ import { SaleRecord, SaleRecord$inboundSchema } from "./salerecord.js";
 import { TenancyData, TenancyData$inboundSchema } from "./tenancydata.js";
 import { TenureData, TenureData$inboundSchema } from "./tenuredata.js";
 
+/**
+ * Property charges including service charge and ground rent
+ */
 export type Charges = {
   groundRent?: ChargeHistory | null | undefined;
   serviceCharge?: ChargeHistory | null | undefined;
 };
 
+/**
+ * Accuracy level of property coordinates
+ */
 export const CoordinateConfidence = {
   High: "high",
   Medium: "medium",
   Low: "low",
 } as const;
+/**
+ * Accuracy level of property coordinates
+ */
 export type CoordinateConfidence = OpenEnum<typeof CoordinateConfidence>;
 
+/**
+ * Flood risk information
+ */
 export type FloodRisk = {
+  /**
+   * Flood risk level
+   */
   riskLevel?: string | undefined;
+  /**
+   * Suitability assessment
+   */
   suitability?: string | null | undefined;
 };
 
+/**
+ * Physical state of the property (derived from AddressBase Premium BLPU State)
+ */
 export const OccupancyStatus = {
   Planned: "planned",
   UnderConstruction: "under_construction",
@@ -62,12 +83,21 @@ export const OccupancyStatus = {
   Vacant: "vacant",
   Demolished: "demolished",
 } as const;
+/**
+ * Physical state of the property (derived from AddressBase Premium BLPU State)
+ */
 export type OccupancyStatus = OpenEnum<typeof OccupancyStatus>;
 
+/**
+ * Property category
+ */
 export const PropertyCategory = {
   Residential: "residential",
   Commercial: "commercial",
 } as const;
+/**
+ * Property category
+ */
 export type PropertyCategory = OpenEnum<typeof PropertyCategory>;
 
 export type PropertyDataApi2 = {
@@ -80,55 +110,130 @@ export type PropertyDataApi1 = {
   type: "Polygon";
 };
 
+/**
+ * Property boundary GeoJSON (Polygon or MultiPolygon)
+ */
 export type PropertyDataApiBoundary = PropertyDataApi1 | PropertyDataApi2;
 
+/**
+ * GeoJSON geometry type
+ */
 export const PropertyDataApiType = {
   Point: "Point",
 } as const;
+/**
+ * GeoJSON geometry type
+ */
 export type PropertyDataApiType = ClosedEnum<typeof PropertyDataApiType>;
 
 export type PropertyDataApiSpatial = {
+  /**
+   * Property boundary GeoJSON (Polygon or MultiPolygon)
+   */
   boundary?: PropertyDataApi1 | PropertyDataApi2 | undefined;
+  /**
+   * Coordinates as [longitude, latitude] following GeoJSON standard
+   */
   coordinates?: Array<number> | undefined;
+  /**
+   * GeoJSON geometry type
+   */
   type?: PropertyDataApiType | undefined;
 };
 
 export type PropertyDataApi = {
   address?: PropertyAddress | undefined;
   build?: BuildData | undefined;
+  /**
+   * Property charges including service charge and ground rent
+   */
   charges?: Charges | undefined;
+  /**
+   * AddressBase Premium classification code (e.g., RD = Residential Dwelling, RH = HMO, C* = Commercial)
+   */
   classificationCode?: string | null | undefined;
+  /**
+   * Accuracy level of property coordinates
+   */
   coordinateConfidence?: CoordinateConfidence | null | undefined;
   councilTax?: CouncilTaxData | undefined;
   epc?: EPCData | undefined;
+  /**
+   * Flood risk information
+   */
   floodRisk?: FloodRisk | undefined;
+  /**
+   * Lease records for leasehold properties
+   */
   leases?: Array<Lease> | undefined;
+  /**
+   * Property listings with images and details
+   */
   listings?: Array<Listing> | undefined;
   /**
    * Location identifier (always returned)
    */
   locationId?: string | undefined;
   marketStatus?: MarketStatus | undefined;
+  /**
+   * Physical state of the property (derived from AddressBase Premium BLPU State)
+   */
   occupancyStatus?: OccupancyStatus | null | undefined;
+  /**
+   * Property overlays and designations
+   */
   overlays?: Array<string> | undefined;
+  /**
+   * Parent location identifier
+   */
   parentLocationId?: string | null | undefined;
+  /**
+   * Rent price change history
+   */
   priceChangeRent?: Array<PriceChange> | undefined;
+  /**
+   * Sale price change history
+   */
   priceChangeSale?: Array<PriceChange> | undefined;
   pricing?: PricingData | undefined;
+  /**
+   * Property category
+   */
   propertyCategory?: PropertyCategory | null | undefined;
+  /**
+   * Unique property identifier
+   */
   propertyId?: string | undefined;
   prosperity?: ProsperityData | undefined;
   refurbishment?: RefurbishmentData | undefined;
+  /**
+   * Related property IDs
+   */
   relationships?: Array<string> | undefined;
   roomDetails?: RoomDetails | undefined;
+  /**
+   * Historical sale records
+   */
   saleHistory?: Array<SaleRecord> | undefined;
+  /**
+   * SEO-friendly URL slug
+   */
   slug?: string | undefined;
+  /**
+   * Data source identifiers
+   */
   sources?: Array<string> | undefined;
   spatial?: PropertyDataApiSpatial | undefined;
+  /**
+   * Street identifiers
+   */
   streetIds?: Array<number> | undefined;
   tags?: PropertyTags | undefined;
   tenancy?: TenancyData | undefined;
   tenure?: TenureData | undefined;
+  /**
+   * Number of sub-units in multi-occupancy buildings (null for single units)
+   */
   unitCount?: number | null | undefined;
 };