feat: add promote to stable workflow and sync stable back to main

This commit introduces a new GitHub Actions workflow for promoting changes from the main branch to the stable branch, along with a step to sync the stable branch back to main after a release. The workflow includes token generation and proper Git configuration for automated commits.

Author: caio-pizzol

.github/workflows/promote-stable.yml

@@ -0,0 +1,27 @@
+name: Promote to Stable
+
+on:
+  workflow_dispatch:
+
+jobs:
+  promote:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate token
+        id: generate_token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ secrets.APP_ID }}
+          private-key: ${{ secrets.APP_PRIVATE_KEY }}
+
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+          token: ${{ steps.generate_token.outputs.token }}
+
+      - run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git checkout stable || git checkout -b stable
+          git merge main --no-ff -m "chore: promote main to stable"
+          git push origin stable

.github/workflows/release-package.yml

@@ -51,3 +51,15 @@ jobs:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: |
           pnpm dlx semantic-release
+
+      - name: Sync stable back to main
+        if: github.ref == 'refs/heads/stable'
+        env:
+          GITHUB_TOKEN: ${{ steps.generate_token.outputs.token }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git fetch origin main stable
+          git checkout main
+          git merge origin/stable -m "chore: sync stable release to main"
+          git push origin main