@atelierai/uco 1.0.0

package/dist/devops/utils/manifest.js

@@ -0,0 +1,403 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { randomUUID } from 'node:crypto';
+import { isNewerVersion, isValidVersion } from './semver.js';
+import { silentLogger } from '../lib/logger.js';
+export const UCO_UNITY_PACKAGE_ID = 'com.atelierai.unity.copilot';
+// Older package ids uco must clean out of a manifest when (re)installing,
+// so a Phase-C rename leaves no dangling dependency behind.
+export const COCLI_LEGACY_UNITY_PACKAGE_IDS = ['com.ivanmurzak.unity.mcp'];
+const REGISTRY_NAME = 'package.openupm.com';
+const REGISTRY_URL = 'https://package.openupm.com';
+export const COCLI_OPENUPM_REQUIRED_SCOPES = [
+    'com.atelierai',
+    'com.ivanmurzak',
+    'extensions.unity',
+    'org.nuget.com.ivanmurzak',
+    'org.nuget.microsoft',
+    'org.nuget.system',
+    'org.nuget.r3',
+];
+const COCLI_INSTALL_OPENUPM_REQUIRED_SCOPES = ['extensions.unity'];
+export class AtomicManifestReplaceError extends Error {
+    temporaryPath;
+    replacementError;
+    cleanupError;
+    constructor(temporaryPath, replacementError, cleanupError) {
+        const replacementMessage = replacementError instanceof Error
+            ? replacementError.message
+            : String(replacementError);
+        const cleanupMessage = cleanupError instanceof Error ? cleanupError.message : String(cleanupError);
+        super(`Atomic manifest replacement failed (${replacementMessage}); cleanup also failed `
+            + `and the temporary manifest may remain at ${temporaryPath} (${cleanupMessage}).`, { cause: new AggregateError([replacementError, cleanupError]) });
+        this.name = 'AtomicManifestReplaceError';
+        this.temporaryPath = temporaryPath;
+        this.replacementError = replacementError;
+        this.cleanupError = cleanupError;
+    }
+}
+const manifestFileSystem = {
+    statSync: (filePath) => fs.statSync(filePath),
+    writeFileSync: (filePath, content, options) => fs.writeFileSync(filePath, content, options),
+    renameSync: (oldPath, newPath) => fs.renameSync(oldPath, newPath),
+    unlinkSync: (filePath) => fs.unlinkSync(filePath),
+};
+/** Same-directory unique write followed by atomic replacement. */
+export function atomicReplaceManifest(manifestPath, content, fileSystem = manifestFileSystem) {
+    const mode = fileSystem.statSync(manifestPath).mode;
+    const temporaryPath = path.join(path.dirname(manifestPath), `.${path.basename(manifestPath)}.${process.pid}.${randomUUID()}.tmp`);
+    let temporaryExists = false;
+    try {
+        // Mark ownership before the call: a filesystem can create/partially write
+        // the file and still throw. ENOENT during cleanup means creation never
+        // happened and is the only safe cleanup error to ignore.
+        temporaryExists = true;
+        fileSystem.writeFileSync(temporaryPath, content, { encoding: 'utf8', mode, flag: 'wx' });
+        fileSystem.renameSync(temporaryPath, manifestPath);
+        temporaryExists = false;
+    }
+    catch (replacementError) {
+        if (temporaryExists) {
+            try {
+                fileSystem.unlinkSync(temporaryPath);
+            }
+            catch (cleanupError) {
+                if (cleanupError?.code === 'ENOENT') {
+                    throw replacementError;
+                }
+                throw new AtomicManifestReplaceError(temporaryPath, replacementError, cleanupError);
+            }
+        }
+        throw replacementError;
+    }
+}
+function isNonSemverPackageSource(value) {
+    return ['file:', 'git:', 'git+', 'ssh:', 'http:', 'https:']
+        .some((prefix) => value.toLowerCase().startsWith(prefix));
+}
+export function inspectPluginManifest(projectPath) {
+    const manifestPath = path.join(projectPath, 'Packages', 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+        throw new Error(`manifest.json not found at: ${manifestPath}`);
+    }
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    const activeSource = manifest.dependencies?.[UCO_UNITY_PACKAGE_ID];
+    return {
+        manifestPath,
+        activeSource,
+        activeSourceIsNonSemver: activeSource !== undefined && isNonSemverPackageSource(activeSource),
+    };
+}
+/**
+ * Resolve the latest plugin version from the OpenUPM registry.
+ * Throws an error with actionable suggestions if the network request fails.
+ *
+ * @param logger Optional logger. Defaults to `silentLogger` so library
+ *   callers stay side-effect-free; CLI call sites must pass a chalk-
+ *   styled logger adapter explicitly to preserve the historical output.
+ */
+export async function resolveLatestVersion(logger = silentLogger) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    try {
+        const res = await fetch(`https://package.openupm.com/${UCO_UNITY_PACKAGE_ID}`, {
+            signal: controller.signal,
+            headers: { Accept: 'application/json' },
+        });
+        if (res.ok) {
+            const data = await res.json();
+            const latest = data !== null && typeof data === 'object' && !Array.isArray(data)
+                ? data['dist-tags']
+                : undefined;
+            const latestValue = latest !== null && typeof latest === 'object' && !Array.isArray(latest)
+                ? latest['latest']
+                : undefined;
+            if (typeof latestValue === 'string'
+                && latestValue === latestValue.trim()
+                && !/[\u0000-\u001f\u007f]/.test(latestValue)
+                && isValidVersion(latestValue)) {
+                logger.info(`Resolved latest version from OpenUPM: ${latestValue}`);
+                return latestValue;
+            }
+            throw new Error('OpenUPM returned an invalid latest plugin version. '
+                + 'Retry, or run `uco install-plugin <project> --version <version>`.');
+        }
+        throw new Error(`OpenUPM returned status ${res.status}. ` +
+            'Check your network connection and retry, or run `uco install-plugin <project> --version <version>`.');
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes('uco install-plugin')) {
+            throw err;
+        }
+        throw new Error('Failed to resolve latest plugin version from OpenUPM. ' +
+            'Check your network connection and retry, or run `uco install-plugin <project> --version <version>`.');
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Determines if the version should be updated.
+ * Only update if the new version is higher than the current version.
+ * Ports the C# Installer.ShouldUpdateVersion() logic.
+ */
+export function shouldUpdateVersion(currentVersion, newVersion) {
+    if (!currentVersion)
+        return true;
+    if (!newVersion)
+        return false;
+    // Skip automatic update for non-semver specs (file:, git+, http, etc.)
+    const nonSemverPrefixes = ['file:', 'git+', 'http:', 'https:'];
+    if (nonSemverPrefixes.some((prefix) => currentVersion.startsWith(prefix))) {
+        return false;
+    }
+    if (isValidVersion(currentVersion) && isValidVersion(newVersion)) {
+        return isNewerVersion(currentVersion, newVersion);
+    }
+    // Automatic resolution never overwrites an unrecognised dependency value.
+    // Explicit --version retains force semantics in addPluginToManifest.
+    return false;
+}
+/**
+ * Add Unity-MCP plugin to a Unity project's Packages/manifest.json.
+ * Ports the C# Installer.Manifest.cs logic:
+ * - Adds OpenUPM scoped registry with required scopes
+ * - Adds/updates the plugin dependency
+ * - When force is false (auto-resolved version): never downgrades
+ * - When force is true (user-specified --plugin-version): allows downgrade
+ *
+ * @param logger Optional logger. Defaults to `silentLogger` so library
+ *   callers stay side-effect-free; CLI call sites must pass a chalk-
+ *   styled logger adapter explicitly to preserve the historical output.
+ */
+export function addPluginToManifest(projectPath, version, force = false, logger = silentLogger, fileSystem = manifestFileSystem) {
+    const manifestPath = path.join(projectPath, 'Packages', 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+        throw new Error(`manifest.json not found at: ${manifestPath}`);
+    }
+    const rawJson = fs.readFileSync(manifestPath, 'utf-8');
+    const manifest = JSON.parse(rawJson);
+    let modified = false;
+    // --- Ensure scopedRegistries array exists
+    if (!manifest.scopedRegistries) {
+        manifest.scopedRegistries = [];
+        modified = true;
+    }
+    // --- Find or create the OpenUPM registry
+    let openUpmRegistry = manifest.scopedRegistries.find((r) => r.name === REGISTRY_NAME);
+    if (!openUpmRegistry) {
+        openUpmRegistry = {
+            name: REGISTRY_NAME,
+            url: REGISTRY_URL,
+            scopes: [],
+        };
+        manifest.scopedRegistries.push(openUpmRegistry);
+        modified = true;
+    }
+    if (openUpmRegistry.url !== REGISTRY_URL) {
+        openUpmRegistry.url = REGISTRY_URL;
+        modified = true;
+    }
+    // --- Add missing scopes
+    if (!openUpmRegistry.scopes) {
+        openUpmRegistry.scopes = [];
+        modified = true;
+    }
+    for (const scope of COCLI_OPENUPM_REQUIRED_SCOPES) {
+        if (!openUpmRegistry.scopes.includes(scope)) {
+            openUpmRegistry.scopes.push(scope);
+            modified = true;
+        }
+    }
+    // --- Add/update dependency (version-aware, never downgrade)
+    if (!manifest.dependencies) {
+        manifest.dependencies = {};
+        modified = true;
+    }
+    for (const legacyId of COCLI_LEGACY_UNITY_PACKAGE_IDS) {
+        if (manifest.dependencies[legacyId] !== undefined) {
+            delete manifest.dependencies[legacyId];
+            modified = true;
+        }
+    }
+    const currentVersion = manifest.dependencies[UCO_UNITY_PACKAGE_ID];
+    let resolvedVersion = version;
+    if (!currentVersion || force || shouldUpdateVersion(currentVersion, version)) {
+        manifest.dependencies[UCO_UNITY_PACKAGE_ID] = version;
+        modified = true;
+    }
+    else {
+        resolvedVersion = currentVersion;
+        logger.info(`Plugin already at version ${currentVersion} (>= ${version}). Skipping version update. Use \`uco install-plugin <project> --version <version>\` to force a specific version.`);
+    }
+    // --- Write back
+    if (modified) {
+        atomicReplaceManifest(manifestPath, JSON.stringify(manifest, null, 2) + '\n', fileSystem);
+        logger.success(`Updated ${manifestPath}`);
+    }
+    else {
+        logger.info('manifest.json is already up to date.');
+    }
+    return { modified, resolvedVersion, manifestPath };
+}
+/**
+ * Patch `Packages/manifest.json` for the uco `install` flow.
+ *
+ *   - Set `dependencies["com.atelierai.unity.copilot"]` to the chosen sourcing
+ *     spec (file:, git, or embed).
+ *   - Strip the OpenUPM `org.nuget.com.ivanmurzak.*` scopes from any
+ *     existing `scopedRegistries[].scopes` array (we ship DLLs directly,
+ *     so OpenUPM must not race the install and re-introduce upstream
+ *     binaries).
+ *   - Keep the OpenUPM `extensions.unity` scope needed by the embedded
+ *     plugin's Unity package dependencies.
+ *   - If another scopedRegistry ends up with zero scopes after stripping,
+ *     remove that registry entry.
+ *
+ * Idempotent: re-running with the same spec is a no-op.
+ *
+ * NB: this is intentionally separate from `addPluginToManifest`, which
+ *     installs the plugin itself from OpenUPM. uco's install path only
+ *     keeps scopes needed by transitive Unity packages.
+ */
+export function setPluginInManifest(projectPath, spec, logger = silentLogger, fileSystem = manifestFileSystem) {
+    const manifestPath = path.join(projectPath, 'Packages', 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+        throw new Error(`manifest.json not found at: ${manifestPath}`);
+    }
+    const rawJson = fs.readFileSync(manifestPath, 'utf-8');
+    const manifest = JSON.parse(rawJson);
+    let modified = false;
+    const removedScopes = [];
+    // --- Compute the new dependency value
+    let dependencyValue;
+    switch (spec.kind) {
+        case 'file': {
+            // Normalize: Unity wants forward slashes after `file:`.
+            const normalized = spec.path.replace(/\\/g, '/');
+            dependencyValue = `file:${normalized}`;
+            break;
+        }
+        case 'git':
+            dependencyValue = spec.url;
+            break;
+        case 'embed':
+            // Embedded packages live under <target>/Packages/<name>/ — Unity
+            // resolves them implicitly from the directory; the manifest entry
+            // typically points at the embedded folder via `file:` syntax.
+            dependencyValue = `file:./${UCO_UNITY_PACKAGE_ID}`;
+            break;
+        default: {
+            const _exhaustive = spec;
+            throw new Error(`Unknown plugin spec kind: ${JSON.stringify(_exhaustive)}`);
+        }
+    }
+    // --- Replace dependency
+    if (!manifest.dependencies) {
+        manifest.dependencies = {};
+        modified = true;
+    }
+    // Drop legacy package keys so a project installed before the Phase C
+    // rename doesn't keep a stale dependency pointing at a now-renamed (and
+    // therefore non-existent) file: path — Unity would fail to resolve it.
+    for (const legacyId of COCLI_LEGACY_UNITY_PACKAGE_IDS) {
+        if (manifest.dependencies[legacyId] !== undefined) {
+            delete manifest.dependencies[legacyId];
+            modified = true;
+        }
+    }
+    if (manifest.dependencies[UCO_UNITY_PACKAGE_ID] !== dependencyValue) {
+        manifest.dependencies[UCO_UNITY_PACKAGE_ID] = dependencyValue;
+        modified = true;
+    }
+    // --- Strip OpenUPM org.nuget.com.ivanmurzak.* scopes so OpenUPM
+    //     cannot race-install upstream NuGet packages over our staged DLLs.
+    const registries = Array.isArray(manifest.scopedRegistries)
+        ? manifest.scopedRegistries
+        : [];
+    const filteredRegistries = [];
+    for (const reg of registries) {
+        if (!Array.isArray(reg.scopes)) {
+            filteredRegistries.push(reg);
+            continue;
+        }
+        const before = reg.scopes.length;
+        const kept = reg.scopes.filter((s) => {
+            const drop = s === 'org.nuget.com.ivanmurzak' || s.startsWith('org.nuget.com.ivanmurzak.');
+            if (drop)
+                removedScopes.push(s);
+            return !drop;
+        });
+        if (kept.length !== before) {
+            modified = true;
+            reg.scopes = kept;
+        }
+        if (kept.length === 0) {
+            // Drop it here; required OpenUPM scopes are restored below.
+            modified = true;
+            continue;
+        }
+        filteredRegistries.push(reg);
+    }
+    // --- Keep OpenUPM available for Unity-package dependencies that are not
+    //     part of uco's staged NuGet DLL set (currently PlayerPrefsEx).
+    let openUpmRegistry = filteredRegistries.find((reg) => reg.name === REGISTRY_NAME);
+    if (!openUpmRegistry) {
+        openUpmRegistry = {
+            name: REGISTRY_NAME,
+            url: REGISTRY_URL,
+            scopes: [],
+        };
+        filteredRegistries.push(openUpmRegistry);
+        modified = true;
+    }
+    if (openUpmRegistry.url !== REGISTRY_URL) {
+        openUpmRegistry.url = REGISTRY_URL;
+        modified = true;
+    }
+    if (!Array.isArray(openUpmRegistry.scopes)) {
+        openUpmRegistry.scopes = [];
+        modified = true;
+    }
+    for (const scope of COCLI_INSTALL_OPENUPM_REQUIRED_SCOPES) {
+        if (!openUpmRegistry.scopes.includes(scope)) {
+            openUpmRegistry.scopes.push(scope);
+            modified = true;
+        }
+    }
+    manifest.scopedRegistries = filteredRegistries;
+    if (modified) {
+        atomicReplaceManifest(manifestPath, JSON.stringify(manifest, null, 2) + '\n', fileSystem);
+        logger.success(`Patched ${manifestPath}`);
+    }
+    else {
+        logger.info('manifest.json is already up to date.');
+    }
+    return { modified, manifestPath, dependencyValue, removedScopes };
+}
+/**
+ * Remove Unity-MCP plugin from a Unity project's Packages/manifest.json.
+ * Only removes the plugin dependency — scoped registries and scopes are
+ * left untouched because other packages may depend on them.
+ *
+ * @param logger Optional logger. Defaults to `silentLogger` so library
+ *   callers stay side-effect-free; CLI call sites must pass a chalk-
+ *   styled logger adapter explicitly to preserve the historical output.
+ */
+export function removePluginFromManifest(projectPath, logger = silentLogger, fileSystem = manifestFileSystem) {
+    const manifestPath = path.join(projectPath, 'Packages', 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+        throw new Error(`manifest.json not found at: ${manifestPath}`);
+    }
+    const rawJson = fs.readFileSync(manifestPath, 'utf-8');
+    const manifest = JSON.parse(rawJson);
+    if (!manifest.dependencies || !(UCO_UNITY_PACKAGE_ID in manifest.dependencies)) {
+        logger.info('Unity-MCP plugin is not installed. Nothing to remove.');
+        return { removed: false, manifestPath };
+    }
+    delete manifest.dependencies[UCO_UNITY_PACKAGE_ID];
+    atomicReplaceManifest(manifestPath, JSON.stringify(manifest, null, 2) + '\n', fileSystem);
+    logger.success(`Removed ${UCO_UNITY_PACKAGE_ID} from ${manifestPath}`);
+    return { removed: true, manifestPath };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/devops/utils/manifest.js.map

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

package/dist/devops/utils/port.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generate a deterministic port from a directory path.
+ * Ports the C# UnityMcpPlugin.GeneratePortFromDirectory() logic.
+ * SHA256 hash of lowercased directory → first 4 bytes as uint32 → modulo 10000 + 20000.
+ */
+export declare function generatePortFromDirectory(dir: string): number;

package/dist/devops/utils/port.js

@@ -0,0 +1,19 @@
+import { createHash } from 'crypto';
+const MIN_PORT = 20000;
+const MAX_PORT = 29999;
+const PORT_RANGE = MAX_PORT - MIN_PORT + 1;
+/**
+ * Generate a deterministic port from a directory path.
+ * Ports the C# UnityMcpPlugin.GeneratePortFromDirectory() logic.
+ * SHA256 hash of lowercased directory → first 4 bytes as uint32 → modulo 10000 + 20000.
+ */
+export function generatePortFromDirectory(dir) {
+    const hash = createHash('sha256')
+        .update(dir.toLowerCase())
+        .digest();
+    // Read first 4 bytes as little-endian int32, then treat as unsigned
+    const int32 = hash.readInt32LE(0);
+    const uint32 = int32 >>> 0;
+    return MIN_PORT + (uint32 % PORT_RANGE);
+}
+//# sourceMappingURL=port.js.map

package/dist/devops/utils/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../../src/devops/utils/port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,QAAQ,GAAG,KAAK,CAAC;AACvB,MAAM,QAAQ,GAAG,KAAK,CAAC;AACvB,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;SACzB,MAAM,EAAE,CAAC;IAEZ,oEAAoE;IACpE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,CAAC;IAE3B,OAAO,QAAQ,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;AAC1C,CAAC"}

package/dist/devops/utils/probe.d.ts

@@ -0,0 +1,15 @@
+export declare const PING_ENDPOINT = "/api/system-tools/ping";
+export interface ProbeSuccess {
+    ok: true;
+    baseUrl: string;
+    data: unknown;
+}
+export interface ProbeFailure {
+    ok: false;
+    reason: string;
+}
+export type ProbeResult = ProbeSuccess | ProbeFailure;
+/**
+ * Probe an MCP server's ping endpoint. Returns structured result.
+ */
+export declare function probe(baseUrl: string, headers: Record<string, string>, timeoutMs: number): Promise<ProbeResult>;

package/dist/devops/utils/probe.js

@@ -0,0 +1,58 @@
+import { verbose } from './ui.js';
+export const PING_ENDPOINT = '/api/system-tools/ping';
+/**
+ * Probe an MCP server's ping endpoint. Returns structured result.
+ */
+export async function probe(baseUrl, headers, timeoutMs) {
+    const endpoint = `${baseUrl}${PING_ENDPOINT}`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(endpoint, {
+            method: 'POST',
+            headers,
+            body: '{}',
+            signal: controller.signal,
+        });
+        const text = await response.text();
+        if (response.ok) {
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                data = text;
+            }
+            return { ok: true, baseUrl, data };
+        }
+        verbose(`[${baseUrl}] HTTP ${response.status} — not ready yet`);
+        return { ok: false, reason: `HTTP ${response.status}` };
+    }
+    catch (err) {
+        const cause = err instanceof Error && 'cause' in err ? err.cause : null;
+        const code = cause?.code ?? '';
+        const isAbort = err instanceof Error && err.name === 'AbortError';
+        let reason;
+        if (isAbort) {
+            reason = 'timed out';
+            verbose(`[${baseUrl}] probe timed out`);
+        }
+        else if (code === 'ECONNREFUSED') {
+            reason = 'connection refused';
+            verbose(`[${baseUrl}] connection refused`);
+        }
+        else if (code === 'ECONNRESET') {
+            reason = 'connection reset';
+            verbose(`[${baseUrl}] connection reset`);
+        }
+        else {
+            reason = err instanceof Error ? err.message : String(err);
+            verbose(`[${baseUrl}] probe failed: ${reason}`);
+        }
+        return { ok: false, reason };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=probe.js.map

package/dist/devops/utils/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../../src/devops/utils/probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,CAAC,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAetD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,OAAe,EACf,OAA+B,EAC/B,SAAiB;IAEjB,MAAM,QAAQ,GAAG,GAAG,OAAO,GAAG,aAAa,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YACrC,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,IAAI,IAAa,CAAC;YAClB,IAAI,CAAC;gBAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,IAAI,GAAG,IAAI,CAAC;YAAC,CAAC;YACvD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACrC,CAAC;QAED,OAAO,CAAC,IAAI,OAAO,UAAU,QAAQ,CAAC,MAAM,kBAAkB,CAAC,CAAC;QAChE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,IAAI,OAAO,IAAI,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,KAAmC,CAAC,CAAC,CAAC,IAAI,CAAC;QACvG,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;QAElE,IAAI,MAAc,CAAC;QACnB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,GAAG,WAAW,CAAC;YACrB,OAAO,CAAC,IAAI,OAAO,mBAAmB,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;YACnC,MAAM,GAAG,oBAAoB,CAAC;YAC9B,OAAO,CAAC,IAAI,OAAO,sBAAsB,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YACjC,MAAM,GAAG,kBAAkB,CAAC;YAC5B,OAAO,CAAC,IAAI,OAAO,oBAAoB,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,OAAO,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/devops/utils/semver.d.ts

@@ -0,0 +1,4 @@
+/** Returns true only for a complete SemVer 2.0.0 version. */
+export declare function isValidVersion(version: string): boolean;
+/** Returns true if `latest` has strictly greater SemVer precedence. */
+export declare function isNewerVersion(current: string, latest: string): boolean;

package/dist/devops/utils/semver.js

@@ -0,0 +1,75 @@
+const SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/;
+function parseVersion(version) {
+    const match = SEMVER.exec(version);
+    if (match === null)
+        return null;
+    const prerelease = match[4]?.split('.') ?? [];
+    // Numeric prerelease identifiers must not contain leading zeroes. The
+    // main expression already rejects empty and non-SemVer identifiers.
+    if (prerelease.some((identifier) => /^\d+$/.test(identifier)
+        && identifier.length > 1
+        && identifier.startsWith('0'))) {
+        return null;
+    }
+    return {
+        major: BigInt(match[1]),
+        minor: BigInt(match[2]),
+        patch: BigInt(match[3]),
+        prerelease,
+    };
+}
+/** Returns true only for a complete SemVer 2.0.0 version. */
+export function isValidVersion(version) {
+    return parseVersion(version) !== null;
+}
+function compareIdentifiers(a, b) {
+    const aNumeric = /^\d+$/.test(a);
+    const bNumeric = /^\d+$/.test(b);
+    if (aNumeric && bNumeric) {
+        const aValue = BigInt(a);
+        const bValue = BigInt(b);
+        return aValue < bValue ? -1 : aValue > bValue ? 1 : 0;
+    }
+    if (aNumeric !== bNumeric)
+        return aNumeric ? -1 : 1;
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/** Returns -1 if a < b, 0 if equivalent by SemVer precedence, 1 if a > b. */
+function compareVersions(a, b) {
+    for (const key of ['major', 'minor', 'patch']) {
+        if (a[key] < b[key])
+            return -1;
+        if (a[key] > b[key])
+            return 1;
+    }
+    // A release has higher precedence than a prerelease. Build metadata is
+    // intentionally absent from ParsedSemVer because SemVer ignores it.
+    if (a.prerelease.length === 0 || b.prerelease.length === 0) {
+        if (a.prerelease.length === b.prerelease.length)
+            return 0;
+        return a.prerelease.length === 0 ? 1 : -1;
+    }
+    const length = Math.max(a.prerelease.length, b.prerelease.length);
+    for (let index = 0; index < length; index += 1) {
+        const left = a.prerelease[index];
+        const right = b.prerelease[index];
+        if (left === undefined || right === undefined) {
+            if (left === right)
+                return 0;
+            return left === undefined ? -1 : 1;
+        }
+        const compared = compareIdentifiers(left, right);
+        if (compared !== 0)
+            return compared;
+    }
+    return 0;
+}
+/** Returns true if `latest` has strictly greater SemVer precedence. */
+export function isNewerVersion(current, latest) {
+    const parsedCurrent = parseVersion(current);
+    const parsedLatest = parseVersion(latest);
+    if (parsedCurrent === null || parsedLatest === null)
+        return false;
+    return compareVersions(parsedCurrent, parsedLatest) < 0;
+}
+//# sourceMappingURL=semver.js.map

package/dist/devops/utils/semver.js.map

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