@vepler/sdk 2.138.0 → 2.140.0

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

@@ -0,0 +1,49 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+/**
+ * Request body for the multi-area census profile.
+ */
+export type CensusAreaProfileRequest = {
+  /**
+   * Stable public dataset id.
+   */
+  datasetCode: string;
+  /**
+   * ONS geography codes to profile (max 100).
+   */
+  geographyCodes: Array<string>;
+  /**
+   * Optional variable-slug filter. Values must be slugs returned by GET /datasets/{datasetCode}/variables. Omit to return the full profile.
+   */
+  variableSlugs?: Array<string> | undefined;
+};
+
+/** @internal */
+export type CensusAreaProfileRequest$Outbound = {
+  datasetCode: string;
+  geographyCodes: Array<string>;
+  variableSlugs?: Array<string> | undefined;
+};
+
+/** @internal */
+export const CensusAreaProfileRequest$outboundSchema: z.ZodType<
+  CensusAreaProfileRequest$Outbound,
+  z.ZodTypeDef,
+  CensusAreaProfileRequest
+> = z.object({
+  datasetCode: z.string(),
+  geographyCodes: z.array(z.string()),
+  variableSlugs: z.array(z.string()).optional(),
+});
+
+export function censusAreaProfileRequestToJSON(
+  censusAreaProfileRequest: CensusAreaProfileRequest,
+): string {
+  return JSON.stringify(
+    CensusAreaProfileRequest$outboundSchema.parse(censusAreaProfileRequest),
+  );
+}

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

@@ -0,0 +1,44 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type CensusHealthResponse = {
+  /**
+   * Service identifier.
+   */
+  service: string;
+  /**
+   * Service status — 'ok' when operational.
+   */
+  status: string;
+  /**
+   * ISO 8601 timestamp the health check was answered at.
+   */
+  timestamp: string;
+};
+
+/** @internal */
+export const CensusHealthResponse$inboundSchema: z.ZodType<
+  CensusHealthResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  service: z.string(),
+  status: z.string(),
+  timestamp: z.string(),
+});
+
+export function censusHealthResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<CensusHealthResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CensusHealthResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CensusHealthResponse' from JSON`,
+  );
+}

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

@@ -0,0 +1,49 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+/**
+ * Request body for the custom-area census rollup. Ratios are SUM(count)/SUM(base), never an average of ratios.
+ */
+export type CensusRollupRequest = {
+  /**
+   * Category codes ('{classificationCode}-{NNN}') to roll up across the custom area. At least one is required; there is no wildcard — list every code you want.
+   */
+  categoryCodes: Array<string>;
+  /**
+   * Stable public dataset id.
+   */
+  datasetCode: string;
+  /**
+   * ONS geography codes forming the custom area (max 100).
+   */
+  geographyCodes: Array<string>;
+};
+
+/** @internal */
+export type CensusRollupRequest$Outbound = {
+  categoryCodes: Array<string>;
+  datasetCode: string;
+  geographyCodes: Array<string>;
+};
+
+/** @internal */
+export const CensusRollupRequest$outboundSchema: z.ZodType<
+  CensusRollupRequest$Outbound,
+  z.ZodTypeDef,
+  CensusRollupRequest
+> = z.object({
+  categoryCodes: z.array(z.string()),
+  datasetCode: z.string(),
+  geographyCodes: z.array(z.string()),
+});
+
+export function censusRollupRequestToJSON(
+  censusRollupRequest: CensusRollupRequest,
+): string {
+  return JSON.stringify(
+    CensusRollupRequest$outboundSchema.parse(censusRollupRequest),
+  );
+}

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

@@ -162,7 +162,7 @@ export type AirTightness = {
 /**
  * Non-null when source value was corrupted/incomplete.
  */
-export const DataQuality = {
+export const EPCDataSchemasFabricFloorDataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
   QualityLabelOnly: "quality_label_only",
   WelshLanguage: "welsh_language",
@@ -172,7 +172,9 @@ export const DataQuality = {
 /**
  * Non-null when source value was corrupted/incomplete.
  */
-export type DataQuality = OpenEnum<typeof DataQuality>;
+export type EPCDataSchemasFabricFloorDataQuality = OpenEnum<
+  typeof EPCDataSchemasFabricFloorDataQuality
+>;
 
 /**
  * Energy efficiency rating.
@@ -249,7 +251,7 @@ export type Floor = {
   /**
    * Non-null when source value was corrupted/incomplete.
    */
-  dataQuality: DataQuality | null;
+  dataQuality: EPCDataSchemasFabricFloorDataQuality | null;
   /**
    * Raw SAP description string.
    */
@@ -1778,11 +1780,11 @@ export function airTightnessFromJSON(
 }
 
 /** @internal */
-export const DataQuality$inboundSchema: z.ZodType<
-  DataQuality,
+export const EPCDataSchemasFabricFloorDataQuality$inboundSchema: z.ZodType<
+  EPCDataSchemasFabricFloorDataQuality,
   z.ZodTypeDef,
   unknown
-> = openEnums.inboundSchema(DataQuality);
+> = openEnums.inboundSchema(EPCDataSchemasFabricFloorDataQuality);
 
 /** @internal */
 export const EPCDataEnergyEfficiency$inboundSchema: z.ZodType<
@@ -1815,7 +1817,7 @@ export const InsulationType$inboundSchema: z.ZodType<
 /** @internal */
 export const Floor$inboundSchema: z.ZodType<Floor, z.ZodTypeDef, unknown> = z
   .object({
-    dataQuality: z.nullable(DataQuality$inboundSchema),
+    dataQuality: z.nullable(EPCDataSchemasFabricFloorDataQuality$inboundSchema),
     description: z.nullable(z.string()),
     energyEfficiency: z.nullable(EPCDataEnergyEfficiency$inboundSchema),
     environmentalEfficiency: z.nullable(

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

@@ -92,6 +92,9 @@ export * from "./catchmentfeature.js";
 export * from "./catchmentfeaturecollection.js";
 export * from "./catchmentmeta.js";
 export * from "./catchmentreference.js";
+export * from "./censusareaprofilerequest.js";
+export * from "./censushealthresponse.js";
+export * from "./censusrolluprequest.js";
 export * from "./changelogentry.js";
 export * from "./changeloglistresponse.js";
 export * from "./chargeentry.js";
@@ -269,6 +272,9 @@ export * from "./propertyqueryrequest.js";
 export * from "./propertytags.js";
 export * from "./propertyvalueimpact.js";
 export * from "./prosperitydata.js";
+export * from "./prosperitydimensionscore.js";
+export * from "./prosperityindicator.js";
+export * from "./prosperitylistresponse.js";
 export * from "./provenance.js";
 export * from "./psc.js";
 export * from "./psclistresponse.js";

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

@@ -26,10 +26,6 @@ import {
   PropertyAddress$inboundSchema,
 } from "./propertyaddress.js";
 import { PropertyTags, PropertyTags$inboundSchema } from "./propertytags.js";
-import {
-  ProsperityData,
-  ProsperityData$inboundSchema,
-} from "./prosperitydata.js";
 import {
   RefurbishmentData,
   RefurbishmentData$inboundSchema,
@@ -401,6 +397,10 @@ export type PropertyDataApiSpatial = {
 };
 
 export type PropertyDataApi = {
+  /**
+   * Per-field provenance for claim-resolved fields. Stored, not indexed; returned on request.
+   */
+  provenance?: { [k: string]: { [k: string]: any } } | undefined;
   address?: PropertyAddress | undefined;
   build?: BuildData | undefined;
   /**
@@ -467,7 +467,6 @@ export type PropertyDataApi = {
    * Unique property identifier
    */
   propertyId?: string | undefined;
-  prosperity?: ProsperityData | undefined;
   refurbishment?: RefurbishmentData | undefined;
   /**
    * Related property IDs
@@ -856,6 +855,7 @@ export const PropertyDataApi$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  _provenance: z.record(z.record(z.any())).optional(),
   address: PropertyAddress$inboundSchema.optional(),
   build: BuildData$inboundSchema.optional(),
   building: z.nullable(z.lazy(() => PropertyDataApiBuilding$inboundSchema))
@@ -879,7 +879,6 @@ export const PropertyDataApi$inboundSchema: z.ZodType<
   pricing: PricingData$inboundSchema.optional(),
   propertyCategory: z.nullable(PropertyCategory$inboundSchema).optional(),
   propertyId: z.string().optional(),
-  prosperity: ProsperityData$inboundSchema.optional(),
   refurbishment: RefurbishmentData$inboundSchema.optional(),
   relationships: z.array(z.string()).optional(),
   roomDetails: RoomDetails$inboundSchema.optional(),
@@ -892,6 +891,10 @@ export const PropertyDataApi$inboundSchema: z.ZodType<
   tenancy: TenancyData$inboundSchema.optional(),
   tenure: TenureData$inboundSchema.optional(),
   unitCount: z.nullable(z.number().int()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "_provenance": "provenance",
+  });
 });
 
 export function propertyDataApiFromJSON(

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

@@ -4,56 +4,100 @@
 
 import * as z from "zod/v3";
 import { safeParse } from "../../../lib/schemas.js";
+import * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
-
-export type Employment = {
+import {
+  ProsperityDimensionScore,
+  ProsperityDimensionScore$inboundSchema,
+} from "./prosperitydimensionscore.js";
+import {
+  ProsperityIndicator,
+  ProsperityIndicator$inboundSchema,
+} from "./prosperityindicator.js";
+
+/**
+ * ONS OAC 2021 geodemographic classification (null for Scotland and Northern Ireland, which have no OAC)
+ */
+export type Classification = {
   /**
-   * Dimension score 0-100
+   * OAC group label — the mid-tier segment
    */
-  score: number;
-};
-
-export type Housing = {
+  groupLabel?: string | undefined;
   /**
-   * Dimension score 0-100
+   * Geodemographic classification scheme, e.g. "oac_2021" (ONS Output Area Classification)
    */
-  score: number;
-};
-
-export type Income = {
+  scheme?: string | undefined;
   /**
-   * Dimension score 0-100
+   * OAC subgroup label — the finest-grain segment
    */
-  score: number;
-};
-
-export type LivingStandards = {
+  subgroup?: string | undefined;
   /**
-   * Dimension score 0-100
+   * OAC supergroup label — the broad "what kind of place" segment
    */
-  score: number;
+  supergroupLabel?: string | undefined;
 };
 
+/**
+ * Worst (lowest-quality) data_quality across the populated dimensions; estimated > limited > partial > full
+ */
+export const DataQuality = {
+  Full: "full",
+  Partial: "partial",
+  Limited: "limited",
+  Estimated: "estimated",
+} as const;
+/**
+ * Worst (lowest-quality) data_quality across the populated dimensions; estimated > limited > partial > full
+ */
+export type DataQuality = OpenEnum<typeof DataQuality>;
+
+/**
+ * Per-dimension prosperity breakdown, keyed by dimension
+ */
 export type Dimensions = {
-  employment?: Employment | undefined;
-  housing?: Housing | undefined;
-  income?: Income | undefined;
-  livingStandards?: LivingStandards | undefined;
+  employment?: ProsperityDimensionScore | undefined;
+  housing?: ProsperityDimensionScore | undefined;
+  income?: ProsperityDimensionScore | undefined;
+  livingStandards?: ProsperityDimensionScore | undefined;
 };
 
 export type ProsperityData = {
   /**
-   * National decile 1-10
+   * ONS OAC 2021 geodemographic classification (null for Scotland and Northern Ireland, which have no OAC)
+   */
+  classification?: Classification | null | undefined;
+  /**
+   * ISO 8601 timestamp when this prosperity score was computed
+   */
+  computedAt: Date;
+  /**
+   * Worst (lowest-quality) data_quality across the populated dimensions; estimated > limited > partial > full
+   */
+  dataQuality: DataQuality;
+  /**
+   * National decile 1-10 (10 = most prosperous)
    */
   decile: number;
+  /**
+   * Per-dimension prosperity breakdown, keyed by dimension
+   */
   dimensions?: Dimensions | undefined;
+  /**
+   * Small-area code this score belongs to (LSOA in England/Wales, Data Zone in Scotland, SOA in NI)
+   */
+  geographicCode: string;
+  /**
+   * Curated array of the underlying indicators (19 ONS/MHCLG measures) that feed the dimensions
+   */
+  indicators?: Array<ProsperityIndicator> | undefined;
   /**
    * National percentile 1-100
    */
   percentile: number;
   /**
-   * Overall prosperity score 0-100
+   * Overall prosperity score 0-100 for the area
    */
   score: number;
   /**
@@ -63,74 +107,33 @@ export type ProsperityData = {
 };
 
 /** @internal */
-export const Employment$inboundSchema: z.ZodType<
-  Employment,
+export const Classification$inboundSchema: z.ZodType<
+  Classification,
   z.ZodTypeDef,
   unknown
 > = z.object({
-  score: z.number(),
+  groupLabel: z.string().optional(),
+  scheme: z.string().optional(),
+  subgroup: z.string().optional(),
+  supergroupLabel: z.string().optional(),
 });
 
-export function employmentFromJSON(
-  jsonString: string,
-): SafeParseResult<Employment, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => Employment$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Employment' from JSON`,
-  );
-}
-
-/** @internal */
-export const Housing$inboundSchema: z.ZodType<Housing, z.ZodTypeDef, unknown> =
-  z.object({
-    score: z.number(),
-  });
-
-export function housingFromJSON(
+export function classificationFromJSON(
   jsonString: string,
-): SafeParseResult<Housing, SDKValidationError> {
+): SafeParseResult<Classification, SDKValidationError> {
   return safeParse(
     jsonString,
-    (x) => Housing$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Housing' from JSON`,
+    (x) => Classification$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Classification' from JSON`,
   );
 }
 
 /** @internal */
-export const Income$inboundSchema: z.ZodType<Income, z.ZodTypeDef, unknown> = z
-  .object({
-    score: z.number(),
-  });
-
-export function incomeFromJSON(
-  jsonString: string,
-): SafeParseResult<Income, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => Income$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Income' from JSON`,
-  );
-}
-
-/** @internal */
-export const LivingStandards$inboundSchema: z.ZodType<
-  LivingStandards,
+export const DataQuality$inboundSchema: z.ZodType<
+  DataQuality,
   z.ZodTypeDef,
   unknown
-> = z.object({
-  score: z.number(),
-});
-
-export function livingStandardsFromJSON(
-  jsonString: string,
-): SafeParseResult<LivingStandards, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => LivingStandards$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'LivingStandards' from JSON`,
-  );
-}
+> = openEnums.inboundSchema(DataQuality);
 
 /** @internal */
 export const Dimensions$inboundSchema: z.ZodType<
@@ -138,10 +141,10 @@ export const Dimensions$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  employment: z.lazy(() => Employment$inboundSchema).optional(),
-  housing: z.lazy(() => Housing$inboundSchema).optional(),
-  income: z.lazy(() => Income$inboundSchema).optional(),
-  livingStandards: z.lazy(() => LivingStandards$inboundSchema).optional(),
+  employment: ProsperityDimensionScore$inboundSchema.optional(),
+  housing: ProsperityDimensionScore$inboundSchema.optional(),
+  income: ProsperityDimensionScore$inboundSchema.optional(),
+  livingStandards: ProsperityDimensionScore$inboundSchema.optional(),
 });
 
 export function dimensionsFromJSON(
@@ -160,8 +163,14 @@ export const ProsperityData$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  classification: z.nullable(z.lazy(() => Classification$inboundSchema))
+    .optional(),
+  computedAt: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  dataQuality: DataQuality$inboundSchema,
   decile: z.number().int(),
   dimensions: z.lazy(() => Dimensions$inboundSchema).optional(),
+  geographicCode: z.string(),
+  indicators: z.array(ProsperityIndicator$inboundSchema).optional(),
   percentile: z.number().int(),
   score: z.number(),
   version: z.string(),

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

@@ -0,0 +1,79 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../../lib/schemas.js";
+import * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Data completeness for this dimension
+ */
+export const ProsperityDimensionScoreDataQuality = {
+  Full: "full",
+  Partial: "partial",
+  Limited: "limited",
+  Estimated: "estimated",
+} as const;
+/**
+ * Data completeness for this dimension
+ */
+export type ProsperityDimensionScoreDataQuality = OpenEnum<
+  typeof ProsperityDimensionScoreDataQuality
+>;
+
+export type ProsperityDimensionScore = {
+  /**
+   * Human-readable weighted formula used to derive the dimension score
+   */
+  calculation: string;
+  /**
+   * Data completeness for this dimension
+   */
+  dataQuality: ProsperityDimensionScoreDataQuality;
+  /**
+   * National percentile for this dimension, 1-100
+   */
+  percentile: number;
+  /**
+   * Dimension score 0-100 (100 = most prosperous)
+   */
+  score: number;
+  /**
+   * This dimension's weight in the overall prosperity score (0-1)
+   */
+  weight: number;
+};
+
+/** @internal */
+export const ProsperityDimensionScoreDataQuality$inboundSchema: z.ZodType<
+  ProsperityDimensionScoreDataQuality,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(ProsperityDimensionScoreDataQuality);
+
+/** @internal */
+export const ProsperityDimensionScore$inboundSchema: z.ZodType<
+  ProsperityDimensionScore,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  calculation: z.string(),
+  dataQuality: ProsperityDimensionScoreDataQuality$inboundSchema,
+  percentile: z.number().int(),
+  score: z.number(),
+  weight: z.number(),
+});
+
+export function prosperityDimensionScoreFromJSON(
+  jsonString: string,
+): SafeParseResult<ProsperityDimensionScore, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ProsperityDimensionScore$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ProsperityDimensionScore' from JSON`,
+  );
+}