intercom-upgrade-migration

# Intercom Upgrade & Migration ## Overview Guide for upgrading the `intercom-client` npm package and handling Intercom API version changes. The SDK was rewritten in TypeScript starting at v6, which introduced significant breaking changes from the v5 CommonJS API. ## Prerequisites - Current `intercom-client` installed - Git for version control - Test suite available ## Instructions ### Step 1: Check Current Versions ```bash # Current SDK version npm list intercom-client # Latest available npm view intercom-client version # Current API version (check response headers) curl -s -D - -o /dev/null \ -H "Authorization: Bearer $INTERCOM_ACCESS_TOKEN" \ https://api.intercom.io/me 2>/dev/null | grep -i intercom-version ``` ### Step 2: SDK v5 to v6 Migration (Major Breaking Change) The v6 SDK is a full TypeScript rewrite with a new API surface. **Client Initialization:** ```typescript // v5 (CommonJS) const Intercom = require("intercom-client"); const client = new Intercom.Client({ token: "xxx" }); // v6+ (TypeScript ESM) import { IntercomClient } from "intercom-client"; const client = new IntercomClient({ token: "xxx" }); ``` **Contact Operations:** ```typescript // v5 await client.users.create({ email: "test@example.com" }); await client.leads.create({ email: "lead@example.com" }); await client.users.find({ id: "abc" }); await client.users.list(); // v6+ (unified contacts API) await client.contacts.create({ role: "user", email: "test@example.com" }); await client....