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

package/dist/github-actions-ci.d.ts

@@ -0,0 +1,21 @@
+import { ILoggerProvider, LoggerAnnotationOptions, LoggerProviderLevel, MarkdownTarget } from './logger-provider';
+export declare enum GitHubAnnotationLevel {
+    Notice = "notice",
+    Warning = "warning",
+    Error = "error"
+}
+/** When set to 1/true/yes/on (case-insensitive), unity-cli may append to `GITHUB_STEP_SUMMARY`. Default: off. */
+export declare function isUnityCliWorkflowSummaryEnabled(): boolean;
+export declare class GitHubActionsLoggerProvider implements ILoggerProvider {
+    readonly isCi: boolean;
+    log(level: LoggerProviderLevel, message: any, optionalParams?: any[]): void;
+    startGroup(message: any, optionalParams?: any[]): void;
+    endGroup(): void;
+    annotate(level: GitHubAnnotationLevel, message: string, options?: LoggerAnnotationOptions): void;
+    mask(message: string): void;
+    setEnvironmentVariable(name: string, value: string): void;
+    setOutput(name: string, value: string): void;
+    appendStepSummary(summary: string): void;
+    getMarkdownByteLimit(target: MarkdownTarget): number;
+    private escapeGitHubCommandValue;
+}

package/dist/github-actions-ci.js

@@ -0,0 +1,137 @@
+"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.GitHubActionsLoggerProvider = exports.GitHubAnnotationLevel = void 0;
+exports.isUnityCliWorkflowSummaryEnabled = isUnityCliWorkflowSummaryEnabled;
+const fs = __importStar(require("fs"));
+var GitHubAnnotationLevel;
+(function (GitHubAnnotationLevel) {
+    GitHubAnnotationLevel["Notice"] = "notice";
+    GitHubAnnotationLevel["Warning"] = "warning";
+    GitHubAnnotationLevel["Error"] = "error";
+})(GitHubAnnotationLevel || (exports.GitHubAnnotationLevel = GitHubAnnotationLevel = {}));
+/** When set to 1/true/yes/on (case-insensitive), unity-cli may append to `GITHUB_STEP_SUMMARY`. Default: off. */
+function isUnityCliWorkflowSummaryEnabled() {
+    const v = process.env.UNITY_CLI_WORKFLOW_SUMMARY?.trim().toLowerCase();
+    return v === '1' || v === 'true' || v === 'yes' || v === 'on';
+}
+class GitHubActionsLoggerProvider {
+    isCi = process.env.GITHUB_ACTIONS === 'true';
+    log(level, message, optionalParams = []) {
+        switch (level) {
+            case 'debug': {
+                message.toString().split('\n').forEach((line) => {
+                    process.stdout.write(`::debug::${line}\n`, ...optionalParams);
+                });
+                break;
+            }
+            case 'ci':
+            case 'info':
+                process.stdout.write(`${message}\n`, ...optionalParams);
+                break;
+            default:
+                process.stdout.write(`::${level}::${message}\n`, ...optionalParams);
+                break;
+        }
+    }
+    startGroup(message, optionalParams = []) {
+        const firstLine = message.toString().split('\n')[0];
+        process.stdout.write(`::group::${firstLine}\n`, ...optionalParams);
+    }
+    endGroup() {
+        process.stdout.write('::endgroup::\n');
+    }
+    annotate(level, message, options) {
+        const parts = [];
+        const appendPart = (key, value) => {
+            if (value === undefined || value === null) {
+                return;
+            }
+            const stringValue = value.toString();
+            if (stringValue.length === 0) {
+                return;
+            }
+            parts.push(`${key}=${this.escapeGitHubCommandValue(stringValue)}`);
+        };
+        appendPart('file', options?.file);
+        if (options?.line !== undefined && options.line > 0)
+            appendPart('line', options.line);
+        if (options?.endLine !== undefined && options.endLine > 0)
+            appendPart('endLine', options.endLine);
+        if (options?.column !== undefined && options.column > 0)
+            appendPart('col', options.column);
+        if (options?.endColumn !== undefined && options.endColumn > 0)
+            appendPart('endColumn', options.endColumn);
+        appendPart('title', options?.title);
+        const metadata = parts.length > 0 ? ` ${parts.join(',')}` : '';
+        process.stdout.write(`::${level}${metadata}::${this.escapeGitHubCommandValue(message)}\n`);
+    }
+    mask(message) {
+        process.stdout.write(`::add-mask::${message}\n`);
+    }
+    setEnvironmentVariable(name, value) {
+        const githubEnv = process.env.GITHUB_ENV;
+        if (githubEnv) {
+            fs.appendFileSync(githubEnv, `${name}=${value}\n`, { encoding: 'utf8' });
+        }
+    }
+    setOutput(name, value) {
+        const githubOutput = process.env.GITHUB_OUTPUT;
+        if (githubOutput) {
+            fs.appendFileSync(githubOutput, `${name}=${value}\n`, { encoding: 'utf8' });
+        }
+    }
+    appendStepSummary(summary) {
+        const githubSummary = process.env.GITHUB_STEP_SUMMARY;
+        if (!githubSummary) {
+            return;
+        }
+        fs.appendFileSync(githubSummary, summary, { encoding: 'utf8' });
+    }
+    getMarkdownByteLimit(target) {
+        if (target === 'workflow-summary' && isUnityCliWorkflowSummaryEnabled()) {
+            return 1024 * 1024;
+        }
+        return Number.POSITIVE_INFINITY;
+    }
+    escapeGitHubCommandValue(value) {
+        return value
+            .replace(/%/g, '%25')
+            .replace(/\r/g, '%0D')
+            .replace(/\n/g, '%0A');
+    }
+}
+exports.GitHubActionsLoggerProvider = GitHubActionsLoggerProvider;
+//# sourceMappingURL=github-actions-ci.js.map

package/dist/github-actions-ci.js.map

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

package/dist/index.d.ts

@@ -7,3 +7,4 @@ export * from './unity-project';
 export * from './unity-version';
 export * from './utilities';
 export * from './unity-logging';
+export * from './upm-cli';

package/dist/index.js

@@ -24,4 +24,5 @@ __exportStar(require("./unity-project"), exports);
 __exportStar(require("./unity-version"), exports);
 __exportStar(require("./utilities"), exports);
 __exportStar(require("./unity-logging"), exports);
+__exportStar(require("./upm-cli"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oBAAoB;AACpB,gDAA8B;AAC9B,mDAAiC;AACjC,4CAA0B;AAC1B,iDAA+B;AAC/B,8CAA4B;AAC5B,kDAAgC;AAChC,kDAAgC;AAChC,8CAA4B;AAC5B,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oBAAoB;AACpB,gDAA8B;AAC9B,mDAAiC;AACjC,4CAA0B;AAC1B,iDAA+B;AAC/B,8CAA4B;AAC5B,kDAAgC;AAChC,kDAAgC;AAChC,8CAA4B;AAC5B,kDAAgC;AAChC,4CAA0B"}

package/dist/logger-provider.d.ts

@@ -0,0 +1,35 @@
+export type MarkdownTarget = 'workflow-summary' | 'stdout';
+export type LoggerProviderLevel = 'debug' | 'ci' | 'utp' | 'info' | 'warning' | 'error';
+export type LoggerProviderAnnotationLevel = 'notice' | 'warning' | 'error';
+export interface LoggerAnnotationOptions {
+    file?: string;
+    line?: number;
+    endLine?: number;
+    column?: number;
+    endColumn?: number;
+    title?: string;
+}
+export interface ILoggerProvider {
+    readonly isCi: boolean;
+    log(level: LoggerProviderLevel, message: any, optionalParams?: any[]): void;
+    startGroup(message: any, optionalParams?: any[]): void;
+    endGroup(): void;
+    annotate(level: LoggerProviderAnnotationLevel, message: string, options?: LoggerAnnotationOptions): void;
+    mask(message: string): void;
+    setEnvironmentVariable(name: string, value: string): void;
+    setOutput(name: string, value: string): void;
+    appendStepSummary(summary: string): void;
+    getMarkdownByteLimit(target: MarkdownTarget): number;
+}
+export declare class LocalCliLoggerProvider implements ILoggerProvider {
+    readonly isCi = false;
+    log(level: LoggerProviderLevel, message: any, optionalParams?: any[]): void;
+    startGroup(message: any, optionalParams?: any[]): void;
+    endGroup(): void;
+    annotate(level: LoggerProviderAnnotationLevel, message: string): void;
+    mask(_message: string): void;
+    setEnvironmentVariable(_name: string, _value: string): void;
+    setOutput(_name: string, _value: string): void;
+    appendStepSummary(_summary: string): void;
+    getMarkdownByteLimit(_target: MarkdownTarget): number;
+}

package/dist/logger-provider.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalCliLoggerProvider = void 0;
+class LocalCliLoggerProvider {
+    isCi = false;
+    log(level, message, optionalParams = []) {
+        const stringColor = {
+            debug: '\x1b[35m',
+            ci: undefined,
+            utp: undefined,
+            info: undefined,
+            warning: '\x1b[33m',
+            error: '\x1b[31m',
+        }[level];
+        if (stringColor && stringColor.length > 0) {
+            process.stdout.write(`${stringColor}${message}\x1b[0m\n`, ...optionalParams);
+            return;
+        }
+        process.stdout.write(`${message}\n`, ...optionalParams);
+    }
+    startGroup(message, optionalParams = []) {
+        this.log('info', message, optionalParams);
+    }
+    endGroup() {
+        // no-op for local terminal
+    }
+    annotate(level, message) {
+        const mapped = level === 'error' ? 'error' : (level === 'warning' ? 'warning' : 'info');
+        this.log(mapped, message);
+    }
+    mask(_message) {
+        // no-op for local terminal
+    }
+    setEnvironmentVariable(_name, _value) {
+        // no-op for local terminal
+    }
+    setOutput(_name, _value) {
+        // no-op for local terminal
+    }
+    appendStepSummary(_summary) {
+        // no-op for local terminal
+    }
+    getMarkdownByteLimit(_target) {
+        return Number.POSITIVE_INFINITY;
+    }
+}
+exports.LocalCliLoggerProvider = LocalCliLoggerProvider;
+//# sourceMappingURL=logger-provider.js.map

package/dist/logger-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-provider.js","sourceRoot":"","sources":["../src/logger-provider.ts"],"names":[],"mappings":";;;AA0BA,MAAa,sBAAsB;IACf,IAAI,GAAG,KAAK,CAAC;IAEtB,GAAG,CAAC,KAA0B,EAAE,OAAY,EAAE,iBAAwB,EAAE;QAC3E,MAAM,WAAW,GAAuB;YACpC,KAAK,EAAE,UAAU;YACjB,EAAE,EAAE,SAAS;YACb,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,UAAU;SACpB,CAAC,KAAK,CAAC,CAAC;QACT,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,GAAG,OAAO,WAAW,EAAE,GAAG,cAAc,CAAC,CAAC;YAC7E,OAAO;QACX,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,EAAE,GAAG,cAAc,CAAC,CAAC;IAC5D,CAAC;IAEM,UAAU,CAAC,OAAY,EAAE,iBAAwB,EAAE;QACtD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAC9C,CAAC;IAEM,QAAQ;QACX,2BAA2B;IAC/B,CAAC;IAEM,QAAQ,CAAC,KAAoC,EAAE,OAAe;QACjE,MAAM,MAAM,GAAwB,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7G,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IAEM,IAAI,CAAC,QAAgB;QACxB,2BAA2B;IAC/B,CAAC;IAEM,sBAAsB,CAAC,KAAa,EAAE,MAAc;QACvD,2BAA2B;IAC/B,CAAC;IAEM,SAAS,CAAC,KAAa,EAAE,MAAc;QAC1C,2BAA2B;IAC/B,CAAC;IAEM,iBAAiB,CAAC,QAAgB;QACrC,2BAA2B;IAC/B,CAAC;IAEM,oBAAoB,CAAC,OAAuB;QAC/C,OAAO,MAAM,CAAC,iBAAiB,CAAC;IACpC,CAAC;CACJ;AAnDD,wDAmDC"}

package/dist/logging.d.ts

@@ -1,3 +1,41 @@
+import { UTP } from './utp';
+import { MarkdownTarget } from './logger-provider';
+/**
+ * Merges LogEntry/Compiler rows by message+file+line; on collision keeps the more severe entry.
+ * Exported for unit tests.
+ */
+export declare function mergeLogEntriesPreferringSeverity(candidates: UTP[]): UTP[];
+/** Single test result row for summary and CLI table. */
+export interface TestResultSummary {
+    status: string;
+    durationMs: number;
+    description: string;
+    message?: string;
+    file?: string;
+    line?: number;
+}
+/** Maps UTPTestStatus.state to display status (Unity/NUnit-style: 0 Inconclusive, 1 Passed, 2 Failed, 3 Skipped). */
+export declare function testStatusFromState(state: number | undefined): string;
+/** Converts a single TestStatus UTP to TestResultSummary. Exported for CLI use. */
+export declare function utpToTestResultSummary(e: UTP): TestResultSummary;
+/** Builds a markdown table string for test results (Status | Duration | Test). Exported for CLI use. */
+export declare function buildTestResultsTableMarkdown(testResults: TestResultSummary[], byteLimit: number, prefix?: string): string;
+/**
+ * Rich unit-test markdown block used by workflow summary and stdout.
+ * Keeps byte-budget behavior and truncation hints.
+ */
+export declare function buildUnitTestJobSummaryMarkdown(testResults: TestResultSummary[], byteLimit: number, prefix?: string): string;
+/**
+ * Truncates s to fit within maxBytes in UTF-8. If truncated, appends an ellipsis (…).
+ * If s already fits, returns s unchanged.
+ * Exported for unit tests.
+ */
+export declare function truncateStringToUtf8ByteLength(s: string, maxBytes: number): string;
+/**
+ * Removes known noise phrases from a log message for summary display.
+ * Exported for unit tests.
+ */
+export declare function stripSummaryNoiseFromLogMessage(message: string): string;
 export declare enum LogLevel {
     DEBUG = "debug",
     CI = "ci",
@@ -8,10 +46,9 @@ export declare enum LogLevel {
 }
 export declare class Logger {
     logLevel: LogLevel;
-    private readonly _ci;
+    private readonly _provider;
     static readonly instance: Logger;
     private constructor();
-    private printLine;
     /**
      * Logs a message to the console.
      * @param level The log level for this message.
@@ -49,13 +86,36 @@ export declare class Logger {
      * @param title The title of the annotation.
      */
     annotate(logLevel: LogLevel, message: string, file?: string, line?: number, endLine?: number, column?: number, endColumn?: number, title?: string): void;
-    private escapeGitHubCommandValue;
     private shouldLog;
     /**
      * Masks a string in the console output in CI environments that support it.
      * @param message The string to mask.
      */
     CI_mask(message: string): void;
+    /**
+     * Masks a credential value in CI environments before it appears in logs.
+     * This is a convenience wrapper around CI_mask for credential values.
+     * @param value The credential value to mask.
+     */
+    maskCredential(value: string | undefined): void;
+    /**
+     * Logs command-line options with sensitive information scrubbed.
+     * Automatically removes passwords, tokens, emails, and other credentials from the output.
+     * @param options The options object to log (typically from commander.js).
+     * @param optionalParams Additional parameters to log.
+     */
+    debugOptions(options: any, ...optionalParams: any[]): void;
+    /**
+     * List of sensitive option keys that should be scrubbed from debug output.
+     */
+    private readonly SENSITIVE_KEYS;
+    /**
+     * Scrubs sensitive information from an object for safe logging.
+     * Creates a deep clone of the object and replaces sensitive values with [REDACTED].
+     * @param obj The object to scrub (typically command-line options).
+     * @returns A new object with sensitive values replaced.
+     */
+    private scrubSensitiveData;
     /**
      * Sets an environment variable in CI environments that support it.
      * @param name The name of the environment variable.
@@ -63,5 +123,30 @@ export declare class Logger {
      */
     CI_setEnvironmentVariable(name: string, value: string): void;
     CI_setOutput(name: string, value: string): void;
-    CI_appendWorkflowSummary(telemetry: any[]): void;
+    private static formatDurationMs;
+    private static truncateStr;
+    private static truncateSummaryToByteLimit;
+    /**
+     * Returns the markdown byte limit for a given output target.
+     * Workflow summary may be backend constrained; stdout is intentionally uncapped.
+     */
+    getMarkdownByteLimit(target: MarkdownTarget): number;
+    CI_appendWorkflowSummary(name: string, telemetry: UTP[], options?: {
+        projectPath?: string;
+        additionalLogEntries?: UTP[];
+    }): void;
+    /**
+     * Builds summary: stats + action table + unit-test block + severity foldouts.
+     */
+    private buildSummaryTimelineAndMergedLog;
+    /**
+     * Builds summary with timeline in a <details> and merged log foldouts by severity.
+     * Used when primary builder would exceed size limit.
+     */
+    private buildSummaryCollapsibleWithMergedLog;
+    /**
+     * Fallback: list timeline (when actions exist) + unit-test block (when present) + compact count lines.
+     * Used when even collapsible summary would exceed 1 MB.
+     */
+    private buildSummaryTimelineAndCounts;
 }