salesforce-upgrade-migration

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 <[e-mail]>
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

# jsforce version
npm list jsforce

# Current API version in use
node -e "const jsforce = require('jsforce'); const c = new jsforce.Connection({}); console.log('Default API version:', c.version)"

# Available API versions from your org
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

// jsforce v1.x → v2.x/v3.x migration
// Key breaking changes:

// BEFORE (v1.x): Callback-based
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,
});