Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
/**
* http.js error boundary — database-unavailable degradation.
*
* A missing/rotated DATABASE_URL makes every DB-backed read reject. Two contracts
* keep that from turning into a log + alert + Sentry storm:
* 1. wrap() classifies the DB-down error as 503 (Retry-After) and does NOT emit
* the per-request `[api] unhandled` error line — it throttles to a warn.
* 2. serverError() coerces a DB-down error to 503 + Retry-After regardless of
* the caller's nominal status (sitemap/deployments pass 500/502).
*/
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
import { wrap, serverError, wrapCron } from '../api/_lib/http.js';
vi.mock('../api/_lib/alerts.js', () => ({
sendOpsAlert: async () => {},
}));
vi.mock('../api/_lib/cache.js', () => ({
cacheGet: async () => null,
cacheSet: async () => {},
}));
// Minimal ServerResponse stand-in: case-insensitive header store + end capture.
function fakeRes() {
const headers = {};
return {
statusCode: 0,
body: undefined,
ended: false,
headersSent: false,
writableEnded: false,
setHeader(k, v) { headers[String(k).toLowerCase()] = v; },
getHeader(k) { return headers[String(k).toLowerCase()]; },
end(b) { this.body = b; this.ended = true; this.writableEnded = true; },
_headers: headers,
};
}
function dbDownError() {
// The exact shape thrown by the env accessor when DATABASE_URL is absent.
return new Error('Missing required env var: DATABASE_URL');
}
function dbFullError() {
// The exact NeonDbError shape when the branch hits its project-size cap
// (SQLSTATE 53100). esbuild minifies the class name, so production matches on
// err.code / message — mirror both here.
const e = new Error('could not extend file because project size limit (512 MB) has been exceeded');
e.name = 'NeonDbError';
e.code = '53100';
return e;
}
let errSpy, warnSpy;
beforeEach(() => {
errSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
});
afterEach(() => {
errSpy.mockRestore();
warnSpy.mockRestore();
});
describe('wrap() under a DB outage', () => {
it('returns 503 + Retry-After and does not log [api] unhandled at error level', async () => {
const handler = wrap(async () => { throw dbDownError(); });
const res = fakeRes();
await handler({ method: 'GET', url: '/api/galaxy/flows', headers: {} }, res);
expect(res.statusCode).toBe(503);
expect(res.getHeader('retry-after')).toBe('30');
expect(JSON.parse(res.body).error).toBe('service_unavailable');
// No `[api] unhandled` error line — the outage is throttled to a warn instead.
const unhandled = errSpy.mock.calls.some((c) => String(c[0]).includes('[api] unhandled'));
expect(unhandled).toBe(false);
});
it('degrades a storage-cap failure (SQLSTATE 53100) to 503 + Retry-After, not a 500 storm', async () => {
const handler = wrap(async () => { throw dbFullError(); });
const res = fakeRes();
await handler({ method: 'GET', url: '/api/cron/smart-money-rollup', headers: {} }, res);
expect(res.statusCode).toBe(503);
expect(res.getHeader('retry-after')).toBe('30');
expect(JSON.parse(res.body).error).toBe('service_unavailable');
// No `[api] unhandled` error line / Sentry capture — throttled to a warn.
const unhandled = errSpy.mock.calls.some((c) => String(c[0]).includes('[api] unhandled'));
expect(unhandled).toBe(false);
});
it('still logs and 500s a genuine (non-DB) handler bug', async () => {
const handler = wrap(async () => { throw new Error('boom'); });
const res = fakeRes();
await handler({ method: 'GET', url: '/api/whatever', headers: {} }, res);
expect(res.statusCode).toBe(500);
const unhandled = errSpy.mock.calls.some((c) => String(c[0]).includes('[api] unhandled'));
expect(unhandled).toBe(true);
});
it('wrapCron() keeps the same db_unavailable degradation now that a time budget races the handler', async () => {
const handler = wrapCron(async () => { throw dbDownError(); }, { maxDurationMs: 30_000 });
const res = fakeRes();
await handler({ method: 'GET', url: '/api/cron/smart-money-rollup', headers: {} }, res);
// Still the pre-existing db_unavailable degradation (200, not the budget's
// 503 cron_timeout, and not wrap()'s generic 500): the race around the
// handler must never reclassify this path.
expect(res.statusCode).toBe(200);
expect(JSON.parse(res.body)).toMatchObject({ ok: false, reason: 'db_unavailable' });
const unhandled = errSpy.mock.calls.some((c) => String(c[0]).includes('[api] unhandled'));
expect(unhandled).toBe(false);
});
});
describe('serverError() under a DB outage', () => {
it('coerces a DB-down error to 503 + Retry-After regardless of the nominal status', () => {
const res = fakeRes();
serverError(res, 500, 'sitemap_failed', dbDownError());
expect(res.statusCode).toBe(503);
expect(res.getHeader('retry-after')).toBe('30');
expect(JSON.parse(res.body).error).toBe('service_unavailable');
// Reported as a throttled warn, not the `[server-error]` error line.
const serverErr = errSpy.mock.calls.some((c) => String(c[0]).includes('[server-error'));
expect(serverErr).toBe(false);
});
it('keeps a genuine 5xx as-is with the [server-error] log line', () => {
const res = fakeRes();
serverError(res, 502, 'pulse_failed', new Error('upstream exploded'));
expect(res.statusCode).toBe(502);
expect(JSON.parse(res.body).error).toBe('pulse_failed');
const serverErr = errSpy.mock.calls.some((c) => String(c[0]).includes('[server-error'));
expect(serverErr).toBe(true);
});
});