Add HTTP status code response helpers (#33)

Author: Copilot

.gitignore

@@ -1,3 +1,4 @@
 dist
 node_modules
-.DS_Store
+.DS_Store
+package-lock.json

adex/src/http.d.ts

@@ -12,6 +12,11 @@ export type ServerResponse = HTTPServerResponse & {
   json: (data: any) => void
   text: (data: string) => void
   redirect: (url: string, statusCode: number) => void
+  badRequest: (message?: string) => void
+  unauthorized: (message?: string) => void
+  forbidden: (message?: string) => void
+  notFound: (message?: string) => void
+  internalServerError: (message?: string) => void
 }
 
 export function prepareRequest(req: IncomingMessage): void

adex/src/http.js

@@ -59,4 +59,50 @@ export function prepareResponse(res) {
     res.statusCode = statusCode
     res.setHeader('Location', url)
   }
+
+  // HTTP Status helpers
+  res.badRequest = (message) => {
+    res.statusCode = 400
+    if (message) {
+      res.setHeader('content-type', 'application/json')
+      res.write(JSON.stringify({ error: message }))
+    }
+    res.end()
+  }
+
+  res.unauthorized = (message) => {
+    res.statusCode = 401
+    if (message) {
+      res.setHeader('content-type', 'application/json')
+      res.write(JSON.stringify({ error: message }))
+    }
+    res.end()
+  }
+
+  res.forbidden = (message) => {
+    res.statusCode = 403
+    if (message) {
+      res.setHeader('content-type', 'application/json')
+      res.write(JSON.stringify({ error: message }))
+    }
+    res.end()
+  }
+
+  res.notFound = (message) => {
+    res.statusCode = 404
+    if (message) {
+      res.setHeader('content-type', 'application/json')
+      res.write(JSON.stringify({ error: message }))
+    }
+    res.end()
+  }
+
+  res.internalServerError = (message) => {
+    res.statusCode = 500
+    if (message) {
+      res.setHeader('content-type', 'application/json')
+      res.write(JSON.stringify({ error: message }))
+    }
+    res.end()
+  }
 }

adex/tests/response-helpers.spec.js

@@ -0,0 +1,111 @@
+import { describe, it } from 'node:test'
+import assert from 'node:assert'
+import { prepareResponse } from '../src/http.js'
+
+// Mock ServerResponse class
+class MockServerResponse {
+  constructor() {
+    this.statusCode = 200
+    this.headers = {}
+    this.writtenData = []
+    this.ended = false
+  }
+  
+  setHeader(name, value) {
+    this.headers[name] = value
+  }
+  
+  write(data) {
+    this.writtenData.push(data)
+  }
+  
+  end() {
+    this.ended = true
+  }
+}
+
+describe('HTTP Response Helpers', () => {
+  
+  it('badRequest sets 400 status and ends response', () => {
+    const res = new MockServerResponse()
+    prepareResponse(res)
+    
+    res.badRequest()
+    
+    assert.strictEqual(res.statusCode, 400)
+    assert.strictEqual(res.ended, true)
+    assert.strictEqual(res.writtenData.length, 0)
+  })
+  
+  it('badRequest with message sets 400 status and sends JSON error', () => {
+    const res = new MockServerResponse()
+    prepareResponse(res)
+    
+    res.badRequest('Invalid input')
+    
+    assert.strictEqual(res.statusCode, 400)
+    assert.strictEqual(res.ended, true)
+    assert.strictEqual(res.headers['content-type'], 'application/json')
+    assert.strictEqual(res.writtenData[0], JSON.stringify({ error: 'Invalid input' }))
+  })
+  
+  it('unauthorized sets 401 status', () => {
+    const res = new MockServerResponse()
+    prepareResponse(res)
+    
+    res.unauthorized('Authentication required')
+    
+    assert.strictEqual(res.statusCode, 401)
+    assert.strictEqual(res.ended, true)
+    assert.strictEqual(res.headers['content-type'], 'application/json')
+    assert.strictEqual(res.writtenData[0], JSON.stringify({ error: 'Authentication required' }))
+  })
+  
+  it('forbidden sets 403 status', () => {
+    const res = new MockServerResponse()
+    prepareResponse(res)
+    
+    res.forbidden('Access denied')
+    
+    assert.strictEqual(res.statusCode, 403)
+    assert.strictEqual(res.ended, true)
+    assert.strictEqual(res.headers['content-type'], 'application/json')
+    assert.strictEqual(res.writtenData[0], JSON.stringify({ error: 'Access denied' }))
+  })
+  
+  it('notFound sets 404 status', () => {
+    const res = new MockServerResponse()
+    prepareResponse(res)
+    
+    res.notFound('Resource not found')
+    
+    assert.strictEqual(res.statusCode, 404)
+    assert.strictEqual(res.ended, true)
+    assert.strictEqual(res.headers['content-type'], 'application/json')
+    assert.strictEqual(res.writtenData[0], JSON.stringify({ error: 'Resource not found' }))
+  })
+  
+  it('internalServerError sets 500 status', () => {
+    const res = new MockServerResponse()
+    prepareResponse(res)
+    
+    res.internalServerError('Something went wrong')
+    
+    assert.strictEqual(res.statusCode, 500)
+    assert.strictEqual(res.ended, true)
+    assert.strictEqual(res.headers['content-type'], 'application/json')
+    assert.strictEqual(res.writtenData[0], JSON.stringify({ error: 'Something went wrong' }))
+  })
+  
+  it('status helpers without message only set status and end', () => {
+    const res = new MockServerResponse()
+    prepareResponse(res)
+    
+    res.notFound()
+    
+    assert.strictEqual(res.statusCode, 404)
+    assert.strictEqual(res.ended, true)
+    assert.strictEqual(res.writtenData.length, 0)
+    assert.strictEqual(res.headers['content-type'], undefined)
+  })
+})

playground/src/api/status-helpers.js

@@ -0,0 +1,27 @@
+/**
+ * @param {import("adex/http").IncomingMessage} req
+ * @param {import("adex/http").ServerResponse} res
+ */
+export default (req, res) => {
+  const { pathname, searchParams } = new URL(req.url, 'http://localhost')
+  const type = searchParams.get('type')
+  const message = searchParams.get('message')
+
+  switch (type) {
+    case 'badRequest':
+      return res.badRequest(message)
+    case 'unauthorized':
+      return res.unauthorized(message)
+    case 'forbidden':
+      return res.forbidden(message)
+    case 'notFound':
+      return res.notFound(message)
+    case 'internalServerError':
+      return res.internalServerError(message)
+    default:
+      return res.json({
+        usage: 'Add ?type=badRequest&message=Custom%20message to test status helpers',
+        available: ['badRequest', 'unauthorized', 'forbidden', 'notFound', 'internalServerError']
+      })
+  }
+}