hubspot-reference-architecture

# HubSpot Reference Architecture ## Overview Production-ready layered architecture for HubSpot CRM integrations with typed clients, service abstraction, caching, and webhook handling. ## Prerequisites - TypeScript 5+ project - `@hubspot/api-client` v13+ installed - Understanding of layered architecture patterns ## Instructions ### Step 1: Project Structure ``` my-hubspot-integration/ ├── src/ │ ├── hubspot/ # HubSpot infrastructure layer │ │ ├── client.ts # Singleton @hubspot/api-client wrapper │ │ ├── types.ts # HubSpot-specific types │ │ ├── errors.ts # Error classification │ │ ├── cache.ts # Response caching │ │ └── associations.ts # Association type constants │ ├── services/ # Business logic layer │ │ ├── contact.service.ts # Contact CRUD + business rules │ │ ├── deal.service.ts # Deal pipeline operations │ │ ├── company.service.ts # Company management │ │ └── sync.service.ts # Data synchronization │ ├── api/ # API layer │ │ ├── routes/ │ │ │ ├── contacts.ts # REST endpoints │ │ │ ├── deals.ts │ │ │ └── webhooks.ts # Webhook receiver │ │ └── middleware/ │ │ ├── auth.ts # Request auth │ │ └── webhook-verify.ts # HubSpot signature verification │ ├── jobs/ # Background jobs │ │ ├── sync-conta...