@freerdp-bridge/fastify 0.2.1 → 0.2.4
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/README.md +21 -4
- package/package.json +8 -3
package/README.md
CHANGED
|
@@ -1,25 +1,38 @@
|
|
|
1
1
|
# FreeRDP Browser Bridge — Fastify
|
|
2
2
|
|
|
3
|
+
## Purpose
|
|
4
|
+
|
|
3
5
|
Mount RDP HTTP and WebSocket routes inside an existing Fastify 5 application,
|
|
4
6
|
on its existing port. Each session runs a separate native worker; FreeRDP does
|
|
5
|
-
not run inside Node.js.
|
|
7
|
+
not run inside Node.js. Package name: `@freerdp-bridge/fastify`.
|
|
8
|
+
|
|
9
|
+
## Installation
|
|
6
10
|
|
|
7
11
|
Install the adapter and the matching native runtime version for your server:
|
|
8
12
|
|
|
9
13
|
```sh
|
|
10
14
|
# Linux x64 / glibc
|
|
11
|
-
npm install fastify@5.12.5 @freerdp-bridge/fastify@0.2.
|
|
15
|
+
npm install fastify@5.12.5 @freerdp-bridge/fastify@0.2.4 @freerdp-bridge/runtime-linux-x64-gnu@0.2.4
|
|
12
16
|
|
|
13
17
|
# Windows x64
|
|
14
|
-
npm install fastify@5.12.5 @freerdp-bridge/fastify@0.2.
|
|
18
|
+
npm install fastify@5.12.5 @freerdp-bridge/fastify@0.2.4 @freerdp-bridge/runtime-win32-x64@0.2.4
|
|
15
19
|
```
|
|
16
20
|
|
|
17
21
|
For an unreleased source checkout, use locally built tarballs instead;
|
|
18
22
|
a source version number alone does not establish registry availability.
|
|
23
|
+
## Requirements
|
|
24
|
+
|
|
25
|
+
Requires Node.js 24, ESM, Fastify 5 and a native runtime of the same product
|
|
26
|
+
version as all JS bridge packages. Install the runtime explicitly.
|
|
19
27
|
Runtime packages include their private native libraries, helpers and notices.
|
|
28
|
+
This adapter contains JavaScript/declarations; the compiled C++ worker and
|
|
29
|
+
native IPC components are supplied by the separate platform runtime, not by
|
|
30
|
+
the adapter. The runtime also carries its third-party source companions.
|
|
20
31
|
They require no compiler or network installation script. Node/browser binaries
|
|
21
32
|
are separate prerequisites. macOS, ARM and musl are not supported by this set.
|
|
22
33
|
|
|
34
|
+
## Usage
|
|
35
|
+
|
|
23
36
|
```ts
|
|
24
37
|
import Fastify from 'fastify';
|
|
25
38
|
import { rdpBridgePlugin, resolveNativeRuntime } from '@freerdp-bridge/fastify';
|
|
@@ -44,6 +57,8 @@ Cookie-based identity needs a separate CSRF/Origin adapter and is currently
|
|
|
44
57
|
refused. On Windows, use an absolute Windows path for runtimeRoot. The host
|
|
45
58
|
owns external TLS and access logging; exclude credentials and attach URL tokens.
|
|
46
59
|
|
|
60
|
+
## Limitations
|
|
61
|
+
|
|
47
62
|
The plugin validates bodies strictly within 64 KiB, preserves session ownership,
|
|
48
63
|
uses single-use control/media tokens, and verifies RDP certificates strictly by
|
|
49
64
|
default. Inspect `/rdp/v1/build` and `/rdp/v1/capabilities` for the actual native
|
|
@@ -70,5 +85,7 @@ The host owns presentation, identity and browser permission policy.
|
|
|
70
85
|
|
|
71
86
|
Complete source-tree guides are `docs/FASTIFY_USAGE.md` and
|
|
72
87
|
`docs/NATIVE_NPM_RUNTIME.md`; the public `.d.ts` files describe the options.
|
|
73
|
-
|
|
88
|
+
## License
|
|
89
|
+
|
|
90
|
+
Project-owned code uses MIT (LICENSE). Native dependencies retain their own licenses in
|
|
74
91
|
the platform runtime package's THIRD_PARTY_NOTICES.md and bundled notices.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@freerdp-bridge/fastify",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.4",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"engines": {
|
|
@@ -8,7 +8,8 @@
|
|
|
8
8
|
},
|
|
9
9
|
"files": [
|
|
10
10
|
"dist",
|
|
11
|
-
"LICENSE"
|
|
11
|
+
"LICENSE",
|
|
12
|
+
"README.md"
|
|
12
13
|
],
|
|
13
14
|
"exports": {
|
|
14
15
|
".": {
|
|
@@ -21,11 +22,15 @@
|
|
|
21
22
|
}
|
|
22
23
|
},
|
|
23
24
|
"dependencies": {
|
|
24
|
-
"@freerdp-bridge/api": "0.2.
|
|
25
|
+
"@freerdp-bridge/api": "0.2.4"
|
|
25
26
|
},
|
|
26
27
|
"peerDependencies": {
|
|
27
28
|
"fastify": "^5.12.5"
|
|
28
29
|
},
|
|
30
|
+
"repository": {
|
|
31
|
+
"type": "git",
|
|
32
|
+
"url": "git+https://github.com/SensNyaha/freerdp-bridge-fastify.git"
|
|
33
|
+
},
|
|
29
34
|
"scripts": {
|
|
30
35
|
"build": "tsc -b"
|
|
31
36
|
}
|