backeer-opencode 0.1.4 → 0.2.0

package/src/updates.js

@@ -0,0 +1,136 @@
+export const PLUGIN_VERSION = "0.2.0"
+
+const PACKAGE_NAME = "backeer-opencode"
+const NPM_REGISTRY_URL = "https://registry.npmjs.org"
+const CHECK_TIMEOUT_MS = 3000
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000
+
+export function parseVersion(value) {
+  const match = String(value).trim().match(
+    /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/,
+  )
+  if (!match) return
+  return {
+    parts: [Number(match[1]), Number(match[2]), Number(match[3])],
+    prerelease: match[4],
+  }
+}
+
+export function isVersionNewer(latestValue, currentValue) {
+  const latest = parseVersion(latestValue)
+  const current = parseVersion(currentValue)
+  if (!latest || !current) return false
+
+  for (let index = 0; index < 3; index++) {
+    if (latest.parts[index] > current.parts[index]) return true
+    if (latest.parts[index] < current.parts[index]) return false
+  }
+  if (!latest.prerelease && current.prerelease) return true
+  if (latest.prerelease && !current.prerelease) return false
+  return Boolean(
+    latest.prerelease &&
+    current.prerelease &&
+    latest.prerelease !== current.prerelease,
+  )
+}
+
+export function createUpdateChecker({
+  fetchImplementation = globalThis.fetch,
+  now = () => Date.now(),
+} = {}) {
+  let checkedAt = 0
+  let cachedResult
+  let pendingCheck
+
+  async function fetchLatest() {
+    const controller = new AbortController()
+    const timeout = setTimeout(() => controller.abort(), CHECK_TIMEOUT_MS)
+    try {
+      const response = await fetchImplementation(
+        `${NPM_REGISTRY_URL}/${PACKAGE_NAME}/latest`,
+        { signal: controller.signal },
+      )
+      if (!response.ok) return { state: "unavailable", currentVersion: PLUGIN_VERSION }
+      const data = await response.json()
+      const latestVersion = typeof data?.version === "string"
+        ? data.version.trim()
+        : ""
+      if (!parseVersion(latestVersion)) {
+        return { state: "unavailable", currentVersion: PLUGIN_VERSION }
+      }
+      if (!isVersionNewer(latestVersion, PLUGIN_VERSION)) {
+        return {
+          state: "current",
+          currentVersion: PLUGIN_VERSION,
+          latestVersion,
+        }
+      }
+      return {
+        state: "available",
+        currentVersion: PLUGIN_VERSION,
+        latestVersion,
+        updateCommand:
+          `opencode plugin ${PACKAGE_NAME}@${latestVersion} -g --force`,
+      }
+    } catch {
+      return { state: "unavailable", currentVersion: PLUGIN_VERSION }
+    } finally {
+      clearTimeout(timeout)
+    }
+  }
+
+  return {
+    async check({ force = false } = {}) {
+      if (!force && checkedAt && now() - checkedAt < CHECK_INTERVAL_MS) {
+        return cachedResult
+      }
+      if (pendingCheck) return pendingCheck
+
+      pendingCheck = fetchLatest()
+        .then((result) => {
+          cachedResult = result
+          checkedAt = now()
+          return result
+        })
+        .finally(() => { pendingCheck = undefined })
+      return pendingCheck
+    },
+  }
+}
+
+export function formatAgentUpdateInstruction(info) {
+  return [
+    "[BACKEER UPDATE REQUESTED]",
+    `The user explicitly requested the Backeer OpenCode plugin update from v${info.currentVersion} to v${info.latestVersion}.`,
+    `Run exactly: ${info.updateCommand}`,
+    "Then verify that the global OpenCode config is pinned to the exact new version and that the matching package exists in the OpenCode cache.",
+    "Do not read, print, replace, or otherwise expose the Backeer token.",
+    "Do not use @latest and do not claim success until both installation and verification pass.",
+    "Do not terminate the active OpenCode process; tell the user to restart OpenCode after success.",
+  ].join("\n")
+}
+
+export function createUpdateNoticeHook(updateChecker) {
+  const notifiedSessions = new Set()
+
+  return async (input, output) => {
+    if (notifiedSessions.has(input.sessionID)) return
+    notifiedSessions.add(input.sessionID)
+
+    const info = await updateChecker.check()
+    if (info.state !== "available") return
+    output.parts.push({
+      id: `prt_backeer-update-${Date.now()}`,
+      sessionID: input.sessionID,
+      messageID: output.message.id,
+      type: "text",
+      synthetic: true,
+      text: [
+        "[BACKEER UPDATE AVAILABLE]",
+        `Backeer OpenCode plugin v${info.latestVersion} is available; current version is v${info.currentVersion}.`,
+        "Inform the user that an update is available and suggest `/backeer update`.",
+        "Do not install it solely because of this notice.",
+      ].join("\n"),
+    })
+  }
+}