@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
|
@@ -1,488 +0,0 @@
|
|
|
1
|
-
import { s as Limiter } from "./policy-CBcK2XGg.js";
|
|
2
|
-
import { Extent, Quantity } from "@mark1russell7/quantity";
|
|
3
|
-
/**
|
|
4
|
-
* This type tells if an operation can go again after a failure. It is a property of the
|
|
5
|
-
* operation, not of the dependency. One Redis client sends a GET, which is safe to send again. It
|
|
6
|
-
* also sends an INCR, which counts two times when it goes again after a timeout. Each operation
|
|
7
|
-
* declares its idempotency:
|
|
8
|
-
* - `true`: a second issue has the same effect. Examples are an HTTP GET or PUT, a SELECT, a
|
|
9
|
-
* Redis GET or SET, and a write that the server removes when it is a copy.
|
|
10
|
-
* - `false`: the client does not send it again after it can have reached the server.
|
|
11
|
-
* - keyed: the server keeps a key for a window, as with an `Idempotency-Key` header, and it
|
|
12
|
-
* ignores a copy in that window. A copy after the window is a second operation. Thus the
|
|
13
|
-
* window is a timer, and it must be longer than all retries of the operation.
|
|
14
|
-
*/
|
|
15
|
-
type Idempotency = boolean | {
|
|
16
|
-
readonly key: string;
|
|
17
|
-
readonly window: Extent;
|
|
18
|
-
};
|
|
19
|
-
/** An operation is an endpoint that the service calls or serves, a command, or a query. */
|
|
20
|
-
interface Operation {
|
|
21
|
-
readonly idempotent: Idempotency;
|
|
22
|
-
}
|
|
23
|
-
/**
|
|
24
|
-
* This function tells if an operation can go again `since` its first issue. An idempotent
|
|
25
|
-
* operation can always go again, and other operations cannot. A keyed operation can go again
|
|
26
|
-
* while the server keeps its key.
|
|
27
|
-
*/
|
|
28
|
-
declare const mayReissue: (operation: Operation, since: Quantity) => boolean;
|
|
29
|
-
/** An exit signal is a signal that asks the process to stop: each one starts the shutdown. */
|
|
30
|
-
type ExitSignal = "SIGINT" | "SIGTERM" | "SIGQUIT";
|
|
31
|
-
/** These are the signals that the runtime handles. */
|
|
32
|
-
declare const EXIT_SIGNALS: readonly ExitSignal[];
|
|
33
|
-
/**
|
|
34
|
-
* A process trigger is an event of the process, other than a signal, that starts the shutdown. A
|
|
35
|
-
* declaration opts in to each one (`svc.trigger`):
|
|
36
|
-
* - `stdin-close`: the standard input ends or closes, as when the parent of a stdio child goes away.
|
|
37
|
-
* The process must read its input, as a stdio transport does, or Node does not see the end.
|
|
38
|
-
* - `ipc-close`: the IPC channel to the parent process closes.
|
|
39
|
-
* - `ipc-message`: a message on the IPC channel matches a declared shape. Windows cannot give a
|
|
40
|
-
* child a SIGTERM that the child can catch, thus a parent sends a message.
|
|
41
|
-
*/
|
|
42
|
-
type ProcessTrigger = "stdin-close" | "ipc-close" | "ipc-message";
|
|
43
|
-
/** These are the process triggers that a declaration can opt in to. */
|
|
44
|
-
declare const PROCESS_TRIGGERS: readonly ProcessTrigger[];
|
|
45
|
-
/** An exit trigger is an event that starts the shutdown: an exit signal, or a declared process trigger. */
|
|
46
|
-
type ExitTrigger = ExitSignal | ProcessTrigger;
|
|
47
|
-
/**
|
|
48
|
-
* An uncaught origin tells how an error that no code caught came to the process. It is an exception
|
|
49
|
-
* that no code caught, or a rejection of a promise that no code handled.
|
|
50
|
-
*/
|
|
51
|
-
type UncaughtOrigin = "uncaughtException" | "unhandledRejection";
|
|
52
|
-
/** These are the origins of the errors that the option `uncaught` of `run()` receives. */
|
|
53
|
-
declare const UNCAUGHT_ORIGINS: readonly UncaughtOrigin[];
|
|
54
|
-
/** This function tells if a number is an exit code of a process: a whole number from 0 to 255. */
|
|
55
|
-
declare const isExitCode: (code: number) => boolean;
|
|
56
|
-
/** This function tells if a trigger is an exit signal. A repeat signal obeys `onRepeatSignal`. */
|
|
57
|
-
declare const isExitSignal: (trigger: string) => trigger is ExitSignal;
|
|
58
|
-
/**
|
|
59
|
-
* A message shape is a value of JSON that a message of the IPC channel can match. A string, a
|
|
60
|
-
* number, a boolean or null matches an equal message. An object matches a message that has each of
|
|
61
|
-
* its fields, and each value of the field matches. An array matches an array of the same length, item by item.
|
|
62
|
-
*/
|
|
63
|
-
type MessageShape = string | number | boolean | null | readonly MessageShape[] | {
|
|
64
|
-
readonly [field: string]: MessageShape;
|
|
65
|
-
};
|
|
66
|
-
/** This function tells if a value is a message shape: a value of JSON, with no function and no undefined. */
|
|
67
|
-
declare const isMessageShape: (value: unknown) => value is MessageShape;
|
|
68
|
-
/** This function tells if a message of the IPC channel matches a shape. */
|
|
69
|
-
declare const matchesMessage: (shape: MessageShape, message: unknown) => boolean;
|
|
70
|
-
/**
|
|
71
|
-
* A process port is the part of the process that the runtime uses: its exit triggers, its output
|
|
72
|
-
* and its exit. The runtime owns the handlers, because Node as PID 1 without a handler ignores
|
|
73
|
-
* SIGTERM. Only the runtime ends the process, and library code does not. A test gives a fake port,
|
|
74
|
-
* sends triggers, and reads the exit code.
|
|
75
|
-
*/
|
|
76
|
-
interface ProcessPort {
|
|
77
|
-
/**
|
|
78
|
-
* This method adds a handler for a trigger, and gives the function that removes it. The runtime
|
|
79
|
-
* asks for a process trigger only when the declaration opts in to it. For `ipc-message`, the
|
|
80
|
-
* handler gets each message of the IPC channel, and the runtime matches it.
|
|
81
|
-
*/
|
|
82
|
-
on(trigger: ExitTrigger, handler: (message?: unknown) => void): () => void;
|
|
83
|
-
/**
|
|
84
|
-
* This method adds a handler for each error that no code caught, and gives the function that
|
|
85
|
-
* removes it. The runtime asks for it only when `run()` gets the option `uncaught`. A port without
|
|
86
|
-
* this method gets no handler, as the embedded port.
|
|
87
|
-
*/
|
|
88
|
-
onUncaught?(handler: (error: unknown, origin: UncaughtOrigin) => void): () => void;
|
|
89
|
-
/**
|
|
90
|
-
* This method writes each buffered line of the output, and its promise ends when the output is
|
|
91
|
-
* written. The stage `flush the output` uses it, in the cap of that stage.
|
|
92
|
-
*/
|
|
93
|
-
flush?(): Promise<void> | void;
|
|
94
|
-
/**
|
|
95
|
-
* This method keeps the process alive, and gives the function that releases it. The lifecycle
|
|
96
|
-
* holds its process from its start to its exit, as a listening socket does. Thus a process whose
|
|
97
|
-
* timers do not keep it alive does not end in the middle of its work. It keeps its teardown and its exit code.
|
|
98
|
-
*/
|
|
99
|
-
hold?(): () => void;
|
|
100
|
-
/** This method ends the process with a code: the code of the exit request, 1 after an error, or 0. */
|
|
101
|
-
exit(code: number): void;
|
|
102
|
-
}
|
|
103
|
-
/** A host stream is the part of a stream of Node that the port uses. */
|
|
104
|
-
interface HostStream {
|
|
105
|
-
readonly writable?: boolean;
|
|
106
|
-
readonly destroyed?: boolean;
|
|
107
|
-
readonly readableEnded?: boolean;
|
|
108
|
-
write(chunk: string, done: (error?: unknown) => void): boolean;
|
|
109
|
-
on(event: string, handler: () => void): unknown;
|
|
110
|
-
off(event: string, handler: () => void): unknown;
|
|
111
|
-
}
|
|
112
|
-
/** A process host is the part of the process of Node that the port uses. Its event `message` gives the message of the IPC channel. */
|
|
113
|
-
interface ProcessHost {
|
|
114
|
-
on(signal: string, handler: (message?: unknown) => void): unknown;
|
|
115
|
-
off(signal: string, handler: (message?: unknown) => void): unknown;
|
|
116
|
-
exit(code: number): unknown;
|
|
117
|
-
readonly stdin?: HostStream | undefined;
|
|
118
|
-
readonly stdout?: HostStream | undefined;
|
|
119
|
-
readonly stderr?: HostStream | undefined;
|
|
120
|
-
}
|
|
121
|
-
/**
|
|
122
|
-
* This function makes a process port on a host. `find` gives the host at each use, or undefined
|
|
123
|
-
* when the platform has no process. Then the use throws.
|
|
124
|
-
*/
|
|
125
|
-
declare const processPortOf: (find: () => ProcessHost | undefined) => ProcessPort;
|
|
126
|
-
/** This port is the process of Node. */
|
|
127
|
-
declare const nodeProcess: ProcessPort;
|
|
128
|
-
/** An embedded process port records the exit code of a lifecycle that does not own its process. */
|
|
129
|
-
interface EmbeddedProcess extends ProcessPort {
|
|
130
|
-
/** This code is the code of the exit request of the lifecycle, or null before that request. */
|
|
131
|
-
readonly exitCode: number | null;
|
|
132
|
-
/** This promise ends with the exit code when the lifecycle asks for its exit. */
|
|
133
|
-
readonly exited: Promise<number>;
|
|
134
|
-
}
|
|
135
|
-
/**
|
|
136
|
-
* This function gives a process port for a lifecycle in a process that another part owns. That
|
|
137
|
-
* part is a script, a test of an application, or a library entry. The port adds no handler of a signal or of
|
|
138
|
-
* a trigger, it does not hold the process, and its `exit` only records the code. The caller stops
|
|
139
|
-
* the lifecycle with `life.shutdown()`. A process with a service of its own gives its parts to
|
|
140
|
-
* that service, and does not use this port.
|
|
141
|
-
*/
|
|
142
|
-
declare const embeddedProcess: () => EmbeddedProcess;
|
|
143
|
-
/**
|
|
144
|
-
* A route pattern matches the routes of a controller that its exact routes do not name. A
|
|
145
|
-
* registry that changes while the service operates, for example a registry of procedures, thus
|
|
146
|
-
* needs no list of routes before the start. The syntax of a pattern:
|
|
147
|
-
* - `*` matches each text, also an empty text and a text with `/`. The pattern `*` alone matches
|
|
148
|
-
* each route.
|
|
149
|
-
* - `:name` matches a text of one character or more without `/`, and gives it in `params.name`.
|
|
150
|
-
* - Each other character matches itself.
|
|
151
|
-
*
|
|
152
|
-
* The declaration names the operations that a request of the pattern can be. Each operation
|
|
153
|
-
* declares its idempotency, as a route does. A function picks the operation of each request.
|
|
154
|
-
*/
|
|
155
|
-
interface RoutePattern {
|
|
156
|
-
readonly pattern: string;
|
|
157
|
-
/** These are the operations that a request of the pattern can be, by name. */
|
|
158
|
-
readonly operations: Readonly<Record<string, Operation>>;
|
|
159
|
-
}
|
|
160
|
-
/** A route request is what the function of a pattern gets for one request. */
|
|
161
|
-
interface RouteRequest {
|
|
162
|
-
readonly controller: string;
|
|
163
|
-
readonly route: string;
|
|
164
|
-
/** These are the texts of the `:name` parts of the pattern, by name. */
|
|
165
|
-
readonly params: Readonly<Record<string, string>>;
|
|
166
|
-
/** These are the texts of the `*` parts of the pattern, in their sequence. */
|
|
167
|
-
readonly wildcards: readonly string[];
|
|
168
|
-
/** This value is the detail that the transport gives with the request, or undefined. */
|
|
169
|
-
readonly detail: unknown;
|
|
170
|
-
}
|
|
171
|
-
/**
|
|
172
|
-
* An operation choice gives the name of the operation of one request: one of the operations that
|
|
173
|
-
* the pattern declares. Thus the function decides the idempotency of each request, and the
|
|
174
|
-
* declaration keeps each window of a keyed operation as data.
|
|
175
|
-
*/
|
|
176
|
-
type OperationOf = (request: RouteRequest) => string;
|
|
177
|
-
/**
|
|
178
|
-
* All policies have the same timing shape. A timing is a count of polls (a debounce) or a
|
|
179
|
-
* duration (a window), and each converts to the other. A long window is easier to read as a
|
|
180
|
-
* duration, and that is the only difference between the two.
|
|
181
|
-
*/
|
|
182
|
-
type Timing = {
|
|
183
|
-
readonly type: "debounce";
|
|
184
|
-
/** This interval is the time between two polls of the signal. */
|
|
185
|
-
readonly interval: Quantity;
|
|
186
|
-
/** This count is the number of failed polls in sequence before the policy fails. */
|
|
187
|
-
readonly failAfter: number;
|
|
188
|
-
/** This count is the number of passed polls in sequence before the policy recovers. */
|
|
189
|
-
readonly recoverAfter: number;
|
|
190
|
-
} | {
|
|
191
|
-
readonly type: "window";
|
|
192
|
-
/** This duration is how long the signal fails before the policy fails, on the monotonic clock. */
|
|
193
|
-
readonly failAfter: Quantity;
|
|
194
|
-
/** This duration is how long the signal passes before the policy recovers. Without it, the first pass recovers the policy. */
|
|
195
|
-
readonly recoverAfter?: Quantity | undefined;
|
|
196
|
-
};
|
|
197
|
-
/** A poll has an interval, a jitter as a fraction (±20 % is 0.2) and a timeout. */
|
|
198
|
-
interface Poll {
|
|
199
|
-
readonly interval: Quantity;
|
|
200
|
-
readonly jitter: number;
|
|
201
|
-
readonly timeout: Quantity;
|
|
202
|
-
}
|
|
203
|
-
/** A span is a range of times, from the earliest to the latest. */
|
|
204
|
-
interface Span {
|
|
205
|
-
readonly min: Quantity;
|
|
206
|
-
readonly max: Quantity;
|
|
207
|
-
}
|
|
208
|
-
/**
|
|
209
|
-
* This type tells how a failed step answers a poll.
|
|
210
|
-
* - An `"error"` step refuses at once.
|
|
211
|
-
* - A `"timeout"` step (a black hole) answers only when the timeout of the poll ends. Each poll
|
|
212
|
-
* makes a new call, and each call ends at its timeout. Thus the step is slower by that timeout,
|
|
213
|
-
* at the two ends of the span.
|
|
214
|
-
* - A `"hang"` step makes a use that does not end. The first poll fails at its timeout. While the
|
|
215
|
-
* use stays pending, the runtime does not start the check again, and each later poll fails at
|
|
216
|
-
* once. Thus a debounce of two polls or more fails as fast as on an error.
|
|
217
|
-
*/
|
|
218
|
-
type FailsBy = "error" | "timeout" | "hang";
|
|
219
|
-
/**
|
|
220
|
-
* This function gives the time that a policy takes to fail after its signal becomes bad. A
|
|
221
|
-
* debounce of N polls takes approximately N intervals, with the jitter. A window takes its
|
|
222
|
-
* duration, plus one interval at most for the poll that starts its sequence. A step that fails by
|
|
223
|
-
* a timeout adds the timeout of the poll. At 3 polls of 5 s ± 20 %, the latch fails in 8–18 s on
|
|
224
|
-
* an error, and in 12–22 s on a 4 s timeout. A step that hangs adds the timeout only where its
|
|
225
|
-
* first failure ends the sequence: a window, or a debounce of one poll.
|
|
226
|
-
*/
|
|
227
|
-
declare const failSpan: (timing: Timing, poll: Poll, by?: FailsBy) => Span;
|
|
228
|
-
/** This function gives the time that a policy takes to recover after its signal becomes good. */
|
|
229
|
-
declare const recoverSpan: (timing: Timing, poll: Poll) => Span;
|
|
230
|
-
/** This function gives the window that a debounce approximates: N polls of an interval fail after N intervals. */
|
|
231
|
-
declare const asWindow: (timing: Timing) => Timing;
|
|
232
|
-
/** This function gives the debounce that approximates a window on a poll: the polls that fit, rounded up. */
|
|
233
|
-
declare const asDebounce: (timing: Timing, poll: Poll) => Timing;
|
|
234
|
-
/**
|
|
235
|
-
* This function gives the most time that a heartbeat takes to find a silent peer, as an amount
|
|
236
|
-
* for the ordering law (`detectionTime`). An interval of "infinite" is a heartbeat that is off.
|
|
237
|
-
*/
|
|
238
|
-
declare const heartbeatDetection: (interval: Extent, timeout: Quantity, misses: number) => Extent;
|
|
239
|
-
/**
|
|
240
|
-
* This is the format of a service as data: what `describe()` exports, and nothing starts. The
|
|
241
|
-
* timer algebra and the ordering law read it. Each timer has a unit. Each knob comes from the
|
|
242
|
-
* declaration, because the runtime has no defaults. A bound that nobody gives is "no bound", not
|
|
243
|
-
* zero.
|
|
244
|
-
*/
|
|
245
|
-
declare const FORMAT = "mark1russell7.service/1";
|
|
246
|
-
/** A step is a step of a connection that a check examines. A check that skips a step cannot see a failure in it. */
|
|
247
|
-
type Step = "dial" | "local-state" | "round-trip" | "checkout" | "progress" | "topology" | "latency";
|
|
248
|
-
/** A gate is the policy that the failures of a check count toward. */
|
|
249
|
-
type Gate = "readiness" | "liveness";
|
|
250
|
-
/** A check is an active check: one signal, for one step of a connection. */
|
|
251
|
-
interface Check {
|
|
252
|
-
readonly name: string;
|
|
253
|
-
/** This name is the dependency that it examines, or null when it reads the state of the process. */
|
|
254
|
-
readonly dependency: string | null;
|
|
255
|
-
readonly step: Step;
|
|
256
|
-
/** This flag tells if it uses the connection of the application. A check on its own connection cannot see a failure of that connection. */
|
|
257
|
-
readonly ownConnection: boolean;
|
|
258
|
-
/** This gate is the policy that it controls, or null for a check that only reports. It has no default. */
|
|
259
|
-
readonly gates: Gate | null;
|
|
260
|
-
readonly poll: Poll;
|
|
261
|
-
/**
|
|
262
|
-
* These are the loops that mark the progress of a check of the step `progress`, and its stall
|
|
263
|
-
* time. Without a declaration, the check names no loops, and `lint()` does not compare its stall time.
|
|
264
|
-
*/
|
|
265
|
-
readonly marks?: ProgressMarks | undefined;
|
|
266
|
-
}
|
|
267
|
-
/**
|
|
268
|
-
* A progress mark declaration tells which loops mark the progress of a check, and how long the
|
|
269
|
-
* check waits for a mark. The check function fails when no loop marked in the stall time.
|
|
270
|
-
*/
|
|
271
|
-
interface ProgressMarks {
|
|
272
|
-
/** These are the names of the loops: a check (its poller) or a worker of the service. */
|
|
273
|
-
readonly loops: readonly string[];
|
|
274
|
-
/** This time is the most time from one mark to the next before the check fails. */
|
|
275
|
-
readonly stall: Quantity;
|
|
276
|
-
}
|
|
277
|
-
/**
|
|
278
|
-
* A dependency is something that the service uses, with its client. Its knobs have the names that
|
|
279
|
-
* the ordering law uses: `request_timeout`, `connect_bound`, `driver_writeoff_time`,
|
|
280
|
-
* `heartbeat_interval`, `client_retry_window`. Thus the law reads them without a translation.
|
|
281
|
-
*/
|
|
282
|
-
interface Dependency {
|
|
283
|
-
readonly name: string;
|
|
284
|
-
/** This identifier is the component in the corpus (`systems.component.postgresql`), or null when the corpus does not have it. */
|
|
285
|
-
readonly system: string | null;
|
|
286
|
-
readonly knobs: Readonly<Record<string, Extent>>;
|
|
287
|
-
/**
|
|
288
|
-
* These are the operations that the service does with it, by name (`GET /v1/forecast`, `INCR`).
|
|
289
|
-
* Each operation declares if it can go again. A dependency usually has the two kinds, thus a
|
|
290
|
-
* dependency has no idempotency of its own. An operation without a declaration does not go again.
|
|
291
|
-
*/
|
|
292
|
-
readonly operations: Readonly<Record<string, Operation>>;
|
|
293
|
-
}
|
|
294
|
-
/**
|
|
295
|
-
* A transport is something that takes work in: a server, a consumer or a worker. Each is a
|
|
296
|
-
* component with a state machine. The service is ready only while each transport takes work.
|
|
297
|
-
*/
|
|
298
|
-
interface Transport {
|
|
299
|
-
readonly name: string;
|
|
300
|
-
readonly kind: "server" | "consumer" | "worker";
|
|
301
|
-
/** These are its knobs, with the names of the law where the law has them: the `server_idle_close` of a server. */
|
|
302
|
-
readonly knobs: Readonly<Record<string, Extent>>;
|
|
303
|
-
}
|
|
304
|
-
/**
|
|
305
|
-
* A controller is a group of routes. It is ready only while the dependencies that it needs are
|
|
306
|
-
* ready. Each route declares if its callers can send it again. When the shutdown stops a request,
|
|
307
|
-
* an idempotent route answers 503, which a caller can retry. Other routes answer 500.
|
|
308
|
-
*/
|
|
309
|
-
interface Controller {
|
|
310
|
-
readonly name: string;
|
|
311
|
-
readonly requires: readonly string[];
|
|
312
|
-
readonly routes: Readonly<Record<string, Operation>>;
|
|
313
|
-
/**
|
|
314
|
-
* These patterns match the routes that `routes` does not name, in their sequence: the first
|
|
315
|
-
* pattern that matches a route gives its operations. Without a declaration, the controller has
|
|
316
|
-
* no patterns.
|
|
317
|
-
*/
|
|
318
|
-
readonly patterns?: readonly RoutePattern[] | undefined;
|
|
319
|
-
}
|
|
320
|
-
/** A coupling is a declared edge between two policies. The algebra checks its margin. */
|
|
321
|
-
interface Coupling {
|
|
322
|
-
readonly from: Gate;
|
|
323
|
-
readonly to: Gate;
|
|
324
|
-
readonly effect: "fails";
|
|
325
|
-
}
|
|
326
|
-
/** A phase is one step of the shutdown sequence, with a cap. Its owner adds it. */
|
|
327
|
-
interface Phase {
|
|
328
|
-
readonly name: string;
|
|
329
|
-
readonly cap: Quantity;
|
|
330
|
-
}
|
|
331
|
-
/**
|
|
332
|
-
* A repeat signal policy tells what an exit signal does while the shutdown runs:
|
|
333
|
-
* - `ignore`: the signal has no effect, and the shutdown continues.
|
|
334
|
-
* - `exit`: the process exits with the code 1 at once, as a second Ctrl-C does in a terminal.
|
|
335
|
-
*/
|
|
336
|
-
type RepeatSignal = "ignore" | "exit";
|
|
337
|
-
/**
|
|
338
|
-
* A cooperative floor is the earliest time of the cooperative abort in the drain:
|
|
339
|
-
* - `half`: half the cap of the drain. The work in flight gets half the drain at the least.
|
|
340
|
-
* - `none`: no floor. A window of the whole cap or more aborts the work at the start of the drain.
|
|
341
|
-
*/
|
|
342
|
-
type CooperativeFloor = "half" | "none";
|
|
343
|
-
/** These exit codes replace the code 0 of a clean shutdown, by the trigger of the shutdown. */
|
|
344
|
-
type ExitCodes = Readonly<Partial<Record<ExitTrigger, number>>>;
|
|
345
|
-
/**
|
|
346
|
-
* A message trigger is a message of the IPC channel that starts the shutdown, for the trigger
|
|
347
|
-
* `ipc-message`. With `as`, the message is that exit signal: it has its exit code and the policy of a
|
|
348
|
-
* repeat signal. Without `as`, the message is the trigger `ipc-message`.
|
|
349
|
-
*/
|
|
350
|
-
interface MessageTrigger {
|
|
351
|
-
/** This shape is the message that starts the shutdown, for example `"shutdown"`. */
|
|
352
|
-
readonly match: MessageShape;
|
|
353
|
-
/** This signal is the exit signal that the message replaces, for example `SIGTERM` on Windows. */
|
|
354
|
-
readonly as?: ExitSignal | undefined;
|
|
355
|
-
}
|
|
356
|
-
/** A service description is the whole graph of a service, as data. */
|
|
357
|
-
interface ServiceDescription {
|
|
358
|
-
readonly format: typeof FORMAT;
|
|
359
|
-
readonly name: string;
|
|
360
|
-
/** This flag tells if a part joined after the start. That part starts tripped, and the export is partial. */
|
|
361
|
-
readonly partial: boolean;
|
|
362
|
-
readonly transports: readonly Transport[];
|
|
363
|
-
readonly dependencies: readonly Dependency[];
|
|
364
|
-
readonly controllers: readonly Controller[];
|
|
365
|
-
readonly checks: readonly Check[];
|
|
366
|
-
/**
|
|
367
|
-
* These are the keyed limiters of the service, each with its key, its policy, its store and the
|
|
368
|
-
* bound on its keys. Without a declaration, the service has no limiters.
|
|
369
|
-
*/
|
|
370
|
-
readonly limiters?: readonly Limiter[] | undefined;
|
|
371
|
-
readonly policies: {
|
|
372
|
-
readonly readiness: Timing;
|
|
373
|
-
readonly liveness: Timing;
|
|
374
|
-
/** This duration is how long the service can take to start. The startup probe must agree with it. */
|
|
375
|
-
readonly startup: Quantity;
|
|
376
|
-
};
|
|
377
|
-
readonly couplings: readonly Coupling[];
|
|
378
|
-
readonly shutdown: {
|
|
379
|
-
readonly phases: readonly Phase[];
|
|
380
|
-
/** This window is how long before the end of the drain the cooperative abort occurs, or no bound. */
|
|
381
|
-
readonly cooperativeWindow: Extent;
|
|
382
|
-
/** This floor is the earliest time of the cooperative abort. Without a declaration, the floor is `half`. */
|
|
383
|
-
readonly cooperativeFloor?: CooperativeFloor | undefined;
|
|
384
|
-
/** This policy tells what a signal does while the shutdown runs. Each declaration gives it, because the runtime has no defaults. */
|
|
385
|
-
readonly onRepeatSignal: RepeatSignal;
|
|
386
|
-
/** These triggers start the shutdown, in addition to the exit signals. Each one is opt-in. */
|
|
387
|
-
readonly triggers?: readonly ProcessTrigger[] | undefined;
|
|
388
|
-
/** These messages of the IPC channel start the shutdown. The trigger `ipc-message` needs one at the least. */
|
|
389
|
-
readonly messages?: readonly MessageTrigger[] | undefined;
|
|
390
|
-
/** These codes replace the exit code 0 by the trigger. Without a code, a clean shutdown exits 0. */
|
|
391
|
-
readonly exitCodes?: ExitCodes | undefined;
|
|
392
|
-
};
|
|
393
|
-
}
|
|
394
|
-
/**
|
|
395
|
-
* A machine name names one machine of the runtime. Each machine has a document in `machines.ts`,
|
|
396
|
-
* which names the same states and events. The document of a client is with its client, for example
|
|
397
|
-
* `REDIS_CLIENT_MACHINE`.
|
|
398
|
-
*/
|
|
399
|
-
type MachineName = "gate" | "latch" | "window" | "poller" | "drain" | "exit" | "watchdog" | "client";
|
|
400
|
-
/**
|
|
401
|
-
* A lifecycle event is one transition of one machine of the runtime, on the monotonic clock. The
|
|
402
|
-
* runtime stamps each planned event: the gate, each phase of the drain, and the exit. Thus a
|
|
403
|
-
* window that a measurement times starts at the event.
|
|
404
|
-
*/
|
|
405
|
-
interface LifecycleEvent {
|
|
406
|
-
/** This time is when the transition occurred, in milliseconds on the monotonic clock. */
|
|
407
|
-
readonly at: number;
|
|
408
|
-
readonly machine: MachineName;
|
|
409
|
-
/** This name identifies one machine among others of its kind: a check, or the service. */
|
|
410
|
-
readonly instance: string;
|
|
411
|
-
readonly from: string;
|
|
412
|
-
readonly to: string;
|
|
413
|
-
readonly on: string;
|
|
414
|
-
/** This text gives more about the event, for example the cause of a failure. */
|
|
415
|
-
readonly detail?: string | undefined;
|
|
416
|
-
}
|
|
417
|
-
/** A recorder receives each lifecycle event. */
|
|
418
|
-
type Recorder = (event: LifecycleEvent) => void;
|
|
419
|
-
/** These are the levels of a log entry, from the least to the most severe. */
|
|
420
|
-
declare const LOG_LEVELS: readonly ["debug", "info", "warn", "error"];
|
|
421
|
-
type LogLevel = (typeof LOG_LEVELS)[number];
|
|
422
|
-
/** These fields are the structured data of a log entry, for example the machine and the cap of a phase. */
|
|
423
|
-
type LogFields = Readonly<Record<string, unknown>>;
|
|
424
|
-
/**
|
|
425
|
-
* A logger is the port that receives the log entries of the runtime. It has one method, thus an
|
|
426
|
-
* adapter to another logger is a few lines. For example, `{ log: (level, message, fields) => app[level](message, fields) }`.
|
|
427
|
-
*/
|
|
428
|
-
interface Logger {
|
|
429
|
-
log(level: LogLevel, message: string, fields: LogFields): void;
|
|
430
|
-
}
|
|
431
|
-
/** A log entry is one call of a logger, as a test logger keeps it. */
|
|
432
|
-
interface LogEntry {
|
|
433
|
-
readonly level: LogLevel;
|
|
434
|
-
readonly message: string;
|
|
435
|
-
readonly fields: LogFields;
|
|
436
|
-
}
|
|
437
|
-
/** This function tells if `level` is at `least` or more severe. */
|
|
438
|
-
declare const atLeast: (level: LogLevel, least: LogLevel) => boolean;
|
|
439
|
-
/** A console target has one method for each level, as the console of Node and of a browser has. */
|
|
440
|
-
type ConsoleTarget = Readonly<Record<LogLevel, (...data: unknown[]) => void>>;
|
|
441
|
-
/**
|
|
442
|
-
* A log format tells how the console logger writes an entry.
|
|
443
|
-
* - `text`: the message, and then the fields as an object, when the entry has fields.
|
|
444
|
-
* - `json`: one line of JSON for each entry, with the level, the message and each field.
|
|
445
|
-
*/
|
|
446
|
-
type LogFormat = "text" | "json";
|
|
447
|
-
/** These are the ids of the trace and of the span of a log entry, with the names of the OpenTelemetry log data model. */
|
|
448
|
-
interface TraceIds {
|
|
449
|
-
readonly trace_id: string;
|
|
450
|
-
readonly span_id: string;
|
|
451
|
-
}
|
|
452
|
-
/**
|
|
453
|
-
* A source of trace ids gives the ids of the active span, or nothing when no span is active. The
|
|
454
|
-
* entry `@mark1russell7/service/otel` has one on the API of OpenTelemetry: `traceIds`.
|
|
455
|
-
*/
|
|
456
|
-
type TraceIdsSource = () => TraceIds | undefined;
|
|
457
|
-
/** These options make the console logger. */
|
|
458
|
-
interface ConsoleLoggerOptions {
|
|
459
|
-
/** This level is the least severe level that the logger writes. The default is `info`. */
|
|
460
|
-
readonly level?: LogLevel | undefined;
|
|
461
|
-
/** This target receives each entry. The default is the global console. */
|
|
462
|
-
readonly console?: ConsoleTarget | undefined;
|
|
463
|
-
/** This format tells how the logger writes each entry. The default is `text`. */
|
|
464
|
-
readonly format?: LogFormat | undefined;
|
|
465
|
-
/**
|
|
466
|
-
* This source gives the trace ids of each entry. The logger adds them to the fields, but a field
|
|
467
|
-
* of the entry with the same name stays. With no source, or when the source gives nothing, the
|
|
468
|
-
* entry does not change.
|
|
469
|
-
*/
|
|
470
|
-
readonly traceIds?: TraceIdsSource | undefined;
|
|
471
|
-
}
|
|
472
|
-
/**
|
|
473
|
-
* This function makes the console logger. It writes each entry at its level or more severe to the
|
|
474
|
-
* method of that level. In the format `text`, it writes the message first and then the fields. In
|
|
475
|
-
* the format `json`, it writes one line of JSON.
|
|
476
|
-
*/
|
|
477
|
-
declare const consoleLogger: (options?: ConsoleLoggerOptions) => Logger;
|
|
478
|
-
/**
|
|
479
|
-
* This function makes a recorder that writes each lifecycle event to a logger. Thus the logger is
|
|
480
|
-
* one sink of the same stream as the recorder, not a second set of calls. The levels are these:
|
|
481
|
-
* - `error`: each error of the lifecycle, and an exit at once on a repeat signal.
|
|
482
|
-
* - `warn`: a phase at its cap, a failed startup, a startup over its budget, a tripped latch and a blocked event loop.
|
|
483
|
-
* - `info`: each step of the startup, the start and the end of each phase, the exit, and each recovery.
|
|
484
|
-
* - `debug`: each other transition, for example each poll of a check.
|
|
485
|
-
* With the description, the entry of a phase also gives its cap. A failure of the logger does not stop the lifecycle.
|
|
486
|
-
*/
|
|
487
|
-
declare const logEvents: (logger: Logger, description?: ServiceDescription) => Recorder;
|
|
488
|
-
export { ProcessTrigger as $, Step as A, recoverSpan as B, FORMAT as C, ProgressMarks as D, Phase as E, Timing as F, EmbeddedProcess as G, RoutePattern as H, asDebounce as I, HostStream as J, ExitSignal as K, asWindow as L, FailsBy as M, Poll as N, RepeatSignal as O, Span as P, ProcessPort as Q, failSpan as R, ExitCodes as S, MessageTrigger as T, RouteRequest as U, OperationOf as V, EXIT_SIGNALS as W, PROCESS_TRIGGERS as X, MessageShape as Y, ProcessHost as Z, Check as _, LogFields as a, isMessageShape as at, Coupling as b, Logger as c, processPortOf as ct, atLeast as d, mayReissue as dt, UNCAUGHT_ORIGINS as et, consoleLogger as f, Recorder as g, MachineName as h, LogEntry as i, isExitSignal as it, Transport as j, ServiceDescription as k, TraceIds as l, Idempotency as lt, LifecycleEvent as m, ConsoleTarget as n, embeddedProcess as nt, LogFormat as o, matchesMessage as ot, logEvents as p, ExitTrigger as q, LOG_LEVELS as r, isExitCode as rt, LogLevel as s, nodeProcess as st, ConsoleLoggerOptions as t, UncaughtOrigin as tt, TraceIdsSource as u, Operation as ut, Controller as v, Gate as w, Dependency as x, CooperativeFloor as y, heartbeatDetection as z };
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"machine-BhVeHr_m.js","names":["dialTcp"],"sources":["../src/client/meets.ts","../src/client/core.ts","../src/client/dial.ts","../src/client/machine.ts"],"sourcesContent":["// The manifestations that a client can meet, and their detectors (E9). The shapes, the two queries,\n// the detectors of the kernel and the words of each manifestation are the same for each client.\n// Each client entry gives its own list of meetings, because the timers of each driver differ.\n\nimport type { Extent, Quantity } from \"@mark1russell7/quantity\";\nimport { quantity, valueIn } from \"@mark1russell7/quantity\";\n\n/** A situation is what the connection did when the failure started: a command in flight, or idle. */\nexport type Situation = \"in flight\" | \"idle\";\n\n/** A detector is a mechanism that finds a failure, and the most time that it takes. */\nexport interface Detector {\n /** This name identifies the mechanism: a knob of the declaration, or the kernel. */\n readonly by: string;\n /** This time is the most that the detector takes, after the failure starts. \"infinite\" tells that it does not find the failure. */\n readonly within: Extent;\n readonly situation: Situation;\n /** This text tells what the detector does, for example that it fails a command without a change of state. */\n readonly effect: string;\n}\n\n/**\n * A meeting is a manifestation that the client can meet, and its detectors (E9). The names of the\n * manifestations are the names of the vocabulary of the harness and the corpus. `app-stall` is a\n * server whose process is alive and does not answer, a proposal of the vocabulary.\n */\nexport interface Meeting {\n readonly manifestation: string;\n /** This text tells the failure in words. */\n readonly what: string;\n readonly detectors: readonly Detector[];\n}\n\n/** These are the manifestations that each client gives a meeting for, in this sequence. */\nexport const MANIFESTATIONS = [\"rst\", \"fin\", \"blackhole\", \"freeze-host\", \"freeze-process\", \"app-stall\"] as const;\n\n/** A manifestation is one name of `MANIFESTATIONS`. */\nexport type Manifestation = (typeof MANIFESTATIONS)[number];\n\n/**\n * These words tell each manifestation that does not depend on the driver. The words of `app-stall`\n * name an example, and the example is a fact of each server, thus each client gives them.\n */\nexport const WHAT: Readonly<Record<Exclude<Manifestation, \"app-stall\">, string>> = {\n rst: \"the server answers each segment with a reset, and refuses each new connection\",\n fin: \"the process of the server ends, and its kernel closes the connection\",\n blackhole: \"the network drops each segment in the two directions\",\n \"freeze-host\": \"the host of the server stops, without a close: the death without a close\",\n \"freeze-process\": \"the process of the server stops, and its kernel stays up\",\n};\n\n/** This amount is a detector that does not find the failure. */\nexport const NEVER: Extent = { value: \"infinite\", unit: \"s\" };\n\nconst s = (value: number): Quantity => quantity(Math.round(value * 1e6) / 1e6, \"s\");\nconst seconds = (amount: Extent): number =>\n amount.value === \"infinite\" ? Number.POSITIVE_INFINITY : valueIn(amount as Quantity, \"s\");\n\n/** Node gives keepalive 10 probes, 1 s apart, after its idle time: a silent peer is found 10 s after the idle time. */\nconst NODE_PROBES = 10;\nconst NODE_INTERVAL = 1;\n\n/** This function gives the time at which Node's TCP keepalive gives up a silent peer: the idle time, then 10 probes 1 s apart. */\nexport const keepaliveGiveUp = (idle: Extent): Extent => (idle.value === \"infinite\" ? NEVER : s(seconds(idle) + NODE_PROBES * NODE_INTERVAL));\n\n/** This detector is a segment that arrives at once: a reset or a FIN. */\nexport const immediate = (situation: Situation, effect: string): Detector => ({ by: \"the next segment\", within: s(0), situation, effect });\n\n/** This detector is TCP keepalive on a silent peer. It gives up after its probes, and the socket closes. */\nexport const keepaliveSilent = (idle: Extent): Detector => ({\n by: \"keepalive_idle\",\n within: keepaliveGiveUp(idle),\n situation: \"idle\",\n effect: \"TCP keepalive gives up, and the socket closes\",\n});\n\n/** This detector is TCP keepalive on a peer whose kernel stays up. That kernel answers each probe, thus keepalive does not find the failure. */\nexport const keepaliveAnswered = (): Detector => ({\n by: \"keepalive_idle\",\n within: NEVER,\n situation: \"idle\",\n effect: \"the kernel of the server answers each probe\",\n});\n\n/** This detector is TCP keepalive on a peer that resets: the first probe gets the reset. */\nexport const keepaliveReset = (idle: Extent): Detector => ({\n by: \"keepalive_idle\",\n within: idle.value === \"infinite\" ? NEVER : idle,\n situation: \"idle\",\n effect: \"the first probe gets a reset\",\n});\n\n/** This detector is the kernel, which gives up the retransmissions of a segment in flight. A driver can add what follows. */\nexport const kernelGiveUp = (within: Extent, after?: string): Detector => ({\n by: \"retrans_giveup_time\",\n within,\n situation: \"in flight\",\n effect: `the kernel gives up the retransmissions and closes the socket${after === undefined ? \"\" : `, and ${after}`}`,\n});\n\n/** This function gives the first detector of a manifestation in a situation, or null when no detector has an end (C3). */\nexport const firstDetector = (meeting: Meeting, situation: Situation): Detector | null => {\n const ranked = meeting.detectors\n .filter((detector) => detector.situation === situation && detector.within.value !== \"infinite\")\n .sort((a, b) => seconds(a.within) - seconds(b.within));\n return ranked[0] ?? null;\n};\n\n/** This function gives each manifestation and situation that no detector of the client finds: the standing rule, as a query (C3, E9). */\nexport const unwatched = (meets: readonly Meeting[]): Array<{ readonly manifestation: string; readonly situation: Situation }> =>\n meets.flatMap((meeting) =>\n ([\"in flight\", \"idle\"] as const).flatMap((situation) =>\n firstDetector(meeting, situation) === null ? [{ manifestation: meeting.manifestation, situation }] : [],\n ),\n );\n","// The parts of a client wrapper that do not change from one client to the next. Each client entry\n// (`./redis`, `./pg`, `./http-client`, `./websocket`, and each later client of S1) fills them in with its driver. The core gives\n// the shapes of a client, the outcome of a call in three values, the rule that sends a call again,\n// the record of the calls in flight, the bounded close, the checks of the steps of a connection,\n// and the problems of a spec and of a client in a description. It loads only quantity.\n// The section \"Unified or separate\" of docs/S6.md gives each part, and the reason for each part that stays in a driver.\n\nimport type { Extent, Quantity } from \"@mark1russell7/quantity\";\nimport { quantity, valueIn } from \"@mark1russell7/quantity\";\nimport type { Backoff } from \"../backoff.ts\";\nimport { retrierOn } from \"../retrier.ts\";\nimport type { ServiceBuilder } from \"../builder.ts\";\nimport type { Cancel, Clock } from \"../clock.ts\";\nimport type { Check, Dependency, Gate, ServiceDescription, Step } from \"../description.ts\";\nimport type { Recorder } from \"../events.ts\";\nimport type { Outcome } from \"../latch.ts\";\nimport type { DependencyHandle } from \"../lifecycle.ts\";\nimport type { Operation } from \"../operation.ts\";\nimport { mayReissue } from \"../operation.ts\";\nimport type { CheckFn } from \"../poller.ts\";\nimport type { Poll } from \"../timing.ts\";\nimport type { Meeting } from \"./meets.ts\";\n\n/**\n * A sent result is the outcome of a call, in three values (C8):\n * - `ok`: the server answered.\n * - `error`: the call did not apply. The server answered with an error (`reply`), or the call did\n * not leave the client.\n * - `indeterminate`: the call can have reached the server, and nothing tells if it applied.\n */\nexport type Sent<T> =\n | { readonly outcome: \"ok\"; readonly value: T; readonly attempts: number }\n | { readonly outcome: \"error\"; readonly error: string; readonly reply: boolean; readonly attempts: number }\n | { readonly outcome: \"indeterminate\"; readonly error: string; readonly attempts: number };\n\n/** This type is the outcome of one try of a call, before the core counts the tries. */\nexport type Attempt<T = unknown> =\n | { readonly outcome: \"ok\"; readonly value: T }\n | { readonly outcome: \"error\"; readonly error: string; readonly reply: boolean }\n | { readonly outcome: \"indeterminate\"; readonly error: string };\n\n/** Send options tell how the client sends one call. */\nexport interface SendOptions {\n /** This signal abandons the call. A call that left the client is then indeterminate. */\n readonly signal?: AbortSignal | undefined;\n /** False stops the client: it does not send the call again. A check that must fail at once uses it. */\n readonly reissue?: boolean | undefined;\n}\n\n/** A dial function opens a new connection to the server, and reads one reply of the protocol. The `dial` check uses it. */\nexport type DialFn = (host: string, port: number, signal: AbortSignal) => Promise<void>;\n\n/** The steps of a connection that each client gives a check for (B14). A client can add more steps. */\nexport type ClientStep = Extract<Step, \"dial\" | \"round-trip\" | \"local-state\">;\n\n/** Check options tell which checks the client gives the health runtime, and which policy each one controls. */\nexport interface CheckOptions<S extends Step = ClientStep> {\n readonly poll: Poll;\n /** For each step, the policy that its check controls, or null for a check that only reports. A step that is absent has no check. */\n readonly steps: Partial<Record<S, Gate | null>>;\n /**\n * With a catalog, the client gives a check for each step that it has (B19). The steps of `steps` are\n * the nominated checks. Each other step reports only, and polls at the catalog poll. `true` is a poll\n * of 30 s with the jitter and the timeout of `poll`. A nominated step that the client has no check\n * for then fails the attach. Without a catalog, the client gives only the steps of `steps`.\n */\n readonly catalog?: true | Poll | undefined;\n}\n\n/** This interval is the poll of a catalog check that gates nothing (B19). */\nexport const CATALOG_INTERVAL: Quantity = quantity(30, \"s\");\n\n/** A step check is the function of one step, and if it uses the connection of the application. */\nexport interface StepCheck {\n readonly ownConnection: boolean;\n readonly run: CheckFn;\n}\n\n/** This function gives an amount in milliseconds. \"infinite\" is `Infinity`. */\nexport const ms = (amount: Extent): number =>\n amount.value === \"infinite\" ? Number.POSITIVE_INFINITY : valueIn(amount as Quantity, \"ms\");\n\n/** This function gives an amount in milliseconds, or undefined for \"infinite\". Each driver then writes its own form of \"no timer\". */\nexport const finiteMs = (amount: Extent): number | undefined => {\n const value = ms(amount);\n return Number.isFinite(value) ? value : undefined;\n};\n\n/** This function gives the text of an error. */\nexport const message = (error: unknown): string => (error instanceof Error ? error.message : String(error));\n\n/**\n * These are the knobs that each client has, by the names of the ordering law. Each driver adds its\n * own knobs. The comments of each driver tell which option of the driver a knob sets.\n */\nexport interface ClientKnobs {\n /** This time bounds a new connection. */\n readonly connect_bound: Quantity;\n /** This time bounds each call on the connection of the application. */\n readonly request_timeout: Quantity;\n /** This time is the idle time of TCP keepalive. Node then sends 10 probes 1 s apart. */\n readonly keepalive_idle: Extent;\n /** This time is the age at which the client replaces a connection. */\n readonly max_connection_age: Extent;\n /** This time bounds the close of the client at the shutdown. */\n readonly close_bound: Quantity;\n /**\n * This time is when the kernel gives up a segment that it retransmits. Node cannot set it, thus\n * the declaration states it for the ordering law (O17), from the platform.\n */\n readonly retrans_giveup_time: Extent;\n}\n\n/** A client spec is the declaration of one client: where it connects, and its knobs. Each driver adds its own fields. */\nexport interface ClientSpec<K extends ClientKnobs = ClientKnobs> {\n readonly host: string;\n readonly port: number;\n readonly password?: string | undefined;\n /** This identifier is the component in the corpus, for example `systems.component.redis`, or null. */\n readonly system: string | null;\n readonly knobs: K;\n /** These operations add to the table of the client, or change it. */\n readonly operations?: Readonly<Record<string, Operation>> | undefined;\n}\n\n/** A factory makes the connection or the pool of a client from the options of its driver. */\nexport type Factory<O, C> = (options: O) => C | Promise<C>;\n\n/** These options make a client. Without them, a client uses its driver, the real clock, and the dial of its protocol. */\nexport interface ClientOptions<F> {\n readonly create?: F | undefined;\n readonly clock?: Clock | undefined;\n /** This function receives each transition of the client, for the prober (D3). */\n readonly record?: Recorder | undefined;\n readonly dial?: DialFn | undefined;\n}\n\n/** A client socket is the part of the socket of a connection that the join of the prober and the bounded close read. */\nexport interface ClientSocket {\n readonly localAddress?: string | undefined;\n readonly localPort?: number | undefined;\n readonly remoteAddress?: string | undefined;\n readonly remotePort?: number | undefined;\n /** This method closes the socket at once. A close of the driver only half-closes it, and a silent peer does not answer that. */\n destroy?(): void;\n}\n\n/**\n * A client join is one connection, at the time when it can serve (D1, D2). The prober joins its\n * kernel records to the server's view of the connection through it. Each driver adds the server's id of the connection.\n */\nexport interface ClientJoin {\n readonly generation: number;\n /** This time is when the connection became ready, in milliseconds on the monotonic clock. */\n readonly at: number;\n readonly localAddress: string | null;\n readonly localPort: number | null;\n readonly remoteAddress: string | null;\n readonly remotePort: number | null;\n}\n\n/** This function gives the addresses and the ports of a socket for a join. Each one is null when the socket does not give it. */\nexport const socketEnds = (\n socket: ClientSocket | undefined,\n): Pick<ClientJoin, \"localAddress\" | \"localPort\" | \"remoteAddress\" | \"remotePort\"> => ({\n localAddress: socket?.localAddress ?? null,\n localPort: socket?.localPort ?? null,\n remoteAddress: socket?.remoteAddress ?? null,\n remotePort: socket?.remotePort ?? null,\n});\n\n/** A client is a dependency of a service: its declaration, its handle and its checks. Each driver adds the method that sends a call. */\nexport interface Client<S extends Step = ClientStep, J extends ClientJoin = ClientJoin> {\n readonly name: string;\n /** This declaration goes to `svc.dependency(name, declaration, handle)`. */\n readonly declaration: Omit<Dependency, \"name\">;\n readonly handle: DependencyHandle;\n /** These are the manifestations that the client can meet, and the detectors of each (E9). */\n readonly meets: readonly Meeting[];\n /** This text is the state of the client, as the machine document of the client names it. */\n readonly status: string;\n /** These are the connections of the client, the latest last. */\n readonly joins: readonly J[];\n /** This method gives the checks of the client and their functions, for `svc.check(check, run)`. */\n checks(options: CheckOptions<S>): ReadonlyArray<readonly [Check, CheckFn]>;\n /** This method declares the client in a service: its dependency, its handle and its checks. */\n attach(svc: ServiceBuilder, options: CheckOptions<S>): ServiceBuilder;\n /** This method gives the problems of the client in a description: a close that does not fit in its phase, for example. */\n problems(description: ServiceDescription): string[];\n}\n\n/** This function declares a client in a service: its dependency, its handle, and each of its checks. */\nexport const attachClient = (\n svc: ServiceBuilder,\n name: string,\n declaration: Omit<Dependency, \"name\">,\n handle: DependencyHandle,\n checks: ReadonlyArray<readonly [Check, CheckFn]>,\n): ServiceBuilder => {\n svc.dependency(name, declaration, handle);\n for (const [check, run] of checks) svc.check(check, run);\n return svc;\n};\n\n/** This function gives the table of operations of a client: the defaults of its driver, then the operations of its spec. */\nexport const operationTable = (\n defaults: Readonly<Record<string, Operation>>,\n more: Readonly<Record<string, Operation>> | undefined,\n): Readonly<Record<string, Operation>> => ({ ...defaults, ...more });\n\n/** A client recorder gives one transition of a client to the recorder of the options, for the prober (D3). */\nexport type ClientRecorder = (from: string, to: string, on: string, detail?: string) => void;\n\n/** This function makes the recorder of a client. Each event has the machine \"client\", and the name of the client as its instance. */\nexport const clientRecorder =\n (record: Recorder | undefined, clock: Clock, name: string): ClientRecorder =>\n (from, to, on, detail) =>\n record?.({ at: clock.now(), machine: \"client\", instance: name, from, to, on, ...(detail === undefined ? {} : { detail }) });\n\n/** This function gives the outcome of a call that did not leave the client. It is certain: the call did not apply. */\nexport const notSent = (error: string): Attempt<never> => ({ outcome: \"error\", error, reply: false });\n\n/** A settle function gives the outcome of a call in flight. A driver can give a cause, for example the error that ends a client of a pool. */\nexport type Settle<T = unknown> = (value: Attempt<T>, cause?: Error) => void;\n\n/**\n * This record holds the calls in flight of a client. Each call settles one time. A call that the\n * caller abandons after it left the client is indeterminate, because a sent call cannot be\n * cancelled (principle 9). The close and a closed connection settle each call that stays (C10).\n */\nexport interface InFlight {\n /** This number is the count of the calls in flight. */\n readonly size: number;\n /**\n * This method sends one call, and records it until it settles. `start` sends the call, and gives\n * its outcome to `settle`. `after` operates one time, after the call settles and before its promise resolves.\n */\n track<T>(\n signal: AbortSignal | undefined,\n abandoned: string,\n start: (settle: Settle<T>) => void,\n after?: (value: Attempt<T>, cause: Error | undefined) => void,\n ): Promise<Attempt<T>>;\n /** This method settles each call in flight as indeterminate, with this error. */\n settleAll(error: string): void;\n /** This method resolves when no call is in flight. A close that waits for its calls uses it in its bound. */\n idle(): Promise<void>;\n}\n\n/** This function makes the record of the calls in flight of a client. */\nexport const inFlight = (): InFlight => {\n const closes = new Set<(error: string) => void>();\n const waiters = new Set<() => void>();\n const wake = (): void => {\n if (closes.size > 0) return;\n for (const waiter of [...waiters]) waiter();\n waiters.clear();\n };\n return {\n get size() {\n return closes.size;\n },\n idle: () =>\n new Promise<void>((resolve) => {\n if (closes.size === 0) resolve();\n else waiters.add(resolve);\n }),\n track<T>(\n signal: AbortSignal | undefined,\n abandoned: string,\n start: (settle: Settle<T>) => void,\n after?: (value: Attempt<T>, cause: Error | undefined) => void,\n ): Promise<Attempt<T>> {\n return new Promise<Attempt<T>>((resolve) => {\n let settled = false;\n const settle: Settle<T> = (value, cause) => {\n if (settled) return;\n settled = true;\n closes.delete(close);\n signal?.removeEventListener(\"abort\", aborted);\n after?.(value, cause);\n resolve(value);\n wake();\n };\n const close = (error: string): void => settle({ outcome: \"indeterminate\", error }, new Error(error));\n const aborted = (): void => close(abandoned);\n closes.add(close);\n signal?.addEventListener(\"abort\", aborted, { once: true });\n start(settle);\n });\n },\n settleAll(error) {\n for (const close of [...closes]) close(error);\n },\n };\n};\n\n/**\n * This function sends one call through the record of the calls in flight, with a timer of the\n * wrapper. A driver with no timer for its call uses it: amqplib, and the agent of Node. At `bound`\n * milliseconds the call is indeterminate with the error `timedOut`, because it left the client.\n * The timer stops when the call settles, before `after` operates.\n */\nexport const trackWithTimer = <T>(\n flight: InFlight,\n clock: Clock,\n bound: number,\n signal: AbortSignal | undefined,\n abandoned: string,\n timedOut: string,\n start: (settle: Settle<T>) => void,\n after?: (value: Attempt<T>, cause: Error | undefined) => void,\n): Promise<Attempt<T>> => {\n let stop: Cancel = () => {};\n return flight.track<T>(\n signal,\n abandoned,\n (settle) => {\n stop = clock.after(bound, () => settle({ outcome: \"indeterminate\", error: timedOut }));\n start(settle);\n },\n (value, cause) => {\n stop();\n after?.(value, cause);\n },\n );\n};\n\n/**\n * This function waits for the work of a close, for `bound` milliseconds at most. It gives true when\n * the work ended in its bound, with a success or a failure. It gives false at the bound. The driver\n * then destroys each socket that stays, because a silent server does not close its half.\n */\nexport const withinBound = (clock: Clock, bound: number, work: Promise<unknown>): Promise<boolean> => {\n const done = work.then(\n () => true,\n () => true,\n );\n let cancel: Cancel = () => {};\n const timer = new Promise<boolean>((resolve) => {\n cancel = clock.after(bound, () => resolve(false));\n });\n return Promise.race([done, timer]).then((ended) => {\n cancel();\n return ended;\n });\n};\n\n/**\n * A ready wait holds the calls that wait for a ready connection before their second try. A client\n * that connects again by itself uses it: Redis and RabbitMQ.\n */\nexport interface ReadyWait {\n /** This method waits until the client is ready, for `within` milliseconds at most. It gives true when the client is ready. */\n wait(within: number, signal?: AbortSignal): Promise<boolean>;\n /** This method ends each wait with true. The client uses it when its connection is ready. */\n wake(): void;\n}\n\n/** This function makes the ready wait of a client. The function `ready` tells if the client is ready. */\nexport const readyWait = (clock: Clock, ready: () => boolean): ReadyWait => {\n const waiters = new Set<() => void>();\n return {\n wait: (within, signal) =>\n new Promise((resolve) => {\n if (ready()) {\n resolve(true);\n return;\n }\n let cancel: Cancel = () => {};\n const done = (value: boolean): void => {\n waiters.delete(wake);\n cancel();\n signal?.removeEventListener(\"abort\", aborted);\n resolve(value);\n };\n const wake = (): void => done(true);\n const aborted = (): void => done(false);\n waiters.add(wake);\n cancel = clock.after(within, () => done(ready()));\n signal?.addEventListener(\"abort\", aborted, { once: true });\n }),\n wake() {\n for (const wake of [...waiters]) wake();\n },\n };\n};\n\n/** These are the knobs of a client that connects again by itself, after a delay that doubles. */\nexport interface RetryKnobs {\n /** This time is the first delay before a new try to connect. The delay doubles after each try. */\n readonly retry_base: Quantity;\n /** This time is the most that one delay can be, before its jitter. */\n readonly retry_cap: Quantity;\n}\n\n/**\n * This function gives the backoff of the tries to connect: from `retry_base`, doubling to\n * `retry_cap`, each with a jitter up to the base. The client rounds each delay to a whole millisecond.\n */\nexport const retryBackoff = (knobs: RetryKnobs): Backoff => ({\n base: ms(knobs.retry_base),\n factor: 2,\n cap: ms(knobs.retry_cap),\n jitter: { kind: \"add\", amount: ms(knobs.retry_base) },\n});\n\n/**\n * A retry schedule holds the next try to connect, for a client that connects again by itself. It\n * counts the tries since the last join. Each delay comes from the backoff, rounded to a whole millisecond.\n */\nexport interface RetrySchedule {\n /** This count is the number of tries since the last reset. */\n readonly tries: number;\n /** This method counts one more try, and starts `due` after the delay of that try. It stops a try that waits. */\n schedule(due: () => void): void;\n /** This method stops the try that waits. The close uses it. */\n cancel(): void;\n /** This method sets the count of tries to zero. The client uses it at each join. */\n reset(): void;\n}\n\n/** This function makes the retry schedule of a client, from its backoff and its random numbers. RabbitMQ and WebSocket use it. */\nexport const retrySchedule = (clock: Clock, backoff: Backoff, random: () => number): RetrySchedule => {\n // the public retrier does the same work: the schedule only names its count `tries`\n const retry = retrierOn(clock, backoff, random);\n return {\n get tries() {\n return retry.attempts;\n },\n schedule(due) {\n retry.schedule(due);\n },\n cancel: () => retry.cancel(),\n reset: () => retry.reset(),\n };\n};\n\n/** This function gives the problems of the retry knobs: the cap must not be below the base. */\nexport const retryProblems = (name: string, knobs: RetryKnobs): string[] =>\n ms(knobs.retry_cap) < ms(knobs.retry_base) ? [`${name}'s retry_cap is below its retry_base`] : [];\n\n/**\n * This function gives the problem of a count of misses that is not a whole number above zero. A\n * client that closes its connection after a count of heartbeat misses uses it. `mechanism` names the heartbeat, for example \"watchdog\".\n */\nexport const missesProblems = (name: string, misses: number, mechanism: string): string[] =>\n Number.isInteger(misses) && misses >= 1 ? [] : [`${name}'s ${mechanism} closes the connection after ${misses} misses, not a whole number above zero`];\n\n/** This function gives the problems of the knobs of a spec that each client has: each knob must be a time of zero or more. */\nexport const timeProblems = (name: string, knobs: object): string[] => {\n const problems: string[] = [];\n for (const [knob, amount] of Object.entries(knobs) as Array<[string, Extent]>) {\n if (amount.value !== \"infinite\" && !(ms(amount) >= 0)) problems.push(`${name}'s ${knob} is not a time of zero or more`);\n }\n return problems;\n};\n\n/** This function writes a bound for a driver that reads 0 as no timer: \"infinite\" is 0. */\nexport const orZero = (amount: Extent): number => finiteMs(amount) ?? 0;\n\n/** This function tells if an amount is a whole number of milliseconds. \"infinite\" is whole. */\nexport const wholeMs = (amount: Extent): boolean => amount.value === \"infinite\" || Number.isInteger(ms(amount));\n\n/** This function tells if an amount is a whole number of seconds. \"infinite\" is whole. */\nexport const wholeSeconds = (amount: Extent): boolean =>\n amount.value === \"infinite\" || Number.isInteger(valueIn(amount as Quantity, \"s\"));\n\n/** These are the knobs of a spec that `zeroProblems` and `wholeProblems` examine, by their kind. */\nexport interface KnobKinds {\n /** These knobs must be a finite time above zero, because the driver reads 0 as no bound. */\n readonly bounded?: readonly string[] | undefined;\n /** These knobs can be \"infinite\", which the driver writes as 0. Thus 0 itself is not a bound. */\n readonly open?: readonly string[] | undefined;\n /** These knobs go to the driver in whole milliseconds. */\n readonly millis?: readonly string[] | undefined;\n /** These knobs go to the driver or to Node in whole seconds. */\n readonly seconds?: readonly string[] | undefined;\n}\n\nconst knobOf = (knobs: object, knob: string): Extent => (knobs as Record<string, Extent>)[knob]!;\n\n/**\n * This function gives the problems of the knobs of a driver that reads 0 as no timer. pg and the\n * MongoDB driver read 0 so. A bounded knob must be a finite time above zero. An open knob can be\n * \"infinite\", and 0 is then a mistake.\n */\nexport const zeroProblems = (name: string, driver: string, knobs: object, kinds: KnobKinds): string[] => {\n const problems: string[] = [];\n for (const knob of kinds.bounded ?? []) {\n const value = ms(knobOf(knobs, knob));\n if (!(value > 0) || !Number.isFinite(value)) problems.push(`${name}'s ${knob} is not a finite time above zero: ${driver} reads 0 as no bound`);\n }\n for (const knob of kinds.open ?? []) {\n const amount = knobOf(knobs, knob);\n if (amount.value !== \"infinite\" && !(ms(amount) > 0)) problems.push(`${name}'s ${knob} is zero: give \"infinite\" for no bound`);\n }\n return problems;\n};\n\n/** This function gives the problems of the knobs that a driver takes in whole milliseconds or in whole seconds. */\nexport const wholeProblems = (name: string, knobs: object, kinds: KnobKinds): string[] => [\n ...(kinds.millis ?? []).filter((knob) => !wholeMs(knobOf(knobs, knob))).map((knob) => `${name}'s ${knob} is not a whole number of milliseconds`),\n ...(kinds.seconds ?? []).filter((knob) => !wholeSeconds(knobOf(knobs, knob))).map((knob) => `${name}'s ${knob} is not a whole number of seconds`),\n];\n\n/** This function gives the problems of the sizes of a pool: at most `max` connections, and `min` from 0 to `max`. */\nexport const poolProblems = (name: string, pool: { readonly max: number; readonly min: number }): string[] => {\n const problems: string[] = [];\n if (!Number.isInteger(pool.max) || pool.max < 1) problems.push(`${name}'s pool has a max of ${pool.max}, not a whole number above zero`);\n if (!Number.isInteger(pool.min) || pool.min < 0 || pool.min > pool.max)\n problems.push(`${name}'s pool has a min of ${pool.min}, not a whole number from 0 to its max`);\n return problems;\n};\n\n/**\n * This function gives the problem O07 of a client whose server has a deadline, or null. The client\n * must wait longer than the deadline of the server. Then the server ends a slow call with an error\n * first. Otherwise the client gives up first, and the server goes on with the call. `call` names\n * the call of the server, for example a statement.\n */\nexport const deadlineProblem = (name: string, request: Quantity, deadline: Extent, call: string): string | null =>\n deadline.value !== \"infinite\" && ms(request) <= ms(deadline)\n ? `${name}'s request_timeout is not above its statement_timeout: the server goes on with a ${call} that the client gave up (O07)`\n : null;\n\n/**\n * This function gives the problem O01 of a client pool, or null. The pool must close an idle\n * connection before its server does. Otherwise a request can go on a connection that the server\n * closed. A server that keeps an idle connection with no bound gives no problem. `knob` names the\n * idle time of the client: `pool_idle_expiry` of a pool, or `client_idle_timeout` of a gRPC channel.\n */\nexport const idleCloseProblem = (name: string, expiry: Extent, close: Extent, knob = \"pool_idle_expiry\"): string | null =>\n close.value !== \"infinite\" && !(ms(expiry) < ms(close))\n ? `${name}'s ${knob} is not below the idle close of its server: a request can go on a connection that the server closed (O01)`\n : null;\n\n/**\n * This function gives the problems of the timers that the wrapper has, because its driver has none.\n * Each one must be a finite time above zero. `bounds` gives what each knob bounds, for example \"a call\".\n */\nexport const wrapperTimerProblems = (name: string, knobs: object, bounds: Readonly<Record<string, string>>): string[] =>\n Object.entries(bounds)\n .filter(([knob]) => {\n const value = ms(knobOf(knobs, knob));\n return !(value > 0) || !Number.isFinite(value);\n })\n .map(([knob, what]) => `${name}'s ${knob} is not a finite time above zero: the timer of the wrapper is the only bound of ${what}`);\n\n/** This function gives the problem of a finite connection age, for a client that does not replace a connection at an age. `reason` tells why. */\nexport const ageProblems = (name: string, knobs: Pick<ClientKnobs, \"max_connection_age\">, reason: string): string[] =>\n knobs.max_connection_age.value === \"infinite\" ? [] : [`${name}'s max_connection_age is not \"infinite\": ${reason}`];\n\n/** This function gives the problem of a keepalive that is not a finite time above zero, for a driver that always turns keepalive on. */\nexport const keepaliveOnProblems = (name: string, knobs: Pick<ClientKnobs, \"keepalive_idle\">, driver: string): string[] => {\n const value = ms(knobs.keepalive_idle);\n return value > 0 && Number.isFinite(value) ? [] : [`${name}'s keepalive_idle is not a finite time above zero: ${driver} always turns keepalive on`];\n};\n\n/** These are the parts of one call that the core uses to send it, and to send it again. */\nexport interface Reissue<T> {\n readonly clock: Clock;\n /** This time bounds the call and its second try, in milliseconds from its start. */\n readonly bound: number;\n /** This operation is the declaration of the call, or undefined when the table does not name it. */\n readonly operation: Operation | undefined;\n readonly options: SendOptions;\n /** This function makes one try. Its signal ends the try. */\n readonly attempt: (signal: AbortSignal | undefined) => Promise<Attempt<T>>;\n /** This function operates before the second try, with the time that is left. False stops the second try. */\n readonly beforeAgain?: ((left: number, signal: AbortSignal | undefined) => Promise<boolean>) | undefined;\n /** This function receives the start of a second try, for the record of the client. */\n readonly onReissue: () => void;\n}\n\n/**\n * This function sends a call, and gives its outcome in three values. It sends again only an\n * idempotent operation, one time at most, after an outcome that is not certain. A reply of the\n * server is certain. The second try ends at the bound of the call, not one bound after its own start.\n */\nexport const sendWithReissue = async <T>(call: Reissue<T>): Promise<Sent<T>> => {\n const { clock, bound } = call;\n const { signal } = call.options;\n const operation = call.options.reissue === false ? undefined : call.operation;\n const started = clock.now();\n const first = await call.attempt(signal);\n if (first.outcome === \"ok\") return { outcome: \"ok\", value: first.value, attempts: 1 };\n const again =\n !(first.outcome === \"error\" && first.reply) &&\n operation !== undefined &&\n signal?.aborted !== true &&\n mayReissue(operation, quantity((clock.now() - started) / 1000, \"s\"));\n const left = bound - (clock.now() - started);\n if (!again || left <= 0) return { ...first, attempts: 1 };\n if (call.beforeAgain !== undefined && !(await call.beforeAgain(left, signal))) return { ...first, attempts: 1 };\n call.onReissue();\n const end = new AbortController();\n const stop = clock.after(Math.max(0, bound - (clock.now() - started)), () => end.abort());\n const forward = (): void => end.abort();\n signal?.addEventListener(\"abort\", forward, { once: true });\n const second = await call.attempt(end.signal);\n stop();\n signal?.removeEventListener(\"abort\", forward);\n return second.outcome === \"ok\" ? { outcome: \"ok\", value: second.value, attempts: 2 } : { ...second, attempts: 2 };\n};\n\n/**\n * This function gives the checks of a client, for `svc.check(check, run)`. Without a catalog, it gives\n * a check for each step that the options name, when the client has a function for that step. With a\n * catalog, it gives a check for each step of the client. It then throws for a nominated step that the\n * client does not have (B19). The name of each check is the pair of the component and the step, a\n * public contract.\n */\nexport const stepChecks = <S extends Step>(\n name: string,\n options: CheckOptions<S>,\n runs: Readonly<Partial<Record<S, StepCheck>>>,\n): ReadonlyArray<readonly [Check, CheckFn]> => {\n const has = (Object.entries(runs) as Array<[S, StepCheck | undefined]>).filter(([, run]) => run !== undefined).map(([step]) => step);\n const catalog = options.catalog === true ? { ...options.poll, interval: CATALOG_INTERVAL } : options.catalog;\n if (catalog !== undefined) {\n const missing = Object.keys(options.steps).filter((step) => !has.includes(step as S));\n if (missing.length > 0) {\n throw new Error(`${name}: the nominated checks ${missing.join(\", \")} are not in the catalog of the client (${has.join(\", \")})`);\n }\n }\n const made: Array<readonly [Check, CheckFn]> = [];\n for (const step of has) {\n const run = runs[step] as StepCheck;\n const nominated = step in options.steps;\n if (!nominated && catalog === undefined) continue;\n made.push([\n {\n name: `${name}.${step}`,\n dependency: name,\n step,\n ownConnection: run.ownConnection,\n gates: nominated ? (options.steps[step] ?? null) : null,\n poll: nominated || catalog === undefined ? options.poll : catalog,\n },\n run.run,\n ]);\n }\n return made;\n};\n\n/** This function makes a check outcome from a sent result: only `ok` passes. */\nexport const passes = (sent: Sent<unknown>): Outcome => (sent.outcome === \"ok\" ? \"ok\" : \"error\");\n\n/** This check gives the state of the client, without a round trip. */\nexport const localStateCheck = (ready: () => boolean): StepCheck => ({ ownConnection: true, run: () => (ready() ? \"ok\" : \"error\") });\n\n/**\n * This check sends one call on the connection of the application. A check measures the step at this time.\n * Thus it does not send the call again, and only `ok` passes.\n */\nexport const roundTripCheck = (send: (options: SendOptions) => Promise<Sent<unknown>>): StepCheck => ({\n ownConnection: true,\n run: async (signal) => passes(await send({ signal, reissue: false })),\n});\n\n/**\n * This check opens a new connection each time. It finds a server that refuses connections, but not\n * a stalled connection of the application. A failed dial throws, and the poller counts the throw as an error.\n */\nexport const dialCheck = (dial: DialFn, host: string, port: number): StepCheck => ({\n ownConnection: false,\n run: async (signal) => {\n await dial(host, port, signal);\n return \"ok\" as const;\n },\n});\n\n/** These are the bounds of a client that the core examines in a description. */\nexport interface ClientBounds {\n /** This time bounds the close of the client, in milliseconds. */\n readonly close: number;\n /** This time bounds a call on the connection of the application, in milliseconds. */\n readonly request: number;\n}\n\n/** This function gives the bounds of a client that `clientProblems` examines, from its knobs. */\nexport const clientBounds = (knobs: ClientKnobs): ClientBounds => ({ close: ms(knobs.close_bound), request: ms(knobs.request_timeout) });\n\n/**\n * This function gives the problems of a client in a description:\n * - The client needs the phase \"tear down dependencies\", and its close must fit in the cap of that phase.\n * - A round-trip check must end in one jittered poll (B7, O13).\n */\nexport const clientProblems = (name: string, description: ServiceDescription, bounds: ClientBounds): string[] => {\n const found: string[] = [];\n const teardown = description.shutdown.phases.find((phase) => phase.name === \"tear down dependencies\");\n if (teardown === undefined) found.push(`${name} needs the phase \"tear down dependencies\" to close`);\n else if (bounds.close >= valueIn(teardown.cap, \"ms\"))\n found.push(`${name}'s close_bound of ${bounds.close} ms does not fit in the cap of \"tear down dependencies\"`);\n for (const check of description.checks) {\n if (check.dependency !== name || check.step !== \"round-trip\") continue;\n const slowest = valueIn(check.poll.timeout, \"ms\") + valueIn(check.poll.interval, \"ms\") * (1 + check.poll.jitter);\n if (bounds.request > slowest) found.push(`${name}'s request_timeout outlives one jittered poll of ${check.name} (B7, O13)`);\n }\n return found;\n};\n\n/**\n * This poll is a poll of the checks to start from: each 5 s with a jitter of 20 %, and a timeout of\n * 4 s (B6, O12). Its slowest poll is 4 s + 5 s × 1.2 = 10 s, the slowest poll of the cells of O13.\n * It does not depend on a driver. The starting knobs of each driver fit it.\n */\nexport const STARTING_POLL: Poll = { interval: { value: 5, unit: \"s\" }, jitter: 0.2, timeout: { value: 4, unit: \"s\" } };\n","// The dial of a client: a new TCP connection that sends the first bytes of its protocol and reads\n// the answer. Each driver gives its bytes and its rule for the answer. The core keeps node:net out\n// of `core.ts`, thus only an entry that gives a dial loads it.\n\nimport { connect as dialTcp } from \"node:net\";\nimport type { DialFn } from \"./core.ts\";\n\n/**\n * A judge reads the bytes that the server sent so far. It gives null for a good answer, an error for\n * a bad answer, or \"more\" when it must wait for more bytes.\n */\nexport type Judge = (received: Buffer) => Error | null | \"more\";\n\n/**\n * This function makes a dial function. The dial opens a TCP connection, sends `hello`, and reads the\n * answer until `judge` decides. An abort, an error of the socket, and a close before the decision fail the dial.\n * The dial destroys its socket at its end.\n */\nexport const helloDial =\n (hello: string | Uint8Array, judge: Judge): DialFn =>\n (host, port, signal) =>\n new Promise((resolve, reject) => {\n if (signal.aborted) {\n reject(new Error(\"the dial was aborted\"));\n return;\n }\n const socket = dialTcp({ host, port });\n let received = Buffer.alloc(0);\n const end = (error?: Error): void => {\n signal.removeEventListener(\"abort\", onAbort);\n socket.destroy();\n if (error === undefined) resolve();\n else reject(error);\n };\n const onAbort = (): void => end(new Error(\"the dial was aborted\"));\n signal.addEventListener(\"abort\", onAbort, { once: true });\n socket.once(\"connect\", () => socket.write(hello));\n socket.on(\"data\", (chunk: Buffer) => {\n received = Buffer.concat([received, chunk]);\n const verdict = judge(received);\n if (verdict === \"more\") return;\n end(verdict ?? undefined);\n });\n socket.once(\"error\", (error) => end(error));\n socket.once(\"close\", () => end(new Error(\"the server closed the dial\")));\n });\n\n/** This function gives the authority of a host and a port for a Host header. An IPv6 address goes in brackets. */\nexport const authority = (host: string, port: number): string => `${host.includes(\":\") ? `[${host}]` : host}:${port}`;\n\n/**\n * This function makes a judge of the status line of an HTTP/1.1 answer. The judge waits for the end\n * of the line, in the first 8 KiB. Then `accept` reads the status code, and gives null for a good status or an error.\n * The HTTP client accepts each status. The WebSocket client accepts only 101.\n */\nexport const statusLineJudge =\n (accept: (status: number, line: string) => Error | null): Judge =>\n (received) => {\n const end = received.indexOf(\"\\r\\n\");\n if (end < 0) return received.length > 8192 ? new Error(\"the answer has no status line in its first 8 KiB\") : \"more\";\n const line = received.toString(\"latin1\", 0, end);\n const status = /^HTTP\\/1\\.[01] (\\d{3})/.exec(line);\n return status === null ? new Error(`the answer ${JSON.stringify(line)} is not an HTTP/1.1 status line`) : accept(Number(status[1]), line);\n };\n","// The parts of the machine document of a client that each client has. Each client entry writes its\n// own states and transitions, because the states are the states of its driver. The helpers, the\n// knob shape, the timer of the bounded close and the events that the core records are the same.\n\nimport type { TransitionDef } from \"@mark1russell7/algebra\";\n\n/** This function gives one transition of a machine document. */\nexport const transition = (\n id: string,\n from: string | readonly string[],\n on: string | readonly string[],\n to: string,\n extra: Partial<TransitionDef> = {},\n): TransitionDef => ({\n id,\n from,\n on,\n to,\n ...extra,\n});\n\n/** A client knob is a knob of a client in a machine document: a time in seconds, with no default. */\nexport interface ClientKnob {\n readonly key: string;\n readonly scope: \"client\";\n readonly unit: \"s\";\n readonly default: null;\n}\n\n/** This function gives a knob of a client in a machine document, by the option of the driver that it sets. */\nexport const clientKnob = (key: string): ClientKnob => ({ key, scope: \"client\", unit: \"s\", default: null });\n\n/** A close timer is the timer of the bounded close in a machine document. */\nexport interface CloseTimer {\n readonly duration: { readonly knob: \"close_bound\"; readonly unit: \"s\" };\n readonly arms: readonly [\"close.request\"];\n readonly cancels: readonly [\"status.end\"];\n readonly fires: \"close.bound\";\n}\n\n/** This timer is the bound of the close. The close request arms it, and the end cancels it. At its end, the driver destroys each socket. */\nexport const closeTimer = (): CloseTimer => ({\n duration: { knob: \"close_bound\", unit: \"s\" },\n arms: [\"close.request\"],\n cancels: [\"status.end\"],\n fires: \"close.bound\",\n});\n\n/**\n * These are the events that each machine document of a client declares. The core and the shared\n * parts of each client record them: a second try, a failed connect, and the steps of the bounded close.\n */\nexport const CLIENT_EVENTS = [\"status.connecting\", \"connect.failed\", \"command.reissue\", \"close.request\", \"close.bound\", \"close.destroy\", \"status.end\"] as const;\n"],"mappings":"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"}
|