intercom-local-dev-loop

# Intercom Local Dev Loop ## Overview Set up a fast local development workflow for Intercom integrations with proper test isolation, mocking strategies, and webhook tunneling. ## Prerequisites - Completed `intercom-install-auth` setup - Node.js 18+ with npm/pnpm - A test/development Intercom workspace (separate from production) ## Instructions ### Step 1: Project Structure ``` my-intercom-app/ ├── src/ │ ├── intercom/ │ │ ├── client.ts # Singleton client │ │ ├── contacts.ts # Contact operations │ │ ├── conversations.ts # Conversation operations │ │ └── types.ts # Intercom type extensions │ └── index.ts ├── tests/ │ ├── mocks/ │ │ └── intercom.ts # Mock client factory │ ├── contacts.test.ts │ └── conversations.test.ts ├── .env.development # Dev workspace token ├── .env.test # Test config (mocked) ├── .env.example # Template └── package.json ``` ### Step 2: Environment Configuration ```bash # .env.example (commit this) INTERCOM_ACCESS_TOKEN= INTERCOM_WEBHOOK_SECRET= NODE_ENV=development # .env.development (git-ignored, real dev workspace token) INTERCOM_ACCESS_TOKEN=dG9rOmRldl90b2tlbl9oZXJl INTERCOM_WEBHOOK_SECRET=your-webhook-secret NODE_ENV=development ``` ### Step 3: Client Singleton with Environment Awareness ```typescript // src/intercom/client.ts import { IntercomClient } from "intercom-client"; let instance: IntercomClient | null = null; export function getClient(): IntercomC...