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

package/dist/rules/ports-no-concrete-dependency.js

@@ -0,0 +1,32 @@
+import { defineRule } from '../support/rule/define-rule.js';
+import { dependencyListListener } from '../support/ports/dependency-list-listener.js';
+import { importedBindings } from '../support/ports/imported-bindings.js';
+export const portsNoConcreteDependency = defineRule({
+    id: 'ports/no-concrete-dependency',
+    type: 'problem',
+    recommended: 'error',
+    description: 'A dependency list names ports, never the class that implements one: nothing imported from infrastructure/ or from test/fakes/.',
+    messages: {
+        concrete: '{{name}} is named in a dependency list but comes from {{where}}: a list names ports, never what implements them. Name the port (the abstract class of domain/repositories or application/ports that {{name}} implements) and let the declaration of the adapter, the module file or a `fake(Port, ..)` of the test say which class stands behind it.',
+    },
+    create({ file, sourceCode, report }) {
+        const imported = importedBindings(file, sourceCode.ast);
+        return dependencyListListener(sourceCode.ast, (dependency) => {
+            const where = concretePlace(imported.get(dependency.name)?.target);
+            if (where !== undefined) {
+                report({ node: dependency, messageId: 'concrete', data: { name: dependency.name, where } });
+            }
+        });
+    },
+});
+function concretePlace(target) {
+    if (target?.kind !== 'file' || target.location.area !== 'context') {
+        return undefined;
+    }
+    const { layer, inside } = target.location;
+    if (layer === 'infrastructure') {
+        return 'infrastructure/';
+    }
+    return layer === 'test' && inside[0] === 'fakes' ? 'test/fakes/' : undefined;
+}
+//# sourceMappingURL=ports-no-concrete-dependency.js.map

package/dist/rules/ports-no-concrete-dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports-no-concrete-dependency.js","sourceRoot":"","sources":["../../src/rules/ports-no-concrete-dependency.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAa;IAC9D,EAAE,EAAE,8BAA8B;IAClC,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,OAAO;IACpB,WAAW,EACT,gIAAgI;IAClI,QAAQ,EAAE;QACR,QAAQ,EACN,sVAAsV;KACzV;IACD,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE;QACjC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;QAExD,OAAO,sBAAsB,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE;YAC3D,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;YAEnE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,aAAa,CAAC,MAAgC;IACrD,IAAI,MAAM,EAAE,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;IAE1C,IAAI,KAAK,KAAK,gBAAgB,EAAE,CAAC;QAC/B,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,KAAK,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/E,CAAC"}

package/dist/rules/ports-no-token-constant.d.ts

@@ -0,0 +1,5 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+type MessageId = 'tokenCall' | 'madeToken' | 'literalToken' | 'constant' | 'tokenFile';
+export declare const portsNoTokenConstant: TSESLint.RuleModule<MessageId, [], import("../index.js").RuleDocs, TSESLint.RuleListener>;
+export {};
+//# sourceMappingURL=ports-no-token-constant.d.ts.map

package/dist/rules/ports-no-token-constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports-no-token-constant.d.ts","sourceRoot":"","sources":["../../src/rules/ports-no-token-constant.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,KAAK,QAAQ,EAAiB,MAAM,0BAA0B,CAAC;AAOlG,KAAK,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AAUvF,eAAO,MAAM,oBAAoB,2FAiD/B,CAAC"}

package/dist/rules/ports-no-token-constant.js

@@ -0,0 +1,109 @@
+import path from 'node:path';
+import { ASTUtils, AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { defineRule } from '../support/rule/define-rule.js';
+import { propertyName } from '../support/globals/property-name.js';
+import { inSourceRoot } from '../support/imports/in-source-root.js';
+import { bindingCallReader } from '../support/ports/binding-call-reader.js';
+import { dependencyListListener } from '../support/ports/dependency-list-listener.js';
+const KIT = /^@ddd-ts-kit\//;
+const UPPER_SNAKE = /^[A-Z][A-Z0-9]*(?:_[A-Z0-9]+)*$/;
+const TOKEN_FILE = /(?:\.ports|^tokens)\.ts$/;
+const INSTEAD = 'Declare the port as an abstract class (domain/repositories/*.repository.ts or application/ports/*.port.ts) and name that class wherever the dependency is bound, listed or resolved: the class is the contract and the injection token at once.';
+export const portsNoTokenConstant = defineRule({
+    id: 'ports/no-token-constant',
+    type: 'problem',
+    recommended: 'error',
+    description: 'There is no token constant and no token file: a dependency is named by the abstract class of its port, never by `token(..)`, a symbol, a string or an UPPER_SNAKE constant.',
+    messages: {
+        tokenCall: `\`{{call}}(..)\` makes an injection token. ${INSTEAD}`,
+        madeToken: `{{name}} is a symbol used as an injection token. ${INSTEAD}`,
+        literalToken: `\`{{call}}(..)\` is given {{what}} as its token. ${INSTEAD}`,
+        constant: `{{name}} in this dependency list is a token constant. ${INSTEAD} Write the name of the port class here.`,
+        tokenFile: `{{file}} is a token file. ${INSTEAD} Move each port to its own file and delete this one.`,
+    },
+    create({ file, sourceCode, report }) {
+        const bindingCall = bindingCallReader(sourceCode.ast);
+        const tokenMakers = importedTokenMakers(sourceCode.ast);
+        const tellGivenToken = givenTokenReporter(sourceCode, report);
+        const lists = dependencyListListener(sourceCode.ast, (dependency) => {
+            if (dependency.name.length > 1 && UPPER_SNAKE.test(dependency.name)) {
+                report({ node: dependency, messageId: 'constant', data: { name: dependency.name } });
+            }
+        });
+        return {
+            ...lists,
+            Program() {
+                const base = path.posix.basename(file.path);
+                if (inSourceRoot(file) && TOKEN_FILE.test(base)) {
+                    report({ loc: { line: 1, column: 0 }, messageId: 'tokenFile', data: { file: base } });
+                }
+            },
+            CallExpression(node) {
+                lists.CallExpression?.(node);
+                if (isTokenMaker(node.callee, tokenMakers)) {
+                    report({ node, messageId: 'tokenCall', data: { call: sourceCode.getText(node.callee) } });
+                }
+                const call = bindingCall(node);
+                const [given] = node.arguments;
+                if (call !== undefined && given !== undefined) {
+                    tellGivenToken(call, given);
+                }
+            },
+        };
+    },
+});
+/** What a binding call is given instead of a port class: a symbol, a string, or a constant holding a symbol. */
+function givenTokenReporter(sourceCode, report) {
+    return (call, given) => {
+        if (isSymbol(given)) {
+            report({ node: given, messageId: 'literalToken', data: { call, what: 'a symbol' } });
+        }
+        if (given.type === AST_NODE_TYPES.Literal && typeof given.value === 'string') {
+            report({ node: given, messageId: 'literalToken', data: { call, what: 'a string' } });
+        }
+        if (given.type === AST_NODE_TYPES.Identifier && isDeclaredAsSymbol(sourceCode, given)) {
+            report({ node: given, messageId: 'madeToken', data: { name: given.name } });
+        }
+    };
+}
+/** The local names of `token` imported from a package of the kit, and the namespaces it can be reached through. */
+function importedTokenMakers(program) {
+    const imports = program.body.filter((statement) => statement.type === AST_NODE_TYPES.ImportDeclaration && KIT.test(statement.source.value));
+    const specifiers = imports.flatMap((statement) => statement.type === AST_NODE_TYPES.ImportDeclaration ? statement.specifiers : []);
+    const named = specifiers.filter((specifier) => specifier.type === AST_NODE_TYPES.ImportSpecifier &&
+        specifier.imported.type === AST_NODE_TYPES.Identifier &&
+        specifier.imported.name === 'token');
+    const namespaces = specifiers.filter((specifier) => specifier.type === AST_NODE_TYPES.ImportNamespaceSpecifier);
+    return {
+        named: new Set(named.map((specifier) => specifier.local.name)),
+        namespaces: new Set(namespaces.map((specifier) => specifier.local.name)),
+    };
+}
+function isTokenMaker(callee, makers) {
+    if (callee.type === AST_NODE_TYPES.Identifier) {
+        return makers.named.has(callee.name);
+    }
+    return (callee.type === AST_NODE_TYPES.MemberExpression &&
+        callee.object.type === AST_NODE_TYPES.Identifier &&
+        makers.namespaces.has(callee.object.name) &&
+        propertyName(callee) === 'token');
+}
+/** `Symbol('clock')` and `Symbol.for('clock')`. */
+function isSymbol(node) {
+    if (node?.type !== AST_NODE_TYPES.CallExpression) {
+        return false;
+    }
+    const { callee } = node;
+    if (callee.type === AST_NODE_TYPES.Identifier) {
+        return callee.name === 'Symbol';
+    }
+    return (callee.type === AST_NODE_TYPES.MemberExpression &&
+        callee.object.type === AST_NODE_TYPES.Identifier &&
+        callee.object.name === 'Symbol' &&
+        propertyName(callee) === 'for');
+}
+function isDeclaredAsSymbol(sourceCode, identifier) {
+    const declared = ASTUtils.findVariable(sourceCode.getScope(identifier), identifier.name)?.defs[0]?.node;
+    return declared?.type === AST_NODE_TYPES.VariableDeclarator && isSymbol(declared.init);
+}
+//# sourceMappingURL=ports-no-token-constant.js.map

package/dist/rules/ports-no-token-constant.js.map

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

package/dist/rules/ports-value-import.d.ts

@@ -0,0 +1,3 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+export declare const portsValueImport: TSESLint.RuleModule<"typeImport", [], import("../index.js").RuleDocs, TSESLint.RuleListener>;
+//# sourceMappingURL=ports-value-import.d.ts.map

package/dist/rules/ports-value-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports-value-import.d.ts","sourceRoot":"","sources":["../../src/rules/ports-value-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAiB,MAAM,0BAA0B,CAAC;AAWxF,eAAO,MAAM,gBAAgB,8FAoC3B,CAAC"}

package/dist/rules/ports-value-import.js

@@ -0,0 +1,60 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { defineRule } from '../support/rule/define-rule.js';
+import { bindingCallReader } from '../support/ports/binding-call-reader.js';
+import { dependencyListListener } from '../support/ports/dependency-list-listener.js';
+import { importedBindings } from '../support/ports/imported-bindings.js';
+const BINDERS = new Set(['bind', 'rebind']);
+export const portsValueImport = defineRule({
+    id: 'ports/value-import',
+    type: 'problem',
+    recommended: 'error',
+    fixable: 'code',
+    description: 'A port named in a dependency list or given to bind is imported as a value: the class is the injection token, and a type import erases it.',
+    messages: {
+        typeImport: '{{name}} is used as an injection token but is imported with `import type`. Import it as a value (`import { {{name}} } from ..`): the abstract class is the token, and a type-only import leaves nothing to bind or to resolve when the file runs.',
+    },
+    create({ file, sourceCode, report }) {
+        const imported = importedBindings(file, sourceCode.ast);
+        const bindingCall = bindingCallReader(sourceCode.ast);
+        const judge = (node) => {
+            const binding = node?.type === AST_NODE_TYPES.Identifier ? imported.get(node.name) : undefined;
+            if (node?.type === AST_NODE_TYPES.Identifier && binding?.typeOnly === true) {
+                report({ node, messageId: 'typeImport', data: { name: node.name }, fix: asValueImport(sourceCode, binding) });
+            }
+        };
+        const lists = dependencyListListener(sourceCode.ast, judge);
+        return {
+            ...lists,
+            CallExpression(node) {
+                lists.CallExpression?.(node);
+                if (BINDERS.has(bindingCall(node) ?? '')) {
+                    judge(node.arguments[0]);
+                }
+            },
+        };
+    },
+});
+/** `import { type X }` loses its keyword; `import type { X, Y }` becomes `import { X, type Y }`. */
+function asValueImport(sourceCode, { declaration, specifier }) {
+    return (fixer) => {
+        if (declaration.importKind !== 'type') {
+            return typeKeywordOf(sourceCode, specifier).map((keyword) => fixer.removeRange([
+                keyword.range[0],
+                specifier.local.range[0] > keyword.range[1] ? keyword.range[1] + 1 : keyword.range[1],
+            ]));
+        }
+        const others = declaration.specifiers.filter((other) => other !== specifier && other.type === AST_NODE_TYPES.ImportSpecifier);
+        const keyword = sourceCode.getFirstToken(declaration, { skip: 1 });
+        return keyword === null
+            ? []
+            : [
+                fixer.removeRange([keyword.range[0], keyword.range[1] + 1]),
+                ...others.map((other) => fixer.insertTextBefore(other, 'type ')),
+            ];
+    };
+}
+function typeKeywordOf(sourceCode, specifier) {
+    const first = sourceCode.getFirstToken(specifier);
+    return first?.value === 'type' ? [first] : [];
+}
+//# sourceMappingURL=ports-value-import.js.map

package/dist/rules/ports-value-import.js.map

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

package/dist/rules/purity.d.ts

@@ -0,0 +1,4 @@
+export declare const purityNoSystemClock: import("@typescript-eslint/utils/ts-eslint").RuleModule<"imported" | "used", [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+export declare const purityNoAmbientRandomness: import("@typescript-eslint/utils/ts-eslint").RuleModule<"imported" | "used", [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+export declare const purityNoEnvironment: import("@typescript-eslint/utils/ts-eslint").RuleModule<"imported" | "used", [], import("../index.js").RuleDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+//# sourceMappingURL=purity.d.ts.map

package/dist/rules/purity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purity.d.ts","sourceRoot":"","sources":["../../src/rules/purity.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,6KAY9B,CAAC;AAEH,eAAO,MAAM,yBAAyB,6KAwBpC,CAAC;AAEH,eAAO,MAAM,mBAAmB,6KA6B9B,CAAC"}

package/dist/rules/purity.js

@@ -0,0 +1,65 @@
+import { purityRule } from '../support/purity-rule.js';
+export const purityNoSystemClock = purityRule({
+    id: 'purity/no-system-clock',
+    description: 'No new Date() without argument, Date.now(), Date() or performance.now() in domain/ or application/: time comes from the Clock port.',
+    instead: 'Receive the instant as a parameter in the domain, and take it from the Clock port (`this.clock.now()`) in a handler, so that a test fixes time with FixedClock.',
+    members: { Date: ['now'], performance: ['now', 'timeOrigin'] },
+    calls: ['Date'],
+    constructions: [],
+    bareConstructions: ['Date'],
+    modules: [],
+    namedImports: {},
+});
+export const purityNoAmbientRandomness = purityRule({
+    id: 'purity/no-ambient-randomness',
+    description: 'No Math.random, crypto.randomUUID or id library in domain/ or application/: identifiers come from the IdGenerator port.',
+    instead: 'Receive the identifier as a parameter in the domain, and take it from the IdGenerator port (`this.ids.next()`) in a handler, so that a test gets predictable identifiers.',
+    members: { Math: ['random'], crypto: ['randomUUID', 'getRandomValues', 'randomBytes', 'randomInt'] },
+    calls: ['randomUUID'],
+    constructions: [],
+    bareConstructions: [],
+    modules: [
+        'uuid',
+        'nanoid',
+        'ulid',
+        'ulidx',
+        'cuid',
+        '@paralleldrive/cuid2',
+        'ksuid',
+        'shortid',
+        'uuidv7',
+        'hyperid',
+        'bson',
+    ],
+    namedImports: { crypto: ['randomUUID', 'getRandomValues', 'randomBytes', 'randomInt', 'webcrypto'] },
+});
+export const purityNoEnvironment = purityRule({
+    id: 'purity/no-environment',
+    description: 'No process.env, console, file system or network access in domain/ or application/.',
+    instead: 'Declare what is needed as a port in application/ports (a configuration value object, a logger, a gateway), implement it in infrastructure/ and bind it in the module file.',
+    members: { process: ['env', 'argv', 'cwd', 'exit', 'stdout', 'stderr', 'stdin'], console: [] },
+    calls: ['fetch'],
+    constructions: ['XMLHttpRequest', 'WebSocket', 'EventSource'],
+    bareConstructions: [],
+    modules: [
+        'fs',
+        'http',
+        'https',
+        'http2',
+        'net',
+        'dgram',
+        'dns',
+        'tls',
+        'child_process',
+        'worker_threads',
+        'os',
+        'readline',
+        'axios',
+        'node-fetch',
+        'undici',
+        'got',
+        'dotenv',
+    ],
+    namedImports: {},
+});
+//# sourceMappingURL=purity.js.map

package/dist/rules/purity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purity.js","sourceRoot":"","sources":["../../src/rules/purity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;IAC5C,EAAE,EAAE,wBAAwB;IAC5B,WAAW,EACT,qIAAqI;IACvI,OAAO,EACL,iKAAiK;IACnK,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE;IAC9D,KAAK,EAAE,CAAC,MAAM,CAAC;IACf,aAAa,EAAE,EAAE;IACjB,iBAAiB,EAAE,CAAC,MAAM,CAAC;IAC3B,OAAO,EAAE,EAAE;IACX,YAAY,EAAE,EAAE;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC;IAClD,EAAE,EAAE,8BAA8B;IAClC,WAAW,EACT,yHAAyH;IAC3H,OAAO,EACL,2KAA2K;IAC7K,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE;IACpG,KAAK,EAAE,CAAC,YAAY,CAAC;IACrB,aAAa,EAAE,EAAE;IACjB,iBAAiB,EAAE,EAAE;IACrB,OAAO,EAAE;QACP,MAAM;QACN,QAAQ;QACR,MAAM;QACN,OAAO;QACP,MAAM;QACN,sBAAsB;QACtB,OAAO;QACP,SAAS;QACT,QAAQ;QACR,SAAS;QACT,MAAM;KACP;IACD,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE;CACrG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;IAC5C,EAAE,EAAE,uBAAuB;IAC3B,WAAW,EAAE,oFAAoF;IACjG,OAAO,EACL,4KAA4K;IAC9K,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;IAC9F,KAAK,EAAE,CAAC,OAAO,CAAC;IAChB,aAAa,EAAE,CAAC,gBAAgB,EAAE,WAAW,EAAE,aAAa,CAAC;IAC7D,iBAAiB,EAAE,EAAE;IACrB,OAAO,EAAE;QACP,IAAI;QACJ,MAAM;QACN,OAAO;QACP,OAAO;QACP,KAAK;QACL,OAAO;QACP,KAAK;QACL,KAAK;QACL,eAAe;QACf,gBAAgB;QAChB,IAAI;QACJ,UAAU;QACV,OAAO;QACP,YAAY;QACZ,QAAQ;QACR,KAAK;QACL,QAAQ;KACT;IACD,YAAY,EAAE,EAAE;CACjB,CAAC,CAAC"}

package/dist/rules/rules.d.ts

@@ -0,0 +1,4 @@
+import { type DddRule } from '../support/rule/docs-of.js';
+/** Keyed by ESLint name: the id of docs/ARCHITECTURE.md with its slash replaced by a dash, or the name of a companion rule. */
+export declare const rules: Readonly<Record<string, DddRule>>;
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/rules/rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAoGlE,+HAA+H;AAC/H,eAAO,MAAM,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEnD,CAAC"}

package/dist/rules/rules.js

@@ -0,0 +1,97 @@
+import { docsOf } from '../support/rule/docs-of.js';
+import { applicationCommandQuerySeparation } from './application-command-query-separation.js';
+import { applicationHandlerShape } from './application-handler-shape.js';
+import { aspectsOutsideIn } from './aspects-outside-in.js';
+import { authzActorExplicit } from './authz-actor-explicit.js';
+import { authzDeclared } from './authz-declared.js';
+import { authzInApplication } from './authz-in-application.js';
+import { cleanFileSize } from './clean-file-size.js';
+import { cleanFunctionCeiling } from './clean-function-ceiling.js';
+import { cleanFunctionSize } from './clean-function-size.js';
+import { cleanNoCommentedOutCode } from './clean-no-commented-out-code.js';
+import { cleanNoEscapeHatch } from './clean-no-escape-hatch.js';
+import { cleanNoFlagArgument } from './clean-no-flag-argument.js';
+import { cleanNoHashPrivate } from './clean-no-hash-private.js';
+import { cleanNoNoiseComment } from './clean-no-noise-comment.js';
+import { cleanOneExportPerFile } from './clean-one-export-per-file.js';
+import { cleanStepdown } from './clean-stepdown.js';
+import { contextExtractable } from './context-extractable.js';
+import { contextDeclaredRelationship, contextPublishedLanguageIsAContract, contextPublishedLanguageOnly, } from './context-boundaries.js';
+import { declarationsRoleDeclared } from './declarations-role-declared.js';
+import { domainAggregateEncapsulation } from './domain-aggregate-encapsulation.js';
+import { domainEventsDispatchedOnSave } from './domain-events-dispatched-on-save.js';
+import { domainEventsTransactionalBeforeCommit } from './domain-events-transactional-before-commit.js';
+import { domainNoGenericError } from './domain-no-generic-error.js';
+import { domainValueObjectImmutability } from './domain-value-object-immutability.js';
+import { eventsConsumerIdempotent } from './events-consumer-idempotent.js';
+import { eventsNameFormat } from './events-name-format.js';
+import { eventsOutboxRequired } from './events-outbox-required.js';
+import { governanceRecordedDeviation } from './governance-recorded-deviation.js';
+import { importsAliasOnly } from './imports-alias-only.js';
+import { layerApplicationInward } from './layer-application-inward.js';
+import { layerDomainPurity } from './layer-domain-purity.js';
+import { layerInfrastructureNoPresentation, layerPresentationNoInfrastructure } from './layer-sideways.js';
+import { portsAbstractClass } from './ports-abstract-class.js';
+import { portsImplementsNeverExtends } from './ports-implements-never-extends.js';
+import { portsNoConcreteDependency } from './ports-no-concrete-dependency.js';
+import { portsNoTokenConstant } from './ports-no-token-constant.js';
+import { portsValueImport } from './ports-value-import.js';
+import { purityNoAmbientRandomness, purityNoEnvironment, purityNoSystemClock } from './purity.js';
+import { schedulingJobName } from './scheduling-job-name.js';
+import { schedulingJobTriggersUseCase } from './scheduling-job-triggers-use-case.js';
+import { standardNoParallelInterface } from './standard-no-parallel-interface.js';
+import { testNoMocks } from './test-no-mocks.js';
+import { tracingPlatformOnly } from './tracing-platform-only.js';
+const ALL = [
+    layerDomainPurity,
+    layerApplicationInward,
+    layerPresentationNoInfrastructure,
+    layerInfrastructureNoPresentation,
+    contextPublishedLanguageOnly,
+    contextDeclaredRelationship,
+    contextPublishedLanguageIsAContract,
+    purityNoSystemClock,
+    purityNoAmbientRandomness,
+    purityNoEnvironment,
+    cleanStepdown,
+    cleanFunctionSize,
+    cleanFunctionCeiling,
+    cleanNoFlagArgument,
+    cleanNoCommentedOutCode,
+    cleanNoNoiseComment,
+    cleanNoEscapeHatch,
+    cleanNoHashPrivate,
+    cleanOneExportPerFile,
+    cleanFileSize,
+    domainAggregateEncapsulation,
+    domainValueObjectImmutability,
+    domainNoGenericError,
+    applicationHandlerShape,
+    applicationCommandQuerySeparation,
+    domainEventsDispatchedOnSave,
+    domainEventsTransactionalBeforeCommit,
+    testNoMocks,
+    eventsNameFormat,
+    eventsOutboxRequired,
+    eventsConsumerIdempotent,
+    contextExtractable,
+    authzDeclared,
+    authzInApplication,
+    authzActorExplicit,
+    aspectsOutsideIn,
+    tracingPlatformOnly,
+    standardNoParallelInterface,
+    governanceRecordedDeviation,
+    declarationsRoleDeclared,
+    portsAbstractClass,
+    portsImplementsNeverExtends,
+    portsNoTokenConstant,
+    portsNoConcreteDependency,
+    portsValueImport,
+    schedulingJobTriggersUseCase,
+    schedulingJobName,
+    importsAliasOnly,
+];
+/** Keyed by ESLint name: the id of docs/ARCHITECTURE.md with its slash replaced by a dash, or the name of a companion rule. */
+export const rules = Object.fromEntries(ALL.map((rule) => [docsOf(rule).name, rule]));
+//# sourceMappingURL=rules.js.map

package/dist/rules/rules.js.map

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

package/dist/rules/scheduling-job-name.d.ts

@@ -0,0 +1,5 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+type MessageId = 'notLiteral' | 'format' | 'context' | 'actor';
+export declare const schedulingJobName: TSESLint.RuleModule<MessageId, [], import("../index.js").RuleDocs, TSESLint.RuleListener>;
+export {};
+//# sourceMappingURL=scheduling-job-name.d.ts.map

package/dist/rules/scheduling-job-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling-job-name.d.ts","sourceRoot":"","sources":["../../src/rules/scheduling-job-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAiB,MAAM,0BAA0B,CAAC;AAUxF,KAAK,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAQ/D,eAAO,MAAM,iBAAiB,2FA6C5B,CAAC"}

package/dist/rules/scheduling-job-name.js

@@ -0,0 +1,98 @@
+import { AST_NODE_TYPES } from '@typescript-eslint/utils';
+import { calleeName } from '../support/calls/callee-name.js';
+import { declarationReader } from '../support/declarations/declaration-reader.js';
+import { defineRule } from '../support/rule/define-rule.js';
+import { descendants } from '../support/descendants.js';
+import { inContext } from '../support/imports/in-context.js';
+import { staticString } from '../support/imports/static-string.js';
+import { registeredJob } from '../support/scheduling/registered-job.js';
+const JOB_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*\.[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const WHY = 'The name of a job is its identity: the lock of its occurrences, its settings, its metrics and its system actor are keyed by it, so it is written once and never derived.';
+export const schedulingJobName = defineRule({
+    id: 'scheduling/job-name',
+    type: 'problem',
+    recommended: 'error',
+    description: 'A job is named `<context>.<job-name>` by a string literal, and its system actor carries that same name.',
+    messages: {
+        notLiteral: `The name of this job is not a string literal. ${WHY} Write \`'{{context}}.<job-name>'\` in lower-case kebab-case.`,
+        format: `"{{name}}" is not a job name. ${WHY} Write \`'{{context}}.<job-name>'\`: two segments in lower-case kebab-case, the context then the job.`,
+        context: `The job "{{name}}" is declared in the context "{{context}}". ${WHY} Write \`'{{context}}.{{job}}'\`: a job is named after the context it belongs to and leaves with it when the context is extracted.`,
+        actor: 'This job runs as `systemActor({{given}})` but is named "{{name}}". Write `systemActor(\'{{name}}\')`: the audit trail and the logs then name the job that acted.',
+    },
+    create({ file, sourceCode, report }) {
+        const context = inContext(file)?.context;
+        const declarationsOf = declarationReader(sourceCode.ast);
+        const judging = { context, declared: [], report };
+        const judgeClass = (node) => {
+            for (const declaration of declarationsOf(node).filter((candidate) => candidate.name === 'Scheduled')) {
+                judgeName(judging, declaration.arguments[0], declaration.node);
+            }
+        };
+        return {
+            ClassDeclaration: judgeClass,
+            ClassExpression: judgeClass,
+            CallExpression(node) {
+                const job = file.isTest ? undefined : registeredJob(node);
+                if (job !== undefined) {
+                    judgeName(judging, job.registration.arguments[0], job.registration);
+                }
+            },
+            'Program:exit'(program) {
+                if (!file.path.endsWith('.job.ts') || file.isTest) {
+                    return;
+                }
+                for (const finding of actorDefects(program, judging.declared[0], context)) {
+                    report(finding);
+                }
+            },
+        };
+    },
+});
+function judgeName(judging, node, at) {
+    const name = node === undefined ? undefined : staticString(node);
+    if (name !== undefined) {
+        judging.declared.push(name);
+    }
+    const finding = nameDefect(name, judging.context);
+    if (finding !== undefined) {
+        judging.report({ ...finding, node: node ?? at });
+    }
+}
+function nameDefect(name, context) {
+    const here = context ?? '<context>';
+    if (name === undefined) {
+        return { messageId: 'notLiteral', data: { context: here } };
+    }
+    if (!JOB_NAME.test(name)) {
+        return { messageId: 'format', data: { name, context: here } };
+    }
+    const [owner = '', job = ''] = name.split('.');
+    return context === undefined || owner === context
+        ? undefined
+        : { messageId: 'context', data: { name, context, job } };
+}
+/** Every `systemActor(..)` of a job file passes the name the job is declared with; without a declaration in the file, a name of its context. */
+function actorDefects(program, declared, context) {
+    const calls = [...descendants(program)].flatMap((node) => node.type === AST_NODE_TYPES.CallExpression && calleeName(node) === 'systemActor' ? [node] : []);
+    return calls.flatMap((call) => actorDefect(call, declared, context));
+}
+function actorDefect(call, declared, context) {
+    const [given] = call.arguments;
+    const name = given === undefined ? undefined : staticString(given);
+    const expected = declared ?? jobNameOf(name, context) ?? `${context ?? '<context>'}.<job-name>`;
+    if (name === expected) {
+        return [];
+    }
+    return [
+        {
+            node: given ?? call,
+            messageId: 'actor',
+            data: { given: name === undefined ? '..' : `'${name}'`, name: expected },
+        },
+    ];
+}
+/** The name itself, when it is a job name of the context: what an explicit-style job file is held to. */
+function jobNameOf(name, context) {
+    return name !== undefined && nameDefect(name, context) === undefined ? name : undefined;
+}
+//# sourceMappingURL=scheduling-job-name.js.map

package/dist/rules/scheduling-job-name.js.map

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

package/dist/rules/scheduling-job-triggers-use-case.d.ts

@@ -0,0 +1,5 @@
+import { type TSESLint } from '@typescript-eslint/utils';
+type MessageId = 'notAJob' | 'noCommand' | 'repository' | 'model' | 'misplaced';
+export declare const schedulingJobTriggersUseCase: TSESLint.RuleModule<MessageId, [], import("../index.js").RuleDocs, TSESLint.RuleListener>;
+export {};
+//# sourceMappingURL=scheduling-job-triggers-use-case.d.ts.map

package/dist/rules/scheduling-job-triggers-use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling-job-triggers-use-case.d.ts","sourceRoot":"","sources":["../../src/rules/scheduling-job-triggers-use-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,QAAQ,EAAiB,MAAM,0BAA0B,CAAC;AAoBxF,KAAK,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,GAAG,WAAW,CAAC;AAUhF,eAAO,MAAM,4BAA4B,2FAsBvC,CAAC"}