raffel 0.1.2

package/dist/http/session.js

@@ -0,0 +1,354 @@
+/**
+ * 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 { getCookie, setCookie, deleteCookie } from './cookie.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Adapter to convert HttpContextInterface to CookieContext
+ */
+function toCookieContext(c) {
+    return {
+        req: {
+            header: (name) => c.req.header(name),
+            raw: {
+                headers: {
+                    cookie: c.req.header('cookie'),
+                },
+            },
+        },
+        header: (name, value) => c.header(name, value),
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// In-Memory Store
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Default in-memory session store
+ */
+class InMemorySessionStore {
+    sessions = new Map();
+    async get(id) {
+        return this.sessions.get(id);
+    }
+    async set(id, session) {
+        this.sessions.set(id, session);
+    }
+    async delete(id) {
+        this.sessions.delete(id);
+    }
+    async clear() {
+        this.sessions.clear();
+    }
+    async getAll() {
+        return Array.from(this.sessions.values());
+    }
+    async getByUserId(userId) {
+        return Array.from(this.sessions.values()).filter((s) => s.userId === userId);
+    }
+    async deleteByUserId(userId) {
+        for (const [id, session] of this.sessions) {
+            if (session.userId === userId) {
+                this.sessions.delete(id);
+            }
+        }
+    }
+    async cleanup() {
+        const now = Date.now();
+        let count = 0;
+        for (const [id, session] of this.sessions) {
+            if (session.expiresAt <= now) {
+                this.sessions.delete(id);
+                count++;
+            }
+        }
+        return count;
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Session Manager
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 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 function createSessionTracker(options = {}) {
+    const { maxAge = 3600000, // 1 hour
+    refreshOnAccess = true, generateId = () => crypto.randomUUID(), store = new InMemorySessionStore(), onCreate, onAccess, onDestroy, cleanupInterval = 60000, // 1 minute
+     } = options;
+    // Start cleanup timer
+    let cleanupTimer;
+    if (cleanupInterval > 0) {
+        cleanupTimer = setInterval(async () => {
+            await store.cleanup();
+        }, cleanupInterval);
+        // Don't block process exit
+        if (cleanupTimer.unref) {
+            cleanupTimer.unref();
+        }
+    }
+    return {
+        async create(opts = {}) {
+            const now = Date.now();
+            const session = {
+                id: generateId(),
+                userId: opts.userId,
+                createdAt: now,
+                lastAccessedAt: now,
+                expiresAt: now + maxAge,
+                ip: opts.ip,
+                userAgent: opts.userAgent,
+                data: opts.data || {},
+            };
+            await store.set(session.id, session);
+            if (onCreate) {
+                await onCreate(session);
+            }
+            return session;
+        },
+        async get(id) {
+            const session = await store.get(id);
+            if (!session) {
+                return undefined;
+            }
+            // Check if expired
+            if (session.expiresAt <= Date.now()) {
+                await store.delete(id);
+                if (onDestroy) {
+                    await onDestroy(id);
+                }
+                return undefined;
+            }
+            // Update access time if configured
+            if (refreshOnAccess) {
+                const now = Date.now();
+                session.lastAccessedAt = now;
+                session.expiresAt = now + maxAge;
+                await store.set(id, session);
+            }
+            if (onAccess) {
+                await onAccess(session);
+            }
+            return session;
+        },
+        async update(id, data) {
+            const session = await store.get(id);
+            if (!session || session.expiresAt <= Date.now()) {
+                return undefined;
+            }
+            if (data.userId !== undefined) {
+                session.userId = data.userId;
+            }
+            if (data.data !== undefined) {
+                session.data = { ...session.data, ...data.data };
+            }
+            session.lastAccessedAt = Date.now();
+            await store.set(id, session);
+            return session;
+        },
+        async touch(id) {
+            const session = await store.get(id);
+            if (!session || session.expiresAt <= Date.now()) {
+                return undefined;
+            }
+            const now = Date.now();
+            session.lastAccessedAt = now;
+            session.expiresAt = now + maxAge;
+            await store.set(id, session);
+            return session;
+        },
+        async destroy(id) {
+            await store.delete(id);
+            if (onDestroy) {
+                await onDestroy(id);
+            }
+        },
+        async destroyByUserId(userId) {
+            const sessions = await store.getByUserId(userId);
+            for (const session of sessions) {
+                await store.delete(session.id);
+                if (onDestroy) {
+                    await onDestroy(session.id);
+                }
+            }
+        },
+        async getAll() {
+            const all = await store.getAll();
+            const now = Date.now();
+            return all.filter((s) => s.expiresAt > now);
+        },
+        async getByUserId(userId) {
+            const sessions = await store.getByUserId(userId);
+            const now = Date.now();
+            return sessions.filter((s) => s.expiresAt > now);
+        },
+        async getStats() {
+            const all = await store.getAll();
+            const now = Date.now();
+            const active = all.filter((s) => s.expiresAt > now);
+            const expired = all.length - active.length;
+            const uniqueUsers = new Set(active.filter((s) => s.userId).map((s) => s.userId)).size;
+            return {
+                totalSessions: all.length,
+                activeSessions: active.length,
+                expiredSessions: expired,
+                uniqueUsers,
+            };
+        },
+        async clear() {
+            await store.clear();
+        },
+        async cleanup() {
+            return store.cleanup();
+        },
+        stop() {
+            if (cleanupTimer) {
+                clearInterval(cleanupTimer);
+                cleanupTimer = undefined;
+            }
+        },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Middleware
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Default IP extraction function
+ */
+function defaultGetIp(c) {
+    const forwardedFor = c.req.header('x-forwarded-for');
+    if (forwardedFor) {
+        const firstIp = forwardedFor.split(',')[0].trim();
+        if (firstIp)
+            return firstIp;
+    }
+    const realIp = c.req.header('x-real-ip');
+    if (realIp)
+        return realIp;
+    return 'unknown';
+}
+/**
+ * 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 function sessionMiddleware(sessions, options = {}) {
+    const { cookieName = 'session_id', cookie = {}, getIp = defaultGetIp, autoCreate = false, contextKey = 'session', } = options;
+    const cookieOptions = {
+        httpOnly: true,
+        secure: true,
+        sameSite: 'Lax',
+        path: '/',
+        ...cookie,
+    };
+    return async (c, next) => {
+        const cookieCtx = toCookieContext(c);
+        // Try to get existing session from cookie
+        const sessionId = getCookie(cookieCtx, cookieName);
+        let session;
+        if (sessionId) {
+            session = await sessions.get(sessionId);
+        }
+        // Auto-create session if configured
+        if (!session && autoCreate) {
+            session = await sessions.create({
+                ip: getIp(c),
+                userAgent: c.req.header('user-agent'),
+            });
+            // Set session cookie
+            setCookie(cookieCtx, cookieName, session.id, cookieOptions);
+        }
+        // Store session in context
+        if (session) {
+            ;
+            c.set(contextKey, session);
+        }
+        await next();
+        // Check if session was set during request (e.g., after login)
+        const newSession = c.get(contextKey);
+        if (newSession && (!session || newSession.id !== session.id)) {
+            setCookie(cookieCtx, cookieName, newSession.id, cookieOptions);
+        }
+    };
+}
+/**
+ * Helper to create a session and set it in context (use after login)
+ */
+export async function createSession(c, sessions, options = {}) {
+    const { userId, data, contextKey = 'session' } = options;
+    const session = await sessions.create({
+        userId,
+        ip: defaultGetIp(c),
+        userAgent: c.req.header('user-agent'),
+        data,
+    });
+    c.set(contextKey, session);
+    return session;
+}
+/**
+ * Helper to destroy session (use for logout)
+ */
+export async function destroySession(c, sessions, options = {}) {
+    const { cookieName = 'session_id', contextKey = 'session' } = options;
+    const session = c.get(contextKey);
+    if (session) {
+        await sessions.destroy(session.id);
+        c.set(contextKey, undefined);
+    }
+    deleteCookie(toCookieContext(c), cookieName);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────────────────────────
+export default {
+    createSessionTracker,
+    sessionMiddleware,
+    createSession,
+    destroySession,
+};
+//# sourceMappingURL=session.js.map

package/dist/http/session.js.map

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

package/dist/http/static-s3.d.ts

@@ -0,0 +1,176 @@
+/**
+ * S3 Static File Serving Middleware
+ *
+ * Serves static files from AWS S3 (or compatible services) with support for:
+ * - Direct streaming from S3
+ * - Pre-signed URL redirects (for CDN offloading)
+ * - ETag/conditional requests
+ * - Cache-Control headers
+ * - Content-Type from S3 metadata
+ *
+ * @example
+ * import { serveStaticS3 } from 'raffel/http'
+ * import { S3Client } from '@aws-sdk/client-s3'
+ *
+ * const s3 = new S3Client({ region: 'us-east-1' })
+ *
+ * // Proxy mode - stream through server
+ * app.use('/assets/*', serveStaticS3({
+ *   client: s3,
+ *   bucket: 'my-assets-bucket',
+ *   prefix: 'static/'
+ * }))
+ *
+ * // Redirect mode - generate pre-signed URLs
+ * app.use('/files/*', serveStaticS3({
+ *   client: s3,
+ *   bucket: 'my-files-bucket',
+ *   signedUrls: { expiresIn: 3600 }
+ * }))
+ */
+import type { HttpMiddleware } from './app.js';
+/**
+ * Minimal S3 client interface
+ * Compatible with @aws-sdk/client-s3 but doesn't require it as a dependency
+ */
+export interface S3ClientLike {
+    send(command: unknown): Promise<unknown>;
+}
+/**
+ * S3 GetObject command interface
+ */
+export interface S3GetObjectCommand {
+    new (input: {
+        Bucket: string;
+        Key: string;
+    }): unknown;
+}
+/**
+ * S3 HeadObject command interface
+ */
+export interface S3HeadObjectCommand {
+    new (input: {
+        Bucket: string;
+        Key: string;
+    }): unknown;
+}
+/**
+ * Pre-signed URL generator function
+ */
+export type SignedUrlGenerator = (client: S3ClientLike, bucket: string, key: string, expiresIn: number) => Promise<string>;
+/**
+ * S3 static file serving options
+ */
+export interface S3StaticOptions {
+    /**
+     * S3 client instance (from @aws-sdk/client-s3)
+     */
+    client: S3ClientLike;
+    /**
+     * S3 bucket name
+     */
+    bucket: string;
+    /**
+     * Key prefix to prepend to request paths
+     * @default ''
+     */
+    prefix?: string;
+    /**
+     * Max age for Cache-Control header (in seconds)
+     * @default 0
+     */
+    maxAge?: number;
+    /**
+     * Enable immutable directive in Cache-Control
+     * @default false
+     */
+    immutable?: boolean;
+    /**
+     * Default file for directory-like paths (e.g., /foo/ -> /foo/index.html)
+     * @default 'index.html'
+     */
+    index?: string | false;
+    /**
+     * Fallback key when object not found (for SPA)
+     */
+    fallback?: string;
+    /**
+     * Custom headers to add to responses
+     */
+    headers?: Record<string, string>;
+    /**
+     * Rewrite function to modify the key before fetching
+     */
+    rewrite?: (path: string) => string;
+    /**
+     * Strip prefix from request path before building S3 key
+     * @default ''
+     */
+    stripPrefix?: string;
+    /**
+     * Pre-signed URL configuration
+     * When enabled, redirects to S3 with signed URLs instead of proxying
+     */
+    signedUrls?: {
+        /**
+         * URL expiration time in seconds
+         * @default 3600 (1 hour)
+         */
+        expiresIn?: number;
+        /**
+         * Custom function to generate signed URLs
+         * If not provided, you must pass getSignedUrl from @aws-sdk/s3-request-presigner
+         */
+        generator?: SignedUrlGenerator;
+    };
+    /**
+     * GetObjectCommand class from @aws-sdk/client-s3
+     * Required for proxy mode
+     */
+    GetObjectCommand?: S3GetObjectCommand;
+    /**
+     * HeadObjectCommand class from @aws-sdk/client-s3
+     * Required for checking object existence
+     */
+    HeadObjectCommand?: S3HeadObjectCommand;
+}
+/**
+ * Create S3 static file serving middleware
+ *
+ * @param options - S3 static options
+ * @returns Middleware function
+ *
+ * @example
+ * // Proxy mode - requires GetObjectCommand
+ * import { S3Client, GetObjectCommand, HeadObjectCommand } from '@aws-sdk/client-s3'
+ *
+ * const s3 = new S3Client({ region: 'us-east-1' })
+ *
+ * app.use('/assets/*', serveStaticS3({
+ *   client: s3,
+ *   bucket: 'my-bucket',
+ *   prefix: 'assets/',
+ *   GetObjectCommand,
+ *   HeadObjectCommand,
+ *   maxAge: 86400
+ * }))
+ *
+ * @example
+ * // Redirect mode - requires getSignedUrl
+ * import { getSignedUrl } from '@aws-sdk/s3-request-presigner'
+ *
+ * app.use('/files/*', serveStaticS3({
+ *   client: s3,
+ *   bucket: 'my-bucket',
+ *   GetObjectCommand,
+ *   HeadObjectCommand,
+ *   signedUrls: {
+ *     expiresIn: 3600,
+ *     generator: (client, bucket, key, expiresIn) =>
+ *       getSignedUrl(client, new GetObjectCommand({ Bucket: bucket, Key: key }), { expiresIn })
+ *   }
+ * }))
+ */
+export declare function serveStaticS3<E extends Record<string, unknown> = Record<string, unknown>>(options: S3StaticOptions): HttpMiddleware<E>;
+export default serveStaticS3;
+//# sourceMappingURL=static-s3.d.ts.map

package/dist/http/static-s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-s3.d.ts","sourceRoot":"","sources":["../../src/http/static-s3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAM9C;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAA;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAA;CACtD;AA4BD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,MAAM,CAAC,CAAA;AAEpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,YAAY,CAAA;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAElC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE;QACX;;;WAGG;QACH,SAAS,CAAC,EAAE,MAAM,CAAA;QAElB;;;WAGG;QACH,SAAS,CAAC,EAAE,kBAAkB,CAAA;KAC/B,CAAA;IAED;;;OAGG;IACH,gBAAgB,CAAC,EAAE,kBAAkB,CAAA;IAErC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,mBAAmB,CAAA;CACxC;AAwCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvF,OAAO,EAAE,eAAe,GACvB,cAAc,CAAC,CAAC,CAAC,CA+MnB;AAMD,eAAe,aAAa,CAAA"}