@helia/delegated-routing-client 0.0.0-9114743f

package/dist/src/delegated-routing-router.d.ts

@@ -0,0 +1,18 @@
+import { CID } from 'multiformats/cid';
+import type { DelegatedRoutingV1HttpApiClientComponents, DelegatedRoutingV1HttpApiClientInit } from '@helia/delegated-routing-v1-http-api-client';
+import type { Peer, Provider, Router, RoutingOptions } from '@helia/interface';
+import type { Version } from 'multiformats';
+export declare class DelegatedHTTPRouter implements Router {
+    readonly name = "delegated-http-router";
+    private readonly client;
+    constructor(components: DelegatedRoutingV1HttpApiClientComponents, init: DelegatedRoutingV1HttpApiClientInit);
+    provide(cid: CID, options?: RoutingOptions): Promise<void>;
+    cancelReprovide(cid?: CID, options?: RoutingOptions): Promise<void>;
+    findProviders(cid: CID<unknown, number, number, Version>, options?: RoutingOptions): AsyncIterable<Provider>;
+    put(key: Uint8Array, value: Uint8Array, options?: RoutingOptions): Promise<void>;
+    get(key: Uint8Array, options?: RoutingOptions): Promise<Uint8Array>;
+    findPeer(peerId: CID, options?: RoutingOptions): Promise<Peer>;
+    getClosestPeers(key: Uint8Array, options?: RoutingOptions): AsyncIterable<Peer>;
+    toString(): string;
+}
+//# sourceMappingURL=delegated-routing-router.d.ts.map

package/dist/src/delegated-routing-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegated-routing-router.d.ts","sourceRoot":"","sources":["../../src/delegated-routing-router.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAItC,OAAO,KAAK,EAAmC,yCAAyC,EAAE,mCAAmC,EAAE,MAAM,6CAA6C,CAAA;AAClL,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAQ3C,qBAAa,mBAAoB,YAAW,MAAM;IAChD,SAAgB,IAAI,2BAA0B;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;gBAE3C,UAAU,EAAE,yCAAyC,EAAE,IAAI,EAAE,mCAAmC;IAIvG,OAAO,CAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,eAAe,CAAE,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,aAAa,CAAE,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC;IAW/G,GAAG,CAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjF,GAAG,CAAE,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAqBpE,QAAQ,CAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7D,eAAe,CAAE,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC;IAIxF,QAAQ,IAAK,MAAM;CAGpB"}

package/dist/src/delegated-routing-router.js

@@ -0,0 +1,78 @@
+import { delegatedRoutingV1HttpApiClient } from '@helia/delegated-routing-v1-http-api-client';
+import { NotFoundError } from '@libp2p/interface';
+import first from 'it-first';
+import map from 'it-map';
+import { CID } from 'multiformats/cid';
+import * as Digest from 'multiformats/hashes/digest';
+import { equals as uint8ArrayEquals } from 'uint8arrays/equals';
+import { fromString as uint8ArrayFromString } from 'uint8arrays/from-string';
+const IPNS_PREFIX = uint8ArrayFromString('/ipns/');
+function isIPNSKey(key) {
+    return uint8ArrayEquals(key.subarray(0, IPNS_PREFIX.byteLength), IPNS_PREFIX);
+}
+export class DelegatedHTTPRouter {
+    name = 'delegated-http-router';
+    client;
+    constructor(components, init) {
+        this.client = delegatedRoutingV1HttpApiClient(init)(components);
+    }
+    async provide(cid, options) {
+        // noop
+    }
+    async cancelReprovide(cid, options) {
+        // noop
+    }
+    async *findProviders(cid, options) {
+        yield* map(this.client.getProviders(cid, options), (record) => {
+            return {
+                id: record.ID,
+                multiaddrs: record.Addrs,
+                protocols: record.Protocols,
+                routing: 'delegated-http-routing'
+            };
+        });
+    }
+    async put(key, value, options) {
+        if (!isIPNSKey(key)) {
+            return;
+        }
+        const digest = Digest.decode(key.slice(IPNS_PREFIX.length));
+        const cid = CID.createV1(0x72, digest);
+        await this.client.putIPNS(cid, value, options);
+    }
+    async get(key, options) {
+        if (!isIPNSKey(key)) {
+            throw new NotFoundError('Not found');
+        }
+        const digest = Digest.decode(key.slice(IPNS_PREFIX.length));
+        const cid = CID.createV1(0x72, digest);
+        try {
+            return await this.client.getIPNS(cid, options);
+        }
+        catch (err) {
+            // BadResponseError is thrown when the response had no body, which means
+            // the record couldn't be found
+            if (err.name === 'BadResponseError') {
+                throw new NotFoundError('Not found');
+            }
+            throw err;
+        }
+    }
+    async findPeer(peerId, options) {
+        const peer = await first(this.client.getPeers(peerId, options));
+        if (peer != null) {
+            return {
+                id: peer.ID,
+                multiaddrs: peer.Addrs ?? []
+            };
+        }
+        throw new NotFoundError('Not found');
+    }
+    async *getClosestPeers(key, options) {
+        // noop
+    }
+    toString() {
+        return `DelegatedHTTPRouter(${this.client.url})`;
+    }
+}
+//# sourceMappingURL=delegated-routing-router.js.map

package/dist/src/delegated-routing-router.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,10 @@
+import { delegatedHTTPRoutingDefaults } from './utils/delegated-http-routing-defaults.ts';
+import type { DelegatedRoutingV1HttpApiClientInit } from '@helia/delegated-routing-v1-http-api-client';
+import type { Router } from '@helia/interface';
+export { delegatedHTTPRoutingDefaults };
+export type { DelegatedRoutingV1HttpApiClientInit };
+/**
+ * Creates a Helia Router that connects to an endpoint that supports the [Delegated Routing V1 HTTP API](https://specs.ipfs.tech/routing/http-routing-v1/) spec.
+ */
+export declare function delegatedHTTPRouter(init: DelegatedRoutingV1HttpApiClientInit): (components: any) => Router;
+//# 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":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAA;AACzF,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,6CAA6C,CAAA;AACtG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,EAAE,4BAA4B,EAAE,CAAA;AACvC,YAAY,EAAE,mCAAmC,EAAE,CAAA;AAEnD;;GAEG;AACH,wBAAgB,mBAAmB,CAAE,IAAI,EAAE,mCAAmC,GAAG,CAAC,UAAU,EAAE,GAAG,KAAK,MAAM,CAE3G"}

package/dist/src/index.js

@@ -0,0 +1,10 @@
+import { DelegatedHTTPRouter } from "./delegated-routing-router.js";
+import { delegatedHTTPRoutingDefaults } from "./utils/delegated-http-routing-defaults.js";
+export { delegatedHTTPRoutingDefaults };
+/**
+ * Creates a Helia Router that connects to an endpoint that supports the [Delegated Routing V1 HTTP API](https://specs.ipfs.tech/routing/http-routing-v1/) spec.
+ */
+export function delegatedHTTPRouter(init) {
+    return (components) => new DelegatedHTTPRouter(components, delegatedHTTPRoutingDefaults(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":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAA;AAIzF,OAAO,EAAE,4BAA4B,EAAE,CAAA;AAGvC;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAE,IAAyC;IAC5E,OAAO,CAAC,UAAe,EAAE,EAAE,CAAC,IAAI,mBAAmB,CAAC,UAAU,EAAE,4BAA4B,CAAC,IAAI,CAAC,CAAC,CAAA;AACrG,CAAC"}

package/dist/src/utils/delegated-http-routing-defaults.browser.d.ts

@@ -0,0 +1,3 @@
+import type { DelegatedRoutingV1HttpApiClientInit } from '@helia/delegated-routing-v1-http-api-client';
+export declare function delegatedHTTPRoutingDefaults(init?: DelegatedRoutingV1HttpApiClientInit): DelegatedRoutingV1HttpApiClientInit;
+//# sourceMappingURL=delegated-http-routing-defaults.browser.d.ts.map

package/dist/src/utils/delegated-http-routing-defaults.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegated-http-routing-defaults.browser.d.ts","sourceRoot":"","sources":["../../../src/utils/delegated-http-routing-defaults.browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,6CAA6C,CAAA;AAEtG,wBAAgB,4BAA4B,CAAE,IAAI,CAAC,EAAE,mCAAmC,GAAG,mCAAmC,CAM7H"}

package/dist/src/utils/delegated-http-routing-defaults.browser.js

@@ -0,0 +1,8 @@
+export function delegatedHTTPRoutingDefaults(init) {
+    return {
+        url: 'https://delegated-ipfs.dev',
+        filterProtocols: ['unknown', 'transport-bitswap', 'transport-ipfs-gateway-http'],
+        filterAddrs: ['https', 'webtransport', 'webrtc', 'webrtc-direct', 'wss', 'tls']
+    };
+}
+//# sourceMappingURL=delegated-http-routing-defaults.browser.js.map

package/dist/src/utils/delegated-http-routing-defaults.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegated-http-routing-defaults.browser.js","sourceRoot":"","sources":["../../../src/utils/delegated-http-routing-defaults.browser.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,4BAA4B,CAAE,IAA0C;IACtF,OAAO;QACL,GAAG,EAAE,4BAA4B;QACjC,eAAe,EAAE,CAAC,SAAS,EAAE,mBAAmB,EAAE,6BAA6B,CAAC;QAChF,WAAW,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC;KAChF,CAAA;AACH,CAAC"}

package/dist/src/utils/delegated-http-routing-defaults.d.ts

@@ -0,0 +1,3 @@
+import type { DelegatedRoutingV1HttpApiClientInit } from '@helia/delegated-routing-v1-http-api-client';
+export declare function delegatedHTTPRoutingDefaults(init?: DelegatedRoutingV1HttpApiClientInit): DelegatedRoutingV1HttpApiClientInit;
+//# sourceMappingURL=delegated-http-routing-defaults.d.ts.map

package/dist/src/utils/delegated-http-routing-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegated-http-routing-defaults.d.ts","sourceRoot":"","sources":["../../../src/utils/delegated-http-routing-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,6CAA6C,CAAA;AAEtG,wBAAgB,4BAA4B,CAAE,IAAI,CAAC,EAAE,mCAAmC,GAAG,mCAAmC,CAO7H"}

package/dist/src/utils/delegated-http-routing-defaults.js

@@ -0,0 +1,9 @@
+export function delegatedHTTPRoutingDefaults(init) {
+    return {
+        url: 'https://delegated-ipfs.dev',
+        filterProtocols: ['unknown', 'transport-bitswap', 'transport-ipfs-gateway-http'],
+        filterAddrs: ['https', 'tcp', 'webrtc', 'webrtc-direct', 'wss', 'tls'],
+        ...(init ?? {})
+    };
+}
+//# sourceMappingURL=delegated-http-routing-defaults.js.map

package/dist/src/utils/delegated-http-routing-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegated-http-routing-defaults.js","sourceRoot":"","sources":["../../../src/utils/delegated-http-routing-defaults.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,4BAA4B,CAAE,IAA0C;IACtF,OAAO;QACL,GAAG,EAAE,4BAA4B;QACjC,eAAe,EAAE,CAAC,SAAS,EAAE,mBAAmB,EAAE,6BAA6B,CAAC;QAChF,WAAW,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC;QACtE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;KAChB,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@helia/delegated-routing-client",
+  "version": "0.0.0-9114743f",
+  "description": "Use HTTP Delegated Routers with Helia",
+  "license": "Apache-2.0 OR MIT",
+  "homepage": "https://github.com/ipfs/helia/tree/main/packages/delegated-routing-client#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ipfs/helia.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ipfs/helia/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "keywords": [
+    "IPFS"
+  ],
+  "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",
+      "module-sync": "./dist/src/index.js"
+    }
+  },
+  "scripts": {
+    "clean": "aegir clean",
+    "lint": "aegir lint",
+    "dep-check": "aegir dep-check",
+    "doc-check": "aegir doc-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"
+  },
+  "dependencies": {
+    "@helia/delegated-routing-v1-http-api-client": "^8.0.0",
+    "@helia/interface": "6.2.1-9114743f",
+    "@libp2p/interface": "^3.2.3",
+    "it-first": "^3.0.11",
+    "it-map": "^3.1.6",
+    "multiformats": "^14.0.0",
+    "uint8arrays": "^6.1.1"
+  },
+  "devDependencies": {
+    "@libp2p/logger": "^6.2.8",
+    "@libp2p/peer-id": "^6.0.10",
+    "aegir": "^48.0.11",
+    "it-drain": "^3.0.12",
+    "sinon-ts": "^2.0.0"
+  },
+  "browser": {
+    "./dist/src/utils/delegated-http-routing-defaults.js": "./dist/src/utils/delegated-http-routing-defaults.browser.js"
+  },
+  "sideEffects": false
+}

package/src/delegated-routing-router.ts

@@ -0,0 +1,98 @@
+import { delegatedRoutingV1HttpApiClient } from '@helia/delegated-routing-v1-http-api-client'
+import { NotFoundError } from '@libp2p/interface'
+import first from 'it-first'
+import map from 'it-map'
+import { CID } from 'multiformats/cid'
+import * as Digest from 'multiformats/hashes/digest'
+import { equals as uint8ArrayEquals } from 'uint8arrays/equals'
+import { fromString as uint8ArrayFromString } from 'uint8arrays/from-string'
+import type { DelegatedRoutingV1HttpApiClient, DelegatedRoutingV1HttpApiClientComponents, DelegatedRoutingV1HttpApiClientInit } from '@helia/delegated-routing-v1-http-api-client'
+import type { Peer, Provider, Router, RoutingOptions } from '@helia/interface'
+import type { Version } from 'multiformats'
+
+const IPNS_PREFIX = uint8ArrayFromString('/ipns/')
+
+function isIPNSKey (key: Uint8Array): boolean {
+  return uint8ArrayEquals(key.subarray(0, IPNS_PREFIX.byteLength), IPNS_PREFIX)
+}
+
+export class DelegatedHTTPRouter implements Router {
+  public readonly name = 'delegated-http-router'
+  private readonly client: DelegatedRoutingV1HttpApiClient
+
+  constructor (components: DelegatedRoutingV1HttpApiClientComponents, init: DelegatedRoutingV1HttpApiClientInit) {
+    this.client = delegatedRoutingV1HttpApiClient(init)(components)
+  }
+
+  async provide (cid: CID, options?: RoutingOptions): Promise<void> {
+    // noop
+  }
+
+  async cancelReprovide (cid?: CID, options?: RoutingOptions): Promise<void> {
+    // noop
+  }
+
+  async * findProviders (cid: CID<unknown, number, number, Version>, options?: RoutingOptions): AsyncIterable<Provider> {
+    yield * map(this.client.getProviders(cid, options), (record) => {
+      return {
+        id: record.ID,
+        multiaddrs: record.Addrs,
+        protocols: record.Protocols,
+        routing: 'delegated-http-routing'
+      }
+    })
+  }
+
+  async put (key: Uint8Array, value: Uint8Array, options?: RoutingOptions): Promise<void> {
+    if (!isIPNSKey(key)) {
+      return
+    }
+
+    const digest = Digest.decode(key.slice(IPNS_PREFIX.length))
+    const cid = CID.createV1(0x72, digest)
+
+    await this.client.putIPNS(cid, value, options)
+  }
+
+  async get (key: Uint8Array, options?: RoutingOptions): Promise<Uint8Array> {
+    if (!isIPNSKey(key)) {
+      throw new NotFoundError('Not found')
+    }
+
+    const digest = Digest.decode(key.slice(IPNS_PREFIX.length))
+    const cid = CID.createV1(0x72, digest)
+
+    try {
+      return await this.client.getIPNS(cid, options)
+    } catch (err: any) {
+      // BadResponseError is thrown when the response had no body, which means
+      // the record couldn't be found
+      if (err.name === 'BadResponseError') {
+        throw new NotFoundError('Not found')
+      }
+
+      throw err
+    }
+  }
+
+  async findPeer (peerId: CID, options?: RoutingOptions): Promise<Peer> {
+    const peer = await first(this.client.getPeers(peerId, options))
+
+    if (peer != null) {
+      return {
+        id: peer.ID,
+        multiaddrs: peer.Addrs ?? []
+      }
+    }
+
+    throw new NotFoundError('Not found')
+  }
+
+  async * getClosestPeers (key: Uint8Array, options?: RoutingOptions): AsyncIterable<Peer> {
+    // noop
+  }
+
+  toString (): string {
+    return `DelegatedHTTPRouter(${this.client.url})`
+  }
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+import { DelegatedHTTPRouter } from './delegated-routing-router.ts'
+import { delegatedHTTPRoutingDefaults } from './utils/delegated-http-routing-defaults.ts'
+import type { DelegatedRoutingV1HttpApiClientInit } from '@helia/delegated-routing-v1-http-api-client'
+import type { Router } from '@helia/interface'
+
+export { delegatedHTTPRoutingDefaults }
+export type { DelegatedRoutingV1HttpApiClientInit }
+
+/**
+ * Creates a Helia Router that connects to an endpoint that supports the [Delegated Routing V1 HTTP API](https://specs.ipfs.tech/routing/http-routing-v1/) spec.
+ */
+export function delegatedHTTPRouter (init: DelegatedRoutingV1HttpApiClientInit): (components: any) => Router {
+  return (components: any) => new DelegatedHTTPRouter(components, delegatedHTTPRoutingDefaults(init))
+}

package/src/utils/delegated-http-routing-defaults.browser.ts

@@ -0,0 +1,9 @@
+import type { DelegatedRoutingV1HttpApiClientInit } from '@helia/delegated-routing-v1-http-api-client'
+
+export function delegatedHTTPRoutingDefaults (init?: DelegatedRoutingV1HttpApiClientInit): DelegatedRoutingV1HttpApiClientInit {
+  return {
+    url: 'https://delegated-ipfs.dev',
+    filterProtocols: ['unknown', 'transport-bitswap', 'transport-ipfs-gateway-http'],
+    filterAddrs: ['https', 'webtransport', 'webrtc', 'webrtc-direct', 'wss', 'tls']
+  }
+}

package/src/utils/delegated-http-routing-defaults.ts

@@ -0,0 +1,10 @@
+import type { DelegatedRoutingV1HttpApiClientInit } from '@helia/delegated-routing-v1-http-api-client'
+
+export function delegatedHTTPRoutingDefaults (init?: DelegatedRoutingV1HttpApiClientInit): DelegatedRoutingV1HttpApiClientInit {
+  return {
+    url: 'https://delegated-ipfs.dev',
+    filterProtocols: ['unknown', 'transport-bitswap', 'transport-ipfs-gateway-http'],
+    filterAddrs: ['https', 'tcp', 'webrtc', 'webrtc-direct', 'wss', 'tls'],
+    ...(init ?? {})
+  }
+}