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

package/dist/rules/no-async-in-domain.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rule_1 = require("../lib/rule");
+/**
+ * The domain layer is pure and synchronous — I/O and awaiting belong to the app layer.
+ *
+ * The one exception is password hashing from the modules in `allowedModules` (default `bcrypt`),
+ * which only exists asynchronously:
+ *
+ *   public async verify(plain: string): Promise<boolean> {
+ *     return bcrypt.compare(plain, this.hash);
+ *   }
+ *
+ * An `await` is allowed only on such a call; an `async` function only when it awaits or returns
+ * such a call and awaits nothing else; a `Promise<…>` type only as the return type of a function
+ * that qualifies (async or returning such a call directly).
+ */
+const FUNCTIONS = new Set(['FunctionDeclaration', 'FunctionExpression', 'ArrowFunctionExpression']);
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'problem',
+        docs: { description: 'Forbid async code in the domain layer, except bcrypt' },
+        messages: { async: 'Domain layer must be synchronous — move {{what}} to the app layer{{exception}}.' },
+        schema: [{
+                type: 'object',
+                properties: { allowedModules: { type: 'array', items: { type: 'string' } } },
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const allowedModules = context.options[0]?.allowedModules ?? ['bcrypt'];
+        const exception = allowedModules.length ? ` (only ${allowedModules.join(', ')} calls may be awaited)` : '';
+        /** `bcrypt` (default/namespace import) → call as `bcrypt.x()`; `compare` (named) → call as `compare()`. */
+        const namespaces = new Set();
+        const functions = new Set();
+        const isAllowedCall = (node) => {
+            if (node?.type !== 'CallExpression')
+                return false;
+            const callee = node.callee;
+            if (callee.type === 'Identifier')
+                return functions.has(callee.name);
+            return callee.type === 'MemberExpression' && callee.object.type === 'Identifier' && namespaces.has(callee.object.name);
+        };
+        /** Per-function bookkeeping, innermost last. */
+        const stack = [];
+        const report = (node, what) => context.report({ node, messageId: 'async', data: { what, exception } });
+        const enter = (fn) => {
+            const frame = { fn, allowedAwaits: 0, otherAwaits: 0, allowedReturns: 0, otherReturns: 0 };
+            // `async () => bcrypt.hash(x)` — an expression body is its return.
+            if (fn.type === 'ArrowFunctionExpression' && fn.expression) {
+                if (isAllowedCall(fn.body) || (fn.body.type === 'AwaitExpression' && isAllowedCall(fn.body.argument)))
+                    frame.allowedReturns++;
+                else
+                    frame.otherReturns++;
+            }
+            stack.push(frame);
+        };
+        const exit = (fn) => {
+            const frame = stack.pop();
+            const usesAllowed = frame.allowedAwaits + frame.allowedReturns > 0;
+            const qualifies = usesAllowed && frame.otherAwaits === 0;
+            if (fn.async && !qualifies)
+                report(fn, 'the async function');
+            const returnType = fn.returnType?.typeAnnotation;
+            const returnsPromise = returnType?.type === 'TSTypeReference' && returnType.typeName.name === 'Promise';
+            // A non-async function may return a Promise only when every return hands back an allowed call.
+            const passesThrough = !fn.async && frame.allowedReturns > 0 && frame.otherReturns === 0;
+            if (returnsPromise && !(fn.async ? qualifies : passesThrough))
+                report(returnType, 'the Promise');
+        };
+        return {
+            ImportDeclaration(node) {
+                if (!allowedModules.includes(node.source.value))
+                    return;
+                for (const specifier of node.specifiers) {
+                    if (specifier.type === 'ImportSpecifier')
+                        functions.add(specifier.local.name);
+                    else
+                        namespaces.add(specifier.local.name);
+                }
+            },
+            ':function': enter,
+            ':function:exit': exit,
+            AwaitExpression(node) {
+                const frame = stack[stack.length - 1];
+                if (isAllowedCall(node.argument)) {
+                    if (frame)
+                        frame.allowedAwaits++;
+                    return;
+                }
+                if (frame)
+                    frame.otherAwaits++;
+                report(node, 'the await');
+            },
+            ReturnStatement(node) {
+                const frame = stack[stack.length - 1];
+                if (!frame || !node.argument)
+                    return;
+                const value = node.argument.type === 'AwaitExpression' ? node.argument.argument : node.argument;
+                if (isAllowedCall(value))
+                    frame.allowedReturns++;
+                else
+                    frame.otherReturns++;
+            },
+            // Promise types anywhere except a function's own return type (judged on exit above).
+            'TSTypeReference[typeName.name="Promise"]'(node) {
+                const parent = node.parent; // TSTypeAnnotation
+                const owner = parent?.parent;
+                const isReturnType = parent?.type === 'TSTypeAnnotation' && FUNCTIONS.has(owner?.type) && owner.returnType === parent;
+                if (!isReturnType)
+                    report(node, 'the Promise');
+            },
+        };
+    },
+});
+//# sourceMappingURL=no-async-in-domain.js.map

package/dist/rules/no-async-in-domain.js.map

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

package/dist/rules/no-duplicate-sdk-types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * the frontend imports wire types from the generated SDK (`api/client/types.d.ts`)
+ * instead of re-declaring them. Matches by name, so a renamed hand-written mirror slips through.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/no-duplicate-sdk-types.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const node_fs_1 = tslib_1.__importDefault(require("node:fs"));
+const rule_1 = require("../lib/rule");
+/** typesFile → Set of type names it declares (per lint run). */
+const sdkNames = new Map();
+const namesIn = (typesFile) => {
+    if (!sdkNames.has(typesFile)) {
+        const source = node_fs_1.default.readFileSync(typesFile, 'utf8');
+        sdkNames.set(typesFile, new Set([...source.matchAll(/\b(?:interface|type|enum)\s+([A-Z]\w*)/g)].map((match) => match[1])));
+    }
+    return sdkNames.get(typesFile);
+};
+/**
+ * the frontend imports wire types from the generated SDK (`api/client/types.d.ts`)
+ * instead of re-declaring them. Matches by name, so a renamed hand-written mirror slips through.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'problem',
+        docs: { description: 'Forbid re-declaring types that exist in the generated SDK' },
+        messages: { duplicate: '"{{name}}" already exists in the generated SDK — import it from api/client/types.' },
+        schema: [{
+                type: 'object',
+                properties: { typesFile: { type: 'string' } },
+                required: ['typesFile'],
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const names = namesIn(context.options[0].typesFile);
+        const check = (node) => {
+            if (names.has(node.id.name))
+                context.report({ node: node.id, messageId: 'duplicate', data: { name: node.id.name } });
+        };
+        return { TSInterfaceDeclaration: check, TSTypeAliasDeclaration: check, TSEnumDeclaration: check };
+    },
+});
+//# sourceMappingURL=no-duplicate-sdk-types.js.map

package/dist/rules/no-duplicate-sdk-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-duplicate-sdk-types.js","sourceRoot":"","sources":["../../src/rules/no-duplicate-sdk-types.ts"],"names":[],"mappings":";;;AAAA,8DAAyB;AACzB,sCAAyC;AAEzC,gEAAgE;AAChE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;AAE3B,MAAM,OAAO,GAAG,CAAC,SAAS,EAAE,EAAE;IAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,iBAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAClD,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,yCAAyC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7H,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF;;;GAGG;AACH,kBAAe,IAAA,iBAAU,EAAC;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,EAAE,WAAW,EAAE,2DAA2D,EAAE;QAClF,QAAQ,EAAE,EAAE,SAAS,EAAE,mFAAmF,EAAE;QAC5G,MAAM,EAAE,CAAC;gBACP,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBAC7C,QAAQ,EAAE,CAAC,WAAW,CAAC;gBACvB,oBAAoB,EAAE,KAAK;aAC5B,CAAC;KACH;IACD,MAAM,CAAC,OAAO;QACZ,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,EAAE;YACrB,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvH,CAAC,CAAC;QACF,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;IACpG,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/no-entity-assembly-in-app.d.ts

@@ -0,0 +1,7 @@
+/**
+ * the app layer must not map DTOs into entities field by field; the entity's static
+ * `fromDTO(...)` owns that. Flags `new Entity({...})` and `Entity.create({...})` for any value
+ * imported from a module's `domain/` (value objects in `domain/values` are exempt).
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/no-entity-assembly-in-app.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rule_1 = require("../lib/rule");
+/**
+ * the app layer must not map DTOs into entities field by field; the entity's static
+ * `fromDTO(...)` owns that. Flags `new Entity({...})` and `Entity.create({...})` for any value
+ * imported from a module's `domain/` (value objects in `domain/values` are exempt).
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'suggestion',
+        docs: { description: 'Forbid assembling domain entities from object literals in the app layer' },
+        messages: { assemble: 'Don\'t assemble "{{name}}" from an object literal here — move the mapping into {{name}}.fromDTO(...).' },
+        schema: [],
+    },
+    create(context) {
+        const entities = new Set();
+        const isEntityImport = (source) => /(^|\/)domain(\/|$)/.test(source) && !/\/domain\/values(\/|$)/.test(source);
+        const check = (call, name) => {
+            if (entities.has(name))
+                context.report({ node: call, messageId: 'assemble', data: { name } });
+        };
+        return {
+            ImportDeclaration(node) {
+                if (node.importKind === 'type' || !isEntityImport(node.source.value))
+                    return;
+                for (const specifier of node.specifiers) {
+                    if (specifier.importKind !== 'type' && !/Error$/.test(specifier.local.name))
+                        entities.add(specifier.local.name);
+                }
+            },
+            'NewExpression[callee.type="Identifier"][arguments.0.type="ObjectExpression"]': (node) => check(node, node.callee.name),
+            'CallExpression[callee.property.name="create"][callee.object.type="Identifier"][arguments.0.type="ObjectExpression"]': (node) => check(node, node.callee.object.name),
+        };
+    },
+});
+//# sourceMappingURL=no-entity-assembly-in-app.js.map

package/dist/rules/no-entity-assembly-in-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-entity-assembly-in-app.js","sourceRoot":"","sources":["../../src/rules/no-entity-assembly-in-app.ts"],"names":[],"mappings":";;AAAA,sCAAyC;AACzC;;;;GAIG;AACH,kBAAe,IAAA,iBAAU,EAAC;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,EAAE,WAAW,EAAE,yEAAyE,EAAE;QAChG,QAAQ,EAAE,EAAE,QAAQ,EAAE,uGAAuG,EAAE;QAC/H,MAAM,EAAE,EAAE;KACX;IACD,MAAM,CAAC,OAAO;QACZ,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC3B,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/G,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;YAC3B,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAChG,CAAC,CAAC;QACF,OAAO;YACL,iBAAiB,CAAC,IAAI;gBACpB,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;oBAAE,OAAO;gBAC7E,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACxC,IAAI,SAAS,CAAC,UAAU,KAAK,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;wBAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClH,CAAC;YACH,CAAC;YACD,8EAA8E,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACvH,qHAAqH,EAAE,CAAC,IAAI,EAAE,EAAE,CAC9H,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;SACvC,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/no-entity-mutation-outside-domain.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Outside the domain, a loaded entity changes only through its own methods (`config.update(dto)`),
+ * never by assigning its fields (`config.billingCycle = dto.billingCycle`). Field writes skip the
+ * domain's invariants and, on @trackable / event-sourced aggregates, the events those methods emit.
+ *
+ * "Loaded entity" = a variable initialised from an awaited lookup on the service itself:
+ * `await this.findOne(…)`, `await this.<repository>.find…(…)` / `.get…(…)` / `.load…(…)`.
+ * Local accumulators and response objects are left alone.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/no-entity-mutation-outside-domain.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rule_1 = require("../lib/rule");
+/**
+ * Outside the domain, a loaded entity changes only through its own methods (`config.update(dto)`),
+ * never by assigning its fields (`config.billingCycle = dto.billingCycle`). Field writes skip the
+ * domain's invariants and, on @trackable / event-sourced aggregates, the events those methods emit.
+ *
+ * "Loaded entity" = a variable initialised from an awaited lookup on the service itself:
+ * `await this.findOne(…)`, `await this.<repository>.find…(…)` / `.get…(…)` / `.load…(…)`.
+ * Local accumulators and response objects are left alone.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'suggestion',
+        docs: { description: 'Change loaded entities through domain methods only' },
+        messages: { mutation: '"{{variable}}" is a loaded entity — change it through a domain method (e.g. `{{variable}}.update(dto)`), not `{{variable}}.{{property}} = …`.' },
+        schema: [{
+                type: 'object',
+                properties: { loaderPattern: { type: 'string' } },
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const loader = new RegExp(context.options[0]?.loaderPattern ?? '^(findOne|find|get|load|require)');
+        const entities = new Set(); // scope variables
+        const isLoad = (init) => {
+            const call = init?.type === 'AwaitExpression' ? init.argument : null;
+            if (call?.type !== 'CallExpression' || call.callee.type !== 'MemberExpression')
+                return false;
+            const method = call.callee.property.name ?? '';
+            const target = call.callee.object;
+            // this.findOne(...) or this.<repo>.find...(...)
+            const onThis = target.type === 'ThisExpression' || (target.type === 'MemberExpression' && target.object.type === 'ThisExpression');
+            return onThis && loader.test(method);
+        };
+        const variableOf = (node, identifier) => {
+            let scope = context.sourceCode.getScope(node);
+            while (scope) {
+                const variable = scope.set.get(identifier.name);
+                if (variable)
+                    return variable;
+                scope = scope.upper;
+            }
+            return null;
+        };
+        const check = (node, target) => {
+            if (target?.type !== 'MemberExpression' || target.computed || target.object.type !== 'Identifier')
+                return;
+            const variable = variableOf(node, target.object);
+            if (variable && entities.has(variable)) {
+                context.report({ node, messageId: 'mutation', data: { variable: target.object.name, property: target.property.name } });
+            }
+        };
+        return {
+            VariableDeclarator(node) {
+                if (node.id.type === 'Identifier' && isLoad(node.init)) {
+                    const variable = variableOf(node, node.id);
+                    if (variable)
+                        entities.add(variable);
+                }
+            },
+            AssignmentExpression: (node) => check(node, node.left),
+            UpdateExpression: (node) => check(node, node.argument),
+        };
+    },
+});
+//# sourceMappingURL=no-entity-mutation-outside-domain.js.map

package/dist/rules/no-entity-mutation-outside-domain.js.map

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

package/dist/rules/no-message-construction-outside-domain.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Message (event) bodies are built by the domain — an aggregate method returns or emits them:
+ *
+ *   // domain
+ *   public changed(actorId: string): ServiceOfferChanged {
+ *     return { uuid: v4(), timestamp: new Date(), name: MessageNames.ServiceOfferChanged, aggregateId: …, actorId, therapistId: … };
+ *   }
+ *   // app
+ *   await this.messagePublisher.publish(offering.changed(authToken.userId));
+ *
+ * An object literal pinning `name: MessageNames.X` anywhere outside `allowedPaths` (default `/domain/`)
+ * is a message constructed in the wrong layer.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/no-message-construction-outside-domain.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rule_1 = require("../lib/rule");
+const ast_1 = require("../lib/ast");
+const messages_1 = require("../lib/messages");
+/**
+ * Message (event) bodies are built by the domain — an aggregate method returns or emits them:
+ *
+ *   // domain
+ *   public changed(actorId: string): ServiceOfferChanged {
+ *     return { uuid: v4(), timestamp: new Date(), name: MessageNames.ServiceOfferChanged, aggregateId: …, actorId, therapistId: … };
+ *   }
+ *   // app
+ *   await this.messagePublisher.publish(offering.changed(authToken.userId));
+ *
+ * An object literal pinning `name: MessageNames.X` anywhere outside `allowedPaths` (default `/domain/`)
+ * is a message constructed in the wrong layer.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'problem',
+        docs: { description: 'Construct message bodies only in the domain layer' },
+        messages: {
+            construct: '{{enumName}}.{{message}} is built here — the domain returns or emits message bodies; call the aggregate method that produces it.',
+        },
+        schema: [{
+                type: 'object',
+                properties: { allowedPaths: { type: 'array', items: { type: 'string' } }, enumName: { type: 'string' } },
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const { allowedPaths = ['/domain/'], enumName = 'MessageNames' } = context.options[0] ?? {};
+        if (allowedPaths.some((fragment) => (0, ast_1.filePath)(context).includes(fragment)))
+            return {};
+        return {
+            ObjectExpression(node) {
+                const property = (0, messages_1.nameProperty)(node, enumName);
+                if (property?.name)
+                    context.report({ node, messageId: 'construct', data: { enumName, message: property.name } });
+            },
+        };
+    },
+});
+//# sourceMappingURL=no-message-construction-outside-domain.js.map

package/dist/rules/no-message-construction-outside-domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-message-construction-outside-domain.js","sourceRoot":"","sources":["../../src/rules/no-message-construction-outside-domain.ts"],"names":[],"mappings":";;AAAA,sCAAyC;AACzC,oCAAsC;AACtC,8CAA+C;AAE/C;;;;;;;;;;;;GAYG;AACH,kBAAe,IAAA,iBAAU,EAAC;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,EAAE,WAAW,EAAE,mDAAmD,EAAE;QAC1E,QAAQ,EAAE;YACR,SAAS,EAAE,kIAAkI;SAC9I;QACD,MAAM,EAAE,CAAC;gBACP,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBACxG,oBAAoB,EAAE,KAAK;aAC5B,CAAC;KACH;IACD,MAAM,CAAC,OAAO;QACZ,MAAM,EAAE,YAAY,GAAG,CAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5F,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,QAAgB,EAAE,EAAE,CAAC,IAAA,cAAQ,EAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAC7F,OAAO;YACL,gBAAgB,CAAC,IAAI;gBACnB,MAAM,QAAQ,GAAG,IAAA,uBAAY,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC9C,IAAI,QAAQ,EAAE,IAAI;oBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACnH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/no-reconstitute.d.ts

@@ -0,0 +1,3 @@
+/** entities have no `reconstitute`; repositories deserialize, services call `existing.update()`. */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/no-reconstitute.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rule_1 = require("../lib/rule");
+/** entities have no `reconstitute`; repositories deserialize, services call `existing.update()`. */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'suggestion',
+        docs: { description: 'Forbid defining or calling `reconstitute`' },
+        messages: {
+            definition: 'Entities must not have `reconstitute` — the repository deserializes into the constructor.',
+            call: 'Don\'t rebuild entities with `reconstitute` — fetch, call `existing.update(dto)`, save.',
+        },
+        schema: [],
+    },
+    create(context) {
+        return {
+            'MethodDefinition[key.name="reconstitute"]': (node) => context.report({ node: node.key, messageId: 'definition' }),
+            'CallExpression[callee.property.name="reconstitute"]': (node) => context.report({ node, messageId: 'call' }),
+        };
+    },
+});
+//# sourceMappingURL=no-reconstitute.js.map

package/dist/rules/no-reconstitute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-reconstitute.js","sourceRoot":"","sources":["../../src/rules/no-reconstitute.ts"],"names":[],"mappings":";;AAAA,sCAAyC;AACzC,oGAAoG;AACpG,kBAAe,IAAA,iBAAU,EAAC;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,EAAE,WAAW,EAAE,2CAA2C,EAAE;QAClE,QAAQ,EAAE;YACR,UAAU,EAAE,2FAA2F;YACvG,IAAI,EAAE,yFAAyF;SAChG;QACD,MAAM,EAAE,EAAE;KACX;IACD,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,2CAA2C,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;YAClH,qDAAqD,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;SAC7G,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/port-file.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Ports live one per file in `src/modules/<module>/app/ports/<Name>Port.ts`, each declared as an
+ * exported interface named exactly like the file. Supporting types (DTO-ish interfaces the port
+ * signature uses) may sit next to it; runtime code (classes, functions, values) may not — that is an
+ * adapter. `index.ts` barrels in `app/ports/` are allowed. Outside `app/ports/`, nothing may declare
+ * a `…Port` type.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/port-file.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const ast_1 = require("../lib/ast");
+const rule_1 = require("../lib/rule");
+const PORT_NAME = /Port$/;
+const TYPE_ONLY = new Set(['TSInterfaceDeclaration', 'TSTypeAliasDeclaration', 'ImportDeclaration', 'ExportAllDeclaration']);
+/** The declaration behind a top-level statement (`export interface X` → `interface X`). */
+const declarationOf = (statement) => statement.type === 'ExportNamedDeclaration' || statement.type === 'ExportDefaultDeclaration' ? statement.declaration : statement;
+/**
+ * Ports live one per file in `src/modules/<module>/app/ports/<Name>Port.ts`, each declared as an
+ * exported interface named exactly like the file. Supporting types (DTO-ish interfaces the port
+ * signature uses) may sit next to it; runtime code (classes, functions, values) may not — that is an
+ * adapter. `index.ts` barrels in `app/ports/` are allowed. Outside `app/ports/`, nothing may declare
+ * a `…Port` type.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'suggestion',
+        docs: { description: 'Enforce the location, shape and naming of port files' },
+        messages: {
+            fileName: 'Port files are named "<Name>Port.ts" — "{{file}}.ts" is not.',
+            missing: '"{{file}}.ts" must declare `export interface {{file}}`.',
+            notInterface: 'Port "{{name}}" must be an interface, not a {{kind}}.',
+            notExported: 'Port "{{name}}" must be exported.',
+            onePerFile: 'Port "{{name}}" must live in its own file app/ports/{{name}}.ts (one port per file).',
+            runtime: 'Port files contain only types — move this {{kind}} to infrastructure/ (it is an adapter).',
+            location: 'Port "{{name}}" must be declared in src/modules/<module>/app/ports/{{name}}.ts.',
+        },
+        schema: [],
+    },
+    create(context) {
+        const location = (0, ast_1.moduleLocation)(context);
+        const inPorts = location?.rest[0] === 'app' && location.rest[1] === 'ports' && location.rest.length === 3;
+        const file = node_path_1.default.basename(context.filename).replace(/\.ts$/, '');
+        if (!inPorts) {
+            // Anywhere else: a `…Port` declaration is a port in the wrong place.
+            const report = (node) => {
+                if (node.id && PORT_NAME.test(node.id.name))
+                    context.report({ node: node.id, messageId: 'location', data: { name: node.id.name } });
+            };
+            return { TSInterfaceDeclaration: report, TSTypeAliasDeclaration: report, ClassDeclaration: report };
+        }
+        if (file === 'index')
+            return {};
+        return {
+            Program(program) {
+                if (!PORT_NAME.test(file)) {
+                    context.report({ node: program, loc: { line: 1, column: 0 }, messageId: 'fileName', data: { file } });
+                }
+                let found = false;
+                for (const statement of program.body) {
+                    const declaration = declarationOf(statement);
+                    const exported = declaration !== statement;
+                    // Re-exports (`export { X } from …`, `export type { X }`) carry no declaration of their own.
+                    if (!declaration)
+                        continue;
+                    if (!TYPE_ONLY.has(declaration.type) && declaration.type !== 'TSModuleDeclaration') {
+                        const kind = { ClassDeclaration: 'class', FunctionDeclaration: 'function', VariableDeclaration: 'value', TSEnumDeclaration: 'enum' }[declaration.type] ?? 'statement';
+                        if (declaration.id?.name === file) {
+                            // `export abstract class XPort` — the port itself, declared with the wrong construct.
+                            found = true;
+                            context.report({ node: declaration.id, messageId: 'notInterface', data: { name: file, kind } });
+                        }
+                        else {
+                            context.report({ node: declaration, messageId: 'runtime', data: { kind } });
+                        }
+                        continue;
+                    }
+                    const name = declaration.id?.name;
+                    if (!name)
+                        continue;
+                    if (name === file) {
+                        found = true;
+                        if (declaration.type !== 'TSInterfaceDeclaration') {
+                            context.report({ node: declaration.id, messageId: 'notInterface', data: { name, kind: 'type alias' } });
+                        }
+                        else if (!exported) {
+                            context.report({ node: declaration.id, messageId: 'notExported', data: { name } });
+                        }
+                    }
+                    else if (PORT_NAME.test(name)) {
+                        context.report({ node: declaration.id, messageId: 'onePerFile', data: { name } });
+                    }
+                }
+                if (!found && PORT_NAME.test(file)) {
+                    context.report({ node: program, loc: { line: 1, column: 0 }, messageId: 'missing', data: { file } });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=port-file.js.map

package/dist/rules/port-file.js.map

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

package/dist/rules/port-has-adapters.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Every `<X>RepositoryPort` declared in `app/ports/` has at least one implementation in the module's
+ * `infrastructure/`: a class that `implements` the port, or a prefixed `…<X>Repository`
+ * (`PgXRepository`, `PgNatsXRepository`, `InMemoryXRepository`, …). Which prefix is right for its
+ * folder is `repository-naming`'s job.
+ * Reads sibling files, so editors only re-check it when the port file itself is re-linted.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/port-has-adapters.js

@@ -0,0 +1,62 @@
+"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");
+/** infrastructure dir → [{ name, implements: Set<string> }] for every class declared in it (per lint run). */
+const infrastructureClasses = new Map();
+const classesIn = (dir) => {
+    if (!infrastructureClasses.has(dir)) {
+        const classes = [];
+        const walk = (current) => {
+            if (!node_fs_1.default.existsSync(current))
+                return;
+            for (const entry of node_fs_1.default.readdirSync(current, { withFileTypes: true })) {
+                const full = node_path_1.default.join(current, entry.name);
+                if (entry.isDirectory())
+                    walk(full);
+                else if (/\.ts$/.test(entry.name) && !/\.test\.ts$/.test(entry.name)) {
+                    for (const match of node_fs_1.default.readFileSync(full, 'utf8').matchAll(/\bclass\s+(\w+)([^{]*)\{/g)) {
+                        const implemented = match[2].match(/\bimplements\s+([\w\s,<>.]+)/)?.[1] ?? '';
+                        classes.push({ name: match[1], implements: new Set(implemented.match(/\w+/g) ?? []) });
+                    }
+                }
+            }
+        };
+        walk(dir);
+        infrastructureClasses.set(dir, classes);
+    }
+    return infrastructureClasses.get(dir);
+};
+/**
+ * Every `<X>RepositoryPort` declared in `app/ports/` has at least one implementation in the module's
+ * `infrastructure/`: a class that `implements` the port, or a prefixed `…<X>Repository`
+ * (`PgXRepository`, `PgNatsXRepository`, `InMemoryXRepository`, …). Which prefix is right for its
+ * folder is `repository-naming`'s job.
+ * Reads sibling files, so editors only re-check it when the port file itself is re-linted.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'suggestion',
+        docs: { description: 'Require every repository port to have at least one infrastructure implementation' },
+        messages: { missing: 'Port "{{port}}" has no implementation in {{module}}/infrastructure/ (expected e.g. Pg{{base}}).' },
+        schema: [],
+    },
+    create(context) {
+        const location = (0, ast_1.moduleLocation)(context);
+        if (!location || location.rest[0] !== 'app' || location.rest[1] !== 'ports')
+            return {};
+        return {
+            'TSInterfaceDeclaration[id.name=/RepositoryPort$/]'(node) {
+                const port = node.id.name;
+                const base = port.replace(/Port$/, '');
+                const implemented = classesIn(node_path_1.default.join(location.root, 'infrastructure')).some((cls) => cls.implements.has(port) || (cls.name !== base && cls.name.endsWith(base) && /^[A-Z]/.test(cls.name)));
+                if (!implemented)
+                    context.report({ node: node.id, messageId: 'missing', data: { port, base, module: location.module } });
+            },
+        };
+    },
+});
+//# sourceMappingURL=port-has-adapters.js.map

package/dist/rules/port-has-adapters.js.map

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