summaryrefslogtreecommitdiff
path: root/packages/taler-util/src/invariants.ts
blob: c6e9b81134b1897781892b94d9cf5ea6e9ef0cea (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
/*
 This file is part of GNU Taler
 (C) 2019-2024 Taler Systems S.A.

 GNU Taler is free software; you can redistribute it and/or modify it under the
 terms of the GNU General Public License as published by the Free Software
 Foundation; either version 3, or (at your option) any later version.

 GNU Taler is distributed in the hope that it will be useful, but WITHOUT ANY
 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
 A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

 You should have received a copy of the GNU General Public License along with
 GNU Taler; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
 */

/**
 * Helpers for invariants.
 */

/**
 * An invariant has been violated.
 */
export class InvariantViolatedError extends Error {
  constructor(message?: string) {
    super(message);
    Object.setPrototypeOf(this, InvariantViolatedError.prototype);
  }
}

/**
 * Check a database invariant.
 *
 * A violation of this invariant means that the database is inconsistent.
 */
export function checkDbInvariant(b: boolean, m?: string): asserts b {
  if (!b) {
    if (m) {
      throw Error(`BUG: database invariant failed (${m})`);
    } else {
      throw Error("BUG: database invariant failed");
    }
  }
}

/**
 * Check a logic invariant.
 *
 * A violation of this invariant means that there is a logic bug in the program.
 */
export function checkLogicInvariant(b: boolean, m?: string): asserts b {
  if (!b) {
    if (m) {
      throw Error(`BUG: logic invariant failed (${m})`);
    } else {
      throw Error("BUG: logic invariant failed");
    }
  }
}