eslint rules

apps/website/eslint-rules/view-data-builder-implements.js

@@ -0,0 +1,96 @@
+/**
+ * ESLint rule to enforce View Data Builder contract implementation
+ *
+ * View Data Builders in lib/builders/view-data/ must:
+ * 1. Be classes named *ViewDataBuilder
+ * 2. Implement the ViewDataBuilder<TInput, TOutput> interface
+ * 3. Have a static build() method
+ */
+
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Enforce View Data Builder contract implementation',
+      category: 'Builders',
+      recommended: true,
+    },
+    fixable: null,
+    schema: [],
+    messages: {
+      notAClass: 'View Data Builders must be classes named *ViewDataBuilder',
+      missingImplements: 'View Data Builders must implement ViewDataBuilder<TInput, TOutput> interface',
+      missingBuildMethod: 'View Data Builders must have a static build() method',
+    },
+  },
+
+  create(context) {
+    const filename = context.getFilename();
+    const isInViewDataBuilders = filename.includes('/lib/builders/view-data/');
+    
+    if (!isInViewDataBuilders) return {};
+
+    let hasImplements = false;
+    let hasBuildMethod = false;
+
+    return {
+      // Check class declaration
+      ClassDeclaration(node) {
+        const className = node.id?.name;
+        
+        if (!className || !className.endsWith('ViewDataBuilder')) {
+          context.report({
+            node,
+            messageId: 'notAClass',
+          });
+        }
+
+        // Check if class implements ViewDataBuilder interface
+        if (node.implements && node.implements.length > 0) {
+          for (const impl of node.implements) {
+            // Handle GenericTypeAnnotation for ViewDataBuilder<TInput, TOutput>
+            if (impl.expression.type === 'TSInstantiationExpression') {
+              const expr = impl.expression.expression;
+              if (expr.type === 'Identifier' && expr.name === 'ViewDataBuilder') {
+                hasImplements = true;
+              }
+            } else if (impl.expression.type === 'Identifier') {
+              // Handle simple ViewDataBuilder (without generics)
+              if (impl.expression.name === 'ViewDataBuilder') {
+                hasImplements = true;
+              }
+            }
+          }
+        }
+
+        // Check for static build method
+        const buildMethod = node.body.body.find(member =>
+          member.type === 'MethodDefinition' &&
+          member.key.type === 'Identifier' &&
+          member.key.name === 'build' &&
+          member.static === true
+        );
+
+        if (buildMethod) {
+          hasBuildMethod = true;
+        }
+      },
+
+      'Program:exit'() {
+        if (!hasImplements) {
+          context.report({
+            node: context.getSourceCode().ast,
+            messageId: 'missingImplements',
+          });
+        }
+
+        if (!hasBuildMethod) {
+          context.report({
+            node: context.getSourceCode().ast,
+            messageId: 'missingBuildMethod',
+          });
+        }
+      },
+    };
+  },
+};