@yasainet/eslint 0.0.51 → 0.0.52

package/README.md

@@ -35,7 +35,7 @@ Each entry point enforces a feature-based architecture with the following conven
 ├── shared/             # Cross-feature shared modules
 ├── ...
 {libRoot}/              # *.lib.ts — library wrappers (e.g., supabase.lib.ts)
-{utilsRoot}/            # *.util.ts — top-level utilities
+{utilsRoot}/            # *.util.ts — top-level utilities (e.g., font.util.ts)
 ```
 
 ## Setup

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasainet/eslint",
-  "version": "0.0.51",
+  "version": "0.0.52",
   "description": "ESLint",
   "type": "module",
   "exports": {

package/src/common/local-plugins/index.mjs

@@ -2,6 +2,7 @@ import { featureNameRule } from "./feature-name.mjs";
 import { importPathStyleRule } from "./import-path-style.mjs";
 import { namespaceImportNameRule } from "./namespace-import-name.mjs";
 import { noAnyReturnRule } from "./no-any-return.mjs";
+import { queriesExportRule } from "./queries-export.mjs";
 import { schemaNamingRule } from "./schema-naming.mjs";
 
 /** Single plugin object to avoid ESLint "Cannot redefine plugin" errors. */
@@ -11,6 +12,7 @@ export const localPlugin = {
     "import-path-style": importPathStyleRule,
     "namespace-import-name": namespaceImportNameRule,
     "no-any-return": noAnyReturnRule,
+    "queries-export": queriesExportRule,
     "schema-naming": schemaNamingRule,
   },
 };

package/src/common/local-plugins/queries-export.mjs

@@ -0,0 +1,65 @@
+/**
+ * Enforce verb allow list for `queries/*.query.ts` exports.
+ *
+ * The queries layer is the TS-idiomatic translation of Rails 5 actions
+ * (index/show -> get, create, update, destroy -> delete). Auth ceremonies
+ * (signUp / signIn / signOut) are admitted as industry-standard exceptions.
+ */
+
+const QUERIES_ALLOW = /^(get|create|update|delete|signUp|signIn|signOut)([A-Z]|$)/;
+
+function isFunctionLike(initNode) {
+  if (!initNode) return false;
+  const t = initNode.type;
+  if (t === "ArrowFunctionExpression" || t === "FunctionExpression") return true;
+  if (t === "CallExpression") {
+    return initNode.arguments.some(
+      (arg) =>
+        arg.type === "ArrowFunctionExpression" ||
+        arg.type === "FunctionExpression",
+    );
+  }
+  return false;
+}
+
+function reportIfInvalid(context, idNode) {
+  if (!QUERIES_ALLOW.test(idNode.name)) {
+    context.report({
+      node: idNode,
+      messageId: "invalidName",
+      data: { name: idNode.name },
+    });
+  }
+}
+
+export const queriesExportRule = {
+  meta: {
+    type: "problem",
+    messages: {
+      invalidName:
+        "queries export '{{ name }}' must start with one of: get, create, update, delete, signUp, signIn, signOut. (Rails 5 actions translated to TS idiom)",
+    },
+    schema: [],
+  },
+  create(context) {
+    return {
+      ExportNamedDeclaration(node) {
+        if (!node.declaration) return;
+        const decl = node.declaration;
+
+        if (decl.type === "FunctionDeclaration" && decl.id) {
+          reportIfInvalid(context, decl.id);
+          return;
+        }
+
+        if (decl.type === "VariableDeclaration") {
+          for (const variator of decl.declarations) {
+            if (variator.id.type !== "Identifier") continue;
+            if (!isFunctionLike(variator.init)) continue;
+            reportIfInvalid(context, variator.id);
+          }
+        }
+      },
+    };
+  },
+};

package/src/common/naming.mjs

@@ -102,6 +102,14 @@ export function createNamingConfigs(featureRoot, prefixLibMapping) {
         ],
       },
     },
+    {
+      name: "naming/queries-export",
+      files: featuresGlob(featureRoot, "**/queries/*.query.ts"),
+      plugins: { local: localPlugin },
+      rules: {
+        "local/queries-export": "error",
+      },
+    },
   );
 
   configs.push(