Run production from built JavaScript

Add a tsdown build for the server entrypoint and switch production
and worker scripts to run the compiled JavaScript with Node.js.  The
build keeps the module graph unbundled, emits ESM .js files, and copies
runtime assets needed by the compiled server.

Build the Docker image in two stages so the runtime image includes the
compiled dist tree while still installing only production dependencies.
Update manual installation docs and the changelog to describe the new
build step.

Fix #357

Assisted-by: Codex:gpt-5.5

Author: dahlia

.dockerignore

@@ -1,4 +1,5 @@
 .env
 .git/
 .github/
+dist/
 node_modules/

.gitignore

@@ -1,5 +1,6 @@
 .env
 assets/
+dist/
 fedify-hollo-*.tgz
 *.jsonl
 node_modules/

CHANGES.md

@@ -38,6 +38,12 @@ To be released.
      -  Preview card scraping, media processing, and authentication helpers now
         load on demand instead of eagerly during route registration.
 
+ -  Added a production build step powered by `tsdown`, and changed
+    `pnpm prod` and `pnpm worker` to run the compiled JavaScript output with
+    Node.js instead of running TypeScript through `tsx`.  Docker images now
+    build these JavaScript files in a builder stage and include them in the
+    runtime image.  [[#357]]
+
  -  Moved remote replies scraping from synchronous post ingestion to a
     rate-limited background worker.  Remote posts now enqueue reply collection
     scraping jobs instead of fetching nested replies inline, which prevents
@@ -145,6 +151,7 @@ To be released.
 
 [#348]: https://github.com/fedify-dev/hollo/issues/348
 [#350]: https://github.com/fedify-dev/hollo/issues/350
+[#357]: https://github.com/fedify-dev/hollo/issues/357
 [#409]: https://github.com/fedify-dev/hollo/issues/409
 [#420]: https://github.com/fedify-dev/hollo/issues/420
 [#424]: https://github.com/fedify-dev/hollo/issues/424

Dockerfile

@@ -1,3 +1,21 @@
+FROM docker.io/node:24-alpine AS builder
+
+ARG VERSION
+
+RUN apk add --no-cache ffmpeg jq libstdc++ pnpm
+
+COPY pnpm-lock.yaml package.json /app/
+WORKDIR /app/
+RUN pnpm install --frozen-lockfile
+
+COPY . /app/
+RUN \
+  if [ "$VERSION" != "" ]; then \
+    jq --arg version "$VERSION" '.version = $version' package.json > .pkg.json \
+    && mv .pkg.json package.json; \
+  fi \
+  && pnpm run build
+
 FROM docker.io/node:24-alpine
 
 LABEL org.opencontainers.image.title="Hollo"
@@ -14,6 +32,7 @@ WORKDIR /app/
 RUN pnpm install --frozen-lockfile --prod
 
 COPY . /app/
+COPY --from=builder /app/dist /app/dist
 
 ARG VERSION
 LABEL org.opencontainers.image.version="${VERSION}"

docs/src/content/docs/install/manual.mdx

@@ -91,9 +91,10 @@ Hollo.
 Starting the server
 -------------------
 
-To start the server, run the following command:
+Build the JavaScript files and start the server:
 
 ~~~~ sh frame="none"
+pnpm run build
 pnpm run prod
 ~~~~
 
@@ -117,7 +118,13 @@ dependencies:
     pnpm install
     ~~~~
 
- 3. Restart the server:
+ 3. Rebuild the JavaScript files:
+
+    ~~~~ sh frame="none"
+    pnpm run build
+    ~~~~
+
+ 4. Restart the server:
 
     ~~~~ sh frame="none"
     pnpm run prod

docs/src/content/docs/ja/install/manual.mdx

@@ -88,9 +88,10 @@ Holloをインストールしたら、設定を行う必要があります。
 サーバー起動
 ------------
 
-サーバーを起動する準備が整ったら、以下のコマンドを実行します：
+JavaScriptファイルをビルドしてから、サーバーを起動します：
 
 ~~~~ sh frame="none"
+pnpm run build
 pnpm run prod
 ~~~~
 
@@ -114,7 +115,13 @@ GitHubリポジトリから最新のコードを取得し、依存関係を再
     pnpm install
     ~~~~
 
- 3. サーバーを再起動します：
+ 3. JavaScriptファイルを再ビルドします：
+
+    ~~~~ sh frame="none"
+    pnpm run build
+    ~~~~
+
+ 4. サーバーを再起動します：
 
     ~~~~ sh frame="none"
     pnpm run prod

docs/src/content/docs/ko/install/manual.mdx

@@ -89,9 +89,10 @@ Hollo가 설치되었다면, 설정을 해야 합니다.
 서버 시작하기
 -------------
 
-서버를 시작하려면 다음 명령을 실행하세요:
+JavaScript 파일을 빌드한 뒤 서버를 시작합니다:
 
 ~~~~ sh frame="none"
+pnpm run build
 pnpm run prod
 ~~~~
 
@@ -115,7 +116,13 @@ GitHub 저장소에서 최신 코드를 받고 의존성을 다시 설치하면
     pnpm install
     ~~~~
 
- 3. 서버를 다시 시작합니다:
+ 3. JavaScript 파일을 다시 빌드합니다:
+
+    ~~~~ sh frame="none"
+    pnpm run build
+    ~~~~
+
+ 4. 서버를 다시 시작합니다:
 
     ~~~~ sh frame="none"
     pnpm run prod

docs/src/content/docs/zh-cn/install/manual.mdx

@@ -83,9 +83,10 @@ import { Steps } from "@astrojs/starlight/components";
 启动服务端
 ----------
 
-要启动服务端，请运行以下命令：
+先构建 JavaScript 文件，然后启动服务端：
 
 ~~~~ sh frame="none"
+pnpm run build
 pnpm run prod
 ~~~~
 
@@ -108,7 +109,13 @@ pnpm run prod
     pnpm install
     ~~~~
 
- 3. 重启服务端：
+ 3. 重新构建 JavaScript 文件：
+
+    ~~~~ sh frame="none"
+    pnpm run build
+    ~~~~
+
+ 4. 重启服务端：
 
     ~~~~ sh frame="none"
     pnpm run prod

package.json

@@ -5,11 +5,12 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "prod": "pnpm run migrate && tsx --env-file-if-exists=.env --dns-result-order=ipv6first bin/server.ts",
+    "prod": "pnpm run migrate && node --env-file-if-exists=.env --dns-result-order=ipv6first dist/bin/server.js",
     "dev": "pnpm run migrate && tsx watch --env-file-if-exists=.env --dns-result-order=ipv6first bin/server.ts",
-    "worker": "NODE_TYPE=worker tsx --env-file-if-exists=.env --dns-result-order=ipv6first bin/server.ts",
+    "worker": "NODE_TYPE=worker node --env-file-if-exists=.env --dns-result-order=ipv6first dist/bin/server.js",
     "list:routes": "tsx --env-file-if-exists=.env bin/routes.ts",
     "measure:memory": "node --expose-gc --import tsx --env-file-if-exists=.env scripts/measure-memory.ts",
+    "build": "tsdown",
     "test": "pnpm run migrate:test && vitest",
     "test:ci": "vitest",
     "typecheck": "tsgo --noEmit",
@@ -94,6 +95,7 @@
     "oxfmt": "^0.46.0",
     "oxlint": "^1.61.0",
     "timekeeper": "^2.3.1",
+    "tsdown": "^0.21.10",
     "typescript": "^6.0.3",
     "vitest": "^3.1.4"
   },