@procedures/peer 0.11.0 → 0.12.1

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @procedures/peer
 
+## 0.12.1
+
+### Patch Changes
+
+- 9fccd90: `createProcedureHost()` has the new option `controller` (server stack CLI-45). `controller.requires` names the dependencies of the service that each call of the host needs. `host.controllers` gives them, and `host.declare(svc)` declares them on the controller of the host. While a check of one of them fails readiness, the service refuses each call with `UNAVAILABLE`, which a caller can send again. Without the option, the controller needs no dependency, as before.
+  
+  jarvis needs this option: its procedure calls need its world store.
+- Updated dependencies [b89e3fe]
+  - @procedures/client@0.12.1
+
+## 0.12.0
+
+### Minor Changes
+
+- 9ea2030: `runProcedureHost()` of `@procedures/server` is the one runner entry on `run()` of `@mark1russell7/service`, for `procedure-server`, `mark serve` and `mark --server` (server stack CLI-8, decisions D6, D7 and D17). This change is a break of the server stack, thus it is its own MINOR (decision D13).
+  
+  - New `runProcedureHost({ name, host, mode, profile, lockfile, log, run })`. It declares the parts of `createProcedureHost()` in one service, and starts `run()`. It gives `{ host, service, life }` when the startup ends.
+  - The mode `foreground` has the profile `localDev`: a second Ctrl-C exits at once. The mode `background` has the profile `daemon`: a repeat signal has no effect. Each run declares `onRepeatSignal`. `HOST_PROFILES` gives the profiles as data.
+  - The caps of the stages sum to 10 s. They replace the hard-exit timer of 10 s of the entries.
+  - The lockfile is a dependency of the service: its connect writes it before the listeners start, and its close removes it after the listeners close. New `lockfileHandle(data)` of `@procedures/peer/lockfile`.
+  - `runServer()` (the bin `procedure-server` and `mark serve`) and `startServerMode()` (`mark --server`) install no signal handler and no hard-exit timer. Their promise ends with the lifecycle.
+  - `mark --server` is the background host (decision D17). `procedure-server` and `mark serve` run in the foreground.
+  - The entries map their transports to a host with `peerHostOptions()` of `@procedures/peer` (CLI-7).
+  - `ServerRunOptions.run` and the second argument of `startServerMode()` take the options of `run()`, for a test: a process port and a clock.
+  - A random token of `procedure-server` has 32 bytes, as the token of `mark --server`.
+  - The one-shot commands of `mark` keep their interrupt. CLI-26 moves them under `run()`.
+  
+  The behavior that changes:
+  
+  - A second Ctrl-C of `mark --server` has no effect: the host ends its drain, in 10 s at most. A second Ctrl-C of `procedure-server` and `mark serve` exits at once with the code 1, as before.
+  - The process exits with the code of the lifecycle: 0 after a clean shutdown, and 1 after an error or a startup that failed.
+  - A random token of `procedure-server` has 64 hexadecimal characters, not 48.
+  
+  Migration steps:
+  
+  - The site, MiniMongo, Graph and jarvis: no change is necessary. They do not start these entries.
+  - A script that starts `procedure-server` or `mark serve` and stops it with a signal: no change is necessary. Wait for the exit, in 10 s at most.
+  - A program that embeds the server outside a service: use `startServer()`, which starts it as a peer, and `peer.stop()`.
+
+### Patch Changes
+
+- @procedures/client@0.12.0
+
 ## 0.11.0
 
 ### Minor Changes

package/README.md

@@ -140,6 +140,7 @@ await svc.run();
 - **The faces.** `http` and `ws` are the faces of this package (`httpFace()`, `wsFace()`). `mcp` takes `mcpFace()` of `@procedures/mcp-server`. A face of another package is a function with the same shape.
 - **The listeners.** The faces of a listener mount on its mount list, so they share one port. Without `listen`, the app mounts `host.handler` and `host.upgrade` on its own listener.
 - **The request tracking.** Each call goes through `life.request`, with the route `<face> <procedure>`. The function of the pattern gives the idempotency of each call: a repeatable procedure, a keyed call, or a call that runs one time (decision D3).
+- **The readiness of the calls.** The option `controller.requires` names the dependencies of the service that each call needs. While a check of one of them fails readiness, the service refuses each call with `UNAVAILABLE` (CLI-45).
 - **The streams.** Each call is a stream, and a unary call is a stream of one (decision D4). A stream stays in flight until its end. A cut after the first item ends the stream with an error line.
 - **The collections.** The option `collections` gives the storages. The host serves `collections.<name>.*` for each one.
 - **No `/health` route.** The probes come from the runner (`probeHandler` or `probeServer`). A client checks a lockfile with `host.info` and the token of the lockfile.