@seta-labs/geo 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @seta-labs/geo
 
+## 0.5.0
+
+- `comuni(query?)` takes `storici`: with `true` the list also returns the
+  municipalities suppressed since 1991; without it only the current ones.
+- `TerritoryComune` (the list rows and the `comune` block of
+  `comune(codComune)`) gains `costituitoIl` and `soppressoIl` (`YYYY-MM-DD`,
+  or null) and `codComuneSuccessore`, the municipality it merged into.
+- Names, provinces and regions follow the ISTAT list of current
+  municipalities: `Cardedu`, `OG`, `Sardegna` where the OMI registry had
+  `CARDEDU`, `NU`, `SARDEGNA`.
+
+## 0.4.0
+
+- New `cadastreParcels(query?)` on `GET /cadastre/parcels`: the stored
+  cadastral answers, newest first, filtered by `codComune`, `foglio`,
+  `particella` and `tipologia` (exact match), paginated with `page` and
+  `pageSize`. A read of the store: it never asks the cadastral map.
+- New types `CadastreParcelsQuery`, `CadastreParcelsPage` and `CadastreParcelRow`.
+
 ## 0.3.0
 
 - `geocode`, `geocodeBatch`, `reverseGeocode` and `cadastreParcel` take

package/README.md

@@ -50,6 +50,7 @@ retain their own concurrency and retry policy.
 | `geocodeBatch`                           | `GeocodeBatchRequest`                  |
 | `reverseGeocode`                         | `ReverseGeocodeRequest`                |
 | `cadastreParcel`                         | `CadastreParcelRequest`                |
+| `cadastreParcels`                        | optional `CadastreParcelsQuery`        |
 | `territory.status`, `territory.datasets` | options only                           |
 | `territory.comuni`                       | optional `TerritoryComuniQuery`        |
 | `territory.quotazioni`                   | optional `TerritoryQuotazioniQuery`    |

package/dist/index.d.ts

@@ -127,6 +127,22 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/cadastre/parcels': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations['CadastreController_listParcels'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/territory/status': {
         parameters: {
             query?: never;
@@ -439,6 +455,39 @@ interface components {
             /** @description True when the answer came from the cache, no map call. */
             cached: boolean;
         };
+        CadastreParcelRowDto: {
+            /** @description Canonical cache key: "lat,lng" rounded to 5 decimals. */
+            query: string;
+            lat: number;
+            lng: number;
+            /** @example PARTICELLA */
+            tipologia: string;
+            /** @example B885 */
+            codComune: string | null;
+            /** @description Municipality name; null when the code is not in the registry. */
+            comune: string | null;
+            /** @example AL */
+            provincia: string | null;
+            sezione: string | null;
+            /** @example 36 */
+            foglio: string | null;
+            /** @example G */
+            allegato: string | null;
+            sviluppo: string | null;
+            /** @example 5101 */
+            particella: string | null;
+            /**
+             * Format: date-time
+             * @description When the map last gave this answer.
+             */
+            updatedAt: string;
+        };
+        CadastreParcelsPageDto: {
+            page: number;
+            pageSize: number;
+            total: number;
+            items: components['schemas']['CadastreParcelRowDto'][];
+        };
         TerritoryStatusDto: {
             /** @description Latest OMI publication loaded (`YYYY-S`), null while no supply is loaded. */
             semestre: string | null;
@@ -463,6 +512,18 @@ interface components {
             denominazione: string;
             provincia: string;
             regione: string;
+            /**
+             * Format: date
+             * @description Birth of the municipality, when it falls after 1 January 1991.
+             */
+            costituitoIl: string | null;
+            /**
+             * Format: date
+             * @description Suppression date, null for a current municipality.
+             */
+            soppressoIl: string | null;
+            /** @description Belfiore code of the municipality it merged into. */
+            codComuneSuccessore: string | null;
             popolazione: number | null;
             redditoMedio: number | null;
         };
@@ -514,6 +575,18 @@ interface components {
             denominazione: string;
             provincia: string;
             regione: string;
+            /**
+             * Format: date
+             * @description Birth of the municipality, when it falls after 1 January 1991.
+             */
+            costituitoIl: string | null;
+            /**
+             * Format: date
+             * @description Suppression date, null for a current municipality.
+             */
+            soppressoIl: string | null;
+            /** @description Belfiore code of the municipality it merged into. */
+            codComuneSuccessore: string | null;
         };
         TerritoryIstatDto: {
             denominazione: string;
@@ -841,6 +914,42 @@ interface operations {
             };
         };
     };
+    CadastreController_listParcels: {
+        parameters: {
+            query?: {
+                page?: number;
+                pageSize?: number;
+                /** @description Cadastral municipality code. */
+                codComune?: string;
+                foglio?: string;
+                particella?: string;
+                /** @description What lies under the point. */
+                tipologia?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The stored map answers, newest first; never a map call. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['CadastreParcelsPageDto'];
+                };
+            };
+            /** @description Missing or invalid API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     TerritoryController_status: {
         parameters: {
             query?: never;
@@ -904,6 +1013,8 @@ interface operations {
                 provincia?: string;
                 regione?: string;
                 ordina?: 'denominazione' | 'popolazione';
+                /** @description Also the municipalities suppressed since 1991, with their dates. */
+                storici?: boolean;
             };
             header?: never;
             path?: never;
@@ -1080,6 +1191,8 @@ type ReverseGeocodeRequest = ApiSchemas['ReverseGeocodeRequestDto'];
 type ReverseGeocodeResult = ApiSchemas['ReverseGeocodeResultDto'];
 type CadastreParcelRequest = ApiSchemas['CadastreParcelRequestDto'];
 type CadastreParcelResult = ApiSchemas['CadastreParcelResultDto'];
+type CadastreParcelsPage = ApiSchemas['CadastreParcelsPageDto'];
+type CadastreParcelRow = ApiSchemas['CadastreParcelRowDto'];
 type TerritoryStatus = ApiSchemas['TerritoryStatusDto'];
 type TerritoryResolveRequest = ApiSchemas['TerritoryResolveRequestDto'];
 type TerritoryResolveResponse = ApiSchemas['TerritoryResolveResponseDto'];
@@ -1098,6 +1211,7 @@ type TerritoryCompravendita = ApiSchemas['TerritoryCompravenditaDto'];
 type TerritoryComuniQuery = NonNullable<ApiPaths['/territory/comuni']['get']['parameters']['query']>;
 type TerritoryQuotazioniQuery = NonNullable<ApiPaths['/territory/quotazioni']['get']['parameters']['query']>;
 type TerritoryCompravenditeQuery = NonNullable<ApiPaths['/territory/compravendite']['get']['parameters']['query']>;
+type CadastreParcelsQuery = NonNullable<ApiPaths['/cadastre/parcels']['get']['parameters']['query']>;
 interface RequestOptions {
     signal?: AbortSignal;
 }
@@ -1142,10 +1256,12 @@ interface GeoClient {
     reverseGeocode(input: ReverseGeocodeRequest, options?: LookupOptions): Promise<ReverseGeocodeResult>;
     /** What the AdE cadastral map finds under a point; 503 `CADASTRE_BLOCKED` carries Retry-After. */
     cadastreParcel(input: CadastreParcelRequest, options?: LookupOptions): Promise<CadastreParcelResult>;
+    /** The stored cadastral answers, newest first: a read of the store, never a map call. */
+    cadastreParcels(query?: CadastreParcelsQuery, options?: RequestOptions): Promise<CadastreParcelsPage>;
     territory: TerritoryClient;
 }
 
 declare function createGeoClient(options: GeoClientOptions): GeoClient;
 
 export { ApiError, createGeoClient };
-export type { CadastreParcelRequest, CadastreParcelResult, GeoClient, GeoClientOptions, GeocodeBatchRequest, GeocodeBatchResponse, GeocodeRequest, GeocodeResult, LookupCache, LookupOptions, RequestOptions, ReverseGeocodeRequest, ReverseGeocodeResult, TerritoryClient, TerritoryCompravendita, TerritoryCompravenditePage, TerritoryCompravenditeQuery, TerritoryComune, TerritoryComuneDetail, TerritoryComuneRiga, TerritoryComuniPage, TerritoryComuniQuery, TerritoryDatasets, TerritoryOmi, TerritoryPointResult, TerritoryQuotazione, TerritoryQuotazioniPage, TerritoryQuotazioniQuery, TerritoryResolveRequest, TerritoryResolveResponse, TerritoryStatus };
+export type { CadastreParcelRequest, CadastreParcelResult, CadastreParcelRow, CadastreParcelsPage, CadastreParcelsQuery, GeoClient, GeoClientOptions, GeocodeBatchRequest, GeocodeBatchResponse, GeocodeRequest, GeocodeResult, LookupCache, LookupOptions, RequestOptions, ReverseGeocodeRequest, ReverseGeocodeResult, TerritoryClient, TerritoryCompravendita, TerritoryCompravenditePage, TerritoryCompravenditeQuery, TerritoryComune, TerritoryComuneDetail, TerritoryComuneRiga, TerritoryComuniPage, TerritoryComuniQuery, TerritoryDatasets, TerritoryOmi, TerritoryPointResult, TerritoryQuotazione, TerritoryQuotazioniPage, TerritoryQuotazioniQuery, TerritoryResolveRequest, TerritoryResolveResponse, TerritoryStatus };

package/dist/index.js

@@ -86,6 +86,7 @@ function createGeoClient(options) {
     geocodeBatch: (input, request) => data(client.POST("/geocode/batch", { ...lookupInit(request), body: input })),
     reverseGeocode: (input, request) => data(client.POST("/geocode/reverse", { ...lookupInit(request), body: input })),
     cadastreParcel: (input, request) => data(client.POST("/cadastre/parcel", { ...lookupInit(request), body: input })),
+    cadastreParcels: (query, options2) => data(client.GET("/cadastre/parcels", { ...options2, params: { query } })),
     territory: territory(client)
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@seta-labs/geo",
-    "version": "0.3.0",
+    "version": "0.5.0",
     "description": "Typed Fetch client for the Seta Geo HTTP API",
     "license": "UNLICENSED",
     "type": "module",