zosenlink-node-client 1.0.0

package/README.md

@@ -0,0 +1,69 @@
+# ZosenLink Node Client
+
+`zosenlink-node-client` is a minimal managed frpc wrapper for Node.js hosts. It accepts exactly one positional argument: the activation key.
+
+```bash
+./zosenlink-node-client <activation-key>
+```
+
+The platform URL is fixed to `http://39.106.140.106`. Runtime status events are emitted to stdout as JSON Lines, one object per line, so Node.js can listen to `child.stdout`.
+
+Example:
+
+```js
+import { spawn } from "node:child_process";
+
+const child = spawn("./zosenlink-node-client", ["dev-activation-key"]);
+
+child.stdout.on("data", (chunk) => {
+  for (const line of chunk.toString().trim().split("\n")) {
+    if (!line) continue;
+    console.log(JSON.parse(line));
+  }
+});
+
+child.stderr.on("data", (chunk) => {
+  console.error(chunk.toString());
+});
+```
+
+NPM wrapper example:
+
+```js
+const { startZosenLinkClient } = require("zosenlink-node-client");
+
+const child = startZosenLinkClient("dev-activation-key", {
+  onEvent(event) {
+    console.log(event);
+  }
+});
+
+child.stderr.on("data", (chunk) => {
+  process.stderr.write(chunk);
+});
+```
+
+The npm package expects platform binaries under:
+
+```text
+bin/
+  darwin-arm64/zosenlink-node-client
+  darwin-x64/zosenlink-node-client
+  linux-x64/zosenlink-node-client
+  win32-x64/zosenlink-node-client.exe
+```
+
+Build examples:
+
+```bash
+cd apps/zosenlink-node-client
+GOOS=darwin GOARCH=arm64 CGO_ENABLED=0 go build -trimpath -ldflags='-s -w' -o bin/darwin-arm64/zosenlink-node-client .
+GOOS=darwin GOARCH=amd64 CGO_ENABLED=0 go build -trimpath -ldflags='-s -w' -o bin/darwin-x64/zosenlink-node-client .
+GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -trimpath -ldflags='-s -w' -o bin/linux-x64/zosenlink-node-client .
+GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -trimpath -ldflags='-s -w' -o bin/win32-x64/zosenlink-node-client.exe .
+
+# Optional artifact build path used by the repo:
+go build -trimpath -ldflags='-s -w' -o ../../artifacts/zosenlink-node-client-darwin-arm64/zosenlink-node-client .
+GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -trimpath -ldflags='-s -w' -o ../../artifacts/zosenlink-node-client-linux-amd64/zosenlink-node-client .
+GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -trimpath -ldflags='-s -w' -o ../../artifacts/zosenlink-node-client-win64/zosenlink-node-client.exe .
+```

package/bin/README.md

@@ -0,0 +1,13 @@
+# Platform Binaries
+
+Place built `zosenlink-node-client` binaries in platform-specific folders:
+
+```text
+bin/
+  darwin-arm64/zosenlink-node-client
+  darwin-x64/zosenlink-node-client
+  linux-x64/zosenlink-node-client
+  win32-x64/zosenlink-node-client.exe
+```
+
+`index.js` resolves the executable from `process.platform` and `process.arch`.

package/index.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { execFileSync, spawn } = require("node:child_process");
+
+const ARCH_MAP = {
+  x64: "x64",
+  arm64: "arm64"
+};
+
+function platformKey(platform = process.platform, arch = process.arch) {
+  return `${platform}-${ARCH_MAP[arch] || arch}`;
+}
+
+function executableName(platform = process.platform) {
+  return platform === "win32" ? "zosenlink-node-client.exe" : "zosenlink-node-client";
+}
+
+function executablePath(options = {}) {
+  const platform = options.platform || process.platform;
+  const arch = options.arch || process.arch;
+  return path.join(__dirname, "bin", platformKey(platform, arch), executableName(platform));
+}
+
+function assertActivationKey(activationKey) {
+  const key = String(activationKey || "").trim();
+  if (!key) {
+    throw new Error("activationKey is required");
+  }
+  return key;
+}
+
+function assertExecutable(file) {
+  if (!fs.existsSync(file)) {
+    throw new Error(`Missing zosenlink-node-client binary: ${file}`);
+  }
+  if (process.platform !== "win32") {
+    fs.chmodSync(file, 0o755);
+  }
+  if (process.platform === "darwin") {
+    removeMacQuarantine(file);
+  }
+}
+
+function removeMacQuarantine(file) {
+  try {
+    execFileSync("/usr/bin/xattr", ["-p", "com.apple.quarantine", file], {
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+  } catch (error) {
+    if (error && (error.status === 1 || error.code === 1)) return;
+    throw error;
+  }
+
+  try {
+    execFileSync("/usr/bin/xattr", ["-d", "com.apple.quarantine", file], {
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+  } catch (error) {
+    if (error && (error.status === 1 || error.code === 1)) return;
+    throw error;
+  }
+}
+
+function startZosenLinkClient(activationKey, options = {}) {
+  const key = assertActivationKey(activationKey);
+  const file = options.executable || executablePath(options);
+  assertExecutable(file);
+
+  const child = spawn(file, [key], {
+    cwd: path.dirname(file),
+    windowsHide: true,
+    stdio: ["ignore", "pipe", "pipe"],
+    ...options.spawn
+  });
+
+  if (typeof options.onEvent === "function") {
+    let stdoutBuffer = "";
+    child.stdout.on("data", (chunk) => {
+      stdoutBuffer += chunk.toString("utf8");
+      let index = stdoutBuffer.indexOf("\n");
+      while (index >= 0) {
+        const line = stdoutBuffer.slice(0, index).trim();
+        stdoutBuffer = stdoutBuffer.slice(index + 1);
+        if (line) {
+          options.onEvent(JSON.parse(line));
+        }
+        index = stdoutBuffer.indexOf("\n");
+      }
+    });
+  }
+
+  return child;
+}
+
+module.exports = {
+  executablePath,
+  platformKey,
+  startZosenLinkClient
+};
+
+if (require.main === module) {
+  const activationKey = process.argv[2];
+  const child = startZosenLinkClient(activationKey, {
+    onEvent(event) {
+      console.log("[zosenlink]", event);
+    }
+  });
+
+  child.stderr.on("data", (chunk) => {
+    process.stderr.write(chunk);
+  });
+
+  child.on("exit", (code, signal) => {
+    console.log(`zosenlink-node-client exited: ${code ?? signal}`);
+  });
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "zosenlink-node-client",
+  "version": "1.0.0",
+  "description": "Node.js wrapper for the ZosenLink managed frpc client.",
+  "main": "index.js",
+  "bin": {
+    "zosenlink-node-client": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "bin/README.md",
+    "bin/darwin-arm64/zosenlink-node-client",
+    "bin/darwin-x64/zosenlink-node-client",
+    "bin/linux-x64/zosenlink-node-client",
+    "bin/win32-x64/zosenlink-node-client.exe"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "license": "UNLICENSED"
+}