agl 41.2.0 → 42.1.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 +41 -0
- package/dist_serve/bundle.js +2625 -2278
- package/dist_serve/bundle.js.map +2 -2
- package/dist_serve/bundle.js.third-party-notices.json +3 -68
- package/dist_serve/bundle.js.third-party-notices.txt +4 -137
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/aglapisurface.document.js +4 -4
- package/dist_ts/classes.authmodels.d.ts +2 -8
- package/dist_ts/classes.authmodels.js +60 -23
- package/dist_ts/classes.authstore.d.ts +24 -0
- package/dist_ts/classes.authstore.js +185 -23
- package/dist_ts/classes.cli.d.ts +3 -6
- package/dist_ts/classes.cli.js +38 -51
- package/dist_ts/classes.config.d.ts +17 -3
- package/dist_ts/classes.config.js +55 -18
- package/dist_ts/classes.controller.d.ts +83 -14
- package/dist_ts/classes.controller.js +545 -229
- package/dist_ts/classes.controllerdevices.d.ts +128 -0
- package/dist_ts/classes.controllerdevices.js +472 -0
- package/dist_ts/classes.controllermanagement.d.ts +42 -9
- package/dist_ts/classes.controllermanagement.js +72 -23
- package/dist_ts/classes.controllerservice.d.ts +3 -31
- package/dist_ts/classes.controllerservice.js +3 -47
- package/dist_ts/classes.mcpcontrollerhost.js +9 -3
- package/dist_ts/classes.processinspection.d.ts +8 -1
- package/dist_ts/classes.processinspection.js +92 -2
- package/dist_ts/classes.proxycontrol.js +6 -1
- package/dist_ts/classes.proxydaemon.d.ts +2 -2
- package/dist_ts/classes.proxydaemon.js +1 -1
- package/dist_ts/classes.proxystore.d.ts +2 -11
- package/dist_ts/classes.proxystore.js +3 -25
- package/dist_ts/classes.sessionfeed.d.ts +10 -1
- package/dist_ts/classes.sessionfeed.js +12 -2
- package/dist_ts/classes.tpmsecretcodec.d.ts +13 -0
- package/dist_ts/classes.tpmsecretcodec.js +28 -0
- package/dist_ts/classes.trustedproxysecrets.d.ts +91 -0
- package/dist_ts/classes.trustedproxysecrets.js +338 -0
- package/dist_ts/classes.upgradecoordinator.d.ts +14 -1
- package/dist_ts/classes.upgradecoordinator.js +21 -3
- package/dist_ts/classes.upgradetransaction.d.ts +32 -0
- package/dist_ts/classes.upgradetransaction.js +101 -4
- package/dist_ts/classes.validation.d.ts +2 -0
- package/dist_ts/classes.validation.js +2 -2
- package/dist_ts/functions.controlleradmission.d.ts +67 -0
- package/dist_ts/functions.controlleradmission.js +127 -0
- package/dist_ts/functions.deviceapi.d.ts +28 -0
- package/dist_ts/functions.deviceapi.js +246 -0
- package/dist_ts/functions.deviceproof.d.ts +33 -0
- package/dist_ts/functions.deviceproof.js +93 -0
- package/dist_ts/functions.remotecli.d.ts +27 -0
- package/dist_ts/functions.remotecli.js +241 -0
- package/dist_ts/functions.retiredenvironment.d.ts +11 -2
- package/dist_ts/functions.retiredenvironment.js +22 -5
- package/dist_ts/index.d.ts +1 -0
- package/dist_ts/index.js +2 -1
- package/dist_ts/interfaces.auth.d.ts +29 -4
- package/dist_ts/interfaces.auth.js +10 -1
- package/dist_ts/interfaces.config.d.ts +14 -0
- package/dist_ts/interfaces.config.js +9 -2
- package/dist_ts/interfaces.lifecycle.d.ts +3 -0
- package/dist_ts_authswitch/classes.authoritydaemon.js +6 -1
- package/dist_ts_interfaces/devices.d.ts +331 -0
- package/dist_ts_interfaces/devices.js +34 -0
- package/dist_ts_interfaces/index.d.ts +2 -0
- package/dist_ts_interfaces/index.js +3 -1
- package/dist_ts_interfaces/interfaces.d.ts +5 -3
- package/dist_ts_interfaces/interfaces.js +3 -2
- package/dist_ts_interfaces/management.d.ts +2 -2
- package/dist_ts_interfaces/management.js +2 -2
- package/dist_ts_interfaces/mcprequests.d.ts +1 -1
- package/dist_ts_interfaces/requests.d.ts +2 -2
- package/dist_ts_interfaces/requests.devices.d.ts +89 -0
- package/dist_ts_interfaces/requests.devices.js +2 -0
- package/dist_ts_interfaces/requests.upgrade.d.ts +0 -12
- package/package.json +12 -11
- package/readme.md +116 -24
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/aglapisurface.document.ts +3 -3
- package/ts/classes.authmodels.ts +68 -25
- package/ts/classes.authstore.ts +183 -24
- package/ts/classes.cli.ts +38 -61
- package/ts/classes.config.ts +70 -21
- package/ts/classes.controller.ts +746 -329
- package/ts/classes.controllerdevices.ts +469 -0
- package/ts/classes.controllermanagement.ts +123 -49
- package/ts/classes.controllerservice.ts +3 -56
- package/ts/classes.mcpcontrollerhost.ts +10 -5
- package/ts/classes.processinspection.ts +84 -3
- package/ts/classes.proxycontrol.ts +2 -0
- package/ts/classes.proxydaemon.ts +3 -2
- package/ts/classes.proxystore.ts +4 -25
- package/ts/classes.sessionfeed.ts +13 -1
- package/ts/classes.tpmsecretcodec.ts +26 -0
- package/ts/classes.trustedproxysecrets.ts +317 -0
- package/ts/classes.upgradecoordinator.ts +33 -3
- package/ts/classes.upgradetransaction.ts +130 -1
- package/ts/classes.validation.ts +1 -1
- package/ts/functions.controlleradmission.ts +168 -0
- package/ts/functions.deviceapi.ts +295 -0
- package/ts/functions.deviceproof.ts +118 -0
- package/ts/functions.remotecli.ts +270 -0
- package/ts/functions.retiredenvironment.ts +25 -3
- package/ts/index.ts +1 -0
- package/ts/interfaces.auth.ts +41 -3
- package/ts/interfaces.config.ts +15 -0
- package/ts/interfaces.lifecycle.ts +3 -0
- package/ts_authswitch/classes.authoritydaemon.ts +2 -0
- package/ts_interfaces/devices.schema.json +890 -0
- package/ts_interfaces/devices.ts +392 -0
- package/ts_interfaces/index.ts +2 -0
- package/ts_interfaces/interfaces.ts +5 -2
- package/ts_interfaces/management.ts +2 -2
- package/ts_interfaces/mcprequests.ts +1 -1
- package/ts_interfaces/requests.devices.ts +95 -0
- package/ts_interfaces/requests.ts +10 -10
- package/ts_interfaces/requests.upgrade.ts +0 -16
- package/ts_web/00_commitinfo_data.ts +1 -1
- package/ts_web/classes.controllersocketclient.ts +27 -0
- package/ts_web/elements.devices.ts +752 -0
- package/ts_web/elements.harnesscontrollerapp.ts +18 -1
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
import type { IControllerRuntimeConfig, TControllerTlsMode } from './interfaces.config.js';
|
|
3
|
+
/** The header a trusted TLS reverse proxy injects with the controller's trusted-proxy secret. */
|
|
4
|
+
export declare const trustedProxySecretHeader = "x-harness-controller-proxy-secret";
|
|
5
|
+
/** At most this many gateway source addresses per controller. */
|
|
6
|
+
export declare const maximumGatewaySources = 16;
|
|
7
|
+
/**
|
|
8
|
+
* A peer or configured address as one canonical IP literal: IPv4 dotted, an IPv4-mapped IPv6 address as its IPv4
|
|
9
|
+
* address (a dual-stack listener reports IPv4 peers so), IPv6 compressed and lower case. Undefined for anything
|
|
10
|
+
* else, a scoped IPv6 address and SmartServe's `unknown` included.
|
|
11
|
+
*/
|
|
12
|
+
export declare const canonicalIpAddress: (valueArg: string) => string | undefined;
|
|
13
|
+
/** 127.0.0.0/8 and ::1, given as canonical addresses. */
|
|
14
|
+
export declare const isLoopbackAddress: (addressArg: string) => boolean;
|
|
15
|
+
/** One configured gateway source address, canonical; loopback and unspecified addresses are refused. */
|
|
16
|
+
export declare const canonicalGatewaySource: (valueArg: string) => string;
|
|
17
|
+
/** The configured gateway source addresses, canonical, sorted and without duplicates. */
|
|
18
|
+
export declare const canonicalGatewaySources: (valuesArg: readonly string[]) => string[];
|
|
19
|
+
/**
|
|
20
|
+
* The one interface address the controller listens on: loopback in local mode and in TLS-proxy mode without a
|
|
21
|
+
* gateway source (a reverse proxy on this host), every interface otherwise, IPv6 as well when a gateway source is
|
|
22
|
+
* IPv6. Admission then refuses every address off loopback that is not a gateway source.
|
|
23
|
+
*/
|
|
24
|
+
export declare const controllerListenHostname: (configArg: Pick<IControllerRuntimeConfig, 'tlsMode' | 'gatewaySources'>) => string;
|
|
25
|
+
export type TControllerAdmissionKind = 'request' | 'upgrade';
|
|
26
|
+
/**
|
|
27
|
+
* Why a request or WebSocket upgrade was refused: `source` (off loopback and not from a gateway source, or off
|
|
28
|
+
* loopback at all in local mode), `secret` (without the trusted-proxy secret), `origin` (another browser origin, or
|
|
29
|
+
* off loopback without one on an upgrade or on a request other than GET and HEAD), `forwarded_proto` (an upgrade
|
|
30
|
+
* through the proxy without `X-Forwarded-Proto: https`).
|
|
31
|
+
*/
|
|
32
|
+
export type TControllerAdmissionRefusal = 'source' | 'secret' | 'origin' | 'forwarded_proto';
|
|
33
|
+
export interface IControllerAdmissionPolicy {
|
|
34
|
+
publicOrigin: string;
|
|
35
|
+
tlsMode: TControllerTlsMode;
|
|
36
|
+
/** Canonical, as `IControllerRuntimeConfig.gatewaySources` holds them. */
|
|
37
|
+
gatewaySources: readonly string[];
|
|
38
|
+
/** Whether a header value is the trusted-proxy secret (the current one or a rotation's); never in local mode. */
|
|
39
|
+
acceptsProxySecret(valueArg: string | null): boolean;
|
|
40
|
+
}
|
|
41
|
+
export interface IControllerAdmissionRequest {
|
|
42
|
+
headers: Headers;
|
|
43
|
+
/**
|
|
44
|
+
* The HTTP method as received (`Request.method`), never SmartServe's `IRequestContext.method`, which reports any
|
|
45
|
+
* method it does not know as GET.
|
|
46
|
+
*/
|
|
47
|
+
method: string;
|
|
48
|
+
/** The direct peer, as SmartServe reports it (`IConnectionInfo.remoteAddr`). */
|
|
49
|
+
remoteAddr: string;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* The admission of every HTTP request and WebSocket upgrade on the controller's one listener; undefined admits.
|
|
53
|
+
*
|
|
54
|
+
* Off loopback a request needs both a configured gateway source address and the trusted-proxy secret. An upgrade
|
|
55
|
+
* there also needs the public origin as `Origin` and `X-Forwarded-Proto: https`: only the operator's own tools on
|
|
56
|
+
* loopback connect without an `Origin`. A GET or HEAD request there may come without one, as a browser's navigation
|
|
57
|
+
* and asset requests do; every other method needs the public origin, and no request may carry another. On loopback
|
|
58
|
+
* a request is served as it always was, and an upgrade with an `Origin` needs the public origin, and in TLS-proxy
|
|
59
|
+
* mode the forwarded protocol and the secret as well: a reverse proxy on this host forwards from loopback.
|
|
60
|
+
*/
|
|
61
|
+
export declare const controllerAdmissionRefusal: (kindArg: TControllerAdmissionKind, requestArg: IControllerAdmissionRequest, policyArg: IControllerAdmissionPolicy) => TControllerAdmissionRefusal | undefined;
|
|
62
|
+
/**
|
|
63
|
+
* The listener options of the controller's one TypedServer: the interface it binds (`controllerListenHostname`) and
|
|
64
|
+
* the admission of every HTTP request and WebSocket upgrade on it, every surface included, by
|
|
65
|
+
* `controllerAdmissionRefusal`. A refusal answers 403.
|
|
66
|
+
*/
|
|
67
|
+
export declare const controllerListenerOptions: (configArg: Pick<IControllerRuntimeConfig, 'publicOrigin' | 'tlsMode' | 'gatewaySources'>, acceptsProxySecretArg: (valueArg: string | null) => boolean) => Required<Pick<plugins.typedserver.IServerOptions, 'listenHostname' | 'requestAdmission' | 'websocketAdmission'>>;
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
/** The header a trusted TLS reverse proxy injects with the controller's trusted-proxy secret. */
|
|
3
|
+
export const trustedProxySecretHeader = 'x-harness-controller-proxy-secret';
|
|
4
|
+
/** At most this many gateway source addresses per controller. */
|
|
5
|
+
export const maximumGatewaySources = 16;
|
|
6
|
+
const ipv4MappedPattern = /^::ffff:(\d{1,3}(?:\.\d{1,3}){3})$/iu;
|
|
7
|
+
/**
|
|
8
|
+
* A peer or configured address as one canonical IP literal: IPv4 dotted, an IPv4-mapped IPv6 address as its IPv4
|
|
9
|
+
* address (a dual-stack listener reports IPv4 peers so), IPv6 compressed and lower case. Undefined for anything
|
|
10
|
+
* else, a scoped IPv6 address and SmartServe's `unknown` included.
|
|
11
|
+
*/
|
|
12
|
+
export const canonicalIpAddress = (valueArg) => {
|
|
13
|
+
const mapped = ipv4MappedPattern.exec(valueArg);
|
|
14
|
+
const candidate = mapped ? mapped[1] : valueArg;
|
|
15
|
+
const family = plugins.net.isIP(candidate);
|
|
16
|
+
if (family === 4)
|
|
17
|
+
return candidate;
|
|
18
|
+
if (family !== 6 || candidate.includes('%'))
|
|
19
|
+
return undefined;
|
|
20
|
+
try {
|
|
21
|
+
return new URL(`http://[${candidate}]/`).hostname.slice(1, -1);
|
|
22
|
+
}
|
|
23
|
+
catch {
|
|
24
|
+
return undefined;
|
|
25
|
+
}
|
|
26
|
+
};
|
|
27
|
+
/** 127.0.0.0/8 and ::1, given as canonical addresses. */
|
|
28
|
+
export const isLoopbackAddress = (addressArg) => addressArg === '::1' || (plugins.net.isIPv4(addressArg) && addressArg.startsWith('127.'));
|
|
29
|
+
const describeInput = (valueArg) => JSON.stringify(valueArg.slice(0, 64));
|
|
30
|
+
/** One configured gateway source address, canonical; loopback and unspecified addresses are refused. */
|
|
31
|
+
export const canonicalGatewaySource = (valueArg) => {
|
|
32
|
+
const address = canonicalIpAddress(valueArg.trim());
|
|
33
|
+
if (address === undefined) {
|
|
34
|
+
throw new Error(`Gateway source ${describeInput(valueArg)} is not an IPv4 or unscoped IPv6 address.`);
|
|
35
|
+
}
|
|
36
|
+
if (isLoopbackAddress(address)) {
|
|
37
|
+
throw new Error(`Gateway source ${address} is a loopback address; loopback is always admitted without one.`);
|
|
38
|
+
}
|
|
39
|
+
if (address === '0.0.0.0' || address === '::') {
|
|
40
|
+
throw new Error(`Gateway source ${address} is the unspecified address; name the gateway's own address.`);
|
|
41
|
+
}
|
|
42
|
+
return address;
|
|
43
|
+
};
|
|
44
|
+
/** The configured gateway source addresses, canonical, sorted and without duplicates. */
|
|
45
|
+
export const canonicalGatewaySources = (valuesArg) => {
|
|
46
|
+
const sources = [...new Set(valuesArg.map(canonicalGatewaySource))].sort();
|
|
47
|
+
if (sources.length > maximumGatewaySources) {
|
|
48
|
+
throw new Error(`A controller takes at most ${maximumGatewaySources} gateway source addresses.`);
|
|
49
|
+
}
|
|
50
|
+
return sources;
|
|
51
|
+
};
|
|
52
|
+
/**
|
|
53
|
+
* The one interface address the controller listens on: loopback in local mode and in TLS-proxy mode without a
|
|
54
|
+
* gateway source (a reverse proxy on this host), every interface otherwise, IPv6 as well when a gateway source is
|
|
55
|
+
* IPv6. Admission then refuses every address off loopback that is not a gateway source.
|
|
56
|
+
*/
|
|
57
|
+
export const controllerListenHostname = (configArg) => {
|
|
58
|
+
const sources = configArg.tlsMode === 'proxy' ? configArg.gatewaySources ?? [] : [];
|
|
59
|
+
if (sources.length === 0)
|
|
60
|
+
return '127.0.0.1';
|
|
61
|
+
return sources.some((sourceArg) => plugins.net.isIPv6(sourceArg)) ? '::' : '0.0.0.0';
|
|
62
|
+
};
|
|
63
|
+
/** The only methods admitted off loopback without an `Origin`: a browser sends none on navigations and asset loads. */
|
|
64
|
+
const originlessMethods = new Set(['GET', 'HEAD']);
|
|
65
|
+
/**
|
|
66
|
+
* The admission of every HTTP request and WebSocket upgrade on the controller's one listener; undefined admits.
|
|
67
|
+
*
|
|
68
|
+
* Off loopback a request needs both a configured gateway source address and the trusted-proxy secret. An upgrade
|
|
69
|
+
* there also needs the public origin as `Origin` and `X-Forwarded-Proto: https`: only the operator's own tools on
|
|
70
|
+
* loopback connect without an `Origin`. A GET or HEAD request there may come without one, as a browser's navigation
|
|
71
|
+
* and asset requests do; every other method needs the public origin, and no request may carry another. On loopback
|
|
72
|
+
* a request is served as it always was, and an upgrade with an `Origin` needs the public origin, and in TLS-proxy
|
|
73
|
+
* mode the forwarded protocol and the secret as well: a reverse proxy on this host forwards from loopback.
|
|
74
|
+
*/
|
|
75
|
+
export const controllerAdmissionRefusal = (kindArg, requestArg, policyArg) => {
|
|
76
|
+
const peer = canonicalIpAddress(requestArg.remoteAddr);
|
|
77
|
+
const origin = requestArg.headers.get('origin');
|
|
78
|
+
if (peer === undefined || !isLoopbackAddress(peer)) {
|
|
79
|
+
if (policyArg.tlsMode !== 'proxy' || peer === undefined || !policyArg.gatewaySources.includes(peer))
|
|
80
|
+
return 'source';
|
|
81
|
+
if (!policyArg.acceptsProxySecret(requestArg.headers.get(trustedProxySecretHeader)))
|
|
82
|
+
return 'secret';
|
|
83
|
+
if (origin === null) {
|
|
84
|
+
return kindArg === 'request' && originlessMethods.has(requestArg.method) ? undefined : 'origin';
|
|
85
|
+
}
|
|
86
|
+
if (origin !== policyArg.publicOrigin)
|
|
87
|
+
return 'origin';
|
|
88
|
+
if (kindArg === 'upgrade' && requestArg.headers.get('x-forwarded-proto') !== 'https')
|
|
89
|
+
return 'forwarded_proto';
|
|
90
|
+
return undefined;
|
|
91
|
+
}
|
|
92
|
+
if (kindArg === 'request' || origin === null)
|
|
93
|
+
return undefined;
|
|
94
|
+
if (origin !== policyArg.publicOrigin)
|
|
95
|
+
return 'origin';
|
|
96
|
+
if (policyArg.tlsMode === 'local')
|
|
97
|
+
return undefined;
|
|
98
|
+
if (requestArg.headers.get('x-forwarded-proto') !== 'https')
|
|
99
|
+
return 'forwarded_proto';
|
|
100
|
+
if (!policyArg.acceptsProxySecret(requestArg.headers.get(trustedProxySecretHeader)))
|
|
101
|
+
return 'secret';
|
|
102
|
+
return undefined;
|
|
103
|
+
};
|
|
104
|
+
/**
|
|
105
|
+
* The listener options of the controller's one TypedServer: the interface it binds (`controllerListenHostname`) and
|
|
106
|
+
* the admission of every HTTP request and WebSocket upgrade on it, every surface included, by
|
|
107
|
+
* `controllerAdmissionRefusal`. A refusal answers 403.
|
|
108
|
+
*/
|
|
109
|
+
export const controllerListenerOptions = (configArg, acceptsProxySecretArg) => {
|
|
110
|
+
const policy = {
|
|
111
|
+
publicOrigin: configArg.publicOrigin,
|
|
112
|
+
tlsMode: configArg.tlsMode,
|
|
113
|
+
gatewaySources: [...(configArg.tlsMode === 'proxy' ? configArg.gatewaySources ?? [] : [])],
|
|
114
|
+
acceptsProxySecret: (valueArg) => configArg.tlsMode === 'proxy' && acceptsProxySecretArg(valueArg),
|
|
115
|
+
};
|
|
116
|
+
const admit = (kindArg) => (contextArg) => (controllerAdmissionRefusal(kindArg, {
|
|
117
|
+
headers: contextArg.headers,
|
|
118
|
+
method: contextArg.request.method,
|
|
119
|
+
remoteAddr: contextArg.connectionInfo?.remoteAddr ?? 'unknown',
|
|
120
|
+
}, policy) === undefined);
|
|
121
|
+
return {
|
|
122
|
+
listenHostname: controllerListenHostname(configArg),
|
|
123
|
+
requestAdmission: admit('request'),
|
|
124
|
+
websocketAdmission: admit('upgrade'),
|
|
125
|
+
};
|
|
126
|
+
};
|
|
127
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLmNvbnRyb2xsZXJhZG1pc3Npb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mdW5jdGlvbnMuY29udHJvbGxlcmFkbWlzc2lvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUd4QyxpR0FBaUc7QUFDakcsTUFBTSxDQUFDLE1BQU0sd0JBQXdCLEdBQUcsbUNBQW1DLENBQUM7QUFFNUUsaUVBQWlFO0FBQ2pFLE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLEVBQUUsQ0FBQztBQUV4QyxNQUFNLGlCQUFpQixHQUFHLHNDQUFzQyxDQUFDO0FBRWpFOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxDQUFDLFFBQWdCLEVBQXNCLEVBQUU7SUFDekUsTUFBTSxNQUFNLEdBQUcsaUJBQWlCLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQ2hELE1BQU0sU0FBUyxHQUFHLE1BQU0sQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBRSxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUM7SUFDakQsTUFBTSxNQUFNLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUM7SUFDM0MsSUFBSSxNQUFNLEtBQUssQ0FBQztRQUFFLE9BQU8sU0FBUyxDQUFDO0lBQ25DLElBQUksTUFBTSxLQUFLLENBQUMsSUFBSSxTQUFTLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQztRQUFFLE9BQU8sU0FBUyxDQUFDO0lBQzlELElBQUksQ0FBQztRQUNILE9BQU8sSUFBSSxHQUFHLENBQUMsV0FBVyxTQUFTLElBQUksQ0FBQyxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDakUsQ0FBQztJQUFDLE1BQU0sQ0FBQztRQUNQLE9BQU8sU0FBUyxDQUFD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
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { IControllerEvent, IControllerMessageBundle, IControllerPermission, IControllerQuestion, IControllerSessionFeedRow, TControllerEventType, TControllerSessionFeedDelta } from '../dist_ts_interfaces/index.js';
|
|
2
|
+
import { type IDeviceMessage, type IDevicePermission, type IDeviceQuestion, type IDeviceSessionFeedDelta, type IDeviceSessionRow, type IReq_DeviceAuthChallenge, type IReq_DeviceAuthProve, type IReq_DevicePair, type IReq_DevicePermissionReply, type IReq_DeviceQuestionReply, type IReq_DeviceSessionRead, type IReq_DeviceSessionSend, type TDeviceEvent } from '../dist_ts_interfaces/devices.js';
|
|
3
|
+
/** The controller events a device receives, each projected by `deviceEvent`; every other event never reaches one. */
|
|
4
|
+
export declare const deviceRelayedEventTypes: ReadonlySet<TControllerEventType>;
|
|
5
|
+
/** A feed row as a device sees it; none for a terminal row, which a device does not open. */
|
|
6
|
+
export declare const deviceSessionRow: (rowArg: IControllerSessionFeedRow) => IDeviceSessionRow | undefined;
|
|
7
|
+
export declare const deviceSessionRows: (rowsArg: readonly IControllerSessionFeedRow[]) => IDeviceSessionRow[];
|
|
8
|
+
/** A feed change as a device applies it: the same epoch and revision, terminal rows left out. */
|
|
9
|
+
export declare const deviceFeedDelta: (deltaArg: TControllerSessionFeedDelta) => IDeviceSessionFeedDelta;
|
|
10
|
+
/** A transcript page's messages, oldest first. */
|
|
11
|
+
export declare const deviceMessages: (bundlesArg: readonly IControllerMessageBundle[]) => IDeviceMessage[];
|
|
12
|
+
export declare const devicePermissions: (permissionsArg: readonly IControllerPermission[]) => IDevicePermission[];
|
|
13
|
+
export declare const deviceQuestions: (questionsArg: readonly IControllerQuestion[]) => IDeviceQuestion[];
|
|
14
|
+
/** A controller event as a device receives it, or none. `rowOfArg` answers the feed's published rows. */
|
|
15
|
+
export declare const deviceEvent: (eventArg: IControllerEvent, rowOfArg: (rowIdArg: string) => IControllerSessionFeedRow | undefined) => TDeviceEvent | undefined;
|
|
16
|
+
export declare const assertDevicePairRequest: (valueArg: unknown) => IReq_DevicePair['request'];
|
|
17
|
+
export declare const assertDeviceAuthChallengeRequest: (valueArg: unknown) => IReq_DeviceAuthChallenge['request'];
|
|
18
|
+
export declare const assertDeviceAuthProveRequest: (valueArg: unknown) => IReq_DeviceAuthProve['request'];
|
|
19
|
+
export declare const assertDeviceSessionReadRequest: (valueArg: unknown) => IReq_DeviceSessionRead['request'];
|
|
20
|
+
export declare const assertDeviceSessionSendRequest: (valueArg: unknown) => IReq_DeviceSessionSend['request'];
|
|
21
|
+
export declare const assertDevicePermissionReplyRequest: (valueArg: unknown) => IReq_DevicePermissionReply['request'];
|
|
22
|
+
export declare const assertDeviceQuestionReplyRequest: (valueArg: unknown) => IReq_DeviceQuestionReply['request'];
|
|
23
|
+
export declare const assertDevicePairingCancelRequest: (valueArg: unknown) => {
|
|
24
|
+
pairingId: string;
|
|
25
|
+
};
|
|
26
|
+
export declare const assertDeviceRevokeRequest: (valueArg: unknown) => {
|
|
27
|
+
deviceId: string;
|
|
28
|
+
};
|
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
import { deviceLabelMaximumCharacters, deviceMessageMaximumBytes, } from '../dist_ts_interfaces/devices.js';
|
|
2
|
+
import { isControllerSessionFeedRowId } from '../dist_ts_interfaces/sessionfeed.js';
|
|
3
|
+
import { assertKeys, assertObject, assertQuestionAnswers } from './classes.validation.js';
|
|
4
|
+
import { sessionFeedRowId } from './classes.sessionfeed.js';
|
|
5
|
+
/*
|
|
6
|
+
* The device API's requests and projections: what a device may ask, checked before anything is read, and the reduced
|
|
7
|
+
* shapes of what it gets. A device sees the session feed without host paths, tickets or terminals, transcripts with
|
|
8
|
+
* tool calls reduced to name, title and status, and an allowlist of events.
|
|
9
|
+
*/
|
|
10
|
+
/** The controller events a device receives, each projected by `deviceEvent`; every other event never reaches one. */
|
|
11
|
+
export const deviceRelayedEventTypes = new Set([
|
|
12
|
+
'sessionfeed.changed',
|
|
13
|
+
'sessions.changed',
|
|
14
|
+
'session.changed',
|
|
15
|
+
'session.history.changed',
|
|
16
|
+
'permissions.changed',
|
|
17
|
+
'session.text.updated',
|
|
18
|
+
'session.text.delta',
|
|
19
|
+
]);
|
|
20
|
+
/** A feed row as a device sees it; none for a terminal row, which a device does not open. */
|
|
21
|
+
export const deviceSessionRow = (rowArg) => (rowArg.open.kind === 'terminal' ? undefined : {
|
|
22
|
+
id: rowArg.id,
|
|
23
|
+
harness: rowArg.harness,
|
|
24
|
+
state: rowArg.state,
|
|
25
|
+
name: rowArg.name,
|
|
26
|
+
...(rowArg.excerpt === undefined ? {} : { excerpt: rowArg.excerpt }),
|
|
27
|
+
updatedAt: rowArg.updatedAt,
|
|
28
|
+
});
|
|
29
|
+
export const deviceSessionRows = (rowsArg) => rowsArg
|
|
30
|
+
.flatMap((rowArg) => deviceSessionRow(rowArg) ?? []);
|
|
31
|
+
/** A feed change as a device applies it: the same epoch and revision, terminal rows left out. */
|
|
32
|
+
export const deviceFeedDelta = (deltaArg) => 'reset' in deltaArg
|
|
33
|
+
? { epoch: deltaArg.epoch, revision: deltaArg.revision, reset: true, upserts: [], removed: [] }
|
|
34
|
+
: {
|
|
35
|
+
epoch: deltaArg.epoch,
|
|
36
|
+
revision: deltaArg.revision,
|
|
37
|
+
reset: false,
|
|
38
|
+
upserts: deviceSessionRows(deltaArg.upserts),
|
|
39
|
+
removed: [...deltaArg.removed],
|
|
40
|
+
};
|
|
41
|
+
/** One source message of a transcript as one device message: its reasoning, text and tool calls as parts, in order. */
|
|
42
|
+
const deviceMessage = (bundleArg) => {
|
|
43
|
+
const first = bundleArg.messages[0];
|
|
44
|
+
if (!first)
|
|
45
|
+
return undefined;
|
|
46
|
+
const parts = [];
|
|
47
|
+
for (const message of bundleArg.messages) {
|
|
48
|
+
for (const reasoning of message.reasoning ?? []) {
|
|
49
|
+
if (reasoning.text !== '')
|
|
50
|
+
parts.push({ type: 'reasoning', id: reasoning.id.nativeId, text: reasoning.text });
|
|
51
|
+
}
|
|
52
|
+
if (message.toolCall) {
|
|
53
|
+
parts.push({
|
|
54
|
+
type: 'tool',
|
|
55
|
+
id: message.toolCall.id.nativeId,
|
|
56
|
+
tool: message.toolCall.name,
|
|
57
|
+
...(message.toolCall.title === undefined ? {} : { title: message.toolCall.title }),
|
|
58
|
+
status: message.toolCall.status,
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
else if (message.text !== '' || message.streaming === true) {
|
|
62
|
+
// A streaming part is listed while still empty: its live text applies to it.
|
|
63
|
+
parts.push({ type: 'text', id: message.id.nativeId, text: message.text });
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
return {
|
|
67
|
+
id: bundleArg.sourceMessageId.nativeId,
|
|
68
|
+
role: bundleArg.messages.some((messageArg) => messageArg.role === 'user') ? 'user' : 'assistant',
|
|
69
|
+
createdAt: first.createdAt,
|
|
70
|
+
parts,
|
|
71
|
+
};
|
|
72
|
+
};
|
|
73
|
+
/** A transcript page's messages, oldest first. */
|
|
74
|
+
export const deviceMessages = (bundlesArg) => bundlesArg
|
|
75
|
+
.flatMap((bundleArg) => deviceMessage(bundleArg) ?? []);
|
|
76
|
+
export const devicePermissions = (permissionsArg) => permissionsArg
|
|
77
|
+
.map((permissionArg) => ({
|
|
78
|
+
id: permissionArg.id.nativeId,
|
|
79
|
+
title: permissionArg.title,
|
|
80
|
+
type: permissionArg.type,
|
|
81
|
+
patterns: [...permissionArg.patterns],
|
|
82
|
+
}));
|
|
83
|
+
export const deviceQuestions = (questionsArg) => questionsArg
|
|
84
|
+
.map((questionArg) => ({
|
|
85
|
+
id: questionArg.id.nativeId,
|
|
86
|
+
questions: questionArg.questions.map((itemArg) => ({
|
|
87
|
+
question: itemArg.question,
|
|
88
|
+
header: itemArg.header,
|
|
89
|
+
options: itemArg.options.map(({ label, description }) => ({ label, description })),
|
|
90
|
+
...(itemArg.multiple === undefined ? {} : { multiple: itemArg.multiple }),
|
|
91
|
+
...(itemArg.custom === undefined ? {} : { custom: itemArg.custom }),
|
|
92
|
+
})),
|
|
93
|
+
}));
|
|
94
|
+
/**
|
|
95
|
+
* The row id a device names a conversation by, when the feed lists it as something a device opens; events about any
|
|
96
|
+
* other session (a driver, a child, a terminal's agent, one the feed has not listed yet) reach no device.
|
|
97
|
+
*/
|
|
98
|
+
const visibleRowId = (sessionIdArg, rowOfArg) => {
|
|
99
|
+
if (!sessionIdArg || sessionIdArg.harnessId === 'controller')
|
|
100
|
+
return undefined;
|
|
101
|
+
const rowId = sessionFeedRowId(sessionIdArg.harnessId, sessionIdArg.nativeId);
|
|
102
|
+
const row = rowOfArg(rowId);
|
|
103
|
+
return row && row.open.kind !== 'terminal' ? rowId : undefined;
|
|
104
|
+
};
|
|
105
|
+
/** A controller event as a device receives it, or none. `rowOfArg` answers the feed's published rows. */
|
|
106
|
+
export const deviceEvent = (eventArg, rowOfArg) => {
|
|
107
|
+
switch (eventArg.type) {
|
|
108
|
+
case 'sessionfeed.changed':
|
|
109
|
+
return eventArg.sessionFeed ? { type: 'sessionfeed.changed', delta: deviceFeedDelta(eventArg.sessionFeed) } : undefined;
|
|
110
|
+
case 'sessions.changed':
|
|
111
|
+
return { type: 'sessions.changed' };
|
|
112
|
+
case 'session.changed':
|
|
113
|
+
case 'session.history.changed':
|
|
114
|
+
case 'permissions.changed': {
|
|
115
|
+
if (!eventArg.sessionId)
|
|
116
|
+
return eventArg.type === 'permissions.changed' ? { type: 'sessions.changed' } : undefined;
|
|
117
|
+
const sessionId = visibleRowId(eventArg.sessionId, rowOfArg);
|
|
118
|
+
return sessionId === undefined ? undefined : { type: 'session.changed', sessionId };
|
|
119
|
+
}
|
|
120
|
+
case 'session.text.updated': {
|
|
121
|
+
const update = eventArg.textUpdate;
|
|
122
|
+
const sessionId = visibleRowId(update?.sessionId, rowOfArg);
|
|
123
|
+
return update && sessionId !== undefined ? {
|
|
124
|
+
type: 'session.text.updated',
|
|
125
|
+
update: { sessionId, messageId: update.messageId.nativeId, partId: update.partId.nativeId, text: update.text },
|
|
126
|
+
} : undefined;
|
|
127
|
+
}
|
|
128
|
+
case 'session.text.delta': {
|
|
129
|
+
const delta = eventArg.textDelta;
|
|
130
|
+
const sessionId = visibleRowId(delta?.sessionId, rowOfArg);
|
|
131
|
+
return delta && sessionId !== undefined ? {
|
|
132
|
+
type: 'session.text.delta',
|
|
133
|
+
delta: {
|
|
134
|
+
sessionId,
|
|
135
|
+
messageId: delta.messageId.nativeId,
|
|
136
|
+
partId: delta.partId.nativeId,
|
|
137
|
+
delta: delta.delta,
|
|
138
|
+
baseTextUtf8Bytes: delta.baseTextUtf8Bytes,
|
|
139
|
+
textUtf8Bytes: delta.textUtf8Bytes,
|
|
140
|
+
},
|
|
141
|
+
} : undefined;
|
|
142
|
+
}
|
|
143
|
+
default:
|
|
144
|
+
return undefined;
|
|
145
|
+
}
|
|
146
|
+
};
|
|
147
|
+
const assertText = (valueArg, nameArg, maximumBytesArg) => {
|
|
148
|
+
if (typeof valueArg !== 'string' || valueArg.length === 0 || Buffer.byteLength(valueArg, 'utf8') > maximumBytesArg) {
|
|
149
|
+
throw new Error(`${nameArg} must contain 1-${maximumBytesArg} UTF-8 bytes.`);
|
|
150
|
+
}
|
|
151
|
+
return valueArg;
|
|
152
|
+
};
|
|
153
|
+
const assertDeviceId = (valueArg) => {
|
|
154
|
+
if (typeof valueArg !== 'string' || !/^[A-Za-z0-9_-]{24}$/u.test(valueArg))
|
|
155
|
+
throw new Error('deviceId is not a device id.');
|
|
156
|
+
return valueArg;
|
|
157
|
+
};
|
|
158
|
+
const assertRowId = (valueArg) => {
|
|
159
|
+
if (!isControllerSessionFeedRowId(valueArg))
|
|
160
|
+
throw new Error('sessionId must name a session as the session feed does.');
|
|
161
|
+
return valueArg;
|
|
162
|
+
};
|
|
163
|
+
/** A device's name or model: one line of 1 to 64 characters, its surrounding blanks dropped. */
|
|
164
|
+
const assertDeviceLabel = (valueArg, nameArg) => {
|
|
165
|
+
const label = typeof valueArg === 'string' ? valueArg.trim() : '';
|
|
166
|
+
if (label.length === 0 || [...label].length > deviceLabelMaximumCharacters || /\p{Cc}/u.test(label)) {
|
|
167
|
+
throw new Error(`${nameArg} must be one line of 1-${deviceLabelMaximumCharacters} characters.`);
|
|
168
|
+
}
|
|
169
|
+
return label;
|
|
170
|
+
};
|
|
171
|
+
export const assertDevicePairRequest = (valueArg) => {
|
|
172
|
+
const value = assertObject(valueArg, 'device pair request');
|
|
173
|
+
assertKeys(value, ['code', 'name', 'model', 'publicKey', 'proof']);
|
|
174
|
+
return {
|
|
175
|
+
code: assertText(value.code, 'code', 64),
|
|
176
|
+
name: assertDeviceLabel(value.name, 'name'),
|
|
177
|
+
model: assertDeviceLabel(value.model, 'model'),
|
|
178
|
+
publicKey: assertText(value.publicKey, 'publicKey', 256),
|
|
179
|
+
proof: assertText(value.proof, 'proof', 128),
|
|
180
|
+
};
|
|
181
|
+
};
|
|
182
|
+
export const assertDeviceAuthChallengeRequest = (valueArg) => {
|
|
183
|
+
const value = assertObject(valueArg, 'device challenge request');
|
|
184
|
+
assertKeys(value, ['deviceId']);
|
|
185
|
+
return { deviceId: assertDeviceId(value.deviceId) };
|
|
186
|
+
};
|
|
187
|
+
export const assertDeviceAuthProveRequest = (valueArg) => {
|
|
188
|
+
const value = assertObject(valueArg, 'device proof request');
|
|
189
|
+
assertKeys(value, ['deviceId', 'signature']);
|
|
190
|
+
return { deviceId: assertDeviceId(value.deviceId), signature: assertText(value.signature, 'signature', 128) };
|
|
191
|
+
};
|
|
192
|
+
export const assertDeviceSessionReadRequest = (valueArg) => {
|
|
193
|
+
const value = assertObject(valueArg, 'device session read request');
|
|
194
|
+
assertKeys(value, ['sessionId'], ['before', 'limit']);
|
|
195
|
+
if (value.limit !== undefined && (!Number.isSafeInteger(value.limit) || value.limit < 1 || value.limit > 50)) {
|
|
196
|
+
throw new Error('limit must be an integer from 1 to 50.');
|
|
197
|
+
}
|
|
198
|
+
return {
|
|
199
|
+
sessionId: assertRowId(value.sessionId),
|
|
200
|
+
...(value.before === undefined ? {} : { before: assertText(value.before, 'before', 4096) }),
|
|
201
|
+
...(value.limit === undefined ? {} : { limit: value.limit }),
|
|
202
|
+
};
|
|
203
|
+
};
|
|
204
|
+
export const assertDeviceSessionSendRequest = (valueArg) => {
|
|
205
|
+
const value = assertObject(valueArg, 'device session send request');
|
|
206
|
+
assertKeys(value, ['sessionId', 'text']);
|
|
207
|
+
const text = assertText(value.text, 'text', deviceMessageMaximumBytes);
|
|
208
|
+
if (!text.trim() || text.includes('\0'))
|
|
209
|
+
throw new Error('text must be a message that is not blank.');
|
|
210
|
+
return { sessionId: assertRowId(value.sessionId), text };
|
|
211
|
+
};
|
|
212
|
+
export const assertDevicePermissionReplyRequest = (valueArg) => {
|
|
213
|
+
const value = assertObject(valueArg, 'device permission reply request');
|
|
214
|
+
assertKeys(value, ['sessionId', 'permissionId', 'reply'], ['message']);
|
|
215
|
+
if (value.reply !== 'once' && value.reply !== 'reject')
|
|
216
|
+
throw new Error('reply must be once or reject.');
|
|
217
|
+
return {
|
|
218
|
+
sessionId: assertRowId(value.sessionId),
|
|
219
|
+
permissionId: assertText(value.permissionId, 'permissionId', 512),
|
|
220
|
+
reply: value.reply,
|
|
221
|
+
...(value.message === undefined ? {} : { message: assertText(value.message, 'message', 2048) }),
|
|
222
|
+
};
|
|
223
|
+
};
|
|
224
|
+
export const assertDeviceQuestionReplyRequest = (valueArg) => {
|
|
225
|
+
const value = assertObject(valueArg, 'device question reply request');
|
|
226
|
+
assertKeys(value, ['sessionId', 'questionId', 'answers']);
|
|
227
|
+
return {
|
|
228
|
+
sessionId: assertRowId(value.sessionId),
|
|
229
|
+
questionId: assertText(value.questionId, 'questionId', 512),
|
|
230
|
+
answers: assertQuestionAnswers(value.answers),
|
|
231
|
+
};
|
|
232
|
+
};
|
|
233
|
+
export const assertDevicePairingCancelRequest = (valueArg) => {
|
|
234
|
+
const value = assertObject(valueArg, 'pairing cancel request');
|
|
235
|
+
assertKeys(value, ['pairingId']);
|
|
236
|
+
if (typeof value.pairingId !== 'string' || !/^[A-Za-z0-9_-]{22}$/u.test(value.pairingId)) {
|
|
237
|
+
throw new Error('pairingId is not a pairing id.');
|
|
238
|
+
}
|
|
239
|
+
return { pairingId: value.pairingId };
|
|
240
|
+
};
|
|
241
|
+
export const assertDeviceRevokeRequest = (valueArg) => {
|
|
242
|
+
const value = assertObject(valueArg, 'device revoke request');
|
|
243
|
+
assertKeys(value, ['deviceId']);
|
|
244
|
+
return { deviceId: assertDeviceId(value.deviceId) };
|
|
245
|
+
};
|
|
246
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb25zLmRldmljZWFwaS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Z1bmN0aW9ucy5kZXZpY2VhcGkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBVUEsT0FBTyxFQUNMLDRCQUE0QixFQUM1Qix5QkFBeUIsR0FlMUIsTUFBTSw2QkFBNkIsQ0FBQztBQUNyQyxPQUFPLEVBQUUsNEJBQTRCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUMvRSxPQUFPLEVBQUUsVUFBVSxFQUFFLFlBQVksRUFBRSxxQkFBcUIsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQzFGLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBRTVEOzs7O0dBSUc7QUFFSCxxSEFBcUg7QUFDckgsTUFBTSxDQUFDLE1BQU0sdUJBQXVCLEdBQXNDLElBQUksR0FBRyxDQUF1QjtJQUN0RyxxQkFBcUI7SUFDckIsa0JBQWtCO0lBQ2xCLGlCQUFpQjtJQUNqQix5QkFBeUI7SUFDekIscUJBQXFCO0lBQ3JCLHNCQUFzQjtJQUN0QixvQkFBb0I7Q0FDckIsQ0FBQyxDQUFDO0FBRUgsNkZBQTZGO0FBQzdGLE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUFHLENBQUMsTUFBaUMsRUFBaUMsRUFBRSxDQUFDLENBQ3BHLE1BQU0sQ0FBQyxJQUFJLENBQUMsSUFBSSxLQUFLLFVBQVUsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQztJQUM1QyxFQUFFLEVBQUUsTUFBTSxDQUFDLEVBQUU7SUFDYixPQUFPLEVBQUUsTUFBTSxDQUFDLE9BQU87SUFDdkIsS0FBSyxFQUFFLE1BQU0sQ0FBQyxLQUFLO0lBQ25CLElBQUksRUFBRSxNQUFNLENBQUMsSUFBSTtJQUNqQixHQUFHLENBQUMsTUFBTSxDQUFDLE9BQU8sS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxPQUFPLEVBQUUsTUFBTSxDQUFDLE9B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
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
/**
|
|
3
|
+
* The bytes of a base64url text without padding, refused (undefined) unless it is exactly that text's canonical form,
|
|
4
|
+
* of `byteLengthArg` bytes when given and of at most `maximumBytesArg` otherwise.
|
|
5
|
+
*/
|
|
6
|
+
export declare const decodeDeviceBase64Url: (valueArg: unknown, sizeArg: {
|
|
7
|
+
bytes: number;
|
|
8
|
+
} | {
|
|
9
|
+
maximumBytes: number;
|
|
10
|
+
}) => Buffer | undefined;
|
|
11
|
+
export interface IDeviceMessageBinding {
|
|
12
|
+
/** `controller:<port>`. */
|
|
13
|
+
controllerId: string;
|
|
14
|
+
/** The controller's public origin, exactly as it is configured. */
|
|
15
|
+
origin: string;
|
|
16
|
+
/** The device key, SubjectPublicKeyInfo DER. */
|
|
17
|
+
publicKey: Uint8Array;
|
|
18
|
+
}
|
|
19
|
+
/** The message a device signs to pair: it binds the key to this controller, origin and code. */
|
|
20
|
+
export declare const devicePairingMessage: (bindingArg: IDeviceMessageBinding, codeArg: Uint8Array) => Buffer;
|
|
21
|
+
/** The message a device signs to authenticate one connection: it binds the key to this controller, origin and nonce. */
|
|
22
|
+
export declare const deviceAuthenticationMessage: (bindingArg: IDeviceMessageBinding, nonceArg: Uint8Array) => Buffer;
|
|
23
|
+
/**
|
|
24
|
+
* A device's public key: a P-256 SubjectPublicKeyInfo in DER with an uncompressed point on the curve, in exactly the
|
|
25
|
+
* form `node:crypto` exports it again, so one key has one text and one fingerprint. Undefined for anything else.
|
|
26
|
+
*/
|
|
27
|
+
export declare const importDevicePublicKey: (spkiArg: Uint8Array) => plugins.crypto.KeyObject | undefined;
|
|
28
|
+
/** Whether `signatureArg` (ECDSA P-256 with SHA-256, DER) is the key's signature of `messageArg`. */
|
|
29
|
+
export declare const verifyDeviceSignature: (keyArg: plugins.crypto.KeyObject, messageArg: Uint8Array, signatureArg: Uint8Array) => boolean;
|
|
30
|
+
/** A key's fingerprint for people to compare: SHA-256 of the SPKI, the first 16 bytes as 8 groups of 4 uppercase hex. */
|
|
31
|
+
export declare const deviceKeyFingerprint: (spkiArg: Uint8Array) => string;
|
|
32
|
+
/** The QR code's payload: `agl-pair:?origin=<https origin>&controller=<controller id>&code=<base64url>`, each once. */
|
|
33
|
+
export declare const devicePairingPayload: (originArg: string, controllerIdArg: string, codeArg: Uint8Array) => string;
|