@stackable-labs/cli-app-extension 1.9.0 → 1.10.0

package/README.md

@@ -5,15 +5,17 @@ CLI for scaffolding new [Stackable](https://www.npmjs.com/package/@stackable-lab
 ## Quick Start
 
 ```bash
-npx @stackable-labs/cli-app-extension my-extension
+npx @stackable-labs/cli-app-extension@latest create my-extension
 ```
 
 Or run interactively with no arguments:
 
 ```bash
-npx @stackable-labs/cli-app-extension
+npx @stackable-labs/cli-app-extension@latest create
 ```
 
+> **Important:** Always include `@latest` to ensure you get the most recent version. Both `npx` and `pnpm dlx` aggressively cache packages.
+
 ## Interactive Mode
 
 When run without all required flags, the CLI guides you through a step-by-step prompt flow:
@@ -84,6 +86,27 @@ pnpm dev         # starts both Extension + Preview with hot-reload
 
 The preview host runs at the configured preview port and hot-reloads whenever the Extension changes.
 
+## Troubleshooting
+
+### Stale CLI version after update
+
+Both `npx` and `pnpm dlx` cache downloaded packages. If you're seeing an older version after a new release:
+
+**npx** — Always use `@latest` and clear the cache if needed:
+```bash
+npx @stackable-labs/cli-app-extension@latest create
+
+# If still stale, clear the npx cache:
+npx clear-npx-cache
+```
+
+**pnpm dlx** — Force a fresh resolve:
+```bash
+pnpm dlx --recreate-lockfile @stackable-labs/cli-app-extension@latest create
+```
+
+> **Note:** After a new version is published to npm, there may be a brief delay (up to ~15 minutes) before the npm CDN propagates the update.
+
 ## Requirements
 
 - Node 20+

package/dist/index.js

@@ -2194,10 +2194,55 @@ var DevApp = ({ options = {} }) => {
   return /* @__PURE__ */ jsx16(Box16, { children: /* @__PURE__ */ jsx16(Text16, { children: "Loading..." }) });
 };
 
+// src/lib/versionCheck.ts
+import https from "https";
+var PACKAGE_NAME = "@stackable-labs/cli-app-extension";
+var REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+var TIMEOUT_MS = 3e3;
+var 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 true;
+    if ((pa[i] ?? 0) < (pb[i] ?? 0)) return false;
+  }
+  return false;
+};
+var checkForUpdate = (currentVersion) => {
+  try {
+    const req = https.get(REGISTRY_URL, { timeout: TIMEOUT_MS }, (res) => {
+      let data = "";
+      res.on("data", (chunk) => {
+        data += chunk.toString();
+      });
+      res.on("end", () => {
+        try {
+          const { version: latest } = JSON.parse(data);
+          if (latest && latest !== currentVersion && isNewer(latest, currentVersion)) {
+            const warning = "\n\x1B[33m\u26A0  Update available: " + currentVersion + " \u2192 " + latest + "\x1B[0m\n   Run \x1B[36mnpx @stackable-labs/cli-app-extension@latest\x1B[0m to update\n";
+            console.error(warning);
+          }
+        } catch {
+        }
+      });
+    });
+    req.on("socket", (socket) => {
+      socket.unref();
+    });
+    req.on("error", () => {
+    });
+    req.on("timeout", () => {
+      req.destroy();
+    });
+  } catch {
+  }
+};
+
 // src/index.tsx
 import { jsx as jsx17 } from "react/jsx-runtime";
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
+checkForUpdate(version);
 program.name("stackable-app-extension").description("Stackable Labs - App Extension developer CLI").version(version);
 program.command("create" /* CREATE */).description("Create a new Extension project").argument("[name]", "Extension project name").option("--extension-port <port>", "Extension dev server port (default: 5173)").option("--preview-port <port>", "Preview dev server port").option("--skip-install", "Skip package manager install").option("--skip-git", "Skip git initialization").action((name, options) => {
   render(/* @__PURE__ */ jsx17(App, { command: "create" /* CREATE */, initialName: name, options }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackable-labs/cli-app-extension",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "type": "module",
   "private": false,
   "bin": {