linktree-upgrade-migration

# Linktree Upgrade & Migration ## Overview Linktree provides a link-in-bio platform with APIs for managing profiles, links, and click analytics. The API exposes endpoints for CRUD operations on link trees, individual links, and analytics data. Tracking API changes is critical because Linktree's link schema evolves with new link types (commerce, scheduling, music), analytics response formats change with new metric dimensions, and profile customization fields expand — breaking integrations that sync link performance data to marketing dashboards or automate link management across multiple profiles. ## Version Detection ```typescript const LINKTREE_BASE = "https://api.linktr.ee/v1"; async function detectLinktreeApiVersion(apiKey: string): Promise<void> { const res = await fetch(`${LINKTREE_BASE}/profile`, { headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" }, }); const version = res.headers.get("x-linktree-api-version") ?? "v1"; console.log(`Linktree API version: ${version}`); // Check for deprecated link type fields const linksRes = await fetch(`${LINKTREE_BASE}/links`, { headers: { Authorization: `Bearer ${apiKey}` }, }); const data = await linksRes.json(); const knownTypes = ["classic", "header", "music", "video", "commerce", "scheduling"]; const activeTypes = [...new Set(data.links?.map((l: any) => l.type) ?? [])]; const unknown = activeTypes.filter((t: string) => !knownTypes.includes(t)); if (unknown.length...