@helia/mfs 0.0.0

package/dist/src/index.d.ts

@@ -0,0 +1,225 @@
+/**
+ * @packageDocumentation
+ *
+ * `@helia/mfs` is an implementation of a {@link https://docs.ipfs.tech/concepts/file-systems/ Mutable File System} powered by {@link https://github.com/ipfs/helia Helia}.
+ *
+ * See the {@link MFS MFS interface} for all available operations.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { createHelia } from 'helia'
+ * import { mfs } from '@helia/mfs'
+ *
+ * const helia = createHelia({
+ *   // ... helia config
+ * })
+ * const fs = mfs(helia)
+ *
+ * // create an empty directory
+ * await fs.mkdir('/my-directory')
+ *
+ * // add a file to the directory
+ * await fs.writeBytes(Uint8Array.from([0, 1, 2, 3]), '/my-directory/foo.txt')
+ *
+ * // read the file
+ * for await (const buf of fs.cat('/my-directory/foo.txt')) {
+ *   console.info(buf)
+ * }
+ * ```
+ */
+import { CID } from 'multiformats/cid';
+import type { Blocks } from '@helia/interface/blocks';
+import type { UnixFSEntry } from 'ipfs-unixfs-exporter';
+import type { Datastore } from 'interface-datastore';
+import type { AddOptions, CatOptions, ChmodOptions, CpOptions, LsOptions, MkdirOptions as UnixFsMkdirOptions, RmOptions as UnixFsRmOptions, StatOptions, TouchOptions, UnixFSStats } from '@helia/unixfs';
+import type { ByteStream } from 'ipfs-unixfs-importer';
+import { type Mtime } from 'ipfs-unixfs';
+export interface MFSComponents {
+    blockstore: Blocks;
+    datastore: Datastore;
+}
+export interface MFSInit {
+    /**
+     * The key used to store the root CID in the datastore (default: '/local/filesroot')
+     */
+    key?: string;
+}
+export type WriteOptions = AddOptions & CpOptions & {
+    /**
+     * An optional mode to set on the new file
+     */
+    mode: number;
+    /**
+     * An optional mtime to set on the new file
+     */
+    mtime: Mtime;
+};
+export type MkdirOptions = AddOptions & StatOptions & CpOptions & UnixFsMkdirOptions;
+/**
+ * Options to pass to the rm command
+ */
+export interface RmOptions extends UnixFsRmOptions {
+    /**
+     * If true, allow attempts to delete files or directories that do not exist
+     * (default: false)
+     */
+    force: boolean;
+}
+/**
+ * The UnixFS interface provides familiar filesystem operations to make working with
+ * UnixFS DAGs simple and intuitive.
+ */
+export interface MFS {
+    /**
+     * Add a single `Uint8Array` to your Helia node as a file.
+     *
+     * @example
+     *
+     * ```typescript
+     * const cid = await fs.addBytes(Uint8Array.from([0, 1, 2, 3]))
+     *
+     * console.info(cid)
+     * ```
+     */
+    writeBytes: (bytes: Uint8Array, path: string, options?: Partial<WriteOptions>) => Promise<void>;
+    /**
+     * Add a stream of `Uint8Array` to your Helia node as a file.
+     *
+     * @example
+     *
+     * ```typescript
+     * import fs from 'node:fs'
+     *
+     * const stream = fs.createReadStream('./foo.txt')
+     * const cid = await fs.addByteStream(stream)
+     *
+     * console.info(cid)
+     * ```
+     */
+    writeByteStream: (bytes: ByteStream, path: string, options?: Partial<WriteOptions>) => Promise<void>;
+    /**
+     * Retrieve the contents of a file from your Helia node.
+     *
+     * @example
+     *
+     * ```typescript
+     * for await (const buf of fs.cat(cid)) {
+     *   console.info(buf)
+     * }
+     * ```
+     */
+    cat: (path: string, options?: Partial<CatOptions>) => AsyncIterable<Uint8Array>;
+    /**
+     * Change the permissions on a file or directory in a DAG
+     *
+     * @example
+     *
+     * ```typescript
+     * const beforeCid = await fs.addBytes(Uint8Array.from([0, 1, 2, 3]))
+     * const beforeStats = await fs.stat(beforeCid)
+     *
+     * const afterCid = await fs.chmod(cid, 0x755)
+     * const afterStats = await fs.stat(afterCid)
+     *
+     * console.info(beforeCid, beforeStats)
+     * console.info(afterCid, afterStats)
+     * ```
+     */
+    chmod: (path: string, mode: number, options?: Partial<ChmodOptions>) => Promise<void>;
+    /**
+     * Add a file or directory to a target directory.
+     *
+     * @example
+     *
+     * ```typescript
+     * const fileCid = await fs.addBytes(Uint8Array.from([0, 1, 2, 3]))
+     * const directoryCid = await fs.addDirectory()
+     *
+     * const updatedCid = await fs.cp(fileCid, directoryCid, 'foo.txt')
+     *
+     * console.info(updatedCid)
+     * ```
+     */
+    cp: (source: CID | string, destination: string, options?: Partial<CpOptions>) => Promise<void>;
+    /**
+     * List directory contents.
+     *
+     * @example
+     *
+     * ```typescript
+     * for await (const entry of fs.ls(directoryCid)) {
+     *   console.info(etnry)
+     * }
+     * ```
+     */
+    ls: (path?: string, options?: Partial<LsOptions>) => AsyncIterable<UnixFSEntry>;
+    /**
+     * Make a new directory under an existing directory.
+     *
+     * @example
+     *
+     * ```typescript
+     * const directoryCid = await fs.addDirectory()
+     *
+     * const updatedCid = await fs.mkdir(directoryCid, 'new-dir')
+     *
+     * console.info(updatedCid)
+     * ```
+     */
+    mkdir: (path: string, options?: Partial<MkdirOptions>) => Promise<void>;
+    /**
+     * Remove a file or directory from an existing directory.
+     *
+     * @example
+     *
+     * ```typescript
+     * const directoryCid = await fs.addDirectory()
+     * const updatedCid = await fs.mkdir(directoryCid, 'new-dir')
+     *
+     * const finalCid = await fs.rm(updatedCid, 'new-dir')
+     *
+     * console.info(finalCid)
+     * ```
+     */
+    rm: (path: string, options?: Partial<RmOptions>) => Promise<void>;
+    /**
+     * Return statistics about a UnixFS DAG.
+     *
+     * @example
+     *
+     * ```typescript
+     * const fileCid = await fs.addBytes(Uint8Array.from([0, 1, 2, 3]))
+     *
+     * const stats = await fs.stat(fileCid)
+     *
+     * console.info(stats)
+     * ```
+     */
+    stat: (path: string, options?: Partial<StatOptions>) => Promise<UnixFSStats>;
+    /**
+     * Update the mtime of a UnixFS DAG
+     *
+     * @example
+     *
+     * ```typescript
+     * const beforeCid = await fs.addBytes(Uint8Array.from([0, 1, 2, 3]))
+     * const beforeStats = await fs.stat(beforeCid)
+     *
+     * const afterCid = await fs.touch(beforeCid)
+     * const afterStats = await fs.stat(afterCid)
+     *
+     * console.info(beforeCid, beforeStats)
+     * console.info(afterCid, afterStats)
+     * ```
+     */
+    touch: (path: string, options?: Partial<TouchOptions>) => Promise<void>;
+}
+/**
+ * Create a {@link MFS} instance powered by {@link https://github.com/ipfs/helia Helia}
+ */
+export declare function mfs(helia: {
+    blockstore: Blocks;
+    datastore: Datastore;
+}, init?: MFSInit): MFS;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/index.js

@@ -0,0 +1,312 @@
+/**
+ * @packageDocumentation
+ *
+ * `@helia/mfs` is an implementation of a {@link https://docs.ipfs.tech/concepts/file-systems/ Mutable File System} powered by {@link https://github.com/ipfs/helia Helia}.
+ *
+ * See the {@link MFS MFS interface} for all available operations.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { createHelia } from 'helia'
+ * import { mfs } from '@helia/mfs'
+ *
+ * const helia = createHelia({
+ *   // ... helia config
+ * })
+ * const fs = mfs(helia)
+ *
+ * // create an empty directory
+ * await fs.mkdir('/my-directory')
+ *
+ * // add a file to the directory
+ * await fs.writeBytes(Uint8Array.from([0, 1, 2, 3]), '/my-directory/foo.txt')
+ *
+ * // read the file
+ * for await (const buf of fs.cat('/my-directory/foo.txt')) {
+ *   console.info(buf)
+ * }
+ * ```
+ */
+import { Key } from 'interface-datastore';
+import { CID } from 'multiformats/cid';
+import { unixfs } from '@helia/unixfs';
+import { AlreadyExistsError, DoesNotExistError, InvalidParametersError, NotADirectoryError } from '@helia/unixfs/errors';
+import { logger } from '@libp2p/logger';
+import { basename } from './utils/basename.js';
+import { UnixFS as IPFSUnixFS } from 'ipfs-unixfs';
+const log = logger('helia:mfs');
+class DefaultMFS {
+    components;
+    unixfs;
+    root;
+    key;
+    constructor(components, init = {}) {
+        this.components = components;
+        this.key = new Key(init.key ?? '/locals/filesroot');
+        this.unixfs = unixfs(components);
+    }
+    async #getRootCID() {
+        if (this.root == null) {
+            try {
+                const buf = await this.components.datastore.get(this.key);
+                this.root = CID.decode(buf);
+            }
+            catch (err) {
+                if (err.code !== 'ERR_NOT_FOUND') {
+                    throw err;
+                }
+                this.root = await this.unixfs.addDirectory();
+            }
+        }
+        return this.root;
+    }
+    async writeBytes(bytes, path, options) {
+        const cid = await this.unixfs.addFile({
+            content: bytes,
+            mode: options?.mode,
+            mtime: options?.mtime,
+        }, options);
+        await this.cp(cid, path, options);
+    }
+    async writeByteStream(bytes, path, options) {
+        const cid = await this.unixfs.addFile({
+            content: bytes,
+            mode: options?.mode,
+            mtime: options?.mtime,
+        }, options);
+        await this.cp(cid, path, options);
+    }
+    async *cat(path, options = {}) {
+        const root = await this.#getRootCID();
+        const trail = await this.#walkPath(root, path, {
+            ...options,
+            createMissingDirectories: false,
+            finalSegmentMustBeDirectory: false
+        });
+        yield* this.unixfs.cat(trail[trail.length - 1].cid, options);
+    }
+    async chmod(path, mode, options = {}) {
+        const root = await this.#getRootCID();
+        this.root = await this.unixfs.chmod(root, mode, {
+            ...options,
+            path
+        });
+    }
+    async cp(source, destination, options) {
+        const root = await this.#getRootCID();
+        const force = options?.force ?? false;
+        if (typeof source === 'string') {
+            const stat = await this.stat(source, options);
+            source = stat.cid;
+        }
+        if (!force) {
+            await this.#ensurePathDoesNotExist(destination, options);
+        }
+        const fileName = basename(destination);
+        const containingDirectory = destination.substring(0, destination.length - `/${fileName}`.length);
+        let trail = [{
+                cid: root,
+                name: ''
+            }];
+        if (containingDirectory !== '') {
+            trail = await this.#walkPath(root, containingDirectory, {
+                ...options,
+                createMissingDirectories: options?.force ?? false,
+                finalSegmentMustBeDirectory: true
+            });
+        }
+        trail.push({
+            cid: source,
+            name: fileName
+        });
+        this.root = await this.#persistPath(trail, options);
+    }
+    async *ls(path, options) {
+        const root = await this.#getRootCID();
+        if (options?.path != null) {
+            path = `${path}/${options.path}`;
+        }
+        yield* this.unixfs.ls(root, {
+            ...options,
+            path
+        });
+    }
+    async mkdir(path, options) {
+        const force = options?.force ?? false;
+        if (!force) {
+            await this.#ensurePathDoesNotExist(path, options);
+        }
+        const dirName = basename(path);
+        const containingDirectory = path.substring(0, path.length - `/${dirName}`.length);
+        const root = await this.#getRootCID();
+        let trail = [{
+                cid: root,
+                name: ''
+            }];
+        if (containingDirectory !== '') {
+            trail = await this.#walkPath(root, containingDirectory, {
+                ...options,
+                createMissingDirectories: force,
+                finalSegmentMustBeDirectory: true
+            });
+        }
+        trail.push({
+            cid: await this.unixfs.addDirectory({
+                mode: options?.mode,
+                mtime: options?.mtime
+            }, options),
+            name: basename(path)
+        });
+        this.root = await this.#persistPath(trail, options);
+    }
+    async rm(path, options) {
+        const force = options?.force ?? false;
+        if (!force) {
+            await this.#ensurePathExists(path, options);
+        }
+        const root = await this.#getRootCID();
+        const trail = await this.#walkPath(root, path, {
+            ...options,
+            createMissingDirectories: false,
+            finalSegmentMustBeDirectory: false
+        });
+        const lastSegment = trail.pop();
+        if (lastSegment == null) {
+            throw new InvalidParametersError('path was too short');
+        }
+        // remove directory entry
+        const containingDir = trail[trail.length - 1];
+        containingDir.cid = await this.unixfs.rm(containingDir.cid, lastSegment.name, options);
+        this.root = await this.#persistPath(trail, options);
+    }
+    async stat(path, options) {
+        const root = await this.#getRootCID();
+        const trail = await this.#walkPath(root, path, {
+            ...options,
+            createMissingDirectories: false,
+            finalSegmentMustBeDirectory: false
+        });
+        const finalEntry = trail.pop();
+        if (finalEntry == null) {
+            throw new DoesNotExistError();
+        }
+        return this.unixfs.stat(finalEntry.cid, {
+            ...options
+        });
+    }
+    async touch(path, options) {
+        const root = await this.#getRootCID();
+        const trail = await this.#walkPath(root, path, {
+            ...options,
+            createMissingDirectories: false,
+            finalSegmentMustBeDirectory: false
+        });
+        let finalEntry = trail[trail.length - 1];
+        if (finalEntry == null) {
+            throw new DoesNotExistError();
+        }
+        finalEntry.cid = await this.unixfs.touch(finalEntry.cid, options);
+        this.root = await this.#persistPath(trail, options);
+    }
+    async #walkPath(root, path, opts) {
+        if (!path.startsWith('/')) {
+            throw new InvalidParametersError('path must be absolute');
+        }
+        const stat = await this.unixfs.stat(root, {
+            ...opts,
+            offline: true
+        });
+        let output = [{
+                cid: root,
+                name: '',
+                unixfs: stat.unixfs
+            }];
+        let cid = root;
+        let parts = path.split('/').filter(Boolean);
+        for (let i = 0; i < parts.length; i++) {
+            const segment = parts[i];
+            try {
+                const stat = await this.unixfs.stat(cid, {
+                    ...opts,
+                    offline: true,
+                    path: segment
+                });
+                output.push({
+                    cid: stat.cid,
+                    name: segment,
+                    unixfs: stat.unixfs
+                });
+                cid = stat.cid;
+            }
+            catch (err) {
+                log.error('could not resolve path segment %s of %s under %c', segment, path, root);
+                if (opts.createMissingDirectories) {
+                    const cid = await this.unixfs.addDirectory();
+                    output.push({
+                        cid: cid,
+                        name: segment,
+                        unixfs: new IPFSUnixFS({ type: 'directory' })
+                    });
+                }
+                else {
+                    throw new DoesNotExistError(`${path} does not exist`);
+                }
+            }
+        }
+        const lastSegment = output[output.length - 1];
+        if (opts.finalSegmentMustBeDirectory === true && lastSegment.unixfs?.isDirectory() !== true) {
+            throw new NotADirectoryError(`${path} was not a directory`);
+        }
+        return output;
+    }
+    async #persistPath(path, options = {}) {
+        let child = path.pop();
+        if (child == null) {
+            throw new InvalidParametersError('path was too short');
+        }
+        let cid = child.cid;
+        for (let i = path.length - 1; i > -1; i--) {
+            const segment = path[i];
+            segment.cid = await this.unixfs.cp(child.cid, segment.cid, child.name, {
+                ...options,
+                force: true
+            });
+            child = segment;
+            cid = segment.cid;
+        }
+        await this.components.datastore.put(this.key, cid.bytes, options);
+        return cid;
+    }
+    async #ensurePathExists(path, options = {}) {
+        const exists = await this.#pathExists(path, options);
+        if (!exists) {
+            throw new DoesNotExistError();
+        }
+    }
+    async #ensurePathDoesNotExist(path, options = {}) {
+        const exists = await this.#pathExists(path, options);
+        if (exists) {
+            throw new AlreadyExistsError();
+        }
+    }
+    async #pathExists(path, options = {}) {
+        try {
+            await this.stat(path, {
+                ...options,
+                offline: true
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Create a {@link MFS} instance powered by {@link https://github.com/ipfs/helia Helia}
+ */
+export function mfs(helia, init = {}) {
+    return new DefaultMFS(helia, init);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

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

@@ -0,0 +1,2 @@
+export declare function basename(path: string): string;
+//# sourceMappingURL=basename.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"basename.d.ts","sourceRoot":"","sources":["../../../src/utils/basename.ts"],"names":[],"mappings":"AACA,wBAAgB,QAAQ,CAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/src/utils/basename.js

@@ -0,0 +1,4 @@
+export function basename(path) {
+    return path.split('/').pop() ?? '';
+}
+//# sourceMappingURL=basename.js.map

package/dist/src/utils/basename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basename.js","sourceRoot":"","sources":["../../../src/utils/basename.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,QAAQ,CAAE,IAAY;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAA;AACpC,CAAC"}

package/dist/typedoc-urls.json

@@ -0,0 +1,9 @@
+{
+  "MFS": "https://ipfs.github.io/helia-mfs/interfaces/MFS.html",
+  "MFSComponents": "https://ipfs.github.io/helia-mfs/interfaces/MFSComponents.html",
+  "MFSInit": "https://ipfs.github.io/helia-mfs/interfaces/MFSInit.html",
+  "RmOptions": "https://ipfs.github.io/helia-mfs/interfaces/RmOptions.html",
+  "MkdirOptions": "https://ipfs.github.io/helia-mfs/types/MkdirOptions.html",
+  "WriteOptions": "https://ipfs.github.io/helia-mfs/types/WriteOptions.html",
+  "mfs": "https://ipfs.github.io/helia-mfs/functions/mfs-1.html"
+}