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
// Coverage for api/trenches.js, the read-only proxy in front of services/pulse.
// Hard requirement: never fabricate market data. Unconfigured or failing
// upstream is always 503 pulse_offline; only allowlisted views and params pass.
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
vi.mock('../api/_lib/http.js', () => ({
wrap: (fn) => fn,
cors: () => false,
method: () => true,
rateLimited: (res) => {
res._json = { status: 429, body: { error: 'rate_limited' } };
return res;
},
json: (res, status, body, headers = {}) => {
res._json = { status, body, headers };
return res;
},
}));
vi.mock('../api/_lib/rate-limit.js', () => ({
limits: { marketDataIp: vi.fn(async () => ({ success: true })) },
clientIp: () => '1.2.3.4',
}));
const { default: handler } = await import('../api/trenches.js');
const { limits } = await import('../api/_lib/rate-limit.js');
const call = (url) => {
const res = { setHeader() {}, end() {}, statusCode: 200 };
return handler({ method: 'GET', url, headers: {} }, res).then(() => res._json);
};
const ORIGINAL = process.env.PULSE_URL;
const originalFetch = global.fetch;
beforeEach(() => {
limits.marketDataIp.mockResolvedValue({ success: true });
process.env.PULSE_URL = 'https://pulse.example.test';
global.fetch = vi.fn();
});
afterEach(() => {
if (ORIGINAL === undefined) delete process.env.PULSE_URL;
else process.env.PULSE_URL = ORIGINAL;
global.fetch = originalFetch;
});
describe('api/trenches', () => {
it('503s pulse_offline when PULSE_URL is unset', async () => {
delete process.env.PULSE_URL;
const r = await call('/api/trenches?view=overview');
expect(r.status).toBe(503);
expect(r.body.error).toBe('pulse_offline');
expect(global.fetch).not.toHaveBeenCalled();
});
it('rejects unknown views with 400', async () => {
const r = await call('/api/trenches?view=../../etc/passwd');
expect(r.status).toBe(400);
expect(global.fetch).not.toHaveBeenCalled();
});
it('forwards only allowlisted params to the mapped upstream path', async () => {
global.fetch.mockResolvedValue({ ok: true, json: async () => ({ total: 0, rows: [] }) });
const r = await call('/api/trenches?view=tokens&chain=solana&limit=5&secret=1');
const upstream = global.fetch.mock.calls[0][0];
expect(upstream.pathname).toBe('/api/tokens');
expect(upstream.searchParams.get('chain')).toBe('solana');
expect(upstream.searchParams.get('limit')).toBe('5');
expect(upstream.searchParams.has('secret')).toBe(false);
expect(r.status).toBe(200);
expect(r.body).toEqual({ total: 0, rows: [] });
});
it('503s on non-2xx upstream and on network failure, never with data', async () => {
global.fetch.mockResolvedValueOnce({ ok: false, status: 500 });
expect((await call('/api/trenches?view=launches')).body.error).toBe('pulse_offline');
global.fetch.mockRejectedValueOnce(new Error('ECONNREFUSED'));
const r = await call('/api/trenches?view=launches');
expect(r.status).toBe(503);
expect(r.headers['cache-control']).toBe('no-store');
});
it('honours the rate limit', async () => {
limits.marketDataIp.mockResolvedValue({ success: false });
expect((await call('/api/trenches?view=overview')).status).toBe(429);
});
});