documenso-upgrade-migration

# Documenso Upgrade & Migration ## Current State !`npm list @documenso/sdk-typescript 2>/dev/null || echo 'SDK not installed'` !`npm list documenso-sdk-python 2>/dev/null || pip show documenso-sdk-python 2>/dev/null | head -3 || echo 'Python SDK not installed'` ## Overview Guide for upgrading between Documenso API versions and SDK updates. Documenso has two API versions: **v1** (legacy, document-centric) and **v2** (recommended, envelope-based with multi-document support). The TypeScript and Python SDKs use the v2 API by default. ## Prerequisites - Current Documenso integration working - Test environment available - Feature flag system (recommended for gradual rollout) ## API Version Comparison | Feature | v1 (legacy) | v2 (recommended) | |---------|-------------|-------------------| | Base path | `/api/v1/` | `/api/v2/` | | Document model | Documents | Envelopes (can contain multiple documents) | | SDK support | REST only | TypeScript + Python SDK | | Template API | `/templates/{id}/create-document` | Via envelope create | | Authentication | `Authorization: Bearer` | `Authorization: Bearer` (same) | | Status | Maintained, not deprecated | Actively developed | ## Instructions ### Step 1: Upgrade SDK to Latest ```bash # Check current version npm list @documenso/sdk-typescript # Upgrade npm install @documenso/sdk-typescript@latest # Check for breaking changes npm info @documenso/sdk-typescript changelog # Python pip install --upgrade documenso-sdk-python ``` ### S...