@capgo/cli/dist/src/versionHelpers.d.ts

A CLI to upload to capgo servers

/** CLI / API auto-bump levels (fix is normalized to patch at parse time) */
export type AutoBumpLevel = 'major' | 'minor' | 'patch' | 'metadata';
/** Resolver input including AI-backed classification */
export type AutoBumpInput = AutoBumpLevel | 'ai';
/** @std/semver increment release types used by auto-bump */
export type AutoBumpRelease = 'major' | 'minor' | 'patch' | 'prerelease';
/**
 * Normalize CLI/SDK auto-bump values including `ai`.
 * - bare flag / true → minor
 * - fix → patch
 * - ai → ai (resolved later via Workers AI)
 * - metadata stays metadata (mapped to prerelease increment later)
 */
export declare function normalizeAutoBumpInput(level: string | boolean | undefined | null): AutoBumpInput | undefined;
/**
 * Normalize CLI/SDK auto-bump values to concrete bump levels (excludes `ai`).
 * Prefer `normalizeAutoBumpInput` when `ai` is allowed.
 */
export declare function normalizeAutoBumpLevel(level: string | boolean | undefined | null): AutoBumpLevel | undefined;
export declare function autoBumpLevelToRelease(level: AutoBumpLevel | AutoBumpRelease): AutoBumpRelease;
/**
 * Auto-bump a semver version by the given level
 * @param currentVersion - The current version string (e.g., "1.0.0")
 * @param level - major | minor | patch | metadata | prerelease
 * @returns The bumped version or a fallback version if parsing fails
 */
export declare function autoBumpVersionBy(currentVersion: string, level?: AutoBumpLevel | AutoBumpRelease): string;
/**
 * Auto-bump a semver version by incrementing the patch number
 * @param currentVersion - The current version string (e.g., "1.0.0")
 * @returns The bumped version or a fallback version if parsing fails
 */
export declare function autoBumpVersion(currentVersion: string): string;
/**
 * Auto-bump a semver version by incrementing the minor number
 * @param currentVersion - The current version string (e.g., "1.0.0")
 * @returns The bumped version or a fallback version if parsing fails
 */
export declare function autoBumpMinorVersion(currentVersion: string): string;
/**
 * Interactively ask the user how to handle version bumping
 * @param currentVersion - The current version
 * @param context - Optional context string (e.g., "upload", "onboarding")
 * @returns The new version string or null if cancelled
 */
export declare function interactiveVersionBump(currentVersion: string, context?: string): Promise<string | null>;
/**
 * Get suggestions for alternative versions when a version already exists
 * @param existingVersion - The version that already exists
 * @returns Array of suggested alternative versions
 */
export declare function getVersionSuggestions(existingVersion: string): string[];