Merge remote-tracking branch 'origin/master' into feature/actor-quality-score

Author: VojtaKai

.github/styles/config/vocabularies/Docs/accept.txt

@@ -119,7 +119,7 @@ subreddits?
 [Ss]ubwoofer
 Tripadvisor
 upvote
-walkthroughs?
+[Ww]alkthroughs?
 
 ul
 [Aa]gno

.github/workflows/docs.yaml

@@ -19,7 +19,7 @@ jobs:
         steps:
             -   uses: actions/checkout@v5
             -   name: Use Node.js 22
-                uses: actions/setup-node@v5
+                uses: actions/setup-node@v6
                 with:
                     node-version: 22
                     cache: 'npm'

.github/workflows/lychee.yml

@@ -12,7 +12,7 @@ jobs:
             -   uses: actions/checkout@v5
 
             -   name: Use Node.js 22
-                uses: actions/setup-node@v5
+                uses: actions/setup-node@v6
                 with:
                     node-version: 22
                     cache: 'npm'

.github/workflows/nginx.conf-test.yaml

@@ -15,7 +15,7 @@ jobs:
             -   uses: actions/checkout@v5
 
             -   name: Use Node.js 22
-                uses: actions/setup-node@v5
+                uses: actions/setup-node@v6
                 with:
                     node-version: 22
                     cache: 'npm'

.github/workflows/openapi.yaml

@@ -18,7 +18,7 @@ jobs:
                     fetch-depth: 0
 
             -   name: Use Node.js 22
-                uses: actions/setup-node@v5
+                uses: actions/setup-node@v6
                 with:
                     node-version: 22
                     cache: 'npm'
@@ -46,7 +46,7 @@ jobs:
                     token: ${{ secrets.APIFY_SERVICE_ACCOUNT_GITHUB_TOKEN }}
 
             -   name: Use Node.js 22
-                uses: actions/setup-node@v5
+                uses: actions/setup-node@v6
                 with:
                     node-version: 22
                     cache: 'npm'
@@ -98,7 +98,7 @@ jobs:
                     npm show $PACKAGE_NAME@$PACKAGE_VER # fails if the package is not available, succeeds if it is
 
             -   name: Commit the new theme version
-                uses: stefanzweifel/git-auto-commit-action@v6
+                uses: stefanzweifel/git-auto-commit-action@v7
                 with:
                     commit_message: 'chore: publish new version of @apify/docs-theme [skip ci]'
                     file_pattern: 'apify-docs-theme/package*.json'

.github/workflows/publish-theme.yaml

@@ -14,7 +14,7 @@ jobs:
                 uses: actions/checkout@v5
 
             -   name: Use Node.js 22
-                uses: actions/setup-node@v5
+                uses: actions/setup-node@v6
                 with:
                     node-version: 22
                     cache: 'npm'
@@ -35,6 +35,110 @@ jobs:
                     INTERCOM_APP_ID: ${{ secrets.INTERCOM_APP_ID }}
                     SEGMENT_TOKEN: ${{ secrets.SEGMENT_TOKEN }}
 
+            -   name: Install Nginx
+                run: |
+                    sudo apt-get update
+                    sudo apt-get install -y nginx
+
+            -   name: Start Docusaurus server
+                run: |
+                    nohup npx docusaurus serve --port 3000 --no-open &
+                    sleep 5
+                    curl -f http://localhost:3000 > /dev/null
+
+            -   name: Start Nginx with project config
+                run: |
+                    cat > default.conf <<EOF
+                    worker_processes auto;
+                    error_log $(pwd)/logs/error.log;
+                    pid $(pwd)/logs/nginx.pid;
+                    events {}
+                    http {
+                        access_log $(pwd)/logs/access.log;
+                        include $(pwd)/nginx.conf;
+                    }
+                    EOF
+                    sed -i 's|https://apify.github.io/apify-docs|http://localhost:3000|g' default.conf
+                    mkdir -p $(pwd)/logs
+                    nginx -c $(pwd)/default.conf
+                    sleep 1
+
+            -   name: Run header assertions
+                run: |
+                    set -euo pipefail
+                    function assert_header() {
+                        url=$1
+                        header=$2
+                        expected=$3
+                        shift 3
+                        extra_args=("$@")
+                        actual=$(curl -s -D - -o /dev/null "${extra_args[@]}" "$url" | grep -i "^$header" | tr -d '\r' || true)
+                        echo "→ $url → $actual"
+                        echo "$actual" | grep -q "$expected" || (echo "❌ Expected '$expected' in '$header' for $url" && exit 1)
+                    }
+
+                    echo "🧪 Checking Nginx responses... (apify-docs)"
+                    assert_header "http://localhost:8080/" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/platform/proxy/usage" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/platform/proxy/usage.md" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/platform/proxy/usage" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/img/docs-og.png" "Content-Type" "image/png"
+                    assert_header "http://localhost:8080/img/javascript-40x40.svg" "Content-Type" "image/svg"
+                    assert_header "http://localhost:8080/llms.txt" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/llms-full.txt" "Content-Type" "text/markdown"
+
+                    echo "🧪 Checking Nginx responses... (apify-sdk-js)"
+                    assert_header "http://localhost:8080/sdk/js" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/sdk/js" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/sdk/js/docs/guides/apify-platform" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/sdk/js/docs/guides/apify-platform.md" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/sdk/js/docs/guides/apify-platform" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/sdk/js/llms.txt" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/sdk/js/llms-full.txt" "Content-Type" "text/markdown"
+
+                    echo "🧪 Checking Nginx responses... (apify-sdk-python)"
+                    assert_header "http://localhost:8080/sdk/python" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/sdk/python" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/sdk/python/docs/changelog" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/sdk/python/docs/changelog.md" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/sdk/python/docs/changelog" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/sdk/python/llms.txt" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/sdk/python/llms-full.txt" "Content-Type" "text/markdown"
+
+                    echo "🧪 Checking Nginx responses... (apify-client-js)"
+                    assert_header "http://localhost:8080/api/client/js" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/api/client/js" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/api/client/js/docs/changelog" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/api/client/js/docs/changelog.md" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/api/client/js/docs/changelog" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/api/client/js/llms.txt" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/api/client/js/llms-full.txt" "Content-Type" "text/markdown"
+
+                    echo "🧪 Checking Nginx responses... (apify-client-python)"
+                    assert_header "http://localhost:8080/api/client/python" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/api/client/python" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/api/client/python/docs/changelog" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/api/client/python/docs/changelog.md" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/api/client/python/docs/changelog" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/api/client/python/llms.txt" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/api/client/python/llms-full.txt" "Content-Type" "text/markdown"
+
+                    echo "🧪 Checking Nginx responses... (apify-cli)"
+                    assert_header "http://localhost:8080/cli" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/cli" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/cli/docs/changelog" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/cli/docs/changelog.md" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/cli/docs/changelog" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/cli/llms.txt" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/cli/llms-full.txt" "Content-Type" "text/markdown"
+
+                    echo "✅ All Nginx header checks passed."
+
+            -   name: Stop Nginx
+                if: always()
+                run: nginx -c $(pwd)/default.conf -s stop
+
     lint_content:
         name: Lint markdown content
         runs-on: ubuntu-latest
@@ -51,7 +155,7 @@ jobs:
                     separator: ","
 
             -   name: Use Node.js 22
-                uses: actions/setup-node@v5
+                uses: actions/setup-node@v6
                 with:
                     node-version: 22
                     cache: 'npm'
@@ -84,7 +188,7 @@ jobs:
                 uses: actions/checkout@v5
 
             -   name: Use Node.js 22
-                uses: actions/setup-node@v5
+                uses: actions/setup-node@v6
                 with:
                     node-version: 22
                     cache: 'npm'

.github/workflows/test.yaml

@@ -70,7 +70,7 @@ This will be enough to work on Platform, Academy and OpenAPI. If you want to wor
 5. Add a record to `/etc/hosts`, which maps the `docs.apify.loc` to a localhost:
 
     ```text
-    127.0.01 docs.apify.loc
+    127.0.0.1 docs.apify.loc
     ```
 
 You should be able to open https://docs.apify.loc in your browser and run all the repositories jointly as one project.

CONTRIBUTING.md

@@ -1,12 +1,12 @@
 title: ChargeRunRequest
 required:
   - eventName
-  - eventCount
+  - count
 type: object
 properties:
   eventName:
     type: string
     example: ANALYZE_PAGE
-  eventCount:
+  count:
     type: number
     example: 1

apify-api/openapi/components/schemas/actor-runs/ChargeRunRequest.yaml

@@ -13,3 +13,7 @@ properties:
     type: number
     nullable: true
     example: 128
+  restartOnError:
+    type: boolean
+    nullable: true
+    example: false