@jixo/opendweb-server-binary 0.0.0 → 0.1.0

package/bin/dweb-server.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+// dweb-server CLI 入口：转发参数与信号到平台二进制
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+const binDir = path.dirname(fileURLToPath(import.meta.url));
+
+const PLATFORM_BINARIES = {
+  "darwin-arm64": "dweb-server-aarch64-apple-darwin",
+  "win32-x64": "dweb-server-x86_64-pc-windows.exe",
+};
+const SUPPORTED = `${process.platform}-${process.arch}`;
+const BINARY_NAME = PLATFORM_BINARIES[SUPPORTED];
+if (!BINARY_NAME) {
+  console.error(
+    `@jixo/opendweb-server-binary: 当前平台 ${SUPPORTED} 暂不支持。v0.1 提供 ${Object.keys(PLATFORM_BINARIES).join(" / ")}；其它平台请使用 docker 镜像 ghcr.io/gaubee/dweb。`,
+  );
+  process.exit(1);
+}
+
+const binPath = path.join(binDir, BINARY_NAME);
+const child = spawn(binPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env,
+});
+
+const forward = (sig) => () => {
+  if (!child.killed) child.kill(sig);
+};
+process.on("SIGINT", forward("SIGINT"));
+process.on("SIGTERM", forward("SIGTERM"));
+child.on("exit", (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  else process.exit(code ?? 0);
+});

package/index.d.ts

@@ -0,0 +1,20 @@
+export interface StartServerOptions {
+  /** rendezvous/healthz 监听地址，默认 127.0.0.1:8787 */
+  httpBind?: string;
+  /** relay HTTP 监听地址，默认 127.0.0.1:3340 */
+  relayBind?: string;
+  /** 默认 true */
+  relayEnabled?: boolean;
+}
+
+export interface ServerHandle {
+  pid: number;
+  httpUrl: string;
+  relayHttpUrl: string;
+  /** 发送 SIGINT 并等待退出（5s 后 SIGKILL 兜底），幂等 */
+  stop(): Promise<void>;
+  /** 进程退出码 future */
+  exited: Promise<number>;
+}
+
+export declare function startServer(options?: StartServerOptions): Promise<ServerHandle>;

package/index.js

@@ -1 +1,91 @@
-module.exports = {};
+// @dweb/server-binary：以子进程方式启动 dweb-server，提供可等待的停止方式
+import { spawn } from "node:child_process";
+import { createHash } from "node:crypto";
+import { fileURLToPath } from "node:url";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+const PLATFORM_BINARIES = {
+  "darwin-arm64": "dweb-server-aarch64-apple-darwin",
+  "win32-x64": "dweb-server-x86_64-pc-windows.exe",
+};
+const SUPPORTED = `${process.platform}-${process.arch}`;
+const BINARY_NAME = PLATFORM_BINARIES[SUPPORTED];
+if (!BINARY_NAME) {
+  throw new Error(
+    `@jixo/opendweb-server-binary: 当前平台 ${SUPPORTED} 暂不支持。v0.1 提供 ${Object.keys(PLATFORM_BINARIES).join(" / ")}；其它平台请使用 docker 镜像 ghcr.io/gaubee/dweb。`,
+  );
+}
+
+/**
+ * @typedef {Object} StartServerOptions
+ * @property {string} [httpBind]   rendezvous/healthz 监听地址，默认 127.0.0.1:8787
+ * @property {string} [relayBind]  relay HTTP 监听地址，默认 127.0.0.1:3340
+ * @property {boolean} [relayEnabled] 默认 true
+ */
+
+/**
+ * 启动 dweb-server 子进程。
+ * @param {StartServerOptions} [options]
+ * @returns {Promise<{ pid: number, httpUrl: string, relayHttpUrl: string, stop: () => Promise<void>, exited: Promise<number> }>}
+ */
+export async function startServer(options = {}) {
+  const binDir = path.dirname(fileURLToPath(import.meta.url));
+  const srcBin = path.join(binDir, "bin", BINARY_NAME);
+  // SMB 网络磁盘（开发机）上的原生二进制会触发 CODESIGNING Invalid Page：
+  // darwin 拷到私有 tmp 内容寻址路径执行。Windows 无此问题且 tmp 无扩展名
+  // 拷贝会被 Defender/路径解析干扰——直接执行源路径。
+  let binPath = srcBin;
+  if (process.platform === "darwin") {
+    try {
+      const buf = fs.readFileSync(srcBin);
+      const hash = createHash("sha256").update(buf).digest("hex").slice(0, 24);
+      const dir = fs.mkdtempSync(path.join(os.tmpdir(), "opendweb-server-"));
+      const dest = path.join(dir, hash);
+      const fd = fs.openSync(dest, fs.constants.O_CREAT | fs.constants.O_EXCL | fs.constants.O_WRONLY, 0o755);
+      try {
+        fs.writeFileSync(fd, buf);
+        fs.fsyncSync(fd);
+      } finally {
+        fs.closeSync(fd);
+      }
+      binPath = dest;
+    } catch {
+      binPath = srcBin; // 退回直接执行源路径
+    }
+  }
+
+  const httpBind = options.httpBind ?? "127.0.0.1:8787";
+  const relayBind = options.relayBind ?? "127.0.0.1:3340";
+  const env = {
+    ...process.env,
+    DWEB_HTTP_BIND: httpBind,
+    DWEB_RELAY_HTTP_BIND: relayBind,
+    DWEB_RELAY_ENABLED: options.relayEnabled === false ? "false" : "true",
+  };
+
+  const child = spawn(binPath, [], { env, stdio: ["ignore", "pipe", "pipe"] });
+  if (typeof child.pid !== "number") {
+    throw new Error("failed to spawn dweb-server");
+  }
+
+  const exited = new Promise((resolve, reject) => {
+    child.once("exit", (code) => resolve(code ?? 0));
+    child.once("error", reject);
+  });
+
+  const stop = () =>
+    new Promise((resolve) => {
+      if (child.exitCode !== null || child.signalCode !== null) return resolve();
+      child.once("exit", () => resolve());
+      child.kill("SIGINT");
+      setTimeout(() => {
+        if (child.exitCode === null && child.signalCode === null) child.kill("SIGKILL");
+      }, 5000).unref();
+    });
+
+  const httpUrl = `http://${httpBind}`;
+  const relayHttpUrl = `http://${relayBind}`;
+  return { pid: child.pid, httpUrl, relayHttpUrl, stop, exited };
+}

package/package.json

@@ -1,9 +1,34 @@
 {
   "name": "@jixo/opendweb-server-binary",
-  "version": "0.0.0",
-  "description": "Generated placeholder package reserved by pnpm-pub.",
+  "version": "0.1.0",
+  "description": "@jixo/opendweb-server-binary — dweb self-hostable server binary (darwin-arm64 + win32-x64)",
+  "license": "MIT OR Apache-2.0",
+  "bin": {
+    "dweb-server": "./bin/dweb-server.mjs"
+  },
   "main": "index.js",
+  "types": "index.d.ts",
+  "type": "module",
+  "scripts": {
+    "pack:binary": "node scripts/pack.mjs",
+    "test": "node scripts/pack.mjs && node --test --test-force-exit",
+    "typecheck": "tsc --noEmit",
+    "build:win": "PATH=\"$HOME/.cargo/bin:$PATH\" cargo build --release --target x86_64-pc-windows-gnu -p dweb-server && cp \"$HOME/.cargo-target/dweb/x86_64-pc-windows-gnu/release/dweb-server.exe\" bin/dweb-server-x86_64-pc-windows.exe"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "vitest": "^3.0.0"
+  },
   "files": [
-    "index.js"
-  ]
+    "index.js",
+    "index.d.ts",
+    "bin/dweb-server.mjs",
+    "scripts/pack.mjs",
+    "bin/dweb-server-aarch64-apple-darwin",
+    "bin/dweb-server-x86_64-pc-windows-windows.exe"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Gaubee/dweb.git"
+  }
 }

package/scripts/pack.mjs

@@ -0,0 +1,73 @@
+// 平台感知的 release 二进制打包：从 cargo target 拷贝到包内 bin/。
+// darwin: build host target 产物 dweb-server → bin/dweb-server-aarch64-apple-darwin
+// windows: 优先复用 CI 已构建的 --target x86_64-pc-windows-msvc 产物（.exe）；
+//          staging 已放好 bin/dweb-server-x86_64-pc-windows.exe 时直接通过。
+import { spawnSync } from "node:child_process";
+import { cpSync, chmodSync, mkdirSync, existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const pkgDir = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
+const binDir = path.join(pkgDir, "bin");
+mkdirSync(binDir, { recursive: true });
+
+function findWorkspaceRoot() {
+  if (process.env.DWEB_ROOT) return process.env.DWEB_ROOT;
+  let dir = pkgDir;
+  for (let i = 0; i < 4; i++) {
+    if (existsSync(path.join(dir, "Cargo.toml"))) return dir;
+    dir = path.dirname(dir);
+  }
+  return null;
+}
+
+function resolveTargetDir() {
+  const raw = process.env.CARGO_TARGET_DIR ?? path.join(process.env.HOME ?? "~", ".cargo-target", "dweb");
+  return raw.replace(/^\$HOME/, process.env.HOME ?? "").replace(/^~/, process.env.HOME ?? "");
+}
+
+if (process.platform === "win32") {
+  const staged = path.join(binDir, "dweb-server-x86_64-pc-windows.exe");
+  if (existsSync(staged)) {
+    console.log("packed(win): bin/dweb-server-x86_64-pc-windows.exe (staged)");
+    process.exit(0);
+  }
+  // 本地 Windows 开发：构建 target 产物
+  const root = findWorkspaceRoot();
+  const targetDir = resolveTargetDir();
+  const src = path.join(targetDir, "x86_64-pc-windows-msvc", "release", "dweb-server.exe");
+  if (!existsSync(src)) {
+    if (root) {
+      const built = spawnSync("cargo", ["build", "--release", "--target", "x86_64-pc-windows-msvc", "-p", "dweb-server"], { stdio: "inherit", cwd: root });
+      if (built.status !== 0) throw new Error("cargo build failed");
+    }
+    if (!existsSync(src)) {
+      throw new Error(`windows binary not found at ${src} (no MSVC toolchain on non-windows hosts is expected; use CI staging)`);
+    }
+  }
+  cpSync(src, staged);
+  console.log(`packed(win): ${staged}`);
+  process.exit(0);
+}
+
+// darwin（host build）
+const root = findWorkspaceRoot();
+if (root) {
+  const built = spawnSync("cargo", ["build", "--release", "-p", "dweb-server"], {
+    stdio: "inherit",
+    cwd: root,
+  });
+  if (built.status !== 0) {
+    throw new Error("cargo build failed");
+  }
+}
+
+const targetDir = resolveTargetDir();
+const src = path.join(targetDir, "release", "dweb-server");
+if (!existsSync(src)) {
+  throw new Error(`binary not found at ${src}`);
+}
+const dest = path.join(binDir, "dweb-server-aarch64-apple-darwin");
+cpSync(src, dest);
+chmodSync(dest, 0o755);
+console.log("packed: bin/dweb-server-aarch64-apple-darwin");