@doccov/api 0.4.0 → 0.6.0

package/src/routes/coverage.ts

@@ -1,3 +1,4 @@
+import { getPlanLimits, type Plan } from '@doccov/db';
 import { Hono } from 'hono';
 import { nanoid } from 'nanoid';
 import { auth } from '../auth/config';
@@ -29,33 +30,50 @@ coverageRoute.get('/projects/:projectId/history', async (c) => {
   const { projectId } = c.req.param();
   const { range = '30d', limit = '50' } = c.req.query();
 
-  // Verify user has access to project
-  const project = await db
+  // Verify user has access to project and get org plan
+  const projectWithOrg = await db
     .selectFrom('projects')
     .innerJoin('org_members', 'org_members.orgId', 'projects.orgId')
+    .innerJoin('organizations', 'organizations.id', 'projects.orgId')
     .where('projects.id', '=', projectId)
     .where('org_members.userId', '=', session.user.id)
-    .select(['projects.id', 'projects.name'])
+    .select(['projects.id', 'projects.name', 'organizations.plan'])
     .executeTakeFirst();
 
-  if (!project) {
+  if (!projectWithOrg) {
     return c.json({ error: 'Project not found' }, 404);
   }
 
-  // Calculate date filter based on range
+  // Check plan limits for trends access
+  const planLimits = getPlanLimits(projectWithOrg.plan as Plan);
+  if (planLimits.historyDays === 0) {
+    return c.json(
+      {
+        error: 'Coverage trends require Team plan or higher',
+        upgrade: 'https://doccov.com/pricing',
+      },
+      403,
+    );
+  }
+
+  // Calculate date filter based on range (capped by plan limit)
   let dateFilter: Date | null = null;
   const now = new Date();
-  switch (range) {
-    case '7d':
-      dateFilter = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
-      break;
-    case '30d':
-      dateFilter = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
-      break;
-    case '90d':
-      dateFilter = new Date(now.getTime() - 90 * 24 * 60 * 60 * 1000);
-      break;
-    // 'all' and 'versions' - no date filter
+  const maxDays = planLimits.historyDays;
+
+  // Map range to days, capped by plan limit
+  const rangeDays: Record<string, number> = {
+    '7d': Math.min(7, maxDays),
+    '30d': Math.min(30, maxDays),
+    '90d': Math.min(90, maxDays),
+  };
+
+  if (range in rangeDays) {
+    const days = rangeDays[range];
+    dateFilter = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+  } else if (range === 'all' || range === 'versions') {
+    // Still cap by plan limit
+    dateFilter = new Date(now.getTime() - maxDays * 24 * 60 * 60 * 1000);
   }
 
   let query = db
@@ -74,13 +92,9 @@ coverageRoute.get('/projects/:projectId/history', async (c) => {
       'version',
       'branch',
       'commitSha',
-      'coveragePercent',
-      'documentedCount',
-      'totalCount',
-      'descriptionCount',
-      'paramsCount',
-      'returnsCount',
-      'examplesCount',
+      'coverageScore',
+      'documentedExports',
+      'totalExports',
       'driftCount',
       'source',
       'createdAt',
@@ -111,13 +125,9 @@ coverageRoute.post('/projects/:projectId/snapshots', async (c) => {
     version?: string;
     branch?: string;
     commitSha?: string;
-    coveragePercent: number;
-    documentedCount: number;
-    totalCount: number;
-    descriptionCount?: number;
-    paramsCount?: number;
-    returnsCount?: number;
-    examplesCount?: number;
+    coverageScore: number;
+    documentedExports: number;
+    totalExports: number;
     driftCount?: number;
     source?: 'ci' | 'manual' | 'scheduled';
   }>();
@@ -144,13 +154,9 @@ coverageRoute.post('/projects/:projectId/snapshots', async (c) => {
       version: body.version || null,
       branch: body.branch || null,
       commitSha: body.commitSha || null,
-      coveragePercent: body.coveragePercent,
-      documentedCount: body.documentedCount,
-      totalCount: body.totalCount,
-      descriptionCount: body.descriptionCount || null,
-      paramsCount: body.paramsCount || null,
-      returnsCount: body.returnsCount || null,
-      examplesCount: body.examplesCount || null,
+      coverageScore: body.coverageScore,
+      documentedExports: body.documentedExports,
+      totalExports: body.totalExports,
       driftCount: body.driftCount || 0,
       source: body.source || 'manual',
     })
@@ -161,7 +167,7 @@ coverageRoute.post('/projects/:projectId/snapshots', async (c) => {
   await db
     .updateTable('projects')
     .set({
-      coverageScore: body.coveragePercent,
+      coverageScore: body.coverageScore,
       driftCount: body.driftCount || 0,
       lastAnalyzedAt: new Date(),
     })
@@ -174,9 +180,9 @@ coverageRoute.post('/projects/:projectId/snapshots', async (c) => {
 // Helper: Generate insights from coverage data
 interface Snapshot {
   version: string | null;
-  coveragePercent: number;
-  documentedCount: number;
-  totalCount: number;
+  coverageScore: number;
+  documentedExports: number;
+  totalExports: number;
   driftCount: number;
 }
 
@@ -192,7 +198,7 @@ function generateInsights(snapshots: Snapshot[]): Insight[] {
 
   const first = snapshots[0];
   const last = snapshots[snapshots.length - 1];
-  const diff = last.coveragePercent - first.coveragePercent;
+  const diff = last.coverageScore - first.coverageScore;
 
   // Overall improvement/regression
   if (diff > 0) {
@@ -210,8 +216,8 @@ function generateInsights(snapshots: Snapshot[]): Insight[] {
   }
 
   // Predict time to 100%
-  if (diff > 0 && last.coveragePercent < 100) {
-    const remaining = 100 - last.coveragePercent;
+  if (diff > 0 && last.coverageScore < 100) {
+    const remaining = 100 - last.coverageScore;
     const avgGainPerSnapshot = diff / (snapshots.length - 1);
     if (avgGainPerSnapshot > 0) {
       const snapshotsToComplete = Math.ceil(remaining / avgGainPerSnapshot);
@@ -227,8 +233,7 @@ function generateInsights(snapshots: Snapshot[]): Insight[] {
   const milestones = [50, 75, 90, 100];
   for (const milestone of milestones) {
     const crossedAt = snapshots.findIndex(
-      (s, i) =>
-        i > 0 && s.coveragePercent >= milestone && snapshots[i - 1].coveragePercent < milestone,
+      (s, i) => i > 0 && s.coverageScore >= milestone && snapshots[i - 1].coverageScore < milestone,
     );
     if (crossedAt > 0) {
       insights.push({
@@ -253,7 +258,7 @@ function detectRegression(
   for (let i = 1; i < recent.length; i++) {
     const prev = recent[i - 1];
     const curr = recent[i];
-    const drop = prev.coveragePercent - curr.coveragePercent;
+    const drop = prev.coverageScore - curr.coverageScore;
 
     if (drop >= 3) {
       // 3% or more drop
@@ -261,7 +266,7 @@ function detectRegression(
         fromVersion: prev.version || `v${i}`,
         toVersion: curr.version || `v${i + 1}`,
         coverageDrop: Math.round(drop),
-        exportsLost: prev.documentedCount - curr.documentedCount,
+        exportsLost: prev.documentedExports - curr.documentedExports,
       };
     }
   }