@iotwork/scadactl 2.11.1-windows-arm64 → 2.11.1

package/README.md

@@ -0,0 +1,45 @@
+# scadactl npm packages
+
+该目录用于将 Go 编写的 `scadactl` 发布为跨平台 npm 命令行工具。
+
+## 安装
+
+```sh
+npm install --global @iotwork/scadactl
+scadactl -h
+```
+
+入口包 `@iotwork/scadactl` 本身只包含 Node.js 启动器。npm 会根据平台包中的 `os` 和 `cpu` 字段，仅安装当前系统对应的 optional dependency：
+
+| 构建目标 | npm `os` | npm `cpu` | optional dependency alias |
+| --- | --- | --- | --- |
+| `windows_amd64` | `win32` | `x64` | `@iotwork/scadactl-windows-amd64` |
+| `windows_arm64` | `win32` | `arm64` | `@iotwork/scadactl-windows-arm64` |
+| `linux_amd64` | `linux` | `x64` | `@iotwork/scadactl-linux-amd64` |
+| `linux_arm64` | `linux` | `arm64` | `@iotwork/scadactl-linux-arm64` |
+| `darwin_arm64` | `darwin` | `arm64` | `@iotwork/scadactl-darwin-arm64` |
+
+这些别名均指向同一个真实 npm 包名 `@iotwork/scadactl` 的平台预发布版本。例如 `@iotwork/scadactl-linux-amd64` 对应 `npm:@iotwork/scadactl@2.8.3-linux-amd64`。
+
+## 发布
+
+在本目录执行：
+
+```sh
+npm run set-version -- 2.8.3
+npm run check
+npm run build
+npm run pack:all
+npm run publish:all -- --dry-run
+npm run publish:all
+```
+
+`set-version` 只接受 `x.y.z` 格式，并同步更新入口包、五个平台包和所有 npm alias。`build` 使用 `CGO_ENABLED=0` 交叉编译五个平台，`pack:all` 将六个 tarball 写入 `dist/`。
+
+`publish:all` 先以 `platform` dist-tag 发布五个平台版本，最后发布入口包，并确保 `latest` 指向不带架构的入口版本（即使入口版本已发布）。发布前会查询目标 registry，自动跳过已存在的精确版本，因此中断后可以重新执行；查询遇到认证或网络等错误时会中止。`--dry-run` 也会执行查询并跳过已发布版本，但不会发布或修改 dist-tag。可以把 npm 参数继续传给脚本，例如：
+
+```sh
+npm run publish:all -- --registry=https://registry.example.com
+```
+
+平台二进制生成在 `packages/<target>/bin/`，打包产物生成在 `dist/`；两者都不会提交到 Git。

package/bin/scadactl.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { findTarget } from "../lib/targets.js";
+
+const require = createRequire(import.meta.url);
+const currentDirectory = path.dirname(fileURLToPath(import.meta.url));
+const target = findTarget();
+
+if (!target) {
+  throw new Error(`Unsupported platform: ${process.platform} (${process.arch})`);
+}
+
+function findExecutable() {
+  let packageRoot;
+  try {
+    const manifest = require.resolve(`${target.alias}/package.json`);
+    packageRoot = path.dirname(manifest);
+  } catch {
+    // Allow the launcher to run directly from this source tree after npm run build.
+    packageRoot = path.resolve(
+      currentDirectory,
+      "..",
+      "packages",
+      target.id,
+    );
+  }
+
+  const executable = path.join(packageRoot, "bin", target.executable);
+  if (existsSync(executable)) {
+    return executable;
+  }
+
+  throw new Error(
+    `Missing optional dependency ${target.alias}. Reinstall with: npm install --global @iotwork/scadactl@latest`,
+  );
+}
+
+const child = spawn(findExecutable(), process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+child.on("error", (error) => {
+  console.error(error);
+  process.exit(1);
+});
+
+for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  process.on(signal, () => {
+    if (!child.killed) {
+      child.kill(signal);
+    }
+  });
+}
+
+child.on("exit", (code, signal) => {
+  if (signal && process.platform !== "win32") {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 1);
+});

package/lib/targets.js

@@ -0,0 +1,55 @@
+export const targets = Object.freeze([
+  Object.freeze({
+    id: "windows_amd64",
+    alias: "@iotwork/scadactl-windows-amd64",
+    os: "win32",
+    cpu: "x64",
+    goos: "windows",
+    goarch: "amd64",
+    executable: "scadactl.exe",
+  }),
+  Object.freeze({
+    id: "windows_arm64",
+    alias: "@iotwork/scadactl-windows-arm64",
+    os: "win32",
+    cpu: "arm64",
+    goos: "windows",
+    goarch: "arm64",
+    executable: "scadactl.exe",
+  }),
+  Object.freeze({
+    id: "linux_amd64",
+    alias: "@iotwork/scadactl-linux-amd64",
+    os: "linux",
+    cpu: "x64",
+    goos: "linux",
+    goarch: "amd64",
+    executable: "scadactl",
+  }),
+  Object.freeze({
+    id: "linux_arm64",
+    alias: "@iotwork/scadactl-linux-arm64",
+    os: "linux",
+    cpu: "arm64",
+    goos: "linux",
+    goarch: "arm64",
+    executable: "scadactl",
+  }),
+  Object.freeze({
+    id: "darwin_arm64",
+    alias: "@iotwork/scadactl-darwin-arm64",
+    os: "darwin",
+    cpu: "arm64",
+    goos: "darwin",
+    goarch: "arm64",
+    executable: "scadactl",
+  }),
+]);
+
+export function findTarget(platform = process.platform, arch = process.arch) {
+  return targets.find((target) => target.os === platform && target.cpu === arch);
+}
+
+export function platformVersion(version, target) {
+  return `${version}-${target.id.replaceAll("_", "-")}`;
+}

package/package.json

@@ -1,22 +1,36 @@
 {
   "name": "@iotwork/scadactl",
-  "version": "2.11.1-windows-arm64",
-  "description": "scadactl binary for Windows ARM64",
+  "version": "2.11.1",
+  "description": "Command-line client for Shenkong SCADA",
   "license": "UNLICENSED",
   "homepage": "https://www.shenkong.cc",
-  "os": [
-    "win32"
-  ],
-  "cpu": [
-    "arm64"
-  ],
+  "type": "module",
+  "bin": {
+    "scadactl": "bin/scadactl.js"
+  },
   "files": [
-    "bin/scadactl.exe"
+    "bin",
+    "lib",
+    "README.md"
   ],
   "engines": {
     "node": ">=18"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "check": "node scripts/check.mjs",
+    "pack:all": "node scripts/pack.mjs",
+    "publish:all": "node scripts/publish.mjs",
+    "set-version": "node scripts/set-version.mjs"
+  },
+  "optionalDependencies": {
+    "@iotwork/scadactl-windows-amd64": "npm:@iotwork/scadactl@2.11.1-windows-amd64",
+    "@iotwork/scadactl-windows-arm64": "npm:@iotwork/scadactl@2.11.1-windows-arm64",
+    "@iotwork/scadactl-linux-amd64": "npm:@iotwork/scadactl@2.11.1-linux-amd64",
+    "@iotwork/scadactl-linux-arm64": "npm:@iotwork/scadactl@2.11.1-linux-arm64",
+    "@iotwork/scadactl-darwin-arm64": "npm:@iotwork/scadactl@2.11.1-darwin-arm64"
   }
 }