/**
 * Common properties for exceptions.
 */
interface ExceptionOpts {
    cause?: unknown;
    context?: Record<string, unknown>;
    status?: number;
}
/**
 * Base class for exceptions with context.
 */
export declare class BaseException extends Error {
    readonly cause?: unknown;
    readonly context?: Record<string, unknown>;
    readonly status?: number;
    readonly publicMessage?: string;
    constructor(name: string, message: string, opts?: ExceptionOpts & {
        publicMessage?: string;
    });
}
/**
 * Error for authentication flow failures with context.
 */
export declare class AuthenticationException extends BaseException {
    readonly description?: string | null;
    constructor(message: string, opts?: ExceptionOpts & {
        description?: string | null;
    });
}
/**
 * Error for forbidden/blocked identities (HTTP 403).
 */
export declare class ForbiddenException extends BaseException {
    constructor(message: string, opts?: ExceptionOpts);
}
/**
 * Error for upstream resources that the OWOX Java IDP could not find
 * (HTTP 404). Typically raised when a project member was already removed
 * concurrently or when a userUid no longer exists at the IDP layer.
 * Callers can use this to offer idempotent semantics (e.g. treat
 * remove-after-remove as success) or to surface a cleaner 404 to clients.
 */
export declare class IdpNotFoundException extends BaseException {
    constructor(message: string, opts?: ExceptionOpts);
}
/**
 * Detects "state expired" errors by a consistent marker.
 */
export declare function isStateExpiredError(error: unknown): boolean;
/**
 * Error for failed requests to Identity OWOX.
 */
export declare class IdpFailedException extends BaseException {
    constructor(message: string, opts?: ExceptionOpts);
}
/**
 * Error for session resolution and authentication failures.
 */
export declare class SessionException extends BaseException {
    constructor(message: string, opts?: ExceptionOpts);
}
/**
 * Error for Identity API 4xx responses with raw body in context.
 */
export declare class IdentityApiException extends BaseException {
    constructor(message: string, opts?: ExceptionOpts);
}
export {};
//# sourceMappingURL=exceptions.d.ts.map