js.yml

name: JavaScript CI/CD

on:
  push:
    branches:
      - main
    paths:
      - 'js/**'
      - 'scripts/**'
      - '.github/workflows/js.yml'
  pull_request:
    types: [opened, synchronize, reopened]
    paths:
      - 'js/**'
      - 'scripts/**'
      - '.github/workflows/js.yml'
  workflow_dispatch:
    inputs:
      release_mode:
        description: 'Manual release mode'
        required: true
        type: choice
        default: 'instant'
        options:
          - instant
          - changeset-pr
      bump_type:
        description: 'Manual release type'
        required: true
        type: choice
        options:
          - patch
          - minor
          - major
      description:
        description: 'Manual release description (optional)'
        required: false
        type: string

concurrency: ${{ github.workflow }}-${{ github.ref }}

jobs:
  # Changeset check - only runs on PRs
  changeset-check:
    name: Check for Changesets
    runs-on: ubuntu-latest
    if: github.event_name == 'pull_request'
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20.x'

      - name: Install dependencies
        working-directory: ./js
        run: npm install

      - name: Check for changesets
        run: |
          # Skip changeset check for automated version PRs
          if [[ "${{ github.head_ref }}" == "changeset-release/"* ]]; then
            echo "Skipping changeset check for automated release PR"
            exit 0
          fi

          # Run changeset validation script
          node scripts/validate-changeset.mjs

  # Test JavaScript
  test-js:
    name: Test JavaScript
    runs-on: ubuntu-latest
    needs: [changeset-check]
    if: always() && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || needs.changeset-check.result == 'success')
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20.x'

      - name: Setup .NET
        uses: actions/setup-dotnet@v4
        with:
          dotnet-version: '8.0.x'

      - name: Install clink
        run: dotnet tool install --global clink

      - name: Verify clink installation
        run: clink --version

      - name: Install dependencies
        working-directory: ./js
        run: npm install

      - name: Create test data directories
        run: |
          mkdir -p ./js/data
          mkdir -p ./data/auth-data/users
          mkdir -p ./data/menu-items
          mkdir -p ./js/backend/monolith/data/auth-data
          mkdir -p ./js/tests

      - name: Run tests
        working-directory: ./js
        run: npm test

  # Release JavaScript - only runs on main after tests pass
  release-js:
    name: Release JavaScript
    runs-on: ubuntu-latest
    needs: [test-js]
    if: always() && github.ref == 'refs/heads/main' && github.event_name == 'push' && needs.test-js.result == 'success'
    permissions:
      contents: write
      pull-requests: write
      id-token: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20.x'
          registry-url: 'https://registry.npmjs.org'

      - name: Install dependencies
        working-directory: ./js
        run: npm install

      - name: Check for changesets
        id: check_changesets
        run: |
          # Count changeset files (excluding README.md and config.json)
          CHANGESET_COUNT=$(find js/.changeset -name "*.md" ! -name "README.md" | wc -l)
          echo "Found $CHANGESET_COUNT changeset file(s)"
          echo "has_changesets=$([[ $CHANGESET_COUNT -gt 0 ]] && echo 'true' || echo 'false')" >> $GITHUB_OUTPUT

      - name: Version packages and commit to main
        if: steps.check_changesets.outputs.has_changesets == 'true'
        id: version
        run: |
          # Configure git
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"

          # Get current version before bump
          OLD_VERSION=$(node -p "require('./js/package.json').version")
          echo "Current version: $OLD_VERSION"

          # Run changeset version to bump versions and update CHANGELOG
          cd js && npm run changeset:version && cd ..

          # Get new version after bump
          NEW_VERSION=$(node -p "require('./js/package.json').version")
          echo "New version: $NEW_VERSION"
          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT

          # Check if there are changes to commit
          if [[ -n $(git status --porcelain) ]]; then
            echo "Changes detected, committing..."

            # Stage all changes (package.json, package-lock.json, CHANGELOG.md, deleted changesets)
            git add -A

            # Commit with version number as message
            git commit -m "$NEW_VERSION" \
                       -m "" \
                       -m "🤖 Generated with [Claude Code](https://claude.com/claude-code)"

            # Push directly to main
            git push origin main

            echo "✅ Version bump committed and pushed to main"
            echo "version_committed=true" >> $GITHUB_OUTPUT
          else
            echo "No changes to commit"
            echo "version_committed=false" >> $GITHUB_OUTPUT
          fi

      - name: Publish to npm
        if: steps.version.outputs.version_committed == 'true'
        id: publish
        run: |
          # Pull the latest changes we just pushed
          git pull origin main

          # Publish to npm
          cd js && npm run changeset:publish

          echo "published=true" >> $GITHUB_OUTPUT

          # Get published version
          PUBLISHED_VERSION=$(node -p "require('./js/package.json').version")
          echo "published_version=$PUBLISHED_VERSION" >> $GITHUB_OUTPUT
          echo "✅ Published @link-foundation/links-client@$PUBLISHED_VERSION to npm"
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

      - name: Create GitHub Release
        if: steps.publish.outputs.published == 'true'
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          VERSION="${{ steps.publish.outputs.published_version }}"
          TAG="v$VERSION"

          echo "Creating GitHub release for $TAG..."

          # Extract changelog entry for this version
          # Read from CHANGELOG.md between this version header and the next version header
          if [ -f js/CHANGELOG.md ]; then
            RELEASE_NOTES=$(awk "/## $VERSION/{flag=1; next} /## [0-9]/{flag=0} flag" js/CHANGELOG.md)
          fi

          if [ -z "$RELEASE_NOTES" ]; then
            RELEASE_NOTES="Release $VERSION"
          fi

          # Create release
          gh release create "$TAG" \
            --title "$VERSION" \
            --notes "$RELEASE_NOTES" \
            --repo ${{ github.repository }}

          echo "✅ Created GitHub release: $TAG"

  # Manual Instant Release - triggered via workflow_dispatch with instant mode
  instant-release:
    name: Instant Release
    if: github.event_name == 'workflow_dispatch' && github.event.inputs.release_mode == 'instant'
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      id-token: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20.x'
          registry-url: 'https://registry.npmjs.org'

      - name: Install dependencies
        working-directory: ./js
        run: npm install

      - name: Configure git
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"

      - name: Bump version
        id: version
        run: |
          cd js

          # Get current version
          OLD_VERSION=$(node -p "require('./package.json').version")
          echo "Current version: $OLD_VERSION"

          # Bump version based on bump_type
          npm version ${{ github.event.inputs.bump_type }} --no-git-tag-version

          # Get new version
          NEW_VERSION=$(node -p "require('./package.json').version")
          echo "New version: $NEW_VERSION"
          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT

          cd ..

          # Commit changes
          git add -A
          git commit -m "$NEW_VERSION" \
                     -m "" \
                     -m "${{ github.event.inputs.description || 'Manual release' }}" \
                     -m "" \
                     -m "🤖 Generated with [Claude Code](https://claude.com/claude-code)"

          git push origin main
          echo "version_committed=true" >> $GITHUB_OUTPUT

      - name: Publish to npm
        if: steps.version.outputs.version_committed == 'true'
        id: publish
        run: |
          cd js && npm publish --access public
          echo "published=true" >> $GITHUB_OUTPUT
          echo "published_version=${{ steps.version.outputs.new_version }}" >> $GITHUB_OUTPUT
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

      - name: Create GitHub Release
        if: steps.publish.outputs.published == 'true'
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          VERSION="${{ steps.version.outputs.new_version }}"
          TAG="v$VERSION"

          gh release create "$TAG" \
            --title "$VERSION" \
            --notes "${{ github.event.inputs.description || 'Manual release' }}" \
            --repo ${{ github.repository }}

  # Manual Changeset PR - creates a pull request with the changeset for review
  changeset-pr:
    name: Create Changeset PR
    if: github.event_name == 'workflow_dispatch' && github.event.inputs.release_mode == 'changeset-pr'
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20.x'

      - name: Install dependencies
        working-directory: ./js
        run: npm install

      - name: Create changeset file
        run: |
          CHANGESET_ID=$(date +%s | md5sum | head -c 8)
          CHANGESET_FILE="js/.changeset/${CHANGESET_ID}.md"

          cat > "$CHANGESET_FILE" << EOF
          ---
          '@link-foundation/links-client': ${{ github.event.inputs.bump_type }}
          ---

          ${{ github.event.inputs.description || 'Manual release' }}
          EOF

          echo "Created changeset: $CHANGESET_FILE"
          cat "$CHANGESET_FILE"

      - name: Create Pull Request
        uses: peter-evans/create-pull-request@v7
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          commit-message: 'chore: add changeset for manual ${{ github.event.inputs.bump_type }} release'
          branch: changeset-manual-release-${{ github.run_id }}
          delete-branch: true
          title: 'chore: manual ${{ github.event.inputs.bump_type }} release'
          body: |
            ## Manual Release Request

            This PR was created by a manual workflow trigger to prepare a **${{ github.event.inputs.bump_type }}** release.

            ### Release Details
            - **Type:** ${{ github.event.inputs.bump_type }}
            - **Description:** ${{ github.event.inputs.description || 'Manual release' }}
            - **Triggered by:** @${{ github.actor }}

            ### Next Steps
            1. Review the changeset in this PR
            2. Merge this PR to main
            3. The automated release workflow will create a version PR
            4. Merge the version PR to publish to npm and create a GitHub release