@procedures/server 0.52.2 → 0.53.1

package/CHANGELOG.md

@@ -1,5 +1,62 @@
 # @procedures/server
 
+## 0.53.1
+
+### Patch Changes
+
+- Updated dependencies [84f0c78]
+- Updated dependencies [abf290c]
+  - @procedures/client@0.53.1
+  - @procedures/fs@0.53.1
+  - @procedures/peer@0.53.1
+
+## 0.53.0
+
+### Patch Changes
+
+- The packages use the new versions of their dependencies of the owner: `@mark1russell7/service` `^0.8.3`, `@mark1russell7/coeval` `^0.26.1` and `@mark1russell7/docker-sqlite` `^0.3.0`. The range of `@mark1russell7/collections` stays `^0.5.0`: its version 0.7.0 and later remove names that `@procedures/collections` exports.
+- 556d0a8: The packages use `@mark1russell7/service` `^0.8.2` in place of `^0.6.0`. Version 0.7.0 adds the refusal cause `capacity`, and version 0.8.0 refuses a listen backlog of 0. Version 0.8.2 adds the call context of OpenTelemetry. The types `Clock` and `Cancel` of `@mark1russell7/service/clock` do not change: their home is `@mark1russell7/algebra/clock`, and the entry gives them again.
+  
+  A refusal of a call limit with the cause `capacity` gives `RATE_LIMITED` that is not retryable and has no `retry-after`. A take of one unit does not get this cause, because each policy holds 1 unit or more.
+- Updated dependencies [bc98f77]
+- Updated dependencies [11d9084]
+- Updated dependencies [d28ccb5]
+- Updated dependencies [735cfcf]
+- Updated dependencies [0da2c6d]
+- Updated dependencies
+- Updated dependencies [556d0a8]
+  - @procedures/client@0.53.0
+  - @procedures/peer@0.53.0
+  - @procedures/fs@0.53.0
+
+## 0.52.5
+
+### Patch Changes
+
+- 36adc69: `runProcedureHost()` takes the option `telemetry`: a function that starts the telemetry SDK of the app. The host starts it before the dependencies and the listeners, and gives `{ stopOnSignals: false }`. The phase `flush the output` stops it last. The cap of the phase limits the wait. The new exports are `TELEMETRY_FLUSH_PHASE`, `HostTelemetry` and `HostTelemetryOptions`.
+- Updated dependencies [25a5f44]
+  - @procedures/client@0.52.5
+  - @procedures/fs@0.52.5
+  - @procedures/peer@0.52.5
+
+## 0.52.4
+
+### Patch Changes
+
+- 79cd1ee: The procedures `server.start` and `server.status` get the folder `~/.mark` and the folder of the lockfiles from `getMarkDir()` and `getServersDir()` of `@procedures/peer/lockfile`. Before, each of the two files made its own copy of the path. The paths do not change.
+- @procedures/client@0.52.4
+  - @procedures/fs@0.52.4
+  - @procedures/peer@0.52.4
+
+## 0.52.3
+
+### Patch Changes
+
+- Updated dependencies [db1bcaa]
+  - @procedures/client@0.52.3
+  - @procedures/fs@0.52.3
+  - @procedures/peer@0.52.3
+
 ## 0.52.2
 
 ### Patch Changes

package/README.md

@@ -337,11 +337,16 @@ await life.done; // the runner ends the process after the stop in stages
 - **The lockfile.** `lockfile` makes the lockfile a dependency of the service. The startup writes it before the listeners start, and the shutdown removes it after the listeners close.
 - **The probes.** Each listener of the host answers the probes under `/_probes` (CLI-9). `probes: { port, host, prefix, retryAfter }` moves them to a probe server on a port of its own (decision D5). `probes()` of the result gives the base URL of each place that answers them.
 - **The parts of the app.** `declare(svc, host)` gives the builder of the service to the app before `run()` (CLI-62). The app declares its transports, dependencies, checks and phase work with the methods of the builder. `describe()` shows them, and the runner starts and stops them with the host. The example follows this list.
+- **The telemetry.** `telemetry` starts the telemetry SDK of the app before the dependencies and the listeners (CLI-130). The phase `flush the output` stops it last. The example after the list shows it.
 - **Outside a service.** `startServer()` starts the same server as a peer, for a test or an app that has its own lifecycle.
 
 ```typescript
+import { startNodeTelemetry } from "@mark1russell7/otel-ts/node";
+
 const { host, life } = await runProcedureHost({
   name: "app-dev",
+  // The host gives { stopOnSignals: false }: the runner owns the signals
+  telemetry: (options) => startNodeTelemetry({ serviceName: "app-dev", ...options }),
   mode: "foreground",
   // The calls wait for the readiness of the dependency of the app (CLI-45)
   host: { name: "app", registry, policy, controller: { requires: ["mongo"] }, listen },
@@ -361,6 +366,7 @@ const { host, life } = await runProcedureHost({
 - The parts of the app come after the parts of the host. Thus the server of the host starts before a transport of the app. A listener of the app can mount `host.handler`.
 - The lockfile comes after the dependencies of the app. It connects last, and it closes first.
 - Without `declare`, the service has only the parts of the host.
+- The cap of the phase `flush the output` limits the wait for the telemetry: 1 s in `localDev` and `daemon`. The host refuses `telemetry` with a profile that has no such phase.
 
 #### The logger