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
// ─── Detail page for /discover/a/:chainId/:agentId and /discover/avatar/:id ──
const LIB_CDN_URL = 'https://three.ws/agent-3d/latest/agent-3d.js';
// Parse URL: /discover/a/{chainId}/{agentId} or /discover/avatar/{id}
function parseRoute() {
const path = location.pathname;
const solana = path.match(/^\/discover\/a\/sol\/([A-Za-z0-9]+)/);
if (solana) return { kind: 'solana', id: solana[1] };
const onchain = path.match(/^\/discover\/a\/(\d+)\/(\d+)/);
if (onchain) return { kind: 'onchain', chainId: onchain[1], id: onchain[2] };
const avatar = path.match(/^\/discover\/avatar\/([^/]+)/);
if (avatar) return { kind: 'avatar', id: avatar[1] };
return null;
}
// Agent art is whatever URL the registering party published: an IPFS URI, a
// gateway that may be rate-limiting, or a host that answers 404 with JSON (which
// the browser blocks as an opaque response). Cross-origin and decentralized art
// goes through the same-origin image proxy, which races live IPFS gateways and
// answers 204 when nothing renderable exists.
function heroImageURL(src) {
if (typeof src !== 'string' || !src) return '';
if (/^(ipfs|ar):\/\//i.test(src)) return `/api/img?${new URLSearchParams({ url: src, w: '640', fallback: 'none' })}`;
let url;
try {
url = new URL(src, location.href);
} catch {
return '';
}
if (url.origin === location.origin) return url.href;
if (url.protocol !== 'https:' && url.protocol !== 'http:') return '';
return `/api/img?${new URLSearchParams({ url: url.href, w: '640', fallback: 'none' })}`;
}
async function fetchItem(route) {
// SSR handler may have pre-loaded the item to avoid a round-trip
if (window.__DETAIL_ITEM__) return window.__DETAIL_ITEM__;
const params = new URLSearchParams({ kind: route.kind, id: route.id });
if (route.kind === 'onchain') params.set('chain', route.chainId);
const res = await fetch(`/api/explore-item?${params}`);
if (!res.ok) throw Object.assign(new Error('fetch failed'), { status: res.status });
const data = await res.json();
return data.item;
}
// Derive a smart back URL: restore the referrer if it was the discover page so
// filters and search state are not lost.
function backUrl() {
try {
const ref = document.referrer;
if (ref) {
const u = new URL(ref);
if (u.hostname === location.hostname && u.pathname === '/discover') {
return ref; // preserves ?q=, ?chain=, etc.
}
}
} catch (_) { /* ignore */ }
return '/discover';
}
function escapeHtml(s) {
return String(s ?? '')
.replace(/&/g, '&')
.replace(/</g, '<')
.replace(/>/g, '>')
.replace(/"/g, '"');
}
function escapeAttr(s) {
return escapeHtml(s).replace(/'/g, ''');
}
function shortAddr(a) {
if (!a || a.length < 10) return a || '';
return `${a.slice(0, 6)}…${a.slice(-4)}`;
}
function fmtDate(iso) {
if (!iso) return '—';
return new Date(iso).toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' });
}
// ─── Render ──────────────────────────────────────────────────────────────────
function render(item) {
const $ = (role) => document.querySelector(`[data-role="${role}"]`);
// Update document meta
document.title = `${item.name} · three.ws`;
const metaDesc = document.querySelector('meta[name="description"]');
if (metaDesc) metaDesc.content = item.description || `${item.name} on three.ws`;
// Smart back link
const backEl = $('back-link');
if (backEl) backEl.href = backUrl();
// Hero media
const media = $('hero-media');
const placeholder = () => {
const ph = document.createElement('div');
ph.className = 'detail-hero-ph';
ph.textContent = item.has3d ? '🎭' : '🤖';
return ph;
};
const heroSrc = heroImageURL(item.image);
if (heroSrc) {
const img = document.createElement('img');
img.alt = item.name;
// A dead or non-image source (204 from the proxy) swaps in the placeholder
// instead of leaving a broken-image icon in the hero.
img.addEventListener('error', () => img.replaceWith(placeholder()), { once: true });
img.src = heroSrc;
media.appendChild(img);
} else {
media.appendChild(placeholder());
}
const badges = $('badges');
if (item.kind === 'solana') {
badges.innerHTML = `
<span class="explore-badge explore-badge--solana">◎ Solana</span>
${item.has3d ? '<span class="explore-badge explore-badge--3d">3D</span>' : ''}
`;
} else if (item.kind === 'onchain') {
badges.innerHTML = `
<span class="explore-badge explore-badge--chain">${escapeHtml(item.chainName)}</span>
${item.has3d ? '<span class="explore-badge explore-badge--3d">3D</span>' : ''}
${item.x402Support ? '<span class="explore-badge explore-badge--x402">x402</span>' : ''}
`;
} else {
badges.innerHTML = `
<span class="explore-badge explore-badge--avatar">Public avatar</span>
<span class="explore-badge explore-badge--3d">3D</span>
${item.featured ? '<span class="explore-badge">Featured</span>' : ''}
`;
}
// Name + description
$('name').textContent = item.name;
const descEl = $('desc');
if (item.description) {
descEl.textContent = item.description;
descEl.hidden = false;
}
const metaRow = $('meta-row');
const metaItems = [];
if (item.kind === 'solana') {
if (item.owner) metaItems.push(`<span class="detail-meta-item">Owner <a href="${escapeAttr(item.ownerExplorerUrl || '#')}" target="_blank" rel="noopener">${escapeHtml(item.ownerShort)}</a></span>`);
if (item.createdAt) metaItems.push(`<span class="detail-meta-item">Registered ${fmtDate(item.createdAt)}</span>`);
if (item.skills?.length) metaItems.push(`<span class="detail-meta-item">${item.skills.length} skill${item.skills.length === 1 ? '' : 's'}</span>`);
} else if (item.kind === 'onchain') {
metaItems.push(`<span class="detail-meta-item">Agent #${escapeHtml(String(item.agentId))}</span>`);
metaItems.push(`<span class="detail-meta-item">Owner <a href="${escapeAttr(item.ownerExplorerUrl || '#')}" target="_blank" rel="noopener">${escapeHtml(item.ownerShort)}</a></span>`);
if (item.registeredAt) metaItems.push(`<span class="detail-meta-item">Registered ${fmtDate(item.registeredAt)}</span>`);
} else {
if (item.author) {
const authorLink = item.author.profileUrl
? `<a href="${escapeAttr(item.author.profileUrl)}">${escapeHtml(item.author.handle)}</a>`
: escapeHtml(item.author.handle);
metaItems.push(`<span class="detail-meta-item">By ${authorLink}</span>`);
}
if (item.createdAt) metaItems.push(`<span class="detail-meta-item">Added ${fmtDate(item.createdAt)}</span>`);
}
metaRow.innerHTML = metaItems.join('');
const actions = $('actions');
if (item.kind === 'solana') {
if (item.has3d && item.viewerUrl) {
actions.innerHTML += `<a class="detail-btn detail-btn--primary" href="${escapeAttr(item.viewerUrl)}">View 3D</a>`;
}
actions.innerHTML += `<a class="detail-btn detail-btn--ghost" href="${escapeAttr(item.explorerUrl || '#')}" target="_blank" rel="noopener">Solscan ↗</a>`;
} else if (item.kind === 'onchain') {
if (item.viewerUrl) {
actions.innerHTML += `<a class="detail-btn detail-btn--primary" href="${escapeAttr(item.viewerUrl)}">View 3D</a>`;
}
actions.innerHTML += `<a class="detail-btn detail-btn--ghost" href="${escapeAttr(item.tokenExplorerUrl || '#')}" target="_blank" rel="noopener">On-chain ↗</a>`;
} else {
actions.innerHTML += `<a class="detail-btn detail-btn--primary" href="${escapeAttr(item.viewerUrl || '#')}">View 3D</a>`;
}
// 3D viewer
if (item.has3d) {
const viewerWrap = $('viewer-wrap');
viewerWrap.hidden = false;
const viewer = $('viewer');
const script = document.createElement('script');
script.type = 'module';
script.src = LIB_CDN_URL;
document.head.appendChild(script);
if (item.kind === 'onchain' && item.chainId && item.agentId) {
const agentUri = `agent://${item.chainId}/${item.agentId}`;
viewer.innerHTML = `<agent-3d src="${escapeAttr(agentUri)}" mode="inline" responsive style="width:100%;height:100%"></agent-3d>`;
} else if (item.kind === 'avatar' && item.avatarId) {
// Use /api/avatars/:id — the agent-3d component resolves it as a manifest
const apiSrc = `${location.origin}/api/avatars/${encodeURIComponent(item.avatarId)}`;
viewer.innerHTML = `<agent-3d src="${escapeAttr(apiSrc)}" mode="inline" responsive style="width:100%;height:100%"></agent-3d>`;
}
}
// Services panel (onchain)
if (item.kind === 'onchain' && item.services?.length) {
const panel = $('services-panel');
panel.hidden = false;
$('service-count').textContent = String(item.services.length);
const list = $('services');
list.innerHTML = item.services
.map((s) => {
const endpointHtml = s.endpoint
? `<div class="detail-service-endpoint"><a href="${escapeAttr(s.endpoint)}" target="_blank" rel="noopener">${escapeHtml(s.endpoint)}</a></div>`
: '';
const versionHtml = s.version ? `<div class="detail-service-version">v${escapeHtml(s.version)}</div>` : '';
return `<li class="detail-service">
<div class="detail-service-name">${escapeHtml(s.name || 'Unnamed')}</div>
${endpointHtml}${versionHtml}
</li>`;
})
.join('');
}
// Tags panel (avatar)
if (item.kind === 'avatar' && item.tags?.length) {
const panel = $('tags-panel');
panel.hidden = false;
$('tags').innerHTML = item.tags.map((t) => `<span class="detail-tag">${escapeHtml(t)}</span>`).join('');
}
if (item.kind === 'solana') {
const panel = $('onchain-panel');
panel.hidden = false;
const dl = $('onchain-dl');
const rows = [
['Chain', 'Solana (mainnet)'],
['Mint', `<a href="${escapeAttr(item.explorerUrl || '#')}" target="_blank" rel="noopener">${escapeHtml(item.asset)}</a>`],
['Owner', `<a href="${escapeAttr(item.ownerExplorerUrl || '#')}" target="_blank" rel="noopener">${escapeHtml(item.owner)}</a>`],
['Registered', fmtDate(item.createdAt)],
];
if (item.skills?.length) {
rows.push(['Skills', item.skills.map((s) => escapeHtml(s)).join(', ')]);
}
dl.innerHTML = rows.map(([k, v]) => `<dt>${escapeHtml(k)}</dt><dd>${v}</dd>`).join('');
fetchSolanaReputation(item.asset, panel, dl);
fetchOnchainHistory({ asset: item.asset }, $);
}
if (item.kind === 'onchain') {
const panel = $('onchain-panel');
panel.hidden = false;
const dl = $('onchain-dl');
const rows = [
['Chain', `${escapeHtml(item.chainName)} (${escapeHtml(String(item.chainId))})`],
['Agent ID', `<a href="${escapeAttr(item.tokenExplorerUrl || '#')}" target="_blank" rel="noopener">#${escapeHtml(String(item.agentId))}</a>`],
['Owner', `<a href="${escapeAttr(item.ownerExplorerUrl || '#')}" target="_blank" rel="noopener">${escapeHtml(item.owner)}</a>`],
['Registered', fmtDate(item.registeredAt)],
];
if (item.registeredTx) {
const txUrl = item.explorerBase ? `${item.explorerBase}/tx/${item.registeredTx}` : '#';
rows.push(['Reg. tx', `<a href="${escapeAttr(txUrl)}" target="_blank" rel="noopener">${escapeHtml(shortAddr(item.registeredTx))}</a>`]);
}
dl.innerHTML = rows.map(([k, v]) => `<dt>${escapeHtml(k)}</dt><dd>${v}</dd>`).join('');
fetchOnchainHistory({ chain: item.chainId, id: item.agentId }, $);
}
// Avatar details panel
if (item.kind === 'avatar') {
const panel = $('avatar-panel');
panel.hidden = false;
const dl = $('avatar-dl');
const rows = [];
if (item.author) {
const authorLink = item.author.profileUrl
? `<a href="${escapeAttr(item.author.profileUrl)}">${escapeHtml(item.author.handle)}</a>`
: escapeHtml(item.author.handle);
rows.push(['Creator', authorLink]);
}
if (item.source) rows.push(['Source', escapeHtml(item.source)]);
rows.push(['Added', fmtDate(item.createdAt)]);
dl.innerHTML = rows.map(([k, v]) => `<dt>${escapeHtml(k)}</dt><dd class="detail-dl-normal">${v}</dd>`).join('');
}
// Embed panel
buildEmbedPanel(item, $);
// Show content, hide loading
$('loading').hidden = true;
$('content').hidden = false;
}
function buildEmbedPanel(item, $) {
const panel = $('embed-panel');
panel.hidden = false;
panel.classList.add('detail-panel--full');
const origin = location.origin;
let snippets;
if (item.kind === 'solana') {
const pageUrl = `${origin}/discover/a/sol/${item.asset}`;
const cardUrl = `${origin}/a/sol/${item.asset}/.well-known/agent-card.json`;
const name = item.name || 'Solana Agent';
snippets = [
{ label: 'Link', key: 'link', value: pageUrl, rows: 1 },
{ label: 'Agent card', key: 'card', value: cardUrl, rows: 1 },
{
label: 'Markdown',
key: 'md',
value: `[${name}](${pageUrl})`,
rows: 1,
},
];
} else if (item.kind === 'onchain') {
const pageUrl = `${origin}/a/${item.chainId}/${item.agentId}`;
const embedUrl = `${origin}/a/${item.chainId}/${item.agentId}/embed`;
const agentUri = `agent://${item.chainId}/${item.agentId}`;
const name = item.name || `Agent #${item.agentId}`;
snippets = [
{
label: 'Web component',
key: 'wc',
value: `<script type="module" src="${LIB_CDN_URL}"></script>\n<agent-3d src="${agentUri}" mode="inline" width="480px" responsive></agent-3d>`,
rows: 3,
},
{
label: 'iframe',
key: 'iframe',
value: `<iframe src="${embedUrl}" width="480" height="600" style="border:0;border-radius:12px" allow="autoplay; xr-spatial-tracking" sandbox="allow-scripts allow-same-origin allow-popups" title="${escapeHtml(name)}"></iframe>`,
rows: 3,
},
{ label: 'Link', key: 'link', value: pageUrl, rows: 1 },
{
label: 'Markdown',
key: 'md',
value: `[](${pageUrl})`,
rows: 2,
},
];
} else {
const detailUrl = `${origin}/avatars/${item.avatarId}`;
const name = item.name || 'Avatar';
const apiSrc = `${origin}/api/avatars/${item.avatarId}`;
snippets = [
{
label: 'Web component',
key: 'wc',
value: `<script type="module" src="${LIB_CDN_URL}"></script>\n<agent-3d src="${apiSrc}" mode="inline" width="480px" responsive></agent-3d>`,
rows: 3,
},
{
label: 'iframe',
key: 'iframe',
value: `<iframe src="${origin}/app#model=${encodeURIComponent(item.glbUrl)}" width="480" height="600" style="border:0;border-radius:12px" allow="autoplay; xr-spatial-tracking" title="${escapeHtml(name)}"></iframe>`,
rows: 3,
},
{ label: 'Link', key: 'link', value: detailUrl, rows: 1 },
{ label: 'GLB', key: 'glb', value: item.glbUrl, rows: 1 },
];
}
const tabsEl = $('embed-tabs');
const panesEl = $('embed-panes');
tabsEl.innerHTML = '';
panesEl.innerHTML = '';
snippets.forEach((s, i) => {
const tab = document.createElement('button');
tab.type = 'button';
tab.className = 'detail-embed-tab' + (i === 0 ? ' is-active' : '');
tab.textContent = s.label;
tab.dataset.tab = s.key;
tabsEl.appendChild(tab);
const pane = document.createElement('div');
pane.className = 'detail-embed-pane' + (i === 0 ? ' is-active' : '');
pane.dataset.pane = s.key;
pane.innerHTML = `
<textarea class="detail-embed-snippet" readonly rows="${s.rows}">${escapeHtml(s.value)}</textarea>
<button type="button" class="detail-embed-copy" data-copy-key="${s.key}">Copy</button>
`;
panesEl.appendChild(pane);
});
// Tab switching
tabsEl.addEventListener('click', (e) => {
const tab = e.target.closest('.detail-embed-tab');
if (!tab) return;
tabsEl.querySelectorAll('.detail-embed-tab').forEach((t) => t.classList.remove('is-active'));
panesEl.querySelectorAll('.detail-embed-pane').forEach((p) => p.classList.remove('is-active'));
tab.classList.add('is-active');
panesEl.querySelector(`[data-pane="${tab.dataset.tab}"]`)?.classList.add('is-active');
});
// Copy buttons
panesEl.addEventListener('click', (e) => {
const btn = e.target.closest('.detail-embed-copy');
if (!btn) return;
const key = btn.dataset.copyKey;
const textarea = panesEl.querySelector(`[data-pane="${key}"] textarea`);
if (!textarea) return;
const flash = (label) => {
const orig = btn.textContent;
btn.textContent = label;
setTimeout(() => { btn.textContent = orig; }, 1800);
};
Promise.resolve(navigator.clipboard?.writeText(textarea.value))
.then(() => flash('Copied!'))
.catch(() => {
// Clipboard API can reject (permissions, insecure context) — fall
// back to selecting the text so the user can copy manually.
textarea.focus();
textarea.select();
flash('Press ⌘C / Ctrl+C');
});
});
}
async function fetchSolanaReputation(asset, panel, dl) {
try {
const res = await fetch(`/api/agents/solana-reputation?asset=${encodeURIComponent(asset)}&network=mainnet`);
if (!res.ok) return;
const data = await res.json();
const rep = data.reputation;
if (!rep) return;
const extra = [];
if (rep.feedback?.total > 0) {
const avg = rep.feedback.score_avg != null ? Number(rep.feedback.score_avg).toFixed(1) : '—';
extra.push(['Feedback', `${avg} ★ · ${rep.feedback.total} review${rep.feedback.total === 1 ? '' : 's'} (${rep.feedback.unique_attesters} attester${rep.feedback.unique_attesters === 1 ? '' : 's'})`]);
}
if (rep.validation) {
const passed = (rep.validation.self_passed || 0) + (rep.validation.event_passed || 0);
const failed = (rep.validation.self_failed || 0) + (rep.validation.event_failed || 0);
if (passed + failed > 0) {
extra.push(['Validation', `${passed} passed · ${failed} failed`]);
}
}
if (rep.stake?.total_lamports > 0) {
const sol = (Number(rep.stake.total_lamports) / 1e9).toFixed(4);
extra.push(['Stake', `${sol} SOL from ${rep.stake.unique_stakers} staker${rep.stake.unique_stakers === 1 ? '' : 's'}`]);
}
if (rep.token_activity?.graduated) {
extra.push(['Token', `Graduated · ${rep.token_activity.trade_count || 0} trades`]);
}
if (extra.length) {
dl.innerHTML += '<dt style="grid-column:1/-1;border-top:1px solid rgba(255,255,255,0.06);padding-top:10px;margin-top:6px;font-size:10px;text-transform:uppercase;letter-spacing:0.1em;color:#888">Reputation</dt><dd style="display:none"></dd>';
dl.innerHTML += extra.map(([k, v]) => `<dt>${escapeHtml(k)}</dt><dd>${escapeHtml(v)}</dd>`).join('');
}
} catch (_) {}
}
// ─── On-chain history ────────────────────────────────────────────────────────
// Reads the platform's own cross-chain index (agent_onchain_events) rather than
// scanning an RPC in the browser, so an agent's registrations, token launches,
// reputation attestations, transfers and delegations render on one timeline for
// both Solana and EVM. Every row links to the transaction on a block explorer,
// so nothing here has to be taken on trust.
const HISTORY_CLASS_LABEL = {
registration: 'Registered',
metadata: 'Metadata',
transfer: 'Transfer',
token_launch: 'Token launch',
reputation: 'Reputation',
validation: 'Validation',
delegation: 'Delegation',
};
function fmtDateTime(iso) {
if (!iso) return '';
return new Date(iso).toLocaleString('en-US', {
year: 'numeric', month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit',
});
}
/**
* One line of human detail per event class, drawn from the indexed payload.
* Returns '' when the payload adds nothing the class name did not already say.
*/
function historyDetail(ev) {
const p = ev.payload || {};
if (ev.eventClass === 'token_launch' && p.mint) return p.mint;
if (ev.eventClass === 'transfer' && ev.counterparty) return `→ ${shortAddr(ev.counterparty)}`;
if (ev.eventClass === 'metadata' && p.key) return p.value ? `${p.key} = ${p.value}` : p.key;
if (ev.eventClass === 'reputation') {
if (p.value != null && p.valueDecimals != null) {
const scaled = Number(p.value) / 10 ** Number(p.valueDecimals);
return Number.isFinite(scaled) ? `${scaled} ${p.tag1 || ''}`.trim() : '';
}
if (p.score != null) return `${p.score} ★`;
}
if (ev.eventClass === 'metadata' && p.agentUri) return p.agentUri;
return '';
}
async function fetchOnchainHistory(query, $) {
const panel = $('history-panel');
if (!panel) return;
const list = $('history');
const foot = $('history-foot');
const params = new URLSearchParams(
Object.fromEntries(Object.entries(query).filter(([, v]) => v != null && v !== '')),
);
params.set('limit', '50');
let data;
try {
const res = await fetch(`/api/agents/onchain-history?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
data = await res.json();
} catch (_) {
// The index being unreachable is not the agent having no history, and
// saying so is the whole point of showing this panel at all.
panel.hidden = false;
list.innerHTML = '<li class="detail-history-empty">On-chain history is unavailable right now. Reload to try again.</li>';
return;
}
panel.hidden = false;
const events = Array.isArray(data.events) ? data.events : [];
$('history-count').textContent = String(events.length);
if (!events.length) {
// Three genuinely different states, and conflating them is how an outage
// gets read as "this agent has done nothing".
const lagState = data.indexLag || {};
list.innerHTML = lagState.error
? '<li class="detail-history-empty">The indexer could not read this agent on its last pass, so this list is not a statement about the agent. It retries automatically.</li>'
: lagState.crawled
? '<li class="detail-history-empty">No on-chain events recorded for this agent yet. The indexer has looked and found nothing beyond its registration.</li>'
: '<li class="detail-history-empty">This agent has not been crawled yet. Its history will appear here after the next indexer pass.</li>';
} else {
list.innerHTML = events
.map((ev) => {
const label = HISTORY_CLASS_LABEL[ev.eventClass] || ev.eventClass;
const detail = historyDetail(ev);
const link = ev.explorerUrl
? `<a class="detail-history-link" href="${escapeAttr(ev.explorerUrl)}" target="_blank" rel="noopener" title="${escapeAttr(ev.tx)}">${escapeHtml(shortAddr(ev.tx))} ↗</a>`
: '';
return `<li class="detail-history-row">
<time class="detail-history-when" datetime="${escapeAttr(ev.occurredAt)}">${escapeHtml(fmtDateTime(ev.occurredAt))}</time>
<span class="detail-history-what">
<span class="detail-history-class" data-class="${escapeAttr(ev.eventClass)}">${escapeHtml(label)}</span>
<span>${escapeHtml(ev.eventName)}</span>
${detail ? `<span class="detail-history-detail">${escapeHtml(detail)}</span>` : ''}
</span>
${link}
</li>`;
})
.join('');
}
// Freshness is part of the answer: "no events" from an index last updated
// four hours ago means something different from the same answer live.
const lag = data.indexLag || {};
if (!lag.crawled) {
foot.textContent = 'Not yet crawled by the agent indexer.';
} else if (lag.error) {
foot.textContent = `Indexer last reported: ${lag.error}`;
} else if (lag.lagMinutes != null) {
foot.textContent =
lag.lagMinutes < 1
? 'Index up to date as of less than a minute ago.'
: `Index last updated ${lag.lagMinutes} minute${lag.lagMinutes === 1 ? '' : 's'} ago.`;
} else {
foot.textContent = '';
}
}
function showError(status, onRetry) {
const $ = (role) => document.querySelector(`[data-role="${role}"]`);
$('loading').hidden = true;
$('error').hidden = false;
const retryBtn = $('error-retry');
if (status === 404) {
$('error-title').textContent = 'Not found';
$('error-msg').textContent = 'This item does not exist or has been removed.';
// 404 is terminal — retry won't help. Offer only "Back to Discover".
if (retryBtn) retryBtn.hidden = true;
} else {
$('error-title').textContent = 'Something went wrong';
$('error-msg').textContent = 'Could not load this item. Check your connection and try again.';
if (retryBtn && typeof onRetry === 'function') {
retryBtn.hidden = false;
retryBtn.onclick = onRetry;
}
}
}
// ─── Boot ─────────────────────────────────────────────────────────────────────
(async function init() {
const route = parseRoute();
if (!route) {
showError(404);
return;
}
async function load() {
const $ = (role) => document.querySelector(`[data-role="${role}"]`);
$('error').hidden = true;
$('loading').hidden = false;
try {
const item = await fetchItem(route);
render(item);
} catch (err) {
showError(err.status || 500, load);
}
}
load();
})();