@equinor/fusion-framework-react-app 14.0.3-next.0 → 14.0.3

package/src/__tests__/useFeature.test.tsx

@@ -1,104 +0,0 @@
-import { act } from 'react';
-import { describe, expect, it, vi } from 'vitest';
-
-import { mockFramework } from '@equinor/fusion-framework/mock';
-import { enableAppManifestMock } from '@equinor/fusion-framework-app/mock';
-import type { AppMockConfigureFn } from '@equinor/fusion-framework-app/mock';
-import type { AppModule } from '@equinor/fusion-framework-module-app';
-import { enableFeatureFlagMock } from '@equinor/fusion-framework-module-feature-flag/mock';
-import type { FeatureFlagModule } from '@equinor/fusion-framework-module-feature-flag';
-
-import { useFeature } from '../feature-flag/useFeature';
-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('useFeature', () => {
-  it('resolves a flag seeded on the app scope when the framework has no feature-flag module', async () => {
-    const fusion = await mockFramework<[AppModule]>((configurator) =>
-      enableAppManifestMock(configurator, env),
-    );
-    const configure: AppMockConfigureFn<[FeatureFlagModule]> = (configurator) => {
-      enableFeatureFlagMock(configurator, (mock) => {
-        mock.addFeature({ key: 'dark-mode', enabled: true });
-      });
-    };
-
-    const { result } = await renderAppHook(() => useFeature('dark-mode'), {
-      env,
-      fusion,
-      configure,
-    });
-
-    await vi.waitFor(() => expect(result.current.feature?.enabled).toBe(true));
-  });
-
-  it('lets an app-scoped flag override a framework-scoped flag with the same key', async () => {
-    const fusion = await mockFramework<[AppModule, FeatureFlagModule]>((configurator) => {
-      enableAppManifestMock(configurator, env);
-      enableFeatureFlagMock(configurator, (mock) => {
-        mock.addFeature({ key: 'dark-mode', enabled: false });
-      });
-    });
-    const configure: AppMockConfigureFn<[FeatureFlagModule]> = (configurator) => {
-      enableFeatureFlagMock(configurator, (mock) => {
-        mock.addFeature({ key: 'dark-mode', enabled: true });
-      });
-    };
-
-    const { result } = await renderAppHook(() => useFeature('dark-mode'), {
-      env,
-      fusion,
-      configure,
-    });
-
-    await vi.waitFor(() => expect(result.current.feature?.enabled).toBe(true));
-  });
-
-  it('exposes a framework-only flag through the merged stream when the app has not seeded it', async () => {
-    const fusion = await mockFramework<[AppModule, FeatureFlagModule]>((configurator) => {
-      enableAppManifestMock(configurator, env);
-      enableFeatureFlagMock(configurator, (mock) => {
-        mock.addFeature({ key: 'framework-only', enabled: true });
-      });
-    });
-    const configure: AppMockConfigureFn<[FeatureFlagModule]> = (configurator) => {
-      enableFeatureFlagMock(configurator);
-    };
-
-    const { result } = await renderAppHook(() => useFeature('framework-only'), {
-      env,
-      fusion,
-      configure,
-    });
-
-    await vi.waitFor(() => expect(result.current.feature?.enabled).toBe(true));
-  });
-
-  it('inverts the current value when toggleFeature is called without an explicit value', async () => {
-    const fusion = await mockFramework<[AppModule]>((configurator) =>
-      enableAppManifestMock(configurator, env),
-    );
-    const configure: AppMockConfigureFn<[FeatureFlagModule]> = (configurator) => {
-      enableFeatureFlagMock(configurator, (mock) => {
-        mock.addFeature({ key: 'my-flag', enabled: false });
-      });
-    };
-
-    const { result } = await renderAppHook(() => useFeature('my-flag'), { env, fusion, configure });
-    await vi.waitFor(() => expect(result.current.feature?.enabled).toBe(false));
-
-    act(() => {
-      result.current.toggleFeature();
-    });
-
-    await vi.waitFor(() => expect(result.current.feature?.enabled).toBe(true));
-  });
-});

package/src/__tests__/useHelpCenter.test.tsx

@@ -1,64 +0,0 @@
-import { describe, expect, it, vi } 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 useAppModule from '../useAppModule';
-import { useHelpCenter } from '../help-center/useHelpCenter';
-import { EVENT_NAME } from '../help-center/event-name.js';
-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('useHelpCenter', () => {
-  it('dispatches the expected page and detail for every help-center action', async () => {
-    const fusion = await mockFramework<[AppModule]>((configurator) =>
-      enableAppManifestMock(configurator, env),
-    );
-
-    const { result } = await renderAppHook(
-      () => ({ helpCenter: useHelpCenter(), eventModule: useAppModule('event') }),
-      { env, fusion },
-    );
-
-    const received: Array<{ page: string } & Record<string, unknown>> = [];
-    result.current.eventModule.addEventListener(EVENT_NAME, (event) => {
-      received.push(event.detail as { page: string } & Record<string, unknown>);
-    });
-
-    result.current.helpCenter.openHelp();
-    await vi.waitFor(() => expect(received).toHaveLength(1));
-
-    result.current.helpCenter.openArticle('my-article');
-    await vi.waitFor(() => expect(received).toHaveLength(2));
-
-    result.current.helpCenter.openFaqs();
-    await vi.waitFor(() => expect(received).toHaveLength(3));
-
-    result.current.helpCenter.openSearch('my search');
-    await vi.waitFor(() => expect(received).toHaveLength(4));
-
-    result.current.helpCenter.openGovernance();
-    await vi.waitFor(() => expect(received).toHaveLength(5));
-
-    result.current.helpCenter.openReleaseNotes();
-    await vi.waitFor(() => expect(received).toHaveLength(6));
-
-    expect(received).toEqual([
-      { page: 'home' },
-      { page: 'article', articleId: 'my-article' },
-      { page: 'faqs' },
-      { page: 'search', search: 'my search' },
-      { page: 'governance' },
-      { page: 'release-notes' },
-    ]);
-  });
-});

package/src/__tests__/useToken.test.tsx

@@ -1,71 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-
-import { mockFramework } from '@equinor/fusion-framework/mock';
-
-import { useToken } from '../msal/useToken';
-import { renderAppHook } from '@equinor/fusion-framework-vitest-plugin-react-app/test';
-
-describe('useToken', () => {
-  it('resolves a full AuthenticationResult from the app scope’s real, mock-backed auth module', async () => {
-    const { result, unmount } = await renderAppHook(() => useToken({ scopes: ['User.Read'] }));
-
-    // `renderAppHook` awaits the render, and the mock resolves near-instantly,
-    // so the pending state may have already settled by the time we can observe it
-    await vi.waitFor(() => expect(result.current.pending).toBe(false));
-
-    expect(result.current.error).toBeNull();
-    expect(result.current.token?.scopes).toEqual(['User.Read']);
-    // a structurally valid JWT has three dot-separated segments
-    expect(result.current.token?.accessToken.split('.')).toHaveLength(3);
-    expect(result.current.token?.account).toMatchObject({ username: 'test.user@equinor.com' });
-
-    // unmount before the next test's environment tears down, so no acquisition
-    // effect can flush a state update against an already-destroyed `window`
-    await unmount();
-  });
-
-  it('surfaces an acquisition error instead of throwing', async () => {
-    const fusion = await mockFramework();
-    // persistent, not `-Once`: the app module hoists via a version-compat proxy that
-    // may call through before the hook's own effect does, consuming a one-shot mock
-    vi.spyOn(fusion.modules.auth, 'acquireToken').mockRejectedValue(
-      new Error('acquisition failed'),
-    );
-
-    const { result, unmount } = await renderAppHook(() => useToken({ scopes: ['User.Read'] }), {
-      fusion,
-    });
-
-    await vi.waitFor(() => expect(result.current.pending).toBe(false));
-
-    expect(result.current.token).toBeUndefined();
-    expect(result.current.error).toBeInstanceOf(Error);
-
-    await unmount();
-  });
-
-  it('only re-acquires the token when the scopes\u2019 contents change, not on every re-render', async () => {
-    const fusion = await mockFramework();
-    const acquireToken = vi.spyOn(fusion.modules.auth, 'acquireToken');
-
-    const { result, rerender, unmount } = await renderAppHook((props) => useToken(props), {
-      initialProps: { scopes: ['User.Read'] },
-      fusion,
-    });
-
-    await vi.waitFor(() => expect(result.current.pending).toBe(false));
-    expect(acquireToken).toHaveBeenCalledTimes(1);
-
-    // a fresh array literal with the same contents must not trigger a re-acquisition
-    await rerender({ scopes: ['User.Read'] });
-    await vi.waitFor(() => expect(result.current.pending).toBe(false));
-    expect(acquireToken).toHaveBeenCalledTimes(1);
-
-    // changed scope contents must trigger a second acquisition
-    await rerender({ scopes: ['User.Read', 'Mail.Read'] });
-    await vi.waitFor(() => expect(result.current.pending).toBe(false));
-    expect(acquireToken).toHaveBeenCalledTimes(2);
-
-    await unmount();
-  });
-});

package/src/__tests__/useTrackFeature.test.tsx

@@ -1,83 +0,0 @@
-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

@@ -1,11 +0,0 @@
-/**
- * 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

@@ -1,11 +0,0 @@
-/**
- * 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

@@ -1,11 +0,0 @@
-/**
- * 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

@@ -1,19 +0,0 @@
-/**
- * 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

@@ -1,17 +0,0 @@
-/**
- * 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';