klaviyo-local-dev-loop

# Klaviyo Local Dev Loop ## Overview Set up a fast, reproducible local development workflow for Klaviyo integrations with hot reload, SDK mocking, and integration tests. ## Prerequisites - Completed `klaviyo-install-auth` setup - Node.js 18+ with npm/pnpm - `klaviyo-api` package installed ## Instructions ### Step 1: Project Structure ``` my-klaviyo-project/ ├── src/ │ ├── klaviyo/ │ │ ├── client.ts # ApiKeySession + API class singletons │ │ ├── profiles.ts # Profile operations │ │ ├── events.ts # Event tracking │ │ └── lists.ts # List management │ └── index.ts ├── tests/ │ ├── unit/ │ │ └── profiles.test.ts # Mocked SDK tests │ └── integration/ │ └── klaviyo.test.ts # Live API tests (CI only) ├── .env.local # Local secrets (git-ignored) ├── .env.example # Template for team ├── .env.test # Test environment (sandbox key) └── package.json ``` ### Step 2: Environment Configuration ```bash # .env.example (commit this) KLAVIYO_PRIVATE_KEY=pk_your_test_key_here KLAVIYO_PUBLIC_KEY=YourPublicKey NODE_ENV=development # .env.local (git-ignored, actual secrets) KLAVIYO_PRIVATE_KEY=pk_******************************** ``` ```json // package.json scripts { "scripts": { "dev": "tsx watch src/index.ts", "test": "vitest", "test:watch": "vitest --watch", "test:integration": "KLAVIYO_TEST=1 vitest --config vitest.integration.config.ts", "typech...