hubspot-local-dev-loop

# HubSpot Local Dev Loop ## Overview Set up a fast local development workflow for HubSpot integrations with sandbox accounts, mocking, and test utilities. ## Prerequisites - Completed `hubspot-install-auth` setup - Node.js 18+ with npm/pnpm - HubSpot developer test account (free at developers.hubspot.com) ## Instructions ### Step 1: Create Project Structure ``` my-hubspot-project/ ├── src/ │ ├── hubspot/ │ │ ├── client.ts # Singleton @hubspot/api-client wrapper │ │ ├── contacts.ts # Contact operations │ │ ├── deals.ts # Deal operations │ │ └── types.ts # HubSpot type definitions │ └── index.ts ├── tests/ │ ├── mocks/ │ │ └── hubspot.ts # Shared mock factory │ ├── contacts.test.ts │ └── deals.test.ts ├── .env.local # Local secrets (git-ignored) ├── .env.example # Template for team ├── tsconfig.json └── package.json ``` ### Step 2: Create Client Singleton ```typescript // src/hubspot/client.ts import * as hubspot from '@hubspot/api-client'; let instance: hubspot.Client | null = null; export function getHubSpotClient(): hubspot.Client { if (!instance) { if (!process.env.HUBSPOT_ACCESS_TOKEN) { throw new Error('HUBSPOT_ACCESS_TOKEN environment variable is required'); } instance = new hubspot.Client({ accessToken: process.env.HUBSPOT_ACCESS_TOKEN, numberOfApiCallRetries: 3, }); } return instance; } // Reset client (useful for tests) export functi...