eslint-plugin-modularity 2.1.7 → 2.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -146,7 +146,7 @@ export function format(data: Data): FormattedData {
146
146
  ## 📦 Compatibility
147
147
  | Package | Version |
148
148
  | :--- | :--- |
149
- | ESLint | `^8.0.0 \|\| ^9.0.0 \|\| ^10.0.0` |
149
+ | ESLint | `^8.40.0 \|\| ^9.0.0 \|\| ^10.0.0` |
150
150
  | Node.js | `>=18.0.0` |
151
151
 
152
152
  See the [ESLint Version Support Policy](../../docs/ESLINT_VERSION_SUPPORT.md) — current ecosystem share data, the 20% gate, and the forward-looking exception that covers v10.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "eslint-plugin-modularity",
3
- "version": "2.1.7",
3
+ "version": "2.1.9",
4
4
  "description": "ESLint plugin for module architecture — enforces DDD value objects and anemic-model checks, naming, REST conventions, and utility isolation.",
5
5
  "type": "commonjs",
6
6
  "main": "./src/index.js",
@@ -58,10 +58,10 @@
58
58
  "node": ">=18.0.0"
59
59
  },
60
60
  "dependencies": {
61
- "@interlace/eslint-devkit": "^1.10.0"
61
+ "@interlace/eslint-devkit": "^1.11.0"
62
62
  },
63
63
  "peerDependencies": {
64
- "eslint": "^8.0.0 || ^9.0.0 || ^10.0.0"
64
+ "eslint": "^8.40.0 || ^9.0.0 || ^10.0.0"
65
65
  },
66
66
  "funding": {
67
67
  "type": "github",
package/src/index.js CHANGED
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.configs=exports.plugin=exports.rules=void 0;exports.rules={get"ddd-anemic-domain-model"(){return require("./rules/ddd-anemic-domain-model").dddAnemicDomainModel},get"ddd-value-object-immutability"(){return require("./rules/ddd-value-object-immutability").dddValueObjectImmutability},get"enforce-naming"(){return require("./rules/enforce-naming").enforceNaming},get"enforce-rest-conventions"(){return require("./rules/enforce-rest-conventions").enforceRestConventions},get"no-external-api-calls-in-utils"(){return require("./rules/no-external-api-calls-in-utils").noExternalApiCallsInUtils},get"no-mutable-exports"(){return require("./rules/no-mutable-exports").noMutableExports}};exports.plugin={meta:{name:"eslint-plugin-modularity",version:"2.1.7"},rules:exports.rules};const recommendedRules={"modularity/ddd-anemic-domain-model":"warn","modularity/ddd-value-object-immutability":"error","modularity/enforce-naming":"warn","modularity/enforce-rest-conventions":"error","modularity/no-external-api-calls-in-utils":"error","modularity/no-mutable-exports":"warn"};exports.configs={recommended:{plugins:{"modularity":exports.plugin},rules:recommendedRules},strict:{plugins:{"modularity":exports.plugin},rules:Object.fromEntries(Object.keys(exports.rules).map(ruleName=>[`modularity/${ruleName}`,"error"]))}};exports.default=exports.plugin;
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.configs=exports.plugin=exports.rules=void 0;exports.rules={get"ddd-anemic-domain-model"(){return require("./rules/ddd-anemic-domain-model").dddAnemicDomainModel},get"ddd-value-object-immutability"(){return require("./rules/ddd-value-object-immutability").dddValueObjectImmutability},get"enforce-naming"(){return require("./rules/enforce-naming").enforceNaming},get"enforce-rest-conventions"(){return require("./rules/enforce-rest-conventions").enforceRestConventions},get"no-external-api-calls-in-utils"(){return require("./rules/no-external-api-calls-in-utils").noExternalApiCallsInUtils},get"no-mutable-exports"(){return require("./rules/no-mutable-exports").noMutableExports}};exports.plugin={meta:{name:"eslint-plugin-modularity",version:"2.1.9"},rules:exports.rules};const recommendedRules={"modularity/ddd-anemic-domain-model":"warn","modularity/ddd-value-object-immutability":"error","modularity/enforce-naming":"warn","modularity/enforce-rest-conventions":"error","modularity/no-external-api-calls-in-utils":"error","modularity/no-mutable-exports":"warn"};exports.configs={recommended:{plugins:{"modularity":exports.plugin},rules:recommendedRules},strict:{plugins:{"modularity":exports.plugin},rules:Object.fromEntries(Object.keys(exports.rules).map(ruleName=>[`modularity/${ruleName}`,"error"]))}};exports.default=exports.plugin;
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.dddAnemicDomainModel=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");const eslint_devkit_2=require("@interlace/eslint-devkit");function isDto(className,dtoPatterns){return dtoPatterns.some(pattern=>className.includes(pattern))}function isSimpleGetterSetter(member){if(member.value.type!=="FunctionExpression"){return false}const methodName=member.key.type==="Identifier"?member.key.name:"";const body=member.value.body;if(body.type!=="BlockStatement"||body.body.length===0){return false}if(methodName.startsWith("get")&&body.body.length===1){const statement=body.body[0];if(statement.type==="ReturnStatement"&&statement.argument){return true}}if(methodName.startsWith("set")&&body.body.length===1){const statement=body.body[0];if(statement.type==="ExpressionStatement"&&statement.expression.type==="AssignmentExpression"){return true}}return false}function isPureDelegation(member){if(member.value.type!=="FunctionExpression"){return false}const body=member.value.body;if(body.type!=="BlockStatement"||body.body.length!==1){return false}const statement=body.body[0];const builtInMethods=new Set(["map","filter","reduce","forEach","find","findIndex","some","every","includes","indexOf","slice","concat","join","sort","reverse","push","pop","shift","unshift","splice","flat","flatMap","toString","valueOf","toJSON"]);if(statement.type==="ReturnStatement"&&statement.argument){const arg=statement.argument;if(arg.type==="CallExpression"&&arg.callee.type==="MemberExpression"){const callee=arg.callee;const methodName=callee.property.type==="Identifier"?callee.property.name:"";if(builtInMethods.has(methodName)){return false}const object=callee.object;if(object.type==="MemberExpression"&&object.object.type==="ThisExpression"){const propName=object.property.type==="Identifier"?object.property.name:"";if(propName.includes("repository")||propName.includes("service")||propName.includes("api")||propName.includes("client")||propName.includes("dao")||propName.includes("Repository")||propName.includes("Service")||propName.includes("Api")){return true}return false}if(object.type==="Identifier"){return true}}}if(statement.type==="ExpressionStatement"){const expr=statement.expression;if(expr.type==="CallExpression"&&expr.callee.type==="MemberExpression"){const callee=expr.callee;const methodName=callee.property.type==="Identifier"?callee.property.name:"";if(builtInMethods.has(methodName)){return false}const object=callee.object;if(object.type==="MemberExpression"&&object.object.type==="ThisExpression"){const propName=object.property.type==="Identifier"?object.property.name:"";if(propName.includes("repository")||propName.includes("service")||propName.includes("api")||propName.includes("client")||propName.includes("dao")||propName.includes("Repository")||propName.includes("Service")||propName.includes("Api")){return true}return false}}}return false}function countBusinessMethods(node){let count=0;for(const member of node.body.body){if(member.type==="MethodDefinition"){const methodName=member.key.type==="Identifier"?member.key.name:"";if(member.kind==="get"||member.kind==="set"){continue}if(methodName==="constructor"){continue}if(isSimpleGetterSetter(member)){continue}if(isPureDelegation(member)){continue}const valueType=member.value.type;if(valueType==="FunctionExpression"||valueType==="ArrowFunctionExpression"){count++}}else if(member.type==="PropertyDefinition"){continue}}return count}exports.dddAnemicDomainModel=(0,eslint_devkit_2.createRule)({name:"ddd-anemic-domain-model",meta:{type:"suggestion",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-modularity/docs/rules/ddd-anemic-domain-model.md",description:"Detects entities with only getters/setters and no business logic"},messages:{anemicDomainModel:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.ARCHITECTURE,issueName:"Anemic domain model",description:"Class {{className}} has no business logic (only getters/setters)",severity:"MEDIUM",fix:"Add business logic methods to create a rich domain model",documentationLink:"https://martinfowler.com/bliki/AnemicDomainModel.html"}),addBusinessLogic:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Add Business Logic",description:"Add business logic methods",severity:"LOW",fix:"Add domain behavior methods to {{className}}",documentationLink:"https://martinfowler.com/bliki/AnemicDomainModel.html"}),migrateToRichModel:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Migrate to Rich Model",description:"Migrate to rich domain model",severity:"LOW",fix:"Encapsulate behavior with data",documentationLink:"https://martinfowler.com/bliki/AnemicDomainModel.html"}),identifyAggregateRoot:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Identify Aggregate Root",description:"Identify aggregate root and enforce invariants",severity:"LOW",fix:"Define aggregate boundaries and enforce invariants",documentationLink:"https://martinfowler.com/bliki/DDD_Aggregate.html"})},schema:[{type:"object",properties:{minBusinessMethods:{type:"number",default:1,minimum:0,description:"Minimum business methods required"},ignoreDtos:{type:"boolean",default:true,description:"Ignore DTOs and data transfer objects"},dtoPatterns:{type:"array",items:{type:"string"},default:["DTO","Dto","Data","Request","Response","Payload"],description:"Patterns for DTO identification"}},additionalProperties:false}]},defaultOptions:[{minBusinessMethods:1,ignoreDtos:true,dtoPatterns:["DTO","Dto","Data","Request","Response","Payload"]}],create(context,[options={}]){const{minBusinessMethods=1,ignoreDtos=true,dtoPatterns=["DTO","Dto","Data","Request","Response","Payload"]}=options||{};function checkClass(node){if(!node.id){return}const className=node.id.name;if(ignoreDtos&&isDto(className,dtoPatterns)){return}const businessMethodCount=countBusinessMethods(node);if(businessMethodCount<minBusinessMethods){context.report({node,messageId:"anemicDomainModel",data:{className},suggest:[{messageId:"addBusinessLogic",fix:()=>null,data:{className}},{messageId:"migrateToRichModel",fix:()=>null},{messageId:"identifyAggregateRoot",fix:()=>null}]})}}return{ClassDeclaration:checkClass,ClassExpression:checkClass}}});
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.dddAnemicDomainModel=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");const eslint_devkit_2=require("@interlace/eslint-devkit");function isDto(className,dtoPatterns){return dtoPatterns.some(pattern=>className.includes(pattern))}function isSimpleGetterSetter(member){if(member.value.type!=="FunctionExpression"){return false}const methodName=member.key.type==="Identifier"?member.key.name:"";const body=member.value.body;if(body.type!=="BlockStatement"||body.body.length===0){return false}if(methodName.startsWith("get")&&body.body.length===1){const statement=body.body[0];if(statement.type==="ReturnStatement"&&statement.argument){return true}}if(methodName.startsWith("set")&&body.body.length===1){const statement=body.body[0];if(statement.type==="ExpressionStatement"&&statement.expression.type==="AssignmentExpression"){return true}}return false}function isPureDelegation(member){if(member.value.type!=="FunctionExpression"){return false}const body=member.value.body;if(body.type!=="BlockStatement"||body.body.length!==1){return false}const statement=body.body[0];const builtInMethods=new Set(["map","filter","reduce","forEach","find","findIndex","some","every","includes","indexOf","slice","concat","join","sort","reverse","push","pop","shift","unshift","splice","flat","flatMap","toString","valueOf","toJSON"]);if(statement.type==="ReturnStatement"&&statement.argument){const arg=statement.argument;if(arg.type==="CallExpression"&&arg.callee.type==="MemberExpression"){const callee=arg.callee;const methodName=callee.property.type==="Identifier"?callee.property.name:"";if(builtInMethods.has(methodName)){return false}const object=callee.object;if(object.type==="MemberExpression"&&object.object.type==="ThisExpression"){const propName=object.property.type==="Identifier"?object.property.name:"";if(propName.includes("repository")||propName.includes("service")||propName.includes("api")||propName.includes("client")||propName.includes("dao")||propName.includes("Repository")||propName.includes("Service")||propName.includes("Api")){return true}return false}if(object.type==="Identifier"){return true}}}if(statement.type==="ExpressionStatement"){const expr=statement.expression;if(expr.type==="CallExpression"&&expr.callee.type==="MemberExpression"){const callee=expr.callee;const methodName=callee.property.type==="Identifier"?callee.property.name:"";if(builtInMethods.has(methodName)){return false}const object=callee.object;if(object.type==="MemberExpression"&&object.object.type==="ThisExpression"){const propName=object.property.type==="Identifier"?object.property.name:"";if(propName.includes("repository")||propName.includes("service")||propName.includes("api")||propName.includes("client")||propName.includes("dao")||propName.includes("Repository")||propName.includes("Service")||propName.includes("Api")){return true}return false}}}return false}function countBusinessMethods(node){let count=0;for(const member of node.body.body){if(member.type==="MethodDefinition"){const methodName=member.key.type==="Identifier"?member.key.name:"";if(member.kind==="get"||member.kind==="set"){continue}if(methodName==="constructor"){continue}if(isSimpleGetterSetter(member)){continue}if(isPureDelegation(member)){continue}const valueType=member.value.type;if(valueType==="FunctionExpression"||valueType==="ArrowFunctionExpression"){count++}}else if(member.type==="PropertyDefinition"){continue}}return count}exports.dddAnemicDomainModel=(0,eslint_devkit_2.createRule)({name:"ddd-anemic-domain-model",meta:{type:"suggestion",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-modularity/docs/rules/ddd-anemic-domain-model.md",description:"Detects entities with only getters/setters and no business logic"},hasSuggestions:true,messages:{anemicDomainModel:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.ARCHITECTURE,issueName:"Anemic domain model",description:"Class {{className}} has no business logic (only getters/setters)",severity:"MEDIUM",fix:"Add business logic methods to create a rich domain model",documentationLink:"https://martinfowler.com/bliki/AnemicDomainModel.html"}),addBusinessLogic:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Add Business Logic",description:"Add business logic methods",severity:"LOW",fix:"Add domain behavior methods to {{className}}",documentationLink:"https://martinfowler.com/bliki/AnemicDomainModel.html"}),migrateToRichModel:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Migrate to Rich Model",description:"Migrate to rich domain model",severity:"LOW",fix:"Encapsulate behavior with data",documentationLink:"https://martinfowler.com/bliki/AnemicDomainModel.html"}),identifyAggregateRoot:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Identify Aggregate Root",description:"Identify aggregate root and enforce invariants",severity:"LOW",fix:"Define aggregate boundaries and enforce invariants",documentationLink:"https://martinfowler.com/bliki/DDD_Aggregate.html"})},schema:[{type:"object",properties:{minBusinessMethods:{type:"number",default:1,minimum:0,description:"Minimum business methods required"},ignoreDtos:{type:"boolean",default:true,description:"Ignore DTOs and data transfer objects"},dtoPatterns:{type:"array",items:{type:"string"},default:["DTO","Dto","Data","Request","Response","Payload"],description:"Patterns for DTO identification"}},additionalProperties:false}]},defaultOptions:[{minBusinessMethods:1,ignoreDtos:true,dtoPatterns:["DTO","Dto","Data","Request","Response","Payload"]}],create(context,[options={}]){const{minBusinessMethods=1,ignoreDtos=true,dtoPatterns=["DTO","Dto","Data","Request","Response","Payload"]}=options||{};function checkClass(node){if(!node.id){return}const className=node.id.name;if(ignoreDtos&&isDto(className,dtoPatterns)){return}const businessMethodCount=countBusinessMethods(node);if(businessMethodCount<minBusinessMethods){context.report({node,messageId:"anemicDomainModel",data:{className},suggest:[{messageId:"addBusinessLogic",fix:()=>null,data:{className}},{messageId:"migrateToRichModel",fix:()=>null},{messageId:"identifyAggregateRoot",fix:()=>null}]})}}return{ClassDeclaration:checkClass,ClassExpression:checkClass}}});
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.dddValueObjectImmutability=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");const eslint_devkit_2=require("@interlace/eslint-devkit");function isValueObject(className,patterns){return patterns.some(pattern=>className.includes(pattern))}function hasReadonlyModifier(node){return node.readonly===true}function usesObjectFreeze(node){for(const member of node.body.body){if(member.type==="MethodDefinition"&&member.kind==="constructor"){const constructor=member.value;if(constructor.type==="FunctionExpression"){const body=constructor.body;if(body.type==="BlockStatement"){for(const statement of body.body){if(statement.type==="ExpressionStatement"&&statement.expression.type==="CallExpression"&&statement.expression.callee.type==="MemberExpression"&&statement.expression.callee.object.type==="Identifier"&&statement.expression.callee.object.name==="Object"&&statement.expression.callee.property.type==="Identifier"&&statement.expression.callee.property.name==="freeze"){return true}}}}}}return false}exports.dddValueObjectImmutability=(0,eslint_devkit_2.createRule)({name:"ddd-value-object-immutability",meta:{type:"suggestion",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-modularity/docs/rules/ddd-value-object-immutability.md",description:"Validates value objects are properly immutable"},messages:{mutableValueObject:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.ARCHITECTURE,issueName:"Mutable value object",description:"Value object {{className}} has mutable properties",severity:"MEDIUM",fix:"Make properties readonly or use Object.freeze",documentationLink:"https://martinfowler.com/bliki/ValueObject.html"}),mutableNestedType:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.ARCHITECTURE,issueName:"Mutable nested type",description:"Value object {{className}} has mutable nested type (array/object) - use Readonly<T> or readonly arrays",severity:"MEDIUM",fix:"Use readonly arrays or Readonly<T> for nested objects",documentationLink:"https://www.typescriptlang.org/docs/handbook/utility-types.html#readonlytype"}),addReadonly:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Add Readonly",description:"Add readonly modifier",severity:"LOW",fix:"readonly propertyName: Type",documentationLink:"https://www.typescriptlang.org/docs/handbook/2/classes.html#readonly"}),useObjectFreeze:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use Object.freeze",description:"Use Object.freeze in constructor",severity:"LOW",fix:"constructor() { Object.freeze(this); }",documentationLink:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze"}),makeImmutable:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Make Immutable",description:"Make value object fully immutable",severity:"LOW",fix:"Add readonly to all properties and freeze object",documentationLink:"https://martinfowler.com/bliki/ValueObject.html"})},schema:[{type:"object",properties:{valueObjectPatterns:{type:"array",items:{type:"string"},default:["Value","VO","ValueObject"],description:"Patterns to identify value objects"},requireReadonly:{type:"boolean",default:true,description:"Require readonly modifiers"},checkObjectFreeze:{type:"boolean",default:true,description:"Check for Object.freeze usage"}},additionalProperties:false}]},defaultOptions:[{valueObjectPatterns:["Value","VO","ValueObject"],requireReadonly:true,checkObjectFreeze:true}],create(context,[options={}]){const{valueObjectPatterns=["Value","VO","ValueObject"],requireReadonly=true,checkObjectFreeze=true}=options||{};function checkClass(node){if(!node.id){return}const className=node.id.name;if(!isValueObject(className,valueObjectPatterns)){return}if(checkObjectFreeze&&usesObjectFreeze(node)){return}const mutableProperties=[];for(const member of node.body.body){if(member.type==="PropertyDefinition"){if(requireReadonly&&!hasReadonlyModifier(member)){mutableProperties.push(member)}}}if(mutableProperties.length>0){context.report({node,messageId:"mutableValueObject",data:{className},suggest:[{messageId:"addReadonly",fix:()=>null},{messageId:"useObjectFreeze",fix:()=>null},{messageId:"makeImmutable",fix:()=>null}]})}}return{ClassDeclaration:checkClass,ClassExpression:checkClass}}});
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.dddValueObjectImmutability=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");const eslint_devkit_2=require("@interlace/eslint-devkit");function isValueObject(className,patterns){return patterns.some(pattern=>className.includes(pattern))}function hasReadonlyModifier(node){return node.readonly===true}function usesObjectFreeze(node){for(const member of node.body.body){if(member.type==="MethodDefinition"&&member.kind==="constructor"){const constructor=member.value;if(constructor.type==="FunctionExpression"){const body=constructor.body;if(body.type==="BlockStatement"){for(const statement of body.body){if(statement.type==="ExpressionStatement"&&statement.expression.type==="CallExpression"&&statement.expression.callee.type==="MemberExpression"&&statement.expression.callee.object.type==="Identifier"&&statement.expression.callee.object.name==="Object"&&statement.expression.callee.property.type==="Identifier"&&statement.expression.callee.property.name==="freeze"){return true}}}}}}return false}exports.dddValueObjectImmutability=(0,eslint_devkit_2.createRule)({name:"ddd-value-object-immutability",meta:{type:"suggestion",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-modularity/docs/rules/ddd-value-object-immutability.md",description:"Validates value objects are properly immutable"},hasSuggestions:true,messages:{mutableValueObject:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.ARCHITECTURE,issueName:"Mutable value object",description:"Value object {{className}} has mutable properties",severity:"MEDIUM",fix:"Make properties readonly or use Object.freeze",documentationLink:"https://martinfowler.com/bliki/ValueObject.html"}),mutableNestedType:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.ARCHITECTURE,issueName:"Mutable nested type",description:"Value object {{className}} has mutable nested type (array/object) - use Readonly<T> or readonly arrays",severity:"MEDIUM",fix:"Use readonly arrays or Readonly<T> for nested objects",documentationLink:"https://www.typescriptlang.org/docs/handbook/utility-types.html#readonlytype"}),addReadonly:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Add Readonly",description:"Add readonly modifier",severity:"LOW",fix:"readonly propertyName: Type",documentationLink:"https://www.typescriptlang.org/docs/handbook/2/classes.html#readonly"}),useObjectFreeze:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use Object.freeze",description:"Use Object.freeze in constructor",severity:"LOW",fix:"constructor() { Object.freeze(this); }",documentationLink:"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze"}),makeImmutable:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Make Immutable",description:"Make value object fully immutable",severity:"LOW",fix:"Add readonly to all properties and freeze object",documentationLink:"https://martinfowler.com/bliki/ValueObject.html"})},schema:[{type:"object",properties:{valueObjectPatterns:{type:"array",items:{type:"string"},default:["Value","VO","ValueObject"],description:"Patterns to identify value objects"},requireReadonly:{type:"boolean",default:true,description:"Require readonly modifiers"},checkObjectFreeze:{type:"boolean",default:true,description:"Check for Object.freeze usage"}},additionalProperties:false}]},defaultOptions:[{valueObjectPatterns:["Value","VO","ValueObject"],requireReadonly:true,checkObjectFreeze:true}],create(context,[options={}]){const{valueObjectPatterns=["Value","VO","ValueObject"],requireReadonly=true,checkObjectFreeze=true}=options||{};function checkClass(node){if(!node.id){return}const className=node.id.name;if(!isValueObject(className,valueObjectPatterns)){return}if(checkObjectFreeze&&usesObjectFreeze(node)){return}const mutableProperties=[];for(const member of node.body.body){if(member.type==="PropertyDefinition"){if(requireReadonly&&!hasReadonlyModifier(member)){mutableProperties.push(member)}}}if(mutableProperties.length>0){context.report({node,messageId:"mutableValueObject",data:{className},suggest:[{messageId:"addReadonly",fix:()=>null},{messageId:"useObjectFreeze",fix:()=>null},{messageId:"makeImmutable",fix:()=>null}]})}}return{ClassDeclaration:checkClass,ClassExpression:checkClass}}});
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.enforceRestConventions=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");const eslint_devkit_2=require("@interlace/eslint-devkit");exports.enforceRestConventions=(0,eslint_devkit_2.createRule)({name:"enforce-rest-conventions",meta:{type:"suggestion",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-modularity/docs/rules/enforce-rest-conventions.md",description:"Validates REST endpoint design against best practices"},messages:{restConventionViolation:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.ARCHITECTURE,issueName:"REST convention violation",description:"{{violation}}: {{details}}",severity:"MEDIUM",fix:"Follow RESTful conventions for HTTP methods, status codes, and resource naming",documentationLink:"https://restfulapi.net/"}),useProperHttpMethod:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use HTTP Method",description:"Use proper HTTP method",severity:"LOW",fix:"GET (read), POST (create), PUT/PATCH (update), DELETE (delete)",documentationLink:"https://restfulapi.net/http-methods/"}),useProperStatusCode:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use Status Code",description:"Use appropriate status code",severity:"LOW",fix:"200 (OK), 201 (Created), 204 (No Content), 400 (Bad Request), 404 (Not Found)",documentationLink:"https://restfulapi.net/http-status-codes/"}),fixResourceNaming:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Resource Naming",description:"Use plural nouns for resources",severity:"LOW",fix:"/users, /orders, /products (not /user, /order)",documentationLink:"https://restfulapi.net/resource-naming/"})},schema:[{type:"object",properties:{checkHttpMethods:{type:"boolean",default:true,description:"Check HTTP methods"},checkStatusCodes:{type:"boolean",default:true,description:"Check status codes"},checkResourceNaming:{type:"boolean",default:true,description:"Check resource naming"}},additionalProperties:false}]},defaultOptions:[{checkHttpMethods:true,checkStatusCodes:true,checkResourceNaming:true}],create(context,[options={}]){const{checkStatusCodes=true,checkResourceNaming=true}=options||{};function checkCallExpression(node){if(node.callee.type==="MemberExpression"){const property=node.callee.property;if(property.type==="Identifier"){const methodName=property.name.toLowerCase();const httpMethods=["get","post","put","patch","delete","head","options"];if(httpMethods.includes(methodName)){if(checkResourceNaming&&node.arguments.length>0){const pathArg=node.arguments[0];if(pathArg.type==="Literal"&&typeof pathArg.value==="string"){const path=pathArg.value;if(path.startsWith("/")&&path.length>1){const resource=path.split("/")[1];if(!path.includes(":")&&!resource.endsWith("s")&&resource.length>3){context.report({node:pathArg,messageId:"restConventionViolation",data:{violation:"Resource naming",details:`Resource "${resource}" should be plural (e.g., /users, /orders)`},suggest:[{messageId:"fixResourceNaming",fix:()=>null}]})}}}}}}}if(checkStatusCodes&&node.callee.type==="MemberExpression"){const property=node.callee.property;if(property.type==="Identifier"&&property.name==="status"){}}}return{CallExpression:checkCallExpression}}});
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.enforceRestConventions=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");const eslint_devkit_2=require("@interlace/eslint-devkit");exports.enforceRestConventions=(0,eslint_devkit_2.createRule)({name:"enforce-rest-conventions",meta:{type:"suggestion",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-modularity/docs/rules/enforce-rest-conventions.md",description:"Validates REST endpoint design against best practices"},hasSuggestions:true,messages:{restConventionViolation:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.ARCHITECTURE,issueName:"REST convention violation",description:"{{violation}}: {{details}}",severity:"MEDIUM",fix:"Follow RESTful conventions for HTTP methods, status codes, and resource naming",documentationLink:"https://restfulapi.net/"}),useProperHttpMethod:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use HTTP Method",description:"Use proper HTTP method",severity:"LOW",fix:"GET (read), POST (create), PUT/PATCH (update), DELETE (delete)",documentationLink:"https://restfulapi.net/http-methods/"}),useProperStatusCode:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use Status Code",description:"Use appropriate status code",severity:"LOW",fix:"200 (OK), 201 (Created), 204 (No Content), 400 (Bad Request), 404 (Not Found)",documentationLink:"https://restfulapi.net/http-status-codes/"}),fixResourceNaming:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Resource Naming",description:"Use plural nouns for resources",severity:"LOW",fix:"/users, /orders, /products (not /user, /order)",documentationLink:"https://restfulapi.net/resource-naming/"})},schema:[{type:"object",properties:{checkHttpMethods:{type:"boolean",default:true,description:"Check HTTP methods"},checkStatusCodes:{type:"boolean",default:true,description:"Check status codes"},checkResourceNaming:{type:"boolean",default:true,description:"Check resource naming"}},additionalProperties:false}]},defaultOptions:[{checkHttpMethods:true,checkStatusCodes:true,checkResourceNaming:true}],create(context,[options={}]){const{checkStatusCodes=true,checkResourceNaming=true}=options||{};function checkCallExpression(node){if(node.callee.type==="MemberExpression"){const property=node.callee.property;if(property.type==="Identifier"){const methodName=property.name.toLowerCase();const httpMethods=["get","post","put","patch","delete","head","options"];if(httpMethods.includes(methodName)){if(checkResourceNaming&&node.arguments.length>0){const pathArg=node.arguments[0];if(pathArg.type==="Literal"&&typeof pathArg.value==="string"){const path=pathArg.value;if(path.startsWith("/")&&path.length>1){const resource=path.split("/")[1];if(!path.includes(":")&&!resource.endsWith("s")&&resource.length>3){context.report({node:pathArg,messageId:"restConventionViolation",data:{violation:"Resource naming",details:`Resource "${resource}" should be plural (e.g., /users, /orders)`},suggest:[{messageId:"fixResourceNaming",fix:()=>null}]})}}}}}}}if(checkStatusCodes&&node.callee.type==="MemberExpression"){const property=node.callee.property;if(property.type==="Identifier"&&property.name==="status"){}}}return{CallExpression:checkCallExpression}}});
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noExternalApiCallsInUtils=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");const eslint_devkit_2=require("@interlace/eslint-devkit");function isUtilityFile(filename,patterns){return patterns.some(pattern=>{const regex=new RegExp(pattern.replace(/\*\*/g,".*").replace(/\*/g,"[^/]*"));return regex.test(filename)})}function isNetworkCall(node,networkMethods){if(node.callee.type==="Identifier"){return networkMethods.includes(node.callee.name)}if(node.callee.type==="MemberExpression"&&node.callee.property.type==="Identifier"){const methodName=node.callee.property.name;const objectName=node.callee.object.type==="Identifier"?node.callee.object.name:"";return networkMethods.includes(methodName)||networkMethods.includes(`${objectName}.${methodName}`)}return false}exports.noExternalApiCallsInUtils=(0,eslint_devkit_2.createRule)({name:"no-external-api-calls-in-utils",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-modularity/docs/rules/no-external-api-calls-in-utils.md",description:"Detects network calls in utility functions"},hasSuggestions:true,messages:{externalApiCallInUtils:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.ARCHITECTURE,issueName:"External API call in utils",description:"Network call in utility function - breaks testability",severity:"HIGH",fix:"Use dependency injection for network calls",documentationLink:"https://rules.sonarsource.com/javascript/RSPEC-1075/"}),useDependencyInjection:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use Dependency Injection",description:"Inject API client",severity:"LOW",fix:"function util(apiClient) { return apiClient.get(...) }",documentationLink:"https://en.wikipedia.org/wiki/Dependency_injection"}),extractToService:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Extract to Service",description:"Extract to service layer",severity:"LOW",fix:"Create services/apiService.ts",documentationLink:"https://martinfowler.com/eaaCatalog/serviceLayer.html"}),passApiClient:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Pass API Client",description:"Pass API client as parameter",severity:"LOW",fix:"function util(apiClient, data) { ... }",documentationLink:"https://en.wikipedia.org/wiki/Dependency_injection"})},schema:[{type:"object",properties:{ignoreInTests:{type:"boolean",default:true},networkMethods:{type:"array",items:{type:"string"},default:["fetch","axios","request","http.get","https.get","get","post","put","delete","patch"]},utilityPatterns:{type:"array",items:{type:"string"},default:["**/utils/**","**/helpers/**","**/lib/**"]}},additionalProperties:false}]},defaultOptions:[{ignoreInTests:true,networkMethods:["fetch","axios","request","http.get","https.get","get","post","put","delete","patch"],utilityPatterns:["**/utils/**","**/helpers/**","**/lib/**"]}],create(context,[options={}]){const{ignoreInTests=true,networkMethods=["fetch","axios","request","http.get","https.get","get","post","put","delete","patch"],utilityPatterns=["**/utils/**","**/helpers/**","**/lib/**"]}=options||{};const filename=context.filename;const isTestFile=ignoreInTests&&/\.(test|spec)\.(ts|tsx|js|jsx)$/.test(filename);if(isTestFile){return{}}const isUtility=isUtilityFile(filename,utilityPatterns);if(!isUtility){return{}}function checkCallExpression(node){if(isNetworkCall(node,networkMethods)){context.report({node,messageId:"externalApiCallInUtils",suggest:[{messageId:"useDependencyInjection",fix:()=>null},{messageId:"extractToService",fix:()=>null},{messageId:"passApiClient",fix:()=>null}]})}}return{CallExpression:checkCallExpression}}});
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.noExternalApiCallsInUtils=void 0;const eslint_devkit_1=require("@interlace/eslint-devkit");const eslint_devkit_2=require("@interlace/eslint-devkit");const DEFAULT_HTTP_MODULES=["axios","got","ky","node-fetch","undici","superagent","request","phin","needle","http","https","http2","node:http","node:https","node:http2"];const DEFAULT_NETWORK_METHODS=["get","post","put","patch","delete","head","options","request","fetch","all","stream"];const DEFAULT_UTILITY_PATTERNS=["**/utils/**","**/helpers/**","**/lib/**"];const GLOBAL_CLIENTS=new Set(["fetch"]);const GLOBAL_CLIENT_HOSTS=new Set(["window","globalThis","global","self"]);const AMBIGUOUS_MODULE_NAMES=new Set(["request","got"]);function isUtilityFile(filename,patterns){return patterns.some(pattern=>{const regex=new RegExp(pattern.replace(/\*\*/g,".*").replace(/\*/g,"[^/]*"));return regex.test(filename)})}function rootName(node){let current=node;while(current.type==="MemberExpression"){current=current.object}return current.type==="Identifier"?current.name:null}function requiredModule(node){if(node.type==="CallExpression"&&node.callee.type==="Identifier"&&node.callee.name==="require"&&node.arguments[0]?.type==="Literal"&&typeof node.arguments[0].value==="string"){return node.arguments[0].value}return null}exports.noExternalApiCallsInUtils=(0,eslint_devkit_2.createRule)({name:"no-external-api-calls-in-utils",meta:{type:"problem",docs:{url:"https://github.com/ofri-peretz/eslint/blob/main/packages/eslint-plugin-modularity/docs/rules/no-external-api-calls-in-utils.md",description:"Detects network calls in utility functions"},hasSuggestions:true,messages:{externalApiCallInUtils:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.ARCHITECTURE,issueName:"External API call in utils",description:"Network call in utility function - breaks testability",severity:"HIGH",fix:"Use dependency injection for network calls",documentationLink:"https://rules.sonarsource.com/javascript/RSPEC-1075/"}),useDependencyInjection:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Use Dependency Injection",description:"Inject API client",severity:"LOW",fix:"function util(apiClient) { return apiClient.get(...) }",documentationLink:"https://en.wikipedia.org/wiki/Dependency_injection"}),extractToService:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Extract to Service",description:"Extract to service layer",severity:"LOW",fix:"Create services/apiService.ts",documentationLink:"https://martinfowler.com/eaaCatalog/serviceLayer.html"}),passApiClient:(0,eslint_devkit_1.formatLLMMessage)({icon:eslint_devkit_1.MessageIcons.INFO,issueName:"Pass API Client",description:"Pass API client as parameter",severity:"LOW",fix:"function util(apiClient, data) { ... }",documentationLink:"https://en.wikipedia.org/wiki/Dependency_injection"})},schema:[{type:"object",properties:{httpModules:{type:"array",items:{type:"string"},default:DEFAULT_HTTP_MODULES},ignoreInTests:{type:"boolean",default:true},networkMethods:{description:'HTTP method names to flag. A bare name ("get") applies only when the receiver resolves to a known HTTP client. A dotted entry ("httpClient.get") is an exact object.method escape hatch that bypasses client resolution entirely \u2014 use it for an in-house client this rule cannot trace.',type:"array",items:{type:"string"},default:DEFAULT_NETWORK_METHODS},utilityPatterns:{type:"array",items:{type:"string"},default:DEFAULT_UTILITY_PATTERNS}},additionalProperties:false}]},defaultOptions:[{httpModules:DEFAULT_HTTP_MODULES,ignoreInTests:true,networkMethods:DEFAULT_NETWORK_METHODS,utilityPatterns:DEFAULT_UTILITY_PATTERNS}],create(context,[options={}]){const{httpModules=DEFAULT_HTTP_MODULES,ignoreInTests=true,networkMethods=DEFAULT_NETWORK_METHODS,utilityPatterns=DEFAULT_UTILITY_PATTERNS}=options||{};const filename=context.filename;const isTestFile=ignoreInTests&&/\.(test|spec)\.(ts|tsx|js|jsx)$/.test(filename);if(isTestFile){return{}}const isUtility=isUtilityFile(filename,utilityPatterns);if(!isUtility){return{}}const modules=new Set(httpModules);const methods=new Set(networkMethods);const explicitPairs=new Set(networkMethods.filter(method=>method.includes(".")));const clients=new Set(GLOBAL_CLIENTS);for(const source of modules){const bare=source.replace(/^node:/,"");if(/^[A-Za-z_$][\w$]*$/.test(bare)&&!AMBIGUOUS_MODULE_NAMES.has(bare)){clients.add(bare)}}const aliases=[];const calls=[];function trackBinding(id){if(id.type==="Identifier"){clients.add(id.name)}else if(id.type==="ObjectPattern"){for(const property of id.properties){if(property.type==="Property"&&property.value.type==="Identifier"){clients.add(property.value.name)}}}}function isNetworkCall(node){const callee=node.callee;if(callee.type==="Identifier"){return clients.has(callee.name)}if(callee.type!=="MemberExpression"||callee.computed||callee.property.type!=="Identifier"){return false}const method=callee.property.name;const root=rootName(callee.object);if(root===null){return false}if(explicitPairs.has(`${root}.${method}`)){return true}if(GLOBAL_CLIENT_HOSTS.has(root)){return GLOBAL_CLIENTS.has(method)}return clients.has(root)&&methods.has(method)}return{ImportDeclaration(node){if(node.importKind==="type"||!modules.has(node.source.value)){return}for(const specifier of node.specifiers){if(specifier.type!=="ImportSpecifier"||specifier.importKind!=="type"){clients.add(specifier.local.name)}}},VariableDeclarator(node){if(!node.init){return}const source=requiredModule(node.init);if(source!==null){if(modules.has(source)){trackBinding(node.id)}return}const root=rootName(node.init.type==="CallExpression"?node.init.callee:node.init);if(root!==null&&node.id.type==="Identifier"){aliases.push([node.id.name,root])}},CallExpression(node){calls.push(node)},"Program:exit"(){let changed=true;while(changed){changed=false;for(const[local,root]of aliases){if(clients.has(root)&&!clients.has(local)){clients.add(local);changed=true}}}for(const node of calls){if(!isNetworkCall(node)){continue}context.report({node,messageId:"externalApiCallInUtils",suggest:[{messageId:"useDependencyInjection",fix:()=>null},{messageId:"extractToService",fix:()=>null},{messageId:"passApiClient",fix:()=>null}]})}}}}});