Ekklesia/.github/workflows/publish-packages.yml

name: Publish packages

# Publishes one public @ekklesia/* package train (ADR 0053, docs/development/releases.md) to the
# npm registry: exactly the artifacts this run's package-release gate proves, and nothing else.
#
# Only ever started by hand, on `main`, by someone with write access to this repository: no pull
# request or push can start it. It needs the version-set commit of a release (`version` must equal
# the platform version there), and the repository secret EKKLESIA_PACKAGES_PUBLISH_TOKEN, a token of
# the dedicated publisher account with only the `write:package` scope. Packages are publicly
# readable (ADR 0054); publishing is what this protects.

on:
  workflow_dispatch:
    inputs:
      version:
        description: The package train version to publish, equal to the platform version on main.
        required: true
        type: string

permissions:
  contents: read

# Never cancel a publication part way, and never run two at once. A rerun resumes safely.
concurrency:
  group: publish-packages
  cancel-in-progress: false

env:
  # The only registry-specific setting: where the train is published.
  EKKLESIA_PACKAGES_REGISTRY: https://git.zayin.net/api/packages/Zayin/npm/

jobs:
  package-release:
    if: github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    timeout-minutes: 20
    outputs:
      version: ${{ steps.release.outputs.version }}
      revision: ${{ steps.release.outputs.revision }}
      manifest_sha256: ${{ steps.release.outputs.manifest_sha256 }}
    steps:
      - name: Check out repository
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false

      - name: Set up Node.js
        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
        with:
          node-version-file: .node-version

      - name: Activate pinned pnpm
        run: |
          corepack enable
          corepack prepare [email protected] --activate

      - name: Install dependencies
        run: pnpm install --frozen-lockfile

      # The same credential-free gate as CI: build, reproduce, and consume the train.
      - name: Build, reproduce, and consume the public package train
        run: pnpm test:package-release --keep package-train

      - name: Describe the proven release train
        id: release
        run: |
          release="$(find package-train -mindepth 1 -maxdepth 1 -type d)"
          manifest="$release/ekklesia-package-train.json"
          {
            echo "version=$(node -p 'JSON.parse(require("fs").readFileSync(process.argv[1], "utf8")).version' "$manifest")"
            echo "revision=$(node -p 'JSON.parse(require("fs").readFileSync(process.argv[1], "utf8")).source.revision' "$manifest")"
            echo "manifest_sha256=$(sha256sum "$manifest" | cut -d' ' -f1)"
          } >>"$GITHUB_OUTPUT"

      # Artifact actions version 3: version 4 refuses any server that is not github.com. The directory
      # name must not start with a dot: the artifact actions leave hidden files out.
      - name: Hand the release train on
        uses: actions/upload-artifact@c6a3b2bd78b3985e4b2f15397fec357f0fd808de # v3.2.2-node20
        with:
          name: package-train
          path: package-train/
          if-no-files-found: error
          retention-days: 90

  publish:
    needs: package-release
    if: github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
      # Only for the publication tool itself: nothing is built or installed in this job.
      - name: Check out repository
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false

      - name: Set up Node.js
        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
        with:
          node-version-file: .node-version

      - name: Receive the release train the gate proved
        uses: actions/download-artifact@ad191675b41f6a5b46da9a048cb6893812da158b # v3.1.0-node20
        with:
          name: package-train
          path: package-train/

      # The tool validates the whole train against its manifest, that manifest against the gate's,
      # its version against the request, and its revision against this commit, before it sends
      # anything; then publishes, verifies every package byte for byte, and moves `latest` last.
      - name: Publish the exact release train
        env:
          EKKLESIA_PACKAGES_PUBLISH_TOKEN: ${{ secrets.EKKLESIA_PACKAGES_PUBLISH_TOKEN }}
          TRAIN_VERSION: ${{ inputs.version }}
          TRAIN_REVISION: ${{ github.sha }}
          MANIFEST_SHA256: ${{ needs.package-release.outputs.manifest_sha256 }}
        run: |
          node scripts/publish-package-train.ts \
            --release "$(find package-train -mindepth 1 -maxdepth 1 -type d)" \
            --registry "$EKKLESIA_PACKAGES_REGISTRY" \
            --version "$TRAIN_VERSION" \
            --revision "$TRAIN_REVISION" \
            --manifest-sha256 "$MANIFEST_SHA256" \
            --record publication-record.json \
            --require-public-read

      - name: Keep the publication record
        uses: actions/upload-artifact@c6a3b2bd78b3985e4b2f15397fec357f0fd808de # v3.2.2-node20
        with:
          name: package-train-publication-record
          path: publication-record.json
          if-no-files-found: error
          retention-days: 90