@ignfab/geocontext 0.9.2 → 0.9.5

package/dist/tools/GpfWfsDescribeTypeTool.d.ts

@@ -3,7 +3,7 @@ import { z } from "zod";
 import type { Collection } from "@ignfab/gpf-schema-store";
 declare const gpfWfsDescribeTypeInputSchema: z.ZodObject<{
     typename: z.ZodString;
-}, "strip", z.ZodTypeAny, {
+}, "strict", z.ZodTypeAny, {
     typename?: string;
 }, {
     typename?: string;
@@ -13,10 +13,10 @@ declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
     name: string;
     title: string;
     annotations: {
-        readonly readOnlyHint: true;
-        readonly destructiveHint: false;
-        readonly idempotentHint: true;
-        readonly openWorldHint: true;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
     };
     description: string;
     protected outputSchemaShape: z.ZodObject<{
@@ -50,10 +50,6 @@ declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
             id?: string;
-            namespace?: string;
-            name?: string;
-            title?: string;
-            description?: string;
             properties?: {
                 type?: string;
                 name?: string;
@@ -62,12 +58,12 @@ declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
                 enum?: string[];
                 defaultCrs?: string;
             }[];
-        }, {
-            id?: string;
             namespace?: string;
             name?: string;
             title?: string;
             description?: string;
+        }, {
+            id?: string;
             properties?: {
                 type?: string;
                 name?: string;
@@ -76,14 +72,14 @@ declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
                 enum?: string[];
                 defaultCrs?: string;
             }[];
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        result?: {
-            id?: string;
             namespace?: string;
             name?: string;
             title?: string;
             description?: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        result?: {
+            id?: string;
             properties?: {
                 type?: string;
                 name?: string;
@@ -92,14 +88,14 @@ declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
                 enum?: string[];
                 defaultCrs?: string;
             }[];
-        };
-    }, {
-        result?: {
-            id?: string;
             namespace?: string;
             name?: string;
             title?: string;
             description?: string;
+        };
+    }, {
+        result?: {
+            id?: string;
             properties?: {
                 type?: string;
                 name?: string;
@@ -108,11 +104,15 @@ declare class GpfWfsDescribeTypeTool extends MCPTool<GpfWfsDescribeTypeInput> {
                 enum?: string[];
                 defaultCrs?: string;
             }[];
+            namespace?: string;
+            name?: string;
+            title?: string;
+            description?: string;
         };
     }>;
     schema: z.ZodObject<{
         typename: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
+    }, "strict", z.ZodTypeAny, {
         typename?: string;
     }, {
         typename?: string;

package/dist/tools/GpfWfsDescribeTypeTool.js

@@ -1,14 +1,14 @@
 import { MCPTool } from "mcp-framework";
 import { z } from "zod";
 import { wfsClient } from "../gpf/wfs.js";
-import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "./toolAnnotations.js";
+import { READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS } from "../helpers/toolAnnotations.js";
 const gpfWfsDescribeTypeInputSchema = z.object({
     typename: z
         .string()
         .trim()
         .min(1, "le nom du type ne doit pas être vide")
         .describe("Le nom du type (ex : BDTOPO_V3:batiment)"),
-});
+}).strict();
 const gpfWfsPropertySchema = z.object({
     name: z.string().describe("Le nom de la propriété."),
     type: z.string().describe("Le type de la propriété."),
@@ -34,8 +34,9 @@ class GpfWfsDescribeTypeTool extends MCPTool {
     description = [
         "Renvoie le schéma détaillé d'un type WFS à partir de son identifiant (`typename`) : identifiants, description et liste des propriétés.",
         "Utiliser ce tool après `gpf_wfs_search_types` pour inspecter les propriétés disponibles avant d'appeler `gpf_wfs_get_features`.",
-        "La sortie inclut notamment le type des propriétés, leur description, et leurs valeurs possibles (`enum`) lorsqu'elles existent.",
-    ].join("\r\n");
+        "La sortie inclut notamment le type des propriétés, leur description, leurs valeurs possibles (`enum`) lorsqu'elles existent",
+        "**Appel fortement recommandé si les noms exacts des propriétés ne sont pas connus : un nom de propriété incorrect provoque une erreur**."
+    ].join("\n");
     outputSchemaShape = gpfWfsDescribeTypeOutputSchema;
     schema = gpfWfsDescribeTypeInputSchema;
     async execute(input) {

package/dist/tools/GpfWfsDescribeTypeTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"GpfWfsDescribeTypeTool.js","sourceRoot":"","sources":["../../src/tools/GpfWfsDescribeTypeTool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GpfWfsDescribeTypeTool.js","sourceRoot":"","sources":["../../src/tools/GpfWfsDescribeTypeTool.ts"],"names":[],"mappings":"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"}

package/dist/tools/GpfWfsGetFeaturesTool.d.ts

@@ -1,60 +1,132 @@
 import { MCPTool } from "mcp-framework";
-import { z } from "zod";
-declare const gpfWfsGetFeaturesInputSchema: z.ZodObject<{
-    typename: z.ZodString;
-    property_names: z.ZodOptional<z.ZodString>;
-    sort_by: z.ZodOptional<z.ZodString>;
-    count: z.ZodOptional<z.ZodNumber>;
-    cql_filter: z.ZodOptional<z.ZodString>;
-    result_type: z.ZodOptional<z.ZodEnum<["results", "hits", "url"]>>;
-}, "strip", z.ZodTypeAny, {
-    cql_filter?: string;
-    typename?: string;
-    property_names?: string;
-    sort_by?: string;
-    count?: number;
-    result_type?: "results" | "hits" | "url";
-}, {
-    cql_filter?: string;
-    typename?: string;
-    property_names?: string;
-    sort_by?: string;
-    count?: number;
-    result_type?: "results" | "hits" | "url";
-}>;
-type GpfWfsGetFeaturesInput = z.infer<typeof gpfWfsGetFeaturesInputSchema>;
+import type { Collection } from "@ignfab/gpf-schema-store";
+import { type CompiledRequest } from "../helpers/wfs_internal/request.js";
+import { type GpfWfsGetFeaturesInput } from "../helpers/wfs_internal/schema.js";
 declare class GpfWfsGetFeaturesTool extends MCPTool<GpfWfsGetFeaturesInput> {
     name: string;
     title: string;
     annotations: {
-        readonly readOnlyHint: true;
-        readonly destructiveHint: false;
-        readonly idempotentHint: true;
-        readonly openWorldHint: true;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
     };
     description: string;
-    schema: z.ZodObject<{
-        typename: z.ZodString;
-        property_names: z.ZodOptional<z.ZodString>;
-        sort_by: z.ZodOptional<z.ZodString>;
-        count: z.ZodOptional<z.ZodNumber>;
-        cql_filter: z.ZodOptional<z.ZodString>;
-        result_type: z.ZodOptional<z.ZodEnum<["results", "hits", "url"]>>;
-    }, "strip", z.ZodTypeAny, {
-        cql_filter?: string;
+    schema: import("zod").ZodObject<{
+        typename: import("zod").ZodString;
+        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+        result_type: import("zod").ZodDefault<import("zod").ZodEnum<["results", "hits", "request"]>>;
+        select: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        order_by: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            property: import("zod").ZodString;
+            direction: import("zod").ZodDefault<import("zod").ZodEnum<["asc", "desc"]>>;
+        }, "strict", import("zod").ZodTypeAny, {
+            property?: string;
+            direction?: "asc" | "desc";
+        }, {
+            property?: string;
+            direction?: "asc" | "desc";
+        }>, "many">>;
+        where: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            property: import("zod").ZodString;
+            operator: import("zod").ZodEnum<["eq", "ne", "lt", "lte", "gt", "gte", "in", "is_null"]>;
+            value: import("zod").ZodOptional<import("zod").ZodString>;
+            values: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, "strict", import("zod").ZodTypeAny, {
+            values?: string[];
+            value?: string;
+            property?: string;
+            operator?: "gte" | "gt" | "lte" | "lt" | "eq" | "ne" | "in" | "is_null";
+        }, {
+            values?: string[];
+            value?: string;
+            property?: string;
+            operator?: "gte" | "gt" | "lte" | "lt" | "eq" | "ne" | "in" | "is_null";
+        }>, "many">>;
+        spatial_operator: import("zod").ZodOptional<import("zod").ZodEnum<["bbox", "intersects_point", "dwithin_point", "intersects_feature"]>>;
+        bbox_west: import("zod").ZodOptional<import("zod").ZodNumber>;
+        bbox_south: import("zod").ZodOptional<import("zod").ZodNumber>;
+        bbox_east: import("zod").ZodOptional<import("zod").ZodNumber>;
+        bbox_north: import("zod").ZodOptional<import("zod").ZodNumber>;
+        intersects_lon: import("zod").ZodOptional<import("zod").ZodNumber>;
+        intersects_lat: import("zod").ZodOptional<import("zod").ZodNumber>;
+        dwithin_lon: import("zod").ZodOptional<import("zod").ZodNumber>;
+        dwithin_lat: import("zod").ZodOptional<import("zod").ZodNumber>;
+        dwithin_distance_m: import("zod").ZodOptional<import("zod").ZodNumber>;
+        intersects_feature_typename: import("zod").ZodOptional<import("zod").ZodString>;
+        intersects_feature_id: import("zod").ZodOptional<import("zod").ZodString>;
+    }, "strict", import("zod").ZodTypeAny, {
         typename?: string;
-        property_names?: string;
-        sort_by?: string;
-        count?: number;
-        result_type?: "results" | "hits" | "url";
+        limit?: number;
+        result_type?: "request" | "results" | "hits";
+        select?: string[];
+        order_by?: {
+            property?: string;
+            direction?: "asc" | "desc";
+        }[];
+        where?: {
+            values?: string[];
+            value?: string;
+            property?: string;
+            operator?: "gte" | "gt" | "lte" | "lt" | "eq" | "ne" | "in" | "is_null";
+        }[];
+        spatial_operator?: "bbox" | "intersects_point" | "dwithin_point" | "intersects_feature";
+        bbox_west?: number;
+        bbox_south?: number;
+        bbox_east?: number;
+        bbox_north?: number;
+        intersects_lon?: number;
+        intersects_lat?: number;
+        dwithin_lon?: number;
+        dwithin_lat?: number;
+        dwithin_distance_m?: number;
+        intersects_feature_typename?: string;
+        intersects_feature_id?: string;
     }, {
-        cql_filter?: string;
         typename?: string;
-        property_names?: string;
-        sort_by?: string;
-        count?: number;
-        result_type?: "results" | "hits" | "url";
+        limit?: number;
+        result_type?: "request" | "results" | "hits";
+        select?: string[];
+        order_by?: {
+            property?: string;
+            direction?: "asc" | "desc";
+        }[];
+        where?: {
+            values?: string[];
+            value?: string;
+            property?: string;
+            operator?: "gte" | "gt" | "lte" | "lt" | "eq" | "ne" | "in" | "is_null";
+        }[];
+        spatial_operator?: "bbox" | "intersects_point" | "dwithin_point" | "intersects_feature";
+        bbox_west?: number;
+        bbox_south?: number;
+        bbox_east?: number;
+        bbox_north?: number;
+        intersects_lon?: number;
+        intersects_lat?: number;
+        dwithin_lon?: number;
+        dwithin_lat?: number;
+        dwithin_distance_m?: number;
+        intersects_feature_typename?: string;
+        intersects_feature_id?: string;
     }>;
+    /**
+     * Exposes an input schema variant that stays compatible with most MCP integrations.
+     *
+     * @returns The published input schema exposed through the MCP tool definition.
+     */
+    get inputSchema(): {
+        type: "object";
+        properties?: Record<string, object>;
+        required?: string[];
+    };
+    /**
+     * Formats compact responses (`hits`, `request`) into `structuredContent`.
+     * Full result sets are still delegated to the framework default behavior.
+     *
+     * @param data Raw execution result returned by the tool implementation.
+     * @returns An MCP success response, optionally enriched with structured content.
+     */
     protected createSuccessResponse(data: unknown): import("mcp-framework").ToolResponse | {
         content: {
             type: "text";
@@ -70,10 +142,64 @@ declare class GpfWfsGetFeaturesTool extends MCPTool<GpfWfsGetFeaturesInput> {
             text: string;
         }[];
         structuredContent: {
+            body?: string;
+            result_type?: "request";
+            method?: "POST";
             url?: string;
-            result_type?: "url";
+            query?: Record<string, string>;
+            get_url?: string;
         };
     };
-    execute(input: GpfWfsGetFeaturesInput): Promise<any>;
+    /**
+     * Loads a WFS feature type description from the embedded catalog.
+     *
+     * @param typename Exact WFS typename to load from the embedded schema store.
+     * @returns The matching feature type description.
+     */
+    protected getFeatureType(typename: string): Promise<Collection>;
+    /**
+     * Executes a compiled WFS request as POST and returns the JSON FeatureCollection.
+     *
+     * @param request Compiled request split into query-string parameters and POST body.
+     * @returns The parsed JSON response returned by the WFS endpoint.
+     */
+    protected fetchFeatureCollection(request: CompiledRequest): Promise<any>;
+    /**
+     * Extracts a result count from a WFS response, preferring `numberMatched`.
+     * Explicitly rejects responses that do not provide a usable total.
+     *
+     * @param featureCollection Parsed WFS response object.
+     * @returns The total number of matching features.
+     */
+    protected getMatchedFeatureCount(featureCollection: Record<string, unknown>): number;
+    /**
+     * Enriches transformed features with a complete `feature_ref`, reusable
+     * in particular by `intersects_feature`.
+     *
+     * @param featureCollection Raw WFS FeatureCollection response.
+     * @param typename Typename of the main queried layer.
+     * @returns The transformed FeatureCollection with fully populated feature references.
+     */
+    protected attachFeatureRefs(featureCollection: Record<string, unknown>, typename: string): Record<string, unknown>;
+    /**
+     * Resolves the geometry of a reference feature when `intersects_feature` is used,
+     * then converts it to EWKT for CQL compilation.
+     *
+     * @param input Normalized tool input.
+     * @returns The resolved reference geometry, or `undefined` when no reference feature is needed.
+     */
+    protected resolveIntersectsFeatureGeometry(input: GpfWfsGetFeaturesInput): Promise<{
+        typename: string;
+        feature_id: string;
+        geometry_ewkt: string;
+    }>;
+    /**
+     * Orchestrates the full tool execution flow:
+     * catalog lookup -> compilation -> WFS request -> response post-processing.
+     *
+     * @param input Normalized tool input.
+     * @returns Either a compiled request, a hit count, or a transformed FeatureCollection.
+     */
+    execute(input: GpfWfsGetFeaturesInput): Promise<Record<string, unknown>>;
 }
 export default GpfWfsGetFeaturesTool;