@pkcprotocol/pkc-js 0.0.106 → 0.0.108

package/dist/bundled/chunks/{helia-for-pkc-qvcQHRw5.js → helia-for-pkc-BY1wF9W8.js}

@@ -1,19 +1,21 @@
 import { i as __toESM, r as __require, t as __commonJSMin } from "./chunk-2rV9d50f.js";
-import { B as hideClassPrivateProps, Er as logger_default, H as ipnsNameToIpnsOverPubsubTopic, wr as PKCError, x as binaryKeyToPubsubTopic } from "./schema-B4n6Xctr.js";
-import { a as fetchBlockWithStalledSessionFailover, c as selectBitswapSessionSeedPeers, i as directFetchIpnsRecordFromProviders, n as cacheIpnsRecordInPubsubLocalStore, o as getHeliaDebugContext, r as connectToPubsubPeers, s as readFreshCachedIpnsRecordFromPubsubLocalStore } from "./util-DUR-gvDQ.js";
+import { Ar as PKCError, Mr as logger_default, S as hideClassPrivateProps, n as binaryKeyToPubsubTopic, w as ipnsNameToIpnsOverPubsubTopic } from "./util-C6zDjhpr.js";
+import { a as directFetchIpnsRecordFromProviders, c as readFreshCachedIpnsRecordFromPubsubLocalStore, i as connectToPubsubPeers, l as selectBitswapSessionSeedPeers, n as REACHABILITY_DOCS_URL, o as fetchBlockWithStalledSessionFailover, r as cacheIpnsRecordInPubsubLocalStore, s as getHeliaDebugContext, u as summarizeProviderReachability } from "./util-B-wz3mKY.js";
 import { t as map } from "./src-Cpx2Sts8.js";
 import { t as parallelBatch } from "./src-DKntVmyX.js";
 import { fileURLToPath } from "node:url";
 import fsp, { rename, writeFile } from "node:fs/promises";
-import Path, { basename, dirname, join } from "node:path";
-import path from "path";
+import path, { basename, dirname, join } from "node:path";
+import path$1 from "path";
 import { CID } from "multiformats/cid";
 import { peerIdFromString } from "@libp2p/peer-id";
 import * as Digest from "multiformats/hashes/digest";
 import { base32, base32upper } from "multiformats/bases/base32";
 import { EventEmitter as EventEmitter$1 } from "events";
+import { ipnsSelector } from "ipns/selector";
 import { ipnsValidator } from "ipns/validator";
 import { multihashToIPNSRoutingKey, unmarshalIPNSRecord } from "ipns";
+import { equals } from "uint8arrays/equals";
 import { createHeliaLight } from "helia";
 import { libp2pDefaults, withLibp2p } from "@helia/libp2p";
 import { withBitswap } from "@helia/bitswap";
@@ -149,7 +151,7 @@ var require_path = /* @__PURE__ */ __commonJSMin(((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.convertPosixPathToPattern = exports.convertWindowsPathToPattern = exports.convertPathToPattern = exports.escapePosixPath = exports.escapeWindowsPath = exports.escape = exports.removeLeadingDotSegment = exports.makeAbsolute = exports.unixify = void 0;
 	const os$1 = __require("os");
-	const path$9 = __require("path");
+	const path$10 = __require("path");
 	const IS_WINDOWS_PLATFORM = os$1.platform() === "win32";
 	const LEADING_DOT_SEGMENT_CHARACTERS_COUNT = 2;
 	/**
@@ -178,7 +180,7 @@ var require_path = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.unixify = unixify;
 	function makeAbsolute(cwd, filepath) {
-		return path$9.resolve(cwd, filepath);
+		return path$10.resolve(cwd, filepath);
 	}
 	exports.makeAbsolute = makeAbsolute;
 	function removeLeadingDotSegment(entry) {
@@ -1430,7 +1432,7 @@ var require_braces = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 //#endregion
 //#region node_modules/picomatch/lib/constants.js
 var require_constants$1 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
-	const path$8 = __require("path");
+	const path$9 = __require("path");
 	const WIN_SLASH = "\\\\/";
 	const WIN_NO_SLASH = `[^${WIN_SLASH}]`;
 	const DEFAULT_MAX_EXTGLOB_RECURSION = 0;
@@ -1555,7 +1557,7 @@ var require_constants$1 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		CHAR_UNDERSCORE: 95,
 		CHAR_VERTICAL_LINE: 124,
 		CHAR_ZERO_WIDTH_NOBREAK_SPACE: 65279,
-		SEP: path$8.sep,
+		SEP: path$9.sep,
 		/**
 		* Create EXTGLOB_CHARS
 		*/
@@ -1599,7 +1601,7 @@ var require_constants$1 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 //#endregion
 //#region node_modules/picomatch/lib/utils.js
 var require_utils$2 = /* @__PURE__ */ __commonJSMin(((exports) => {
-	const path$7 = __require("path");
+	const path$8 = __require("path");
 	const win32 = process.platform === "win32";
 	const { REGEX_BACKSLASH, REGEX_REMOVE_BACKSLASH, REGEX_SPECIAL_CHARS, REGEX_SPECIAL_CHARS_GLOBAL } = require_constants$1();
 	exports.isObject = (val) => val !== null && typeof val === "object" && !Array.isArray(val);
@@ -1619,7 +1621,7 @@ var require_utils$2 = /* @__PURE__ */ __commonJSMin(((exports) => {
 	};
 	exports.isWindows = (options) => {
 		if (options && typeof options.windows === "boolean") return options.windows;
-		return win32 === true || path$7.sep === "\\";
+		return win32 === true || path$8.sep === "\\";
 	};
 	exports.escapeLast = (input, char, lastIdx) => {
 		const idx = input.lastIndexOf(char, lastIdx);
@@ -2989,7 +2991,7 @@ var require_parse = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 //#endregion
 //#region node_modules/picomatch/lib/picomatch.js
 var require_picomatch$1 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
-	const path$6 = __require("path");
+	const path$7 = __require("path");
 	const scan = require_scan();
 	const parse = require_parse();
 	const utils = require_utils$2();
@@ -3128,7 +3130,7 @@ var require_picomatch$1 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	* @api public
 	*/
 	picomatch.matchBase = (input, glob, options, posix = utils.isWindows(options)) => {
-		return (glob instanceof RegExp ? glob : picomatch.makeRe(glob, options)).test(path$6.basename(input));
+		return (glob instanceof RegExp ? glob : picomatch.makeRe(glob, options)).test(path$7.basename(input));
 	};
 	/**
 	* Returns true if **any** of the given glob `patterns` match the specified `string`.
@@ -3683,7 +3685,7 @@ var require_micromatch = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 var require_pattern = /* @__PURE__ */ __commonJSMin(((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.isAbsolute = exports.partitionAbsoluteAndRelative = exports.removeDuplicateSlashes = exports.matchAny = exports.convertPatternsToRe = exports.makeRe = exports.getPatternParts = exports.expandBraceExpansion = exports.expandPatternsWithBraceExpansion = exports.isAffectDepthOfReadingPattern = exports.endsWithSlashGlobStar = exports.hasGlobStar = exports.getBaseDirectory = exports.isPatternRelatedToParentDirectory = exports.getPatternsOutsideCurrentDirectory = exports.getPatternsInsideCurrentDirectory = exports.getPositivePatterns = exports.getNegativePatterns = exports.isPositivePattern = exports.isNegativePattern = exports.convertToNegativePattern = exports.convertToPositivePattern = exports.isDynamicPattern = exports.isStaticPattern = void 0;
-	const path$5 = __require("path");
+	const path$6 = __require("path");
 	const globParent = require_glob_parent();
 	const micromatch = require_micromatch();
 	const GLOBSTAR = "**";
@@ -3791,7 +3793,7 @@ var require_pattern = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.endsWithSlashGlobStar = endsWithSlashGlobStar;
 	function isAffectDepthOfReadingPattern(pattern) {
-		const basename = path$5.basename(pattern);
+		const basename = path$6.basename(pattern);
 		return endsWithSlashGlobStar(pattern) || isStaticPattern(basename);
 	}
 	exports.isAffectDepthOfReadingPattern = isAffectDepthOfReadingPattern;
@@ -3865,7 +3867,7 @@ var require_pattern = /* @__PURE__ */ __commonJSMin(((exports) => {
 	}
 	exports.partitionAbsoluteAndRelative = partitionAbsoluteAndRelative;
 	function isAbsolute(pattern) {
-		return path$5.isAbsolute(pattern);
+		return path$6.isAbsolute(pattern);
 	}
 	exports.isAbsolute = isAbsolute;
 }));
@@ -4493,7 +4495,7 @@ var require_fs = /* @__PURE__ */ __commonJSMin(((exports) => {
 //#region node_modules/@nodelib/fs.scandir/out/settings.js
 var require_settings$2 = /* @__PURE__ */ __commonJSMin(((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
-	const path$4 = __require("path");
+	const path$5 = __require("path");
 	const fsStat = require_out$3();
 	const fs = require_fs();
 	var Settings = class {
@@ -4501,7 +4503,7 @@ var require_settings$2 = /* @__PURE__ */ __commonJSMin(((exports) => {
 			this._options = _options;
 			this.followSymbolicLinks = this._getValue(this._options.followSymbolicLinks, false);
 			this.fs = fs.createFileSystemAdapter(this._options.fs);
-			this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path$4.sep);
+			this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path$5.sep);
 			this.stats = this._getValue(this._options.stats, false);
 			this.throwErrorOnBrokenSymbolicLink = this._getValue(this._options.throwErrorOnBrokenSymbolicLink, true);
 			this.fsStatSettings = new fsStat.Settings({
@@ -5095,7 +5097,7 @@ var require_sync$2 = /* @__PURE__ */ __commonJSMin(((exports) => {
 //#region node_modules/@nodelib/fs.walk/out/settings.js
 var require_settings$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
-	const path$3 = __require("path");
+	const path$4 = __require("path");
 	const fsScandir = require_out$2();
 	var Settings = class {
 		constructor(_options = {}) {
@@ -5105,7 +5107,7 @@ var require_settings$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
 			this.deepFilter = this._getValue(this._options.deepFilter, null);
 			this.entryFilter = this._getValue(this._options.entryFilter, null);
 			this.errorFilter = this._getValue(this._options.errorFilter, null);
-			this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path$3.sep);
+			this.pathSegmentSeparator = this._getValue(this._options.pathSegmentSeparator, path$4.sep);
 			this.fsScandirSettings = new fsScandir.Settings({
 				followSymbolicLinks: this._options.followSymbolicLinks,
 				fs: this._options.fs,
@@ -5157,7 +5159,7 @@ var require_out$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
 //#region node_modules/fast-glob/out/readers/reader.js
 var require_reader = /* @__PURE__ */ __commonJSMin(((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
-	const path$2 = __require("path");
+	const path$3 = __require("path");
 	const fsStat = require_out$3();
 	const utils = require_utils$1();
 	var Reader = class {
@@ -5170,7 +5172,7 @@ var require_reader = /* @__PURE__ */ __commonJSMin(((exports) => {
 			});
 		}
 		_getFullEntryPath(filepath) {
-			return path$2.resolve(this._settings.cwd, filepath);
+			return path$3.resolve(this._settings.cwd, filepath);
 		}
 		_makeEntry(stats, pattern) {
 			const entry = {
@@ -5505,7 +5507,7 @@ var require_entry = /* @__PURE__ */ __commonJSMin(((exports) => {
 //#region node_modules/fast-glob/out/providers/provider.js
 var require_provider = /* @__PURE__ */ __commonJSMin(((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
-	const path$1 = __require("path");
+	const path$2 = __require("path");
 	const deep_1 = require_deep();
 	const entry_1 = require_entry$1();
 	const error_1 = require_error();
@@ -5519,7 +5521,7 @@ var require_provider = /* @__PURE__ */ __commonJSMin(((exports) => {
 			this.entryTransformer = new entry_2.default(this._settings);
 		}
 		_getRootDirectory(task) {
-			return path$1.resolve(this._settings.cwd, task.base);
+			return path$2.resolve(this._settings.cwd, task.base);
 		}
 		_getReaderOptions(task) {
 			const basePath = task.base === "." ? "" : task.base;
@@ -5850,7 +5852,7 @@ var import_out = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((export
 * Async iterable filename pattern matcher
 */
 async function* glob(dir, pattern, options = {}) {
-	const absoluteDir = Path.resolve(dir);
+	const absoluteDir = path.resolve(dir);
 	const stats = await fsp.stat(absoluteDir);
 	for await (const entry of import_out.default.stream(pattern, {
 		...options,
@@ -6020,7 +6022,7 @@ var NextToLast = class {
 		};
 	}
 	decode(str) {
-		let fileName = Path.basename(str);
+		let fileName = path.basename(str);
 		if (fileName.endsWith(this.extension)) fileName = fileName.substring(0, fileName.length - this.extension.length);
 		return CID.decode(this.base.decoder.decode(fileName));
 	}
@@ -6046,7 +6048,7 @@ var NextToLast = class {
 async function writeFile$1(file, contents, options) {
 	try {
 		options?.signal?.throwIfAborted();
-		await raceSignal(fsp.mkdir(Path.dirname(file), { recursive: true }), options?.signal);
+		await raceSignal(fsp.mkdir(path.dirname(file), { recursive: true }), options?.signal);
 		const writer = new Writer(file);
 		options?.signal?.throwIfAborted();
 		await writer.write(contents);
@@ -6071,7 +6073,7 @@ var FsBlockstore = class {
 	deleteManyConcurrency;
 	shardingStrategy;
 	constructor(location, init = {}) {
-		this.path = Path.resolve(location);
+		this.path = path.resolve(location);
 		this.createIfMissing = init.createIfMissing ?? true;
 		this.errorIfExists = init.errorIfExists ?? false;
 		this.deleteManyConcurrency = init.deleteManyConcurrency ?? 50;
@@ -6097,7 +6099,7 @@ var FsBlockstore = class {
 	async put(key, val, options) {
 		const { dir, file } = this.shardingStrategy.encode(key);
 		try {
-			await writeFile$1(Path.join(this.path, dir, file), val, options);
+			await writeFile$1(path.join(this.path, dir, file), val, options);
 			return key;
 		} catch (err) {
 			throw new PutFailedError(String(err));
@@ -6116,7 +6118,7 @@ var FsBlockstore = class {
 		let handle;
 		try {
 			options?.signal?.throwIfAborted();
-			handle = await raceSignal(fsp.open(Path.join(this.path, dir, file)), options?.signal);
+			handle = await raceSignal(fsp.open(path.join(this.path, dir, file)), options?.signal);
 			yield* handle.createReadStream();
 		} catch (err) {
 			if (handle != null) await raceSignal(handle.close(), options?.signal);
@@ -6137,7 +6139,7 @@ var FsBlockstore = class {
 		const { dir, file } = this.shardingStrategy.encode(key);
 		try {
 			options?.signal?.throwIfAborted();
-			await raceSignal(fsp.unlink(Path.join(this.path, dir, file)), options?.signal);
+			await raceSignal(fsp.unlink(path.join(this.path, dir, file)), options?.signal);
 		} catch (err) {
 			if (err.code === "ENOENT") return;
 			throw new DeleteFailedError(String(err));
@@ -6155,14 +6157,14 @@ var FsBlockstore = class {
 		const { dir, file } = this.shardingStrategy.encode(key);
 		try {
 			options?.signal?.throwIfAborted();
-			await raceSignal(fsp.access(Path.join(this.path, dir, file)), options?.signal);
+			await raceSignal(fsp.access(path.join(this.path, dir, file)), options?.signal);
 		} catch (err) {
 			return false;
 		}
 		return true;
 	}
 	async *getAll(options) {
-		const pattern = `**/*${this.shardingStrategy.extension}`.split(Path.sep).join("/");
+		const pattern = `**/*${this.shardingStrategy.extension}`.split(path.sep).join("/");
 		const files = glob(this.path, pattern, { absolute: true });
 		for await (const file of files) try {
 			options?.signal?.throwIfAborted();
@@ -6214,7 +6216,7 @@ async function createBlockstoreForLibp2pJsClient({ dataPath, key }) {
 		defaultMaxBytes: DEFAULT_IN_MEMORY_BLOCKSTORE_MAX_BYTES,
 		close: async () => {}
 	};
-	const store = new FsBlockstore(path.join(dataPath, "blockstore", key));
+	const store = new FsBlockstore(path$1.join(dataPath, "blockstore", key));
 	await store.open();
 	return {
 		blockstore: store,
@@ -6654,9 +6656,31 @@ async function createLibp2pJsClientOrUseExistingOne(pkcOptions) {
 		});
 		const ipnsRecordArrivalListeners = /* @__PURE__ */ new Map();
 		const originalLocalStorePut = ipnsPubsubLocalStore.put.bind(ipnsPubsubLocalStore);
+		const originalLocalStoreHas = ipnsPubsubLocalStore.has.bind(ipnsPubsubLocalStore);
+		const originalLocalStoreGet = ipnsPubsubLocalStore.get.bind(ipnsPubsubLocalStore);
+		const localStoreWriteTailByTopic = /* @__PURE__ */ new Map();
 		ipnsPubsubLocalStore.put = async (routingKey, marshalledRecord, options) => {
-			await originalLocalStorePut(routingKey, marshalledRecord, options);
 			const pubsubTopic = binaryKeyToPubsubTopic(routingKey);
+			const previousWrite = localStoreWriteTailByTopic.get(pubsubTopic) ?? Promise.resolve();
+			let releaseWrite;
+			const thisWriteDone = new Promise((resolve) => releaseWrite = resolve);
+			const thisWrite = previousWrite.then(() => thisWriteDone);
+			localStoreWriteTailByTopic.set(pubsubTopic, thisWrite);
+			let wroteNewerRecord = false;
+			try {
+				await previousWrite;
+				if (await originalLocalStoreHas(routingKey, options)) {
+					const { record: heldRecord } = await originalLocalStoreGet(routingKey, options);
+					if (equals(heldRecord, marshalledRecord)) return;
+					if (ipnsSelector(routingKey, [heldRecord, marshalledRecord]) === 0) return;
+				}
+				await originalLocalStorePut(routingKey, marshalledRecord, options);
+				wroteNewerRecord = true;
+			} finally {
+				releaseWrite();
+				if (localStoreWriteTailByTopic.get(pubsubTopic) === thisWrite) localStoreWriteTailByTopic.delete(pubsubTopic);
+			}
+			if (!wroteNewerRecord) return;
 			let record;
 			try {
 				record = unmarshalIPNSRecord(marshalledRecord);
@@ -6745,7 +6769,7 @@ async function createLibp2pJsClientOrUseExistingOne(pkcOptions) {
 								options,
 								log: logger_default("pkc-js:helia:ipns:direct-fetch")
 							});
-							if (direct) {
+							if (direct.recordBytes) {
 								directFetchOutcome = {
 									attempted: true,
 									hit: true,
@@ -6771,7 +6795,9 @@ async function createLibp2pJsClientOrUseExistingOne(pkcOptions) {
 							directFetchOutcome = {
 								attempted: true,
 								hit: false,
-								durationMs: Date.now() - directStart
+								durationMs: Date.now() - directStart,
+								providers: direct.providers,
+								subscribersTried: direct.subscribersTried
 							};
 						} catch (directErr) {
 							if (options?.signal?.aborted) throw directErr;
@@ -6817,18 +6843,35 @@ async function createLibp2pJsClientOrUseExistingOne(pkcOptions) {
 					} 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)
-					});
+					if (!recordBytes) {
+						const subscribersAtResolveTime = helia.libp2p.services.pubsub.getSubscribers(ipnsPubsubTopic).length;
+						const providers = directFetchOutcome.attempted && !directFetchOutcome.hit ? directFetchOutcome.providers : void 0;
+						const failureDetails = {
+							ipnsName,
+							currentName,
+							ipnsPubsubTopic,
+							ipnsResolveOptions: options,
+							providersFound: providers?.length,
+							directFetchOutcome,
+							warmupOutcome,
+							routerErrors,
+							subscribersAtResolveTime,
+							httpRouters: pkcOptions.httpRoutersOptions,
+							...getHeliaDebugContext(helia)
+						};
+						const unreachableReason = providers && subscribersAtResolveTime === 0 ? summarizeProviderReachability({
+							providers,
+							subscribersTried: directFetchOutcome.subscribersTried ?? 0
+						}) : void 0;
+						if (unreachableReason) throw new PKCError("ERR_COMMUNITY_UNREACHABLE_FROM_THIS_CLIENT", {
+							reason: unreachableReason,
+							providerPeerIds: providers.map((provider) => provider.peerId),
+							providers,
+							docsUrl: REACHABILITY_DOCS_URL,
+							...failureDetails
+						});
+						throw new PKCError("ERR_RESOLVED_IPNS_P2P_TO_UNDEFINED", failureDetails);
+					}
 					await ipnsValidator(routingKey, recordBytes);
 					const record = unmarshalIPNSRecord(recordBytes);
 					ipnsRecordNetworkValidatedAtMs.set(ipnsPubsubTopic, Date.now());

package/dist/bundled/chunks/{local-community-BVWWQKxg.js → local-community-B6i3MUzw.js}

@@ -1,2 +1,2 @@
-import { n as createNewLocalCommunityDb, r as updateInstancePropsWithStartedCommunityOrDb, t as LocalCommunity } from "./local-community-DhiNmK3L.js";
+import { n as createNewLocalCommunityDb, r as updateInstancePropsWithStartedCommunityOrDb, t as LocalCommunity } from "./local-community-Dm02mfn3.js";
 export { LocalCommunity, createNewLocalCommunityDb, updateInstancePropsWithStartedCommunityOrDb };