npm - @mailwoman/api - Versions diffs - 9.0.0 → 9.2.0 - Mend

@mailwoman/api 9.0.0 → 9.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/out/schema.d.ts CHANGED Viewed

@@ -7,7 +7,7 @@
  *   libpostal), nothing here is a vendor contract — this surface is ours to design, so request
  *   bodies are REQUIRED and validator-enforced (no legacy tolerance to preserve). A `defaultHook`
  *   on the app maps validation failures through the shared `APIErrorSchema` envelope
- *   (`apiError(c, 400, "invalid request body", <zod summary>)`) — the pattern boundary every
+ *   (`errorResponse(c, 400, "invalid request body", <zod summary>)`) — the pattern boundary every
  *   surface holds to: where no legacy contract exists, the validator MAY speak, but only in
  *   our envelope.
  *
@@ -97,16 +97,210 @@ export declare const GeocodeRequestSchema: z.ZodObject<{
  * `@mailwoman/api`, never the reverse). `mailwoman/test/api-schema-drift.test.ts` is the compile-time tripwire that
  * catches this shape drifting from the real `GeocodeResult` interface.
  */
-export declare const GeocodeOutcomeSchema: z.ZodObject<{
+export declare const GeocodeOutcomeLikeSchema: z.ZodObject<{
     input: z.ZodString;
+    components: z.ZodRecord<z.ZodEnum<{
+        country: "country";
+        region: "region";
+        locality: "locality";
+        dependent_locality: "dependent_locality";
+        postcode: "postcode";
+        subregion: "subregion";
+        house_number: "house_number";
+        street: "street";
+        street_prefix: "street_prefix";
+        street_prefix_particle: "street_prefix_particle";
+        street_suffix: "street_suffix";
+        intersection_a: "intersection_a";
+        intersection_b: "intersection_b";
+        unit: "unit";
+        venue: "venue";
+        attention: "attention";
+        po_box: "po_box";
+        cedex: "cedex";
+        prefecture: "prefecture";
+        municipality: "municipality";
+        district: "district";
+        block: "block";
+        sub_block: "sub_block";
+        building_number: "building_number";
+        building_name: "building_name";
+    }> & z.core.$partial, z.ZodString>;
     lat: z.ZodNullable<z.ZodNumber>;
     lon: z.ZodNullable<z.ZodNumber>;
     resolution_tier: z.ZodEnum<{
+        street: "street";
+        venue: "venue";
         address_point: "address_point";
         interpolated: "interpolated";
+        admin: "admin";
+        plus_code: "plus_code";
+    }>;
+    entity: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        categoryID: z.ZodNullable<z.ZodString>;
+        confidence: z.ZodNumber;
+        country: z.ZodString;
+    }, z.core.$strip>>;
+    uncertainty_m: z.ZodNullable<z.ZodNumber>;
+    locality: z.ZodNullable<z.ZodString>;
+    region: z.ZodNullable<z.ZodString>;
+    postcode: z.ZodNullable<z.ZodString>;
+    house_number: z.ZodNullable<z.ZodString>;
+    street: z.ZodNullable<z.ZodString>;
+    venue: z.ZodNullable<z.ZodString>;
+    dependent_locality: z.ZodNullable<z.ZodString>;
+    unit: z.ZodNullable<z.ZodString>;
+    countryCode: z.ZodNullable<z.ZodString>;
+    hierarchy: z.ZodArray<z.ZodObject<{
+        tag: z.ZodString;
+        value: z.ZodString;
+        name: z.ZodString;
+        lat: z.ZodOptional<z.ZodNumber>;
+        lon: z.ZodOptional<z.ZodNumber>;
+        placeID: z.ZodOptional<z.ZodString>;
+        in_winner_lineage: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    candidates: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        tag: z.ZodString;
+        lat: z.ZodNumber;
+        lon: z.ZodNumber;
+        countryCode: z.ZodNullable<z.ZodString>;
+        placeID: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    rooftop: z.ZodOptional<z.ZodObject<{
+        localityNorm: z.ZodOptional<z.ZodString>;
+        postcode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    postcode_country_scope: z.ZodNullable<z.ZodString>;
+    intent_markers: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            intersection: "intersection";
+            po_box: "po_box";
+            postcode_only: "postcode_only";
+            locality_only: "locality_only";
+            structured_address: "structured_address";
+            landmark: "landmark";
+            poi_query: "poi_query";
+            vague: "vague";
+            bare_toponym: "bare_toponym";
+            route_pair: "route_pair";
+            near_me: "near_me";
+            poi_category: "poi_category";
+        }>;
+        code: z.ZodEnum<{
+            poi_category: "poi_category";
+            declared_ambiguity: "declared_ambiguity";
+            declared_fork: "declared_fork";
+            focus_point_required: "focus_point_required";
+        }>;
+        mechanism: z.ZodString;
+        message: z.ZodString;
+        evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    admin_coherence: z.ZodOptional<z.ZodObject<{
+        region: z.ZodEnum<{
+            confirmed: "confirmed";
+            contradicted: "contradicted";
+            unstated: "unstated";
+            unverifiable: "unverifiable";
+        }>;
+        country: z.ZodEnum<{
+            confirmed: "confirmed";
+            contradicted: "contradicted";
+            unstated: "unstated";
+            unverifiable: "unverifiable";
+        }>;
+    }, z.core.$strip>>;
+    dropped_components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        tag: z.ZodEnum<{
+            country: "country";
+            region: "region";
+            locality: "locality";
+            dependent_locality: "dependent_locality";
+            postcode: "postcode";
+            subregion: "subregion";
+            house_number: "house_number";
+            street: "street";
+            street_prefix: "street_prefix";
+            street_prefix_particle: "street_prefix_particle";
+            street_suffix: "street_suffix";
+            intersection_a: "intersection_a";
+            intersection_b: "intersection_b";
+            unit: "unit";
+            venue: "venue";
+            attention: "attention";
+            po_box: "po_box";
+            cedex: "cedex";
+            prefecture: "prefecture";
+            municipality: "municipality";
+            district: "district";
+            block: "block";
+            sub_block: "sub_block";
+            building_number: "building_number";
+            building_name: "building_name";
+        }>;
+        value: z.ZodString;
+        kept: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type GeocodeOutcomeLike = z.infer<typeof GeocodeOutcomeLikeSchema>;
+/**
+ * `POST /v1/geocode` response — a hand-modeled mirror of `GeocodeResult`'s wire shape (`mailwoman/geocode-core.ts`),
+ * `.loose()` so a field the engine adds that this schema doesn't yet know about still rides through undocumented rather
+ * than being stripped or rejected. DOC-ACCURACY ONLY: the route passes `engine.geocode()`'s outcome through verbatim
+ * (`GeocodeOutcome = Record<string, unknown>`, `api/engine.ts`) — nothing here validates a real response, so a
+ * schema/engine mismatch can never reject or mutate a result at runtime. Deliberately carries NO import from
+ * `mailwoman` (the engine-agnosticism boundary — `mailwoman` is the one workspace allowed to depend on
+ * `@mailwoman/api`, never the reverse). `mailwoman/test/api-schema-drift.test.ts` is the compile-time tripwire that
+ * catches this shape drifting from the real `GeocodeResult` interface.
+ */
+export declare const GeocodeOutcomeSchema: z.ZodObject<{
+    input: z.ZodString;
+    components: z.ZodRecord<z.ZodEnum<{
+        country: "country";
+        region: "region";
+        locality: "locality";
+        dependent_locality: "dependent_locality";
+        postcode: "postcode";
+        subregion: "subregion";
+        house_number: "house_number";
+        street: "street";
+        street_prefix: "street_prefix";
+        street_prefix_particle: "street_prefix_particle";
+        street_suffix: "street_suffix";
+        intersection_a: "intersection_a";
+        intersection_b: "intersection_b";
+        unit: "unit";
+        venue: "venue";
+        attention: "attention";
+        po_box: "po_box";
+        cedex: "cedex";
+        prefecture: "prefecture";
+        municipality: "municipality";
+        district: "district";
+        block: "block";
+        sub_block: "sub_block";
+        building_number: "building_number";
+        building_name: "building_name";
+    }> & z.core.$partial, z.ZodString>;
+    lat: z.ZodNullable<z.ZodNumber>;
+    lon: z.ZodNullable<z.ZodNumber>;
+    resolution_tier: z.ZodEnum<{
         street: "street";
+        venue: "venue";
+        address_point: "address_point";
+        interpolated: "interpolated";
         admin: "admin";
+        plus_code: "plus_code";
     }>;
+    entity: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        categoryID: z.ZodNullable<z.ZodString>;
+        confidence: z.ZodNumber;
+        country: z.ZodString;
+    }, z.core.$strip>>;
     uncertainty_m: z.ZodNullable<z.ZodNumber>;
     locality: z.ZodNullable<z.ZodString>;
     region: z.ZodNullable<z.ZodString>;
@@ -124,6 +318,7 @@ export declare const GeocodeOutcomeSchema: z.ZodObject<{
         lat: z.ZodOptional<z.ZodNumber>;
         lon: z.ZodOptional<z.ZodNumber>;
         placeID: z.ZodOptional<z.ZodString>;
+        in_winner_lineage: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     candidates: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -133,8 +328,83 @@ export declare const GeocodeOutcomeSchema: z.ZodObject<{
         countryCode: z.ZodNullable<z.ZodString>;
         placeID: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    rooftop: z.ZodOptional<z.ZodObject<{
+        localityNorm: z.ZodOptional<z.ZodString>;
+        postcode: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     postcode_country_scope: z.ZodNullable<z.ZodString>;
+    intent_markers: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            intersection: "intersection";
+            po_box: "po_box";
+            postcode_only: "postcode_only";
+            locality_only: "locality_only";
+            structured_address: "structured_address";
+            landmark: "landmark";
+            poi_query: "poi_query";
+            vague: "vague";
+            bare_toponym: "bare_toponym";
+            route_pair: "route_pair";
+            near_me: "near_me";
+            poi_category: "poi_category";
+        }>;
+        code: z.ZodEnum<{
+            poi_category: "poi_category";
+            declared_ambiguity: "declared_ambiguity";
+            declared_fork: "declared_fork";
+            focus_point_required: "focus_point_required";
+        }>;
+        mechanism: z.ZodString;
+        message: z.ZodString;
+        evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    admin_coherence: z.ZodOptional<z.ZodObject<{
+        region: z.ZodEnum<{
+            confirmed: "confirmed";
+            contradicted: "contradicted";
+            unstated: "unstated";
+            unverifiable: "unverifiable";
+        }>;
+        country: z.ZodEnum<{
+            confirmed: "confirmed";
+            contradicted: "contradicted";
+            unstated: "unstated";
+            unverifiable: "unverifiable";
+        }>;
+    }, z.core.$strip>>;
+    dropped_components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        tag: z.ZodEnum<{
+            country: "country";
+            region: "region";
+            locality: "locality";
+            dependent_locality: "dependent_locality";
+            postcode: "postcode";
+            subregion: "subregion";
+            house_number: "house_number";
+            street: "street";
+            street_prefix: "street_prefix";
+            street_prefix_particle: "street_prefix_particle";
+            street_suffix: "street_suffix";
+            intersection_a: "intersection_a";
+            intersection_b: "intersection_b";
+            unit: "unit";
+            venue: "venue";
+            attention: "attention";
+            po_box: "po_box";
+            cedex: "cedex";
+            prefecture: "prefecture";
+            municipality: "municipality";
+            district: "district";
+            block: "block";
+            sub_block: "sub_block";
+            building_number: "building_number";
+            building_name: "building_name";
+        }>;
+        value: z.ZodString;
+        kept: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$loose>;
+export type GeocodeOutcome = z.infer<typeof GeocodeOutcomeSchema>;
 /**
  * `POST /v1/batch` request body.
  */
@@ -151,14 +421,49 @@ export declare const BatchRequestSchema: z.ZodObject<{
 export declare const BatchResponseSchema: z.ZodObject<{
     results: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         input: z.ZodString;
+        components: z.ZodRecord<z.ZodEnum<{
+            country: "country";
+            region: "region";
+            locality: "locality";
+            dependent_locality: "dependent_locality";
+            postcode: "postcode";
+            subregion: "subregion";
+            house_number: "house_number";
+            street: "street";
+            street_prefix: "street_prefix";
+            street_prefix_particle: "street_prefix_particle";
+            street_suffix: "street_suffix";
+            intersection_a: "intersection_a";
+            intersection_b: "intersection_b";
+            unit: "unit";
+            venue: "venue";
+            attention: "attention";
+            po_box: "po_box";
+            cedex: "cedex";
+            prefecture: "prefecture";
+            municipality: "municipality";
+            district: "district";
+            block: "block";
+            sub_block: "sub_block";
+            building_number: "building_number";
+            building_name: "building_name";
+        }> & z.core.$partial, z.ZodString>;
         lat: z.ZodNullable<z.ZodNumber>;
         lon: z.ZodNullable<z.ZodNumber>;
         resolution_tier: z.ZodEnum<{
+            street: "street";
+            venue: "venue";
             address_point: "address_point";
             interpolated: "interpolated";
-            street: "street";
             admin: "admin";
+            plus_code: "plus_code";
         }>;
+        entity: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            categoryID: z.ZodNullable<z.ZodString>;
+            confidence: z.ZodNumber;
+            country: z.ZodString;
+        }, z.core.$strip>>;
         uncertainty_m: z.ZodNullable<z.ZodNumber>;
         locality: z.ZodNullable<z.ZodString>;
         region: z.ZodNullable<z.ZodString>;
@@ -176,6 +481,7 @@ export declare const BatchResponseSchema: z.ZodObject<{
             lat: z.ZodOptional<z.ZodNumber>;
             lon: z.ZodOptional<z.ZodNumber>;
             placeID: z.ZodOptional<z.ZodString>;
+            in_winner_lineage: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
         candidates: z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -185,7 +491,81 @@ export declare const BatchResponseSchema: z.ZodObject<{
             countryCode: z.ZodNullable<z.ZodString>;
             placeID: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        rooftop: z.ZodOptional<z.ZodObject<{
+            localityNorm: z.ZodOptional<z.ZodString>;
+            postcode: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         postcode_country_scope: z.ZodNullable<z.ZodString>;
+        intent_markers: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                intersection: "intersection";
+                po_box: "po_box";
+                postcode_only: "postcode_only";
+                locality_only: "locality_only";
+                structured_address: "structured_address";
+                landmark: "landmark";
+                poi_query: "poi_query";
+                vague: "vague";
+                bare_toponym: "bare_toponym";
+                route_pair: "route_pair";
+                near_me: "near_me";
+                poi_category: "poi_category";
+            }>;
+            code: z.ZodEnum<{
+                poi_category: "poi_category";
+                declared_ambiguity: "declared_ambiguity";
+                declared_fork: "declared_fork";
+                focus_point_required: "focus_point_required";
+            }>;
+            mechanism: z.ZodString;
+            message: z.ZodString;
+            evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        admin_coherence: z.ZodOptional<z.ZodObject<{
+            region: z.ZodEnum<{
+                confirmed: "confirmed";
+                contradicted: "contradicted";
+                unstated: "unstated";
+                unverifiable: "unverifiable";
+            }>;
+            country: z.ZodEnum<{
+                confirmed: "confirmed";
+                contradicted: "contradicted";
+                unstated: "unstated";
+                unverifiable: "unverifiable";
+            }>;
+        }, z.core.$strip>>;
+        dropped_components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            tag: z.ZodEnum<{
+                country: "country";
+                region: "region";
+                locality: "locality";
+                dependent_locality: "dependent_locality";
+                postcode: "postcode";
+                subregion: "subregion";
+                house_number: "house_number";
+                street: "street";
+                street_prefix: "street_prefix";
+                street_prefix_particle: "street_prefix_particle";
+                street_suffix: "street_suffix";
+                intersection_a: "intersection_a";
+                intersection_b: "intersection_b";
+                unit: "unit";
+                venue: "venue";
+                attention: "attention";
+                po_box: "po_box";
+                cedex: "cedex";
+                prefecture: "prefecture";
+                municipality: "municipality";
+                district: "district";
+                block: "block";
+                sub_block: "sub_block";
+                building_number: "building_number";
+                building_name: "building_name";
+            }>;
+            value: z.ZodString;
+            kept: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$loose>, z.ZodObject<{
         input: z.ZodString;
         error: z.ZodString;

package/out/schema.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAA;AAErC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnD;;GAEG;AACH;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;EAA2D,CAAA;AAEvF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAA;AAEtC;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;iBAMN,CAAA;AAEzB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;iBAA6E,CAAA;AAE9G;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;iBAON,CAAA;AAEzB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;iBAKN,CAAA;~~AAiC3B~~;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2BN~~,CAAA;~~AAE3B~~;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;iBAUN,CAAA;AAYzB;;GAEG;AACH,eAAO,MAAM,mBAAmB~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~iBAIN,CAAA;AAE1B;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;iBAKN,CAAA;AAE3B;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;iBAIN,CAAA;AAQ5B;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;iBAMN,CAAA;AAE1B;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;iBAKN,CAAA;AAE3B;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;iBAMN,CAAA"}
1	+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAA;AAErC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnD;;GAEG;AACH;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;EAA2D,CAAA;AAEvF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAA;AAEtC;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;iBAMN,CAAA;AAEzB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;iBAA6E,CAAA;AAE9G;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;iBAON,CAAA;AAEzB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;iBAKN,CAAA;AA8G3B;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsEnC,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEzE;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA6D,CAAA;AAE9F,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;iBAUN,CAAA;AAYzB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIN,CAAA;AAE1B;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;iBAKN,CAAA;AAE3B;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;iBAIN,CAAA;AAQ5B;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;iBAMN,CAAA;AAE1B;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;iBAKN,CAAA;AAE3B;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;iBAMN,CAAA"}

package/out/schema.js CHANGED Viewed

@@ -7,7 +7,7 @@
  *   libpostal), nothing here is a vendor contract — this surface is ours to design, so request
  *   bodies are REQUIRED and validator-enforced (no legacy tolerance to preserve). A `defaultHook`
  *   on the app maps validation failures through the shared `APIErrorSchema` envelope
- *   (`apiError(c, 400, "invalid request body", <zod summary>)`) — the pattern boundary every
+ *   (`errorResponse(c, 400, "invalid request body", <zod summary>)`) — the pattern boundary every
  *   surface holds to: where no legacy contract exists, the validator MAY speak, but only in
  *   our envelope.
  *
@@ -89,6 +89,9 @@ const GeocodeHierarchyEntrySchema = z
     lat: z.number().optional(),
     lon: z.number().optional(),
     placeID: z.string().optional(),
+    // #1731 tri-state lineage provenance: true = the winner's ancestor chain vouches for this entry, false =
+    // resolved independently OUTSIDE the winner's lineage, absent = unverifiable. Absence is not false.
+    in_winner_lineage: z.boolean().optional(),
 })
     .openapi("GeocodeHierarchyEntry");
 /**
@@ -105,6 +108,77 @@ const GeocodeCandidateSchema = z
     placeID: z.string().optional(),
 })
     .openapi("GeocodeCandidate");
+/**
+ * The `ComponentTag` union at this engine-agnostic boundary, named once so every schema that speaks about a tag speaks
+ * about the SAME list. Two hand-copied enums would agree on the day they were written and diverge on the day a tag is
+ * added — the shape of defect `feedback-parity-needs-shared-function-not-shared-constants` describes.
+ */
+const ComponentTagSchema = z.enum([
+    "country",
+    "region",
+    "locality",
+    "dependent_locality",
+    "postcode",
+    "subregion",
+    "house_number",
+    "street",
+    "street_prefix",
+    "street_prefix_particle",
+    "street_suffix",
+    "intersection_a",
+    "intersection_b",
+    "unit",
+    "venue",
+    "attention",
+    "po_box",
+    "cedex",
+    "prefecture",
+    "municipality",
+    "district",
+    "block",
+    "sub_block",
+    "building_number",
+    "building_name",
+]);
+/**
+ * Canonical parsed-component map carried by `GeocodeResult.components`. Spelled out at this engine-agnostic API
+ * boundary for the same reason the result schema is hand-modeled; the compile-time drift pin in
+ * `mailwoman/test/api-schema-drift.test.ts` catches any mismatch with the real `ComponentTag`-keyed result type.
+ */
+const GeocodeComponentsSchema = z.partialRecord(ComponentTagSchema, z.string());
+/**
+ * One `GeocodeOutcome.intent_markers` entry — an advisory the ROAD_TO_V9 §4 intent vocabulary raised about the QUERY.
+ * Mirrors `QueryIntentMarker` (`core/pipeline/types.ts`).
+ *
+ * `evidence` is deliberately open (`z.record`): each `code` carries its own measurement — a dominance margin, a pair of
+ * interpretations, a taxonomy id — and flattening those into one closed shape would either lose the numbers or invent
+ * fields that do not apply. `code` is the discriminator a client branches on.
+ */
+const QueryIntentMarkerSchema = z
+    .object({
+    // Spelled out rather than `z.string()` so `mailwoman/test/api-schema-drift.test.ts`'s schema-too-wide direction
+    // keeps biting: a new `QueryKind` that never reaches this list is a documented contract that has quietly stopped
+    // describing the real one.
+    kind: z.enum([
+        "postcode_only",
+        "locality_only",
+        "structured_address",
+        "intersection",
+        "po_box",
+        "landmark",
+        "poi_query",
+        "vague",
+        "bare_toponym",
+        "route_pair",
+        "near_me",
+        "poi_category",
+    ]),
+    code: z.enum(["declared_ambiguity", "declared_fork", "focus_point_required", "poi_category"]),
+    mechanism: z.string(),
+    message: z.string(),
+    evidence: z.record(z.string(), z.unknown()).optional(),
+})
+    .openapi("QueryIntentMarker");
 /**
  * `POST /v1/geocode` response — a hand-modeled mirror of `GeocodeResult`'s wire shape (`mailwoman/geocode-core.ts`),
  * `.loose()` so a field the engine adds that this schema doesn't yet know about still rides through undocumented rather
@@ -115,12 +189,22 @@ const GeocodeCandidateSchema = z
  * `@mailwoman/api`, never the reverse). `mailwoman/test/api-schema-drift.test.ts` is the compile-time tripwire that
  * catches this shape drifting from the real `GeocodeResult` interface.
  */
-export const GeocodeOutcomeSchema = z
-    .object({
+export const GeocodeOutcomeLikeSchema = z.object({
     input: z.string(),
+    components: GeocodeComponentsSchema,
     lat: z.number().nullable(),
     lon: z.number().nullable(),
-    resolution_tier: z.enum(["address_point", "interpolated", "street", "admin"]),
+    resolution_tier: z.enum(["address_point", "interpolated", "street", "admin", "venue", "plus_code"]),
+    // The fork→entity probe's answer (#1585) — present only on the `venue` tier; see geocode-core's
+    // GeocodeResult.entity.
+    entity: z
+        .object({
+        name: z.string(),
+        categoryID: z.string().nullable(),
+        confidence: z.number(),
+        country: z.string(),
+    })
+        .optional(),
     uncertainty_m: z.number().nullable(),
     locality: z.string().nullable(),
     region: z.string().nullable(),
@@ -136,13 +220,55 @@ export const GeocodeOutcomeSchema = z
     countryCode: z.string().nullable(),
     hierarchy: z.array(GeocodeHierarchyEntrySchema),
     candidates: z.array(GeocodeCandidateSchema),
+    // The register row's OWN scope tags when the address_point tier answered and its shard carries
+    // them (normalized locality key + postcode of the ROOFTOP) — see geocode-core's GeocodeResult.rooftop.
+    rooftop: z
+        .object({
+        localityNorm: z.string().optional(),
+        postcode: z.string().optional(),
+    })
+        .optional(),
     // #42: the country the postcode-country coherence pass scoped the walk to, or null. Non-null ONLY when it
     // OVERRODE the request's country prior — so a caller who asked for US and got an FR answer can see which
     // evidence bought the change instead of reading it as a bug.
     postcode_country_scope: z.string().nullable(),
-})
-    .loose()
-    .openapi("GeocodeOutcome");
+    // ROAD_TO_V9 §4: query-intent advisories. Always present; empty means the vocabulary looked and had nothing to
+    // say. Advisory ONLY — no marker changed which answer won, and a client is free to ignore the array entirely.
+    intent_markers: z.array(QueryIntentMarkerSchema),
+    // #1717 stage 1: flag-only admin-coherence verdicts — did the winning candidate's resolved ancestry confirm,
+    // contradict, or fail to speak to the PARSED region/country qualifiers? Nothing ranks or gates on these; present
+    // whenever a winner resolved (both members always populated — `unstated` is the explicit no-qualifier claim),
+    // absent when nothing resolved to check against. See mailwoman's `admin-coherence.ts` for the verdict contract.
+    admin_coherence: z
+        .object({
+        region: z.enum(["confirmed", "contradicted", "unstated", "unverifiable"]),
+        country: z.enum(["confirmed", "contradicted", "unstated", "unverifiable"]),
+    })
+        .optional(),
+    // #1755: spans the flat `components` map could not represent. `components` holds one value per tag, so a second
+    // `locality` span ceases to exist there — and without this line `region: null` means both "the input named no
+    // region" and "it named one and we deleted it". Absent when nothing was dropped; never an empty array on the wire,
+    // because the common case is nothing dropped and a client should not have to read a field to learn that.
+    dropped_components: z
+        .array(z.object({
+        tag: ComponentTagSchema,
+        value: z.string(),
+        // The value that held the slot, so a reader sees which of the two survived without re-deriving it.
+        kept: z.string(),
+    }))
+        .optional(),
+});
+/**
+ * `POST /v1/geocode` response — a hand-modeled mirror of `GeocodeResult`'s wire shape (`mailwoman/geocode-core.ts`),
+ * `.loose()` so a field the engine adds that this schema doesn't yet know about still rides through undocumented rather
+ * than being stripped or rejected. DOC-ACCURACY ONLY: the route passes `engine.geocode()`'s outcome through verbatim
+ * (`GeocodeOutcome = Record<string, unknown>`, `api/engine.ts`) — nothing here validates a real response, so a
+ * schema/engine mismatch can never reject or mutate a result at runtime. Deliberately carries NO import from
+ * `mailwoman` (the engine-agnosticism boundary — `mailwoman` is the one workspace allowed to depend on
+ * `@mailwoman/api`, never the reverse). `mailwoman/test/api-schema-drift.test.ts` is the compile-time tripwire that
+ * catches this shape drifting from the real `GeocodeResult` interface.
+ */
+export const GeocodeOutcomeSchema = GeocodeOutcomeLikeSchema.loose().openapi("GeocodeOutcome");
 /**
  * `POST /v1/batch` request body.
  */

package/out/schema.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"schema.js","sourceRoot":"","sources":["../schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAA;AAErC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnD;;GAEG;AACH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;AAEvF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAA;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KACjC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,UAAU,EAAE,eAAe,CAAC,QAAQ,EAAE;CACtC,CAAC;KACD,OAAO,CAAC,cAAc,CAAC,CAAA;AAEzB;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAE9G;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KACjC,MAAM,CAAC;IACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;IACpD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC;KACD,OAAO,CAAC,cAAc,CAAC,CAAA;AAEzB;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KACnC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC3C,UAAU,EAAE,eAAe,CAAC,QAAQ,EAAE;CACtC,CAAC;KACD,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAE3B;;;;GAIG;AACH,MAAM,2BAA2B,GAAG,CAAC;KACnC,MAAM,CAAC;IACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;~~CAC9B~~,CAAC;KACD,OAAO,CAAC,uBAAuB,CAAC,CAAA;AAElC;;;GAGG;AACH,MAAM,sBAAsB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAE7B~~;;;;;;;;;GASG~~;AACH,MAAM,CAAC,~~MAAM~~,oBAAoB,GAAG,CAAC;~~KACnC~~,MAAM,CAAC;IACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;~~IAC7E~~,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,qGAAqG;IACrG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,qFAAqF;IACrF,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,6EAA6E;IAC7E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;IAC3C,0GAA0G;IAC1G,yGAAyG;IACzG,6DAA6D;IAC7D,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;~~CAC7C~~,CAAC;~~KACD~~,KAAK,EAAE;~~KACP~~,OAAO,CAAC,gBAAgB,CAAC,CAAA;~~AAE3B~~;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KACjC,MAAM,CAAC;IACP,yGAAyG;IACzG,4FAA4F;IAC5F,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACtD;;OAEG;IACH,UAAU,EAAE,eAAe,CAAC,QAAQ,EAAE;CACtC,CAAC;KACD,OAAO,CAAC,cAAc,CAAC,CAAA;AAEzB;;GAEG;AACH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAE9E;;GAEG;AACH,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,CAAC,CAAA;AAE3E;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KAClC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;CAChC,CAAC;KACD,OAAO,CAAC,eAAe,CAAC,CAAA;AAE1B;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KACnC,MAAM,CAAC;IACP,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;IACpD,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAClC,CAAC;KACD,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAE3B;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACpC,MAAM,CAAC;IACP,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;CACpD,CAAC;KACD,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAE5B;;;GAGG;AACH,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;AAEvE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KAClC,MAAM,CAAC;IACP,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC;IACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC;KACD,OAAO,CAAC,eAAe,CAAC,CAAA;AAE1B;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KACnC,MAAM,CAAC;IACP,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC;KACD,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAE3B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KACnC,MAAM,CAAC;IACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC;KACD,KAAK,EAAE;KACP,OAAO,CAAC,gBAAgB,CAAC,CAAA"}
1	+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../schema.ts"],"names":[],"mappings":"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"}