@cenogram/mcp-server 0.5.0 → 0.11.0

package/dist/api-client.js

@@ -26,7 +26,8 @@ function extractCreditInfo(res) {
     const cost = parseInt(res.headers.get("X-Credits-Cost") ?? "", 10);
     if (isNaN(balance) || isNaN(cost))
         return null;
-    return { balance, cost };
+    const refunded = parseInt(res.headers.get("X-Credits-Refunded") ?? "", 10);
+    return isNaN(refunded) ? { balance, cost } : { balance, cost, refunded };
 }
 export const OAUTH_CTX_PREFIX = "\x01";
 export function encodeOAuthCtx(userId, grantId) {
@@ -94,15 +95,56 @@ export function formatRetryAfter(seconds) {
         return unit(Math.ceil(seconds / 3600), "hour");
     return unit(Math.ceil(seconds / 86400), "day");
 }
+export class ApiHttpError extends Error {
+    status;
+    code;
+    authMode;
+    retryAfterSeconds;
+    constructor(message, opts) {
+        super(message);
+        this.name = "ApiHttpError";
+        this.status = opts.status;
+        this.code = opts.code;
+        this.authMode = opts.authMode;
+        this.retryAfterSeconds = opts.retryAfterSeconds;
+    }
+}
+export function isExpectedApiError(error) {
+    if (!(error instanceof ApiHttpError))
+        return false;
+    const { status, authMode, code } = error;
+    if (status >= 500)
+        return false;
+    switch (status) {
+        case 400:
+        case 402:
+        case 404:
+        case 409:
+        case 410:
+        case 422:
+        case 429:
+            return true;
+        case 401:
+            return authMode !== "oauth";
+        case 403:
+            return code === "email_not_verified";
+        default:
+            return false;
+    }
+}
 async function handleErrorResponse(res, apiKey) {
+    const mode = getAuthMode(apiKey ?? process.env.CENOGRAM_API_KEY);
     if (res.status === 429) {
         const seconds = parseRetryAfterSeconds(res.headers?.get?.("Retry-After"));
         const wait = seconds !== null ? ` Retry in ${formatRetryAfter(seconds)}.` : " Retry shortly.";
-        throw new Error(`Too many requests - this is a rate limit, not an exhausted allowance.${wait}`);
+        throw new ApiHttpError(`Too many requests - this is a rate limit, not an exhausted allowance.${wait}`, { status: 429, authMode: mode, retryAfterSeconds: seconds ?? undefined });
     }
     const body = (await res.json().catch(() => ({})));
-    const mode = getAuthMode(apiKey ?? process.env.CENOGRAM_API_KEY);
-    throw new Error(authErrorMessage(res.status, mode, body));
+    throw new ApiHttpError(authErrorMessage(res.status, mode, body), {
+        status: res.status,
+        code: typeof body.error === "string" ? body.error : undefined,
+        authMode: mode,
+    });
 }
 function toQueryParams(obj) {
     const params = {};
@@ -175,6 +217,10 @@ export function getTransactions(p, apiKey) {
         floodRisk: p.floodRisk,
         heritageStatus: p.heritageStatus,
         landslideRisk: p.landslideRisk,
+        landUse: p.landUse,
+        buildingStoreys: p.buildingStoreys,
+        minFootprintArea: p.minFootprintArea,
+        maxFootprintArea: p.maxFootprintArea,
         minPrice: p.minPrice,
         maxPrice: p.maxPrice,
         dateFrom: p.dateFrom,
@@ -207,6 +253,10 @@ export function getTransactionsSummary(p, apiKey) {
         floodRisk: p.floodRisk,
         heritageStatus: p.heritageStatus,
         landslideRisk: p.landslideRisk,
+        landUse: p.landUse,
+        buildingStoreys: p.buildingStoreys,
+        minFootprintArea: p.minFootprintArea,
+        maxFootprintArea: p.maxFootprintArea,
         minPrice: p.minPrice,
         maxPrice: p.maxPrice,
         dateFrom: p.dateFrom,
@@ -247,6 +297,17 @@ export function getPriceSpreadLocations(params, apiKey) {
         search: params.search,
     }), apiKey);
 }
+export function getFloodRisk(params, apiKey) {
+    return fetchApi("/api/v1/flood-risk", toQueryParams({
+        location: params.location,
+        teryt: params.teryt,
+    }), apiKey);
+}
+export function getFloodRiskLocations(params, apiKey) {
+    return fetchApi("/api/v1/flood-risk/locations", toQueryParams({
+        search: params.search,
+    }), apiKey);
+}
 export function getValuation(params, apiKey) {
     return fetchApi("/api/v1/valuations", toQueryParams({
         lat: params.lat,
@@ -261,12 +322,43 @@ export function getValuation(params, apiKey) {
 export function getLocations(parent, apiKey) {
     return fetchApi("/api/v1/locations", parent ? { parent } : undefined, apiKey);
 }
+export function searchLocations(q, apiKey) {
+    return fetchApi("/api/v1/locations", { search: q }, apiKey);
+}
 export function getPriceHistogram(bins = 20, max = 3_000_000, apiKey) {
     return fetchApi("/api/v1/stats/price-histogram", toQueryParams({ bins, max }), apiKey);
 }
 export function searchParcels(q, limit, apiKey) {
     return fetchApi("/api/v1/parcels/search", toQueryParams({ q, limit }), apiKey);
 }
+export function listParcels(p, apiKey) {
+    return fetchApi("/api/v1/parcels", toQueryParams({
+        location: p.location,
+        teryt: p.teryt,
+        bbox: p.bbox,
+        lat: p.lat,
+        lng: p.lng,
+        radiusKm: p.radiusKm,
+        minArea: p.minArea,
+        maxArea: p.maxArea,
+        street: p.street,
+        buildingNumber: p.buildingNumber,
+        limit: p.limit,
+        cursor: p.cursor,
+    }), apiKey);
+}
+export function getStreets(scope, apiKey) {
+    return fetchApi("/api/v1/streets", toQueryParams({ ...scope }), apiKey);
+}
+export function getParcelsMap(bbox, limit, apiKey) {
+    return fetchApi("/api/v1/parcels/map", toQueryParams({ bbox, limit }), apiKey);
+}
+export function searchParcelsByPolygon(polygon, limit, apiKey) {
+    const body = { polygon };
+    if (limit != null)
+        body.limit = limit;
+    return fetchApiPost("/api/v1/parcels/spatial", body, apiKey);
+}
 export function resolveParcel(params, apiKey) {
     return fetchApi("/api/v1/parcels/resolve", toQueryParams({
         q: params.q,
@@ -279,6 +371,10 @@ export function getParcelReport(parcelKey, apiKey) {
     const urlKey = parcelKey.trim().replace(/\//g, "-");
     return fetchApi(`/api/v1/parcels/${encodeURIComponent(urlKey)}/report`, undefined, apiKey);
 }
+export function getParcelLandClass(parcelKey, apiKey) {
+    const urlKey = parcelKey.trim().replace(/\//g, "-");
+    return fetchApi(`/api/v1/parcels/${encodeURIComponent(urlKey)}/land-class`, undefined, apiKey);
+}
 export function searchByPolygon(p, apiKey) {
     const body = { polygon: p.polygon };
     if (p.propertyType != null)
@@ -315,6 +411,14 @@ export function searchByPolygon(p, apiKey) {
         body.rooms = p.rooms;
     if (p.floor)
         body.floor = p.floor;
+    if (p.landUse)
+        body.landUse = p.landUse;
+    if (p.buildingStoreys)
+        body.buildingStoreys = p.buildingStoreys;
+    if (p.minFootprintArea != null)
+        body.minFootprintArea = p.minFootprintArea;
+    if (p.maxFootprintArea != null)
+        body.maxFootprintArea = p.maxFootprintArea;
     if (p.limit != null)
         body.limit = p.limit;
     return fetchApiPost("/api/v1/transactions/spatial", body, apiKey);
@@ -353,9 +457,18 @@ export function getTransactionHeritage(transactionId, apiKey) {
 export function getTransactionLandslide(transactionId, apiKey) {
     return fetchApi(`/api/v1/transactions/${transactionId}/landslide`, undefined, apiKey);
 }
+export function getTransactionNature(transactionId, apiKey) {
+    return fetchApi(`/api/v1/transactions/${transactionId}/nature`, undefined, apiKey);
+}
+export function getTransactionSubsurface(transactionId, apiKey) {
+    return fetchApi(`/api/v1/transactions/${transactionId}/subsurface`, undefined, apiKey);
+}
 export function getTransactionSurroundings(transactionId, apiKey) {
     return fetchApi(`/api/v1/transactions/${transactionId}/surroundings`, undefined, apiKey);
 }
+export function getTransactionRoads(transactionId, apiKey) {
+    return fetchApi(`/api/v1/transactions/${transactionId}/roads`, undefined, apiKey);
+}
 export function getTransactionTransit(transactionId, apiKey) {
     return fetchApi(`/api/v1/transactions/${transactionId}/transit`, undefined, apiKey);
 }

package/dist/error-messages.js

@@ -41,7 +41,7 @@ export function authErrorMessage(status, mode, body = {}) {
             return "API key rejected. Check https://cenogram.pl/ustawienia#api-keys if it's still active.";
         case 402: {
             const explanation = specificField(body.message);
-            if (body.error === "trial_expired" && explanation) {
+            if (explanation) {
                 const upgrade = specificField(body.upgrade);
                 return upgrade && !explanation.includes(upgrade) ? `${sentence(explanation)} (${upgrade})` : explanation;
             }

package/dist/formatters.d.ts

@@ -1,4 +1,4 @@
-import type { Transaction, TransactionsResponse, TransactionsSummary, StatsResponse, PricePerM2Row, HistogramBin, ParcelSearchResponse, ParcelResolveResponse, SpatialSearchResponse, CompareResponse, LocationItem, RentalYieldResponse, RentalYieldLocationsResponse, PriceSpreadResponse, PriceSpreadLocationsResponse, ValuationResponse, BuildingBreakdownResponse, FloodBreakdownResponse, HeritageBreakdownResponse, LandslideBreakdownResponse, SurroundingsResponse, TransitBreakdownResponse, PermitsResponse, PlanningResponse, FarmlandResponse, DemographicsResponse, InfrastructureSignalsResponse, ParcelReportResponse } from "./api-client.js";
+import type { Transaction, TransactionsResponse, TransactionsSummary, StatsResponse, PricePerM2Row, HistogramBin, ParcelSearchResponse, ParcelResolveResponse, ParcelListResponse, StreetListResponse, ParcelFeatureCollection, CorpusCoverage, SpatialSearchResponse, CompareResponse, LocationItem, LocationSearchItem, RentalYieldResponse, RentalYieldLocationsResponse, PriceSpreadResponse, PriceSpreadLocationsResponse, FloodRiskResponse, FloodRiskLocationsResponse, ValuationResponse, BuildingBreakdownResponse, BuildingAgeEstimate, FloodBreakdownResponse, HeritageBreakdownResponse, LandslideBreakdownResponse, NatureBreakdownResponse, SubsurfaceBreakdownResponse, SurroundingsResponse, RoadsBreakdownResponse, TransitBreakdownResponse, PermitsResponse, PlanningResponse, FarmlandResponse, DemographicsResponse, InfrastructureSignalsResponse, ParcelReportResponse, ParcelLandClassResponse } from "./api-client.js";
 export declare const MARKET_CAVEAT = "Note: median/average prices are market-based \u2014 fractional ownership shares and non-market deeds (public tenders, foreclosures, privileged/subsidized sales) are excluded from price aggregates. Transaction counts and coverage stay complete.";
 export declare function formatPLN(value: number | null | undefined): string;
 export declare function formatArea(m2: number | null | undefined): string;
@@ -9,18 +9,27 @@ export declare function formatMarketOverview(stats: StatsResponse): string;
 export declare function formatPriceStats(rows: PricePerM2Row[], location?: string): string;
 export declare function formatHistogram(bins: HistogramBin[]): string;
 export declare function formatParcelResults(res: ParcelSearchResponse, query: string): string;
+export declare function formatCorpusCoverage(cov: CorpusCoverage | null | undefined): string;
+export declare function formatParcelList(res: ParcelListResponse, scope: string, creditsRefunded?: boolean): string;
+export declare function formatStreetList(res: StreetListResponse, q: string, scope: string): string;
+export declare function formatParcelFeatures(res: ParcelFeatureCollection, scope: string): string;
 export declare function formatParcelResolve(res: ParcelResolveResponse): string;
 export declare function formatSpatialResults(res: SpatialSearchResponse): string;
+export declare function formatBuildingAge(age: BuildingAgeEstimate | undefined): string;
 export declare function formatBuildingBreakdown(res: BuildingBreakdownResponse): string;
 export declare function formatFloodBreakdown(res: FloodBreakdownResponse): string;
 export declare function formatHeritageBreakdown(res: HeritageBreakdownResponse): string;
 export declare function formatLandslideBreakdown(res: LandslideBreakdownResponse): string;
+export declare function formatNatureBreakdown(res: NatureBreakdownResponse): string;
+export declare function formatSubsurfaceBreakdown(res: SubsurfaceBreakdownResponse): string;
 export declare function formatSurroundings(res: SurroundingsResponse): string;
+export declare function formatRoads(res: RoadsBreakdownResponse): string;
 export declare function formatTransitBreakdown(res: TransitBreakdownResponse): string;
 export declare function formatPermitsBreakdown(res: PermitsResponse): string;
 export declare function formatPlanningBreakdown(res: PlanningResponse): string;
 export declare function formatFarmland(res: FarmlandResponse): string;
 export declare function formatLocationHierarchy(items: LocationItem[], parent?: string): string;
+export declare function formatLocationSearch(items: LocationSearchItem[], rcnOnly: string[], query: string): string;
 export declare function formatCompareResults(res: CompareResponse): string;
 export declare function formatDemographics(r: DemographicsResponse): string;
 export declare function formatInfrastructureSignals(r: InfrastructureSignalsResponse): string;
@@ -28,5 +37,9 @@ export declare function formatRentalYield(r: RentalYieldResponse): string;
 export declare function formatRentalYieldLocations(r: RentalYieldLocationsResponse): string;
 export declare function formatPriceSpread(r: PriceSpreadResponse): string;
 export declare function formatPriceSpreadLocations(r: PriceSpreadLocationsResponse): string;
+export declare function formatFloodRisk(r: FloodRiskResponse): string;
+export declare function formatFloodRiskLocations(r: FloodRiskLocationsResponse): string;
 export declare function formatValuation(r: ValuationResponse): string;
+export declare const REPORT_LAYER_ORDER: Array<[string, string]>;
 export declare function formatParcelReport(res: ParcelReportResponse): string;
+export declare function formatParcelLandClass(res: ParcelLandClassResponse): string;