import type { PluginCustomFieldValue, PluginGame, PluginHost, PluginInvocation, PluginSession, PluginPermission, PluginRuntimeContext, PluginGameSourceCandidate, PluginGameSourceDraft, PluginGameSourcePatch, PluginGameSourcePageCapture, PluginGameSourceSearchPayload, PluginGameSourceResolvePayload, PluginGameSourceRefreshPayload, PluginGameSourceParsePagePayload, XLibraryPlugin } from './index';
export type PluginTestNetworkResponse = {
    status: number;
    contentType?: string;
    body: string;
};
export type PluginTestCall = {
    operation: string;
    payload: unknown;
};
export type PluginValidationIssue = {
    path: Array<string | number>;
    code: string;
    message: string;
    hint?: string;
};
export declare class PluginContractValidationError extends Error {
    readonly issues: PluginValidationIssue[];
    constructor(message: string, issues: PluginValidationIssue[]);
}
export type PluginTestHostOptions = {
    plugin?: PluginRuntimeContext['plugin'];
    permissions?: PluginPermission[];
    games?: PluginGame[];
    sessions?: PluginSession[];
    settings?: Record<string, PluginCustomFieldValue>;
    storage?: Record<string, unknown>;
    cache?: Record<string, unknown>;
    gameFields?: Record<string, Record<string, PluginCustomFieldValue>>;
    importInputs?: Record<string, string | Uint8Array>;
    network?: (input: {
        url: string;
        method?: 'GET' | 'POST';
        body?: string;
        headers?: Record<string, string>;
    }) => Promise<PluginTestNetworkResponse> | PluginTestNetworkResponse;
    auth?: Record<string, {
        connected: boolean;
        expiresAt?: string;
    }>;
    authRequest?: (authId: string, input: {
        url: string;
        method?: 'GET' | 'POST';
        body?: string;
        headers?: Record<string, string>;
    }) => Promise<PluginTestNetworkResponse> | PluginTestNetworkResponse;
};
export type PluginTestHost = {
    host: PluginHost;
    context: PluginRuntimeContext;
    calls: ReadonlyArray<PluginTestCall>;
    notifications: ReadonlyArray<{
        title: string;
        message: string;
        level: 'info' | 'warn' | 'error';
    }>;
    exportChunks: readonly string[];
    diagnostics: ReadonlyArray<{
        level: 'debug' | 'info' | 'warn' | 'error';
        event: string;
        message: string;
        context?: Record<string, string | number | boolean>;
    }>;
    importInputs: ReadonlyMap<string, Uint8Array>;
    storage: ReadonlyMap<string, unknown>;
    cache: ReadonlyMap<string, {
        value: unknown;
        expiresAt: string;
    }>;
    setNow(value: Date): void;
    now(): Date;
};
/**
 * In-memory, deterministic implementation of the public plugin host contract.
 * Unknown host operations fail closed, so unit tests cannot accidentally rely
 * on capabilities that production would not grant.
 */
export declare function createPluginTestHost(options?: PluginTestHostOptions): PluginTestHost;
export declare function runPluginInvocation(plugin: XLibraryPlugin, invocation: PluginInvocation, testHost: PluginTestHost): Promise<unknown>;
export declare function assertGameSourceDraft(value: unknown): asserts value is {
    externalId: string;
    canonicalUrl: string;
    name: string;
};
export declare function assertGameSourceCandidates(value: unknown): asserts value is {
    candidates: PluginGameSourceCandidate[];
    nextCursor?: string;
};
export declare function assertBrowserPageCapture(value: unknown): asserts value is PluginGameSourcePageCapture;
export declare function assertGameSourcePatch(value: unknown): asserts value is PluginGameSourcePatch;
export declare function runGameSourceSearch(plugin: XLibraryPlugin, payload: PluginGameSourceSearchPayload, testHost: PluginTestHost): Promise<{
    candidates: PluginGameSourceCandidate[];
    nextCursor?: string;
}>;
export declare function runGameSourceResolve(plugin: XLibraryPlugin, payload: PluginGameSourceResolvePayload | PluginGameSourceParsePagePayload, testHost: PluginTestHost): Promise<PluginGameSourceDraft>;
export declare function runGameSourceRefresh(plugin: XLibraryPlugin, payload: PluginGameSourceRefreshPayload, testHost: PluginTestHost): Promise<PluginGameSourcePatch>;
export declare function createBrowserPageCapture(input?: Partial<PluginGameSourcePageCapture>): PluginGameSourcePageCapture;
//# sourceMappingURL=testing.d.ts.map