@pjts/eslint-style-rules 0.0.0-stage → 0.0.3

package/dist/rules/message-handler.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rule_1 = require("../lib/rule");
+const ast_1 = require("../lib/ast");
+const db_1 = require("../lib/db");
+const messages_1 = require("../lib/messages");
+/**
+ * A message consumer is an application-layer class:
+ *
+ *   export class SlotCacheInvalidationHandler extends MessageHandlerBase {
+ *     constructor(private readonly cache: SlotCachePort) {
+ *       super([MessageNames.CalendarBooked]);
+ *     }
+ *     protected async handleMessage(event: CalendarBooked): Promise<void> { … }
+ *   }
+ *
+ * - named `…Handler`, in one of `paths` (default `/app/`);
+ * - subscribes with `super([MessageNames.X, …])`; when `handleMessage` switches on the name, every
+ *   subscribed name has a `case` and every `case` is subscribed;
+ * - `handleMessage` is protected and its parameter typed with the message (or a union of them);
+ * - depends only on ports (`…Port`) or application classes imported from the app layer — the
+ *   infrastructure is wired in by the module's `…MessageHandlers` composition root.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'problem',
+        docs: { description: 'Enforce the shape and dependencies of message handlers' },
+        messages: {
+            suffix: 'Message handler "{{name}}" must end with "Handler".',
+            location: 'Message handler "{{name}}" belongs in {{paths}}.',
+            subscription: '"{{name}}" must subscribe with `super([{{enumName}}.…])`.',
+            unhandled: '"{{name}}" subscribes to {{enumName}}.{{message}} but has no `case` for it in handleMessage.',
+            notSubscribed: '`case {{enumName}}.{{message}}` is never delivered — add it to super([...]) or remove the case.',
+            handleMessage: '"{{name}}" must implement `protected async handleMessage(message: <Message type>)`.',
+            untyped: 'Type the handleMessage parameter with the message it handles (or a union of them).',
+            dependency: '"{{name}}" may depend on ports (…Port) or application classes only, not "{{type}}" — wire infrastructure in the …MessageHandlers composition root.',
+        },
+        schema: [{
+                type: 'object',
+                properties: {
+                    bases: { type: 'array', items: { type: 'string' } },
+                    paths: { type: 'array', items: { type: 'string' } },
+                    enumName: { type: 'string' },
+                    dependencyPattern: { type: 'string' },
+                    allowedTypes: { type: 'array', items: { type: 'string' } },
+                },
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const { bases = ['MessageHandlerBase'], paths = ['/app/'], enumName = 'MessageNames', dependencyPattern = 'Port$', allowedTypes = [] } = context.options[0] ?? {};
+        const file = (0, ast_1.filePath)(context);
+        /** local name → import source */
+        const imports = new Map();
+        /** Relative imports inside the app layer, or any path through an `/app/` folder (`@modules/x/app/Y`). */
+        const isAppImport = (source) => !!source && !/infrastructure|\/domain(\/|$)/.test(source) && (source.startsWith('.') || /\/app(\/|$)/.test(source));
+        return {
+            ImportDeclaration(node) {
+                for (const specifier of node.specifiers)
+                    imports.set(specifier.local.name, node.source.value);
+            },
+            ClassDeclaration(node) {
+                if (!bases.includes(node.superClass?.name))
+                    return;
+                const name = node.id?.name ?? '(anonymous)';
+                const at = node.id ?? node;
+                if (!name.endsWith('Handler'))
+                    context.report({ node: at, messageId: 'suffix', data: { name } });
+                if (!paths.some((fragment) => file.includes(fragment)))
+                    context.report({ node: at, messageId: 'location', data: { name, paths: paths.join(' or ') } });
+                const members = node.body.body.filter((member) => member.type === 'MethodDefinition');
+                const constructor = members.find((member) => member.kind === 'constructor');
+                const superCall = constructor?.value.body?.body
+                    .map((statement) => statement.expression)
+                    .find((expression) => expression?.type === 'CallExpression' && expression.callee.type === 'Super');
+                const list = superCall?.arguments[0];
+                const subscribed = list?.type === 'ArrayExpression' ? list.elements.map((element) => (0, messages_1.messageNameOf)(element, enumName)) : [];
+                if (!list || list.type !== 'ArrayExpression' || subscribed.length === 0 || subscribed.some((n) => !n)) {
+                    context.report({ node: superCall ?? constructor?.key ?? at, messageId: 'subscription', data: { name, enumName } });
+                }
+                const handle = members.find((member) => (member.key.name ?? member.key.value) === 'handleMessage');
+                if (!handle || handle.accessibility !== 'protected') {
+                    context.report({ node: handle?.key ?? at, messageId: 'handleMessage', data: { name } });
+                }
+                else {
+                    const param = handle.value.params[0] && (0, db_1.paramBinding)(handle.value.params[0]);
+                    if (!param?.typeAnnotation)
+                        context.report({ node: param ?? handle.key, messageId: 'untyped' });
+                    const handled = (0, messages_1.switchCaseNames)(handle.value.body, enumName);
+                    if (handled.size > 0) {
+                        for (const message of subscribed.filter(Boolean)) {
+                            if (!handled.has(message))
+                                context.report({ node: list, messageId: 'unhandled', data: { name, enumName, message } });
+                        }
+                        for (const message of handled) {
+                            if (!subscribed.includes(message))
+                                context.report({ node: handle.key, messageId: 'notSubscribed', data: { enumName, message } });
+                        }
+                    }
+                }
+                for (const param of constructor?.value.params ?? []) {
+                    const type = (0, db_1.paramBinding)(param).typeAnnotation?.typeAnnotation;
+                    const typeName = type?.type === 'TSTypeReference' && type.typeName.type === 'Identifier' ? type.typeName.name : null;
+                    if (!typeName)
+                        continue;
+                    if (new RegExp(dependencyPattern).test(typeName) || allowedTypes.includes(typeName) || isAppImport(imports.get(typeName)))
+                        continue;
+                    context.report({ node: param, messageId: 'dependency', data: { name, type: typeName } });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=message-handler.js.map

package/dist/rules/message-handler.js.map

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

package/dist/rules/message-name-reference.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Message names are referenced through the enum (`MessageNames.CalendarBooked`), never as string
+ * literals: in a `name:` property, a `case` label of a `switch (x.name)`, or the names a `MessageHandlerBase` subclass
+ * passes to `super([...])`. A literal skips the compiler's check that the message exists.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/message-name-reference.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rule_1 = require("../lib/rule");
+/**
+ * Message names are referenced through the enum (`MessageNames.CalendarBooked`), never as string
+ * literals: in a `name:` property, a `case` label of a `switch (x.name)`, or the names a `MessageHandlerBase` subclass
+ * passes to `super([...])`. A literal skips the compiler's check that the message exists.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'problem',
+        docs: { description: 'Reference message names through the MessageNames enum' },
+        messages: { literal: 'Use {{enumName}}.{{suggestion}} instead of the string \'{{value}}\'.' },
+        schema: [{
+                type: 'object',
+                properties: { enumName: { type: 'string' }, pattern: { type: 'string' }, handlerBases: { type: 'array', items: { type: 'string' } } },
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const { enumName = 'MessageNames', pattern = '^[A-Z][A-Z0-9]*(_[A-Z0-9]+)+$', handlerBases = ['MessageHandlerBase'] } = context.options[0] ?? {};
+        const isName = (node) => node?.type === 'Literal' && typeof node.value === 'string' && new RegExp(pattern).test(node.value);
+        const pascal = (value) => value.toLowerCase().replace(/(^|_)([a-z0-9])/g, (_m, _s, c) => c.toUpperCase());
+        const report = (node) => context.report({ node, messageId: 'literal', data: { enumName, value: node.value, suggestion: pascal(node.value) } });
+        return {
+            'Property[computed=false]'(node) {
+                if ((node.key.name ?? node.key.value) === 'name' && isName(node.value))
+                    report(node.value);
+            },
+            'TSPropertySignature'(node) {
+                // `name: 'CALENDAR_BOOKED'` as a type in a message interface.
+                const type = node.typeAnnotation?.typeAnnotation;
+                if ((node.key.name ?? node.key.value) === 'name' && type?.type === 'TSLiteralType' && isName(type.literal))
+                    report(type.literal);
+            },
+            // Only switches on a message's name — `switch (status) { case 'PART_CAPTURED': … }` is someone else's enum.
+            'SwitchStatement[discriminant.type="MemberExpression"][discriminant.property.name="name"] > SwitchCase'(node) {
+                if (isName(node.test))
+                    report(node.test);
+            },
+            'CallExpression[callee.type="Super"]'(node) {
+                const owner = context.sourceCode.getAncestors(node).reverse().find((a) => a.type === 'ClassDeclaration' || a.type === 'ClassExpression');
+                if (!handlerBases.includes(owner?.superClass?.name))
+                    return;
+                const list = node.arguments[0];
+                if (list?.type === 'ArrayExpression')
+                    list.elements.filter(isName).forEach(report);
+            },
+        };
+    },
+});
+//# sourceMappingURL=message-name-reference.js.map

package/dist/rules/message-name-reference.js.map

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

package/dist/rules/message-names.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The messages barrel (`src/common/messages/index.ts`) keeps three things in step with the message
+ * files next to it: every `MessageNames` key has a `<Key>.ts`, every message file has a key and a
+ * re-export, and every value is the key in SCREAMING_SNAKE_CASE (`CalendarBooked = 'CALENDAR_BOOKED'`).
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/message-names.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const fs_1 = tslib_1.__importDefault(require("fs"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const rule_1 = require("../lib/rule");
+const messages_1 = require("../lib/messages");
+/**
+ * The messages barrel (`src/common/messages/index.ts`) keeps three things in step with the message
+ * files next to it: every `MessageNames` key has a `<Key>.ts`, every message file has a key and a
+ * re-export, and every value is the key in SCREAMING_SNAKE_CASE (`CalendarBooked = 'CALENDAR_BOOKED'`).
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'problem',
+        docs: { description: 'Keep MessageNames, message files and re-exports in step' },
+        messages: {
+            noEnum: 'The messages index must declare `export enum {{enumName}}`.',
+            noFile: '{{enumName}}.{{key}} has no message file "{{key}}.ts".',
+            value: '{{enumName}}.{{key}} must be \'{{expected}}\'.',
+            notInEnum: 'Message file "{{file}}.ts" has no {{enumName}}.{{file}} member.',
+            notExported: 'Message "{{file}}" must be re-exported here (`export { {{file}} } from \'./{{file}}\'`).',
+        },
+        schema: [{
+                type: 'object',
+                properties: { enumName: { type: 'string' }, basePattern: { type: 'string' } },
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const { enumName = 'MessageNames', basePattern = 'Base$' } = context.options[0] ?? {};
+        if (path_1.default.basename(context.filename) !== 'index.ts')
+            return {};
+        const dir = path_1.default.dirname(context.filename);
+        return {
+            Program(program) {
+                const files = fs_1.default.existsSync(dir)
+                    ? fs_1.default.readdirSync(dir)
+                        .filter((file) => /\.ts$/.test(file) && !/\.(d|test)\.ts$/.test(file) && file !== 'index.ts')
+                        .map((file) => file.replace(/\.ts$/, ''))
+                        .filter((name) => !new RegExp(basePattern).test(name))
+                    : [];
+                const enumNode = program.body
+                    .map((statement) => (statement.type === 'ExportNamedDeclaration' ? statement.declaration : statement))
+                    .find((declaration) => declaration?.type === 'TSEnumDeclaration' && declaration.id.name === enumName);
+                if (!enumNode)
+                    return context.report({ node: program, loc: { line: 1, column: 0 }, messageId: 'noEnum', data: { enumName } });
+                const members = enumNode.body?.members ?? enumNode.members;
+                const keys = new Set();
+                for (const member of members) {
+                    const key = member.id.name ?? member.id.value;
+                    keys.add(key);
+                    if (!files.includes(key))
+                        context.report({ node: member.id, messageId: 'noFile', data: { enumName, key } });
+                    const expected = (0, messages_1.screamingSnake)(key);
+                    if (member.initializer?.type !== 'Literal' || member.initializer.value !== expected) {
+                        context.report({ node: member.initializer ?? member, messageId: 'value', data: { enumName, key, expected } });
+                    }
+                }
+                const reExported = new Set();
+                let exportsAll = false;
+                for (const statement of program.body) {
+                    if (statement.type === 'ExportAllDeclaration')
+                        exportsAll = true;
+                    if (statement.type === 'ExportNamedDeclaration' && statement.source) {
+                        for (const specifier of statement.specifiers)
+                            reExported.add(specifier.exported.name ?? specifier.exported.value);
+                    }
+                }
+                for (const file of files) {
+                    if (!keys.has(file))
+                        context.report({ node: enumNode.id, messageId: 'notInEnum', data: { file, enumName } });
+                    if (!exportsAll && !reExported.has(file))
+                        context.report({ node: enumNode.id, messageId: 'notExported', data: { file } });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=message-names.js.map

package/dist/rules/message-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-names.js","sourceRoot":"","sources":["../../src/rules/message-names.ts"],"names":[],"mappings":";;;AAAA,oDAAoB;AACpB,wDAAwB;AACxB,sCAAyC;AACzC,8CAAiD;AAEjD;;;;GAIG;AACH,kBAAe,IAAA,iBAAU,EAAC;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,EAAE,WAAW,EAAE,yDAAyD,EAAE;QAChF,QAAQ,EAAE;YACR,MAAM,EAAE,6DAA6D;YACrE,MAAM,EAAE,wDAAwD;YAChE,KAAK,EAAE,gDAAgD;YACvD,SAAS,EAAE,iEAAiE;YAC5E,WAAW,EAAE,0FAA0F;SACxG;QACD,MAAM,EAAE,CAAC;gBACP,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBAC7E,oBAAoB,EAAE,KAAK;aAC5B,CAAC;KACH;IACD,MAAM,CAAC,OAAO;QACZ,MAAM,EAAE,QAAQ,GAAG,cAAc,EAAE,WAAW,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtF,IAAI,cAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,UAAU;YAAE,OAAO,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE3C,OAAO;YACL,OAAO,CAAC,OAAO;gBACb,MAAM,KAAK,GAAG,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC;oBAC9B,CAAC,CAAC,YAAE,CAAC,WAAW,CAAC,GAAG,CAAC;yBAChB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,UAAU,CAAC;yBAC5F,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;yBACxC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC1D,CAAC,CAAC,EAAE,CAAC;gBAEP,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI;qBAC1B,GAAG,CAAC,CAAC,SAAc,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,KAAK,wBAAwB,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;qBAC1G,IAAI,CAAC,CAAC,WAAgB,EAAE,EAAE,CAAC,WAAW,EAAE,IAAI,KAAK,mBAAmB,IAAI,WAAW,CAAC,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;gBAC7G,IAAI,CAAC,QAAQ;oBAAE,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;gBAE9H,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC;gBAC3D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;gBAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC;oBAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACd,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;wBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;oBAC5G,MAAM,QAAQ,GAAG,IAAA,yBAAc,EAAC,GAAG,CAAC,CAAC;oBACrC,IAAI,MAAM,CAAC,WAAW,EAAE,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;wBACpF,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;oBAChH,CAAC;gBACH,CAAC;gBAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;gBACrC,IAAI,UAAU,GAAG,KAAK,CAAC;gBACvB,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrC,IAAI,SAAS,CAAC,IAAI,KAAK,sBAAsB;wBAAE,UAAU,GAAG,IAAI,CAAC;oBACjE,IAAI,SAAS,CAAC,IAAI,KAAK,wBAAwB,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;wBACpE,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,UAAU;4BAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;oBACpH,CAAC;gBACH,CAAC;gBACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;wBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;oBAC7G,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;wBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC5H,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/module-layout.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Every file of `src/modules/<module>/` sits in the agreed folder layout:
+ *   <module>/<Module>Module.ts, <module>/index.ts (+ `rootFiles`, e.g. <Module>MessageHandlers.ts)
+ *   <module>/{app,domain,infrastructure,testing}/…
+ *   <module>/app/{dto,ports}/… (app-layer classes sit directly in app/; tests next to them)
+ * The `<Module>Module.ts` file additionally checks that the required entries exist on disk.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/module-layout.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const node_fs_1 = tslib_1.__importDefault(require("node:fs"));
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const ast_1 = require("../lib/ast");
+const rule_1 = require("../lib/rule");
+/**
+ * Every file of `src/modules/<module>/` sits in the agreed folder layout:
+ *   <module>/<Module>Module.ts, <module>/index.ts (+ `rootFiles`, e.g. <Module>MessageHandlers.ts)
+ *   <module>/{app,domain,infrastructure,testing}/…
+ *   <module>/app/{dto,ports}/… (app-layer classes sit directly in app/; tests next to them)
+ * The `<Module>Module.ts` file additionally checks that the required entries exist on disk.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'suggestion',
+        docs: { description: 'Enforce the DDD module folder layout' },
+        messages: {
+            rootFile: '"{{file}}" must not sit in the module root — only {{allowed}} live there.',
+            folder: 'Folder "{{folder}}/" is not part of the module layout ({{allowed}}).',
+            subfolder: 'Folder "{{layer}}/{{folder}}/" is not allowed ({{allowed}}).',
+            missing: 'Module "{{module}}" is missing "{{entry}}".',
+        },
+        schema: [{
+                type: 'object',
+                properties: {
+                    folders: { type: 'array', items: { type: 'string' } },
+                    subfolders: { type: 'object', additionalProperties: { type: 'array', items: { type: 'string' } } },
+                    required: { type: 'array', items: { type: 'string' } },
+                    rootFiles: { type: 'array', items: { type: 'string' } },
+                },
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const location = (0, ast_1.moduleLocation)(context);
+        if (!location)
+            return {};
+        const { folders = ['app', 'domain', 'infrastructure', 'testing'], subfolders = { app: ['dto', 'ports'] }, required = ['app', 'index.ts'], 
+        // `{Module}` → the module folder in PascalCase (`catalog-search` → `CatalogSearch`).
+        rootFiles = ['{Module}Module.ts', 'index.ts'], } = context.options[0] ?? {};
+        const { module, rest, root } = location;
+        const moduleFile = `${(0, ast_1.pascalCase)(module)}Module.ts`;
+        return {
+            Program(node) {
+                const report = (messageId, data) => context.report({ node, loc: { line: 1, column: 0 }, messageId, data });
+                if (rest.length === 1) {
+                    const allowedRoot = rootFiles.map((pattern) => pattern.split('{Module}').join((0, ast_1.pascalCase)(module)));
+                    if (rest[0] === moduleFile) {
+                        for (const entry of required) {
+                            if (!node_fs_1.default.existsSync(node_path_1.default.join(root, entry)))
+                                report('missing', { module, entry });
+                        }
+                    }
+                    else if (!allowedRoot.includes(rest[0])) {
+                        report('rootFile', { file: rest[0], allowed: allowedRoot.join(', ') });
+                    }
+                    return;
+                }
+                const [layer, folder] = rest;
+                if (!folders.includes(layer))
+                    return report('folder', { folder: layer, allowed: folders.join(', ') });
+                if (rest.length > 2 && subfolders[layer] && !subfolders[layer].includes(folder)) {
+                    report('subfolder', { layer, folder, allowed: subfolders[layer].join(', ') });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=module-layout.js.map

package/dist/rules/module-layout.js.map

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

package/dist/rules/module-service-getters.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A module class exposes application-layer classes — and only those — through public getters named
+ * after them in camelCase:
+ *
+ *   import { ServiceOfferPublicView } from './app/ServiceOfferPublicView';
+ *
+ *   public get serviceOfferPublicView() {
+ *     return new ServiceOfferPublicView(this.serviceOfferRepo);
+ *   }
+ *
+ * Two directions are checked:
+ * - every public getter returns `new X(...)` where X is a value imported from the module's own
+ *   `./app/…` (not `./app/dto` or `./app/ports`), and is named X with a lower-case first letter;
+ * - every `new X(...)` of an app use-case class (suffix `Service` | `View` | `Handler`) sits in a public,
+ *   non-static getter. Internal app helpers (notifiers, runners) may be built in the constructor for
+ *   wiring — they just can't be exposed.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/module-service-getters.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rule_1 = require("../lib/rule");
+const ast_1 = require("../lib/ast");
+/**
+ * A module class exposes application-layer classes — and only those — through public getters named
+ * after them in camelCase:
+ *
+ *   import { ServiceOfferPublicView } from './app/ServiceOfferPublicView';
+ *
+ *   public get serviceOfferPublicView() {
+ *     return new ServiceOfferPublicView(this.serviceOfferRepo);
+ *   }
+ *
+ * Two directions are checked:
+ * - every public getter returns `new X(...)` where X is a value imported from the module's own
+ *   `./app/…` (not `./app/dto` or `./app/ports`), and is named X with a lower-case first letter;
+ * - every `new X(...)` of an app use-case class (suffix `Service` | `View` | `Handler`) sits in a public,
+ *   non-static getter. Internal app helpers (notifiers, runners) may be built in the constructor for
+ *   wiring — they just can't be exposed.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'suggestion',
+        docs: { description: 'Modules expose only their own app-layer classes, through camelCase getters' },
+        messages: {
+            notGetter: '"{{name}}" must be exposed through `public get {{getter}}()`, not constructed in {{where}}.',
+            name: 'Getter returning {{name}} must be named `{{getter}}`, not `{{actual}}`.',
+            visibility: 'Getter `{{getter}}` must be public and non-static.',
+            notApp: 'Module getter `{{getter}}` may only return `new <AppClass>(...)` of a class imported from ./app/ — {{what}}.',
+        },
+        schema: [{
+                type: 'object',
+                properties: { suffixes: { type: 'array', items: { type: 'string' }, minItems: 1 } },
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const suffixes = context.options[0]?.suffixes ?? ['Service', 'View', 'Handler'];
+        /** local name → import source, for value imports of the file. */
+        const imports = new Map();
+        const isAppSource = (source) => /^\.\/app(\/|$)/.test(source) && !/^\.\/app\/(dto|ports)(\/|$)/.test(source);
+        const isAppClass = (name) => isAppSource(imports.get(name) ?? '');
+        const camel = (name) => name[0].toLowerCase() + name.slice(1);
+        const isModuleClass = (classNode) => /Module$/.test(classNode?.id?.name ?? '');
+        const describe = (member) => {
+            if (member.type === 'MethodDefinition')
+                return member.kind === 'constructor' ? 'the constructor' : `method \`${member.key.name}\``;
+            return `field \`${member.key.name}\``;
+        };
+        /** What a getter returns, in words, when it isn't an app class. */
+        const describeReturn = (argument) => {
+            if (!argument)
+                return 'it returns nothing';
+            if (argument.type === 'NewExpression' && argument.callee.type === 'Identifier') {
+                const source = imports.get(argument.callee.name);
+                return source ? `${argument.callee.name} comes from '${source}'` : `${argument.callee.name} is not imported from ./app/`;
+            }
+            return `it returns ${context.sourceCode.getText(argument).slice(0, 40)}`;
+        };
+        return {
+            ImportDeclaration(node) {
+                if (node.importKind === 'type')
+                    return;
+                for (const specifier of node.specifiers) {
+                    if (specifier.importKind !== 'type')
+                        imports.set(specifier.local.name, node.source.value);
+                }
+            },
+            // Getters: only app classes, under the right name.
+            'MethodDefinition[kind="get"]'(getterNode) {
+                if (!isModuleClass(getterNode.parent.parent))
+                    return;
+                if (getterNode.static || getterNode.accessibility === 'private' || getterNode.accessibility === 'protected')
+                    return;
+                const getter = getterNode.key.name ?? getterNode.key.value;
+                const returns = [];
+                const collect = (node) => {
+                    if (!node || typeof node.type !== 'string')
+                        return;
+                    if (node.type === 'ReturnStatement') {
+                        returns.push(node);
+                        return;
+                    }
+                    // Returns inside nested functions belong to those functions.
+                    if (/Function/.test(node.type))
+                        return;
+                    for (const key of Object.keys(node)) {
+                        if (key === 'parent')
+                            continue;
+                        const value = node[key];
+                        if (Array.isArray(value))
+                            value.forEach(collect);
+                        else if (value && typeof value === 'object')
+                            collect(value);
+                    }
+                };
+                getterNode.value.body.body.forEach(collect);
+                if (returns.length === 0) {
+                    context.report({ node: getterNode.key, messageId: 'notApp', data: { getter, what: 'it returns nothing' } });
+                }
+                for (const statement of returns) {
+                    const argument = statement.argument;
+                    const name = argument?.type === 'NewExpression' && argument.callee.type === 'Identifier' ? argument.callee.name : null;
+                    if (!name || !isAppClass(name)) {
+                        context.report({ node: statement, messageId: 'notApp', data: { getter, what: describeReturn(argument) } });
+                    }
+                    else if (getter !== camel(name)) {
+                        context.report({ node: getterNode.key, messageId: 'name', data: { name, getter: camel(name), actual: getter } });
+                    }
+                }
+            },
+            // App use-case classes: only constructed inside public getters.
+            'NewExpression[callee.type="Identifier"]'(node) {
+                const name = node.callee.name;
+                if (!isAppClass(name) || !suffixes.some((suffix) => name.endsWith(suffix)))
+                    return;
+                const ancestors = context.sourceCode.getAncestors(node);
+                const member = (0, ast_1.findLast)(ancestors, (a) => a.type === 'MethodDefinition' || a.type === 'PropertyDefinition');
+                if (!member || !isModuleClass(member.parent.parent))
+                    return;
+                if (member.type !== 'MethodDefinition' || member.kind !== 'get') {
+                    context.report({ node, messageId: 'notGetter', data: { name, getter: camel(name), where: describe(member) } });
+                }
+                else if (member.static || member.accessibility === 'private' || member.accessibility === 'protected') {
+                    context.report({ node: member.key, messageId: 'visibility', data: { getter: camel(name) } });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=module-service-getters.js.map

package/dist/rules/module-service-getters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-service-getters.js","sourceRoot":"","sources":["../../src/rules/module-service-getters.ts"],"names":[],"mappings":";;AAAA,sCAAyC;AACzC,oCAAsC;AACtC;;;;;;;;;;;;;;;;GAgBG;AACH,kBAAe,IAAA,iBAAU,EAAC;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,EAAE,WAAW,EAAE,4EAA4E,EAAE;QACnG,QAAQ,EAAE;YACR,SAAS,EAAE,6FAA6F;YACxG,IAAI,EAAE,yEAAyE;YAC/E,UAAU,EAAE,oDAAoD;YAChE,MAAM,EAAE,8GAA8G;SACvH;QACD,MAAM,EAAE,CAAC;gBACP,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE;gBACnF,oBAAoB,EAAE,KAAK;aAC5B,CAAC;KACH;IACD,MAAM,CAAC,OAAO;QACZ,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAChF,iEAAiE;QACjE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7G,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAE/E,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,EAAE;YAC1B,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB;gBAAE,OAAO,MAAM,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;YACnI,OAAO,WAAW,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QACxC,CAAC,CAAC;QAEF,mEAAmE;QACnE,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,EAAE;YAClC,IAAI,CAAC,QAAQ;gBAAE,OAAO,oBAAoB,CAAC;YAC3C,IAAI,QAAQ,CAAC,IAAI,KAAK,eAAe,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC/E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACjD,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,gBAAgB,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,8BAA8B,CAAC;YAC3H,CAAC;YACD,OAAO,cAAc,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC3E,CAAC,CAAC;QAEF,OAAO;YACL,iBAAiB,CAAC,IAAI;gBACpB,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM;oBAAE,OAAO;gBACvC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACxC,IAAI,SAAS,CAAC,UAAU,KAAK,MAAM;wBAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5F,CAAC;YACH,CAAC;YAED,mDAAmD;YACnD,8BAA8B,CAAC,UAAU;gBACvC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC;oBAAE,OAAO;gBACrD,IAAI,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,aAAa,KAAK,SAAS,IAAI,UAAU,CAAC,aAAa,KAAK,WAAW;oBAAE,OAAO;gBACpH,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;gBAE3D,MAAM,OAAO,GAAU,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,CAAC,IAAI,EAAQ,EAAE;oBAC7B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;wBAAE,OAAO;oBACnD,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;wBACpC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBACnB,OAAO;oBACT,CAAC;oBACD,6DAA6D;oBAC7D,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;wBAAE,OAAO;oBACvC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;wBACpC,IAAI,GAAG,KAAK,QAAQ;4BAAE,SAAS;wBAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;wBACxB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;4BAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;6BAC5C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;4BAAE,OAAO,CAAC,KAAK,CAAC,CAAC;oBAC9D,CAAC;gBACH,CAAC,CAAC;gBACF,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAC;gBAC9G,CAAC;gBAED,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;oBAChC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;oBACpC,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,KAAK,eAAe,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;oBACvH,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC/B,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7G,CAAC;yBAAM,IAAI,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;wBAClC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;oBACnH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,gEAAgE;YAChE,yCAAyC,CAAC,IAAI;gBAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC9B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAAE,OAAO;gBACnF,MAAM,SAAS,GAAI,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAW,CAAC;gBACnE,MAAM,MAAM,GAAG,IAAA,cAAQ,EAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC;gBAC5G,IAAI,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;oBAAE,OAAO;gBAC5D,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;oBAChE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjH,CAAC;qBAAM,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,MAAM,CAAC,aAAa,KAAK,WAAW,EAAE,CAAC;oBACvG,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/F,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/no-async-in-domain.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;