apify-upgrade-migration

# Apify Upgrade & Migration ## Overview Guide for upgrading `apify`, `apify-client`, and `crawlee` packages. The biggest migration in Apify's history was SDK v2 to v3, which split crawling functionality into the `crawlee` package. This skill covers that migration plus general upgrade procedures. ## Prerequisites - Git branch for the upgrade - Test suite available - Current versions documented ## Instructions ### Step 1: Check Current Versions ```bash # Check installed versions npm list apify apify-client crawlee 2>/dev/null # Check latest available versions npm view apify version npm view apify-client version npm view crawlee version # Check for outdated packages npm outdated apify apify-client crawlee ``` ### Step 2: Create Upgrade Branch ```bash git checkout -b upgrade/apify-packages ``` ### Step 3: Upgrade Packages ```bash # Upgrade to latest npm install apify@latest crawlee@latest apify-client@latest # Or upgrade to specific version npm install apify@3.2.0 crawlee@3.11.0 # Check for peer dependency issues npm ls 2>&1 | grep "ERESOLVE\|peer dep" ``` ### Step 4: Run Tests and Fix Issues ```bash npm test npm run build # Catch TypeScript errors ``` ## Major Migration: Apify SDK v2 to v3 (Crawlee Split) This is the most common migration. In v3, crawling code moved to `crawlee`. ### Import Changes ```typescript // ---- BEFORE (SDK v2) ---- import Apify from 'apify'; const { CheerioCrawler, PlaywrightCrawler, log } = Apify; // ---- AFTER (SDK v3 + Crawlee)...