agl 43.7.0 → 43.9.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 +33 -0
- package/dist_serve/bundle.js +871 -858
- package/dist_serve/bundle.js.map +2 -2
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/aglapisurface.document.js +824 -6
- package/dist_ts/aglapi/interfaces.d.ts +43 -0
- package/dist_ts/aglapi/interfaces.js +11 -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 +20 -8
- package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -0
- package/dist_ts/classes.mcpcontrollerhost.js +21 -2
- package/dist_ts/classes.mcptools.d.ts +1 -1
- package/dist_ts/classes.mcptools.js +2 -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.ticketstore.d.ts +3 -3
- package/dist_ts/classes.ticketstore.js +23 -4
- 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 +43 -3
- package/dist_ts/functions.mcptickettools.d.ts +60 -0
- package/dist_ts/functions.mcptickettools.js +4 -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.ticketcli.d.ts +4 -2
- package/dist_ts/functions.ticketcli.js +70 -4
- package/dist_ts/functions.ticketlisting.d.ts +38 -0
- package/dist_ts/functions.ticketlisting.js +211 -0
- package/dist_ts/functions.ticketvalidation.d.ts +62 -0
- package/dist_ts/functions.ticketvalidation.js +41 -3
- 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/requests.tickets.d.ts +31 -3
- package/dist_ts_interfaces/requests.tickets.js +2 -2
- package/dist_ts_interfaces/tickets.d.ts +174 -2
- package/dist_ts_interfaces/tickets.js +20 -2
- package/dist_ts_interfaces/workercallers.d.ts +43 -3
- package/package.json +2 -2
- package/readme.md +95 -14
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/aglapisurface.document.ts +823 -5
- package/ts/aglapi/interfaces.ts +10 -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 +22 -7
- package/ts/classes.mcpcontrollerhost.ts +22 -1
- package/ts/classes.mcptools.ts +1 -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.ticketstore.ts +21 -3
- 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 +54 -2
- package/ts/functions.mcptickettools.ts +3 -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.ticketcli.ts +70 -5
- package/ts/functions.ticketlisting.ts +214 -0
- package/ts/functions.ticketvalidation.ts +41 -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/requests.tickets.ts +32 -2
- package/ts_interfaces/tickets.ts +136 -3
- package/ts_interfaces/workercallers.ts +34 -2
- package/ts_web/00_commitinfo_data.ts +1 -1
- package/ts_web/elements.inbox.ts +50 -9
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { ControllerMcpClient } from './classes.mcpclient.js';
|
|
2
|
+
import { type IPushStatus, type IPushTestResult } from '../dist_ts_interfaces/push.js';
|
|
3
|
+
export declare const pushCliHelp = "Usage: agl push status [--json]\n agl push apns set --key-id KEY_ID --team-id TEAM_ID [--topic BUNDLE_ID] < AuthKey_KEY_ID.p8\n agl push apns unset\n agl push fcm set < SERVICE_ACCOUNT.json\n agl push fcm unset\n agl push previews on|off\n agl push test [--device DEVICE_ID] [--json]\nNotifications of what waits in the Inbox go from this host straight to Apple's (APNs) and Google's (FCM) push\nservices, to the paired devices that registered for them. Every command accepts --port PORT (default 4097), runs\nagainst the running controller as the local owner, and every change is audited.\napns set reads the AuthKey .p8 file Apple issued for the team (a key with Apple Push Notifications service) from\n standard input, never from a terminal. --key-id is the key's 10-character id, --team-id the team's; the\n topic is the app's bundle id, com.modelprofile.harness unless --topic names another.\nfcm set reads the JSON key file of the Firebase project's service account (Project settings, Service accounts,\n Generate new private key) from standard input, never from a terminal. Its token_uri is ignored: the host\n asks Google's own endpoints only.\n Both keys are sealed with the TPM and never printed. Set one again to replace it, also after Apple or Google\n refused it: nothing is sent on a refused credential.\nunset removes the platform's credential: nothing is sent on it until it is set again; the devices stay registered.\npreviews on: a notification also says where an item lives, what it asks and its id, which Apple or Google can read.\n off (the default): it says one fixed sentence per kind of item.\nstatus previews, and for each platform: whether its credential is set and usable, what it is for (key id, team id\n and topic; project and service account), when it was set, the registered devices, why Apple or Google\n refused it, and the last send that failed since the controller started (with how far the host's clock is off\n when Google refused for it). --json prints the answer as JSON.\ntest sends the test notification (\"Push from AGL works.\") to every registered device, or to the one --device\n names (its id, as Settings -> Devices shows it), and prints what Apple or Google answered for each: delivered,\n or why not. A device whose token the push service no longer knows loses its registration; the app registers\n again on its next connect. --json prints the answer as JSON.\n";
|
|
4
|
+
export type TPushCliArguments = {
|
|
5
|
+
port: number;
|
|
6
|
+
json: boolean;
|
|
7
|
+
} & ({
|
|
8
|
+
operation: 'status';
|
|
9
|
+
} | {
|
|
10
|
+
operation: 'apns.set';
|
|
11
|
+
keyId: string;
|
|
12
|
+
teamId: string;
|
|
13
|
+
topic?: string;
|
|
14
|
+
} | {
|
|
15
|
+
operation: 'apns.unset';
|
|
16
|
+
} | {
|
|
17
|
+
operation: 'fcm.set';
|
|
18
|
+
} | {
|
|
19
|
+
operation: 'fcm.unset';
|
|
20
|
+
} | {
|
|
21
|
+
operation: 'previews';
|
|
22
|
+
previews: boolean;
|
|
23
|
+
} | {
|
|
24
|
+
operation: 'test';
|
|
25
|
+
deviceId?: string;
|
|
26
|
+
});
|
|
27
|
+
/** `agl push …`: the operation and its options; a usage error names the option, never a value it does not know. */
|
|
28
|
+
export declare const parsePushCliArguments: (argsArg: readonly string[]) => TPushCliArguments;
|
|
29
|
+
/** One device's answer to `agl push test`, as a line: never its token. */
|
|
30
|
+
export declare const pushTestLine: (resultArg: IPushTestResult) => string;
|
|
31
|
+
/** `agl push status` as lines: previews, then each platform. */
|
|
32
|
+
export declare const pushStatusLines: (statusArg: IPushStatus) => string[];
|
|
33
|
+
export interface IPushCliOptions {
|
|
34
|
+
/** Where `apns set` and `fcm set` read their key; this process's standard input when absent. */
|
|
35
|
+
input?: NodeJS.ReadableStream & {
|
|
36
|
+
isTTY?: boolean;
|
|
37
|
+
};
|
|
38
|
+
/** Where the outcome is written; standard output when absent. */
|
|
39
|
+
write?: (textArg: string) => void;
|
|
40
|
+
/** Runs an operation with the local owner capability; `withLocalConfigurationOwner` when absent. For tests. */
|
|
41
|
+
withOwner?: <T>(clientArg: ControllerMcpClient, portArg: number, operationArg: (ownerTokenArg: string) => Promise<T>) => Promise<T>;
|
|
42
|
+
}
|
|
43
|
+
export declare const runPushCli: (argsArg: string[], optionsArg?: IPushCliOptions) => Promise<void>;
|
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
import { ControllerMcpClient } from './classes.mcpclient.js';
|
|
2
|
+
import { withCliDiagnostics } from './functions.clidiagnostics.js';
|
|
3
|
+
import { withLocalConfigurationOwner } from './functions.configurationowner.js';
|
|
4
|
+
import { readStandardInputSecret } from './functions.remotecli.js';
|
|
5
|
+
import { defaultControllerPort } from './classes.config.js';
|
|
6
|
+
import { pushClockSkewText, pushTestAnswerWaitMs } from '../dist_ts_interfaces/push.js';
|
|
7
|
+
export const pushCliHelp = `Usage: agl push status [--json]
|
|
8
|
+
agl push apns set --key-id KEY_ID --team-id TEAM_ID [--topic BUNDLE_ID] < AuthKey_KEY_ID.p8
|
|
9
|
+
agl push apns unset
|
|
10
|
+
agl push fcm set < SERVICE_ACCOUNT.json
|
|
11
|
+
agl push fcm unset
|
|
12
|
+
agl push previews on|off
|
|
13
|
+
agl push test [--device DEVICE_ID] [--json]
|
|
14
|
+
Notifications of what waits in the Inbox go from this host straight to Apple's (APNs) and Google's (FCM) push
|
|
15
|
+
services, to the paired devices that registered for them. Every command accepts --port PORT (default 4097), runs
|
|
16
|
+
against the running controller as the local owner, and every change is audited.
|
|
17
|
+
apns set reads the AuthKey .p8 file Apple issued for the team (a key with Apple Push Notifications service) from
|
|
18
|
+
standard input, never from a terminal. --key-id is the key's 10-character id, --team-id the team's; the
|
|
19
|
+
topic is the app's bundle id, com.modelprofile.harness unless --topic names another.
|
|
20
|
+
fcm set reads the JSON key file of the Firebase project's service account (Project settings, Service accounts,
|
|
21
|
+
Generate new private key) from standard input, never from a terminal. Its token_uri is ignored: the host
|
|
22
|
+
asks Google's own endpoints only.
|
|
23
|
+
Both keys are sealed with the TPM and never printed. Set one again to replace it, also after Apple or Google
|
|
24
|
+
refused it: nothing is sent on a refused credential.
|
|
25
|
+
unset removes the platform's credential: nothing is sent on it until it is set again; the devices stay registered.
|
|
26
|
+
previews on: a notification also says where an item lives, what it asks and its id, which Apple or Google can read.
|
|
27
|
+
off (the default): it says one fixed sentence per kind of item.
|
|
28
|
+
status previews, and for each platform: whether its credential is set and usable, what it is for (key id, team id
|
|
29
|
+
and topic; project and service account), when it was set, the registered devices, why Apple or Google
|
|
30
|
+
refused it, and the last send that failed since the controller started (with how far the host's clock is off
|
|
31
|
+
when Google refused for it). --json prints the answer as JSON.
|
|
32
|
+
test sends the test notification ("Push from AGL works.") to every registered device, or to the one --device
|
|
33
|
+
names (its id, as Settings -> Devices shows it), and prints what Apple or Google answered for each: delivered,
|
|
34
|
+
or why not. A device whose token the push service no longer knows loses its registration; the app registers
|
|
35
|
+
again on its next connect. --json prints the answer as JSON.
|
|
36
|
+
`;
|
|
37
|
+
/** `agl push …`: the operation and its options; a usage error names the option, never a value it does not know. */
|
|
38
|
+
export const parsePushCliArguments = (argsArg) => {
|
|
39
|
+
const rest = [...argsArg];
|
|
40
|
+
const first = rest.shift();
|
|
41
|
+
let operation;
|
|
42
|
+
let previews;
|
|
43
|
+
if (first === 'status' || first === 'test')
|
|
44
|
+
operation = first;
|
|
45
|
+
else if ((first === 'apns' || first === 'fcm') && (rest[0] === 'set' || rest[0] === 'unset'))
|
|
46
|
+
operation = `${first}.${rest.shift()}`;
|
|
47
|
+
else if (first === 'previews' && (rest[0] === 'on' || rest[0] === 'off')) {
|
|
48
|
+
operation = 'previews';
|
|
49
|
+
previews = rest.shift() === 'on';
|
|
50
|
+
}
|
|
51
|
+
if (!operation)
|
|
52
|
+
throw new Error(pushCliHelp);
|
|
53
|
+
const allowed = new Set(['--port', ...(operation === 'status' || operation === 'test' ? ['--json'] : []),
|
|
54
|
+
...(operation === 'apns.set' ? ['--key-id', '--team-id', '--topic'] : []), ...(operation === 'test' ? ['--device'] : [])]);
|
|
55
|
+
const options = new Map();
|
|
56
|
+
for (let index = 0; index < rest.length; index++) {
|
|
57
|
+
const token = rest[index];
|
|
58
|
+
const equals = token.startsWith('--') ? token.indexOf('=') : -1;
|
|
59
|
+
const flag = equals > 0 ? token.slice(0, equals) : token;
|
|
60
|
+
if (!flag.startsWith('--'))
|
|
61
|
+
throw new Error(`Unexpected argument for agl push: ${flag.slice(0, 64)}`);
|
|
62
|
+
if (!allowed.has(flag))
|
|
63
|
+
throw new Error(`Unknown push option: ${flag.slice(0, 64)}.`);
|
|
64
|
+
if (options.has(flag))
|
|
65
|
+
throw new Error(`Duplicate push option: ${flag}.`);
|
|
66
|
+
if (flag === '--json') {
|
|
67
|
+
if (equals > 0)
|
|
68
|
+
throw new Error('--json takes no value.');
|
|
69
|
+
options.set(flag, 'true');
|
|
70
|
+
continue;
|
|
71
|
+
}
|
|
72
|
+
const value = equals > 0 ? token.slice(equals + 1) : rest[++index];
|
|
73
|
+
if (value === undefined || value === '' || (equals < 0 && value.startsWith('--')))
|
|
74
|
+
throw new Error(`${flag} requires a value.`);
|
|
75
|
+
options.set(flag, value);
|
|
76
|
+
}
|
|
77
|
+
const port = options.has('--port') ? Number(options.get('--port')) : defaultControllerPort;
|
|
78
|
+
if (!/^[1-9][0-9]{0,4}$/u.test(String(port)) || port > 65_535)
|
|
79
|
+
throw new Error('--port must be an integer between 1 and 65535.');
|
|
80
|
+
const base = { port, json: options.has('--json') };
|
|
81
|
+
if (operation === 'apns.set') {
|
|
82
|
+
const keyId = options.get('--key-id');
|
|
83
|
+
const teamId = options.get('--team-id');
|
|
84
|
+
if (keyId === undefined)
|
|
85
|
+
throw new Error('agl push apns set requires --key-id.');
|
|
86
|
+
if (teamId === undefined)
|
|
87
|
+
throw new Error('agl push apns set requires --team-id.');
|
|
88
|
+
const topic = options.get('--topic');
|
|
89
|
+
return { ...base, operation, keyId, teamId, ...(topic === undefined ? {} : { topic }) };
|
|
90
|
+
}
|
|
91
|
+
if (operation === 'previews')
|
|
92
|
+
return { ...base, operation, previews: previews };
|
|
93
|
+
if (operation === 'test') {
|
|
94
|
+
const deviceId = options.get('--device');
|
|
95
|
+
return { ...base, operation, ...(deviceId === undefined ? {} : { deviceId }) };
|
|
96
|
+
}
|
|
97
|
+
return { ...base, operation };
|
|
98
|
+
};
|
|
99
|
+
const platformName = { apns: 'APNs', fcm: 'FCM' };
|
|
100
|
+
const time = (valueArg) => new Date(valueArg).toISOString();
|
|
101
|
+
const failureLine = (failureArg) => (`${failureArg.reason}${failureArg.vendorReason === undefined ? '' : ` (${failureArg.vendorReason})`} at ${time(failureArg.at)}`
|
|
102
|
+
+ (failureArg.clockSkewMs === undefined ? ''
|
|
103
|
+
: `; the push service's clock and the host's were ${pushClockSkewText(failureArg.clockSkewMs)}: set the host's clock right (NTP)`));
|
|
104
|
+
const devices = (countArg) => `${countArg} registered device${countArg === 1 ? '' : 's'}`;
|
|
105
|
+
/** One device's answer to `agl push test`, as a line: never its token. */
|
|
106
|
+
export const pushTestLine = (resultArg) => {
|
|
107
|
+
const where = `${resultArg.name} (${resultArg.deviceId}, ${platformName[resultArg.platform]}${resultArg.environment === undefined ? '' : ` ${resultArg.environment}`})`;
|
|
108
|
+
const vendor = resultArg.vendorReason === undefined ? '' : ` (${resultArg.vendorReason})`;
|
|
109
|
+
if (resultArg.outcome === 'delivered')
|
|
110
|
+
return `${where}: delivered`;
|
|
111
|
+
if (resultArg.outcome === 'unregistered') {
|
|
112
|
+
return `${where}: the push service no longer knows its token${vendor}; its registration was removed, and the app registers again on its next connect`;
|
|
113
|
+
}
|
|
114
|
+
if (resultArg.outcome === 'unavailable')
|
|
115
|
+
return `${where}: not sent: the host holds no usable ${platformName[resultArg.platform]} credential`;
|
|
116
|
+
if (resultArg.outcome === 'no_answer')
|
|
117
|
+
return `${where}: no answer in time: ${platformName[resultArg.platform]} did not answer within ${pushTestAnswerWaitMs / 1000} s; the notification may still arrive`;
|
|
118
|
+
return `${where}: not delivered: ${resultArg.outcome}${vendor}`;
|
|
119
|
+
};
|
|
120
|
+
/** `agl push status` as lines: previews, then each platform. */
|
|
121
|
+
export const pushStatusLines = (statusArg) => {
|
|
122
|
+
const lines = [`Previews: ${statusArg.previews ? 'on' : 'off'}`];
|
|
123
|
+
const { apns, fcm } = statusArg;
|
|
124
|
+
const states = {
|
|
125
|
+
unset: 'not set',
|
|
126
|
+
ready: 'ready',
|
|
127
|
+
refused: 'refused: nothing is sent until it is set again',
|
|
128
|
+
unreadable: 'unreadable on this machine: nothing is sent until it is set again',
|
|
129
|
+
};
|
|
130
|
+
lines.push(`APNs: ${states[apns.state]}${apns.keyId === undefined ? '' : `, key id ${apns.keyId}, team ${apns.teamId}, topic ${apns.topic}`}`
|
|
131
|
+
+ `${apns.setAt === undefined ? '' : `, set ${time(apns.setAt)}`}; ${devices(apns.registrations)}`);
|
|
132
|
+
if (apns.refused)
|
|
133
|
+
lines.push(` refused ${failureLine(apns.refused)}`);
|
|
134
|
+
if (apns.lastFailure)
|
|
135
|
+
lines.push(` last failed send: ${failureLine(apns.lastFailure)}`);
|
|
136
|
+
lines.push(`FCM: ${states[fcm.state]}${fcm.projectId === undefined ? '' : `, project ${fcm.projectId}, service account ${fcm.clientEmail}`}`
|
|
137
|
+
+ `${fcm.setAt === undefined ? '' : `, set ${time(fcm.setAt)}`}; ${devices(fcm.registrations)}`);
|
|
138
|
+
if (fcm.refused)
|
|
139
|
+
lines.push(` refused ${failureLine(fcm.refused)}`);
|
|
140
|
+
if (fcm.lastFailure)
|
|
141
|
+
lines.push(` last failed send: ${failureLine(fcm.lastFailure)}`);
|
|
142
|
+
return lines;
|
|
143
|
+
};
|
|
144
|
+
/** What a change did, as one line. */
|
|
145
|
+
const changeLine = (parsedArg, changeArg) => {
|
|
146
|
+
if (parsedArg.operation === 'apns.set') {
|
|
147
|
+
const { keyId, teamId, topic } = changeArg.status.apns;
|
|
148
|
+
return `Set the APNs credential: key id ${keyId}, team ${teamId}, topic ${topic}. The key is sealed with the TPM and never printed.`;
|
|
149
|
+
}
|
|
150
|
+
if (parsedArg.operation === 'fcm.set') {
|
|
151
|
+
const { projectId, clientEmail } = changeArg.status.fcm;
|
|
152
|
+
return `Set the FCM credential: project ${projectId}, service account ${clientEmail}. The key is sealed with the TPM and never printed.`;
|
|
153
|
+
}
|
|
154
|
+
if (parsedArg.operation === 'apns.unset' || parsedArg.operation === 'fcm.unset') {
|
|
155
|
+
const name = platformName[parsedArg.operation === 'apns.unset' ? 'apns' : 'fcm'];
|
|
156
|
+
return changeArg.changed ? `Removed the ${name} credential: nothing is sent on ${name} until it is set again.`
|
|
157
|
+
: `No ${name} credential was set; nothing changed.`;
|
|
158
|
+
}
|
|
159
|
+
const previews = parsedArg.previews ? 'on' : 'off';
|
|
160
|
+
return changeArg.changed ? `Previews are ${previews} now.` : `Previews were ${previews} already; nothing changed.`;
|
|
161
|
+
};
|
|
162
|
+
/** The key a `set` reads, refused from a terminal; nothing of it is printed. */
|
|
163
|
+
const readKey = (parsedArg, inputArg) => (parsedArg.operation === 'apns.set'
|
|
164
|
+
? readStandardInputSecret(inputArg, 'agl push apns set reads the AuthKey .p8 file from a pipe or a file, never from a '
|
|
165
|
+
+ 'terminal: run it as `agl push apns set --key-id KEY_ID --team-id TEAM_ID < AuthKey_KEY_ID.p8`.', 'an APNs signing key')
|
|
166
|
+
: readStandardInputSecret(inputArg, 'agl push fcm set reads the service account key file from a pipe or a file, never '
|
|
167
|
+
+ 'from a terminal: run it as `agl push fcm set < SERVICE_ACCOUNT.json`.', 'a service account key file', 16 * 1024));
|
|
168
|
+
export const runPushCli = async (argsArg, optionsArg = {}) => {
|
|
169
|
+
const write = optionsArg.write ?? ((textArg) => { process.stdout.write(textArg); });
|
|
170
|
+
if (argsArg.includes('--help') || argsArg.includes('-h')) {
|
|
171
|
+
write(pushCliHelp);
|
|
172
|
+
return;
|
|
173
|
+
}
|
|
174
|
+
const parsed = parsePushCliArguments(argsArg);
|
|
175
|
+
const key = parsed.operation === 'apns.set' || parsed.operation === 'fcm.set'
|
|
176
|
+
? await readKey(parsed, optionsArg.input ?? process.stdin) : undefined;
|
|
177
|
+
const request = parsed.operation === 'apns.set'
|
|
178
|
+
? { keyId: parsed.keyId, teamId: parsed.teamId, ...(parsed.topic === undefined ? {} : { topic: parsed.topic }), signingKey: key }
|
|
179
|
+
: parsed.operation === 'fcm.set' ? { serviceAccount: key }
|
|
180
|
+
: parsed.operation === 'previews' ? { previews: parsed.previews }
|
|
181
|
+
: parsed.operation === 'test' && parsed.deviceId !== undefined ? { deviceId: parsed.deviceId } : {};
|
|
182
|
+
const client = new ControllerMcpClient({ controllerPort: parsed.port });
|
|
183
|
+
const withOwner = optionsArg.withOwner ?? withLocalConfigurationOwner;
|
|
184
|
+
await withCliDiagnostics(async () => withOwner(client, parsed.port, async (ownerTokenArg) => {
|
|
185
|
+
const answer = await client.push(parsed.operation, { ...request, ownerToken: ownerTokenArg });
|
|
186
|
+
if (parsed.operation === 'status') {
|
|
187
|
+
write(parsed.json ? `${JSON.stringify(answer)}\n` : pushStatusLines(answer).map((lineArg) => `${lineArg}\n`).join(''));
|
|
188
|
+
return;
|
|
189
|
+
}
|
|
190
|
+
if (parsed.operation === 'test') {
|
|
191
|
+
const { results } = answer;
|
|
192
|
+
write(parsed.json ? `${JSON.stringify(answer)}\n`
|
|
193
|
+
: results.length === 0 ? 'No paired device is registered for notifications.\n'
|
|
194
|
+
: results.map((resultArg) => `${pushTestLine(resultArg)}\n`).join(''));
|
|
195
|
+
return;
|
|
196
|
+
}
|
|
197
|
+
const change = answer;
|
|
198
|
+
write([changeLine(parsed, change), ...pushStatusLines(change.status)].map((lineArg) => `${lineArg}\n`).join(''));
|
|
199
|
+
}));
|
|
200
|
+
};
|
|
201
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLnB1c2hjbGkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mdW5jdGlvbnMucHVzaGNsaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUM3RCxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUNuRSxPQUFPLEVBQUUsMkJBQTJCLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUNoRixPQUFPLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUNuRSxPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUM1RCxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsb0JBQW9CLEVBQTBHLE1BQU0sMEJBQTBCLENBQUM7QUFFM0wsTUFBTSxDQUFDLE1BQU0sV0FBVyxHQUFHOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztDQTZCMUIsQ0FBQztBQVlGLG1IQUFtSDtBQUNuSCxNQUFNLENBQUMsTUFBTSxxQkFBcUIsR0FBRyxDQUFDLE9BQTBCLEVBQXFCLEVBQUU7SUFDckYsTUFBTSxJQUFJLEdBQUcsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxDQUFDO0lBQzFCLE1BQU0sS0FBSyxHQUFHLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztJQUMzQixJQUFJLFNBQXFDLENBQUM7SUFDMUMsSUFBSSxRQUE2QixDQUFDO0lBQ2xDLElBQUksS0FBSyxLQUFLLFFBQVEsSUFBSSxLQUFLLEtBQUssTUFBTTtRQUFFLFNBQVMsR0FBRyxLQUFLLENBQUM7U0FDekQsSUFBSSxDQUFDLEtBQUssS0FBSyxNQUFNLElBQUksS0FBSyxLQUFLLEtBQUssQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxLQUFLLEtBQUssSUFBSSxJQUFJLENBQUMsQ0FBQyxDQUFDLEtBQUssT0FBTyxDQUFDO1FBQUUsU0FBUyxH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
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
import type { TPushErrorCode } from '../dist_ts_interfaces/push.js';
|
|
3
|
+
/**
|
|
4
|
+
* The push credentials the owner gives the host (AGL-1639), checked before they are sealed: an APNs signing key
|
|
5
|
+
* (Apple's AuthKey .p8 file: one P-256 private key) with its key id, team id and topic, and an FCM service account key
|
|
6
|
+
* (Google's JSON key file: a project, the service account's address and an RSA private key). A refusal names the field
|
|
7
|
+
* and the rule, never what was given.
|
|
8
|
+
*/
|
|
9
|
+
/** The bundle id the AGL apps ship under (iOS and Android): the APNs topic unless the owner names another. */
|
|
10
|
+
export declare const defaultApnsTopic = "com.modelprofile.harness";
|
|
11
|
+
/** A refusal of an `agl push` request, with the sentence the owner reads. */
|
|
12
|
+
export declare class PushError extends Error {
|
|
13
|
+
readonly code: TPushErrorCode;
|
|
14
|
+
constructor(code: TPushErrorCode, messageArg: string);
|
|
15
|
+
}
|
|
16
|
+
export declare const isAppleId: (valueArg: unknown) => valueArg is string;
|
|
17
|
+
export declare const isBundleId: (valueArg: unknown) => valueArg is string;
|
|
18
|
+
export declare const isFirebaseProjectId: (valueArg: unknown) => valueArg is string;
|
|
19
|
+
export declare const isServiceAccountEmail: (valueArg: unknown) => valueArg is string;
|
|
20
|
+
export declare const isServiceAccountKeyId: (valueArg: unknown) => valueArg is string;
|
|
21
|
+
/** A private key as the store keeps it sealed: PKCS #8, DER. */
|
|
22
|
+
export declare const privateKeyBytes: (keyArg: plugins.crypto.KeyObject) => Buffer;
|
|
23
|
+
/** A sealed key read back. */
|
|
24
|
+
export declare const privateKeyFromBytes: (bytesArg: Uint8Array) => plugins.crypto.KeyObject;
|
|
25
|
+
export interface IApnsCredentialInput {
|
|
26
|
+
keyId: string;
|
|
27
|
+
teamId: string;
|
|
28
|
+
topic: string;
|
|
29
|
+
key: plugins.crypto.KeyObject;
|
|
30
|
+
}
|
|
31
|
+
/** Whether a key is a P-256 private key, the only kind APNs signs provider tokens with (ES256). */
|
|
32
|
+
export declare const isApnsSigningKey: (keyArg: plugins.crypto.KeyObject) => boolean;
|
|
33
|
+
/** Whether a key is an RSA private key of at least 2048 bits, which Google's token endpoint takes (RS256). */
|
|
34
|
+
export declare const isServiceAccountSigningKey: (keyArg: plugins.crypto.KeyObject) => boolean;
|
|
35
|
+
/** `agl push apns set`: the key id, team id and topic, and the .p8 file's text. */
|
|
36
|
+
export declare const parseApnsCredential: (inputArg: {
|
|
37
|
+
keyId: unknown;
|
|
38
|
+
teamId: unknown;
|
|
39
|
+
topic?: unknown;
|
|
40
|
+
signingKey: unknown;
|
|
41
|
+
}) => IApnsCredentialInput;
|
|
42
|
+
export interface IFcmCredentialInput {
|
|
43
|
+
projectId: string;
|
|
44
|
+
clientEmail: string;
|
|
45
|
+
/** The key's id, when the file names one: the provider token's `kid`. */
|
|
46
|
+
privateKeyId?: string;
|
|
47
|
+
key: plugins.crypto.KeyObject;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* `agl push fcm set`: the service account key file's JSON. Its `token_uri` and the other URLs it carries are ignored:
|
|
51
|
+
* the host asks Google's own token endpoint only.
|
|
52
|
+
*/
|
|
53
|
+
export declare const parseFcmCredential: (textArg: unknown) => IFcmCredentialInput;
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
/**
|
|
3
|
+
* The push credentials the owner gives the host (AGL-1639), checked before they are sealed: an APNs signing key
|
|
4
|
+
* (Apple's AuthKey .p8 file: one P-256 private key) with its key id, team id and topic, and an FCM service account key
|
|
5
|
+
* (Google's JSON key file: a project, the service account's address and an RSA private key). A refusal names the field
|
|
6
|
+
* and the rule, never what was given.
|
|
7
|
+
*/
|
|
8
|
+
/** The bundle id the AGL apps ship under (iOS and Android): the APNs topic unless the owner names another. */
|
|
9
|
+
export const defaultApnsTopic = 'com.modelprofile.harness';
|
|
10
|
+
/** A refusal of an `agl push` request, with the sentence the owner reads. */
|
|
11
|
+
export class PushError extends Error {
|
|
12
|
+
code;
|
|
13
|
+
constructor(code, messageArg) {
|
|
14
|
+
super(messageArg);
|
|
15
|
+
this.code = code;
|
|
16
|
+
this.name = 'PushError';
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
/** An Apple key id or team id: 10 characters of capital letters and digits. */
|
|
20
|
+
const appleIdPattern = /^[A-Z0-9]{10}$/u;
|
|
21
|
+
/** A bundle id: at least two dot-separated parts of letters, digits and hyphens, at most 155 characters. */
|
|
22
|
+
const bundleIdPattern = /^(?=.{3,155}$)[A-Za-z0-9-]+(?:\.[A-Za-z0-9-]+)+$/u;
|
|
23
|
+
/** A Google Cloud project id: 6 to 30 lowercase letters, digits and hyphens, from a letter, not ending in a hyphen. */
|
|
24
|
+
const projectIdPattern = /^[a-z][a-z0-9-]{4,28}[a-z0-9]$/u;
|
|
25
|
+
/** A service account's address: one line of printable ASCII around one `@`, at most 254 characters. */
|
|
26
|
+
const clientEmailPattern = /^(?=.{3,254}$)[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$/u;
|
|
27
|
+
/** The id of a service account key, which Google names in the JWT header (`kid`). */
|
|
28
|
+
const privateKeyIdPattern = /^[A-Za-z0-9]{1,128}$/u;
|
|
29
|
+
export const isAppleId = (valueArg) => typeof valueArg === 'string' && appleIdPattern.test(valueArg);
|
|
30
|
+
export const isBundleId = (valueArg) => typeof valueArg === 'string' && bundleIdPattern.test(valueArg);
|
|
31
|
+
export const isFirebaseProjectId = (valueArg) => typeof valueArg === 'string' && projectIdPattern.test(valueArg);
|
|
32
|
+
export const isServiceAccountEmail = (valueArg) => typeof valueArg === 'string' && clientEmailPattern.test(valueArg);
|
|
33
|
+
export const isServiceAccountKeyId = (valueArg) => typeof valueArg === 'string' && privateKeyIdPattern.test(valueArg);
|
|
34
|
+
const refuse = (messageArg) => new PushError('push_credential_invalid', messageArg);
|
|
35
|
+
/** A private key from PEM text; refused, without the cause (which could quote the input), when it is none. */
|
|
36
|
+
const readPrivateKey = (pemArg, refusalArg) => {
|
|
37
|
+
try {
|
|
38
|
+
return plugins.crypto.createPrivateKey({ key: pemArg, format: 'pem' });
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
throw refuse(refusalArg);
|
|
42
|
+
}
|
|
43
|
+
};
|
|
44
|
+
/** A private key as the store keeps it sealed: PKCS #8, DER. */
|
|
45
|
+
export const privateKeyBytes = (keyArg) => keyArg.export({ format: 'der', type: 'pkcs8' });
|
|
46
|
+
/** A sealed key read back. */
|
|
47
|
+
export const privateKeyFromBytes = (bytesArg) => (plugins.crypto.createPrivateKey({ key: Buffer.from(bytesArg), format: 'der', type: 'pkcs8' }));
|
|
48
|
+
/** Whether a key is a P-256 private key, the only kind APNs signs provider tokens with (ES256). */
|
|
49
|
+
export const isApnsSigningKey = (keyArg) => (keyArg.type === 'private' && keyArg.asymmetricKeyType === 'ec' && keyArg.asymmetricKeyDetails?.namedCurve === 'prime256v1');
|
|
50
|
+
/** Whether a key is an RSA private key of at least 2048 bits, which Google's token endpoint takes (RS256). */
|
|
51
|
+
export const isServiceAccountSigningKey = (keyArg) => (keyArg.type === 'private' && keyArg.asymmetricKeyType === 'rsa' && (keyArg.asymmetricKeyDetails?.modulusLength ?? 0) >= 2048);
|
|
52
|
+
/** `agl push apns set`: the key id, team id and topic, and the .p8 file's text. */
|
|
53
|
+
export const parseApnsCredential = (inputArg) => {
|
|
54
|
+
if (!isAppleId(inputArg.keyId))
|
|
55
|
+
throw refuse('--key-id must be the 10-character key id Apple shows for the key: capital letters and digits.');
|
|
56
|
+
if (!isAppleId(inputArg.teamId))
|
|
57
|
+
throw refuse('--team-id must be the 10-character Apple team id: capital letters and digits.');
|
|
58
|
+
const topic = inputArg.topic ?? defaultApnsTopic;
|
|
59
|
+
if (!isBundleId(topic))
|
|
60
|
+
throw refuse('--topic must be the app\'s bundle id, such as com.modelprofile.harness.');
|
|
61
|
+
const refusal = 'The standard input is not an APNs signing key: give the AuthKey .p8 file Apple issued, which holds one '
|
|
62
|
+
+ 'P-256 private key (PKCS #8 PEM).';
|
|
63
|
+
if (typeof inputArg.signingKey !== 'string' || inputArg.signingKey.length === 0)
|
|
64
|
+
throw refuse(refusal);
|
|
65
|
+
const key = readPrivateKey(inputArg.signingKey, refusal);
|
|
66
|
+
if (!isApnsSigningKey(key))
|
|
67
|
+
throw refuse(refusal);
|
|
68
|
+
return { keyId: inputArg.keyId, teamId: inputArg.teamId, topic, key };
|
|
69
|
+
};
|
|
70
|
+
/**
|
|
71
|
+
* `agl push fcm set`: the service account key file's JSON. Its `token_uri` and the other URLs it carries are ignored:
|
|
72
|
+
* the host asks Google's own token endpoint only.
|
|
73
|
+
*/
|
|
74
|
+
export const parseFcmCredential = (textArg) => {
|
|
75
|
+
const file = 'The standard input is not a service account key: give the JSON key file of the Firebase project\'s service '
|
|
76
|
+
+ 'account (Project settings, Service accounts, Generate new private key).';
|
|
77
|
+
if (typeof textArg !== 'string' || textArg.length === 0)
|
|
78
|
+
throw refuse(file);
|
|
79
|
+
let value;
|
|
80
|
+
try {
|
|
81
|
+
value = JSON.parse(textArg);
|
|
82
|
+
}
|
|
83
|
+
catch {
|
|
84
|
+
throw refuse(file);
|
|
85
|
+
}
|
|
86
|
+
if (!value || typeof value !== 'object' || Array.isArray(value))
|
|
87
|
+
throw refuse(file);
|
|
88
|
+
const record = value;
|
|
89
|
+
if (record.type !== 'service_account')
|
|
90
|
+
throw refuse(`${file} Its type is not service_account.`);
|
|
91
|
+
if (!isFirebaseProjectId(record.project_id))
|
|
92
|
+
throw refuse('The service account key has no valid project_id.');
|
|
93
|
+
if (!isServiceAccountEmail(record.client_email))
|
|
94
|
+
throw refuse('The service account key has no valid client_email.');
|
|
95
|
+
if (record.private_key_id !== undefined && !isServiceAccountKeyId(record.private_key_id)) {
|
|
96
|
+
throw refuse('The service account key has an invalid private_key_id.');
|
|
97
|
+
}
|
|
98
|
+
const keyRefusal = 'The service account key\'s private_key is not an RSA private key of at least 2048 bits (PKCS #8 PEM).';
|
|
99
|
+
if (typeof record.private_key !== 'string' || record.private_key.length === 0)
|
|
100
|
+
throw refuse(keyRefusal);
|
|
101
|
+
const key = readPrivateKey(record.private_key, keyRefusal);
|
|
102
|
+
if (!isServiceAccountSigningKey(key))
|
|
103
|
+
throw refuse(keyRefusal);
|
|
104
|
+
return {
|
|
105
|
+
projectId: record.project_id,
|
|
106
|
+
clientEmail: record.client_email,
|
|
107
|
+
...(record.private_key_id === undefined ? {} : { privateKeyId: record.private_key_id }),
|
|
108
|
+
key,
|
|
109
|
+
};
|
|
110
|
+
};
|
|
111
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLnB1c2hjcmVkZW50aWFscy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Z1bmN0aW9ucy5wdXNoY3JlZGVudGlhbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFHeEM7Ozs7O0dBS0c7QUFFSCw4R0FBOEc7QUFDOUcsTUFBTSxDQUFDLE1BQU0sZ0JBQWdCLEdBQUcsMEJBQTBCLENBQUM7QUFFM0QsNkVBQTZFO0FBQzdFLE1BQU0sT0FBTyxTQUFVLFNBQVEsS0FBSztJQUNOLElBQUk7SUFBaEMsWUFBNEIsSUFBb0IsRUFBRSxVQUFrQjtRQUNsRSxLQUFLLENBQUMsVUFBVSxDQUFDLENBQUM7b0JBRFEsSUFBSTtRQUU5QixJQUFJLENBQUMsSUFBSSxHQUFHLFdBQVcsQ0FBQztJQUMxQixDQUFDO0NBQ0Y7QUFFRCwrRUFBK0U7QUFDL0UsTUFBTSxjQUFjLEdBQUcsaUJBQWlCLENBQUM7QUFDekMsNEdBQTRHO0FBQzVHLE1BQU0sZUFBZSxHQUFHLG1EQUFtRCxDQUFDO0FBQzVFLHVIQUF1SDtBQUN2SCxNQUFNLGdCQUFnQixHQUFHLGlDQUFpQyxDQUFDO0FBQzNELHVHQUF1RztBQUN2RyxNQUFNLGtCQUFrQixHQUFHLGdFQUFnRSxDQUFDO0FBQzVGLHFGQUFxRjtBQUNyRixNQUFNLG1CQUFtQixHQUFHLHVCQUF1QixDQUFDO0FBRXBELE1BQU0sQ0FBQyxNQUFNLFNBQVMsR0FBRyxDQUFDLFFBQWlCLEVBQXNCLEVBQUUsQ0FBQyxPQUFPLFFBQVEsS0FBSyxRQUFRLElBQUksY0FBYyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQztBQUNsSSxNQUFNLENBQUMsTUFBTSxVQUFVLEdBQUcsQ0FBQyxRQUFpQixFQUFzQixFQUFFLENBQUMsT0FBTyxRQUFRLEtBQUssUUFBUSxJQUFJLGVBQWUsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLENBQUM7QUFD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
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { type TControllerMcpPushMethod } from '../dist_ts_interfaces/push.js';
|
|
2
|
+
export declare const isControllerMcpPushMethod: (methodArg: string) => methodArg is TControllerMcpPushMethod;
|
|
3
|
+
/** An `agl.mcp.push.*` request in shape, with the owner capability; refused without naming a value. */
|
|
4
|
+
export declare const assertPushWireRequest: (methodArg: string, valueArg: unknown) => Record<string, unknown>;
|
|
5
|
+
/** A request as the controller's answer echoes it: the owner capability and the keys replaced. */
|
|
6
|
+
export declare const redactPushRequest: (requestArg: Record<string, unknown>) => Record<string, unknown>;
|
|
7
|
+
/** An `agl.mcp.push.*` answer in shape, as `agl push` prints it. */
|
|
8
|
+
export declare const assertPushResponse: (methodArg: TControllerMcpPushMethod, valueArg: unknown) => void;
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import { controllerMcpPushMethods, pushOperationOf, pushSecretRequestFields, } from '../dist_ts_interfaces/push.js';
|
|
2
|
+
/**
|
|
3
|
+
* The shape of `agl push` requests and answers on the controller's private channel (AGL-1639). Only the shape: the
|
|
4
|
+
* controller judges the values, and neither a refusal here nor one there repeats a value, since `signingKey` and
|
|
5
|
+
* `serviceAccount` carry the owner's keys.
|
|
6
|
+
*/
|
|
7
|
+
const isRecord = (valueArg) => (!!valueArg && typeof valueArg === 'object' && !Array.isArray(valueArg));
|
|
8
|
+
const isText = (valueArg, maximumArg) => (typeof valueArg === 'string' && valueArg.length > 0 && valueArg.length <= maximumArg);
|
|
9
|
+
/** Each request's fields besides `ownerToken`, with the most a field may hold. */
|
|
10
|
+
const requestFields = {
|
|
11
|
+
status: { required: {} },
|
|
12
|
+
// A .p8 file is about 250 bytes; a service account key file about 2.4 KB.
|
|
13
|
+
'apns.set': { required: { keyId: 64, teamId: 64, signingKey: 16 * 1024 }, optional: { topic: 255 } },
|
|
14
|
+
'apns.unset': { required: {} },
|
|
15
|
+
'fcm.set': { required: { serviceAccount: 32 * 1024 } },
|
|
16
|
+
'fcm.unset': { required: {} },
|
|
17
|
+
previews: { required: { previews: 'boolean' } },
|
|
18
|
+
test: { required: {}, optional: { deviceId: 64 } },
|
|
19
|
+
};
|
|
20
|
+
export const isControllerMcpPushMethod = (methodArg) => (controllerMcpPushMethods.includes(methodArg));
|
|
21
|
+
/** An `agl.mcp.push.*` request in shape, with the owner capability; refused without naming a value. */
|
|
22
|
+
export const assertPushWireRequest = (methodArg, valueArg) => {
|
|
23
|
+
if (!isControllerMcpPushMethod(methodArg) || !isRecord(valueArg))
|
|
24
|
+
throw new Error('Invalid private controller request.');
|
|
25
|
+
const { required, optional = {} } = requestFields[pushOperationOf(methodArg)];
|
|
26
|
+
const keys = Object.keys(valueArg);
|
|
27
|
+
if (!isText(valueArg.ownerToken, 1024)
|
|
28
|
+
|| keys.some((keyArg) => keyArg !== 'ownerToken' && !Object.hasOwn(required, keyArg) && !Object.hasOwn(optional, keyArg))
|
|
29
|
+
|| Object.entries(required).some(([keyArg, ruleArg]) => (ruleArg === 'boolean'
|
|
30
|
+
? typeof valueArg[keyArg] !== 'boolean' : !isText(valueArg[keyArg], ruleArg)))
|
|
31
|
+
|| Object.entries(optional).some(([keyArg, maximumArg]) => valueArg[keyArg] !== undefined && !isText(valueArg[keyArg], maximumArg))) {
|
|
32
|
+
throw new Error('Invalid private controller request.');
|
|
33
|
+
}
|
|
34
|
+
return valueArg;
|
|
35
|
+
};
|
|
36
|
+
/** A request as the controller's answer echoes it: the owner capability and the keys replaced. */
|
|
37
|
+
export const redactPushRequest = (requestArg) => {
|
|
38
|
+
const redacted = { ...requestArg };
|
|
39
|
+
for (const field of ['ownerToken', ...pushSecretRequestFields])
|
|
40
|
+
if (Object.hasOwn(redacted, field))
|
|
41
|
+
redacted[field] = '[redacted]';
|
|
42
|
+
return redacted;
|
|
43
|
+
};
|
|
44
|
+
const credentialStates = ['unset', 'ready', 'refused', 'unreadable'];
|
|
45
|
+
const failureReasons = ['credential_refused', 'refused', 'rate_limited', 'service_failed', 'unreachable'];
|
|
46
|
+
const isTime = (valueArg) => Number.isSafeInteger(valueArg) && valueArg > 0;
|
|
47
|
+
/** A clock skew within a year either way. */
|
|
48
|
+
const isClockSkew = (valueArg) => Number.isSafeInteger(valueArg) && Math.abs(valueArg) <= 366 * 24 * 60 * 60_000;
|
|
49
|
+
const isFailure = (valueArg) => isRecord(valueArg) && isTime(valueArg.at) && failureReasons.includes(valueArg.reason)
|
|
50
|
+
&& (valueArg.vendorReason === undefined || isText(valueArg.vendorReason, 64))
|
|
51
|
+
&& (valueArg.clockSkewMs === undefined || isClockSkew(valueArg.clockSkewMs))
|
|
52
|
+
&& Object.keys(valueArg).every((keyArg) => ['at', 'reason', 'vendorReason', 'clockSkewMs'].includes(keyArg));
|
|
53
|
+
const isPlatformStatus = (valueArg, fieldsArg) => isRecord(valueArg)
|
|
54
|
+
&& credentialStates.includes(valueArg.state)
|
|
55
|
+
&& Number.isSafeInteger(valueArg.registrations) && valueArg.registrations >= 0
|
|
56
|
+
&& (valueArg.setAt === undefined || isTime(valueArg.setAt))
|
|
57
|
+
&& (valueArg.refused === undefined || isFailure(valueArg.refused))
|
|
58
|
+
&& (valueArg.lastFailure === undefined || isFailure(valueArg.lastFailure))
|
|
59
|
+
&& fieldsArg.every((keyArg) => valueArg[keyArg] === undefined || isText(valueArg[keyArg], 255))
|
|
60
|
+
&& Object.keys(valueArg).every((keyArg) => ['state', 'registrations', 'setAt', 'refused', 'lastFailure', ...fieldsArg].includes(keyArg));
|
|
61
|
+
const isPushStatus = (valueArg) => isRecord(valueArg)
|
|
62
|
+
&& Object.keys(valueArg).length === 3 && typeof valueArg.previews === 'boolean'
|
|
63
|
+
&& isPlatformStatus(valueArg.apns, ['keyId', 'teamId', 'topic'])
|
|
64
|
+
&& isPlatformStatus(valueArg.fcm, ['projectId', 'clientEmail']);
|
|
65
|
+
const testOutcomes = ['delivered', 'unregistered', 'unavailable', 'no_answer', ...failureReasons];
|
|
66
|
+
const isTestResult = (valueArg) => isRecord(valueArg)
|
|
67
|
+
&& isText(valueArg.deviceId, 64) && typeof valueArg.name === 'string' && valueArg.name.length <= 256
|
|
68
|
+
&& (valueArg.platform === 'apns' || valueArg.platform === 'fcm')
|
|
69
|
+
&& (valueArg.environment === undefined || valueArg.environment === 'sandbox' || valueArg.environment === 'production')
|
|
70
|
+
&& testOutcomes.includes(valueArg.outcome)
|
|
71
|
+
&& (valueArg.vendorReason === undefined || isText(valueArg.vendorReason, 64))
|
|
72
|
+
&& Object.keys(valueArg).every((keyArg) => ['deviceId', 'name', 'platform', 'environment', 'outcome', 'vendorReason'].includes(keyArg));
|
|
73
|
+
/** An `agl.mcp.push.*` answer in shape, as `agl push` prints it. */
|
|
74
|
+
export const assertPushResponse = (methodArg, valueArg) => {
|
|
75
|
+
const operation = pushOperationOf(methodArg);
|
|
76
|
+
const valid = operation === 'status' ? isPushStatus(valueArg)
|
|
77
|
+
: operation === 'test' ? isRecord(valueArg) && Object.keys(valueArg).length === 1 && Array.isArray(valueArg.results)
|
|
78
|
+
&& valueArg.results.length <= 1024 && valueArg.results.every(isTestResult)
|
|
79
|
+
: isRecord(valueArg) && Object.keys(valueArg).length === 2 && typeof valueArg.changed === 'boolean' && isPushStatus(valueArg.status);
|
|
80
|
+
if (!valid)
|
|
81
|
+
throw new Error('invalid');
|
|
82
|
+
};
|
|
83
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLnB1c2h3aXJlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvZnVuY3Rpb25zLnB1c2h3aXJlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFDTCx3QkFBd0IsRUFDeEIsZUFBZSxFQUNmLHVCQUF1QixHQUd4QixNQUFNLDBCQUEwQixDQUFDO0FBRWxDOzs7O0dBSUc7QUFFSCxNQUFNLFFBQVEsR0FBRyxDQUFDLFFBQWlCLEVBQXVDLEVBQUUsQ0FBQyxDQUMzRSxDQUFDLENBQUMsUUFBUSxJQUFJLE9BQU8sUUFBUSxLQUFLLFFBQVEsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLENBQ3ZFLENBQUM7QUFFRixNQUFNLE1BQU0sR0FBRyxDQUFDLFFBQWlCLEVBQUUsVUFBa0IsRUFBc0IsRUFBRSxDQUFDLENBQzVFLE9BQU8sUUFBUSxLQUFLLFFBQVEsSUFBSSxRQUFRLENBQUMsTUFBTSxHQUFHLENBQUMsSUFBSSxRQUFRLENBQUMsTUFBTSxJQUFJLFVBQVUsQ0FDckYsQ0FBQztBQUVGLGtGQUFrRjtBQUNsRixNQUFNLGFBQWEsR0FBZ0g7SUFDakksTUFBTSxFQUFFLEVBQUUsUUFBUSxFQUFFLEVBQUUsRUFBRTtJQUN4QiwwRUFBMEU7SUFDMUUsVUFBVSxFQUFFLEVBQUUsUUFBUSxFQUFFLEVBQUUsS0FBSyxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsRUFBRSxFQUFFLFVBQVUsRUFBRSxFQUFFLEdBQUcsSUFBSSxFQUFFLEVBQUUsUUFBUSxFQUFFLEVBQUUsS0FBSyxFQUFFLEdBQUcsRUFBRSxFQUFFO0lBQ3BHLFlBQVksRUFBRSxFQUFFLFFBQVEsRUFBRSxFQUFFLEVBQUU7SUFDOUIsU0FBUyxFQUFFLEVBQUUsUUFBUSxFQUFFLEVBQUUsY0FBYyxFQUFFLEVBQUUsR0FBRyxJQUFJLEVBQUUsRUFBRTtJQUN0RCxXQUFXLEVBQUUsRUFBRSxRQUFRLEVBQUUsRUFBRSxFQUFF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SyxHQUFHLFNBQVMsS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDLFlBQVksQ0FBQyxRQUFRLENBQUM7UUFDM0QsQ0FBQyxDQUFDLFNBQVMsS0FBSyxNQUFNLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsSUFBSSxNQUFNLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDLE1BQU0sS0FBSyxDQUFDLElBQUksS0FBSyxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsT0FBTyxDQUFDO2VBQy9HLFFBQVEsQ0FBQyxPQUFPLENBQUMsTUFBTSxJQUFJLElBQUksSUFBSSxRQUFRLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxZQUFZLENBQUM7WUFDMUUsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsSUFBSSxNQUFNLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDLE1BQU0sS0FBSyxDQUFDLElBQUksT0FBTyxRQUFRLENBQUMsT0FBTyxLQUFLLFNBQVMsSUFBSSxZQUFZLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ3pJLElBQUksQ0FBQyxLQUFLO1FBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyxTQUFTLENBQUMsQ0FBQztBQUN6QyxDQUFDLENBQUMifQ==
|
|
@@ -32,11 +32,11 @@ export interface IRemoteCliOptions {
|
|
|
32
32
|
}
|
|
33
33
|
/**
|
|
34
34
|
* Reads a secret from standard input, a pipe or a file, never a terminal (`refusalArg` names the right way), and
|
|
35
|
-
* returns it trimmed; nothing of it is echoed or kept past the read.
|
|
35
|
+
* returns it trimmed; nothing of it is echoed or kept past the read. `maximumBytesArg` bounds it (4 KiB by default).
|
|
36
36
|
*/
|
|
37
37
|
export declare const readStandardInputSecret: (inputArg: NodeJS.ReadableStream & {
|
|
38
38
|
isTTY?: boolean;
|
|
39
|
-
}, refusalArg: string, whatArg: string) => Promise<string>;
|
|
39
|
+
}, refusalArg: string, whatArg: string, maximumBytesArg?: number) => Promise<string>;
|
|
40
40
|
export interface IStoppedController {
|
|
41
41
|
authStore: SmartDataAuthStore;
|
|
42
42
|
issuer: IControllerIssuerIdentity;
|