@ac-kit/net-webrtc 0.0.0-stage → 0.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 +35 -0
- package/LICENSE +28 -0
- package/README.md +99 -2
- package/dist/_ice-servers.d.ts +15 -0
- package/dist/_ice-servers.d.ts.map +1 -0
- package/dist/_ice-servers.js +33 -0
- package/dist/_ice-servers.js.map +1 -0
- package/dist/_mdns.d.ts +53 -0
- package/dist/_mdns.d.ts.map +1 -0
- package/dist/_mdns.js +239 -0
- package/dist/_mdns.js.map +1 -0
- package/dist/_native.d.ts +82 -0
- package/dist/_native.d.ts.map +1 -0
- package/dist/_native.js +51 -0
- package/dist/_native.js.map +1 -0
- package/dist/_peer-connection-driver.d.ts +95 -0
- package/dist/_peer-connection-driver.d.ts.map +1 -0
- package/dist/_peer-connection-driver.js +500 -0
- package/dist/_peer-connection-driver.js.map +1 -0
- package/dist/_stun.d.ts +28 -0
- package/dist/_stun.d.ts.map +1 -0
- package/dist/_stun.js +115 -0
- package/dist/_stun.js.map +1 -0
- package/dist/dtls-fingerprint.d.ts +18 -0
- package/dist/dtls-fingerprint.d.ts.map +1 -0
- package/dist/dtls-fingerprint.js +25 -0
- package/dist/dtls-fingerprint.js.map +1 -0
- package/dist/errors.d.ts +27 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +42 -0
- package/dist/errors.js.map +1 -0
- package/dist/index.d.ts +5 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5 -0
- package/dist/index.js.map +1 -0
- package/dist/webrtc-data-channel.d.ts +80 -0
- package/dist/webrtc-data-channel.d.ts.map +1 -0
- package/dist/webrtc-data-channel.js +138 -0
- package/dist/webrtc-data-channel.js.map +1 -0
- package/dist/webrtc-peer-connection.d.ts +205 -0
- package/dist/webrtc-peer-connection.d.ts.map +1 -0
- package/dist/webrtc-peer-connection.js +324 -0
- package/dist/webrtc-peer-connection.js.map +1 -0
- package/package.json +75 -3
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# @ac-kit/net-webrtc
|
|
2
|
+
|
|
3
|
+
## 0.1.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- a484936: `@ac-kit/net-webrtc`: WebRTC data channels for Node.js, interoperable with
|
|
8
|
+
Chromium, Firefox and Safari's WebKit.
|
|
9
|
+
|
|
10
|
+
- `WebRtcPeerConnection`, with browser-shaped descriptions and candidates:
|
|
11
|
+
`setLocalDescription`, `setRemoteDescription`, `addIceCandidate`, trickled
|
|
12
|
+
`candidate` events, connection, ICE, gathering and signalling states,
|
|
13
|
+
`connected()`, and closing through `close()` or an `AbortSignal`.
|
|
14
|
+
- `WebRtcDataChannel`: reliable or partially reliable (`ordered`,
|
|
15
|
+
`maxRetransmits`, `maxPacketLifeTime`), binary and text messages,
|
|
16
|
+
`bufferedAmount` and `bufferedAmountLow` for pacing.
|
|
17
|
+
- Host candidates on every local IPv4 address, server-reflexive ones from
|
|
18
|
+
`stun:` servers, and browsers' `.local` (mDNS) candidates resolved by
|
|
19
|
+
multicast DNS. A `turn:` URL throws `WebRtcTurnUnsupportedError`.
|
|
20
|
+
- `localFingerprints`, `remoteFingerprints` and `parseSdpFingerprints`, to check
|
|
21
|
+
the DTLS certificates against a trusted channel.
|
|
22
|
+
- ICE, DTLS and SCTP run in webrtc-rs's sans-I/O `rtc`, a native binding
|
|
23
|
+
prebuilt per platform (`@ac-kit/net-webrtc-<platform>`, optional
|
|
24
|
+
dependencies); the UDP sockets and the timer are the JavaScript side's.
|
|
25
|
+
|
|
26
|
+
### Patch Changes
|
|
27
|
+
|
|
28
|
+
- Updated dependencies [99ca4b9]
|
|
29
|
+
- Updated dependencies [99ca4b9]
|
|
30
|
+
- Updated dependencies [99ca4b9]
|
|
31
|
+
- Updated dependencies [99ca4b9]
|
|
32
|
+
- @ac-kit/async@0.4.0
|
|
33
|
+
- @ac-kit/core@0.8.0
|
|
34
|
+
- @ac-kit/net-address@0.4.0
|
|
35
|
+
- @ac-kit/node@0.8.0
|
package/LICENSE
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
BSD 3-Clause License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2024-2026 Anthony Champagne and contributors
|
|
4
|
+
|
|
5
|
+
Redistribution and use in source and binary forms, with or without
|
|
6
|
+
modification, are permitted provided that the following conditions are met:
|
|
7
|
+
|
|
8
|
+
1. Redistributions of source code must retain the above copyright notice, this
|
|
9
|
+
list of conditions and the following disclaimer.
|
|
10
|
+
|
|
11
|
+
2. Redistributions in binary form must reproduce the above copyright notice,
|
|
12
|
+
this list of conditions and the following disclaimer in the documentation
|
|
13
|
+
and/or other materials provided with the distribution.
|
|
14
|
+
|
|
15
|
+
3. Neither the name of the copyright holder nor the names of its
|
|
16
|
+
contributors may be used to endorse or promote products derived from
|
|
17
|
+
this software without specific prior written permission.
|
|
18
|
+
|
|
19
|
+
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
20
|
+
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
21
|
+
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
22
|
+
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
|
23
|
+
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
24
|
+
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
25
|
+
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
|
26
|
+
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
27
|
+
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
28
|
+
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,100 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @ac-kit/net-webrtc
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
WebRTC data channels for Node.js: a peer connection that browsers can talk to,
|
|
4
|
+
carrying reliable and partially reliable message channels. No audio or video.
|
|
5
|
+
|
|
6
|
+
ICE, DTLS and SCTP are webrtc-rs's [`rtc`](https://github.com/webrtc-rs/rtc)
|
|
7
|
+
state machine, compiled into a native addon. It performs no I/O: the
|
|
8
|
+
connection owns its UDP sockets and its timer on the JavaScript thread, as
|
|
9
|
+
`@ac-kit/net-quic` does.
|
|
10
|
+
|
|
11
|
+
Signalling is the caller's. Descriptions and candidates have the browser's
|
|
12
|
+
shapes (`RTCSessionDescriptionInit`, `RTCIceCandidateInit`), so they travel
|
|
13
|
+
unchanged between a page and Node.
|
|
14
|
+
|
|
15
|
+
```ts
|
|
16
|
+
import { WebRtcPeerConnection } from "@ac-kit/net-webrtc";
|
|
17
|
+
|
|
18
|
+
const connection = new WebRtcPeerConnection({
|
|
19
|
+
iceServers: ["stun:stun.example.org:3478"],
|
|
20
|
+
});
|
|
21
|
+
connection.subscribe("candidate", (candidate) => signal({ candidate }));
|
|
22
|
+
|
|
23
|
+
const control = connection.createDataChannel("control");
|
|
24
|
+
const state = connection.createDataChannel("state", {
|
|
25
|
+
ordered: false,
|
|
26
|
+
maxRetransmits: 0,
|
|
27
|
+
});
|
|
28
|
+
control.subscribe("message", (data) => {
|
|
29
|
+
// `Uint8Array` for a binary message, `string` for a text one.
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
signal({ description: connection.setLocalDescription() });
|
|
33
|
+
// …then, from the peer:
|
|
34
|
+
connection.setRemoteDescription(answer);
|
|
35
|
+
connection.addIceCandidate(remoteCandidate);
|
|
36
|
+
|
|
37
|
+
await connection.connected();
|
|
38
|
+
control.send("hello");
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
A channel the peer opens arrives as a `dataChannel` event. `close()` closes
|
|
42
|
+
every channel, then the connection; an `AbortSignal` passed as `signal` does
|
|
43
|
+
the same.
|
|
44
|
+
|
|
45
|
+
## Candidates
|
|
46
|
+
|
|
47
|
+
Gathering starts with `setLocalDescription`. Each local address gets a host
|
|
48
|
+
candidate: `bindAddress` alone when given, otherwise every non-internal IPv4
|
|
49
|
+
address of the machine, each on its own UDP socket. Each `stun:` server in
|
|
50
|
+
`iceServers` then adds a server-reflexive candidate per socket, when it
|
|
51
|
+
answers within three seconds. `gatheringStateChange` reports `complete` once
|
|
52
|
+
every server has answered or given up.
|
|
53
|
+
|
|
54
|
+
TURN is not supported yet: a `turn:` or `turns:` URL throws
|
|
55
|
+
`WebRtcTurnUnsupportedError` from the constructor, so a configuration that
|
|
56
|
+
relies on a relay fails where it is written rather than silently connecting
|
|
57
|
+
less often. `stuns:` throws `UnsupportedError`.
|
|
58
|
+
|
|
59
|
+
Browsers hide their local addresses behind `.local` names (mDNS). A remote
|
|
60
|
+
candidate carrying one is added once a multicast DNS query resolves it, and
|
|
61
|
+
dropped if nothing answers within three seconds, as a browser drops it. The
|
|
62
|
+
query is sent from port 5353, shared with the system's own responder, because
|
|
63
|
+
browsers answer by multicast only. A dropped candidate often costs nothing:
|
|
64
|
+
the browser's own connectivity checks still reach this side, which learns
|
|
65
|
+
their address from them.
|
|
66
|
+
|
|
67
|
+
## Authenticating the peer
|
|
68
|
+
|
|
69
|
+
WebRTC authenticates nothing by itself: each side checks the DTLS handshake
|
|
70
|
+
against the certificate fingerprint in the other's description, and whoever
|
|
71
|
+
relays the descriptions can substitute both. `localFingerprints()` and
|
|
72
|
+
`remoteFingerprints()` read them out of the descriptions, to be compared with
|
|
73
|
+
a copy obtained over a channel the application trusts.
|
|
74
|
+
|
|
75
|
+
## Limits
|
|
76
|
+
|
|
77
|
+
- `maxMessageSize` is 64 KiB by default (RFC 8841) and 256 KiB at most.
|
|
78
|
+
- `send` never blocks: `bufferedAmount` counts the bytes not yet acknowledged
|
|
79
|
+
by the peer, and `bufferedAmountLow` fires when it falls to
|
|
80
|
+
`bufferedAmountLowThreshold`. Pace a bulk sender on it.
|
|
81
|
+
- A channel the peer opened reports `maxRetransmits` and `maxPacketLifeTime`
|
|
82
|
+
as `null`, whatever it was opened with: `rtc` does not expose them. The
|
|
83
|
+
channel still behaves as the peer asked.
|
|
84
|
+
- IPv6 is used only when `bindAddress` is an IPv6 address or `"::"`.
|
|
85
|
+
|
|
86
|
+
## Platforms
|
|
87
|
+
|
|
88
|
+
The binding is prebuilt for `linux-x64-gnu` and `linux-arm64-gnu` (glibc 2.28
|
|
89
|
+
and later), `darwin-x64`, `darwin-arm64` and `win32-x64-msvc`, each in its own
|
|
90
|
+
package, `@ac-kit/net-webrtc-<platform>`: an optional dependency the package
|
|
91
|
+
manager installs only on the platform it runs on. A package manager told to
|
|
92
|
+
skip optional dependencies (`--no-optional`, `--omit=optional`) leaves the
|
|
93
|
+
binding out.
|
|
94
|
+
|
|
95
|
+
It is loaded on first use: importing the package never fails, but creating a
|
|
96
|
+
connection without the binding throws `UnsupportedError`.
|
|
97
|
+
|
|
98
|
+
See the
|
|
99
|
+
[generated API docs](https://anthochamp.pages.grenadine.io/node-essentials/api/net-webrtc/)
|
|
100
|
+
for the full reference.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/** A STUN server to learn server-reflexive addresses from. */
|
|
2
|
+
export type StunServer_ = {
|
|
3
|
+
/** A host name or an IP address, without brackets. */
|
|
4
|
+
readonly host: string;
|
|
5
|
+
readonly port: number;
|
|
6
|
+
};
|
|
7
|
+
/**
|
|
8
|
+
* Parses `iceServers` into the STUN servers to query (RFC 7064 `stun:` URIs).
|
|
9
|
+
*
|
|
10
|
+
* @throws {WebRtcTurnUnsupportedError} For a `turn:` or `turns:` URI.
|
|
11
|
+
* @throws {UnsupportedError} For a `stuns:` URI: STUN over TLS needs TCP.
|
|
12
|
+
* @throws {RangeError} For anything else that is not a `stun:` URI.
|
|
13
|
+
*/
|
|
14
|
+
export declare function parseIceServers_(urls: readonly string[]): StunServer_[];
|
|
15
|
+
//# sourceMappingURL=_ice-servers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_ice-servers.d.ts","sourceRoot":"","sources":["../src/_ice-servers.ts"],"names":[],"mappings":"AAIA,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GAAG;IACzB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB,CAAC;AAQF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,EAAE,CAmBvE"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { UnsupportedError } from "@ac-kit/core";
|
|
2
|
+
import { WebRtcTurnUnsupportedError } from "./errors.js";
|
|
3
|
+
/** RFC 8489 §9: STUN's default port over UDP. */
|
|
4
|
+
const DEFAULT_STUN_PORT_ = 3478;
|
|
5
|
+
const STUN_URI_ = /^stun:(?:\[([0-9A-Fa-f:.]+)\]|([^\s:/?#[\]@]+))(?::(\d{1,5}))?$/;
|
|
6
|
+
/**
|
|
7
|
+
* Parses `iceServers` into the STUN servers to query (RFC 7064 `stun:` URIs).
|
|
8
|
+
*
|
|
9
|
+
* @throws {WebRtcTurnUnsupportedError} For a `turn:` or `turns:` URI.
|
|
10
|
+
* @throws {UnsupportedError} For a `stuns:` URI: STUN over TLS needs TCP.
|
|
11
|
+
* @throws {RangeError} For anything else that is not a `stun:` URI.
|
|
12
|
+
*/
|
|
13
|
+
export function parseIceServers_(urls) {
|
|
14
|
+
return urls.map((url) => {
|
|
15
|
+
const scheme = url.slice(0, url.indexOf(":") + 1).toLowerCase();
|
|
16
|
+
if (scheme === "turn:" || scheme === "turns:") {
|
|
17
|
+
throw new WebRtcTurnUnsupportedError(url);
|
|
18
|
+
}
|
|
19
|
+
if (scheme === "stuns:") {
|
|
20
|
+
throw new UnsupportedError(`STUN over TLS is not supported: ${url}`);
|
|
21
|
+
}
|
|
22
|
+
const match = STUN_URI_.exec(`stun:${url.slice(scheme.length)}`);
|
|
23
|
+
if (scheme !== "stun:" || match === null) {
|
|
24
|
+
throw new RangeError(`Not a stun: URI: ${url}`);
|
|
25
|
+
}
|
|
26
|
+
const port = match[3] === undefined ? DEFAULT_STUN_PORT_ : Number(match[3]);
|
|
27
|
+
if (port < 1 || port > 65535) {
|
|
28
|
+
throw new RangeError(`Invalid port in ${url}`);
|
|
29
|
+
}
|
|
30
|
+
return { host: match[1] ?? match[2], port };
|
|
31
|
+
});
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=_ice-servers.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_ice-servers.js","sourceRoot":"","sources":["../src/_ice-servers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AASzD,iDAAiD;AACjD,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,MAAM,SAAS,GACd,iEAAiE,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAuB;IACvD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAChE,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/C,MAAM,IAAI,0BAA0B,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzB,MAAM,IAAI,gBAAgB,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACjE,IAAI,MAAM,KAAK,OAAO,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,IAAI,UAAU,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,UAAU,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;AACJ,CAAC"}
|
package/dist/_mdns.d.ts
ADDED
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A one-shot multicast DNS query (RFC 6762 §5.1) for the address behind a
|
|
3
|
+
* `.local` name: what a browser puts in its host ICE candidates instead of the
|
|
4
|
+
* address itself (draft-ietf-mmusic-mdns-ice-candidates).
|
|
5
|
+
*
|
|
6
|
+
* Only what that needs: one message with an A and an AAAA question, and the
|
|
7
|
+
* answers matching the name read back. The query goes out from port 5353,
|
|
8
|
+
* shared with the system's responder and joined to the group on every IPv4
|
|
9
|
+
* interface, because browsers' responders answer by multicast only. Where 5353
|
|
10
|
+
* cannot be shared it goes out from an ephemeral port with the unicast-response
|
|
11
|
+
* bit (§5.4, §6.7), which Avahi answers but browsers do not. No caching, no
|
|
12
|
+
* probing, no announcing: `@ac-kit/net-dns` is the place for a DNS message
|
|
13
|
+
* codec when it exists.
|
|
14
|
+
*/
|
|
15
|
+
/** Where queries go: the mDNS IPv4 group and port. */
|
|
16
|
+
export declare const MDNS_IPV4_GROUP_: {
|
|
17
|
+
readonly address: "224.0.0.251";
|
|
18
|
+
readonly port: 5353;
|
|
19
|
+
};
|
|
20
|
+
/**
|
|
21
|
+
* A query for `name`'s A and AAAA records, asking for a unicast response unless
|
|
22
|
+
* `unicastResponse` is `false`.
|
|
23
|
+
*/
|
|
24
|
+
export declare function encodeMdnsQuery_(name: string, unicastResponse?: boolean): Uint8Array<ArrayBuffer>;
|
|
25
|
+
/**
|
|
26
|
+
* The addresses a response gives `name`, IPv4 first; empty when it answers
|
|
27
|
+
* something else or is malformed.
|
|
28
|
+
*/
|
|
29
|
+
export declare function decodeMdnsAnswers_(data: Uint8Array, name: string): string[];
|
|
30
|
+
/** Where and how long {@link resolveMdnsName_} asks. */
|
|
31
|
+
export type MdnsQueryOptions_ = {
|
|
32
|
+
/**
|
|
33
|
+
* Asks this one responder by unicast instead of the link by multicast: for a
|
|
34
|
+
* test's fake responder.
|
|
35
|
+
*/
|
|
36
|
+
readonly server?: {
|
|
37
|
+
readonly address: string;
|
|
38
|
+
readonly port: number;
|
|
39
|
+
};
|
|
40
|
+
/** Gives up after this long. */
|
|
41
|
+
readonly timeoutMs: number;
|
|
42
|
+
/** Interval between retransmissions of the query. */
|
|
43
|
+
readonly retryMs: number;
|
|
44
|
+
readonly signal?: AbortSignal;
|
|
45
|
+
};
|
|
46
|
+
/**
|
|
47
|
+
* Asks the local link for `name`'s address.
|
|
48
|
+
*
|
|
49
|
+
* @returns The first address answered, IPv4 preferred, or `null` when nobody
|
|
50
|
+
* answered in time or the signal aborted.
|
|
51
|
+
*/
|
|
52
|
+
export declare function resolveMdnsName_(name: string, options: MdnsQueryOptions_): Promise<string | null>;
|
|
53
|
+
//# sourceMappingURL=_mdns.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_mdns.d.ts","sourceRoot":"","sources":["../src/_mdns.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;GAaG;AAEH,sDAAsD;AACtD,eAAO,MAAM,gBAAgB;aAAK,OAAO,EAAE,aAAa;aAAE,IAAI,EAAE,IAAI;CAAW,CAAC;AAShF;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,EACZ,eAAe,UAAO,GACpB,UAAU,CAAC,WAAW,CAAC,CAiCzB;AAiDD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAoD3E;AAED,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,GAAG;IAC/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,gCAAgC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkDxB"}
|
package/dist/_mdns.js
ADDED
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
import { isIP } from "node:net";
|
|
2
|
+
import { networkInterfaces } from "node:os";
|
|
3
|
+
import { bitAddressFromBytes, printIpv4Address, printIpv6Address, } from "@ac-kit/net-address";
|
|
4
|
+
import { DgramSocket } from "@ac-kit/node";
|
|
5
|
+
/**
|
|
6
|
+
* A one-shot multicast DNS query (RFC 6762 §5.1) for the address behind a
|
|
7
|
+
* `.local` name: what a browser puts in its host ICE candidates instead of the
|
|
8
|
+
* address itself (draft-ietf-mmusic-mdns-ice-candidates).
|
|
9
|
+
*
|
|
10
|
+
* Only what that needs: one message with an A and an AAAA question, and the
|
|
11
|
+
* answers matching the name read back. The query goes out from port 5353,
|
|
12
|
+
* shared with the system's responder and joined to the group on every IPv4
|
|
13
|
+
* interface, because browsers' responders answer by multicast only. Where 5353
|
|
14
|
+
* cannot be shared it goes out from an ephemeral port with the unicast-response
|
|
15
|
+
* bit (§5.4, §6.7), which Avahi answers but browsers do not. No caching, no
|
|
16
|
+
* probing, no announcing: `@ac-kit/net-dns` is the place for a DNS message
|
|
17
|
+
* codec when it exists.
|
|
18
|
+
*/
|
|
19
|
+
/** Where queries go: the mDNS IPv4 group and port. */
|
|
20
|
+
export const MDNS_IPV4_GROUP_ = { address: "224.0.0.251", port: 5353 };
|
|
21
|
+
const TYPE_A_ = 1;
|
|
22
|
+
const TYPE_AAAA_ = 28;
|
|
23
|
+
const CLASS_IN_ = 1;
|
|
24
|
+
/** The unicast-response bit of a question's class (RFC 6762 §5.4). */
|
|
25
|
+
const UNICAST_RESPONSE_ = 0x8000;
|
|
26
|
+
const MAX_POINTER_JUMPS_ = 32;
|
|
27
|
+
/**
|
|
28
|
+
* A query for `name`'s A and AAAA records, asking for a unicast response unless
|
|
29
|
+
* `unicastResponse` is `false`.
|
|
30
|
+
*/
|
|
31
|
+
export function encodeMdnsQuery_(name, unicastResponse = true) {
|
|
32
|
+
const labels = name.replace(/\.$/, "").split(".");
|
|
33
|
+
const encodedLabels = labels.map((label) => new TextEncoder().encode(label));
|
|
34
|
+
for (const label of encodedLabels) {
|
|
35
|
+
if (label.byteLength === 0 || label.byteLength > 63) {
|
|
36
|
+
throw new RangeError(`Invalid DNS label in ${JSON.stringify(name)}`);
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
const nameLength = encodedLabels.reduce((sum, label) => sum + 1 + label.byteLength, 1);
|
|
40
|
+
const questionLength = nameLength + 4;
|
|
41
|
+
const message = new Uint8Array(12 + 2 * questionLength);
|
|
42
|
+
const view = new DataView(message.buffer);
|
|
43
|
+
// Id 0, flags 0 (a standard query), two questions.
|
|
44
|
+
view.setUint16(4, 2);
|
|
45
|
+
let offset = 12;
|
|
46
|
+
for (const type of [TYPE_A_, TYPE_AAAA_]) {
|
|
47
|
+
for (const label of encodedLabels) {
|
|
48
|
+
message[offset++] = label.byteLength;
|
|
49
|
+
message.set(label, offset);
|
|
50
|
+
offset += label.byteLength;
|
|
51
|
+
}
|
|
52
|
+
message[offset++] = 0;
|
|
53
|
+
view.setUint16(offset, type);
|
|
54
|
+
view.setUint16(offset + 2, unicastResponse ? CLASS_IN_ | UNICAST_RESPONSE_ : CLASS_IN_);
|
|
55
|
+
offset += 4;
|
|
56
|
+
}
|
|
57
|
+
return message;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Reads a possibly compressed name at `offset`.
|
|
61
|
+
*
|
|
62
|
+
* @returns The name, lowercased, and the offset just past it in place, or
|
|
63
|
+
* `null` when it is malformed.
|
|
64
|
+
*/
|
|
65
|
+
function readName_(data, offset) {
|
|
66
|
+
const labels = [];
|
|
67
|
+
let position = offset;
|
|
68
|
+
let next = null;
|
|
69
|
+
for (let jumps = 0; jumps <= MAX_POINTER_JUMPS_;) {
|
|
70
|
+
const length = data[position];
|
|
71
|
+
if (length === undefined) {
|
|
72
|
+
return null;
|
|
73
|
+
}
|
|
74
|
+
if (length === 0) {
|
|
75
|
+
return {
|
|
76
|
+
name: labels.join(".").toLowerCase(),
|
|
77
|
+
next: next ?? position + 1,
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
if ((length & 0xc0) === 0xc0) {
|
|
81
|
+
const low = data[position + 1];
|
|
82
|
+
if (low === undefined) {
|
|
83
|
+
return null;
|
|
84
|
+
}
|
|
85
|
+
next ??= position + 2;
|
|
86
|
+
position = ((length & 0x3f) << 8) | low;
|
|
87
|
+
jumps++;
|
|
88
|
+
continue;
|
|
89
|
+
}
|
|
90
|
+
if ((length & 0xc0) !== 0 || position + 1 + length > data.byteLength) {
|
|
91
|
+
return null;
|
|
92
|
+
}
|
|
93
|
+
labels.push(new TextDecoder().decode(data.subarray(position + 1, position + 1 + length)));
|
|
94
|
+
position += 1 + length;
|
|
95
|
+
}
|
|
96
|
+
return null;
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
* The addresses a response gives `name`, IPv4 first; empty when it answers
|
|
100
|
+
* something else or is malformed.
|
|
101
|
+
*/
|
|
102
|
+
export function decodeMdnsAnswers_(data, name) {
|
|
103
|
+
if (data.byteLength < 12) {
|
|
104
|
+
return [];
|
|
105
|
+
}
|
|
106
|
+
const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
|
|
107
|
+
// A response (QR set) only.
|
|
108
|
+
if ((view.getUint16(2) & 0x8000) === 0) {
|
|
109
|
+
return [];
|
|
110
|
+
}
|
|
111
|
+
const questions = view.getUint16(4);
|
|
112
|
+
const records = view.getUint16(6) + view.getUint16(8) + view.getUint16(10);
|
|
113
|
+
const wanted = name.replace(/\.$/, "").toLowerCase();
|
|
114
|
+
let offset = 12;
|
|
115
|
+
for (let index = 0; index < questions; index++) {
|
|
116
|
+
const read = readName_(data, offset);
|
|
117
|
+
if (read === null) {
|
|
118
|
+
return [];
|
|
119
|
+
}
|
|
120
|
+
offset = read.next + 4;
|
|
121
|
+
}
|
|
122
|
+
const ipv4 = [];
|
|
123
|
+
const ipv6 = [];
|
|
124
|
+
for (let index = 0; index < records; index++) {
|
|
125
|
+
const read = readName_(data, offset);
|
|
126
|
+
if (read === null || read.next + 10 > data.byteLength) {
|
|
127
|
+
break;
|
|
128
|
+
}
|
|
129
|
+
const type = view.getUint16(read.next);
|
|
130
|
+
const recordClass = view.getUint16(read.next + 2) & ~UNICAST_RESPONSE_;
|
|
131
|
+
const length = view.getUint16(read.next + 8);
|
|
132
|
+
const rdata = read.next + 10;
|
|
133
|
+
if (rdata + length > data.byteLength) {
|
|
134
|
+
break;
|
|
135
|
+
}
|
|
136
|
+
if (read.name === wanted && recordClass === CLASS_IN_) {
|
|
137
|
+
if (type === TYPE_A_ && length === 4) {
|
|
138
|
+
ipv4.push(printIpv4Address(bitAddressFromBytes(data.slice(rdata, rdata + 4), 32)));
|
|
139
|
+
}
|
|
140
|
+
else if (type === TYPE_AAAA_ && length === 16) {
|
|
141
|
+
ipv6.push(printIpv6Address(bitAddressFromBytes(data.slice(rdata, rdata + 16), 128)));
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
offset = rdata + length;
|
|
145
|
+
}
|
|
146
|
+
return [...ipv4, ...ipv6];
|
|
147
|
+
}
|
|
148
|
+
/**
|
|
149
|
+
* Asks the local link for `name`'s address.
|
|
150
|
+
*
|
|
151
|
+
* @returns The first address answered, IPv4 preferred, or `null` when nobody
|
|
152
|
+
* answered in time or the signal aborted.
|
|
153
|
+
*/
|
|
154
|
+
export async function resolveMdnsName_(name, options) {
|
|
155
|
+
if (options.signal?.aborted) {
|
|
156
|
+
return null;
|
|
157
|
+
}
|
|
158
|
+
const server = options.server ?? MDNS_IPV4_GROUP_;
|
|
159
|
+
// Throws on a malformed name before any socket exists.
|
|
160
|
+
encodeMdnsQuery_(name);
|
|
161
|
+
const multicast = options.server === undefined ? await openMulticastSocket_() : null;
|
|
162
|
+
const socket = multicast ??
|
|
163
|
+
DgramSocket.from({ type: isIP(server.address) === 6 ? "udp6" : "udp4" });
|
|
164
|
+
const query = encodeMdnsQuery_(name, multicast === null);
|
|
165
|
+
const answered = Promise.withResolvers();
|
|
166
|
+
socket.subscribe("message", (data) => {
|
|
167
|
+
const [address] = decodeMdnsAnswers_(data, name);
|
|
168
|
+
if (address !== undefined) {
|
|
169
|
+
answered.resolve(address);
|
|
170
|
+
}
|
|
171
|
+
});
|
|
172
|
+
socket.subscribe("error", () => answered.resolve(null));
|
|
173
|
+
const timeout = setTimeout(() => answered.resolve(null), options.timeoutMs);
|
|
174
|
+
const abort = () => answered.resolve(null);
|
|
175
|
+
options.signal?.addEventListener("abort", abort, { once: true });
|
|
176
|
+
// Aborted while the multicast socket was being opened.
|
|
177
|
+
if (options.signal?.aborted) {
|
|
178
|
+
abort();
|
|
179
|
+
}
|
|
180
|
+
let retry;
|
|
181
|
+
try {
|
|
182
|
+
if (multicast === null) {
|
|
183
|
+
await socket.bind(0);
|
|
184
|
+
}
|
|
185
|
+
const send = () => {
|
|
186
|
+
socket.send(server.port, server.address, query).catch(() => {
|
|
187
|
+
// Lost, as the network might have lost it: the next retry or the
|
|
188
|
+
// timeout follows.
|
|
189
|
+
});
|
|
190
|
+
};
|
|
191
|
+
send();
|
|
192
|
+
retry = setInterval(send, options.retryMs);
|
|
193
|
+
return await answered.promise;
|
|
194
|
+
}
|
|
195
|
+
catch {
|
|
196
|
+
return null;
|
|
197
|
+
}
|
|
198
|
+
finally {
|
|
199
|
+
clearTimeout(timeout);
|
|
200
|
+
clearInterval(retry);
|
|
201
|
+
options.signal?.removeEventListener("abort", abort);
|
|
202
|
+
await socket.close().catch(() => undefined);
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
* A socket on port 5353 joined to the IPv4 mDNS group on every interface, or
|
|
207
|
+
* `null` when the port cannot be shared.
|
|
208
|
+
*/
|
|
209
|
+
async function openMulticastSocket_() {
|
|
210
|
+
const socket = DgramSocket.from({ type: "udp4", reuseAddr: true });
|
|
211
|
+
try {
|
|
212
|
+
await socket.bind(MDNS_IPV4_GROUP_.port);
|
|
213
|
+
}
|
|
214
|
+
catch {
|
|
215
|
+
await socket.close().catch(() => undefined);
|
|
216
|
+
return null;
|
|
217
|
+
}
|
|
218
|
+
let joined = false;
|
|
219
|
+
for (const addresses of Object.values(networkInterfaces())) {
|
|
220
|
+
for (const { address, family } of addresses ?? []) {
|
|
221
|
+
if (family !== "IPv4") {
|
|
222
|
+
continue;
|
|
223
|
+
}
|
|
224
|
+
try {
|
|
225
|
+
socket.addMembership(MDNS_IPV4_GROUP_.address, address);
|
|
226
|
+
joined = true;
|
|
227
|
+
}
|
|
228
|
+
catch {
|
|
229
|
+
// An interface without multicast: the others may answer.
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
if (!joined) {
|
|
234
|
+
await socket.close().catch(() => undefined);
|
|
235
|
+
return null;
|
|
236
|
+
}
|
|
237
|
+
return socket;
|
|
238
|
+
}
|
|
239
|
+
//# sourceMappingURL=_mdns.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_mdns.js","sourceRoot":"","sources":["../src/_mdns.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
/** One event of a peer connection or of one of its channels (`channel`). */
|
|
2
|
+
export type NativeEvent_ = {
|
|
3
|
+
readonly type: "candidate" | "state" | "iceState" | "gatheringState" | "signalingState" | "open" | "closed" | "error" | "message" | "bufferedAmountLow";
|
|
4
|
+
readonly channel?: number;
|
|
5
|
+
readonly candidate?: string;
|
|
6
|
+
readonly mid?: string;
|
|
7
|
+
readonly state?: string;
|
|
8
|
+
readonly message?: string;
|
|
9
|
+
/** A `Buffer` over memory the binding allocated: never shared. */
|
|
10
|
+
readonly binary?: Uint8Array<ArrayBuffer>;
|
|
11
|
+
readonly text?: string;
|
|
12
|
+
};
|
|
13
|
+
/** A datagram to send from the socket bound to `localAddress`. */
|
|
14
|
+
export type NativeDatagram_ = {
|
|
15
|
+
readonly data: Uint8Array<ArrayBuffer>;
|
|
16
|
+
readonly address: string;
|
|
17
|
+
readonly port: number;
|
|
18
|
+
readonly localAddress: string;
|
|
19
|
+
};
|
|
20
|
+
/** What one `poll` returns. */
|
|
21
|
+
export type NativePoll_ = {
|
|
22
|
+
readonly datagrams: NativeDatagram_[];
|
|
23
|
+
readonly events: NativeEvent_[];
|
|
24
|
+
readonly timeoutMs?: number;
|
|
25
|
+
};
|
|
26
|
+
export type NativeSessionDescription_ = {
|
|
27
|
+
readonly type: string;
|
|
28
|
+
readonly sdp: string;
|
|
29
|
+
};
|
|
30
|
+
export type NativeDataChannelOptions_ = {
|
|
31
|
+
readonly ordered: boolean;
|
|
32
|
+
readonly maxRetransmits?: number;
|
|
33
|
+
readonly maxPacketLifeTime?: number;
|
|
34
|
+
readonly protocol?: string;
|
|
35
|
+
readonly negotiatedId?: number;
|
|
36
|
+
};
|
|
37
|
+
export type NativeDataChannelInfo_ = {
|
|
38
|
+
readonly label: string;
|
|
39
|
+
readonly protocol: string;
|
|
40
|
+
readonly ordered: boolean;
|
|
41
|
+
readonly maxRetransmits?: number;
|
|
42
|
+
readonly maxPacketLifeTime?: number;
|
|
43
|
+
readonly stream?: number;
|
|
44
|
+
};
|
|
45
|
+
/** Webrtc-rs's sans-I/O peer connection, as `rust/rtc-node` exposes it. */
|
|
46
|
+
export type NativePeerConnection_ = {
|
|
47
|
+
setLocalDescription(type: string | null): NativeSessionDescription_;
|
|
48
|
+
setRemoteDescription(description: NativeSessionDescription_): void;
|
|
49
|
+
localDescription(): NativeSessionDescription_ | null;
|
|
50
|
+
remoteDescription(): NativeSessionDescription_ | null;
|
|
51
|
+
addLocalHostCandidate(address: string, port: number): void;
|
|
52
|
+
addLocalServerReflexiveCandidate(address: string, port: number, relatedAddress: string, relatedPort: number): void;
|
|
53
|
+
endOfLocalCandidates(): void;
|
|
54
|
+
addRemoteCandidate(candidate: string, mid: string | null): void;
|
|
55
|
+
handleRead(data: Uint8Array, localAddress: string, localPort: number, peerAddress: string, peerPort: number): void;
|
|
56
|
+
poll(maxDatagrams: number): NativePoll_;
|
|
57
|
+
onTimeout(): void;
|
|
58
|
+
createDataChannel(label: string, options: NativeDataChannelOptions_): number;
|
|
59
|
+
dataChannelInfo(channel: number): NativeDataChannelInfo_;
|
|
60
|
+
dataChannelSendBinary(channel: number, data: Uint8Array): void;
|
|
61
|
+
dataChannelSendText(channel: number, text: string): void;
|
|
62
|
+
dataChannelBufferedAmount(channel: number): number;
|
|
63
|
+
dataChannelSetBufferedAmountLowThreshold(channel: number, amount: number): void;
|
|
64
|
+
dataChannelClose(channel: number): void;
|
|
65
|
+
close(): void;
|
|
66
|
+
};
|
|
67
|
+
type NativeBinding_ = {
|
|
68
|
+
readonly RtcPeerConnection: new (options: {
|
|
69
|
+
readonly maxMessageSize?: number;
|
|
70
|
+
}) => NativePeerConnection_;
|
|
71
|
+
};
|
|
72
|
+
/**
|
|
73
|
+
* The native binding for this platform, loaded on first use so that importing
|
|
74
|
+
* the package never fails on a platform without one. Each platform's binary is
|
|
75
|
+
* its own package, `@ac-kit/net-webrtc-<platform>`, which the package manager
|
|
76
|
+
* installs as an optional dependency only where it runs.
|
|
77
|
+
*
|
|
78
|
+
* @throws {UnsupportedError} When no binary was installed for this platform.
|
|
79
|
+
*/
|
|
80
|
+
export declare function nativeWebRtc_(): NativeBinding_;
|
|
81
|
+
export {};
|
|
82
|
+
//# sourceMappingURL=_native.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_native.d.ts","sourceRoot":"","sources":["../src/_native.ts"],"names":[],"mappings":"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"}
|