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
// The guard that keeps every outbound third-party call bounded. Its own logic
// is worth testing: a checker that silently stops catching things is worse than
// no checker, because the gate keeps passing while the protection erodes.
import { describe, it, expect } from 'vitest';
import { scanFile } from '../scripts/check-fetch-timeouts.mjs';
const scan = (src) => scanFile('x.js', src);
describe('check-fetch-timeouts', () => {
it('flags an external fetch with no deadline', () => {
const out = scan(`const r = await fetch('https://api.example.com/v1/thing', { method: 'POST' });`);
expect(out).toHaveLength(1);
expect(out[0].line).toBe(1);
});
it('accepts a signal passed as the LAST key of a long options object', () => {
// The window this replaced was fixed-size, so a call whose options ran
// past it was reported as unbounded precisely when it was hardest to read.
const body = Array.from({ length: 24 }, (_, i) => `\t\t\tfield${i}: ${i},`).join('\n');
const out = scan([
`const res = await fetch(URL_CONST, {`,
`\tmethod: 'POST',`,
`\tbody: JSON.stringify({`,
body,
`\t}),`,
`\tsignal: controller.signal,`,
`});`,
`const URL_CONST = 'https://api.example.com/x';`,
].join('\n'));
expect(out).toEqual([]);
});
it('accepts AbortSignal.timeout and the shared wrappers', () => {
expect(scan(`await fetch('https://a.example/x', { signal: AbortSignal.timeout(5000) });`)).toEqual([]);
expect(scan(`await fetchUpstream('https://a.example/x', {}, { timeoutMs: 5000 });`)).toEqual([]);
expect(scan(`await pumpFetchJson('https://frontend-api-v3.pump.fun/coins/x');`)).toEqual([]);
});
it('resolves an external URL held in a const', () => {
const src = [
`const BASE = 'https://api.example.com';`,
`const r = await fetch(\`\${BASE}/thing\`, { method: 'GET' });`,
].join('\n');
expect(scan(src)).toHaveLength(1);
});
it('ignores same-origin and relative calls, which are a different concern', () => {
expect(scan(`await fetch('/api/thing');`)).toEqual([]);
expect(scan(`await fetch('https://three.ws/api/thing');`)).toEqual([]);
expect(scan(`const B = 'http://localhost:3000';\nawait fetch(\`\${B}/x\`);`)).toEqual([]);
});
it('ignores stubs, definitions and commented-out code', () => {
expect(scan(`globalThis.fetch = vi.fn(async () => new Response());`)).toEqual([]);
expect(scan(`// await fetch('https://api.example.com/x');`)).toEqual([]);
expect(scan(`\t * await fetch('https://api.example.com/x');`)).toEqual([]);
});
it('reports the file and line so the message is actionable', () => {
const out = scan(`const a = 1;\nconst b = 2;\nawait fetch('https://api.example.com/x');`);
expect(out[0]).toMatchObject({ file: 'x.js', line: 3 });
expect(out[0].code).toContain('api.example.com');
});
});
// Under api/ the rule is wider: a handler calling its own origin opens a real
// socket between two instances, and the URLs that hang most often (a provider's
// delivery URL, a worker artifact) only exist at runtime, so neither is visible
// to a scan for literal hosts.
describe('check-fetch-timeouts under api/', () => {
const scanApi = (src) => scanFile('api/thing.js', src);
it('flags a same-origin self-call with no deadline', () => {
const out = scanApi(`const r = await fetch(\`\${origin}/api/forge\`, { method: 'POST' });`);
expect(out).toHaveLength(1);
});
it('flags a fetch of a URL only known at runtime', () => {
expect(scanApi(`const resp = await fetch(sourceUrl);`)).toHaveLength(1);
});
it('accepts the same call once it is bounded', () => {
expect(scanApi(`const resp = await fetch(sourceUrl, { signal: AbortSignal.timeout(9000) });`)).toEqual([]);
expect(scanApi(`const resp = await fetchUpstream(sourceUrl, {}, { timeoutMs: 9000 });`)).toEqual([]);
});
it('accepts an init object assembled further up the function', () => {
const src = [
`const init = { method, headers, signal: AbortSignal.timeout(timeoutMs) };`,
`if (body != null) init.body = JSON.stringify(body);`,
`const a = 1;`,
`const b = 2;`,
`const c = 3;`,
`const d = 4;`,
`const e = 5;`,
`const upstream = await fetch(url, init);`,
].join('\n');
expect(scanApi(src)).toEqual([]);
});
it('accepts a wrapper that passes its caller\'s init straight through', () => {
// The deadline belongs to the caller; imposing a second one here would
// silently shorten it.
expect(scanApi(`const res = await fetch(url.toString(), { ...init, redirect: 'manual' });`)).toEqual([]);
});
it('ignores a data: URL and a client snippet quoted as a string', () => {
expect(scanApi(`const buf = await (await fetch('data:application/octet-stream;base64,' + b64)).arrayBuffer();`)).toEqual([]);
expect(scanApi(`\t\t"const _r = await fetch('/api/mcp', {",`)).toEqual([]);
});
it('leaves browser code judged on external hosts only', () => {
expect(scanFile('src/page.js', `await fetch('/api/thing');`)).toEqual([]);
expect(scanFile('src/page.js', `await fetch(someUrl);`)).toEqual([]);
});
});