@fireproof/vendor 1.0.4 → 1.1.0-dev

package/src/ipfs-unixfs-exporter/dist/src/index.d.ts

@@ -1,355 +0,0 @@
-/**
- * @packageDocumentation
- *
- * The UnixFS Exporter provides a means to read DAGs from a blockstore given a CID.
- *
- * @example
- *
- * ```js
- * // import a file and export it again
- * import { importer } from 'ipfs-unixfs-importer'
- * import { exporter } from 'ipfs-unixfs-exporter'
- * import { MemoryBlockstore } from 'blockstore-core/memory'
- *
- * // Should contain the blocks we are trying to export
- * const blockstore = new MemoryBlockstore()
- * const files = []
- *
- * for await (const file of importer([{
- *   path: '/foo/bar.txt',
- *   content: new Uint8Array([0, 1, 2, 3])
- * }], blockstore)) {
- *   files.push(file)
- * }
- *
- * console.info(files[0].cid) // Qmbaz
- *
- * const entry = await exporter(files[0].cid, blockstore)
- *
- * console.info(entry.cid) // Qmqux
- * console.info(entry.path) // Qmbaz/foo/bar.txt
- * console.info(entry.name) // bar.txt
- * console.info(entry.unixfs.fileSize()) // 4
- *
- * // stream content from unixfs node
- * const size = entry.unixfs.fileSize()
- * const bytes = new Uint8Array(size)
- * let offset = 0
- *
- * for await (const buf of entry.content()) {
- *   bytes.set(buf, offset)
- *   offset += chunk.length
- * }
- *
- * console.info(bytes) // 0, 1, 2, 3
- * ```
- */
-import { CID } from 'multiformats/cid';
-import type { PBNode } from '@ipld/dag-pb';
-import type { Bucket } from 'hamt-sharding';
-import type { Blockstore } from 'interface-blockstore';
-import type { UnixFS } from 'ipfs-unixfs';
-import type { ProgressOptions, ProgressEvent } from 'progress-events';
-export * from './errors.js';
-export interface ExportProgress {
-    /**
-     * How many bytes of the file have been read
-     */
-    bytesRead: bigint;
-    /**
-     * How many bytes of the file will be read - n.b. this may be
-     * smaller than `fileSize` if `offset`/`length` have been
-     * specified
-     */
-    totalBytes: bigint;
-    /**
-     * The size of the file being read - n.b. this may be
-     * larger than `total` if `offset`/`length` has been
-     * specified
-     */
-    fileSize: bigint;
-}
-export interface ExportWalk {
-    cid: CID;
-}
-/**
- * Progress events emitted by the exporter
- */
-export type ExporterProgressEvents = ProgressEvent<'unixfs:exporter:progress:unixfs:file', ExportProgress> | ProgressEvent<'unixfs:exporter:progress:unixfs:raw', ExportProgress> | ProgressEvent<'unixfs:exporter:progress:raw', ExportProgress> | ProgressEvent<'unixfs:exporter:progress:identity', ExportProgress> | ProgressEvent<'unixfs:exporter:walk:file', ExportWalk> | ProgressEvent<'unixfs:exporter:walk:directory', ExportWalk> | ProgressEvent<'unixfs:exporter:walk:hamt-sharded-directory', ExportWalk> | ProgressEvent<'unixfs:exporter:walk:raw', ExportWalk>;
-export interface ExporterOptions extends ProgressOptions<ExporterProgressEvents> {
-    /**
-     * An optional offset to start reading at.
-     *
-     * If the CID resolves to a file this will be a byte offset within that file,
-     * otherwise if it's a directory it will be a directory entry offset within
-     * the directory listing. (default: undefined)
-     */
-    offset?: number;
-    /**
-     * An optional length to read.
-     *
-     * If the CID resolves to a file this will be the number of bytes read from
-     * the file, otherwise if it's a directory it will be the number of directory
-     * entries read from the directory listing. (default: undefined)
-     */
-    length?: number;
-    /**
-     * This signal can be used to abort any long-lived operations such as fetching
-     * blocks from the network. (default: undefined)
-     */
-    signal?: AbortSignal;
-    /**
-     * When a DAG layer is encountered, all child nodes are loaded in parallel but
-     * processed as they arrive. This allows us to load sibling nodes in advance
-     * of yielding their bytes. Pass a value here to control the number of blocks
-     * loaded in parallel. If a strict depth-first traversal is required, this
-     * value should be set to `1`, otherwise the traversal order will tend to
-     * resemble a breadth-first fan-out and yield a have stable ordering.
-     * (default: undefined)
-     */
-    blockReadConcurrency?: number;
-}
-export interface Exportable<T> {
-    /**
-     * A disambiguator to allow TypeScript to work out the type of the entry.
-     *
-     * @example
-     *
-     * ```TypeScript
-     * if (entry.type === 'file') {
-     *   // access UnixFSFile properties safely
-     * }
-     *
-     * if (entry.type === 'directory') {
-     *   // access UnixFSDirectory properties safely
-     * }
-     * ```
-     */
-    type: 'file' | 'directory' | 'object' | 'raw' | 'identity';
-    /**
-     * The name of the entry
-     */
-    name: string;
-    /**
-     * The path of the entry within the DAG in which it was encountered
-     */
-    path: string;
-    /**
-     * The CID of the entry
-     */
-    cid: CID;
-    /**
-     * How far down the DAG the entry is
-     */
-    depth: number;
-    /**
-     * The size of the entry
-     */
-    size: bigint;
-    /**
-     * @example File content
-     *
-     * When `entry` is a file or a `raw` node, `offset` and/or `length` arguments can be passed to `entry.content()` to return slices of data:
-     *
-     * ```javascript
-     * const length = 5
-     * const data = new Uint8Array(length)
-     * let offset = 0
-     *
-     * for await (const chunk of entry.content({
-     *   offset: 0,
-     *   length
-     * })) {
-     *   data.set(chunk, offset)
-     *   offset += chunk.length
-     * }
-     *
-     * // `data` contains the first 5 bytes of the file
-     * return data
-     * ```
-     *
-     * @example Directory content
-     *
-     * If `entry` is a directory, passing `offset` and/or `length` to `entry.content()` will limit the number of files returned from the directory.
-     *
-     * ```javascript
-     * const entries = []
-     *
-     * for await (const entry of dir.content({
-     *   offset: 0,
-     *   length: 5
-     * })) {
-     *   entries.push(entry)
-     * }
-     *
-     * // `entries` contains the first 5 files/directories in the directory
-     * ```
-     */
-    content(options?: ExporterOptions): AsyncGenerator<T, void, unknown>;
-}
-/**
- * If the entry is a file, `entry.content()` returns an async iterator that yields one or more Uint8Arrays containing the file content:
- *
- * ```javascript
- * if (entry.type === 'file') {
- *   for await (const chunk of entry.content()) {
- *     // chunk is a Buffer
- *   }
- * }
- * ```
- */
-export interface UnixFSFile extends Exportable<Uint8Array> {
-    type: 'file';
-    unixfs: UnixFS;
-    node: PBNode;
-}
-/**
- * If the entry is a directory, `entry.content()` returns further `entry` objects:
- *
- * ```javascript
- * if (entry.type === 'directory') {
- *   for await (const entry of dir.content()) {
- *     console.info(entry.name)
- *   }
- * }
- * ```
- */
-export interface UnixFSDirectory extends Exportable<UnixFSEntry> {
-    type: 'directory';
-    unixfs: UnixFS;
-    node: PBNode;
-}
-/**
- * Entries with a `dag-cbor` or `dag-json` codec {@link CID} return JavaScript object entries
- */
-export interface ObjectNode extends Exportable<any> {
-    type: 'object';
-    node: Uint8Array;
-}
-/**
- * Entries with a `raw` codec {@link CID} return raw entries.
- *
- * `entry.content()` returns an async iterator that yields a buffer containing the node content:
- *
- * ```javascript
- * for await (const chunk of entry.content()) {
- *   // chunk is a Buffer
- * }
- * ```
- *
- * Unless you an options object containing `offset` and `length` keys as an argument to `entry.content()`, `chunk` will be equal to `entry.node`.
- */
-export interface RawNode extends Exportable<Uint8Array> {
-    type: 'raw';
-    node: Uint8Array;
-}
-/**
- * Entries with a `identity` codec {@link CID} return identity entries.
- *
- * These are entries where the data payload is stored in the CID itself,
- * otherwise they are identical to {@link RawNode}s.
- */
-export interface IdentityNode extends Exportable<Uint8Array> {
-    type: 'identity';
-    node: Uint8Array;
-}
-/**
- * A UnixFSEntry is a representation of the types of node that can be
- * encountered in a DAG.
- */
-export type UnixFSEntry = UnixFSFile | UnixFSDirectory | ObjectNode | RawNode | IdentityNode;
-export interface NextResult {
-    cid: CID;
-    name: string;
-    path: string;
-    toResolve: string[];
-}
-export interface ResolveResult {
-    entry: UnixFSEntry;
-    next?: NextResult;
-}
-export interface Resolve {
-    (cid: CID, name: string, path: string, toResolve: string[], depth: number, blockstore: ReadableStorage, options: ExporterOptions): Promise<ResolveResult>;
-}
-export interface Resolver {
-    (cid: CID, name: string, path: string, toResolve: string[], resolve: Resolve, depth: number, blockstore: ReadableStorage, options: ExporterOptions): Promise<ResolveResult>;
-}
-export type UnixfsV1FileContent = AsyncIterable<Uint8Array> | Iterable<Uint8Array>;
-export type UnixfsV1DirectoryContent = AsyncIterable<UnixFSEntry> | Iterable<UnixFSEntry>;
-export type UnixfsV1Content = UnixfsV1FileContent | UnixfsV1DirectoryContent;
-export interface UnixfsV1Resolver {
-    (cid: CID, node: PBNode, unixfs: UnixFS, path: string, resolve: Resolve, depth: number, blockstore: ReadableStorage): (options: ExporterOptions) => UnixfsV1Content;
-}
-export interface ShardTraversalContext {
-    hamtDepth: number;
-    rootBucket: Bucket<boolean>;
-    lastBucket: Bucket<boolean>;
-}
-/**
- * A subset of the {@link Blockstore} interface that just contains the get
- * method.
- */
-export type ReadableStorage = Pick<Blockstore, 'get'>;
-/**
- * Returns an async iterator that yields entries for all segments in a path
- *
- * @example
- *
- * ```javascript
- * import { walkPath } from 'ipfs-unixfs-exporter'
- *
- * const entries = []
- *
- * for await (const entry of walkPath('Qmfoo/foo/bar/baz.txt', blockstore)) {
- *   entries.push(entry)
- * }
- *
- * // entries contains 4x `entry` objects
- * ```
- */
-export declare function walkPath(path: string | CID, blockstore: ReadableStorage, options?: ExporterOptions): AsyncGenerator<UnixFSEntry, void, any>;
-/**
- * Uses the given blockstore instance to fetch an IPFS node by a CID or path.
- *
- * Returns a {@link Promise} which resolves to a {@link UnixFSEntry}.
- *
- * @example
- *
- * ```typescript
- * import { exporter } from 'ipfs-unixfs-exporter'
- * import { CID } from 'multiformats/cid'
- *
- * const cid = CID.parse('QmFoo')
- *
- * const entry = await exporter(cid, blockstore, {
- *   signal: AbortSignal.timeout(50000)
- * })
- *
- * if (entry.type === 'file') {
- *   for await (const chunk of entry.content()) {
- *     // chunk is a Uint8Array
- *   }
- * }
- * ```
- */
-export declare function exporter(path: string | CID, blockstore: ReadableStorage, options?: ExporterOptions): Promise<UnixFSEntry>;
-/**
- * Returns an async iterator that yields all entries beneath a given CID or IPFS
- * path, as well as the containing directory.
- *
- * @example
- *
- * ```typescript
- * import { recursive } from 'ipfs-unixfs-exporter'
- *
- * const entries = []
- *
- * for await (const child of recursive('Qmfoo/foo/bar', blockstore)) {
- *   entries.push(entry)
- * }
- *
- * // entries contains all children of the `Qmfoo/foo/bar` directory and it's children
- * ```
- */
-export declare function recursive(path: string | CID, blockstore: ReadableStorage, options?: ExporterOptions): AsyncGenerator<UnixFSEntry, void, any>;
-//# sourceMappingURL=index.d.ts.map

package/src/ipfs-unixfs-exporter/dist/src/index.d.ts.map

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

package/src/ipfs-unixfs-exporter/dist/src/index.js

@@ -1,197 +0,0 @@
-/**
- * @packageDocumentation
- *
- * The UnixFS Exporter provides a means to read DAGs from a blockstore given a CID.
- *
- * @example
- *
- * ```js
- * // import a file and export it again
- * import { importer } from 'ipfs-unixfs-importer'
- * import { exporter } from 'ipfs-unixfs-exporter'
- * import { MemoryBlockstore } from 'blockstore-core/memory'
- *
- * // Should contain the blocks we are trying to export
- * const blockstore = new MemoryBlockstore()
- * const files = []
- *
- * for await (const file of importer([{
- *   path: '/foo/bar.txt',
- *   content: new Uint8Array([0, 1, 2, 3])
- * }], blockstore)) {
- *   files.push(file)
- * }
- *
- * console.info(files[0].cid) // Qmbaz
- *
- * const entry = await exporter(files[0].cid, blockstore)
- *
- * console.info(entry.cid) // Qmqux
- * console.info(entry.path) // Qmbaz/foo/bar.txt
- * console.info(entry.name) // bar.txt
- * console.info(entry.unixfs.fileSize()) // 4
- *
- * // stream content from unixfs node
- * const size = entry.unixfs.fileSize()
- * const bytes = new Uint8Array(size)
- * let offset = 0
- *
- * for await (const buf of entry.content()) {
- *   bytes.set(buf, offset)
- *   offset += chunk.length
- * }
- *
- * console.info(bytes) // 0, 1, 2, 3
- * ```
- */
-import last from 'it-last';
-import { CID } from 'multiformats/cid';
-import { BadPathError, NotFoundError } from './errors.js';
-import resolve from './resolvers/index.js';
-export * from './errors.js';
-const toPathComponents = (path = '') => {
-    // split on / unless escaped with \
-    return (path
-        .trim()
-        .match(/([^\\^/]|\\\/)+/g) ?? [])
-        .filter(Boolean);
-};
-const cidAndRest = (path) => {
-    if (path instanceof Uint8Array) {
-        return {
-            cid: CID.decode(path),
-            toResolve: []
-        };
-    }
-    const cid = CID.asCID(path);
-    if (cid != null) {
-        return {
-            cid,
-            toResolve: []
-        };
-    }
-    if (typeof path === 'string') {
-        if (path.indexOf('/ipfs/') === 0) {
-            path = path.substring(6);
-        }
-        const output = toPathComponents(path);
-        return {
-            cid: CID.parse(output[0]),
-            toResolve: output.slice(1)
-        };
-    }
-    throw new BadPathError(`Unknown path type ${path}`);
-};
-/**
- * Returns an async iterator that yields entries for all segments in a path
- *
- * @example
- *
- * ```javascript
- * import { walkPath } from 'ipfs-unixfs-exporter'
- *
- * const entries = []
- *
- * for await (const entry of walkPath('Qmfoo/foo/bar/baz.txt', blockstore)) {
- *   entries.push(entry)
- * }
- *
- * // entries contains 4x `entry` objects
- * ```
- */
-export async function* walkPath(path, blockstore, options = {}) {
-    let { cid, toResolve } = cidAndRest(path);
-    let name = cid.toString();
-    let entryPath = name;
-    const startingDepth = toResolve.length;
-    while (true) {
-        const result = await resolve(cid, name, entryPath, toResolve, startingDepth, blockstore, options);
-        if (result.entry == null && result.next == null) {
-            throw new NotFoundError(`Could not resolve ${path}`);
-        }
-        if (result.entry != null) {
-            yield result.entry;
-        }
-        if (result.next == null) {
-            return;
-        }
-        // resolve further parts
-        toResolve = result.next.toResolve;
-        cid = result.next.cid;
-        name = result.next.name;
-        entryPath = result.next.path;
-    }
-}
-/**
- * Uses the given blockstore instance to fetch an IPFS node by a CID or path.
- *
- * Returns a {@link Promise} which resolves to a {@link UnixFSEntry}.
- *
- * @example
- *
- * ```typescript
- * import { exporter } from 'ipfs-unixfs-exporter'
- * import { CID } from 'multiformats/cid'
- *
- * const cid = CID.parse('QmFoo')
- *
- * const entry = await exporter(cid, blockstore, {
- *   signal: AbortSignal.timeout(50000)
- * })
- *
- * if (entry.type === 'file') {
- *   for await (const chunk of entry.content()) {
- *     // chunk is a Uint8Array
- *   }
- * }
- * ```
- */
-export async function exporter(path, blockstore, options = {}) {
-    const result = await last(walkPath(path, blockstore, options));
-    if (result == null) {
-        throw new NotFoundError(`Could not resolve ${path}`);
-    }
-    return result;
-}
-/**
- * Returns an async iterator that yields all entries beneath a given CID or IPFS
- * path, as well as the containing directory.
- *
- * @example
- *
- * ```typescript
- * import { recursive } from 'ipfs-unixfs-exporter'
- *
- * const entries = []
- *
- * for await (const child of recursive('Qmfoo/foo/bar', blockstore)) {
- *   entries.push(entry)
- * }
- *
- * // entries contains all children of the `Qmfoo/foo/bar` directory and it's children
- * ```
- */
-export async function* recursive(path, blockstore, options = {}) {
-    const node = await exporter(path, blockstore, options);
-    if (node == null) {
-        return;
-    }
-    yield node;
-    if (node.type === 'directory') {
-        for await (const child of recurse(node, options)) {
-            yield child;
-        }
-    }
-    async function* recurse(node, options) {
-        for await (const file of node.content(options)) {
-            yield file;
-            if (file instanceof Uint8Array) {
-                continue;
-            }
-            if (file.type === 'directory') {
-                yield* recurse(file, options);
-            }
-        }
-    }
-}
-//# sourceMappingURL=index.js.map

package/src/ipfs-unixfs-exporter/dist/src/index.js.map

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

package/src/ipfs-unixfs-exporter/dist/src/resolvers/dag-cbor.d.ts

@@ -1,4 +0,0 @@
-import type { Resolver } from '../index.js';
-declare const resolve: Resolver;
-export default resolve;
-//# sourceMappingURL=dag-cbor.d.ts.map

package/src/ipfs-unixfs-exporter/dist/src/resolvers/dag-cbor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dag-cbor.d.ts","sourceRoot":"","sources":["../../../src/resolvers/dag-cbor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,QAAA,MAAM,OAAO,EAAE,QAKd,CAAA;AAED,eAAe,OAAO,CAAA"}

package/src/ipfs-unixfs-exporter/dist/src/resolvers/dag-cbor.js

@@ -1,9 +0,0 @@
-import * as dagCbor from "@fireproof/vendor/@ipld/dag-cbor";
-import { resolveObjectPath } from '../utils/resolve-object-path.js';
-const resolve = async (cid, name, path, toResolve, resolve, depth, blockstore, options) => {
-    const block = await blockstore.get(cid, options);
-    const object = dagCbor.decode(block);
-    return resolveObjectPath(object, block, cid, name, path, toResolve, depth);
-};
-export default resolve;
-//# sourceMappingURL=dag-cbor.js.map

package/src/ipfs-unixfs-exporter/dist/src/resolvers/dag-cbor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dag-cbor.js","sourceRoot":"","sources":["../../../src/resolvers/dag-cbor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAGnE,MAAM,OAAO,GAAa,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE;IAClG,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAM,KAAK,CAAC,CAAA;IAEzC,OAAO,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAA;AAC5E,CAAC,CAAA;AAED,eAAe,OAAO,CAAA"}

package/src/ipfs-unixfs-exporter/dist/src/resolvers/dag-json.d.ts

@@ -1,4 +0,0 @@
-import type { Resolver } from '../index.js';
-declare const resolve: Resolver;
-export default resolve;
-//# sourceMappingURL=dag-json.d.ts.map

package/src/ipfs-unixfs-exporter/dist/src/resolvers/dag-json.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dag-json.d.ts","sourceRoot":"","sources":["../../../src/resolvers/dag-json.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,QAAA,MAAM,OAAO,EAAE,QAKd,CAAA;AAED,eAAe,OAAO,CAAA"}

package/src/ipfs-unixfs-exporter/dist/src/resolvers/dag-json.js

@@ -1,9 +0,0 @@
-import * as dagJson from "@fireproof/vendor/@ipld/dag-json";
-import { resolveObjectPath } from '../utils/resolve-object-path.js';
-const resolve = async (cid, name, path, toResolve, resolve, depth, blockstore, options) => {
-    const block = await blockstore.get(cid, options);
-    const object = dagJson.decode(block);
-    return resolveObjectPath(object, block, cid, name, path, toResolve, depth);
-};
-export default resolve;
-//# sourceMappingURL=dag-json.js.map

package/src/ipfs-unixfs-exporter/dist/src/resolvers/dag-json.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dag-json.js","sourceRoot":"","sources":["../../../src/resolvers/dag-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAGnE,MAAM,OAAO,GAAa,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE;IAClG,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAM,KAAK,CAAC,CAAA;IAEzC,OAAO,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAA;AAC5E,CAAC,CAAA;AAED,eAAe,OAAO,CAAA"}

package/src/ipfs-unixfs-exporter/dist/src/resolvers/identity.d.ts

@@ -1,4 +0,0 @@
-import type { Resolver } from '../index.js';
-declare const resolve: Resolver;
-export default resolve;
-//# sourceMappingURL=identity.d.ts.map

package/src/ipfs-unixfs-exporter/dist/src/resolvers/identity.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/resolvers/identity.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAmB,QAAQ,EAAkB,MAAM,aAAa,CAAA;AAuB5E,QAAA,MAAM,OAAO,EAAE,QAkBd,CAAA;AAED,eAAe,OAAO,CAAA"}

package/src/ipfs-unixfs-exporter/dist/src/resolvers/identity.js

@@ -1,38 +0,0 @@
-import * as mh from 'multiformats/hashes/digest';
-import { CustomProgressEvent } from 'progress-events';
-import { NotFoundError } from '../errors.js';
-import extractDataFromBlock from '../utils/extract-data-from-block.js';
-import validateOffsetAndLength from '../utils/validate-offset-and-length.js';
-const rawContent = (node) => {
-    async function* contentGenerator(options = {}) {
-        const { start, end } = validateOffsetAndLength(node.length, options.offset, options.length);
-        const buf = extractDataFromBlock(node, 0n, start, end);
-        options.onProgress?.(new CustomProgressEvent('unixfs:exporter:progress:identity', {
-            bytesRead: BigInt(buf.byteLength),
-            totalBytes: end - start,
-            fileSize: BigInt(node.byteLength)
-        }));
-        yield buf;
-    }
-    return contentGenerator;
-};
-const resolve = async (cid, name, path, toResolve, resolve, depth, blockstore, options) => {
-    if (toResolve.length > 0) {
-        throw new NotFoundError(`No link named ${path} found in raw node ${cid}`);
-    }
-    const buf = mh.decode(cid.multihash.bytes);
-    return {
-        entry: {
-            type: 'identity',
-            name,
-            path,
-            cid,
-            content: rawContent(buf.digest),
-            depth,
-            size: BigInt(buf.digest.length),
-            node: buf.digest
-        }
-    };
-};
-export default resolve;
-//# sourceMappingURL=identity.js.map

package/src/ipfs-unixfs-exporter/dist/src/resolvers/identity.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/resolvers/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,oBAAoB,MAAM,qCAAqC,CAAA;AACtE,OAAO,uBAAuB,MAAM,wCAAwC,CAAA;AAG5E,MAAM,UAAU,GAAG,CAAC,IAAgB,EAAgF,EAAE;IACpH,KAAK,SAAU,CAAC,CAAC,gBAAgB,CAAE,UAA2B,EAAE;QAC9D,MAAM,EACJ,KAAK,EACL,GAAG,EACJ,GAAG,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;QAExE,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;QAEtD,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,mBAAmB,CAAiB,mCAAmC,EAAE;YAChG,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;YACjC,UAAU,EAAE,GAAG,GAAG,KAAK;YACvB,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;SAClC,CAAC,CAAC,CAAA;QAEH,MAAM,GAAG,CAAA;IACX,CAAC;IAED,OAAO,gBAAgB,CAAA;AACzB,CAAC,CAAA;AAED,MAAM,OAAO,GAAa,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE;IAClG,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,aAAa,CAAC,iBAAiB,IAAI,sBAAsB,GAAG,EAAE,CAAC,CAAA;IAC3E,CAAC;IACD,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAE1C,OAAO;QACL,KAAK,EAAE;YACL,IAAI,EAAE,UAAU;YAChB,IAAI;YACJ,IAAI;YACJ,GAAG;YACH,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;YAC/B,KAAK;YACL,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;YAC/B,IAAI,EAAE,GAAG,CAAC,MAAM;SACjB;KACF,CAAA;AACH,CAAC,CAAA;AAED,eAAe,OAAO,CAAA"}

package/src/ipfs-unixfs-exporter/dist/src/resolvers/index.d.ts

@@ -1,4 +0,0 @@
-import type { Resolve } from '../index.js';
-declare const resolve: Resolve;
-export default resolve;
-//# sourceMappingURL=index.d.ts.map

package/src/ipfs-unixfs-exporter/dist/src/resolvers/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resolvers/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,aAAa,CAAA;AAWpD,QAAA,MAAM,OAAO,EAAE,OAQd,CAAA;AAED,eAAe,OAAO,CAAA"}