feat: add optimized notes counts endpoint for mobile app

- add GET /api/notes/counts endpoint that returns aggregated note counts (all, starred, archived, trash) without fetching full note data. Includes Valkey caching with 2-minute TTL for improved performance.

Author: batalabs

CHANGELOG.md

@@ -1,10 +1,9 @@
 ## [1.6.2](https://github.com/typelets/typelets-api/compare/v1.6.1...v1.6.2) (2025-10-15)
 
-
 ### Bug Fixes
 
-* replace GITHUB_TOKEN with PAT_TOKEN in release workflow ([6327365](https://github.com/typelets/typelets-api/commit/632736522b75a68d0e268d0a649d5ec6b5367db3))
-* replace GITHUB_TOKEN with PAT_TOKEN in release workflow ([844f9d9](https://github.com/typelets/typelets-api/commit/844f9d997391bda0ffe4b7788efa019cddf5d982))
+- replace GITHUB_TOKEN with PAT_TOKEN in release workflow ([6327365](https://github.com/typelets/typelets-api/commit/632736522b75a68d0e268d0a649d5ec6b5367db3))
+- replace GITHUB_TOKEN with PAT_TOKEN in release workflow ([844f9d9](https://github.com/typelets/typelets-api/commit/844f9d997391bda0ffe4b7788efa019cddf5d982))
 
 ## [1.6.1](https://github.com/typelets/typelets-api/compare/v1.6.0...v1.6.1) (2025-10-15)
 

src/lib/cache-keys.ts

@@ -15,6 +15,7 @@ export const CacheKeys = {
   notesArchived: (userId: string) => `notes:${userId}:archived`,
   notesDeleted: (userId: string) => `notes:${userId}:deleted`,
   notesDeletedCount: (userId: string) => `notes:${userId}:deletedCount`,
+  notesCounts: (userId: string) => `notes:${userId}:counts`,
 
   // Attachment-related
   noteAttachments: (noteId: string) => `attachments:note:${noteId}`,
@@ -31,5 +32,6 @@ export const CacheTTL = {
   notesStarred: 300, // 5 minutes
   notesArchived: 300, // 5 minutes
   notesDeleted: 300, // 5 minutes
+  notesCounts: 120, // 2 minutes
   noteAttachments: 1800, // 30 minutes
 } as const;

src/routes/notes.ts

@@ -5,6 +5,8 @@ import { db, notes } from "../db";
 import { createNoteSchema, updateNoteSchema, notesQuerySchema } from "../lib/validation";
 import { eq, and, desc, or, ilike, count, SQL } from "drizzle-orm";
 import { checkNoteLimits } from "../middleware/usage";
+import { getCache, setCache } from "../lib/cache";
+import { CacheKeys, CacheTTL } from "../lib/cache-keys";
 
 const notesRouter = new Hono();
 
@@ -79,6 +81,63 @@ notesRouter.get("/", zValidator("query", notesQuerySchema), async (c) => {
   });
 });
 
+notesRouter.get("/counts", async (c) => {
+  const userId = c.get("userId");
+  const cacheKey = CacheKeys.notesCounts(userId);
+
+  // Try to get from cache first
+  const cachedCounts = await getCache<{
+    all: number;
+    starred: number;
+    archived: number;
+    trash: number;
+  }>(cacheKey);
+
+  if (cachedCounts) {
+    return c.json(cachedCounts);
+  }
+
+  // If not in cache, query the database
+  const [allCount] = await db
+    .select({ total: count() })
+    .from(notes)
+    .where(and(eq(notes.userId, userId), eq(notes.deleted, false), eq(notes.archived, false)));
+
+  const [starredCount] = await db
+    .select({ total: count() })
+    .from(notes)
+    .where(
+      and(
+        eq(notes.userId, userId),
+        eq(notes.starred, true),
+        eq(notes.deleted, false),
+        eq(notes.archived, false)
+      )
+    );
+
+  const [archivedCount] = await db
+    .select({ total: count() })
+    .from(notes)
+    .where(and(eq(notes.userId, userId), eq(notes.archived, true), eq(notes.deleted, false)));
+
+  const [trashCount] = await db
+    .select({ total: count() })
+    .from(notes)
+    .where(and(eq(notes.userId, userId), eq(notes.deleted, true)));
+
+  const counts = {
+    all: allCount.total,
+    starred: starredCount.total,
+    archived: archivedCount.total,
+    trash: trashCount.total,
+  };
+
+  // Cache the results
+  await setCache(cacheKey, counts, CacheTTL.notesCounts);
+
+  return c.json(counts);
+});
+
 notesRouter.get("/:id", async (c) => {
   const userId = c.get("userId");
   const noteId = c.req.param("id");

src/version.ts

@@ -1,2 +1,2 @@
 // This file is automatically updated by semantic-release
-export const VERSION = "1.6.2"
+export const VERSION = "1.6.2";