@trackunit/react-core-hooks 1.17.66 → 1.17.67-alpha-df707023a8f.0

package/index.cjs.js

@@ -1110,6 +1110,29 @@ const useToast = () => {
     return toastContext;
 };
 
+/**
+ * Hook that checks whether the current user is allowed to perform a per-account,
+ * FGA-backed `Account.actions` action for the active account.
+ *
+ * The action results are resolved once at manager startup (alongside the user's
+ * permissions) and read synchronously from `useCurrentUser`, so this hook does
+ * not issue a query and does not flip a loading state — mirroring
+ * `useUserPermission`. Use it to gate UI on a per-account action.
+ *
+ * @param action - The `Account.actions` field to check.
+ * @returns {boolean} `true` if the action is allowed, `false` otherwise (including before it has resolved).
+ * @example
+ * ```tsx
+ * import { useAccountAction } from "@trackunit/react-core-hooks";
+ *
+ * const canManageUsers = useAccountAction("manageUsers");
+ * ```
+ */
+const useAccountAction = (action) => {
+    const { accountActions } = useCurrentUser();
+    return react.useMemo(() => accountActions?.[action] ?? false, [accountActions, action]);
+};
+
 /**
  * This is a hook providing the Current User language.
  *
@@ -1526,6 +1549,7 @@ const useWidgetConfig = () => {
 };
 
 exports.fetchAssetBlobUrl = fetchAssetBlobUrl;
+exports.useAccountAction = useAccountAction;
 exports.useAnalytics = useAnalytics;
 exports.useAssetRuntime = useAssetRuntime;
 exports.useAssetSorting = useAssetSorting;

package/index.esm.js

@@ -1108,6 +1108,29 @@ const useToast = () => {
     return toastContext;
 };
 
+/**
+ * Hook that checks whether the current user is allowed to perform a per-account,
+ * FGA-backed `Account.actions` action for the active account.
+ *
+ * The action results are resolved once at manager startup (alongside the user's
+ * permissions) and read synchronously from `useCurrentUser`, so this hook does
+ * not issue a query and does not flip a loading state — mirroring
+ * `useUserPermission`. Use it to gate UI on a per-account action.
+ *
+ * @param action - The `Account.actions` field to check.
+ * @returns {boolean} `true` if the action is allowed, `false` otherwise (including before it has resolved).
+ * @example
+ * ```tsx
+ * import { useAccountAction } from "@trackunit/react-core-hooks";
+ *
+ * const canManageUsers = useAccountAction("manageUsers");
+ * ```
+ */
+const useAccountAction = (action) => {
+    const { accountActions } = useCurrentUser();
+    return useMemo(() => accountActions?.[action] ?? false, [accountActions, action]);
+};
+
 /**
  * This is a hook providing the Current User language.
  *
@@ -1523,4 +1546,4 @@ const useWidgetConfig = () => {
     return result;
 };
 
-export { fetchAssetBlobUrl, useAnalytics, useAssetRuntime, useAssetSorting, useConfirmationDialog, useCurrentUser, useCurrentUserFavoriteAdvancedSensors, useCurrentUserFavoriteInsights, useCurrentUserLanguage, useCurrentUserSystemOfMeasurement, useCurrentUserTimeFormat, useCurrentUserTimeZonePreference, useCustomerRuntime, useEnvironment, useErrorHandler, useErrorHandlerOrNull, useEventRuntime, useExportDataContext, useFeatureBranchQueryString, useFeatureFlags, useFilterBarContext, useGeolocation, useHasAccessTo, useHostFeatureFlag, useImageUploader, useIrisAppId, useIrisAppImage, useIrisAppName, useModalDialogContext, useNavigateInHost, useOemBrandingContext, useSettingsUtils, useSiteRuntime, useTimeRange, useToast, useToken, useUserPermission, useUserSubscription, useValidateAccess, useValidateAccessAsync, useWidgetConfig, useWidgetConfigAsync };
+export { fetchAssetBlobUrl, useAccountAction, useAnalytics, useAssetRuntime, useAssetSorting, useConfirmationDialog, useCurrentUser, useCurrentUserFavoriteAdvancedSensors, useCurrentUserFavoriteInsights, useCurrentUserLanguage, useCurrentUserSystemOfMeasurement, useCurrentUserTimeFormat, useCurrentUserTimeZonePreference, useCustomerRuntime, useEnvironment, useErrorHandler, useErrorHandlerOrNull, useEventRuntime, useExportDataContext, useFeatureBranchQueryString, useFeatureFlags, useFilterBarContext, useGeolocation, useHasAccessTo, useHostFeatureFlag, useImageUploader, useIrisAppId, useIrisAppImage, useIrisAppName, useModalDialogContext, useNavigateInHost, useOemBrandingContext, useSettingsUtils, useSiteRuntime, useTimeRange, useToast, useToken, useUserPermission, useUserSubscription, useValidateAccess, useValidateAccessAsync, useWidgetConfig, useWidgetConfigAsync };

package/migrations/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../../../libs/react/core-hooks/migrations/entry.ts"],"names":[],"mappings":"","sourcesContent":["export {};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-core-hooks",
-  "version": "1.17.66",
+  "version": "1.17.67-alpha-df707023a8f.0",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
@@ -8,9 +8,9 @@
   },
   "dependencies": {
     "es-toolkit": "^1.39.10",
-    "@trackunit/iris-app-runtime-core": "1.17.61",
-    "@trackunit/iris-app-runtime-core-api": "1.16.60",
-    "@trackunit/react-core-contexts-api": "1.17.60",
+    "@trackunit/iris-app-runtime-core": "1.17.62-alpha-df707023a8f.0",
+    "@trackunit/iris-app-runtime-core-api": "1.16.61-alpha-df707023a8f.0",
+    "@trackunit/react-core-contexts-api": "1.17.61-alpha-df707023a8f.0",
     "zod": "^3.25.76"
   },
   "peerDependencies": {

package/src/index.d.ts

@@ -28,6 +28,7 @@ export * from "./timeRange/useTimeRange";
 export * from "./toast/useToast";
 export * from "./token/useToken";
 export * from "./useFeatureBranchQueryString";
+export * from "./user/useAccountAction";
 export * from "./user/useCurrentUser";
 export * from "./user/useCurrentUserPreference";
 export * from "./user/useUserPermission";

package/src/user/useAccountAction.d.ts

@@ -0,0 +1,20 @@
+export type AccountAction = "manageUsers";
+/**
+ * Hook that checks whether the current user is allowed to perform a per-account,
+ * FGA-backed `Account.actions` action for the active account.
+ *
+ * The action results are resolved once at manager startup (alongside the user's
+ * permissions) and read synchronously from `useCurrentUser`, so this hook does
+ * not issue a query and does not flip a loading state — mirroring
+ * `useUserPermission`. Use it to gate UI on a per-account action.
+ *
+ * @param action - The `Account.actions` field to check.
+ * @returns {boolean} `true` if the action is allowed, `false` otherwise (including before it has resolved).
+ * @example
+ * ```tsx
+ * import { useAccountAction } from "@trackunit/react-core-hooks";
+ *
+ * const canManageUsers = useAccountAction("manageUsers");
+ * ```
+ */
+export declare const useAccountAction: (action: AccountAction) => boolean;