api-patterns

🔍 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/

Error Handling Patterns

Using Error Classes

Location: src/utils/error-handler.ts

import { Errors, createErrorResponse } from '../utils/error-handler';

// In endpoint handler
try {
  // Validation error
  if (!isValid) {
    throw Errors.validationError(['Field is required']);
  }
  
  // Not found
  if (!record) {
    throw Errors.notFound('Event');
  }
  
  // Database error
  if (queryFailed) {
    throw Errors.databaseError('Query failed: ' + error.message);
  }
  
  // Success response
  return new Response(JSON.stringify(data), {
    headers: { 'Content-Type': 'application/json' }
  });
  
} catch (error) {
  return createErrorResponse(error, requestId, url.pathname);
}

Error Types

// Client errors (4xx)
Errors.badRequest(message, details?)       // 400
Errors.unauthorized(message?)              // 401
Errors.forbidden(message?)                 // 403
Errors.notFound(resource?)                 // 404
Errors.validationError(errors[])           // 400
Errors.rateLimit(message?)                 // 429

// Server errors (5xx)
Errors.databaseError(message)              // 500
Errors.serviceUnavailable(message?)        // 503
Errors.timeout(message?)                   // 504