ci.yml

name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

# Cancel in-progress runs for the same branch/PR
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

jobs:
  secrets-scan:
    name: Secrets Scanning (Gitleaks)
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Gitleaks Scan
        uses: gitleaks/gitleaks-action@v2
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

  vulnerability-scan:
    name: Dependency Vulnerability Audit
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - run: npm audit --audit-level=high

  license-scan:
    name: Dependency License Compliance
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - name: Install dependencies
        run: npm ci
      # Permissive-only allow-list, reconciled with the project's own
      # MIT/Apache-2.0 license (issue #107). Fails the build on any
      # dependency (direct or transitive) carrying a copyleft or
      # unrecognized/unlicensed license.
      - name: Check dependency licenses
        run: |
          npx license-checker --production \
            --onlyAllow 'MIT;Apache-2.0;BSD-2-Clause;BSD-3-Clause;ISC;0BSD;CC0-1.0;Unlicense' \
            --excludePrivatePackages

  commitlint:
    name: Commit Message Lint
    runs-on: ubuntu-latest
    # Only meaningful on PRs — on direct pushes to main we skip this check
    # since squash merges are handled by the branch protection rule.
    if: github.event_name == 'pull_request'
    steps:
      - uses: actions/checkout@v4
        with:
          # Fetch enough history to validate all commits in the PR.
          fetch-depth: 0

      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm

      - name: Install dependencies
        run: npm ci

      # Lint every commit in the PR from the merge base to HEAD.
      - name: Lint commit messages
        run: |
          npx commitlint \
            --from ${{ github.event.pull_request.base.sha }} \
            --to   ${{ github.event.pull_request.head.sha }} \
            --verbose

  backend:
    name: Backend (Nest) – Node ${{ matrix.node-version }}
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [20, 22]

    # Spin up a PostgreSQL service container so Prisma can connect during the
    # migrate step (migrate deploy requires a live DB).
    services:
      postgres:
        image: postgres:16-alpine
        env:
          POSTGRES_USER: vortex
          POSTGRES_PASSWORD: vortex
          POSTGRES_DB: vortex
        ports:
          - 5432:5432
        # Wait until postgres is healthy before the steps run.
        options: >-
          --health-cmd="pg_isready -U vortex"
          --health-interval=10s
          --health-timeout=5s
          --health-retries=5

    env:
      DATABASE_URL: postgresql://vortex:vortex@localhost:5432/vortex?schema=public

    steps:
      - uses: actions/checkout@v4

      # ── Node / npm cache (#130) ──────────────────────────────────────────
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
          cache: npm

      - name: Install dependencies
        run: npm ci

      # ── Env drift check ────────────────────────────────────────────────────
      # Fast, early-failing check that env.validation.ts, .env*.example, and
      # configuration.ts's process.env reads all agree on the same variable set.
      - name: Check env var drift
        run: npx tsx scripts/check-env-drift.ts

      # ── Prisma ──────────────────────────────────────────────────────────────
      - name: Validate Prisma schema
        run: npm run db:validate

      - name: Generate Prisma client
        run: npm run db:generate

      # Apply all pending migrations to the CI database so the schema stays in
      # sync and any broken migration SQL is caught before merge.
      - name: Run database migrations
        run: npm run db:migrate:prod

      # ── Build & test ────────────────────────────────────────────────────────
      - name: Lint
        run: npm run lint

      - name: Type-check
        run: npm run typecheck

      - name: Build
        run: npm run build

      - name: Unit tests
        run: npm test

      - name: E2E tests
        run: npm run test:e2e

  # ── Migration rollback verification ────────────────────────────────────────
  # For every prisma/migrations/*/down.sql, applies migration.sql then
  # down.sql against a fresh Postgres and asserts the schema returns to its
  # pre-migration (empty) state. See prisma/migrations/README.md.
  migration-rollback:
    name: Migration rollback verification
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:16-alpine
        env:
          POSTGRES_USER: vortex
          POSTGRES_PASSWORD: vortex
          POSTGRES_DB: vortex_rollback_test
        ports:
          - 5432:5432
        options: >-
          --health-cmd pg_isready
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5
    env:
      PGHOST: localhost
      PGPORT: 5432
      PGUSER: vortex
      PGPASSWORD: vortex
      PGDATABASE: vortex_rollback_test
    steps:
      - uses: actions/checkout@v4

      - name: Apply each migration's up then down script and verify schema is restored
        run: |
          set -euo pipefail
          for dir in prisma/migrations/*/; do
            name=$(basename "$dir")
            up="$dir/migration.sql"
            down="$dir/down.sql"
            [ -f "$down" ] || continue

            echo "::group::$name"
            before=$(psql -Atc "select tablename from pg_tables where schemaname='public' order by 1")
            psql -v ON_ERROR_STOP=1 -f "$up"
            psql -v ON_ERROR_STOP=1 -f "$down"
            after=$(psql -Atc "select tablename from pg_tables where schemaname='public' order by 1")

            if [ "$before" != "$after" ]; then
              echo "Schema after down.sql does not match pre-migration state for $name"
              echo "before: $before"
              echo "after:  $after"
              exit 1
            fi
            echo "::endgroup::"
          done

  # ── Docker build verification (#131) ──────────────────────────────────────
  # Ensures every push that changes application code doesn't silently break
  # the Dockerfile. Image publishing to a registry can be wired up separately
  # once registry credentials are in place.
  docker:
    name: Docker – build verification
    runs-on: ubuntu-latest
    needs: backend
    steps:
      - uses: actions/checkout@v4

      - name: Build Docker image
        uses: docker/build-push-action@v6
        with:
          context: .
          push: false
          tags: vortex-backend:ci

  sdk-publish:
    name: Publish generated SDK
    runs-on: ubuntu-latest
    needs: [backend, docker]
    if: startsWith(github.ref, 'refs/tags/v')
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 20
          registry-url: https://registry.npmjs.org

      - name: Install dependencies
        run: npm ci

      - name: Regenerate client SDK
        run: npm run generate:client

      - name: Verify packaged SDK installs cleanly
        run: |
          tmpdir=$(mktemp -d)
          cd "$tmpdir"
          npm init -y
          npm install --silent "$GITHUB_WORKSPACE/src/generated"
          npm install --silent typescript @types/node
          cat <<'TS' > index.ts
          import type { paths, components } from '@vortex-protocol/backend-sdk';

          type IntentList = paths['/api/v1/intents']['get'];
          type Intent = components['schemas']['Intent'];

          const fallback: Intent | undefined = undefined;
          void fallback;
          void IntentList;
          TS
          npx tsc --noEmit --moduleResolution node --module commonjs --target es2020 index.ts

      - name: Publish SDK to npm
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
        run: |
          version="${GITHUB_REF_NAME#v}"
          npm --prefix src/generated version "$version" --no-git-tag-version
          npm --prefix src/generated publish --access public