name: Documentation on: push: paths: - 'packages/*/src/**' - '!packages/create-discord-bot/**' - '!packages/proxy-container/**' - '!packages/ui/**' tags: - '**' workflow_dispatch: inputs: ref: description: 'The tag to checkout' required: true concurrency: group: ${{ github.workflow }}-${{ github.head_ref || github.ref }} cancel-in-progress: true jobs: build-docs: name: Build & upload documentation runs-on: ubuntu-latest env: TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }} TURBO_TEAM: ${{ secrets.TURBO_TEAM }} if: github.repository_owner == 'discordjs' steps: - name: Checkout repository uses: actions/checkout@v4 with: ref: ${{ inputs.ref || '' }} - name: Install Node.js v20 uses: actions/setup-node@v4 with: node-version: 20 - name: Install dependencies uses: ./packages/actions/src/pnpmCache - name: Build dependencies run: pnpm run build - name: Checkout main repository uses: actions/checkout@v4 with: path: 'main' - name: Build main shell: bash run: | cd main pnpm install --frozen-lockfile --prefer-offline --loglevel error pnpm run build cd .. - name: Extract package and semver from tag id: extract-tag uses: ./packages/actions/src/formatTag with: tag: ${{ inputs.ref || github.ref_name }} - name: Build docs run: pnpm run docs - name: Build docs with main api-extractor run: | declare -a PACKAGES=("brokers" "builders" "collection" "core" "discord.js" "formatters" "next" "proxy" "rest" "util" "voice" "ws") for PACKAGE in "${PACKAGES[@]}"; do cd "packages/${PACKAGE}" sed -i 's!https://github.com/discordjs/discord.js/tree/main!https://github.com/discordjs/discord.js/tree/${{ inputs.ref || github.ref_name }}!' api-extractor.json ../../main/packages/api-extractor/bin/api-extractor run --local --minify ../../main/packages/scripts/bin/generateSplitDocumentation.js cd ../.. done - name: Checkout docs repository uses: actions/checkout@v4 with: repository: 'discordjs/docs' token: ${{ secrets.DJS_DOCS }} path: 'out' - name: Upload documentation to database env: DATABASE_URL: ${{ secrets.DATABASE_URL }} CF_D1_DOCS_API_KEY: ${{ secrets.CF_D1_DOCS_API_KEY }} CF_D1_DOCS_ID: ${{ secrets.CF_D1_DOCS_ID }} CF_ACCOUNT_ID: ${{ secrets.CF_ACCOUNT_ID }} BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }} CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }} CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }} CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }} CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }} CF_R2_DOCS_BUCKET_URL: ${{ secrets.CF_R2_DOCS_BUCKET_URL }} uses: ./main/packages/actions/src/uploadDocumentation with: package: ${{ steps.extract-tag.outputs.package }} version: ${{ steps.extract-tag.outputs.semver }} - name: Upload split documentation to blob storage env: BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }} CF_R2_DOCS_URL: ${{ secrets.CF_R2_DOCS_URL }} CF_R2_DOCS_ACCESS_KEY_ID: ${{ secrets.CF_R2_DOCS_ACCESS_KEY_ID }} CF_R2_DOCS_SECRET_ACCESS_KEY: ${{ secrets.CF_R2_DOCS_SECRET_ACCESS_KEY }} CF_R2_DOCS_BUCKET: ${{ secrets.CF_R2_DOCS_BUCKET }} uses: ./main/packages/actions/src/uploadSplitDocumentation with: package: ${{ steps.extract-tag.outputs.package }} version: ${{ steps.extract-tag.outputs.semver }} - name: Move docs to correct directory env: PACKAGE: ${{ steps.extract-tag.outputs.package }} SEMVER: ${{ steps.extract-tag.outputs.semver }} run: | mkdir -p "out/${PACKAGE}" if [[ "${PACKAGE}" == "discord.js" ]]; then mv "packages/${PACKAGE}/docs/docs.json" "out/${PACKAGE}/${SEMVER}.json" mv "packages/${PACKAGE}/docs/docs.api.json" "out/${PACKAGE}/${SEMVER}.api.json" else mv "packages/${PACKAGE}/docs/docs.api.json" "out/${PACKAGE}/${SEMVER}.api.json" fi - name: Commit and push run: | cd out git config user.name github-actions[bot] git config user.email 41898282+github-actions[bot]@users.noreply.github.com git add . git commit -m "Docs build for ${GITHUB_REF_TYPE} ${GITHUB_REF_NAME}: ${GITHUB_SHA}" || true git push build-indices: needs: build-docs name: Build & upload search indices runs-on: ubuntu-latest env: TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }} TURBO_TEAM: ${{ secrets.TURBO_TEAM }} if: github.repository_owner == 'discordjs' steps: - name: Checkout repository uses: actions/checkout@v4 - name: Install Node.js v20 uses: actions/setup-node@v4 with: node-version: 20 - name: Install dependencies uses: ./packages/actions/src/pnpmCache - name: Build dependencies run: pnpm run build - name: Upload search indices to meilisearch env: DATABASE_URL: ${{ secrets.DATABASE_URL }} SEARCH_API_URL: ${{ secrets.SEARCH_API_URL }} SEARCH_API_KEY: ${{ secrets.SEARCH_API_KEY }} uses: ./packages/actions/src/uploadSearchIndices