jops-core 1.0.14 → 1.0.15

package/README.md

@@ -560,6 +560,8 @@ t.terminate();
 
 `init` and `update` accept `--cordova`, `--capacitor` or `--web` to override the detected project type.
 
+After each command the CLI checks npm for a newer jops-core and prints a notice if one is available (at most 1.5 s, silent when offline). `build` also warns if `lib/jops-core.min.js` doesn't match the installed version. Turn the check off with `--no-update-check` or `JOPS_NO_UPDATE_CHECK=1`; it is skipped automatically when `CI` is set.
+
 ---
 
 ## Source & Contributing

package/bin/init.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import fs from "fs";
+import https from "https";
 import path from "path";
 import readline from "readline";
 import { fileURLToPath } from "url";
@@ -14,10 +15,64 @@ if (command !== "init" && command !== "build" && command !== "update") {
   console.log("");
   console.log("Options (init, update):");
   console.log("  --cordova | --capacitor | --web   override the detected project type");
+  console.log("Options (all commands):");
+  console.log("  --no-update-check                 skip the check for a newer jops-core version");
   process.exit(0);
 }
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, "../package.json"), "utf8"));
+
+// ─── update check ────────────────────────────────────────────────────────────
+// Started now, awaited at the end, so it runs in parallel with the command.
+// Any failure (offline, timeout, Node without fetch) prints nothing.
+
+const skipUpdateCheck =
+  process.env.CI ||
+  process.env.JOPS_NO_UPDATE_CHECK ||
+  process.env.NO_UPDATE_NOTIFIER ||
+  flags.includes("--no-update-check");
+
+// https.get rather than fetch: destroying the request closes the socket at once,
+// whereas an aborted fetch keeps the process alive until its 10 s connect timeout.
+function fetchLatestVersion() {
+  return new Promise((resolve) => {
+    const req = https.get("https://registry.npmjs.org/jops-core/latest", (res) => {
+      if (res.statusCode !== 200) {
+        clearTimeout(timer);
+        res.resume();
+        return resolve(null);
+      }
+      let body = "";
+      res.setEncoding("utf8");
+      res.on("data", (chunk) => (body += chunk));
+      res.on("end", () => {
+        clearTimeout(timer);
+        try {
+          resolve(JSON.parse(body).version ?? null);
+        } catch {
+          resolve(null);
+        }
+      });
+    });
+    const timer = setTimeout(() => req.destroy(), 1500);
+    req.on("error", () => {
+      clearTimeout(timer);
+      resolve(null);
+    });
+  });
+}
+
+const latestVersion = skipUpdateCheck ? Promise.resolve(null) : fetchLatestVersion();
+
+function isNewer(a, b) {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] || 0) !== (pb[i] || 0)) return (pa[i] || 0) > (pb[i] || 0);
+  }
+  return false;
+}
 
 // ─── project detection ───────────────────────────────────────────────────────
 // projectRoot: package.json, .vscode/   webRoot: index.html, lib/, src/
@@ -413,7 +468,6 @@ if (command === "update") {
 
   fs.copyFileSync(vendorSrc, vendorDest);
 
-  const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, "../package.json"), "utf8"));
   console.log(`[jops-core] Updated ${rel(vendorDest)} to v${pkg.version}`);
 }
 
@@ -446,8 +500,29 @@ if (command === "build") {
     }
   }
 
+  const vendored = path.join(webRoot, "lib", "jops-core.min.js");
+  const installed = path.join(__dirname, "../lib/jops-core.min.js");
+  if (fs.existsSync(vendored) && !fs.readFileSync(vendored).equals(fs.readFileSync(installed))) {
+    console.warn(`[jops-core] ${rel(vendored)} differs from the installed v${pkg.version} — run \`npx jops-core update\` before building.`);
+  }
+
   const distDir = path.join(webRoot, "dist");
   if (fs.existsSync(distDir)) fs.rmSync(distDir, { recursive: true, force: true });
   buildCopyDir(webRoot, distDir);
   console.log("[jops-core] Built → dist/");
 }
+
+// ─── update notice ───────────────────────────────────────────────────────────
+
+const latest = await latestVersion;
+if (latest && isNewer(latest, pkg.version)) {
+  console.log("");
+  if (command === "update") {
+    console.log(`[jops-core] Copied v${pkg.version} from node_modules, but v${latest} is available.`);
+    console.log("            Run `npm i jops-core@latest` first, then `npx jops-core update` again.");
+  } else {
+    console.log(`[jops-core] Update available: ${pkg.version} → ${latest}`);
+    console.log("            npm i jops-core@latest && npx jops-core update");
+  }
+  console.log("            What's new: https://github.com/uidb-dev/jops-core/blob/main/CHANGELOG.md");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jops-core",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "A no-bundler, OOP-first SPA framework with Android-style view composition",
   "type": "module",
   "exports": "./lib/jops-core.min.js",