@rikalabs/akter 0.1.0-alpha.0 → 0.1.0-alpha.3
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/CHANGELOG.md +46 -3
- package/README.md +2 -2
- package/dist/actor/definition.d.ts +13 -9
- package/dist/actor/descriptor.d.ts +2 -2
- package/dist/actor/descriptor.js +4 -4
- package/dist/client/calls.js +1 -1
- package/dist/client/index.d.ts +1 -1
- package/dist/client/index.js +1 -1
- package/dist/errors/actor.d.ts +12 -42
- package/dist/errors/actor.js +13 -42
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/members/payload.d.ts +1 -1
- package/dist/protocol/inspection.d.ts +221 -1
- package/dist/protocol/inspection.js +151 -2
- package/dist/protocol/wire.d.ts +6 -49
- package/dist/protocol/wire.js +1 -10
- package/dist/runtime/actors.d.ts +3 -0
- package/dist/runtime/adoption/backfill.js +1 -1
- package/dist/runtime/adoption/enforce.js +2 -2
- package/dist/runtime/adoption/observe.js +1 -1
- package/dist/runtime/adoption/plan.d.ts +1 -1
- package/dist/runtime/adoption/startup.js +1 -1
- package/dist/runtime/adoption/status.d.ts +1 -1
- package/dist/runtime/app.d.ts +65 -0
- package/dist/runtime/app.js +38 -0
- package/dist/runtime/connections/holder.d.ts +11 -1
- package/dist/runtime/connections/holder.js +8 -4
- package/dist/runtime/connections/streams.d.ts +4 -4
- package/dist/runtime/content/store.js +15 -11
- package/dist/runtime/database/bounded.d.ts +4 -18
- package/dist/runtime/database/bounded.js +36 -22
- package/dist/runtime/database/coordination.d.ts +12 -3
- package/dist/runtime/database/coordination.js +29 -36
- package/dist/runtime/database/migrations.d.ts +61 -29
- package/dist/runtime/database/migrations.js +375 -139
- package/dist/runtime/database/replica.d.ts +4 -1
- package/dist/runtime/database/replica.js +4 -1
- package/dist/runtime/database/schema.d.ts +13 -0
- package/dist/runtime/database/schema.js +13 -0
- package/dist/runtime/database/shards.d.ts +31 -13
- package/dist/runtime/database/shards.js +38 -26
- package/dist/runtime/entity/register.d.ts +8 -1
- package/dist/runtime/entity/register.js +58 -7
- package/dist/runtime/fleet/checks.js +4 -4
- package/dist/runtime/fleet/maintainer.d.ts +1 -1
- package/dist/runtime/fleet/maintainer.js +1 -1
- package/dist/runtime/index.d.ts +2 -0
- package/dist/runtime/index.js +1 -0
- package/dist/runtime/inspector/layer.d.ts +20 -0
- package/dist/runtime/inspector/layer.js +224 -5
- package/dist/runtime/inspector/queries.d.ts +54 -8
- package/dist/runtime/inspector/queries.js +84 -15
- package/dist/runtime/layer.d.ts +48 -39
- package/dist/runtime/layer.js +124 -56
- package/dist/runtime/operators/audit.d.ts +3 -0
- package/dist/runtime/operators/audit.js +6 -2
- package/dist/runtime/operators/repair.js +30 -10
- package/dist/runtime/operators/seed.js +4 -2
- package/dist/runtime/payloads/versions.d.ts +4 -4
- package/dist/runtime/payloads/versions.js +24 -15
- package/dist/runtime/queries.js +4 -2
- package/dist/runtime/registration.d.ts +5 -2
- package/dist/runtime/registration.js +3 -3
- package/dist/runtime/runner.d.ts +12 -0
- package/dist/runtime/runner.js +12 -0
- package/dist/runtime/storage/codec.d.ts +19 -7
- package/dist/runtime/storage/codec.js +23 -7
- package/dist/runtime/storage/placements.d.ts +6 -1
- package/dist/runtime/storage/placements.js +98 -6
- package/dist/runtime/storage/retention.d.ts +6 -0
- package/dist/runtime/storage/retention.js +25 -13
- package/dist/runtime/subscriptions/relay.js +47 -44
- package/dist/runtime/subscriptions/storage.d.ts +3 -2
- package/dist/runtime/subscriptions/storage.js +9 -6
- package/dist/runtime/telemetry/live.d.ts +255 -0
- package/dist/runtime/telemetry/live.js +540 -0
- package/dist/runtime/telemetry/metrics.d.ts +2 -0
- package/dist/runtime/telemetry/metrics.js +4 -1
- package/dist/runtime/telemetry/sampler.js +33 -13
- package/dist/runtime/telemetry/spans.d.ts +1 -1
- package/dist/runtime/telemetry/spans.js +1 -1
- package/dist/runtime/topology/locks.d.ts +6 -3
- package/dist/runtime/topology/locks.js +27 -4
- package/dist/runtime/turn/execute.d.ts +2 -0
- package/dist/runtime/turn/execute.js +5 -2
- package/dist/runtime/turn/pipeline.d.ts +5 -12
- package/dist/runtime/turn/pipeline.js +11 -11
- package/dist/runtime/turn/relay.d.ts +13 -3
- package/dist/runtime/turn/relay.js +27 -14
- package/dist/runtime/turn/rows.js +4 -4
- package/dist/runtime/workflows/compatibility.d.ts +1 -1
- package/dist/runtime/workflows/compatibility.js +85 -31
- package/dist/runtime/workflows/engine.js +20 -17
- package/dist/serve/layer.js +3 -2
- package/dist/tables/owned.d.ts +1 -1
- package/dist/tables/owned.js +1 -1
- package/dist/testing/actor-test.d.ts +2 -24
- package/dist/testing/actor-test.js +1 -27
- package/dist/testing/index.d.ts +0 -12
- package/dist/testing/index.js +0 -6
- package/package.json +1 -1
- package/dist/runtime/database/neki/migrations.d.ts +0 -31
- package/dist/runtime/database/neki/migrations.js +0 -276
- package/dist/runtime/database/neki/session.d.ts +0 -23
- package/dist/runtime/database/neki/session.js +0 -31
- package/dist/testing/cluster.d.ts +0 -93
- package/dist/testing/cluster.js +0 -296
- package/dist/testing/conformance/access.d.ts +0 -5
- package/dist/testing/conformance/access.js +0 -531
- package/dist/testing/conformance/admission.d.ts +0 -11
- package/dist/testing/conformance/admission.js +0 -182
- package/dist/testing/conformance/adoption.d.ts +0 -2
- package/dist/testing/conformance/adoption.js +0 -1019
- package/dist/testing/conformance/assertions.d.ts +0 -202
- package/dist/testing/conformance/assertions.js +0 -849
- package/dist/testing/conformance/batches.d.ts +0 -41
- package/dist/testing/conformance/batches.js +0 -388
- package/dist/testing/conformance/blobs.d.ts +0 -14
- package/dist/testing/conformance/blobs.js +0 -405
- package/dist/testing/conformance/capacity.d.ts +0 -8
- package/dist/testing/conformance/capacity.js +0 -433
- package/dist/testing/conformance/client.d.ts +0 -5
- package/dist/testing/conformance/client.js +0 -719
- package/dist/testing/conformance/cold-serve.d.ts +0 -16
- package/dist/testing/conformance/cold-serve.js +0 -254
- package/dist/testing/conformance/connections/actors.d.ts +0 -1143
- package/dist/testing/conformance/connections/actors.js +0 -180
- package/dist/testing/conformance/connections/harness.d.ts +0 -1754
- package/dist/testing/conformance/connections/harness.js +0 -142
- package/dist/testing/conformance/connections/holders.d.ts +0 -4
- package/dist/testing/conformance/connections/holders.js +0 -165
- package/dist/testing/conformance/connections/lifecycle.d.ts +0 -4
- package/dist/testing/conformance/connections/lifecycle.js +0 -113
- package/dist/testing/conformance/connections/limits.d.ts +0 -4
- package/dist/testing/conformance/connections/limits.js +0 -127
- package/dist/testing/conformance/connections/reauthorization.d.ts +0 -4
- package/dist/testing/conformance/connections/reauthorization.js +0 -170
- package/dist/testing/conformance/connections/resync.d.ts +0 -4
- package/dist/testing/conformance/connections/resync.js +0 -360
- package/dist/testing/conformance/connections/takeover.d.ts +0 -4
- package/dist/testing/conformance/connections/takeover.js +0 -287
- package/dist/testing/conformance/connections.d.ts +0 -4
- package/dist/testing/conformance/connections.js +0 -15
- package/dist/testing/conformance/content-blobs.d.ts +0 -16
- package/dist/testing/conformance/content-blobs.js +0 -534
- package/dist/testing/conformance/counter.d.ts +0 -16
- package/dist/testing/conformance/counter.js +0 -813
- package/dist/testing/conformance/cron.d.ts +0 -5
- package/dist/testing/conformance/cron.js +0 -665
- package/dist/testing/conformance/drain.d.ts +0 -26
- package/dist/testing/conformance/drain.js +0 -540
- package/dist/testing/conformance/effect-control.d.ts +0 -38
- package/dist/testing/conformance/effect-control.js +0 -1059
- package/dist/testing/conformance/effects.d.ts +0 -23
- package/dist/testing/conformance/effects.js +0 -432
- package/dist/testing/conformance/events.d.ts +0 -28
- package/dist/testing/conformance/events.js +0 -335
- package/dist/testing/conformance/export.d.ts +0 -2
- package/dist/testing/conformance/export.js +0 -368
- package/dist/testing/conformance/fleet.d.ts +0 -444
- package/dist/testing/conformance/fleet.js +0 -1009
- package/dist/testing/conformance/groups.d.ts +0 -7
- package/dist/testing/conformance/groups.js +0 -353
- package/dist/testing/conformance/heap.d.ts +0 -3
- package/dist/testing/conformance/heap.js +0 -149
- package/dist/testing/conformance/http.d.ts +0 -2809
- package/dist/testing/conformance/http.js +0 -1234
- package/dist/testing/conformance/inspection-views.d.ts +0 -8
- package/dist/testing/conformance/inspection-views.js +0 -272
- package/dist/testing/conformance/inspector.d.ts +0 -7
- package/dist/testing/conformance/inspector.js +0 -650
- package/dist/testing/conformance/mint.d.ts +0 -58
- package/dist/testing/conformance/mint.js +0 -692
- package/dist/testing/conformance/multi-runner.d.ts +0 -8
- package/dist/testing/conformance/multi-runner.js +0 -403
- package/dist/testing/conformance/neki/plan.d.ts +0 -19
- package/dist/testing/conformance/neki/plan.js +0 -30
- package/dist/testing/conformance/observability.d.ts +0 -3
- package/dist/testing/conformance/observability.js +0 -343
- package/dist/testing/conformance/offline.d.ts +0 -4
- package/dist/testing/conformance/offline.js +0 -474
- package/dist/testing/conformance/operator-harness.d.ts +0 -57
- package/dist/testing/conformance/operator-harness.js +0 -78
- package/dist/testing/conformance/operator.d.ts +0 -3
- package/dist/testing/conformance/operator.js +0 -379
- package/dist/testing/conformance/outbox-cross-shard.d.ts +0 -14
- package/dist/testing/conformance/outbox-cross-shard.js +0 -160
- package/dist/testing/conformance/outbox.d.ts +0 -36
- package/dist/testing/conformance/outbox.js +0 -437
- package/dist/testing/conformance/payload-migrations.d.ts +0 -3
- package/dist/testing/conformance/payload-migrations.js +0 -612
- package/dist/testing/conformance/pipeline.d.ts +0 -3
- package/dist/testing/conformance/pipeline.js +0 -1040
- package/dist/testing/conformance/placement.d.ts +0 -22
- package/dist/testing/conformance/placement.js +0 -539
- package/dist/testing/conformance/platform.d.ts +0 -40
- package/dist/testing/conformance/platform.js +0 -101
- package/dist/testing/conformance/progress.d.ts +0 -39
- package/dist/testing/conformance/progress.js +0 -666
- package/dist/testing/conformance/properties.d.ts +0 -6
- package/dist/testing/conformance/properties.js +0 -295
- package/dist/testing/conformance/protocols.d.ts +0 -4
- package/dist/testing/conformance/protocols.js +0 -618
- package/dist/testing/conformance/provider/advertise.d.ts +0 -21
- package/dist/testing/conformance/provider/advertise.js +0 -44
- package/dist/testing/conformance/read-your-writes.d.ts +0 -20
- package/dist/testing/conformance/read-your-writes.js +0 -192
- package/dist/testing/conformance/reducers.d.ts +0 -8
- package/dist/testing/conformance/reducers.js +0 -258
- package/dist/testing/conformance/relay.d.ts +0 -42
- package/dist/testing/conformance/relay.js +0 -1115
- package/dist/testing/conformance/restore.d.ts +0 -43
- package/dist/testing/conformance/restore.js +0 -341
- package/dist/testing/conformance/retention.d.ts +0 -14
- package/dist/testing/conformance/retention.js +0 -463
- package/dist/testing/conformance/rls.d.ts +0 -24
- package/dist/testing/conformance/rls.js +0 -576
- package/dist/testing/conformance/simulation.d.ts +0 -31
- package/dist/testing/conformance/simulation.js +0 -167
- package/dist/testing/conformance/single-shard.d.ts +0 -2
- package/dist/testing/conformance/single-shard.js +0 -125
- package/dist/testing/conformance/singleton.d.ts +0 -3
- package/dist/testing/conformance/singleton.js +0 -293
- package/dist/testing/conformance/statements.d.ts +0 -60
- package/dist/testing/conformance/statements.js +0 -108
- package/dist/testing/conformance/streams.d.ts +0 -7
- package/dist/testing/conformance/streams.js +0 -280
- package/dist/testing/conformance/subscriptions/access.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/access.js +0 -98
- package/dist/testing/conformance/subscriptions/actors.d.ts +0 -4910
- package/dist/testing/conformance/subscriptions/actors.js +0 -372
- package/dist/testing/conformance/subscriptions/cluster.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/cluster.js +0 -89
- package/dist/testing/conformance/subscriptions/delivery.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/delivery.js +0 -253
- package/dist/testing/conformance/subscriptions/deploys.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/deploys.js +0 -162
- package/dist/testing/conformance/subscriptions/epochs.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/epochs.js +0 -169
- package/dist/testing/conformance/subscriptions/failures.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/failures.js +0 -108
- package/dist/testing/conformance/subscriptions/feeds.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/feeds.js +0 -218
- package/dist/testing/conformance/subscriptions/harness.d.ts +0 -124
- package/dist/testing/conformance/subscriptions/harness.js +0 -143
- package/dist/testing/conformance/subscriptions/operator.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/operator.js +0 -128
- package/dist/testing/conformance/subscriptions/retention.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/retention.js +0 -288
- package/dist/testing/conformance/subscriptions/routing.d.ts +0 -4
- package/dist/testing/conformance/subscriptions/routing.js +0 -179
- package/dist/testing/conformance/subscriptions.d.ts +0 -4
- package/dist/testing/conformance/subscriptions.js +0 -19
- package/dist/testing/conformance/tables.d.ts +0 -125
- package/dist/testing/conformance/tables.js +0 -664
- package/dist/testing/conformance/transports/actors.d.ts +0 -1907
- package/dist/testing/conformance/transports/actors.js +0 -163
- package/dist/testing/conformance/transports/client.d.ts +0 -3
- package/dist/testing/conformance/transports/client.js +0 -237
- package/dist/testing/conformance/transports/feeds.d.ts +0 -3
- package/dist/testing/conformance/transports/feeds.js +0 -232
- package/dist/testing/conformance/transports/harness.d.ts +0 -93
- package/dist/testing/conformance/transports/harness.js +0 -84
- package/dist/testing/conformance/transports/streams.d.ts +0 -3
- package/dist/testing/conformance/transports/streams.js +0 -96
- package/dist/testing/conformance/transports/websocket.d.ts +0 -3
- package/dist/testing/conformance/transports/websocket.js +0 -384
- package/dist/testing/conformance/transports/wire.d.ts +0 -141
- package/dist/testing/conformance/transports/wire.js +0 -204
- package/dist/testing/conformance/transports.d.ts +0 -3
- package/dist/testing/conformance/transports.js +0 -11
- package/dist/testing/conformance/watch.d.ts +0 -59
- package/dist/testing/conformance/watch.js +0 -879
- package/dist/testing/conformance/workflow-engine.d.ts +0 -97
- package/dist/testing/conformance/workflow-engine.js +0 -253
- package/dist/testing/conformance/workflow-versions.d.ts +0 -3
- package/dist/testing/conformance/workflow-versions.js +0 -545
- package/dist/testing/conformance/workflows/access.d.ts +0 -4
- package/dist/testing/conformance/workflows/access.js +0 -147
- package/dist/testing/conformance/workflows/actors.d.ts +0 -2317
- package/dist/testing/conformance/workflows/actors.js +0 -305
- package/dist/testing/conformance/workflows/basics.d.ts +0 -4
- package/dist/testing/conformance/workflows/basics.js +0 -144
- package/dist/testing/conformance/workflows/engine.d.ts +0 -4
- package/dist/testing/conformance/workflows/engine.js +0 -80
- package/dist/testing/conformance/workflows/guards.d.ts +0 -4
- package/dist/testing/conformance/workflows/guards.js +0 -172
- package/dist/testing/conformance/workflows/harness.d.ts +0 -14
- package/dist/testing/conformance/workflows/harness.js +0 -44
- package/dist/testing/conformance/workflows/recovery.d.ts +0 -4
- package/dist/testing/conformance/workflows/recovery.js +0 -181
- package/dist/testing/conformance/workflows/starts.d.ts +0 -4
- package/dist/testing/conformance/workflows/starts.js +0 -57
- package/dist/testing/conformance/workflows/suspension.d.ts +0 -4
- package/dist/testing/conformance/workflows/suspension.js +0 -106
- package/dist/testing/conformance/workflows/waits.d.ts +0 -4
- package/dist/testing/conformance/workflows/waits.js +0 -284
- package/dist/testing/conformance/workflows.d.ts +0 -4
- package/dist/testing/conformance/workflows.js +0 -19
- package/dist/testing/conformance.d.ts +0 -330
- package/dist/testing/conformance.js +0 -364
- package/dist/testing/foundation.d.ts +0 -41
- package/dist/testing/foundation.js +0 -517
- package/dist/testing/simulate-cluster.d.ts +0 -112
- package/dist/testing/simulate-cluster.js +0 -257
- package/dist/testing/simulate.d.ts +0 -90
- package/dist/testing/simulate.js +0 -127
|
@@ -0,0 +1,255 @@
|
|
|
1
|
+
import { Context, Data, Effect, Stream } from "effect";
|
|
2
|
+
/** How far back an activity or latency read reaches, ending now. */
|
|
3
|
+
export type LiveWindow = "1h" | "24h" | "7d";
|
|
4
|
+
/** The most tenants one runner records turns for; past it the least recently active is dropped. */
|
|
5
|
+
export declare const MAX_RECORDED_TENANTS = 64;
|
|
6
|
+
/** The most command streams one tenant may hold open on one runner. */
|
|
7
|
+
export declare const MAX_TENANT_STREAMS = 4;
|
|
8
|
+
/** The most command streams one runner holds open. */
|
|
9
|
+
export declare const MAX_STREAMS = 64;
|
|
10
|
+
/** The entries a watched tenant's ring keeps for a reconnecting stream. */
|
|
11
|
+
export declare const STREAM_RING = 256;
|
|
12
|
+
/** The entries one stream buffers before it ends with a gap. */
|
|
13
|
+
export declare const STREAM_BUFFER = 1024;
|
|
14
|
+
/** How long a tenant keeps recording stream entries after its last stream ended, so a reconnect resumes. */
|
|
15
|
+
export declare const STREAM_GRACE_MS = 60000;
|
|
16
|
+
/** The longest payload preview, in characters. */
|
|
17
|
+
export declare const PREVIEW_CHARACTERS = 256;
|
|
18
|
+
/** The longest encoded payload or failure a preview or error tag is read from; a longer one has none. */
|
|
19
|
+
export declare const PREVIEW_INPUT_CHARACTERS = 16384;
|
|
20
|
+
/**
|
|
21
|
+
* A short, redacted rendering of a payload encoded as `{ "value": ... }`,
|
|
22
|
+
* null when it carries none or is longer than `PREVIEW_INPUT_CHARACTERS`. A
|
|
23
|
+
* top-level string is never shown, since nothing names what it holds. It is
|
|
24
|
+
* built on the runner, so the payload itself never leaves it.
|
|
25
|
+
*/
|
|
26
|
+
export declare const payloadPreview: (encoded: string) => string | null;
|
|
27
|
+
/** One committed command as a stream carries it; `id` is the stream's epoch and sequence. */
|
|
28
|
+
export interface StreamEntry {
|
|
29
|
+
readonly id: string;
|
|
30
|
+
readonly seq: number;
|
|
31
|
+
readonly commandId: string;
|
|
32
|
+
readonly atMs: number;
|
|
33
|
+
readonly durationMs: number;
|
|
34
|
+
readonly actorType: string;
|
|
35
|
+
readonly actorId: string;
|
|
36
|
+
readonly command: string;
|
|
37
|
+
readonly callerKey: string;
|
|
38
|
+
readonly failed: boolean;
|
|
39
|
+
readonly errorTag: string | null;
|
|
40
|
+
readonly payloadPreview: string | null;
|
|
41
|
+
}
|
|
42
|
+
/** What a stream's subscriber receives: a committed command, or a gap after which entries are missing. */
|
|
43
|
+
export type StreamMessage = Data.TaggedEnum<{
|
|
44
|
+
command: {
|
|
45
|
+
readonly entry: StreamEntry;
|
|
46
|
+
};
|
|
47
|
+
gap: {};
|
|
48
|
+
}>;
|
|
49
|
+
export declare const StreamMessage: {
|
|
50
|
+
readonly $is: <Tag extends "command" | "gap">(tag: Tag) => (u: unknown) => u is Extract<{
|
|
51
|
+
readonly _tag: "command";
|
|
52
|
+
readonly entry: StreamEntry;
|
|
53
|
+
}, {
|
|
54
|
+
readonly _tag: Tag;
|
|
55
|
+
}> | Extract<{
|
|
56
|
+
readonly _tag: "gap";
|
|
57
|
+
}, {
|
|
58
|
+
readonly _tag: Tag;
|
|
59
|
+
}>;
|
|
60
|
+
readonly $match: {
|
|
61
|
+
<Cases extends { readonly [Tag in "command" | "gap"]: (args: Extract<{
|
|
62
|
+
readonly _tag: "command";
|
|
63
|
+
readonly entry: StreamEntry;
|
|
64
|
+
} | {
|
|
65
|
+
readonly _tag: "gap";
|
|
66
|
+
}, {
|
|
67
|
+
readonly _tag: Tag;
|
|
68
|
+
}>) => any; }>(cases: Cases): (value: {
|
|
69
|
+
readonly _tag: "command";
|
|
70
|
+
readonly entry: StreamEntry;
|
|
71
|
+
} | {
|
|
72
|
+
readonly _tag: "gap";
|
|
73
|
+
}) => import("effect/Unify").Unify<ReturnType<Cases["command" | "gap"]>>;
|
|
74
|
+
<Cases extends { readonly [Tag in "command" | "gap"]: (args: Extract<{
|
|
75
|
+
readonly _tag: "command";
|
|
76
|
+
readonly entry: StreamEntry;
|
|
77
|
+
} | {
|
|
78
|
+
readonly _tag: "gap";
|
|
79
|
+
}, {
|
|
80
|
+
readonly _tag: Tag;
|
|
81
|
+
}>) => any; }>(value: {
|
|
82
|
+
readonly _tag: "command";
|
|
83
|
+
readonly entry: StreamEntry;
|
|
84
|
+
} | {
|
|
85
|
+
readonly _tag: "gap";
|
|
86
|
+
}, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["command" | "gap"]>>;
|
|
87
|
+
};
|
|
88
|
+
readonly command: Data.TaggedEnum.ConstructorFrom<{
|
|
89
|
+
readonly _tag: "command";
|
|
90
|
+
readonly entry: StreamEntry;
|
|
91
|
+
}, "_tag">;
|
|
92
|
+
readonly gap: Data.TaggedEnum.ConstructorFrom<{
|
|
93
|
+
readonly _tag: "gap";
|
|
94
|
+
}, "_tag">;
|
|
95
|
+
};
|
|
96
|
+
/** Which committed commands a stream sends: one actor type, failures or successes, or all. */
|
|
97
|
+
export interface StreamFilter {
|
|
98
|
+
readonly actorType?: string | undefined;
|
|
99
|
+
readonly failed?: boolean | undefined;
|
|
100
|
+
}
|
|
101
|
+
/** The fields of a committed command its stream entry is built from, read only when the tenant is watched. */
|
|
102
|
+
export interface StreamSource {
|
|
103
|
+
readonly commandId: string;
|
|
104
|
+
readonly atMs: number;
|
|
105
|
+
readonly durationMs: number;
|
|
106
|
+
readonly actorType: string;
|
|
107
|
+
readonly actorId: string;
|
|
108
|
+
readonly command: string;
|
|
109
|
+
readonly callerKey: string;
|
|
110
|
+
readonly failed: boolean;
|
|
111
|
+
/** The command's encoded payload. */
|
|
112
|
+
readonly payload: string;
|
|
113
|
+
/** The declared failure's encoded value, when the command failed. */
|
|
114
|
+
readonly failure: string | undefined;
|
|
115
|
+
}
|
|
116
|
+
/** Activity over a window: commands per second at each covered slot, oldest first, and each command's volume. */
|
|
117
|
+
export interface Activity {
|
|
118
|
+
readonly since: number;
|
|
119
|
+
readonly points: ReadonlyArray<{
|
|
120
|
+
readonly atMs: number;
|
|
121
|
+
readonly perSecond: number;
|
|
122
|
+
}>;
|
|
123
|
+
readonly commands: ReadonlyArray<{
|
|
124
|
+
readonly command: string;
|
|
125
|
+
readonly count: number;
|
|
126
|
+
readonly perSecond: number;
|
|
127
|
+
}>;
|
|
128
|
+
}
|
|
129
|
+
/** Turn latency over a window: counts per duration bound (the last unbounded) and quantiles. */
|
|
130
|
+
export interface Latency {
|
|
131
|
+
readonly since: number;
|
|
132
|
+
readonly count: number;
|
|
133
|
+
readonly buckets: ReadonlyArray<{
|
|
134
|
+
readonly upToMs: number | null;
|
|
135
|
+
readonly count: number;
|
|
136
|
+
}>;
|
|
137
|
+
readonly p50Ms: number | null;
|
|
138
|
+
readonly p95Ms: number | null;
|
|
139
|
+
readonly p99Ms: number | null;
|
|
140
|
+
}
|
|
141
|
+
/** A type's recent rate and quantiles, or all types' together. */
|
|
142
|
+
export interface Rates {
|
|
143
|
+
/** Commands per second over the current minute and the four before it, from `since`. */
|
|
144
|
+
readonly perSecond: number;
|
|
145
|
+
/** The median turn time over the last hour, from `since`; null with no turn. */
|
|
146
|
+
readonly p50Ms: number | null;
|
|
147
|
+
/** The 99th percentile turn time over the last hour, from `since`; null with no turn. */
|
|
148
|
+
readonly p99Ms: number | null;
|
|
149
|
+
}
|
|
150
|
+
/**
|
|
151
|
+
* Committed turns of this runner, by tenant and actor type, in minute slots
|
|
152
|
+
* for an hour and hour slots for 7 days, and the live command stream. Every
|
|
153
|
+
* read is one tenant's. Nothing here survives the process. A tenant costs a
|
|
154
|
+
* few typed arrays per actor type it ran (about 20 KiB, and under 1 KiB per
|
|
155
|
+
* command), and at most `MAX_RECORDED_TENANTS` are kept.
|
|
156
|
+
*/
|
|
157
|
+
export declare const liveRecorder: (options: {
|
|
158
|
+
readonly startedAtMs: number;
|
|
159
|
+
readonly epoch: string;
|
|
160
|
+
}) => {
|
|
161
|
+
startedAtMs: number;
|
|
162
|
+
/** How many command streams this runner holds open now. */
|
|
163
|
+
streams: () => number;
|
|
164
|
+
/** How many tenants this runner holds a stream ring for now. */
|
|
165
|
+
watched: () => number;
|
|
166
|
+
/** Whether a new stream of `tenant` would be refused now. */
|
|
167
|
+
full: (tenant: string) => boolean;
|
|
168
|
+
/**
|
|
169
|
+
* A window's points are the slots it spans whose time this runner
|
|
170
|
+
* observed: a slot before `since` has none, and a slot's rate divides its
|
|
171
|
+
* count by the seconds of it observed, so the current slot and the one
|
|
172
|
+
* `since` falls in are not diluted.
|
|
173
|
+
*/
|
|
174
|
+
activity: (tenant: string, actorType: string | undefined, window: LiveWindow, nowMs: number) => Activity | undefined;
|
|
175
|
+
latency: (tenant: string, actorType: string | undefined, window: LiveWindow, nowMs: number) => Latency | undefined;
|
|
176
|
+
rates: (tenant: string, actorType: string | undefined, nowMs: number) => Rates | undefined;
|
|
177
|
+
/** The actor types `tenant` committed a turn of on this runner. */
|
|
178
|
+
actorTypes: (tenant: string) => string[];
|
|
179
|
+
/**
|
|
180
|
+
* Counts one command that wrote a receipt. `durationMs` is its turn's
|
|
181
|
+
* transaction time; `nowMs` is the runner's clock when its batch was
|
|
182
|
+
* published, which places it in its minute and hour.
|
|
183
|
+
*/
|
|
184
|
+
record: (tenant: string, actorType: string, command: string, durationMs: number, nowMs: number) => void;
|
|
185
|
+
/**
|
|
186
|
+
* Hands one committed command to the tenant's streams. Unless the tenant
|
|
187
|
+
* has a stream open, or had one within `STREAM_GRACE_MS`, this is one map
|
|
188
|
+
* lookup and `source` is never called. The payload preview is built only
|
|
189
|
+
* when an open stream takes the command, so the ring kept for a reconnect
|
|
190
|
+
* during the grace holds none.
|
|
191
|
+
*/
|
|
192
|
+
publish: (tenant: string, nowMs: number, source: () => StreamSource) => void;
|
|
193
|
+
/**
|
|
194
|
+
* One of `tenant`'s command streams. Its slot is taken only when the
|
|
195
|
+
* stream starts and given back when it ends however it ends, so a request
|
|
196
|
+
* interrupted before its body starts holds none. `after` is the id of the
|
|
197
|
+
* last entry a previous stream sent: entries the ring still holds after it
|
|
198
|
+
* are sent first, and an id from another epoch, or one the ring no longer
|
|
199
|
+
* reaches, sends a gap and ends. A stream that falls `STREAM_BUFFER`
|
|
200
|
+
* entries behind ends with a gap, and so does one opened when this runner
|
|
201
|
+
* already holds `MAX_TENANT_STREAMS` for the tenant or `MAX_STREAMS` in all.
|
|
202
|
+
*/
|
|
203
|
+
subscribe: (tenant: string, filter: StreamFilter, after: string | undefined) => Stream.Stream<StreamMessage>;
|
|
204
|
+
};
|
|
205
|
+
/** The recorder `liveRecorder` builds. */
|
|
206
|
+
export type LiveRecorder = ReturnType<typeof liveRecorder>;
|
|
207
|
+
/** One activation resident on this runner. */
|
|
208
|
+
export interface Resident {
|
|
209
|
+
readonly actorType: string;
|
|
210
|
+
readonly actorId: string;
|
|
211
|
+
/** Commands waiting in its mailbox, not yet taken into a batch. */
|
|
212
|
+
readonly mailbox: number;
|
|
213
|
+
}
|
|
214
|
+
/** One open connection this runner holds or serves. */
|
|
215
|
+
export interface OpenConnection {
|
|
216
|
+
readonly actorType: string;
|
|
217
|
+
readonly actorId: string;
|
|
218
|
+
readonly kind: "socket" | "feed" | "watch" | "stream";
|
|
219
|
+
/** A feed's event names; empty for any other kind. */
|
|
220
|
+
readonly events: ReadonlyArray<string>;
|
|
221
|
+
}
|
|
222
|
+
/** One cron entry a registered actor type declares. */
|
|
223
|
+
export interface DeclaredSchedule {
|
|
224
|
+
readonly actorType: string;
|
|
225
|
+
readonly key: string;
|
|
226
|
+
readonly command: string;
|
|
227
|
+
}
|
|
228
|
+
declare const LiveRuntime_base: Context.ServiceClass<LiveRuntime, "@rikalabs/akter/runtime/telemetry/live/LiveRuntime", {
|
|
229
|
+
/** The recorder, or undefined until `enable` ran. */
|
|
230
|
+
readonly recorder: () => LiveRecorder | undefined;
|
|
231
|
+
/** Builds the recorder on first use and returns it; it counts from then on. */
|
|
232
|
+
readonly enable: Effect.Effect<LiveRecorder>;
|
|
233
|
+
readonly resident: (tenant: string) => ReadonlyArray<Resident>;
|
|
234
|
+
readonly connections: (tenant: string) => ReadonlyArray<OpenConnection>;
|
|
235
|
+
readonly schedules: () => ReadonlyArray<DeclaredSchedule>;
|
|
236
|
+
/** Other runners the cluster's runner storage lists, healthy or not; undefined when unknown. */
|
|
237
|
+
readonly peers: Effect.Effect<number | undefined>;
|
|
238
|
+
/** Counts one served SSE stream member until the returned release runs. */
|
|
239
|
+
readonly streamOpened: (ref: {
|
|
240
|
+
readonly tenant: string;
|
|
241
|
+
readonly actor: string;
|
|
242
|
+
readonly id: string;
|
|
243
|
+
}) => () => void;
|
|
244
|
+
}>;
|
|
245
|
+
/**
|
|
246
|
+
* What this runner knows only in memory, for the inspector's live reads:
|
|
247
|
+
* its recorder, the activations resident on it and their mailboxes, the
|
|
248
|
+
* connections it holds, the cron entries it registers, and how many other
|
|
249
|
+
* runners the cluster lists. Each read names one tenant. The recorder exists
|
|
250
|
+
* only once `enable` ran, which `Inspector.serve` does when it is mounted, so
|
|
251
|
+
* a runtime nobody inspects counts nothing.
|
|
252
|
+
*/
|
|
253
|
+
export declare class LiveRuntime extends LiveRuntime_base {
|
|
254
|
+
}
|
|
255
|
+
export {};
|