@cotal-ai/core 0.169.0 → 0.170.0
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/dist/agent-file.d.ts +9 -5
- package/dist/agent-file.d.ts.map +1 -1
- package/dist/agent-file.js +18 -8
- package/dist/agent-file.js.map +1 -1
- package/dist/anycast-requests.d.ts +8 -1
- package/dist/anycast-requests.d.ts.map +1 -1
- package/dist/anycast-requests.js +47 -0
- package/dist/anycast-requests.js.map +1 -1
- package/dist/backup-config.d.ts +5 -2
- package/dist/backup-config.d.ts.map +1 -1
- package/dist/backup-config.js +7 -2
- package/dist/backup-config.js.map +1 -1
- package/dist/backup.d.ts +6 -0
- package/dist/backup.d.ts.map +1 -1
- package/dist/backup.js +11 -4
- package/dist/backup.js.map +1 -1
- package/dist/endpoint-binding.d.ts.map +1 -1
- package/dist/endpoint-binding.js +2 -0
- package/dist/endpoint-binding.js.map +1 -1
- package/dist/endpoint-channel-discovery.d.ts +102 -0
- package/dist/endpoint-channel-discovery.d.ts.map +1 -0
- package/dist/endpoint-channel-discovery.js +170 -0
- package/dist/endpoint-channel-discovery.js.map +1 -0
- package/dist/endpoint-control-plane.d.ts +204 -0
- package/dist/endpoint-control-plane.d.ts.map +1 -0
- package/dist/endpoint-control-plane.js +627 -0
- package/dist/endpoint-control-plane.js.map +1 -0
- package/dist/endpoint-durable-backstop.d.ts +249 -0
- package/dist/endpoint-durable-backstop.d.ts.map +1 -0
- package/dist/endpoint-durable-backstop.js +485 -0
- package/dist/endpoint-durable-backstop.js.map +1 -0
- package/dist/endpoint-liveness.d.ts +105 -0
- package/dist/endpoint-liveness.d.ts.map +1 -0
- package/dist/endpoint-liveness.js +223 -0
- package/dist/endpoint-liveness.js.map +1 -0
- package/dist/endpoint-messaging.d.ts +229 -0
- package/dist/endpoint-messaging.d.ts.map +1 -0
- package/dist/endpoint-messaging.js +420 -0
- package/dist/endpoint-messaging.js.map +1 -0
- package/dist/endpoint-presence.d.ts +15 -0
- package/dist/endpoint-presence.d.ts.map +1 -1
- package/dist/endpoint-presence.js +35 -0
- package/dist/endpoint-presence.js.map +1 -1
- package/dist/endpoint-subscriptions.d.ts +199 -0
- package/dist/endpoint-subscriptions.d.ts.map +1 -0
- package/dist/endpoint-subscriptions.js +543 -0
- package/dist/endpoint-subscriptions.js.map +1 -0
- package/dist/endpoint.d.ts +32 -91
- package/dist/endpoint.d.ts.map +1 -1
- package/dist/endpoint.js +246 -1744
- package/dist/endpoint.js.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/provision-jwt.d.ts.map +1 -1
- package/dist/provision-jwt.js +1 -0
- package/dist/provision-jwt.js.map +1 -1
- package/dist/provision-permissions.d.ts +1 -1
- package/dist/provision-permissions.d.ts.map +1 -1
- package/dist/provision-permissions.js +3 -0
- package/dist/provision-permissions.js.map +1 -1
- package/dist/run-host.d.ts +4 -1
- package/dist/run-host.d.ts.map +1 -1
- package/dist/run-record.d.ts +4 -0
- package/dist/run-record.d.ts.map +1 -1
- package/dist/run-record.js +36 -0
- package/dist/run-record.js.map +1 -1
- package/dist/space-quiescence-resources.d.ts +30 -0
- package/dist/space-quiescence-resources.d.ts.map +1 -0
- package/dist/space-quiescence-resources.js +45 -0
- package/dist/space-quiescence-resources.js.map +1 -0
- package/package.json +1 -1
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
import { JetStreamApiCodes } from "@nats-io/jetstream";
|
|
2
|
+
import { openChannelRegistry, effectiveReplay, effectiveDeliveryClass, readChannelConfig, readChannelDefaults, decodeChannelEntry, } from "./channels.js";
|
|
3
|
+
import { isPublishPermissionDenied } from "./endpoint.js";
|
|
4
|
+
import { isJetStreamMissing } from "./jetstream-missing.js";
|
|
5
|
+
import { lastKvEntries } from "./kv-scan.js";
|
|
6
|
+
import { CHANNEL_DEFAULTS_KEY, channelBucket, isConcreteChannel } from "./subjects.js";
|
|
7
|
+
/** One endpoint's view of the channel registry: the on-demand read, the cache lookups and the
|
|
8
|
+
* replay and delivery-class policy they answer, and the registry watch or one-shot read that keeps
|
|
9
|
+
* the cache. Internal: `CotalEndpoint` keeps the public methods and forwards to it. */
|
|
10
|
+
export class EndpointChannelDiscovery {
|
|
11
|
+
deps;
|
|
12
|
+
constructor(deps) {
|
|
13
|
+
this.deps = deps;
|
|
14
|
+
}
|
|
15
|
+
get nc() { return this.deps.nc(); }
|
|
16
|
+
get space() { return this.deps.space(); }
|
|
17
|
+
get card() { return this.deps.card(); }
|
|
18
|
+
get doConsume() { return this.deps.doConsume(); }
|
|
19
|
+
get doWatch() { return this.deps.doWatch(); }
|
|
20
|
+
get doWatchChannels() { return this.deps.doWatchChannels(); }
|
|
21
|
+
get channelKv() { return this.deps.channelKv(); }
|
|
22
|
+
set channelWatchIter(iter) { this.deps.setChannelWatchIter(iter); }
|
|
23
|
+
get channelConfigs() { return this.deps.channelConfigs(); }
|
|
24
|
+
get channelDefaults() { return this.deps.channelDefaults(); }
|
|
25
|
+
set channelDefaults(defaults) { this.deps.setChannelDefaults(defaults); }
|
|
26
|
+
get channelRead() { return this.deps.channelRead(); }
|
|
27
|
+
set channelRead(read) { this.deps.setChannelRead(read); }
|
|
28
|
+
get channelReadGeneration() { return this.deps.channelReadGeneration(); }
|
|
29
|
+
set channelReadGeneration(n) { this.deps.setChannelReadGeneration(n); }
|
|
30
|
+
get channelReadApplied() { return this.deps.channelReadApplied(); }
|
|
31
|
+
set channelReadApplied(n) { this.deps.setChannelReadApplied(n); }
|
|
32
|
+
notLiveMsg() { return this.deps.notLiveMsg(); }
|
|
33
|
+
bindKvWatch(kv) { return this.deps.bindKvWatch(kv); }
|
|
34
|
+
emitRecoverable(err) { this.deps.emitRecoverable(err); }
|
|
35
|
+
emit(event, ...args) { return this.deps.emit(event, ...args); }
|
|
36
|
+
/** A consumer that reads presence on demand reads the channel registry on demand too: it holds no
|
|
37
|
+
* watch on either, so a seat binds no consumer per member on these buckets (SPEC §6, §7). */
|
|
38
|
+
get readsChannelsOnDemand() {
|
|
39
|
+
return this.doConsume && this.doWatchChannels && !this.doWatch;
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* Read the channel registry from the broker now, for a consumer that reads presence on demand. One
|
|
43
|
+
* batched Direct Get that binds no consumer, decoded as the watch decodes; the result replaces the
|
|
44
|
+
* cache, so an entry removed since the last read is gone. {@link listChannels} and a join or leave
|
|
45
|
+
* read through here first; other cache readers see the last read.
|
|
46
|
+
*
|
|
47
|
+
* Calls made while a read is in flight share it, and every other call reads anew. A failed read
|
|
48
|
+
* throws and changes nothing. A credential that may not make the read is refused with the grant it lacks.
|
|
49
|
+
*/
|
|
50
|
+
async readChannels() {
|
|
51
|
+
if (!this.readsChannelsOnDemand)
|
|
52
|
+
throw new Error("readChannels is for a consumer that reads presence on demand; this endpoint watches the channel registry or keeps no cache of it");
|
|
53
|
+
const kv = this.channelKv;
|
|
54
|
+
if (!kv)
|
|
55
|
+
throw new Error(this.notLiveMsg());
|
|
56
|
+
if (this.channelRead)
|
|
57
|
+
return this.channelRead;
|
|
58
|
+
const generation = ++this.channelReadGeneration;
|
|
59
|
+
const read = (async () => {
|
|
60
|
+
let entries;
|
|
61
|
+
try {
|
|
62
|
+
entries = await lastKvEntries(kv);
|
|
63
|
+
}
|
|
64
|
+
catch (e) {
|
|
65
|
+
if (!isPublishPermissionDenied(e))
|
|
66
|
+
throw e;
|
|
67
|
+
throw new Error(`channel registry read refused for ${this.card.id}: this credential may not publish $JS.API.DIRECT.GET.KV_${channelBucket(this.space)}, the on-demand registry read (SPEC Appendix B). A credential minted by an older issuer can lack this grant even when newly minted; upgrade the manager or auth service that issues credentials, then mint a new credential. Reusing credentials or reconnecting does not add the grant.`, { cause: e });
|
|
68
|
+
}
|
|
69
|
+
if (generation <= this.channelReadApplied)
|
|
70
|
+
return;
|
|
71
|
+
this.channelReadApplied = generation;
|
|
72
|
+
this.channelConfigs.clear();
|
|
73
|
+
this.channelDefaults = {};
|
|
74
|
+
for (const e of entries)
|
|
75
|
+
this.handleChannelEntry(e);
|
|
76
|
+
})();
|
|
77
|
+
this.channelRead = read;
|
|
78
|
+
const settled = () => { if (this.channelRead === read)
|
|
79
|
+
this.channelRead = undefined; };
|
|
80
|
+
read.then(settled, settled);
|
|
81
|
+
return read;
|
|
82
|
+
}
|
|
83
|
+
/** This channel's registry config from the local cache (undefined if unset). */
|
|
84
|
+
getChannelConfig(channel) {
|
|
85
|
+
return this.channelConfigs.get(channel);
|
|
86
|
+
}
|
|
87
|
+
/** Effective replay-on-join policy for a channel: per-channel override ?? space default ??
|
|
88
|
+
* true. Reads the live cache, so it reflects runtime registry edits. */
|
|
89
|
+
channelReplay(channel) {
|
|
90
|
+
return effectiveReplay(this.channelConfigs.get(channel), this.channelDefaults);
|
|
91
|
+
}
|
|
92
|
+
/** Effective replay window for a channel (per-channel override ?? space default), or undefined
|
|
93
|
+
* for the full retained window. Only meaningful when {@link channelReplay} is true. */
|
|
94
|
+
channelReplayWindow(channel) {
|
|
95
|
+
return this.channelConfigs.get(channel)?.replayWindow ?? this.channelDefaults.replayWindow;
|
|
96
|
+
}
|
|
97
|
+
/** A channel's effective replay policy read straight from the registry bucket, for a caller that
|
|
98
|
+
* reads it right after start, before any watch cache has caught up, or that watches nothing. A
|
|
99
|
+
* wildcard reads the space defaults only. A space with no registry bucket has the built-in policy.
|
|
100
|
+
* `registered` says whether the channel has its own registry entry. */
|
|
101
|
+
async channelReplayPolicy(channel) {
|
|
102
|
+
if (!this.nc)
|
|
103
|
+
throw new Error(this.notLiveMsg());
|
|
104
|
+
const kv = this.channelKv ?? (await openChannelRegistry(this.nc, this.space, { create: false }));
|
|
105
|
+
let cfg;
|
|
106
|
+
let defaults;
|
|
107
|
+
try {
|
|
108
|
+
[cfg, defaults] = await Promise.all([
|
|
109
|
+
isConcreteChannel(channel) ? readChannelConfig(kv, channel) : Promise.resolve(undefined),
|
|
110
|
+
readChannelDefaults(kv),
|
|
111
|
+
]);
|
|
112
|
+
}
|
|
113
|
+
catch (e) {
|
|
114
|
+
// `open` binds lazily, so a space with no registry bucket surfaces on the first read.
|
|
115
|
+
if (!isJetStreamMissing(e, JetStreamApiCodes.StreamNotFound))
|
|
116
|
+
throw e;
|
|
117
|
+
}
|
|
118
|
+
return { replay: effectiveReplay(cfg, defaults), window: cfg?.replayWindow ?? defaults?.replayWindow ?? null, registered: cfg !== undefined };
|
|
119
|
+
}
|
|
120
|
+
/** Effective delivery class for a channel (per-channel override ?? space default ?? "durable"),
|
|
121
|
+
* from the live watch cache — drives the non-gating delivery-health surface (only durable-class
|
|
122
|
+
* channels have a Plane-3 backstop to report on). */
|
|
123
|
+
channelDeliveryClass(channel) {
|
|
124
|
+
return effectiveDeliveryClass(this.channelConfigs.get(channel), this.channelDefaults);
|
|
125
|
+
}
|
|
126
|
+
/** Watch the channel registry: replay existing keys, then stream updates, into the local
|
|
127
|
+
* cache. A failed bind throws out of connect; an entry that does not decode or validate is
|
|
128
|
+
* reported as a `warning` and dropped, so its channel resolves to the default policy. */
|
|
129
|
+
async startChannelWatch() {
|
|
130
|
+
if (!this.channelKv)
|
|
131
|
+
return;
|
|
132
|
+
const bound = await this.bindKvWatch(this.channelKv);
|
|
133
|
+
if (!bound)
|
|
134
|
+
return;
|
|
135
|
+
const { iter } = bound;
|
|
136
|
+
this.channelWatchIter = iter;
|
|
137
|
+
void (async () => {
|
|
138
|
+
for await (const e of iter)
|
|
139
|
+
this.handleChannelEntry(e);
|
|
140
|
+
})().catch((e) => this.emit("error", e));
|
|
141
|
+
}
|
|
142
|
+
/** {@link EndpointOptions.readOnce}: fill the channel cache from one read of the registry. */
|
|
143
|
+
async readChannelsOnce() {
|
|
144
|
+
if (!this.channelKv)
|
|
145
|
+
return;
|
|
146
|
+
for (const e of await lastKvEntries(this.channelKv))
|
|
147
|
+
this.handleChannelEntry(e);
|
|
148
|
+
}
|
|
149
|
+
handleChannelEntry(e) {
|
|
150
|
+
// Cleared before the decode, so an entry that does not decode resolves to the default as the
|
|
151
|
+
// fresh registry reads do.
|
|
152
|
+
const isDefaults = e.key === CHANNEL_DEFAULTS_KEY;
|
|
153
|
+
if (isDefaults)
|
|
154
|
+
this.channelDefaults = {};
|
|
155
|
+
else
|
|
156
|
+
this.channelConfigs.delete(e.key);
|
|
157
|
+
if (e.operation === "DEL" || e.operation === "PURGE")
|
|
158
|
+
return;
|
|
159
|
+
try {
|
|
160
|
+
if (isDefaults)
|
|
161
|
+
this.channelDefaults = decodeChannelEntry(e);
|
|
162
|
+
else
|
|
163
|
+
this.channelConfigs.set(e.key, decodeChannelEntry(e));
|
|
164
|
+
}
|
|
165
|
+
catch (err) {
|
|
166
|
+
this.emitRecoverable(new Error(`dropped channel registry entry for key ${JSON.stringify(e.key)}: ${err.message}`));
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
//# sourceMappingURL=endpoint-channel-discovery.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"endpoint-channel-discovery.js","sourceRoot":"","sources":["../src/endpoint-channel-discovery.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
import { type Msg, type NatsConnection, type Subscription } from "@nats-io/transport-node";
|
|
2
|
+
import { type ResolvedService, type SubmitAndFollowGoalOptions } from "./endpoint-invoke.js";
|
|
3
|
+
import type { EpCaller, IssuedCaller } from "./endpoint-subjects.js";
|
|
4
|
+
import { type RegistryEndpointsInput, type RegistryEndpointsOutput } from "./registry-contract.js";
|
|
5
|
+
import type { EpVerbTarget, EpAttributedReply } from "./endpoint-verbs.js";
|
|
6
|
+
import type { ControlReply, ControlRequest, ControlRequestInit, EndpointRef } from "./types.js";
|
|
7
|
+
/** One goal follower {@link EndpointControlPlane.followServiceGoal} registers with its endpoint. */
|
|
8
|
+
type GoalFollower = {
|
|
9
|
+
cancel: () => void;
|
|
10
|
+
reconnected: (nc: NatsConnection) => void;
|
|
11
|
+
};
|
|
12
|
+
/** What the control plane reads from its endpoint. State is read when it is used, never copied, and
|
|
13
|
+
* every method is looked up on the endpoint at call time. */
|
|
14
|
+
export interface EndpointControlPlaneDeps {
|
|
15
|
+
nc: () => NatsConnection | undefined;
|
|
16
|
+
space: () => string;
|
|
17
|
+
owner: () => string;
|
|
18
|
+
actor: () => string;
|
|
19
|
+
stopped: () => boolean;
|
|
20
|
+
authed: () => boolean;
|
|
21
|
+
connId: () => string;
|
|
22
|
+
presentedExp: () => number | undefined;
|
|
23
|
+
issuedGeneration: () => string | undefined;
|
|
24
|
+
acceptedToken: () => string | undefined;
|
|
25
|
+
rebuildPromise: () => Promise<void> | undefined;
|
|
26
|
+
subs: () => Subscription[];
|
|
27
|
+
resolvedServices: () => Map<string, ResolvedService>;
|
|
28
|
+
resolvedCommandServices: () => Map<string, Map<string, ResolvedService>>;
|
|
29
|
+
serviceInvocations: () => WeakMap<NatsConnection, Set<Promise<void>>>;
|
|
30
|
+
requestsAwaitingReply: () => Map<NatsConnection, Set<(error: Error) => void>>;
|
|
31
|
+
activeGoalFollowers: () => Set<GoalFollower>;
|
|
32
|
+
splitsRecovered: () => number;
|
|
33
|
+
setSplitsRecovered: (count: number) => void;
|
|
34
|
+
notLiveMsg: () => string;
|
|
35
|
+
requireLifecycleUid: (what: string) => string;
|
|
36
|
+
reportSubscriptionDenial: (error: unknown) => boolean;
|
|
37
|
+
ref: () => EndpointRef;
|
|
38
|
+
reconnect: () => Promise<void>;
|
|
39
|
+
emit: (event: string, ...args: unknown[]) => boolean;
|
|
40
|
+
}
|
|
41
|
+
/** The request/reply control plane of one endpoint (serve, answer and request control, with the
|
|
42
|
+
* bound reply every request rides) and its service-invocation client (describe, list, invoke,
|
|
43
|
+
* and follow a goal). Internal: `CotalEndpoint` keeps the public methods and forwards to it. */
|
|
44
|
+
export declare class EndpointControlPlane {
|
|
45
|
+
private readonly deps;
|
|
46
|
+
constructor(deps: EndpointControlPlaneDeps);
|
|
47
|
+
private get nc();
|
|
48
|
+
private get space();
|
|
49
|
+
private get owner();
|
|
50
|
+
private get actor();
|
|
51
|
+
private get stopped();
|
|
52
|
+
private get authed();
|
|
53
|
+
private get connId();
|
|
54
|
+
private get presentedExp();
|
|
55
|
+
private get issuedGeneration();
|
|
56
|
+
private get acceptedToken();
|
|
57
|
+
private get rebuildPromise();
|
|
58
|
+
private get subs();
|
|
59
|
+
private get resolvedServices();
|
|
60
|
+
private get resolvedCommandServices();
|
|
61
|
+
private get serviceInvocations();
|
|
62
|
+
private get requestsAwaitingReply();
|
|
63
|
+
private get activeGoalFollowers();
|
|
64
|
+
private get splitsRecovered();
|
|
65
|
+
private set splitsRecovered(value);
|
|
66
|
+
private notLiveMsg;
|
|
67
|
+
private requireLifecycleUid;
|
|
68
|
+
private reportSubscriptionDenial;
|
|
69
|
+
private ref;
|
|
70
|
+
private reconnect;
|
|
71
|
+
private emit;
|
|
72
|
+
/** Serve control requests for a service. Returns the subscription so a caller that re-registers on
|
|
73
|
+
* reconnect (the delivery daemon) can drop the stale one. `boundReply` is REQUIRED for any service
|
|
74
|
+
* whose responder holds a wildcard publish grant over the service subtree (the delivery daemon's
|
|
75
|
+
* `ctl.delivery.*.*.reply.>`): without it, an authenticated caller could set its reply target to a
|
|
76
|
+
* PEER's reply lane (`ctl.delivery.<victim>.reply.<n>`) and turn the responder into a confused
|
|
77
|
+
* deputy — the broker does NOT permission-check the requester's embedded reply subject. With it, a
|
|
78
|
+
* reply is published only when `m.reply` is under the AUTHENTICATED request subject
|
|
79
|
+
* (`${m.subject}.reply.…`), binding the reply to the broker-policed sender token.
|
|
80
|
+
*
|
|
81
|
+
* Requests are answered one at a time, in arrival order. A request `concurrent` accepts is answered
|
|
82
|
+
* in its own time instead: it waits for none of the requests in front of it, including one still
|
|
83
|
+
* running, and holds up none behind it. Only for a request that shares no state with the service's
|
|
84
|
+
* other requests. */
|
|
85
|
+
serveControl(service: string, handler: (req: ControlRequest) => Promise<ControlReply> | ControlReply, opts?: {
|
|
86
|
+
boundReply?: boolean;
|
|
87
|
+
concurrent?: (req: ControlRequest) => boolean;
|
|
88
|
+
}): import("@nats-io/transport-node").Subscription;
|
|
89
|
+
/** Answer one control request for {@link serveControl}: the sender guard, the handler, and the reply. */
|
|
90
|
+
private answerControl;
|
|
91
|
+
/** Keep native named-reply and NoResponders handling, but settle when its connection closes:
|
|
92
|
+
* nats.js can close a no-mux subscription without settling its request. One close observer per
|
|
93
|
+
* connection avoids retaining a closed-promise callback for every completed request. */
|
|
94
|
+
requestBoundReply(nc: NatsConnection, subject: string, body: string, reply: string, timeoutMs: number): Promise<Msg>;
|
|
95
|
+
/** Send a control request to a service and await its reply (client side). Like {@link requestDelivery},
|
|
96
|
+
* the reply rides a BOUNDED subject UNDER the request subject (`ctl.<service>.<id>.reply.<uuid>`), not
|
|
97
|
+
* the per-id `_INBOX`.
|
|
98
|
+
* `noMux` lets us name the reply subject while keeping NoResponders detection. The random suffix is
|
|
99
|
+
* defense-in-depth (a predictable suffix would let a peer target an in-flight named reply sub). The
|
|
100
|
+
* reply sits under the sender's OWN request subject, so the responder's `boundReply` guard accepts it. */
|
|
101
|
+
requestControl(service: string, req: ControlRequestInit, timeoutMs?: number): Promise<ControlReply>;
|
|
102
|
+
/** The caller this connection's endpoint requests ride as: the legacy triple, or the issued
|
|
103
|
+
* caller with its discovered generation (SPEC 13.15). It names the reply rail this connection's
|
|
104
|
+
* credential reads, which is where a manager's turn notice for it lands (SPEC 14.3). */
|
|
105
|
+
serviceRailCaller(): EpCaller;
|
|
106
|
+
/** This endpoint's v0.4 caller triple (§13.2) — the identity its minted ep-rail rows pin. The
|
|
107
|
+
* owner/actor principal is mode-correct by construction (static: DEV_OWNER + the connection
|
|
108
|
+
* identity; user mode: the bearer's callout-derived pair), and the lifecycle UID is the
|
|
109
|
+
* launcher-supplied incarnation the rows are keyed on (ledger-consistent: the §13.1 presence
|
|
110
|
+
* lifecycle-proof refuses a divergent uid before any publish). */
|
|
111
|
+
private serviceCaller;
|
|
112
|
+
/** Follow this caller's goal on its standing connection, subscribing before submission.
|
|
113
|
+
* A submitter may use a separate short-lived control credential for the same caller triple;
|
|
114
|
+
* the accepted action's readiness budget can outlive that credential. This endpoint retains
|
|
115
|
+
* its existing credential renewal and caller-scoped progress grants. */
|
|
116
|
+
followServiceGoal(endpoint: string, submit: (signal?: AbortSignal) => Promise<EpAttributedReply>, deadlineMs?: number, opts?: Pick<SubmitAndFollowGoalOptions, "reconcile" | "signal" | "prepare">): Promise<EpAttributedReply>;
|
|
117
|
+
/** Drop every cached handle for one endpoint after refresh or a currency split. */
|
|
118
|
+
private clearResolvedService;
|
|
119
|
+
/** Hold connection recovery through the whole pre-acceptance phase, including the progress
|
|
120
|
+
* subscription flush. Release on setup failure or the command's answer, never on goal terminal. */
|
|
121
|
+
private beginServiceInvocation;
|
|
122
|
+
private waitServiceRecovery;
|
|
123
|
+
/** The resolved, digest-verified command surface of `endpoint` as this connection's caller sees
|
|
124
|
+
* it. Unpinned calls cache the complete discovery surface, and `refresh` drops both the full
|
|
125
|
+
* handle and any command-specific invocation handles. `instanceId` selects one instance without
|
|
126
|
+
* reading or populating either class cache, as a pinned invoke does. The caller's existing
|
|
127
|
+
* credential must permit that route. */
|
|
128
|
+
describeService(endpoint: string, opts?: {
|
|
129
|
+
deadlineMs?: number;
|
|
130
|
+
signal?: AbortSignal;
|
|
131
|
+
refresh?: boolean;
|
|
132
|
+
instanceId?: string;
|
|
133
|
+
}): Promise<ResolvedService>;
|
|
134
|
+
/** The caller a registry listing rides (SPEC 13.15). An issued connection lists as itself. Any
|
|
135
|
+
* other connection reads the listing generation the issuer bound to the credential it presented,
|
|
136
|
+
* under the token its connection id and that credential's expiry derive. `undefined`: that
|
|
137
|
+
* credential carries no listing binding, because it predates listing issuance or has no expiry. */
|
|
138
|
+
listingCaller(): Promise<IssuedCaller | undefined>;
|
|
139
|
+
/** One page of the registry's `endpoints` answer (SPEC 13.20) over this connection
|
|
140
|
+
* ({@link listRegistryEndpoints}). The describe rides this connection's own caller; the question
|
|
141
|
+
* rides the listing caller on an authed mesh. `unbound`: this credential carries no listing
|
|
142
|
+
* binding. */
|
|
143
|
+
listEndpoints(input: RegistryEndpointsInput, opts?: {
|
|
144
|
+
deadlineMs?: number;
|
|
145
|
+
signal?: AbortSignal;
|
|
146
|
+
}): Promise<{
|
|
147
|
+
unbound: true;
|
|
148
|
+
} | {
|
|
149
|
+
unbound?: false;
|
|
150
|
+
reply: EpAttributedReply;
|
|
151
|
+
page?: RegistryEndpointsOutput;
|
|
152
|
+
}>;
|
|
153
|
+
/** Ask the registry over `nc` under `listing`: this connection, or another of this caller triple
|
|
154
|
+
* such as a manager-call connection. The describe rides this connection, whose view holds the
|
|
155
|
+
* registry's describe. Every endpoint the page lists has its cached describe dropped, so the next
|
|
156
|
+
* describe of it reads the surface afresh. `unbound`: the broker refused the question under
|
|
157
|
+
* `listing`, whose credential holds no listing row. */
|
|
158
|
+
listEndpointsOver(nc: NatsConnection, listing: IssuedCaller | undefined, input: RegistryEndpointsInput, opts?: {
|
|
159
|
+
deadlineMs?: number;
|
|
160
|
+
signal?: AbortSignal;
|
|
161
|
+
}): Promise<{
|
|
162
|
+
unbound: true;
|
|
163
|
+
} | {
|
|
164
|
+
unbound?: false;
|
|
165
|
+
reply: EpAttributedReply;
|
|
166
|
+
page?: RegistryEndpointsOutput;
|
|
167
|
+
}>;
|
|
168
|
+
/** GENERIC v0.4 service invoke over this endpoint's own connection: resolve
|
|
169
|
+
* the named endpoint's registered surface — describe, §13.7 store fetch, digest-verified
|
|
170
|
+
* recompile ({@link resolveService}; cached per endpoint name) — and invoke one command. The
|
|
171
|
+
* resolve is describe-bound currency, and a call that reaches the wrong incarnation is recovered
|
|
172
|
+
* two ways depending on WHO caught it — the difference between knowing the command did not run
|
|
173
|
+
* and only knowing someone answered:
|
|
174
|
+
* - the RESPONDER fenced it on the request's `bind` (§13.2, an `ok:false` reply marked
|
|
175
|
+
* {@link replyRefusedBeforeEffect}): the command did not run, so the bind is dropped and the
|
|
176
|
+
* call re-issued for any command, up to {@link BIND_SPLIT_REISSUES} times while each re-issue
|
|
177
|
+
* is refused the same way. If a re-issue cannot be resolved, the refusal
|
|
178
|
+
* surfaces — still saying the command did not run — naming the resolve failure as why the
|
|
179
|
+
* repair could not be attempted. An unpinned targeted call that reached a member holding no
|
|
180
|
+
* mapping for its target ({@link replyTargetUnmapped}) is repaired the same way, and when the
|
|
181
|
+
* re-issues run out, the latest such refusal is the one surfaced.
|
|
182
|
+
* - this CLIENT caught it on the reply ({@link respondedButUnbound}: a different instance,
|
|
183
|
+
* `failed-precondition`; the same instance at any other epoch, `expired`), which is what a
|
|
184
|
+
* responder too old to know the field produces. A live instance received and answered it, so
|
|
185
|
+
* the bind is dropped but the call is re-issued only for a command on the
|
|
186
|
+
* {@link isRepeatSafeCommand} allowlist; anything else surfaces, since a second attempt could
|
|
187
|
+
* duplicate its effect.
|
|
188
|
+
* A broker permission refusal marked `not-executed` rebuilds the connection and retries once
|
|
189
|
+
* within the original deadline. A second refusal stands. Responder errors and calls that may
|
|
190
|
+
* have run never trigger this repair.
|
|
191
|
+
* Errors from the responder come back structurally on the attributed reply
|
|
192
|
+
* (`reply.ok === false`); transport/validation refusals throw {@link EpEnvelopeError}. */
|
|
193
|
+
invokeService(endpoint: string, command: string, args?: Record<string, unknown>, opts?: {
|
|
194
|
+
target?: EpVerbTarget;
|
|
195
|
+
deadlineMs?: number;
|
|
196
|
+
follow?: boolean;
|
|
197
|
+
signal?: AbortSignal;
|
|
198
|
+
instanceId?: string;
|
|
199
|
+
classInstanceId?: string;
|
|
200
|
+
}): Promise<EpAttributedReply>;
|
|
201
|
+
private invokeServiceOnce;
|
|
202
|
+
}
|
|
203
|
+
export {};
|
|
204
|
+
//# sourceMappingURL=endpoint-control-plane.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"endpoint-control-plane.d.ts","sourceRoot":"","sources":["../src/endpoint-control-plane.ts"],"names":[],"mappings":"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"}
|