@equinor/fusion-framework-react-app 14.1.2 → 14.2.0

package/dist/types/create-component.d.ts

@@ -7,6 +7,8 @@ import type { FrameworkEvent, FrameworkEventInit } from '@equinor/fusion-framewo
 export type ComponentRenderArgs<TFusion extends Fusion = Fusion, TEnv = AppEnv> = {
     fusion: TFusion;
     env: TEnv;
+    /** Receives uncaught errors raised while the application renders or initializes its modules. */
+    onError?: (error: unknown) => void;
 };
 export type ComponentRenderer<TFusion extends Fusion = Fusion, TEnv = AppEnv> = (fusion: TFusion, env: TEnv) => React.LazyExoticComponent<React.ComponentType>;
 /**

package/dist/types/make-component.d.ts

@@ -15,6 +15,8 @@ export type ComponentRenderArgs<TFusion extends Fusion = Fusion, TEnv = AppEnv>
     fusion: TFusion;
     /** The application environment (manifest, config, basename, etc.). */
     env: TEnv;
+    /** Receives failures raised while application modules initialize. */
+    onError?: (error: unknown) => void;
 };
 /**
  * Factory function that receives a Fusion instance and environment and returns a
@@ -45,10 +47,7 @@ export type ComponentRenderer<TFusion extends Fusion = Fusion, TEnv = AppEnv> =
  * @returns {React.LazyExoticComponent<React.ComponentType>} A lazy component that, when rendered,
  * initializes the specified modules and provides the necessary Fusion and module context.
  */
-export declare const makeComponent: <TModules extends Array<AnyModule>, TRef extends Fusion = Fusion, TEnv extends AppEnv = AppEnv>(Component: React.ReactNode, args: {
-    fusion: TRef;
-    env: TEnv;
-}, configure?: AppModuleInitiator<TModules, TRef, TEnv>) => React.LazyExoticComponent<React.ComponentType>;
+export declare const makeComponent: <TModules extends Array<AnyModule>, TRef extends Fusion = Fusion, TEnv extends AppEnv = AppEnv>(Component: React.ReactNode, args: ComponentRenderArgs<TRef, TEnv>, configure?: AppModuleInitiator<TModules, TRef, TEnv>) => React.LazyExoticComponent<React.ComponentType>;
 declare module '@equinor/fusion-framework-module-event' {
     interface FrameworkEventMap {
         onReactAppLoaded: FrameworkEvent<FrameworkEventInit<{

package/dist/types/roles/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Roles V2 React hooks for Fusion Framework applications.
+ *
+ * @packageDocumentation
+ */
+export type { ActivateClaimableRoleAssignmentInput, RolesModule, } from '@equinor/fusion-framework-module-roles';
+export { useAccessRole, type ClaimableRoleAssignmentActivationResult, type UseAccessRoleResult, } from './useAccessRole';

package/dist/types/roles/useAccessRole.d.ts

@@ -0,0 +1,63 @@
+import type { ActivateClaimableRoleAssignmentInput, IRolesProvider } from '@equinor/fusion-framework-module-roles';
+/** Result returned after a claimable role assignment activation succeeds. */
+export type ClaimableRoleAssignmentActivationResult = Awaited<ReturnType<IRolesProvider['activateClaimableRoleAssignment']>>;
+/**
+ * Reactive state and actions for one Roles V2 access role.
+ */
+export interface UseAccessRoleResult {
+    /** Whether the access role is currently active, or `undefined` while the first check runs. */
+    hasAccessRole: boolean | undefined;
+    /** Whether a claimable role can grant the access role, or `undefined` while the first check runs. */
+    hasClaimableRoleAssignmentForAccessRole: boolean | undefined;
+    /** Whether active-access and claimable-assignment checks are running. */
+    isChecking: boolean;
+    /** Error from the latest access-role check. */
+    checkError: unknown;
+    /** Re-runs the active-access and claimable-assignment checks. */
+    checkAccessRole: () => Promise<void>;
+    /** Activates a claimable role assignment and refreshes access state after success. */
+    activateClaimableRoleAssignment: (input: ActivateClaimableRoleAssignmentInput) => Promise<ClaimableRoleAssignmentActivationResult>;
+    /** Whether a claimable-role-assignment activation is running. */
+    isActivating: boolean;
+    /** Error from the latest role activation request. */
+    activationError: unknown;
+}
+/**
+ * Checks one Roles V2 access role and activates a claimable role assignment when available.
+ *
+ * The hook checks both active access-role assignments and claimable access-role mappings when
+ * mounted. A successful activation triggers a new check so rendered access state follows it.
+ *
+ * @param accessRoleName - Exact, case-sensitive Roles V2 access-role name to check.
+ * @returns Access-role state and an activation action backed by the app-scoped Roles provider.
+ * @throws The function returned as `activateClaimableRoleAssignment` rethrows cancellation and
+ * Roles V2 failures.
+ *
+ * @example
+ * ```tsx
+ * const role = useAccessRole('Reports.Read');
+ *
+ * if (role.isChecking) return <Spinner />;
+ * if (role.checkError) return <ErrorMessage error={role.checkError} />;
+ * if (role.hasAccessRole) return <Reports />;
+ *
+ * // Consume the event-handler rejection; activationError below owns the visible failure.
+ * const handleActivate = (): void => {
+ *   void role.activateClaimableRoleAssignment({
+ *     assignmentId: claimableRoleId,
+ *     reason: 'Open reports',
+ *     hours: 2,
+ *   }).catch(() => undefined);
+ * };
+ *
+ * return role.hasClaimableRoleAssignmentForAccessRole ? (
+ *   <>
+ *     {role.activationError ? <p role="alert">{String(role.activationError)}</p> : null}
+ *     <button disabled={role.isActivating} onClick={handleActivate}>
+ *       Claim access
+ *     </button>
+ *   </>
+ * ) : null;
+ * ```
+ */
+export declare const useAccessRole: (accessRoleName: string) => UseAccessRoleResult;

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "14.1.2";
+export declare const version = "14.2.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-react-app",
-  "version": "14.1.2",
+  "version": "14.2.0",
   "description": "",
   "type": "module",
   "main": "./dist/esm/index.js",
@@ -70,6 +70,10 @@
       "types": "./dist/types/routing/index.d.ts",
       "import": "./dist/esm/routing/index.js"
     },
+    "./roles": {
+      "types": "./dist/types/roles/index.d.ts",
+      "import": "./dist/esm/roles/index.js"
+    },
     "./ag-grid": {
       "types": "./dist/types/ag-grid/react.d.ts",
       "import": "./dist/esm/ag-grid/react.js"
@@ -138,6 +142,9 @@
       "routing": [
         "dist/types/routing/index.d.ts"
       ],
+      "roles": [
+        "dist/types/roles/index.d.ts"
+      ],
       "ag-grid": [
         "dist/types/ag-grid/react.d.ts"
       ],
@@ -170,15 +177,15 @@
     "directory": "packages/react"
   },
   "dependencies": {
-    "@equinor/fusion-framework": "8.1.2",
+    "@equinor/fusion-framework": "8.1.3",
+    "@equinor/fusion-framework-app": "13.1.4",
     "@equinor/fusion-framework-module": "6.1.4",
-    "@equinor/fusion-framework-module-app": "8.1.1",
-    "@equinor/fusion-framework-app": "13.1.2",
-    "@equinor/fusion-framework-module-navigation": "7.0.10",
     "@equinor/fusion-framework-module-http": "8.1.1",
+    "@equinor/fusion-framework-module-app": "8.2.0",
     "@equinor/fusion-framework-react": "9.0.1",
-    "@equinor/fusion-framework-react-module-http": "12.0.1",
-    "@equinor/fusion-framework-react-module": "4.0.4"
+    "@equinor/fusion-framework-react-module": "4.0.4",
+    "@equinor/fusion-framework-module-navigation": "7.0.10",
+    "@equinor/fusion-framework-react-module-http": "12.0.1"
   },
   "devDependencies": {
     "@remix-run/router": "^1.23.3",
@@ -192,21 +199,22 @@
     "typescript": "^7.0.2",
     "vitest": "^4.1.10",
     "vitest-browser-react": "^2.2.0",
-    "@equinor/fusion-framework-react-ag-grid": "37.1.1",
     "@equinor/fusion-framework-module-ag-grid": "37.1.1",
-    "@equinor/fusion-framework-module-analytics": "3.1.1",
-    "@equinor/fusion-framework-module-bookmark": "4.1.1",
+    "@equinor/fusion-framework-react-ag-grid": "37.1.1",
+    "@equinor/fusion-framework-module-analytics": "3.1.3",
     "@equinor/fusion-framework-module-context": "9.0.1",
     "@equinor/fusion-framework-module-event": "6.1.1",
+    "@equinor/fusion-framework-module-bookmark": "4.1.2",
     "@equinor/fusion-framework-module-feature-flag": "2.1.1",
-    "@equinor/fusion-framework-module-msal": "11.0.2",
+    "@equinor/fusion-framework-module-msal": "11.0.3",
     "@equinor/fusion-framework-module-state": "^2.0.4",
     "@equinor/fusion-framework-module-telemetry": "7.1.1",
     "@equinor/fusion-framework-react-module-bookmark": "7.0.1",
+    "@equinor/fusion-framework-module-roles": "^0.2.0",
     "@equinor/fusion-framework-react-module-context": "7.0.4",
-    "@equinor/fusion-framework-react-router": "2.4.2",
-    "@equinor/fusion-framework-vitest-plugin-react-app": "1.0.2",
-    "@equinor/fusion-observable": "9.2.2"
+    "@equinor/fusion-framework-vitest-plugin-react-app": "1.0.5",
+    "@equinor/fusion-observable": "9.2.2",
+    "@equinor/fusion-framework-react-router": "2.4.4"
   },
   "peerDependencies": {
     "@types/react": "^18.0.0 || ^19.0.0",
@@ -215,9 +223,10 @@
     "rxjs": "^7.0.0",
     "@equinor/fusion-framework-module-ag-grid": "^37.1.1",
     "@equinor/fusion-framework-react-ag-grid": "^37.1.1",
-    "@equinor/fusion-framework-module-msal": "^11.0.2",
+    "@equinor/fusion-framework-module-msal": "^11.0.3",
+    "@equinor/fusion-framework-module-roles": "^0.2.0",
     "@equinor/fusion-framework-module-state": "^2.0.4",
-    "@equinor/fusion-framework-react-router": "^2.4.2"
+    "@equinor/fusion-framework-react-router": "^2.4.4"
   },
   "peerDependenciesMeta": {
     "@equinor/fusion-framework-module-ag-grid": {
@@ -235,6 +244,9 @@
     "@equinor/fusion-framework-module-navigation": {
       "optional": true
     },
+    "@equinor/fusion-framework-module-roles": {
+      "optional": true
+    },
     "@equinor/fusion-framework-react-module-bookmark": {
       "optional": true
     },