raffel 0.1.2

package/dist/http/context-helpers.js

@@ -0,0 +1,325 @@
+/**
+ * Context Helpers
+ *
+ * Convenience response methods that can be added to HttpContext.
+ * These provide a fluent API for common response patterns.
+ *
+ * @example
+ * import { HttpApp, extendContext } from 'raffel/http'
+ *
+ * const app = new HttpApp()
+ *
+ * // Extend context with helpers
+ * app.use('*', extendContext())
+ *
+ * // Now use helpers in handlers
+ * app.get('/users/:id', async (c) => {
+ *   const user = await findUser(c.req.param('id'))
+ *   if (!user) return c.notFoundResponse('User not found')
+ *   return c.successResponse(user)
+ * })
+ *
+ * app.post('/users', async (c) => {
+ *   const data = await c.req.json()
+ *   const errors = validate(data)
+ *   if (errors.length) return c.validationErrorResponse(errors)
+ *   const user = await createUser(data)
+ *   return c.createdResponse(user)
+ * })
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Error Codes
+// ─────────────────────────────────────────────────────────────────────────────
+const ERROR_CODES = {
+    400: 'BAD_REQUEST',
+    401: 'UNAUTHORIZED',
+    403: 'FORBIDDEN',
+    404: 'NOT_FOUND',
+    409: 'CONFLICT',
+    422: 'VALIDATION_ERROR',
+    429: 'TOO_MANY_REQUESTS',
+    500: 'INTERNAL_SERVER_ERROR',
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Context Extension Middleware
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Middleware that extends context with response helpers
+ *
+ * @returns Middleware function
+ *
+ * @example
+ * app.use('*', extendContext())
+ *
+ * app.get('/users/:id', async (c) => {
+ *   const user = await findUser(c.req.param('id'))
+ *   if (!user) return c.notFoundResponse('User not found')
+ *   return c.successResponse(user)
+ * })
+ */
+export function extendContext() {
+    return async (c, next) => {
+        const ctx = c;
+        // Success response
+        ctx.successResponse = function (data, status = 200) {
+            return createJsonResponse({ success: true, data }, status);
+        };
+        // Error response
+        ctx.errorResponse = function (message, status = 500, code) {
+            return createJsonResponse({
+                success: false,
+                error: {
+                    message,
+                    code: code || ERROR_CODES[status] || 'ERROR',
+                },
+            }, status);
+        };
+        // Created response (201)
+        ctx.createdResponse = function (data) {
+            return createJsonResponse({ success: true, data }, 201);
+        };
+        // No content response (204)
+        ctx.noContentResponse = function () {
+            return new Response(null, { status: 204 });
+        };
+        // Bad request response (400)
+        ctx.badRequestResponse = function (message = 'Bad Request', details) {
+            return createJsonResponse({
+                success: false,
+                error: {
+                    message,
+                    code: 'BAD_REQUEST',
+                    ...(details !== undefined && { details }),
+                },
+            }, 400);
+        };
+        // Unauthorized response (401)
+        ctx.unauthorizedResponse = function (message = 'Unauthorized') {
+            return createJsonResponse({
+                success: false,
+                error: {
+                    message,
+                    code: 'UNAUTHORIZED',
+                },
+            }, 401);
+        };
+        // Forbidden response (403)
+        ctx.forbiddenResponse = function (message = 'Forbidden') {
+            return createJsonResponse({
+                success: false,
+                error: {
+                    message,
+                    code: 'FORBIDDEN',
+                },
+            }, 403);
+        };
+        // Not found response (404)
+        ctx.notFoundResponse = function (message = 'Not Found') {
+            return createJsonResponse({
+                success: false,
+                error: {
+                    message,
+                    code: 'NOT_FOUND',
+                },
+            }, 404);
+        };
+        // Conflict response (409)
+        ctx.conflictResponse = function (message = 'Conflict', details) {
+            return createJsonResponse({
+                success: false,
+                error: {
+                    message,
+                    code: 'CONFLICT',
+                    ...(details !== undefined && { details }),
+                },
+            }, 409);
+        };
+        // Validation error response (422)
+        ctx.validationErrorResponse = function (errors) {
+            return createJsonResponse({
+                success: false,
+                error: {
+                    message: 'Validation Error',
+                    code: 'VALIDATION_ERROR',
+                    details: { errors },
+                },
+            }, 422);
+        };
+        // Too many requests response (429)
+        ctx.tooManyRequestsResponse = function (message = 'Too Many Requests', retryAfter) {
+            const headers = {
+                'Content-Type': 'application/json; charset=UTF-8',
+            };
+            if (retryAfter !== undefined) {
+                headers['Retry-After'] = retryAfter.toString();
+            }
+            return new Response(JSON.stringify({
+                success: false,
+                error: {
+                    message,
+                    code: 'TOO_MANY_REQUESTS',
+                },
+            }), { status: 429, headers });
+        };
+        // Server error response (500)
+        ctx.serverErrorResponse = function (message = 'Internal Server Error') {
+            return createJsonResponse({
+                success: false,
+                error: {
+                    message,
+                    code: 'INTERNAL_SERVER_ERROR',
+                },
+            }, 500);
+        };
+        await next();
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Standalone Helper Functions
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create a success response (standalone function)
+ */
+export function successResponse(data, status = 200) {
+    return createJsonResponse({ success: true, data }, status);
+}
+/**
+ * Create an error response (standalone function)
+ */
+export function errorResponse(message, status = 500, code) {
+    return createJsonResponse({
+        success: false,
+        error: {
+            message,
+            code: code || ERROR_CODES[status] || 'ERROR',
+        },
+    }, status);
+}
+/**
+ * Create a 201 Created response (standalone function)
+ */
+export function createdResponse(data) {
+    return createJsonResponse({ success: true, data }, 201);
+}
+/**
+ * Create a 204 No Content response (standalone function)
+ */
+export function noContentResponse() {
+    return new Response(null, { status: 204 });
+}
+/**
+ * Create a 400 Bad Request response (standalone function)
+ */
+export function badRequestResponse(message = 'Bad Request', details) {
+    return createJsonResponse({
+        success: false,
+        error: {
+            message,
+            code: 'BAD_REQUEST',
+            ...(details !== undefined && { details }),
+        },
+    }, 400);
+}
+/**
+ * Create a 401 Unauthorized response (standalone function)
+ */
+export function unauthorizedResponse(message = 'Unauthorized') {
+    return createJsonResponse({
+        success: false,
+        error: {
+            message,
+            code: 'UNAUTHORIZED',
+        },
+    }, 401);
+}
+/**
+ * Create a 403 Forbidden response (standalone function)
+ */
+export function forbiddenResponse(message = 'Forbidden') {
+    return createJsonResponse({
+        success: false,
+        error: {
+            message,
+            code: 'FORBIDDEN',
+        },
+    }, 403);
+}
+/**
+ * Create a 404 Not Found response (standalone function)
+ */
+export function notFoundResponse(message = 'Not Found') {
+    return createJsonResponse({
+        success: false,
+        error: {
+            message,
+            code: 'NOT_FOUND',
+        },
+    }, 404);
+}
+/**
+ * Create a 409 Conflict response (standalone function)
+ */
+export function conflictResponse(message = 'Conflict', details) {
+    return createJsonResponse({
+        success: false,
+        error: {
+            message,
+            code: 'CONFLICT',
+            ...(details !== undefined && { details }),
+        },
+    }, 409);
+}
+/**
+ * Create a 422 Validation Error response (standalone function)
+ */
+export function validationErrorResponse(errors) {
+    return createJsonResponse({
+        success: false,
+        error: {
+            message: 'Validation Error',
+            code: 'VALIDATION_ERROR',
+            details: { errors },
+        },
+    }, 422);
+}
+/**
+ * Create a 500 Server Error response (standalone function)
+ */
+export function serverErrorResponse(message = 'Internal Server Error') {
+    return createJsonResponse({
+        success: false,
+        error: {
+            message,
+            code: 'INTERNAL_SERVER_ERROR',
+        },
+    }, 500);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+function createJsonResponse(body, status) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: {
+            'Content-Type': 'application/json; charset=UTF-8',
+        },
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────────────────────────
+export default {
+    extendContext,
+    successResponse,
+    errorResponse,
+    createdResponse,
+    noContentResponse,
+    badRequestResponse,
+    unauthorizedResponse,
+    forbiddenResponse,
+    notFoundResponse,
+    conflictResponse,
+    validationErrorResponse,
+    serverErrorResponse,
+};
+//# sourceMappingURL=context-helpers.js.map

package/dist/http/context-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers.js","sourceRoot":"","sources":["../../src/http/context-helpers.ts"],"names":[],"mappings":"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"}

package/dist/http/context.d.ts

@@ -0,0 +1,157 @@
+/**
+ * HttpContext - Hono-compatible HTTP Context
+ *
+ * Provides:
+ * - Request helpers: c.req.param(), c.req.query(), c.req.json(), c.req.header(), etc.
+ * - Response helpers: c.json(), c.text(), c.html(), c.body(), c.redirect()
+ * - Context storage: c.set(), c.get(), c.var
+ */
+import type { BodyInit, HeadersInit, FetchEvent, ExecutionContext } from './web-types.js';
+/** HTTP Request wrapper interface */
+export interface HttpRequest {
+    /** Raw Request object */
+    raw: Request;
+    /** HTTP method */
+    readonly method: string;
+    /** Request URL */
+    readonly url: string;
+    /** Request path (without query string) */
+    readonly path: string;
+    /**
+     * Get path parameters
+     * @param name - Parameter name (e.g., 'id' for /users/:id), or undefined for all params
+     */
+    param(name?: string): string | undefined | Record<string, string>;
+    /**
+     * Get query parameters
+     * @param name - Query parameter name, or undefined for all params
+     */
+    query(name?: string): string | undefined | Record<string, string>;
+    /**
+     * Get header values
+     * @param name - Header name (case-insensitive), or undefined for all headers
+     */
+    header(name?: string): string | undefined | Record<string, string>;
+    /**
+     * Parse request body as JSON
+     * @throws If body is not valid JSON
+     */
+    json<T = unknown>(): Promise<T>;
+    /**
+     * Get request body as text
+     */
+    text(): Promise<string>;
+    /**
+     * Get request body as ArrayBuffer
+     */
+    arrayBuffer(): Promise<ArrayBuffer>;
+    /**
+     * Get request body as Blob
+     */
+    blob(): Promise<Blob>;
+    /**
+     * Get request body as FormData
+     */
+    formData(): Promise<FormData>;
+    /**
+     * Check if request has valid JSON body
+     */
+    valid<T>(target: 'json'): T;
+}
+/** Response status code */
+export type StatusCode = 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 304 | 305 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511;
+/** Status codes that can have content */
+export type ContentfulStatusCode = Exclude<StatusCode, 204 | 205 | 304>;
+/** JSON response options */
+export interface JsonOptions {
+    status?: StatusCode;
+    headers?: HeadersInit;
+}
+/** Redirect options */
+export interface RedirectOptions {
+    status?: 301 | 302 | 303 | 307 | 308;
+}
+/** HTTP Context interface */
+export interface HttpContextInterface<E extends Record<string, unknown> = Record<string, unknown>> {
+    /** Request wrapper */
+    req: HttpRequest;
+    /** Response (set by handler) */
+    res: Response | undefined;
+    /** Event for Workers/edge environments */
+    event?: FetchEvent;
+    /** Execution context for Workers */
+    executionCtx?: ExecutionContext;
+    /**
+     * Set a variable in context storage
+     */
+    set<K extends keyof E>(key: K, value: E[K]): void;
+    /**
+     * Get a variable from context storage
+     */
+    get<K extends keyof E>(key: K): E[K] | undefined;
+    /**
+     * Access all context variables
+     */
+    readonly var: E & Record<string, unknown>;
+    /**
+     * Set a response header
+     */
+    header(name: string, value: string): void;
+    /**
+     * Get response status
+     */
+    status(code: StatusCode): void;
+    /**
+     * Create a JSON response
+     */
+    json<T>(data: T, status?: ContentfulStatusCode, headers?: HeadersInit): Response;
+    json<T>(data: T, init?: JsonOptions): Response;
+    /**
+     * Create a text response
+     */
+    text(data: string, status?: ContentfulStatusCode, headers?: HeadersInit): Response;
+    /**
+     * Create an HTML response
+     */
+    html(data: string, status?: ContentfulStatusCode, headers?: HeadersInit): Response;
+    /**
+     * Create a response with a body
+     */
+    body(data: BodyInit | null, status?: StatusCode, headers?: HeadersInit): Response;
+    /**
+     * Create a redirect response
+     */
+    redirect(location: string, status?: 301 | 302 | 303 | 307 | 308): Response;
+    /**
+     * Create a not found response
+     */
+    notFound(): Response;
+    /**
+     * Create a new response with the given init
+     */
+    newResponse(body: BodyInit | null, init?: ResponseInit): Response;
+}
+export declare class HttpContext<E extends Record<string, unknown> = Record<string, unknown>> implements HttpContextInterface<E> {
+    req: HttpRequest;
+    res: Response | undefined;
+    event?: FetchEvent;
+    executionCtx?: ExecutionContext;
+    private variables;
+    private responseHeaders;
+    private responseStatus;
+    constructor(request: Request, params?: Record<string, string>);
+    set<K extends keyof E>(key: K, value: E[K]): void;
+    get<K extends keyof E>(key: K): E[K] | undefined;
+    get var(): E & Record<string, unknown>;
+    header(name: string, value: string): void;
+    status(code: StatusCode): void;
+    json<T>(data: T, statusOrInit?: ContentfulStatusCode | JsonOptions, headers?: HeadersInit): Response;
+    text(data: string, status?: ContentfulStatusCode, headers?: HeadersInit): Response;
+    html(data: string, status?: ContentfulStatusCode, headers?: HeadersInit): Response;
+    body(data: BodyInit | null, status?: StatusCode, headers?: HeadersInit): Response;
+    redirect(location: string, status?: 301 | 302 | 303 | 307 | 308): Response;
+    notFound(): Response;
+    newResponse(body: BodyInit | null, init?: ResponseInit): Response;
+}
+export default HttpContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/http/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/http/context.ts"],"names":[],"mappings":"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"}