publish-example-tutorials.yaml

name: Publish Example App Tutorials

on:
  # Run when changes are pushed to example tutorials or metadata
  push:
    branches:
      - main
    paths:
      - 'examples/*/*/tutorial.md'
      - 'examples/*/*/metadata.json'
      - 'examples/*/*/features.json'
  # Allow manual triggering
  workflow_dispatch:

concurrency:
  group: example-tutorials
  cancel-in-progress: false

jobs:
  PublishExampleTutorials:
    name: Process and Publish Example Tutorials
    runs-on: ubuntu-latest
    steps:
      - name: Checkout SDK Repo
        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
        with:
          fetch-depth: 0
          ref: main

      - name: Checkout Docs Repo
        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
        with:
          repository: immutable/docs
          token: ${{ secrets.TS_IMMUTABLE_SDK_GITHUB_TOKEN }}
          path: imx-docs
          ref: DVR-295-docs-restructure

      - name: Setup environment variables
        run: |
          echo "CLONE_DIR=./imx-docs" >> $GITHUB_ENV

      - name: Setup Github
        run: |
          git config --global user.name "${GITHUB_ACTOR}"
          git config --global user.email "${GITHUB_ACTOR}@users.noreply.github.com"

      - name: setup
        uses: ./.github/actions/setup

      - name: Install Dependencies
        run: pnpm install --frozen-lockfile

      - name: Process Example App Tutorials
        run: |
          # Generate example app JSON files
          pnpm parse:examples
          
          # Process tutorials and copy to docs repo
          ./.github/scripts/process-tutorials.sh
        shell: bash

      - name: Create Pull Request in Docs Repo
        id: create_pr
        run: |
          cd "$CLONE_DIR"
          if ! git status --porcelain | grep -q .; then
            echo "No changes to commit"
            echo "pr_url=" >> $GITHUB_OUTPUT
            exit 0
          fi

          BRANCH_NAME="chore/sdk-docs-update-${{ github.run_id }}"
          git checkout -b $BRANCH_NAME
          
          git add .
          git commit -m "Update example app tutorials from SDK repo"
          git push -u origin $BRANCH_NAME
          echo "Successfully pushed changes to docs repo on branch $BRANCH_NAME"

          PR_URL=$(gh pr create \
            --title "Update example app tutorials from SDK repo" \
            --body "Automated PR from ts-immutable-sdk to update tutorials. Review and merge if all looks good." \
            --base DVR-295-docs-restructure \
            --repo immutable/docs)
          
          echo "Successfully created PR in docs repo: $PR_URL"
          echo "pr_url=${PR_URL}" >> $GITHUB_OUTPUT
        env:
          GITHUB_TOKEN: ${{ secrets.TS_IMMUTABLE_SDK_GITHUB_TOKEN }}
        shell: bash

      # - name: Notify Slack of New Docs PR
      #   if: steps.create_pr.outputs.pr_url != ''
      #   uses: slackapi/slack-github-action@v1.26.0
      #   with:
      #     channel-id: ${{ secrets.DOCS_PR_SLACK_CHANNEL_ID }}
      #     slack-message: "New automated tutorials PR is ready for review: <${{ steps.create_pr.outputs.pr_url }}|View Pull Request>"
      #   env:
      #     SLACK_BOT_TOKEN: ${{ secrets.DOCS_PR_SLACK_BOT_TOKEN }}