@bitsocial/bitsocial-react-hooks 0.1.0

package/dist/hooks/communities.js

@@ -0,0 +1,389 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { useEffect, useState, useMemo } from "react";
+import { useAccount } from "./accounts/index.js";
+import validator from "../lib/validator.js";
+import Logger from "@pkcprotocol/pkc-logger";
+const log = Logger("bitsocial-react-hooks:communities:hooks");
+import assert from "assert";
+import useInterval from "./utils/use-interval.js";
+import createStore from "zustand";
+import { resolveEnsTxtRecord } from "../lib/chain/index.js";
+import useCommunitiesStore from "../stores/communities/index.js";
+import useAccountsStore from "../stores/accounts/index.js";
+import shallow from "zustand/shallow";
+import { getChainProviders, getPkcCommunityAddresses } from "../lib/pkc-compat.js";
+import { getCommunityRefKey, getUniqueSortedCommunityRefs } from "../lib/community-ref.js";
+const parseMaybeJson = (value) => (typeof value === "string" ? JSON.parse(value) : value);
+const tryParseMaybeJson = (value) => {
+    try {
+        return parseMaybeJson(value);
+    }
+    catch (_a) {
+        return value;
+    }
+};
+const isRecord = (value) => !!value && typeof value === "object";
+const isCommunityStatsPayload = (value) => isRecord(value) &&
+    ("hourActiveUserCount" in value || "weekActiveUserCount" in value || "allPostCount" in value);
+const parseFetchedCommunityStats = (fetchedCid) => {
+    const parsedCid = parseMaybeJson(fetchedCid);
+    if (isCommunityStatsPayload(parsedCid)) {
+        return parsedCid;
+    }
+    if (isRecord(parsedCid) && "content" in parsedCid) {
+        const parsedContent = tryParseMaybeJson(parsedCid.content);
+        if (isCommunityStatsPayload(parsedContent)) {
+            return parsedContent;
+        }
+    }
+    return parsedCid;
+};
+/**
+ * @param community - The community identifier, e.g. {name: 'memes.eth'} or {publicKey: '12D3KooW...'}
+ * @param acountName - The nickname of the account, e.g. 'Account 1'. If no accountName is provided, use
+ * the active account.
+ */
+export function useCommunity(options) {
+    assert(!options || typeof options === "object", `useCommunity options argument '${options}' not an object`);
+    const opts = options !== null && options !== void 0 ? options : {};
+    const { community: communityInput, accountName, onlyIfCached } = opts;
+    const account = useAccount({ accountName });
+    const accountId = (account === null || account === void 0 ? void 0 : account.id) || "";
+    validator.validateUseCommunityArguments({
+        community: communityInput,
+        communityAddress: opts.communityAddress,
+        account,
+    });
+    const communityKey = communityInput ? getCommunityRefKey(communityInput) : "";
+    const storedCommunity = useCommunitiesStore((state) => state.communities[communityKey]);
+    const addCommunityToStore = useCommunitiesStore((state) => state.addCommunityToStore);
+    const errors = useCommunitiesStore((state) => state.errors[communityKey]);
+    const communityEditSummary = useAccountsStore((state) => {
+        const accountEditsSummaries = state.accountsEditsSummaries[accountId] || {};
+        const candidateCommunityKeys = [
+            storedCommunity === null || storedCommunity === void 0 ? void 0 : storedCommunity.address,
+            storedCommunity === null || storedCommunity === void 0 ? void 0 : storedCommunity.name,
+            storedCommunity === null || storedCommunity === void 0 ? void 0 : storedCommunity.publicKey,
+            communityInput === null || communityInput === void 0 ? void 0 : communityInput.name,
+            communityInput === null || communityInput === void 0 ? void 0 : communityInput.publicKey,
+        ];
+        for (const candidateCommunityKey of candidateCommunityKeys) {
+            if (typeof candidateCommunityKey === "string" &&
+                accountEditsSummaries[candidateCommunityKey]) {
+                return accountEditsSummaries[candidateCommunityKey];
+            }
+        }
+    });
+    useEffect(() => {
+        if (!communityInput || !account) {
+            return;
+        }
+        if (!storedCommunity && !onlyIfCached) {
+            // if community isn't already in store, add it
+            addCommunityToStore(communityInput, account).catch((error) => log.error("useCommunity addCommunityToStore error", { communityInput, error }));
+        }
+    }, [communityKey, account === null || account === void 0 ? void 0 : account.id]);
+    if (account && communityInput) {
+        log("useCommunity", {
+            community: communityInput,
+            communityKey,
+            storedCommunity,
+            account,
+        });
+    }
+    const mergedCommunity = useMemo(() => {
+        var _a;
+        if (!communityEditSummary) {
+            return storedCommunity;
+        }
+        const localCommunityAddresses = getPkcCommunityAddresses(account === null || account === void 0 ? void 0 : account.pkc);
+        const editedCommunityAddress = (_a = communityEditSummary.address) === null || _a === void 0 ? void 0 : _a.value;
+        const inputCommunityIdentifiers = [communityInput === null || communityInput === void 0 ? void 0 : communityInput.name, communityInput === null || communityInput === void 0 ? void 0 : communityInput.publicKey].filter((communityIdentifier) => typeof communityIdentifier === "string");
+        if (!storedCommunity &&
+            editedCommunityAddress &&
+            !inputCommunityIdentifiers.some((communityIdentifier) => localCommunityAddresses.includes(communityIdentifier)) &&
+            !localCommunityAddresses.includes(editedCommunityAddress)) {
+            return storedCommunity;
+        }
+        if ((storedCommunity === null || storedCommunity === void 0 ? void 0 : storedCommunity.address) &&
+            editedCommunityAddress &&
+            storedCommunity.address !== editedCommunityAddress) {
+            return storedCommunity;
+        }
+        const summaryValues = Object.fromEntries(Object.entries(communityEditSummary).map(([propertyName, propertySummary]) => [
+            propertyName,
+            propertySummary === null || propertySummary === void 0 ? void 0 : propertySummary.value,
+        ]));
+        return Object.assign(Object.assign({}, (storedCommunity || { address: (communityInput === null || communityInput === void 0 ? void 0 : communityInput.name) || (communityInput === null || communityInput === void 0 ? void 0 : communityInput.publicKey) })), summaryValues);
+    }, [account === null || account === void 0 ? void 0 : account.pkc, storedCommunity, communityInput, communityEditSummary]);
+    let state = (mergedCommunity === null || mergedCommunity === void 0 ? void 0 : mergedCommunity.updatingState) || "initializing";
+    // force succeeded even if the community is fecthing a new update
+    if (mergedCommunity === null || mergedCommunity === void 0 ? void 0 : mergedCommunity.updatedAt) {
+        state = "succeeded";
+    }
+    return useMemo(() => (Object.assign(Object.assign({}, mergedCommunity), { state, error: errors === null || errors === void 0 ? void 0 : errors[errors.length - 1], errors: errors || [] })), [mergedCommunity, communityKey, errors]);
+}
+/**
+ * @param community - The community identifier, e.g. {name: 'memes.eth'} or {publicKey: '12D3KooW...'}
+ * @param acountName - The nickname of the account, e.g. 'Account 1'. If no accountName is provided, use
+ * the active account.
+ */
+export function useCommunityStats(options) {
+    assert(!options || typeof options === "object", `useCommunityStats options argument '${options}' not an object`);
+    const opts = options !== null && options !== void 0 ? options : {};
+    const { community, accountName, onlyIfCached } = opts;
+    validator.validateUseCommunityStatsArguments({
+        community,
+        communityAddress: opts.communityAddress,
+    });
+    const account = useAccount({ accountName });
+    const communityKey = community ? getCommunityRefKey(community) : "";
+    const fetchedCommunity = useCommunity({ community, onlyIfCached });
+    const communityStatsCid = fetchedCommunity === null || fetchedCommunity === void 0 ? void 0 : fetchedCommunity.statsCid;
+    const communityStats = useCommunitiesStatsStore((state) => state.communitiesStats[communityKey]);
+    const setCommunityStats = useCommunitiesStatsStore((state) => state.setCommunityStats);
+    const [fetchError, setFetchError] = useState();
+    useEffect(() => {
+        setFetchError(undefined);
+        if (!communityKey || !communityStatsCid || !account) {
+            return;
+        }
+        let cancelled = false;
+        (() => __awaiter(this, void 0, void 0, function* () {
+            let fetchedCid;
+            try {
+                fetchedCid = yield account.pkc.fetchCid({ cid: communityStatsCid });
+                fetchedCid = parseFetchedCommunityStats(fetchedCid);
+                if (cancelled) {
+                    return;
+                }
+                setCommunityStats(communityKey, fetchedCid);
+            }
+            catch (error) {
+                const normalizedError = error instanceof Error ? error : new Error(typeof error === "string" ? error : "error");
+                if (cancelled) {
+                    return;
+                }
+                setFetchError(normalizedError);
+                log.error("useCommunityStats pkc.fetchCid error", {
+                    community,
+                    communityKey,
+                    communityStatsCid,
+                    fetchedCommunity,
+                    fetchedCid,
+                    error: normalizedError,
+                });
+            }
+        }))();
+        return () => {
+            cancelled = true;
+        };
+    }, [communityStatsCid, account === null || account === void 0 ? void 0 : account.id, communityKey, setCommunityStats]);
+    if (account && communityStatsCid) {
+        log("useCommunityStats", {
+            community,
+            communityKey,
+            communityStatsCid,
+            communityStats,
+            fetchedCommunity,
+            account,
+        });
+    }
+    const state = !communityKey || !account || !communityStatsCid
+        ? "uninitialized"
+        : fetchError
+            ? "failed"
+            : communityStats
+                ? "succeeded"
+                : "fetching-ipfs";
+    return useMemo(() => (Object.assign(Object.assign({}, communityStats), { state, error: fetchError, errors: fetchError ? [fetchError] : [] })), [communityStats, state, fetchError]);
+}
+const useCommunitiesStatsStore = createStore((setState) => ({
+    communitiesStats: {},
+    setCommunityStats: (communityAddress, communityStats) => setState((state) => ({
+        communitiesStats: Object.assign(Object.assign({}, state.communitiesStats), { [communityAddress]: communityStats }),
+    })),
+}));
+/**
+ * @param communities - The communities to fetch, e.g. [{name: 'memes.eth'}, {publicKey: '12D3KooW...'}]
+ * @param acountName - The nickname of the account, e.g. 'Account 1'. If no accountName is provided, use
+ * the active account.
+ */
+export function useCommunities(options) {
+    assert(!options || typeof options === "object", `useCommunities options argument '${options}' not an object`);
+    const opts = options !== null && options !== void 0 ? options : {};
+    const { communities: communitiesInput, accountName, onlyIfCached } = opts;
+    const account = useAccount({ accountName });
+    validator.validateUseCommunitiesArguments({
+        communities: communitiesInput,
+        communityRefs: opts.communityRefs,
+        communityAddresses: opts.communityAddresses,
+        account,
+    });
+    const normalizedCommunityRefs = useMemo(() => communitiesInput || [], [communitiesInput]);
+    const communityKeys = useMemo(() => normalizedCommunityRefs.map(getCommunityRefKey), [normalizedCommunityRefs]);
+    const communities = useCommunitiesStore((state) => communityKeys.map((communityKey) => state.communities[communityKey || ""]), shallow);
+    const communitiesErrors = useCommunitiesStore((state) => communityKeys.map((communityKey) => state.errors[communityKey || ""]), shallow);
+    const addCommunityToStore = useCommunitiesStore((state) => state.addCommunityToStore);
+    useEffect(() => {
+        if (!normalizedCommunityRefs.length || !account) {
+            return;
+        }
+        if (onlyIfCached) {
+            return;
+        }
+        const uniqueCommunityRefs = getUniqueSortedCommunityRefs(normalizedCommunityRefs);
+        for (const communityRef of uniqueCommunityRefs) {
+            addCommunityToStore(communityRef, account).catch((error) => log.error("useCommunities addCommunityToStore error", { communityRef, error }));
+        }
+    }, [account === null || account === void 0 ? void 0 : account.id, communityKeys.toString(), onlyIfCached, normalizedCommunityRefs]);
+    if (account && normalizedCommunityRefs.length) {
+        log("useCommunities", {
+            requestedCommunities: normalizedCommunityRefs,
+            communityKeys,
+            communities,
+            account,
+        });
+    }
+    const errors = useMemo(() => communitiesErrors.flatMap((communityErrors) => communityErrors || []), [communitiesErrors]);
+    const hasFailedCommunity = communities.some((community, index) => { var _a; return !community && Boolean((_a = communitiesErrors[index]) === null || _a === void 0 ? void 0 : _a.length); });
+    const state = hasFailedCommunity
+        ? "failed"
+        : communities.indexOf(undefined) === -1
+            ? "succeeded"
+            : "fetching-ipns";
+    return useMemo(() => ({
+        communities,
+        state,
+        error: errors[errors.length - 1],
+        errors,
+    }), [communities, state, errors, communityKeys.toString()]);
+}
+// TODO: pkc.listCommunities() has been removed, rename this and use event communitieschanged instead of polling
+/**
+ * Returns all the owner communities created by pkc-js by calling pkc.listCommunities()
+ */
+export function useListCommunities(accountName) {
+    const account = useAccount({ accountName });
+    const [communityAddresses, setCommunityAddresses] = useState([]);
+    const delay = 1000;
+    const immediate = true;
+    useInterval(() => {
+        const pkc = account === null || account === void 0 ? void 0 : account.pkc;
+        if (!pkc)
+            return;
+        const newAddrs = getPkcCommunityAddresses(pkc);
+        if (newAddrs.toString() !== communityAddresses.toString()) {
+            log("useListCommunities", { communityAddresses });
+            setCommunityAddresses(newAddrs);
+        }
+    }, delay, immediate);
+    return communityAddresses;
+}
+/**
+ * @param communityAddress - The community address to resolve to a public key, e.g. 'news.eth' resolves to '12D3KooW...'.
+ * @param acountName - The nickname of the account, e.g. 'Account 1'. If no accountName is provided, use
+ * the active account.
+ */
+// NOTE: useResolvedCommunityAddress tests are skipped, if changes are made they must be tested manually
+export function useResolvedCommunityAddress(options) {
+    assert(!options || typeof options === "object", `useResolvedCommunityAddress options argument '${options}' not an object`);
+    let { communityAddress, accountName, cache } = options !== null && options !== void 0 ? options : {};
+    // cache by default
+    if (typeof cache !== "boolean") {
+        cache = true;
+    }
+    // poll every 15 seconds, about the duration of an eth block
+    let interval = 15000;
+    // no point in polling often if caching is on
+    if (cache) {
+        interval = 1000 * 60 * 60 * 25;
+    }
+    const account = useAccount({ accountName });
+    const chainProviders = getChainProviders(account);
+    const [resolvedAddress, setResolvedAddress] = useState();
+    const [errors, setErrors] = useState([]);
+    const [state, setState] = useState();
+    let initialState = "initializing";
+    // before those defined, nothing can happen
+    if (options && account && communityAddress) {
+        initialState = "ready";
+    }
+    useInterval(() => {
+        if (!account || !communityAddress) {
+            setResolvedAddress(undefined);
+            setState(undefined);
+            setErrors((prevErrors) => (prevErrors.length ? [] : prevErrors));
+            return;
+        }
+        // address isn't a crypto domain, can't be resolved
+        if (!(communityAddress === null || communityAddress === void 0 ? void 0 : communityAddress.includes("."))) {
+            if (state !== "failed") {
+                setErrors([Error("not a crypto domain")]);
+                setState("failed");
+                setResolvedAddress(undefined);
+            }
+            return;
+        }
+        // only support resolving '.eth' for now
+        if (!(communityAddress === null || communityAddress === void 0 ? void 0 : communityAddress.endsWith(".eth"))) {
+            if (state !== "failed") {
+                setErrors([Error("crypto domain type unsupported")]);
+                setState("failed");
+                setResolvedAddress(undefined);
+            }
+            return;
+        }
+        (() => __awaiter(this, void 0, void 0, function* () {
+            try {
+                setState("resolving");
+                const res = yield resolveCommunityAddress(communityAddress, chainProviders);
+                setState("succeeded");
+                if (res !== resolvedAddress) {
+                    setResolvedAddress(res);
+                }
+            }
+            catch (error) {
+                setErrors([...errors, error]);
+                setState("failed");
+                setResolvedAddress(undefined);
+                log.error("useResolvedCommunityAddress resolveCommunityAddress error", {
+                    communityAddress,
+                    chainProviders,
+                    error,
+                });
+            }
+        }))();
+    }, interval, true, [communityAddress, chainProviders]);
+    // only support ENS at the moment
+    const chainProvider = chainProviders === null || chainProviders === void 0 ? void 0 : chainProviders["eth"];
+    // log('useResolvedCommunityAddress', {communityAddress, state, errors, resolvedAddress, chainProviders})
+    return {
+        resolvedAddress,
+        chainProvider,
+        state: state || initialState,
+        error: errors[errors.length - 1],
+        errors,
+    };
+}
+// NOTE: resolveCommunityAddress tests are skipped, if changes are made they must be tested manually
+export const resolveCommunityAddress = (communityAddress, chainProviders) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c;
+    let resolvedCommunityAddress;
+    if (communityAddress.endsWith(".eth")) {
+        resolvedCommunityAddress = yield resolveEnsTxtRecord(communityAddress, "community-address", "eth", (_b = (_a = chainProviders === null || chainProviders === void 0 ? void 0 : chainProviders["eth"]) === null || _a === void 0 ? void 0 : _a.urls) === null || _b === void 0 ? void 0 : _b[0], (_c = chainProviders === null || chainProviders === void 0 ? void 0 : chainProviders["eth"]) === null || _c === void 0 ? void 0 : _c.chainId);
+    }
+    else {
+        throw Error(`resolveCommunityAddress invalid communityAddress '${communityAddress}'`);
+    }
+    return resolvedCommunityAddress;
+});
+//# sourceMappingURL=communities.js.map

package/dist/hooks/communities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"communities.js","sourceRoot":"","sources":["../../src/hooks/communities.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useState, useMemo } from \"react\";\nimport { useAccount } from \"./accounts\";\nimport validator from \"../lib/validator\";\nimport Logger from \"@pkcprotocol/pkc-logger\";\nconst log = Logger(\"bitsocial-react-hooks:communities:hooks\");\nimport assert from \"assert\";\nimport {\n  Community,\n  CommunityStats,\n  ChainProviders,\n  UseResolvedCommunityAddressOptions,\n  UseResolvedCommunityAddressResult,\n  UseCommunityOptions,\n  UseCommunityResult,\n  UseCommunitiesOptions,\n  UseCommunitiesResult,\n  UseCommunityStatsOptions,\n  UseCommunityStatsResult,\n} from \"../types\";\nimport useInterval from \"./utils/use-interval\";\nimport createStore from \"zustand\";\nimport { resolveEnsTxtRecord } from \"../lib/chain\";\nimport useCommunitiesStore from \"../stores/communities\";\nimport useAccountsStore from \"../stores/accounts\";\nimport shallow from \"zustand/shallow\";\nimport { getChainProviders, getPkcCommunityAddresses } from \"../lib/pkc-compat\";\nimport { getCommunityRefKey, getUniqueSortedCommunityRefs } from \"../lib/community-ref\";\n\nconst parseMaybeJson = (value: unknown) => (typeof value === \"string\" ? JSON.parse(value) : value);\n\nconst tryParseMaybeJson = (value: unknown) => {\n  try {\n    return parseMaybeJson(value);\n  } catch {\n    return value;\n  }\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === \"object\";\n\nconst isCommunityStatsPayload = (value: unknown): value is CommunityStats =>\n  isRecord(value) &&\n  (\"hourActiveUserCount\" in value || \"weekActiveUserCount\" in value || \"allPostCount\" in value);\n\nconst parseFetchedCommunityStats = (fetchedCid: unknown): CommunityStats => {\n  const parsedCid = parseMaybeJson(fetchedCid);\n  if (isCommunityStatsPayload(parsedCid)) {\n    return parsedCid;\n  }\n  if (isRecord(parsedCid) && \"content\" in parsedCid) {\n    const parsedContent = tryParseMaybeJson(parsedCid.content);\n    if (isCommunityStatsPayload(parsedContent)) {\n      return parsedContent;\n    }\n  }\n  return parsedCid as CommunityStats;\n};\n\n/**\n * @param community - The community identifier, e.g. {name: 'memes.eth'} or {publicKey: '12D3KooW...'}\n * @param acountName - The nickname of the account, e.g. 'Account 1'. If no accountName is provided, use\n * the active account.\n */\nexport function useCommunity(options?: UseCommunityOptions): UseCommunityResult {\n  assert(\n    !options || typeof options === \"object\",\n    `useCommunity options argument '${options}' not an object`,\n  );\n  const opts = options ?? {};\n  const { community: communityInput, accountName, onlyIfCached } = opts;\n  const account = useAccount({ accountName });\n  const accountId = account?.id || \"\";\n  validator.validateUseCommunityArguments({\n    community: communityInput,\n    communityAddress: (opts as any).communityAddress,\n    account,\n  });\n  const communityKey = communityInput ? getCommunityRefKey(communityInput) : \"\";\n  const storedCommunity = useCommunitiesStore((state: any) => state.communities[communityKey]);\n  const addCommunityToStore = useCommunitiesStore((state: any) => state.addCommunityToStore);\n  const errors = useCommunitiesStore((state: any) => state.errors[communityKey]);\n  const communityEditSummary = useAccountsStore((state: any) => {\n    const accountEditsSummaries = state.accountsEditsSummaries[accountId] || {};\n    const candidateCommunityKeys = [\n      storedCommunity?.address,\n      storedCommunity?.name,\n      storedCommunity?.publicKey,\n      communityInput?.name,\n      communityInput?.publicKey,\n    ];\n    for (const candidateCommunityKey of candidateCommunityKeys) {\n      if (\n        typeof candidateCommunityKey === \"string\" &&\n        accountEditsSummaries[candidateCommunityKey]\n      ) {\n        return accountEditsSummaries[candidateCommunityKey];\n      }\n    }\n  });\n\n  useEffect(() => {\n    if (!communityInput || !account) {\n      return;\n    }\n    if (!storedCommunity && !onlyIfCached) {\n      // if community isn't already in store, add it\n      addCommunityToStore(communityInput, account).catch((error: unknown) =>\n        log.error(\"useCommunity addCommunityToStore error\", { communityInput, error }),\n      );\n    }\n  }, [communityKey, account?.id]);\n\n  if (account && communityInput) {\n    log(\"useCommunity\", {\n      community: communityInput,\n      communityKey,\n      storedCommunity,\n      account,\n    });\n  }\n\n  const mergedCommunity = useMemo(() => {\n    if (!communityEditSummary) {\n      return storedCommunity;\n    }\n    const localCommunityAddresses = getPkcCommunityAddresses(account?.pkc);\n    const editedCommunityAddress = communityEditSummary.address?.value;\n    const inputCommunityIdentifiers = [communityInput?.name, communityInput?.publicKey].filter(\n      (communityIdentifier): communityIdentifier is string =>\n        typeof communityIdentifier === \"string\",\n    );\n    if (\n      !storedCommunity &&\n      editedCommunityAddress &&\n      !inputCommunityIdentifiers.some((communityIdentifier) =>\n        localCommunityAddresses.includes(communityIdentifier),\n      ) &&\n      !localCommunityAddresses.includes(editedCommunityAddress)\n    ) {\n      return storedCommunity;\n    }\n    if (\n      storedCommunity?.address &&\n      editedCommunityAddress &&\n      storedCommunity.address !== editedCommunityAddress\n    ) {\n      return storedCommunity;\n    }\n    const summaryValues = Object.fromEntries(\n      Object.entries(communityEditSummary).map(([propertyName, propertySummary]: [string, any]) => [\n        propertyName,\n        propertySummary?.value,\n      ]),\n    );\n    return {\n      ...(storedCommunity || { address: communityInput?.name || communityInput?.publicKey }),\n      ...summaryValues,\n    };\n  }, [account?.pkc, storedCommunity, communityInput, communityEditSummary]);\n\n  let state = mergedCommunity?.updatingState || \"initializing\";\n  // force succeeded even if the community is fecthing a new update\n  if (mergedCommunity?.updatedAt) {\n    state = \"succeeded\";\n  }\n\n  return useMemo(\n    () => ({\n      ...mergedCommunity,\n      state,\n      error: errors?.[errors.length - 1],\n      errors: errors || [],\n    }),\n    [mergedCommunity, communityKey, errors],\n  );\n}\n\n/**\n * @param community - The community identifier, e.g. {name: 'memes.eth'} or {publicKey: '12D3KooW...'}\n * @param acountName - The nickname of the account, e.g. 'Account 1'. If no accountName is provided, use\n * the active account.\n */\nexport function useCommunityStats(options?: UseCommunityStatsOptions): UseCommunityStatsResult {\n  assert(\n    !options || typeof options === \"object\",\n    `useCommunityStats options argument '${options}' not an object`,\n  );\n  const opts = options ?? {};\n  const { community, accountName, onlyIfCached } = opts;\n  validator.validateUseCommunityStatsArguments({\n    community,\n    communityAddress: (opts as any).communityAddress,\n  });\n  const account = useAccount({ accountName });\n  const communityKey = community ? getCommunityRefKey(community) : \"\";\n  const fetchedCommunity = useCommunity({ community, onlyIfCached });\n  const communityStatsCid = fetchedCommunity?.statsCid;\n  const communityStats = useCommunitiesStatsStore(\n    (state: CommunitiesStatsState) => state.communitiesStats[communityKey],\n  );\n  const setCommunityStats = useCommunitiesStatsStore(\n    (state: CommunitiesStatsState) => state.setCommunityStats,\n  );\n  const [fetchError, setFetchError] = useState<Error | undefined>();\n\n  useEffect(() => {\n    setFetchError(undefined);\n    if (!communityKey || !communityStatsCid || !account) {\n      return;\n    }\n    let cancelled = false;\n    (async () => {\n      let fetchedCid;\n      try {\n        fetchedCid = await account.pkc.fetchCid({ cid: communityStatsCid });\n        fetchedCid = parseFetchedCommunityStats(fetchedCid);\n        if (cancelled) {\n          return;\n        }\n        setCommunityStats(communityKey, fetchedCid);\n      } catch (error) {\n        const normalizedError =\n          error instanceof Error ? error : new Error(typeof error === \"string\" ? error : \"error\");\n        if (cancelled) {\n          return;\n        }\n        setFetchError(normalizedError);\n        log.error(\"useCommunityStats pkc.fetchCid error\", {\n          community,\n          communityKey,\n          communityStatsCid,\n          fetchedCommunity,\n          fetchedCid,\n          error: normalizedError,\n        });\n      }\n    })();\n    return () => {\n      cancelled = true;\n    };\n  }, [communityStatsCid, account?.id, communityKey, setCommunityStats]);\n\n  if (account && communityStatsCid) {\n    log(\"useCommunityStats\", {\n      community,\n      communityKey,\n      communityStatsCid,\n      communityStats,\n      fetchedCommunity,\n      account,\n    });\n  }\n\n  const state =\n    !communityKey || !account || !communityStatsCid\n      ? \"uninitialized\"\n      : fetchError\n        ? \"failed\"\n        : communityStats\n          ? \"succeeded\"\n          : \"fetching-ipfs\";\n\n  return useMemo(\n    () => ({\n      ...communityStats,\n      state,\n      error: fetchError,\n      errors: fetchError ? [fetchError] : [],\n    }),\n    [communityStats, state, fetchError],\n  );\n}\n\ntype CommunitiesStatsState = {\n  communitiesStats: { [communityAddress: string]: CommunityStats };\n  setCommunityStats: Function;\n};\n\nconst useCommunitiesStatsStore = createStore<CommunitiesStatsState>((setState: Function) => ({\n  communitiesStats: {},\n  setCommunityStats: (communityAddress: string, communityStats: CommunityStats) =>\n    setState((state: CommunitiesStatsState) => ({\n      communitiesStats: { ...state.communitiesStats, [communityAddress]: communityStats },\n    })),\n}));\n\n/**\n * @param communities - The communities to fetch, e.g. [{name: 'memes.eth'}, {publicKey: '12D3KooW...'}]\n * @param acountName - The nickname of the account, e.g. 'Account 1'. If no accountName is provided, use\n * the active account.\n */\nexport function useCommunities(options?: UseCommunitiesOptions): UseCommunitiesResult {\n  assert(\n    !options || typeof options === \"object\",\n    `useCommunities options argument '${options}' not an object`,\n  );\n  const opts = options ?? {};\n  const { communities: communitiesInput, accountName, onlyIfCached } = opts;\n  const account = useAccount({ accountName });\n  validator.validateUseCommunitiesArguments({\n    communities: communitiesInput,\n    communityRefs: (opts as any).communityRefs,\n    communityAddresses: (opts as any).communityAddresses,\n    account,\n  });\n  const normalizedCommunityRefs = useMemo(() => communitiesInput || [], [communitiesInput]);\n  const communityKeys = useMemo(\n    () => normalizedCommunityRefs.map(getCommunityRefKey),\n    [normalizedCommunityRefs],\n  );\n  const communities: (Community | undefined)[] = useCommunitiesStore(\n    (state: any) => communityKeys.map((communityKey) => state.communities[communityKey || \"\"]),\n    shallow,\n  );\n  const communitiesErrors: (Error[] | undefined)[] = useCommunitiesStore(\n    (state: any) => communityKeys.map((communityKey) => state.errors[communityKey || \"\"]),\n    shallow,\n  );\n  const addCommunityToStore = useCommunitiesStore((state: any) => state.addCommunityToStore);\n\n  useEffect(() => {\n    if (!normalizedCommunityRefs.length || !account) {\n      return;\n    }\n    if (onlyIfCached) {\n      return;\n    }\n    const uniqueCommunityRefs = getUniqueSortedCommunityRefs(normalizedCommunityRefs);\n    for (const communityRef of uniqueCommunityRefs) {\n      addCommunityToStore(communityRef, account).catch((error: unknown) =>\n        log.error(\"useCommunities addCommunityToStore error\", { communityRef, error }),\n      );\n    }\n  }, [account?.id, communityKeys.toString(), onlyIfCached, normalizedCommunityRefs]);\n\n  if (account && normalizedCommunityRefs.length) {\n    log(\"useCommunities\", {\n      requestedCommunities: normalizedCommunityRefs,\n      communityKeys,\n      communities,\n      account,\n    });\n  }\n\n  const errors = useMemo(\n    () => communitiesErrors.flatMap((communityErrors) => communityErrors || []),\n    [communitiesErrors],\n  );\n  const hasFailedCommunity = communities.some(\n    (community, index) => !community && Boolean(communitiesErrors[index]?.length),\n  );\n  const state = hasFailedCommunity\n    ? \"failed\"\n    : communities.indexOf(undefined) === -1\n      ? \"succeeded\"\n      : \"fetching-ipns\";\n\n  return useMemo(\n    () => ({\n      communities,\n      state,\n      error: errors[errors.length - 1],\n      errors,\n    }),\n    [communities, state, errors, communityKeys.toString()],\n  );\n}\n\n// TODO: pkc.listCommunities() has been removed, rename this and use event communitieschanged instead of polling\n/**\n * Returns all the owner communities created by pkc-js by calling pkc.listCommunities()\n */\nexport function useListCommunities(accountName?: string) {\n  const account = useAccount({ accountName });\n  const [communityAddresses, setCommunityAddresses] = useState<string[]>([]);\n\n  const delay = 1000;\n  const immediate = true;\n  useInterval(\n    () => {\n      const pkc = account?.pkc;\n      if (!pkc) return;\n      const newAddrs = getPkcCommunityAddresses(pkc);\n      if (newAddrs.toString() !== communityAddresses.toString()) {\n        log(\"useListCommunities\", { communityAddresses });\n        setCommunityAddresses(newAddrs);\n      }\n    },\n    delay,\n    immediate,\n  );\n\n  return communityAddresses;\n}\n\n/**\n * @param communityAddress - The community address to resolve to a public key, e.g. 'news.eth' resolves to '12D3KooW...'.\n * @param acountName - The nickname of the account, e.g. 'Account 1'. If no accountName is provided, use\n * the active account.\n */\n// NOTE: useResolvedCommunityAddress tests are skipped, if changes are made they must be tested manually\nexport function useResolvedCommunityAddress(\n  options?: UseResolvedCommunityAddressOptions,\n): UseResolvedCommunityAddressResult {\n  assert(\n    !options || typeof options === \"object\",\n    `useResolvedCommunityAddress options argument '${options}' not an object`,\n  );\n  let { communityAddress, accountName, cache } = options ?? {};\n\n  // cache by default\n  if (typeof cache !== \"boolean\") {\n    cache = true;\n  }\n\n  // poll every 15 seconds, about the duration of an eth block\n  let interval = 15000;\n  // no point in polling often if caching is on\n  if (cache) {\n    interval = 1000 * 60 * 60 * 25;\n  }\n\n  const account = useAccount({ accountName });\n  const chainProviders = getChainProviders(account);\n  const [resolvedAddress, setResolvedAddress] = useState<string>();\n  const [errors, setErrors] = useState<Error[]>([]);\n  const [state, setState] = useState<string>();\n\n  let initialState = \"initializing\";\n  // before those defined, nothing can happen\n  if (options && account && communityAddress) {\n    initialState = \"ready\";\n  }\n\n  useInterval(\n    () => {\n      if (!account || !communityAddress) {\n        setResolvedAddress(undefined);\n        setState(undefined);\n        setErrors((prevErrors) => (prevErrors.length ? [] : prevErrors));\n        return;\n      }\n\n      // address isn't a crypto domain, can't be resolved\n      if (!communityAddress?.includes(\".\")) {\n        if (state !== \"failed\") {\n          setErrors([Error(\"not a crypto domain\")]);\n          setState(\"failed\");\n          setResolvedAddress(undefined);\n        }\n        return;\n      }\n\n      // only support resolving '.eth' for now\n      if (!communityAddress?.endsWith(\".eth\")) {\n        if (state !== \"failed\") {\n          setErrors([Error(\"crypto domain type unsupported\")]);\n          setState(\"failed\");\n          setResolvedAddress(undefined);\n        }\n        return;\n      }\n\n      (async () => {\n        try {\n          setState(\"resolving\");\n          const res = await resolveCommunityAddress(communityAddress, chainProviders);\n          setState(\"succeeded\");\n          if (res !== resolvedAddress) {\n            setResolvedAddress(res);\n          }\n        } catch (error: any) {\n          setErrors([...errors, error]);\n          setState(\"failed\");\n          setResolvedAddress(undefined);\n          log.error(\"useResolvedCommunityAddress resolveCommunityAddress error\", {\n            communityAddress,\n            chainProviders,\n            error,\n          });\n        }\n      })();\n    },\n    interval,\n    true,\n    [communityAddress, chainProviders],\n  );\n\n  // only support ENS at the moment\n  const chainProvider = chainProviders?.[\"eth\"];\n\n  // log('useResolvedCommunityAddress', {communityAddress, state, errors, resolvedAddress, chainProviders})\n  return {\n    resolvedAddress,\n    chainProvider,\n    state: state || initialState,\n    error: errors[errors.length - 1],\n    errors,\n  };\n}\n\n// NOTE: resolveCommunityAddress tests are skipped, if changes are made they must be tested manually\nexport const resolveCommunityAddress = async (\n  communityAddress: string,\n  chainProviders: ChainProviders,\n) => {\n  let resolvedCommunityAddress;\n  if (communityAddress.endsWith(\".eth\")) {\n    resolvedCommunityAddress = await resolveEnsTxtRecord(\n      communityAddress,\n      \"community-address\",\n      \"eth\",\n      chainProviders?.[\"eth\"]?.urls?.[0],\n      chainProviders?.[\"eth\"]?.chainId,\n    );\n  } else {\n    throw Error(`resolveCommunityAddress invalid communityAddress '${communityAddress}'`);\n  }\n  return resolvedCommunityAddress;\n};\n"]}

package/dist/hooks/feeds/feeds.d.ts

@@ -0,0 +1,18 @@
+import { UseBufferedFeedsOptions, UseBufferedFeedsResult, UseFeedOptions, UseFeedResult } from "../../types.js";
+/**
+ * @param communities - The communities to fetch, e.g. [{name: 'memes.eth'}, {publicKey: '12D3KooW...'}]
+ * @param sortType - The sorting algo for the feed: 'hot' | 'new' | 'active' | 'topHour' | 'topDay' | 'topWeek' | 'topMonth' | 'topYear' | 'topAll' | 'controversialHour' | 'controversialDay' | 'controversialWeek' | 'controversialMonth' | 'controversialYear' | 'controversialAll'
+ * @param acountName - The nickname of the account, e.g. 'Account 1'. If no accountName is provided, use
+ * the active account.
+ */
+export declare function useFeed(options?: UseFeedOptions): UseFeedResult;
+/**
+ * Use useBufferedFeeds to buffer multiple feeds in the background so what when
+ * they are called by useFeed later, they are already preloaded.
+ *
+ * @param feedOptions - The options of the feed
+ * @param acountName - The nickname of the account, e.g. 'Account 1'. If no accountName is provided, use
+ * the active account.
+ */
+export declare function useBufferedFeeds(options?: UseBufferedFeedsOptions): UseBufferedFeedsResult;
+//# sourceMappingURL=feeds.d.ts.map

package/dist/hooks/feeds/feeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeds.d.ts","sourceRoot":"","sources":["../../../src/hooks/feeds/feeds.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,aAAa,EAEd,MAAM,aAAa,CAAC;AAUrB;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAgL/D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,sBAAsB,CA0I1F"}