| name | salesforce-upgrade-migration |
| description | Analyze, plan, and execute Salesforce API version upgrades and jsforce major version migrations.
Use when upgrading Salesforce API versions, migrating jsforce v1 to v3,
or adapting to deprecated API changes.
Trigger with phrases like "upgrade salesforce", "salesforce API version",
"jsforce upgrade", "salesforce deprecation", "salesforce version migration".
|
| allowed-tools | Read, Write, Edit, Bash(npm:*), Bash(sf:*), Bash(git:*) |
| version | 1.7.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","crm","salesforce"] |
| compatibility | Designed for Claude Code |
Salesforce Upgrade & Migration
Overview
Guide for upgrading Salesforce API versions (v55.0 to v59.0+), migrating between jsforce major versions, and handling Salesforce seasonal release changes.
Prerequisites
- Current jsforce or simple-salesforce installed
- Git for version control
- Test suite with Salesforce integration tests
- Sandbox environment for validation
Instructions
Step 1: Check Current Versions
npm list jsforce
node -e "const jsforce = require('jsforce'); const c = new jsforce.Connection({}); console.log('Default API version:', c.version)"
sf org display --target-org my-org --json | jq '.result.apiVersion'
Step 2: Salesforce API Version Changes
| API Version | Release | Key Changes |
|---|
| v59.0 | Winter '24 | Composite Graph improvements, Einstein AI endpoints |
| v58.0 | Summer '23 | Enhanced Bulk API 2.0, Flow API updates |
| v57.0 | Spring '23 | SOQL TYPEOF improvements, new standard fields |
| v56.0 | Winter '23 | sObject Collections batch size changes |
| v55.0 | Summer '22 | Retirement of old SOAP API features |
Salesforce retires API versions periodically. Versions older than 3 years are typically deprecated. Check Salesforce Release Notes each season.
Step 3: jsforce Major Version Migration
import jsforce from 'jsforce';
const conn = new jsforce.Connection();
conn.(username, password, {
conn.(, {});
});
jsforce ;
conn = jsforce.();
conn.(username, password);
result = conn.();
job = conn..(, );
batch = job.();
results = conn..({
: ,
: ,
: csvData,
});
