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
import { describe, it, expect, vi } from 'vitest';
// Mock db.js to prevent DB connection on import
vi.mock('../../api/_lib/db.js', () => ({ sql: vi.fn(), isDbUnavailableError: () => false, isDbCapacityError: () => false }));
import {
defaultEmbedPolicy,
normalizeLegacyPolicy,
validateEmbedPolicy,
POLICY_VERSION,
} from '../../api/_lib/embed-policy.js';
describe('defaultEmbedPolicy', () => {
it('returns a policy with version 1', () => {
const p = defaultEmbedPolicy();
expect(p.version).toBe(1);
expect(p.version).toBe(POLICY_VERSION);
});
it('has allowlist mode with empty hosts', () => {
const p = defaultEmbedPolicy();
expect(p.origins.mode).toBe('allowlist');
expect(p.origins.hosts).toEqual([]);
});
it('has all surfaces enabled except mcp', () => {
const p = defaultEmbedPolicy();
expect(p.surfaces.script).toBe(true);
expect(p.surfaces.iframe).toBe(true);
expect(p.surfaces.widget).toBe(true);
expect(p.surfaces.mcp).toBe(false);
});
it('brain defaults to we-pay mode', () => {
const p = defaultEmbedPolicy();
expect(p.brain.mode).toBe('we-pay');
expect(p.brain.proxy_url).toBeNull();
expect(p.brain.monthly_quota).toBe(1000);
expect(p.brain.rate_limit_per_min).toBe(10);
});
it('storage defaults to r2', () => {
const p = defaultEmbedPolicy();
expect(p.storage.primary).toBe('r2');
expect(p.storage.pinned_ipfs).toBe(false);
expect(p.storage.onchain_attested).toBe(false);
});
});
describe('normalizeLegacyPolicy', () => {
it('returns default policy for null input', () => {
const result = normalizeLegacyPolicy(null);
expect(result).toEqual(defaultEmbedPolicy());
});
it('returns default policy for undefined input', () => {
const result = normalizeLegacyPolicy(undefined);
expect(result).toEqual(defaultEmbedPolicy());
});
it('handles legacy format (has mode/hosts at root, no version/origins)', () => {
const legacy = { mode: 'denylist', hosts: ['evil.com', 'bad.io'] };
const result = normalizeLegacyPolicy(legacy);
expect(result.origins.mode).toBe('denylist');
expect(result.origins.hosts).toEqual(['evil.com', 'bad.io']);
expect(result.version).toBe(POLICY_VERSION);
// surfaces/brain/storage should come from defaults
expect(result.surfaces).toEqual(defaultEmbedPolicy().surfaces);
});
it('merges partial origins into defaults', () => {
const partial = { origins: { mode: 'denylist', hosts: ['x.com'] } };
const result = normalizeLegacyPolicy(partial);
expect(result.origins.mode).toBe('denylist');
expect(result.origins.hosts).toEqual(['x.com']);
});
it('merges partial surfaces into defaults', () => {
const partial = { surfaces: { mcp: true } };
const result = normalizeLegacyPolicy(partial);
expect(result.surfaces.mcp).toBe(true);
expect(result.surfaces.iframe).toBe(true); // from default
});
it('merges partial brain config into defaults', () => {
const partial = { brain: { mode: 'none' } };
const result = normalizeLegacyPolicy(partial);
expect(result.brain.mode).toBe('none');
expect(result.brain.monthly_quota).toBe(1000); // from default
});
});
describe('validateEmbedPolicy', () => {
it('accepts a valid full policy', () => {
const policy = {
origins: { mode: 'allowlist', hosts: ['example.com'] },
surfaces: { script: true, iframe: false, widget: true, mcp: false },
brain: {
mode: 'we-pay',
proxy_url: null,
monthly_quota: 500,
rate_limit_per_min: 5,
model: 'claude-sonnet-4-6',
},
storage: { primary: 'r2', pinned_ipfs: false, onchain_attested: false },
};
const result = validateEmbedPolicy(policy);
expect(result.origins.mode).toBe('allowlist');
expect(result.origins.hosts).toEqual(['example.com']);
});
it('requires proxy_url when brain.mode is key-proxy', () => {
const policy = {
origins: { mode: 'allowlist', hosts: [] },
surfaces: { script: true, iframe: true, widget: true, mcp: false },
brain: {
mode: 'key-proxy',
proxy_url: null, // invalid — key-proxy needs a URL
monthly_quota: null,
rate_limit_per_min: null,
model: 'claude-sonnet-4-6',
},
storage: { primary: 'r2', pinned_ipfs: false, onchain_attested: false },
};
expect(() => validateEmbedPolicy(policy)).toThrow();
});
it('accepts key-proxy with valid proxy_url', () => {
const policy = {
origins: { mode: 'allowlist', hosts: [] },
surfaces: { script: true, iframe: true, widget: true, mcp: false },
brain: {
mode: 'key-proxy',
proxy_url: 'https://proxy.example.com',
monthly_quota: null,
rate_limit_per_min: null,
model: 'claude-sonnet-4-6',
},
storage: { primary: 'r2', pinned_ipfs: false, onchain_attested: false },
};
const result = validateEmbedPolicy(policy);
expect(result.brain.mode).toBe('key-proxy');
});
it('rejects invalid origin mode', () => {
const policy = {
origins: { mode: 'wildcard', hosts: [] }, // invalid
surfaces: { script: true, iframe: true, widget: true, mcp: false },
brain: {
mode: 'we-pay',
proxy_url: null,
monthly_quota: null,
rate_limit_per_min: null,
model: 'claude-sonnet-4-6',
},
storage: { primary: 'r2', pinned_ipfs: false, onchain_attested: false },
};
expect(() => validateEmbedPolicy(policy)).toThrow();
});
it('rejects more than 100 hosts', () => {
const policy = {
origins: {
mode: 'allowlist',
hosts: Array.from({ length: 101 }, (_, i) => `host${i}.com`),
},
surfaces: { script: true, iframe: true, widget: true, mcp: false },
brain: {
mode: 'we-pay',
proxy_url: null,
monthly_quota: null,
rate_limit_per_min: null,
model: 'claude-sonnet-4-6',
},
storage: { primary: 'r2', pinned_ipfs: false, onchain_attested: false },
};
expect(() => validateEmbedPolicy(policy)).toThrow();
});
});