customerio-local-dev-loop

# Customer.io Local Dev Loop ## Overview Set up an efficient local development workflow for Customer.io: environment isolation via separate workspaces, a dry-run client for safe development, test mocks for unit tests, and prefixed events that never pollute production data. ## Prerequisites - `customerio-node` installed - Separate Customer.io workspace for development (recommended — free workspaces available) - `dotenv` or similar for environment variable loading ## Instructions ### Step 1: Environment Configuration ```bash # .env.development CUSTOMERIO_SITE_ID=dev-site-id CUSTOMERIO_TRACK_API_KEY=dev-track-key CUSTOMERIO_APP_API_KEY=dev-app-key CUSTOMERIO_REGION=us CUSTOMERIO_DRY_RUN=false CUSTOMERIO_EVENT_PREFIX=dev_ # .env.test CUSTOMERIO_SITE_ID=not-needed CUSTOMERIO_TRACK_API_KEY=not-needed CUSTOMERIO_APP_API_KEY=not-needed CUSTOMERIO_DRY_RUN=true CUSTOMERIO_EVENT_PREFIX=test_ ``` ### Step 2: Environment-Aware Client ```typescript // lib/customerio-dev.ts import { TrackClient, APIClient, RegionUS, RegionEU } from "customerio-node"; interface CioConfig { siteId: string; trackApiKey: string; appApiKey: string; region: typeof RegionUS | typeof RegionEU; dryRun: boolean; eventPrefix: string; } function loadConfig(): CioConfig { return { siteId: process.env.CUSTOMERIO_SITE_ID ?? "", trackApiKey: process.env.CUSTOMERIO_TRACK_API_KEY ?? "", appApiKey: process.env.CUSTOMERIO_APP_API_KEY ?? "", region: process.env.CUSTOMERIO_REGION === "eu...