@helia/interface 0.0.0

package/LICENSE

@@ -0,0 +1,4 @@
+This project is dual licensed under MIT and Apache-2.0.
+
+MIT: https://www.opensource.org/licenses/mit
+Apache-2.0: https://www.apache.org/licenses/license-2.0

package/README.md

@@ -0,0 +1,44 @@
+# @helia/interface <!-- omit in toc -->
+
+[![ipfs.tech](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](https://ipfs.tech)
+[![Discuss](https://img.shields.io/discourse/https/discuss.ipfs.tech/posts.svg?style=flat-square)](https://discuss.ipfs.tech)
+[![codecov](https://img.shields.io/codecov/c/github/ipfs/helia.svg?style=flat-square)](https://codecov.io/gh/ipfs/helia)
+[![CI](https://img.shields.io/github/actions/workflow/status/ipfs/helia/js-test-and-release.yml?branch=main\&style=flat-square)](https://github.com/ipfs/helia/actions/workflows/js-test-and-release.yml?query=branch%3Amain)
+
+> The Helia API
+
+## Table of contents <!-- omit in toc -->
+
+- [Install](#install)
+- [API Docs](#api-docs)
+- [License](#license)
+- [Contribute](#contribute)
+
+## Install
+
+```console
+$ npm i @helia/interface
+```
+
+## API Docs
+
+- <https://ipfs.github.io/helia/modules/_helia_interface.html>
+
+## License
+
+Licensed under either of
+
+- Apache 2.0, ([LICENSE-APACHE](LICENSE-APACHE) / <http://www.apache.org/licenses/LICENSE-2.0>)
+- MIT ([LICENSE-MIT](LICENSE-MIT) / <http://opensource.org/licenses/MIT>)
+
+## Contribute
+
+Contributions welcome! Please check out [the issues](https://github.com/ipfs/helia/issues).
+
+Also see our [contributing document](https://github.com/ipfs/community/blob/master/CONTRIBUTING_JS.md) for more information on how we work, and about contributing in general.
+
+Please be aware that all interactions related to this repo are subject to the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).
+
+Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
+
+[![](https://cdn.rawgit.com/jbenet/contribute-ipfs-gif/master/img/contribute.gif)](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md)

package/dist/index.min.js

@@ -0,0 +1,3 @@
+(function (root, factory) {(typeof module === 'object' && module.exports) ? module.exports = factory() : root.HeliaInterface = factory()}(typeof self !== 'undefined' ? self : this, function () {
+"use strict";var HeliaInterface=(()=>{var t=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var d=(o,e,x,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let p of b(e))!c.call(o,p)&&p!==x&&t(o,p,{get:()=>e[p],enumerable:!(r=a(e,p))||r.enumerable});return o};var f=o=>d(t({},"__esModule",{value:!0}),o);var g={};return f(g);})();
+return HeliaInterface}));

package/dist/src/errors.d.ts

@@ -0,0 +1,18 @@
+export declare abstract class HeliaError extends Error {
+    readonly name: string;
+    readonly code: string;
+    constructor(message: string, name: string, code: string);
+}
+export declare class NotAFileError extends HeliaError {
+    constructor(message?: string);
+}
+export declare class NotADirectoryError extends HeliaError {
+    constructor(message?: string);
+}
+export declare class NoContentError extends HeliaError {
+    constructor(message?: string);
+}
+export declare class InvalidParametersError extends HeliaError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,8BAAsB,UAAW,SAAQ,KAAK;IAC5C,SAAgB,IAAI,EAAE,MAAM,CAAA;IAC5B,SAAgB,IAAI,EAAE,MAAM,CAAA;gBAEf,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAMzD;AAED,qBAAa,aAAc,SAAQ,UAAU;gBAC9B,OAAO,SAAe;CAGpC;AAED,qBAAa,kBAAmB,SAAQ,UAAU;gBACnC,OAAO,SAAoB;CAGzC;AAED,qBAAa,cAAe,SAAQ,UAAU;gBAC/B,OAAO,SAAe;CAGpC;AAED,qBAAa,sBAAuB,SAAQ,UAAU;gBACvC,OAAO,SAAuB;CAG5C"}

package/dist/src/errors.js

@@ -0,0 +1,28 @@
+export class HeliaError extends Error {
+    constructor(message, name, code) {
+        super(message);
+        this.name = name;
+        this.code = code;
+    }
+}
+export class NotAFileError extends HeliaError {
+    constructor(message = 'not a file') {
+        super(message, 'NotAFileError', 'ERR_NOT_FILE');
+    }
+}
+export class NotADirectoryError extends HeliaError {
+    constructor(message = 'not a directory') {
+        super(message, 'NotAFileError', 'ERR_NOT_DIRECTORY');
+    }
+}
+export class NoContentError extends HeliaError {
+    constructor(message = 'no content') {
+        super(message, 'NoContentError', 'ERR_NO_CONTENT');
+    }
+}
+export class InvalidParametersError extends HeliaError {
+    constructor(message = 'invalid parameters') {
+        super(message, 'InvalidParametersError', 'ERR_INVALID_PARAMETERS');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,UAAW,SAAQ,KAAK;IAI5C,YAAa,OAAe,EAAE,IAAY,EAAE,IAAY;QACtD,KAAK,CAAC,OAAO,CAAC,CAAA;QAEd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAa,OAAO,GAAG,YAAY;QACjC,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,cAAc,CAAC,CAAA;IACjD,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAa,OAAO,GAAG,iBAAiB;QACtC,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,mBAAmB,CAAC,CAAA;IACtD,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAa,OAAO,GAAG,YAAY;QACjC,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAA;IACpD,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IACpD,YAAa,OAAO,GAAG,oBAAoB;QACzC,KAAK,CAAC,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,CAAC,CAAA;IACpE,CAAC;CACF"}

package/dist/src/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @packageDocumentation
+ *
+ * The API defined by a Helia node
+ *
+ * @example
+ *
+ * ```typescript
+ * import type { Helia } from '@helia/interface'
+ *
+ * export function doSomething(helia: Helia) {
+ *   // use helia node functions here
+ * }
+ * ```
+ */
+import type { Libp2p } from '@libp2p/interface-libp2p';
+import type { Blockstore } from 'interface-blockstore';
+import type { AbortOptions } from '@libp2p/interfaces';
+import type { PeerId } from '@libp2p/interface-peer-id';
+import type { Multiaddr } from '@multiformats/multiaddr';
+import type { Datastore } from 'interface-datastore';
+/**
+ * The API presented by a Helia node.
+ */
+export interface Helia {
+    /**
+     * The underlying libp2p node
+     */
+    libp2p: Libp2p;
+    /**
+     * Where the blocks are stored
+     */
+    blockstore: Blockstore;
+    /**
+     * A key/value store
+     */
+    datastore: Datastore;
+    /**
+     * Returns information about this node
+     *
+     * @example
+     *
+     * ```typescript
+     * import { createHelia } from 'helia'
+     *
+     * const node = await createHelia()
+     * const id = await node.info()
+     * console.info(id)
+     * // { peerId: PeerId(12D3Foo), ... }
+     * ```
+     */
+    info: (options?: InfoOptions) => Promise<InfoResponse>;
+    /**
+     * Stops the Helia node
+     */
+    stop: () => Promise<void>;
+}
+export interface InfoOptions extends AbortOptions {
+    peerId?: PeerId;
+}
+export interface InfoResponse {
+    peerId: PeerId;
+    multiaddrs: Multiaddr[];
+    agentVersion: string;
+    protocolVersion: string;
+    protocols: string[];
+}
+//# 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":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,UAAU,EAAE,UAAU,CAAA;IAEtB;;OAEG;IACH,SAAS,EAAE,SAAS,CAAA;IAEpB;;;;;;;;;;;;;OAaG;IACH,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAEtD;;OAEG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB"}

package/dist/src/index.js

@@ -0,0 +1,17 @@
+/**
+ * @packageDocumentation
+ *
+ * The API defined by a Helia node
+ *
+ * @example
+ *
+ * ```typescript
+ * import type { Helia } from '@helia/interface'
+ *
+ * export function doSomething(helia: Helia) {
+ *   // use helia node functions here
+ * }
+ * ```
+ */
+export {};
+//# 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":"AAAA;;;;;;;;;;;;;;GAcG"}

package/package.json

@@ -0,0 +1,167 @@
+{
+  "name": "@helia/interface",
+  "version": "0.0.0",
+  "description": "The Helia API",
+  "license": "Apache-2.0 OR MIT",
+  "homepage": "https://github.com/ipfs/helia/tree/master/packages/interface#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",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "*",
+        "dist/*",
+        "dist/src/*",
+        "dist/src/*/index"
+      ],
+      "src/*": [
+        "*",
+        "dist/*",
+        "dist/src/*",
+        "dist/src/*/index"
+      ]
+    }
+  },
+  "files": [
+    "src",
+    "dist",
+    "!dist/test",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./errors": {
+      "types": "./dist/src/errors.d.ts",
+      "import": "./dist/src/errors.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",
+    "release": "aegir release"
+  },
+  "dependencies": {
+    "@libp2p/interface-libp2p": "^1.1.0",
+    "@libp2p/interface-peer-id": "^2.0.1",
+    "@libp2p/interfaces": "^3.3.1",
+    "@multiformats/multiaddr": "^11.1.5",
+    "interface-blockstore": "^4.0.1",
+    "interface-datastore": "^7.0.3"
+  },
+  "devDependencies": {
+    "aegir": "^38.1.0"
+  },
+  "typedoc": {
+    "entryPoint": "./src/index.ts"
+  }
+}

package/src/errors.ts

@@ -0,0 +1,35 @@
+export abstract class HeliaError extends Error {
+  public readonly name: string
+  public readonly code: string
+
+  constructor (message: string, name: string, code: string) {
+    super(message)
+
+    this.name = name
+    this.code = code
+  }
+}
+
+export class NotAFileError extends HeliaError {
+  constructor (message = 'not a file') {
+    super(message, 'NotAFileError', 'ERR_NOT_FILE')
+  }
+}
+
+export class NotADirectoryError extends HeliaError {
+  constructor (message = 'not a directory') {
+    super(message, 'NotAFileError', 'ERR_NOT_DIRECTORY')
+  }
+}
+
+export class NoContentError extends HeliaError {
+  constructor (message = 'no content') {
+    super(message, 'NoContentError', 'ERR_NO_CONTENT')
+  }
+}
+
+export class InvalidParametersError extends HeliaError {
+  constructor (message = 'invalid parameters') {
+    super(message, 'InvalidParametersError', 'ERR_INVALID_PARAMETERS')
+  }
+}

package/src/index.ts

@@ -0,0 +1,98 @@
+/**
+ * @packageDocumentation
+ *
+ * The API defined by a Helia node
+ *
+ * @example
+ *
+ * ```typescript
+ * import type { Helia } from '@helia/interface'
+ *
+ * export function doSomething(helia: Helia) {
+ *   // use helia node functions here
+ * }
+ * ```
+ */
+
+import type { Libp2p } from '@libp2p/interface-libp2p'
+import type { Blockstore } from 'interface-blockstore'
+import type { AbortOptions } from '@libp2p/interfaces'
+import type { PeerId } from '@libp2p/interface-peer-id'
+import type { Multiaddr } from '@multiformats/multiaddr'
+import type { Datastore } from 'interface-datastore'
+
+/**
+ * The API presented by a Helia node.
+ */
+export interface Helia {
+  /**
+   * The underlying libp2p node
+   */
+  libp2p: Libp2p
+
+  /**
+   * Where the blocks are stored
+   */
+  blockstore: Blockstore
+
+  /**
+   * A key/value store
+   */
+  datastore: Datastore
+
+  /**
+   * Returns information about this node
+   *
+   * @example
+   *
+   * ```typescript
+   * import { createHelia } from 'helia'
+   *
+   * const node = await createHelia()
+   * const id = await node.info()
+   * console.info(id)
+   * // { peerId: PeerId(12D3Foo), ... }
+   * ```
+   */
+  info: (options?: InfoOptions) => Promise<InfoResponse>
+
+  /**
+   * Stops the Helia node
+   */
+  stop: () => Promise<void>
+}
+
+export interface InfoOptions extends AbortOptions {
+  /**
+   * If passed, return information about this PeerId, defaults
+   * to the ID of the current node.
+   */
+  peerId?: PeerId
+}
+
+export interface InfoResponse {
+  /**
+   * The ID of the peer this info is about
+   */
+  peerId: PeerId
+
+  /**
+   * The multiaddrs the peer is listening on
+   */
+  multiaddrs: Multiaddr[]
+
+  /**
+   * The peer's reported agent version
+   */
+  agentVersion: string
+
+  /**
+   * The peer's reported protocol version
+   */
+  protocolVersion: string
+
+  /**
+   * The protocols the peer supports
+   */
+  protocols: string[]
+}