@selvajs/selva 4.11.0 → 4.12.0

package/build/server/chunks/entries/endpoints/api/admin/system/throughput/_server.ts.js-DhWAJpZE.js

@@ -0,0 +1,88 @@
+import { r as requirePermission } from '../../../../../../chunks/access.server.js-BkVI6Vou.js';
+import { a as apiError, A as ApiErrorCode } from '../../../../../../chunks/api-errors.js-C9xGTbW6.js';
+import { json } from '@sveltejs/kit';
+import { randomFillSync } from 'node:crypto';
+import '../../../../../../chunks/src.js-B12bUNyu.js';
+import 'zod';
+import '../../../../../../chunks/providers.server.js-BSOw3gYp.js';
+import '../../../../../../chunks/shared-server.js-D2MyEK0i.js';
+import '../../../../../../chunks/schema.js-BeFDxIuz.js';
+import '../../../../../../chunks/core-BQtRL5GE.js-iCpLjXCp.js';
+import 'node:url';
+import 'node:path';
+import 'node:fs';
+import 'node:fs/promises';
+import '@supabase/supabase-js';
+
+//#region src/routes/api/admin/system/throughput/+server.ts
+/**
+* Network throughput probe for the /admin/system page. Measures the transport
+* path between the operator's browser and this server — through whatever
+* proxies/tunnels sit in between (reverse proxy, SSO relays such as Azure App
+* Proxy) — with zero compute involvement:
+*
+*   GET  ?mb=N  → streams N MB of random bytes (download direction)
+*   POST        → consumes and discards the request body, returns the
+*                 server-side receive duration (upload direction)
+*
+* Random bytes are deliberately incompressible so proxy compression can't fake
+* a fast transfer. `instance_admin` only — a bandwidth probe is an operator
+* tool, and the download side is a data faucet.
+*
+* A curl-friendly, env-flag-gated sibling exists at /api/diag/throughput for
+* shell-based testing (documented in docs/deployment/app-proxy-migration.md);
+* this endpoint is the browser/UI counterpart that also works behind SSO
+* proxies where curl can't authenticate.
+*/
+var CHUNK_BYTES = 1048576;
+var DOWNLOAD_DEFAULT_MB = 20;
+var DOWNLOAD_MAX_MB = 256;
+var UPLOAD_MAX_BYTES = 268435456;
+var GET = async ({ locals, url }) => {
+	requirePermission(locals, "instance_admin");
+	const requested = Number(url.searchParams.get("mb"));
+	const mb = Math.min(DOWNLOAD_MAX_MB, Math.max(1, Number.isFinite(requested) ? requested : DOWNLOAD_DEFAULT_MB));
+	let sentChunks = 0;
+	const stream = new ReadableStream({ pull(controller) {
+		if (sentChunks >= mb) {
+			controller.close();
+			return;
+		}
+		const chunk = new Uint8Array(CHUNK_BYTES);
+		randomFillSync(chunk);
+		controller.enqueue(chunk);
+		sentChunks++;
+	} });
+	return new Response(stream, { headers: {
+		"Content-Type": "application/octet-stream",
+		"Content-Length": String(mb * CHUNK_BYTES),
+		"Cache-Control": "no-store"
+	} });
+};
+var POST = async ({ locals, request }) => {
+	requirePermission(locals, "instance_admin");
+	const declared = Number(request.headers.get("content-length"));
+	if (Number.isFinite(declared) && declared > UPLOAD_MAX_BYTES) apiError(413, ApiErrorCode.VALIDATION_FAILED, "Upload exceeds the 256 MB probe limit");
+	if (!request.body) apiError(400, ApiErrorCode.VALIDATION_FAILED, "Missing request body");
+	const start = performance.now();
+	const reader = request.body.getReader();
+	let bytes = 0;
+	while (true) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		bytes += value.byteLength;
+		if (bytes > UPLOAD_MAX_BYTES) {
+			await reader.cancel();
+			apiError(413, ApiErrorCode.VALIDATION_FAILED, "Upload exceeds the 256 MB probe limit");
+		}
+	}
+	const ms = performance.now() - start;
+	return json({
+		bytes,
+		ms: Math.round(ms),
+		mbps: ms > 0 ? Number((bytes / 1048576 / (ms / 1e3)).toFixed(2)) : null
+	});
+};
+
+export { GET, POST };
+//# sourceMappingURL=_server.ts.js-DhWAJpZE.js.map

package/build/server/chunks/entries/endpoints/api/admin/system/throughput/_server.ts.js-DhWAJpZE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_server.ts.js-DhWAJpZE.js","sources":["../../../../../../../../../.svelte-kit/output/server/entries/endpoints/api/admin/system/throughput/_server.ts.js"],"sourcesContent":["import { w as requirePermission } from \"../../../../../../chunks/access.server.js\";\nimport { n as apiError, t as ApiErrorCode } from \"../../../../../../chunks/api-errors.js\";\nimport { json } from \"@sveltejs/kit\";\nimport { randomFillSync } from \"node:crypto\";\n//#region src/routes/api/admin/system/throughput/+server.ts\n/**\n* Network throughput probe for the /admin/system page. Measures the transport\n* path between the operator's browser and this server — through whatever\n* proxies/tunnels sit in between (reverse proxy, SSO relays such as Azure App\n* Proxy) — with zero compute involvement:\n*\n*   GET  ?mb=N  → streams N MB of random bytes (download direction)\n*   POST        → consumes and discards the request body, returns the\n*                 server-side receive duration (upload direction)\n*\n* Random bytes are deliberately incompressible so proxy compression can't fake\n* a fast transfer. `instance_admin` only — a bandwidth probe is an operator\n* tool, and the download side is a data faucet.\n*\n* A curl-friendly, env-flag-gated sibling exists at /api/diag/throughput for\n* shell-based testing (documented in docs/deployment/app-proxy-migration.md);\n* this endpoint is the browser/UI counterpart that also works behind SSO\n* proxies where curl can't authenticate.\n*/\nvar CHUNK_BYTES = 1048576;\nvar DOWNLOAD_DEFAULT_MB = 20;\nvar DOWNLOAD_MAX_MB = 256;\nvar UPLOAD_MAX_BYTES = 268435456;\nvar GET = async ({ locals, url }) => {\n\trequirePermission(locals, \"instance_admin\");\n\tconst requested = Number(url.searchParams.get(\"mb\"));\n\tconst mb = Math.min(DOWNLOAD_MAX_MB, Math.max(1, Number.isFinite(requested) ? requested : DOWNLOAD_DEFAULT_MB));\n\tlet sentChunks = 0;\n\tconst stream = new ReadableStream({ pull(controller) {\n\t\tif (sentChunks >= mb) {\n\t\t\tcontroller.close();\n\t\t\treturn;\n\t\t}\n\t\tconst chunk = new Uint8Array(CHUNK_BYTES);\n\t\trandomFillSync(chunk);\n\t\tcontroller.enqueue(chunk);\n\t\tsentChunks++;\n\t} });\n\treturn new Response(stream, { headers: {\n\t\t\"Content-Type\": \"application/octet-stream\",\n\t\t\"Content-Length\": String(mb * CHUNK_BYTES),\n\t\t\"Cache-Control\": \"no-store\"\n\t} });\n};\nvar POST = async ({ locals, request }) => {\n\trequirePermission(locals, \"instance_admin\");\n\tconst declared = Number(request.headers.get(\"content-length\"));\n\tif (Number.isFinite(declared) && declared > UPLOAD_MAX_BYTES) apiError(413, ApiErrorCode.VALIDATION_FAILED, \"Upload exceeds the 256 MB probe limit\");\n\tif (!request.body) apiError(400, ApiErrorCode.VALIDATION_FAILED, \"Missing request body\");\n\tconst start = performance.now();\n\tconst reader = request.body.getReader();\n\tlet bytes = 0;\n\twhile (true) {\n\t\tconst { done, value } = await reader.read();\n\t\tif (done) break;\n\t\tbytes += value.byteLength;\n\t\tif (bytes > UPLOAD_MAX_BYTES) {\n\t\t\tawait reader.cancel();\n\t\t\tapiError(413, ApiErrorCode.VALIDATION_FAILED, \"Upload exceeds the 256 MB probe limit\");\n\t\t}\n\t}\n\tconst ms = performance.now() - start;\n\treturn json({\n\t\tbytes,\n\t\tms: Math.round(ms),\n\t\tmbps: ms > 0 ? Number((bytes / 1048576 / (ms / 1e3)).toFixed(2)) : null\n\t});\n};\n//#endregion\nexport { GET, POST };\n"],"names":[],"mappings":"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"}

package/build/server/chunks/entries/endpoints/api/admin/system/update/_server.ts.js-DNoYUUBX.js

@@ -0,0 +1,562 @@
+import { b as private_env } from '../../../../../../chunks/shared-server.js-D2MyEK0i.js';
+import '../../../../../../chunks/src.js-B12bUNyu.js';
+import { t as actorFrom, r as renderThrown, j as getEventSink, i as getErrorReporter } from '../../../../../../chunks/providers.server.js-BSOw3gYp.js';
+import { r as requirePermission } from '../../../../../../chunks/access.server.js-BkVI6Vou.js';
+import { c as checkForUpdate, r as readChannel, a as channelTag } from '../../../../../../chunks/updateCheck.server.js-xwjOOtFl.js';
+import { u as updateLogPath, f as findDeploymentDir, a as updateStatePath, s as startUpdateOutcomeReconciler } from '../../../../../../chunks/selfUpdate.server.js-BfarIc28.js';
+import { json } from '@sveltejs/kit';
+import { join as join$1 } from 'node:path';
+import { readFileSync as readFileSync$1 } from 'node:fs';
+import { spawn } from 'child_process';
+import { join } from 'path';
+import { readFileSync, writeFileSync } from 'fs';
+import 'zod';
+import '../../../../../../chunks/schema.js-BeFDxIuz.js';
+import '../../../../../../chunks/core-BQtRL5GE.js-iCpLjXCp.js';
+import 'node:crypto';
+import 'node:url';
+import 'node:fs/promises';
+import '@supabase/supabase-js';
+import '../../../../../../chunks/api-errors.js-C9xGTbW6.js';
+import '../../../../../../chunks/update-outcome.js-Djn7e2VC.js';
+
+//#region src/lib/server/updateRunner.server.ts
+/**
+* Generates the bash the self-update POST route spawns: a tiny daemonizing
+* launcher plus the runner script that actually stops/updates/starts/health-
+* checks the deployment. Split out of the route file because SvelteKit's
+* route-file validator only allows HTTP-verb exports (and `_`-prefixed ones) —
+* these are plain functions the runner-script contract tests import directly.
+*/
+function readRuntimeVersion(dir) {
+	try {
+		const pkg = JSON.parse(readFileSync$1(join$1(dir, "node_modules", "@selvajs", "selva", "package.json"), "utf8"));
+		return typeof pkg.version === "string" ? pkg.version : void 0;
+	} catch {
+		return;
+	}
+}
+function shellQuote(s) {
+	return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+function buildLauncher(runnerScript, logPath, prelude = []) {
+	const echoes = prelude.map((line) => `echo ${shellQuote(line)}`).join("\n");
+	return `
+LOGFILE=${shellQuote(logPath)}
+RUNNER=/tmp/selva-update-runner.sh
+mkdir -p "$(dirname "$LOGFILE")"
+: > "$LOGFILE"
+
+cat > "$RUNNER" <<'__SELVA_RUNNER_EOF__'
+${runnerScript}
+__SELVA_RUNNER_EOF__
+chmod +x "$RUNNER"
+
+trap '' PIPE
+exec > >(tee --output-error=warn-nopipe -a "$LOGFILE" 2>/dev/null) 2>&1
+${echoes}
+
+# Daemonize the runner so PM2's tree-kill of selva-compute can't reach it.
+# setsid puts it in a new session; the trailing & + disown + launcher exit
+# leaves the runner with PPID=1 once we're gone. stdin/stdout/stderr are
+# fully detached from this process (and from selva-compute's pipes).
+setsid bash "$RUNNER" </dev/null >>"$LOGFILE" 2>&1 &
+RUNNER_PID=$!
+disown
+echo "[INFO] Update runner started (PID $RUNNER_PID, log: $LOGFILE)"
+
+# Small pause so the runner has time to print its first line before SSE
+# closes — otherwise the frontend's first poll might see no progress.
+sleep 1
+exit 0
+`;
+}
+function buildNpmRunnerScript(npmArgs, versionBefore, ecosystemPath, tag) {
+	const npmCommand = ["npm", ...npmArgs].map(shellQuote).join(" ");
+	return `#!/bin/bash
+set -o pipefail
+BEFORE=${shellQuote(versionBefore ?? "")}
+ECOSYSTEM=${shellQuote(ecosystemPath)}
+TAG=${shellQuote(tag)}
+
+# Resolve the deployment-local pm2 explicitly instead of trusting PATH.
+# The runner is re-launched via \`setsid bash\` from a tempfile, so it inherits
+# whatever environment the spawning process had. When the update is triggered
+# from the admin UI that happens to include node_modules/.bin; from cron or a
+# bare shell it does not, and every pm2 call below — including the EXIT trap's
+# last-resort restart — fails with "command not found" and the app stays dark.
+PM2="$(dirname "$ECOSYSTEM")/node_modules/.bin/pm2"
+[ -x "$PM2" ] || PM2=pm2
+
+# Waits for selva-compute to leave the transitional 'stopping' state.
+#
+# \`pm2 stop\` sends SIGINT and returns without waiting for the process to die.
+# The SvelteKit node adapter then drains in-flight requests before exiting, and
+# PM2 only escalates to SIGKILL after kill_timeout (10s in the scaffolded
+# ecosystem). For that whole window the process table entry has a name and an
+# id but no live pid — \`pm2 start\` resolves the name, converts to a restart,
+# finds nothing to restart, and pm2's own table printer crashes on
+# \`undefined.pm2_env\`. Polling here keeps the rest of the script out of that
+# window entirely.
+#
+# The drain reliably takes the full timeout when the update was triggered from
+# the admin UI: that page is fed by an SSE stream this very process serves, and
+# an open SSE stream never completes on its own.
+# Prints exactly one word. Callers compare it against 'online' / 'stopping', so
+# a probe that emits two tokens on failure (the inline catch AND a shell
+# fallback both firing) would silently never match either. Node's catch is the
+# single failure path; fd 0 rather than /dev/stdin because the latter isn't a
+# readable pipe everywhere.
+app_status() {
+  "$PM2" jlist 2>/dev/null | node -e "
+    try {
+      const list = JSON.parse(require('fs').readFileSync(0,'utf8'));
+      const app = list.find(p => p.name === 'selva-compute');
+      process.stdout.write(app ? app.pm2_env.status : 'missing');
+    } catch { process.stdout.write('error'); }
+  " 2>/dev/null
+}
+
+wait_until_stopped() {
+  for i in $(seq 1 20); do
+    STATUS=$(app_status)
+    if [ "$STATUS" != "stopping" ]; then
+      return 0
+    fi
+    echo "[INFO] selva-compute still draining (attempt $i/20) — waiting for SIGKILL escalation"
+    sleep 1
+  done
+  echo "[WARN] selva-compute stuck in 'stopping' after 20s — continuing anyway"
+  return 1
+}
+
+# \`pm2 start <ecosystem>\` converts to a restart-by-id when an entry of the same
+# name is already in the table. If that entry is stale the restart fails and no
+# amount of retrying the same command helps — the name has to be dropped first
+# so the start registers a fresh process. Deleting a stopped entry is safe: the
+# ecosystem file is the source of truth for how to bring it back.
+start_app() {
+  if "$PM2" start "$ECOSYSTEM" --update-env; then
+    return 0
+  fi
+  echo "[WARN] pm2 start failed — dropping the stale process entry and retrying"
+  "$PM2" delete selva-compute >/dev/null 2>&1 || true
+  "$PM2" start "$ECOSYSTEM" --update-env
+}
+
+# Last-resort safety net. If the script exits with the app NOT online for
+# any reason (crash, kill -9, network blip, npm hang past timeout), try to
+# bring it back from ecosystem.config.cjs before exiting. Leaving the app
+# down is the worst possible outcome of an update.
+on_exit() {
+  CODE=$?
+  STATUS=$(app_status)
+  # A 'stopping' entry is mid-drain, not down. Restarting it now hits the same
+  # dead-id window that brought us here; wait for the entry to settle first.
+  if [ "$STATUS" = "stopping" ]; then
+    wait_until_stopped
+    STATUS=$(app_status)
+  fi
+  if [ "$STATUS" != "online" ]; then
+    echo "[RECOVER] selva-compute is '$STATUS' — starting from ecosystem.config.cjs"
+    start_app >/dev/null 2>&1 || \\
+      echo "[RECOVER] pm2 start failed — manual intervention required: cd $(dirname "$ECOSYSTEM") && ./node_modules/.bin/pm2 delete selva-compute; ./node_modules/.bin/pm2 start ecosystem.config.cjs"
+  fi
+  # Terminal marker: the restarted app's outcome reconciler greps this to turn
+  # the run into an audit event (selfUpdate.server.ts). Keep the format stable.
+  echo "[EXIT] code=$CODE"
+}
+trap on_exit EXIT
+
+# A killed runner must not look like a finished one.
+#
+# \`$?\` inside an EXIT trap reports the last completed command, NOT the signal.
+# When systemd SIGTERMs the whole cgroup, the EXIT trap still runs and records
+# \`code=0\` — so deriveOutcome takes the exit-0 success branch and tells the
+# operator "Updated X → Y. The app is back online." while npm never ran and
+# the deployment is unchanged. Catching the signal makes the recorded code
+# truthful; 143/130 are the conventional 128+signal values.
+on_signal() {
+  SIG=$1
+  echo "[FATAL] KILLED: runner received SIG$SIG before finishing."
+  echo "[FATAL] Nothing was installed by this run. If the app is down, recover with:"
+  echo "[FATAL]   cd $(dirname "$ECOSYSTEM") && pm2 start ecosystem.config.cjs --update-env"
+  echo "[FATAL] A systemd-supervised pm2 can do this when 'pm2 update' recycles the daemon."
+  exit $2
+}
+trap 'on_signal TERM 143' TERM
+trap 'on_signal INT 130' INT
+trap 'on_signal HUP 129' HUP
+
+# ---------------------------------------------------------------------------
+# 1. Pre-flight: skip the whole cycle if there's nothing to install.
+# ---------------------------------------------------------------------------
+# Without this, clicking "Update" on an already-current instance triggers a
+# full stop/install/start cycle and a downtime window for no reason.
+echo "[STEP] Checking npm registry for the '$TAG' channel version"
+LATEST=$(npm view "@selvajs/selva@$TAG" version --silent 2>/dev/null || echo "")
+if [ -z "$LATEST" ]; then
+  echo "[WARN] Could not query npm registry — proceeding with update attempt anyway"
+elif [ -n "$BEFORE" ] && [ "$LATEST" = "$BEFORE" ]; then
+  echo "[INFO] Already on the '$TAG' channel version ($BEFORE)"
+  echo "[DONE] Nothing to do"
+  exit 0
+else
+  # May be a forward update OR a revert (target older than installed) — either
+  # way the installed version differs from what this channel publishes.
+  echo "[INFO] Target ($TAG): $BEFORE → $LATEST"
+fi
+
+# ---------------------------------------------------------------------------
+# 1b. Node engine pre-flight — BEFORE any downtime.
+# ---------------------------------------------------------------------------
+# npm only treats an engine mismatch as fatal under engine-strict=true, which
+# no deployment sets. So a release requiring a newer Node installs
+# "successfully", pm2 starts, and /api/health returns 200 (it touches nothing
+# Node-version specific) — a false green that skips rollback entirely. Warn
+# here so a CLI-driven run sees it too; the admin UI blocks earlier.
+REQUIRED_NODE=$(npm view "@selvajs/selva@$TAG" engines.node --silent 2>/dev/null | tr -d '"' | tr -d "'")
+RUNNING_NODE=$(node -p 'process.versions.node' 2>/dev/null)
+if [ -n "$REQUIRED_NODE" ] && [ -n "$RUNNING_NODE" ]; then
+  # Compare majors only — the ranges we publish are all \`>=X\` forms.
+  REQ_MAJOR=$(echo "$REQUIRED_NODE" | grep -o '[0-9]\\+' | head -1)
+  RUN_MAJOR=$(echo "$RUNNING_NODE" | cut -d. -f1)
+  if [ -n "$REQ_MAJOR" ] && [ "$RUN_MAJOR" -lt "$REQ_MAJOR" ] 2>/dev/null; then
+    echo "[WARN] ENGINE_MISMATCH: @selvajs/selva@$LATEST requires Node $REQUIRED_NODE but this host runs v$RUNNING_NODE"
+    echo "[WARN] npm will install it anyway (engine-strict is off) and the health probe will pass,"
+    echo "[WARN] but routes using newer Node APIs will fail at request time. Upgrade Node on this host."
+  fi
+fi
+
+# ---------------------------------------------------------------------------
+# 2. Resync PM2 daemon if its in-memory version drifted from the CLI on disk.
+# ---------------------------------------------------------------------------
+# After a global pm2 upgrade the daemon keeps running its original version
+# while the CLI moves forward. Process commands then talk to a stale daemon
+# and the symptom is "stop works, start never lands". \`pm2 update\` dumps
+# processes, kills the daemon, respawns on the current CLI, restores the
+# dump. Doing it before we touch anything keeps the rest of the script
+# talking to a coherent daemon.
+echo "[STEP] Checking PM2 daemon/CLI version sync"
+PING_OUT=$("$PM2" ping 2>&1)
+if echo "$PING_OUT" | grep -q "out-of-date"; then
+  # pm2 prints both versions alongside the warning. Which is newer decides
+  # whether \`pm2 update\` can help — see the direction check below.
+  DAEMON_V=$(echo "$PING_OUT" | sed -e 's/\\x1b\\[[0-9;]*m//g' \\
+    | grep -i "In memory PM2 version" | grep -o '[0-9]\\+\\.[0-9]\\+\\.[0-9]\\+' | head -1)
+  LOCAL_V=$(echo "$PING_OUT" | sed -e 's/\\x1b\\[[0-9;]*m//g' \\
+    | grep -i "Local PM2 version" | grep -o '[0-9]\\+\\.[0-9]\\+\\.[0-9]\\+' | head -1)
+  DAEMON_MAJOR=\${DAEMON_V%%.*}
+  LOCAL_MAJOR=\${LOCAL_V%%.*}
+
+  # A daemon NEWER than the deployment-local CLI means a foreign global pm2 owns
+  # it. \`pm2 update\` would DOWNGRADE the daemon and feed it a dump it can't read,
+  # losing the process table — selva-compute never gets re-registered. That is an
+  # operator problem, not something this script can repair, so stop before we
+  # take the app down.
+  if [ -n "$DAEMON_MAJOR" ] && [ -n "$LOCAL_MAJOR" ] && [ "$DAEMON_MAJOR" -gt "$LOCAL_MAJOR" ] 2>/dev/null; then
+    echo "[FATAL] PM2_SKEW: the running daemon (v$DAEMON_V) is NEWER than this deployment's pm2 (v$LOCAL_V)."
+    echo "[FATAL] A global pm2 owns the daemon. Running 'pm2 update' would downgrade it and drop"
+    echo "[FATAL] the process table. Resolve manually before updating:"
+    echo "[FATAL]   which -a pm2 && pm2 -v && pm2 ping"
+    echo "[FATAL] Aborting WITHOUT stopping the app — it is still running."
+    exit 8
+  fi
+
+  # Under systemd, \`pm2 update\` kills and respawns the daemon. systemd sees its
+  # unit's main process die and, with the default KillMode=control-group,
+  # SIGTERMs everything in the cgroup — including this runner. setsid escapes
+  # PM2's tree-kill but NOT the cgroup, so there is no way to survive it from
+  # here; refuse the resync instead of being killed by it.
+  if grep -qs 'pm2.*\\.service' /proc/self/cgroup 2>/dev/null; then
+    echo "[FATAL] SYSTEMD_PM2: this deployment's PM2 is supervised by systemd, and the daemon"
+    echo "[FATAL] needs a resync. Running 'pm2 update' here would restart the systemd unit and"
+    echo "[FATAL] kill this runner mid-update. Resync manually from a shell, then retry:"
+    echo "[FATAL]   cd $(dirname "$ECOSYSTEM") && ./node_modules/.bin/pm2 update"
+    echo "[FATAL] Aborting WITHOUT stopping the app — it is still running."
+    exit 9
+  fi
+
+  echo "[STEP] PM2 daemon is out-of-date — running 'pm2 update' to resync"
+  if ! "$PM2" update; then
+    echo "[FATAL] pm2 update failed — aborting before stopping the running app"
+    exit 1
+  fi
+  echo "[INFO] PM2 daemon resynced"
+fi
+
+# ---------------------------------------------------------------------------
+# 3. Stop selva-compute BEFORE npm rewrites build/.
+# ---------------------------------------------------------------------------
+# SvelteKit's node adapter lazy-imports chunks from build/server/chunks/ on
+# every request. Letting npm rewrite build/ while the old process still
+# serves traffic means in-flight requests hit ERR_MODULE_NOT_FOUND for chunks
+# whose hash just changed under their feet. Stopping first is a brief
+# downtime window (~1-2s longer than restart-in-place) for a much smaller
+# blast radius.
+#
+# This is also where the SSE connection to the frontend dies — selva-compute
+# IS the SSE server. From here on, the user sees output via the log-file
+# polling fallback in the admin UI, not over SSE.
+echo "[STEP] Stopping selva-compute"
+if ! "$PM2" stop selva-compute; then
+  echo "[WARN] pm2 stop failed — selva-compute may not be running yet. Continuing."
+fi
+
+# pm2 stop returns before the process is actually gone. Everything below —
+# npm rewriting build/, then the restart — must happen outside the drain window.
+wait_until_stopped
+
+# ---------------------------------------------------------------------------
+# 4. Run npm update.
+# ---------------------------------------------------------------------------
+echo "[STEP] Updating @selvajs/* packages"
+if ! ${npmCommand}; then
+  echo "[FATAL] npm update failed — EXIT trap will restart the previous build"
+  exit 1
+fi
+
+AFTER=$(node -e "try{console.log(require('./node_modules/@selvajs/selva/package.json').version)}catch(e){}" 2>/dev/null)
+echo "[INFO] New @selvajs/selva: \${AFTER:-unknown}"
+
+if [ -n "$BEFORE" ] && [ "$BEFORE" = "$AFTER" ]; then
+  echo "[WARN] No version change ($BEFORE). Your npm cache may be stale."
+  echo "[WARN] Recover with:"
+  echo "[WARN]   npm cache clean --force"
+  echo "[WARN]   rm -rf node_modules package-lock.json"
+  echo "[WARN]   npm install --prefer-online"
+fi
+
+# ---------------------------------------------------------------------------
+# 5. Start selva-compute with the new build.
+# ---------------------------------------------------------------------------
+# Start from ecosystem.config.cjs, NOT \`pm2 start selva-compute\` — the latter
+# requires selva-compute to already be in pm2's in-memory process list, which
+# a \`pm2 update\` (step 2) isn't guaranteed to preserve.
+echo "[STEP] Starting selva-compute with new build"
+if ! start_app; then
+  echo "[FATAL] pm2 start failed — investigate with \\\`pm2 logs selva-compute\\\`"
+  exit 2
+fi
+
+# ---------------------------------------------------------------------------
+# 6. Health probe the new process.
+# ---------------------------------------------------------------------------
+# Read PORT from .env the same way scripts/update.sh does, so non-default
+# ports are respected.
+PORT=$(grep "^PORT=" .env 2>/dev/null \\
+  | head -1 \\
+  | cut -d'=' -f2 \\
+  | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//' -e 's/^["'"'"']//' -e 's/["'"'"']$//' -e 's/[[:space:]]*#.*//')
+PORT=\${PORT:-3000}
+
+echo "[STEP] Health-probing the new process on port $PORT"
+HEALTHY=0
+for i in $(seq 1 15); do
+  sleep 2
+  CODE=$(curl -sS -o /tmp/selva-health.$$ -w "%{http_code}" --max-time 5 "http://localhost:$PORT/api/health" 2>/dev/null || echo "000")
+  if [ "$CODE" = "200" ]; then
+    HEALTHY=1
+    echo "[INFO] Health probe passed after \${i} attempt(s)"
+    rm -f /tmp/selva-health.$$
+    break
+  fi
+  echo "[INFO] Probe attempt $i/15: HTTP $CODE — retrying"
+done
+
+if [ "$HEALTHY" = "1" ]; then
+  echo "[DONE] Update complete"
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# 7. Rollback path.
+# ---------------------------------------------------------------------------
+echo "[FATAL] New process failed health check after 30s"
+if [ -f /tmp/selva-health.$$ ]; then
+  echo "[FATAL] Last response body:"
+  cat /tmp/selva-health.$$
+  rm -f /tmp/selva-health.$$
+fi
+
+if [ -z "$BEFORE" ]; then
+  echo "[FATAL] No prior version recorded — cannot roll back automatically."
+  echo "[FATAL] EXIT trap will attempt to restart the current build anyway."
+  exit 3
+fi
+
+echo "[STEP] Rolling back @selvajs/selva to $BEFORE"
+"$PM2" stop selva-compute >/dev/null 2>&1 || true
+wait_until_stopped >/dev/null 2>&1
+# Restore @selvajs/cli alongside the runtime: the forward step installs both at
+# the channel tag, so reverting only the runtime leaves a version pair that was
+# never released together.
+if ! npm install --save "@selvajs/cli@$BEFORE" "@selvajs/selva@$BEFORE"; then
+  echo "[FATAL] Rollback npm install failed — EXIT trap will retry restart."
+  exit 4
+fi
+
+start_app || true
+sleep 3
+ROLLBACK_CODE=$(curl -sS -o /dev/null -w "%{http_code}" --max-time 5 "http://localhost:$PORT/api/health" 2>/dev/null || echo "000")
+if [ "$ROLLBACK_CODE" = "200" ]; then
+  echo "[DONE] Rolled back to $BEFORE — previous version is online"
+  exit 5
+fi
+
+echo "[FATAL] Rollback restart also failed health check (HTTP $ROLLBACK_CODE)"
+echo "[FATAL] Manual recovery required. Check: pm2 logs selva-compute"
+exit 6
+`;
+}
+function npmInstallArgs(channel) {
+	const tag = channelTag(channel);
+	return [
+		"install",
+		"--save",
+		"--prefer-online",
+		`@selvajs/cli@${tag}`,
+		`@selvajs/selva@${tag}`
+	];
+}
+function detectUpdatePlan(env, channel) {
+	const dir = findDeploymentDir(env);
+	return dir ? {
+		cwd: dir,
+		args: npmInstallArgs(channel)
+	} : null;
+}
+//#endregion
+//#region src/routes/api/admin/system/update/+server.ts
+function stripAnsi(str) {
+	return str.replace(/\x1B\[[0-9;]*[mGKHF]/g, "");
+}
+var POST = async ({ locals }) => {
+	requirePermission(locals, "instance_admin");
+	const channel = readChannel();
+	const plan = detectUpdatePlan(private_env, channel);
+	if (!plan) return new Response(JSON.stringify({ error: "Couldn't determine how to update this deployment. Expected node_modules/@selvajs/selva (CLI scaffold) in the cwd or a parent directory." }), {
+		status: 500,
+		headers: { "Content-Type": "application/json" }
+	});
+	const versionBefore = readRuntimeVersion(plan.cwd);
+	const actorId = locals.ctx ? actorFrom(locals.ctx) : "system";
+	const pending = {
+		startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		actorId,
+		channel,
+		fromVersion: versionBefore
+	};
+	try {
+		writeFileSync(updateStatePath(plan.cwd), JSON.stringify(pending, null, "	"));
+	} catch (err) {
+		locals.log.error("Could not persist pending-update state", {
+			component: "selfUpdate",
+			err: renderThrown(err)
+		});
+	}
+	await getEventSink().emit({
+		type: "system.update.started",
+		channel,
+		fromVersion: versionBefore,
+		actorId
+	});
+	const stream = new ReadableStream({ start(controller) {
+		const encoder = new TextEncoder();
+		function sendEvent(type, data) {
+			const message = `data: ${JSON.stringify({
+				type,
+				...data
+			})}\n\n`;
+			controller.enqueue(encoder.encode(message));
+		}
+		try {
+			const prelude = [`[INFO] Updating deployment (cwd: ${plan.cwd}, channel: ${channel})`, ...versionBefore ? [`[INFO] Current @selvajs/selva: ${versionBefore}`] : []];
+			const runnerScript = buildNpmRunnerScript(plan.args, versionBefore, join(plan.cwd, "ecosystem.config.cjs"), channelTag(channel));
+			const cmd = "bash";
+			const args = ["-c", buildLauncher(runnerScript, updateLogPath(plan.cwd), prelude)];
+			const localBin = join(plan.cwd, "node_modules", ".bin");
+			const child = spawn(cmd, args, {
+				cwd: plan.cwd,
+				env: {
+					PATH: `${localBin}:${process.env.PATH ?? ""}`,
+					HOME: process.env.HOME,
+					INSTALL_DIR: plan.cwd
+				},
+				detached: true,
+				stdio: [
+					"ignore",
+					"pipe",
+					"pipe"
+				]
+			});
+			child.unref();
+			startUpdateOutcomeReconciler({
+				deploymentDir: plan.cwd,
+				emit: (e) => getEventSink().emit(e),
+				report: (err) => getErrorReporter().capture(err, { tags: { origin: "selfUpdate" } })
+			});
+			const timeout = setTimeout(() => {
+				try {
+					if (child.pid) process.kill(-child.pid, "SIGTERM");
+				} catch {}
+				sendEvent("log", { data: "[FATAL] Update timed out after 15 minutes" });
+				sendEvent("exit", { code: -1 });
+				controller.close();
+			}, 9e5);
+			let restarting = false;
+			child.stdout.on("data", (data) => {
+				const lines = data.toString().split("\n");
+				for (const line of lines) {
+					const clean = stripAnsi(line).trim();
+					if (clean) if (!restarting && (clean.includes("Applying action stopProcessId") || clean.includes("Applying action restartProcessId"))) {
+						restarting = true;
+						sendEvent("restarting", { data: clean });
+					} else sendEvent("log", { data: clean });
+				}
+			});
+			child.stderr.on("data", (data) => {
+				const lines = data.toString().split("\n");
+				for (const line of lines) {
+					const clean = stripAnsi(line).trim();
+					if (clean) sendEvent("log", { data: `[ERROR] ${clean}` });
+				}
+			});
+			child.on("close", (code) => {
+				clearTimeout(timeout);
+				sendEvent("exit", { code: code ?? -1 });
+				controller.close();
+			});
+			child.on("error", (err) => {
+				clearTimeout(timeout);
+				sendEvent("log", { data: `[FATAL] ${err.message}` });
+				sendEvent("exit", { code: -1 });
+				controller.close();
+			});
+		} catch (err) {
+			sendEvent("log", { data: `[FATAL] Failed to spawn process: ${err}` });
+			sendEvent("exit", { code: -1 });
+			controller.close();
+		}
+	} });
+	return new Response(stream, { headers: {
+		"Content-Type": "text/event-stream",
+		"Cache-Control": "no-cache",
+		Connection: "keep-alive"
+	} });
+};
+var GET = async ({ locals, url, fetch }) => {
+	requirePermission(locals, "instance_admin");
+	if (url.searchParams.get("check") !== null) return json(await checkForUpdate(fetch, readChannel()), { headers: { "Cache-Control": "no-store" } });
+	let body = "";
+	try {
+		body = readFileSync(updateLogPath(findDeploymentDir(private_env)), "utf8");
+	} catch {}
+	return new Response(body, { headers: {
+		"Content-Type": "text/plain; charset=utf-8",
+		"Cache-Control": "no-store"
+	} });
+};
+
+export { GET, POST };
+//# sourceMappingURL=_server.ts.js-DNoYUUBX.js.map