hubspot-upgrade-migration

# HubSpot Upgrade & Migration ## Overview Guide for upgrading `@hubspot/api-client` SDK versions and migrating from legacy HubSpot APIs to the current CRM v3 API. ## Prerequisites - Current `@hubspot/api-client` installed - Git for version control - Test suite available - Staging environment for validation ## Instructions ### Step 1: Check Current Version and Available Updates ```bash # Current version npm list @hubspot/api-client # Latest available npm view @hubspot/api-client version # See changelog npm view @hubspot/api-client versions --json | tail -10 ``` ### Step 2: Review Breaking Changes Key breaking changes in `@hubspot/api-client`: | Version | Breaking Change | Migration | |---------|----------------|-----------| | v11 -> v12 | Association APIs moved to v4 namespace | `client.crm.associations.v4.basicApi` | | v10 -> v11 | Batch API input format changed | Wrap inputs in `{ inputs: [...] }` | | v9 -> v10 | `apiKey` auth removed (API keys deprecated) | Use `accessToken` only | | v8 -> v9 | TypeScript strict types on all methods | Update type imports | ### Step 3: Create Upgrade Branch and Update ```bash git checkout -b chore/upgrade-hubspot-api-client npm install @hubspot/api-client@latest npm test ``` ### Step 4: Common Migration Patterns #### API Key to Access Token (v9 -> v10+) ```typescript // BEFORE (deprecated -- API keys removed in v10) const client = new hubspot.Client({ apiKey: 'your-api-key' }); // AFTER (use private app access token) const ...