@whatalo/cli-kit 1.0.0

package/dist/version/index.mjs

@@ -0,0 +1,164 @@
+// src/version/check.ts
+import { readFile, writeFile, mkdir } from "fs/promises";
+import path2 from "path";
+import chalk from "chalk";
+
+// src/session/store.ts
+import fs from "fs/promises";
+import os from "os";
+import path from "path";
+function getSessionDir() {
+  return path.join(os.homedir(), ".whatalo");
+}
+
+// src/version/check.ts
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var REGISTRY_TIMEOUT_MS = 3e3;
+function getCachePath() {
+  return path2.join(getSessionDir(), "version-check.json");
+}
+async function readCache() {
+  try {
+    const raw = await readFile(getCachePath(), "utf-8");
+    const cache = JSON.parse(raw);
+    const lastCheck = new Date(cache.lastCheck).getTime();
+    if (Date.now() - lastCheck < CHECK_INTERVAL_MS) {
+      return cache;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+async function writeCache(cache) {
+  try {
+    const dir = getSessionDir();
+    await mkdir(dir, { recursive: true, mode: 448 });
+    await writeFile(getCachePath(), JSON.stringify(cache, null, 2), "utf-8");
+  } catch {
+  }
+}
+async function fetchLatestVersion(packageName) {
+  try {
+    const res = await fetch(
+      `https://registry.npmjs.org/${packageName}/latest`,
+      { signal: AbortSignal.timeout(REGISTRY_TIMEOUT_MS) }
+    );
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function isNewerVersion(current, latest) {
+  const parse = (v) => v.replace(/^v/, "").split(".").map(Number);
+  const c = parse(current);
+  const l = parse(latest);
+  for (let i = 0; i < 3; i++) {
+    if ((l[i] ?? 0) > (c[i] ?? 0)) return true;
+    if ((l[i] ?? 0) < (c[i] ?? 0)) return false;
+  }
+  return false;
+}
+function getUpgradeCommand() {
+  const pm = detectPackageManager();
+  switch (pm) {
+    case "pnpm":
+      return "pnpm add -g @whatalo/cli";
+    case "yarn":
+      return "yarn global add @whatalo/cli";
+    case "npm":
+      return "npm install -g @whatalo/cli";
+  }
+}
+function detectPackageManager() {
+  const userAgent = process.env.npm_config_user_agent ?? "";
+  if (userAgent.includes("pnpm")) return "pnpm";
+  if (userAgent.includes("yarn")) return "yarn";
+  if (userAgent.includes("npm")) return "npm";
+  return "pnpm";
+}
+function scheduleVersionCheck(currentVersion) {
+  const checkPromise = (async () => {
+    const cached = await readCache();
+    if (cached && cached.currentVersion === currentVersion) {
+      return cached.latestVersion !== currentVersion && isNewerVersion(currentVersion, cached.latestVersion) ? cached.latestVersion : null;
+    }
+    const latestVersion = await fetchLatestVersion("@whatalo/cli");
+    if (!latestVersion) return null;
+    await writeCache({
+      lastCheck: (/* @__PURE__ */ new Date()).toISOString(),
+      latestVersion,
+      currentVersion
+    });
+    return isNewerVersion(currentVersion, latestVersion) ? latestVersion : null;
+  })();
+  process.on("exit", () => {
+    checkPromise.then((latestVersion) => {
+      if (!latestVersion) return;
+      const upgradeCmd = getUpgradeCommand();
+      const box = [
+        "",
+        chalk.yellow("\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E"),
+        chalk.yellow("\u2502                                          \u2502"),
+        chalk.yellow("\u2502") + `   Update available: ${chalk.dim(currentVersion)} ${chalk.yellow("\u2192")} ${chalk.green(latestVersion)}       ` + chalk.yellow("\u2502"),
+        chalk.yellow("\u2502") + `   Run: ${chalk.cyan(upgradeCmd)}          ` + chalk.yellow("\u2502"),
+        chalk.yellow("\u2502                                          \u2502"),
+        chalk.yellow("\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"),
+        ""
+      ];
+      for (const line of box) {
+        process.stderr.write(line + "\n");
+      }
+    }).catch(() => {
+    });
+  });
+}
+
+// src/version/compatibility.ts
+import { readFileSync } from "fs";
+import path3 from "path";
+function checkSdkCompatibility(cliVersion, projectDir) {
+  const sdkVersion = getSdkVersion(projectDir);
+  if (!sdkVersion) return null;
+  const cliMajor = parseMajor(cliVersion);
+  const sdkMajor = parseMajor(sdkVersion);
+  if (cliMajor !== sdkMajor) {
+    return `SDK version ${sdkVersion} may not be compatible with CLI ${cliVersion}. Run: pnpm update @whatalo/app-sdk`;
+  }
+  const cliMinor = parseMinor(cliVersion);
+  const sdkMinor = parseMinor(sdkVersion);
+  if (cliMinor - sdkMinor > 1) {
+    return `SDK version ${sdkVersion} is behind CLI ${cliVersion}. Run: pnpm update @whatalo/app-sdk`;
+  }
+  return null;
+}
+function getSdkVersion(projectDir) {
+  try {
+    const pkgPath = path3.join(
+      projectDir,
+      "node_modules",
+      "@whatalo",
+      "app-sdk",
+      "package.json"
+    );
+    const raw = readFileSync(pkgPath, "utf-8");
+    const pkg = JSON.parse(raw);
+    return pkg.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function parseMajor(version) {
+  return parseInt(version.replace(/^v/, "").split(".")[0] ?? "0", 10);
+}
+function parseMinor(version) {
+  return parseInt(version.replace(/^v/, "").split(".")[1] ?? "0", 10);
+}
+export {
+  checkSdkCompatibility,
+  getUpgradeCommand,
+  isNewerVersion,
+  scheduleVersionCheck
+};

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@whatalo/cli-kit",
+  "version": "1.0.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Shared CLI utilities for Whatalo plugin development tools",
+  "author": {
+    "name": "Bello Sanchez",
+    "email": "bello@whatalo.com",
+    "url": "https://github.com/bellopushon"
+  },
+  "homepage": "https://developers.whatalo.com",
+  "bugs": {
+    "email": "soporte@whatalo.com"
+  },
+  "keywords": [
+    "whatalo",
+    "cli",
+    "plugin",
+    "developer-tools"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./session": {
+      "types": "./dist/session/index.d.ts",
+      "import": "./dist/session/index.mjs",
+      "require": "./dist/session/index.cjs"
+    },
+    "./output": {
+      "types": "./dist/output/index.d.ts",
+      "import": "./dist/output/index.mjs",
+      "require": "./dist/output/index.cjs"
+    },
+    "./http": {
+      "types": "./dist/http/index.d.ts",
+      "import": "./dist/http/index.mjs",
+      "require": "./dist/http/index.cjs"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.mjs",
+      "require": "./dist/config/index.cjs"
+    },
+    "./tunnel": {
+      "types": "./dist/tunnel/index.d.ts",
+      "import": "./dist/tunnel/index.mjs",
+      "require": "./dist/tunnel/index.cjs"
+    },
+    "./version": {
+      "types": "./dist/version/index.d.ts",
+      "import": "./dist/version/index.mjs",
+      "require": "./dist/version/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@iarna/toml": "^2.2.5",
+    "chalk": "^5.4.1",
+    "esbuild": "^0.27.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/iarna__toml": "^2.0.5",
+    "@types/node": "^24.10.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  }
+}