MeshChatX/.github/workflows/build-linux-packages.yml

# Linux packaging build test: AppImage, deb, rpm, Flatpak (branches and PRs).
# Tagged release assets run in build-release.yml with draft.
#
# Pinned first-party actions (bump tag and SHA together when upgrading):
#   actions/checkout@v6.0.1            8e8c483db84b4bee98b60c0593521ed34d9990e8
#   actions/upload-artifact@v5.0.0     330a01c490aca151604b8cf639adc76d48f6c5d4
#   actions/cache@v4.2.0               1bd1e32a3bdc45362d1e726936510720a7c30a57

name: Build Linux packages

on:
    push:
        branches:
            - dev
    pull_request:
        branches:
            - dev
        paths:
            - "package.json"
            - "scripts/ensure-flatpak-flathub-remote.sh"
            - "scripts/ci/github-build-linux-*.sh"
            - "scripts/ci/github-warm-appimage-tools.sh"
            - ".github/workflows/build-linux-packages.yml"
            - ".github/workflows/build-release.yml"
            - ".github/workflows/frontend-build.yml"
            - ".github/actions/**"
    workflow_dispatch:

permissions:
    contents: read

concurrency:
    group: linux-packages-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
    cancel-in-progress: true

env:
    FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
    NODE_OPTIONS: --max-old-space-size=8192
    PYTHON_VERSION: "3.14"
    NODE_VERSION: "24"
    UV_VERSION: "0.11.15"
    PNPM_VERSION: "11.1.2"

jobs:
    frontend:
        name: Build frontend artifact
        uses: ./.github/workflows/frontend-build.yml
        permissions:
            contents: read
        with:
            artifact_name: meshchatx-frontend-linux-pkg-${{ github.run_id }}-${{ github.run_attempt }}
            retention_days: 1

    linux-test:
        name: Linux build test (${{ matrix.arch }})
        needs: frontend
        strategy:
            fail-fast: false
            matrix:
                include:
                    - arch: x64
                      runner: ubuntu-latest
                    - arch: arm64
                      runner: ubuntu-24.04-arm
        runs-on: ${{ matrix.runner }}
        timeout-minutes: 120
        permissions:
            contents: read
        env:
            FRONTEND_ARTIFACT_NAME: ${{ needs.frontend.outputs.artifact_name }}
            MESHCHATX_FRONTEND_PREBUILT: "1"
        steps:
            - name: Checkout
              uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8

            - name: Set up Python and UV
              uses: ./.github/actions/setup-python-uv
              with:
                  python-version: ${{ env.PYTHON_VERSION }}
                  uv-version: ${{ env.UV_VERSION }}

            - name: Set up Node and pnpm
              uses: ./.github/actions/setup-node-pnpm
              with:
                  node-version: ${{ env.NODE_VERSION }}
                  pnpm-version: ${{ env.PNPM_VERSION }}

            - name: Cache electron-builder toolsets
              uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57
              with:
                  path: ~/.cache/electron-builder
                  key: electron-builder-${{ runner.os }}-${{ runner.arch }}-${{ hashFiles('pnpm-lock.yaml', 'package.json') }}
                  restore-keys: |
                      electron-builder-${{ runner.os }}-${{ runner.arch }}-

            - name: Linux packaging APT dependencies
              run: bash scripts/ci/github-apt-linux-packaging.sh

            - name: Install dependencies
              run: bash scripts/ci/github-install-deps.sh

            - name: Fetch frontend artifact
              uses: ./.github/actions/fetch-frontend-artifact
              with:
                  artifact-name: ${{ env.FRONTEND_ARTIFACT_NAME }}

            - name: Setup Task
              env:
                  GITHUB_TOKEN: ${{ github.token }}
              run: sh scripts/ci/setup-task.sh

            - name: Build release-assets
              env:
                  GITHUB_TOKEN: ${{ github.token }}
              run: bash scripts/ci/github-build-linux-release-assets.sh

            - name: Upload Linux build-test artifact (${{ matrix.arch }})
              uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4
              with:
                  name: meshchatx-linux-build-test-${{ matrix.arch }}-${{ github.ref_name }}-${{ github.run_id }}
                  path: release-assets/
                  if-no-files-found: warn
                  retention-days: 1

    flatpak:
        name: Flatpak (electron-builder)
        needs: frontend
        runs-on: ubuntu-latest
        timeout-minutes: 90
        permissions:
            contents: read
        env:
            FRONTEND_ARTIFACT_NAME: ${{ needs.frontend.outputs.artifact_name }}
            MESHCHATX_FRONTEND_PREBUILT: "1"
        steps:
            - name: Checkout
              uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8

            - name: Install flatpak toolchain
              run: |
                  set -euo pipefail
                  sudo apt-get update -y
                  sudo apt-get install -y --no-install-recommends \
                      flatpak \
                      flatpak-builder \
                      elfutils \
                      zstd \
                      desktop-file-utils \
                      appstream

            - name: Install flatpak runtimes (user scope)
              run: |
                  set -euo pipefail
                  bash scripts/ensure-flatpak-flathub-remote.sh
                  flatpak --user install -y --noninteractive flathub \
                      org.freedesktop.Platform//25.08 \
                      org.freedesktop.Sdk//25.08 \
                      org.electronjs.Electron2.BaseApp//25.08

            - name: Set up development environment
              uses: ./.github/actions/setup-dev-environment
              with:
                  python-version: ${{ env.PYTHON_VERSION }}
                  uv-version: ${{ env.UV_VERSION }}
                  node-version: ${{ env.NODE_VERSION }}
                  pnpm-version: ${{ env.PNPM_VERSION }}

            - name: Fetch frontend artifact
              uses: ./.github/actions/fetch-frontend-artifact
              with:
                  artifact-name: ${{ env.FRONTEND_ARTIFACT_NAME }}

            - name: Build flatpak bundle
              run: bash scripts/ci/github-build-linux-flatpak.sh

            - name: List flatpak output
              run: |
                  set -euo pipefail
                  ls -la dist 2>/dev/null || true
                  find dist -maxdepth 3 -type f \( -name "*.flatpak" -o -name "*.flatpakref" \) -print

            - name: Upload flatpak artifact
              uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4
              with:
                  name: meshchatx-linux-flatpak-${{ github.ref_name }}-${{ github.run_id }}
                  path: dist/*.flatpak
                  if-no-files-found: error
                  retention-days: 7