/**
 * @file esm.errors.ts
 * @description Error classes for ESM package loading, version resolution, and caching.
 */
import { PublicMcpError, InternalMcpError } from './mcp.error';
/**
 * Error thrown when loading an ESM package fails.
 */
export declare class EsmPackageLoadError extends InternalMcpError {
    readonly packageName: string;
    readonly version?: string;
    readonly originalError?: Error;
    constructor(packageName: string, version?: string, originalError?: Error);
}
/**
 * Error thrown when version resolution against the npm registry fails.
 */
export declare class EsmVersionResolutionError extends InternalMcpError {
    readonly packageName: string;
    readonly range: string;
    readonly originalError?: Error;
    constructor(packageName: string, range: string, originalError?: Error);
}
/**
 * Error thrown when an ESM package's manifest is invalid or missing.
 */
export declare class EsmManifestInvalidError extends PublicMcpError {
    readonly packageName: string;
    readonly details?: string;
    readonly mcpErrorCode: -32602;
    constructor(packageName: string, details?: string);
}
/**
 * Error thrown when ESM cache operations fail.
 */
export declare class EsmCacheError extends InternalMcpError {
    readonly operation: string;
    readonly packageName?: string;
    readonly originalError?: Error;
    constructor(operation: string, packageName?: string, originalError?: Error);
}
/**
 * Error thrown when authentication to a private npm registry fails.
 */
export declare class EsmRegistryAuthError extends PublicMcpError {
    readonly registryUrl?: string;
    readonly details?: string;
    readonly mcpErrorCode: -32001;
    constructor(registryUrl?: string, details?: string);
}
/**
 * Error thrown when a package specifier string is invalid.
 */
export declare class EsmInvalidSpecifierError extends PublicMcpError {
    readonly specifier: string;
    readonly mcpErrorCode: -32602;
    constructor(specifier: string);
}
//# sourceMappingURL=esm.errors.d.ts.map