@instafy/cli 0.1.11 → 0.2.0

package/dist/project-manifest.js

@@ -1,24 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import path from "node:path";
-export function findProjectManifest(startDir) {
-    let current = path.resolve(startDir);
-    const root = path.parse(current).root;
-    while (true) {
-        const candidate = path.join(current, ".instafy", "project.json");
-        if (existsSync(candidate)) {
-            try {
-                const parsed = JSON.parse(readFileSync(candidate, "utf8"));
-                if (parsed?.projectId) {
-                    return { manifest: parsed, path: candidate };
-                }
-            }
-            catch {
-                // ignore malformed manifest
-            }
-        }
-        if (current === root)
-            break;
-        current = path.dirname(current);
-    }
-    return { manifest: null, path: null };
-}

package/dist/project.js

@@ -1,412 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import kleur from "kleur";
-import { stdin as input } from "node:process";
-import { getInstafyProfileConfigPath, resolveConfiguredStudioUrl, resolveControllerUrl, resolveUserAccessTokenWithSource, } from "./config.js";
-import { formatAuthRejectedError, formatAuthRequiredError } from "./errors.js";
-import { findProjectManifest } from "./project-manifest.js";
-import { fetchWithControllerAuth } from "./controller-fetch.js";
-let promptsModule = null;
-async function loadPrompts() {
-    promptsModule ?? (promptsModule = import("@clack/prompts"));
-    return promptsModule;
-}
-async function controllerFetch(controllerUrl, auth, pathname, init) {
-    const { response, accessToken } = await fetchWithControllerAuth({
-        url: `${controllerUrl}${pathname}`,
-        init,
-        accessToken: auth.accessToken,
-        tokenSource: auth.tokenSource,
-        profile: auth.profile,
-        cwd: auth.cwd,
-    });
-    auth.accessToken = accessToken;
-    return response;
-}
-async function fetchOrganizations(controllerUrl, auth, retryCommand) {
-    const response = await controllerFetch(controllerUrl, auth, "/orgs");
-    if (!response.ok) {
-        const text = await response.text().catch(() => "");
-        if (response.status === 401 || response.status === 403) {
-            throw formatAuthRejectedError({
-                status: response.status,
-                responseBody: text,
-                retryCommand,
-            });
-        }
-        throw new Error(`Organization list failed (${response.status} ${response.statusText}): ${text}`);
-    }
-    const body = (await response.json());
-    return Array.isArray(body.orgs) ? body.orgs : [];
-}
-async function fetchOrgProjects(controllerUrl, auth, orgId, retryCommand) {
-    const response = await controllerFetch(controllerUrl, auth, `/orgs/${encodeURIComponent(orgId)}/projects`);
-    if (!response.ok) {
-        const text = await response.text().catch(() => "");
-        if (response.status === 401 || response.status === 403) {
-            throw formatAuthRejectedError({
-                status: response.status,
-                responseBody: text,
-                retryCommand,
-            });
-        }
-        throw new Error(`Project list failed (${response.status} ${response.statusText}): ${text}`);
-    }
-    const body = (await response.json());
-    return Array.isArray(body.projects) ? body.projects : [];
-}
-async function createOrganization(controllerUrl, auth, payload, retryCommand) {
-    const response = await controllerFetch(controllerUrl, auth, "/orgs", {
-        method: "POST",
-        headers: {
-            "content-type": "application/json",
-        },
-        body: JSON.stringify(payload),
-    });
-    if (!response.ok) {
-        const text = await response.text().catch(() => "");
-        if (response.status === 401 || response.status === 403) {
-            throw formatAuthRejectedError({
-                status: response.status,
-                responseBody: text,
-                retryCommand,
-            });
-        }
-        throw new Error(`Organization creation failed (${response.status} ${response.statusText}): ${text}`);
-    }
-    const json = (await response.json());
-    const orgId = json.org_id ?? json.orgId ?? json.id;
-    if (!orgId) {
-        throw new Error(`Organization creation response missing org id (expected org_id/orgId/id). Raw: ${JSON.stringify(json)}`);
-    }
-    return { orgId, orgName: json.org_name ?? json.orgName ?? null };
-}
-async function resolveOrg(controllerUrl, auth, options, retryCommand) {
-    if (options.orgId) {
-        return { orgId: options.orgId, orgName: options.orgName ?? null };
-    }
-    const orgSlug = options.orgSlug?.trim() || null;
-    const orgName = options.orgName?.trim() || null;
-    const studioUrl = resolveConfiguredStudioUrl({ profile: options.profile ?? null }) ?? "https://staging.instafy.dev";
-    const studioOrgUrl = `${studioUrl.replace(/\/$/, "")}/studio?panel=settings`;
-    const allowInteractive = Boolean(input.isTTY && process.stdout.isTTY && options.json !== true && process.env.CI !== "true");
-    async function promptAndCreateOrg() {
-        const { isCancel, text } = await loadPrompts();
-        const enteredName = await text({
-            message: "Organization name",
-            defaultValue: "Personal",
-        });
-        if (isCancel(enteredName)) {
-            throw new Error("Cancelled.");
-        }
-        const chosenName = String(enteredName).trim() || "Personal";
-        const enteredSlug = await text({
-            message: "Organization slug (optional)",
-        });
-        if (isCancel(enteredSlug)) {
-            throw new Error("Cancelled.");
-        }
-        const chosenSlug = String(enteredSlug).trim();
-        const payload = {
-            orgName: chosenName,
-        };
-        if (options.ownerUserId) {
-            payload.ownerUserId = options.ownerUserId;
-        }
-        if (chosenSlug) {
-            payload.orgSlug = chosenSlug;
-        }
-        const created = await createOrganization(controllerUrl, auth, payload, retryCommand);
-        return { orgId: created.orgId, orgName: created.orgName ?? chosenName };
-    }
-    if (orgSlug) {
-        const orgs = await fetchOrganizations(controllerUrl, auth, retryCommand);
-        const matches = orgs.filter((org) => org.slug === orgSlug);
-        if (matches.length === 1) {
-            return { orgId: matches[0].id, orgName: matches[0].name ?? null };
-        }
-    }
-    if (!orgSlug && !orgName) {
-        const orgs = await fetchOrganizations(controllerUrl, auth, retryCommand);
-        if (orgs.length === 0) {
-            if (allowInteractive) {
-                const { confirm, isCancel } = await loadPrompts();
-                console.log(kleur.yellow("No organizations found for this account."));
-                console.log("");
-                console.log(`Create one in Studio: ${kleur.cyan(studioOrgUrl)}`);
-                console.log("");
-                const shouldCreate = await confirm({
-                    message: "Create a new organization now?",
-                    initialValue: true,
-                });
-                if (isCancel(shouldCreate) || !shouldCreate) {
-                    throw new Error("No organization selected.");
-                }
-                return await promptAndCreateOrg();
-            }
-            throw new Error(`No organizations found.\n\nNext:\n- Create an org in Studio: ${studioOrgUrl}\n- Or rerun: instafy project init --org-name \"My Org\"`);
-        }
-        if (orgs.length === 1) {
-            return { orgId: orgs[0].id, orgName: orgs[0].name ?? null };
-        }
-        if (allowInteractive) {
-            const { isCancel, select } = await loadPrompts();
-            const selection = await select({
-                message: "Choose an organization for this project",
-                options: [
-                    { value: "__create__", label: "+ Create a new organization" },
-                    ...orgs.map((org) => ({
-                        value: org.id,
-                        label: org.name,
-                        hint: `${org.slug ? `${org.slug} · ` : ""}${org.id}`,
-                    })),
-                ],
-                initialValue: orgs[0].id,
-            });
-            if (isCancel(selection)) {
-                throw new Error("Cancelled.");
-            }
-            if (selection === "__create__") {
-                return await promptAndCreateOrg();
-            }
-            const pickedOrg = orgs.find((org) => org.id === selection);
-            if (!pickedOrg) {
-                throw new Error("Selected organization not found.");
-            }
-            return { orgId: pickedOrg.id, orgName: pickedOrg.name ?? null };
-        }
-        throw new Error("Multiple organizations found.\n\nNext:\n- instafy org list\n- instafy project init --org-id <uuid>");
-    }
-    if (orgSlug && !orgName) {
-        if (allowInteractive) {
-            const { isCancel, text } = await loadPrompts();
-            console.log(kleur.yellow("Organization slug did not match an existing org."));
-            console.log(`Create one in Studio: ${kleur.cyan(studioOrgUrl)}`);
-            console.log("");
-            const enteredName = await text({
-                message: "Organization name",
-                defaultValue: "Personal",
-            });
-            if (isCancel(enteredName)) {
-                throw new Error("Cancelled.");
-            }
-            const chosenName = String(enteredName).trim() || "Personal";
-            const payload = { orgName: chosenName, orgSlug };
-            if (options.ownerUserId) {
-                payload.ownerUserId = options.ownerUserId;
-            }
-            const created = await createOrganization(controllerUrl, auth, payload, retryCommand);
-            return { orgId: created.orgId, orgName: created.orgName ?? chosenName };
-        }
-        throw new Error(`Organization slug "${orgSlug}" did not match an existing org, and org name is required to create one.\n\nNext:\n- Create an org in Studio: ${studioOrgUrl}\n- Or rerun: instafy project init --org-name \"My Org\" --org-slug "${orgSlug}"`);
-    }
-    const payload = {};
-    if (orgName) {
-        payload.orgName = orgName;
-    }
-    if (orgSlug) {
-        payload.orgSlug = orgSlug;
-    }
-    if (options.ownerUserId) {
-        payload.ownerUserId = options.ownerUserId;
-    }
-    if (!payload.orgName) {
-        throw new Error(`Organization name is required.\n\nNext:\n- Create an org in Studio: ${studioOrgUrl}\n- Or rerun: instafy project init --org-name \"My Org\"`);
-    }
-    const created = await createOrganization(controllerUrl, auth, payload, retryCommand);
-    return { orgId: created.orgId, orgName: created.orgName ?? orgName ?? null };
-}
-export async function listProjects(options) {
-    const controllerUrl = resolveControllerUrl({ controllerUrl: options.controllerUrl ?? null });
-    const resolved = resolveUserAccessTokenWithSource({ accessToken: options.accessToken ?? null });
-    if (!resolved.token) {
-        throw formatAuthRequiredError({ retryCommand: "instafy project list" });
-    }
-    const retryCommand = "instafy project list";
-    const auth = {
-        accessToken: resolved.token,
-        tokenSource: resolved.source,
-        profile: resolved.profile,
-        cwd: process.cwd(),
-    };
-    const orgs = await fetchOrganizations(controllerUrl, auth, retryCommand);
-    let targetOrgs = orgs;
-    if (options.orgId) {
-        targetOrgs = orgs.filter((org) => org.id === options.orgId);
-        if (targetOrgs.length === 0) {
-            throw new Error(`No organization found for id ${options.orgId}`);
-        }
-    }
-    else if (options.orgSlug) {
-        targetOrgs = orgs.filter((org) => org.slug === options.orgSlug);
-        if (targetOrgs.length === 0) {
-            throw new Error(`No organization found for slug ${options.orgSlug}`);
-        }
-    }
-    const summaries = [];
-    for (const org of targetOrgs) {
-        const projects = await fetchOrgProjects(controllerUrl, auth, org.id, retryCommand);
-        summaries.push({ org, projects });
-    }
-    if (options.json) {
-        console.log(JSON.stringify(summaries, null, 2));
-    }
-    else if (summaries.length === 0) {
-        console.log(kleur.yellow("No organizations found for this account."));
-    }
-    else {
-        for (const summary of summaries) {
-            console.log(`${kleur.green(summary.org.name)} (${summary.org.id})`);
-            if (summary.projects.length === 0) {
-                console.log(kleur.yellow("  No projects found."));
-                continue;
-            }
-            for (const project of summary.projects) {
-                const type = project.project_type ? ` · ${project.project_type}` : "";
-                const status = project.status ? ` · ${project.status}` : "";
-                console.log(`  ${project.project_id}${type}${status}`);
-            }
-        }
-    }
-    return summaries.flatMap((summary) => summary.projects);
-}
-export async function projectInit(options) {
-    const rootDir = path.resolve(options.path ?? process.cwd());
-    const controllerUrl = resolveControllerUrl({
-        controllerUrl: options.controllerUrl ?? null,
-        profile: options.profile ?? null,
-        cwd: rootDir,
-    });
-    const resolved = resolveUserAccessTokenWithSource({
-        accessToken: options.accessToken ?? null,
-        profile: options.profile ?? null,
-        cwd: rootDir,
-    });
-    if (!resolved.token) {
-        throw formatAuthRequiredError({
-            retryCommand: "instafy project init",
-            advancedHint: "pass --access-token or set INSTAFY_ACCESS_TOKEN / SUPABASE_ACCESS_TOKEN",
-        });
-    }
-    const retryCommand = "instafy project init";
-    const auth = {
-        accessToken: resolved.token,
-        tokenSource: resolved.source,
-        profile: resolved.profile,
-        cwd: rootDir,
-    };
-    const org = await resolveOrg(controllerUrl, auth, options, retryCommand);
-    const body = {
-        projectType: options.projectType,
-        ownerUserId: options.ownerUserId,
-    };
-    const response = await controllerFetch(controllerUrl, auth, `/orgs/${encodeURIComponent(org.orgId)}/projects`, {
-        method: "POST",
-        headers: {
-            "content-type": "application/json",
-        },
-        body: JSON.stringify(body),
-    });
-    if (!response.ok) {
-        const text = await response.text().catch(() => "");
-        if (response.status === 401 || response.status === 403) {
-            throw formatAuthRejectedError({
-                status: response.status,
-                responseBody: text,
-                retryCommand,
-            });
-        }
-        throw new Error(`Project creation failed (${response.status} ${response.statusText}): ${text}`);
-    }
-    const json = (await response.json());
-    if (!json.project_id && json.projectId) {
-        json.project_id = json.projectId;
-    }
-    if (!json.org_id && json.orgId) {
-        json.org_id = json.orgId;
-    }
-    if (!json.org_name && json.orgName) {
-        json.org_name = json.orgName;
-    }
-    if (!json.project_id) {
-        throw new Error(`Project creation response missing project id (expected project_id/projectId). Raw: ${JSON.stringify(json)}`);
-    }
-    const manifestDir = path.join(rootDir, ".instafy");
-    const manifestPath = path.join(manifestDir, "project.json");
-    try {
-        fs.mkdirSync(manifestDir, { recursive: true });
-        fs.writeFileSync(manifestPath, JSON.stringify({
-            projectId: json.project_id,
-            orgId: json.org_id ?? org.orgId ?? null,
-            orgName: json.org_name ?? org.orgName ?? null,
-            controllerUrl,
-            profile: options.profile ?? null,
-            createdAt: new Date().toISOString(),
-        }, null, 2), "utf8");
-    }
-    catch (error) {
-        throw new Error(`Project created but failed to write manifest at ${manifestPath}: ${error instanceof Error ? error.message : String(error)}`);
-    }
-    if (options.json) {
-        console.log(JSON.stringify({
-            projectId: json.project_id,
-            orgId: json.org_id ?? org.orgId ?? null,
-            orgName: json.org_name ?? org.orgName ?? null,
-            manifest: manifestPath,
-        }));
-    }
-    else {
-        console.log(kleur.green(`Project created: ${json.project_id}`));
-        const resolvedOrgName = json.org_name ?? org.orgName;
-        const resolvedOrgId = json.org_id ?? org.orgId;
-        if (resolvedOrgName) {
-            console.log(kleur.cyan(`Org: ${resolvedOrgName}${resolvedOrgId ? ` (${resolvedOrgId})` : ""}`));
-        }
-        console.log(kleur.cyan(`Manifest written to ${manifestPath}`));
-    }
-    return json;
-}
-export function projectProfile(options) {
-    const rootDir = path.resolve(options.path ?? process.cwd());
-    const manifestInfo = findProjectManifest(rootDir);
-    if (!manifestInfo.path || !manifestInfo.manifest) {
-        throw new Error("No project configured. Run `instafy project init` in this folder first.");
-    }
-    const shouldUpdate = options.unset === true || typeof options.profile === "string";
-    const currentProfile = typeof manifestInfo.manifest.profile === "string" && manifestInfo.manifest.profile.trim()
-        ? manifestInfo.manifest.profile.trim()
-        : null;
-    if (!shouldUpdate) {
-        if (options.json) {
-            console.log(JSON.stringify({ ok: true, path: manifestInfo.path, profile: currentProfile }, null, 2));
-        }
-        else {
-            console.log(kleur.green("Project profile"));
-            console.log(`Manifest: ${manifestInfo.path}`);
-            console.log(`Profile: ${currentProfile ?? kleur.yellow("(none)")}`);
-        }
-        return { path: manifestInfo.path, profile: currentProfile };
-    }
-    const nextProfileRaw = options.unset === true ? null : typeof options.profile === "string" ? options.profile.trim() : null;
-    const nextProfile = nextProfileRaw && nextProfileRaw.length > 0 ? nextProfileRaw : null;
-    if (nextProfile) {
-        getInstafyProfileConfigPath(nextProfile);
-    }
-    const updated = { ...manifestInfo.manifest };
-    if (nextProfile) {
-        updated.profile = nextProfile;
-    }
-    else {
-        delete updated.profile;
-    }
-    fs.writeFileSync(manifestInfo.path, JSON.stringify(updated, null, 2), "utf8");
-    if (options.json) {
-        console.log(JSON.stringify({ ok: true, path: manifestInfo.path, profile: nextProfile }, null, 2));
-    }
-    else {
-        console.log(kleur.green("Updated project profile."));
-        console.log(`Manifest: ${manifestInfo.path}`);
-        console.log(`Profile: ${nextProfile ?? kleur.yellow("(none)")}`);
-    }
-    return { path: manifestInfo.path, profile: nextProfile };
-}

package/dist/rathole.js

@@ -1,216 +0,0 @@
-import { spawn } from "node:child_process";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { Readable } from "node:stream";
-import { pipeline } from "node:stream/promises";
-const DEFAULT_VERSION = process.env.RATHOLE_VERSION ?? "latest";
-const DEFAULT_CACHE_DIR = process.env.RATHOLE_CACHE_DIR ?? path.join(os.homedir(), ".instafy", "rathole");
-export async function ensureRatholeBinary(options = {}) {
-    const logger = options.logger ?? (() => { });
-    const versionInput = (options.version ?? DEFAULT_VERSION).trim() || "latest";
-    const cacheRoot = path.resolve(options.cacheDir ?? DEFAULT_CACHE_DIR);
-    const plan = resolveInstallPlan();
-    if (plan.method === "cargo") {
-        return ensureRatholeViaCargo({
-            version: versionInput,
-            cacheRoot,
-            binaryName: plan.binaryName,
-            logger,
-        });
-    }
-    const tag = normalizeGithubTag(versionInput);
-    const targetDir = path.join(cacheRoot, tag, plan.assetName.replace(/\.zip$/i, ""));
-    const binaryPath = path.join(targetDir, plan.binaryName);
-    try {
-        await fs.promises.access(binaryPath, fs.constants.X_OK);
-        return binaryPath;
-    }
-    catch {
-        // continue and attempt download
-    }
-    await fs.promises.mkdir(targetDir, { recursive: true });
-    const downloadUrl = buildDownloadUrl(plan.assetName, tag);
-    logger(`Downloading rathole (${plan.assetName}) from ${downloadUrl}`);
-    const tempFile = path.join(targetDir, `${plan.assetName}.${Date.now()}.download`);
-    try {
-        await downloadFile(downloadUrl, tempFile, options.fetchImpl);
-        await extractZip(tempFile, targetDir);
-    }
-    finally {
-        await safeUnlink(tempFile);
-    }
-    if (!(await fileExists(binaryPath))) {
-        throw new Error(`rathole binary missing after extraction (${binaryPath})`);
-    }
-    if (process.platform !== "win32") {
-        await fs.promises.chmod(binaryPath, 0o755);
-    }
-    logger(`rathole ready at ${binaryPath}`);
-    return binaryPath;
-}
-function resolveInstallPlan() {
-    const arch = process.arch;
-    const platform = process.platform;
-    if (platform === "darwin") {
-        if (arch === "arm64") {
-            return {
-                method: "download",
-                assetName: "rathole-x86_64-apple-darwin.zip",
-                binaryName: "rathole",
-            };
-        }
-        if (arch === "x64") {
-            return {
-                method: "download",
-                assetName: "rathole-x86_64-apple-darwin.zip",
-                binaryName: "rathole",
-            };
-        }
-        throw new Error(`Unsupported platform ${platform}/${arch} for prebuilt rathole; set RATHOLE_BIN or install via cargo.`);
-    }
-    if (platform === "linux") {
-        if (arch === "arm64") {
-            return {
-                method: "download",
-                assetName: "rathole-aarch64-unknown-linux-musl.zip",
-                binaryName: "rathole",
-            };
-        }
-        if (arch === "x64") {
-            return {
-                method: "download",
-                assetName: "rathole-x86_64-unknown-linux-gnu.zip",
-                binaryName: "rathole",
-            };
-        }
-        throw new Error(`Unsupported platform ${platform}/${arch}. Set RATHOLE_BIN to a valid executable.`);
-    }
-    if (platform === "win32") {
-        if (arch !== "x64") {
-            throw new Error(`Unsupported platform ${platform}/${arch}. Set RATHOLE_BIN to a valid executable.`);
-        }
-        return {
-            method: "download",
-            assetName: "rathole-x86_64-pc-windows-msvc.zip",
-            binaryName: "rathole.exe",
-        };
-    }
-    throw new Error(`Unsupported platform ${platform}/${arch}. Set RATHOLE_BIN to a valid executable.`);
-}
-function normalizeGithubTag(raw) {
-    const trimmed = raw.trim();
-    if (!trimmed || trimmed.toLowerCase() === "latest") {
-        return "latest";
-    }
-    return trimmed.startsWith("v") ? trimmed : `v${trimmed}`;
-}
-function buildDownloadUrl(assetName, tag) {
-    const base = tag === "latest"
-        ? "https://github.com/rapiz1/rathole/releases/latest/download"
-        : `https://github.com/rapiz1/rathole/releases/download/${tag}`;
-    return `${base}/${assetName}`;
-}
-async function downloadFile(url, destination, fetchImpl) {
-    const fetcher = fetchImpl ?? fetch;
-    const response = await fetcher(url);
-    if (!response.ok || !response.body) {
-        const text = await response.text().catch(() => "");
-        throw new Error(`failed to download rathole (${response.status}): ${text}`);
-    }
-    const nodeStream = typeof Readable.fromWeb === "function"
-        ? Readable.fromWeb(response.body)
-        : response.body;
-    await pipeline(nodeStream, fs.createWriteStream(destination));
-}
-async function extractZip(archivePath, targetDir) {
-    const cmd = process.platform === "win32" ? "powershell.exe" : "unzip";
-    const args = process.platform === "win32"
-        ? [
-            "-NoProfile",
-            "-NonInteractive",
-            "-Command",
-            `Expand-Archive -LiteralPath '${escapePowershellString(archivePath)}' -DestinationPath '${escapePowershellString(targetDir)}' -Force`,
-        ]
-        : ["-o", archivePath, "-d", targetDir];
-    await new Promise((resolve, reject) => {
-        const child = spawn(cmd, args);
-        child.on("error", reject);
-        child.on("close", (code) => {
-            if (code === 0) {
-                resolve();
-            }
-            else {
-                reject(new Error(`${cmd} exited with code ${code ?? -1}`));
-            }
-        });
-    });
-}
-function escapePowershellString(value) {
-    return value.replace(/'/g, "''");
-}
-async function ensureRatholeViaCargo(params) {
-    const tag = normalizeGithubTag(params.version);
-    const installRoot = path.join(params.cacheRoot, tag, "cargo");
-    const binPath = path.join(installRoot, "bin", params.binaryName);
-    try {
-        await fs.promises.access(binPath, fs.constants.X_OK);
-        return binPath;
-    }
-    catch {
-        // continue
-    }
-    await fs.promises.mkdir(installRoot, { recursive: true });
-    const crateVersion = tag === "latest" ? null : tag.replace(/^v/, "").trim() || null;
-    params.logger(crateVersion
-        ? `Installing rathole ${crateVersion} via cargo (arm64 macOS fallback)...`
-        : "Installing rathole via cargo (arm64 macOS fallback)...");
-    const argsLocked = ["install", "rathole", "--locked", "--root", installRoot];
-    const argsUnlocked = ["install", "rathole", "--root", installRoot];
-    if (crateVersion) {
-        argsLocked.push("--version", crateVersion);
-        argsUnlocked.push("--version", crateVersion);
-    }
-    const runCargoInstall = async (args) => await new Promise((resolve, reject) => {
-        const child = spawn("cargo", args, { stdio: "inherit" });
-        child.on("error", (error) => {
-            reject(new Error(`failed to run cargo install for rathole (${String(error)}). Install Rust/cargo or set RATHOLE_BIN.`));
-        });
-        child.on("close", (code) => {
-            if (code === 0) {
-                resolve();
-            }
-            else {
-                reject(new Error(`cargo install exited with code ${code ?? -1}`));
-            }
-        });
-    });
-    try {
-        await runCargoInstall(argsLocked);
-    }
-    catch (error) {
-        params.logger(`cargo install --locked failed (${error instanceof Error ? error.message : String(error)}); retrying without --locked...`);
-        await runCargoInstall(argsUnlocked);
-    }
-    if (!(await fileExists(binPath))) {
-        throw new Error(`rathole binary missing after cargo install (${binPath})`);
-    }
-    return binPath;
-}
-async function fileExists(candidate) {
-    try {
-        await fs.promises.access(candidate, fs.constants.X_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function safeUnlink(filePath) {
-    try {
-        await fs.promises.unlink(filePath);
-    }
-    catch {
-        // ignore
-    }
-}