@getmaito/cli 0.1.0 → 0.1.2

package/README.md

@@ -22,6 +22,12 @@ Run commands:
 maito posts list
 ```
 
+Show the installed version:
+
+```sh
+maito version
+```
+
 ## Auth
 
 Sign in for full CLI access:
@@ -57,6 +63,8 @@ Update the global install:
 npm update -g @getmaito/cli
 ```
 
+The CLI checks npm for a newer version at most once per day and prints an update hint after normal human-readable command output. JSON output is not changed.
+
 ## Release
 
 The CLI package is published as `@getmaito/cli`.

package/dist/index.js

@@ -13693,7 +13693,8 @@ var AutoPlugConfigSchema = exports_external.object({
   kind: AutoPlugKindSchema,
   destination: AutoPlugDestinationSchema.default("first_comment"),
   messageTemplate: exports_external.string().trim().min(1).max(1000),
-  ctaLinkId: exports_external.string().min(1).optional()
+  ctaLinkId: exports_external.string().min(1).optional(),
+  issueId: exports_external.string().min(1).optional()
 });
 // ../contracts/src/billing.ts
 var BillingPlanSchema = exports_external.enum([
@@ -17293,15 +17294,23 @@ function getConfigDir() {
   }
   return process.env.XDG_CONFIG_HOME?.trim() || path.join(os.homedir(), ".config");
 }
-function parseJsonResponse(response, label) {
-  return response.json().catch(() => {
-    throw new Error(`Failed to parse ${label} response.`);
-  }).then((payload) => {
-    if (!response.ok) {
-      throw new Error(formatOAuthError(label, payload, response.status));
+async function parseJsonResponse(response, label) {
+  const text = await response.text();
+  let payload;
+  if (text.trim()) {
+    try {
+      payload = JSON.parse(text);
+    } catch {
+      if (!response.ok) {
+        throw new Error(formatOAuthError(label, text, response.status));
+      }
+      throw new Error(`Failed to parse ${label} response.`);
     }
-    return payload;
-  });
+  }
+  if (!response.ok) {
+    throw new Error(formatOAuthError(label, payload, response.status));
+  }
+  return payload;
 }
 function formatOAuthError(label, payload, status) {
   if (payload && typeof payload === "object") {
@@ -17318,6 +17327,9 @@ function formatOAuthError(label, payload, status) {
       return `${label} failed: ${message}`;
     }
   }
+  if (typeof payload === "string" && payload.trim()) {
+    return `${label} failed with status ${status}: ${payload.trim()}`;
+  }
   return `${label} failed with status ${status}.`;
 }
 function requireString(value, fieldName) {
@@ -17401,11 +17413,132 @@ function printPostList(value) {
   }
 }
 
+// src/update-check.ts
+import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
+import { createRequire } from "node:module";
+import os2 from "node:os";
+import path2 from "node:path";
+var require2 = createRequire(import.meta.url);
+var packageJson = require2("../package.json");
+var PACKAGE_NAME = typeof packageJson.name === "string" ? packageJson.name : "@getmaito/cli";
+var CURRENT_VERSION = typeof packageJson.version === "string" ? packageJson.version : "0.0.0";
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+var REGISTRY_LATEST_URL = "https://registry.npmjs.org/@getmaito%2fcli/latest";
+var REQUEST_TIMEOUT_MS = 1500;
+async function maybePrintUpdateNotice(input) {
+  if (input.json || isDisabled()) {
+    return;
+  }
+  const store = await readUpdateCheckStore().catch(() => ({}));
+  const lastCheckedAt = store.lastCheckedAt ? Date.parse(store.lastCheckedAt) : Number.NaN;
+  if (Number.isFinite(lastCheckedAt) && Date.now() - lastCheckedAt < CHECK_INTERVAL_MS) {
+    return;
+  }
+  await writeUpdateCheckStore({
+    lastCheckedAt: new Date().toISOString()
+  }).catch(() => {
+    return;
+  });
+  const latestVersion = await fetchLatestVersion().catch(() => {
+    return;
+  });
+  if (!latestVersion || compareVersions(latestVersion, CURRENT_VERSION) <= 0) {
+    return;
+  }
+  console.error("");
+  console.error(`Update available: ${PACKAGE_NAME} ${CURRENT_VERSION} -> ${latestVersion}`);
+  console.error(`Run: npm update -g ${PACKAGE_NAME}`);
+}
+function getCliPackageInfo() {
+  return {
+    name: PACKAGE_NAME,
+    version: CURRENT_VERSION
+  };
+}
+function isDisabled() {
+  const value = process.env.MAITO_CLI_DISABLE_UPDATE_CHECK?.trim().toLowerCase();
+  return value === "1" || value === "true" || value === "yes";
+}
+async function fetchLatestVersion() {
+  const controller = new AbortController;
+  const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+  try {
+    const response = await fetch(REGISTRY_LATEST_URL, {
+      headers: {
+        accept: "application/json"
+      },
+      signal: controller.signal
+    });
+    if (!response.ok) {
+      return;
+    }
+    const payload = await response.json();
+    return typeof payload.version === "string" && payload.version.trim() ? payload.version.trim() : undefined;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+async function readUpdateCheckStore() {
+  const filePath = getUpdateCheckFilePath();
+  try {
+    const raw = await readFile2(filePath, "utf8");
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === "object" ? parsed : {};
+  } catch (error48) {
+    if (error48.code === "ENOENT") {
+      return {};
+    }
+    throw error48;
+  }
+}
+async function writeUpdateCheckStore(store) {
+  const filePath = getUpdateCheckFilePath();
+  await mkdir2(path2.dirname(filePath), { recursive: true });
+  await writeFile2(filePath, `${JSON.stringify(store, null, 2)}
+`, {
+    encoding: "utf8",
+    mode: 384
+  });
+}
+function getUpdateCheckFilePath() {
+  return path2.join(getConfigDir2(), "maito", "update-check.json");
+}
+function getConfigDir2() {
+  if (process.platform === "win32") {
+    return process.env.APPDATA?.trim() || path2.join(os2.homedir(), "AppData", "Roaming");
+  }
+  return process.env.XDG_CONFIG_HOME?.trim() || path2.join(os2.homedir(), ".config");
+}
+function compareVersions(left, right) {
+  const leftParts = readVersionParts(left);
+  const rightParts = readVersionParts(right);
+  for (let index = 0;index < 3; index += 1) {
+    const difference = (leftParts[index] ?? 0) - (rightParts[index] ?? 0);
+    if (difference !== 0) {
+      return difference;
+    }
+  }
+  return 0;
+}
+function readVersionParts(value) {
+  const release = value.split("-", 1)[0] ?? "";
+  const parts = release.split(".");
+  return [
+    Number.parseInt(parts[0] ?? "0", 10) || 0,
+    Number.parseInt(parts[1] ?? "0", 10) || 0,
+    Number.parseInt(parts[2] ?? "0", 10) || 0
+  ];
+}
+
 // src/index.ts
 async function main() {
   const { positionals, flags } = parseArgs(process.argv.slice(2));
   const json2 = readBooleanFlag(flags, "json");
   const baseUrl = resolveApiBaseUrl(readStringFlag(flags, "base-url") ?? process.env.MAITO_BASE_URL);
+  if (positionals[0] === "version" || readBooleanFlag(flags, "version")) {
+    printVersion({ json: json2 });
+    return;
+  }
   if (positionals.length === 0 || positionals[0] === "help" || readBooleanFlag(flags, "help")) {
     printUsage();
     return;
@@ -17422,6 +17555,7 @@ async function main() {
       return;
     }
     console.log(`Signed in to ${status.baseUrl}${formatSignedInUser(status.user)}`);
+    await maybePrintUpdateNotice({ json: json2 });
     return;
   }
   if (commandKey === "logout") {
@@ -17434,10 +17568,12 @@ async function main() {
       return;
     }
     console.log(removed ? `Signed out from ${baseUrl}.` : `No saved OAuth session for ${baseUrl}.`);
+    await maybePrintUpdateNotice({ json: json2 });
     return;
   }
   if (commandKey === "auth.status") {
     await printAuthStatus({ baseUrl, json: json2 });
+    await maybePrintUpdateNotice({ json: json2 });
     return;
   }
   if (commandKey === "auth.use-api-key") {
@@ -17448,6 +17584,7 @@ async function main() {
       return;
     }
     console.log(`Stored API key for ${baseUrl}.`);
+    await maybePrintUpdateNotice({ json: json2 });
     return;
   }
   if (commandKey === "auth.clear-api-key") {
@@ -17457,6 +17594,7 @@ async function main() {
       return;
     }
     console.log(removed ? `Removed stored API key for ${baseUrl}.` : `No stored API key for ${baseUrl}.`);
+    await maybePrintUpdateNotice({ json: json2 });
     return;
   }
   const context = {
@@ -17516,6 +17654,7 @@ async function main() {
     return;
   }
   printHuman(outputKey, result);
+  await maybePrintUpdateNotice({ json: json2 });
 }
 async function printAuthStatus(input) {
   const [status, storedApiKey] = await Promise.all([
@@ -17864,6 +18003,10 @@ function parseArgs(argv) {
     if (!value) {
       continue;
     }
+    if (value === "-v") {
+      flags.version = true;
+      continue;
+    }
     if (!value.startsWith("--")) {
       positionals.push(value);
       continue;
@@ -17896,6 +18039,17 @@ function normalizeOutputKey(positionals) {
   const root = normalizeRoot(positionals[0]);
   return [root, positionals[1]].filter(Boolean).join(".");
 }
+function printVersion(input) {
+  const packageInfo = getCliPackageInfo();
+  if (input.json) {
+    printJson({
+      command: "maito",
+      ...packageInfo
+    });
+    return;
+  }
+  console.log(`maito ${packageInfo.version}`);
+}
 function requireAction(context, index, command) {
   const action = context.positionals[index];
   if (!action) {
@@ -18092,6 +18246,8 @@ function parseJson(value, label) {
 }
 function printUsage() {
   console.log(`Usage:
+  maito version [--json]
+  maito --version
   maito login [--base-url <url>] [--oauth-client-id <id>] [--json]
   maito logout [--base-url <url>] [--json]
   maito auth status [--base-url <url>] [--json]

package/dist/update-check.d.ts

@@ -0,0 +1,8 @@
+export declare function maybePrintUpdateNotice(input: {
+    json: boolean;
+}): Promise<void>;
+export declare function getCliPackageInfo(): {
+    name: string;
+    version: string;
+};
+//# sourceMappingURL=update-check.d.ts.map

package/dist/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AA4BA,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,iBA8BpE;AAED,wBAAgB,iBAAiB;;;EAKhC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getmaito/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "bin": {
     "maito": "dist/index.js"