@pithy-sh/core 0.1.2 → 0.1.3

package/dist/error/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/error/http.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA8BpB,CAAC;AAeH;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAG,QAAQ,CAUlE"}

package/dist/error/http.js

@@ -0,0 +1,72 @@
+import { ErrorPayload, PublicErrorPayload } from "./payload.js";
+import { InternalError, PithyError, ValidationError, messageOf } from "./pithyError.js";
+import { clientError } from "./client.js";
+import { z } from "zod";
+import { HTTPException } from "hono/http-exception";
+//#region src/error/http.ts
+/**
+* The HTTP surface of an error, as a real codec. `encode` (server emits) maps an in-memory
+* `ErrorPayload` down to the public wire shape by calling {@link clientError} — **the security
+* boundary, which drops `action` and `detail`, so neither an operator's remedy nor internal context
+* can land in an HTTP body.** `decode` (client SDK parses) maps a wire body back to a payload. The one
+* schema validates both directions, so the error a server sends and the error an app receives are the
+* same contract.
+*
+* **`action` is stripped because it is written for an operator, not for a caller.** It names `pithy`
+* commands, files in the adopter's repository, wrangler bindings and provider consoles — a
+* description of the deployment, handed out at whatever status the error carries. The operator reads
+* it on the surfaces built for them: the terminal, the CLI's `--json` line, a log, an audit row. What
+* the caller gets is `message`, which is the field that has always meant "safe to expose".
+*
+* **The rule is not kept here.** HTTP is one transport of several — a WebSocket frame is a client
+* surface that never touches this codec — so the projection lives in ./client and this encoder is one
+* of its callers. Doing it the other way round is what let an `action` reach a browser over a socket.
+*/
+const HttpError = z.codec(PublicErrorPayload, ErrorPayload, {
+	decode: (wire) => wire,
+	encode: (payload, result) => {
+		try {
+			return clientError(payload);
+		} catch (error) {
+			if (error instanceof z.core.$ZodError) for (const issue of error.issues) result.issues.push({
+				...issue,
+				input: void 0
+			});
+			else result.issues.push({
+				code: "custom",
+				input: void 0,
+				message: messageOf(error)
+			});
+			return z.NEVER;
+		}
+	}
+});
+/**
+* Hono's own 400s are the caller's fault, not ours. `hono/validator` throws `HTTPException(400)`
+* for a body it cannot even parse — a malformed JSON document, a malformed multipart form — before
+* any schema runs, so no validator hook ever sees it. Left alone it would fall through to the
+* generic wrap below and answer a bad request with a 500. Only 400 is translated: every other
+* `HTTPException` is a framework condition we have no public wording for, and guessing one would
+* put Hono's internal text on the wire.
+*/
+function fromHttpException(error) {
+	if (error.status !== 400) return null;
+	return new ValidationError({
+		message: "The request body could not be parsed.",
+		detail: error.message
+	});
+}
+/**
+* Hono `onError` handler. Register once on the root app (`app.onError(pithyErrorHandler)`): any
+* `PithyError` becomes `{ error: <public payload> }` at its declared status; a Hono `HTTPException`
+* 400 becomes `validation/invalid_input`; any other throw is wrapped as a `core/internal` 500
+* carrying the original as `cause` (kept internal) and a generic public message — mirroring the
+* CLI's "unexpected crash" path.
+*/
+function pithyErrorHandler(err, c) {
+	const translated = err instanceof HTTPException ? fromHttpException(err) : null;
+	const pithy = err instanceof PithyError ? err : translated ?? new InternalError({ detail: err instanceof Error ? err.message : String(err) }, { cause: err });
+	return c.json({ error: HttpError.encode(pithy.payload) }, pithy.payload.status);
+}
+//#endregion
+export { HttpError, pithyErrorHandler };