ddd-ts-kit 0.0.0-stage → 0.1.1

package/dist/check/domain-events/is-registered-after-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-registered-after-commit.js","sourceRoot":"","sources":["../../../src/check/domain-events/is-registered-after-commit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,MAAM,EAAE,GAAG,eAAe,CAAC;AAC3B,MAAM,SAAS,GAAG,0BAA0B,CAAC;AAC7C,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA8B,EAAE,SAAiB;IACvF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAC7B,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAE5G,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CACpG,CAAC;IAEF,OAAO,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,AAAD,EAAG,OAAO,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACnH,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,SAAiB;IACvD,MAAM,IAAI,GAAG,IAAI,MAAM,CACrB,qFAAqF,YAAY,CAAC,SAAS,CAAC,YAAY,EACxH,GAAG,CACJ,CAAC;IAEF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,eAAe,CAAC,IAAU,EAAE,OAA6B;IAChE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IAEhD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAChC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,YAAY,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,GAAG,GAAG,CACrG,CAAC;IAEF,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACjG,CAAC"}

package/dist/check/domain-events/refused-before-commit.d.ts

@@ -0,0 +1,8 @@
+import type { HandlerDependency } from './handler-dependency.js';
+/**
+ * Why a handler of `context` that runs before the commit may not depend on this, in the words
+ * that follow the name of the dependency; undefined when it may. A port of `application/ports/`
+ * of the context is not judged here: where its adapter lives decides.
+ */
+export declare function refusedBeforeCommit(context: string, { name, target }: HandlerDependency): string | undefined;
+//# sourceMappingURL=refused-before-commit.d.ts.map

package/dist/check/domain-events/refused-before-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refused-before-commit.d.ts","sourceRoot":"","sources":["../../../src/check/domain-events/refused-before-commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAOjE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAwB5G"}

package/dist/check/domain-events/refused-before-commit.js

@@ -0,0 +1,37 @@
+const KERNEL = '@ddd-ts-kit/kernel';
+const TRUSTED_PACKAGES = [KERNEL, '@ddd-ts-kit/auth'];
+/** The ports of the kernel whose effect no transaction covers. */
+const OUTSIDE_THE_TRANSACTION = ['Cache', 'Lock', 'RateLimiter', 'JobScheduler', 'EventBus'];
+/**
+ * Why a handler of `context` that runs before the commit may not depend on this, in the words
+ * that follow the name of the dependency; undefined when it may. A port of `application/ports/`
+ * of the context is not judged here: where its adapter lives decides.
+ */
+export function refusedBeforeCommit(context, { name, target }) {
+    if (target.kind === 'builtin') {
+        return `which comes from ${target.name}`;
+    }
+    if (target.kind === 'package') {
+        return fromPackage(name, target.name);
+    }
+    const { location } = target;
+    if (location.area === 'platform') {
+        return 'which comes from the platform';
+    }
+    if (location.area !== 'context') {
+        return undefined;
+    }
+    if (location.context !== context) {
+        return `which belongs to the context ${location.context}`;
+    }
+    return location.layer === 'infrastructure' ? 'which is imported from infrastructure/' : undefined;
+}
+function fromPackage(name, packageName) {
+    if (!TRUSTED_PACKAGES.includes(packageName)) {
+        return `which comes from the package ${packageName}`;
+    }
+    return packageName === KERNEL && OUTSIDE_THE_TRANSACTION.includes(name)
+        ? 'a port of the kernel no transaction covers'
+        : undefined;
+}
+//# sourceMappingURL=refused-before-commit.js.map

package/dist/check/domain-events/refused-before-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refused-before-commit.js","sourceRoot":"","sources":["../../../src/check/domain-events/refused-before-commit.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAG,oBAAoB,CAAC;AACpC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACtD,kEAAkE;AAClE,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;AAE7F;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,EAAE,IAAI,EAAE,MAAM,EAAqB;IACtF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,oBAAoB,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAE5B,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,+BAA+B,CAAC;IACzC,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,QAAQ,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,gCAAgC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,KAAK,gBAAgB,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,SAAS,CAAC;AACpG,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,WAAmB;IACpD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,OAAO,gCAAgC,WAAW,EAAE,CAAC;IACvD,CAAC;IAED,OAAO,WAAW,KAAK,MAAM,IAAI,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrE,CAAC,CAAC,4CAA4C;QAC9C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}

package/dist/check/engine/check-result.d.ts

@@ -0,0 +1,11 @@
+import type { Violation } from '../model/violation.js';
+export interface CheckResult {
+    readonly violations: Violation[];
+    readonly errorCount: number;
+    readonly warningCount: number;
+    /** Violations silenced by a directive that gives a reason. */
+    readonly suppressedCount: number;
+    readonly suppressionCount: number;
+    readonly fileCount: number;
+}
+//# sourceMappingURL=check-result.d.ts.map

package/dist/check/engine/check-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-result.d.ts","sourceRoot":"","sources":["../../../src/check/engine/check-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/dist/check/engine/check-result.js

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

package/dist/check/engine/check-result.js.map

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

package/dist/check/engine/format-check.d.ts

@@ -0,0 +1,4 @@
+import type { CheckResult } from './check-result.js';
+export type CheckFormat = 'text' | 'json' | 'github' | 'gitlab';
+export declare function formatCheck(result: CheckResult, format: CheckFormat): string;
+//# sourceMappingURL=format-check.d.ts.map

package/dist/check/engine/format-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-check.d.ts","sourceRoot":"","sources":["../../../src/check/engine/format-check.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAIhE,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAY5E"}

package/dist/check/engine/format-check.js

@@ -0,0 +1,65 @@
+import { createHash } from 'node:crypto';
+const CODE_QUALITY_SEVERITIES = { error: 'major', warn: 'minor' };
+export function formatCheck(result, format) {
+    if (format === 'gitlab') {
+        return JSON.stringify(result.violations.map(toCodeQualityIssue), null, 2);
+    }
+    if (format === 'json') {
+        return JSON.stringify(jsonOf(result), null, 2);
+    }
+    const lines = result.violations.map(format === 'github' ? githubLine : textLine);
+    return [...lines, summaryLine(result)].join(format === 'github' ? '\n' : '\n\n');
+}
+function jsonOf(result) {
+    return {
+        ok: result.errorCount === 0,
+        errors: result.errorCount,
+        warnings: result.warningCount,
+        suppressions: result.suppressionCount,
+        suppressed: result.suppressedCount,
+        files: result.fileCount,
+        violations: result.violations,
+    };
+}
+function summaryLine(result) {
+    return `${plural(result.errorCount, 'error')}, ${plural(result.warningCount, 'warning')}, ${plural(result.suppressionCount, 'suppression')} in ${plural(result.fileCount, 'file')}.`;
+}
+function plural(count, word) {
+    return `${count} ${word}${count === 1 ? '' : 's'}`;
+}
+function textLine(violation) {
+    const label = violation.severity === 'error' ? 'error' : 'warn ';
+    return `${violation.file}:${violation.line}  ${label}  ${violation.ruleId}\n  ${violation.message}\n  fix: ${violation.fix}`;
+}
+function githubLine(violation) {
+    const level = violation.severity === 'error' ? 'error' : 'warning';
+    const message = `${violation.message} Fix: ${violation.fix}`;
+    return `::${level} file=${escapeProperty(violation.file)},line=${violation.line},title=${escapeProperty(violation.ruleId)}::${escapeData(message)}`;
+}
+/** GitHub cuts an annotation at the first raw newline or unescaped separator. */
+function escapeData(value) {
+    return value.replaceAll('%', '%25').replaceAll('\r', '%0D').replaceAll('\n', '%0A');
+}
+function escapeProperty(value) {
+    return escapeData(value).replaceAll(':', '%3A').replaceAll(',', '%2C');
+}
+/**
+ * One issue of a GitLab Code Quality report. The fingerprint is stable across runs and does not
+ * depend on the line, so a violation that merely moves is not reported as fixed and new.
+ */
+function toCodeQualityIssue(violation, index, all) {
+    const rank = all.slice(0, index).filter((earlier) => identity(earlier) === identity(violation)).length;
+    return {
+        description: `${violation.message} Fix: ${violation.fix}`,
+        check_name: violation.ruleId,
+        fingerprint: createHash('sha256')
+            .update(`${identity(violation)}\n${rank}`)
+            .digest('hex'),
+        severity: CODE_QUALITY_SEVERITIES[violation.severity],
+        location: { path: violation.file, lines: { begin: violation.line } },
+    };
+}
+function identity(violation) {
+    return [violation.ruleId, violation.file, violation.message].join('\n');
+}
+//# sourceMappingURL=format-check.js.map

package/dist/check/engine/format-check.js.map

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

package/dist/check/engine/run-check.d.ts

@@ -0,0 +1,10 @@
+import type { Project } from '../model/project.js';
+import type { CheckResult } from './check-result.js';
+export interface CheckOptions {
+    /** Run only these rule ids. */
+    readonly rules?: readonly string[];
+    /** Skip the rules that need the whole tree. */
+    readonly fileScopeOnly?: boolean;
+}
+export declare function runCheck(project: Project, options?: CheckOptions): CheckResult;
+//# sourceMappingURL=run-check.d.ts.map

package/dist/check/engine/run-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-check.d.ts","sourceRoot":"","sources":["../../../src/check/engine/run-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAOnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,WAAW,CAiBlF"}

package/dist/check/engine/run-check.js

@@ -0,0 +1,26 @@
+import { RULES } from '../catalogue/rules.js';
+import { findSuppressions } from '../suppressions/find-suppressions.js';
+import { isSuppressed } from '../suppressions/is-suppressed.js';
+import { SUPPRESSION_RULE_ID } from '../suppressions/suppression-rule-id.js';
+import { suppressionViolations } from '../suppressions/suppression-violations.js';
+import { summarize } from './summarize.js';
+export function runCheck(project, options = {}) {
+    const selected = (id) => options.rules === undefined || options.rules.length === 0 || options.rules.includes(id);
+    const suppressions = project.files.flatMap(findSuppressions);
+    const active = RULES.filter((rule) => selected(rule.id) && project.severity(rule.id) !== 'off');
+    const raw = active.flatMap((rule) => violationsOf(rule, project, options.fileScopeOnly === true));
+    const kept = raw.filter((violation) => !isSuppressed(violation, suppressions));
+    const suppressedCount = raw.length - kept.length;
+    if (selected(SUPPRESSION_RULE_ID)) {
+        kept.push(...suppressionViolations(project, suppressions));
+    }
+    kept.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.ruleId.localeCompare(b.ruleId));
+    return summarize(kept, { suppressedCount, suppressionCount: suppressions.length, fileCount: project.files.length });
+}
+function violationsOf(rule, project, oneFileOnly) {
+    if (!oneFileOnly) {
+        return [...rule.run(project), ...(rule.acrossProject?.(project) ?? [])];
+    }
+    return rule.scope === 'project' ? [] : rule.run(project);
+}
+//# sourceMappingURL=run-check.js.map

package/dist/check/engine/run-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-check.js","sourceRoot":"","sources":["../../../src/check/engine/run-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAI9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAElF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAS3C,MAAM,UAAU,QAAQ,CAAC,OAAgB,EAAE,OAAO,GAAiB,EAAE;IACnE,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAW,EAAE,CACvC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAE1F,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC;IAChG,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC;IAClG,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IAC/E,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAEjD,IAAI,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAEzG,OAAO,SAAS,CAAC,IAAI,EAAE,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AACtH,CAAC;AAED,SAAS,YAAY,CAAC,IAAU,EAAE,OAAgB,EAAE,WAAoB;IACtE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC3D,CAAC"}

package/dist/check/engine/summarize.d.ts

@@ -0,0 +1,5 @@
+import type { Violation } from '../model/violation.js';
+import type { CheckResult } from './check-result.js';
+/** Counts what is reported; the totals about suppressions and files come from the run it derives from. */
+export declare function summarize(violations: Violation[], run?: Pick<CheckResult, 'suppressedCount' | 'suppressionCount' | 'fileCount'>): CheckResult;
+//# sourceMappingURL=summarize.d.ts.map

package/dist/check/engine/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../src/check/engine/summarize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,0GAA0G;AAC1G,wBAAgB,SAAS,CACvB,UAAU,EAAE,SAAS,EAAE,EACvB,GAAG,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,WAAW,CAAC,GAC5E,WAAW,CASb"}

package/dist/check/engine/summarize.js

@@ -0,0 +1,12 @@
+/** Counts what is reported; the totals about suppressions and files come from the run it derives from. */
+export function summarize(violations, run) {
+    return {
+        violations,
+        errorCount: violations.filter((violation) => violation.severity === 'error').length,
+        warningCount: violations.filter((violation) => violation.severity === 'warn').length,
+        suppressedCount: run?.suppressedCount ?? 0,
+        suppressionCount: run?.suppressionCount ?? 0,
+        fileCount: run?.fileCount ?? 0,
+    };
+}
+//# sourceMappingURL=summarize.js.map

package/dist/check/engine/summarize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../../src/check/engine/summarize.ts"],"names":[],"mappings":"AAGA,0GAA0G;AAC1G,MAAM,UAAU,SAAS,CACvB,UAAuB,EACvB,GAA6E;IAE7E,OAAO;QACL,UAAU;QACV,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;QACnF,YAAY,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;QACpF,eAAe,EAAE,GAAG,EAAE,eAAe,IAAI,CAAC;QAC1C,gBAAgB,EAAE,GAAG,EAAE,gBAAgB,IAAI,CAAC;QAC5C,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,CAAC;KAC/B,CAAC;AACJ,CAAC"}

package/dist/check/events/consumer-registrations.d.ts

@@ -0,0 +1,18 @@
+import type { SourceFile } from '../model/source-file.js';
+export interface ConsumerRegistration {
+    /** Blanked code of the call and of the calls chained on it. */
+    readonly code: string;
+    readonly line: number;
+    /** The consumer name, when it is written as a literal. */
+    readonly name: string | undefined;
+    readonly nameLine: number;
+    /** False for a free `on` or `consume` that is given no processed-event store. */
+    readonly deduplicates: boolean;
+}
+/**
+ * Calls that subscribe a consumer under a name: `builder.on(definition, { consumer })`,
+ * `consume(definition, { consumer, processed, unitOfWork }, handler)`,
+ * `on(definition, handler, { consumer, processed })` and `idempotent(name, store, handler)`.
+ */
+export declare function consumerRegistrations(file: SourceFile): ConsumerRegistration[];
+//# sourceMappingURL=consumer-registrations.d.ts.map

package/dist/check/events/consumer-registrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-registrations.d.ts","sourceRoot":"","sources":["../../../src/check/events/consumer-registrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAS1D,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAQD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB,EAAE,CAkB9E"}

package/dist/check/events/consumer-registrations.js

@@ -0,0 +1,35 @@
+import { chainEnd } from '../text/chain-end.js';
+const CALL = /(?:(\.)\s*|(?<![\w$.]))(on|consume|idempotent)\s*(?:<[^<>()]*>)?\s*\(/g;
+const CONSUMER_KEY = /(?<![\w$.])consumer\s*:\s*$/;
+const CONSUMER_OPTION = /(?<![\w$.])consumer\s*[:,}]/;
+const STORE_OPTION = /(?<![\w$.])processed\s*[:,}]/;
+/**
+ * Calls that subscribe a consumer under a name: `builder.on(definition, { consumer })`,
+ * `consume(definition, { consumer, processed, unitOfWork }, handler)`,
+ * `on(definition, handler, { consumer, processed })` and `idempotent(name, store, handler)`.
+ */
+export function consumerRegistrations(file) {
+    const { code } = file.scan;
+    return [...code.matchAll(CALL)].flatMap((match) => {
+        const open = match.index + match[0].length;
+        const span = { start: match.index, open, end: chainEnd(code, open) };
+        const registered = code.slice(span.start, span.end);
+        const literal = match[2] === 'idempotent' ? firstLiteral(file, span) : optionLiteral(file, span);
+        if (literal === undefined && (match[2] === 'idempotent' || !CONSUMER_OPTION.test(registered))) {
+            return [];
+        }
+        const line = file.scan.lineAt(span.start);
+        const deduplicates = match[1] !== undefined || match[2] === 'idempotent' || STORE_OPTION.test(registered);
+        return [{ code: registered, line, name: literal?.value, nameLine: literal?.line ?? line, deduplicates }];
+    });
+}
+function firstLiteral(file, { open, end }) {
+    return file.scan.strings.find((literal) => literal.start >= open && literal.start < end && file.scan.code.slice(open, literal.start).trim() === '');
+}
+function optionLiteral(file, { open, end }) {
+    const { code, strings } = file.scan;
+    return strings.find((literal) => literal.start > open &&
+        literal.start < end &&
+        CONSUMER_KEY.test(code.slice(Math.max(open, literal.start - 40), literal.start)));
+}
+//# sourceMappingURL=consumer-registrations.js.map

package/dist/check/events/consumer-registrations.js.map

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

package/dist/check/events/domain-event-names.d.ts

@@ -0,0 +1,5 @@
+import type { SourceFile } from '../model/source-file.js';
+import type { StringRecord } from '../scan/string-record.js';
+/** The `name` a domain event class gives itself: `readonly name = '...'`, `name: string = '...'`. */
+export declare function domainEventNames(file: SourceFile): StringRecord[];
+//# sourceMappingURL=domain-event-names.d.ts.map

package/dist/check/events/domain-event-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event-names.d.ts","sourceRoot":"","sources":["../../../src/check/events/domain-event-names.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7D,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,EAAE,CAIjE"}

package/dist/check/events/domain-event-names.js

@@ -0,0 +1,7 @@
+/** `name = '...'`, `name: '...'` and `name: string = '...'`. */
+const NAME_PROPERTY = /(?<![\w$.])name\s*\??\s*(?:[:=]|:[^=;\n'"]+=)\s*$/;
+/** The `name` a domain event class gives itself: `readonly name = '...'`, `name: string = '...'`. */
+export function domainEventNames(file) {
+    return file.scan.strings.filter((literal) => NAME_PROPERTY.test(file.scan.code.slice(Math.max(0, literal.start - 200), literal.start)));
+}
+//# sourceMappingURL=domain-event-names.js.map

package/dist/check/events/domain-event-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event-names.js","sourceRoot":"","sources":["../../../src/check/events/domain-event-names.ts"],"names":[],"mappings":"AAGA,gEAAgE;AAChE,MAAM,aAAa,GAAG,mDAAmD,CAAC;AAE1E,qGAAqG;AACrG,MAAM,UAAU,gBAAgB,CAAC,IAAgB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAC1C,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAC1F,CAAC;AACJ,CAAC"}

package/dist/check/events/event-declarations.d.ts

@@ -0,0 +1,15 @@
+import type { SourceFile } from '../model/source-file.js';
+export interface EventDeclaration {
+    readonly start: number;
+    readonly end: number;
+    /** The `type` given to the declaration itself, not a `type` of its payload schema. */
+    readonly type: {
+        readonly value: string;
+        readonly line: number;
+    } | undefined;
+    readonly version: string;
+    readonly hasPayload: boolean;
+}
+/** The `defineIntegrationEvent({ ... })` calls found in a source. */
+export declare function eventDeclarations(file: SourceFile): EventDeclaration[];
+//# sourceMappingURL=event-declarations.d.ts.map

package/dist/check/events/event-declarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-declarations.d.ts","sourceRoot":"","sources":["../../../src/check/events/event-declarations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAQ1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,EAAE,CAgBtE"}

package/dist/check/events/event-declarations.js

@@ -0,0 +1,37 @@
+import { callEnd } from '../text/call-end.js';
+import { isTypeLiteral } from './is-type-literal.js';
+const DECLARATION = /(?<![\w$.])defineIntegrationEvent\s*(?:<[^<>()]*>)?\s*\(/g;
+const PAYLOAD_KEY = /(?<![\w$.])payload\s*[:,}]/;
+const VERSION_KEY = /(?<![\w$.])version\s*:\s*(\d+)/;
+/** The `defineIntegrationEvent({ ... })` calls found in a source. */
+export function eventDeclarations(file) {
+    const { code } = file.scan;
+    return [...code.matchAll(DECLARATION)].map((match) => {
+        const argumentsStart = match.index + match[0].length;
+        const end = callEnd(code, argumentsStart);
+        const body = code.slice(match.index, end);
+        return {
+            start: match.index,
+            end,
+            type: typeOf(file, argumentsStart, end),
+            version: VERSION_KEY.exec(body)?.[1] ?? '?',
+            hasPayload: PAYLOAD_KEY.test(body),
+        };
+    });
+}
+function typeOf(file, argumentsStart, end) {
+    const { code, strings } = file.scan;
+    const type = strings.find((literal) => {
+        if (literal.start < argumentsStart || literal.start >= end || !isTypeLiteral(file, literal.start)) {
+            return false;
+        }
+        // Directly in the options object: one brace deep, not inside a nested call.
+        const before = code.slice(argumentsStart, literal.start);
+        return count(before, '{') - count(before, '}') === 1 && count(before, '(') === count(before, ')');
+    });
+    return type === undefined ? undefined : { value: type.value, line: type.line };
+}
+function count(text, char) {
+    return text.split(char).length - 1;
+}
+//# sourceMappingURL=event-declarations.js.map

package/dist/check/events/event-declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-declarations.js","sourceRoot":"","sources":["../../../src/check/events/event-declarations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,GAAG,2DAA2D,CAAC;AAChF,MAAM,WAAW,GAAG,4BAA4B,CAAC;AACjD,MAAM,WAAW,GAAG,gCAAgC,CAAC;AAWrD,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;IAE3B,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACnD,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACrD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAE1C,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG;YACH,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC;YACvC,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG;YAC3C,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;SACnC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,MAAM,CAAC,IAAgB,EAAE,cAAsB,EAAE,GAAW;IACnE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;IAEpC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QACpC,IAAI,OAAO,CAAC,KAAK,GAAG,cAAc,IAAI,OAAO,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClG,OAAO,KAAK,CAAC;QACf,CAAC;QAED,4EAA4E;QAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAEzD,OAAO,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpG,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;AACjF,CAAC;AAED,SAAS,KAAK,CAAC,IAAY,EAAE,IAAY;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACrC,CAAC"}

package/dist/check/events/in-declaration.d.ts

@@ -0,0 +1,3 @@
+import type { EventDeclaration } from './event-declarations.js';
+export declare function inDeclaration(declarations: readonly EventDeclaration[], offset: number): boolean;
+//# sourceMappingURL=in-declaration.d.ts.map

package/dist/check/events/in-declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-declaration.d.ts","sourceRoot":"","sources":["../../../src/check/events/in-declaration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,wBAAgB,aAAa,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhG"}

package/dist/check/events/in-declaration.js

@@ -0,0 +1,4 @@
+export function inDeclaration(declarations, offset) {
+    return declarations.some((declaration) => offset > declaration.start && offset < declaration.end);
+}
+//# sourceMappingURL=in-declaration.js.map

package/dist/check/events/in-declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-declaration.js","sourceRoot":"","sources":["../../../src/check/events/in-declaration.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,YAAyC,EAAE,MAAc;IACrF,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,MAAM,GAAG,WAAW,CAAC,KAAK,IAAI,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;AACpG,CAAC"}

package/dist/check/events/is-type-literal.d.ts

@@ -0,0 +1,4 @@
+import type { SourceFile } from '../model/source-file.js';
+/** True when the string literal starting at `start` is the value of a `type` key. */
+export declare function isTypeLiteral(file: SourceFile, start: number): boolean;
+//# sourceMappingURL=is-type-literal.d.ts.map

package/dist/check/events/is-type-literal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-type-literal.d.ts","sourceRoot":"","sources":["../../../src/check/events/is-type-literal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAI1D,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtE"}

package/dist/check/events/is-type-literal.js

@@ -0,0 +1,6 @@
+const TYPE_KEY = /(?<![\w$.])type\s*\??\s*:\s*$/;
+/** True when the string literal starting at `start` is the value of a `type` key. */
+export function isTypeLiteral(file, start) {
+    return TYPE_KEY.test(file.scan.code.slice(Math.max(0, start - 40), start));
+}
+//# sourceMappingURL=is-type-literal.js.map

package/dist/check/events/is-type-literal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-type-literal.js","sourceRoot":"","sources":["../../../src/check/events/is-type-literal.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AAEjD,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,IAAgB,EAAE,KAAa;IAC3D,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/check/events/name-of-event-class.d.ts

@@ -0,0 +1,4 @@
+import type { SourceFile } from '../model/source-file.js';
+/** The name written in the body of the class `className`, when the file declares that class and names it with a literal. */
+export declare function nameOfEventClass(file: SourceFile, className: string): string | undefined;
+//# sourceMappingURL=name-of-event-class.d.ts.map

package/dist/check/events/name-of-event-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-of-event-class.d.ts","sourceRoot":"","sources":["../../../src/check/events/name-of-event-class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,4HAA4H;AAC5H,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASxF"}

package/dist/check/events/name-of-event-class.js

@@ -0,0 +1,11 @@
+import { domainEventNames } from './domain-event-names.js';
+/** The name written in the body of the class `className`, when the file declares that class and names it with a literal. */
+export function nameOfEventClass(file, className) {
+    const declared = file.structure.classes.find((candidate) => candidate.name === className);
+    if (declared === undefined) {
+        return undefined;
+    }
+    return domainEventNames(file).find((literal) => literal.start > declared.start && literal.start < declared.end)
+        ?.value;
+}
+//# sourceMappingURL=name-of-event-class.js.map

package/dist/check/events/name-of-event-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-of-event-class.js","sourceRoot":"","sources":["../../../src/check/events/name-of-event-class.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,4HAA4H;AAC5H,MAAM,UAAU,gBAAgB,CAAC,IAAgB,EAAE,SAAiB;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAE1F,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC;QAC7G,EAAE,KAAK,CAAC;AACZ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,46 @@
+export const AUTHZ_DOCS = {
+    'authz/declared': {
+        why: 'A use case nobody thought about is reachable by everybody. Declaring the permission next to the registration, or declaring the use case public, makes the decision visible in review and lets the bus middleware refuse everything else. The same holds for a route: its security is part of the contract, not a default. The route type enforces it already (`defineRoute` does not compile without `security` and refuses an empty list); this rule stays as the net for a definition built loosely, from an untyped object or a cast. On a message class, @Requires(...) or @Public() of @ddd-ts-kit/kernel/declarations is the declaration, in any project; in the declared style there is no registration to read, so a command or query class carrying neither is reported.',
+        bad: `builder.command(VoidInvoiceCommand).handledBy(VoidInvoiceHandler, [InvoiceRepository]);
+defineRoute({ method: 'POST', path: '/invoices/:id/void' }, handler);
+// application/commands/void-invoice/void-invoice.command.ts, declared style
+export class VoidInvoiceCommand extends AuthorizedCommand<void> {}`,
+        good: `builder.command(VoidInvoiceCommand).requires(billingPermissions['invoice.void']).handledBy(VoidInvoiceHandler, [InvoiceRepository]);
+builder.query(GetCatalogQuery).public().handledBy(GetCatalogHandler, [CatalogReader]);
+defineRoute({ method: 'POST', path: '/invoices/:id/void', security: ['bearer'] }, handler);
+// application/commands/void-invoice/void-invoice.command.ts, declared style
+@Requires(billingPermissions['invoice.void'])
+export class VoidInvoiceCommand extends AuthorizedCommand<void> {}`,
+    },
+    'authz/in-application': {
+        why: 'A right decided in a route is skipped by every other entry point: a consumer, a job, another route. Decided in an adapter or in an aggregate, it is invisible and tied to one authorization model. In the application layer, behind the Authorizer port, every right is declared once, tested once, and changing from roles to policies or relationships changes an adapter only. A route keeps the request glue of @ddd-ts-kit/auth (actorOf, sessionOf, resolveSession, a SessionAuthenticator); the domain sees neither the Actor, the Session nor the ExecutionContext. The access decorators (Requires, Public, Policy of @ddd-ts-kit/kernel/declarations) and the access ports of @ddd-ts-kit/auth (Access, PolicyAccess) are how the application layer says it: they are imported in application/ and refused in presentation/, infrastructure/ and domain/.',
+        bad: `// presentation/http/void-invoice.route.ts
+if (!context.principal.roles.includes('admin')) {
+  return { status: 403 };
+}
+// presentation/http/void-invoice.route.ts
+import { Requires } from '@ddd-ts-kit/kernel/declarations';`,
+        good: `// presentation/http/void-invoice.route.ts
+await commandBus.execute(new VoidInvoiceCommand(actorOf(context.principal), params.invoiceId));
+// application/commands/void-invoice/void-invoice.handler.ts
+await this.access.authorize(command.actor, billingPermissions['invoice.void'], invoice);
+// application/authorization/only-issuer-voids.policy.ts
+@Policy(billingPermissions['invoice.void'], { name: 'billing.only-issuer-voids' })
+export class OnlyIssuerVoidsPolicy {}`,
+    },
+    'authz/actor-explicit': {
+        why: 'A handler that reads "the current user" from an ambient context depends on something no signature shows: a consumer or a job that forgot to set it fails at run time, and a test has to set a global. With the actor as data of the command, the use case says who acts, and any caller can send it. The ExecutionScope port (and ActorContext, a view of it) is named and read by infrastructure and the platform alone, as a type or as a value in a dependency list, for audit columns, tenant scoping and correlation: stampCreation, stampUpdate and tenantScopeOf belong in a repository adapter.',
+        bad: `// application/commands/void-invoice/void-invoice.handler.ts
+@CommandHandler(VoidInvoiceCommand, [InvoiceRepository, ExecutionScope])
+const actor = this.actors.require();
+const { tenantId } = this.scope.require();
+const stamp = stampCreation(this.scope, this.clock);`,
+        good: `// application/commands/void-invoice/void-invoice.command.ts
+export class VoidInvoiceCommand extends AuthorizedCommand {}
+// application/commands/void-invoice/void-invoice.handler.ts
+const { actor } = command;
+// infrastructure/persistence/drizzle-invoice.repository.ts
+const row = { ...toRow(invoice), ...stampCreation(this.scope, this.clock), ...tenantScopeOf(this.scope) };`,
+    },
+};
+//# sourceMappingURL=authz-docs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authz-docs.js","sourceRoot":"","sources":["../../../src/check/explain/authz-docs.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAsC;IAC3D,gBAAgB,EAAE;QAChB,GAAG,EAAE,mvBAAmvB;QACxvB,GAAG,EAAE;;;mEAG0D;QAC/D,IAAI,EAAE;;;;;mEAKyD;KAChE;IACD,sBAAsB,EAAE;QACtB,GAAG,EAAE,q0BAAq0B;QAC10B,GAAG,EAAE;;;;;4DAKmD;QACxD,IAAI,EAAE;;;;;;sCAM4B;KACnC;IACD,sBAAsB,EAAE;QACtB,GAAG,EAAE,ykBAAykB;QAC9kB,GAAG,EAAE;;;;qDAI4C;QACjD,IAAI,EAAE;;;;;2GAKiG;KACxG;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,39 @@
+export const CLEAN_DOCS = {
+    'clean/stepdown': {
+        why: 'A reader opens a file to learn what it does, then, if needed, how. With the public members first and each helper below its first caller, the file reads once from top to bottom, like a newspaper article. Helpers on top force the reader to hold details before knowing what they serve.',
+        bad: `function parseLine(line: string) {}
+export function parseFile(text: string) { return text.split('\\n').map(parseLine); }`,
+        good: `export function parseFile(text: string) { return text.split('\\n').map(parseLine); }
+function parseLine(line: string) {}`,
+    },
+    'clean/function-size': {
+        why: 'A long function mixes several levels of abstraction, and its parts can be neither named nor tested alone. More than three parameters usually travel together because they are one concept without a type. Small functions with few arguments are what makes the stepdown order readable. The limits are configurable under `limits`, up to a ceiling: no function is longer than 100 lines, describe callbacks, module files and tests included, and that ceiling is an error whatever the severity of the rule.',
+        bad: `function issue(id: string, customer: string, amount: number, currency: string, dueOn: Date) {}`,
+        good: `function issue(id: string, customer: CustomerId, total: Money) {}`,
+    },
+    'clean/no-commented-out-code': {
+        why: 'Nobody dares to delete commented-out code: it looks important and is never run, compiled or tested. It rots while the code around it changes, and misleads the next reader. Version control keeps every past version without that cost.',
+        bad: `// const total = lines.reduce((sum, line) => sum + line.amount, 0);`,
+        good: `(nothing: the old version is in the history)`,
+    },
+    'clean/no-noise-comment': {
+        why: 'A comment that repeats the name, draws a banner or records who changed what adds reading time and no information, and it drifts from the code it sits on. Comments are kept for what the code cannot say: why, a warning, an external reference.',
+        bad: `/** Gets the order. */
+getOrder(): Order {}
+// ---------- helpers ----------`,
+        good: `// Rounded half-even: required by the tax authority (art. 242).
+round(amount: Money): Money {}`,
+    },
+    'clean/no-escape-hatch': {
+        why: 'any, the non-null assertion and suppressed diagnostics tell the compiler to stop checking, and the error it would have reported comes back at run time, far from its cause. When one is really needed, the written reason is what lets a reviewer judge it.',
+        bad: `const total = (order as any).lines!.length; // @ts-ignore`,
+        good: `if (order.lines === undefined) throw new OrderWithoutLines(order.id);`,
+    },
+    'clean/no-flag-argument': {
+        why: 'A boolean parameter means the method does two things, and the call site (`close(true)`) does not say which. Two methods named after the two intentions are readable at the call site and can each guard their own invariants.',
+        bad: `cancel(refund: boolean): void {}`,
+        good: `cancel(): void {}
+cancelAndRefund(): void {}`,
+    },
+};
+//# sourceMappingURL=clean-docs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clean-docs.js","sourceRoot":"","sources":["../../../src/check/explain/clean-docs.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAsC;IAC3D,gBAAgB,EAAE;QAChB,GAAG,EAAE,4RAA4R;QACjS,GAAG,EAAE;qFAC4E;QACjF,IAAI,EAAE;oCAC0B;KACjC;IACD,qBAAqB,EAAE;QACrB,GAAG,EAAE,kfAAkf;QACvf,GAAG,EAAE,gGAAgG;QACrG,IAAI,EAAE,mEAAmE;KAC1E;IACD,6BAA6B,EAAE;QAC7B,GAAG,EAAE,yOAAyO;QAC9O,GAAG,EAAE,qEAAqE;QAC1E,IAAI,EAAE,8CAA8C;KACrD;IACD,wBAAwB,EAAE;QACxB,GAAG,EAAE,kPAAkP;QACvP,GAAG,EAAE;;iCAEwB;QAC7B,IAAI,EAAE;+BACqB;KAC5B;IACD,uBAAuB,EAAE;QACvB,GAAG,EAAE,6PAA6P;QAClQ,GAAG,EAAE,2DAA2D;QAChE,IAAI,EAAE,uEAAuE;KAC9E;IACD,wBAAwB,EAAE;QACxB,GAAG,EAAE,+NAA+N;QACpO,GAAG,EAAE,kCAAkC;QACvC,IAAI,EAAE;2BACiB;KACxB;CACF,CAAC"}

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

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