@mark1russell7/service 0.8.19 → 0.8.20
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/build/backoff.d.ts +44 -2
- package/build/{builder-zO48Vgoj.d.ts → builder.d.ts} +14 -101
- package/build/builder.js +499 -0
- package/build/builder.js.map +1 -0
- package/build/{call-context-DDhcVvn5.d.ts → call-context.d.ts} +3 -4
- package/build/channel.d.ts +1 -1
- package/build/{core-BSzt4RI2.d.ts → client/core.d.ts} +32 -61
- package/build/{machine-BhVeHr_m.js → client/core.js} +4 -153
- package/build/client/core.js.map +1 -0
- package/build/{dial-ChwIcvd4.d.ts → client/dial.d.ts} +3 -4
- package/build/client/dial.js +52 -0
- package/build/client/dial.js.map +1 -0
- package/build/client/machine.js +29 -0
- package/build/client/machine.js.map +1 -0
- package/build/client/meets.d.ts +35 -0
- package/build/client/meets.js +78 -0
- package/build/client/meets.js.map +1 -0
- package/build/clock.d.ts +1 -1
- package/build/conformance.d.ts +122 -0
- package/build/conformance.js +470 -0
- package/build/conformance.js.map +1 -0
- package/build/contract.d.ts +28 -0
- package/build/contract.js +184 -0
- package/build/contract.js.map +1 -0
- package/build/description.d.ts +161 -0
- package/build/description.js +11 -0
- package/build/description.js.map +1 -0
- package/build/drains.js +35 -0
- package/build/drains.js.map +1 -0
- package/build/events.d.ts +25 -0
- package/build/fakes.d.ts +43 -0
- package/build/fakes.js +93 -0
- package/build/fakes.js.map +1 -0
- package/build/grpc/client.d.ts +153 -0
- package/build/grpc/client.js +474 -0
- package/build/grpc/client.js.map +1 -0
- package/build/grpc/connection.d.ts +97 -0
- package/build/grpc/connection.js +59 -0
- package/build/grpc/connection.js.map +1 -0
- package/build/grpc/machine.d.ts +12 -0
- package/build/grpc/machine.js +149 -0
- package/build/grpc/machine.js.map +1 -0
- package/build/grpc/meets.d.ts +14 -0
- package/build/grpc/meets.js +105 -0
- package/build/grpc/meets.js.map +1 -0
- package/build/grpc/starting.d.ts +33 -0
- package/build/grpc/starting.js +89 -0
- package/build/grpc/starting.js.map +1 -0
- package/build/grpc.d.ts +9 -303
- package/build/grpc.js +7 -854
- package/build/health.d.ts +93 -0
- package/build/health.js +223 -0
- package/build/health.js.map +1 -0
- package/build/heartbeat.d.ts +1 -1
- package/build/host/discovery.d.ts +61 -0
- package/build/host/discovery.js +113 -0
- package/build/host/discovery.js.map +1 -0
- package/build/host/env.d.ts +14 -0
- package/build/host/env.js +57 -0
- package/build/host/env.js.map +1 -0
- package/build/host/fakes.d.ts +82 -0
- package/build/host/fakes.js +239 -0
- package/build/host/fakes.js.map +1 -0
- package/build/host/group.d.ts +142 -0
- package/build/host/group.js +517 -0
- package/build/host/group.js.map +1 -0
- package/build/host/install.d.ts +96 -0
- package/build/host/install.js +330 -0
- package/build/host/install.js.map +1 -0
- package/build/host/lock.d.ts +78 -0
- package/build/host/lock.js +190 -0
- package/build/host/lock.js.map +1 -0
- package/build/host/logs.d.ts +26 -0
- package/build/host/logs.js +48 -0
- package/build/host/logs.js.map +1 -0
- package/build/host/node.d.ts +14 -0
- package/build/host/node.js +309 -0
- package/build/host/node.js.map +1 -0
- package/build/{ports-B1ayTL-j.d.ts → host/ports.d.ts} +15 -16
- package/build/host/ports.js +17 -0
- package/build/host/ports.js.map +1 -0
- package/build/host/probes.d.ts +51 -0
- package/build/host/probes.js +139 -0
- package/build/host/probes.js.map +1 -0
- package/build/host/processes.d.ts +32 -0
- package/build/host/processes.js +63 -0
- package/build/host/processes.js.map +1 -0
- package/build/host/render.d.ts +84 -0
- package/build/host/render.js +235 -0
- package/build/host/render.js.map +1 -0
- package/build/host/watch.d.ts +90 -0
- package/build/host/watch.js +165 -0
- package/build/host/watch.js.map +1 -0
- package/build/host.d.ts +13 -671
- package/build/host.js +12 -2126
- package/build/http/answers.js +29 -0
- package/build/http/answers.js.map +1 -0
- package/build/http/fake-server.js +61 -0
- package/build/http/fake-server.js.map +1 -0
- package/build/http/outcome.d.ts +115 -0
- package/build/http/outcome.js +325 -0
- package/build/http/outcome.js.map +1 -0
- package/build/http/probes.d.ts +83 -0
- package/build/http/probes.js +232 -0
- package/build/http/probes.js.map +1 -0
- package/build/http/transport.d.ts +165 -0
- package/build/http/transport.js +517 -0
- package/build/http/transport.js.map +1 -0
- package/build/http-client/client.d.ts +121 -0
- package/build/http-client/client.js +330 -0
- package/build/http-client/client.js.map +1 -0
- package/build/http-client/connection.d.ts +78 -0
- package/build/http-client/connection.js +54 -0
- package/build/http-client/connection.js.map +1 -0
- package/build/http-client/machine.d.ts +14 -0
- package/build/http-client/machine.js +109 -0
- package/build/http-client/machine.js.map +1 -0
- package/build/http-client/meets.d.ts +11 -0
- package/build/http-client/meets.js +74 -0
- package/build/http-client/meets.js.map +1 -0
- package/build/http-client/session.d.ts +87 -0
- package/build/http-client/session.js +99 -0
- package/build/http-client/session.js.map +1 -0
- package/build/http-client/starting.d.ts +25 -0
- package/build/http-client/starting.js +65 -0
- package/build/http-client/starting.js.map +1 -0
- package/build/http-client.d.ts +9 -330
- package/build/http-client.js +8 -707
- package/build/http.d.ts +5 -353
- package/build/http.js +3 -1086
- package/build/identity.d.ts +16 -0
- package/build/identity.js +44 -0
- package/build/identity.js.map +1 -0
- package/build/index.d.ts +35 -412
- package/build/index.js +24 -3277
- package/build/knobs.d.ts +1 -0
- package/build/{knobs-BJcz6m01.js → knobs.js} +2 -34
- package/build/knobs.js.map +1 -0
- package/build/latch.d.ts +29 -0
- package/build/latch.js +122 -0
- package/build/latch.js.map +1 -0
- package/build/{rules-HyFCBStQ.d.ts → law.d.ts} +19 -37
- package/build/law.js +149 -0
- package/build/law.js.map +1 -0
- package/build/lifecycle.d.ts +144 -0
- package/build/lifecycle.js +411 -0
- package/build/lifecycle.js.map +1 -0
- package/build/limiter/machine.d.ts +40 -0
- package/build/limiter/machine.js +279 -0
- package/build/limiter/machine.js.map +1 -0
- package/build/{policy-CBcK2XGg.d.ts → limiter/policy.d.ts} +28 -29
- package/build/{policy-UYALkqVq.js → limiter/policy.js} +10 -9
- package/build/limiter/policy.js.map +1 -0
- package/build/{limiter-BNKnwzeY.d.ts → limiter/quota.d.ts} +32 -74
- package/build/{limiter-DrM0PQV9.js → limiter/quota.js} +3 -418
- package/build/limiter/quota.js.map +1 -0
- package/build/{store-DFwFKrsB.d.ts → limiter/store.d.ts} +10 -11
- package/build/limiter/store.js +145 -0
- package/build/limiter/store.js.map +1 -0
- package/build/limiter.d.ts +4 -3
- package/build/limiter.js +4 -2
- package/build/lint.d.ts +152 -0
- package/build/lint.js +576 -0
- package/build/lint.js.map +1 -0
- package/build/logger.d.ts +71 -0
- package/build/logger.js +183 -0
- package/build/logger.js.map +1 -0
- package/build/machines.d.ts +41 -0
- package/build/machines.js +451 -0
- package/build/machines.js.map +1 -0
- package/build/metrics.d.ts +53 -0
- package/build/metrics.js +111 -0
- package/build/metrics.js.map +1 -0
- package/build/mongodb/client.d.ts +131 -0
- package/build/mongodb/client.js +388 -0
- package/build/mongodb/client.js.map +1 -0
- package/build/mongodb/connection.d.ts +112 -0
- package/build/mongodb/connection.js +12 -0
- package/build/mongodb/connection.js.map +1 -0
- package/build/mongodb/machine.d.ts +14 -0
- package/build/mongodb/machine.js +122 -0
- package/build/mongodb/machine.js.map +1 -0
- package/build/mongodb/meets.d.ts +15 -0
- package/build/mongodb/meets.js +103 -0
- package/build/mongodb/meets.js.map +1 -0
- package/build/mongodb/starting.d.ts +29 -0
- package/build/mongodb/starting.js +77 -0
- package/build/mongodb/starting.js.map +1 -0
- package/build/mongodb.d.ts +8 -296
- package/build/mongodb.js +7 -682
- package/build/operation.d.ts +27 -0
- package/build/{operation-DF73RZOI.js → operation.js} +2 -2
- package/build/operation.js.map +1 -0
- package/build/otel.d.ts +2 -2
- package/build/pg/client.d.ts +96 -0
- package/build/pg/client.js +277 -0
- package/build/pg/client.js.map +1 -0
- package/build/pg/connection.d.ts +75 -0
- package/build/pg/connection.js +11 -0
- package/build/pg/connection.js.map +1 -0
- package/build/pg/machine.d.ts +13 -0
- package/build/pg/machine.js +111 -0
- package/build/pg/machine.js.map +1 -0
- package/build/pg/meets.d.ts +14 -0
- package/build/pg/meets.js +83 -0
- package/build/pg/meets.js.map +1 -0
- package/build/pg/starting.d.ts +26 -0
- package/build/pg/starting.js +62 -0
- package/build/pg/starting.js.map +1 -0
- package/build/pg.d.ts +8 -219
- package/build/pg.js +7 -525
- package/build/poller.d.ts +9 -0
- package/build/poller.js +152 -0
- package/build/poller.js.map +1 -0
- package/build/process.d.ts +114 -0
- package/build/process.js +170 -0
- package/build/process.js.map +1 -0
- package/build/profiles.d.ts +68 -0
- package/build/profiles.js +120 -0
- package/build/profiles.js.map +1 -0
- package/build/{queue-DXdw1vLO.d.ts → queue.d.ts} +16 -29
- package/build/queue.js +279 -0
- package/build/queue.js.map +1 -0
- package/build/rabbitmq/client.d.ts +144 -0
- package/build/rabbitmq/client.js +426 -0
- package/build/rabbitmq/client.js.map +1 -0
- package/build/rabbitmq/connection.d.ts +91 -0
- package/build/rabbitmq/connection.js +15 -0
- package/build/rabbitmq/connection.js.map +1 -0
- package/build/rabbitmq/machine.d.ts +13 -0
- package/build/rabbitmq/machine.js +159 -0
- package/build/rabbitmq/machine.js.map +1 -0
- package/build/rabbitmq/meets.d.ts +12 -0
- package/build/rabbitmq/meets.js +96 -0
- package/build/rabbitmq/meets.js.map +1 -0
- package/build/rabbitmq/starting.d.ts +27 -0
- package/build/rabbitmq/starting.js +67 -0
- package/build/rabbitmq/starting.js.map +1 -0
- package/build/rabbitmq.d.ts +8 -283
- package/build/rabbitmq.js +7 -742
- package/build/redis/client.d.ts +86 -0
- package/build/redis/client.js +285 -0
- package/build/redis/client.js.map +1 -0
- package/build/redis/connection.d.ts +57 -0
- package/build/redis/connection.js +11 -0
- package/build/redis/connection.js.map +1 -0
- package/build/redis/limiter.d.ts +43 -0
- package/build/redis/limiter.js +164 -0
- package/build/redis/limiter.js.map +1 -0
- package/build/redis/machine.d.ts +12 -0
- package/build/redis/machine.js +144 -0
- package/build/redis/machine.js.map +1 -0
- package/build/redis/meets.d.ts +11 -0
- package/build/redis/meets.js +75 -0
- package/build/redis/meets.js.map +1 -0
- package/build/redis/operations.d.ts +5 -0
- package/build/redis/operations.js +114 -0
- package/build/redis/operations.js.map +1 -0
- package/build/redis.d.ts +10 -207
- package/build/redis.js +9 -771
- package/build/requests.d.ts +66 -0
- package/build/requests.js +279 -0
- package/build/requests.js.map +1 -0
- package/build/retrier.d.ts +62 -0
- package/build/{retrier-Dnjhvxol.js → retrier.js} +2 -2
- package/build/retrier.js.map +1 -0
- package/build/routes.d.ts +35 -0
- package/build/routes.js +77 -0
- package/build/routes.js.map +1 -0
- package/build/rules.d.ts +19 -2
- package/build/stops.d.ts +51 -0
- package/build/stops.js +86 -0
- package/build/stops.js.map +1 -0
- package/build/testing.d.ts +8 -270
- package/build/testing.js +4 -1027
- package/build/testing.js.map +1 -1
- package/build/timing.d.ts +63 -0
- package/build/{timing-DZl36uXs.js → timing.js} +2 -2
- package/build/timing.js.map +1 -0
- package/build/units.d.ts +17 -0
- package/build/units.js +236 -0
- package/build/units.js.map +1 -0
- package/build/watchdog.d.ts +34 -0
- package/build/watchdog.js +53 -0
- package/build/watchdog.js.map +1 -0
- package/build/websocket/client.d.ts +136 -0
- package/build/websocket/client.js +422 -0
- package/build/websocket/client.js.map +1 -0
- package/build/websocket/connection.d.ts +83 -0
- package/build/websocket/connection.js +57 -0
- package/build/websocket/connection.js.map +1 -0
- package/build/websocket/machine.d.ts +12 -0
- package/build/websocket/machine.js +155 -0
- package/build/websocket/machine.js.map +1 -0
- package/build/websocket/meets.d.ts +14 -0
- package/build/websocket/meets.js +92 -0
- package/build/websocket/meets.js.map +1 -0
- package/build/websocket/starting.d.ts +25 -0
- package/build/websocket/starting.js +69 -0
- package/build/websocket/starting.js.map +1 -0
- package/build/websocket.d.ts +9 -264
- package/build/websocket.js +8 -774
- package/build/worker.d.ts +92 -0
- package/build/worker.js +153 -0
- package/build/worker.js.map +1 -0
- package/package.json +4 -3
- package/build/backoff-QTRGfkEK.d.ts +0 -45
- package/build/clock-DpVgpY4h.d.ts +0 -2
- package/build/grpc.js.map +0 -1
- package/build/host.js.map +0 -1
- package/build/http-client.js.map +0 -1
- package/build/http.js.map +0 -1
- package/build/index.js.map +0 -1
- package/build/knobs-BJcz6m01.js.map +0 -1
- package/build/lifecycle-D0J-zwZF.d.ts +0 -374
- package/build/limiter-DrM0PQV9.js.map +0 -1
- package/build/logger-B6drv9w0.d.ts +0 -488
- package/build/machine-BhVeHr_m.js.map +0 -1
- package/build/mongodb.js.map +0 -1
- package/build/operation-DF73RZOI.js.map +0 -1
- package/build/pg.js.map +0 -1
- package/build/policy-UYALkqVq.js.map +0 -1
- package/build/process-7R9M29wN.js +0 -437
- package/build/process-7R9M29wN.js.map +0 -1
- package/build/rabbitmq.js.map +0 -1
- package/build/redis.js.map +0 -1
- package/build/requests-DD2ALv0_.js +0 -583
- package/build/requests-DD2ALv0_.js.map +0 -1
- package/build/retrier-Dnjhvxol.js.map +0 -1
- package/build/timing-DZl36uXs.js.map +0 -1
- package/build/websocket.js.map +0 -1
package/build/host.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"host.js","names":["NAME","xmlText","record","ms","isTimeAtLeast","spawnChild"],"sources":["../src/host/ports.ts","../src/host/render.ts","../src/host/processes.ts","../src/host/lock.ts","../src/host/discovery.ts","../src/host/install.ts","../src/host/probes.ts","../src/host/watch.ts","../src/host/env.ts","../src/host/logs.ts","../src/host/group.ts","../src/host/node.ts"],"sourcesContent":["import type { Clock } from \"../clock.ts\";\nimport type { Logger } from \"../logger.ts\";\n\n/** These options go with one command: the folder that it runs in, and the most time that it can take. */\nexport interface CommandOptions {\n readonly cwd?: string | undefined;\n /** This time is the most that the command can take, in milliseconds. After it, the command stops, and its code is 124. */\n readonly timeout?: number | undefined;\n}\n\n/** A command result is the exit code of a command and the text that it wrote to its output and its error output. */\nexport interface CommandResult {\n /** This code is the exit code. A program that is not found gives 127, and a command at its timeout gives 124. */\n readonly code: number;\n readonly out: string;\n}\n\n/**\n * A command port starts a program with a list of arguments and gives its result. It does not use a\n * shell, thus no argument needs a quote. The host uses it for `schtasks`, `systemctl` and `taskkill`.\n */\nexport interface CommandPort {\n run(file: string, args: readonly string[], options?: CommandOptions): Promise<CommandResult>;\n}\n\n/** A file port is the part of a file system that the host uses. Each path is a full path. */\nexport interface FilePort {\n /** This method gives the text of a file in UTF-8, or null when the file does not exist. */\n read(path: string): Promise<string | null>;\n /** This method writes a file. It makes the folders of the path, and it replaces the file in one step. */\n write(path: string, data: string | Uint8Array): Promise<void>;\n /** This method makes a file only when no file has the path, and tells if it made it. It makes the folders of the path. */\n create(path: string, data: string): Promise<boolean>;\n /** This method adds data at the end of a file. It makes the file and its folders when they do not exist. */\n append(path: string, data: string | Uint8Array): Promise<void>;\n /** This method gives the size of a file in bytes, or null when the file does not exist. */\n size(path: string): Promise<number | null>;\n /** This method gives a file a new path. It replaces a file at the new path. */\n rename(from: string, to: string): Promise<void>;\n /** This method removes a file. A file that does not exist is not an error. */\n remove(path: string): Promise<void>;\n}\n\n/** These are the signals that the host sends to a process. */\nexport type StopSignal = \"SIGINT\" | \"SIGTERM\" | \"SIGKILL\";\n\n/** A spawn request tells the program that a child process runs, with its arguments, its folder and its environment. */\nexport interface SpawnRequest {\n readonly program: string;\n readonly args: readonly string[];\n readonly cwd?: string | undefined;\n readonly env: Readonly<Record<string, string>>;\n /** True gives the child an IPC channel. Only a child that is a Node program can use it. */\n readonly ipc: boolean;\n}\n\n/** A child handle is a child process that the host started. */\nexport interface ChildHandle {\n /** This number is the process ID, or null when the program did not start. */\n readonly pid: number | null;\n /** This flag tells if the child has an IPC channel. */\n readonly ipc: boolean;\n /** This method adds a handler for each part of the output and of the error output of the child. */\n onOutput(handler: (stream: \"stdout\" | \"stderr\", chunk: string | Uint8Array) => void): void;\n /**\n * This method adds a handler for the end of the child. The handler gets the exit code, or null after\n * a signal, and the signal. A program that did not start also ends, with a null code.\n */\n onExit(handler: (code: number | null, signal: string | null) => void): void;\n /** This method sends a message on the IPC channel, and tells if it went. */\n send(message: unknown): boolean;\n}\n\n/**\n * A process port is the part of the processes of the system that the host uses. It finds if a\n * process is alive, it gives its start time, it sends signals and it starts a child.\n */\nexport interface ProcessesPort {\n /** This method tells if a process with this ID is alive. A process of a different user is alive too. */\n alive(pid: number): boolean;\n /** This method gives the start time of a process, in milliseconds after the epoch, or null when the system does not tell. */\n startOf(pid: number): Promise<number | null>;\n /** This method sends a signal to one process, and tells if the signal went. */\n signal(pid: number, signal: StopSignal): boolean;\n /** This method sends a signal to the process group whose leader is `pid`, and tells if the signal went. Windows has no process groups. */\n signalGroup(pid: number, signal: StopSignal): boolean;\n /** This method starts a child process. On Linux, the child leads a new process group. */\n spawn(request: SpawnRequest): ChildHandle;\n}\n\n/** An HTTP answer is the status and the text of an answer. `complete` is false when the text stopped at the limit. */\nexport interface HttpAnswer {\n readonly status: number;\n readonly body: string;\n readonly complete: boolean;\n}\n\n/** A net port does the network part of a readiness probe. */\nexport interface NetPort {\n /** This method sends a GET request, and gives the status of the answer, or null when no answer came in the timeout. */\n httpStatus(url: string, timeout: number): Promise<number | null>;\n /**\n * This method sends a GET request, and gives the status and up to `limit` bytes of the text. It gives\n * null when the answer did not end in the timeout. A probe with freshness bounds uses it. It is optional\n * for the net ports that callers wrote before it. `nodeHostPorts` and `fakeHost` have it.\n */\n httpText?(url: string, timeout: number, limit: number): Promise<HttpAnswer | null>;\n /** This method tells if a TCP connection to the host and the port opens in the timeout, in milliseconds. */\n tcpConnect(host: string, port: number, timeout: number): Promise<boolean>;\n}\n\n/** This record names a process: its ID and its start time, in milliseconds after the epoch. */\nexport interface ProcessMark {\n readonly pid: number;\n readonly startedAt: number;\n}\n\n/**\n * The host ports are each effect of the system that the host uses. A test gives fakes (`fakeHost` of\n * `./testing`), thus a test installs no task and starts no process. `nodeHostPorts()` gives the ports of Node.\n */\nexport interface HostPorts {\n /** This text is the platform, as `process.platform` gives it, for example `win32` or `linux`. */\n readonly platform: string;\n readonly commands: CommandPort;\n readonly files: FilePort;\n readonly processes: ProcessesPort;\n readonly net: NetPort;\n /** This clock gives the monotonic time and the timers. */\n readonly clock: Clock;\n /** This function gives the wall time, in milliseconds after the epoch. */\n readonly wall: () => number;\n /** This record names the process of the host itself. */\n readonly self: ProcessMark;\n /** These are the environment variables of the host. */\n readonly env: Readonly<Record<string, string | undefined>>;\n /** This text is the home folder of the user. */\n readonly homeDir: string;\n /** This function gives the user that a Windows task runs as, for example `HOST\\name`. */\n readonly user: () => string;\n /** This logger gets the log entries of the host. Without it, the host writes no log. */\n readonly logger?: Logger | undefined;\n}\n\n/** This function joins the parts of a path with the separator of the platform. */\nexport const joinPath = (platform: string, ...parts: readonly string[]): string => {\n const separator = platform === \"win32\" ? \"\\\\\" : \"/\";\n // a scan and not a regular expression, thus a long run of separators takes linear time\n const isSeparator = (char: string | undefined): boolean => char === \"/\" || char === \"\\\\\";\n const trim = (part: string, head: boolean): string => {\n let start = 0;\n let end = part.length;\n while (head && start < end && isSeparator(part[start])) start += 1;\n while (end > start && isSeparator(part[end - 1])) end -= 1;\n return part.slice(start, end);\n };\n const trimmed = parts.map((part, at) => trim(part, at !== 0));\n return trimmed.filter((part, at) => at === 0 || part !== \"\").join(separator);\n};\n","import type { Quantity } from \"@mark1russell7/quantity\";\nimport { convertible, isQuantity, valueIn } from \"@mark1russell7/quantity\";\nimport { escapeAttribute as xmlText } from \"@mark1russell7/text\";\n\n/**\n * A service start tells when the system starts the program.\n * - `logon`: at the logon of the user. The program runs until it stops.\n * - `boot`: at the start of the computer, before a logon. The program runs until it stops. It runs in the background.\n * - `{ daily: \"HH:MM\" }`: each day at that local time, as a job that runs to its end.\n */\nexport type ServiceStart = \"logon\" | \"boot\" | { readonly daily: string };\n\n/** A restart policy tells how long the system waits before it starts a program again after it stops. */\nexport interface RestartPolicy {\n /** This time is the wait before the next start. On Windows, the task starts again at whole minutes, 1 minute or more. */\n readonly after: Quantity;\n}\n\n/** A service spec tells which program the system runs as a user service, and when. */\nexport interface ServiceSpec {\n /** This name is the name of the Windows task and of the systemd unit: letters, digits, `.`, `_` and `-`. */\n readonly name: string;\n readonly description: string;\n /** This path is the full path of the program, for example the path of Node. */\n readonly program: string;\n readonly args: readonly string[];\n /** This folder is the working folder of the program. */\n readonly cwd?: string | undefined;\n readonly start: ServiceStart;\n /** This policy starts a program at logon or at boot again after it stops. Null starts it only at its start. A daily job has no restart. */\n readonly restart: RestartPolicy | null;\n /**\n * True runs the program when the user is not logged on. On Windows, the task gets an S4U logon, and Task Scheduler\n * then refuses the task from a shell that is not elevated. On Linux, the install sets the linger of the user\n * (`loginctl enable-linger`), thus the user manager of systemd starts at boot and stays after the logout.\n * The default is true for a boot start, and false for the other starts.\n */\n readonly background?: boolean | undefined;\n /** This folder keeps the files of the host, for example the task file of Windows. */\n readonly stateDir: string;\n /** On Windows, `hidden` starts the program through `conhost --headless`, thus no window opens. The default is `hidden`. */\n readonly console?: \"hidden\" | \"visible\" | undefined;\n /** This time is the most that one run can take. The default is no limit. */\n readonly timeLimit?: Quantity | undefined;\n}\n\n/** These are the parts of the task of Windows that come from the system, not from the spec. */\nexport interface TaskContext {\n /** This text is the user of the task, for example `HOST\\name`. */\n readonly user: string;\n /** This path is the path of `conhost.exe`, for a hidden console. */\n readonly conhost: string;\n}\n\nconst NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;\nconst DAILY = /^([01]\\d|2[0-3]):([0-5]\\d)$/;\n/** This function tells if a text has a control character. Such a character can add a line to a unit, or break the task file. */\nconst hasControl = (text: string): boolean => {\n for (let at = 0; at < text.length; at += 1) {\n const code = text.charCodeAt(at);\n if (code < 0x20 || code === 0x7f) return true;\n }\n return false;\n};\n\n/** This function gives the time of a daily start, or null when the text is not `HH:MM`. */\nexport const dailyTime = (text: string): { readonly hour: string; readonly minute: string } | null => {\n const found = DAILY.exec(text);\n return found === null ? null : { hour: found[1]!, minute: found[2]! };\n};\n\n/** This function tells if the program of a spec runs until it stops: a start at logon or at boot, not a daily job. */\nexport const runsUntilStop = (start: ServiceStart): start is \"logon\" | \"boot\" => start === \"logon\" || start === \"boot\";\n\n/** This function tells if a spec runs when the user is not logged on: its `background`, or true for a boot start. */\nexport const inBackground = (spec: ServiceSpec): boolean => spec.background ?? spec.start === \"boot\";\n\n/** This function tells if a value is a time: a quantity in a unit of time. */\nexport const isTime = (value: unknown): value is Quantity => isQuantity(value) && convertible(value.unit, \"ms\");\n\n/** This function gives the problems of a service spec: each value that the task or the unit cannot use. */\nexport const serviceProblems = (spec: ServiceSpec): string[] => {\n const problems: string[] = [];\n if (!NAME.test(spec.name)) problems.push(`the name ${JSON.stringify(spec.name)} is not letters, digits, \".\", \"_\" and \"-\"`);\n const fields: Array<[string, string]> = [\n [\"description\", spec.description],\n [\"program\", spec.program],\n [\"stateDir\", spec.stateDir],\n ...spec.args.map((arg, at): [string, string] => [`argument ${at}`, arg]),\n ...(spec.cwd === undefined ? [] : [[\"cwd\", spec.cwd] as [string, string]]),\n ];\n for (const [field, value] of fields) if (hasControl(value)) problems.push(`the ${field} has a control character`);\n if (spec.program === \"\") problems.push(\"the program is empty\");\n if (spec.stateDir === \"\") problems.push(\"the stateDir is empty\");\n if (!runsUntilStop(spec.start) && dailyTime(spec.start.daily) === null)\n problems.push(`the daily start ${JSON.stringify(spec.start.daily)} is not a time HH:MM`);\n if (!runsUntilStop(spec.start) && spec.restart !== null) problems.push(\"a daily job has no restart: give null\");\n if (spec.background !== undefined && typeof spec.background !== \"boolean\") problems.push(\"the background is not true or false\");\n if (spec.start === \"boot\" && spec.background === false) problems.push(\"a boot start runs before a logon: give background true, or leave it out\");\n if (inBackground(spec) && spec.console === \"visible\") problems.push(\"a program in the background has no desktop: give the console hidden, or leave it out\");\n if (spec.restart !== null && !(isTime(spec.restart.after) && valueIn(spec.restart.after, \"ms\") >= 0))\n problems.push(\"the restart wait is not a time of zero or more\");\n if (spec.timeLimit !== undefined && !(isTime(spec.timeLimit) && valueIn(spec.timeLimit, \"ms\") > 0))\n problems.push(\"the time limit is not a time above zero\");\n if (spec.console !== undefined && spec.console !== \"hidden\" && spec.console !== \"visible\")\n problems.push(`the console ${JSON.stringify(spec.console)} is not \"hidden\" or \"visible\"`);\n return problems;\n};\n\n/**\n * This function quotes one argument for a command line of Windows, by the rules of `CommandLineToArgvW`.\n * It doubles each backslash before a quote and at the end. One pass keeps the time linear.\n */\nexport const windowsArg = (arg: string): string => {\n if (arg !== \"\" && !/[\\s\"]/.test(arg)) return arg;\n let quoted = '\"';\n let slashes = 0;\n for (const char of arg) {\n if (char === \"\\\\\") {\n slashes += 1;\n continue;\n }\n quoted += char === '\"' ? `${\"\\\\\".repeat(slashes * 2 + 1)}\"` : `${\"\\\\\".repeat(slashes)}${char}`;\n slashes = 0;\n }\n return `${quoted}${\"\\\\\".repeat(slashes * 2)}\"`;\n};\n\n/**\n * This function quotes one argument for the `ExecStart` line of a systemd unit. It writes `%` as\n * `%%` and `$` as `$$`, thus systemd expands no specifier and no variable. An argument with a space,\n * a quote, a backslash or a `;` goes in double quotes.\n */\nexport const systemdArg = (arg: string): string => {\n const escaped = arg.replace(/%/g, () => \"%%\").replace(/\\$/g, () => \"$$\");\n if (escaped !== \"\" && !/[\\s\"'\\\\;]/.test(escaped)) return escaped;\n return `\"${escaped.replace(/\\\\/g, () => \"\\\\\\\\\").replace(/\"/g, () => '\\\\\"')}\"`;\n};\n\n/** This function gives a time as an ISO 8601 duration of Task Scheduler in whole seconds, for example `PT90S`. */\nconst isoSeconds = (time: Quantity): string => `PT${Math.max(1, Math.ceil(valueIn(time, \"s\")))}S`;\n\n/** This function gives the interval of the repeat trigger of a task: whole minutes, 1 minute or more. */\nconst repeatMinutes = (time: Quantity): number => Math.max(1, Math.ceil(valueIn(time, \"min\")));\n\n/** This function gives the seconds of a restart wait for systemd, a whole number. */\nconst restartSeconds = (time: Quantity): number => Math.max(0, Math.ceil(valueIn(time, \"s\")));\n\nconst refuse = (spec: ServiceSpec): void => {\n const problems = serviceProblems(spec);\n if (problems.length > 0) throw new Error(`the service spec has problems: ${problems.join(\"; \")}`);\n};\n\n/**\n * This function gives the task file of Windows for a spec, as text. It is a pure function: the same\n * spec and context give the same text. Each start boundary is in the past, thus the task does not wait for a date.\n * - A start at logon gets a logon trigger, and a start at boot gets a boot trigger. With a restart, a time trigger\n * also starts the task each few minutes. The task ignores a start while its program runs (`IgnoreNew`).\n * - A daily start gets a calendar trigger at its time. A start that the computer missed occurs when it can (`StartWhenAvailable`).\n * - A spec in the background gets an S4U logon: the task runs when the user is not logged on, and Windows keeps no password.\n * Otherwise the task runs only in the session of the user (`InteractiveToken`).\n * Task Scheduler reads the file as UTF-16 with a byte order mark: give the text to `utf16le`.\n */\nexport const renderTaskXml = (spec: ServiceSpec, context: TaskContext): string => {\n refuse(spec);\n const user = xmlText(context.user);\n const hidden = (spec.console ?? \"hidden\") === \"hidden\";\n const command = hidden ? context.conhost : spec.program;\n const args = (hidden ? [\"--headless\", spec.program, ...spec.args] : [...spec.args]).map(windowsArg).join(\" \");\n const triggers: string[] = [];\n if (runsUntilStop(spec.start)) {\n triggers.push(\n spec.start === \"logon\"\n ? ` <LogonTrigger>\n <Enabled>true</Enabled>\n <UserId>${user}</UserId>\n </LogonTrigger>`\n : ` <BootTrigger>\n <Enabled>true</Enabled>\n </BootTrigger>`,\n );\n if (spec.restart !== null)\n triggers.push(` <TimeTrigger>\n <Enabled>true</Enabled>\n <StartBoundary>2000-01-01T00:00:00</StartBoundary>\n <Repetition>\n <Interval>PT${repeatMinutes(spec.restart.after)}M</Interval>\n <StopAtDurationEnd>false</StopAtDurationEnd>\n </Repetition>\n </TimeTrigger>`);\n } else {\n const time = dailyTime(spec.start.daily)!;\n triggers.push(` <CalendarTrigger>\n <Enabled>true</Enabled>\n <StartBoundary>2000-01-01T${time.hour}:${time.minute}:00</StartBoundary>\n <ScheduleByDay>\n <DaysInterval>1</DaysInterval>\n </ScheduleByDay>\n </CalendarTrigger>`);\n }\n const cwd = spec.cwd === undefined ? \"\" : `\\n <WorkingDirectory>${xmlText(spec.cwd)}</WorkingDirectory>`;\n const limit = spec.timeLimit === undefined ? \"PT0S\" : isoSeconds(spec.timeLimit);\n return `<?xml version=\"1.0\" encoding=\"UTF-16\"?>\n<Task version=\"1.4\" xmlns=\"http://schemas.microsoft.com/windows/2004/02/mit/task\">\n <RegistrationInfo>\n <Description>${xmlText(spec.description)}</Description>\n <URI>\\\\${xmlText(spec.name)}</URI>\n </RegistrationInfo>\n <Triggers>\n${triggers.join(\"\\n\")}\n </Triggers>\n <Principals>\n <Principal id=\"Author\">\n <UserId>${user}</UserId>\n <LogonType>${inBackground(spec) ? \"S4U\" : \"InteractiveToken\"}</LogonType>\n <RunLevel>LeastPrivilege</RunLevel>\n </Principal>\n </Principals>\n <Settings>\n <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>\n <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>\n <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>\n <AllowHardTerminate>true</AllowHardTerminate>\n <StartWhenAvailable>true</StartWhenAvailable>\n <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>\n <IdleSettings>\n <StopOnIdleEnd>false</StopOnIdleEnd>\n <RestartOnIdle>false</RestartOnIdle>\n </IdleSettings>\n <AllowStartOnDemand>true</AllowStartOnDemand>\n <Enabled>true</Enabled>\n <Hidden>false</Hidden>\n <RunOnlyIfIdle>false</RunOnlyIfIdle>\n <WakeToRun>false</WakeToRun>\n <ExecutionTimeLimit>${limit}</ExecutionTimeLimit>\n <Priority>5</Priority>\n </Settings>\n <Actions Context=\"Author\">\n <Exec>\n <Command>${xmlText(windowsArg(command))}</Command>\n <Arguments>${xmlText(args)}</Arguments>${cwd}\n </Exec>\n </Actions>\n</Task>\n`;\n};\n\n/** This function encodes a text as UTF-16, little-endian, with a byte order mark: the encoding that Task Scheduler reads. */\nexport const utf16le = (text: string): Uint8Array => {\n const bytes = new Uint8Array(2 + text.length * 2);\n bytes[0] = 0xff;\n bytes[1] = 0xfe;\n for (let at = 0; at < text.length; at += 1) {\n const unit = text.charCodeAt(at);\n bytes[2 + at * 2] = unit & 0xff;\n bytes[3 + at * 2] = unit >> 8;\n }\n return bytes;\n};\n\n/**\n * This function gives the systemd user unit of a spec (`<name>.service`), as text. It is a pure function.\n * - A start at logon or at boot is a service of the type `simple`, wanted by `default.target`. With a restart, it has `Restart=on-failure`.\n * The unit is the same for the two starts: the linger of the user (`installService`) starts the user manager at boot.\n * - A daily start is a service of the type `oneshot` with no `[Install]` section. Its timer (`renderSystemdTimer`) starts it.\n */\nexport const renderSystemdUnit = (spec: ServiceSpec): string => {\n refuse(spec);\n const lines = [\"[Unit]\", `Description=${spec.description.replace(/%/g, \"%%\")}`, \"\", \"[Service]\"];\n lines.push(runsUntilStop(spec.start) ? \"Type=simple\" : \"Type=oneshot\");\n lines.push(`ExecStart=${[spec.program, ...spec.args].map(systemdArg).join(\" \")}`);\n if (spec.cwd !== undefined) lines.push(`WorkingDirectory=${spec.cwd.replace(/%/g, \"%%\")}`);\n if (spec.restart !== null) lines.push(\"Restart=on-failure\", `RestartSec=${restartSeconds(spec.restart.after)}`);\n if (spec.timeLimit !== undefined) lines.push(`RuntimeMaxSec=${Math.max(1, Math.ceil(valueIn(spec.timeLimit, \"s\")))}`);\n if (runsUntilStop(spec.start)) lines.push(\"\", \"[Install]\", \"WantedBy=default.target\");\n return `${lines.join(\"\\n\")}\\n`;\n};\n\n/** This function gives the systemd timer (`<name>.timer`) of a daily spec, or null for a start at logon or at boot. It is a pure function. */\nexport const renderSystemdTimer = (spec: ServiceSpec): string | null => {\n refuse(spec);\n if (runsUntilStop(spec.start)) return null;\n const time = dailyTime(spec.start.daily)!;\n return `${[\n \"[Unit]\",\n `Description=${spec.description.replace(/%/g, \"%%\")}`,\n \"\",\n \"[Timer]\",\n `OnCalendar=*-*-* ${time.hour}:${time.minute}:00`,\n \"Persistent=true\",\n \"\",\n \"[Install]\",\n \"WantedBy=timers.target\",\n ].join(\"\\n\")}\\n`;\n};\n","import type { HostPorts, ProcessMark } from \"./ports.ts\";\n\n/**\n * This margin is the time after a recorded start in which a process can start and still be the same\n * process, in milliseconds. A start time on Linux comes in ticks of 10 ms, and a step of the wall clock moves a time.\n */\nexport const START_MARGIN_MS = 1000;\n\n/**\n * This function tells if the process of a mark is alive and is the same process. Windows and Linux\n * use a process ID again after a process stops. Thus a live process that started after the mark is a\n * different process. A start time that the system does not give proves nothing, and the process counts as the same.\n */\nexport const sameProcess = async (mark: ProcessMark, ports: HostPorts): Promise<boolean> => {\n if (!Number.isInteger(mark.pid) || mark.pid <= 0) return false;\n if (mark.pid === ports.self.pid) return Math.abs(mark.startedAt - ports.self.startedAt) <= START_MARGIN_MS;\n if (!ports.processes.alive(mark.pid)) return false;\n let started: number | null;\n try {\n started = await ports.processes.startOf(mark.pid);\n } catch {\n started = null;\n }\n return started === null || started <= mark.startedAt + START_MARGIN_MS;\n};\n\n/**\n * A tree stop outcome tells what a tree stop did.\n * - `stopped`: the stop went to the process and to each process under it.\n * - `absent`: no process with the ID was alive.\n * - `failed`: the process is alive and the stop did not go. The problem tells why.\n */\nexport type TreeStopOutcome =\n | { readonly kind: \"stopped\" }\n | { readonly kind: \"absent\" }\n | { readonly kind: \"failed\"; readonly problem: string };\n\n/**\n * This function stops a process and each process under it, by its ID only. It does not find a process by\n * its name or its command line. On Windows, it starts `taskkill /T /F /PID <pid>`. On Linux, it sends\n * SIGKILL to the process group of the ID, or to the process when it leads no group. It does not throw.\n */\nexport const stopTree = async (pid: number, ports: HostPorts): Promise<TreeStopOutcome> => {\n if (!Number.isInteger(pid) || pid <= 0) return { kind: \"failed\", problem: `${pid} is not a process ID` };\n if (pid === ports.self.pid) return { kind: \"failed\", problem: \"the host does not stop its own process\" };\n if (!ports.processes.alive(pid)) return { kind: \"absent\" };\n if (ports.platform === \"win32\") {\n const result = await ports.commands\n .run(\"taskkill\", [\"/T\", \"/F\", \"/PID\", String(pid)])\n .catch((error: unknown) => ({ code: 127, out: error instanceof Error ? error.message : String(error) }));\n if (result.code === 0 || !ports.processes.alive(pid)) return { kind: \"stopped\" };\n return { kind: \"failed\", problem: `taskkill gave the code ${result.code}: ${result.out}` };\n }\n if (ports.processes.signalGroup(pid, \"SIGKILL\") || ports.processes.signal(pid, \"SIGKILL\")) return { kind: \"stopped\" };\n return ports.processes.alive(pid) ? { kind: \"failed\", problem: `the signal SIGKILL did not go to the process ${pid}` } : { kind: \"absent\" };\n};\n","import { delay } from \"@mark1russell7/algebra/clock\";\nimport type { HostPorts, ProcessMark } from \"./ports.ts\";\nimport { sameProcess } from \"./processes.ts\";\n\n/**\n * A lock owner is the record in a lock file: the process that holds the lock. The record can also\n * have the child process that it holds the lock for. The lock is held while one of the two is alive.\n */\nexport interface LockOwner extends ProcessMark {\n readonly child?: ProcessMark | undefined;\n}\n\n/** An instance lock is a lock that this process holds. */\nexport interface InstanceLock {\n readonly path: string;\n readonly owner: LockOwner;\n /** This method writes a new child process in the record, or no child with null. */\n update(child: ProcessMark | null): Promise<void>;\n /** This method removes the lock file, when it still has the record of this lock. A second use does nothing. */\n release(): Promise<void>;\n}\n\n/**\n * A lock result tells what a try to take the lock found.\n * - `acquired`: this process holds the lock. `recovered` tells why a stale lock went first, or it is null.\n * - `held`: a live process holds the lock. Its owner is in the result.\n * - `failed`: the lock did not come free, or the file system failed. The problem tells why.\n */\nexport type LockResult =\n | { readonly kind: \"acquired\"; readonly lock: InstanceLock; readonly recovered: string | null }\n | { readonly kind: \"held\"; readonly owner: LockOwner }\n | { readonly kind: \"failed\"; readonly problem: string };\n\n/**\n * A lock state is what an examination of a lock file found. An examination does not throw.\n * - `free`: no file.\n * - `held`: the record names a live process.\n * - `stale`: the record names processes that stopped. The next take removes the file.\n * - `malformed`: the file is not a record, or the read failed.\n */\nexport type LockState =\n | { readonly kind: \"free\" }\n | { readonly kind: \"held\"; readonly owner: LockOwner }\n | { readonly kind: \"stale\"; readonly owner: LockOwner; readonly why: string }\n | { readonly kind: \"malformed\"; readonly problem: string };\n\n/** These options go with a take of the lock. */\nexport interface LockOptions {\n /** This count is the number of reads of a malformed file before the take removes it. The default is 3. */\n readonly tries?: number | undefined;\n /** This time is the pause between two reads of a malformed file, in milliseconds. The default is 100. */\n readonly pause?: number | undefined;\n /** This child process goes in the record at the take. */\n readonly child?: ProcessMark | undefined;\n}\n\nconst isMark = (value: unknown): value is ProcessMark => {\n if (typeof value !== \"object\" || value === null) return false;\n const { pid, startedAt } = value as { pid?: unknown; startedAt?: unknown };\n return typeof pid === \"number\" && Number.isInteger(pid) && pid > 0 && typeof startedAt === \"number\" && Number.isFinite(startedAt);\n};\n\n/** This function reads a lock owner from the text of a lock file, or gives null for a text that is not a record. */\nexport const parseLockOwner = (text: string): LockOwner | null => {\n try {\n const value = JSON.parse(text) as unknown;\n if (!isMark(value)) return null;\n const child = (value as { child?: unknown }).child;\n if (child !== undefined && child !== null && !isMark(child)) return null;\n return { pid: value.pid, startedAt: value.startedAt, ...(isMark(child) ? { child: { pid: child.pid, startedAt: child.startedAt } } : {}) };\n } catch {\n return null;\n }\n};\n\n/** This function gives the text of a lock file for an owner. */\nexport const lockText = (owner: LockOwner): string => `${JSON.stringify(owner)}\\n`;\n\n/** This function tells if the owner of a lock is alive: its process, or its child. */\nconst ownerAlive = async (owner: LockOwner, ports: HostPorts): Promise<boolean> =>\n (await sameProcess(owner, ports)) || (owner.child !== undefined && (await sameProcess(owner.child, ports)));\n\n/**\n * This function removes a file only when it has this text: a lock file or a discovery file. The\n * removal holds the removal lock `<path>.rm` for its read and its delete. Thus two processes that find\n * the same stale file do not remove each other's new file. A removal lock whose owner stopped goes first.\n */\nexport const removeIfSame = async (path: string, text: string, ports: HostPorts): Promise<boolean> => {\n const removal = `${path}.rm`;\n const mine = lockText({ pid: ports.self.pid, startedAt: ports.self.startedAt });\n if (!(await ports.files.create(removal, mine))) {\n const other = parseLockOwner((await ports.files.read(removal)) ?? \"\");\n if (other !== null && (await ownerAlive(other, ports))) return false;\n await ports.files.remove(removal);\n if (!(await ports.files.create(removal, mine))) return false;\n }\n try {\n if ((await ports.files.read(path)) !== text) return false;\n await ports.files.remove(path);\n return true;\n } finally {\n if ((await ports.files.read(removal)) === mine) await ports.files.remove(removal);\n }\n};\n\n/** This function examines a lock file. It does not throw. */\nexport const inspectInstanceLock = async (path: string, ports: HostPorts): Promise<LockState> => {\n try {\n const text = await ports.files.read(path);\n if (text === null) return { kind: \"free\" };\n const owner = parseLockOwner(text);\n if (owner === null) return { kind: \"malformed\", problem: \"the lock file is not a lock record\" };\n if (await ownerAlive(owner, ports)) return { kind: \"held\", owner };\n return { kind: \"stale\", owner, why: `the owner process ${owner.pid} stopped` };\n } catch (error) {\n return { kind: \"malformed\", problem: `the read failed: ${error instanceof Error ? error.message : String(error)}` };\n }\n};\n\n/**\n * This function takes the lock of one instance: a lock file with the record of this process. Thus a\n * second instance does not start. It does not throw.\n * - A file whose owner and child stopped is stale: it goes, and the take tries again.\n * - A malformed file can be the file of a take that writes at this time. The take reads it again after\n * a pause, and after `tries` reads, it removes it.\n * - A file whose owner or child is alive gives `held`.\n */\nexport const acquireInstanceLock = async (path: string, ports: HostPorts, options: LockOptions = {}): Promise<LockResult> => {\n const tries = options.tries ?? 3;\n const pause = options.pause ?? 100;\n const owner: LockOwner = { pid: ports.self.pid, startedAt: ports.self.startedAt, ...(options.child === undefined ? {} : { child: options.child }) };\n let recovered: string | null = null;\n let malformed = 0;\n try {\n for (let attempt = 0; attempt < tries + 3; attempt += 1) {\n const text = lockText(owner);\n if (await ports.files.create(path, text)) {\n ports.logger?.log(\"info\", `the host took the lock ${path}`, { path, pid: owner.pid, ...(recovered === null ? {} : { recovered }) });\n return { kind: \"acquired\", lock: held(path, owner, text, ports), recovered };\n }\n const found = await ports.files.read(path);\n if (found === null) continue;\n const other = parseLockOwner(found);\n if (other === null) {\n malformed += 1;\n if (malformed < tries) {\n await delay(ports.clock, pause);\n continue;\n }\n if (await removeIfSame(path, found, ports)) recovered = \"the lock file was not a lock record\";\n continue;\n }\n if (await ownerAlive(other, ports)) return { kind: \"held\", owner: other };\n if (await removeIfSame(path, found, ports)) {\n recovered = `the owner process ${other.pid} stopped`;\n ports.logger?.log(\"warn\", `the host removed the stale lock ${path}: ${recovered}`, { path, owner: other });\n }\n }\n return { kind: \"failed\", problem: `the lock ${path} did not come free after ${tries + 3} tries` };\n } catch (error) {\n return { kind: \"failed\", problem: `the file system failed: ${error instanceof Error ? error.message : String(error)}` };\n }\n};\n\n/** This function gives the handle of a lock that this process holds. */\nconst held = (path: string, first: LockOwner, firstText: string, ports: HostPorts): InstanceLock => {\n let owner = first;\n let text = firstText;\n let released = false;\n // the updates and the release occur in sequence, thus a late write does not make the file again after the release\n let queue: Promise<void> = Promise.resolve();\n const enqueue = (work: () => Promise<void>): Promise<void> => {\n const next = queue.then(work);\n queue = next.catch(() => {});\n return next;\n };\n return {\n path,\n get owner() {\n return owner;\n },\n update: (child) =>\n enqueue(async () => {\n if (released) return;\n const next: LockOwner = { pid: owner.pid, startedAt: owner.startedAt, ...(child === null ? {} : { child }) };\n const nextText = lockText(next);\n await ports.files.write(path, nextText);\n owner = next;\n text = nextText;\n }),\n release: () =>\n enqueue(async () => {\n if (released) return;\n released = true;\n try {\n await removeIfSame(path, text, ports);\n } catch {\n // a lock file that stays is stale after the exit of this process\n }\n }),\n };\n};\n","import type { HostPorts } from \"./ports.ts\";\nimport { removeIfSame } from \"./lock.ts\";\nimport { sameProcess } from \"./processes.ts\";\n\n/**\n * A discovery record tells where a running instance listens. The instance writes it after its start,\n * and a client reads it to find the instance. The file is JSON, one record.\n */\nexport interface Discovery {\n /** This number is the process ID of the instance. */\n readonly pid: number;\n /** This text is the start time of the process, as an ISO 8601 time. */\n readonly startedAt: string;\n /** This number is the port that the instance listens on, or null. */\n readonly port: number | null;\n /** This text is the address of the instance, for example `http://127.0.0.1:8080/`, or null. */\n readonly url: string | null;\n /** These fields are more data of the instance, for example its version. */\n readonly extra?: Readonly<Record<string, unknown>> | undefined;\n}\n\n/**\n * A discovery read is what a read of the discovery file found. A read does not throw.\n * - `running`: the file names a live process, and its start time does not prove that it is a different process.\n * - `absent`: no file.\n * - `stale`: the file names a process that stopped, or a new process with the same ID.\n * - `malformed`: the file is not a discovery record, or the read failed. The problem tells why.\n */\nexport type DiscoveryRead =\n | { readonly kind: \"running\"; readonly record: Discovery }\n | { readonly kind: \"absent\" }\n | { readonly kind: \"stale\"; readonly record: Discovery; readonly why: string }\n | { readonly kind: \"malformed\"; readonly problem: string };\n\n/** These options go with a read of the discovery file. */\nexport interface ReadDiscoveryOptions {\n /** True removes a stale or malformed file. The default is false. */\n readonly clean?: boolean | undefined;\n}\n\nconst isPort = (value: unknown): value is number => typeof value === \"number\" && Number.isInteger(value) && value >= 1 && value <= 65_535;\n\n/** This function reads a discovery record from a text. It gives the record, or the problem as a text. */\nexport const parseDiscovery = (text: string): Discovery | string => {\n let value: unknown;\n try {\n value = JSON.parse(text);\n } catch (error) {\n return `the file is not JSON: ${error instanceof Error ? error.message : String(error)}`;\n }\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return \"the file is not a JSON object\";\n const record = value as Readonly<Record<string, unknown>>;\n const { pid, startedAt, port, url, extra } = record;\n if (typeof pid !== \"number\" || !Number.isInteger(pid) || pid <= 0) return \"the field pid is not a process ID\";\n if (typeof startedAt !== \"string\" || !Number.isFinite(Date.parse(startedAt))) return \"the field startedAt is not an ISO time\";\n if (port !== null && port !== undefined && !isPort(port)) return \"the field port is not a port from 1 to 65535\";\n if (url !== null && url !== undefined && typeof url !== \"string\") return \"the field url is not a text\";\n if (extra !== undefined && (typeof extra !== \"object\" || extra === null || Array.isArray(extra))) return \"the field extra is not an object\";\n return {\n pid,\n startedAt,\n port: isPort(port) ? port : null,\n url: typeof url === \"string\" ? url : null,\n ...(extra === undefined ? {} : { extra: extra as Readonly<Record<string, unknown>> }),\n };\n};\n\n/** These fields describe where this process listens. */\nexport interface DiscoveryFields {\n readonly port?: number | null | undefined;\n readonly url?: string | null | undefined;\n readonly extra?: Readonly<Record<string, unknown>> | undefined;\n}\n\n/** This function gives the discovery record of the process of the host, with its start time. */\nexport const discoveryOf = (fields: DiscoveryFields, ports: HostPorts): Discovery => ({\n pid: ports.self.pid,\n startedAt: new Date(ports.self.startedAt).toISOString(),\n port: fields.port ?? null,\n url: fields.url ?? null,\n ...(fields.extra === undefined ? {} : { extra: fields.extra }),\n});\n\n/** This function writes a discovery file. The write replaces the file in one step, thus a reader sees the old record or the new one. */\nexport const writeDiscovery = async (path: string, record: Discovery, ports: HostPorts): Promise<void> => {\n await ports.files.write(path, `${JSON.stringify(record, null, 2)}\\n`);\n};\n\n/**\n * This function reads a discovery file and examines its process. It does not throw: a file that is not\n * a record, or a failed read, gives `malformed`. With `clean`, it removes a stale or malformed file.\n */\nexport const readDiscovery = async (path: string, ports: HostPorts, options: ReadDiscoveryOptions = {}): Promise<DiscoveryRead> => {\n const { found, text } = await examine(path, ports);\n // The clean removes only the text that it examined: a new instance can write its file after the read.\n if (options.clean === true && text !== null && (found.kind === \"stale\" || found.kind === \"malformed\")) {\n try {\n if (await removeIfSame(path, text, ports)) ports.logger?.log(\"info\", `the host removed the ${found.kind} discovery file ${path}`, { path, kind: found.kind });\n } catch {\n // the next read examines the file again\n }\n }\n return found;\n};\n\nconst examine = async (path: string, ports: HostPorts): Promise<{ readonly found: DiscoveryRead; readonly text: string | null }> => {\n let text: string | null;\n try {\n text = await ports.files.read(path);\n } catch (error) {\n return { found: { kind: \"malformed\", problem: `the read failed: ${error instanceof Error ? error.message : String(error)}` }, text: null };\n }\n if (text === null) return { found: { kind: \"absent\" }, text };\n const record = parseDiscovery(text);\n if (typeof record === \"string\") return { found: { kind: \"malformed\", problem: record }, text };\n const mark = { pid: record.pid, startedAt: Date.parse(record.startedAt) };\n if (await sameProcess(mark, ports)) return { found: { kind: \"running\", record }, text };\n const why = ports.processes.alive(record.pid)\n ? `the process ${record.pid} started after the record, thus it is a different process`\n : `the process ${record.pid} stopped`;\n return { found: { kind: \"stale\", record, why }, text };\n};\n\n/** This function removes a discovery file when it names the process `pid`, by default the process of the host. It tells if it removed the file. */\nexport const removeDiscovery = async (path: string, ports: HostPorts, pid: number = ports.self.pid): Promise<boolean> => {\n try {\n const text = await ports.files.read(path);\n if (text === null) return false;\n const record = parseDiscovery(text);\n if (typeof record === \"string\" || record.pid !== pid) return false;\n return await removeIfSame(path, text, ports);\n } catch {\n return false;\n }\n};\n","import type { DiscoveryRead } from \"./discovery.ts\";\nimport { readDiscovery } from \"./discovery.ts\";\nimport type { HostPorts } from \"./ports.ts\";\nimport { joinPath } from \"./ports.ts\";\nimport { stopTree } from \"./processes.ts\";\nimport type { ServiceSpec } from \"./render.ts\";\nimport { inBackground, renderSystemdTimer, renderSystemdUnit, renderTaskXml, runsUntilStop, serviceProblems, utf16le } from \"./render.ts\";\n\n/** A command record is one command that a service operation started, and its result. */\nexport interface CommandRecord {\n readonly file: string;\n readonly args: readonly string[];\n readonly code: number;\n readonly out: string;\n}\n\n/**\n * A service outcome tells what a service operation did. An operation does not throw.\n * - `done`: each command gave 0. `commands` and `files` tell what the operation did.\n * - `failed`: a command gave a code that is not 0, or the file system failed. The problem tells which.\n * - `refused`: the spec has problems, and the operation did nothing.\n * - `unsupported`: the platform is not Windows or Linux, and the operation did nothing.\n */\nexport type ServiceOutcome =\n | { readonly kind: \"done\"; readonly commands: readonly CommandRecord[]; readonly files: readonly string[] }\n | { readonly kind: \"failed\"; readonly commands: readonly CommandRecord[]; readonly problem: string }\n | { readonly kind: \"refused\"; readonly problems: readonly string[] }\n | { readonly kind: \"unsupported\"; readonly platform: string };\n\n/** A service status tells if the system has the service, its state, and the instance of the discovery file. */\nexport interface ServiceStatus {\n /** This flag tells if the system has the task or the unit. */\n readonly installed: boolean;\n /**\n * This text is the state that the system gives, for example `Running` or `Ready` from `schtasks`, or\n * `active` or `inactive` from `systemctl`. It is `unknown` when the system gives no state.\n */\n readonly state: string;\n /** This is the read of the discovery file, or null without a discovery path. */\n readonly instance: DiscoveryRead | null;\n /** These are the commands that the status started. */\n readonly commands: readonly CommandRecord[];\n}\n\n/** These options go with an install. */\nexport interface InstallOptions {\n /** True starts the service after the install. The default is true. */\n readonly start?: boolean | undefined;\n}\n\n/** These options go with an operation that stops the instance: the discovery file that names it. */\nexport interface InstanceOptions {\n /** This path is the discovery file of the instance. With it, the operation stops the process tree of a live instance. */\n readonly discovery?: string | undefined;\n}\n\n/** These are the files of a service on this platform. */\nexport interface ServicePaths {\n /** This path is the task file on Windows, or the unit on Linux. */\n readonly unit: string;\n /** This path is the timer of a daily job on Linux, or null. */\n readonly timer: string | null;\n}\n\n/** This function gives the folder of the systemd user units: `$XDG_CONFIG_HOME/systemd/user`, or `~/.config/systemd/user`. */\nconst unitDir = (ports: HostPorts): string => {\n const config = ports.env[\"XDG_CONFIG_HOME\"];\n return joinPath(\"linux\", config === undefined || config === \"\" ? joinPath(\"linux\", ports.homeDir, \".config\") : config, \"systemd\", \"user\");\n};\n\n/** This function gives the files of a service on the platform of the ports. */\nexport const servicePaths = (spec: ServiceSpec, ports: HostPorts): ServicePaths => {\n if (ports.platform === \"win32\") return { unit: joinPath(\"win32\", spec.stateDir, `${spec.name}.task.xml`), timer: null };\n const dir = unitDir(ports);\n return { unit: joinPath(\"linux\", dir, `${spec.name}.service`), timer: runsUntilStop(spec.start) ? null : joinPath(\"linux\", dir, `${spec.name}.timer`) };\n};\n\n/** This function gives the unit that `systemctl` enables: the timer of a daily job, or the service. */\nconst enabledUnit = (spec: ServiceSpec): string => (runsUntilStop(spec.start) ? `${spec.name}.service` : `${spec.name}.timer`);\n\n/**\n * This text goes with a failure of `schtasks` for a spec in the background. Task Scheduler refuses a boot trigger\n * and an S4U logon from a shell that is not elevated: `Access is denied`, with the code 1 (Windows 11, 2026-11).\n */\nconst ELEVATION =\n \"Task Scheduler refuses a boot trigger and an S4U logon from a shell that is not elevated: start the same operation in a shell of an administrator\";\n\n/** This function gives the path of `conhost.exe` from `SystemRoot`. Without it, Task Scheduler expands `%SystemRoot%` at the start. */\nconst conhostPath = (ports: HostPorts): string => joinPath(\"win32\", ports.env[\"SystemRoot\"] ?? \"%SystemRoot%\", \"System32\", \"conhost.exe\");\n\n/** A runner starts commands, and keeps a record of each. */\ninterface Runner {\n readonly commands: CommandRecord[];\n run(file: string, args: readonly string[]): Promise<CommandRecord>;\n}\n\nconst runner = (ports: HostPorts): Runner => {\n const commands: CommandRecord[] = [];\n return {\n commands,\n async run(file, args) {\n let record: CommandRecord;\n try {\n const result = await ports.commands.run(file, args);\n record = { file, args, code: result.code, out: result.out.trim() };\n } catch (error) {\n record = { file, args, code: 127, out: error instanceof Error ? error.message : String(error) };\n }\n commands.push(record);\n ports.logger?.log(record.code === 0 ? \"debug\" : \"warn\", `${file} ${args.join(\" \")} gave the code ${record.code}`, { ...record });\n return record;\n },\n };\n};\n\nconst failed = (commands: readonly CommandRecord[], record: CommandRecord, note: string | null): ServiceOutcome => ({\n kind: \"failed\",\n commands,\n problem: `${record.file} ${record.args.join(\" \")} gave the code ${record.code}${record.out === \"\" ? \"\" : `: ${record.out}`}${note === null ? \"\" : ` (${note})`}`,\n});\n\n/** This function gives the note of a failed command: the elevation of Task Scheduler for a spec in the background, or null. */\nconst noteOf = (spec: ServiceSpec, ports: HostPorts, record: CommandRecord): string | null =>\n ports.platform === \"win32\" && record.file === \"schtasks\" && inBackground(spec) ? ELEVATION : null;\n\nconst problemOf = (error: unknown): string => (error instanceof Error ? error.message : String(error));\n\n/**\n * This function runs the steps of an operation. It refuses a spec with problems and a platform that\n * is not Windows or Linux, and it catches each failure of the file system.\n */\nconst operate = async (\n spec: ServiceSpec,\n ports: HostPorts,\n steps: (run: Runner, files: string[]) => Promise<CommandRecord | null>,\n): Promise<ServiceOutcome> => {\n const problems = serviceProblems(spec);\n if (problems.length > 0) return { kind: \"refused\", problems };\n if (ports.platform !== \"win32\" && ports.platform !== \"linux\") return { kind: \"unsupported\", platform: ports.platform };\n const run = runner(ports);\n const files: string[] = [];\n try {\n const failure = await steps(run, files);\n if (failure !== null) return failed(run.commands, failure, noteOf(spec, ports, failure));\n } catch (error) {\n return { kind: \"failed\", commands: run.commands, problem: `the file system failed: ${problemOf(error)}` };\n }\n return { kind: \"done\", commands: run.commands, files };\n};\n\n/** This function gives the first record whose code is not 0, or null. */\nconst firstFailure = (...records: readonly CommandRecord[]): CommandRecord | null => records.find((record) => record.code !== 0) ?? null;\n\n/**\n * This function installs a service of the user, and by default starts it. It does not throw.\n * - On Windows, it writes the task file in UTF-16 to `stateDir`, and starts `schtasks /Create /XML <file> /F`, then `schtasks /Run`.\n * - On Linux, it writes the unit (and the timer of a daily job), then starts `systemctl --user daemon-reload` and `enable`.\n * For a spec in the background, it first starts `loginctl enable-linger` for the user.\n * A second install replaces the first. Give it the ports of a test, thus no test installs a real task.\n * On Windows, Task Scheduler refuses a spec in the background from a shell that is not elevated: the problem then tells so.\n */\nexport const installService = (spec: ServiceSpec, ports: HostPorts, options: InstallOptions = {}): Promise<ServiceOutcome> =>\n operate(spec, ports, async (run, files) => {\n const start = options.start ?? true;\n const paths = servicePaths(spec, ports);\n if (ports.platform === \"win32\") {\n await ports.files.write(paths.unit, utf16le(renderTaskXml(spec, { user: ports.user(), conhost: conhostPath(ports) })));\n files.push(paths.unit);\n const created = await run.run(\"schtasks\", [\"/Create\", \"/TN\", spec.name, \"/XML\", paths.unit, \"/F\"]);\n if (created.code !== 0 || !start) return firstFailure(created);\n return firstFailure(await run.run(\"schtasks\", [\"/Run\", \"/TN\", spec.name]));\n }\n await ports.files.write(paths.unit, renderSystemdUnit(spec));\n files.push(paths.unit);\n const timer = renderSystemdTimer(spec);\n if (paths.timer !== null && timer !== null) {\n await ports.files.write(paths.timer, timer);\n files.push(paths.timer);\n }\n if (inBackground(spec)) {\n // the linger starts the user manager at boot and keeps it after the logout. The removal keeps the linger, because other units can need it\n const lingered = await run.run(\"loginctl\", [\"enable-linger\"]);\n if (lingered.code !== 0) return lingered;\n }\n const reloaded = await run.run(\"systemctl\", [\"--user\", \"daemon-reload\"]);\n if (reloaded.code !== 0) return reloaded;\n return firstFailure(await run.run(\"systemctl\", [\"--user\", \"enable\", ...(start ? [\"--now\"] : []), enabledUnit(spec)]));\n });\n\n/** This function stops the instance of a discovery file, when it is alive and is the same process. */\nconst stopInstance = async (ports: HostPorts, options: InstanceOptions): Promise<void> => {\n if (options.discovery === undefined) return;\n const found = await readDiscovery(options.discovery, ports, { clean: true });\n if (found.kind !== \"running\") return;\n const stopped = await stopTree(found.record.pid, ports);\n ports.logger?.log(stopped.kind === \"failed\" ? \"warn\" : \"info\", `the host stopped the instance ${found.record.pid}: ${stopped.kind}`, {\n pid: found.record.pid,\n outcome: stopped.kind,\n });\n};\n\n/**\n * This function removes a service. It does not throw. On Windows, it ends the task and deletes it. On\n * Linux, it disables and stops the unit, removes its files and reloads systemd. With a discovery file,\n * it then stops the process tree of an instance that stays.\n */\nexport const uninstallService = (spec: ServiceSpec, ports: HostPorts, options: InstanceOptions = {}): Promise<ServiceOutcome> =>\n operate(spec, ports, async (run, files) => {\n const paths = servicePaths(spec, ports);\n let failure: CommandRecord | null;\n if (ports.platform === \"win32\") {\n // the end of a task that does not run gives a code that is not 0: it is not a failure of the removal\n await run.run(\"schtasks\", [\"/End\", \"/TN\", spec.name]);\n failure = firstFailure(await run.run(\"schtasks\", [\"/Delete\", \"/TN\", spec.name, \"/F\"]));\n await ports.files.remove(paths.unit);\n } else {\n failure = firstFailure(await run.run(\"systemctl\", [\"--user\", \"disable\", \"--now\", enabledUnit(spec)]));\n if (paths.timer !== null) await run.run(\"systemctl\", [\"--user\", \"stop\", `${spec.name}.service`]);\n await ports.files.remove(paths.unit);\n if (paths.timer !== null) await ports.files.remove(paths.timer);\n await run.run(\"systemctl\", [\"--user\", \"daemon-reload\"]);\n }\n files.push(paths.unit, ...(paths.timer === null ? [] : [paths.timer]));\n await stopInstance(ports, options);\n return failure;\n });\n\n/** This function enables a service and starts it. It does not throw. On Windows, it enables the task and runs it. */\nexport const startService = (spec: ServiceSpec, ports: HostPorts): Promise<ServiceOutcome> =>\n operate(spec, ports, async (run) => {\n if (ports.platform === \"win32\") {\n const enabled = await run.run(\"schtasks\", [\"/Change\", \"/TN\", spec.name, \"/ENABLE\"]);\n if (enabled.code !== 0) return enabled;\n return firstFailure(await run.run(\"schtasks\", [\"/Run\", \"/TN\", spec.name]));\n }\n // stopService disables the unit or its timer, thus the start enables it again\n return firstFailure(await run.run(\"systemctl\", [\"--user\", \"enable\", \"--now\", enabledUnit(spec)]));\n });\n\n/**\n * This function stops a service, and keeps it stopped until `startService`. It does not throw.\n * - On Windows, it disables the task, thus its time trigger does not start it again, and ends the task.\n * With a discovery file, it then stops the process tree of the instance. Windows has no signal that a child can catch.\n * - On Linux, it disables the unit of a service at logon or at boot, or the timer of a daily job, and stops it.\n * Thus the next login, the next boot or the next calendar time does not start it again. The stop sends SIGTERM,\n * thus `run()` stops in its stages. A daily job that operates stops too.\n */\nexport const stopService = (spec: ServiceSpec, ports: HostPorts, options: InstanceOptions = {}): Promise<ServiceOutcome> =>\n operate(spec, ports, async (run) => {\n if (ports.platform === \"win32\") {\n const disabled = await run.run(\"schtasks\", [\"/Change\", \"/TN\", spec.name, \"/DISABLE\"]);\n if (disabled.code !== 0) return disabled;\n await run.run(\"schtasks\", [\"/End\", \"/TN\", spec.name]);\n await stopInstance(ports, options);\n return null;\n }\n const disabled = await run.run(\"systemctl\", [\"--user\", \"disable\", \"--now\", enabledUnit(spec)]);\n if (disabled.code !== 0 || runsUntilStop(spec.start)) return firstFailure(disabled);\n return firstFailure(await run.run(\"systemctl\", [\"--user\", \"stop\", `${spec.name}.service`]));\n });\n\n/** This function gives the value of a line `Key: value` of the list of `schtasks /Query /FO LIST`. */\nconst listValue = (out: string, key: string): string | null => {\n for (const line of out.split(/\\r?\\n/)) {\n const at = line.indexOf(\":\");\n if (at > 0 && line.slice(0, at).trim() === key) return line.slice(at + 1).trim();\n }\n return null;\n};\n\n/**\n * This function gives the status of a service. It does not throw. A service that the system does not\n * have gives `installed: false`. A malformed or stale discovery file gives its read, and not a throw.\n */\nexport const serviceStatus = async (spec: ServiceSpec, ports: HostPorts, options: InstanceOptions = {}): Promise<ServiceStatus> => {\n const run = runner(ports);\n const instance = options.discovery === undefined ? null : await readDiscovery(options.discovery, ports);\n if (serviceProblems(spec).length > 0 || (ports.platform !== \"win32\" && ports.platform !== \"linux\"))\n return { installed: false, state: \"unknown\", instance, commands: run.commands };\n if (ports.platform === \"win32\") {\n const query = await run.run(\"schtasks\", [\"/Query\", \"/TN\", spec.name, \"/V\", \"/FO\", \"LIST\"]);\n if (query.code !== 0) return { installed: false, state: \"unknown\", instance, commands: run.commands };\n return { installed: true, state: listValue(query.out, \"Status\") ?? \"unknown\", instance, commands: run.commands };\n }\n let installed: boolean;\n try {\n installed = (await ports.files.read(servicePaths(spec, ports).unit)) !== null;\n } catch {\n installed = false;\n }\n const active = await run.run(\"systemctl\", [\"--user\", \"is-active\", `${spec.name}.service`]);\n const state = active.out.split(/\\r?\\n/)[0]?.trim() ?? \"\";\n return { installed, state: state === \"\" ? \"unknown\" : state, instance, commands: run.commands };\n};\n","import type { Quantity } from \"@mark1russell7/quantity\";\nimport { convertible, formatDuration, isQuantity, valueIn } from \"@mark1russell7/quantity\";\nimport type { HostPorts } from \"./ports.ts\";\n\n/**\n * A freshness bound reads one time in the JSON answer of an http probe. The time is epoch\n * milliseconds or an ISO 8601 text. The probe fails when the time is older than `within`, or when\n * the answer does not have it.\n */\nexport interface FreshnessBound {\n /** This JSON Pointer (RFC 6901) names the time in the answer, for example `/delivery/lastTestSendAt`. */\n readonly pointer: string;\n /** This time is the largest age that passes. */\n readonly within: Quantity;\n}\n\n/**\n * A ready probe tells when a program is ready.\n * - `http`: a GET request to the address gives the status, 200 by default. With `fresh`, the answer\n * is also JSON, and each bound of `fresh` passes. The age of a time is measured from `now`: a\n * JSON Pointer to the time of the target in the answer. Without `now`, the wall clock of the host\n * gives the time.\n * - `tcp`: a TCP connection to the port opens. The default host is `127.0.0.1`.\n * - `command`: a command gives the exit code 0.\n */\nexport type ReadyProbe =\n | {\n readonly kind: \"http\";\n readonly url: string;\n readonly status?: number | undefined;\n readonly fresh?: readonly FreshnessBound[] | undefined;\n readonly now?: string | undefined;\n }\n | { readonly kind: \"tcp\"; readonly port: number; readonly host?: string | undefined }\n | { readonly kind: \"command\"; readonly program: string; readonly args: readonly string[]; readonly cwd?: string | undefined };\n\n/** A probe result is the result of one use of a probe. A failure tells why. */\nexport type ProbeResult = { readonly ok: true } | { readonly ok: false; readonly why: string };\n\n/** This size is the largest answer that a probe with freshness bounds reads: 1 MiB. */\nexport const PROBE_BODY_LIMIT = 1_048_576;\n\nconst isPointer = (pointer: unknown): pointer is string =>\n typeof pointer === \"string\" && (pointer === \"\" || (pointer.startsWith(\"/\") && !/~[^01]|~$/.test(pointer)));\n\n/** This function gives the problems of a probe: each value that a probe cannot use. */\nexport const probeProblems = (probe: ReadyProbe): string[] => {\n if (probe.kind === \"http\") {\n const problems: string[] = [];\n if (!/^https?:\\/\\//.test(probe.url)) problems.push(`the address ${JSON.stringify(probe.url)} is not an http or https address`);\n if (probe.status !== undefined && !(Number.isInteger(probe.status) && probe.status >= 100 && probe.status <= 599))\n problems.push(`the status ${probe.status} is not an HTTP status`);\n if (probe.now !== undefined && !isPointer(probe.now)) problems.push(`the now ${JSON.stringify(probe.now)} is not a JSON Pointer`);\n if (probe.now !== undefined && probe.fresh === undefined) problems.push(\"the probe has a now, but no fresh list\");\n if (probe.fresh !== undefined && probe.fresh.length === 0) problems.push(\"the fresh list is empty\");\n for (const bound of probe.fresh ?? []) {\n if (!isPointer(bound.pointer)) problems.push(`the freshness pointer ${JSON.stringify(bound.pointer)} is not a JSON Pointer`);\n if (!(isQuantity(bound.within) && convertible(bound.within.unit, \"ms\") && valueIn(bound.within, \"ms\") >= 0))\n problems.push(`the freshness bound of ${JSON.stringify(bound.pointer)} is not a time of zero or more`);\n }\n return problems;\n }\n if (probe.kind === \"tcp\")\n return Number.isInteger(probe.port) && probe.port >= 1 && probe.port <= 65_535 ? [] : [`the port ${probe.port} is not a port from 1 to 65535`];\n if (probe.kind === \"command\") return probe.program === \"\" ? [\"the program of the command probe is empty\"] : [];\n return [`the probe kind ${JSON.stringify((probe as { kind: unknown }).kind)} is not http, tcp or command`];\n};\n\n/** This function gives the value at a JSON Pointer (RFC 6901), or undefined when the document does not have it. */\nconst pointAt = (document: unknown, pointer: string): unknown => {\n if (pointer === \"\") return document;\n let at = document;\n for (const token of pointer.slice(1).split(\"/\")) {\n const key = token.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\");\n if (Array.isArray(at)) {\n if (!/^(0|[1-9]\\d*)$/.test(key) || Number(key) >= at.length) return undefined;\n at = at[Number(key)];\n } else if (at !== null && typeof at === \"object\" && Object.hasOwn(at, key)) {\n at = (at as Record<string, unknown>)[key];\n } else return undefined;\n }\n return at;\n};\n\n/** This function gives the time of a value in epoch milliseconds: a finite number, or an ISO 8601 text. */\nconst timeOf = (value: unknown): number | null => {\n if (typeof value === \"number\") return Number.isFinite(value) ? value : null;\n if (typeof value === \"string\") {\n const time = Date.parse(value);\n return Number.isNaN(time) ? null : time;\n }\n return null;\n};\n\n/** This function examines the JSON answer of an http probe against its freshness bounds. */\nconst freshness = (url: string, body: string, bounds: readonly FreshnessBound[], nowPointer: string | undefined, wall: number): ProbeResult => {\n let document: unknown;\n try {\n document = JSON.parse(body);\n } catch {\n return { ok: false, why: `${url} did not give JSON` };\n }\n const now = nowPointer === undefined ? wall : timeOf(pointAt(document, nowPointer));\n if (now === null) return { ok: false, why: `${url} has no time at ${nowPointer}` };\n const stale: string[] = [];\n for (const bound of bounds) {\n const time = timeOf(pointAt(document, bound.pointer));\n if (time === null) {\n stale.push(`${bound.pointer} has no time`);\n continue;\n }\n const age = Math.max(0, now - time);\n if (age > valueIn(bound.within, \"ms\"))\n stale.push(`${bound.pointer} is ${formatDuration({ value: age, unit: \"ms\" })} old, above ${formatDuration(bound.within)}`);\n }\n return stale.length === 0 ? { ok: true } : { ok: false, why: `${url}: ${stale.join(\"; \")}` };\n};\n\n/** This function uses a probe one time, in a timeout of milliseconds. It does not throw. */\nexport const probeOnce = async (probe: ReadyProbe, timeout: number, ports: HostPorts): Promise<ProbeResult> => {\n try {\n if (probe.kind === \"http\") {\n const want = probe.status ?? 200;\n if (probe.fresh !== undefined) {\n if (ports.net.httpText === undefined) return { ok: false, why: \"the net port cannot read an answer, thus it cannot examine freshness\" };\n const answer = await ports.net.httpText(probe.url, timeout, PROBE_BODY_LIMIT);\n if (answer === null) return { ok: false, why: `${probe.url} gave no answer in ${timeout} ms` };\n if (answer.status !== want) return { ok: false, why: `${probe.url} gave ${answer.status}, not ${want}` };\n if (!answer.complete) return { ok: false, why: `the answer of ${probe.url} is above ${PROBE_BODY_LIMIT} bytes` };\n return freshness(probe.url, answer.body, probe.fresh, probe.now, ports.wall());\n }\n const status = await ports.net.httpStatus(probe.url, timeout);\n if (status === want) return { ok: true };\n return { ok: false, why: status === null ? `${probe.url} gave no answer in ${timeout} ms` : `${probe.url} gave ${status}, not ${want}` };\n }\n if (probe.kind === \"tcp\") {\n const host = probe.host ?? \"127.0.0.1\";\n if (await ports.net.tcpConnect(host, probe.port, timeout)) return { ok: true };\n return { ok: false, why: `no TCP connection to ${host}:${probe.port} in ${timeout} ms` };\n }\n const result = await ports.commands.run(probe.program, probe.args, { cwd: probe.cwd, timeout });\n return result.code === 0 ? { ok: true } : { ok: false, why: `${probe.program} gave the code ${result.code}` };\n } catch (error) {\n return { ok: false, why: `the probe failed: ${error instanceof Error ? error.message : String(error)}` };\n }\n};\n","import type { Quantity } from \"@mark1russell7/quantity\";\nimport { valueIn } from \"@mark1russell7/quantity\";\nimport type { Latch, Result, Trace } from \"../latch.ts\";\nimport { latch } from \"../latch.ts\";\nimport type { Poller } from \"../poller.ts\";\nimport { poller } from \"../poller.ts\";\nimport type { Timing } from \"../timing.ts\";\nimport type { HostPorts } from \"./ports.ts\";\nimport type { ProbeResult, ReadyProbe } from \"./probes.ts\";\nimport { probeOnce, probeProblems } from \"./probes.ts\";\nimport { isTime } from \"./render.ts\";\n\n/**\n * A verdict tells when a target goes down and when it comes up again.\n * - `debounce`: `failAfter` failed polls in sequence make it down, and `recoverAfter` passed polls in sequence make it up.\n * - `window`: failures for the time `failAfter` make it down. Passes for the time `recoverAfter` make it up. Without\n * `recoverAfter`, the first pass makes it up.\n */\nexport type TargetVerdict =\n | { readonly type: \"debounce\"; readonly failAfter: number; readonly recoverAfter: number }\n | { readonly type: \"window\"; readonly failAfter: Quantity; readonly recoverAfter?: Quantity | undefined };\n\n/** A watch target is one thing that a watcher probes on its own loop. */\nexport interface WatchTarget {\n /** This name is unique in the spec. A change names its target with it. */\n readonly name: string;\n readonly probe: ReadyProbe;\n /** This time is between the starts of two polls. */\n readonly interval: Quantity;\n /** This time is the most that one poll waits. It is not above the interval. */\n readonly timeout: Quantity;\n /** This fraction moves each interval by up to ± its part, thus two watchers do not poll in step. The default is 0.1. */\n readonly jitter?: number | undefined;\n /** The default is a debounce: 3 failures make it down, and 2 passes make it up. */\n readonly verdict?: TargetVerdict | undefined;\n}\n\n/** A watch spec lists the targets of one watcher. */\nexport interface WatchSpec {\n readonly targets: readonly WatchTarget[];\n}\n\n/** The health of a target is `unknown` until its first verdict. */\nexport type TargetHealth = \"unknown\" | \"up\" | \"down\";\n\n/** A target change is one transition of the health of a target. */\nexport interface TargetChange {\n readonly target: string;\n readonly from: TargetHealth;\n readonly to: \"up\" | \"down\";\n /** This time is the wall time of the change, in milliseconds after the epoch. */\n readonly at: number;\n /** This text tells why the latest poll failed, for a change to down. It is null for a change to up. */\n readonly why: string | null;\n}\n\n/** A target state is what a watcher knows of one target at this time. */\nexport interface TargetState {\n readonly name: string;\n readonly health: TargetHealth;\n /** This time is the wall time of the latest change of the health, or of the start. */\n readonly since: number;\n /** This result is the latest poll, or null before the first poll. */\n readonly last: ProbeResult | null;\n /** This time is the wall time of the latest poll, or null. */\n readonly lastAt: number | null;\n /** This count is the failed polls in sequence. */\n readonly failures: number;\n}\n\nexport interface WatchOptions {\n /** This function gets each change of the health of a target. A throw in it does not stop the watcher. */\n readonly onChange: (change: TargetChange) => void;\n /** This function gives a number in [0, 1) for the jitter. The default is `Math.random`. */\n readonly random?: (() => number) | undefined;\n /** This function gets each transition of the poller and the latch of each target, with the name of the target. */\n readonly trace?: ((target: string, from: string, to: string, on: string) => void) | undefined;\n}\n\n/** A target watch is a running watcher. */\nexport interface TargetWatch {\n /** This method gives the state of each target, in the sequence of the spec. */\n states(): TargetState[];\n /** This method polls each target one time at once, outside its loop, and gives the states after the polls. */\n pollNow(): Promise<TargetState[]>;\n /** This method stops each loop. A stopped watcher gives no change. */\n stop(): void;\n}\n\n/** This verdict is the default: 3 failures in sequence make a target down, and 2 passes make it up. */\nexport const DEFAULT_VERDICT: TargetVerdict = { type: \"debounce\", failAfter: 3, recoverAfter: 2 };\nconst DEFAULT_JITTER = 0.1;\n\nconst ms = (amount: Quantity): number => valueIn(amount, \"ms\");\nconst isTimeAtLeast = (value: unknown, floor: number, strict: boolean): boolean => isTime(value) && (strict ? ms(value) > floor : ms(value) >= floor);\nconst whole = (value: number): boolean => Number.isInteger(value) && value >= 1;\n\n/** This function gives the problems of a watch spec: each value that the watcher cannot use. */\nexport const watchProblems = (spec: WatchSpec): string[] => {\n const problems: string[] = [];\n if (spec.targets.length === 0) problems.push(\"the spec has no target\");\n const names = new Set<string>();\n for (const target of spec.targets) {\n const of = `the target ${JSON.stringify(target.name)}`;\n if (target.name === \"\") problems.push(\"a target name is empty\");\n if (names.has(target.name)) problems.push(`${of} is in the spec two times`);\n names.add(target.name);\n problems.push(...probeProblems(target.probe).map((problem) => `${of}: ${problem}`));\n if (!isTimeAtLeast(target.interval, 0, true)) problems.push(`${of}: the interval is not a time above zero`);\n if (!isTimeAtLeast(target.timeout, 0, true)) problems.push(`${of}: the timeout is not a time above zero`);\n else if (isTimeAtLeast(target.interval, 0, true) && ms(target.timeout) > ms(target.interval)) problems.push(`${of}: the timeout is above the interval`);\n const jitter = target.jitter ?? DEFAULT_JITTER;\n if (!(Number.isFinite(jitter) && jitter >= 0 && jitter < 1)) problems.push(`${of}: the jitter ${jitter} is not a fraction from 0 to below 1`);\n const verdict = target.verdict ?? DEFAULT_VERDICT;\n if (verdict.type === \"debounce\") {\n if (!whole(verdict.failAfter)) problems.push(`${of}: the verdict fails after ${verdict.failAfter} polls, not a whole number above zero`);\n if (!whole(verdict.recoverAfter)) problems.push(`${of}: the verdict recovers after ${verdict.recoverAfter} polls, not a whole number above zero`);\n } else if (verdict.type === \"window\") {\n if (!isTimeAtLeast(verdict.failAfter, 0, false)) problems.push(`${of}: the failAfter of the window is not a time of zero or more`);\n if (verdict.recoverAfter !== undefined && !isTimeAtLeast(verdict.recoverAfter, 0, false))\n problems.push(`${of}: the recoverAfter of the window is not a time of zero or more`);\n } else problems.push(`${of}: the verdict type ${JSON.stringify((verdict as { type: unknown }).type)} is not debounce or window`);\n }\n return problems;\n};\n\nconst timingOf = (target: WatchTarget): Timing => {\n const verdict = target.verdict ?? DEFAULT_VERDICT;\n return verdict.type === \"debounce\"\n ? { type: \"debounce\", interval: target.interval, failAfter: verdict.failAfter, recoverAfter: verdict.recoverAfter }\n : { type: \"window\", failAfter: verdict.failAfter, recoverAfter: verdict.recoverAfter };\n};\n\ninterface Unit {\n readonly target: WatchTarget;\n health: TargetHealth;\n since: number;\n last: ProbeResult | null;\n lastAt: number | null;\n failures: number;\n /** This text is the reason of the latest failed poll. */\n why: string | null;\n}\n\n/**\n * This function starts a watcher of targets: an outside prober. Each target has its own loop of polls, on the\n * clock of the ports, with a jitter. A verdict turns the polls into the health of the target: a debounce or a\n * window. A target is `unknown` at the start. Its first pass makes it up, and its verdict makes it down. Each change\n * goes to `onChange`, with the reason of the latest failed poll. The watcher throws at the start when the spec has a\n * problem.\n */\nexport const watchTargets = (spec: WatchSpec, ports: HostPorts, options: WatchOptions): TargetWatch => {\n const problems = watchProblems(spec);\n if (problems.length > 0) throw new Error(`the watch spec has problems: ${problems.join(\"; \")}`);\n const random = options.random ?? Math.random;\n let stopped = false;\n\n const emit = (unit: Unit, to: \"up\" | \"down\"): void => {\n if (unit.health === to) return;\n const change: TargetChange = { target: unit.target.name, from: unit.health, to, at: ports.wall(), why: to === \"down\" ? unit.why : null };\n unit.health = to;\n unit.since = change.at;\n if (stopped) return;\n try {\n options.onChange(change);\n } catch (error) {\n ports.logger?.log(\"warn\", `the change handler of the watch failed: ${error instanceof Error ? error.message : String(error)}`, { target: change.target });\n }\n };\n\n const watched = spec.targets.map((target): { readonly unit: Unit; readonly gate: Latch; readonly loop: Poller } => {\n const unit: Unit = { target, health: \"unknown\", since: ports.wall(), last: null, lastAt: null, failures: 0, why: null };\n const trace: Trace | undefined = options.trace === undefined ? undefined : (from, to, on) => options.trace?.(target.name, from, to, on);\n const timeout = ms(target.timeout);\n // the result of the latest probe: a poller result tells only the outcome\n let probed: ProbeResult | null = null;\n const gate: Latch = latch(timingOf(target), ports.clock, false, () => emit(unit, gate.tripped ? \"down\" : \"up\"), trace);\n const record = (result: Result): void => {\n const own = probed;\n probed = null;\n // a timeout or a pending call has the cause of the poller: the probe gave no result for this poll\n const seen: ProbeResult =\n result.outcome === \"ok\" ? { ok: true } : { ok: false, why: !result.timedOut && own !== null && !own.ok ? own.why : (result.cause ?? \"the poll failed\") };\n unit.last = seen;\n unit.lastAt = ports.wall();\n unit.failures = seen.ok ? 0 : unit.failures + 1;\n if (!seen.ok) unit.why = seen.why;\n gate.record(result);\n if (seen.ok && unit.health === \"unknown\" && !gate.tripped) emit(unit, \"up\");\n };\n const loop = poller({\n name: target.name,\n poll: { interval: target.interval, jitter: target.jitter ?? DEFAULT_JITTER, timeout: target.timeout },\n run: async () => {\n const result = await probeOnce(target.probe, timeout, ports);\n probed = result;\n return result.ok ? \"ok\" : \"error\";\n },\n clock: ports.clock,\n random,\n forced: () => false,\n record,\n trace,\n });\n return { unit, gate, loop };\n });\n\n const states = (): TargetState[] =>\n watched.map(({ unit }) => ({ name: unit.target.name, health: unit.health, since: unit.since, last: unit.last, lastAt: unit.lastAt, failures: unit.failures }));\n\n for (const { loop } of watched) loop.start(0);\n\n return {\n states,\n async pollNow() {\n await Promise.all(watched.map(({ loop }) => loop.pollNow()));\n return states();\n },\n stop() {\n if (stopped) return;\n stopped = true;\n for (const { gate, loop } of watched) {\n loop.stop();\n gate.stop();\n }\n },\n };\n};\n","/** An env file is the variables of a file of environment variables, and the problem of each line that it skipped. */\nexport interface EnvFile {\n readonly env: Readonly<Record<string, string>>;\n readonly problems: readonly string[];\n}\n\nconst KEY = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/** This function reads a value in double quotes: `\\n`, `\\t`, `\\\"` and `\\\\` are escapes. */\nconst doubleQuoted = (body: string): string =>\n body.replace(/\\\\(.)/g, (_match, char: string) => (char === \"n\" ? \"\\n\" : char === \"t\" ? \"\\t\" : char === \"r\" ? \"\\r\" : char));\n\n/**\n * This function reads a file of environment variables, one `KEY=value` on each line. It is a pure\n * function. It does not throw: it skips a bad line and gives its problem.\n * - A blank line and a line that starts with `#` are skipped. A line can start with `export `.\n * - A value in single quotes is literal. A value in double quotes has the escapes `\\n`, `\\t`, `\\\"` and `\\\\`.\n * - A value without quotes ends at ` #`, and its spaces at the two ends go.\n * - A key that comes again replaces its value.\n */\nexport const parseEnvFile = (text: string): EnvFile => {\n const env: Record<string, string> = {};\n const problems: string[] = [];\n // a byte order mark at the start is not a part of the first key\n const lines = (text.charCodeAt(0) === 0xfeff ? text.slice(1) : text).split(/\\r?\\n/);\n lines.forEach((raw, at) => {\n const line = raw.trim();\n if (line === \"\" || line.startsWith(\"#\")) return;\n const body = line.startsWith(\"export \") ? line.slice(\"export \".length).trimStart() : line;\n const equals = body.indexOf(\"=\");\n if (equals <= 0) {\n problems.push(`line ${at + 1} has no KEY=value`);\n return;\n }\n const key = body.slice(0, equals).trim();\n if (!KEY.test(key)) {\n problems.push(`line ${at + 1}: ${JSON.stringify(key)} is not a name of a variable`);\n return;\n }\n const rest = body.slice(equals + 1).trim();\n const quote = rest[0];\n if (quote === '\"' || quote === \"'\") {\n const end = quote === \"'\" ? rest.indexOf(\"'\", 1) : closingQuote(rest);\n if (end < 0) {\n problems.push(`line ${at + 1}: the value of ${key} has no closing quote`);\n return;\n }\n env[key] = quote === \"'\" ? rest.slice(1, end) : doubleQuoted(rest.slice(1, end));\n return;\n }\n const comment = rest.search(/\\s#/);\n env[key] = (comment < 0 ? rest : rest.slice(0, comment)).trim();\n });\n return { env, problems };\n};\n\n/** This function gives the place of the double quote that closes a value, or -1. A quote after a backslash does not close it. */\nconst closingQuote = (text: string): number => {\n for (let at = 1; at < text.length; at += 1) {\n if (text[at] === \"\\\\\") at += 1;\n else if (text[at] === '\"') return at;\n }\n return -1;\n};\n","import type { Quantity } from \"@mark1russell7/quantity\";\nimport { valueIn } from \"@mark1russell7/quantity\";\nimport type { FilePort } from \"./ports.ts\";\n\n/** A log spec tells where the output of a program goes, and when the file rotates. */\nexport interface LogSpec {\n /** This path is the log file. */\n readonly path: string;\n /** This size is the most that the file gets before it rotates, for example `{ value: 10, unit: \"MB\" }`. */\n readonly maxSize: Quantity;\n /** This count is the number of old files that stay: `<path>.1` is the newest. 0 keeps no old file. */\n readonly keep: number;\n}\n\n/** A rotating log writes data to a file, and rotates the file at its size. */\nexport interface RotatingLog {\n /** This method adds data to the log. The writes occur in sequence. A failed write does not throw. */\n write(chunk: string | Uint8Array): void;\n /** This promise ends when each write before it is done. */\n flush(): Promise<void>;\n /** This count is the number of writes that failed. */\n readonly failures: number;\n}\n\nconst byteLength = (chunk: string | Uint8Array): number => (typeof chunk === \"string\" ? new TextEncoder().encode(chunk).length : chunk.length);\n\n/**\n * This function makes a rotating log on a file port. Before a write that makes the file larger than\n * `maxSize`, the file rotates: `<path>.<keep>` goes, each `<path>.<n>` becomes `<path>.<n + 1>`, and the\n * file becomes `<path>.1`. A chunk larger than the size goes into a new file of its own.\n */\nexport const rotatingLog = (spec: LogSpec, files: FilePort): RotatingLog => {\n const max = valueIn(spec.maxSize, \"B\");\n let chain: Promise<void> = Promise.resolve();\n let size: number | null = null;\n let failures = 0;\n const rotate = async (): Promise<void> => {\n if (spec.keep <= 0) {\n await files.remove(spec.path);\n return;\n }\n await files.remove(`${spec.path}.${spec.keep}`);\n for (let at = spec.keep - 1; at >= 1; at -= 1)\n if ((await files.size(`${spec.path}.${at}`)) !== null) await files.rename(`${spec.path}.${at}`, `${spec.path}.${at + 1}`);\n await files.rename(spec.path, `${spec.path}.1`);\n };\n const append = async (chunk: string | Uint8Array): Promise<void> => {\n const length = byteLength(chunk);\n size ??= (await files.size(spec.path)) ?? 0;\n if (size > 0 && size + length > max) {\n await rotate();\n size = 0;\n }\n await files.append(spec.path, chunk);\n size += length;\n };\n return {\n write(chunk) {\n chain = chain.then(() => append(chunk)).catch(() => {\n failures += 1;\n // the size is not known after a failure: the next write reads it again\n size = null;\n });\n },\n flush: () => chain,\n get failures() {\n return failures;\n },\n };\n};\n","import type { Quantity } from \"@mark1russell7/quantity\";\nimport { convertible, isQuantity, valueIn } from \"@mark1russell7/quantity\";\nimport type { Backoff } from \"../backoff.ts\";\nimport { backoffProblems } from \"../backoff.ts\";\nimport type { Cancel } from \"../clock.ts\";\nimport type { LogFields, LogLevel } from \"../logger.ts\";\nimport type { MessageShape } from \"../process.ts\";\nimport { isMessageShape } from \"../process.ts\";\nimport type { Retrier } from \"../retrier.ts\";\nimport { retrier } from \"../retrier.ts\";\nimport { removeDiscovery, writeDiscovery } from \"./discovery.ts\";\nimport { parseEnvFile } from \"./env.ts\";\nimport type { InstanceLock } from \"./lock.ts\";\nimport { acquireInstanceLock } from \"./lock.ts\";\nimport type { LogSpec, RotatingLog } from \"./logs.ts\";\nimport { rotatingLog } from \"./logs.ts\";\nimport type { ChildHandle, HostPorts } from \"./ports.ts\";\nimport { joinPath } from \"./ports.ts\";\nimport type { ReadyProbe } from \"./probes.ts\";\nimport { probeOnce, probeProblems } from \"./probes.ts\";\nimport { stopTree } from \"./processes.ts\";\nimport { isTime } from \"./render.ts\";\n\n/** A ready spec tells how the supervisor finds that a program is ready. */\nexport interface ReadySpec {\n readonly probe: ReadyProbe;\n /** This time is the pause between two uses of the probe. */\n readonly interval: Quantity;\n /** This time is the most that one use of the probe can take. */\n readonly timeout: Quantity;\n /** This time is the most that the program can take to be ready. After it, the supervisor stops the program and starts it again. */\n readonly within: Quantity;\n}\n\n/**\n * An alive spec tells how the supervisor finds that a ready program still works. A program can hang and not exit:\n * its process stays, and only a probe finds it. After `failures` failures in sequence, the supervisor stops the\n * program in stages and starts it again after its backoff.\n */\nexport interface AliveSpec {\n readonly probe: ReadyProbe;\n /** This time is the pause between two uses of the probe. The first use is one interval after the program is ready. */\n readonly interval: Quantity;\n /** This time is the most that one use of the probe can take. */\n readonly timeout: Quantity;\n /** This count of failures in sequence stops the program: a whole number of 1 or more. A pass sets the count to 0. */\n readonly failures: number;\n}\n\n/** A program restart tells how the supervisor starts a program again after it stops. */\nexport interface ProgramRestart {\n /** This backoff gives the wait before each start again, in milliseconds, as `retrier` uses it. */\n readonly backoff: Backoff;\n /** This time is how long a program is ready before its count of tries goes back to 0. */\n readonly resetAfter: Quantity;\n}\n\n/** A stop spec tells how the supervisor stops a program. */\nexport interface StopSpec {\n /** This time is the wait for the staged stop, before the supervisor stops the process tree. */\n readonly grace: Quantity;\n /** This message goes on the IPC channel of a child that has one. The default is `\"shutdown\"`, which `run()` can match. */\n readonly message?: MessageShape | undefined;\n /** This signal goes to a child without an IPC channel on Linux. The default is `SIGTERM`. */\n readonly signal?: \"SIGINT\" | \"SIGTERM\" | undefined;\n}\n\n/** A program spec tells one program of a group, and what it needs before it starts. */\nexport interface ProgramSpec {\n /** This name is the name of the program in the group: letters, digits, `.`, `_` and `-`. */\n readonly name: string;\n readonly program: string;\n readonly args?: readonly string[] | undefined;\n readonly cwd?: string | undefined;\n /** These variables go to the program. They replace the variables of the env file and of the host. */\n readonly env?: Readonly<Record<string, string>> | undefined;\n /** This file gives variables to the program at each start (`parseEnvFile`). They replace the variables of the host. */\n readonly envFile?: string | undefined;\n /** These are the programs that must be ready before this program starts. */\n readonly after?: readonly string[] | undefined;\n /** This spec tells when the program is ready. Without it, the program is ready when it starts. */\n readonly ready?: ReadySpec | undefined;\n /** This spec tells how the supervisor finds that the ready program still works. Without it, only an exit starts the program again. */\n readonly alive?: AliveSpec | undefined;\n /** This policy starts the program again after it stops. The default is `DEFAULT_RESTART`. Null does not start it again. */\n readonly restart?: ProgramRestart | null | undefined;\n /** This spec tells the log file. The default is `<stateDir>/logs/<name>.log`, 10 MB, with 3 old files. Null keeps no log. */\n readonly log?: LogSpec | null | undefined;\n /** True gives the child an IPC channel, for the staged stop of a Node program. The default is false. */\n readonly ipc?: boolean | undefined;\n /** This spec tells the stop. The default is a grace of 10 s. */\n readonly stop?: StopSpec | undefined;\n /** These fields go in the discovery file of the program, `<stateDir>/<name>.json`. */\n readonly listen?: { readonly port?: number | null | undefined; readonly url?: string | null | undefined } | undefined;\n}\n\n/** A group spec tells a group of programs that one supervisor starts in sequence and keeps alive. */\nexport interface GroupSpec {\n readonly name: string;\n /** This folder keeps the lock, the discovery file and the log of each program. */\n readonly stateDir: string;\n readonly programs: readonly ProgramSpec[];\n}\n\n/** These options go with a supervisor. */\nexport interface GroupOptions {\n /** This function gives a number in [0, 1) for the jitter of the backoff. The default is `Math.random`. */\n readonly random?: (() => number) | undefined;\n}\n\n/**\n * A program phase tells where a program of a group is.\n * - `waiting`: a program that it needs is not ready.\n * - `starting`: it runs, and its probe did not pass.\n * - `ready`: it runs, and its probe passed.\n * - `backoff`: it stopped, and it starts again after its backoff.\n * - `held`: another instance holds its lock. The supervisor tries again after the backoff.\n * - `exited`: it stopped, and it has no restart.\n * - `stopping`, `stopped`: the stop of the group.\n */\nexport type ProgramPhase = \"waiting\" | \"starting\" | \"ready\" | \"backoff\" | \"held\" | \"exited\" | \"stopping\" | \"stopped\";\n\n/** A program state is the state of one program of a group, for a status. */\nexport interface ProgramState {\n readonly name: string;\n readonly phase: ProgramPhase;\n /** This number is the process ID of the child, or null. */\n readonly pid: number | null;\n /** This count is the number of starts again since the start of the group. */\n readonly restarts: number;\n /** This text tells the last problem, for example why the probe failed, or it is null. */\n readonly detail: string | null;\n}\n\n/** A group supervisor starts the programs of a group in sequence, starts each again after it stops, and stops them in stages. */\nexport interface GroupSupervisor {\n /** This method starts each program whose programs are ready. A second use does nothing. */\n start(): void;\n /** This method stops each program in the reverse sequence of the start. A second use gives the same promise. */\n stop(): Promise<void>;\n /** This method gives the state of each program, in the sequence of the spec. */\n states(): readonly ProgramState[];\n}\n\n/**\n * This restart is the default. The first wait is 1 s, and each wait after it is two times longer, to 1 min.\n * The jitter subtracts up to half of each wait. The count of tries goes back to 0 after 1 min ready.\n */\nexport const DEFAULT_RESTART: ProgramRestart = {\n backoff: { base: 1000, factor: 2, cap: 60_000, jitter: { kind: \"subtract\", fraction: 0.5 } },\n resetAfter: { value: 60, unit: \"s\" },\n};\n\nconst DEFAULT_GRACE: Quantity = { value: 10, unit: \"s\" };\nconst DEFAULT_LOG_SIZE: Quantity = { value: 10, unit: \"MB\" };\nconst DEFAULT_LOG_KEEP = 3;\nconst NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;\n\nconst ms = (time: Quantity): number => valueIn(time, \"ms\");\n\n/**\n * This function gives the start sequence of a group, as layers of names. Each program of a layer needs only programs of the\n * layers before it. A program in a cycle, or after an unknown program, is in no layer. `groupProblems` names it.\n */\nexport const startOrder = (spec: GroupSpec): string[][] => {\n const names = new Set(spec.programs.map((program) => program.name));\n const placed = new Set<string>();\n const layers: string[][] = [];\n for (;;) {\n const layer = spec.programs\n .filter((program) => !placed.has(program.name))\n .filter((program) => (program.after ?? []).every((name) => names.has(name) && placed.has(name)))\n .map((program) => program.name);\n if (layer.length === 0) return layers;\n for (const name of layer) placed.add(name);\n layers.push([...new Set(layer)]);\n }\n};\n\nconst isTimeAtLeast = (value: unknown, floor: number, strict: boolean): boolean =>\n isTime(value) && (strict ? ms(value) > floor : ms(value) >= floor);\n\n/** This function gives the problems of a group spec: each value that the supervisor cannot use. */\nexport const groupProblems = (spec: GroupSpec): string[] => {\n const problems: string[] = [];\n if (!NAME.test(spec.name)) problems.push(`the group name ${JSON.stringify(spec.name)} is not letters, digits, \".\", \"_\" and \"-\"`);\n if (spec.stateDir === \"\") problems.push(\"the stateDir is empty\");\n if (spec.programs.length === 0) problems.push(\"the group has no programs\");\n const seen = new Set<string>();\n const names = new Set(spec.programs.map((program) => program.name));\n for (const program of spec.programs) {\n const name = program.name;\n const of = `the program ${JSON.stringify(name)}`;\n if (!NAME.test(name)) problems.push(`${of}: the name is not letters, digits, \".\", \"_\" and \"-\"`);\n if (seen.has(name)) problems.push(`${of} comes two times`);\n seen.add(name);\n if (program.program === \"\") problems.push(`${of}: the program is empty`);\n for (const need of program.after ?? []) {\n if (need === name) problems.push(`${of} is after itself`);\n else if (!names.has(need)) problems.push(`${of} is after ${JSON.stringify(need)}, which is not in the group`);\n }\n if (program.ready !== undefined) {\n problems.push(...probeProblems(program.ready.probe).map((problem) => `${of}: ${problem}`));\n for (const field of [\"interval\", \"timeout\", \"within\"] as const)\n if (!isTimeAtLeast(program.ready[field], 0, true)) problems.push(`${of}: the ${field} of the probe is not a time above zero`);\n }\n if (program.alive !== undefined) {\n problems.push(...probeProblems(program.alive.probe).map((problem) => `${of}: the liveness probe: ${problem}`));\n for (const field of [\"interval\", \"timeout\"] as const)\n if (!isTimeAtLeast(program.alive[field], 0, true)) problems.push(`${of}: the ${field} of the liveness probe is not a time above zero`);\n if (!(Number.isInteger(program.alive.failures) && program.alive.failures >= 1))\n problems.push(`${of}: the failures of the liveness probe is not a whole number of 1 or more`);\n }\n if (program.restart !== undefined && program.restart !== null) {\n problems.push(...backoffProblems(program.restart.backoff).map((problem) => `${of}: ${problem}`));\n if (!isTimeAtLeast(program.restart.resetAfter, 0, false)) problems.push(`${of}: the resetAfter is not a time of zero or more`);\n }\n if (program.log !== undefined && program.log !== null) {\n const size = program.log.maxSize;\n if (!(isQuantity(size) && convertible(size.unit, \"B\") && valueIn(size, \"B\") > 0)) problems.push(`${of}: the maxSize of the log is not a size above zero`);\n if (!(Number.isInteger(program.log.keep) && program.log.keep >= 0)) problems.push(`${of}: the keep of the log is not a whole number of zero or more`);\n if (program.log.path === \"\") problems.push(`${of}: the path of the log is empty`);\n }\n if (program.stop !== undefined) {\n if (!isTimeAtLeast(program.stop.grace, 0, false)) problems.push(`${of}: the grace of the stop is not a time of zero or more`);\n if (program.stop.message !== undefined && !isMessageShape(program.stop.message)) problems.push(`${of}: the stop message is not a value of JSON`);\n const signal = program.stop.signal;\n if (signal !== undefined && signal !== \"SIGINT\" && signal !== \"SIGTERM\") problems.push(`${of}: the stop signal ${JSON.stringify(signal)} is not SIGINT or SIGTERM`);\n }\n const port = program.listen?.port;\n if (port !== undefined && port !== null && !(Number.isInteger(port) && port >= 1 && port <= 65_535))\n problems.push(`${of}: the port ${port} is not a port from 1 to 65535`);\n }\n const placed = new Set(startOrder(spec).flat());\n const left = spec.programs.filter((program) => !placed.has(program.name) && (program.after ?? []).every((need) => names.has(need) && need !== program.name));\n if (left.length > 0) problems.push(`the programs ${left.map((program) => JSON.stringify(program.name)).join(\", \")} are in a cycle of \"after\", or after a program in one`);\n return problems;\n};\n\n/** The supervisor keeps one unit for each program: its spec, its files and its state. */\ninterface Unit {\n readonly spec: ProgramSpec;\n readonly lockPath: string;\n readonly discoveryPath: string;\n readonly log: RotatingLog | null;\n readonly retry: Retrier | null;\n phase: ProgramPhase;\n child: ChildHandle | null;\n lock: InstanceLock | null;\n timers: Cancel[];\n /** This cancel stops the next use of the liveness probe. It is one timer, thus a long life adds no timers. */\n watch: Cancel | null;\n restarts: number;\n detail: string | null;\n /** This text tells why the supervisor stopped the child, or it is null. */\n reason: string | null;\n waiters: Array<() => void>;\n}\n\n/**\n * This function makes the supervisor of a group. It refuses a spec with problems. Each effect goes\n * through the ports, thus a test gives `fakeHost()` and starts no process.\n * - A program starts when each program of its `after` is ready. It takes its lock first, thus a second instance does not start.\n * - A program with a probe is ready when its probe passes. A program that is not ready in `within` stops, and starts again.\n * - A program that stops starts again after the backoff of its `retrier`, when its programs are ready.\n * - Its output goes to its rotating log. Its environment is the host, then its env file, then its `env`.\n * - The stop goes in the reverse sequence: the staged stop first, and after the grace, the stop of the process tree by its ID.\n */\nexport const superviseGroup = (spec: GroupSpec, ports: HostPorts, options: GroupOptions = {}): GroupSupervisor => {\n const problems = groupProblems(spec);\n if (problems.length > 0) throw new Error(`the group ${spec.name} has problems: ${problems.join(\"; \")}`);\n const abort = new AbortController();\n const layers = startOrder(spec);\n let started = false;\n let stopping = false;\n let stopped: Promise<void> | null = null;\n\n const say = (level: LogLevel, message: string, fields: LogFields): void => {\n try {\n ports.logger?.log(level, message, { group: spec.name, ...fields });\n } catch {\n // the supervisor does not depend on its logger\n }\n };\n\n const units = new Map<string, Unit>();\n for (const program of spec.programs) {\n const restart = program.restart === undefined ? DEFAULT_RESTART : program.restart;\n const logSpec =\n program.log === undefined\n ? { path: joinPath(ports.platform, spec.stateDir, \"logs\", `${program.name}.log`), maxSize: DEFAULT_LOG_SIZE, keep: DEFAULT_LOG_KEEP }\n : program.log;\n units.set(program.name, {\n spec: program,\n lockPath: joinPath(ports.platform, spec.stateDir, `${program.name}.lock`),\n discoveryPath: joinPath(ports.platform, spec.stateDir, `${program.name}.json`),\n log: logSpec === null ? null : rotatingLog(logSpec, ports.files),\n retry:\n restart === null\n ? null\n : retrier({ ...restart.backoff, clock: ports.clock, signal: abort.signal, ...(options.random === undefined ? {} : { random: options.random }) }),\n phase: \"waiting\",\n child: null,\n lock: null,\n timers: [],\n watch: null,\n restarts: 0,\n detail: null,\n reason: null,\n waiters: [],\n });\n }\n const unitOf = (name: string): Unit => units.get(name)!;\n\n const clearTimers = (unit: Unit): void => {\n for (const cancel of unit.timers.splice(0)) cancel();\n unit.watch?.();\n unit.watch = null;\n };\n\n const environment = async (unit: Unit): Promise<Record<string, string>> => {\n const env: Record<string, string> = {};\n for (const [key, value] of Object.entries(ports.env)) if (value !== undefined) env[key] = value;\n const file = unit.spec.envFile;\n if (file !== undefined) {\n try {\n const text = await ports.files.read(file);\n if (text === null) say(\"warn\", `the env file ${file} of ${unit.spec.name} does not exist`, { program: unit.spec.name, file });\n else {\n const parsed = parseEnvFile(text);\n Object.assign(env, parsed.env);\n for (const problem of parsed.problems) say(\"warn\", `the env file ${file} of ${unit.spec.name}: ${problem}`, { program: unit.spec.name, file });\n }\n } catch (error) {\n say(\"warn\", `the read of the env file ${file} of ${unit.spec.name} failed`, { program: unit.spec.name, file, error });\n }\n }\n return Object.assign(env, unit.spec.env ?? {});\n };\n\n const consider = (unit: Unit): void => {\n if (!started || stopping || unit.phase !== \"waiting\") return;\n if (!(unit.spec.after ?? []).every((name) => unitOf(name).phase === \"ready\")) return;\n void launch(unit);\n };\n const considerAll = (): void => {\n for (const layer of layers) for (const name of layer) consider(unitOf(name));\n };\n\n /** This function starts the program again after the backoff, or ends it when it has no restart. */\n const later = (unit: Unit, phase: \"backoff\" | \"held\"): void => {\n const delay = unit.retry?.schedule(() => {\n if (stopping) return;\n unit.phase = \"waiting\";\n unit.restarts += 1;\n consider(unit);\n });\n if (delay === undefined || delay === null) {\n unit.phase = phase === \"held\" ? \"held\" : \"exited\";\n void unit.lock?.release();\n unit.lock = null;\n return;\n }\n unit.phase = phase;\n say(\"info\", `${unit.spec.name} starts again in ${delay} ms`, { program: unit.spec.name, delay: { value: delay, unit: \"ms\" }, attempt: unit.retry?.attempts });\n };\n\n const markReady = (unit: Unit, child: ChildHandle): void => {\n if (unit.child !== child || stopping) return;\n unit.phase = \"ready\";\n unit.detail = null;\n say(\"info\", `${unit.spec.name} is ready`, { program: unit.spec.name, pid: child.pid });\n const restart = unit.spec.restart === undefined ? DEFAULT_RESTART : unit.spec.restart;\n if (unit.retry !== null && restart !== null)\n unit.timers.push(\n ports.clock.after(ms(restart.resetAfter), () => {\n if (unit.child === child && unit.phase === \"ready\") unit.retry?.reset();\n }),\n );\n if (unit.spec.alive !== undefined) watch(unit, child, unit.spec.alive);\n considerAll();\n };\n\n /** This function uses the liveness probe of a ready program each interval, and stops the program after `failures` failures in sequence. */\n const watch = (unit: Unit, child: ChildHandle, alive: AliveSpec): void => {\n let failures = 0;\n const current = (): boolean => unit.child === child && unit.phase === \"ready\" && !stopping;\n const next = (): void => {\n unit.watch = ports.clock.after(ms(alive.interval), () => {\n unit.watch = null;\n void check();\n });\n };\n const check = async (): Promise<void> => {\n if (!current()) return;\n const result = await probeOnce(alive.probe, ms(alive.timeout), ports);\n if (!current()) return;\n if (result.ok) {\n if (failures > 0) say(\"info\", `${unit.spec.name} is alive again`, { program: unit.spec.name, pid: child.pid, failures });\n failures = 0;\n unit.detail = null;\n next();\n return;\n }\n failures += 1;\n unit.detail = `the liveness probe failed ${failures} of ${alive.failures} times in sequence (${result.why})`;\n if (failures < alive.failures) {\n say(\"warn\", `${unit.spec.name}: ${unit.detail}`, { program: unit.spec.name, pid: child.pid, why: result.why });\n next();\n return;\n }\n unit.reason = `its liveness probe failed ${failures} times in sequence (${result.why})`;\n unit.detail = unit.reason;\n say(\"warn\", `${unit.spec.name} is not alive, thus it stops`, { program: unit.spec.name, pid: child.pid, why: result.why });\n void stagedStop(unit, child);\n };\n next();\n };\n\n const probe = (unit: Unit, child: ChildHandle, ready: ReadySpec): void => {\n const deadline = ports.clock.now() + ms(ready.within);\n const attempt = async (): Promise<void> => {\n if (unit.child !== child || stopping) return;\n const result = await probeOnce(ready.probe, ms(ready.timeout), ports);\n if (unit.child !== child || stopping) return;\n if (result.ok) {\n markReady(unit, child);\n return;\n }\n unit.detail = result.why;\n if (ports.clock.now() >= deadline) {\n unit.reason = `it was not ready in ${ms(ready.within)} ms (${result.why})`;\n unit.detail = unit.reason;\n say(\"warn\", `${unit.spec.name} is not ready in its time, thus it stops`, { program: unit.spec.name, pid: child.pid, why: result.why });\n void stagedStop(unit, child);\n return;\n }\n unit.timers.push(ports.clock.after(ms(ready.interval), () => void attempt()));\n };\n void attempt();\n };\n\n const exited = (unit: Unit, child: ChildHandle, code: number | null, signal: string | null): void => {\n if (unit.child !== child) return;\n clearTimers(unit);\n unit.child = null;\n for (const waiter of unit.waiters.splice(0)) waiter();\n if (child.pid !== null) void removeDiscovery(unit.discoveryPath, ports, child.pid);\n void unit.lock?.update(null).catch(() => {});\n if (stopping || unit.phase === \"stopping\") {\n unit.phase = \"stopped\";\n return;\n }\n const end = child.pid === null ? `${unit.spec.program} did not start` : `it exited with ${code === null ? `the signal ${signal ?? \"unknown\"}` : `the code ${code}`}`;\n unit.detail = unit.reason === null ? end : `${unit.reason}, then ${end}`;\n unit.reason = null;\n say(\"warn\", `${unit.spec.name} stopped: ${unit.detail}`, { program: unit.spec.name, pid: child.pid, code, signal });\n later(unit, \"backoff\");\n };\n\n const launch = async (unit: Unit): Promise<void> => {\n unit.phase = \"starting\";\n unit.detail = null;\n const name = unit.spec.name;\n if (unit.lock === null) {\n const taken = await acquireInstanceLock(unit.lockPath, ports);\n if (stopping) {\n if (taken.kind === \"acquired\") await taken.lock.release();\n return;\n }\n if (taken.kind !== \"acquired\") {\n unit.detail = taken.kind === \"held\" ? `the process ${taken.owner.child?.pid ?? taken.owner.pid} holds the lock ${unit.lockPath}` : taken.problem;\n say(\"warn\", `${name} does not start: ${unit.detail}`, { program: name, lock: unit.lockPath });\n later(unit, \"held\");\n return;\n }\n unit.lock = taken.lock;\n }\n const lock = unit.lock;\n const env = await environment(unit);\n if (stopping) {\n await lock.release();\n unit.lock = null;\n return;\n }\n const child = ports.processes.spawn({ program: unit.spec.program, args: unit.spec.args ?? [], cwd: unit.spec.cwd, env, ipc: unit.spec.ipc ?? false });\n const startedAt = ports.wall();\n unit.child = child;\n child.onOutput((_stream, chunk) => unit.log?.write(chunk));\n child.onExit((code, signal) => exited(unit, child, code, signal));\n const pid = child.pid;\n if (pid === null) return;\n say(\"info\", `${name} started`, { program: name, pid });\n const mark = { pid, startedAt };\n try {\n await lock.update(mark);\n await writeDiscovery(\n unit.discoveryPath,\n { pid, startedAt: new Date(startedAt).toISOString(), port: unit.spec.listen?.port ?? null, url: unit.spec.listen?.url ?? null, extra: { group: spec.name, program: name } },\n ports,\n );\n } catch (error) {\n say(\"warn\", `the files of ${name} were not written`, { program: name, error });\n }\n // a child that ended during the writes leaves no discovery file\n if (unit.child !== child) await removeDiscovery(unit.discoveryPath, ports, pid);\n if (unit.child !== child || stopping) return;\n if (unit.spec.ready === undefined) markReady(unit, child);\n else probe(unit, child, unit.spec.ready);\n };\n\n /** This function waits for the end of a child, for at most `wait` milliseconds. It tells if the child ended. */\n const ended = (unit: Unit, child: ChildHandle, wait: number): Promise<boolean> =>\n new Promise((resolve) => {\n if (unit.child !== child) {\n resolve(true);\n return;\n }\n const cancel = ports.clock.after(wait, () => resolve(unit.child !== child));\n unit.waiters.push(() => {\n cancel();\n resolve(true);\n });\n });\n\n /**\n * This function stops a child in stages. The message goes on its IPC channel when it has one. Else\n * Linux gets SIGTERM, and Windows gets `taskkill /T` without `/F`. After the grace, the process tree stops by its ID.\n */\n const stagedStop = async (unit: Unit, child: ChildHandle): Promise<void> => {\n const pid = child.pid;\n if (pid === null || unit.child !== child) return;\n const grace = ms(unit.spec.stop?.grace ?? DEFAULT_GRACE);\n const gone = ended(unit, child, grace);\n let asked: string | null = null;\n if (child.ipc && child.send(unit.spec.stop?.message ?? \"shutdown\")) asked = \"the IPC message\";\n else if (ports.platform === \"win32\") {\n const result = await ports.commands.run(\"taskkill\", [\"/T\", \"/PID\", String(pid)]).catch(() => null);\n if (result?.code === 0) asked = \"taskkill\";\n } else {\n const signal = unit.spec.stop?.signal ?? \"SIGTERM\";\n if (ports.processes.signal(pid, signal)) asked = signal;\n }\n say(\"info\", `${unit.spec.name} stops${asked === null ? \"\" : ` through ${asked}`}`, { program: unit.spec.name, pid, grace: { value: grace, unit: \"ms\" } });\n if (asked !== null && (await gone)) return;\n const tree = await stopTree(pid, ports);\n const why = asked === null ? \"the staged stop did not go\" : \"it did not stop in its grace\";\n say(tree.kind === \"failed\" ? \"error\" : \"warn\", `${unit.spec.name}: ${why}, thus its process tree stops: ${tree.kind}`, {\n program: unit.spec.name,\n pid,\n outcome: tree.kind,\n });\n if (!(await ended(unit, child, grace))) say(\"error\", `${unit.spec.name} did not end after the stop of its process tree`, { program: unit.spec.name, pid });\n };\n\n const stopUnit = async (unit: Unit): Promise<void> => {\n clearTimers(unit);\n const child = unit.child;\n const pid = child?.pid ?? null;\n if (child !== null && pid !== null) {\n unit.phase = \"stopping\";\n await stagedStop(unit, child);\n await removeDiscovery(unit.discoveryPath, ports, pid);\n }\n unit.phase = \"stopped\";\n await unit.lock?.release();\n unit.lock = null;\n };\n\n return {\n start() {\n if (started || stopping) return;\n started = true;\n say(\"info\", `the group ${spec.name} starts`, { layers });\n considerAll();\n },\n stop() {\n if (stopped !== null) return stopped;\n stopping = true;\n abort.abort();\n stopped = (async () => {\n for (const layer of [...layers].reverse()) await Promise.all(layer.map((name) => stopUnit(unitOf(name))));\n await Promise.all([...units.values()].map((unit) => unit.log?.flush()));\n say(\"info\", `the group ${spec.name} stopped`, {});\n })();\n return stopped;\n },\n states() {\n return spec.programs.map((program) => {\n const unit = unitOf(program.name);\n return { name: program.name, phase: unit.phase, pid: unit.child?.pid ?? null, restarts: unit.restarts, detail: unit.detail };\n });\n },\n };\n};\n","import type { Serializable } from \"node:child_process\";\nimport { execFile, spawn as spawnChild } from \"node:child_process\";\nimport { appendFile, mkdir, readFile, rename, rm, stat, writeFile } from \"node:fs/promises\";\nimport { connect } from \"node:net\";\nimport { homedir, userInfo } from \"node:os\";\nimport { dirname } from \"node:path\";\nimport type { Clock } from \"../clock.ts\";\nimport { realClock } from \"../clock.ts\";\nimport type { Logger } from \"../logger.ts\";\nimport type { ChildHandle, CommandPort, FilePort, HostPorts, HttpAnswer, NetPort, ProcessesPort, SpawnRequest, StopSignal } from \"./ports.ts\";\n\n/** These options go with the ports of Node. */\nexport interface NodeHostOptions {\n readonly logger?: Logger | undefined;\n /** This clock gives the time and the timers. The default is `realClock`. */\n readonly clock?: Clock | undefined;\n}\n\nconst codeOf = (error: unknown): string | undefined =>\n typeof error === \"object\" && error !== null && \"code\" in error ? String((error as { code: unknown }).code) : undefined;\n\nconst missing = (error: unknown): boolean => codeOf(error) === \"ENOENT\";\n\nconst nodeCommands: CommandPort = {\n run: (file, args, options = {}) =>\n new Promise((resolve) => {\n execFile(\n file,\n [...args],\n { ...(options.cwd === undefined ? {} : { cwd: options.cwd }), timeout: options.timeout ?? 0, windowsHide: true, encoding: \"utf8\", maxBuffer: 16 * 1024 * 1024 },\n (error, stdout, stderr) => {\n const out = `${stdout}${stderr}`;\n if (error === null) {\n resolve({ code: 0, out });\n return;\n }\n if (missing(error)) resolve({ code: 127, out: error.message });\n else if (error.killed === true && options.timeout !== undefined) resolve({ code: 124, out });\n else resolve({ code: typeof error.code === \"number\" ? error.code : 1, out: out === \"\" ? error.message : out });\n },\n );\n }),\n};\n\nlet serial = 0;\n\nconst nodeFiles: FilePort = {\n async read(path) {\n try {\n return await readFile(path, \"utf8\");\n } catch (error) {\n if (missing(error)) return null;\n throw error;\n }\n },\n async write(path, data) {\n await mkdir(dirname(path), { recursive: true });\n serial += 1;\n const temporary = `${path}.${process.pid}.${serial}.tmp`;\n await writeFile(temporary, data);\n try {\n await rename(temporary, path);\n } catch (error) {\n await rm(temporary, { force: true });\n throw error;\n }\n },\n async create(path, data) {\n await mkdir(dirname(path), { recursive: true });\n try {\n await writeFile(path, data, { flag: \"wx\" });\n return true;\n } catch (error) {\n if (codeOf(error) === \"EEXIST\") return false;\n throw error;\n }\n },\n async append(path, data) {\n await mkdir(dirname(path), { recursive: true });\n await appendFile(path, data);\n },\n async size(path) {\n try {\n return (await stat(path)).size;\n } catch (error) {\n if (missing(error)) return null;\n throw error;\n }\n },\n rename: (from, to) => rename(from, to),\n remove: (path) => rm(path, { force: true }),\n};\n\n/** This difference is the time from the start of the Windows file time (1601) to the start of the epoch (1970), in milliseconds. */\nconst FILETIME_EPOCH_MS = 11_644_473_600_000n;\n\n/**\n * This limit is the longest time of the query of a start time on Windows, in milliseconds. A cold start of PowerShell\n * on a loaded host can take more than 10 seconds (SYS-47). After the limit the start time is null, and the lock then\n * counts a live process ID as its owner. Thus a short limit can hold a stale lock, and the limit is wide.\n */\nconst WINDOWS_START_LIMIT_MS = 30_000;\n\n/** This function gives the start time of a Windows process from PowerShell, in milliseconds after the epoch, or null. */\nconst windowsStart = async (pid: number): Promise<number | null> => {\n const result = await nodeCommands.run(\n \"powershell.exe\",\n [\"-NoProfile\", \"-NonInteractive\", \"-Command\", `(Get-Process -Id ${pid} -ErrorAction Stop).StartTime.ToFileTimeUtc()`],\n { timeout: WINDOWS_START_LIMIT_MS },\n );\n const text = result.out.trim();\n if (result.code !== 0 || !/^\\d+$/.test(text)) return null;\n return Number(BigInt(text) / 10_000n - FILETIME_EPOCH_MS);\n};\n\n/** This count is the number of clock ticks in one second on Linux. It is 100 on each common kernel. */\nconst LINUX_TICKS = 100;\n\n/** This function gives the start time of a Linux process from `/proc`, in milliseconds after the epoch, or null. */\nconst linuxStart = async (pid: number): Promise<number | null> => {\n const record = await readFile(`/proc/${pid}/stat`, \"utf8\");\n // the name of the program is in parentheses and can have spaces: the fields start after the last \")\"\n const fields = record.slice(record.lastIndexOf(\")\") + 2).split(\" \");\n const ticks = Number(fields[19]);\n const boot = /^btime (\\d+)$/m.exec(await readFile(\"/proc/stat\", \"utf8\"));\n if (!Number.isFinite(ticks) || boot === null) return null;\n return Number(boot[1]) * 1000 + (ticks * 1000) / LINUX_TICKS;\n};\n\nconst sendSignal = (pid: number, signal: StopSignal | 0): boolean => {\n try {\n return process.kill(pid, signal);\n } catch {\n return false;\n }\n};\n\nconst nodeSpawn = (request: SpawnRequest): ChildHandle => {\n const outputs: Array<(stream: \"stdout\" | \"stderr\", chunk: string | Uint8Array) => void> = [];\n const exits: Array<(code: number | null, signal: string | null) => void> = [];\n let end: { code: number | null; signal: string | null } | null = null;\n const finish = (code: number | null, signal: string | null): void => {\n if (end !== null) return;\n end = { code, signal };\n for (const handler of exits) handler(code, signal);\n };\n const child = spawnChild(request.program, [...request.args], {\n ...(request.cwd === undefined ? {} : { cwd: request.cwd }),\n env: { ...request.env },\n stdio: request.ipc ? [\"ignore\", \"pipe\", \"pipe\", \"ipc\"] : [\"ignore\", \"pipe\", \"pipe\"],\n // on Linux the child leads its own process group, thus the tree stop reaches each process under it\n detached: process.platform !== \"win32\",\n windowsHide: true,\n });\n child.stdout?.on(\"data\", (chunk: Uint8Array) => {\n for (const handler of outputs) handler(\"stdout\", chunk);\n });\n child.stderr?.on(\"data\", (chunk: Uint8Array) => {\n for (const handler of outputs) handler(\"stderr\", chunk);\n });\n child.on(\"error\", () => {\n if (child.pid === undefined) finish(null, null);\n });\n child.on(\"exit\", (code, signal) => finish(code, signal));\n return {\n pid: child.pid ?? null,\n ipc: request.ipc,\n onOutput(handler) {\n outputs.push(handler);\n },\n onExit(handler) {\n exits.push(handler);\n if (end !== null) handler(end.code, end.signal);\n },\n send(message) {\n if (!child.connected) return false;\n try {\n return child.send(message as Serializable);\n } catch {\n return false;\n }\n },\n };\n};\n\nconst nodeProcesses: ProcessesPort = {\n alive(pid) {\n try {\n process.kill(pid, 0);\n return true;\n } catch (error) {\n // a process of a different user is alive, and the signal does not go to it\n return codeOf(error) === \"EPERM\";\n }\n },\n async startOf(pid) {\n try {\n if (process.platform === \"win32\") return await windowsStart(pid);\n if (process.platform === \"linux\") return await linuxStart(pid);\n return null;\n } catch {\n return null;\n }\n },\n signal: (pid, signal) => sendSignal(pid, signal),\n signalGroup: (pid, signal) => process.platform !== \"win32\" && sendSignal(-pid, signal),\n spawn: nodeSpawn,\n};\n\n/**\n * This function sends a GET request that does not follow a redirect. The timeout also stops the\n * read of the body. The status read and the text read use it, thus they have one timeout.\n */\nconst get = (url: string, timeout: number): Promise<Response> => fetch(url, { signal: AbortSignal.timeout(timeout), redirect: \"manual\" });\n\n/**\n * This function reads the body of an answer up to `limit` bytes, and gives the status and the text.\n * At the limit, it cancels the body, and `complete` is false. The decoder keeps the bytes of a\n * character that two parts of the body split. The unit tests give it answers with no network.\n */\nexport const answerText = async (response: Response, limit: number): Promise<HttpAnswer> => {\n const reader = response.body?.getReader();\n if (reader === undefined) return { status: response.status, body: \"\", complete: true };\n const decoder = new TextDecoder();\n let body = \"\";\n let size = 0;\n for (;;) {\n const read = await reader.read();\n if (read.done) return { status: response.status, body: body + decoder.decode(), complete: true };\n if (size + read.value.byteLength > limit) {\n body += decoder.decode(read.value.subarray(0, limit - size));\n await reader.cancel();\n return { status: response.status, body, complete: false };\n }\n body += decoder.decode(read.value, { stream: true });\n size += read.value.byteLength;\n }\n};\n\nconst nodeNet: NetPort = {\n async httpStatus(url, timeout) {\n try {\n const response = await get(url, timeout);\n await response.body?.cancel();\n return response.status;\n } catch {\n return null;\n }\n },\n async httpText(url, timeout, limit) {\n try {\n return await answerText(await get(url, timeout), limit);\n } catch {\n return null;\n }\n },\n tcpConnect: (host, port, timeout) =>\n new Promise((resolve) => {\n const socket = connect({ host, port });\n const done = (open: boolean): void => {\n socket.destroy();\n resolve(open);\n };\n socket.setTimeout(timeout, () => done(false));\n socket.once(\"connect\", () => done(true));\n socket.once(\"error\", () => done(false));\n }),\n};\n\n/**\n * This function gives the host ports of Node: `child_process`, `fs/promises`, `net`, `fetch` and `process`.\n * Only a program uses it. A test gives `fakeHost()` of `./testing`, thus it starts no process and installs no task.\n */\nexport const nodeHostPorts = (options: NodeHostOptions = {}): HostPorts => {\n const user = (): string => {\n const name = userInfo().username;\n const domain = process.env[\"USERDOMAIN\"];\n return process.platform === \"win32\" && domain !== undefined && domain !== \"\" ? `${domain}\\\\${name}` : name;\n };\n return {\n platform: process.platform,\n commands: nodeCommands,\n files: nodeFiles,\n processes: nodeProcesses,\n net: nodeNet,\n clock: options.clock ?? realClock,\n wall: () => Date.now(),\n self: { pid: process.pid, startedAt: Math.round(Date.now() - process.uptime() * 1000) },\n env: process.env,\n homeDir: homedir(),\n user,\n ...(options.logger === undefined ? {} : { logger: options.logger }),\n };\n};\n"],"mappings":"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"}
|
package/build/http-client.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"http-client.js","names":["knob","t"],"sources":["../src/http-client/connection.ts","../src/http-client/meets.ts","../src/http-client/client.ts","../src/http-client/machine.ts","../src/http-client/starting.ts","../src/http-client/session.ts"],"sourcesContent":["import type { ClientSocket, Factory } from \"../client/core.ts\";\n\n/** An HTTP socket is the socket of a client in the core: the join of the prober and the bounded close read it. */\nexport type HttpSocket = ClientSocket;\n\n/** An HTTP response is a whole response: its status, its headers, and its whole body. */\nexport interface HttpResponse {\n readonly status: number;\n /** These are the headers of the response, by their names in lower case, as Node gives them. */\n readonly headers: Readonly<Record<string, string | readonly string[] | undefined>>;\n readonly body: Buffer;\n}\n\n/** An agent request is one request that the wrapper gives the agent. */\nexport interface AgentRequest {\n readonly host: string;\n readonly port: number;\n readonly method: string;\n readonly path: string;\n readonly headers: Readonly<Record<string, string>>;\n readonly body?: Uint8Array | undefined;\n}\n\n/**\n * These are the events of one request that the wrapper reads. The agent gives each one at most one\n * time. `connect` comes only for a new connection. A request on a free socket left the client when it got that socket.\n */\nexport interface AgentEvents {\n /** The agent gave the request a socket. `reused` is true for a socket from the free list (`req.reusedSocket`). */\n socket(socket: HttpSocket, reused: boolean): void;\n /** The new socket of the request connected. The request then leaves the client. */\n connect(): void;\n}\n\n/** An agent exchange is one request in the agent: the promise of its whole response, and the abort that destroys its socket. */\nexport interface AgentExchange {\n /** This promise resolves with the whole response, or rejects with the error of the request, the socket or the body. */\n readonly response: Promise<HttpResponse>;\n /** This method destroys the request and its socket. A request that waits for a socket leaves the queue of the agent. */\n abort(error: Error): void;\n}\n\n/**\n * An agent is the part of an `http.Agent` of Node that the wrapper uses, with `http.request` on it.\n * A fake for tests has each part too. Thus the wrapper does not load node:http until it connects.\n */\nexport interface HttpAgent {\n /** This method sends one request on the agent. */\n request(request: AgentRequest, events: AgentEvents): AgentExchange;\n /** This method gives each socket of the agent that is open: the busy ones and the free ones. */\n sockets(): readonly HttpSocket[];\n /** This method destroys each socket of the agent. A request on a socket then fails. */\n destroy(): void;\n}\n\n/**\n * These are the options that the wrapper gives `new http.Agent`. Each one comes from the declaration.\n * The wrapper sets each option that has an effect on a timer, thus no default of Node decides one.\n */\nexport interface HttpAgentOptions {\n readonly keepAlive: true;\n /**\n * This time is the free socket timer (`timeout`). The agent closes a free socket at the smaller of\n * this time and the hint of the server less `agentKeepAliveTimeoutBuffer`. 0 is no timer, and then the hint does not apply.\n */\n readonly timeout: number;\n /** This time is subtracted from the hint of the server (`Keep-Alive: timeout=…`). A hint at or below it gives no reuse. */\n readonly agentKeepAliveTimeoutBuffer: number;\n /** This time is the idle time of TCP keepalive. The agent always turns keepalive on, and Node truncates the time to whole seconds. */\n readonly keepAliveMsecs: number;\n /** This count is the most sockets for one origin. A request waits in the agent for a socket above it. */\n readonly maxSockets: number;\n /** This count is the most free sockets for one origin. */\n readonly maxFreeSockets: number;\n /** The agent gives the socket that was free last, as the global agent does. */\n readonly scheduling: \"lifo\";\n}\n\n/** An agent factory makes the agent of the client from its options. */\nexport type AgentFactory = Factory<HttpAgentOptions, HttpAgent>;\n\n/** These are the parts of `node:http` that the factory uses. The specifier is a value, thus the entry loads node:http only at the connect. */\ninterface NodeHttp {\n readonly Agent: new (options: HttpAgentOptions) => NodeAgent;\n request(options: object): NodeRequest;\n}\n\ninterface NodeAgent {\n readonly sockets: Readonly<Record<string, readonly HttpSocket[] | undefined>>;\n readonly freeSockets: Readonly<Record<string, readonly HttpSocket[] | undefined>>;\n destroy(): void;\n}\n\ninterface NodeSocket extends HttpSocket {\n readonly connecting: boolean;\n once(event: \"connect\", listener: () => void): unknown;\n}\n\ninterface NodeIncoming {\n readonly statusCode?: number | undefined;\n readonly headers: Readonly<Record<string, string | string[] | undefined>>;\n readonly complete: boolean;\n on(event: \"data\", listener: (chunk: Buffer) => void): unknown;\n on(event: \"end\" | \"close\", listener: () => void): unknown;\n on(event: \"error\", listener: (error: Error) => void): unknown;\n}\n\ninterface NodeRequest {\n readonly reusedSocket: boolean;\n on(event: \"socket\", listener: (socket: NodeSocket) => void): unknown;\n on(event: \"response\", listener: (response: NodeIncoming) => void): unknown;\n on(event: \"error\", listener: (error: Error) => void): unknown;\n end(body?: Uint8Array): void;\n destroy(error?: Error): void;\n}\n\n/**\n * This factory makes an `http.Agent` of Node. It loads node:http only when a client connects.\n * Each request goes through `http.request` with the agent. The response settles at the end of its body.\n * A body that ends before it is complete rejects the response.\n */\nexport const nodeAgent: AgentFactory = async (options) => {\n const specifier = \"node:http\";\n const http = (await import(specifier)) as NodeHttp;\n const agent = new http.Agent(options);\n const all = (lists: Readonly<Record<string, readonly HttpSocket[] | undefined>>): HttpSocket[] => Object.values(lists).flatMap((list) => list ?? []);\n return {\n request(request, events) {\n const req = http.request({ host: request.host, port: request.port, method: request.method, path: request.path, headers: request.headers, agent });\n const response = new Promise<HttpResponse>((resolve, reject) => {\n req.on(\"socket\", (socket) => {\n events.socket(socket, req.reusedSocket);\n if (socket.connecting) socket.once(\"connect\", () => events.connect());\n else if (!req.reusedSocket) events.connect();\n });\n req.on(\"response\", (incoming) => {\n const chunks: Buffer[] = [];\n incoming.on(\"data\", (chunk) => chunks.push(chunk));\n incoming.on(\"error\", reject);\n incoming.on(\"end\", () => resolve({ status: incoming.statusCode ?? 0, headers: incoming.headers, body: Buffer.concat(chunks) }));\n incoming.on(\"close\", () => {\n if (!incoming.complete) reject(new Error(\"the connection closed before the end of the body\"));\n });\n });\n req.on(\"error\", reject);\n });\n req.end(request.body);\n return { response, abort: (error) => req.destroy(error) };\n },\n sockets: () => [...all(agent.sockets), ...all(agent.freeSockets)],\n destroy: () => agent.destroy(),\n };\n};\n","import type { Detector, Meeting, Situation } from \"../client/meets.ts\";\nimport { WHAT, immediate, keepaliveAnswered, keepaliveReset, keepaliveSilent, kernelGiveUp } from \"../client/meets.ts\";\nimport type { HttpClientKnobs } from \"./client.ts\";\n\n/**\n * This function gives the manifestations that an HTTP client can meet, and the detectors of each,\n * from its knobs. The HTTP cells measured them on the agent of Node 24.21.0:\n * - The agent has no timer of a call, thus the timer of the wrapper finds each silent call in flight.\n * - The free socket timer closes an idle socket at `pool_idle_expiry` at most. Thus no request goes\n * later on a socket that went silent while it was free.\n * - A FIN on a busy socket fails the call with \"socket hang up\". A FIN on a free socket destroys it.\n */\nexport const httpClientMeetings = (name: string, knobs: HttpClientKnobs): Meeting[] => {\n const call: Detector = {\n by: \"request_timeout\",\n within: knobs.request_timeout,\n situation: \"in flight\",\n effect: `the timer of the wrapper ends the call as indeterminate, and ${name} destroys its socket`,\n };\n const idleExpiry = (situation: Situation): Detector => ({\n by: \"pool_idle_expiry\",\n within: knobs.pool_idle_expiry,\n situation,\n effect: \"the free socket timer of the agent closes the socket, and the next request opens a new socket\",\n });\n const giveUp = kernelGiveUp(knobs.retrans_giveup_time, \"the call fails as indeterminate\");\n const silent = (manifestation: \"blackhole\" | \"freeze-host\"): Meeting => ({\n manifestation,\n what: WHAT[manifestation],\n detectors: [call, giveUp, idleExpiry(\"idle\"), keepaliveSilent(knobs.keepalive_idle)],\n });\n return [\n {\n manifestation: \"rst\",\n what: WHAT.rst,\n detectors: [\n immediate(\"in flight\", \"the call fails with ECONNRESET as indeterminate, and the next request opens a new socket\"),\n idleExpiry(\"idle\"),\n keepaliveReset(knobs.keepalive_idle),\n ],\n },\n {\n manifestation: \"fin\",\n what: WHAT.fin,\n detectors: [\n immediate(\"in flight\", 'the call fails with \"socket hang up\" as indeterminate'),\n immediate(\"idle\", \"the agent destroys the free socket, and the next request opens a new socket\"),\n ],\n },\n silent(\"blackhole\"),\n silent(\"freeze-host\"),\n {\n manifestation: \"freeze-process\",\n what: WHAT[\"freeze-process\"],\n detectors: [call, idleExpiry(\"idle\"), keepaliveAnswered()],\n },\n {\n manifestation: \"app-stall\",\n what: \"the server holds its reply, for example in a slow handler, and its kernel stays up\",\n detectors: [call, idleExpiry(\"idle\"), keepaliveAnswered()],\n },\n ];\n};\n","import type { Extent, Quantity } from \"@mark1russell7/quantity\";\nimport type { CallContext } from \"../call-context.ts\";\nimport type { Cancel } from \"../clock.ts\";\nimport { realClock } from \"../clock.ts\";\nimport type { Attempt, CheckOptions, Client, ClientJoin, ClientKnobs, ClientOptions, ClientSpec, ClientStep, DialFn, SendOptions, Sent } from \"../client/core.ts\";\nimport {\n ageProblems,\n attachClient,\n clientBounds,\n clientProblems,\n clientRecorder,\n dialCheck,\n idleCloseProblem,\n inFlight,\n keepaliveOnProblems,\n localStateCheck,\n message,\n ms,\n notSent,\n operationTable,\n poolProblems,\n roundTripCheck,\n sendWithReissue,\n socketEnds,\n stepChecks,\n timeProblems,\n trackWithTimer,\n wholeProblems,\n withinBound,\n wrapperTimerProblems,\n zeroProblems,\n} from \"../client/core.ts\";\nimport type { Judge } from \"../client/dial.ts\";\nimport { authority, helloDial, statusLineJudge } from \"../client/dial.ts\";\nimport type { Dependency } from \"../description.ts\";\nimport type { DependencyHandle } from \"../lifecycle.ts\";\nimport type { Operation } from \"../operation.ts\";\nimport type { AgentExchange, AgentFactory, HttpAgent, HttpAgentOptions, HttpResponse, HttpSocket } from \"./connection.ts\";\nimport { nodeAgent } from \"./connection.ts\";\nimport { httpClientMeetings } from \"./meets.ts\";\n\n/**\n * These are the knobs of the client, each a time, by the names of the ordering law where the law\n * has them. The runtime has no defaults, thus each knob is necessary. The constant\n * `HTTP_CLIENT_STARTING_KNOBS` gives a declaration from the HTTP cells. The knobs that each client has come from the core.\n */\nexport interface HttpClientKnobs extends ClientKnobs {\n /** This time bounds the TCP connect of a new socket. The wrapper has this timer, because the agent has none. */\n readonly connect_bound: Quantity;\n /**\n * This time bounds each call: from its start until the end of the body of its response. It also\n * bounds the wait for a socket. The wrapper has this timer, because the agent has none.\n */\n readonly request_timeout: Quantity;\n /**\n * This time is the free socket timer of the agent (`timeout`). The agent closes a free socket at the\n * smaller of this time and the hint of the server less `hint_buffer`. It must be below `server_idle_close` (O01).\n */\n readonly pool_idle_expiry: Extent;\n /** This time is what the agent subtracts from the hint of the server (`agentKeepAliveTimeoutBuffer`). A hint at or below it gives no reuse. */\n readonly hint_buffer: Quantity;\n /**\n * This time is when the server closes an idle connection, after its response. A Node server closes\n * at `keepAliveTimeout` plus `keepAliveTimeoutBuffer`. \"infinite\" is a server that keeps an idle\n * connection with no bound. The client does not set it: `problems` compares it with `pool_idle_expiry` (O01).\n */\n readonly server_idle_close: Extent;\n /** This time is the idle time of TCP keepalive (`keepAliveMsecs`), in whole seconds. The agent always turns keepalive on. */\n readonly keepalive_idle: Extent;\n /** The agent does not replace a connection at an age, thus this knob must be \"infinite\". */\n readonly max_connection_age: Extent;\n /** This time bounds the close of the client: the wait for the calls in flight, then a destroy of each socket. */\n readonly close_bound: Quantity;\n}\n\n/** A check request is the request of the round-trip check, and of the first connection at the connect. */\nexport interface CheckRequest {\n readonly method: string;\n readonly path: string;\n}\n\n/**\n * This request asks about the server, not about a resource (RFC 9110 §9.3.7). Thus it changes no\n * state. A server that does not route it still answers with a status, and the status tells that it is alive.\n */\nexport const OPTIONS_STAR: CheckRequest = { method: \"OPTIONS\", path: \"*\" };\n\n/** An HTTP client spec is the declaration of one HTTP client: the origin that it connects to, its pool, and its knobs. */\nexport interface HttpClientSpec extends ClientSpec<HttpClientKnobs> {\n /** This count is the most sockets of the pool (`maxSockets`). It is also the most free sockets. */\n readonly pool: { readonly max: number };\n /** This request is the request of the round-trip check and of the first connection. Without it, the client uses `OPTIONS *`. */\n readonly check?: CheckRequest | undefined;\n /**\n * These operations add to the table of the client, or change it. The table names each method by\n * its idempotency in RFC 9110. A caller can name an operation of its own, for example a POST with an `Idempotency-Key`.\n */\n readonly operations?: Readonly<Record<string, Operation>> | undefined;\n}\n\n/** These options make a client. Without them, it uses the agent of Node, the real clock, and a dial with `OPTIONS *`. */\nexport interface HttpClientOptions extends ClientOptions<AgentFactory> {\n /**\n * With this call context, each request gets the headers of the active context of its caller, for\n * example `traceparent`. A header of the call with the same name stays. `callContext` of the entry `/otel` gives one.\n */\n readonly callContext?: CallContext | undefined;\n}\n\n/** An HTTP call is one request. A string body goes as UTF-8, with its `content-length`. */\nexport interface HttpCall {\n readonly method: string;\n readonly path: string;\n readonly headers?: Readonly<Record<string, string>> | undefined;\n readonly body?: string | Uint8Array | undefined;\n /** This name is the operation of the call in the table. Without it, the operation is the method. */\n readonly operation?: string | undefined;\n}\n\n/** An HTTP client is a dependency of a service: its declaration, its handle, its checks and its requests. */\nexport interface HttpClient extends Client<ClientStep, ClientJoin> {\n /** This text is the state of the client, as `HTTP_CLIENT_MACHINE` names it. */\n readonly status: string;\n /**\n * This method sends a request, and gives its outcome in three values. A whole response of each\n * status is `ok`. The client sends again only an idempotent operation, one time at most, after an\n * outcome that is not certain. The second try stays in the bound of the request.\n */\n request(call: HttpCall, options?: SendOptions): Promise<Sent<HttpResponse>>;\n}\n\n/**\n * These operations are the methods of HTTP, by their idempotency in RFC 9110 §9.2.2. A second\n * request of GET, HEAD, OPTIONS, TRACE, PUT or DELETE has the same effect as one. POST and PATCH do not.\n */\nexport const HTTP_OPERATIONS: Readonly<Record<string, Operation>> = {\n GET: { idempotent: true },\n HEAD: { idempotent: true },\n OPTIONS: { idempotent: true },\n TRACE: { idempotent: true },\n PUT: { idempotent: true },\n DELETE: { idempotent: true },\n POST: { idempotent: false },\n PATCH: { idempotent: false },\n};\n\n/** This function gives the problems of a spec: the knobs that the agent cannot use. */\nexport const specProblems = (name: string, spec: HttpClientSpec): string[] => {\n const { knobs } = spec;\n const problems = [\n ...timeProblems(name, knobs),\n // the agent has no timer of a connect or of a call\n ...wrapperTimerProblems(name, knobs, { connect_bound: \"a connect\", request_timeout: \"a call\" }),\n // the agent reads a timeout of 0 as no free socket timer, and then the hint of the server does not apply\n ...zeroProblems(name, \"the agent\", knobs, { bounded: [\"pool_idle_expiry\"] }),\n ...keepaliveOnProblems(name, knobs, \"the agent\"),\n // Node truncates the keepalive delay to whole seconds\n ...wholeProblems(name, knobs, { millis: [\"connect_bound\", \"request_timeout\", \"pool_idle_expiry\", \"hint_buffer\"], seconds: [\"keepalive_idle\"] }),\n ...poolProblems(name, { max: spec.pool.max, min: 0 }),\n ...ageProblems(name, knobs, \"the agent does not replace a connection at an age\"),\n ];\n if (!Number.isFinite(ms(knobs.hint_buffer))) problems.push(`${name}'s hint_buffer is not a finite time: the agent subtracts it from the hint of the server`);\n return problems;\n};\n\n/** This function gives the options of `new http.Agent` from a spec. Each timer of the agent comes from the declaration. */\nexport const agentOptions = (spec: HttpClientSpec): HttpAgentOptions => {\n const { knobs } = spec;\n return {\n keepAlive: true,\n timeout: ms(knobs.pool_idle_expiry),\n agentKeepAliveTimeoutBuffer: ms(knobs.hint_buffer),\n keepAliveMsecs: ms(knobs.keepalive_idle),\n maxSockets: spec.pool.max,\n maxFreeSockets: spec.pool.max,\n scheduling: \"lifo\",\n };\n};\n\n/** This function gives the bytes of the dial: `OPTIONS *` with the Host header, and a close after the answer. */\nexport const optionsRequest = (host: string, port: number): string => `OPTIONS * HTTP/1.1\\r\\nHost: ${authority(host, port)}\\r\\nConnection: close\\r\\n\\r\\n`;\n\n/** This judge reads the status line of the answer. Any status passes, because it tells that an HTTP server answered. */\nexport const statusJudge: Judge = statusLineJudge(() => null);\n\n/** This dial function opens a TCP connection, sends `OPTIONS *`, and waits for the status line. It changes no state on the server. */\nexport const httpDial: DialFn = (host, port, signal) => helloDial(optionsRequest(host, port), statusJudge)(host, port, signal);\n\n/**\n * This function makes an HTTP client, a dependency of a service over an `http.Agent` of Node.\n * - It sets each timer of the agent from the declaration. The agent sends no request again by itself,\n * and the client sends again only an idempotent operation of its table.\n * - Its call is a request until the end of the body of its response. The wrapper has a timer for the\n * connect and one for the call, because the agent has none.\n * - It tells the outcome of a call in three values. A request that did not get a connected socket\n * did not leave the client. A failure after that is not certain.\n * - It destroys the socket of each call that is not `ok`, thus no later request gets that socket.\n * - It records each new socket of the pool (D1). HTTP gives no id of a connection.\n *\n * The core of the clients gives the outcomes, the second try, the calls in flight and the timer of a\n * call. It also gives the bounded close and the checks. This entry gives what the agent does in its own way.\n */\nexport const httpClient = (name: string, spec: HttpClientSpec, options: HttpClientOptions = {}): HttpClient => {\n const problems = specProblems(name, spec);\n if (problems.length > 0) throw new Error(problems.join(\"; \"));\n const { knobs } = spec;\n const clock = options.clock ?? realClock;\n const create = options.create ?? nodeAgent;\n const dial = options.dial ?? httpDial;\n const operations = operationTable(HTTP_OPERATIONS, spec.operations);\n const requestTimeout = ms(knobs.request_timeout);\n const connectBound = ms(knobs.connect_bound);\n const check = spec.check ?? OPTIONS_STAR;\n\n let agent: HttpAgent | null = null;\n let status = \"none\";\n const joins: ClientJoin[] = [];\n // the calls that left the client: the close waits for them, in its bound\n const flight = inFlight();\n // the calls that did not leave the client: the close ends each one as not sent\n const waiting = new Set<(error: string) => void>();\n\n const emit = clientRecorder(options.record, clock, name);\n // the state of the client is the outcome of the last connect of a socket of its pool\n const record = (on: string, to: string = status, detail?: string): void => {\n const from = status;\n status = to;\n emit(from, to, on, detail);\n };\n const closing = (): boolean => status === \"closing\" || status === \"end\";\n\n /**\n * This function makes one try of a call. The try waits for a socket of the agent: a free one, or a\n * new one in `connect_bound`. A failure before the socket is ready is certain: the request did not\n * leave the client. After that, the try waits for the whole response in the rest of `request_timeout`.\n */\n const attempt = async (call: HttpCall, signal: AbortSignal | undefined): Promise<Attempt<HttpResponse>> => {\n const a = agent;\n if (a === null) return notSent(`${name} has not connected`);\n if (closing()) return notSent(`${name} is ${status}: the request did not leave the client`);\n if (signal?.aborted) return notSent(\"the caller aborted the request before it left the client\");\n const started = clock.now();\n const body = typeof call.body === \"string\" ? Buffer.from(call.body, \"utf8\") : call.body;\n const headers = { ...call.headers, ...(body === undefined ? {} : { \"content-length\": String(body.byteLength) }) };\n\n let socket: HttpSocket | undefined;\n let reused = false;\n let left = false;\n // true when the wrapper ended the try itself: the error of the agent that follows is not a failed connect\n let ending = false;\n let connectTimer: Cancel = () => {};\n let decide: (value: true | Attempt<never>) => void = () => {};\n const leaving = new Promise<true | Attempt<never>>((resolve) => {\n let decided = false;\n decide = (value) => {\n if (decided) return;\n decided = true;\n resolve(value);\n };\n });\n // a result of the agent that arrives before the try records it\n let deliver: ((value: Attempt<HttpResponse>, cause?: Error) => void) | null = null;\n let early: { readonly value: Attempt<HttpResponse>; readonly cause: Error | undefined } | null = null;\n let settled = false;\n const settleWith = (value: Attempt<HttpResponse>, cause?: Error): void => {\n if (deliver === null) early ??= { value, cause };\n else deliver(value, cause);\n };\n\n let exchange: AgentExchange | null = null;\n const stop = (text: string): void => {\n if (left) return;\n ending = true;\n connectTimer();\n exchange?.abort(new Error(text));\n decide(notSent(text));\n };\n const ready = (): void => {\n left = true;\n connectTimer();\n decide(true);\n };\n exchange = a.request(\n { host: spec.host, port: spec.port, method: call.method, path: call.path, headers, body },\n {\n socket(given, isReused) {\n socket = given;\n reused = isReused;\n if (isReused) {\n ready();\n return;\n }\n connectTimer = clock.after(connectBound, () => {\n if (left) return;\n record(\"connect.failed\", closing() ? status : \"failing\", \"no connection in connect_bound\");\n stop(\"no connection in connect_bound: the request did not leave the client\");\n });\n },\n connect() {\n const generation = joins.length + 1;\n joins.push({ generation, at: clock.now(), ...socketEnds(socket) });\n record(\"join\", closing() ? status : \"ready\", `socket ${generation}`);\n ready();\n },\n },\n );\n // the agent can fail a request in its queue or at its connect: it did not leave the client\n exchange.response.then(\n (response) => settleWith({ outcome: \"ok\", value: response }),\n (error: unknown) => {\n const cause = error instanceof Error ? error : new Error(message(error));\n if (!left) {\n connectTimer();\n if (!ending) record(\"connect.failed\", closing() ? status : \"failing\", message(error));\n decide(notSent(message(error)));\n return;\n }\n // the abort of the wrapper after the call settled is not a failure of the socket\n if (settled) return;\n // a reused socket that fails before the response: the server closed it, as in the keep-alive race\n if (reused) record(\"reuse.failed\", status, message(error));\n settleWith({ outcome: \"indeterminate\", error: message(error) }, cause);\n },\n );\n\n const abandoned = (): void => stop(\"the caller abandoned the request before it left the client\");\n signal?.addEventListener(\"abort\", abandoned, { once: true });\n const queued = clock.after(requestTimeout, () => stop(\"no socket in request_timeout: the request did not leave the client\"));\n waiting.add(stop);\n const got = await leaving;\n signal?.removeEventListener(\"abort\", abandoned);\n queued();\n waiting.delete(stop);\n if (got !== true) return got;\n\n const sent = exchange;\n return trackWithTimer<HttpResponse>(\n flight,\n clock,\n Math.max(0, requestTimeout - (clock.now() - started)),\n signal,\n \"the caller abandoned the request after it left the client\",\n \"no whole response in request_timeout: the server can have the request\",\n (settle) => {\n deliver = settle;\n if (early !== null) settle(early.value, early.cause);\n },\n (value, cause) => {\n settled = true;\n // the socket of a call that is not ok can hold a part of a response: it goes, and no later request gets it\n if (value.outcome !== \"ok\") sent.abort(cause ?? new Error(value.error));\n },\n );\n };\n\n const request = (given: HttpCall, sendOptions: SendOptions = {}): Promise<Sent<HttpResponse>> => {\n // the headers of the context of the caller, read now: each try of the call sends the same ones\n const call = options.callContext === undefined ? given : { ...given, headers: { ...options.callContext.headers(), ...given.headers } };\n const method = call.method.toUpperCase();\n const named = call.operation ?? method;\n return sendWithReissue({\n clock,\n bound: requestTimeout,\n operation: operations[named],\n options: sendOptions,\n attempt: (signal) => attempt({ ...call, method }, signal),\n onReissue: () => record(\"command.reissue\", status, named),\n });\n };\n\n const handle: DependencyHandle = {\n async connect(signal) {\n record(\"status.connecting\", \"connecting\");\n agent = await create(agentOptions(spec));\n if (signal.aborted) throw new Error(`${name}: the service stopped before the connect`);\n // the check request opens the first socket of the pool. A server that is down does not stop the\n // startup: the checks keep readiness tripped until a connect succeeds (readiness is earned)\n await request(check, { signal, reissue: false });\n },\n async close() {\n const a = agent;\n if (a === null || closing()) return;\n record(\"close.request\", \"closing\");\n for (const stop of [...waiting]) stop(\"the client closed before the request left\");\n // the agent has no close that waits: the client waits for its calls in flight, in its bound\n if (!(await withinBound(clock, ms(knobs.close_bound), flight.idle()))) {\n record(\"close.bound\");\n const open = a.sockets().length;\n flight.settleAll(\"the client closed with the request in flight\");\n a.destroy();\n record(\"close.destroy\", status, `open sockets: ${open}`);\n } else {\n // each free socket closes with a FIN\n a.destroy();\n }\n record(\"status.end\", \"end\");\n },\n };\n\n const declaration: Omit<Dependency, \"name\"> = {\n system: spec.system,\n knobs: {\n connect_bound: knobs.connect_bound,\n request_timeout: knobs.request_timeout,\n pool_idle_expiry: knobs.pool_idle_expiry,\n hint_buffer: knobs.hint_buffer,\n keepalive_idle: knobs.keepalive_idle,\n // the agent sends nothing on a free socket, thus its keepalive is the only refresh of an idle flow (O03)\n idle_refresh_interval: knobs.keepalive_idle,\n max_connection_age: knobs.max_connection_age,\n close_bound: knobs.close_bound,\n retrans_giveup_time: knobs.retrans_giveup_time,\n },\n operations,\n };\n\n const checks = (checkOptions: CheckOptions) =>\n stepChecks<ClientStep>(name, checkOptions, {\n // the outcome of the last connect of a socket, without a round trip\n \"local-state\": localStateCheck(() => status === \"ready\"),\n // the check request through the pool of the application. A status of 500 or more fails it\n \"round-trip\": roundTripCheck(async (sendOptions) => {\n const sent = await request(check, sendOptions);\n return sent.outcome === \"ok\" && sent.value.status >= 500\n ? { outcome: \"error\", error: `the server answered ${sent.value.status}`, reply: true, attempts: sent.attempts }\n : sent;\n }),\n // a new connection each time, with OPTIONS *\n dial: dialCheck(dial, spec.host, spec.port),\n });\n\n return {\n name,\n declaration,\n handle,\n meets: httpClientMeetings(name, knobs),\n get status() {\n return status;\n },\n joins,\n request,\n checks,\n attach: (svc, checkOptions) => attachClient(svc, name, declaration, handle, checks(checkOptions)),\n problems(description) {\n // O01: the pool must close an idle socket before the server does\n const idle = idleCloseProblem(name, knobs.pool_idle_expiry, knobs.server_idle_close);\n return [...clientProblems(name, description, clientBounds(knobs)), ...(idle === null ? [] : [idle])];\n },\n };\n};\n","import type { Machine } from \"@mark1russell7/algebra\";\nimport { clientKnob as knob, closeTimer, transition as t } from \"../client/machine.ts\";\n\n/** The states where the agent exists and serves. */\nconst SERVING = [\"connecting\", \"ready\", \"failing\"] as const;\nconst OPEN = [...SERVING, \"closing\"] as const;\n\n/**\n * The HTTP client of the service as a `mark1russell7.machine/1` document. It is the agent as the\n * wrapper sees it, not one socket: the document `node-http-agent` of `@mark1russell7/machines`\n * gives each socket of the agent. The state is the outcome of the last connect of a socket:\n * - `ready`: the last connect succeeded.\n * - `failing`: the last connect failed, or did not end in connect_bound. The agent does not connect\n * again by itself. The next request tries again.\n *\n * A free socket that the agent closes does not change the state. A request on a reused socket that\n * fails records `reuse.failed`, and the state stays. A test records the transitions of the client\n * and replays them against this document.\n */\nexport const HTTP_CLIENT_MACHINE: Machine = {\n format: \"mark1russell7.machine/1\",\n id: \"service.machine.http-client\",\n title: \"The HTTP client of the service, over an http.Agent of Node\",\n layer: \"driver\",\n version: \"0.1.0\",\n sources: [{ ref: \"packages/service/src/http-client (the client implements this document)\", rung: \"implemented\" }],\n states: {\n none: { initial: true, note: \"the client exists, and its agent does not\" },\n connecting: { note: \"the check request of the startup opens the first socket\" },\n ready: { note: \"the last connect succeeded. A dead free socket stays hidden until the free socket timer or a request meets it\" },\n failing: { note: \"the last connect failed. A request that waits for a socket of a full pool does not change the state\" },\n closing: { note: \"the client waits for its calls in flight in close_bound, then destroys each socket of the agent\" },\n end: { final: true, note: \"the service closed the client\" },\n },\n events: {\n \"status.connecting\": { kind: \"local\" },\n join: { kind: \"rx\", note: \"a new socket of the agent connected: the request on it leaves the client (D1)\" },\n \"connect.failed\": { kind: \"local\", note: \"a connect failed: its error, or connect_bound\" },\n \"reuse.failed\": { kind: \"rx\", note: \"a request on a free socket that the agent reused failed: the server closed that socket\" },\n \"command.reissue\": { kind: \"local\" },\n \"close.request\": { kind: \"local\" },\n \"close.bound\": { kind: \"timer\", note: \"a call in flight did not end in close_bound\" },\n \"close.destroy\": { kind: \"local\", note: \"the bound destroys each socket of the agent, and each call in flight is indeterminate\" },\n \"status.end\": { kind: \"local\" },\n },\n knobs: {\n connect_bound: knob(\"connect.bound\"),\n request_timeout: knob(\"request.bound\"),\n pool_idle_expiry: knob(\"timeout\"),\n hint_buffer: knob(\"agentKeepAliveTimeoutBuffer\"),\n keepalive_idle: knob(\"keepAliveMsecs\"),\n close_bound: knob(\"close.bound\"),\n },\n timers: {\n connect_timeout: {\n duration: { knob: \"connect_bound\", unit: \"s\" },\n arms: [\"enter:connecting\"],\n cancels: [\"join\", \"connect.failed\"],\n fires: \"connect.failed\",\n note: \"the timer of the wrapper on the connect of a new socket. The agent has no connect timer\",\n },\n close: closeTimer(),\n },\n transitions: [\n t(\"connect\", \"none\", \"status.connecting\", \"connecting\"),\n t(\"join\", [...SERVING], \"join\", \"ready\"),\n t(\"connect-failed\", [...SERVING], \"connect.failed\", \"failing\", { timer: \"connect_timeout\" }),\n // a request that is in flight at the close can still connect, or fail\n t(\"join-closing\", \"closing\", \"join\", \"closing\"),\n t(\"connect-failed-closing\", \"closing\", \"connect.failed\", \"closing\"),\n ...OPEN.map((state) => t(`reuse-failed-${state}`, state, \"reuse.failed\", state)),\n ...OPEN.map((state) => t(`reissue-${state}`, state, \"command.reissue\", state)),\n t(\"close\", [...SERVING], \"close.request\", \"closing\"),\n t(\"close-bound\", \"closing\", \"close.bound\", \"closing\", { timer: \"close\" }),\n t(\"close-destroy\", \"closing\", \"close.destroy\", \"closing\"),\n t(\"end\", \"closing\", \"status.end\", \"end\"),\n ],\n};\n","import { STARTING_POLL } from \"../client/core.ts\";\nimport type { Poll } from \"../timing.ts\";\nimport type { HttpClientKnobs } from \"./client.ts\";\n\n/**\n * This poll is the poll of the checks that `HTTP_CLIENT_STARTING_KNOBS` fits. It is `STARTING_POLL` of\n * the core: each 5 s with a jitter of 20 %, and a timeout of 4 s (B6, O12). The poll does not depend on the driver.\n */\nexport const HTTP_CLIENT_STARTING_POLL: Poll = STARTING_POLL;\n\n/**\n * These knobs are a declaration to start from. They come from what the HTTP cells measured on the\n * agent of Node 24.21.0 against a Node server at its defaults. The runtime has no defaults: a service gives\n * these knobs, or its own. Each value holds the borders that the cells measured:\n * - `connect_bound` 5 s: the connect timeout of DP44. The agent has no connect timer.\n * - `request_timeout` 9.5 s: in the slowest poll of 10 s (O13). The agent has no timer of a call.\n * A frozen server held the call of undici until its headersTimeout, at 10.187 s.\n * - `pool_idle_expiry` 4 s: the free socket timer. The agent then closes a free socket at 4 s, the\n * hint of 5 s less `hint_buffer`. That is below the idle close of the server.\n * - `hint_buffer` 1 s: the default of the agent.\n * - `server_idle_close` 6 s: a Node server closes an idle connection at its `keepAliveTimeout` of 5 s\n * plus its buffer of 1 s. The cells measured 6.0003 s. O01 then has a margin of 2 s.\n * - `keepalive_idle` 1 s: the default of the agent. Node truncates it to whole seconds.\n * - `max_connection_age` \"infinite\": the agent does not replace a connection at an age.\n * - `close_bound` 2 s: a call in flight behind a black hole holds its socket with no bound.\n * - `retrans_giveup_time` 924.6 s: the give-up of Linux at `tcp_retries2 = 15`.\n */\nexport const HTTP_CLIENT_STARTING_KNOBS: HttpClientKnobs = {\n connect_bound: { value: 5, unit: \"s\" },\n request_timeout: { value: 9.5, unit: \"s\" },\n pool_idle_expiry: { value: 4, unit: \"s\" },\n hint_buffer: { value: 1, unit: \"s\" },\n server_idle_close: { value: 6, unit: \"s\" },\n keepalive_idle: { value: 1, unit: \"s\" },\n max_connection_age: { value: \"infinite\", unit: \"s\" },\n close_bound: { value: 2, unit: \"s\" },\n retrans_giveup_time: { value: 924.6, unit: \"s\" },\n};\n","import type { Extent, Quantity } from \"@mark1russell7/quantity\";\nimport { quantity } from \"@mark1russell7/quantity\";\nimport type { Clock } from \"../clock.ts\";\nimport { realClock } from \"../clock.ts\";\nimport { ms, timeProblems, wrapperTimerProblems, zeroProblems } from \"../client/core.ts\";\nimport type { Heartbeat } from \"../heartbeat.ts\";\nimport { heartbeat } from \"../heartbeat.ts\";\n\n/**\n * These are the knobs of the session check of an HTTP/2 client. They have the names and the units of\n * the gRPC client, because the check is the same PING. The grpc-js driver ends its transport at the first PING with no ACK.\n */\nexport interface SessionCheckKnobs {\n /**\n * This time is the quiet interval of a session. A tick comes at each interval, and it sends a PING\n * when the session heard nothing since the last tick. \"infinite\" sends no PING.\n */\n readonly keepalive_time: Extent;\n /** This time bounds the ACK of each PING. With no ACK in it, the check closes the session. */\n readonly keepalive_timeout: Quantity;\n}\n\n/**\n * A session is the part of an HTTP/2 session that the check uses. A `ClientHttp2Session` of\n * `node:http2` has each member, thus the check does not load `node:http2`.\n */\nexport interface H2Session {\n /** This flag is true until the socket of the session connects. */\n readonly connecting: boolean;\n /** This method sends a PING. The callback gets null at the ACK, and an error otherwise. It gives false when the PING did not go. */\n ping(callback: (error: Error | null) => void): boolean;\n /** This method ends the session and each stream on it at once. */\n destroy(error?: Error): void;\n}\n\n/** A close is the part of the check that closed the session. */\nexport type SessionClose = \"stream timeout\" | \"no PING answer\";\n\n/** These options make a session check. */\nexport interface SessionCheckOptions {\n readonly knobs: SessionCheckKnobs;\n /**\n * True lets a quiet session with no stream get a PING, as the option of the gRPC client does.\n * The default is false: a server can refuse a PING with no stream (O26).\n */\n readonly keepaliveWithoutCalls?: boolean | undefined;\n /** This clock gives the ticks and the timeouts. The default is `realClock`. */\n readonly clock?: Clock | undefined;\n /** This function receives the close of the session by the check, with its cause. */\n readonly onClose?: ((cause: SessionClose) => void) | undefined;\n}\n\n/**\n * A session check closes an HTTP/2 session that stopped answering. The caller tells it of each\n * stream and of each frame from the peer. The next stream of the caller then opens a new session.\n */\nexport interface SessionCheck {\n /** This method tells the check that a stream started on the session. */\n opened(): void;\n /** This method tells the check that a stream ended with an answer or an error. */\n ended(): void;\n /** This method tells the check that a stream ended at its timeout. The check then closes the session. */\n timedOut(): void;\n /** This method tells the check that a frame came from the peer, for example a response or the SETTINGS of the peer. */\n heard(): void;\n /** This method stops the check, and the session stays. A second use does nothing. */\n stop(): void;\n /** This count is the streams in flight on the session. */\n readonly streams: number;\n /** This cause is why the check closed the session, or null while it did not. */\n readonly closed: SessionClose | null;\n}\n\n/** This code is on the error that ends each stream of a session that the check closes. */\nexport const SESSION_CHECK_CLOSE = \"ERR_SESSION_CHECK\";\n\n/**\n * This function starts the check of one HTTP/2 session. It has two parts:\n * - A stream that times out closes its session, and not only the stream. On HTTP/1.1, a request\n * that times out destroys its socket. On HTTP/2, the session is the connection.\n * - The heartbeat of the package sends a PING after a quiet interval. With no ACK in\n * `keepalive_timeout`, it closes the session.\n *\n * A session that has not connected cannot answer a PING. Thus its tick waits for the SETTINGS of the\n * peer through `heard()`, in `keepalive_timeout`.\n */\nexport const sessionCheck = (session: H2Session, options: SessionCheckOptions): SessionCheck => {\n const { knobs, keepaliveWithoutCalls = false, clock = realClock } = options;\n let streams = 0;\n let heardSince = false;\n let closed: SessionClose | null = null;\n\n const close = (cause: SessionClose, why: string): void => {\n if (closed !== null) return;\n closed = cause;\n beat.stop();\n session.destroy(Object.assign(new Error(`the session check closed the session: ${why}`), { code: SESSION_CHECK_CLOSE }));\n options.onClose?.(cause);\n };\n\n const beat: Heartbeat = heartbeat({\n interval: ms(knobs.keepalive_time),\n timeout: ms(knobs.keepalive_timeout),\n misses: 1,\n clock,\n due: () => {\n const quiet = !heardSince;\n heardSince = false;\n return closed === null && quiet && (keepaliveWithoutCalls || streams > 0);\n },\n ping: () => {\n // the answer of a session that connects is the SETTINGS of the peer, through heard()\n if (session.connecting) return undefined;\n return new Promise<boolean>((resolve) => {\n try {\n if (!session.ping((error) => resolve(error === null))) resolve(false);\n } catch {\n resolve(false);\n }\n });\n },\n onDead: () => close(\"no PING answer\", \"no PING ACK in keepalive_timeout\"),\n });\n\n return {\n opened() {\n streams += 1;\n },\n ended() {\n streams = Math.max(0, streams - 1);\n },\n timedOut() {\n streams = Math.max(0, streams - 1);\n close(\"stream timeout\", \"a stream timed out\");\n },\n heard() {\n heardSince = true;\n beat.answer();\n },\n stop() {\n beat.stop();\n },\n get streams() {\n return streams;\n },\n get closed() {\n return closed;\n },\n };\n};\n\n/**\n * This function gives the most time from the last frame of the peer to the close of a session by the\n * PING. The first quiet tick comes up to two intervals after that frame, and its PING then waits\n * `keepalive_timeout`. \"infinite\" is a check with no PING. Then only a stream timeout closes the session.\n */\nexport const sessionCheckDetection = (knobs: SessionCheckKnobs): Extent =>\n knobs.keepalive_time.value === \"infinite\"\n ? { value: \"infinite\", unit: \"s\" }\n : quantity((2 * ms(knobs.keepalive_time) + ms(knobs.keepalive_timeout)) / 1000, \"s\");\n\n/**\n * This function gives the problems of the knobs of a session check. Each knob is a time of zero or\n * more. `keepalive_time` is \"infinite\" for no PING, and not zero. `keepalive_timeout` is a finite time\n * above zero, because the check is the only bound of the PING.\n */\nexport const sessionCheckProblems = (name: string, knobs: SessionCheckKnobs): string[] => {\n const times = timeProblems(name, knobs);\n if (times.length > 0) return times;\n return [\n ...zeroProblems(name, \"the session check\", knobs, { open: [\"keepalive_time\"] }),\n ...wrapperTimerProblems(name, knobs, { keepalive_timeout: \"a PING\" }),\n ];\n};\n"],"mappings":"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"}
|