/** * Exceptions raised by the ordering validation battery. * * @module @nhtio/adk/batteries/validation/exceptions */ import type { BaseException } from "../../types"; import type { BlockingOrderingViolation } from "./types"; /** Thrown when ordering guard options do not satisfy the battery contract. */ export declare const E_INVALID_ORDERING_GUARD_OPTIONS: import("../../factories").CreatedException<[ string ]>; /** Thrown when a string profile name is absent from the registered profile catalog. */ export declare const E_UNKNOWN_ORDERING_PROFILE: import("../../factories").CreatedException<[ string ]>; /** A blocking ordering exception enriched with the complete violation list. */ export interface OrderingViolationException extends BaseException { /** Blocking violations that caused the dispatch rejection. */ violations: BlockingOrderingViolation[]; } /** A repair failure, retaining enough progress to reconcile a partially-mutated store. */ export interface OrderingRepairException extends BaseException { /** The original ids in the collision group being repaired. */ groupIds: string[]; /** Group members deleted before a degraded replacement failed. */ deletedIds: string[]; /** The persistence or context error that caused the repair to fail. */ cause?: unknown; } /** Thrown internally when materialising an ordering repair cannot complete. */ export declare const E_ORDERING_REPAIR_FAILED: import("../../factories").CreatedException<[ string ]>; /** Constructs a structured repair failure without losing the underlying store error. */ export declare const createOrderingRepairError: (message: string, cause: unknown, groupIds: string[], deletedIds: string[]) => OrderingRepairException; /** * Thrown when a dispatch contains blocking ordering violations. * * @remarks * This factory remains compatible with the repository's printf-style exception convention. Use * {@link createOrderingViolationError} when the structured violation list is available. */ export declare const E_ORDERING_VIOLATION: import("../../factories").CreatedException<[ number, string ]>; /** * Constructs an ordering rejection and attaches its typed blocking violation list. * * @param count - Number of blocking violations. * @param firstDetail - Human-readable detail for the first violation. * @param violations - Complete list of violations that may feed the rejection path. * @returns The enriched exception instance. */ export declare const createOrderingViolationError: (count: number, firstDetail: string, violations: BlockingOrderingViolation[]) => OrderingViolationException;