@pkcprotocol/pkc-js 0.0.11

package/dist/node/helia/util.js

@@ -0,0 +1,98 @@
+import { PKCError } from "../pkc-error.js";
+import { pubsubTopicToDhtKeyCid } from "../util.js";
+export async function connectToPubsubPeers({ helia, pubsubTopic, maxPeers, options, log }) {
+    // TODO need to check if this hangs or not
+    const contentCid = pubsubTopicToDhtKeyCid(pubsubTopic);
+    const peersWithContent = [];
+    const connectedPeersWithContent = [];
+    const peerDialToError = {};
+    // Create an abort controller to handle hanging findProviders
+    const abortController = new AbortController();
+    const combinedSignal = options?.signal ? AbortSignal.any([options.signal, abortController.signal]) : abortController.signal;
+    let shouldStop = false;
+    // Set up periodic check for pubsub subscribers
+    const checkInterval = setInterval(() => {
+        if (helia.libp2p.services.pubsub.getSubscribers(pubsubTopic).length > 0 && !abortController.signal.aborted) {
+            log.trace("Aborting findProviders iterator - found pubsub subscribers for topic", pubsubTopic);
+            abortController.abort();
+            shouldStop = true;
+        }
+    }, 100); // Check every 100ms
+    try {
+        const findProvidersLabel = `findProviders:${pubsubTopic}`;
+        console.time(findProvidersLabel);
+        for await (const peer of helia.libp2p.contentRouting.findProviders(contentCid, { ...options, signal: combinedSignal })) {
+            if (shouldStop) {
+                log.trace("Breaking findProviders loop due to shouldStop flag (pubsub subscribers found)");
+                break;
+            }
+            peersWithContent.push(peer);
+            try {
+                const conn = await helia.libp2p.dial(peer.id, options); // will be a no-op if we're already connected
+                // if it succeeds, means we can connect to this peer
+                connectedPeersWithContent.push(conn);
+                if (helia.libp2p.services.pubsub.getSubscribers(pubsubTopic).length > 0) {
+                    shouldStop = true;
+                    log.trace("Breaking findProviders loop after successful dial and finding pubsub subscribers");
+                    break;
+                }
+                if (connectedPeersWithContent.length >= maxPeers) {
+                    log.trace("Breaking findProviders loop after reaching maxPeers", maxPeers);
+                    shouldStop = true;
+                    break;
+                }
+            }
+            catch (e) {
+                peerDialToError[peer.id.toString()] = e;
+                log.trace("Failed to dial IPNS-Over-Pubsub peer", peer.id.toString(), "Due to error", e);
+            }
+        }
+        console.timeEnd(findProvidersLabel);
+    }
+    catch (e) {
+        e.details = {
+            ...e.details,
+            contentCid,
+            options,
+            maxPeersBeforeWeStopLookingForProviders: maxPeers,
+            connectedPeersWithContent,
+            peersWithContent,
+            peerDialToError
+        };
+        throw e;
+    }
+    finally {
+        clearInterval(checkInterval);
+    }
+    log.trace("Connected to", connectedPeersWithContent.length, "peers", "for content", contentCid);
+    if (connectedPeersWithContent.length === 0) {
+        const error = new PKCError("ERR_FAILED_TO_DIAL_ANY_PEERS_PROVIDING_CID", {
+            contentCid,
+            peerDialToError,
+            peersWithContent,
+            options
+        });
+        log.error(error);
+        throw error;
+    }
+    else
+        return connectedPeersWithContent;
+}
+export async function waitForTopicPeers(helia, topic, minPeers = 1, timeoutMs = 10000) {
+    // after connecting to peers, we need to get the peers from the pubsub service
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        const subscribers = helia.libp2p.services.pubsub.getSubscribers(topic);
+        if (subscribers.length >= minPeers) {
+            return subscribers;
+        }
+        // Wait 100ms before checking again
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    throw new PKCError("ERR_TIMEOUT_WAITING_FOR_PUBSUB_TOPIC_PEERS", {
+        topic,
+        minPeers,
+        timeoutMs
+    });
+}
+//# sourceMappingURL=util.js.map

package/dist/node/helia/util.js.map

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

package/dist/node/index.d.ts

@@ -0,0 +1,244 @@
+import "./zod-error-map.js";
+import * as PKCClass from "./pkc/pkc.js";
+import type { InputPKCOptions } from "./types.js";
+import type { AuthorNameRpcParam, CidRpcParam } from "./clients/rpc-client/types.js";
+declare const PKC: {
+    (pkcOptions?: InputPKCOptions): Promise<PKCClass.PKC>;
+    setNativeFunctions: (newNativeFunctions: Partial<import("./types.js").NativeFunctions>) => void;
+    nativeFunctions: {
+        node: import("./types.js").NativeFunctions;
+        browser: import("./types.js").NativeFunctions;
+    };
+    getShortCid: (params: CidRpcParam) => string;
+    getShortAddress: (params: AuthorNameRpcParam) => string;
+    challenges: Record<string, import("zod/v4/core").$InferInnerFunctionType<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>>;
+            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").ZodObject<{
+        optionInputs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+            option: import("zod").ZodString;
+            label: import("zod").ZodString;
+            default: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            placeholder: import("zod").ZodOptional<import("zod").ZodString>;
+            required: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$loose>>>;
+        type: import("zod").ZodString;
+        challenge: import("zod").ZodOptional<import("zod").ZodString>;
+        caseInsensitive: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        getChallenge: 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>>;
+                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>;
+            challengeRequestMessage: import("zod").ZodCustom<import("./pubsub-messages/types.js").DecryptedChallengeRequestMessageTypeWithCommunityAuthor, import("./pubsub-messages/types.js").DecryptedChallengeRequestMessageTypeWithCommunityAuthor>;
+            challengeIndex: import("zod").ZodNumber;
+            community: import("zod").ZodCustom<import("./runtime/node/community/local-community.js").LocalCommunity, import("./runtime/node/community/local-community.js").LocalCommunity>;
+        }, import("zod/v4/core").$strip>], null>, import("zod").ZodPromise<import("zod").ZodUnion<[import("zod").ZodObject<{
+            challenge: import("zod").ZodString;
+            verify: import("zod").ZodFunction<import("zod").ZodTuple<readonly [import("zod").ZodLazy<import("zod").ZodString>], null>, import("zod").ZodPromise<import("zod").ZodUnion<[import("zod").ZodObject<{
+                success: import("zod").ZodLiteral<true>;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                success: import("zod").ZodLiteral<false>;
+                error: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>]>>>;
+            type: import("zod").ZodString;
+            caseInsensitive: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strict>, import("zod").ZodUnion<[import("zod").ZodObject<{
+            success: import("zod").ZodLiteral<true>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            success: import("zod").ZodLiteral<false>;
+            error: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>]>]>>>;
+    }, import("zod/v4/core").$strict>>>;
+};
+export default PKC;
+export declare const setNativeFunctions: (newNativeFunctions: Partial<import("./types.js").NativeFunctions>) => void;
+export declare const nativeFunctions: {
+    node: import("./types.js").NativeFunctions;
+    browser: import("./types.js").NativeFunctions;
+};
+export declare const getShortCid: (params: CidRpcParam) => string;
+export declare const getShortAddress: (params: AuthorNameRpcParam) => string;
+export declare const challenges: Record<string, import("zod/v4/core").$InferInnerFunctionType<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>>;
+        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").ZodObject<{
+    optionInputs: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        option: import("zod").ZodString;
+        label: import("zod").ZodString;
+        default: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        placeholder: import("zod").ZodOptional<import("zod").ZodString>;
+        required: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$loose>>>;
+    type: import("zod").ZodString;
+    challenge: import("zod").ZodOptional<import("zod").ZodString>;
+    caseInsensitive: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    description: import("zod").ZodOptional<import("zod").ZodString>;
+    getChallenge: 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>>;
+            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>;
+        challengeRequestMessage: import("zod").ZodCustom<import("./pubsub-messages/types.js").DecryptedChallengeRequestMessageTypeWithCommunityAuthor, import("./pubsub-messages/types.js").DecryptedChallengeRequestMessageTypeWithCommunityAuthor>;
+        challengeIndex: import("zod").ZodNumber;
+        community: import("zod").ZodCustom<import("./runtime/node/community/local-community.js").LocalCommunity, import("./runtime/node/community/local-community.js").LocalCommunity>;
+    }, import("zod/v4/core").$strip>], null>, import("zod").ZodPromise<import("zod").ZodUnion<[import("zod").ZodObject<{
+        challenge: import("zod").ZodString;
+        verify: import("zod").ZodFunction<import("zod").ZodTuple<readonly [import("zod").ZodLazy<import("zod").ZodString>], null>, import("zod").ZodPromise<import("zod").ZodUnion<[import("zod").ZodObject<{
+            success: import("zod").ZodLiteral<true>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            success: import("zod").ZodLiteral<false>;
+            error: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>]>>>;
+        type: import("zod").ZodString;
+        caseInsensitive: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strict>, import("zod").ZodUnion<[import("zod").ZodObject<{
+        success: import("zod").ZodLiteral<true>;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        success: import("zod").ZodLiteral<false>;
+        error: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>]>]>>>;
+}, import("zod/v4/core").$strict>>>;

package/dist/node/index.js

@@ -0,0 +1,36 @@
+import "./zod-error-map.js";
+import polyfill from "./runtime/node/polyfill.js";
+polyfill();
+import * as PKCClass from "./pkc/pkc.js";
+import { setNativeFunctions as utilSetNativeFunctions } from "./runtime/node/util.js";
+import nodeNativeFunctions from "./runtime/node/native-functions.js";
+import browserNativeFunctions from "./runtime/browser/native-functions.js";
+import { shortifyAddress, shortifyCid } from "./util.js";
+import { pkcJsChallenges } from "./runtime/node/community/challenges/index.js";
+import { PKCWithRpcClient } from "./pkc/pkc-with-rpc-client.js";
+import { parseRpcAuthorNameParam, parseRpcCidParam } from "./clients/rpc-client/rpc-schema-util.js";
+const PKC = async function PKC(pkcOptions = {}) {
+    const pkc = pkcOptions.pkcRpcClientsOptions ? new PKCWithRpcClient(pkcOptions) : new PKCClass.PKC(pkcOptions);
+    await pkc._init();
+    return pkc;
+};
+const getShortAddressValue = (params) => {
+    const parsed = parseRpcAuthorNameParam(params);
+    return shortifyAddress(parsed.address);
+};
+const getShortCidValue = (params) => {
+    const parsed = parseRpcCidParam(params);
+    return shortifyCid(parsed.cid);
+};
+PKC.setNativeFunctions = utilSetNativeFunctions;
+PKC.nativeFunctions = { node: nodeNativeFunctions, browser: browserNativeFunctions };
+PKC.getShortCid = getShortCidValue;
+PKC.getShortAddress = getShortAddressValue;
+PKC.challenges = pkcJsChallenges;
+export default PKC;
+export const setNativeFunctions = PKC.setNativeFunctions;
+export const nativeFunctions = PKC.nativeFunctions;
+export const getShortCid = PKC.getShortCid;
+export const getShortAddress = PKC.getShortAddress;
+export const challenges = PKC.challenges;
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC;AAC5B,OAAO,QAAQ,MAAM,4BAA4B,CAAC;AAClD,QAAQ,EAAE,CAAC;AACX,OAAO,KAAK,QAAQ,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,mBAAmB,MAAM,oCAAoC,CAAC;AACrE,OAAO,sBAAsB,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAEpG,MAAM,GAAG,GAAG,KAAK,UAAU,GAAG,CAAC,aAA8B,EAAE;IAC3D,MAAM,GAAG,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC9G,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IAClB,OAAO,GAAG,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAAC,MAA0B,EAAE,EAAE;IACxD,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC,CAAC;AACF,MAAM,gBAAgB,GAAG,CAAC,MAAmB,EAAE,EAAE;IAC7C,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF,GAAG,CAAC,kBAAkB,GAAG,sBAAsB,CAAC;AAChD,GAAG,CAAC,eAAe,GAAG,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;AACrF,GAAG,CAAC,WAAW,GAAG,gBAAgB,CAAC;AACnC,GAAG,CAAC,eAAe,GAAG,oBAAoB,CAAC;AAC3C,GAAG,CAAC,UAAU,GAAG,eAAe,CAAC;AACjC,eAAe,GAAG,CAAC;AACnB,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC,kBAAkB,CAAC;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC,eAAe,CAAC;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC,eAAe,CAAC;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC"}

package/dist/node/logger.d.ts

@@ -0,0 +1,12 @@
+interface Logger {
+    (formatter: any, ...args: any[]): void;
+    error: (formatter: any, ...args: any[]) => void;
+    trace: (formatter: any, ...args: any[]) => void;
+}
+declare function Logger(namespace: string): Logger;
+declare namespace Logger {
+    const disable: () => void;
+    const enable: (namespaces: string) => void;
+    const enabled: (namespaces: string) => boolean;
+}
+export default Logger;

package/dist/node/logger.js

@@ -0,0 +1,11 @@
+import BaseLogger from "@pkc/pkc-logger";
+function Logger(namespace) {
+    return BaseLogger(namespace);
+}
+(function (Logger) {
+    Logger.disable = () => BaseLogger.disable();
+    Logger.enable = (namespaces) => BaseLogger.enable(namespaces);
+    Logger.enabled = (namespaces) => BaseLogger.enabled(namespaces);
+})(Logger || (Logger = {}));
+export default Logger;
+//# sourceMappingURL=logger.js.map

package/dist/node/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,iBAAiB,CAAC;AAQzC,SAAS,MAAM,CAAC,SAAiB;IAC7B,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED,WAAU,MAAM;IACC,cAAO,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IACrC,aAAM,GAAG,CAAC,UAAkB,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/D,cAAO,GAAG,CAAC,UAAkB,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAClF,CAAC,EAJS,MAAM,KAAN,MAAM,QAIf;AAED,eAAe,MAAM,CAAC"}

package/dist/node/pages/pages-client-manager.d.ts

@@ -0,0 +1,159 @@
+import { BaseClientsManager, OptionsToLoadFromGateway } from "../clients/base-client-manager.js";
+import type { ModQueuePageIpfs, ModQueueSortName, PageIpfs } from "./types.js";
+import Logger from "../logger.js";
+import { BasePages, ModQueuePages, PostsPages, RepliesPages } from "./pages.js";
+import { POSTS_SORT_TYPES, POST_REPLIES_SORT_TYPES, type PageRuntimeFields } from "./util.js";
+import { PKC } from "../pkc/pkc.js";
+import { PagesIpfsGatewayClient, PagesKuboRpcClient, PagesLibp2pJsClient, PagesPKCRpcStateClient } from "./pages-clients.js";
+export declare class BasePagesClientsManager extends BaseClientsManager {
+    clients: {
+        ipfsGateways: {
+            [sortType: string]: {
+                [ipfsGatewayUrl: string]: PagesIpfsGatewayClient;
+            };
+        };
+        kuboRpcClients: {
+            [sortType: string]: {
+                [kuboRpcClientUrl: string]: PagesKuboRpcClient;
+            };
+        };
+        pkcRpcClients: {
+            [sortType: string]: {
+                [rpcUrl: string]: PagesPKCRpcStateClient;
+            };
+        };
+        libp2pJsClients: {
+            [sortType: string]: {
+                [libp2pJsClientKey: string]: PagesLibp2pJsClient;
+            };
+        };
+    };
+    protected _pages: RepliesPages | PostsPages | ModQueuePages;
+    constructor(opts: {
+        pages: BasePagesClientsManager["_pages"];
+        pkc: PKC;
+    });
+    protected _updateIpfsGatewayClientStates(sortTypes: string[]): void;
+    protected _updateKuboRpcClientStates(sortTypes: string[]): void;
+    protected _updateLibp2pJsClientStates(sortTypes: string[]): void;
+    protected _updatePKCRpcClientStates(sortTypes: string[]): void;
+    preFetchGateway(gatewayUrl: string, loadOpts: OptionsToLoadFromGateway): void;
+    postFetchGatewaySuccess(gatewayUrl: string, loadOpts: OptionsToLoadFromGateway): void;
+    postFetchGatewayFailure(gatewayUrl: string, loadOpts: OptionsToLoadFromGateway): void;
+    postFetchGatewayAborted(gatewayUrl: string, loadOpts: OptionsToLoadFromGateway): void;
+    _updatePageCidsSortCache(pageCid: string, sortTypes: string[]): void;
+    updatePageCidsToSortTypes(newPageCids: BasePages["pageCids"]): void;
+    private _calculatePageMaxSizeCacheKey;
+    updatePagesMaxSizeCache(newPageCids: string[], pageMaxSizeBytes: number): void;
+    updatePageCidsToSortTypesToIncludeSubsequent(nextPageCid: string, previousPageCid: string): void;
+    updateKuboRpcState(newState: PagesKuboRpcClient["state"], kuboRpcClientUrl: string, sortTypes: string[] | undefined): void;
+    updateLibp2pJsClientState(newState: PagesLibp2pJsClient["state"], libp2pJsClientKey: keyof PKC["clients"]["libp2pJsClients"], sortTypes: string[] | undefined): void;
+    updateGatewayState(newState: PagesIpfsGatewayClient["state"], gateway: string, sortTypes: string[] | undefined): void;
+    updateRpcState(newState: PagesPKCRpcStateClient["state"], rpcUrl: string, sortTypes: string[] | undefined): void;
+    _updateKuboRpcClientOrHeliaState(newState: PagesKuboRpcClient["state"] | PagesLibp2pJsClient["state"], kuboRpcOrHelia: PKC["clients"]["kuboRpcClients"][string] | PKC["clients"]["libp2pJsClients"][string], sortTypes: string[] | undefined): void;
+    protected preFetchPage(): void;
+    protected _requestPageFromRPC(opts: {
+        pageCid: string;
+        log: Logger;
+        sortTypes: string[] | undefined;
+        pageMaxSize: number;
+    }): Promise<{
+        page: ModQueuePageIpfs | PageIpfs;
+        runtimeFields?: PageRuntimeFields;
+    }>;
+    private _fetchPageWithRpc;
+    protected parsePageJson(json: unknown): PageIpfs | ModQueuePageIpfs;
+    private _fetchPageWithKuboOrHeliaP2P;
+    _fetchPageFromGateways(pageCid: string, log: Logger, pageMaxSize: number): Promise<PageIpfs | ModQueuePageIpfs>;
+    fetchPage(pageCid: string, overridePageMaxSize?: number): Promise<{
+        page: PageIpfs | ModQueuePageIpfs;
+        runtimeFields?: PageRuntimeFields;
+    }>;
+    protected getSortTypes(): string[];
+}
+export declare class RepliesPagesClientsManager extends BasePagesClientsManager {
+    clients: {
+        ipfsGateways: Record<keyof typeof POST_REPLIES_SORT_TYPES, {
+            [ipfsGatewayUrl: string]: PagesIpfsGatewayClient;
+        }>;
+        kuboRpcClients: Record<keyof typeof POST_REPLIES_SORT_TYPES, {
+            [kuboRpcClientUrl: string]: PagesIpfsGatewayClient;
+        }>;
+        pkcRpcClients: Record<keyof typeof POST_REPLIES_SORT_TYPES, {
+            [rpcUrl: string]: PagesPKCRpcStateClient;
+        }>;
+        libp2pJsClients: Record<keyof typeof POST_REPLIES_SORT_TYPES, {
+            [libp2pJsClientKey: string]: PagesIpfsGatewayClient;
+        }>;
+    };
+    protected getSortTypes(): string[];
+    protected preFetchPage(): void;
+    protected _requestPageFromRPC(opts: {
+        pageCid: string;
+        log: Logger;
+        sortTypes: string[] | undefined;
+        pageMaxSize: number;
+    }): Promise<{
+        page: PageIpfs;
+        runtimeFields?: PageRuntimeFields;
+    }>;
+}
+export declare class CommunityPostsPagesClientsManager extends BasePagesClientsManager {
+    clients: {
+        ipfsGateways: Record<keyof typeof POSTS_SORT_TYPES, {
+            [ipfsGatewayUrl: string]: PagesIpfsGatewayClient;
+        }>;
+        kuboRpcClients: Record<keyof typeof POSTS_SORT_TYPES, {
+            [kuboRpcClientUrl: string]: PagesIpfsGatewayClient;
+        }>;
+        pkcRpcClients: Record<keyof typeof POSTS_SORT_TYPES, {
+            [rpcUrl: string]: PagesPKCRpcStateClient;
+        }>;
+        libp2pJsClients: Record<keyof typeof POSTS_SORT_TYPES, {
+            [libp2pJsClientKey: string]: PagesIpfsGatewayClient;
+        }>;
+    };
+    protected getSortTypes(): string[];
+    protected preFetchPage(): void;
+    protected _requestPageFromRPC(opts: {
+        pageCid: string;
+        log: Logger;
+        sortTypes: string[] | undefined;
+        pageMaxSize: number;
+    }): Promise<{
+        page: PageIpfs;
+        runtimeFields?: PageRuntimeFields;
+    }>;
+}
+export declare class CommunityModQueueClientsManager extends BasePagesClientsManager {
+    clients: {
+        ipfsGateways: Record<ModQueueSortName, {
+            [ipfsGatewayUrl: string]: PagesIpfsGatewayClient;
+        }>;
+        kuboRpcClients: Record<ModQueueSortName, {
+            [kuboRpcClientUrl: string]: PagesIpfsGatewayClient;
+        }>;
+        pkcRpcClients: Record<ModQueueSortName, {
+            [rpcUrl: string]: PagesPKCRpcStateClient;
+        }>;
+        libp2pJsClients: Record<ModQueueSortName, {
+            [libp2pJsClientKey: string]: PagesIpfsGatewayClient;
+        }>;
+    };
+    protected getSortTypes(): ModQueueSortName[];
+    fetchPage(pageCid: string, overridePageMaxSize?: number): Promise<{
+        page: ModQueuePageIpfs;
+        runtimeFields?: PageRuntimeFields;
+    }>;
+    protected preFetchPage(): void;
+    protected parsePageJson(json: unknown): ModQueuePageIpfs;
+    protected _requestPageFromRPC(opts: {
+        pageCid: string;
+        log: Logger;
+        sortTypes: string[] | undefined;
+        pageMaxSize: number;
+    }): Promise<{
+        page: ModQueuePageIpfs;
+        runtimeFields?: PageRuntimeFields;
+    }>;
+}