miro-upgrade-migration

# Miro Upgrade & Migration ## Overview Guide for migrating from Miro REST API v1 to v2, upgrading the `@mirohq/miro-api` SDK, and handling the key breaking changes between versions. ## Key Breaking Changes: v1 to v2 ### Terminology Changes | v1 Term | v2 Term | Notes | |---------|---------|-------| | Widget | Item | All board elements renamed | | Line | Connector | Lines renamed, gained captions and snapTo | | Sticker | Sticky Note | Type value: `sticky_note` | | Widget API (polymorphic) | Per-type endpoints | No more universal create endpoint | | `text` property | `content` property | In data objects | | `shapeType` | `shape` (in `data`) | Moved from style to data object | | `startWidget` / `endWidget` | `startItem` / `endItem` | Connector endpoints | | Board User Connection | Board Member | Sharing/permissions model | ### Endpoint Migration Map ``` # v1 (DEPRECATED) → v2 (CURRENT) POST /v1/boards/{id}/widgets → POST /v2/boards/{id}/sticky_notes POST /v2/boards/{id}/shapes POST /v2/boards/{id}/cards POST /v2/boards/{id}/texts POST /v2/boards/{id}/frames POST /v2/boards/{id}/images POST /v2/boards/{id}/documents PO...