@memtensor/memos-local-openclaw-plugin 1.0.2-beta.4 → 1.0.2-beta.6

package/src/update-check.ts

@@ -0,0 +1,96 @@
+/**
+ * Channel-aware update check against npm registry dist-tags.
+ * - Prerelease users (e.g. 1.0.2-beta.x) compare against beta tag only (semver gt).
+ * - Stable users compare against latest tag only (semver gt).
+ * - Beta users get optional stableChannel hint to install @latest when stable exists.
+ */
+// @ts-ignore — semver has no bundled types
+import * as semver from "semver";
+
+export interface UpdateCheckResult {
+  updateAvailable: boolean;
+  current: string;
+  /** Version on the channel we compared against (beta tag or latest tag). */
+  latest: string;
+  packageName: string;
+  /** Channel used for the primary comparison. */
+  channel: "beta" | "latest";
+  /** Full install command (includes @beta when updating on beta channel). */
+  installCommand: string;
+  /** When current is prerelease and registry has a stable latest — how to switch to stable. */
+  stableChannel?: { version: string; installCommand: string };
+}
+
+function isPrerelease(v: string): boolean {
+  return semver.prerelease(v) != null;
+}
+
+/**
+ * Fetch registry package doc and compute update state.
+ */
+export async function computeUpdateCheck(
+  packageName: string,
+  current: string,
+  fetchImpl: typeof fetch,
+  timeoutMs = 8_000,
+): Promise<UpdateCheckResult | null> {
+  if (!semver.valid(current)) return null;
+
+  const url = `https://registry.npmjs.org/${encodeURIComponent(packageName)}`;
+  const resp = await fetchImpl(url, { signal: AbortSignal.timeout(timeoutMs) });
+  if (!resp.ok) return null;
+
+  const data = (await resp.json()) as { "dist-tags"?: Record<string, string> };
+  const tags = data["dist-tags"] ?? {};
+  const latestTag = tags.latest;
+  const betaTag = tags.beta;
+
+  const onBeta = isPrerelease(current);
+  let updateAvailable = false;
+  let channel: "beta" | "latest" = "latest";
+  let targetVersion = current;
+  let installCommand = `openclaw plugins install ${packageName}`;
+
+  if (onBeta) {
+    channel = "beta";
+    // Beta users: only compare against beta tag; never suggest "updating" to stable via gt confusion.
+    if (betaTag && semver.valid(betaTag) && semver.gt(betaTag, current)) {
+      updateAvailable = true;
+      targetVersion = betaTag;
+      installCommand = `openclaw plugins install ${packageName}@beta`;
+    } else {
+      targetVersion = betaTag && semver.valid(betaTag) ? betaTag : current;
+      if (betaTag && semver.valid(betaTag) && semver.eq(betaTag, current)) {
+        installCommand = `openclaw plugins install ${packageName}@beta`;
+      }
+    }
+  } else {
+    // Stable users: compare against latest only.
+    if (latestTag && semver.valid(latestTag) && semver.gt(latestTag, current)) {
+      updateAvailable = true;
+      targetVersion = latestTag;
+      installCommand = `openclaw plugins install ${packageName}`;
+    } else {
+      targetVersion = latestTag && semver.valid(latestTag) ? latestTag : current;
+    }
+  }
+
+  // Beta user + stable exists on latest: optional hint to switch to stable (not counted as "update").
+  let stableChannel: UpdateCheckResult["stableChannel"];
+  if (onBeta && latestTag && semver.valid(latestTag) && !isPrerelease(latestTag)) {
+    stableChannel = {
+      version: latestTag,
+      installCommand: `openclaw plugins install ${packageName}@latest`,
+    };
+  }
+
+  return {
+    updateAvailable,
+    current,
+    latest: targetVersion,
+    packageName,
+    channel,
+    installCommand,
+    stableChannel,
+  };
+}