Kernel

@caisson/kernel is the shared spine every package imports. It defines a typed CaissonError hierarchy — each failure has a stable, documented shape instead of an ad-hoc string — and hosts the one standards/conformance gate every package ships through.

The contract

Two error shapes are load-bearing across the base:

• The credit gate raises a 402 with a documented body, not a bare 500.
• A tenancy denial returns 404, not 403 — refusing to confirm a row exists is the policy. There is no existence leak to probe.

import { InsufficientCreditsError, NotFoundError } from "@caisson/kernel";

// 402 — the credit gate. Documented body, never a bare 500.
throw new InsufficientCreditsError({ required: 1, available: 0 });

// Tenancy denial → 404. We never confirm the row exists.
throw new NotFoundError();

The 402 carries a stable, machine-readable body so an agent can react to it:

// HTTP 402
{ "error": "insufficient_credits", "required": 1, "available": 0 }

A package becomes part of the base only by passing the one gate:

$ bun run check   # build · lint · test — every package, one gate

Related