lonesome-js 0.1.0-beta-ee6d282

package/LICENSE.md

@@ -0,0 +1,7 @@
+Copyright 2026 K024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# lonesome-js
+
+High-performance programmable reverse proxy bindings for Node.js, built on top of Pingora.
+
+[中文文档 (README.zh.md)](./README.zh.md)
+
+## Why lonesome-js
+
+- Built on Pingora for modern async proxy performance and reliability.
+- Runtime route updates (`addOrUpdate`) with Node.js without process restarts.
+- Request matching and middleware conditions powered by CEL expressions.
+- `virtual_js` upstream mode for in-process Node.js service composition.
+
+## How It Differs From Traditional Reverse Proxies
+
+Most reverse proxies focus on static config files and process-level reload workflows. `lonesome-js` is designed around a runtime API and programmable request flow.
+
+### CEL-Driven Routing and Middleware Logic
+
+Instead of limiting logic to fixed directives, routes and middleware conditions can use CEL expressions for matching and value generation.
+
+Examples:
+- Route match: `"Method('POST') && PathPrefix('/api') && Query('debug', '1')"`
+- Conditional middleware: `rule: "Header('x-env', 'prod')"`
+- Dynamic value: `expression: "MethodValue() + '-' + QueryValue('id')"`
+
+### `virtual_js` Upstreams
+
+Beyond TCP/Unix socket upstreams, `virtual_js` allows requests to be bridged into JavaScript handlers in-process. This makes it possible to build internal adapters and programmable backends without opening extra network ports.
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm i lonesome-js
+```
+
+### 2. Start a proxy server
+
+```ts
+import { LonesomeServer } from 'lonesome-js'
+
+const server = new LonesomeServer()
+
+server.start({
+  listeners: [{ kind: 'tcp', addr: '127.0.0.1:8080' }],
+})
+```
+
+### 3. Add a basic route
+
+```ts
+server.addOrUpdate({
+  id: 'basic-proxy',
+  matcher: { rule: "PathPrefix('/api')", priority: 50 },
+  middlewares: [],
+  upstreams: [
+    { kind: 'tcp', address: '127.0.0.1:9000' },
+  ],
+  loadBalancer: { algorithm: 'round_robin' },
+})
+```
+
+### 4. Hot-update the route at runtime
+
+```ts
+server.addOrUpdate({
+  id: 'basic-proxy',
+  matcher: { rule: "PathPrefix('/api')", priority: 50 },
+  middlewares: [{ type: 'respond', config: { status: 418, body: 'teapot' } }],
+  upstreams: [
+    { kind: 'tcp', address: '127.0.0.1:9000' },
+  ],
+})
+```
+
+## Documentation
+
+- Docs index and LonesomeServer control API: [docs/readme.md](./docs/readme.md)
+- Route lifecycle and hot updates: [docs/route.md](./docs/route.md)
+- CEL expressions: [docs/cel.md](./docs/cel.md)
+- `virtual_js` upstreams: [docs/virtual_js.md](./docs/virtual_js.md)
+- Middlewares: *TODO*

package/README.zh.md

@@ -0,0 +1,86 @@
+# lonesome-js
+
+基于 Pingora 的 Node.js 高性能可编程反向代理绑定。
+
+[English README](./README.md)
+
+## 为什么使用 lonesome-js
+
+- 基于 Pingora，具备现代异步代理的性能与稳定性基础。
+- 通过 `addOrUpdate` 支持 Node.js 运行时路由热更新，无需重启进程。
+- 路由匹配与中间件条件由 CEL 表达式驱动。
+- 提供 `virtual_js` upstream，可在进程内接入 Node.js 处理链路。
+
+## 与传统反向代理的设计差异
+
+多数传统反向代理偏向静态配置文件与 reload 流程；`lonesome-js` 更偏向运行时 API 与可编程流量编排。
+
+### 基于 CEL 的匹配与逻辑表达
+
+路由规则、中间件条件和动态值都可以通过 CEL 表达式描述，而不是只能依赖固定指令。
+
+示例：
+- 路由匹配：`"Method('POST') && PathPrefix('/api') && Query('debug', '1')"`
+- 条件中间件：`rule: "Header('x-env', 'prod')"`
+- 动态值：`expression: "MethodValue() + '-' + QueryValue('id')"`
+
+### `virtual_js` 上游能力
+
+除 TCP/Unix socket upstream 外，`virtual_js` 可以把请求桥接到进程内 JavaScript handler。适合构建内部适配层或可编程后端，无需额外暴露网络端口。
+
+## 快速开始
+
+### 1. 安装
+
+```bash
+npm i lonesome-js
+```
+
+### 2. 启动代理服务
+
+```ts
+import { LonesomeServer } from 'lonesome-js'
+
+const server = new LonesomeServer()
+
+server.start({
+  listeners: [{ kind: 'tcp', addr: '127.0.0.1:8080' }],
+})
+```
+
+### 3. 添加基础路由
+
+```ts
+server.addOrUpdate({
+  id: 'basic-proxy',
+  matcher: { rule: "PathPrefix('/api')", priority: 50 },
+  middlewares: [],
+  upstreams: [
+    { kind: 'tcp', address: '127.0.0.1:9000', tls: false, sni: '', weight: 1 },
+  ],
+  loadBalancer: { algorithm: 'round_robin' },
+})
+```
+
+### 4. 运行时热更新路由
+
+```ts
+server.addOrUpdate({
+  id: 'basic-proxy',
+  matcher: { rule: "PathPrefix('/api')", priority: 50 },
+  middlewares: [{ type: 'respond', config: { status: 418, body: 'teapot' } }],
+  upstreams: [
+    { kind: 'tcp', address: '127.0.0.1:9000', tls: false, sni: '', weight: 1 },
+  ],
+})
+```
+
+## 文档
+
+以下 `docs/` 文档当前为英文：
+
+- 文档总览与 LonesomeServer 控制 API: [docs/readme.md](./docs/readme.md)
+- 路由管理与热更新: [docs/route.md](./docs/route.md)
+- CEL 表达式: [docs/cel.md](./docs/cel.md)
+- `virtual_js` upstream: [docs/virtual_js.md](./docs/virtual_js.md)
+- 中间件：*TODO*

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+export declare class LonesomeServer {
+  constructor()
+  start(startup: StartupConfig): void
+  stop(): void
+  addOrUpdate(route: RouteConfig): void
+  remove(routeId: string): boolean
+  status(): ServerStatus
+}
+
+export interface LoadBalancerConfig {
+  algorithm?: string
+  maxIterations?: number
+  hashKeyRule?: string
+}
+
+export interface MiddlewareConfig {
+  type: string
+  config: any
+}
+
+export declare function purgeRouteCache(routeId: string): Promise<void>
+
+export declare function registerVirtualListener(key: string, onEvent: (arg0: string, arg1: string, arg2: Buffer) => void): void
+
+export interface RouteConfig {
+  id: string
+  matcher: RouteMatcherConfig
+  middlewares: Array<MiddlewareConfig>
+  upstreams: Array<UpstreamConfig>
+  loadBalancer?: LoadBalancerConfig
+}
+
+export interface RouteMatcherConfig {
+  rule: string
+  priority?: number
+}
+
+export interface ServerStatus {
+  running: boolean
+  routeCount: number
+}
+
+export interface StartupConfig {
+  threads?: number
+  workStealing?: boolean
+  listeners: StartupListenerConfig[]
+}
+
+export interface StartupListenerConfig {
+  kind: 'tcp' | 'tls' | 'unix'
+  addr: string
+  certPath?: string
+  keyPath?: string
+}
+
+export declare function unregisterVirtualListener(key: string): boolean
+
+export interface UpstreamConfig {
+  kind?: 'tcp' | 'unix' | 'virtual_js'
+  address: string
+  tls?: boolean
+  h2c?: boolean
+  sni?: string
+  weight?: number
+}
+
+export declare function virtualPushEvent(kind: string, connId: string, data?: Buffer | undefined | null, message?: string | undefined | null): void

package/dist/index.js

@@ -0,0 +1,587 @@
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+import { createRequire } from 'node:module'
+const require = createRequire(import.meta.url)
+const __dirname = new URL('.', import.meta.url).pathname
+
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (typeof process.report?.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
+      return true
+    }
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./lonesome-js.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-android-arm64')
+        const bindingPackageVersion = require('lonesome-js-android-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./lonesome-js.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-android-arm-eabi')
+        const bindingPackageVersion = require('lonesome-js-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+        try {
+        return require('./lonesome-js.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-win32-x64-gnu')
+        const bindingPackageVersion = require('lonesome-js-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./lonesome-js.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-win32-x64-msvc')
+        const bindingPackageVersion = require('lonesome-js-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./lonesome-js.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-win32-ia32-msvc')
+        const bindingPackageVersion = require('lonesome-js-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./lonesome-js.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-win32-arm64-msvc')
+        const bindingPackageVersion = require('lonesome-js-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./lonesome-js.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('lonesome-js-darwin-universal')
+      const bindingPackageVersion = require('lonesome-js-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./lonesome-js.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-darwin-x64')
+        const bindingPackageVersion = require('lonesome-js-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./lonesome-js.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-darwin-arm64')
+        const bindingPackageVersion = require('lonesome-js-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./lonesome-js.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-freebsd-x64')
+        const bindingPackageVersion = require('lonesome-js-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./lonesome-js.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-freebsd-arm64')
+        const bindingPackageVersion = require('lonesome-js-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./lonesome-js.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('lonesome-js-linux-x64-musl')
+          const bindingPackageVersion = require('lonesome-js-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./lonesome-js.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('lonesome-js-linux-x64-gnu')
+          const bindingPackageVersion = require('lonesome-js-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+          return require('./lonesome-js.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('lonesome-js-linux-arm64-musl')
+          const bindingPackageVersion = require('lonesome-js-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./lonesome-js.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('lonesome-js-linux-arm64-gnu')
+          const bindingPackageVersion = require('lonesome-js-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./lonesome-js.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('lonesome-js-linux-arm-musleabihf')
+          const bindingPackageVersion = require('lonesome-js-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./lonesome-js.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('lonesome-js-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('lonesome-js-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./lonesome-js.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('lonesome-js-linux-loong64-musl')
+          const bindingPackageVersion = require('lonesome-js-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./lonesome-js.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('lonesome-js-linux-loong64-gnu')
+          const bindingPackageVersion = require('lonesome-js-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./lonesome-js.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('lonesome-js-linux-riscv64-musl')
+          const bindingPackageVersion = require('lonesome-js-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./lonesome-js.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('lonesome-js-linux-riscv64-gnu')
+          const bindingPackageVersion = require('lonesome-js-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./lonesome-js.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-linux-ppc64-gnu')
+        const bindingPackageVersion = require('lonesome-js-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./lonesome-js.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-linux-s390x-gnu')
+        const bindingPackageVersion = require('lonesome-js-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./lonesome-js.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-openharmony-arm64')
+        const bindingPackageVersion = require('lonesome-js-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./lonesome-js.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-openharmony-x64')
+        const bindingPackageVersion = require('lonesome-js-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./lonesome-js.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('lonesome-js-openharmony-arm')
+        const bindingPackageVersion = require('lonesome-js-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./lonesome-js.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (process.env.NAPI_RS_FORCE_WASI) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+    try {
+      wasiBinding = require('lonesome-js-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (process.env.NAPI_RS_FORCE_WASI) {
+        if (!wasiBindingError) {
+          wasiBindingError = err
+        } else {
+          wasiBindingError.cause = err
+        }
+        loadErrors.push(err)
+      }
+    }
+  }
+  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
+    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
+    error.cause = wasiBindingError
+    throw error
+  }
+}
+
+if (!nativeBinding) {
+  if (loadErrors.length > 0) {
+    throw new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+      {
+        cause: loadErrors.reduce((err, cur) => {
+          cur.cause = err
+          return cur
+        }),
+      },
+    )
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { LonesomeServer, purgeRouteCache, registerVirtualListener, unregisterVirtualListener, virtualPushEvent } = nativeBinding
+export { LonesomeServer }
+export { purgeRouteCache }
+export { registerVirtualListener }
+export { unregisterVirtualListener }
+export { virtualPushEvent }

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "lonesome-js",
+  "version": "0.1.0-beta-ee6d282",
+  "type": "module",
+  "main": "dist/index.js",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "napi": {
+    "binaryName": "lonesome-js",
+    "targets": [
+      "aarch64-apple-darwin",
+      "x86_64-pc-windows-msvc",
+      "x86_64-unknown-linux-gnu"
+    ]
+  },
+  "files": [
+    "dist/"
+  ],
+  "engines": {
+    "node": ">= 12.22.0 < 13 || >= 14.17.0 < 15 || >= 15.12.0 < 16 || >= 16.0.0"
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "build": "napi build --esm --output-dir dist --platform --release",
+    "build:debug": "napi build --esm --output-dir dist --platform",
+    "bench:list-suites": "tsx bench/index.ts list-suites",
+    "bench:setup": "tsx bench/setup.ts start",
+    "bench": "tsx bench/index.ts run",
+    "version": "napi version",
+    "lint": "tsc -b --noEmit",
+    "test": "tsx --test 'e2e-test/**/*.test.ts'"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^3.6.0",
+    "@types/k6": "^1.7.0",
+    "@types/node": "^25.5.2",
+    "jose": "^6.2.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "zx": "^8.8.5"
+  }
+}