@evolu/relay 4.1.5 → 4.2.1

package/README.md

@@ -40,10 +40,11 @@ package. Clients reconnect and sync what they missed.
 
 The relay reads `PORT` and Relay-specific `EVOLU_RELAY_*` environment variables:
 
-| Variable                      | Default  | Description                                                     |
-| ----------------------------- | -------- | --------------------------------------------------------------- |
-| `PORT`                        | `4000`   | The TCP port to listen on, also supplied by hosting platforms.  |
-| `EVOLU_RELAY_MAX_OWNER_BYTES` | No limit | The storage quota per owner, as a size literal such as `10MiB`. |
+| Variable                      | Default  | Description                                                                                          |
+| ----------------------------- | -------- | ---------------------------------------------------------------------------------------------------- |
+| `PORT`                        | `4000`   | The TCP port to listen on, also supplied by hosting platforms.                                       |
+| `EVOLU_RELAY_MAX_OWNER_BYTES` | No limit | The storage quota per owner, as a size literal such as `10MiB`.                                      |
+| `EVOLU_RELAY_LOG_LEVEL`       | `log`    | The console level, from `trace` to `silent`. `debug` also logs connections, `trace` every SQL query. |
 
 Quota values use `ByteSizeLiteral`, such as `0B`, `512KiB`, or `1.5GiB`.
 Bare byte counts such as `1048576` are not accepted; use `1MiB` instead.
@@ -59,8 +60,11 @@ never fall back to defaults. `EVOLU_RELAY_PORT` is not supported; use `PORT`.
 PORT=4001 EVOLU_RELAY_MAX_OWNER_BYTES=10MiB npx @evolu/relay
 ```
 
-The Docker health check follows `PORT`. Use a fixed, nonzero port in Docker;
-`PORT=0` selects an unpredictable port that the health check cannot discover.
+For uptime monitors and load balancers, the relay answers `GET` and `HEAD`
+requests for `/health` with status 200 while its database file can be read and
+with status 503 otherwise. The Docker health check requests it on `PORT`. Use a
+fixed, nonzero port in Docker; `PORT=0` selects an unpredictable port that the
+health check cannot discover.
 The image exposes port 4000, so map a custom port explicitly:
 
 ```bash

package/dist/src/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { ByteSizeLiteral, byteSizeToByteLength, createConsole, createConsoleFormatter, env, optional, Port, PortFromString, withDefault, } from "@evolu/common";
+import { ByteSizeLiteral, byteSizeToByteLength, createConsole, createConsoleFormatter, env, optional, Port, PortFromString, union, withDefault, } from "@evolu/common";
 import { installPolyfills } from "@evolu/common/polyfills";
 import { createRelay, createRelayDeps, runMain } from "@evolu/nodejs";
 import { mkdirSync } from "node:fs";
@@ -8,13 +8,13 @@ installPolyfills();
 const RelayEnv = env({
     port: withDefault(optional(PortFromString), Port.orThrow(4000)),
     EVOLU_RELAY: {
+        logLevel: optional(union("trace", "debug", "log", "info", "warn", "error", "silent")),
         maxOwnerBytes: optional(ByteSizeLiteral),
     },
 });
 const deps = {
     ...createRelayDeps(),
     console: createConsole({
-        // level: "debug",
         formatter: createConsoleFormatter()({
             timestampFormat: "relative",
         }),
@@ -22,6 +22,8 @@ const deps = {
 };
 await runMain(deps)((run) => {
     const config = RelayEnv.orThrow(process.env, { errors: "all" });
+    if (config.logLevel !== undefined)
+        run.deps.console.setLevel(config.logLevel);
     const maxOwnerBytes = config.maxOwnerBytes === undefined
         ? undefined
         : byteSizeToByteLength(config.maxOwnerBytes);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evolu/relay",
-  "version": "4.1.5",
+  "version": "4.2.1",
   "description": "Evolu Relay server",
   "keywords": [
     "evolu",
@@ -27,8 +27,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@evolu/common": "8.15.1",
-    "@evolu/nodejs": "4.1.1"
+    "@evolu/common": "8.17.0",
+    "@evolu/nodejs": "4.2.0"
   },
   "devDependencies": {
     "@evolu/typescript-config": "0.1.1",