Validation

/**
 * Validation function type - returns error message or null if valid
 */
type CheckFunction = () => Promise<string | null>;

/**
 * Runs multiple validation checks and throws if any fail
 * @param checks - Array of validation functions to execute
 * @throws Throws aggregated error messages if any checks fail
 */
function check(checks: CheckFunction[]): Promise<void>;

import { check, checkWebDir, checkPackage, checkAppConfig } from "@capacitor/cli";

const config = await loadConfig();

// Run multiple validation checks
await check([
  () => checkPackage(),
  () => checkWebDir(config),
  () => checkAppConfig(config)
]);

/**
 * Checks for existence of package.json or valid NX monorepo setup
 * @returns Promise resolving to null if valid, or error message if invalid
 */
function checkPackage(): Promise<string | null>;

/**
 * Validates web directory exists and contains required index.html
 * @param config - Capacitor configuration
 * @returns Promise resolving to null if valid, or error message if invalid
 */
function checkWebDir(config: Config): Promise<string | null>;

/**
 * Validates application directory exists and is accessible
 * @param config - Capacitor configuration
 * @param dir - Directory path to validate
 * @returns Promise resolving to null if valid, or error message if invalid
 */
function checkAppDir(config: Config, dir: string): Promise<string | null>;

/**
 * Validates app configuration including app ID and app name
 * @param config - Capacitor configuration
 * @returns Promise resolving to null if valid, or error message if invalid
 */
function checkAppConfig(config: Config): Promise<string | null>;

/**
 * Validates app ID format and platform compatibility
 * @param config - Capacitor configuration
 * @param id - App ID to validate
 * @returns Promise resolving to null if valid, or error message if invalid
 */
function checkAppId(config: Config, id: string): Promise<string | null>;

/**
 * Validates app name format and requirements
 * @param config - Capacitor configuration
 * @param name - App name to validate
 * @returns Promise resolving to null if valid, or error message if invalid
 */
function checkAppName(config: Config, name: string): Promise<string | null>;

import { checkAppConfig, checkAppId, checkAppName } from "@capacitor/cli";

const config = await loadConfig();

// Validate complete app configuration
const appConfigError = await checkAppConfig(config);
if (appConfigError) {
  console.error('App config error:', appConfigError);
}

// Validate specific app ID
const appIdError = await checkAppId(config, 'com.example.myapp');
if (appIdError) {
  console.error('App ID error:', appIdError);
}

/**
 * Validates that Capacitor platform package is available
 * @param config - Capacitor configuration
 * @param platform - Platform name to validate ('ios', 'android', etc.)
 * @returns Promise resolving to null if valid, or error message if invalid
 */
function checkCapacitorPlatform(config: Config, platform: string): Promise<string | null>;

/**
 * Validates Android package availability
 * @param config - Capacitor configuration
 * @returns Promise resolving to null if valid, or error message if invalid
 */
function checkAndroidPackage(config: Config): Promise<string | null>;

/**
 * Checks Android development environment setup
 * @param config - Capacitor configuration
 */
function doctorAndroid(config: Config): Promise<void>;

/**
 * Validates iOS package availability
 * @param config - Capacitor configuration
 * @returns Promise resolving to null if valid, or error message if invalid
 */
function checkIOSPackage(config: Config): Promise<string | null>;

/**
 * Validates CocoaPods installation and configuration
 * @param config - Capacitor configuration
 * @returns Promise resolving to null if valid, or error message if invalid
 */
function checkCocoaPods(config: Config): Promise<string | null>;

/**
 * Validates Bundler installation (for CocoaPods)
 * @param config - Capacitor configuration
 * @returns Promise resolving to null if valid, or error message if invalid
 */
function checkBundler(config: Config): Promise<string | null>;

/**
 * Checks iOS development environment setup
 * @param config - Capacitor configuration
 */
function doctorIOS(config: Config): Promise<void>;

/**
 * Runs comprehensive diagnostics for project setup
 * @param config - Capacitor configuration
 * @param platform - Optional specific platform to check
 */
function doctorCommand(config: Config, platform?: string): Promise<void>;

# Check all platforms
npx cap doctor

# Check specific platform
npx cap doctor ios
npx cap doctor android

/**
 * Checks JDK major version for Android compatibility
 * @returns Promise resolving to JDK major version number
 * @throws Throws if JDK is not found or incompatible
 */
function checkJDKMajorVersion(): Promise<number>;

/**
 * Validates platform version compatibility with Capacitor core
 * @param config - Capacitor configuration
 * @param platform - Platform name to validate
 */
function checkPlatformVersions(config: Config, platform: string): Promise<void>;

/**
 * Gets version of specific Capacitor package
 * @param config - Capacitor configuration
 * @param platform - Platform package name
 * @returns Promise resolving to version string
 */
function getCapacitorPackageVersion(config: Config, platform: string): Promise<string>;

/**
 * Gets Capacitor core version
 * @param config - Capacitor configuration
 * @returns Promise resolving to core version string
 */
function getCoreVersion(config: Config): Promise<string>;

/**
 * Gets Capacitor CLI version
 * @param config - Capacitor configuration
 * @returns Promise resolving to CLI version string
 */
function getCLIVersion(config: Config): Promise<string>;

/**
 * Gets Capacitor package information if available
 * @param config - Capacitor configuration
 * @param name - Package name to look up
 * @returns Promise resolving to PackageJson or null if not found
 */
function getCapacitorPackage(config: Config, name: string): Promise<PackageJson | null>;

/**
 * Gets Capacitor package information, throwing if not available
 * @param config - Capacitor configuration
 * @param name - Package name to require
 * @returns Promise resolving to PackageJson
 * @throws Throws if package is not found
 */
function requireCapacitorPackage(config: Config, name: string): Promise<PackageJson>;

/**
 * Selects platforms to operate on, with validation
 * @param config - Capacitor configuration
 * @param selectedPlatformName - Specific platform name or undefined for all
 * @returns Promise resolving to array of valid platform names
 */
function selectPlatforms(config: Config, selectedPlatformName?: string): Promise<string[]>;

/**
 * Validates that a platform name is supported
 * @param platform - Platform name to validate
 * @returns Promise resolving to true if valid, false otherwise
 */
function isValidPlatform(platform: string): Promise<boolean>;

/**
 * Gets list of known supported platforms
 * @returns Promise resolving to array of platform names
 */
function getKnownPlatforms(): Promise<string[]>;

/**
 * Gets platforms that have been added to the project
 * @param config - Capacitor configuration
 * @returns Promise resolving to array of added platform names
 */
function getAddedPlatforms(config: Config): Promise<string[]>;

/**
 * Gets validation checks required for update operations
 * @param config - Capacitor configuration
 * @param platforms - Array of platform names to validate
 * @returns Array of validation check functions
 */
function updateChecks(config: Config, platforms: string[]): CheckFunction[];

// Web directory validation
"Could not find the web assets directory: /path/to/project/dist"
"The web assets directory must contain an index.html file"

// App configuration validation  
"Missing appId for new platform. Please add it in capacitor.config.json"
"Missing appName for new platform. Please add it in capacitor.config.json"

// Platform validation
"Could not find the ios platform. You must install it first: npm install @capacitor/ios"
"Could not find the android platform. You must install it first: npm install @capacitor/android"

// Package validation
"The Capacitor CLI needs to run at the root of an npm package"