@chill-sharp/react-client 1.1.12 → 1.1.15

package/src/hooks.ts

@@ -1,515 +1,515 @@
-/*
- * ChillSharp is a lightweight .NET library that sits on top of Entity Framework Core 
- * and turns an existing data model into a fully working REST API with almost no setup.
- * Copyright (C) 2025 Andrea Piovesan
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- * 
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU Affero General Public License for more details.
- * 
- * You should have received a copy of the GNU Affero General Public License
- * along with this program.  If not, see <https://www.gnu.org/licenses/>.
- */
-
-import { useEffect, useRef, useState } from "react";
-import { CHILL_SHARP_REACT_CLIENT_VERSION } from "./version.js";
-import { useChillSharpClient } from "./context.js";
-import type {
-  ChillDtoSchema,
-  ChillDtoSchemaListItem,
-  ChillUserPreferences,
-  ChillEntityChangeCallback,
-  ChillEntityChangeSubscription,
-  ChillValidationError,
-  GetTextRequest,
-  GetTextResponse,
-  JsonObject
-} from "@chill-sharp/ts-client";
-
-export interface UseChillAsyncState<TData> {
-  data: TData | null;
-  error: unknown;
-  isLoading: boolean;
-  reload: () => Promise<TData | null>;
-}
-
-export interface UseChillMutationState<TData> {
-  data: TData | null;
-  error: unknown;
-  isLoading: boolean;
-  execute: (...args: unknown[]) => Promise<TData>;
-  reset: () => void;
-}
-
-export interface UseChillSubscriptionState {
-  error: unknown;
-  isSubscribed: boolean;
-}
-
-export function useSchema(
-  chillType: string,
-  chillViewCode = "default",
-  cultureName?: string,
-  update = false
-): UseChillAsyncState<ChillDtoSchema> {
-  const client = useChillSharpClient();
-  const [data, setData] = useState<ChillDtoSchema | null>(null);
-  const [error, setError] = useState<unknown>(null);
-  const [isLoading, setIsLoading] = useState<boolean>(true);
-
-  const load = async () => {
-    setIsLoading(true);
-    setError(null);
-
-    try {
-      const response = await client.getSchema(chillType, chillViewCode, cultureName, update);
-      setData(response);
-      return response;
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-
-  useEffect(() => {
-    void load();
-  }, [client, chillType, chillViewCode, cultureName, update]);
-
-  return {
-    data,
-    error,
-    isLoading,
-    reload: load
-  };
-}
-
-export function useSchemaList(cultureName?: string): UseChillAsyncState<ChillDtoSchemaListItem[]> {
-  const client = useChillSharpClient();
-  const [data, setData] = useState<ChillDtoSchemaListItem[] | null>(null);
-  const [error, setError] = useState<unknown>(null);
-  const [isLoading, setIsLoading] = useState<boolean>(true);
-
-  const load = async () => {
-    setIsLoading(true);
-    setError(null);
-
-    try {
-      const response = await client.getSchemaList(cultureName);
-      setData(response);
-      return response;
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-
-  useEffect(() => {
-    void load();
-  }, [client, cultureName]);
-
-  return {
-    data,
-    error,
-    isLoading,
-    reload: load
-  };
-}
-
-export function useText(request: GetTextRequest): UseChillAsyncState<GetTextResponse> {
-  const client = useChillSharpClient();
-  const [data, setData] = useState<GetTextResponse | null>(null);
-  const [error, setError] = useState<unknown>(null);
-  const [isLoading, setIsLoading] = useState<boolean>(true);
-
-  const load = async () => {
-    setIsLoading(true);
-    setError(null);
-
-    try {
-      const response = await client.getText(request);
-      setData(response);
-      return response;
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-
-  useEffect(() => {
-    void load();
-  }, [client, request]);
-
-  return {
-    data,
-    error,
-    isLoading,
-    reload: load
-  };
-}
-
-export function useTexts(requests: GetTextRequest[]): UseChillAsyncState<Array<GetTextResponse | null>> {
-  const client = useChillSharpClient();
-  const [data, setData] = useState<Array<GetTextResponse | null> | null>(null);
-  const [error, setError] = useState<unknown>(null);
-  const [isLoading, setIsLoading] = useState<boolean>(true);
-
-  const load = async () => {
-    setIsLoading(true);
-    setError(null);
-
-    try {
-      const response = await client.getTexts(requests);
-      setData(response);
-      return response;
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-
-  useEffect(() => {
-    void load();
-  }, [client, requests]);
-
-  return {
-    data,
-    error,
-    isLoading,
-    reload: load
-  };
-}
-
-export function useVersion(): string {
-  return CHILL_SHARP_REACT_CLIENT_VERSION;
-}
-
-export function useTest(): UseChillAsyncState<string> {
-  const client = useChillSharpClient();
-  const [data, setData] = useState<string | null>(null);
-  const [error, setError] = useState<unknown>(null);
-  const [isLoading, setIsLoading] = useState<boolean>(true);
-
-  const load = async () => {
-    setIsLoading(true);
-    setError(null);
-
-    try {
-      const response = await client.test();
-      setData(response);
-      return response;
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-
-  useEffect(() => {
-    void load();
-  }, [client]);
-
-  return {
-    data,
-    error,
-    isLoading,
-    reload: load
-  };
-}
-
-export function useCurrentUserPreferences(): UseChillAsyncState<ChillUserPreferences> {
-  const client = useChillSharpClient();
-  const [data, setData] = useState<ChillUserPreferences | null>(null);
-  const [error, setError] = useState<unknown>(null);
-  const [isLoading, setIsLoading] = useState<boolean>(true);
-
-  const load = async () => {
-    setIsLoading(true);
-    setError(null);
-    try {
-      const response = await client.getCurrentUserPreferences();
-      setData(response);
-      return response;
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-
-  useEffect(() => { void load(); }, [client]);
-  return { data, error, isLoading, reload: load };
-}
-
-export function useQueryMutation(): UseChillMutationState<JsonObject> {
-  const client = useChillSharpClient();
-  const [data, setData] = useState<JsonObject | null>(null);
-  const [error, setError] = useState<unknown>(null);
-  const [isLoading, setIsLoading] = useState<boolean>(false);
-
-  const execute = async (...args: unknown[]) => {
-    const payload = args[0] as JsonObject;
-    setIsLoading(true);
-    setError(null);
-
-    try {
-      const response = await client.query(payload);
-      setData(response);
-      return response;
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-
-  return {
-    data,
-    error,
-    isLoading,
-    execute,
-    reset: () => {
-      setData(null);
-      setError(null);
-      setIsLoading(false);
-    }
-  };
-}
-
-export function useLookupMutation(): UseChillMutationState<JsonObject> {
-  const client = useChillSharpClient();
-  const [data, setData] = useState<JsonObject | null>(null);
-  const [error, setError] = useState<unknown>(null);
-  const [isLoading, setIsLoading] = useState<boolean>(false);
-
-  const execute = async (...args: unknown[]) => {
-    const payload = args[0] as JsonObject;
-    setIsLoading(true);
-    setError(null);
-
-    try {
-      const response = await client.lookup(payload);
-      setData(response);
-      return response;
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-
-  return {
-    data,
-    error,
-    isLoading,
-    execute,
-    reset: () => {
-      setData(null);
-      setError(null);
-      setIsLoading(false);
-    }
-  };
-}
-
-export function useAutocompleteMutation(): UseChillMutationState<JsonObject> {
-  const client = useChillSharpClient();
-  const [data, setData] = useState<JsonObject | null>(null);
-  const [error, setError] = useState<unknown>(null);
-  const [isLoading, setIsLoading] = useState<boolean>(false);
-
-  const execute = async (...args: unknown[]) => {
-    const payload = args[0] as JsonObject;
-    setIsLoading(true);
-    setError(null);
-
-    try {
-      const response = await client.autocomplete(payload);
-      setData(response);
-      return response;
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-
-  return {
-    data,
-    error,
-    isLoading,
-    execute,
-    reset: () => {
-      setData(null);
-      setError(null);
-      setIsLoading(false);
-    }
-  };
-}
-
-export function useValidateMutation(): UseChillMutationState<ChillValidationError[]> {
-  const client = useChillSharpClient();
-  const [data, setData] = useState<ChillValidationError[] | null>(null);
-  const [error, setError] = useState<unknown>(null);
-  const [isLoading, setIsLoading] = useState<boolean>(false);
-
-  const execute = async (...args: unknown[]) => {
-    const payload = args[0] as JsonObject;
-    setIsLoading(true);
-    setError(null);
-
-    try {
-      const response = await client.validate(payload);
-      setData(response);
-      return response;
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-
-  return {
-    data,
-    error,
-    isLoading,
-    execute,
-    reset: () => {
-      setData(null);
-      setError(null);
-      setIsLoading(false);
-    }
-  };
-}
-
-export function useEntityMutation(action: "find" | "create" | "update" | "delete"): UseChillMutationState<JsonObject | null> {
-  const client = useChillSharpClient();
-  const [data, setData] = useState<JsonObject | null>(null);
-  const [error, setError] = useState<unknown>(null);
-  const [isLoading, setIsLoading] = useState<boolean>(false);
-
-  const execute = async (...args: unknown[]) => {
-    const payload = args[0] as JsonObject;
-    setIsLoading(true);
-    setError(null);
-
-    try {
-      let response: JsonObject | null;
-      switch (action) {
-        case "find":
-          response = await client.find(payload);
-          break;
-        case "create":
-          response = await client.create(payload);
-          break;
-        case "update":
-          response = await client.update(payload);
-          break;
-        default:
-          await client.delete(payload);
-          response = null;
-          break;
-      }
-
-      setData(response);
-      return response;
-    } catch (err) {
-      setError(err);
-      throw err;
-    } finally {
-      setIsLoading(false);
-    }
-  };
-
-  return {
-    data,
-    error,
-    isLoading,
-    execute,
-    reset: () => {
-      setData(null);
-      setError(null);
-      setIsLoading(false);
-    }
-  };
-}
-
-export function useEntityChanges(
-  chillType: string,
-  onChanges: ChillEntityChangeCallback,
-  guid?: string | null
-): UseChillSubscriptionState {
-  const client = useChillSharpClient();
-  const onChangesRef = useRef<ChillEntityChangeCallback>(onChanges);
-  const unsubscribeRef = useRef<null | (() => Promise<void>)>(null);
-  const [error, setError] = useState<unknown>(null);
-  const [isSubscribed, setIsSubscribed] = useState<boolean>(false);
-
-  useEffect(() => {
-    onChangesRef.current = onChanges;
-  }, [onChanges]);
-
-  useEffect(() => {
-    let isDisposed = false;
-
-    setError(null);
-    setIsSubscribed(false);
-    unsubscribeRef.current = null;
-
-    void client
-      .subscribeToEntityChanges(
-        chillType,
-        async (changes) => {
-          await onChangesRef.current(changes);
-        },
-        guid
-      )
-      .then((subscription: ChillEntityChangeSubscription) => {
-        if (isDisposed) {
-          void subscription.unsubscribe();
-          return;
-        }
-
-        unsubscribeRef.current = () => subscription.unsubscribe();
-        setIsSubscribed(true);
-      })
-      .catch((err) => {
-        if (!isDisposed) {
-          setError(err);
-          setIsSubscribed(false);
-        }
-      });
-
-    return () => {
-      isDisposed = true;
-      setIsSubscribed(false);
-      if (unsubscribeRef.current) {
-        void unsubscribeRef.current();
-        unsubscribeRef.current = null;
-      }
-    };
-  }, [client, chillType, guid]);
-
-  return {
-    error,
-    isSubscribed
-  };
-}
+/*
+ * ChillSharp is a lightweight .NET library that sits on top of Entity Framework Core 
+ * and turns an existing data model into a fully working REST API with almost no setup.
+ * Copyright (C) 2025 Andrea Piovesan
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ * 
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ * 
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { useEffect, useRef, useState } from "react";
+import { CHILL_SHARP_REACT_CLIENT_VERSION } from "./version.js";
+import { useChillSharpClient } from "./context.js";
+import type {
+  ChillDtoSchema,
+  ChillDtoSchemaListItem,
+  ChillUserPreferences,
+  ChillEntityChangeCallback,
+  ChillEntityChangeSubscription,
+  ChillValidationError,
+  GetTextRequest,
+  GetTextResponse,
+  JsonObject
+} from "@chill-sharp/ts-client";
+
+export interface UseChillAsyncState<TData> {
+  data: TData | null;
+  error: unknown;
+  isLoading: boolean;
+  reload: () => Promise<TData | null>;
+}
+
+export interface UseChillMutationState<TData> {
+  data: TData | null;
+  error: unknown;
+  isLoading: boolean;
+  execute: (...args: unknown[]) => Promise<TData>;
+  reset: () => void;
+}
+
+export interface UseChillSubscriptionState {
+  error: unknown;
+  isSubscribed: boolean;
+}
+
+export function useSchema(
+  chillType: string,
+  chillViewCode = "default",
+  cultureName?: string,
+  update = false
+): UseChillAsyncState<ChillDtoSchema> {
+  const client = useChillSharpClient();
+  const [data, setData] = useState<ChillDtoSchema | null>(null);
+  const [error, setError] = useState<unknown>(null);
+  const [isLoading, setIsLoading] = useState<boolean>(true);
+
+  const load = async () => {
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      const response = await client.getSchema(chillType, chillViewCode, cultureName, update);
+      setData(response);
+      return response;
+    } catch (err) {
+      setError(err);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    void load();
+  }, [client, chillType, chillViewCode, cultureName, update]);
+
+  return {
+    data,
+    error,
+    isLoading,
+    reload: load
+  };
+}
+
+export function useSchemaList(cultureName?: string): UseChillAsyncState<ChillDtoSchemaListItem[]> {
+  const client = useChillSharpClient();
+  const [data, setData] = useState<ChillDtoSchemaListItem[] | null>(null);
+  const [error, setError] = useState<unknown>(null);
+  const [isLoading, setIsLoading] = useState<boolean>(true);
+
+  const load = async () => {
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      const response = await client.getSchemaList(cultureName);
+      setData(response);
+      return response;
+    } catch (err) {
+      setError(err);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    void load();
+  }, [client, cultureName]);
+
+  return {
+    data,
+    error,
+    isLoading,
+    reload: load
+  };
+}
+
+export function useText(request: GetTextRequest): UseChillAsyncState<GetTextResponse> {
+  const client = useChillSharpClient();
+  const [data, setData] = useState<GetTextResponse | null>(null);
+  const [error, setError] = useState<unknown>(null);
+  const [isLoading, setIsLoading] = useState<boolean>(true);
+
+  const load = async () => {
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      const response = await client.getText(request);
+      setData(response);
+      return response;
+    } catch (err) {
+      setError(err);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    void load();
+  }, [client, request]);
+
+  return {
+    data,
+    error,
+    isLoading,
+    reload: load
+  };
+}
+
+export function useTexts(requests: GetTextRequest[]): UseChillAsyncState<Array<GetTextResponse | null>> {
+  const client = useChillSharpClient();
+  const [data, setData] = useState<Array<GetTextResponse | null> | null>(null);
+  const [error, setError] = useState<unknown>(null);
+  const [isLoading, setIsLoading] = useState<boolean>(true);
+
+  const load = async () => {
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      const response = await client.getTexts(requests);
+      setData(response);
+      return response;
+    } catch (err) {
+      setError(err);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    void load();
+  }, [client, requests]);
+
+  return {
+    data,
+    error,
+    isLoading,
+    reload: load
+  };
+}
+
+export function useVersion(): string {
+  return CHILL_SHARP_REACT_CLIENT_VERSION;
+}
+
+export function useTest(): UseChillAsyncState<string> {
+  const client = useChillSharpClient();
+  const [data, setData] = useState<string | null>(null);
+  const [error, setError] = useState<unknown>(null);
+  const [isLoading, setIsLoading] = useState<boolean>(true);
+
+  const load = async () => {
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      const response = await client.test();
+      setData(response);
+      return response;
+    } catch (err) {
+      setError(err);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    void load();
+  }, [client]);
+
+  return {
+    data,
+    error,
+    isLoading,
+    reload: load
+  };
+}
+
+export function useCurrentUserPreferences(): UseChillAsyncState<ChillUserPreferences> {
+  const client = useChillSharpClient();
+  const [data, setData] = useState<ChillUserPreferences | null>(null);
+  const [error, setError] = useState<unknown>(null);
+  const [isLoading, setIsLoading] = useState<boolean>(true);
+
+  const load = async () => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      const response = await client.getCurrentUserPreferences();
+      setData(response);
+      return response;
+    } catch (err) {
+      setError(err);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  useEffect(() => { void load(); }, [client]);
+  return { data, error, isLoading, reload: load };
+}
+
+export function useQueryMutation(): UseChillMutationState<JsonObject> {
+  const client = useChillSharpClient();
+  const [data, setData] = useState<JsonObject | null>(null);
+  const [error, setError] = useState<unknown>(null);
+  const [isLoading, setIsLoading] = useState<boolean>(false);
+
+  const execute = async (...args: unknown[]) => {
+    const payload = args[0] as JsonObject;
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      const response = await client.query(payload);
+      setData(response);
+      return response;
+    } catch (err) {
+      setError(err);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  return {
+    data,
+    error,
+    isLoading,
+    execute,
+    reset: () => {
+      setData(null);
+      setError(null);
+      setIsLoading(false);
+    }
+  };
+}
+
+export function useLookupMutation(): UseChillMutationState<JsonObject> {
+  const client = useChillSharpClient();
+  const [data, setData] = useState<JsonObject | null>(null);
+  const [error, setError] = useState<unknown>(null);
+  const [isLoading, setIsLoading] = useState<boolean>(false);
+
+  const execute = async (...args: unknown[]) => {
+    const payload = args[0] as JsonObject;
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      const response = await client.lookup(payload);
+      setData(response);
+      return response;
+    } catch (err) {
+      setError(err);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  return {
+    data,
+    error,
+    isLoading,
+    execute,
+    reset: () => {
+      setData(null);
+      setError(null);
+      setIsLoading(false);
+    }
+  };
+}
+
+export function useAutocompleteMutation(): UseChillMutationState<JsonObject> {
+  const client = useChillSharpClient();
+  const [data, setData] = useState<JsonObject | null>(null);
+  const [error, setError] = useState<unknown>(null);
+  const [isLoading, setIsLoading] = useState<boolean>(false);
+
+  const execute = async (...args: unknown[]) => {
+    const payload = args[0] as JsonObject;
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      const response = await client.autocomplete(payload);
+      setData(response);
+      return response;
+    } catch (err) {
+      setError(err);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  return {
+    data,
+    error,
+    isLoading,
+    execute,
+    reset: () => {
+      setData(null);
+      setError(null);
+      setIsLoading(false);
+    }
+  };
+}
+
+export function useValidateMutation(): UseChillMutationState<ChillValidationError[]> {
+  const client = useChillSharpClient();
+  const [data, setData] = useState<ChillValidationError[] | null>(null);
+  const [error, setError] = useState<unknown>(null);
+  const [isLoading, setIsLoading] = useState<boolean>(false);
+
+  const execute = async (...args: unknown[]) => {
+    const payload = args[0] as JsonObject;
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      const response = await client.validate(payload);
+      setData(response);
+      return response;
+    } catch (err) {
+      setError(err);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  return {
+    data,
+    error,
+    isLoading,
+    execute,
+    reset: () => {
+      setData(null);
+      setError(null);
+      setIsLoading(false);
+    }
+  };
+}
+
+export function useEntityMutation(action: "find" | "create" | "update" | "delete"): UseChillMutationState<JsonObject | null> {
+  const client = useChillSharpClient();
+  const [data, setData] = useState<JsonObject | null>(null);
+  const [error, setError] = useState<unknown>(null);
+  const [isLoading, setIsLoading] = useState<boolean>(false);
+
+  const execute = async (...args: unknown[]) => {
+    const payload = args[0] as JsonObject;
+    setIsLoading(true);
+    setError(null);
+
+    try {
+      let response: JsonObject | null;
+      switch (action) {
+        case "find":
+          response = await client.find(payload);
+          break;
+        case "create":
+          response = await client.create(payload);
+          break;
+        case "update":
+          response = await client.update(payload);
+          break;
+        default:
+          await client.delete(payload);
+          response = null;
+          break;
+      }
+
+      setData(response);
+      return response;
+    } catch (err) {
+      setError(err);
+      throw err;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  return {
+    data,
+    error,
+    isLoading,
+    execute,
+    reset: () => {
+      setData(null);
+      setError(null);
+      setIsLoading(false);
+    }
+  };
+}
+
+export function useEntityChanges(
+  chillType: string,
+  onChanges: ChillEntityChangeCallback,
+  guid?: string | null
+): UseChillSubscriptionState {
+  const client = useChillSharpClient();
+  const onChangesRef = useRef<ChillEntityChangeCallback>(onChanges);
+  const unsubscribeRef = useRef<null | (() => Promise<void>)>(null);
+  const [error, setError] = useState<unknown>(null);
+  const [isSubscribed, setIsSubscribed] = useState<boolean>(false);
+
+  useEffect(() => {
+    onChangesRef.current = onChanges;
+  }, [onChanges]);
+
+  useEffect(() => {
+    let isDisposed = false;
+
+    setError(null);
+    setIsSubscribed(false);
+    unsubscribeRef.current = null;
+
+    void client
+      .subscribeToEntityChanges(
+        chillType,
+        async (changes) => {
+          await onChangesRef.current(changes);
+        },
+        guid
+      )
+      .then((subscription: ChillEntityChangeSubscription) => {
+        if (isDisposed) {
+          void subscription.unsubscribe();
+          return;
+        }
+
+        unsubscribeRef.current = () => subscription.unsubscribe();
+        setIsSubscribed(true);
+      })
+      .catch((err) => {
+        if (!isDisposed) {
+          setError(err);
+          setIsSubscribed(false);
+        }
+      });
+
+    return () => {
+      isDisposed = true;
+      setIsSubscribed(false);
+      if (unsubscribeRef.current) {
+        void unsubscribeRef.current();
+        unsubscribeRef.current = null;
+      }
+    };
+  }, [client, chillType, guid]);
+
+  return {
+    error,
+    isSubscribed
+  };
+}