finta-upgrade-migration

# Finta Upgrade & Migration ## Overview Finta is a fundraising CRM built for founders managing investor pipelines, deal rooms, and investor updates. The API exposes endpoints for funding rounds, investor contacts, and deal room documents. Tracking API changes matters because Finta evolves its data model around fundraising workflows — field renames in round stages, investor contact schema updates, and deal room permission changes can break integrations that sync pipeline data to external analytics or reporting tools. ## Version Detection ```typescript const FINTA_BASE = "https://api.trustfinta.com/v1"; async function detectFintaApiVersion(apiKey: string): Promise<void> { const res = await fetch(`${FINTA_BASE}/rounds`, { headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" }, }); const data = await res.json(); const apiVersion = res.headers.get("x-finta-version") ?? "unknown"; console.log(`Finta API version: ${apiVersion}`); // Check for deprecated fields in round objects const knownFields = ["id", "name", "stage", "target_amount", "raised_amount", "investors", "created_at"]; if (data.rounds?.[0]) { const actual = Object.keys(data.rounds[0]); const deprecated = knownFields.filter((f) => !actual.includes(f)); const added = actual.filter((f) => !knownFields.includes(f)); if (deprecated.length) console.warn(`Removed fields: ${deprecated.join(", ")}`); if (added.length) console.log(`New fields: ${added.join("...