punktfunk/.gitea/workflows/decky.yml

# Build the punktfunk Decky Loader plugin (Gaming-Mode QAM launcher) into a distribution zip
# and publish it to Gitea's GENERIC package registry, giving Decky's "install from URL" a
# stable link. On tags the zip is ALSO attached to the Gitea release.
#
#   PUT/GET  https://git.unom.io/api/packages/unom/generic/punktfunk-decky/<version>/punktfunk.zip
#
# The plugin backend is PURE PYTHON (clients/decky/main.py — no compiled binary), so we do NOT
# need the Decky CLI (which requires Docker + rust-nightly only to compile native backends).
# We build the frontend with pnpm and assemble the store-layout zip by hand:
#
#   punktfunk.zip
#     punktfunk/                  <- single top-level dir == plugin.json "name"
#       plugin.json   [required]
#       package.json  [required]
#       main.py       [required: python backend]
#       dist/index.js [required: rollup output]
#       README.md     (recommended)
#       LICENSE       [required by the plugin store]
#
# REGISTRY_TOKEN: repo Actions secret, a PAT with write:package scope (shared with deb/rpm/docker).
name: decky

on:
  push:
    branches: [main]
    tags: ['v*']
  workflow_dispatch:

env:
  REGISTRY: git.unom.io
  OWNER: unom
  PACKAGE: punktfunk-decky        # generic-registry package name
  PLUGIN: punktfunk               # plugin.json "name" == zip top-level dir

jobs:
  build-publish:
    runs-on: ubuntu-24.04
    timeout-minutes: 30
    container:
      image: node:22-bookworm     # node + corepack(pnpm); matches the @decky toolchain
    defaults:
      run:
        working-directory: clients/decky
    steps:
      - uses: actions/checkout@v4

      - name: pnpm
        run: |
          corepack enable
          # The repo's pnpm-lock.yaml + package.json devDeps target pnpm 9 (the version the
          # @decky toolchain and the local build use). Pin it so --frozen-lockfile holds.
          corepack prepare pnpm@9 --activate

      - name: Build frontend
        run: |
          pnpm install --frozen-lockfile
          pnpm run build          # rollup -> clients/decky/dist/index.js

      - name: Version + channel
        # Tag vX.Y.Z -> X.Y.Z (stable `latest/` alias + Gitea Release); main push -> 0.3.0-ciN.g<sha>
        # (`canary/` alias). Used for the registry version path + the zip name (the plugin.json
        # version is the source of truth Decky reads after install — bump it in the release commit).
        working-directory: ${{ gitea.workspace }}
        run: |
          SHORT=$(echo "$GITHUB_SHA" | cut -c1-8)
          case "$GITHUB_REF" in
            refs/tags/v*) V="${GITHUB_REF_NAME#v}"; ALIAS=latest ;;
            *)            V="0.3.0-ci${GITHUB_RUN_NUMBER}.g${SHORT}"; ALIAS=canary ;;
          esac
          echo "VERSION=$V" >> "$GITHUB_ENV"
          echo "ALIAS=$ALIAS" >> "$GITHUB_ENV"
          echo "decky version $V -> alias '$ALIAS'"

      - name: Assemble store-layout zip
        working-directory: ${{ gitea.workspace }}
        run: |
          apt-get update && apt-get install -y --no-install-recommends zip >/dev/null
          STAGE="$RUNNER_TEMP/decky"
          DEST="$STAGE/$PLUGIN"
          rm -rf "$STAGE"; mkdir -p "$DEST/dist" "$DEST/bin"
          cp clients/decky/plugin.json   "$DEST/"
          cp clients/decky/package.json  "$DEST/"
          cp clients/decky/main.py       "$DEST/"
          cp clients/decky/dist/index.js "$DEST/dist/"
          cp clients/decky/README.md     "$DEST/"
          # The stream-launch wrapper (target of the Steam shortcut); keep it executable
          # (runner_info() also re-chmods at runtime in case the zip/extract drops the bit).
          cp clients/decky/bin/punktfunkrun.sh "$DEST/bin/"
          chmod 0755 "$DEST/bin/punktfunkrun.sh"
          # Store requires a LICENSE in the plugin root; the project is MIT OR Apache-2.0.
          cp LICENSE-MIT                 "$DEST/LICENSE"
          ( cd "$STAGE" && zip -r "$RUNNER_TEMP/punktfunk.zip" "$PLUGIN" )
          ls -lh "$RUNNER_TEMP/punktfunk.zip"
          unzip -l "$RUNNER_TEMP/punktfunk.zip"

      - name: Publish to the Gitea generic registry
        working-directory: ${{ gitea.workspace }}
        env:
          TOKEN: ${{ secrets.REGISTRY_TOKEN }}
        run: |
          BASE="https://$REGISTRY/api/packages/$OWNER/generic/$PACKAGE"
          # 1) Immutable, versioned URL.
          curl -fsS --user "enricobuehler:$TOKEN" --upload-file "$RUNNER_TEMP/punktfunk.zip" \
            "$BASE/$VERSION/punktfunk.zip"
          echo "published $BASE/$VERSION/punktfunk.zip"
          # 2) Channel alias (stable release -> latest/, canary main build -> canary/) — the link
          #    to paste into Decky's "install from URL". The generic registry rejects re-uploading
          #    an existing version/file (409), so delete the prior alias first (ignore 404 on run #1).
          curl -fsS -o /dev/null --user "enricobuehler:$TOKEN" -X DELETE \
            "$BASE/$ALIAS/punktfunk.zip" || true
          curl -fsS --user "enricobuehler:$TOKEN" --upload-file "$RUNNER_TEMP/punktfunk.zip" \
            "$BASE/$ALIAS/punktfunk.zip"
          echo "install-from-URL link: $BASE/$ALIAS/punktfunk.zip"

      - name: Attach zip to the Gitea release (stable tags only)
        if: startsWith(gitea.ref, 'refs/tags/v')
        working-directory: ${{ gitea.workspace }}
        env:
          GITEA_TOKEN: ${{ secrets.REGISTRY_TOKEN }}
        run: |
          . scripts/ci/gitea-release.sh
          RID=$(ensure_release "$GITHUB_REF_NAME" "$GITHUB_REF_NAME" auto)
          upsert_asset "$RID" "$RUNNER_TEMP/punktfunk.zip" "punktfunk-${VERSION}.zip"