@helia/unixfs 0.0.0

package/dist/src/index.js

@@ -0,0 +1,48 @@
+import { add, addStream } from './commands/add.js';
+import { cat } from './commands/cat.js';
+import { mkdir } from './commands/mkdir.js';
+import { cp } from './commands/cp.js';
+import { rm } from './commands/rm.js';
+import { stat } from './commands/stat.js';
+import { touch } from './commands/touch.js';
+import { chmod } from './commands/chmod.js';
+import { ls } from './commands/ls.js';
+class DefaultUnixFS {
+    constructor(components) {
+        this.components = components;
+    }
+    async add(source, options = {}) {
+        return await add(source, this.components.blockstore, options);
+    }
+    async *addStream(source, options = {}) {
+        yield* addStream(source, this.components.blockstore, options);
+    }
+    async *cat(cid, options = {}) {
+        yield* cat(cid, this.components.blockstore, options);
+    }
+    async chmod(source, mode, options = {}) {
+        return await chmod(source, mode, this.components.blockstore, options);
+    }
+    async cp(source, target, name, options = {}) {
+        return await cp(source, target, name, this.components.blockstore, options);
+    }
+    async *ls(cid, options = {}) {
+        yield* ls(cid, this.components.blockstore, options);
+    }
+    async mkdir(cid, dirname, options = {}) {
+        return await mkdir(cid, dirname, this.components.blockstore, options);
+    }
+    async rm(cid, path, options = {}) {
+        return await rm(cid, path, this.components.blockstore, options);
+    }
+    async stat(cid, options = {}) {
+        return await stat(cid, this.components.blockstore, options);
+    }
+    async touch(cid, options = {}) {
+        return await touch(cid, this.components.blockstore, options);
+    }
+}
+export function unixfs(helia) {
+    return new DefaultUnixFS(helia);
+}
+//# 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/package.json

@@ -0,0 +1,166 @@
+{
+  "name": "@helia/unixfs",
+  "version": "0.0.0",
+  "description": "A Helia-compatible wrapper for UnixFS",
+  "license": "Apache-2.0 OR MIT",
+  "homepage": "https://github.com/ipfs/helia/tree/master/packages/unixfs#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ipfs/helia.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ipfs/helia/issues"
+  },
+  "keywords": [
+    "IPFS"
+  ],
+  "engines": {
+    "node": ">=16.0.0",
+    "npm": ">=7.0.0"
+  },
+  "type": "module",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "src",
+    "dist",
+    "!dist/test",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "eslintConfig": {
+    "extends": "ipfs",
+    "parserOptions": {
+      "sourceType": "module"
+    }
+  },
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      [
+        "@semantic-release/commit-analyzer",
+        {
+          "preset": "conventionalcommits",
+          "releaseRules": [
+            {
+              "breaking": true,
+              "release": "major"
+            },
+            {
+              "revert": true,
+              "release": "patch"
+            },
+            {
+              "type": "feat",
+              "release": "minor"
+            },
+            {
+              "type": "fix",
+              "release": "patch"
+            },
+            {
+              "type": "docs",
+              "release": "patch"
+            },
+            {
+              "type": "test",
+              "release": "patch"
+            },
+            {
+              "type": "deps",
+              "release": "patch"
+            },
+            {
+              "scope": "no-release",
+              "release": false
+            }
+          ]
+        }
+      ],
+      [
+        "@semantic-release/release-notes-generator",
+        {
+          "preset": "conventionalcommits",
+          "presetConfig": {
+            "types": [
+              {
+                "type": "feat",
+                "section": "Features"
+              },
+              {
+                "type": "fix",
+                "section": "Bug Fixes"
+              },
+              {
+                "type": "chore",
+                "section": "Trivial Changes"
+              },
+              {
+                "type": "docs",
+                "section": "Documentation"
+              },
+              {
+                "type": "deps",
+                "section": "Dependencies"
+              },
+              {
+                "type": "test",
+                "section": "Tests"
+              }
+            ]
+          }
+        }
+      ],
+      "@semantic-release/changelog",
+      "@semantic-release/npm",
+      "@semantic-release/github",
+      "@semantic-release/git"
+    ]
+  },
+  "scripts": {
+    "clean": "aegir clean",
+    "lint": "aegir lint",
+    "dep-check": "aegir dep-check",
+    "build": "aegir build",
+    "docs": "aegir docs",
+    "test": "aegir test",
+    "test:chrome": "aegir test -t browser --cov",
+    "test:chrome-webworker": "aegir test -t webworker",
+    "test:firefox": "aegir test -t browser -- --browser firefox",
+    "test:firefox-webworker": "aegir test -t webworker -- --browser firefox",
+    "test:node": "aegir test -t node --cov",
+    "test:electron-main": "aegir test -t electron-main",
+    "release": "aegir release"
+  },
+  "dependencies": {
+    "@helia/interface": "next",
+    "@ipld/dag-pb": "^4.0.0",
+    "@libp2p/interfaces": "^3.3.1",
+    "@libp2p/logger": "^2.0.5",
+    "@multiformats/murmur3": "^2.1.2",
+    "hamt-sharding": "^3.0.2",
+    "interface-blockstore": "^4.0.1",
+    "ipfs-unixfs": "^9.0.0",
+    "ipfs-unixfs-exporter": "^10.0.0",
+    "ipfs-unixfs-importer": "^12.0.0",
+    "it-last": "^2.0.0",
+    "it-pipe": "^2.0.5",
+    "merge-options": "^3.0.4",
+    "multiformats": "^11.0.1"
+  },
+  "devDependencies": {
+    "aegir": "^38.1.0",
+    "blockstore-core": "^3.0.0",
+    "delay": "^5.0.0",
+    "it-all": "^2.0.0",
+    "it-drain": "^2.0.0",
+    "it-to-buffer": "^3.0.0",
+    "uint8arrays": "^4.0.3"
+  }
+}

package/src/commands/add.ts

@@ -0,0 +1,46 @@
+import type { Blockstore } from 'interface-blockstore'
+import { ImportCandidate, importer, ImportResult, UserImporterOptions } from 'ipfs-unixfs-importer'
+import last from 'it-last'
+import type { CID } from 'multiformats/cid'
+import { UnknownError } from './utils/errors.js'
+
+function isIterable (obj: any): obj is Iterator<Uint8Array> {
+  return obj[Symbol.iterator] != null
+}
+
+function isAsyncIterable (obj: any): obj is AsyncIterator<Uint8Array> {
+  return obj[Symbol.asyncIterator] != null
+}
+
+export async function add (source: Uint8Array | Iterator<Uint8Array> | AsyncIterator<Uint8Array> | ImportCandidate, blockstore: Blockstore, options: UserImporterOptions = {}): Promise<CID> {
+  let importCandidate: ImportCandidate
+
+  if (source instanceof Uint8Array || isIterable(source) || isAsyncIterable(source)) {
+    importCandidate = {
+      // @ts-expect-error FIXME: work out types
+      content: source
+    }
+  } else {
+    importCandidate = source
+  }
+
+  const result = await last(importer(importCandidate, blockstore, {
+    cidVersion: 1,
+    rawLeaves: true,
+    ...options
+  }))
+
+  if (result == null) {
+    throw new UnknownError('Could not import')
+  }
+
+  return result.cid
+}
+
+export async function * addStream (source: Iterable<ImportCandidate> | AsyncIterable<ImportCandidate>, blockstore: Blockstore, options: UserImporterOptions = {}): AsyncGenerator<ImportResult> {
+  yield * importer(source, blockstore, {
+    cidVersion: 1,
+    rawLeaves: true,
+    ...options
+  })
+}

package/src/commands/cat.ts

@@ -0,0 +1,31 @@
+import { NoContentError, NotAFileError } from '@helia/interface/errors'
+import { Blockstore, exporter } from 'ipfs-unixfs-exporter'
+import type { CID } from 'multiformats/cid'
+import type { CatOptions } from '../index.js'
+import { resolve } from './utils/resolve.js'
+import mergeOpts from 'merge-options'
+
+const mergeOptions = mergeOpts.bind({ ignoreUndefined: true })
+
+const defaultOptions: CatOptions = {
+
+}
+
+export async function * cat (cid: CID, blockstore: Blockstore, options: Partial<CatOptions> = {}): AsyncIterable<Uint8Array> {
+  const opts: CatOptions = mergeOptions(defaultOptions, options)
+  const resolved = await resolve(cid, opts.path, blockstore, opts)
+  const result = await exporter(resolved.cid, blockstore, opts)
+
+  if (result.type !== 'file' && result.type !== 'raw') {
+    throw new NotAFileError()
+  }
+
+  if (result.content == null) {
+    throw new NoContentError()
+  }
+
+  yield * result.content({
+    offset: opts.offset,
+    length: opts.length
+  })
+}

package/src/commands/chmod.ts

@@ -0,0 +1,133 @@
+import { recursive } from 'ipfs-unixfs-exporter'
+import { CID } from 'multiformats/cid'
+import type { ChmodOptions } from '../index.js'
+import mergeOpts from 'merge-options'
+import { logger } from '@libp2p/logger'
+import { UnixFS } from 'ipfs-unixfs'
+import { pipe } from 'it-pipe'
+import { InvalidPBNodeError, NotUnixFSError, UnknownError } from './utils/errors.js'
+import * as dagPB from '@ipld/dag-pb'
+import type { PBNode, PBLink } from '@ipld/dag-pb'
+import { importer } from 'ipfs-unixfs-importer'
+import { persist } from './utils/persist.js'
+import type { Blockstore } from 'interface-blockstore'
+import last from 'it-last'
+import { sha256 } from 'multiformats/hashes/sha2'
+import { resolve, updatePathCids } from './utils/resolve.js'
+import * as raw from 'multiformats/codecs/raw'
+
+const mergeOptions = mergeOpts.bind({ ignoreUndefined: true })
+const log = logger('helia:unixfs:chmod')
+
+const defaultOptions: ChmodOptions = {
+  recursive: false
+}
+
+export async function chmod (cid: CID, mode: number, blockstore: Blockstore, options: Partial<ChmodOptions> = {}): Promise<CID> {
+  const opts: ChmodOptions = mergeOptions(defaultOptions, options)
+  const resolved = await resolve(cid, opts.path, blockstore, options)
+
+  log('chmod %c %d', resolved.cid, mode)
+
+  if (opts.recursive) {
+    // recursively export from root CID, change perms of each entry then reimport
+    // but do not reimport files, only manipulate dag-pb nodes
+    const root = await pipe(
+      async function * () {
+        for await (const entry of recursive(resolved.cid, blockstore)) {
+          let metadata: UnixFS
+          let links: PBLink[] = []
+
+          if (entry.type === 'raw') {
+            // convert to UnixFS
+            metadata = new UnixFS({ type: 'file', data: entry.node })
+          } else if (entry.type === 'file' || entry.type === 'directory') {
+            metadata = entry.unixfs
+            links = entry.node.Links
+          } else {
+            throw new NotUnixFSError()
+          }
+
+          metadata.mode = mode
+
+          const node = {
+            Data: metadata.marshal(),
+            Links: links
+          }
+
+          yield {
+            path: entry.path,
+            content: node
+          }
+        }
+      },
+      // @ts-expect-error we account for the incompatible source type with our custom dag builder below
+      (source) => importer(source, blockstore, {
+        ...opts,
+        pin: false,
+        dagBuilder: async function * (source, block, opts) {
+          for await (const entry of source) {
+            yield async function () {
+              // @ts-expect-error cannot derive type
+              const node: PBNode = entry.content
+
+              const buf = dagPB.encode(node)
+              const cid = await persist(buf, block, opts)
+
+              if (node.Data == null) {
+                throw new InvalidPBNodeError(`${cid} had no data`)
+              }
+
+              const unixfs = UnixFS.unmarshal(node.Data)
+
+              return {
+                cid,
+                size: buf.length,
+                path: entry.path,
+                unixfs
+              }
+            }
+          }
+        }
+      }),
+      async (nodes) => await last(nodes)
+    )
+
+    if (root == null) {
+      throw new UnknownError(`Could not chmod ${resolved.cid.toString()}`)
+    }
+
+    return await updatePathCids(root.cid, resolved, blockstore, options)
+  }
+
+  const block = await blockstore.get(resolved.cid)
+  let metadata: UnixFS
+  let links: PBLink[] = []
+
+  if (resolved.cid.code === raw.code) {
+    // convert to UnixFS
+    metadata = new UnixFS({ type: 'file', data: block })
+  } else {
+    const node = dagPB.decode(block)
+
+    if (node.Data == null) {
+      throw new InvalidPBNodeError(`${resolved.cid.toString()} had no data`)
+    }
+
+    links = node.Links
+    metadata = UnixFS.unmarshal(node.Data)
+  }
+
+  metadata.mode = mode
+  const updatedBlock = dagPB.encode({
+    Data: metadata.marshal(),
+    Links: links
+  })
+
+  const hash = await sha256.digest(updatedBlock)
+  const updatedCid = CID.create(resolved.cid.version, dagPB.code, hash)
+
+  await blockstore.put(updatedCid, updatedBlock)
+
+  return await updatePathCids(updatedCid, resolved, blockstore, options)
+}

package/src/commands/cp.ts

@@ -0,0 +1,41 @@
+import { InvalidParametersError } from '@helia/interface/errors'
+import type { Blockstore } from 'ipfs-unixfs-exporter'
+import type { CID } from 'multiformats/cid'
+import type { CpOptions } from '../index.js'
+import mergeOpts from 'merge-options'
+import { logger } from '@libp2p/logger'
+import { addLink } from './utils/add-link.js'
+import { cidToPBLink } from './utils/cid-to-pblink.js'
+import { cidToDirectory } from './utils/cid-to-directory.js'
+
+const mergeOptions = mergeOpts.bind({ ignoreUndefined: true })
+const log = logger('helia:unixfs:cp')
+
+const defaultOptions = {
+  force: false
+}
+
+export async function cp (source: CID, target: CID, name: string, blockstore: Blockstore, options: Partial<CpOptions> = {}): Promise<CID> {
+  const opts: CpOptions = mergeOptions(defaultOptions, options)
+
+  if (name.includes('/')) {
+    throw new InvalidParametersError('Name must not have slashes')
+  }
+
+  const [
+    directory,
+    pblink
+  ] = await Promise.all([
+    cidToDirectory(target, blockstore, opts),
+    cidToPBLink(source, name, blockstore, opts)
+  ])
+
+  log('Adding %c as "%s" to %c', source, name, target)
+
+  const result = await addLink(directory, pblink, blockstore, {
+    allowOverwriting: opts.force,
+    ...opts
+  })
+
+  return result.cid
+}

package/src/commands/ls.ts

@@ -0,0 +1,36 @@
+import { NoContentError, NotADirectoryError } from '@helia/interface/errors'
+import { Blockstore, exporter, UnixFSEntry } from 'ipfs-unixfs-exporter'
+import type { CID } from 'multiformats/cid'
+import type { LsOptions } from '../index.js'
+import { resolve } from './utils/resolve.js'
+import mergeOpts from 'merge-options'
+
+const mergeOptions = mergeOpts.bind({ ignoreUndefined: true })
+
+const defaultOptions = {
+
+}
+
+export async function * ls (cid: CID, blockstore: Blockstore, options: Partial<LsOptions> = {}): AsyncIterable<UnixFSEntry> {
+  const opts: LsOptions = mergeOptions(defaultOptions, options)
+  const resolved = await resolve(cid, opts.path, blockstore, opts)
+  const result = await exporter(resolved.cid, blockstore)
+
+  if (result.type === 'file' || result.type === 'raw') {
+    yield result
+    return
+  }
+
+  if (result.content == null) {
+    throw new NoContentError()
+  }
+
+  if (result.type !== 'directory') {
+    throw new NotADirectoryError()
+  }
+
+  yield * result.content({
+    offset: options.offset,
+    length: options.length
+  })
+}

package/src/commands/mkdir.ts

@@ -0,0 +1,71 @@
+import { InvalidParametersError, NotADirectoryError } from '@helia/interface/errors'
+import { CID } from 'multiformats/cid'
+import mergeOpts from 'merge-options'
+import { logger } from '@libp2p/logger'
+import type { MkdirOptions } from '../index.js'
+import * as dagPB from '@ipld/dag-pb'
+import { addLink } from './utils/add-link.js'
+import type { Blockstore } from 'interface-blockstore'
+import { UnixFS } from 'ipfs-unixfs'
+import { sha256 } from 'multiformats/hashes/sha2'
+import { exporter } from 'ipfs-unixfs-exporter'
+import { cidToDirectory } from './utils/cid-to-directory.js'
+import { cidToPBLink } from './utils/cid-to-pblink.js'
+
+const mergeOptions = mergeOpts.bind({ ignoreUndefined: true })
+const log = logger('helia:unixfs:mkdir')
+
+const defaultOptions = {
+  cidVersion: 1,
+  force: false
+}
+
+export async function mkdir (parentCid: CID, dirname: string, blockstore: Blockstore, options: Partial<MkdirOptions> = {}): Promise<CID> {
+  const opts: MkdirOptions = mergeOptions(defaultOptions, options)
+
+  if (dirname.includes('/')) {
+    throw new InvalidParametersError('Path must not have slashes')
+  }
+
+  const entry = await exporter(parentCid, blockstore, options)
+
+  if (entry.type !== 'directory') {
+    throw new NotADirectoryError(`${parentCid.toString()} was not a UnixFS directory`)
+  }
+
+  log('creating %s', dirname)
+
+  const metadata = new UnixFS({
+    type: 'directory',
+    mode: opts.mode,
+    mtime: opts.mtime
+  })
+
+  // Persist the new parent PBNode
+  const node = {
+    Data: metadata.marshal(),
+    Links: []
+  }
+  const buf = dagPB.encode(node)
+  const hash = await sha256.digest(buf)
+  const emptyDirCid = CID.create(opts.cidVersion, dagPB.code, hash)
+
+  await blockstore.put(emptyDirCid, buf)
+
+  const [
+    directory,
+    pblink
+  ] = await Promise.all([
+    cidToDirectory(parentCid, blockstore, opts),
+    cidToPBLink(emptyDirCid, dirname, blockstore, opts)
+  ])
+
+  log('adding empty dir called %s to %c', dirname, parentCid)
+
+  const result = await addLink(directory, pblink, blockstore, {
+    ...opts,
+    allowOverwriting: opts.force
+  })
+
+  return result.cid
+}

package/src/commands/rm.ts

@@ -0,0 +1,31 @@
+import { InvalidParametersError } from '@helia/interface/errors'
+import type { Blockstore } from 'ipfs-unixfs-exporter'
+import type { CID } from 'multiformats/cid'
+import type { RmOptions } from '../index.js'
+import mergeOpts from 'merge-options'
+import { logger } from '@libp2p/logger'
+import { removeLink } from './utils/remove-link.js'
+import { cidToDirectory } from './utils/cid-to-directory.js'
+
+const mergeOptions = mergeOpts.bind({ ignoreUndefined: true })
+const log = logger('helia:unixfs:rm')
+
+const defaultOptions = {
+
+}
+
+export async function rm (target: CID, name: string, blockstore: Blockstore, options: Partial<RmOptions> = {}): Promise<CID> {
+  const opts: RmOptions = mergeOptions(defaultOptions, options)
+
+  if (name.includes('/')) {
+    throw new InvalidParametersError('Name must not have slashes')
+  }
+
+  const directory = await cidToDirectory(target, blockstore, opts)
+
+  log('Removing %s from %c', name, target)
+
+  const result = await removeLink(directory, name, blockstore, opts)
+
+  return result.cid
+}