feat(api): error + validate + pagination plumbing

Add lib/api/{errors,validate,pagination,index}.js: typed ApiError
subclasses, errorMiddleware, zod-backed validate(), parsePagination
with caps, and a mountApi() that owns /api routing + 404 + error tail.
server.js delegates /api to mountApi and drops the inline /api/spaces
smoke (returns in Task 2).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
root
2026-05-31 16:37:06 +10:00
parent 42d7f568a2
commit 75afedaef0
9 changed files with 254 additions and 15 deletions

48
lib/api/errors.js Normal file
View File

@@ -0,0 +1,48 @@
import { log } from '../log.js';
export class ApiError extends Error {
constructor(code, message, status, details) {
super(message);
this.code = code;
this.status = status;
this.details = details;
}
}
export class NotFoundError extends ApiError {
constructor(message = 'not found', details) {
super('not_found', message, 404, details);
}
}
export class ValidationError extends ApiError {
constructor(message = 'validation failed', details) {
super('validation_failed', message, 400, details);
}
}
export class ConflictError extends ApiError {
constructor(message = 'conflict', details) {
super('conflict', message, 409, details);
}
}
export class ForbiddenError extends ApiError {
constructor(message = 'forbidden', details) {
super('forbidden', message, 403, details);
}
}
export function asyncWrap(fn) {
return (req, res, next) => Promise.resolve(fn(req, res, next)).catch(next);
}
export function errorMiddleware(err, _req, res, _next) {
if (err instanceof ApiError) {
const body = { error: { code: err.code, message: err.message } };
if (err.details !== undefined) body.error.details = err.details;
return res.status(err.status).json(body);
}
log.error({ err }, 'unhandled');
res.status(500).json({ error: { code: 'internal', message: err.message } });
}