@xyo-network/react-api 2.32.0-rc.7 → 2.32.0

package/dist/esm/hooks/ResolvePayloadArgs.d.ts

@@ -0,0 +1,5 @@
+import { XyoApiError } from '@xyo-network/api';
+import { XyoPayload } from '@xyo-network/payload';
+export declare type UsePayload = [XyoPayload?, boolean?, XyoApiError?];
+export declare type UseHuriOrHash = [...UsePayload, boolean?];
+//# sourceMappingURL=ResolvePayloadArgs.d.ts.map

package/dist/esm/hooks/ResolvePayloadArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolvePayloadArgs.d.ts","sourceRoot":"","sources":["../../../src/hooks/ResolvePayloadArgs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjD,oBAAY,UAAU,GAAG,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAA;AAE9D,oBAAY,aAAa,GAAG,CAAC,GAAG,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA"}

package/dist/esm/hooks/ResolvePayloadArgs.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ResolvePayloadArgs.js.map

package/dist/esm/hooks/ResolvePayloadArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolvePayloadArgs.js","sourceRoot":"","sources":["../../../src/hooks/ResolvePayloadArgs.ts"],"names":[],"mappings":""}

package/dist/esm/hooks/index.d.ts

@@ -0,0 +1,6 @@
+export * from './lib';
+export * from './ResolvePayloadArgs';
+export * from './useHuriHash';
+export * from './useLoadPayload';
+export * from './useResolveHuri';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA"}

package/dist/esm/hooks/index.js

@@ -0,0 +1,6 @@
+export * from './lib';
+export * from './ResolvePayloadArgs';
+export * from './useHuriHash';
+export * from './useLoadPayload';
+export * from './useResolveHuri';
+//# sourceMappingURL=index.js.map

package/dist/esm/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,sBAAsB,CAAA;AACpC,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA"}

package/dist/esm/hooks/lib/FetchHuriHashOptions.d.ts

@@ -0,0 +1,4 @@
+export interface FetchHuriHashOptions {
+    changeActiveNetwork?: boolean;
+}
+//# sourceMappingURL=FetchHuriHashOptions.d.ts.map

package/dist/esm/hooks/lib/FetchHuriHashOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchHuriHashOptions.d.ts","sourceRoot":"","sources":["../../../../src/hooks/lib/FetchHuriHashOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B"}

package/dist/esm/hooks/lib/FetchHuriHashOptions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=FetchHuriHashOptions.js.map

package/dist/esm/hooks/lib/FetchHuriHashOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FetchHuriHashOptions.js","sourceRoot":"","sources":["../../../../src/hooks/lib/FetchHuriHashOptions.ts"],"names":[],"mappings":""}

package/dist/esm/hooks/lib/findHuriNetwork.d.ts

@@ -0,0 +1,4 @@
+import { XyoNetworkPayload } from '@xyo-network/network';
+import { Huri } from '@xyo-network/payload';
+export declare const findHuriNetwork: (huriInstance: Huri, networks?: XyoNetworkPayload[]) => XyoNetworkPayload | undefined;
+//# sourceMappingURL=findHuriNetwork.d.ts.map

package/dist/esm/hooks/lib/findHuriNetwork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findHuriNetwork.d.ts","sourceRoot":"","sources":["../../../../src/hooks/lib/findHuriNetwork.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAE3C,eAAO,MAAM,eAAe,iBAAkB,IAAI,aAAa,iBAAiB,EAAE,kCASjF,CAAA"}

package/dist/esm/hooks/lib/findHuriNetwork.js

@@ -0,0 +1,9 @@
+export const findHuriNetwork = (huriInstance, networks) => {
+    // see if huri archivist matches any archivist in the network configs
+    return networks
+        ?.filter((network) => network.nodes?.find((node) => {
+        return node.type === 'archivist' && new URL(node.uri).hostname === huriInstance.archivist;
+    }))
+        .shift();
+};
+//# sourceMappingURL=findHuriNetwork.js.map

package/dist/esm/hooks/lib/findHuriNetwork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findHuriNetwork.js","sourceRoot":"","sources":["../../../../src/hooks/lib/findHuriNetwork.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,YAAkB,EAAE,QAA8B,EAAE,EAAE;IACpF,qEAAqE;IACrE,OAAO,QAAQ;QACb,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CACnB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,OAAO,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC,SAAS,CAAA;IAC3F,CAAC,CAAC,CACH;SACA,KAAK,EAAE,CAAA;AACZ,CAAC,CAAA"}

package/dist/esm/hooks/lib/index.d.ts

@@ -0,0 +1,3 @@
+export * from './FetchHuriHashOptions';
+export * from './findHuriNetwork';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/hooks/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA"}

package/dist/esm/hooks/lib/index.js

@@ -0,0 +1,3 @@
+export * from './FetchHuriHashOptions';
+export * from './findHuriNetwork';
+//# sourceMappingURL=index.js.map

package/dist/esm/hooks/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/hooks/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA"}

package/dist/esm/hooks/useHuriHash.d.ts

@@ -0,0 +1,13 @@
+import { Huri } from '@xyo-network/payload';
+import { FetchHuriHashOptions } from './lib';
+/**
+ * Resolve a hash or a huri regardless of network
+ */
+declare const useHuriHash: (huriOrHash?: string | Huri, huriUri?: string, options?: FetchHuriHashOptions) => [({
+    schema: string;
+    previousHash?: string | undefined;
+    sources?: string[] | undefined;
+    timestamp?: number | undefined;
+} | undefined)?, (boolean | undefined)?, (import("@xyo-network/api").XyoApiError<any, any> | undefined)?, (boolean | undefined)?];
+export { useHuriHash };
+//# sourceMappingURL=useHuriHash.d.ts.map

package/dist/esm/hooks/useHuriHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHuriHash.d.ts","sourceRoot":"","sources":["../../../src/hooks/useHuriHash.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAG3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAK5C;;GAEG;AACH,QAAA,MAAM,WAAW,gBAAiB,MAAM,GAAG,IAAI,YAAY,MAAM,YAAY,oBAAoB;;;;;iIA0BhG,CAAA;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/esm/hooks/useHuriHash.js

@@ -0,0 +1,30 @@
+import { Huri } from '@xyo-network/payload';
+import { useCallback } from 'react';
+import { useLoadPayload } from './useLoadPayload';
+import { useResolveHuri } from './useResolveHuri';
+/**
+ * Resolve a hash or a huri regardless of network
+ */
+const useHuriHash = (huriOrHash, huriUri, options) => {
+    const hash = useCallback((huriOrHash) => {
+        if (huriOrHash) {
+            if (typeof huriOrHash === 'string') {
+                return huriOrHash;
+            }
+            if (huriOrHash instanceof Huri) {
+                return huriOrHash.hash;
+            }
+        }
+    }, []);
+    const providedHash = hash(huriOrHash);
+    //AT: TODO -> Talk about this pattern
+    // Optimistically try to grab the has from the current network and archive
+    const [payload, notFound, apiError] = useLoadPayload(providedHash);
+    // if a huriUri was passed, we can safely override the notFound from the hash only query
+    const notFoundOverride = huriUri ? true : notFound;
+    // If payload isn't found, fallback to the huriUri
+    const [huriPayload, huriPayloadNotFound, huriApiError, networkNotFound] = useResolveHuri(huriUri, notFoundOverride, options);
+    return [payload ?? huriPayload, huriPayloadNotFound, apiError ?? huriApiError, networkNotFound];
+};
+export { useHuriHash };
+//# sourceMappingURL=useHuriHash.js.map

package/dist/esm/hooks/useHuriHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHuriHash.js","sourceRoot":"","sources":["../../../src/hooks/useHuriHash.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAInC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,GAAG,CAAC,UAA0B,EAAE,OAAgB,EAAE,OAA8B,EAAiB,EAAE;IAClH,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,UAA0B,EAAE,EAAE;QACtD,IAAI,UAAU,EAAE;YACd,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE;gBAClC,OAAO,UAAU,CAAA;aAClB;YACD,IAAI,UAAU,YAAY,IAAI,EAAE;gBAC9B,OAAO,UAAU,CAAC,IAAI,CAAA;aACvB;SACF;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,CAAA;IAErC,qCAAqC;IAErC,0EAA0E;IAC1E,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,cAAc,CAAC,YAAY,CAAC,CAAA;IAElE,wFAAwF;IACxF,MAAM,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAA;IAElD,kDAAkD;IAClD,MAAM,CAAC,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,eAAe,CAAC,GAAG,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAA;IAE5H,OAAO,CAAC,OAAO,IAAI,WAAW,EAAE,mBAAmB,EAAE,QAAQ,IAAI,YAAY,EAAE,eAAe,CAAC,CAAA;AACjG,CAAC,CAAA;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/esm/hooks/useLoadPayload.d.ts

@@ -0,0 +1,3 @@
+import { UsePayload } from './ResolvePayloadArgs';
+export declare const useLoadPayload: (hash?: string) => UsePayload;
+//# sourceMappingURL=useLoadPayload.d.ts.map

package/dist/esm/hooks/useLoadPayload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLoadPayload.d.ts","sourceRoot":"","sources":["../../../src/hooks/useLoadPayload.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjD,eAAO,MAAM,cAAc,UAAW,MAAM,eAiD3C,CAAA"}

package/dist/esm/hooks/useLoadPayload.js

@@ -0,0 +1,52 @@
+import { useAsyncEffect } from '@xylabs/react-shared';
+import { useArchive } from '@xyo-network/react-archive';
+import { useArchivistApi } from '@xyo-network/react-archivist-api';
+import { useEffect, useState } from 'react';
+export const useLoadPayload = (hash) => {
+    const { api } = useArchivistApi();
+    const { archive } = useArchive();
+    const [localHash, setLocalHash] = useState();
+    const [notFound, setNotFound] = useState();
+    const [apiError, setApiError] = useState();
+    const [payload, setPayload] = useState();
+    const reset = () => {
+        setPayload(undefined);
+        setApiError(undefined);
+        setNotFound(undefined);
+    };
+    // allow for hash changes to retrigger the api call
+    useEffect(() => {
+        if (hash !== localHash) {
+            setLocalHash(hash);
+            reset();
+        }
+    }, [hash, localHash]);
+    useAsyncEffect(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    async (mounted) => {
+        if (api && localHash && localHash.length > 0 && notFound === undefined) {
+            reset();
+            try {
+                const result = await api?.archive(archive).payload.hash(localHash).get();
+                if (mounted()) {
+                    if (result?.length) {
+                        setPayload(result[0]);
+                        setNotFound(false);
+                    }
+                    else if (result?.length === 0) {
+                        setNotFound(true);
+                        setPayload(undefined);
+                    }
+                }
+            }
+            catch (e) {
+                reset();
+                setNotFound(false);
+                setApiError(e);
+                console.error(e);
+            }
+        }
+    }, [hash, api, archive, payload, notFound, localHash]);
+    return [payload, notFound, apiError];
+};
+//# sourceMappingURL=useLoadPayload.js.map

package/dist/esm/hooks/useLoadPayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLoadPayload.js","sourceRoot":"","sources":["../../../src/hooks/useLoadPayload.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGrD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAClE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAI3C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAa,EAAc,EAAE;IAC1D,MAAM,EAAE,GAAG,EAAE,GAAG,eAAe,EAAE,CAAA;IACjC,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CAAA;IAChC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,EAAU,CAAA;IACpD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,EAAW,CAAA;IACnD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,EAAe,CAAA;IACvD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,EAAc,CAAA;IAEpD,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,UAAU,CAAC,SAAS,CAAC,CAAA;QACrB,WAAW,CAAC,SAAS,CAAC,CAAA;QACtB,WAAW,CAAC,SAAS,CAAC,CAAA;IACxB,CAAC,CAAA;IAED,mDAAmD;IACnD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI,KAAK,SAAS,EAAE;YACtB,YAAY,CAAC,IAAI,CAAC,CAAA;YAClB,KAAK,EAAE,CAAA;SACR;IACH,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAA;IAErB,cAAc;IACZ,uDAAuD;IACvD,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,IAAI,GAAG,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,KAAK,SAAS,EAAE;YACtE,KAAK,EAAE,CAAA;YACP,IAAI;gBACF,MAAM,MAAM,GAAG,MAAM,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAA;gBACxE,IAAI,OAAO,EAAE,EAAE;oBACb,IAAI,MAAM,EAAE,MAAM,EAAE;wBAClB,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;wBACrB,WAAW,CAAC,KAAK,CAAC,CAAA;qBACnB;yBAAM,IAAI,MAAM,EAAE,MAAM,KAAK,CAAC,EAAE;wBAC/B,WAAW,CAAC,IAAI,CAAC,CAAA;wBACjB,UAAU,CAAC,SAAS,CAAC,CAAA;qBACtB;iBACF;aACF;YAAC,OAAO,CAAC,EAAE;gBACV,KAAK,EAAE,CAAA;gBACP,WAAW,CAAC,KAAK,CAAC,CAAA;gBAClB,WAAW,CAAC,CAAgB,CAAC,CAAA;gBAC7B,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;aACjB;SACF;IACH,CAAC,EACD,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CACnD,CAAA;IACD,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;AACtC,CAAC,CAAA"}

package/dist/esm/hooks/useResolveHuri.d.ts

@@ -0,0 +1,10 @@
+import { XyoApiError } from '@xyo-network/api';
+import { FetchHuriHashOptions } from './lib';
+declare const useResolveHuri: (huriUri?: string, dependentNotFound?: boolean, options?: FetchHuriHashOptions) => [({
+    schema: string;
+    previousHash?: string | undefined;
+    sources?: string[] | undefined;
+    timestamp?: number | undefined;
+} | undefined)?, (boolean | undefined)?, (XyoApiError<any, any> | undefined)?, (boolean | undefined)?];
+export { useResolveHuri };
+//# sourceMappingURL=useResolveHuri.d.ts.map

package/dist/esm/hooks/useResolveHuri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolveHuri.d.ts","sourceRoot":"","sources":["../../../src/hooks/useResolveHuri.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAK9C,OAAO,EAAE,oBAAoB,EAAmB,MAAM,OAAO,CAAA;AAG7D,QAAA,MAAM,cAAc,aAAc,MAAM,sBAAsB,OAAO,YAAY,oBAAoB;;;;;sGA+DpG,CAAA;AAED,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/esm/hooks/useResolveHuri.js

@@ -0,0 +1,64 @@
+import { useAsyncEffect } from '@xylabs/react-shared';
+import { Huri } from '@xyo-network/payload';
+import { useNetwork } from '@xyo-network/react-network';
+import { useEffect, useState } from 'react';
+import { findHuriNetwork } from './lib';
+const useResolveHuri = (huriUri, dependentNotFound, options) => {
+    const { network, networks, setNetwork } = useNetwork();
+    const [huriPayload, setHuriPayload] = useState();
+    const [huriPayloadNotFound, setHuriPayloadNotFound] = useState();
+    const [huriNetworkNotFound, setHuriNetworkNotFound] = useState();
+    const [huriApiError, setHuriApiError] = useState();
+    const { changeActiveNetwork } = options ?? {};
+    //AT: TODO -> Talk about this pattern
+    const reset = () => {
+        setHuriPayload(undefined);
+        setHuriPayloadNotFound(undefined);
+        setHuriApiError(undefined);
+    };
+    useEffect(() => {
+        // Initially, sync local not found with dependent's status
+        setHuriPayloadNotFound(dependentNotFound);
+    }, [dependentNotFound]);
+    useAsyncEffect(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    async (mounted) => {
+        // if dependent value is resolved, don't do anything, if not resolved, try to resolve huriUri
+        if (dependentNotFound && huriUri) {
+            reset();
+            const huriInstance = new Huri(huriUri);
+            const foundHuriNetwork = findHuriNetwork(huriInstance, networks);
+            if (foundHuriNetwork && mounted()) {
+                if (network !== foundHuriNetwork && changeActiveNetwork) {
+                    setNetwork?.(foundHuriNetwork);
+                    return;
+                }
+                try {
+                    const huriPayload = await huriInstance.fetch();
+                    if (mounted()) {
+                        if (huriPayload) {
+                            setHuriPayload(huriPayload);
+                            setHuriPayloadNotFound(false);
+                        }
+                        else {
+                            setHuriPayloadNotFound(true);
+                        }
+                    }
+                }
+                catch (e) {
+                    if (mounted()) {
+                        setHuriPayloadNotFound(false);
+                        setHuriPayload(undefined);
+                        setHuriApiError(e);
+                    }
+                }
+            }
+            else {
+                setHuriNetworkNotFound(true);
+            }
+        }
+    }, [huriUri, network, networks, dependentNotFound, setNetwork, changeActiveNetwork]);
+    return [huriPayload, huriPayloadNotFound, huriApiError, huriNetworkNotFound];
+};
+export { useResolveHuri };
+//# sourceMappingURL=useResolveHuri.js.map

package/dist/esm/hooks/useResolveHuri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolveHuri.js","sourceRoot":"","sources":["../../../src/hooks/useResolveHuri.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,EAAE,IAAI,EAAc,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE3C,OAAO,EAAwB,eAAe,EAAE,MAAM,OAAO,CAAA;AAG7D,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAE,iBAA2B,EAAE,OAA8B,EAAiB,EAAE;IACtH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAAA;IACtD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,EAAc,CAAA;IAC5D,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,GAAG,QAAQ,EAAW,CAAA;IACzE,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,GAAG,QAAQ,EAAW,CAAA;IACzE,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,EAAe,CAAA;IAE/D,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,IAAI,EAAE,CAAA;IAE7C,qCAAqC;IACrC,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,cAAc,CAAC,SAAS,CAAC,CAAA;QACzB,sBAAsB,CAAC,SAAS,CAAC,CAAA;QACjC,eAAe,CAAC,SAAS,CAAC,CAAA;IAC5B,CAAC,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QACb,0DAA0D;QAC1D,sBAAsB,CAAC,iBAAiB,CAAC,CAAA;IAC3C,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAEvB,cAAc;IACZ,uDAAuD;IACvD,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,6FAA6F;QAC7F,IAAI,iBAAiB,IAAI,OAAO,EAAE;YAChC,KAAK,EAAE,CAAA;YACP,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAA;YAEtC,MAAM,gBAAgB,GAAG,eAAe,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;YAEhE,IAAI,gBAAgB,IAAI,OAAO,EAAE,EAAE;gBACjC,IAAI,OAAO,KAAK,gBAAgB,IAAI,mBAAmB,EAAE;oBACvD,UAAU,EAAE,CAAC,gBAAgB,CAAC,CAAA;oBAC9B,OAAM;iBACP;gBAED,IAAI;oBACF,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,CAAA;oBAC9C,IAAI,OAAO,EAAE,EAAE;wBACb,IAAI,WAAW,EAAE;4BACf,cAAc,CAAC,WAAW,CAAC,CAAA;4BAC3B,sBAAsB,CAAC,KAAK,CAAC,CAAA;yBAC9B;6BAAM;4BACL,sBAAsB,CAAC,IAAI,CAAC,CAAA;yBAC7B;qBACF;iBACF;gBAAC,OAAO,CAAC,EAAE;oBACV,IAAI,OAAO,EAAE,EAAE;wBACb,sBAAsB,CAAC,KAAK,CAAC,CAAA;wBAC7B,cAAc,CAAC,SAAS,CAAC,CAAA;wBACzB,eAAe,CAAC,CAAgB,CAAC,CAAA;qBAClC;iBACF;aACF;iBAAM;gBACL,sBAAsB,CAAC,IAAI,CAAC,CAAA;aAC7B;SACF;IACH,CAAC,EACD,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,mBAAmB,CAAC,CACjF,CAAA;IAED,OAAO,CAAC,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAA;AAC9E,CAAC,CAAA;AAED,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/esm/index.d.ts

@@ -1,2 +1,3 @@
 export * from './components';
+export * from './hooks';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA"}

package/dist/esm/index.js

@@ -1,2 +1,3 @@
 export * from './components';
+export * from './hooks';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA"}

package/package.json

@@ -10,24 +10,29 @@
     "url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/issues"
   },
   "dependencies": {
-    "@emotion/react": "^11.10.4",
-    "@emotion/styled": "^11.10.4",
+    "@xylabs/react-button": "^2.14.16",
+    "@xylabs/react-dialogs": "^2.14.16",
+    "@xylabs/react-flexbox": "^2.14.16",
+    "@xylabs/react-shared": "^2.14.16",
+    "@xyo-network/react-archive": "^2.32.0",
+    "@xyo-network/react-archivist-api": "^2.32.0",
+    "@xyo-network/react-network": "^2.32.0",
+    "@xyo-network/react-shared": "^2.32.0",
+    "react-json-view": "^1.21.3",
+    "tslib": "^2.4.0"
+  },
+  "peerDependencies": {
+    "@mui/icons-material": "^5.10.3",
     "@mui/material": "^5.10.3",
-    "@xylabs/react-button": "^2.14.14",
-    "@xylabs/react-dialogs": "^2.14.14",
-    "@xylabs/react-flexbox": "^2.14.14",
-    "@xylabs/react-shared": "^2.14.14",
-    "@xyo-network/react-shared": "^2.32.0-rc.7",
+    "@mui/styles": "^5.10.3",
+    "@xyo-network/api": "^2.30.0-rc.3",
+    "@xyo-network/network": "^2.30.0-rc.3",
+    "@xyo-network/payload": "^2.30.0-rc.3",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "react-json-view": "^1.21.3",
-    "react-router-dom": "^6.3.0",
-    "tslib": "^2.4.0"
+    "react-router-dom": "^6.3.0"
   },
   "description": "Common React library for all XYO projects that use React",
-  "devDependencies": {
-    "@xyo-network/api": "^2.30.0-rc.3"
-  },
   "browser": "dist/esm/index.js",
   "docs": "dist/docs.json",
   "exports": {
@@ -70,6 +75,5 @@
   },
   "sideEffects": false,
   "types": "dist/esm/index.d.ts",
-  "version": "2.32.0-rc.7",
-  "stableVersion": "2.31.3"
+  "version": "2.32.0"
 }

package/src/hooks/ResolvePayloadArgs.ts

@@ -0,0 +1,6 @@
+import { XyoApiError } from '@xyo-network/api'
+import { XyoPayload } from '@xyo-network/payload'
+
+export type UsePayload = [XyoPayload?, boolean?, XyoApiError?]
+
+export type UseHuriOrHash = [...UsePayload, boolean?]

package/src/hooks/index.ts

@@ -0,0 +1,5 @@
+export * from './lib'
+export * from './ResolvePayloadArgs'
+export * from './useHuriHash'
+export * from './useLoadPayload'
+export * from './useResolveHuri'

package/src/hooks/lib/FetchHuriHashOptions.ts

@@ -0,0 +1,3 @@
+export interface FetchHuriHashOptions {
+  changeActiveNetwork?: boolean
+}

package/src/hooks/lib/findHuriNetwork.ts

@@ -0,0 +1,13 @@
+import { XyoNetworkPayload } from '@xyo-network/network'
+import { Huri } from '@xyo-network/payload'
+
+export const findHuriNetwork = (huriInstance: Huri, networks?: XyoNetworkPayload[]) => {
+  // see if huri archivist matches any archivist in the network configs
+  return networks
+    ?.filter((network) =>
+      network.nodes?.find((node) => {
+        return node.type === 'archivist' && new URL(node.uri).hostname === huriInstance.archivist
+      }),
+    )
+    .shift()
+}

package/src/hooks/lib/index.ts

@@ -0,0 +1,2 @@
+export * from './FetchHuriHashOptions'
+export * from './findHuriNetwork'

package/src/hooks/useHuriHash.stories.tsx

@@ -0,0 +1,108 @@
+/* eslint-disable import/no-internal-modules */
+import { Alert, Typography } from '@mui/material'
+import { ComponentStory, Meta } from '@storybook/react'
+import { ButtonEx } from '@xylabs/react-button'
+import { FlexCol, FlexRow } from '@xylabs/react-flexbox'
+import { Huri } from '@xyo-network/payload'
+import { ArchivistApiProvider } from '@xyo-network/react-archivist-api'
+import { NetworkMemoryProvider } from '@xyo-network/react-network'
+import { XyoSchemaCache } from '@xyo-network/utils'
+import { lazy, Suspense, useState } from 'react'
+
+import { FetchHuriHashOptions } from './lib'
+import { useHuriHash } from './useHuriHash'
+
+const JsonView = lazy(() => import(/* webpackChunkName: "jsonView" */ 'react-json-view'))
+
+interface UseHuriHashComponentProps {
+  huriOrHash: string | Huri
+  huriUri?: string
+  options?: FetchHuriHashOptions
+  reTestable?: boolean
+}
+
+const apiDomain = 'https://beta.api.archivist.xyo.network'
+const hash = '5605fabad11b10bb5fb86b309ca0970894eda8f22362dda1a489817723bca992'
+XyoSchemaCache.instance.proxy = `${apiDomain}/domain`
+
+const mainApiDomain = 'https://api.archivist.xyo.network'
+const mainHash = 'd3a3936e31ba1d835c528784ab77c1eaaeedd6e16b7aad68a88241ce539853cb'
+
+const Wrapper: React.FC<UseHuriHashComponentProps> = (props) => (
+  <NetworkMemoryProvider>
+    <ArchivistApiProvider apiDomain={apiDomain}>
+      <UseHuriHashComponent {...props} />
+    </ArchivistApiProvider>
+  </NetworkMemoryProvider>
+)
+
+const UseHuriHashComponent: React.FC<UseHuriHashComponentProps> = ({ huriOrHash, huriUri, options, reTestable }) => {
+  const [trigger, setTrigger] = useState<string | Huri>(huriOrHash)
+  const [payload, notFound, , networkNotFound] = useHuriHash(trigger, huriUri, options)
+
+  return (
+    <>
+      <Typography variant="body1" fontWeight="bold">
+        Fetches the payload for a huriOrHash.
+      </Typography>
+      {reTestable ? (
+        <FlexRow columnGap={2}>
+          <ButtonEx variant="contained" onClick={() => setTrigger(hash)}>
+            Fetch Valid Hash
+          </ButtonEx>
+          <ButtonEx variant="contained" onClick={() => setTrigger('foo')}>
+            Hash Not Found
+          </ButtonEx>
+        </FlexRow>
+      ) : null}
+      <FlexCol my={3}>
+        {notFound === undefined && networkNotFound === undefined ? 'Loading...' : null}
+        {notFound ? <Alert severity="warning">Not Found</Alert> : null}
+        {networkNotFound ? <Alert severity="warning">Network Not Found</Alert> : null}
+        <Suspense fallback={<FlexCol busy />}>
+          <JsonView src={payload || {}} />
+        </Suspense>
+      </FlexCol>
+    </>
+  )
+}
+
+const StorybookEntry: Meta = {
+  argTypes: {},
+  component: UseHuriHashComponent,
+  parameters: {
+    docs: {
+      page: null,
+    },
+  },
+  title: 'payload/useHuriHash',
+}
+
+const Template: ComponentStory<typeof UseHuriHashComponent> = (props) => {
+  return <Wrapper {...props} />
+}
+
+const Default = Template.bind({})
+Default.args = { huriOrHash: hash }
+
+const NotFound = Template.bind({})
+NotFound.args = { huriOrHash: 'foo', reTestable: true }
+
+const WithHuri = Template.bind({})
+WithHuri.args = { huriOrHash: new Huri(`${apiDomain}/${hash}`) }
+
+const WithHuriUri = Template.bind({})
+WithHuriUri.args = { huriUri: `${mainApiDomain}/${mainHash}` }
+
+const WithHuriUriNetworkNotFound = Template.bind({})
+WithHuriUriNetworkNotFound.args = { huriUri: `http://badarchivisturl.com/${mainHash}` }
+
+// Note - story will work correctly once main net return 200 instead of 404 when payloads aren't found
+// Resolve huriUri when network is different from the current network
+const WithHuriUriNotFound = Template.bind({})
+WithHuriUriNotFound.args = { huriUri: `${mainApiDomain}/foo` }
+
+export { Default, NotFound, WithHuri, WithHuriUri, WithHuriUriNetworkNotFound, WithHuriUriNotFound }
+
+// eslint-disable-next-line import/no-default-export
+export default StorybookEntry

package/src/hooks/useHuriHash.tsx

@@ -0,0 +1,40 @@
+import { Huri } from '@xyo-network/payload'
+import { useCallback } from 'react'
+
+import { FetchHuriHashOptions } from './lib'
+import { UseHuriOrHash } from './ResolvePayloadArgs'
+import { useLoadPayload } from './useLoadPayload'
+import { useResolveHuri } from './useResolveHuri'
+
+/**
+ * Resolve a hash or a huri regardless of network
+ */
+const useHuriHash = (huriOrHash?: string | Huri, huriUri?: string, options?: FetchHuriHashOptions): UseHuriOrHash => {
+  const hash = useCallback((huriOrHash?: string | Huri) => {
+    if (huriOrHash) {
+      if (typeof huriOrHash === 'string') {
+        return huriOrHash
+      }
+      if (huriOrHash instanceof Huri) {
+        return huriOrHash.hash
+      }
+    }
+  }, [])
+
+  const providedHash = hash(huriOrHash)
+
+  //AT: TODO -> Talk about this pattern
+
+  // Optimistically try to grab the has from the current network and archive
+  const [payload, notFound, apiError] = useLoadPayload(providedHash)
+
+  // if a huriUri was passed, we can safely override the notFound from the hash only query
+  const notFoundOverride = huriUri ? true : notFound
+
+  // If payload isn't found, fallback to the huriUri
+  const [huriPayload, huriPayloadNotFound, huriApiError, networkNotFound] = useResolveHuri(huriUri, notFoundOverride, options)
+
+  return [payload ?? huriPayload, huriPayloadNotFound, apiError ?? huriApiError, networkNotFound]
+}
+
+export { useHuriHash }