delivery-03-reliable-quality-utilities/src/errors.ts

import type { DiagnosticContext, FailureKind } from "./models.js";

/**
 * A small error type for boundaries where callers need a meaningful failure
 * category and safe diagnostic context. It is not a universal error hierarchy.
 */
export class QualityUtilityError extends Error {
  readonly kind: FailureKind;
  readonly context: DiagnosticContext;

  constructor(kind: FailureKind, message: string, context: DiagnosticContext, cause?: unknown) {
    super(message, cause === undefined ? undefined : { cause });
    this.name = "QualityUtilityError";
    this.kind = kind;
    this.context = context;
  }
}

export function isRetryableDependencyFailure(error: unknown): boolean {
  return error instanceof QualityUtilityError && error.kind === "dependency-failure";
}