cwbridge 1.7.0

package/README.md

@@ -0,0 +1,30 @@
+# CWBridge
+
+CWBridge is a Windows command-line bridge for locally configured Roblox
+services. This npm package contains the compiled Windows executable and a
+minimal launcher; it does not include the Python source code.
+
+## Run
+
+```powershell
+npx --yes cwbridge
+```
+
+Pass normal CWBridge arguments after the command, for example:
+
+```powershell
+npx --yes cwbridge --version
+npx --yes cwbridge start --only weather
+```
+
+The launcher checks npm at most once every 24 hours and reports when a newer
+package is available. It does not update the executable automatically. Fetch
+the newest launcher with:
+
+```powershell
+npx --yes cwbridge@latest
+```
+
+Set `CWBRIDGE_NO_UPDATE_CHECK=1` to disable the launcher update check.
+
+This package is currently Windows x64 only.

package/bin/cwbridge.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("node:fs");
+const https = require("node:https");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const packageInfo = require("../package.json");
+const UPDATE_CHECK_MS = 24 * 60 * 60 * 1000;
+const UPDATE_TIMEOUT_MS = 900;
+
+function parseVersion(value) {
+  const match = /^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(String(value));
+  return match ? match.slice(1, 4).map(Number) : null;
+}
+
+function isNewerVersion(latest, current) {
+  const latestParts = parseVersion(latest);
+  const currentParts = parseVersion(current);
+  if (!latestParts || !currentParts) {
+    return false;
+  }
+  for (let index = 0; index < latestParts.length; index += 1) {
+    if (latestParts[index] !== currentParts[index]) {
+      return latestParts[index] > currentParts[index];
+    }
+  }
+  return false;
+}
+
+function cachePath() {
+  const base = process.env.LOCALAPPDATA || process.env.APPDATA;
+  return base ? path.join(base, "CWBridge", "npm-update-check.json") : null;
+}
+
+function readCachedLatest() {
+  const filename = cachePath();
+  if (!filename) {
+    return null;
+  }
+  try {
+    const cached = JSON.parse(fs.readFileSync(filename, "utf8"));
+    if (
+      cached.package === packageInfo.name &&
+      typeof cached.checkedAt === "number" &&
+      Date.now() - cached.checkedAt < UPDATE_CHECK_MS &&
+      typeof cached.latest === "string"
+    ) {
+      return cached.latest;
+    }
+  } catch {
+    // A missing or malformed cache must never prevent CWBridge from starting.
+  }
+  return null;
+}
+
+function writeCachedLatest(latest) {
+  const filename = cachePath();
+  if (!filename) {
+    return;
+  }
+  try {
+    fs.mkdirSync(path.dirname(filename), { recursive: true });
+    fs.writeFileSync(
+      filename,
+      JSON.stringify({ package: packageInfo.name, latest, checkedAt: Date.now() }),
+      "utf8",
+    );
+  } catch {
+    // The update cache is optional and must not affect command execution.
+  }
+}
+
+function fetchLatestVersion() {
+  return new Promise((resolve) => {
+    const request = https.get(
+      `https://registry.npmjs.org/${encodeURIComponent(packageInfo.name)}/latest`,
+      { headers: { Accept: "application/json", "User-Agent": "cwbridge-npx-launcher" } },
+      (response) => {
+        let body = "";
+        response.setEncoding("utf8");
+        response.on("data", (chunk) => {
+          body += chunk;
+        });
+        response.on("end", () => {
+          if (response.statusCode !== 200) {
+            resolve(null);
+            return;
+          }
+          try {
+            resolve(JSON.parse(body).version || null);
+          } catch {
+            resolve(null);
+          }
+        });
+      },
+    );
+    request.setTimeout(UPDATE_TIMEOUT_MS, () => request.destroy());
+    request.on("error", () => resolve(null));
+  });
+}
+
+async function reportAvailableUpdate() {
+  if (process.env.CWBRIDGE_NO_UPDATE_CHECK === "1") {
+    return;
+  }
+  const cachedLatest = readCachedLatest();
+  const latest = cachedLatest || (await fetchLatestVersion());
+  if (!latest) {
+    return;
+  }
+  if (!cachedLatest) {
+    writeCachedLatest(latest);
+  }
+  if (isNewerVersion(latest, packageInfo.version)) {
+    console.error(
+      `A newer CWBridge version is available: v${packageInfo.version} -> v${latest}\n` +
+        "Run: npx --yes cwbridge@latest",
+    );
+  }
+}
+
+async function main() {
+  if (process.platform !== "win32") {
+    console.error("CWBridge via npx currently supports Windows x64 only.");
+    process.exitCode = 1;
+    return;
+  }
+
+  const executable = path.join(__dirname, "cwbridge.exe");
+  if (!fs.existsSync(executable)) {
+    console.error("CWBridge executable is missing from this npm package.");
+    process.exitCode = 1;
+    return;
+  }
+
+  await reportAvailableUpdate();
+  const result = spawnSync(executable, process.argv.slice(2), {
+    stdio: "inherit",
+    windowsHide: false,
+  });
+  if (result.error) {
+    console.error(`Unable to start CWBridge: ${result.error.message}`);
+    process.exitCode = 1;
+    return;
+  }
+  process.exitCode = typeof result.status === "number" ? result.status : 1;
+}
+
+if (require.main === module) {
+  main().catch((error) => {
+    console.error(`CWBridge launcher failed: ${error.message}`);
+    process.exitCode = 1;
+  });
+}
+
+module.exports = { isNewerVersion, parseVersion };

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "cwbridge",
+  "version": "1.7.0",
+  "description": "Windows launcher for the compiled CWBridge executable",
+  "license": "UNLICENSED",
+  "private": false,
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "cwbridge": "bin/cwbridge.js"
+  },
+  "files": [
+    "bin/cwbridge.js",
+    "bin/cwbridge.exe",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}