@mailwoman/api 6.0.0

package/README.md

@@ -0,0 +1,98 @@
+# @mailwoman/api
+
+The **native [Mailwoman](https://mailwoman.sister.software) HTTP API** — an engine-agnostic `/v1` surface
+(parse, geocode, batch, resolve, format) plus health, metrics, and an emitted OpenAPI document. Unlike its
+drop-in siblings ([`@mailwoman/nominatim`](../nominatim), [`@mailwoman/photon`](../photon),
+[`@mailwoman/libpostal`](../libpostal)), nothing here mimics a third-party API — this is Mailwoman's own
+wire contract, so request bodies are strict and validator-enforced.
+
+## Engine contract
+
+The package takes a `MailwomanAPIEngine` — every method optional. An absent method answers `501` (`/v1/parse`)
+or `503` (`/v1/geocode`, `/v1/batch`, `/v1/resolve`, `/v1/reload` — deps missing in production). `format` is
+the one exception: it's wired in-package from [`@mailwoman/formatter`](../formatter) and always available,
+with no engine method at all.
+
+```ts
+import type { MailwomanAPIEngine } from "@mailwoman/api"
+
+const engine: MailwomanAPIEngine = {
+	parse: async (address, opts) => {
+		/* → { input, solutions, debug? } */
+	},
+	geocode: async (address) => {
+		/* → GeocodeResult, passed through verbatim */
+	},
+	batch: async (addresses) => {
+		/* → { results } — one row per address, in order, per-row error isolation */
+	},
+	resolveTree: async (tree, opts) => {
+		/* → { tree } — the same tree, decorated with gazetteer coords + attribution */
+	},
+	reload: async () => {
+		/* → { reloaded, versions } — versioned data switchover */
+	},
+	health: () => {
+		/* → model card / data-root inventory, spread into GET /health */
+	},
+}
+```
+
+The `mailwoman` CLI wires the real parse/geocode/resolve stack (phase 4b); tests inject fixtures.
+
+## Endpoints
+
+| Endpoint        | Method    | Body / query                           | Absent-engine status       |
+| --------------- | --------- | -------------------------------------- | -------------------------- |
+| `/v1/parse`     | GET, POST | `{ address, debug? }` (or `?address=`) | `501`                      |
+| `/v1/geocode`   | POST      | `{ address }`                          | `503`                      |
+| `/v1/batch`     | POST      | `{ addresses: string[] }`              | `503`                      |
+| `/v1/resolve`   | POST      | `{ tree: AddressTree, opts? }`         | `503`                      |
+| `/v1/reload`    | POST      | —                                      | `503`                      |
+| `/v1/format`    | POST      | `{ components, country, options? }`    | always available           |
+| `/health`       | GET       | —                                      | `200` (status+uptime only) |
+| `/metrics`      | GET       | —                                      | always available           |
+| `/openapi.json` | GET       | —                                      | always available           |
+
+Every error response is the native envelope: `{ error: string, detail?: string }`. A validation failure on
+a strict body (e.g. `/v1/format` with no `components`) maps through the same envelope — `{ error: "invalid
+request body", detail: "<short zod summary>" }` — never the raw zod shape.
+
+## Library use
+
+```ts
+import { serveNode } from "@mailwoman/api-kit"
+import { createMailwomanAPI, type MailwomanAPIEngine } from "@mailwoman/api"
+
+const engine: MailwomanAPIEngine = {
+	/* parse, geocode, batch, resolveTree, reload, health — backed by your Mailwoman pipeline */
+}
+const app = createMailwomanAPI(engine)
+serveNode({ fetch: app.fetch, port: 3000, hostname: "0.0.0.0" })
+```
+
+## Options
+
+`createMailwomanAPI(engine, options?)`:
+
+- `cors` — permissive CORS (`Access-Control-Allow-Origin: *`, `GET, POST, OPTIONS`) on by default; browser
+  clients (the demo, a map widget) need it for the mutating `/v1/*` preflight. Set `false` when a reverse
+  proxy already owns the CORS headers.
+- `bodyLimitBytes` — max request body size, enforced ahead of every `/v1/*` handler. Default 2 MiB (carried
+  from the express server's `express.json({ limit: "2mb" })`). Oversized bodies answer `413` before the body
+  is buffered into memory.
+- `batchMax` — max `addresses` rows accepted by `POST /v1/batch`. Default 500. Exceeding it answers `413`.
+
+## Metrics
+
+`POST /v1/geocode` and `POST /v1/batch` record timing to [`@mailwoman/api-kit`](../api-kit)'s generic
+in-process metrics — `GET /metrics` returns the live snapshot (latency percentiles, per-tier counts).
+`/v1/geocode`'s tier is read from `outcome["resolution_tier"]` (falling back to `"admin"`); `/v1/batch`
+records whole-call latency under the fixed `"batch"` tier — per-row tier metrics are the engine's job
+(phase 4b). A thrown engine error records the reserved `"error"` tier before rethrowing into the `500`
+safety net.
+
+## Status
+
+Phase 4a: the routes, app, and OpenAPI document ship engine-agnostic, with fixture-backed tests. Phase 4b
+wires the real engine into the `mailwoman serve` CLI and repoints `RemoteResolver` at `/v1/resolve`.

package/out/app.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The native Mailwoman Hono app: CORS + a request-body-size guard + the strict-validation error
+ *   envelope + the `/v1` routes + the emitted OpenAPI document. Engine-agnostic — the `mailwoman`
+ *   CLI wires the real parse/geocode/resolve stack (phase 4b); tests inject fixtures.
+ */
+import { OpenAPIHono } from "@hono/zod-openapi";
+import { type OpenAPIDocInfo } from "@mailwoman/api-kit";
+import type { MailwomanAPIEngine } from "./engine.ts";
+/** Options for {@link createMailwomanAPI}. */
+export interface MailwomanAPIOptions {
+    /**
+     * Emit permissive CORS headers (`Access-Control-Allow-Origin: *`) on every response and answer preflight `OPTIONS`
+     * with `204`. Default `true` — browser-embedded clients (the demo, a map widget) need it: a cross-origin XHR
+     * (including the `POST` preflight) is blocked without it (#1017). Set `false` when a reverse proxy already owns the
+     * CORS headers.
+     */
+    cors?: boolean;
+    /** Max request body size in bytes, enforced ahead of every `/v1/*` handler. Default 2 MiB. */
+    bodyLimitBytes?: number;
+    /** Max `addresses` rows accepted by `POST /v1/batch`. Default 500 (see `routes.ts`'s `DEFAULT_BATCH_MAX`). */
+    batchMax?: number;
+}
+/**
+ * The document info stamped into the emitted OpenAPI document. Exported (not inlined) so the `mailwoman openapi`
+ * command can call `emitOpenAPIDocuments` with the SAME info the mounted `/openapi.json` route (below, via
+ * {@link attachOpenAPIDocs}) uses — one source of truth, no risk of the two drifting.
+ */
+export declare const MAILWOMAN_API_DOC_INFO: OpenAPIDocInfo;
+/** Build the native Mailwoman app around an injected {@link MailwomanAPIEngine}. */
+export declare function createMailwomanAPI(engine: MailwomanAPIEngine, options?: MailwomanAPIOptions): OpenAPIHono;
+//# sourceMappingURL=app.d.ts.map

package/out/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../app.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAA+B,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAKrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAMrD,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IACnC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd,8FAA8F;IAC9F,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,8GAA8G;IAC9G,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAUD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAoBpC,CAAA;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,GAAE,mBAAwB,GAAG,WAAW,CAkD7G"}

package/out/app.js

@@ -0,0 +1,92 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The native Mailwoman Hono app: CORS + a request-body-size guard + the strict-validation error
+ *   envelope + the `/v1` routes + the emitted OpenAPI document. Engine-agnostic — the `mailwoman`
+ *   CLI wires the real parse/geocode/resolve stack (phase 4b); tests inject fixtures.
+ */
+import { OpenAPIHono } from "@hono/zod-openapi";
+import { apiError, attachOpenAPIDocs } from "@mailwoman/api-kit";
+import packageJson from "@mailwoman/api/package.json" with { type: "json" };
+import { bodyLimit } from "hono/body-limit";
+import { cors } from "hono/cors";
+import { DEFAULT_BATCH_MAX, registerMailwomanAPIRoutes } from "./routes.js";
+/** 2 MiB — carried from the express server's `express.json({ limit: "2mb" })` (`mailwoman/server/index.ts`). */
+const DEFAULT_BODY_LIMIT_BYTES = 2 * 1024 * 1024;
+/**
+ * Short, single-line summary of a zod validation failure for the envelope's `detail` field — not the full `ZodError`,
+ * which is multi-line and carries internal path/code detail not meant for a wire response.
+ */
+function summarizeValidationError(error) {
+    return error.issues.map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`).join("; ");
+}
+/**
+ * The document info stamped into the emitted OpenAPI document. Exported (not inlined) so the `mailwoman openapi`
+ * command can call `emitOpenAPIDocuments` with the SAME info the mounted `/openapi.json` route (below, via
+ * {@link attachOpenAPIDocs}) uses — one source of truth, no risk of the two drifting.
+ */
+export const MAILWOMAN_API_DOC_INFO = {
+    title: packageJson.name,
+    version: packageJson.version,
+    description: packageJson.description,
+    license: { name: "AGPL-3.0-only OR LicenseRef-Commercial", identifier: "AGPL-3.0-only" },
+    contact: { name: "Sister Software", url: "https://mailwoman.sister.software" },
+    servers: [
+        {
+            url: "http://{host}:{port}",
+            variables: { host: { default: "127.0.0.1" }, port: { default: "3000" } },
+        },
+    ],
+    security: [],
+    tags: [
+        { name: "parsing", description: "Free-text address parsing." },
+        { name: "geocoding", description: "Address-to-coordinate resolution." },
+        { name: "resolving", description: "Gazetteer resolution over an already-decoded address tree." },
+        { name: "formatting", description: "Component-dict rendering — the inverse of parsing." },
+        { name: "meta", description: "Health, metrics, and deploy-time operations." },
+    ],
+};
+/** Build the native Mailwoman app around an injected {@link MailwomanAPIEngine}. */
+export function createMailwomanAPI(engine, options = {}) {
+    const app = new OpenAPIHono({
+        // This surface is ours (no vendor contract to preserve): every declared body/query schema is
+        // validator-enforced, and a failure maps through the shared api-kit envelope — never the raw zod
+        // `{success, error}` shape. Individual routes (routes.ts) override this per-call to answer their OWN
+        // friendly business message (e.g. "address is required"); this is the fallback for the rest (currently
+        // just `/v1/format`).
+        defaultHook: (result, c) => {
+            if (!result.success) {
+                return apiError(c, 400, "invalid request body", summarizeValidationError(result.error));
+            }
+            return undefined;
+        },
+    });
+    // Browser-embedded clients need CORS or their cross-origin XHR (including the mutating `/v1/*` preflight) is
+    // blocked before it completes (#1017). GET+POST, unlike the read-only drop-ins (photon, nominatim).
+    if (options.cors !== false) {
+        app.use(cors({ origin: "*", allowMethods: ["GET", "POST", "OPTIONS"], allowHeaders: ["*"], maxAge: 86400 }));
+    }
+    // Safety net: an engine fault answers the native envelope, never a crash. `detail` carries the raw message —
+    // this surface is ours to design, so (unlike the vendor-constrained drop-in envelopes) we can be helpful.
+    app.onError((error, c) => {
+        // A malformed request body is a client-side syntax error, not a server fault — Hono's zod-openapi
+        // validator throws before a route's own hook ever sees the body, so it lands here instead of the
+        // per-route 400s in routes.ts. Answer 400, not the 500 net (which stays reserved for engine faults).
+        if (error instanceof Error && error.message.includes("Malformed JSON")) {
+            return apiError(c, 400, "invalid request body", "malformed JSON");
+        }
+        return apiError(c, 500, "internal error", error instanceof Error ? error.message : String(error));
+    });
+    // Ahead of the handlers (which buffer the body into memory) so an oversized POST is rejected before that
+    // buffering happens, not after — mirrors the libpostal precedent.
+    app.use("/v1/*", bodyLimit({
+        maxSize: options.bodyLimitBytes ?? DEFAULT_BODY_LIMIT_BYTES,
+        onError: (c) => apiError(c, 413, "request body too large"),
+    }));
+    registerMailwomanAPIRoutes(app, engine, { batchMax: options.batchMax ?? DEFAULT_BATCH_MAX });
+    attachOpenAPIDocs(app, MAILWOMAN_API_DOC_INFO);
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/out/app.js.map

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

package/out/engine.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The native-surface engine contract. Engine-agnostic like the drop-ins: the `mailwoman` CLI
+ *   wires the real parse/geocode/resolve stack (phase 4b); tests inject fixtures. `format` is the
+ *   exception — it's wired in-package from `@mailwoman/formatter` (the surface exists to expose it).
+ */
+import type { AddressTree } from "@mailwoman/core/decoder";
+import type { SerializedSolution } from "@mailwoman/core/solver";
+/** One parse outcome: the tokenized input span + ranked solutions (the legacy /parse shape). */
+export interface ParseOutcome {
+    input: {
+        body: string;
+        start: number;
+        end: number;
+    };
+    solutions: SerializedSolution[];
+    debug?: string;
+}
+/** A geocode outcome — the engine returns the geocode-core `GeocodeResult` shape verbatim (passthrough). */
+export type GeocodeOutcome = Record<string, unknown>;
+/** A batch row: a GeocodeOutcome, or an `{ input, error }` slot (per-row isolation). */
+export type BatchRow = GeocodeOutcome | {
+    input: string;
+    error: string;
+};
+export interface ResolveTreeOutcome {
+    tree: AddressTree;
+}
+/** The `/health` data block the engine contributes (model card, data-root inventory). */
+export type HealthData = Record<string, unknown>;
+export interface MailwomanAPIEngine {
+    parse?(address: string, opts: {
+        debug: boolean;
+    }): Promise<ParseOutcome>;
+    geocode?(address: string): Promise<GeocodeOutcome>;
+    batch?(addresses: string[]): Promise<{
+        results: BatchRow[];
+    }>;
+    resolveTree?(tree: AddressTree, opts: Record<string, unknown>): Promise<ResolveTreeOutcome>;
+    reload?(): Promise<{
+        reloaded: boolean;
+        versions: unknown;
+    }>;
+    health?(): HealthData;
+}
+//# sourceMappingURL=engine.d.ts.map

package/out/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAEhE,gGAAgG;AAChG,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD,SAAS,EAAE,kBAAkB,EAAE,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,4GAA4G;AAC5G,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEpD,wFAAwF;AACxF,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAExE,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,WAAW,CAAA;CACjB;AAED,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEhD,MAAM,WAAW,kBAAkB;IAClC,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACxE,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAClD,KAAK,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC,CAAA;IAC7D,WAAW,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC3F,MAAM,CAAC,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAC5D,MAAM,CAAC,IAAI,UAAU,CAAA;CACrB"}

package/out/engine.js

@@ -0,0 +1,11 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The native-surface engine contract. Engine-agnostic like the drop-ins: the `mailwoman` CLI
+ *   wires the real parse/geocode/resolve stack (phase 4b); tests inject fixtures. `format` is the
+ *   exception — it's wired in-package from `@mailwoman/formatter` (the surface exists to expose it).
+ */
+export {};
+//# sourceMappingURL=engine.js.map

package/out/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/out/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `@mailwoman/api` — the native Mailwoman HTTP API: an engine-agnostic `/v1` surface (parse,
+ *   geocode, batch, resolve, format) alongside health, metrics, and an emitted OpenAPI document.
+ *   Unlike its drop-in siblings (`@mailwoman/nominatim`, `@mailwoman/photon`,
+ *   `@mailwoman/libpostal`), nothing here mimics a third-party API — this is Mailwoman's own wire
+ *   contract, so schemas are strict and validator-enforced rather than tolerant of legacy quirks.
+ *
+ *   Like its siblings, the package is engine-agnostic: routes take a {@link MailwomanAPIEngine}; the
+ *   `mailwoman` CLI wires the real parse/geocode/resolve stack (phase 4b). The Hono app (CORS +
+ *   body-size guard + the strict-validation error envelope + the emitted OpenAPI document) lives in
+ *   `app.ts`; route definitions + handlers (incl. `registerMailwomanAPIRoutes`) in `routes.ts`; the
+ *   engine contract in `engine.ts`; the zod wire schemas in `schema.ts`.
+ */
+export * from "./app.ts";
+export * from "./engine.ts";
+export * from "./routes.ts";
+export * from "./schema.ts";
+//# sourceMappingURL=index.d.ts.map

package/out/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/out/index.js

@@ -0,0 +1,22 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `@mailwoman/api` — the native Mailwoman HTTP API: an engine-agnostic `/v1` surface (parse,
+ *   geocode, batch, resolve, format) alongside health, metrics, and an emitted OpenAPI document.
+ *   Unlike its drop-in siblings (`@mailwoman/nominatim`, `@mailwoman/photon`,
+ *   `@mailwoman/libpostal`), nothing here mimics a third-party API — this is Mailwoman's own wire
+ *   contract, so schemas are strict and validator-enforced rather than tolerant of legacy quirks.
+ *
+ *   Like its siblings, the package is engine-agnostic: routes take a {@link MailwomanAPIEngine}; the
+ *   `mailwoman` CLI wires the real parse/geocode/resolve stack (phase 4b). The Hono app (CORS +
+ *   body-size guard + the strict-validation error envelope + the emitted OpenAPI document) lives in
+ *   `app.ts`; route definitions + handlers (incl. `registerMailwomanAPIRoutes`) in `routes.ts`; the
+ *   engine contract in `engine.ts`; the zod wire schemas in `schema.ts`.
+ */
+export * from "./app.js";
+export * from "./engine.js";
+export * from "./routes.js";
+export * from "./schema.js";
+//# sourceMappingURL=index.js.map

package/out/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/out/routes.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Route definitions + handlers for the native `/v1` surface. The OpenAPI document is emitted from
+ *   these definitions — there is no handwritten spec. Unlike the drop-ins (photon, nominatim,
+ *   libpostal), nothing here mimics a vendor's legacy query-parsing tolerance: request bodies are
+ *   validator-enforced, and a validation failure always answers through the shared api-kit envelope
+ *   (`apiError`), never the raw zod shape. `GET /v1/parse` is the one query-string route, and it
+ *   reads `c.req.query()` directly — a query string has no repeated-value contract worth preserving
+ *   here (contrast the drop-ins' `legacyQuery` adapter), so there's nothing to tolerate.
+ *
+ *   Per-route validation hooks (the 3rd arg to `app.openapi(route, handler, hook)`) override the
+ *   app-level `defaultHook` (wired in `app.ts`) so each route can answer its OWN friendly business
+ *   message — `"address is required"`, `"body must be { addresses: string[] }"`, etc. — matching the
+ *   express `mailwoman/server` precedent this surface carries forward. Routes with no friendly
+ *   carry-forward message (currently just `/v1/format`) fall through to the app-level hook's generic
+ *   `"invalid request body"`.
+ */
+import { type OpenAPIHono } from "@hono/zod-openapi";
+import type { MailwomanAPIEngine } from "./engine.ts";
+/**
+ * Default `POST /v1/batch` row cap when {@link RegisterMailwomanAPIRoutesOptions.batchMax} is omitted. This is the
+ * standalone-engine default, not derived from env — `mailwoman serve` always passes the env-derived value explicitly
+ * (`$public.MAILWOMAN_BATCH_MAX`, default 1000; see `core/env/schema.ts`).
+ */
+export declare const DEFAULT_BATCH_MAX = 500;
+/** Options for {@link registerMailwomanAPIRoutes}. */
+export interface RegisterMailwomanAPIRoutesOptions {
+    /** Max `addresses` rows accepted by `POST /v1/batch`. Default {@link DEFAULT_BATCH_MAX}. */
+    batchMax?: number;
+}
+/** Register the native `/v1` routes + `/health` + `/metrics` against an injected engine. */
+export declare function registerMailwomanAPIRoutes(app: OpenAPIHono, engine: MailwomanAPIEngine, options?: RegisterMailwomanAPIRoutesOptions): void;
+//# sourceMappingURL=routes.d.ts.map

package/out/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAe,KAAK,WAAW,EAAK,MAAM,mBAAmB,CAAA;AAMpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAgBrD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAA;AAapC,sDAAsD;AACtD,MAAM,WAAW,iCAAiC;IACjD,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AA2LD,4FAA4F;AAC5F,wBAAgB,0BAA0B,CACzC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,iCAAsC,GAC7C,IAAI,CAiJN"}

package/out/routes.js

@@ -0,0 +1,319 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Route definitions + handlers for the native `/v1` surface. The OpenAPI document is emitted from
+ *   these definitions — there is no handwritten spec. Unlike the drop-ins (photon, nominatim,
+ *   libpostal), nothing here mimics a vendor's legacy query-parsing tolerance: request bodies are
+ *   validator-enforced, and a validation failure always answers through the shared api-kit envelope
+ *   (`apiError`), never the raw zod shape. `GET /v1/parse` is the one query-string route, and it
+ *   reads `c.req.query()` directly — a query string has no repeated-value contract worth preserving
+ *   here (contrast the drop-ins' `legacyQuery` adapter), so there's nothing to tolerate.
+ *
+ *   Per-route validation hooks (the 3rd arg to `app.openapi(route, handler, hook)`) override the
+ *   app-level `defaultHook` (wired in `app.ts`) so each route can answer its OWN friendly business
+ *   message — `"address is required"`, `"body must be { addresses: string[] }"`, etc. — matching the
+ *   express `mailwoman/server` precedent this surface carries forward. Routes with no friendly
+ *   carry-forward message (currently just `/v1/format`) fall through to the app-level hook's generic
+ *   `"invalid request body"`.
+ */
+import { createRoute, z } from "@hono/zod-openapi";
+import { apiError, metricsSnapshot, recordTimed } from "@mailwoman/api-kit";
+import { canonicalKey, formatAddress } from "@mailwoman/formatter";
+import { APIErrorSchema, BatchRequestSchema, BatchResponseSchema, FormatRequestSchema, FormatResponseSchema, GeocodeOutcomeSchema, GeocodeRequestSchema, HealthResponseSchema, ParseOutcomeSchema, ParseRequestSchema, ResolveRequestSchema, ResolveResponseSchema, } from "./schema.js";
+/**
+ * Default `POST /v1/batch` row cap when {@link RegisterMailwomanAPIRoutesOptions.batchMax} is omitted. This is the
+ * standalone-engine default, not derived from env — `mailwoman serve` always passes the env-derived value explicitly
+ * (`$public.MAILWOMAN_BATCH_MAX`, default 1000; see `core/env/schema.ts`).
+ */
+export const DEFAULT_BATCH_MAX = 500;
+const startedAt = Date.now();
+/**
+ * `detail` text for every 503 "engine method absent" response (`/v1/geocode`, `/v1/batch`, `/v1/resolve`, `/v1/reload`)
+ * — the express-era remediation carried forward: a stranger hitting a 503 must see the exact fix, not just "not
+ * available". Matches `mailwoman/api-engine.ts`'s `buildPreflightMessage()` boot-time banner in spirit (same two
+ * missing pieces — the packages, and the gazetteer data), condensed to one line for a JSON error body.
+ */
+const GEOCODER_UNAVAILABLE_DETAIL = "install @mailwoman/neural + @mailwoman/resolver-wof-sqlite and provide gazetteer data (MAILWOMAN_WOF_DB / MAILWOMAN_CANDIDATE_DB)";
+const errorContent = (description) => ({
+    description,
+    content: { "application/json": { schema: APIErrorSchema } },
+});
+const parseQueryParams = z.object({
+    address: z.string().optional().openapi({ description: "The address to parse." }),
+    debug: z.string().optional().openapi({ description: '`"true"` to include a diagnostic report.' }),
+});
+const parseResponses = {
+    200: {
+        description: "The tokenized input span + ranked solutions.",
+        content: { "application/json": { schema: ParseOutcomeSchema } },
+    },
+    400: errorContent("`address` is required."),
+    501: errorContent("The backing engine method is not wired for this deployment."),
+};
+const geocodeResponses = {
+    200: {
+        description: "One geocode result (parse → resolve cascade), passed through from the engine verbatim.",
+        content: { "application/json": { schema: GeocodeOutcomeSchema } },
+    },
+    400: errorContent("`address` is required."),
+    503: errorContent("The geocoding engine is not wired for this deployment (dependencies missing)."),
+};
+const batchResponses = {
+    200: {
+        description: "One result per input address, in input order (per-row error isolation).",
+        content: { "application/json": { schema: BatchResponseSchema } },
+    },
+    400: errorContent("Body must be `{ addresses: string[] }`."),
+    413: errorContent("`addresses.length` exceeds the configured batch cap."),
+    503: errorContent("The geocoding engine is not wired for this deployment (dependencies missing)."),
+};
+const resolveResponses = {
+    200: {
+        description: "The same tree, decorated in place with gazetteer coordinates + attribution.",
+        content: { "application/json": { schema: ResolveResponseSchema } },
+    },
+    400: errorContent("Body must be `{ tree: AddressTree, opts? }`."),
+    503: errorContent("The resolver is not wired for this deployment (dependencies missing)."),
+};
+const reloadResponses = {
+    200: {
+        description: "Versioned data switchover result — the new per-shard version map.",
+        content: {
+            "application/json": { schema: z.looseObject({ reloaded: z.boolean(), versions: z.unknown() }) },
+        },
+    },
+    503: errorContent("The geocoding engine is not wired for this deployment (dependencies missing)."),
+};
+const formatResponses = {
+    200: {
+        description: "The rendered address string + the deterministic canonical match key.",
+        content: { "application/json": { schema: FormatResponseSchema } },
+    },
+    400: errorContent("Invalid request body."),
+};
+const healthResponses = {
+    200: {
+        description: "Liveness + engine health block. Answers 200 even when the engine is absent or broken.",
+        content: { "application/json": { schema: HealthResponseSchema } },
+    },
+};
+const metricsResponses = {
+    200: {
+        description: "The live in-process timing metrics snapshot (latency percentiles + per-tier counts).",
+        content: { "application/json": { schema: z.looseObject({}) } },
+    },
+};
+const parseGetRoute = createRoute({
+    method: "get",
+    path: "/v1/parse",
+    operationId: "parseGet",
+    summary: "Parse an address (query string)",
+    tags: ["parsing"],
+    request: { query: parseQueryParams },
+    responses: parseResponses,
+});
+const parsePostRoute = createRoute({
+    method: "post",
+    path: "/v1/parse",
+    operationId: "parsePost",
+    summary: "Parse an address (JSON body)",
+    tags: ["parsing"],
+    request: { body: { content: { "application/json": { schema: ParseRequestSchema } }, required: true } },
+    responses: parseResponses,
+});
+const geocodeRoute = createRoute({
+    method: "post",
+    path: "/v1/geocode",
+    operationId: "geocode",
+    summary: "Geocode an address to coordinates",
+    tags: ["geocoding"],
+    request: { body: { content: { "application/json": { schema: GeocodeRequestSchema } }, required: true } },
+    responses: geocodeResponses,
+});
+const batchRoute = createRoute({
+    method: "post",
+    path: "/v1/batch",
+    operationId: "batch",
+    summary: "Geocode a batch of addresses",
+    tags: ["geocoding"],
+    request: { body: { content: { "application/json": { schema: BatchRequestSchema } }, required: true } },
+    responses: batchResponses,
+});
+const resolveRoute = createRoute({
+    method: "post",
+    path: "/v1/resolve",
+    operationId: "resolve",
+    summary: "Resolve an already-decoded address tree against the gazetteer",
+    tags: ["resolving"],
+    request: { body: { content: { "application/json": { schema: ResolveRequestSchema } }, required: true } },
+    responses: resolveResponses,
+});
+const reloadRoute = createRoute({
+    method: "post",
+    path: "/v1/reload",
+    operationId: "reload",
+    summary: "Reload versioned data shards (deploy-only; gate at ingress)",
+    tags: ["meta"],
+    responses: reloadResponses,
+});
+const formatRoute = createRoute({
+    method: "post",
+    path: "/v1/format",
+    operationId: "format",
+    summary: "Render address components to a string + canonical match key",
+    tags: ["formatting"],
+    request: { body: { content: { "application/json": { schema: FormatRequestSchema } }, required: true } },
+    responses: formatResponses,
+});
+const healthRoute = createRoute({
+    method: "get",
+    path: "/health",
+    operationId: "health",
+    summary: "Liveness + engine health",
+    tags: ["meta"],
+    responses: healthResponses,
+});
+const metricsRoute = createRoute({
+    method: "get",
+    path: "/metrics",
+    operationId: "metrics",
+    summary: "In-process timing metrics snapshot",
+    tags: ["meta"],
+    responses: metricsResponses,
+});
+/**
+ * `components` accepts `string | string[]` per key on the wire (a caller may pass every span a multi-span match
+ * covered); `formatAddress`/`canonicalKey` want a single string per `ComponentTag`. Multi-span values collapse to their
+ * FIRST span here — the formatter template owns joining semantics, not this route.
+ */
+function toComponentDict(components) {
+    const out = {};
+    for (const [key, value] of Object.entries(components)) {
+        const first = Array.isArray(value) ? value[0] : value;
+        if (first !== undefined) {
+            out[key] = first;
+        }
+    }
+    return out;
+}
+/** Register the native `/v1` routes + `/health` + `/metrics` against an injected engine. */
+export function registerMailwomanAPIRoutes(app, engine, options = {}) {
+    const batchMax = options.batchMax ?? DEFAULT_BATCH_MAX;
+    app.openapi(parseGetRoute, async (c) => {
+        if (!engine.parse)
+            return c.json({ error: "parse not implemented" }, 501);
+        const address = c.req.query("address")?.trim();
+        if (!address)
+            return c.json({ error: "address is required" }, 400);
+        const debug = c.req.query("debug") === "true";
+        const outcome = await engine.parse(address, { debug });
+        return c.json(outcome, 200);
+    });
+    app.openapi(parsePostRoute, async (c) => {
+        if (!engine.parse)
+            return c.json({ error: "parse not implemented" }, 501);
+        const { address, debug } = c.req.valid("json");
+        const trimmed = address.trim();
+        if (!trimmed)
+            return c.json({ error: "address is required" }, 400);
+        const outcome = await engine.parse(trimmed, { debug: debug ?? false });
+        return c.json(outcome, 200);
+    }, (result, c) => {
+        if (!result.success)
+            return c.json({ error: "address is required" }, 400);
+        return undefined;
+    });
+    app.openapi(geocodeRoute, async (c) => {
+        if (!engine.geocode)
+            return apiError(c, 503, "geocoder not available", GEOCODER_UNAVAILABLE_DETAIL);
+        const { address } = c.req.valid("json");
+        const trimmed = address.trim();
+        if (!trimmed)
+            return c.json({ error: "address is required" }, 400);
+        const t0 = performance.now();
+        try {
+            const outcome = await engine.geocode(trimmed);
+            recordTimed(performance.now() - t0, String(outcome["resolution_tier"] ?? "admin"));
+            // `GeocodeOutcome` (the engine contract) is a deliberate `Record<string, unknown>` passthrough —
+            // `GeocodeOutcomeSchema` is now a REAL typed shape (doc-accuracy only, per its own docstring), so a
+            // local cast at this wire boundary is needed, matching the established idiom below (`/v1/resolve`'s
+            // `tree as unknown as AddressTree`) for "documented wire shape looser than the domain type".
+            return c.json(outcome, 200);
+        }
+        catch (error) {
+            recordTimed(performance.now() - t0, "error");
+            throw error;
+        }
+    }, (result, c) => {
+        if (!result.success)
+            return c.json({ error: "address is required" }, 400);
+        return undefined;
+    });
+    app.openapi(batchRoute, async (c) => {
+        const { addresses } = c.req.valid("json");
+        if (addresses.length === 0)
+            return c.json({ results: [] }, 200);
+        if (addresses.length > batchMax) {
+            return c.json({ error: `batch too large: ${addresses.length} > ${batchMax}` }, 413);
+        }
+        if (!engine.batch)
+            return apiError(c, 503, "geocoder not available", GEOCODER_UNAVAILABLE_DETAIL);
+        // Whole-call latency, recorded under the "batch" tier. Per-row tier metrics are the ENGINE's
+        // responsibility (phase 4b) — this app only times the call as a unit.
+        const t0 = performance.now();
+        try {
+            const outcome = await engine.batch(addresses);
+            recordTimed(performance.now() - t0, "batch");
+            // Same wire-vs-domain cast as `/v1/geocode` above — `BatchRow`'s `GeocodeOutcome` half is a
+            // `Record<string, unknown>` passthrough; `BatchResponseSchema` now types its `GeocodeOutcome` union
+            // member as the real shape.
+            return c.json(outcome, 200);
+        }
+        catch (error) {
+            recordTimed(performance.now() - t0, "error");
+            throw error;
+        }
+    }, (result, c) => {
+        if (!result.success)
+            return c.json({ error: "body must be { addresses: string[] }" }, 400);
+        return undefined;
+    });
+    app.openapi(resolveRoute, 
+    // Metrics are the ENGINE's responsibility here (phase 4b): the express predecessor recorded the
+    // street node's stamped resolution tier per call — the wired engine must carry that over, and
+    // must trim batch rows the same way (the route passes raw input through).
+    async (c) => {
+        if (!engine.resolveTree)
+            return apiError(c, 503, "resolver not available", GEOCODER_UNAVAILABLE_DETAIL);
+        const { tree, opts } = c.req.valid("json");
+        // The wire schema keeps `tree` loose (`{ roots: unknown[] }`, forward-compat) — a local cast at the
+        // boundary onto the engine's `AddressTree` contract, matching the established idiom (api-kit's
+        // `openapi.ts`, the drop-ins' response casts) for "documented wire shape looser than the domain type".
+        const outcome = await engine.resolveTree(tree, opts ?? {});
+        return c.json(outcome, 200);
+    }, (result, c) => {
+        if (!result.success)
+            return c.json({ error: "body must be { tree: AddressTree, opts? }" }, 400);
+        return undefined;
+    });
+    app.openapi(reloadRoute, async (c) => {
+        if (!engine.reload)
+            return apiError(c, 503, "geocoder not available", GEOCODER_UNAVAILABLE_DETAIL);
+        const outcome = await engine.reload();
+        return c.json(outcome, 200);
+    });
+    app.openapi(formatRoute, (c) => {
+        const { components, country, options: formatOptions } = c.req.valid("json");
+        const dict = toComponentDict(components);
+        const formatted = formatAddress(dict, country, formatOptions);
+        return c.json({ formatted, canonicalKey: canonicalKey(dict) }, 200);
+    });
+    app.openapi(healthRoute, (c) => {
+        const uptimeSeconds = Math.round((Date.now() - startedAt) / 1000);
+        return c.json({ status: "ok", uptime_s: uptimeSeconds, ...engine.health?.() }, 200);
+    });
+    app.openapi(metricsRoute, (c) => c.json(metricsSnapshot(), 200));
+}
+//# sourceMappingURL=routes.js.map

package/out/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAoB,CAAC,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAG3E,OAAO,EAAE,YAAY,EAAsB,aAAa,EAA6B,MAAM,sBAAsB,CAAA;AAGjH,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACrB,MAAM,aAAa,CAAA;AAEpB;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;AAE5B;;;;;GAKG;AACH,MAAM,2BAA2B,GAChC,mIAAmI,CAAA;AAQpI,MAAM,YAAY,GAAG,CAAC,WAAmB,EAAE,EAAE,CAAC,CAAC;IAC9C,WAAW;IACX,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE;CAC3D,CAAC,CAAA;AAEF,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;IAChF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC;CACjG,CAAC,CAAA;AAEF,MAAM,cAAc,GAAG;IACtB,GAAG,EAAE;QACJ,WAAW,EAAE,8CAA8C;QAC3D,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE;KAC/D;IACD,GAAG,EAAE,YAAY,CAAC,wBAAwB,CAAC;IAC3C,GAAG,EAAE,YAAY,CAAC,6DAA6D,CAAC;CAChF,CAAA;AAED,MAAM,gBAAgB,GAAG;IACxB,GAAG,EAAE;QACJ,WAAW,EAAE,wFAAwF;QACrG,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE;KACjE;IACD,GAAG,EAAE,YAAY,CAAC,wBAAwB,CAAC;IAC3C,GAAG,EAAE,YAAY,CAAC,+EAA+E,CAAC;CAClG,CAAA;AAED,MAAM,cAAc,GAAG;IACtB,GAAG,EAAE;QACJ,WAAW,EAAE,yEAAyE;QACtF,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE;KAChE;IACD,GAAG,EAAE,YAAY,CAAC,yCAAyC,CAAC;IAC5D,GAAG,EAAE,YAAY,CAAC,sDAAsD,CAAC;IACzE,GAAG,EAAE,YAAY,CAAC,+EAA+E,CAAC;CAClG,CAAA;AAED,MAAM,gBAAgB,GAAG;IACxB,GAAG,EAAE;QACJ,WAAW,EAAE,6EAA6E;QAC1F,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE,EAAE;KAClE;IACD,GAAG,EAAE,YAAY,CAAC,8CAA8C,CAAC;IACjE,GAAG,EAAE,YAAY,CAAC,uEAAuE,CAAC;CAC1F,CAAA;AAED,MAAM,eAAe,GAAG;IACvB,GAAG,EAAE;QACJ,WAAW,EAAE,mEAAmE;QAChF,OAAO,EAAE;YACR,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE;SAC/F;KACD;IACD,GAAG,EAAE,YAAY,CAAC,+EAA+E,CAAC;CAClG,CAAA;AAED,MAAM,eAAe,GAAG;IACvB,GAAG,EAAE;QACJ,WAAW,EAAE,sEAAsE;QACnF,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE;KACjE;IACD,GAAG,EAAE,YAAY,CAAC,uBAAuB,CAAC;CAC1C,CAAA;AAED,MAAM,eAAe,GAAG;IACvB,GAAG,EAAE;QACJ,WAAW,EAAE,uFAAuF;QACpG,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE;KACjE;CACD,CAAA;AAED,MAAM,gBAAgB,GAAG;IACxB,GAAG,EAAE;QACJ,WAAW,EAAE,sFAAsF;QACnG,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE;KAC9D;CACD,CAAA;AAED,MAAM,aAAa,GAAG,WAAW,CAAC;IACjC,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,UAAU;IACvB,OAAO,EAAE,iCAAiC;IAC1C,IAAI,EAAE,CAAC,SAAS,CAAC;IACjB,OAAO,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE;IACpC,SAAS,EAAE,cAAc;CACzB,CAAC,CAAA;AAEF,MAAM,cAAc,GAAG,WAAW,CAAC;IAClC,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,WAAW;IACxB,OAAO,EAAE,8BAA8B;IACvC,IAAI,EAAE,CAAC,SAAS,CAAC;IACjB,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IACtG,SAAS,EAAE,cAAc;CACzB,CAAC,CAAA;AAEF,MAAM,YAAY,GAAG,WAAW,CAAC;IAChC,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,mCAAmC;IAC5C,IAAI,EAAE,CAAC,WAAW,CAAC;IACnB,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IACxG,SAAS,EAAE,gBAAgB;CAC3B,CAAC,CAAA;AAEF,MAAM,UAAU,GAAG,WAAW,CAAC;IAC9B,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,OAAO;IACpB,OAAO,EAAE,8BAA8B;IACvC,IAAI,EAAE,CAAC,WAAW,CAAC;IACnB,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IACtG,SAAS,EAAE,cAAc;CACzB,CAAC,CAAA;AAEF,MAAM,YAAY,GAAG,WAAW,CAAC;IAChC,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,+DAA+D;IACxE,IAAI,EAAE,CAAC,WAAW,CAAC;IACnB,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IACxG,SAAS,EAAE,gBAAgB;CAC3B,CAAC,CAAA;AAEF,MAAM,WAAW,GAAG,WAAW,CAAC;IAC/B,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,QAAQ;IACrB,OAAO,EAAE,6DAA6D;IACtE,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,SAAS,EAAE,eAAe;CAC1B,CAAC,CAAA;AAEF,MAAM,WAAW,GAAG,WAAW,CAAC;IAC/B,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,QAAQ;IACrB,OAAO,EAAE,6DAA6D;IACtE,IAAI,EAAE,CAAC,YAAY,CAAC;IACpB,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IACvG,SAAS,EAAE,eAAe;CAC1B,CAAC,CAAA;AAEF,MAAM,WAAW,GAAG,WAAW,CAAC;IAC/B,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,QAAQ;IACrB,OAAO,EAAE,0BAA0B;IACnC,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,SAAS,EAAE,eAAe;CAC1B,CAAC,CAAA;AAEF,MAAM,YAAY,GAAG,WAAW,CAAC;IAChC,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,oCAAoC;IAC7C,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,SAAS,EAAE,gBAAgB;CAC3B,CAAC,CAAA;AAEF;;;;GAIG;AACH,SAAS,eAAe,CAAC,UAA6C;IACrE,MAAM,GAAG,GAAkB,EAAE,CAAA;IAE7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAErD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,GAAG,CAAC,GAAmB,CAAC,GAAG,KAAK,CAAA;QACjC,CAAC;IACF,CAAC;IAED,OAAO,GAAG,CAAA;AACX,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,0BAA0B,CACzC,GAAgB,EAChB,MAA0B,EAC1B,UAA6C,EAAE;IAE/C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAA;IAEtD,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACtC,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,GAAG,CAAC,CAAA;QACzE,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAA;QAE9C,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,GAAG,CAAC,CAAA;QAClE,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,MAAM,CAAA;QAC7C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QAEtD,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,GAAG,CAAC,OAAO,CACV,cAAc,EACd,KAAK,EAAE,CAAC,EAAE,EAAE;QACX,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,GAAG,CAAC,CAAA;QACzE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;QAE9B,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,GAAG,CAAC,CAAA;QAClE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,IAAI,KAAK,EAAE,CAAC,CAAA;QAEtE,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAC5B,CAAC,EACD,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,GAAG,CAAC,CAAA;QAEzE,OAAO,SAAS,CAAA;IACjB,CAAC,CACD,CAAA;IAED,GAAG,CAAC,OAAO,CACV,YAAY,EACZ,KAAK,EAAE,CAAC,EAAE,EAAE;QACX,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,2BAA2B,CAAC,CAAA;QACnG,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;QAE9B,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,GAAG,CAAC,CAAA;QAClE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAE5B,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YAC7C,WAAW,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,OAAO,CAAC,CAAC,CAAA;YAElF,iGAAiG;YACjG,oGAAoG;YACpG,oGAAoG;YACpG,6FAA6F;YAC7F,OAAO,CAAC,CAAC,IAAI,CAAC,OAA0D,EAAE,GAAG,CAAC,CAAA;QAC/E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,WAAW,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,CAAA;YAC5C,MAAM,KAAK,CAAA;QACZ,CAAC;IACF,CAAC,EACD,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,GAAG,CAAC,CAAA;QAEzE,OAAO,SAAS,CAAA;IACjB,CAAC,CACD,CAAA;IAED,GAAG,CAAC,OAAO,CACV,UAAU,EACV,KAAK,EAAE,CAAC,EAAE,EAAE;QACX,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAEzC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAA;QAE/D,IAAI,SAAS,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;YACjC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,oBAAoB,SAAS,CAAC,MAAM,MAAM,QAAQ,EAAE,EAAE,EAAE,GAAG,CAAC,CAAA;QACpF,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,OAAO,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,2BAA2B,CAAC,CAAA;QAEjG,6FAA6F;QAC7F,sEAAsE;QACtE,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAE5B,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YAC7C,WAAW,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,CAAA;YAE5C,4FAA4F;YAC5F,oGAAoG;YACpG,4BAA4B;YAC5B,OAAO,CAAC,CAAC,IAAI,CAAC,OAAyD,EAAE,GAAG,CAAC,CAAA;QAC9E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,WAAW,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,CAAA;YAC5C,MAAM,KAAK,CAAA;QACZ,CAAC;IACF,CAAC,EACD,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,EAAE,GAAG,CAAC,CAAA;QAE1F,OAAO,SAAS,CAAA;IACjB,CAAC,CACD,CAAA;IAED,GAAG,CAAC,OAAO,CACV,YAAY;IACZ,gGAAgG;IAChG,8FAA8F;IAC9F,0EAA0E;IAC1E,KAAK,EAAE,CAAC,EAAE,EAAE;QACX,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,2BAA2B,CAAC,CAAA;QACvG,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC1C,oGAAoG;QACpG,+FAA+F;QAC/F,uGAAuG;QACvG,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAA8B,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;QAEpF,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAC5B,CAAC,EACD,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,EAAE,GAAG,CAAC,CAAA;QAE/F,OAAO,SAAS,CAAA;IACjB,CAAC,CACD,CAAA;IAED,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACpC,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,2BAA2B,CAAC,CAAA;QAClG,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAA;QAErC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE;QAC9B,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC3E,MAAM,IAAI,GAAG,eAAe,CAAC,UAAU,CAAC,CAAA;QACxC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,aAAiD,CAAC,CAAA;QAEjG,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;IACpE,CAAC,CAAC,CAAA;IAEF,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE;QAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAA;QAEjE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAA;IACpF,CAAC,CAAC,CAAA;IAEF,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,CAAC,CAAC,CAAA;AACjE,CAAC"}

package/out/schema.d.ts

@@ -0,0 +1,177 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Zod wire schemas for the native `/v1` surface. Unlike the drop-ins (photon, nominatim,
+ *   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 (wired in Task 3) maps validation failures through the shared `APIErrorSchema`
+ *   envelope (`apiError(c, 400, "invalid request body", <zod summary>)`) — the documented pattern
+ *   boundary from phase 2: where no legacy contract exists, the validator MAY speak, but only in
+ *   our envelope.
+ *
+ *   `APIErrorSchema` itself is owned by `@mailwoman/api-kit` (plumbing shared by every native
+ *   surface) — it's re-exported here so route modules can import every schema they need, request
+ *   and error alike, from this one file.
+ */
+import { z } from "@hono/zod-openapi";
+export { APIErrorSchema } from "@mailwoman/api-kit";
+/** `POST /v1/parse` request body. */
+export declare const ParseRequestSchema: z.ZodObject<{
+    address: z.ZodString;
+    debug: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * `POST /v1/parse` response — a loose mirror of {@linkcode ParseOutcome} (`engine.ts`). `solutions` entries aren't fully
+ * modeled: `SerializedSolution` (`@mailwoman/core/solver`) carries the solver's internal match/classification detail,
+ * which is the engine's contract, not this wire schema's — `score`/`penalty` are the two fields every solution always
+ * carries (always-present numbers, cheap to pin accurately); `classifications`/`matches` stay loose passthrough.
+ */
+export declare const ParseOutcomeSchema: z.ZodObject<{
+    input: z.ZodObject<{
+        body: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$strip>;
+    solutions: z.ZodArray<z.ZodObject<{
+        score: z.ZodNumber;
+        penalty: z.ZodNumber;
+    }, z.core.$loose>>;
+    debug: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** `POST /v1/geocode` request body. */
+export declare const GeocodeRequestSchema: z.ZodObject<{
+    address: z.ZodString;
+}, z.core.$strip>;
+/**
+ * `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;
+    lat: z.ZodNullable<z.ZodNumber>;
+    lon: z.ZodNullable<z.ZodNumber>;
+    resolution_tier: z.ZodEnum<{
+        address_point: "address_point";
+        interpolated: "interpolated";
+        street: "street";
+        admin: "admin";
+    }>;
+    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>;
+    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>;
+    }, 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>>;
+}, z.core.$loose>;
+/** `POST /v1/batch` request body. */
+export declare const BatchRequestSchema: z.ZodObject<{
+    addresses: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/** `POST /v1/batch` response — one `GeocodeOutcome`, or an `{ input, error }` slot, per row (per-row isolation). */
+export declare const BatchResponseSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        input: z.ZodString;
+        lat: z.ZodNullable<z.ZodNumber>;
+        lon: z.ZodNullable<z.ZodNumber>;
+        resolution_tier: z.ZodEnum<{
+            address_point: "address_point";
+            interpolated: "interpolated";
+            street: "street";
+            admin: "admin";
+        }>;
+        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>;
+        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>;
+        }, 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>>;
+    }, z.core.$loose>, z.ZodObject<{
+        input: z.ZodString;
+        error: z.ZodString;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>;
+/**
+ * `POST /v1/resolve` request body — an already-decoded `AddressTree` (the parser's output) to resolve against the
+ * gazetteer.
+ */
+export declare const ResolveRequestSchema: z.ZodObject<{
+    tree: z.ZodObject<{
+        roots: z.ZodArray<z.ZodUnknown>;
+    }, z.core.$loose>;
+    opts: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$strip>;
+/** `POST /v1/resolve` response — the same tree, decorated in place with gazetteer coords + attribution. */
+export declare const ResolveResponseSchema: z.ZodObject<{
+    tree: z.ZodObject<{
+        roots: z.ZodArray<z.ZodUnknown>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+/**
+ * `POST /v1/format` request body. `components` accepts `string | string[]` per key on the wire — a handler-side
+ * concern, not this schema's: `@mailwoman/formatter`'s `ComponentDict` (`format.ts`) is `Partial<Record<ComponentTag,
+ * string>>`, single-string only, so a route handler must join array values before calling
+ * `formatAddress`/`canonicalKey`.
+ */
+export declare const FormatRequestSchema: z.ZodObject<{
+    components: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    country: z.ZodString;
+    options: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+}, z.core.$strip>;
+/** `POST /v1/format` response — the rendered string plus the deterministic canonical match key. */
+export declare const FormatResponseSchema: z.ZodObject<{
+    formatted: z.ZodString;
+    canonicalKey: z.ZodString;
+}, z.core.$strip>;
+/**
+ * `GET /health` response — `status`/`uptime_s` are stamped by the ROUTE itself, unconditionally, regardless of engine
+ * (`api/routes.ts`'s `healthRoute` handler: `{ status: "ok", uptime_s, ...engine.health?.() }`), so those two are cheap
+ * + accurate to pin. Everything else is `HealthData` (`api/engine.ts`) — an engine-defined block (model card, data-root
+ * inventory for `mailwoman serve`; something else entirely for another engine) — stays loose.
+ */
+export declare const HealthResponseSchema: z.ZodObject<{
+    status: z.ZodLiteral<"ok">;
+    uptime_s: z.ZodNumber;
+}, z.core.$loose>;
+//# sourceMappingURL=schema.d.ts.map

package/out/schema.d.ts.map

@@ -0,0 +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,qCAAqC;AACrC,eAAO,MAAM,kBAAkB;;;iBAKN,CAAA;AAEzB;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;iBAUN,CAAA;AAEzB,uCAAuC;AACvC,eAAO,MAAM,oBAAoB;;iBAIN,CAAA;AAiC3B;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBN,CAAA;AAE3B,qCAAqC;AACrC,eAAO,MAAM,kBAAkB;;iBAIN,CAAA;AAEzB,oHAAoH;AACpH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIN,CAAA;AAE1B;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;iBAKN,CAAA;AAE3B,2GAA2G;AAC3G,eAAO,MAAM,qBAAqB;;;;iBAIN,CAAA;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;iBAMN,CAAA;AAE1B,mGAAmG;AACnG,eAAO,MAAM,oBAAoB;;;iBAKN,CAAA;AAE3B;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;iBAMN,CAAA"}

package/out/schema.js

@@ -0,0 +1,168 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Zod wire schemas for the native `/v1` surface. Unlike the drop-ins (photon, nominatim,
+ *   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 (wired in Task 3) maps validation failures through the shared `APIErrorSchema`
+ *   envelope (`apiError(c, 400, "invalid request body", <zod summary>)`) — the documented pattern
+ *   boundary from phase 2: where no legacy contract exists, the validator MAY speak, but only in
+ *   our envelope.
+ *
+ *   `APIErrorSchema` itself is owned by `@mailwoman/api-kit` (plumbing shared by every native
+ *   surface) — it's re-exported here so route modules can import every schema they need, request
+ *   and error alike, from this one file.
+ */
+import { z } from "@hono/zod-openapi";
+export { APIErrorSchema } from "@mailwoman/api-kit";
+/** `POST /v1/parse` request body. */
+export const ParseRequestSchema = z
+    .object({
+    address: z.string(),
+    debug: z.boolean().optional(),
+})
+    .openapi("ParseRequest");
+/**
+ * `POST /v1/parse` response — a loose mirror of {@linkcode ParseOutcome} (`engine.ts`). `solutions` entries aren't fully
+ * modeled: `SerializedSolution` (`@mailwoman/core/solver`) carries the solver's internal match/classification detail,
+ * which is the engine's contract, not this wire schema's — `score`/`penalty` are the two fields every solution always
+ * carries (always-present numbers, cheap to pin accurately); `classifications`/`matches` stay loose passthrough.
+ */
+export const ParseOutcomeSchema = z
+    .object({
+    input: z.object({
+        body: z.string(),
+        start: z.number(),
+        end: z.number(),
+    }),
+    solutions: z.array(z.looseObject({ score: z.number(), penalty: z.number() })),
+    debug: z.string().optional(),
+})
+    .openapi("ParseOutcome");
+/** `POST /v1/geocode` request body. */
+export const GeocodeRequestSchema = z
+    .object({
+    address: z.string(),
+})
+    .openapi("GeocodeRequest");
+/**
+ * One `GeocodeOutcome.hierarchy` entry — locality → country, most specific first. `name` is the resolved gazetteer name
+ * (proper-cased canonical); `value` is the raw parsed span. Mirrors `GeocodeResult["hierarchy"]` entries
+ * (`mailwoman/geocode-core.ts`), hand-modeled — see {@link GeocodeOutcomeSchema} for the no-import rationale.
+ */
+const GeocodeHierarchyEntrySchema = z
+    .object({
+    tag: z.string(),
+    value: z.string(),
+    name: z.string(),
+    lat: z.number().optional(),
+    lon: z.number().optional(),
+    placeID: z.string().optional(),
+})
+    .openapi("GeocodeHierarchyEntry");
+/**
+ * One `GeocodeOutcome.candidates` entry — a ranked alternative place for the query's primary result (the winning place
+ * first, then same-query runner-ups). Mirrors `GeocodeResult["candidates"]` entries.
+ */
+const GeocodeCandidateSchema = z
+    .object({
+    name: z.string(),
+    tag: z.string(),
+    lat: z.number(),
+    lon: z.number(),
+    countryCode: z.string().nullable(),
+    placeID: z.string().optional(),
+})
+    .openapi("GeocodeCandidate");
+/**
+ * `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 = z
+    .object({
+    input: z.string(),
+    lat: z.number().nullable(),
+    lon: z.number().nullable(),
+    resolution_tier: z.enum(["address_point", "interpolated", "street", "admin"]),
+    uncertainty_m: z.number().nullable(),
+    locality: z.string().nullable(),
+    region: z.string().nullable(),
+    postcode: z.string().nullable(),
+    house_number: z.string().nullable(),
+    street: z.string().nullable(),
+    countryCode: z.string().nullable(),
+    hierarchy: z.array(GeocodeHierarchyEntrySchema),
+    candidates: z.array(GeocodeCandidateSchema),
+})
+    .loose()
+    .openapi("GeocodeOutcome");
+/** `POST /v1/batch` request body. */
+export const BatchRequestSchema = z
+    .object({
+    addresses: z.array(z.string()),
+})
+    .openapi("BatchRequest");
+/** `POST /v1/batch` response — one `GeocodeOutcome`, or an `{ input, error }` slot, per row (per-row isolation). */
+export const BatchResponseSchema = z
+    .object({
+    results: z.array(z.union([GeocodeOutcomeSchema, z.object({ input: z.string(), error: z.string() })])),
+})
+    .openapi("BatchResponse");
+/**
+ * `POST /v1/resolve` request body — an already-decoded `AddressTree` (the parser's output) to resolve against the
+ * gazetteer.
+ */
+export const ResolveRequestSchema = z
+    .object({
+    tree: z.looseObject({ roots: z.array(z.unknown()) }),
+    opts: z.looseObject({}).optional(),
+})
+    .openapi("ResolveRequest");
+/** `POST /v1/resolve` response — the same tree, decorated in place with gazetteer coords + attribution. */
+export const ResolveResponseSchema = z
+    .object({
+    tree: z.looseObject({ roots: z.array(z.unknown()) }),
+})
+    .openapi("ResolveResponse");
+/**
+ * `POST /v1/format` request body. `components` accepts `string | string[]` per key on the wire — a handler-side
+ * concern, not this schema's: `@mailwoman/formatter`'s `ComponentDict` (`format.ts`) is `Partial<Record<ComponentTag,
+ * string>>`, single-string only, so a route handler must join array values before calling
+ * `formatAddress`/`canonicalKey`.
+ */
+export const FormatRequestSchema = z
+    .object({
+    components: z.record(z.string(), z.union([z.string(), z.array(z.string())])),
+    country: z.string(),
+    options: z.looseObject({}).optional(),
+})
+    .openapi("FormatRequest");
+/** `POST /v1/format` response — the rendered string plus the deterministic canonical match key. */
+export const FormatResponseSchema = z
+    .object({
+    formatted: z.string(),
+    canonicalKey: z.string(),
+})
+    .openapi("FormatResponse");
+/**
+ * `GET /health` response — `status`/`uptime_s` are stamped by the ROUTE itself, unconditionally, regardless of engine
+ * (`api/routes.ts`'s `healthRoute` handler: `{ status: "ok", uptime_s, ...engine.health?.() }`), so those two are cheap
+ * + accurate to pin. Everything else is `HealthData` (`api/engine.ts`) — an engine-defined block (model card, data-root
+ * inventory for `mailwoman serve`; something else entirely for another engine) — stays loose.
+ */
+export const HealthResponseSchema = z
+    .object({
+    status: z.literal("ok"),
+    uptime_s: z.number(),
+})
+    .loose()
+    .openapi("HealthResponse");
+//# sourceMappingURL=schema.js.map

package/out/schema.js.map

@@ -0,0 +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,qCAAqC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KACjC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC;KACD,OAAO,CAAC,cAAc,CAAC,CAAA;AAEzB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KACjC,MAAM,CAAC;IACP,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;KACf,CAAC;IACF,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC;KACD,OAAO,CAAC,cAAc,CAAC,CAAA;AAEzB,uCAAuC;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KACnC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,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,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;CAC3C,CAAC;KACD,KAAK,EAAE;KACP,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAE3B,qCAAqC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KACjC,MAAM,CAAC;IACP,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC;KACD,OAAO,CAAC,cAAc,CAAC,CAAA;AAEzB,oHAAoH;AACpH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KAClC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;CACrG,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,2GAA2G;AAC3G,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;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KAClC,MAAM,CAAC;IACP,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5E,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,mGAAmG;AACnG,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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@mailwoman/api",
+  "version": "6.0.0",
+  "description": "The native Mailwoman HTTP API — engine-agnostic /v1 surface (parse, geocode, batch, resolve, format) with health, metrics, and an emitted OpenAPI document.",
+  "license": "AGPL-3.0-only OR LicenseRef-Commercial",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sister-software/mailwoman.git",
+    "directory": "api"
+  },
+  "files": [
+    "out/**/*.js",
+    "out/**/*.js.map",
+    "out/**/*.d.ts",
+    "out/**/*.d.ts.map",
+    "README.md"
+  ],
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./out/index.d.ts",
+      "default": "./out/index.js"
+    }
+  },
+  "publishConfig": {
+    "exports": {
+      "./package.json": "./package.json",
+      ".": {
+        "types": "./out/index.d.ts",
+        "default": "./out/index.js"
+      }
+    },
+    "access": "public"
+  },
+  "dependencies": {
+    "@hono/zod-openapi": "^1.4.0",
+    "@mailwoman/api-kit": "6.0.0",
+    "@mailwoman/core": "6.0.0",
+    "@mailwoman/formatter": "6.0.0",
+    "hono": "^4.12.29",
+    "zod": "^4.4.3"
+  }
+}