@xyo-network/react-payload 2.27.2 → 2.27.5

package/dist/esm/contexts/PayloadDiviner/Context.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="react" />
+import { PayloadDivinerState } from './State';
+declare const PayloadDivinerContext: import("react").Context<PayloadDivinerState & import("@xyo-network/react-shared").ContextExState>;
+export { PayloadDivinerContext };
+//# sourceMappingURL=Context.d.ts.map

package/dist/esm/contexts/PayloadDiviner/Context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../../../src/contexts/PayloadDiviner/Context.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAE7C,QAAA,MAAM,qBAAqB,mGAAyC,CAAA;AAEpE,OAAO,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/esm/contexts/PayloadDiviner/Context.js

@@ -0,0 +1,4 @@
+import { createContextEx } from '@xyo-network/react-shared';
+const PayloadDivinerContext = createContextEx();
+export { PayloadDivinerContext };
+//# sourceMappingURL=Context.js.map

package/dist/esm/contexts/PayloadDiviner/Context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Context.js","sourceRoot":"","sources":["../../../../src/contexts/PayloadDiviner/Context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAI3D,MAAM,qBAAqB,GAAG,eAAe,EAAuB,CAAA;AAEpE,OAAO,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/esm/contexts/PayloadDiviner/Provider.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="react" />
+import { XyoPayloadDiviner } from '@xyo-network/diviner';
+import { ContextExProviderProps } from '@xyo-network/react-shared';
+export declare type PayloadDivinerProviderProps = ContextExProviderProps<{
+    diviner?: XyoPayloadDiviner;
+}>;
+export declare const PayloadDivinerProvider: React.FC<PayloadDivinerProviderProps>;
+//# sourceMappingURL=Provider.d.ts.map

package/dist/esm/contexts/PayloadDiviner/Provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../../src/contexts/PayloadDiviner/Provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAyB,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAKlE,oBAAY,2BAA2B,GAAG,sBAAsB,CAAC;IAC/D,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B,CAAC,CAAA;AAEF,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAoBxE,CAAA"}

package/dist/esm/contexts/PayloadDiviner/Provider.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { XyoHuriPayloadDiviner } from '@xyo-network/diviner';
+import { useArchivistApi } from '@xyo-network/react-archivist-api';
+import { useMemo, useState } from 'react';
+import { PayloadDivinerContext } from './Context';
+export const PayloadDivinerProvider = ({ diviner: divinerProp, required = false, children }) => {
+    const [diviner, setDiviner] = useState(divinerProp);
+    const { api } = useArchivistApi();
+    const activeDiviner = useMemo(() => {
+        //if no diviner is set, then we use a XyoHuriPayloadDiviner
+        return diviner ?? new XyoHuriPayloadDiviner({ archivistUri: api?.config.apiDomain });
+    }, [diviner, api?.config.apiDomain]);
+    return (_jsx(PayloadDivinerContext.Provider, { value: {
+            diviner: activeDiviner,
+            provided: true,
+            setDiviner,
+        }, children: diviner ? children : required ? null : children }));
+};
+//# sourceMappingURL=Provider.js.map

package/dist/esm/contexts/PayloadDiviner/Provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.js","sourceRoot":"","sources":["../../../../src/contexts/PayloadDiviner/Provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,qBAAqB,EAAqB,MAAM,sBAAsB,CAAA;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAElE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAMjD,MAAM,CAAC,MAAM,sBAAsB,GAA0C,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE;IACpI,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAgC,WAAW,CAAC,CAAA;IAClF,MAAM,EAAE,GAAG,EAAE,GAAG,eAAe,EAAE,CAAA;IAEjC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE;QACjC,2DAA2D;QAC3D,OAAO,OAAO,IAAI,IAAI,qBAAqB,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;IACtF,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;IAEpC,OAAO,CACL,KAAC,qBAAqB,CAAC,QAAQ,IAC7B,KAAK,EAAE;YACL,OAAO,EAAE,aAAa;YACtB,QAAQ,EAAE,IAAI;YACd,UAAU;SACX,YAEA,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,GACjB,CAClC,CAAA;AACH,CAAC,CAAA"}

package/dist/esm/contexts/PayloadDiviner/State.d.ts

@@ -0,0 +1,7 @@
+import { XyoPayloadDiviner } from '@xyo-network/diviner';
+import { Dispatch } from 'react';
+export interface PayloadDivinerState {
+    diviner?: XyoPayloadDiviner;
+    setDiviner?: Dispatch<XyoPayloadDiviner>;
+}
+//# sourceMappingURL=State.d.ts.map

package/dist/esm/contexts/PayloadDiviner/State.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"State.d.ts","sourceRoot":"","sources":["../../../../src/contexts/PayloadDiviner/State.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhC,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,UAAU,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAA;CACzC"}

package/dist/esm/contexts/PayloadDiviner/State.js

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

package/dist/esm/contexts/PayloadDiviner/State.js.map

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

package/dist/esm/contexts/PayloadDiviner/index.d.ts

@@ -0,0 +1,5 @@
+export * from './Context';
+export * from './Provider';
+export * from './State';
+export * from './use';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/contexts/PayloadDiviner/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA"}

package/dist/esm/contexts/PayloadDiviner/index.js

@@ -0,0 +1,5 @@
+export * from './Context';
+export * from './Provider';
+export * from './State';
+export * from './use';
+//# sourceMappingURL=index.js.map

package/dist/esm/contexts/PayloadDiviner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/contexts/PayloadDiviner/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA"}

package/dist/esm/contexts/PayloadDiviner/use.d.ts

@@ -0,0 +1,5 @@
+import { XyoPayload } from '@xyo-network/payload';
+export declare const usePayloadDiviner: (required?: boolean) => Omit<import("./State").PayloadDivinerState & import("@xyo-network/react-shared").ContextExState, "provided">;
+export declare const useDivinePayload: (huri?: string) => [XyoPayload | undefined | null, Error | undefined];
+export declare const useDivinePayloads: (huriList: string[]) => [(XyoPayload | null)[] | undefined, Error[] | undefined];
+//# sourceMappingURL=use.d.ts.map

package/dist/esm/contexts/PayloadDiviner/use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use.d.ts","sourceRoot":"","sources":["../../../../src/contexts/PayloadDiviner/use.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAOjD,eAAO,MAAM,iBAAiB,sIAE7B,CAAA;AAED,eAAO,MAAM,gBAAgB,UAAW,MAAM,KAAG,CAAC,UAAU,GAAG,SAAS,GAAG,IAAI,EAAE,KAAK,GAAG,SAAS,CAyBjG,CAAA;AAED,eAAO,MAAM,iBAAiB,aAAc,MAAM,EAAE,KAAG,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,GAAG,SAAS,CA0B7G,CAAA"}

package/dist/esm/contexts/PayloadDiviner/use.js

@@ -0,0 +1,50 @@
+import { useAsyncEffect } from '@xylabs/react-shared';
+import { XyoPayloadDivinerPayloadSchema, XyoPayloadDivinerQueryPayloadSchema } from '@xyo-network/diviner';
+import { useContextEx } from '@xyo-network/react-shared';
+import compact from 'lodash/compact';
+import { useState } from 'react';
+import { PayloadDivinerContext } from './Context';
+export const usePayloadDiviner = (required = false) => {
+    return useContextEx(PayloadDivinerContext, 'PayloadDiviner', required);
+};
+export const useDivinePayload = (huri) => {
+    const { diviner } = usePayloadDiviner();
+    const [payload, setPayload] = useState();
+    const [error, setError] = useState();
+    useAsyncEffect(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    async (mounted) => {
+        if (huri) {
+            try {
+                const payload = (await diviner?.divine({ huri, schema: XyoPayloadDivinerQueryPayloadSchema, targetSchema: XyoPayloadDivinerPayloadSchema }))?.payload;
+                if (mounted()) {
+                    setPayload(payload);
+                }
+            }
+            catch (ex) {
+                if (mounted()) {
+                    setError(ex);
+                }
+            }
+        }
+    }, [diviner, huri]);
+    return [payload, error];
+};
+export const useDivinePayloads = (huriList) => {
+    const { diviner } = usePayloadDiviner();
+    const [payloads, setPayloads] = useState();
+    const [errors, setErrors] = useState();
+    useAsyncEffect(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    async (mounted) => {
+        console.log(`huriList: ${JSON.stringify(huriList, null, 2)}`);
+        const payloads = await Promise.allSettled(huriList.map(async (huri) => (await diviner?.divine({ huri, schema: XyoPayloadDivinerQueryPayloadSchema, targetSchema: XyoPayloadDivinerPayloadSchema }))?.payload ?? null));
+        if (mounted()) {
+            setPayloads([...payloads.values()].map((value) => (value.status === 'rejected' ? null : value.value)));
+            setErrors(compact([...payloads.values()].map((value) => (value.status === 'rejected' ? Error('fivine failed', { cause: value.reason }) : undefined))));
+        }
+    }, [diviner, huriList]);
+    console.log(`payloads: ${JSON.stringify(payloads, null, 2)}`);
+    return [payloads, errors];
+};
+//# sourceMappingURL=use.js.map

package/dist/esm/contexts/PayloadDiviner/use.js.map

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

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

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

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

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

package/dist/esm/contexts/index.js

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

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

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

package/package.json

@@ -18,19 +18,19 @@
     "@xylabs/react-flexbox": "^2.14.10",
     "@xylabs/react-quick-tip-button": "^2.14.10",
     "@xylabs/react-shared": "^2.14.10",
-    "@xyo-network/api": "^2.24.6",
-    "@xyo-network/network": "^2.24.6",
-    "@xyo-network/payload": "^2.24.6",
-    "@xyo-network/react-archive": "^2.27.2",
-    "@xyo-network/react-archivist": "^2.27.2",
-    "@xyo-network/react-archivist-api": "^2.27.2",
-    "@xyo-network/react-auth-service": "^2.27.2",
-    "@xyo-network/react-network": "^2.27.2",
-    "@xyo-network/react-property": "^2.27.2",
-    "@xyo-network/react-schema": "^2.27.2",
-    "@xyo-network/react-shared": "^2.27.2",
-    "@xyo-network/schema-payload-plugin": "^2.24.6",
-    "@xyo-network/utils": "^2.24.6",
+    "@xyo-network/api": "^2.24.10",
+    "@xyo-network/network": "^2.24.10",
+    "@xyo-network/payload": "^2.24.10",
+    "@xyo-network/react-archive": "^2.27.5",
+    "@xyo-network/react-archivist": "^2.27.5",
+    "@xyo-network/react-archivist-api": "^2.27.5",
+    "@xyo-network/react-auth-service": "^2.27.5",
+    "@xyo-network/react-network": "^2.27.5",
+    "@xyo-network/react-property": "^2.27.5",
+    "@xyo-network/react-schema": "^2.27.5",
+    "@xyo-network/react-shared": "^2.27.5",
+    "@xyo-network/schema-payload-plugin": "^2.24.10",
+    "@xyo-network/utils": "^2.24.10",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "react-icons": "^4.4.0",
@@ -41,7 +41,7 @@
   "devDependencies": {
     "@storybook/react": "^6.5.10",
     "@xylabs/tsconfig-dom": "^2.5.13",
-    "@xyo-network/react-storybook": "^2.27.2"
+    "@xyo-network/react-storybook": "^2.27.5"
   },
   "browser": "dist/esm/index.js",
   "docs": "dist/docs.json",
@@ -92,5 +92,5 @@
   },
   "sideEffects": false,
   "types": "dist/esm/index.d.ts",
-  "version": "2.27.2"
+  "version": "2.27.5"
 }

package/src/contexts/PayloadDiviner/Context.ts

@@ -0,0 +1,7 @@
+import { createContextEx } from '@xyo-network/react-shared'
+
+import { PayloadDivinerState } from './State'
+
+const PayloadDivinerContext = createContextEx<PayloadDivinerState>()
+
+export { PayloadDivinerContext }

package/src/contexts/PayloadDiviner/Provider.tsx

@@ -0,0 +1,32 @@
+import { XyoHuriPayloadDiviner, XyoPayloadDiviner } from '@xyo-network/diviner'
+import { useArchivistApi } from '@xyo-network/react-archivist-api'
+import { ContextExProviderProps } from '@xyo-network/react-shared'
+import { useMemo, useState } from 'react'
+
+import { PayloadDivinerContext } from './Context'
+
+export type PayloadDivinerProviderProps = ContextExProviderProps<{
+  diviner?: XyoPayloadDiviner
+}>
+
+export const PayloadDivinerProvider: React.FC<PayloadDivinerProviderProps> = ({ diviner: divinerProp, required = false, children }) => {
+  const [diviner, setDiviner] = useState<XyoPayloadDiviner | undefined>(divinerProp)
+  const { api } = useArchivistApi()
+
+  const activeDiviner = useMemo(() => {
+    //if no diviner is set, then we use a XyoHuriPayloadDiviner
+    return diviner ?? new XyoHuriPayloadDiviner({ archivistUri: api?.config.apiDomain })
+  }, [diviner, api?.config.apiDomain])
+
+  return (
+    <PayloadDivinerContext.Provider
+      value={{
+        diviner: activeDiviner,
+        provided: true,
+        setDiviner,
+      }}
+    >
+      {diviner ? children : required ? null : children}
+    </PayloadDivinerContext.Provider>
+  )
+}

package/src/contexts/PayloadDiviner/State.ts

@@ -0,0 +1,7 @@
+import { XyoPayloadDiviner } from '@xyo-network/diviner'
+import { Dispatch } from 'react'
+
+export interface PayloadDivinerState {
+  diviner?: XyoPayloadDiviner
+  setDiviner?: Dispatch<XyoPayloadDiviner>
+}

package/src/contexts/PayloadDiviner/index.ts

@@ -0,0 +1,4 @@
+export * from './Context'
+export * from './Provider'
+export * from './State'
+export * from './use'

package/src/contexts/PayloadDiviner/use.ts

@@ -0,0 +1,67 @@
+import { useAsyncEffect } from '@xylabs/react-shared'
+import { XyoPayloadDivinerPayloadSchema, XyoPayloadDivinerQueryPayloadSchema } from '@xyo-network/diviner'
+import { XyoPayload } from '@xyo-network/payload'
+import { useContextEx } from '@xyo-network/react-shared'
+import compact from 'lodash/compact'
+import { useState } from 'react'
+
+import { PayloadDivinerContext } from './Context'
+
+export const usePayloadDiviner = (required = false) => {
+  return useContextEx(PayloadDivinerContext, 'PayloadDiviner', required)
+}
+
+export const useDivinePayload = (huri?: string): [XyoPayload | undefined | null, Error | undefined] => {
+  const { diviner } = usePayloadDiviner()
+  const [payload, setPayload] = useState<XyoPayload | null>()
+  const [error, setError] = useState<Error>()
+
+  useAsyncEffect(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    async (mounted) => {
+      if (huri) {
+        try {
+          const payload = (await diviner?.divine({ huri, schema: XyoPayloadDivinerQueryPayloadSchema, targetSchema: XyoPayloadDivinerPayloadSchema }))?.payload
+          if (mounted()) {
+            setPayload(payload)
+          }
+        } catch (ex) {
+          if (mounted()) {
+            setError(ex as Error)
+          }
+        }
+      }
+    },
+    [diviner, huri]
+  )
+
+  return [payload, error]
+}
+
+export const useDivinePayloads = (huriList: string[]): [(XyoPayload | null)[] | undefined, Error[] | undefined] => {
+  const { diviner } = usePayloadDiviner()
+  const [payloads, setPayloads] = useState<(XyoPayload | null)[]>()
+  const [errors, setErrors] = useState<Error[]>()
+
+  useAsyncEffect(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    async (mounted) => {
+      console.log(`huriList: ${JSON.stringify(huriList, null, 2)}`)
+      const payloads = await Promise.allSettled(
+        huriList.map(
+          async (huri) =>
+            (await diviner?.divine({ huri, schema: XyoPayloadDivinerQueryPayloadSchema, targetSchema: XyoPayloadDivinerPayloadSchema }))?.payload ?? null
+        )
+      )
+      if (mounted()) {
+        setPayloads([...payloads.values()].map((value) => (value.status === 'rejected' ? null : value.value)))
+        setErrors(compact([...payloads.values()].map((value) => (value.status === 'rejected' ? Error('fivine failed', { cause: value.reason }) : undefined))))
+      }
+    },
+    [diviner, huriList]
+  )
+
+  console.log(`payloads: ${JSON.stringify(payloads, null, 2)}`)
+
+  return [payloads, errors]
+}

package/src/contexts/index.ts

@@ -1 +1,2 @@
 export * from './Payload'
+export * from './PayloadDiviner'