@doccov/api 0.3.5 → 0.3.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/api",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "DocCov API - Badge endpoint and coverage services",
   "keywords": [
     "doccov",
@@ -19,20 +19,18 @@
   "author": "Ryan Waits",
   "type": "module",
   "scripts": {
-    "build": "bunup",
     "dev": "bun run --hot src/index.ts",
     "start": "bun run src/index.ts",
-    "lint": "biome check src/ functions/ lib/",
-    "lint:fix": "biome check --write src/ functions/ lib/",
-    "format": "biome format --write src/ functions/ lib/"
+    "lint": "biome check src/ api/",
+    "lint:fix": "biome check --write src/ api/",
+    "format": "biome format --write src/ api/"
   },
   "dependencies": {
     "@ai-sdk/anthropic": "^2.0.55",
-    "@doccov/sdk": "^0.13.0",
+    "@doccov/sdk": "^0.15.0",
     "@openpkg-ts/spec": "^0.9.0",
     "@vercel/sandbox": "^1.0.3",
     "ai": "^5.0.111",
-    "hono": "^4.0.0",
     "ms": "^2.1.3",
     "zod": "^3.25.0"
   },
@@ -41,7 +39,6 @@
     "@types/ms": "^0.7.34",
     "@types/node": "^20.0.0",
     "@vercel/node": "^3.0.0",
-    "bunup": "latest",
     "typescript": "^5.0.0"
   }
 }

package/src/routes/plan.ts

@@ -34,10 +34,13 @@ planRoute.post('/', async (c) => {
 
     // Check for private repos
     if (context.metadata.isPrivate) {
-      return c.json({
-        error: 'Private repositories are not supported',
-        hint: 'Use a public repository or run doccov locally',
-      }, 403);
+      return c.json(
+        {
+          error: 'Private repositories are not supported',
+          hint: 'Use a public repository or run doccov locally',
+        },
+        403,
+      );
     }
 
     // Generate build plan using AI
@@ -67,9 +70,12 @@ planRoute.post('/', async (c) => {
       }
     }
 
-    return c.json({
-      error: 'Failed to generate build plan',
-      message: error instanceof Error ? error.message : 'Unknown error',
-    }, 500);
+    return c.json(
+      {
+        error: 'Failed to generate build plan',
+        message: error instanceof Error ? error.message : 'Unknown error',
+      },
+      500,
+    );
   }
 });

package/vercel.json

@@ -1,12 +1,8 @@
 {
+  "framework": null,
   "installCommand": "bun install",
-  "buildCommand": "bun run build",
+  "outputDirectory": ".",
   "rewrites": [
-    { "source": "/badge/:path*", "destination": "/api" },
-    { "source": "/spec/:path*", "destination": "/api" },
-    { "source": "/plan", "destination": "/api/plan" },
-    { "source": "/execute", "destination": "/api/execute" },
-    { "source": "/execute-stream", "destination": "/api/execute-stream" },
     { "source": "/(.*)", "destination": "/api" }
   ]
 }

package/api/[...path].ts

@@ -1,35 +0,0 @@
-/**
- * Catch-all router for Vercel serverless functions.
- * Routes requests to the appropriate bundled function handler.
- */
-import type { VercelRequest, VercelResponse } from '@vercel/node';
-
-// Import bundled handlers (built by bunup)
-import executeHandler from '../dist/functions/execute';
-import executeStreamHandler from '../dist/functions/execute-stream';
-import planHandler from '../dist/functions/plan';
-
-export const config = {
-  runtime: 'nodejs',
-  maxDuration: 300,
-};
-
-type Handler = (req: VercelRequest, res: VercelResponse) => Promise<void | VercelResponse>;
-
-const handlers: Record<string, Handler> = {
-  execute: executeHandler,
-  'execute-stream': executeStreamHandler,
-  plan: planHandler,
-};
-
-export default async function handler(req: VercelRequest, res: VercelResponse) {
-  // Extract path from catch-all
-  const pathSegments = req.query.path;
-  const route = Array.isArray(pathSegments) ? pathSegments[0] : pathSegments;
-
-  if (!route || !handlers[route]) {
-    return res.status(404).json({ error: 'Not found', availableRoutes: Object.keys(handlers) });
-  }
-
-  return handlers[route](req, res);
-}

package/bunup.config.ts

@@ -1,16 +0,0 @@
-import { defineConfig } from 'bunup';
-
-export default defineConfig({
-  entry: ['functions/execute.ts', 'functions/execute-stream.ts', 'functions/plan.ts'],
-  dts: false,
-  clean: true,
-  splitting: false,
-  format: ['esm'],
-  outDir: 'dist/functions',
-  external: [
-    '@vercel/node',
-    '@vercel/sandbox',
-    '@doccov/sdk',
-    '@openpkg-ts/spec',
-  ],
-});

package/functions/execute-stream.ts

@@ -1,273 +0,0 @@
-/**
- * GET /execute-stream - Execute a build plan with SSE streaming progress
- *
- * Query params:
- * - plan: Base64-encoded BuildPlan JSON (required)
- *
- * SSE Events:
- * - step-start: { stepId, name }
- * - step-progress: { stepId, output }
- * - step-complete: { stepId, success, duration, error? }
- * - complete: { success, spec?, totalDuration, error? }
- * - error: { message }
- */
-
-import type { BuildPlan, BuildPlanExecutionResult, BuildPlanStepResult } from '@doccov/sdk';
-import type { OpenPkg } from '@openpkg-ts/spec';
-import { Sandbox } from '@vercel/sandbox';
-import type { VercelRequest, VercelResponse } from '@vercel/node';
-import ms from 'ms';
-
-export const config = {
-  runtime: 'nodejs',
-  maxDuration: 300, // 5 minutes for full execution
-};
-
-/**
- * SSE event types for execute streaming
- */
-type ExecuteEvent =
-  | { type: 'step-start'; stepId: string; name: string }
-  | { type: 'step-progress'; stepId: string; output: string }
-  | { type: 'step-complete'; stepId: string; success: boolean; duration: number; error?: string }
-  | { type: 'complete'; success: boolean; spec?: OpenPkg; totalDuration: number; error?: string }
-  | { type: 'error'; message: string };
-
-/**
- * Map runtime to Vercel sandbox runtime
- */
-function getSandboxRuntime(runtime: string): 'node22' | 'node24' {
-  if (runtime === 'node24') return 'node24';
-  return 'node22'; // Default to node22 for everything else
-}
-
-export default async function handler(req: VercelRequest, res: VercelResponse) {
-  // CORS
-  res.setHeader('Access-Control-Allow-Origin', '*');
-  res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
-  res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
-
-  if (req.method === 'OPTIONS') {
-    return res.status(200).end();
-  }
-
-  if (req.method !== 'GET') {
-    return res.status(405).json({ error: 'Method not allowed' });
-  }
-
-  // Get plan from query string (base64 encoded)
-  const planBase64 = req.query.plan as string;
-
-  if (!planBase64) {
-    return res.status(400).json({ error: 'plan query param is required (base64 encoded JSON)' });
-  }
-
-  let plan: BuildPlan;
-  try {
-    const planJson = Buffer.from(planBase64, 'base64').toString('utf-8');
-    plan = JSON.parse(planJson) as BuildPlan;
-  } catch {
-    return res.status(400).json({ error: 'Invalid plan: must be valid base64-encoded JSON' });
-  }
-
-  // Validate plan structure
-  if (!plan.target?.repoUrl || !plan.steps) {
-    return res.status(400).json({ error: 'Invalid plan structure' });
-  }
-
-  // Set SSE headers
-  res.setHeader('Content-Type', 'text/event-stream');
-  res.setHeader('Cache-Control', 'no-cache');
-  res.setHeader('Connection', 'keep-alive');
-
-  // Send initial comment
-  res.write(':ok\n\n');
-
-  // Helper to send SSE event
-  const sendEvent = (event: ExecuteEvent) => {
-    const data = JSON.stringify(event);
-    res.write(`data: ${data}\n\n`);
-  };
-
-  // Run execution with streaming progress
-  await runExecuteWithProgress(plan, sendEvent);
-
-  res.end();
-}
-
-async function runExecuteWithProgress(
-  plan: BuildPlan,
-  sendEvent: (event: ExecuteEvent) => void,
-): Promise<void> {
-  const startTime = Date.now();
-  const stepResults: BuildPlanStepResult[] = [];
-  let sandbox: Awaited<ReturnType<typeof Sandbox.create>> | null = null;
-
-  try {
-    // Create sandbox with git source
-    sandbox = await Sandbox.create({
-      source: {
-        url: plan.target.repoUrl,
-        type: 'git',
-      },
-      resources: { vcpus: 4 },
-      timeout: ms('5m'),
-      runtime: getSandboxRuntime(plan.environment.runtime),
-    });
-
-    // Execute each step
-    for (const step of plan.steps) {
-      const stepStart = Date.now();
-
-      sendEvent({
-        type: 'step-start',
-        stepId: step.id,
-        name: step.name,
-      });
-
-      try {
-        const result = await sandbox.runCommand({
-          cmd: step.command,
-          args: step.args,
-          cwd: step.cwd,
-          timeout: step.timeout ?? 60000,
-        });
-
-        // stdout/stderr are async functions in Vercel Sandbox
-        const stdout = result.stdout ? await result.stdout() : '';
-        const stderr = result.stderr ? await result.stderr() : '';
-
-        const success = result.exitCode === 0;
-        const duration = Date.now() - stepStart;
-
-        stepResults.push({
-          stepId: step.id,
-          success,
-          duration,
-          output: stdout.slice(0, 5000),
-          error: !success ? stderr.slice(0, 2000) : undefined,
-        });
-
-        sendEvent({
-          type: 'step-complete',
-          stepId: step.id,
-          success,
-          duration,
-          error: !success ? stderr.slice(0, 500) : undefined,
-        });
-
-        // Stop on non-optional failures
-        if (!success && !step.optional) {
-          throw new Error(`Step '${step.name}' failed: ${stderr.slice(0, 500)}`);
-        }
-      } catch (stepError) {
-        const duration = Date.now() - stepStart;
-        const errorMsg = stepError instanceof Error ? stepError.message : 'Unknown error';
-
-        stepResults.push({
-          stepId: step.id,
-          success: false,
-          duration,
-          error: errorMsg,
-        });
-
-        sendEvent({
-          type: 'step-complete',
-          stepId: step.id,
-          success: false,
-          duration,
-          error: errorMsg.slice(0, 500),
-        });
-
-        if (!step.optional) {
-          throw stepError;
-        }
-      }
-    }
-
-    // Run doccov spec to generate the OpenPkg spec
-    const analyzeStep = {
-      id: 'analyze',
-      name: 'Generate OpenPkg spec',
-    };
-
-    sendEvent({
-      type: 'step-start',
-      stepId: analyzeStep.id,
-      name: analyzeStep.name,
-    });
-
-    const specStart = Date.now();
-    const entryPoint = plan.target.entryPoints[0] ?? 'src/index.ts';
-
-    // Install doccov CLI first
-    await sandbox.runCommand({
-      cmd: 'npm',
-      args: ['install', '-g', '@doccov/cli@latest'],
-    });
-
-    // Run spec generation
-    const specResult = await sandbox.runCommand({
-      cmd: 'doccov',
-      args: ['spec', entryPoint, '--output', 'openpkg.json'],
-      cwd: plan.target.rootPath,
-    });
-
-    const specStdout = specResult.stdout ? await specResult.stdout() : '';
-    const specStderr = specResult.stderr ? await specResult.stderr() : '';
-    const specDuration = Date.now() - specStart;
-
-    stepResults.push({
-      stepId: 'analyze',
-      success: specResult.exitCode === 0,
-      duration: specDuration,
-      output: specStdout.slice(0, 2000),
-      error: specResult.exitCode !== 0 ? specStderr.slice(0, 2000) : undefined,
-    });
-
-    sendEvent({
-      type: 'step-complete',
-      stepId: 'analyze',
-      success: specResult.exitCode === 0,
-      duration: specDuration,
-      error: specResult.exitCode !== 0 ? specStderr.slice(0, 500) : undefined,
-    });
-
-    if (specResult.exitCode !== 0) {
-      throw new Error(`Spec generation failed: ${specStderr.slice(0, 500)}`);
-    }
-
-    // Read the generated spec - readFile returns a readable stream
-    const specStream = await sandbox.readFile({ path: 'openpkg.json' });
-    const chunks: Buffer[] = [];
-    for await (const chunk of specStream as AsyncIterable<Buffer>) {
-      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-    }
-    const specContent = Buffer.concat(chunks).toString('utf-8');
-    const spec = JSON.parse(specContent) as OpenPkg;
-
-    sendEvent({
-      type: 'complete',
-      success: true,
-      spec,
-      totalDuration: Date.now() - startTime,
-    });
-  } catch (error) {
-    const errorMsg = error instanceof Error ? error.message : 'Unknown error';
-
-    sendEvent({
-      type: 'complete',
-      success: false,
-      totalDuration: Date.now() - startTime,
-      error: errorMsg,
-    });
-  } finally {
-    if (sandbox) {
-      try {
-        await sandbox.stop();
-      } catch {
-        // Ignore cleanup errors
-      }
-    }
-  }
-}

package/functions/execute.ts

@@ -1,204 +0,0 @@
-/**
- * POST /execute - Execute a build plan in a Vercel Sandbox
- *
- * Request body:
- * - plan: BuildPlan object (required)
- *
- * Response:
- * - BuildPlanExecutionResult with spec and step results
- */
-
-import type { BuildPlan, BuildPlanExecutionResult, BuildPlanStepResult } from '@doccov/sdk';
-import type { OpenPkg } from '@openpkg-ts/spec';
-import { Sandbox } from '@vercel/sandbox';
-import type { VercelRequest, VercelResponse } from '@vercel/node';
-import ms from 'ms';
-
-export const config = {
-  runtime: 'nodejs',
-  maxDuration: 300, // 5 minutes for full execution
-};
-
-interface ExecuteRequestBody {
-  plan: BuildPlan;
-}
-
-/**
- * Map package manager to install command
- */
-function getInstallCommand(pm: string): { cmd: string; args: string[] } {
-  switch (pm) {
-    case 'bun':
-      return { cmd: 'bun', args: ['install', '--ignore-scripts'] };
-    case 'pnpm':
-      return { cmd: 'pnpm', args: ['install', '--ignore-scripts'] };
-    case 'yarn':
-      return { cmd: 'yarn', args: ['install', '--ignore-scripts'] };
-    default:
-      return { cmd: 'npm', args: ['install', '--ignore-scripts', '--legacy-peer-deps'] };
-  }
-}
-
-/**
- * Map runtime to Vercel sandbox runtime
- */
-function getSandboxRuntime(runtime: string): 'node22' | 'node24' {
-  if (runtime === 'node24') return 'node24';
-  return 'node22'; // Default to node22 for everything else
-}
-
-export default async function handler(req: VercelRequest, res: VercelResponse) {
-  // CORS
-  res.setHeader('Access-Control-Allow-Origin', '*');
-  res.setHeader('Access-Control-Allow-Methods', 'POST, OPTIONS');
-  res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
-
-  if (req.method === 'OPTIONS') {
-    return res.status(200).end();
-  }
-
-  if (req.method !== 'POST') {
-    return res.status(405).json({ error: 'Method not allowed' });
-  }
-
-  const body = req.body as ExecuteRequestBody;
-
-  if (!body.plan) {
-    return res.status(400).json({ error: 'plan is required' });
-  }
-
-  const { plan } = body;
-
-  // Validate plan structure
-  if (!plan.target?.repoUrl || !plan.steps) {
-    return res.status(400).json({ error: 'Invalid plan structure' });
-  }
-
-  const startTime = Date.now();
-  const stepResults: BuildPlanStepResult[] = [];
-  let sandbox: Awaited<ReturnType<typeof Sandbox.create>> | null = null;
-
-  try {
-    // Create sandbox with git source
-    sandbox = await Sandbox.create({
-      source: {
-        url: plan.target.repoUrl,
-        type: 'git',
-      },
-      resources: { vcpus: 4 },
-      timeout: ms('5m'),
-      runtime: getSandboxRuntime(plan.environment.runtime),
-    });
-
-    // Execute each step
-    for (const step of plan.steps) {
-      const stepStart = Date.now();
-
-      try {
-        const result = await sandbox.runCommand({
-          cmd: step.command,
-          args: step.args,
-          cwd: step.cwd,
-          timeout: step.timeout ?? 60000,
-        });
-
-        // stdout/stderr are async functions in Vercel Sandbox
-        const stdout = result.stdout ? await result.stdout() : '';
-        const stderr = result.stderr ? await result.stderr() : '';
-
-        stepResults.push({
-          stepId: step.id,
-          success: result.exitCode === 0,
-          duration: Date.now() - stepStart,
-          output: stdout.slice(0, 5000), // Truncate output
-          error: result.exitCode !== 0 ? stderr.slice(0, 2000) : undefined,
-        });
-
-        // Stop on non-optional failures
-        if (result.exitCode !== 0 && !step.optional) {
-          throw new Error(`Step '${step.name}' failed: ${stderr}`);
-        }
-      } catch (stepError) {
-        stepResults.push({
-          stepId: step.id,
-          success: false,
-          duration: Date.now() - stepStart,
-          error: stepError instanceof Error ? stepError.message : 'Unknown error',
-        });
-
-        if (!step.optional) {
-          throw stepError;
-        }
-      }
-    }
-
-    // Run doccov spec to generate the OpenPkg spec
-    const specStart = Date.now();
-    const entryPoint = plan.target.entryPoints[0] ?? 'src/index.ts';
-
-    // Install doccov CLI first
-    await sandbox.runCommand({
-      cmd: 'npm',
-      args: ['install', '-g', '@doccov/cli@latest'],
-    });
-
-    // Run spec generation
-    const specResult = await sandbox.runCommand({
-      cmd: 'doccov',
-      args: ['spec', entryPoint, '--output', 'openpkg.json'],
-      cwd: plan.target.rootPath,
-    });
-
-    const specStdout = specResult.stdout ? await specResult.stdout() : '';
-    const specStderr = specResult.stderr ? await specResult.stderr() : '';
-
-    stepResults.push({
-      stepId: 'analyze',
-      success: specResult.exitCode === 0,
-      duration: Date.now() - specStart,
-      output: specStdout.slice(0, 2000),
-      error: specResult.exitCode !== 0 ? specStderr.slice(0, 2000) : undefined,
-    });
-
-    if (specResult.exitCode !== 0) {
-      throw new Error(`Spec generation failed: ${specStderr}`);
-    }
-
-    // Read the generated spec - readFile returns a readable stream
-    const specStream = await sandbox.readFile({ path: 'openpkg.json' });
-    const chunks: Buffer[] = [];
-    for await (const chunk of specStream as AsyncIterable<Buffer>) {
-      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-    }
-    const specContent = Buffer.concat(chunks).toString('utf-8');
-    const spec = JSON.parse(specContent) as OpenPkg;
-
-    const result: BuildPlanExecutionResult = {
-      success: true,
-      spec,
-      stepResults,
-      totalDuration: Date.now() - startTime,
-    };
-
-    return res.status(200).json(result);
-  } catch (error) {
-    console.error('Execution error:', error);
-
-    const result: BuildPlanExecutionResult = {
-      success: false,
-      stepResults,
-      totalDuration: Date.now() - startTime,
-      error: error instanceof Error ? error.message : 'Unknown error',
-    };
-
-    return res.status(200).json(result); // Return 200 with success: false
-  } finally {
-    if (sandbox) {
-      try {
-        await sandbox.stop();
-      } catch {
-        // Ignore cleanup errors
-      }
-    }
-  }
-}