@vepler/sdk 3.0.0 → 5.28.1

package/dist/commonjs/sdk/models/shared/epcdata.d.ts

@@ -3,7 +3,7 @@ import { ClosedEnum, OpenEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 /**
- * Certificate type
+ * Which kind of certificate this is: domestic, non-domestic, or a display energy certificate.
  */
 export declare const CertificateType: {
     readonly Domestic: "domestic";
@@ -11,11 +11,11 @@ export declare const CertificateType: {
     readonly Dec: "dec";
 };
 /**
- * Certificate type
+ * Which kind of certificate this is: domestic, non-domestic, or a display energy certificate.
  */
 export type CertificateType = OpenEnum<typeof CertificateType>;
 /**
- * Current EPC rating band
+ * Energy efficiency band on the current certificate, where A+ and A are the most efficient and G the least.
  */
 export declare const CurrentRatingBand: {
     readonly APlus: "A+";
@@ -33,74 +33,74 @@ export declare const CurrentRatingBand: {
     readonly G: "G";
 };
 /**
- * Current EPC rating band
+ * Energy efficiency band on the current certificate, where A+ and A are the most efficient and G the least.
  */
 export type CurrentRatingBand = OpenEnum<typeof CurrentRatingBand>;
 /**
- * Unit of co2Current measurement. Domestic: tonnes_per_year. Non-domestic/DEC: kg_co2_per_m2_per_year.
+ * The unit `co2Current` is expressed in. Domestic certificates use `tonnes_per_year`; non-domestic certificates and Display Energy Certificates use `kg_co2_per_m2_per_year`.
  */
 export declare const Co2Unit: {
     readonly TonnesPerYear: "tonnes_per_year";
     readonly KgCo2PerM2PerYear: "kg_co2_per_m2_per_year";
 };
 /**
- * Unit of co2Current measurement. Domestic: tonnes_per_year. Non-domestic/DEC: kg_co2_per_m2_per_year.
+ * The unit `co2Current` is expressed in. Domestic certificates use `tonnes_per_year`; non-domestic certificates and Display Energy Certificates use `kg_co2_per_m2_per_year`.
  */
 export type Co2Unit = OpenEnum<typeof Co2Unit>;
 /**
- * Unit of energyConsumptionCurrent measurement.
+ * The unit `energyConsumptionCurrent` is expressed in.
  */
 export declare const EnergyConsumptionUnit: {
     readonly KwhPerYear: "kwh_per_year";
     readonly KwhPerM2PerYear: "kwh_per_m2_per_year";
 };
 /**
- * Unit of energyConsumptionCurrent measurement.
+ * The unit `energyConsumptionCurrent` is expressed in.
  */
 export type EnergyConsumptionUnit = OpenEnum<typeof EnergyConsumptionUnit>;
 /**
- * Environmental impact, CO2, energy consumption
+ * Environmental impact, carbon dioxide emissions and energy consumption from the certificate.
  */
 export type Emissions = {
     /**
-     * Current annual CO2 emissions. Domestic: tonnes/year. Non-domestic: kg CO2/m²/year (building emission rate). Check co2Unit for the measurement unit.
+     * Annual carbon dioxide emissions at the assessed efficiency. Domestic certificates report tonnes per year and non-domestic certificates report kg CO2 per m² per year; read `co2Unit` for the unit that applies to this record.
      */
-    co2Current: number | null;
+    co2Current?: number | null | undefined;
     /**
-     * CO2 intensity per unit floor area (kg CO2/m²/year). Directly reported for domestic (CO2_EMISS_CURR_PER_FLOOR_AREA). For non-domestic, this equals BUILDING_EMISSIONS.
+     * Annual carbon dioxide emissions per square metre of floor area, in kg CO2 per m² per year. On non-domestic certificates this is the building emission rate.
      */
-    co2PerFloorArea: number | null;
+    co2PerFloorArea?: number | null | undefined;
     /**
-     * Achievable CO2 emissions after improvements. Domestic only; null for non-domestic and DECs.
+     * Annual carbon dioxide emissions once the recommended improvements are carried out. Domestic only; null on non-domestic certificates and Display Energy Certificates.
      */
-    co2Potential: number | null;
+    co2Potential?: number | null | undefined;
     /**
-     * Unit of co2Current measurement. Domestic: tonnes_per_year. Non-domestic/DEC: kg_co2_per_m2_per_year.
+     * The unit `co2Current` is expressed in. Domestic certificates use `tonnes_per_year`; non-domestic certificates and Display Energy Certificates use `kg_co2_per_m2_per_year`.
      */
-    co2Unit: Co2Unit;
+    co2Unit?: Co2Unit | undefined;
     /**
-     * Current annual energy consumption. Domestic: kWh/year. Non-domestic: kWh/m²/year (PRIMARY_ENERGY_VALUE). Check energyConsumptionUnit for measurement unit.
+     * Annual energy consumption at the assessed efficiency. Domestic certificates report kWh per year and non-domestic certificates report kWh per m² per year; read `energyConsumptionUnit` for the unit that applies to this record.
      */
-    energyConsumptionCurrent: number | null;
+    energyConsumptionCurrent?: number | null | undefined;
     /**
-     * Achievable energy consumption. Domestic only.
+     * Annual energy consumption once the recommended improvements are carried out. Domestic only.
      */
-    energyConsumptionPotential: number | null;
+    energyConsumptionPotential?: number | null | undefined;
     /**
-     * Unit of energyConsumptionCurrent measurement.
+     * The unit `energyConsumptionCurrent` is expressed in.
      */
-    energyConsumptionUnit: EnergyConsumptionUnit | null;
+    energyConsumptionUnit?: EnergyConsumptionUnit | null | undefined;
     /**
-     * Environmental impact score (1-100, higher is better). Domestic only.
+     * Environmental impact score from 1 to 100, where higher is better. Domestic only.
      */
-    environmentalScoreCurrent: number | null;
+    environmentalScoreCurrent?: number | null | undefined;
     /**
-     * Achievable environmental impact score. Domestic only.
+     * The environmental impact score the property would reach once the recommended improvements are carried out, on the same 1 to 100 scale. Domestic only.
      */
-    environmentalScorePotential: number | null;
+    environmentalScorePotential?: number | null | undefined;
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export declare const EnergyEfficiency: {
     readonly VeryGood: "very_good";
@@ -110,11 +110,11 @@ export declare const EnergyEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EnergyEfficiency = OpenEnum<typeof EnergyEfficiency>;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export declare const EnvironmentalEfficiency: {
     readonly VeryGood: "very_good";
@@ -124,28 +124,28 @@ export declare const EnvironmentalEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EnvironmentalEfficiency = OpenEnum<typeof EnvironmentalEfficiency>;
 /**
- * Air tightness assessment. Scotland only; null for E&W.
+ * The air tightness assessment. Scotland only; null on England and Wales certificates.
  */
 export type AirTightness = {
     /**
-     * SAP description string from assessor.
+     * The assessor's own description of this component, as written on the certificate.
      */
-    description: string | null;
+    description?: string | null | undefined;
     /**
-     * Energy efficiency rating.
+     * How energy efficient this component is, on the certificate's five-point scale.
      */
-    energyEfficiency: EnergyEfficiency | null;
+    energyEfficiency?: EnergyEfficiency | null | undefined;
     /**
-     * Environmental efficiency rating.
+     * How this component scores for environmental impact, on the certificate's five-point scale.
      */
-    environmentalEfficiency: EnvironmentalEfficiency | null;
+    environmentalEfficiency?: EnvironmentalEfficiency | null | undefined;
 };
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export declare const EPCDataSchemasFabricFloorDataQuality: {
     readonly TruncatedThermalTransmittance: "truncated_thermal_transmittance";
@@ -155,11 +155,11 @@ export declare const EPCDataSchemasFabricFloorDataQuality: {
     readonly SourceError: "source_error";
 };
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export type EPCDataSchemasFabricFloorDataQuality = OpenEnum<typeof EPCDataSchemasFabricFloorDataQuality>;
 /**
- * Energy efficiency rating.
+ * How energy efficient the floor is, on the certificate's five-point scale.
  */
 export declare const EPCDataEnergyEfficiency: {
     readonly VeryGood: "very_good";
@@ -169,11 +169,11 @@ export declare const EPCDataEnergyEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient the floor is, on the certificate's five-point scale.
  */
 export type EPCDataEnergyEfficiency = OpenEnum<typeof EPCDataEnergyEfficiency>;
 /**
- * Environmental efficiency rating.
+ * How the floor scores for environmental impact, on the certificate's five-point scale.
  */
 export declare const EPCDataEnvironmentalEfficiency: {
     readonly VeryGood: "very_good";
@@ -183,11 +183,11 @@ export declare const EPCDataEnvironmentalEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Environmental efficiency rating.
+ * How the floor scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataEnvironmentalEfficiency = OpenEnum<typeof EPCDataEnvironmentalEfficiency>;
 /**
- * Floor type: solid, suspended_timber, suspended_sealed, another_dwelling_below, other_premises_below.
+ * How the ground floor is built, including the cases where another dwelling or premises sits below.
  */
 export declare const FloorType: {
     readonly Solid: "solid";
@@ -197,11 +197,11 @@ export declare const FloorType: {
     readonly OtherPremisesBelow: "other_premises_below";
 };
 /**
- * Floor type: solid, suspended_timber, suspended_sealed, another_dwelling_below, other_premises_below.
+ * How the ground floor is built, including the cases where another dwelling or premises sits below.
  */
 export type FloorType = OpenEnum<typeof FloorType>;
 /**
- * Insulation type if present.
+ * How the floor is insulated, where insulation is present.
  */
 export declare const InsulationType: {
     readonly None: "none";
@@ -217,52 +217,52 @@ export declare const InsulationType: {
     readonly Rafter: "rafter";
 };
 /**
- * Insulation type if present.
+ * How the floor is insulated, where insulation is present.
  */
 export type InsulationType = OpenEnum<typeof InsulationType>;
 /**
- * Ground floor construction and insulation.
+ * The ground floor and its insulation.
  */
 export type Floor = {
     /**
-     * Non-null when source value was corrupted/incomplete.
+     * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
      */
-    dataQuality: EPCDataSchemasFabricFloorDataQuality | null;
+    dataQuality?: EPCDataSchemasFabricFloorDataQuality | null | undefined;
     /**
-     * Raw SAP description string.
+     * The assessor's own description of the floor, as written on the certificate.
      */
-    description: string | null;
+    description?: string | null | undefined;
     /**
-     * Energy efficiency rating.
+     * How energy efficient the floor is, on the certificate's five-point scale.
      */
-    energyEfficiency: EPCDataEnergyEfficiency | null;
+    energyEfficiency?: EPCDataEnergyEfficiency | null | undefined;
     /**
-     * Environmental efficiency rating.
+     * How the floor scores for environmental impact, on the certificate's five-point scale.
      */
-    environmentalEfficiency: EPCDataEnvironmentalEfficiency | null;
+    environmentalEfficiency?: EPCDataEnvironmentalEfficiency | null | undefined;
     /**
-     * Floor type: solid, suspended_timber, suspended_sealed, another_dwelling_below, other_premises_below.
+     * How the ground floor is built, including the cases where another dwelling or premises sits below.
      */
-    floorType: FloorType | null;
+    floorType?: FloorType | null | undefined;
     /**
-     * Whether insulation status is assumed.
+     * True when the assessor assumed the insulation rather than confirming it.
      */
-    insulationAssumed: boolean;
+    insulationAssumed?: boolean | undefined;
     /**
-     * Whether floor insulation is present.
+     * True when the floor is insulated.
      */
-    insulationPresent: boolean | null;
+    insulationPresent?: boolean | null | undefined;
     /**
-     * Insulation type if present.
+     * How the floor is insulated, where insulation is present.
      */
-    insulationType: InsulationType | null;
+    insulationType?: InsulationType | null | undefined;
     /**
-     * U-value in W/m²K if reported.
+     * Thermal transmittance (U-value) of the floor, in W/m²K, where the assessment reports one.
      */
-    thermalTransmittance: number | null;
+    thermalTransmittance?: number | null | undefined;
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasEnergyEfficiency: {
     readonly VeryGood: "very_good";
@@ -272,11 +272,11 @@ export declare const EPCDataSchemasEnergyEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasEnergyEfficiency = OpenEnum<typeof EPCDataSchemasEnergyEfficiency>;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasEnvironmentalEfficiency: {
     readonly VeryGood: "very_good";
@@ -286,28 +286,28 @@ export declare const EPCDataSchemasEnvironmentalEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasEnvironmentalEfficiency = OpenEnum<typeof EPCDataSchemasEnvironmentalEfficiency>;
 /**
- * Heating control system.
+ * How the heating is controlled.
  */
 export type HeatingControls = {
     /**
-     * SAP description string from assessor.
+     * The assessor's own description of this component, as written on the certificate.
      */
-    description: string | null;
+    description?: string | null | undefined;
     /**
-     * Energy efficiency rating.
+     * How energy efficient this component is, on the certificate's five-point scale.
      */
-    energyEfficiency: EPCDataSchemasEnergyEfficiency | null;
+    energyEfficiency?: EPCDataSchemasEnergyEfficiency | null | undefined;
     /**
-     * Environmental efficiency rating.
+     * How this component scores for environmental impact, on the certificate's five-point scale.
      */
-    environmentalEfficiency: EPCDataSchemasEnvironmentalEfficiency | null;
+    environmentalEfficiency?: EPCDataSchemasEnvironmentalEfficiency | null | undefined;
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricEnergyEfficiency: {
     readonly VeryGood: "very_good";
@@ -317,11 +317,11 @@ export declare const EPCDataSchemasFabricEnergyEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricEnergyEfficiency = OpenEnum<typeof EPCDataSchemasFabricEnergyEfficiency>;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricEnvironmentalEfficiency: {
     readonly VeryGood: "very_good";
@@ -331,28 +331,28 @@ export declare const EPCDataSchemasFabricEnvironmentalEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricEnvironmentalEfficiency = OpenEnum<typeof EPCDataSchemasFabricEnvironmentalEfficiency>;
 /**
- * Hot water system.
+ * The hot water system.
  */
 export type HotWater = {
     /**
-     * SAP description string from assessor.
+     * The assessor's own description of this component, as written on the certificate.
      */
-    description: string | null;
+    description?: string | null | undefined;
     /**
-     * Energy efficiency rating.
+     * How energy efficient this component is, on the certificate's five-point scale.
      */
-    energyEfficiency: EPCDataSchemasFabricEnergyEfficiency | null;
+    energyEfficiency?: EPCDataSchemasFabricEnergyEfficiency | null | undefined;
     /**
-     * Environmental efficiency rating.
+     * How this component scores for environmental impact, on the certificate's five-point scale.
      */
-    environmentalEfficiency: EPCDataSchemasFabricEnvironmentalEfficiency | null;
+    environmentalEfficiency?: EPCDataSchemasFabricEnvironmentalEfficiency | null | undefined;
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricLightingEnergyEfficiency: {
     readonly VeryGood: "very_good";
@@ -362,11 +362,11 @@ export declare const EPCDataSchemasFabricLightingEnergyEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricLightingEnergyEfficiency = OpenEnum<typeof EPCDataSchemasFabricLightingEnergyEfficiency>;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricLightingEnvironmentalEfficiency: {
     readonly VeryGood: "very_good";
@@ -376,28 +376,28 @@ export declare const EPCDataSchemasFabricLightingEnvironmentalEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricLightingEnvironmentalEfficiency = OpenEnum<typeof EPCDataSchemasFabricLightingEnvironmentalEfficiency>;
 /**
- * Lighting system.
+ * The lighting installed.
  */
 export type Lighting = {
     /**
-     * SAP description string from assessor.
+     * The assessor's own description of this component, as written on the certificate.
      */
-    description: string | null;
+    description?: string | null | undefined;
     /**
-     * Energy efficiency rating.
+     * How energy efficient this component is, on the certificate's five-point scale.
      */
-    energyEfficiency: EPCDataSchemasFabricLightingEnergyEfficiency | null;
+    energyEfficiency?: EPCDataSchemasFabricLightingEnergyEfficiency | null | undefined;
     /**
-     * Environmental efficiency rating.
+     * How this component scores for environmental impact, on the certificate's five-point scale.
      */
-    environmentalEfficiency: EPCDataSchemasFabricLightingEnvironmentalEfficiency | null;
+    environmentalEfficiency?: EPCDataSchemasFabricLightingEnvironmentalEfficiency | null | undefined;
 };
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export declare const EPCDataDataQuality: {
     readonly TruncatedThermalTransmittance: "truncated_thermal_transmittance";
@@ -407,11 +407,11 @@ export declare const EPCDataDataQuality: {
     readonly SourceError: "source_error";
 };
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export type EPCDataDataQuality = OpenEnum<typeof EPCDataDataQuality>;
 /**
- * Energy efficiency rating.
+ * How energy efficient the heating system is, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricMainHeatingEnergyEfficiency: {
     readonly VeryGood: "very_good";
@@ -421,11 +421,11 @@ export declare const EPCDataSchemasFabricMainHeatingEnergyEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient the heating system is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricMainHeatingEnergyEfficiency = OpenEnum<typeof EPCDataSchemasFabricMainHeatingEnergyEfficiency>;
 /**
- * Environmental efficiency rating.
+ * How the heating system scores for environmental impact, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricMainHeatingEnvironmentalEfficiency: {
     readonly VeryGood: "very_good";
@@ -435,11 +435,11 @@ export declare const EPCDataSchemasFabricMainHeatingEnvironmentalEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Environmental efficiency rating.
+ * How the heating system scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricMainHeatingEnvironmentalEfficiency = OpenEnum<typeof EPCDataSchemasFabricMainHeatingEnvironmentalEfficiency>;
 /**
- * Fuel type for this heating system.
+ * The fuel this heating system runs on.
  */
 export declare const Fuel: {
     readonly MainsGas: "mains_gas";
@@ -458,11 +458,11 @@ export declare const Fuel: {
     readonly Other: "other";
 };
 /**
- * Fuel type for this heating system.
+ * The fuel this heating system runs on.
  */
 export type Fuel = OpenEnum<typeof Fuel>;
 /**
- * Heat pump type if applicable: air_source, ground_source, water_source.
+ * Where the heat pump draws its heat from, where the system is a heat pump.
  */
 export declare const HeatPumpType: {
     readonly AirSource: "air_source";
@@ -470,11 +470,11 @@ export declare const HeatPumpType: {
     readonly WaterSource: "water_source";
 };
 /**
- * Heat pump type if applicable: air_source, ground_source, water_source.
+ * Where the heat pump draws its heat from, where the system is a heat pump.
  */
 export type HeatPumpType = OpenEnum<typeof HeatPumpType>;
 /**
- * Heating system type: boiler_radiators, storage_heaters, heat_pump_radiators, etc.
+ * What kind of main heating system is installed.
  */
 export declare const SystemType: {
     readonly BoilerRadiators: "boiler_radiators";
@@ -490,48 +490,48 @@ export declare const SystemType: {
     readonly NoneAssumed: "none_assumed";
 };
 /**
- * Heating system type: boiler_radiators, storage_heaters, heat_pump_radiators, etc.
+ * What kind of main heating system is installed.
  */
 export type SystemType = OpenEnum<typeof SystemType>;
 /**
- * Main heating system.
+ * The main heating system.
  */
 export type MainHeating = {
     /**
-     * Non-null when source value was corrupted/incomplete.
+     * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
      */
-    dataQuality: EPCDataDataQuality | null;
+    dataQuality?: EPCDataDataQuality | null | undefined;
     /**
-     * Raw SAP description string.
+     * The assessor's own description of the heating system, as written on the certificate.
      */
-    description: string | null;
+    description?: string | null | undefined;
     /**
-     * Energy efficiency rating.
+     * How energy efficient the heating system is, on the certificate's five-point scale.
      */
-    energyEfficiency: EPCDataSchemasFabricMainHeatingEnergyEfficiency | null;
+    energyEfficiency?: EPCDataSchemasFabricMainHeatingEnergyEfficiency | null | undefined;
     /**
-     * Environmental efficiency rating.
+     * How the heating system scores for environmental impact, on the certificate's five-point scale.
      */
-    environmentalEfficiency: EPCDataSchemasFabricMainHeatingEnvironmentalEfficiency | null;
+    environmentalEfficiency?: EPCDataSchemasFabricMainHeatingEnvironmentalEfficiency | null | undefined;
     /**
-     * Fuel type for this heating system.
+     * The fuel this heating system runs on.
      */
-    fuel: Fuel | null;
+    fuel?: Fuel | null | undefined;
     /**
-     * Heat pump type if applicable: air_source, ground_source, water_source.
+     * Where the heat pump draws its heat from, where the system is a heat pump.
      */
-    heatPumpType: HeatPumpType | null;
+    heatPumpType?: HeatPumpType | null | undefined;
     /**
-     * Whether this property has multiple heating systems.
+     * True when the certificate records more than one heating system.
      */
-    isMultiSystem: boolean;
+    isMultiSystem?: boolean | undefined;
     /**
-     * Heating system type: boiler_radiators, storage_heaters, heat_pump_radiators, etc.
+     * What kind of main heating system is installed.
      */
-    systemType: SystemType | null;
+    systemType?: SystemType | null | undefined;
 };
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export declare const EPCDataSchemasDataQuality: {
     readonly TruncatedThermalTransmittance: "truncated_thermal_transmittance";
@@ -541,11 +541,11 @@ export declare const EPCDataSchemasDataQuality: {
     readonly SourceError: "source_error";
 };
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export type EPCDataSchemasDataQuality = OpenEnum<typeof EPCDataSchemasDataQuality>;
 /**
- * Energy efficiency rating.
+ * How energy efficient the roof is, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricRoofEnergyEfficiency: {
     readonly VeryGood: "very_good";
@@ -555,11 +555,11 @@ export declare const EPCDataSchemasFabricRoofEnergyEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient the roof is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricRoofEnergyEfficiency = OpenEnum<typeof EPCDataSchemasFabricRoofEnergyEfficiency>;
 /**
- * Environmental efficiency rating.
+ * How the roof scores for environmental impact, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricRoofEnvironmentalEfficiency: {
     readonly VeryGood: "very_good";
@@ -569,11 +569,11 @@ export declare const EPCDataSchemasFabricRoofEnvironmentalEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Environmental efficiency rating.
+ * How the roof scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricRoofEnvironmentalEfficiency = OpenEnum<typeof EPCDataSchemasFabricRoofEnvironmentalEfficiency>;
 /**
- * Insulation type: loft, rafter, none, etc.
+ * How the roof is insulated, if at all.
  */
 export declare const EPCDataInsulationType: {
     readonly None: "none";
@@ -589,11 +589,11 @@ export declare const EPCDataInsulationType: {
     readonly Rafter: "rafter";
 };
 /**
- * Insulation type: loft, rafter, none, etc.
+ * How the roof is insulated, if at all.
  */
 export type EPCDataInsulationType = OpenEnum<typeof EPCDataInsulationType>;
 /**
- * Roof type: pitched, flat, thatched, another_dwelling_above, other_premises_above, roof_room.
+ * How the roof is built, including the cases where another dwelling or premises sits above.
  */
 export declare const RoofType: {
     readonly Pitched: "pitched";
@@ -604,56 +604,56 @@ export declare const RoofType: {
     readonly RoofRoom: "roof_room";
 };
 /**
- * Roof type: pitched, flat, thatched, another_dwelling_above, other_premises_above, roof_room.
+ * How the roof is built, including the cases where another dwelling or premises sits above.
  */
 export type RoofType = OpenEnum<typeof RoofType>;
 /**
- * Roof construction and insulation.
+ * The roof and its insulation.
  */
 export type EPCDataRoof = {
     /**
-     * Non-null when source value was corrupted/incomplete.
+     * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
      */
-    dataQuality: EPCDataSchemasDataQuality | null;
+    dataQuality?: EPCDataSchemasDataQuality | null | undefined;
     /**
-     * Raw SAP description string.
+     * The assessor's own description of the roof, as written on the certificate.
      */
-    description: string | null;
+    description?: string | null | undefined;
     /**
-     * Energy efficiency rating.
+     * How energy efficient the roof is, on the certificate's five-point scale.
      */
-    energyEfficiency: EPCDataSchemasFabricRoofEnergyEfficiency | null;
+    energyEfficiency?: EPCDataSchemasFabricRoofEnergyEfficiency | null | undefined;
     /**
-     * Environmental efficiency rating.
+     * How the roof scores for environmental impact, on the certificate's five-point scale.
      */
-    environmentalEfficiency: EPCDataSchemasFabricRoofEnvironmentalEfficiency | null;
+    environmentalEfficiency?: EPCDataSchemasFabricRoofEnvironmentalEfficiency | null | undefined;
     /**
-     * Whether insulation status is assumed.
+     * True when the assessor assumed the insulation rather than confirming it.
      */
-    insulationAssumed: boolean;
+    insulationAssumed?: boolean | undefined;
     /**
-     * Loft insulation depth in millimetres.
+     * Depth of the loft insulation, in millimetres.
      */
-    insulationDepthMm: number | null;
+    insulationDepthMm?: number | null | undefined;
     /**
-     * Whether roof insulation is present.
+     * True when the roof is insulated.
      */
-    insulationPresent: boolean | null;
+    insulationPresent?: boolean | null | undefined;
     /**
-     * Insulation type: loft, rafter, none, etc.
+     * How the roof is insulated, if at all.
      */
-    insulationType: EPCDataInsulationType | null;
+    insulationType?: EPCDataInsulationType | null | undefined;
     /**
-     * Roof type: pitched, flat, thatched, another_dwelling_above, other_premises_above, roof_room.
+     * How the roof is built, including the cases where another dwelling or premises sits above.
      */
-    roofType: RoofType | null;
+    roofType?: RoofType | null | undefined;
     /**
-     * U-value in W/m²K if reported.
+     * Thermal transmittance (U-value) of the roof, in W/m²K, where the assessment reports one.
      */
-    thermalTransmittance: number | null;
+    thermalTransmittance?: number | null | undefined;
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricSecondaryHeatingEnergyEfficiency: {
     readonly VeryGood: "very_good";
@@ -663,11 +663,11 @@ export declare const EPCDataSchemasFabricSecondaryHeatingEnergyEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricSecondaryHeatingEnergyEfficiency = OpenEnum<typeof EPCDataSchemasFabricSecondaryHeatingEnergyEfficiency>;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricSecondaryHeatingEnvironmentalEfficiency: {
     readonly VeryGood: "very_good";
@@ -677,28 +677,28 @@ export declare const EPCDataSchemasFabricSecondaryHeatingEnvironmentalEfficiency
     readonly VeryPoor: "very_poor";
 };
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricSecondaryHeatingEnvironmentalEfficiency = OpenEnum<typeof EPCDataSchemasFabricSecondaryHeatingEnvironmentalEfficiency>;
 /**
- * Secondary heating system. Null when no secondary heating is present.
+ * Any secondary heating system. Null when the property has none.
  */
 export type SecondaryHeating = {
     /**
-     * SAP description string from assessor.
+     * The assessor's own description of this component, as written on the certificate.
      */
-    description: string | null;
+    description?: string | null | undefined;
     /**
-     * Energy efficiency rating.
+     * How energy efficient this component is, on the certificate's five-point scale.
      */
-    energyEfficiency: EPCDataSchemasFabricSecondaryHeatingEnergyEfficiency | null;
+    energyEfficiency?: EPCDataSchemasFabricSecondaryHeatingEnergyEfficiency | null | undefined;
     /**
-     * Environmental efficiency rating.
+     * How this component scores for environmental impact, on the certificate's five-point scale.
      */
-    environmentalEfficiency: EPCDataSchemasFabricSecondaryHeatingEnvironmentalEfficiency | null;
+    environmentalEfficiency?: EPCDataSchemasFabricSecondaryHeatingEnvironmentalEfficiency | null | undefined;
 };
 /**
- * Wall construction type: cavity, solid_brick, timber_frame, sandstone_or_limestone, etc.
+ * How the external walls are built.
  */
 export declare const EPCDataConstruction: {
     readonly Cavity: "cavity";
@@ -716,11 +716,11 @@ export declare const EPCDataConstruction: {
     readonly CurtainWall: "curtain_wall";
 };
 /**
- * Wall construction type: cavity, solid_brick, timber_frame, sandstone_or_limestone, etc.
+ * How the external walls are built.
  */
 export type EPCDataConstruction = OpenEnum<typeof EPCDataConstruction>;
 /**
- * Non-null when the source value was corrupted/incomplete. Null = normal quality.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export declare const EPCDataSchemasFabricDataQuality: {
     readonly TruncatedThermalTransmittance: "truncated_thermal_transmittance";
@@ -730,11 +730,11 @@ export declare const EPCDataSchemasFabricDataQuality: {
     readonly SourceError: "source_error";
 };
 /**
- * Non-null when the source value was corrupted/incomplete. Null = normal quality.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export type EPCDataSchemasFabricDataQuality = OpenEnum<typeof EPCDataSchemasFabricDataQuality>;
 /**
- * Energy efficiency rating.
+ * How energy efficient the walls are, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricWallsEnergyEfficiency: {
     readonly VeryGood: "very_good";
@@ -744,11 +744,11 @@ export declare const EPCDataSchemasFabricWallsEnergyEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient the walls are, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricWallsEnergyEfficiency = OpenEnum<typeof EPCDataSchemasFabricWallsEnergyEfficiency>;
 /**
- * Environmental efficiency rating.
+ * How the walls score for environmental impact, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricWallsEnvironmentalEfficiency: {
     readonly VeryGood: "very_good";
@@ -758,11 +758,11 @@ export declare const EPCDataSchemasFabricWallsEnvironmentalEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Environmental efficiency rating.
+ * How the walls score for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricWallsEnvironmentalEfficiency = OpenEnum<typeof EPCDataSchemasFabricWallsEnvironmentalEfficiency>;
 /**
- * Insulation type: none, filled_cavity, external, internal, as_built, partial, etc.
+ * How the walls are insulated, if at all.
  */
 export declare const EPCDataSchemasInsulationType: {
     readonly None: "none";
@@ -778,56 +778,56 @@ export declare const EPCDataSchemasInsulationType: {
     readonly Rafter: "rafter";
 };
 /**
- * Insulation type: none, filled_cavity, external, internal, as_built, partial, etc.
+ * How the walls are insulated, if at all.
  */
 export type EPCDataSchemasInsulationType = OpenEnum<typeof EPCDataSchemasInsulationType>;
 /**
- * External wall construction and insulation.
+ * The external walls and their insulation.
  */
 export type Walls = {
     /**
-     * Wall construction type: cavity, solid_brick, timber_frame, sandstone_or_limestone, etc.
+     * How the external walls are built.
      */
-    construction: EPCDataConstruction | null;
+    construction?: EPCDataConstruction | null | undefined;
     /**
-     * Non-null when the source value was corrupted/incomplete. Null = normal quality.
+     * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
      */
-    dataQuality: EPCDataSchemasFabricDataQuality | null;
+    dataQuality?: EPCDataSchemasFabricDataQuality | null | undefined;
     /**
-     * Raw SAP description string from assessor.
+     * The assessor's own description of the walls, as written on the certificate.
      */
-    description: string | null;
+    description?: string | null | undefined;
     /**
-     * Energy efficiency rating.
+     * How energy efficient the walls are, on the certificate's five-point scale.
      */
-    energyEfficiency: EPCDataSchemasFabricWallsEnergyEfficiency | null;
+    energyEfficiency?: EPCDataSchemasFabricWallsEnergyEfficiency | null | undefined;
     /**
-     * Environmental efficiency rating.
+     * How the walls score for environmental impact, on the certificate's five-point scale.
      */
-    environmentalEfficiency: EPCDataSchemasFabricWallsEnvironmentalEfficiency | null;
+    environmentalEfficiency?: EPCDataSchemasFabricWallsEnvironmentalEfficiency | null | undefined;
     /**
-     * Whether insulation status is assumed by the assessor (true) or confirmed (false).
+     * True when the assessor assumed the insulation rather than confirming it.
      */
-    insulationAssumed: boolean;
+    insulationAssumed?: boolean | undefined;
     /**
-     * Whether wall insulation is present.
+     * True when the walls are insulated.
      */
-    insulationPresent: boolean | null;
+    insulationPresent?: boolean | null | undefined;
     /**
-     * Insulation type: none, filled_cavity, external, internal, as_built, partial, etc.
+     * How the walls are insulated, if at all.
      */
-    insulationType: EPCDataSchemasInsulationType | null;
+    insulationType?: EPCDataSchemasInsulationType | null | undefined;
     /**
-     * Wall material (e.g. 'brick') where identifiable from description.
+     * The wall material, for example 'brick', where the assessor's description identifies one.
      */
-    material: string | null;
+    material?: string | null | undefined;
     /**
-     * U-value in W/m²K if reported. Newer SAP versions report this instead of description text.
+     * Thermal transmittance (U-value) of the walls, in W/m²K, where the assessment reports one.
      */
-    thermalTransmittance: number | null;
+    thermalTransmittance?: number | null | undefined;
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricWindowsEnergyEfficiency: {
     readonly VeryGood: "very_good";
@@ -837,11 +837,11 @@ export declare const EPCDataSchemasFabricWindowsEnergyEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricWindowsEnergyEfficiency = OpenEnum<typeof EPCDataSchemasFabricWindowsEnergyEfficiency>;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export declare const EPCDataSchemasFabricWindowsEnvironmentalEfficiency: {
     readonly VeryGood: "very_good";
@@ -851,87 +851,88 @@ export declare const EPCDataSchemasFabricWindowsEnvironmentalEfficiency: {
     readonly VeryPoor: "very_poor";
 };
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricWindowsEnvironmentalEfficiency = OpenEnum<typeof EPCDataSchemasFabricWindowsEnvironmentalEfficiency>;
 /**
- * Window glazing specification.
+ * The windows and their glazing.
  */
 export type Windows = {
     /**
-     * SAP description string from assessor.
+     * The assessor's own description of this component, as written on the certificate.
      */
-    description: string | null;
+    description?: string | null | undefined;
     /**
-     * Energy efficiency rating.
+     * How energy efficient this component is, on the certificate's five-point scale.
      */
-    energyEfficiency: EPCDataSchemasFabricWindowsEnergyEfficiency | null;
+    energyEfficiency?: EPCDataSchemasFabricWindowsEnergyEfficiency | null | undefined;
     /**
-     * Environmental efficiency rating.
+     * How this component scores for environmental impact, on the certificate's five-point scale.
      */
-    environmentalEfficiency: EPCDataSchemasFabricWindowsEnvironmentalEfficiency | null;
+    environmentalEfficiency?: EPCDataSchemasFabricWindowsEnvironmentalEfficiency | null | undefined;
 };
 /**
- * Building fabric assessment (domestic only)
+ * Component-by-component assessment of the building, covering walls, roof, floor, windows and more. Domestic certificates only.
  */
 export type Fabric = {
     /**
-     * Air tightness assessment. Scotland only; null for E&W.
+     * The air tightness assessment. Scotland only; null on England and Wales certificates.
      */
-    airTightness: AirTightness | null;
+    airTightness?: AirTightness | null | undefined;
     /**
-     * Ground floor construction and insulation.
+     * The ground floor and its insulation.
      */
-    floor: Floor;
+    floor?: Floor | undefined;
     /**
-     * Heating control system.
+     * How the heating is controlled.
      */
-    heatingControls: HeatingControls;
+    heatingControls?: HeatingControls | undefined;
     /**
-     * Hot water system.
+     * The hot water system.
      */
-    hotWater: HotWater;
+    hotWater?: HotWater | undefined;
     /**
-     * Lighting system.
+     * The lighting installed.
      */
-    lighting: Lighting;
+    lighting?: Lighting | undefined;
     /**
-     * Main heating system.
+     * The main heating system.
      */
-    mainHeating: MainHeating;
+    mainHeating?: MainHeating | undefined;
     /**
-     * Roof construction and insulation.
+     * The roof and its insulation.
      */
-    roof: EPCDataRoof;
+    roof?: EPCDataRoof | undefined;
     /**
-     * Secondary heating system. Null when no secondary heating is present.
+     * Any secondary heating system. Null when the property has none.
      */
-    secondaryHeating: SecondaryHeating | null;
+    secondaryHeating?: SecondaryHeating | null | undefined;
     /**
-     * External wall construction and insulation.
+     * The external walls and their insulation.
      */
-    walls: Walls;
+    walls?: Walls | undefined;
     /**
-     * Window glazing specification.
+     * The windows and their glazing.
      */
-    windows: Windows;
+    windows?: Windows | undefined;
 };
 /**
- * MEES compliance status
+ * Whether the property meets the Minimum Energy Efficiency Standard that governs letting.
  */
 export declare const MeesCompliance: {
     readonly Compliant: "compliant";
     readonly AtRisk: "at_risk";
     readonly NonCompliant: "non_compliant";
+    readonly NotApplicable: "not_applicable";
     readonly Exempt: "exempt";
     readonly Unknown: "unknown";
 };
 /**
- * MEES compliance status
+ * Whether the property meets the Minimum Energy Efficiency Standard that governs letting.
  */
 export type MeesCompliance = OpenEnum<typeof MeesCompliance>;
 /**
- * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+ * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
  */
 export declare const EPCDataBand: {
     readonly APlus: "A+";
@@ -949,11 +950,11 @@ export declare const EPCDataBand: {
     readonly G: "G";
 };
 /**
- * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+ * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
  */
 export type EPCDataBand = OpenEnum<typeof EPCDataBand>;
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export declare const ScoreType: {
     readonly Sap: "sap";
@@ -962,28 +963,28 @@ export declare const ScoreType: {
     readonly Epi: "epi";
 };
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export type ScoreType = OpenEnum<typeof ScoreType>;
 /**
- * Current energy rating at time of assessment.
+ * The rating the building holds as assessed.
  */
 export type Current = {
     /**
-     * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+     * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
      */
-    band: EPCDataBand;
+    band?: EPCDataBand | undefined;
     /**
-     * Numeric score. Interpretation depends on scoreType: SAP = 1-100 (higher is better); Asset = kg CO2/m² (lower is better, unbounded); Operational = relative to benchmark (lower is better, unbounded); EPI = kg CO2/m² using Scottish weather data.
+     * Numeric score behind the band, read alongside `scoreType`. A `sap` score runs from 1 to 100 and higher is better. An `asset` score is in kg CO2 per m² and an `operational` score is measured against a benchmark; both are unbounded and lower is better. An `epi` score is in kg CO2 per m² calculated with Scottish weather data.
      */
-    score: number;
+    score?: number | undefined;
     /**
-     * Discriminator for numeric score interpretation.
+     * Which scale `score` is on. Read it before comparing scores across certificates.
      */
-    scoreType: ScoreType;
+    scoreType?: ScoreType | undefined;
 };
 /**
- * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+ * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
  */
 export declare const EPCDataSchemasBand: {
     readonly APlus: "A+";
@@ -1001,11 +1002,11 @@ export declare const EPCDataSchemasBand: {
     readonly G: "G";
 };
 /**
- * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+ * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
  */
 export type EPCDataSchemasBand = OpenEnum<typeof EPCDataSchemasBand>;
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export declare const EPCDataScoreType: {
     readonly Sap: "sap";
@@ -1014,45 +1015,45 @@ export declare const EPCDataScoreType: {
     readonly Epi: "epi";
 };
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export type EPCDataScoreType = OpenEnum<typeof EPCDataScoreType>;
 /**
- * Achievable rating with recommended improvements. Null for DECs (operational ratings have no potential). E&W non-domestic does not publish a potential rating; Scotland non-domestic does.
+ * The rating the building would reach if the recommended improvements were carried out. Null on Display Energy Certificates, which rate measured use rather than potential, and on England and Wales non-domestic certificates, which do not publish one. Scotland non-domestic does.
  */
 export type Potential = {
     /**
-     * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+     * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
      */
-    band: EPCDataSchemasBand;
+    band?: EPCDataSchemasBand | undefined;
     /**
-     * Numeric score. Interpretation depends on scoreType: SAP = 1-100 (higher is better); Asset = kg CO2/m² (lower is better, unbounded); Operational = relative to benchmark (lower is better, unbounded); EPI = kg CO2/m² using Scottish weather data.
+     * Numeric score behind the band, read alongside `scoreType`. A `sap` score runs from 1 to 100 and higher is better. An `asset` score is in kg CO2 per m² and an `operational` score is measured against a benchmark; both are unbounded and lower is better. An `epi` score is in kg CO2 per m² calculated with Scottish weather data.
      */
-    score: number;
+    score?: number | undefined;
     /**
-     * Discriminator for numeric score interpretation.
+     * Which scale `score` is on. Read it before comparing scores across certificates.
      */
-    scoreType: EPCDataScoreType;
+    scoreType?: EPCDataScoreType | undefined;
 };
 /**
- * Full energy rating (current + potential)
+ * Energy rating as assessed, and as it could be with the recommended improvements made.
  */
 export type Rating = {
     /**
-     * Whether the building achieves net-zero carbon. Scotland non-domestic uses 'Carbon Neu' band; mapped to A+ with this flag set to true.
+     * True when the building is rated carbon neutral. Scotland non-domestic certificates record this as a 'Carbon Neu' band, which is published here as band `A+` with this flag set.
      */
-    carbonNeutral: boolean;
+    carbonNeutral?: boolean | undefined;
     /**
-     * Current energy rating at time of assessment.
+     * The rating the building holds as assessed.
      */
-    current: Current;
+    current?: Current | undefined;
     /**
-     * Achievable rating with recommended improvements. Null for DECs (operational ratings have no potential). E&W non-domestic does not publish a potential rating; Scotland non-domestic does.
+     * The rating the building would reach if the recommended improvements were carried out. Null on Display Energy Certificates, which rate measured use rather than potential, and on England and Wales non-domestic certificates, which do not publish one. Scotland non-domestic does.
      */
-    potential: Potential | null;
+    potential?: Potential | null | undefined;
 };
 /**
- * Measure category: insulation, glazing, heating, hot_water, renewables, lighting.
+ * What kind of improvement the measure is.
  */
 export declare const Category: {
     readonly Insulation: "insulation";
@@ -1063,11 +1064,11 @@ export declare const Category: {
     readonly Lighting: "lighting";
 };
 /**
- * Measure category: insulation, glazing, heating, hot_water, renewables, lighting.
+ * What kind of improvement the measure is.
  */
 export type Category = OpenEnum<typeof Category>;
 /**
- * CO2 reduction impact. Scotland non-domestic only: low, medium, high.
+ * How much the measure cuts carbon dioxide emissions. Scotland non-domestic only.
  */
 export declare const Co2Impact: {
     readonly Low: "low";
@@ -1075,46 +1076,46 @@ export declare const Co2Impact: {
     readonly High: "high";
 };
 /**
- * CO2 reduction impact. Scotland non-domestic only: low, medium, high.
+ * How much the measure cuts carbon dioxide emissions. Scotland non-domestic only.
  */
 export type Co2Impact = OpenEnum<typeof Co2Impact>;
 /**
- * Currency. All values normalised to GBP.
+ * The currency of the cost figures. Always `GBP`.
  */
 export declare const Currency: {
     readonly Gbp: "GBP";
 };
 /**
- * Currency. All values normalised to GBP.
+ * The currency of the cost figures. Always `GBP`.
  */
 export type Currency = ClosedEnum<typeof Currency>;
 /**
- * Structured cost estimate with numeric min/max in GBP. Parsed from 1,054 unique source cost strings (including encoding variants). Use cost.year to apply your own inflation adjustment.
+ * What the measure is estimated to cost, as numeric bounds in GBP. Use `cost.year` as the base year when adjusting for inflation.
  */
 export type Cost = {
     /**
-     * Currency. All values normalised to GBP.
+     * The currency of the cost figures. Always `GBP`.
      */
-    currency: Currency;
+    currency?: Currency | undefined;
     /**
-     * Raw cost string from source (e.g. '£100 - £350'). Preserved for transparency.
+     * The cost range exactly as the certificate words it, for example '£100 - £350'.
      */
-    indicative: string | null;
+    indicative?: string | null | undefined;
     /**
-     * Upper bound cost estimate (£ GBP).
+     * High end of the estimated cost, in GBP.
      */
-    max: number | null;
+    max?: number | null | undefined;
     /**
-     * Lower bound cost estimate (£ GBP).
+     * Low end of the estimated cost, in GBP.
      */
-    min: number | null;
+    min?: number | null | undefined;
     /**
-     * Assessment year for this cost estimate. Consumers should apply their own inflation adjustment from this base year.
+     * The year the cost was estimated in. Treat it as the base year when adjusting for inflation.
      */
-    year: number | null;
+    year?: number | null | undefined;
 };
 /**
- * Canonical improvement measure: wall_insulation, condensing_boiler, solar_pv, etc. 40 canonical values covering all SAP standard improvement measures.
+ * Which improvement is recommended, mapped to a standard set of measures.
  */
 export declare const Measure: {
     readonly WallInsulation: "wall_insulation";
@@ -1159,11 +1160,11 @@ export declare const Measure: {
     readonly LowEnergyLighting: "low_energy_lighting";
 };
 /**
- * Canonical improvement measure: wall_insulation, condensing_boiler, solar_pv, etc. 40 canonical values covering all SAP standard improvement measures.
+ * Which improvement is recommended, mapped to a standard set of measures.
  */
 export type Measure = OpenEnum<typeof Measure>;
 /**
- * Payback period classification. Non-domestic only: short, medium, long, other.
+ * How long the measure takes to pay for itself. Non-domestic only.
  */
 export declare const PaybackType: {
     readonly Short: "short";
@@ -1172,160 +1173,160 @@ export declare const PaybackType: {
     readonly Other: "other";
 };
 /**
- * Payback period classification. Non-domestic only: short, medium, long, other.
+ * How long the measure takes to pay for itself. Non-domestic only.
  */
 export type PaybackType = OpenEnum<typeof PaybackType>;
 /**
- * Projected rating after this measure. Domestic only.
+ * The rating reached once this measure is carried out. Domestic only.
  */
 export type ProjectedRating = {
     /**
-     * Projected energy band after this measure (e.g. 'C').
+     * The energy band the dwelling reaches once this measure is in place, for example 'C'.
      */
-    band: string | null;
+    band?: string | null | undefined;
     /**
-     * Projected cumulative SAP score after implementing this and all prior measures.
+     * The SAP score the dwelling reaches with this measure and every measure before it in the sequence.
      */
-    energyScore: number | null;
+    energyScore?: number | null | undefined;
     /**
-     * Projected cumulative environmental score.
+     * The environmental impact score the dwelling reaches with this measure and every measure before it.
      */
-    environmentalScore: number | null;
+    environmentalScore?: number | null | undefined;
 };
 /**
- * Currency.
+ * The currency of the saving. Always `GBP`.
  */
 export declare const EPCDataCurrency: {
     readonly Gbp: "GBP";
 };
 /**
- * Currency.
+ * The currency of the saving. Always `GBP`.
  */
 export type EPCDataCurrency = ClosedEnum<typeof EPCDataCurrency>;
 /**
- * Estimated annual saving in GBP. Parsed from source typical saving field.
+ * What the measure is estimated to save each year, in GBP.
  */
 export type Saving = {
     /**
-     * Estimated annual saving (£ GBP).
+     * Estimated saving each year, in GBP.
      */
-    annual: number | null;
+    annual?: number | null | undefined;
     /**
-     * Currency.
+     * The currency of the saving. Always `GBP`.
      */
-    currency: EPCDataCurrency;
+    currency?: EPCDataCurrency | undefined;
 };
 /**
- * Individual improvement recommendation with structured cost/saving values, canonical measure classification, and projected rating impact.
+ * One recommended improvement, with its cost and saving estimates, its standard measure classification, and the rating it would achieve.
  */
 export type Recommendations = {
     /**
-     * Measure category: insulation, glazing, heating, hot_water, renewables, lighting.
+     * What kind of improvement the measure is.
      */
-    category: Category | null;
+    category?: Category | null | undefined;
     /**
-     * CO2 reduction impact. Scotland non-domestic only: low, medium, high.
+     * How much the measure cuts carbon dioxide emissions. Scotland non-domestic only.
      */
-    co2Impact: Co2Impact | null;
+    co2Impact?: Co2Impact | null | undefined;
     /**
-     * Structured cost estimate with numeric min/max in GBP. Parsed from 1,054 unique source cost strings (including encoding variants). Use cost.year to apply your own inflation adjustment.
+     * What the measure is estimated to cost, as numeric bounds in GBP. Use `cost.year` as the base year when adjusting for inflation.
      */
-    cost: Cost | null;
+    cost?: Cost | null | undefined;
     /**
-     * Detailed description with guidance text.
+     * The fuller explanation of the measure, as worded on the certificate.
      */
-    description: string | null;
+    description?: string | null | undefined;
     /**
-     * Whether this measure is eligible for Green Deal financing. Boolean — not a raw string code.
+     * True when the measure qualifies for Green Deal financing.
      */
-    greenDealEligible: boolean | null;
+    greenDealEligible?: boolean | null | undefined;
     /**
-     * Canonical improvement measure: wall_insulation, condensing_boiler, solar_pv, etc. 40 canonical values covering all SAP standard improvement measures.
+     * Which improvement is recommended, mapped to a standard set of measures.
      */
-    measure: Measure | null;
+    measure?: Measure | null | undefined;
     /**
-     * Source measure code. E&W: IMPROVEMENT_ID. Scotland: EPC-prefixed (e.g. EPC-R4).
+     * The code this measure carries on the source certificate. Scottish certificates prefix theirs with 'EPC-', such as 'EPC-R4'.
      */
-    measureCode: string | null;
+    measureCode?: string | null | undefined;
     /**
-     * Payback period classification. Non-domestic only: short, medium, long, other.
+     * How long the measure takes to pay for itself. Non-domestic only.
      */
-    paybackType: PaybackType | null;
+    paybackType?: PaybackType | null | undefined;
     /**
-     * Projected rating after this measure. Domestic only.
+     * The rating reached once this measure is carried out. Domestic only.
      */
-    projectedRating: ProjectedRating | null;
+    projectedRating?: ProjectedRating | null | undefined;
     /**
-     * Estimated annual saving in GBP. Parsed from source typical saving field.
+     * What the measure is estimated to save each year, in GBP.
      */
-    saving: Saving | null;
+    saving?: Saving | null | undefined;
     /**
-     * Priority order. Implementing measures in sequence provides the most cost-effective path.
+     * Position in the recommended order. Carrying the measures out in this order gives the most cost-effective path.
      */
-    sequence: number;
+    sequence?: number | undefined;
     /**
-     * Short description of the improvement measure.
+     * The measure in a short line, as worded on the certificate.
      */
-    summary: string | null;
+    summary?: string | null | undefined;
 };
 /**
- * Annual heating costs — current and achievable.
+ * Estimated annual heating cost, as assessed and after improvement.
  */
 export type Heating = {
     /**
-     * Current annual heating cost (£).
+     * Estimated annual heating cost at the assessed efficiency, in GBP.
      */
-    current: number;
+    current?: number | undefined;
     /**
-     * Achievable annual heating cost (£).
+     * Estimated annual heating cost once the recommended improvements are carried out, in GBP.
      */
-    potential: number;
+    potential?: number | undefined;
 };
 /**
- * Annual hot water costs — current and achievable.
+ * Estimated annual hot water cost, as assessed and after improvement.
  */
 export type EPCDataHotWater = {
     /**
-     * Current annual hot water cost (£).
+     * Estimated annual hot water cost at the assessed efficiency, in GBP.
      */
-    current: number;
+    current?: number | undefined;
     /**
-     * Achievable annual hot water cost (£).
+     * Estimated annual hot water cost once the recommended improvements are carried out, in GBP.
      */
-    potential: number;
+    potential?: number | undefined;
 };
 /**
- * Annual lighting costs — current and achievable.
+ * Estimated annual lighting cost, as assessed and after improvement.
  */
 export type EPCDataLighting = {
     /**
-     * Current annual lighting cost (£).
+     * Estimated annual lighting cost at the assessed efficiency, in GBP.
      */
-    current: number;
+    current?: number | undefined;
     /**
-     * Achievable annual lighting cost (£).
+     * Estimated annual lighting cost once the recommended improvements are carried out, in GBP.
      */
-    potential: number;
+    potential?: number | undefined;
 };
 /**
- * Annual running costs in GBP (domestic only)
+ * Estimated annual running costs for heating, hot water and lighting. Domestic certificates only; null for the other types.
  */
 export type RunningCosts = {
     /**
-     * Annual heating costs — current and achievable.
+     * Estimated annual heating cost, as assessed and after improvement.
      */
-    heating: Heating;
+    heating?: Heating | undefined;
     /**
-     * Annual hot water costs — current and achievable.
+     * Estimated annual hot water cost, as assessed and after improvement.
      */
-    hotWater: EPCDataHotWater;
+    hotWater?: EPCDataHotWater | undefined;
     /**
-     * Annual lighting costs — current and achievable.
+     * Estimated annual lighting cost, as assessed and after improvement.
      */
-    lighting: EPCDataLighting;
+    lighting?: EPCDataLighting | undefined;
 };
 /**
- * AC inspection commissioning status.
+ * Whether an air conditioning inspection has been carried out, commissioned, or is not relevant.
  */
 export declare const InspectionStatus: {
     readonly Completed: "completed";
@@ -1335,32 +1336,32 @@ export declare const InspectionStatus: {
     readonly Unknown: "unknown";
 };
 /**
- * AC inspection commissioning status.
+ * Whether an air conditioning inspection has been carried out, commissioned, or is not relevant.
  */
 export type InspectionStatus = OpenEnum<typeof InspectionStatus>;
 /**
- * Air conditioning details. Non-domestic/DEC only; null for domestic.
+ * The building's air conditioning. Recorded on non-domestic certificates and Display Energy Certificates; null for domestic.
  */
 export type AirConditioning = {
     /**
-     * Estimated AC capacity when actual is unknown (kW).
+     * Estimated capacity of the air conditioning system, in kW, used when the rated capacity is unknown.
      */
-    estimatedKwRating: number | null;
+    estimatedKwRating?: number | null | undefined;
     /**
-     * AC inspection commissioning status.
+     * Whether an air conditioning inspection has been carried out, commissioned, or is not relevant.
      */
-    inspectionStatus: InspectionStatus | null;
+    inspectionStatus?: InspectionStatus | null | undefined;
     /**
-     * Actual AC system capacity (kW).
+     * Rated capacity of the air conditioning system, in kW.
      */
-    kwRating: number | null;
+    kwRating?: number | null | undefined;
     /**
-     * Whether AC system is installed.
+     * True when the building has air conditioning.
      */
-    present: boolean;
+    present?: boolean | undefined;
 };
 /**
- * Electricity tariff type. Domestic only.
+ * The electricity tariff the property is on, including the off-peak arrangements. Domestic only.
  */
 export declare const EnergyTariff: {
     readonly Single: "single";
@@ -1372,11 +1373,11 @@ export declare const EnergyTariff: {
     readonly Unknown: "unknown";
 };
 /**
- * Electricity tariff type. Domestic only.
+ * The electricity tariff the property is on, including the off-peak arrangements. Domestic only.
  */
 export type EnergyTariff = OpenEnum<typeof EnergyTariff>;
 /**
- * Corridor heat loss classification. Flats/maisonettes only.
+ * Whether the dwelling is reached by a corridor and whether that corridor is heated. Recorded for flats and maisonettes only.
  */
 export declare const HeatLossCorridor: {
     readonly NoCorridor: "no_corridor";
@@ -1384,11 +1385,11 @@ export declare const HeatLossCorridor: {
     readonly UnheatedCorridor: "unheated_corridor";
 };
 /**
- * Corridor heat loss classification. Flats/maisonettes only.
+ * Whether the dwelling is reached by a corridor and whether that corridor is heated. Recorded for flats and maisonettes only.
  */
 export type HeatLossCorridor = OpenEnum<typeof HeatLossCorridor>;
 /**
- * Normalised primary fuel type. See mainFuelExternal for raw source text.
+ * The main fuel the building uses, mapped to a standard set of categories. `mainFuelExternal` carries the wording used on the certificate.
  */
 export declare const MainFuel: {
     readonly MainsGas: "mains_gas";
@@ -1407,45 +1408,45 @@ export declare const MainFuel: {
     readonly Other: "other";
 };
 /**
- * Normalised primary fuel type. See mainFuelExternal for raw source text.
+ * The main fuel the building uses, mapped to a standard set of categories. `mainFuelExternal` carries the wording used on the certificate.
  */
 export type MainFuel = OpenEnum<typeof MainFuel>;
 /**
- * Photovoltaic panel installation.
+ * The solar photovoltaic installation.
  */
 export type Photovoltaic = {
     /**
-     * Whether PV panels are installed.
+     * True when solar photovoltaic panels are installed.
      */
-    present: boolean;
+    present?: boolean | undefined;
     /**
-     * Percentage of demand met by PV. Domestic only (PHOTO_SUPPLY field).
+     * The photovoltaic supply figure recorded on the certificate, as a percentage. Domestic only.
      */
-    supplyPercentage: number | null;
+    supplyPercentage?: number | null | undefined;
 };
 /**
- * On-site renewable energy installations.
+ * Renewable energy generated on site.
  */
 export type Renewables = {
     /**
-     * Free-text renewable sources description. Non-domestic only (RENEWABLE_SOURCES field).
+     * The renewable sources in the assessor's own words. Non-domestic only.
      */
-    description: string | null;
+    description?: string | null | undefined;
     /**
-     * Photovoltaic panel installation.
+     * The solar photovoltaic installation.
      */
-    photovoltaic: Photovoltaic | null;
+    photovoltaic?: Photovoltaic | null | undefined;
     /**
-     * Solar thermal (hot water) present. Domestic: from SOLAR_WATER_HEATING_FLAG. Non-domestic: derived from RENEWABLE_SOURCES text.
+     * True when the building has solar thermal panels heating its hot water.
      */
-    solarThermal: boolean | null;
+    solarThermal?: boolean | null | undefined;
     /**
      * Number of wind turbines installed. Domestic only.
      */
-    windTurbines: number | null;
+    windTurbines?: number | null | undefined;
 };
 /**
- * Mechanical ventilation type. Domestic only. Null means natural ventilation.
+ * How the property is ventilated. Domestic only.
  */
 export declare const Ventilation: {
     readonly Natural: "natural";
@@ -1453,101 +1454,101 @@ export declare const Ventilation: {
     readonly MechanicalSupplyAndExtract: "mechanical_supply_and_extract";
 };
 /**
- * Mechanical ventilation type. Domestic only. Null means natural ventilation.
+ * How the property is ventilated. Domestic only.
  */
 export type Ventilation = OpenEnum<typeof Ventilation>;
 /**
- * Building energy systems — fuel, heating, renewables
+ * The property's energy systems: fuel, heating controls, ventilation and on-site renewables.
  */
 export type Systems = {
     /**
-     * Air conditioning details. Non-domestic/DEC only; null for domestic.
+     * The building's air conditioning. Recorded on non-domestic certificates and Display Energy Certificates; null for domestic.
      */
-    airConditioning: AirConditioning | null;
+    airConditioning?: AirConditioning | null | undefined;
     /**
-     * Electricity tariff type. Domestic only.
+     * The electricity tariff the property is on, including the off-peak arrangements. Domestic only.
      */
-    energyTariff: EnergyTariff | null;
+    energyTariff?: EnergyTariff | null | undefined;
     /**
-     * Corridor heat loss classification. Flats/maisonettes only.
+     * Whether the dwelling is reached by a corridor and whether that corridor is heated. Recorded for flats and maisonettes only.
      */
-    heatLossCorridor: HeatLossCorridor | null;
+    heatLossCorridor?: HeatLossCorridor | null | undefined;
     /**
-     * Normalised primary fuel type. See mainFuelExternal for raw source text.
+     * The main fuel the building uses, mapped to a standard set of categories. `mainFuelExternal` carries the wording used on the certificate.
      */
-    mainFuel: MainFuel | null;
+    mainFuel?: MainFuel | null | undefined;
     /**
-     * Raw fuel type text from source register. E.g. 'mains gas (not community)', 'electricity (7-hour tariff)', 'Natural Gas'.
+     * The fuel exactly as the certificate words it, for example 'mains gas (not community)' or 'electricity (7-hour tariff)'.
      */
-    mainFuelExternal: string | null;
+    mainFuelExternal?: string | null | undefined;
     /**
-     * Heating control system code. Domestic only.
+     * The heating controls recorded on the certificate, as a source code. Domestic only.
      */
-    mainHeatingControls: string | null;
+    mainHeatingControls?: string | null | undefined;
     /**
-     * Whether mains gas is connected. Domestic only. Derived from MAINS_GAS_FLAG (Y→true, N→false, blank→null).
+     * True when the property has a mains gas connection. Domestic only; null when the certificate does not say.
      */
-    mainsGas: boolean | null;
+    mainsGas?: boolean | null | undefined;
     /**
-     * On-site renewable energy installations.
+     * Renewable energy generated on site.
      */
-    renewables: Renewables;
+    renewables?: Renewables | undefined;
     /**
-     * Length of unheated corridor in metres. Flats/maisonettes only.
+     * Length of the unheated corridor, in metres. Recorded for flats and maisonettes only.
      */
-    unheatedCorridorLength: number | null;
+    unheatedCorridorLength?: number | null | undefined;
     /**
-     * Mechanical ventilation type. Domestic only. Null means natural ventilation.
+     * How the property is ventilated. Domestic only.
      */
-    ventilation: Ventilation | null;
+    ventilation?: Ventilation | null | undefined;
 };
 export type EPCData = {
     /**
-     * Certificate type
+     * Which kind of certificate this is: domestic, non-domestic, or a display energy certificate.
      */
     certificateType?: CertificateType | null | undefined;
     /**
-     * Current EPC rating band
+     * Energy efficiency band on the current certificate, where A+ and A are the most efficient and G the least.
      */
     currentRatingBand?: CurrentRatingBand | null | undefined;
     /**
-     * Current SAP score (1-100)
+     * Numeric energy score on the current certificate. Read it with `rating.current.scoreType`: a domestic SAP score runs 1 to 100 and higher is better.
      */
     currentRatingScore?: number | null | undefined;
     /**
-     * Environmental impact, CO2, energy consumption
+     * Environmental impact, carbon dioxide emissions and energy consumption from the certificate.
      */
     emissions?: Emissions | null | undefined;
     /**
-     * Building fabric assessment (domestic only)
+     * Component-by-component assessment of the building, covering walls, roof, floor, windows and more. Domestic certificates only.
      */
     fabric?: Fabric | null | undefined;
     /**
-     * Date of most recent EPC assessment
+     * When the property was inspected for this certificate, as an ISO 8601 date.
      */
     inspectionDate?: string | null | undefined;
     /**
-     * MEES compliance status
+     * Whether the property meets the Minimum Energy Efficiency Standard that governs letting.
      */
     meesCompliance?: MeesCompliance | null | undefined;
     /**
-     * Full energy rating (current + potential)
+     * Energy rating as assessed, and as it could be with the recommended improvements made.
      */
     rating?: Rating | null | undefined;
     /**
-     * Improvement recommendations
+     * Improvements the assessor recommended, with their expected effect on the rating.
      */
     recommendations?: Array<Recommendations> | undefined;
     /**
-     * Annual running costs in GBP (domestic only)
+     * Estimated annual running costs for heating, hot water and lighting. Domestic certificates only; null for the other types.
      */
     runningCosts?: RunningCosts | null | undefined;
     /**
-     * Certificate source reference ID
+     * The certificate's own identifier in the register it came from.
      */
     sourceReference?: string | null | undefined;
     /**
-     * Building energy systems — fuel, heating, renewables
+     * The property's energy systems: fuel, heating controls, ventilation and on-site renewables.
      */
     systems?: Systems | null | undefined;
 };