@pkcprotocol/pkc-js 0.0.83 → 0.0.85

package/dist/node/index-with-compile-cache.d.ts

@@ -12,6 +12,7 @@ declare const _default: {
             path: import("zod").ZodOptional<import("zod").ZodString>;
             name: import("zod").ZodOptional<import("zod").ZodString>;
             options: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            publicOptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
             exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                 community: import("zod").ZodOptional<import("zod").ZodObject<{
                     addresses: import("zod").ZodArray<import("zod").ZodString>;
@@ -64,6 +65,7 @@ declare const _default: {
                 path: import("zod").ZodOptional<import("zod").ZodString>;
                 name: import("zod").ZodOptional<import("zod").ZodString>;
                 options: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+                publicOptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
                 exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                     community: import("zod").ZodOptional<import("zod").ZodObject<{
                         addresses: import("zod").ZodArray<import("zod").ZodString>;
@@ -123,7 +125,48 @@ declare const _default: {
             error: import("zod").ZodString;
             reason: import("zod").ZodOptional<import("zod").ZodString>;
         }, import("zod/v4/core").$strip>]>]>>>;
-    }, import("zod/v4/core").$strict>>>;
+        validateChallengeSettings: import("zod").ZodOptional<import("zod").ZodFunction<import("zod").ZodTuple<readonly [import("zod").ZodObject<{
+            challengeSettings: import("zod").ZodObject<{
+                path: import("zod").ZodOptional<import("zod").ZodString>;
+                name: import("zod").ZodOptional<import("zod").ZodString>;
+                options: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+                publicOptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                    community: import("zod").ZodOptional<import("zod").ZodObject<{
+                        addresses: import("zod").ZodArray<import("zod").ZodString>;
+                        maxCommentCids: import("zod").ZodNumber;
+                        postScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                        replyScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                        firstCommentTimestamp: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    }, import("zod/v4/core").$strict>>;
+                    postScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    replyScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    postCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    replyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    firstCommentTimestamp: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    challenges: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodNumber>>;
+                    role: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodUnion<[import("zod").ZodEnum<{
+                        owner: "owner";
+                        admin: "admin";
+                        moderator: "moderator";
+                    }>, import("zod").ZodString]>>>;
+                    address: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    rateLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    rateLimitChallengeSuccess: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    publicationType: import("zod").ZodOptional<import("zod").ZodObject<{
+                        post: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        reply: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        vote: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        commentEdit: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        commentModeration: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        communityEdit: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    }, import("zod/v4/core").$loose>>;
+                }, import("zod/v4/core").$loose>>>;
+                description: import("zod").ZodOptional<import("zod").ZodString>;
+                pendingApproval: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            }, import("zod/v4/core").$strict>;
+        }, import("zod/v4/core").$strip>], null>, import("zod").ZodVoid>>;
+    }, import("zod/v4/core").$loose>>>;
     createAnchorIpnsRecord: typeof import("./signer/ipns-record.js").createAnchorIpnsRecord;
 };
 export default _default;
@@ -139,6 +182,7 @@ export declare const challenges: Record<string, import("zod/v4/core").$InferInne
         path: import("zod").ZodOptional<import("zod").ZodString>;
         name: import("zod").ZodOptional<import("zod").ZodString>;
         options: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        publicOptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
         exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
             community: import("zod").ZodOptional<import("zod").ZodObject<{
                 addresses: import("zod").ZodArray<import("zod").ZodString>;
@@ -191,6 +235,7 @@ export declare const challenges: Record<string, import("zod/v4/core").$InferInne
             path: import("zod").ZodOptional<import("zod").ZodString>;
             name: import("zod").ZodOptional<import("zod").ZodString>;
             options: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            publicOptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
             exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                 community: import("zod").ZodOptional<import("zod").ZodObject<{
                     addresses: import("zod").ZodArray<import("zod").ZodString>;
@@ -250,7 +295,48 @@ export declare const challenges: Record<string, import("zod/v4/core").$InferInne
         error: import("zod").ZodString;
         reason: import("zod").ZodOptional<import("zod").ZodString>;
     }, import("zod/v4/core").$strip>]>]>>>;
-}, import("zod/v4/core").$strict>>>;
+    validateChallengeSettings: import("zod").ZodOptional<import("zod").ZodFunction<import("zod").ZodTuple<readonly [import("zod").ZodObject<{
+        challengeSettings: import("zod").ZodObject<{
+            path: import("zod").ZodOptional<import("zod").ZodString>;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            options: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            publicOptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                community: import("zod").ZodOptional<import("zod").ZodObject<{
+                    addresses: import("zod").ZodArray<import("zod").ZodString>;
+                    maxCommentCids: import("zod").ZodNumber;
+                    postScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    replyScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    firstCommentTimestamp: import("zod").ZodOptional<import("zod").ZodNumber>;
+                }, import("zod/v4/core").$strict>>;
+                postScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                replyScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                postCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+                replyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+                firstCommentTimestamp: import("zod").ZodOptional<import("zod").ZodNumber>;
+                challenges: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodNumber>>;
+                role: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodUnion<[import("zod").ZodEnum<{
+                    owner: "owner";
+                    admin: "admin";
+                    moderator: "moderator";
+                }>, import("zod").ZodString]>>>;
+                address: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                rateLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+                rateLimitChallengeSuccess: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                publicationType: import("zod").ZodOptional<import("zod").ZodObject<{
+                    post: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    reply: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    vote: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    commentEdit: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    commentModeration: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    communityEdit: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                }, import("zod/v4/core").$loose>>;
+            }, import("zod/v4/core").$loose>>>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            pendingApproval: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strict>;
+    }, import("zod/v4/core").$strip>], null>, import("zod").ZodVoid>>;
+}, import("zod/v4/core").$loose>>>;
 export declare const createAnchorIpnsRecord: typeof import("./signer/ipns-record.js").createAnchorIpnsRecord;
 export type { NameResolverInterface } from "./schema.js";
 export type { NameResolver } from "./types.js";

package/dist/node/index.d.ts

@@ -17,6 +17,7 @@ declare const PKC: {
             path: import("zod").ZodOptional<import("zod").ZodString>;
             name: import("zod").ZodOptional<import("zod").ZodString>;
             options: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            publicOptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
             exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                 community: import("zod").ZodOptional<import("zod").ZodObject<{
                     addresses: import("zod").ZodArray<import("zod").ZodString>;
@@ -69,6 +70,7 @@ declare const PKC: {
                 path: import("zod").ZodOptional<import("zod").ZodString>;
                 name: import("zod").ZodOptional<import("zod").ZodString>;
                 options: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+                publicOptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
                 exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                     community: import("zod").ZodOptional<import("zod").ZodObject<{
                         addresses: import("zod").ZodArray<import("zod").ZodString>;
@@ -128,7 +130,48 @@ declare const PKC: {
             error: import("zod").ZodString;
             reason: import("zod").ZodOptional<import("zod").ZodString>;
         }, import("zod/v4/core").$strip>]>]>>>;
-    }, import("zod/v4/core").$strict>>>;
+        validateChallengeSettings: import("zod").ZodOptional<import("zod").ZodFunction<import("zod").ZodTuple<readonly [import("zod").ZodObject<{
+            challengeSettings: import("zod").ZodObject<{
+                path: import("zod").ZodOptional<import("zod").ZodString>;
+                name: import("zod").ZodOptional<import("zod").ZodString>;
+                options: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+                publicOptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                    community: import("zod").ZodOptional<import("zod").ZodObject<{
+                        addresses: import("zod").ZodArray<import("zod").ZodString>;
+                        maxCommentCids: import("zod").ZodNumber;
+                        postScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                        replyScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                        firstCommentTimestamp: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    }, import("zod/v4/core").$strict>>;
+                    postScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    replyScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    postCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    replyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    firstCommentTimestamp: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    challenges: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodNumber>>;
+                    role: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodUnion<[import("zod").ZodEnum<{
+                        owner: "owner";
+                        admin: "admin";
+                        moderator: "moderator";
+                    }>, import("zod").ZodString]>>>;
+                    address: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                    rateLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    rateLimitChallengeSuccess: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    publicationType: import("zod").ZodOptional<import("zod").ZodObject<{
+                        post: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        reply: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        vote: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        commentEdit: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        commentModeration: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        communityEdit: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    }, import("zod/v4/core").$loose>>;
+                }, import("zod/v4/core").$loose>>>;
+                description: import("zod").ZodOptional<import("zod").ZodString>;
+                pendingApproval: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            }, import("zod/v4/core").$strict>;
+        }, import("zod/v4/core").$strip>], null>, import("zod").ZodVoid>>;
+    }, import("zod/v4/core").$loose>>>;
     createAnchorIpnsRecord: typeof signerCreateAnchorIpnsRecord;
 };
 export default PKC;
@@ -144,6 +187,7 @@ export declare const challenges: Record<string, import("zod/v4/core").$InferInne
         path: import("zod").ZodOptional<import("zod").ZodString>;
         name: import("zod").ZodOptional<import("zod").ZodString>;
         options: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        publicOptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
         exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
             community: import("zod").ZodOptional<import("zod").ZodObject<{
                 addresses: import("zod").ZodArray<import("zod").ZodString>;
@@ -196,6 +240,7 @@ export declare const challenges: Record<string, import("zod/v4/core").$InferInne
             path: import("zod").ZodOptional<import("zod").ZodString>;
             name: import("zod").ZodOptional<import("zod").ZodString>;
             options: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            publicOptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
             exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                 community: import("zod").ZodOptional<import("zod").ZodObject<{
                     addresses: import("zod").ZodArray<import("zod").ZodString>;
@@ -255,7 +300,48 @@ export declare const challenges: Record<string, import("zod/v4/core").$InferInne
         error: import("zod").ZodString;
         reason: import("zod").ZodOptional<import("zod").ZodString>;
     }, import("zod/v4/core").$strip>]>]>>>;
-}, import("zod/v4/core").$strict>>>;
+    validateChallengeSettings: import("zod").ZodOptional<import("zod").ZodFunction<import("zod").ZodTuple<readonly [import("zod").ZodObject<{
+        challengeSettings: import("zod").ZodObject<{
+            path: import("zod").ZodOptional<import("zod").ZodString>;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            options: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+            publicOptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                community: import("zod").ZodOptional<import("zod").ZodObject<{
+                    addresses: import("zod").ZodArray<import("zod").ZodString>;
+                    maxCommentCids: import("zod").ZodNumber;
+                    postScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    replyScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    firstCommentTimestamp: import("zod").ZodOptional<import("zod").ZodNumber>;
+                }, import("zod/v4/core").$strict>>;
+                postScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                replyScore: import("zod").ZodOptional<import("zod").ZodNumber>;
+                postCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+                replyCount: import("zod").ZodOptional<import("zod").ZodNumber>;
+                firstCommentTimestamp: import("zod").ZodOptional<import("zod").ZodNumber>;
+                challenges: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodNumber>>;
+                role: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodUnion<[import("zod").ZodEnum<{
+                    owner: "owner";
+                    admin: "admin";
+                    moderator: "moderator";
+                }>, import("zod").ZodString]>>>;
+                address: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+                rateLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+                rateLimitChallengeSuccess: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                publicationType: import("zod").ZodOptional<import("zod").ZodObject<{
+                    post: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    reply: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    vote: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    commentEdit: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    commentModeration: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    communityEdit: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                }, import("zod/v4/core").$loose>>;
+            }, import("zod/v4/core").$loose>>>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            pendingApproval: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strict>;
+    }, import("zod/v4/core").$strip>], null>, import("zod").ZodVoid>>;
+}, import("zod/v4/core").$loose>>>;
 export declare const createAnchorIpnsRecord: typeof signerCreateAnchorIpnsRecord;
 export type { NameResolverInterface } from "./schema.js";
 export type { NameResolver } from "./types.js";

package/dist/node/pkc/pkc-with-rpc-client.d.ts

@@ -1,5 +1,5 @@
 import { PKC } from "./pkc.js";
-import type { InputPKCOptions, GetCommunityArgs } from "../types.js";
+import type { InputPKCOptions, GetCommunityArgs, GetCommentArgs } from "../types.js";
 import { CreateRpcCommunityFunctionArgumentSchema } from "../community/schema.js";
 import { RpcLocalCommunity } from "../community/rpc-local-community.js";
 import { RpcRemoteCommunity } from "../community/rpc-remote-community.js";
@@ -18,7 +18,9 @@ export declare class PKCWithRpcClient extends PKC {
         resolvedAuthorName: string | null;
     }>;
     destroy(): Promise<void>;
-    getComment(commentCid: CidRpcParam): Promise<import("../publications/comment/comment.js").Comment>;
+    getComment(getCommentArgs: GetCommentArgs): Promise<import("../publications/comment/comment.js").Comment>;
     getCommunity(getCommunityArgs: GetCommunityArgs): Promise<import("../community/remote-community.js").RemoteCommunity>;
-    createCommunity(options?: z.infer<typeof CreateRpcCommunityFunctionArgumentSchema> | RpcRemoteCommunityJson | RpcLocalCommunityJson): Promise<RpcLocalCommunity | RpcRemoteCommunity>;
+    createCommunity(options?: z.infer<typeof CreateRpcCommunityFunctionArgumentSchema> | RpcRemoteCommunityJson | RpcLocalCommunityJson, opts?: {
+        abortSignal?: AbortSignal;
+    }): Promise<RpcLocalCommunity | RpcRemoteCommunity>;
 }

package/dist/node/pkc/pkc-with-rpc-client.js

@@ -3,6 +3,8 @@ import { PKC } from "./pkc.js";
 import { parseCreateRpcCommunityFunctionArgumentSchemaWithPKCErrorIfItFails } from "../schema/schema-util.js";
 import { RpcLocalCommunity } from "../community/rpc-local-community.js";
 import { RpcRemoteCommunity } from "../community/rpc-remote-community.js";
+import { PKCError } from "../pkc-error.js";
+import { rejectWhenAbortSignalFires, rejectWhenCommunityStopsOrAborts, throwIfAbortSignalAborted } from "../util.js";
 import { parseRpcAuthorNameParam, parseRpcCidParam, parseRpcFetchCidParam } from "../clients/rpc-client/rpc-schema-util.js";
 import { listStartedCommunities } from "./tracked-instance-registry-util.js";
 // This is a helper class for separating RPC-client logic from main PKC
@@ -47,9 +49,23 @@ export class PKCWithRpcClient extends PKC {
         await super.destroy();
         await this._pkcRpcClient.destroy();
     }
-    async getComment(commentCid) {
-        const parsedArgs = parseRpcCidParam(commentCid);
-        const commentIpfs = await this._pkcRpcClient.getComment(parsedArgs);
+    // The RPC call below has no cancellation of its own, so an aborting caller (and pkc.destroy(),
+    // which cannot reach into this function) would be left waiting on it. Racing the combined signal
+    // gives them a way out, matching the direct path in PKC.getComment (issue #278).
+    async getComment(getCommentArgs) {
+        const { abortSignal, ...cidArgs } = getCommentArgs;
+        const parsedArgs = parseRpcCidParam(cidArgs);
+        const cancellation = rejectWhenAbortSignalFires({
+            abortSignal: this._combineWithDestroyAbortSignal(abortSignal),
+            error: () => new PKCError("ERR_GET_COMMENT_ABORTED", { getCommentArgs: parsedArgs, abortReason: abortSignal?.reason })
+        });
+        let commentIpfs;
+        try {
+            commentIpfs = await Promise.race([this._pkcRpcClient.getComment(parsedArgs), cancellation.promise]);
+        }
+        finally {
+            cancellation.cleanup();
+        }
         return this.createComment({ ...parsedArgs, raw: { ...parsedArgs?.raw, comment: commentIpfs } });
     }
     async getCommunity(getCommunityArgs) {
@@ -58,8 +74,9 @@ export class PKCWithRpcClient extends PKC {
         }
         return super.getCommunity(getCommunityArgs);
     }
-    async createCommunity(options = {}) {
+    async createCommunity(options = {}, opts) {
         const log = Logger("pkc-js:pkc-with-rpc-client:createCommunity");
+        throwIfAbortSignalAborted(opts?.abortSignal);
         // No need to parse if it's a jsonified instance
         const parsedRpcOptions = "clients" in options ? options : parseCreateRpcCommunityFunctionArgumentSchemaWithPKCErrorIfItFails(options);
         log.trace("Received community options to create a community instance over RPC:", options);
@@ -97,9 +114,30 @@ export class PKCWithRpcClient extends PKC {
                 const updatePromise = new Promise((resolve) => community.once("update", resolve));
                 let error;
                 const errorPromise = new Promise((resolve) => community.once("error", (err) => resolve((error = err))));
-                await community._createAndSubscribeToNewUpdatingCommunity(community);
-                await community.update();
-                await Promise.race([updatePromise, errorPromise]);
+                // Every wait below is unbounded: the subscribe call may never be answered, and the
+                // server may never push an update for a community it hosts. Without something to
+                // lose to, an aborting caller (and pkc.destroy(), which cannot reach into this
+                // function) is left with a promise that never settles — issue #277. The instance is
+                // tracked in _updatingCommunities before the first wait, so a third-party stop()
+                // reaches it too, and that is the second way out.
+                const cancellation = rejectWhenCommunityStopsOrAborts({
+                    community,
+                    abortSignal: this._combineWithDestroyAbortSignal(opts?.abortSignal)
+                });
+                try {
+                    await Promise.race([community._createAndSubscribeToNewUpdatingCommunity(community), cancellation.promise]);
+                    await Promise.race([community.update(), cancellation.promise]);
+                    await Promise.race([updatePromise, errorPromise, cancellation.promise]);
+                }
+                catch (e) {
+                    // stop() is a no-op on an instance that is already stopped, which is exactly the
+                    // case when we lost to a stop rather than to an abort.
+                    await community.stop().catch((stopErr) => log.error("Failed to stop a cancelled community instance", stopErr));
+                    throw e;
+                }
+                finally {
+                    cancellation.cleanup();
+                }
                 await community.stop();
                 if (error)
                     throw error;

package/dist/node/pkc/pkc-with-rpc-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"pkc-with-rpc-client.js","sourceRoot":"","sources":["../../../src/pkc/pkc-with-rpc-client.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,kEAAkE,EAAE,MAAM,0BAA0B,CAAC;AAE9G,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAK1E,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAC5H,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAG7E,uEAAuE;AACvE,sCAAsC;AACtC,MAAM,OAAO,gBAAiB,SAAQ,GAAG;IAIrC,YAAY,OAAwB;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,2DAA2D;IAC5J,CAAC;IAEQ,KAAK,CAAC,KAAK;QAChB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,MAAM,CAAC,kCAAkC,CAAC,CAAC;QAEvD,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QAEtB,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,CAAC;QAEjG,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACrD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YACxD,SAAS,CAAC,+BAA+B,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACtD,GAAG,CAAC,KAAK,CAAC,0BAA0B,EAAE,MAAM,EAAE,yBAAyB,EAAE,GAAG,CAAC,CAAC;YAClF,CAAC,CAAC,CAAC;YACH,SAAS,CAAC,4BAA4B,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACnD,GAAG,CAAC,KAAK,CAAC,0BAA0B,EAAE,MAAM,EAAE,sBAAsB,EAAE,GAAG,CAAC,CAAC;YAC/E,CAAC,CAAC,CAAC;QACP,CAAC;QACD,gDAAgD;QAEhD,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,WAAW,EAAE,EAAE;YACpD,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACP,CAAC;IAEQ,KAAK,CAAC,QAAQ,CAAC,GAAgB;QACpC,MAAM,SAAS,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;QACjD,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3D,CAAC;IAEQ,KAAK,CAAC,iBAAiB,CAAC,IAAwB;QACrD,MAAM,UAAU,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC;IAEQ,KAAK,CAAC,OAAO;QAClB,KAAK,MAAM,gBAAgB,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,MAAM,gBAAgB,CAAC,kBAAkB,EAAE,CAAC;QAChD,CAAC;QACD,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;IACvC,CAAC;IAEQ,KAAK,CAAC,UAAU,CAAC,UAAuB;QAC7C,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,aAAa,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,GAAI,UAA0B,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;IACrH,CAAC;IAEQ,KAAK,CAAC,YAAY,CAAC,gBAAkC;QAC1D,IAAI,CAAC,gBAAgB,CAAC,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC;YACrF,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,KAAK,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAChD,CAAC;IAEQ,KAAK,CAAC,eAAe,CAC1B,UAAqH,EAAE;QAEvH,MAAM,GAAG,GAAG,MAAM,CAAC,4CAA4C,CAAC,CAAC;QAEjE,gDAAgD;QAChD,MAAM,gBAAgB,GAClB,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kEAAkE,CAAC,OAAO,CAAC,CAAC;QAEjH,GAAG,CAAC,KAAK,CAAC,qEAAqE,EAAE,OAAO,CAAC,CAAC;QAE1F,MAAM,aAAa,GACf,CAAC,SAAS,IAAI,gBAAgB,IAAI,OAAO,gBAAgB,CAAC,OAAO,KAAK,QAAQ,CAAC;YAC/E,CAAC,MAAM,IAAI,gBAAgB,IAAI,OAAO,gBAAgB,CAAC,IAAI,KAAK,QAAQ,CAAC;YACzE,CAAC,WAAW,IAAI,gBAAgB,IAAI,OAAO,gBAAgB,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC;QACxF,MAAM,gBAAgB,GAChB,gBAA4C,CAAC,OAA8B;YAC3E,gBAA4C,CAAC,IAA2B;YACxE,gBAA4C,CAAC,SAAgC,CAAC;QAEpF,IAAI,aAAa,IAAI,gBAAgB,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,8BAA8B,EAAE,CAAC;YAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,iEAAiE;YAC1G,MAAM,mBAAmB,GAAG,cAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;YAEtE,IAAI,SAAS,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAAC;gBAC9C,mGAAmG;gBACnG,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBAC9C,MAAM,SAAS,GAAG,gBAAoD,CAAC;gBACvE,MAAM,SAAS,GAAI,SAAS,CAAC,GAA4C,EAAE,cAE5D,CAAC;gBAChB,IAAI,SAAS,EAAE,CAAC;oBACZ,IAAI,WAAW,IAAI,SAAS;wBAAE,SAAS,CAAC,+CAA+C,CAAC,SAAS,CAAC,CAAC;;wBAC9F,SAAS,CAAC,gDAAgD,CAAC,SAAS,CAAC,CAAC;gBAC/E,CAAC;gBACD,IAAI,SAAS,CAAC,GAAG;oBAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;gBAC/D,MAAM,SAAS,CAAC,0BAA0B,EAAE,CAAC;gBAC7C,OAAO,SAAS,CAAC;YACrB,CAAC;iBAAM,IAAI,mBAAmB,EAAE,CAAC;gBAC7B,uCAAuC;gBACvC,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBAC9C,SAAS,CAAC,UAAU,CAAC,gBAAiB,CAAC,CAAC;gBACxC,0CAA0C;gBAC1C,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;gBAClF,IAAI,KAAmC,CAAC;gBACxC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxG,MAAM,SAAS,CAAC,yCAAyC,CAAC,SAAS,CAAC,CAAC;gBACrE,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;gBACzB,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;gBAClD,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;gBACvB,IAAI,KAAK;oBAAE,MAAM,KAAK,CAAC;gBACvB,MAAM,SAAS,CAAC,0BAA0B,EAAE,CAAC;gBAC7C,OAAO,SAAS,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACJ,GAAG,CAAC,KAAK,CAAC,uDAAuD,EAAE,gBAAgB,CAAC,CAAC;gBACrF,MAAM,eAAe,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACrD,MAAM,IAAI,CAAC,qCAAqC,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;gBAEpF,OAAO,eAAe,CAAC;YAC3B,CAAC;QACL,CAAC;aAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,oFAAoF;YACpF,IAAI,WAAW,IAAI,gBAAgB,EAAE,CAAC;gBAClC,MAAM,eAAe,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACrD,MAAM,IAAI,CAAC,qCAAqC,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;gBACpF,OAAO,eAAe,CAAC;YAC3B,CAAC;YACD,uCAAuC;YACvC,MAAM,2BAA2B,GAAG,MAAM,IAAI,CAAC,aAAc,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;YAChG,GAAG,CACC,oCAAoC,2BAA2B,CAAC,cAAc,CAAC,OAAO,eAAe,EACrG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC,CAC1D,CAAC;YACF,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,SAAS,CAAC,gDAAgD,CAAC,2BAA2B,CAAC,CAAC;YAC9F,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YACpC,MAAM,IAAI,CAAC,mCAAmC,CAAC,2BAA2B,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YACnG,MAAM,SAAS,CAAC,0BAA0B,EAAE,CAAC;YAC7C,OAAO,SAAS,CAAC;QACrB,CAAC;;YAAM,MAAM,KAAK,CAAC,sFAAsF,CAAC,CAAC;IAC/G,CAAC;CACJ"}
+{"version":3,"file":"pkc-with-rpc-client.js","sourceRoot":"","sources":["../../../src/pkc/pkc-with-rpc-client.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,kEAAkE,EAAE,MAAM,0BAA0B,CAAC;AAE9G,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAG1E,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAErH,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAC5H,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAI7E,uEAAuE;AACvE,sCAAsC;AACtC,MAAM,OAAO,gBAAiB,SAAQ,GAAG;IAIrC,YAAY,OAAwB;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,2DAA2D;IAC5J,CAAC;IAEQ,KAAK,CAAC,KAAK;QAChB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,MAAM,CAAC,kCAAkC,CAAC,CAAC;QAEvD,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QAEtB,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,CAAC;QAEjG,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACrD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YACxD,SAAS,CAAC,+BAA+B,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACtD,GAAG,CAAC,KAAK,CAAC,0BAA0B,EAAE,MAAM,EAAE,yBAAyB,EAAE,GAAG,CAAC,CAAC;YAClF,CAAC,CAAC,CAAC;YACH,SAAS,CAAC,4BAA4B,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACnD,GAAG,CAAC,KAAK,CAAC,0BAA0B,EAAE,MAAM,EAAE,sBAAsB,EAAE,GAAG,CAAC,CAAC;YAC/E,CAAC,CAAC,CAAC;QACP,CAAC;QACD,gDAAgD;QAEhD,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,WAAW,EAAE,EAAE;YACpD,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACP,CAAC;IAEQ,KAAK,CAAC,QAAQ,CAAC,GAAgB;QACpC,MAAM,SAAS,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;QACjD,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3D,CAAC;IAEQ,KAAK,CAAC,iBAAiB,CAAC,IAAwB;QACrD,MAAM,UAAU,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC;IAEQ,KAAK,CAAC,OAAO;QAClB,KAAK,MAAM,gBAAgB,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,MAAM,gBAAgB,CAAC,kBAAkB,EAAE,CAAC;QAChD,CAAC;QACD,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;IACvC,CAAC;IAED,+FAA+F;IAC/F,iGAAiG;IACjG,iFAAiF;IACxE,KAAK,CAAC,UAAU,CAAC,cAA8B;QACpD,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,GAAG,cAAc,CAAC;QACnD,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,YAAY,GAAG,0BAA0B,CAAC;YAC5C,WAAW,EAAE,IAAI,CAAC,8BAA8B,CAAC,WAAW,CAAC;YAC7D,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,yBAAyB,EAAE,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;SACzH,CAAC,CAAC;QACH,IAAI,WAA4D,CAAC;QACjE,IAAI,CAAC;YACD,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACxG,CAAC;gBAAS,CAAC;YACP,YAAY,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,GAAI,UAA0B,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;IACrH,CAAC;IAEQ,KAAK,CAAC,YAAY,CAAC,gBAAkC;QAC1D,IAAI,CAAC,gBAAgB,CAAC,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC;YACrF,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,KAAK,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAChD,CAAC;IAEQ,KAAK,CAAC,eAAe,CAC1B,UAAqH,EAAE,EACvH,IAAoC;QAEpC,MAAM,GAAG,GAAG,MAAM,CAAC,4CAA4C,CAAC,CAAC;QACjE,yBAAyB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAE7C,gDAAgD;QAChD,MAAM,gBAAgB,GAClB,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kEAAkE,CAAC,OAAO,CAAC,CAAC;QAEjH,GAAG,CAAC,KAAK,CAAC,qEAAqE,EAAE,OAAO,CAAC,CAAC;QAE1F,MAAM,aAAa,GACf,CAAC,SAAS,IAAI,gBAAgB,IAAI,OAAO,gBAAgB,CAAC,OAAO,KAAK,QAAQ,CAAC;YAC/E,CAAC,MAAM,IAAI,gBAAgB,IAAI,OAAO,gBAAgB,CAAC,IAAI,KAAK,QAAQ,CAAC;YACzE,CAAC,WAAW,IAAI,gBAAgB,IAAI,OAAO,gBAAgB,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC;QACxF,MAAM,gBAAgB,GAChB,gBAA4C,CAAC,OAA8B;YAC3E,gBAA4C,CAAC,IAA2B;YACxE,gBAA4C,CAAC,SAAgC,CAAC;QAEpF,IAAI,aAAa,IAAI,gBAAgB,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,8BAA8B,EAAE,CAAC;YAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,iEAAiE;YAC1G,MAAM,mBAAmB,GAAG,cAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;YAEtE,IAAI,SAAS,IAAI,OAAO,IAAI,mBAAmB,EAAE,CAAC;gBAC9C,mGAAmG;gBACnG,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBAC9C,MAAM,SAAS,GAAG,gBAAoD,CAAC;gBACvE,MAAM,SAAS,GAAI,SAAS,CAAC,GAA4C,EAAE,cAE5D,CAAC;gBAChB,IAAI,SAAS,EAAE,CAAC;oBACZ,IAAI,WAAW,IAAI,SAAS;wBAAE,SAAS,CAAC,+CAA+C,CAAC,SAAS,CAAC,CAAC;;wBAC9F,SAAS,CAAC,gDAAgD,CAAC,SAAS,CAAC,CAAC;gBAC/E,CAAC;gBACD,IAAI,SAAS,CAAC,GAAG;oBAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;gBAC/D,MAAM,SAAS,CAAC,0BAA0B,EAAE,CAAC;gBAC7C,OAAO,SAAS,CAAC;YACrB,CAAC;iBAAM,IAAI,mBAAmB,EAAE,CAAC;gBAC7B,uCAAuC;gBACvC,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBAC9C,SAAS,CAAC,UAAU,CAAC,gBAAiB,CAAC,CAAC;gBACxC,0CAA0C;gBAC1C,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;gBAClF,IAAI,KAAmC,CAAC;gBACxC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxG,mFAAmF;gBACnF,iFAAiF;gBACjF,+EAA+E;gBAC/E,oFAAoF;gBACpF,iFAAiF;gBACjF,kDAAkD;gBAClD,MAAM,YAAY,GAAG,gCAAgC,CAAC;oBAClD,SAAS;oBACT,WAAW,EAAE,IAAI,CAAC,8BAA8B,CAAC,IAAI,EAAE,WAAW,CAAC;iBACtE,CAAC,CAAC;gBACH,IAAI,CAAC;oBACD,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,yCAAyC,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;oBAC3G,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;oBAC/D,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC5E,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACT,iFAAiF;oBACjF,uDAAuD;oBACvD,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,+CAA+C,EAAE,OAAO,CAAC,CAAC,CAAC;oBAC/G,MAAM,CAAC,CAAC;gBACZ,CAAC;wBAAS,CAAC;oBACP,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC3B,CAAC;gBACD,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;gBACvB,IAAI,KAAK;oBAAE,MAAM,KAAK,CAAC;gBACvB,MAAM,SAAS,CAAC,0BAA0B,EAAE,CAAC;gBAC7C,OAAO,SAAS,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACJ,GAAG,CAAC,KAAK,CAAC,uDAAuD,EAAE,gBAAgB,CAAC,CAAC;gBACrF,MAAM,eAAe,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACrD,MAAM,IAAI,CAAC,qCAAqC,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;gBAEpF,OAAO,eAAe,CAAC;YAC3B,CAAC;QACL,CAAC;aAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,oFAAoF;YACpF,IAAI,WAAW,IAAI,gBAAgB,EAAE,CAAC;gBAClC,MAAM,eAAe,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACrD,MAAM,IAAI,CAAC,qCAAqC,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;gBACpF,OAAO,eAAe,CAAC;YAC3B,CAAC;YACD,uCAAuC;YACvC,MAAM,2BAA2B,GAAG,MAAM,IAAI,CAAC,aAAc,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;YAChG,GAAG,CACC,oCAAoC,2BAA2B,CAAC,cAAc,CAAC,OAAO,eAAe,EACrG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC,CAC1D,CAAC;YACF,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,SAAS,CAAC,gDAAgD,CAAC,2BAA2B,CAAC,CAAC;YAC9F,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YACpC,MAAM,IAAI,CAAC,mCAAmC,CAAC,2BAA2B,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YACnG,MAAM,SAAS,CAAC,0BAA0B,EAAE,CAAC;YAC7C,OAAO,SAAS,CAAC;QACrB,CAAC;;YAAM,MAAM,KAAK,CAAC,sFAAsF,CAAC,CAAC;IAC/G,CAAC;CACJ"}

package/dist/node/pkc/pkc.d.ts

@@ -1,4 +1,4 @@
-import type { StorageInterface, GatewayClient, KuboRpcClient, PKCEvents, PubsubClient, ParsedPKCOptions, LRUStorageInterface, LRUStorageConstructor, InputPKCOptions, PKCMemCaches, GetCommunityArgs } from "../types.js";
+import type { StorageInterface, GatewayClient, KuboRpcClient, PKCEvents, PubsubClient, ParsedPKCOptions, LRUStorageInterface, LRUStorageConstructor, InputPKCOptions, PKCMemCaches, GetCommunityArgs, GetCommentArgs } from "../types.js";
 import { Comment } from "../publications/comment/comment.js";
 import Vote from "../publications/vote/vote.js";
 import { CommentEdit } from "../publications/comment-edit/comment-edit.js";
@@ -102,7 +102,7 @@ export declare class PKC extends PKCTypedEmitter<PKCEvents> implements ParsedPKC
     _waitForHttpRoutersSetupToSettle(): Promise<void>;
     _init(): Promise<void>;
     getCommunity(getCommunityArgs: GetCommunityArgs): Promise<RemoteCommunity>;
-    getComment(cid: CidRpcParam): Promise<Comment>;
+    getComment(getCommentArgs: GetCommentArgs): Promise<Comment>;
     private _initMissingFieldsOfPublicationBeforeSigning;
     private _createCommentInstanceFromAnotherCommentInstance;
     createComment(options: CommentIpfsType | CommentPubsubMessagePublication | {
@@ -119,7 +119,9 @@ export declare class PKC extends PKCTypedEmitter<PKCEvents> implements ParsedPKC
     private _createRemoteCommunityInstance;
     private _createLocalCommunity;
     private _createCommunityInstanceFromJsonifiedCommunity;
-    createCommunity(options?: z.infer<typeof CreateCommunityFunctionArgumentsSchema> | CommunityJson): Promise<RemoteCommunity | RpcRemoteCommunity | RpcLocalCommunity | LocalCommunity>;
+    createCommunity(options?: z.infer<typeof CreateCommunityFunctionArgumentsSchema> | CommunityJson, opts?: {
+        abortSignal?: AbortSignal;
+    }): Promise<RemoteCommunity | RpcRemoteCommunity | RpcLocalCommunity | LocalCommunity>;
     _createVoteInstanceFromJsonfiedVote(jsonfied: VoteJson): Promise<Vote>;
     createVote(options: CreateVoteOptions | VotePubsubMessagePublication | VoteJson): Promise<Vote>;
     _createCommentEditInstanceFromJsonfiedCommentEdit(jsonfied: CommentEditTypeJson): Promise<CommentEdit>;
@@ -140,5 +142,6 @@ export declare class PKC extends PKCTypedEmitter<PKCEvents> implements ParsedPKC
     }): Promise<void>;
     _createStorageLRU(opts: Omit<LRUStorageConstructor, "pkc">): Promise<LRUStorageInterface>;
     _getDestroyAbortSignal(): AbortSignal;
+    _combineWithDestroyAbortSignal(abortSignal?: AbortSignal): AbortSignal;
     destroy(): Promise<void>;
 }

package/dist/node/pkc/pkc.js

@@ -1,6 +1,6 @@
 import { getDefaultDataPath, listCommunitiesSync as nodeListCommunities, createKuboRpcClient, monitorCommunitiesDirectory, tryToDeleteCommunitiesThatFailedToBeDeletedBefore } from "../runtime/node/util.js";
 import { Comment } from "../publications/comment/comment.js";
-import { waitForUpdateInCommunityInstanceWithErrorAndTimeout, areEquivalentCommunityAddresses, deepMergeRuntimeFields, doesDomainAddressHaveCapitalLetter, hideClassPrivateProps, isStringDomain, removeUndefinedValuesRecursively, timestamp, resolveWhenPredicateIsTrue } from "../util.js";
+import { waitForUpdateInCommunityInstanceWithErrorAndTimeout, areEquivalentCommunityAddresses, deepMergeRuntimeFields, doesDomainAddressHaveCapitalLetter, hideClassPrivateProps, isStringDomain, removeUndefinedValuesRecursively, timestamp, resolveWhenPredicateIsTrue, throwIfAbortSignalAborted } from "../util.js";
 import Vote from "../publications/vote/vote.js";
 import { createSigner } from "../signer/index.js";
 import { CommentEdit } from "../publications/comment-edit/comment-edit.js";
@@ -277,28 +277,67 @@ export class PKC extends PKCTypedEmitter {
         this._clientsManager = new PKCClientsManager(this);
         hideClassPrivateProps(this);
     }
+    // `abortSignal` unwinds the IPNS wait below immediately instead of blocking for
+    // `_timeouts["community-ipns"]`, and rejects with ERR_GET_COMMUNITY_ABORTED (issue #275). It has
+    // to be split off before the rest reaches createCommunity(), whose schemas are `.strict()`.
     async getCommunity(getCommunityArgs) {
-        if (!getCommunityArgs.address && !getCommunityArgs.name && !getCommunityArgs.publicKey) {
+        const { abortSignal, ...communityIdentifier } = getCommunityArgs;
+        if (!communityIdentifier.address && !communityIdentifier.name && !communityIdentifier.publicKey) {
             throw new Error("At least one of address, name, or publicKey must be provided");
         }
-        const community = await this.createCommunity(getCommunityArgs);
+        // Same code as an abort mid-fetch, so callers have one thing to check regardless of when the
+        // signal fired, and we skip creating an instance we would only stop again.
+        if (abortSignal?.aborted)
+            throw new PKCError("ERR_GET_COMMUNITY_ABORTED", { communityIdentifier, abortReason: abortSignal.reason });
+        const community = await this.createCommunity(communityIdentifier, { abortSignal });
         if (typeof community.createdAt === "number")
             return community; // It's a local community, and already has been loaded, no need to wait
         const timeoutMs = this._timeouts["community-ipns"];
-        await waitForUpdateInCommunityInstanceWithErrorAndTimeout(community, timeoutMs);
+        await waitForUpdateInCommunityInstanceWithErrorAndTimeout({ community, timeoutMs, abortSignal });
         return community;
     }
-    async getComment(cid) {
+    // `abortSignal` unwinds the CommentIpfs wait below immediately instead of blocking for
+    // `_timeouts["comment-ipfs"]`, and rejects with ERR_GET_COMMENT_ABORTED (issue #278). It has to
+    // be split off before the rest reaches createComment(), which would otherwise carry the signal
+    // onto the instance — the same reason `abortSignal` is a reserved comment field.
+    async getComment(getCommentArgs) {
         const log = Logger("pkc-js:pkc:getComment");
-        const parsedGetCommentArgs = parseRpcCidParam(cid);
+        const { abortSignal, ...cidArgs } = getCommentArgs;
+        const parsedGetCommentArgs = parseRpcCidParam(cidArgs);
+        // Same code as an abort mid-fetch, so callers have one thing to check regardless of when the
+        // signal fired, and we skip creating an instance we would only stop again.
+        if (abortSignal?.aborted)
+            throw new PKCError("ERR_GET_COMMENT_ABORTED", { getCommentArgs: parsedGetCommentArgs, abortReason: abortSignal.reason });
         // getComment is interested in loading CommentIpfs only
         const comment = await this.createComment(parsedGetCommentArgs);
         let lastUpdateError;
         const errorListener = (err) => (lastUpdateError = err);
         comment.on("error", errorListener);
+        // Rejects the race below on abort. Reported as ERR_GET_COMMENT_ABORTED rather than as the
+        // timeout, so callers can tell a slow network from a cancellation.
+        let abortError;
+        let abortReject;
+        const abortListener = () => {
+            abortError = new PKCError("ERR_GET_COMMENT_ABORTED", {
+                getCommentArgs: parsedGetCommentArgs,
+                abortReason: abortSignal?.reason,
+                lastUpdateError
+            });
+            abortReject?.(abortError);
+        };
+        const abortPromise = new Promise((_, reject) => {
+            abortReject = reject;
+        });
+        // pTimeout attaches its own handler, but only once we hand it the race below. Give it one up
+        // front so an abort landing before that never surfaces as an unhandled rejection.
+        void abortPromise.catch(() => { });
+        // The signal outlives this call (a caller's long-lived stop signal), so the listener is
+        // removed in the `finally` on every outcome. `{ once: true }` alone only detaches it when
+        // abort fires, which leaks one listener per call (issues #145, #146).
+        abortSignal?.addEventListener("abort", abortListener);
         const commentTimeout = this._timeouts["comment-ipfs"];
         try {
-            await pTimeout(comment._attemptInfintelyToLoadCommentIpfs(), {
+            await pTimeout(Promise.race([comment._attemptInfintelyToLoadCommentIpfs(), abortPromise]), {
                 milliseconds: commentTimeout,
                 message: lastUpdateError ||
                     new TimeoutError(`pkc.getComment({cid: ${parsedGetCommentArgs}}) timed out after ${commentTimeout}ms`)
@@ -308,11 +347,16 @@ export class PKC extends PKCTypedEmitter {
             return comment;
         }
         catch (e) {
+            // Abort wins over whatever else the comment happened to emit: the caller cancelled on
+            // purpose, so reporting a stale retriable error instead would be misleading.
+            if (abortError)
+                throw abortError;
             if (lastUpdateError)
                 throw lastUpdateError;
             throw e;
         }
         finally {
+            abortSignal?.removeEventListener("abort", abortListener);
             comment.removeListener("error", errorListener);
             await comment.stop();
         }
@@ -589,8 +633,13 @@ export class PKC extends PKCTypedEmitter {
         else
             return this._createRemoteCommunityInstance(jsonfied);
     }
-    async createCommunity(options = {}) {
+    // `opts.abortSignal` is a second parameter rather than a key on `options`, because `options` is
+    // zod-parsed by `.strict()` schemas that would reject the extra key. It only has teeth on the
+    // RPC path, whose local-community branch parks on waits with no timeout (issue #277); here it
+    // just refuses to start work the caller has already given up on.
+    async createCommunity(options = {}, opts) {
         const log = Logger("pkc-js:pkc:createCommunity");
+        throwIfAbortSignalAborted(opts?.abortSignal);
         if ("clients" in options)
             return this._createCommunityInstanceFromJsonifiedCommunity(options);
         const parsedOptions = options;
@@ -937,10 +986,23 @@ export class PKC extends PKCTypedEmitter {
         return this._storageLRUs[opts.cacheName];
     }
     _getDestroyAbortSignal() {
-        if (!this._destroyAbortController)
+        if (!this._destroyAbortController) {
             this._destroyAbortController = new AbortController();
+            // destroy() aborts with `?.`, so nothing happens there if no caller had asked for the
+            // signal yet. Without this, the first caller to ask afterwards is handed a live signal
+            // for a pkc that is already torn down, and waits on it forever (issue #277).
+            if (this.destroyed)
+                this._destroyAbortController.abort(new PKCError("ERR_PKC_IS_DESTROYED"));
+        }
         return this._destroyAbortController.signal;
     }
+    // Folds teardown into a caller's signal, so work nobody explicitly cancelled still stops when the
+    // pkc is destroyed. Returns the destroy signal untouched when there is nothing to combine, which
+    // keeps AbortSignal.any() (and the listener it registers on both sources) off the common path.
+    _combineWithDestroyAbortSignal(abortSignal) {
+        const destroySignal = this._getDestroyAbortSignal();
+        return abortSignal ? AbortSignal.any([abortSignal, destroySignal]) : destroySignal;
+    }
     async destroy() {
         const log = Logger("pkc-js:pkc:destroy");
         if (this.destroyed)