@celljs/ta-host 4.16.0 → 4.18.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.
Files changed (179) hide show
  1. package/esm/node/app-commands.d.ts +111 -0
  2. package/esm/node/app-commands.js +646 -0
  3. package/esm/node/credentials.d.ts +12 -0
  4. package/esm/node/credentials.js +35 -0
  5. package/esm/node/delegate-extension.d.ts +11 -0
  6. package/esm/node/delegate-extension.js +33 -0
  7. package/esm/node/directory-relocator.d.ts +49 -0
  8. package/esm/node/directory-relocator.js +267 -0
  9. package/esm/node/extension-providers.d.ts +16 -1
  10. package/esm/node/extension-providers.js +23 -3
  11. package/esm/node/index.d.ts +8 -0
  12. package/esm/node/index.js +8 -0
  13. package/esm/node/keep-awake.d.ts +8 -1
  14. package/esm/node/keep-awake.js +24 -3
  15. package/esm/node/message-page.d.ts +6 -1
  16. package/esm/node/message-page.js +50 -2
  17. package/esm/node/package-hosts.d.ts +8 -0
  18. package/esm/node/package-hosts.js +41 -0
  19. package/esm/node/package-webhooks.d.ts +26 -0
  20. package/esm/node/package-webhooks.js +101 -0
  21. package/esm/node/page-book.d.ts +48 -0
  22. package/esm/node/page-book.js +117 -0
  23. package/esm/node/relay-bridge.d.ts +2 -0
  24. package/esm/node/relay-bridge.js +35 -1
  25. package/esm/node/rooms-bridge.d.ts +13 -1
  26. package/esm/node/rooms-bridge.js +29 -0
  27. package/esm/node/screen-share/desktop-picture.d.ts +51 -0
  28. package/esm/node/screen-share/desktop-picture.js +133 -0
  29. package/esm/node/screen-share/desktop-session.d.ts +128 -0
  30. package/esm/node/screen-share/desktop-session.js +437 -0
  31. package/esm/node/screen-share/desktop-targets.d.ts +24 -0
  32. package/esm/node/screen-share/desktop-targets.js +80 -0
  33. package/esm/node/screen-share/desktop-viewer.d.ts +146 -0
  34. package/esm/node/screen-share/desktop-viewer.js +339 -0
  35. package/esm/node/screen-share/index.d.ts +8 -0
  36. package/esm/node/screen-share/index.js +9 -0
  37. package/esm/node/screen-share/rfb-client.d.ts +54 -0
  38. package/esm/node/screen-share/rfb-client.js +179 -0
  39. package/esm/node/screen-share/rfb-des.d.ts +11 -0
  40. package/esm/node/screen-share/rfb-des.js +143 -0
  41. package/esm/node/screen-share/rfb-encodings.d.ts +71 -0
  42. package/esm/node/screen-share/rfb-encodings.js +288 -0
  43. package/esm/node/screen-share/rfb-framebuffer.d.ts +16 -0
  44. package/esm/node/screen-share/rfb-framebuffer.js +53 -0
  45. package/esm/node/screen-share/rfb-protocol.d.ts +90 -0
  46. package/esm/node/screen-share/rfb-protocol.js +36 -0
  47. package/esm/node/screen-share/rfb-reader.d.ts +34 -0
  48. package/esm/node/screen-share/rfb-reader.js +110 -0
  49. package/esm/node/screen-share/rfb-security.d.ts +30 -0
  50. package/esm/node/screen-share/rfb-security.js +136 -0
  51. package/esm/node/screen-share/rfb-test-server.d.ts +37 -0
  52. package/esm/node/screen-share/rfb-test-server.js +116 -0
  53. package/esm/node/screen-share/screen-share-server-impl.d.ts +37 -0
  54. package/esm/node/screen-share/screen-share-server-impl.js +76 -0
  55. package/esm/node/screen-share/screen-shares.d.ts +123 -0
  56. package/esm/node/screen-share/screen-shares.js +463 -0
  57. package/esm/node/session-info-util.d.ts +10 -9
  58. package/esm/node/session-info-util.js +16 -68
  59. package/esm/node/settings-store.d.ts +1 -1
  60. package/esm/node/settings-store.js +7 -4
  61. package/esm/node/sign-in/access-store.d.ts +1 -1
  62. package/esm/node/sign-in/access-store.js +4 -1
  63. package/esm/node/sign-in/index.d.ts +2 -0
  64. package/esm/node/sign-in/index.js +2 -0
  65. package/esm/node/sign-in/polled-sign-in.d.ts +50 -0
  66. package/esm/node/sign-in/polled-sign-in.js +83 -0
  67. package/esm/node/sign-in/sign-in-devices.d.ts +55 -0
  68. package/esm/node/sign-in/sign-in-devices.js +113 -0
  69. package/esm/node/sign-in/sign-in-flow.d.ts +38 -4
  70. package/esm/node/sign-in/sign-in-flow.js +79 -4
  71. package/esm/node/sign-in/sign-in-pages.d.ts +8 -0
  72. package/esm/node/sign-in/sign-in-pages.js +137 -8
  73. package/esm/node/sign-in/sign-in-provider.d.ts +6 -0
  74. package/esm/node/sign-in/sign-in-provider.js +15 -0
  75. package/esm/node/sources-extension.d.ts +10 -0
  76. package/esm/node/sources-extension.js +18 -0
  77. package/esm/node/ta-server-impl.d.ts +5 -1
  78. package/esm/node/ta-server-impl.js +25 -3
  79. package/esm/node/ta-session-factory.d.ts +13 -1
  80. package/esm/node/ta-session-factory.js +41 -4
  81. package/esm/node/ta-session.d.ts +2 -0
  82. package/esm/node/ta-session.js +1 -0
  83. package/esm/node/team/team-calls.js +49 -0
  84. package/esm/node/voice-bridge.d.ts +70 -0
  85. package/esm/node/voice-bridge.js +280 -0
  86. package/esm/node/voices-file.d.ts +38 -0
  87. package/esm/node/voices-file.js +100 -0
  88. package/esm/node/working-directory.d.ts +8 -2
  89. package/esm/node/working-directory.js +7 -0
  90. package/lib/node/app-commands.d.ts +112 -0
  91. package/lib/node/app-commands.js +650 -0
  92. package/lib/node/credentials.d.ts +13 -0
  93. package/lib/node/credentials.js +38 -0
  94. package/lib/node/delegate-extension.d.ts +12 -0
  95. package/lib/node/delegate-extension.js +37 -0
  96. package/lib/node/directory-relocator.d.ts +50 -0
  97. package/lib/node/directory-relocator.js +270 -0
  98. package/lib/node/extension-providers.d.ts +16 -1
  99. package/lib/node/extension-providers.js +23 -3
  100. package/lib/node/index.d.ts +8 -0
  101. package/lib/node/index.js +8 -0
  102. package/lib/node/keep-awake.d.ts +8 -1
  103. package/lib/node/keep-awake.js +24 -3
  104. package/lib/node/message-page.d.ts +6 -1
  105. package/lib/node/message-page.js +50 -2
  106. package/lib/node/package-hosts.d.ts +8 -0
  107. package/lib/node/package-hosts.js +41 -0
  108. package/lib/node/package-webhooks.d.ts +27 -0
  109. package/lib/node/package-webhooks.js +104 -0
  110. package/lib/node/page-book.d.ts +49 -0
  111. package/lib/node/page-book.js +120 -0
  112. package/lib/node/relay-bridge.d.ts +2 -0
  113. package/lib/node/relay-bridge.js +34 -0
  114. package/lib/node/rooms-bridge.d.ts +13 -1
  115. package/lib/node/rooms-bridge.js +29 -0
  116. package/lib/node/screen-share/desktop-picture.d.ts +52 -0
  117. package/lib/node/screen-share/desktop-picture.js +136 -0
  118. package/lib/node/screen-share/desktop-session.d.ts +129 -0
  119. package/lib/node/screen-share/desktop-session.js +442 -0
  120. package/lib/node/screen-share/desktop-targets.d.ts +25 -0
  121. package/lib/node/screen-share/desktop-targets.js +84 -0
  122. package/lib/node/screen-share/desktop-viewer.d.ts +147 -0
  123. package/lib/node/screen-share/desktop-viewer.js +343 -0
  124. package/lib/node/screen-share/index.d.ts +9 -0
  125. package/lib/node/screen-share/index.js +25 -0
  126. package/lib/node/screen-share/rfb-client.d.ts +55 -0
  127. package/lib/node/screen-share/rfb-client.js +183 -0
  128. package/lib/node/screen-share/rfb-des.d.ts +12 -0
  129. package/lib/node/screen-share/rfb-des.js +146 -0
  130. package/lib/node/screen-share/rfb-encodings.d.ts +72 -0
  131. package/lib/node/screen-share/rfb-encodings.js +295 -0
  132. package/lib/node/screen-share/rfb-framebuffer.d.ts +17 -0
  133. package/lib/node/screen-share/rfb-framebuffer.js +57 -0
  134. package/lib/node/screen-share/rfb-protocol.d.ts +91 -0
  135. package/lib/node/screen-share/rfb-protocol.js +39 -0
  136. package/lib/node/screen-share/rfb-reader.d.ts +35 -0
  137. package/lib/node/screen-share/rfb-reader.js +115 -0
  138. package/lib/node/screen-share/rfb-security.d.ts +31 -0
  139. package/lib/node/screen-share/rfb-security.js +141 -0
  140. package/lib/node/screen-share/rfb-test-server.d.ts +38 -0
  141. package/lib/node/screen-share/rfb-test-server.js +120 -0
  142. package/lib/node/screen-share/screen-share-server-impl.d.ts +38 -0
  143. package/lib/node/screen-share/screen-share-server-impl.js +79 -0
  144. package/lib/node/screen-share/screen-shares.d.ts +124 -0
  145. package/lib/node/screen-share/screen-shares.js +464 -0
  146. package/lib/node/session-info-util.d.ts +10 -9
  147. package/lib/node/session-info-util.js +15 -67
  148. package/lib/node/settings-store.d.ts +1 -1
  149. package/lib/node/settings-store.js +6 -3
  150. package/lib/node/sign-in/access-store.d.ts +1 -1
  151. package/lib/node/sign-in/access-store.js +4 -1
  152. package/lib/node/sign-in/index.d.ts +2 -0
  153. package/lib/node/sign-in/index.js +2 -0
  154. package/lib/node/sign-in/polled-sign-in.d.ts +51 -0
  155. package/lib/node/sign-in/polled-sign-in.js +87 -0
  156. package/lib/node/sign-in/sign-in-devices.d.ts +56 -0
  157. package/lib/node/sign-in/sign-in-devices.js +117 -0
  158. package/lib/node/sign-in/sign-in-flow.d.ts +38 -4
  159. package/lib/node/sign-in/sign-in-flow.js +80 -5
  160. package/lib/node/sign-in/sign-in-pages.d.ts +8 -0
  161. package/lib/node/sign-in/sign-in-pages.js +136 -7
  162. package/lib/node/sign-in/sign-in-provider.d.ts +6 -0
  163. package/lib/node/sign-in/sign-in-provider.js +15 -0
  164. package/lib/node/sources-extension.d.ts +11 -0
  165. package/lib/node/sources-extension.js +22 -0
  166. package/lib/node/ta-server-impl.d.ts +5 -1
  167. package/lib/node/ta-server-impl.js +24 -2
  168. package/lib/node/ta-session-factory.d.ts +13 -1
  169. package/lib/node/ta-session-factory.js +40 -3
  170. package/lib/node/ta-session.d.ts +2 -0
  171. package/lib/node/ta-session.js +1 -0
  172. package/lib/node/team/team-calls.js +49 -0
  173. package/lib/node/voice-bridge.d.ts +71 -0
  174. package/lib/node/voice-bridge.js +281 -0
  175. package/lib/node/voices-file.d.ts +39 -0
  176. package/lib/node/voices-file.js +104 -0
  177. package/lib/node/working-directory.d.ts +8 -2
  178. package/lib/node/working-directory.js +7 -0
  179. package/package.json +14 -10
@@ -0,0 +1,141 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.RfbSecurity = exports.RfbAuthError = void 0;
4
+ const node_crypto_1 = require("node:crypto");
5
+ const rfb_des_1 = require("./rfb-des");
6
+ const rfb_protocol_1 = require("./rfb-protocol");
7
+ const rfb_reader_1 = require("./rfb-reader");
8
+ /** The server refused to let Ta in, with its reason. */
9
+ class RfbAuthError extends Error {
10
+ }
11
+ exports.RfbAuthError = RfbAuthError;
12
+ /**
13
+ * Signing in (RFC 6143 7.1.2, 7.2): the first security type of the server's list that Ta knows (None, VNC
14
+ * Authentication, Apple Remote Desktop), and the result.
15
+ */
16
+ class RfbSecurity {
17
+ constructor(reader, write, options) {
18
+ this.reader = reader;
19
+ this.write = write;
20
+ this.options = options;
21
+ }
22
+ /** Signs in with the minor version agreed (3, 7 or 8). */
23
+ async negotiate(minor) {
24
+ let type;
25
+ if (minor === 3) {
26
+ type = await this.reader.u32();
27
+ if (type === 0) {
28
+ throw new RfbAuthError(await this.reason());
29
+ }
30
+ }
31
+ else {
32
+ const count = await this.reader.u8();
33
+ if (count === 0) {
34
+ throw new RfbAuthError(await this.reason());
35
+ }
36
+ const offered = [...(await this.reader.read(count))];
37
+ // The first of the server's list that Ta knows: a server puts what it prefers first.
38
+ const known = offered.find(one => one === rfb_protocol_1.Rfb.Security.NONE || one === rfb_protocol_1.Rfb.Security.VNC || one === rfb_protocol_1.Rfb.Security.ARD);
39
+ if (known === undefined) {
40
+ throw new RfbAuthError(`The desktop offers ways of signing in Ta does not know (${offered.join(', ')}).`);
41
+ }
42
+ type = known;
43
+ this.write(Uint8Array.of(type));
44
+ }
45
+ switch (type) {
46
+ case rfb_protocol_1.Rfb.Security.NONE:
47
+ break;
48
+ case rfb_protocol_1.Rfb.Security.VNC:
49
+ await this.vnc();
50
+ break;
51
+ case rfb_protocol_1.Rfb.Security.ARD:
52
+ await this.ard();
53
+ break;
54
+ default:
55
+ throw new RfbAuthError(`The desktop asks for a way of signing in Ta does not know (${type}).`);
56
+ }
57
+ // 3.3 and 3.7 say nothing after None.
58
+ if (type !== rfb_protocol_1.Rfb.Security.NONE || minor >= 8) {
59
+ await this.result(minor);
60
+ }
61
+ }
62
+ async vnc() {
63
+ const challenge = await this.reader.read(16);
64
+ const { password } = await this.options.credentials({ username: false });
65
+ this.write(rfb_des_1.RfbDes.vncResponse(password, challenge));
66
+ }
67
+ /**
68
+ * Apple Remote Desktop (type 30), which the Screen Sharing of macOS offers: Diffie-Hellman with the server's
69
+ * generator and prime, MD5 of the shared secret as an AES-128 key, the account in 128 bytes encrypted with it.
70
+ */
71
+ async ard() {
72
+ const generator = BigInt(await this.reader.u16());
73
+ const length = await this.reader.u16();
74
+ if (length < 16 || length > 1024) {
75
+ throw new rfb_reader_1.RfbClosedError(`The desktop sent a key of ${length} bytes.`);
76
+ }
77
+ const prime = RfbSecurity.toBigInt(await this.reader.read(length));
78
+ const serverKey = RfbSecurity.toBigInt(await this.reader.read(length));
79
+ const secret = (RfbSecurity.toBigInt((0, node_crypto_1.randomBytes)(length)) % (prime - BigInt(2))) + BigInt(1);
80
+ const publicKey = RfbSecurity.power(generator, secret, prime);
81
+ const shared = RfbSecurity.power(serverKey, secret, prime);
82
+ const key = (0, node_crypto_1.createHash)('md5').update(RfbSecurity.toBytes(shared, length)).digest();
83
+ const { username = '', password } = await this.options.credentials({ username: true });
84
+ const plain = (0, node_crypto_1.randomBytes)(128);
85
+ RfbSecurity.field(plain, 0, username);
86
+ RfbSecurity.field(plain, 64, password);
87
+ const cipher = (0, node_crypto_1.createCipheriv)('aes-128-ecb', key, null);
88
+ cipher.setAutoPadding(false);
89
+ const encrypted = Buffer.concat([cipher.update(plain), cipher.final()]);
90
+ this.write(new Uint8Array(Buffer.concat([encrypted, RfbSecurity.toBytes(publicKey, length)])));
91
+ }
92
+ async result(minor) {
93
+ const status = await this.reader.u32();
94
+ if (status === 0) {
95
+ return;
96
+ }
97
+ throw new RfbAuthError(minor >= 8 ? await this.reason() : 'The desktop did not take the password.');
98
+ }
99
+ async reason() {
100
+ const length = await this.reader.u32();
101
+ if (length > rfb_protocol_1.Rfb.MAX_TEXT) {
102
+ throw new rfb_reader_1.RfbClosedError('The desktop sent a reason too long to read.');
103
+ }
104
+ return new TextDecoder().decode(await this.reader.read(length)) || 'The desktop did not let Ta in.';
105
+ }
106
+ /** A text of up to 63 bytes, ended by a zero, at `at` (the rest of its 64 bytes stays random). */
107
+ static field(into, at, text) {
108
+ const bytes = Buffer.from(text, 'utf8').subarray(0, 63);
109
+ bytes.copy(into, at);
110
+ into[at + bytes.length] = 0;
111
+ }
112
+ static toBigInt(bytes) {
113
+ let value = BigInt(0);
114
+ for (const byte of bytes) {
115
+ value = (value << BigInt(8)) | BigInt(byte);
116
+ }
117
+ return value;
118
+ }
119
+ static toBytes(value, length) {
120
+ const out = new Uint8Array(length);
121
+ for (let at = length - 1; at >= 0; at--) {
122
+ out[at] = Number(value & BigInt(255));
123
+ value >>= BigInt(8);
124
+ }
125
+ return out;
126
+ }
127
+ static power(base, exponent, modulus) {
128
+ let result = BigInt(1);
129
+ base %= modulus;
130
+ while (exponent > BigInt(0)) {
131
+ if (exponent & BigInt(1)) {
132
+ result = (result * base) % modulus;
133
+ }
134
+ base = (base * base) % modulus;
135
+ exponent >>= BigInt(1);
136
+ }
137
+ return result;
138
+ }
139
+ }
140
+ exports.RfbSecurity = RfbSecurity;
141
+ //# sourceMappingURL=rfb-security.js.map
@@ -0,0 +1,38 @@
1
+ import type { ExecSocket } from '@celljs/ta-exec';
2
+ import { RfbReader } from './rfb-reader';
3
+ /**
4
+ * A VNC server in memory, for the specs: it speaks to an RfbClient through a pair of sockets, reads what the client
5
+ * sends and writes what a test tells it to.
6
+ */
7
+ export declare class FakeRfbServer {
8
+ readonly socket: ExecSocket;
9
+ readonly reader: RfbReader;
10
+ readonly written: Uint8Array[];
11
+ protected toClient?: (data: Uint8Array) => void;
12
+ /** What was sent before the client listened: given to it once it does. */
13
+ protected early: Uint8Array[];
14
+ protected closeClient?: () => void;
15
+ protected readonly deflate: import("zlib").Deflate;
16
+ protected deflated: Buffer[];
17
+ constructor();
18
+ send(...parts: (Uint8Array | number[])[]): void;
19
+ hangUp(): void;
20
+ /** The version, security of `types` (3.8), and the answer to the client's choice. */
21
+ greet(types: number[], minor?: number): Promise<number>;
22
+ /** ServerInit, then reads SetPixelFormat and SetEncodings. */
23
+ init(width: number, height: number, name?: string): Promise<number[]>;
24
+ /** The next FramebufferUpdateRequest: whether it is incremental. */
25
+ request(): Promise<boolean>;
26
+ /** A FramebufferUpdate of rectangles, each its header and body. */
27
+ update(rects: {
28
+ x: number;
29
+ y: number;
30
+ w: number;
31
+ h: number;
32
+ encoding: number;
33
+ body: Uint8Array | number[];
34
+ }[]): void;
35
+ /** Bytes of ZRLE through one zlib stream for the whole connection, as a server keeps it: length and data. */
36
+ zrle(plain: number[]): Promise<Uint8Array>;
37
+ }
38
+ //# sourceMappingURL=rfb-test-server.d.ts.map
@@ -0,0 +1,120 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.FakeRfbServer = void 0;
4
+ const node_zlib_1 = require("node:zlib");
5
+ const rfb_protocol_1 = require("./rfb-protocol");
6
+ const rfb_reader_1 = require("./rfb-reader");
7
+ /**
8
+ * A VNC server in memory, for the specs: it speaks to an RfbClient through a pair of sockets, reads what the client
9
+ * sends and writes what a test tells it to.
10
+ */
11
+ class FakeRfbServer {
12
+ constructor() {
13
+ this.written = [];
14
+ /** What was sent before the client listened: given to it once it does. */
15
+ this.early = [];
16
+ this.deflate = (0, node_zlib_1.createDeflate)();
17
+ this.deflated = [];
18
+ const fromClient = {};
19
+ this.reader = new rfb_reader_1.RfbReader({
20
+ onData: listener => {
21
+ fromClient.data = listener;
22
+ },
23
+ onClose: listener => {
24
+ fromClient.close = listener;
25
+ },
26
+ });
27
+ this.socket = {
28
+ write: bytes => {
29
+ var _a;
30
+ this.written.push(bytes);
31
+ (_a = fromClient.data) === null || _a === void 0 ? void 0 : _a.call(fromClient, bytes);
32
+ },
33
+ end: () => {
34
+ var _a, _b;
35
+ (_a = fromClient.close) === null || _a === void 0 ? void 0 : _a.call(fromClient);
36
+ (_b = this.closeClient) === null || _b === void 0 ? void 0 : _b.call(this);
37
+ },
38
+ onData: listener => {
39
+ this.toClient = listener;
40
+ for (const bytes of this.early.splice(0)) {
41
+ listener(bytes);
42
+ }
43
+ },
44
+ onClose: listener => {
45
+ this.closeClient = listener;
46
+ },
47
+ };
48
+ this.deflate.on('data', chunk => this.deflated.push(chunk));
49
+ }
50
+ send(...parts) {
51
+ for (const part of parts) {
52
+ const bytes = part instanceof Uint8Array ? part : Uint8Array.from(part);
53
+ if (this.toClient) {
54
+ this.toClient(bytes);
55
+ }
56
+ else {
57
+ this.early.push(bytes);
58
+ }
59
+ }
60
+ }
61
+ hangUp() {
62
+ var _a;
63
+ (_a = this.closeClient) === null || _a === void 0 ? void 0 : _a.call(this);
64
+ }
65
+ /** The version, security of `types` (3.8), and the answer to the client's choice. */
66
+ async greet(types, minor = 8) {
67
+ this.send(new TextEncoder().encode(`RFB 003.00${minor}\n`));
68
+ const version = new TextDecoder().decode(await this.reader.read(12));
69
+ if (version !== `RFB 003.00${minor}\n`) {
70
+ throw new Error(`The client answered ${version}.`);
71
+ }
72
+ if (minor === 3) {
73
+ this.send(rfb_reader_1.RfbBytes.u32(types[0]));
74
+ return types[0];
75
+ }
76
+ this.send([types.length, ...types]);
77
+ return this.reader.u8();
78
+ }
79
+ /** ServerInit, then reads SetPixelFormat and SetEncodings. */
80
+ async init(width, height, name = 'fake') {
81
+ const shared = await this.reader.u8();
82
+ const nameBytes = new TextEncoder().encode(name);
83
+ this.send([...rfb_reader_1.RfbBytes.u16(width), ...rfb_reader_1.RfbBytes.u16(height), ...rfb_protocol_1.Rfb.PIXEL_FORMAT, ...rfb_reader_1.RfbBytes.u32(nameBytes.length)], nameBytes);
84
+ await this.reader.read(20);
85
+ await this.reader.read(2);
86
+ const count = await this.reader.u16();
87
+ const encodings = [];
88
+ for (let index = 0; index < count; index++) {
89
+ encodings.push(await this.reader.s32());
90
+ }
91
+ return [shared, ...encodings];
92
+ }
93
+ /** The next FramebufferUpdateRequest: whether it is incremental. */
94
+ async request() {
95
+ const type = await this.reader.u8();
96
+ if (type !== rfb_protocol_1.Rfb.ClientMessage.UPDATE_REQUEST) {
97
+ throw new Error(`The client sent ${type}, not a request.`);
98
+ }
99
+ const incremental = (await this.reader.u8()) === 1;
100
+ await this.reader.read(8);
101
+ return incremental;
102
+ }
103
+ /** A FramebufferUpdate of rectangles, each its header and body. */
104
+ update(rects) {
105
+ this.send([rfb_protocol_1.Rfb.ServerMessage.FRAMEBUFFER_UPDATE, 0, ...rfb_reader_1.RfbBytes.u16(rects.length)]);
106
+ for (const rect of rects) {
107
+ this.send([...rfb_reader_1.RfbBytes.u16(rect.x), ...rfb_reader_1.RfbBytes.u16(rect.y), ...rfb_reader_1.RfbBytes.u16(rect.w), ...rfb_reader_1.RfbBytes.u16(rect.h), ...rfb_reader_1.RfbBytes.s32(rect.encoding)], rect.body);
108
+ }
109
+ }
110
+ /** Bytes of ZRLE through one zlib stream for the whole connection, as a server keeps it: length and data. */
111
+ async zrle(plain) {
112
+ this.deflated = [];
113
+ this.deflate.write(Buffer.from(plain));
114
+ await new Promise(resolve => this.deflate.flush(node_zlib_1.constants.Z_SYNC_FLUSH, () => resolve()));
115
+ const data = Buffer.concat(this.deflated);
116
+ return Uint8Array.from([...rfb_reader_1.RfbBytes.u32(data.length), ...data]);
117
+ }
118
+ }
119
+ exports.FakeRfbServer = FakeRfbServer;
120
+ //# sourceMappingURL=rfb-test-server.js.map
@@ -0,0 +1,38 @@
1
+ import { type TaDesktopControl, type TaDesktopFrames, type TaDesktopInfo, type TaDesktopInput, type TaDesktopPrompt, type TaDesktopScreen, type TaDesktopSignIn, type TaDesktopTarget, type TaDesktopView, type TaDesktopViewer, TaScreenShareServer } from '@celljs/ta-protocol';
2
+ import { ScreenShares } from './screen-shares';
3
+ /** The remote desktops for pages (docs/design/ta-desktop-remote.md 5), each viewer of the connection that opened it. */
4
+ export declare class TaScreenShareServerImpl implements TaScreenShareServer {
5
+ protected readonly desktops: ScreenShares;
6
+ listDesktops(): Promise<TaDesktopInfo[]>;
7
+ listDesktopScreens(target: TaDesktopTarget): Promise<TaDesktopScreen[]>;
8
+ addDesktop(target: TaDesktopTarget): Promise<TaDesktopInfo>;
9
+ removeDesktop(desktopId: string): Promise<void>;
10
+ openDesktop(options: {
11
+ target: TaDesktopTarget;
12
+ view: TaDesktopView;
13
+ clientMessageId: string;
14
+ device?: string;
15
+ }): Promise<TaDesktopViewer>;
16
+ closeDesktop(viewerId: string): Promise<void>;
17
+ readDesktopFrames(viewerId: string, want: number): Promise<TaDesktopFrames>;
18
+ setDesktopView(viewerId: string, view: TaDesktopView): Promise<void>;
19
+ sendDesktopInput(viewerId: string, batch: {
20
+ seq: number;
21
+ events: TaDesktopInput[];
22
+ }): Promise<void>;
23
+ pasteToDesktop(viewerId: string, input: {
24
+ text: string;
25
+ press?: boolean;
26
+ clientMessageId: string;
27
+ }): Promise<void>;
28
+ readDesktopClipboard(): Promise<string | undefined>;
29
+ takeDesktopControl(viewerId: string): Promise<{
30
+ control: TaDesktopControl | null;
31
+ asked: boolean;
32
+ }>;
33
+ releaseDesktopControl(viewerId: string): Promise<void>;
34
+ endAllDesktops(): Promise<void>;
35
+ watchDesktops(): Promise<TaDesktopPrompt[]>;
36
+ answerDesktop(promptId: string, answer: TaDesktopSignIn | null, remember?: boolean): Promise<boolean>;
37
+ }
38
+ //# sourceMappingURL=screen-share-server-impl.d.ts.map
@@ -0,0 +1,79 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.TaScreenShareServerImpl = void 0;
13
+ const core_1 = require("@celljs/core");
14
+ const rpc_1 = require("@celljs/rpc");
15
+ const node_1 = require("@celljs/rpc/lib/node");
16
+ const ta_protocol_1 = require("@celljs/ta-protocol");
17
+ const ta_errors_1 = require("../ta-errors");
18
+ const screen_shares_1 = require("./screen-shares");
19
+ /** The remote desktops for pages (docs/design/ta-desktop-remote.md 5), each viewer of the connection that opened it. */
20
+ let TaScreenShareServerImpl = class TaScreenShareServerImpl {
21
+ listDesktops() {
22
+ return ta_errors_1.TaErrors.guard(() => this.desktops.list(node_1.RpcContext.requireConnection()));
23
+ }
24
+ listDesktopScreens(target) {
25
+ return ta_errors_1.TaErrors.guard(() => this.desktops.screens(target));
26
+ }
27
+ addDesktop(target) {
28
+ return ta_errors_1.TaErrors.guard(() => this.desktops.add(target));
29
+ }
30
+ removeDesktop(desktopId) {
31
+ return ta_errors_1.TaErrors.guard(() => this.desktops.remove(desktopId));
32
+ }
33
+ openDesktop(options) {
34
+ return ta_errors_1.TaErrors.guard(() => this.desktops.open(node_1.RpcContext.requireConnection(), options));
35
+ }
36
+ closeDesktop(viewerId) {
37
+ return ta_errors_1.TaErrors.guard(() => this.desktops.close(node_1.RpcContext.requireConnection(), viewerId));
38
+ }
39
+ readDesktopFrames(viewerId, want) {
40
+ return ta_errors_1.TaErrors.guard(() => this.desktops.read(node_1.RpcContext.requireConnection(), viewerId, want));
41
+ }
42
+ setDesktopView(viewerId, view) {
43
+ return ta_errors_1.TaErrors.guard(() => this.desktops.setView(node_1.RpcContext.requireConnection(), viewerId, view));
44
+ }
45
+ sendDesktopInput(viewerId, batch) {
46
+ return ta_errors_1.TaErrors.guard(() => this.desktops.input(node_1.RpcContext.requireConnection(), viewerId, batch));
47
+ }
48
+ pasteToDesktop(viewerId, input) {
49
+ return ta_errors_1.TaErrors.guard(() => this.desktops.paste(node_1.RpcContext.requireConnection(), viewerId, input));
50
+ }
51
+ async readDesktopClipboard() {
52
+ // The clipboard of a desktop is read from the second stage (docs/design/ta-desktop-remote.md 3.4).
53
+ return undefined;
54
+ }
55
+ takeDesktopControl(viewerId) {
56
+ return ta_errors_1.TaErrors.guard(() => this.desktops.take(node_1.RpcContext.requireConnection(), viewerId));
57
+ }
58
+ releaseDesktopControl(viewerId) {
59
+ return ta_errors_1.TaErrors.guard(() => this.desktops.release(node_1.RpcContext.requireConnection(), viewerId));
60
+ }
61
+ endAllDesktops() {
62
+ return ta_errors_1.TaErrors.guard(() => this.desktops.endAll());
63
+ }
64
+ async watchDesktops() {
65
+ return this.desktops.watch(node_1.RpcContext.requireConnection());
66
+ }
67
+ async answerDesktop(promptId, answer, remember) {
68
+ return this.desktops.answer(promptId, answer !== null && answer !== void 0 ? answer : null, remember === true);
69
+ }
70
+ };
71
+ exports.TaScreenShareServerImpl = TaScreenShareServerImpl;
72
+ __decorate([
73
+ (0, core_1.Autowired)(screen_shares_1.ScreenShares),
74
+ __metadata("design:type", screen_shares_1.ScreenShares)
75
+ ], TaScreenShareServerImpl.prototype, "desktops", void 0);
76
+ exports.TaScreenShareServerImpl = TaScreenShareServerImpl = __decorate([
77
+ (0, rpc_1.Rpc)(ta_protocol_1.TaScreenShareServer)
78
+ ], TaScreenShareServerImpl);
79
+ //# sourceMappingURL=screen-share-server-impl.js.map
@@ -0,0 +1,124 @@
1
+ import type { RpcConnection } from '@celljs/rpc/lib/node';
2
+ import { ExecEnvironmentFactory, type ExecSocket } from '@celljs/ta-exec';
3
+ import { type TaDesktopControl, type TaDesktopEvent, type TaDesktopFrames, type TaDesktopInfo, type TaDesktopInput, type TaDesktopPrompt, type TaDesktopScreen, type TaDesktopSignIn, type TaDesktopTarget, type TaDesktopView, type TaDesktopViewer } from '@celljs/ta-protocol';
4
+ import { TaCredentials } from '../credentials';
5
+ import { RemoteHosts } from '../remote/remote-protocol';
6
+ import { TaPrincipals } from '../team/team-protocol';
7
+ import { TaWorkingDirectory } from '../working-directory';
8
+ import { DesktopSession } from './desktop-session';
9
+ import { DesktopTargets } from './desktop-targets';
10
+ import { DesktopViewer } from './desktop-viewer';
11
+ import type { RfbCredentials } from './rfb-protocol';
12
+ interface Waiting {
13
+ prompt: TaDesktopPrompt;
14
+ settle(answer: TaDesktopSignIn | undefined, remember?: boolean): void;
15
+ }
16
+ /** What a desktop signs in with now: kept or forgotten once it tells whether it took it. */
17
+ interface Signing {
18
+ credential: RfbCredentials;
19
+ /** It came from the store. */
20
+ kept: boolean;
21
+ /** The user asked to keep it. */
22
+ remember: boolean;
23
+ }
24
+ interface Entry {
25
+ viewer: DesktopViewer;
26
+ session: DesktopSession;
27
+ orphan?: ReturnType<typeof setTimeout>;
28
+ }
29
+ /**
30
+ * The desktops ta serve shows and works for the owner's pages (docs/design/ta-desktop-remote.md): which there are,
31
+ * one DesktopSession for each one looked at, the viewers of the pages, and what a connection asks of whoever is there.
32
+ * Its connections go through the ExecEnvironment of the machine of the desktop, never a socket to a machine of its own
33
+ * choosing; only the desktops of the list are ever reached. In the first stage every call is the owner's
34
+ * (team-calls.ts), so there is no one else to check here.
35
+ */
36
+ export declare class ScreenShares {
37
+ protected readonly environments: ExecEnvironmentFactory;
38
+ protected readonly hosts: RemoteHosts;
39
+ protected readonly workingDirectory: TaWorkingDirectory;
40
+ protected readonly principals: TaPrincipals;
41
+ protected readonly credentialStores: TaCredentials;
42
+ protected readonly sessions: Map<string, DesktopSession>;
43
+ protected readonly viewers: Map<string, Entry>;
44
+ protected readonly waiting: Map<string, Waiting>;
45
+ protected readonly watchers: Set<RpcConnection>;
46
+ protected readonly closing: WeakSet<RpcConnection>;
47
+ protected readonly signing: Map<string, Signing>;
48
+ /** Desktops that refused the sign-in kept for them: asked again until one is taken. */
49
+ protected readonly refused: Set<string>;
50
+ /** The account each desktop was signed in to last, put in the form next time. */
51
+ protected readonly users: Map<string, string>;
52
+ protected targetsOf?: DesktopTargets;
53
+ protected get targets(): DesktopTargets;
54
+ list(connection?: RpcConnection): TaDesktopInfo[];
55
+ add(target: TaDesktopTarget): TaDesktopInfo;
56
+ remove(desktopId: string): void;
57
+ open(connection: RpcConnection, options: {
58
+ target: TaDesktopTarget;
59
+ view: TaDesktopView;
60
+ clientMessageId: string;
61
+ device?: string;
62
+ }): TaDesktopViewer;
63
+ close(connection: RpcConnection, viewerId: string): void;
64
+ read(connection: RpcConnection, viewerId: string, want: number): Promise<TaDesktopFrames>;
65
+ setView(connection: RpcConnection, viewerId: string, view: TaDesktopView): void;
66
+ input(connection: RpcConnection, viewerId: string, batch: {
67
+ seq: number;
68
+ events: TaDesktopInput[];
69
+ }): void;
70
+ paste(connection: RpcConnection, viewerId: string, input: {
71
+ text: string;
72
+ press?: boolean;
73
+ clientMessageId: string;
74
+ }): void;
75
+ take(connection: RpcConnection, viewerId: string): {
76
+ control: TaDesktopControl | null;
77
+ asked: boolean;
78
+ };
79
+ release(connection: RpcConnection, viewerId: string): void;
80
+ /** Ends every viewer of every desktop, and their connections. */
81
+ endAll(): void;
82
+ /** The screens of a desktop: connecting to it for a while when no page does. */
83
+ screens(target: TaDesktopTarget): Promise<TaDesktopScreen[]>;
84
+ watch(connection: RpcConnection): TaDesktopPrompt[];
85
+ answer(promptId: string, answer: TaDesktopSignIn | null, remember?: boolean): boolean;
86
+ /** Whether anyone looks at a desktop now: the computer stays awake meanwhile. */
87
+ get watched(): boolean;
88
+ dispose(): void;
89
+ protected find(target: TaDesktopTarget | undefined): TaDesktopInfo;
90
+ protected connect(target: TaDesktopTarget): Promise<ExecSocket>;
91
+ static connectHere(port: number, host: string): Promise<ExecSocket>;
92
+ /**
93
+ * The account of the Screen Sharing of macOS, or the password of VNC: the one kept for the desktop, unless it
94
+ * refused it; else asked of every page of the owner in one form, who may have it kept.
95
+ */
96
+ protected credentials(info: TaDesktopInfo, need: {
97
+ username: boolean;
98
+ refused?: boolean;
99
+ }): Promise<RfbCredentials | undefined>;
100
+ /** A desktop took the sign-in or refused it: one the user asked to keep is kept now, a kept one refused is asked again. */
101
+ protected signedIn(info: TaDesktopInfo, taken: boolean): void;
102
+ protected ask(prompt: TaDesktopPrompt): Promise<{
103
+ answer?: TaDesktopSignIn;
104
+ remember: boolean;
105
+ }>;
106
+ protected broadcast(event: TaDesktopEvent): void;
107
+ protected entryOf(connection: RpcConnection, viewerId: string): Entry | undefined;
108
+ protected require(connection: RpcConnection, viewerId: string): Entry;
109
+ /** A viewer belongs to the connection that calls for it last; when that one drops, it waits ORPHAN_MS for the page. */
110
+ protected adopt(entry: Entry, connection: RpcConnection): void;
111
+ protected drop(viewerId: string): void;
112
+ protected viewerOf(entry: Entry): TaDesktopViewer;
113
+ protected described(info: TaDesktopInfo, connection?: RpcConnection): TaDesktopInfo;
114
+ protected nameOf(principal: string): string;
115
+ /** What a page answered, checked: a password, and an account when one came. */
116
+ static signInOf(answer: unknown): TaDesktopSignIn | undefined;
117
+ /** The account of whoever runs ta serve: the one to sign in to this computer with. */
118
+ static localUser(): string | undefined;
119
+ /** The id of the sign-in of a desktop in the store. */
120
+ static credentialId(desktopId: string): string;
121
+ protected static device(device: unknown): string;
122
+ }
123
+ export {};
124
+ //# sourceMappingURL=screen-shares.d.ts.map