@absolutejs/edenv0.2.0betaDev ToolsUnwraps Eden Treaty failures into real Errors that keep the HTTP status, so 402, 409 and 500 stay distinguishable.
Tiny error helpers for Eden Treaty clients. Eden surfaces a failed call as { status, value }, and most call sites throw error.value — dropping the HTTP status so a 402 paywall, a 409 conflict and a 500 all look the same downstream. These helpers normalize any thrown value into a real Error that keeps .status, so error handling stays status-aware across the Elysia + Eden stack. Zero dependencies; works in the browser and on the server.
bun add @absolutejs/edenTiny error helpers for Eden Treaty clients. Eden surfaces a failed call as { status, value } — and most call sites throw error.value, dropping the HTTP status so a 402 paywall, a 409 conflict, and a 500 all look the same downstream. This fixes that.
apiError(error, fallback?) — normalize any thrown value (or an Eden
{ status, value }) into an Error that keeps .status.
apiErrorMessage(error, fallback?) — best-effort human message.
apiErrorStatus(error) — the HTTP status carried by an error, if any.
isPaywallError(error) — true for a 402 Payment Required.
List endpoints can share one bounded request/response contract without hiding their concrete database query:
CursorPage<T> is the corresponding envelope for stable keyset pagination. getPageCount, clampPageIndex, and getPageRange keep client pagination math consistent with the server contract.
Zero dependencies; works in the browser and on the server.
Apache-2.0
apiError(error, fallback?) normalizes any thrown value — or an Eden { status, value } — into an Error that keeps .status.
apiErrorMessage(error, fallback?) extracts a best-effort human-readable message from whatever was thrown.
apiErrorStatus(error) returns the HTTP status carried by an error, if any, so handlers can branch on 402 vs 409 vs 500.
isPaywallError(error) is true for a 402 Payment Required, making upgrade nudges a one-line check.
No dependencies and no runtime assumptions — the same helpers run in the browser and on the server.
Outcomes
Tiny error helpers for Eden Treaty clients. Eden surfaces a failed call as { status, value } — and most call sites throw error.value, dropping the HTTP status so a 402 paywall, a 409 conflict, and a 500 all look the same downstream. This fixes that.
apiError(error, fallback?) — normalize any thrown value (or an Eden
List endpoints can share one bounded request/response contract without hiding their concrete database query:
Hardening checklist
Follow in order
# @absolutejs/eden
import { apiError, isPaywallError } from "@absolutejs/eden";
const { data, error } = await api.things.get();
if (error) throw apiError(error); // a real Error that KEEPS error.status
// elsewhere
try {
await loadPremiumPanel();
} catch (e) {
if (isPaywallError(e)) showUpgradeNudge();
else showError(apiErrorMessage(e));
}List endpoints can share one bounded request/response contract without hiding their concrete database query:
import {
normalizeOffsetPage,
type OffsetPage,
} from "@absolutejs/eden";
const { limit, offset } = normalizeOffsetPage(request, {
defaultLimit: 25,
maxLimit: 100,
});
const response: OffsetPage<User> = { data: rows, total };Throw a status-preserving Error at the call site, then branch on the status wherever the error surfaces.
import {
apiError,
apiErrorMessage,
isPaywallError
} from '@absolutejs/eden';
const { data, error } = await api.things.get();
if (error) throw apiError(error); // a real Error that KEEPS error.status
// elsewhere
try {
await loadPremiumPanel();
} catch (e) {
if (isPaywallError(e)) showUpgradeNudge();
else showError(apiErrorMessage(e));
}Current package surface