@helia/verified-fetch 1.1.3 → 1.2.1

package/dist/src/types.d.ts

@@ -1,2 +1,3 @@
 export type RequestFormatShorthand = 'raw' | 'car' | 'tar' | 'ipns-record' | 'dag-json' | 'dag-cbor' | 'json' | 'cbor';
+export type SupportedBodyTypes = string | ArrayBuffer | Blob | ReadableStream<Uint8Array> | null;
 //# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAA;AAEtH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAA"}

package/dist/src/utils/byte-range-context.d.ts

@@ -0,0 +1,80 @@
+import type { SupportedBodyTypes } from '../types.js';
+import type { ComponentLogger } from '@libp2p/interface';
+export declare class ByteRangeContext {
+    private readonly headers?;
+    readonly isRangeRequest: boolean;
+    /**
+     * This property is purposefully only set in `set fileSize` and should not be set directly.
+     */
+    private _fileSize;
+    private _body;
+    private readonly rangeRequestHeader;
+    private readonly log;
+    private readonly requestRangeStart;
+    private readonly requestRangeEnd;
+    private byteStart;
+    private byteEnd;
+    private byteSize;
+    constructor(logger: ComponentLogger, headers?: HeadersInit | undefined);
+    setBody(body: SupportedBodyTypes): void;
+    getBody(): SupportedBodyTypes;
+    private getSlicedBody;
+    /**
+     * Sometimes, we need to set the fileSize explicitly because we can't calculate
+     * the size of the body (e.g. for unixfs content where we call .stat).
+     *
+     * This fileSize should otherwise only be called from `setBody`.
+     */
+    setFileSize(size: number | bigint | null): void;
+    getFileSize(): number | null | undefined;
+    private isValidByteStart;
+    private isValidByteEnd;
+    /**
+     * We may get the values required to determine if this is a valid range request at different times
+     * so we need to calculate it when asked.
+     */
+    get isValidRangeRequest(): boolean;
+    /**
+     * Given all the information we have, this function returns the offset that will be used when:
+     * 1. calling unixfs.cat
+     * 2. slicing the body
+     */
+    get offset(): number;
+    /**
+     * Given all the information we have, this function returns the length that will be used when:
+     * 1. calling unixfs.cat
+     * 2. slicing the body
+     */
+    get length(): number | undefined;
+    /**
+     * Converts a range request header into helia/unixfs supported range options
+     * Note that the gateway specification says we "MAY" support multiple ranges (https://specs.ipfs.tech/http-gateways/path-gateway/#range-request-header) but we don't
+     *
+     * Also note that @helia/unixfs and ipfs-unixfs-exporter expect length and offset to be numbers, the range header is a string, and the size of the resource is likely a bigint.
+     *
+     * SUPPORTED:
+     * Range: bytes=<range-start>-<range-end>
+     * Range: bytes=<range-start>-
+     * Range: bytes=-<suffix-length> // must pass size so we can calculate the offset. suffix-length is the number of bytes from the end of the file.
+     *
+     * NOT SUPPORTED:
+     * Range: bytes=<range-start>-<range-end>, <range-start>-<range-end>
+     * Range: bytes=<range-start>-<range-end>, <range-start>-<range-end>, <range-start>-<range-end>
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Range#directives
+     */
+    private setOffsetDetails;
+    /**
+     * This function returns the value of the "content-range" header.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Range
+     *
+     * Returns a string representing the following content ranges:
+     *
+     * @example
+     * - Content-Range: <unit> <byteStart>-<byteEnd>/<byteSize>
+     * - Content-Range: <unit> <byteStart>-<byteEnd>/*
+     */
+    get contentRangeHeaderValue(): string;
+}
+//# sourceMappingURL=byte-range-context.d.ts.map

package/dist/src/utils/byte-range-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-range-context.d.ts","sourceRoot":"","sources":["../../../src/utils/byte-range-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAU,MAAM,mBAAmB,CAAA;AAuChE,qBAAa,gBAAgB;IAgBW,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAf/D,SAAgB,cAAc,EAAE,OAAO,CAAA;IAEvC;;OAEG;IACH,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoB;IACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAe;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAe;IAC/C,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAoB;gBAEvB,MAAM,EAAE,eAAe,EAAmB,OAAO,CAAC,yBAAa;IAyBrE,OAAO,CAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAQxC,OAAO,IAAK,kBAAkB;IA4BrC,OAAO,CAAC,aAAa;IAOrB;;;;;OAKG;IACI,WAAW,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI;IAOhD,WAAW,IAAK,MAAM,GAAG,IAAI,GAAG,SAAS;IAIhD,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,cAAc;IAetB;;;OAGG;IACH,IAAW,mBAAmB,IAAK,OAAO,CAmCzC;IAED;;;;OAIG;IACH,IAAW,MAAM,IAAK,MAAM,CAE3B;IAED;;;;OAIG;IACH,IAAW,MAAM,IAAK,MAAM,GAAG,SAAS,CASvC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;;;;;;;;;OAUG;IAEH,IAAW,uBAAuB,IAAK,MAAM,CAW5C;CACF"}

package/dist/src/utils/byte-range-context.js

@@ -0,0 +1,277 @@
+import { calculateByteRangeIndexes, getHeader } from './request-headers.js';
+import { getContentRangeHeader } from './response-headers.js';
+/**
+ * Gets the body size of a given body if it's possible to calculate it synchronously.
+ */
+function getBodySizeSync(body) {
+    if (typeof body === 'string') {
+        return body.length;
+    }
+    if (body instanceof ArrayBuffer || body instanceof Uint8Array) {
+        return body.byteLength;
+    }
+    if (body instanceof Blob) {
+        return body.size;
+    }
+    if (body instanceof ReadableStream) {
+        return null;
+    }
+    return null;
+}
+function getByteRangeFromHeader(rangeHeader) {
+    /**
+     * Range: bytes=<start>-<end> | bytes=<start2>- | bytes=-<end2>
+     */
+    const match = rangeHeader.match(/^bytes=(?<start>\d+)?-(?<end>\d+)?$/);
+    if (match?.groups == null) {
+        throw new Error('Invalid range request');
+    }
+    const { start, end } = match.groups;
+    return { start, end };
+}
+export class ByteRangeContext {
+    headers;
+    isRangeRequest;
+    /**
+     * This property is purposefully only set in `set fileSize` and should not be set directly.
+     */
+    _fileSize;
+    _body = null;
+    rangeRequestHeader;
+    log;
+    requestRangeStart;
+    requestRangeEnd;
+    byteStart;
+    byteEnd;
+    byteSize;
+    constructor(logger, headers) {
+        this.headers = headers;
+        this.log = logger.forComponent('helia:verified-fetch:byte-range-context');
+        this.rangeRequestHeader = getHeader(this.headers, 'Range');
+        if (this.rangeRequestHeader != null) {
+            this.isRangeRequest = true;
+            this.log.trace('range request detected');
+            try {
+                const { start, end } = getByteRangeFromHeader(this.rangeRequestHeader);
+                this.requestRangeStart = start != null ? parseInt(start) : null;
+                this.requestRangeEnd = end != null ? parseInt(end) : null;
+            }
+            catch (e) {
+                this.log.error('error parsing range request header: %o', e);
+                this.requestRangeStart = null;
+                this.requestRangeEnd = null;
+            }
+            this.setOffsetDetails();
+        }
+        else {
+            this.log.trace('no range request detected');
+            this.isRangeRequest = false;
+            this.requestRangeStart = null;
+            this.requestRangeEnd = null;
+        }
+    }
+    setBody(body) {
+        this._body = body;
+        // if fileSize was already set, don't recalculate it
+        this.setFileSize(this._fileSize ?? getBodySizeSync(body));
+        this.log.trace('set request body with fileSize %o', this._fileSize);
+    }
+    getBody() {
+        const body = this._body;
+        if (body == null) {
+            this.log.trace('body is null');
+            return body;
+        }
+        if (!this.isRangeRequest || !this.isValidRangeRequest) {
+            this.log.trace('returning body unmodified for non-range, or invalid range, request');
+            return body;
+        }
+        const byteStart = this.byteStart;
+        const byteEnd = this.byteEnd;
+        const byteSize = this.byteSize;
+        if (byteStart != null || byteEnd != null) {
+            this.log.trace('returning body with byteStart=%o, byteEnd=%o, byteSize=%o', byteStart, byteEnd, byteSize);
+            if (body instanceof ReadableStream) {
+                // stream should already be spliced by `unixfs.cat`
+                return body;
+            }
+            return this.getSlicedBody(body);
+        }
+        // we should not reach this point, but return body untouched.
+        this.log.error('returning unmodified body for valid range request');
+        return body;
+    }
+    // TODO: we should be able to use this.offset and this.length to slice the body
+    getSlicedBody(body) {
+        const offset = this.byteStart ?? 0;
+        const length = this.byteEnd == null ? undefined : this.byteEnd + 1;
+        this.log.trace('returning body with offset %o and length %o', offset, length);
+        return body.slice(offset, length);
+    }
+    /**
+     * Sometimes, we need to set the fileSize explicitly because we can't calculate
+     * the size of the body (e.g. for unixfs content where we call .stat).
+     *
+     * This fileSize should otherwise only be called from `setBody`.
+     */
+    setFileSize(size) {
+        this._fileSize = size != null ? Number(size) : null;
+        this.log.trace('set _fileSize to %o', this._fileSize);
+        // when fileSize changes, we need to recalculate the offset details
+        this.setOffsetDetails();
+    }
+    getFileSize() {
+        return this._fileSize;
+    }
+    isValidByteStart() {
+        if (this.byteStart != null) {
+            if (this.byteStart < 0) {
+                return false;
+            }
+            if (this._fileSize != null && this.byteStart >= this._fileSize) {
+                return false;
+            }
+            if (this.byteEnd != null && this.byteStart > this.byteEnd) {
+                return false;
+            }
+        }
+        return true;
+    }
+    isValidByteEnd() {
+        if (this.byteEnd != null) {
+            if (this.byteEnd < 0) {
+                return false;
+            }
+            if (this._fileSize != null && this.byteEnd >= this._fileSize) {
+                return false;
+            }
+            if (this.byteStart != null && this.byteEnd < this.byteStart) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * We may get the values required to determine if this is a valid range request at different times
+     * so we need to calculate it when asked.
+     */
+    get isValidRangeRequest() {
+        if (!this.isRangeRequest) {
+            return false;
+        }
+        if (this.requestRangeStart == null && this.requestRangeEnd == null) {
+            this.log.trace('invalid range request, range request values not provided');
+            return false;
+        }
+        if (!this.isValidByteStart()) {
+            this.log.trace('invalid range request, byteStart is less than 0 or greater than fileSize');
+            return false;
+        }
+        if (!this.isValidByteEnd()) {
+            this.log.trace('invalid range request, byteEnd is less than 0 or greater than fileSize');
+            return false;
+        }
+        if (this.requestRangeEnd != null && this.requestRangeStart != null) {
+            // we may not have enough info.. base check on requested bytes
+            if (this.requestRangeStart > this.requestRangeEnd) {
+                this.log.trace('invalid range request, start is greater than end');
+                return false;
+            }
+            else if (this.requestRangeStart < 0) {
+                this.log.trace('invalid range request, start is less than 0');
+                return false;
+            }
+            else if (this.requestRangeEnd < 0) {
+                this.log.trace('invalid range request, end is less than 0');
+                return false;
+            }
+        }
+        if (this.byteEnd == null && this.byteStart == null && this.byteSize == null) {
+            this.log.trace('invalid range request, could not calculate byteStart, byteEnd, or byteSize');
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Given all the information we have, this function returns the offset that will be used when:
+     * 1. calling unixfs.cat
+     * 2. slicing the body
+     */
+    get offset() {
+        return this.byteStart ?? 0;
+    }
+    /**
+     * Given all the information we have, this function returns the length that will be used when:
+     * 1. calling unixfs.cat
+     * 2. slicing the body
+     */
+    get length() {
+        if (this.byteEnd != null && this.byteStart != null && this.byteStart === this.byteEnd) {
+            return 1;
+        }
+        if (this.byteEnd != null) {
+            return this.byteEnd + 1;
+        }
+        return this.byteSize != null ? this.byteSize - 1 : undefined;
+    }
+    /**
+     * Converts a range request header into helia/unixfs supported range options
+     * Note that the gateway specification says we "MAY" support multiple ranges (https://specs.ipfs.tech/http-gateways/path-gateway/#range-request-header) but we don't
+     *
+     * Also note that @helia/unixfs and ipfs-unixfs-exporter expect length and offset to be numbers, the range header is a string, and the size of the resource is likely a bigint.
+     *
+     * SUPPORTED:
+     * Range: bytes=<range-start>-<range-end>
+     * Range: bytes=<range-start>-
+     * Range: bytes=-<suffix-length> // must pass size so we can calculate the offset. suffix-length is the number of bytes from the end of the file.
+     *
+     * NOT SUPPORTED:
+     * Range: bytes=<range-start>-<range-end>, <range-start>-<range-end>
+     * Range: bytes=<range-start>-<range-end>, <range-start>-<range-end>, <range-start>-<range-end>
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Range#directives
+     */
+    setOffsetDetails() {
+        if (this.requestRangeStart == null && this.requestRangeEnd == null) {
+            this.log.trace('requestRangeStart and requestRangeEnd are null');
+            return;
+        }
+        try {
+            const { start, end, byteSize } = calculateByteRangeIndexes(this.requestRangeStart ?? undefined, this.requestRangeEnd ?? undefined, this._fileSize ?? undefined);
+            this.log.trace('set byteStart to %o, byteEnd to %o, byteSize to %o', start, end, byteSize);
+            this.byteStart = start;
+            this.byteEnd = end;
+            this.byteSize = byteSize;
+        }
+        catch (e) {
+            this.log.error('error setting offset details: %o', e);
+            this.byteStart = undefined;
+            this.byteEnd = undefined;
+            this.byteSize = undefined;
+        }
+    }
+    /**
+     * This function returns the value of the "content-range" header.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Range
+     *
+     * Returns a string representing the following content ranges:
+     *
+     * @example
+     * - Content-Range: <unit> <byteStart>-<byteEnd>/<byteSize>
+     * - Content-Range: <unit> <byteStart>-<byteEnd>/*
+     */
+    // - Content-Range: <unit> */<byteSize> // this is purposefully not in jsdoc block
+    get contentRangeHeaderValue() {
+        if (!this.isValidRangeRequest) {
+            this.log.error('cannot get contentRangeHeaderValue for invalid range request');
+            throw new Error('Invalid range request');
+        }
+        return getContentRangeHeader({
+            byteStart: this.byteStart,
+            byteEnd: this.byteEnd,
+            byteSize: this._fileSize ?? undefined
+        });
+    }
+}
+//# sourceMappingURL=byte-range-context.js.map

package/dist/src/utils/byte-range-context.js.map

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

package/dist/src/utils/get-stream-from-async-iterable.js

@@ -7,7 +7,7 @@ export async function getStreamFromAsyncIterable(iterator, path, logger, options
     const reader = iterator[Symbol.asyncIterator]();
     const { value: firstChunk, done } = await reader.next();
     if (done === true) {
-        log.error('No content found for path', path);
+        log.error('no content found for path', path);
         throw new Error('No content found');
     }
     const stream = new ReadableStream({

package/dist/src/utils/parse-url-string.js

@@ -70,7 +70,7 @@ export async function parseUrlString({ urlString, ipns, logger }, options) {
         }
         else {
             // protocol is ipns
-            log.trace('Attempting to resolve PeerId for %s', cidOrPeerIdOrDnsLink);
+            log.trace('attempting to resolve PeerId for %s', cidOrPeerIdOrDnsLink);
             let peerId = null;
             try {
                 peerId = peerIdFromString(cidOrPeerIdOrDnsLink);
@@ -82,11 +82,11 @@ export async function parseUrlString({ urlString, ipns, logger }, options) {
             }
             catch (err) {
                 if (peerId == null) {
-                    log.error('Could not parse PeerId string "%s"', cidOrPeerIdOrDnsLink, err);
+                    log.error('could not parse PeerId string "%s"', cidOrPeerIdOrDnsLink, err);
                     errors.push(new TypeError(`Could not parse PeerId in ipns url "${cidOrPeerIdOrDnsLink}", ${err.message}`));
                 }
                 else {
-                    log.error('Could not resolve PeerId %c', peerId, err);
+                    log.error('could not resolve PeerId %c', peerId, err);
                     errors.push(new TypeError(`Could not resolve PeerId "${cidOrPeerIdOrDnsLink}", ${err.message}`));
                 }
             }
@@ -105,7 +105,7 @@ export async function parseUrlString({ urlString, ipns, logger }, options) {
                     ipnsCache.set(cidOrPeerIdOrDnsLink, resolveResult, 60 * 1000 * 2);
                 }
                 catch (err) {
-                    log.error('Could not resolve DnsLink for "%s"', cidOrPeerIdOrDnsLink, err);
+                    log.error('could not resolve DnsLink for "%s"', cidOrPeerIdOrDnsLink, err);
                     errors.push(err);
                 }
             }

package/dist/src/utils/request-headers.d.ts

@@ -0,0 +1,13 @@
+export declare function getHeader(headers: HeadersInit | undefined, header: string): string | undefined;
+/**
+ * Given two ints from a Range header, and potential fileSize, returns:
+ * 1. number of bytes the response should contain.
+ * 2. the start index of the range. // inclusive
+ * 3. the end index of the range. // inclusive
+ */
+export declare function calculateByteRangeIndexes(start: number | undefined, end: number | undefined, fileSize?: number): {
+    byteSize?: number;
+    start?: number;
+    end?: number;
+};
+//# sourceMappingURL=request-headers.d.ts.map

package/dist/src/utils/request-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-headers.d.ts","sourceRoot":"","sources":["../../../src/utils/request-headers.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAE,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB/F;AAED;;;;;GAKG;AAEH,wBAAgB,yBAAyB,CAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAoCrK"}

package/dist/src/utils/request-headers.js

@@ -0,0 +1,62 @@
+export function getHeader(headers, header) {
+    if (headers == null) {
+        return undefined;
+    }
+    if (headers instanceof Headers) {
+        return headers.get(header) ?? undefined;
+    }
+    if (Array.isArray(headers)) {
+        const entry = headers.find(([key]) => key.toLowerCase() === header.toLowerCase());
+        return entry?.[1];
+    }
+    const key = Object.keys(headers).find(k => k.toLowerCase() === header.toLowerCase());
+    if (key == null) {
+        return undefined;
+    }
+    return headers[key];
+}
+/**
+ * Given two ints from a Range header, and potential fileSize, returns:
+ * 1. number of bytes the response should contain.
+ * 2. the start index of the range. // inclusive
+ * 3. the end index of the range. // inclusive
+ */
+// eslint-disable-next-line complexity
+export function calculateByteRangeIndexes(start, end, fileSize) {
+    if ((start ?? 0) > (end ?? Infinity)) {
+        throw new Error('Invalid range: Range-start index is greater than range-end index.');
+    }
+    if (start != null && (end ?? 0) >= (fileSize ?? Infinity)) {
+        throw new Error('Invalid range: Range-end index is greater than or equal to the size of the file.');
+    }
+    if (start == null && (end ?? 0) > (fileSize ?? Infinity)) {
+        throw new Error('Invalid range: Range-end index is greater than the size of the file.');
+    }
+    if (start != null && start < 0) {
+        throw new Error('Invalid range: Range-start index cannot be negative.');
+    }
+    if (start != null && end != null) {
+        return { byteSize: end - start + 1, start, end };
+    }
+    else if (start == null && end != null) {
+        // suffix byte range requested
+        if (fileSize == null) {
+            return { end };
+        }
+        if (end === fileSize) {
+            return { byteSize: fileSize, start: 0, end: fileSize - 1 };
+        }
+        return { byteSize: end, start: fileSize - end, end: fileSize - 1 };
+    }
+    else if (start != null && end == null) {
+        if (fileSize == null) {
+            // we only have the start index, and no fileSize, so we can't return a valid range.
+            return { start };
+        }
+        const end = fileSize - 1;
+        const byteSize = fileSize - start;
+        return { byteSize, start, end };
+    }
+    return { byteSize: fileSize, start: 0, end: fileSize != null ? fileSize - 1 : 0 };
+}
+//# sourceMappingURL=request-headers.js.map

package/dist/src/utils/request-headers.js.map

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

package/dist/src/utils/response-headers.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This function returns the value of the `Content-Range` header for a given range.
+ * If you know the total size of the body, pass it as `byteSize`
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Range
+ */
+export declare function getContentRangeHeader({ byteStart, byteEnd, byteSize }: {
+    byteStart: number | undefined;
+    byteEnd: number | undefined;
+    byteSize: number | undefined;
+}): string;
+//# sourceMappingURL=response-headers.d.ts.map

package/dist/src/utils/response-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-headers.d.ts","sourceRoot":"","sources":["../../../src/utils/response-headers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAE,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;IAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,MAAM,CAmC7K"}

package/dist/src/utils/response-headers.js

@@ -0,0 +1,37 @@
+/**
+ * This function returns the value of the `Content-Range` header for a given range.
+ * If you know the total size of the body, pass it as `byteSize`
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Range
+ */
+export function getContentRangeHeader({ byteStart, byteEnd, byteSize }) {
+    const total = byteSize ?? '*'; // if we don't know the total size, we should use *
+    if ((byteEnd ?? 0) >= (byteSize ?? Infinity)) {
+        throw new Error('Invalid range: Range-end index is greater than or equal to the size of the file.');
+    }
+    if ((byteStart ?? 0) >= (byteSize ?? Infinity)) {
+        throw new Error('Invalid range: Range-start index is greater than or equal to the size of the file.');
+    }
+    if (byteStart != null && byteEnd == null) {
+        // only byteStart in range
+        if (byteSize == null) {
+            return `bytes */${total}`;
+        }
+        return `bytes ${byteStart}-${byteSize - 1}/${byteSize}`;
+    }
+    if (byteStart == null && byteEnd != null) {
+        // only byteEnd in range
+        if (byteSize == null) {
+            return `bytes */${total}`;
+        }
+        const end = byteSize - 1;
+        const start = end - byteEnd + 1;
+        return `bytes ${start}-${end}/${byteSize}`;
+    }
+    if (byteStart == null && byteEnd == null) {
+        // neither are provided, we can't return a valid range.
+        return `bytes */${total}`;
+    }
+    return `bytes ${byteStart}-${byteEnd}/${total}`;
+}
+//# sourceMappingURL=response-headers.js.map

package/dist/src/utils/response-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-headers.js","sourceRoot":"","sources":["../../../src/utils/response-headers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAE,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAgG;IACnK,MAAM,KAAK,GAAG,QAAQ,IAAI,GAAG,CAAA,CAAC,mDAAmD;IAEjF,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAA;IACrG,CAAC;IACD,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAA;IACvG,CAAC;IAED,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACzC,0BAA0B;QAC1B,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,WAAW,KAAK,EAAE,CAAA;QAC3B,CAAC;QACD,OAAO,SAAS,SAAS,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAA;IACzD,CAAC;IAED,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACzC,wBAAwB;QACxB,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,WAAW,KAAK,EAAE,CAAA;QAC3B,CAAC;QACD,MAAM,GAAG,GAAG,QAAQ,GAAG,CAAC,CAAA;QACxB,MAAM,KAAK,GAAG,GAAG,GAAG,OAAO,GAAG,CAAC,CAAA;QAE/B,OAAO,SAAS,KAAK,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAA;IAC5C,CAAC;IAED,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACzC,uDAAuD;QACvD,OAAO,WAAW,KAAK,EAAE,CAAA;IAC3B,CAAC;IAED,OAAO,SAAS,SAAS,IAAI,OAAO,IAAI,KAAK,EAAE,CAAA;AACjD,CAAC"}

package/dist/src/utils/responses.d.ts

@@ -1,9 +1,26 @@
+import type { ByteRangeContext } from './byte-range-context';
+import type { SupportedBodyTypes } from '../types.js';
+import type { Logger } from '@libp2p/interface';
 export interface ResponseOptions extends ResponseInit {
     redirected?: boolean;
 }
-export declare function okResponse(url: string, body?: BodyInit | null, init?: ResponseOptions): Response;
-export declare function notSupportedResponse(url: string, body?: BodyInit | null, init?: ResponseInit): Response;
-export declare function notAcceptableResponse(url: string, body?: BodyInit | null, init?: ResponseInit): Response;
-export declare function badRequestResponse(url: string, body?: BodyInit | null, init?: ResponseInit): Response;
+export declare function okResponse(url: string, body?: SupportedBodyTypes, init?: ResponseOptions): Response;
+export declare function badGatewayResponse(url: string, body?: SupportedBodyTypes, init?: ResponseInit): Response;
+export declare function notSupportedResponse(url: string, body?: SupportedBodyTypes, init?: ResponseInit): Response;
+export declare function notAcceptableResponse(url: string, body?: SupportedBodyTypes, init?: ResponseInit): Response;
+export declare function badRequestResponse(url: string, body?: SupportedBodyTypes, init?: ResponseInit): Response;
 export declare function movedPermanentlyResponse(url: string, location: string, init?: ResponseInit): Response;
+interface RangeOptions {
+    byteRangeContext: ByteRangeContext;
+    log?: Logger;
+}
+export declare function okRangeResponse(url: string, body: SupportedBodyTypes, { byteRangeContext, log }: RangeOptions, init?: ResponseOptions): Response;
+/**
+ * We likely need to catch errors handled by upstream helia libraries if range-request throws an error. Some examples:
+ * * The range is out of bounds
+ * * The range is invalid
+ * * The range is not supported for the given type
+ */
+export declare function badRangeResponse(url: string, body?: SupportedBodyTypes, init?: ResponseInit): Response;
+export {};
 //# sourceMappingURL=responses.d.ts.map

package/dist/src/utils/responses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../../src/utils/responses.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,UAAU,CAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,QAAQ,CAejG;AAED,wBAAgB,oBAAoB,CAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAYxG;AAED,wBAAgB,qBAAqB,CAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAWzG;AAED,wBAAgB,kBAAkB,CAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAWtG;AAED,wBAAgB,wBAAwB,CAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAetG"}
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../../src/utils/responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAuB/C,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,UAAU,CAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,QAAQ,CAgBpG;AAED,wBAAgB,kBAAkB,CAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAWzG;AAED,wBAAgB,oBAAoB,CAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAY3G;AAED,wBAAgB,qBAAqB,CAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAW5G;AAED,wBAAgB,kBAAkB,CAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAWzG;AAED,wBAAgB,wBAAwB,CAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAetG;AAED,UAAU,YAAY;IACpB,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,eAAe,CAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,gBAAgB,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,QAAQ,CAkCjJ;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAWvG"}