return classification?.kind === "reason" ? classification.reason : null;

}

function normalizeErrorSignal(err: unknown): FailoverSignal {

function normalizeErrorSignal(err: unknown, providerHint?: string): FailoverSignal {

const message = getErrorMessage(err);

return {

status: getStatusCode(err),

code: getErrorCode(err),

message: message || undefined,

provider: getProvider(err),

provider: getProvider(err) ?? providerHint,

};

}

err: unknown,

seen: Set<object>,

depth: number,

providerHint?: string,

): FailoverClassification | null {

if (depth > MAX_FAILOVER_CAUSE_DEPTH) {

return null;

reason: err.reason,

};

}

const signal = normalizeErrorSignal(err);

const signal = normalizeErrorSignal(err, providerHint);

const codeReason = signal.code

? failoverReasonFromClassification(classifyFailoverSignal({ code: signal.code }))

: null;

candidate,

seen,

depth + 1,

providerHint,

);

if (nestedClassification) {

if (hasSessionLock && !hasExplicitFailoverMetadata) {

return null;

}

function resolveFailoverClassificationFromError(err: unknown): FailoverClassification | null {

return resolveFailoverClassificationFromErrorInternal(err, new Set<object>(), 0);

function resolveFailoverClassificationFromError(

err: unknown,

providerHint?: string,

): FailoverClassification | null {

return resolveFailoverClassificationFromErrorInternal(err, new Set<object>(), 0, providerHint);

}

export function resolveFailoverReasonFromError(err: unknown): FailoverReason | null {

return failoverReasonFromClassification(resolveFailoverClassificationFromError(err));

export function resolveFailoverReasonFromError(

err: unknown,

providerHint?: string,

): FailoverReason | null {

return failoverReasonFromClassification(

resolveFailoverClassificationFromError(err, providerHint),

);

}

export function describeFailoverError(err: unknown): {

if (isFailoverError(err)) {

return err;

}

const reason = resolveFailoverReasonFromError(err);

const reason = resolveFailoverReasonFromError(err, context?.provider);

if (!reason) {

return null;

}