@pkcprotocol/pkc-js 0.0.74 → 0.0.75

package/dist/node/schema.d.ts

@@ -45,6 +45,10 @@ export declare const PKCUserOptionBaseSchema: z.ZodObject<{
         key: z.ZodString;
         libp2pOptions: z.ZodDefault<z.ZodCustom<libp2pOptions, libp2pOptions>>;
         heliaOptions: z.ZodDefault<z.ZodCustom<Partial<Partial<import("helia").HeliaInit<import("libp2p").Libp2p<import("helia").DefaultLibp2pServices>>> | undefined>, Partial<Partial<import("helia").HeliaInit<import("libp2p").Libp2p<import("helia").DefaultLibp2pServices>>> | undefined>>>;
+        blockstoreOptions: z.ZodOptional<z.ZodObject<{
+            maxBytes: z.ZodOptional<z.ZodNumber>;
+            lowWaterRatio: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
     validatePages: z.ZodBoolean;
     userAgent: z.ZodString;
@@ -294,6 +298,10 @@ export declare const PKCUserOptionsSchema: z.ZodPipe<z.ZodObject<{
         key: z.ZodString;
         libp2pOptions: z.ZodDefault<z.ZodCustom<libp2pOptions, libp2pOptions>>;
         heliaOptions: z.ZodDefault<z.ZodCustom<Partial<Partial<import("helia").HeliaInit<import("libp2p").Libp2p<import("helia").DefaultLibp2pServices>>> | undefined>, Partial<Partial<import("helia").HeliaInit<import("libp2p").Libp2p<import("helia").DefaultLibp2pServices>>> | undefined>>>;
+        blockstoreOptions: z.ZodOptional<z.ZodObject<{
+            maxBytes: z.ZodOptional<z.ZodNumber>;
+            lowWaterRatio: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
     challenges: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCustom<z.core.$InferInnerFunctionType<z.ZodTuple<readonly [z.ZodObject<{
         challengeSettings: z.ZodObject<{
@@ -555,6 +563,10 @@ export declare const PKCUserOptionsSchema: z.ZodPipe<z.ZodObject<{
         key: string;
         libp2pOptions: libp2pOptions;
         heliaOptions: Partial<Partial<import("helia").HeliaInit<import("libp2p").Libp2p<import("helia").DefaultLibp2pServices>>>>;
+        blockstoreOptions?: {
+            maxBytes?: number | undefined;
+            lowWaterRatio?: number | undefined;
+        } | undefined;
     }[] | undefined;
     challenges?: Record<string, z.core.$InferInnerFunctionType<z.ZodTuple<readonly [z.ZodObject<{
         challengeSettings: z.ZodObject<{
@@ -691,6 +703,10 @@ export declare const PKCUserOptionsSchema: z.ZodPipe<z.ZodObject<{
         key: string;
         libp2pOptions: libp2pOptions;
         heliaOptions: Partial<Partial<import("helia").HeliaInit<import("libp2p").Libp2p<import("helia").DefaultLibp2pServices>>>>;
+        blockstoreOptions?: {
+            maxBytes?: number | undefined;
+            lowWaterRatio?: number | undefined;
+        } | undefined;
     }[] | undefined;
     challenges?: Record<string, z.core.$InferInnerFunctionType<z.ZodTuple<readonly [z.ZodObject<{
         challengeSettings: z.ZodObject<{
@@ -820,6 +836,10 @@ export declare const PKCParsedOptionsSchema: z.ZodObject<{
         key: z.ZodString;
         libp2pOptions: z.ZodDefault<z.ZodCustom<libp2pOptions, libp2pOptions>>;
         heliaOptions: z.ZodDefault<z.ZodCustom<Partial<Partial<import("helia").HeliaInit<import("libp2p").Libp2p<import("helia").DefaultLibp2pServices>>> | undefined>, Partial<Partial<import("helia").HeliaInit<import("libp2p").Libp2p<import("helia").DefaultLibp2pServices>>> | undefined>>>;
+        blockstoreOptions: z.ZodOptional<z.ZodObject<{
+            maxBytes: z.ZodOptional<z.ZodNumber>;
+            lowWaterRatio: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
     validatePages: z.ZodBoolean;
     userAgent: z.ZodString;

package/dist/node/schema.js

@@ -52,7 +52,17 @@ export const PKCUserOptionBaseSchema = z.object({
         .object({
         key: z.string().min(1),
         libp2pOptions: z.custom().default({}),
-        heliaOptions: z.custom().default({})
+        heliaOptions: z.custom().default({}),
+        // Size cap for the libp2p-js block cache. Defaults per runtime (see
+        // runtime/{node,browser}/blockstore.ts) and is ignored when heliaOptions.blockstore is
+        // supplied, since the caller then owns block storage entirely.
+        blockstoreOptions: z
+            .object({
+            maxBytes: z.number().positive().optional(),
+            // evict down to this fraction of maxBytes when the cap is hit
+            lowWaterRatio: z.number().gt(0).lte(1).optional()
+        })
+            .optional()
     })
         .array()
         .max(1, "Only one libp2pJsClientOptions is allowed at the moment")

package/dist/node/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,+BAA+B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,OAAO,MAAM,cAAc,CAAC;AAMnC,gEAAgE;AAEhE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CACpC,CAAC,KAAK,EAAwC,EAAE,CAAC,KAAK,YAAY,UAAU,EAC5E,EAAE,OAAO,EAAE,qBAAqB,EAAE,CACrC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,sDAAsD,CAAC,CAAC;AAEhH,MAAM,YAAY,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,6CAA6C,CAAC,CAAC,CAAC,0GAA0G;AAExM,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,EAA6B,CAAC,CAAC,wDAAwD;AAEvI,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,+BAA+B;AAUvE,kHAAkH;AAClH,0DAA0D;AAC1D,gDAAgD;AAChD,qEAAqE;AACrE,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC;AAGH,6IAA6I;AAC7I,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CACtC,CAAC,GAAG,EAAE,EAAE;IACJ,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACzD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,OAAO,CACH,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;QACzB,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC;QAChB,OAAO,CAAC,CAAC,OAAO,KAAK,UAAU;QAC/B,OAAO,CAAC,CAAC,UAAU,KAAK,UAAU;QAClC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAC/D,CAAC;AACN,CAAC,EACD;IACI,OAAO,EACH,gJAAgJ;CACvJ,CACJ,CAAC;AAEF,iHAAiH;AACjH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,mCAAmC,GAAG,+BAA+B,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CACtG,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAC/C,CAAC;AAEF,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,EAAwD,CAAC;AAa1G,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,eAAe,EAAE,oBAAoB,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IACxD,qBAAqB,EAAE,mCAAmC,CAAC,QAAQ,EAAE;IACrE,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,qDAAqD,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IACjI,2BAA2B,EAAE,mCAAmC,CAAC,QAAQ,EAAE;IAC3E,oBAAoB,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAChE,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACxC,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC/B,aAAa,EAAE,kBAAkB,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IACpD,sBAAsB,EAAE,CAAC;SACpB,MAAM,CAAC;QACJ,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACtB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAyB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,oEAAoE;QACpE,uFAAuF;QACvF,+DAA+D;QAC/D,iBAAiB,EAAE,CAAC;aACf,MAAM,CAAC;YACJ,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;YAC1C,8DAA8D;YAC9D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SACpD,CAAC;aACD,QAAQ,EAAE;KAClB,CAAC;SACD,KAAK,EAAE;SACP,GAAG,CAAC,CAAC,EAAE,yDAAyD,CAAC;SACjE,QAAQ,EAAE;IACf,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,8EAA8E;IAC1G,SAAS,EAAE,eAAe;IAC1B,2DAA2D;IAC3D,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,qFAAqF;IAC7H,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,gGAAgG;IACvI,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,+EAA+E;IACpG,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAA6B,CAAC,CAAC,QAAQ,EAAE,CAAC,yEAAyE;CAC/J,CAAC,CAAC;AAEH,MAAM,kCAAkC,GAAG;IACvC,EAAE,GAAG,EAAE,mCAAmC,EAAE;IAC5C,EAAE,GAAG,EAAE,+BAA+B,EAAE;CAClC,CAAC;AAEX,MAAM,sBAAsB,GAAG,CAAC,yBAAyB,EAAE,gCAAgC,EAAE,gCAAgC,CAAU,CAAC;AAExI,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC/D,yDAAyD;IACzD,eAAe,EAAE,uBAAuB,CAAC,KAAK,CAAC,eAAe;SACzD,OAAO,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC;SACpC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAChF,2BAA2B,EAAE,uBAAuB,CAAC,KAAK,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,GAAG,kCAAkC,CAAC,CAAC;IACvI,kBAAkB,EAAE,uBAAuB,CAAC,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC;QACzE,wBAAwB;QACxB,qBAAqB;QACrB,8BAA8B;QAC9B,8BAA8B;QAC9B,+BAA+B;QAC/B,2BAA2B;KAC9B,CAAC;IACF,kBAAkB,EAAE,uBAAuB,CAAC,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC;IAClF,eAAe,EAAE,uBAAuB,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC;IAC7E,cAAc,EAAE,uBAAuB,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3E,MAAM,EAAE,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3D,aAAa,EAAE,uBAAuB,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;IACxE,SAAS,EAAE,uBAAuB,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;CACjF,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;IAClB,IACI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,2BAA2B,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,kCAAkC,CAAC;QACvG,IAAI,CAAC,sBAAsB,EAC7B,CAAC;QACC,OAAO;YACH,GAAG,IAAI;YACP,2BAA2B,EAAE,EAA+E;SAC/G,CAAC;IACN,CAAC;;QAAM,OAAO,IAAI,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACjE,4DAA4D;IAC5D,qBAAqB,EAAE,gCAAgC,CAAC,QAAQ,EAAE;IAClE,2BAA2B,EAAE,gCAAgC,CAAC,QAAQ,EAAE;IACxE,aAAa,EAAE,kBAAkB,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@pkcprotocol/pkc-js",
-    "version": "0.0.74",
+    "version": "0.0.75",
     "type": "module",
     "scripts": {
         "prebuild": "node config/generate-version.js",
@@ -85,6 +85,8 @@
         "assert": "2.1.0",
         "better-sqlite3": "12.9.0",
         "blockstore-core": "7.0.1",
+        "blockstore-fs": "^4.0.1",
+        "blockstore-idb": "^4.0.1",
         "buffer": "6.0.3",
         "cbor": "10.0.11",
         "cborg": "4.5.8",
@@ -141,9 +143,9 @@
         "@types/retry": "0.12.5",
         "@types/tcp-port-used": "1.0.4",
         "@types/ws": "8.18.1",
-        "@vitest/browser-playwright": "4.0.15",
-        "@vitest/runner": "4.0.15",
-        "@vitest/ui": "4.0.15",
+        "@vitest/browser-playwright": "4.1.10",
+        "@vitest/runner": "4.1.10",
+        "@vitest/ui": "4.1.10",
         "chokidar": "3.5.3",
         "commitizen": "4.3.1",
         "cross-env": "7.0.3",
@@ -164,7 +166,8 @@
         "socket.io-client": "4.8.1",
         "tempy": "3.2.0",
         "typescript": "5.9.3",
-        "vitest": "4.0.15",
+        "vite": "7.3.2",
+        "vitest": "4.1.10",
         "wait-on": "9.0.5"
     },
     "description": "TypeScript SDK for PKC (Public Key Communities), a serverless, decentralized social protocol built on IPFS, IPNS, and libp2p pubsub. Powers all PKC clients: CLI, Electron desktop, and web.",

package/dist/bundled/chunks/helia-for-pkc-B-75U9z9.js

@@ -1,495 +0,0 @@
-import { L as hideClassPrivateProps, R as ipnsNameToIpnsOverPubsubTopic, _r as PKCError, yr as logger_default } from "./schema-B1Ot-kux.js";
-import { a as fetchBlockWithStalledSessionFailover, i as directFetchIpnsRecordFromProviders, n as cacheIpnsRecordInPubsubLocalStore, o as getHeliaDebugContext, r as connectToPubsubPeers, s as selectBitswapSessionSeedPeers } from "./util-B6v5HAdy.js";
-import { CID } from "multiformats/cid";
-import { peerIdFromString } from "@libp2p/peer-id";
-import { EventEmitter as EventEmitter$1 } from "events";
-import { createHelia, libp2pDefaults } from "helia";
-import { ipns } from "@helia/ipns";
-import { multihashToIPNSRoutingKey, unmarshalIPNSRecord } from "ipns";
-import { ipnsValidator } from "ipns/validator";
-import { gossipsub } from "@libp2p/gossipsub";
-import { identify } from "@libp2p/identify";
-import { bitswap } from "@helia/block-brokers";
-import { MemoryBlockstore } from "blockstore-core";
-import { delegatedRoutingV1HttpApiClientContentRouting } from "@helia/delegated-routing-v1-http-api-client";
-import { NotFoundError } from "@libp2p/interface";
-import { unixfs } from "@helia/unixfs";
-import { fetch } from "@libp2p/fetch";
-import { pubsub } from "@helia/ipns/routing";
-//#region dist/node/runtime/node/libp2p-extra-transports.js
-const extraLibp2pTransports = [];
-//#endregion
-//#region dist/node/helia/libp2pjsClient.js
-var Libp2pJsClient = class {
-	/**
-	* The running Helia node backing this libp2p-js client — the public, semver-covered way for
-	* consumers that share the node (e.g. @bitsocial/pubsub-voting, bitsocial-seeder) to reach it,
-	* instead of the private `_helia` field (issue #221).
-	*
-	* The returned node is guaranteed to carry, in addition to Helia's own surface:
-	* - `libp2p.services.pubsub` — the gossipsub service registered at node construction
-	* - `libp2p.services.fetch` — the `@libp2p/fetch` service registered at node construction
-	* - `blockstore` — the node's block storage (bitswap-backed retrieval)
-	* - `libp2p.contentRouting` — the delegated-routing aggregation over `httpRoutersOptions`
-	*
-	* A breaking change to what this accessor returns is a breaking pkc-js release.
-	*/
-	get heliaNode() {
-		return this._helia;
-	}
-	constructor(libp2pJsClientOptions) {
-		this._helia = libp2pJsClientOptions.helia;
-		this._heliaUnixfs = libp2pJsClientOptions.heliaUnixfs;
-		this._heliaIpnsRouter = libp2pJsClientOptions.heliaIpnsRouter;
-		this.heliaWithKuboRpcClientFunctions = libp2pJsClientOptions.heliaWithKuboRpcClientFunctions;
-		this._libp2pJsClientsOptions = libp2pJsClientOptions.libp2pJsClientsOptions;
-		this._mergedHeliaOptions = libp2pJsClientOptions.mergedHeliaOptions;
-		this.key = libp2pJsClientOptions.key;
-		this.countOfUsesOfInstance = libp2pJsClientOptions.countOfUsesOfInstance;
-		hideClassPrivateProps(this);
-	}
-};
-//#endregion
-//#region dist/node/helia/dial-transport-filter.js
-const DENIED_DIAL_TRANSPORTS_BY_DEFAULT = [
-	"webrtc",
-	"webrtc-direct",
-	"webtransport"
-];
-function multiaddrUsesDeniedTransport(multiaddr) {
-	const componentNames = multiaddr.getComponents().map((component) => component.name);
-	return DENIED_DIAL_TRANSPORTS_BY_DEFAULT.some((deniedProto) => componentNames.includes(deniedProto));
-}
-function createDefaultDialTransportGater() {
-	return { denyDialMultiaddr: (multiaddr) => multiaddrUsesDeniedTransport(multiaddr) };
-}
-//#endregion
-//#region dist/node/helia/helia-for-pkc.js
-const log = logger_default("pkc-js:libp2p-js");
-const libp2pJsClients = {};
-const creatingLibp2pJsClients = {};
-const DELEGATED_ROUTING_CONCURRENT_REQUESTS = 32;
-function getDelegatedRoutingFields(routers) {
-	const routersObj = {};
-	for (let i = 0; i < routers.length; i++) {
-		const factory = delegatedRoutingV1HttpApiClientContentRouting({
-			url: routers[i],
-			concurrentRequests: DELEGATED_ROUTING_CONCURRENT_REQUESTS
-		});
-		routersObj["delegatedRouting" + i] = (components) => {
-			const routing = factory(components);
-			routing.get = async () => {
-				throw new NotFoundError("pkc HTTP routers do not serve IPNS records");
-			};
-			routing.put = async () => {};
-			const routerUrl = routers[i];
-			const originalFindProviders = routing.findProviders.bind(routing);
-			routing.findProviders = async function* (cid, options) {
-				try {
-					yield* originalFindProviders(cid, options);
-				} catch (e) {
-					log.trace("Content router", routerUrl, "errored during findProviders; treating it as returning no providers", e);
-				}
-			};
-			return routing;
-		};
-	}
-	return routersObj;
-}
-async function createLibp2pJsClientOrUseExistingOne(pkcOptions) {
-	if (!pkcOptions.httpRoutersOptions?.length) throw Error("You need to have pkc.httpRouterOptions to set up helia");
-	const existingClient = libp2pJsClients[pkcOptions.key];
-	if (existingClient) {
-		existingClient.countOfUsesOfInstance++;
-		return existingClient;
-	}
-	const creatingClientPromise = creatingLibp2pJsClients[pkcOptions.key];
-	if (creatingClientPromise) {
-		const client = await creatingClientPromise;
-		client.countOfUsesOfInstance++;
-		return client;
-	}
-	creatingLibp2pJsClients[pkcOptions.key] = (async () => {
-		const mergedHeliaInit = {
-			libp2p: {
-				addresses: { listen: [] },
-				peerDiscovery: void 0,
-				transports: [...libp2pDefaults().transports ?? [], ...extraLibp2pTransports],
-				connectionMonitor: { abortConnectionOnPingFailure: false },
-				connectionGater: createDefaultDialTransportGater(),
-				...pkcOptions.libp2pOptions,
-				services: {
-					identify: identify(),
-					pubsub: gossipsub(),
-					fetch: fetch(),
-					...getDelegatedRoutingFields(pkcOptions.httpRoutersOptions),
-					...pkcOptions.libp2pOptions?.services
-				}
-			},
-			blockstore: new MemoryBlockstore(),
-			blockBrokers: [bitswap()],
-			start: false,
-			...pkcOptions.heliaOptions
-		};
-		const helia = await createHelia(mergedHeliaInit);
-		helia.routing.routers = helia.routing.routers.filter((r) => r.constructor.name !== "HTTPGatewayRouter");
-		log("Initialized libp2pjs helia with key", pkcOptions.key, "peer id", helia.libp2p.peerId.toString());
-		const pubsubEventHandler = new EventEmitter$1();
-		helia.libp2p.services.pubsub.addEventListener("message", (evt) => {
-			log.trace(`Event from helia libp2p pubsub: on pubsub topic (string, e.g. community address) ${evt.detail.topic}`);
-			const msgFormatted = {
-				data: evt.detail.data,
-				topic: evt.detail.topic,
-				type: evt.detail.type
-			};
-			pubsubEventHandler.emit(evt.detail.topic, msgFormatted);
-		});
-		const heliaFs = unixfs(helia);
-		const asHeliaCatCid = (ipfsPathOrCid) => {
-			CID.parse(ipfsPathOrCid.split("/")[0]);
-			return ipfsPathOrCid;
-		};
-		const MAX_BITSWAP_SESSION_SEED_PEERS = 3;
-		const getBitswapSessionSeedPeers = (scopeIpnsPubsubTopic) => {
-			const pubsub = helia.libp2p.services.pubsub;
-			return selectBitswapSessionSeedPeers({
-				connectedPeers: helia.libp2p.getPeers(),
-				scopedPubsubSubscriberPeerIdStrings: scopeIpnsPubsubTopic ? pubsub.getSubscribers(scopeIpnsPubsubTopic).map(String) : [],
-				pubsubSubscriberPeerIdStrings: pubsub.getTopics().flatMap((topic) => pubsub.getSubscribers(topic).map(String)),
-				maxSeeds: MAX_BITSWAP_SESSION_SEED_PEERS
-			});
-		};
-		const KUBO_DURATION_UNIT_TO_MS = {
-			ns: 1e-6,
-			us: .001,
-			µs: .001,
-			ms: 1,
-			s: 1e3,
-			m: 6e4,
-			h: 36e5
-		};
-		const parseKuboStyleTimeoutMs = (timeout) => {
-			if (timeout === void 0 || timeout === null) return void 0;
-			if (typeof timeout === "number" && Number.isFinite(timeout) && timeout > 0) return timeout;
-			if (typeof timeout === "string") {
-				let totalMs = 0;
-				let matchedLength = 0;
-				for (const component of timeout.matchAll(/(\d+(?:\.\d+)?)(ns|us|µs|ms|s|m|h)/g)) {
-					totalMs += parseFloat(component[1]) * KUBO_DURATION_UNIT_TO_MS[component[2]];
-					matchedLength += component[0].length;
-				}
-				if (matchedLength === timeout.length && totalMs > 0) return totalMs;
-			}
-			throw new PKCError("ERR_INVALID_KUBO_STYLE_TIMEOUT", { invalidTimeout: timeout });
-		};
-		const SESSION_NO_PROVIDERS_RETRY_BASE_DELAY_MS = 500;
-		const isCausedByInsufficientProviders = (error) => {
-			if (!(error instanceof Error)) return false;
-			if (error.name === "InsufficientProvidersError") return true;
-			if (error instanceof AggregateError && error.errors.some(isCausedByInsufficientProviders)) return true;
-			return isCausedByInsufficientProviders(error.cause);
-		};
-		const delayAbortable = (ms, signal) => new Promise((resolve) => {
-			if (signal.aborted) return resolve();
-			const onAbort = () => {
-				clearTimeout(timer);
-				resolve();
-			};
-			const timer = setTimeout(() => {
-				signal.removeEventListener("abort", onAbort);
-				resolve();
-			}, ms);
-			signal.addEventListener("abort", onAbort, { once: true });
-		});
-		const ipnsPubsubRouter = pubsub(helia);
-		const ipnsPubsubLocalStore = ipnsPubsubRouter.localStore;
-		const ipnsNameResolver = ipns(helia, { routers: [ipnsPubsubRouter] });
-		ipnsNameResolver.routers = ipnsNameResolver.routers.filter((r) => r?.constructor?.name !== "LocalStoreRouting");
-		const WARMUP_MAX_PEERS = 4;
-		const warmupPromisesByTopic = /* @__PURE__ */ new Map();
-		const warmupForTopic = (topic, options) => {
-			if (helia.libp2p.services.pubsub.getSubscribers(topic).length > 0) return Promise.resolve();
-			const existing = warmupPromisesByTopic.get(topic);
-			if (existing) return existing;
-			const p = connectToPubsubPeers({
-				helia,
-				pubsubTopic: topic,
-				maxPeers: WARMUP_MAX_PEERS,
-				options,
-				log: logger_default("pkc-js:helia:pubsub:warmup")
-			}).then(() => void 0).finally(() => {
-				warmupPromisesByTopic.delete(topic);
-			});
-			warmupPromisesByTopic.set(topic, p);
-			return p;
-		};
-		const throwIfHeliaIsStoppingOrStopped = () => {
-			if (helia.libp2p.status === "stopped" || helia.libp2p.status === "stopping") throw new PKCError("ERR_HELIAS_STOPPING_OR_STOPPED", {
-				heliaKey: pkcOptions.key,
-				helia,
-				...getHeliaDebugContext(helia)
-			});
-		};
-		const heliaWithKuboRpcClientShape = {
-			name: { resolve: (ipnsName, options) => {
-				throwIfHeliaIsStoppingOrStopped();
-				async function* generator() {
-					const currentName = typeof ipnsName === "string" ? ipnsName : ipnsName.toString();
-					const ipnsNameAsPeerId = peerIdFromString(currentName);
-					log.trace("Resolving ipns name", currentName, "with options", options);
-					const ipnsPubsubTopic = ipnsNameToIpnsOverPubsubTopic(ipnsNameAsPeerId.toString());
-					const routingKey = multihashToIPNSRoutingKey(ipnsNameAsPeerId.toMultihash());
-					let directFetchOutcome = { attempted: false };
-					{
-						if (!helia.libp2p.services.pubsub.getTopics().includes(ipnsPubsubTopic)) helia.libp2p.services.pubsub.subscribe(ipnsPubsubTopic);
-						warmupForTopic(ipnsPubsubTopic, options).catch((e) => log.trace("Fire-and-forget warmup failed for", ipnsPubsubTopic, e));
-						const directStart = Date.now();
-						try {
-							const direct = await directFetchIpnsRecordFromProviders({
-								helia,
-								pubsubTopic: ipnsPubsubTopic,
-								routingKey,
-								maxPeers: WARMUP_MAX_PEERS,
-								validate: ipnsValidator,
-								options,
-								log: logger_default("pkc-js:helia:ipns:direct-fetch")
-							});
-							if (direct) {
-								directFetchOutcome = {
-									attempted: true,
-									hit: true,
-									durationMs: direct.durationMs,
-									source: direct.source,
-									peerId: direct.peerId
-								};
-								const record = unmarshalIPNSRecord(direct.recordBytes);
-								try {
-									await cacheIpnsRecordInPubsubLocalStore({
-										localStore: ipnsPubsubLocalStore,
-										routingKey,
-										marshalledRecord: direct.recordBytes
-									});
-								} catch (cacheErr) {
-									log.trace("Failed to cache direct-fetched IPNS record at the pubsub routing layer for", ipnsPubsubTopic, cacheErr);
-								}
-								yield record.value;
-								return;
-							}
-							directFetchOutcome = {
-								attempted: true,
-								hit: false,
-								durationMs: Date.now() - directStart
-							};
-						} catch (directErr) {
-							if (options?.signal?.aborted) throw directErr;
-							directFetchOutcome = {
-								attempted: true,
-								hit: false,
-								durationMs: Date.now() - directStart,
-								error: directErr
-							};
-							log.trace("Direct IPNS fetch path errored for", ipnsPubsubTopic, directErr);
-						}
-					}
-					let warmupOutcome = { attempted: false };
-					if (helia.libp2p.services.pubsub.getSubscribers(ipnsPubsubTopic).length === 0) {
-						const warmupStart = Date.now();
-						try {
-							await warmupForTopic(ipnsPubsubTopic, options);
-							warmupOutcome = {
-								attempted: true,
-								durationMs: Date.now() - warmupStart,
-								subscribersAfterWarmup: helia.libp2p.services.pubsub.getSubscribers(ipnsPubsubTopic).length
-							};
-						} catch (warmupErr) {
-							warmupOutcome = {
-								attempted: true,
-								durationMs: Date.now() - warmupStart,
-								error: warmupErr
-							};
-							log.error("Pre-resolve peer warmup failed for", ipnsPubsubTopic, warmupErr);
-						}
-					}
-					let recordBytes;
-					const routerErrors = [];
-					for (const router of ipnsNameResolver.routers) try {
-						const got = await router.get(routingKey, {
-							...options,
-							validate: false
-						});
-						if (got) {
-							recordBytes = got;
-							break;
-						}
-					} catch (err) {
-						routerErrors.push(err);
-					}
-					if (!recordBytes) throw new PKCError("ERR_RESOLVED_IPNS_P2P_TO_UNDEFINED", {
-						ipnsName,
-						currentName,
-						ipnsPubsubTopic,
-						ipnsResolveOptions: options,
-						directFetchOutcome,
-						warmupOutcome,
-						routerErrors,
-						subscribersAtResolveTime: helia.libp2p.services.pubsub.getSubscribers(ipnsPubsubTopic).length,
-						httpRouters: pkcOptions.httpRoutersOptions,
-						...getHeliaDebugContext(helia)
-					});
-					await ipnsValidator(routingKey, recordBytes);
-					yield unmarshalIPNSRecord(recordBytes).value;
-				}
-				return generator();
-			} },
-			cat(ipfsPath, options) {
-				throwIfHeliaIsStoppingOrStopped();
-				const rootCid = CID.parse(ipfsPath.split("/")[0]);
-				const timeoutMs = parseKuboStyleTimeoutMs(options?.timeout);
-				const { bitswapSessionSeedScopeIpnsPubsubTopic, ...unixfsCatOptions } = options ?? {};
-				return (async function* () {
-					const controller = new AbortController();
-					const callerSignal = options?.signal;
-					const abortFromCallerSignal = () => controller.abort(callerSignal?.reason);
-					if (callerSignal?.aborted) abortFromCallerSignal();
-					else callerSignal?.addEventListener("abort", abortFromCallerSignal, { once: true });
-					const timeoutTimer = timeoutMs !== void 0 ? setTimeout(() => controller.abort(new PKCError("ERR_FETCH_CID_P2P_TIMEOUT", {
-						ipfsPath,
-						timeoutMs
-					})), timeoutMs) : void 0;
-					try {
-						for (let attempt = 0;; attempt++) {
-							const session = helia.blockstore.createSession(rootCid, { providers: getBitswapSessionSeedPeers(bitswapSessionSeedScopeIpnsPubsubTopic) });
-							const sessionGet = session.get.bind(session);
-							const fallbackGet = helia.blockstore.get.bind(helia.blockstore);
-							session.get = (blockCid, blockGetOptions) => fetchBlockWithStalledSessionFailover({
-								cid: blockCid,
-								sessionGet,
-								fallbackGet,
-								stallTimeoutMs: heliaWithKuboRpcClientShape._bitswapSessionStalledGetFailoverMs ?? 2500,
-								options: blockGetOptions,
-								log
-							});
-							let yieldedAnyBytes = false;
-							try {
-								const catIterable = unixfs({ blockstore: session }).cat(asHeliaCatCid(ipfsPath), {
-									...unixfsCatOptions,
-									signal: controller.signal
-								});
-								for await (const chunk of catIterable) {
-									yieldedAnyBytes = true;
-									yield chunk;
-								}
-								return;
-							} catch (catError) {
-								if (controller.signal.aborted) throw controller.signal.reason instanceof Error ? controller.signal.reason : catError;
-								if (yieldedAnyBytes || !isCausedByInsufficientProviders(catError)) throw catError;
-								log.trace("Bitswap session found no providers for", ipfsPath, "- retrying, attempt", attempt + 1);
-							} finally {
-								session.close();
-							}
-							await delayAbortable(Math.min(SESSION_NO_PROVIDERS_RETRY_BASE_DELAY_MS * 2 ** attempt, 8e3), controller.signal);
-							if (controller.signal.aborted) {
-								if (controller.signal.reason instanceof Error) throw controller.signal.reason;
-								throw new PKCError("ERR_FETCH_CID_P2P_TIMEOUT", {
-									ipfsPath,
-									timeoutMs
-								});
-							}
-						}
-					} finally {
-						if (timeoutTimer !== void 0) clearTimeout(timeoutTimer);
-						callerSignal?.removeEventListener("abort", abortFromCallerSignal);
-					}
-				})();
-			},
-			pubsub: {
-				ls: async () => helia.libp2p.services.pubsub.getTopics(),
-				peers: async (topic, options) => helia.libp2p.services.pubsub.getSubscribers(topic),
-				publish: async (topic, data, options) => {
-					throwIfHeliaIsStoppingOrStopped();
-					const wasAlreadySubscribed = helia.libp2p.services.pubsub.getTopics().includes(topic);
-					if (!wasAlreadySubscribed) helia.libp2p.services.pubsub.subscribe(topic);
-					try {
-						await warmupForTopic(topic, options);
-						log("Published new data to pubsub topic (string, e.g. community address)", topic, "Direct gossipsub recipients (libp2p peer IDs, NOT signer/community addresses):", (await helia.libp2p.services.pubsub.publish(topic, data)).recipients.map((p) => p.toString()));
-					} finally {
-						if (!wasAlreadySubscribed) helia.libp2p.services.pubsub.unsubscribe(topic);
-					}
-				},
-				subscribe: async (topic, handler, options) => {
-					throwIfHeliaIsStoppingOrStopped();
-					pubsubEventHandler.on(topic, handler);
-					const warmupPromise = warmupForTopic(topic, options);
-					helia.libp2p.services.pubsub.subscribe(topic);
-					await warmupPromise;
-				},
-				unsubscribe: async (topic, handler, options) => {
-					throwIfHeliaIsStoppingOrStopped();
-					pubsubEventHandler.removeListener(topic, handler);
-					if (pubsubEventHandler.listenerCount(topic) === 0) helia.libp2p.services.pubsub.unsubscribe(topic);
-				}
-			},
-			async add(entry, options) {
-				throw Error("Helia 'add' is not supported at the moment in pkc-js API");
-			},
-			async stop(options) {
-				const clientFromMap = libp2pJsClients[pkcOptions.key];
-				if (!clientFromMap) return;
-				if (clientFromMap.countOfUsesOfInstance <= 0) return;
-				clientFromMap.countOfUsesOfInstance--;
-				if (clientFromMap.countOfUsesOfInstance === 0) {
-					delete libp2pJsClients[pkcOptions.key];
-					for (const router of ipnsNameResolver.routers) {
-						const lifecycle = router;
-						if (typeof lifecycle.stop === "function") try {
-							await lifecycle.stop();
-						} catch (e) {
-							log.error("Error stopping IPNS router", router?.constructor?.name, e);
-						}
-					}
-					for (const topic of helia.libp2p.services.pubsub.getTopics()) helia.libp2p.services.pubsub.unsubscribe(topic);
-					for (const connection of helia.libp2p.getConnections()) try {
-						connection.abort(/* @__PURE__ */ new Error("pkc-js libp2p instance is stopping"));
-					} catch (e) {
-						log.error("Error aborting libp2p connection during stop", e);
-					}
-					try {
-						await helia.stop();
-					} catch (e) {
-						log.error("Error stopping helia", e);
-					}
-					log("Helia/libp2p-js stopped with key", pkcOptions.key, "and peer id", helia.libp2p.peerId.toString());
-				}
-			}
-		};
-		const originalSubscribe = helia.libp2p.services.pubsub.subscribe.bind(helia.libp2p.services.pubsub);
-		helia.libp2p.services.pubsub.subscribe = (topic) => {
-			throwIfHeliaIsStoppingOrStopped();
-			warmupForTopic(topic).catch((err) => log.error("warmup failed for topic", topic, err));
-			originalSubscribe(topic);
-		};
-		const client = new Libp2pJsClient({
-			helia,
-			heliaWithKuboRpcClientFunctions: heliaWithKuboRpcClientShape,
-			heliaUnixfs: heliaFs,
-			heliaIpnsRouter: ipnsNameResolver,
-			mergedHeliaOptions: mergedHeliaInit,
-			countOfUsesOfInstance: 1,
-			libp2pJsClientsOptions: pkcOptions,
-			key: pkcOptions.key
-		});
-		await helia.start();
-		log("Helia/libp2p-js started with key", pkcOptions.key, "and peer id", helia.libp2p.peerId.toString());
-		libp2pJsClients[pkcOptions.key] = client;
-		return client;
-	})();
-	const createdClientPromise = creatingLibp2pJsClients[pkcOptions.key];
-	if (!createdClientPromise) throw new Error("Missing creation promise after initialization");
-	try {
-		return await createdClientPromise;
-	} finally {
-		delete creatingLibp2pJsClients[pkcOptions.key];
-	}
-}
-//#endregion
-export { createLibp2pJsClientOrUseExistingOne };