async-pipeline.yml

# Generated by async-pipeline. Do not edit by hand.
# Run: async-pipeline github generate

name: Async Pipeline

on:
  pull_request:
    types:
      - "opened"
      - "ready_for_review"
      - "reopened"
      - "synchronize"
  push:
    branches:
      - "main"
  release:
    types:
      - "published"
  workflow_dispatch:
    inputs:
      job:
        description: "Pipeline job to run"
        required: true
        type: choice
        options:
          - "pages"
          - "publish"
          - "release-doctor"
          - "verify"

permissions:
  contents: read

jobs:
  publish:
    name: publish
    if: (github.event_name == 'workflow_dispatch' && github.event.inputs.job == 'publish') || (github.event_name == 'release' && (github.event.action == 'published'))
    runs-on: ubuntu-latest
    environment:
      name: "npm-publish"
      url: "https://www.npmjs.com/package/@async/flow"
    permissions:
      contents: write
      id-token: write
      packages: write
    steps:
      - name: Checkout
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

      - name: Setup pnpm runtime
        uses: pnpm/setup@cf03a9b516e09bc5a90f041fc26fc930c9dc631b # v1.0.0
        with:
          version: 11.8.0
          runtime: node@24
          install: false
          cache: false

      - name: Use current npm
        run: npm install -g npm@11.16.0

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

      - name: Run pipeline task pack
        uses: async/actions/run@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          command: "pnpm async-pipeline github check && pnpm async-pipeline run-task pack"
          check-generated: false
          artifact-name: async-pipeline-${{ github.job }}-pack-runs
        env:
          CI: true

      - name: Plan release package
        uses: async/actions/doctor@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          mode: plan
          package-path: "."
          evidence-dir: .async/release
          release-command: "pnpm dlx github:async/release#v0.1.6"
        env:
          CI: true

      - name: Inspect release package
        uses: async/actions/doctor@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          mode: inspect
          package-path: "."
          evidence-dir: .async/release
          release-command: "pnpm dlx github:async/release#v0.1.6"
        env:
          CI: true

      - name: Check release changelog
        uses: async/actions/doctor@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          mode: changelog
          package-path: "."
          evidence-dir: .async/release
          release-command: "pnpm dlx github:async/release#v0.1.6"
        env:
          CI: true

      - name: Render release notes
        uses: async/actions/doctor@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          mode: notes
          package-path: "."
          evidence-dir: .async/release
          release-command: "pnpm dlx github:async/release#v0.1.6"
        env:
          CI: true

      - name: Create or update GitHub Release
        uses: async/actions/publish@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          package-path: "."
          mode: github-release
          registry: "https://registry.npmjs.org"
          dist-tag: "latest"
          notes-file: .async/release/release-notes.md
        env:
          CI: true
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Publish GitHub Packages mirror
        uses: async/actions/publish@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          package-path: "."
          mode: github-packages
          registry: "https://npm.pkg.github.com"
          dist-tag: "latest"
          token-env-name: GITHUB_TOKEN
        env:
          CI: true
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Publish npm package
        uses: async/actions/publish@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          package-path: "."
          mode: npm
          registry: "https://registry.npmjs.org"
          dist-tag: "latest"
          token-env-name: NODE_AUTH_TOKEN
          provenance: true
        env:
          CI: true
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

      - name: Run release doctor
        uses: async/actions/doctor@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          mode: doctor
          package-path: "."
          evidence-dir: .async/release
          release-command: "pnpm dlx github:async/release#v0.1.6"
          network: live
        env:
          CI: true
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

  release-doctor:
    name: release-doctor
    if: github.event_name == 'workflow_dispatch' && github.event.inputs.job == 'release-doctor'
    runs-on: ubuntu-latest
    permissions:
      contents: read
      packages: read
    steps:
      - name: Checkout
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

      - name: Setup pnpm runtime
        uses: pnpm/setup@cf03a9b516e09bc5a90f041fc26fc930c9dc631b # v1.0.0
        with:
          version: 11.8.0
          runtime: node@24
          install: false
          cache: false

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

      - name: Run pipeline task pack
        uses: async/actions/run@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          command: "pnpm async-pipeline github check && pnpm async-pipeline run-task pack"
          check-generated: false
          artifact-name: async-pipeline-${{ github.job }}-pack-runs
        env:
          CI: true

      - name: Run release doctor
        uses: async/actions/doctor@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          mode: doctor
          package-path: "."
          evidence-dir: .async/release
          release-command: "pnpm dlx github:async/release#v0.1.6"
          network: live
        env:
          CI: true
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

  snapshot:
    name: snapshot
    if: github.event_name == 'push' && (github.ref == 'refs/heads/main')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      packages: write
    steps:
      - name: Checkout
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

      - name: Setup pnpm runtime
        uses: pnpm/setup@cf03a9b516e09bc5a90f041fc26fc930c9dc631b # v1.0.0
        with:
          version: 11.8.0
          runtime: node@24
          install: false
          cache: false

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

      - name: Run pipeline task pack
        uses: async/actions/run@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          command: "pnpm async-pipeline github check && pnpm async-pipeline run-task pack"
          check-generated: false
          artifact-name: async-pipeline-${{ github.job }}-pack-runs
        env:
          CI: true

      - name: Plan main package preview
        run: pnpm dlx github:async/release#v0.1.6 preview plan --package . --mode main --namespace "${{ github.repository_owner }}" --source-repository "${{ github.repository }}" --source-sha "${{ github.sha }}" --evidence-dir .async/release --json

      - name: Stage main package preview
        run: pnpm dlx github:async/release#v0.1.6 preview stage --package . --mode main --namespace "${{ github.repository_owner }}" --source-repository "${{ github.repository }}" --source-sha "${{ github.sha }}" --evidence-dir .async/release --json --registry https://npm.pkg.github.com

      - name: Inspect main package preview
        run: pnpm dlx github:async/release#v0.1.6 preview inspect --package . --mode main --namespace "${{ github.repository_owner }}" --source-repository "${{ github.repository }}" --source-sha "${{ github.sha }}" --evidence-dir .async/release --json

      - name: Publish main package preview
        id: async-main-package-preview
        uses: async/actions/preview@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          package-path: "."
          target-registry: "https://npm.pkg.github.com"
          mode: main
          comment: false
          token-env-name: "GITHUB_TOKEN"
          release-package: "github:async/release#v0.1.6"
        env:
          CI: true
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Verify main package preview
        if: steps.async-main-package-preview.outputs.package-spec != ''
        run: pnpm dlx github:async/release#v0.1.6 preview doctor --package . --mode main --namespace "${{ github.repository_owner }}" --source-repository "${{ github.repository }}" --source-sha "${{ github.sha }}" --evidence-dir .async/release --json --registry https://npm.pkg.github.com --network live
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

  verify:
    name: verify
    if: (github.event_name == 'pull_request') || (github.event_name == 'push' && (github.ref == 'refs/heads/main')) || (github.event_name == 'release' && (github.event.action == 'published')) || (github.event_name == 'workflow_dispatch' && github.event.inputs.job == 'verify')
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

      - name: Setup pnpm runtime
        uses: pnpm/setup@cf03a9b516e09bc5a90f041fc26fc930c9dc631b # v1.0.0
        with:
          version: 11.8.0
          runtime: node@24
          install: false
          cache: false

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

      - name: Run pipeline job
        uses: async/actions/run@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          command: "pnpm async-pipeline github check && pnpm async-pipeline run verify"
          check-generated: false
          artifact-name: async-pipeline-${{ github.job }}-runs
        env:
          CI: true

  pages:
    name: pages
    if: github.event_name == 'pull_request' || (github.event_name == 'push' && (github.ref == 'refs/heads/main')) || (github.event_name == 'workflow_dispatch' && github.event.inputs.job == 'pages')
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

      - name: Setup pnpm runtime
        uses: pnpm/setup@cf03a9b516e09bc5a90f041fc26fc930c9dc631b # v1.0.0
        with:
          version: 11.8.0
          runtime: node@24
          install: false
          cache: false

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

      - name: Run Pages target
        uses: async/actions/run@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          command: "pnpm async-pipeline github check && pnpm async-pipeline run-task docs.site"
          check-generated: false
          artifact-name: async-pipeline-${{ github.job }}-runs
        env:
          CI: true

      - name: Upload Pages artifact
        uses: async/actions/pages@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          mode: static
          path: ".async/pages"

  pages-deploy:
    name: pages-deploy
    needs: "pages"
    if: github.event_name != 'pull_request'
    runs-on: ubuntu-latest
    environment:
      name: "github-pages"
      url: "${{ steps.deployment.outputs.page_url }}"
    permissions:
      pages: write
      id-token: write
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: async/actions/pages@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          upload: false
          deploy: true

  package-preview:
    name: package-preview
    if: github.event_name == 'pull_request' && github.event.pull_request.draft == false
    runs-on: ubuntu-latest
    permissions:
      contents: read
      issues: write
      packages: write
      pull-requests: write
    steps:
      - name: Checkout
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
          persist-credentials: false

      - name: Setup pnpm runtime
        uses: pnpm/setup@cf03a9b516e09bc5a90f041fc26fc930c9dc631b # v1.0.0
        with:
          version: 11.8.0
          runtime: node@24
          install: false
          cache: false

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

      - name: Run package preview target
        uses: async/actions/run@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          command: "pnpm async-pipeline github check && pnpm async-pipeline run-task pack"
          check-generated: false
          artifact-name: async-pipeline-${{ github.job }}-runs
        env:
          CI: true

      - name: Plan PR package preview
        run: pnpm dlx github:async/release#v0.1.6 preview plan --package . --mode pr --namespace "${{ github.repository_owner }}" --source-repository "${{ github.repository }}" --source-sha "${{ github.sha }}" --evidence-dir .async/release --json --pr-number "${{ github.event.pull_request.number }}" --head-sha "${{ github.event.pull_request.head.sha }}"

      - name: Stage PR package preview
        run: pnpm dlx github:async/release#v0.1.6 preview stage --package . --mode pr --namespace "${{ github.repository_owner }}" --source-repository "${{ github.repository }}" --source-sha "${{ github.sha }}" --evidence-dir .async/release --json --registry https://npm.pkg.github.com --pr-number "${{ github.event.pull_request.number }}" --head-sha "${{ github.event.pull_request.head.sha }}"

      - name: Inspect PR package preview
        run: pnpm dlx github:async/release#v0.1.6 preview inspect --package . --mode pr --namespace "${{ github.repository_owner }}" --source-repository "${{ github.repository }}" --source-sha "${{ github.sha }}" --evidence-dir .async/release --json --pr-number "${{ github.event.pull_request.number }}" --head-sha "${{ github.event.pull_request.head.sha }}"

      - name: Publish package preview
        id: async-package-preview
        uses: async/actions/preview@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          package-path: "."
          target-registry: "https://npm.pkg.github.com"
          mode: pr
          comment: true
          token-env-name: "GITHUB_TOKEN"
          release-package: "github:async/release#v0.1.6"
        env:
          CI: true
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Verify PR package preview
        if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && steps.async-package-preview.outputs.package-spec != ''
        run: pnpm dlx github:async/release#v0.1.6 preview doctor --package . --mode pr --namespace "${{ github.repository_owner }}" --source-repository "${{ github.repository }}" --source-sha "${{ github.sha }}" --evidence-dir .async/release --json --registry https://npm.pkg.github.com --network live --pr-number "${{ github.event.pull_request.number }}" --head-sha "${{ github.event.pull_request.head.sha }}"
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Comment package preview
        if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && steps.async-package-preview.outputs.comment-body != ''
        uses: async/actions/comment@ff415041176eaffaa2ba19363fe371188f52ee1f # v0.1.24
        with:
          mode: pr-comment
          repository: ${{ github.repository }}
          number: ${{ github.event.pull_request.number }}
          marker: ${{ steps.async-package-preview.outputs.comment-marker }}
          body: ${{ steps.async-package-preview.outputs.comment-body }}
          token: ${{ secrets.GITHUB_TOKEN }}