endpoint-routing

Endpoint Routing Rules

🔍 Code Searchability Patterns

Find api-patterns Issues with ast-grep

# Find async function $NAME(request: Request, env: Env, requestId: string)
# Find return createJSONResponse($$$)
# Find return createErrorResponse($$$)
# Find generateRequestId()
# Find createLogger($$$)
ast-grep --pattern 'async function $NAME(request: Request, env: Env, requestId: string)' src/
ast-grep --pattern 'return createJSONResponse($$$)' src/
ast-grep --pattern 'return createErrorResponse($$$)' src/
ast-grep --pattern 'generateRequestId()' src/
ast-grep --pattern 'createLogger($$$)' src/
sg -p 'async' src/
sg -p 'return' src/
sg -p 'return' src/
sg -p 'generateRequestId()' src/
sg -p 'createLogger($$$)' src/

api-patterns Discovery Commands

sg search "async function" src/api/
sg search "createJSONResponse" src/
sg search "generateRequestId" src/
sg search "createLogger" src/

Search Examples

# Find all API endpoint handlers
sg search 'async' src/
# Find JSON response patterns
sg search 'return' src/
# Find request ID generation
sg search 'return' src/
# Find logging patterns
sg search 'generateRequestId()' src/

Main Entry Point

All HTTP requests are handled in src/index.ts via the fetch() handler.

Request Flow Pattern

import { generateRequestId, createOPTIONSResponse, createJSONResponse } from '../utils/request';
import { createLogger } from '../utils/logger';

1. Generate requestId: generateRequestId()
2. Parse URL: new URL(request.url)
3. Log request details with StructuredLogger
4. Handle CORS preflight: createOPTIONSResponse()
5. Route by pathname
6. Return response: createJSONResponse() (includes CORS)

Endpoint Categories

Core System Endpoints (4)

Pattern: Exact pathname match

if (url.pathname === '/health') {
  // Health check - used by all dashboards
  // Returns: { status, version, timestamp, requestId, duration }
}

if (url.pathname === '/logs') {
  // Centralized logging - used by browser extension
  // POST: Receives log batches from extension
}

if (url.pathname === '/diagnostics') {
  // System diagnostics - used by setup wizard, health monitor
  // Returns: bindings status, KV status, last checks
}

if (url.pathname === '/system-status') {
  // Detailed status - used by dashboard stats
  // Returns: uptime, memory, KV records, health indicators
}