fixup!

Author: avivkeller

.vercelignore

@@ -0,0 +1,2 @@
+# Ignored the cloned `node` folder
+/node

package.json

@@ -21,13 +21,14 @@
     "prepare": "husky || exit 0",
     "run": "node packages/cli/bin/cli.mjs",
     "watch": "node --watch packages/cli/bin/cli.mjs",
+    "docs:build": "node --run build:site",
     "build:site": "bash scripts/deployments/site/main.sh",
     "build:beta": "bash scripts/deployments/beta/main.sh",
     "build": "node --run build:site",
-    "deploy:site": "wrangler deploy --config scripts/deployments/site/wrangler.jsonc",
-    "deploy:beta": "wrangler deploy --config scripts/deployments/beta/wrangler.jsonc",
-    "preview:site": "wrangler versions upload --config scripts/deployments/site/wrangler.jsonc",
-    "preview:beta": "wrangler versions upload --config scripts/deployments/beta/wrangler.jsonc",
+    "deploy:site": "WRANGLER_LOG=debug wrangler deploy --config scripts/deployments/site/wrangler.jsonc",
+    "deploy:beta": "WRANGLER_LOG=debug wrangler deploy --config scripts/deployments/beta/wrangler.jsonc",
+    "preview:site": "WRANGLER_LOG=debug wrangler versions upload --config scripts/deployments/site/wrangler.jsonc",
+    "preview:beta": "WRANGLER_LOG=debug wrangler versions upload --config scripts/deployments/beta/wrangler.jsonc",
     "changeset": "changeset",
     "changeset:version": "changeset version",
     "release": "changeset publish"

scripts/vercel-build.sh

@@ -0,0 +1,25 @@
+set -e
+
+# Use the tag captured during the prepare step as the docs version, so the
+# output reflects the nodejs/node release it was generated from (e.g. v26.0.0)
+# rather than the Node.js runtime version running this build (process.version).
+NODE_VERSION=$(cat .node-tag)
+
+node packages/cli/bin/cli.mjs generate \
+  -t orama-db \
+  -t json \
+  -t llms-txt \
+  -t section-pages \
+  -i "./node/doc/api/*.md" \
+  --ignore "./node/doc/api/quic.md" \
+  -o "./out" \
+  -c "./node/CHANGELOG.md" \
+  -v "$NODE_VERSION" \
+  --type-map "./node/doc/type-map.json" \
+  --config-file "./beta/doc-kit.config.mjs" \
+  --log-level debug
+
+cp ./node/doc/api/*.md "./out"
+
+rm -rf node/
+rm -f .node-tag

scripts/vercel-prepare.sh

@@ -0,0 +1,55 @@
+set -e
+
+# Determine the latest stable release tag on nodejs/node (skip pre-releases
+# like `-rc`/`-nightly`, taking the highest version-sorted tag).
+LATEST_TAG=$(git ls-remote --tags --refs --sort='-v:refname' \
+  https://github.com/nodejs/node.git 'v*' \
+  | awk -F/ '$NF !~ /-/ { print $NF; exit }')
+
+if [ -z "$LATEST_TAG" ]; then
+  echo "Could not determine the latest nodejs/node release tag" >&2
+  exit 1
+fi
+
+# Persist the tag so the build step can use it as the docs version
+echo "$LATEST_TAG" > .node-tag
+
+echo "Building docs for nodejs/node $LATEST_TAG"
+
+# Clone the repository at that tag with no checkout and shallow history
+git clone --depth 1 --branch "$LATEST_TAG" --filter=blob:none --sparse \
+  https://github.com/nodejs/node.git
+
+# Move into the cloned directory
+cd node
+
+# Enable sparse checkout and specify the folder
+git sparse-checkout set lib doc .
+
+# TODO(@avivkeller): Remove this rewrite once nodejs/node embeds
+# `<DocumentationIndex />` directly.
+INTRODUCED_IN=$(sed -n 's/^<!--introduced_in=\(.*\)-->$/\1/p' ./doc/api/documentation.md)
+
+{
+  printf -- '---\nmdx: true\ntype: misc\n'
+  if [ -n "$INTRODUCED_IN" ]; then
+    printf -- 'introduced_in: %s\n' "$INTRODUCED_IN"
+  fi
+  printf -- '---\n'
+  sed \
+    -e 's|<!-- STABILITY_OVERVIEW_SLOT_BEGIN -->|<DocumentationIndex />|' \
+    -e '/^<!--.*-->$/d' \
+    -e '/^<!-- YAML$/,/^-->$/d' \
+    ./doc/api/documentation.md
+} > ./doc/api/index.md
+
+rm ./doc/api/documentation.md
+
+# Move back out
+cd ..
+
+# Install dependencies
+pnpm install --frozen-lockfile
+
+# Create the ./out directory
+mkdir -p out

vercel.json

@@ -0,0 +1,14 @@
+{
+  "cleanUrls": true,
+  "headers": [
+    {
+      "source": "/assets/(.*)",
+      "headers": [
+        {
+          "key": "Cache-Control",
+          "value": "public, max-age=31536000, immutable"
+        }
+      ]
+    }
+  ]
+}