agl 43.7.0 → 43.8.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/changelog.md +17 -0
- package/dist_serve/bundle.js +786 -786
- package/dist_serve/bundle.js.map +2 -2
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/interfaces.d.ts +35 -0
- package/dist_ts/aglapi/interfaces.js +9 -1
- package/dist_ts/classes.apnsclient.d.ts +97 -0
- package/dist_ts/classes.apnsclient.js +363 -0
- package/dist_ts/classes.authmodels.js +19 -6
- package/dist_ts/classes.authstore.js +15 -2
- package/dist_ts/classes.cli.js +8 -1
- package/dist_ts/classes.controller.d.ts +30 -3
- package/dist_ts/classes.controller.js +250 -9
- package/dist_ts/classes.controllerdevices.d.ts +35 -7
- package/dist_ts/classes.controllerdevices.js +86 -13
- package/dist_ts/classes.controllerpush.d.ts +111 -0
- package/dist_ts/classes.controllerpush.js +299 -0
- package/dist_ts/classes.fcmclient.d.ts +78 -0
- package/dist_ts/classes.fcmclient.js +278 -0
- package/dist_ts/classes.inbox.d.ts +10 -2
- package/dist_ts/classes.inbox.js +9 -2
- package/dist_ts/classes.mcpclient.d.ts +5 -0
- package/dist_ts/classes.mcpclient.js +18 -6
- package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -0
- package/dist_ts/classes.mcpcontrollerhost.js +19 -1
- package/dist_ts/classes.mcpvalidation.js +4 -1
- package/dist_ts/classes.mcpworkercaller.d.ts +6 -0
- package/dist_ts/classes.mcpworkercaller.js +26 -4
- package/dist_ts/classes.pushdelivery.d.ts +115 -0
- package/dist_ts/classes.pushdelivery.js +311 -0
- package/dist_ts/classes.pushhandover.d.ts +46 -0
- package/dist_ts/classes.pushhandover.js +131 -0
- package/dist_ts/classes.pushregistrations.d.ts +96 -0
- package/dist_ts/classes.pushregistrations.js +263 -0
- package/dist_ts/classes.pushsettings.d.ts +125 -0
- package/dist_ts/classes.pushsettings.js +377 -0
- package/dist_ts/classes.workercallers.d.ts +73 -2
- package/dist_ts/classes.workercallers.js +354 -43
- package/dist_ts/driver/classes.directreports.d.ts +5 -0
- package/dist_ts/driver/classes.directreports.js +3 -2
- package/dist_ts/fleet/classes.workerlaunches.d.ts +6 -4
- package/dist_ts/fleet/classes.workerlaunches.js +10 -9
- package/dist_ts/fleet/classes.workers.d.ts +12 -2
- package/dist_ts/fleet/classes.workers.js +82 -2
- package/dist_ts/functions.deviceapi.d.ts +23 -3
- package/dist_ts/functions.deviceapi.js +41 -3
- package/dist_ts/functions.pushcli.d.ts +43 -0
- package/dist_ts/functions.pushcli.js +201 -0
- package/dist_ts/functions.pushcredentials.d.ts +53 -0
- package/dist_ts/functions.pushcredentials.js +111 -0
- package/dist_ts/functions.pushwire.d.ts +8 -0
- package/dist_ts/functions.pushwire.js +83 -0
- package/dist_ts/functions.remotecli.d.ts +2 -2
- package/dist_ts/functions.remotecli.js +4 -4
- package/dist_ts/functions.workercallervalidation.js +3 -2
- package/dist_ts/functions.workerprocessproof.d.ts +12 -0
- package/dist_ts/functions.workerprocessproof.js +32 -1
- package/dist_ts/interfaces.auth.d.ts +27 -3
- package/dist_ts/interfaces.auth.js +9 -1
- package/dist_ts/interfaces.lifecycle.d.ts +7 -1
- package/dist_ts/interfaces.push.d.ts +69 -0
- package/dist_ts/interfaces.push.js +25 -0
- package/dist_ts/plugins.d.ts +3 -1
- package/dist_ts/plugins.js +4 -2
- package/dist_ts_interfaces/devices.d.ts +178 -2
- package/dist_ts_interfaces/devices.js +24 -2
- package/dist_ts_interfaces/index.d.ts +1 -0
- package/dist_ts_interfaces/index.js +2 -1
- package/dist_ts_interfaces/mcprequests.d.ts +3 -2
- package/dist_ts_interfaces/mcprequests.js +3 -1
- package/dist_ts_interfaces/push.d.ts +166 -0
- package/dist_ts_interfaces/push.js +24 -0
- package/dist_ts_interfaces/workercallers.d.ts +43 -3
- package/package.json +1 -1
- package/readme.md +64 -11
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/interfaces.ts +8 -0
- package/ts/classes.apnsclient.ts +389 -0
- package/ts/classes.authmodels.ts +21 -5
- package/ts/classes.authstore.ts +14 -1
- package/ts/classes.cli.ts +7 -0
- package/ts/classes.controller.ts +273 -7
- package/ts/classes.controllerdevices.ts +94 -12
- package/ts/classes.controllerpush.ts +351 -0
- package/ts/classes.fcmclient.ts +292 -0
- package/ts/classes.inbox.ts +13 -2
- package/ts/classes.mcpclient.ts +20 -5
- package/ts/classes.mcpcontrollerhost.ts +20 -0
- package/ts/classes.mcpvalidation.ts +2 -0
- package/ts/classes.mcpworkercaller.ts +24 -2
- package/ts/classes.pushdelivery.ts +378 -0
- package/ts/classes.pushhandover.ts +98 -0
- package/ts/classes.pushregistrations.ts +244 -0
- package/ts/classes.pushsettings.ts +428 -0
- package/ts/classes.workercallers.ts +329 -37
- package/ts/driver/classes.directreports.ts +7 -1
- package/ts/fleet/classes.workerlaunches.ts +9 -7
- package/ts/fleet/classes.workers.ts +65 -2
- package/ts/functions.deviceapi.ts +52 -2
- package/ts/functions.pushcli.ts +212 -0
- package/ts/functions.pushcredentials.ts +129 -0
- package/ts/functions.pushwire.ts +106 -0
- package/ts/functions.remotecli.ts +3 -2
- package/ts/functions.workercallervalidation.ts +2 -1
- package/ts/functions.workerprocessproof.ts +34 -0
- package/ts/interfaces.auth.ts +26 -3
- package/ts/interfaces.lifecycle.ts +7 -1
- package/ts/interfaces.push.ts +78 -0
- package/ts/plugins.ts +3 -1
- package/ts_interfaces/devices.schema.json +327 -0
- package/ts_interfaces/devices.ts +206 -1
- package/ts_interfaces/index.ts +1 -0
- package/ts_interfaces/mcprequests.ts +3 -0
- package/ts_interfaces/push.ts +162 -0
- package/ts_interfaces/workercallers.ts +34 -2
- package/ts_web/00_commitinfo_data.ts +1 -1
|
@@ -0,0 +1,377 @@
|
|
|
1
|
+
var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
|
|
2
|
+
function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
|
|
3
|
+
var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
|
|
4
|
+
var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
|
|
5
|
+
var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
|
|
6
|
+
var _, done = false;
|
|
7
|
+
for (var i = decorators.length - 1; i >= 0; i--) {
|
|
8
|
+
var context = {};
|
|
9
|
+
for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
|
|
10
|
+
for (var p in contextIn.access) context.access[p] = contextIn.access[p];
|
|
11
|
+
context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
|
|
12
|
+
var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
|
|
13
|
+
if (kind === "accessor") {
|
|
14
|
+
if (result === void 0) continue;
|
|
15
|
+
if (result === null || typeof result !== "object") throw new TypeError("Object expected");
|
|
16
|
+
if (_ = accept(result.get)) descriptor.get = _;
|
|
17
|
+
if (_ = accept(result.set)) descriptor.set = _;
|
|
18
|
+
if (_ = accept(result.init)) initializers.unshift(_);
|
|
19
|
+
}
|
|
20
|
+
else if (_ = accept(result)) {
|
|
21
|
+
if (kind === "field") initializers.unshift(_);
|
|
22
|
+
else descriptor[key] = _;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
if (target) Object.defineProperty(target, contextIn.name, descriptor);
|
|
26
|
+
done = true;
|
|
27
|
+
};
|
|
28
|
+
var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
|
|
29
|
+
var useValue = arguments.length > 2;
|
|
30
|
+
for (var i = 0; i < initializers.length; i++) {
|
|
31
|
+
value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
|
|
32
|
+
}
|
|
33
|
+
return useValue ? value : void 0;
|
|
34
|
+
};
|
|
35
|
+
import * as plugins from './plugins.js';
|
|
36
|
+
import { isPushVendorReason } from './interfaces.push.js';
|
|
37
|
+
import { isApnsSigningKey, isAppleId, isBundleId, isFirebaseProjectId, isServiceAccountEmail, isServiceAccountKeyId, isServiceAccountSigningKey, privateKeyBytes, privateKeyFromBytes, } from './functions.pushcredentials.js';
|
|
38
|
+
/** The stored document's `content` is bounded plain JSON. */
|
|
39
|
+
const maximumContentBytes = 64 * 1024;
|
|
40
|
+
const isPlainObject = (valueArg) => (!!valueArg && typeof valueArg === 'object' && !Array.isArray(valueArg)
|
|
41
|
+
&& (Object.getPrototypeOf(valueArg) === Object.prototype || Object.getPrototypeOf(valueArg) === null));
|
|
42
|
+
const assertDocument = (valueArg) => {
|
|
43
|
+
const value = valueArg;
|
|
44
|
+
let size = Number.POSITIVE_INFINITY;
|
|
45
|
+
try {
|
|
46
|
+
size = Buffer.byteLength(JSON.stringify(value?.content), 'utf8');
|
|
47
|
+
}
|
|
48
|
+
catch { /* refused below */ }
|
|
49
|
+
if (!isPlainObject(value)
|
|
50
|
+
|| Object.keys(value).length !== 2
|
|
51
|
+
|| typeof value.id !== 'string' || !/^controller:[1-9][0-9]{0,4}$/u.test(value.id)
|
|
52
|
+
|| !isPlainObject(value.content)
|
|
53
|
+
|| size > maximumContentBytes) {
|
|
54
|
+
throw new Error('Invalid push settings record.');
|
|
55
|
+
}
|
|
56
|
+
};
|
|
57
|
+
let ControllerPushSettingsModel = (() => {
|
|
58
|
+
let _classDecorators = [plugins.nosqldb.managed({ collectionName: 'agl_controller_push_settings' }), plugins.nosqldb.exactPersistence({ assertDocument })];
|
|
59
|
+
let _classDescriptor;
|
|
60
|
+
let _classExtraInitializers = [];
|
|
61
|
+
let _classThis;
|
|
62
|
+
let _classSuper = plugins.nosqldb.SmartDataDbDoc;
|
|
63
|
+
let _id_decorators;
|
|
64
|
+
let _id_initializers = [];
|
|
65
|
+
let _id_extraInitializers = [];
|
|
66
|
+
let _content_decorators;
|
|
67
|
+
let _content_initializers = [];
|
|
68
|
+
let _content_extraInitializers = [];
|
|
69
|
+
var ControllerPushSettingsModel = class extends _classSuper {
|
|
70
|
+
static { _classThis = this; }
|
|
71
|
+
static {
|
|
72
|
+
const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
|
|
73
|
+
_id_decorators = [plugins.nosqldb.unI()];
|
|
74
|
+
_content_decorators = [plugins.nosqldb.svDb()];
|
|
75
|
+
__esDecorate(null, null, _id_decorators, { kind: "field", name: "id", static: false, private: false, access: { has: obj => "id" in obj, get: obj => obj.id, set: (obj, value) => { obj.id = value; } }, metadata: _metadata }, _id_initializers, _id_extraInitializers);
|
|
76
|
+
__esDecorate(null, null, _content_decorators, { kind: "field", name: "content", static: false, private: false, access: { has: obj => "content" in obj, get: obj => obj.content, set: (obj, value) => { obj.content = value; } }, metadata: _metadata }, _content_initializers, _content_extraInitializers);
|
|
77
|
+
__esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
|
|
78
|
+
ControllerPushSettingsModel = _classThis = _classDescriptor.value;
|
|
79
|
+
if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
|
|
80
|
+
__runInitializers(_classThis, _classExtraInitializers);
|
|
81
|
+
}
|
|
82
|
+
id = __runInitializers(this, _id_initializers, void 0);
|
|
83
|
+
content = (__runInitializers(this, _id_extraInitializers), __runInitializers(this, _content_initializers, void 0));
|
|
84
|
+
constructor() {
|
|
85
|
+
super(...arguments);
|
|
86
|
+
__runInitializers(this, _content_extraInitializers);
|
|
87
|
+
}
|
|
88
|
+
};
|
|
89
|
+
return ControllerPushSettingsModel = _classThis;
|
|
90
|
+
})();
|
|
91
|
+
export { ControllerPushSettingsModel };
|
|
92
|
+
const isTime = (valueArg) => Number.isSafeInteger(valueArg) && valueArg > 0;
|
|
93
|
+
const isStoredKey = (valueArg) => (isPlainObject(valueArg)
|
|
94
|
+
&& Number.isSafeInteger(valueArg.generation) && valueArg.generation >= 1
|
|
95
|
+
&& typeof valueArg.ciphertext === 'string' && /^[A-Za-z0-9_-]{1,131072}$/u.test(valueArg.ciphertext));
|
|
96
|
+
const isRefusal = (valueArg) => (isPlainObject(valueArg) && isTime(valueArg.at) && (valueArg.vendorReason === undefined || isPushVendorReason(valueArg.vendorReason)));
|
|
97
|
+
/** A stored entry this release reads: its own keys checked, any other key a later release's. */
|
|
98
|
+
const readApnsEntry = (valueArg) => (isPlainObject(valueArg) && isAppleId(valueArg.keyId) && isAppleId(valueArg.teamId) && isBundleId(valueArg.topic)
|
|
99
|
+
&& isStoredKey(valueArg.key) && isTime(valueArg.setAt) && (valueArg.refused === undefined || isRefusal(valueArg.refused))
|
|
100
|
+
? valueArg : undefined);
|
|
101
|
+
const readFcmEntry = (valueArg) => (isPlainObject(valueArg) && isFirebaseProjectId(valueArg.projectId) && isServiceAccountEmail(valueArg.clientEmail)
|
|
102
|
+
&& (valueArg.privateKeyId === undefined || isServiceAccountKeyId(valueArg.privateKeyId))
|
|
103
|
+
&& isStoredKey(valueArg.key) && isTime(valueArg.setAt) && (valueArg.refused === undefined || isRefusal(valueArg.refused))
|
|
104
|
+
? valueArg : undefined);
|
|
105
|
+
const readRecord = (controllerIdArg) => ControllerPushSettingsModel.exact.findStoredOne({ id: controllerIdArg });
|
|
106
|
+
/**
|
|
107
|
+
* The push settings of one running controller: what it read at start and every change the owner makes, in one order.
|
|
108
|
+
* The keys exist in plaintext only in this process, as key objects; the store holds them sealed. A change of a
|
|
109
|
+
* platform's credential reaches the listeners (the delivery service drops its sender for the platform).
|
|
110
|
+
*/
|
|
111
|
+
export class ControllerPushSettings {
|
|
112
|
+
options;
|
|
113
|
+
previewsOn = false;
|
|
114
|
+
apnsHeld = { state: 'unset' };
|
|
115
|
+
fcmHeld = { state: 'unset' };
|
|
116
|
+
/**
|
|
117
|
+
* The newest generation each platform's credential had in this process, also after `unset`: the next one is always
|
|
118
|
+
* higher, so a refusal of an earlier credential that arrives late never names the one set since.
|
|
119
|
+
*/
|
|
120
|
+
generations = { apns: 0, fcm: 0 };
|
|
121
|
+
listeners = new Set();
|
|
122
|
+
mutationTail = Promise.resolve();
|
|
123
|
+
closed = false;
|
|
124
|
+
constructor(options) {
|
|
125
|
+
this.options = options;
|
|
126
|
+
}
|
|
127
|
+
/** Reads the controller's settings and unseals each credential that was not refused. */
|
|
128
|
+
static async open(optionsArg) {
|
|
129
|
+
const settings = new ControllerPushSettings(optionsArg);
|
|
130
|
+
const stored = await readRecord(optionsArg.controllerId);
|
|
131
|
+
const content = stored ? ControllerPushSettingsModel.exact.toPersisted(stored).content : {};
|
|
132
|
+
settings.previewsOn = content.previews === true;
|
|
133
|
+
settings.apnsHeld = await settings.holdApns(content.apns);
|
|
134
|
+
settings.fcmHeld = await settings.holdFcm(content.fcm);
|
|
135
|
+
// An entry this release cannot read still names its generation: the next credential's seal name is not that one's.
|
|
136
|
+
for (const platform of ['apns', 'fcm']) {
|
|
137
|
+
const entry = content[platform];
|
|
138
|
+
const generation = isPlainObject(entry) && isPlainObject(entry.key) ? entry.key.generation : undefined;
|
|
139
|
+
if (Number.isSafeInteger(generation) && generation > 0)
|
|
140
|
+
settings.generations[platform] = generation;
|
|
141
|
+
}
|
|
142
|
+
return settings;
|
|
143
|
+
}
|
|
144
|
+
now() {
|
|
145
|
+
return this.options.now?.() ?? Date.now();
|
|
146
|
+
}
|
|
147
|
+
/** Whether notifications carry previews. */
|
|
148
|
+
previews() {
|
|
149
|
+
return this.previewsOn;
|
|
150
|
+
}
|
|
151
|
+
/** What `agl push status` shows of the APNs credential, without the key. */
|
|
152
|
+
apnsStatus() {
|
|
153
|
+
const { state, stored } = this.apnsHeld;
|
|
154
|
+
return {
|
|
155
|
+
state,
|
|
156
|
+
...(stored === undefined ? {} : { keyId: stored.keyId, teamId: stored.teamId, topic: stored.topic, setAt: stored.setAt }),
|
|
157
|
+
...(state === 'refused' && stored?.refused ? { refused: { at: stored.refused.at, reason: 'credential_refused',
|
|
158
|
+
...(stored.refused.vendorReason === undefined ? {} : { vendorReason: stored.refused.vendorReason }) } } : {}),
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
/** What `agl push status` shows of the FCM credential, without the key. */
|
|
162
|
+
fcmStatus() {
|
|
163
|
+
const { state, stored } = this.fcmHeld;
|
|
164
|
+
return {
|
|
165
|
+
state,
|
|
166
|
+
...(stored === undefined ? {} : { projectId: stored.projectId, clientEmail: stored.clientEmail, setAt: stored.setAt }),
|
|
167
|
+
...(state === 'refused' && stored?.refused ? { refused: { at: stored.refused.at, reason: 'credential_refused',
|
|
168
|
+
...(stored.refused.vendorReason === undefined ? {} : { vendorReason: stored.refused.vendorReason }) } } : {}),
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
/** The APNs credential to send with, while it is ready. */
|
|
172
|
+
apnsCredential() {
|
|
173
|
+
return this.closed ? undefined : this.apnsHeld.credential;
|
|
174
|
+
}
|
|
175
|
+
/** The FCM credential to send with, while it is ready. */
|
|
176
|
+
fcmCredential() {
|
|
177
|
+
return this.closed ? undefined : this.fcmHeld.credential;
|
|
178
|
+
}
|
|
179
|
+
/** Whether the host holds a credential for the platform that Apple or Google did not refuse. */
|
|
180
|
+
ready(platformArg) {
|
|
181
|
+
return (platformArg === 'apns' ? this.apnsCredential() : this.fcmCredential()) !== undefined;
|
|
182
|
+
}
|
|
183
|
+
/** Calls `listenerArg` with the platform whenever its credential changes; answers the unsubscription. */
|
|
184
|
+
onChange(listenerArg) {
|
|
185
|
+
this.listeners.add(listenerArg);
|
|
186
|
+
return () => { this.listeners.delete(listenerArg); };
|
|
187
|
+
}
|
|
188
|
+
/** Seals and stores a new APNs credential, which replaces the one held (a refused one too). */
|
|
189
|
+
setApns(inputArg) {
|
|
190
|
+
return this.mutate(async () => {
|
|
191
|
+
const generation = this.nextGeneration('apns');
|
|
192
|
+
const key = await this.seal('apns', generation, inputArg.key);
|
|
193
|
+
const stored = { keyId: inputArg.keyId, teamId: inputArg.teamId, topic: inputArg.topic, key, setAt: this.now() };
|
|
194
|
+
await this.write((contentArg) => { contentArg.apns = stored; });
|
|
195
|
+
this.apnsHeld = { state: 'ready', stored, credential: {
|
|
196
|
+
keyId: stored.keyId, teamId: stored.teamId, topic: stored.topic, key: inputArg.key, generation,
|
|
197
|
+
} };
|
|
198
|
+
this.changed('apns');
|
|
199
|
+
return true;
|
|
200
|
+
});
|
|
201
|
+
}
|
|
202
|
+
/** Seals and stores a new FCM credential, which replaces the one held (a refused one too). */
|
|
203
|
+
setFcm(inputArg) {
|
|
204
|
+
return this.mutate(async () => {
|
|
205
|
+
const generation = this.nextGeneration('fcm');
|
|
206
|
+
const key = await this.seal('fcm', generation, inputArg.key);
|
|
207
|
+
const stored = {
|
|
208
|
+
projectId: inputArg.projectId, clientEmail: inputArg.clientEmail,
|
|
209
|
+
...(inputArg.privateKeyId === undefined ? {} : { privateKeyId: inputArg.privateKeyId }), key, setAt: this.now(),
|
|
210
|
+
};
|
|
211
|
+
await this.write((contentArg) => { contentArg.fcm = stored; });
|
|
212
|
+
this.fcmHeld = { state: 'ready', stored, credential: {
|
|
213
|
+
projectId: stored.projectId, clientEmail: stored.clientEmail,
|
|
214
|
+
...(stored.privateKeyId === undefined ? {} : { privateKeyId: stored.privateKeyId }), key: inputArg.key, generation,
|
|
215
|
+
} };
|
|
216
|
+
this.changed('fcm');
|
|
217
|
+
return true;
|
|
218
|
+
});
|
|
219
|
+
}
|
|
220
|
+
/** Removes a platform's credential; answers whether the host held one (also an unreadable one). */
|
|
221
|
+
unset(platformArg) {
|
|
222
|
+
return this.mutate(async () => {
|
|
223
|
+
const current = await readRecord(this.options.controllerId);
|
|
224
|
+
const held = platformArg === 'apns' ? this.apnsHeld : this.fcmHeld;
|
|
225
|
+
if (!current || (!Object.hasOwn(ControllerPushSettingsModel.exact.toPersisted(current).content, platformArg) && held.state === 'unset')) {
|
|
226
|
+
return false;
|
|
227
|
+
}
|
|
228
|
+
await this.write((contentArg) => { delete contentArg[platformArg]; });
|
|
229
|
+
if (platformArg === 'apns')
|
|
230
|
+
this.apnsHeld = { state: 'unset' };
|
|
231
|
+
else
|
|
232
|
+
this.fcmHeld = { state: 'unset' };
|
|
233
|
+
this.changed(platformArg);
|
|
234
|
+
return true;
|
|
235
|
+
});
|
|
236
|
+
}
|
|
237
|
+
/** Turns previews on or off; answers whether that changed them. */
|
|
238
|
+
setPreviews(previewsArg) {
|
|
239
|
+
return this.mutate(async () => {
|
|
240
|
+
if (this.previewsOn === previewsArg)
|
|
241
|
+
return false;
|
|
242
|
+
await this.write((contentArg) => { contentArg.previews = previewsArg; });
|
|
243
|
+
this.previewsOn = previewsArg;
|
|
244
|
+
return true;
|
|
245
|
+
});
|
|
246
|
+
}
|
|
247
|
+
/**
|
|
248
|
+
* Apple or Google refused generation `generationArg` of a platform's credential: it is kept as `refused`, and nothing
|
|
249
|
+
* is sent on the platform until the owner sets it again. A credential set since is not the one refused.
|
|
250
|
+
*/
|
|
251
|
+
refuse(platformArg, generationArg, vendorReasonArg) {
|
|
252
|
+
return this.mutate(async () => {
|
|
253
|
+
const held = platformArg === 'apns' ? this.apnsHeld : this.fcmHeld;
|
|
254
|
+
if (held.state !== 'ready' || held.credential?.generation !== generationArg || !held.stored)
|
|
255
|
+
return false;
|
|
256
|
+
const refused = { at: this.now(), ...(isPushVendorReason(vendorReasonArg) ? { vendorReason: vendorReasonArg } : {}) };
|
|
257
|
+
const stored = { ...held.stored, refused };
|
|
258
|
+
await this.write((contentArg) => {
|
|
259
|
+
// What a later release added to the entry stays.
|
|
260
|
+
contentArg[platformArg] = { ...(isPlainObject(contentArg[platformArg]) ? contentArg[platformArg] : {}), ...stored };
|
|
261
|
+
});
|
|
262
|
+
if (platformArg === 'apns')
|
|
263
|
+
this.apnsHeld = { state: 'refused', stored: stored };
|
|
264
|
+
else
|
|
265
|
+
this.fcmHeld = { state: 'refused', stored: stored };
|
|
266
|
+
this.changed(platformArg);
|
|
267
|
+
return true;
|
|
268
|
+
});
|
|
269
|
+
}
|
|
270
|
+
/** Forgets the keys; the record stays. Changes still running fail. */
|
|
271
|
+
close() {
|
|
272
|
+
this.closed = true;
|
|
273
|
+
this.apnsHeld = { state: this.apnsHeld.state, ...(this.apnsHeld.stored ? { stored: this.apnsHeld.stored } : {}) };
|
|
274
|
+
this.fcmHeld = { state: this.fcmHeld.state, ...(this.fcmHeld.stored ? { stored: this.fcmHeld.stored } : {}) };
|
|
275
|
+
this.listeners.clear();
|
|
276
|
+
}
|
|
277
|
+
/** A generation the platform's credential never had in this process, nor the stored one. */
|
|
278
|
+
nextGeneration(platformArg) {
|
|
279
|
+
this.generations[platformArg] += 1;
|
|
280
|
+
return this.generations[platformArg];
|
|
281
|
+
}
|
|
282
|
+
changed(platformArg) {
|
|
283
|
+
for (const listener of [...this.listeners])
|
|
284
|
+
listener(platformArg);
|
|
285
|
+
}
|
|
286
|
+
sealName(platformArg, generationArg) {
|
|
287
|
+
return `agl-controller.${this.options.issuerId.slice(0, 22)}.${this.options.controllerId.replace(':', '-')}.push-${platformArg}.${generationArg}`;
|
|
288
|
+
}
|
|
289
|
+
async seal(platformArg, generationArg, keyArg) {
|
|
290
|
+
const bytes = privateKeyBytes(keyArg);
|
|
291
|
+
try {
|
|
292
|
+
return { generation: generationArg, ciphertext: await this.options.codec.seal(this.sealName(platformArg, generationArg), bytes) };
|
|
293
|
+
}
|
|
294
|
+
finally {
|
|
295
|
+
bytes.fill(0);
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
/** The key of a stored credential, unsealed; none (`unreadable`) when this machine cannot unseal it. */
|
|
299
|
+
async unseal(platformArg, keyArg) {
|
|
300
|
+
let bytes;
|
|
301
|
+
try {
|
|
302
|
+
bytes = await this.options.codec.unseal(this.sealName(platformArg, keyArg.generation), keyArg.ciphertext);
|
|
303
|
+
return privateKeyFromBytes(bytes);
|
|
304
|
+
}
|
|
305
|
+
catch {
|
|
306
|
+
return undefined;
|
|
307
|
+
}
|
|
308
|
+
finally {
|
|
309
|
+
bytes?.fill(0);
|
|
310
|
+
}
|
|
311
|
+
}
|
|
312
|
+
async holdApns(valueArg) {
|
|
313
|
+
if (valueArg === undefined)
|
|
314
|
+
return { state: 'unset' };
|
|
315
|
+
const stored = readApnsEntry(valueArg);
|
|
316
|
+
if (!stored)
|
|
317
|
+
return this.unreadable('APNs', 'apns');
|
|
318
|
+
if (stored.refused)
|
|
319
|
+
return { state: 'refused', stored };
|
|
320
|
+
const key = await this.unseal('apns', stored.key);
|
|
321
|
+
if (!key || !isApnsSigningKey(key))
|
|
322
|
+
return { ...this.unreadable('APNs', 'apns'), stored };
|
|
323
|
+
return { state: 'ready', stored, credential: {
|
|
324
|
+
keyId: stored.keyId, teamId: stored.teamId, topic: stored.topic, key, generation: stored.key.generation,
|
|
325
|
+
} };
|
|
326
|
+
}
|
|
327
|
+
async holdFcm(valueArg) {
|
|
328
|
+
if (valueArg === undefined)
|
|
329
|
+
return { state: 'unset' };
|
|
330
|
+
const stored = readFcmEntry(valueArg);
|
|
331
|
+
if (!stored)
|
|
332
|
+
return this.unreadable('FCM', 'fcm');
|
|
333
|
+
if (stored.refused)
|
|
334
|
+
return { state: 'refused', stored };
|
|
335
|
+
const key = await this.unseal('fcm', stored.key);
|
|
336
|
+
if (!key || !isServiceAccountSigningKey(key))
|
|
337
|
+
return { ...this.unreadable('FCM', 'fcm'), stored };
|
|
338
|
+
return { state: 'ready', stored, credential: {
|
|
339
|
+
projectId: stored.projectId, clientEmail: stored.clientEmail,
|
|
340
|
+
...(stored.privateKeyId === undefined ? {} : { privateKeyId: stored.privateKeyId }), key, generation: stored.key.generation,
|
|
341
|
+
} };
|
|
342
|
+
}
|
|
343
|
+
unreadable(nameArg, platformArg) {
|
|
344
|
+
console.warn(`The ${nameArg} push credential of ${this.options.controllerId} cannot be read or unsealed on this machine, so `
|
|
345
|
+
+ `nothing is sent on it: set it again with \`agl push ${platformArg} set\`.`);
|
|
346
|
+
return { state: 'unreadable' };
|
|
347
|
+
}
|
|
348
|
+
/** Changes the stored `content` with `changeArg`, keeping every key this release does not know. */
|
|
349
|
+
async write(changeArg) {
|
|
350
|
+
const current = await readRecord(this.options.controllerId);
|
|
351
|
+
if (!current) {
|
|
352
|
+
const content = {};
|
|
353
|
+
changeArg(content);
|
|
354
|
+
const inserted = await ControllerPushSettingsModel.exact.insert({ id: this.options.controllerId, content });
|
|
355
|
+
if (inserted.status !== 'inserted')
|
|
356
|
+
throw new Error('The push settings changed concurrently and were not stored.');
|
|
357
|
+
return;
|
|
358
|
+
}
|
|
359
|
+
const content = structuredClone(ControllerPushSettingsModel.exact.toPersisted(current).content);
|
|
360
|
+
changeArg(content);
|
|
361
|
+
const result = await ControllerPushSettingsModel.exact.transition({ current, change: (modelArg) => { modelArg.content = content; } });
|
|
362
|
+
if (result.status !== 'transitioned')
|
|
363
|
+
throw new Error('The push settings changed concurrently and were not stored.');
|
|
364
|
+
}
|
|
365
|
+
mutate(operationArg) {
|
|
366
|
+
if (this.closed)
|
|
367
|
+
return Promise.reject(new Error('The push settings are closed.'));
|
|
368
|
+
const task = this.mutationTail.then(() => {
|
|
369
|
+
if (this.closed)
|
|
370
|
+
throw new Error('The push settings are closed.');
|
|
371
|
+
return operationArg();
|
|
372
|
+
});
|
|
373
|
+
this.mutationTail = task.then(() => undefined, () => undefined);
|
|
374
|
+
return task;
|
|
375
|
+
}
|
|
376
|
+
}
|
|
377
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5wdXNoc2V0dGluZ3MuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jbGFzc2VzLnB1c2hzZXR0aW5ncy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFFeEMsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFHMUQsT0FBTyxFQUNMLGdCQUFnQixFQUNoQixTQUFTLEVBQ1QsVUFBVSxFQUNWLG1CQUFtQixFQUNuQixxQkFBcUIsRUFDckIscUJBQXFCLEVBQ3JCLDBCQUEwQixFQUMxQixlQUFlLEVBQ2YsbUJBQW1CLEdBR3BCLE1BQU0sZ0NBQWdDLENBQUM7QUFnRHhDLDZEQUE2RDtBQUM3RCxNQUFNLG1CQUFtQixHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUM7QUFFdEMsTUFBTSxhQUFhLEdBQUcsQ0FBQyxRQUFpQixFQUF1QyxFQUFFLENBQUMsQ0FDaEYsQ0FBQyxDQUFDLFFBQVEsSUFBSSxPQUFPLFFBQVEsS0FBSyxRQUFRLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQztPQUNuRSxDQUFDLE1BQU0sQ0FBQyxjQUFjLENBQUMsUUFBUSxDQUFDLEtBQUssTUFBTSxDQUFDLFNBQVMsSUFBSSxNQUFNLENBQUMsY0FBYyxDQUFDLFFBQVEsQ0FBQyxLQUFLLElBQUksQ0FBQyxDQUN0RyxDQUFDO0FBRUYsTUFBTSxjQUFjLEdBQStFLENBQUMsUUFBUSxFQUFFLEVBQUU7SUFDOUcsTUFBTSxLQUFLLEdBQUcsUUFBMkQsQ0FBQztJQUMxRSxJQUFJLElBQUksR0FBRyxNQUFNLENBQUMsaUJBQWlCLENBQUM7SUFDcEMsSUFBSSxDQUFDO1FBQUMsSUFBSSxHQUFHLE1BQU0sQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxLQUFLLEVBQUUsT0FB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
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { type IFleetWorkerCallerHooks, type TFleetWorkerCallerLaunch, type TFleetWorkerCallerBinding, type IWorkerCallerReadiness, type TWorkerCallerEnrollment, type IWorkerCallerEnrollmentResponse, type IConfigurationMaster, type IControllerMcpCaller, type IControllerMcpWireCaller, type IWorkerClaudeJobRequest, type TWorkerClaudeJobObservation } from '../dist_ts_interfaces/index.js';
|
|
1
|
+
import { type IFleetWorkerCallerHooks, type TFleetWorkerCallerLaunch, type TFleetWorkerCallerBinding, type IWorkerCallerReadiness, type TWorkerCallerEnrollment, type IWorkerCallerEnrollmentResponse, type IConfigurationMaster, type IControllerMcpCaller, type IControllerMcpWireCaller, type IWorkerClaudeJobRequest, type TWorkerClaudeJobObservation, type IWorkerClaudeProcessRequest, type TWorkerClaudeProcessIdentification } from '../dist_ts_interfaces/index.js';
|
|
2
2
|
import { ControllerMcpCallerRegistry } from './classes.mcpcallerregistry.js';
|
|
3
|
-
import { resolveWorkerBridgeCommand, resolveClaudeWorkerExecutable, verifyClaudeWorkerProcess, readWorkerBridge, verifyWorkerBridge, type IWorkerCallerConnection, type IWorkerProcessSnapshot } from './functions.workerprocessproof.js';
|
|
3
|
+
import { resolveWorkerBridgeCommand, resolveClaudeWorkerExecutable, verifyClaudeWorkerProcess, verifyClaudeReleaseProcess, readWorkerBridge, verifyWorkerBridge, readWorkerProcessSnapshot, type IWorkerCallerConnection, type IWorkerProcessSnapshot } from './functions.workerprocessproof.js';
|
|
4
4
|
import { type IWorkerCallerBindingStore } from './classes.workercallerbindings.js';
|
|
5
5
|
export interface IWorkerCodexCallerOrigin {
|
|
6
6
|
parent: IWorkerProcessSnapshot;
|
|
@@ -11,6 +11,19 @@ export interface IWorkerCallerLease {
|
|
|
11
11
|
caller: IControllerMcpCaller;
|
|
12
12
|
release(): void;
|
|
13
13
|
}
|
|
14
|
+
/**
|
|
15
|
+
* Why a bridge that enrolled by its process was not identified: the check that refused it (`bridge`: the approved
|
|
16
|
+
* command over its own connection; `parent`: the process it runs under directly; `inventory`: the fleet's Claude
|
|
17
|
+
* inventory; `worker`: the fleet's registry; `release`: the Claude Code release its parent runs; `record`: the worker's
|
|
18
|
+
* caller record), with the job's session and the fleet worker once the inventory and registry named them. Never a
|
|
19
|
+
* credential, a launch id or a process id.
|
|
20
|
+
*/
|
|
21
|
+
export interface IWorkerProcessRefusal {
|
|
22
|
+
check: 'bridge' | 'parent' | 'inventory' | 'worker' | 'release' | 'record';
|
|
23
|
+
reason: string;
|
|
24
|
+
workerId?: string;
|
|
25
|
+
nativeSessionId?: string;
|
|
26
|
+
}
|
|
14
27
|
export interface IControllerWorkerCallerOptions {
|
|
15
28
|
controllerGeneration: string;
|
|
16
29
|
/** The port this controller is configured to serve: a bridge an upgrade re-executed in place names it (`aglMcpReexecArguments`). */
|
|
@@ -28,6 +41,12 @@ export interface IControllerWorkerCallerOptions {
|
|
|
28
41
|
* Without it a bridge of a process that replaced the bound one stays pending.
|
|
29
42
|
*/
|
|
30
43
|
observeClaudeJob?(request: IWorkerClaudeJobRequest): Promise<TWorkerClaudeJobObservation>;
|
|
44
|
+
/**
|
|
45
|
+
* Which fleet worker's Claude background job runs the process a bridge without a launch runs under, from a fresh
|
|
46
|
+
* inventory of the fleet's Claude homes and its registry (`FleetWorkers.identifyCallerProcess`). Without it such a
|
|
47
|
+
* bridge stays pending.
|
|
48
|
+
*/
|
|
49
|
+
identifyClaudeProcess?(request: IWorkerClaudeProcessRequest): Promise<TWorkerClaudeProcessIdentification>;
|
|
31
50
|
/** Where the reason a worker enrollment stays pending is written once; the controller log by default. */
|
|
32
51
|
log?(line: string): void;
|
|
33
52
|
}
|
|
@@ -35,8 +54,10 @@ export interface IWorkerCallerProcessProof {
|
|
|
35
54
|
resolveCommand: typeof resolveWorkerBridgeCommand;
|
|
36
55
|
resolveClaude: typeof resolveClaudeWorkerExecutable;
|
|
37
56
|
verifyClaude: typeof verifyClaudeWorkerProcess;
|
|
57
|
+
verifyClaudeRelease: typeof verifyClaudeReleaseProcess;
|
|
38
58
|
readBridge: typeof readWorkerBridge;
|
|
39
59
|
verifyBridge: typeof verifyWorkerBridge;
|
|
60
|
+
readProcess: typeof readWorkerProcessSnapshot;
|
|
40
61
|
}
|
|
41
62
|
export declare class ControllerWorkerCallers implements IFleetWorkerCallerHooks {
|
|
42
63
|
private readonly options;
|
|
@@ -49,6 +70,24 @@ export declare class ControllerWorkerCallers implements IFleetWorkerCallerHooks
|
|
|
49
70
|
private readonly workerTails;
|
|
50
71
|
/** Pending reasons logged for launches this controller does not hold, by launch digest and reason. */
|
|
51
72
|
private readonly loggedUnknown;
|
|
73
|
+
/**
|
|
74
|
+
* Process enrollments refused once the bridge was proved, until when: by the digest of the bridge's whole snapshot
|
|
75
|
+
* and by its parent's PID and start, so neither that bridge nor another under the same process is proved, or reads
|
|
76
|
+
* the inventory, again while the refusal holds. Cleared when the fleet adopts or re-binds a worker.
|
|
77
|
+
*/
|
|
78
|
+
private readonly processRefusals;
|
|
79
|
+
/**
|
|
80
|
+
* How often the fleet adopted, re-bound or revoked a worker: an identification that ran across such a change is
|
|
81
|
+
* discarded in both directions. Its refusal is remembered only while this is what it was when the evidence for it
|
|
82
|
+
* began to be read, and it creates a worker's record only while this is what it was when the fleet began to read.
|
|
83
|
+
* One counter for every worker: which worker a running identification names is known only once it returns.
|
|
84
|
+
*/
|
|
85
|
+
private refusalEpoch;
|
|
86
|
+
/**
|
|
87
|
+
* The fleet identification running for a parent process, by its PID and start, and the epoch it began in: enrollments
|
|
88
|
+
* under it wait for that one read, until the fleet adopts or re-binds a worker.
|
|
89
|
+
*/
|
|
90
|
+
private readonly identifications;
|
|
52
91
|
private closed;
|
|
53
92
|
private readonly proof;
|
|
54
93
|
private readonly log;
|
|
@@ -59,6 +98,7 @@ export declare class ControllerWorkerCallers implements IFleetWorkerCallerHooks
|
|
|
59
98
|
revokeWorkerCaller(requestArg: Parameters<IFleetWorkerCallerHooks['revokeWorkerCaller']>[0]): Promise<void>;
|
|
60
99
|
enroll(requestArg: TWorkerCallerEnrollment, connectionArg?: IWorkerCallerConnection): Promise<IWorkerCallerEnrollmentResponse>;
|
|
61
100
|
admit(wireArg: IControllerMcpWireCaller | undefined, connectionArg?: IWorkerCallerConnection): Promise<IWorkerCallerLease>;
|
|
101
|
+
clearCallerRefusals(): void;
|
|
62
102
|
close(): Promise<void>;
|
|
63
103
|
/**
|
|
64
104
|
* Binds `recordArg` to `bindingArg`, inside its serial chain: a Claude launch to its background job and, when it has
|
|
@@ -70,6 +110,36 @@ export declare class ControllerWorkerCallers implements IFleetWorkerCallerHooks
|
|
|
70
110
|
* replaced, after the fleet proved the bridge's process to be the next process of the same job.
|
|
71
111
|
*/
|
|
72
112
|
private enrollClaude;
|
|
113
|
+
/**
|
|
114
|
+
* Enrolls a bridge that holds no launch this controller can use by its process chain (AGL-1888). Every check is
|
|
115
|
+
* required: (1) the bridge holds its own connection and runs the bridge command this controller approves now; (2) its
|
|
116
|
+
* parent, the process it runs under directly and never one further up, is a process of the controller's user; (5) the
|
|
117
|
+
* parent runs an installed Claude Code release, proved locally before anything of the fleet is read; (3) a fresh
|
|
118
|
+
* inventory of the fleet's Claude homes lists that parent exactly once, as the process of a background job, and the
|
|
119
|
+
* parent is unchanged across the read; (4) exactly one live fleet Claude worker binds that job's session. The bridge
|
|
120
|
+
* then enrolls into that worker's caller record.
|
|
121
|
+
*/
|
|
122
|
+
private enrollProcess;
|
|
123
|
+
private identifyProcess;
|
|
124
|
+
/**
|
|
125
|
+
* Enrolls a bridge whose process the fleet identified into its worker's caller record: the worker's current bound
|
|
126
|
+
* record proves it as for any of its bridges (`enrollClaude`); only a worker without one, or with one revoked, also by
|
|
127
|
+
* that proof, gets a record created and bound to the job's process, and only while the epoch is still `epochArg`, the
|
|
128
|
+
* one the identification began in. A record a fleet wake prepared is never replaced.
|
|
129
|
+
*/
|
|
130
|
+
private enrollIdentified;
|
|
131
|
+
/** The current, verified record of a worker that is bound to `processArg`: the same PID and start. */
|
|
132
|
+
private recordOfProcess;
|
|
133
|
+
/**
|
|
134
|
+
* The fleet's identification of the process `parentArg`, shared by every enrollment that waits for it, with the epoch
|
|
135
|
+
* it began in. One that began before the fleet's last adoption or re-bind is not shared any more.
|
|
136
|
+
*/
|
|
137
|
+
private identifyOnce;
|
|
138
|
+
/**
|
|
139
|
+
* Where a process enrollment's refusal goes: once per job session or worker and reason to the controller log, never
|
|
140
|
+
* for a bridge whose parent runs no Claude job of the inventory (an AGL terminal, a harness's own server).
|
|
141
|
+
*/
|
|
142
|
+
private noteProcessRefusal;
|
|
73
143
|
/**
|
|
74
144
|
* Proves the bridge's process to be the current process of the job the launch is bound to, from a fresh inventory the
|
|
75
145
|
* fleet reads, and binds the launch to it at the current revision. A bridge refused for good is remembered for its
|
|
@@ -83,6 +153,7 @@ export declare class ControllerWorkerCallers implements IFleetWorkerCallerHooks
|
|
|
83
153
|
* checked against its generation's, and only while it is still its worker's current launch. It is restored
|
|
84
154
|
* unverified: its bridge enrolls only after a fresh inventory shows the job still the worker's, in the kept process
|
|
85
155
|
* when that still runs unchanged, or in the bridge's process, which then proves itself as the job's next process.
|
|
156
|
+
* Otherwise the reason it cannot be restored, which is logged only when the bridge's process does not identify it.
|
|
86
157
|
*/
|
|
87
158
|
private restore;
|
|
88
159
|
/** The kept process of a restored launch while it still runs as it was proved: the same PID, start and snapshot. */
|