@ignfab/geocontext 0.9.6 → 0.9.7

package/dist/helpers/wfs_engine/schema.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Zod schemas and published MCP input schemas for the structured WFS engine.
+ *
+ * This module centralizes:
+ * - shared schema fragments reused by WFS tools
+ * - public tool input schemas and inferred input types
+ * - compact output schemas used for `hits` and `request` responses
+ */
+import { z } from "zod";
+export declare const DEFAULT_LIMIT = 100;
+export declare const MAX_LIMIT = 5000;
+export declare const REQUEST_GET_URL_MAX_LENGTH = 6000;
+export declare const WHERE_OPERATORS: readonly ["eq", "ne", "lt", "lte", "gt", "gte", "in", "is_null"];
+export declare const SPATIAL_OPERATORS: readonly ["bbox", "intersects_point", "dwithin_point", "intersects_feature"];
+export declare const ORDER_DIRECTIONS: readonly ["asc", "desc"];
+export type SpatialFilter = {
+    operator: "bbox";
+    west: number;
+    south: number;
+    east: number;
+    north: number;
+} | {
+    operator: "intersects_point";
+    lon: number;
+    lat: number;
+} | {
+    operator: "dwithin_point";
+    lon: number;
+    lat: number;
+    distance_m: number;
+} | {
+    operator: "intersects_feature";
+    typename: string;
+    feature_id: string;
+};
+export declare const gpfWfsGetFeaturesRequestOutputSchema: z.ZodObject<{
+    result_type: z.ZodLiteral<"request">;
+    method: z.ZodLiteral<"POST">;
+    url: z.ZodString;
+    query: z.ZodRecord<z.ZodString, z.ZodString>;
+    body: z.ZodString;
+    get_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    result_type: "request";
+    method: "POST";
+    query: Record<string, string>;
+    body: string;
+    get_url?: string | null | undefined;
+}, {
+    url: string;
+    result_type: "request";
+    method: "POST";
+    query: Record<string, string>;
+    body: string;
+    get_url?: string | null | undefined;
+}>;
+export declare const gpfWfsGetFeatureByIdRequestOutputSchema: z.ZodObject<{
+    result_type: z.ZodLiteral<"request">;
+    method: z.ZodLiteral<"POST">;
+    url: z.ZodString;
+    query: z.ZodRecord<z.ZodString, z.ZodString>;
+    body: z.ZodString;
+    get_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    result_type: "request";
+    method: "POST";
+    query: Record<string, string>;
+    body: string;
+    get_url?: string | null | undefined;
+}, {
+    url: string;
+    result_type: "request";
+    method: "POST";
+    query: Record<string, string>;
+    body: string;
+    get_url?: string | null | undefined;
+}>;
+export declare const gpfWfsGetFeaturesInputSchema: z.ZodObject<{
+    typename: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    result_type: z.ZodDefault<z.ZodEnum<["results", "hits", "request"]>>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    order_by: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        property: z.ZodString;
+        direction: z.ZodDefault<z.ZodEnum<["asc", "desc"]>>;
+    }, "strict", z.ZodTypeAny, {
+        property: string;
+        direction: "asc" | "desc";
+    }, {
+        property: string;
+        direction?: "asc" | "desc" | undefined;
+    }>, "many">>;
+    where: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        property: z.ZodString;
+        operator: z.ZodEnum<["eq", "ne", "lt", "lte", "gt", "gte", "in", "is_null"]>;
+        value: z.ZodOptional<z.ZodString>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        property: string;
+        operator: "gte" | "gt" | "lte" | "lt" | "eq" | "ne" | "in" | "is_null";
+        values?: string[] | undefined;
+        value?: string | undefined;
+    }, {
+        property: string;
+        operator: "gte" | "gt" | "lte" | "lt" | "eq" | "ne" | "in" | "is_null";
+        values?: string[] | undefined;
+        value?: string | undefined;
+    }>, "many">>;
+    spatial_operator: z.ZodOptional<z.ZodEnum<["bbox", "intersects_point", "dwithin_point", "intersects_feature"]>>;
+    bbox_west: z.ZodOptional<z.ZodNumber>;
+    bbox_south: z.ZodOptional<z.ZodNumber>;
+    bbox_east: z.ZodOptional<z.ZodNumber>;
+    bbox_north: z.ZodOptional<z.ZodNumber>;
+    intersects_lon: z.ZodOptional<z.ZodNumber>;
+    intersects_lat: z.ZodOptional<z.ZodNumber>;
+    dwithin_lon: z.ZodOptional<z.ZodNumber>;
+    dwithin_lat: z.ZodOptional<z.ZodNumber>;
+    dwithin_distance_m: z.ZodOptional<z.ZodNumber>;
+    intersects_feature_typename: z.ZodOptional<z.ZodString>;
+    intersects_feature_id: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    typename: string;
+    result_type: "request" | "results" | "hits";
+    limit: number;
+    select?: string[] | undefined;
+    order_by?: {
+        property: string;
+        direction: "asc" | "desc";
+    }[] | undefined;
+    where?: {
+        property: string;
+        operator: "gte" | "gt" | "lte" | "lt" | "eq" | "ne" | "in" | "is_null";
+        values?: string[] | undefined;
+        value?: string | undefined;
+    }[] | undefined;
+    spatial_operator?: "bbox" | "intersects_point" | "dwithin_point" | "intersects_feature" | undefined;
+    bbox_west?: number | undefined;
+    bbox_south?: number | undefined;
+    bbox_east?: number | undefined;
+    bbox_north?: number | undefined;
+    intersects_lon?: number | undefined;
+    intersects_lat?: number | undefined;
+    dwithin_lon?: number | undefined;
+    dwithin_lat?: number | undefined;
+    dwithin_distance_m?: number | undefined;
+    intersects_feature_typename?: string | undefined;
+    intersects_feature_id?: string | undefined;
+}, {
+    typename: string;
+    result_type?: "request" | "results" | "hits" | undefined;
+    limit?: number | undefined;
+    select?: string[] | undefined;
+    order_by?: {
+        property: string;
+        direction?: "asc" | "desc" | undefined;
+    }[] | undefined;
+    where?: {
+        property: string;
+        operator: "gte" | "gt" | "lte" | "lt" | "eq" | "ne" | "in" | "is_null";
+        values?: string[] | undefined;
+        value?: string | undefined;
+    }[] | undefined;
+    spatial_operator?: "bbox" | "intersects_point" | "dwithin_point" | "intersects_feature" | undefined;
+    bbox_west?: number | undefined;
+    bbox_south?: number | undefined;
+    bbox_east?: number | undefined;
+    bbox_north?: number | undefined;
+    intersects_lon?: number | undefined;
+    intersects_lat?: number | undefined;
+    dwithin_lon?: number | undefined;
+    dwithin_lat?: number | undefined;
+    dwithin_distance_m?: number | undefined;
+    intersects_feature_typename?: string | undefined;
+    intersects_feature_id?: string | undefined;
+}>;
+export type GpfWfsGetFeaturesInput = z.infer<typeof gpfWfsGetFeaturesInputSchema>;
+export type WhereClause = NonNullable<GpfWfsGetFeaturesInput["where"]>[number];
+export type OrderByClause = NonNullable<GpfWfsGetFeaturesInput["order_by"]>[number];
+export declare const gpfWfsGetFeaturesHitsOutputSchema: z.ZodObject<{
+    result_type: z.ZodLiteral<"hits">;
+    totalFeatures: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    result_type: "hits";
+    totalFeatures: number;
+}, {
+    result_type: "hits";
+    totalFeatures: number;
+}>;
+export declare const gpfWfsGetFeaturesPublishedInputSchema: import("../jsonSchema.js").PublishedInputSchema;
+export declare const gpfWfsGetFeatureByIdInputSchema: z.ZodObject<{
+    typename: z.ZodString;
+    feature_id: z.ZodString;
+    result_type: z.ZodDefault<z.ZodEnum<["results", "request"]>>;
+    select: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    typename: string;
+    feature_id: string;
+    result_type: "request" | "results";
+    select?: string[] | undefined;
+}, {
+    typename: string;
+    feature_id: string;
+    result_type?: "request" | "results" | undefined;
+    select?: string[] | undefined;
+}>;
+export type GpfWfsGetFeatureByIdInput = z.infer<typeof gpfWfsGetFeatureByIdInputSchema>;
+export declare const gpfWfsGetFeatureByIdPublishedInputSchema: import("../jsonSchema.js").PublishedInputSchema;

package/dist/helpers/{wfs_internal → wfs_engine}/schema.js

@@ -1,12 +1,22 @@
+/**
+ * Zod schemas and published MCP input schemas for the structured WFS engine.
+ *
+ * This module centralizes:
+ * - shared schema fragments reused by WFS tools
+ * - public tool input schemas and inferred input types
+ * - compact output schemas used for `hits` and `request` responses
+ */
 import { z } from "zod";
-import { generatePublishedInputSchema } from "../../helpers/jsonSchema.js";
-import { lonSchema, latSchema } from "../../helpers/schemas.js";
+import { generatePublishedInputSchema } from "../jsonSchema.js";
+import { lonSchema, latSchema } from "../schemas.js";
+// --- Shared Constants ---
 export const DEFAULT_LIMIT = 100;
 export const MAX_LIMIT = 5000;
 export const REQUEST_GET_URL_MAX_LENGTH = 6000;
 export const WHERE_OPERATORS = ["eq", "ne", "lt", "lte", "gt", "gte", "in", "is_null"];
 export const SPATIAL_OPERATORS = ["bbox", "intersects_point", "dwithin_point", "intersects_feature"];
 export const ORDER_DIRECTIONS = ["asc", "desc"];
+// --- Shared Clauses ---
 const whereClauseSchema = z.object({
     property: z.string().trim().min(1).describe("Nom exact d'une propriété non géométrique du type WFS. Utiliser `gpf_wfs_describe_type` pour connaître les noms exacts disponibles."),
     operator: z.enum(WHERE_OPERATORS).describe("Opérateur de filtre : `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `in`, `is_null`."),
@@ -17,6 +27,18 @@ const orderBySchema = z.object({
     property: z.string().trim().min(1).describe("Nom exact d'une propriété non géométrique à utiliser pour le tri. Utiliser `gpf_wfs_describe_type` pour connaître les noms exacts disponibles."),
     direction: z.enum(ORDER_DIRECTIONS).default("asc").describe("Direction de tri : `asc` ou `desc`."),
 }).strict().describe("Critère de tri structuré. Exemple : `{ property: \"population\", direction: \"desc\" }`.");
+// --- Shared Compact Outputs ---
+const wfsRequestOutputSchema = z.object({
+    result_type: z.literal("request").describe("Indique que la réponse contient la requête WFS compilée (équivalent enrichi géométrie pour `create_map` et le débogage)."),
+    method: z.literal("POST").describe("Méthode HTTP réellement utilisée pour exécuter la requête."),
+    url: z.string().describe("URL de base appelée pour la requête POST."),
+    query: z.record(z.string()).describe("Paramètres WFS envoyés dans la query string."),
+    body: z.string().describe("Corps de la requête POST, encodé en `application/x-www-form-urlencoded`."),
+    get_url: z.string().nullable().optional().describe("URL GET dérivée quand la requête reste raisonnablement portable en GET."),
+});
+export const gpfWfsGetFeaturesRequestOutputSchema = wfsRequestOutputSchema;
+export const gpfWfsGetFeatureByIdRequestOutputSchema = wfsRequestOutputSchema;
+// --- `gpf_wfs_get_features` ---
 export const gpfWfsGetFeaturesInputSchema = z.object({
     typename: z
         .string()
@@ -65,17 +87,35 @@ export const gpfWfsGetFeaturesInputSchema = z.object({
     intersects_feature_typename: z.string().trim().min(1).optional().describe("Type WFS du feature de référence, utilisé avec `spatial_operator = \"intersects_feature\"`."),
     intersects_feature_id: z.string().trim().min(1).optional().describe("Identifiant du feature de référence, utilisé avec `spatial_operator = \"intersects_feature\"`."),
 }).strict();
+// --- `gpf_wfs_get_features` Outputs ---
 export const gpfWfsGetFeaturesHitsOutputSchema = z.object({
     result_type: z.literal("hits").describe("Indique que la réponse contient uniquement un comptage."),
     totalFeatures: z.number().describe("Le nombre total d'objets correspondant à la requête."),
 });
-export const gpfWfsGetFeaturesRequestOutputSchema = z.object({
-    result_type: z.literal("request").describe("Indique que la réponse contient la requête WFS compilée (équivalent enrichi géométrie pour `create_map` et le débogage)."),
-    method: z.literal("POST").describe("Méthode HTTP réellement utilisée pour exécuter la requête."),
-    url: z.string().describe("URL de base appelée pour la requête POST."),
-    query: z.record(z.string()).describe("Paramètres WFS envoyés dans la query string."),
-    body: z.string().describe("Corps de la requête POST, encodé en `application/x-www-form-urlencoded`."),
-    get_url: z.string().nullable().optional().describe("URL GET dérivée quand la requête reste raisonnablement portable en GET."),
-});
+// --- `gpf_wfs_get_features` Published Schema ---
 export const gpfWfsGetFeaturesPublishedInputSchema = generatePublishedInputSchema(gpfWfsGetFeaturesInputSchema);
+// --- `gpf_wfs_get_feature_by_id` ---
+export const gpfWfsGetFeatureByIdInputSchema = z.object({
+    typename: z
+        .string()
+        .trim()
+        .min(1, "le nom du type ne doit pas être vide")
+        .describe("Nom exact du type WFS à interroger, par exemple `ADMINEXPRESS-COG.LATEST:commune`."),
+    feature_id: z
+        .string()
+        .trim()
+        .min(1, "le feature_id ne doit pas être vide")
+        .describe("Identifiant WFS exact de l'objet à récupérer, par exemple `commune.8952`."),
+    result_type: z
+        .enum(["results", "request"])
+        .default("results")
+        .describe("`results` renvoie une FeatureCollection normalisée avec exactement un objet. `request` renvoie la requête WFS compilée (`get_url`) à destination de `create_map` via `geojson_url`, ou pour déboguer."),
+    select: z
+        .array(z.string().trim().min(1))
+        .min(1)
+        .optional()
+        .describe("Liste des propriétés non géométriques à renvoyer. Quand `result_type=\"request\"`, la géométrie est automatiquement ajoutée."),
+}).strict();
+// --- `gpf_wfs_get_feature_by_id` Published Schema ---
+export const gpfWfsGetFeatureByIdPublishedInputSchema = generatePublishedInputSchema(gpfWfsGetFeatureByIdInputSchema);
 //# sourceMappingURL=schema.js.map

package/dist/helpers/wfs_engine/schema.js.map

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

package/dist/helpers/wfs_engine/spatialCql.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Spatial CQL compilation helpers for the structured WFS query compiler.
+ *
+ * This module turns normalized spatial filter objects into CQL fragments that
+ * can be combined with attribute predicates in the final query.
+ */
+import type { CollectionProperty } from "@ignfab/gpf-schema-store";
+import type { SpatialFilter } from "./schema.js";
+/**
+ * Compiles a bbox spatial filter into a CQL predicate.
+ *
+ * @param geometryProperty Geometry property already resolved for the feature type.
+ * @param spatialFilter Normalized bbox filter.
+ * @returns A CQL bbox predicate.
+ */
+export declare function compileBboxSpatialFilter(geometryProperty: CollectionProperty, spatialFilter: Extract<SpatialFilter, {
+    operator: "bbox";
+}>): string;
+/**
+ * Compiles an intersects-point spatial filter into a CQL predicate.
+ *
+ * @param geometryProperty Geometry property already resolved for the feature type.
+ * @param spatialFilter Normalized point intersection filter.
+ * @returns A CQL intersects predicate.
+ */
+export declare function compileIntersectsPointSpatialFilter(geometryProperty: CollectionProperty, spatialFilter: Extract<SpatialFilter, {
+    operator: "intersects_point";
+}>): string;
+/**
+ * Compiles a distance-based spatial filter into a CQL predicate.
+ *
+ * @param geometryProperty Geometry property already resolved for the feature type.
+ * @param spatialFilter Normalized distance filter.
+ * @returns A CQL dwithin predicate.
+ */
+export declare function compileDwithinSpatialFilter(geometryProperty: CollectionProperty, spatialFilter: Extract<SpatialFilter, {
+    operator: "dwithin_point";
+}>): string;
+/**
+ * Compiles an `intersects_feature` spatial filter once the reference geometry is already serialized.
+ *
+ * @param geometryProperty Geometry property already resolved for the feature type.
+ * @param geometryEwkt Reference geometry serialized as EWKT.
+ * @returns A CQL intersects predicate.
+ */
+export declare function compileIntersectsFeatureSpatialFilter(geometryProperty: CollectionProperty, geometryEwkt: string): string;

package/dist/helpers/wfs_engine/spatialCql.js

@@ -0,0 +1,54 @@
+/**
+ * Spatial CQL compilation helpers for the structured WFS query compiler.
+ *
+ * This module turns normalized spatial filter objects into CQL fragments that
+ * can be combined with attribute predicates in the final query.
+ */
+// --- Spatial Predicate Compilation ---
+/**
+ * Compiles a bbox spatial filter into a CQL predicate.
+ *
+ * @param geometryProperty Geometry property already resolved for the feature type.
+ * @param spatialFilter Normalized bbox filter.
+ * @returns A CQL bbox predicate.
+ */
+export function compileBboxSpatialFilter(geometryProperty, spatialFilter) {
+    if (spatialFilter.west >= spatialFilter.east) {
+        throw new Error("Le bbox est invalide : `bbox_west` doit être strictement inférieur à `bbox_east`.");
+    }
+    if (spatialFilter.south >= spatialFilter.north) {
+        throw new Error("Le bbox est invalide : `bbox_south` doit être strictement inférieur à `bbox_north`.");
+    }
+    return `BBOX(${geometryProperty.name},${spatialFilter.west},${spatialFilter.south},${spatialFilter.east},${spatialFilter.north},'EPSG:4326')`;
+}
+/**
+ * Compiles an intersects-point spatial filter into a CQL predicate.
+ *
+ * @param geometryProperty Geometry property already resolved for the feature type.
+ * @param spatialFilter Normalized point intersection filter.
+ * @returns A CQL intersects predicate.
+ */
+export function compileIntersectsPointSpatialFilter(geometryProperty, spatialFilter) {
+    return `INTERSECTS(${geometryProperty.name},SRID=4326;POINT(${spatialFilter.lon} ${spatialFilter.lat}))`;
+}
+/**
+ * Compiles a distance-based spatial filter into a CQL predicate.
+ *
+ * @param geometryProperty Geometry property already resolved for the feature type.
+ * @param spatialFilter Normalized distance filter.
+ * @returns A CQL dwithin predicate.
+ */
+export function compileDwithinSpatialFilter(geometryProperty, spatialFilter) {
+    return `DWITHIN(${geometryProperty.name},SRID=4326;POINT(${spatialFilter.lon} ${spatialFilter.lat}),${spatialFilter.distance_m},meters)`;
+}
+/**
+ * Compiles an `intersects_feature` spatial filter once the reference geometry is already serialized.
+ *
+ * @param geometryProperty Geometry property already resolved for the feature type.
+ * @param geometryEwkt Reference geometry serialized as EWKT.
+ * @returns A CQL intersects predicate.
+ */
+export function compileIntersectsFeatureSpatialFilter(geometryProperty, geometryEwkt) {
+    return `INTERSECTS(${geometryProperty.name},${geometryEwkt})`;
+}
+//# sourceMappingURL=spatialCql.js.map

package/dist/helpers/wfs_engine/spatialCql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatialCql.js","sourceRoot":"","sources":["../../../src/helpers/wfs_engine/spatialCql.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,wCAAwC;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,gBAAoC,EAAE,aAA2D;IACxI,IAAI,aAAa,CAAC,IAAI,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;IACvG,CAAC;IACD,IAAI,aAAa,CAAC,KAAK,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,qFAAqF,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,QAAQ,gBAAgB,CAAC,IAAI,IAAI,aAAa,CAAC,IAAI,IAAI,aAAa,CAAC,KAAK,IAAI,aAAa,CAAC,IAAI,IAAI,aAAa,CAAC,KAAK,eAAe,CAAC;AAChJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mCAAmC,CAAC,gBAAoC,EAAE,aAAuE;IAC/J,OAAO,cAAc,gBAAgB,CAAC,IAAI,oBAAoB,aAAa,CAAC,GAAG,IAAI,aAAa,CAAC,GAAG,IAAI,CAAC;AAC3G,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,gBAAoC,EAAE,aAAoE;IACpJ,OAAO,WAAW,gBAAgB,CAAC,IAAI,oBAAoB,aAAa,CAAC,GAAG,IAAI,aAAa,CAAC,GAAG,KAAK,aAAa,CAAC,UAAU,UAAU,CAAC;AAC3I,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qCAAqC,CAAC,gBAAoC,EAAE,YAAoB;IAC9G,OAAO,cAAc,gBAAgB,CAAC,IAAI,IAAI,YAAY,GAAG,CAAC;AAChE,CAAC"}

package/dist/helpers/wfs_engine/spatialFilter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Spatial input normalization helpers for the structured WFS query compiler.
+ *
+ * This module turns raw tool input parameters into normalized spatial filter
+ * objects that can then be compiled into CQL fragments.
+ */
+import type { GpfWfsGetFeaturesInput, SpatialFilter } from "./schema.js";
+/**
+ * Normalizes the raw spatial input into a discriminated spatial filter object.
+ *
+ * @param input Normalized tool input.
+ * @returns A normalized spatial filter, or `undefined` when no spatial filter is requested.
+ */
+export declare function getSpatialFilter(input: GpfWfsGetFeaturesInput): SpatialFilter | undefined;

package/dist/helpers/wfs_engine/spatialFilter.js

@@ -0,0 +1,131 @@
+/**
+ * Spatial input normalization helpers for the structured WFS query compiler.
+ *
+ * This module turns raw tool input parameters into normalized spatial filter
+ * objects that can then be compiled into CQL fragments.
+ */
+// --- Parameter Groups ---
+const BBOX_PARAM_NAMES = ["bbox_west", "bbox_south", "bbox_east", "bbox_north"];
+const INTERSECTS_POINT_PARAM_NAMES = ["intersects_lon", "intersects_lat"];
+const DWITHIN_PARAM_NAMES = ["dwithin_lon", "dwithin_lat", "dwithin_distance_m"];
+const INTERSECTS_FEATURE_PARAM_NAMES = ["intersects_feature_typename", "intersects_feature_id"];
+// --- Parameter Detection ---
+/**
+ * Checks whether any property in a named group is defined on the raw input object.
+ *
+ * @param input Normalized tool input.
+ * @param keys Input keys to inspect.
+ * @returns `true` when at least one key from the group is present.
+ */
+function hasAny(input, keys) {
+    return keys.some((name) => input[name] !== undefined);
+}
+// --- Per-Mode Readers ---
+/**
+ * Reads and validates the `bbox` spatial filter parameters.
+ *
+ * @param input Normalized tool input.
+ * @returns A normalized `bbox` spatial filter.
+ */
+function readBboxFilter(input) {
+    if (input.bbox_west === undefined || input.bbox_south === undefined || input.bbox_east === undefined || input.bbox_north === undefined) {
+        throw new Error("Le filtre spatial `bbox` exige `bbox_west`, `bbox_south`, `bbox_east` et `bbox_north`.");
+    }
+    return {
+        operator: "bbox",
+        west: input.bbox_west,
+        south: input.bbox_south,
+        east: input.bbox_east,
+        north: input.bbox_north,
+    };
+}
+/**
+ * Reads and validates the `intersects_point` spatial filter parameters.
+ *
+ * @param input Normalized tool input.
+ * @returns A normalized `intersects_point` spatial filter.
+ */
+function readIntersectsPointFilter(input) {
+    if (input.intersects_lon === undefined || input.intersects_lat === undefined) {
+        throw new Error("Le filtre spatial `intersects_point` exige `intersects_lon` et `intersects_lat`.");
+    }
+    return {
+        operator: "intersects_point",
+        lon: input.intersects_lon,
+        lat: input.intersects_lat,
+    };
+}
+/**
+ * Reads and validates the `dwithin_point` spatial filter parameters.
+ *
+ * @param input Normalized tool input.
+ * @returns A normalized `dwithin_point` spatial filter.
+ */
+function readDwithinPointFilter(input) {
+    if (input.dwithin_lon === undefined || input.dwithin_lat === undefined || input.dwithin_distance_m === undefined) {
+        throw new Error("Le filtre spatial `dwithin_point` exige `dwithin_lon`, `dwithin_lat` et `dwithin_distance_m`.");
+    }
+    return {
+        operator: "dwithin_point",
+        lon: input.dwithin_lon,
+        lat: input.dwithin_lat,
+        distance_m: input.dwithin_distance_m,
+    };
+}
+/**
+ * Reads and validates the `intersects_feature` spatial filter parameters.
+ *
+ * @param input Normalized tool input.
+ * @returns A normalized `intersects_feature` spatial filter.
+ */
+function readIntersectsFeatureFilter(input) {
+    if (!input.intersects_feature_typename || !input.intersects_feature_id) {
+        throw new Error("Le filtre spatial `intersects_feature` exige `intersects_feature_typename` et `intersects_feature_id`.");
+    }
+    return {
+        operator: "intersects_feature",
+        typename: input.intersects_feature_typename,
+        feature_id: input.intersects_feature_id,
+    };
+}
+// --- Public Normalization ---
+/**
+ * Normalizes the raw spatial input into a discriminated spatial filter object.
+ *
+ * @param input Normalized tool input.
+ * @returns A normalized spatial filter, or `undefined` when no spatial filter is requested.
+ */
+export function getSpatialFilter(input) {
+    const hasBboxParams = hasAny(input, BBOX_PARAM_NAMES);
+    const hasIntersectsPointParams = hasAny(input, INTERSECTS_POINT_PARAM_NAMES);
+    const hasDwithinParams = hasAny(input, DWITHIN_PARAM_NAMES);
+    const hasIntersectsFeatureParams = hasAny(input, INTERSECTS_FEATURE_PARAM_NAMES);
+    switch (input.spatial_operator) {
+        case undefined:
+            if (hasBboxParams || hasIntersectsPointParams || hasDwithinParams || hasIntersectsFeatureParams) {
+                throw new Error("Les paramètres spatiaux exigent `spatial_operator`.");
+            }
+            return undefined;
+        case "bbox":
+            if (hasIntersectsPointParams || hasDwithinParams || hasIntersectsFeatureParams) {
+                throw new Error("Le filtre spatial `bbox` n'accepte pas les paramètres d'un autre mode spatial.");
+            }
+            return readBboxFilter(input);
+        case "intersects_point":
+            if (hasBboxParams || hasDwithinParams || hasIntersectsFeatureParams) {
+                throw new Error("Le filtre spatial `intersects_point` n'accepte pas les paramètres d'un autre mode spatial.");
+            }
+            return readIntersectsPointFilter(input);
+        case "dwithin_point":
+            if (hasBboxParams || hasIntersectsPointParams || hasIntersectsFeatureParams) {
+                throw new Error("Le filtre spatial `dwithin_point` n'accepte pas les paramètres d'un autre mode spatial.");
+            }
+            return readDwithinPointFilter(input);
+        case "intersects_feature":
+            if (hasBboxParams || hasIntersectsPointParams || hasDwithinParams) {
+                throw new Error("Le filtre spatial `intersects_feature` n'accepte pas les paramètres d'un autre mode spatial.");
+            }
+            return readIntersectsFeatureFilter(input);
+    }
+}
+//# sourceMappingURL=spatialFilter.js.map

package/dist/helpers/wfs_engine/spatialFilter.js.map

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