brustjs 0.1.4-alpha → 0.1.6-alpha
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 +6 -6
- package/package.json +7 -7
- package/runtime/config.ts +45 -9
- package/runtime/index.d.ts +35 -0
- package/runtime/index.js +52 -52
- package/runtime/index.ts +41 -1
package/README.md
CHANGED
|
@@ -29,7 +29,7 @@ per-worker `SharedArrayBuffer`. `tokio-uring` (io_uring) on Linux, `tokio` on ma
|
|
|
29
29
|
bun create brustjs my-app
|
|
30
30
|
cd my-app
|
|
31
31
|
bun install
|
|
32
|
-
bun run dev # → http://127.0.0.1:
|
|
32
|
+
bun run dev # → http://127.0.0.1:1337
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
**Or, with the CLI on your PATH:**
|
|
@@ -55,14 +55,14 @@ bun add brustjs
|
|
|
55
55
|
git clone https://github.com/AssetsArt/brust && cd brust
|
|
56
56
|
bun install
|
|
57
57
|
cd runtime && bun run build && cd .. # release addon; NOT build:debug (~2× slower)
|
|
58
|
-
bun run example/hello-world/index.ts # → http://127.0.0.1:
|
|
58
|
+
bun run example/hello-world/index.ts # → http://127.0.0.1:1337
|
|
59
59
|
```
|
|
60
60
|
|
|
61
61
|
```bash
|
|
62
|
-
curl 127.0.0.1:
|
|
63
|
-
curl 127.0.0.1:
|
|
64
|
-
curl 127.0.0.1:
|
|
65
|
-
curl -N 127.0.0.1:
|
|
62
|
+
curl 127.0.0.1:1337/ping # → pong (pure Rust)
|
|
63
|
+
curl 127.0.0.1:1337/ # → SSR HTML + island
|
|
64
|
+
curl 127.0.0.1:1337/native-profile/World # → Rust jinja, no React
|
|
65
|
+
curl -N 127.0.0.1:1337/sse-counter # → SSE frames
|
|
66
66
|
```
|
|
67
67
|
|
|
68
68
|
The [`example/hello-world/`](./example/hello-world) app shows each feature in one
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "brustjs",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.6-alpha",
|
|
4
4
|
"description": "Bun + Rust SSR framework — React on the server, Rust everywhere else (napi cdylib + per-worker SharedArrayBuffer).",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -40,12 +40,12 @@
|
|
|
40
40
|
"typescript": "^6.0.3"
|
|
41
41
|
},
|
|
42
42
|
"optionalDependencies": {
|
|
43
|
-
"brustjs-darwin-x64": "0.1.
|
|
44
|
-
"brustjs-darwin-arm64": "0.1.
|
|
45
|
-
"brustjs-linux-x64-gnu": "0.1.
|
|
46
|
-
"brustjs-linux-arm64-gnu": "0.1.
|
|
47
|
-
"brustjs-linux-x64-musl": "0.1.
|
|
48
|
-
"brustjs-linux-arm64-musl": "0.1.
|
|
43
|
+
"brustjs-darwin-x64": "0.1.6-alpha",
|
|
44
|
+
"brustjs-darwin-arm64": "0.1.6-alpha",
|
|
45
|
+
"brustjs-linux-x64-gnu": "0.1.6-alpha",
|
|
46
|
+
"brustjs-linux-arm64-gnu": "0.1.6-alpha",
|
|
47
|
+
"brustjs-linux-x64-musl": "0.1.6-alpha",
|
|
48
|
+
"brustjs-linux-arm64-musl": "0.1.6-alpha"
|
|
49
49
|
},
|
|
50
50
|
"peerDependencies": {
|
|
51
51
|
"react": "^19.2.6",
|
package/runtime/config.ts
CHANGED
|
@@ -3,7 +3,10 @@ import path from 'node:path'
|
|
|
3
3
|
import { parse as parseToml } from 'smol-toml'
|
|
4
4
|
|
|
5
5
|
export interface BrustConfig {
|
|
6
|
-
/**
|
|
6
|
+
/** Host/address to bind on. Default `localhost`. Accepts a hostname
|
|
7
|
+
* (resolved Rust-side) or a literal IP such as `0.0.0.0` / `127.0.0.1`. */
|
|
8
|
+
host: string
|
|
9
|
+
/** TCP port to bind on. Default 1337. */
|
|
7
10
|
port: number
|
|
8
11
|
/** Bun Worker count for render dispatch. Default `availableParallelism()`. */
|
|
9
12
|
workers: number
|
|
@@ -11,6 +14,13 @@ export interface BrustConfig {
|
|
|
11
14
|
cacheMaxEntries?: number
|
|
12
15
|
}
|
|
13
16
|
|
|
17
|
+
/** Caller-supplied fallbacks (e.g. `brust.run({ address, port })`) applied
|
|
18
|
+
* BELOW env + TOML but ABOVE the framework defaults. */
|
|
19
|
+
export interface ConfigDefaults {
|
|
20
|
+
host?: string
|
|
21
|
+
port?: number
|
|
22
|
+
}
|
|
23
|
+
|
|
14
24
|
export class BrustConfigError extends Error {
|
|
15
25
|
constructor(
|
|
16
26
|
message: string,
|
|
@@ -21,7 +31,8 @@ export class BrustConfigError extends Error {
|
|
|
21
31
|
}
|
|
22
32
|
}
|
|
23
33
|
|
|
24
|
-
const
|
|
34
|
+
const DEFAULT_HOST = 'localhost'
|
|
35
|
+
const DEFAULT_PORT = 1337
|
|
25
36
|
// One worker per CPU. Bumping the multiplier above 1 was tuned for I/O-bound
|
|
26
37
|
// renders; on CPU-bound React work (typical) it over-subscribes and amplifies
|
|
27
38
|
// p99 tail. Users with Suspense-heavy / await-heavy renders can override via
|
|
@@ -31,14 +42,21 @@ const defaultWorkers = (): number => os.availableParallelism()
|
|
|
31
42
|
const CONFIG_BASENAME = 'brust.toml'
|
|
32
43
|
|
|
33
44
|
/**
|
|
34
|
-
* Resolve Brust configuration. Precedence (low → high):
|
|
45
|
+
* Resolve Brust configuration. Precedence (low → high):
|
|
46
|
+
* framework defaults < caller `defaults` < TOML < env.
|
|
35
47
|
*
|
|
36
|
-
* -
|
|
48
|
+
* - Framework defaults: { host: 'localhost', port: 1337, workers: availableParallelism() }
|
|
49
|
+
* - Caller `defaults`: e.g. `brust.run({ address, port })` — app-level fallbacks
|
|
50
|
+
* that fill in only when neither TOML nor env specify the value (so a
|
|
51
|
+
* `brust dev --port` / BRUST_PORT still wins over code).
|
|
37
52
|
* - TOML: brust.toml at `cwd` (missing file is fine — only a present file with
|
|
38
|
-
* wrong shape is an error).
|
|
39
|
-
* - Env: BRUST_PORT
|
|
53
|
+
* wrong shape is an error). `[server] address` / `port`.
|
|
54
|
+
* - Env: BRUST_ADDR, BRUST_PORT, BRUST_WORKERS override either source.
|
|
40
55
|
*/
|
|
41
|
-
export async function loadConfig(
|
|
56
|
+
export async function loadConfig(
|
|
57
|
+
cwd: string = process.cwd(),
|
|
58
|
+
defaults: ConfigDefaults = {},
|
|
59
|
+
): Promise<BrustConfig> {
|
|
42
60
|
let fromToml: Partial<BrustConfig> = {}
|
|
43
61
|
const tomlPath = path.join(cwd, CONFIG_BASENAME)
|
|
44
62
|
|
|
@@ -55,10 +73,11 @@ export async function loadConfig(cwd: string = process.cwd()): Promise<BrustConf
|
|
|
55
73
|
|
|
56
74
|
const fromEnv = extractFromEnv()
|
|
57
75
|
|
|
58
|
-
const
|
|
76
|
+
const host = fromEnv.host ?? fromToml.host ?? defaults.host ?? DEFAULT_HOST
|
|
77
|
+
const port = fromEnv.port ?? fromToml.port ?? defaults.port ?? DEFAULT_PORT
|
|
59
78
|
const workers = fromEnv.workers ?? fromToml.workers ?? defaultWorkers()
|
|
60
79
|
|
|
61
|
-
return { port, workers, cacheMaxEntries: fromToml.cacheMaxEntries }
|
|
80
|
+
return { host, port, workers, cacheMaxEntries: fromToml.cacheMaxEntries }
|
|
62
81
|
}
|
|
63
82
|
|
|
64
83
|
function extractFromToml(parsed: unknown, file: string): Partial<BrustConfig> {
|
|
@@ -83,6 +102,16 @@ function extractFromToml(parsed: unknown, file: string): Partial<BrustConfig> {
|
|
|
83
102
|
}
|
|
84
103
|
out.port = port
|
|
85
104
|
}
|
|
105
|
+
const address = (server as Record<string, unknown>).address
|
|
106
|
+
if (address !== undefined) {
|
|
107
|
+
if (typeof address !== 'string' || address.trim() === '') {
|
|
108
|
+
throw new BrustConfigError(
|
|
109
|
+
`${file}: server.address must be a non-empty string (got ${JSON.stringify(address)})`,
|
|
110
|
+
file,
|
|
111
|
+
)
|
|
112
|
+
}
|
|
113
|
+
out.host = address.trim()
|
|
114
|
+
}
|
|
86
115
|
}
|
|
87
116
|
|
|
88
117
|
if ('workers' in root) {
|
|
@@ -124,6 +153,13 @@ function extractFromToml(parsed: unknown, file: string): Partial<BrustConfig> {
|
|
|
124
153
|
|
|
125
154
|
function extractFromEnv(): Partial<BrustConfig> {
|
|
126
155
|
const out: Partial<BrustConfig> = {}
|
|
156
|
+
if (process.env.BRUST_ADDR) {
|
|
157
|
+
const addr = process.env.BRUST_ADDR.trim()
|
|
158
|
+
if (addr === '') {
|
|
159
|
+
throw new BrustConfigError('BRUST_ADDR must be a non-empty string', null)
|
|
160
|
+
}
|
|
161
|
+
out.host = addr
|
|
162
|
+
}
|
|
127
163
|
if (process.env.BRUST_PORT) {
|
|
128
164
|
const n = parseInt(process.env.BRUST_PORT, 10)
|
|
129
165
|
if (!Number.isInteger(n) || n < 1 || n > 65535) {
|
package/runtime/index.d.ts
CHANGED
|
@@ -213,9 +213,44 @@ export declare function registerRoutes(configs: Array<string>): NapiResult<numbe
|
|
|
213
213
|
export declare function resetWorkerPool(): number
|
|
214
214
|
|
|
215
215
|
export interface ServeOptions {
|
|
216
|
+
/**
|
|
217
|
+
* Host to bind on — a hostname (e.g. `localhost`, resolved here) or a
|
|
218
|
+
* literal IP such as `0.0.0.0` / `127.0.0.1`.
|
|
219
|
+
*/
|
|
220
|
+
host: string
|
|
216
221
|
port: number
|
|
217
222
|
workers: number
|
|
218
223
|
entry: string
|
|
224
|
+
/** Optional performance tunables. Omit to keep framework defaults. */
|
|
225
|
+
tuning?: ServeTuning
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
/**
|
|
229
|
+
* Runtime-tunable server limits, all optional. Maps onto `server::Tuning`
|
|
230
|
+
* (which holds the defaults). `conn_workers` is the only one NOT in
|
|
231
|
+
* `server::Tuning` — it's the Rust connection-handling concurrency passed to
|
|
232
|
+
* `server::start`, independent of `workers` (the Bun render-thread count).
|
|
233
|
+
*/
|
|
234
|
+
export interface ServeTuning {
|
|
235
|
+
/**
|
|
236
|
+
* Rust-side accept→parse→dispatch task concurrency. Independent of
|
|
237
|
+
* `workers` (Bun render threads). Default = `workers`.
|
|
238
|
+
*/
|
|
239
|
+
connWorkers?: number
|
|
240
|
+
/** Cap on request bytes before the header terminator. Default 16384. */
|
|
241
|
+
maxRequestBytes?: number
|
|
242
|
+
/** Cap on action/RPC body size (mirror the SAB capacity). Default 262144. */
|
|
243
|
+
maxActionBodyBytes?: number
|
|
244
|
+
/** Accept-side queue depth (TCP backpressure point). Default 1024. */
|
|
245
|
+
connQueueCap?: number
|
|
246
|
+
/** Initial per-connection read buffer capacity. Default 4096. */
|
|
247
|
+
readBufCap?: number
|
|
248
|
+
/**
|
|
249
|
+
* Max ms a render dispatch waits for a free worker before 503 (AllBusy is
|
|
250
|
+
* queued, not failed-fast). Lets `connWorkers > workers` avoid 503 storms.
|
|
251
|
+
* Default 10000.
|
|
252
|
+
*/
|
|
253
|
+
claimTimeoutMs?: number
|
|
219
254
|
}
|
|
220
255
|
|
|
221
256
|
export declare function untilReady(timeoutMs: number): Promise<NapiResult<undefined>>
|
package/runtime/index.js
CHANGED
|
@@ -77,8 +77,8 @@ function requireNative() {
|
|
|
77
77
|
try {
|
|
78
78
|
const binding = require('brustjs-android-arm64')
|
|
79
79
|
const bindingPackageVersion = require('brustjs-android-arm64/package.json').version
|
|
80
|
-
if (bindingPackageVersion !== '0.1.
|
|
81
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
80
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
81
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
82
82
|
}
|
|
83
83
|
return binding
|
|
84
84
|
} catch (e) {
|
|
@@ -93,8 +93,8 @@ function requireNative() {
|
|
|
93
93
|
try {
|
|
94
94
|
const binding = require('brustjs-android-arm-eabi')
|
|
95
95
|
const bindingPackageVersion = require('brustjs-android-arm-eabi/package.json').version
|
|
96
|
-
if (bindingPackageVersion !== '0.1.
|
|
97
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
96
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
97
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
98
98
|
}
|
|
99
99
|
return binding
|
|
100
100
|
} catch (e) {
|
|
@@ -114,8 +114,8 @@ function requireNative() {
|
|
|
114
114
|
try {
|
|
115
115
|
const binding = require('brustjs-win32-x64-gnu')
|
|
116
116
|
const bindingPackageVersion = require('brustjs-win32-x64-gnu/package.json').version
|
|
117
|
-
if (bindingPackageVersion !== '0.1.
|
|
118
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
117
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
118
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
119
119
|
}
|
|
120
120
|
return binding
|
|
121
121
|
} catch (e) {
|
|
@@ -130,8 +130,8 @@ function requireNative() {
|
|
|
130
130
|
try {
|
|
131
131
|
const binding = require('brustjs-win32-x64-msvc')
|
|
132
132
|
const bindingPackageVersion = require('brustjs-win32-x64-msvc/package.json').version
|
|
133
|
-
if (bindingPackageVersion !== '0.1.
|
|
134
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
133
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
134
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
135
135
|
}
|
|
136
136
|
return binding
|
|
137
137
|
} catch (e) {
|
|
@@ -147,8 +147,8 @@ function requireNative() {
|
|
|
147
147
|
try {
|
|
148
148
|
const binding = require('brustjs-win32-ia32-msvc')
|
|
149
149
|
const bindingPackageVersion = require('brustjs-win32-ia32-msvc/package.json').version
|
|
150
|
-
if (bindingPackageVersion !== '0.1.
|
|
151
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
150
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
151
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
152
152
|
}
|
|
153
153
|
return binding
|
|
154
154
|
} catch (e) {
|
|
@@ -163,8 +163,8 @@ function requireNative() {
|
|
|
163
163
|
try {
|
|
164
164
|
const binding = require('brustjs-win32-arm64-msvc')
|
|
165
165
|
const bindingPackageVersion = require('brustjs-win32-arm64-msvc/package.json').version
|
|
166
|
-
if (bindingPackageVersion !== '0.1.
|
|
167
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
166
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
167
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
168
168
|
}
|
|
169
169
|
return binding
|
|
170
170
|
} catch (e) {
|
|
@@ -182,8 +182,8 @@ function requireNative() {
|
|
|
182
182
|
try {
|
|
183
183
|
const binding = require('brustjs-darwin-universal')
|
|
184
184
|
const bindingPackageVersion = require('brustjs-darwin-universal/package.json').version
|
|
185
|
-
if (bindingPackageVersion !== '0.1.
|
|
186
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
185
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
186
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
187
187
|
}
|
|
188
188
|
return binding
|
|
189
189
|
} catch (e) {
|
|
@@ -198,8 +198,8 @@ function requireNative() {
|
|
|
198
198
|
try {
|
|
199
199
|
const binding = require('brustjs-darwin-x64')
|
|
200
200
|
const bindingPackageVersion = require('brustjs-darwin-x64/package.json').version
|
|
201
|
-
if (bindingPackageVersion !== '0.1.
|
|
202
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
201
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
202
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
203
203
|
}
|
|
204
204
|
return binding
|
|
205
205
|
} catch (e) {
|
|
@@ -214,8 +214,8 @@ function requireNative() {
|
|
|
214
214
|
try {
|
|
215
215
|
const binding = require('brustjs-darwin-arm64')
|
|
216
216
|
const bindingPackageVersion = require('brustjs-darwin-arm64/package.json').version
|
|
217
|
-
if (bindingPackageVersion !== '0.1.
|
|
218
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
217
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
218
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
219
219
|
}
|
|
220
220
|
return binding
|
|
221
221
|
} catch (e) {
|
|
@@ -234,8 +234,8 @@ function requireNative() {
|
|
|
234
234
|
try {
|
|
235
235
|
const binding = require('brustjs-freebsd-x64')
|
|
236
236
|
const bindingPackageVersion = require('brustjs-freebsd-x64/package.json').version
|
|
237
|
-
if (bindingPackageVersion !== '0.1.
|
|
238
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
237
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
238
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
239
239
|
}
|
|
240
240
|
return binding
|
|
241
241
|
} catch (e) {
|
|
@@ -250,8 +250,8 @@ function requireNative() {
|
|
|
250
250
|
try {
|
|
251
251
|
const binding = require('brustjs-freebsd-arm64')
|
|
252
252
|
const bindingPackageVersion = require('brustjs-freebsd-arm64/package.json').version
|
|
253
|
-
if (bindingPackageVersion !== '0.1.
|
|
254
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
253
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
254
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
255
255
|
}
|
|
256
256
|
return binding
|
|
257
257
|
} catch (e) {
|
|
@@ -271,8 +271,8 @@ function requireNative() {
|
|
|
271
271
|
try {
|
|
272
272
|
const binding = require('brustjs-linux-x64-musl')
|
|
273
273
|
const bindingPackageVersion = require('brustjs-linux-x64-musl/package.json').version
|
|
274
|
-
if (bindingPackageVersion !== '0.1.
|
|
275
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
274
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
275
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
276
276
|
}
|
|
277
277
|
return binding
|
|
278
278
|
} catch (e) {
|
|
@@ -287,8 +287,8 @@ function requireNative() {
|
|
|
287
287
|
try {
|
|
288
288
|
const binding = require('brustjs-linux-x64-gnu')
|
|
289
289
|
const bindingPackageVersion = require('brustjs-linux-x64-gnu/package.json').version
|
|
290
|
-
if (bindingPackageVersion !== '0.1.
|
|
291
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
290
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
291
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
292
292
|
}
|
|
293
293
|
return binding
|
|
294
294
|
} catch (e) {
|
|
@@ -305,8 +305,8 @@ function requireNative() {
|
|
|
305
305
|
try {
|
|
306
306
|
const binding = require('brustjs-linux-arm64-musl')
|
|
307
307
|
const bindingPackageVersion = require('brustjs-linux-arm64-musl/package.json').version
|
|
308
|
-
if (bindingPackageVersion !== '0.1.
|
|
309
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
308
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
309
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
310
310
|
}
|
|
311
311
|
return binding
|
|
312
312
|
} catch (e) {
|
|
@@ -321,8 +321,8 @@ function requireNative() {
|
|
|
321
321
|
try {
|
|
322
322
|
const binding = require('brustjs-linux-arm64-gnu')
|
|
323
323
|
const bindingPackageVersion = require('brustjs-linux-arm64-gnu/package.json').version
|
|
324
|
-
if (bindingPackageVersion !== '0.1.
|
|
325
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
324
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
325
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
326
326
|
}
|
|
327
327
|
return binding
|
|
328
328
|
} catch (e) {
|
|
@@ -339,8 +339,8 @@ function requireNative() {
|
|
|
339
339
|
try {
|
|
340
340
|
const binding = require('brustjs-linux-arm-musleabihf')
|
|
341
341
|
const bindingPackageVersion = require('brustjs-linux-arm-musleabihf/package.json').version
|
|
342
|
-
if (bindingPackageVersion !== '0.1.
|
|
343
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
342
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
343
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
344
344
|
}
|
|
345
345
|
return binding
|
|
346
346
|
} catch (e) {
|
|
@@ -355,8 +355,8 @@ function requireNative() {
|
|
|
355
355
|
try {
|
|
356
356
|
const binding = require('brustjs-linux-arm-gnueabihf')
|
|
357
357
|
const bindingPackageVersion = require('brustjs-linux-arm-gnueabihf/package.json').version
|
|
358
|
-
if (bindingPackageVersion !== '0.1.
|
|
359
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
358
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
359
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
360
360
|
}
|
|
361
361
|
return binding
|
|
362
362
|
} catch (e) {
|
|
@@ -373,8 +373,8 @@ function requireNative() {
|
|
|
373
373
|
try {
|
|
374
374
|
const binding = require('brustjs-linux-loong64-musl')
|
|
375
375
|
const bindingPackageVersion = require('brustjs-linux-loong64-musl/package.json').version
|
|
376
|
-
if (bindingPackageVersion !== '0.1.
|
|
377
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
376
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
377
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
378
378
|
}
|
|
379
379
|
return binding
|
|
380
380
|
} catch (e) {
|
|
@@ -389,8 +389,8 @@ function requireNative() {
|
|
|
389
389
|
try {
|
|
390
390
|
const binding = require('brustjs-linux-loong64-gnu')
|
|
391
391
|
const bindingPackageVersion = require('brustjs-linux-loong64-gnu/package.json').version
|
|
392
|
-
if (bindingPackageVersion !== '0.1.
|
|
393
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
392
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
393
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
394
394
|
}
|
|
395
395
|
return binding
|
|
396
396
|
} catch (e) {
|
|
@@ -407,8 +407,8 @@ function requireNative() {
|
|
|
407
407
|
try {
|
|
408
408
|
const binding = require('brustjs-linux-riscv64-musl')
|
|
409
409
|
const bindingPackageVersion = require('brustjs-linux-riscv64-musl/package.json').version
|
|
410
|
-
if (bindingPackageVersion !== '0.1.
|
|
411
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
410
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
411
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
412
412
|
}
|
|
413
413
|
return binding
|
|
414
414
|
} catch (e) {
|
|
@@ -423,8 +423,8 @@ function requireNative() {
|
|
|
423
423
|
try {
|
|
424
424
|
const binding = require('brustjs-linux-riscv64-gnu')
|
|
425
425
|
const bindingPackageVersion = require('brustjs-linux-riscv64-gnu/package.json').version
|
|
426
|
-
if (bindingPackageVersion !== '0.1.
|
|
427
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
426
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
427
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
428
428
|
}
|
|
429
429
|
return binding
|
|
430
430
|
} catch (e) {
|
|
@@ -440,8 +440,8 @@ function requireNative() {
|
|
|
440
440
|
try {
|
|
441
441
|
const binding = require('brustjs-linux-ppc64-gnu')
|
|
442
442
|
const bindingPackageVersion = require('brustjs-linux-ppc64-gnu/package.json').version
|
|
443
|
-
if (bindingPackageVersion !== '0.1.
|
|
444
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
443
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
444
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
445
445
|
}
|
|
446
446
|
return binding
|
|
447
447
|
} catch (e) {
|
|
@@ -456,8 +456,8 @@ function requireNative() {
|
|
|
456
456
|
try {
|
|
457
457
|
const binding = require('brustjs-linux-s390x-gnu')
|
|
458
458
|
const bindingPackageVersion = require('brustjs-linux-s390x-gnu/package.json').version
|
|
459
|
-
if (bindingPackageVersion !== '0.1.
|
|
460
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
459
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
460
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
461
461
|
}
|
|
462
462
|
return binding
|
|
463
463
|
} catch (e) {
|
|
@@ -476,8 +476,8 @@ function requireNative() {
|
|
|
476
476
|
try {
|
|
477
477
|
const binding = require('brustjs-openharmony-arm64')
|
|
478
478
|
const bindingPackageVersion = require('brustjs-openharmony-arm64/package.json').version
|
|
479
|
-
if (bindingPackageVersion !== '0.1.
|
|
480
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
479
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
480
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
481
481
|
}
|
|
482
482
|
return binding
|
|
483
483
|
} catch (e) {
|
|
@@ -492,8 +492,8 @@ function requireNative() {
|
|
|
492
492
|
try {
|
|
493
493
|
const binding = require('brustjs-openharmony-x64')
|
|
494
494
|
const bindingPackageVersion = require('brustjs-openharmony-x64/package.json').version
|
|
495
|
-
if (bindingPackageVersion !== '0.1.
|
|
496
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
495
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
496
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
497
497
|
}
|
|
498
498
|
return binding
|
|
499
499
|
} catch (e) {
|
|
@@ -508,8 +508,8 @@ function requireNative() {
|
|
|
508
508
|
try {
|
|
509
509
|
const binding = require('brustjs-openharmony-arm')
|
|
510
510
|
const bindingPackageVersion = require('brustjs-openharmony-arm/package.json').version
|
|
511
|
-
if (bindingPackageVersion !== '0.1.
|
|
512
|
-
throw new Error(`Native binding package version mismatch, expected 0.1.
|
|
511
|
+
if (bindingPackageVersion !== '0.1.6-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
|
|
512
|
+
throw new Error(`Native binding package version mismatch, expected 0.1.6-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
|
|
513
513
|
}
|
|
514
514
|
return binding
|
|
515
515
|
} catch (e) {
|
package/runtime/index.ts
CHANGED
|
@@ -5,6 +5,9 @@ import { loadConfig } from './config.ts'
|
|
|
5
5
|
import { configureCssEnabled, configureCssHrefsForRoute } from './css.ts'
|
|
6
6
|
|
|
7
7
|
export interface ServeOptions {
|
|
8
|
+
/** Host/address to bind on. A hostname (e.g. `localhost`, resolved Rust-side)
|
|
9
|
+
* or a literal IP such as `0.0.0.0` / `127.0.0.1`. */
|
|
10
|
+
host: string
|
|
8
11
|
port: number
|
|
9
12
|
workers: number
|
|
10
13
|
entry: string
|
|
@@ -20,6 +23,30 @@ export interface ServeOptions {
|
|
|
20
23
|
* pattern. The field here is currently unused inside serve() and is reserved
|
|
21
24
|
* for future IPC-based propagation of the manifest. */
|
|
22
25
|
mcp?: { manifest: import('./mcp/manifest.ts').McpManifest }
|
|
26
|
+
/** Performance tunables. All optional — omitting any field keeps the
|
|
27
|
+
* framework default, so the whole object is opt-in. `connWorkers` sets the
|
|
28
|
+
* Rust-side connection-handling concurrency (accept→parse→dispatch), which is
|
|
29
|
+
* INDEPENDENT of `workers` (the Bun render threads): I/O-bound paths like
|
|
30
|
+
* `/ping` scale with `connWorkers`, render-bound paths scale with `workers`.
|
|
31
|
+
* Setting `connWorkers > workers` is safe: a render dispatch that finds every
|
|
32
|
+
* worker busy QUEUES (awaits a free worker up to `claimTimeoutMs`) instead of
|
|
33
|
+
* 503-ing, so excess conn-workers just wait their turn rather than dropping
|
|
34
|
+
* requests. */
|
|
35
|
+
tuning?: {
|
|
36
|
+
/** Rust accept/dispatch concurrency. Default = `workers`. */
|
|
37
|
+
connWorkers?: number
|
|
38
|
+
/** Max request bytes before header terminator. Default 16384 (16 KB). */
|
|
39
|
+
maxRequestBytes?: number
|
|
40
|
+
/** Max action/RPC body size. Default 262144 (256 KB). */
|
|
41
|
+
maxActionBodyBytes?: number
|
|
42
|
+
/** Accept-side queue depth (TCP backpressure point). Default 1024. */
|
|
43
|
+
connQueueCap?: number
|
|
44
|
+
/** Initial per-connection read buffer capacity. Default 4096. */
|
|
45
|
+
readBufCap?: number
|
|
46
|
+
/** Max ms a render waits for a free worker before 503 (AllBusy queues
|
|
47
|
+
* instead of failing fast). Default 10000. */
|
|
48
|
+
claimTimeoutMs?: number
|
|
49
|
+
}
|
|
23
50
|
}
|
|
24
51
|
|
|
25
52
|
// Render callback. Resolves with a framed-response length: `> 0` → FAST LANE
|
|
@@ -101,9 +128,11 @@ export const brust = {
|
|
|
101
128
|
registerActionsInternal(opts.actions)
|
|
102
129
|
}
|
|
103
130
|
;(native as any).beginServe({
|
|
131
|
+
host: opts.host,
|
|
104
132
|
port: opts.port,
|
|
105
133
|
workers: opts.workers,
|
|
106
134
|
entry: opts.entry,
|
|
135
|
+
tuning: opts.tuning,
|
|
107
136
|
})
|
|
108
137
|
const baseEnv = { ...process.env }
|
|
109
138
|
const workersArr: Worker[] = []
|
|
@@ -257,6 +286,13 @@ export const brust = {
|
|
|
257
286
|
routes: import('./routes.ts').FlatRoute[]
|
|
258
287
|
entry: string
|
|
259
288
|
scanRoot?: string
|
|
289
|
+
/** Host/address to bind on. Default `localhost`. A `brust dev --port` /
|
|
290
|
+
* BRUST_PORT / BRUST_ADDR / brust.toml all override this app-level value
|
|
291
|
+
* (precedence: env > toml > this > framework default). */
|
|
292
|
+
address?: string
|
|
293
|
+
/** TCP port to bind on. Default 1337. Overridable by env/toml — see
|
|
294
|
+
* `address`. */
|
|
295
|
+
port?: number
|
|
260
296
|
/** Overrides merged into the underlying `serve()` call (main thread). */
|
|
261
297
|
serve?: Partial<Omit<ServeOptions, 'entry' | 'actions' | 'mcp'>>
|
|
262
298
|
/** Per-worker SAB size in bytes. Default 256 KB. */
|
|
@@ -293,7 +329,10 @@ export const brust = {
|
|
|
293
329
|
const { actions, sourceFiles } = await this.scanActions({ roots: [scanRoot] })
|
|
294
330
|
|
|
295
331
|
if (!isWorker) {
|
|
296
|
-
const { port, workers, cacheMaxEntries } = await loadConfig()
|
|
332
|
+
const { host, port, workers, cacheMaxEntries } = await loadConfig(process.cwd(), {
|
|
333
|
+
host: opts.address,
|
|
334
|
+
port: opts.port,
|
|
335
|
+
})
|
|
297
336
|
console.log(`[brust] main: spawning ${workers} worker threads`)
|
|
298
337
|
if (cacheMaxEntries !== undefined) this.configureCache({ maxEntries: cacheMaxEntries })
|
|
299
338
|
|
|
@@ -529,6 +568,7 @@ export const brust = {
|
|
|
529
568
|
}
|
|
530
569
|
|
|
531
570
|
await this.serve({
|
|
571
|
+
host,
|
|
532
572
|
port,
|
|
533
573
|
workers,
|
|
534
574
|
entry: opts.entry,
|