@xyo-network/react-archivist 2.38.0-rc.5 → 2.38.0-rc.7

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

@@ -1,5 +1,10 @@
 import { XyoPayload, XyoPayloadFindFilter } from '@xyo-network/payload';
+declare type RefreshCallback = () => void;
 export declare const useArchivist: (required?: boolean) => Omit<import("./State").ArchivistState & import("@xyo-network/react-shared").ContextExState, "provided">;
-export declare const useArchivistGet: (ids?: string[], required?: boolean) => [(XyoPayload | null)[]?, Error?];
-export declare const useArchivistFind: <TFilter extends XyoPayloadFindFilter>(filter: TFilter, required?: boolean) => [(XyoPayload | null)[]?, Error?];
+export declare const useArchivistGet: (ids?: string[], required?: boolean) => [(XyoPayload | null)[]?, Error?, RefreshCallback?];
+export declare const useArchivistFind: <TFilter extends XyoPayloadFindFilter>(filter: TFilter, required?: boolean) => [(XyoPayload | null)[]?, Error?, RefreshCallback?];
+export declare const useArchivistInsert: (payloads: XyoPayload[], required?: boolean) => [(XyoPayload | null)[]?, Error?];
+export declare const useArchivistAll: (required?: boolean) => [(XyoPayload | null)[]?, Error?];
+export declare const useArchivistClear: (required?: boolean) => [(XyoPayload | null)[]?, Error?];
+export {};
 //# sourceMappingURL=use.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use.d.ts","sourceRoot":"","sources":["../../../src/contexts/use.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAe,MAAM,sBAAsB,CAAA;AAMpF,eAAO,MAAM,YAAY,iIAExB,CAAA;AAED,eAAO,MAAM,eAAe,SAAU,MAAM,EAAE,yBAAqB,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAqBjG,CAAA;AAED,eAAO,MAAM,gBAAgB,iFAA8E,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAqBzI,CAAA"}
+{"version":3,"file":"use.d.ts","sourceRoot":"","sources":["../../../src/contexts/use.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAe,MAAM,sBAAsB,CAAA;AAMpF,aAAK,eAAe,GAAG,MAAM,IAAI,CAAA;AAEjC,eAAO,MAAM,YAAY,iIAExB,CAAA;AAaD,eAAO,MAAM,eAAe,SAAU,MAAM,EAAE,yBAAqB,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,eAAe,CAAC,CA0BnH,CAAA;AAED,eAAO,MAAM,gBAAgB,iFAG1B,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,eAAe,CAAC,CAyBnD,CAAA;AAED,eAAO,MAAM,kBAAkB,aAAc,UAAU,EAAE,yBAAqB,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAkC5G,CAAA;AAED,eAAO,MAAM,eAAe,0BAAuB,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAqBjF,CAAA;AAED,eAAO,MAAM,iBAAiB,0BAAuB,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAqBnF,CAAA"}

package/dist/esm/contexts/use.js

@@ -1,12 +1,95 @@
 import { useAsyncEffect } from '@xylabs/react-shared';
 import { XyoArchivistWrapper } from '@xyo-network/archivist';
-import { useContextEx } from '@xyo-network/react-shared';
+import { useContextEx, useDataState } from '@xyo-network/react-shared';
 import { useState } from 'react';
 import { ArchivistContext } from './Context';
 export const useArchivist = (required = false) => {
     return useContextEx(ArchivistContext, 'Archivist', required);
 };
+const useSharedUseArchivistState = (required) => {
+    const [payloads, setPayloads] = useState();
+    const { archivist } = useArchivist(required);
+    const [error, setError] = useState();
+    const [refresh, setRefresh] = useState(1);
+    const [inFlight, setInFlight] = useState(false);
+    const refreshPayloads = () => setRefresh((previous) => previous + 1);
+    return { archivist, error, inFlight, payloads, refresh, refreshPayloads, setError, setInFlight, setPayloads };
+};
 export const useArchivistGet = (ids, required = false) => {
+    const [savedIds] = useDataState(ids);
+    const { archivist, error, inFlight, payloads, refresh, setError, setInFlight, setPayloads, refreshPayloads } = useSharedUseArchivistState(required);
+    useAsyncEffect(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    async (mounted) => {
+        try {
+            if (archivist && !inFlight && savedIds) {
+                const wrapper = new XyoArchivistWrapper(archivist);
+                const result = (await wrapper?.get(savedIds ?? [])) ?? [];
+                setInFlight(true);
+                if (mounted()) {
+                    setError(undefined);
+                    setPayloads(result);
+                    setInFlight(false);
+                }
+            }
+        }
+        catch (ex) {
+            setError(ex);
+            setInFlight(false);
+        }
+    }, [archivist, savedIds, refresh, inFlight, setInFlight, setError, setPayloads]);
+    return [payloads, error, refreshPayloads];
+};
+export const useArchivistFind = (filter, required = false) => {
+    const [savedFilter] = useDataState(filter);
+    const { archivist, error, inFlight, payloads, refresh, setError, setInFlight, setPayloads, refreshPayloads } = useSharedUseArchivistState(required);
+    useAsyncEffect(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    async (mounted) => {
+        try {
+            if (archivist && !inFlight && savedFilter) {
+                const wrapper = new XyoArchivistWrapper(archivist);
+                const result = await wrapper?.find(savedFilter);
+                setInFlight(true);
+                if (mounted()) {
+                    setError(undefined);
+                    setPayloads(result);
+                    setInFlight(false);
+                }
+            }
+        }
+        catch (ex) {
+            setError(ex);
+            setInFlight(false);
+        }
+    }, [archivist, inFlight, refresh, savedFilter, setError, setInFlight, setPayloads]);
+    return [payloads, error, refreshPayloads];
+};
+export const useArchivistInsert = (payloads, required = false) => {
+    const [savedPayloads] = useDataState(payloads);
+    const { archivist, error, inFlight, payloads: resultPayloads, refresh, setError, setInFlight, setPayloads: setResultPayloads, } = useSharedUseArchivistState(required);
+    useAsyncEffect(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    async (mounted) => {
+        try {
+            if (archivist && !inFlight && savedPayloads) {
+                const wrapper = new XyoArchivistWrapper(archivist);
+                const result = await wrapper.insert(savedPayloads);
+                setInFlight(true);
+                if (mounted()) {
+                    setError(undefined);
+                    setResultPayloads(result);
+                }
+            }
+        }
+        catch (ex) {
+            setError(ex);
+            setInFlight(true);
+        }
+    }, [archivist, inFlight, refresh, savedPayloads, setError, setInFlight, setResultPayloads]);
+    return [resultPayloads, error];
+};
+export const useArchivistAll = (required = false) => {
     const { archivist } = useArchivist(required);
     const [payloads, setPayloads] = useState();
     const [error, setError] = useState();
@@ -15,7 +98,7 @@ export const useArchivistGet = (ids, required = false) => {
     async (mounted) => {
         try {
             const wrapper = archivist ? new XyoArchivistWrapper(archivist) : undefined;
-            const result = (await wrapper?.get(ids ?? [])) ?? [];
+            const result = await wrapper?.all();
             if (mounted()) {
                 setError(undefined);
                 setPayloads(result);
@@ -24,10 +107,10 @@ export const useArchivistGet = (ids, required = false) => {
         catch (ex) {
             setError(ex);
         }
-    }, [archivist, ids]);
+    }, [archivist]);
     return [payloads, error];
 };
-export const useArchivistFind = (filter, required = false) => {
+export const useArchivistClear = (required = false) => {
     const { archivist } = useArchivist(required);
     const [payloads, setPayloads] = useState();
     const [error, setError] = useState();
@@ -36,16 +119,16 @@ export const useArchivistFind = (filter, required = false) => {
     async (mounted) => {
         try {
             const wrapper = archivist ? new XyoArchivistWrapper(archivist) : undefined;
-            const result = await wrapper?.find(filter);
+            await wrapper?.clear();
             if (mounted()) {
                 setError(undefined);
-                setPayloads(result);
+                setPayloads([]);
             }
         }
         catch (ex) {
             setError(ex);
         }
-    }, [archivist, filter]);
+    }, [archivist]);
     return [payloads, error];
 };
 //# sourceMappingURL=use.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use.js","sourceRoot":"","sources":["../../../src/contexts/use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE5C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,GAAG,KAAK,EAAE,EAAE;IAC/C,OAAO,YAAY,CAAC,gBAAgB,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAA;AAC9D,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAc,EAAE,QAAQ,GAAG,KAAK,EAAoC,EAAE;IACpG,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC5C,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,EAAe,CAAA;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,EAAS,CAAA;IAC3C,cAAc;IACZ,uDAAuD;IACvD,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,IAAI;YACF,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAC1E,MAAM,MAAM,GAAG,CAAC,MAAM,OAAO,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;YACpD,IAAI,OAAO,EAAE,EAAE;gBACb,QAAQ,CAAC,SAAS,CAAC,CAAA;gBACnB,WAAW,CAAC,MAAM,CAAC,CAAA;aACpB;SACF;QAAC,OAAO,EAAE,EAAE;YACX,QAAQ,CAAC,EAAW,CAAC,CAAA;SACtB;IACH,CAAC,EACD,CAAC,SAAS,EAAE,GAAG,CAAC,CACjB,CAAA;IACD,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;AAC1B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAuC,MAAe,EAAE,QAAQ,GAAG,KAAK,EAAoC,EAAE;IAC5I,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC5C,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,EAAe,CAAA;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,EAAS,CAAA;IAC3C,cAAc;IACZ,uDAAuD;IACvD,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,IAAI;YACF,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAC1E,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;YAC1C,IAAI,OAAO,EAAE,EAAE;gBACb,QAAQ,CAAC,SAAS,CAAC,CAAA;gBACnB,WAAW,CAAC,MAAM,CAAC,CAAA;aACpB;SACF;QAAC,OAAO,EAAE,EAAE;YACX,QAAQ,CAAC,EAAW,CAAC,CAAA;SACtB;IACH,CAAC,EACD,CAAC,SAAS,EAAE,MAAM,CAAC,CACpB,CAAA;IACD,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;AAC1B,CAAC,CAAA"}
+{"version":3,"file":"use.js","sourceRoot":"","sources":["../../../src/contexts/use.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -13,8 +13,8 @@
     "@xylabs/react-button": "^2.15.1",
     "@xylabs/react-flexbox": "^2.15.1",
     "@xylabs/react-shared": "^2.15.1",
-    "@xyo-network/module": "^2.38.0-rc.9",
-    "@xyo-network/react-shared": "^2.38.0-rc.5",
+    "@xyo-network/module": "^2.38.0-rc.12",
+    "@xyo-network/react-shared": "^2.38.0-rc.7",
     "lodash": "^4.17.21",
     "tslib": "^2.4.0"
   },
@@ -29,9 +29,10 @@
   "description": "Common React library for all XYO projects that use React",
   "devDependencies": {
     "@types/lodash": "^4.14.186",
-    "@xyo-network/api": "^2.38.0-rc.9",
-    "@xyo-network/archivist": "^2.38.0-rc.9",
-    "@xyo-network/payload": "^2.38.0-rc.9"
+    "@xyo-network/api": "^2.38.0-rc.12",
+    "@xyo-network/archivist": "^2.38.0-rc.12",
+    "@xyo-network/payload": "^2.38.0-rc.12",
+    "@xyo-network/react-archivist-api": "^2.38.0-rc.7"
   },
   "browser": "dist/esm/index.js",
   "docs": "dist/docs.json",
@@ -75,6 +76,6 @@
   },
   "sideEffects": false,
   "types": "dist/esm/index.d.ts",
-  "version": "2.38.0-rc.5",
+  "version": "2.38.0-rc.7",
   "stableVersion": "2.37.29"
 }

package/src/contexts/story/ArchivistHooks.stories.tsx

@@ -0,0 +1,44 @@
+import { ComponentMeta, ComponentStory } from '@storybook/react'
+
+import { useArchivistFind, useArchivistGet } from '../use'
+import { ArchivistPayloads } from './ArchivistPayloads.stories'
+import { WithArchivistProviders } from './WithArchivistProviders.stories'
+
+const StorybookEntry = {
+  argTypes: {},
+  component: ArchivistPayloads,
+  decorators: [WithArchivistProviders],
+  parameters: {
+    docs: {
+      page: null,
+    },
+  },
+  title: 'archivist/Hooks',
+} as ComponentMeta<typeof ArchivistPayloads>
+
+const ArchivistGetPayloadsTemplate: ComponentStory<typeof ArchivistPayloads> = (args) => {
+  const [payloads, error, refresh] = useArchivistGet([
+    '3da33603417622f4cdad2becbca8c7889623d9045d0e8923e1702a99d2f3e47c',
+    '3da33603417622f4cdad2becbca8c7889623d9045d0e8923e1702a99d2f3e47d',
+  ])
+  return <ArchivistPayloads payloads={payloads} error={error} refresh={refresh} {...args}></ArchivistPayloads>
+}
+
+const ArchivistFindPayloadsTemplate: ComponentStory<typeof ArchivistPayloads> = (args) => {
+  const [payloads, error, refresh] = useArchivistFind({
+    limit: 5,
+    schema: 'network.xyo.payload',
+  })
+  return <ArchivistPayloads payloads={payloads} error={error} refresh={refresh} {...args}></ArchivistPayloads>
+}
+
+const Get = ArchivistGetPayloadsTemplate.bind({})
+Get.args = {}
+
+const Find = ArchivistFindPayloadsTemplate.bind({})
+Find.args = {}
+
+export { Find, Get }
+
+// eslint-disable-next-line import/no-default-export
+export default StorybookEntry

package/src/contexts/story/ArchivistPayloads.stories.tsx

@@ -0,0 +1,31 @@
+import { Button, Card, CardContent, CardHeader } from '@mui/material'
+import { FlexCol } from '@xylabs/react-flexbox'
+import { XyoPayload } from '@xyo-network/payload'
+
+export interface ArchivistPayloadsProps {
+  refresh?: () => void
+  payloads?: (XyoPayload | null)[]
+  error?: Error
+}
+
+export const ArchivistPayloads: React.FC<ArchivistPayloadsProps> = ({ refresh, payloads, error }) => {
+  return (
+    <FlexCol rowGap={2}>
+      <Button variant="contained" onClick={() => refresh?.()}>
+        Refresh
+      </Button>
+      <Card>
+        <CardHeader title="Payloads" />
+        <CardContent>
+          <pre style={{ whiteSpace: 'pre-wrap', wordBreak: 'break-all' }}>{payloads ? JSON.stringify(payloads, null, 2) : null}</pre>
+        </CardContent>
+      </Card>
+      <Card>
+        <CardHeader title="Errors" />
+        <CardContent>
+          <pre style={{ whiteSpace: 'pre-wrap', wordBreak: 'break-all' }}>{error ? JSON.stringify(error, null, 2) : null}</pre>
+        </CardContent>
+      </Card>
+    </FlexCol>
+  )
+}

package/src/contexts/story/WithArchivistProviders.stories.tsx

@@ -0,0 +1,28 @@
+import { DecoratorFn } from '@storybook/react'
+import { WithChildren } from '@xylabs/react-shared'
+import { ArchivistApiProvider, useArchivistApi } from '@xyo-network/react-archivist-api'
+
+import { RemoteArchivistProvider } from '../Provider'
+
+const WithArchivist: React.FC<WithChildren> = ({ children }) => {
+  return <ArchivistApiProvider apiDomain="https://beta.api.archivist.xyo.network">{children}</ArchivistApiProvider>
+}
+
+const WithRemoteArchivist: React.FC<WithChildren> = ({ children }) => {
+  const { api } = useArchivistApi()
+  return (
+    <RemoteArchivistProvider config={{ api: api, archive: 'temp', schema: 'network.xyo.archivist.remote.config' }}>
+      {children}
+    </RemoteArchivistProvider>
+  )
+}
+
+export const WithArchivistProviders: DecoratorFn = (Story, args) => {
+  return (
+    <WithArchivist>
+      <WithRemoteArchivist>
+        <Story {...args} />
+      </WithRemoteArchivist>
+    </WithArchivist>
+  )
+}

package/src/contexts/use.ts

@@ -1,16 +1,123 @@
 import { useAsyncEffect } from '@xylabs/react-shared'
 import { XyoArchivistWrapper } from '@xyo-network/archivist'
 import { XyoPayload, XyoPayloadFindFilter, XyoPayloads } from '@xyo-network/payload'
-import { useContextEx } from '@xyo-network/react-shared'
+import { useContextEx, useDataState } from '@xyo-network/react-shared'
 import { useState } from 'react'
 
 import { ArchivistContext } from './Context'
 
+type RefreshCallback = () => void
+
 export const useArchivist = (required = false) => {
   return useContextEx(ArchivistContext, 'Archivist', required)
 }
 
-export const useArchivistGet = (ids?: string[], required = false): [(XyoPayload | null)[]?, Error?] => {
+const useSharedUseArchivistState = (required: boolean) => {
+  const [payloads, setPayloads] = useState<XyoPayloads>()
+  const { archivist } = useArchivist(required)
+  const [error, setError] = useState<Error>()
+  const [refresh, setRefresh] = useState(1)
+  const [inFlight, setInFlight] = useState(false)
+  const refreshPayloads = () => setRefresh((previous) => previous + 1)
+
+  return { archivist, error, inFlight, payloads, refresh, refreshPayloads, setError, setInFlight, setPayloads }
+}
+
+export const useArchivistGet = (ids?: string[], required = false): [(XyoPayload | null)[]?, Error?, RefreshCallback?] => {
+  const [savedIds] = useDataState(ids)
+  const { archivist, error, inFlight, payloads, refresh, setError, setInFlight, setPayloads, refreshPayloads } = useSharedUseArchivistState(required)
+
+  useAsyncEffect(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    async (mounted) => {
+      try {
+        if (archivist && !inFlight && savedIds) {
+          const wrapper = new XyoArchivistWrapper(archivist)
+          const result = (await wrapper?.get(savedIds ?? [])) ?? []
+          setInFlight(true)
+          if (mounted()) {
+            setError(undefined)
+            setPayloads(result)
+            setInFlight(false)
+          }
+        }
+      } catch (ex) {
+        setError(ex as Error)
+        setInFlight(false)
+      }
+    },
+    [archivist, savedIds, refresh, inFlight, setInFlight, setError, setPayloads],
+  )
+  return [payloads, error, refreshPayloads]
+}
+
+export const useArchivistFind = <TFilter extends XyoPayloadFindFilter>(
+  filter: TFilter,
+  required = false,
+): [(XyoPayload | null)[]?, Error?, RefreshCallback?] => {
+  const [savedFilter] = useDataState(filter)
+  const { archivist, error, inFlight, payloads, refresh, setError, setInFlight, setPayloads, refreshPayloads } = useSharedUseArchivistState(required)
+  useAsyncEffect(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    async (mounted) => {
+      try {
+        if (archivist && !inFlight && savedFilter) {
+          const wrapper = new XyoArchivistWrapper(archivist)
+          const result = await wrapper?.find(savedFilter)
+          setInFlight(true)
+          if (mounted()) {
+            setError(undefined)
+            setPayloads(result)
+            setInFlight(false)
+          }
+        }
+      } catch (ex) {
+        setError(ex as Error)
+        setInFlight(false)
+      }
+    },
+    [archivist, inFlight, refresh, savedFilter, setError, setInFlight, setPayloads],
+  )
+  return [payloads, error, refreshPayloads]
+}
+
+export const useArchivistInsert = (payloads: XyoPayload[], required = false): [(XyoPayload | null)[]?, Error?] => {
+  const [savedPayloads] = useDataState(payloads)
+  const {
+    archivist,
+    error,
+    inFlight,
+    payloads: resultPayloads,
+    refresh,
+    setError,
+    setInFlight,
+    setPayloads: setResultPayloads,
+  } = useSharedUseArchivistState(required)
+
+  useAsyncEffect(
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    async (mounted) => {
+      try {
+        if (archivist && !inFlight && savedPayloads) {
+          const wrapper = new XyoArchivistWrapper(archivist)
+          const result = await wrapper.insert(savedPayloads)
+          setInFlight(true)
+          if (mounted()) {
+            setError(undefined)
+            setResultPayloads(result)
+          }
+        }
+      } catch (ex) {
+        setError(ex as Error)
+        setInFlight(true)
+      }
+    },
+    [archivist, inFlight, refresh, savedPayloads, setError, setInFlight, setResultPayloads],
+  )
+  return [resultPayloads, error]
+}
+
+export const useArchivistAll = (required = false): [(XyoPayload | null)[]?, Error?] => {
   const { archivist } = useArchivist(required)
   const [payloads, setPayloads] = useState<XyoPayloads>()
   const [error, setError] = useState<Error>()
@@ -19,7 +126,7 @@ export const useArchivistGet = (ids?: string[], required = false): [(XyoPayload
     async (mounted) => {
       try {
         const wrapper = archivist ? new XyoArchivistWrapper(archivist) : undefined
-        const result = (await wrapper?.get(ids ?? [])) ?? []
+        const result = await wrapper?.all()
         if (mounted()) {
           setError(undefined)
           setPayloads(result)
@@ -28,12 +135,12 @@ export const useArchivistGet = (ids?: string[], required = false): [(XyoPayload
         setError(ex as Error)
       }
     },
-    [archivist, ids],
+    [archivist],
   )
   return [payloads, error]
 }
 
-export const useArchivistFind = <TFilter extends XyoPayloadFindFilter>(filter: TFilter, required = false): [(XyoPayload | null)[]?, Error?] => {
+export const useArchivistClear = (required = false): [(XyoPayload | null)[]?, Error?] => {
   const { archivist } = useArchivist(required)
   const [payloads, setPayloads] = useState<XyoPayloads>()
   const [error, setError] = useState<Error>()
@@ -42,16 +149,16 @@ export const useArchivistFind = <TFilter extends XyoPayloadFindFilter>(filter: T
     async (mounted) => {
       try {
         const wrapper = archivist ? new XyoArchivistWrapper(archivist) : undefined
-        const result = await wrapper?.find(filter)
+        await wrapper?.clear()
         if (mounted()) {
           setError(undefined)
-          setPayloads(result)
+          setPayloads([])
         }
       } catch (ex) {
         setError(ex as Error)
       }
     },
-    [archivist, filter],
+    [archivist],
   )
   return [payloads, error]
 }