added useEntity and useEntityQuery hooks

app/src/ui/client/api/use-api.ts

@@ -0,0 +1,30 @@
+import type { Api } from "Api";
+import type { FetchPromise } from "modules/ModuleApi";
+import useSWR, { type SWRConfiguration, useSWRConfig } from "swr";
+import { useClient } from "ui/client/ClientProvider";
+
+export const useApi = () => {
+   const client = useClient();
+   return client.api;
+};
+
+export const useApiQuery = <Data, RefineFn extends (data: Data) => any = (data: Data) => Data>(
+   fn: (api: Api) => FetchPromise<Data>,
+   options?: SWRConfiguration & { enabled?: boolean; refine?: RefineFn }
+) => {
+   const api = useApi();
+   const promise = fn(api);
+   const refine = options?.refine ?? ((data: Data) => data);
+   const fetcher = () => promise.execute().then(refine);
+   const key = promise.key();
+
+   type RefinedData = RefineFn extends (data: Data) => infer R ? R : Data;
+
+   const swr = useSWR<RefinedData>(options?.enabled === false ? null : key, fetcher, options);
+   return {
+      ...swr,
+      promise,
+      key,
+      api
+   };
+};