@xudesheng/conflu 0.2.0

package/README.md

@@ -0,0 +1,25 @@
+# @xudesheng/conflu
+
+`@xudesheng/conflu` is a thin npm wrapper for the native Conflu CLI binaries.
+
+It downloads the matching prebuilt binary from:
+
+- <https://github.com/xudesheng/conflu/releases>
+
+## Install
+
+```bash
+npm i -g @xudesheng/conflu
+```
+
+## Run
+
+```bash
+conflu --version
+```
+
+## npx
+
+```bash
+npx @xudesheng/conflu --version
+```

package/bin/conflu.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(__dirname, "..");
+const binaryName = process.platform === "win32" ? "conflu.exe" : "conflu";
+const binaryPath = path.join(packageRoot, ".conflu-bin", binaryName);
+
+if (!fs.existsSync(binaryPath)) {
+  console.error(
+    "[CNP006] Native Conflu binary is missing.\nHint: reinstall with `npm i -g @xudesheng/conflu`.",
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env,
+});
+
+if (result.error) {
+  console.error(
+    `[CNP006] Failed to launch native Conflu binary.\nHint: ${result.error.message}`,
+  );
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);

package/lib/diagnostics.mjs

@@ -0,0 +1,18 @@
+export class InstallError extends Error {
+  constructor(code, message, hint, cause) {
+    super(message);
+    this.name = "InstallError";
+    this.code = code;
+    this.hint = hint;
+    this.cause = cause;
+  }
+}
+
+export function toDiagnostic(err) {
+  if (err instanceof InstallError) {
+    return `[${err.code}] ${err.message}\nHint: ${err.hint}`;
+  }
+
+  const fallback = err && err.message ? err.message : String(err);
+  return `[CNP999] Unexpected installer failure\nHint: ${fallback}`;
+}

package/lib/install.mjs

@@ -0,0 +1,218 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import { createWriteStream } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+
+import AdmZip from "adm-zip";
+import * as tar from "tar";
+
+import { InstallError } from "./diagnostics.mjs";
+import { resolvePlatform } from "./platform.mjs";
+
+function releaseBase(version) {
+  if (process.env.CONFLU_NPM_RELEASE_BASE_URL) {
+    return `${process.env.CONFLU_NPM_RELEASE_BASE_URL}/v${version}`;
+  }
+  return `https://github.com/xudesheng/conflu/releases/download/v${version}`;
+}
+
+async function fetchText(url) {
+  try {
+    const res = await fetch(url);
+    if (!res.ok) {
+      throw new InstallError(
+        "CNP003",
+        `Failed to fetch checksum file: HTTP ${res.status}`,
+        "Verify that the target release exists and is public.",
+      );
+    }
+    return await res.text();
+  } catch (err) {
+    if (err instanceof InstallError) {
+      throw err;
+    }
+    throw new InstallError(
+      "CNP003",
+      "Failed to fetch checksum file.",
+      "Check network access and retry install.",
+      err,
+    );
+  }
+}
+
+async function downloadToFile(url, destPath) {
+  try {
+    const res = await fetch(url);
+    if (!res.ok || !res.body) {
+      throw new InstallError(
+        "CNP002",
+        `Failed to download binary archive: HTTP ${res.status}`,
+        "Verify release asset URL and retry install.",
+      );
+    }
+    await pipeline(Readable.fromWeb(res.body), createWriteStream(destPath));
+  } catch (err) {
+    if (err instanceof InstallError) {
+      throw err;
+    }
+    throw new InstallError(
+      "CNP002",
+      "Failed while streaming archive download.",
+      "Check network stability and retry install.",
+      err,
+    );
+  }
+}
+
+function parseChecksums(content) {
+  const map = new Map();
+  for (const rawLine of content.split("\n")) {
+    const line = rawLine.trim();
+    if (!line) {
+      continue;
+    }
+    const [hash, ...rest] = line.split(/\s+/);
+    const filename = rest.join(" ").trim();
+    if (hash && filename) {
+      map.set(filename, hash);
+    }
+  }
+  return map;
+}
+
+async function sha256File(filePath) {
+  const h = crypto.createHash("sha256");
+  const fd = await fs.open(filePath, "r");
+  try {
+    const buf = Buffer.allocUnsafe(1024 * 1024);
+    while (true) {
+      const { bytesRead } = await fd.read(buf, 0, buf.length, null);
+      if (bytesRead === 0) {
+        break;
+      }
+      h.update(buf.subarray(0, bytesRead));
+    }
+  } finally {
+    await fd.close();
+  }
+  return h.digest("hex");
+}
+
+async function extractArchive(archivePath, extractDir) {
+  if (archivePath.endsWith(".zip")) {
+    try {
+      const zip = new AdmZip(archivePath);
+      zip.extractAllTo(extractDir, true);
+      return;
+    } catch (err) {
+      throw new InstallError(
+        "CNP005",
+        "Failed to extract zip archive.",
+        "Check disk permissions and free space, then retry install.",
+        err,
+      );
+    }
+  }
+
+  if (archivePath.endsWith(".tar.gz")) {
+    try {
+      await tar.x({
+        file: archivePath,
+        cwd: extractDir,
+      });
+      return;
+    } catch (err) {
+      throw new InstallError(
+        "CNP005",
+        "Failed to extract tar.gz archive.",
+        "Check disk permissions and free space, then retry install.",
+        err,
+      );
+    }
+  }
+
+  throw new InstallError(
+    "CNP005",
+    `Unsupported archive format: ${archivePath}`,
+    "Please report this issue with release version and platform details.",
+  );
+}
+
+export async function installBinary(version, packageRoot) {
+  const resolved = resolvePlatform();
+  if (!resolved) {
+    throw new InstallError(
+      "CNP001",
+      `Unsupported platform: ${os.platform()}-${os.arch()}`,
+      "Install from GitHub Releases manually for this platform.",
+    );
+  }
+
+  const base = releaseBase(version);
+  const archiveName = `conflu-v${version}-${resolved.assetName}`;
+  const archiveUrl = `${base}/${archiveName}`;
+  const checksumsUrl = `${base}/conflu-v${version}-SHA256SUMS.txt`;
+
+  const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), "conflu-npm-"));
+  const archivePath = path.join(tempRoot, archiveName);
+  const extractDir = path.join(tempRoot, "extract");
+
+  try {
+    await fs.mkdir(extractDir, { recursive: true });
+    await downloadToFile(archiveUrl, archivePath);
+    const checksumsRaw = await fetchText(checksumsUrl);
+    const checksums = parseChecksums(checksumsRaw);
+    const expected = checksums.get(archiveName);
+    if (!expected) {
+      throw new InstallError(
+        "CNP004",
+        `Checksum entry missing for ${archiveName}`,
+        "Verify release assets include SHA256SUMS and retry.",
+      );
+    }
+
+    const actual = await sha256File(archivePath);
+    if (actual !== expected) {
+      throw new InstallError(
+        "CNP004",
+        `Checksum mismatch for ${archiveName}`,
+        "Release asset integrity check failed. Abort install and investigate release assets.",
+      );
+    }
+
+    await extractArchive(archivePath, extractDir);
+    const sourceBinary = path.join(extractDir, resolved.binaryName);
+    try {
+      await fs.stat(sourceBinary);
+    } catch (err) {
+      throw new InstallError(
+        "CNP005",
+        `Extracted archive does not contain ${resolved.binaryName}`,
+        "Release packaging is inconsistent. Check release artifacts.",
+        err,
+      );
+    }
+
+    const binDir = path.join(packageRoot, ".conflu-bin");
+    const targetBinary = path.join(binDir, resolved.binaryName);
+    await fs.mkdir(binDir, { recursive: true });
+    await fs.copyFile(sourceBinary, targetBinary);
+    if (resolved.binaryName !== "conflu.exe") {
+      try {
+        await fs.chmod(targetBinary, 0o755);
+      } catch (err) {
+        throw new InstallError(
+          "CNP007",
+          "Failed to set executable permission on conflu binary.",
+          "Check filesystem mount options and permissions, then retry install.",
+          err,
+        );
+      }
+    }
+  } finally {
+    await fs.rm(tempRoot, { recursive: true, force: true });
+  }
+}

package/lib/platform.mjs

@@ -0,0 +1,27 @@
+import os from "node:os";
+
+export function resolvePlatform() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  if (platform === "win32" && arch === "x64") {
+    return {
+      assetName: "windows-x64.zip",
+      binaryName: "conflu.exe",
+    };
+  }
+  if (platform === "linux" && arch === "x64") {
+    return {
+      assetName: "linux-x64-musl.tar.gz",
+      binaryName: "conflu",
+    };
+  }
+  if (platform === "darwin" && (arch === "x64" || arch === "arm64")) {
+    return {
+      assetName: "macos-universal.zip",
+      binaryName: "conflu",
+    };
+  }
+
+  return null;
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@xudesheng/conflu",
+  "version": "0.2.0",
+  "description": "Thin npm wrapper for Conflu native binaries",
+  "license": "MIT OR Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/desheng-io/conflu.git",
+    "directory": "distribution/npm-wrapper"
+  },
+  "homepage": "https://github.com/xudesheng/conflu",
+  "type": "module",
+  "bin": {
+    "conflu": "bin/conflu.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "scripts/",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "adm-zip": "^0.5.16",
+    "tar": "^7.4.3"
+  }
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,26 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { installBinary } from "../lib/install.mjs";
+import { toDiagnostic } from "../lib/diagnostics.mjs";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(__dirname, "..");
+
+if (process.env.CONFLU_NPM_SKIP_POSTINSTALL === "1") {
+  console.log("[CNP000] Skipping postinstall because CONFLU_NPM_SKIP_POSTINSTALL=1");
+  process.exit(0);
+}
+
+async function main() {
+  const pkgPath = path.join(packageRoot, "package.json");
+  const pkg = JSON.parse(await fs.readFile(pkgPath, "utf-8"));
+  await installBinary(pkg.version, packageRoot);
+  console.log(`[CNP000] Installed Conflu binary for @xudesheng/conflu@${pkg.version}`);
+}
+
+main().catch((err) => {
+  console.error(toDiagnostic(err));
+  process.exit(1);
+});