brustjs 0.1.3-alpha → 0.1.5-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.
Files changed (8) hide show
  1. package/README.md +6 -6
  2. package/package.json +7 -7
  3. package/runtime/cli/native-routes-emit.ts +30 -1
  4. package/runtime/config.ts +45 -9
  5. package/runtime/dev/ws-channel.ts +12 -13
  6. package/runtime/index.d.ts +17 -0
  7. package/runtime/index.js +53 -52
  8. package/runtime/index.ts +16 -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:3000
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:3000
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:3000/ping # → pong (pure Rust)
63
- curl 127.0.0.1:3000/ # → SSR HTML + island
64
- curl 127.0.0.1:3000/native-profile/World # → Rust jinja, no React
65
- curl -N 127.0.0.1:3000/sse-counter # → SSE frames
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-alpha",
3
+ "version": "0.1.5-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.3-alpha",
44
- "brustjs-darwin-arm64": "0.1.3-alpha",
45
- "brustjs-linux-x64-gnu": "0.1.3-alpha",
46
- "brustjs-linux-arm64-gnu": "0.1.3-alpha",
47
- "brustjs-linux-x64-musl": "0.1.3-alpha",
48
- "brustjs-linux-arm64-musl": "0.1.3-alpha"
43
+ "brustjs-darwin-x64": "0.1.5-alpha",
44
+ "brustjs-darwin-arm64": "0.1.5-alpha",
45
+ "brustjs-linux-x64-gnu": "0.1.5-alpha",
46
+ "brustjs-linux-arm64-gnu": "0.1.5-alpha",
47
+ "brustjs-linux-x64-musl": "0.1.5-alpha",
48
+ "brustjs-linux-arm64-musl": "0.1.5-alpha"
49
49
  },
50
50
  "peerDependencies": {
51
51
  "react": "^19.2.6",
package/runtime/cli/native-routes-emit.ts CHANGED
@@ -1,7 +1,29 @@
1
1
  import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
2
2
  import { dirname, resolve } from 'node:path'
3
+ import { buildDevClientTag } from '../dev/client.ts'
3
4
  import { ISLANDS_IMPORTMAP_AND_BOOTSTRAP } from '../islands/importmap.ts'
4
5
 
6
+ /** Dev-only: splice the /_brust/dev WS client `<script>` into a compiled native
7
+ * template so `native: true` (jinja) routes auto-reload like React-SSR routes.
8
+ *
9
+ * Native routes render Rust-side on the fast lane, bypassing the React renderer
10
+ * that injects the dev client (runtime/render/stream.ts) — so without this the
11
+ * browser on a native page never opens the dev WS and can never auto-reload.
12
+ *
13
+ * Inserted before the first `</head>` when the page has one (a `<BrustPage>`
14
+ * shell); otherwise appended (bare-fragment pages like a plain `<div>`). The
15
+ * browser executes the module script in either position. Gated on `BRUST_DEV`
16
+ * so `brust build` never bakes it into production templates. */
17
+ function injectDevClientIntoTemplate(template: string): string {
18
+ const tag = buildDevClientTag()
19
+ if (template.includes(tag)) return template // idempotent across re-emits
20
+ const headClose = template.indexOf('</head>')
21
+ if (headClose !== -1) {
22
+ return template.slice(0, headClose) + tag + template.slice(headClose)
23
+ }
24
+ return template + tag
25
+ }
26
+
5
27
  /** Sub-project J — build pass that turns user's `pages/<Name>.tsx` files into
6
28
  * `.brust/jinja/<Name>.jinja` templates. Invoked from `brust build` and
7
29
  * `brust dev` after the user's routes are flattened.
@@ -85,7 +107,14 @@ export async function emitNativeTemplates(opts: NativeRouteEmitOpts): Promise<vo
85
107
  } catch (e) {
86
108
  throw new Error(`native route "${name}" failed to compile (${sourcePath}):\n${String(e)}`)
87
109
  }
88
- writeFileSync(outPath, compiled.template)
110
+ // Dev-only: native routes don't pass through the React renderer's dev-client
111
+ // injection, so splice the /_brust/dev WS script in here. reEmitJinja() runs
112
+ // this on every hot reload, so the script is always present in dev.
113
+ const template =
114
+ process.env.BRUST_DEV === '1'
115
+ ? injectDevClientIntoTemplate(compiled.template)
116
+ : compiled.template
117
+ writeFileSync(outPath, template)
89
118
  built.push(name)
90
119
 
91
120
  // Islands post-processing. The compiler reports an island manifest ONLY
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
- /** TCP port to bind on. Default 3000. */
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 DEFAULT_PORT = 3000
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): defaults < TOML < env.
45
+ * Resolve Brust configuration. Precedence (low → high):
46
+ * framework defaults < caller `defaults` < TOML < env.
35
47
  *
36
- * - Defaults: { port: 3000, workers: availableParallelism() }
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 and BRUST_WORKERS override either source.
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(cwd: string = process.cwd()): Promise<BrustConfig> {
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 port = fromEnv.port ?? fromToml.port ?? DEFAULT_PORT
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/dev/ws-channel.ts CHANGED
@@ -81,19 +81,18 @@ export function installWorkerBroadcastListener(): void {
81
81
  }
82
82
  }
83
83
 
84
- /** Main-side: relay the message to every worker via postMessage. Each
85
- * worker's installed message listener forwards to its local clients.
86
- * Per-worker postMessage failures are swallowed (worker may be already
87
- * terminating). */
84
+ /** Main-side: push the message to every `/_brust/dev` client through the napi
85
+ * addon. The dev WS is a Rust-owned control channel (see the `/_brust/dev`
86
+ * branch in crates/brust/src/server.rs), so the frame is delivered straight
87
+ * through each connection's Rust-owned send_tx and SURVIVES a hot reload's
88
+ * worker restart.
89
+ *
90
+ * The previous implementation relayed main→worker→worker-local-clients, which
91
+ * lost the `reload` frame: the coordinator broadcasts it AFTER terminateAll(),
92
+ * by which point the connection's worker-side registration had died with the
93
+ * old worker. */
88
94
  export async function broadcast(msg: DevMessage): Promise<void> {
89
95
  const json = JSON.stringify(msg)
90
- const { _workersForTests } = await import('./worker-registry.ts')
91
- const workers = _workersForTests()
92
- for (const w of workers) {
93
- try {
94
- w.postMessage({ type: 'dev-broadcast', json })
95
- } catch {
96
- /* worker already terminated; drop */
97
- }
98
- }
96
+ const native = await import('../index.js')
97
+ ;(native as { napiDevBroadcast?: (json: string) => void }).napiDevBroadcast?.(json)
99
98
  }
package/runtime/index.d.ts CHANGED
@@ -29,6 +29,18 @@ export interface NapiCompiledJsx {
29
29
  islandsJson: string
30
30
  }
31
31
 
32
+ /**
33
+ * Dev-mode: broadcast one JSON control frame (building / reload / css-update /
34
+ * error / ok) to every connected `/_brust/dev` client. Called from the main
35
+ * thread by the dev coordinator. A no-op when no dev client is connected.
36
+ *
37
+ * Delivery goes straight through each connection's Rust-owned `send_tx`, so it
38
+ * survives a hot reload's worker restart — unlike the old worker-relay path,
39
+ * which lost the `reload` frame because the terminated worker took the client
40
+ * registration with it.
41
+ */
42
+ export declare function napiDevBroadcast(json: string): void
43
+
32
44
  /**
33
45
  * Sub-project J — boot-time listing of registered minijinja templates.
34
46
  * JS dispatcher uses this to validate every `native: true` route's
@@ -201,6 +213,11 @@ export declare function registerRoutes(configs: Array<string>): NapiResult<numbe
201
213
  export declare function resetWorkerPool(): number
202
214
 
203
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
204
221
  port: number
205
222
  workers: number
206
223
  entry: string
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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
80
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
96
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
117
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
133
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
150
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
166
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
185
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
201
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
217
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
237
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
253
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
274
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
290
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
308
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
324
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
342
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
358
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
376
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
392
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
410
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
426
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
443
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
459
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
479
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
495
+ if (bindingPackageVersion !== '0.1.5-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.5-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.3-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.3-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
511
+ if (bindingPackageVersion !== '0.1.5-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.5-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
513
513
  }
514
514
  return binding
515
515
  } catch (e) {
@@ -582,6 +582,7 @@ module.exports.configureCache = nativeBinding.configureCache
582
582
  module.exports.configureCssDir = nativeBinding.configureCssDir
583
583
  module.exports.configureIslandsDir = nativeBinding.configureIslandsDir
584
584
  module.exports.isWorker = nativeBinding.isWorker
585
+ module.exports.napiDevBroadcast = nativeBinding.napiDevBroadcast
585
586
  module.exports.napiListNativeTemplates = nativeBinding.napiListNativeTemplates
586
587
  module.exports.napiLoadJinjaTemplates = nativeBinding.napiLoadJinjaTemplates
587
588
  module.exports.napiRegisterSsePaths = nativeBinding.napiRegisterSsePaths
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
@@ -101,6 +104,7 @@ export const brust = {
101
104
  registerActionsInternal(opts.actions)
102
105
  }
103
106
  ;(native as any).beginServe({
107
+ host: opts.host,
104
108
  port: opts.port,
105
109
  workers: opts.workers,
106
110
  entry: opts.entry,
@@ -257,6 +261,13 @@ export const brust = {
257
261
  routes: import('./routes.ts').FlatRoute[]
258
262
  entry: string
259
263
  scanRoot?: string
264
+ /** Host/address to bind on. Default `localhost`. A `brust dev --port` /
265
+ * BRUST_PORT / BRUST_ADDR / brust.toml all override this app-level value
266
+ * (precedence: env > toml > this > framework default). */
267
+ address?: string
268
+ /** TCP port to bind on. Default 1337. Overridable by env/toml — see
269
+ * `address`. */
270
+ port?: number
260
271
  /** Overrides merged into the underlying `serve()` call (main thread). */
261
272
  serve?: Partial<Omit<ServeOptions, 'entry' | 'actions' | 'mcp'>>
262
273
  /** Per-worker SAB size in bytes. Default 256 KB. */
@@ -293,7 +304,10 @@ export const brust = {
293
304
  const { actions, sourceFiles } = await this.scanActions({ roots: [scanRoot] })
294
305
 
295
306
  if (!isWorker) {
296
- const { port, workers, cacheMaxEntries } = await loadConfig()
307
+ const { host, port, workers, cacheMaxEntries } = await loadConfig(process.cwd(), {
308
+ host: opts.address,
309
+ port: opts.port,
310
+ })
297
311
  console.log(`[brust] main: spawning ${workers} worker threads`)
298
312
  if (cacheMaxEntries !== undefined) this.configureCache({ maxEntries: cacheMaxEntries })
299
313
 
@@ -529,6 +543,7 @@ export const brust = {
529
543
  }
530
544
 
531
545
  await this.serve({
546
+ host,
532
547
  port,
533
548
  workers,
534
549
  entry: opts.entry,