packaging.yml

name: Packaging

on:
  workflow_call:
    inputs:
      package:
        description: Package Directory ("managed" or "unlocked")
        default: unlocked
        required: false
        type: string
      promote-package:
        description: Promote New Package Version?
        default: false
        required: false
        type: boolean
      skip-validation:
        description: Skip validation and code coverage checks
        default: false
        required: false
        type: boolean
      version:
        description: Version Number (#.#.#)
        required: false
        type: string
    outputs:
      version-id:
        description: "Package Version ID"
        value: ${{ jobs.create-package-version.outputs.version-id }}
  workflow_dispatch:
    inputs:
      package:
        description: Package Directory ("managed" or "unlocked")
        default: unlocked
        required: false
        type: string
      promote-package:
        description: Promote New Package Version?
        default: false
        required: false
        type: boolean
      skip-validation:
        description: Skip validation and code coverage checks
        default: false
        required: false
        type: boolean
      version:
        description: Version Number (#.#.#)
        required: false
        type: string

jobs:
  create-package-version:
    name: Create Package Version
    outputs:
      version-id: ${{ steps.create-package.outputs.version-id }}
    permissions:
      contents: write
    runs-on: ubuntu-latest
    timeout-minutes: 30
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          ref: main

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: lts/*
          cache: "npm"

      - name: Setup NPM
        shell: bash
        run: npm ci

      - name: Setup SF CLI
        uses: ./.github/actions/setup-sf-cli

      - name: Authenticate Devhub
        env:
          CLIENT_ID: ${{ secrets.SALESFORCE_CONSUMER_KEY }}
          JWT_KEY: ${{ secrets.SALESFORCE_JWT_KEY }}
          USERNAME: ${{ secrets.SALESFORCE_DEVHUB_USERNAME }}
        shell: bash
        run: |
          set -euo pipefail
          echo "${JWT_KEY}" > server.key
          sf org login jwt \
            --client-id "$CLIENT_ID" \
            --jwt-key-file server.key \
            --set-default-dev-hub \
            --username "$USERNAME"
          trap 'rm -f server.key' EXIT

      - name: Switch Package Context
        shell: bash
        run: |
          # Validate package directory and sfdx-project.json file exist
          if [[ ! -f "packages/${{ inputs.package }}/sfdx-project.json" ]]; then
            echo "ERROR: 'packages/${{ inputs.package }}/sfdx-project.json' not found"
            exit 1
          fi
          # Swap the sfdx-project.json file for the one listed in the package directory
          mkdir -p tmp
          mv sfdx-project.json tmp/
          cp "packages/${{ inputs.package }}/sfdx-project.json" .

      - name: Get Version Number
        id: get-version
        env:
          INPUT_VERSION: ${{ inputs.version }}
        shell: bash
        run: |
          # If an input version number isn't set, use the current version defined in sfdx-project.json:
          if [[ -z "$INPUT_VERSION" ]]; then
            VERSION_NUMBER=$(jq -r '.packageDirectories[] | select(.default == true) | .versionNumber' sfdx-project.json)
            echo "Using the version number defined in sfdx-project.json: $VERSION_NUMBER"
          else
            VERSION_NUMBER="${INPUT_VERSION}.NEXT"
            echo "Using specified version number: $VERSION_NUMBER"
          fi
          # Create version name by removing .NEXT suffix
          VERSION_NAME="v${VERSION_NUMBER%.NEXT}"
          echo "version-number=$VERSION_NUMBER" >> "$GITHUB_OUTPUT"
          echo "version-name=$VERSION_NAME" >> "$GITHUB_OUTPUT"

      - name: Update Package Version
        shell: bash
        env:
          VERSION_NUMBER: ${{ steps.get-version.outputs.version-number }}
          VERSION_NAME: ${{ steps.get-version.outputs.version-name }}
        run: |
          # Update the version number/name in both project files:
          # Update the package file
          jq --arg vn "$VERSION_NUMBER" --arg vnm "$VERSION_NAME" \
            '.packageDirectories[0].versionNumber = $vn | .packageDirectories[0].versionName = $vnm' \
            sfdx-project.json > sfdx-project.json.tmp && mv sfdx-project.json.tmp sfdx-project.json
          # Update version in the original root file
          jq --arg vn "$VERSION_NUMBER" --arg vnm "$VERSION_NAME" \
            '.packageDirectories[0].versionNumber = $vn | .packageDirectories[0].versionName = $vnm' \
            tmp/sfdx-project.json > tmp/sfdx-project.json.tmp && mv tmp/sfdx-project.json.tmp tmp/sfdx-project.json

      - name: Create New Package Version
        id: create-package
        env:
          VERSION_NUMBER: ${{ steps.get-version.outputs.version-number }}
          WIKI_URL: "https://github.com/jasonsiders/apex-database-layer/wiki"
        shell: bash
        run: |
          set -euo pipefail
          PACKAGE_ALIAS=$(jq -r '.packageDirectories[] | select(.default == true) | .package' sfdx-project.json)
          VALIDATION_FLAG=$([[ "${{ inputs.skip-validation }}" == "true" ]] && echo "skip-validation" || echo "code-coverage")
          COMMAND="sf package version create --$VALIDATION_FLAG --installation-key-bypass --json --package \"$PACKAGE_ALIAS\" --post-install-url \"$WIKI_URL\" --wait 29"
          echo "$COMMAND"
          if RESULT=$(eval "$COMMAND" 2>&1); then
            # Success - extract version ID
            VERSION_ID=$(echo "$RESULT" | jq -r '.result.SubscriberPackageVersionId')
            echo "Package Version ID: $VERSION_ID"
            echo "version-id=$VERSION_ID" >> "$GITHUB_OUTPUT"
            [[ -n "$VERSION_ID" && "$VERSION_ID" != "null" ]] || { echo "ERROR: Invalid version ID"; exit 1; }
          else
            echo "::error::Package creation failed: $RESULT"
            exit 1
          fi

      - name: Promote Package Version
        if: ${{ inputs.promote-package == 'true' }}
        env:
          PACKAGE_TYPE: ${{ inputs.package }}
          VERSION_ID: ${{ steps.create-package.outputs.version-id }}
          VERSION_NAME: ${{ steps.get-version.outputs.version-name }}
        shell: bash
        run: |
          set -euo pipefail
          sf package version promote --package "$VERSION_ID" --no-prompt
          echo "::success:: Promoted $PACKAGE_TYPE package $VERSION_NAME - $VERSION_ID"

      - name: Run Prettier
        shell: bash
        run: |
          # Run Prettier on sfdx-project.json files, since packaging overwrites spacing:
          npx prettier -w sfdx-project.json
          npx prettier -w tmp/sfdx-project.json

      - name: Cleanup
        shell: bash
        run: |
          # Relocate root & package's project files back to their original location
          cp sfdx-project.json "packages/${{ inputs.package }}/" 
          mv tmp/sfdx-project.json .         
          rm -rf tmp/

      - name: Pull Latest Changes
        shell: bash
        run: |
          git fetch origin main
          git rebase origin/main || {
            echo "Rebase failed, trying merge strategy"
            git rebase --abort 2>/dev/null || true
            git pull --no-rebase origin main
          }

      - name: Tag & Commit Changes
        uses: "stefanzweifel/git-auto-commit-action@v6"
        with:
          commit_message: "Packaged new ${{ inputs.package }} version ${{ steps.get-version.outputs.version-name }}"
          skip_dirty_check: true