@ddd-ts-kit/eslint-plugin 0.0.0-stage → 0.1.0

package/dist/rules/domain-events-dispatched-on-save.js.map

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

package/dist/rules/domain-events-transactional-before-commit.d.ts

@@ -0,0 +1,4 @@
+type MessageId = 'beforeCommit' | 'afterCommit';
+export declare const domainEventsTransactionalBeforeCommit: import("@typescript-eslint/utils/ts-eslint").RuleModule<MessageId, [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+export {};
+//# sourceMappingURL=domain-events-transactional-before-commit.d.ts.map

package/dist/rules/domain-events-transactional-before-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-events-transactional-before-commit.d.ts","sourceRoot":"","sources":["../../src/rules/domain-events-transactional-before-commit.ts"],"names":[],"mappings":"AAaA,KAAK,SAAS,GAAG,cAAc,GAAG,aAAa,CAAC;AAkBhD,eAAO,MAAM,qCAAqC,mKAmDhD,CAAC"}

package/dist/rules/domain-events-transactional-before-commit.js

@@ -0,0 +1,121 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { propertyOf } from '../support/calls/property-of.js';
+import { className } from '../support/classes/class-name.js';
+import { constructorOf } from '../support/classes/constructor-of.js';
+import { declarationReader } from '../support/declarations/declaration-reader.js';
+import { inContext } from '../support/imports/in-context.js';
+import { staticString } from '../support/imports/static-string.js';
+import { importedBindings } from '../support/ports/imported-bindings.js';
+import { defineRule } from '../support/rule/define-rule.js';
+import { parameterTypeName } from '../support/types/parameter-type-name.js';
+const DECORATOR = 'DomainEventHandler';
+const KERNEL = '@ddd-ts-kit/kernel';
+const TRUSTED_PACKAGES = new Set([KERNEL, '@ddd-ts-kit/auth']);
+/** The ports of the kernel whose effect no transaction covers. */
+const OUTSIDE_THE_TRANSACTION = new Set(['Cache', 'Lock', 'RateLimiter', 'JobScheduler', 'EventBus']);
+const PUBLISHER = 'IntegrationEventPublisher';
+const ROLLED_BACK = "A handler that runs before the commit runs inside the transaction, and the commit can still fail after it ran: it may only have effects the rollback undoes. Declare the handler `phase: 'after-commit'` when its effect may be lost on a crash (it then runs at most once), or publish an integration event from a publisher (outbox, at least once) and do the work in the handler of that event when it must not be lost.";
+export const domainEventsTransactionalBeforeCommit = defineRule({
+    id: 'domain-events/transactional-before-commit',
+    type: 'problem',
+    recommended: 'error',
+    description: 'A declared domain event handler that runs before the commit has only effects the rollback undoes: no Cache, Lock, RateLimiter, JobScheduler or EventBus of the kernel, nothing from infrastructure/, another context, the platform or a foreign package; an after-commit handler never depends on IntegrationEventPublisher.',
+    messages: {
+        beforeCommit: `{{handler}} runs before the commit and depends on {{name}}, {{why}}: its effect would survive a rollback. ${ROLLED_BACK}`,
+        afterCommit: `{{handler}} runs after the commit and depends on {{name}}: the event it publishes would be committed apart from the state change it announces. Send a command through the \`CommandBus\` port and let the publisher of the event that command records write to the outbox, or leave this handler before the commit.`,
+    },
+    create({ file, sourceCode, report }) {
+        const context = inContext(file)?.context;
+        if (context === undefined || file.isTest) {
+            return {};
+        }
+        const declarationsOf = declarationReader(sourceCode.ast);
+        const imported = importedBindings(file, sourceCode.ast);
+        const judgeClass = (node) => {
+            const declaration = declarationsOf(node).find((candidate) => candidate.name === DECORATOR);
+            if (declaration === undefined) {
+                return;
+            }
+            const handler = className(node);
+            const isAfterCommit = runsAfterCommit(declaration);
+            for (const { name, node: where } of dependenciesOf(node, declaration)) {
+                const origin = originOf(imported.get(name));
+                if (origin === undefined) {
+                    continue;
+                }
+                if (isAfterCommit && isKernel(origin, PUBLISHER)) {
+                    report({ node: where, messageId: 'afterCommit', data: { handler, name } });
+                }
+                const why = isAfterCommit ? undefined : refusedBeforeCommit(context, origin);
+                if (why !== undefined) {
+                    report({ node: where, messageId: 'beforeCommit', data: { handler, name, why } });
+                }
+            }
+        };
+        return { ClassDeclaration: judgeClass, ClassExpression: judgeClass };
+    },
+});
+function runsAfterCommit(declaration) {
+    const [, options] = declaration.arguments;
+    const phase = options?.type === AST_NODE_TYPES.ObjectExpression ? propertyOf(options, 'phase') : undefined;
+    return phase !== undefined && staticString(phase.value) === 'after-commit';
+}
+/** Each name once: the dependency list of the decorator first, then the types of the constructor parameters. */
+function dependenciesOf(node, declaration) {
+    const list = declaration.arguments.at(-1);
+    const listed = list?.type === AST_NODE_TYPES.ArrayExpression
+        ? list.elements.flatMap((element) => element?.type === AST_NODE_TYPES.Identifier ? [{ name: element.name, node: element }] : [])
+        : [];
+    const received = (constructorOf(node.body)?.value.params ?? []).flatMap((parameter) => {
+        const name = parameterTypeName(parameter);
+        return name === undefined ? [] : [{ name, node: parameter }];
+    });
+    const all = [...listed, ...received];
+    return all.filter((dependency, index) => all.findIndex((other) => other.name === dependency.name) === index);
+}
+function originOf(binding) {
+    if (binding === undefined) {
+        return undefined;
+    }
+    const { specifier, target } = binding;
+    if (specifier.type !== AST_NODE_TYPES.ImportSpecifier) {
+        return { exported: specifier.local.name, target };
+    }
+    return {
+        exported: specifier.imported.type === AST_NODE_TYPES.Identifier ? specifier.imported.name : specifier.imported.value,
+        target,
+    };
+}
+function isKernel({ exported, target }, name) {
+    return target.kind === 'package' && target.name === KERNEL && exported === name;
+}
+/** Why a handler of `context` that runs before the commit may not depend on this; undefined when it may, or when one file cannot tell. */
+function refusedBeforeCommit(context, origin) {
+    const { target } = origin;
+    if (target.kind === 'builtin') {
+        return `which comes from ${target.name}`;
+    }
+    if (target.kind === 'package') {
+        return fromPackage(origin, 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({ exported }, packageName) {
+    if (!TRUSTED_PACKAGES.has(packageName)) {
+        return `which comes from the package ${packageName}`;
+    }
+    return packageName === KERNEL && OUTSIDE_THE_TRANSACTION.has(exported)
+        ? 'a port of the kernel no transaction covers'
+        : undefined;
+}
+//# sourceMappingURL=domain-events-transactional-before-commit.js.map

package/dist/rules/domain-events-transactional-before-commit.js.map

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

package/dist/rules/domain-no-generic-error.d.ts

@@ -0,0 +1,2 @@
+export declare const domainNoGenericError: import("@typescript-eslint/utils/ts-eslint").RuleModule<"generic", [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+//# sourceMappingURL=domain-no-generic-error.d.ts.map

package/dist/rules/domain-no-generic-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-no-generic-error.d.ts","sourceRoot":"","sources":["../../src/rules/domain-no-generic-error.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,mKAmC/B,CAAC"}

package/dist/rules/domain-no-generic-error.js

@@ -0,0 +1,32 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { defineRule } from '../support/rule/define-rule.js';
+import { ambientName } from '../support/globals/ambient-name.js';
+export const domainNoGenericError = defineRule({
+    id: 'domain/no-generic-error',
+    type: 'problem',
+    recommended: 'error',
+    description: 'No `throw new Error(...)` in domain/ or application/: an expected failure is a DomainError with a stable code.',
+    messages: {
+        generic: 'A generic Error says nothing a caller can act on. Throw a DomainError with a stable code (`ddd-ts-kit generate domain-error {{context}} <Name>`): presentation maps the code to a status in one place.',
+    },
+    create({ file, sourceCode, report }) {
+        const { location } = file;
+        if (location.area !== 'context' ||
+            file.isTest ||
+            (location.layer !== 'domain' && location.layer !== 'application')) {
+            return {};
+        }
+        return {
+            ThrowStatement(node) {
+                const thrown = node.argument;
+                if (thrown.type !== AST_NODE_TYPES.NewExpression && thrown.type !== AST_NODE_TYPES.CallExpression) {
+                    return;
+                }
+                if (ambientName(sourceCode, thrown.callee) === 'Error') {
+                    report({ node: thrown, messageId: 'generic', data: { context: location.context } });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=domain-no-generic-error.js.map

package/dist/rules/domain-no-generic-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-no-generic-error.js","sourceRoot":"","sources":["../../src/rules/domain-no-generic-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAY;IACxD,EAAE,EAAE,yBAAyB;IAC7B,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,OAAO;IACpB,WAAW,EACT,gHAAgH;IAClH,QAAQ,EAAE;QACR,OAAO,EACL,wMAAwM;KAC3M;IACD,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE;QACjC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAE1B,IACE,QAAQ,CAAC,IAAI,KAAK,SAAS;YAC3B,IAAI,CAAC,MAAM;YACX,CAAC,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,KAAK,KAAK,aAAa,CAAC,EACjE,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL,cAAc,CAAC,IAAI;gBACjB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC;gBAE7B,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,aAAa,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,cAAc,EAAE,CAAC;oBAClG,OAAO;gBACT,CAAC;gBAED,IAAI,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC;oBACvD,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACtF,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/domain-value-object-immutability.d.ts

@@ -0,0 +1,4 @@
+type MessageId = 'mutableProperty' | 'setter' | 'mutation';
+export declare const domainValueObjectImmutability: import("@typescript-eslint/utils/ts-eslint").RuleModule<MessageId, [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+export {};
+//# sourceMappingURL=domain-value-object-immutability.d.ts.map

package/dist/rules/domain-value-object-immutability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-value-object-immutability.d.ts","sourceRoot":"","sources":["../../src/rules/domain-value-object-immutability.ts"],"names":[],"mappings":"AAgBA,KAAK,SAAS,GAAG,iBAAiB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D,eAAO,MAAM,6BAA6B,mKA+CxC,CAAC"}

package/dist/rules/domain-value-object-immutability.js

@@ -0,0 +1,77 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { className } from '../support/classes/class-name.js';
+import { constructorOf } from '../support/classes/constructor-of.js';
+import { enclosingMember } from '../support/classes/enclosing-member.js';
+import { isCallable } from '../support/classes/is-callable.js';
+import { isConstructor } from '../support/classes/is-constructor.js';
+import { memberName } from '../support/classes/member-name.js';
+import { defineRule } from '../support/rule/define-rule.js';
+import { propertyName } from '../support/globals/property-name.js';
+import { parameterName } from '../support/members/parameter-name.js';
+import { parameterProperties } from '../support/members/parameter-properties.js';
+import { startsAtThis } from '../support/members/starts-at-this.js';
+const ARRAY_MUTATORS = new Set(['push', 'pop', 'shift', 'unshift', 'splice', 'sort', 'reverse', 'fill', 'copyWithin']);
+export const domainValueObjectImmutability = defineRule({
+    id: 'domain/value-object-immutability',
+    type: 'problem',
+    recommended: 'error',
+    description: 'A value object is immutable: every property is readonly, there is no setter and no method writes to `this`.',
+    messages: {
+        mutableProperty: 'The property {{name}} of the value object {{className}} is not readonly. Mark it readonly: a value object never changes, an operation returns a new instance.',
+        setter: 'The value object {{className}} has the setter {{name}}. Remove it and return a new {{className}} from a method named after the operation.',
+        mutation: '{{className}} changes its own state ({{target}}). Return a new {{className}} built from the new values instead: a value object is immutable and compared by value.',
+    },
+    create({ file, sourceCode, report }) {
+        if (!isValueObjectFile(file)) {
+            return {};
+        }
+        const mutation = (node, target) => {
+            const site = enclosingMember(node);
+            if (site === undefined || isConstructor(site.member) || !startsAtThis(target)) {
+                return;
+            }
+            report({
+                node,
+                messageId: 'mutation',
+                data: { className: className(site.body.parent), target: sourceCode.getText(target) },
+            });
+        };
+        return {
+            ClassBody: (body) => judgeMembers(body, report),
+            AssignmentExpression: (node) => mutation(node, node.left),
+            UpdateExpression: (node) => mutation(node, node.argument),
+            CallExpression(node) {
+                if (node.callee.type === AST_NODE_TYPES.MemberExpression &&
+                    ARRAY_MUTATORS.has(propertyName(node.callee) ?? '')) {
+                    mutation(node, node.callee.object);
+                }
+            },
+        };
+    },
+});
+function isValueObjectFile(file) {
+    const { location } = file;
+    return (location.area === 'context' && location.layer === 'domain' && !file.isTest && location.inside[0] === 'value-objects');
+}
+function judgeMembers(body, report) {
+    const owner = className(body.parent);
+    for (const name of mutablePropertyNames(body)) {
+        report({ node: name.node, messageId: 'mutableProperty', data: { className: owner, name: name.text } });
+    }
+    for (const member of body.body.filter(isSetter)) {
+        report({ node: member.key, messageId: 'setter', data: { className: owner, name: memberName(member) ?? '' } });
+    }
+}
+function mutablePropertyNames(body) {
+    const fields = body.body.filter((member) => member.type === AST_NODE_TYPES.PropertyDefinition || member.type === AST_NODE_TYPES.AccessorProperty);
+    const writable = fields.filter((member) => !member.readonly && !member.declare && !isCallable(member));
+    const parameters = parameterProperties(constructorOf(body)).filter((property) => !property.readonly);
+    return [
+        ...writable.map((member) => ({ node: member.key, text: memberName(member) ?? 'a computed key' })),
+        ...parameters.map((property) => ({ node: property, text: parameterName(property) })),
+    ];
+}
+function isSetter(member) {
+    return member.type === AST_NODE_TYPES.MethodDefinition && member.kind === 'set';
+}
+//# sourceMappingURL=domain-value-object-immutability.js.map

package/dist/rules/domain-value-object-immutability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-value-object-immutability.js","sourceRoot":"","sources":["../../src/rules/domain-value-object-immutability.ts"],"names":[],"mappings":"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"}

package/dist/rules/events-consumer-idempotent.d.ts

@@ -0,0 +1,5 @@
+import { TSESLint } from '@typescript-eslint/utils';
+type MessageId = 'consumerName' | 'declaredName' | 'subscription' | 'directSubscribe';
+export declare const eventsConsumerIdempotent: TSESLint.RuleModule<MessageId, [], import("../index.js").RuleDocs, TSESLint.RuleListener>;
+export {};
+//# sourceMappingURL=events-consumer-idempotent.d.ts.map

package/dist/rules/events-consumer-idempotent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-consumer-idempotent.d.ts","sourceRoot":"","sources":["../../src/rules/events-consumer-idempotent.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,QAAQ,EAAiB,MAAM,0BAA0B,CAAC;AAY7F,KAAK,SAAS,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,iBAAiB,CAAC;AAUtF,eAAO,MAAM,wBAAwB,2FAgDnC,CAAC"}

package/dist/rules/events-consumer-idempotent.js

@@ -0,0 +1,115 @@
+import { ASTUtils, AST_NODE_TYPES, TSESLint } from '@typescript-eslint/utils';
+import { calleeName } from '../support/calls/callee-name.js';
+import { methodChain } from '../support/calls/method-chain.js';
+import { missingKeys } from '../support/calls/missing-keys.js';
+import { className } from '../support/classes/class-name.js';
+import { declarationReader } from '../support/declarations/declaration-reader.js';
+import { isDeclaredStyle } from '../support/declarations/is-declared-style.js';
+import { writtenName } from '../support/declarations/written-name.js';
+import { defineRule } from '../support/rule/define-rule.js';
+import { propertyName } from '../support/globals/property-name.js';
+import { inContext } from '../support/imports/in-context.js';
+const EVENTS = '@ddd-ts-kit/events';
+const HANDLER_BINDINGS = new Set(['handledBy', 'handledByFactory']);
+const WHY = 'Delivery is at least once: without a stable consumer name and a processed-event store, a redelivered event is handled twice.';
+export const eventsConsumerIdempotent = defineRule({
+    id: 'events/consumer-idempotent',
+    type: 'problem',
+    recommended: 'error',
+    description: 'Every consumer of an integration event is registered or declared with a stable consumer name and a processed-event store.',
+    messages: {
+        consumerName: `This consumer is declared without a name. ${WHY} Write \`.on(<definition>, { consumer: '{{context}}.<reaction>' })\`: the name is the idempotency scope and must never change.`,
+        declaredName: `{{className}} is declared with \`@IntegrationEventHandler\` but its \`consumer\` is {{problem}}. ${WHY} Write \`@IntegrationEventHandler(<definition>, { consumer: '{{context}}.<reaction>' }, [<ports>])\` with the name as a string literal: it is the idempotency scope and must never change.`,
+        subscription: `This subscription gives no {{missing}}. ${WHY} Pass \`{ consumer: '{{context}}.<reaction>', processed: <the processed-event store> }\` as third argument, or use \`consume\`, which also commits the mark with the handler.`,
+        directSubscribe: `{{call}}() subscribes a handler that nothing deduplicates. ${WHY} Declare the consumer with \`builder.on(<definition>, { consumer })\` in the module, or wrap the handler with \`on\` or \`consume\` of ${EVENTS}.`,
+    },
+    create({ file, sourceCode, report }) {
+        const here = inContext(file);
+        if (here === undefined || file.isTest) {
+            return {};
+        }
+        const subscribesHere = here.layer === 'application' || here.layer === 'module';
+        const tell = (finding) => {
+            if (finding !== undefined) {
+                report({ ...finding, data: { ...finding.data, context: here.context } });
+            }
+        };
+        const declarationsOf = isDeclaredStyle(file) ? declarationReader(sourceCode.ast) : undefined;
+        const judgeClass = (node) => {
+            for (const declaration of declarationsOf?.(node) ?? []) {
+                tell(unnamedHandler(node, declaration));
+            }
+        };
+        return {
+            CallExpression(node) {
+                tell(unnamedConsumer(node));
+                tell(unprotectedSubscription(node, sourceCode));
+                if (subscribesHere) {
+                    tell(directSubscription(node, sourceCode));
+                }
+            },
+            ClassDeclaration: judgeClass,
+            ClassExpression: judgeClass,
+        };
+    },
+});
+/** `@IntegrationEventHandler(definition, { consumer: 'billing.price-list' }, [...])`: the class is its own registration. */
+function unnamedHandler(node, declaration) {
+    if (declaration.name !== 'IntegrationEventHandler') {
+        return undefined;
+    }
+    const consumer = writtenName(declaration.arguments[1], 'consumer');
+    return 'value' in consumer
+        ? undefined
+        : {
+            node: declaration.node,
+            messageId: 'declaredName',
+            data: { className: className(node), problem: consumer.problem },
+        };
+}
+/** `builder.on(definition, options).handledBy(Handler)`: the chain tells this `on` from the one of an event emitter. */
+function unnamedConsumer(node) {
+    if (node.callee.type !== AST_NODE_TYPES.MemberExpression || !HANDLER_BINDINGS.has(calleeName(node) ?? '')) {
+        return undefined;
+    }
+    const [declaration] = methodChain(node);
+    if (declaration?.name !== 'on' || missingKeys(declaration.call.arguments[1], ['consumer']).length === 0) {
+        return undefined;
+    }
+    return { node: declaration.call, messageId: 'consumerName' };
+}
+function unprotectedSubscription(node, sourceCode) {
+    if (node.callee.type !== AST_NODE_TYPES.Identifier || !isImportOf(sourceCode, node.callee, 'on')) {
+        return undefined;
+    }
+    const missing = missingKeys(node.arguments[2], ['consumer', 'processed']);
+    return missing.length === 0
+        ? undefined
+        : { node, messageId: 'subscription', data: { missing: missing.map((key) => `\`${key}\``).join(' and ') } };
+}
+function isImportOf(sourceCode, identifier, exported) {
+    const definition = ASTUtils.findVariable(sourceCode.getScope(identifier), identifier.name)?.defs[0];
+    if (definition?.type !== TSESLint.Scope.DefinitionType.ImportBinding ||
+        definition.node.type !== AST_NODE_TYPES.ImportSpecifier) {
+        return false;
+    }
+    const { imported } = definition.node;
+    return (definition.parent.type === AST_NODE_TYPES.ImportDeclaration &&
+        definition.parent.source.value === EVENTS &&
+        imported.type === AST_NODE_TYPES.Identifier &&
+        imported.name === exported);
+}
+function directSubscription(node, sourceCode) {
+    const { callee } = node;
+    if (callee.type !== AST_NODE_TYPES.MemberExpression ||
+        propertyName(callee) !== 'subscribe' ||
+        node.arguments.some(isDeduplicated)) {
+        return undefined;
+    }
+    return { node, messageId: 'directSubscribe', data: { call: sourceCode.getText(callee) } };
+}
+/** `idempotent(name, store, handler)` of the kernel is the primitive `on` and `consume` are built on. */
+function isDeduplicated(argument) {
+    return argument.type === AST_NODE_TYPES.CallExpression && calleeName(argument) === 'idempotent';
+}
+//# sourceMappingURL=events-consumer-idempotent.js.map

package/dist/rules/events-consumer-idempotent.js.map

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

package/dist/rules/events-name-format.d.ts

@@ -0,0 +1,2 @@
+export declare const eventsNameFormat: import("@typescript-eslint/utils/ts-eslint").RuleModule<"format", [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+//# sourceMappingURL=events-name-format.d.ts.map

package/dist/rules/events-name-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-name-format.d.ts","sourceRoot":"","sources":["../../src/rules/events-name-format.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,gBAAgB,kKAmC3B,CAAC"}

package/dist/rules/events-name-format.js

@@ -0,0 +1,53 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { keyName } from '../support/classes/key-name.js';
+import { defineRule } from '../support/rule/define-rule.js';
+import { inContext } from '../support/imports/in-context.js';
+import { staticString } from '../support/imports/static-string.js';
+const KEBAB_SEGMENT = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export const eventsNameFormat = defineRule({
+    id: 'events/name-format',
+    type: 'problem',
+    recommended: 'error',
+    description: 'Domain and integration event names follow <context>.<aggregate>.<fact-in-past-tense>, in kebab-case.',
+    messages: {
+        format: 'The event name "{{value}}" does not follow <context>.<aggregate>.<fact>. Name it "{{context}}.<aggregate>.<fact-in-past-tense>" in kebab-case, for example "{{context}}.invoice.issued".',
+    },
+    create({ file, report }) {
+        const here = inContext(file);
+        const key = here === undefined || file.isTest ? undefined : judgedKey(here);
+        if (here === undefined || key === undefined) {
+            return {};
+        }
+        const judge = (node) => {
+            const value = node.value === null || node.computed || keyName(node.key) !== key ? undefined : staticString(node.value);
+            if (value === undefined || isEventName(value, here.context)) {
+                return;
+            }
+            // In a published language, `type: 'x'` may be a plain discriminator: outside a declaration only dotted values are event names.
+            if (key === 'type' && !value.includes('.') && !isDeclarationOption(node)) {
+                return;
+            }
+            report({ node: node.value ?? node, messageId: 'format', data: { value, context: here.context } });
+        };
+        return { Property: judge, PropertyDefinition: judge };
+    },
+});
+/** A domain event carries its name in `name`, an integration event in the `type` of its declaration. */
+function judgedKey(here) {
+    if (here.layer === 'domain' && here.inside[0] === 'events') {
+        return 'name';
+    }
+    return here.layer === 'published-language' ? 'type' : undefined;
+}
+function isEventName(value, context) {
+    const parts = value.split('.');
+    return parts.length === 3 && parts[0] === context && parts.every((part) => KEBAB_SEGMENT.test(part));
+}
+function isDeclarationOption(node) {
+    const call = node.parent.type === AST_NODE_TYPES.ObjectExpression ? node.parent.parent : undefined;
+    if (call?.type !== AST_NODE_TYPES.CallExpression || call.arguments[0] !== node.parent) {
+        return false;
+    }
+    return call.callee.type === AST_NODE_TYPES.Identifier && call.callee.name === 'defineIntegrationEvent';
+}
+//# sourceMappingURL=events-name-format.js.map

package/dist/rules/events-name-format.js.map

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

package/dist/rules/events-outbox-required.d.ts

@@ -0,0 +1,7 @@
+interface Options {
+    readonly brokerPackages?: readonly string[];
+}
+type MessageId = 'broker' | 'concreteBus' | 'publisherDependency';
+export declare const eventsOutboxRequired: import("@typescript-eslint/utils/ts-eslint").RuleModule<MessageId, [Options], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+export {};
+//# sourceMappingURL=events-outbox-required.d.ts.map

package/dist/rules/events-outbox-required.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-outbox-required.d.ts","sourceRoot":"","sources":["../../src/rules/events-outbox-required.ts"],"names":[],"mappings":"AAOA,UAAU,OAAO;IACf,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAqBD,KAAK,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,qBAAqB,CAAC;AAElE,eAAO,MAAM,oBAAoB,0KAgD/B,CAAC"}

package/dist/rules/events-outbox-required.js

@@ -0,0 +1,82 @@
+import { defineRule } from '../support/rule/define-rule.js';
+import { importListener } from '../support/imports/import-listener.js';
+import { innerLayer } from '../support/imports/inner-layer.js';
+import { parameterTypeName } from '../support/types/parameter-type-name.js';
+const DEFAULT_BROKER_PACKAGES = [
+    'amqplib',
+    'kafkajs',
+    'nats',
+    '@aws-sdk/client-sqs',
+    '@aws-sdk/client-sns',
+    '@google-cloud/pubsub',
+    '@ddd-ts-kit/rabbitmq',
+    'bullmq',
+    'ioredis',
+];
+/** What carries events past the outbox: the bus port itself, every bus of a broker, and the parts of the outbox the platform alone assembles. */
+const TRANSPORT = /^(?:[\w$]*EventBus|OutboxRelay|OutboxPublisher|OutboxStore)$/;
+const TRANSPORT_TYPE = /(?:EventBus|Relay)$/;
+const THROUGH_THE_PORT = 'Depend on the IntegrationEventPublisher port of @ddd-ts-kit/kernel and publish through it: the composition root binds it to the outbox, so the event is stored in the transaction of the command and relayed afterwards.';
+export const eventsOutboxRequired = defineRule({
+    id: 'events/outbox-required',
+    type: 'problem',
+    recommended: 'error',
+    description: 'Integration events leave through the transactional outbox: domain/ and application/ never reach a broker client, a bus (the EventBus port included) or a part of the outbox.',
+    messages: {
+        broker: `The {{layer}} layer imports the broker client "{{name}}": an event sent straight to a broker is lost or duplicated when the transaction of the command fails. ${THROUGH_THE_PORT}`,
+        concreteBus: `The {{layer}} layer imports {{name}}, which carries events past the outbox: the use case would decide how events leave. ${THROUGH_THE_PORT}`,
+        publisherDependency: `{{className}} is given a {{type}}: a publisher of application/integration/publishers translates a domain event and hands it to a port. Type the parameter IntegrationEventPublisher. ${THROUGH_THE_PORT}`,
+    },
+    schema: [
+        {
+            type: 'object',
+            additionalProperties: false,
+            properties: { brokerPackages: { type: 'array', items: { type: 'string' }, uniqueItems: true } },
+        },
+    ],
+    defaultOptions: [{}],
+    create({ file, options: [options], report }) {
+        const layer = innerLayer(file);
+        if (layer === undefined) {
+            return {};
+        }
+        const brokers = options.brokerPackages ?? DEFAULT_BROKER_PACKAGES;
+        const judgesConstructors = isPublisher(file);
+        return {
+            ...importListener(file, ({ node, target, names }) => {
+                if (target.kind === 'package' && brokers.includes(target.name)) {
+                    report({ node, messageId: 'broker', data: { name: target.name, layer } });
+                    return;
+                }
+                for (const bus of names.filter((imported) => TRANSPORT.test(imported.name))) {
+                    report({ node: bus.node, messageId: 'concreteBus', data: { name: bus.name, layer } });
+                }
+            }),
+            MethodDefinition(node) {
+                if (judgesConstructors && node.kind === 'constructor') {
+                    judgeConstructor(node, report);
+                }
+            },
+        };
+    },
+});
+function judgeConstructor(node, report) {
+    for (const parameter of node.value.params) {
+        const type = parameterTypeName(parameter) ?? '';
+        if (TRANSPORT_TYPE.test(type)) {
+            report({
+                node: parameter,
+                messageId: 'publisherDependency',
+                data: { className: node.parent.parent.id?.name ?? 'The publisher', type },
+            });
+        }
+    }
+}
+function isPublisher(file) {
+    const { location } = file;
+    return (location.area === 'context' &&
+        location.layer === 'application' &&
+        location.inside[0] === 'integration' &&
+        location.inside[1] === 'publishers');
+}
+//# sourceMappingURL=events-outbox-required.js.map

package/dist/rules/events-outbox-required.js.map

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

package/dist/rules/governance-recorded-deviation.d.ts

@@ -0,0 +1,2 @@
+export declare const governanceRecordedDeviation: import("@typescript-eslint/utils/ts-eslint").RuleModule<"blanket" | "unrecorded", [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+//# sourceMappingURL=governance-recorded-deviation.d.ts.map

package/dist/rules/governance-recorded-deviation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-recorded-deviation.d.ts","sourceRoot":"","sources":["../../src/rules/governance-recorded-deviation.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,2BAA2B,kLAgCtC,CAAC"}