ddd-ts-kit 0.2.0 → 0.3.0

package/README.md

@@ -47,6 +47,7 @@ ddd-ts-kit init [--http express|fastify|nest|none]
                 [--broker none|rabbitmq|kafka|nats|redis|custom] [--cache none|redis] [--audit on|off]
                 [--errors none|sentry] [--logger stdout|pino|winston]
                 [--style declared|explicit] [--assembly barrel|discovery]
+                [--dependencies signature|listed] [--refusals factories|classes]
                 [--package-manager npm|pnpm]
                 [--allow-no-outbox "<reason>"] [--import-alias '$<name>/']
                 [--import-extension none|js]
@@ -137,6 +138,13 @@ is absent with standard decorators and under `tsx`. `init` writes
 what each class is given. Every generated file exports one class, interface or function and is named
 after it.
 
+**Domain errors are built by factories.** `init` writes `"stack.refusals": "factories"`: a
+context has one error class per concept, extending `ConceptError` of the kernel, and
+`generate error <context> <Concept> <refusal>` adds a static factory to it. The `errors/*`
+rules hold that form. `--refusals classes`, or a config without the key, keeps one class per
+error built with `new`, as 0.1 and 0.2 wrote them; `error-factories` moves a project from one
+to the other.
+
 **Domain events leave with the save.** A generated command handler builds or loads its aggregate,
 calls one intention method, `await repository.save(aggregate)` and returns: no `pullEvents()`, and
 no `DomainEventDispatcher` in a handler or in a repository adapter, which only persists. The events
@@ -231,7 +239,8 @@ ddd-ts-kit generate --help --json
 | `entity` | `<context> <Name>` | entity, spec |
 | `value-object` (`vo`) | `<context> <Name>` | value object, spec |
 | `domain-event` | `<context> <Aggregate> <Fact>` | event named `<context>.<aggregate>.<fact>`, spec |
-| `domain-error` | `<context> <Name> [--code CODE]` | error with a stable code, spec |
+| `error` (`refusal`) | `<context> <Concept> <refusal> [--code CODE] [--term ...]...` | a static factory `<refusal>` on `domain/errors/<concept>.error.ts`, the class of the errors of that concept (created when absent, extending `ConceptError`), and its case in `test/unit/<concept>.error.spec.ts`. The factory is added after the last one; run again, the command changes nothing. `<Concept>` is a term of the glossary (`--term` adds it). The code is the name of the refusal in constant case, with the concept before it when the name is one word or a code of the kit (`Appointment notFound` sets `APPOINTMENT_NOT_FOUND`); `--code` takes one of the forms `errors/factory-name` accepts. Refused: a name such as `create` or `error1`, and a code already set in the context |
+| `domain-error` | `<context> <Name> [--code CODE]` | one class per error with a stable code, spec: the form of a project whose config says `"stack.refusals": "classes"` or nothing. Refused under `factories`, with the `generate error` command to run instead |
 | `domain-service` | `<context> <Name>` | service, spec |
 | `repository` | `<context> <Aggregate> [--tenant-scoped]` | the port `domain/repositories/<name>.repository.ts` (`abstract class <Name>Repository extends Repository<<Name>>`), the adapter of the project's ORM (`implements` the port) with its mapper and table (or model), a fake, one `repositoryContract` spec run on both, registration |
 | `command` | `<context> <UseCaseName> (--permission <aggregate>.<action> \| --public) [--aggregate <Name>]` | `<use-case>.command.ts` on `AuthorizedCommand` (plain `Command` when public), `<use-case>.handler.ts` (it builds the aggregate, saves it and answers: the events leave with the save), spec through the bus with the refusal of an actor who lacks the permission, registration with `.requires(...)` or `.public()` (and the repository when missing). A generated command answers `void` or the identifier of its aggregate, so no `<use-case>.result.ts` is written |
@@ -413,6 +422,48 @@ published languages, declared upstreams, allowed packages, cycles and orphans. `
 it as `.dependency-cruiser.cjs`; `--check` exits 1 when the file is missing or stale, which is
 what `npm run depcruise` runs first. Edit the config, not the file.
 
+## error-factories
+
+```
+ddd-ts-kit error-factories --plan
+ddd-ts-kit error-factories --apply [--dry-run]
+```
+
+Moves a project from one class per error (`new SlotTakenError(..)`) to static factories on one
+error class per concept (`AppointmentError.slotTaken(..)`), in two steps, because which concept
+a refusal is about is a decision of the model.
+
+`--plan` writes `error-factories.plan.json`: per context, one entry per class of
+`domain/errors/` that extends `DomainError`, with its code, the concept proposed for it (the
+aggregate its name starts or ends with, empty when none does) and the factory name that says
+its code (`APPOINTMENT_NOT_FOUND` on `Appointment` gives `notFound`). Edit it: every entry
+needs a `concept`, a term of the glossary.
+
+`--apply` follows the plan and refuses an entry without a concept, a vague factory name or one
+that does not say the code. It:
+
+- writes `domain/errors/<concept>.error.ts`, a class extending `ConceptError` with one factory
+  per class moved there: the parameters of the constructor, the message it gave to `super`, and
+  as facts the parameters that are plain data (text, numbers, booleans, dates);
+- removes each class and its spec, whose cases go under `describe('<factory>')` in
+  `test/unit/<concept>.error.spec.ts`;
+- rewrites every file under the source root and `test/`: `new X(..)` becomes
+  `<Concept>Error.<factory>(..)`, `thenError(X)` and `thenError(X, code)` become
+  `thenError('<CODE>')`, `toThrow(X)` and `expect.any(X)` become an assertion on the code,
+  `toBeInstanceOf(X)` becomes `toMatchObject({ code })`, `e instanceof X` becomes
+  `<Concept>Error.is(e, '<CODE>')`, an import of the class becomes the import of its concept
+  class, and a type names the concept class. A class of the same name in two contexts goes to
+  the concept of its own. Comments and strings are left alone;
+- sets `"stack.refusals": "factories"` in the config.
+
+It leaves, and says: a class that has members of its own, reads `this` in its constructor or
+gives options to `super` (written by hand); a place where a class stood as a value it cannot
+translate; a property of the error that became a fact (`error.personId` is now
+`error.facts.personId`); a factory with more than three parameters. And always: which facts a
+client may read (none is exposed), the factories that still take a sentence as only parameter,
+and the facts to assert in the specs. Run the formatter afterwards. Run again, it finds nothing
+left to move. `--json` answers `{ dryRun, moved, written, removed, manual }`.
+
 ## build-aliases
 
 ```
@@ -591,7 +642,7 @@ saying what to do instead. Exit code 1 when there is at least one error.
 | `test/builder-required` | an aggregate without `test/builders/<name>.builder.ts` |
 | `events/name-format` | an event name that is not `<context>.<aggregate>.<fact>` in kebab-case with the right context |
 | `events/defined-in-published-language` | `defineIntegrationEvent` outside a published language, without a payload, twice for one version; an event described by hand |
-| `language/glossary-term` | a class of the model named with a word the glossary of its context does not define; an empty glossary |
+| `language/glossary-term` | a class of the model named with a word the glossary of its context does not define; an empty glossary; under `"stack.refusals": "factories"`, an error class of `domain/errors/` too |
 | `language/no-technical-name` | `Manager`, `Helper`, `Util`, `Utils`, `Data`, `Info`, `Processor`, `Wrapper`, `Impl`, `Base`, `Abstract`, `Dto`, `Entity`, `Model` in a type declared under `domain/` or in a use case folder |
 | `purity/no-system-clock` | `new Date()` without argument, `Date.now()`, `performance.now()` in `domain/` or `application/` |
 | `purity/no-ambient-randomness` | `Math.random`, the random source of `crypto`, an id library |
@@ -635,6 +686,8 @@ saying what to do instead. Exit code 1 when there is at least one error.
 | `ports/value-import` | a class named in a dependency list, or given to `bind` or `rebind`, imported with `import type` or `import { type X }` |
 | `scheduling/job-triggers-use-case` | in `application/scheduling/*.job.ts`: an exported class that does not implement `ScheduledJob`; a `run` that sends no command (no `.execute(` call); a repository in the dependency list or the constructor; an import from `domain/aggregates/`, `domain/entities/`, `domain/services/` or `infrastructure/`. A `builder.job(..)` registration of a class that lives elsewhere |
 | `scheduling/job-name` | the first argument of `@Scheduled(..)` or `.job(..)` that is not a string literal `<context>.<job-name>` in lower-case kebab-case with the context of its file; a `systemActor(..)` of a job file passing another name; one job name used twice in the project |
+| `errors/code-unique` | under `"stack.refusals": "factories"`, in the `domain/errors/` of a context: a code set a second time, by a factory (`refusal('CODE', ..)`) or by a class (`readonly code = 'CODE'`), with the file and line of the first. The same code in two contexts is not reported |
+| `errors/known-code` | under `"stack.refusals": "factories"`, in a `*.route.ts`: a code of the `errors` list that no refusal of the context of the route sets, that no class outside the contexts sets, and that is not a code of the kit |
 
 Five more ids belong to `@ddd-ts-kit/eslint-plugin`, which reads the syntax tree where this
 checker reads text: `domain/aggregate-encapsulation`, `domain/value-object-immutability`,

package/dist/check/catalogue/architecture-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"architecture-rules.d.ts","sourceRoot":"","sources":["../../../src/check/catalogue/architecture-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AA+D7C,gHAAgH;AAChH,eAAO,MAAM,kBAAkB,EAAE,SAAS,IAAI,EA8D7C,CAAC"}
+{"version":3,"file":"architecture-rules.d.ts","sourceRoot":"","sources":["../../../src/check/catalogue/architecture-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAiE7C,gHAAgH;AAChH,eAAO,MAAM,kBAAkB,EAAE,SAAS,IAAI,EAgE7C,CAAC"}

package/dist/check/catalogue/architecture-rules.js

@@ -24,6 +24,8 @@ import { declarationsConstructorInjection } from '../rules/declarations-construc
 import { declarationsRoleDeclared } from '../rules/declarations-role-declared.js';
 import { domainEventsDispatchedOnSave } from '../rules/domain-events-dispatched-on-save.js';
 import { domainEventsTransactionalBeforeCommit } from '../rules/domain-events-transactional-before-commit.js';
+import { errorsCodeUnique } from '../rules/errors-code-unique.js';
+import { errorsKnownCode } from '../rules/errors-known-code.js';
 import { eventsConsumerIdempotent } from '../rules/events-consumer-idempotent.js';
 import { eventsDefinedInPublishedLanguage } from '../rules/events-defined-in-published-language.js';
 import { eventsNameFormat } from '../rules/events-name-format.js';
@@ -122,5 +124,7 @@ export const ARCHITECTURE_RULES = [
     importsAliasOnly,
     importsExtension,
     importsAliasDeclared,
+    errorsCodeUnique,
+    errorsKnownCode,
 ];
 //# sourceMappingURL=architecture-rules.js.map

package/dist/check/catalogue/architecture-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"architecture-rules.js","sourceRoot":"","sources":["../../../src/check/catalogue/architecture-rules.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"architecture-rules.js","sourceRoot":"","sources":["../../../src/check/catalogue/architecture-rules.ts"],"names":[],"mappings":"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"}

package/dist/check/catalogue/eslint-only-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eslint-only-rules.d.ts","sourceRoot":"","sources":["../../../src/check/catalogue/eslint-only-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAmB7F,CAAC"}
+{"version":3,"file":"eslint-only-rules.d.ts","sourceRoot":"","sources":["../../../src/check/catalogue/eslint-only-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAkC7F,CAAC"}

package/dist/check/catalogue/eslint-only-rules.js

@@ -15,6 +15,18 @@ export const ESLINT_ONLY_RULES = [
         id: 'domain/no-generic-error',
         description: 'domain/ and application/ never `throw new Error(...)`: a business failure is a DomainError subclass.',
     },
+    {
+        id: 'errors/through-factory',
+        description: 'Under "stack.refusals": "factories", a domain error is built by a static factory of its concept class: no `new` of a class of domain/errors/ outside that class.',
+    },
+    {
+        id: 'errors/constructor-not-public',
+        description: 'Under "stack.refusals": "factories", the constructor of an error class of domain/errors/ is not public: the class extends ConceptError and declares none, or declares it private or protected.',
+    },
+    {
+        id: 'errors/factory-name',
+        description: 'Under "stack.refusals": "factories", a static factory of an error class is named after the refusal, never `create`, `make`, `of` or `error1`, and its code is that name in constant case, alone or with the name of the concept.',
+    },
     {
         id: 'application/handler-shape',
         description: 'A *.handler.ts file exports one class with a single public method, execute.',

package/dist/check/catalogue/eslint-only-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"eslint-only-rules.js","sourceRoot":"","sources":["../../../src/check/catalogue/eslint-only-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqE;IACjG;QACE,EAAE,EAAE,gCAAgC;QACpC,WAAW,EACT,0GAA0G;KAC7G;IACD;QACE,EAAE,EAAE,kCAAkC;QACtC,WAAW,EAAE,kGAAkG;KAChH;IACD;QACE,EAAE,EAAE,yBAAyB;QAC7B,WAAW,EAAE,sGAAsG;KACpH;IACD;QACE,EAAE,EAAE,2BAA2B;QAC/B,WAAW,EAAE,6EAA6E;KAC3F;IACD,EAAE,EAAE,EAAE,sCAAsC,EAAE,WAAW,EAAE,oDAAoD,EAAE;CAClH,CAAC"}
+{"version":3,"file":"eslint-only-rules.js","sourceRoot":"","sources":["../../../src/check/catalogue/eslint-only-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqE;IACjG;QACE,EAAE,EAAE,gCAAgC;QACpC,WAAW,EACT,0GAA0G;KAC7G;IACD;QACE,EAAE,EAAE,kCAAkC;QACtC,WAAW,EAAE,kGAAkG;KAChH;IACD;QACE,EAAE,EAAE,yBAAyB;QAC7B,WAAW,EAAE,sGAAsG;KACpH;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,WAAW,EACT,kKAAkK;KACrK;IACD;QACE,EAAE,EAAE,+BAA+B;QACnC,WAAW,EACT,gMAAgM;KACnM;IACD;QACE,EAAE,EAAE,qBAAqB;QACzB,WAAW,EACT,kOAAkO;KACrO;IACD;QACE,EAAE,EAAE,2BAA2B;QAC/B,WAAW,EAAE,6EAA6E;KAC3F;IACD,EAAE,EAAE,EAAE,sCAAsC,EAAE,WAAW,EAAE,oDAAoD,EAAE;CAClH,CAAC"}

package/dist/check/errors/builds-through-factories.d.ts

@@ -0,0 +1,4 @@
+import type { Project } from '../model/project.js';
+/** The `errors/*` rules judge a project that says it builds its refusals through factories; one that does not say keeps the form of 0.2. */
+export declare function buildsThroughFactories(project: Project): boolean;
+//# sourceMappingURL=builds-through-factories.d.ts.map

package/dist/check/errors/builds-through-factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builds-through-factories.d.ts","sourceRoot":"","sources":["../../../src/check/errors/builds-through-factories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,4IAA4I;AAC5I,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEhE"}

package/dist/check/errors/builds-through-factories.js

@@ -0,0 +1,5 @@
+/** The `errors/*` rules judge a project that says it builds its refusals through factories; one that does not say keeps the form of 0.2. */
+export function buildsThroughFactories(project) {
+    return project.config.stack.refusals === 'factories';
+}
+//# sourceMappingURL=builds-through-factories.js.map

package/dist/check/errors/builds-through-factories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builds-through-factories.js","sourceRoot":"","sources":["../../../src/check/errors/builds-through-factories.ts"],"names":[],"mappings":"AAEA,4IAA4I;AAC5I,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,WAAW,CAAC;AACvD,CAAC"}

package/dist/check/errors/error-code.d.ts

@@ -0,0 +1,6 @@
+/** A code a source gives to a refusal, and where. */
+export interface ErrorCode {
+    readonly code: string;
+    readonly line: number;
+}
+//# sourceMappingURL=error-code.d.ts.map

package/dist/check/errors/error-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-code.d.ts","sourceRoot":"","sources":["../../../src/check/errors/error-code.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/dist/check/errors/error-code.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-code.js.map

package/dist/check/errors/error-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-code.js","sourceRoot":"","sources":["../../../src/check/errors/error-code.ts"],"names":[],"mappings":""}

package/dist/check/errors/error-codes.d.ts

@@ -0,0 +1,8 @@
+import type { Scan } from '../scan/scan.js';
+import type { ErrorCode } from './error-code.js';
+/**
+ * The codes a source gives to its refusals, in both forms: the first argument of
+ * `.refusal('CODE', ..)` in a factory, and the `readonly code = 'CODE'` field of a class per error.
+ */
+export declare function errorCodes(scan: Scan): ErrorCode[];
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/check/errors/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../../src/check/errors/error-codes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,CAelD"}

package/dist/check/errors/error-codes.js

@@ -0,0 +1,21 @@
+import { wholeLiteral } from '../declarations/whole-literal.js';
+import { callArguments } from '../text/call-arguments.js';
+const REFUSAL_CALL = /\.\s*refusal\s*\(/g;
+const CODE_FIELD = /\breadonly\s+code\s*(?::[^=;]+)?=\s*/g;
+/**
+ * The codes a source gives to its refusals, in both forms: the first argument of
+ * `.refusal('CODE', ..)` in a factory, and the `readonly code = 'CODE'` field of a class per error.
+ */
+export function errorCodes(scan) {
+    const built = [...scan.code.matchAll(REFUSAL_CALL)].flatMap((match) => {
+        const [code] = callArguments(scan.code, match.index + match[0].length - 1);
+        const literal = code === undefined ? undefined : wholeLiteral(scan, code);
+        return literal === undefined ? [] : [{ code: literal, line: scan.lineAt(match.index) }];
+    });
+    const fields = [...scan.code.matchAll(CODE_FIELD)].flatMap((match) => {
+        const literal = scan.strings.find((candidate) => candidate.start === match.index + match[0].length);
+        return literal === undefined ? [] : [{ code: literal.value, line: scan.lineAt(match.index) }];
+    });
+    return [...built, ...fields].sort((a, b) => a.line - b.line);
+}
+//# sourceMappingURL=error-codes.js.map

package/dist/check/errors/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","sourceRoot":"","sources":["../../../src/check/errors/error-codes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG1D,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAC1C,MAAM,UAAU,GAAG,uCAAuC,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACpE,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC3E,MAAM,OAAO,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE1E,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAEpG,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/dist/check/errors/kit-error-codes.d.ts

@@ -0,0 +1,3 @@
+/** The codes of the refusals the packages of the kit raise, which a route may declare without a class of the project. */
+export declare const KIT_ERROR_CODES: readonly string[];
+//# sourceMappingURL=kit-error-codes.d.ts.map

package/dist/check/errors/kit-error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit-error-codes.d.ts","sourceRoot":"","sources":["../../../src/check/errors/kit-error-codes.ts"],"names":[],"mappings":"AAAA,yHAAyH;AACzH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAc5C,CAAC"}

package/dist/check/errors/kit-error-codes.js

@@ -0,0 +1,17 @@
+/** The codes of the refusals the packages of the kit raise, which a route may declare without a class of the project. */
+export const KIT_ERROR_CODES = [
+    'VALIDATION_FAILED',
+    'NOT_FOUND',
+    'CONFLICT',
+    'INVARIANT_VIOLATION',
+    'UNAUTHORIZED',
+    'FORBIDDEN',
+    'CONCURRENCY_CONFLICT',
+    'INVALID_CRITERIA',
+    'INVALID_PAGE_REQUEST',
+    'TIMEOUT',
+    'CIRCUIT_OPEN',
+    'BULKHEAD_FULL',
+    'ATTEMPTS_EXHAUSTED',
+];
+//# sourceMappingURL=kit-error-codes.js.map

package/dist/check/errors/kit-error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit-error-codes.js","sourceRoot":"","sources":["../../../src/check/errors/kit-error-codes.ts"],"names":[],"mappings":"AAAA,yHAAyH;AACzH,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,mBAAmB;IACnB,WAAW;IACX,UAAU;IACV,qBAAqB;IACrB,cAAc;IACd,WAAW;IACX,sBAAsB;IACtB,kBAAkB;IAClB,sBAAsB;IACtB,SAAS;IACT,cAAc;IACd,eAAe;IACf,oBAAoB;CACrB,CAAC"}

package/dist/check/explain/errors-docs.d.ts

@@ -0,0 +1,3 @@
+import type { RuleDoc } from '../model/rule-doc.js';
+export declare const ERRORS_DOCS: Readonly<Record<string, RuleDoc>>;
+//# sourceMappingURL=errors-docs.d.ts.map

package/dist/check/explain/errors-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-docs.d.ts","sourceRoot":"","sources":["../../../src/check/explain/errors-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BzD,CAAC"}

package/dist/check/explain/errors-docs.js

@@ -0,0 +1,30 @@
+export const ERRORS_DOCS = {
+    'errors/code-unique': {
+        why: 'The code is the identity of a refusal for everything outside the domain: the HTTP mapper gives it a status, the OpenAPI document lists it, the audit trail and the span record it as the reason, a client branches on it and a test asserts it. Nothing downstream knows the class or the factory. Two refusals of one context under one code are therefore one refusal for every reader, whatever their messages say. The code is checked per context, since each context owns its language: the same code in two contexts is allowed, and the error mapper of the application gives it one status. Both forms are read, the first argument of `refusal(..)` in a factory and the `readonly code` field of a class per error. Judged under "stack.refusals": "factories" only: a project whose config does not say was written when an error was a class, and keeps working untouched.',
+        bad: `export class AppointmentError extends ConceptError {
+  static slotTaken(calendarId: string) {
+    return AppointmentError.refusal('BOOKING_REFUSED', 'The slot is already held.', { calendarId });
+  }
+
+  static outsideAvailability(startsAt: Date) {
+    return AppointmentError.refusal('BOOKING_REFUSED', 'The calendar takes no appointment then.', { startsAt });
+  }
+}`,
+        good: `export class AppointmentError extends ConceptError {
+  static slotTaken(calendarId: string) {
+    return AppointmentError.refusal('SLOT_TAKEN', 'The slot is already held.', { calendarId });
+  }
+
+  static outsideAvailability(startsAt: Date) {
+    return AppointmentError.refusal('OUTSIDE_AVAILABILITY', 'The calendar takes no appointment then.', { startsAt });
+  }
+}`,
+    },
+    'errors/known-code': {
+        why: 'The `errors` list of a route is what the OpenAPI document promises: one problem response per status of the codes it names. A code written there that no refusal sets, misspelled or left behind by a renamed factory, is a response the contract documents and the API never gives, while the refusal really raised is missing from it. A code exists when a factory or an error class of the context of the route sets it, when a class outside the contexts (the platform, the shared kernel) does, or when it is a code of the kit: VALIDATION_FAILED, NOT_FOUND, CONFLICT, INVARIANT_VIOLATION, UNAUTHORIZED, FORBIDDEN, CONCURRENCY_CONFLICT, INVALID_CRITERIA, INVALID_PAGE_REQUEST, TIMEOUT, CIRCUIT_OPEN, BULKHEAD_FULL, ATTEMPTS_EXHAUSTED. A code another context sets does not count: a context answers with its own language. Judged under "stack.refusals": "factories" only.',
+        bad: `// domain/errors/appointment.error.ts sets 'SLOT_TAKEN'
+defineRoute({ method: 'POST', path: '/appointments', errors: ['FORBIDDEN', 'SLOT_ALREADY_TAKEN'], security: ['bearer'] }, book);`,
+        good: `defineRoute({ method: 'POST', path: '/appointments', errors: ['FORBIDDEN', 'SLOT_TAKEN'], security: ['bearer'] }, book);`,
+    },
+};
+//# sourceMappingURL=errors-docs.js.map

package/dist/check/explain/errors-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-docs.js","sourceRoot":"","sources":["../../../src/check/explain/errors-docs.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAsC;IAC5D,oBAAoB,EAAE;QACpB,GAAG,EAAE,y1BAAy1B;QAC91B,GAAG,EAAE;;;;;;;;EAQP;QACE,IAAI,EAAE;;;;;;;;EAQR;KACC;IACD,mBAAmB,EAAE;QACnB,GAAG,EAAE,41BAA41B;QACj2B,GAAG,EAAE;iIACwH;QAC7H,IAAI,EAAE,0HAA0H;KACjI;CACF,CAAC"}

package/dist/check/explain/rule-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule-docs.d.ts","sourceRoot":"","sources":["../../../src/check/explain/rule-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAepD,oGAAoG;AACpG,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAcvD,CAAC"}
+{"version":3,"file":"rule-docs.d.ts","sourceRoot":"","sources":["../../../src/check/explain/rule-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAgBpD,oGAAoG;AACpG,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAevD,CAAC"}

package/dist/check/explain/rule-docs.js

@@ -1,6 +1,7 @@
 import { AUTHZ_DOCS } from './authz-docs.js';
 import { CLEAN_DOCS } from './clean-docs.js';
 import { CONTEXT_DOCS } from './context-docs.js';
+import { ERRORS_DOCS } from './errors-docs.js';
 import { EVENTS_DOCS } from './events-docs.js';
 import { IMPORTS_DOCS } from './imports-docs.js';
 import { LANGUAGE_DOCS } from './language-docs.js';
@@ -16,6 +17,7 @@ export const RULE_DOCS = {
     ...AUTHZ_DOCS,
     ...CLEAN_DOCS,
     ...CONTEXT_DOCS,
+    ...ERRORS_DOCS,
     ...EVENTS_DOCS,
     ...IMPORTS_DOCS,
     ...LANGUAGE_DOCS,

package/dist/check/explain/rule-docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"rule-docs.js","sourceRoot":"","sources":["../../../src/check/explain/rule-docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,oGAAoG;AACpG,MAAM,CAAC,MAAM,SAAS,GAAsC;IAC1D,GAAG,UAAU;IACb,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,WAAW;IACd,GAAG,YAAY;IACf,GAAG,aAAa;IAChB,GAAG,UAAU;IACb,GAAG,WAAW;IACd,GAAG,UAAU;IACb,GAAG,eAAe;IAClB,GAAG,aAAa;IAChB,GAAG,SAAS;IACZ,GAAG,WAAW;CACf,CAAC"}
+{"version":3,"file":"rule-docs.js","sourceRoot":"","sources":["../../../src/check/explain/rule-docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,oGAAoG;AACpG,MAAM,CAAC,MAAM,SAAS,GAAsC;IAC1D,GAAG,UAAU;IACb,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,WAAW;IACd,GAAG,WAAW;IACd,GAAG,YAAY;IACf,GAAG,aAAa;IAChB,GAAG,UAAU;IACb,GAAG,WAAW;IACd,GAAG,UAAU;IACb,GAAG,eAAe;IAClB,GAAG,aAAa;IAChB,GAAG,SAAS;IACZ,GAAG,WAAW;CACf,CAAC"}

package/dist/check/fixtures/errors-fixtures.d.ts

@@ -0,0 +1,3 @@
+import type { Fixture } from './fixture.js';
+export declare const ERRORS_FIXTURES: readonly Fixture[];
+//# sourceMappingURL=errors-fixtures.d.ts.map

package/dist/check/fixtures/errors-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-fixtures.d.ts","sourceRoot":"","sources":["../../../src/check/fixtures/errors-fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAuM5C,eAAO,MAAM,eAAe,EAAE,SAAS,OAAO,EAAuD,CAAC"}

package/dist/check/fixtures/errors-fixtures.js

@@ -0,0 +1,126 @@
+import { CONFIG_FILE } from '../../config/index.js';
+import { config } from './config.js';
+import { PATHS } from './paths.js';
+import { project } from './project.js';
+import { source } from './source.js';
+const { BILLING, ROUTE } = PATHS;
+const INVOICE_ERROR = `${BILLING}/domain/errors/invoice.error.ts`;
+const REMINDER_ERROR = `${BILLING}/domain/errors/reminder.error.ts`;
+const LEGACY_ERROR = `${BILLING}/domain/errors/issue.error.ts`;
+const LEDGER_ERROR = `${BILLING}/domain/errors/ledger.error.ts`;
+const FACTORIES = { [CONFIG_FILE]: config({ stack: { refusals: 'factories' } }) };
+const concept = (name, ...factories) => source("import { ConceptError } from '@ddd-ts-kit/kernel';", '', `export class ${name}Error extends ConceptError {`, factories.join('\n\n'), '}');
+const factory = (owner, name, code) => source(`  static ${name}(id: string) {`, `    return ${owner}Error.refusal('${code}', \`Refused for \${id}.\`, { id });`, '  }').trimEnd();
+const LEGACY = source("import { DomainError } from '@ddd-ts-kit/kernel';", '', 'export class IssueError extends DomainError {', "  readonly code = 'INVOICE_ALREADY_ISSUED';", '}');
+const route = (...codes) => source("import { defineRoute } from '@ddd-ts-kit/http';", '', 'export const issueInvoiceRoute = defineRoute(', `  { method: 'POST', path: '/invoices', errors: [${codes.map((code) => `'${code}'`).join(', ')}], security: false },`, '  issue,', ');');
+const INVOICE = concept('Invoice', factory('Invoice', 'alreadyIssued', 'INVOICE_ALREADY_ISSUED'), factory('Invoice', 'notFound', 'INVOICE_NOT_FOUND'));
+const CODE_UNIQUE = [
+    {
+        ruleId: 'errors/code-unique',
+        name: 'each refusal of a context has its own code, over two concept classes',
+        expect: 'pass',
+        files: project({
+            [INVOICE_ERROR]: INVOICE,
+            [REMINDER_ERROR]: concept('Reminder', factory('Reminder', 'notDue', 'REMINDER_NOT_DUE')),
+        }, FACTORIES),
+    },
+    {
+        ruleId: 'errors/code-unique',
+        name: 'the same code in two contexts: each context owns its language',
+        expect: 'pass',
+        files: project({
+            [INVOICE_ERROR]: INVOICE,
+            [`${PATHS.CATALOG}/domain/errors/invoice.error.ts`]: concept('Invoice', factory('Invoice', 'notFound', 'INVOICE_NOT_FOUND')),
+        }, FACTORIES),
+    },
+    {
+        ruleId: 'errors/code-unique',
+        name: 'a project that does not say how it builds its refusals is not judged',
+        expect: 'pass',
+        files: project({
+            [INVOICE_ERROR]: concept('Invoice', factory('Invoice', 'alreadyIssued', 'INVOICE_ALREADY_ISSUED')),
+            [LEGACY_ERROR]: LEGACY,
+        }),
+    },
+    {
+        ruleId: 'errors/code-unique',
+        name: 'two factories of one class set the same code',
+        expect: { file: INVOICE_ERROR },
+        files: project({
+            [INVOICE_ERROR]: concept('Invoice', factory('Invoice', 'alreadyIssued', 'INVOICE_ALREADY_ISSUED'), factory('Invoice', 'issuedTwice', 'INVOICE_ALREADY_ISSUED')),
+        }, FACTORIES),
+    },
+    {
+        ruleId: 'errors/code-unique',
+        name: 'a factory sets the code of a class per error of the same context',
+        expect: { file: LEGACY_ERROR },
+        files: project({
+            [INVOICE_ERROR]: concept('Invoice', factory('Invoice', 'alreadyIssued', 'INVOICE_ALREADY_ISSUED')),
+            [LEGACY_ERROR]: LEGACY,
+        }, FACTORIES),
+    },
+];
+const KNOWN_CODE = [
+    {
+        ruleId: 'errors/known-code',
+        name: 'a route declaring codes its context sets, and codes of the kit',
+        expect: 'pass',
+        files: project({
+            [INVOICE_ERROR]: INVOICE,
+            [ROUTE]: route('UNAUTHORIZED', 'FORBIDDEN', 'INVOICE_ALREADY_ISSUED', 'INVOICE_NOT_FOUND'),
+        }, FACTORIES),
+    },
+    {
+        ruleId: 'errors/known-code',
+        name: 'a code set by a class per error, and one set outside the contexts',
+        expect: 'pass',
+        files: project({
+            [LEGACY_ERROR]: LEGACY,
+            'src/platform/quota/quota-exceeded-error.ts': LEGACY.replaceAll('IssueError', 'QuotaExceededError').replace('INVOICE_ALREADY_ISSUED', 'QUOTA_EXCEEDED'),
+            [ROUTE]: route('INVOICE_ALREADY_ISSUED', 'QUOTA_EXCEEDED'),
+        }, FACTORIES),
+    },
+    {
+        ruleId: 'errors/known-code',
+        name: 'a project that does not say how it builds its refusals is not judged',
+        expect: 'pass',
+        files: project({ [ROUTE]: route('INVOICE_VOIDED') }),
+    },
+    {
+        ruleId: 'errors/known-code',
+        name: 'a route declaring a code nothing sets',
+        expect: { file: ROUTE },
+        files: project({ [INVOICE_ERROR]: INVOICE, [ROUTE]: route('FORBIDDEN', 'INVOICE_VOIDED') }, FACTORIES),
+    },
+    {
+        ruleId: 'errors/known-code',
+        name: 'a route declaring a code only another context sets',
+        expect: { file: ROUTE },
+        files: project({
+            [`${PATHS.CATALOG}/domain/errors/reminder.error.ts`]: concept('Reminder', factory('Reminder', 'notDue', 'REMINDER_NOT_DUE')),
+            [ROUTE]: route('REMINDER_NOT_DUE'),
+        }, FACTORIES),
+    },
+];
+const ERROR_LANGUAGE = [
+    {
+        ruleId: 'language/glossary-term',
+        name: 'an error class named after a term of the glossary',
+        expect: 'pass',
+        files: project({ [INVOICE_ERROR]: INVOICE }, FACTORIES),
+    },
+    {
+        ruleId: 'language/glossary-term',
+        name: 'an error class named after a word the glossary does not define',
+        expect: { file: LEDGER_ERROR },
+        files: project({ [LEDGER_ERROR]: concept('Ledger', factory('Ledger', 'closed', 'LEDGER_CLOSED')) }, FACTORIES),
+    },
+    {
+        ruleId: 'language/glossary-term',
+        name: 'a class per error keeps its free name while the project does not build through factories',
+        expect: 'pass',
+        files: project({ [LEDGER_ERROR]: concept('Ledger', factory('Ledger', 'closed', 'LEDGER_CLOSED')) }),
+    },
+];
+export const ERRORS_FIXTURES = [...CODE_UNIQUE, ...KNOWN_CODE, ...ERROR_LANGUAGE];
+//# sourceMappingURL=errors-fixtures.js.map

package/dist/check/fixtures/errors-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-fixtures.js","sourceRoot":"","sources":["../../../src/check/fixtures/errors-fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;AAEjC,MAAM,aAAa,GAAG,GAAG,OAAO,iCAAiC,CAAC;AAClE,MAAM,cAAc,GAAG,GAAG,OAAO,kCAAkC,CAAC;AACpE,MAAM,YAAY,GAAG,GAAG,OAAO,+BAA+B,CAAC;AAC/D,MAAM,YAAY,GAAG,GAAG,OAAO,gCAAgC,CAAC;AAEhE,MAAM,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC;AAElF,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,GAAG,SAAmB,EAAU,EAAE,CAC/D,MAAM,CACJ,oDAAoD,EACpD,EAAE,EACF,gBAAgB,IAAI,8BAA8B,EAClD,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EACtB,GAAG,CACJ,CAAC;AAEJ,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,IAAY,EAAU,EAAE,CACpE,MAAM,CACJ,YAAY,IAAI,gBAAgB,EAChC,cAAc,KAAK,kBAAkB,IAAI,sCAAsC,EAC/E,KAAK,CACN,CAAC,OAAO,EAAE,CAAC;AAEd,MAAM,MAAM,GAAG,MAAM,CACnB,mDAAmD,EACnD,EAAE,EACF,+CAA+C,EAC/C,6CAA6C,EAC7C,GAAG,CACJ,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,GAAG,KAAe,EAAU,EAAE,CAC3C,MAAM,CACJ,iDAAiD,EACjD,EAAE,EACF,+CAA+C,EAC/C,mDAAmD,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,EACrH,UAAU,EACV,IAAI,CACL,CAAC;AAEJ,MAAM,OAAO,GAAG,OAAO,CACrB,SAAS,EACT,OAAO,CAAC,SAAS,EAAE,eAAe,EAAE,wBAAwB,CAAC,EAC7D,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,mBAAmB,CAAC,CACpD,CAAC;AAEF,MAAM,WAAW,GAAuB;IACtC;QACE,MAAM,EAAE,oBAAoB;QAC5B,IAAI,EAAE,sEAAsE;QAC5E,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,OAAO,CACZ;YACE,CAAC,aAAa,CAAC,EAAE,OAAO;YACxB,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;SACzF,EACD,SAAS,CACV;KACF;IACD;QACE,MAAM,EAAE,oBAAoB;QAC5B,IAAI,EAAE,+DAA+D;QACrE,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,OAAO,CACZ;YACE,CAAC,aAAa,CAAC,EAAE,OAAO;YACxB,CAAC,GAAG,KAAK,CAAC,OAAO,iCAAiC,CAAC,EAAE,OAAO,CAC1D,SAAS,EACT,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,mBAAmB,CAAC,CACpD;SACF,EACD,SAAS,CACV;KACF;IACD;QACE,MAAM,EAAE,oBAAoB;QAC5B,IAAI,EAAE,sEAAsE;QAC5E,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,OAAO,CAAC;YACb,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,eAAe,EAAE,wBAAwB,CAAC,CAAC;YAClG,CAAC,YAAY,CAAC,EAAE,MAAM;SACvB,CAAC;KACH;IACD;QACE,MAAM,EAAE,oBAAoB;QAC5B,IAAI,EAAE,8CAA8C;QACpD,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;QAC/B,KAAK,EAAE,OAAO,CACZ;YACE,CAAC,aAAa,CAAC,EAAE,OAAO,CACtB,SAAS,EACT,OAAO,CAAC,SAAS,EAAE,eAAe,EAAE,wBAAwB,CAAC,EAC7D,OAAO,CAAC,SAAS,EAAE,aAAa,EAAE,wBAAwB,CAAC,CAC5D;SACF,EACD,SAAS,CACV;KACF;IACD;QACE,MAAM,EAAE,oBAAoB;QAC5B,IAAI,EAAE,kEAAkE;QACxE,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;QAC9B,KAAK,EAAE,OAAO,CACZ;YACE,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,eAAe,EAAE,wBAAwB,CAAC,CAAC;YAClG,CAAC,YAAY,CAAC,EAAE,MAAM;SACvB,EACD,SAAS,CACV;KACF;CACF,CAAC;AAEF,MAAM,UAAU,GAAuB;IACrC;QACE,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,gEAAgE;QACtE,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,OAAO,CACZ;YACE,CAAC,aAAa,CAAC,EAAE,OAAO;YACxB,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,cAAc,EAAE,WAAW,EAAE,wBAAwB,EAAE,mBAAmB,CAAC;SAC3F,EACD,SAAS,CACV;KACF;IACD;QACE,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,mEAAmE;QACzE,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,OAAO,CACZ;YACE,CAAC,YAAY,CAAC,EAAE,MAAM;YACtB,4CAA4C,EAAE,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC,OAAO,CACzG,wBAAwB,EACxB,gBAAgB,CACjB;YACD,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,wBAAwB,EAAE,gBAAgB,CAAC;SAC3D,EACD,SAAS,CACV;KACF;IACD;QACE,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,sEAAsE;QAC5E,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;KACrD;IACD;QACE,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,uCAAuC;QAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;QACvB,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,WAAW,EAAE,gBAAgB,CAAC,EAAE,EAAE,SAAS,CAAC;KACvG;IACD;QACE,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,oDAAoD;QAC1D,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;QACvB,KAAK,EAAE,OAAO,CACZ;YACE,CAAC,GAAG,KAAK,CAAC,OAAO,kCAAkC,CAAC,EAAE,OAAO,CAC3D,UAAU,EACV,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAClD;YACD,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAC;SACnC,EACD,SAAS,CACV;KACF;CACF,CAAC;AAEF,MAAM,cAAc,GAAuB;IACzC;QACE,MAAM,EAAE,wBAAwB;QAChC,IAAI,EAAE,mDAAmD;QACzD,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC;KACxD;IACD;QACE,MAAM,EAAE,wBAAwB;QAChC,IAAI,EAAE,gEAAgE;QACtE,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;QAC9B,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC;KAC/G;IACD;QACE,MAAM,EAAE,wBAAwB;QAChC,IAAI,EAAE,0FAA0F;QAChG,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;KACpG;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAuB,CAAC,GAAG,WAAW,EAAE,GAAG,UAAU,EAAE,GAAG,cAAc,CAAC,CAAC"}

package/dist/check/fixtures/fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/check/fixtures/fixtures.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EA8BtC,CAAC"}
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/check/fixtures/fixtures.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EA+BtC,CAAC"}

package/dist/check/fixtures/fixtures.js

@@ -10,6 +10,7 @@ import { CONTEXT_FIXTURES } from './context-fixtures.js';
 import { COVERAGE_FIXTURES } from './coverage-fixtures.js';
 import { DECLARATIONS_FIXTURES } from './declarations-fixtures.js';
 import { DOMAIN_EVENTS_FIXTURES } from './domain-events-fixtures.js';
+import { ERRORS_FIXTURES } from './errors-fixtures.js';
 import { EVENTS_FIXTURES } from './events-fixtures.js';
 import { EXTENSION_FIXTURES } from './extension-fixtures.js';
 import { EXTRACTABLE_FIXTURES } from './extractable-fixtures.js';
@@ -45,6 +46,7 @@ export const FIXTURES = [
     ...COVERAGE_FIXTURES,
     ...DECLARATIONS_FIXTURES,
     ...DOMAIN_EVENTS_FIXTURES,
+    ...ERRORS_FIXTURES,
     ...EVENTS_FIXTURES,
     ...EXTENSION_FIXTURES,
     ...EXTRACTABLE_FIXTURES,

package/dist/check/fixtures/fixtures.js.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../../src/check/fixtures/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAuB;IAC1C,GAAG,uBAAuB;IAC1B,GAAG,uBAAuB;IAC1B,GAAG,cAAc;IACjB,GAAG,cAAc;IACjB,GAAG,oBAAoB;IACvB,GAAG,eAAe;IAClB,GAAG,8BAA8B;IACjC,GAAG,iBAAiB;IACpB,GAAG,gBAAgB;IACnB,GAAG,iBAAiB;IACpB,GAAG,qBAAqB;IACxB,GAAG,sBAAsB;IACzB,GAAG,eAAe;IAClB,GAAG,kBAAkB;IACrB,GAAG,oBAAoB;IACvB,GAAG,mBAAmB;IACtB,GAAG,gBAAgB;IACnB,GAAG,iBAAiB;IACpB,GAAG,cAAc;IACjB,GAAG,eAAe;IAClB,GAAG,eAAe;IAClB,GAAG,eAAe;IAClB,GAAG,cAAc;IACjB,GAAG,eAAe;IAClB,GAAG,mBAAmB;IACtB,GAAG,iBAAiB;IACpB,GAAG,aAAa;IAChB,GAAG,gBAAgB;IACnB,GAAG,aAAa;CACjB,CAAC"}
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../../src/check/fixtures/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAuB;IAC1C,GAAG,uBAAuB;IAC1B,GAAG,uBAAuB;IAC1B,GAAG,cAAc;IACjB,GAAG,cAAc;IACjB,GAAG,oBAAoB;IACvB,GAAG,eAAe;IAClB,GAAG,8BAA8B;IACjC,GAAG,iBAAiB;IACpB,GAAG,gBAAgB;IACnB,GAAG,iBAAiB;IACpB,GAAG,qBAAqB;IACxB,GAAG,sBAAsB;IACzB,GAAG,eAAe;IAClB,GAAG,eAAe;IAClB,GAAG,kBAAkB;IACrB,GAAG,oBAAoB;IACvB,GAAG,mBAAmB;IACtB,GAAG,gBAAgB;IACnB,GAAG,iBAAiB;IACpB,GAAG,cAAc;IACjB,GAAG,eAAe;IAClB,GAAG,eAAe;IAClB,GAAG,eAAe;IAClB,GAAG,cAAc;IACjB,GAAG,eAAe;IAClB,GAAG,mBAAmB;IACtB,GAAG,iBAAiB;IACpB,GAAG,aAAa;IAChB,GAAG,gBAAgB;IACnB,GAAG,aAAa;CACjB,CAAC"}

package/dist/check/rules/errors-code-unique.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../model/rule.js';
+export declare const errorsCodeUnique: Rule;
+//# sourceMappingURL=errors-code-unique.d.ts.map

package/dist/check/rules/errors-code-unique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-code-unique.d.ts","sourceRoot":"","sources":["../../../src/check/rules/errors-code-unique.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAO7C,eAAO,MAAM,gBAAgB,EAAE,IAe9B,CAAC"}

package/dist/check/rules/errors-code-unique.js

@@ -0,0 +1,34 @@
+import { buildsThroughFactories } from '../errors/builds-through-factories.js';
+import { errorCodes } from '../errors/error-codes.js';
+import { perFile } from '../support/per-file.js';
+const FIX = 'Give each refusal of a context its own code, or call the factory that already sets this one: the HTTP mapping, the OpenAPI document, the audit trail and the tests know a refusal by its code alone.';
+export const errorsCodeUnique = {
+    id: 'errors/code-unique',
+    description: 'Under "stack.refusals": "factories", a code is given to one refusal of a context: no two factories, and no two error classes, of the domain/errors/ of a context set the same code.',
+    scope: 'project',
+    run(project) {
+        if (!buildsThroughFactories(project)) {
+            return [];
+        }
+        // Remembers, across the error files of a context, where each code was first written.
+        const firstUse = new Map();
+        return perFile(project, this.id, (file) => codesTaken(file, firstUse));
+    },
+};
+function codesTaken(file, firstUse) {
+    const { location } = file;
+    if (location.area !== 'context' || location.layer !== 'domain' || location.inside[0] !== 'errors' || file.isTest) {
+        return [];
+    }
+    return errorCodes(file.scan).flatMap(({ code, line }) => {
+        const key = `${location.context} ${code}`;
+        const first = firstUse.get(key);
+        if (first === undefined) {
+            firstUse.set(key, `${file.path}:${line}`);
+        }
+        return first === undefined
+            ? []
+            : [{ line, message: `The code "${code}" is already set in ${first}, in the same context.`, fix: FIX }];
+    });
+}
+//# sourceMappingURL=errors-code-unique.js.map

package/dist/check/rules/errors-code-unique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-code-unique.js","sourceRoot":"","sources":["../../../src/check/rules/errors-code-unique.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAItD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,MAAM,GAAG,GACP,sMAAsM,CAAC;AAEzM,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,EAAE,EAAE,oBAAoB;IACxB,WAAW,EACT,qLAAqL;IACvL,KAAK,EAAE,SAAS;IAChB,GAAG,CAAC,OAAO;QACT,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,qFAAqF;QACrF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE3C,OAAO,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,CAAC;CACF,CAAC;AAEF,SAAS,UAAU,CAAC,IAAgB,EAAE,QAA6B;IACjE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE1B,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACjH,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QACtD,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEhC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,KAAK,KAAK,SAAS;YACxB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,IAAI,uBAAuB,KAAK,wBAAwB,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3G,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/check/rules/errors-known-code.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from '../model/rule.js';
+export declare const errorsKnownCode: Rule;
+//# sourceMappingURL=errors-known-code.d.ts.map