@rage-against-the-pixel/unity-cli 1.0.0

package/dist/license-client.js

@@ -0,0 +1,411 @@
+"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.LicensingClient = exports.LicenseType = void 0;
+const os = __importStar(require("os"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const logging_1 = require("./logging");
+const unity_hub_1 = require("./unity-hub");
+const utilities_1 = require("./utilities");
+var LicenseType;
+(function (LicenseType) {
+    LicenseType["personal"] = "personal";
+    LicenseType["professional"] = "professional";
+    LicenseType["floating"] = "floating";
+})(LicenseType || (exports.LicenseType = LicenseType = {}));
+class LicensingClient {
+    unityHub = new unity_hub_1.UnityHub();
+    licenseClientPath;
+    licenseVersion;
+    logger = logging_1.Logger.instance;
+    constructor(licenseVersion = undefined) {
+        this.licenseVersion = licenseVersion;
+    }
+    async init() {
+        try {
+            await fs.promises.access(this.unityHub.executable, fs.constants.R_OK);
+            await fs.promises.access(this.unityHub.rootDirectory, fs.constants.R_OK);
+        }
+        catch (error) {
+            await this.unityHub.Install();
+        }
+        const licensingClientExecutable = process.platform === 'win32' ? 'Unity.Licensing.Client.exe' : 'Unity.Licensing.Client';
+        const licenseClientPath = await (0, utilities_1.ResolveGlobToPath)([this.unityHub.rootDirectory, '**', licensingClientExecutable]);
+        this.licenseClientPath = licenseClientPath;
+        await fs.promises.access(this.licenseClientPath, fs.constants.X_OK);
+        return this.licenseClientPath;
+    }
+    getUnityCommonDir() {
+        const result = process.env['UNITY_COMMON_DIR'];
+        if (result) {
+            return result;
+        }
+        const platform = os.platform();
+        switch (platform) {
+            case 'win32': {
+                const programData = process.env['PROGRAMDATA'] || 'C:\\ProgramData';
+                return path.join(programData, 'Unity');
+            }
+            case 'darwin': {
+                return '/Library/Application Support/Unity';
+            }
+            case 'linux': {
+                const dataHome = process.env['XDG_DATA_HOME'] || path.join(os.homedir(), '.local', 'share');
+                return path.join(dataHome, 'unity3d', 'Unity');
+            }
+            default:
+                throw new Error(`Failed to determine Unity common directory for platform: ${platform}`);
+        }
+    }
+    getExitCodeMessage(exitCode) {
+        switch (exitCode) {
+            case 0:
+                return 'OK';
+            case 1:
+                return 'Invalid arguments';
+            case 2:
+                return 'Invalid credentials';
+            case 3:
+                return 'Organization ID is missing';
+            case 4:
+                return 'Package Access Control List file download failed';
+            case 5:
+                return 'Context initialization failed';
+            case 6:
+                return 'Replication service initialization failed';
+            case 7:
+                return 'Orchestrator initialization failed';
+            case 8:
+                return 'Floating service initialization failed';
+            case 9:
+                return 'Package service initialization failed';
+            case 10:
+                return 'Access token initialization failed';
+            case 11:
+                return 'Multi client pipe server start failed';
+            case 12:
+                return 'License activation generation failed';
+            case 13:
+                return 'Syncing entitlements failed';
+            case 14:
+                return 'No valid entitlement found';
+            case 15:
+                return 'License update failed';
+            case 16:
+                return 'Unable to get list of user seats';
+            case 17:
+                return 'Seat activation or deactivation failed';
+            case 18:
+                return 'Getting entitlements failed';
+            case 19:
+                return 'Acquiring license failed';
+            case 20:
+                return 'Renewing floating lease failed';
+            case 21:
+                return 'Returning floating lease failed';
+            default:
+                return `Unknown Error`;
+        }
+    }
+    async patchBinary(src, dest, searchValue, replaceValue) {
+        const data = await fs.promises.readFile(src);
+        let modified = false;
+        for (let i = 0; i <= data.length - searchValue.length; i++) {
+            if (data.subarray(i, i + searchValue.length).equals(searchValue)) {
+                replaceValue.copy(data, i);
+                modified = true;
+                i += searchValue.length - 1;
+            }
+        }
+        if (!modified) {
+            throw new Error('Could not find the search value');
+        }
+        await fs.promises.writeFile(dest, data);
+    }
+    async patchLicenseVersion() {
+        if (!this.licenseVersion) {
+            // check if the UNITY_EDITOR_PATH is set. If it is, use it to determine the license version
+            const unityEditorPath = process.env['UNITY_EDITOR_PATH'];
+            if (unityEditorPath) {
+                const versionMatch = unityEditorPath.match(/(\d+)\.(\d+)\.(\d+)/);
+                if (!versionMatch) {
+                    this.licenseVersion = '6.x'; // default to 6.x if version cannot be determined
+                }
+                else {
+                    switch (versionMatch[1]) {
+                        case '4':
+                            this.licenseVersion = '4.x';
+                            break;
+                        case '5':
+                            this.licenseVersion = '5.x';
+                            break;
+                        default:
+                            this.licenseVersion = '6.x'; // default to 6.x for any other
+                            break;
+                    }
+                }
+            }
+            if (!this.licenseVersion) {
+                this.licenseVersion = '6.x'; // default to 6.x if not set
+            }
+        }
+        if (this.licenseVersion === '6.x') {
+            return;
+        }
+        if (this.licenseVersion !== '5.x' && this.licenseVersion !== '4.x') {
+            this.logger.warn(`Warning: Specified license version '${this.licenseVersion}' is unsupported, skipping`);
+            return;
+        }
+        if (!this.licenseClientPath) {
+            this.licenseClientPath = await this.init();
+        }
+        const clientDirectory = path.dirname(this.licenseClientPath);
+        const patchedDirectory = path.join(os.tmpdir(), `UnityLicensingClient-${this.licenseVersion.replace('.', '_')}`);
+        if (await fs.promises.mkdir(patchedDirectory, { recursive: true }) === undefined) {
+            this.logger.info('Unity Licensing Client was already patched, reusing');
+        }
+        else {
+            let found = false;
+            for (const fileName of await fs.promises.readdir(clientDirectory)) {
+                if (fileName === 'Unity.Licensing.EntitlementResolver.dll') {
+                    await this.patchBinary(path.join(clientDirectory, fileName), path.join(patchedDirectory, fileName), Buffer.from('6.x', 'utf16le'), Buffer.from(this.licenseVersion, 'utf16le'));
+                    found = true;
+                }
+                else {
+                    await fs.promises.symlink(path.join(clientDirectory, fileName), path.join(patchedDirectory, fileName));
+                }
+            }
+            if (!found) {
+                throw new Error('Could not find Unity.Licensing.EntitlementResolver.dll in the unityhub installation');
+            }
+        }
+        this.licenseClientPath = path.join(patchedDirectory, path.basename(this.licenseClientPath));
+        const unityCommonDir = this.getUnityCommonDir();
+        const legacyLicenseFile = path.join(unityCommonDir, `Unity_v${this.licenseVersion}.ulf`);
+        await fs.promises.mkdir(unityCommonDir, { recursive: true });
+        try {
+            await fs.promises.symlink(path.join(patchedDirectory, 'Unity_lic.ulf'), legacyLicenseFile);
+        }
+        catch (error) {
+            if (error && error.code === 'EEXIST') {
+                await fs.promises.unlink(legacyLicenseFile);
+                await fs.promises.symlink(path.join(patchedDirectory, 'Unity_lic.ulf'), legacyLicenseFile);
+            }
+            else {
+                throw error;
+            }
+        }
+        process.env['UNITY_COMMON_DIR'] = patchedDirectory;
+    }
+    async exec(args) {
+        await this.patchLicenseVersion();
+        if (!this.licenseClientPath) {
+            this.licenseClientPath = await this.init();
+        }
+        let output = '';
+        let exitCode = 0;
+        function processOutput(data) {
+            const chunk = data.toString();
+            output += chunk;
+        }
+        this.logger.startGroup(`\x1b[34m${this.licenseClientPath} ${args.join(' ')}\x1b[0m`);
+        await fs.promises.access(this.licenseClientPath, fs.constants.R_OK | fs.constants.X_OK);
+        try {
+            exitCode = await new Promise((resolve, reject) => {
+                fs.accessSync(this.licenseClientPath, fs.constants.R_OK | fs.constants.X_OK);
+                const child = (0, child_process_1.spawn)(this.licenseClientPath, args, {
+                    stdio: ['ignore', 'pipe', 'pipe']
+                });
+                process.once('SIGINT', () => child.kill('SIGINT'));
+                process.once('SIGTERM', () => child.kill('SIGTERM'));
+                child.stdout.on('data', processOutput);
+                child.stderr.on('data', processOutput);
+                child.on('error', (error) => reject(error));
+                child.on('close', (code) => {
+                    process.stdout.write('\n');
+                    resolve(code === null ? 0 : code);
+                });
+            });
+        }
+        finally {
+            const maskedOutput = this.maskSerialInOutput(output);
+            const splitLines = maskedOutput.split(/\r?\n/);
+            for (const line of splitLines) {
+                if (line === undefined || line.length === 0) {
+                    continue;
+                }
+                this.logger.info(line);
+            }
+            this.logger.endGroup();
+            if (exitCode !== 0) {
+                const message = this.getExitCodeMessage(exitCode);
+                throw new Error(`License command failed with exit code ${exitCode}: ${message}`);
+            }
+        }
+        return output;
+    }
+    maskSerialInOutput(output) {
+        return output.replace(/([\w-]+-XXXX)/g, (_, serial) => {
+            const maskedSerial = serial.slice(0, -4) + `XXXX`;
+            this.logger.mask(maskedSerial);
+            return serial;
+        });
+    }
+    async Version() {
+        await this.exec(['--version']);
+    }
+    async Activate(licenseType, servicesConfig = undefined, serial = undefined, username = undefined, password = undefined) {
+        let activeLicenses = await this.showEntitlements();
+        if (activeLicenses.includes(licenseType)) {
+            this.logger.info(`License of type '${licenseType}' is already active, skipping activation`);
+            return;
+        }
+        switch (licenseType) {
+            case LicenseType.floating: {
+                if (!servicesConfig) {
+                    throw new Error('Services config path is required for floating license activation');
+                }
+                let servicesPath;
+                switch (process.platform) {
+                    case 'win32':
+                        servicesPath = path.join(process.env.PROGRAMDATA || '', 'Unity', 'config');
+                        break;
+                    case 'darwin':
+                        servicesPath = path.join('/Library', 'Application Support', 'Unity', 'config');
+                        break;
+                    case 'linux':
+                        servicesPath = path.join('/usr', 'share', 'unity3d', 'config');
+                        break;
+                    default:
+                        throw new Error(`Unsupported platform: ${process.platform}`);
+                }
+                const servicesConfigPath = path.join(servicesPath, 'services-config.json');
+                await fs.promises.writeFile(servicesConfigPath, Buffer.from(servicesConfig, 'base64'));
+                return;
+            }
+            default: { // personal and professional license activation
+                if (!username) {
+                    const encodedUsername = process.env.UNITY_USERNAME_BASE64;
+                    if (!encodedUsername) {
+                        throw Error('Username is required for Unity License Activation!');
+                    }
+                    username = Buffer.from(encodedUsername, 'base64').toString('utf-8');
+                }
+                const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+                if (username.length === 0 || !emailRegex.test(username)) {
+                    throw Error('Username must be your Unity ID email address!');
+                }
+                if (!password) {
+                    const encodedPassword = process.env.UNITY_PASSWORD_BASE64;
+                    if (!encodedPassword) {
+                        throw Error('Password is required for Unity License Activation!');
+                    }
+                    password = Buffer.from(encodedPassword, 'base64').toString('utf-8');
+                }
+                if (password.length === 0) {
+                    throw Error('Password is required for Unity License Activation!');
+                }
+                await this.activateLicense(licenseType, username, password, serial);
+            }
+        }
+    }
+    async Deactivate(licenseType) {
+        if (licenseType === LicenseType.floating) {
+            return;
+        }
+        const activeLicenses = await this.showEntitlements();
+        if (activeLicenses.includes(licenseType)) {
+            await this.returnLicense(licenseType);
+        }
+    }
+    async showEntitlements() {
+        const output = await this.exec([`--showEntitlements`]);
+        const matches = output.matchAll(/Product Name: (?<license>.+)/g);
+        const licenses = [];
+        for (const match of matches) {
+            if (match.groups?.license) {
+                switch (match.groups.license) {
+                    case 'Unity Pro':
+                        if (!licenses.includes(LicenseType.professional)) {
+                            licenses.push(LicenseType.professional);
+                        }
+                        break;
+                    case 'Unity Personal':
+                        if (!licenses.includes(LicenseType.personal)) {
+                            licenses.push(LicenseType.personal);
+                        }
+                        break;
+                    default:
+                        throw Error(`Unsupported license type: ${match.groups.license}`);
+                }
+            }
+        }
+        return licenses;
+    }
+    async activateLicense(licenseType, username, password, serial = undefined) {
+        const args = [
+            `--activate-ulf`,
+            `--username`, username,
+            `--password`, password
+        ];
+        if (serial !== undefined && serial.length > 0) {
+            serial = serial.trim();
+            args.push(`--serial`, serial);
+            const maskedSerial = serial.slice(0, -4) + `XXXX`;
+            this.logger.mask(maskedSerial);
+        }
+        if (licenseType === LicenseType.personal) {
+            args.push(`--include-personal`);
+        }
+        await this.exec(args);
+        const activeLicenses = await this.showEntitlements();
+        if (!activeLicenses.includes(licenseType)) {
+            throw new Error(`Failed to activate license of type '${licenseType}'`);
+        }
+        this.logger.info(`Successfully activated license of type '${licenseType}'`);
+    }
+    async returnLicense(licenseType) {
+        await this.exec([`--return-ulf`]);
+        const activeLicenses = await this.showEntitlements();
+        if (activeLicenses.includes(licenseType)) {
+            throw new Error(`Failed to return license of type '${licenseType}'`);
+        }
+        this.logger.info(`Successfully returned license of type '${licenseType}'`);
+    }
+}
+exports.LicensingClient = LicensingClient;
+//# sourceMappingURL=license-client.js.map

package/dist/license-client.js.map

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

package/dist/logging.d.ts

@@ -0,0 +1,44 @@
+export declare enum LogLevel {
+    DEBUG = "debug",
+    CI = "ci",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+export declare class Logger {
+    logLevel: LogLevel;
+    private _ci;
+    static instance: Logger;
+    private constructor();
+    /**
+     * Logs a message to the console.
+     * @param level The log level for this message.
+     * @param message The message to log.
+     * @param optionalParams Additional parameters to log.
+     */
+    log(level: LogLevel, message: any, optionalParams?: any[]): void;
+    /**
+     * Starts a log group. In CI environments that support grouping, this will create a collapsible group.
+     */
+    startGroup(message: any, optionalParams?: any[], logLevel?: LogLevel): void;
+    /**
+     * Ends a log group. In CI environments that support grouping, this will end the current group.
+     */
+    endGroup(): void;
+    /**
+     * Logs a message with CI level.
+     * @param message
+     * @param optionalParams
+     */
+    ci(message: any, ...optionalParams: any[]): void;
+    debug(message: any, ...optionalParams: any[]): void;
+    info(message: any, ...optionalParams: any[]): void;
+    warn(message: any, ...optionalParams: any[]): void;
+    error(message: any, ...optionalParams: any[]): void;
+    private shouldLog;
+    /**
+     * Masks a string in the console output in CI environments that support it.
+     * @param message The string to mask.
+     */
+    mask(message: string): void;
+}

package/dist/logging.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = exports.LogLevel = void 0;
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["CI"] = "ci";
+    LogLevel["INFO"] = "info";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+class Logger {
+    logLevel = LogLevel.INFO;
+    _ci;
+    static instance = new Logger();
+    constructor() {
+        if (process.env.GITHUB_ACTIONS) {
+            this._ci = 'GITHUB_ACTIONS';
+            this.logLevel = process.env.ACTIONS_STEP_DEBUG === 'true' ? LogLevel.DEBUG : LogLevel.CI;
+        }
+        Logger.instance = this;
+    }
+    /**
+     * Logs a message to the console.
+     * @param level The log level for this message.
+     * @param message The message to log.
+     * @param optionalParams Additional parameters to log.
+     */
+    log(level, message, optionalParams = []) {
+        if (this.shouldLog(level)) {
+            switch (this._ci) {
+                case 'GITHUB_ACTIONS': {
+                    switch (level) {
+                        case LogLevel.DEBUG: {
+                            message.toString().split('\n').forEach((line) => {
+                                process.stdout.write(`::debug::${line}\n`, ...optionalParams);
+                            });
+                            break;
+                        }
+                        case LogLevel.CI:
+                        case LogLevel.INFO: {
+                            process.stdout.write(`${message}\n`, ...optionalParams);
+                            break;
+                        }
+                        default: {
+                            process.stdout.write(`::${level}::${message}\n`, ...optionalParams);
+                            break;
+                        }
+                    }
+                    break;
+                }
+                default: {
+                    const clear = '\x1b[0m';
+                    const stringColor = {
+                        [LogLevel.DEBUG]: '\x1b[35m', // Purple
+                        [LogLevel.INFO]: clear, // No color / White
+                        [LogLevel.CI]: clear, // No color / White
+                        [LogLevel.WARN]: '\x1b[33m', // Yellow
+                        [LogLevel.ERROR]: '\x1b[31m', // Red
+                    }[level] || clear; // Default to no color / White
+                    process.stdout.write(`${stringColor}${message}${clear}\n`, ...optionalParams);
+                    break;
+                }
+            }
+        }
+    }
+    /**
+     * Starts a log group. In CI environments that support grouping, this will create a collapsible group.
+     */
+    startGroup(message, optionalParams = [], logLevel = LogLevel.INFO) {
+        switch (this._ci) {
+            case 'GITHUB_ACTIONS': {
+                // if there is newline in message, only use the first line for group title
+                // then print the rest of the lines inside the group in cyan color
+                const firstLine = message.toString().split('\n')[0];
+                const restLines = message.toString().split('\n').slice(1);
+                const cyan = '\x1b[36m';
+                const clear = '\x1b[0m';
+                process.stdout.write(`::group::${firstLine}\n`, ...optionalParams);
+                restLines.forEach(line => {
+                    process.stdout.write(`${cyan}${line}${clear}\n`, ...optionalParams);
+                });
+                break;
+            }
+            default: {
+                // No grouping in standard console
+                this.log(logLevel, message, optionalParams);
+                break;
+            }
+        }
+    }
+    /**
+     * Ends a log group. In CI environments that support grouping, this will end the current group.
+     */
+    endGroup() {
+        switch (this._ci) {
+            case 'GITHUB_ACTIONS': {
+                process.stdout.write(`::endgroup::\n`);
+                break;
+            }
+            default: {
+                break; // No grouping in standard console
+            }
+        }
+    }
+    /**
+     * Logs a message with CI level.
+     * @param message
+     * @param optionalParams
+     */
+    ci(message, ...optionalParams) {
+        this.log(LogLevel.CI, message, optionalParams);
+    }
+    debug(message, ...optionalParams) {
+        this.log(LogLevel.DEBUG, message, optionalParams);
+    }
+    info(message, ...optionalParams) {
+        this.log(LogLevel.INFO, message, optionalParams);
+    }
+    warn(message, ...optionalParams) {
+        this.log(LogLevel.WARN, message, optionalParams);
+    }
+    error(message, ...optionalParams) {
+        this.log(LogLevel.ERROR, message, optionalParams);
+    }
+    shouldLog(level) {
+        if (level === LogLevel.CI) {
+            return true;
+        }
+        const levelOrder = [LogLevel.DEBUG, LogLevel.INFO, LogLevel.WARN, LogLevel.ERROR];
+        return levelOrder.indexOf(level) >= levelOrder.indexOf(this.logLevel);
+    }
+    /**
+     * Masks a string in the console output in CI environments that support it.
+     * @param message The string to mask.
+     */
+    mask(message) {
+        switch (this._ci) {
+            case 'GITHUB_ACTIONS': {
+                process.stdout.write(`::add-mask::${message}\n`);
+                break;
+            }
+        }
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":";;;AAAA,IAAY,QAMX;AAND,WAAY,QAAQ;IAChB,2BAAe,CAAA;IACf,qBAAS,CAAA;IACT,yBAAa,CAAA;IACb,yBAAa,CAAA;IACb,2BAAe,CAAA;AACnB,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB;AAED,MAAa,MAAM;IACR,QAAQ,GAAa,QAAQ,CAAC,IAAI,CAAC;IAClC,GAAG,CAAqB;IAChC,MAAM,CAAC,QAAQ,GAAW,IAAI,MAAM,EAAE,CAAC;IAEvC;QACI,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,GAAG,gBAAgB,CAAC;YAC5B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7F,CAAC;QAED,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAC,KAAe,EAAE,OAAY,EAAE,iBAAwB,EAAE;QAChE,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC;gBACf,KAAK,gBAAgB,CAAC,CAAC,CAAC;oBACpB,QAAQ,KAAK,EAAE,CAAC;wBACZ,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;4BAClB,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAY,EAAE,EAAE;gCACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,EAAE,GAAG,cAAc,CAAC,CAAC;4BAClE,CAAC,CAAC,CAAC;4BACH,MAAM;wBACV,CAAC;wBACD,KAAK,QAAQ,CAAC,EAAE,CAAC;wBACjB,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;4BACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,EAAE,GAAG,cAAc,CAAC,CAAC;4BACxD,MAAM;wBACV,CAAC;wBACD,OAAO,CAAC,CAAC,CAAC;4BACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,OAAO,IAAI,EAAE,GAAG,cAAc,CAAC,CAAC;4BACpE,MAAM;wBACV,CAAC;oBACL,CAAC;oBACD,MAAM;gBACV,CAAC;gBACD,OAAO,CAAC,CAAC,CAAC;oBACN,MAAM,KAAK,GAAG,SAAS,CAAC;oBACxB,MAAM,WAAW,GAAW;wBACxB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,SAAS;wBACvC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAQ,mBAAmB;wBACjD,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,EAAU,mBAAmB;wBACjD,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,EAAG,SAAS;wBACvC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM;qBACvC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAgB,8BAA8B;oBAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,GAAG,OAAO,GAAG,KAAK,IAAI,EAAE,GAAG,cAAc,CAAC,CAAC;oBAC9E,MAAM;gBACV,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,OAAY,EAAE,iBAAwB,EAAE,EAAE,WAAqB,QAAQ,CAAC,IAAI;QAC1F,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC;YACf,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACpB,0EAA0E;gBAC1E,kEAAkE;gBAClE,MAAM,SAAS,GAAW,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5D,MAAM,SAAS,GAAa,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACpE,MAAM,IAAI,GAAG,UAAU,CAAC;gBACxB,MAAM,KAAK,GAAG,SAAS,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,SAAS,IAAI,EAAE,GAAG,cAAc,CAAC,CAAC;gBACnE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;oBACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,IAAI,EAAE,GAAG,cAAc,CAAC,CAAC;gBACxE,CAAC,CAAC,CAAC;gBACH,MAAM;YACV,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACN,kCAAkC;gBAClC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;gBAC5C,MAAM;YACV,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACI,QAAQ;QACX,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC;YACf,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;gBACvC,MAAM;YACV,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACN,MAAM,CAAC,kCAAkC;YAC7C,CAAC;QACL,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,EAAE,CAAC,OAAY,EAAE,GAAG,cAAqB;QAC5C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IACnD,CAAC;IAEM,KAAK,CAAC,OAAY,EAAE,GAAG,cAAqB;QAC/C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IACtD,CAAC;IAEM,IAAI,CAAC,OAAY,EAAE,GAAG,cAAqB;QAC9C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IACrD,CAAC;IAEM,IAAI,CAAC,OAAY,EAAE,GAAG,cAAqB;QAC9C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IACrD,CAAC;IAEM,KAAK,CAAC,OAAY,EAAE,GAAG,cAAqB;QAC/C,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IACtD,CAAC;IAEO,SAAS,CAAC,KAAe;QAC7B,IAAI,KAAK,KAAK,QAAQ,CAAC,EAAE,EAAE,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClF,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1E,CAAC;IAED;;;OAGG;IACI,IAAI,CAAC,OAAe;QACvB,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC;YACf,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,OAAO,IAAI,CAAC,CAAC;gBACjD,MAAM;YACV,CAAC;QACL,CAAC;IACL,CAAC;;AA9IL,wBA+IC"}

package/dist/unity-editor.d.ts

@@ -0,0 +1,26 @@
+export interface EditorCommand {
+    args: string[];
+    projectPath?: string;
+}
+export declare class UnityEditor {
+    editorPath: string;
+    editorRootPath: string;
+    private procInfo;
+    private pidFile;
+    private logger;
+    private autoAddNoGraphics;
+    constructor(editorPath: string);
+    /**
+     * Get the full path to a Unity project template based on the provided template name or regex pattern.
+     * @param template The name or regex pattern of the template to find.
+     * @returns The full path to the matching template file.
+     * @throws Error if the template directory does not exist, no templates are found, or no matching template is found.
+     */
+    GetTemplatePath(template: string): string;
+    Run(command: EditorCommand): Promise<void>;
+    GetLogsDirectory(projectPath: string | undefined): string;
+    GenerateLogFilePath(projectPath: string | undefined, prefix?: string | undefined): string;
+    private exec;
+    private tryKillEditorProcess;
+    static GetEditorRootPath(editorPath: string): string;
+}