@trackunit/react-core-hooks 1.12.43 → 1.12.44-alpha-57a40ea11fa.0

package/index.cjs.js

@@ -379,64 +379,76 @@ const useModalDialogContext = () => {
     return modalDialogContext;
 };
 
-const isMultipleCriteriaOneOf = (options) => {
-    return typeof options === "object" && "oneOf" in options;
-};
-const isMultipleCriteriaRequireAll = (options) => {
-    return typeof options === "object" && "requireAll" in options;
+const isMultipleCriteriaOneOf = (options) => typeof options === "object" && "oneOf" in options;
+const isMultipleCriteriaRequireAll = (options) => typeof options === "object" && "requireAll" in options;
+const resolveAccess = async (context, options) => {
+    if (isMultipleCriteriaOneOf(options) && isMultipleCriteriaRequireAll(options)) {
+        throw new Error("Multiple criteria are not allowed, use one of or require all - not both");
+    }
+    if (isMultipleCriteriaOneOf(options)) {
+        const results = await Promise.all(options.oneOf.map(option => context.hasAccessTo(option)));
+        return results.some(Boolean);
+    }
+    if (isMultipleCriteriaRequireAll(options)) {
+        const results = await Promise.all(options.requireAll.map(option => context.hasAccessTo(option)));
+        return results.every(Boolean);
+    }
+    return context.hasAccessTo(options);
 };
 /**
- * This is a hook to use the hasAccessTo in host.
- * You can use this to ensure the page you link to is available for the user to see.
+ * Hook to check if the current user has access to a navigation target.
+ * Useful for conditionally rendering links based on user permissions.
  *
  * @requires NavigationContext
  * @example
  * import { useHasAccessTo } from "@trackunit/react-core-hooks";
  * useHasAccessTo({ assetId: assetInfo?.assetId, page: "movement" })
- * @see (@link NavigationRuntimeApi)
- * @see (@link HasAccessToOptions)
- * @see (@link HasAccessToOptions.assetId)
- * @see (@link HasAccessToOptions.page)
- * @see (@link HasAccessToOptions.siteId)
- * @see (@link NavigationRuntimeApi)
+ * @see {@link NavigationRuntimeApi}
+ * @see {@link HasAccessToOptions}
  */
 const useHasAccessTo = (options) => {
     const context = react.useContext(reactCoreContextsApi.NavigationContext);
-    if (!context) {
-        throw new Error("useHasAccessTo must be used within an NavigationContext");
-    }
+    const [stableOptions, setStableOptions] = react.useState(options);
     const [hasAccess, setHasAccess] = react.useState();
     const [loading, setLoading] = react.useState(true);
     const [error, setError] = react.useState();
+    if (JSON.stringify(stableOptions) !== JSON.stringify(options)) {
+        setStableOptions(options);
+    }
     react.useEffect(() => {
-        async function checkAccess() {
+        if (!context)
+            return;
+        let cancelled = false;
+        setLoading(true);
+        setError(undefined);
+        const checkAccess = async () => {
             try {
-                if (isMultipleCriteriaOneOf(options) && isMultipleCriteriaRequireAll(options)) {
-                    throw new Error("Multiple criteria are not allowed, use one of or require all - not both");
-                }
-                if (isMultipleCriteriaOneOf(options)) {
-                    const doHaveAccess = await Promise.all(options.oneOf.map(option => context?.hasAccessTo(option)));
-                    setHasAccess(doHaveAccess.some(access => access));
-                }
-                else if (isMultipleCriteriaRequireAll(options)) {
-                    const doHaveAccess = await Promise.all(options.requireAll.map(option => context?.hasAccessTo(option)));
-                    setHasAccess(doHaveAccess.every(access => access));
-                }
-                else {
-                    const doHaveAccess = await context?.hasAccessTo(options);
-                    setHasAccess(doHaveAccess);
+                const accessResult = await resolveAccess(context, stableOptions);
+                if (!cancelled) {
+                    setHasAccess(accessResult);
                 }
             }
             catch (e) {
-                setError(new Error("Failed to check access", { cause: e }));
+                if (!cancelled) {
+                    setError(new Error("Failed to check access", { cause: e }));
+                }
             }
             finally {
-                setLoading(false);
+                if (!cancelled) {
+                    setLoading(false);
+                }
             }
-        }
+        };
         void checkAccess();
-    }, [context, options]);
-    return react.useMemo(() => ({ hasAccess, loading, error }), [hasAccess, loading, error]);
+        return () => {
+            cancelled = true;
+        };
+    }, [context, stableOptions]);
+    const result = react.useMemo(() => ({ hasAccess, loading, error }), [hasAccess, loading, error]);
+    if (!context) {
+        throw new Error("useHasAccessTo must be used within a NavigationContext");
+    }
+    return result;
 };
 
 /**

package/index.esm.js

@@ -377,64 +377,76 @@ const useModalDialogContext = () => {
     return modalDialogContext;
 };
 
-const isMultipleCriteriaOneOf = (options) => {
-    return typeof options === "object" && "oneOf" in options;
-};
-const isMultipleCriteriaRequireAll = (options) => {
-    return typeof options === "object" && "requireAll" in options;
+const isMultipleCriteriaOneOf = (options) => typeof options === "object" && "oneOf" in options;
+const isMultipleCriteriaRequireAll = (options) => typeof options === "object" && "requireAll" in options;
+const resolveAccess = async (context, options) => {
+    if (isMultipleCriteriaOneOf(options) && isMultipleCriteriaRequireAll(options)) {
+        throw new Error("Multiple criteria are not allowed, use one of or require all - not both");
+    }
+    if (isMultipleCriteriaOneOf(options)) {
+        const results = await Promise.all(options.oneOf.map(option => context.hasAccessTo(option)));
+        return results.some(Boolean);
+    }
+    if (isMultipleCriteriaRequireAll(options)) {
+        const results = await Promise.all(options.requireAll.map(option => context.hasAccessTo(option)));
+        return results.every(Boolean);
+    }
+    return context.hasAccessTo(options);
 };
 /**
- * This is a hook to use the hasAccessTo in host.
- * You can use this to ensure the page you link to is available for the user to see.
+ * Hook to check if the current user has access to a navigation target.
+ * Useful for conditionally rendering links based on user permissions.
  *
  * @requires NavigationContext
  * @example
  * import { useHasAccessTo } from "@trackunit/react-core-hooks";
  * useHasAccessTo({ assetId: assetInfo?.assetId, page: "movement" })
- * @see (@link NavigationRuntimeApi)
- * @see (@link HasAccessToOptions)
- * @see (@link HasAccessToOptions.assetId)
- * @see (@link HasAccessToOptions.page)
- * @see (@link HasAccessToOptions.siteId)
- * @see (@link NavigationRuntimeApi)
+ * @see {@link NavigationRuntimeApi}
+ * @see {@link HasAccessToOptions}
  */
 const useHasAccessTo = (options) => {
     const context = useContext(NavigationContext);
-    if (!context) {
-        throw new Error("useHasAccessTo must be used within an NavigationContext");
-    }
+    const [stableOptions, setStableOptions] = useState(options);
     const [hasAccess, setHasAccess] = useState();
     const [loading, setLoading] = useState(true);
     const [error, setError] = useState();
+    if (JSON.stringify(stableOptions) !== JSON.stringify(options)) {
+        setStableOptions(options);
+    }
     useEffect(() => {
-        async function checkAccess() {
+        if (!context)
+            return;
+        let cancelled = false;
+        setLoading(true);
+        setError(undefined);
+        const checkAccess = async () => {
             try {
-                if (isMultipleCriteriaOneOf(options) && isMultipleCriteriaRequireAll(options)) {
-                    throw new Error("Multiple criteria are not allowed, use one of or require all - not both");
-                }
-                if (isMultipleCriteriaOneOf(options)) {
-                    const doHaveAccess = await Promise.all(options.oneOf.map(option => context?.hasAccessTo(option)));
-                    setHasAccess(doHaveAccess.some(access => access));
-                }
-                else if (isMultipleCriteriaRequireAll(options)) {
-                    const doHaveAccess = await Promise.all(options.requireAll.map(option => context?.hasAccessTo(option)));
-                    setHasAccess(doHaveAccess.every(access => access));
-                }
-                else {
-                    const doHaveAccess = await context?.hasAccessTo(options);
-                    setHasAccess(doHaveAccess);
+                const accessResult = await resolveAccess(context, stableOptions);
+                if (!cancelled) {
+                    setHasAccess(accessResult);
                 }
             }
             catch (e) {
-                setError(new Error("Failed to check access", { cause: e }));
+                if (!cancelled) {
+                    setError(new Error("Failed to check access", { cause: e }));
+                }
             }
             finally {
-                setLoading(false);
+                if (!cancelled) {
+                    setLoading(false);
+                }
             }
-        }
+        };
         void checkAccess();
-    }, [context, options]);
-    return useMemo(() => ({ hasAccess, loading, error }), [hasAccess, loading, error]);
+        return () => {
+            cancelled = true;
+        };
+    }, [context, stableOptions]);
+    const result = useMemo(() => ({ hasAccess, loading, error }), [hasAccess, loading, error]);
+    if (!context) {
+        throw new Error("useHasAccessTo must be used within a NavigationContext");
+    }
+    return result;
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-core-hooks",
-  "version": "1.12.43",
+  "version": "1.12.44-alpha-57a40ea11fa.0",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
@@ -8,9 +8,9 @@
   },
   "dependencies": {
     "react": "19.0.0",
-    "@trackunit/iris-app-runtime-core": "1.13.41",
-    "@trackunit/iris-app-runtime-core-api": "1.12.39",
-    "@trackunit/react-core-contexts-api": "1.13.39"
+    "@trackunit/iris-app-runtime-core": "1.13.42-alpha-57a40ea11fa.0",
+    "@trackunit/iris-app-runtime-core-api": "1.12.40-alpha-57a40ea11fa.0",
+    "@trackunit/react-core-contexts-api": "1.13.40-alpha-57a40ea11fa.0"
   },
   "module": "./index.esm.js",
   "main": "./index.cjs.js",

package/src/navigation/useHasAccessTo.d.ts

@@ -1,27 +1,26 @@
-import { HasAccessToOptions } from "@trackunit/iris-app-runtime-core-api";
-export interface MultipleCriteriaOneOf {
-    oneOf: Array<HasAccessToOptions>;
-}
-export interface MultipleCriteriaRequireAll {
-    requireAll: Array<HasAccessToOptions>;
-}
+import type { HasAccessToOptions } from "@trackunit/iris-app-runtime-core-api";
+export type MultipleCriteriaOneOf = {
+    readonly oneOf: Array<HasAccessToOptions>;
+};
+export type MultipleCriteriaRequireAll = {
+    readonly requireAll: Array<HasAccessToOptions>;
+};
+type AccessOptions = HasAccessToOptions | MultipleCriteriaOneOf | MultipleCriteriaRequireAll;
+type UseHasAccessToResult = {
+    readonly hasAccess: boolean | undefined;
+    readonly loading: boolean;
+    readonly error: Error | undefined;
+};
 /**
- * This is a hook to use the hasAccessTo in host.
- * You can use this to ensure the page you link to is available for the user to see.
+ * Hook to check if the current user has access to a navigation target.
+ * Useful for conditionally rendering links based on user permissions.
  *
  * @requires NavigationContext
  * @example
  * import { useHasAccessTo } from "@trackunit/react-core-hooks";
  * useHasAccessTo({ assetId: assetInfo?.assetId, page: "movement" })
- * @see (@link NavigationRuntimeApi)
- * @see (@link HasAccessToOptions)
- * @see (@link HasAccessToOptions.assetId)
- * @see (@link HasAccessToOptions.page)
- * @see (@link HasAccessToOptions.siteId)
- * @see (@link NavigationRuntimeApi)
+ * @see {@link NavigationRuntimeApi}
+ * @see {@link HasAccessToOptions}
  */
-export declare const useHasAccessTo: (options: HasAccessToOptions | MultipleCriteriaOneOf | MultipleCriteriaRequireAll) => {
-    hasAccess: boolean | undefined;
-    loading: boolean;
-    error: Error | undefined;
-};
+export declare const useHasAccessTo: (options: AccessOptions) => UseHasAccessToResult;
+export {};