Merge pull request #6 from Codegyan-LLC/dev

v1.0.6

Author: prathmeshyelne

.github/workflows/npm-publish.yml

@@ -1,57 +1,76 @@
-name: Git Package Release & Publish oon NPM
+# 🚀 Release & Publish Workflow
+# 
+# This GitHub Actions workflow automates the full release process:
+# 
+# 1. On every push to the `main` branch:
+#    - Bumps the version in `package.json` automatically (patch level: v1.0.6 → v1.0.7).
+#    - Commits and pushes the new version + Git tag back to `main`.
+#    - Creates a GitHub Release with the new tag.
+#
+# 2. Build Job:
+#    - Runs `npm install` and `npm run build`.
+#    - Archives the build output (`dist/`) as an artifact to pass to the next job.
+#
+# 3. Publish to NPM:
+#    - Downloads the build artifact (`dist/`).
+#    - Publishes it to the npm registry using the `NPM_AUTH_TOKEN` secret.
+#
+# 🔑 Requirements:
+# - `secrets.PERSONAL_TOKEN` → A GitHub Personal Access Token with `repo` scope (used to push to protected `main`).
+# - `secrets.NPM_AUTH_TOKEN` → An npm token with publish rights.
+#
+# ✅ This ensures every commit to `main` automatically:
+#    → bumps the version
+#    → creates a GitHub Release
+#    → builds the package
+#    → publishes the compiled output to npm.
+#
+# ------------------------------------------------------------------------
+
+
+name: Release Git Package & Publish on NPM
 
 on:
   push:
     branches:
       - main
 
-permissions:
-  contents: write   # needed to push commits, tags, and create releases
-  packages: write   # needed for publishing GitHub packages (optional)
-  
 jobs:
   release:
     runs-on: ubuntu-latest
     outputs:
       version: ${{ steps.version.outputs.new_version }}
 
     steps:
-      # Checkout repo
       - name: Checkout code
         uses: actions/checkout@v4
 
-      # Setup Node.js
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '24'
+          node-version: 24
 
-      # Git identity (required for npm version)
       - name: Setup Git identity
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
 
-      # Install dependencies
       - name: Install dependencies
         run: npm install
 
-      # Bump version dynamically
       - name: Bump version
         id: version
         run: |
           NEW_VERSION=$(npm version patch -m "chore(release): v%s [skip ci]")
           echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
 
-      # Push changes (commit + tag)
-      - name: Push changes
+      - name: Push version bump and tag
         uses: ad-m/github-push-action@v0.8.0
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
+          github_token: ${{ secrets.PERSONAL_TOKEN }}   # ← use PAT, since main is protected
           branch: main
           tags: true
 
-      # Create GitHub Release
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
@@ -60,27 +79,50 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-  publish-npm:
-    needs: release   # ⬅ Runs only after release is successful
+  build:
+    needs: release
     runs-on: ubuntu-latest
-
     steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
+      - uses: actions/checkout@v4
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
+      - uses: actions/setup-node@v4
         with:
-          node-version: '24'
-          registry-url: 'https://registry.npmjs.org/'
+          node-version: 24
 
       - name: Install dependencies
         run: npm install
 
       - name: Build package
         run: npm run build
 
-      - name: Publish to NPM
-        run: npm publish --access public
+      - name: Archive build
+        run: tar -czf dist.tar.gz dist
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist.tar.gz
+
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org/
+
+      - name: Download build artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+
+      - name: Extract build
+        run: tar -xzf dist.tar.gz
+
+      - name: Publish to npm
+        run: npm publish dist --access public
         env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}