chore(shell-bson-parser): add publish release workflow

Author: rtritto

.github/workflows/publish.yml

@@ -0,0 +1,104 @@
+name: Publish Release
+
+on:
+  push:
+    branches:
+      - esm
+
+permissions:
+  contents: read
+
+jobs:
+  publish_package:
+    if: startsWith(github.event.head_commit.message, 'release(')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    environment: release
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          registry-url: 'https://registry.npmjs.org'
+      - name: Create NPM release
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - name: Create GitHub release
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const { owner, repo } = context.repo
+
+            const { data: releases } = await github.rest.repos.listReleases({
+              owner,
+              repo
+            })
+
+            const defaultBranch = context.ref.replace('refs/heads/', '')
+
+            const commitMessage = context.payload.head_commit.message
+
+            const packageMatch = commitMessage.match(/^release\(([^)]+)\):/)
+            if (!packageMatch) {
+              throw new Error('Missing package name. Expected format: "release(package-name):"')
+            }
+            const packageName = packageMatch[1]
+
+            const version = require(`./packages/${packageName}/package.json`).version
+            const versionTag = `${packageName}-v${version}`
+
+            let releaseNotes = ''
+            if (releases.length === 0) {
+              releaseNotes = 'First release!'
+            } else {
+              // Get range of commits using the API (from the previous release to the current HEAD)
+              const { data: comparison } = await github.rest.repos.compareCommits({
+                owner,
+                repo,
+                base: releases[0].tag_name,
+                head: context.sha
+              })
+
+              const features = []
+              const fixes = []
+              const breaking =[]
+
+              // Split commits by standard Conventional Commits
+              for (const { commit, sha } of comparison.commits) {
+                const firstLine = commit.message.split('\n')[0].trim()
+                const shortSha = sha.substring(0, 7)
+                const entry = `- ${firstLine} (${shortSha})`
+
+                // Breaking Changes "!" before the colon, e.g. "feat!:"
+                if (/^[a-zA-Z]+(?:\([^)]+\))?!:/.test(firstLine)) {
+                  breaking.push(entry)
+                }
+                // Features with prefix "feat:" or "feat(scope):"
+                else if (/^feat(?:\([^)]+\))?:/.test(firstLine)) {
+                  features.push(entry)
+                } 
+                // Bug Fixes with prefix "fix:" or "fix(scope):"
+                else if (/^fix(?:\([^)]+\))?:/.test(firstLine)) {
+                  fixes.push(entry)
+                }
+              }
+
+              if (breaking.length > 0) releaseNotes += '### Breaking Changes\n' + breaking.join('\n') + '\n\n'
+              if (features.length > 0) releaseNotes += '### Features\n' + features.join('\n') + '\n\n'
+              if (fixes.length > 0) releaseNotes += '### Bug Fixes\n' + fixes.join('\n') + '\n\n'
+            }
+
+            await github.rest.repos.createRelease({
+              owner,
+              repo,
+              tag_name: versionTag,
+              target_commitish: defaultBranch,
+              name: versionTag,
+              body: releaseNotes.trim()
+            })
+
+            console.log(`Release ${versionTag} created`)