@freerdp-bridge/fastify 0.2.1 → 0.2.2

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 (2) hide show
  1. package/README.md +21 -4
  2. package/package.json +4 -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. Requires Node.js 24.
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.1 @freerdp-bridge/runtime-linux-x64-gnu@0.2.1
15
+ npm install fastify@5.12.5 @freerdp-bridge/fastify@0.2.2 @freerdp-bridge/runtime-linux-x64-gnu@0.2.2
12
16
 
13
17
  # Windows x64
14
- npm install fastify@5.12.5 @freerdp-bridge/fastify@0.2.1 @freerdp-bridge/runtime-win32-x64@0.2.1
18
+ npm install fastify@5.12.5 @freerdp-bridge/fastify@0.2.2 @freerdp-bridge/runtime-win32-x64@0.2.2
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
- Project-owned code uses MIT. Native dependencies retain their own licenses in
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.1",
3
+ "version": "0.2.2",
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,7 +22,7 @@
21
22
  }
22
23
  },
23
24
  "dependencies": {
24
- "@freerdp-bridge/api": "0.2.1"
25
+ "@freerdp-bridge/api": "0.2.2"
25
26
  },
26
27
  "peerDependencies": {
27
28
  "fastify": "^5.12.5"