import type { NormalizedPrototype } from '../../types/index.js';
import type { NetworkFailure } from './prototype-api.types.js';
/**
 * Coarse-grained discriminant for fetcher failures.
 *
 * - http: HTTP response was received (status is available)
 * - cors: Browser returned an opaque response (no status/code observable)
 * - network: Network/socket error without HTTP response (ENOTFOUND, ECONNREFUSED, etc.)
 * - timeout: Fetcher-level timeout (no HTTP response)
 * - abort: Caller-driven abort (AbortController)
 * - unknown: Classification failed; fall back to code UNKNOWN
 */
export type FetchFailureKind = 'http' | 'cors' | 'network' | 'timeout' | 'abort' | 'unknown';
/**
 * Canonical error codes exposed by the fetcher.
 *
 * HTTP (4xx): CLIENT_UNAUTHORIZED / CLIENT_FORBIDDEN / CLIENT_NOT_FOUND /
 * CLIENT_RATE_LIMITED / CLIENT_BAD_REQUEST / CLIENT_METHOD_NOT_ALLOWED /
 * CLIENT_TIMEOUT / CLIENT_ERROR (other 4xx)
 * HTTP (5xx): SERVER_INTERNAL_ERROR / SERVER_BAD_GATEWAY /
 * SERVER_GATEWAY_TIMEOUT / SERVER_SERVICE_UNAVAILABLE / SERVER_ERROR (other 5xx)
 * Network: NETWORK_ERROR / ECONNREFUSED / ENOTFOUND / ETIMEDOUT
 * Control: TIMEOUT (fetcher timeout), ABORTED (AbortController)
 * CORS: CORS_BLOCKED (opaque response; status/code not observable)
 * Fallback: UNKNOWN
 */
export type FetcherErrorCode = 'CLIENT_UNAUTHORIZED' | 'CLIENT_FORBIDDEN' | 'CLIENT_NOT_FOUND' | 'CLIENT_RATE_LIMITED' | 'CLIENT_BAD_REQUEST' | 'CLIENT_METHOD_NOT_ALLOWED' | 'CLIENT_TIMEOUT' | 'CLIENT_ERROR' | 'SERVER_INTERNAL_ERROR' | 'SERVER_BAD_GATEWAY' | 'SERVER_GATEWAY_TIMEOUT' | 'SERVER_SERVICE_UNAVAILABLE' | 'SERVER_ERROR' | 'NETWORK_ERROR' | 'ECONNREFUSED' | 'ENOTFOUND' | 'ETIMEDOUT' | 'TIMEOUT' | 'ABORTED' | 'CORS_BLOCKED' | 'UNKNOWN';
/**
 * Successful response from fetchPrototypes containing an array of prototypes.
 */
export type FetchPrototypesSuccess = {
    readonly ok: true;
    readonly data: NormalizedPrototype[];
};
/**
 * Failed response from fetchPrototypes with error details.
 */
export type FetchPrototypesFailure = {
    readonly ok: false;
    /** Always fetcher-originated. */
    readonly origin: 'fetcher';
    /** Coarse-grained classification of the failure cause. */
    readonly kind: FetchFailureKind;
    /** Canonicalized error code (in addition to details.res.code). */
    readonly code: FetcherErrorCode;
    /** Human-readable error message. */
    readonly error: string;
} & Omit<NetworkFailure, 'error'>;
/**
 * Result type for fetchPrototypes function - either success with data or failure with error.
 */
export type FetchPrototypesResult = FetchPrototypesSuccess | FetchPrototypesFailure;
/**
 * Successful response from fetchRandomPrototype containing a single prototype.
 */
export type FetchRandomPrototypeSuccess = {
    readonly ok: true;
    readonly data: NormalizedPrototype;
};
/**
 * Failed response from fetchRandomPrototype (same as FetchPrototypesFailure).
 */
export type FetchRandomPrototypeFailure = FetchPrototypesFailure;
/**
 * Result type for fetchRandomPrototype function - either success with single prototype or failure.
 */
export type FetchRandomPrototypeResult = FetchRandomPrototypeSuccess | FetchRandomPrototypeFailure;
/**
 * Result type for fetchPrototypeById function - either success with single prototype or failure.
 */
export type FetchPrototypeByIdResult = {
    readonly ok: true;
    readonly data: NormalizedPrototype;
} | FetchPrototypesFailure;
//# sourceMappingURL=result.types.d.ts.map