catastrogps 1.2.1 → 2.1.0

package/dist/index.js

@@ -24,6 +24,7 @@ __export(index_exports, {
   AmbiguousReferenceError: () => AmbiguousReferenceError,
   AuthenticationError: () => AuthenticationError,
   COUNTRY_CODES: () => COUNTRY_CODES,
+  CROP_LANGUAGES: () => CROP_LANGUAGES,
   CatastroGPS: () => CatastroGPS,
   CatastroGPSError: () => CatastroGPSError,
   CoverageError: () => CoverageError,
@@ -126,8 +127,8 @@ var NetworkError = class extends CatastroGPSError {
 };
 function errorFromResponse(status, body, retryAfter, quota) {
   const code = typeof body.code === "string" ? body.code : void 0;
-  const message = typeof body.error === "string" && body.error || typeof body.message === "string" && body.message || `HTTP ${status}`;
-  const details = body.data ?? body.parsed;
+  const message = typeof body.message === "string" && body.message || typeof body.error === "string" && body.error || `HTTP ${status}`;
+  const details = body.details ?? body.data;
   const options = { status, code, details, body };
   if (code === "CNV_AMBIGUOUS" || status === 300) return new AmbiguousReferenceError(message, options);
   if (code === "CNV_COVERAGE") return new CoverageError(message, options);
@@ -156,7 +157,7 @@ function errorFromResponse(status, body, retryAfter, quota) {
 }
 
 // src/resources/export.ts
-var FORMATS = ["kml", "gpx", "dxf"];
+var FORMATS = ["kml", "gpx"];
 var ExportResource = class {
   constructor(client) {
     this.client = client;
@@ -167,8 +168,8 @@ var ExportResource = class {
       throw new CatastroGPSError(`format must be one of ${FORMATS.join(", ")}`);
     }
     if (!reference.trim()) throw new CatastroGPSError("reference must not be empty");
-    return this.client.request("GET", `/api/export/${format}`, {
-      query: { refcat: reference.trim(), country: options.country },
+    return this.client.request("GET", `/v1/export/${format}`, {
+      query: { reference: reference.trim(), country: options.country },
       raw: true
     });
   }
@@ -239,6 +240,7 @@ var ADDRESS_COUNTRY_CODES = [
   "PT"
 ];
 var UNITS_COUNTRY_CODES = ["ES", "PV", "NA"];
+var CROP_LANGUAGES = ["es", "ca", "en", "pt", "fr", "it", "de", "pl", "nl", "cs"];
 
 // src/resources/parcels.ts
 var MIN_COMPARE = 2;
@@ -249,19 +251,29 @@ var ParcelsResource = class {
   }
   client;
   async get(reference, options = {}) {
-    return this.client.request("GET", parcelPath(reference), { query: { country: options.country } });
+    return this.client.request("GET", parcelPath(reference), {
+      query: { country: options.country, lang: options.lang }
+    });
+  }
+  async subparcels(reference, options = {}) {
+    return this.client.request("GET", parcelPath(reference, "/subparcels"), {
+      query: { country: options.country, lang: options.lang }
+    });
+  }
+  async neighbors(reference, options = {}) {
+    return this.client.request("GET", parcelPath(reference, "/neighbors"), { query: { country: options.country } });
   }
   async atPoint(point) {
     if (!Number.isFinite(point.lat) || !Number.isFinite(point.lng)) {
       throw new CatastroGPSError("lat and lng must be finite numbers");
     }
-    return this.client.request("GET", "/api/search/coordinates", {
+    return this.client.request("GET", "/v1/search/coordinates", {
       query: { lat: point.lat, lng: point.lng, country: point.country }
     });
   }
   async findByAddress(address) {
     if (!address.trim()) throw new CatastroGPSError("address must not be empty");
-    return this.client.request("POST", "/api/search/address/parse", { body: { direccion: address } });
+    return this.client.request("POST", "/v1/search/address/parse", { body: { address: address.trim() } });
   }
   async geometry(reference, options = {}) {
     return this.client.request("GET", parcelPath(reference, "/polygon"), { query: { country: options.country } });
@@ -270,10 +282,9 @@ var ParcelsResource = class {
     return this.client.request("GET", parcelPath(reference, "/solar"), { query: { country: options.country } });
   }
   async agriculture(reference, options = {}) {
-    const data = await this.client.request("GET", parcelPath(reference, "/agro"), {
+    return this.client.request("GET", parcelPath(reference, "/agriculture"), {
       query: { country: options.country }
     });
-    return data.agro ?? data;
   }
   async terrain(reference, options = {}) {
     return this.client.request("GET", parcelPath(reference, "/terrain"), { query: locatedQuery(options) });
@@ -296,14 +307,14 @@ var ParcelsResource = class {
     if (parcels.length < MIN_COMPARE || parcels.length > MAX_COMPARE) {
       throw new CatastroGPSError(`compare takes ${MIN_COMPARE} or ${MAX_COMPARE} parcels`);
     }
-    const parcelas = parcels.map((parcel) => {
+    const body = parcels.map((parcel) => {
       if (!parcel.reference?.trim()) throw new CatastroGPSError("reference must not be empty");
       if (!ENRICHMENT_COUNTRY_CODES.includes(parcel.country)) {
         throw new CatastroGPSError(`country must be one of ${ENRICHMENT_COUNTRY_CODES.join(", ")}`);
       }
-      return { ref_catastral: parcel.reference.trim(), country: parcel.country };
+      return { reference: parcel.reference.trim(), country: parcel.country };
     });
-    return this.client.request("POST", "/api/catastro/compare", { body: { parcelas } });
+    return this.client.request("POST", "/v1/parcels/compare", { body: { parcels: body } });
   }
 };
 function locatedQuery(options) {
@@ -317,7 +328,7 @@ function locatedQuery(options) {
 }
 function parcelPath(reference, suffix = "") {
   if (!reference.trim()) throw new CatastroGPSError("reference must not be empty");
-  return `/api/catastro/${encodeURIComponent(reference.trim())}${suffix}`;
+  return `/v1/parcels/${encodeURIComponent(reference.trim())}${suffix}`;
 }
 
 // src/resources/fincas.ts
@@ -330,7 +341,7 @@ var FincasResource = class {
   async searchAddress(query) {
     const params = typeof query === "string" ? { q: query } : query;
     if (!params.q?.trim() && !params.street?.trim()) throw new CatastroGPSError("q or street is required");
-    return this.client.request("GET", "/api/search/address/candidates", {
+    return this.client.request("GET", "/v1/search/address/candidates", {
       query: {
         country: params.country,
         q: params.q?.trim(),
@@ -367,16 +378,16 @@ var FincasResource = class {
     const first = pages[0].data;
     const last = pages[pages.length - 1].data;
     return {
-      refCatastral: first.refCatastral,
-      direccion: first.direccion,
-      codigoPostal: first.codigoPostal,
-      municipio: first.municipio,
-      provincia: first.provincia,
-      usoGeneral: first.usoGeneral,
-      anioConstruccion: first.anioConstruccion,
-      totalUnidadesFinca: last.totalUnidadesFinca ?? pages.reduce((sum, p) => sum + p.data.unidades.length, 0),
-      unidades: pages.flatMap((page) => page.data.unidades),
-      construcciones: pages.flatMap((page) => page.data.construcciones ?? []),
+      reference: first.reference,
+      address: first.address,
+      postalCode: first.postalCode,
+      municipality: first.municipality,
+      region: first.region,
+      mainUse: first.mainUse,
+      yearBuilt: first.yearBuilt,
+      propertyUnitCount: last.propertyUnitCount ?? pages.reduce((sum, p) => sum + p.data.units.length, 0),
+      units: pages.flatMap((page) => page.data.units),
+      constructions: pages.flatMap((page) => page.data.constructions ?? []),
       dataSource: first.dataSource,
       dataDate: first.dataDate,
       attribution: first.attribution,
@@ -386,11 +397,41 @@ var FincasResource = class {
   }
 };
 
+// src/resources/locations.ts
+var LocationsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async provinces() {
+    return this.client.request("GET", "/v1/locations/provinces");
+  }
+  async municipalities(region) {
+    return this.client.request("GET", "/v1/locations/municipalities", {
+      query: { region: required(region, "region") }
+    });
+  }
+  async streets(query) {
+    return this.client.request("GET", "/v1/locations/streets", {
+      query: {
+        region: required(query.region, "region"),
+        municipality: required(query.municipality, "municipality"),
+        name: query.name?.trim()
+      }
+    });
+  }
+};
+function required(value, name) {
+  const trimmed = value?.trim();
+  if (!trimmed) throw new CatastroGPSError(`${name} must not be empty`);
+  return trimmed;
+}
+
 // src/version.ts
-var VERSION = "1.2.1";
+var VERSION = "2.1.0";
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://api.catastrogps.es";
+var DEFAULT_BASE_URL = "https://api.parcelgps.com";
 var DEFAULT_TIMEOUT_MS = 3e4;
 var DEFAULT_MAX_RETRIES = 2;
 var BACKOFF_BASE_MS = 500;
@@ -401,6 +442,7 @@ var CatastroGPS = class {
   parcels;
   export;
   fincas;
+  locations;
   lastQuota;
   apiKey;
   baseUrl;
@@ -426,6 +468,7 @@ var CatastroGPS = class {
     this.parcels = new ParcelsResource(this);
     this.export = new ExportResource(this);
     this.fincas = new FincasResource(this);
+    this.locations = new LocationsResource(this);
   }
   async searchAddressCandidates(query) {
     return this.fincas.searchAddress(query);
@@ -437,7 +480,10 @@ var CatastroGPS = class {
     return this.fincas.pages(refcat14, options);
   }
   async resolve(text, options = {}) {
-    return this.request("GET", "/api/resolve", { query: { q: text, hint: options.hint } });
+    return this.request("GET", "/v1/resolve", { query: { q: text, hint: options.hint } });
+  }
+  async cropCatalog(options = {}) {
+    return this.request("GET", "/v1/reference/crops", { query: { lang: options.lang } });
   }
   async request(method, path, options = {}) {
     const result = await this.conditionalRequest(method, path, options);
@@ -584,6 +630,7 @@ function sleep(ms) {
   AmbiguousReferenceError,
   AuthenticationError,
   COUNTRY_CODES,
+  CROP_LANGUAGES,
   CatastroGPS,
   CatastroGPSError,
   CoverageError,

package/dist/index.mjs

@@ -77,8 +77,8 @@ var NetworkError = class extends CatastroGPSError {
 };
 function errorFromResponse(status, body, retryAfter, quota) {
   const code = typeof body.code === "string" ? body.code : void 0;
-  const message = typeof body.error === "string" && body.error || typeof body.message === "string" && body.message || `HTTP ${status}`;
-  const details = body.data ?? body.parsed;
+  const message = typeof body.message === "string" && body.message || typeof body.error === "string" && body.error || `HTTP ${status}`;
+  const details = body.details ?? body.data;
   const options = { status, code, details, body };
   if (code === "CNV_AMBIGUOUS" || status === 300) return new AmbiguousReferenceError(message, options);
   if (code === "CNV_COVERAGE") return new CoverageError(message, options);
@@ -107,7 +107,7 @@ function errorFromResponse(status, body, retryAfter, quota) {
 }
 
 // src/resources/export.ts
-var FORMATS = ["kml", "gpx", "dxf"];
+var FORMATS = ["kml", "gpx"];
 var ExportResource = class {
   constructor(client) {
     this.client = client;
@@ -118,8 +118,8 @@ var ExportResource = class {
       throw new CatastroGPSError(`format must be one of ${FORMATS.join(", ")}`);
     }
     if (!reference.trim()) throw new CatastroGPSError("reference must not be empty");
-    return this.client.request("GET", `/api/export/${format}`, {
-      query: { refcat: reference.trim(), country: options.country },
+    return this.client.request("GET", `/v1/export/${format}`, {
+      query: { reference: reference.trim(), country: options.country },
       raw: true
     });
   }
@@ -190,6 +190,7 @@ var ADDRESS_COUNTRY_CODES = [
   "PT"
 ];
 var UNITS_COUNTRY_CODES = ["ES", "PV", "NA"];
+var CROP_LANGUAGES = ["es", "ca", "en", "pt", "fr", "it", "de", "pl", "nl", "cs"];
 
 // src/resources/parcels.ts
 var MIN_COMPARE = 2;
@@ -200,19 +201,29 @@ var ParcelsResource = class {
   }
   client;
   async get(reference, options = {}) {
-    return this.client.request("GET", parcelPath(reference), { query: { country: options.country } });
+    return this.client.request("GET", parcelPath(reference), {
+      query: { country: options.country, lang: options.lang }
+    });
+  }
+  async subparcels(reference, options = {}) {
+    return this.client.request("GET", parcelPath(reference, "/subparcels"), {
+      query: { country: options.country, lang: options.lang }
+    });
+  }
+  async neighbors(reference, options = {}) {
+    return this.client.request("GET", parcelPath(reference, "/neighbors"), { query: { country: options.country } });
   }
   async atPoint(point) {
     if (!Number.isFinite(point.lat) || !Number.isFinite(point.lng)) {
       throw new CatastroGPSError("lat and lng must be finite numbers");
     }
-    return this.client.request("GET", "/api/search/coordinates", {
+    return this.client.request("GET", "/v1/search/coordinates", {
       query: { lat: point.lat, lng: point.lng, country: point.country }
     });
   }
   async findByAddress(address) {
     if (!address.trim()) throw new CatastroGPSError("address must not be empty");
-    return this.client.request("POST", "/api/search/address/parse", { body: { direccion: address } });
+    return this.client.request("POST", "/v1/search/address/parse", { body: { address: address.trim() } });
   }
   async geometry(reference, options = {}) {
     return this.client.request("GET", parcelPath(reference, "/polygon"), { query: { country: options.country } });
@@ -221,10 +232,9 @@ var ParcelsResource = class {
     return this.client.request("GET", parcelPath(reference, "/solar"), { query: { country: options.country } });
   }
   async agriculture(reference, options = {}) {
-    const data = await this.client.request("GET", parcelPath(reference, "/agro"), {
+    return this.client.request("GET", parcelPath(reference, "/agriculture"), {
       query: { country: options.country }
     });
-    return data.agro ?? data;
   }
   async terrain(reference, options = {}) {
     return this.client.request("GET", parcelPath(reference, "/terrain"), { query: locatedQuery(options) });
@@ -247,14 +257,14 @@ var ParcelsResource = class {
     if (parcels.length < MIN_COMPARE || parcels.length > MAX_COMPARE) {
       throw new CatastroGPSError(`compare takes ${MIN_COMPARE} or ${MAX_COMPARE} parcels`);
     }
-    const parcelas = parcels.map((parcel) => {
+    const body = parcels.map((parcel) => {
       if (!parcel.reference?.trim()) throw new CatastroGPSError("reference must not be empty");
       if (!ENRICHMENT_COUNTRY_CODES.includes(parcel.country)) {
         throw new CatastroGPSError(`country must be one of ${ENRICHMENT_COUNTRY_CODES.join(", ")}`);
       }
-      return { ref_catastral: parcel.reference.trim(), country: parcel.country };
+      return { reference: parcel.reference.trim(), country: parcel.country };
     });
-    return this.client.request("POST", "/api/catastro/compare", { body: { parcelas } });
+    return this.client.request("POST", "/v1/parcels/compare", { body: { parcels: body } });
   }
 };
 function locatedQuery(options) {
@@ -268,7 +278,7 @@ function locatedQuery(options) {
 }
 function parcelPath(reference, suffix = "") {
   if (!reference.trim()) throw new CatastroGPSError("reference must not be empty");
-  return `/api/catastro/${encodeURIComponent(reference.trim())}${suffix}`;
+  return `/v1/parcels/${encodeURIComponent(reference.trim())}${suffix}`;
 }
 
 // src/resources/fincas.ts
@@ -281,7 +291,7 @@ var FincasResource = class {
   async searchAddress(query) {
     const params = typeof query === "string" ? { q: query } : query;
     if (!params.q?.trim() && !params.street?.trim()) throw new CatastroGPSError("q or street is required");
-    return this.client.request("GET", "/api/search/address/candidates", {
+    return this.client.request("GET", "/v1/search/address/candidates", {
       query: {
         country: params.country,
         q: params.q?.trim(),
@@ -318,16 +328,16 @@ var FincasResource = class {
     const first = pages[0].data;
     const last = pages[pages.length - 1].data;
     return {
-      refCatastral: first.refCatastral,
-      direccion: first.direccion,
-      codigoPostal: first.codigoPostal,
-      municipio: first.municipio,
-      provincia: first.provincia,
-      usoGeneral: first.usoGeneral,
-      anioConstruccion: first.anioConstruccion,
-      totalUnidadesFinca: last.totalUnidadesFinca ?? pages.reduce((sum, p) => sum + p.data.unidades.length, 0),
-      unidades: pages.flatMap((page) => page.data.unidades),
-      construcciones: pages.flatMap((page) => page.data.construcciones ?? []),
+      reference: first.reference,
+      address: first.address,
+      postalCode: first.postalCode,
+      municipality: first.municipality,
+      region: first.region,
+      mainUse: first.mainUse,
+      yearBuilt: first.yearBuilt,
+      propertyUnitCount: last.propertyUnitCount ?? pages.reduce((sum, p) => sum + p.data.units.length, 0),
+      units: pages.flatMap((page) => page.data.units),
+      constructions: pages.flatMap((page) => page.data.constructions ?? []),
       dataSource: first.dataSource,
       dataDate: first.dataDate,
       attribution: first.attribution,
@@ -337,11 +347,41 @@ var FincasResource = class {
   }
 };
 
+// src/resources/locations.ts
+var LocationsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async provinces() {
+    return this.client.request("GET", "/v1/locations/provinces");
+  }
+  async municipalities(region) {
+    return this.client.request("GET", "/v1/locations/municipalities", {
+      query: { region: required(region, "region") }
+    });
+  }
+  async streets(query) {
+    return this.client.request("GET", "/v1/locations/streets", {
+      query: {
+        region: required(query.region, "region"),
+        municipality: required(query.municipality, "municipality"),
+        name: query.name?.trim()
+      }
+    });
+  }
+};
+function required(value, name) {
+  const trimmed = value?.trim();
+  if (!trimmed) throw new CatastroGPSError(`${name} must not be empty`);
+  return trimmed;
+}
+
 // src/version.ts
-var VERSION = "1.2.1";
+var VERSION = "2.1.0";
 
 // src/client.ts
-var DEFAULT_BASE_URL = "https://api.catastrogps.es";
+var DEFAULT_BASE_URL = "https://api.parcelgps.com";
 var DEFAULT_TIMEOUT_MS = 3e4;
 var DEFAULT_MAX_RETRIES = 2;
 var BACKOFF_BASE_MS = 500;
@@ -352,6 +392,7 @@ var CatastroGPS = class {
   parcels;
   export;
   fincas;
+  locations;
   lastQuota;
   apiKey;
   baseUrl;
@@ -377,6 +418,7 @@ var CatastroGPS = class {
     this.parcels = new ParcelsResource(this);
     this.export = new ExportResource(this);
     this.fincas = new FincasResource(this);
+    this.locations = new LocationsResource(this);
   }
   async searchAddressCandidates(query) {
     return this.fincas.searchAddress(query);
@@ -388,7 +430,10 @@ var CatastroGPS = class {
     return this.fincas.pages(refcat14, options);
   }
   async resolve(text, options = {}) {
-    return this.request("GET", "/api/resolve", { query: { q: text, hint: options.hint } });
+    return this.request("GET", "/v1/resolve", { query: { q: text, hint: options.hint } });
+  }
+  async cropCatalog(options = {}) {
+    return this.request("GET", "/v1/reference/crops", { query: { lang: options.lang } });
   }
   async request(method, path, options = {}) {
     const result = await this.conditionalRequest(method, path, options);
@@ -534,6 +579,7 @@ export {
   AmbiguousReferenceError,
   AuthenticationError,
   COUNTRY_CODES,
+  CROP_LANGUAGES,
   CatastroGPS,
   CatastroGPSError,
   CoverageError,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "catastrogps",
-  "version": "1.2.1",
-  "description": "Official JavaScript/TypeScript client for the Catastro GPS API: parcels from 29 European countries (31 official cadastres, including the Basque Country and Navarre) by reference, coordinates or address; building units, terrain, ground motion, solar and more",
+  "version": "2.1.0",
+  "description": "Official JavaScript/TypeScript client for the Catastro GPS API: parcels from 29 European countries (including the Basque Country and Navarre foral cadastres) by reference, coordinates or address; building units, terrain, ground motion, solar and more",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",