@meterapp/car-image 1.0.0

package/dist/update.js

@@ -0,0 +1,142 @@
+import { spawn } from "node:child_process";
+import { readJsonFile, writeJsonFile } from "./config.js";
+import { PACKAGE_NAME } from "./version.js";
+export const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+export const UPDATE_CHECK_TTL_MS = 24 * 60 * 60 * 1000;
+function parseVersion(version) {
+    const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?/.exec(version.trim());
+    if (!match)
+        return null;
+    return { parts: [Number(match[1]), Number(match[2]), Number(match[3])], pre: match[4] ?? null };
+}
+/** Semver-ish comparison; a prerelease sorts before its release. Unparsable versions compare equal. */
+export function compareVersions(a, b) {
+    const left = parseVersion(a);
+    const right = parseVersion(b);
+    if (!left || !right)
+        return 0;
+    for (let index = 0; index < 3; index += 1) {
+        const l = left.parts[index] ?? 0;
+        const r = right.parts[index] ?? 0;
+        if (l !== r)
+            return l < r ? -1 : 1;
+    }
+    if (left.pre && !right.pre)
+        return -1;
+    if (!left.pre && right.pre)
+        return 1;
+    if (left.pre && right.pre && left.pre !== right.pre)
+        return left.pre < right.pre ? -1 : 1;
+    return 0;
+}
+export function isNewer(latest, current) {
+    return typeof latest === "string" && compareVersions(latest, current) > 0;
+}
+/** Detects the package manager that launched us from `npm_config_user_agent`. */
+export function detectPackageManager(env = process.env) {
+    const agent = (env.npm_config_user_agent ?? "").toLowerCase();
+    if (agent.startsWith("pnpm/"))
+        return "pnpm";
+    if (agent.startsWith("bun/"))
+        return "bun";
+    if (agent.startsWith("yarn/"))
+        return "yarn";
+    return "npm";
+}
+export function installCommand(manager, pkg = PACKAGE_NAME) {
+    switch (manager) {
+        case "pnpm":
+            return { command: "pnpm", args: ["add", "-g", `${pkg}@latest`] };
+        case "bun":
+            return { command: "bun", args: ["add", "-g", `${pkg}@latest`] };
+        case "yarn":
+            return { command: "yarn", args: ["global", "add", `${pkg}@latest`] };
+        default:
+            return { command: "npm", args: ["install", "-g", `${pkg}@latest`] };
+    }
+}
+/** True when running through `npx`, `pnpm dlx`, `bunx` or similar one-shot runners. */
+export function isNpxInvocation(env = process.env, argv1 = process.argv[1] ?? "") {
+    if (env.npm_command === "exec")
+        return true;
+    if (env.npm_lifecycle_event === "npx")
+        return true;
+    const path = argv1.replace(/\\/g, "/");
+    return /\/_npx\//.test(path) || /\/\.pnpm-store\/|\/dlx-[^/]*\//.test(path) || /\/\.bun\/install\/cache\//.test(path);
+}
+/**
+ * Decision matrix for the passive update check that runs before a command:
+ * silent when nothing is newer, when there is no TTY, when `--quiet`, when
+ * running the stdio MCP server, or when a notice was already shown today.
+ * npx/dlx invocations only ever get a notice (they always run the latest
+ * version anyway on the next call).
+ */
+export function decideUpdate(input) {
+    if (!isNewer(input.latest, input.current))
+        return { action: "none", reason: "up to date" };
+    if (input.command === "mcp" || input.command === "update")
+        return { action: "none", reason: "command excluded" };
+    if (!input.isTTY)
+        return { action: "none", reason: "not a tty" };
+    if (input.quiet)
+        return { action: "none", reason: "quiet" };
+    if (input.lastNoticeAt !== null && input.now - input.lastNoticeAt < UPDATE_CHECK_TTL_MS) {
+        return { action: "none", reason: "already notified today" };
+    }
+    if (input.viaNpx)
+        return { action: "notice", latest: input.latest };
+    switch (input.autoUpdate) {
+        case "always":
+            return { action: "install", latest: input.latest };
+        case "never":
+            return { action: "notice", latest: input.latest };
+        default:
+            return { action: "ask", latest: input.latest };
+    }
+}
+/** Latest published version from the npm registry, or null on any failure. */
+export async function fetchLatestVersion(fetchImpl = fetch, timeoutMs = 2500) {
+    try {
+        const response = await fetchImpl(REGISTRY_URL, {
+            signal: AbortSignal.timeout(timeoutMs),
+            headers: { Accept: "application/vnd.npm.install-v1+json, application/json" },
+        });
+        if (!response.ok)
+            return null;
+        const body = (await response.json());
+        return typeof body.version === "string" ? body.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Reads the 24h cache, refreshing it from the registry when stale or forced. */
+export async function checkForUpdate(options) {
+    const now = options.now ?? Date.now();
+    const ttl = options.ttlMs ?? UPDATE_CHECK_TTL_MS;
+    const cached = await readJsonFile(options.cachePath);
+    if (!options.force && cached && typeof cached.checkedAt === "number" && now - cached.checkedAt < ttl) {
+        return { latest: cached.latest ?? null, cache: cached, fromCache: true };
+    }
+    const latest = await fetchLatestVersion(options.fetchImpl);
+    const cache = { checkedAt: now, latest, lastNoticeAt: cached?.lastNoticeAt };
+    await writeJsonFile(options.cachePath, cache, 0o600).catch(() => undefined);
+    return { latest, cache, fromCache: false };
+}
+export async function markNoticeShown(cachePath, cache, now = Date.now()) {
+    await writeJsonFile(cachePath, { ...cache, lastNoticeAt: now }, 0o600).catch(() => undefined);
+}
+/** Runs the global install in the foreground; resolves with the exit code. */
+export function performUpdate(manager, log) {
+    const { command, args } = installCommand(manager);
+    log(`Running: ${command} ${args.join(" ")}\n`);
+    return new Promise((resolve) => {
+        const child = spawn(command, args, { stdio: "inherit", shell: process.platform === "win32" });
+        child.on("error", (error) => {
+            log(`Could not start ${command}: ${error.message}\n`);
+            resolve(1);
+        });
+        child.on("exit", (code) => resolve(code ?? 1));
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"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"}

package/dist/version.js

@@ -0,0 +1,5 @@
+/** Kept in sync with package.json by `src/version.test.ts`. */
+export const CLI_VERSION = "1.0.0";
+export const PACKAGE_NAME = "@meterapp/car-image";
+export const BIN_NAME = "car-image";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AACnC,MAAM,CAAC,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@meterapp/car-image",
+  "version": "1.0.0",
+  "description": "CLI and MCP server for the Car Image API by Meter: studio-quality, transparent-background vehicle renders for agents, apps and browsers. Login, fetch images, mint signed URLs, run diagnostics, configure agents.",
+  "license": "MIT",
+  "author": "Meter <hello@meterapp.co> (https://meterapp.co)",
+  "homepage": "https://car-imgs.vercel.app",
+  "bugs": {
+    "url": "https://car-imgs.vercel.app/docs/feedback",
+    "email": "hello@meterapp.co"
+  },
+  "keywords": [
+    "car",
+    "vehicle",
+    "image",
+    "api",
+    "cli",
+    "mcp",
+    "mcp-server",
+    "agents",
+    "claude",
+    "cursor",
+    "chatgpt",
+    "meter"
+  ],
+  "type": "module",
+  "bin": {
+    "car-image": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.0.0",
+    "zod": "^4.5.4",
+    "@meterapp/car-image-sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}