@helia/verified-fetch 4.1.0 → 5.0.0

package/dist/src/plugins/plugin-handle-raw.js.map

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

package/dist/src/plugins/plugins.d.ts

@@ -1,6 +0,0 @@
-/**
- * Export extension (non-default) plugins here
- */
-export { DirIndexHtmlPlugin, dirIndexHtmlPluginFactory } from './plugin-handle-dir-index-html.js';
-export { DagCborHtmlPreviewPlugin, dagCborHtmlPreviewPluginFactory } from './plugin-handle-dag-cbor-html-preview.js';
-//# sourceMappingURL=plugins.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../src/plugins/plugins.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AACjG,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAA"}

package/dist/src/plugins/plugins.js

@@ -1,6 +0,0 @@
-/**
- * Export extension (non-default) plugins here
- */
-export { DirIndexHtmlPlugin, dirIndexHtmlPluginFactory } from './plugin-handle-dir-index-html.js';
-export { DagCborHtmlPreviewPlugin, dagCborHtmlPreviewPluginFactory } from './plugin-handle-dag-cbor-html-preview.js';
-//# sourceMappingURL=plugins.js.map

package/dist/src/plugins/plugins.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../../src/plugins/plugins.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AACjG,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAA"}

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

@@ -1,103 +0,0 @@
-import type { SupportedBodyTypes } from '../index.js';
-import type { Logger } from '@libp2p/interface';
-interface RequestRange {
-    start: number | undefined;
-    end: number | undefined;
-}
-interface ByteRange extends RequestRange {
-    size: number | undefined;
-}
-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;
-    /**
-     * multiPartBoundary is required for multipart responses
-     */
-    private readonly multiPartBoundary?;
-    private readonly requestRanges;
-    private byteRanges;
-    readonly isMultiRangeRequest: boolean;
-    private _isValidRangeRequest;
-    constructor(logger: Logger, headers?: HeadersInit | undefined);
-    getByteRanges(): ByteRange[];
-    /**
-     * You can pass a function when you need to support multi-range requests but have your own slicing logic, such as in the case of dag-pb/unixfs.
-     *
-     * @param bodyOrProvider - A supported body type or a function that returns a supported body type.
-     * @param contentType - The content type of the body.
-     */
-    setBody(bodyOrProvider: SupportedBodyTypes | ((range: ByteRange) => AsyncGenerator<Uint8Array, void, unknown>), contentType?: string): void;
-    getBody(responseContentType?: string): 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;
-    private isValidByteRange;
-    /**
-     * 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 length that will be used when:
-     * 1. calling unixfs.cat
-     * 2. slicing the body
-     */
-    getLength(range?: ByteRange): 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.
-     * 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;
-    /**
-     * Helper to convert a SliceableBody to a Uint8Array
-     */
-    private convertToUint8Array;
-    private getMultipartBody;
-    private getSlicedBodyForRange;
-    /**
-     * Returns the content type for the response.
-     * For multipart ranges, this will be multipart/byteranges with a boundary.
-     */
-    getContentType(): string | 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>/*
-     */
-    get contentRangeHeaderValue(): string;
-    private createRangeStream;
-}
-export {};
-//# sourceMappingURL=byte-range-context.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"byte-range-context.d.ts","sourceRoot":"","sources":["../../../src/utils/byte-range-context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAI/C,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CACxB;AAED,UAAU,SAAU,SAAQ,YAAY;IACtC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CACzB;AAuDD,qBAAa,gBAAgB;IAqBE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IApBtD,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;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAQ;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0D;IACxF,OAAO,CAAC,UAAU,CAAkB;IACpC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAQ;IAG7C,OAAO,CAAC,oBAAoB,CAAiB;gBAEhC,MAAM,EAAE,MAAM,EAAmB,OAAO,CAAC,EAAE,WAAW,YAAA;IA8B5D,aAAa,IAAK,SAAS,EAAE;IAIpC;;;;;OAKG;IACI,OAAO,CACZ,cAAc,EAAE,kBAAkB,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,KAAK,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,EACtG,WAAW,GAAE,MAAmC,GAC/C,IAAI;IAaA,OAAO,CAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,kBAAkB;IAsCjE,OAAO,CAAC,aAAa;IA+BrB;;;;;OAKG;IACI,WAAW,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI;IAQhD,WAAW,IAAK,MAAM,GAAG,IAAI,GAAG,SAAS;IAIhD,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,gBAAgB;IAcxB;;;OAGG;IACH,IAAW,mBAAmB,IAAK,OAAO,CAuBzC;IAcD;;;;OAIG;IACI,SAAS,CAAE,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS;IA0BxD;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;YACW,mBAAmB;YAwBjB,gBAAgB;IAyChC,OAAO,CAAC,qBAAqB;IAwB7B;;;OAGG;IACI,cAAc,IAAK,MAAM,GAAG,SAAS;IAO5C;;;;;;;;;;OAUG;IAEH,IAAW,uBAAuB,IAAK,MAAM,CAuB5C;IAGD,OAAO,CAAC,iBAAiB;CA8D1B"}

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

@@ -1,504 +0,0 @@
-import toBrowserReadableStream from 'it-to-browser-readablestream';
-import { InvalidRangeError } from '../errors.js';
-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> | bytes=<start1>-<end1>,<start2>-<end2>,...
-     */
-    if (!rangeHeader.startsWith('bytes=')) {
-        throw new InvalidRangeError('Invalid range request');
-    }
-    const rangesStr = rangeHeader.substring(6); // Remove "bytes=" prefix
-    const rangeParts = rangesStr.split(',').map(part => part.trim());
-    const ranges = [];
-    for (const part of rangeParts) {
-        const match = part.match(/^(?<start>\d+)?-(?<end>\d+)?$/);
-        if (match?.groups == null) {
-            throw new InvalidRangeError(`Invalid range specification: ${part}`);
-        }
-        const { start, end } = match.groups;
-        ranges.push({
-            start: start ?? null,
-            end: end ?? null
-        });
-    }
-    if (ranges.length === 0) {
-        throw new InvalidRangeError('No valid ranges found');
-    }
-    return { ranges };
-}
-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;
-    /**
-     * multiPartBoundary is required for multipart responses
-     */
-    multiPartBoundary;
-    requestRanges = [];
-    byteRanges = [];
-    isMultiRangeRequest = false;
-    // to be set by isValidRangeRequest so that we don't need to re-check the byteRanges
-    _isValidRangeRequest = false;
-    constructor(logger, headers) {
-        this.headers = headers;
-        this.log = logger.newScope('byte-range-context');
-        this.rangeRequestHeader = getHeader(this.headers, 'Range');
-        if (this.rangeRequestHeader != null) {
-            this.isRangeRequest = true;
-            this.log.trace('range request detected');
-            try {
-                const { ranges } = getByteRangeFromHeader(this.rangeRequestHeader);
-                this.isMultiRangeRequest = ranges.length > 1;
-                this.requestRanges = ranges.map(range => ({
-                    start: range.start != null ? parseInt(range.start) : null,
-                    end: range.end != null ? parseInt(range.end) : null
-                }));
-                this.multiPartBoundary = `multipart_byteranges_${Math.floor(Math.random() * 1000000000)}`;
-            }
-            catch (e) {
-                this.log.error('error parsing range request header - %e', e);
-                this.requestRanges = [];
-            }
-            this.setOffsetDetails();
-        }
-        else {
-            this.log.trace('no range request detected');
-            this.isRangeRequest = false;
-        }
-    }
-    getByteRanges() {
-        return this.byteRanges;
-    }
-    /**
-     * You can pass a function when you need to support multi-range requests but have your own slicing logic, such as in the case of dag-pb/unixfs.
-     *
-     * @param bodyOrProvider - A supported body type or a function that returns a supported body type.
-     * @param contentType - The content type of the body.
-     */
-    setBody(bodyOrProvider, contentType = 'application/octet-stream') {
-        if (typeof bodyOrProvider === 'function') {
-            this._body = this.createRangeStream(bodyOrProvider, contentType);
-        }
-        else {
-            this._body = bodyOrProvider;
-            // if fileSize was already set, don't recalculate it
-            this.setFileSize(this._fileSize ?? getBodySizeSync(bodyOrProvider));
-        }
-        this.log.trace('set request body with fileSize %o', this._fileSize);
-    }
-    getBody(responseContentType) {
-        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;
-        }
-        if (this.isMultiRangeRequest) {
-            if (this._body instanceof ReadableStream) {
-                return this._body;
-            }
-            return toBrowserReadableStream(this.getMultipartBody(responseContentType));
-        }
-        // Single range request handling
-        if (this.byteRanges.length > 0) {
-            const range = this.byteRanges[0];
-            if (body instanceof ReadableStream) {
-                // stream should already be spliced by `unixfs.cat`
-                // TODO: if the content is not unixfs and unixfs.cat was not called, we need to slice the body here.
-                return body;
-            }
-            if (range.start != null || range.end != null) {
-                this.log.trace('returning body with byteStart=%o, byteEnd=%o, byteSize=%o', range.start, range.end, range.size);
-            }
-            return this.getSlicedBody(body, range);
-        }
-        // we should not reach this point, but return body untouched.
-        this.log.error('returning unmodified body for valid range request');
-        return body;
-    }
-    getSlicedBody(body, range) {
-        const offset = range.start ?? 0;
-        // Calculate the correct number of bytes to return
-        // For a range like bytes=1000-2000, we want exactly 1001 bytes
-        let length;
-        if (range.end != null && range.start != null) {
-            // Exact number of bytes is (end - start + 1) due to inclusive ranges
-            length = range.end - range.start + 1;
-        }
-        else {
-            length = undefined;
-        }
-        this.log.trace('slicing body with offset=%o and length=%o', offset, length);
-        if (typeof body === 'string') {
-            // String slicing works with start and end indices
-            return body.slice(offset, length !== undefined ? offset + length : undefined);
-        }
-        else if (body instanceof Blob) {
-            // Blob.slice takes start and end positions
-            return body.slice(offset, length !== undefined ? offset + length : undefined);
-        }
-        else if (body instanceof ArrayBuffer || body instanceof Uint8Array) {
-            // ArrayBuffer.slice and Uint8Array.slice take start and end positions
-            return body.slice(offset, length !== undefined ? offset + length : undefined);
-        }
-        // This should never happen due to type constraints
-        return body;
-    }
-    /**
-     * 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._isValidRangeRequest = false; // body has changed, so we need to re-validate the byte ranges
-        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(byteStart, byteEnd) {
-        if (byteStart != null) {
-            if (byteStart < 0) {
-                return false;
-            }
-            if (this._fileSize != null && byteStart >= this._fileSize) {
-                return false;
-            }
-            if (byteEnd != null && byteStart > byteEnd) {
-                return false;
-            }
-        }
-        return true;
-    }
-    isValidByteEnd(byteStart, byteEnd) {
-        if (byteEnd != null) {
-            if (byteEnd < 0) {
-                this.log.trace('invalid range request, byteEnd is less than 0');
-                return false;
-            }
-            if (this._fileSize != null && byteEnd >= this._fileSize) {
-                this.log.trace('invalid range request, byteEnd is greater than fileSize');
-                return false;
-            }
-            if (byteStart != null && byteEnd < byteStart) {
-                this.log.trace('invalid range request, byteEnd is less than byteStart');
-                return false;
-            }
-        }
-        return true;
-    }
-    isValidByteRange(range) {
-        this.log.trace('validating byte range: %o', range);
-        if (range.start != null && !this.isValidByteStart(range.start, range.end)) {
-            this.log.trace('invalid range request, byteStart is less than 0 or greater than fileSize');
-            return false;
-        }
-        if (range.end != null && !this.isValidByteEnd(range.start, range.end)) {
-            this.log.trace('invalid range request, byteEnd is less than 0 or greater than fileSize');
-            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._isValidRangeRequest) {
-            // prevent unnecessary re-validation of each byte range
-            return true;
-        }
-        if (!this.isRangeRequest) {
-            return false;
-        }
-        if (this.byteRanges.length === 0) {
-            this.log.trace('invalid range request, no valid ranges');
-            return false;
-        }
-        const isValid = this.byteRanges.every(range => this.isValidByteRange(range));
-        if (!isValid) {
-            this.log.trace('invalid range request, not all ranges are valid');
-            return false;
-        }
-        this._isValidRangeRequest = true;
-        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
-    //  */
-    // public offset (range: ByteRange): number {
-    //   if (this.byteRanges.length > 0) {
-    //     return this.byteRanges[0].start ?? 0
-    //   }
-    //   return 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
-     */
-    getLength(range) {
-        if (!this.isValidRangeRequest) {
-            this.log.error('cannot get length for invalid range request');
-            return undefined;
-        }
-        if (this.isMultiRangeRequest && range == null) {
-            /**
-             * The content-length for a multi-range request is the sum of the lengths of all the ranges, plus the boundaries and part headers and newlines.
-             */
-            // TODO: figure out a way to calculate the correct content-length for multi-range requests' response.
-            return undefined;
-        }
-        range ??= this.byteRanges[0];
-        this.log.trace('getting length for range: %o', range);
-        if (range.end != null && range.start != null) {
-            // For a range like bytes=1000-2000, we want a length of 1001 bytes
-            return range.end - range.start + 1;
-        }
-        if (range.end != null) {
-            return range.end + 1;
-        }
-        return range.size;
-    }
-    /**
-     * 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.
-     * 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.requestRanges.length === 0) {
-            this.log.trace('no request ranges defined');
-            return;
-        }
-        try {
-            // Calculate byte ranges for all requests
-            this.byteRanges = this.requestRanges.map(range => {
-                const { start, end, byteSize } = calculateByteRangeIndexes(range.start ?? undefined, range.end ?? undefined, this._fileSize ?? undefined);
-                return { start, end, size: byteSize };
-            });
-            this.log.trace('set byte ranges: %o', this.byteRanges);
-        }
-        catch (e) {
-            this.log.error('error setting offset details: %o', e);
-            this.byteRanges = [];
-        }
-    }
-    /**
-     * Helper to convert a SliceableBody to a Uint8Array
-     */
-    async convertToUint8Array(content) {
-        if (typeof content === 'string') {
-            return new TextEncoder().encode(content);
-        }
-        if ('arrayBuffer' in content && typeof content.arrayBuffer === 'function') {
-            // This is a Blob
-            const buffer = await content.arrayBuffer();
-            return new Uint8Array(buffer);
-        }
-        if ('byteLength' in content && !('buffer' in content)) {
-            // This is an ArrayBuffer
-            return new Uint8Array(content);
-        }
-        if ('buffer' in content && 'byteLength' in content && 'byteOffset' in content) {
-            // This is a Uint8Array
-            return content;
-        }
-        throw new Error('Unsupported content type for multipart response');
-    }
-    async *getMultipartBody(responseContentType = 'application/octet-stream') {
-        const body = this._body;
-        if (body instanceof ReadableStream) {
-            // in the case of unixfs, the body is a readable stream, and setBody is called with a function that returns a readable stream that generates the
-            // correct multipartBody.. so we just return that body.
-            return body;
-        }
-        if (body === null) {
-            throw new Error('Cannot create multipart body from null');
-        }
-        const encoder = new TextEncoder();
-        for (const range of this.byteRanges) {
-            if (range.start === undefined || range.end === undefined) {
-                continue;
-            }
-            // Calculate part headers
-            const partHeaderString = `\r\n--${this.multiPartBoundary}\r\n` +
-                `Content-Type: ${responseContentType}\r\n` +
-                `Content-Range: ${getContentRangeHeader({
-                    byteStart: range.start,
-                    byteEnd: range.end,
-                    byteSize: this._fileSize ?? undefined
-                })}\r\n\r\n`;
-            // Convert header to Uint8Array
-            yield encoder.encode(partHeaderString);
-            // Get content for this range and convert to Uint8Array
-            const slicedContent = this.getSlicedBodyForRange(body, range.start, range.end);
-            yield await this.convertToUint8Array(slicedContent);
-        }
-        // Add final this.multiPartBoundary
-        yield encoder.encode(`\r\n--${this.multiPartBoundary}--`);
-    }
-    getSlicedBodyForRange(body, start, end) {
-        // Calculate the correct number of bytes to return
-        // For a range like bytes=1000-2000, we want exactly 1001 bytes
-        const offset = start;
-        const length = end - start + 1;
-        this.log.trace('slicing body with offset=%o and length=%o', offset, length);
-        if (typeof body === 'string') {
-            return body.slice(offset, offset + length);
-        }
-        else if (body instanceof Blob) {
-            return body.slice(offset, offset + length);
-        }
-        else if (body instanceof ArrayBuffer || body instanceof Uint8Array) {
-            return body.slice(offset, offset + length);
-        }
-        else {
-            // This should never happen due to type constraints
-            return body;
-        }
-    }
-    /**
-     * Returns the content type for the response.
-     * For multipart ranges, this will be multipart/byteranges with a boundary.
-     */
-    getContentType() {
-        if (this.isMultiRangeRequest && this.isValidRangeRequest) {
-            return `multipart/byteranges; boundary=${this.multiPartBoundary}`;
-        }
-        return 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() {
-        // For multipart responses, this will be included in each part
-        // So this method is only used for single-range responses
-        if (!this.isValidRangeRequest) {
-            this.log.error('cannot get contentRangeHeaderValue for invalid range request');
-            throw new InvalidRangeError('Invalid range request');
-        }
-        if (this.isMultiRangeRequest) {
-            this.log.error('contentRangeHeaderValue should not be called for multipart responses');
-            throw new InvalidRangeError('Content-Range header not applicable for multipart responses');
-        }
-        if (this.byteRanges.length > 0) {
-            const range = this.byteRanges[0];
-            return getContentRangeHeader({
-                byteStart: range.start,
-                byteEnd: range.end,
-                byteSize: this._fileSize ?? undefined
-            });
-        }
-        throw new InvalidRangeError('No valid ranges found');
-    }
-    // Unified method to create a stream for either single or multi-range requests
-    createRangeStream(contentProvider, contentType) {
-        const encoder = new TextEncoder();
-        const byteRanges = this.byteRanges;
-        const multiPartBoundary = this.multiPartBoundary;
-        const fileSize = this._fileSize;
-        const log = this.log;
-        const isMultiRangeRequest = this.isMultiRangeRequest;
-        if (byteRanges.length === 0) {
-            // TODO: create a stream with a range of *
-            log.error('Cannot create range stream with no byte ranges');
-            throw new InvalidRangeError('No valid ranges found');
-        }
-        return new ReadableStream({
-            async start(controller) {
-                try {
-                    // For multi-range requests, we need to handle multiple parts with headers
-                    for (const range of byteRanges) {
-                        // Write part header for multipart responses
-                        if (isMultiRangeRequest) {
-                            const partHeader = `\r\n--${multiPartBoundary}\r\n` +
-                                `Content-Type: ${contentType}\r\n` +
-                                `Content-Range: ${getContentRangeHeader({
-                                    byteStart: range.start,
-                                    byteEnd: range.end,
-                                    byteSize: fileSize ?? undefined
-                                })}\r\n\r\n`;
-                            controller.enqueue(encoder.encode(partHeader));
-                        }
-                        // Get and stream content for this range
-                        try {
-                            // Get content for this range
-                            const rangeContent = contentProvider(range);
-                            for await (const chunk of rangeContent) {
-                                controller.enqueue(chunk);
-                            }
-                        }
-                        catch (err) {
-                            log.error('Error processing range %o: %o', range, err);
-                            throw err; // Re-throw to be caught by the outer try/catch
-                        }
-                    }
-                    if (isMultiRangeRequest) {
-                        // Write final boundary for multipart
-                        controller.enqueue(encoder.encode(`\r\n--${multiPartBoundary}--`));
-                    }
-                    controller.close();
-                }
-                catch (err) {
-                    log.error('Error processing range(s) - %e', err);
-                    controller.error(err);
-                }
-            }
-        });
-    }
-}
-//# sourceMappingURL=byte-range-context.js.map