@guiho/runx 0.2.6 → 0.4.0

package/library/manifest.js

@@ -1,112 +1,4 @@
-import { dirname, isAbsolute, relative, resolve } from 'node:path';
-import { Type } from '@sinclair/typebox';
-import { TypeCompiler } from '@sinclair/typebox/compiler';
-import { RunXError, invariant } from './errors.js';
-const identifier = '^[a-z][a-z0-9-]*$';
-export const CommandSchema = Type.Object({
-    uid: Type.String({ pattern: identifier }),
-    id: Type.String({ pattern: identifier }),
-    group: Type.String({ pattern: identifier }),
-    summary: Type.String({ minLength: 1 }),
-    description: Type.String({ minLength: 1 }),
-    command: Type.String({ minLength: 1 }),
-    cwd: Type.Optional(Type.String({ minLength: 1 })),
-    shell: Type.Optional(Type.Union([
-        Type.Literal('auto'),
-        Type.Literal('bash'),
-        Type.Literal('sh'),
-        Type.Literal('powershell'),
-        Type.Literal('cmd'),
-    ])),
-    tags: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
-    confirm: Type.Optional(Type.Union([Type.Literal('never'), Type.Literal('always')])),
-}, { additionalProperties: false });
-export const ManifestSchema = Type.Object({
-    version: Type.Literal(1),
-    project: Type.Optional(Type.Object({ name: Type.String({ minLength: 1 }) }, { additionalProperties: false })),
-    groups: Type.Record(Type.String({ pattern: identifier }), Type.Object({ summary: Type.String({ minLength: 1 }) }, { additionalProperties: false })),
-    commands: Type.Array(CommandSchema, { minItems: 1 }),
-}, { additionalProperties: false });
-const manifestCheck = TypeCompiler.Compile(ManifestSchema);
-export const findManifest = async (cwd, explicitFile) => {
-    if (explicitFile) {
-        const candidate = resolve(cwd, explicitFile);
-        if (await Bun.file(candidate).exists())
-            return candidate;
-        throw new RunXError(`Manifest not found: ${candidate}`);
-    }
-    let current = resolve(cwd);
-    while (true) {
-        const candidate = resolve(current, 'runx.yaml');
-        if (await Bun.file(candidate).exists())
-            return candidate;
-        const parent = dirname(current);
-        if (parent === current)
-            break;
-        current = parent;
-    }
-    throw new RunXError('No runx.yaml found. Run this command inside a configured project or pass --file <path>.');
-};
-export const readManifest = async (cwd, explicitFile) => {
-    const path = await findManifest(cwd, explicitFile);
-    let parsed;
-    try {
-        parsed = Bun.YAML.parse(await Bun.file(path).text());
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : 'Unknown YAML parsing error.';
-        throw new RunXError(`Invalid YAML in ${path}: ${message}`);
-    }
-    if (!manifestCheck.Check(parsed)) {
-        const errors = [...manifestCheck.Errors(parsed)].map((error) => `${error.path || '/'}: ${error.message}`);
-        throw new RunXError(`Invalid RunX manifest ${path}:\n${errors.join('\n')}`);
-    }
-    const manifest = parsed;
-    validateManifestSemantics(manifest, path);
-    return { manifest, path };
-};
-export const resolveCommand = (manifest, manifestPath, selector) => {
-    const commands = manifest.commands;
-    let command = commands.find((entry) => entry.uid === selector);
-    if (!command && selector.includes('/')) {
-        command = commands.find((entry) => `${entry.group}/${entry.id}` === selector);
-    }
-    if (!command && /^\d+$/.test(selector)) {
-        command = commands[Number.parseInt(selector, 10) - 1];
-    }
-    if (!command) {
-        const matches = commands.filter((entry) => entry.id === selector);
-        if (matches.length > 1) {
-            throw new RunXError(`Ambiguous command ID "${selector}". Use one of: ${matches.map((entry) => `${entry.group}/${entry.id} (${entry.uid})`).join(', ')}`);
-        }
-        command = matches[0];
-    }
-    if (!command)
-        throw new RunXError(`Unknown command selector: ${selector}`);
-    const manifestDirectory = dirname(manifestPath);
-    const commandCwd = resolve(manifestDirectory, command.cwd ?? '.');
-    const relativeCwd = relative(manifestDirectory, commandCwd);
-    invariant(!isAbsolute(relativeCwd) && !relativeCwd.startsWith('..'), `Command ${command.uid} has a cwd outside the manifest directory.`);
-    return {
-        ...command,
-        index: commands.indexOf(command) + 1,
-        selector: `${command.group}/${command.id}`,
-        manifestPath,
-        cwd: commandCwd,
-    };
-};
-const validateManifestSemantics = (manifest, path) => {
-    const uids = new Set();
-    const selectors = new Set();
-    for (const command of manifest.commands) {
-        if (!manifest.groups[command.group])
-            throw new RunXError(`Command ${command.uid} references unknown group "${command.group}" in ${path}.`);
-        if (uids.has(command.uid))
-            throw new RunXError(`Duplicate command UID "${command.uid}" in ${path}.`);
-        const selector = `${command.group}/${command.id}`;
-        if (selectors.has(selector))
-            throw new RunXError(`Duplicate command selector "${selector}" in ${path}.`);
-        uids.add(command.uid);
-        selectors.add(selector);
-    }
-};
+/**
+ * @copyright Copyright © 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+export { commandSchema as CommandSchema, findConfiguration as findManifest, manifestSchema as ManifestSchema, readManifest, resolveCommand, } from './configuration.js';

package/library/path-utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @copyright Copyright © 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+export { baseName, directoryName, homeDirectory, isAbsolutePath, joinPath, normalizePath, relativePath, resolvePath, };
+declare function normalizePath(value: string): string;
+declare function isAbsolutePath(value: string): boolean;
+declare function resolvePath(...values: string[]): string;
+declare function joinPath(...values: string[]): string;
+declare function directoryName(value: string): string;
+declare function baseName(value: string): string;
+declare function relativePath(from: string, to: string): string;
+declare function homeDirectory(): string;
+//# sourceMappingURL=path-utils.d.ts.map

package/library/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../source/path-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,QAAQ,EACR,aAAa,EACb,aAAa,EACb,cAAc,EACd,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,CAAA;AAQD,iBAAS,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoB5C;AAED,iBAAS,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,iBAAS,WAAW,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAQhD;AAED,iBAAS,QAAQ,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7C;AAED,iBAAS,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ5C;AAED,iBAAS,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvC;AAED,iBAAS,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAYtD;AAED,iBAAS,aAAa,IAAI,MAAM,CAI/B"}

package/library/path-utils.js

@@ -0,0 +1,82 @@
+/**
+ * @copyright Copyright © 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+export { baseName, directoryName, homeDirectory, isAbsolutePath, joinPath, normalizePath, relativePath, resolvePath, };
+const windowsDrivePattern = /^[A-Za-z]:[\\/]/;
+function pathSeparator(value = process.platform) {
+    return value === 'win32' ? '\\' : '/';
+}
+function normalizePath(value) {
+    const separator = pathSeparator();
+    const normalized = value.replace(/[\\/]+/g, separator);
+    const drive = windowsDrivePattern.test(normalized) ? normalized.slice(0, 2) : '';
+    const rooted = drive !== '' || normalized.startsWith(separator);
+    const parts = normalized.slice(drive.length).split(separator);
+    const output = [];
+    for (const part of parts) {
+        if (!part || part === '.')
+            continue;
+        if (part === '..') {
+            if (output.length > 0 && output.at(-1) !== '..')
+                output.pop();
+            else if (!rooted)
+                output.push(part);
+            continue;
+        }
+        output.push(part);
+    }
+    const prefix = drive ? `${drive}${separator}` : rooted ? separator : '';
+    return `${prefix}${output.join(separator)}` || (rooted ? prefix : '.');
+}
+function isAbsolutePath(value) {
+    return windowsDrivePattern.test(value) || value.startsWith('/') || value.startsWith('\\');
+}
+function resolvePath(...values) {
+    let current = '';
+    for (const value of values) {
+        if (!value)
+            continue;
+        current = isAbsolutePath(value) ? value : current ? joinPath(current, value) : value;
+    }
+    if (!isAbsolutePath(current))
+        current = joinPath(process.cwd(), current);
+    return normalizePath(current);
+}
+function joinPath(...values) {
+    return normalizePath(values.filter(Boolean).join(pathSeparator()));
+}
+function directoryName(value) {
+    const normalized = normalizePath(value);
+    const separator = pathSeparator();
+    const index = normalized.lastIndexOf(separator);
+    if (index < 0)
+        return '.';
+    if (index === 0)
+        return separator;
+    if (index === 2 && windowsDrivePattern.test(normalized))
+        return normalized.slice(0, 3);
+    return normalized.slice(0, index);
+}
+function baseName(value) {
+    const normalized = normalizePath(value);
+    const index = normalized.lastIndexOf(pathSeparator());
+    return index < 0 ? normalized : normalized.slice(index + 1);
+}
+function relativePath(from, to) {
+    const separator = pathSeparator();
+    const fromParts = normalizePath(from).split(separator);
+    const toParts = normalizePath(to).split(separator);
+    const insensitive = process.platform === 'win32';
+    let index = 0;
+    while (index < fromParts.length
+        && index < toParts.length
+        && (insensitive ? fromParts[index].toLowerCase() === toParts[index].toLowerCase() : fromParts[index] === toParts[index]))
+        index += 1;
+    return [...Array(fromParts.length - index).fill('..'), ...toParts.slice(index)].join(separator) || '.';
+}
+function homeDirectory() {
+    const home = Bun.env.HOME ?? Bun.env.USERPROFILE;
+    if (!home)
+        throw new Error('RunX requires HOME or USERPROFILE to resolve global storage.');
+    return resolvePath(home);
+}

package/library/recovery.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @copyright Copyright © 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import type { RecoveryInstructions, UpgradeOs } from './upgrade-types.js';
+export { createRecoveryInstructions };
+declare const createRecoveryInstructions: (targetVersion: string, os: UpgradeOs, targetSource?: RecoveryInstructions['targetSource'], installerBaseUrl?: string) => RecoveryInstructions;
+//# sourceMappingURL=recovery.d.ts.map

package/library/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../source/recovery.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEzE,OAAO,EAAE,0BAA0B,EAAE,CAAA;AAIrC,QAAA,MAAM,0BAA0B,kBAAmB,MAAM,MAAM,SAAS,iBAAgB,oBAAoB,CAAC,cAAc,CAAC,gCAA4C,oBAevK,CAAA"}

package/library/recovery.js

@@ -0,0 +1,23 @@
+/**
+ * @copyright Copyright © 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+export { createRecoveryInstructions };
+const rawBase = 'https://raw.githubusercontent.com/CGuiho/runx/main/devops';
+const createRecoveryInstructions = (targetVersion, os, targetSource = 'resolved', installerBaseUrl = rawBase) => {
+    if (os === 'windows') {
+        return {
+            targetVersion,
+            targetSource,
+            installCommand: `powershell.exe -NoProfile -ExecutionPolicy Bypass -Command '& ([scriptblock]::Create((Invoke-RestMethod "${installerBaseUrl}/install.ps1"))) -Version "${escapePowerShell(targetVersion)}"'`,
+            stopProcessCommand: 'powershell.exe -NoProfile -Command "Get-Process runx -ErrorAction SilentlyContinue | Stop-Process -Force"',
+        };
+    }
+    return {
+        targetVersion,
+        targetSource,
+        installCommand: `curl -fsSL ${installerBaseUrl}/install.sh | sh -s -- --version '${escapeShell(targetVersion)}'`,
+        stopProcessCommand: 'pkill -x runx',
+    };
+};
+const escapePowerShell = (value) => value.replace(/`/g, '``').replace(/"/g, '`"');
+const escapeShell = (value) => value.replace(/'/g, `'"'"'`);

package/library/release-catalog.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @copyright Copyright © 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import type { ReleaseAsset, ReleaseCatalog, UpgradeArch, UpgradeOs, UpgradeVariant } from './upgrade-types.js';
+export { assetCandidates, fetchReleaseCatalog, findCompatibleAsset, normalizeReleaseVersion, resolveUpgradePlatform, };
+declare const githubReleaseSchema: import("@sinclair/typebox").TObject<{
+    tag_name: import("@sinclair/typebox").TString;
+    draft: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    prerelease: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    published_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>>;
+    created_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>>;
+    assets: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        name: import("@sinclair/typebox").TString;
+        browser_download_url: import("@sinclair/typebox").TString;
+    }>>;
+}>;
+export type GitHubRelease = import('@sinclair/typebox').Static<typeof githubReleaseSchema>;
+export type ReleasePlatform = {
+    os: UpgradeOs;
+    arch: UpgradeArch;
+    variant: UpgradeVariant;
+};
+type FetchCatalogOptions = ReleasePlatform & {
+    currentVersion: string;
+    fetchImpl?: typeof fetch;
+};
+declare const fetchReleaseCatalog: (options: FetchCatalogOptions) => Promise<ReleaseCatalog>;
+declare const findCompatibleAsset: (release: GitHubRelease, platform: ReleasePlatform) => ReleaseAsset | null;
+declare const assetCandidates: ({ os, arch, variant }: ReleasePlatform) => string[];
+declare const resolveUpgradePlatform: (platform?: NodeJS.Platform, architecture?: NodeJS.Architecture) => ReleasePlatform;
+declare const normalizeReleaseVersion: (tag: string) => string;
+//# sourceMappingURL=release-catalog.d.ts.map

package/library/release-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-catalog.d.ts","sourceRoot":"","sources":["../source/release-catalog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAuB,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnI,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,GACvB,CAAA;AAED,QAAA,MAAM,mBAAmB;;;;;;;;;;EAUS,CAAA;AAIlC,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,EAAE,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE1F,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,SAAS,CAAA;IACb,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,cAAc,CAAA;CACxB,CAAA;AAED,KAAK,mBAAmB,GAAG,eAAe,GAAG;IAC3C,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB,CAAA;AAID,QAAA,MAAM,mBAAmB,YAAmB,mBAAmB,KAAG,OAAO,CAAC,cAAc,CAoCvF,CAAA;AAkBD,QAAA,MAAM,mBAAmB,YAAa,aAAa,YAAY,eAAe,KAAG,YAAY,GAAG,IAM/F,CAAA;AAED,QAAA,MAAM,eAAe,0BAA2B,eAAe,KAAG,MAAM,EAUvE,CAAA;AAED,QAAA,MAAM,sBAAsB,sEAA+D,eAM1F,CAAA;AAED,QAAA,MAAM,uBAAuB,QAAS,MAAM,KAAG,MAA6D,CAAA"}

package/library/release-catalog.js

@@ -0,0 +1,124 @@
+/**
+ * @copyright Copyright © 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import { Type } from '@sinclair/typebox';
+import { Value } from '@sinclair/typebox/value';
+import { compare, parse, valid } from 'semver';
+import { RunXError } from './errors.js';
+export { assetCandidates, fetchReleaseCatalog, findCompatibleAsset, normalizeReleaseVersion, resolveUpgradePlatform, };
+const githubReleaseSchema = Type.Object({
+    tag_name: Type.String(),
+    draft: Type.Optional(Type.Boolean()),
+    prerelease: Type.Optional(Type.Boolean()),
+    published_at: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+    created_at: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+    assets: Type.Array(Type.Object({
+        name: Type.String(),
+        browser_download_url: Type.String(),
+    }, { additionalProperties: true })),
+}, { additionalProperties: true });
+const githubReleasesSchema = Type.Array(githubReleaseSchema);
+const repositoryApi = 'https://api.github.com/repos/CGuiho/runx/releases';
+const fetchReleaseCatalog = async (options) => {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const releases = [];
+    let page = 1;
+    let next = true;
+    while (next) {
+        const response = await fetchImpl(`${repositoryApi}?per_page=100&page=${page}`, {
+            headers: { accept: 'application/vnd.github+json' },
+        });
+        if (!response.ok)
+            throw new RunXError(`Could not retrieve RunX releases page ${page}: HTTP ${response.status}`, 4);
+        const payload = await response.json();
+        let pageReleases;
+        try {
+            pageReleases = Value.Decode(githubReleasesSchema, payload);
+        }
+        catch {
+            throw new RunXError(`Could not retrieve RunX releases page ${page}: malformed release`, 4);
+        }
+        releases.push(...pageReleases.filter((release) => !release.draft));
+        next = hasNextPage(response.headers.get('link'));
+        page += 1;
+    }
+    const normalized = releases.map((release) => normalizeRelease(release, options));
+    normalized.sort(compareCatalogEntries);
+    const latestStableVersion = normalized.find((entry) => valid(entry.version) && !entry.prerelease)?.version ?? null;
+    for (const entry of normalized)
+        entry.latestStable = entry.version === latestStableVersion;
+    return {
+        schemaVersion: 1,
+        command: 'runx upgrade list',
+        currentVersion: options.currentVersion,
+        latestStableVersion,
+        releases: normalized,
+    };
+};
+const normalizeRelease = (release, platform) => {
+    const version = normalizeReleaseVersion(release.tag_name);
+    const parsed = parse(version);
+    const prerelease = parsed ? parsed.prerelease.length > 0 : Boolean(release.prerelease);
+    return {
+        tag: release.tag_name,
+        version,
+        channel: releaseChannel(version, prerelease),
+        prerelease,
+        publishedAt: release.published_at ?? release.created_at ?? null,
+        current: version === platform.currentVersion,
+        latestStable: false,
+        compatibleAsset: findCompatibleAsset(release, platform),
+    };
+};
+const findCompatibleAsset = (release, platform) => {
+    for (const candidate of assetCandidates(platform)) {
+        const asset = release.assets.find((item) => item.name === candidate);
+        if (asset)
+            return { name: asset.name, url: asset.browser_download_url };
+    }
+    return null;
+};
+const assetCandidates = ({ os, arch, variant }) => {
+    const suffix = os === 'windows' ? '.exe' : '';
+    if (arch === 'arm64')
+        return [`runx-${os}-arm64${suffix}`];
+    const prefix = `runx-${os}-x64`;
+    const names = {
+        baseline: [`${prefix}-baseline${suffix}`, `${prefix}${suffix}`, `${prefix}-modern${suffix}`],
+        default: [`${prefix}${suffix}`, `${prefix}-baseline${suffix}`, `${prefix}-modern${suffix}`],
+        modern: [`${prefix}-modern${suffix}`, `${prefix}${suffix}`, `${prefix}-baseline${suffix}`],
+    };
+    return names[variant];
+};
+const resolveUpgradePlatform = (platform = process.platform, architecture = process.arch) => {
+    const os = platform === 'win32' ? 'windows' : platform === 'darwin' ? 'darwin' : platform === 'linux' ? 'linux' : null;
+    const arch = architecture === 'x64' ? 'x64' : architecture === 'arm64' ? 'arm64' : null;
+    if (!os)
+        throw new RunXError(`Self-upgrade is not supported on ${platform}.`);
+    if (!arch)
+        throw new RunXError(`Self-upgrade is not supported on architecture ${architecture}.`);
+    return { os, arch, variant: 'baseline' };
+};
+const normalizeReleaseVersion = (tag) => tag.replace(/^@guiho\/runx@/, '').replace(/^v/, '');
+const releaseChannel = (version, prerelease) => {
+    const parsed = parse(version);
+    if (!parsed)
+        return 'other';
+    if (!prerelease)
+        return 'stable';
+    const identifier = parsed.prerelease[0];
+    return typeof identifier === 'string' ? identifier : 'prerelease';
+};
+const compareCatalogEntries = (left, right) => {
+    const leftValid = valid(left.version);
+    const rightValid = valid(right.version);
+    if (leftValid && rightValid)
+        return compare(rightValid, leftValid);
+    if (leftValid)
+        return -1;
+    if (rightValid)
+        return 1;
+    return timestamp(right.publishedAt) - timestamp(left.publishedAt);
+};
+const timestamp = (value) => value ? Date.parse(value) || 0 : 0;
+const hasNextPage = (link) => Boolean(link?.split(',').some((part) => /rel="next"/.test(part)));

package/library/self-management.d.ts

@@ -1,11 +1,31 @@
-import type { RunXUpgradeResult, UpdateResult } from './types.js';
-export { checkForLatestVersion, listAvailableVersions, uninstallSelf, upgradeSelf, };
+/**
+ * @copyright Copyright © 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import type { ReleaseCatalog, UpgradeEnvelope, UpgradeEvent, UpgradePlan } from './upgrade-types.js';
+import type { UpdateResult } from './types.js';
+export { checkForLatestVersion, listAvailableVersions, uninstallSelf, upgradeSelf, validateNativeBinary };
+export type UpgradeFileOperations = {
+    rename: (from: string, to: string) => Promise<void>;
+    remove: (path: string) => Promise<void>;
+    makeExecutable: (path: string) => Promise<void>;
+};
+export type UpgradeSelfOptions = {
+    dryRun: boolean;
+    currentVersion?: string;
+    requestedVersion?: string;
+    arch?: UpgradePlan['arch'];
+    variant?: import('./upgrade-types.js').UpgradeVariant;
+    onPlan?: (plan: UpgradePlan) => void;
+    onEvent?: (event: UpgradeEvent) => void;
+    fileOperations?: UpgradeFileOperations;
+};
 declare const checkForLatestVersion: () => Promise<UpdateResult>;
-declare const listAvailableVersions: () => Promise<string[]>;
-declare const upgradeSelf: (dryRun: boolean) => Promise<RunXUpgradeResult>;
+declare const listAvailableVersions: () => Promise<ReleaseCatalog>;
+declare const upgradeSelf: (input: boolean | UpgradeSelfOptions) => Promise<UpgradeEnvelope>;
 declare const uninstallSelf: (dryRun: boolean) => Promise<{
     executablePath: string;
     scheduled: boolean;
     dryRun: boolean;
 }>;
+declare const validateNativeBinary: (bytes: Uint8Array, os: UpgradePlan['os']) => void;
 //# sourceMappingURL=self-management.d.ts.map

package/library/self-management.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"self-management.d.ts","sourceRoot":"","sources":["../source/self-management.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEjE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,EACb,WAAW,GACZ,CAAA;AAMD,QAAA,MAAM,qBAAqB,QAAa,OAAO,CAAC,YAAY,CAY3D,CAAA;AAED,QAAA,MAAM,qBAAqB,QAAa,OAAO,CAAC,MAAM,EAAE,CAKvD,CAAA;AAED,QAAA,MAAM,WAAW,WAAkB,OAAO,KAAG,OAAO,CAAC,iBAAiB,CAmBrE,CAAA;AAED,QAAA,MAAM,aAAa,WAAkB,OAAO,KAAG,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAWrH,CAAA"}
+{"version":3,"file":"self-management.d.ts","sourceRoot":"","sources":["../source/self-management.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,cAAc,EAA6C,eAAe,EAAkC,YAAY,EAAgB,WAAW,EAAiB,MAAM,oBAAoB,CAAA;AAC5M,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAA;AAEzG,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,OAAO,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1B,OAAO,CAAC,EAAE,OAAO,oBAAoB,EAAE,cAAc,CAAA;IACrD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IACvC,cAAc,CAAC,EAAE,qBAAqB,CAAA;CACvC,CAAA;AAuCD,QAAA,MAAM,qBAAqB,QAAa,OAAO,CAAC,YAAY,CAS3D,CAAA;AAED,QAAA,MAAM,qBAAqB,QAAa,OAAO,CAAC,cAAc,CAG7D,CAAA;AAED,QAAA,MAAM,WAAW,UAAiB,OAAO,GAAG,kBAAkB,KAAG,OAAO,CAAC,eAAe,CA4IvF,CAAA;AAED,QAAA,MAAM,aAAa,WAAkB,OAAO,KAAG,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAWrH,CAAA;AAkFD,QAAA,MAAM,oBAAoB,UAAW,UAAU,MAAM,WAAW,CAAC,IAAI,CAAC,KAAG,IAOxE,CAAA"}