hex-ci-integration

# Hex CI Integration ## Overview Set up CI/CD for Hex data analytics integrations: run unit tests with mocked project run and connection responses on every PR, trigger live Hex project runs and validate outputs on merge to main. Hex provides collaborative data notebooks with scheduled runs and API-triggered execution, so CI pipelines verify data transform logic, trigger post-deploy dashboard refreshes, and monitor run status. ## GitHub Actions Workflow ```yaml # .github/workflows/hex-ci.yml name: Hex CI on: pull_request: paths: ['src/hex/**', 'tests/**'] push: branches: [main] jobs: unit-tests: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: { node-version: '20' } - run: npm ci - run: npm test -- --reporter=verbose trigger-hex-refresh: if: github.ref == 'refs/heads/main' needs: unit-tests runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: { node-version: '20' } - run: npm ci - run: npm run test:integration env: HEX_API_TOKEN: ${{ secrets.HEX_API_TOKEN }} HEX_PROJECT_ID: ${{ vars.HEX_PROJECT_ID }} ``` ## Mock-Based Unit Tests ```typescript // tests/hex-service.test.ts import { describe, it, expect, vi } from 'vitest'; import { triggerProjectRun, getRunStatus } from '../src/hex-service'; vi.mock('../src/hex-client', () => ({ HexClient: vi.fn().mockIm...