@pkcprotocol/pkc-js 0.0.93 → 0.0.94

package/dist/bundled/chunks/{rpc-local-community-DOSee621.js → rpc-local-community-Dr_-Lb8I.js}

@@ -1,5 +1,5 @@
 import { i as __toESM, n as __exportAll, r as __require, t as __commonJSMin } from "./chunk-2rV9d50f.js";
-import { $ as pubsubTopicToDhtKey, $n as n$10, $t as ChallengeFileSchema, A as extractNetworkErrorDetails, An as CommentUpdateSignedPropertyNames, Ar as literal, At as refreshTrackedCommunityAliases, B as isIpfsCid, Bt as pTimeout, Cn as CommentPubsubMessageWithFlexibleAuthorRefinementSchema, Cr as require_supports_color, Ct as findStartedCommunity, D as deepMergeRuntimeFields, Dn as CommentUpdateForChallengeVerificationSignedPropertyNames, Dr as array, E as createAbortError, Er as _enum, Et as listStartedCommunities, Fn as ModQueuePageIpfsSchema, Ft as untrackStartedCommunity, Gn as AuthorCommentIpfsReservedFields, Gt as CreateCommunityEditPublicationOptionsWithRefinementSchema, H as isIpns, I as getPostUpdateTimestampRange, In as PageIpfsSchema, It as untrackUpdatingComment, Jn as CidPathSchema, Kt as CommentModerationChallengeRequestToEncryptSchema, L as hideClassPrivateProps, Ln as CommentEditChallengeRequestToEncryptSchema, Lt as untrackUpdatingCommunity, Mr as object, Mt as trackStartedCommunity, Nn as CreateCommentOptionsWithRefinementSchema, Nr as record, O as derivePublicationFromChallengeRequest, On as CommentUpdateReservedFields, Or as boolean, Ot as listUpdatingCommunities, Pn as GetPageParamSchema, Pr as string, Pt as trackUpdatingCommunity, Q as isStringDomain, Qn as CreateSignerSchema, Qt as ChallengeFileFactorySchema, R as ipnsNameToIpnsOverPubsubTopic, Rt as require_sha256$1, Sr as logger_default, Tn as CommentUpdateChallengeReservedFieldNames, Tt as findUpdatingCommunity, U as isIpnsPath, Un as CreateCommentEditOptionsWithRefinementSchema, Ut as CommunityEditPublicationSignedPropertyNames, V as isIpfsPath, Vn as CommentEditSignedPropertyNames, Vt as CommunityEditPublicationChallengeRequestToEncryptSchema, Wn as AuthorAddressSchema, Wt as CommunityEditPubsubMessagePublicationSchema, X as isRequestPubsubPublicationOfPost, Xn as CommunityAddressSchema, Xt as CommentModerationsTableRowSchema, Yn as CidStringSchema, Yt as CommentModerationSignedPropertyNames, Z as isRequestPubsubPublicationOfReply, Zn as CommunityAuthorChallengeReservedFieldNames, Zt as CreateCommentModerationOptionsWithRefinementSchema, _ as PKCUserOptionBaseSchema, _n as VoteSignedPropertyNames, _r as FailedToFetchCommunityFromGatewaysError, an as CommunityIpfsSchema, ar as e$5, b as areEquivalentCommunityAddresses, bn as CommentIpfsReservedFields, br as PKCError, bt as waitForUpdateInCommunityInstanceWithErrorAndTimeout, c as ChallengeVerificationMessageSignedPropertyNames, cn as CreateRemoteCommunityFunctionArgumentSchema, cr as t$12, dr as t$10, f as DecryptedChallengeSchema, fn as RpcRemoteCommunityUpdateEventResultSchema, fr as t$9, g as PKCParsedOptionsSchema, gr as FailedToFetchCommentUpdateFromGatewaysError, gt as sleepUntilTimeoutOrAbort, h as NameResolverSerializedSchema, hn as VotePubsubMessagePublicationSchema, hr as FailedToFetchCommentIpfsFromGatewaysError, ht as shortifyCid, i as ChallengeMessageSignedPropertyNames, in as CommunityIpfsReservedFields, ir as e$6, j as fetchAndValidateIpnsRecordFromGateway, jr as number, k as doesDomainAddressHaveCapitalLetter, kn as CommentUpdateSchema, kr as custom, l as DecryptedChallengeAnswerSchema, ln as CreateRpcCommunityFunctionArgumentSchema, lr as n$8, m as NameResolveCacheOptionsSchema, mn as VoteChallengeRequestToEncryptSchema, mr as require_retry$1, mt as shortifyAddress, n as ChallengeAnswerMessageSignedPropertyNames, nn as CommunityEditOptionsSchema, o as ChallengeRequestMessageSignedPropertyNames, on as CommunitySignedPropertyNames, or as t$11, ot as removeNullUndefinedEmptyObjectsValuesRecursively, p as DecryptedChallengeVerificationSchema, pn as CreateVoteUserOptionsWithRefinementSchema, pr as e$4, qn as ChallengeAnswersSchema, qt as CommentModerationPubsubMessagePublicationSchema, rn as CommunityExportRecordsSchema, rr as t$13, sn as CreateNewLocalCommunityUserOptionsSchema, sr as r$8, tn as CommunityChallengeSettingSchema, tr as n$9, tt as raceAgainstAbort, un as ExportCommunityModLogsOptionsSchema, ur as r$7, ut as resolveWhenPredicateIsTrue, v as PKCUserOptionsSchema, vr as FailedToFetchGenericIpfsFromGatewaysError, vt as throwIfAbortSignalAborted, wn as CommentSignedPropertyNames, wr as require_ms$1, wt as findUpdatingComment, x as calculateIpfsCidV0, xn as CommentIpfsSchema, xr as messages, yn as CommentChallengeRequestToEncryptSchema, yr as FailedToFetchPageIpfsFromGatewaysError, yt as timestamp, z as isAbortError, zn as CommentEditPubsubMessagePublicationWithFlexibleAuthorSchema } from "./schema-HH2zeH-j.js";
+import { $ as isRequestPubsubPublicationOfReply, $n as CommunityAuthorChallengeReservedFieldNames, $t as CreateCommentModerationOptionsWithRefinementSchema, A as doesDomainAddressHaveCapitalLetter, An as CommentUpdateReservedFields, Ar as boolean, At as listUpdatingCommunities, B as ipnsNameToIpnsOverPubsubTopic, Bt as require_sha256$1, Cn as CommentIpfsSchema, Cr as messages, D as createAbortError, Dn as CommentUpdateChallengeReservedFieldNames, Dt as findUpdatingCommunity, En as CommentSignedPropertyNames, Er as require_ms$1, Et as findUpdatingComment, Fn as CreateCommentOptionsWithRefinementSchema, Fr as record, G as isIpnsPath, Gn as CreateCommentEditOptionsWithRefinementSchema, Gt as CommunityEditPublicationSignedPropertyNames, H as isIpfsCid, Ht as pTimeout, In as GetPageParamSchema, Ir as string, It as trackUpdatingCommunity, Jt as CommentModerationChallengeRequestToEncryptSchema, Kn as AuthorAddressSchema, Kt as CommunityEditPubsubMessagePublicationSchema, L as getPostUpdateTimestampRange, Ln as ModQueuePageIpfsSchema, Lt as untrackStartedCommunity, M as fetchAndValidateIpnsRecordFromGateway, Mn as CommentUpdateSignedPropertyNames, Mr as literal, Mt as refreshTrackedCommunityAliases, Nr as number, O as deepMergeRuntimeFields, Or as _enum, Ot as listStartedCommunities, Pr as object, Pt as trackStartedCommunity, Q as isRequestPubsubPublicationOfPost, Qn as CommunityAddressSchema, Qt as CommentModerationsTableRowSchema, R as hideClassPrivateProps, Rn as PageIpfsSchema, Rt as untrackUpdatingComment, S as calculateIpfsCidV0, Sn as CommentIpfsReservedFields, Sr as PKCError, St as waitForUpdateInCommunityInstanceWithErrorAndTimeout, Tn as CommentPubsubMessageWithFlexibleAuthorRefinementSchema, Tr as require_supports_color, Tt as findStartedCommunity, U as isIpfsPath, Un as CommentEditSignedPropertyNames, Ut as CommunityEditPublicationChallengeRequestToEncryptSchema, V as isAbortError, Vn as CommentEditPubsubMessagePublicationWithFlexibleAuthorSchema, W as isIpns, Xn as CidPathSchema, Yn as ChallengeAnswersSchema, Yt as CommentModerationPubsubMessagePublicationSchema, Zn as CidStringSchema, Zt as CommentModerationSignedPropertyNames, _ as PKCUserOptionBaseSchema, _n as VotePubsubMessagePublicationSchema, _r as FailedToFetchCommentIpfsFromGatewaysError, _t as shortifyCid, an as CommunityExportRecordsSchema, ar as t$13, b as areEquivalentCommunityAddresses, br as FailedToFetchGenericIpfsFromGatewaysError, bt as throwIfAbortSignalAborted, c as ChallengeVerificationMessageSignedPropertyNames, cn as CommunitySignedPropertyNames, cr as t$11, ct as removeNullUndefinedEmptyObjectsValuesRecursively, dn as CreateRpcCommunityFunctionArgumentSchema, dr as n$8, en as ChallengeFileFactorySchema, er as CreateSignerSchema, et as isStringDomain, f as DecryptedChallengeSchema, fn as ExportCommunityModLogsOptionsSchema, fr as r$7, ft as resolveWhenPredicateIsTrue, g as PKCParsedOptionsSchema, gn as VoteChallengeRequestToEncryptSchema, gr as require_retry$1, gt as shortifyAddress, h as NameResolverSerializedSchema, hn as CreateVoteUserOptionsWithRefinementSchema, hr as e$4, i as ChallengeMessageSignedPropertyNames, in as CommunityEditOptionsSchema, j as extractNetworkErrorDetails, jn as CommentUpdateSchema, jr as custom, k as derivePublicationFromChallengeRequest, kn as CommentUpdateForChallengeVerificationSignedPropertyNames, kr as array, l as DecryptedChallengeAnswerSchema, ln as CreateNewLocalCommunityUserOptionsSchema, lr as r$8, m as NameResolveCacheOptionsSchema, mn as RpcRemoteCommunityUpdateEventResultSchema, mr as t$9, n as ChallengeAnswerMessageSignedPropertyNames, o as ChallengeRequestMessageSignedPropertyNames, on as CommunityIpfsReservedFields, or as e$6, p as DecryptedChallengeVerificationSchema, pr as t$10, qn as AuthorCommentIpfsReservedFields, qt as CreateCommunityEditPublicationOptionsWithRefinementSchema, rn as CommunityChallengeSettingSchema, rr as n$9, rt as raceAgainstAbort, sn as CommunityIpfsSchema, sr as e$5, tn as ChallengeFileSchema, tr as n$10, tt as pubsubTopicToDhtKey, un as CreateRemoteCommunityFunctionArgumentSchema, ur as t$12, v as PKCUserOptionsSchema, vr as FailedToFetchCommentUpdateFromGatewaysError, vt as sleepUntilTimeoutOrAbort, wr as logger_default, xn as CommentChallengeRequestToEncryptSchema, xr as FailedToFetchPageIpfsFromGatewaysError, xt as timestamp, yn as VoteSignedPropertyNames, yr as FailedToFetchCommunityFromGatewaysError, z as interruptibleSleep, zn as CommentEditChallengeRequestToEncryptSchema, zt as untrackUpdatingCommunity } from "./schema-5-rYJ-bC.js";
 import { t as all } from "./src-CYIMjhjK.js";
 import { createHash } from "node:crypto";
 import { pathToFileURL } from "node:url";
@@ -125415,12 +125415,18 @@ function selectWinningGatewayCommunity(opts) {
 //#endregion
 //#region dist/node/community/community-client-manager.js
 const MAX_FILE_SIZE_BYTES_FOR_COMMUNITY_IPFS = 1024 * 1024;
+const FORCED_IPNS_NETWORK_REVALIDATION_MIN_INTERVAL_MS = 3e4;
 var CommunityClientsManager = class extends PKCClientsManager {
 	constructor(community) {
 		super(community._pkc);
 		this._suppressUpdatingStateForNameResolution = 0;
 		this._ipnsLoadingOperation = void 0;
 		this._updateCidsAlreadyLoaded = new LimitedSet(30);
+		this._subscribedIpnsArrivalTopics = /* @__PURE__ */ new Set();
+		this._pendingIpnsArrivalCids = /* @__PURE__ */ new Set();
+		this._pendingIpnsArrivalHopTargets = /* @__PURE__ */ new Set();
+		this._nextResolveRevalidatesNetwork = false;
+		this._lastForcedIpnsNetworkRevalidationAtMs = 0;
 		this._community = community;
 		this._initPKCRpcClients();
 		hideClassPrivateProps(this);
@@ -125583,20 +125589,127 @@ var CommunityClientsManager = class extends PKCClientsManager {
 	async startUpdatingLoop() {
 		const log = logger_default("pkc-js:remote-community:update");
 		this._community._createStopAbortController();
-		const updateInterval = Object.keys(this._pkc.clients.kuboRpcClients).length > 0 || Object.keys(this._pkc.clients.libp2pJsClients).length > 0 ? 1e3 : this._pkc.updateInterval;
+		const areWeConnectedToKuboOrHelia = Object.keys(this._pkc.clients.kuboRpcClients).length > 0 || Object.keys(this._pkc.clients.libp2pJsClients).length > 0;
+		const defaultIpfsClient = areWeConnectedToKuboOrHelia ? this.getDefaultKuboRpcClientOrHelia() : void 0;
+		const defaultLibp2pJsClient = defaultIpfsClient && "_helia" in defaultIpfsClient ? defaultIpfsClient : void 0;
+		if (defaultLibp2pJsClient) {
+			try {
+				this._syncIpnsArrivalSubscriptions(defaultLibp2pJsClient);
+			} catch (e) {
+				log.error(`Failed to arm IPNS record arrival subscriptions of community ${this._community.address} before its first update`, e);
+			}
+			this._lastForcedIpnsNetworkRevalidationAtMs = Date.now();
+		}
 		while (this._community.state === "updating" && !this._community._getStopAbortSignal()?.aborted) try {
 			await this.updateOnce();
 		} catch (e) {
 			log.error(`Failed to update community ${this._community.address} for this iteration, will retry later`, e);
 		} finally {
-			await sleepUntilTimeoutOrAbort(updateInterval, this._community._getStopAbortSignal());
+			if (defaultLibp2pJsClient) {
+				try {
+					this._syncIpnsArrivalSubscriptions(defaultLibp2pJsClient);
+				} catch (e) {
+					log.error(`Failed to sync IPNS record arrival subscriptions of community ${this._community.address}`, e);
+				}
+				const safetyNetMs = this._pkc.updateInterval * (.75 + Math.random() * .5);
+				await this._sleepUntilIpnsArrivalOrTimeoutOrAbort({
+					ms: safetyNetMs,
+					signal: this._community._getStopAbortSignal()
+				});
+			} else await sleepUntilTimeoutOrAbort(areWeConnectedToKuboOrHelia ? 1e3 : this._pkc.updateInterval, this._community._getStopAbortSignal());
 		}
+		this._clearIpnsArrivalSubscriptions();
 		this._community._clearStopAbortController();
 		log("Community", this._community.address, "is no longer updating");
 	}
 	async stopUpdatingLoop() {
 		this._ipnsLoadingOperation?.stop();
 		this._updateCidsAlreadyLoaded.clear();
+		this._clearIpnsArrivalSubscriptions();
+	}
+	_onIpnsRecordArrival(arrival) {
+		const value = arrival.record.value;
+		if (isIpfsPath(value)) {
+			const cid = value.split("/")[2];
+			if (this._updateCidsAlreadyLoaded.has(cid) || this._community.updateCid === cid) return;
+			this._pendingIpnsArrivalCids.add(cid);
+		} else if (isIpnsPath(value)) {
+			const hopTarget = value.split("/")[2];
+			if (this._community.ipnsHops?.includes(hopTarget)) return;
+			this._pendingIpnsArrivalHopTargets.add(hopTarget);
+		} else return;
+		this._wakeUpdateLoopForIpnsArrival?.();
+	}
+	_consumePendingIpnsArrivals() {
+		for (const cid of this._pendingIpnsArrivalCids) if (this._updateCidsAlreadyLoaded.has(cid) || this._community.updateCid === cid) this._pendingIpnsArrivalCids.delete(cid);
+		for (const hopTarget of this._pendingIpnsArrivalHopTargets) if (this._community.ipnsHops?.includes(hopTarget)) this._pendingIpnsArrivalHopTargets.delete(hopTarget);
+		if (this._pendingIpnsArrivalCids.size === 0 && this._pendingIpnsArrivalHopTargets.size === 0) return false;
+		this._pendingIpnsArrivalCids.clear();
+		this._pendingIpnsArrivalHopTargets.clear();
+		return true;
+	}
+	_syncIpnsArrivalSubscriptions(client) {
+		if (!this._ipnsArrivalListener) this._ipnsArrivalListener = (arrival) => this._onIpnsRecordArrival(arrival);
+		this._ipnsArrivalClient = client;
+		const preResolveIpnsName = this._community.ipnsName ?? this._pinnedIpnsName() ?? (!isStringDomain(this._community.address) ? this._community.address : void 0);
+		const ipnsNamesToWatch = this._community.ipnsHops?.length ? this._community.ipnsHops : preResolveIpnsName ? [preResolveIpnsName] : [];
+		const desiredTopics = new Set(ipnsNamesToWatch.map(ipnsNameToIpnsOverPubsubTopic));
+		for (const topic of this._subscribedIpnsArrivalTopics) if (!desiredTopics.has(topic)) {
+			client.heliaWithKuboRpcClientFunctions.ipnsRecordArrivals.unsubscribe({
+				pubsubTopic: topic,
+				listener: this._ipnsArrivalListener
+			});
+			this._subscribedIpnsArrivalTopics.delete(topic);
+		}
+		for (const topic of desiredTopics) if (!this._subscribedIpnsArrivalTopics.has(topic)) {
+			client.heliaWithKuboRpcClientFunctions.ipnsRecordArrivals.subscribe({
+				pubsubTopic: topic,
+				listener: this._ipnsArrivalListener
+			});
+			this._subscribedIpnsArrivalTopics.add(topic);
+		}
+	}
+	_resyncIpnsArrivalSubscriptionsIfArmed() {
+		if (!this._ipnsArrivalClient) return;
+		try {
+			this._syncIpnsArrivalSubscriptions(this._ipnsArrivalClient);
+		} catch (e) {
+			logger_default("pkc-js:remote-community:update").error(`Failed to sync IPNS record arrival subscriptions of community ${this._community.address}`, e);
+		}
+	}
+	_clearIpnsArrivalSubscriptions() {
+		if (this._ipnsArrivalClient && this._ipnsArrivalListener) for (const topic of this._subscribedIpnsArrivalTopics) this._ipnsArrivalClient.heliaWithKuboRpcClientFunctions.ipnsRecordArrivals.unsubscribe({
+			pubsubTopic: topic,
+			listener: this._ipnsArrivalListener
+		});
+		this._subscribedIpnsArrivalTopics.clear();
+		this._ipnsArrivalClient = void 0;
+		this._pendingIpnsArrivalCids.clear();
+		this._pendingIpnsArrivalHopTargets.clear();
+		this._nextResolveRevalidatesNetwork = false;
+	}
+	async _sleepUntilIpnsArrivalOrTimeoutOrAbort({ ms, signal }) {
+		if (this._consumePendingIpnsArrivals()) {
+			this._nextResolveRevalidatesNetwork = false;
+			return;
+		}
+		const { promise, wake } = interruptibleSleep({
+			ms,
+			signal
+		});
+		let wokenByArrival = false;
+		const wakeForArrival = () => {
+			wokenByArrival = true;
+			wake();
+		};
+		this._wakeUpdateLoopForIpnsArrival = wakeForArrival;
+		await promise;
+		if (this._wakeUpdateLoopForIpnsArrival === wakeForArrival) this._wakeUpdateLoopForIpnsArrival = void 0;
+		if (wokenByArrival) {
+			this._pendingIpnsArrivalCids.clear();
+			this._pendingIpnsArrivalHopTargets.clear();
+		}
+		this._nextResolveRevalidatesNetwork = !wokenByArrival && Date.now() - this._lastForcedIpnsNetworkRevalidationAtMs >= FORCED_IPNS_NETWORK_REVALIDATION_MIN_INTERVAL_MS;
 	}
 	async _resolveCommunityNameWithoutUpdatingState({ communityName, abortSignal, cache }) {
 		this._suppressUpdatingStateForNameResolution++;
@@ -125618,6 +125731,25 @@ var CommunityClientsManager = class extends PKCClientsManager {
 		if (this._community.publicKey) chainKeys.delete(this._community.publicKey);
 		return [...chainKeys];
 	}
+	_applyKeyMigration({ communityName, newPublicKey }) {
+		logger_default("pkc-js:community-client-manager:_applyKeyMigration")("Key migration detected for", communityName, "old:", this._community.publicKey, "new:", newPublicKey);
+		const previousPublicKey = this._community.publicKey;
+		const error = new PKCError("ERR_COMMUNITY_NAME_RESOLVES_TO_DIFFERENT_PUBLIC_KEY", {
+			communityName,
+			previousPublicKey,
+			newPublicKey
+		});
+		this._community._clearDataForKeyMigration(newPublicKey);
+		this._updateCidsAlreadyLoaded.clear();
+		this._community.nameResolved = true;
+		this._pendingIpnsArrivalCids.clear();
+		this._pendingIpnsArrivalHopTargets.clear();
+		this._resyncIpnsArrivalSubscriptionsIfArmed();
+		this._community._abortStopOperations("Key migration: name resolved to different public key");
+		this._community._createStopAbortController();
+		this._community.emit("update", this._community);
+		this._community.emit("error", error);
+	}
 	_resolveNameInBackground(name) {
 		const log = logger_default("pkc-js:community-client-manager:_resolveNameInBackground");
 		const setNameResolvedAndEmitUpdate = (newNameResolved) => {
@@ -125636,20 +125768,10 @@ var CommunityClientsManager = class extends PKCClientsManager {
 					setNameResolvedAndEmitUpdate(false);
 					return;
 				}
-				log("Key migration detected for", name, "old:", this._community.publicKey, "new:", resolved);
-				const previousPublicKey = this._community.publicKey;
-				const error = new PKCError("ERR_COMMUNITY_NAME_RESOLVES_TO_DIFFERENT_PUBLIC_KEY", {
+				this._applyKeyMigration({
 					communityName: name,
-					previousPublicKey,
 					newPublicKey: resolved
 				});
-				this._community._clearDataForKeyMigration(resolved);
-				this._updateCidsAlreadyLoaded.clear();
-				this._community.nameResolved = true;
-				this._community._abortStopOperations("Key migration: name resolved to different public key");
-				this._community._createStopAbortController();
-				this._community.emit("update", this._community);
-				this._community.emit("error", error);
 			} else if (resolved) setNameResolvedAndEmitUpdate(true);
 			if (!resolved && this._community.name) setNameResolvedAndEmitUpdate(false);
 		}).catch((e) => {
@@ -125681,13 +125803,18 @@ var CommunityClientsManager = class extends PKCClientsManager {
 			abortSignal: this._community._getStopAbortSignal()
 		});
 	}
+	_pinnedIpnsName() {
+		const isDomain = isStringDomain(this._community.address);
+		const hasAnchorClaim = Boolean(this._community.anchor);
+		if (this._community.publicKey && (isDomain || hasAnchorClaim || !isDomain && this._community.name && this._community.nameResolved === true)) return this._community.publicKey;
+	}
 	async fetchNewUpdateForCommunity(communityAddress) {
 		return this._withInflightCommunityFetch(communityAddress, async () => {
 			let ipnsName;
 			const isDomain = isStringDomain(communityAddress);
-			const hasAnchorClaim = Boolean(this._community.anchor);
-			if (this._community.publicKey && (isDomain || hasAnchorClaim || !isDomain && this._community.name && this._community.nameResolved === true)) {
-				ipnsName = this._community.publicKey;
+			const pinnedIpnsName = this._pinnedIpnsName();
+			if (pinnedIpnsName) {
+				ipnsName = pinnedIpnsName;
 				if (isDomain) this._resolveNameInBackground(communityAddress);
 			} else ipnsName = await this.resolveCommunityNameIfNeeded({
 				communityName: communityAddress,
@@ -125701,6 +125828,7 @@ var CommunityClientsManager = class extends PKCClientsManager {
 				this._community.ipnsHops = [ipnsName];
 				this._community.ipnsPubsubTopic = ipnsNameToIpnsOverPubsubTopic(ipnsName);
 				this._community.ipnsPubsubTopicRoutingCid = pubsubTopicToDhtKey(this._community.ipnsPubsubTopic);
+				this._resyncIpnsArrivalSubscriptionsIfArmed();
 			}
 			if (this._community.updateCid) this._updateCidsAlreadyLoaded.add(this._community.updateCid);
 			this._community._setUpdatingStateWithEventEmissionIfNewState("fetching-ipns");
@@ -125742,9 +125870,13 @@ var CommunityClientsManager = class extends PKCClientsManager {
 		const kuboRpcOrHelia = this.getDefaultKuboRpcClientOrHelia();
 		if ("_helia" in kuboRpcOrHelia) this.updateLibp2pJsClientState("fetching-ipns", kuboRpcOrHelia._libp2pJsClientsOptions.key);
 		else this.updateKuboRpcState("fetching-ipns", kuboRpcOrHelia.url);
+		const forceNetworkRevalidation = this._nextResolveRevalidatesNetwork;
+		this._nextResolveRevalidatesNetwork = false;
+		if (forceNetworkRevalidation) this._lastForcedIpnsNetworkRevalidationAtMs = Date.now();
 		const { cid: latestCommunityCid, ipnsHops } = await this.resolveIpnsToCidP2P(ipnsName, {
 			timeoutMs: this._pkc._timeouts["community-ipns"],
-			abortSignal: this._community._getStopAbortSignal()
+			abortSignal: this._community._getStopAbortSignal(),
+			...forceNetworkRevalidation ? { nocache: true } : {}
 		});
 		this._community.ipnsHops = ipnsHops;
 		ipnsHops[ipnsHops.length - 1];
@@ -126387,6 +126519,7 @@ var RemoteCommunity = class extends import_lib$1.TypedEmitter {
 		this.pubsubTopicRoutingCid = void 0;
 		this.publicKey = newPublicKey;
 		this.ipnsName = newPublicKey;
+		this.ipnsHops = [newPublicKey];
 		this.ipnsPubsubTopic = ipnsNameToIpnsOverPubsubTopic(newPublicKey);
 		this.ipnsPubsubTopicRoutingCid = pubsubTopicToDhtKey(this.ipnsPubsubTopic);
 		this._assertHasIdentity();

package/dist/bundled/chunks/{schema-HH2zeH-j.js → schema-5-rYJ-bC.js}

@@ -15376,17 +15376,28 @@ function throwIfAbortSignalAborted(signal) {
 	if (typeof signal.reason === "string" && signal.reason.length > 0) throw createAbortError(signal.reason);
 	throw createAbortError();
 }
+function interruptibleSleep({ ms, signal }) {
+	let wake = () => void 0;
+	return {
+		promise: new Promise((resolve) => {
+			if (signal?.aborted) return resolve();
+			const settle = () => {
+				clearTimeout(timer);
+				signal?.removeEventListener("abort", settle);
+				resolve();
+			};
+			const timer = setTimeout(settle, ms);
+			signal?.addEventListener("abort", settle, { once: true });
+			wake = settle;
+		}),
+		wake
+	};
+}
 function sleepUntilTimeoutOrAbort(ms, signal) {
-	return new Promise((resolve) => {
-		if (signal?.aborted) return resolve();
-		const onAbortOrTimeout = () => {
-			clearTimeout(timer);
-			signal?.removeEventListener("abort", onAbortOrTimeout);
-			resolve();
-		};
-		const timer = setTimeout(onAbortOrTimeout, ms);
-		signal?.addEventListener("abort", onAbortOrTimeout, { once: true });
-	});
+	return interruptibleSleep({
+		ms,
+		signal
+	}).promise;
 }
 async function raceAgainstAbort(promise, signal) {
 	if (!signal) return promise;
@@ -15803,6 +15814,12 @@ async function waitForUpdateInCommunityInstanceWithErrorAndTimeout(opts) {
 function calculateIpfsCidV0(content) {
 	return of(content);
 }
+/**
+* converts a binary record key to a pubsub topic key
+*/
+function binaryKeyToPubsubTopic(key) {
+	return `/record/${toString(key, "base64url")}`;
+}
 function ipnsNameToIpnsOverPubsubTopic(ipnsName) {
 	const ipnsNamespaceBytes = new TextEncoder().encode("/ipns/");
 	const ipnsNameBytes = peerIdFromString(ipnsName).toMultihash().bytes;
@@ -16206,7 +16223,7 @@ function extractNetworkErrorDetails(err, depth = 0) {
 }
 //#endregion
 //#region dist/node/generated-version.js
-const version = "0.0.93";
+const version = "0.0.94";
 //#endregion
 //#region dist/node/version.js
 const protocolVersion = ProtocolVersionSchema.parse("1.0.0");
@@ -16360,4 +16377,4 @@ const DecryptedChallengeVerificationSchema = object({
 }).strict();
 const ChallengeVerificationMessageSignedPropertyNames = t$3(n$3(ChallengeVerificationMessageSchema.shape, ["signature"]));
 //#endregion
-export { pubsubTopicToDhtKey as $, n as $n, ChallengeFileSchema as $t, extractNetworkErrorDetails as A, CommentUpdateSignedPropertyNames as An, literal as Ar, refreshTrackedCommunityAliases as At, isIpfsCid as B, CommentEditReservedFields as Bn, pTimeout as Bt, contentContainsMarkdownAudio as C, CommentPubsubMessageWithFlexibleAuthorRefinementSchema as Cn, require_supports_color as Cr, findStartedCommunity as Ct, deepMergeRuntimeFields as D, CommentUpdateForChallengeVerificationSignedPropertyNames as Dn, array as Dr, listUpdatingComments as Dt, createAbortError as E, CommentUpdateForChallengeVerificationSchema as En, _enum as Er, listStartedCommunities as Et, getIpnsRecordInLocalKuboNode as F, ModQueuePageIpfsSchema as Fn, ZodError as Fr, untrackStartedCommunity as Ft, isLinkOfAudio as G, AuthorCommentIpfsReservedFields as Gn, CreateCommunityEditPublicationOptionsWithRefinementSchema as Gt, isIpns as H, CommentEditsTableRowSchema as Hn, CommunityEditPublicationPubsubReservedFields as Ht, getPostUpdateTimestampRange as I, PageIpfsSchema as In, joinValues as Ir, untrackUpdatingComment as It, isLinkOfVideo as J, CidPathSchema as Jn, CommentModerationReservedFields as Jt, isLinkOfImage as K, AuthorReservedFields as Kn, CommentModerationChallengeRequestToEncryptSchema as Kt, hideClassPrivateProps as L, CommentEditChallengeRequestToEncryptSchema as Ln, parsedType as Lr, untrackUpdatingCommunity as Lt, genToArray as M, CommentsTableRowSchema as Mn, object as Mr, trackStartedCommunity as Mt, getEquivalentCommunityAddresses as N, CreateCommentOptionsWithRefinementSchema as Nn, record as Nr, trackUpdatingComment as Nt, derivePublicationFromChallengeRequest as O, CommentUpdateReservedFields as On, boolean as Or, listUpdatingCommunities as Ot, getErrorCodeFromMessage as P, GetPageParamSchema as Pn, string as Pr, trackUpdatingCommunity as Pt, isStringDomain as Q, CreateSignerSchema as Qn, ChallengeFileFactorySchema as Qt, ipnsNameToIpnsOverPubsubTopic as R, CommentEditPubsubMessagePublicationSchema as Rn, stringifyPrimitive as Rr, require_sha256 as Rt, calculateStringSizeSameAsIpfsAddCidV0 as S, CommentPubsubMessageReservedFields as Sn, logger_default as Sr, findCommunityInRegistry as St, contentContainsMarkdownVideos as T, CommentUpdateChallengeReservedFieldNames as Tn, setErrorMap as Tr, findUpdatingCommunity as Tt, isIpnsPath as U, CreateCommentEditOptionsWithRefinementSchema as Un, CommunityEditPublicationSignedPropertyNames as Ut, isIpfsPath as V, CommentEditSignedPropertyNames as Vn, CommunityEditPublicationChallengeRequestToEncryptSchema as Vt, isLinkOfAnimatedImage as W, AuthorAddressSchema as Wn, CommunityEditPubsubMessagePublicationSchema as Wt, isRequestPubsubPublicationOfPost as X, CommunityAddressSchema as Xn, CommentModerationsTableRowSchema as Xt, isLinkValid as Y, CidStringSchema as Yn, CommentModerationSignedPropertyNames as Yt, isRequestPubsubPublicationOfReply as Z, CommunityAuthorChallengeReservedFieldNames as Zn, CreateCommentModerationOptionsWithRefinementSchema as Zt, PKCUserOptionBaseSchema as _, VoteSignedPropertyNames as _n, FailedToFetchCommunityFromGatewaysError as _r, statMfsPathSafely as _t, ChallengeRequestMessageSchema as a, CommunityIpfsSchema as an, e$2 as ar, removeMfsFilesSafely as at, areEquivalentCommunityAddresses as b, CommentIpfsReservedFields as bn, PKCError as br, waitForUpdateInCommunityInstanceWithErrorAndTimeout as bt, ChallengeVerificationMessageSignedPropertyNames as c, CreateRemoteCommunityFunctionArgumentSchema as cn, t$5 as cr, removeUndefinedValuesRecursively as ct, DecryptedChallengeRequestSchema as d, PubsubTopicSchema as dn, t$7 as dr, retryKuboBlockPutPinAndProvidePubsubTopic as dt, CommunityAnchorSchema as en, t$1 as er, pubsubTopicToDhtKeyCid as et, DecryptedChallengeSchema as f, RpcRemoteCommunityUpdateEventResultSchema as fn, t$8 as fr, retryKuboIpfsAdd as ft, PKCParsedOptionsSchema as g, VotePubsubReservedFields as gn, FailedToFetchCommentUpdateFromGatewaysError as gr, sleepUntilTimeoutOrAbort as gt, NameResolverSerializedSchema as h, VotePubsubMessagePublicationSchema as hn, FailedToFetchCommentIpfsFromGatewaysError as hr, shortifyCid as ht, ChallengeMessageSignedPropertyNames as i, CommunityIpfsReservedFields as in, e as ir, removeBlocksFromKuboNode as it, fetchAndValidateIpnsRecordFromGateway as j, CommentUpdateTableRowSchema as jn, number as jr, syncCommunityRegistryEntry as jt, doesDomainAddressHaveCapitalLetter as k, CommentUpdateSchema as kn, custom as kr, refreshTrackedCommentAliases as kt, DecryptedChallengeAnswerSchema as l, CreateRpcCommunityFunctionArgumentSchema as ln, n$7 as lr, replaceXWithY as lt, NameResolveCacheOptionsSchema as m, VoteChallengeRequestToEncryptSchema as mn, require_retry as mr, shortifyAddress as mt, ChallengeAnswerMessageSignedPropertyNames as n, CommunityEditOptionsSchema as nn, t$2 as nr, rejectWhenAbortSignalFires as nt, ChallengeRequestMessageSignedPropertyNames as o, CommunitySignedPropertyNames as on, t$4 as or, removeNullUndefinedEmptyObjectsValuesRecursively as ot, DecryptedChallengeVerificationSchema as p, CreateVoteUserOptionsWithRefinementSchema as pn, e$4 as pr, retryKuboIpfsAddAndProvide as pt, isLinkOfMedia as q, ChallengeAnswersSchema as qn, CommentModerationPubsubMessagePublicationSchema as qt, ChallengeMessageSchema as r, CommunityExportRecordsSchema as rn, t$3 as rr, rejectWhenCommunityStopsOrAborts as rt, ChallengeVerificationMessageSchema as s, CreateNewLocalCommunityUserOptionsSchema as sn, r$2 as sr, removeNullUndefinedValues as st, ChallengeAnswerMessageSchema as t, CommunityChallengeSettingSchema as tn, n$3 as tr, raceAgainstAbort as tt, DecryptedChallengeRequestPublicationSchema as u, ExportCommunityModLogsOptionsSchema as un, r$4 as ur, resolveWhenPredicateIsTrue as ut, PKCUserOptionsSchema as v, VoteTablesRowSchema as vn, FailedToFetchGenericIpfsFromGatewaysError as vr, throwIfAbortSignalAborted as vt, contentContainsMarkdownImages as w, CommentSignedPropertyNames as wn, require_ms as wr, findUpdatingComment as wt, calculateIpfsCidV0 as x, CommentIpfsSchema as xn, messages as xr, writeKuboFilesWithTimeout as xt, version_default as y, CommentChallengeRequestToEncryptSchema as yn, FailedToFetchPageIpfsFromGatewaysError as yr, timestamp as yt, isAbortError as z, CommentEditPubsubMessagePublicationWithFlexibleAuthorSchema as zn, TimeoutError as zt };
+export { isRequestPubsubPublicationOfReply as $, CommunityAuthorChallengeReservedFieldNames as $n, CreateCommentModerationOptionsWithRefinementSchema as $t, doesDomainAddressHaveCapitalLetter as A, CommentUpdateReservedFields as An, boolean as Ar, listUpdatingCommunities as At, ipnsNameToIpnsOverPubsubTopic as B, CommentEditPubsubMessagePublicationSchema as Bn, stringifyPrimitive as Br, require_sha256 as Bt, calculateStringSizeSameAsIpfsAddCidV0 as C, CommentIpfsSchema as Cn, messages as Cr, writeKuboFilesWithTimeout as Ct, createAbortError as D, CommentUpdateChallengeReservedFieldNames as Dn, setErrorMap as Dr, findUpdatingCommunity as Dt, contentContainsMarkdownVideos as E, CommentSignedPropertyNames as En, require_ms as Er, findUpdatingComment as Et, getErrorCodeFromMessage as F, CreateCommentOptionsWithRefinementSchema as Fn, record as Fr, trackUpdatingComment as Ft, isIpnsPath as G, CreateCommentEditOptionsWithRefinementSchema as Gn, CommunityEditPublicationSignedPropertyNames as Gt, isIpfsCid as H, CommentEditReservedFields as Hn, pTimeout as Ht, getIpnsRecordInLocalKuboNode as I, GetPageParamSchema as In, string as Ir, trackUpdatingCommunity as It, isLinkOfImage as J, AuthorReservedFields as Jn, CommentModerationChallengeRequestToEncryptSchema as Jt, isLinkOfAnimatedImage as K, AuthorAddressSchema as Kn, CommunityEditPubsubMessagePublicationSchema as Kt, getPostUpdateTimestampRange as L, ModQueuePageIpfsSchema as Ln, ZodError as Lr, untrackStartedCommunity as Lt, fetchAndValidateIpnsRecordFromGateway as M, CommentUpdateSignedPropertyNames as Mn, literal as Mr, refreshTrackedCommunityAliases as Mt, genToArray as N, CommentUpdateTableRowSchema as Nn, number as Nr, syncCommunityRegistryEntry as Nt, deepMergeRuntimeFields as O, CommentUpdateForChallengeVerificationSchema as On, _enum as Or, listStartedCommunities as Ot, getEquivalentCommunityAddresses as P, CommentsTableRowSchema as Pn, object as Pr, trackStartedCommunity as Pt, isRequestPubsubPublicationOfPost as Q, CommunityAddressSchema as Qn, CommentModerationsTableRowSchema as Qt, hideClassPrivateProps as R, PageIpfsSchema as Rn, joinValues as Rr, untrackUpdatingComment as Rt, calculateIpfsCidV0 as S, CommentIpfsReservedFields as Sn, PKCError as Sr, waitForUpdateInCommunityInstanceWithErrorAndTimeout as St, contentContainsMarkdownImages as T, CommentPubsubMessageWithFlexibleAuthorRefinementSchema as Tn, require_supports_color as Tr, findStartedCommunity as Tt, isIpfsPath as U, CommentEditSignedPropertyNames as Un, CommunityEditPublicationChallengeRequestToEncryptSchema as Ut, isAbortError as V, CommentEditPubsubMessagePublicationWithFlexibleAuthorSchema as Vn, TimeoutError as Vt, isIpns as W, CommentEditsTableRowSchema as Wn, CommunityEditPublicationPubsubReservedFields as Wt, isLinkOfVideo as X, CidPathSchema as Xn, CommentModerationReservedFields as Xt, isLinkOfMedia as Y, ChallengeAnswersSchema as Yn, CommentModerationPubsubMessagePublicationSchema as Yt, isLinkValid as Z, CidStringSchema as Zn, CommentModerationSignedPropertyNames as Zt, PKCUserOptionBaseSchema as _, VotePubsubMessagePublicationSchema as _n, FailedToFetchCommentIpfsFromGatewaysError as _r, shortifyCid as _t, ChallengeRequestMessageSchema as a, CommunityExportRecordsSchema as an, t$3 as ar, rejectWhenCommunityStopsOrAborts as at, areEquivalentCommunityAddresses as b, VoteTablesRowSchema as bn, FailedToFetchGenericIpfsFromGatewaysError as br, throwIfAbortSignalAborted as bt, ChallengeVerificationMessageSignedPropertyNames as c, CommunitySignedPropertyNames as cn, t$4 as cr, removeNullUndefinedEmptyObjectsValuesRecursively as ct, DecryptedChallengeRequestSchema as d, CreateRpcCommunityFunctionArgumentSchema as dn, n$7 as dr, replaceXWithY as dt, ChallengeFileFactorySchema as en, CreateSignerSchema as er, isStringDomain as et, DecryptedChallengeSchema as f, ExportCommunityModLogsOptionsSchema as fn, r$4 as fr, resolveWhenPredicateIsTrue as ft, PKCParsedOptionsSchema as g, VoteChallengeRequestToEncryptSchema as gn, require_retry as gr, shortifyAddress as gt, NameResolverSerializedSchema as h, CreateVoteUserOptionsWithRefinementSchema as hn, e$4 as hr, retryKuboIpfsAddAndProvide as ht, ChallengeMessageSignedPropertyNames as i, CommunityEditOptionsSchema as in, t$2 as ir, rejectWhenAbortSignalFires as it, extractNetworkErrorDetails as j, CommentUpdateSchema as jn, custom as jr, refreshTrackedCommentAliases as jt, derivePublicationFromChallengeRequest as k, CommentUpdateForChallengeVerificationSignedPropertyNames as kn, array as kr, listUpdatingComments as kt, DecryptedChallengeAnswerSchema as l, CreateNewLocalCommunityUserOptionsSchema as ln, r$2 as lr, removeNullUndefinedValues as lt, NameResolveCacheOptionsSchema as m, RpcRemoteCommunityUpdateEventResultSchema as mn, t$8 as mr, retryKuboIpfsAdd as mt, ChallengeAnswerMessageSignedPropertyNames as n, CommunityAnchorSchema as nn, t$1 as nr, pubsubTopicToDhtKeyCid as nt, ChallengeRequestMessageSignedPropertyNames as o, CommunityIpfsReservedFields as on, e as or, removeBlocksFromKuboNode as ot, DecryptedChallengeVerificationSchema as p, PubsubTopicSchema as pn, t$7 as pr, retryKuboBlockPutPinAndProvidePubsubTopic as pt, isLinkOfAudio as q, AuthorCommentIpfsReservedFields as qn, CreateCommunityEditPublicationOptionsWithRefinementSchema as qt, ChallengeMessageSchema as r, CommunityChallengeSettingSchema as rn, n$3 as rr, raceAgainstAbort as rt, ChallengeVerificationMessageSchema as s, CommunityIpfsSchema as sn, e$2 as sr, removeMfsFilesSafely as st, ChallengeAnswerMessageSchema as t, ChallengeFileSchema as tn, n as tr, pubsubTopicToDhtKey as tt, DecryptedChallengeRequestPublicationSchema as u, CreateRemoteCommunityFunctionArgumentSchema as un, t$5 as ur, removeUndefinedValuesRecursively as ut, PKCUserOptionsSchema as v, VotePubsubReservedFields as vn, FailedToFetchCommentUpdateFromGatewaysError as vr, sleepUntilTimeoutOrAbort as vt, contentContainsMarkdownAudio as w, CommentPubsubMessageReservedFields as wn, logger_default as wr, findCommunityInRegistry as wt, binaryKeyToPubsubTopic as x, CommentChallengeRequestToEncryptSchema as xn, FailedToFetchPageIpfsFromGatewaysError as xr, timestamp as xt, version_default as y, VoteSignedPropertyNames as yn, FailedToFetchCommunityFromGatewaysError as yr, statMfsPathSafely as yt, interruptibleSleep as z, CommentEditChallengeRequestToEncryptSchema as zn, parsedType as zr, untrackUpdatingCommunity as zt };

package/dist/bundled/chunks/{util-DSIDv1Cb.js → util-_-fNQNIV.js}

@@ -1,4 +1,4 @@
-import { br as PKCError, et as pubsubTopicToDhtKeyCid } from "./schema-HH2zeH-j.js";
+import { Sr as PKCError, nt as pubsubTopicToDhtKeyCid } from "./schema-5-rYJ-bC.js";
 import { ipnsSelector } from "ipns/selector";
 import { ipnsValidator } from "ipns/validator";
 import { unmarshalIPNSRecord } from "ipns";
@@ -476,6 +476,14 @@ async function cacheIpnsRecordInPubsubLocalStore({ localStore, routingKey, marsh
 	await localStore.put(routingKey, marshalledRecord);
 }
 const DEFAULT_CACHED_IPNS_RECORD_TTL_MS = 6e4;
+function ipnsCacheTtlJitterFactor(routingKey) {
+	let hash = 2166136261;
+	for (let i = 0; i < routingKey.length; i++) {
+		hash ^= routingKey[i];
+		hash = Math.imul(hash, 16777619) >>> 0;
+	}
+	return .75 + hash / 4294967296 * .25;
+}
 async function readFreshCachedIpnsRecordFromPubsubLocalStore({ localStore, routingKey, lastNetworkValidatedAtMs }) {
 	if (!await localStore.has(routingKey)) return void 0;
 	const { record: recordBytes, created } = await localStore.get(routingKey);
@@ -485,9 +493,9 @@ async function readFreshCachedIpnsRecordFromPubsubLocalStore({ localStore, routi
 		return;
 	}
 	const record = unmarshalIPNSRecord(recordBytes);
-	const ttlMs = record.ttl !== void 0 ? Number(record.ttl / 1000000n) : DEFAULT_CACHED_IPNS_RECORD_TTL_MS;
+	const effectiveTtlMs = (record.ttl !== void 0 ? Number(record.ttl / 1000000n) : DEFAULT_CACHED_IPNS_RECORD_TTL_MS) * ipnsCacheTtlJitterFactor(routingKey);
 	const lastConfirmedCurrentAtMs = Math.max(created.getTime(), lastNetworkValidatedAtMs ?? 0);
-	if (Date.now() - lastConfirmedCurrentAtMs >= ttlMs) return void 0;
+	if (Date.now() - lastConfirmedCurrentAtMs >= effectiveTtlMs) return void 0;
 	return record;
 }
 //#endregion

package/dist/bundled/index.js

@@ -1,2 +1,2 @@
-import { a as getShortCid, i as getShortAddress, n as challenges, o as nativeFunctions, r as createAnchorIpnsRecord, s as setNativeFunctions, t as PKC } from "./chunks/node-BrLiC0qX.js";
+import { a as getShortCid, i as getShortAddress, n as challenges, o as nativeFunctions, r as createAnchorIpnsRecord, s as setNativeFunctions, t as PKC } from "./chunks/node-C37nDOa8.js";
 export { challenges, createAnchorIpnsRecord, PKC as default, getShortAddress, getShortCid, nativeFunctions, setNativeFunctions };

package/dist/bundled/rpc/src/index.js

@@ -1,7 +1,7 @@
-import { Ct as findStartedCommunity, L as hideClassPrivateProps, Sr as logger_default, br as PKCError, lt as replaceXWithY, rr as t, tr as n } from "../../chunks/schema-HH2zeH-j.js";
-import { _ as parseRpcPublishAnchorRecordParam, c as parseRpcAuthorNameParam, d as parseRpcCommentRepliesPageParam, f as parseRpcCommunityIdentifierParam, g as parseRpcExportCommunityParam, h as parseRpcExportCommunityModLogsParam, l as parseRpcCancelExportParam, m as parseRpcEditCommunityParam, p as parseRpcCommunityPageParam, t as PKC, u as parseRpcCidParam, v as parseRpcPublishChallengeAnswersParam, y as parseRpcUnsubscribeParam } from "../../chunks/node-BrLiC0qX.js";
-import { An as parseSetNewSettingsPKCWsServerSchemaWithPKCErrorIfItFails, Cn as parseDecryptedChallengeAnswerWithPKCErrorIfItFails, J as buildPagesRuntimeFields, ct as pRetry, dn as parseCommunityEditOptionsSchemaWithPKCErrorIfItFails, dt as require_lib, jn as parseVoteChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, lt as pLimit, nn as parseCommentChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, on as parseCommentModerationChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, q as buildPageRuntimeFields, rn as parseCommentEditChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, rr as t$1, rt as extractCrosspostRuntimeFields, un as parseCommunityEditChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, ur as stringify, vn as parseCreateNewLocalCommunityUserOptionsSchemaWithPKCErrorIfItFails, yn as parseCreatePKCWsServerOptionsSchemaWithPKCErrorIfItFails } from "../../chunks/rpc-local-community-DOSee621.js";
-import { t as LocalCommunity } from "../../chunks/local-community-DgbMuVAA.js";
+import { Ht as pTimeout, R as hideClassPrivateProps, Sr as PKCError, Tt as findStartedCommunity, ar as t, dt as replaceXWithY, rr as n, wr as logger_default } from "../../chunks/schema-5-rYJ-bC.js";
+import { _ as parseRpcPublishAnchorRecordParam, c as parseRpcAuthorNameParam, d as parseRpcCommentRepliesPageParam, f as parseRpcCommunityIdentifierParam, g as parseRpcExportCommunityParam, h as parseRpcExportCommunityModLogsParam, l as parseRpcCancelExportParam, m as parseRpcEditCommunityParam, p as parseRpcCommunityPageParam, t as PKC, u as parseRpcCidParam, v as parseRpcPublishChallengeAnswersParam, y as parseRpcUnsubscribeParam } from "../../chunks/node-C37nDOa8.js";
+import { An as parseSetNewSettingsPKCWsServerSchemaWithPKCErrorIfItFails, Cn as parseDecryptedChallengeAnswerWithPKCErrorIfItFails, J as buildPagesRuntimeFields, ct as pRetry, dn as parseCommunityEditOptionsSchemaWithPKCErrorIfItFails, dt as require_lib, jn as parseVoteChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, lt as pLimit, nn as parseCommentChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, on as parseCommentModerationChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, q as buildPageRuntimeFields, rn as parseCommentEditChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, rr as t$1, rt as extractCrosspostRuntimeFields, un as parseCommunityEditChallengeRequestToEncryptSchemaWithPKCErrorIfItFails, ur as stringify, vn as parseCreateNewLocalCommunityUserOptionsSchemaWithPKCErrorIfItFails, yn as parseCreatePKCWsServerOptionsSchemaWithPKCErrorIfItFails } from "../../chunks/rpc-local-community-Dr_-Lb8I.js";
+import { t as LocalCommunity } from "../../chunks/local-community-Ce7303vY.js";
 import { fileURLToPath } from "node:url";
 import path from "path";
 import assert from "assert";
@@ -103,6 +103,7 @@ function sanitizeRpcNotificationResult(event, result) {
 //#endregion
 //#region dist/node/rpc/src/index.js
 const log = logger_default("pkc-js-rpc:pkc-ws-server");
+const DESTROY_CLIENTS_CLOSE_TIMEOUT_MS = 5e3;
 const AUTO_START_TRANSIENT_RETRIES = 8;
 const _isTransientKuboError = (error) => {
 	const markers = [
@@ -138,6 +139,7 @@ var PKCWsServer = class extends import_lib.TypedEmitter {
 		this._autoStartOnBoot = false;
 		this._exportCommunityInstances = /* @__PURE__ */ new Map();
 		this._ownsHttpServer = false;
+		this._pendingDisconnectionCleanups = /* @__PURE__ */ new Set();
 		const log = logger_default("pkc-js:PKCWsServer");
 		this.authKey = authKey;
 		this._autoStartOnBoot = startStartedCommunitiesOnStartup ?? true;
@@ -185,24 +187,14 @@ var PKCWsServer = class extends import_lib.TypedEmitter {
 			this._onSettingsChange[ws._id] = {};
 			log("Established connection with new RPC client", ws._id);
 		});
-		this.rpcWebsockets.on("disconnection", async (ws) => {
-			log("RPC client disconnected", ws._id, "number of rpc clients connected", this.rpcWebsockets.wss.clients.size);
-			const subscriptionCleanups = this.subscriptionCleanups[ws._id];
-			if (!subscriptionCleanups) {
-				delete this.subscriptionCleanups[ws._id];
-				delete this.connections[ws._id];
-				delete this._onSettingsChange[ws._id];
-				log("Disconnected from RPC client (no subscriptions to clean)", ws._id);
-				return;
-			}
-			for (const subscriptionId in subscriptionCleanups) {
-				await subscriptionCleanups[subscriptionId]();
-				delete subscriptionCleanups[subscriptionId];
-			}
-			delete this.subscriptionCleanups[ws._id];
-			delete this.connections[ws._id];
-			delete this._onSettingsChange[ws._id];
-			log("Disconnected from RPC client", ws._id);
+		this.rpcWebsockets.on("disconnection", (ws) => {
+			const cleanup = this._cleanUpDisconnectedClient(ws._id);
+			this._pendingDisconnectionCleanups.add(cleanup);
+			const untrack = () => this._pendingDisconnectionCleanups.delete(cleanup);
+			cleanup.then(untrack, (e) => {
+				log.error("Failed to clean up after RPC client disconnected", ws._id, e);
+				untrack();
+			});
 		});
 		this.rpcWebsocketsRegister("getComment", this.getComment.bind(this));
 		this.rpcWebsocketsRegister("getCommunityPage", this.getCommunityPage.bind(this));
@@ -1520,9 +1512,38 @@ var PKCWsServer = class extends import_lib.TypedEmitter {
 		delete connectionCleanups[subscriptionId];
 		return { success: true };
 	}
+	async _cleanUpDisconnectedClient(connectionId) {
+		log("RPC client disconnected", connectionId, "number of rpc clients connected", this.rpcWebsockets.wss.clients.size);
+		const subscriptionCleanups = this.subscriptionCleanups[connectionId];
+		if (!subscriptionCleanups) {
+			delete this.subscriptionCleanups[connectionId];
+			delete this.connections[connectionId];
+			delete this._onSettingsChange[connectionId];
+			log("Disconnected from RPC client (no subscriptions to clean)", connectionId);
+			return;
+		}
+		for (const subscriptionId in subscriptionCleanups) {
+			await subscriptionCleanups[subscriptionId]();
+			delete subscriptionCleanups[subscriptionId];
+		}
+		delete this.subscriptionCleanups[connectionId];
+		delete this.connections[connectionId];
+		delete this._onSettingsChange[connectionId];
+		log("Disconnected from RPC client", connectionId);
+	}
 	async destroy() {
 		for (const connectionId of t(this.subscriptionCleanups)) for (const subscriptionId of t(this.subscriptionCleanups[connectionId])) await this.unsubscribe([{ subscriptionId: Number(subscriptionId) }], connectionId);
+		const wssClosed = new Promise((resolve) => this.ws.once("close", () => resolve()));
 		this.ws.close();
+		for (const client of this.ws.clients) client.close(1e3, "PKCWsServer is shutting down");
+		try {
+			await pTimeout(wssClosed, { milliseconds: DESTROY_CLIENTS_CLOSE_TIMEOUT_MS });
+		} catch {
+			log.error("Some RPC clients did not complete the close handshake within", DESTROY_CLIENTS_CLOSE_TIMEOUT_MS, "ms of destroy(), terminating them");
+			for (const client of this.ws.clients) client.terminate();
+			await wssClosed;
+		}
+		await Promise.allSettled(this._pendingDisconnectionCleanups);
 		if (this._ownsHttpServer && this._httpServer) await new Promise((r) => this._httpServer.close(() => r()));
 		await (await this._getPKCInstance()).destroy();
 		for (const communityAddress of t(this._startedCommunities)) delete this._startedCommunities[communityAddress];

package/dist/node/clients/base-client-manager.d.ts

@@ -96,6 +96,7 @@ export declare class BaseClientsManager {
     resolveIpnsToCidP2P(ipnsName: string, loadOpts: {
         timeoutMs: number;
         abortSignal?: AbortSignal;
+        nocache?: boolean;
     }): Promise<{
         cid: string;
         ipnsHops: string[];

package/dist/node/clients/base-client-manager.js

@@ -469,7 +469,13 @@ export class BaseClientsManager {
     // chain of IPNS names traversed: ipnsHops[0] is the anchor (the name we were asked to
     // resolve) and ipnsHops.at(-1) is the terminal name (the name whose record points
     // directly at the /ipfs/ CID, i.e. the key that signs the content).
-    async resolveIpnsToCidP2P(ipnsName, loadOpts) {
+    async resolveIpnsToCidP2P(ipnsName, 
+    // `nocache: true` forces a network revalidation even on the libp2p-js resolver (whose
+    // default below is to let its gossip-fed routing-layer cache serve, issue #301). The
+    // community update loop sets it on safety-net ticks, which exist precisely for pushed
+    // records the cache never received. It is spread AFTER the per-client default, so the
+    // caller's value wins.
+    loadOpts) {
         const log = Logger("pkc-js:clients-manager:resolveIpnsToCidP2P");
         throwIfAbortSignalAborted(loadOpts.abortSignal);
         // recursive: false so the resolver returns the IMMEDIATE value of each record (so we can