validate-canvas-extensions.yml

name: Validate Canvas Extensions

on:
  pull_request:
    branches: [main]
    types: [opened, synchronize, reopened]
    paths:
      - "extensions/**"
      - ".schemas/canvas.schema.json"

permissions:
  contents: read

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
        with:
          fetch-depth: 0

      - name: Setup Node.js
        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
        with:
          node-version: "22"
          cache: "npm"

      - name: Validate changed canvas extensions
        run: |
          set -euo pipefail

          mapfile -t changed_extensions < <(
            git diff --name-only "origin/${{ github.base_ref }}...HEAD" |
            awk -F/ '$1 == "extensions" && $2 != "" && $2 != "external-assets" && $2 !~ /\./ { print "extensions/" $2 }' |
            sort -u
          )

          if [ "${#changed_extensions[@]}" -eq 0 ]; then
            echo "No canvas extension directories changed — skipping validation."
            exit 0
          fi

          echo "Validating ${#changed_extensions[@]} extension(s): ${changed_extensions[*]}"

          errors=()

          for ext_dir in "${changed_extensions[@]}"; do
            if [ ! -d "$ext_dir" ]; then
              echo "$ext_dir no longer exists (deleted?), skipping."
              continue
            fi

            if [ ! -f "$ext_dir/extension.mjs" ]; then
              errors+=("\`$ext_dir\`: missing required \`extension.mjs\`.")
            fi

            if [ ! -f "$ext_dir/canvas.json" ]; then
              errors+=("\`$ext_dir\`: missing required \`canvas.json\`.")
              continue
            fi

            if [ ! -f "$ext_dir/assets/preview.png" ]; then
              errors+=("\`$ext_dir\`: missing required \`assets/preview.png\`.")
            fi

            if ! schema_output="$(npx --yes ajv-cli@5 validate --spec=draft7 --strict=false -s .schemas/canvas.schema.json -d "$ext_dir/canvas.json" 2>&1)"; then
              condensed_output="$(echo "$schema_output" | tr '\n' ' ' | sed 's/[[:space:]]\+/ /g')"
              errors+=("\`$ext_dir/canvas.json\`: schema validation failed against \`.schemas/canvas.schema.json\` ($condensed_output).")
              continue
            fi

            mapfile -t screenshot_paths < <(
              node -e 'const fs = require("fs"); const manifest = JSON.parse(fs.readFileSync(process.argv[1], "utf8")); const paths = [manifest?.screenshots?.icon?.path, manifest?.screenshots?.gallery?.path].filter((value) => typeof value === "string" && value.trim().length > 0); for (const value of [...new Set(paths)]) { console.log(value); }' "$ext_dir/canvas.json"
            )

            for screenshot_path in "${screenshot_paths[@]}"; do
              if [ ! -f "$ext_dir/$screenshot_path" ]; then
                errors+=("\`$ext_dir/canvas.json\`: screenshot path \`$screenshot_path\` does not exist in the extension directory.")
              fi
            done
          done

          if [ "${#errors[@]}" -ne 0 ]; then
            echo "❌ Canvas extension validation failed:"
            for error in "${errors[@]}"; do
              echo "- $error"
            done
            exit 1
          fi

          echo "✅ All changed canvas extensions passed validation."