@rage-against-the-pixel/unity-cli 1.8.3 → 3.0.0

package/dist/upm-cli.js

@@ -0,0 +1,469 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpmCli = void 0;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const semver_1 = require("semver");
+const logging_1 = require("./logging");
+const utilities_1 = require("./utilities");
+/**
+ * Managed Unity Package Manager CLI (unity-cli–installed `UnityPackageManager`), modeled after {@link UnityHub}:
+ * parameterless constructor resolves roots and executable preference, {@link Install} manages downloads, {@link Exec} runs the binary.
+ */
+class UpmCli {
+    /** Root directory for managed installs (~/.unity-cli/upm), analogous to {@link UnityHub.rootDirectory}. */
+    managedRoot;
+    logger = logging_1.Logger.instance;
+    constructor() {
+        this.managedRoot = path.join(os.homedir(), '.unity-cli', 'upm');
+    }
+    static getCdnBaseUrl() {
+        const override = process.env.UPM_CDN_BASE_URL?.trim();
+        if (override && override.length > 0) {
+            return `${override.replace(/\/$/, '')}/upm-cli`;
+        }
+        return 'https://cdn.packages.unity.com/upm-cli';
+    }
+    /**
+     * HTTPS URL under the UPM CLI CDN for a release file. Caller must validate `tag` (e.g. {@link UpmCli.validateVersionFormat});
+     * path segments are encoded to avoid tainted file-derived strings reaching the network unchecked (CodeQL js/file-access-to-http).
+     */
+    static buildUpmReleaseAssetUrl(cdnBase, tag, fileName) {
+        const root = new URL(`${cdnBase.replace(/\/$/, '')}/`);
+        return new URL(`releases/${encodeURIComponent(tag)}/${encodeURIComponent(fileName)}`, root).href;
+    }
+    static buildUpmLatestTxtUrl(cdnBase) {
+        return new URL('latest.txt', new URL(`${cdnBase.replace(/\/$/, '')}/`)).href;
+    }
+    static normalizeSemver(version) {
+        const normalized = (0, semver_1.valid)(version);
+        if (normalized) {
+            return normalized;
+        }
+        const coerced = (0, semver_1.coerce)(version);
+        return coerced?.version;
+    }
+    static parseVerifiedSemVerFromLine(line) {
+        const t = line.trim();
+        if (!t) {
+            return null;
+        }
+        const direct = (0, semver_1.valid)(t);
+        if (direct) {
+            const parsed = (0, semver_1.parse)(direct, false);
+            if (parsed && (0, semver_1.valid)(parsed.version)) {
+                return parsed;
+            }
+        }
+        const coerced = (0, semver_1.coerce)(t);
+        if (coerced && (0, semver_1.valid)(coerced)) {
+            return coerced;
+        }
+        return null;
+    }
+    static parseCliVersionStdout(output) {
+        const trimmed = output.trim();
+        if (!trimmed) {
+            throw new Error('Upm cli --version produced empty output.');
+        }
+        const lines = trimmed.split(/\r?\n/).map((l) => l.trim()).filter((l) => l.length > 0);
+        for (let i = lines.length - 1; i >= 0; i--) {
+            const version = UpmCli.parseVerifiedSemVerFromLine(lines[i]);
+            if (version) {
+                return version;
+            }
+        }
+        const fallback = UpmCli.parseVerifiedSemVerFromLine(trimmed);
+        if (fallback) {
+            return fallback;
+        }
+        throw new Error(`Failed to parse upm cli version: ${JSON.stringify(trimmed)}`);
+    }
+    getVersionInstallDir(version) {
+        const t = version.trim();
+        this.validateVersionFormat(t);
+        if (t.includes('..') || path.normalize(t) !== t) {
+            throw new Error(`Invalid upm cli release tag for path use: ${version}`);
+        }
+        const dir = path.join(this.managedRoot, t);
+        const resolvedDir = path.resolve(dir);
+        const resolvedRoot = path.resolve(this.managedRoot);
+        const rootPrefix = resolvedRoot.endsWith(path.sep) ? resolvedRoot : `${resolvedRoot}${path.sep}`;
+        if (resolvedDir !== resolvedRoot && !resolvedDir.startsWith(rootPrefix)) {
+            throw new Error('Resolved UPM install directory left managed root.');
+        }
+        return dir;
+    }
+    getCurrentVersionFilePath() {
+        return path.join(this.managedRoot, 'current-version.txt');
+    }
+    getPlatformId() {
+        const plat = process.platform;
+        const arch = process.arch;
+        if (plat === 'win32') {
+            if (arch === 'arm64') {
+                return 'windows-arm64';
+            }
+            return 'windows-x64';
+        }
+        if (plat === 'darwin') {
+            if (arch === 'arm64') {
+                return 'macos-arm64';
+            }
+            return 'macos-x64';
+        }
+        if (plat === 'linux') {
+            if (arch === 'arm64') {
+                return 'linux-arm64';
+            }
+            return 'linux-x64';
+        }
+        throw new Error(`Unsupported platform for upm cli: ${plat} ${arch}`);
+    }
+    validateVersionFormat(version) {
+        const t = version.trim();
+        if (!t.startsWith('v') || !(0, semver_1.valid)(t)) {
+            throw new Error(`Invalid upm cli version format: ${version}. Expected a semver release tag with leading v (e.g. v9.27.0).`);
+        }
+    }
+    findPrimaryExecutable(installDir) {
+        if (process.platform === 'win32') {
+            const exe = path.join(installDir, 'UnityPackageManager.exe');
+            if (fs.existsSync(exe)) {
+                return exe;
+            }
+        }
+        else {
+            const bin = path.join(installDir, 'UnityPackageManager');
+            if (fs.existsSync(bin)) {
+                return bin;
+            }
+        }
+        throw new Error(`Could not find UnityPackageManager binary under ${installDir}`);
+    }
+    /** Optional executable override (mirrors `UNITY_HUB_PATH` for {@link UnityHub}). */
+    getExecutablePathOverride() {
+        const p = process.env.UPM_CLI_PATH?.trim();
+        return p && p.length > 0 ? path.normalize(p) : undefined;
+    }
+    executableOverrideIsUsable() {
+        const p = this.getExecutablePathOverride();
+        if (!p) {
+            return false;
+        }
+        try {
+            fs.accessSync(p, fs.constants.R_OK | fs.constants.X_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Release tag of the managed install from `current-version.txt`, if present and valid.
+     */
+    GetInstalledReleaseTag() {
+        const currentFile = this.getCurrentVersionFilePath();
+        if (!fs.existsSync(currentFile)) {
+            return undefined;
+        }
+        try {
+            const version = fs.readFileSync(currentFile, 'utf8').trim();
+            if (!version) {
+                return undefined;
+            }
+            this.validateVersionFormat(version);
+            return version;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Path to the primary `UnityPackageManager` binary for a managed release, or `undefined` if missing.
+     */
+    ResolveManagedPrimaryPath(version) {
+        let v = version?.trim() || this.GetInstalledReleaseTag();
+        if (!v) {
+            return undefined;
+        }
+        const installDir = this.getVersionInstallDir(v);
+        try {
+            return this.findPrimaryExecutable(installDir);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Resolved path used to spawn the UPM CLI: `UPM_CLI_PATH` override when set, otherwise the managed primary binary.
+     * @throws If nothing usable is installed (mirrors Hub/Editor behavior when the executable cannot be used).
+     */
+    GetExecutablePath() {
+        const overridePath = this.getExecutablePathOverride();
+        if (overridePath) {
+            fs.accessSync(overridePath, fs.constants.R_OK | fs.constants.X_OK);
+            return overridePath;
+        }
+        const managed = this.ResolveManagedPrimaryPath();
+        if (!managed) {
+            throw new Error('Upm cli is not installed. Run `unity-cli upm-install` first.');
+        }
+        fs.accessSync(managed, fs.constants.R_OK | fs.constants.X_OK);
+        return managed;
+    }
+    /** Same role as {@link UnityHub.executable}: path used to spawn the UPM CLI (may reflect `UPM_CLI_PATH` or the managed install). */
+    get executable() {
+        return this.GetExecutablePath();
+    }
+    async GetLatestReleaseTag() {
+        const cdn = UpmCli.getCdnBaseUrl();
+        const latestUrl = UpmCli.buildUpmLatestTxtUrl(cdn);
+        const version = (await (0, utilities_1.HttpsGetText)(latestUrl)).trim();
+        this.validateVersionFormat(version);
+        return version;
+    }
+    /** True if `latestTag` is newer than the installed managed release, or nothing is installed yet. */
+    IsUpdateAvailable(latestTag) {
+        const current = this.GetInstalledReleaseTag();
+        if (!current) {
+            return true;
+        }
+        const normalizedCurrent = UpmCli.normalizeSemver(current);
+        const normalizedLatest = UpmCli.normalizeSemver(latestTag);
+        if (normalizedCurrent && normalizedLatest) {
+            return (0, semver_1.compare)(normalizedLatest, normalizedCurrent) > 0;
+        }
+        return latestTag.trim() !== current.trim();
+    }
+    /**
+     * Installs or updates the managed UPM CLI (mirrors {@link UnityHub.Install} for the Hub itself).
+     * @returns Installed release tag (e.g. v9.27.0).
+     */
+    async Install(options) {
+        const cdn = UpmCli.getCdnBaseUrl();
+        let version = options?.version?.trim();
+        if (!version || version.length === 0) {
+            version = await this.GetLatestReleaseTag();
+        }
+        version = version.trim();
+        const installDir = this.getVersionInstallDir(version);
+        const markerPath = path.join(installDir, '.unity-cli-upm-installed');
+        if (options?.skipIfInstalled !== false && fs.existsSync(markerPath)) {
+            try {
+                this.findPrimaryExecutable(installDir);
+                const recordedTag = path.basename(installDir);
+                await fs.promises.writeFile(this.getCurrentVersionFilePath(), `${recordedTag}\n`, 'utf8');
+                return version;
+            }
+            catch {
+                // reinstall
+            }
+        }
+        const platform = this.getPlatformId();
+        const zipName = `upm-${platform}.zip`;
+        const zipUrl = UpmCli.buildUpmReleaseAssetUrl(cdn, version, zipName);
+        const checksumUrl = UpmCli.buildUpmReleaseAssetUrl(cdn, version, `${zipName}.sha256`);
+        const tempRoot = path.join((0, utilities_1.GetTempDir)(), `unity-cli-upm-${Date.now()}`);
+        const resolvedTempRoot = path.resolve(tempRoot);
+        const zipPath = path.join(resolvedTempRoot, zipName);
+        const checksumPath = path.join(resolvedTempRoot, `${zipName}.sha256`);
+        try {
+            this.logger.info(`Installing upm cli ${version} (${platform})...`);
+            await (0, utilities_1.DownloadFile)(zipUrl, zipPath);
+            await (0, utilities_1.DownloadFile)(checksumUrl, checksumPath);
+            const checksumContent = (await fs.promises.readFile(checksumPath, 'utf8')).trim();
+            const expectedHash = checksumContent.split(/\s+/)[0]?.toLowerCase();
+            if (!expectedHash) {
+                throw new Error(`Could not read SHA-256 from ${checksumPath}`);
+            }
+            const actualHash = (await (0, utilities_1.Sha256FileHex)(zipPath)).toLowerCase();
+            if (actualHash !== expectedHash) {
+                throw new Error(`SHA-256 mismatch for upm cli zip. Expected ${expectedHash}, got ${actualHash}`);
+            }
+            await (0, utilities_1.DeleteDirectory)(installDir);
+            await fs.promises.mkdir(installDir, { recursive: true });
+            await (0, utilities_1.extractZipNative)(zipPath, installDir, {
+                zipUnder: resolvedTempRoot,
+                destUnder: path.resolve(this.managedRoot),
+            }, {
+                silent: false,
+                showCommand: this.logger.logLevel === logging_1.LogLevel.DEBUG
+            });
+            const primary = this.findPrimaryExecutable(installDir);
+            if (process.platform !== 'win32') {
+                try {
+                    fs.chmodSync(primary, 0o755);
+                }
+                catch {
+                    // ignore
+                }
+            }
+            const wrapperUnix = path.join(installDir, 'upm');
+            if (process.platform !== 'win32' && fs.existsSync(wrapperUnix)) {
+                try {
+                    fs.chmodSync(wrapperUnix, 0o755);
+                }
+                catch {
+                    // ignore
+                }
+            }
+            await fs.promises.writeFile(markerPath, `${new Date().toISOString()}\n`, 'utf8');
+            const recordedTag = path.basename(installDir);
+            await fs.promises.writeFile(this.getCurrentVersionFilePath(), `${recordedTag}\n`, 'utf8');
+            return version;
+        }
+        finally {
+            await (0, utilities_1.DeleteDirectory)(tempRoot);
+        }
+    }
+    /**
+     * When running in an interactive terminal, may prompt to install a missing UPM CLI or update to the latest CDN release.
+     * When not interactive, logs a warning if the running binary is older than the CDN latest (no install).
+     * Compares the running binary ({@link Version}) to {@link GetLatestReleaseTag} (including when {@code UPM_CLI_PATH} overrides the managed install).
+     * Call before {@link GetExecutablePath} / {@link Exec} for Hub-style optional install/update (e.g. pack).
+     */
+    async PromptInstallOrUpdateWhenInteractive() {
+        const overrideUsable = this.executableOverrideIsUsable();
+        const managedExe = this.ResolveManagedPrimaryPath();
+        const hasExecutable = overrideUsable || managedExe !== undefined;
+        if (!hasExecutable) {
+            if ((0, utilities_1.isInteractiveTerminalSession)()) {
+                const install = await (0, utilities_1.PromptYesNo)('The upm cli is not installed. Download and install it now?', true);
+                if (install) {
+                    await this.Install({ skipIfInstalled: false });
+                }
+            }
+            return;
+        }
+        try {
+            const latestTag = await this.GetLatestReleaseTag();
+            const latestSem = UpmCli.parseVerifiedSemVerFromLine(latestTag);
+            if (!latestSem) {
+                return;
+            }
+            const installedSem = await this.Version();
+            if ((0, semver_1.compare)(latestSem, installedSem) <= 0) {
+                return;
+            }
+            const usingOverride = overrideUsable;
+            if (!(0, utilities_1.isInteractiveTerminalSession)()) {
+                if (usingOverride) {
+                    this.logger.warn(`The upm cli (UPM_CLI_PATH) reports ${installedSem.version}, but ${latestTag} is available on the CDN. This run still uses UPM_CLI_PATH; update that binary or unset it and run unity-cli upm-install to use the managed release.`);
+                }
+                else {
+                    this.logger.warn(`The upm cli (${installedSem.version}) is older than the latest release (${latestTag}). Run unity-cli upm-install or unity-cli upm-install --auto-update to update.`);
+                }
+                return;
+            }
+            const prompt = usingOverride
+                ? `Your upm cli (UPM_CLI_PATH) reports ${installedSem.version}, but ${latestTag} is available. Install the latest to the managed location now? This run will keep using UPM_CLI_PATH until you unset it or point it at the new binary.`
+                : `A newer upm cli version is available (${installedSem.version} -> ${latestTag}). Install it now?`;
+            const shouldUpdate = await (0, utilities_1.PromptYesNo)(prompt, !usingOverride);
+            if (!shouldUpdate) {
+                return;
+            }
+            await this.Install({
+                version: latestTag,
+                skipIfInstalled: false,
+            });
+            if (usingOverride) {
+                this.logger.warn(`Installed upm cli ${latestTag} under ${this.managedRoot}. Unset UPM_CLI_PATH (or update it) so subsequent commands use the new install.`);
+            }
+        }
+        catch (error) {
+            this.logger.debug(`Failed to check for upm cli updates: ${error}`);
+        }
+    }
+    /**
+     * Executes the UPM CLI with the given arguments (mirrors {@link UnityHub.Exec}).
+     */
+    async Exec(args, options = { silent: this.logger.logLevel > logging_1.LogLevel.CI, showCommand: this.logger.logLevel <= logging_1.LogLevel.CI }) {
+        const exe = this.GetExecutablePath();
+        if (exe.includes(path.sep)) {
+            fs.accessSync(exe, fs.constants.R_OK | fs.constants.X_OK);
+        }
+        return (0, utilities_1.Exec)(exe, args, options);
+    }
+    /**
+     * Runs `--version` and returns the verified semver from the binary.
+     * @param expectedReleaseTag When set (e.g. from {@link Install}), ensures the reported semver matches this CDN release tag.
+     */
+    async Version(expectedReleaseTag) {
+        const raw = await this.Exec(['--version'], {
+            silent: true,
+            showCommand: this.logger.logLevel === logging_1.LogLevel.DEBUG,
+        });
+        const version = UpmCli.parseCliVersionStdout(raw);
+        if (expectedReleaseTag !== undefined && expectedReleaseTag.trim().length > 0) {
+            const tag = expectedReleaseTag.trim();
+            const expected = UpmCli.parseVerifiedSemVerFromLine(tag);
+            if (!expected) {
+                throw new Error(`Invalid installed upm cli release tag: ${expectedReleaseTag}`);
+            }
+            if ((0, semver_1.compare)(version, expected) !== 0) {
+                throw new Error(`Upm cli binary version mismatch: binary reported ${version.version} (--version), expected ${expected.version} (${expectedReleaseTag}).`);
+            }
+        }
+        return version;
+    }
+    /**
+     * Runs the UPM CLI `pack` subcommand (builds argv from {@link UpmPackOptions}, then {@link Exec}).
+     */
+    async Pack(options, execOptions) {
+        const orgId = options.organizationId.trim();
+        if (!orgId) {
+            throw new Error('UpmCli.Pack requires a non-empty organizationId.');
+        }
+        const args = [];
+        if (this.logger.logLevel === logging_1.LogLevel.DEBUG) {
+            args.push('--log-level', '5', '--console-log-level', '5');
+        }
+        args.push('pack', '--organization-id', orgId);
+        const dest = options.destination?.trim();
+        if (dest && dest.length > 0) {
+            args.push('--destination', dest);
+        }
+        const dir = options.packageDirectory?.trim();
+        if (dir && dir.length > 0) {
+            args.push(dir);
+        }
+        return this.Exec(args, execOptions);
+    }
+}
+exports.UpmCli = UpmCli;
+//# sourceMappingURL=upm-cli.js.map

package/dist/upm-cli.js.map

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

package/dist/utilities.d.ts

@@ -16,10 +16,38 @@ export declare function ResolvePathCandidates(globsList: string[][]): Promise<st
  * @returns The user input as a string.
  */
 export declare function PromptForSecretInput(prompt: string): Promise<string>;
+/**
+ * Prompts for y/n. Empty input uses `defaultYes` (Y/n vs y/N suffix).
+ */
+export declare function PromptYesNo(prompt: string, defaultYes: boolean): Promise<boolean>;
+/**
+ * True when stdin and stdout are TTYs and the process is not running under CI.
+ * Use before interactive prompts (readline).
+ */
+export declare function isInteractiveTerminalSession(): boolean;
+/**
+ * True when {@link process.stdout} is a TTY and the process is not running under CI.
+ * Use for terminal-only output (e.g. live tables, ANSI) that does not read from stdin.
+ * This is not the same as {@link isInteractiveTerminalSession} (which also requires a TTY on stdin for prompts).
+ */
+export declare function isStdoutTTY(): boolean;
 export type ExecOptions = {
     silent?: boolean;
     showCommand?: boolean;
+    /**
+     * Merged on top of `process.env` for the child process. When omitted, the child inherits the current environment (default `spawn` behavior).
+     */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * Substrings replaced with `*****` in streamed lines, captured output, and the logged command line.
+     * Only values with length >= 4 are applied (avoids noisy replacements). Longer literals are applied first.
+     */
+    redactLiterals?: readonly string[];
 };
+/** Dedupes, trims, drops short values, longest-first (so one secret cannot leak via another). */
+export declare function orderedRedactionSecrets(literals: readonly string[] | undefined): string[];
+/** Replaces each configured literal with `*****` everywhere it appears in `text`. */
+export declare function redactSensitiveLiterals(text: string, literals: readonly string[] | undefined): string;
 /**
  * Executes a command with arguments and options.
  * @param command The command to execute.
@@ -29,8 +57,32 @@ export type ExecOptions = {
  * @throws An error if the command returns a non-zero exit code.
  */
 export declare function Exec(command: string, args: string[], options?: ExecOptions): Promise<string>;
+/**
+ * Confines archive extraction paths before spawning tools (mitigates CodeQL `js/shell-command-constructed-from-input`).
+ * Both paths must resolve under the given roots (e.g. temp download dir and managed UPM root).
+ */
+export interface ZipExtractPathTrust {
+    /** Directory tree that must contain `zipPath` (e.g. resolved temp root for this download). */
+    zipUnder: string;
+    /** Directory tree that must contain `destDir` (e.g. managed `~/.unity-cli/upm`). */
+    destUnder: string;
+}
+/**
+ * Extracts a zip archive using OS tools (PowerShell on Windows, `unzip` elsewhere).
+ */
+export declare function extractZipNative(zipPath: string, destDir: string, pathTrust: ZipExtractPathTrust, execOptions?: ExecOptions): Promise<void>;
+/**
+ * GET an HTTPS URL and return the response body as UTF-8 text (trimmed).
+ * @throws If the response status is not 200 or the request fails.
+ */
+export declare function HttpsGetText(url: string): Promise<string>;
+/**
+ * Computes the SHA-256 digest of a file as a lowercase hex string.
+ */
+export declare function Sha256FileHex(filePath: string): Promise<string>;
 /**
  * Downloads a file from a URL to a specified path.
+ * Requires HTTP status 200 before writing. Verifies the file is readable after download.
  * @param url The URL to download from.
  * @param downloadPath The path to save the downloaded file.
  * @throws An error if the download fails or the file is not accessible after download.