Class GeneralExpectedError

EXPECTED application-level condition — the Java-style Exception half of the error/exception split: "this failure is a known, anticipated business outcome, not a malfunction".

Purpose: classification marker, not routing

The framework does NOT pattern-match this class anywhere — it adds no special handling to gates, checks, or any other channel. It exists so APPLICATION code can split its own catch blocks the way Java splits Exception from Error:

• GeneralExpectedError (and subclasses) — anticipated conditions the caller knows how to handle gracefully (validation failed, precondition not met, user-facing refusal with a meaningful message);
• everything else — a genuine malfunction (отказ): bug, broken invariant, unexpected infrastructure failure. Treat as fatal for the current operation, log loudly, do not swallow.

try {
  await doWork();
} catch (error) {
  if (GeneralExpectedError.isGeneralExpectedError(error)) {
    notifyUser(getErrorMessage(error)); // anticipated — handle and continue
    return;
  }
  throw error; // malfunction — propagate as a failure
}
Copy

Relation to the order-error triad

OrderRejectedError, OrderDeletedError and OrderTransientError are CHANNEL-specific verdicts consumed by the framework's order machinery. GeneralExpectedError is channel-agnostic and framework-invisible: throwing it from a gate or check is treated like any other non-typed throw (the "transient" verdict). Use the triad inside broker adapters; use GeneralExpectedError in your own application layers.

Nuances

• Nominal runtime identification. Recognized by the __type__ === Symbol.for("GeneralExpectedError") brand via the static guard — never by instanceof, so it survives duplicated module instances across bundles. Subclass it freely for domain-specific expected conditions: the brand is inherited, so the single guard catches the whole family.
• The message is the user-facing payload — unlike the order triad, where the message is purely informational, here it typically carries the text shown to the human who triggered the operation.

class InsufficientBalanceError extends GeneralExpectedError {}

function assertBalance(balance: number, required: number) {
  if (balance < required) {
    throw new InsufficientBalanceError(
      `insufficient balance: have ${balance}, need ${required}`
    );
  }
}
Copy