Move each error family out of domain/errors.ts into its own module (base, core, provider selection/adapter, browser observation, artifact, evidence, unknown registry, hopper, configuration) and relocate AnalysisErrorProjection to analysisErrorProjection. Migrate all 162 importers to the owning modules and delete errors.ts. No re-export shims; behavior is unchanged.
110 lines
3.4 KiB
TypeScript
110 lines
3.4 KiB
TypeScript
import { AnalysisError } from "./analysisErrorBase.js";
|
|
import {
|
|
hopperStartupFailure,
|
|
type HopperStartupDiagnostic,
|
|
type HopperStartupFailureCode,
|
|
type HopperStartupFailureDiagnostic,
|
|
} from "./hopperStartupFailure.js";
|
|
|
|
/** Base class for failures produced specifically by the Hopper provider. */
|
|
export abstract class HopperError extends AnalysisError {}
|
|
|
|
/** Hopper did not respond within the configured operation deadline. */
|
|
export class HopperTimeoutError extends HopperError {
|
|
readonly _tag = "HopperTimeoutError";
|
|
|
|
constructor(
|
|
readonly timeoutMs: number,
|
|
readonly operation?: string,
|
|
readonly requestId?: number,
|
|
readonly providerState: "busy" | "not_started" = "not_started",
|
|
) {
|
|
super(
|
|
`Hopper ${operation === undefined ? "startup" : operation} timed out after ${String(timeoutMs)}ms`,
|
|
);
|
|
}
|
|
}
|
|
|
|
/** The caller cancelled a Hopper operation before it completed. */
|
|
export class HopperCancelledError extends HopperError {
|
|
readonly _tag = "HopperCancelledError";
|
|
|
|
constructor() {
|
|
super("Hopper operation was cancelled");
|
|
}
|
|
}
|
|
|
|
/** Hopper returned bytes or JSON that do not satisfy the NDJSON RPC contract. */
|
|
export class HopperProtocolError extends HopperError {
|
|
readonly _tag = "HopperProtocolError";
|
|
}
|
|
|
|
export type HopperDiagnosticType =
|
|
| "remote"
|
|
| "authorization"
|
|
| "invalid_request"
|
|
| "capability_unavailable"
|
|
| "bridge_exception";
|
|
|
|
/** Hopper's JSON-RPC endpoint returned an expected remote error response. */
|
|
export interface HopperRemoteErrorContext {
|
|
readonly diagnosticType?: HopperDiagnosticType;
|
|
readonly operation?: string;
|
|
readonly requestId?: number;
|
|
}
|
|
|
|
export class HopperRemoteError extends HopperError {
|
|
readonly _tag = "HopperRemoteError";
|
|
readonly diagnosticType: HopperDiagnosticType;
|
|
readonly operation: string | undefined;
|
|
readonly requestId: number | undefined;
|
|
|
|
constructor(
|
|
readonly code: number,
|
|
readonly safeMessage: string,
|
|
context: HopperRemoteErrorContext = {},
|
|
) {
|
|
super(`Hopper request failed (${String(code)}): ${safeMessage}`);
|
|
this.diagnosticType = context.diagnosticType ?? "remote";
|
|
this.operation = context.operation;
|
|
this.requestId = context.requestId;
|
|
}
|
|
}
|
|
|
|
/** The owned Hopper bridge stopped before its client was closed. */
|
|
export class HopperProcessError extends HopperError {
|
|
readonly _tag = "HopperProcessError";
|
|
readonly failureCode: HopperStartupFailureCode | undefined;
|
|
override readonly userMessage: string | undefined;
|
|
|
|
constructor(
|
|
readonly exitCode: number | null,
|
|
readonly diagnostic?: HopperStartupFailureDiagnostic,
|
|
readonly operation?: string,
|
|
readonly requestId?: number,
|
|
) {
|
|
super(`Hopper bridge stopped unexpectedly with code ${String(exitCode)}`);
|
|
const failure = hopperStartupFailure(exitCode);
|
|
this.failureCode = failure?.code;
|
|
this.userMessage = failure?.message;
|
|
}
|
|
}
|
|
|
|
/** Hopper or the repository bridge could not be started. */
|
|
export class HopperStartError extends HopperError {
|
|
readonly _tag = "HopperStartError";
|
|
override readonly userMessage: string | undefined;
|
|
readonly ownerRunId: string | undefined;
|
|
|
|
constructor(
|
|
options?: ErrorOptions & {
|
|
readonly userMessage?: string;
|
|
readonly ownerRunId?: string;
|
|
},
|
|
) {
|
|
super("Hopper application bridge could not be started", options);
|
|
this.userMessage = options?.userMessage;
|
|
this.ownerRunId = options?.ownerRunId;
|
|
}
|
|
}
|