build-docs.yml

name: Build Documentation

on:
  workflow_call:
    inputs:
      version:
        description: 'Documentation version (latest or preview)'
        required: true
        type: string
      image_tag:
        description: 'Docker image tag to extract OpenAPI spec from'
        required: true
        type: string

permissions: {}

jobs:
  build:
    name: Build Documentation (${{ inputs.version }})
    runs-on: ubuntu-latest
    permissions:
      contents: read

    steps:
      - name: Checkout code
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

      - name: Login to DockerHub
        uses: docker/login-action@b45d80f862d83dbcd57f89517bcf500b2ab88fb2 # v4.0.0
        with:
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_TOKEN }}

      - name: Extract OpenAPI spec from Docker image
        run: |
          docker pull sdvd/server:${{ inputs.image_tag }}
          CONTAINER_ID=$(docker create sdvd/server:${{ inputs.image_tag }})
          mkdir -p docs/assets
          docker cp "$CONTAINER_ID:/data/openapi.json" docs/assets/openapi.json
          docker rm "$CONTAINER_ID"

      - name: Setup Bun
        uses: oven-sh/setup-bun@ecf28ddc73e819eb6fa29df6b34ef8921c743461 # v2.1.3

      - name: Install dependencies
        run: bun install
        working-directory: docs

      - name: Build documentation
        run: bun run build
        working-directory: docs
        env:
          DOCS_VERSION: ${{ inputs.version }}

      - name: Upload artifact
        uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
        with:
          name: docs-${{ inputs.version }}
          path: docs/.vitepress/dist
          retention-days: 14
          overwrite: true