deploy-docs.yml

# Deploy docs site to Cloudflare Pages via Wrangler CLI.
#
# Triggers on docs/** changes pushed to dev, staging, or main.
# PR pushes get a preview deployment with URL posted as a comment.
# Production branch = staging (matches current user-facing surface).
#
# Required secrets: CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID

name: Deploy Docs

on:
  push:
    branches: [dev, staging, main]
    paths:
      - 'docs/**'
      - 'package.json'
      - 'package-lock.json'
  pull_request:
    paths:
      - 'docs/**'
  workflow_dispatch:

permissions:
  contents: read
  deployments: write
  pull-requests: write

jobs:
  deploy:
    runs-on: ubuntu-latest
    if: github.repository == 'protoLabsAI/protoMaker'
    timeout-minutes: 10
    concurrency:
      group: docs-deploy-${{ github.ref }}
      cancel-in-progress: true

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: 22

      - name: Build docs
        run: |
          npm install vitepress@1.6.4
          npx vitepress build docs

      - name: Deploy to Cloudflare Pages
        id: deploy
        env:
          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
        run: |
          BRANCH="${GITHUB_HEAD_REF:-${GITHUB_REF_NAME}}"
          npx wrangler pages deploy docs/.vitepress/dist \
            --project-name=protolabs-docs \
            --branch="$BRANCH" \
            --commit-hash="${GITHUB_SHA}" \
            --commit-message="${{ github.event.head_commit.message || 'Deploy' }}"

      - name: Comment PR preview URL
        if: github.event_name == 'pull_request'
        uses: actions/github-script@v7
        with:
          script: |
            const branch = context.payload.pull_request.head.ref;
            const slug = branch.replace(/[^a-z0-9-]/gi, '-').substring(0, 28);
            const url = `https://${slug}.protolabs-docs.pages.dev`;
            github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: `Docs preview: ${url}`
            });

      - name: Notify Discord
        if: always() && github.event_name == 'push'
        run: |
          STATUS="${{ job.status }}"
          COMMIT="${GITHUB_SHA:0:8}"
          BRANCH="${GITHUB_REF_NAME}"
          if [ "$STATUS" = "success" ]; then
            MSG="Docs deployed (${BRANCH}): \`${COMMIT}\` — https://docs.protolabs.studio"
          else
            MSG="Docs deploy FAILED (${BRANCH}): \`${COMMIT}\` — ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"
          fi
          if [ -n "${DISCORD_DEPLOY_WEBHOOK:-}" ]; then
            curl -sf -H "Content-Type: application/json" \
              -d "{\"content\": \"${MSG}\"}" \
              "$DISCORD_DEPLOY_WEBHOOK" || true
          fi
        env:
          DISCORD_DEPLOY_WEBHOOK: ${{ secrets.DISCORD_DEPLOY_WEBHOOK }}