@seta-labs/geo 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @seta-labs/geo
 
+## 0.10.0
+
+- `territory.perimetri({ lat, lng })`: the OMI zone and the municipality a point
+  falls into, each with its perimeter as a GeoJSON MultiPolygon (WGS84,
+  simplified to a couple of metres) ready to draw on a map. `zona` and `comune`
+  are null when the point is outside every perimeter. Requires Geo service
+  `0.14.0`.
+
+## 0.9.0
+
+- `territory.raggi(input)`: for each point and municipality (`codComune`), the
+  radius that covers the whole municipality from the point: the distance to
+  the farthest vertex of its ISTAT boundary, in metres rounded up, from the
+  latest edition that has it (a suppressed municipality keeps its last).
+  `edizione` and `raggioM` are null when no edition has the municipality. Up
+  to 100 points per call; `id` is echoed back.
+
 ## 0.8.0
 
 - **Breaking:** `LookupCache` becomes `CachePolicy`, the cache options every

package/dist/index.d.ts

@@ -209,6 +209,22 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/territory/perimetri': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations['TerritoryController_perimetri'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/territory/resolve': {
         parameters: {
             query?: never;
@@ -225,6 +241,22 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/territory/raggi': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations['TerritoryController_raggi'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/cadastre/parcel': {
         parameters: {
             query?: never;
@@ -645,6 +677,21 @@ interface components {
             zone: components['schemas']['TerritoryZonaQuotazioneDto'][];
             compravendite: components['schemas']['TerritoryCompravenditaAnnoDto'][];
         };
+        TerritoryPerimetroDto: {
+            codComune: string;
+            /** @description Null for a municipality. */
+            codZona: string | null;
+            /** @description Zone or municipality name. */
+            nome: string | null;
+            /** @description GeoJSON MultiPolygon in WGS84, simplified to a couple of metres. */
+            geometry: {
+                [key: string]: unknown;
+            };
+        };
+        TerritoryPerimetriDto: {
+            zona: components['schemas']['TerritoryPerimetroDto'] | null;
+            comune: components['schemas']['TerritoryPerimetroDto'] | null;
+        };
         TerritoryPointDto: {
             id: string;
             lat: number;
@@ -674,6 +721,30 @@ interface components {
         TerritoryResolveResponseDto: {
             items: components['schemas']['TerritoryPointResultDto'][];
         };
+        TerritoryRaggioPointDto: {
+            id: string;
+            /** @description Belfiore code of the municipality (e.g. `D969`). */
+            codComune: string;
+            lat: number;
+            lng: number;
+        };
+        TerritoryRaggiRequestDto: {
+            points: components['schemas']['TerritoryRaggioPointDto'][];
+        };
+        TerritoryRaggioDto: {
+            id: string;
+            codComune: string;
+            /**
+             * Format: date
+             * @description Boundary edition.
+             */
+            edizione: string | null;
+            /** @description Metres, rounded up. */
+            raggioM: number | null;
+        };
+        TerritoryRaggiResponseDto: {
+            items: components['schemas']['TerritoryRaggioDto'][];
+        };
         CadastreParcelRequestDto: {
             lat: number;
             lng: number;
@@ -1143,6 +1214,35 @@ interface operations {
             };
         };
     };
+    TerritoryController_perimetri: {
+        parameters: {
+            query: {
+                lat: number;
+                lng: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['TerritoryPerimetriDto'];
+                };
+            };
+            /** @description Missing or invalid API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     TerritoryController_resolve: {
         parameters: {
             query?: never;
@@ -1173,6 +1273,36 @@ interface operations {
             };
         };
     };
+    TerritoryController_raggi: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['TerritoryRaggiRequestDto'];
+            };
+        };
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['TerritoryRaggiResponseDto'];
+                };
+            };
+            /** @description Missing or invalid API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     CadastreController_parcel: {
         parameters: {
             query?: never;
@@ -1284,6 +1414,11 @@ type TerritoryStatus = ApiSchemas['TerritoryStatusDto'];
 type TerritoryResolveRequest = ApiSchemas['TerritoryResolveRequestDto'];
 type TerritoryResolveResponse = ApiSchemas['TerritoryResolveResponseDto'];
 type TerritoryPointResult = ApiSchemas['TerritoryPointResultDto'];
+type TerritoryRaggiRequest = ApiSchemas['TerritoryRaggiRequestDto'];
+type TerritoryRaggiResponse = ApiSchemas['TerritoryRaggiResponseDto'];
+type TerritoryRaggio = ApiSchemas['TerritoryRaggioDto'];
+type TerritoryPerimetri = ApiSchemas['TerritoryPerimetriDto'];
+type TerritoryPerimetro = ApiSchemas['TerritoryPerimetroDto'];
 type TerritoryOmi = ApiSchemas['TerritoryOmiDto'];
 type TerritoryComune = ApiSchemas['TerritoryComuneDto'];
 type TerritoryComuneDetail = ApiSchemas['TerritoryComuneDetailDto'];
@@ -1321,6 +1456,7 @@ interface PacingOptions {
     retries?: number;
 }
 
+type TerritoryPerimetriQuery = ApiPaths['/territory/perimetri']['get']['parameters']['query'];
 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']>;
@@ -1355,7 +1491,10 @@ interface TerritoryClient {
     quotazioni(query?: TerritoryQuotazioniQuery, options?: RequestOptions): Promise<TerritoryQuotazioniPage>;
     compravendite(query?: TerritoryCompravenditeQuery, options?: RequestOptions): Promise<TerritoryCompravenditePage>;
     comune(codComune: string, options?: RequestOptions): Promise<TerritoryComuneDetail>;
+    /** The OMI zone and the municipality a point falls into, each with its GeoJSON perimeter. */
+    perimetri(query: TerritoryPerimetriQuery, options?: RequestOptions): Promise<TerritoryPerimetri>;
     resolve(input: TerritoryResolveRequest, options?: RequestOptions): Promise<TerritoryResolveResponse>;
+    raggi(input: TerritoryRaggiRequest, options?: RequestOptions): Promise<TerritoryRaggiResponse>;
 }
 interface GeoClient {
     geocode(input: GeocodeRequest, options?: LookupOptions): Promise<GeocodeResult>;
@@ -1372,4 +1511,4 @@ interface GeoClient {
 declare function createGeoClient(options: GeoClientOptions): GeoClient;
 
 export { ApiError, createGeoClient };
-export type { CachePolicy, CadastreParcelRequest, CadastreParcelResult, CadastreParcelRow, CadastreParcelsPage, CadastreParcelsQuery, GeoAdminArea, GeoClient, GeoClientOptions, GeoStreetMatch, GeocodeBatchRequest, GeocodeBatchResponse, GeocodeRequest, GeocodeResult, LookupOptions, PacingOptions, RequestOptions, ReverseGeocodeRequest, ReverseGeocodeResult, TerritoryClient, TerritoryCompravendita, TerritoryCompravenditePage, TerritoryCompravenditeQuery, TerritoryComune, TerritoryComuneDetail, TerritoryComuneRiga, TerritoryComuniPage, TerritoryComuniQuery, TerritoryDatasets, TerritoryOmi, TerritoryPointResult, TerritoryQuotazione, TerritoryQuotazioniPage, TerritoryQuotazioniQuery, TerritoryResolveRequest, TerritoryResolveResponse, TerritoryStatus, TerritoryTerritorio };
+export type { CachePolicy, CadastreParcelRequest, CadastreParcelResult, CadastreParcelRow, CadastreParcelsPage, CadastreParcelsQuery, GeoAdminArea, GeoClient, GeoClientOptions, GeoStreetMatch, GeocodeBatchRequest, GeocodeBatchResponse, GeocodeRequest, GeocodeResult, LookupOptions, PacingOptions, RequestOptions, ReverseGeocodeRequest, ReverseGeocodeResult, TerritoryClient, TerritoryCompravendita, TerritoryCompravenditePage, TerritoryCompravenditeQuery, TerritoryComune, TerritoryComuneDetail, TerritoryComuneRiga, TerritoryComuniPage, TerritoryComuniQuery, TerritoryDatasets, TerritoryOmi, TerritoryPerimetri, TerritoryPerimetriQuery, TerritoryPerimetro, TerritoryPointResult, TerritoryQuotazione, TerritoryQuotazioniPage, TerritoryQuotazioniQuery, TerritoryRaggiRequest, TerritoryRaggiResponse, TerritoryRaggio, TerritoryResolveRequest, TerritoryResolveResponse, TerritoryStatus, TerritoryTerritorio };

package/dist/index.js

@@ -30,7 +30,7 @@ function codeOf(body) {
   return typeof body.code === "string" ? body.code : void 0;
 }
 
-// ../../node_modules/.pnpm/@seta-labs+nestjs-cache-control@0.2.1_@nestjs+common@12.1.2_class-transformer@0.5.1_cla_d70e55208c987ac6b22f0eff0ce5869e/node_modules/@seta-labs/nestjs-cache-control/dist/cache-policy.util.js
+// ../../node_modules/.pnpm/@seta-labs+nestjs-cache-control@0.2.1_@nestjs+common@12.4.0_class-transformer@0.5.1_cla_a761c97cc6bb49499ea6356a28f157db/node_modules/@seta-labs/nestjs-cache-control/dist/cache-policy.util.js
 var MAX_DELTA_SECONDS = 2147483648;
 function formatCacheControl(policy) {
   if (!policy)
@@ -177,7 +177,9 @@ function territory(client) {
         params: { path: { codComune } }
       })
     ),
-    resolve: (input, options) => data(client.POST("/territory/resolve", { ...options, body: input }))
+    perimetri: (query, options) => data(client.GET("/territory/perimetri", { ...options, params: { query } })),
+    resolve: (input, options) => data(client.POST("/territory/resolve", { ...options, body: input })),
+    raggi: (input, options) => data(client.POST("/territory/raggi", { ...options, body: input }))
   };
 }
 function createGeoClient(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@seta-labs/geo",
-    "version": "0.8.0",
+    "version": "0.10.0",
     "description": "Typed Fetch client for the Seta Geo HTTP API",
     "license": "UNLICENSED",
     "type": "module",
@@ -43,10 +43,10 @@
     },
     "devDependencies": {
         "@seta-geo/types": "workspace:*",
-        "@seta-labs/config": "^0.16.1",
+        "@seta-labs/config": "^0.18.0",
         "@seta-labs/nestjs-cache-control": "0.2.1",
         "tsup": "^9.0.0",
         "typescript": "^6.0.3",
-        "vitest": "^5.0.3"
+        "vitest": "^5.1.0"
     }
 }