@indigoai-us/hq-cli 5.319.0 → 5.321.0

package/dist/utils/package-use-lease.js

@@ -0,0 +1,213 @@
+import { createHash } from "node:crypto";
+import { mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync, } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { performance } from "node:perf_hooks";
+const CLI_NAME = "@indigoai-us/hq-cli";
+const UPDATE_REQUEST = "update.pending.json";
+export class PackageUseUpdatePendingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PackageUseUpdatePendingError";
+    }
+}
+function errorLabel(error) {
+    if (error && typeof error === "object") {
+        const value = error;
+        if (typeof value.code === "string")
+            return value.code;
+        if (typeof value.name === "string")
+            return value.name;
+    }
+    return "unknown error";
+}
+function readPackage(directory) {
+    try {
+        return JSON.parse(readFileSync(path.join(directory, "package.json"), "utf8"));
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT" || code === "ENOTDIR")
+            return null;
+        throw new Error(`Unable to inspect the HQ CLI install (${errorLabel(error)})`, { cause: error });
+    }
+}
+function findCliPackage(directory) {
+    while (true) {
+        const pkg = readPackage(directory);
+        if (pkg?.name === CLI_NAME) {
+            return { root: directory, version: typeof pkg.version === "string" ? pkg.version : "unknown" };
+        }
+        const parent = path.dirname(directory);
+        if (parent === directory)
+            return null;
+        directory = parent;
+    }
+}
+function isPnpmGlobal(root) {
+    const normalized = root.replace(/\\/g, "/").replace(/\/+$/, "");
+    const parts = normalized.split("/").filter(Boolean);
+    for (let i = 0; i < parts.length - 1; i += 1) {
+        if (parts[i] === "global" && (/^\d+$/.test(parts[i + 1]) || /^v\d+$/.test(parts[i + 1])))
+            return true;
+    }
+    const home = process.env.PNPM_HOME?.replace(/\\/g, "/").replace(/\/+$/, "");
+    const globalRoot = home ? `${home}/global` : null;
+    const left = process.platform === "win32" ? normalized.toLowerCase() : normalized;
+    const right = globalRoot && process.platform === "win32" ? globalRoot.toLowerCase() : globalRoot;
+    return Boolean(right && (left === right || left.startsWith(`${right}/`)));
+}
+function isBunGlobal(root) {
+    const parts = root.replace(/\\/g, "/").split("/").filter(Boolean);
+    return parts.some((part, i) => part === "install" && parts[i + 1] === "global" && parts[i + 2] === "node_modules");
+}
+export function npmPrefix(root, platform = process.platform) {
+    const normalized = root.replace(/\\/g, "/").replace(/\/+$/, "");
+    const parts = normalized.split("/");
+    const index = parts.lastIndexOf("node_modules");
+    if (index < 0)
+        return null;
+    const end = parts[index - 1] === "lib" ? index - 1 : index;
+    const prefix = parts.slice(0, end).join("/");
+    if (platform === "win32" && /^[a-z]:$/i.test(prefix))
+        return `${prefix}/`;
+    if (!prefix && normalized.startsWith("/"))
+        return "/";
+    return prefix || null;
+}
+function packageUseStateDirectory() {
+    if (process.platform === "win32") {
+        const localAppData = process.env.LOCALAPPDATA;
+        if (!localAppData)
+            throw new Error("LOCALAPPDATA is unavailable for the HQ CLI package-use lease");
+        return path.join(localAppData, "hq-cli", "state", "package-use");
+    }
+    return path.join(process.env.XDG_STATE_HOME?.trim() || path.join(os.homedir(), ".local", "state"), "hq-cli", "package-use");
+}
+function normalizedPrefix(prefix) {
+    let canonical = realpathSync.native(prefix).replace(/\\/g, "/");
+    canonical = canonical.replace(/^\\\\\?\\UNC\\/i, "//").replace(/^\\\\\?\\/, "");
+    return process.platform === "win32" ? canonical.toLowerCase() : canonical;
+}
+export function packageUseLeaseDirectory(prefix, stateDirectory = packageUseStateDirectory()) {
+    const digest = createHash("sha256").update(normalizedPrefix(prefix), "utf8").digest("hex");
+    return path.join(stateDirectory, digest);
+}
+export function packageUseUpdateRequestPath(prefix, stateDirectory) {
+    return path.join(packageUseLeaseDirectory(prefix, stateDirectory), UPDATE_REQUEST);
+}
+function waitForUpdateRequest(requestPath, timeoutMs) {
+    const started = Date.now();
+    const sleeper = new Int32Array(new SharedArrayBuffer(4));
+    while (true) {
+        try {
+            const request = JSON.parse(readFileSync(requestPath, "utf8"));
+            const pid = request.pid;
+            if (typeof pid !== "number" || !Number.isInteger(pid) || pid <= 0) {
+                throw new Error("invalid update request");
+            }
+            try {
+                process.kill(pid, 0);
+            }
+            catch (error) {
+                if (error.code === "ESRCH") {
+                    rmSync(requestPath, { force: true });
+                    return;
+                }
+            }
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return;
+            throw new Error(`Unable to read the HQ CLI update request (${errorLabel(error)})`, { cause: error });
+        }
+        if (Date.now() - started >= timeoutMs) {
+            throw new PackageUseUpdatePendingError("The HQ CLI package is being updated; retry after the update finishes");
+        }
+        Atomics.wait(sleeper, 0, 0, 100);
+    }
+}
+export function acquirePackageUseLease(prefix, hqVersion, stateDirectory) {
+    const directory = packageUseLeaseDirectory(prefix, stateDirectory);
+    mkdirSync(directory, { recursive: true, mode: 0o700 });
+    const requestPath = path.join(directory, UPDATE_REQUEST);
+    const record = {
+        pid: process.pid,
+        start_time_ms: Math.floor(performance.timeOrigin),
+        hq_version: hqVersion,
+    };
+    const leasePath = path.join(directory, `${record.pid}-${record.start_time_ms}.json`);
+    const tempPath = `${leasePath}.${Math.random().toString(36).slice(2)}.tmp`;
+    let released = false;
+    const release = () => {
+        if (released)
+            return;
+        released = true;
+        process.removeListener("exit", releaseOnExit);
+        try {
+            rmSync(leasePath, { force: true });
+        }
+        catch (error) {
+            process.stderr.write(`hq-cli package-use lease release failed (${errorLabel(error)})\n`);
+        }
+    };
+    const releaseOnExit = () => release();
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        waitForUpdateRequest(requestPath, 30_000);
+        try {
+            writeFileSync(tempPath, `${JSON.stringify(record)}\n`, { flag: "wx", mode: 0o600 });
+            renameSync(tempPath, leasePath);
+        }
+        catch (error) {
+            rmSync(tempPath, { force: true });
+            throw new Error(`Unable to publish the HQ CLI package-use lease (${errorLabel(error)})`, { cause: error });
+        }
+        if (!exists(requestPath)) {
+            process.once("exit", releaseOnExit);
+            return { leasePath, release };
+        }
+        rmSync(leasePath, { force: true });
+    }
+    throw new PackageUseUpdatePendingError("An HQ CLI update is waiting for the package lease; retry when it finishes");
+}
+function exists(file) {
+    try {
+        readFileSync(file);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+export function acquireCurrentPackageUseLease() {
+    const pkg = findCliPackage(path.dirname(fileURLToPath(import.meta.url)));
+    if (!pkg || isPnpmGlobal(pkg.root) || isBunGlobal(pkg.root))
+        return null;
+    const prefix = npmPrefix(pkg.root);
+    if (!prefix)
+        return null;
+    if (process.platform !== "win32") {
+        const parts = pkg.root.replace(/\\/g, "/").replace(/\/+$/, "").split("/").filter(Boolean);
+        const nodeModules = parts.lastIndexOf("node_modules");
+        if (nodeModules > 0 && parts[nodeModules - 1] !== "lib")
+            return null;
+    }
+    return acquirePackageUseLease(prefix, pkg.version);
+}
+/** True while the desktop updater owns the per-prefix update request. */
+export function currentPackageUseUpdateRequested() {
+    const pkg = findCliPackage(path.dirname(fileURLToPath(import.meta.url)));
+    if (!pkg || isPnpmGlobal(pkg.root) || isBunGlobal(pkg.root))
+        return false;
+    const prefix = npmPrefix(pkg.root);
+    if (!prefix)
+        return false;
+    return exists(packageUseUpdateRequestPath(prefix));
+}
+export const __test__ = {
+    waitForUpdateRequest,
+};
+//# sourceMappingURL=package-use-lease.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.319.0",
+  "version": "5.321.0",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {