@remix-run/response 0.2.1 → 0.3.1

package/README.md

@@ -31,14 +31,14 @@ import { compressResponse } from '@remix-run/response/compress'
 
 ### File Responses
 
-The `createFileResponse` helper creates a response for serving files with full HTTP semantics:
+The `createFileResponse` helper creates a response for serving files with full HTTP semantics. It works with both native `File` objects and `LazyFile` from `@remix-run/lazy-file`:
 
 ```ts
 import { createFileResponse } from '@remix-run/response/file'
-import { openFile } from '@remix-run/fs'
+import { openLazyFile } from '@remix-run/fs'
 
-let file = await openFile('./public/image.jpg')
-let response = await createFileResponse(file, request, {
+let lazyFile = openLazyFile('./public/image.jpg')
+let response = await createFileResponse(lazyFile, request, {
   cacheControl: 'public, max-age=3600',
 })
 ```

package/dist/lib/compress.d.ts

@@ -63,6 +63,10 @@ export declare function compressResponse(response: Response, request: Request, o
  * Compresses a response stream that bridges node:zlib to Web Streams.
  * Reads from the input stream, compresses chunks through the compressor,
  * and returns a new ReadableStream with the compressed data.
+ *
+ * @param input The input stream to compress
+ * @param compressor The zlib compressor instance to use
+ * @returns A new ReadableStream with the compressed data
  */
 export declare function compressStream(input: ReadableStream<Uint8Array>, compressor: Gzip | Deflate | BrotliCompress): ReadableStream<Uint8Array>;
 //# sourceMappingURL=compress.d.ts.map

package/dist/lib/compress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../../src/lib/compress.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,IAAI,EACT,KAAK,OAAO,EACb,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAI3D,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAAA;AAGhD,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IAEtB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAElB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,QAAQ,CAAC,CAuDnB;AA8ED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,EACjC,UAAU,EAAE,IAAI,GAAG,OAAO,GAAG,cAAc,GAC1C,cAAc,CAAC,UAAU,CAAC,CA2F5B"}
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../../src/lib/compress.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,IAAI,EACT,KAAK,OAAO,EACb,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAI3D,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAAA;AAGhD,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IAEtB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAElB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,QAAQ,CAAC,CA6DnB;AAmFD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,EACjC,UAAU,EAAE,IAAI,GAAG,OAAO,GAAG,cAAc,GAC1C,cAAc,CAAC,UAAU,CAAC,CA2F5B"}

package/dist/lib/compress.js

@@ -1,5 +1,5 @@
 import { constants, createBrotliCompress, createDeflate, createGzip, } from 'node:zlib';
-import { AcceptEncoding, SuperHeaders } from '@remix-run/headers';
+import { AcceptEncoding, CacheControl, Vary } from '@remix-run/headers';
 const defaultEncodings = ['br', 'gzip', 'deflate'];
 /**
  * Compresses a Response based on the client's Accept-Encoding header.
@@ -30,24 +30,29 @@ export async function compressResponse(response, request, options) {
     let supportedEncodings = compressOptions.encodings ?? defaultEncodings;
     let threshold = compressOptions.threshold ?? 1024;
     let acceptEncodingHeader = request.headers.get('Accept-Encoding');
-    let responseHeaders = new SuperHeaders(response.headers);
+    let responseHeaders = new Headers(response.headers);
+    let contentEncodingHeader = responseHeaders.get('content-encoding');
+    let contentLengthHeader = responseHeaders.get('content-length');
+    let contentLength = contentLengthHeader != null ? parseInt(contentLengthHeader, 10) : null;
+    let acceptRangesHeader = responseHeaders.get('accept-ranges');
+    let cacheControl = CacheControl.from(responseHeaders.get('cache-control'));
     if (!acceptEncodingHeader ||
         supportedEncodings.length === 0 ||
         // Empty response
         (request.method !== 'HEAD' && !response.body) ||
         // Already compressed
-        responseHeaders.contentEncoding != null ||
+        contentEncodingHeader != null ||
         // Content-Length below threshold
-        (responseHeaders.contentLength != null && responseHeaders.contentLength < threshold) ||
+        (contentLength != null && contentLength < threshold) ||
         // Cache-Control: no-transform
-        responseHeaders.cacheControl.noTransform ||
+        cacheControl.noTransform ||
         // Response advertising range support
-        responseHeaders.acceptRanges === 'bytes' ||
+        acceptRangesHeader === 'bytes' ||
         // Partial content responses
         response.status === 206) {
         return response;
     }
-    let acceptEncoding = new AcceptEncoding(acceptEncodingHeader);
+    let acceptEncoding = AcceptEncoding.from(acceptEncodingHeader);
     let selectedEncoding = negotiateEncoding(acceptEncoding, supportedEncodings);
     if (selectedEncoding === null) {
         // Client has explicitly rejected all supported encodings, including 'identity'
@@ -83,13 +88,17 @@ function negotiateEncoding(acceptEncoding, supportedEncodings) {
     return preferred;
 }
 function setCompressionHeaders(headers, encoding) {
-    headers.contentEncoding = encoding;
-    headers.acceptRanges = 'none';
-    headers.contentLength = null;
-    headers.vary.add('Accept-Encoding');
+    headers.set('content-encoding', encoding);
+    headers.set('accept-ranges', 'none');
+    headers.delete('content-length');
+    // Update Vary header to include Accept-Encoding
+    let vary = Vary.from(headers.get('vary'));
+    vary.add('Accept-Encoding');
+    headers.set('vary', vary.toString());
     // Convert strong ETags to weak since compressed representation is byte-different
-    if (headers.etag && !headers.etag.startsWith('W/')) {
-        headers.etag = `W/${headers.etag}`;
+    let etagHeader = headers.get('etag');
+    if (etagHeader && !etagHeader.startsWith('W/')) {
+        headers.set('etag', `W/${etagHeader}`);
     }
 }
 const zlibFlushOptions = {
@@ -103,8 +112,8 @@ function applyCompression(response, responseHeaders, encoding, options) {
         return response;
     }
     // Detect SSE for automatic flush configuration
-    let contentType = response.headers.get('Content-Type');
-    let mediaType = contentType?.split(';')[0].trim();
+    let contentTypeHeader = response.headers.get('Content-Type');
+    let mediaType = contentTypeHeader?.split(';')[0].trim();
     let isSSE = mediaType === 'text/event-stream';
     let compressor = createCompressor(encoding, {
         ...options,
@@ -129,6 +138,10 @@ function applyCompression(response, responseHeaders, encoding, options) {
  * Compresses a response stream that bridges node:zlib to Web Streams.
  * Reads from the input stream, compresses chunks through the compressor,
  * and returns a new ReadableStream with the compressed data.
+ *
+ * @param input The input stream to compress
+ * @param compressor The zlib compressor instance to use
+ * @returns A new ReadableStream with the compressed data
  */
 export function compressStream(input, compressor) {
     let reader = null;

package/dist/lib/file.d.ts

@@ -1,3 +1,24 @@
+/**
+ * Minimal interface for file-like objects used by `createFileResponse`.
+ */
+export interface FileLike {
+    /** File compatibility - included for interface completeness */
+    readonly name: string;
+    /** Used for Content-Length header and range calculations */
+    readonly size: number;
+    /** Used for Content-Type header */
+    readonly type: string;
+    /** Used for Last-Modified header and weak ETag generation */
+    readonly lastModified: number;
+    /** Used for streaming the response body */
+    stream(): ReadableStream<Uint8Array>;
+    /** Used for strong ETag digest calculation */
+    arrayBuffer(): Promise<ArrayBuffer>;
+    /** Used for range requests (206 Partial Content) */
+    slice(start?: number, end?: number, contentType?: string): {
+        stream(): ReadableStream<Uint8Array>;
+    };
+}
 /**
  * Custom function for computing file digests.
  *
@@ -10,11 +31,11 @@
  *   return customHash(buffer)
  * }
  */
-export type FileDigestFunction = (file: File) => Promise<string>;
+export type FileDigestFunction<file extends FileLike = File> = (file: file) => Promise<string>;
 /**
  * Options for creating a file response.
  */
-export interface FileResponseOptions {
+export interface FileResponseOptions<file extends FileLike = File> {
     /**
      * Cache-Control header value. If not provided, no Cache-Control header will be set.
      *
@@ -39,14 +60,14 @@ export interface FileResponseOptions {
      * - String: Web Crypto API algorithm name ('SHA-256', 'SHA-384', 'SHA-512', 'SHA-1').
      *   Note: Using strong ETags will buffer the entire file into memory before hashing.
      *   Consider using weak ETags (default) or a custom digest function for large files.
-     * - Function: Custom digest computation that receives a File and returns the digest string
+     * - Function: Custom digest computation that receives a file and returns the digest string
      *
      * Only used when `etag: 'strong'`. Ignored for weak ETags.
      *
      * @default 'SHA-256'
      * @example async (file) => await customHash(file)
      */
-    digest?: AlgorithmIdentifier | FileDigestFunction;
+    digest?: AlgorithmIdentifier | FileDigestFunction<file>;
     /**
      * Whether to include `Last-Modified` headers.
      *
@@ -73,17 +94,21 @@ export interface FileResponseOptions {
  * Creates a file [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response)
  * with full HTTP semantics including ETags, Last-Modified, conditional requests, and Range support.
  *
- * @param file The file to send
+ * Accepts both native `File` objects and `LazyFile` from `@remix-run/lazy-file`.
+ *
+ * @param file The file to send (native `File` or `LazyFile`)
  * @param request The request object
  * @param options Configuration options
  * @returns A `Response` object containing the file
  *
  * @example
  * import { createFileResponse } from '@remix-run/response/file'
- * let file = openFile('./public/image.jpg')
- * return createFileResponse(file, request, {
+ * import { openLazyFile } from '@remix-run/fs'
+ *
+ * let lazyFile = openLazyFile('./public/image.jpg')
+ * return createFileResponse(lazyFile, request, {
  *   cacheControl: 'public, max-age=3600'
  * })
  */
-export declare function createFileResponse(file: File, request: Request, options?: FileResponseOptions): Promise<Response>;
+export declare function createFileResponse<file extends FileLike>(file: file, request: Request, options?: FileResponseOptions<file>): Promise<Response>;
 //# sourceMappingURL=file.d.ts.map

package/dist/lib/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/lib/file.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAEhE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAA;IAChC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,mBAAmB,GAAG,kBAAkB,CAAA;IACjD;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,QAAQ,CAAC,CA+KnB"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/lib/file.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,2CAA2C;IAC3C,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,CAAA;IACpC,8CAA8C;IAC9C,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;IACnC,oDAAoD;IACpD,KAAK,CACH,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,GACnB;QAAE,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,CAAA;KAAE,CAAA;CAC5C;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,CAAC,IAAI,SAAS,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAE9F;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,IAAI,SAAS,QAAQ,GAAG,IAAI;IAC/D;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAA;IAChC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,mBAAmB,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;IACvD;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,SAAS,QAAQ,EAC5D,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,mBAAmB,CAAC,IAAI,CAAM,GACtC,OAAO,CAAC,QAAQ,CAAC,CA4KnB"}

package/dist/lib/file.js

@@ -1,24 +1,28 @@
-import SuperHeaders from '@remix-run/headers';
+import { ContentRange, IfMatch, IfNoneMatch, IfRange, Range, } from '@remix-run/headers';
 import { isCompressibleMimeType, mimeTypeToContentType } from '@remix-run/mime';
 /**
  * Creates a file [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response)
  * with full HTTP semantics including ETags, Last-Modified, conditional requests, and Range support.
  *
- * @param file The file to send
+ * Accepts both native `File` objects and `LazyFile` from `@remix-run/lazy-file`.
+ *
+ * @param file The file to send (native `File` or `LazyFile`)
  * @param request The request object
  * @param options Configuration options
  * @returns A `Response` object containing the file
  *
  * @example
  * import { createFileResponse } from '@remix-run/response/file'
- * let file = openFile('./public/image.jpg')
- * return createFileResponse(file, request, {
+ * import { openLazyFile } from '@remix-run/fs'
+ *
+ * let lazyFile = openLazyFile('./public/image.jpg')
+ * return createFileResponse(lazyFile, request, {
  *   cacheControl: 'public, max-age=3600'
  * })
  */
 export async function createFileResponse(file, request, options = {}) {
     let { cacheControl, etag: etagStrategy = 'weak', digest: digestOption = 'SHA-256', lastModified: lastModifiedEnabled = true, acceptRanges: acceptRangesOption, } = options;
-    let headers = new SuperHeaders(request.headers);
+    let headers = request.headers;
     let contentType = mimeTypeToContentType(file.type);
     let contentLength = file.size;
     let etag;
@@ -42,28 +46,32 @@ export async function createFileResponse(file, request, options = {}) {
     }
     let hasIfMatch = headers.has('If-Match');
     // If-Match support: https://httpwg.org/specs/rfc9110.html#field.if-match
-    if (etag && hasIfMatch && !headers.ifMatch.matches(etag)) {
-        return new Response('Precondition Failed', {
-            status: 412,
-            headers: new SuperHeaders(omitNullableValues({
-                etag,
-                lastModified,
-                acceptRanges,
-            })),
-        });
+    if (etag && hasIfMatch) {
+        let ifMatch = IfMatch.from(headers.get('if-match'));
+        if (!ifMatch.matches(etag)) {
+            return new Response('Precondition Failed', {
+                status: 412,
+                headers: buildResponseHeaders({
+                    etag,
+                    lastModified,
+                    acceptRanges,
+                }),
+            });
+        }
     }
     // If-Unmodified-Since support: https://httpwg.org/specs/rfc9110.html#field.if-unmodified-since
     if (lastModified && !hasIfMatch) {
-        let ifUnmodifiedSince = headers.ifUnmodifiedSince;
-        if (ifUnmodifiedSince != null) {
+        let ifUnmodifiedSinceHeader = headers.get('if-unmodified-since');
+        if (ifUnmodifiedSinceHeader != null) {
+            let ifUnmodifiedSince = new Date(ifUnmodifiedSinceHeader);
             if (removeMilliseconds(lastModified) > removeMilliseconds(ifUnmodifiedSince)) {
                 return new Response('Precondition Failed', {
                     status: 412,
-                    headers: new SuperHeaders(omitNullableValues({
+                    headers: buildResponseHeaders({
                         etag,
                         lastModified,
                         acceptRanges,
-                    })),
+                    }),
                 });
             }
         }
@@ -72,12 +80,14 @@ export async function createFileResponse(file, request, options = {}) {
     // If-Modified-Since support: https://httpwg.org/specs/rfc9110.html#field.if-modified-since
     if (etag || lastModified) {
         let shouldReturnNotModified = false;
-        if (etag && headers.ifNoneMatch.matches(etag)) {
+        let ifNoneMatch = IfNoneMatch.from(headers.get('if-none-match'));
+        if (etag && ifNoneMatch.matches(etag)) {
             shouldReturnNotModified = true;
         }
-        else if (lastModified && headers.ifNoneMatch.tags.length === 0) {
-            let ifModifiedSince = headers.ifModifiedSince;
-            if (ifModifiedSince != null) {
+        else if (lastModified && ifNoneMatch.tags.length === 0) {
+            let ifModifiedSinceHeader = headers.get('if-modified-since');
+            if (ifModifiedSinceHeader != null) {
+                let ifModifiedSince = new Date(ifModifiedSinceHeader);
                 if (removeMilliseconds(lastModified) <= removeMilliseconds(ifModifiedSince)) {
                     shouldReturnNotModified = true;
                 }
@@ -86,18 +96,18 @@ export async function createFileResponse(file, request, options = {}) {
         if (shouldReturnNotModified) {
             return new Response(null, {
                 status: 304,
-                headers: new SuperHeaders(omitNullableValues({
+                headers: buildResponseHeaders({
                     etag,
                     lastModified,
                     acceptRanges,
-                })),
+                }),
             });
         }
     }
     // Range support: https://httpwg.org/specs/rfc9110.html#field.range
     // If-Range support: https://httpwg.org/specs/rfc9110.html#field.if-range
     if (acceptRanges && request.method === 'GET' && headers.has('Range')) {
-        let range = headers.range;
+        let range = Range.from(headers.get('range'));
         // Check if the Range header was sent but parsing resulted in no valid ranges (malformed)
         if (range.ranges.length === 0) {
             return new Response('Bad Request', {
@@ -105,15 +115,16 @@ export async function createFileResponse(file, request, options = {}) {
             });
         }
         // If-Range support: https://httpwg.org/specs/rfc9110.html#field.if-range
-        if (headers.ifRange.matches({
+        let ifRange = IfRange.from(headers.get('if-range'));
+        if (ifRange.matches({
             etag,
             lastModified,
         })) {
             if (!range.canSatisfy(file.size)) {
                 return new Response('Range Not Satisfiable', {
                     status: 416,
-                    headers: new SuperHeaders({
-                        contentRange: { unit: 'bytes', size: file.size },
+                    headers: buildResponseHeaders({
+                        contentRange: ContentRange.from({ unit: 'bytes', size: file.size }),
                     }),
                 });
             }
@@ -122,16 +133,16 @@ export async function createFileResponse(file, request, options = {}) {
             if (normalizedRanges.length > 1) {
                 return new Response('Range Not Satisfiable', {
                     status: 416,
-                    headers: new SuperHeaders({
-                        contentRange: { unit: 'bytes', size: file.size },
+                    headers: buildResponseHeaders({
+                        contentRange: ContentRange.from({ unit: 'bytes', size: file.size }),
                     }),
                 });
             }
             let { start, end } = normalizedRanges[0];
             let { size } = file;
-            return new Response(file.slice(start, end + 1), {
+            return new Response(file.slice(start, end + 1).stream(), {
                 status: 206,
-                headers: new SuperHeaders(omitNullableValues({
+                headers: buildResponseHeaders({
                     contentType,
                     contentLength: end - start + 1,
                     contentRange: { unit: 'bytes', start, end, size },
@@ -139,33 +150,51 @@ export async function createFileResponse(file, request, options = {}) {
                     lastModified,
                     cacheControl,
                     acceptRanges,
-                })),
+                }),
             });
         }
     }
-    return new Response(request.method === 'HEAD' ? null : file, {
+    return new Response(request.method === 'HEAD' ? null : file.stream(), {
         status: 200,
-        headers: new SuperHeaders(omitNullableValues({
+        headers: buildResponseHeaders({
             contentType,
             contentLength,
             etag,
             lastModified,
             cacheControl,
             acceptRanges,
-        })),
+        }),
     });
 }
 function generateWeakETag(file) {
     return `W/"${file.size}-${file.lastModified}"`;
 }
-function omitNullableValues(headers) {
-    let result = {};
-    for (let key in headers) {
-        if (headers[key] != null) {
-            result[key] = headers[key];
-        }
+function buildResponseHeaders(values) {
+    let headers = new Headers();
+    if (values.contentType) {
+        headers.set('Content-Type', values.contentType);
+    }
+    if (values.contentLength != null) {
+        headers.set('Content-Length', String(values.contentLength));
+    }
+    if (values.contentRange) {
+        let str = ContentRange.from(values.contentRange).toString();
+        if (str)
+            headers.set('Content-Range', str);
+    }
+    if (values.etag) {
+        headers.set('ETag', values.etag);
     }
-    return result;
+    if (values.lastModified != null) {
+        headers.set('Last-Modified', new Date(values.lastModified).toUTCString());
+    }
+    if (values.cacheControl) {
+        headers.set('Cache-Control', values.cacheControl);
+    }
+    if (values.acceptRanges) {
+        headers.set('Accept-Ranges', values.acceptRanges);
+    }
+    return headers;
 }
 /**
  * Computes a digest (hash) for a file.
@@ -199,6 +228,9 @@ async function hashFile(file, algorithm = 'SHA-256') {
 /**
  * Removes milliseconds from a timestamp, returning seconds.
  * HTTP dates only have second precision, so this is useful for date comparisons.
+ *
+ * @param time The timestamp or Date to truncate
+ * @returns The timestamp in seconds (milliseconds removed)
  */
 function removeMilliseconds(time) {
     let timestamp = time instanceof Date ? time.getTime() : time;

package/dist/lib/redirect.d.ts

@@ -1,6 +1,7 @@
 /**
  * Creates a redirect [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response).
  *
+ * @alias redirect
  * @param location The location to redirect to
  * @param init The `ResponseInit` object for the response, or a status code
  * @returns A `Response` object with a redirect header

package/dist/lib/redirect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redirect.d.ts","sourceRoot":"","sources":["../../src/lib/redirect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,GAAG,GAAG,EACtB,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,GAC3B,QAAQ,CAaV"}
+{"version":3,"file":"redirect.d.ts","sourceRoot":"","sources":["../../src/lib/redirect.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,GAAG,GAAG,EACtB,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,GAC3B,QAAQ,CAaV"}

package/dist/lib/redirect.js

@@ -1,6 +1,7 @@
 /**
  * Creates a redirect [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response).
  *
+ * @alias redirect
  * @param location The location to redirect to
  * @param init The `ResponseInit` object for the response, or a status code
  * @returns A `Response` object with a redirect header

package/dist/redirect.d.ts

@@ -1,2 +1,2 @@
-export { createRedirectResponse } from './lib/redirect.ts';
+export { createRedirectResponse, createRedirectResponse as redirect, } from './lib/redirect.ts';
 //# sourceMappingURL=redirect.d.ts.map

package/dist/redirect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redirect.d.ts","sourceRoot":"","sources":["../src/redirect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"redirect.d.ts","sourceRoot":"","sources":["../src/redirect.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,sBAAsB,IAAI,QAAQ,GACnC,MAAM,mBAAmB,CAAA"}

package/dist/redirect.js

@@ -1 +1,2 @@
-export { createRedirectResponse } from "./lib/redirect.js";
+export { createRedirectResponse, createRedirectResponse as redirect, // shorthand
+ } from "./lib/redirect.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remix-run/response",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Response helpers for the web Fetch API",
   "author": "Michael Jackson <mjijackson@gmail.com>",
   "license": "MIT",
@@ -40,12 +40,13 @@
   "devDependencies": {
     "@types/node": "^24.6.0",
     "@typescript/native-preview": "7.0.0-dev.20251125.1",
-    "@remix-run/mime": "0.2.0"
+    "@remix-run/lazy-file": "5.0.1",
+    "@remix-run/mime": "0.3.0"
   },
-  "peerDependencies": {
-    "@remix-run/headers": "^0.18.0",
-    "@remix-run/mime": "^0.2.0",
-    "@remix-run/html-template": "^0.3.0"
+  "dependencies": {
+    "@remix-run/headers": "^0.19.0",
+    "@remix-run/html-template": "^0.3.0",
+    "@remix-run/mime": "^0.3.0"
   },
   "keywords": [
     "fetch",

package/src/lib/compress.ts

@@ -9,7 +9,7 @@ import {
 } from 'node:zlib'
 import type { BrotliOptions, ZlibOptions } from 'node:zlib'
 
-import { AcceptEncoding, SuperHeaders } from '@remix-run/headers'
+import { AcceptEncoding, CacheControl, Vary } from '@remix-run/headers'
 
 export type Encoding = 'br' | 'gzip' | 'deflate'
 const defaultEncodings: Encoding[] = ['br', 'gzip', 'deflate']
@@ -84,7 +84,13 @@ export async function compressResponse(
   let supportedEncodings = compressOptions.encodings ?? defaultEncodings
   let threshold = compressOptions.threshold ?? 1024
   let acceptEncodingHeader = request.headers.get('Accept-Encoding')
-  let responseHeaders = new SuperHeaders(response.headers)
+  let responseHeaders = new Headers(response.headers)
+
+  let contentEncodingHeader = responseHeaders.get('content-encoding')
+  let contentLengthHeader = responseHeaders.get('content-length')
+  let contentLength = contentLengthHeader != null ? parseInt(contentLengthHeader, 10) : null
+  let acceptRangesHeader = responseHeaders.get('accept-ranges')
+  let cacheControl = CacheControl.from(responseHeaders.get('cache-control'))
 
   if (
     !acceptEncodingHeader ||
@@ -92,20 +98,20 @@ export async function compressResponse(
     // Empty response
     (request.method !== 'HEAD' && !response.body) ||
     // Already compressed
-    responseHeaders.contentEncoding != null ||
+    contentEncodingHeader != null ||
     // Content-Length below threshold
-    (responseHeaders.contentLength != null && responseHeaders.contentLength < threshold) ||
+    (contentLength != null && contentLength < threshold) ||
     // Cache-Control: no-transform
-    responseHeaders.cacheControl.noTransform ||
+    cacheControl.noTransform ||
     // Response advertising range support
-    responseHeaders.acceptRanges === 'bytes' ||
+    acceptRangesHeader === 'bytes' ||
     // Partial content responses
     response.status === 206
   ) {
     return response
   }
 
-  let acceptEncoding = new AcceptEncoding(acceptEncodingHeader)
+  let acceptEncoding = AcceptEncoding.from(acceptEncodingHeader)
   let selectedEncoding = negotiateEncoding(acceptEncoding, supportedEncodings)
   if (selectedEncoding === null) {
     // Client has explicitly rejected all supported encodings, including 'identity'
@@ -155,15 +161,20 @@ function negotiateEncoding(
   return preferred
 }
 
-function setCompressionHeaders(headers: SuperHeaders, encoding: string): void {
-  headers.contentEncoding = encoding
-  headers.acceptRanges = 'none'
-  headers.contentLength = null
-  headers.vary.add('Accept-Encoding')
+function setCompressionHeaders(headers: Headers, encoding: string): void {
+  headers.set('content-encoding', encoding)
+  headers.set('accept-ranges', 'none')
+  headers.delete('content-length')
+
+  // Update Vary header to include Accept-Encoding
+  let vary = Vary.from(headers.get('vary'))
+  vary.add('Accept-Encoding')
+  headers.set('vary', vary.toString())
 
   // Convert strong ETags to weak since compressed representation is byte-different
-  if (headers.etag && !headers.etag.startsWith('W/')) {
-    headers.etag = `W/${headers.etag}`
+  let etagHeader = headers.get('etag')
+  if (etagHeader && !etagHeader.startsWith('W/')) {
+    headers.set('etag', `W/${etagHeader}`)
   }
 }
 
@@ -177,7 +188,7 @@ const brotliFlushOptions = {
 
 function applyCompression(
   response: Response,
-  responseHeaders: SuperHeaders,
+  responseHeaders: Headers,
   encoding: Encoding,
   options: CompressResponseOptions,
 ): Response {
@@ -186,8 +197,8 @@ function applyCompression(
   }
 
   // Detect SSE for automatic flush configuration
-  let contentType = response.headers.get('Content-Type')
-  let mediaType = contentType?.split(';')[0].trim()
+  let contentTypeHeader = response.headers.get('Content-Type')
+  let mediaType = contentTypeHeader?.split(';')[0].trim()
   let isSSE = mediaType === 'text/event-stream'
 
   let compressor = createCompressor(encoding, {
@@ -216,6 +227,10 @@ function applyCompression(
  * Compresses a response stream that bridges node:zlib to Web Streams.
  * Reads from the input stream, compresses chunks through the compressor,
  * and returns a new ReadableStream with the compressed data.
+ *
+ * @param input The input stream to compress
+ * @param compressor The zlib compressor instance to use
+ * @returns A new ReadableStream with the compressed data
  */
 export function compressStream(
   input: ReadableStream<Uint8Array>,

package/src/lib/file.ts

@@ -1,6 +1,37 @@
-import SuperHeaders from '@remix-run/headers'
+import {
+  type ContentRangeInit,
+  ContentRange,
+  IfMatch,
+  IfNoneMatch,
+  IfRange,
+  Range,
+} from '@remix-run/headers'
 import { isCompressibleMimeType, mimeTypeToContentType } from '@remix-run/mime'
 
+/**
+ * Minimal interface for file-like objects used by `createFileResponse`.
+ */
+export interface FileLike {
+  /** File compatibility - included for interface completeness */
+  readonly name: string
+  /** Used for Content-Length header and range calculations */
+  readonly size: number
+  /** Used for Content-Type header */
+  readonly type: string
+  /** Used for Last-Modified header and weak ETag generation */
+  readonly lastModified: number
+  /** Used for streaming the response body */
+  stream(): ReadableStream<Uint8Array>
+  /** Used for strong ETag digest calculation */
+  arrayBuffer(): Promise<ArrayBuffer>
+  /** Used for range requests (206 Partial Content) */
+  slice(
+    start?: number,
+    end?: number,
+    contentType?: string,
+  ): { stream(): ReadableStream<Uint8Array> }
+}
+
 /**
  * Custom function for computing file digests.
  *
@@ -13,12 +44,12 @@ import { isCompressibleMimeType, mimeTypeToContentType } from '@remix-run/mime'
  *   return customHash(buffer)
  * }
  */
-export type FileDigestFunction = (file: File) => Promise<string>
+export type FileDigestFunction<file extends FileLike = File> = (file: file) => Promise<string>
 
 /**
  * Options for creating a file response.
  */
-export interface FileResponseOptions {
+export interface FileResponseOptions<file extends FileLike = File> {
   /**
    * Cache-Control header value. If not provided, no Cache-Control header will be set.
    *
@@ -43,14 +74,14 @@ export interface FileResponseOptions {
    * - String: Web Crypto API algorithm name ('SHA-256', 'SHA-384', 'SHA-512', 'SHA-1').
    *   Note: Using strong ETags will buffer the entire file into memory before hashing.
    *   Consider using weak ETags (default) or a custom digest function for large files.
-   * - Function: Custom digest computation that receives a File and returns the digest string
+   * - Function: Custom digest computation that receives a file and returns the digest string
    *
    * Only used when `etag: 'strong'`. Ignored for weak ETags.
    *
    * @default 'SHA-256'
    * @example async (file) => await customHash(file)
    */
-  digest?: AlgorithmIdentifier | FileDigestFunction
+  digest?: AlgorithmIdentifier | FileDigestFunction<file>
   /**
    * Whether to include `Last-Modified` headers.
    *
@@ -78,22 +109,26 @@ export interface FileResponseOptions {
  * Creates a file [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response)
  * with full HTTP semantics including ETags, Last-Modified, conditional requests, and Range support.
  *
- * @param file The file to send
+ * Accepts both native `File` objects and `LazyFile` from `@remix-run/lazy-file`.
+ *
+ * @param file The file to send (native `File` or `LazyFile`)
  * @param request The request object
  * @param options Configuration options
  * @returns A `Response` object containing the file
  *
  * @example
  * import { createFileResponse } from '@remix-run/response/file'
- * let file = openFile('./public/image.jpg')
- * return createFileResponse(file, request, {
+ * import { openLazyFile } from '@remix-run/fs'
+ *
+ * let lazyFile = openLazyFile('./public/image.jpg')
+ * return createFileResponse(lazyFile, request, {
  *   cacheControl: 'public, max-age=3600'
  * })
  */
-export async function createFileResponse(
-  file: File,
+export async function createFileResponse<file extends FileLike>(
+  file: file,
   request: Request,
-  options: FileResponseOptions = {},
+  options: FileResponseOptions<file> = {},
 ): Promise<Response> {
   let {
     cacheControl,
@@ -103,7 +138,7 @@ export async function createFileResponse(
     acceptRanges: acceptRangesOption,
   } = options
 
-  let headers = new SuperHeaders(request.headers)
+  let headers = request.headers
 
   let contentType = mimeTypeToContentType(file.type)
   let contentLength = file.size
@@ -134,33 +169,33 @@ export async function createFileResponse(
   let hasIfMatch = headers.has('If-Match')
 
   // If-Match support: https://httpwg.org/specs/rfc9110.html#field.if-match
-  if (etag && hasIfMatch && !headers.ifMatch.matches(etag)) {
-    return new Response('Precondition Failed', {
-      status: 412,
-      headers: new SuperHeaders(
-        omitNullableValues({
+  if (etag && hasIfMatch) {
+    let ifMatch = IfMatch.from(headers.get('if-match'))
+    if (!ifMatch.matches(etag)) {
+      return new Response('Precondition Failed', {
+        status: 412,
+        headers: buildResponseHeaders({
           etag,
           lastModified,
           acceptRanges,
         }),
-      ),
-    })
+      })
+    }
   }
 
   // If-Unmodified-Since support: https://httpwg.org/specs/rfc9110.html#field.if-unmodified-since
   if (lastModified && !hasIfMatch) {
-    let ifUnmodifiedSince = headers.ifUnmodifiedSince
-    if (ifUnmodifiedSince != null) {
+    let ifUnmodifiedSinceHeader = headers.get('if-unmodified-since')
+    if (ifUnmodifiedSinceHeader != null) {
+      let ifUnmodifiedSince = new Date(ifUnmodifiedSinceHeader)
       if (removeMilliseconds(lastModified) > removeMilliseconds(ifUnmodifiedSince)) {
         return new Response('Precondition Failed', {
           status: 412,
-          headers: new SuperHeaders(
-            omitNullableValues({
-              etag,
-              lastModified,
-              acceptRanges,
-            }),
-          ),
+          headers: buildResponseHeaders({
+            etag,
+            lastModified,
+            acceptRanges,
+          }),
         })
       }
     }
@@ -170,12 +205,14 @@ export async function createFileResponse(
   // If-Modified-Since support: https://httpwg.org/specs/rfc9110.html#field.if-modified-since
   if (etag || lastModified) {
     let shouldReturnNotModified = false
+    let ifNoneMatch = IfNoneMatch.from(headers.get('if-none-match'))
 
-    if (etag && headers.ifNoneMatch.matches(etag)) {
+    if (etag && ifNoneMatch.matches(etag)) {
       shouldReturnNotModified = true
-    } else if (lastModified && headers.ifNoneMatch.tags.length === 0) {
-      let ifModifiedSince = headers.ifModifiedSince
-      if (ifModifiedSince != null) {
+    } else if (lastModified && ifNoneMatch.tags.length === 0) {
+      let ifModifiedSinceHeader = headers.get('if-modified-since')
+      if (ifModifiedSinceHeader != null) {
+        let ifModifiedSince = new Date(ifModifiedSinceHeader)
         if (removeMilliseconds(lastModified) <= removeMilliseconds(ifModifiedSince)) {
           shouldReturnNotModified = true
         }
@@ -185,13 +222,11 @@ export async function createFileResponse(
     if (shouldReturnNotModified) {
       return new Response(null, {
         status: 304,
-        headers: new SuperHeaders(
-          omitNullableValues({
-            etag,
-            lastModified,
-            acceptRanges,
-          }),
-        ),
+        headers: buildResponseHeaders({
+          etag,
+          lastModified,
+          acceptRanges,
+        }),
       })
     }
   }
@@ -199,7 +234,7 @@ export async function createFileResponse(
   // Range support: https://httpwg.org/specs/rfc9110.html#field.range
   // If-Range support: https://httpwg.org/specs/rfc9110.html#field.if-range
   if (acceptRanges && request.method === 'GET' && headers.has('Range')) {
-    let range = headers.range
+    let range = Range.from(headers.get('range'))
 
     // Check if the Range header was sent but parsing resulted in no valid ranges (malformed)
     if (range.ranges.length === 0) {
@@ -209,8 +244,9 @@ export async function createFileResponse(
     }
 
     // If-Range support: https://httpwg.org/specs/rfc9110.html#field.if-range
+    let ifRange = IfRange.from(headers.get('if-range'))
     if (
-      headers.ifRange.matches({
+      ifRange.matches({
         etag,
         lastModified,
       })
@@ -218,8 +254,8 @@ export async function createFileResponse(
       if (!range.canSatisfy(file.size)) {
         return new Response('Range Not Satisfiable', {
           status: 416,
-          headers: new SuperHeaders({
-            contentRange: { unit: 'bytes', size: file.size },
+          headers: buildResponseHeaders({
+            contentRange: ContentRange.from({ unit: 'bytes', size: file.size }),
           }),
         })
       }
@@ -230,8 +266,8 @@ export async function createFileResponse(
       if (normalizedRanges.length > 1) {
         return new Response('Range Not Satisfiable', {
           status: 416,
-          headers: new SuperHeaders({
-            contentRange: { unit: 'bytes', size: file.size },
+          headers: buildResponseHeaders({
+            contentRange: ContentRange.from({ unit: 'bytes', size: file.size }),
           }),
         })
       }
@@ -239,54 +275,75 @@ export async function createFileResponse(
       let { start, end } = normalizedRanges[0]
       let { size } = file
 
-      return new Response(file.slice(start, end + 1), {
+      return new Response(file.slice(start, end + 1).stream(), {
         status: 206,
-        headers: new SuperHeaders(
-          omitNullableValues({
-            contentType,
-            contentLength: end - start + 1,
-            contentRange: { unit: 'bytes', start, end, size },
-            etag,
-            lastModified,
-            cacheControl,
-            acceptRanges,
-          }),
-        ),
+        headers: buildResponseHeaders({
+          contentType,
+          contentLength: end - start + 1,
+          contentRange: { unit: 'bytes', start, end, size },
+          etag,
+          lastModified,
+          cacheControl,
+          acceptRanges,
+        }),
       })
     }
   }
 
-  return new Response(request.method === 'HEAD' ? null : file, {
+  return new Response(request.method === 'HEAD' ? null : file.stream(), {
     status: 200,
-    headers: new SuperHeaders(
-      omitNullableValues({
-        contentType,
-        contentLength,
-        etag,
-        lastModified,
-        cacheControl,
-        acceptRanges,
-      }),
-    ),
+    headers: buildResponseHeaders({
+      contentType,
+      contentLength,
+      etag,
+      lastModified,
+      cacheControl,
+      acceptRanges,
+    }),
   })
 }
 
-function generateWeakETag(file: File): string {
+function generateWeakETag(file: FileLike): string {
   return `W/"${file.size}-${file.lastModified}"`
 }
 
-type OmitNullableValues<T> = {
-  [K in keyof T as T[K] extends null | undefined ? never : K]: NonNullable<T[K]>
+interface ResponseHeaderValues {
+  contentType?: string
+  contentLength?: number
+  contentRange?: ContentRangeInit
+  etag?: string
+  lastModified?: number
+  cacheControl?: string
+  acceptRanges?: 'bytes'
 }
 
-function omitNullableValues<T extends Record<string, any>>(headers: T): OmitNullableValues<T> {
-  let result: any = {}
-  for (let key in headers) {
-    if (headers[key] != null) {
-      result[key] = headers[key]
-    }
+function buildResponseHeaders(values: ResponseHeaderValues): Headers {
+  let headers = new Headers()
+
+  if (values.contentType) {
+    headers.set('Content-Type', values.contentType)
+  }
+  if (values.contentLength != null) {
+    headers.set('Content-Length', String(values.contentLength))
+  }
+  if (values.contentRange) {
+    let str = ContentRange.from(values.contentRange).toString()
+    if (str) headers.set('Content-Range', str)
+  }
+  if (values.etag) {
+    headers.set('ETag', values.etag)
+  }
+  if (values.lastModified != null) {
+    headers.set('Last-Modified', new Date(values.lastModified).toUTCString())
   }
-  return result
+  if (values.cacheControl) {
+    headers.set('Cache-Control', values.cacheControl)
+  }
+  if (values.acceptRanges) {
+    headers.set('Accept-Ranges', values.acceptRanges)
+  }
+
+  return headers
 }
 
 /**
@@ -296,9 +353,9 @@ function omitNullableValues<T extends Record<string, any>>(headers: T): OmitNull
  * @param digestOption Web Crypto algorithm name or custom digest function
  * @returns The computed digest as a hex string
  */
-async function computeDigest(
-  file: File,
-  digestOption: AlgorithmIdentifier | FileDigestFunction,
+async function computeDigest<file extends FileLike>(
+  file: file,
+  digestOption: AlgorithmIdentifier | FileDigestFunction<file>,
 ): Promise<string> {
   return typeof digestOption === 'function'
     ? await digestOption(file)
@@ -315,7 +372,10 @@ async function computeDigest(
  * @param algorithm Web Crypto API algorithm name (default: 'SHA-256')
  * @returns The hash as a hex string
  */
-async function hashFile(file: File, algorithm: AlgorithmIdentifier = 'SHA-256'): Promise<string> {
+async function hashFile<F extends FileLike>(
+  file: F,
+  algorithm: AlgorithmIdentifier = 'SHA-256',
+): Promise<string> {
   let buffer = await file.arrayBuffer()
   let hashBuffer = await crypto.subtle.digest(algorithm, buffer)
   return Array.from(new Uint8Array(hashBuffer))
@@ -326,6 +386,9 @@ async function hashFile(file: File, algorithm: AlgorithmIdentifier = 'SHA-256'):
 /**
  * Removes milliseconds from a timestamp, returning seconds.
  * HTTP dates only have second precision, so this is useful for date comparisons.
+ *
+ * @param time The timestamp or Date to truncate
+ * @returns The timestamp in seconds (milliseconds removed)
  */
 function removeMilliseconds(time: number | Date): number {
   let timestamp = time instanceof Date ? time.getTime() : time

package/src/lib/redirect.ts

@@ -1,6 +1,7 @@
 /**
  * Creates a redirect [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response).
  *
+ * @alias redirect
  * @param location The location to redirect to
  * @param init The `ResponseInit` object for the response, or a status code
  * @returns A `Response` object with a redirect header

package/src/redirect.ts

@@ -1 +1,4 @@
-export { createRedirectResponse } from './lib/redirect.ts'
+export {
+  createRedirectResponse,
+  createRedirectResponse as redirect, // shorthand
+} from './lib/redirect.ts'