document-rest 1.3.0 → 1.4.1

package/README.md

@@ -22,6 +22,16 @@ This binds a plain `node:http` listener to `127.0.0.1` (loopback only) on the gi
 
 Every release also attaches a Node [single-executable application](https://nodejs.org/api/single-executable-applications.html) build for Linux (x64 and arm64), Windows (x64 and arm64), and macOS (Apple Silicon and Intel) to that release's own GitHub Release assets — the entire server and its dependencies embedded in one file, needing no Node.js install or `npx` at all. For the "a caller with no Node runtime of its own" case this package exists for in the first place, this removes the last Node dependency too: download the asset matching your platform from the package's tag on the [Releases page](https://github.com/ExaDev/documents.js/releases), run it directly (`chmod +x` on Linux/macOS first), and it takes the identical `--port` flag.
 
+### Container image
+
+Every release also publishes a multi-arch (`linux/amd64` + `linux/arm64`) container image to GitHub Container Registry, wrapping the identical standalone binary above on a minimal [distroless](https://github.com/GoogleContainerTools/distroless) base rather than a Node install:
+
+```sh
+docker run -p 3100:3100 ghcr.io/exadev/documents.js:VERSION --port 3100
+```
+
+Replace `VERSION` with the package's own exact release version (e.g. `1.2.0`) — matching the version-pinned convention every other artifact in this repository uses, this image is never published under a loose major/minor tag such as `1` or `1.2`, though `latest` does track the newest release. The image binds to `0.0.0.0` inside the container regardless of `--port`, so `-p <host>:<container>` is all that's needed to reach it; see the security note above about this listener having no authentication of its own — publishing the container's port makes it reachable by anything that can reach the host, so put a reverse proxy or firewall in front of it before exposing it beyond your own machine.
+
 ## API
 
 **`GET /`** lists every available operation:

package/dist/bin.js

@@ -131,15 +131,17 @@ function parsePort(raw) {
 * Returns the listening `Server` rather than resolving `void` so a caller with a reason to stop it again (a test binding an ephemeral port for the duration of one assertion) can -- neither real distribution shape needs to, so both simply discard it.
 */
 async function main() {
-	const portArg = readFlag(process.argv.slice(2), "port");
+	const args = process.argv.slice(2);
+	const portArg = readFlag(args, "port");
 	const port = portArg === void 0 ? DEFAULT_PORT : parsePort(portArg);
+	const host = readFlag(args, "host") ?? "127.0.0.1";
 	const server = createRestServer();
 	await new Promise((resolve) => {
-		server.listen(port, "127.0.0.1", resolve);
+		server.listen(port, host, resolve);
 	});
 	const address = server.address();
 	if (address === null || typeof address === "string") throw new Error("Expected the HTTP server to bind a TCP address, not a pipe or Unix socket");
-	console.error(`document-rest listening on http://127.0.0.1:${String(address.port)}`);
+	console.error(`document-rest listening on http://${host}:${String(address.port)}`);
 	return server;
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document-rest",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "A plain REST API server exposing document-operations' conversion, editing, inspection, and .odb operations as JSON-over-HTTP endpoints -- one POST route per operation, for a caller with no MCP client and no Node runtime of their own.",
   "type": "module",
   "repository": {
@@ -87,8 +87,8 @@
   "license": "MIT",
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
-    "document-operations": "1.1.0",
-    "documents.js": "7.20.1",
+    "document-operations": "1.1.1",
+    "documents.js": "7.20.2",
     "zod": "4.4.3"
   },
   "devDependencies": {
@@ -97,7 +97,7 @@
     "@vitest/coverage-v8": "4.1.11",
     "eslint": "10.8.1",
     "husky": "9.1.7",
-    "odf.js": "7.25.1",
+    "odf.js": "7.25.2",
     "publint": "0.3.22",
     "semantic-release": "25.0.9",
     "tsdown": "0.22.14",