use convex linter (#51)

## Summary
- Install and configure `@convex-dev/eslint-plugin` 
- Auto-fix `explicit-table-ids` violations (adds table name as first arg to `db.get`/`db.patch`/`db.delete`/`db.replace`)
- Add eslint-disable annotations where table names are genuinely dynamic

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Author: ianmacartney

eslint.config.js

@@ -3,6 +3,7 @@ import pluginJs from "@eslint/js";
 import tseslint from "typescript-eslint";
 import reactHooks from "eslint-plugin-react-hooks";
 import reactRefresh from "eslint-plugin-react-refresh";
+import convexPlugin from "@convex-dev/eslint-plugin";
 
 export default [
   {
@@ -37,7 +38,12 @@ export default [
     languageOptions: {
       globals: globals.worker,
     },
+    plugins: {
+      "@convex-dev": convexPlugin,
+    },
     rules: {
+      ...convexPlugin.configs.recommended[0].rules,
+
       "@typescript-eslint/no-floating-promises": "error",
       "@typescript-eslint/no-explicit-any": "off",
       "no-unused-vars": "off",

example/convex/example.ts

@@ -33,7 +33,7 @@ export const nearestPoints = query({
     });
     return await Promise.all(
       results.map(async (result) => {
-        const row = await ctx.db.get(result.key as Id<"locations">);
+        const row = await ctx.db.get("locations", result.key as Id<"locations">);
         if (!row) {
           throw new Error("Invalid locationId");
         }
@@ -91,7 +91,7 @@ export const search = query({
     );
     const rows = await Promise.all(
       results.map(async (result) => {
-        const row = await ctx.db.get(result.key);
+        const row = await ctx.db.get("locations", result.key);
         if (!row) {
           throw new Error("Invalid locationId");
         }

package-lock.json

@@ -71,6 +71,7 @@
     "convex": "^1.24.8"
   },
   "devDependencies": {
+    "@convex-dev/eslint-plugin": "^2.0.0",
     "@edge-runtime/vm": "5.0.0",
     "@eslint/js": "9.39.2",
     "@fast-check/vitest": "0.2.4",

package.json

@@ -135,7 +135,7 @@ async function removePointByKey(
         `Invariant failed: Missing cell ${cell} for point ${existing._id}`,
       );
     }
-    await ctx.db.delete(existingCell._id);
+    await ctx.db.delete("pointsByCell", existingCell._id);
     await approximateCounter.decrement(ctx, existing._id, cellCounterKey(cell));
   }
   for (const [filterKey, filterDoc] of Object.entries(existing.filterKeys)) {
@@ -155,14 +155,14 @@ async function removePointByKey(
           `Invariant failed: Missing filterKey ${filterKey}:${filterValue} for point ${existing._id}`,
         );
       }
-      await ctx.db.delete(existingFilterKey._id);
+      await ctx.db.delete("pointsByFilterKey", existingFilterKey._id);
       await approximateCounter.decrement(
         ctx,
         existing._id,
         filterCounterKey(filterKey, filterValue),
       );
     }
   }
-  await ctx.db.delete(existing._id);
+  await ctx.db.delete("points", existing._id);
   return true;
 }

src/component/document.ts

@@ -24,7 +24,7 @@ export async function increment(
     .withIndex("key", (q) => q.eq("key", key))
     .first();
   if (existing) {
-    await ctx.db.patch(existing._id, { count: existing.count + 1 });
+    await ctx.db.patch("approximateCounters", existing._id, { count: existing.count + 1 });
   } else {
     await ctx.db.insert("approximateCounters", { key, count: 1 });
   }
@@ -46,9 +46,9 @@ export async function decrement(
     throw new Error(`Invariant failed: Missing counter for key ${key}`);
   }
   if (existing.count === 1) {
-    await ctx.db.delete(existing._id);
+    await ctx.db.delete("approximateCounters", existing._id);
   } else {
-    await ctx.db.patch(existing._id, { count: existing.count - 1 });
+    await ctx.db.patch("approximateCounters", existing._id, { count: existing.count - 1 });
   }
 }
 

src/component/lib/approximateCounter.ts

@@ -123,7 +123,7 @@ export class ClosestPointQuery {
             }
             continue;
           }
-          const point = await ctx.db.get(pointId);
+          const point = await ctx.db.get("points", pointId);
           if (!point) {
             throw new Error("Point not found");
           }
@@ -140,7 +140,7 @@ export class ClosestPointQuery {
     const entries = this.results
       .toArray()
       .sort((a, b) => a.distance - b.distance);
-    const points = await Promise.all(entries.map((r) => ctx.db.get(r.pointID)));
+    const points = await Promise.all(entries.map((r) => ctx.db.get("points", r.pointID)));
     const results = [];
     for (let i = 0; i < entries.length; i++) {
       const point = points[i];

src/component/lib/pointQuery.ts

@@ -195,7 +195,7 @@ export const execute = query({
           }
           const { pointId } = decodeTupleKey(tupleKey);
           try {
-            await channel.push({ tupleKey, docPromise: ctx.db.get(pointId) });
+            await channel.push({ tupleKey, docPromise: ctx.db.get("points", pointId) });
           } catch (e) {
             if (e instanceof ChannelClosedError) {
               break;