@equinor/fusion-framework-react-app 14.0.3 → 14.1.0

package/src/__tests__/useTrackFeature.test.tsx

@@ -0,0 +1,83 @@
+import { describe, expect, it } from 'vitest';
+
+import { mockFramework } from '@equinor/fusion-framework/mock';
+import { enableAppManifestMock } from '@equinor/fusion-framework-app/mock';
+import type { AppModule } from '@equinor/fusion-framework-module-app';
+import { enableAnalytics, type AnalyticsModule } from '@equinor/fusion-framework-module-analytics';
+import { MockAnalyticsAdapter } from '@equinor/fusion-framework-module-analytics/mock';
+import type { MockTelemetryAdapter } from '@equinor/fusion-framework-module-telemetry/mock';
+
+import { useTrackFeature } from '../analytics/useTrackFeature';
+import { renderAppHook } from '@equinor/fusion-framework-vitest-plugin-react-app/test';
+
+const env = {
+  manifest: {
+    appKey: 'test-app',
+    displayName: 'Test App',
+    description: 'A test application',
+    type: 'standalone' as const,
+  },
+};
+
+describe('useTrackFeature', () => {
+  it('tracks an app-feature analytics event carrying the current app’s key, leaving telemetry untouched', async () => {
+    const recorder = new MockAnalyticsAdapter();
+
+    const fusion = await mockFramework<[AppModule, AnalyticsModule]>((configurator) => {
+      enableAppManifestMock(configurator, env);
+      enableAnalytics(configurator, (builder) => {
+        builder.setAdapter('mock', async () => recorder);
+      });
+    });
+    fusion.modules.app.setCurrentApp('test-app');
+
+    const { result } = await renderAppHook(() => useTrackFeature(), { env, fusion });
+    result.current('button-click', { section: 'header' });
+
+    // analytics is the only channel a successful call should reach
+    expect(recorder.getAnalytics()).toMatchObject([
+      {
+        name: 'app-feature',
+        value: { feature: 'button-click', data: { section: 'header' } },
+        attributes: { appKey: 'test-app', context: undefined },
+      },
+    ]);
+    // the framework logs its own telemetry regardless; the fallback diagnostic
+    // specifically must not fire when analytics was reached successfully
+    const telemetry = fusion.modules.telemetry.getAdapter('mock') as MockTelemetryAdapter;
+    expect(telemetry.getItems('AnalyticsProviderNotFound')).toHaveLength(0);
+  });
+
+  it('includes the current context alongside the app key', async () => {
+    const recorder = new MockAnalyticsAdapter();
+    const project = { id: 'ctx-1', title: 'My project', type: { id: 'ProjectMaster' }, value: {} };
+
+    const fusion = await mockFramework<[AppModule, AnalyticsModule]>((configurator) => {
+      enableAppManifestMock(configurator, env);
+      enableAnalytics(configurator, (builder) => {
+        builder.setAdapter('mock', async () => recorder);
+      });
+      configurator.context.setCurrentContext(project);
+    });
+
+    const { result } = await renderAppHook(() => useTrackFeature(), { env, fusion });
+    result.current('button-click');
+
+    const [event] = recorder.getAnalytics('app-feature');
+    expect(event.attributes?.context).toMatchObject({ id: project.id, type: 'ProjectMaster' });
+  });
+
+  it('reports to telemetry instead of throwing when no analytics provider is registered', async () => {
+    const fusion = await mockFramework<[AppModule]>((configurator) => {
+      enableAppManifestMock(configurator, env);
+    });
+
+    const { result } = await renderAppHook(() => useTrackFeature(), { env, fusion });
+
+    // the missing-analytics diagnostic is a telemetry concern, not an analytics one —
+    // it must not throw and must not fabricate an analytics event of its own
+    expect(() => result.current('button-click')).not.toThrow();
+    const telemetry = fusion.modules.telemetry.getAdapter('mock') as MockTelemetryAdapter;
+    expect(telemetry.getItems('AnalyticsProviderNotFound')).toHaveLength(1);
+  });
+});

package/src/ag-grid/community.ts

@@ -0,0 +1,11 @@
+/**
+ * AG Grid community-tier sub-path entry-point.
+ *
+ * @remarks
+ * Re-exports every public symbol from
+ * `@equinor/fusion-framework-react-ag-grid/community` so the application
+ * resolves a single shared copy of `ag-grid-community`.
+ *
+ * @packageDocumentation
+ */
+export * from '@equinor/fusion-framework-react-ag-grid/community';

package/src/ag-grid/enterprise.ts

@@ -0,0 +1,11 @@
+/**
+ * AG Grid enterprise-tier sub-path entry-point.
+ *
+ * @remarks
+ * Re-exports every public symbol from
+ * `@equinor/fusion-framework-react-ag-grid/enterprise` so the application
+ * resolves a single shared copy of `ag-grid-enterprise`.
+ *
+ * @packageDocumentation
+ */
+export * from '@equinor/fusion-framework-react-ag-grid/enterprise';

package/src/ag-grid/react.ts

@@ -0,0 +1,11 @@
+/**
+ * AG Grid React component sub-path entry-point.
+ *
+ * @remarks
+ * Re-exports the AG Grid React bindings from
+ * `@equinor/fusion-framework-react-ag-grid/react`, including the
+ * `AgGridReact` component, `enableAgGrid`, and their associated types.
+ *
+ * @packageDocumentation
+ */
+export * from '@equinor/fusion-framework-react-ag-grid/react';

package/src/ag-grid/testing.ts

@@ -0,0 +1,19 @@
+/**
+ * AG Grid test helpers sub-path entry-point.
+ *
+ * @remarks
+ * Re-exports the AG Grid test helpers from
+ * `@equinor/fusion-framework-module-ag-grid/testing`. Import from test setup
+ * files only — these helpers patch global state and are not meant for
+ * application runtime code.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Silences AG Grid Enterprise's unlicensed "License Key Not Found" banner on
+ * `console.error` so it doesn't bury real failures in test output.
+ *
+ * @returns A function that restores the original `console.error`.
+ */
+export { suppressAgGridLicenseBanner } from '@equinor/fusion-framework-module-ag-grid/testing';

package/src/ag-grid/theme.ts

@@ -0,0 +1,17 @@
+/**
+ * AG Grid theme sub-path entry-point.
+ *
+ * @remarks
+ * Re-exports the Fusion AG Grid theme utilities from
+ * `@equinor/fusion-framework-module-ag-grid/themes`, together with the
+ * application-scoped {@link useTheme} hook.
+ *
+ * @packageDocumentation
+ */
+export {
+  fusionTheme,
+  createThemeFromTheme,
+  createTheme,
+} from '@equinor/fusion-framework-module-ag-grid/themes';
+export type { Theme } from '@equinor/fusion-framework-module-ag-grid/themes';
+export { useTheme } from './useTheme';

package/src/create-component.tsx

@@ -41,7 +41,7 @@ export type ComponentRenderer<TFusion extends Fusion = Fusion, TEnv = AppEnv> =
  * @example
  * ```tsx
  * const configCallback: AppConfigurator = (configurator) => {
- *  configurator.http.configureClient(
+ *  configurator.configureHttpClient(
  *     'bar', {
  *       baseUri: 'https://somewhere-test.com',
  *       defaultScopes: ['foo/.default']

package/src/msal/useToken.ts

@@ -1,4 +1,4 @@
-import { useEffect, useState } from 'react';
+import { useEffect, useRef, useState } from 'react';
 
 import type { AuthenticationResult } from '@equinor/fusion-framework-module-msal';
 
@@ -32,11 +32,22 @@ export const useToken = (req: {
   const [token, setToken] = useState<AuthenticationResult | undefined>(undefined);
   const [pending, setPending] = useState<boolean>(false);
   const [error, setError] = useState<unknown>(null);
+
+  // `req` is typically a fresh object literal each render; key the effect on its
+  // scopes' content instead of identity, so it doesn't re-run (and reset `pending`
+  // to `true` forever) every time the caller re-renders. `JSON.stringify` (rather than
+  // `.join(',')`) keeps scopes with different array boundaries (e.g. `['a,b']` vs.
+  // `['a', 'b']`) from colliding on the same key.
+  const scopesKey = JSON.stringify(req.scopes);
+  const reqRef = useRef(req);
+  reqRef.current = req;
+
+  // biome-ignore lint/correctness/useExhaustiveDependencies: scopesKey is a re-run trigger, not read in the body
   useEffect(() => {
     setPending(true);
     setToken(undefined);
     msalProvider
-      .acquireToken({ request: req })
+      .acquireToken({ request: reqRef.current })
       .then((result) => {
         // Only update state when a token was actually acquired
         if (result) {
@@ -45,7 +56,7 @@ export const useToken = (req: {
       })
       .catch(setError)
       .finally(() => setPending(false));
-  }, [msalProvider, req]);
+  }, [msalProvider, scopesKey]);
   return { token, pending, error };
 };
 

package/src/version.ts

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '14.0.3';
+export const version = '14.1.0';

package/tsconfig.json

@@ -12,12 +12,18 @@
     {
       "path": "../../app"
     },
+    {
+      "path": "../../framework"
+    },
     {
       "path": "../framework"
     },
     {
       "path": "../router"
     },
+    {
+      "path": "../ag-grid"
+    },
     {
       "path": "../../modules/analytics"
     },

package/vitest.config.ts

@@ -1,15 +1,9 @@
-import { defineProject } from 'vitest/config';
+import { defineProject } from '@equinor/fusion-framework-vitest-plugin-react-app/config';
 
-import { name, version } from './package.json';
+import { name, version } from './package.json' with { type: 'json' };
 
 export default defineProject({
-  resolve: {
-    // @ts-expect-error -- tsconfigPaths is a Vite 8 option; vitest 4.x ships Vite 7 types
-    tsconfigPaths: true,
-  },
   test: {
-    include: ['src/__tests__/**'],
     name: `${name}@${version}`,
-    environment: 'happy-dom',
   },
 });