raffel 0.1.2

package/dist/http/static-s3.js

@@ -0,0 +1,282 @@
+/**
+ * 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 }
+ * }))
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// MIME Types (fallback when S3 doesn't provide Content-Type)
+// ─────────────────────────────────────────────────────────────────────────────
+const MIME_TYPES = {
+    '.html': 'text/html; charset=UTF-8',
+    '.htm': 'text/html; charset=UTF-8',
+    '.css': 'text/css; charset=UTF-8',
+    '.js': 'application/javascript; charset=UTF-8',
+    '.mjs': 'application/javascript; charset=UTF-8',
+    '.json': 'application/json; charset=UTF-8',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.pdf': 'application/pdf',
+    '.zip': 'application/zip',
+    '.wasm': 'application/wasm',
+};
+/**
+ * Get MIME type from extension
+ */
+function getMimeType(key) {
+    const ext = key.slice(key.lastIndexOf('.')).toLowerCase();
+    return MIME_TYPES[ext] || 'application/octet-stream';
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// S3 Static File Middleware
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 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 function serveStaticS3(options) {
+    const { client, bucket, prefix = '', maxAge = 0, immutable = false, index = 'index.html', fallback, headers: customHeaders, rewrite, stripPrefix = '', signedUrls, GetObjectCommand, HeadObjectCommand, } = options;
+    // Validate required commands for proxy mode
+    if (!signedUrls && !GetObjectCommand) {
+        throw new Error('serveStaticS3 requires GetObjectCommand in proxy mode');
+    }
+    return async (c, next) => {
+        // Only handle GET and HEAD requests
+        if (c.req.method !== 'GET' && c.req.method !== 'HEAD') {
+            await next();
+            return;
+        }
+        // Get request path
+        let requestPath = decodeURIComponent(new URL(c.req.url).pathname);
+        // Strip prefix if configured
+        if (stripPrefix && requestPath.startsWith(stripPrefix)) {
+            requestPath = requestPath.slice(stripPrefix.length) || '/';
+        }
+        // Apply rewrite if configured
+        if (rewrite) {
+            requestPath = rewrite(requestPath);
+        }
+        // Remove leading slash and build S3 key
+        const cleanPath = requestPath.replace(/^\/+/, '');
+        let s3Key = prefix + cleanPath;
+        // Handle directory-like paths
+        if (index && (s3Key.endsWith('/') || !s3Key.includes('.'))) {
+            if (!s3Key.endsWith('/'))
+                s3Key += '/';
+            s3Key += index;
+        }
+        try {
+            // Check if object exists (HEAD request)
+            let objectInfo = null;
+            if (HeadObjectCommand) {
+                try {
+                    const headCommand = new HeadObjectCommand({ Bucket: bucket, Key: s3Key });
+                    objectInfo = (await client.send(headCommand));
+                }
+                catch (err) {
+                    const error = err;
+                    if (error.name === 'NotFound' || error.name === 'NoSuchKey') {
+                        // Object not found - try fallback
+                        if (fallback) {
+                            const fallbackKey = prefix + fallback.replace(/^\/+/, '');
+                            try {
+                                const fallbackHead = new HeadObjectCommand({ Bucket: bucket, Key: fallbackKey });
+                                objectInfo = (await client.send(fallbackHead));
+                                s3Key = fallbackKey;
+                            }
+                            catch {
+                                await next();
+                                return;
+                            }
+                        }
+                        else {
+                            await next();
+                            return;
+                        }
+                    }
+                    else {
+                        throw err;
+                    }
+                }
+            }
+            // Build response headers
+            const responseHeaders = {};
+            // Content-Type
+            responseHeaders['Content-Type'] = objectInfo?.ContentType || getMimeType(s3Key);
+            // Content-Length
+            if (objectInfo?.ContentLength) {
+                responseHeaders['Content-Length'] = objectInfo.ContentLength.toString();
+            }
+            // Cache-Control
+            const cacheDirectives = [];
+            if (maxAge > 0) {
+                cacheDirectives.push(`max-age=${maxAge}`);
+            }
+            else {
+                cacheDirectives.push('no-cache');
+            }
+            if (immutable) {
+                cacheDirectives.push('immutable');
+            }
+            responseHeaders['Cache-Control'] = cacheDirectives.join(', ');
+            // Last-Modified
+            if (objectInfo?.LastModified) {
+                responseHeaders['Last-Modified'] = objectInfo.LastModified.toUTCString();
+            }
+            // ETag (from S3)
+            if (objectInfo?.ETag) {
+                responseHeaders['ETag'] = objectInfo.ETag;
+            }
+            // Custom headers
+            if (customHeaders) {
+                Object.assign(responseHeaders, customHeaders);
+            }
+            // Check conditional requests
+            const ifNoneMatch = c.req.header('if-none-match');
+            if (ifNoneMatch && objectInfo?.ETag) {
+                // S3 ETags may or may not have quotes
+                const normalizedETag = objectInfo.ETag.replace(/"/g, '');
+                const normalizedIfNoneMatch = ifNoneMatch.replace(/"/g, '');
+                if (normalizedETag === normalizedIfNoneMatch) {
+                    c.res = new Response(null, {
+                        status: 304,
+                        headers: responseHeaders,
+                    });
+                    return;
+                }
+            }
+            const ifModifiedSince = c.req.header('if-modified-since');
+            if (ifModifiedSince && objectInfo?.LastModified) {
+                const ifModifiedDate = new Date(ifModifiedSince);
+                if (objectInfo.LastModified <= ifModifiedDate) {
+                    c.res = new Response(null, {
+                        status: 304,
+                        headers: responseHeaders,
+                    });
+                    return;
+                }
+            }
+            // HEAD request - just return headers
+            if (c.req.method === 'HEAD') {
+                c.res = new Response(null, {
+                    status: 200,
+                    headers: responseHeaders,
+                });
+                return;
+            }
+            // Signed URL mode - redirect to S3
+            if (signedUrls?.generator) {
+                const expiresIn = signedUrls.expiresIn ?? 3600;
+                const signedUrl = await signedUrls.generator(client, bucket, s3Key, expiresIn);
+                c.res = new Response(null, {
+                    status: 302,
+                    headers: {
+                        Location: signedUrl,
+                        'Cache-Control': `private, max-age=${Math.min(expiresIn - 60, maxAge || expiresIn - 60)}`,
+                    },
+                });
+                return;
+            }
+            // Proxy mode - stream from S3
+            if (!GetObjectCommand) {
+                throw new Error('GetObjectCommand required for proxy mode');
+            }
+            const getCommand = new GetObjectCommand({ Bucket: bucket, Key: s3Key });
+            const response = (await client.send(getCommand));
+            // Get stream from response
+            let body = null;
+            if (response.Body?.transformToWebStream) {
+                // AWS SDK v3 style
+                body = response.Body.transformToWebStream();
+            }
+            else if (response.Body?.transformToByteArray) {
+                // Alternative AWS SDK v3 method
+                body = await response.Body.transformToByteArray();
+            }
+            c.res = new Response(body, {
+                status: 200,
+                headers: responseHeaders,
+            });
+        }
+        catch (err) {
+            const error = err;
+            // S3 errors
+            if (error.name === 'NotFound' || error.name === 'NoSuchKey' || error.name === 'AccessDenied') {
+                await next();
+                return;
+            }
+            // Re-throw other errors
+            throw err;
+        }
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────────────────────────
+export default serveStaticS3;
+//# sourceMappingURL=static-s3.js.map

package/dist/http/static-s3.js.map

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

package/dist/http/static.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Static File Serving Middleware
+ *
+ * Serves static files from the filesystem with support for:
+ * - Directory indexing
+ * - ETag/conditional requests
+ * - Cache-Control headers
+ * - Content-Type detection
+ * - Range requests (partial content)
+ * - Dotfiles handling
+ *
+ * @example
+ * import { serveStatic } from 'raffel/http'
+ *
+ * // Serve files from 'public' directory
+ * app.use('/static/*', serveStatic({ root: './public' }))
+ *
+ * // With options
+ * app.use('/assets/*', serveStatic({
+ *   root: './assets',
+ *   maxAge: 86400,
+ *   index: 'index.html',
+ *   dotfiles: 'ignore'
+ * }))
+ */
+import type { HttpMiddleware } from './app.js';
+/**
+ * Static file serving options
+ */
+export interface StaticOptions {
+    /**
+     * Root directory to serve files from
+     */
+    root: string;
+    /**
+     * Default file to serve for directory requests
+     * @default 'index.html'
+     */
+    index?: string | false;
+    /**
+     * Max age for Cache-Control header (in seconds)
+     * @default 0
+     */
+    maxAge?: number;
+    /**
+     * Enable immutable directive in Cache-Control
+     * @default false
+     */
+    immutable?: boolean;
+    /**
+     * How to handle dotfiles (files starting with .)
+     * - 'allow': Serve dotfiles normally
+     * - 'deny': Return 403 for dotfiles
+     * - 'ignore': Return 404 for dotfiles (pretend they don't exist)
+     * @default 'ignore'
+     */
+    dotfiles?: 'allow' | 'deny' | 'ignore';
+    /**
+     * Enable ETag generation
+     * @default true
+     */
+    etag?: boolean;
+    /**
+     * Enable Last-Modified header
+     * @default true
+     */
+    lastModified?: boolean;
+    /**
+     * Fallback file to serve when file not found (for SPA)
+     */
+    fallback?: string;
+    /**
+     * Custom headers to add to responses
+     */
+    headers?: Record<string, string>;
+    /**
+     * Rewrite function to modify the path before serving
+     */
+    rewrite?: (path: string) => string;
+    /**
+     * Prefix to strip from the request path
+     * @default ''
+     */
+    prefix?: string;
+}
+/**
+ * Create static file serving middleware
+ *
+ * @param options - Static file options
+ * @returns Middleware function
+ *
+ * @example
+ * // Basic usage
+ * app.use('/public/*', serveStatic({ root: './public' }))
+ *
+ * // With caching
+ * app.use('/assets/*', serveStatic({
+ *   root: './dist/assets',
+ *   maxAge: 31536000, // 1 year
+ *   immutable: true
+ * }))
+ *
+ * // SPA fallback
+ * app.use('/*', serveStatic({
+ *   root: './dist',
+ *   fallback: 'index.html'
+ * }))
+ */
+export declare function serveStatic<E extends Record<string, unknown> = Record<string, unknown>>(options: StaticOptions): HttpMiddleware<E>;
+export default serveStatic;
+//# sourceMappingURL=static.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/http/static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAM9C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;IAEtC;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,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,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAoED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrF,OAAO,EAAE,aAAa,GACrB,cAAc,CAAC,CAAC,CAAC,CAqNnB;AAsGD,eAAe,WAAW,CAAA"}