@vepler/sdk 2.167.0 → 3.0.0

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

@@ -0,0 +1,181 @@
+/*
+ * 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";
+import {
+  GeocodePrecision,
+  GeocodePrecision$inboundSchema,
+} from "./geocodeprecision.js";
+
+/**
+ * Street extent
+ */
+export type BoundingBox = {
+  /**
+   * Eastern boundary (max longitude)
+   */
+  east: number;
+  /**
+   * Northern boundary (max latitude)
+   */
+  north: number;
+  /**
+   * Southern boundary (min latitude)
+   */
+  south: number;
+  /**
+   * Western boundary (min longitude)
+   */
+  west: number;
+};
+
+/**
+ * Representative point for the street (centre)
+ */
+export type StreetMatchCoordinates = {
+  /**
+   * Latitude in decimal degrees
+   */
+  lat: number;
+  /**
+   * Longitude in decimal degrees
+   */
+  lng: number;
+};
+
+/**
+ * A named-street geocoding result, keyed on USRN
+ */
+export type StreetMatch = {
+  /**
+   * Administrative area
+   */
+  administrativeArea?: string | undefined;
+  /**
+   * Street extent
+   */
+  boundingBox?: BoundingBox | undefined;
+  /**
+   * Match confidence (0-100)
+   */
+  confidence: number;
+  /**
+   * ISO 3166-1 alpha-2 country code of the street
+   */
+  country: string;
+  /**
+   * Distance from the query point in metres, when a point was supplied
+   */
+  distance?: number | undefined;
+  /**
+   * Result granularity discriminator
+   */
+  granularity: "street";
+  /**
+   * Stable, provider-namespaced street identity in the form `<country>-<scheme>:<value>`, unique across countries. Key street results on this rather than on a national id (which differs per country — USRN in Great Britain, other schemes elsewhere).
+   */
+  id: string;
+  /**
+   * Locality within the town
+   */
+  locality?: string | undefined;
+  /**
+   * Representative point for the street (centre)
+   */
+  location: StreetMatchCoordinates;
+  /**
+   * Street name
+   */
+  name: string;
+  precision: GeocodePrecision;
+  /**
+   * Number of addressable properties on the street
+   */
+  propertyCount?: number | undefined;
+  /**
+   * Town / post town
+   */
+  town?: string | undefined;
+  /**
+   * Unique Street Reference Number — the statutory Great Britain street id (GB results only)
+   */
+  usrn?: number | undefined;
+};
+
+/** @internal */
+export const BoundingBox$inboundSchema: z.ZodType<
+  BoundingBox,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  east: z.number(),
+  north: z.number(),
+  south: z.number(),
+  west: z.number(),
+});
+
+export function boundingBoxFromJSON(
+  jsonString: string,
+): SafeParseResult<BoundingBox, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BoundingBox$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BoundingBox' from JSON`,
+  );
+}
+
+/** @internal */
+export const StreetMatchCoordinates$inboundSchema: z.ZodType<
+  StreetMatchCoordinates,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  lat: z.number(),
+  lng: z.number(),
+});
+
+export function streetMatchCoordinatesFromJSON(
+  jsonString: string,
+): SafeParseResult<StreetMatchCoordinates, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StreetMatchCoordinates$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StreetMatchCoordinates' from JSON`,
+  );
+}
+
+/** @internal */
+export const StreetMatch$inboundSchema: z.ZodType<
+  StreetMatch,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  administrativeArea: z.string().optional(),
+  boundingBox: z.lazy(() => BoundingBox$inboundSchema).optional(),
+  confidence: z.number(),
+  country: z.string(),
+  distance: z.number().optional(),
+  granularity: z.literal("street"),
+  id: z.string(),
+  locality: z.string().optional(),
+  location: z.lazy(() => StreetMatchCoordinates$inboundSchema),
+  name: z.string(),
+  precision: GeocodePrecision$inboundSchema,
+  propertyCount: z.number().optional(),
+  town: z.string().optional(),
+  usrn: z.number().optional(),
+});
+
+export function streetMatchFromJSON(
+  jsonString: string,
+): SafeParseResult<StreetMatch, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StreetMatch$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StreetMatch' from JSON`,
+  );
+}

package/src/sdk/models/shared/{extractionrestriction.ts → titlecovenant.ts}

@@ -7,17 +7,26 @@ import { safeParse } from "../../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
-export type ExtractionRestriction = {
+export type TitleCovenant = {
   date: string | null;
+  /**
+   * Legal text quoted verbatim from the register entry
+   */
   rawText: string;
   sourceEntryRef: string;
+  /**
+   * Short summary label
+   */
   title: string;
+  /**
+   * AI-authored plain-language explanation
+   */
   whyThisMatters: string;
 };
 
 /** @internal */
-export const ExtractionRestriction$inboundSchema: z.ZodType<
-  ExtractionRestriction,
+export const TitleCovenant$inboundSchema: z.ZodType<
+  TitleCovenant,
   z.ZodTypeDef,
   unknown
 > = z.object({
@@ -28,12 +37,12 @@ export const ExtractionRestriction$inboundSchema: z.ZodType<
   whyThisMatters: z.string(),
 });
 
-export function extractionRestrictionFromJSON(
+export function titleCovenantFromJSON(
   jsonString: string,
-): SafeParseResult<ExtractionRestriction, SDKValidationError> {
+): SafeParseResult<TitleCovenant, SDKValidationError> {
   return safeParse(
     jsonString,
-    (x) => ExtractionRestriction$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'ExtractionRestriction' from JSON`,
+    (x) => TitleCovenant$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TitleCovenant' from JSON`,
   );
 }

package/src/sdk/models/shared/{extractiondocumentsummary.ts → titledocumentsummary.ts}

@@ -16,22 +16,22 @@ export const DocumentType = {
 } as const;
 export type DocumentType = OpenEnum<typeof DocumentType>;
 
-export const ExtractionDocumentSummaryStatus = {
+export const TitleDocumentSummaryStatus = {
   Pending: "pending",
   Uploaded: "uploaded",
   Failed: "failed",
 } as const;
-export type ExtractionDocumentSummaryStatus = OpenEnum<
-  typeof ExtractionDocumentSummaryStatus
+export type TitleDocumentSummaryStatus = OpenEnum<
+  typeof TitleDocumentSummaryStatus
 >;
 
-export type ExtractionDocumentSummary = {
+export type TitleDocumentSummary = {
   description: string;
   displayName: string;
   documentType: DocumentType;
   sizeBytes: number | null;
-  status: ExtractionDocumentSummaryStatus;
-  uploadedAt: string | null;
+  status: TitleDocumentSummaryStatus;
+  uploadedAt: Date | null;
 };
 
 /** @internal */
@@ -42,32 +42,34 @@ export const DocumentType$inboundSchema: z.ZodType<
 > = openEnums.inboundSchema(DocumentType);
 
 /** @internal */
-export const ExtractionDocumentSummaryStatus$inboundSchema: z.ZodType<
-  ExtractionDocumentSummaryStatus,
+export const TitleDocumentSummaryStatus$inboundSchema: z.ZodType<
+  TitleDocumentSummaryStatus,
   z.ZodTypeDef,
   unknown
-> = openEnums.inboundSchema(ExtractionDocumentSummaryStatus);
+> = openEnums.inboundSchema(TitleDocumentSummaryStatus);
 
 /** @internal */
-export const ExtractionDocumentSummary$inboundSchema: z.ZodType<
-  ExtractionDocumentSummary,
+export const TitleDocumentSummary$inboundSchema: z.ZodType<
+  TitleDocumentSummary,
   z.ZodTypeDef,
   unknown
 > = z.object({
   description: z.string(),
   displayName: z.string(),
   documentType: DocumentType$inboundSchema,
-  sizeBytes: z.nullable(z.number()),
-  status: ExtractionDocumentSummaryStatus$inboundSchema,
-  uploadedAt: z.nullable(z.string()),
+  sizeBytes: z.nullable(z.number().int()),
+  status: TitleDocumentSummaryStatus$inboundSchema,
+  uploadedAt: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ),
 });
 
-export function extractionDocumentSummaryFromJSON(
+export function titleDocumentSummaryFromJSON(
   jsonString: string,
-): SafeParseResult<ExtractionDocumentSummary, SDKValidationError> {
+): SafeParseResult<TitleDocumentSummary, SDKValidationError> {
   return safeParse(
     jsonString,
-    (x) => ExtractionDocumentSummary$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'ExtractionDocumentSummary' from JSON`,
+    (x) => TitleDocumentSummary$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TitleDocumentSummary' from JSON`,
   );
 }

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

@@ -0,0 +1,170 @@
+/*
+ * 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";
+import {
+  RegisteredCharges,
+  RegisteredCharges$inboundSchema,
+} from "./registeredcharges.js";
+import { TitleCovenant, TitleCovenant$inboundSchema } from "./titlecovenant.js";
+import {
+  TitleDocumentSummary,
+  TitleDocumentSummary$inboundSchema,
+} from "./titledocumentsummary.js";
+import { TitleNotice, TitleNotice$inboundSchema } from "./titlenotice.js";
+import {
+  TitleProprietor,
+  TitleProprietor$inboundSchema,
+} from "./titleproprietor.js";
+import {
+  TitleRestriction,
+  TitleRestriction$inboundSchema,
+} from "./titlerestriction.js";
+import {
+  TitleScheduleNoticeOfLease,
+  TitleScheduleNoticeOfLease$inboundSchema,
+} from "./titleschedulenoticeoflease.js";
+import {
+  TitleSummaryCounts,
+  TitleSummaryCounts$inboundSchema,
+} from "./titlesummarycounts.js";
+
+/**
+ * Class of title from the register (possessory/qualified = material defect). null when not stated.
+ */
+export const ClassOfTitle = {
+  Absolute: "absolute",
+  GoodLeasehold: "good_leasehold",
+  Possessory: "possessory",
+  Qualified: "qualified",
+  Other: "other",
+} as const;
+/**
+ * Class of title from the register (possessory/qualified = material defect). null when not stated.
+ */
+export type ClassOfTitle = OpenEnum<typeof ClassOfTitle>;
+
+export type Ownership = {
+  proprietors: Array<TitleProprietor>;
+};
+
+export const Tenure = {
+  Freehold: "freehold",
+  Leasehold: "leasehold",
+  Commonhold: "commonhold",
+} as const;
+export type Tenure = OpenEnum<typeof Tenure>;
+
+export type TitleExtractionPayload = {
+  /**
+   * Class of title from the register (possessory/qualified = material defect). null when not stated.
+   */
+  classOfTitle: ClassOfTitle | null;
+  covenants: Array<TitleCovenant>;
+  /**
+   * Display string for the current owner card on the summary page.
+   */
+  currentOwnerDisplay: string;
+  documents: Array<TitleDocumentSummary>;
+  extractedAt: Date;
+  /**
+   * 'Not applicable for freehold' or a human lease term summary.
+   */
+  leaseTermDescription: string;
+  notices: Array<TitleNotice>;
+  ownership: Ownership;
+  promptVersion: string;
+  /**
+   * Verbatim QUALIFICATION entry text on qualified titles; null otherwise.
+   */
+  qualification: string | null;
+  /**
+   * Edition date of the HMLR register at time of extract
+   */
+  registerAsOf: Date;
+  registeredCharges: RegisteredCharges;
+  restrictions: Array<TitleRestriction>;
+  /**
+   * Sub-leases noted against the title (schedule of notices of leases), verbatim.
+   */
+  scheduleOfNoticesOfLeases?: Array<TitleScheduleNoticeOfLease> | undefined;
+  summaryCounts: TitleSummaryCounts;
+  tenure: Tenure;
+  titleNumber: string;
+};
+
+/** @internal */
+export const ClassOfTitle$inboundSchema: z.ZodType<
+  ClassOfTitle,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(ClassOfTitle);
+
+/** @internal */
+export const Ownership$inboundSchema: z.ZodType<
+  Ownership,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  proprietors: z.array(TitleProprietor$inboundSchema),
+});
+
+export function ownershipFromJSON(
+  jsonString: string,
+): SafeParseResult<Ownership, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Ownership$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Ownership' from JSON`,
+  );
+}
+
+/** @internal */
+export const Tenure$inboundSchema: z.ZodType<Tenure, z.ZodTypeDef, unknown> =
+  openEnums.inboundSchema(Tenure);
+
+/** @internal */
+export const TitleExtractionPayload$inboundSchema: z.ZodType<
+  TitleExtractionPayload,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  classOfTitle: z.nullable(ClassOfTitle$inboundSchema).default(null),
+  covenants: z.array(TitleCovenant$inboundSchema),
+  currentOwnerDisplay: z.string(),
+  documents: z.array(TitleDocumentSummary$inboundSchema),
+  extractedAt: z.string().datetime({ offset: true }).transform(v =>
+    new Date(v)
+  ),
+  leaseTermDescription: z.string(),
+  notices: z.array(TitleNotice$inboundSchema),
+  ownership: z.lazy(() => Ownership$inboundSchema),
+  promptVersion: z.string(),
+  qualification: z.nullable(z.string()).default(null),
+  registerAsOf: z.string().datetime({ offset: true }).transform(v =>
+    new Date(v)
+  ),
+  registeredCharges: RegisteredCharges$inboundSchema,
+  restrictions: z.array(TitleRestriction$inboundSchema),
+  scheduleOfNoticesOfLeases: z.array(TitleScheduleNoticeOfLease$inboundSchema)
+    .optional(),
+  summaryCounts: TitleSummaryCounts$inboundSchema,
+  tenure: Tenure$inboundSchema,
+  titleNumber: z.string(),
+});
+
+export function titleExtractionPayloadFromJSON(
+  jsonString: string,
+): SafeParseResult<TitleExtractionPayload, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TitleExtractionPayload$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TitleExtractionPayload' from JSON`,
+  );
+}

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

@@ -10,9 +10,9 @@ import { ClosedEnum, OpenEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 import {
-  ExtractionPayload,
-  ExtractionPayload$inboundSchema,
-} from "./extractionpayload.js";
+  TitleExtractionPayload,
+  TitleExtractionPayload$inboundSchema,
+} from "./titleextractionpayload.js";
 
 export const TitleExtractionPollResponseObject = {
   TitleExtraction: "title_extraction",
@@ -32,7 +32,7 @@ export type TitleExtractionPollResponseStatus = OpenEnum<
 >;
 
 export type TitleExtractionPollResponse = {
-  extraction: ExtractionPayload | null;
+  extraction: TitleExtractionPayload | null;
   failureCode: string | null;
   failureMessage: string | null;
   object: TitleExtractionPollResponseObject;
@@ -58,7 +58,7 @@ export const TitleExtractionPollResponse$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  extraction: z.nullable(ExtractionPayload$inboundSchema),
+  extraction: z.nullable(TitleExtractionPayload$inboundSchema),
   failure_code: z.nullable(z.string()),
   failure_message: z.nullable(z.string()),
   object: TitleExtractionPollResponseObject$inboundSchema,

package/src/sdk/models/shared/{extractionnotice.ts → titlenotice.ts}

@@ -18,13 +18,22 @@ export const NoticeType = {
 } as const;
 export type NoticeType = OpenEnum<typeof NoticeType>;
 
-export type ExtractionNotice = {
+export type TitleNotice = {
   date: string | null;
   noticeType: NoticeType;
   partyName: string | null;
+  /**
+   * Legal text quoted verbatim from the register entry
+   */
   rawText: string;
   sourceEntryRef: string;
+  /**
+   * Short summary label
+   */
   title: string;
+  /**
+   * AI-authored plain-language explanation
+   */
   whyThisMatters: string;
 };
 
@@ -36,8 +45,8 @@ export const NoticeType$inboundSchema: z.ZodType<
 > = openEnums.inboundSchema(NoticeType);
 
 /** @internal */
-export const ExtractionNotice$inboundSchema: z.ZodType<
-  ExtractionNotice,
+export const TitleNotice$inboundSchema: z.ZodType<
+  TitleNotice,
   z.ZodTypeDef,
   unknown
 > = z.object({
@@ -50,12 +59,12 @@ export const ExtractionNotice$inboundSchema: z.ZodType<
   whyThisMatters: z.string(),
 });
 
-export function extractionNoticeFromJSON(
+export function titleNoticeFromJSON(
   jsonString: string,
-): SafeParseResult<ExtractionNotice, SDKValidationError> {
+): SafeParseResult<TitleNotice, SDKValidationError> {
   return safeParse(
     jsonString,
-    (x) => ExtractionNotice$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'ExtractionNotice' from JSON`,
+    (x) => TitleNotice$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TitleNotice' from JSON`,
   );
 }

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

@@ -0,0 +1,90 @@
+/*
+ * 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";
+
+export const EntityType = {
+  Individual: "individual",
+  LimitedCompany: "limited_company",
+  Llp: "llp",
+  CorporateBody: "corporate_body",
+  LocalAuthority: "local_authority",
+  CountyCouncil: "county_council",
+  RegisteredSociety: "registered_society",
+  HousingAssociation: "housing_association",
+  UnlimitedCompany: "unlimited_company",
+  OverseasCompany: "overseas_company",
+  Charity: "charity",
+  Unknown: "unknown",
+} as const;
+export type EntityType = OpenEnum<typeof EntityType>;
+
+export type TitleProprietor = {
+  /**
+   * Registered addresses for this proprietor (max 3, per HMLR cap)
+   */
+  addresses: Array<string>;
+  /**
+   * UK Companies House registration number
+   */
+  companyRegistrationNumber: string | null;
+  /**
+   * Country of incorporation
+   */
+  countryIncorporated: string | null;
+  entityType: EntityType;
+  forenames: string | null;
+  /**
+   * Display name — full name for individuals, company/trust name for organisations
+   */
+  name: string;
+  /**
+   * Overseas registration / UK regn code
+   */
+  overseasRegistrationNumber: string | null;
+  /**
+   * 1-based position within the proprietorship register
+   */
+  proprietorOrder: number;
+  surname: string | null;
+};
+
+/** @internal */
+export const EntityType$inboundSchema: z.ZodType<
+  EntityType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(EntityType);
+
+/** @internal */
+export const TitleProprietor$inboundSchema: z.ZodType<
+  TitleProprietor,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  addresses: z.array(z.string()),
+  companyRegistrationNumber: z.nullable(z.string()),
+  countryIncorporated: z.nullable(z.string()),
+  entityType: EntityType$inboundSchema,
+  forenames: z.nullable(z.string()),
+  name: z.string(),
+  overseasRegistrationNumber: z.nullable(z.string()),
+  proprietorOrder: z.number().int(),
+  surname: z.nullable(z.string()),
+});
+
+export function titleProprietorFromJSON(
+  jsonString: string,
+): SafeParseResult<TitleProprietor, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TitleProprietor$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TitleProprietor' from JSON`,
+  );
+}

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

@@ -0,0 +1,48 @@
+/*
+ * 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 TitleRestriction = {
+  date: string | null;
+  /**
+   * Legal text quoted verbatim from the register entry
+   */
+  rawText: string;
+  sourceEntryRef: string;
+  /**
+   * Short summary label
+   */
+  title: string;
+  /**
+   * AI-authored plain-language explanation
+   */
+  whyThisMatters: string;
+};
+
+/** @internal */
+export const TitleRestriction$inboundSchema: z.ZodType<
+  TitleRestriction,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  date: z.nullable(z.string()),
+  rawText: z.string(),
+  sourceEntryRef: z.string(),
+  title: z.string(),
+  whyThisMatters: z.string(),
+});
+
+export function titleRestrictionFromJSON(
+  jsonString: string,
+): SafeParseResult<TitleRestriction, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TitleRestriction$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TitleRestriction' from JSON`,
+  );
+}