intercom-sdk-patterns

# Intercom SDK Patterns ## Overview Production-ready patterns for the `intercom-client` TypeScript SDK covering client initialization, pagination, error handling, and type safety. ## Prerequisites - `intercom-client` package installed - TypeScript 5.0+ project - Familiarity with async/await and generators ## Instructions ### Step 1: Type-Safe Client Wrapper ```typescript // src/intercom/client.ts import { IntercomClient } from "intercom-client"; import { Intercom } from "intercom-client"; let instance: IntercomClient | null = null; export function getClient(): IntercomClient { if (!instance) { instance = new IntercomClient({ token: process.env.INTERCOM_ACCESS_TOKEN!, }); } return instance; } // Type-safe contact creation helper export async function createContact( params: Intercom.CreateContactRequest ): Promise<Intercom.Contact> { return getClient().contacts.create(params); } // Type-safe search helper export async function searchContacts( query: Intercom.SearchRequest ): Promise<Intercom.ContactList> { return getClient().contacts.search(query); } ``` ### Step 2: Cursor-Based Pagination Intercom uses cursor-based pagination. The `starting_after` parameter points to the next page. ```typescript // Generic paginator for any list endpoint async function* paginateContacts( client: IntercomClient, perPage = 50 ): AsyncGenerator<Intercom.Contact> { let startingAfter: string | undefined; do { const page = await client.contacts....