Merge pull request #6 from rdbumstead/feat/v2.1.0-release

feat: Release v2.1.0 - Multi-Auth Support, Cache Granularity, and Docs Overhaul

Author: rdbumstead

.github/workflows/test.yml

@@ -271,6 +271,111 @@ jobs:
           echo "✅ Cache behavior test completed"
           echo "Check action logs to verify cache hit on second run"
 
+  test-cache-granularity:
+    name: Cache Granularity (v2.1)
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup with Major Cache Granularity
+        id: setup-major
+        uses: ./
+        with:
+          skip_auth: "true"
+          cli_version_for_cache: "major"
+
+      - name: Setup with Minor Cache Granularity
+        id: setup-minor
+        uses: ./
+        with:
+          skip_auth: "true"
+          cli_version_for_cache: "minor"
+
+      - name: Setup with Exact Cache Granularity
+        id: setup-exact
+        uses: ./
+        with:
+          skip_auth: "true"
+          cli_version_for_cache: "exact"
+
+      - name: Verify
+        run: |
+          echo "✅ Cache granularity test completed"
+          echo "All three granularity options accepted: major, minor, exact"
+
+  test-sfdx-url-auth:
+    name: SFDX Auth URL (v2.1)
+    runs-on: ubuntu-latest
+    if: github.repository_owner == 'rdbumstead' || github.event_name == 'workflow_dispatch'
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup with SFDX Auth URL
+        id: setup-sfdx-url
+        uses: ./
+        with:
+          auth_method: "sfdx-url"
+          sfdx_auth_url: ${{ secrets.SFDX_AUTH_URL }}
+
+      - name: Verify SFDX URL Auth
+        run: |
+          echo "Testing SFDX Auth URL authentication..."
+          sf org display
+
+          echo "Verifying outputs..."
+          echo "Org ID: ${{ steps.setup-sfdx-url.outputs.org_id }}"
+          echo "Auth Performed: ${{ steps.setup-sfdx-url.outputs.auth_performed }}"
+          echo "API Version: ${{ steps.setup-sfdx-url.outputs.api_version }}"
+
+          if [ -z "${{ steps.setup-sfdx-url.outputs.org_id }}" ]; then
+            echo "❌ org_id output is empty"
+            exit 1
+          fi
+
+          echo "✅ SFDX Auth URL authentication successful"
+
+  test-new-outputs:
+    name: New Outputs (v2.1)
+    runs-on: ubuntu-latest
+    if: github.repository_owner == 'rdbumstead' || github.event_name == 'workflow_dispatch'
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Salesforce
+        id: setup-sf
+        uses: ./
+        with:
+          jwt_key: ${{ secrets.SFDX_JWT_KEY }}
+          client_id: ${{ secrets.SFDX_CLIENT_ID }}
+          username: ${{ vars.SFDX_USERNAME }}
+
+      - name: Verify New Outputs
+        run: |
+          echo "Testing new v2.1 outputs..."
+
+          echo "api_version: ${{ steps.setup-sf.outputs.api_version }}"
+          echo "auth_performed: ${{ steps.setup-sf.outputs.auth_performed }}"
+
+          # Verify api_version is not empty
+          if [ -z "${{ steps.setup-sf.outputs.api_version }}" ]; then
+            echo "❌ api_version output is empty"
+            exit 1
+          fi
+
+          # Verify auth_performed is true
+          if [ "${{ steps.setup-sf.outputs.auth_performed }}" != "true" ]; then
+            echo "❌ auth_performed should be 'true'"
+            exit 1
+          fi
+
+          echo "✅ New outputs verified"
+
   test-network-retry:
     name: Network Retry Logic
     runs-on: ubuntu-latest
@@ -376,6 +481,9 @@ jobs:
       - test-custom-alias
       - test-error-handling
       - test-cache-behavior
+      - test-cache-granularity
+      - test-sfdx-url-auth
+      - test-new-outputs
       - test-network-retry
       - test-invalid-plugins
       - test-source-flags
@@ -462,6 +570,32 @@ jobs:
             echo "❌ **Source Flags Output**: Failed" >> $GITHUB_STEP_SUMMARY
           fi
 
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### v2.1 Features" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+
+          if [ "${{ needs.test-cache-granularity.result }}" = "success" ]; then
+            echo "✅ **Cache Granularity**: Passed" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **Cache Granularity**: Failed" >> $GITHUB_STEP_SUMMARY
+          fi
+
+          if [ "${{ needs.test-sfdx-url-auth.result }}" = "success" ]; then
+            echo "✅ **SFDX Auth URL**: Passed" >> $GITHUB_STEP_SUMMARY
+          elif [ "${{ needs.test-sfdx-url-auth.result }}" = "skipped" ]; then
+            echo "⏭️ **SFDX Auth URL**: Skipped (no secrets)" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **SFDX Auth URL**: Failed" >> $GITHUB_STEP_SUMMARY
+          fi
+
+          if [ "${{ needs.test-new-outputs.result }}" = "success" ]; then
+            echo "✅ **New Outputs (v2.1)**: Passed" >> $GITHUB_STEP_SUMMARY
+          elif [ "${{ needs.test-new-outputs.result }}" = "skipped" ]; then
+            echo "⏭️ **New Outputs (v2.1)**: Skipped (no secrets)" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **New Outputs (v2.1)**: Failed" >> $GITHUB_STEP_SUMMARY
+          fi
+
           echo "" >> $GITHUB_STEP_SUMMARY
           echo "---" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
@@ -502,6 +636,11 @@ jobs:
             CRITICAL_FAILED=true
           fi
 
+          if [ "${{ needs.test-cache-granularity.result }}" != "success" ]; then
+            echo "❌ Critical test failed: Cache Granularity"
+            CRITICAL_FAILED=true
+          fi
+
           if [ "$CRITICAL_FAILED" = true ]; then
             echo ""
             echo "❌ One or more critical tests failed"

CHANGELOG.md

@@ -5,6 +5,52 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.0] - 2026-01-15
+
+### Added - Multiple Authentication Methods 🔐
+
+- **SFDX Auth URL authentication** (`auth_method: 'sfdx-url'`)
+
+  - Simpler alternative to JWT - no certificate required
+  - Uses refresh token from SFDX Auth URL
+  - New input: `sfdx_auth_url`
+
+- **Access Token authentication** (`auth_method: 'access-token'`)
+
+  - Direct access token authentication for advanced use cases
+  - New input: `access_token`
+  - Warning: Access tokens are short-lived
+
+- **New `auth_method` input** to select authentication type
+  - Options: `jwt` (default), `sfdx-url`, `access-token`
+  - Backward compatible - existing JWT workflows work unchanged
+
+### Added - Cache Granularity Control ⚡
+
+- **New `cli_version_for_cache` input** to control cache key granularity
+  - `major` - Cache busts only on major CLI version changes
+  - `minor` - Cache busts on minor version changes (default)
+  - `exact` - Cache busts on every CLI version change
+  - Improves cache hit rates for teams using `cli_version: 'latest'`
+
+### Added - New Outputs 📊
+
+- **`api_version`** - Salesforce API version for the authenticated org
+- **`auth_performed`** - Whether authentication was performed (`true`/`false`)
+
+### Changed - Improvements
+
+- Cache key format updated to `sf-v3-*` for new cache strategy
+- Improved sandbox and scratch org detection logic
+- Better logging with tree-formatted output
+- Environment variables used for sensitive auth data (more secure)
+
+### Fixed 🐞
+
+- Custom plugin installation loop now correctly installs plugins
+
+---
+
 ## [2.0.1] - 2026-01-15
 
 ### Fixed 🐞
@@ -156,6 +202,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+[2.1.0]: https://github.com/rdbumstead/setup-salesforce-action/releases/tag/v2.1.0
+[2.0.1]: https://github.com/rdbumstead/setup-salesforce-action/releases/tag/v2.0.1
 [2.0.0]: https://github.com/rdbumstead/setup-salesforce-action/releases/tag/v2.0.0
 [1.1.1]: https://github.com/rdbumstead/setup-salesforce-action/releases/tag/v1.1.1
 [1.1.0]: https://github.com/rdbumstead/setup-salesforce-action/releases/tag/v1.1.0