@crvouga/mockingbird-service-google-maps 1.0.0 → 1.1.1

package/dist/{chunk-5HEE5U7V.js → chunk-G5DEDMPE.js}

@@ -463,7 +463,7 @@ var faultResponse = (rule) => {
   const body = rule.body === void 0 ? { detail: "Injected by Mockingbird" } : rule.body;
   return new Response(JSON.stringify(body), { status, headers });
 };
-var createFaultRegistry = (rng = createRng(0), sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))) => {
+var createFaultRegistry = (rng = createRng(0), sleep = (ms) => new Promise((resolve2) => setTimeout(resolve2, ms))) => {
   const entries = [];
   return {
     add(rule) {
@@ -1149,6 +1149,16 @@ var operationMetadata = (operation) => {
 
 // ../core/dist/service.js
 import { Hono } from "hono";
+
+// ../core/dist/validation.js
+var recorded = /* @__PURE__ */ new WeakMap();
+var recordedIssues = (request) => recorded.get(request);
+
+// ../core/dist/service.js
+var withIssues = (request, response) => {
+  const issues = response.status >= 400 ? recordedIssues(request) : void 0;
+  return issues && issues.length > 0 ? annotateResponse(response, { issues }) : response;
+};
 var defineOperations = (handlers) => handlers;
 var OperationRegistryError = class extends Error {
   problems;
@@ -1234,9 +1244,7 @@ var createService = (options) => {
         now
       };
       const short = await options.before?.(context);
-      if (short)
-        return short;
-      return handler(context);
+      return withIssues(request, short ?? await handler(context));
     };
     app.on(operation.method.toUpperCase(), honoPath(operation.path), route);
   }
@@ -1273,7 +1281,7 @@ var restoreNamespace = (sqlite, namespace, snapshot) => {
 };
 
 // ../core/dist/version.js
-var PACKAGE_VERSION = true ? "1.0.0" : UNRELEASED_VERSION;
+var PACKAGE_VERSION = true ? "1.1.1" : UNRELEASED_VERSION;
 
 // ../core/dist/signing.js
 var encoder = new TextEncoder();
@@ -1441,7 +1449,7 @@ var createRuntime = (options) => {
   const rng = createRng(options.seed ?? 0);
   const wallNow = options.io?.wallNow ?? Date.now;
   const monotonicNow = options.io?.monotonicNow ?? (() => performance.now());
-  const sleep = options.io?.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  const sleep = options.io?.sleep ?? ((ms) => new Promise((resolve2) => setTimeout(resolve2, ms)));
   const faults = createFaultRegistry(createRng(options.seed ?? 0), sleep);
   const metrics = createMetrics();
   const journal = createJournal(options.journalSize ?? DEFAULT_JOURNAL_SIZE);
@@ -1724,8 +1732,15 @@ var createRuntime = (options) => {
       const started = monotonicNow();
       const url = new URL(request.url);
       const operationId = operationIdFor(request, url.pathname);
+      const contentLength = request.headers.get("content-length");
+      const received = {
+        contentType: request.headers.get("content-type"),
+        bodyBytes: contentLength !== null && /^\d+$/.test(contentLength) ? Number(contentLength) : null,
+        transferEncoding: request.headers.get("transfer-encoding")
+      };
       const log = (status, faultId, response2) => {
         const noted = response2 ? responseNotes(response2) : void 0;
+        const rejected = status >= 400 && faultId === void 0;
         const entry = {
           service: options.name,
           namespace,
@@ -1737,7 +1752,9 @@ var createRuntime = (options) => {
           unmatched: options.document !== void 0 && operationId === void 0,
           ...faultId !== void 0 ? { faultId } : {},
           ...noted?.ids && Object.keys(noted.ids).length > 0 ? { ids: noted.ids } : {},
-          ...noted?.adopted ? { adopted: true } : {}
+          ...noted?.adopted ? { adopted: true } : {},
+          ...rejected ? { request: { ...received } } : {},
+          ...rejected && noted?.issues && noted.issues.length > 0 ? { issues: noted.issues.map((issue) => ({ ...issue })) } : {}
         };
         metrics.record(entry);
         journal.record({ ...entry, at: new Date(clock.now()).toISOString() });
@@ -1945,9 +1962,9 @@ var presetRoutes = (presets, runtime) => ({
 });
 
 // src/generated/openapi.ts
-var document = JSON.parse(`{"openapi":"3.1.0","info":{"title":"Google Places, Geocoding and Maps JavaScript API (Mockingbird subset)","description":"The Google Maps Platform surface our member app calls: Places Autocomplete, Place Details\\nand Find Place From Text (the legacy JSON web services), the Geocoding API, and the Maps\\nJavaScript API loader (\`/maps/api/js?libraries=places\`). Every web-service answer is HTTP 200\\nwith Google's \`status\` field; the mock resolves addresses from a QA corpus.\\n","version":"1","x-mockingbird-upstream":{"note":"Hand-authored from Google's documented response shapes and the fields our consumer reads (address-autocomplete-native-rest.tsx, address-autocomplete-web.tsx, use-geocoded-address.ts). Google publishes no OpenAPI document for these endpoints."}},"servers":[{"url":"https://maps.googleapis.com"}],"paths":{"/maps/api/place/autocomplete/json":{"get":{"operationId":"PlaceAutocomplete","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"$ref":"#/components/parameters/Key"},{"name":"input","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":60,"examples":["1625 N Central","Phoenix","85004","4821 Maple Street Denver","200 N Spring St, Los Angeles","136 Murray"]}},{"name":"types","in":"query","schema":{"type":"string","enum":["address","geocode"]}},{"name":"components","in":"query","schema":{"type":"string","enum":["country:us","country:ca","country:us|country:ca"]}},{"$ref":"#/components/parameters/SessionToken"}],"responses":{"200":{"description":"Predictions, or a non-OK status (HTTP 200 either way)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutocompleteResponse"}}}},"500":{"description":"Google front-end failure (server_error preset)","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/maps/api/place/details/json":{"get":{"operationId":"PlaceDetails","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"$ref":"#/components/parameters/Key"},{"name":"place_id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"examples":["ChIJ5BKAwJuCB5951g03ZzrkHx9","ChIJE1ellR5XyWiy2lHIlJ5cls3","ChIJaWYsCINV1XBQQ97jO3pznpg","EieyJsIjoiNDgyMSBNYXBsZSBTdHJlZXQiLCJjIjoiRGVudmVyIiwicyI6IkNPIiwieiI6IjgwMjAyIiwibiI6IkRlbnZlciBDb3VudHkiLCJhIjozOS43NDc4OCwibyI6LTEwNC45OTQyNX0","ChIJdoesNotExist000000000"]}},{"name":"fields","in":"query","schema":{"type":"string","enum":["address_component","address_components","geometry","formatted_address,geometry","place_id,name,types","address_component,geometry,formatted_address"]}},{"$ref":"#/components/parameters/SessionToken"}],"responses":{"200":{"description":"The place, or a non-OK status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetailsResponse"}}}},"500":{"description":"Google front-end failure (server_error preset)","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/maps/api/geocode/json":{"get":{"operationId":"Geocode","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"$ref":"#/components/parameters/Key"},{"name":"address","in":"query","schema":{"type":"string","minLength":1,"maxLength":80,"examples":["1625 N Central Ave, Phoenix, AZ 85004","88 Greenwich St, New York, NY 10006","4821 Maple Street, Denver, CO 80202","85004","Phoenix, AZ","1625 N Central Ave"]}},{"name":"place_id","in":"query","schema":{"type":"string","examples":["ChIJ5BKAwJuCB5951g03ZzrkHx9"]}},{"name":"components","in":"query","schema":{"type":"string","enum":["postal_code:85004","postal_code:10006","postal_code:00000"]}}],"responses":{"200":{"description":"Geocoding results, or a non-OK status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeocodeResponse"}}}},"500":{"description":"Google front-end failure (server_error preset)","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/maps/api/place/findplacefromtext/json":{"get":{"operationId":"FindPlaceFromText","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"$ref":"#/components/parameters/Key"},{"name":"input","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":80,"examples":["1625 N Central Ave, Phoenix, AZ 85004","1625 N Central","Gilbert"]}},{"name":"inputtype","in":"query","required":true,"schema":{"type":"string","enum":["textquery","phonenumber"]}},{"name":"fields","in":"query","schema":{"type":"string","enum":["geometry","formatted_address,geometry","place_id,name","place_id"]}}],"responses":{"200":{"description":"Candidates, or a non-OK status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindPlaceResponse"}}}},"500":{"description":"Google front-end failure (server_error preset)","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/maps/api/js":{"get":{"operationId":"MapsJavaScriptApi","description":"The Maps JavaScript API loader. The mock serves a shim defining google.maps.places (AutocompleteService, PlacesService, AutocompleteSessionToken, PlacesServiceStatus) and google.maps.Geocoder, backed by the REST operations above.","x-mockingbird":{"supported":true,"parity":{"enabled":false,"reason":"A JavaScript program, not data: it is exercised by evaluating it in a fake window and driving our web client through it (google-maps.acceptance.test.ts)."}},"parameters":[{"name":"key","in":"query","schema":{"type":"string"}},{"name":"libraries","in":"query","schema":{"type":"string"}},{"name":"callback","in":"query","schema":{"type":"string"}},{"name":"v","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"The Maps JavaScript shim","content":{"text/javascript":{"schema":{"type":"string"}}}},"503":{"description":"Script unavailable (script_unavailable preset)","content":{"text/plain":{"schema":{"type":"string"}}}}}}}},"components":{"parameters":{"Key":{"name":"key","in":"query","required":true,"description":"The Google Maps Platform API key (\`PLACES_KEY\`); also the namespace credential.","schema":{"type":"string","minLength":1,"maxLength":40,"examples":["parity-key"]}},"SessionToken":{"name":"sessiontoken","in":"query","description":"Autocomplete session token (billing grouping); accepted and journaled as metadata.","schema":{"type":"string","format":"uuid"}}},"schemas":{"Status":{"type":"string","enum":["OK","ZERO_RESULTS","INVALID_REQUEST","OVER_QUERY_LIMIT","REQUEST_DENIED","UNKNOWN_ERROR","NOT_FOUND"]},"LatLng":{"type":"object","required":["lat","lng"],"properties":{"lat":{"type":"number"},"lng":{"type":"number"}}},"Viewport":{"type":"object","required":["northeast","southwest"],"properties":{"northeast":{"$ref":"#/components/schemas/LatLng"},"southwest":{"$ref":"#/components/schemas/LatLng"}}},"Geometry":{"type":"object","required":["location","viewport"],"properties":{"location":{"$ref":"#/components/schemas/LatLng"},"location_type":{"type":"string","enum":["ROOFTOP","RANGE_INTERPOLATED","GEOMETRIC_CENTER","APPROXIMATE"]},"viewport":{"$ref":"#/components/schemas/Viewport"}}},"AddressComponent":{"type":"object","required":["long_name","short_name","types"],"properties":{"long_name":{"type":"string"},"short_name":{"type":"string"},"types":{"type":"array","items":{"type":"string"}}}},"MatchedSubstring":{"type":"object","required":["length","offset"],"properties":{"length":{"type":"integer"},"offset":{"type":"integer"}}},"Prediction":{"type":"object","required":["description","place_id","reference","structured_formatting","terms","types","matched_substrings"],"properties":{"description":{"type":"string"},"matched_substrings":{"type":"array","items":{"$ref":"#/components/schemas/MatchedSubstring"}},"place_id":{"type":"string","x-mockingbird-resource":{"type":"place","identity":true}},"reference":{"type":"string"},"structured_formatting":{"type":"object","required":["main_text","secondary_text"],"properties":{"main_text":{"type":"string"},"main_text_matched_substrings":{"type":"array","items":{"$ref":"#/components/schemas/MatchedSubstring"}},"secondary_text":{"type":"string"}}},"terms":{"type":"array","items":{"type":"object","required":["offset","value"],"properties":{"offset":{"type":"integer"},"value":{"type":"string"}}}},"types":{"type":"array","items":{"type":"string"}}}},"PlaceResult":{"type":"object","description":"Only the fields requested with \`fields=\` are present.","properties":{"address_components":{"type":"array","items":{"$ref":"#/components/schemas/AddressComponent"}},"adr_address":{"type":"string"},"formatted_address":{"type":"string"},"geometry":{"$ref":"#/components/schemas/Geometry"},"name":{"type":"string"},"place_id":{"type":"string"},"reference":{"type":"string"},"types":{"type":"array","items":{"type":"string"}},"url":{"type":"string"},"utc_offset":{"type":"integer"},"vicinity":{"type":"string"}}},"AutocompleteResponse":{"type":"object","required":["predictions","status"],"properties":{"predictions":{"type":"array","items":{"$ref":"#/components/schemas/Prediction"}},"status":{"$ref":"#/components/schemas/Status"},"error_message":{"type":"string"}}},"DetailsResponse":{"type":"object","required":["html_attributions","status"],"properties":{"html_attributions":{"type":"array","items":{"type":"string"}},"result":{"$ref":"#/components/schemas/PlaceResult"},"status":{"$ref":"#/components/schemas/Status"},"error_message":{"type":"string"}}},"GeocodeResult":{"type":"object","required":["address_components","formatted_address","geometry","place_id","types"],"properties":{"address_components":{"type":"array","items":{"$ref":"#/components/schemas/AddressComponent"}},"formatted_address":{"type":"string"},"geometry":{"$ref":"#/components/schemas/Geometry"},"place_id":{"type":"string"},"types":{"type":"array","items":{"type":"string"}}}},"GeocodeResponse":{"type":"object","required":["results","status"],"properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/GeocodeResult"}},"status":{"$ref":"#/components/schemas/Status"},"error_message":{"type":"string"}}},"FindPlaceResponse":{"type":"object","required":["candidates","status"],"properties":{"candidates":{"type":"array","items":{"$ref":"#/components/schemas/PlaceResult"}},"status":{"$ref":"#/components/schemas/Status"},"error_message":{"type":"string"}}}}}}`);
-var operationIds = ["PlaceAutocomplete", "PlaceDetails", "Geocode", "FindPlaceFromText", "MapsJavaScriptApi"];
-var supportedOperationIds = ["PlaceAutocomplete", "PlaceDetails", "Geocode", "FindPlaceFromText", "MapsJavaScriptApi"];
+var document = JSON.parse(`{"openapi":"3.1.0","info":{"title":"Google Places, Geocoding and Maps JavaScript API (Mockingbird subset)","description":"The Google Maps Platform surface our member app calls: Places Autocomplete, Place Details\\nand Find Place From Text (the legacy JSON web services), the Geocoding API, and the Maps\\nJavaScript API loader (\`/maps/api/js?libraries=places\`). Every web-service answer is HTTP 200\\nwith Google's \`status\` field; the mock resolves addresses from a QA corpus.\\n","version":"1","x-mockingbird-upstream":{"note":"Hand-authored from Google's documented response shapes and the fields our consumer reads (address-autocomplete-native-rest.tsx, address-autocomplete-web.tsx, use-geocoded-address.ts). Google publishes no OpenAPI document for these endpoints."}},"servers":[{"url":"https://maps.googleapis.com"}],"paths":{"/maps/api/place/autocomplete/json":{"get":{"operationId":"PlaceAutocomplete","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"$ref":"#/components/parameters/Key"},{"name":"input","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":60,"examples":["1625 N Central","Phoenix","85004","4821 Maple Street Denver","200 N Spring St, Los Angeles","136 Murray"]}},{"name":"types","in":"query","schema":{"type":"string","enum":["address","geocode"]}},{"name":"components","in":"query","schema":{"type":"string","enum":["country:us","country:ca","country:us|country:ca"]}},{"$ref":"#/components/parameters/SessionToken"}],"responses":{"200":{"description":"Predictions, or a non-OK status (HTTP 200 either way)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutocompleteResponse"}}}},"500":{"description":"Google front-end failure (server_error preset)","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/maps/api/place/details/json":{"get":{"operationId":"PlaceDetails","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"$ref":"#/components/parameters/Key"},{"name":"place_id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"examples":["ChIJ5BKAwJuCB5951g03ZzrkHx9","ChIJE1ellR5XyWiy2lHIlJ5cls3","ChIJaWYsCINV1XBQQ97jO3pznpg","EieyJsIjoiNDgyMSBNYXBsZSBTdHJlZXQiLCJjIjoiRGVudmVyIiwicyI6IkNPIiwieiI6IjgwMjAyIiwibiI6IkRlbnZlciBDb3VudHkiLCJhIjozOS43NDc4OCwibyI6LTEwNC45OTQyNX0","ChIJdoesNotExist000000000"]}},{"name":"fields","in":"query","schema":{"type":"string","enum":["address_component","address_components","geometry","formatted_address,geometry","place_id,name,types","address_component,geometry,formatted_address"]}},{"$ref":"#/components/parameters/SessionToken"}],"responses":{"200":{"description":"The place, or a non-OK status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetailsResponse"}}}},"500":{"description":"Google front-end failure (server_error preset)","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/maps/api/geocode/json":{"get":{"operationId":"Geocode","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"$ref":"#/components/parameters/Key"},{"name":"address","in":"query","schema":{"type":"string","minLength":1,"maxLength":80,"examples":["1625 N Central Ave, Phoenix, AZ 85004","88 Greenwich St, New York, NY 10006","4821 Maple Street, Denver, CO 80202","85004","Phoenix, AZ","1625 N Central Ave"]}},{"name":"place_id","in":"query","schema":{"type":"string","examples":["ChIJ5BKAwJuCB5951g03ZzrkHx9"]}},{"name":"components","in":"query","schema":{"type":"string","enum":["postal_code:85004","postal_code:10006","postal_code:00000"]}}],"responses":{"200":{"description":"Geocoding results, or a non-OK status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeocodeResponse"}}}},"500":{"description":"Google front-end failure (server_error preset)","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/maps/api/place/findplacefromtext/json":{"get":{"operationId":"FindPlaceFromText","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"$ref":"#/components/parameters/Key"},{"name":"input","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":80,"examples":["1625 N Central Ave, Phoenix, AZ 85004","1625 N Central","Gilbert"]}},{"name":"inputtype","in":"query","required":true,"schema":{"type":"string","enum":["textquery","phonenumber"]}},{"name":"fields","in":"query","schema":{"type":"string","enum":["geometry","formatted_address,geometry","place_id,name","place_id"]}}],"responses":{"200":{"description":"Candidates, or a non-OK status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindPlaceResponse"}}}},"500":{"description":"Google front-end failure (server_error preset)","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/maps/api/js":{"get":{"operationId":"MapsJavaScriptApi","description":"The Maps JavaScript API loader. The mock serves a shim defining google.maps.places (AutocompleteService, PlacesService, AutocompleteSessionToken, PlacesServiceStatus) and google.maps.Geocoder, backed by the REST operations above.","x-mockingbird":{"supported":true,"parity":{"enabled":false,"reason":"A JavaScript program, not data: it is exercised by evaluating it in a fake window and driving our web client through it (google-maps.acceptance.test.ts)."}},"parameters":[{"name":"key","in":"query","schema":{"type":"string"}},{"name":"libraries","in":"query","schema":{"type":"string"}},{"name":"callback","in":"query","schema":{"type":"string"}},{"name":"v","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"The Maps JavaScript shim","content":{"text/javascript":{"schema":{"type":"string"}}}},"503":{"description":"Script unavailable (script_unavailable preset)","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1:validateAddress":{"servers":[{"url":"https://addressvalidation.googleapis.com"}],"post":{"operationId":"ValidateAddress","description":"Address Validation API v1 validateAddress, with USPS CASS data (\`enableUspsCass\`). A Google Cloud API: errors are HTTP 4xx/5xx with a \`google.rpc.Status\` envelope, and the key may also be sent as the \`X-Goog-Api-Key\` header. Responses are proto3 JSON (false booleans and empty lists omitted). Reference: https://developers.google.com/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"$ref":"#/components/parameters/Key"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateAddressRequest"}}}},"responses":{"200":{"description":"The validation result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateAddressResponse"}}}},"400":{"description":"INVALID_ARGUMENT (malformed request, unsupported region, invalid API key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleApiError"}}}},"403":{"description":"PERMISSION_DENIED (missing key; address_validation_denied preset)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleApiError"}}}},"503":{"description":"UNAVAILABLE (address_validation_unavailable preset)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleApiError"}}}}}}}},"components":{"parameters":{"Key":{"name":"key","in":"query","required":true,"description":"The Google Maps Platform API key (\`PLACES_KEY\`); also the namespace credential.","schema":{"type":"string","minLength":1,"maxLength":40,"examples":["parity-key"]}},"SessionToken":{"name":"sessiontoken","in":"query","description":"Autocomplete session token (billing grouping); accepted and journaled as metadata.","schema":{"type":"string","format":"uuid"}}},"schemas":{"Status":{"type":"string","enum":["OK","ZERO_RESULTS","INVALID_REQUEST","OVER_QUERY_LIMIT","REQUEST_DENIED","UNKNOWN_ERROR","NOT_FOUND"]},"LatLng":{"type":"object","required":["lat","lng"],"properties":{"lat":{"type":"number"},"lng":{"type":"number"}}},"Viewport":{"type":"object","required":["northeast","southwest"],"properties":{"northeast":{"$ref":"#/components/schemas/LatLng"},"southwest":{"$ref":"#/components/schemas/LatLng"}}},"Geometry":{"type":"object","required":["location","viewport"],"properties":{"location":{"$ref":"#/components/schemas/LatLng"},"location_type":{"type":"string","enum":["ROOFTOP","RANGE_INTERPOLATED","GEOMETRIC_CENTER","APPROXIMATE"]},"viewport":{"$ref":"#/components/schemas/Viewport"}}},"AddressComponent":{"type":"object","required":["long_name","short_name","types"],"properties":{"long_name":{"type":"string"},"short_name":{"type":"string"},"types":{"type":"array","items":{"type":"string"}}}},"MatchedSubstring":{"type":"object","required":["length","offset"],"properties":{"length":{"type":"integer"},"offset":{"type":"integer"}}},"Prediction":{"type":"object","required":["description","place_id","reference","structured_formatting","terms","types","matched_substrings"],"properties":{"description":{"type":"string"},"matched_substrings":{"type":"array","items":{"$ref":"#/components/schemas/MatchedSubstring"}},"place_id":{"type":"string","x-mockingbird-resource":{"type":"place","identity":true}},"reference":{"type":"string"},"structured_formatting":{"type":"object","required":["main_text","secondary_text"],"properties":{"main_text":{"type":"string"},"main_text_matched_substrings":{"type":"array","items":{"$ref":"#/components/schemas/MatchedSubstring"}},"secondary_text":{"type":"string"}}},"terms":{"type":"array","items":{"type":"object","required":["offset","value"],"properties":{"offset":{"type":"integer"},"value":{"type":"string"}}}},"types":{"type":"array","items":{"type":"string"}}}},"PlaceResult":{"type":"object","description":"Only the fields requested with \`fields=\` are present.","properties":{"address_components":{"type":"array","items":{"$ref":"#/components/schemas/AddressComponent"}},"adr_address":{"type":"string"},"formatted_address":{"type":"string"},"geometry":{"$ref":"#/components/schemas/Geometry"},"name":{"type":"string"},"place_id":{"type":"string"},"reference":{"type":"string"},"types":{"type":"array","items":{"type":"string"}},"url":{"type":"string"},"utc_offset":{"type":"integer"},"vicinity":{"type":"string"}}},"AutocompleteResponse":{"type":"object","required":["predictions","status"],"properties":{"predictions":{"type":"array","items":{"$ref":"#/components/schemas/Prediction"}},"status":{"$ref":"#/components/schemas/Status"},"error_message":{"type":"string"}}},"DetailsResponse":{"type":"object","required":["html_attributions","status"],"properties":{"html_attributions":{"type":"array","items":{"type":"string"}},"result":{"$ref":"#/components/schemas/PlaceResult"},"status":{"$ref":"#/components/schemas/Status"},"error_message":{"type":"string"}}},"GeocodeResult":{"type":"object","required":["address_components","formatted_address","geometry","place_id","types"],"properties":{"address_components":{"type":"array","items":{"$ref":"#/components/schemas/AddressComponent"}},"formatted_address":{"type":"string"},"geometry":{"$ref":"#/components/schemas/Geometry"},"place_id":{"type":"string"},"types":{"type":"array","items":{"type":"string"}}}},"GeocodeResponse":{"type":"object","required":["results","status"],"properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/GeocodeResult"}},"status":{"$ref":"#/components/schemas/Status"},"error_message":{"type":"string"}}},"FindPlaceResponse":{"type":"object","required":["candidates","status"],"properties":{"candidates":{"type":"array","items":{"$ref":"#/components/schemas/PlaceResult"}},"status":{"$ref":"#/components/schemas/Status"},"error_message":{"type":"string"}}},"GoogleApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","status"],"properties":{"code":{"type":"integer"},"message":{"type":"string"},"status":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}}}}},"PostalAddress":{"type":"object","description":"google.type.PostalAddress","properties":{"revision":{"type":"integer"},"regionCode":{"type":"string","examples":["US"]},"languageCode":{"type":"string"},"postalCode":{"type":"string","examples":["85004","10006","80202","90012","00000"]},"sortingCode":{"type":"string"},"administrativeArea":{"type":"string","examples":["AZ","NY","CO","CA"]},"locality":{"type":"string","examples":["Phoenix","New York","Denver","Los Angeles","Springfield"]},"sublocality":{"type":"string"},"addressLines":{"type":"array","maxItems":3,"items":{"type":"string","maxLength":80,"examples":["1625 N Central Ave","1625 North Central Avenue Building A","4821 Maple Street","N Central Ave","Apt 2"]}},"recipients":{"type":"array","items":{"type":"string"}},"organization":{"type":"string"}}},"ValidateAddressRequest":{"type":"object","required":["address"],"additionalProperties":false,"properties":{"address":{"$ref":"#/components/schemas/PostalAddress","examples":[{"regionCode":"US","addressLines":["1625 N Central Ave"],"locality":"Phoenix","administrativeArea":"AZ","postalCode":"85004"},{"regionCode":"US","addressLines":["4821 Maple Street"],"locality":"Denver","administrativeArea":"CO","postalCode":"80202"},{"regionCode":"US","addressLines":["N Central Ave"],"locality":"Phoenix","administrativeArea":"AZ","postalCode":"85004"},{"regionCode":"US","addressLines":["1625 N Central Ave, Phoenix, AZ 85004"]},{"regionCode":"US","addressLines":["12 Nowhere Rd"],"locality":"Springfield","administrativeArea":"ZZ","postalCode":"00000"}]},"previousResponseId":{"type":"string"},"enableUspsCass":{"type":"boolean"},"languageOptions":{"type":"object"},"sessionToken":{"type":"string"}}},"ValidationAddressComponent":{"type":"object","required":["componentName","componentType","confirmationLevel"],"properties":{"componentName":{"type":"object","required":["text"],"properties":{"text":{"type":"string"},"languageCode":{"type":"string"}}},"componentType":{"type":"string"},"confirmationLevel":{"type":"string","enum":["CONFIRMED","UNCONFIRMED_BUT_PLAUSIBLE","UNCONFIRMED_AND_SUSPICIOUS"]},"inferred":{"type":"boolean"},"spellCorrected":{"type":"boolean"},"replaced":{"type":"boolean"},"unexpected":{"type":"boolean"}}},"Granularity":{"type":"string","enum":["GRANULARITY_UNSPECIFIED","SUB_PREMISE","PREMISE","PREMISE_PROXIMITY","BLOCK","ROUTE","OTHER"]},"ValidationResult":{"type":"object","properties":{"verdict":{"type":"object","properties":{"inputGranularity":{"$ref":"#/components/schemas/Granularity"},"validationGranularity":{"$ref":"#/components/schemas/Granularity"},"geocodeGranularity":{"$ref":"#/components/schemas/Granularity"},"addressComplete":{"type":"boolean"},"hasUnconfirmedComponents":{"type":"boolean"},"hasInferredComponents":{"type":"boolean"},"hasReplacedComponents":{"type":"boolean"},"hasSpellCorrectedComponents":{"type":"boolean"},"possibleNextAction":{"type":"string","enum":["POSSIBLE_NEXT_ACTION_UNSPECIFIED","FIX","CONFIRM_ADD_SUBPREMISES","CONFIRM","ACCEPT"]}}},"address":{"type":"object","properties":{"formattedAddress":{"type":"string"},"postalAddress":{"$ref":"#/components/schemas/PostalAddress"},"addressComponents":{"type":"array","items":{"$ref":"#/components/schemas/ValidationAddressComponent"}},"missingComponentTypes":{"type":"array","items":{"type":"string"}},"unconfirmedComponentTypes":{"type":"array","items":{"type":"string"}},"unresolvedTokens":{"type":"array","items":{"type":"string"}}}},"geocode":{"type":"object","properties":{"location":{"type":"object","properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}}},"placeId":{"type":"string"},"placeTypes":{"type":"array","items":{"type":"string"}}}},"uspsData":{"type":"object","properties":{"standardizedAddress":{"type":"object","properties":{"firstAddressLine":{"type":"string"},"secondAddressLine":{"type":"string"},"cityStateZipAddressLine":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"zipCode":{"type":"string"},"zipCodeExtension":{"type":"string"}}},"dpvConfirmation":{"type":"string","enum":["Y","N","S","D"]},"dpvFootnote":{"type":"string"},"postOfficeCity":{"type":"string"},"postOfficeState":{"type":"string"},"errorMessage":{"type":"string"},"cassProcessed":{"type":"boolean"}}}}},"ValidateAddressResponse":{"type":"object","required":["result","responseId"],"properties":{"result":{"$ref":"#/components/schemas/ValidationResult"},"responseId":{"type":"string"}}}}}}`);
+var operationIds = ["PlaceAutocomplete", "PlaceDetails", "Geocode", "FindPlaceFromText", "MapsJavaScriptApi", "ValidateAddress"];
+var supportedOperationIds = ["PlaceAutocomplete", "PlaceDetails", "Geocode", "FindPlaceFromText", "MapsJavaScriptApi", "ValidateAddress"];
 
 // src/corpus.ts
 var row = (id, line1, city, state, zip, county, lat, lng) => ({ id, line1, city, state, zip, county, lat, lng });
@@ -3010,6 +3027,541 @@ var GoogleMapsState = class {
   }
 };
 
+// src/validation.ts
+var GRANULARITIES = [
+  "SUB_PREMISE",
+  "PREMISE",
+  "PREMISE_PROXIMITY",
+  "BLOCK",
+  "ROUTE",
+  "OTHER"
+];
+var NEXT_ACTIONS = [
+  "FIX",
+  "CONFIRM_ADD_SUBPREMISES",
+  "CONFIRM",
+  "ACCEPT"
+];
+var DPV_CODES = ["Y", "N", "S", "D"];
+var ValidationRequestError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ValidationRequestError";
+  }
+};
+var TOP_LEVEL = /* @__PURE__ */ new Set([
+  "address",
+  "previousResponseId",
+  "enableUspsCass",
+  "languageOptions",
+  "sessionToken"
+]);
+var POSTAL_ADDRESS = /* @__PURE__ */ new Set([
+  "revision",
+  "regionCode",
+  "languageCode",
+  "postalCode",
+  "sortingCode",
+  "administrativeArea",
+  "locality",
+  "sublocality",
+  "addressLines",
+  "recipients",
+  "organization"
+]);
+var MAX_INPUT_LENGTH = 280;
+var MAX_ADDRESS_LINES = 3;
+var MAX_ADDRESS_LINE_LENGTH = 80;
+var isRecord4 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var optionalString = (value, field) => {
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value !== "string") {
+    throw new ValidationRequestError(
+      `Invalid value at '${field}' (TYPE_STRING), ${JSON.stringify(value)}`
+    );
+  }
+  const trimmed = value.trim();
+  return trimmed ? trimmed : void 0;
+};
+var parseValidateRequest = (body) => {
+  if (!isRecord4(body)) throw new ValidationRequestError("Invalid JSON payload received.");
+  for (const key of Object.keys(body)) {
+    if (!TOP_LEVEL.has(key)) {
+      throw new ValidationRequestError(
+        `Invalid JSON payload received. Unknown name "${key}": Cannot find field.`
+      );
+    }
+  }
+  const address = body.address;
+  if (address === void 0 || address === null) {
+    throw new ValidationRequestError("Address is missing from the request.");
+  }
+  if (!isRecord4(address)) {
+    throw new ValidationRequestError(
+      `Invalid value at 'address' (type.googleapis.com/google.type.PostalAddress), ${JSON.stringify(address)}`
+    );
+  }
+  for (const key of Object.keys(address)) {
+    if (!POSTAL_ADDRESS.has(key)) {
+      throw new ValidationRequestError(
+        `Invalid JSON payload received. Unknown name "${key}" at 'address': Cannot find field.`
+      );
+    }
+  }
+  const rawLines = address.addressLines ?? [];
+  if (!Array.isArray(rawLines) || rawLines.some((line) => typeof line !== "string")) {
+    throw new ValidationRequestError(
+      `Invalid value at 'address.address_lines' (TYPE_STRING), ${JSON.stringify(rawLines)}`
+    );
+  }
+  if (rawLines.length > MAX_ADDRESS_LINES) {
+    throw new ValidationRequestError(
+      `Invalid value at 'address.address_lines' (repeated STRING), a maximum of ${MAX_ADDRESS_LINES} address lines is allowed.`
+    );
+  }
+  const overLong = rawLines.findIndex((line) => line.length > MAX_ADDRESS_LINE_LENGTH);
+  if (overLong !== -1) {
+    throw new ValidationRequestError(
+      `Invalid value at 'address.address_lines[${overLong}]' (STRING), the maximum length is ${MAX_ADDRESS_LINE_LENGTH} characters.`
+    );
+  }
+  const addressLines = rawLines.map((line) => line.trim()).filter(Boolean);
+  if (addressLines.length === 0) {
+    throw new ValidationRequestError("Address lines are missing from the request.");
+  }
+  const enable = body.enableUspsCass;
+  if (enable !== void 0 && enable !== null && typeof enable !== "boolean") {
+    throw new ValidationRequestError(
+      `Invalid value at 'enable_usps_cass' (TYPE_BOOL), ${JSON.stringify(enable)}`
+    );
+  }
+  const input = {
+    regionCode: optionalString(address.regionCode, "address.region_code")?.toUpperCase(),
+    addressLines,
+    locality: optionalString(address.locality, "address.locality"),
+    administrativeArea: optionalString(address.administrativeArea, "address.administrative_area"),
+    postalCode: optionalString(address.postalCode, "address.postal_code")
+  };
+  const length = [
+    ...input.addressLines,
+    input.locality ?? "",
+    input.administrativeArea ?? "",
+    input.postalCode ?? ""
+  ].join("").length;
+  if (length > MAX_INPUT_LENGTH) {
+    throw new ValidationRequestError(
+      `The total length of the address fields must not exceed ${MAX_INPUT_LENGTH} characters.`
+    );
+  }
+  const region = input.regionCode ?? "US";
+  if (enable === true && region !== "US" && region !== "PR") {
+    throw new ValidationRequestError(
+      "USPS CASS validation is only supported for addresses in the US and PR regions."
+    );
+  }
+  return { address: input, enableUspsCass: enable === true };
+};
+var ABBREVIATIONS = {
+  north: "N",
+  south: "S",
+  east: "E",
+  west: "W",
+  northeast: "NE",
+  northwest: "NW",
+  southeast: "SE",
+  southwest: "SW",
+  avenue: "Ave",
+  av: "Ave",
+  street: "St",
+  str: "St",
+  road: "Rd",
+  drive: "Dr",
+  boulevard: "Blvd",
+  lane: "Ln",
+  parkway: "Pkwy",
+  place: "Pl",
+  court: "Ct",
+  circle: "Cir",
+  highway: "Hwy",
+  terrace: "Ter",
+  square: "Sq",
+  plaza: "Plz",
+  trail: "Trl",
+  way: "Way",
+  mall: "Mall"
+};
+var DIRECTIONALS = /* @__PURE__ */ new Set(["n", "s", "e", "w", "ne", "nw", "se", "sw"]);
+var DESIGNATORS = {
+  apt: "Apt",
+  apartment: "Apt",
+  unit: "Unit",
+  ste: "Ste",
+  suite: "Ste",
+  bldg: "Bldg",
+  building: "Bldg",
+  fl: "Fl",
+  floor: "Fl",
+  rm: "Rm",
+  room: "Rm",
+  spc: "Spc",
+  space: "Spc",
+  lot: "Lot",
+  trlr: "Trlr",
+  "#": "#"
+};
+var UNIT_AT_END = /[\s,]+(#|apt|apartment|unit|ste|suite|bldg|building|fl|floor|rm|room|spc|space|lot|trlr)\.?\s*#?\s*([A-Za-z0-9-]+)$/i;
+var UNIT_ONLY = /^(#|apt|apartment|unit|ste|suite|bldg|building|fl|floor|rm|room|spc|space|lot|trlr)?\.?\s*#?\s*([A-Za-z0-9-]+)$/i;
+var STREET_NUMBER2 = /^([A-Za-z]?\d+[A-Za-z]?(?:-\d+)?)\s+(.+)$/;
+var unitText = (unit) => unit.designator === "#" ? `#${unit.value}` : `${unit.designator} ${unit.value}`;
+var parseUnit = (designator, value) => ({
+  designator: DESIGNATORS[(designator ?? "#").toLowerCase()] ?? "#",
+  value: value.toUpperCase()
+});
+var splitUnit = (line) => {
+  const match = UNIT_AT_END.exec(line);
+  if (!match || match.index === 0) return { street: line.trim(), unit: void 0 };
+  return {
+    street: line.slice(0, match.index).trim(),
+    unit: parseUnit(match[1], match[2])
+  };
+};
+var streetKey = (street) => normalize(street).split(" ").map((word) => (ABBREVIATIONS[word] ?? word).toLowerCase()).join(" ");
+var standardizeStreet = (street) => street.replace(/[.,]/g, " ").split(/\s+/).filter(Boolean).map((word) => {
+  const lower = word.toLowerCase();
+  if (DIRECTIONALS.has(lower)) return lower.toUpperCase();
+  return ABBREVIATIONS[lower] ?? word;
+}).join(" ");
+var stateCode = (value) => {
+  if (!value) return void 0;
+  const upper = value.trim().toUpperCase();
+  if (STATE_NAMES[upper]) return upper;
+  const byName = Object.entries(STATE_NAMES).find(([, name]) => name.toUpperCase() === upper);
+  return byName?.[0] ?? upper;
+};
+var cityRows = (rows, city, state) => rows.filter(
+  (row2) => normalize(row2.city) === normalize(city) && (state === void 0 || row2.state === state)
+);
+var resolve = (input, rows) => {
+  const [first = "", ...rest] = input.addressLines;
+  let streetLine = first;
+  let unit;
+  let locality = input.locality;
+  let state = stateCode(input.administrativeArea);
+  let zip = input.postalCode?.slice(0, 5);
+  let candidates = [];
+  if (locality || zip) {
+    const second = rest.join(" ").trim();
+    if (second) {
+      const only = UNIT_ONLY.exec(second);
+      if (only) unit = parseUnit(only[1], only[2]);
+    }
+  } else {
+    const joined = input.addressLines.join(", ");
+    const parsed = parseStreetInCity(joined, rows);
+    if (parsed) {
+      streetLine = parsed.line1;
+      locality = parsed.row.city;
+      state = parsed.row.state;
+      const zipMatch = /\b(\d{5})(?:-\d{4})?\s*(?:,?\s*(?:USA|US|United States))?$/i.exec(joined);
+      zip = zipMatch?.[1];
+    }
+  }
+  const split = splitUnit(streetLine);
+  const street = split.street;
+  unit = unit ?? split.unit;
+  const numbered = STREET_NUMBER2.exec(street);
+  if (locality) candidates = cityRows(rows, locality, state);
+  let localityStatus = "confirmed";
+  let stateStatus = "confirmed";
+  if (candidates.length === 0 && zip) {
+    candidates = rows.filter((row2) => row2.zip === zip);
+    if (candidates.length > 0) {
+      localityStatus = "replaced";
+      if (state !== void 0 && candidates[0]?.state !== state) stateStatus = "replaced";
+    }
+  }
+  if (candidates.length === 0 || !numbered) {
+    return { unresolved: { street, unit, hasNumber: !!numbered } };
+  }
+  const number = numbered[1];
+  const key = streetKey(street);
+  const exact = candidates.find((row2) => streetKey(row2.line1) === key);
+  const base = exact ?? candidates.find((row2) => zip !== void 0 && row2.zip === zip) ?? candidates[0];
+  const outStreet = exact ? exact.line1 : standardizeStreet(street);
+  const routeMatch = STREET_NUMBER2.exec(outStreet);
+  return {
+    resolved: {
+      row: base,
+      street: outStreet,
+      number,
+      route: routeMatch ? routeMatch[2] : outStreet,
+      unit,
+      inCorpus: !!exact,
+      postal: zip === void 0 ? "inferred" : zip === base.zip ? "confirmed" : "replaced",
+      locality: localityStatus,
+      state: stateStatus
+    }
+  };
+};
+var fnv = (value, seed = 2166136261) => {
+  let hash = seed >>> 0;
+  for (let i = 0; i < value.length; i++) {
+    hash ^= value.charCodeAt(i);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return hash;
+};
+var zipPlus4 = (row2, street) => String(fnv(`${row2.id}|${streetKey(street)}`) % 9999 + 1).padStart(4, "0");
+var responseId = (seed) => {
+  const hex = [2166136261, 16777619, 2654435769, 2135587861].map((s) => fnv(seed, s).toString(16).padStart(8, "0")).join("");
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-4${hex.slice(13, 16)}-a${hex.slice(17, 20)}-${hex.slice(20, 32)}`;
+};
+var component = (text2, componentType, confirmationLevel, flags = {}) => ({
+  componentName: { text: text2, languageCode: "en" },
+  componentType,
+  confirmationLevel,
+  ...flags.inferred ? { inferred: true } : {},
+  ...flags.replaced ? { replaced: true } : {}
+});
+var compact = (value) => Object.fromEntries(
+  Object.entries(value).filter(
+    ([, v]) => v !== void 0 && v !== false && !(Array.isArray(v) && v.length === 0)
+  )
+);
+var uniq = (values) => [...new Set(values)];
+var validateAddress = (request, rows, options = {}) => {
+  const { address: input, enableUspsCass } = request;
+  const region = input.regionCode ?? "US";
+  const usps = region === "US" || region === "PR";
+  const outcome = region === "US" ? resolve(input, rows) : void 0;
+  let granularity;
+  let inputGranularity;
+  let addressComplete;
+  let nextAction;
+  let dpv;
+  let dpvFootnote;
+  let unconfirmed = [];
+  let missing = [];
+  let hasReplaced = false;
+  let hasInferred = false;
+  let uspsError;
+  const components = [];
+  let postalAddress;
+  let formattedAddress2;
+  let geocode2;
+  let standardized;
+  let rowId;
+  if (!outcome || "unresolved" in outcome) {
+    const street = outcome && "unresolved" in outcome ? outcome.unresolved : void 0;
+    const hasNumber = street?.hasNumber ?? STREET_NUMBER2.test(input.addressLines[0] ?? "");
+    const unit = street?.unit;
+    const cityKnown = input.locality !== void 0 && cityRows(rows, input.locality, stateCode(input.administrativeArea)).length > 0;
+    inputGranularity = unit ? "SUB_PREMISE" : hasNumber ? "PREMISE" : "ROUTE";
+    addressComplete = false;
+    nextAction = "FIX";
+    if (cityKnown && !hasNumber) {
+      granularity = "ROUTE";
+      missing = ["street_number"];
+      dpv = void 0;
+    } else {
+      granularity = "OTHER";
+      dpv = usps ? "N" : void 0;
+    }
+    const streetText = street?.street ?? input.addressLines[0] ?? "";
+    const split = STREET_NUMBER2.exec(streetText);
+    const routeLevel = cityKnown ? "UNCONFIRMED_BUT_PLAUSIBLE" : "UNCONFIRMED_AND_SUSPICIOUS";
+    if (split) {
+      components.push(component(split[1], "street_number", routeLevel));
+      components.push(component(split[2], "route", routeLevel));
+    } else if (streetText) {
+      components.push(
+        component(streetText, "route", cityKnown ? "CONFIRMED" : "UNCONFIRMED_AND_SUSPICIOUS")
+      );
+    }
+    if (unit) components.push(component(unitText(unit), "subpremise", routeLevel));
+    if (input.locality) {
+      components.push(
+        component(
+          input.locality,
+          "locality",
+          cityKnown ? "CONFIRMED" : "UNCONFIRMED_AND_SUSPICIOUS"
+        )
+      );
+    }
+    const state = stateCode(input.administrativeArea);
+    if (state) {
+      components.push(
+        component(
+          state,
+          "administrative_area_level_1",
+          STATE_NAMES[state] ? "CONFIRMED" : "UNCONFIRMED_AND_SUSPICIOUS"
+        )
+      );
+    }
+    if (input.postalCode) {
+      const zipKnown = rows.some((row2) => row2.zip === input.postalCode?.slice(0, 5));
+      components.push(
+        component(
+          input.postalCode,
+          "postal_code",
+          zipKnown ? "CONFIRMED" : "UNCONFIRMED_AND_SUSPICIOUS"
+        )
+      );
+    }
+    components.push(
+      component(region === "US" ? "USA" : region, "country", "CONFIRMED", {
+        inferred: input.regionCode === void 0
+      })
+    );
+    hasInferred = input.regionCode === void 0;
+    unconfirmed = components.filter((c) => c.confirmationLevel !== "CONFIRMED").map((c) => c.componentType);
+    const line = [streetText, unit ? unitText(unit) : ""].filter(Boolean).join(" ");
+    postalAddress = compact({
+      regionCode: region,
+      languageCode: "en",
+      postalCode: input.postalCode,
+      administrativeArea: state,
+      locality: input.locality,
+      addressLines: line ? [line] : void 0
+    });
+    formattedAddress2 = [
+      line,
+      input.locality,
+      [state, input.postalCode].filter(Boolean).join(" "),
+      region === "US" ? "USA" : region
+    ].filter(Boolean).join(", ");
+  } else {
+    const r = outcome.resolved;
+    const row2 = r.row;
+    rowId = row2.id;
+    const street = r.street;
+    const validation = row2.validation ?? {};
+    const plus4 = zipPlus4(row2, street);
+    inputGranularity = r.unit ? "SUB_PREMISE" : "PREMISE";
+    granularity = "PREMISE";
+    addressComplete = true;
+    nextAction = "ACCEPT";
+    dpv = "Y";
+    dpvFootnote = "AABB";
+    let unitLevel = "CONFIRMED";
+    if (validation.multiUnit) {
+      if (!r.unit) {
+        missing = ["subpremise"];
+        addressComplete = false;
+        nextAction = "CONFIRM_ADD_SUBPREMISES";
+        dpv = "D";
+        dpvFootnote = "AAN1";
+      } else if (validation.units === void 0 || validation.units.some((u) => u.toUpperCase() === r.unit?.value)) {
+        granularity = "SUB_PREMISE";
+      } else {
+        unitLevel = "UNCONFIRMED_BUT_PLAUSIBLE";
+        nextAction = "CONFIRM";
+        dpv = "S";
+        dpvFootnote = "AACC";
+      }
+    } else if (r.unit) {
+      unitLevel = "UNCONFIRMED_BUT_PLAUSIBLE";
+      nextAction = "CONFIRM";
+      dpvFootnote = "AACC";
+    }
+    if (r.postal === "replaced" || r.locality === "replaced" || r.state === "replaced") {
+      hasReplaced = true;
+      if (nextAction === "ACCEPT") nextAction = "CONFIRM";
+    }
+    components.push(component(r.number, "street_number", "CONFIRMED"));
+    components.push(component(r.route, "route", "CONFIRMED"));
+    if (r.unit) components.push(component(unitText(r.unit), "subpremise", unitLevel));
+    components.push(
+      component(row2.city, "locality", "CONFIRMED", { replaced: r.locality === "replaced" })
+    );
+    components.push(
+      component(row2.state, "administrative_area_level_1", "CONFIRMED", {
+        replaced: r.state === "replaced"
+      })
+    );
+    components.push(
+      component(row2.zip, "postal_code", "CONFIRMED", {
+        inferred: r.postal === "inferred",
+        replaced: r.postal === "replaced"
+      })
+    );
+    components.push(component(plus4, "postal_code_suffix", "CONFIRMED", { inferred: true }));
+    components.push(
+      component("USA", "country", "CONFIRMED", { inferred: input.regionCode === void 0 })
+    );
+    hasInferred = true;
+    unconfirmed = components.filter((c) => c.confirmationLevel !== "CONFIRMED").map((c) => c.componentType);
+    if (validation.granularity) granularity = validation.granularity;
+    if (validation.addressComplete !== void 0) addressComplete = validation.addressComplete;
+    if (validation.possibleNextAction) nextAction = validation.possibleNextAction;
+    if (validation.dpvConfirmation) dpv = validation.dpvConfirmation;
+    if (validation.unconfirmedComponentTypes)
+      unconfirmed = [...validation.unconfirmedComponentTypes];
+    if (validation.uspsErrorMessage) uspsError = validation.uspsErrorMessage;
+    const line = [street, r.unit ? unitText(r.unit) : ""].filter(Boolean).join(" ");
+    const zip = `${row2.zip}-${plus4}`;
+    postalAddress = {
+      regionCode: "US",
+      languageCode: "en",
+      postalCode: zip,
+      administrativeArea: row2.state,
+      locality: row2.city,
+      addressLines: [line]
+    };
+    formattedAddress2 = `${line}, ${row2.city}, ${row2.state} ${zip}, USA`;
+    const place = r.inCorpus ? { placeId: corpusPlaceId(row2), lat: row2.lat, lng: row2.lng } : synthesize(street, row2);
+    geocode2 = {
+      location: { latitude: place.lat, longitude: place.lng },
+      placeId: place.placeId,
+      placeTypes: r.unit ? ["subpremise"] : ["premise"]
+    };
+    standardized = {
+      firstAddressLine: line.toUpperCase(),
+      cityStateZipAddressLine: `${row2.city.toUpperCase()} ${row2.state} ${zip}`,
+      city: row2.city.toUpperCase(),
+      state: row2.state,
+      zipCode: row2.zip,
+      zipCodeExtension: plus4
+    };
+  }
+  if (options.dpvOverride) dpv = options.dpvOverride;
+  if (dpv === "N") standardized = void 0;
+  if (dpv !== void 0 && dpvFootnote === void 0) dpvFootnote = dpv === "N" ? "A1M1" : "AABB";
+  if (dpv === "N") dpvFootnote = "A1M1";
+  const verdict = compact({
+    inputGranularity,
+    validationGranularity: granularity,
+    geocodeGranularity: granularity === "SUB_PREMISE" ? "PREMISE" : granularity,
+    addressComplete,
+    hasUnconfirmedComponents: unconfirmed.length > 0,
+    hasInferredComponents: hasInferred,
+    hasReplacedComponents: hasReplaced,
+    possibleNextAction: nextAction
+  });
+  const address = compact({
+    formattedAddress: formattedAddress2,
+    postalAddress,
+    addressComponents: components,
+    missingComponentTypes: uniq(missing),
+    unconfirmedComponentTypes: uniq(unconfirmed)
+  });
+  const uspsData = usps ? uspsError ? compact({ errorMessage: uspsError, cassProcessed: enableUspsCass }) : compact({
+    standardizedAddress: standardized,
+    dpvConfirmation: dpv,
+    dpvFootnote: dpv ? dpvFootnote : void 0,
+    postOfficeCity: standardized ? standardized.city : void 0,
+    postOfficeState: standardized ? standardized.state : void 0,
+    cassProcessed: enableUspsCass
+  }) : void 0;
+  const result = compact({ verdict, address, geocode: geocode2, uspsData });
+  const verdictClass = `${nextAction}/${uspsError ? "ERROR" : dpv ?? "-"}`;
+  return {
+    body: { result, responseId: responseId(JSON.stringify({ input, enableUspsCass })) },
+    rowId,
+    verdictClass
+  };
+};
+
 // src/runtime.ts
 var WEB_SERVICES = ["PlaceAutocomplete", "PlaceDetails", "Geocode", "FindPlaceFromText"];
 var everyWebService = (rule) => WEB_SERVICES.map((operationId) => ({ operationId, ...rule }));
@@ -3054,6 +3606,60 @@ var GOOGLE_MAPS_PRESETS = {
     description: "Every web-service call is held 6 s: past QA's 5 s wait for predictions",
     rules: everyWebService({ latencyMs: 6e3 })
   },
+  address_validation_denied: {
+    description: "Address Validation answers 403 PERMISSION_DENIED, as for a key without the API enabled",
+    rules: [
+      {
+        operationId: "ValidateAddress",
+        status: 403,
+        body: {
+          error: {
+            code: 403,
+            message: "Requests to this API addressvalidation.googleapis.com method google.maps.addressvalidation.v1.AddressValidation.ValidateAddress are blocked.",
+            status: "PERMISSION_DENIED",
+            details: [
+              {
+                "@type": "type.googleapis.com/google.rpc.ErrorInfo",
+                reason: "API_KEY_SERVICE_BLOCKED",
+                domain: "googleapis.com",
+                metadata: { service: "addressvalidation.googleapis.com" }
+              }
+            ]
+          }
+        }
+      }
+    ]
+  },
+  address_validation_unavailable: {
+    description: "Address Validation answers 503 UNAVAILABLE (Google's transient failure)",
+    rules: [
+      {
+        operationId: "ValidateAddress",
+        status: 503,
+        body: {
+          error: {
+            code: 503,
+            message: "The service is currently unavailable.",
+            status: "UNAVAILABLE"
+          }
+        }
+      }
+    ]
+  },
+  address_validation_slow: {
+    description: "Address Validation is held 3 s: past a 2.5 s checkout timeout",
+    rules: [{ operationId: "ValidateAddress", latencyMs: 3e3 }]
+  },
+  address_validation_no_verdict: {
+    description: `Address Validation answers 200 {"result": {}} (no verdict): a malformed answer, for a client's defensive branch`,
+    rules: [{ operationId: "ValidateAddress", status: 200, body: { result: {} } }]
+  },
+  address_validation_dpv_n: {
+    description: "Address Validation reports USPS DPV confirmation N (not deliverable)",
+    rules: [
+      { operationId: "ValidateAddress", effect: "usps_dpv", params: { dpvConfirmation: "N" } }
+    ]
+  },
   script_unavailable: {
     description: "The Maps JavaScript API answers 503, so the script's onerror fires",
     rules: [{ operationId: "MapsJavaScriptApi", status: 503, body: "Service Unavailable" }]
@@ -3061,9 +3667,46 @@ var GOOGLE_MAPS_PRESETS = {
 };
 var json3 = (status, body) => new Response(JSON.stringify(body), { status, headers: { "content-type": "application/json" } });
 var adminError3 = (status, message) => json3(status, { error: { type: "mockingbird_admin", message } });
-var isRecord4 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isRecord5 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var stringList = (value) => Array.isArray(value) && value.every((v) => typeof v === "string") ? value : void 0;
+var parseValidation = (value, index) => {
+  if (value === void 0 || value === null) return void 0;
+  const at = `addresses[${index}].validation`;
+  if (!isRecord5(value)) return `${at} must be an object`;
+  const out = {};
+  const enums = [
+    ["granularity", GRANULARITIES],
+    ["possibleNextAction", NEXT_ACTIONS],
+    ["dpvConfirmation", DPV_CODES]
+  ];
+  for (const [key, allowed] of enums) {
+    if (value[key] === void 0) continue;
+    if (!allowed.includes(value[key])) {
+      return `${at}.${key} must be one of ${allowed.join(", ")}`;
+    }
+    Object.assign(out, { [key]: value[key] });
+  }
+  for (const key of ["addressComplete", "multiUnit"]) {
+    if (value[key] === void 0) continue;
+    if (typeof value[key] !== "boolean") return `${at}.${key} must be a boolean`;
+    out[key] = value[key];
+  }
+  for (const key of ["unconfirmedComponentTypes", "units"]) {
+    if (value[key] === void 0) continue;
+    const list = stringList(value[key]);
+    if (!list) return `${at}.${key} must be a string[]`;
+    out[key] = list;
+  }
+  if (value.uspsErrorMessage !== void 0) {
+    if (typeof value.uspsErrorMessage !== "string" || !value.uspsErrorMessage) {
+      return `${at}.uspsErrorMessage must be a non-empty string`;
+    }
+    out.uspsErrorMessage = value.uspsErrorMessage;
+  }
+  return out;
+};
 var parseAddress = (value, index) => {
-  if (!isRecord4(value)) return `addresses[${index}] must be an object`;
+  if (!isRecord5(value)) return `addresses[${index}] must be an object`;
   for (const key of ["line1", "city", "state", "zip"]) {
     if (typeof value[key] !== "string" || !value[key].trim()) {
       return `addresses[${index}].${key} must be a non-empty string`;
@@ -3071,6 +3714,8 @@ var parseAddress = (value, index) => {
   }
   const state = String(value.state).toUpperCase();
   if (!/^[A-Z]{2}$/.test(state)) return `addresses[${index}].state must be a two-letter code`;
+  const validation = parseValidation(value.validation, index);
+  if (typeof validation === "string") return validation;
   const lat = value.lat === void 0 ? 0 : Number(value.lat);
   const lng = value.lng === void 0 ? 0 : Number(value.lng);
   if (!Number.isFinite(lat) || !Number.isFinite(lng)) {
@@ -3084,7 +3729,8 @@ var parseAddress = (value, index) => {
     zip: String(value.zip).trim(),
     county: typeof value.county === "string" ? value.county : "",
     lat,
-    lng
+    lng,
+    ...validation ? { validation } : {}
   };
 };
 var adminRoutes = (runtime) => ({
@@ -3096,9 +3742,12 @@ var adminRoutes = (runtime) => ({
     });
   },
   "PUT /corpus": ({ body, namespace }) => {
-    const list = Array.isArray(body) ? body : isRecord4(body) ? body.addresses : void 0;
+    const list = Array.isArray(body) ? body : isRecord5(body) ? body.addresses : void 0;
     if (!Array.isArray(list)) {
-      return adminError3(400, 'expected {"addresses": [{line1, city, state, zip, lat?, lng?}]}');
+      return adminError3(
+        400,
+        'expected {"addresses": [{line1, city, state, zip, lat?, lng?, validation?}]}'
+      );
     }
     const rows = [];
     for (const [index, each] of list.entries()) {
@@ -3116,7 +3765,7 @@ var adminRoutes = (runtime) => ({
   },
   "GET /settings": ({ namespace }) => json3(200, runtime.instance(namespace).state.current()),
   "PUT /settings": ({ body, namespace }) => {
-    if (!isRecord4(body)) return adminError3(400, "expected a JSON object");
+    if (!isRecord5(body)) return adminError3(400, "expected a JSON object");
     const patch = {};
     if (body.keys !== void 0) {
       if (!Array.isArray(body.keys)) return adminError3(400, "keys: string[]");
@@ -3159,7 +3808,9 @@ var createRuntime2 = (options = {}) => createRuntime({
 var GOOGLE_MAPS_NAMESPACE = "google-maps";
 var MISSING_KEY_MESSAGE = "You must use an API key to authenticate each request to Google Maps Platform APIs. For additional information, please refer to http://g.co/dev/maps-no-account";
 var INVALID_KEY_MESSAGE = "The provided API key is invalid. ";
-var keyCredential = (request) => new URL(request.url).searchParams.get("key") ?? void 0;
+var MISSING_API_KEY_MESSAGE = "The request is missing a valid API key.";
+var INVALID_API_KEY_MESSAGE = "API key not valid. Please pass a valid API key.";
+var keyCredential = (request) => new URL(request.url).searchParams.get("key") ?? request.headers.get("x-goog-api-key") ?? void 0;
 var CORS = { "access-control-allow-origin": "*" };
 var json4 = (body, status = 200) => new Response(JSON.stringify(body, null, 3), {
   status,
@@ -3176,6 +3827,17 @@ var DEFAULT_MESSAGES = {
   UNKNOWN_ERROR: "An unknown error occurred. Please try again.",
   REQUEST_DENIED: INVALID_KEY_MESSAGE
 };
+var apiError = (error) => json4({ error }, error.code);
+var requestJson = (body) => {
+  if (body.kind === "json") return body.value;
+  if (body.kind === "empty") return {};
+  const raw = body.kind === "bytes" ? new TextDecoder().decode(body.value) : body.kind === "text" ? body.value : body.kind === "invalid" ? body.text : void 0;
+  try {
+    return JSON.parse(raw ?? "");
+  } catch {
+    throw new ValidationRequestError("Invalid JSON payload received.");
+  }
+};
 var text = (value) => typeof value === "string" ? value : Array.isArray(value) ? String(value[0]) : void 0;
 var GoogleMapsAPI = class {
   app;
@@ -3196,7 +3858,8 @@ var GoogleMapsAPI = class {
       PlaceDetails: (context) => this.details(context),
       Geocode: (context) => this.geocode(context),
       FindPlaceFromText: (context) => this.findPlace(context),
-      MapsJavaScriptApi: (context) => this.script(context)
+      MapsJavaScriptApi: (context) => this.script(context),
+      ValidateAddress: (context) => this.validate(context)
     });
     this.service = createService({
       document,
@@ -3239,6 +3902,7 @@ var GoogleMapsAPI = class {
   gate(context) {
     const operationId = context.operation.operationId;
     if (operationId === "MapsJavaScriptApi") return void 0;
+    if (operationId === "ValidateAddress") return this.cloudGate(context);
     const key = text(context.query.key);
     if (!key) return this.status(operationId, "REQUEST_DENIED", MISSING_KEY_MESSAGE);
     const keys = this.state.current().keys;
@@ -3253,6 +3917,50 @@ var GoogleMapsAPI = class {
     }
     return void 0;
   }
+  /** Key check for the Google Cloud-style Address Validation API. */
+  cloudGate(context) {
+    const key = text(context.query.key) ?? context.request.headers.get("x-goog-api-key");
+    if (!key) {
+      return apiError({ code: 403, message: MISSING_API_KEY_MESSAGE, status: "PERMISSION_DENIED" });
+    }
+    const keys = this.state.current().keys;
+    if (keys.length > 0 && !keys.includes(key)) {
+      return apiError({
+        code: 400,
+        message: INVALID_API_KEY_MESSAGE,
+        status: "INVALID_ARGUMENT",
+        details: [
+          {
+            "@type": "type.googleapis.com/google.rpc.ErrorInfo",
+            reason: "API_KEY_INVALID",
+            domain: "googleapis.com",
+            metadata: { service: "addressvalidation.googleapis.com" }
+          }
+        ]
+      });
+    }
+    return void 0;
+  }
+  validate(context) {
+    let request;
+    try {
+      request = parseValidateRequest(requestJson(context.body));
+    } catch (error) {
+      if (!(error instanceof ValidationRequestError)) throw error;
+      return apiError({ code: 400, message: error.message, status: "INVALID_ARGUMENT" });
+    }
+    const forced = faultEffect(context.request, "usps_dpv")?.dpvConfirmation;
+    const dpvOverride = DPV_CODES.includes(forced) ? forced : void 0;
+    const outcome = validateAddress(request, this.state.corpus(), {
+      ...dpvOverride ? { dpvOverride } : {}
+    });
+    return annotateResponse(json4(outcome.body), {
+      ids: {
+        ...outcome.rowId ? { addressRowId: outcome.rowId } : {},
+        verdict: outcome.verdictClass
+      }
+    });
+  }
   noted(response, context, place) {
     const session = text(context.query.sessiontoken);
     const ids = {};
@@ -3387,7 +4095,9 @@ export {
   GOOGLE_MAPS_NAMESPACE,
   MISSING_KEY_MESSAGE,
   INVALID_KEY_MESSAGE,
+  MISSING_API_KEY_MESSAGE,
+  INVALID_API_KEY_MESSAGE,
   keyCredential,
   GoogleMapsAPI
 };
-//# sourceMappingURL=chunk-5HEE5U7V.js.map
+//# sourceMappingURL=chunk-G5DEDMPE.js.map