@vepler/sdk 2.57.3 → 2.131.0

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

@@ -0,0 +1,1054 @@
+/*
+ * 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 { ClosedEnum, OpenEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  BuildingAddressLink,
+  BuildingAddressLink$inboundSchema,
+} from "./buildingaddresslink.js";
+import { BuildingPart, BuildingPart$inboundSchema } from "./buildingpart.js";
+
+/**
+ * Counts of linked addresses by classification
+ */
+export type AddressCount = {
+  /**
+   * Commercial address count
+   */
+  commercial?: number | null | undefined;
+  /**
+   * Other address count
+   */
+  other?: number | null | undefined;
+  /**
+   * Residential address count
+   */
+  residential?: number | null | undefined;
+  /**
+   * Total addressable units in this building
+   */
+  total?: number | null | undefined;
+};
+
+export const BuildingDataSources = {
+  Paf: "paf",
+  Os: "os",
+  OsNgd: "os_ngd",
+  NgdAddresses: "ngd_addresses",
+  Epc: "epc",
+  Hmlr: "hmlr",
+  Voa: "voa",
+  Hmrc: "hmrc",
+  HistoricEngland: "historic_england",
+  Listing: "listing",
+  OpenData: "open_data",
+  Council: "council",
+} as const;
+export type BuildingDataSources = OpenEnum<typeof BuildingDataSources>;
+
+/**
+ * Basement presence
+ */
+export const Present = {
+  Present: "present",
+  Absent: "absent",
+} as const;
+/**
+ * Basement presence
+ */
+export type Present = OpenEnum<typeof Present>;
+
+/**
+ * Whether the basement is self-contained with separate entrance
+ */
+export const SelfContained = {
+  Present: "present",
+  Absent: "absent",
+} as const;
+/**
+ * Whether the basement is self-contained with separate entrance
+ */
+export type SelfContained = OpenEnum<typeof SelfContained>;
+
+/**
+ * Basement detection
+ */
+export type Basement = {
+  /**
+   * Sources that contributed to this sub-block
+   */
+  dataSources?: Array<BuildingDataSources> | undefined;
+  /**
+   * Basement presence
+   */
+  present?: Present | null | undefined;
+  /**
+   * Whether the basement is self-contained with separate entrance
+   */
+  selfContained?: SelfContained | null | undefined;
+};
+
+/**
+ * Centroid of the footprint in WGS84
+ */
+export type Coordinates = {
+  /**
+   * Latitude in decimal degrees
+   */
+  lat: number;
+  /**
+   * Longitude in decimal degrees
+   */
+  lng: number;
+};
+
+/**
+ * Building connectivity type (OS NGD `connectivity` canonicalised)
+ */
+export const Connectivity = {
+  Standalone: "Standalone",
+  MultiConnected: "Multi-Connected",
+  Linked: "Linked",
+  Detached: "Detached",
+} as const;
+/**
+ * Building connectivity type (OS NGD `connectivity` canonicalised)
+ */
+export type Connectivity = OpenEnum<typeof Connectivity>;
+
+/**
+ * Structured construction age. Same shape as Property's `build.constructionAge`. Adapters parse source-native bands (EPC 'England and Wales: 1900-1929', OS NGD '1870-1918') into this envelope.
+ */
+export type Age = {
+  /**
+   * End year of construction period. Null for 'XXXX onwards' bands.
+   */
+  endYear: number | null;
+  /**
+   * Whether the construction date is an exact year (true) or a range (false).
+   */
+  isExact: boolean;
+  /**
+   * Midpoint year. Useful for approximate age calculations.
+   */
+  midYear: number | null;
+  /**
+   * Start year of construction period. Null for 'before XXXX' bands.
+   */
+  startYear: number | null;
+};
+
+export const BuildingSchemasDataSources = {
+  Paf: "paf",
+  Os: "os",
+  OsNgd: "os_ngd",
+  NgdAddresses: "ngd_addresses",
+  Epc: "epc",
+  Hmlr: "hmlr",
+  Voa: "voa",
+  Hmrc: "hmrc",
+  HistoricEngland: "historic_england",
+  Listing: "listing",
+  OpenData: "open_data",
+  Council: "council",
+} as const;
+export type BuildingSchemasDataSources = OpenEnum<
+  typeof BuildingSchemasDataSources
+>;
+
+/**
+ * Canonical wall construction type — same vocabulary as EPC's wall.construction across the system. Sources canonicalise into this enum via their adapter.
+ */
+export const WallConstruction = {
+  Cavity: "cavity",
+  SolidBrick: "solid_brick",
+  TimberFrame: "timber_frame",
+  SandstoneOrLimestone: "sandstone_or_limestone",
+  Sandstone: "sandstone",
+  GraniteOrWhinstone: "granite_or_whinstone",
+  Granite: "granite",
+  SystemBuilt: "system_built",
+  SolidStone: "solid_stone",
+  Cob: "cob",
+  ParkHome: "park_home",
+  Basement: "basement",
+  CurtainWall: "curtain_wall",
+} as const;
+/**
+ * Canonical wall construction type — same vocabulary as EPC's wall.construction across the system. Sources canonicalise into this enum via their adapter.
+ */
+export type WallConstruction = OpenEnum<typeof WallConstruction>;
+
+/**
+ * Construction age and materials (multi-source: OS NGD + EPC)
+ */
+export type Construction = {
+  /**
+   * Structured construction age. Same shape as Property's `build.constructionAge`. Adapters parse source-native bands (EPC 'England and Wales: 1900-1929', OS NGD '1870-1918') into this envelope.
+   */
+  age?: Age | null | undefined;
+  /**
+   * Sources that contributed to this sub-block
+   */
+  dataSources?: Array<BuildingSchemasDataSources> | undefined;
+  /**
+   * ISO date of the evidence supporting the construction values
+   */
+  evidenceDate?: string | null | undefined;
+  /**
+   * Source-native wall material description, for display.
+   */
+  materialDescription?: string | null | undefined;
+  /**
+   * Canonical wall construction type — same vocabulary as EPC's wall.construction across the system. Sources canonicalise into this enum via their adapter.
+   */
+  wallConstruction?: WallConstruction | null | undefined;
+  /**
+   * Construction year (exact or approximate)
+   */
+  year?: number | null | undefined;
+};
+
+export const DataSources = {
+  Paf: "paf",
+  Os: "os",
+  OsNgd: "os_ngd",
+  NgdAddresses: "ngd_addresses",
+  Epc: "epc",
+  Hmlr: "hmlr",
+  Voa: "voa",
+  Hmrc: "hmrc",
+  HistoricEngland: "historic_england",
+  Listing: "listing",
+  OpenData: "open_data",
+  Council: "council",
+} as const;
+export type DataSources = OpenEnum<typeof DataSources>;
+
+/**
+ * GeoJSON geometry type
+ */
+export const BuildingSchemasType = {
+  MultiPolygon: "MultiPolygon",
+} as const;
+/**
+ * GeoJSON geometry type
+ */
+export type BuildingSchemasType = ClosedEnum<typeof BuildingSchemasType>;
+
+/**
+ * GeoJSON MultiPolygon geometry
+ */
+export type GeoJSONMultiPolygon = {
+  /**
+   * Array of polygon coordinate arrays
+   */
+  coordinates: Array<Array<Array<Array<number>>>>;
+  /**
+   * GeoJSON geometry type
+   */
+  type: BuildingSchemasType;
+};
+
+/**
+ * GeoJSON geometry type
+ */
+export const BuildingSchemasFootprintType = {
+  Polygon: "Polygon",
+} as const;
+/**
+ * GeoJSON geometry type
+ */
+export type BuildingSchemasFootprintType = ClosedEnum<
+  typeof BuildingSchemasFootprintType
+>;
+
+/**
+ * GeoJSON Polygon geometry
+ */
+export type GeoJSONPolygon = {
+  /**
+   * Array of linear rings
+   */
+  coordinates: Array<Array<Array<number>>>;
+  /**
+   * GeoJSON geometry type
+   */
+  type: BuildingSchemasFootprintType;
+};
+
+/**
+ * Building footprint geometry in WGS84 (EPSG:4326). Excluded from the default attribute set for response size — request explicitly via `attributes: ["footprint"]`.
+ */
+export type Footprint = GeoJSONPolygon | GeoJSONMultiPolygon | any;
+
+/**
+ * Object type identifier
+ */
+export const BuildingObject = {
+  Building: "building",
+} as const;
+/**
+ * Object type identifier
+ */
+export type BuildingObject = ClosedEnum<typeof BuildingObject>;
+
+/**
+ * Physical state of the building (OS NGD `physicalstate` canonicalised)
+ */
+export const PhysicalState = {
+  Built: "Built",
+  Demolished: "Demolished",
+  Ruined: "Ruined",
+  UnderConstruction: "UnderConstruction",
+} as const;
+/**
+ * Physical state of the building (OS NGD `physicalstate` canonicalised)
+ */
+export type PhysicalState = OpenEnum<typeof PhysicalState>;
+
+/**
+ * Source registry / provider code
+ */
+export const Provider = {
+  Ngd: "NGD",
+  Bag: "BAG",
+  Osm: "OSM",
+  Hu: "HU",
+} as const;
+/**
+ * Source registry / provider code
+ */
+export type Provider = OpenEnum<typeof Provider>;
+
+export const BuildingSchemasRoofDataSources = {
+  Paf: "paf",
+  Os: "os",
+  OsNgd: "os_ngd",
+  NgdAddresses: "ngd_addresses",
+  Epc: "epc",
+  Hmlr: "hmlr",
+  Voa: "voa",
+  Hmrc: "hmrc",
+  HistoricEngland: "historic_england",
+  Listing: "listing",
+  OpenData: "open_data",
+  Council: "council",
+} as const;
+export type BuildingSchemasRoofDataSources = OpenEnum<
+  typeof BuildingSchemasRoofDataSources
+>;
+
+/**
+ * Green/living roof presence detected from aerial survey
+ */
+export const GreenRoof = {
+  Present: "present",
+  Absent: "absent",
+} as const;
+/**
+ * Green/living roof presence detected from aerial survey
+ */
+export type GreenRoof = OpenEnum<typeof GreenRoof>;
+
+/**
+ * Solar panel presence detected from aerial survey
+ */
+export const Solar = {
+  Present: "present",
+  Absent: "absent",
+} as const;
+/**
+ * Solar panel presence detected from aerial survey
+ */
+export type Solar = OpenEnum<typeof Solar>;
+
+/**
+ * Canonical roof type — same vocabulary as EPC's roof.roofType across the system. OS NGD's `roofshapeaspect_shape` canonicalises via its adapter; values that don't fit the enum drop to null.
+ */
+export const BuildingType = {
+  Pitched: "pitched",
+  Flat: "flat",
+  Thatched: "thatched",
+  AnotherDwellingAbove: "another_dwelling_above",
+  OtherPremisesAbove: "other_premises_above",
+  RoofRoom: "roof_room",
+} as const;
+/**
+ * Canonical roof type — same vocabulary as EPC's roof.roofType across the system. OS NGD's `roofshapeaspect_shape` canonicalises via its adapter; values that don't fit the enum drop to null.
+ */
+export type BuildingType = OpenEnum<typeof BuildingType>;
+
+/**
+ * Roof analysis — shape, materials, solar, green roof
+ */
+export type Roof = {
+  /**
+   * Sources that contributed to this sub-block
+   */
+  dataSources?: Array<BuildingSchemasRoofDataSources> | undefined;
+  /**
+   * Green/living roof presence detected from aerial survey
+   */
+  greenRoof?: GreenRoof | null | undefined;
+  /**
+   * Primary roof covering material
+   */
+  material?: string | null | undefined;
+  /**
+   * Solar panel presence detected from aerial survey
+   */
+  solar?: Solar | null | undefined;
+  /**
+   * Canonical roof type — same vocabulary as EPC's roof.roofType across the system. OS NGD's `roofshapeaspect_shape` canonicalises via its adapter; values that don't fit the enum drop to null.
+   */
+  type?: BuildingType | null | undefined;
+};
+
+export const Sources = {
+  Paf: "paf",
+  Os: "os",
+  OsNgd: "os_ngd",
+  NgdAddresses: "ngd_addresses",
+  Epc: "epc",
+  Hmlr: "hmlr",
+  Voa: "voa",
+  Hmrc: "hmrc",
+  HistoricEngland: "historic_england",
+  Listing: "listing",
+  OpenData: "open_data",
+  Council: "council",
+} as const;
+export type Sources = OpenEnum<typeof Sources>;
+
+/**
+ * Lifecycle state of the building record
+ */
+export const BuildingStatus = {
+  Active: "active",
+  Demolished: "demolished",
+  Pending: "pending",
+} as const;
+/**
+ * Lifecycle state of the building record
+ */
+export type BuildingStatus = OpenEnum<typeof BuildingStatus>;
+
+/**
+ * Building connectivity type (OS NGD `connectivity` canonicalised)
+ */
+export const BuildingConnectivity = {
+  Standalone: "Standalone",
+  MultiConnected: "Multi-Connected",
+  Linked: "Linked",
+  Detached: "Detached",
+} as const;
+/**
+ * Building connectivity type (OS NGD `connectivity` canonicalised)
+ */
+export type BuildingConnectivity = OpenEnum<typeof BuildingConnectivity>;
+
+export const BuildingSchemasStructureDataSources = {
+  Paf: "paf",
+  Os: "os",
+  OsNgd: "os_ngd",
+  NgdAddresses: "ngd_addresses",
+  Epc: "epc",
+  Hmlr: "hmlr",
+  Voa: "voa",
+  Hmrc: "hmrc",
+  HistoricEngland: "historic_england",
+  Listing: "listing",
+  OpenData: "open_data",
+  Council: "council",
+} as const;
+export type BuildingSchemasStructureDataSources = OpenEnum<
+  typeof BuildingSchemasStructureDataSources
+>;
+
+/**
+ * Physical state of the building (OS NGD `physicalstate` canonicalised)
+ */
+export const BuildingPhysicalState = {
+  Built: "Built",
+  Demolished: "Demolished",
+  Ruined: "Ruined",
+  UnderConstruction: "UnderConstruction",
+} as const;
+/**
+ * Physical state of the building (OS NGD `physicalstate` canonicalised)
+ */
+export type BuildingPhysicalState = OpenEnum<typeof BuildingPhysicalState>;
+
+/**
+ * Physical structure characteristics (OS NGD aerial / LIDAR)
+ */
+export type Structure = {
+  /**
+   * Building connectivity type (OS NGD `connectivity` canonicalised)
+   */
+  connectivity?: BuildingConnectivity | null | undefined;
+  /**
+   * Sources that contributed to this sub-block
+   */
+  dataSources?: Array<BuildingSchemasStructureDataSources> | undefined;
+  /**
+   * Number of above-ground floors
+   */
+  floors?: number | null | undefined;
+  /**
+   * Building footprint area in square metres
+   */
+  footprintAreaSqm?: number | null | undefined;
+  /**
+   * Maximum height above ground level in metres
+   */
+  heightMax?: number | null | undefined;
+  /**
+   * Height to the base of the roof in metres
+   */
+  heightRoofBase?: number | null | undefined;
+  /**
+   * Physical state of the building (OS NGD `physicalstate` canonicalised)
+   */
+  physicalState?: BuildingPhysicalState | null | undefined;
+};
+
+export type Building = {
+  /**
+   * Counts of linked addresses by classification
+   */
+  addressCount?: AddressCount | null | undefined;
+  /**
+   * Linked address records (UPRN + classification + address line). Excluded from the default attribute set — request explicitly via `attributes: ["addresses"]`.
+   */
+  addresses?: Array<BuildingAddressLink> | null | undefined;
+  /**
+   * Footprint area in square metres, derived from the polygon
+   */
+  areaSqm?: number | null | undefined;
+  /**
+   * Basement detection
+   */
+  basement?: Basement | null | undefined;
+  /**
+   * Composite building identifier `{country}:{provider}:{externalId}`
+   */
+  buildingId: string;
+  /**
+   * Primary use as reported by OS NGD
+   */
+  buildingUse?: string | null | undefined;
+  /**
+   * OS NGD `oslandusetiera` broader category
+   */
+  buildingUseTierA?: string | null | undefined;
+  /**
+   * Centroid of the footprint in WGS84
+   */
+  centroid?: Coordinates | null | undefined;
+  /**
+   * Building connectivity type (OS NGD `connectivity` canonicalised)
+   */
+  connectivity?: Connectivity | null | undefined;
+  /**
+   * Construction age and materials (multi-source: OS NGD + EPC)
+   */
+  construction?: Construction | null | undefined;
+  /**
+   * ISO 3166-1 alpha-2 country code
+   */
+  country: string;
+  /**
+   * Top-level summary of sources used by this aggregation
+   */
+  dataSources?: Array<DataSources> | undefined;
+  /**
+   * Raw source identifier (e.g. OS NGD `osid`)
+   */
+  externalId: string;
+  /**
+   * Number of above-ground floors
+   */
+  floors?: number | null | undefined;
+  /**
+   * Building footprint geometry in WGS84 (EPSG:4326). Excluded from the default attribute set for response size — request explicitly via `attributes: ["footprint"]`.
+   */
+  footprint?: GeoJSONPolygon | GeoJSONMultiPolygon | any | null | undefined;
+  /**
+   * Maximum building height in metres
+   */
+  heightMax?: number | null | undefined;
+  /**
+   * Roof-base height in metres
+   */
+  heightRoofBase?: number | null | undefined;
+  /**
+   * UTC datetime of the latest Elasticsearch write
+   */
+  indexedAt?: string | null | undefined;
+  /**
+   * UPRNs linked to this building via the OS NGD address crossref. Returned in the default attribute set; the full address records are only included on request via `attributes: ["addresses"]`.
+   */
+  locationIds?: Array<string> | undefined;
+  /**
+   * Object type identifier
+   */
+  object: BuildingObject;
+  /**
+   * Number of building parts associated with this building
+   */
+  partCount: number;
+  /**
+   * Building parts linked to this building. Excluded from the default attribute set — request explicitly via `attributes: ["parts"]`.
+   */
+  parts?: Array<BuildingPart> | null | undefined;
+  /**
+   * Physical state of the building (OS NGD `physicalstate` canonicalised)
+   */
+  physicalState?: PhysicalState | null | undefined;
+  /**
+   * Source registry / provider code
+   */
+  provider: Provider;
+  /**
+   * UTC date the building was first observed in any source feed
+   */
+  registeredAt?: string | null | undefined;
+  /**
+   * Roof analysis — shape, materials, solar, green roof
+   */
+  roof?: Roof | null | undefined;
+  /**
+   * UTC date of the latest source feed version contributing to this record
+   */
+  sourceUpdatedAt?: string | null | undefined;
+  /**
+   * All data sources that contributed at least one field to this building
+   */
+  sources: Array<Sources>;
+  /**
+   * Lifecycle state of the building record
+   */
+  status: BuildingStatus;
+  /**
+   * Physical structure characteristics (OS NGD aerial / LIDAR)
+   */
+  structure?: Structure | null | undefined;
+  /**
+   * OS NGD building description / type
+   */
+  type?: string | null | undefined;
+  /**
+   * UTC datetime when this record was last aggregated
+   */
+  updatedAt?: string | null | undefined;
+};
+
+/** @internal */
+export const AddressCount$inboundSchema: z.ZodType<
+  AddressCount,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  commercial: z.nullable(z.number().int()).optional(),
+  other: z.nullable(z.number().int()).optional(),
+  residential: z.nullable(z.number().int()).optional(),
+  total: z.nullable(z.number().int()).optional(),
+});
+
+export function addressCountFromJSON(
+  jsonString: string,
+): SafeParseResult<AddressCount, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AddressCount$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AddressCount' from JSON`,
+  );
+}
+
+/** @internal */
+export const BuildingDataSources$inboundSchema: z.ZodType<
+  BuildingDataSources,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(BuildingDataSources);
+
+/** @internal */
+export const Present$inboundSchema: z.ZodType<Present, z.ZodTypeDef, unknown> =
+  openEnums.inboundSchema(Present);
+
+/** @internal */
+export const SelfContained$inboundSchema: z.ZodType<
+  SelfContained,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(SelfContained);
+
+/** @internal */
+export const Basement$inboundSchema: z.ZodType<
+  Basement,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  dataSources: z.array(BuildingDataSources$inboundSchema).optional(),
+  present: z.nullable(Present$inboundSchema).optional(),
+  selfContained: z.nullable(SelfContained$inboundSchema).optional(),
+});
+
+export function basementFromJSON(
+  jsonString: string,
+): SafeParseResult<Basement, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Basement$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Basement' from JSON`,
+  );
+}
+
+/** @internal */
+export const Coordinates$inboundSchema: z.ZodType<
+  Coordinates,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  lat: z.number(),
+  lng: z.number(),
+});
+
+export function coordinatesFromJSON(
+  jsonString: string,
+): SafeParseResult<Coordinates, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Coordinates$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Coordinates' from JSON`,
+  );
+}
+
+/** @internal */
+export const Connectivity$inboundSchema: z.ZodType<
+  Connectivity,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(Connectivity);
+
+/** @internal */
+export const Age$inboundSchema: z.ZodType<Age, z.ZodTypeDef, unknown> = z
+  .object({
+    endYear: z.nullable(z.number().int()),
+    isExact: z.boolean(),
+    midYear: z.nullable(z.number().int()),
+    startYear: z.nullable(z.number().int()),
+  });
+
+export function ageFromJSON(
+  jsonString: string,
+): SafeParseResult<Age, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Age$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Age' from JSON`,
+  );
+}
+
+/** @internal */
+export const BuildingSchemasDataSources$inboundSchema: z.ZodType<
+  BuildingSchemasDataSources,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(BuildingSchemasDataSources);
+
+/** @internal */
+export const WallConstruction$inboundSchema: z.ZodType<
+  WallConstruction,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(WallConstruction);
+
+/** @internal */
+export const Construction$inboundSchema: z.ZodType<
+  Construction,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  age: z.nullable(z.lazy(() => Age$inboundSchema)).optional(),
+  dataSources: z.array(BuildingSchemasDataSources$inboundSchema).optional(),
+  evidenceDate: z.nullable(z.string()).optional(),
+  materialDescription: z.nullable(z.string()).optional(),
+  wallConstruction: z.nullable(WallConstruction$inboundSchema).optional(),
+  year: z.nullable(z.number().int()).optional(),
+});
+
+export function constructionFromJSON(
+  jsonString: string,
+): SafeParseResult<Construction, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Construction$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Construction' from JSON`,
+  );
+}
+
+/** @internal */
+export const DataSources$inboundSchema: z.ZodType<
+  DataSources,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(DataSources);
+
+/** @internal */
+export const BuildingSchemasType$inboundSchema: z.ZodNativeEnum<
+  typeof BuildingSchemasType
+> = z.nativeEnum(BuildingSchemasType);
+
+/** @internal */
+export const GeoJSONMultiPolygon$inboundSchema: z.ZodType<
+  GeoJSONMultiPolygon,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  coordinates: z.array(z.array(z.array(z.array(z.number())))),
+  type: BuildingSchemasType$inboundSchema,
+});
+
+export function geoJSONMultiPolygonFromJSON(
+  jsonString: string,
+): SafeParseResult<GeoJSONMultiPolygon, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GeoJSONMultiPolygon$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GeoJSONMultiPolygon' from JSON`,
+  );
+}
+
+/** @internal */
+export const BuildingSchemasFootprintType$inboundSchema: z.ZodNativeEnum<
+  typeof BuildingSchemasFootprintType
+> = z.nativeEnum(BuildingSchemasFootprintType);
+
+/** @internal */
+export const GeoJSONPolygon$inboundSchema: z.ZodType<
+  GeoJSONPolygon,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  coordinates: z.array(z.array(z.array(z.number()))),
+  type: BuildingSchemasFootprintType$inboundSchema,
+});
+
+export function geoJSONPolygonFromJSON(
+  jsonString: string,
+): SafeParseResult<GeoJSONPolygon, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GeoJSONPolygon$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GeoJSONPolygon' from JSON`,
+  );
+}
+
+/** @internal */
+export const Footprint$inboundSchema: z.ZodType<
+  Footprint,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  z.lazy(() => GeoJSONPolygon$inboundSchema),
+  z.lazy(() => GeoJSONMultiPolygon$inboundSchema),
+  z.any(),
+]);
+
+export function footprintFromJSON(
+  jsonString: string,
+): SafeParseResult<Footprint, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Footprint$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Footprint' from JSON`,
+  );
+}
+
+/** @internal */
+export const BuildingObject$inboundSchema: z.ZodNativeEnum<
+  typeof BuildingObject
+> = z.nativeEnum(BuildingObject);
+
+/** @internal */
+export const PhysicalState$inboundSchema: z.ZodType<
+  PhysicalState,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(PhysicalState);
+
+/** @internal */
+export const Provider$inboundSchema: z.ZodType<
+  Provider,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(Provider);
+
+/** @internal */
+export const BuildingSchemasRoofDataSources$inboundSchema: z.ZodType<
+  BuildingSchemasRoofDataSources,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(BuildingSchemasRoofDataSources);
+
+/** @internal */
+export const GreenRoof$inboundSchema: z.ZodType<
+  GreenRoof,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(GreenRoof);
+
+/** @internal */
+export const Solar$inboundSchema: z.ZodType<Solar, z.ZodTypeDef, unknown> =
+  openEnums.inboundSchema(Solar);
+
+/** @internal */
+export const BuildingType$inboundSchema: z.ZodType<
+  BuildingType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(BuildingType);
+
+/** @internal */
+export const Roof$inboundSchema: z.ZodType<Roof, z.ZodTypeDef, unknown> = z
+  .object({
+    dataSources: z.array(BuildingSchemasRoofDataSources$inboundSchema)
+      .optional(),
+    greenRoof: z.nullable(GreenRoof$inboundSchema).optional(),
+    material: z.nullable(z.string()).optional(),
+    solar: z.nullable(Solar$inboundSchema).optional(),
+    type: z.nullable(BuildingType$inboundSchema).optional(),
+  });
+
+export function roofFromJSON(
+  jsonString: string,
+): SafeParseResult<Roof, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Roof$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Roof' from JSON`,
+  );
+}
+
+/** @internal */
+export const Sources$inboundSchema: z.ZodType<Sources, z.ZodTypeDef, unknown> =
+  openEnums.inboundSchema(Sources);
+
+/** @internal */
+export const BuildingStatus$inboundSchema: z.ZodType<
+  BuildingStatus,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(BuildingStatus);
+
+/** @internal */
+export const BuildingConnectivity$inboundSchema: z.ZodType<
+  BuildingConnectivity,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(BuildingConnectivity);
+
+/** @internal */
+export const BuildingSchemasStructureDataSources$inboundSchema: z.ZodType<
+  BuildingSchemasStructureDataSources,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(BuildingSchemasStructureDataSources);
+
+/** @internal */
+export const BuildingPhysicalState$inboundSchema: z.ZodType<
+  BuildingPhysicalState,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(BuildingPhysicalState);
+
+/** @internal */
+export const Structure$inboundSchema: z.ZodType<
+  Structure,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  connectivity: z.nullable(BuildingConnectivity$inboundSchema).optional(),
+  dataSources: z.array(BuildingSchemasStructureDataSources$inboundSchema)
+    .optional(),
+  floors: z.nullable(z.number().int()).optional(),
+  footprintAreaSqm: z.nullable(z.number()).optional(),
+  heightMax: z.nullable(z.number()).optional(),
+  heightRoofBase: z.nullable(z.number()).optional(),
+  physicalState: z.nullable(BuildingPhysicalState$inboundSchema).optional(),
+});
+
+export function structureFromJSON(
+  jsonString: string,
+): SafeParseResult<Structure, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Structure$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Structure' from JSON`,
+  );
+}
+
+/** @internal */
+export const Building$inboundSchema: z.ZodType<
+  Building,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  addressCount: z.nullable(z.lazy(() => AddressCount$inboundSchema)).optional(),
+  addresses: z.nullable(z.array(BuildingAddressLink$inboundSchema)).optional(),
+  areaSqm: z.nullable(z.number()).optional(),
+  basement: z.nullable(z.lazy(() => Basement$inboundSchema)).optional(),
+  buildingId: z.string(),
+  buildingUse: z.nullable(z.string()).optional(),
+  buildingUseTierA: z.nullable(z.string()).optional(),
+  centroid: z.nullable(z.lazy(() => Coordinates$inboundSchema)).optional(),
+  connectivity: z.nullable(Connectivity$inboundSchema).optional(),
+  construction: z.nullable(z.lazy(() => Construction$inboundSchema)).optional(),
+  country: z.string(),
+  dataSources: z.array(DataSources$inboundSchema).optional(),
+  externalId: z.string(),
+  floors: z.nullable(z.number().int()).optional(),
+  footprint: z.nullable(
+    z.union([
+      z.lazy(() => GeoJSONPolygon$inboundSchema),
+      z.lazy(() => GeoJSONMultiPolygon$inboundSchema),
+      z.any(),
+    ]),
+  ).optional(),
+  heightMax: z.nullable(z.number()).optional(),
+  heightRoofBase: z.nullable(z.number()).optional(),
+  indexedAt: z.nullable(z.string()).optional(),
+  locationIds: z.array(z.string()).optional(),
+  object: BuildingObject$inboundSchema,
+  partCount: z.number().int().default(0),
+  parts: z.nullable(z.array(BuildingPart$inboundSchema)).optional(),
+  physicalState: z.nullable(PhysicalState$inboundSchema).optional(),
+  provider: Provider$inboundSchema,
+  registeredAt: z.nullable(z.string()).optional(),
+  roof: z.nullable(z.lazy(() => Roof$inboundSchema)).optional(),
+  sourceUpdatedAt: z.nullable(z.string()).optional(),
+  sources: z.array(Sources$inboundSchema),
+  status: BuildingStatus$inboundSchema,
+  structure: z.nullable(z.lazy(() => Structure$inboundSchema)).optional(),
+  type: z.nullable(z.string()).optional(),
+  updatedAt: z.nullable(z.string()).optional(),
+});
+
+export function buildingFromJSON(
+  jsonString: string,
+): SafeParseResult<Building, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Building$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Building' from JSON`,
+  );
+}