@vepler/sdk 2.46.0 → 2.57.3

package/src/lib/encodings.ts

@@ -479,6 +479,23 @@ export const encodeSpaceDelimitedQuery = queryEncoder(encodeSpaceDelimited);
 export const encodePipeDelimitedQuery = queryEncoder(encodePipeDelimited);
 export const encodeDeepObjectQuery = queryEncoder(encodeDeepObject);
 
+function isBlobLike(val: unknown): val is Blob {
+  if (val instanceof Blob) {
+    return true;
+  }
+
+  if (typeof val !== "object" || val == null || !(Symbol.toStringTag in val)) {
+    return false;
+  }
+
+  const tag = val[Symbol.toStringTag];
+  if (tag !== "Blob" && tag !== "File") {
+    return false;
+  }
+
+  return "stream" in val && typeof val.stream === "function";
+}
+
 export function appendForm(
   fd: FormData,
   key: string,
@@ -487,10 +504,12 @@ export function appendForm(
 ): void {
   if (value == null) {
     return;
-  } else if (value instanceof Blob && fileName) {
-    fd.append(key, value, fileName);
-  } else if (value instanceof Blob) {
-    fd.append(key, value);
+  } else if (isBlobLike(value)) {
+    if (fileName) {
+      fd.append(key, value as Blob, fileName);
+    } else {
+      fd.append(key, value as Blob);
+    }
   } else {
     fd.append(key, String(value));
   }

package/src/lib/files.ts

@@ -80,3 +80,25 @@ export function getContentTypeFromFileName(fileName: string): string | null {
 
   return mimeTypes[ext] || null;
 }
+
+/**
+ * Creates a Blob from file content with the given MIME type.
+ *
+ * Node.js Buffers are Uint8Array subclasses that may share a pooled
+ * ArrayBuffer (byteOffset > 0, byteLength < buffer.byteLength). Passing
+ * such a Buffer directly to `new Blob([buf])` can include the entire
+ * underlying pool on some runtimes, producing a Blob with extra bytes
+ * that corrupts multipart uploads.
+ *
+ * Copying into a standalone Uint8Array ensures the Blob receives only the
+ * intended bytes regardless of runtime behaviour.
+ */
+export function bytesToBlob(
+  content: Uint8Array<ArrayBufferLike> | ArrayBuffer | Blob | string,
+  contentType: string,
+): Blob {
+  if (content instanceof Uint8Array) {
+    return new Blob([new Uint8Array(content)], { type: contentType });
+  }
+  return new Blob([content as BlobPart], { type: contentType });
+}

package/src/lib/sdks.ts

@@ -124,13 +124,15 @@ export class ClientSDK {
     if (!base) {
       return ERR(new InvalidRequestError("No base URL provided for operation"));
     }
-    const reqURL = new URL(base);
-    const inputURL = new URL(path, reqURL);
-
+    const baseURL = new URL(base);
+    let reqURL: URL;
     if (path) {
-      reqURL.pathname += reqURL.pathname.endsWith("/") ? "" : "/";
-      reqURL.pathname += inputURL.pathname.replace(/^\/+/, "");
+      baseURL.pathname = baseURL.pathname.replace(/\/+$/, "") + "/";
+      reqURL = new URL(path, baseURL);
+    } else {
+      reqURL = baseURL;
     }
+    reqURL.hash = "";
 
     let finalQuery = query || "";
 

package/src/lib/security.ts

@@ -239,8 +239,9 @@ function applyBearer(
 
 export function resolveGlobalSecurity(
   security: Partial<shared.Security> | null | undefined,
+  allowedFields?: number[],
 ): SecurityState | null {
-  return resolveSecurity(
+  let inputs: SecurityInput[][] = [
     [
       {
         fieldName: "x-api-key",
@@ -248,7 +249,18 @@ export function resolveGlobalSecurity(
         value: security?.apiKeyAuth,
       },
     ],
-  );
+  ];
+
+  if (allowedFields) {
+    inputs = allowedFields.map((i) => {
+      if (i < 0 || i >= inputs.length) {
+        throw new RangeError(`invalid allowedFields index ${i}`);
+      }
+      return inputs[i]!;
+    });
+  }
+
+  return resolveSecurity(...inputs);
 }
 
 export async function extractSecurity<

package/src/lib/url.ts

@@ -13,21 +13,23 @@ export function pathToFunc(
   const paramRE = /\{([a-zA-Z0-9_][a-zA-Z0-9_-]*?)\}/g;
 
   return function buildURLPath(params: Record<string, unknown> = {}): string {
-    return pathPattern.replace(paramRE, function (_, placeholder) {
-      if (!hasOwn.call(params, placeholder)) {
-        throw new Error(`Parameter '${placeholder}' is required`);
-      }
+    return pathPattern
+      .replace(paramRE, function (_, placeholder) {
+        if (!hasOwn.call(params, placeholder)) {
+          throw new Error(`Parameter '${placeholder}' is required`);
+        }
 
-      const value = params[placeholder];
-      if (typeof value !== "string" && typeof value !== "number") {
-        throw new Error(
-          `Parameter '${placeholder}' must be a string or number`,
-        );
-      }
+        const value = params[placeholder];
+        if (typeof value !== "string" && typeof value !== "number") {
+          throw new Error(
+            `Parameter '${placeholder}' must be a string or number`,
+          );
+        }
 
-      return options?.charEncoding === "percent"
-        ? encodeURIComponent(`${value}`)
-        : `${value}`;
-    });
+        return options?.charEncoding === "percent"
+          ? encodeURIComponent(`${value}`)
+          : `${value}`;
+      })
+      .replace(/^\/+/, "");
   };
 }

package/src/sdk/epc.ts

@@ -2,23 +2,55 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import { epcGetByLocationId } from "../funcs/epcGetByLocationId.js";
+import { epcGetEPCByLocationId } from "../funcs/epcGetEPCByLocationId.js";
+import { epcGetEPCHealth } from "../funcs/epcGetEPCHealth.js";
+import { epcQueryEPC } from "../funcs/epcQueryEPC.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as operations from "./models/operations/index.js";
+import * as shared from "./models/shared/index.js";
 import { unwrapAsync } from "./types/fp.js";
 
 export class Epc extends ClientSDK {
   /**
-   * Get EPC records by location ID
+   * Get EPC certificates by location ID
    *
    * @remarks
-   * Retrieve all Energy Performance Certificate (EPC) records for a specific location, ordered by lodgement date (newest first). Returns an empty array if no records are found.
+   * Returns all EPC certificates for a given UPRN, ordered by lodgement date (newest first). Includes domestic, non-domestic, and Display Energy Certificates. Each certificate contains structured energy ratings, building fabric analysis, improvement recommendations with numeric costs, and MEES compliance status.
    */
-  async getByLocationId(
+  async getEpcByLocationId(
     request: operations.GetEpcByLocationIdRequest,
     options?: RequestOptions,
   ): Promise<operations.GetEpcByLocationIdResponseBody> {
-    return unwrapAsync(epcGetByLocationId(
+    return unwrapAsync(epcGetEPCByLocationId(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Health check
+   */
+  async getEpcHealth(
+    options?: RequestOptions,
+  ): Promise<operations.GetEpcHealthResponseBody> {
+    return unwrapAsync(epcGetEPCHealth(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Search EPC certificates
+   *
+   * @remarks
+   * Search and filter EPC certificates by area, energy rating, building fabric, heating system, MEES compliance, and more. Same query interface as the Property API.
+   */
+  async queryEpc(
+    request: shared.EPCQueryRequest,
+    options?: RequestOptions,
+  ): Promise<shared.EPCQueryResponse> {
+    return unwrapAsync(epcQueryEPC(
       this,
       request,
       options,

package/src/sdk/models/errors/getepcbylocationid.ts

@@ -11,79 +11,6 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKBaseError } from "./sdkbaseerror.js";
 import { SDKValidationError } from "./sdkvalidationerror.js";
 
-/**
- * Error type category
- */
-export const GetEPCByLocationIdEPCType = {
-  ApiError: "api_error",
-  InvalidRequestError: "invalid_request_error",
-  AuthenticationError: "authentication_error",
-  RateLimitError: "rate_limit_error",
-} as const;
-/**
- * Error type category
- */
-export type GetEPCByLocationIdEPCType = OpenEnum<
-  typeof GetEPCByLocationIdEPCType
->;
-
-export type GetEPCByLocationIdEPCError = {
-  /**
-   * Machine-readable error code
-   */
-  code?: string | undefined;
-  /**
-   * URL to relevant documentation
-   */
-  docUrl?: string | undefined;
-  /**
-   * Human-readable error message
-   */
-  message: string;
-  /**
-   * Parameter that caused the error
-   */
-  param?: string | undefined;
-  /**
-   * Suggested corrections (e.g. postcode typo suggestions)
-   */
-  suggestions?: Array<string> | undefined;
-  /**
-   * Error type category
-   */
-  type: GetEPCByLocationIdEPCType;
-};
-
-/**
- * Error response
- */
-export type GetEPCByLocationIdEPCResponseBodyData = {
-  error: GetEPCByLocationIdEPCError;
-};
-
-/**
- * Error response
- */
-export class GetEPCByLocationIdEPCResponseBody extends SDKBaseError {
-  error: GetEPCByLocationIdEPCError;
-
-  /** The original data that was passed to this error instance. */
-  data$: GetEPCByLocationIdEPCResponseBodyData;
-
-  constructor(
-    err: GetEPCByLocationIdEPCResponseBodyData,
-    httpMeta: { response: Response; request: Request; body: string },
-  ) {
-    const message = err.error?.message
-      || `API error occurred: ${JSON.stringify(err)}`;
-    super(message, httpMeta);
-    this.data$ = err;
-    this.error = err.error;
-
-    this.name = "GetEPCByLocationIdEPCResponseBody";
-  }
-}
-
 /**
  * Error type category
  */
@@ -155,60 +82,6 @@ export class GetEpcByLocationIdResponseBody extends SDKBaseError {
   }
 }
 
-/** @internal */
-export const GetEPCByLocationIdEPCType$inboundSchema: z.ZodType<
-  GetEPCByLocationIdEPCType,
-  z.ZodTypeDef,
-  unknown
-> = openEnums.inboundSchema(GetEPCByLocationIdEPCType);
-
-/** @internal */
-export const GetEPCByLocationIdEPCError$inboundSchema: z.ZodType<
-  GetEPCByLocationIdEPCError,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  code: z.string().optional(),
-  doc_url: z.string().optional(),
-  message: z.string(),
-  param: z.string().optional(),
-  suggestions: z.array(z.string()).optional(),
-  type: GetEPCByLocationIdEPCType$inboundSchema,
-}).transform((v) => {
-  return remap$(v, {
-    "doc_url": "docUrl",
-  });
-});
-
-export function getEPCByLocationIdEPCErrorFromJSON(
-  jsonString: string,
-): SafeParseResult<GetEPCByLocationIdEPCError, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => GetEPCByLocationIdEPCError$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'GetEPCByLocationIdEPCError' from JSON`,
-  );
-}
-
-/** @internal */
-export const GetEPCByLocationIdEPCResponseBody$inboundSchema: z.ZodType<
-  GetEPCByLocationIdEPCResponseBody,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  error: z.lazy(() => GetEPCByLocationIdEPCError$inboundSchema),
-  request$: z.instanceof(Request),
-  response$: z.instanceof(Response),
-  body$: z.string(),
-})
-  .transform((v) => {
-    return new GetEPCByLocationIdEPCResponseBody(v, {
-      request: v.request$,
-      response: v.response$,
-      body: v.body$,
-    });
-  });
-
 /** @internal */
 export const GetEpcByLocationIdType$inboundSchema: z.ZodType<
   GetEpcByLocationIdType,

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

@@ -71,6 +71,7 @@ export * from "./postv1titledeedstitlenumberpurchase.js";
 export * from "./predictpropertyvalue.js";
 export * from "./predictpropertyvaluebylocation.js";
 export * from "./querycompanies.js";
+export * from "./queryepc.js";
 export * from "./querylistings.js";
 export * from "./querylistingsbysource.js";
 export * from "./querypersons.js";

package/src/sdk/models/errors/queryepc.ts

@@ -0,0 +1,137 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../../lib/primitives.js";
+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 { SDKBaseError } from "./sdkbaseerror.js";
+import { SDKValidationError } from "./sdkvalidationerror.js";
+
+/**
+ * Error type category
+ */
+export const QueryEpcType = {
+  ApiError: "api_error",
+  InvalidRequestError: "invalid_request_error",
+  AuthenticationError: "authentication_error",
+  RateLimitError: "rate_limit_error",
+} as const;
+/**
+ * Error type category
+ */
+export type QueryEpcType = OpenEnum<typeof QueryEpcType>;
+
+export type QueryEpcError = {
+  /**
+   * Machine-readable error code
+   */
+  code?: string | undefined;
+  /**
+   * URL to relevant documentation
+   */
+  docUrl?: string | undefined;
+  /**
+   * Human-readable error message
+   */
+  message: string;
+  /**
+   * Parameter that caused the error
+   */
+  param?: string | undefined;
+  /**
+   * Suggested corrections (e.g. postcode typo suggestions)
+   */
+  suggestions?: Array<string> | undefined;
+  /**
+   * Error type category
+   */
+  type: QueryEpcType;
+};
+
+/**
+ * Error response
+ */
+export type QueryEpcResponseBodyData = {
+  error: QueryEpcError;
+};
+
+/**
+ * Error response
+ */
+export class QueryEpcResponseBody extends SDKBaseError {
+  error: QueryEpcError;
+
+  /** The original data that was passed to this error instance. */
+  data$: QueryEpcResponseBodyData;
+
+  constructor(
+    err: QueryEpcResponseBodyData,
+    httpMeta: { response: Response; request: Request; body: string },
+  ) {
+    const message = err.error?.message
+      || `API error occurred: ${JSON.stringify(err)}`;
+    super(message, httpMeta);
+    this.data$ = err;
+    this.error = err.error;
+
+    this.name = "QueryEpcResponseBody";
+  }
+}
+
+/** @internal */
+export const QueryEpcType$inboundSchema: z.ZodType<
+  QueryEpcType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(QueryEpcType);
+
+/** @internal */
+export const QueryEpcError$inboundSchema: z.ZodType<
+  QueryEpcError,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  code: z.string().optional(),
+  doc_url: z.string().optional(),
+  message: z.string(),
+  param: z.string().optional(),
+  suggestions: z.array(z.string()).optional(),
+  type: QueryEpcType$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "doc_url": "docUrl",
+  });
+});
+
+export function queryEpcErrorFromJSON(
+  jsonString: string,
+): SafeParseResult<QueryEpcError, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => QueryEpcError$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'QueryEpcError' from JSON`,
+  );
+}
+
+/** @internal */
+export const QueryEpcResponseBody$inboundSchema: z.ZodType<
+  QueryEpcResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  error: z.lazy(() => QueryEpcError$inboundSchema),
+  request$: z.instanceof(Request),
+  response$: z.instanceof(Response),
+  body$: z.string(),
+})
+  .transform((v) => {
+    return new QueryEpcResponseBody(v, {
+      request: v.request$,
+      response: v.response$,
+      body: v.body$,
+    });
+  });

package/src/sdk/models/operations/findnearestsubstations.ts

@@ -11,11 +11,11 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type FindNearestSubstationsRequest = {
   /**
-   * Filter by country (ISO 3166-1 alpha-2)
+   * Filter by country code
    */
   country?: string | undefined;
   /**
-   * Latitude of the search point (WGS84)
+   * Latitude of the search point
    */
   lat?: number | null | undefined;
   /**
@@ -23,7 +23,7 @@ export type FindNearestSubstationsRequest = {
    */
   limit?: number | undefined;
   /**
-   * Longitude of the search point (WGS84)
+   * Longitude of the search point
    */
   lon?: number | null | undefined;
   /**
@@ -37,7 +37,7 @@ export type FindNearestSubstationsRequest = {
 };
 
 /**
- * WGS84 coordinate pair
+ * Geographic location of the substation
  */
 export type FindNearestSubstationsCoordinates = {
   /**
@@ -92,7 +92,7 @@ export type Substation = {
    */
   generationHeadroomMw: number | null;
   /**
-   * WGS84 coordinate pair
+   * Geographic location of the substation
    */
   location: FindNearestSubstationsCoordinates | null;
   /**
@@ -108,7 +108,7 @@ export type Substation = {
    */
   operatingRegion: string | null;
   /**
-   * Network operator identifier. Known values include: 'ukpn', 'npg', 'nged', 'ssen', 'spen', 'enw', 'neso'. New operators can be added without code changes.
+   * Network operator that owns and operates this substation
    */
   operator: string;
   /**
@@ -120,7 +120,7 @@ export type Substation = {
    */
   reversePowerCapacityMw: number | null;
   /**
-   * Classification of substation within the electricity network hierarchy. Known values: 'gsp', 'bulk_supply', 'grid', 'primary', 'distribution'. 'gsp' (Grid Supply Point) connects to the national transmission grid. 'bulk_supply' and 'grid' operate at intermediate voltages. 'primary' steps down to 11kV for local distribution. 'distribution' serves end customers at low voltage.
+   * Classification of this substation in the network hierarchy
    */
   substationType: string | null;
   /**

package/src/sdk/models/operations/findsitesbyproperty.ts

@@ -5,6 +5,9 @@
 import * as z from "zod/v3";
 
 export type FindSitesByPropertyRequest = {
+  /**
+   * Unique location identifier (e.g. UPRN in the UK)
+   */
   locationId: string;
 };
 

package/src/sdk/models/operations/findsupplyareabypoint.ts

@@ -11,17 +11,17 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 export type FindSupplyAreaByPointRequest = {
   /**
-   * Latitude of the query point (WGS84)
+   * Latitude of the query point
    */
   lat?: number | null | undefined;
   /**
-   * Longitude of the query point (WGS84)
+   * Longitude of the query point
    */
   lon?: number | null | undefined;
 };
 
 /**
- * WGS84 coordinate pair
+ * Geographic centre point of the supply area
  */
 export type FindSupplyAreaByPointCoordinates = {
   /**
@@ -56,11 +56,11 @@ export type SupplyArea = {
    */
   areaSqkm: number | null;
   /**
-   * Classification of supply area boundary. Each type corresponds to a level in the network hierarchy. Known values: 'gsp', 'bsp', 'grid', 'primary', 'distribution'. 'distribution' is the most granular, 'gsp' (Grid Supply Point) is the broadest.
+   * Level of this boundary in the network hierarchy. More specific types cover smaller geographic areas
    */
   areaType: string | null;
   /**
-   * WGS84 coordinate pair
+   * Geographic centre point of the supply area
    */
   centroid: FindSupplyAreaByPointCoordinates | null;
   /**
@@ -84,7 +84,7 @@ export type SupplyArea = {
    */
   operatingRegion: string | null;
   /**
-   * Network operator identifier. Known values include: 'ukpn', 'npg', 'nged', 'ssen', 'spen', 'enw', 'neso'. New operators can be added without code changes.
+   * Network operator that manages this supply area
    */
   operator: string;
   /**