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

package/dist/rules/repository-naming.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Repository implementations live in `infrastructure/repositories/<storage>/` and are prefixed after
+ * it. A repository with several infrastructural dependencies lives in a combined folder whose
+ * segments are joined with `+` in config order, and concatenates the prefixes:
+ *
+ *   repositories/pg/PgTaskRepository.ts
+ *   repositories/memory/InMemoryTaskRepository.ts
+ *   repositories/pg+nats/PgNatsTaskRepository.ts      (Postgres + NATS outbox)
+ *
+ * The folder must also match what the file imports: a storage whose `imports` signature is found
+ * must be part of the folder, and every folder segment with a signature must be found.
+ *
+ * Options:
+ *   storages: { pg: { prefix: 'Pg', imports: ['@pjts/infra#PostgresDbClient', 'knex'] }, memory: { prefix: 'InMemory' } }
+ *     `imports` entries are `module`, `module#ImportedName` or `scope/*`.
+ *   requireImplementationFolder (default true), fileNameMatchesClass (default true)
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/repository-naming.js

@@ -0,0 +1,122 @@
+"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");
+/**
+ * Repository implementations live in `infrastructure/repositories/<storage>/` and are prefixed after
+ * it. A repository with several infrastructural dependencies lives in a combined folder whose
+ * segments are joined with `+` in config order, and concatenates the prefixes:
+ *
+ *   repositories/pg/PgTaskRepository.ts
+ *   repositories/memory/InMemoryTaskRepository.ts
+ *   repositories/pg+nats/PgNatsTaskRepository.ts      (Postgres + NATS outbox)
+ *
+ * The folder must also match what the file imports: a storage whose `imports` signature is found
+ * must be part of the folder, and every folder segment with a signature must be found.
+ *
+ * Options:
+ *   storages: { pg: { prefix: 'Pg', imports: ['@pjts/infra#PostgresDbClient', 'knex'] }, memory: { prefix: 'InMemory' } }
+ *     `imports` entries are `module`, `module#ImportedName` or `scope/*`.
+ *   requireImplementationFolder (default true), fileNameMatchesClass (default true)
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'suggestion',
+        docs: { description: 'Tie repository class names to their storage folder, imports and file name' },
+        messages: {
+            folder: 'Repository "{{name}}" must live in infrastructure/repositories/<{{storages}}>/ (combine with "+" for several).',
+            unknownStorage: 'Unknown storage "{{segment}}" in "{{folder}}/" — known: {{storages}}.',
+            order: 'Name the folder "{{expected}}/" — storages are combined in the order {{storages}}.',
+            prefix: 'Repository "{{name}}" lives in "{{folder}}/", so it must be named {{prefix}}…Repository.',
+            undeclared: '"{{name}}" depends on {{storage}} ({{via}}), so it belongs in "repositories/{{expected}}/" as {{prefix}}…Repository.',
+            unused: '"{{name}}" lives in "{{folder}}/" but does not depend on {{storage}} — move it to "repositories/{{expected}}/".',
+            fileName: 'File "{{file}}.ts" must be named after its repository class "{{name}}" (one repository per file).',
+        },
+        schema: [{
+                type: 'object',
+                properties: {
+                    storages: {
+                        type: 'object',
+                        additionalProperties: {
+                            type: 'object',
+                            properties: { prefix: { type: 'string' }, imports: { type: 'array', items: { type: 'string' } } },
+                            required: ['prefix'],
+                            additionalProperties: false,
+                        },
+                    },
+                    requireImplementationFolder: { type: 'boolean' },
+                    fileNameMatchesClass: { type: 'boolean' },
+                },
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const { storages = { pg: { prefix: 'Pg', imports: ['@pjts/infra#PostgresDbClient', 'knex', 'pg'] }, memory: { prefix: 'InMemory' } }, requireImplementationFolder = true, fileNameMatchesClass = true, } = context.options[0] ?? {};
+        const keys = Object.keys(storages);
+        const allPrefixes = keys.map((key) => storages[key].prefix);
+        const file = (0, ast_1.filePath)(context);
+        const folder = file.match(/\/infrastructure\/repositories\/([^/]+)\/[^/]+$/)?.[1] ?? null;
+        const baseName = node_path_1.default.basename(file).replace(/\.tsx?$/, '');
+        /** storage key → the import that revealed it, for every storage whose signature this file imports. */
+        const detected = new Map();
+        const matches = (spec, source, importedNames) => {
+            const [module, name] = spec.split('#');
+            const moduleMatches = module.endsWith('/*') ? source.startsWith(module.slice(0, -1)) : source === module;
+            return moduleMatches && (!name || importedNames.includes(name));
+        };
+        const folderFor = (segments) => keys.filter((key) => segments.includes(key)).join('+');
+        const prefixFor = (segments) => keys.filter((key) => segments.includes(key)).map((key) => storages[key].prefix).join('');
+        return {
+            ImportDeclaration(node) {
+                const source = node.source.value;
+                const importedNames = node.specifiers.map((s) => s.imported?.name ?? s.local.name);
+                for (const key of keys) {
+                    const spec = (storages[key].imports ?? []).find((candidate) => matches(candidate, source, importedNames));
+                    if (spec && !detected.has(key))
+                        detected.set(key, spec.replace('#', ' → '));
+                }
+            },
+            'ClassDeclaration[id.name=/Repository$/]'(node) {
+                const name = node.id.name;
+                const report = (messageId, data) => context.report({ node: node.id, messageId, data: { name, ...data } });
+                if (fileNameMatchesClass && baseName !== name)
+                    report('fileName', { file: baseName });
+                if (!folder) {
+                    if (requireImplementationFolder)
+                        report('folder', { storages: keys.join('|') });
+                    return;
+                }
+                const segments = folder.split('+');
+                const unknown = segments.filter((segment) => !(segment in storages));
+                if (unknown.length > 0) {
+                    for (const segment of unknown)
+                        report('unknownStorage', { segment, folder, storages: keys.join(', ') });
+                    return;
+                }
+                if (folderFor(segments) !== folder)
+                    report('order', { expected: folderFor(segments), storages: keys.join(' + ') });
+                // The prefix must be exactly the folder's: `PgNatsX` in pg/ is as wrong as `PgX` in pg+nats/.
+                const prefix = prefixFor(segments);
+                const rest = name.slice(prefix.length);
+                if (!name.startsWith(prefix) || !/^[A-Z]/.test(rest) || allPrefixes.some((p) => rest.startsWith(p) && /^[A-Z]/.test(rest.slice(p.length)))) {
+                    report('prefix', { folder, prefix });
+                }
+                const required = [...new Set([...segments, ...detected.keys()])];
+                for (const [key, via] of detected) {
+                    if (!segments.includes(key)) {
+                        report('undeclared', { storage: key, via, expected: folderFor(required), prefix: prefixFor(required) });
+                    }
+                }
+                for (const key of segments) {
+                    if ((storages[key].imports ?? []).length > 0 && !detected.has(key)) {
+                        const actual = segments.filter((segment) => segment !== key);
+                        report('unused', { folder, storage: key, expected: actual.length ? folderFor(actual) : '<storage it uses>' });
+                    }
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=repository-naming.js.map

package/dist/rules/repository-naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-naming.js","sourceRoot":"","sources":["../../src/rules/repository-naming.ts"],"names":[],"mappings":";;;AAAA,kEAA6B;AAC7B,oCAAsC;AACtC,sCAAyC;AAEzC;;;;;;;;;;;;;;;;GAgBG;AACH,kBAAe,IAAA,iBAAU,EAAC;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,EAAE,WAAW,EAAE,2EAA2E,EAAE;QAClG,QAAQ,EAAE;YACR,MAAM,EAAE,gHAAgH;YACxH,cAAc,EAAE,uEAAuE;YACvF,KAAK,EAAE,oFAAoF;YAC3F,MAAM,EAAE,0FAA0F;YAClG,UAAU,EAAE,sHAAsH;YAClI,MAAM,EAAE,iHAAiH;YACzH,QAAQ,EAAE,mGAAmG;SAC9G;QACD,MAAM,EAAE,CAAC;gBACP,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,oBAAoB,EAAE;4BACpB,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;4BACjG,QAAQ,EAAE,CAAC,QAAQ,CAAC;4BACpB,oBAAoB,EAAE,KAAK;yBAC5B;qBACF;oBACD,2BAA2B,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAChD,oBAAoB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;iBAC1C;gBACD,oBAAoB,EAAE,KAAK;aAC5B,CAAC;KACH;IACD,MAAM,CAAC,OAAO;QACZ,MAAM,EACJ,QAAQ,GAAG,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,8BAA8B,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAC5H,2BAA2B,GAAG,IAAI,EAClC,oBAAoB,GAAG,IAAI,GAC5B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAA,cAAQ,EAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,iDAAiD,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC1F,MAAM,QAAQ,GAAG,mBAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAE5D,sGAAsG;QACtG,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE;YAC9C,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACvC,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;YACzG,OAAO,aAAa,IAAI,CAAC,CAAC,IAAI,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,CAAC,CAAC;QAEF,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvF,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEzH,OAAO;YACL,iBAAiB,CAAC,IAAI;gBACpB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBACjC,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACnF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;oBAC1G,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;wBAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC;YAED,yCAAyC,CAAC,IAAI;gBAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;gBAC1B,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;gBAE1G,IAAI,oBAAoB,IAAI,QAAQ,KAAK,IAAI;oBAAE,MAAM,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAEtF,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,IAAI,2BAA2B;wBAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBAChF,OAAO;gBACT,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC;gBACrE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,KAAK,MAAM,OAAO,IAAI,OAAO;wBAAE,MAAM,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACxG,OAAO;gBACT,CAAC;gBACD,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,MAAM;oBAAE,MAAM,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAEnH,8FAA8F;gBAC9F,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;gBACnC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACvC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3I,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvC,CAAC;gBAED,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBACjE,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC;oBAClC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC5B,MAAM,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBAC1G,CAAC;gBACH,CAAC;gBACD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBACnE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,GAAG,CAAC,CAAC;wBAC7D,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;oBAChH,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/repository-serialization.d.ts

@@ -0,0 +1,6 @@
+/**
+ * persistence repositories map with `serialize` (entity → record) and `deserialize`
+ * (record → entity), and `deserialize` passes the record straight into `new Entity({...})`.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/repository-serialization.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ast_1 = require("../lib/ast");
+const rule_1 = require("../lib/rule");
+const LEGACY_MAPPERS = /^(toDomain|toEntity|toRecord|toRow|fromRow|fromRecord|mapRow|mapRecord|rowTo\w+|recordTo\w+)$/;
+/**
+ * persistence repositories map with `serialize` (entity → record) and `deserialize`
+ * (record → entity), and `deserialize` passes the record straight into `new Entity({...})`.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'suggestion',
+        docs: { description: 'Require serialize/deserialize mapping methods on persistence repositories' },
+        messages: {
+            missing: '"{{name}}" must define `{{method}}`.',
+            legacy: 'Rename `{{method}}` to `serialize` / `deserialize`.',
+            constructor: '`deserialize` must return `new <Entity>({...})`.',
+        },
+        schema: [{
+                type: 'object',
+                properties: { classPattern: { type: 'string' } },
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const classPattern = new RegExp(context.options[0]?.classPattern ?? '^Pg\\w*Repository$');
+        return {
+            'ClassDeclaration[id]'(node) {
+                const name = node.id.name;
+                if (!classPattern.test(name))
+                    return;
+                for (const method of ['serialize', 'deserialize']) {
+                    if (!(0, ast_1.findMethod)(node, method))
+                        context.report({ node: node.id, messageId: 'missing', data: { name, method } });
+                }
+                for (const method of (0, ast_1.methods)(node)) {
+                    if (LEGACY_MAPPERS.test((0, ast_1.memberName)(method) ?? '')) {
+                        context.report({ node: method.key, messageId: 'legacy', data: { method: (0, ast_1.memberName)(method) } });
+                    }
+                }
+                const deserialize = (0, ast_1.findMethod)(node, 'deserialize');
+                const returned = deserialize?.value.body?.body.filter((statement) => statement.type === 'ReturnStatement') ?? [];
+                if (returned.some((statement) => statement.argument?.type !== 'NewExpression')) {
+                    context.report({ node: deserialize.key, messageId: 'constructor' });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=repository-serialization.js.map

package/dist/rules/repository-serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-serialization.js","sourceRoot":"","sources":["../../src/rules/repository-serialization.ts"],"names":[],"mappings":";;AAAA,oCAA6D;AAC7D,sCAAyC;AAEzC,MAAM,cAAc,GAAG,+FAA+F,CAAC;AAEvH;;;GAGG;AACH,kBAAe,IAAA,iBAAU,EAAC;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,EAAE,WAAW,EAAE,2EAA2E,EAAE;QAClG,QAAQ,EAAE;YACR,OAAO,EAAE,sCAAsC;YAC/C,MAAM,EAAE,qDAAqD;YAC7D,WAAW,EAAE,kDAAkD;SAChE;QACD,MAAM,EAAE,CAAC;gBACP,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBAChD,oBAAoB,EAAE,KAAK;aAC5B,CAAC;KACH;IACD,MAAM,CAAC,OAAO;QACZ,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,IAAI,oBAAoB,CAAC,CAAC;QAC1F,OAAO;YACL,sBAAsB,CAAC,IAAI;gBACzB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;gBAC1B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,OAAO;gBAErC,KAAK,MAAM,MAAM,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,CAAC;oBAClD,IAAI,CAAC,IAAA,gBAAU,EAAC,IAAI,EAAE,MAAM,CAAC;wBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBACjH,CAAC;gBACD,KAAK,MAAM,MAAM,IAAI,IAAA,aAAO,EAAC,IAAI,CAAC,EAAE,CAAC;oBACnC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAA,gBAAU,EAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;wBAClD,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAA,gBAAU,EAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;oBAClG,CAAC;gBACH,CAAC;gBACD,MAAM,WAAW,GAAG,IAAA,gBAAU,EAAC,IAAI,EAAE,aAAa,CAAC,CAAC;gBACpD,MAAM,QAAQ,GAAG,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,iBAAiB,CAAC,IAAI,EAAE,CAAC;gBACjH,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,KAAK,eAAe,CAAC,EAAE,CAAC;oBAC/E,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/return-entities.d.ts

@@ -0,0 +1,6 @@
+/**
+ * service methods return domain entities (`Promise<Task>`); the framework serializes them
+ * through `toJSON`, so the app layer never calls it nor declares response-DTO return types.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/return-entities.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ast_1 = require("../lib/ast");
+const rule_1 = require("../lib/rule");
+/**
+ * service methods return domain entities (`Promise<Task>`); the framework serializes them
+ * through `toJSON`, so the app layer never calls it nor declares response-DTO return types.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'suggestion',
+        docs: { description: 'Forbid hand-serialization and response-DTO return types in the app layer' },
+        messages: {
+            toJSON: 'Return the entity — the framework serializes it via toJSON.',
+            responseType: 'Return the domain entity, not "{{type}}".',
+        },
+        schema: [{
+                type: 'object',
+                properties: { responseTypePattern: { type: 'string' } },
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const responseType = new RegExp(context.options[0]?.responseTypePattern ?? '(ResponseDto|Response|JSON|Json)$');
+        return {
+            'CallExpression[callee.property.name="toJSON"][arguments.length=0]': (node) => context.report({ node, messageId: 'toJSON' }),
+            'MethodDefinition[kind="method"][accessibility!="private"] > FunctionExpression'(fn) {
+                const inner = (0, ast_1.promiseTypeArgument)(fn.returnType);
+                const type = inner?.type === 'TSArrayType' ? inner.elementType : inner;
+                const name = type?.type === 'TSTypeReference' ? type.typeName.name : null;
+                if (name && responseType.test(name)) {
+                    context.report({ node: fn.returnType, messageId: 'responseType', data: { type: name } });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=return-entities.js.map

package/dist/rules/return-entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-entities.js","sourceRoot":"","sources":["../../src/rules/return-entities.ts"],"names":[],"mappings":";;AAAA,oCAAiD;AACjD,sCAAyC;AAEzC;;;GAGG;AACH,kBAAe,IAAA,iBAAU,EAAC;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,EAAE,WAAW,EAAE,0EAA0E,EAAE;QACjG,QAAQ,EAAE;YACR,MAAM,EAAE,6DAA6D;YACrE,YAAY,EAAE,2CAA2C;SAC1D;QACD,MAAM,EAAE,CAAC;gBACP,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gBACvD,oBAAoB,EAAE,KAAK;aAC5B,CAAC;KACH;IACD,MAAM,CAAC,OAAO;QACZ,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,mBAAmB,IAAI,mCAAmC,CAAC,CAAC;QAChH,OAAO;YACL,mEAAmE,EAAE,CAAC,IAAI,EAAE,EAAE,CAC5E,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;YAC/C,gFAAgF,CAAC,EAAE;gBACjF,MAAM,KAAK,GAAG,IAAA,yBAAmB,EAAC,EAAE,CAAC,UAAU,CAAC,CAAC;gBACjD,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC;gBACvE,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,KAAK,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;gBAC1E,IAAI,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC3F,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/save-contract.d.ts

@@ -0,0 +1,7 @@
+/**
+ * respond from the domain entity, never from what `repo.save()` returned.
+ * `save` signatures are `Promise<void>`; a genuine `RETURNING` case is documented with
+ *          `// eslint-disable-next-line theralign/save-contract -- RETURNING <column>`.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/save-contract.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ast_1 = require("../lib/ast");
+const rule_1 = require("../lib/rule");
+/**
+ * respond from the domain entity, never from what `repo.save()` returned.
+ * `save` signatures are `Promise<void>`; a genuine `RETURNING` case is documented with
+ *          `// eslint-disable-next-line theralign/save-contract -- RETURNING <column>`.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'suggestion',
+        docs: { description: 'Enforce the repository save() contract' },
+        messages: {
+            usedResult: 'Respond from the entity itself, not from save()\'s return value.',
+            signature: '`save` must return Promise<void> unless the SQL uses RETURNING.',
+        },
+        schema: [],
+    },
+    create(context) {
+        const isSaveCall = (node) => (0, ast_1.calledMethodName)((0, ast_1.unwrapAwait)(node)) === 'save';
+        const checkSignature = (key, returnType) => {
+            const inner = (0, ast_1.promiseTypeArgument)(returnType);
+            if (inner !== undefined && inner?.type !== 'TSVoidKeyword')
+                context.report({ node: key, messageId: 'signature' });
+        };
+        return {
+            VariableDeclarator(node) {
+                if (isSaveCall(node.init))
+                    context.report({ node, messageId: 'usedResult' });
+            },
+            ReturnStatement(node) {
+                if (isSaveCall(node.argument))
+                    context.report({ node, messageId: 'usedResult' });
+            },
+            'TSMethodSignature[key.name="save"]': (node) => checkSignature(node.key, node.returnType),
+            'MethodDefinition[key.name="save"]': (node) => checkSignature(node.key, node.value.returnType),
+        };
+    },
+});
+//# sourceMappingURL=save-contract.js.map

package/dist/rules/save-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-contract.js","sourceRoot":"","sources":["../../src/rules/save-contract.ts"],"names":[],"mappings":";;AAAA,oCAAgF;AAChF,sCAAyC;AAEzC;;;;GAIG;AACH,kBAAe,IAAA,iBAAU,EAAC;IACxB,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,EAAE,WAAW,EAAE,wCAAwC,EAAE;QAC/D,QAAQ,EAAE;YACR,UAAU,EAAE,kEAAkE;YAC9E,SAAS,EAAE,iEAAiE;SAC7E;QACD,MAAM,EAAE,EAAE;KACX;IACD,MAAM,CAAC,OAAO;QACZ,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,sBAAgB,EAAC,IAAA,iBAAW,EAAC,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC;QAC5E,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE;YACzC,MAAM,KAAK,GAAG,IAAA,yBAAmB,EAAC,UAAU,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,EAAE,IAAI,KAAK,eAAe;gBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QACpH,CAAC,CAAC;QACF,OAAO;YACL,kBAAkB,CAAC,IAAI;gBACrB,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;YAC/E,CAAC;YACD,eAAe,CAAC,IAAI;gBAClB,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;oBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;YACnF,CAAC;YACD,oCAAoC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC;YACzF,mCAAmC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;SAC/F,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/test-location.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tests sit next to what they test and are named after it:
+ *
+ *   app/DashboardView.ts
+ *   app/DashboardView.test.ts               ✓
+ *   app/DashboardView.cross-tenant.test.ts  ✓  (optional single suffix)
+ *   app/__tests__/DashboardView.test.ts     ✗  → app/DashboardView.test.ts
+ *   app/cross-tenant.test.ts                ✗  → not named after a file in app/
+ *
+ * Checked as: the first segment of the test's file name is a source file in the same directory.
+ * When it isn't, the rule searches the source root (the nearest `src/`) to suggest where it belongs.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/test-location.js

@@ -0,0 +1,94 @@
+"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");
+const TEST_FILE = /^([^.]+)(?:\.([^.]+))?\.test\.tsx?$/;
+/** source root → Map<basename without extension, relative paths> of every non-test source file (per lint run). */
+const sourceIndex = new Map();
+const indexOf = (root) => {
+    if (!sourceIndex.has(root)) {
+        const index = new Map();
+        const walk = (dir) => {
+            for (const entry of node_fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+                const full = node_path_1.default.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    if (entry.name !== 'node_modules')
+                        walk(full);
+                }
+                else if (/\.tsx?$/.test(entry.name) && !/\.(test|d)\.tsx?$/.test(entry.name)) {
+                    const name = entry.name.replace(/\.tsx?$/, '');
+                    index.set(name, [...(index.get(name) ?? []), node_path_1.default.relative(root, full).split(node_path_1.default.sep).join('/')]);
+                }
+            }
+        };
+        walk(root);
+        sourceIndex.set(root, index);
+    }
+    return sourceIndex.get(root);
+};
+/**
+ * Tests sit next to what they test and are named after it:
+ *
+ *   app/DashboardView.ts
+ *   app/DashboardView.test.ts               ✓
+ *   app/DashboardView.cross-tenant.test.ts  ✓  (optional single suffix)
+ *   app/__tests__/DashboardView.test.ts     ✗  → app/DashboardView.test.ts
+ *   app/cross-tenant.test.ts                ✗  → not named after a file in app/
+ *
+ * Checked as: the first segment of the test's file name is a source file in the same directory.
+ * When it isn't, the rule searches the source root (the nearest `src/`) to suggest where it belongs.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'suggestion',
+        docs: { description: 'Require tests to sit next to, and be named after, the file they test' },
+        messages: {
+            folder: 'Tests sit next to the code they test — move to {{target}}.',
+            name: 'Test files are named "<TestedFile>.<optional-suffix>.test.ts" — "{{file}}" has more than one suffix.',
+            misplaced: '"{{file}}" tests {{tested}} — move it next to it: {{target}}.',
+            ambiguous: '"{{file}}" must sit next to {{tested}}.ts — candidates: {{candidates}}.',
+            untested: '"{{file}}" must be named after the file it tests ("<TestedFile>.<suffix>.test.ts") and sit next to it — no "{{tested}}.ts" exists.',
+        },
+        schema: [],
+    },
+    create(context) {
+        const file = (0, ast_1.filePath)(context);
+        const base = node_path_1.default.posix.basename(file);
+        if (!/\.test\.tsx?$/.test(base))
+            return {};
+        return {
+            Program(node) {
+                const report = (messageId, data) => context.report({ node, loc: { line: 1, column: 0 }, messageId, data: { file: base, ...data } });
+                const match = base.match(TEST_FILE);
+                if (!match)
+                    return report('name', {});
+                const tested = match[1];
+                const srcAt = file.lastIndexOf('/src/');
+                const root = srcAt === -1 ? node_path_1.default.posix.dirname(file) : file.slice(0, srcAt + '/src'.length);
+                const dir = node_path_1.default.posix.dirname(file);
+                const inTestsFolder = dir.split('/').includes('__tests__');
+                const codeDir = inTestsFolder ? dir.split('/').filter((segment) => segment !== '__tests__').join('/') : dir;
+                const rel = (absolute) => node_path_1.default.posix.relative(root, absolute);
+                const exists = (directory) => ['.ts', '.tsx'].some((ext) => node_fs_1.default.existsSync(`${directory}/${tested}${ext}`));
+                if (!inTestsFolder && exists(dir))
+                    return;
+                if (inTestsFolder && exists(codeDir))
+                    return report('folder', { target: `src/${rel(`${codeDir}/${base}`)}` });
+                // Prefer a match inside the test's own module (`modules/<name>/`) over same-named files elsewhere.
+                const all = indexOf(root).get(tested) ?? [];
+                const module = rel(dir).match(/^modules\/[^/]+\//)?.[0];
+                const local = module ? all.filter((relative) => relative.startsWith(module)) : [];
+                const candidates = (local.length ? local : all).map((relative) => `src/${node_path_1.default.posix.dirname(relative)}/${base}`);
+                if (candidates.length === 1)
+                    return report('misplaced', { tested: `${tested}.ts`, target: candidates[0] });
+                if (candidates.length > 1)
+                    return report('ambiguous', { tested, candidates: candidates.join(', ') });
+                return report('untested', { tested });
+            },
+        };
+    },
+});
+//# sourceMappingURL=test-location.js.map

package/dist/rules/test-location.js.map

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

package/dist/rules/throw-app-error.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Every error the API throws is an `AppError` from `@pjts/core`:
+ *
+ *   throw AppError.notFound(`Task ${id} not found`);
+ *   throw new AppError(409, 'VERSION_NOT_DRAFT');
+ *
+ * Anything else — `new Error(...)`, custom `Error` subclasses, values returned by helpers — is
+ * flagged. Rethrowing the caught error unchanged (`catch (e) { …; throw e; }`) is allowed by default
+ * (`allowRethrow`): its throw site was checked where it was created, or it comes from a library.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;

package/dist/rules/throw-app-error.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rule_1 = require("../lib/rule");
+/**
+ * Every error the API throws is an `AppError` from `@pjts/core`:
+ *
+ *   throw AppError.notFound(`Task ${id} not found`);
+ *   throw new AppError(409, 'VERSION_NOT_DRAFT');
+ *
+ * Anything else — `new Error(...)`, custom `Error` subclasses, values returned by helpers — is
+ * flagged. Rethrowing the caught error unchanged (`catch (e) { …; throw e; }`) is allowed by default
+ * (`allowRethrow`): its throw site was checked where it was created, or it comes from a library.
+ */
+exports.default = (0, rule_1.defineRule)({
+    meta: {
+        type: 'problem',
+        docs: { description: 'Require thrown errors to be AppError' },
+        messages: {
+            appError: 'Throw an AppError (`throw AppError.badRequest(...)` / `throw new AppError(status, ...)`), not {{what}}.',
+        },
+        schema: [{
+                type: 'object',
+                properties: { module: { type: 'string' }, allowRethrow: { type: 'boolean' } },
+                additionalProperties: false,
+            }],
+    },
+    create(context) {
+        const { module = '@pjts/core', allowRethrow = true } = context.options[0] ?? {};
+        /** Local names bound to the real AppError. */
+        const appErrorNames = new Set();
+        const isAppError = (node) => node?.type === 'Identifier' && appErrorNames.has(node.name);
+        const isCaughtParam = (identifier) => {
+            for (const ancestor of context.sourceCode.getAncestors(identifier).reverse()) {
+                if (ancestor.type === 'CatchClause')
+                    return ancestor.param?.type === 'Identifier' && ancestor.param.name === identifier.name;
+                if (/Function/.test(ancestor.type))
+                    return false;
+            }
+            return false;
+        };
+        const describe = (argument) => {
+            if (argument.type === 'NewExpression')
+                return `new ${context.sourceCode.getText(argument.callee)}(...)`;
+            return `\`${context.sourceCode.getText(argument).slice(0, 40)}\``;
+        };
+        return {
+            ImportDeclaration(node) {
+                if (node.source.value !== module)
+                    return;
+                for (const specifier of node.specifiers) {
+                    if ((specifier.imported?.name ?? specifier.local.name) === 'AppError')
+                        appErrorNames.add(specifier.local.name);
+                }
+            },
+            ThrowStatement(node) {
+                const argument = node.argument;
+                if (argument.type === 'NewExpression' && isAppError(argument.callee))
+                    return;
+                if (argument.type === 'CallExpression' && argument.callee.type === 'MemberExpression' && isAppError(argument.callee.object))
+                    return;
+                if (allowRethrow && argument.type === 'Identifier' && isCaughtParam(argument))
+                    return;
+                context.report({ node: argument, messageId: 'appError', data: { what: describe(argument) } });
+            },
+        };
+    },
+});
+//# sourceMappingURL=throw-app-error.js.map

package/dist/rules/throw-app-error.js.map

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

package/dist/rules/trackable-repository.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Repositories built on the pjx persistence bases (`RepositoryBase`, `OutboxRepository`):
+ *
+ * - every `deserialize…` method carries `@reconstitute` — it marks the entity as restored and copies
+ *   its version, so `save()` updates (with the optimistic-lock check) instead of inserting a duplicate;
+ * - an event-sourced aggregate (`extends EventSourceable`) is persisted by an `…OutboxRepository`, so
+ *   its emitted events reach the outbox in the same transaction as its state.
+ */
+declare const _default: import("eslint").Rule.RuleModule;
+export default _default;