helia 0.0.0-031ca73

package/dist/src/storage.js

@@ -0,0 +1,178 @@
+import { BaseBlockstore } from 'blockstore-core';
+import merge from 'it-merge';
+import { pushable } from 'it-pushable';
+import filter from 'it-filter';
+import createMortice from 'mortice';
+/**
+ * BlockStorage is a hybrid blockstore that puts/gets blocks from a configured
+ * blockstore (that may be on disk, s3, or something else). If the blocks are
+ * not present Bitswap will be used to fetch them from network peers.
+ */
+export class BlockStorage extends BaseBlockstore {
+    /**
+     * Create a new BlockStorage
+     */
+    constructor(blockstore, pins, bitswap) {
+        super();
+        this.child = blockstore;
+        this.bitswap = bitswap;
+        this.pins = pins;
+        this.lock = createMortice();
+    }
+    async open() {
+        await this.child.open();
+    }
+    async close() {
+        await this.child.close();
+    }
+    unwrap() {
+        return this.child;
+    }
+    /**
+     * Put a block to the underlying datastore
+     */
+    async put(cid, block, options = {}) {
+        const releaseLock = await this.lock.readLock();
+        try {
+            if (this.bitswap?.isStarted() === true) {
+                await this.bitswap.put(cid, block, options);
+            }
+            else {
+                await this.child.put(cid, block, options);
+            }
+        }
+        finally {
+            releaseLock();
+        }
+    }
+    /**
+     * Put a multiple blocks to the underlying datastore
+     */
+    async *putMany(blocks, options = {}) {
+        const releaseLock = await this.lock.readLock();
+        try {
+            const missingBlocks = filter(blocks, async ({ key }) => {
+                return !(await this.child.has(key));
+            });
+            const store = this.bitswap?.isStarted() === true ? this.bitswap : this.child;
+            yield* store.putMany(missingBlocks, options);
+        }
+        finally {
+            releaseLock();
+        }
+    }
+    /**
+     * Get a block by cid
+     */
+    async get(cid, options = {}) {
+        const releaseLock = await this.lock.readLock();
+        try {
+            if (!(await this.has(cid)) && this.bitswap?.isStarted() === true) {
+                return await this.bitswap?.get(cid, options);
+            }
+            else {
+                return await this.child.get(cid, options);
+            }
+        }
+        finally {
+            releaseLock();
+        }
+    }
+    /**
+     * Get multiple blocks back from an array of cids
+     */
+    async *getMany(cids, options = {}) {
+        const releaseLock = await this.lock.readLock();
+        try {
+            const getFromBitswap = pushable({ objectMode: true });
+            const getFromChild = pushable({ objectMode: true });
+            void Promise.resolve().then(async () => {
+                for await (const cid of cids) {
+                    if (!(await this.has(cid)) && this.bitswap?.isStarted() === true) {
+                        getFromBitswap.push(cid);
+                    }
+                    else {
+                        getFromChild.push(cid);
+                    }
+                }
+                getFromBitswap.end();
+                getFromChild.end();
+            }).catch(err => {
+                getFromBitswap.throw(err);
+            });
+            const streams = [
+                this.child.getMany(getFromChild, options)
+            ];
+            if (this.bitswap?.isStarted() === true) {
+                streams.push(this.bitswap.getMany(getFromBitswap, options));
+            }
+            yield* merge(...streams);
+        }
+        finally {
+            releaseLock();
+        }
+    }
+    /**
+     * Delete a block from the blockstore
+     */
+    async delete(cid, options = {}) {
+        const releaseLock = await this.lock.writeLock();
+        try {
+            if (await this.pins.isPinned(cid)) {
+                throw new Error('CID was pinned');
+            }
+            await this.child.delete(cid, options);
+        }
+        finally {
+            releaseLock();
+        }
+    }
+    /**
+     * Delete multiple blocks from the blockstore
+     */
+    async *deleteMany(cids, options = {}) {
+        const releaseLock = await this.lock.writeLock();
+        try {
+            const storage = this;
+            yield* this.child.deleteMany((async function* () {
+                for await (const cid of cids) {
+                    if (await storage.pins.isPinned(cid)) {
+                        throw new Error('CID was pinned');
+                    }
+                    yield cid;
+                }
+            }()), options);
+        }
+        finally {
+            releaseLock();
+        }
+    }
+    async has(cid, options = {}) {
+        const releaseLock = await this.lock.readLock();
+        try {
+            return await this.child.has(cid, options);
+        }
+        finally {
+            releaseLock();
+        }
+    }
+    async *query(q, options = {}) {
+        const releaseLock = await this.lock.readLock();
+        try {
+            yield* this.child.query(q, options);
+        }
+        finally {
+            releaseLock();
+        }
+    }
+    async *queryKeys(q, options = {}) {
+        const releaseLock = await this.lock.readLock();
+        try {
+            yield* this.child.queryKeys(q, options);
+        }
+        finally {
+            releaseLock();
+        }
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/src/storage.js.map

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

package/dist/src/utils/dag-walkers.d.ts

@@ -0,0 +1,22 @@
+import type { DAGWalker } from '../index.js';
+/**
+ * Dag walker for dag-pb CIDs
+ */
+export declare const dagPbWalker: DAGWalker;
+/**
+ * Dag walker for raw CIDs
+ */
+export declare const rawWalker: DAGWalker;
+/**
+ * Dag walker for dag-cbor CIDs. Does not actually use dag-cbor since
+ * all we are interested in is extracting the the CIDs from the block
+ * so we can just use cborg for that.
+ */
+export declare const cborWalker: DAGWalker;
+/**
+ * Dag walker for dag-json CIDs. Does not actually use dag-json since
+ * all we are interested in is extracting the the CIDs from the block
+ * so we can just use cborg/json for that.
+ */
+export declare const jsonWalker: DAGWalker;
+//# sourceMappingURL=dag-walkers.d.ts.map

package/dist/src/utils/dag-walkers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-walkers.d.ts","sourceRoot":"","sources":["../../../src/utils/dag-walkers.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAK5C;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,SAOzB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,SAKvB,CAAA;AAKD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAuBxB,CAAA;AAsED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SA6BxB,CAAA"}

package/dist/src/utils/dag-walkers.js

@@ -0,0 +1,145 @@
+/* eslint max-depth: ["error", 7] */
+import * as dagPb from '@ipld/dag-pb';
+import * as cborg from 'cborg';
+import { Type, Token } from 'cborg';
+import * as cborgJson from 'cborg/json';
+import * as raw from 'multiformats/codecs/raw';
+import { CID } from 'multiformats';
+import { base64 } from 'multiformats/bases/base64';
+/**
+ * Dag walker for dag-pb CIDs
+ */
+export const dagPbWalker = {
+    codec: dagPb.code,
+    async *walk(block) {
+        const node = dagPb.decode(block);
+        yield* node.Links.map(l => l.Hash);
+    }
+};
+/**
+ * Dag walker for raw CIDs
+ */
+export const rawWalker = {
+    codec: raw.code,
+    async *walk() {
+        // no embedded CIDs in a raw block
+    }
+};
+// https://github.com/ipfs/go-ipfs/issues/3570#issuecomment-273931692
+const CID_TAG = 42;
+/**
+ * Dag walker for dag-cbor CIDs. Does not actually use dag-cbor since
+ * all we are interested in is extracting the the CIDs from the block
+ * so we can just use cborg for that.
+ */
+export const cborWalker = {
+    codec: 0x71,
+    async *walk(block) {
+        const cids = [];
+        const tags = [];
+        tags[CID_TAG] = (bytes) => {
+            if (bytes[0] !== 0) {
+                throw new Error('Invalid CID for CBOR tag 42; expected leading 0x00');
+            }
+            const cid = CID.decode(bytes.subarray(1)); // ignore leading 0x00
+            cids.push(cid);
+            return cid;
+        };
+        cborg.decode(block, {
+            tags
+        });
+        yield* cids;
+    }
+};
+/**
+ * Borrowed from @ipld/dag-json
+ */
+class DagJsonTokenizer extends cborgJson.Tokenizer {
+    constructor(data, options) {
+        super(data, options);
+        this.tokenBuffer = [];
+    }
+    done() {
+        return this.tokenBuffer.length === 0 && super.done();
+    }
+    _next() {
+        if (this.tokenBuffer.length > 0) {
+            // @ts-expect-error https://github.com/Microsoft/TypeScript/issues/30406
+            return this.tokenBuffer.pop();
+        }
+        return super.next();
+    }
+    /**
+     * Implements rules outlined in https://github.com/ipld/specs/pull/356
+     */
+    next() {
+        const token = this._next();
+        if (token.type === Type.map) {
+            const keyToken = this._next();
+            if (keyToken.type === Type.string && keyToken.value === '/') {
+                const valueToken = this._next();
+                if (valueToken.type === Type.string) { // *must* be a CID
+                    const breakToken = this._next(); // swallow the end-of-map token
+                    if (breakToken.type !== Type.break) {
+                        throw new Error('Invalid encoded CID form');
+                    }
+                    this.tokenBuffer.push(valueToken); // CID.parse will pick this up after our tag token
+                    return new Token(Type.tag, 42, 0);
+                }
+                if (valueToken.type === Type.map) {
+                    const innerKeyToken = this._next();
+                    if (innerKeyToken.type === Type.string && innerKeyToken.value === 'bytes') {
+                        const innerValueToken = this._next();
+                        if (innerValueToken.type === Type.string) { // *must* be Bytes
+                            for (let i = 0; i < 2; i++) {
+                                const breakToken = this._next(); // swallow two end-of-map tokens
+                                if (breakToken.type !== Type.break) {
+                                    throw new Error('Invalid encoded Bytes form');
+                                }
+                            }
+                            const bytes = base64.decode(`m${innerValueToken.value}`);
+                            return new Token(Type.bytes, bytes, innerValueToken.value.length);
+                        }
+                        this.tokenBuffer.push(innerValueToken); // bail
+                    }
+                    this.tokenBuffer.push(innerKeyToken); // bail
+                }
+                this.tokenBuffer.push(valueToken); // bail
+            }
+            this.tokenBuffer.push(keyToken); // bail
+        }
+        return token;
+    }
+}
+/**
+ * Dag walker for dag-json CIDs. Does not actually use dag-json since
+ * all we are interested in is extracting the the CIDs from the block
+ * so we can just use cborg/json for that.
+ */
+export const jsonWalker = {
+    codec: 0x0129,
+    async *walk(block) {
+        const cids = [];
+        const tags = [];
+        tags[CID_TAG] = (string) => {
+            const cid = CID.parse(string);
+            cids.push(cid);
+            return cid;
+        };
+        cborgJson.decode(block, {
+            tags,
+            tokenizer: new DagJsonTokenizer(block, {
+                tags,
+                allowIndefinite: true,
+                allowUndefined: true,
+                allowNaN: true,
+                allowInfinity: true,
+                allowBigInt: true,
+                strict: false,
+                rejectDuplicateMapKeys: false
+            })
+        });
+        yield* cids;
+    }
+};
+//# sourceMappingURL=dag-walkers.js.map

package/dist/src/utils/dag-walkers.js.map

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

package/dist/src/utils/datastore-version.d.ts

@@ -0,0 +1,3 @@
+import { Datastore } from 'interface-datastore';
+export declare function assertDatastoreVersionIsCurrent(datastore: Datastore): Promise<void>;
+//# sourceMappingURL=datastore-version.d.ts.map

package/dist/src/utils/datastore-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datastore-version.d.ts","sourceRoot":"","sources":["../../../src/utils/datastore-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAO,MAAM,qBAAqB,CAAA;AAOpD,wBAAsB,+BAA+B,CAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAe1F"}

package/dist/src/utils/datastore-version.js

@@ -0,0 +1,19 @@
+import { Key } from 'interface-datastore';
+import { fromString as uint8ArrayFromString } from 'uint8arrays/from-string';
+import { toString as uint8ArrayToString } from 'uint8arrays/to-string';
+const DS_VERSION_KEY = new Key('/version');
+const CURRENT_VERSION = 1;
+export async function assertDatastoreVersionIsCurrent(datastore) {
+    if (!(await datastore.has(DS_VERSION_KEY))) {
+        await datastore.put(DS_VERSION_KEY, uint8ArrayFromString(`${CURRENT_VERSION}`));
+        return;
+    }
+    const buf = await datastore.get(DS_VERSION_KEY);
+    const str = uint8ArrayToString(buf);
+    const version = parseInt(str, 10);
+    if (version !== CURRENT_VERSION) {
+        // TODO: write migrations when we break compatibility - for an example, see https://github.com/ipfs/js-ipfs-repo/tree/master/packages/ipfs-repo-migrations
+        throw new Error('Unknown datastore version, a datastore migration may be required');
+    }
+}
+//# sourceMappingURL=datastore-version.js.map

package/dist/src/utils/datastore-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datastore-version.js","sourceRoot":"","sources":["../../../src/utils/datastore-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,GAAG,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,UAAU,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC5E,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAEtE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAA;AAC1C,MAAM,eAAe,GAAG,CAAC,CAAA;AAEzB,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAE,SAAoB;IACzE,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,EAAE;QAC1C,MAAM,SAAS,CAAC,GAAG,CAAC,cAAc,EAAE,oBAAoB,CAAC,GAAG,eAAe,EAAE,CAAC,CAAC,CAAA;QAE/E,OAAM;KACP;IAED,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IAC/C,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;IACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IAEjC,IAAI,OAAO,KAAK,eAAe,EAAE;QAC/B,0JAA0J;QAC1J,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;KACpF;AACH,CAAC"}

package/package.json

@@ -0,0 +1,176 @@
+{
+  "name": "helia",
+  "version": "0.0.0-031ca73",
+  "description": "An implementation of IPFS in JavaScript",
+  "license": "Apache-2.0 OR MIT",
+  "homepage": "https://github.com/ipfs/helia/tree/master/packages/helia#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",
+    "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": "0.0.0-031ca73",
+    "@ipld/dag-pb": "^4.0.2",
+    "@libp2p/interface-libp2p": "^1.1.0",
+    "@libp2p/interfaces": "^3.3.1",
+    "blockstore-core": "^3.0.0",
+    "cborg": "^1.10.0",
+    "datastore-core": "^8.0.4",
+    "interface-blockstore": "^4.0.1",
+    "interface-datastore": "^7.0.3",
+    "interface-store": "^3.0.4",
+    "ipfs-bitswap": "^16.0.0",
+    "it-all": "^2.0.0",
+    "it-drain": "^2.0.0",
+    "it-filter": "^2.0.0",
+    "it-merge": "^2.0.0",
+    "it-pushable": "^3.1.2",
+    "mortice": "^3.0.1",
+    "multiformats": "^11.0.1",
+    "p-defer": "^4.0.0",
+    "p-queue": "^7.3.4",
+    "progress-events": "^1.0.0",
+    "uint8arrays": "^4.0.3"
+  },
+  "devDependencies": {
+    "@chainsafe/libp2p-noise": "^11.0.0",
+    "@chainsafe/libp2p-yamux": "^3.0.5",
+    "@ipld/dag-cbor": "^9.0.0",
+    "@ipld/dag-json": "^10.0.1",
+    "@libp2p/websockets": "^5.0.3",
+    "aegir": "^38.1.0",
+    "libp2p": "^0.42.2"
+  },
+  "typedoc": {
+    "entryPoint": "./src/index.ts"
+  }
+}