raffel 0.1.2

package/dist/http/serve.js

@@ -0,0 +1,200 @@
+/**
+ * Node.js Serve Helper
+ *
+ * Provides a serve() function to run HttpApp with Node.js http server.
+ * Includes graceful shutdown support.
+ */
+import { createServer } from 'node:http';
+// ─────────────────────────────────────────────────────────────────────────────
+// Request Conversion
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Convert Node.js IncomingMessage to Web Request
+ */
+async function nodeRequestToWebRequest(req) {
+    const protocol = req.socket.encrypted ? 'https' : 'http';
+    const host = req.headers.host || 'localhost';
+    const url = `${protocol}://${host}${req.url || '/'}`;
+    // Read body for methods that typically have one
+    let body;
+    if (req.method !== 'GET' && req.method !== 'HEAD' && req.method !== 'OPTIONS') {
+        const chunks = [];
+        for await (const chunk of req) {
+            chunks.push(chunk);
+        }
+        if (chunks.length > 0) {
+            body = Buffer.concat(chunks);
+        }
+    }
+    // Convert headers
+    const headers = {};
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (value) {
+            headers[key] = Array.isArray(value) ? value.join(', ') : value;
+        }
+    }
+    return new Request(url, {
+        method: req.method,
+        headers,
+        body,
+        duplex: body ? 'half' : undefined,
+    });
+}
+/**
+ * Send Web Response to Node.js ServerResponse
+ */
+async function sendWebResponse(webResponse, nodeRes) {
+    // Set status
+    nodeRes.statusCode = webResponse.status;
+    nodeRes.statusMessage = webResponse.statusText || '';
+    // Set headers
+    webResponse.headers.forEach((value, key) => {
+        // Handle Set-Cookie specially (can have multiple values)
+        if (key.toLowerCase() === 'set-cookie') {
+            const existing = nodeRes.getHeader('set-cookie');
+            if (existing) {
+                const values = Array.isArray(existing) ? existing : [String(existing)];
+                nodeRes.setHeader('set-cookie', [...values, value]);
+            }
+            else {
+                nodeRes.setHeader('set-cookie', value);
+            }
+        }
+        else {
+            nodeRes.setHeader(key, value);
+        }
+    });
+    // Send body
+    if (webResponse.body) {
+        const reader = webResponse.body.getReader();
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                nodeRes.write(value);
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    nodeRes.end();
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Serve Function
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create and start an HTTP server for the given fetch handler
+ *
+ * @example
+ * const app = new HttpApp()
+ * app.get('/', (c) => c.text('Hello!'))
+ *
+ * const server = serve({
+ *   fetch: app.fetch,
+ *   port: 3000,
+ *   hostname: '0.0.0.0',
+ *   onListen: ({ port, hostname }) => {
+ *     console.log(`Listening on http://${hostname}:${port}`)
+ *   }
+ * })
+ *
+ * // Graceful shutdown
+ * process.on('SIGTERM', async () => {
+ *   await server.shutdown()
+ * })
+ */
+export function serve(options) {
+    const { fetch, port = 3000, hostname = '0.0.0.0', onListen, onError, } = options;
+    let inFlightCount = 0;
+    let isAcceptingRequests = true;
+    const waitingResolvers = [];
+    /**
+     * Handle incoming request
+     */
+    async function handleRequest(req, res) {
+        // Reject if not accepting
+        if (!isAcceptingRequests) {
+            res.statusCode = 503;
+            res.setHeader('Connection', 'close');
+            res.end('Service Unavailable');
+            return;
+        }
+        inFlightCount++;
+        try {
+            const webRequest = await nodeRequestToWebRequest(req);
+            const webResponse = await fetch(webRequest);
+            await sendWebResponse(webResponse, res);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            onError?.(error);
+            if (!res.headersSent) {
+                res.statusCode = 500;
+                res.end('Internal Server Error');
+            }
+        }
+        finally {
+            inFlightCount--;
+            // Notify waiters if no more requests
+            if (inFlightCount === 0 && waitingResolvers.length > 0) {
+                for (const resolve of waitingResolvers) {
+                    resolve();
+                }
+                waitingResolvers.length = 0;
+            }
+        }
+    }
+    // Create server
+    const server = createServer(handleRequest);
+    // Add graceful shutdown methods
+    server.stopAcceptingRequests = function () {
+        isAcceptingRequests = false;
+    };
+    server.getInFlightCount = function () {
+        return inFlightCount;
+    };
+    server.waitForRequestsToFinish = function (timeoutMs = 30000) {
+        return new Promise((resolve) => {
+            if (inFlightCount === 0) {
+                resolve();
+                return;
+            }
+            const timer = setTimeout(() => {
+                // Remove from waiters
+                const index = waitingResolvers.indexOf(resolveWrap);
+                if (index !== -1) {
+                    waitingResolvers.splice(index, 1);
+                }
+                resolve();
+            }, timeoutMs);
+            const resolveWrap = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            waitingResolvers.push(resolveWrap);
+        });
+    };
+    server.shutdown = async function (timeoutMs = 30000) {
+        this.stopAcceptingRequests();
+        await this.waitForRequestsToFinish(timeoutMs);
+        return new Promise((resolve) => {
+            this.close(() => resolve());
+        });
+    };
+    // Error handling
+    server.on('error', (err) => {
+        onError?.(err);
+    });
+    // Start listening
+    server.listen(port, hostname, () => {
+        onListen?.({ port, hostname });
+    });
+    return server;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────────────────────────
+export default serve;
+//# sourceMappingURL=serve.js.map

package/dist/http/serve.js.map

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

package/dist/http/session.d.ts

@@ -0,0 +1,279 @@
+/**
+ * Session Tracking Middleware
+ *
+ * Manages user sessions with configurable storage backends.
+ * Tracks session metadata including IP, user-agent, and activity timestamps.
+ *
+ * @example
+ * import { createSessionTracker, sessionMiddleware } from 'raffel/http/session'
+ *
+ * // Create session tracker with in-memory storage
+ * const sessions = createSessionTracker({
+ *   maxAge: 3600000,        // 1 hour
+ *   refreshOnAccess: true,  // Reset TTL on activity
+ * })
+ *
+ * // Use as middleware
+ * app.use('*', sessionMiddleware(sessions))
+ *
+ * // Access session in handlers
+ * app.get('/profile', (c) => {
+ *   const session = c.get('session')
+ *   if (!session) return c.json({ error: 'No session' }, 401)
+ *   return c.json({ userId: session.userId })
+ * })
+ */
+import type { HttpContextInterface } from './context.js';
+import type { HttpMiddleware } from './app.js';
+import { type CookieOptions } from './cookie.js';
+/**
+ * Session data stored for each session
+ */
+export interface Session {
+    /** Unique session identifier */
+    id: string;
+    /** User ID (if authenticated) */
+    userId?: string | number;
+    /** When the session was created */
+    createdAt: number;
+    /** Last activity timestamp */
+    lastAccessedAt: number;
+    /** Session expiry timestamp */
+    expiresAt: number;
+    /** Client IP address */
+    ip?: string;
+    /** Client user agent */
+    userAgent?: string;
+    /** Custom session data */
+    data: Record<string, unknown>;
+}
+/**
+ * Session manager configuration options
+ */
+export interface SessionManagerOptions {
+    /**
+     * Session max age in milliseconds
+     * @default 3600000 (1 hour)
+     */
+    maxAge?: number;
+    /**
+     * Refresh session TTL on each access
+     * @default true
+     */
+    refreshOnAccess?: boolean;
+    /**
+     * Session ID generator function
+     * @default crypto.randomUUID
+     */
+    generateId?: () => string;
+    /**
+     * Custom storage backend
+     * @default InMemorySessionStore
+     */
+    store?: SessionStore;
+    /**
+     * Callback when session is created
+     */
+    onCreate?: (session: Session) => void | Promise<void>;
+    /**
+     * Callback when session is accessed
+     */
+    onAccess?: (session: Session) => void | Promise<void>;
+    /**
+     * Callback when session is destroyed
+     */
+    onDestroy?: (sessionId: string) => void | Promise<void>;
+    /**
+     * Cleanup interval for expired sessions (ms)
+     * @default 60000 (1 minute)
+     */
+    cleanupInterval?: number;
+}
+/**
+ * Session storage interface for custom backends
+ */
+export interface SessionStore {
+    /**
+     * Get a session by ID
+     */
+    get(id: string): Promise<Session | undefined>;
+    /**
+     * Save or update a session
+     */
+    set(id: string, session: Session): Promise<void>;
+    /**
+     * Delete a session
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Clear all sessions
+     */
+    clear(): Promise<void>;
+    /**
+     * Get all sessions (for admin/debugging)
+     */
+    getAll(): Promise<Session[]>;
+    /**
+     * Get sessions for a specific user
+     */
+    getByUserId(userId: string | number): Promise<Session[]>;
+    /**
+     * Delete all sessions for a user
+     */
+    deleteByUserId(userId: string | number): Promise<void>;
+    /**
+     * Cleanup expired sessions
+     */
+    cleanup(): Promise<number>;
+}
+/**
+ * Session tracker interface (server-wide session management)
+ */
+export interface SessionTracker {
+    /**
+     * Create a new session
+     */
+    create(options?: {
+        userId?: string | number;
+        ip?: string;
+        userAgent?: string;
+        data?: Record<string, unknown>;
+    }): Promise<Session>;
+    /**
+     * Get a session by ID
+     */
+    get(id: string): Promise<Session | undefined>;
+    /**
+     * Update session data
+     */
+    update(id: string, data: Partial<Pick<Session, 'userId' | 'data'>>): Promise<Session | undefined>;
+    /**
+     * Touch session (update lastAccessedAt and extend expiry)
+     */
+    touch(id: string): Promise<Session | undefined>;
+    /**
+     * Destroy a session
+     */
+    destroy(id: string): Promise<void>;
+    /**
+     * Destroy all sessions for a user
+     */
+    destroyByUserId(userId: string | number): Promise<void>;
+    /**
+     * Get all active sessions
+     */
+    getAll(): Promise<Session[]>;
+    /**
+     * Get sessions for a user
+     */
+    getByUserId(userId: string | number): Promise<Session[]>;
+    /**
+     * Get session statistics
+     */
+    getStats(): Promise<SessionStats>;
+    /**
+     * Clear all sessions
+     */
+    clear(): Promise<void>;
+    /**
+     * Cleanup expired sessions
+     */
+    cleanup(): Promise<number>;
+    /**
+     * Stop cleanup timer (for graceful shutdown)
+     */
+    stop(): void;
+}
+/**
+ * Session statistics
+ */
+export interface SessionStats {
+    totalSessions: number;
+    activeSessions: number;
+    expiredSessions: number;
+    uniqueUsers: number;
+}
+/**
+ * Session middleware options
+ */
+export interface SessionMiddlewareOptions {
+    /**
+     * Cookie name for session ID
+     * @default 'session_id'
+     */
+    cookieName?: string;
+    /**
+     * Cookie options
+     */
+    cookie?: Omit<CookieOptions, 'maxAge' | 'expires'>;
+    /**
+     * Function to extract IP from context
+     */
+    getIp?: (c: HttpContextInterface) => string;
+    /**
+     * Create session automatically if none exists
+     * @default false
+     */
+    autoCreate?: boolean;
+    /**
+     * Key to store session in context
+     * @default 'session'
+     */
+    contextKey?: string;
+}
+/**
+ * Create a session manager
+ *
+ * @param options - Session manager configuration
+ * @returns Session manager instance
+ *
+ * @example
+ * const sessions = createSessionTracker({
+ *   maxAge: 3600000,        // 1 hour
+ *   refreshOnAccess: true,  // Reset TTL on activity
+ *   onDestroy: (id) => console.log(`Session ${id} destroyed`),
+ * })
+ */
+export declare function createSessionTracker(options?: SessionManagerOptions): SessionTracker;
+/**
+ * Create session middleware
+ *
+ * Attaches session to context and manages session cookie.
+ *
+ * @param sessions - Session manager instance
+ * @param options - Middleware options
+ * @returns Middleware function
+ *
+ * @example
+ * const sessions = createSessionTracker()
+ * app.use('*', sessionMiddleware(sessions, { autoCreate: true }))
+ *
+ * app.get('/profile', (c) => {
+ *   const session = c.get('session')
+ *   return c.json({ session })
+ * })
+ */
+export declare function sessionMiddleware<E extends Record<string, unknown> = Record<string, unknown>>(sessions: SessionTracker, options?: SessionMiddlewareOptions): HttpMiddleware<E>;
+/**
+ * Helper to create a session and set it in context (use after login)
+ */
+export declare function createSession<E extends Record<string, unknown>>(c: HttpContextInterface<E>, sessions: SessionTracker, options?: {
+    userId?: string | number;
+    data?: Record<string, unknown>;
+    contextKey?: string;
+}): Promise<Session>;
+/**
+ * Helper to destroy session (use for logout)
+ */
+export declare function destroySession<E extends Record<string, unknown>>(c: HttpContextInterface<E>, sessions: SessionTracker, options?: {
+    cookieName?: string;
+    contextKey?: string;
+}): Promise<void>;
+declare const _default: {
+    createSessionTracker: typeof createSessionTracker;
+    sessionMiddleware: typeof sessionMiddleware;
+    createSession: typeof createSession;
+    destroySession: typeof destroySession;
+};
+export default _default;
+//# sourceMappingURL=session.d.ts.map

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

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