@helia/verified-fetch 4.1.1 → 5.0.0

package/dist/src/plugins/plugin-handle-unixfs.js

@@ -0,0 +1,180 @@
+import { code as dagPbCode } from '@ipld/dag-pb';
+import { isPromise } from '@libp2p/utils';
+import { exporter } from 'ipfs-unixfs-exporter';
+import first from 'it-first';
+import itToBrowserReadableStream from 'it-to-browser-readablestream';
+import toBuffer from 'it-to-buffer';
+import * as raw from 'multiformats/codecs/raw';
+import { MEDIA_TYPE_OCTET_STREAM, MEDIA_TYPE_DAG_PB } from "../utils/content-types.js";
+import { getContentDispositionFilename } from "../utils/get-content-disposition-filename.js";
+import { badGatewayResponse, movedPermanentlyResponse, partialContentResponse, okResponse } from '../utils/responses.js';
+import { BasePlugin } from './plugin-base.js';
+/**
+ * @see https://specs.ipfs.tech/http-gateways/path-gateway/#use-in-directory-url-normalization
+ */
+function getRedirectUrl(resource, url, terminalElement) {
+    let uri;
+    try {
+        // try the requested resource
+        uri = new URL(resource);
+    }
+    catch {
+        // fall back to the canonical URL
+        uri = url;
+    }
+    // directories must be requested with a trailing slash
+    if (terminalElement?.type === 'directory' && !uri.pathname.endsWith('/')) {
+        // make sure we append slash to end of the path
+        uri.pathname += '/';
+        return uri.toString();
+    }
+}
+/**
+ * Handles UnixFS content
+ */
+export class UnixFSPlugin extends BasePlugin {
+    id = 'unixfs-plugin';
+    codes = [dagPbCode, raw.code];
+    canHandle({ terminalElement, accept }) {
+        const supportsCid = this.codes.includes(terminalElement.cid.code);
+        const supportsAccept = accept.length === 0 || accept.some(header => header.contentType.mediaType === MEDIA_TYPE_OCTET_STREAM ||
+            header.contentType.mediaType === MEDIA_TYPE_DAG_PB);
+        return supportsCid && supportsAccept;
+    }
+    async handle(context) {
+        let { url, resource, terminalElement, ipfsRoots } = context;
+        let filename = url.searchParams.get('filename') ?? terminalElement.name;
+        let redirected;
+        if (terminalElement.type === 'directory') {
+            const redirectUrl = getRedirectUrl(resource, url, terminalElement);
+            if (redirectUrl != null) {
+                this.log.trace('directory url normalization spec requires redirect');
+                if (context.options?.redirect === 'error') {
+                    this.log('could not redirect to %s as redirect option was set to "error"', redirectUrl);
+                    throw new TypeError('Failed to fetch');
+                }
+                else if (context.options?.redirect === 'manual') {
+                    this.log('returning 301 permanent redirect to %s', redirectUrl);
+                    return movedPermanentlyResponse(context.resource, redirectUrl);
+                }
+                this.log('following redirect to %s', redirectUrl);
+                // fall-through simulates following the redirect?
+                resource = redirectUrl;
+                redirected = true;
+            }
+            const dirCid = terminalElement.cid;
+            // if not disabled, search the directory for an index.html file
+            if (context.options?.supportDirectoryIndexes !== false) {
+                const rootFilePath = 'index.html';
+                try {
+                    this.log.trace('found directory at %c/%s, looking for index.html', dirCid, url.pathname);
+                    const entry = await context.serverTiming.time('exporter-dir', '', exporter(`/ipfs/${dirCid}/${rootFilePath}`, context.blockstore, context.options));
+                    if (entry.type === 'directory' || entry.type === 'object') {
+                        return badGatewayResponse(resource, 'Unable to stream content');
+                    }
+                    // use `index.html` as the file name to help with content types
+                    filename = rootFilePath;
+                    this.log.trace('found directory index at %c/%s with cid %c', dirCid, rootFilePath, entry.cid);
+                    return await this.streamFile(resource, entry, filename, redirected, context.range, context.options);
+                }
+                catch (err) {
+                    if (err.name !== 'NotFoundError') {
+                        this.log.error('error loading path %c/%s - %e', dirCid, rootFilePath, err);
+                        throw err;
+                    }
+                }
+            }
+            // no index file found, return the directory listing
+            const block = await toBuffer(context.blockstore.get(dirCid, context.options));
+            return okResponse(resource, block, {
+                headers: {
+                    'content-type': MEDIA_TYPE_DAG_PB,
+                    'content-length': `${block.byteLength}`,
+                    'content-disposition': `${url.searchParams.get('download') === 'true' ? 'attachment' : 'inline'}; ${getContentDispositionFilename(`${dirCid}.dir`)}`,
+                    'x-ipfs-roots': ipfsRoots.map(cid => cid.toV1()).join(','),
+                    'accept-ranges': 'bytes'
+                },
+                redirected
+            });
+        }
+        else if (terminalElement.type === 'file' || terminalElement.type === 'raw' || terminalElement.type === 'identity') {
+            this.log('streaming file');
+            return this.streamFile(resource, terminalElement, filename, redirected, context.range, context.options);
+        }
+        else {
+            this.log.error('cannot stream terminal element type %s', terminalElement.type);
+            return badGatewayResponse(resource, 'Unable to stream content');
+        }
+    }
+    async streamFile(resource, entry, filename, redirected, rangeHeader, options) {
+        let contentType = MEDIA_TYPE_OCTET_STREAM;
+        // only detect content type for non-range requests to avoid loading blocks
+        // we aren't going to stream to the user
+        if (rangeHeader == null) {
+            contentType = await this.detectContentType(entry, filename, options);
+        }
+        if (rangeHeader != null) {
+            return partialContentResponse(resource, (offset, length) => {
+                return entry.content({
+                    ...(options ?? {}),
+                    offset,
+                    length
+                });
+            }, rangeHeader, entry.size, {
+                headers: {
+                    'content-type': contentType,
+                    'content-disposition': `inline; ${getContentDispositionFilename(filename)}`,
+                    'x-ipfs-roots': entry.cid.toString(),
+                    'accept-ranges': 'bytes'
+                },
+                redirected
+            });
+        }
+        // nb. if streaming the output fails (network error, unresolvable block,
+        // etc), a "TypeError: Failed to fetch" error will occur
+        return okResponse(resource, itToBrowserReadableStream(entry.content(options)), {
+            headers: {
+                'content-type': contentType,
+                'content-length': `${entry.size}`,
+                'content-disposition': `inline; ${getContentDispositionFilename(filename)}`,
+                'x-ipfs-roots': entry.cid.toString(),
+                'accept-ranges': 'bytes'
+            },
+            redirected
+        });
+    }
+    async detectContentType(entry, filename, options) {
+        let buf;
+        if (entry.type === 'raw' || entry.type === 'identity') {
+            buf = entry.node;
+        }
+        else {
+            // read the first block of the file
+            buf = await first(entry.content(options));
+        }
+        if (buf == null) {
+            throw new Error('stream ended before first block was read');
+        }
+        let contentType;
+        if (this.pluginOptions.contentTypeParser != null) {
+            try {
+                const parsed = this.pluginOptions.contentTypeParser(buf, filename);
+                if (isPromise(parsed)) {
+                    const result = await parsed;
+                    if (result != null) {
+                        contentType = result;
+                    }
+                }
+                else if (parsed != null) {
+                    contentType = parsed;
+                }
+                this.log.trace('contentTypeParser returned %s for file with name %s', contentType, filename);
+            }
+            catch (err) {
+                this.log.error('error parsing content type - %e', err);
+            }
+        }
+        return contentType ?? MEDIA_TYPE_OCTET_STREAM;
+    }
+}
+//# sourceMappingURL=plugin-handle-unixfs.js.map

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

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

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

@@ -1,78 +1,2 @@
-import type { ResolveURLResult, VerifiedFetchInit, ContentTypeParser, RequestFormatShorthand } from '../index.js';
-import type { ByteRangeContext } from '../utils/byte-range-context.js';
-import type { AcceptHeader } from '../utils/select-output-type.ts';
-import type { ServerTiming } from '../utils/server-timing.ts';
-import type { PathWalkerResponse } from '../utils/walk-path.js';
-import type { IPNSResolver } from '@helia/ipns';
-import type { AbortOptions, Logger } from '@libp2p/interface';
-import type { Helia } from 'helia';
-import type { Blockstore } from 'interface-blockstore';
-import type { UnixFSEntry } from 'ipfs-unixfs-exporter';
-import type { CID } from 'multiformats/cid';
-import type { CustomProgressEvent } from 'progress-events';
-/**
- * Contains common components and functions required by plugins to handle a request.
- * - Read-Only: Plugins can read but shouldn't rewrite them.
- * - Persistent: Relevant even after the request completes (e.g., logging or metrics).
- */
-export interface PluginOptions {
-    logger: Logger;
-    getBlockstore(cid: CID, resource: string | CID, useSession?: boolean, options?: AbortOptions): Blockstore;
-    contentTypeParser?: ContentTypeParser;
-    helia: Helia;
-    ipnsResolver: IPNSResolver;
-}
-/**
- * Represents the ephemeral, modifiable state used by the pipeline.
- * - Mutable: Evolves as you walk the plugin chain.
- * - Shared Data: Allows plugins to communicate partial results, discovered data, or interim errors.
- * - Ephemeral: Typically discarded once fetch(...) completes.
- */
-export interface PluginContext extends ResolveURLResult {
-    readonly resource: string;
-    readonly accept?: AcceptHeader;
-    /**
-     * An array of plugin IDs that are all enabled. You can use this to check if a plugin is enabled and respond accordingly.
-     */
-    plugins: string[];
-    /**
-     * The last time the context is modified, so we know whether a plugin has modified it.
-     * A plugin should increment this value if it modifies the context.
-     */
-    modified: number;
-    onProgress?(evt: CustomProgressEvent<any>): void;
-    options?: Omit<VerifiedFetchInit, 'signal'> & AbortOptions;
-    isDirectory?: boolean;
-    directoryEntries?: UnixFSEntry[];
-    reqFormat?: RequestFormatShorthand;
-    pathDetails?: PathWalkerResponse;
-    /**
-     * ByteRangeContext contains information about the size of the content and range requests.
-     * This can be used to set the Content-Length header without loading the entire body.
-     *
-     * This is set by the ByteRangeContextPlugin
-     */
-    byteRangeContext?: ByteRangeContext;
-    serverTiming: ServerTiming;
-    ipfsPath: string;
-    /**
-     * Allow arbitrary keys/values
-     */
-    [key: string]: unknown;
-}
-export interface VerifiedFetchPlugin {
-    readonly id: string;
-    readonly codes: number[];
-    readonly log: Logger;
-    canHandle(context: PluginContext): boolean;
-    handle(context: PluginContext): Promise<Response | null>;
-}
-export interface VerifiedFetchPluginFactory {
-    (options: PluginOptions): VerifiedFetchPlugin;
-}
-export interface PluginErrorOptions {
-    fatal?: boolean;
-    details?: Record<string, any>;
-    response?: Response;
-}
+export {};
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/url-resolver.d.ts

@@ -1,22 +1,40 @@
 import { CID } from 'multiformats/cid';
-import type { ResolveURLOptions, ResolveURLResult, Resource, URLResolver as URLResolverInterface } from './index.ts';
-import type { ParsedURL } from './utils/parse-url-string.ts';
-import type { ServerTiming } from './utils/server-timing.ts';
+import { ServerTiming } from './utils/server-timing.ts';
+import type { ResolveURLResult, URLResolver as URLResolverInterface } from './index.ts';
 import type { DNSLink } from '@helia/dnslink';
 import type { IPNSResolver } from '@helia/ipns';
-import type { AbortOptions, PeerId } from '@libp2p/interface';
+import type { AbortOptions } from '@libp2p/interface';
+import type { Helia } from 'helia';
+import type { Blockstore } from 'interface-blockstore';
+import type { UnixFSEntry } from 'ipfs-unixfs-exporter';
+export interface WalkPathResult {
+    ipfsRoots: CID[];
+    terminalElement: UnixFSEntry;
+    blockstore: Blockstore;
+}
 export interface URLResolverComponents {
+    helia: Helia;
     ipnsResolver: IPNSResolver;
     dnsLink: DNSLink;
-    timing: ServerTiming;
+}
+export interface URLResolverInit {
+    sessionCacheSize?: number;
+    sessionTTLms?: number;
+}
+export interface ResolveURLOptions extends AbortOptions {
+    session?: boolean;
+    isRawBlockRequest?: boolean;
+    onlyIfCached?: boolean;
 }
 export declare class URLResolver implements URLResolverInterface {
     private readonly components;
-    constructor(components: URLResolverComponents);
-    resolve(resource: Resource, options?: ResolveURLOptions): Promise<ResolveURLResult>;
-    parseUrlString(urlString: string, options?: ResolveURLOptions): Promise<ResolveURLResult>;
-    resolveCIDResource(cid: CID, parsed: Partial<ParsedURL> & Pick<ParsedURL, 'url'>, options?: ResolveURLOptions): Promise<ResolveURLResult>;
-    resolveDNSLink(domain: string, parsed: ParsedURL, options?: ResolveURLOptions): Promise<ResolveURLResult>;
-    resolveIPNSName(resource: string, key: PeerId, parsed: Partial<ParsedURL> & Pick<ParsedURL, 'url'>, options?: AbortOptions): Promise<ResolveURLResult>;
+    private readonly blockstoreSessions;
+    constructor(components: URLResolverComponents, init?: URLResolverInit);
+    resolve(url: URL, serverTiming?: ServerTiming, options?: ResolveURLOptions): Promise<ResolveURLResult>;
+    private getBlockstore;
+    private resolveDNSLink;
+    private resolveIPNSName;
+    private resolveIPFSPath;
+    private walkPath;
 }
 //# sourceMappingURL=url-resolver.d.ts.map

package/dist/src/url-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-resolver.d.ts","sourceRoot":"","sources":["../../src/url-resolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAEtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,WAAW,IAAI,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACpH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAI7D,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,YAAY,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,YAAY,CAAA;CACrB;AAED,qBAAa,WAAY,YAAW,oBAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;gBAErC,UAAU,EAAE,qBAAqB;IAIxC,OAAO,CAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgBxF,cAAc,CAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2B9F,kBAAkB,CAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkB9I,cAAc,CAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgC1G,eAAe,CAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAe9J"}
+{"version":3,"file":"url-resolver.d.ts","sourceRoot":"","sources":["../../src/url-resolver.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAMtC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,IAAI,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,KAAK,EAAqB,MAAM,OAAO,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAyBvD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,GAAG,EAAE,CAAA;IAChB,eAAe,EAAE,WAAW,CAAA;IAC5B,UAAU,EAAE,UAAU,CAAA;CACvB;AAiBD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,KAAK,CAAA;IACZ,YAAY,EAAE,YAAY,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,qBAAa,WAAY,YAAW,oBAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqC;gBAE3D,UAAU,EAAE,qBAAqB,EAAE,IAAI,GAAE,eAAoB;IAYpE,OAAO,CAAE,GAAG,EAAE,GAAG,EAAE,YAAY,GAAE,YAAiC,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgBrI,OAAO,CAAC,aAAa;YAgBP,cAAc;YAiCd,eAAe;YAmBf,eAAe;YAWf,QAAQ;CAuDvB"}

package/dist/src/url-resolver.js

@@ -1,106 +1,184 @@
-import { peerIdFromCID, peerIdFromString } from '@libp2p/peer-id';
+import { DoesNotExistError } from '@helia/unixfs/errors';
+import * as dagCbor from '@ipld/dag-cbor';
+import * as dagJson from '@ipld/dag-json';
+import * as dagPb from '@ipld/dag-pb';
+import { peerIdFromString } from '@libp2p/peer-id';
+import { InvalidParametersError, walkPath } from 'ipfs-unixfs-exporter';
+import toBuffer from 'it-to-buffer';
 import { CID } from 'multiformats/cid';
-import { parseURLString } from "./utils/parse-url-string.js";
-const CODEC_LIBP2P_KEY = 0x72;
+import * as json from 'multiformats/codecs/json';
+import * as raw from 'multiformats/codecs/raw';
+import QuickLRU from 'quick-lru';
+import { SESSION_CACHE_MAX_SIZE, SESSION_CACHE_TTL_MS, CODEC_CBOR, CODEC_IDENTITY } from "./constants.js";
+import { resourceToSessionCacheKey } from "./utils/resource-to-cache-key.js";
+import { ServerTiming } from "./utils/server-timing.js";
+// 1 year in seconds for ipfs content
+const IPFS_CONTENT_TTL = 29030400;
+const ENTITY_CODECS = [
+    CODEC_CBOR,
+    json.code,
+    raw.code
+];
+/**
+ * These are supported by the UnixFS exporter
+ */
+const EXPORTABLE_CODECS = [
+    dagPb.code,
+    dagCbor.code,
+    dagJson.code,
+    raw.code
+];
+function basicEntry(type, cid, bytes) {
+    return {
+        name: cid.toString(),
+        path: cid.toString(),
+        depth: 0,
+        type,
+        node: bytes,
+        cid,
+        size: BigInt(bytes.byteLength),
+        content: async function* () {
+            yield bytes;
+        }
+    };
+}
 export class URLResolver {
     components;
-    constructor(components) {
+    blockstoreSessions;
+    constructor(components, init = {}) {
         this.components = components;
+        this.blockstoreSessions = new QuickLRU({
+            maxSize: init.sessionCacheSize ?? SESSION_CACHE_MAX_SIZE,
+            maxAge: init.sessionTTLms ?? SESSION_CACHE_TTL_MS,
+            onEviction: (key, store) => {
+                store.close();
+            }
+        });
     }
-    async resolve(resource, options = {}) {
-        if (typeof resource === 'string') {
-            return this.parseUrlString(resource, options);
+    async resolve(url, serverTiming = new ServerTiming(), options = {}) {
+        if (url.protocol === 'ipfs:') {
+            return this.resolveIPFSPath(url, serverTiming, options);
         }
-        const cid = CID.asCID(resource);
-        if (cid != null) {
-            return this.resolveCIDResource(cid, {
-                url: new URL(`ipfs://${cid}`)
-            }, options);
+        if (url.protocol === 'ipns:') {
+            return this.resolveIPNSName(url, serverTiming, options);
         }
-        throw new TypeError(`Invalid resource. Cannot determine CID from resource: ${resource}`);
-    }
-    async parseUrlString(urlString, options = {}) {
-        const result = parseURLString(urlString);
-        if (result.protocol === 'ipfs') {
-            const cid = CID.parse(result.cidOrPeerIdOrDnsLink);
-            return this.resolveCIDResource(cid, result, options);
-        }
-        if (result.protocol === 'ipns') {
-            // try to parse target as peer id
-            let peerId;
-            try {
-                peerId = peerIdFromString(result.cidOrPeerIdOrDnsLink);
-            }
-            catch {
-                // fall back to DNSLink (e.g. /ipns/example.com)
-                return this.resolveDNSLink(result.cidOrPeerIdOrDnsLink, result, options);
-            }
-            // parse multihash from string (e.g. /ipns/QmFoo...)
-            return this.resolveIPNSName(result.cidOrPeerIdOrDnsLink, peerId, result, options);
+        if (url.protocol === 'dnslink:') {
+            return this.resolveDNSLink(url, serverTiming, options);
         }
-        throw new TypeError(`Invalid resource. Cannot determine CID from resource: ${urlString}`);
+        throw new InvalidParametersError(`Invalid resource. Unsupported protocol in URL, must be ipfs:, ipns:, or dnslink: ${url}`);
     }
-    async resolveCIDResource(cid, parsed, options = {}) {
-        if (cid.code === CODEC_LIBP2P_KEY) {
-            // special case - peer id encoded as a CID
-            return this.resolveIPNSName(cid.toString(), peerIdFromCID(cid), parsed, options);
+    getBlockstore(root, options = {}) {
+        if (options.session === false) {
+            return this.components.helia.blockstore;
         }
-        return {
-            url: parsed.url,
-            cid,
-            protocol: 'ipfs',
-            query: parsed.query ?? {},
-            path: parsed.path ?? [],
-            fragment: parsed.fragment ?? '',
-            ttl: 29030400, // 1 year for ipfs content
-            ipfsPath: `/ipfs/${cid}${parsed.url.pathname}`
-        };
+        const key = resourceToSessionCacheKey(root);
+        let session = this.blockstoreSessions.get(key);
+        if (session == null) {
+            session = this.components.helia.blockstore.createSession(root, options);
+            this.blockstoreSessions.set(key, session);
+        }
+        return session;
     }
-    async resolveDNSLink(domain, parsed, options) {
-        const results = await this.components.timing.time('dnsLink.resolve', `Resolve DNSLink ${domain}`, this.components.dnsLink.resolve(domain, options));
+    async resolveDNSLink(url, serverTiming, options) {
+        const results = await serverTiming.time('dnsLink.resolve', `Resolve DNSLink ${url.hostname}`, this.components.dnsLink.resolve(url.hostname, options));
         const result = results?.[0];
         if (result == null) {
-            throw new TypeError(`Invalid resource. Cannot resolve DNSLink from domain: ${domain}`);
+            throw new TypeError(`Invalid resource. Cannot resolve DNSLink from domain: ${url.hostname}`);
         }
         // dnslink resolved to IPNS name
         if (result.namespace === 'ipns') {
-            return this.resolveIPNSName(domain, result.peerId, parsed, options);
+            return this.resolveIPNSName(url, serverTiming, options);
         }
         // dnslink resolved to CID
         if (result.namespace !== 'ipfs') {
             // @ts-expect-error result namespace should only be ipns or ipfs
             throw new TypeError(`Invalid resource. Unexpected DNSLink namespace ${result.namespace} from domain: ${domain}`);
         }
+        if (result.path != null && url.pathname !== '') {
+            // path conflict?
+        }
+        const ipfsUrl = new URL(`ipfs://${result.cid}/${url.pathname}`);
+        const ipfsResult = await this.resolveIPFSPath(ipfsUrl, serverTiming, options);
         return {
-            url: parsed.url,
-            cid: result.cid,
-            path: concatPaths(...(result.path ?? '').split('/'), ...(parsed.path ?? [])),
-            fragment: parsed.fragment,
-            // dnslink is mutable so return 'ipns' protocol so we do not include immutable in cache-control header
-            protocol: 'ipns',
-            ttl: result.answer.TTL,
-            query: parsed.query,
-            ipfsPath: `/ipns/${domain}${parsed.url.pathname}`
+            ...ipfsResult,
+            url,
+            ttl: result.answer.TTL
         };
     }
-    async resolveIPNSName(resource, key, parsed, options) {
-        const result = await this.components.timing.time('ipns.resolve', `Resolve IPNS name ${key}`, this.components.ipnsResolver.resolve(key, options));
+    async resolveIPNSName(url, serverTiming, options) {
+        const peerId = peerIdFromString(url.hostname);
+        const result = await serverTiming.time('ipns.resolve', `Resolve IPNS name ${peerId}`, this.components.ipnsResolver.resolve(peerId, options));
+        if (result.path != null && url.pathname !== '') {
+            // path conflict?
+        }
+        const ipfsUrl = new URL(`ipfs://${result.cid}/${url.pathname}`);
+        const ipfsResult = await this.resolveIPFSPath(ipfsUrl, serverTiming, options);
         return {
-            url: parsed.url,
-            cid: result.cid,
-            path: concatPaths(...(result.path ?? '').split('/'), ...(parsed.path ?? [])),
-            query: parsed.query ?? {},
-            fragment: parsed.fragment ?? '',
-            protocol: 'ipns',
+            ...ipfsResult,
+            url,
             // IPNS ttl is in nanoseconds, convert to seconds
-            ttl: Number((result.record.ttl ?? 0n) / BigInt(1e9)),
-            ipfsPath: `/ipns/${resource}${parsed.url.pathname}`
+            ttl: Number((result.record.ttl ?? 0n) / BigInt(1e9))
+        };
+    }
+    async resolveIPFSPath(url, serverTiming, options) {
+        const walkPathResult = await serverTiming.time('ipfs.resolve', '', this.walkPath(url, options));
+        return {
+            ...walkPathResult,
+            url,
+            ttl: IPFS_CONTENT_TTL,
+            blockstore: walkPathResult.blockstore
+        };
+    }
+    async walkPath(url, options = {}) {
+        const cid = CID.parse(url.hostname);
+        const blockstore = this.getBlockstore(cid, options);
+        if (EXPORTABLE_CODECS.includes(cid.code)) {
+            const ipfsRoots = [];
+            let terminalElement;
+            const ipfsPath = toIPFSPath(url);
+            // @ts-expect-error offline is a helia option
+            for await (const entry of walkPath(ipfsPath, blockstore, {
+                ...options,
+                offline: options.onlyIfCached === true,
+                extended: options.isRawBlockRequest !== true
+            })) {
+                ipfsRoots.push(entry.cid);
+                terminalElement = entry;
+            }
+            if (terminalElement == null) {
+                throw new DoesNotExistError('No terminal element found');
+            }
+            return {
+                ipfsRoots,
+                terminalElement,
+                blockstore
+            };
+        }
+        let bytes;
+        if (cid.multihash.code === CODEC_IDENTITY) {
+            bytes = cid.multihash.digest;
+        }
+        else {
+            bytes = await toBuffer(blockstore.get(cid, options));
+        }
+        // entity codecs contain all the bytes for an entity in one block and no
+        // path walking outside of that block is possible
+        if (ENTITY_CODECS.includes(cid.code)) {
+            return {
+                ipfsRoots: [cid],
+                terminalElement: basicEntry('object', cid, bytes),
+                blockstore
+            };
+        }
+        // may be an unknown codec
+        return {
+            ipfsRoots: [cid],
+            terminalElement: basicEntry('raw', cid, bytes),
+            blockstore
         };
     }
 }
-function concatPaths(...paths) {
-    // @ts-expect-error undefined is filtered out
-    return paths
-        .filter(p => p != null && p !== '');
+function toIPFSPath(url) {
+    return `/ipfs/${url.hostname}${decodeURI(url.pathname)}`;
 }
 //# sourceMappingURL=url-resolver.js.map